前言¶
在 DSH 里跑长任务时，进度往往只出现在主界面或日志里，眼睛要来回找。若你习惯把窗口铺开到别的空间，很容易误以为任务已经停住。dsh-hud 是社区维护的客户端插件，在屏幕边缘用独立透明窗口浮出「聊天气泡」式通知，把 THINKING、WORKING、STEP DONE、COMPLETED 等事件接到本机 DSH 的 session/event 上，无需额外联网上报。下面介绍它做什么、怎么装、在什么环境下能出现气泡。
这是什么¶
- 名称：
dsh-hud（npm 包名），仓库 nuclearmilk/dsh-hud - 维护者：nuclearmilk
- 分类：客户端（设置侧栏注册「任务通知流HUD」页，桌面版由独立 Electron 进程承载气泡）
- 协议：MIT（README 与
package.json一致；资料中package.json版本为 1.5.1） - 定位：Cappella 风格的水润毛玻璃气泡 HUD，为 DeepSeek Harness 汇报任务进度
气泡数据仅在本地进程间流转；控制接口监听 127.0.0.1:52399，配置写在 Electron userData 下的 dsh-hud-config.json。
核心功能¶
四类进度气泡¶
插件按会话事件展示四种状态（README 约定）：
| 状态 | 行为要点 |
|---|---|
THINKING |
约 7 秒后自动淡出 |
WORKING |
全程常驻 |
STEP DONE |
短句小结 |
COMPLETED |
输出摘要 |
视觉与交互（设置页可调）¶
- 明暗双主题、透明度 20%～100% 拖动实时生效
- 移动模式可拖拽，锁定后坐标记忆
- 头像：莫奈渐变、纯色（色轮或
#8b5cf6等形式）、本地图片 - 本机已安装字体检索与切换
allRight：关闭时左右交替弹出；开启时整齐靠右
长任务与兜底¶
- 常驻「进行中」：未结束可显示「任务进行中 · 已运行 mm:ss」，设置页可关，默认开启
- 静默兜底：超过设定时长（默认 45 分钟）无进度事件时自动收起并留说明，避免宿主异常时气泡一直挂着
运行时自给¶
桌面版装完即可用，不需要预先安装 Electron，也不需要 dsh-pet 等插件。缺运行时时插件会从镜像拉取（README 示例为 electron 43.3.0，首次约 138 MB，之后复用 ~/.dsh/electron/）。可选用环境变量 DSH_HUD_ELECTRON、DSH_HUD_ELECTRON_MIRROR、DSH_HUD_ELECTRON_DIR、DSH_HUD_ELECTRON_VERSION 指定路径、镜像、目录或版本。
若拿不到任何 Electron 可执行文件，DSH 主流程仍运行，只是无桌面气泡；日志会 WARN，设置页有橙色提示。
安装与启用¶
桌面版（Windows / macOS / Linux App，推荐）¶
desktop profile 由 Electron 应用独占，命令行无法管理。请用界面安装：
- 打开 DSH → 设置 → 插件 → 添加插件
- 安装方式选 Git，输入框粘贴（不要带尖括号或中文说明）：
https://github.com/nuclearmilk/dsh-hud
- 点 安装，等进度完成
- 重启 DSH（气泡为独立 Electron 进程，由宿主在启动时拉起）
- 设置侧栏出现 「任务通知流HUD」 页即表示安装成功
也可用 Releases 的 dsh-hud-<版本>.tgz 下载地址安装。钉死版本示例：
https://github.com/nuclearmilk/dsh-hud#v1.5.1
# 后写 commit hash 亦可；不写则装默认分支最新代码。
命令行（仅非 desktop profile，例如 tui）¶
--profile 必填：
dsh plugin --profile tui add https://github.com/nuclearmilk/dsh-hud
对 desktop 执行会报错：profile "desktop" is managed exclusively by the Electron application。
本地开发可用 link：
dsh plugin --profile tui add link:/path/to/dsh-hud
更新与卸载¶
| 操作 | 做法 |
|---|---|
| 更新（Git / link） | 界面卸载后重装；link 方式 git pull 后重启 DSH |
| 卸载 | 设置 → 插件 → 选中 dsh-hud → 卸载 → 重启 DSH |
典型用法¶
- 按上文在桌面版 DSH 安装并重启。
- 打开 任务通知流HUD 设置页，按需调主题、透明度、位置、
allRight、常驻进行中、静默超时时长等。 - 在本机 DSH 正常发起会话任务；气泡随
session/event在屏幕边缘弹出。无需单独启动 HUD 进程。
若设置里有页但屏幕无气泡：常见于宿主不是 Electron 桌面（CLI / web profile）。桌面版一般不需额外处理；非桌面环境 README 说明气泡不会出现。
升级后界面仍旧：旧气泡可能是 detached 进程占用端口 52399；1.4.2 起启动时会向旧实例发 /api/quit。仍异常时可手动结束残留 electron 进程后重启 DSH。
适用场景与注意¶
适合：经常在桌面 DSH 跑 agent / 长步骤任务，希望余光能看到进度、又不想切回主窗口的人。
注意：
- 插件以当前 DSH 进程权限运行；安装前建议阅读仓库源码与 MIT 许可证。
- 社区目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系；星标等元数据以各站点实时为准（资料线索为 0 star）。
- 不联网、不上报；仍会在本机拉取 Electron 运行时（若本地尚无）。
结尾¶
dsh-hud 把 DSH 会话进度翻译成屏幕边缘的气泡通知，长任务有「进行中」计时与无事件超时收起，桌面版自带 Electron 获取逻辑。需要细节与排障表见仓库 README。
- 目录页：https://www.skillhub.cn/plugins/nuclearmilk/dsh-hud
- GitHub：https://github.com/nuclearmilk/dsh-hud
