在使用 DeepSeek Harness 进行智能体开发时，会话往往包含多个步骤和中间状态。开发者需要在页面内快速确认任务完成、处理审批或查看错误，而系统原生的交互可能不够直观，或者历史记录机制不支持实时回溯。@idoall/dsh-notify 旨在解决这一场景下的状态追踪与即时反馈问题。
插件简介¶
这是一个 DeepSeek Harness 插件，用于在页面内展示任务通知。它提供清晰的状态提示、可折叠的通知堆栈、声音反馈以及后台标签页的视觉关注。通知仅以实时方式传递，记录不会存储在历史记录中。
核心功能¶
1. 通知样式
支持「增强」或「柔和」两种模式。增强模式使用清晰的状态颜色（如绿色表示完成、蓝色表示问题、琥珀色表示审批）和四秒的注意力条；柔和模式则是更低调的展示。卡片会一直保留，直到手动关闭、打开对应会话或在卡片内完成回答。
2. 可折叠堆栈
通知以卡片形式堆叠在页面右上角。默认开启折叠，新卡片完全可见，旧卡片保留在下方。页面内存中最多保留 50 张卡片，并优先处理待办操作。
3. 直接导航与回答
点击卡片可直接跳转至对应会话的特定轮次。卡片内提供与 Composer 兼容的选项，可直接在 Toast 中完成回答。
4. 声音与后台关注
内置 WebAudio 提示音，支持自定义音频。即使页面在后台标签页，也能通过 Favicon 或标题前缀获得视觉/听觉提醒。
5. 状态判定
通知在 Agent 进入 idle 状态时触发，而非仅仅基于文本完成或计时。这意味着只有任务真正停止时才会产生卡片。
6. 任务噪声控制
默认关闭子任务、后台作业和流程工作流的完成通知，避免信息过载。
7. 版本检测
设置页面会检测本地版本与 npm 最新版本的差异，并提供升级命令。
安装与启用¶
插件需要 DeepSeek Harness Web 配置文件支持。安装命令如下：
dsh plugin --profile web add @idoall/dsh-notify@latest
也可以从 GitHub 直接安装：
dsh plugin --profile web add "github:idoall/dsh-notify"
典型用法¶
安装完成后，在设置中选择通知样式（Enhanced 或 Soft）。若需使用自定义声音，需上传文件到配置目录的 <dataDir>/sounds/ 文件夹。支持的格式包括 mp3、m4a、aac、wav、ogg 和 flac，文件大小限制为 1MB。
适用场景与注意事项¶
适用场景：需要精细管理长会话状态、习惯在页面内快速响应审批或问题的开发者。
注意事项：
* 插件仅注册设置部分和页面覆盖层，不修改 DSH 源代码。
* 通知记录仅保存在内存队列中，刷新或重载后不保留。
* 不支持 Service Worker、Web Push 或操作系统级通知矩阵。
* 插件要求 DeepSeek Harness 版本 >=0.1.7-rc.1 且小于 0.3.0。
* 插件名称为 @idoall/dsh-notify，但内部 Cordis 名称和路由为 dsh-notify。
该插件通过页面内的轻量级交互，解决了 DSH 原生交互中状态反馈不明确的问题。更多细节请查阅插件目录或 GitHub 仓库。
