dsh-chime-sound 0.2.0 → 0.3.2

package/CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+## 0.3.2 (2026-09-13)
+
+- 文档：README 顶部加 CI 状态徽章；发布章节写明走 npm 可信发布（OIDC），仓库内不存放令牌
+
+## 0.3.1 (2026-09-13)
+
+- 文档拆分为中英双版：`README.md` 改为英文（面向 npm / 插件市场的规范形态），中文原文迁入新增的 `README.zh.md`，两版顶部互相链接
+- 两版 README 均按公开文档规范改写：去掉人设称呼与内部路径，只描述功能与行为（设置卡片本来就已中英双语，本次未改代码）
+- `package.json` 的 `files` 补入 `README.zh.md` 与 `CHANGELOG.md`，避免文档在发布包里缺失
+
+## 0.3.0 (2026-09-12)
+
+- 新增 5 组音效:g5 清亮铃声 / g6 气泡水滴 / g7 街机电子 / g8 木质马林巴 / g9 柔和电子 — 四个设置项的选择列表各新增 5 个选项(g1-g9)
+- g5-g9 取自 [Freesound](https://freesound.org) 的 **CC0 1.0** 素材(20 条,每条情景各自一条),按情景语义挑选:完成·聚焦为「完成感」音,完成·未聚焦为更短变体,提问·聚焦为提示答问音,提问·未聚焦为最短提示
+- 素材处理链:mpg123(WASM)解码 Freesound 预览 MP3 → 合单声道 → DC 去除 → 按情景裁剪(≤1.25s / 0.75s / 0.95s / 0.60s,截断时淡出 200ms)→ 50ms 短时 RMS 归一至 −6.5 dBFS,超过 −3 dBFS 处软限幅(tanh)→ 48 kHz / 16-bit / 单声道 WAV
+- 新增 `assets/sounds/CREDITS.md`:逐条记录采样出处(Freesound 页面链接)、作者与授权,并写明转换参数
+- 响度校准:新素材峰值 −3 dBFS、整段 RMS 均值 −14.4 dBFS、50ms 短时 RMS 均值 −9.0 dBFS,与 g1-g4(−14.1 / −8.0)基本一致
+
+## 0.2.0 (2026-09-07)
+
+- 新增主音量设置：0%~150%，5% 步进（31 档），默认 100%（与原音量一致）；设置页「提示音效 → 音量 / Volume」←/→ 单按 ±5%、长按连续调节，修改后立即试听
+- 播放链路改为内存增益：新增 `lib/wav.js`（PCM 16-bit 样本增益 + 饱和削波），`PlaySoundW` SND_MEMORY 播放 + 8 槽播放池，>100% 时 16-bit 饱和削波
+- 插件改名：`dsh-notice-sound` → `dsh-chime` → npm 发布名 **`dsh-chime-sound`**（manifest id 保持 `com.dsh-tui.chime`，cordis 挂载 id `chime`，设置命名空间 `chime`）
+- 非 Windows 平台明确降级：仅 Win32（winmm/user32）可播放，其他平台静默 no-op + 警告日志
+
+## 0.1.1 (2026-09-06)
+
+- 修复事件源：改用 `session/event` cordis bus（无需 host admission），替代被拒的 `tuiMessageObserver.subscribe`
+- 焦点判定修正：GetForegroundWindow 句柄 + 窗口类名（CASCADIA_HOSTING_WINDOW_CLASS / ConsoleWindowClass）双判据
+
+## 0.1.0 (2026-09-06)
+
+- 首个版本：完成/提问提示音，4 组音效 × 4 情景，设置页「提示音效」类，中英双语

package/README.md

@@ -1,57 +1,70 @@
 # dsh-chime-sound
 
-dsh-tui 提示音效插件（原名 dsh-notice-sound，2026-09-07 更名）/ Notification sounds for dsh-tui.
+[![ci](https://github.com/VviLliAm-qwq/dsh-chime/actions/workflows/ci.yml/badge.svg)](https://github.com/VviLliAm-qwq/dsh-chime/actions/workflows/ci.yml)
 
-- 触发:女仆调用询问模块 `ask_user_question`(`session/event` `tool/call`,提醒主人回来回答问题)与回复完成(`session/event` `turn/end`,agent-loop 每回合仅发一次;`assistant/message` 会随每个工具步骤多次触发,不采用),区分终端聚焦/未聚焦
-- 4 组音效(清脆电子 / 木质敲击 / 八比特 / 温馨钢琴)× 4 情景,设置页「提示音效」类中可选择或关闭
-- **0.2.0 新增:主音量设置**(设置页「音量 / Volume」项):0%~150%,每档 5%(31 档),默认 100% = 原音量。←/→ 单按 ±5%,**长按连续调节**(dsh-tui 输入层把长按重复展开为逐档事件,无需额外配置);修改后立即试听。>100% 时样本做 16-bit 饱和削波(峰值约 105%,仅极短时段削波;如需无失真可后续改软限幅)。音量仅在插件内部对 WAV 样本增益,不影响系统音量
-- 音效由本仓库 `scripts/gen-sounds.mjs` 生成(WAV,16-bit/48kHz)
-- 设置与文案支持中英文
+**English** · [中文](README.zh.md)
 
-## ⚠️ 平台限制（Windows only）
+Notification sounds for dsh-tui (originally named dsh-notice-sound, renamed on 2026-09-07).
 
-本插件通过 **Win32 API**（koffi → `winmm.dll` `PlaySoundW` / `user32.dll` 焦点检测）播放声音，**仅支持 Windows（Windows Terminal / conhost）**。其他平台（Linux/macOS）上插件静默降级为 no-op（不播放、不拖垮启动），并在日志中给出 `Win32-only` 警告。请勿在非 Windows 环境期待提示音。
+- **Triggers:** the agent calling `ask_user_question` (`session/event` `tool/call` — a nudge to come back and answer) and a reply finishing (`session/event` `turn/end`; agent-loop emits this once per turn, while `assistant/message` fires on every tool step and is deliberately not used). Both distinguish a focused from an unfocused terminal.
+- **9 sound groups × 4 situations**, selectable (or off) in the settings page's “Notice Sounds” section: g1 Crisp / g2 Wood / g3 Chiptune / g4 Warm (synthesised in code), g5 Bell / g6 Bubble / g7 Arcade / g8 Marimba / g9 Soft Synth (CC0 samples).
+- **New in 0.2.0 — master volume** (the “Volume” field): 0–150% in 5% steps (31 steps), default 100% = the original level. `←/→` steps 5%; **holding the key repeats**, because dsh-tui's input layer expands the auto-repeat into per-step events. The new level is auditioned immediately. Above 100% the samples are 16-bit saturated (peak ≈ 105%, clipping only for very short stretches). The gain is applied to the WAV samples inside the plugin and never touches system volume.
+- g1–g4 are synthesised by this repository's `scripts/gen-sounds.mjs` (WAV, 16-bit / 48 kHz); g5–g9 are [Freesound](https://freesound.org) **CC0 1.0** material, decoded and then trimmed, faded and loudness-normalised to the same format. Sources and conversion parameters are recorded in `assets/sounds/CREDITS.md` (CC0 needs no attribution and may be redistributed with this plugin).
+- Settings and copy are bilingual (Chinese/English); the settings card is localised by the host according to the language dsh-tui's `/lang` selected.
 
-## 安装
+## ⚠️ Platform support (Windows only)
 
-**方式一（dsh CLI，推荐）：**
+Sound is played through **Win32 APIs** (koffi → `winmm.dll` `PlaySoundW`, with focus detection via `user32.dll`), so this plugin is **Windows-only** (Windows Terminal and classic conhost). On Linux and macOS it degrades silently to a no-op — no sound, no boot failure — and logs a `Win32-only` warning. Do not expect notification sounds elsewhere.
+
+## Install
+
+**Option 1 — dsh CLI (recommended):**
 
 ```sh
 dsh plugin --profile <profile> add dsh-chime-sound
 ```
 
-（或从 dsh 插件市场 / GitHub 安装：`dsh plugin add github:VviLliAm-qwq/dsh-chime`。）
+(Or from the dsh plugin market / GitHub: `dsh plugin add github:VviLliAm-qwq/dsh-chime`.)
 
-**方式二（手动，与生态常见流程一致）：**
+**Option 2 — manual:**
 
-1. 把插件包复制到 `~/.dsh/profiles/dsh-tui/node_modules/dsh-chime-sound/`
-2. 在 `~/.dsh/profiles/dsh-tui/package.json` 的 `dsh.profile.bundles` 追加 `"dsh-chime-sound"`（声明了 `dsh.bundle.patch`，启动时自动挂载）
-3. 重启 dsh-tui（`/restart`）生效
+1. Copy the package to `~/.dsh/profiles/dsh-tui/node_modules/dsh-chime-sound/`
+2. Append `"dsh-chime-sound"` to `dsh.profile.bundles` in `~/.dsh/profiles/dsh-tui/package.json` (the package declares `dsh.bundle.patch`, so it mounts itself at boot)
+3. Restart dsh-tui (`/restart`)
 
-**兼容性**：dsh-tui 0.10.x（`ctx.tuiSettingsSections` / `session/event` 软探测接缝）；dsh 0.1.2-rc.1+；Node `^22.19 || >=24`；纯 ESM。配置键均有默认值，缺配置时行为退化为"什么都不发生"。
+**Compatibility:** dsh-tui 0.10.x (the `ctx.tuiSettingsSections` and `session/event` seams, both soft-probed); dsh 0.1.2-rc.1+; Node `^22.19 || >=24`; pure ESM. Every configuration key has a default, and a missing configuration degrades to “nothing happens”.
 
-## 配置
+## Configuration
 
-设置项在 dsh-tui 设置页「提示音效 / Notice Sounds」类（或 `~/.dsh/settings.yaml` 的 `chime:` 命名空间）：
+The settings live in dsh-tui's “Notice Sounds” section (or the `chime:` namespace of `~/.dsh/settings.yaml`):
 
 ```yaml
 chime:
-  doneFocus: g2   # 完成对话·聚焦时: g1-g4 / off
-  doneBlur: g2    # 完成对话·未聚焦时
-  askFocus: g2    # 提问·聚焦时
-  askBlur: g2     # 提问·未聚焦时
-  volume: "50"    # 0-150, 5% 步进, 默认 "100"
+  doneFocus: g2   # reply finished, terminal focused: g1-g9 / off
+  doneBlur: g2    # reply finished, terminal unfocused
+  askFocus: g2    # question asked, terminal focused
+  askBlur: g2     # question asked, terminal unfocused
+  volume: "50"    # 0-150, 5% steps, default "100"
 ```
 
-## 事件源说明(0.1.1 修复)
+## Why `session/event` and not the message observer
+
+dsh-tui's mediated `tuiMessageObserver.subscribe()` is unusable here: the API requires the activation to hold a verified Component identity through host admission, and a plugin mounted by a bundle patch never goes through admission — its subscriptions are refused (`COMPONENT_NOT_ADMITTED`) and no sound ever plays.
+
+This plugin therefore listens on the `session/event` cordis bus published by `@deepseek-ai/dsh-session` (the same channel the official `dsh-working-activity` extension uses), which needs no Component identity:
+
+- `tool/call` with `name === 'ask_user_question'` → the question sound (askFocus / askBlur)
+- `turn/end` → the completion sound (doneFocus / doneBlur); subagent sessions are ignored
+- **Focus detection:** the `GetForegroundWindow` handle equals `GetConsoleWindow`, or the window class matches (`CASCADIA_HOSTING_WINDOW_CLASS` = Windows Terminal, `ConsoleWindowClass` = classic conhost). Under ConPTY `GetConsoleWindow` returns a hidden `PseudoConsoleWindow` that is never foreground, so the earlier handle-only and class-only readings were both flawed; the check is now a pair of criteria with a corrected class read.
+- `dsh-plugin.json` no longer declares the unused `messages.observe` capability.
+
+Restart dsh-tui after installing.
 
-此前用 dsh-tui 的 mediated `tuiMessageObserver.subscribe()` 订阅消息事件,但该 API 要求插件激活先通过 host admission 绑定已验证的 Component 身份;bundle-patch 挂载的插件不经过 admission,所有订阅被拒绝(`COMPONENT_NOT_ADMITTED`),导致提示音完全不触发。
+## Publishing
 
-0.1.1 改用 `@deepseek-ai/dsh-session` 发布的 `session/event` cordis bus 事件(官方 `dsh-working-activity` 扩展同款通道),无需 Component identity:
+- **Repository**: <https://github.com/VviLliAm-qwq/dsh-chime> (public)
+- **Release**: `v*` tags drive `.github/workflows/release.yml`, which publishes to npm through **trusted publishing (OIDC)** — no token is stored in the repository.
 
-- `tool/call` 且 `name === 'ask_user_question'` → 提问音(askFocus/askBlur)
-- `turn/end` → 完成音(doneFocus/doneBlur),子代理会话不触发
-- 焦点判定:GetForegroundWindow 句柄 == GetConsoleWindow 或窗口类名匹配(`CASCADIA_HOSTING_WINDOW_CLASS`=Windows Terminal / `ConsoleWindowClass`=传统 conhost)。ConPTY 下 GetConsoleWindow 返回隐藏的 `PseudoConsoleWindow`(永非前台),旧代码仅按句柄/类名读法均有缺陷,现双判据+修正的类名读取
-- `dsh-plugin.json` 已移除不再使用的 `messages.observe` 声明
+## License
 
-安装后需重启 dsh-tui 生效。
+MIT — see [LICENSE](LICENSE). Sound assets are licensed and attributed in `assets/sounds/CREDITS.md`.

package/README.zh.md

@@ -0,0 +1,70 @@
+# dsh-chime-sound
+
+[![ci](https://github.com/VviLliAm-qwq/dsh-chime/actions/workflows/ci.yml/badge.svg)](https://github.com/VviLliAm-qwq/dsh-chime/actions/workflows/ci.yml)
+
+**中文** · [English](README.md)
+
+dsh-tui 提示音效插件（原名 dsh-notice-sound，2026-09-07 更名）。
+
+- 触发：代理调用询问模块 `ask_user_question`（`session/event` `tool/call`，提醒用户回来回答问题）与回复完成（`session/event` `turn/end`，agent-loop 每回合仅发一次；`assistant/message` 会随每个工具步骤多次触发，不采用），并区分终端聚焦 / 未聚焦。
+- 9 组音效 × 4 情景，设置页「提示音效」类中可选择或关闭：g1 清脆电子 / g2 木质敲击 / g3 八比特 / g4 温馨钢琴（代码合成），g5 清亮铃声 / g6 气泡水滴 / g7 街机电子 / g8 木质马林巴 / g9 柔和电子（CC0 采样）。
+- **0.2.0 新增：主音量设置**（设置页「音量 / Volume」项）：0%~150%，每档 5%（31 档），默认 100% = 原音量。`←/→` 单按 ±5%，**长按连续调节**（dsh-tui 输入层把长按重复展开为逐档事件，无需额外配置）；修改后立即试听。>100% 时样本做 16-bit 饱和削波（峰值约 105%，仅极短时段削波）。音量只在插件内部对 WAV 样本增益，不影响系统音量。
+- g1-g4 由本仓库 `scripts/gen-sounds.mjs` 合成（WAV，16-bit / 48 kHz）；g5-g9 为 [Freesound](https://freesound.org) **CC0 1.0** 素材，解码后裁剪、淡入淡出、响度校准为同规格 WAV，出处与转换参数见 `assets/sounds/CREDITS.md`（CC0 无需署名、可随本插件再分发）。
+- 设置与文案均支持中英文；界面语言跟随 dsh-tui 的 `/lang`（设置卡片的文案由宿主按当前语言渲染）。
+
+## ⚠️ 平台限制（Windows only）
+
+本插件通过 **Win32 API**（koffi → `winmm.dll` `PlaySoundW` / `user32.dll` 焦点检测）播放声音，**仅支持 Windows（Windows Terminal / conhost）**。其他平台（Linux / macOS）上插件静默降级为 no-op（不播放、不拖垮启动），并在日志中给出 `Win32-only` 警告。请勿在非 Windows 环境期待提示音。
+
+## 安装
+
+**方式一（dsh CLI，推荐）：**
+
+```sh
+dsh plugin --profile <profile> add dsh-chime-sound
+```
+
+（或从 dsh 插件市场 / GitHub 安装：`dsh plugin add github:VviLliAm-qwq/dsh-chime`。）
+
+**方式二（手动）：**
+
+1. 把插件包复制到 `~/.dsh/profiles/dsh-tui/node_modules/dsh-chime-sound/`
+2. 在 `~/.dsh/profiles/dsh-tui/package.json` 的 `dsh.profile.bundles` 追加 `"dsh-chime-sound"`（该包声明了 `dsh.bundle.patch`，启动时自动挂载）
+3. 重启 dsh-tui（`/restart`）生效
+
+**兼容性**：dsh-tui 0.10.x（`ctx.tuiSettingsSections` / `session/event` 软探测接缝）；dsh 0.1.2-rc.1+；Node `^22.19 || >=24`；纯 ESM。配置键均有默认值，缺配置时行为退化为「什么都不发生」。
+
+## 配置
+
+设置项在 dsh-tui 设置页「提示音效 / Notice Sounds」类（或 `~/.dsh/settings.yaml` 的 `chime:` 命名空间）：
+
+```yaml
+chime:
+  doneFocus: g2   # 完成对话·聚焦时: g1-g9 / off
+  doneBlur: g2    # 完成对话·未聚焦时
+  askFocus: g2    # 提问·聚焦时
+  askBlur: g2     # 提问·未聚焦时
+  volume: "50"    # 0-150, 5% 步进, 默认 "100"
+```
+
+## 事件源说明
+
+dsh-tui 的 mediated `tuiMessageObserver.subscribe()` 对本插件不可用：该 API 要求插件激活先通过 host admission 绑定已验证的 Component 身份，bundle-patch 挂载的插件不经过 admission，订阅会被拒绝（`COMPONENT_NOT_ADMITTED`），提示音完全不触发。
+
+改用 `@deepseek-ai/dsh-session` 发布的 `session/event` cordis bus 事件（官方 `dsh-working-activity` 扩展同款通道），无需 Component identity：
+
+- `tool/call` 且 `name === 'ask_user_question'` → 提问音（askFocus / askBlur）
+- `turn/end` → 完成音（doneFocus / doneBlur），子代理会话不触发
+- 焦点判定：`GetForegroundWindow` 句柄 == `GetConsoleWindow`，或窗口类名匹配（`CASCADIA_HOSTING_WINDOW_CLASS` = Windows Terminal / `ConsoleWindowClass` = 传统 conhost）。ConPTY 下 `GetConsoleWindow` 返回隐藏的 `PseudoConsoleWindow`（永非前台），旧代码仅按句柄或仅按类名读取都有缺陷，现为双判据 + 修正的类名读取
+- `dsh-plugin.json` 已移除不再使用的 `messages.observe` 声明
+
+安装后需重启 dsh-tui 生效。
+
+## 发布
+
+- **仓库**：<https://github.com/VviLliAm-qwq/dsh-chime>（公开）
+- **发布方式**：`v*` tag 驱动 `.github/workflows/release.yml`，经 npm **可信发布（OIDC）**上传——仓库内不存放任何令牌。
+
+## 许可
+
+MIT — 见 [LICENSE](LICENSE)。音效素材的授权与出处见 `assets/sounds/CREDITS.md`。

package/assets/sounds/CREDITS.md

@@ -0,0 +1,54 @@
+# 音效来源 / Sound Credits
+
+`g1`–`g4` 由本仓库 `scripts/gen-sounds.mjs` 纯代码合成，不含第三方素材。
+
+`g5`–`g9` 取自 [Freesound](https://freesound.org) 的 **CC0 1.0（Creative Commons Zero，公有领域献出）** 素材：CC0 允许任意使用与再分发、无需署名，因此可以随本插件（MIT）一同发布；下表列出出处仅为可追溯与致谢。
+
+转换流程：Freesound 预览 MP3 → mpg123（WASM）解码 → 合单声道 → DC 去除 → 按情景裁剪（完成·聚焦 ≤1.25s、完成·未聚焦 ≤0.75s、提问·聚焦 ≤0.95s、提问·未聚焦 ≤0.60s）→ 淡入 5ms / 淡出 80–200ms（截断时 200ms）→ 50ms 短时 RMS 归一到 −6.5 dBFS、超过 −3 dBFS 处软限幅 → 48 kHz / 16-bit / 单声道 WAV。
+
+## g5 Bell / 清亮铃声
+
+| 文件 | 情景 | 原始音效 | 作者 | 出处 |
+|---|---|---|---|---|
+| `g5-done-focus.wav` | 完成·聚焦 | Glass Ding / Toast with champagne glasses | Breviceps | [freesound](https://freesound.org/people/Breviceps/sounds/458408) |
+| `g5-done-blur.wav` | 完成·未聚焦 | Small Bell | steffcaffrey | [freesound](https://freesound.org/people/steffcaffrey/sounds/452371) |
+| `g5-ask-focus.wav` | 提问·聚焦 | Chime Notification | Jofae | [freesound](https://freesound.org/people/Jofae/sounds/380482) |
+| `g5-ask-blur.wav` | 提问·未聚焦 | Ding 1 | greenvwbeetle | [freesound](https://freesound.org/people/greenvwbeetle/sounds/241288) |
+
+## g6 Bubble / 气泡水滴
+
+| 文件 | 情景 | 原始音效 | 作者 | 出处 |
+|---|---|---|---|---|
+| `g6-done-focus.wav` | 完成·聚焦 | bubbles-03.aif | kijjaz | [freesound](https://freesound.org/people/kijjaz/sounds/16738) |
+| `g6-done-blur.wav` | 完成·未聚焦 | The Best Bubble Pop Sound For Game and UI | el_boss | [freesound](https://freesound.org/people/el_boss/sounds/669918) |
+| `g6-ask-focus.wav` | 提问·聚焦 | bubble sound | Ranner | [freesound](https://freesound.org/people/Ranner/sounds/487532) |
+| `g6-ask-blur.wav` | 提问·未聚焦 | Retro, Bubble Shot 01.wav | MATRIXXX_ | [freesound](https://freesound.org/people/MATRIXXX_/sounds/458906) |
+
+## g7 Arcade / 街机电子
+
+| 文件 | 情景 | 原始音效 | 作者 | 出处 |
+|---|---|---|---|---|
+| `g7-done-focus.wav` | 完成·聚焦 | Retro 'Accomplished' SFX | suntemple | [freesound](https://freesound.org/people/suntemple/sounds/253177) |
+| `g7-done-blur.wav` | 完成·未聚焦 | 8-Bit Coin | TheDweebMan | [freesound](https://freesound.org/people/TheDweebMan/sounds/277215) |
+| `g7-ask-focus.wav` | 提问·聚焦 | 8-bit Happy Ding | JapanYoshiTheGamer | [freesound](https://freesound.org/people/JapanYoshiTheGamer/sounds/361264) |
+| `g7-ask-blur.wav` | 提问·未聚焦 | 8-Bit Text Blip - High Pitch | SomeGuy22 | [freesound](https://freesound.org/people/SomeGuy22/sounds/431328) |
+
+## g8 Marimba / 木质马林巴
+
+| 文件 | 情景 | 原始音效 | 作者 | 出处 |
+|---|---|---|---|---|
+| `g8-done-focus.wav` | 完成·聚焦 | marimba sequence | PhonosUPF | [freesound](https://freesound.org/people/PhonosUPF/sounds/488154) |
+| `g8-done-blur.wav` | 完成·未聚焦 | XYLOPHONE D4.wav | juancamiloorjuela | [freesound](https://freesound.org/people/juancamiloorjuela/sounds/204645) |
+| `g8-ask-focus.wav` | 提问·聚焦 | Kalimba C3 | dvdfu | [freesound](https://freesound.org/people/dvdfu/sounds/536549) |
+| `g8-ask-blur.wav` | 提问·未聚焦 | Popsicle Stick Pluck | BluetoothBoy | [freesound](https://freesound.org/people/BluetoothBoy/sounds/269335) |
+
+## g9 Soft synth / 柔和电子
+
+| 文件 | 情景 | 原始音效 | 作者 | 出处 |
+|---|---|---|---|---|
+| `g9-done-focus.wav` | 完成·聚焦 | Beep 03 Positive | PaulMorek | [freesound](https://freesound.org/people/PaulMorek/sounds/330046) |
+| `g9-done-blur.wav` | 完成·未聚焦 | Notification | Fupicat | [freesound](https://freesound.org/people/Fupicat/sounds/538149) |
+| `g9-ask-focus.wav` | 提问·聚焦 | [UI Sound] Approval - High Pitched Bell Synth | GabFitzgerald | [freesound](https://freesound.org/people/GabFitzgerald/sounds/625174) |
+| `g9-ask-blur.wav` | 提问·未聚焦 | Blip or Select | Jofae | [freesound](https://freesound.org/people/Jofae/sounds/379339) |
+
+全部素材均为 CC0 1.0，无署名义务；出处以各 Freesound 原始页面为准。

package/dsh-plugin.json

@@ -3,7 +3,7 @@
   "manifestVersion": "0.15",
   "id": "com.dsh-tui.chime",
   "name": "chime",
-  "version": "0.2.0",
+  "version": "0.3.2",
   "facets": {
     "host": {
       "entry": "lib/index.js",

package/lib/index.js

@@ -7,7 +7,9 @@
  *     "user has to answer, come back" cue
  *   - the assistant turn finishes    (session/event `turn/end`)
  * with separate variants for focused vs unfocused terminal windows.
- * Four sound groups (g1 crisp / g2 wood / g3 chiptune / g4 warm) are
+ * Nine sound groups — synthetic g1 crisp / g2 wood / g3 chiptune / g4 warm
+ * (see scripts/gen-sounds.mjs) and sampled g5 bell / g6 bubble / g7 arcade /
+ * g8 marimba / g9 soft synth (CC0, see assets/sounds/CREDITS.md) — are
  * selectable per scenario in a dedicated settings section (zh/en); a master
  * volume (0%–150%, 5% steps) gains the PCM samples before playback
  * (lib/wav.js scales in memory; PlaySoundW gets SND_MEMORY buffers, so
@@ -81,6 +83,11 @@ const GROUP_OPTIONS = [
     { value: 'g2', label: 'Wood', descriptions: { zh: '木质敲击', en: 'Wood' } },
     { value: 'g3', label: 'Chiptune', descriptions: { zh: '八比特', en: 'Chiptune' } },
     { value: 'g4', label: 'Warm', descriptions: { zh: '温馨钢琴', en: 'Warm' } },
+    { value: 'g5', label: 'Bell', descriptions: { zh: '清亮铃声', en: 'Bell' } },
+    { value: 'g6', label: 'Bubble', descriptions: { zh: '气泡水滴', en: 'Bubble' } },
+    { value: 'g7', label: 'Arcade', descriptions: { zh: '街机电子', en: 'Arcade' } },
+    { value: 'g8', label: 'Marimba', descriptions: { zh: '木质马林巴', en: 'Marimba' } },
+    { value: 'g9', label: 'Soft Synth', descriptions: { zh: '柔和电子', en: 'Soft Synth' } },
     { value: 'off', label: 'Off', descriptions: { zh: '关闭', en: 'Off' } },
 ];
 /** Volume choices: 0%–150% in 5% steps (stored as plain value strings). */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-chime-sound",
-  "version": "0.2.0",
-  "description": "Notification sounds for dsh-tui: distinct tones for conversation done / user question, focused vs unfocused terminal, 4 selectable sound groups, master volume 0-150% in 5% steps, settings section, zh/en",
+  "version": "0.3.2",
+  "description": "Notification sounds for dsh-tui: distinct tones for conversation done / user question, focused vs unfocused terminal, 9 selectable sound groups, master volume 0-150% in 5% steps, settings section, zh/en",
   "license": "MIT",
   "type": "module",
   "main": "lib/index.js",
@@ -29,6 +29,8 @@
     "dsh-plugin.json",
     "cordis.patch.yml",
     "README.md",
+    "README.zh.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "dsh": {