dsh-taskcompletednotification-plugin
[
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 窗口自动到前台（最小化也会被恢复）。
- 署名与图标是它自己：通知显示为「DeepSeek Harness」+ Harness 图标，而不是「Windows PowerShell」。
- 一轮只弹一条：同一轮里已经弹过「待确认」，这一轮结束时就不再重复弹「完成」。
- 子会话不打扰：subagent 产生的轮次不通知，只通知你本人所在的会话。
- 不干扰 Harness：全程只旁听事件，不改任何决定（审批/提问的执行路径完全不受影响）。
安装
从社区市场 / npm 安装（推荐）
dsh plugin --profile web add dsh-taskcompletednotification-plugin
> 包名与仓库名一致（package.json 的 name 就是它）。这条命令要求包已经发布到 npm 仓库 ——
> 本插件目前尚未发布，所以现在请先用下面两种方式安装；一旦发布，上面这条命令即可直接使用。
从发行包安装
- 在 Releases
下载dsh-taskcompletednotification-plugin-.zip并解压
（例如D:\plugins\dsh-taskcompletednotification-plugin-0.1.0）； - 让 DSH 安装这个目录：
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 —— 插件模块只在启动时载入一次。
使用说明
- 正常用 DSH 干活，什么都不用做。
- 任务跑完或模型需要你介入时，右下角会弹出通知（右下角横幅，同时进入通知中心）。
- 点横幅（或通知中心里的那条）→ 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 生成，仅供参考
