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 仓库 —— 本插件目前尚未发布，所以现在请先用下面两种方式安装；一旦发布，上面这条命令即可直接使用。

从发行包安装

1. 在 Releases 下载 dsh-taskcompletednotification-plugin-<version>.zip 并解压 （例如 D:\plugins\dsh-taskcompletednotification-plugin-0.1.0）；
2. 让 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 —— 插件模块只在启动时载入一次。

使用说明

1. 正常用 DSH 干活，什么都不用做。
2. 任务跑完或模型需要你介入时，右下角会弹出通知（右下角横幅，同时进入通知中心）。
3. 点横幅（或通知中心里的那条）→ DSH 窗口回到前台，接着操作即可。
4. 不想被打扰时：在 设置 → 系统 → 通知 里关掉「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 生成，仅供参考