@local/dsh-completion-alert
当对话任务完成、出错或等待您回答时，提供可自定义的声音和屏幕级通知，并以通俗易懂的语言说明失败原因。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:WwNotVvvv/dsh-completion-alert#3b136ef3cfe818ab137a394c7a61b36d6b7f21c7Completion Alert 以 @local/dsh-completion-alert 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
一个 DSH 插件：对话任务结束时提醒你——播放可自定义的提示音，并弹出系统级通知。
关键在于它能说出具体原因。普通提醒只会告诉你"出错了"，而你往往要切回会话才知道错在哪；这个插件把会话里显示的那条错误信息取出来，念给你听。
✅ 已完成 / ⚠️ 异常中断 / ❓ 等待回答，各有独立开关、独立文案、独立音频。DSH 里用插件管理器安装（install_bundle），三种地址形式任选：
| 方式 | 填什么 |
|---|---|
| 本地目录 | 插件目录的绝对路径，或 file: / link: 前缀 |
| Git 仓库 | github:WwNotVvvv/dsh-completion-alert（本仓库） |
| npm 包 | 包名，或 包名@版本 |
| 压缩包 | 绝对 .tgz 路径，或 https://…tgz |
安装后需要刷新页面才会加载浏览器端代码。
系统通知需要你手动授权（浏览器安全限制，无法自动弹）。若提示音没有响，通常是浏览器要求先有一次用户交互——在设置页点一下任意按钮即可"解锁"音频。
「设置 → 任务提醒」下：
朗读文字、朗读语言留空即"跟随界面语言"。你的既有配置不会被改动。
插件把失败归到 10 类，先按稳定的错误码精确匹配，认不出错误码时再匹配错误文字（中转站常返回裸 HTTP 状态、HTML 错误页或自述措辞，中英都覆盖）。
| 类型 | 典型错误码 | 默认提示语 |
|---|---|---|
| 认证失败 | AUTH MISSING_CREDENTIAL ACCOUNT_SIGN_IN_REQUIRED | 接口密钥无效或未授权 |
| 额度不足 | QUOTA ACCOUNT_QUOTA | 账户额度已用尽 |
| 请求过快 | RATE_LIMIT | 请求过于频繁，已被限流 |
| 服务端错误 | SERVER（5xx、overload） | 服务端返回错误，可能是上游故障 |
| 连接中断 | STREAM_CLOSED TRANSPORT TIMEOUT | 连接中断或超时 |
| 地址或模型错误 | UNKNOWN_MODEL NO_ADAPTER | 接口地址或模型名不正确 |
| 返回异常 | MALFORMED_RESPONSE EMPTY_RESPONSE | 返回内容异常，无法解析 |
| 上下文超限 | CONTEXT_WINDOW_EXCEEDED | 对话内容超出模型上下文长度 |
| 请求被拒 | INVALID_REQUEST IMAGE_OFFLOAD_REQUIRED | 请求参数被拒绝 |
| 其他错误 | 以上都认不出 | 错误原因未识别 |
另有独立开关「同时朗读原始错误信息」（默认关），关掉时只念上表的提示语，原始技术措辞仍完整显示在通知里。
取自会话自己的 turn/end 记录——和你在会话里看到的是同一句话。转发的事件只用来判定"是否失败"，措辞优先用日志里的原文。
package.json 声明 peerDependencies 为 ">=0.2.0-rc.2 <0.3.0"；DSH 会在安装/激活时校验，不匹配会提示并给出豁免入口，而不是静默失效。api-session/status|error 转发事件、三个 slot）。这些接口若在未来版本变更，最坏情况是提醒不触发；读取日志那段有兜底，不会抛错。全部在本地，插件不发起任何网络请求。
localStorage 键 dsh.completion-alert.v1IndexedDB 库 dsh-completion-alert用插件管理器 remove_bundle，目标 @local/dsh-completion-alert。
残留的 localStorage 键与 IndexedDB 库不影响其他功能，可手动清除。
npm test # 静态审计 + 行为测试（无需 npm install）
测试基于 Node 内置 vm 模拟浏览器与 Cordis 上下文，零依赖、不需要真实浏览器。
CI 在 Node 20 / 22 上跑同一套测试，见 .github/workflows/ci.yml。
仓库根目录就是包根目录——package.json 必须在根上，否则 github:用户名/仓库名
这种安装方式找不到包（pnpm 会克隆仓库并把根当成包）。所以应当在本目录内
git init，而不是在它的上一层。
client.js 浏览器端全部逻辑（检测、声音、通知、角标、设置页）
index.js Host 端，故意为空：本插件不需要 Host 服务
cordis.patch.yml Loader 补丁，插入一个插件条目
icon.svg Plugin Manager 卡片图标
locale/ 插件列表显示用的标题与描述（DSH 读 en.json 的 meta.*）
tests/ 静态审计 + 行为测试
https://github.com/WwNotVvvv/dsh-completion-alert
package.json 的 repository / homepage / bugs 已指向该仓库，所以插件管理器里
直接填 github:WwNotVvvv/dsh-completion-alert 即可安装。
锁版本：加 #v1.0.0（见 Releases）。
版本历史见 CHANGELOG.md，发版流程见 docs/RELEASING.md。
MIT，见 LICENSE。
A DSH plugin that alerts you when a conversation finishes, fails, or waits for your answer: a customizable sound plus a screen-level notification (not an in-page card, which would be invisible exactly when the window is minimised).
It reports what went wrong, not just that something did: the failure reason is read
from the session's own turn/end record — the same text the conversation shows — then
classified into 10 families, each with its own editable spoken phrase. Reliable codes are
matched exactly; when a relay station returns only a bare HTTP status or its own prose,
the message text is matched instead, in both Chinese and English.
Spoken text and language follow the interface language when left empty. Requires DSH
>=0.2.0-rc.2 <0.3.0. Local storage only; the plugin makes no network requests.