前言¶
DeepSeek Harness（DSH）采用“一切皆插件”的架构。在开发智能体或调试工作流时，开发者通常需要查看会话的执行路径、耗时统计以及模型调用成本。dsh-watcher 作为一个只读插件，旨在解决这些问题，提供会话洞察和本地模型使用统计。
插件简介¶
插件名称：aa2246740/dsh-watcher
一句话定位：Read-only Agent work-path observer for DeepSeek Harness（DeepSeek Harness 的只读 Agent 工作路径观察者）
维护者：aa2246740
许可证：MIT
核心功能¶
该插件提供以下核心能力：
- 只读会话洞察与统计：读取 DSH 会话洞察和本地模型使用统计，不往对话里塞消息，也不编隐藏思维链。
- 可折叠工作路径观察者：将工作路径收成一张能折叠的视图，展示轮次、步骤和持续时间。
- 可视化并行分支与工具结果：可视化并行分支和工具结果，支持在步骤中展开查看。
- 会话聚合与分组：支持会话聚合和分组，例如将两次修改
package.json的操作归类。 - 成本估算：基于
pricing/models.yaml计算成本估算，默认包含 DeepSeek、MiniMax、OpenAI、Anthropic、Gemini、Grok、GLM、Qwen 等主流模型，不联网。 - Web 平台支持：支持 Web 平台，但依赖 DeepSeek Harness 的 Web Host。
安装与启用¶
插件依赖 DeepSeek Harness 0.1.7-rc.1 或 0.1.7-rc.2（@deepseek-ai/dsh-* 的 peer 范围为 >=0.1.7-rc.1 <0.1.8），以及 Node.js ^22.19.0 或 >=24。
桌面 App（推荐）¶
- 打开 DeepSeek Harness 桌面应用。
- 进入 设置 → 插件 → 添加插件。
- 在“包名或地址”中输入以下地址：
github:aa2246740/dsh-watcher#v0.6.1
- 桌面端插件管理器会负责 Desktop profile 和内置包管理器。安装后按提示刷新或重新打开应用。
Web CLI¶
若通过命令行安装，需指定 web profile：
dsh plugin --profile web add github:aa2246740/dsh-watcher#v0.6.1
安装后，需要重新打开该 Web Host 并刷新网页。官方 CLI 只管理 web profile，不能修改 Desktop App 的 profile。
典型用法¶
安装完成后，可以在会话界面使用以下功能：
- 查看工作路径：点击会话标题栏里的“眼睛”图标，将 Session 收成一张能折叠的工作路径，查看这轮走了几步、跑了几次、花了多久。
- 切换视图模式：在视图之间切换，支持从逐项切到归类模式。例如，两次修改
package.json的操作会被归类为 ×2。 - 展开细节：点击具体的步骤，展开查看并行分支、工具结果，或默认折着的推理记录。
- 查看成本：设置页和会话 HUD 的 Token 总数旁会显示估算费用。这是基于
pricing/models.yaml按模型输入/输出/缓存桶计价，部分已知时只显示已标价金额。这是估算，不是账单。
注意事项与适用场景¶
- 权限限制：插件以当前 DSH 进程的权限运行。
- 不替代官方组件：它不替代官方 Trajectory，仅作为辅助的只读观察工具。
- 数据来源：默认表含 DeepSeek、MiniMax 等主流模型，不联网；缺行显示未知，不会当成 $0。
- 隐私与安全：插件为 MIT 许可证开源，建议在安装前检查源码与许可证。
- 适用人群：适合需要频繁调试工作流、分析 Agent 执行路径或监控模型调用成本的 DSH 开发者。
结语¶
dsh-watcher 通过提供折叠式的工作路径观察和成本估算功能，帮助开发者更清晰地理解 Agent 的执行过程。它不侵入对话流，专注于数据展示与统计。
