前言¶
在使用 DeepSeek Harness（DSH）进行智能体开发时，Agent 常常处于等待人工介入的状态，例如需要授权工具或回答问题。开发者通常需要手动盯着 DSH 窗口，这会打断当前的工作流。这个插件通过 Windows 原生通知解决这一问题，允许 Agent 在后台运行时主动通过系统横幅或卡片告知状态，开发者无需一直聚焦窗口即可掌握进度。
插件简介¶
这是一个由 VoodooB0Ys 维护的 DSH 插件。它提供 Windows 原生 Toast 横幅和全屏兜底卡片，在 Agent 需要授权、提问、完成、出错或中止时触发提醒。点击通知即可直接切回对应的 DSH 对话，实现分屏工作的无缝衔接。
核心功能¶
- Windows 原生 Toast 横幅：使用系统原生通知渠道。
- 全屏兜底卡片：当横幅被 Windows 压掉时，显示自定义置顶卡片。
- 事件提醒：支持授权、提问、完成、出错、中止五种事件。
- 点击交互：点击通知将切换回对应对话并滚动至最新消息。
- 聚焦抑制：当开发者正看着该对话时，不会弹出干扰。
- 子代理提醒：支持为子代理/会话开启提醒（默认关闭）。
- 去重机制：短时间内同一事件只提醒一次。
安装与启用¶
使用 DSH 插件管理器进行安装：
github:VoodooB0Ys/dsh-desktop-notify
安装后需重启 DeepSeek Harness 宿主进程（热重载不生效）。
典型用法¶
安装完成后，插件默认启用。可以通过编辑 profile 的 cordis.patch.yml 来调整提醒行为，例如关闭原生横幅、调整去重时间窗口或设置子代理提醒开关。
适用场景与注意¶
- 系统要求：仅支持 Windows 10/11 (x64)。依赖 PowerShell 5.1 和 .NET Framework 4。
- 版本要求：需要 DSH 0.2.0-rc.2 或兼容版本。
- 运行机制：需要注册 COM 激活器以实现点击通知切换对话的功能。
- 热重载限制：修改代码后必须重启宿主进程，插件在启动时注册路由。
- 回合判定：短于 5 秒的回合结束不算作“完成”。
- 权限：插件以当前 DSH 进程权限运行，请从可信源安装。
短结尾¶
dsh-desktop-notify 解决了智能体开发中“盯着屏幕等待”的痛点，让 Agent 的长任务可以在后台静默运行，仅在你需要它时出现。更多详情请访问 GitHub 仓库。
