DSH（DeepSeek Harness）采用插件化架构，其中 dsh-im 负责接入与机器人本体管理。dsh-im-companion 是在此基础上构建的辅助插件，引入了“助理”与“家”（工作区）的概念。它不替代本体功能，而是通过视图增强和操作流程优化，解决多工作区管理、助理状态追踪及迁移成本高的问题。
核心功能¶
该插件主要提供以下能力：
- 增强工作区视图：在左侧工作区列表中直观展示“有助理”、“无助理”及“在线状态”。
- 增强会话状态：在 DSH 原生会话条上增加颜色标识，蓝色代表执行中，橙色代表待用户确认。
- 搬家功能：支持将助理卡片拖拽至另一工作区，实现快速迁移。
- 舰队雷达：提供 Agent 与渠道的矩阵视图，查看全舰队的在线情况。
- 助理详情：点击助理卡片可查看其模式、当前状态及各渠道的开关。
- 按渠道聚合视图：在设置中支持按渠道聚合查看助理。
- 添加接入：通过扫码绑定方式添加新接入点。
- 浅色主题支持：适配浅色主题界面。
安装与启用¶
安装前请确保已安装 DSH 及其本体 dsh-im。
安装命令：
dsh plugin --profile desktop add dsh-im-companion@0.1.8 --registry https://registry.npmjs.org
注意：
--profile参数需根据实际使用的入口填写。桌面应用使用desktop，自启 Web 服务使用web。
启用：
安装完成后刷新页面。如果面板未出现，请完全退出 DSH 应用后重新打开。
典型用法¶
过滤工作区：
点击左侧工作区列表中的“有助理”过滤器，仅显示已配置助理的工作区。
搬家助理：
1. 点击工具栏的机器人图标，进入搬家面板。
2. 拖拽助理卡片至目标工作区的上空，目标工作区会高亮显示。
3. 在二次确认弹窗中确认搬家操作。
注意事项¶
- 前置要求：必须先安装
dsh-im，插件无法独立运行。 - 版本兼容性：旧版本（0.1.6）在
web profile下装配会失败，请确保使用兼容版本。 - 许可证：本项目采用 MIT 许可证开源。
- 生态背景：本插件为社区维护项目，与 DeepSeek 官方无从属关系。
