dsh-notify-me

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

简体中文 | English

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

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

需要你操作时：审批、方案确认、提问，用通知、提示音和标题标记提醒。
后台回复完成时：及时回来查看结果，点击通知可回到对应对话；提醒时机可选「仅后台 / 仅当前对话静默 / 总是提醒」。
人走开但窗口没走：窗口留在最前台、人却离开座位，超过 3 分钟没有输入也算离开，该提醒的照常提醒；收到的那条通知不会在你回来之前自己消失。
离开电脑时：可选转发到 Discord、Bark、Gotify、飞书群机器人、Server酱、WxPusher 或自己的 Webhook。

页面或桌面应用需保持运行（后台 / 最小化可以）；系统通知需要通知权限。审批按钮依赖 Service Worker，只有 Web 端有，桌面端的通知不带按钮，点通知回到对话里裁决。

效果预览

Windows 上经 Edge 显示的 DSH 普通通知，未包含审批按钮

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

展开设置界面预览

通知提醒设置页：页眉、提醒方式、什么时候提醒、试一试与折叠的高级设置

只截插件自己的面板（真实组件，与宿主同款深色主题），不带 DSH 左侧导航栏；每行说明在鼠标停在标题文字上时才出现，所以这里只看到标题。

安装

DSH Web

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

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

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

DSH Desktop

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

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

首次验证

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

Web 用户可再测审批按钮，通知上会带「同意 / 拒绝」。桌面端拿不到 Service Worker，这条测试只发一条普通通知；真实审批的提醒同理——只弹通知，点它回到对话里裁决。

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

window.__dshNotifyMe.test("done")        // 「完成」示例
window.__dshNotifyMe.test("attention")   // 「需要你」示例
window.__dshNotifyMe.test("approval")    // 桥可用时带「同意 / 拒绝」按钮；否则只发普通通知（桌面端即如此）
window.__dshNotifyMe.debug()             // 桥接状态看 bridge 字段（active = 按钮可用）；最近一次被平台拒发的原因在 lastToastReject

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

为什么需要它

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

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

提醒时机

事件	默认行为
🔔 需要你操作	页面可见也提醒；当前对话只留标题标记
✅ 回复完成	页面隐藏 / 后台时提醒（可选「仅当前对话静默」或「总是提醒」）

需要你操作包括审批请求、方案待确认（plan review）和提问（ask_user_question）。带按钮的快捷裁决只在 Web 端可用，桌面端点通知回到对话里裁决（见已知限制）。

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

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

在 DSH 设置里改配置

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

提醒方式

启用提醒 总开关：关闭后不弹通知、不响提示音，也不改标签页标题；
提示音 / 音量：开关直接切；音量滑块收在该行里，点一下标题（▸ 变成 ▾）展开。具体播什么由「高级设置 → 音效来源」决定；
审批通知上直接裁决（默认开）：审批带「同意 / 拒绝」，点一下即完成裁决，不用切回页面。Web 走带按钮的系统通知；桌面端 dsh-app:// 注册不了 Service Worker，通知上没有按钮，点通知回到对话里裁决。设置页「试一试」下面那行会如实说明当前环境能不能给按钮。

什么时候提醒

窗口在前台时也提醒「需要你」（默认开）：关掉后只有窗口转到后台才提醒；
当前对话不弹通知（默认开）：正看着的对话里的等待只留标签页标记，人离开后照常补发；
「回复完成」什么时候提醒（默认「仅后台」）：仅后台 / 仅当前对话静默 / 总是提醒，三选一；
通知自动消失（默认「离开时保留」）：离开时保留 / 总是关闭 / 从不关闭，三选一；
子代理会话不提醒（默认开）：跳过后台子代理（subagent）会话，你正开着的那个照常提醒；
点击通知回到对应对话（默认开）：切到对应对话并把窗口带到前台，桌面端走原生抬窗，多个标签页只调起一个。

展开各开关的边界条件

后台的判定：切到别的应用、被别的窗口盖住、最小化都算；窗口一直留在前台但 3 分钟没有任何键鼠输入同样算，idleMinutes: 0 退回只看窗口。
「当前对话不弹通知」何时补发：窗口转到后台或闲置超时后照常提醒；若你已处理掉就作废。
「回复完成」三档：「仅后台」＝不在看页面才提醒；「仅当前对话静默」＝屏幕上那条静默、别的对话照常提醒，多开对话时有用；「总是提醒」＝从不静默。老配置里的「窗口在前台时也提醒『回复完成』」开关自动迁移到这一项。
「离开时保留」：只有你人在页面前时才几秒后关闭，人不在时收到的那条留在通知中心等你回来；带「同意 / 拒绝」的审批通知仍按 12 秒走，同样不会在人不在时被撤掉。
点击通知的兜底：桌面端抬不起来时只切对话，原因记在 debug().raiseLast 里；关掉这一项后点通知不做任何事。

试一试

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

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

高级设置

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

音效

「需要你」与「回复完成」可独立选择内置合成音（默认）、自定义音频文件或系统通知音。自定义音频上限 1 MiB，存在浏览器本地，可试听与移除；选系统通知音时完全不播插件音效，通知照发，声音交给操作系统（音色跟着系统通知设置走），此时「试听」会改发一条测试通知。任一来源缺文件、读不出来或存不下时回落到内置合成音，提醒不会变成哑的。

外部推送

默认关闭。支持 Discord Webhook / Bark / Gotify / 飞书群机器人 / Server酱（Turbo 与 Server酱³）/ WxPusher / 自定义 Webhook；提醒正文会发往你填写的地址，只使用可信端点。

目标地址、转发开关、发送测试与失败记录

外部通知（默认关）：把提醒同时转发到你自己的推送端点，人不在电脑前也能收到；可加多个目标，每个目标可单独启停。「转发「需要你」」「转发「回复完成」」各自独立开关；发送测试通知往所有目标发一条测试消息（不受这两类开关限制，也不会冒充真提醒）。转发跟本地提醒走同一套触发规则（「当前对话不弹通知」等开关同样管它）；提醒正文会原样发往你填的地址，只填你自己信任的端点；
各目标的填法：Discord 填 Webhook 地址；Bark 填 https://api.day.app/<设备密钥>；Gotify 填 https://<服务器>/message?token=<应用令牌>；飞书填群机器人 Webhook，可选填签名校验密钥；Server酱填 …/send/<SendKey>.send 完整地址；WxPusher 填 appToken 与接收者 UID；自定义端点收一条 POST JSON：{source, event, title, body, text, sessionId, time}；
可靠投递：明显是临时故障的失败（网络中断、5xx、429）按 2 秒 / 6 秒自动重试两次，其它错误立即停；重试仍失败会把这一条记进「失败记录」（最多 10 条，只留标题与正文摘要和主机名，不留完整端点），设置页能一眼看到并清空；
每个目标的状态：目标行右侧显示它最近一次投递的结果（上次成功 / 上次已送出但不可确认 / 上次失败 + 原因），并各自带一个启停开关——某个端点临时不可用就单独关掉它，不用关掉整类事件；
签名：自定义目标填了签名密钥时，请求带 X-DSH-Notify-Signature（对请求体做 HMAC-SHA256，sha256=<hex>）；飞书填了签名密钥时按官方算法在请求体里带 timestamp / sign；
消息模板（可选）：飞书 / Server酱 / WxPusher / 自定义目标可填模板，占位符 {{title}} {{body}} {{event}} {{time}} {{session}}，留空默认是「标题 + 换行 + 正文」；
钉钉不在支持列表里：钉钉群机器人接口不返回任何 CORS 头，且只接受 application/json——浏览器页面既读不到响应，也无法发出符合要求的请求（no-cors 下 Content-Type 会被限制成 safelisted 类型）。要用钉钉，请在自己能控制的机器上搭一个中转，再把「自定义 Webhook」指向它。

运行环境与诊断

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

通知语言、桌面端抬窗与恢复默认

通知语言：跟随界面 / 简体中文 / English——决定通知文字与 🔔 … 标题标记使用的语言；
桌面端抬窗：1.14.0 起由宿主路由做原生激活，最小化、被别的窗口盖住的都实测能抬回来（见桌面端怎么抬窗的）；
恢复默认设置：把所有开关与音效设置还原成出厂值（不动外部推送目标和已选的自定义音频文件）。

提醒渠道

渠道	表现
系统通知	经浏览器进 Windows 通知中心 / macOS 通知中心，点击回到对应对话；Web 端可带「同意 / 拒绝」
提示音	默认 WebAudio 合成音，「需要你」与「完成」音型不同；可换自定义音频，或交给系统通知音
标签页标题	`🔔 需要你 · …` / `✅ 回复完成 · …`（随通知语言切换），打开对应会话即消失；两种标记可同时出现
外部推送（可选，默认关）	把同一条提醒转发到 Discord / Bark / Gotify / 飞书 / Server酱 / WxPusher / 自定义 Webhook

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

兼容性

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

已逐版实测真正激活于 0.1.1-rc.2、0.1.2-rc.1、0.1.5-rc.1、0.1.5-rc.2、0.2.0-rc.2 与 0.2.1-rc.2（判定标准：插件条目进启动页 __DSH_BOOT__、注入依赖解析通过、/plugins/??dsh-notify-me/client.js&rev=… 返回含新代码的构建、设置里出现「通知提醒」分区）。0.1.1-rc.2 到 0.2.1-rc.2 的插件条目照旧兼容，换回旧宿主也不需要改配置；1.9.0 的界面重排没有引入新的宿主 API，设置页页眉的铃铛是插件自己画的 SVG（docs/brand/）。

展开宿主代际的形状差异与两个已知坑

插件按宿主代际自动选源；下表是各形状的边界，不是门禁：

宿主代际	「需要你」交互来源	判断当前会话	点通知切会话
`≤ 0.1.2-alpha.1`	控制器快照的 `pending[]`	快照 `current`	`sessions.open()`
`0.1.2-alpha.2 .. 0.1.6-alpha.1`	`uiSession.pendingInteractions`	快照 `current`	`sessions.open()`
`≥ 0.1.6-alpha.2`（含 `0.2.0-rc.2`、`0.2.1-rc.2`）	`uiSession.sessionStatus`	`retainedBy.mainView`	`uiWorkspace.openSession()`

区间仅作示意：插件按 store 形状自动选源（sessionStatus 存在即走新路），版本号只是各形状的出现边界。peerDependencies 范围决定 npm 的 peer 提示——0.2.1-rc.2 已落在 >=0.2.0-rc.1 <0.3.0-0 里，不需要豁免。

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

两个坑值得记住：一是 dsh.client.inject 里列了新版运行时已不再提供的包，客户端条目会停在 pending (waiting for services: …) 而永不执行——1.1.3 在 0.1.2-rc.1 及以后正是这样失效的；二是宿主换存储或字段名时不会报错，提醒只会静默失效——pendingInteractions→sessionStatus、list.current→retainedBy.mainView、sessions.open()→uiWorkspace.openSession() 都是这一类，所以每次适配都要用 window.__dshNotifyMe.debug() 确认真的是 bound。

控制台高级配置

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

展开控制台 API 与存储说明

window.__dshNotifyMe.config                       // 查看
window.__dshNotifyMe.setConfig({
  enabled: true,           // false = 关闭所有提醒（主开关）
  language: "auto",        // 'auto' 跟随界面 | 'zh' 简体中文 | 'en' English
  attentionHiddenOnly: false, // true = 页面可见时「需要你」不提醒
  currentHiddenOnly: true,    // true = 当前对话的等待只留标题标记（人离开后补发）
  donePolicy: "background",   // 「回复完成」策略：'background' 仅后台 | 'smart' 仅当前对话静默 | 'always' 总是提醒
  idleMinutes: 3,             // 超过多少分钟没有键鼠输入算「离开」（0 = 关掉闲置判定）
  autoDismiss: "present",     // 通知自动消失：'present' 离开时保留 | 'always' 总是关闭 | 'never' 从不关闭
  ignoreSubagent: true,       // true = 后台子代理（subagent）会话不提醒（当前打开的照常）
  sound: true,                // 提示音开关（含「系统通知音」模式）
  soundDone: "synth",         // 「完成」音效来源：'synth' 内置 | 'custom' 自定义文件 | 'system' 系统通知音
  soundAttention: "synth",    // 「需要你」音效来源，取值同上
  volume: 0.5,                // 音量 0~1
  autoFocus: true,            // 点通知回到提醒所属的对话
  quickActions: true,         // 审批通知上的「同意 / 拒绝」按钮
  externalEnabled: false,     // 外部通知转发主开关（默认关：不填端点就什么都不发）
  externalAttention: true,    // 转发「需要你」（触发规则跟本地提醒完全一致）
  externalDone: true,         // 转发「回复完成」
  externalRetryDelays: [2000, 6000], // 可重试失败的退避间隔（毫秒，带抖动；[] = 只发一次）
  externalTargets: []         // 推送目标，见下方字段说明
})
// 目标的形状：{id, type, url, secret?, token?, uid?, template?, enabled?}
// type: 'discord' | 'bark' | 'gotify' | 'feishu' | 'serverchan' | 'wxpusher' | 'custom'
// token/uid 只用于 wxpusher（url 固定为官方端点）；secret 用于飞书签名与自定义 HMAC 签名；
// template 可选，占位符 {{title}} {{body}} {{event}} {{time}} {{session}}；enabled:false 单独停用该目标
window.__dshNotifyMe.resetConfig()                // 恢复默认（同时清掉已选的自定义音效文件）
window.__dshNotifyMe.decide("approval:3", "allowed-once")  // 程序化裁决："allowed-once" | "rejected"
window.__dshNotifyMe.testExternal()               // 显式外发测试：向有效目标发送，返回 {sent, unverified, failed, statuses}

外部通知测试的开关边界：设置页「发送测试通知」要求「启用提醒」与「外部通知」主开关开启，但忽略两类提醒的转发开关。控制台 testExternal() 是显式测试调用：只要配置了有效目标，即使上述主开关关闭，也会向这些目标发送测试消息；没有有效目标则不发送。普通的 test("done") / test("attention") / test("approval") 只测试本地提醒，不外发。

自定义音效文件不在 dshNotifyMe.config 里，而是按类别各存一个键（dshNotifyMe.sound.done / dshNotifyMe.sound.attention，内容是 {name, size, data} 的 data URL）——一个文件转成 data URL 会膨胀约 1.37 倍，塞进配置会拖慢每次读取。resetConfig() 会连这两个键一起清掉。

想确认当前生效的来源，看 window.__dshNotifyMe.debug() 的 soundDone / soundAttention 与 customSoundDone / customSoundAttention。

工作原理

提醒核心监听会话状态与待处理交互；审批裁决由页面侧完成，桌面抬窗走宿主路由加 Win32 原生激活。

展开事件来源与降级说明

提醒核心按宿主代际取源（见上表），当前会话一律来自客户端 sessions 服务：

当前会话 SessionSnapshot：running true→false = 回复完成；
待办交互：uiSession 的 sessionStatus（≥ 0.1.6，逐会话 pendingInteraction）或 pendingInteractions（0.1.2 .. 0.1.5）出现新 key = 模型在等你，容器里带上审批工具名 / 理由、提问文本；旧宿主回落到控制器快照的 pending[]；
其它已列会话摘要：running true→false（或旧宿主的 completed 边沿）= 后台工作提醒。宿主的「完成未读」级别标志负责补漏与标题标记：≥ 0.1.6 用 sessionStatus 行的 completionUnread（后台会话完成即点亮、打开该会话/再次开跑/会话消失即清零），旧宿主用列表行的 completed 提醒位（选中会话即清零）；页面没看见的完成边沿（插件热重载中途、快照合并跳变）由此补报一次，边沿与级别标志同来时按短时间窗合并，只响一声。
子代理会话：列表行带 origin: 'subagent'（并有 parentId）的后台会话默认静音；你正打开着的那个子代理会话不算静音对象，它的提醒走当前对话的常规规则（页面可见时默认只留标题标记、转后台补发），切进来时积压的等待同样补上，切走后重新静音。只有 parentId、没有 origin 的分支（fork）会话属于你自己的对话，始终照常提醒。

提醒核心仍然零第三方运行时依赖、完全自包含：通知文字按所选语言（跟随界面 / 中文 / English）即时解析。设置页是可选的 React 呈现层——当 DSH web profile 提供 slots / locale / react 时才注册进「设置 → 通知提醒」，缺任一能力时插件自动降级为纯提醒（无设置页），不影响功能。

快捷裁决怎么走通的

带「同意 / 拒绝」按钮的通知只能由 Service Worker 弹出（往 new Notification() 里传 actions 会直接抛 TypeError），所以 bundle 的同一份文件再注册成一个只干转信的 worker，把「点了哪个按钮」带回页面。裁决仍在页面里发生，调的是审批面板里「允许一次 / 拒绝」用的同一个 PendingApproval.answer('allowed-once' | 'rejected')——「同意」就是「允许一次」，不多放行任何东西。

展开按钮通知的记账与调窗口

每条按钮通知按交互 key 记账，一次只认领一条等待；请求被页面里答掉、或被新请求顶替之后，残留通知上的按钮再点也不会误裁，只是安静地关掉。带按钮的通知停留 12 秒（普通通知 5 秒），到点自动撤；没来得及点就回页面里裁决，对话里的审批一直等着你。

点正文的「调窗口 + 切对话」也归 worker 这半侧调度：client.focus() 只调起一个窗口（优先当前可见的），也只让那个窗口切对话——多个 DSH 标签页不会互相抢焦点或一起乱切。

桌面端怎么抬窗的

DSH Desktop 是一层 Electron 壳，页面跑在 dsh-app://app 下：DOM 的 window.focus() 只动浏览器窗口对象、碰不到原生窗口，壳的 will-navigate 又把页面里发 dsh: 的常规出口堵上了。现在走插件自己的宿主路由——页面 POST /__dsh-notify-me/focus-window，宿主起 powershell.exe 跑 lib/focus-window.ps1，由它枚举原生窗口、自适应激活（1.5.2 到 1.13.0 那条 dsh://open 深链在 0.2.1-rc.2 上复测 3/3 无效，1.14.0 起整条删掉）。

展开路由、激活顺序、实测数据与安全闸门

壳把 dsh-app://app 下除静态资源以外的所有路径原样转发给宿主 HTTP server（带 origin 校验、注入宿主 cookie），所以上面那个 POST 是同源请求，没有 CORS 问题；宿主半（lib/index.js）本来就跑在 Electron 主进程的子进程里，process.ppid 就是主窗口所属的浏览器进程。点通知时：页面 POST → 宿主起一次 powershell.exe 跑 lib/focus-window.ps1 -ProcessId <ppid> → 脚本枚举该 pid 下可见、无 owner、非 toolwindow 的顶层窗口（优先类名 Chrome_WidgetWin_1，再按 GetWindowRect 面积取最大）→ 自适应激活 → 比对 GetForegroundWindow() 打印 FOCUSED=1|0 → 宿主回 200 / 202。

激活顺序是实的：已经在前台就什么都不做（最常见的情况，零闪烁）；最小化了先 SW_RESTORE；然后合成一次 ALT 按键（keybd_event 按下抬起）给本线程前台权限，再 SetForegroundWindow；这一串都不行才退到 SW_MINIMIZE + SW_RESTORE 兜底。单独调 SetForegroundWindow 会被前台锁直接拒，按调用算、跟 ForegroundLockTimeout 无关；这也重新解释了 1.5.2 那套深链「时灵时不灵」——能抬起来的那些次，多半是系统在通知被点击时自己激活了应用。

实测（powershell.exe 5.1，同一轮跑完）：窗口在前台 ×3、最小化 + 记事本在前台 ×3、可见但被盖住 ×3，全部 FOCUSED=1 且前台窗口比对一致，最小化那几个的 IsIconic 都从 true 变回 false；记事本最大化完全遮挡、最小化 + 完全遮挡、-ProcessId 0 自动探测同样成功。脚本内部耗时最坏 434 ms，进程启动到退出最坏 782 ms，都在 8 秒上限内；pwsh 7.6 对照一轮行为一致，只是 Add-Type 编译慢约 100 ms（脚本刻意不用 7 的语法）。不存在的 pid、存在但没有可见窗口的 pid 都稳定 FOCUSED=0 并 exit 0。

安全上只开一条 exact 路由。词表之外的请求一律拒：非 GET / HEAD / POST 回 405（包括预检的 OPTIONS，且从不回任何 CORS 头），非桌面宿主（Web 版、macOS / Linux、纯 Node）回 501，缺 x-dsh-notify-me-focus: focus 头回 403。

那个头只是「这是页面发来的」标记，不是防线——DNS rebinding 的恶意页对目标地址而言是同源的，能带任意自定义头、也不触发预检。真正的闸门是三层：对端地址必须是 loopback；Host 必须是 loopback 名（127.0.0.1 / localhost / [::1]，可带端口），因为壳转发时 host 已被删掉、由 fetch 按 loopback URL 重填，而 rebinding 的页面 Host 仍是攻击者域名；带了 Origin 就必须和 Host 同源。任一条不符回 403，reason 分别是 bad-remote / bad-host / cross-origin。GET 只回 {ok, route, enabled, desktop, platform}，装完可以先用浏览器打开确认路由在不在。400 毫秒内的重复调用合并成一次，脚本超过 8 秒没回话就 kill 掉按失败处理。

抬不起来的几种场合与已知限制里列的一致（提权窗口、另一虚拟桌面、前台被反复抢走、SW_HIDE 托盘隐藏），一律如实回 202、对话照常切。

已知限制

运行前提

页面必须开着才会提醒（后台标签 / 最小化可以，关标签页即失效——浏览器层方案固有限制）。
通知经由浏览器弹出，需允许浏览器通知权限；每次页面加载后第一次出声 / 弹通知前要先在页面上点过一下；未授权时只剩提示音与标题标记。
系统通知横幅只画在主屏：Windows 没有设置项、Chromium 没有 API 能把它指到别的显示器（多屏时副屏收不到）。要跨屏只能靠外部推送转到手机（1.12.0 起页面里不再画审批卡片）。
配置存在浏览器 localStorage：换浏览器 / 设备或清除站点数据后回到默认值（设置页可一键恢复默认）。

平台差异

快捷裁决按钮要 Service Worker：http://127.0.0.1、https 可用，http://192.168.x.x 这类局域网地址不行；桌面端（dsh-app://）已实测无法注册 Service Worker（宿主未开放 allowServiceWorkers 特权），审批通知退回无按钮样式。宿主不渲染通知按钮时，debug() 的 bridge 字段会说明原因，其余功能不受影响。
Windows 的系统通知标签上限 64 字符，而 Chromium 交给平台的是 n#<origin>#<tag> 整串——桌面页面 dsh-app://app 一项就占去 16 个。插件按当前 location.origin 算剩余预算，超长时保留可读前缀、尾部换成短哈希，所以 debug() 里看到的标签可能被截短；平台仍然拒发时，原文记在 debug().lastToastReject，设置页的测试按钮也会如实报出来，不再「提示已发送但什么都没弹」。
桌面端（Windows）点通知后窗口仍可能抬不起来：目标窗口属于更高完整性级别（提权 / UAC）、在另一个虚拟桌面、前台被别的进程反复抢回去，或窗口被 SW_HIDE 隐藏到托盘时，宿主脚本回 FOCUSED=0、路由回 202，对话照常切（详见桌面端怎么抬窗的）。
macOS：提醒、提示音、标题标记、点通知跳转都没有平台假设，照常工作；但 DSH Desktop（Electron）的系统通知要求应用已签名，未签名的通知直接发不出去，官方 macOS 版是否满足这一前提未实测；审批按钮在 macOS 桌面宿主上的渲染同样未实测（Windows 桌面端已实测不渲染）。

提醒内容与时机

≥ 0.1.6（含 0.2.0-rc.2、0.2.1-rc.2）的「回复完成」提醒正文只有会话名，不再附带回复摘要——宿主快照已不再提供 nodes；提醒本身照常触发。
标题标记由宿主与插件共同写 document.title：宿主重算标题时标记可能被覆盖，直到下一次提醒事件重新写成。
「当前对话不弹通知」按「窗口是否在前台」判定：被别的应用盖住、切到别的应用、最小化都算后台；回到前台或重新有键鼠输入后恢复静默。

外部推送

受浏览器跨域（CORS）限制：端点不放行时自动降级为「送出但不可确认」（no-cors），如实标为「已送出不可确认」；Discord、飞书、Server酱、WxPusher 放行跨域，可直接确认送达。钉钉不放行任何 CORS 头、又只收 application/json，页面发不出去，所以没有做成目标类型（自建中转 + 自定义目标才行）。临时失败（网络中断、5xx、429）按退避重试，重试仍失败进失败记录，其余错误立即停、不重试；转发在本地提醒决定要发之后才触发，所以被静音的提醒也不会外发。

设置页图标补丁

左侧导航行图标靠 DOM 补丁：外壳按分区 id 硬编码图标且 settings.section 没有图标字段，插件只能在面板渲染后把那一行的 <svg> 换成铃铛。命中依赖宿主当前的面板结构（data-shortcut-modal="settings" + 导航按钮里的标签 <span>），DSH 改了这套结构就会静默回落到默认齿轮，其余功能不受影响。标志与命名的取舍见 docs/brand/README.md。

开发自检

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 时自动跳过）
powershell -NoProfile -File lib\focus-window.ps1 -ProcessId 0   # 手动验证抬窗脚本，末行应是 FOCUSED=1
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 指定即可。

致谢与贡献须知

贡献者	贡献
	#7：宿主代际兼容（0.1.6+ / 0.2.0）的报障与复测
	#8：子代理会话静音（`ignoreSubagent`），含测试与文档
	#9：桌面端抬窗链路的逐层排查与真实壳复测
	#10：「音效来源」（内置合成音 / 自定义音频 / 系统通知音）
	#13 / #14：多会话下空闲页面占用 CPU 的性能报告与修复
	#12：外部通知转发（Discord / Bark / Gotify / 自定义 Webhook）
	#17：安卓端收消息的诉求，促成飞书 / Server酱 / WxPusher 三种目标
	#16：离开判定 `idleMinutes`、「回复完成」判定 `donePolicy`、自动消失 `autoDismiss`

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

License

MIT — 见 LICENSE。

dsh-notify-me

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

简体中文 | English

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

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

需要你操作时：审批、方案确认、提问，用通知、提示音和标题标记提醒。
后台回复完成时：及时回来查看结果，点击通知可回到对应对话；提醒时机可选「仅后台 / 仅当前对话静默 / 总是提醒」。
人走开但窗口没走：窗口留在最前台、人却离开座位，超过 3 分钟没有输入也算离开，该提醒的照常提醒；收到的那条通知不会在你回来之前自己消失。
离开电脑时：可选转发到 Discord、Bark、Gotify、飞书群机器人、Server酱、WxPusher 或自己的 Webhook。

页面或桌面应用需保持运行（后台 / 最小化可以）；系统通知需要通知权限。审批按钮依赖 Service Worker，只有 Web 端有，桌面端的通知不带按钮，点通知回到对话里裁决。

效果预览

Windows 上经 Edge 显示的 DSH 普通通知，未包含审批按钮

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

展开设置界面预览

通知提醒设置页：页眉、提醒方式、什么时候提醒、试一试与折叠的高级设置

只截插件自己的面板（真实组件，与宿主同款深色主题），不带 DSH 左侧导航栏；每行说明在鼠标停在标题文字上时才出现，所以这里只看到标题。

安装

DSH Web

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

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

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

DSH Desktop

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

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

首次验证

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

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

window.__dshNotifyMe.test("done")        // 「完成」示例
window.__dshNotifyMe.test("attention")   // 「需要你」示例
window.__dshNotifyMe.test("approval")    // 桥可用时带「同意 / 拒绝」按钮；否则只发普通通知（桌面端即如此）
window.__dshNotifyMe.debug()             // 桥接状态看 bridge 字段（active = 按钮可用）；最近一次被平台拒发的原因在 lastToastReject

为什么需要它

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

提醒时机

事件	默认行为
🔔 需要你操作	页面可见也提醒；当前对话只留标题标记
✅ 回复完成	页面隐藏 / 后台时提醒（可选「仅当前对话静默」或「总是提醒」）

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

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

在 DSH 设置里改配置

提醒方式

启用提醒 总开关：关闭后不弹通知、不响提示音，也不改标签页标题；
提示音 / 音量：开关直接切；音量滑块收在该行里，点一下标题（▸ 变成 ▾）展开。具体播什么由「高级设置 → 音效来源」决定；
审批通知上直接裁决（默认开）：审批带「同意 / 拒绝」，点一下即完成裁决，不用切回页面。Web 走带按钮的系统通知；桌面端 dsh-app:// 注册不了 Service Worker，通知上没有按钮，点通知回到对话里裁决。设置页「试一试」下面那行会如实说明当前环境能不能给按钮。

什么时候提醒

窗口在前台时也提醒「需要你」（默认开）：关掉后只有窗口转到后台才提醒；
当前对话不弹通知（默认开）：正看着的对话里的等待只留标签页标记，人离开后照常补发；
「回复完成」什么时候提醒（默认「仅后台」）：仅后台 / 仅当前对话静默 / 总是提醒，三选一；
通知自动消失（默认「离开时保留」）：离开时保留 / 总是关闭 / 从不关闭，三选一；
子代理会话不提醒（默认开）：跳过后台子代理（subagent）会话，你正开着的那个照常提醒；
点击通知回到对应对话（默认开）：切到对应对话并把窗口带到前台，桌面端走原生抬窗，多个标签页只调起一个。

展开各开关的边界条件

后台的判定：切到别的应用、被别的窗口盖住、最小化都算；窗口一直留在前台但 3 分钟没有任何键鼠输入同样算，idleMinutes: 0 退回只看窗口。
「当前对话不弹通知」何时补发：窗口转到后台或闲置超时后照常提醒；若你已处理掉就作废。
「回复完成」三档：「仅后台」＝不在看页面才提醒；「仅当前对话静默」＝屏幕上那条静默、别的对话照常提醒，多开对话时有用；「总是提醒」＝从不静默。老配置里的「窗口在前台时也提醒『回复完成』」开关自动迁移到这一项。
「离开时保留」：只有你人在页面前时才几秒后关闭，人不在时收到的那条留在通知中心等你回来；带「同意 / 拒绝」的审批通知仍按 12 秒走，同样不会在人不在时被撤掉。
点击通知的兜底：桌面端抬不起来时只切对话，原因记在 debug().raiseLast 里；关掉这一项后点通知不做任何事。

试一试

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

高级设置

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

音效

外部推送

目标地址、转发开关、发送测试与失败记录

外部通知（默认关）：把提醒同时转发到你自己的推送端点，人不在电脑前也能收到；可加多个目标，每个目标可单独启停。「转发「需要你」」「转发「回复完成」」各自独立开关；发送测试通知往所有目标发一条测试消息（不受这两类开关限制，也不会冒充真提醒）。转发跟本地提醒走同一套触发规则（「当前对话不弹通知」等开关同样管它）；提醒正文会原样发往你填的地址，只填你自己信任的端点；
各目标的填法：Discord 填 Webhook 地址；Bark 填 https://api.day.app/<设备密钥>；Gotify 填 https://<服务器>/message?token=<应用令牌>；飞书填群机器人 Webhook，可选填签名校验密钥；Server酱填 …/send/<SendKey>.send 完整地址；WxPusher 填 appToken 与接收者 UID；自定义端点收一条 POST JSON：{source, event, title, body, text, sessionId, time}；
可靠投递：明显是临时故障的失败（网络中断、5xx、429）按 2 秒 / 6 秒自动重试两次，其它错误立即停；重试仍失败会把这一条记进「失败记录」（最多 10 条，只留标题与正文摘要和主机名，不留完整端点），设置页能一眼看到并清空；
每个目标的状态：目标行右侧显示它最近一次投递的结果（上次成功 / 上次已送出但不可确认 / 上次失败 + 原因），并各自带一个启停开关——某个端点临时不可用就单独关掉它，不用关掉整类事件；
签名：自定义目标填了签名密钥时，请求带 X-DSH-Notify-Signature（对请求体做 HMAC-SHA256，sha256=<hex>）；飞书填了签名密钥时按官方算法在请求体里带 timestamp / sign；
消息模板（可选）：飞书 / Server酱 / WxPusher / 自定义目标可填模板，占位符 {{title}} {{body}} {{event}} {{time}} {{session}}，留空默认是「标题 + 换行 + 正文」；
钉钉不在支持列表里：钉钉群机器人接口不返回任何 CORS 头，且只接受 application/json——浏览器页面既读不到响应，也无法发出符合要求的请求（no-cors 下 Content-Type 会被限制成 safelisted 类型）。要用钉钉，请在自己能控制的机器上搭一个中转，再把「自定义 Webhook」指向它。

运行环境与诊断

通知语言、桌面端抬窗与恢复默认

通知语言：跟随界面 / 简体中文 / English——决定通知文字与 🔔 … 标题标记使用的语言；
桌面端抬窗：1.14.0 起由宿主路由做原生激活，最小化、被别的窗口盖住的都实测能抬回来（见桌面端怎么抬窗的）；
恢复默认设置：把所有开关与音效设置还原成出厂值（不动外部推送目标和已选的自定义音频文件）。

提醒渠道

渠道	表现
系统通知	经浏览器进 Windows 通知中心 / macOS 通知中心，点击回到对应对话；Web 端可带「同意 / 拒绝」
提示音	默认 WebAudio 合成音，「需要你」与「完成」音型不同；可换自定义音频，或交给系统通知音
标签页标题	`🔔 需要你 · …` / `✅ 回复完成 · …`（随通知语言切换），打开对应会话即消失；两种标记可同时出现
外部推送（可选，默认关）	把同一条提醒转发到 Discord / Bark / Gotify / 飞书 / Server酱 / WxPusher / 自定义 Webhook

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

兼容性

展开宿主代际的形状差异与两个已知坑

插件按宿主代际自动选源；下表是各形状的边界，不是门禁：

宿主代际	「需要你」交互来源	判断当前会话	点通知切会话
`≤ 0.1.2-alpha.1`	控制器快照的 `pending[]`	快照 `current`	`sessions.open()`
`0.1.2-alpha.2 .. 0.1.6-alpha.1`	`uiSession.pendingInteractions`	快照 `current`	`sessions.open()`
`≥ 0.1.6-alpha.2`（含 `0.2.0-rc.2`、`0.2.1-rc.2`）	`uiSession.sessionStatus`	`retainedBy.mainView`	`uiWorkspace.openSession()`

控制台高级配置

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

展开控制台 API 与存储说明

window.__dshNotifyMe.config                       // 查看
window.__dshNotifyMe.setConfig({
  enabled: true,           // false = 关闭所有提醒（主开关）
  language: "auto",        // 'auto' 跟随界面 | 'zh' 简体中文 | 'en' English
  attentionHiddenOnly: false, // true = 页面可见时「需要你」不提醒
  currentHiddenOnly: true,    // true = 当前对话的等待只留标题标记（人离开后补发）
  donePolicy: "background",   // 「回复完成」策略：'background' 仅后台 | 'smart' 仅当前对话静默 | 'always' 总是提醒
  idleMinutes: 3,             // 超过多少分钟没有键鼠输入算「离开」（0 = 关掉闲置判定）
  autoDismiss: "present",     // 通知自动消失：'present' 离开时保留 | 'always' 总是关闭 | 'never' 从不关闭
  ignoreSubagent: true,       // true = 后台子代理（subagent）会话不提醒（当前打开的照常）
  sound: true,                // 提示音开关（含「系统通知音」模式）
  soundDone: "synth",         // 「完成」音效来源：'synth' 内置 | 'custom' 自定义文件 | 'system' 系统通知音
  soundAttention: "synth",    // 「需要你」音效来源，取值同上
  volume: 0.5,                // 音量 0~1
  autoFocus: true,            // 点通知回到提醒所属的对话
  quickActions: true,         // 审批通知上的「同意 / 拒绝」按钮
  externalEnabled: false,     // 外部通知转发主开关（默认关：不填端点就什么都不发）
  externalAttention: true,    // 转发「需要你」（触发规则跟本地提醒完全一致）
  externalDone: true,         // 转发「回复完成」
  externalRetryDelays: [2000, 6000], // 可重试失败的退避间隔（毫秒，带抖动；[] = 只发一次）
  externalTargets: []         // 推送目标，见下方字段说明
})
// 目标的形状：{id, type, url, secret?, token?, uid?, template?, enabled?}
// type: 'discord' | 'bark' | 'gotify' | 'feishu' | 'serverchan' | 'wxpusher' | 'custom'
// token/uid 只用于 wxpusher（url 固定为官方端点）；secret 用于飞书签名与自定义 HMAC 签名；
// template 可选，占位符 {{title}} {{body}} {{event}} {{time}} {{session}}；enabled:false 单独停用该目标
window.__dshNotifyMe.resetConfig()                // 恢复默认（同时清掉已选的自定义音效文件）
window.__dshNotifyMe.decide("approval:3", "allowed-once")  // 程序化裁决："allowed-once" | "rejected"
window.__dshNotifyMe.testExternal()               // 显式外发测试：向有效目标发送，返回 {sent, unverified, failed, statuses}

外部通知测试的开关边界：设置页「发送测试通知」要求「启用提醒」与「外部通知」主开关开启，但忽略两类提醒的转发开关。控制台 testExternal() 是显式测试调用：只要配置了有效目标，即使上述主开关关闭，也会向这些目标发送测试消息；没有有效目标则不发送。普通的 test("done") / test("attention") / test("approval") 只测试本地提醒，不外发。

自定义音效文件不在 dshNotifyMe.config 里，而是按类别各存一个键（dshNotifyMe.sound.done / dshNotifyMe.sound.attention，内容是 {name, size, data} 的 data URL）——一个文件转成 data URL 会膨胀约 1.37 倍，塞进配置会拖慢每次读取。resetConfig() 会连这两个键一起清掉。

想确认当前生效的来源，看 window.__dshNotifyMe.debug() 的 soundDone / soundAttention 与 customSoundDone / customSoundAttention。

工作原理

提醒核心监听会话状态与待处理交互；审批裁决由页面侧完成，桌面抬窗走宿主路由加 Win32 原生激活。

展开事件来源与降级说明

提醒核心按宿主代际取源（见上表），当前会话一律来自客户端 sessions 服务：

当前会话 SessionSnapshot：running true→false = 回复完成；
待办交互：uiSession 的 sessionStatus（≥ 0.1.6，逐会话 pendingInteraction）或 pendingInteractions（0.1.2 .. 0.1.5）出现新 key = 模型在等你，容器里带上审批工具名 / 理由、提问文本；旧宿主回落到控制器快照的 pending[]；
其它已列会话摘要：running true→false（或旧宿主的 completed 边沿）= 后台工作提醒。宿主的「完成未读」级别标志负责补漏与标题标记：≥ 0.1.6 用 sessionStatus 行的 completionUnread（后台会话完成即点亮、打开该会话/再次开跑/会话消失即清零），旧宿主用列表行的 completed 提醒位（选中会话即清零）；页面没看见的完成边沿（插件热重载中途、快照合并跳变）由此补报一次，边沿与级别标志同来时按短时间窗合并，只响一声。
子代理会话：列表行带 origin: 'subagent'（并有 parentId）的后台会话默认静音；你正打开着的那个子代理会话不算静音对象，它的提醒走当前对话的常规规则（页面可见时默认只留标题标记、转后台补发），切进来时积压的等待同样补上，切走后重新静音。只有 parentId、没有 origin 的分支（fork）会话属于你自己的对话，始终照常提醒。

快捷裁决怎么走通的

展开按钮通知的记账与调窗口

桌面端怎么抬窗的

展开路由、激活顺序、实测数据与安全闸门

抬不起来的几种场合与已知限制里列的一致（提权窗口、另一虚拟桌面、前台被反复抢走、SW_HIDE 托盘隐藏），一律如实回 202、对话照常切。

已知限制

运行前提

页面必须开着才会提醒（后台标签 / 最小化可以，关标签页即失效——浏览器层方案固有限制）。
通知经由浏览器弹出，需允许浏览器通知权限；每次页面加载后第一次出声 / 弹通知前要先在页面上点过一下；未授权时只剩提示音与标题标记。
系统通知横幅只画在主屏：Windows 没有设置项、Chromium 没有 API 能把它指到别的显示器（多屏时副屏收不到）。要跨屏只能靠外部推送转到手机（1.12.0 起页面里不再画审批卡片）。
配置存在浏览器 localStorage：换浏览器 / 设备或清除站点数据后回到默认值（设置页可一键恢复默认）。

平台差异

快捷裁决按钮要 Service Worker：http://127.0.0.1、https 可用，http://192.168.x.x 这类局域网地址不行；桌面端（dsh-app://）已实测无法注册 Service Worker（宿主未开放 allowServiceWorkers 特权），审批通知退回无按钮样式。宿主不渲染通知按钮时，debug() 的 bridge 字段会说明原因，其余功能不受影响。
Windows 的系统通知标签上限 64 字符，而 Chromium 交给平台的是 n#<origin>#<tag> 整串——桌面页面 dsh-app://app 一项就占去 16 个。插件按当前 location.origin 算剩余预算，超长时保留可读前缀、尾部换成短哈希，所以 debug() 里看到的标签可能被截短；平台仍然拒发时，原文记在 debug().lastToastReject，设置页的测试按钮也会如实报出来，不再「提示已发送但什么都没弹」。
桌面端（Windows）点通知后窗口仍可能抬不起来：目标窗口属于更高完整性级别（提权 / UAC）、在另一个虚拟桌面、前台被别的进程反复抢回去，或窗口被 SW_HIDE 隐藏到托盘时，宿主脚本回 FOCUSED=0、路由回 202，对话照常切（详见桌面端怎么抬窗的）。
macOS：提醒、提示音、标题标记、点通知跳转都没有平台假设，照常工作；但 DSH Desktop（Electron）的系统通知要求应用已签名，未签名的通知直接发不出去，官方 macOS 版是否满足这一前提未实测；审批按钮在 macOS 桌面宿主上的渲染同样未实测（Windows 桌面端已实测不渲染）。

提醒内容与时机

≥ 0.1.6（含 0.2.0-rc.2、0.2.1-rc.2）的「回复完成」提醒正文只有会话名，不再附带回复摘要——宿主快照已不再提供 nodes；提醒本身照常触发。
标题标记由宿主与插件共同写 document.title：宿主重算标题时标记可能被覆盖，直到下一次提醒事件重新写成。
「当前对话不弹通知」按「窗口是否在前台」判定：被别的应用盖住、切到别的应用、最小化都算后台；回到前台或重新有键鼠输入后恢复静默。

外部推送

受浏览器跨域（CORS）限制：端点不放行时自动降级为「送出但不可确认」（no-cors），如实标为「已送出不可确认」；Discord、飞书、Server酱、WxPusher 放行跨域，可直接确认送达。钉钉不放行任何 CORS 头、又只收 application/json，页面发不出去，所以没有做成目标类型（自建中转 + 自定义目标才行）。临时失败（网络中断、5xx、429）按退避重试，重试仍失败进失败记录，其余错误立即停、不重试；转发在本地提醒决定要发之后才触发，所以被静音的提醒也不会外发。

设置页图标补丁

左侧导航行图标靠 DOM 补丁：外壳按分区 id 硬编码图标且 settings.section 没有图标字段，插件只能在面板渲染后把那一行的 <svg> 换成铃铛。命中依赖宿主当前的面板结构（data-shortcut-modal="settings" + 导航按钮里的标签 <span>），DSH 改了这套结构就会静默回落到默认齿轮，其余功能不受影响。标志与命名的取舍见 docs/brand/README.md。

开发自检

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 时自动跳过）
powershell -NoProfile -File lib\focus-window.ps1 -ProcessId 0   # 手动验证抬窗脚本，末行应是 FOCUSED=1
npm pack --dry-run               # 预览发布包

致谢与贡献须知

贡献者	贡献
	#7：宿主代际兼容（0.1.6+ / 0.2.0）的报障与复测
	#8：子代理会话静音（`ignoreSubagent`），含测试与文档
	#9：桌面端抬窗链路的逐层排查与真实壳复测
	#10：「音效来源」（内置合成音 / 自定义音频 / 系统通知音）
	#13 / #14：多会话下空闲页面占用 CPU 的性能报告与修复
	#12：外部通知转发（Discord / Bark / Gotify / 自定义 Webhook）
	#17：安卓端收消息的诉求，促成飞书 / Server酱 / WxPusher 三种目标
	#16：离开判定 `idleMinutes`、「回复完成」判定 `donePolicy`、自动消失 `autoDismiss`

License

MIT — 见 LICENSE。

chromoany/dsh-notify-me

dsh-notify-me

效果预览

安装

DSH Web

DSH Desktop

首次验证

为什么需要它

提醒时机

在 DSH 设置里改配置

提醒方式

什么时候提醒

试一试

高级设置

音效

外部推送

运行环境与诊断

提醒渠道

兼容性

控制台高级配置

工作原理

快捷裁决怎么走通的

桌面端怎么抬窗的

已知限制

开发自检

致谢与贡献须知

License

Community comments

chromoany/dsh-notify-me

dsh-notify-me

效果预览

安装

DSH Web

DSH Desktop

首次验证

为什么需要它

提醒时机

在 DSH 设置里改配置

提醒方式

什么时候提醒

试一试

高级设置

音效

外部推送

运行环境与诊断

提醒渠道

兼容性

控制台高级配置

工作原理

快捷裁决怎么走通的

桌面端怎么抬窗的

已知限制

开发自检

致谢与贡献须知

License

Community comments