前言¶
DeepSeek Harness Companion 是一个运行在 DeepSeek Harness Web 中的轻量级插件。它将当前会话的活动状态、上下文压力和用量信息转化为一个“Living Data Orb”（活数据球），帮助开发者快速扫一眼就理解 Agent 的运行情况与资源占用。
该插件的设计理念是“状态优先，用量按需”。默认界面只传达 Agent 正在做什么（状态）以及上下文是否需要关注（压力），只有在悬停、键盘聚焦或点击固定面板时，才会显示详细的数字指标。这种设计避免了数据持续占据注意力，同时保证了隐私安全。
核心功能¶
插件通过 shell.overlay 原生挂载到 DSH Web，具备以下核心能力：
- 活动状态监控：识别 Sleeping、Idle、Working、Waiting、Done 等状态，帮助判断 Agent 是否在正常执行或等待用户响应。
- 上下文压力可视化：通过 Normal、Attention、Warning、Unknown 四个等级展示预计上下文占用率，低于 70% 为 Normal，85% 以上为 Warning。
- 用量面板：展示 Context、Billed input、Output、Cache hit 和 Steps 等指标，数据直接来源于 DSH 提供的 projections。
- Living Data Orb：利用表情和轻量动效表达状态，不依赖颜色作为唯一提示。
- 隐私优先：不读取或发送 prompt、消息、推理过程、工具参数或结果、文件内容、凭证或供应商账户信息。
- 交互与融合：支持拖拽移动位置、折叠成边缘标签，并跟随当前选中的 session 生命周期。
安装与启用¶
该插件通过官方插件目录发布，安装后需重启 Web 端。
dsh plugin --profile web add dsh-companion
dsh web
使用方式¶
安装后，插件会以“宠物”形式出现在 Web 界面上，交互逻辑如下：
- 查看用量：悬停或使用键盘聚焦宠物，会弹出用量面板显示 Context、Billed input、Output 等具体数值。
- 固定面板：点击宠物，可固定或取消固定用量面板，方便持续监控。
- 移动位置：按住宠物拖动，可改变其在屏幕上的显示位置（位置保存在浏览器本地）。
- 折叠与恢复：点击折叠功能，宠物会缩成屏幕边缘的
Show DSH Companion标签，点击该标签可恢复原状。
注意事项与限制¶
dsh-companion 目前处于 MVP 阶段，存在以下限制：
- 版本与兼容性：当前版本（0.1.1）精确面向 DeepSeek Harness
0.1.0-rc.5。由于 Harness 仍处于开发者预览阶段，后续版本可能需要插件更新以适配。 - Session 限制：0.1.0 仅支持 DSH Web 界面和当前选中的 session，不支持多 session 并发或多宠物。
- 隐私边界：插件仅读取 DSH Web 客户端已提供的 session 状态和 projections。当缺少 projection 数据时，指标会保持 Unknown 或直接省略，绝不会将未知数据估算为 0。
- 功能缺失：暂不支持流式 token 估算、价格或成本计算、历史趋势、成长系统、prompt/tool 内容分析或云同步。
结语¶
DSH Companion 适合需要在日常开发中持续监控 Agent 状态和上下文用量的 DSH 用户。它通过极简的视觉反馈解决了“状态可见”与“用量监控”的平衡问题，同时严格遵守隐私原则，不触碰对话内容或推理过程。项目代码与文档托管在 GitHub 上，可根据需要自行构建或查阅。
