前言¶
用 DeepSeek Harness（DSH）跑 agent 时，执行轮次、授权弹窗、待回答问题往往发生在主界面里。窗口被别的应用盖住或最小化到任务栏后，很难判断「现在是否在跑」「是否在等我点同意」。DSH 生态里插件承担扩展能力；dsh-plugin-desktop-hud 由维护者 D00023 发布，分类为客户端，在 Windows 桌面上提供始终置顶的 HUD 卡片，通过本地状态文件反映 DSH 会话，不接管授权流程本身。
这是什么¶
dsh-plugin-desktop-hud（npm 包名同仓库名）是一款 DeepSeek Harness 的 Cordis 宿主插件，搭配预编译的 WPF 覆盖层 HUD.exe。简介所述：在桌面展示运行中任务、授权请求、已完成轮次，并支持多会话任务列表。
- 维护者：D00023
- 许可证：MIT（见仓库 README 与
package.json） - 目录页：SkillHub 插件条目
- 源码：github.com/D00023/dsh-plugin-desktop-hud
社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系；安装插件前宜自行审阅源码与许可证。插件随当前 DSH 进程权限运行，HUD 仅观测事件，不参与审批链路。
核心功能¶
两种形态、六种状态¶
空闲时卡片收成右下角小胶囊（● DSH 空闲）；有活动轮次时展开为带会话标题的卡片。README 列出六种可区分的状态（颜色与动效各异）：
| 状态 | 卡片展示 | 视觉 |
|---|---|---|
| 空闲 | ● DSH 空闲 |
暗淡胶囊，占位小 |
| 执行中 | 会话标题 + 执行中 |
蓝色呼吸点 + shimmer |
| 需授权 | 会话标题 + 需要你授权 |
琥珀色边框脉冲 |
| 待回答 | 会话标题 + 需要你回答 |
蓝色高亮 |
| 轮次完成 | ✓ 任务完成 |
绿色闪烁，约 15 秒后收起 |
| 错误 | 会话标题 + 出错了 |
红色，至下一轮开始 |
状态文案目前为中文；README 称本地化在路线图中。卡片置顶、不进任务栏、不抢焦点；需你介入时可用琥珀（授权）或蓝色（问题）脉冲提示，单击可将 DSH 拉回前台。
多会话任务列表¶
同时跑多个会话时，卡片显示数量角标与 ⌄ 展开符；展开后最多纵向堆叠 4 条任务，其余收成 +N 个任务。子 agent 与工作流归入所属根会话，避免内部流量撑爆列表。
旁路观测、本地无网¶
宿主插件监听 agent/status、approval/request、user-questions/request、agent/error、session/event 等事件，维护每会话状态机，原子写入 %LOCALAPPDATA%\dsh-desktop-hud\state.json（v3，约 2 秒心跳）。HUD.exe（.NET Framework 4.8，仓库内预编译）通过 FileSystemWatcher 与轮询读该文件并渲染。对自动通过的授权有约 600 ms 防抖，避免闪屏。若文件 10 秒未更新，覆盖层自行退出。README 明确：无运行时 npm 依赖、无网络调用、无需管理员权限；协议见仓库 PROTOCOL.md，视觉参数见 overlay/UI-SPEC.md。
环境要求¶
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 10 或 11，x64 |
| 运行时 | .NET Framework 4.8（Windows 10/11 自带） |
| DSH | DeepSeek Harness 0.2.x（README 写明在 0.2.2-rc.1 上测试） |
| 显示器 | 任意；卡片锚定在主显示器右下角 |
不支持 macOS 与 Linux：覆盖层为 Windows WPF 窗口。
安装与启用¶
将 desktop 换成你实际使用的 profile（dsh plugin --help 可查看 --profile 说明）。执行添加后 DSH 会提示重启应用；插件加载后 HUD 出现在主屏右下角。
dsh plugin --profile desktop add github:D00023/dsh-plugin-desktop-hud
卸载时先可选地在 HUD 上右键选择「退出小窗」，再执行：
dsh plugin --profile desktop remove dsh-plugin-desktop-hud
然后重启 DSH。
典型用法¶
| 操作 | 效果 |
|---|---|
| 左键单击卡片或某条任务 | 将 DSH 置于前台（若已最小化则还原） |
⌄ / ⌃（≥2 个任务时出现） |
展开 / 收起任务列表 |
| 拖动 | 移动卡片；位置写入 %LOCALAPPDATA%\dsh-desktop-hud\window-v1.json |
| 右键 | 「回到 DSH」「隐藏 30 分钟」「退出小窗」 |
| 悬停 | 边框变亮，提示可点击 |
若选择「退出小窗」，HUD 会保持隐藏直至下次重启 DSH，以免关闭后立刻再现。
开发者可在不启动 DSH 时用 overlay/bin/HUD.exe --demo 等参数预览状态（详见 README「Development」一节）；日常使用只需安装插件并重启 DSH。
适用场景与注意¶
适合：在 Windows 上长期开着 DSH、多会话并行、经常切到其他窗口但仍需感知「执行中 / 待授权 / 待回答」的开发者。
注意：
- 仅 Windows x64；Linux / macOS 用户无法使用此 HUD。
- 与 DSH
0.2.x配套；大版本升级后宜对照仓库 Requirements 再测。 - HUD 故障时最多停止刷新，不应影响 DSH 本体；权限与数据均在本机
%LOCALAPPDATA%\dsh-desktop-hud\。 - 安装前阅读
index.js、hud-bridge.js与PROTOCOL.md，确认与本地安全策略一致。
结语¶
dsh-plugin-desktop-hud 用「宿主写 JSON、WPF 读 JSON」的侧信道，把 DSH 的运行与待办状态钉在桌面一角，多会话时还能展开简表，单击回主程序。需要进一步了解功能与截图时，可打开 SkillHub 目录页 或 GitHub 仓库 README。
