dsh-plugin-notify-sounds 1.9.4 → 1.9.5

package/README.md

@@ -16,7 +16,7 @@ Walk away from the window without missing anything: an OS notification whether t
 **Install**: DSH → **Plugins** in the left sidebar → Add plugin, paste the line below (keep the version — a release younger than 24 hours is resolved back to the previous one by pnpm's `minimumReleaseAge`) and press **Install**:
 
 ```
-dsh-plugin-notify-sounds@1.9.4
+dsh-plugin-notify-sounds@1.9.5
 ```
 
 ---
@@ -66,7 +66,7 @@ Everything applies immediately — no restart needed.
 2. Paste the package name **with a version** (this plugin is published on [npm](https://www.npmjs.com/package/dsh-plugin-notify-sounds)):
 
    ```
-   dsh-plugin-notify-sounds@1.9.4
+   dsh-plugin-notify-sounds@1.9.5
    ```
 
    Do not drop the version: pnpm's `minimumReleaseAge` policy keeps a release younger than 24 hours out of automatic resolution, so the bare name resolves to the previous one. The current version is on [npm](https://www.npmjs.com/package/dsh-plugin-notify-sounds?activeTab=versions) and in [Releases](https://github.com/BillCx330/dsh-plugin-notify-sounds/releases).
@@ -79,10 +79,10 @@ The "install source" dropdown above the box picks the download mirror (mainland
 
 **Upgrades are installed by the package manager**, so the profile's lockfile moves with the files — a DSH plugin cannot install its own update durably (the manager refuses a package that is already declared, and its remove-then-install step unloads the very code that would finish the install). The plugin therefore only *checks*, and tells you where to install:
 
-- **Inside DSH (recommended, and the only path verified on the Desktop)**: **Plugins** in the left sidebar → uninstall this plugin under *Installed plugins* → **Add plugin** → paste `dsh-plugin-notify-sounds@<version>` → Install → restart DSH. (Keep the version: pnpm's `minimumReleaseAge` policy keeps a freshly published version out of automatic resolution for its first 24 hours, so the bare name can resolve to the previous release.)
+- **0.2.2 and later**: **Plugins** in the sidebar → the row shows its version state, click update (no uninstall-and-add).
+- **0.2.1 and earlier**: **Plugins** in the left sidebar → uninstall this plugin under *Installed plugins* → **Add plugin** → paste `dsh-plugin-notify-sounds@<version>` → Install → restart DSH. (Keep the version: pnpm's `minimumReleaseAge` policy keeps a freshly published version out of automatic resolution for its first 24 hours, so the bare name can resolve to the previous release.)
 
 Uninstalling keeps your settings: preferences and uploaded audio live in the profile (`cordis.patch.yml` and `notify-sounds/sounds/`), so a reinstall restores them — including a clip migrated out of a pre-1.9.0 install.
-- **With the marketplace plugin** ([dshmarket](https://www.npmjs.com/package/dshmarket)): update it in one click there.
 - **On a `web` profile**: `dsh plugin --profile <your profile> add dsh-plugin-notify-sounds@<version>`.
 
 The update row also warns when the running version is not what the profile's lockfile records — the state left behind by the pre-1.8.0 self-updater. One reinstall through the package manager fixes it for good.
@@ -100,7 +100,7 @@ dsh plugin --profile <your profile> add github:BillCx330/dsh-plugin-notify-sound
 **Release archive** — download the `.tgz` from [Releases](https://github.com/BillCx330/dsh-plugin-notify-sounds/releases) and install it by its **path on disk**:
 
 ```sh
-dsh plugin --profile <your profile> add ./dsh-plugin-notify-sounds-1.9.4.tgz
+dsh plugin --profile <your profile> add ./dsh-plugin-notify-sounds-1.9.5.tgz
 ```
 
 (`dsh plugin add` hands its argument straight to the package manager, so it takes a local file path — a download URL will not work.)
@@ -147,7 +147,8 @@ For anyone hacking on the code (exact details live in the source comments):
 
 ## 📜 Changelog
 
-- **v1.9.4** (2026-11-03) **Fixed the window appearing frozen after a notification click, and the window not coming back at all with DevTools open.** Two Windows-only defects ([#5](https://github.com/BillCx330/dsh-plugin-notify-sounds/issues/5)): (1) the raise used Win32 `ShowWindow`, which brings the frame back but leaves the page hidden — the renderer stays paused, so you see the last frame; worse, the window now counts as "visible", so every later click only focuses it and it never recovers. Only a minimised window is restored natively now; a hidden one — or one whose frame is visible while its page is not — goes through `dsh://open`, where Electron's own `show()` restores both. (2) Window matching let any visible window of the shell process outrank a hidden window matched by title, so with DevTools open the inspector was raised instead; titles now always win, DevTools never matches, every candidate must belong to this process, and a blank-titled window remains the last resort. (3) The deep link now goes through `explorer.exe`: the previous launcher **failed silently** while the window was hidden — exit code 0, nothing happened, so a click did nothing at all. **Cost**: clicking while the page is hidden goes through the deep link, so the window takes about 0.5–1.5s longer.
+- **v1.9.5** (2026-11-07) **Adapted to DSH 0.2.2-rc.1: the Settings glyph is back, at the size of its neighbours.** 0.2.2 wraps the nav glyph in a `<span>`, so the old "find the svg and replace it" patch no longer matched and the cell fell back to the default gear; that release also added the supported `settings.section.icon` slot, so the glyph is now a registered component. Its size was fixed along the way: the alarm clock was drawn in 17 units and rendered into a 16px slot, shrinking it 6% and thinning the stroke from 1.3px to 1.22px; the paths are now refitted to the 16 unit box, so the weight matches the rest of the nav. 0.2.1 keeps the DOM swap; both paths stay. The upgrade notes point at 0.2.2's in-place update, and the in-app update hint follows the DSH version: 0.2.2 and later just say "click Update", older builds still get the full uninstall-and-add steps. The README's marketplace-update bullet is gone.
+- **v1.9.4** (2026-11-03) **Fixed the window appearing frozen after a notification click, and the window not coming back at all with DevTools open.** Two Windows-only defects ([#5](https://github.com/BillCx330/dsh-plugin-notify-sounds/issues/5), thanks @myzc1000): (1) the raise used Win32 `ShowWindow`, which brings the frame back but leaves the page hidden — the renderer stays paused, so you see the last frame; worse, the window now counts as "visible", so every later click only focuses it and it never recovers. Only a minimised window is restored natively now; a hidden one — or one whose frame is visible while its page is not — goes through `dsh://open`, where Electron's own `show()` restores both. (2) Window matching let any visible window of the shell process outrank a hidden window matched by title, so with DevTools open the inspector was raised instead; titles now always win, DevTools never matches, every candidate must belong to this process, and a blank-titled window remains the last resort. (3) The deep link now goes through `explorer.exe`: the previous launcher **failed silently** while the window was hidden — exit code 0, nothing happened, so a click did nothing at all. **Cost**: clicking while the page is hidden goes through the deep link, so the window takes about 0.5–1.5s longer.
 - **v1.9.3** (2026-11-02) **A visible-but-unfocused window now raises a system notification.** Notifications used to fire only while the page was hidden, but a window sitting in plain sight behind another app — or on a second screen while you type elsewhere — still reports `visible`, so that whole case was silent ([#5](https://github.com/BillCx330/dsh-plugin-notify-sounds/issues/5), thanks @myzc1000). The gate is now "hidden **or** unfocused". Minimised, tray-hidden and fully covered windows behave as before (Chromium's occlusion tracking marks those hidden).Two small fixes came along: a refused write while adding a clip left its uploaded file behind (it is deleted now), and a multi-line conversation title broke the toast title across lines (it is flattened to one).
 - **v1.9.2** (2026-10-30) **System notifications are titled with the conversation name.** They used to read "Task finished / The agent has finished the current task", so with several conversations open you had to click through to learn which one. The title now carries the conversation's name (from the `title` already on DSH's session rows, falling back to the workspace folder — and treating DSH's own "Working directory: …" fallback as unnamed, so only the folder segment shows), and the body is unchanged; a decision toast prefixes its body with the event so nothing is lost. Titles are trimmed at 48 characters, an untitled session keeps the old wording, and a raw session id is never shown. These fields exist since DSH 0.2.0 — not a new API — and when they are missing the behaviour is exactly what it was. **One cross-platform fix came along**: on Windows two windows uploading the same clip at once made the second report "not audio" (415) — POSIX lets `rename` overwrite, Windows refuses — and that refusal is now treated as success. ([#4](https://github.com/BillCx330/dsh-plugin-notify-sounds/issues/4), thanks @AdySnowflake)
 - **v1.9.1** (2026-10-29) **Fixed "too quiet": the nine presets are now levelled by loudness, not by peak.** A user reported that even 100% was quiet. Two things were stacked: the presets had never been matched to each other (`coin` peaks at 0.105, `ding` at 0.315 — 9.5 dB apart), and all of them sat about 12 dB below a decoded clip (a preset played at -16 dBFS at 100%, an imported file at -4). The same slider number meant two loudnesses. The first cut levelled them by peak, which made the coin sound louder still: a square carries 3 dB more energy than a sine at the same peak (RMS/peak 1.0 vs 0.707). Levels now use a crest-corrected peak — sines and squares land on the same energy, and triangles are capped at the ceiling rather than pushed past it. The same number is about 12 dB louder, and the nine sounds agree with each other. **The saved volume is re-scaled once on upgrade**: at the new scale the same number is ~10 dB louder, so the stored value is halved (60 → 30, 100 → 50) — about 3.5 dB above where you were. Turn it up for the new headroom. ([#3](https://github.com/BillCx330/dsh-plugin-notify-sounds/issues/3), thanks @sink-er)

package/README.zh.md

@@ -16,7 +16,7 @@
 **安装**：DSH → 左侧栏「插件」→ 添加插件，粘贴下面这行（**带上版本号**，否则发布不满 24 小时的版本会被 pnpm 的 `minimumReleaseAge` 解析回上一版），点「安装」：
 
 ```
-dsh-plugin-notify-sounds@1.9.4
+dsh-plugin-notify-sounds@1.9.5
 ```
 
 ---
@@ -66,7 +66,7 @@ DSH 的状态提示只有视觉——状态点、侧栏标记。你一切到别
 2. 在输入框粘贴包名**和版本号**（本插件已发布在 [npm](https://www.npmjs.com/package/dsh-plugin-notify-sounds)）：
 
    ```
-   dsh-plugin-notify-sounds@1.9.4
+   dsh-plugin-notify-sounds@1.9.5
    ```
 
    版本号不要省：pnpm 的 `minimumReleaseAge` 策略会把刚发布不到 24 小时的版本挡在外面，只写包名会解析回上一个版本。想看最新版本号可到 [npm](https://www.npmjs.com/package/dsh-plugin-notify-sounds?activeTab=versions) 或 [Releases](https://github.com/BillCx330/dsh-plugin-notify-sounds/releases) 查。
@@ -79,10 +79,10 @@ DSH 的状态提示只有视觉——状态点、侧栏标记。你一切到别
 
 **升级由包管理器安装**，这样 profile 的 lockfile 会跟着一起更新——DSH 插件无法自己持久地更新自己（管理器拒绝已声明的包，而它的「先移除再安装」会先卸载掉正要完成安装的代码）。所以插件只负责**检查**，并告诉你从哪里装：
 
-- **在 DSH 里（推荐，也是唯一实测过的路径）**：**左侧栏「插件」** → 在「已安装插件」里卸载本插件 → **添加插件** → 粘贴 `dsh-plugin-notify-sounds@<版本>` → 安装 → 重启 DSH。（务必带版本号：pnpm 的 `minimumReleaseAge` 会让刚发布不到 24 小时的版本不参与自动解析，只写包名会装回上一个版本。）
+- **0.2.2 及以上**：**左侧栏「插件」** → 本插件那一行会显示版本状态，直接点更新（不用再卸载重装）。
+- **0.2.1 及更早**：**左侧栏「插件」** → 在「已安装插件」里卸载本插件 → **添加插件** → 粘贴 `dsh-plugin-notify-sounds@<版本>` → 安装 → 重启 DSH。（务必带版本号：pnpm 的 `minimumReleaseAge` 会让刚发布不到 24 小时的版本不参与自动解析，只写包名会装回上一个版本。）
 
 卸载不会丢东西：偏好和自定义音频都存在 profile 里（`cordis.patch.yml` 与 `notify-sounds/sounds/`），重装后自动恢复——包括升级到 1.9.0 时由旧版内嵌音频自动迁移过来的那份。
-- **装了市场插件**（[dshmarket](https://www.npmjs.com/package/dshmarket)）：在市场里一键更新。
 - **`web` profile**：`dsh plugin --profile <你的 profile> add dsh-plugin-notify-sounds@<版本>`。
 
 更新行还会提示「当前版本与 lockfile 记录不一致」——那是 1.8.0 之前的自更新留下的状态，按上面方式重装一次即可永久修好。
@@ -100,7 +100,7 @@ dsh plugin --profile <你的 profile> add github:BillCx330/dsh-plugin-notify-sou
 **Release 压缩包** —— 从 [Releases](https://github.com/BillCx330/dsh-plugin-notify-sounds/releases) 下载 `.tgz`，用它**在磁盘上的路径**安装：
 
 ```sh
-dsh plugin --profile <你的 profile> add ./dsh-plugin-notify-sounds-1.9.4.tgz
+dsh plugin --profile <你的 profile> add ./dsh-plugin-notify-sounds-1.9.5.tgz
 ```
 
 （`dsh plugin add` 把参数原样交给包管理器，所以要给本地文件路径，不能填下载地址。）
@@ -126,7 +126,7 @@ dsh plugin --profile <你的 profile> add ./dsh-plugin-notify-sounds
 - **关闭到后台后点通知会慢一点**：这种情况走系统深链、由 Electron 自己把窗口 `show` 回来（否则画面会停在最后一帧），窗口出现比平时慢约 0.5–1.5 秒；停在欢迎页时深链可能不生效。
 - **第三方封装的桌面客户端**（如 DSH NEXT）：唤窗依赖官方壳的 Win32 能力与 `dsh://` 协议注册，封装版没有这两样，点击通知不会回到窗口——那是宿主侧缺的，插件无法补。
 - **唤窗按窗口标题定位主窗口**：刻意不读取其他进程信息（那会触发杀软主动防御）。若将来 DSH 改变标题格式，唤窗会静默失效——提示音与通知本身不受影响。
-- **导航小图标**：依赖设置面板的 DOM 结构，若DSH 改版后自动回落为官方齿轮，仅影响外观。
+- **导航小图标**：0.2.2 起走官方 `settings.section.icon` 插槽；0.2.1 及更早靠替换设置面板里的图标节点，那一代再改版可能回落为官方齿轮（仅影响外观）。
 - **通知权限**：桌面端放行；受限环境（某些浏览器策略）下被拒时，行内会引导手动允许，其余功能不受影响。
 - **macOS 的系统通知**：桌面外壳对权限请求一律放行，所以设置里恒显示「已授权」；**实际是否弹横幅由 macOS 决定**（系统设置 → 通知 → DeepSeek Harness），未签名的开发版可能静默失败——「显示已授权却没通知」多半不是插件的问题。
 
@@ -146,7 +146,8 @@ dsh plugin --profile <你的 profile> add ./dsh-plugin-notify-sounds
 
 ## 📜 更新记录
 
-- **v1.9.4**（2026-11-03）**修好「窗口弹出来但冻住」，以及开 DevTools 后点通知窗口不回来。** 两个 Windows 专属问题（[#5](https://github.com/BillCx330/dsh-plugin-notify-sounds/issues/5)）：① 唤窗以前用 Win32 `ShowWindow` 把窗口显示出来，但 `hide()` 过的窗口页面仍处于隐藏、渲染是停的——窗口框有了，画面停在最后一帧；更糟的是此后系统层面已算「可见」，再点只会走聚焦，永远恢复不了。现在只对**最小化**用原生 restore，隐藏或「框可见但页面隐藏」一律交给 `dsh://open`，由 Electron 自己 `show()`。② 窗口匹配以前让「同进程的任意可见窗口」压过「按标题命中的隐藏窗口」，开着 DevTools 时会选中 DevTools；现在标题永远优先，DevTools 不参与匹配，所有候选必须是本进程的窗口，空标题窗口保留为最后兜底。③ 深链改用 `explorer.exe` 触发：原来那条 shell 命令在窗口隐藏时会**静默失败**（退出码 0，窗口不动），点了等于没反应。**代价**：页面处于隐藏态时点击会走深链，窗口出现慢约 0.5–1.5 秒。
+- **v1.9.5**（2026-11-07）**适配 DSH 0.2.2-rc.1：设置页的图标回来了，并且和相邻图标一样大。** 0.2.2 把导航格子改成 `<span>` 包图标，原来那套「找到 svg 再替换」的 DOM 写法匹配不上，图标退回默认齿轮；这一版正好开放了 `settings.section.icon` 插槽，改为按官方方式注册组件。顺手修了尺寸：原来的闹钟按 17 单位画、塞进 16px 槽位，缩了 6%，描边也从 1.3px 变成 1.22px，看着比邻居小一圈；现在按 16 单位重排坐标，描边回到 1.3px。0.2.1 仍走旧的 DOM 替换，两条路都保留。升级说明改成 0.2.2 的「插件页直接更新」；应用内的更新提示也按版本给最短路径：0.2.2 及以上只提示「点更新」，更早的版本才给卸载重装的完整步骤。README 里那条「插件市场一键更新」一并删掉了。
+- **v1.9.4**（2026-11-03）**修好「窗口弹出来但冻住」，以及开 DevTools 后点通知窗口不回来。** 两个 Windows 专属问题（[#5](https://github.com/BillCx330/dsh-plugin-notify-sounds/issues/5)，感谢 @myzc1000）：① 唤窗以前用 Win32 `ShowWindow` 把窗口显示出来，但 `hide()` 过的窗口页面仍处于隐藏、渲染是停的——窗口框有了，画面停在最后一帧；更糟的是此后系统层面已算「可见」，再点只会走聚焦，永远恢复不了。现在只对**最小化**用原生 restore，隐藏或「框可见但页面隐藏」一律交给 `dsh://open`，由 Electron 自己 `show()`。② 窗口匹配以前让「同进程的任意可见窗口」压过「按标题命中的隐藏窗口」，开着 DevTools 时会选中 DevTools；现在标题永远优先，DevTools 不参与匹配，所有候选必须是本进程的窗口，空标题窗口保留为最后兜底。③ 深链改用 `explorer.exe` 触发：原来那条 shell 命令在窗口隐藏时会**静默失败**（退出码 0，窗口不动），点了等于没反应。**代价**：页面处于隐藏态时点击会走深链，窗口出现慢约 0.5–1.5 秒。
 - **v1.9.3**（2026-11-02）**窗口可见但没焦点时也会弹系统通知。** 此前只在页面不可见时发通知；而窗口被别的程序盖住、或你切到别的窗口打字、DSH 仍完整显示在屏幕上时，页面报告的仍是 `visible`，这类「看得见但没在用」的情况完全收不到通知（[#5](https://github.com/BillCx330/dsh-plugin-notify-sounds/issues/5)，感谢 @myzc1000）。现在条件改为「不可见 **或** 没有焦点」。最小化、托盘、被完全遮挡（Chromium 的遮挡检测会把窗口标记为 hidden）行为不变。顺带修了两处小问题：上传音频时若写入被拒，已经存好的文件会残留（现在会一并清掉）；对话标题里含换行时会把通知标题撑成两行（现在折叠成一行）。
 - **v1.9.2**（2026-10-30）**系统通知的标题改成对话名。** 此前通知固定写「任务完成 / 智能体已完成当前任务」，同时开着几个对话时，得点进去才知道是哪一个。现在标题用该对话的名字（读的是 DSH 会话列表里已有的 `title`；没有标题、或标题只是「Working directory: 路径」这类兜底串时，只显示目录名），正文不变；决策通知的正文会带上「需要你的决策：」，把原来写在标题里的事件补回来。标题超过 48 字会截断，未命名且无目录时保持原来的文案——**不会显示裸会话 id**。字段从 DSH 0.2.0 起就有，不是新 API，取不到时行为与之前完全一致。**顺带修了一个跨平台问题**：Windows 下两个窗口同时上传同一段音频时，后到的那个会被误报「不是音频」（415）——POSIX 上 `rename` 能覆盖、Windows 上会抛错；现在这种情况按成功处理。（[#4](https://github.com/BillCx330/dsh-plugin-notify-sounds/issues/4)，感谢 @AdySnowflake）
 - **v1.9.1**（2026-10-29）**修好「声音太小」：九个内置音效按实际响度对齐，而不是按峰值。** 有用户反馈 100% 也偏小。查下来是两件事：九个预设从未互相对齐（`coin` 的叠加峰值 0.105、`ding` 0.315，差 9.5 dB）；预设整体又比自定义音频轻约 12 dB（预设 100% 时约 -16 dBFS，导入的音频约 -4 dBFS）——同一个音量数字，两种响度。第一版修复按**峰值**对齐，结果金币反而更响：方波在同等峰值下能量比正弦高 3 dB（RMS/峰值 1.0 对 0.707）。现在按**波峰因数折算后的峰值**对齐——正弦和方波落在同一能量上，三角波因为峰值已经触顶不再加推。同样的音量数字比以前响约 12 dB，九个音效之间也一致了。**升级时音量会自动折算**：新刻度下同一个数字比以前响约 10 dB，所以首次启动会把已存的音量减半（60 → 30、100 → 50），实际只比原来高约 3.5 dB；想更大声再往上调即可。（[#3](https://github.com/BillCx330/dsh-plugin-notify-sounds/issues/3)，感谢 @sink-er）

package/lib/client.js

@@ -92,6 +92,41 @@ window.__ModuleLoader__.load({
 			return typeof navigator !== "undefined" && /Electron/i.test(navigator.userAgent ?? "");
 		};
 
+		/**
+		 * The Desktop's own version, read off the user agent.
+		 *
+		 * Electron puts the app in the UA as `@deepseek-ai/dsh-desktop/<version>`;
+		 * a browser does not, which is exactly the difference that matters —
+		 * outside the shell there is no version to branch on.
+		 *
+		 * @returns `major.minor.patch`, or undefined outside the Desktop.
+		 */
+		function desktopVersion() {
+			const ua = typeof navigator === "undefined" ? "" : String(navigator.userAgent);
+			const match = /@deepseek-ai\/dsh-desktop\/(\d+\.\d+\.\d+)/iu.exec(ua);
+			return match === null ? undefined : match[1];
+		}
+
+		/**
+		 * Whether a `major.minor.patch` string is at least `floor`.
+		 *
+		 * Numeric per segment rather than string order: `0.10.0` is newer than
+		 * `0.9.0`, and a lexical compare gets that backwards.
+		 *
+		 * @param version - the version to test, or undefined when unknown.
+		 * @param floor - the lowest version that counts.
+		 * @returns whether the version is known and meets the floor.
+		 */
+		function atLeastVersion(version, floor) {
+			if (typeof version !== "string") return false;
+			const a = version.split(".").map(Number);
+			const b = floor.split(".").map(Number);
+			for (let i = 0; i < 3; i += 1) {
+				if (a[i] !== b[i]) return a[i] > b[i];
+			}
+			return true;
+		}
+
 		/**
 		 * Whether the page is on macOS.
 		 *
@@ -255,6 +290,7 @@ window.__ModuleLoader__.load({
 			"update.available": "有新版",
 			"update.failed": "检查失败",
 			"update.failedDetail": "两个源都没有给出可用的答复：可能是网络、代理或镜像源临时不可用，稍后重试即可",
+			"update.desktopGuidanceInPlace": "升级：左侧栏「插件」→ 找到本插件 → 直接点「更新」，不用卸载重装（管理器会自己选版本）",
 			"update.desktopGuidance": "升级走包管理器：左侧栏「插件」→ 在「已安装插件」里卸载本插件 → 点「添加插件」→ 粘贴 dsh-plugin-notify-sounds@{version} → 安装 → 重启 DSH",
 			"update.versionPinned": "务必带版本号：发布不满 24 小时的版本会被 pnpm 的 minimumReleaseAge 策略挡掉，只写包名会装回上一个版本",
 			"update.webGuidance": "在终端执行 dsh plugin --profile {profile} add dsh-plugin-notify-sounds@{version}",
@@ -350,6 +386,7 @@ window.__ModuleLoader__.load({
 			"update.available": "New version available",
 			"update.failed": "Check failed",
 			"update.failedDetail": "Neither source returned a usable answer — the network, a proxy or a mirror may be temporarily unavailable. Try again later.",
+			"update.desktopGuidanceInPlace": "To update: Plugins in the sidebar → find this plugin → click Update. No uninstall, and the manager picks the version.",
 			"update.desktopGuidance": "Update through the package manager: sidebar Plugins → uninstall this plugin under Installed plugins → Add plugin → paste dsh-plugin-notify-sounds@{version} → Install → restart DSH",
 			"update.versionPinned": "Keep the version: pnpm's minimumReleaseAge policy blocks a release for its first 24 hours, so the bare name resolves to the previous version",
 			"update.webGuidance": "Run dsh plugin --profile {profile} add dsh-plugin-notify-sounds@{version} in a terminal",
@@ -2359,7 +2396,15 @@ window.__ModuleLoader__.load({
 			if (installTarget !== undefined && installTarget !== "") {
 				const version = packageVersion(installTarget);
 				let guidance;
-				if (isDesktopShell()) {
+				// 0.2.2 updates a third-party package from the plugin page
+				// itself, so the uninstall-and-add steps are the long way round
+				// there. Version-branch rather than time-branch: plenty of
+				// installs stay on 0.2.1, where those steps are still the only
+				// route.
+				const inPlace = isDesktopShell() && atLeastVersion(desktopVersion(), "0.2.2");
+				if (inPlace) {
+					guidance = t("update.desktopGuidanceInPlace");
+				} else if (isDesktopShell()) {
 					guidance = t("update.desktopGuidance", { version });
 				} else if (typeof payload.profile === "string" && payload.profile !== "") {
 					guidance = t("update.webGuidance", { profile: payload.profile, version });
@@ -2373,8 +2418,10 @@ window.__ModuleLoader__.load({
 				lines.push(h("div", { className: css.hint, key: "howto" }, guidance));
 				// Its own line: the steps above are what to do, this is why the
 				// version cannot be dropped — and a parcel of text this long
-				// reads as one dense block when it is glued onto the steps.
-				lines.push(h("div", { className: css.hint, key: "pinned" }, t("update.versionPinned")));
+				// reads as one dense block when it is glued onto the steps. The
+				// in-place route types no version at all, so the note would only
+				// puzzle.
+				if (!inPlace) lines.push(h("div", { className: css.hint, key: "pinned" }, t("update.versionPinned")));
 			}
 			return h("div", { className: css.row }, [
 				h("div", { key: "text" }, [
@@ -2398,13 +2445,15 @@ window.__ModuleLoader__.load({
 
 		//#region settings nav icon
 		/**
-		 * The settings shell draws its nav glyphs from a hardcoded id → icon map
-		 * (`navIcon` in ui-settings-general); every id outside that map — ours,
-		 * and General's — falls back to the same settings gear. The platform
-		 * offers no registration point for a third-party section's glyph, so
-		 * this package swaps its own cell's gear for the alarm-clock artwork
-		 * from the very same primitive family (IconAlarmClockOutlineMedium's
-		 * paths, 1.3px medium stroke) once the cell is in the DOM.
+		 * Until 0.2.2 the shell drew every nav glyph from a hardcoded id → icon
+		 * map (`navIcon` in ui-settings-general), so an id outside that map —
+		 * ours — fell back to the settings gear and the only way to change it
+		 * was to swap the cell's SVG from the DOM. That is what the patch below
+		 * still does, and only for 0.2.1.
+		 *
+		 * 0.2.2 added `settings.section.icon`, so the glyph is a component
+		 * registered under the section id and the DOM patch is dead weight
+		 * there (its tag check no longer matches the shell's new markup).
 		 *
 		 * The swap is cosmetic DOM surgery, deliberately narrow: it matches the
 		 * one nav cell whose label is this section's, copies the original SVG's
@@ -2420,20 +2469,55 @@ window.__ModuleLoader__.load({
 		/** Marker attribute distinguishing a swapped glyph from the shipped one. */
 		const NAV_ICON_MARKER = "data-notify-sounds-icon";
 
-		/** IconAlarmClockOutlineMedium artwork: six stroked paths in a 16×16 box. */
+		/**
+		 * The section's glyph: the shell's own alarm clock, refitted to the 16
+		 * unit box its nav icons use.
+		 *
+		 * The artwork is the primitive family's (`IconAlarmClockOutlineMedium`),
+		 * drawn in 17 units. Rendering it straight into a 16px slot shrank it by
+		 * 6% and thinned the stroke from 1.3px to 1.22px, which read as a
+		 * smaller icon than its neighbours. These paths are the same geometry
+		 * scaled by 16/17 × 1.02 and recentred on (8, 8): same artwork, the
+		 * weight the rest of the nav has.
+		 */
 		const NAV_ICON_PATHS = [
-			"M4.09372 11.9895L3.11865 14.0387",
-			"M12.1392 11.9895L13.1143 14.0387",
-			"M8.11646 4.78442V8.03442L10.6165 9.53442",
-			"M8.11646 13.4094C11.154 13.4094 13.6165 10.947 13.6165 7.90942C13.6165 4.87186 11.154 2.40942 8.11646 2.40942C5.07889 2.40942 2.61646 4.87186 2.61646 7.90942C2.61646 10.947 5.07889 13.4094 8.11646 13.4094Z",
-			"M1.75952 4.74323C2.30657 3.65639 3.12646 2.73047 4.12926 2.05542",
-			"M14.3345 4.74323C13.7874 3.65639 12.9675 2.73047 11.9647 2.05542",
+			"M3.968 12.021L2.973 14.111",
+			"M12.174 12.021L13.169 14.111",
+			"M8.071 4.672V7.987L10.621 9.517",
+			"M8.071 13.47C11.169 13.47 13.681 10.958 13.681 7.86C13.681 4.761 11.169 2.25 8.071 2.25C4.973 2.25 2.461 4.761 2.461 7.86C2.461 10.958 4.973 13.47 8.071 13.47Z",
+			"M1.587 4.63C2.145 3.522 2.981 2.577 4.004 1.889",
+			"M14.413 4.63C13.855 3.522 13.019 2.577 11.996 1.889",
 		];
 
 		/**
-		 * Build the replacement glyph with the shipped icon geometry: `fill=none`
+		 * The section's nav glyph as a component.
+		 *
+		 * Since 0.2.2 the shell offers `settings.section.icon`: one component
+		 * per section id, rendered inside the nav cell, sized by the shell. That
+		 * is the supported route and what this renders through — the DOM patch
+		 * further down only exists for 0.2.1, where the shell had no such slot.
+		 *
+		 * @param props - `size` in pixels and whether the section is `active`.
+		 * @returns the glyph.
+		 */
+		function NotifySoundsNavIcon({ size = 16 }) {
+			return h("svg", {
+				width: size,
+				height: size,
+				viewBox: "0 0 16 16",
+				fill: "none",
+				stroke: "currentColor",
+				strokeWidth: 1.3,
+				strokeLinecap: "round",
+				"aria-hidden": true,
+			}, NAV_ICON_PATHS.map((d) => h("path", { key: d, d })));
+		}
+
+		/**
+		 * Build the replacement glyph with the shell's icon geometry: `fill=none`
 		 * on the root (paths inherit it), `stroke=currentColor` so the shell's
-		 * nav color rules keep driving it, and the medium 1.3px stroke.
+		 * nav color rules keep driving it, and the medium 1.3px stroke with
+		 * round caps.
 		 *
 		 * @returns a detached SVG element.
 		 */
@@ -2441,18 +2525,18 @@ window.__ModuleLoader__.load({
 			const svg = document.createElementNS("http://www.w3.org/2000/svg", "svg");
 			svg.setAttribute("width", "16");
 			svg.setAttribute("height", "16");
-			// 17×17, matching the artwork's own coordinate system
-			// (`IconAlarmClockOutlineArtwork`); the gear it replaces is 16×16,
-			// and reusing ITS viewport here would scale the alarm paths up by
-			// 17/16 and make the glyph visibly larger than its neighbours.
-			svg.setAttribute("viewBox", "0 0 17 17");
+			// 16×16, the same box the shell's own nav glyphs use: a 17-unit
+			// artwork rendered into the 16px slot came out smaller than its
+			// neighbours.
+			svg.setAttribute("viewBox", "0 0 16 16");
 			svg.setAttribute("fill", "none");
+			svg.setAttribute("stroke", "currentColor");
 			svg.setAttribute("stroke-width", "1.3");
+			svg.setAttribute("stroke-linecap", "round");
 			svg.setAttribute("aria-hidden", "true");
 			for (const d of NAV_ICON_PATHS) {
 				const path = document.createElementNS(svg.namespaceURI, "path");
 				path.setAttribute("d", d);
-				path.setAttribute("stroke", "currentColor");
 				svg.appendChild(path);
 			}
 			return svg;
@@ -3471,8 +3555,21 @@ window.__ModuleLoader__.load({
 						onRemoveSound: (slot) => removeSound(slot),
 					}),
 				}, NotifySoundsSection));
+				// 0.2.2's supported route. A shell without the slot (0.2.1) throws
+				// here — or ignores it — and the DOM patch below still swaps the
+				// gear, so both generations show the same glyph.
+				let disposeIcon = () => {};
+				try {
+					disposeIcon = ctx.slots.inject("settings.section.icon", () => ctx.slots.register({
+						name: "settings.section.icon",
+						id: SETTINGS_NAMESPACE,
+						order: 5,
+						locale: NS,
+					}, NotifySoundsNavIcon));
+				} catch {}
 				const disposeNavIcon = installNavIconPatch(t);
 				return () => {
+					disposeIcon();
 					disposeNavIcon();
 					disposeSection();
 				};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-notify-sounds",
-  "version": "1.9.4",
+  "version": "1.9.5",
   "description": "DeepSeek Harness 原生风格提示音插件：需要决策或任务完成时播放提示音，点击系统通知可回到窗口；支持重复提醒、静音时段，以及目标模式下只在最终轮提醒。 · Native-style notification sounds for DeepSeek Harness: a chime when the agent needs your decision or finishes a task, click a system notification to jump back, plus repeat reminders, quiet hours, and goal-mode alerts that wait for the final round.",
   "type": "module",
   "main": "lib/index.js",