前言¶
用 DeepSeek Harness 跑智能体会话时，工具调用、token 消耗和阻塞关系往往分散在日志或本地会话文件里，事后很难按时间轴对齐排查。单独起一个观测服务又要占端口、配路由。下面介绍 maintainer JasperPengC 发布的客户端插件 dsh-agent-blackbox：把 agent-blackbox 仪表盘挂进 DSH 侧栏与全屏面板，在宿主进程内提供实时监视、时间轴回放和跨会话成本总览，不额外起进程或监听端口。
这是什么¶
dsh-agent-blackbox 是 DeepSeek Harness 的客户端插件（npm 包名 dsh-agent-blackbox，当前发布版本 0.1.2，MIT 许可证）。它在 DSH 界面侧栏提供「黑匣子」入口，主区可打开整屏面板；能力来自内置编译后的 agent-blackbox 核心（core/）与前端（web/），无需再单独安装或本地构建 agent-blackbox。
核心功能¶
资料中明确列出的观测能力如下：
- 实时：正在写入的会话自动增量刷新。
- 回放：时间轴缩放与框选、工具瀑布、事件检查器。
- 归因：每个 agent 的工具、token、成本与阻塞关系。
- 总览：跨会话成本排行，按 runtime / 项目分组。
数据只读本机会话文件，不向外部发网络请求；成本统计依赖本地价格表，未知模型不计入合计。
工作原理（简要）¶
插件将 HTTP 路由挂到 DSH 自带 webServer 的 /blackbox 前缀下，与宿主同源。宿主侧 lib/index.js 在进程内挂载路由；浏览器侧 lib/client.js 注册侧栏与面板，两侧复用 agent-blackbox 同一份渲染器。
安装与启用¶
常规安装（命令来自仓库 README）：
dsh plugin --profile desktop add dsh-agent-blackbox
重启 DSH 后，侧栏会出现「黑匣子」▣，主区可打开整屏面板。也可在 DSH「设置 → 插件市场」中搜索 agent-blackbox 安装；社区目录 awesome-dsh-plugin.com 亦有收录。
发布包已内置 core/ 与 web/，不需要另外安装 agent-blackbox。
典型用法¶
安装并重启后，通过侧栏「黑匣子」或全屏面板即可使用，无额外 CLI 步骤。开发者在本地 link 开发时，README 给出如下流程（需自行 clone 仓库，正文安装场景以 npm 包为准）：
dsh plugin --profile desktop add link:$PWD
npm test
面板 UI 与回放能力可参考仓库 README 中的录屏与截图链接（如 playback-dark.gif、panel-light.png）。
环境与限制¶
- DeepSeek Harness：
>=0.2.0-rc.2且<0.3.0；Node.js：>=22.19。 - 超过 24 MB 的会话文件只加载尾部 8 MB。
- 升级插件后需要重启 DSH。
插件在 当前 DSH 进程权限 下运行，安装前建议查看 GitHub 源码 与 MIT 许可证，确认符合你的安全与合规要求。
相关链接¶
- 插件目录页：https://www.skillhub.cn/plugins/JasperPengC/dsh-agent-blackbox
- GitHub：https://github.com/JasperPengC/dsh-agent-blackbox
- npm：https://www.npmjs.com/package/dsh-agent-blackbox
- 问题反馈：https://github.com/JasperPengC/dsh-agent-blackbox/issues
- 主项目 agent-blackbox：https://github.com/JasperPengC/agent-blackbox
DeepSeek Harness 生态以「一切皆插件」为思路；SkillHub、awesome-dsh-plugin 等目录为社区收录，与 DeepSeek / 幻方无官方从属关系。若你需要在 IDE 内对照会话事件与成本而不另开端口，可安装本插件并在重启 DSH 后从侧栏进入黑匣子面板。
