@game25011/dsh-notify-toast 0.4.2 → 0.4.3

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.4.3 — 2026-11-07
+
+- 修复 DSH 0.2.2 设置页导航图标重复：优先注册原生 `settings.section.icon` slot，让 shell 用铃铛替换默认齿轮；旧版 DSH 保留 DOM fallback。
+- 未改变通知核心逻辑；单测、client smoke 和 Host probe 通过。
+
 ## 0.4.2 — 2026-11-07
 
 - 元数据与兼容声明补丁：支持 DSH Desktop 0.2.2-rc.1，`engines.dsh` 显式覆盖 `0.2.2-rc.x` 范围，更新 README 徽标。

package/README.en.md

@@ -8,15 +8,19 @@ English | [中文](./README.md)
 
 > An unofficial, MIT-licensed Windows 10/11 plugin for DSH that provides native Windows background toast notifications without disturbing focus, featuring an unread taskbar badge that counts distinct root sessions (counting multiple completions in the same session as one, showing numbers 1–3 and a red dot for over 3). Major code was generated by an AI coding assistant, with the human maintainer responsible for requirements, debugging, testing, and release.
 
-- Source/local package: `dsh-notify-toast` · Version: `0.4.2` · License: MIT
-- npm package: `@game25011/dsh-notify-toast@0.4.2` (scoped distribution; the repository package name stays `dsh-notify-toast`).
+- Source/local package: `dsh-notify-toast` · Version: `0.4.3` · License: MIT
+- npm package: `@game25011/dsh-notify-toast@0.4.3` (scoped distribution; the repository package name stays `dsh-notify-toast`).
 - Chinese display name: 桌面通知（Windows 原生 toast）; the npm package name, directory, and row id stay ASCII `dsh-notify-toast` (a documented naming exception).
 - Works with: DeepSeek Harness Desktop `0.2.2-rc.1` (Electron shell, `desktop` profile), Windows 10/11
 - Form factor: official DSH bundle (Host + Web Client), installed and removed through the official plugin manager
-- Status: 0.4.2 updates the DSH 0.2.2-rc.1 compatibility declaration. 0.4.1 fixes missed approval notifications. 0.4.0 adds a taskbar unread badge (scheme B: distinct root sessions); 0.3.0 native progress toast, automatic banner retraction, click-to-session, bar-only styling and a simple goal aggregation run were verified on a real device; goal edge cases remain to be re-tested; optional "rewrite the title when all tasks are done" remains available (default off)
+- Status: 0.4.3 fixes duplicate settings navigation icons on DSH 0.2.2. 0.4.2 updates the DSH 0.2.2-rc.1 compatibility declaration. 0.4.1 fixes missed approval notifications. 0.4.0 adds a taskbar unread badge (scheme B: distinct root sessions); 0.3.0 native progress toast, automatic banner retraction, click-to-session, bar-only styling and a simple goal aggregation run were verified on a real device; goal edge cases remain to be re-tested; optional "rewrite the title when all tasks are done" remains available (default off)
 
 ![Windows native progress toast](docs/assets/native-toast.png)
 
+## 0.4.3 update
+
+Fixes duplicate settings navigation icons on DSH 0.2.2 by registering the bell through the native `settings.section.icon` slot, so the shell replaces the default gear instead of rendering two glyphs; older DSH versions keep the DOM fallback. Notification logic is unchanged.
+
 ## 0.4.2 update
 
 Version 0.4.2 is a metadata and compatibility patch with no changes to notification core logic. It explicitly declares support for DSH Desktop 0.2.2-rc.1 by scoping `engines.dsh` to `0.2.2-rc.x` to prevent semver parsing issues, alongside README badge updates. All 94 unit tests, 26 smoke tests, and host integration probes passed. Forward compatibility is not guaranteed during upstream pre-releases.
@@ -76,7 +80,7 @@ Persistent tray/background services, taskbar progress bars, taskbar flashing ani
 
 > Install this plugin through the **official plugin manager** or the GitHub Release. Do not edit the profile's `package.json` or `cordis.patch.yml` by hand.
 >
-> npm package: `@game25011/dsh-notify-toast@0.4.2`; use `npm pack @game25011/dsh-notify-toast` to get the tarball, then install it through the plugin manager.
+> npm package: `@game25011/dsh-notify-toast@0.4.3`; use `npm pack @game25011/dsh-notify-toast` to get the tarball, then install it through the plugin manager.
 
 > Manifest note: `dsh-plugin.json` declares only the Host facet (`facets.host`); the Web Client half is declared by `dsh.client` in `package.json` (other third-party plugins use the same structure), so no `facets.client` is declared. Official DSH 0.2.2-rc.1 plugin loading is driven by `dsh.bundle` / `dsh.client` in `package.json`.
 
@@ -90,7 +94,7 @@ Then install the resulting tarball through the plugin manager; the in-app manage
 
 ### Option A: In-app plugin manager (recommended)
 
-1. Put the delivered `dsh-notify-toast-0.4.2.tgz` anywhere on the local machine (avoid spaces in the path).
+1. Put the delivered `dsh-notify-toast-0.4.3.tgz` anywhere on the local machine (avoid spaces in the path).
 2. Install it with the official plugin manager, either through the Agent or through the plugin management UI:
    - Agent tool: `plugin_manager` → `action: install_bundle`, `target: <absolute path to the tgz>`
    - CLI: only for self-managed profiles (web/headless). The official Desktop `desktop` profile is managed by the Electron application's plugin manager; use the UI or Agent method above.
@@ -111,7 +115,7 @@ Installing from a local directory creates a link, so DSH's HMR can pick up code
 This repository ships `market-index.json`. Add this custom index in the DSH plugin market/discovery page:
 
 ```text
-https://raw.githubusercontent.com/game25011/dsh-notify-toast/4a3c83e5634cf9dcac005ec2e9bbd4c4dd828596/market-index.json
+https://raw.githubusercontent.com/game25011/dsh-notify-toast/e0a6d60a2d9eb67953ed9af8a77943ab88340885/market-index.json
 ```
 
 Then search for `dsh-notify-toast` and install the pinned Git version.

package/README.md

@@ -11,13 +11,17 @@
 
 > dsh-notify-toast 是一款适用于 Windows 10/11 的非官方 DSH 插件（MIT 协议）。它提供聚焦不打扰的后台提醒，通过 Windows 原生通知提示提问、授权与根会话完成；任务栏未读角标按不同根会话计数，同一会话多次完成算一个，1–3 显示数字，超过 3 显示红点。主要代码由 AI 编程助手生成，人类维护者负责需求、调试、测试与发布。
 
-- 源码/本地包名：`dsh-notify-toast` · 版本：`0.4.2` · 许可：MIT · 仓库：https://github.com/game25011/dsh-notify-toast
-- npm 包：`@game25011/dsh-notify-toast@0.4.2`（scoped 分发；源码包名仍为 `dsh-notify-toast`）
+- 源码/本地包名：`dsh-notify-toast` · 版本：`0.4.3` · 许可：MIT · 仓库：https://github.com/game25011/dsh-notify-toast
+- npm 包：`@game25011/dsh-notify-toast@0.4.3`（scoped 分发；源码包名仍为 `dsh-notify-toast`）
 - 适用：DeepSeek Harness Desktop `0.2.2-rc.1`（Electron 壳，profile `desktop`），Windows 10/11
 - 形态：DSH 官方 bundle（Host + Web Client 两半），通过官方插件管理器安装/卸载
-- 状态：0.4.2 更新 DSH 0.2.2-rc.1 兼容声明；0.4.1 修复审批通知漏发；0.4.0 新增任务栏未读角标（方案 B：不同根会话计数）；0.3.0 原生进度 toast、bar-only 样式、自动收回、点击回会话与 Goal 汇总已在本机简单实测；Goal 边界场景仍待补测；「全部完成后改写标题」为可选功能（默认关）
+- 状态：0.4.3 修复 DSH 0.2.2 设置页图标重复；0.4.2 更新 DSH 0.2.2-rc.1 兼容声明；0.4.1 修复审批通知漏发；0.4.0 新增任务栏未读角标（方案 B：不同根会话计数）；0.3.0 原生进度 toast、bar-only 样式、自动收回、点击回会话与 Goal 汇总已在本机简单实测；Goal 边界场景仍待补测；「全部完成后改写标题」为可选功能（默认关）
 - 截图：![Windows 原生进度通知](docs/assets/native-toast.png)
 
+## 0.4.3 更新
+
+修复 DSH 0.2.2 设置页导航图标重复：改用原生 `settings.section.icon` slot，让 shell 用同一个通知铃铛图标替换默认齿轮；旧版 DSH 仍保留原有 DOM fallback。没有改变通知核心逻辑。
+
 ## 0.4.2 更新
 
 v0.4.2 是元数据与兼容声明补丁，未变更通知核心逻辑。针对 DSH Desktop 0.2.2-rc.1，将 `engines.dsh` 显式覆盖至 `0.2.2-rc.x` 范围以避免 semver 误判，并同步更新 README 徽标。94 项单测、26 项 smoke 及 Host probe 均通过；上游处于预发布期，不作长效兼容承诺。
@@ -78,7 +82,7 @@ v0.4.2 是元数据与兼容声明补丁，未变更通知核心逻辑。针对
 
 > 本插件只通过 **官方插件管理器** 或 GitHub Release 安装；不要手改 profile 的 `package.json` 或 `cordis.patch.yml`。
 >
-> npm 包：`@game25011/dsh-notify-toast@0.4.2`；可用 `npm pack @game25011/dsh-notify-toast` 获取 tgz，再按插件管理器安装。
+> npm 包：`@game25011/dsh-notify-toast@0.4.3`；可用 `npm pack @game25011/dsh-notify-toast` 获取 tgz，再按插件管理器安装。
 
 > 插件清单说明：`dsh-plugin.json` 只声明 Host facet（`facets.host`）；Web Client 半由 `package.json` 的 `dsh.client` 声明（同类第三方插件也采用该结构），因此未声明 `facets.client`。DSH 0.2.2-rc.1 的官方插件加载以 `package.json` 的 `dsh.bundle` / `dsh.client` 为准。
 
@@ -92,7 +96,7 @@ npm pack @game25011/dsh-notify-toast --registry=https://registry.npmjs.org/
 
 ### 方式 A：应用内插件管理器（推荐）
 
-1. 把交付的 `dsh-notify-toast-0.4.2.tgz` 放到本机任意目录（路径不要含空格）。
+1. 把交付的 `dsh-notify-toast-0.4.3.tgz` 放到本机任意目录（路径不要含空格）。
 2. 在 DSH 里让 Agent 用官方插件管理器安装，或使用插件管理界面：
    - Agent 工具：`plugin_manager` → `action: install_bundle`，`target: <tgz 绝对路径>`
    - 命令行：**仅适用于自管 profile（web/headless）**；官方 Desktop 的 desktop profile 由 Electron 应用的插件管理器管理，请用上面的界面或 Agent 方式。
@@ -113,7 +117,7 @@ plugin_manager → install_bundle → target: <插件目录绝对路径>
 本仓库自带 `market-index.json`。在 DSH 的插件市场/发现页添加自定义索引：
 
 ```text
-https://raw.githubusercontent.com/game25011/dsh-notify-toast/4a3c83e5634cf9dcac005ec2e9bbd4c4dd828596/market-index.json
+https://raw.githubusercontent.com/game25011/dsh-notify-toast/e0a6d60a2d9eb67953ed9af8a77943ab88340885/market-index.json
 ```
 
 添加后搜索 `dsh-notify-toast` 即可看到本插件，并从市场安装固定版本的 Git 源。

package/docs/INTERFACE.md

@@ -7,7 +7,7 @@
 
 ```
 PKG_ID    = 'dsh-notify-toast'      // package.json name / 客户端 ModuleLoader id / 行 id / settings ns
-VERSION   = '0.4.2'
+VERSION   = '0.4.3'
 RPC_CHANNEL = '/dsh-notify-toast'   // 官方 Connection RPC 频道（Host rpc.handle）
 LOCALE_NS = 'dsh-notify-toast'      // 客户端 locale 命名空间
 ```

package/dsh-plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "dsh.notify-toast",
   "name": "轻量原生通知（Windows）",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "manifestVersion": "0.15",
   "facets": {
     "host": { "entry": "lib/index.js", "apiVersion": "v1alpha1" }
@@ -10,5 +10,5 @@
   "permissions": [],
   "contributes": {},
   "subscriptions": [],
-  "notes": "单插件交付 Host + Web Client：Host 监听 approval/request、user-questions/request、根会话 session/event；原生进度模式下 Host 通过 PowerShell/C#/WinRT helper 创建带进度条的 Windows 原生通知，Web Notification 作为兼容回退；声音由本机 Web Audio 合成（另含内嵌的 uisfx CC0「弹一下」音频），点击回调经 Host 恢复/置前 DSH 窗口。Host 注册同源 webServer 前缀 RPC `/dsh-notify-toast`（config/save/poll/test/focus/health），复用官方 requestRejection 栅栏与一元 RPC 信封；poll 为长轮询，事件环形缓冲在内存、默认 200 条。插件配置经官方 settings 持久化；不访问外部网络、不调用模型、不采集；原生 helper 会写本机编译缓存；会加载 DSH 自带 koffi 原生绑定并调用 user32（仅用于点击回窗），失败降级 window.focus()。client bundle 只注册 settings.section；已删除 shell.overlay 应用内卡片死代码。设置导航行图标由客户端注入（DOM/CSS mask，无联网、无新权限）。capability 声明不构成沙箱。完成通知标题按场景自动生成（单步、2–4 步、5 步以上、提问、授权、全部完成、目标暂停/受阻），不再提供自定义完成标题。目标模式 active+armed 期间不逐轮发完成通知，按 goal/change 的 roundsStarted 增量在 complete/paused/blocked/round-limit/disarmed 后汇总一条；默认开启，可关闭；提问/授权仍即时。提示音新增可选「弹一下」：uisfx 0.4.0 的 CC0 音频内嵌，默认仍是叮咚。0.4.1 修复审批通知漏发（approval waterfall 观察者改为 prepend/global 并继续 next()）。0.4.0 新增任务栏未读角标：Host 用一次性 PowerShell/C# helper 调用 ITaskbarList3::SetOverlayIcon，按不同根会话计数，1–3 显示深灰底白字蓝环数字、超过 3 显示红点，窗口聚焦后清除；不增加常驻后台进程。0.3.0 使用 Host 侧 PowerShell/C#/WinRT helper 创建带动态进度条的 Windows 原生通知，自动移除时间为近似值（3–30 秒）：到期停止进度更新，短暂缓冲后 Hide() 收回横幅（ExpirationTime 约束通知中心保留）；helper 启动时后台预热并在 %LOCALAPPDATA%/dsh-notify-toast/native-cache 编译缓存一个小 DLL，编译/启动失败时自动退回 Web Notification。点击回调经 Host 的 127.0.0.1 loopback server 发布 activate 事件，尽量定位到对应会话；回调失败时不保证 session 定位。原生横幅实际停留时间仍由 Windows 控制。0.4.2 更新 DSH 0.2.2-rc.1 兼容声明与 engines.dsh 范围，不改变通知核心逻辑。"
+  "notes": "单插件交付 Host + Web Client：Host 监听 approval/request、user-questions/request、根会话 session/event；原生进度模式下 Host 通过 PowerShell/C#/WinRT helper 创建带进度条的 Windows 原生通知，Web Notification 作为兼容回退；声音由本机 Web Audio 合成（另含内嵌的 uisfx CC0「弹一下」音频），点击回调经 Host 恢复/置前 DSH 窗口。Host 注册同源 webServer 前缀 RPC `/dsh-notify-toast`（config/save/poll/test/focus/health），复用官方 requestRejection 栅栏与一元 RPC 信封；poll 为长轮询，事件环形缓冲在内存、默认 200 条。插件配置经官方 settings 持久化；不访问外部网络、不调用模型、不采集；原生 helper 会写本机编译缓存；会加载 DSH 自带 koffi 原生绑定并调用 user32（仅用于点击回窗），失败降级 window.focus()。client bundle 只注册 settings.section；已删除 shell.overlay 应用内卡片死代码。设置导航行图标由客户端注入（DOM/CSS mask，无联网、无新权限）。capability 声明不构成沙箱。完成通知标题按场景自动生成（单步、2–4 步、5 步以上、提问、授权、全部完成、目标暂停/受阻），不再提供自定义完成标题。目标模式 active+armed 期间不逐轮发完成通知，按 goal/change 的 roundsStarted 增量在 complete/paused/blocked/round-limit/disarmed 后汇总一条；默认开启，可关闭；提问/授权仍即时。提示音新增可选「弹一下」：uisfx 0.4.0 的 CC0 音频内嵌，默认仍是叮咚。0.4.1 修复审批通知漏发（approval waterfall 观察者改为 prepend/global 并继续 next()）。0.4.0 新增任务栏未读角标：Host 用一次性 PowerShell/C# helper 调用 ITaskbarList3::SetOverlayIcon，按不同根会话计数，1–3 显示深灰底白字蓝环数字、超过 3 显示红点，窗口聚焦后清除；不增加常驻后台进程。0.3.0 使用 Host 侧 PowerShell/C#/WinRT helper 创建带动态进度条的 Windows 原生通知，自动移除时间为近似值（3–30 秒）：到期停止进度更新，短暂缓冲后 Hide() 收回横幅（ExpirationTime 约束通知中心保留）；helper 启动时后台预热并在 %LOCALAPPDATA%/dsh-notify-toast/native-cache 编译缓存一个小 DLL，编译/启动失败时自动退回 Web Notification。点击回调经 Host 的 127.0.0.1 loopback server 发布 activate 事件，尽量定位到对应会话；回调失败时不保证 session 定位。原生横幅实际停留时间仍由 Windows 控制。0.4.2 更新 DSH 0.2.2-rc.1 兼容声明与 engines.dsh 范围，不改变通知核心逻辑。0.4.3 改用原生 settings.section.icon slot 修复设置页图标重复。"
 }

package/lib/client.js

@@ -37,7 +37,7 @@
         /** Locale namespace / settings namespace / client module id. */
         const NS = 'dsh-notify-toast'
         const RPC_CHANNEL = '/dsh-notify-toast'
-        const VERSION = '0.4.2'
+        const VERSION = '0.4.3'
 
         /** Multi-window leadership lease (localStorage, cross-tab visible). */
         const LEADER_STORAGE_KEY = 'dsh-notify-toast:leader'
@@ -1176,8 +1176,65 @@
           }
         }
 
+        /** Native settings.section.icon component (DSH 0.2.2+). */
+        function SettingsNavIcon(props) {
+          const size = props && Number.isFinite(props.size) && props.size > 0 ? props.size : NAV_ICON_SIZE
+          return h(
+            'svg',
+            {
+              width: size,
+              height: size,
+              viewBox: '0 0 16 16',
+              fill: 'none',
+              'aria-hidden': 'true',
+              style: { display: 'block' },
+            },
+            h('path', {
+              d: 'M4.4 6.5C4.4 4.5 5.9 2.9 8 2.9s3.6 1.6 3.6 3.6v2.6l1.05 2.05c.18.35-.08.75-.47.75H3.82c-.39 0-.65-.4-.47-.75L4.4 9.1Z',
+              stroke: 'currentColor',
+              strokeWidth: 1.4,
+              strokeLinejoin: 'round',
+              strokeLinecap: 'round',
+            }),
+            h('path', {
+              d: 'M6.55 13.3h2.9',
+              stroke: 'currentColor',
+              strokeWidth: 1.4,
+              strokeLinecap: 'round',
+            }),
+          )
+        }
+
+        /**
+         * Register the navigation icon through the native settings slot.
+         * DSH 0.2.2 added settings.section.icon; older versions fall back to
+         * the DOM claimer below. The slot replaces the shell's default gear
+         * instead of adding a second glyph beside it.
+         */
+        function registerSettingsNavIcon(ctx) {
+          if (!ctx || !ctx.slots || typeof ctx.slots.inject !== 'function' || typeof ctx.slots.register !== 'function') return false
+          try {
+            ctx.slots.inject('settings.section.icon', () => {
+              try {
+                return ctx.slots.register(
+                  { name: 'settings.section.icon', id: PKG_ID },
+                  SettingsNavIcon,
+                )
+              } catch (error) {
+                warn('cannot register the native settings nav icon', error)
+                return () => {}
+              }
+            })
+            return true
+          } catch (error) {
+            warn('cannot wait for the native settings nav icon slot', error)
+            return false
+          }
+        }
+
         /**
-         * Replace this plugin's fallback gear with the bell mark.
+         * Older-DSH fallback: replace this plugin's default gear with the bell
+         * mark by claiming its own nav row.
          *
          * @param ctx - client context, for effect ownership.
          * @param resolveLabel - current localized section label, re-read on
@@ -3406,9 +3463,9 @@
             }
           }
 
-          // The shell projects no icon field for a section (see the nav-icon
-          // block above); claim this plugin's row so it does not wear the gear.
-          installSettingsNavIcon(ctx, () => t('nav'))
+          // DSH 0.2.2 projects a native settings.section.icon slot; use it
+          // first. Only older shells fall back to claiming the rendered row.
+          if (!registerSettingsNavIcon(ctx)) installSettingsNavIcon(ctx, () => t('nav'))
 
           // ---- 15. Start ----
           status.focused = isFocused()

package/lib/config.js

@@ -11,7 +11,7 @@
 /** package.json name / client module id / loader row id / settings namespace. */
 export const PKG_ID = 'dsh-notify-toast'
 /** Plugin version reported by every RPC endpoint. */
-export const VERSION = '0.4.2'
+export const VERSION = '0.4.3'
 /** Official Connection RPC channel (registered by the Host half). */
 export const RPC_CHANNEL = '/dsh-notify-toast'
 /** Settings namespace: the profile patch row id, which is also the package id. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@game25011/dsh-notify-toast",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "DSH 后台时的 Windows 原生通知与任务栏未读角标：提醒提问/授权/根会话完成，原生进度条与近似自动移除时间，按根会话显示 1–3 或红点，点击尽量回到对应会话；不访问外部网络、不调模型。Windows native toast notifications and a taskbar unread badge for DeepSeek Harness when the window is unfocused.",
   "type": "module",
   "main": "lib/index.js",