中文 · 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 <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。

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.8 || ^0.2.0-rc.1；补上 typecheck / build / test 的 GitHub Actions。

0.6.1

• 在官方 DeepSeek Harness 0.1.7-rc.2 上核对通过。@deepseek-ai/dsh-* 的 peer 仍是 >=0.1.7-rc.1 <0.1.8，安装期接受 0.1.7-rc.1 和 0.1.7-rc.2，不接受 0.1.7-alpha.*。
• 图标仍是 IconChevronRightOutlineRegular、IconRefreshOutlineRegular、IconCheckOutlineRegular、IconCopyOutlineRegular。rc.2 同样没有带尺寸后缀的旧导出。

0.6.0

• 对齐官方 DeepSeek Harness 0.1.7-rc.1。@deepseek-ai/dsh-* 的 peer 改为 >=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 显示等待提示，数据到达后再挂载面板。