dsh-inform
DSH 任务提醒插件：当 DSH 完成任务、需要批准、需要回答 时发出提醒。
默认仅发 操作系统级系统通知（浏览器 Notification API，设置页一键授权）；
页面内（启动器 UI）浮层与自定义提醒音频默认关闭，均可在 设置 → 任务提醒 页面开启。
所有开关持久化到用户设置文档（$DSH_HOME/settings.yaml 的 dsh-inform: 段）。
运行面
原生双面插件（host + client）：
-
host：监听 cordis session/event 事件总线，折叠三类提醒——
turn/end（回合结束；用户主动取消与崩溃恢复不打扰）→ 任务完成approval/asked / approval/decided 审计事件对 → 需要批准tool/call/tool/result 中名为 ask_user_question 的调用对 → 需要回答（子代理会话的完成默认不打扰，其审批仍提醒）
并暴露两个 HTTP 端点（挂在 /plugins/<id>/ 命名空间下——加固部署的鉴权栏只放行模块加载器使用的已知前缀）：
GET /plugins/dsh-inform/api/state?since=<cursor> — 增量状态快照GET /plugins/dsh-inform/api/sound — 自定义音频代理：按当前设置把本地音频文件喂给 <audio>（扩展名白名单 + 30MB 上限；http(s) URL 来源直接 302）
-
client：轮询状态端点（no-store，in-flight 防重入，失败保留最后成功快照并把原因透出到设置页）；每条送达的提醒同步触发 OS 系统通知 与 自定义音频；可选经 shell.overlay 渲染页面内浮层（默认关）；经 settings.section 注册"任务提醒"设置页。
设置项
| 设置 | 默认 | 说明 |
|---|
| 任务完成/需要批准/需要回答 | 开 | 三类事件的独立开关 |
| 系统通知 | —（授权制） | 点「开启系统通知」向浏览器申请权限 |
| 启动器 UI 弹窗 | 关 | 提醒时在页面右上角同时显示浮层卡片 |
| 自定义提醒音频 | 不启用 | 点「选择本地音频文件…」上传（存入 DSH 数据目录）；提醒时从头播放、最长 5 秒；支持试听 |
音频播放规则固定：从第 0 秒开始，最多 5 秒后自动关闭。上传的文件由宿主代理伺服（浏览器不能直接读盘），扩展名白名单 mp3/wav/ogg/m4a/flac/aac/webm、30MB 上限；也接受 http(s) URL 或本地路径作为来源。自动播放被浏览器策略拒绝时，会在下一次页面点击后自动补播一次。
开关只在浏览器侧生效：切换立即生效，无需宿主参与。宿主通过 installSettingsSection 注册命名空间（entry 配置作为 base 层），settings 服务缺席的组合自动回退 entry 配置。
从源码构建
npm install --ignore-scripts # esbuild 平台二进制由 optionalDependencies 提供
npm run verify # typecheck(双 program) + build(host tsc + client 工厂包装/纯度门) + test
测试矩阵：纯折叠逻辑单测（毫秒级零宿主）+ 真实组合集成测试（真 cordis Context + 真 dsh-session 会话总线 + 真 dsh-host-webserver + 内存版 settings provider，覆盖状态与音频两个端点）+ jsdom 客户端 UI 挂载测试。
安装
# 从 npm 安装（推荐）
npx -p @deepseek-ai/dsh dsh plugin --profile web add dsh-inform
# 或从 GitHub 安装
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:mobaixingyao/dsh-inform
# 或本地目录安装（开发迭代）
npx -p @deepseek-ai/dsh dsh plugin --profile web add <本仓库克隆目录>
安装后重启该 profile。验证：
dsh --profile web --dump-config 末尾出现 # == dsh-inform 层与 inform 行；- 打开 GUI，首页 boot 花名册包含
/plugins/dsh-inform/client.js?rev=…；
- 设置页出现"任务提醒"分区（三类开关 + 系统通知 + UI 弹窗 + 自定义音频）；点「开启系统通知」并「触发测试弹窗」，系统通知应弹出。
浏览器半体的构建复刻了官方 packages/client/tsdown.client.ts 的 lazy-CJS 工厂格式，并带纯度门：产物只允许 require('react' | 'react/jsx-runtime')。
设计边界与已知限制
- 系统通知依赖标签页存活（浏览器 Notification API 特性）；完全关闭 GUI 时不会推送。
- 远程（非回环）浏览器上设置 RPC 不可用，开关页降级为提示文案，行为按默认值处理。
- 提醒状态（含游标去重）保存在进程内存：宿主重启后未决审批/提问会重新提醒，已完成的提醒不会重放。
- 音频代理只读单个来源（上传槽 / 配置路径），无目录遍历面；扩展名白名单外返回 415。
ask_user_question 的识别基于工具名常量 ask_user_question（来自官方 dsh-tool-ask-user）。
许可
MIT
