DeepSeek Harness Web 提供了智能体开发的底层能力，但任务运行过程中的状态（思考、等待、工具调用等）通常是隐式的。dsh-companion 是一个本地运行的桌面伙伴与任务状态覆盖层，通过角色动作和状态气泡，将长任务的进展直观地呈现出来。
这是什么¶
Local state-aware desktop companion and task-status overlay for DeepSeek Harness Web。
- 维护者：Wanbinyu
- 许可证：MIT
核心功能¶
- 感知真实任务状态：区分空闲、思考、工具调用、等待确认、完成和失败，而不是简单地循环播放装饰动画。
- 有反馈的角色互动：支持拖动、缩放、点击回应、五分钟休息动作、十分钟长任务动作和完成气泡；工作、完成、待机台词均可编辑。
- 可选计费联动：安装
dsh-billing后，自动读取其会话投影，显示本轮/会话费用、Token、额度进度和未定价提醒。 - 本地运行且保护隐私：不读取提示词、回复、工具参数、文件内容或 API Key。
安装与启用¶
在安装前，请确保环境满足以下要求：
- Node.js：>= 22.19
- DeepSeek Harness：兼容 0.1.0-rc.6 至 rc.8、0.1.1-rc.1 至 rc.2、0.1.2-rc.1
通过以下命令安装发布版：
dsh plugin --profile web add https://github.com/Wanbinyu/dsh-companion/releases/download/v0.1.12/dsh-companion-0.1.12.tgz
安装后启动 Harness Web 即可使用。
使用方式¶
- 移动：拖动角色可调整位置；聚焦后可用方向键精确移动，按住 Shift 时加速。
- 交互：单击角色会播放短反馈动作并显示气泡；休息状态下单击会立即唤醒。
- 设置：点击齿轮可调整大小（80-140 px）、界面强调色、状态气泡和计费信息。
- 位置管理：点击“回到右下角”会清除自定义位置。
注意事项¶
- 非官方插件：这是非官方社区插件，与 DeepSeek 官方无隶属或背书关系。
- 素材许可：角色位图素材不自动适用仓库的 MIT 许可证。
- 隐私边界：插件仅保留状态、轮次、工具名称、时间和短错误码，不会保存或展示用户提示词、模型回复、工具参数、API Key、请求头、完整错误消息、工作区文件内容或任何外部遥测标识。
