Skip to content
Back to search

dsh-notify-me

DSH 桌面消息提醒插件 / desktop notification and message alerts for DeepSeek Harness web:需要你操作(可操作提醒)与回复完成提醒,系统通知+提示音+标签页标题,设置页开关 + 中英通知语言

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/chromoany/dsh-notify-me with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/chromoany/dsh-notify-me'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/chromoany--dsh-notify-me/badge.svg)](/listings/chromoany--dsh-notify-me)

HTML

<a href="/listings/chromoany--dsh-notify-me"><img src="/api/listings/chromoany--dsh-notify-me/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# DSH 官方插件命令:安装并自动挂载进 web profile
dsh plugin --profile web add dsh-notify-me

重启 `dsh web` 后硬刷新页面(Ctrl+Shift+R)。

**兼容性** — 插件按宿主代际自动选源,逐版本声明见 `package.json` 的 `dsh.compatibility.dshReleases`:

| 宿主代际 | 「需要你」交互来源 | 判断当前会话 | 点通知切会话 | | --- | --- | --- | --- | | `≤ 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`) | `uiSession.sessionStatus` | `retainedBy.mainView` | `uiWorkspace.openSession()` |

区间仅作示意:插件按 store 形状自动选源(`sessionStatus` 存在即走新路),版本号只是各形状的出现边界。`package.json` 的 `peerDependencies` 范围同理只影响 npm install 的提示文案——兼容与否以 `dshReleases` 的逐版实测声明为准,未实测的新版本由形状驱动兜底。

实测**真正激活**(各自独立 profile 启动:设置里出现「通知提醒」分区,即插件的 `apply` 确实执行)于 `0.1.2-rc.1`、`0.1.5-rc.2` 与 `0.2.0-rc.2`;更早的 `0.1.1-rc.2` 亦验证过。两个坑值得记住:一是 `dsh.client.inject` 里列了新版运行时已不再提供的包,客户端条目会停在 `pending (waiting for services: …)` 而永不执行——1.1.3 在 `0.1.2-rc.1` 及以后正是这样失效的;二是宿主换存储/字段名时**不会报错**,提醒只会静默失效——`0.2.0-rc.2` 上 `pendingInteractions`→`sessionStatus`、`list.current`→`retainedBy.mainView`、`sessions.open()`→`uiWorkspace.openSession()` 都是这一类,所以每次适配都要用 `window.__dshNotifyMe.debug()` 确认真的是 `bound`、以及用的是哪个来源。

**验证** — F12 控制台执行:

window.__dshNotifyMe.test("done")        // 「完成」示例
window.__dshNotifyMe.test("attention")   // 「需要你」示例
window.__dshNotifyMe.test("approval")    // 「审批按钮」示例:通知上有「同意 / 拒绝」,点着试试
window.__dshNotifyMe.debug()             // 桥接状态看 bridge 字段,active = 按钮可用

没反应?九成是:通知权限被拒绝(在页面上点一下 → 选「允许」;或地址栏锁 → 站点设置 → 通知 → 允许 → 刷新)、装完没重启 DSH、系统设置里浏览器通知被关。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 556 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/brand/header.jpg" width="100%" alt="仓库头图:深色桌面上亮起的铃铛标志,标题 dsh-notify-me,副标题 Step away. Stay informed.">
  3. <h1 align="center">dsh-notify-me</h1>
  4. **离开 DSH 页面,也能及时知道何时需要回来。**
  5. 简体中文 | [English](README.en.md)
  6. [![npm version](https://img.shields.io/npm/v/dsh-notify-me?style=flat-square&label=npm&color=cb3837)](https://www.npmjs.com/package/dsh-notify-me)
  7. [![npm downloads](https://img.shields.io/npm/dm/dsh-notify-me?style=flat-square&label=downloads%2Fmonth&color=1F883D)](https://www.npmjs.com/package/dsh-notify-me)
  8. [![npm total downloads](https://img.shields.io/npm/dt/dsh-notify-me?style=flat-square&label=total%20downloads&color=1F883D)](https://www.npmjs.com/package/dsh-notify-me)
  9. [![License: MIT](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)
  10. [![test](https://github.com/chromoany/dsh-notify-me/actions/workflows/test.yml/badge.svg)](https://github.com/chromoany/dsh-notify-me/actions/workflows/test.yml)
  11. [![DSH Web and Desktop](https://img.shields.io/badge/DSH-Web%20%7C%20Desktop-blue?style=flat-square)](#安装)
  12. [![Package size](https://img.shields.io/npm/unpacked-size/dsh-notify-me?style=flat-square&label=package%20size)](https://www.npmjs.com/package/dsh-notify-me)
  13. [![DSH Compatibility](https://img.shields.io/badge/DSH-%E5%B7%B2%E9%80%82%E9%85%8D%200.2.2--rc.3%20%2F%200.2.1--rc.5-6366f1.svg?style=flat-square)](#兼容性)
  14. [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
  15. </div>
  16. [效果预览](#效果预览) · [安装](#安装) · [配置](#在-dsh-设置里改配置) · [兼容性](#兼容性) · [已知限制](#已知限制) · [更新日志](CHANGELOG.md)
  17. DSH Web / Desktop 的通知插件,让你敢不开完整访问,也不必一直守着页面。
  18. - **需要你操作时**:审批、方案确认、提问,用通知、提示音和标题标记提醒。
  19. - **后台回复完成时**:及时回来查看结果,点击通知可回到对应对话;提醒时机可选「仅后台 / 仅当前对话静默 / 总是提醒」。
  20. - **人走开但窗口没走**:窗口留在最前台、人却离开座位,超过 3 分钟没有输入也算离开,该提醒的照常提醒;收到的那条通知不会在你回来之前自己消失,一回到页面(点任务栏、Alt+Tab、点通知都算)就收起(想让它在回到页面后继续留着,打开「回到页面也保留提醒」)。
  21. - **离开电脑时**:可选转发到 Discord、Bark、Gotify、飞书群机器人、Server酱、WxPusher 或自己的 Webhook。
  22. - **连页面都关掉时**:可选让宿主进程兜底——页面不在时宿主继续把「需要你操作」「回复完成」推到你的网关;也可以只开同源中继,让页面够到要认证的网关。两项默认关,配置写在 profile 的 patch 层(见[页面关闭后:宿主侧兜底与同源中继](#页面关闭后宿主侧兜底与同源中继))。
  23. ## 效果预览
  24. ![Windows 上经 Edge 显示的 DSH 普通通知,未包含审批按钮](https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/screenshots/notify-toast.png)
  25. *普通通知示例 · Windows / Edge · 不含审批按钮。* [查看原图](https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/screenshots/notify-toast.png)
  26. <details>
  27. <summary>展开设置界面预览</summary>
  28. ![通知提醒设置页:页眉、提醒方式、什么时候提醒、会话静音、试一试与折叠的高级设置](https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/screenshots/settings-zh.png)
  29. 只截插件自己的面板(真实组件,与宿主同款深色主题),不带 DSH 左侧导航栏;每行说明在鼠标停在标题文字上时才出现,所以这里只看到标题。
  30. </details>
  31. > **macOS 桌面端(DSH Desktop)** 的系统通知由宿主拉起的小助手 `DSH Notify.app` 发出,需先执行一次 `bash macos/build.sh` 并在系统设置里允许它发通知(见 [macOS 桌面端怎么发系统通知](#macos-桌面端怎么发系统通知))。
  32. > 页面或桌面应用需保持运行(后台 / 最小化可以);系统通知需要通知权限。审批按钮在 Web 与 Windows 11 桌面端可用,macOS 桌面端、Windows 10 与没有 Service Worker 的页面点通知回对话里裁决(见[提醒渠道](#提醒渠道))。开启宿主侧兜底后,页面关闭仍能收到外部推送——本地通知与审批按钮仍要页面在。
  33. ## 安装
  34. ### DSH Web
  35. 已安装 DSH CLI 的用户,在终端执行:
  36. ```sh
  37. # 安装并自动挂载进 web profile
  38. dsh plugin --profile web add dsh-notify-me
  39. ```
  40. 重启 `dsh web`,然后硬刷新页面(Windows / Linux 是 Ctrl+Shift+R,macOS 是 Cmd+Shift+R)。如果你使用其他 Web profile,请把命令中的 `web` 换成实际名称。
  41. ### DSH Desktop
  42. 1. 在桌面应用打开 **插件 → 添加插件**。
  43. 2. 输入 npm 包名 `dsh-notify-me`,按应用提示完成安装,并确认插件已启用。
  44. 3. 完全退出并重新启动 DSH Desktop,使插件加载。
  45. 桌面端的 `desktop` profile 由 Electron 应用管理;不要把上面的 Web 命令改成 `--profile desktop`,CLI 会拒绝此操作。安装到 Web profile 也不会自动安装到桌面端。
  46. ## 首次验证
  47. 1. 在 DSH 页面上点击一次,按提示允许通知;若此前拒绝过,在浏览器站点设置中允许通知。操作系统也需要允许对应浏览器 / DSH Desktop 显示通知。
  48. 2. 打开 **设置 → 通知提醒**,确认出现该分区及底部插件版本号,保持「启用提醒」「提示音」开启。
  49. 3. 点击设置页的「测试『回复完成』」按钮:应出现一条测试通知,并按当前音效设置播放声音。这个本地测试不会转发到外部通知端点,也不受「窗口在前台时也提醒」开关限制。
  50. Web 用户可再测审批按钮,通知上会带「同意 / 拒绝」。Windows 11 桌面端由宿主发原生 Toast,同样带按钮(Windows 10 不发带按钮的原生通知,见[下文](#windows-桌面端怎么发带按钮的通知));macOS 桌面端只发普通通知(渠道差异见[提醒渠道](#提醒渠道))。
  51. <details>
  52. <summary>控制台验证(可选)</summary>
  53. 支持 DevTools 的环境也可执行:
  54. ```js
  55. window.__dshNotifyMe.test("done") // 「完成」示例
  56. window.__dshNotifyMe.test("attention") // 「需要你」示例
  57. window.__dshNotifyMe.test("approval") // Web 桥可用、或 Windows 桌面宿主原生 Toast 时带「同意 / 拒绝」按钮;macOS 桌面与无桥环境只发普通通知
  58. window.__dshNotifyMe.debug() // 桥接看 bridge(active = 按钮可用)、抬窗通道 raiseChannel、最近一次尝试 raiseLast、平台拒发原文 lastToastReject、设置是否真存下来 configStored、宿主协调看 hostBridge、原生通道看 macNative / macNativeLast、winNative / winNativeLast;切回页面后收通知看 toastsLive / toastsWithdrawn / lastToastWithdrawAt(还挂着几条 / 累计收起几条 / 最后一次的时间)
  59. ```
  60. </details>
  61. 没有测试通知时,先检查:通知权限是否被拒绝(在页面上点一下 → 选「允许」;或地址栏锁 → 站点设置 → 通知 → 允许 → 刷新)、装完没重启 DSH、系统设置里浏览器通知被关。
  62. ## 为什么需要它
  63. - **不开完整访问(`workspace-write` + ask)**:保留事前审批,但错过请求会让 agent 等待。
  64. - **开完整访问(full access)**:减少审批打断,同时放弃事前拦截能力。
  65. dsh-notify-me 把「监督」和「守在屏幕前」解耦:只在真的出现决策点(审批 / 方案确认 / 提问)或回复跑完时,才用系统通知把你叫回来——**让你敢不开完整访问**,不必靠放弃拦截能力来换效率。它不降低 full access 本身的权限风险(它不是沙箱),只是减少 ask 模式下因错过审批而产生的等待。
  66. ## 提醒时机
  67. | 事件 | 默认行为 |
  68. | --- | --- |
  69. | 🔔 需要你操作 | 页面可见也提醒;当前对话只留标题标记 |
  70. | ✅ 回复完成 | 页面隐藏 / 后台时提醒(可选「仅当前对话静默」或「总是提醒」) |
  71. **需要你操作**包括审批请求、方案待确认(plan review)和提问(`ask_user_question`)。带按钮的快捷裁决在 Web 与 Windows 11 桌面端可用(Windows 由宿主发原生 Toast),macOS 桌面端与没有 Service Worker 的页面点通知回到对话里裁决(见[已知限制](#已知限制))。
  72. **回复完成**也覆盖后台会话;完成但还没看时,标题带 `✅ 回复完成 ·` 标记,打开对应会话即撤。标题标记不受提醒策略限制。
  73. 通知正文的第一行是会话标题:当前正在看的会话和其他会话一样显示自己的标题,只有宿主还没给出标题的新会话才用「当前对话」占位符兜底。
  74. > **后台**子代理(subagent)子会话的等待与完成默认**不提醒**:DSH 把每个子代理子会话列成独立会话,但它们是所属主对话那一轮里的步骤,提醒只会是噪音。你当前打开的那个子代理会话不算在内,照常提醒。设置页「子代理会话不提醒」可关掉这个静音。
  75. ## 在 DSH 设置里改配置
  76. 打开 **设置 → 通知提醒**。页面按「提醒方式 → 什么时候提醒 → 试一试」三段排开,不常改的收进底部「高级设置」,点一下展开。每行只写标题,具体说明在鼠标停在标题文字上时弹出的小方框里(只有标题本身触发布局,整行空白处不会弹;触屏或键盘操作时留一份隐藏文本给读屏)。带 ▸ 的行点一下展开子项。
  77. ### 提醒方式
  78. - **启用提醒** 总开关:关闭后不弹通知、不响提示音,也不改标签页标题;
  79. - **提示音 / 音量**:开关直接切;音量滑块收在该行里,点一下标题(▸ 变成 ▾)展开。具体播什么由「高级设置 → 音效来源」决定;
  80. - **审批通知上直接裁决**(默认开):审批带「同意 / 拒绝」,点一下即完成裁决,不用切回页面。Web 走带按钮的系统通知;Windows 11 桌面端由宿主发原生 Toast,按钮是真的原生按钮;Windows 10 的系统通知派发不了按钮点击,审批仍在页面或浮层里裁决;macOS 桌面端 `dsh-app://` 注册不了 Service Worker、原生助手也不带按钮,点通知回到对话里裁决。设置页「试一试」下面那行会如实说明当前环境能不能给按钮。
  81. ### 什么时候提醒
  82. - **窗口在前台时也提醒「需要你」**(默认开):关掉后只有窗口转到后台才提醒;
  83. - **前台也提醒(一键)**(默认关):一次把下面三项调成「前台也提醒」——「窗口在前台时也提醒『需要你』」打开、「当前对话不弹通知」关掉、「回复完成」设为「总是提醒」。它不新增存储键,只是那三项的派生视图:三项任一被单独改动,这一行会跟着变;关掉它恢复默认的「只在后台提醒」;
  84. - **当前对话不弹通知**(默认开):正看着的对话里的等待只留标签页标记,人离开后照常补发;
  85. - **「回复完成」什么时候提醒**(默认「仅后台」):仅后台 / 仅当前对话静默 / 总是提醒,三选一;
  86. - **通知自动消失**(默认「离开时保留」):离开时保留 / 总是关闭 / 从不关闭,三选一;三种设置只管「时间到点」那一次关闭,你回到页面时残留的通知一律收起;
  87. - **回到页面也保留提醒**(默认关):打开后,离开时收到的通知在你回到 DSH 页面后不再被收起,会一直留到你点掉或点「关闭」——适合把系统通知样式设成「持续」、希望提醒常驻屏幕的用法;
  88. - **子代理会话不提醒**(默认开):跳过后台子代理(subagent)会话,你正开着的那个照常提醒;
  89. - **点击通知回到对应对话**(默认开):切到对应对话并把窗口带到前台,Windows 桌面走宿主路由原生抬窗、macOS / Linux 走 `dsh://open` 深链,多个标签页只调起一个。
  90. <details>
  91. <summary>展开各开关的边界条件</summary>
  92. - **后台的判定**:切到别的应用、被别的窗口盖住、最小化都算;窗口一直留在前台但 3 分钟没有任何键鼠输入同样算,`idleMinutes: 0` 退回只看窗口。
  93. - **「当前对话不弹通知」何时补发**:窗口转到后台或闲置超时后照常提醒;若你已处理掉就作废。
  94. - **「回复完成」三档**:「仅后台」=不在看页面才提醒;「仅当前对话静默」=屏幕上那条静默、别的对话照常提醒,多开对话时有用;「总是提醒」=从不静默。老配置里的「窗口在前台时也提醒『回复完成』」开关自动迁移到这一项。
  95. - **「离开时保留」**:你人在页面前时,普通通知几秒后自己收;人不在时收到的那条留在通知中心等你回来。回到页面(点任务栏、Alt+Tab、点通知、还原最小化的窗口都算)就立刻收起,三种设置都不影响这一条——不看通知中心,也不会被遗留通知挡着。**打开「回到页面也保留提醒」后,回到页面这一条也不再收起**,通知留到你点掉或点「关闭」,系统通知样式设成「持续」时会一直挂在屏幕上。带「同意 / 拒绝」的通知不设自动撤回,留到你点按钮、回页面把请求答掉、或被新请求顶替为止(仅 Web 端的 Service Worker 通知如此);macOS 桌面端画不出按钮的审批通知、以及 Windows 11 桌面端带按钮的原生审批 Toast,都按 12 秒收。宿主发出的原生通知(Windows 原生 Toast、macOS 通知中心)同样归这套记账管:人不在时同样不撤,回到页面同样收起(该开关打开时也保留),「总是关闭 / 从不关闭」也管得到它们。
  96. - **点击通知的兜底**:桌面端抬不起来时只切对话,原因记在 `debug().raiseLast` 里;关掉这一项后点通知不做任何事。
  97. </details>
  98. ### 静音某些对话
  99. 适合「后台跑着周期任务、但这次不用管它」的对话:只关掉那一行的提醒,别的照旧。
  100. - **静音**:鼠标移到侧边栏的会话行上,右侧出现铃铛,点一下即静音(按钮读作「静音此会话的提醒」);再点一次恢复。也可以右键点会话,在菜单里选「静音此会话的提醒」——触摸设备没有悬停条,菜单里这一行就是入口;
  101. - **标记**:被静音的对话在标题前显示一个划掉的铃铛(读屏读作「此会话已静音」);
  102. - **悬停铃铛可以关掉**:设置页「会话静音」卡片顶部的「悬停时显示静音按钮」默认开;关掉后悬停不再出铃铛,未静音的会话改用右键菜单。已静音的会话仍保留这枚铃铛——它既表示状态,点一下就能取消静音;标题前的划掉铃铛不受影响;
  103. - **范围**:「需要你」「回复完成」、提示音、标签页标记、外部推送一起关掉;别的对话完全不受影响;「试一试」里的测试按钮照发(它就是用来当场验证渠道的);
  104. - **持久化**:列表存在本地,刷新、重启都在;手工改坏的配置会被剪掉而不是让整页失效;
  105. - **关掉标签页之后**:静音列表会随心跳交给宿主,所以「页面关闭后的宿主侧兜底」也不会为它推送——否则关掉页面反而开始响。
  106. 设置页「什么时候提醒」下面有一张「会话静音」卡片,显示当前静音了几个对话,悬停铃铛的开关就在卡片顶部,可以一键「全部取消静音」。
  107. <details>
  108. <summary>边界条件</summary>
  109. - 标记注在宿主的 `sidebar.session.row.leading` 槽位,宿主在「这条会话有运行状态」时用状态点占着这个位置,标记就不渲染——正在跑的后台任务看不到划掉的铃铛,停下后自动回来。静音本身不受影响,通知照旧不发。
  110. - 右键菜单里那一行注在宿主旧的 `sidebar.workspaces.session.menu.item` 槽位,宿主不声明这个槽位时只是菜单里少一行,悬停铃铛、设置页和静音本身都不受影响。
  111. - 悬停铃铛关掉后,未静音的会话在行上没有任何静音入口,判断/取消静音都走右键菜单;已静音的会话行尾仍保留按下状态的铃铛。
  112. - 静音只看会话 id:重命名、换目录都不影响,删掉的会话留在列表里也不会报错(列表上限 200 条,恢复按钮随时清空)。
  113. - 静音不改变「回复完成」的 donePolicy 判定,也不改变「当前对话不弹通知」:两者叠加时以静音为准。
  114. </details>
  115. ### 试一试
  116. 三个按钮分别发一条「需要你」「回复完成」「审批按钮」测试提醒,用当前设置立即发,**不受**「什么时候提醒」里的开关限制;下方一行如实说明当前哪种渠道能给审批按钮。
  117. 设置页底部常显插件版本号(`dsh-notify-me v…`)——报障、核对是否装上新版本时直接照抄这一行。
  118. ### 高级设置
  119. 默认收起,点一下展开。里面收着三块不常改的东西:音效来源、外部推送、运行环境与诊断——分别见下面三节。
  120. #### 音效
  121. 「需要你」与「回复完成」可独立选择内置合成音(默认)、自定义音频文件或系统通知音。自定义音频上限 1 MiB,存在浏览器本地,可试听与移除;选系统通知音时完全不播插件音效,通知照发,声音交给操作系统(音色跟着系统通知设置走),此时「试听」会改发一条测试通知。任一来源缺文件、读不出来或存不下时回落到内置合成音,提醒不会变成哑的。
  122. #### 外部推送
  123. 默认关闭。支持 Discord Webhook / Bark / Gotify / 飞书群机器人 / Server酱(Turbo 与 Server酱³)/ WxPusher / 自定义 Webhook;提醒正文会发往你填写的地址,只使用可信端点。
  124. <details>
  125. <summary>目标地址、转发开关、发送测试与失败记录</summary>
  126. - **外部通知**(默认关):把提醒同时转发到你自己的推送端点,人不在电脑前也能收到;可加多个目标,每个目标可单独启停。「转发「需要你」」「转发「回复完成」」各自独立开关;**发送测试通知**往所有目标发一条测试消息(不受这两类开关限制,也不会冒充真提醒)。转发跟本地提醒走同一套触发规则(「当前对话不弹通知」等开关同样管它);总开关关闭后**页面关闭时的宿主侧兜底也一并停**(开关随心跳交给宿主,见「页面关闭后」一节),不会出现「页面关了还在推」;提醒正文会原样发往你填的地址,**只填你自己信任的端点**;
  127. - **各目标的填法**: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}`;
  128. - **可靠投递**:明显是临时故障的失败(网络中断、5xx、429)按 2 秒 / 6 秒自动重试两次,其它错误立即停;关掉「外部通知」总开关或删掉某个目标后,已经排在定时器上的重试立刻作废,既不算失败也不进失败记录;重试仍失败会把这一条记进「失败记录」(最多 10 条,只留标题与正文摘要和主机名,不留完整端点),设置页能一眼看到并清空;
  129. - **服务码与「不可确认」**:飞书 / Server酱 / WxPusher 的 2xx 还会读返回体里的服务码(飞书与 Server酱是 `0`,WxPusher 是 `1000`),码不对按失败记并带服务端文案;2xx 但正文不是该服务的 JSON(空白、代理或 WAF 的网页)记「已送出不可确认」,不冒充成功;
  130. - **每个目标的状态**:目标行右侧显示它最近一次投递的结果(上次成功 / 上次已送出但不可确认 / 上次失败 + 原因),并各自带一个启停开关——某个端点临时不可用就单独关掉它,不用关掉整类事件;
  131. - **签名**:自定义目标填了签名密钥时,请求带 `X-DSH-Notify-Signature`(对请求体做 HMAC-SHA256,`sha256=<hex>`);飞书填了签名密钥时按官方算法在请求体里带 `timestamp` / `sign`;
  132. - **消息模板**(可选):飞书 / Server酱 / WxPusher / 自定义目标可填模板,占位符 `{{title}}` `{{body}}` `{{event}}` `{{time}}` `{{session}}`,留空默认是「标题 + 换行 + 正文」;
  133. - **钉钉不在支持列表里**:钉钉群机器人接口不返回任何 CORS 头,且只接受 `application/json`——浏览器页面既读不到响应,也无法发出符合要求的请求(no-cors 下 Content-Type 会被限制成 safelisted 类型)。要用钉钉,请在自己能控制的机器上搭一个中转,再把「自定义 Webhook」指向它。
  134. </details>
  135. #### 运行环境与诊断
  136. 在「高级设置」最后一块。默认自动识别当前是 Web 端还是桌面端(DSH Desktop,`dsh-app://`);识别不准时可手动指定——Windows 桌面点通知走宿主路由做原生抬窗、macOS / Linux 走 `dsh://open` 深链(见[桌面端怎么抬窗的](#桌面端怎么抬窗的));抬窗通道本身不带快捷裁决按钮——按钮来自 Web 的 Service Worker 桥,或 Windows 11 桌面端的宿主原生 Toast。手动覆盖与自动识别不一致时,设置页会明示检测结果。
  137. <details>
  138. <summary>通知语言、桌面端抬窗与恢复默认</summary>
  139. - **通知语言**:跟随界面 / 简体中文 / English——决定通知文字与 `🔔 …` 标题标记使用的语言;
  140. - **桌面端抬窗**:Windows 走宿主路由做原生激活、macOS / Linux 走 `dsh://open` 深链;最小化、被别的窗口盖住的窗口在 Windows 与 Linux 上都实测能抬回来,Windows 上 `SW_HIDE` 到托盘的窗口也会先 `SW_SHOW` 再抬(1.21.0 起,见[桌面端怎么抬窗的](#桌面端怎么抬窗的));
  141. - **恢复默认设置**:把所有开关与音效设置还原成出厂值(不动外部推送目标和已选的自定义音频文件)。
  142. </details>
  143. ## 页面关闭后:宿主侧兜底与同源中继
  144. 这两块能力住在宿主进程里(`lib/host-fallback.js`、`lib/relay.js`,都是包内的可选模块),默认关:没有配置时宿主只注册抬窗那一条路由,升级前后行为一致。它们的配置写在 profile 的 patch 层,不在设置页里——它们让宿主替页面干活,不是浏览器偏好;设置页只如实显示探测到的状态。
  145. <details>
  146. <summary>宿主侧兜底:页面关闭后由宿主接着推</summary>
  147. 页面不在时页面半体不运行,提醒就断在这里。宿主侧兜底订阅宿主的会话事件流(`session/event`),在页面关闭后自己把同样两条提醒发到你配置的网关。它跟页面共用同一组开关:心跳把 `external: {enabled, attention, done}` 报给宿主,页面里「转发外部通知」总开关关掉(或只关掉「需要你」/「回复完成」其中一类)时,兜底也照同样规则闭嘴——否则关掉总开关、再关掉标签页,最后那条外部通知还是会到。
  148. profile 覆盖示例(`~/.dsh/profiles/<profile>/cordis.patch.yml`)。**`config` 是整块替换、不是深合并**:patch 里写同一个 `id` 就把整个 `config` 赋过去,所以示例把三块都写全——漏写的键会回落到插件内的默认值(与随包 YAML 是同一份),但被一起冲掉的 `gateway.target` 不会自己回来。
  149. ```yaml
  150. - id: notify-me
  151. config:
  152. allowedOrigins: [] # 顶层:页面入口白名单,留空 = 只接受回环 / 绑定地址(三条宿主入口共用)
  153. gateway:
  154. target: '' # 例:https://cue.example/notify/<key>
  155. credentialsFile: '' # 0600 JSON,见下
  156. headers: {} # 额外请求头,可选
  157. hostFallback:
  158. enabled: true
  159. target: '' # 留空 = 用 gateway.target
  160. credentialsFile: '' # 留空 = 用 gateway.credentialsFile
  161. events: ['turn/end', 'approval/asked']
  162. includeSubagents: false
  163. turnEndThrottleMs: 15000
  164. titlePrefix: 'DSH'
  165. language: 'auto' # auto | zh | en
  166. pageLeaseMs: 60000 # 0 = 不与页面协调(页面开着也会重复)
  167. healthPath: '/__dsh-notify-me/host-fallback'
  168. relay:
  169. enabled: false
  170. path: ''
  171. target: ''
  172. credentialsFile: ''
  173. bodyTemplate: '' # 可选:JSON 请求体模板,见「同源中继」
  174. ```
  175. 逐键说明(括号内是默认值):
  176. - `enabled`(`false`):关着时宿主不订阅任何事件,也不注册健康探针;
  177. - `target` / `credentialsFile`(空):留空回落到 `gateway.*`;两处都空等于没地方可推,模块干脆不挂载,只在宿主日志里留一行 warning——比每次投递都失败好查;
  178. - `events`(`['turn/end', 'approval/asked']`):要推的事件,只列一种就只有那一种;
  179. - `includeSubagents`(`false`):`origin === 'subagent'` 的会话默认跳过,理由与页面侧一致——它们是主对话一轮里的步骤;
  180. - `turnEndThrottleMs`(`15000`):同一会话的「回复完成」在这个窗口内只推一条;窗口只在真发出去时才消耗,被租约挡掉的那次不算。节流只管 `completed`——`aborted` / `error` / `max-tokens` 这些收尾不节流,它们本来就少,而且往往是此刻最该看到的那一条;
  181. - **文案与页面通知逐字一致**:标题是 `<前缀> · 回复完成` / `<前缀> · 审批请求`,正文「回复完成」只有会话名、「审批请求」是 `会话名:工具名 · 原因`——不含任何用户消息正文(用户消息里常带注入的 `<system-reminder>`、记忆上下文与时间戳,复制进通知就没法读了);非正常收尾(`aborted` / `error` / `max-tokens`…)会在正文尾部附一个短后缀,如 `(error)`;
  182. - `titlePrefix`(`DSH`):标题是 `<前缀> · 审批请求` / `<前缀> · 回复完成`(与页面通知同一套标签);
  183. - `language`(`auto`):`auto` 用页面最近一次心跳报的语言,没有心跳才回落到中文;`zh` / `en` 强制;
  184. - `pageLeaseMs`(`60000`):页面在线租约,见下面「去重」;
  185. - `healthPath`(`/__dsh-notify-me/host-fallback`):只读健康探针的路径。
  186. **凭据文件**:宿主用户可读的 0600 JSON,内容是 `{"user": "...", "password": "..."}`(按 HTTP Basic 发)或 `{"authorization": "Bearer ..."}`(原样发;裸 token 会自动补上 `Bearer `)。它不能写进 patch 层——那一层世界可读、还会进 profile 目录。不填这个键时请求不带认证头:很多 webhook 端点本来就不要认证,把「没配凭据」当成错误会让每个提醒都失败;只有「配了路径却读不出来」才算凭据不可用。网关回 401 / 403 时宿主丢掉缓存的凭据、重读文件、只重试一次,所以轮换密码不需要重启宿主。
  187. **去重靠一条页面在线租约**:页面加载后 `GET /__dsh-notify-me/host-bridge` 探测一次(之后每 60 秒复探,页面隐藏时不探、回到可见补探一次),只有回包 `hostFallback.enabled === true` 才开始心跳——body 是 `{alive, language, muted, external}`(`muted` 是被静音会话的 id 列表,`external` 是 `{enabled, attention, done}` 三个转发开关),间隔取 `leaseMs/3`、夹在 5–20 秒;改静音列表或任一转发开关时不等间隔,立刻补一次心跳;`pagehide` 时发一条 `{alive:false, language, external}`(带 `keepalive`)立刻释放。宿主侧租约新鲜就不补推(页面自己在推),租约过期或收到 `alive:false` 才接手,最多等 `pageLeaseMs` 这么久。心跳带语言、静音列表与转发开关:前三样都是用户亲手写进配置的确定状态,宿主照它们执行就是页面自己的意思——静音列表决定哪些会话闭嘴,`external.enabled: false`(设置页「转发外部通知」关掉)则连宿主兜底一起停,否则关掉总开关、再关掉标签页,宿主照样把刚被关掉的那条外部通知推出去;`attention` / `done` 分别管「需要你」「回复完成」两类。仍然不带的是页面的可见性与闲置判定:那是宿主看不见的启发式,只照做一半会得到谁也算不清的规则。语言带过来是为了英文页面不收中文宿主提醒,`language: 'auto'` 时生效。`external` 只有三个字段全是布尔才被采纳,缺字段或类型不对保留上一次答案;页面从没报过(宿主刚起、页面还没开)时兜底照旧按 `hostFallback.enabled` 推。列表在心跳里按字节截断(预算 8 KiB、最多 200 条):被截掉的会话仍在本页静音,只是不由兜底接管。`pageLeaseMs: 0` 关掉协调,宿主永远推——页面开着时会收到两份,只在调试时用。
  188. **两个路由的契约**:页面探测的那条 `GET /__dsh-notify-me/host-bridge` 回 `{ok, version, features, hostFallback:{enabled, leaseMs}, relay:{enabled, path, upstreamHost, upstreamPath}, language, page:{alive, ageMs}}`(`upstreamHost` / `upstreamPath` 是宿主替你转发时的网关主机名与路径,只在中继启用时给出,凭据永不下发);它只在 `hostFallback.enabled` 或 `relay.enabled` 为真时注册,默认安装下是 404,页面按「未启用」处理而不是当故障。心跳 `POST` 要求意图头 `x-dsh-notify-me-page: bridge`(缺了回 `403`),坏 JSON 回 `400`,body 超 16 KiB 回 `413`,成功回 `200 {ok, leaseUntil}`。
  189. **健康探针**:`GET <healthPath>` 回 `{ok, version, enabled, events, includeSubagents, pageAlive, lastDelivery: {at, ok, status} | null}`,非 GET / HEAD 回 `405`。它和其它宿主入口共用同一道闸门:对端必须是本机(回环或监听器自己绑定的那个地址),`Host` 必须是回环名 / 绑定地址 / `allowedOrigins` 派生的公网域名,不符回 `403` 并带 `reason`(`bad-remote` / `bad-host` / `cross-origin`)。探针不收凭据、不转发,用它在终端确认「这个宿主进程到底有没有在推、上一次投递是什么结果」。
  190. **走隧道或反代时必须配 `allowedOrigins`**:那种部署下发往宿主的 `Host` 是公网域名而不是回环地址,而 `allowedOrigins` 既是 `Origin` 白名单,也是可接受的 `Host` 来源。不写它,页面的心跳会被闸门判 `bad-host`(设置页那行显示「宿主未响应」,下方直接提示去顶层 `allowedOrigins` 补本页来源),宿主于是把开着页面的提醒也补推一遍——正是租约要避免的那种重复。
  191. </details>
  192. <details>
  193. <summary>同源中继:让页面够到要认证的网关</summary>
  194. 页面用自己的 `fetch` 往外部目标推,碰上要 Basic 认证的网关就是死路,三条 CORS 事实各堵一次:
  195. 1. 把凭据写进 URL(`https://user:pass@host/…`):`fetch` 直接抛错,请求根本没发出去;
  196. 2. 加 `Authorization` 头:请求变成预检,而 Apprise 这类网关不回任何 `Access-Control-Allow-*`,预检失败;
  197. 3. 退到 `no-cors`:带不了自定义头,等于没有认证。
  198. 于是页面只能报「已送出不可确认」。同源中继把这一段搬到宿主:页面 POST 到与自己同源的路由,宿主补上凭据再打网关,然后把网关的真实状态回给页面。
  199. 启用需要 `relay.enabled: true`、`relay.path`(必须是绝对路径)、`relay.target`(留空回落到 `gateway.target`)和 `relay.credentialsFile`(留空回落到 `gateway.credentialsFile`)。路径本身就是能力——知道它就能让宿主替你发一条通知,价值等同口令,所以建议带一段随机 token:`/__dsh-notify-me/relay/<32 hex token>`。
  200. `relay.bodyTemplate`(可选)给不接受 Apprise `{title, body, type}` 形状的网关用:写一段 JSON 模板,宿主按模板渲染请求体。占位符是 `{{title}}` `{{body}}` `{{text}}` `{{event}}` `{{time}}` `{{session}}`(取载荷里的 `sessionId`)`{{source}}` `{{version}}`,要写在 JSON 字符串里;代入的值先按 JSON 字符串转义,所以标题里的引号、换行不会把模板弄坏,载荷里没有的字段渲染成空串,模板里没写的字段不会出现在请求体里。
  201. 模板在宿主启动时就校验:渲染结果不是 JSON 对象、或模板超过 16 KiB(按 UTF-8 字节算),整条中继不挂载,日志里留一行 warning 写明原因,状态回包与设置页也显示中继未启用——配错一次就能看见,不用等每条提醒都回 500。渲染后的请求体另有 256 KiB 上限(模板可以重复占位符放大体积),超了回 `500 {reason:'rendered-body-too-large'}` 且不发送。不写这个键时保持原来的 `{title, body, type:'info'}` 不变。
  202. 例:把提醒推给自己的推送服务(下面以 MagicPush 风格接口为例,它要求 `channel_ids` + `title` + `content`,Bearer 令牌放在宿主的 0600 凭据文件里):
  203. ```yaml
  204. - id: notify-me
  205. config:
  206. relay:
  207. enabled: true
  208. path: '/__dsh-notify-me/relay/<32 hex token>'
  209. target: 'https://push.example.com/api/v1/notifications/send'
  210. credentialsFile: '/absolute/path/push-credentials.json' # {"authorization":"Bearer fn_push_..."}
  211. bodyTemplate: '{"channel_ids":["<channel-id>"],"title":"{{title}}","content":"{{text}}"}'
  212. ```
  213. YAML 的单引号里模板原样保留;页面设置里把「自定义 Webhook」的地址填成同一个 `target`,请求会自动折叠到中继路由,凭据仍只留在宿主。
  214. 用法:**设置 → 通知提醒 → 高级设置 → 外部推送** 里多出两行只读状态,「同源中继」一行显示 `已启用 · 地址:<origin><relay.path>`;把那个绝对地址填进同页「自定义 Webhook」目标的地址即可,页面不必知道凭据。
  215. 不想改地址也行:**「自定义 Webhook」目标里如果填的是中继上游网关本身的地址,发送时会自动折叠到中继路由**。这类地址在浏览器里注定失败(上面三条 CORS 事实各堵一次,其中 `no-cors` 兜底还会被 Apprise 当成跨站请求直接 `403 Cross-site request rejected`),旧版把它记成 `unverified`——设置页显示「上次已送出(不可确认)」、测试按钮报「已送出不可确认」,**而手机一声不响**。折叠之后请求走同源、凭据由宿主补,回执就是网关的真实状态。折叠要同时满足:目标类型是「自定义」、URL 主机名等于 `relay.upstreamHost`、路径也等于 `relay.upstreamPath`、目标没配签名密钥(签名在页面算,中继带不过去)、且目标不是本页同源。主机名或路径有一项对不上就原样直发(一个网关常按路径分多个 notify key,只比主机名会把 A key 的提醒发到 B key 去),设置页会在会被折叠的目标下写一行说明。
  216. 走隧道 / 反代时中继要和桥接路由过同一道 `Host` 闸门:把页面的公网来源写进顶层 `allowedOrigins`,否则探针与 `POST` 都会被判 `bad-host`。
  217. 回包口径(页面据此把「已送出不可确认」变成可核对的状态):
  218. - `GET` / `HEAD` `<relay.path>` → `200 {ok, route, version, enabled}`:只读探针,不转发、不带凭据,但**和其它宿主入口走同一道闸门**——路径本身就是能力,不设闸门的探针会把「猜对了」告诉猜的人;拿它确认「这个进程挂的是不是我配的那条路径」;
  219. - `POST` → 读 body(上限 64 KiB)、要求是 JSON 对象,映射成网关的 `{title, body, type:'info'}`(配了 `relay.bodyTemplate` 时改为按模板渲染出的 JSON 对象;页面载荷里的 `tag` 一律不透传:Apprise 把 tag 当服务过滤,不匹配会回 424),附上 `gateway.headers` 与凭据;请求必须带 `x-dsh-notify-me-relay: relay` 意图头,缺了回 `403 {reason:'missing-intent'}`——跨站表单发不出自定义头,要发就得多一次预检,而预检在网关这里必然失败;
  220. - `200 {ok, upstreamStatus, upstreamBody}`(`upstreamBody` 最多 500 字符)=转发成功;上游非 2xx 回 `502`,同为这一形状;
  221. - `500 {reason}`:模板配错(`invalid-body-template` / `template-too-large` / `rendered-body-too-large`)——前两种正常在宿主启动校验时就拦下了,这里只是运行期的兜底,且什么都不发;
  222. - `400`(坏 JSON 或空 body)、`413`(body 超限)、`405`(方法不对)、`403`(闸门拒绝或缺少意图头)、`503`(配了凭据文件但读不出来)、`502 {reason:'upstream-error'}`(上游异常或网关回了 3xx——跳转不跟,因为跟过去会把 body 和 `Authorization` 重放到别处)。
  223. 凭据只在宿主:页面拿不到它,它也不会回显在响应或日志里。`POST` 走与其它宿主入口同一道闸门,所以跨站页面或 DNS rebinding 的伪造来源即使猜到路径也会被拒。
  224. </details>
  225. ## 提醒渠道
  226. | 渠道 | 表现 |
  227. | --- | --- |
  228. | 系统通知 | 经浏览器进 Windows / macOS / Linux 的系统通知中心,点击回到对应对话;macOS 桌面端由宿主拉起 `DSH Notify.app` 发(见 [macOS 桌面端怎么发系统通知](#macos-桌面端怎么发系统通知));Windows 11 桌面端的审批提醒由宿主发原生 Toast,带「同意 / 拒绝」按钮(见 [Windows 桌面端怎么发带按钮的通知](#windows-桌面端怎么发带按钮的通知));Web 端可带「同意 / 拒绝」 |
  229. | 提示音 | 默认 WebAudio 合成音,「需要你」与「完成」音型不同;可换自定义音频,或交给系统通知音 |
  230. | 标签页标题 | `🔔 需要你 · …` / `✅ 回复完成 · …`(随通知语言切换),打开对应会话即消失;两种标记可同时出现 |
  231. | 外部推送(可选,默认关) | 把同一条提醒转发到 Discord / Bark / Gotify / 飞书 / Server酱 / WxPusher / 自定义 Webhook |
  232. | 宿主侧兜底(可选,默认关) | 页面关闭后由宿主进程继续把「需要你操作」「回复完成」推到你的网关;要 profile 配置与 0600 凭据文件 |
  233. | 同源中继(可选,默认关) | 页面 POST 到宿主同源路由,由宿主补凭据转发给要认证的网关,并回传网关真实状态码 |
  234. 本插件以**浏览器层**为主:本地通知、提示音、标题标记仍只在页面开着时工作(最小化 / 后台即可——那正是它监听的「离开」状态);开启宿主侧兜底后,外部推送在页面关闭后由宿主进程接着发。
  235. ## 兼容性
  236. 已逐版实测在 `0.1.1-rc.2` 到 `0.2.2-rc.3` 上真正激活,含 npm `next` 渠道的 `0.2.2-rc.3`(判定标准:插件条目进启动页 `__DSH_BOOT__`、注入依赖解析通过、`/plugins/??dsh-notify-me/client.js` 返回含新代码的构建、设置里出现「通知提醒」分区)。`0.2.2-rc.3` 这版在隔离宿主里除了上述四条,还实测了设置分区渲染与「启用提醒」开关往返、四条宿主路由的挂载,宿主日志零告警;桌面端另有 [#41](https://github.com/chromoany/dsh-notify-me/issues/41) 的报告人在同一版本上验过原生 Toast 与抬窗(1.21.3 只加了 Windows 10 的 build 判定,没有碰宿主 API)。逐版适配记录、宿主代际的形状差异与两个会静默失效的坑,见 **[docs/compatibility.md](docs/compatibility.md)**。
  237. ## 控制台高级配置
  238. 设置页是第一入口。想脚本化批量改、恢复默认,或查外部通知目标的字段,见 **[docs/console-config.md](docs/console-config.md)**——完整的配置键、`decide()` / `testExternal()` 接口、外部通知测试的开关边界,以及自定义音效和 `debug().hostBridge` 的读法都在那里。
  239. ## 工作原理
  240. 提醒核心监听会话状态与待处理交互;审批裁决由页面侧完成,Windows 桌面抬窗走宿主路由加 Win32 原生激活、macOS / Linux 走 `dsh://open` 深链。
  241. <details>
  242. <summary>展开事件来源与降级说明</summary>
  243. 提醒核心按宿主代际取源(对照表见 [docs/compatibility.md](docs/compatibility.md)),当前会话一律来自客户端 `sessions` 服务:
  244. - **当前会话** `SessionSnapshot`:`running` true→false = 回复完成;
  245. - **待办交互**:`uiSession` 的 `sessionStatus`(`≥ 0.1.6`,逐会话 `pendingInteraction`)或 `pendingInteractions`(`0.1.2 .. 0.1.5`)出现新 key = 模型在等你,容器里带上审批工具名 / 理由、提问文本;旧宿主回落到控制器快照的 `pending[]`;
  246. - **其它已列会话**摘要:`running` true→false(或旧宿主的 `completed` 边沿)= 后台工作提醒。宿主的「完成未读」级别标志负责补漏与标题标记:`≥ 0.1.6` 用 `sessionStatus` 行的 `completionUnread`(后台会话完成即点亮、打开该会话/再次开跑/会话消失即清零),旧宿主用列表行的 `completed` 提醒位(选中会话即清零);页面没看见的完成边沿(插件热重载中途、快照合并跳变)由此补报一次,边沿与级别标志同来时按短时间窗合并,只响一声。
  247. - **子代理会话**:列表行带 `origin: 'subagent'`(并有 `parentId`)的**后台**会话默认静音;你正打开着的那个子代理会话不算静音对象,它的提醒走当前对话的常规规则(页面可见时默认只留标题标记、转后台补发),切进来时积压的等待同样补上,切走后重新静音。只有 `parentId`、没有 `origin` 的分支(fork)会话属于你自己的对话,始终照常提醒。
  248. 提醒核心仍然零第三方运行时依赖、完全自包含:通知文字按所选语言(跟随界面 / 中文 / English)即时解析。设置页是**可选**的 React 呈现层——当 DSH web profile 提供 `slots` / `locale` / `react` 时才注册进「设置 → 通知提醒」,缺任一能力时插件自动降级为纯提醒(无设置页),不影响功能。
  249. </details>
  250. ### 快捷裁决怎么走通的
  251. Web 端带「同意 / 拒绝」按钮的通知只能由 Service Worker 弹出(往 `new Notification()` 里传 `actions` 会直接抛 `TypeError`),所以 bundle 的同一份文件再注册成一个只干转信的 worker,把「点了哪个按钮」带回页面;Windows 11 桌面端改由宿主发原生 Toast,按钮同样是「同意 / 拒绝」。**裁决仍在页面里发生**,调的是审批面板里「允许一次 / 拒绝」用的同一个 `PendingApproval.answer('allowed-once' | 'rejected')`——「同意」就是「允许一次」,不多放行任何东西。
  252. <details>
  253. <summary>展开按钮通知的记账与调窗口</summary>
  254. 每条按钮通知按交互 key 记账,一次只认领一条等待;请求被页面里答掉、或被新请求顶替之后,残留通知上的按钮再点也不会误裁,只是安静地关掉。Web 端带按钮的通知不设自动撤回,等你点按钮或把请求答掉才消失;普通通知 5 秒自收,macOS 桌面端没有按钮的审批通知与 Windows 11 桌面端带按钮的原生审批 Toast 都 12 秒自收。「通知自动消失」选「从不关闭」时,这两类都不因到点而收;三种设置都只管定时器那一次关闭,你回到页面时残留的通知一律收起(「回到页面也保留提醒」打开时不收起)。没来得及点就回页面里裁决,对话里的审批一直等着你。
  255. 点正文的「调窗口 + 切对话」也归 worker 这半侧调度:`client.focus()` 只调起一个窗口(优先当前可见的),也只让那个窗口切对话——多个 DSH 标签页不会互相抢焦点或一起乱切。
  256. </details>
  257. ### 桌面端怎么抬窗的
  258. DSH Desktop 是一层 Electron 壳,页面跑在 `dsh-app://app` 下:DOM 的 `window.focus()` 只动浏览器窗口对象、碰不到原生窗口,壳的 `will-navigate` 又把页面里发 `dsh:` 的常规出口堵上了。插件按平台走两条通道:Windows 走插件自己的宿主路由——页面 POST `/__dsh-notify-me/focus-window`,宿主起 `powershell.exe` 跑 `lib/focus-window.ps1`,由它枚举原生窗口、自适应激活;macOS / Linux 走壳自己的 `dsh://open` 深链——页面在点击手势里插一个隐藏 iframe 导航 `dsh://open`(子框架导航不经过壳的顶层 `will-navigate` 拦截),交给系统协议注册,壳的 `second-instance` / `open-url` 处理器据此 restore + show + focus 主窗口。Windows 上这条深链在 `0.2.1-rc.2` 复测 3/3 无效,1.14.0 起改走宿主路由;Linux(Plasma 6.8 / Wayland)已实测能把最小化或后台的窗口抬回前台,macOS 未实测。
  259. <details>
  260. <summary>展开路由、激活顺序、实测数据与安全闸门</summary>
  261. Windows 的宿主路由:壳把 `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 的顶层窗口(可见的优先;被 `SW_HIDE` 藏到托盘的 DSH 主窗也保留,优先于同进程的可见辅助窗口,选中后先 `ShowWindow(SW_SHOW)`)→ 自适应激活 → 比对 `GetForegroundWindow()` 打印 `FOCUSED=1|0` → 宿主回 `200` / `202`。
  262. Windows 的激活顺序是实的:已经在前台就什么都不做(最常见的情况,零闪烁);最小化了先 `SW_RESTORE`;然后合成一次 ALT 按键(`keybd_event` 按下抬起)给本线程前台权限,再 `SetForegroundWindow`;全程都被前台锁拒掉时,最后做一次**不抢焦点的置顶脉冲**——`SetWindowPos(HWND_TOPMOST)` 亮 120 ms 再落回 `HWND_NOTOPMOST`,窗口停在普通层的最上面、键鼠焦点原地不动(1.21.4 起)。不再用 `SW_MINIMIZE` + `SW_RESTORE` 兜底:那一对只把窗口「显示」出来,Windows 按它记住的位置放回——被压在底下时还是底下——所以每次重试都更低([#42](https://github.com/chromoany/dsh-notify-me/issues/42))。单独调 `SetForegroundWindow` 会被前台锁直接拒,按调用算、跟 `ForegroundLockTimeout` 无关;这也重新解释了 1.5.2 那套深链「时灵时不灵」——能抬起来的那些次,多半是系统在通知被点击时自己激活了应用。
  263. 实测(`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`。
  264. 置顶脉冲另做了一轮跨进程实测(Windows 11 26200,目标窗口属于另一个进程、被最大化窗口整个盖住):直接对目标窗 `SetWindowPos(HWND_TOP, SWP_NOACTIVATE)` 返回 `True` 但 z-order 一点没动,`BringWindowToTop` 同样无效——跨进程的普通层抬窗会被忽略;换成 `HWND_TOPMOST` 立刻到第 0 位,120 ms 后 `HWND_NOTOPMOST` 仍留在第 0 位,前台窗口始终没变。这也是兜底只能走置顶脉冲、不能只写一句 `HWND_TOP` 的原因。
  265. 安全上只开一条 exact 路由。词表之外的请求一律拒:非 GET / HEAD / POST 回 `405`(包括预检的 `OPTIONS`,且从不回任何 CORS 头),非 Windows 宿主(Web 版、macOS / Linux、纯 Node)回 `501`(macOS / Linux 走深链,不经过这条路由),缺 `x-dsh-notify-me-focus: focus` 头回 `403`。
  266. 那个头只是「这是页面发来的」标记,不是防线——DNS rebinding 的恶意页对目标地址而言是同源的,能带任意自定义头、也不触发预检。真正的闸门是三层:对端地址必须是 loopback,或恰好是监听器自己绑定的那个 IP;`Host` 必须是 loopback 名(`127.0.0.1` / `localhost` / `[::1]`,可带端口)或同一个绑定地址,因为壳转发时 `host` 已被删掉、由 fetch 按它拨号的 URL 重填,而 rebinding 的页面 Host 仍是攻击者域名;带了 `Origin` 就必须和 `Host` 同源。任一条不符回 `403`,`reason` 分别是 `bad-remote` / `bad-host` / `cross-origin`。`GET` 只回 `{ok, route, enabled, desktop, platform}`,装完可以先用浏览器打开确认路由在不在。400 毫秒内的重复调用合并成一次,脚本超过 8 秒没回话就 kill 掉按失败处理。
  267. 这六条宿主路由(focus、macOS 通知、Windows Toast、页面桥接、host-fallback 健康探针、同源中继)现在还共用一层 DSH 准入:宿主若提供 `connection` 服务,handler 会先调 `connection.requestRejection(req)`——DSH 自己的路由也走这里,包含 Host / Origin 围栏和浏览器登录态校验;它返回 401 / 403 就原样转发(`reason` 为 `unauthenticated` / `untrusted`),通过后才轮到上面这套插件自己的闸门。宿主没有这个服务(旧版 DSH、纯 Node、离线测试)时跳过前者、退回插件闸门,行为与之前相同。这一层收在 `lib/page-bridge.js` 的 `guardRequest()` 里。
  268. 抬不起来的几种场合与[已知限制](#已知限制)里列的一致(提权窗口、另一虚拟桌面、前台被反复抢走),一律如实回 `202`、对话照常切。`SW_HIDE` 到托盘的隐藏主窗原来直接回 `202`,1.21.0 起先 `SW_SHOW` 再走同一套激活步骤([#40](https://github.com/chromoany/dsh-notify-me/issues/40))。
  269. </details>
  270. ### macOS 桌面端怎么发系统通知
  271. 页面里的 `new Notification()` 在 macOS 的 DSH Desktop(`dsh-app://app`)上进不了通知中心——不弹,也不报错(`Notification.permission` 照样是 `granted`)。插件在这一平台上改走宿主:页面 POST `/__dsh-notify-me/mac-notify`,宿主(`lib/mac-notify.js`)拉起 `macos/` 下的小助手 `DSH Notify.app`,由它用 `UNUserNotificationCenter` 发一条真正的系统通知。
  272. - **一次性准备**:`bash macos/build.sh` 编译出 `macos/DSH Notify.app`(需要 Xcode Command Line Tools,几秒钟)。产物在 `.gitignore` 里,不进仓库也不进 npm 包。首次弹通知时在「系统设置 → 通知 → DSH Notify」里允许。
  273. - **走哪条路是自动的**:宿主只在「macOS + 桌面壳(Electron 二进制)+ 助手已编译」三个条件都满足时注册这条路由;任一不满足,`GET` 探测报 `enabled: false`,页面继续用自己原来的通知,行为与改动前一致。`dsh web`(浏览器)永远走不到这条路由。
  274. - **点通知回到对应对话**:小助手把会话 id 写进临时目录的 `dsh-notify-me-click.json` 并打开 `dsh://open` 抬窗;页面重新获得焦点时 `GET` 一次取走这个 id、切到对应对话,取走后即清掉,不会重复跳转。DSH 本来就处于前台时 `dsh://open` 不产生新的激活,页面收不到 `focus`,所以通知挂出后、页面在前台时还会每秒探测一次宿主(最多 120 秒),点击后 1 秒内完成切换,读到点击即停;窗口不在前台时不轮询。`autoFocus` 关掉时只抬窗不切会话。
  275. - **提示音**:设置里选「系统通知音」时交给 macOS,其余音效模式仍由页面自己合成,不会两声叠在一起。
  276. - **通知上仍然没有「同意 / 拒绝」按钮**:macOS 的通知动作要求注册通知类别,助手不碰审批状态,裁决仍在对话里做。
  277. - **关掉它**:在 profile 的 patch 层给 `notify-me` 加 `macNotify: { enabled: false }`;或删掉 `macos/DSH Notify.app`,路由会退回 `enabled: false`。
  278. 与抬窗路由一样,这条路由只开一个 exact 路径,其余一律拒:非 GET / POST 回 `405`(含从不回 CORS 头的预检 `OPTIONS`),非 loopback 或未放行的 `Host` / `Origin` 回 `403`,POST 缺 `x-dsh-notify-me-mac: notify` 头回 `403`,助手不存在回 `501`,请求体不是合法通知回 `400`。响应里不含系统信息,只回报助手的退出状态。
  279. ### Windows 桌面端怎么发带按钮的通知
  280. 页面里的 `new Notification()` 在 Windows 桌面端不会被拒,但它带不了按钮:Electron 的渲染进程收到通知请求后只把 title / body / tag / icon / silent 抄给平台,`actions` 数组整个丢掉(`shell/browser/notifications/platform_notification_service.cc` 的 `DisplayNotification()`);`dsh-app://` 页面又注册不了 Service Worker,而按钮通知只有 Service Worker 才画得出来。于是插件把审批提醒改由宿主发原生 Toast。**Windows 10 是例外**:那边的系统通知派发不了协议激活,1.21.3 起不再走这条通道,审批提醒留在页面或浮层里(原因见下)。
  281. - **谁去弹**:宿主半(`lib/index.js`)注册 `POST /__dsh-notify-me/win-toast`,由它起一次 `powershell.exe` 跑 `lib/win-toast.ps1`,用 WinRT `ToastNotificationManager` 把通知发到插件自己的 AUMID `dsh-notify-me` 下,走同一套系统通知设置。**不能借 DSH 的 AUMID**:那个 AUMID 挂着 COM Toast 激活器,Windows 会把每次点击都交给 DSH 本体,Toast 上的协议按钮永远等不到派发([#41](https://github.com/chromoany/dsh-notify-me/issues/41),1.21.2 修)。
  282. - **按钮怎么裁决**:Toast 的两个按钮是 `activationType="protocol"`,分别指向 `dsh-notify-me://approve?token=…` / reject。点按钮后系统调起注册在这个协议下的处理器(一个写入动作文件、再打开 `dsh://open` 的 VBS),宿主在页面下一次探针时把动作交回页面;页面仍走审批面板里同一个 `decidePending()`——「同意」就是「允许一次」,不多放行任何东西。这条链路要求 Toast 挂在自己的 AUMID 下,否则点击会被别的应用的激活器截走。
  283. - **点正文也会抬窗**:正文点击统一走 `dsh-notify-me://open`(有会话时带 `?session=`,没有会话也保留为一次纯抬窗),不再把 `dsh://open` 当 Windows 抬窗手段——那条深链拉不起最小化窗口,更拉不起 `SW_HIDE` 到托盘的窗口。等待审批期间页面每 1.5 秒取一次动作,取到 `open` 先 POST 宿主 focus 路由抬窗、再切会话;托盘隐藏的窗口由 `focus-window.ps1` 先 `SW_SHOW` 再激活([#40](https://github.com/chromoany/dsh-notify-me/issues/40))。
  284. - **中文用户名等非 ASCII profile**:处理器脚本按 UTF-16LE + BOM 写盘,动作目录在点击时才用 `sh.ExpandEnvironmentStrings("%LOCALAPPDATA%")` 解析——脚本正文因此全是 ASCII,不会再被 WSH 按系统 ANSI 代码页解码后把路径弄乱(此前每次点按钮都弹 `800A004C` 脚本错误,[#36](https://github.com/chromoany/dsh-notify-me/issues/36)),1.20.1 起修复。升级后重启桌面端即可,第一次发带按钮的 Toast 时会重写这份脚本,不用手动清旧文件。
  285. - **注册**:第一次发 Toast 前写 `HKCU\Software\Classes\AppUserModelId\dsh-notify-me`(`DisplayName` = 通知抬头,`CustomActivator` = 一个 CLSID),CLSID 只建空的存根、不注册 `LocalServer32`——未打包应用不实现 COM 激活器时,Windows 才会按 XML 把 `activationType="protocol"` 的点击派发出去;随后按 tag 记账到 `ToastNotificationManager.History`。两者都是当前用户级,不需要管理员权限。token 单次、3 分钟有效;动作文件被取走后即删。
  286. - **Windows 10 没有按钮**:Windows 10(build < 22000)缺 Windows 11 那条「没有 COM 激活器也照 XML 派发协议激活」的实现——修复只落在 18967 之后的预览分支,没进 19041 / 19045 的服务分支([microsoft-ui-xaml#1939](https://github.com/microsoft/microsoft-ui-xaml/issues/1939))。19045 上实测:自带 AUMID + 空存根 + 开始菜单快捷方式都补齐,点按钮、点正文仍然只把通知收掉([#41](https://github.com/chromoany/dsh-notify-me/issues/41))。所以 1.21.3 起在 build < 22000 上不发原生 Toast:路由回 `enabled: false`、`reason: "windows-10"`,审批提醒回到页面自己的通知与浮层——宁可没有按钮,也不给一个按下去没反应的。
  287. - **不弹的场合**:非 Windows 桌面宿主、`winToast.enabled: false`、`powershell.exe` 不存在(`reason` 分别是 `disabled` / `helper-missing`),或 Windows 10(见上一条),路由报 `enabled: false`(`501`),页面继续用自己那条不带按钮的通知,行为与改动前一致。
  288. - **关掉它**:在 profile 的 patch 层给 `notify-me` 加 `winToast: { enabled: false }`,审批提醒回到页面自己的通知(无按钮)。
  289. - **自动消失与收起**:原生 Toast 归 `trackToast()` 记账,普通通知 5 秒、带按钮的审批 12 秒(「总是关闭 / 从不关闭」照旧),回到页面(`keepOnReturn` 关闭时)同样收起。
  290. 路由只开一个 exact 路径,其余一律拒:非 GET / POST 回 `405`,非 loopback 或未放行的 `Host` / `Origin` 回 `403`,POST 缺 `x-dsh-notify-me-win: toast` 头回 `403`,请求体不合法回 `400`。响应只回报投递状态,不含系统信息。
  291. ## 已知限制
  292. **运行前提**
  293. - 默认只在页面开着时提醒(后台标签 / 最小化可以,关标签页即失效——浏览器层方案固有限制)。开启宿主侧兜底后,页面关闭仍能收到**外部推送**:它要 profile 里 `hostFallback.enabled: true`、`gateway.target`(或 `hostFallback.target`)与一个 0600 凭据文件,而且宿主进程自己在跑。
  294. - 通知经由浏览器弹出,需允许浏览器通知权限;每次页面加载后第一次出声 / 弹通知前要先在页面上点过一下;未授权时只剩提示音与标题标记。
  295. - 系统通知横幅只画在主屏:Windows 没有设置项、Chromium 没有 API 能把它指到别的显示器(多屏时副屏收不到)。要跨屏只能靠外部推送转到手机(1.12.0 起页面里不再画审批卡片)。
  296. - 配置存在浏览器 `localStorage`:换浏览器 / 设备或清除站点数据后回到默认值(设置页可一键恢复默认)。
  297. **平台差异**
  298. - 快捷裁决按钮要 Service Worker:`http://127.0.0.1`、`https` 可用,`http://192.168.x.x` 这类局域网地址不行;**桌面端(`dsh-app://`)已实测无法注册 Service Worker**(宿主未开放 `allowServiceWorkers` 特权)。因此 Windows 11 桌面端的审批按钮改由宿主发原生 Toast(见 [Windows 桌面端怎么发带按钮的通知](#windows-桌面端怎么发带按钮的通知)),macOS 桌面端仍无按钮、点通知回对话裁决。宿主不渲染通知按钮时,`debug()` 的 `bridge` 字段会说明原因,其余功能不受影响。
  299. - **Windows 10 没有原生审批按钮**:Windows 10(build < 22000)的系统通知不派发 `activationType="protocol"` 的点击,插件在那边不发带按钮的原生 Toast(路由 `reason` 报 `windows-10`),审批仍在页面或浮层里裁决([#41](https://github.com/chromoany/dsh-notify-me/issues/41),1.21.3 起)。
  300. - Windows 的系统通知标签上限 64 字符,而 Chromium 交给平台的是 `n#<origin>#<tag>` 整串——桌面页面 `dsh-app://app` 一项就占去 16 个。插件按当前 `location.origin` 算剩余预算,超长时保留可读前缀、尾部换成短哈希,所以 `debug()` 里看到的标签可能被截短;平台仍然拒发时,原文记在 `debug().lastToastReject`,设置页的测试按钮也会如实报出来,不再「提示已发送但什么都没弹」。
  301. - 桌面端(Windows)点通知后窗口仍可能抬不起来:目标窗口属于更高完整性级别(提权 / UAC)、在另一个虚拟桌面、或前台被别的进程反复抢回去时,宿主脚本回 `FOCUSED=0`、路由回 `202`,对话照常切(详见[桌面端怎么抬窗的](#桌面端怎么抬窗的))。`SW_HIDE` 到托盘的隐藏窗口 1.21.0 起先 `SW_SHOW` 再抬,不再属于这一条([#40](https://github.com/chromoany/dsh-notify-me/issues/40))。
  302. - 桌面端(macOS / Linux)点通知依赖 `dsh://open` 深链:系统未注册 `x-scheme-handler/dsh`、或壳没有 `second-instance` / `open-url` 处理时抬不起来;Linux 上已实测正常,macOS 未实测。
  303. - macOS 桌面端:页面自带的 `new Notification()` 进不了通知中心(`Notification.permission` 报 `granted` 却什么也不弹),所以插件改由宿主拉起助手发通知,需要先 `bash macos/build.sh`(见 [macOS 桌面端怎么发系统通知](#macos-桌面端怎么发系统通知))。助手未编译时退回原行为,即桌面端弹不出系统通知。审批按钮在 macOS 桌面宿主上仍然不渲染;Windows 11 桌面端改由宿主发原生 Toast,按钮可用(见 [Windows 桌面端怎么发带按钮的通知](#windows-桌面端怎么发带按钮的通知))。
  304. **提醒内容与时机**
  305. - `≥ 0.1.6`(含 `0.2.0-rc.2`、`0.2.1-rc.2`)的「回复完成」提醒正文只有会话名,不再附带回复摘要——宿主快照已不再提供 `nodes`;提醒本身照常触发。
  306. - 标题标记由宿主与插件共同写 `document.title`:宿主重算标题时标记可能被覆盖,直到下一次提醒事件重新写成。
  307. - 「当前对话不弹通知」按「窗口是否在前台」判定:被别的应用盖住、切到别的应用、最小化都算后台;回到前台或重新有键鼠输入后恢复静默。
  308. - 按对话静音的标记注在宿主的 `sidebar.session.row.leading` 槽位,而宿主在「这条会话有运行状态」时用状态点占着这个位置,标记就不渲染——正在跑的后台任务看不到划掉的铃铛,停下后自动回来;静音本身不受影响。
  309. **外部推送**
  310. - 受浏览器跨域(CORS)限制:端点不放行时自动降级为「送出但不可确认」(no-cors),如实标为「已送出不可确认」;Discord、飞书、Server酱、WxPusher 放行跨域,可直接确认送达。钉钉不放行任何 CORS 头、又只收 `application/json`,页面发不出去,所以没有做成目标类型(自建中转 + 自定义目标才行)。临时失败(网络中断、5xx、429)按退避重试,重试仍失败进失败记录,其余错误立即停、不重试;转发在本地提醒决定要发之后才触发,所以被静音的提醒也不会外发。
  311. - 同源中继补上的只是「页面够不到要认证的网关」这一类:页面 POST 到同源路由,宿主补凭据并回传网关的真实状态码。仍然成立的边界有几条——中继与宿主侧兜底都要求宿主进程在运行(`dsh web` 或桌面端主进程),它们不是独立守护进程,宿主退出就都停;宿主跑在代理环境里时网关域名要进 `no_proxy`,否则投递会绕到代理出去;兜底只补外部推送,本地系统通知、提示音、标题标记与审批按钮仍要页面在;`pageLeaseMs: 0` 是调试开关,页面开着也会收到两份;中继路由路径等同于口令,别让它出现在公开记录里。
  312. **设置页图标补丁**
  313. - 左侧导航行图标靠 DOM 补丁:外壳按分区 id 硬编码图标且 `settings.section` 没有图标字段,插件只能在面板渲染后把那一行的 `<svg>` 换成铃铛。命中依赖宿主当前的面板结构(`data-shortcut-modal="settings"` + 导航按钮里的标签 `<span>`),DSH 改了这套结构就会静默回落到默认齿轮,其余功能不受影响。标志与命名的取舍见 [docs/brand/README.md](docs/brand/README.md)。
  314. ## 开发自检
  315. ```sh
  316. node --check lib/client.js
  317. node --check lib/index.js
  318. npm test # smoke-test(状态机)+ host-route-test(宿主半路由)+ page-bridge-test + host-fallback-test + relay-route-test + cordis-host-test + mac-notify-test + win-toast-test
  319. npm pack --dry-run # 预览发布包
  320. ```
  321. <details>
  322. <summary>各测试套件覆盖范围与手动检查</summary>
  323. `smoke/smoke-test.cjs` 是离线状态机测试:三代宿主 + 主开关 + 中英语言用例 + 快捷裁决桥(Service Worker 半侧一并跑)+ 闲置判定与通知自收 + 回到页面即收起残留通知 + 通知标签长度收口 + 页面侧 host-bridge 探测/心跳/释放与 `debug().hostBridge` 形状,外加两条桌面原生通道用例——Windows 原生审批 Toast 正文点击只走宿主 focus 路由才切会话(无 session 时只抬窗不切),macOS 前台点击只靠 1 秒轮询切会话并在读走后停止。`smoke/host-route-test.mjs` 不需要本机 DSH,`lib/index.js` 的路由、探针与 403/405/501 闸门在任何平台都会跑。
  324. 新增的三个套件同样自带假 `ctx`、不联网、不需要本机 DSH:`smoke/page-bridge-test.mjs` 跑页面桥接路由的状态回包形状、心跳与释放、缺意图头 `403`、跨源 `403`、坏 JSON `400`、超长 `413`,以及 `allowedOrigins` 派生的 `Host`(模拟隧道)放行与路径冲突;`smoke/host-fallback-test.mjs` 跑宿主兜底——审批去重、`turn/end` 节流、子代理跳过、租约新鲜时不发、租约过期后发、`alive:false` 后立刻发、语言跟随心跳、401 后重读凭据、健康探针;`smoke/relay-route-test.mjs` 跑中继——`GET` 探针、`405`、跨源 `403`、`413`、`400`、`503`、`200` / `502` 映射与「401 只重试一次」、`relay.bodyTemplate` 的模板渲染与 JSON 转义、坏模板启动即不注册、渲染体积上限。
  325. `smoke/mac-notify-test.mjs` 跑 macOS 通知路由:只在 macOS 桌面宿主注册、探测、`405` / `403` / `501` / `400` 的拒绝、传给助手的参数(含 `--id` / `--sound` 与 `{remove:id}` 撤回)、点击回传只被取走一次。它用假的平台与 Electron 版本号驱动,不需要真的编译助手,在任何平台都会跑。
  326. `smoke/win-toast-test.mjs` 跑 Windows 原生 Toast 路由:Windows 桌面门控、`GET` 探针、`405` / `403` / `501` / `400` 的拒绝、审批 payload 与 base64 传递、首次发 Toast 前的六条注册命令(`HKCU\Software\Classes\dsh-notify-me` 的三条协议键、`AppUserModelId\dsh-notify-me` 的 `DisplayName` 与 `CustomActivator`、以及只建不写 `LocalServer32` 的空 `CLSID\{…}` 存根)、Windows 10 门控下既不写注册表也不发 Toast、approve / reject / open 动作单次认领、token 过期与 `{remove}` 撤回。它用假的 `spawn` 驱动 `reg.exe` / `powershell.exe`,不需要真的 Windows 桌面宿主。另外断言处理器脚本是 UTF-16LE + BOM、正文纯 ASCII、含 `ExpandEnvironmentStrings` 表达式、不烘入 profile 路径,且正文点击只发 `dsh-notify-me://open`(不得再出现 `dsh://open`);`dsh-notify-me://open` 不带 session 时仍解析为一次纯抬窗([#40](https://github.com/chromoany/dsh-notify-me/issues/40))。
  327. 改到 `lib/focus-window.ps1` 时(仅 Windows),另需手动跑一次:
  328. ```powershell
  329. powershell -NoProfile -File lib/focus-window.ps1 -ProcessId 0 # 末行应是 FOCUSED=1
  330. ```
  331. `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` 指定即可。
  332. </details>
  333. ## 致谢与贡献须知
  334. | 贡献者 | 贡献 |
  335. |:---:|:---|
  336. | <a href="https://github.com/MengHsir"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/MengHsir.png" width="40" height="40" alt="@MengHsir"></a> | [#1](https://github.com/chromoany/dsh-notify-me/issues/1):DSH Desktop 2.0.9 上「等待审批」完全不弹提醒的报障——由此定位到 `inject` 里残留 `dsh-client-runtime` 让条目停在 `pending`、`apply` 从不执行,1.1.4 起修复 |
  337. | <a href="https://github.com/edision"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/edision.png" width="40" height="40" alt="@edision"></a> | [#2](https://github.com/chromoany/dsh-notify-me/issues/2):`0.1.5-rc.2` 上「等待审批 / 提问 / 方案确认」不触发的报障,指出待处理交互的数据源已迁到 `uiSession.pendingInteractions`,1.1.6 起真正生效 |
  338. | <a href="https://github.com/azy2"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/azy2.png" width="40" height="40" alt="@azy2"></a> | [#3](https://github.com/chromoany/dsh-notify-me/issues/3):1.1.5 的修复在真机上仍不生效的定位——cordis 4 下按属性读 `uiSession` 会抛错,1.1.6 改走 `ctx.get("uiSession")` 起修复 |
  339. | <a href="https://github.com/immofon"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/immofon.png" width="40" height="40" alt="@immofon"></a> | [#4](https://github.com/chromoany/dsh-notify-me/issues/4):macOS 支持的诉求,确认插件只用标准 Web API、能否运行取决于宿主,1.4.0 起文档按宿主 / 浏览器描述 |
  340. | <a href="https://github.com/bakasbk"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/bakasbk.png" width="40" height="40" alt="@bakasbk"></a> | [#5](https://github.com/chromoany/dsh-notify-me/issues/5):`0.2.0-rc.1` 上安装被拒(`peerDependencies` 尚未覆盖 0.2.0 线)的报障,1.2.0 起放宽范围 |
  341. | <a href="https://github.com/XinAnzzZ"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/XinAnzzZ.png" width="40" height="40" alt="@XinAnzzZ"></a> | [#6](https://github.com/chromoany/dsh-notify-me/issues/6):`0.1.7-rc.2` / `0.2.0-rc.1` 上「需要你操作」全程哑火的报障,指出 `pendingInteractions` store 已不存在、需迁到 `uiSession.sessionStatus`,1.2.0 起修复 |
  342. | <a href="https://github.com/AgMahone"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/AgMahone.png" width="40" height="40" alt="@AgMahone"></a> | [#7](https://github.com/chromoany/dsh-notify-me/pull/7):宿主代际兼容(0.1.6+ / 0.2.0)的报障与复测 |
  343. | <a href="https://github.com/d0ublecl1ck"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/d0ublecl1ck.png" width="40" height="40" alt="@d0ublecl1ck"></a> | [#8](https://github.com/chromoany/dsh-notify-me/pull/8):子代理会话静音(`ignoreSubagent`),含测试与文档 |
  344. | <a href="https://github.com/EliteOtaku"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/EliteOtaku.png" width="40" height="40" alt="@EliteOtaku"></a> | [#9](https://github.com/chromoany/dsh-notify-me/issues/9):桌面端抬窗链路的逐层排查与真实壳复测 |
  345. | <a href="https://github.com/Wh1stle05"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/Wh1stle05.png" width="40" height="40" alt="@Wh1stle05"></a> | [#10](https://github.com/chromoany/dsh-notify-me/pull/10):「音效来源」(内置合成音 / 自定义音频 / 系统通知音) |
  346. | <a href="https://github.com/yanzhaohui1999"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/yanzhaohui1999.png" width="40" height="40" alt="@yanzhaohui1999"></a> | [#13](https://github.com/chromoany/dsh-notify-me/issues/13) / [#14](https://github.com/chromoany/dsh-notify-me/pull/14):多会话下空闲页面占用 CPU 的性能报告与修复 |
  347. | <a href="https://github.com/RiZhiZhaoYi"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/RiZhiZhaoYi.png" width="40" height="40" alt="@RiZhiZhaoYi"></a> | [#12](https://github.com/chromoany/dsh-notify-me/issues/12):外部通知转发(Discord / Bark / Gotify / 自定义 Webhook) |
  348. | <a href="https://github.com/yuexian7"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/yuexian7.png" width="40" height="40" alt="@yuexian7"></a> | [#17](https://github.com/chromoany/dsh-notify-me/issues/17):安卓端收消息的诉求,促成飞书 / Server酱 / WxPusher 三种目标 |
  349. | <a href="https://github.com/shrekcg"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/shrekcg.png" width="40" height="40" alt="@shrekcg"></a> | [#16](https://github.com/chromoany/dsh-notify-me/pull/16):离开判定 `idleMinutes`、「回复完成」判定 `donePolicy`、自动消失 `autoDismiss` |
  350. | <a href="https://github.com/Donald-Yip"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/Donald-Yip.png" width="40" height="40" alt="@Donald-Yip"></a> | #18(原 issue 已删除):Windows 通知 tag 超过 64 字符上限、审批测试通知被平台静默拒收的报告 |
  351. | <a href="https://github.com/dunxuan"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/dunxuan.png" width="40" height="40" alt="@dunxuan"></a> | [#20](https://github.com/chromoany/dsh-notify-me/issues/20):当前会话的通知正文用占位符、未取会话标题的报告 |
  352. | <a href="https://github.com/unnamed42"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/unnamed42.png" width="40" height="40" alt="@unnamed42"></a> | [#21](https://github.com/chromoany/dsh-notify-me/issues/21) / [#22](https://github.com/chromoany/dsh-notify-me/pull/22):Linux 上 `dsh://open` 抬窗失效的报障与补丁,1.14.4 起 macOS / Linux 恢复深链抬窗 |
  353. | <a href="https://github.com/LIEGU0317"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/LIEGU0317.png" width="40" height="40" alt="@LIEGU0317"></a> | [#24](https://github.com/chromoany/dsh-notify-me/issues/24) / [#25](https://github.com/chromoany/dsh-notify-me/pull/25):页面关闭后由宿主兜底推送、同源中继两个可选模块(默认关),含测试与文档;[#29](https://github.com/chromoany/dsh-notify-me/issues/29) / [#30](https://github.com/chromoany/dsh-notify-me/pull/30):宿主兜底漏读「转发外部通知」开关(心跳与 pagehide 带 `external`),1.19.0 起生效 |
  354. | <a href="https://github.com/ekexium"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/ekexium.png" width="40" height="40" alt="@ekexium"></a> | [#23](https://github.com/chromoany/dsh-notify-me/issues/23):按对话静音的诉求(每会话一个开关、跨重启持久化、会话行上带标记),1.16.0 起支持 |
  355. | <a href="https://github.com/AomiRaku"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/AomiRaku.png" width="40" height="40" alt="@AomiRaku"></a> | [#26](https://github.com/chromoany/dsh-notify-me/issues/26):会话行悬停按钮遮挡标题的反馈——静音铃铛改为可关闭、右键菜单补一个静音入口,1.18.0 起支持 |
  356. | <a href="https://github.com/Matthew-Laplace"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/Matthew-Laplace.png" width="40" height="40" alt="@Matthew-Laplace"></a> | [#27](https://github.com/chromoany/dsh-notify-me/issues/27) / [#28](https://github.com/chromoany/dsh-notify-me/pull/28):`keepOnReturn`(回到页面也保留提醒)的提案与最小实现,以及「前台也提醒」一键预设的诉求,1.19.0 起支持 |
  357. | <a href="https://github.com/xty13114150041"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/xty13114150041.png" width="40" height="40" alt="@xty13114150041"></a> | [#31](https://github.com/chromoany/dsh-notify-me/issues/31) / [#32](https://github.com/chromoany/dsh-notify-me/pull/32):macOS 桌面端页面通知不响的排查与宿主助手方案(`lib/mac-notify.js` + `macos/`),1.19.0 起支持 |
  358. | <a href="https://github.com/Inh-ui"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/Inh-ui.png" width="40" height="40" alt="@Inh-ui"></a> | [#33](https://github.com/chromoany/dsh-notify-me/issues/33):Windows 桌面端审批通知没有「同意 / 拒绝」按钮的反馈,以及 Electron 丢弃 `actions` / 桌面端注册不了 Service Worker 的源码级定位,1.19.0 起支持 |
  359. | <a href="https://github.com/sakurakugu"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/sakurakugu.png" width="40" height="40" alt="@sakurakugu"></a> | [#34](https://github.com/chromoany/dsh-notify-me/pull/34):同源中继自定义 JSON 请求体模板(`relay.bodyTemplate`),含测试与文档,1.20.0 起支持 |
  360. | <a href="https://github.com/AlbertDope"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/AlbertDope.png" width="40" height="40" alt="@AlbertDope"></a> | [#36](https://github.com/chromoany/dsh-notify-me/issues/36):Windows 中文用户名下审批按钮必弹 `800A004C` 的根因定位(WSH 按 ANSI 代码页解码处理器脚本)与修复验证,1.20.1 起修复 |
  361. | <a href="https://github.com/yangmin19990201-crypto"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/yangmin19990201-crypto.png" width="40" height="40" alt="@yangmin19990201-crypto"></a> | [#37](https://github.com/chromoany/dsh-notify-me/issues/37):同一 `800A004C` 在 0.2.2-rc.2 桌面端 / Windows 11 中文用户名下的独立复现与源码级根因核对(与 [#36](https://github.com/chromoany/dsh-notify-me/issues/36) 同因,1.20.1 起修复) |
  362. | <a href="https://github.com/TianqiCai"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/TianqiCai.png" width="40" height="40" alt="@TianqiCai"></a> | [#38](https://github.com/chromoany/dsh-notify-me/pull/38):macOS 已在前台时点通知不切会话的修复(1 秒轮询),含冒烟测试,1.21.0 起收编 |
  363. | <a href="https://github.com/MVennn"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/MVennn.png" width="40" height="40" alt="@MVennn"></a> | [#40](https://github.com/chromoany/dsh-notify-me/issues/40):Windows 原生审批 Toast 点正文不唤醒最小化/托盘窗口的报障与定位,1.21.0 起修复 |
  364. | <a href="https://github.com/fgql"><img src="https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/contributors/fgql.png" width="40" height="40" alt="@fgql"></a> | [#41](https://github.com/chromoany/dsh-notify-me/issues/41) / [#42](https://github.com/chromoany/dsh-notify-me/issues/42):Windows 审批 Toast 点「同意 / 拒绝」不派发协议激活的报障(1.21.2 / 1.21.3 起修复),以及桌面端点通知后窗口越抬越沉的 z-order 采样与定位(1.21.4 起修复) |
  365. 署名口径:本仓库收编外部 PR 时以维护者提交落地——不沿用原 commit、不挂 Co-authored-by,GitHub 的 contributors 图只显示维护者,贡献者以上面的致谢署名。
  366. ## Star History
  367. <details>
  368. <summary>展开 Star History 图表</summary>
  369. <a href="https://www.star-history.com/?repos=chromoany%2Fdsh-notify-me&type=timeline&legend=bottom-right">
  370. <picture>
  371. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=chromoany/dsh-notify-me&type=date&theme=dark&legend=bottom-right" />
  372. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=chromoany/dsh-notify-me&type=date&legend=bottom-right" />
  373. <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=chromoany/dsh-notify-me&type=date&legend=bottom-right" />
  374. </picture>
  375. </a>
  376. </details>
  377. ## License
  378. MIT — 见 [LICENSE](LICENSE)。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.