dsh-desktop-notifications

dsh plugin --profile web add dsh-desktop-notifications

dsh-desktop-notifications

给 DeepSeek Harness（dsh）用的 Windows 桌面通知插件 ——

DSH 需要你操作（申请权限、提问）或干完活（完成、出错、需要登录）时，

在 Windows 桌面右下角弹出原生 Toast，不用一直盯着浏览器标签页。

每条通知的第一行都是会话名称，多个对话同时跑时一眼分辨是谁在叫你；

授权 / 提问类通知零延时立即弹，并且正文会自动去掉 markdown 符号

（不会在通知里看到 **、` `、~~`）。

小明的课表整理                                  <- 第一行：会话名称（所有通知都是）
需要你确认权限 · pwsh · 删除 Downloads 下的文件    <- 第二行：具体事项

dsh-plugin · 仅 Windows 宿主插件 · 零依赖 · 无需构建 · MIT

特性

🔔 只发重要的事 · 申请权限、提问、任务完成、执行出错、需要登录

🗂️ 第一行永远是会话名 · 从会话日志折叠标题，不同对话的通知不会再混淆

⚡ "需要你"零延时 · 授权/提问一出现就弹（可分别配置延时，只在仍未被回答时才弹）

🧹 自动去 markdown · 去掉 **、` `、~~、[文字](链接)`；下划线与文件名保留

🪟 真正的系统通知 · 归属 DSH 自己的 AppUserModelID（com.deepseek.dsh），显示为 DeepSeek Harness，并进入通知中心

🧾 审计日志 · 每条通知记一行（~/.dsh/dsh-desktop-notifications.log），排查"为什么没弹"有据可查

🪶 无硬依赖 · 纯 ESM + 一个 PowerShell 脚本，无编译器、无打包器、无原生模块（@deepseek-ai/schemastery 是可选 peer，只用来生成设置表单）

触发时机

时机 · 事件 · 第二行 · 何时弹

需要你同意权限 · approval/request · 需要你确认权限 · <工具> · <原因> · 立即

需要你选择 / 作答 · user-questions/request · 正在等待你的选择 · <问题> · 立即

任务完成 · agent/status → idle · 任务完成 · 用时 …，可以回来查看结果了。 · 空闲满 4 秒

执行出错 · agent/error · 执行出错 · <错误摘要> · 立即

需要登录 / 登录过期 · deepseek-account/* · 需要登录 · … · 立即

子代理结束 · subagent/end · <子任务名> 已结束。 · 立即（默认关闭）

工作流结束 · workflow/end · 工作流运行已结束（…）。 · 立即（默认关闭）

两个防打扰设计：相同标题+正文 1.5 秒内只弹一次；"完成"要求 agent 空闲持续 4 秒才弹，

这期间又进入下一轮（例如 /goal 自动续跑）就取消这次通知。

安装

# 从 GitHub 安装
dsh plugin --profile desktop add github:FANLS05/dsh-desktop-notifications

# 或者从本地目录安装
dsh plugin --profile desktop add link:D:\path\to\dsh-desktop-notifications

然后在插件管理里确认 desktop-notifications 这一行是启用的即可（bundle patch 默认就是启用状态）。

环境要求：Windows 10/11 + DSH 桌面版（Node 20+ 由宿主提供）。

不想等真实事件时，可以直接自检：

node "$env:USERPROFILE\.dsh\plugins\dsh-desktop-notifications\scripts\notify-test.mjs"
node "$env:USERPROFILE\.dsh\plugins\dsh-desktop-notifications\scripts\notify-test.mjs" "**标题**" "正文 `code`"

配置

在 GUI 里改（推荐）

插件导出了 Config schema，DSH 会把它当作这一行的"设置文档"：

打开 设置 → 插件，展开 dsh-desktop-notifications bundle，点 desktop-notifications 这一行的配置按钮，

下面所有开关都会以表单形式呈现，保存后立即生效（不用重启）。

在 profile patch 里改

在 %USERPROFILE%\.dsh\profiles\desktop\cordis.patch.yml 里给这一行加 config：

- id: desktop-notifications
  config:
    notifySubagent: true     # 子代理结束也通知
    notifyWorkflow: true     # 工作流结束也通知
    sound: false             # 静音（通知仍在）
    stripMarkdown: false     # 保留原始 markdown
    approvalDelayMs: 1500    # 只在仍未被回答时才弹
    questionDelayMs: 1500
    notifyOnMount: true      # 每次加载弹一条，便于确认通道正常

字段 · 默认值 · 说明

enabled · true · 总开关

appId · com.deepseek.dsh · 通知归属的 AppUserModelID

sound · true · 是否播放提示音

useElectron · true · 宿主是 Electron 主进程时优先用其原生通知

powershellPath · "" · 指定 PowerShell，空则自动找 powershell.exe → pwsh.exe

notifyApproval / notifyQuestion / notifyComplete / notifyError / notifyAccount · true · 各类事件开关

notifySubagent / notifyWorkflow · false · 可选事件（默认关）

notifyOnMount · false · 加载时自检通知

onlyRootSessions · true · 完成类通知只针对根会话

useSessionTitle · true · 用会话名当第一行

stripMarkdown · true · 去掉标题/正文里的 markdown

titleMaxChars · 60 · 第一行截断长度

titleCacheTtlMs · 30000 · 会话名缓存时长

approvalDelayMs / questionDelayMs · 0 · 0 = 立即；调大则只在未被回答时弹

idleGraceMs · 4000 · 空闲多久才算"完成"

dedupeWindowMs · 1500 · 相同通知去重窗口

bodyMaxChars · 180 · 第二行截断长度

logEnabled / logPath / logMaxBytes · true / "" / 262144 · 审计日志（默认 ~/.dsh/dsh-desktop-notifications.log）

审计日志记的是清洗之后的最终文本：

Get-Content "$env:USERPROFILE\.dsh\dsh-desktop-notifications.log" -Encoding UTF8 -Tail 20

实现要点

• 两条投递通道：优先用 Electron 的 Notification（宿主真是 Electron 主进程时）；

否则起一个 PowerShell 子进程跑 lib/toast.ps1，脚本内部再三级降级：

DSH 的 AppUserModelID → Windows PowerShell 内置 AppUserModelID → 通知区域气泡。

• 为什么要起子进程：这里的 DSH 宿主其实是 Electron 的 utility 进程，没有 Notification API。
• detached: true 是坑：在 Windows 上 detached 启动 powershell.exe 会让它 ~130ms 就以

退出码 0 结束、脚本根本没执行；同样的命令行只要不 detached 就正常。这一个参数决定了"能不能收到通知"。

• prepend 再委托：approval/request / user-questions/request 是瀑布事件，谁先应答谁"认领"。

通知监听器用 { prepend: true } 抢在最前面发通知，然后照常 next()，不影响原有应答方。

• 会话名的取值链：sessionQuery.readTitle() 折叠日志里的标题；事件不带会话时（登录提醒、

自检）依次退到"最近活动的对话" → "日志里最新的对话" → DSH。

开发

lib/index.js 是刻意做薄的入口：DSH 的 loader 按包名缓存已加载的模块且不会重新 import，

所以入口用 import('./impl.js?v=' + Date.now()) 绕开缓存 ——

改 lib/impl.js 只需要在插件管理里把该行禁用再启用一次，不用重启宿主、也不用改包名；

只有改 lib/index.js 本身才需要重启。

没有构建步骤：仓库里的 JavaScript 就是最终产物。

已知限制

• 仅在 Windows 生效；其它平台加载后不做任何事。
• Windows 的「专注助手 / 勿扰模式」会压制 Toast —— 系统行为，插件绕不过去（通知仍会进通知中心）。
• 刚创建的会话可能还没有标题（DSH 异步生成），此时第一行会退到上一级。
• 去 markdown 是"宁可多去"：正文里单独出现的 （例如 .txt）也会被去掉，

需要原文就设 stripMarkdown: false。

同类插件

DSH 生态里的通知类插件已经不少，见

awesome-dsh-plugin › Notifications & Integrations

（收录了 35 个）。比较有代表性的：

hotpot-labs/dsh-notifier-plugin（跨平台，带设置卡片）、

lsq-dsh-plugins/dsh-windows-notifications（Windows 通知 + 应用内卡片）、

masknull/dsh-webhook-notifier（HTTP Webhook）、

zhangDSK-Xu/dsh-sound-alert（提示音 + 提醒卡片）。

本插件的差异点：零依赖、无需构建、第一行是会话名、授权/提问零延时、自动去 markdown、带审计日志。

许可

[MIT](LICENSE)