审批通知器 pedromarcioap/dsh-approval-notifier

DSH — 审批通知

Chrome 扩展（Manifest V3），当 DeepSeek Harness 卡住、等你做决定时，弹出系统原生通知——在 Windows 上就是系统 toast。

DSH 审批通知

示意图（tools/make-preview.ps1）。实际外观跟随你的 Windows 主题。

触发时机

扩展会监听接管聊天输入区的面板。每个面板都会暴露一个固定属性，所以完全不依赖自动生成的 CSS 类名：

| 面板 | 监听的标记 | 通知内容 |
| 工具审批 / 沙箱升级 | [data-approval-key] | “DSH 正在等待你的审批” |
| ask_user_question 提问 | [data-question-key] | “DSH 正在等待你的回答” |
| 计划评审（plan mode） | [data-plan-review-key] | “DSH 正在等待计划评审” |

行为：

- 每个请求只通知一次。 DOM 反复变动不会重复弹窗。
- 你作答后，或面板离开屏幕时，自动关闭。
- 没人回应就提醒： toast 大约每 90 秒重新出现，最多三次；你作答或关掉通知后停止。
- 图标角标显示还有多少请求等待决定——弹窗关着也能看到。
- toast 同时短促响一声，但只有你在页面上做过交互后才会响（Chrome 的自动播放限制）。
- 有未处理事项时，标签页标题会加上 ⚠ 。
- 点击通知会聚焦 DSH 标签页。
- 可选静默时段（见配置）：窗口外收到的通知会先压住，等时段结束后再发；如果你提前作答，就直接丢弃。审批可以突破静默时段，因为它会卡住智能体。
- 支持 127.0.0.1 和 localhost 的任意端口，包括 DSH Desktop——它每次运行都会挑一个空闲端口。

安装

1. 打开 chrome://extensions。
2. 开启开发者模式。
3. 点击加载已解压的扩展程序，选择扩展所在文件夹。
4. 刷新 DSH 标签页（F5）——content script 只会注入安装之后加载的页面。
5. 点击扩展图标，用发送测试通知验证。

Releases 里有打包好的 .zip——解压后加载文件夹即可。

只要文件夹还在，扩展就一直处于安装状态。移动或删除文件夹后，需要重新移除并加载。

配置（弹窗）

- 启用通知——开关通知，无需卸载扩展。
- 仅当窗口未聚焦时——避免窗口已经在前台时重复提醒你已经在看聊天窗口了。如果请求到达时窗口正处于焦点状态，那么在你切换窗口的那一刻，它仍会提醒你。
- 免打扰时段 — 「请勿打扰」窗口（默认 22:00–08:00，关闭）。可以跨越午夜。落在该窗口内的提醒会挂起，显示在徽标上，并在窗口结束时送达；如果你提前回复，则不会送达任何内容。
- 审批穿透免打扰 — 默认开启：审批会阻塞智能体，所以值得把你叫醒；提问和计划审阅则等待窗口结束。

通知不出现时

1. chrome://settings/content/notifications → 放行站点 127.0.0.1（DSH 的端口无关紧要：扩展会匹配 127.0.0.1 和 localhost 上的任意端口）。
2. Windows → 设置 → 系统 → 通知：允许 Chrome，并在工作时段关闭专注助手。
3. 确认 harness 页面确实位于 127.0.0.1 或 localhost（例如 DSH Desktop 会启动在 58426 这类随机端口上）。
4. 如果页面角落出现橙色提示，写着 审批提醒未生效，说明页面加载后扩展被重新加载过：按 F5。
弹窗还会显示上次提醒是多久以前，以及是否有标签页正在与扩展通信。

限制

- 需要标签页保持打开。 扩展观察的是 DOM；浏览器关闭时不会有提醒（也没有地方可以回复）。
- 仅限 DSH 页面。 不会干扰其他标签页或其他网站。
- 不是审批通道。 它只负责提醒；决定仍在聊天面板中做出，且每次审批只能使用一次。

DSH 原生插件

还有一个客户端插件版本，位于 plugin/：它不观察 DOM，而是订阅会话状态快照（ctx.uiSession.sessionStatus）。它不依赖 3080 端口，也不依赖标签页打开，并且遵循生态的 bundle 约定，可以通过 dsh plugin add 安装，并登记到社区目录中。

尚未发布到 npm —— 状态见 plugin/README.md。

开发

node test/content.test.mjs # 23 verificações, DOM + chrome simulados
pwsh -File tools/build-release.ps1 # gera dist/dsh-approval-notifier-<versão>.zip

工作流 .github/workflows/test.yml 在每次 push 和 pull request 时运行这些测试。

隐私

扩展不收集也不传输数据。详情见 PRIVACY.md。

发布

Chrome Web Store 的材料位于 store/，发布文案位于 marketing/。

许可证

MIT —— 见 LICENSE。

DSH — 审批通知器

Chrome 扩展（Manifest V3），当 DeepSeek Harness 在对话中阻塞、等待你做出决定时，触发原生通知 —— 在 Windows 上是 Windows toast。

触发时机

它监视接管聊天输入区的面板。每个面板都会发布一个稳定属性，因此不依赖生成的 CSS 类：

| 面板 | 监听的标记 | 通知 |
| 工具审批 / 沙箱升级 | [data-approval-key] | “DSH aguardando sua aprovação” |
| ask_user_question 提示词 | [data-question-key] | “DSH aguardando sua resposta” |
| 计划审查（plan 模式） | [data-plan-review-key] | “DSH aguardando revisão do plano” |

- 每个请求只发一条通知，DOM 反复变动也不会重复。
- 自动清除：你作答后，或面板离开屏幕时，通知随之消失。
- 短促提示音，仅在页面上发生过用户手势之后才响（Chrome 的自动播放规则）。
- 有事项待处理时，标签页标题会加上 ⚠ 前缀。
- 点击通知会把 DSH 标签页切到前台。

安装

1. 打开 chrome://extensions。
2. 启用 Developer mode。
3. 点击 Load unpacked，选中扩展所在文件夹。
4. 重新加载 DSH 标签页（F5）。
5. 打开弹窗，按 Enviar notificação de teste。

打包好的 .zip 见 Releases。

故障排查

如果出现橙色横幅 Aviso de aprovação inativo，说明扩展是在页面之后重新加载的：按 F5。弹窗还会显示距上次通知过了多久，以及当前是否有标签页在与扩展通信。

设置（弹窗）

- Ativar avisos —— 开关通知，无需卸载扩展。
- Só quando a janela não estiver em foco —— 你正看着聊天窗口时保持安静；一旦切走，立刻提醒。

已知限制

- 需要标签页开着。 它监视 DOM，浏览器关掉就无从提醒（也无处作答）。
- 只作用于 DSH 页面。 不碰其他标签页或网站。
- 不是审批通道。 它只负责通知；决定仍在聊天面板里做，且每次审批都是一次性的。

原生 DSH 插件

客户端插件版本在 plugin/：它不监视 DOM，而是订阅会话状态快照（ctx.uiSession.sessionStatus）。不依赖 3080 端口，也不要求标签页开着；它遵循生态的 bundle 约定，因此可以用 dsh plugin add 安装，并列入社区目录。

尚未发布到 npm —— 当前状态见 plugin/README.md。

许可证

MIT —— 见 LICENSE。