dsh-notice-center 1.2.0 → 1.3.0

package/README.en.md

@@ -0,0 +1,211 @@
+# dsh-notice-center 🔔🐋
+
+[中文](./README.md) | **English**
+
+[![test](https://github.com/SCP-QQ/dsh-notice-center/actions/workflows/test.yml/badge.svg)](https://github.com/SCP-QQ/dsh-notice-center/actions/workflows/test.yml)
+[![npm](https://img.shields.io/npm/v/dsh-notice-center.svg)](https://www.npmjs.com/package/dsh-notice-center)
+
+A **notification center** for DeepSeek Harness: it turns the tab's whale icon into a status light and gets your attention while you are looking elsewhere — a session finished, or something is waiting for your decision.
+
+Package `dsh-notice-center`, plugin instance id `notice-center`, settings namespace `notice-center`.
+
+## Screenshots
+
+Settings → **Notification center** (a sidebar entry):
+
+<img src="docs/images/settings.png" width="440" alt="Notification center settings">
+
+## Features
+
+### 1. Whale status light (favicon state machine)
+
+| Whale colour | Meaning | When it clears |
+|---|---|---|
+| 🟢 Green | A session **finished** while you were not watching it | Clears once you open that session; back to the default state once you have opened them all |
+| 🟠 Amber | A session **awaits you**: question / approval / plan review | Clears once handled |
+| ⚫ Black | All clear (the stock icon) | Default state |
+
+In the tab (green = a session finished):
+
+![Tab status light](docs/images/tab-status-light.png)
+
+The colours come from **the same official signal** as the sidebar's green and amber dots, so they never drift apart. Only main sessions count; subagents do not affect it. When both apply, **amber wins** — a pending interaction is the primary status, so a session waiting on you is never masked by another session that just finished.
+
+All three colours are configurable, including the default colour — leave it unset to keep the stock icon.
+
+### 2. System notifications
+
+- **Completion** — fires when a session finishes (the official `completed` goes false → true; the session you have open never flips it, so its run state going true → false counts instead)
+- **Pending** — fires when a new interaction starts waiting for you
+- **Text** — the title is the session name (with `+N` when several merge), the body is the kind of notification (finished → Session finished; pending is **refined per interaction**: approval → *Approval · Bash* (plain *Approval needed* when no tool name is available, truncated past 32 characters), a question → *Choose an option* / *Choose options* / *Type an answer*, or *2 questions* for a batch, plan review → *Plan review*; unknown kinds fall back to a generic line); a **single** finished notification also carries how long the turn took (*Session finished · turn took 2m13s*), formatted like the official in-conversation "turn time" readout and dropped when several merge. The start is observed from `running`, so a turn already in flight when the page reloads has no start and shows no figure
+- **Quiet by default while you are looking** — *in the foreground* means the tab is visible **and** the window has focus; switching tabs, minimising, or leaving the browser behind another app all notify you. To be notified in the foreground too (still sitting in a session but away from the screen), turn on *Notify in the foreground* under *More notification options*
+- **Batching and de-duplication** — events within a 300ms window are merged; the same session and kind only fires once; several sessions merge into *title +N*
+- **Clicking the notification** focuses the window and opens that session
+- **Sound** — finished and pending each have their own picker (**hover to preview**) and a shared volume (adjusting the volume replays the current finished sound at the new level); turning sound on silences the system notification sound and uses the plugin's own
+- **Optional persistence** — turn *Auto hide* off and the notification stays on screen until you dismiss it (auto hide is on by default, so the OS collects it)
+- The notification icon follows your configured status-light colour
+
+| Finished (green) | Pending (amber) |
+|---|---|
+| ![Finished notification](docs/images/notification-done.png) | ![Pending notification](docs/images/notification-pending.png) |
+
+> Notifications are raised by the browser (Chrome here), so the card shows the browser and the origin `127.0.0.1:3080`.
+
+### 3. Sound library
+
+Finished and pending each have a picker with **47 entries**: 45 taken from opencode's built-in sound library (the same `Alert` / `Bip-bop` / `Staplebops` / `Nope` / `Yup` set, with the same numbering as opencode's settings) plus two tones the plugin synthesises itself.
+
+| Pack | Entries |
+|---|---|
+| Built-in (synthesised) | Chime Up (default for finished, a rising two-tone), Chime Down (default for pending, a falling two-tone) |
+| Alert | Alert 01–10 |
+| Bip-bop | Bip-bop 01–10 |
+| Staplebops | Staplebops 01–07 |
+| Nope | Nope 01–12 |
+| Yup | Yup 01–06 |
+
+- **Hover to preview** — moving over an entry plays it (120ms debounce, so sweeping the list does not machine-gun)
+- **Click to apply** — the chosen sound is what that kind of notification plays; the current one is ticked `✓`
+- **Styled like the official control** — the trigger is the official language selector's `.selector` (36px tall, 18px pill radius); the panel is the official `Menu` (`bg-layer-3`, 0.5px hairline, 6px radius), and entries highlight with the official hover fill
+- The host half serves the files at `/notice-center-sounds/<id>.mp3`; if that route is unavailable it **falls back to the built-in synthesised tone**, so you are never left silent
+- No migration needed: without a stored choice it still uses Chime Up / Chime Down
+
+## Usage
+
+1. **Open the settings page** — Settings → **Notification center**
+2. **Turn system notifications on** — flip the master switch; the browser asks for permission, choose Allow (if it was denied, the page says so and you have to re-allow it in the browser's site settings)
+3. **Volume, sounds and foreground alerts** — expand *More notification options*: drag the volume slider (**releasing it replays the finished sound at the new level**); in the finished / pending pickers **hovering an entry previews it**, clicking selects it; turn on *Notify in the foreground* to be alerted while the page is in front
+4. **Colours (optional)** — expand *Tab whale light*: click the swatch or type a `#RRGGBB`, and ↺ at the end of the row restores the default
+5. **That is it** — from then on, sessions finishing or waiting for you notify you while you are away; clicking the notification jumps back to that session
+
+## Installation
+
+`dsh plugin` is a **thin forwarder to pnpm** (it runs pnpm in the profile directory, then adds the new bundle to `dsh.profile.bundles`), so a registry name, a git repository, a tarball or a local path all work.
+
+### 1. From npm (recommended)
+
+```sh
+dsh plugin --profile web add dsh-notice-center
+```
+
+Package page: <https://www.npmjs.com/package/dsh-notice-center> (`latest` is the stable line; pre-releases live on the `next` tag)
+
+### 2. Straight from GitHub (no publish needed)
+
+```sh
+dsh plugin --profile web add github:SCP-QQ/dsh-notice-center
+# or over SSH (when a proxy interferes with HTTPS on your machine)
+dsh plugin --profile web add git+ssh://git@github.com/SCP-QQ/dsh-notice-center.git
+```
+
+### 3. From a tarball (offline / internal distribution)
+
+```sh
+npm pack                                        # produces dsh-notice-center-<version>.tgz
+dsh plugin --profile web add ./dsh-notice-center-<version>.tgz
+```
+
+### 4. Local link (while editing the code)
+
+Add `"dsh-notice-center": "link:<project dir>/dsh-notice-center"` to the profile's `dependencies`, and `"dsh-notice-center"` to `dsh.profile.bundles`.
+
+> The first three need a **Harness restart** afterwards. The host half's only runtime dependency is `@deepseek-ai/schemastery` (which exists on npm), so the profile does not have to provide any `@deepseek-ai/*` package.
+
+**Restart rules differ per half**: editing the browser half `lib/client.cjs` needs no restart (HMR stat-polls the bundle and tells the browser to reload it; refreshing the page forces a clean reload); **editing the host half `lib/index.mjs` requires a Harness restart** (host-half hot reload depends on `cordis-plugin-hmr`, which needs the loader to run with `--expose-internals` — measured, it does not take effect). A first install, or any rename, also requires a restart.
+
+### 5. A local `.npmrc` for manual publishing (optional)
+
+CI publishes over OIDC and needs **no token at all**. Only if you want to run `npm publish` from this machine, drop a `.npmrc` into the project root:
+
+```sh
+//registry.npmjs.org/:_authToken=<your granular token>
+```
+
+It is already listed in `.gitignore` — **never commit it** (especially not when it holds a real token).
+
+## Requirements
+
+- A stock DeepSeek Harness (measured here on Harness 0.1.5-rc.1 + client packages 0.1.5-rc.2; supported from 0.1.2-rc.1)
+- System notifications need a **secure context**: `http://127.0.0.1:3080` and `localhost` work; over a **LAN IP** the browser's Notification API is unavailable
+
+## Uninstall
+
+```sh
+dsh plugin --profile web remove dsh-notice-center
+```
+
+Removing the dependency and the `dsh.profile.bundles` entry leaves nothing behind after a restart.
+
+## Known limitations
+
+- **No notifications once the tab is closed** (Web Push needs a server plus HTTPS, which a local plugin cannot reasonably provide; covering that would need a host-side toast)
+- The Notification API is unavailable in a non-secure context (LAN IP)
+- The green light is lost on page reload: that is the memory-only semantics of the official finished signal, not a bug
+- System-wide do-not-disturb (Windows Focus Assist and friends) swallows notifications and the plugin cannot tell
+
+## Development
+
+```sh
+npm test            # host-half + client-half smoke tests
+npm run test:host   # host half only
+npm run test:client # client half only
+```
+
+CI runs the same suite on push and pull requests (`.github/workflows/test.yml`).
+
+## Releasing
+
+Releases are driven by **tags** through [`.github/workflows/publish.yml`](.github/workflows/publish.yml) — everyday commits and pushes **never publish**:
+
+| Intent | Command | Result |
+|---|---|---|
+| Commit only (feature not verified yet) | `git commit` + `git push` | `test.yml` runs; npm is untouched |
+| Pre-release (for testers) | set the version to `1.3.0-rc.1` → commit → `git tag v1.3.0-rc.1 && git push origin v1.3.0-rc.1` | published to the **`next`** tag (`npm i dsh-notice-center@next`); `latest` stays put |
+| Real release | set the version to `1.3.0` → commit → `git tag v1.3.0 && git push origin v1.3.0` | published to **`latest`**, with provenance attached |
+| Validate the pipeline only | Actions → publish → Run workflow | install + tests + `npm pack --dry-run`, **no publish** |
+
+Three gates are built into the workflow: **the tag must equal the `package.json` version**, **the tagged commit must already be on `main`**, and **the tests must pass**. Any of them failing stops the publish.
+
+### One-time setup: npm Trusted Publishing (OIDC)
+
+Publishing needs no npm token at all, so there is nothing to leak or rotate.
+
+Open the package management page → **Publishing Access** → *Trusted publishers* → **Add a trusted publisher** → **GitHub Actions**:
+
+<https://www.npmjs.com/package/dsh-notice-center/access>
+
+| Field | Value |
+|---|---|
+| Organization or user | `SCP-QQ` |
+| Repository | `dsh-notice-center` |
+| Workflow filename | `publish.yml` (the **filename only**, no path; renaming the file means updating this, or publishes get a 403) |
+| Environment name | `npm` (must match the `environment:` in the workflow) |
+| **Allowed actions → Allow npm publish** | ✅ **must be checked** |
+
+> ⚠️ That checkbox is new npm behaviour: a trusted publisher may only `npm stage publish` unless *Allow npm publish* is ticked, and this workflow's `npm publish` would be rejected.
+> If you would rather have it stage-only and publish by hand in the browser, leave it unchecked and change the workflow's last step to `npm stage publish`.
+
+- Publishing over OIDC makes npm attach **provenance automatically** (no `--provenance` flag), and the package page shows it
+- To require a human click even after a tag is pushed, add **Required reviewers** to the `npm` environment under the repository's Settings → Environments; publishing works without it too
+- Manual local publishing can still fall back to a granular token (see the `.npmrc` usage in Installation, step 5)
+
+## Layout
+
+```
+package.json               package metadata (dsh-notice-center)
+cordis.patch.yml           bundle patch layer (insert id: notice-center)
+lib/index.mjs              host half: settings schema + the /notice-center-sounds route
+lib/client.cjs             browser half: favicon state machine + notifications + sounds + settings UI
+assets/audio/*.mp3         45 opencode sound clips (MIT; see assets/audio/README.md)
+docs/images/*.png          screenshots used by the READMEs
+test/host-half.smoke.mjs   host-half smoke test
+test/client-half.smoke.mjs client-half smoke test (npm test runs both)
+.github/workflows/test.yml CI: pnpm test on push / PR
+```
+
+## License
+
+MIT; the full text is in [`LICENSE`](./LICENSE).
+
+The sound clips (`assets/audio/*.mp3`, 45 files) come from [anomalyco/opencode](https://github.com/anomalyco/opencode),
+specifically `packages/ui/src/assets/audio/`. Upstream ships them under the MIT licence, and the same licence and attribution are kept here; if upstream changes its licensing, replace or drop this directory (see [`assets/audio/README.md`](./assets/audio/README.md)).

package/README.md

@@ -1,8 +1,11 @@
 # dsh-notice-center 🔔🐋
 
+**中文** | [English](./README.en.md)
+
 [![test](https://github.com/SCP-QQ/dsh-notice-center/actions/workflows/test.yml/badge.svg)](https://github.com/SCP-QQ/dsh-notice-center/actions/workflows/test.yml)
+[![npm](https://img.shields.io/npm/v/dsh-notice-center.svg)](https://www.npmjs.com/package/dsh-notice-center)
 
-DeepSeek Harness 的**通知中心**：把标签页鲸鱼图标变成状态灯，并在你不在看的时候主动提醒你 —— 会话跑完了，或者有事情等你拍板。
+DeepSeek Harness 的**通知中心**：把标签页上的鲸鱼图标变成状态灯，并在你不在看的时候主动提醒你 —— 会话跑完了，或者有事情等你拍板。
 
 包名 `dsh-notice-center`、插件实例 id `notice-center`、设置命名空间 `notice-center`。
 
@@ -18,28 +21,28 @@ DeepSeek Harness 的**通知中心**：把标签页鲸鱼图标变成状态灯
 
 | 鲸鱼颜色 | 含义 | 什么时候恢复 |
 |---|---|---|
-| 🟢 绿色 | 有会话在您没看它的时候**跑完了** | 点开该会话后自动恢复；全部看完回黑 |
-| 🟠 琥珀色 | 有会话**有事等您处理**：提问 / 审批 / 计划审核 | 处理完后自动消失 |
+| 🟢 绿色 | 有会话在你没看它的时候**跑完了** | 该会话点开后自动恢复；全部点开过一遍即回到默认状态 |
+| 🟠 琥珀色 | 有会话**有事等你处理**：提问 / 审批 / 计划审核 | 处理完后自动消失 |
 | ⚫ 黑色 | 一切正常（官方原版图标） | 默认状态 |
 
 标签页上的样子（绿 = 有会话跑完了）：
 
 ![标签页状态灯](docs/images/tab-status-light.png)
 
-颜色与侧边栏的绿点、琥珀点**用的是同一份官方信号**，永远同步。只响应主会话，子代理不影响。绿色与琥珀同时存在时显示绿色。
+颜色与侧边栏的绿点、琥珀点**用的是同一份官方信号**，永远同步。只统计主会话，子代理不计入。绿色与琥珀同时存在时**琥珀优先**——待处理是首要状态，有会话卡住等你时不会因为别的会话刚跑完而被掩盖。
 
 三种颜色都可以在设置页改（含「默认色」，不配置则沿用官方原版图标）。
 
 ### 2. 系统通知
 
-- **完成通知**：会话 `completed` 由 false → true 时触发
+- **完成通知**：会话跑完时触发（官方 `completed` 由 false 变为 true；你正打开的那个会话官方不置位，由运行状态 true → false 判定）
 - **待处理通知**：出现新的待处理交互时触发
-- **通知文案**：标题＝会话名（多条聚合时补 `+N`），正文＝通知类型（完成＝「会话已完成」；待处理＝「待审批 / 向你提问 / 计划待审核」，未知类型回退到「有交互等待处理」）
-- **只在你不看的时候弹**（固定策略）——「前台」= 标签页可见**且**窗口有焦点；切到别的标签页、最小化、被别的应用压在后面时都会提醒，只有你正看着 DSH 时才不打扰
-- **聚合与去重**：300ms 窗口合并，同一会话同一类型只弹一次；多条合并为「标题 +N」
+- **通知文案**：标题＝会话名（多条聚合时补 `+N`），正文＝通知类型（完成＝「会话已完成」；待处理**按交互类型细化**＝审批「待审批 · <工具名>」（拿不到工具名时就是「待审批」，工具名超 32 字截断）、提问按形态分「请你选择 / 请你多选 / 请你填写」或批量「向你提问（N 个）」、计划审核「计划待审核」，认不出的类型回退到「有交互等待处理」）；**完成通知单独一条时**附本轮总用时（如「会话已完成 · 本轮总用时 2分13秒」），多条聚合时不附。格式与官方会话气泡的「本轮总用时」一致；起点靠观察 `running` 得到，刷新页面时已经在跑的会话算不出起点，就不显示这个数
+- **默认只在你不看的时候弹**——「前台」= 标签页可见**且**窗口有焦点；切到别的标签页、最小化、被别的应用压在后面时都会提醒。想在前台也提醒（人还停在会话里、却已离开屏幕，例如在刷手机），打开「更多通知设置 → 前台提醒」
+- **聚合与去重**：300ms 内的通知合并，同一会话同一类型只弹一次；多条合并为「标题 +N」
 - **点击通知** = 聚焦窗口并打开对应会话
-- **提示音**：完成 / 待处理各自可下拉选音效（**悬浮即试听**），音量可调；开启提示音时会静音系统提示音，改用插件自带音
-- **常驻可选**：可关闭「自动隐藏」，通知就一直留在屏幕上，直到你点击或手动关闭（默认开启自动隐藏，由系统自行收起）
+- **提示音**：完成 / 待处理各自可下拉选音效（**悬浮即试听**），音量可调（**调完音量会按新音量试听当前的完成提示音**）；开启后改播插件自带音效，系统默认提示音会被静音
+- **常驻可选**：可关闭「自动隐藏」，通知就一直留在屏幕上，直到你点掉它（默认开启自动隐藏，由系统自行收起）
 - 通知图标跟随你配置的状态灯颜色
 
 | 完成通知（绿） | 待处理通知（琥珀） |
@@ -50,7 +53,7 @@ DeepSeek Harness 的**通知中心**：把标签页鲸鱼图标变成状态灯
 
 ### 3. 音效库
 
-完成提示音与待处理提示音各有一个下拉，共 **47 个条目**：45 个 opencode 内置音效 + 2 个插件自带的合成音。
+完成提示音与待处理提示音各有一个下拉，共 **47 个条目**：45 个取自 opencode 内置音效库（就是 opencode 设置里那套 `Alert` / `Bip-bop` / `Staplebops` / `Nope` / `Yup`，同名同序号）+ 2 个插件自带的合成音。
 
 | 音效包 | 条目 |
 |---|---|
@@ -64,14 +67,14 @@ DeepSeek Harness 的**通知中心**：把标签页鲸鱼图标变成状态灯
 - **悬浮即试听**：鼠标划过下拉里的条目就播该音效（120ms 防抖，扫过整列不会连成一片）
 - **点选即生效**：选中后该类型通知就播这个音，当前项打 `✓`
 - **样式照官方**：触发按钮＝官方语言下拉的 `.selector`（36px 高、18px 圆角胶囊）；面板＝官方 `Menu`（`bg-layer-3` + 0.5px 描边 + 6px 圆角），条目标高用官方的 hover 填充色
-- 音效由宿主半在 `/notice-center-sounds/<id>.mp3` 提供；路由不可用时**自动回退内置合成音**，不会变哑
+- 宿主半通过 `/notice-center-sounds/<id>.mp3` 路由提供音效；路由不可用时**自动回退内置合成音**，不会变哑
 - 老配置无需迁移：没配过音效时仍用 Chime Up / Chime Down
 
 ## 使用
 
 1. **打开设置页** —— 设置 → **通知中心**
 2. **开启系统通知** —— 打开「系统通知」总开关，浏览器会弹出授权请求，选「允许」（被拒绝时设置页会提示，需要到浏览器的站点设置里恢复）
-3. **调音量 / 选音效** —— 展开「更多通知设置」：拖音量条；在「完成提示音 / 待处理提示音」下拉里**鼠标划过即可试听**，点一下选中
+3. **调音量 / 选音效 / 前台提醒** —— 展开「更多通知设置」：拖音量条，**松手后会按新音量试听完成提示音**；在「完成提示音 / 待处理提示音」下拉里**鼠标划过即可试听**，点一下选中；想让正看着页面时也提醒，打开「前台提醒」
 4. **改颜色（可选）** —— 展开「鲸鱼状态灯」：点色块或直接填 `#RRGGBB`，行尾 ↺ 恢复默认
 5. **就这样** —— 之后你切走或最小化时，会话跑完 / 有事等你都会收到通知；点通知直接跳回那个会话
 
@@ -86,6 +89,8 @@ DeepSeek Harness 的**通知中心**：把标签页鲸鱼图标变成状态灯
 dsh plugin --profile web add dsh-notice-center
 ```
 
+包页：<https://www.npmjs.com/package/dsh-notice-center>（`latest` 为稳定版；预发布版在 `next` 通道）
+
 ### 2. 直接从 GitHub 装（无需先发布）
 
 ```sh
@@ -97,8 +102,8 @@ dsh plugin --profile web add git+ssh://git@github.com/SCP-QQ/dsh-notice-center.g
 ### 3. 从 tarball 装（离线 / 内网分发）
 
 ```sh
-npm pack                                        # 生成 dsh-notice-center-1.2.0.tgz
-dsh plugin --profile web add ./dsh-notice-center-1.2.0.tgz
+npm pack                                        # 生成 dsh-notice-center-<版本>.tgz
+dsh plugin --profile web add ./dsh-notice-center-<版本>.tgz
 ```
 
 ### 4. 本地 link（改代码时用）
@@ -112,6 +117,16 @@ profile 的 `dependencies` 加
 
 **重启要求分两半**：改浏览器半 `lib/client.cjs` 免重启（HMR 会 stat-poll 并通知浏览器重载该插件 bundle，刷新页面可确保干净重载）；**改宿主半 `lib/index.mjs` 必须重启 Harness**（宿主半热重载依赖 `cordis-plugin-hmr`，需 loader 带 `--expose-internals`，实测未生效）。首次安装与任何改名也必须重启。
 
+### 5. 本机手动发布用的 `.npmrc`（可选）
+
+CI 走 OIDC 发布，**不需要任何 token**。只有当你打算从本机手动 `npm publish` 时，才在项目根目录放一个 `.npmrc`：
+
+```sh
+//registry.npmjs.org/:_authToken=<你的 granular token>
+```
+
+该文件已在 `.gitignore` 里，**绝不要提交**（仓库里有真实 token 时尤其注意）。
+
 ## 要求
 
 - 官方版本 DeepSeek Harness（本机实测：Harness 0.1.5-rc.1 + 客户端包 0.1.5-rc.2，适配范围 0.1.2-rc.1+）
@@ -129,7 +144,7 @@ dsh plugin --profile web remove dsh-notice-center
 
 - 浏览器**标签页关闭后收不到通知**（Web Push 需要服务端 + HTTPS，本地插件场景不现实；要覆盖需宿主 Toast 方案）
 - 非安全上下文（局域网 IP）下 Notification API 不可用
-- 刷新页面后绿色状态丢失：这是官方「已完成通知」的内存态语义，属正常现象
+- 刷新页面后绿色状态丢失：该状态只存在内存中，刷新即丢，属官方信号本身的行为
 - 系统级勿扰模式（Windows 专注助手等）会吞掉通知，插件无法感知
 
 ## 开发
@@ -142,6 +157,42 @@ npm run test:client # 只跑浏览器半
 
 CI 在 push / PR 时跑同一套（`.github/workflows/test.yml`）。
 
+## 发布
+
+发布由 **tag 触发**的 [`.github/workflows/publish.yml`](.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 Trusted Publishing (OIDC)
+
+发布不需要任何 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`。
+
+- 走 OIDC 发布时 npm **自动附带 provenance**（无需 `--provenance`），包页会显示来源证明
+- 想要「tag 推上去还要人工点一下才发」：仓库 Settings → Environments → `npm` → 加 **Required reviewers**；不加也能正常发布
+- 本机手动发布仍可用 granular token 兜底（见上文「安装」第 5 节的 `.npmrc` 用法）
+
 ## 目录结构
 
 ```

package/lib/client.cjs

@@ -29,6 +29,7 @@ const NOTIFY_DEFAULTS = {
 	notifySound: true,
 	notifyVolume: 0.6,
 	notifyAutoHide: true,
+	notifyForeground: false,
 	notifyDoneSound: "builtin-up",
 	notifyPendingSound: "builtin-down"
 };
@@ -441,6 +442,24 @@ function playSound(id, volume, kind) {
 			const notifySound = value.notifySound ?? NOTIFY_DEFAULTS.notifySound;
 			const notifyVolume = normalizeVolume(value.notifyVolume ?? NOTIFY_DEFAULTS.notifyVolume);
 			const notifyAutoHide = value.notifyAutoHide ?? NOTIFY_DEFAULTS.notifyAutoHide;
+			const notifyForeground = value.notifyForeground ?? NOTIFY_DEFAULTS.notifyForeground;
+			/** 音量试听的防抖计时器（拖动过程中不连响，停手后放一遍）。 */
+			const volumeTimer = (0, react.useRef)(void 0);
+			(0, react.useEffect)(() => () => {
+				if (volumeTimer.current !== void 0) clearTimeout(volumeTimer.current);
+			}, []);
+			/** 改音量后试听当前设置的完成提示音：250ms 防抖，只在停手后按新音量放一次。
+			*  primeChime 必须在 onChange 这个用户手势里调，否则防抖后 resume 可能被自动播放策略拦。 */
+			const previewVolume = (next) => {
+				scope.set("notifyVolume", next);
+				primeChime();
+				if (volumeTimer.current !== void 0) clearTimeout(volumeTimer.current);
+				volumeTimer.current = setTimeout(() => {
+					volumeTimer.current = void 0;
+					const snapshot = scope.getSnapshot().value ?? {};
+					playSound(snapshot.notifyDoneSound ?? NOTIFY_DEFAULTS.notifyDoneSound, next, "done");
+				}, 250);
+			};
 			/** 官方设置行规格（对齐「通用设置 → 权限」字段的 row/title/desc 样式）。 */
 			const rowStyle = {
 				display: "flex",
@@ -484,9 +503,16 @@ function playSound(id, volume, kind) {
 				color: "var(--dsw-alias-label-secondary)",
 				cursor: "pointer"
 			};
-			/** 分组条目：主标题 + 描述 + 官方 Switch + 折叠展开箭头（子项由展开态控制显示）。 */
+			/** 分组条目：主标题 + 描述 + 官方 Switch + 折叠展开箭头（子项由展开态控制显示）。
+			*  整行可点：鼠标落在行内任意处都能折叠/展开，不必去够最右边的箭头。
+			*  开关与箭头各自拦住冒泡 —— 否则点开关会连带折叠，点箭头会折叠两次（等于没反应）。
+			*  箭头仍是带 aria-expanded 的真按钮，键盘可达；整行点击只是给鼠标加热区。 */
 			const sectionRow = (key, title, hint, checked, onChange, expanded, onToggle, expandLabel) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-				style: rowStyle,
+				style: {
+					...rowStyle,
+					cursor: "pointer"
+				},
+				onClick: onToggle,
 				children: [
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						style: rowTextStyle,
@@ -501,17 +527,27 @@ function playSound(id, volume, kind) {
 							})
 						]
 					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(primitives.Switch, {
-						checked,
-						label: title,
-						onChange: (next) => onChange(typeof next === "boolean" ? next : !checked)
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						style: {
+							flex: "0 0 auto",
+							display: "inline-flex"
+						},
+						onClick: (event) => event?.stopPropagation?.(),
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(primitives.Switch, {
+							checked,
+							label: title,
+							onChange: (next) => onChange(typeof next === "boolean" ? next : !checked)
+						})
 					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 						type: "button",
 						"aria-expanded": expanded,
 						"aria-label": expandLabel,
 						title: expandLabel,
-						onClick: onToggle,
+						onClick: (event) => {
+							event?.stopPropagation?.();
+							onToggle();
+						},
 						style: iconButtonStyle,
 						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 							style: {
@@ -572,7 +608,7 @@ function playSound(id, volume, kind) {
 						step: 5,
 						value: Math.round(notifyVolume * 100),
 						"aria-label": t("notifyVolume"),
-						onChange: (e) => scope.set("notifyVolume", Number(e.target.value) / 100),
+						onChange: (e) => previewVolume(Number(e.target.value) / 100),
 						style: {
 							flex: "0 0 auto",
 							width: 140,
@@ -716,6 +752,7 @@ function playSound(id, volume, kind) {
 					colorsExpanded ? colorRow("black", t("blackLabel"), () => scope.unset("black")) : null,
 					sectionRow("notifyEnabled", t("groupNotify"), t("notifyEnabledHint"), notifyEnabled, setNotifyEnabled, notifyExpanded, () => setNotifyExpanded((current) => !current), t("notifyExpand")),
 					notifyExpanded ? switchRow("notifyAutoHide", t("notifyAutoHide"), t("notifyAutoHideHint"), notifyAutoHide, (next) => scope.set("notifyAutoHide", next)) : null,
+					notifyExpanded ? switchRow("notifyForeground", t("notifyForeground"), t("notifyForegroundHint"), notifyForeground, (next) => scope.set("notifyForeground", next)) : null,
 					notifyExpanded ? switchRow("notifySound", t("notifySound"), void 0, notifySound, (next) => scope.set("notifySound", next)) : null,
 					notifyExpanded ? volumeRow() : null,
 					notifyExpanded ? soundRow("done", t("notifyDoneSound")) : null,
@@ -747,6 +784,22 @@ function playSound(id, volume, kind) {
 			"locale",
 			"settingsScope"
 		];
+		/**
+		* 本轮用时文案（格式照官方 formatRunDuration：满 60 秒进位到分，秒补零）。
+		* 官方在会话气泡的「本轮用时和速度」里用的是同一套模板，两处读起来一致。
+		* @param ms - 毫秒；负数按 0 处理。
+		* @param t - 命名空间文案函数。
+		* @returns 形如「13秒」/「2分05秒」。
+		*/
+		function formatRunDuration(ms, t) {
+			const total = Math.max(0, Math.floor(ms / 1e3));
+			const minutes = Math.floor(total / 60);
+			const seconds = total % 60;
+			return minutes > 0 ? t("durationMinutes", {
+				minutes,
+				seconds: String(seconds).padStart(2, "0")
+			}) : t("durationSeconds", { seconds });
+		}
 		function apply(ctx) {
 			const list = ctx.sessions.list;
 			/** 绑定 `notice-center` 命名空间：读快照 + 写用户配置（宿主 schema 校验）。 */
@@ -766,6 +819,11 @@ function playSound(id, volume, kind) {
 			let notifyTimer;
 			/** 已通知过的会话完成态，用于识别 false → true 跃迁。 */
 			const prevCompleted = new Map();
+			/** 本轮运行起点（running false→true 时记下）。首次观察时已在跑的会话不记 ——
+			*  那样只能算出「我们看了多久」而不是本轮用时，宁可不出这个数。 */
+			const runStartedAt = new Map();
+			/** 每会话最近一次运行的用时（毫秒）：completed 跃迁那条路径晚于 running 边沿，需要它。 */
+			const lastRunMs = new Map();
 			/** 上一轮待处理会话集合与首帧标记（首帧不通知，避免刷新页面时轰炸）。 */
 			let prevPending = new Set();
 			let pendingSeen = false;
@@ -783,6 +841,7 @@ function playSound(id, volume, kind) {
 					sound: snapshot.notifySound ?? NOTIFY_DEFAULTS.notifySound,
 					volume: normalizeVolume(snapshot.notifyVolume ?? NOTIFY_DEFAULTS.notifyVolume),
 					autoHide: snapshot.notifyAutoHide ?? NOTIFY_DEFAULTS.notifyAutoHide,
+					foreground: snapshot.notifyForeground ?? NOTIFY_DEFAULTS.notifyForeground,
 					doneSound: snapshot.notifyDoneSound ?? NOTIFY_DEFAULTS.notifyDoneSound,
 					pendingSound: snapshot.notifyPendingSound ?? NOTIFY_DEFAULTS.notifyPendingSound
 				};
@@ -793,8 +852,9 @@ function playSound(id, volume, kind) {
 			* @param sessionId - 会话 id。
 			* @param label - 会话显示名；聚合后作为通知**标题**。
 			* @param typeLabel - 通知**正文**（仅 pending 用）：交互类型文案；缺省回退到通用标题。
+			* @param durationMs - 本轮用时（仅 done 用）；算不出起点时传 undefined，正文就不带这个数。
 			*/
-			function queueNotification(kind, sessionId, label, typeLabel) {
+			function queueNotification(kind, sessionId, label, typeLabel, durationMs) {
 				if (!notifyConfig().enabled) return;
 				const key = sessionId + ":" + kind;
 				if (notified.has(key)) return;
@@ -803,7 +863,8 @@ function playSound(id, volume, kind) {
 					kind,
 					sessionId,
 					label,
-					typeLabel
+					typeLabel,
+					durationMs
 				});
 				if (notifyTimer === void 0) notifyTimer = setTimeout(flushNotifications, 300);
 			}
@@ -815,10 +876,10 @@ function playSound(id, volume, kind) {
 				if (entries.length === 0) return;
 				if (notificationSupport() !== "granted") return;
 				const config = notifyConfig();
-				/* 固定策略：只在页面不在前台时打扰（原先的可配置项已移除）。
-				   「前台」= 标签页可见 且 窗口有焦点 —— 只看 visibilityState 会把「浏览器被
-				   别的应用压在后面」误判成正在看，而那正是最该提醒的时候。 */
-				if (isForeground()) return;
+				/* 前台策略：「前台」= 标签页可见 且 窗口有焦点（见 isForeground）。默认只在不在
+				   前台时打扰；开启「前台也提醒」(notifyForeground) 后正在看也弹 —— 用于人还停在
+				   当前会话、却已离开屏幕（刷手机等）的场景。 */
+				if (!config.foreground && isForeground()) return;
 				const t = ctx.locale.bind(SETTINGS_NAMESPACE);
 				const grouped = new Map();
 				for (const entry of entries) {
@@ -832,7 +893,9 @@ function playSound(id, volume, kind) {
 					/* 标题＝会话名（聚合时补「 +N」）；正文＝通知类型。 */
 					let title = head.label ?? head.sessionId;
 					if (extra > 0) title = title + " +" + String(extra);
-					const type = kind === "done" ? t("notifyDoneTitle") : head.typeLabel ?? t("notifyPendingTitle");
+					let type = kind === "done" ? t("notifyDoneTitle") : head.typeLabel ?? t("notifyPendingTitle");
+					/* 用时只在「单独一条完成通知」时附加：聚合时一条正文挂 N 个用时无从表达。 */
+					if (kind === "done" && extra === 0 && head.durationMs !== void 0) type = type + " · " + t("notifyDuration", { duration: formatRunDuration(head.durationMs, t) });
 					try {
 						const notification = new Notification(title, {
 							body: type,
@@ -864,15 +927,39 @@ function playSound(id, volume, kind) {
 				question: "pendingKindQuestion",
 				"plan-review": "pendingKindPlanReview"
 			};
+			/** 工具名上限：超长会撑破通知正文（Windows 通知一两行就截断），超出截断加省略号。 */
+			const TOOL_NAME_LIMIT = 32;
 			/**
-			* 待处理交互类型 → 通知正文文案（如「待审批」）。
-			* 未知类型返回 undefined，调用方回退到通用标题 —— 官方新增交互域时不会显示错误的类型名。
-			* @param interactionKind - pendingInteraction 的 kind 字段。
-			* @returns 类型文案；未知类型为 undefined。
+			* 待处理交互 → 通知正文文案。
+			*
+			* kind 只到「审批 / 提问 / 计划待审核」这一层（官方 SessionPendingInteractionStatus
+			* 就这三种），更细的信息在 entry 的 domain 字段上：审批的 toolName、提问的 questions
+			* 批次。这里读这些字段做细化，**全部防御式读取** —— bundle 不 import 那些类型，
+			* 字段缺席、类型不符（第三方域自造 kind）时逐级降级，绝不显示错误的类型名。
+			* @param interaction - pendingInteractions 的 entry；缺席时为 undefined。
+			* @returns 正文文案；完全认不出时 undefined，调用方回退「有交互等待处理」。
 			*/
-			function pendingTypeLabel(interactionKind) {
-				const key = PENDING_KIND_KEYS[interactionKind];
-				return key === void 0 ? void 0 : ctx.locale.bind(SETTINGS_NAMESPACE)(key);
+			function pendingTypeLabel(interaction) {
+				const t = ctx.locale.bind(SETTINGS_NAMESPACE);
+				const kind = interaction?.kind;
+				if (kind === "approval") {
+					const tool = interaction.toolName;
+					if (typeof tool !== "string" || tool === "") return t("pendingKindApproval");
+					const shown = tool.length > TOOL_NAME_LIMIT ? tool.slice(0, TOOL_NAME_LIMIT) + "…" : tool;
+					return t("pendingApprovalTool", { tool: shown });
+				}
+				if (kind === "question") {
+					const questions = Array.isArray(interaction.questions) ? interaction.questions : [];
+					if (questions.length > 1) return t("pendingQuestionBatch", { count: questions.length });
+					const first = questions[0];
+					/* 只有一条也要能读出「要不要动键盘」：有选项＝选择，无选项＝自己写。 */
+					if (first === null || typeof first !== "object") return t("pendingKindQuestion");
+					const options = Array.isArray(first.options) ? first.options : [];
+					if (options.length === 0) return t("pendingQuestionFill");
+					return first.multiSelect === true ? t("pendingQuestionMulti") : t("pendingQuestionChoose");
+				}
+				const key = PENDING_KIND_KEYS[kind];
+				return key === void 0 ? void 0 : t(key);
 			}
 			/** 状态跃迁检测：官方 completed 由 false 变 true、以及 pending store 新增会话。 */
 			function detectTransitions(state) {
@@ -880,7 +967,7 @@ function playSound(id, volume, kind) {
 					if (row.origin === "subagent") continue;
 					const before = prevCompleted.get(row.id);
 					const now = row.completed === true;
-					if (before === false && now) queueNotification("done", row.id, row.displayTitle ?? row.title ?? row.id);
+					if (before === false && now) queueNotification("done", row.id, row.displayTitle ?? row.title ?? row.id, void 0, lastRunMs.get(row.id));
 					if (!now) notified.delete(row.id + ":done");
 					prevCompleted.set(row.id, now);
 				}
@@ -895,7 +982,7 @@ function playSound(id, volume, kind) {
 					const row = state.byId[id];
 					if (row !== void 0 && row.origin === "subagent") continue;
 					const label = row?.displayTitle ?? row?.title ?? id;
-					queueNotification("pending", id, label, pendingTypeLabel(pendingMap?.get(id)?.kind));
+					queueNotification("pending", id, label, pendingTypeLabel(pendingMap?.get(id)));
 				}
 				for (const id of prevPending) if (!current.has(id)) notified.delete(id + ":pending");
 				prevPending = current;
@@ -980,10 +1067,11 @@ function playSound(id, volume, kind) {
 				};
 			}
 			const uri = (hex) => `data:image/svg+xml,${encodeURIComponent(whaleSvg(hex))}`;
-			/** running true→false 边沿跟踪：完成时恰好被选中且标签页不在台前 →
-			*  记入 finishedWhileHidden。官方 syncCompletedNotifications 只报"未选中时
-			*  完成"（`sessionId !== selected` 才 arm），选中的空缺在这里补齐。
-			*  台前完成不记（V0-02）；重新运行、会话移除均清除；只跟踪主会话。 */
+			/** running true→false 边沿跟踪（只跟踪主会话）：完成时恰好被选中 →
+			*  绿灯记入 finishedWhileHidden（仅当标签页不在台前；台前完成不记，V0-02）；
+			*  通知则无条件入队，由 flush 按「前台也提醒」统一裁决。官方 syncCompletedNotifications
+			*  只报"未选中时完成"（`sessionId !== selected` 才 arm），选中的空缺在这里补齐。
+			*  重新运行、会话移除均清除。 */
 			function trackEdges(state) {
 				for (const row of Object.values(state.byId)) {
 					if (row.origin === "subagent") continue;
@@ -992,17 +1080,25 @@ function playSound(id, volume, kind) {
 						prevRunning.set(row.id, row.running);
 						continue;
 					}
+					if (!prev && row.running) runStartedAt.set(row.id, Date.now());
 					if (prev && !row.running) {
-						if (row.id === state.current && !isForeground()) {
-							finishedWhileHidden.add(row.id);
-							queueNotification("done", row.id, row.displayTitle ?? row.title ?? row.id);
-						}
+						const startedAt = runStartedAt.get(row.id);
+						const elapsed = startedAt === void 0 ? void 0 : Date.now() - startedAt;
+						runStartedAt.delete(row.id);
+						if (elapsed !== void 0) lastRunMs.set(row.id, elapsed);
+						/* 绿灯只记「没看着时跑完」；台前完成不记（V0-02）。 */
+						if (row.id === state.current && !isForeground()) finishedWhileHidden.add(row.id);
+						/* 通知另算：选中会话完成时官方不置 completed，这条是它的唯一来源，
+						   因此「前台要不要打扰」交给 flush 按 notifyForeground 统一裁决。 */
+						if (row.id === state.current) queueNotification("done", row.id, row.displayTitle ?? row.title ?? row.id, void 0, elapsed);
 					} else if (row.running) finishedWhileHidden.delete(row.id);
 					prevRunning.set(row.id, row.running);
 				}
 				for (const id of [...prevRunning.keys()]) if (!(id in state.byId)) {
 					prevRunning.delete(id);
 					finishedWhileHidden.delete(id);
+					runStartedAt.delete(id);
+					lastRunMs.delete(id);
 				}
 			}
 			/** 回到前台（标签页可见且窗口有焦点）→ 选中会话的绿灯熄灭（V0-02）。 */
@@ -1015,18 +1111,21 @@ function playSound(id, volume, kind) {
 			};
 			document.addEventListener("visibilitychange", onForeground);
 			window.addEventListener("focus", onForeground);
-			/** 绿/琥珀判定：主会话 only；绿优先。返回目标 href；null = 官方原版。 */
+			/** 绿/琥珀判定：主会话 only；**琥珀优先于绿**。返回目标 href；null = 官方原版。 */
 			function targetOf(state) {
 				if ((scope.getSnapshot().value ?? {}).colorsEnabled === false) return null;
 				const c = colors();
 				const pendingMap = pendingStore?.getSnapshot();
-				let amber = false;
+				let green = false;
+				/* 顺序照官方 sessionStatuses：pending interaction 是首要状态，live activity
+				   压过 completion reminder。favicon 是跨会话聚合，套用同一原则 —— 任意会话
+				   「卡住等你」都压过任意会话「跑完了」，否则审批会被完成提醒整片掩盖。 */
 				for (const row of Object.values(state.byId)) {
 					if (row.origin === "subagent") continue;
-					if (row.completed === true || finishedWhileHidden.has(row.id)) return uri(c.green);
-					if (pendingMap?.has(row.id) || row.pendingInteraction !== void 0) amber = true;
+					if (pendingMap?.has(row.id) || row.pendingInteraction !== void 0) return uri(c.amber);
+					if (row.completed === true || finishedWhileHidden.has(row.id)) green = true;
 				}
-				if (amber) return uri(c.amber);
+				if (green) return uri(c.green);
 				return c.black ? uri(c.black) : null;
 			}
 			function sync() {
@@ -1077,6 +1176,8 @@ trackEdges(state);
 					notifySound: "提示音",
 					notifyAutoHide: "自动隐藏",
 					notifyAutoHideHint: "关闭后通知常驻，需手动关闭",
+					notifyForeground: "前台提醒",
+					notifyForegroundHint: "开启后，即使你正看着该页面也会提醒",
 					notifyVolume: "音量",
 					notifyDoneSound: "完成提示音",
 					notifyPendingSound: "待处理提示音",
@@ -1088,9 +1189,17 @@ trackEdges(state);
 					permissionUnsupported: "当前浏览器不支持系统通知",
 					notifyDoneTitle: "会话已完成",
 					notifyPendingTitle: "有交互等待处理",
+					notifyDuration: "本轮总用时 {duration}",
+					durationSeconds: "{seconds}秒",
+					durationMinutes: "{minutes}分{seconds}秒",
 					pendingKindApproval: "待审批",
 					pendingKindQuestion: "向你提问",
 					pendingKindPlanReview: "计划待审核",
+					pendingApprovalTool: "待审批 · {tool}",
+					pendingQuestionChoose: "请你选择",
+					pendingQuestionMulti: "请你多选",
+					pendingQuestionFill: "请你填写",
+					pendingQuestionBatch: "向你提问（{count} 个）",
 				},
 				en: {
 					nav: "Notification center",
@@ -1110,6 +1219,8 @@ trackEdges(state);
 					notifySound: "Sound",
 					notifyAutoHide: "Auto hide",
 					notifyAutoHideHint: "Off keeps it on screen until you close it",
+					notifyForeground: "Notify in the foreground",
+					notifyForegroundHint: "Also notify while you are looking at the page",
 					notifyVolume: "Volume",
 					notifyDoneSound: "Done sound",
 					notifyPendingSound: "Pending sound",
@@ -1121,9 +1232,17 @@ trackEdges(state);
 					permissionUnsupported: "This browser does not support notifications",
 					notifyDoneTitle: "Session finished",
 					notifyPendingTitle: "Something awaits you",
+					notifyDuration: "turn took {duration}",
+					durationSeconds: "{seconds}s",
+					durationMinutes: "{minutes}m{seconds}s",
 					pendingKindApproval: "Approval needed",
 					pendingKindQuestion: "Question",
 					pendingKindPlanReview: "Plan review",
+					pendingApprovalTool: "Approval · {tool}",
+					pendingQuestionChoose: "Choose an option",
+					pendingQuestionMulti: "Choose options",
+					pendingQuestionFill: "Type an answer",
+					pendingQuestionBatch: "{count} questions",
 				}
 			}));
 			ctx.slots.inject("settings.section", () => {

package/lib/index.mjs

@@ -48,6 +48,8 @@ const NoticeSettingsSchema = z.object({
 	notifyEnabled: z.boolean().default(false),
 	/** 通知是否自动隐藏（默认 true＝系统自行收起；false＝常驻，需用户手动关闭）。 */
 	notifyAutoHide: z.boolean().default(true),
+	/** 前台也提醒（默认 false＝沿用原固定策略，页面在前台时保持安静；true＝正在看也弹）。 */
+	notifyForeground: z.boolean().default(false),
 	/** 通知提示音：完成与待处理为两种不同的预置音。 */
 	notifySound: z.boolean().default(true),
 	/** 提示音音量（0–1）。 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-notice-center",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "DeepSeek Harness 通知中心：标签页鲸鱼状态灯（绿=跑完 / 琥珀=待处理）+ 浏览器系统通知（完成/待处理提示、45 个 opencode 音效可选、音量可配）。",
   "type": "module",
   "scripts": {
@@ -26,7 +26,8 @@
     "cordis.patch.yml",
     "assets",
     "LICENSE",
-    "README.md"
+    "README.md",
+    "README.en.md"
   ],
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.2"