dsh-watcher
Read-only DSH session insights and local model usage statistics 适合需要折叠查看会话步骤、并行分支、工具调用耗时及Token统计的用户。
同名パッケージの別リポジトリ
インストール
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:daha1216/dsh-watcherドキュメント
README 全文を読む ↗中文 · English
Watcher
安装
DSH Studio 桌面 App(推荐)
打开 设置 → 插件 → 添加插件,在“包名或地址”中输入:
github:daha1216/dsh-watcher#v0.6.3
桌面端插件管理器负责 Desktop profile 和内置包管理器。本发布已提交 lib/;普通使用不需要 clone、构建或安装 DSHX。若应用提示刷新或重新打开,请按提示完成。
Web CLI
dsh plugin --profile web add github:daha1216/dsh-watcher#v0.6.3
这条官方 CLI 命令只写入 web profile,不能修改 Desktop App 的 profile。对于已经运行的 Web Host,请重新打开该 Host 一次,再刷新网页。
需要 DeepSeek Harness 0.1.7-rc.2(@deepseek-ai/dsh@0.1.7-rc.2)。peer 范围 >=0.1.7-rc.1 =24。
DeepSeek Harness Web 的只读插件。点会话标题栏里的眼睛,把 Session 收成一张能折叠的工作路径:这轮走了几步、跑了几次、花了多久;再展开某一步看并行分支、工具结果,或一条默认折着的推理记录。
它不往对话里塞消息,不编隐藏思维链,也不替代官方 Trajectory。





截图取自 0.6.2。0.6.3 起面板改为命令栏布局、检视器为覆盖式抽屉,画面与上略不同,截图待补。
归类只叠能证明相同的调用。两条不同的 bash 不会被捏在一起。模型阶段只显示供应商已经写进 Session 的可见 reasoning;没有记录就写未记录。
已经 clone 过的目录也可以(开发/本地测试):
git clone https://github.com/daha1216/dsh-watcher.git
dsh plugin --profile web add ./dsh-watcher
同样需要 pnpm,然后重新打开该 Web Host 并刷新页面。
dsh plugin --profile web remove dsh-watcher
官方 CLI 只管理 web profile;Desktop App 请使用上面的应用内“添加插件”入口。
设置页和会话 HUD 的 Token 总数旁有 估算费用(不是「总价值」)。按模型的输入 / 输出 / 缓存桶对照 pricing/models.yaml 计价;缺行显示 未知,不会当成 $0。部分已知时主数字只显示已标价金额,未标价写在脚注。这是估算,不是账单。默认表含 DeepSeek、MiniMax、OpenAI、Anthropic、Gemini、Grok、GLM、Qwen 主流行,不联网。设置里打开的是当前生效价格表;保存只把改动过的行写入 localStorage 键 dsh-watcher:pricing-override:v1。欢迎对默认表提 PR。
交互约定在 DESIGN.md。MIT。
本次更新(0.6.3)
- 面板换成实心仪表盘。 去掉毛玻璃:不透明底色、1px 描边、顶部高光与分层阴影;图表 tooltip 和计时卡统一到同一套表面变量。
- 顶栏改成两行命令栏。 上行是状态行(圆点、状态、实时动作、跟随),下行是下沉的控制行(计数与历史加载、归类/深度切换)。轮次改成章节式排版;检视器从挤压列改成覆盖式右侧抽屉,展开时工作路径不再回流,面板宽度也不变。
- 阶段行压成单行。 从 80–100px 的两行头压到 34px 一行(标记、箭头、标题与徽章、右对齐的步骤/执行/耗时),完整措辞保留在 aria-label;行底加 2px 时长占比条,一眼看出时间花在哪。同样的面板高度大约能多放 2.5 倍的行。
- 设置页与 HUD 统一视觉。 四个等宽指标块、带语义色的洞察卡、去 emoji 的下钻面板,硬编码色值全部换成 dsw token 与
color-mix。 - 折叠内容不再占 DOM。 收起的分支按需渲染,空闲面板不再每秒遍历历史子树;一轮里只有正在执行的阶段订阅 1Hz 时钟。
- 更快、更省内存。 同一次折叠在真实 3,409 事件会话上快 37%(35.4ms → 22.1ms)且输出逐字节一致;面板关闭时不再折叠;长期驻留的合并结果与诊断集合都有上限。
- 兼容与工程化。 peer 范围放宽到
>=0.1.7-rc.1 =0.1.7-rc.1 =0.1.7-rc.1 <0.1.8,安装期接受0.1.7-rc.1,不接受0.1.7-alpha.*。 - 图标改为
IconChevronRightOutlineRegular、IconRefreshOutlineRegular、IconCheckOutlineRegular、IconCopyOutlineRegular。rc.1 删掉了带尺寸后缀的旧导出,没有别名。
0.5.0
- 面板能拖大。 右边缘、下边缘和右下角把手都能拖;位置全程不动,最小只能缩回打开时的默认尺寸,不会小到放不下内容。
- HUD 可折叠成一行。 范围切换旁多了一个
▾,收起只留顶栏统计,选择会被记住。 - "定位现场"真的到现场。 现在会选中告警对应的具体失败步骤、直接打开检视器,而不是只滚到轮次标题。
- 连续失败不再刷屏。 同一条失败链更新同一张卡片,标题带上
第 N 轮。
外加一串 0.4.5 的修复:检视器返回不再抢跟随、首次选范围不重复扫会话、投影状态不再存一份自身视图、计时面板文案改为"终端以外的工具"。
历史版本见 CHANGELOG.md。
从源码构建
日常安装不用这一步。改 TypeScript 后用 pnpm 重建已提交的 lib/:
pnpm install
pnpm test
node scripts/link-harness-dependencies.mjs /path/to/harness
pnpm build
pnpm build 需要能解析 @deepseek-ai/dsh-* peer 的本机 Harness 检出。装插件不要走这条路径。
冷会话的 Chat 数据尚未到达时,Watcher 显示等待提示,数据到达后再挂载面板。