dsh-session-hud：DeepSeek Harness 会话悬浮窗插件

前言¶

DeepSeek Harness (DSH) 在运行长任务时，用户往往会切到其他窗口，导致无法实时掌握当前进度或遗漏待批准的工具调用。dsh-session-hud 插件旨在解决这个问题，它将运行中会话的当前工作内容与待批准提示实时推送到一个独立的 WinUI 3 悬浮窗中。

该插件由 xieani090612 维护，采用 MIT 协议开源。

核心功能¶

• 独立悬浮窗：基于 WinUI 3 构建，独立于 DSH 主界面运行。
• 实时状态展示：显示运行中会话的当前工作与待批准提示。
• 窗口交互：支持窗口拖动、缩放、置顶，并跟随系统明暗主题。
• 自适应布局：界面会随窗口大小自适应，支持列表与格子双视图切换。
• 便捷入口：在 DSH 侧边栏提供打开按钮，支持 /hud 命令调用。

安装¶

1. 确保当前 DSH 版本包含插件系统。
2. 执行安装命令（需替换 <profile> 为你的配置档名称）：

dsh plugin --profile <profile> add file:C:\path\to\dsh-session-hud-1.1.0.tgz

也可以使用 link: 方式指向本地目录：

dsh plugin --profile <profile> add link:C:\path\to\dsh-session-hud

安装完成后需要重启 DSH 以加载新模块。

使用方式¶

• 命令调用：在 DSH 中输入 /hud 即可唤出悬浮窗。
• 侧边栏入口：插件加载后，会在 DSH 侧边栏提供相应的打开按钮。
• 窗口操作：窗口支持自由拖动、缩放。可以将窗口拖至副屏或缩小至单条显示。

技术细节与限制¶

• 平台依赖：仅支持 Windows 10 及以上系统。
• 零运行时依赖：dist/ 目录为自包含发布，用户无需安装 .NET 运行时或 Windows App Runtime。
• 通信机制：插件宿主与悬浮窗通过临时文件加原子重命名的方式交换状态快照，避免并发读取问题。
• 图标授权：插件代码遵循 MIT 协议，但默认图标（来源于立绘生成）的版权不在 MIT 覆盖范围内。如需重新分发，需单独确认图标权利或自行替换 assets/icon-source.webp 并重新生成 app/app.ico。

总结¶

dsh-session-hud 通过原生 WinUI 3 窗口为 DSH 提供了即时的状态监控能力，解决了长时间运行任务中状态丢失或操作遗漏的问题。对于需要在多任务环境下管理 DSH 会话的开发者，该插件提供了一个轻量级且不依赖复杂运行时的解决方案。

GitHub 仓库 | 插件目录