dsh-notify-me

离开 DSH 页面，也能及时知道何时需要回来。

简体中文 | English

安装 · 效果预览 · 配置 · 兼容性 · 更新日志

DSH Web / Desktop 的通知插件，让你敢不开完整访问，也不必一直守着页面。

• 需要你操作时：审批、方案确认、提问，用通知、提示音和标题标记提醒。
• 后台回复完成时：及时回来查看结果，点击通知可回到对应对话。
• 离开电脑时：可选转发到 Discord、Bark、Gotify 或自己的 Webhook。
• 不看主屏时：系统通知只会画在主屏，副屏看不到；桌面端的审批卡片画在页面里，跟着 DSH 窗口走到哪块屏（见副屏与审批卡片）。

页面或桌面应用需保持运行，后台 / 最小化可以。系统通知需要通知权限。审批按钮靠 Service Worker 才能进通知：Web 端（http://127.0.0.1 或 https）有，桌面端 dsh-app:// 页面注册不了，通知上没有按钮，审批改在窗口角落的卡片上裁决。

🔎 想找这个插件？可以搜：dsh-notify-me、消息提醒、可操作提醒、桌面通知、需要你操作、回复完成提醒、后台完成提醒、外部通知、Discord / Bark / Gotify 推送（npm 关键词已含以上中英文词）。

效果预览

普通通知示例 · Windows / Edge · 不含审批按钮。 查看原图

安装

DSH Web

已安装 DSH CLI 的用户，在终端执行：

# 安装并自动挂载进 web profile
dsh plugin --profile web add dsh-notify-me

重启 dsh web，然后硬刷新页面（Ctrl+Shift+R）。如果你使用其他 Web profile，请把命令中的 web 换成实际名称。

DSH Desktop

1. 在桌面应用打开 插件 → 添加插件。
2. 输入 npm 包名 dsh-notify-me，按应用提示完成安装，并确认插件已启用。
3. 完全退出并重新启动 DSH Desktop，使插件加载。

桌面端的 desktop profile 由 Electron 应用管理；不要把上面的 Web 命令改成 --profile desktop，CLI 会拒绝此操作。安装到 Web profile 也不会自动安装到桌面端。

首次验证

1. 在 DSH 页面上点击一次，按提示允许通知；若此前拒绝过，在浏览器站点设置中允许通知。操作系统也需要允许对应浏览器 / DSH Desktop 显示通知。
2. 打开 设置 → 通知提醒，确认出现该分区及底部插件版本号，保持「启用提醒」「提示音」开启。
3. 点击设置页的「测试『回复完成』」按钮：应出现一条测试通知，并按当前音效设置播放声音。这个本地测试不会转发到外部通知端点，也不受「窗口在前台时也提醒」开关限制。

Web 用户可再测试审批按钮。桌面端拿不到 Service Worker，这条测试会在窗口角落画一张带「同意 / 拒绝」的卡片（1.10.4 起；之前的版本这里只发普通通知）。

控制台验证（可选） — 支持 DevTools 的环境也可执行：

window.__dshNotifyMe.test("done")        // 「完成」示例
window.__dshNotifyMe.test("attention")   // 「需要你」示例
window.__dshNotifyMe.test("approval")    // 桥可用时带「同意 / 拒绝」按钮；桌面端画在窗口角落的卡片上
window.__dshNotifyMe.debug()             // 桥接状态看 bridge 字段，active = 按钮可用

没有测试通知时，先检查：通知权限是否被拒绝（在页面上点一下 → 选「允许」；或地址栏锁 → 站点设置 → 通知 → 允许 → 刷新）、装完没重启 DSH、系统设置里浏览器通知被关。

为什么需要它

• 不开完整访问（workspace-write + ask）：保留事前审批，但错过请求会让 agent 等待。
• 开完整访问（full access）：减少审批打断，同时放弃事前拦截能力。

dsh-notify-me 把「监督」和「守在屏幕前」解耦：只在真的出现决策点（审批 / 方案确认 / 提问）或回复跑完时，才用系统通知把你叫回来——让你敢不开完整访问，不必靠放弃拦截能力来换效率。它不降低 full access 本身的权限风险（它不是沙箱），只是减少 ask 模式下因错过审批而产生的等待。

提醒时机

需要你操作包括审批请求、方案待确认（plan review）和提问（ask_user_question）。审批带「同意 / 拒绝」：Web 走带按钮的系统通知，桌面端（注册不了 Service Worker）改画在窗口角落的卡片上。

回复完成也覆盖后台会话；完成但还没看时，标题带 ✅ 回复完成 · 标记，打开对应会话即撤。标题标记不受「窗口在前台时也提醒」开关限制。

后台子代理（subagent）子会话的等待与完成默认不提醒：DSH 把每个子代理子会话列成独立会话，但它们是所属主对话那一轮里的步骤，提醒只会是噪音。你当前打开的那个子代理会话不算在内，照常提醒。设置页「子代理会话不提醒」可关掉这个静音。

在 DSH 设置里改配置

打开 设置 → 通知提醒。页面按「提醒方式 → 什么时候提醒 → 试一试」三段排开，不常改的收进底部「高级设置」，点一下展开。每行只写标题，具体说明在鼠标停在标题文字上时弹出的小方框里（只有标题本身触发布局，整行空白处不会弹；触屏或键盘操作时留一份隐藏文本给读屏）。带 ▸ 的行点一下展开子项。

提醒方式

• 启用提醒 总开关：关闭后不弹通知、不响提示音，也不改标签页标题；
• 提示音 / 音量：开关直接切；音量滑块收在该行里，点一下标题（▸ 变成 ▾）展开。具体播什么由「高级设置 → 音效来源」决定；
• 审批通知上直接裁决（默认开）：审批带「同意 / 拒绝」，点一下即完成裁决，不用切回页面。Web 走带按钮的系统通知；桌面端 dsh-app:// 注册不了 Service Worker，于是把按钮画在窗口角落的卡片上（12 秒自动收起，同一条审批不叠第二张卡）。卡片位置由它下面的子行「审批卡片位置」控制，见副屏与审批卡片。

副屏与审批卡片

Windows 的系统通知横幅固定画在主屏上，系统没有设置项、浏览器也没有 API 能把它挪到别的显示器。主屏不看、DSH 停在副屏时，通知就等于没发。这一条改不掉——真要在副屏看见，只能靠页面里的东西。

页面里还剩一种：桌面端的审批卡片。它画在 DSH 页面里，窗口在哪块屏就出现在哪块屏，卡片上能直接「同意 / 拒绝」（桌面端通知带不了按钮）。

• 位置：「审批通知上直接裁决」下面的「审批卡片位置」子行，行上直接显示当前值（默认右下）；点它（▸ 变 ▾）再选右上 / 右下 / 左上 / 左下，改完立刻生效；
• 只给审批：普通提醒与「回复完成」不画卡片，它们只有系统通知；
• 停留时间：审批卡片 12 秒自动收起；点卡片正文切回对应对话。最多同时叠 4 张；
• 不用通知权限：这条路径不碰 Service Worker，也不依赖通知权限。

1.11.0 删掉了「通知类型」二选一。页面浮层曾经能当独立通道用，但它只在 DSH 窗口处于前台时看得见——需要提醒的时刻恰恰是窗口在后台。选浮层、切走之后后台只剩提示音和标题标记，等于没提醒。

什么时候提醒

• 窗口在前台时也提醒「需要你」（默认开）：窗口在前台也提醒；关掉后只有窗口转到后台才提醒——切到别的应用、被别的窗口遮住、最小化都算后台；
• 当前对话不弹通知（默认开）：等待就发生在你正看着的对话里时只留标签页标记，免得挡住审批卡片；窗口转到后台后照常提醒，若你已处理掉就作废；
• 窗口在前台时也提醒「回复完成」（默认关）：默认只在窗口转到后台时提醒，避免打扰（桌面端窗口被遮住也算后台，1.10.5 起不再要求最小化）；
• 子代理会话不提醒（默认开）：跳过后台子代理（subagent）会话——它们是主对话那一轮的步骤，完成由主对话自己的提醒覆盖；你当前打开的那个子代理会话照常提醒；
• 点击通知回到对应对话（默认开）：点通知切到提醒所属的对话；浏览器里同时把窗口带到前台；桌面端不稳定——有时窗口会上前，有时只切对话（见桌面端怎么抬窗的）；多个标签页同时开着时只调起一个（优先当前可见的那个）；关掉后点通知不做任何事。

试一试

三个按钮分别发一条「需要你」「回复完成」「审批按钮」测试提醒，用当前设置立即发，不受「什么时候提醒」里的开关限制；下方一行如实说明当前哪种渠道能给审批按钮。

设置页底部常显插件版本号（dsh-notify-me v…）——报障、核对是否装上新版本时直接照抄这一行。

高级设置

默认收起，点一下展开。里面收着三块不常改的东西：音效来源、外部推送、运行环境与诊断——分别见下面三节。

音效

「需要你」与「回复完成」可独立选择内置合成音、自定义音频或系统通知音。

外部推送

默认关闭。支持 Discord Webhook / Bark / Gotify / 自定义 Webhook；提醒正文会发往你填写的地址，只使用可信端点。

运行环境与诊断

在「高级设置」最后一块。默认自动识别当前是 Web 端还是桌面端（DSH Desktop，dsh-app://）；识别不准时可手动指定——桌面端点通知走 dsh:// 深链调窗（效果不稳定，见桌面端怎么抬窗的）、通知上不带快捷裁决按钮；Web 端走 window.focus() 与 Service Worker 桥。手动覆盖与自动识别不一致时，设置页会明示检测结果。

左侧导航行的图标由 DSH 设置外壳统一渲染：外壳按分区 id 硬编码（只认 account / models / agent-presets / plugins / archived-sessions），其他分区一律给默认齿轮，settings.section 也没有图标字段。插件的做法是在设置面板渲染后替换那一行：按本地化标签文本找到自己的入口，把宿主的 <svg> 换成品牌铃铛（保留宿主给的 icon class），并用 MutationObserver 跟随重渲染；宿主改结构时会自动放弃、回落到齿轮。

需要浏览器通知权限：页面上点一下 → 允许；或地址栏锁 → 站点设置 → 通知 → 允许 → 刷新。macOS 还要在 系统设置 → 通知 里允许该浏览器。

提醒渠道

• 系统通知：经浏览器弹出的系统通知，进 Windows 通知中心或 macOS 通知中心（点击回到提醒所属的对话；支持快捷裁决的 Web 环境可点审批按钮直接裁决，桌面端没有按钮）
• 桌面端审批卡片：dsh-app:// 下系统通知带不了「同意 / 拒绝」，审批类提醒额外在窗口角落画一张可点卡片；见副屏与审批卡片
• 提示音：默认是 WebAudio 合成音（「需要你」与「完成」使用不同音型）；可在设置里为两类提醒分别换成自定义音频文件，或改成让操作系统播放它自己的通知音
• 标签页标题标记：有待处理事项时，标题前出现 🔔 需要你 · … / 🔔 Action needed · …；后台会话完成但还没看时出现 ✅ 回复完成 · … / ✅ Reply finished · …，打开对应会话（或它再次开跑）即消失。两种标记可同时出现，「需要你」在前；宿主改写标题后标记基于新标题重建
• 外部通知（可选，默认关）：按设置里配的推送目标，把同一条提醒转发到 Discord Webhook / Bark / Gotify / 自定义 Webhook——临时离开电脑时，手机上的推送渠道照样收到

本插件是浏览器层实现：DSH 页面需保持打开（最小化/后台即可——那正是它监听的「离开」状态）。

兼容性

逐版本适配记录见 package.json 的 dsh.compatibility.dshReleases。当前宿主（0.2.1-rc.2）的安装门控只读 peerDependencies 与 engines，不再读取这个字段，所以它现在只是一份给人看的记录，不构成门禁。

实测真正激活（各自独立 profile 启动：插件条目进启动页 __DSH_BOOT__ 且注入依赖解析通过、/plugins/??dsh-notify-me/client.js&rev=… 返回含新代码的构建，设置里出现「通知提醒」分区，即插件的 apply 确实执行）于 0.1.2-rc.1、0.1.5-rc.1、0.1.5-rc.2 与 0.2.0-rc.2；更早的 0.1.1-rc.2 亦验证过。

0.2.1-rc.2（当前 latest）另跑了一轮隔离验证：隔离 DSH_HOME 起 dsh web（70 个启动条目），插件条目排在第 59、application 批，三个注入目标都在且都排在它前面；/plugins/??dsh-notify-me/client.js&rev=… 返回当时装的 1.7.0 源码构建（140,153 B）；无头 Chromium 载入页面后 apply 正常执行，window.__dshNotifyMe.debug() 报 uiSession: bound、uiSessionSource: sessionStatus、bridge: active。宿主侧的形状与 0.2.0-rc.2 一致，没有需要改代码的地方。

1.9.0 的界面重排没有放宽也没有收紧这个范围：设置页是纯 React 渲染 + 既有 CSS 变量（每个色值都带 fallback），没有引入任何新的宿主 API；浮层、标题标记、抬窗仍走 1.7 / 1.8 那几条路径。0.1.1-rc.2 到 0.2.1-rc.2 的插件条目照旧兼容，换回旧宿主也不需要改配置。新增的只有界面元素——设置页页眉的铃铛是插件自己画的 SVG（docs/brand/），与宿主无关。

控制台高级配置

设置页是第一入口；想脚本化/批量改或恢复默认时，偏好存 localStorage（dshNotifyMe.config），可用控制台实时调整：

window.__dshNotifyMe.config                       // 查看
window.__dshNotifyMe.setConfig({
  enabled: true,           // false = 关闭所有提醒（主开关）
  language: "auto",        // 'auto' 跟随界面 | 'zh' 简体中文 | 'en' English
  attentionHiddenOnly: false, // true = 页面可见时「需要你」不提醒
  currentHiddenOnly: true,    // true = 当前对话的等待只留标题标记（转后台补发）
  doneHiddenOnly: true,       // false = 页面可见时「完成」也提醒
  ignoreSubagent: true,       // true = 后台子代理（subagent）会话不提醒（当前打开的照常）
  sound: true,                // 提示音开关（含「系统通知音」模式）
  soundDone: "synth",         // 「完成」音效来源：'synth' 内置 | 'custom' 自定义文件 | 'system' 系统通知音
  soundAttention: "synth",    // 「需要你」音效来源，取值同上
  volume: 0.5,                // 音量 0~1
  autoFocus: true,            // 点通知回到提醒所属的对话
  quickActions: true,         // 审批通知上的「同意 / 拒绝」按钮
  overlayCorner: "bottom-right", // 桌面端审批卡片位置：'top-right' | 'bottom-right' | 'top-left' | 'bottom-left'
  externalEnabled: false,     // 外部通知转发主开关（默认关：不填端点就什么都不发）
  externalAttention: true,    // 转发「需要你」（触发规则跟本地提醒完全一致）
  externalDone: true,         // 转发「回复完成」
  externalTargets: []         // 推送目标：[{id, type:'discord'|'bark'|'gotify'|'custom', url}]
})
window.__dshNotifyMe.resetConfig()                // 恢复默认（同时清掉已选的自定义音效文件）
window.__dshNotifyMe.decide("approval:3", "allowed-once")  // 程序化裁决："allowed-once" | "rejected"
window.__dshNotifyMe.testExternal()               // 显式外发测试：向有效目标发送，返回 {sent, unverified, failed, statuses}

工作原理

提醒核心监听会话状态与待处理交互；审批裁决由页面侧完成，桌面抬窗使用应用深链。

已知限制

• 页面必须开着才会提醒（后台标签/最小化可以；关标签页即失效——浏览器层方案固有限制）。

• 通知经由浏览器弹出，需允许浏览器通知权限，且勿扰模式不能屏蔽它。

• 桌面端（DSH Desktop 0.2.1-rc.2 / Windows）点通知后窗口不一定上前台：有时会，有时只切对话。插件发的 dsh://open 深链单独复测 3/3 无效（详见桌面端怎么抬窗的），能抬的时候多半是系统/Chromium 在通知激活时自己把窗口带起来了（discussions #10446）。

• 系统通知横幅只画在主屏：Windows 没有设置项、Chromium 没有 API 能把它指到别的显示器（多屏时副屏收不到系统通知）。页面里唯一还会出现在副屏的是桌面端的审批卡片，它跟着 DSH 窗口走；普通提醒要跨屏，只能靠外部推送转到手机。

• 每次页面加载后第一次出声/弹通知前，需在页面上点击过一次（浏览器自动播放与权限策略）。

• 未授权通知权限时只有提示音与标题标记。

• 快捷裁决按钮要 Service Worker：http://127.0.0.1、https 可用，http://192.168.x.x 这类局域网地址不行；桌面端（dsh-app://）已实测无法注册 Service Worker，按钮渲染不了，审批通知退回无按钮样式。浏览器或桌面宿主不渲染通知按钮时，window.__dshNotifyMe.debug() 的 bridge 字段会说明原因，其余功能不受影响。

• macOS：浏览器里提醒、提示音、标题标记、点通知跳转都没有平台假设，照常工作；但 DSH Desktop（Electron）的系统通知要求应用已签名，未签名的通知直接发不出去，官方 macOS 版是否满足这一前提未实测；审批按钮在 macOS 桌面宿主上的渲染同样未实测（Windows 桌面端已实测不渲染，见上条），不渲染时自动退回无按钮通知。

• 配置存在浏览器 localStorage：换浏览器/设备或清除站点数据后会回到默认值（设置页可一键恢复默认）。

• ≥ 0.1.6（含 0.2.0-rc.2、0.2.1-rc.2）的「回复完成」提醒正文只有会话名，不再附带回复摘要——宿主快照已不再提供 nodes；提醒本身照常触发。

• 标题标记由宿主与插件共同写 document.title：宿主重算标题时标记可能被覆盖，直到下一次提醒事件重新写成。

• 「当前对话不弹通知」按「窗口是否在前台」判定：窗口被别的应用盖住、切到别的应用、最小化都算后台，此时当前对话的等待照常提醒；窗口回到前台再静默。

• 外部通知转发受浏览器跨域（CORS）限制：端点不放行时自动降级为「送出但不可确认」（no-cors），如实标为「已送出不可确认」；Discord Webhook 官方放行跨域，可直接确认送达。HTTP 错误如实记失败、不重试。转发在本地提醒决定要发之后才触发，所以被「当前对话不弹通知」等规则静音的提醒也不会外发。

• 设置左侧导航行图标靠 DOM 补丁：外壳按分区 id 硬编码图标且 settings.section 没有图标字段，插件只能在面板渲染后把那一行的 <svg> 换成铃铛。命中依赖宿主当前的面板结构（data-shortcut-modal="settings" + 导航按钮里的标签 <span>）；如果 DSH 改了这套结构，补丁会静默失效、显示回默认齿轮，其他功能不受影响。

开发自检

node --check lib\client.js
node --check lib\index.js
node smoke\smoke-test.cjs        # 离线状态机冒烟测试：三代宿主 + 主开关 + 中英语言用例 + 快捷裁决桥（Service Worker 半侧一并跑）+ 桌面审批卡片
node smoke\cordis-host-test.mjs  # 真 cordis 端到端（找不到本机 DSH 时自动跳过）
npm pack --dry-run               # 预览发布包

cordis-host-test.mjs 会从本机 DSH 安装借 @deepseek-ai/cordis（依次探测 npm 全局目录、~/.dsh/profiles/web/node_modules 与 ~/.dsh/profiles/node_modules 平铺回退目录）；源码 checkout 里没有 profile 依赖时，用 DSH_CORDIS_PATH=<checkout>/vendor/cordis/lib/index.js 指定即可。

致谢与贡献须知

贡献者（按 handle 列出，链接指向他们参与的 PR / issue）：

• @AgMahone — #7：0.1.6+ / 0.2.0 宿主代际支持，以及通知双响、cordis 查找路径的报障与复测；
• @d0ublecl1ck — #8：子代理会话静音（ignoreSubagent）与配套测试、文档；1.4.0 里「只静音后台子代理、当前打开的照常提醒」的口径同样出自他在 #8 讨论里的建议，落地由维护者完成；
• @EliteOtaku — #9：桌面端抬窗链路（1.5.2）的逐层排查与真实壳三轮复测——确认点通知抬窗 + 切会话稳定生效，并定位出「无用户手势的脚本化注入被 Chromium 静默丢弃」这一复现差异，纠正了最初「沙箱拦死」的判断；
• @Wh1stle05 — #10：「音效来源」功能（内置合成音 / 自定义音频文件 / 系统通知音，「需要你」与「回复完成」各自独立选），含设置页交互、回落链与测试、文档；「系统通知音」试听改发测试通知、假 React 按索引跨渲染保持 hook 状态这两处修正同样出自该 PR。
• @yanzhaohui1999 — #13 / #14：482 个会话下空闲页面烧 CPU 的性能报告（定位到 currentSessionId() 每行重扫全表，实测占 CPU 5.9%~6.5%）与修复（一次列表变化只推导一次「当前会话」），并带先红后绿的回归断言——4 行与 40 行的列表变化代价必须相等（上游报 7 vs 43，修后 5 vs 5）。
• @RiZhiZhaoYi — #12：外部通知转发（Discord Webhook / Bark / Gotify / 自定义 Webhook）的功能建议与使用场景（1.7.0）。

署名口径：本仓库收编外部 PR 时以维护者提交落地——不沿用原 commit、不挂 Co-authored-by，GitHub 的 contributors 图只显示维护者，贡献者以上面的致谢署名。

License

MIT — 见 LICENSE。