DSH(DeepSeek Harness)采用插件化架构,其中 dsh-im 负责接入与机器人本体管理。dsh-im-companion 是在此基础上构建的辅助插件,引入了“助理”与“家”(工作区)的概念。它不替代本体功能,而是通过视图增强和操作流程优化,解决多工作区管理、助理状态追踪及迁移成本高的问题。
Core Features¶
This plugin mainly provides the following capabilities:
- Enhanced Workspace View: Visually displays “has assistant”, “no assistant”, and “online status” in the left-side workspace list.
- Enhanced Session Status: Adds color indicators to the native DSH session bar, where blue represents running and orange represents awaiting user confirmation.
- Relocation Feature: Supports dragging an assistant card to another workspace for quick migration.
- Fleet Radar: Provides a matrix view of Agents and channels to check the online status of the entire fleet.
- Assistant Details: Click an assistant card to view its mode, current status, and toggles for each channel.
- Channel-Aggregated View: Supports viewing assistants aggregated by channel in settings.
- Add Integration: Adds a new access point by scanning a QR code for binding.
- Light Theme Support: Compatible with the light theme interface.
Installation and Enablement¶
Before installing, make sure DSH and its core component dsh-im are already installed.
Installation command:
dsh plugin --profile desktop add dsh-im-companion@0.1.8 --registry https://registry.npmjs.org
Note: The
--profileparameter must be set according to the entry point you are using. Usedesktopfor the desktop app andwebfor the auto-started Web service.
Enablement:
After installation, refresh the page. If the panel does not appear, completely quit the DSH app and reopen it.
Typical Usage¶
Filter Workspaces:
Click the “has assistant” filter in the left-side workspace list to show only workspaces that have assistants configured.
Relocate an Assistant:
1. Click the robot icon in the toolbar to open the relocation panel.
2. Drag the assistant card over the target workspace; the target workspace will be highlighted.
3. Confirm the relocation operation in the secondary confirmation dialog.
Notes¶
- Prerequisite: You must install
dsh-imfirst; the plugin cannot run independently. - Version Compatibility: The older version (0.1.6) fails to load under the
web profile; make sure you use a compatible version. - License: This project is open-sourced under the MIT license.
- Ecosystem Background: This plugin is a community-maintained project and has no affiliation with the official DeepSeek.