前言¶
在 DSH（DeepSeek Harness）里跑长对话或等 Agent 收工时，如果窗口不在前台，很容易错过「这一轮已经结束」的时机。Codex、ChatGPT 等客户端普遍会在回合结束时弹出系统级提示，而 DSH 桌面版原先没有同类能力。下面介绍社区插件 dsh-reply-notify：在 Windows 上于 Agent 从运行态回到空闲时触发桌面 Toast，并在设置里选择「从不 / 仅窗口不在前台时 / 始终」。
这是什么¶
dsh-reply-notify 由维护者 guiwowow 发布，归类为 客户端 插件，当前在 GitHub 上星标为 0。它只做一件事：在 一轮（turn）完成 时发出 Windows 桌面通知，行为上对齐「Codex 式回合完成提醒」，而不是在页面里用浏览器 Notification API（作者在实现说明里写明：在桌面壳里该 API 会静默失效）。
插件版本（见仓库 package.json）为 0.3.2，许可证 MIT；要求 DSH 桌面版 0.2.2-rc.1 或更新（engines.dsh: >=0.2.2-rc.1 <0.3.0-0）。
核心功能¶
三种通知策略¶
在 DSH 中打开 Settings → General → 回答完成通知 / Turn completion notifications，可选：
| 选项 | 行为 |
|---|---|
| 从不 / Never | 不通知 |
| 仅窗口不在前台时 / Only when unfocused | 仅当 DSH 窗口在后台时通知 |
| 始终 / Always | 即使窗口在前台也通知 |
主机端与客户端分工¶
- 主机端（
index.js）监听宿主agent/status事件；当状态由running变为idle时，通过toast.ps1（WinRT，AppUserModelId为com.deepseek.dsh）弹出 Windows Toast。 - 客户端（
client.js）渲染设置行，并向主机汇报客户端才能知道的两项信息：当前模式、窗口是否聚焦；通过POST /__dsh-reply-notify/state同步。 - 子 Agent 会话不触发通知；一轮只弹一次 Toast。
日志与调试¶
决策日志写在：
%USERPROFILE%\.dsh\reply-notify.log
每行一条决策，例如 skip … (window focused)、toast "…"、ps: shown。
在控制台可调用 __dshReplyNotify.test()，向主机请求一次测试 Toast，用于确认 WinRT 链路是否正常。
安装与启用¶
环境：Windows，且已安装 DSH desktop 0.2.2-rc.1 或更新。
官方 README 给出的安装方式如下（上架插件市场后也可用市场搜索；未上架前以手动方式为准）。
- 插件市场（上架后）：在市场中搜索
dsh-reply-notify安装。 - 手动安装：把插件目录复制到用户目录下的 DSH 插件源码路径，在桌面 profile 中以 bundle 方式安装，然后 重启 DSH 一次（主机端仅在启动时加载）。
手动路径与步骤原文为：
~/.dsh/plugins/src/
将本仓库对应文件夹放入上述目录后，在 DSH 桌面 profile 中安装为 bundle，并重启 DSH。
插件无独立 build 步骤；仓库内 test/ 为宿主与客户端测试套件。
典型用法¶
- 完成安装并重启 DSH。
- 打开 Settings → General，找到 回答完成通知 / Turn completion notifications。
- 按使用习惯选择 Never、Only when unfocused 或 Always。
- 发起一次 Agent 对话，等待一轮结束；若策略允许且状态满足条件，应出现系统 Toast。
- 若无 Toast，查看
%USERPROFILE%\.dsh\reply-notify.log，或在控制台执行__dshReplyNotify.test()做隔离测试。
适用场景与注意¶
适合谁：在 Windows 上使用 DSH 桌面版、经常把 DSH 放到后台做编码或批处理任务，又希望回合结束时收到系统级提醒的开发者。
平台与生态：实现依赖 Windows + WinRT Toast，不是跨平台通用通知方案；仅面向 DSH 桌面壳，而非纯 Web 会话。
安全与信任：插件以 当前 DSH 进程权限 运行，会监听 Agent 状态并在本机执行 toast.ps1。安装前建议在 GitHub 仓库 阅读源码与 MIT 许可证，再决定是否启用。
社区目录：插件介绍与索引见社区站点 SkillHub 目录页。DSH 生态强调「一切皆插件」；该目录为社区维护，与 DeepSeek / 幻方无官方从属关系，不宜理解为官方应用商店。
结尾¶
dsh-reply-notify 补上 DSH 桌面端「回合完成提醒」这一小块体验：可配置、尊重窗口焦点，并用 Windows 原生 Toast 而非浏览器通知 API。需要源码、问题反馈或手动安装包时，见 https://github.com/guiwowow/dsh-reply-notify；在插件市场中亦可按名称 dsh-reply-notify 检索（上架后）。
