回合完成或出错、模型提问、工具审批待处理时弹出 Windows 通知。未处理的审批每 5 分钟重复提醒,点击通知聚焦桌面端窗口(未运行时自动启动)。
安装
# Release 预构建包
dsh plugin --profile web add "https://github.com/happyde2b/dsh-win-notify/releases/latest/download/dsh-win-notify.tgz"
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:happyde2b/dsh-win-notify
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
DSH Windows 通知插件:任务完成、任务出错、需要用户选择/回答、需要审批时,弹出 Windows 右下角系统 Toast 通知(进通知中心);审批未处理每 5 分钟提醒一次;点击通知聚焦 / 启动 DSH 桌面端窗口。
适配官方桌面端
@deepseek-ai/dsh-desktop0.1.6-alpha.2(2026-09-19 验证:事件 API 与插件规范均未变)。
通知规则
| 场景 | 触发事件 | 行为 |
|---|---|---|
| 任务完成(仅顶层会话) | turn/end completed |
弹 "DSH 任务完成" + 会话标题/最近任务 |
| 任务出错(仅顶层会话) | turn/end error |
弹 "DSH 任务出错" + 错误信息 |
| 需要选择/回答 | tool/call ask_user_question |
弹 "DSH 需要你的回答" + 问题内容 |
| 需要审批(任何会话,含子代理) | approval/asked |
弹 "DSH 需要你的审批",未处理每 5 分钟提醒 |
| 审批已处理 | approval/decided |
停止提醒 |
| 子代理完成/出错 | 子代理会话 turn/end |
不通知 |
- 多条待审批合并为一条提醒通知("DSH 待审批提醒(第 N 次)")
- 前台/后台都弹(不检测窗口焦点)
- 点击通知 →
dsh-desktop://open→ 聚焦桌面端窗口(未运行则启动)
安装
前置:Node.js 20+;设置环境变量 DSH_HOME 指向 DSH 数据家(如 D:\DeepSeekHarness\dsh-home),
或安装时用 --dsh-home <路径> 显式传入。
方式 A:手动复制(默认,不需要 pnpm)
git clone https://github.com/happyde2b/dsh-win-notify.git
cd dsh-win-notify
node install.js # → <DSH_HOME>\profiles\desktop\node_modules\dsh-win-notify
node install.js --profile web # 指定 profile
# 同步更新 profile 的 package.json(dependencies + dsh.profile.bundles)
方式 B:官方插件管理器(打包成 tgz 后安装)
node install.js --pack # 产物:<DSH_HOME>\downloads\dsh-win-notify-<version>.tgz
node install.js --pack --out D:\tmp # 自定义输出目录
# 在 DSH 桌面端「设置 → 插件 → 添加插件」里填该 tgz 的绝对路径,安装后启用
两种方式都需要重启 DSH 桌面端生效(lib/index.js 被服务进程缓存)。
lib/toast.ps1、lib/open-desktop.ps1 每次弹通知实时读取,改脚本无需重启。
配置
在 <DSH_HOME>\profiles\desktop\cordis.patch.yml 里按 id win-notify 覆盖:
- id: win-notify
config:
enabled: true # 总开关
onTurnComplete: true # 任务完成通知
onTurnError: true # 任务出错通知
onUserQuestion: true # 需要回答通知
onApproval: true # 需要审批通知
approvalReminderMs: 300000 # 审批重复提醒间隔(毫秒),0=关闭
onlyRootAgents: true # 仅顶层会话(排除子代理)
minIntervalMs: 10000 # 同类通知最小间隔(毫秒)
clickUrl: 'http://127.0.0.1:3080' # 协议不可用时的回退地址
desktopAumid: 'com.deepseek.harness' # 通知归属的 AUMID;''=回退到 DSH.Notify
debugLog: '%TEMP%\\dsh-win-notify.log' # 排查日志;''=关闭
debugLog 默认写到 %TEMP%\dsh-win-notify.log(超过 512 KB 自动滚动成 .1)。里面记录
插件加载、turn/end 等事件的顶层判定(root=true/false depth=… origin=…)、实际发出的
通知与节流跳过、以及 toast.ps1 的退出码——排查"为什么没弹"先看这个文件。
实现要点
- 订阅持久化
session/event流(与界面同一数据源),不侵入任何核心包;零第三方依赖。 - 顶层判定读
session.header:origin === 'subagent'或delegationDepth >= 1视为子代理 (0.2.2-rc.3 起agents服务已不再提供roots(),旧写法会让所有完成通知被静默过滤)。 lib/toast.ps1:WinRTToastNotificationManager弹通知,AUMID 候选链[desktopAumid, DSH.Notify, 系统 PowerShell AUMID, ''];惰性注册dsh-desktop://协议 (HKCU,含必需的URL Protocol标记);首次运行会创建DSH Notifications.lnk注册桩 (目标 explorer.exe,切勿改回 powershell.exe——会被 Defender 当木马删除)。lib/open-desktop.ps1:协议处理器。聚焦DeepSeek Harness进程窗口(AppActivate)→ 未运行则启动DeepSeek Harness.exe→ 兜底启动快捷方式。- 两个 .ps1 必须保持纯 ASCII:PowerShell 5.1 按系统 ANSI(GBK) 读 .ps1,UTF-8 中文注释 会吞掉换行导致解析失败。
链接
同类插件
xmanrui/dsh-im★ 3737
通过二维码或机器人凭据将 IM 机器人接入 DeepSeek Harness(支持飞书、微信、钉钉、企业微信、QQ、Slack、Telegram、Discord 和 WhatsApp 共 9 种渠道)。
shaobeichen/dsh-pocket★ 3092
手机远程访问 DSH Web 界面:扫码即用局域网或公网(cloudflared 隧道)访问,实时同屏、移动端适配布局,带设置页管理。
c1overzz/dsh-bili-scroll★ 1459
让你的 DSH 自己刷 B站 —— 读字幕原文挑内容、写日报,遇到值得看的会发评论 @ 你。
OpenPetsHQ/openpets#dsh★ 1399
将 DeepSeek Harness 的生命周期状态、错误与审批请求,桥接到本地运行的 OpenPets 桌面伙伴。
inclusionAI/Avernet#deepseek-harness-channel-bcn★ 608
通过 WebSocket V2 将 DeepSeek Harness 接入 Avernet Bot 协作网络,支持自动注册、Agent 会话隔离、工具调用事件和多 Bot 路由工具。
zaofan-make/dsh-qqbot★ 270
QQ 官方机器人通道(tencent-connect/dsh-qqbot 的增强 fork):群/私聊ai陪聊、富媒体收发、表情包打标入库+检索发图、入群审批/禁言/群发、定时唤醒、QQ 远程审批与提问卡、互动按钮卡、多账号多实例、扩展接口、群友记忆注入、按消息价值唤醒省token、上下文自动压缩、悬浮球设置面板。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。