dsh-taskcompletednotification-plugin
DeepSeek Harness 的 Windows Toast 通知：一轮对话完成，或模型需要用户确认某项操作。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:S1m0n1314/dsh-TaskCompletedNotification-plugin#96f13c342c3330d8a83206782b3a2939628a0363Taskcompletednotification Plugin 以 dsh-taskcompletednotification-plugin 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness 的 Windows 桌面通知插件：任务跑完、模型在等你选择、模型在申请操作权限时， 弹一条 Windows 横幅通知；点一下横幅，DSH 窗口会被拉到前台。
它解决的问题很简单：DSH 在后台跑长任务时，你不可能一直盯着窗口。以前你只能反复切回来看进度； 装上它以后，该回来的时候它会主动叫你。
名字说明：npm 包名必须全小写，所以是
dsh-taskcompletednotification-plugin； GitHub 仓库名大小写不敏感，用的是dsh-TaskCompletedNotification-plugin。 安装时用的是 npm 那个小写包名，两者是同一个插件。
| 场景 | 通知标题 | 通知正文 |
|---|---|---|
| 一轮任务跑完 | DeepSeek Harness | 任务完成 |
模型调用 ask_user_question 等你选择 | DeepSeek Harness | 任务操作待确认 |
| 模型申请沙箱/权限升级等你授权 | DeepSeek Harness | 任务操作待确认 |
dsh plugin --profile web add dsh-taskcompletednotification-plugin
包名与仓库名一致（
package.json的name就是它）。这条命令要求包已经发布到 npm 仓库 —— 本插件目前尚未发布，所以现在请先用下面两种方式安装；一旦发布，上面这条命令即可直接使用。
dsh-taskcompletednotification-plugin-<version>.zip 并解压
（例如 D:\plugins\dsh-taskcompletednotification-plugin-0.1.0）；plugin_manager action=install_bundle target="D:\plugins\dsh-taskcompletednotification-plugin-0.1.0"
git clone https://github.com/S1m0n1314/dsh-TaskCompletedNotification-plugin.git D:\plugins\dsh-taskcompletednotification-plugin
然后同样用 install_bundle 指向该目录。
把目录加进 profile 的 package.json 依赖，并在 profile 的 cordis.patch.yml 里插入：
- insert:
- id: dsh-taskcompletednotification-plugin
name: 'dsh-taskcompletednotification-plugin'
以上任一方式装完，都要完全退出并重启 DSH —— 插件模块只在启动时载入一次。
设置 → 系统 → 通知 里关掉「DeepSeek Harness」，或把插件配置里的
enabled 设成 false。改 profile 的 cordis.patch.yml 里 dsh-taskcompletednotification-plugin 那一行的 config，改完完全重启 DSH。
未填字段用默认值。
| 字段 | 默认 | 含义 |
|---|---|---|
enabled | true | 总开关，false 时不注册任何监听。 |
notifyOnTurnEnd | true | 任务完成通知。 |
notifyOnQuestion | true | 模型提问通知。 |
notifyOnApproval | true | 模型申请权限通知。 |
minTurnMs | 0 | 短于该毫秒数的轮次不弹完成通知（0 = 不限制）。 |
quietWhenActiveMs | 0 | 0 = 完成通知一定弹；设 15000 表示「15 秒内你动过键鼠就不弹」（你正看着屏幕，不打扰）。 |
suppressTurnEndAfterAsk | true | 一轮只弹一条：本轮回过问过/申请过权限，轮末不再弹「任务完成」。 |
title | DeepSeek Harness | 通知标题，同时作为注册的显示名。 |
focusOnClick | true | 点击横幅把 DSH 窗口拉到前台。 |
registerAppId | true | 注册通知署名与图标。 |
timeoutMs / maxConcurrent / log / probe | 15000 / 3 / true / false | 通知进程上限、并发数、诊断日志、诊断模式。 |
配置示例（关闭点击激活 + 只在离开电脑时提醒完成）：
- id: dsh-taskcompletednotification-plugin
name: 'dsh-taskcompletednotification-plugin'
config:
focusOnClick: false
quietWhenActiveMs: 15000
截图待补：需要在 Windows 上真机弹一条通知后截取横幅与通知中心两个画面。 你可以自己用
node tools/send-test-toast.mjs "测试"弹一条来截，我会在这一节放图。
插件不需要管理员权限，只使用当前用户可写的资源。具体会动到：
| 类别 | 具体内容 | 用途 |
|---|---|---|
| 用户目录写入 | %USERPROFILE%\.dsh\dsh-taskcompletednotification-plugin\（log.ndjson、spool\、lib\） | 诊断日志、通知暂存、点击处理器副本 |
| 用户级注册表（HKCU） | HKCU\Software\Classes\AppUserModelId\DeepSeek.Harness.Notify | 让通知署名显示为「DeepSeek Harness」+ 图标 |
| 用户级注册表（HKCU） | HKCU\Software\Classes\dsh-taskcompletednotification-plugin | 注册 dsh-taskcompletednotification-plugin:// 协议，实现「点击横幅拉起窗口」；插件卸载时会自动删除 |
| 进程 | 每次通知启动一个 powershell.exe（约 1 秒，用完即退，最多 3 个并发） | 调用 Windows 通知 API |
| 网络 | 无 | 插件本身不联网 |
不想要某些改动：registerAppId: false 关闭署名注册、focusOnClick: false 关闭点击激活、
enabled: false 彻底停用。
1. 事件从哪来 —— 插件挂在 Harness 宿主进程上，只旁听三类信号，从不干预：
会话日志里的 turn/end（reason.kind === 'completed'）、user-questions/request、
approval/request。监听器注册在 ctx.root（服务根）上并带 { global: true }：
插件自己拿到的 context 不是服务根，而两个 request 事件是按 agent 作用域过滤的 waterfall，
不加这两条会被静默过滤掉、一个事件都收不到。
2. 怎么变成通知 —— lib/index.js 把标题正文拼成 toast XML（自带 XML 转义），写进
$DSH_HOME/dsh-taskcompletednotification-plugin/spool/，再起一个 powershell.exe 执行 lib/notify.ps1；后者只做
LoadXml + CreateToastNotifier(<已注册 AUMID>).Show()，并把结果写回同名 .result.txt 便于排查。
3. 署名与图标 —— 启动时把 DeepSeek.Harness.Notify 注册到
HKCU\Software\Classes\AppUserModelId\，Windows 才会把通知显示成「DeepSeek Harness」。
4. 点击拉起窗口 —— 通知带 activationType="protocol" 与 launch="dsh-taskcompletednotification-plugin://focus"，
点击时由系统按协议启动一个无窗口的 wscript 启动器，再跑 lib/focus-window.ps1：
定位标题以 DeepSeek Harness 结尾的主窗口、必要时从最小化恢复，并在 SetForegroundWindow
被前台锁拒绝时依次改用 AttachThreadInput、按住 ALT 再抢。
node tools/smoke.mjs # 39 项离线测试，不需要 Windows 也能跑
node tools/send-test-toast.mjs "正文" # 走插件自己的链路真弹一条
node tools/verify-click-focus.mjs # 验证「点击拉起窗口」这条链
node tools/pack.mjs # 重新打包发行版到 ../dist/
node tools/release.mjs --dry-run # 预览 GitHub Release 内容
npm run release # 打包 + 发布 Release（需 repo 权限的 GitHub 凭据）
MIT © 2026 S1m0n1314 —— 可自由使用、修改、分发，保留版权声明即可。
由 ai 生成，仅供参考