前言¶
在 DeepSeek Harness（DSH）里跑智能体改代码，常见情况是：分支和 ahead/behind 要切到终端或 IDE 看，本轮动了哪些文件、差异审到哪一步，往往散落在内置卡片和日志里。工具调用、技能使用、会话跑了多久，也没有固定的一行汇总。
下面介绍社区插件 dsh-hud（npm 包名 @konnga/dsh-hud）。它在输入框上方挂三枚胶囊，点 Git 胶囊可打开浮动面板看改动清单与差异；并补充本会话改动归因、审阅进度、图片前后对比、侧栏会话摘要，以及空输入框按 ↑ 召回上一条 prompt。维护者为 konnga，分类为客户端；项目在 GitHub 上约 3 stars，许可证 MIT。
这是什么¶
dsh-hud 是面向 DSH 的 Heads-up display：只读展示当前工作区的 Git 状态与差异，同时把「这个会话改过哪些文件、审到哪了、跑了什么工具、会话运行多久」收进同一行 HUD。
宿主侧通过 git 与 /dsh-hud-rpc 提供数据；客户端在浏览器里渲染胶囊与面板。部分能力依赖宿主内置投影（如 sessionStats、turnOutline）；投影不存在时对应功能会静默不启用，不会编造数据。
核心功能¶
三枚胶囊（输入框上方）¶
从左到右依次为 Git、工具与会话计时。悬停提示由插件自绘气泡（非浏览器原生 tooltip），便于在真机上稳定显示。
Git 胶囊示例：
dsh-hud · git:(main*) ↑1 ↓2 M4 A1 ?1 │ ●3
含义包括：工作区名、分支（* 表示工作区不干净）、与上游的领先/落后、改动计数（M 改、A 增、D 删等），以及本会话确定改过的文件数（●3）。点击打开面板。
工具胶囊展示正在运行的工具（带实时秒数）、各工具调用次数与最近结果（✓/✗），以及用过的技能名；条目过多时收成 +k，悬停可看完整清单。
会话计时胶囊显示本次会话已运行时长（口径与 codex-hud 一致：现在 − 会话创建时刻）。悬停可补充创建时间、模型/工具耗时、轮次与步数（来自 sessionStats）；无投影时仅显示挂钟时长。
Git 面板与差异¶
点 Git 胶囊打开可拖动的面板：改动概览、本会话改了哪些（可开关「只看本会话改的」「只看最近一轮」）、改动清单、最近提交、标签。点清单行或提交行可在右侧看差异或提交明细。
差异栏支持未暂存/已暂存切换、自动换行、复制差异；hunk 可折叠。图片类文件（按文件头识别 PNG/JPEG/GIF/WebP/BMP）提供并排前后对比与尺寸、字节变化说明，并支持缩放档位（默认适应宽度，档位会记住）。
改动清单行首 ●/◐/○ 表示与会话归因的关系；行尾审阅标记可点选或按 v 切换，✓ 变黄表示文件又有新改动需重看。有审阅记录时显示 已审 3/8 与「清空已审」。
轮尾「本轮图片改动」¶
内置「已编辑 N 个文件」卡片不展示图片时，插件在轮尾列出本轮改过的图片缩略图：点缩略图在内置预览打开；点 ⇄ 打开面板看前后对比。最多展示 4 张加「还有 N 个」；本轮未动图则不渲染该条。
侧栏会话行¶
悬停或点行尾 ⋯ 可看到 git 摘要与会话归因，例如「本会话改过 3 个文件」及从命令推断的可能改动路径。
键盘与 prompt 召回¶
面板激活后支持 ↑↓、Enter、[ ]、n p、Space、v、r、Esc 等快捷键（不与 Cmd/Ctrl/Alt 组合及输入框抢键）。
输入框为空时按 ↑ 可召回上一条纯文本 prompt（数据来自会话日志的 turnOutline）；非空输入框不接管。实现上贴近 Lexical 的 contenteditable，宿主改结构时可能失效并静默禁用。
安装与启用¶
桌面端打开「设置 → 插件 → 添加插件」，填入包名：
@konnga/dsh-hud
本地开发可将 profile 依赖指向仓库（改动即时可见；客户端代码需重启应用才重读）：
"@konnga/dsh-hud": "link:/path/to/dsh-hud"
运行环境要求 Node.js >= 20（见项目 README 徽章说明）。当前 npm 发布版本在资料中为 0.9.2。
典型用法¶
- 安装并启用插件后，在任意绑定工作区的会话里看输入框上方是否出现三枚胶囊。
- 需要看分支、改动计数或本会话改过几个文件时，看最左 Git 胶囊；需要点开差异或审阅清单时，点击 Git 胶囊打开面板。
- 审代码时在改动清单中逐行打开差异，用
v或行尾标记记录已审；图片改动用差异栏并排视图或轮尾⇄对比。 - 想重复上一条指令时，清空输入框后按
↑（继续按可翻更早的 prompt）。
面板内刷新可点标题栏 ⟳；差异栏与提交明细栏宽度可拖动，宽度会记住。
适用场景与注意¶
适合：在 DSH 里长时间写代码、跑工具的智能体开发者，希望少切窗口就能掌握 Git 状态、差异审阅进度、工具/技能活动与会话时长。
注意：
- 插件以当前 dsh 进程权限 运行，会读取工作区 git 状态；安装前请查看 源码 与 MIT 许可证，自行评估信任边界。
- 社区目录 skillhub.cn 与 GitHub 为独立信息源，与 DeepSeek / 幻方无官方从属关系；版本与功能以你安装的包为准。
- 会话计时、prompt 召回等依赖宿主服务与投影；会话刚恢复的头几秒可能尚无
sessionStats，插件会按 README 描述重试轮询。
结尾¶
dsh-hud 把 Git 面板、差异与图片对比、会话改动归因、审阅进度、工具活动与会话计时收进 DSH 输入框上方一行，减少在终端、IDE 与聊天卡片之间来回切换。
