dsh-notice-center
DeepSeek Harness 通知中心：标签页鲸鱼状态灯（绿=跑完 / 琥珀=待处理）+ 浏览器系统通知（完成/待处理提示、45 个 opencode 音效可选、音量可配）。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:SCP-QQ/dsh-notice-center#38826e5e5adb3f680f98b8ccdaefa8772f986bcf
Notice Center 以 dsh-notice-center 发布，当前版本为 1.3.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
中文 | English
DeepSeek Harness 的通知中心：把标签页上的鲸鱼图标变成状态灯，并在你不在看的时候主动提醒你 —— 会话跑完了，或者有事情等你拍板。
包名 dsh-notice-center、插件实例 id notice-center、设置命名空间 notice-center。
设置 → 通知中心（侧栏导航项）：
通知中心设置页| 鲸鱼颜色 | 含义 | 什么时候恢复 |
|---|---|---|
| 🟢 绿色 | 有会话在你没看它的时候跑完了 | 该会话点开后自动恢复；全部点开过一遍即回到默认状态 |
| 🟠 琥珀色 | 有会话有事等你处理：提问 / 审批 / 计划审核 | 处理完后自动消失 |
| ⚫ 黑色 | 一切正常（官方原版图标） | 默认状态 |
标签页上的样子（绿 = 有会话跑完了）：
颜色与侧边栏的绿点、琥珀点用的是同一份官方信号，永远同步。只统计主会话，子代理不计入。绿色与琥珀同时存在时琥珀优先——待处理是首要状态，有会话卡住等你时不会因为别的会话刚跑完而被掩盖。
三种颜色都可以在设置页改（含「默认色」，不配置则沿用官方原版图标）。
completed 由 false 变为 true；你正打开的那个会话官方不置位，由运行状态 true → false 判定）+N），正文＝通知类型（完成＝「会话已完成」；待处理按交互类型细化＝审批「待审批 · <工具名>」（拿不到工具名时就是「待审批」，工具名超 32 字截断）、提问按形态分「请你选择 / 请你多选 / 请你填写」或批量「向你提问（N 个）」、计划审核「计划待审核」，认不出的类型回退到「有交互等待处理」）；完成通知单独一条时附本轮总用时（如「会话已完成 · 本轮总用时 2分13秒」），多条聚合时不附。格式与官方会话气泡的「本轮总用时」一致；起点靠观察 running 得到，刷新页面时已经在跑的会话算不出起点，就不显示这个数| 完成通知（绿） | 待处理通知（琥珀） |
|---|---|
| 完成通知 | 待处理通知 |
通知由浏览器发出（本机是 Chrome），所以卡片上显示的是浏览器与站点
127.0.0.1:3080。
完成提示音与待处理提示音各有一个下拉，共 47 个条目：45 个取自 opencode 内置音效库（就是 opencode 设置里那套 Alert / Bip-bop / Staplebops / Nope / Yup，同名同序号）+ 2 个插件自带的合成音。
| 音效包 | 条目 |
|---|---|
| 内置（合成音） | Chime Up（完成默认，上行双音）、Chime Down（待处理默认，下行双音） |
| Alert | Alert 01–10 |
| Bip-bop | Bip-bop 01–10 |
| Staplebops | Staplebops 01–07 |
| Nope | Nope 01–12 |
| Yup | Yup 01–06 |
✓.selector（36px 高、18px 圆角胶囊）；面板＝官方 Menu（bg-layer-3 + 0.5px 描边 + 6px 圆角），条目标高用官方的 hover 填充色/notice-center-sounds/<id>.mp3 路由提供音效；路由不可用时自动回退内置合成音，不会变哑#RRGGBB，行尾 ↺ 恢复默认dsh plugin 是 pnpm 的转发器（在 profile 目录里跑 pnpm，再把新装的 bundle 补进
dsh.profile.bundles），所以 registry 包名、git 仓库、tarball、本地路径都能直接装。
dsh plugin --profile web add dsh-notice-center
包页：https://www.npmjs.com/package/dsh-notice-center（latest 为稳定版；预发布版在 next 通道）
dsh plugin --profile web add github:SCP-QQ/dsh-notice-center
# 或走 SSH（本机 HTTPS 受代理影响时）
dsh plugin --profile web add git+ssh://git@github.com/SCP-QQ/dsh-notice-center.git
npm pack # 生成 dsh-notice-center-<版本>.tgz
dsh plugin --profile web add ./dsh-notice-center-<版本>.tgz
profile 的 dependencies 加
"dsh-notice-center": "link:<项目目录>/dsh-notice-center"，
dsh.profile.bundles 加 "dsh-notice-center"。
前三种装完都要重启 Harness；宿主半的依赖只有
@deepseek-ai/schemastery（npm 上有）， 不需要 profile 额外提供任何@deepseek-ai/*包。
重启要求分两半：改浏览器半 lib/client.cjs 免重启（HMR 会 stat-poll 并通知浏览器重载该插件 bundle，刷新页面可确保干净重载）；改宿主半 lib/index.mjs 必须重启 Harness（宿主半热重载依赖 cordis-plugin-hmr，需 loader 带 --expose-internals，实测未生效）。首次安装与任何改名也必须重启。
.npmrc（可选）CI 走 OIDC 发布，不需要任何 token。只有当你打算从本机手动 npm publish 时，才在项目根目录放一个 .npmrc：
//registry.npmjs.org/:_authToken=<你的 granular token>
该文件已在 .gitignore 里，绝不要提交（仓库里有真实 token 时尤其注意）。
http://127.0.0.1:3080 或 localhost 可用；用局域网 IP 访问时浏览器 Notification API 不可用dsh plugin --profile web remove dsh-notice-center
移除依赖与 dsh.profile.bundles 条目后重启即无残留。
npm test # 宿主半 + 浏览器半冒烟测试
npm run test:host # 只跑宿主半
npm run test:client # 只跑浏览器半
CI 在 push / PR 时跑同一套（.github/workflows/test.yml）。
发布由 tag 触发的 .github/workflows/publish.yml 负责 —— 日常 commit / push 不会发包：
| 意图 | 命令 | 结果 |
|---|---|---|
| 只提交（功能还没验证完） | git commit + git push | 只跑 test.yml，npm 上毫无动静 |
| 预发布（给人试用） | 版本改 1.3.0-rc.1 → commit → git tag v1.3.0-rc.1 && git push origin v1.3.0-rc.1 | 发到 next 通道（npm i dsh-notice-center@next），latest 不变 |
| 正式发版 | 版本改 1.3.0 → commit → git tag v1.3.0 && git push origin v1.3.0 | 发到 latest，自动附带 provenance |
| 只验证发布流程 | Actions → publish → Run workflow | 装依赖 + 跑测试 + npm pack --dry-run，不发布 |
工作流内建三道闸：tag 与 package.json 版本必须一致、tag 指向的提交必须已在 main 上、测试必须通过。任一不过就发不出去。
发布不需要任何 npm 令牌（也就没有令牌过期 / 泄漏的问题）。
打开包管理页 → Publishing Access → Trusted publishers → Add a trusted publisher → 选 GitHub Actions：
https://www.npmjs.com/package/dsh-notice-center/access
| 字段 | 值 |
|---|---|
| Organization or user | SCP-QQ |
| Repository | dsh-notice-center |
| Workflow filename | publish.yml（只填文件名，不带路径；重命名该文件必须同步改这里，否则 403） |
| Environment name | npm（与工作流里的 environment: 一致） |
| Allowed actions → Allow npm publish | ✅ 必须勾 |
⚠️ 那个勾选框是 npm 新版行为：trusted publisher 默认只允许
npm stage publish（暂存），不勾 Allow npm publish 的话，本工作流里的npm publish会被拒。 若你更想要「只能暂存、必须人工在浏览器批准才真发布」，就别勾，并把工作流末步改成npm stage publish。
--provenance），包页会显示来源证明npm → 加 Required reviewers；不加也能正常发布.npmrc 用法）package.json 包元数据（dsh-notice-center）
cordis.patch.yml bundle patch 层（insert id: notice-center）
lib/index.mjs 宿主半：settings schema + /notice-center-sounds 音效路由
lib/client.cjs 浏览器半：favicon 状态机 + 系统通知 + 音效库 + 设置页
assets/audio/*.mp3 45 个 opencode 音效（MIT；来源见 assets/audio/README.md）
docs/images/*.png README 用的截图
test/host-half.smoke.mjs 宿主半冒烟测试
test/client-half.smoke.mjs 浏览器半冒烟测试（npm test 跑两个）
.github/workflows/test.yml CI：push / PR 时跑 pnpm test
MIT，完整许可文本见 LICENSE。
音效素材（assets/audio/*.mp3，45 个）取自 anomalyco/opencode
的 packages/ui/src/assets/audio/，上游以 MIT 许可发布，这里保留同样的许可与署名；
若上游调整授权，请同步替换或移除本目录（详见 assets/audio/README.md）。