dsh-task-notify — 任务完成通知插件

会话停止/阻塞时提醒：右上角 toast + 提示音（WebAudio）+ 系统通知（Windows/macOS 通知中心，页面失焦时弹）。

• 对话完成（以工作区命名，如 all_paper 任务完成）
• 目标完成 / 目标受阻（目标模式）
• 执行出错
• 需要审批（审批请求弹出时）
• 需要你回答（提问面板弹出时）

设置侧栏 →「任务完成通知」可配置：提示音开关、音量（带试听）、四种音调、通知图标、各事件独立开关；配置持久保存。恢复焦点时系统通知自动关闭。

纯本地运行，无任何数据外传；跨平台（声音用浏览器 WebAudio，无平台依赖）。

---

仓库结构（根目录即 npm 包）

dsh-task-notify/
├── package.json          包声明（dsh.client 客户端入口声明）
├── lib/
│   ├── index.js          宿主半边（事件监听 + 队列 + HTTP 接口 + 配置）
│   └── client.js         客户端半边（__ModuleLoader__ bundle：toast/声音/系统通知/设置页）
├── install.ps1           安装/卸载脚本（自动探测、备份、幂等）
├── install.bat           双击安装入口
├── uninstall.bat         双击卸载入口
├── cordis.patch.sample.yml  手动安装用的组合行样例
├── README.md / LICENSE / .gitignore

安装

方式一：双击（推荐） —— 双击 install.bat（窗口显示进度，完成后按任意键关闭）。

方式二：命令行

powershell -ExecutionPolicy Bypass -File install.ps1

脚本自动完成：探测 DSH_HOME（默认 ~/.dsh）→ 找到用户补丁层 cordis.patch.yml → 备份原文件 → 复制 package.json + lib\ 到运行时 node_modules → 追加组合行（幂等，重复执行安全）。

安装后：刷新 DSH Web 页面（F5）；若提示未出现，重启 DSH。首次系统通知时浏览器会询问权限，点允许。

手动安装（不跑脚本）

1. 把本仓库（package.json + lib\）复制到 DSH 运行时包目录（含 @deepseek-ai/cordis 的那个 node_modules，本机为 ~/.dsh/profiles/node_modules/dsh-task-notify/）；

2. 在用户补丁层 cordis.patch.yml（本机为 ~/.dsh/profiles/web/cordis.patch.yml）末尾追加（文件内容只有 [] 时把 [] 替换掉）：

   - insert:
       - id: task-notify
         name: dsh-task-notify
   

3. 刷新页面 / 重启 DSH，授权通知。

验证

• 设置侧栏出现「任务完成通知」设置页（含试听按钮）；
• 任一对话完成后，右上角弹出绿色 toast 并播放提示音；
• 切到其他窗口后再触发任务，右下角出现系统通知；切回 DSH 页面，系统通知自动关闭。

升级

git pull            # 或重新下载仓库
powershell -ExecutionPolicy Bypass -File install.ps1

脚本幂等：已安装时跳过组合行写入，直接覆盖 与 。刷新页面（客户端改动热生效）或重启 DSH（宿主改动）后完成。