前言¶

在 Windows 上用 DeepSeek Harness（DSH）桌面端跑多个智能体会话时，主窗口一最小化，就很难一眼看出哪条会话在跑、哪条在等审批、哪条刚结束。切回 DSH 再翻列表也费时间。dsh-session-hud 是社区插件，在 DSH 最小化或隐藏时弹出一块始终置顶的玻璃风格浮层，集中展示会话状态，并支持一键回到对应会话。下文按「是什么 → 能做什么 → 怎么装 → 怎么用 → 注意点」说明，事实均来自插件 GitHub README 与 package 元数据。

这是什么¶

• 名称：dsh-session-hud（仓库 wangjiaqizero/dsh-session-hud）
• 维护者：wangjiaqizero（README 作者字段为 Session HUD contributors）
• 分类：客户端（DSH 插件目录归类为客户端）
• 许可证：MIT
• 当前版本（package.json）：0.1.0
• 定位：面向 DeepSeek Harness 的桌面浮层 HUD；DSH 在屏幕上时浮层隐藏，最小化或隐藏 DSH 时出现；仅支持 Windows 10/11（x64），macOS / Linux 暂未支持。

插件以 DSH desktop 0.2.x 为宿主，依赖桌面端的窗口状态上报；浏览器里跑的 dsh web 没有可跟随的桌面窗口，因此不适用。

核心功能¶

README 中已列出的能力如下，安装前可对照是否符合你的 workflow。

1. 跟随 DSH 窗口：DSH 可见时 HUD 隐藏；最小化或隐藏后出现；DSH 恢复后再隐藏。
2. 实时会话状态：运行中 / 等待审批 / 刚结束 / 错误，并显示工具名、回合或步骤、已用时间。
3. 一键回到会话：点击 HUD 中某一行会打开 DSH（若已最小化则恢复），并导航到该会话。
4. 贴边收纳（Edge dock）：把浮层拖到左、右或上边缘约 24 px 内，会收成细条标记（彩色信标 + 运行中会话数）；悬停展开，拖标题栏回屏内可恢复常规浮窗。
5. 行内审批：待审批卡片可在 HUD 上直接点「允许 / 拒绝」。
6. 页脚控制：透明度、始终置顶、「跟随」模式；设置与位置在重启后保留。
7. 隐私取向的日志：诊断日志按设计不记录会话标题、标识符或绝对路径。

浮层本身是 Electron 窗口；首次展示时会一次性下载 Electron 运行时（约 110 MB，与插件版本共享缓存）。

环境要求¶

安装与启用¶

在 DSH desktop 配置下添加插件，然后重启 DSH：

dsh plugin --profile desktop add dsh-session-hud

也可在 DSH 的 Plugins → Discover 中安装（以目录是否上架为准）。

重启后，侧栏页脚会出现「mobile window」类按钮；点击它，或最小化 DSH，即可显示 HUD。

首次运行与 Electron 运行时¶

首次显示浮层时，插件会把 Electron 运行时下载到：

%USERPROFILE%\.dsh\session-hud\runtime\

默认先试 npmmirror 镜像，失败则回退到 Electron 官方 GitHub release。若网络都不可达，可指向本机已有的 electron.exe：

$env:HUD_ELECTRON_PATH = "C:\path\to\electron.exe"

也可将已解压的 electron-v44.7.0-win32-x64 目录复制到上述 runtime 路径。

典型用法¶

下表摘自 README，便于日常对照。

本地通信走 127.0.0.1 的 41333–41342 端口桥接；除一次性下载 Electron 外不向公网发数据，README 称无遥测。运行时状态（窗口位置、贴边、透明度、日志等）在 %USERPROFILE%\.dsh\session-hud\；删除该目录可重置全部 HUD 状态。

卸载插件：

dsh plugin --profile desktop remove dsh-session-hud

卸载后 session-hud 目录默认保留（避免再次安装时重复下载运行时）；若要腾出空间并彻底重置，需手动删除该文件夹。

适用场景与注意¶

适合谁

• 长期在 Windows 桌面用 DSH 0.2.x，会同时开多条会话，且习惯最小化主窗口腾出屏幕的用户。
• 需要最小化 DSH 后仍能看运行 / 待审批状态，并希望从浮层直接审批或跳回会话的场景。

务必注意

1. 平台与宿主：仅 Win32；须用 DSH 桌面应用，不是 dsh web。
2. 插件权限：插件在当前 DSH 进程权限下运行，安装前建议自行查看 源码仓库 与 MIT 许可证。
3. HUD 不出现时：确认插件在 desktop profile 已启用并重启 DSH；DSH 在前台时 HUD 会刻意隐藏——需最小化 DSH 或点侧栏按钮。
4. 运行时下载失败：查看 %USERPROFILE%\.dsh\session-hud\logs\hud-host.log，重试（客户端 /hud/restart 或重启 DSH），或设置 HUD_ELECTRON_PATH。
5. 端口占用：41333–41342 均被占用时插件会报错，HUD 按钮可能显示「未连接」。
6. 升级后贴边布局异常：可删除 %USERPROFILE%\.dsh\session-hud\userdata\overlay-state.json 重置几何状态。
7. 调试：可选 HUD_DEBUG=1 开启诊断；README 强调内容为脱敏设计。

DSH 生态遵循「一切皆插件」；SkillHub 插件目录 为社区站点，与 DeepSeek / 幻方无官方从属关系，安装来源以你实际使用的 registry / Discover 列表为准。

结尾¶

dsh-session-hud 解决的是「DSH 最小化后会话状态不可见」这一具体问题：浮层置顶、可贴边、可审批、可一键回会话，且数据与桥接限于本机。若你在 Windows 上常驻 DSH desktop 0.2.x，可按上文命令安装并在首次运行时预留 Electron 下载时间与磁盘空间。

• 目录页：https://www.skillhub.cn/plugins/wangjiaqizero/dsh-session-hud
• GitHub：https://github.com/wangjiaqizero/dsh-session-hud