本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-session-notification

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @dingyi222666/dsh-session-notification

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 设置栏目通过客户端 slot 系统（settings.section）注册，与官方栏目做法一致。
• 偏好存在浏览器本地（localStorage）并跨标签页同步；不需要宿主的 WEB_SETTINGS_NAMESPACES 或任何其他宿主包改动。（Node 半区仍通过 settings 服务在宿主侧保留 dsh-session-notification 命名空间，未放行时它只是占位、无副作用。）
• 设置外壳只给它自己认识的栏目 id 配导航图标，所以「通知」导航行显示的是外壳默认的齿轮。
• 浏览器通知总开关（含授权状态与「授权」按钮），
• 当前会话也提醒开关（开启后正在看的会话完成、出错时也会响），

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后需要做什么额外配置吗？

不需要。安装并重启 dsh web 后，设置面板会多出一个「通知」栏目；浏览器通知默认关闭，首次开启时会向浏览器申请权限，点一次「授权」即可。所有偏好都存在浏览器本地（localStorage），跨标签页自动同步。

提示音是怎么来的？会随插件一起下载音频文件吗？

不会下载。四种内置音效（叮咚/低鸣/轻响/警示）全部用 Web Audio API 在浏览器里实时合成，插件包不携带任何音频文件，体积因此保持很小；如果你想换音色，可以为任意一类事件上传 mp3/ogg/wav（不超过 1 MB）。

我正在看当前会话时它会响吗？

默认不会。设计有意避免与对话界面自身的提示重复打扰：当你正在看的那个会话触发了完成/失败，并且标签页处于前台可见时，不会响铃也不会弹通知。如果希望它也提醒，把「当前会话也提醒」开关打开即可。

浏览器通知被拒绝后再点开关还能用吗？

不能。开关只能反映用户的偏好，权限被拒绝后系统通知的开关会显示「通知已暂停：缺少浏览器权限」，需要去浏览器站点设置里重新放权再回来点一次；声音与权限无关，可以照常使用。

离开页面一段时间后再切回去，会不会有「补弹」一大堆通知？

不会。插件只看会话列表快照的边沿事件（运行状态从 true 变 false、出现 question / approval），插件加载时已经空闲或已经在等待交互的会话不会触发任何通知，只有真正发生在加载之后的新边沿才会提醒。

自定义音效会上传到服务器吗？

不会。自定义音频以 data URL 形式存进当前浏览器的 localStorage（key 是 dsh-session-notification.customSounds），属于设备本地媒体资源，不会跨浏览器或跨 profile 跟随。

会修改 DSH 宿主或聊天视图的代码吗？

不会。设置栏目通过 settings.section slot 注册，与官方栏目做法一致；偏好放在浏览器本地，不需要宿主放行任何设置命名空间；通知来源是会话列表快照，不新增任何 wire 通道。Node 侧仅占位一个 dsh-session-notification 命名空间，不动 apiproxy 等宿主包。

怎么卸载？

用 dsh plugin --profile web remove @dingyi222666/dsh-session-notification，然后重启 dsh web 并在浏览器硬刷新（Cmd/Ctrl+Shift+R）；设置栏目会消失，浏览器本地存的偏好和自定义音频会留在 localStorage 里直到你手动清理。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >= 0.1.1-rc.2
• Node: 未声明

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则