前言¶
在 DeepSeek Harness（DSH）里跑智能体会话，对话区能看到消息，官方 Trajectory 也能追溯执行轨迹；但若只想快速回答「这轮走了几步、工具并行了几路、模型各阶段花了多久、Token 大概多少钱」，往往要在长列表里来回翻。社区维护者 daha1216 的 dsh-watcher 是面向 DSH Web 的只读客户端插件：从会话标题栏打开面板，把 Session 收成可折叠的工作路径，并做本地耗时统计与模型用量费用估算。它不往对话里塞消息，不编造隐藏思维链，也不替代官方 Trajectory。
这是什么¶
- 名称：dsh-watcher（GitHub：
daha1216/dsh-watcher） - 分类：客户端（
platform: web） - 维护者：daha1216
- 许可证：MIT
- 当前发布版本（资料中的安装引用）：
v0.7.0
插件定位是「DeepSeek Harness Web 的只读插件」：点会话标题栏里的眼睛图标，打开观测面板，查看轮次、阶段、工具执行与模型阶段的结构化路径；设置页和会话 HUD 旁还可查看 Token 与估算费用（按本地价格表，非账单）。
核心功能¶
可折叠工作路径¶
面板把当前 Session 整理成可折叠路径，展示这轮有多少步、多少次执行、总耗时；展开某一步可看并行分支、工具结果，或默认折叠的推理记录（仅显示供应商已写入 Session 的可见 reasoning，无记录则标为「未记录」）。
支持归类视图：能把可证明为相同调用的记录叠在一起（例如两次改 package.json 显示为 ×2）；两条不同的 bash 不会被强行合并。也支持按深度、组织方式切换呈现；搜索与「全部 / 异常 / 等待」筛选、统计与视图控制收在 0.7.0 起精简后的状态条与菜单中。
耗时与实时指标¶
各级耗时可见：轮次总耗时、阶段跨度、单条记录耗时，以及实时 tok/s。指标线展示轮次 · 步骤 · 执行数，Token · 估算成本 · 缓存命中等读数。
本地费用估算¶
设置页和会话 HUD 的 Token 总数旁有估算费用（不是「总价值」）。按模型的输入 / 输出 / 缓存桶对照仓库内 pricing/models.yaml 计价；缺行显示未知，不会当成 $0。默认表含 DeepSeek、MiniMax、OpenAI、Anthropic、Gemini、Grok、GLM、Qwen 等主流行，不联网。在设置里打开的是当前生效价格表；保存时只把改动过的行写入浏览器 localStorage 键 dsh-watcher:pricing-override:v1。这是估算，不是账单。
检视器与设置页¶
检视器保留头部、指标与「结果 / 输入 / 原始」三个 tab，并支持在记录间步进（含方向键）；宽面板（约 980px 以上）时详情可停靠在路径右侧。设置页分「概览 / 趋势 / 会话 / 偏好」等 tab，可对历史会话做扫描与统计（失败会明确提示，不与「确实没有数据」混淆）。
行为边界¶
- 只读观测，不修改对话内容。
- 冷会话的 Chat 数据尚未到达时，Watcher 显示等待提示，数据到达后再挂载面板。
安装与启用¶
需要 DeepSeek Harness 0.1.7-rc.2（@deepseek-ai/dsh@0.1.7-rc.2）。peer 范围 >=0.1.7-rc.1 <0.1.8 || ^0.2.0-rc.1：0.1.7-rc.1、0.1.7-rc.2 和 0.2.0-rc.x 均可安装；开发与测试仍以 0.1.7-rc.2 为准。Node 需为 ^22.19.0 或 >=24。
DSH Studio 桌面 App（推荐）¶
打开 设置 → 插件 → 添加插件，在「包名或地址」中输入：
github:daha1216/dsh-watcher#v0.7.0
桌面端插件管理器负责 Desktop profile 和内置包管理器。发布包已包含 lib/；普通使用不需要 clone、构建或安装 DSHX。若应用提示刷新或重新打开，请按提示完成。
Web CLI¶
下面命令只写入 web profile，不能修改 Desktop App 的 profile：
dsh plugin --profile web add github:daha1216/dsh-watcher#v0.7.0
对于已经运行的 Web Host，请重新打开该 Host 一次，再刷新网页。
卸载 Web profile 中的插件：
dsh plugin --profile web remove dsh-watcher
官方 CLI 只管理 web profile；Desktop App 请使用应用内「添加插件」入口。
典型用法¶
- 按上文方式在 Desktop 或 Web 安装
v0.7.0并重启 / 刷新 Host。 - 打开一条 DSH 会话，在标题栏点击眼睛图标，打开 Watcher 面板。
- 在路径上浏览轮次与阶段；需要时用归类模式合并相同调用，或展开某步查看并行工具与推理片段。
- 通过「用量与耗时」等入口查看 Token、缓存与估算成本；若需自定义单价，在插件设置页修改价格表并保存（覆盖项写入
localStorage）。 - 点击具体记录打开检视器，在「结果 / 输入 / 原始」间切换，或用记录步进器在相邻记录间移动。
适用场景与注意¶
适合谁：在 DSH Web 或 Studio 上开发、调试智能体，需要快速看清执行结构、并行关系、耗时与大致模型成本，又不想让插件改写对话或伪造思维链的开发者。
权限与安全：插件以当前 DSH 进程及浏览器环境运行，能读取会话与本地存储中的配置覆盖项。安装前建议在 GitHub 查看源码与 MIT 许可证，确认符合你的合规要求。
生态说明：DSH 采用「一切皆插件」思路；社区插件目录托管在独立站点，与 DeepSeek / 幻方无官方从属关系。本插件星标数为 0（截至目录线索），不代表功能完备度，以 README 与发布标签为准。
开发与构建：日常安装不必从源码构建。若改 TypeScript，维护者文档要求用 pnpm 重建已提交的 lib/（需本机 Harness 检出解析 peer）；这与终端用户安装路径无关。
结尾¶
dsh-watcher 把 DSH 会话折成可导航的只读工作路径，并辅以本地耗时与模型费用估算，适合作为官方 Trajectory 之外的「仪表盘式」观测补充。更多说明与截图见仓库 README；社区目录页与源码地址如下。
- 目录页：https://www.skillhub.cn/plugins/daha1216/dsh-watcher
- GitHub：https://github.com/daha1216/dsh-watcher
