操作指示条 Miaoyeah/dsh-activity-hud

DeepSeek Activity HUD · 操作指示器

DeepSeek 在你电脑上动手时，屏幕顶部出现一条置顶提示：它正在做什么、做了多久。鼠标可穿透、不抢焦点，做完变绿后自动消失。

执行中只读操作刚完成

平台：Windows 10 / 11 · 依赖：Node.js 18+ · 协议：MIT · 版本：v1.0.0

为什么需要它

DeepSeek Harness 里的 DeepSeek 是真的在你本机干活：跑 PowerShell、开后台任务、读 / 写 / 改文件。你切到别的窗口时看不见它在动，就容易撞车——它正在改的文件你也在改，或者它在跑重活时你还在猛敲键盘。

这个工具把「它此刻在动你的电脑」变成一眼可见的状态，而且绝不打断你：

| 颜色 | 含义 |
| 🟡 琥珀色 | 正在执行会改动本机的操作（跑命令、写文件、改文件、派子任务…） |
| 🔵 蓝色 | 正在做只读操作（读文件、搜索、列目录…） |
| 🟢 绿色 | 刚刚做完，显示本次耗时，2.5 秒后消失 |

副标题写清楚：哪个会话、哪个目录，以及有没有并行动作 / 后台任务在跑。

不会打断你

实测窗口样式 exstyle = 0x080800A8：

- WS_EX_TRANSPARENT (0x20) — 鼠标穿透，点下去点到的是下面的窗口，不挡任何点击
- WS_EX_NOACTIVATE (0x08000000) — 不抢键盘焦点，你正在打字时它冒出来也不打断输入
- WS_EX_TOOLWINDOW (0x80) — 不进 Alt-Tab，配合 ShowInTaskbar=false 不进任务栏
- WS_EX_TOPMOST (0x8) — 置顶，但鼠标穿透
- 心跳机制：数据超过 3 秒没更新自动隐藏，所以监听进程挂了也不会留一条鬼影

安装

git clone https://github.com/Miaoyeah/dsh-activity-hud.git
cd dsh-activity-hud

然后双击 start-hud.vbs。没有黑框、不弹窗；找不到 Node.js 时会提示你去装。

不用重启 DeepSeek，也不改 DeepSeek 的任何文件，随时开、随时关。

开机自启（可选）

右键 install-startup.ps1 →「使用 PowerShell 运行」，会在「启动」文件夹建一个快捷方式。

取消：

powershell -ExecutionPolicy Bypass -File install-startup.ps1 -Remove

停止

powershell -ExecutionPolicy Bypass -File stop-hud.ps1

什么会点亮它

- 任何会碰本机的工具调用：跑命令、终端、读 / 写 / 改文件、搜索、派生子任务、运行工作流、展示文件……
- 只思考、只聊天、只查网页的时候不点亮（这些不动你的机器）。
- 覆盖所有正在进行的会话：别的 DSH 窗口、子任务、工作流，谁在动电脑就显示谁。

不想看到的工具，在 hud.config.json 的 excludeTools 里加名字即可。

配置 hud.config.json

改完保存即生效（watcher 每 0.4 秒检查一次），不用重启。

| 字段 | 默认 | 说明 |
| lingerMs | 2500 | 动作结束后提示条还留多久（毫秒）。调大可减少连续命令之间的闪动 |
| maxDetailChars | 90 | 详情文字最多显示多少字 |
| showBackgroundJobs | true | 副标题是否显示「N 个后台任务在跑」 |
| excludeTools | 见文件 | 不点亮的工具名列表 |

位置也可调：改 hud.ps1 里的 $win.Top / $win.Left（默认顶部居中，距顶 18 像素）。

它是怎么做到的

DeepSeek Harness ──写──▶ ~/.dsh/sessions/<工作区>/session-/session.v4.jsonl.zstd │ （zstd 多帧追加的事件流） ▼ watch.mjs：按帧增量解码，配对 tool/call ↔ tool/result │ 每 400ms ▼ state.json（谁在跑、跑了多久） │ 每 220ms ▼ hud.ps1（WPF 置顶小窗，鼠标穿透）

- 只读会话日志，不注入、不 hook、不联网。
- 日志是 zstd 多帧追加的，按帧增量解码，每次只读新增的那一段（不重复解析历史）。
- 多个会话交替执行时，主行有 1.5 秒粘性，避免来回跳。
- watcher 每 1 秒写心跳；悬浮条发现数据超过 3 秒没更新会自己隐藏。

文件结构

dsh-activity-hud/
├─ start-hud.vbs 双击启动（无窗口） ├─ stop-hud.ps1 停止全部进程 ├─ install-startup.ps1 开机自启（-Remove 取消） ├─ watch.mjs 监听会话日志 → state.json ├─ hud.ps1 WPF 悬浮条（UTF-8 带 BOM，改它请保持编码） ├─ hud.config.json 配置 ├─ scripts/ │ └─ make-demo.mjs 生成演示状态 / 截图 ├─ demo/ 效果截图 ├─ state.json 运行时状态（自动生成） ├─ logs/ watcher.log / hud.log / activity.ndjson（自动生成） └─ run/ 进程号（自动生成）

logs/activity.ndjson 是每次动作的流水（什么工具、耗时多少、哪个会话），可以事后对账。

排查

双击没反应？ 看 logs/watcher.log。没有这个文件说明 Node 没跑起来（没装 / 不在 PATH）。

想看它现在认为你在干什么：

node watch.mjs --once

直接打印当前状态，不写文件、不拉悬浮条。

悬浮条内容乱码？ hud.ps1 存盘时被改成了无 BOM 的 UTF-8。用记事本「另存为」选 UTF-8 带 BOM。

一直亮着不消失？ 说明确实有工具在跑。看 state.json 里的 main.detail，或直接 stop-hud.ps1。

彻底不想用了： stop-hud.ps1，然后删掉整个文件夹即可——它没往别处写任何东西（除了 DeepSeek 自己本来就会写的 ~/.dsh 会话日志）。

隐私

- 只读本机上 DeepSeek 自己的会话日志，不截屏、不记录按键、不联网、不上传。
- logs/activity.ndjson 留在本机，可随时删除。

已知限制

- 只在「有工具在跑」时点亮，纯思考不亮（故意的，否则几乎常亮）。
- 覆盖所有会话，无法只盯某一个窗口（可作为 v1.1 的过滤项）。
- 依赖 DeepSeek Harness 的会话日志格式（session.v4）。如果宿主换了格式，需要小改 watch.mjs。
- 仅 Windows（悬浮条基于 WPF；watch.mjs 本身跨平台）。

A tiny always-on-top HUD for DeepSeek Harness on Windows: whenever the agent actually touches your machine (runs a command, edits a file, spawns a job), a click-through pill appears at the top of the screen showing what it is doing and for how long. Amber = mutating, blue = read-only, green = just finished. It never steals focus, never blocks a click, and hides itself after 2.5 s of idle.

It works by tailing DSH's own session event log (~/.dsh/sessions/*/session.v4.jsonl.zstd), pairing tool/call with tool/result — read-only, no injection, no network.

Requires Windows 10/11 and Node.js 18+. Double-click start-hud.vbs.

License

MIT © 2026 Miao Junhao