@game25011/dsh-notify-toast 0.4.1 → 0.4.2

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.4.2 — 2026-11-07
+
+- 元数据与兼容声明补丁：支持 DSH Desktop 0.2.2-rc.1，`engines.dsh` 显式覆盖 `0.2.2-rc.x` 范围，更新 README 徽标。
+- 未修改通知核心逻辑；94 项单测、26 项 client smoke、Host integration probe 通过；设置页图标待实际界面确认。
+
 ## 0.4.1 — 2026-11-04
 
 - 修复审批通知漏发：`approval/request` 是 waterfall，UI 审批应答器可能先处理并短路；观察者改为 `prepend + global`，发布事件后始终 `next()` 委托，不改变审批结果。

package/README.en.md

@@ -4,19 +4,23 @@
 
 English | [中文](./README.md)
 
-[![CI](https://github.com/game25011/dsh-notify-toast/actions/workflows/ci.yml/badge.svg)](https://github.com/game25011/dsh-notify-toast/actions/workflows/ci.yml) ![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg) ![DSH](https://img.shields.io/badge/DSH-0.2.1--rc.2-blue) ![Platform: Windows 10/11](https://img.shields.io/badge/platform-Windows%2010%2F11-0078D4)
+[![CI](https://github.com/game25011/dsh-notify-toast/actions/workflows/ci.yml/badge.svg)](https://github.com/game25011/dsh-notify-toast/actions/workflows/ci.yml) ![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg) ![DSH](https://img.shields.io/badge/DSH-0.2.2--rc.1-blue) ![Platform: Windows 10/11](https://img.shields.io/badge/platform-Windows%2010%2F11-0078D4)
 
 > 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.1` · License: MIT
-- npm status: **not published**. Do not run `npm install dsh-notify-toast`; that npm name belongs to a different project.
+- 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`).
 - 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.1-rc.2` (Electron shell, `desktop` profile), Windows 10/11
+- 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.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.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.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.
+
 ## 0.4.1 update
 
 Fixes missed approval notifications: DSH's `approval/request` is a waterfall and the UI approval answerer may claim and short-circuit it. The plugin observer now uses `prepend + global`, publishes the notification, and always delegates with `next()`; it never changes the approval outcome.
@@ -30,6 +34,9 @@ The goal is a **lightweight, native, extensible and quiet** Windows notification
 - **Extensible**: MIT-licensed, with separated Host/Client/native helper layers and an open `docs/INTERFACE.md`. Users can tune settings, fork the project, or add notification kinds, sounds and routes through the interfaces. There is no in-app scripting or third-party runtime extension API yet; deep customization requires code changes.
 - **Continuously maintained**: compatibility, installation reliability and real feedback come first; no feature-count race.
 
+## Overview
+
+A lightweight DSH notification plugin with on-demand helper startup and no persistent background services. It combines sound alerts, native Windows notifications, and taskbar unread badges, empirically covering ~90% of daily DSH notification scenarios based on real usage (an estimate, not an absolute guarantee). Built under MIT with a layered Host/Client/native helper architecture, it supports config tweaks and forks (no runtime scripting API; deep customization requires modifying code). Primary code is AI-assisted, while human maintainers oversee requirements, debugging, testing, and releases, aiming for ongoing DSH compatibility.
 ## AI-assisted development
 
 Most of this project’s code — Host, Web Client, PowerShell/C# native helpers, and most tests/docs — was generated by AI coding assistants; the human maintainer is responsible for requirements, debugging, testing, releases, and maintenance. AI-generated content may be wrong, and issues and pull requests are welcome. This project is licensed under the MIT License; AI tools are not authors, copyright holders, or responsible parties, and this disclosure is not legal advice. See [AI-DISCLOSURE.md](AI-DISCLOSURE.md).
@@ -69,13 +76,21 @@ 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 status: **not published**. Do not use `npm install dsh-notify-toast`; the npm name belongs to a different project.
+> 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.
+
+> 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`.
+
+### Option 0: npm package (optional)
+
+```text
+npm pack @game25011/dsh-notify-toast --registry=https://registry.npmjs.org/
+```
 
-> 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.1-rc.2 plugin loading is driven by `dsh.bundle` / `dsh.client` in `package.json`.
+Then install the resulting tarball through the plugin manager; the in-app manager remains the recommended Desktop path.
 
 ### Option A: In-app plugin manager (recommended)
 
-1. Put the delivered `dsh-notify-toast-0.4.1.tgz` anywhere on the local machine (avoid spaces in the path).
+1. Put the delivered `dsh-notify-toast-0.4.2.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.
@@ -99,7 +114,7 @@ This repository ships `market-index.json`. Add this custom index in the DSH plug
 https://raw.githubusercontent.com/game25011/dsh-notify-toast/4a3c83e5634cf9dcac005ec2e9bbd4c4dd828596/market-index.json
 ```
 
-Then search for `dsh-notify-toast` and install the pinned Git version.  
+Then search for `dsh-notify-toast` and install the pinned Git version.
 This is a **self-hosted index**; the default DSH market does not automatically list this plugin, so other users must add the same index or the official catalog must include it.
 
 ### Upgrade
@@ -190,7 +205,7 @@ Host: koffi user32 SetForegroundWindow ← focus
 
 | Item | Notes |
 |---|---|
-| DSH | `0.2.1-rc.2` (`engines.dsh: >=0.2.1-rc.2 <0.3.0`); the Host event/RPC/settings contracts this plugin relies on were tested on this version. |
+| DSH | `0.2.2-rc.1` (`engines.dsh: >=0.2.1-rc.2 <0.2.2-0 || >=0.2.2-rc.0 <0.3.0`); the Host event/RPC/settings contracts this plugin relies on were tested on this version. |
 | Operating system | Windows 10/11 (native toast + koffi user32 window focus); macOS/Linux untested (the plugin targets Windows). |
 | Runtime form | DSH Desktop (Electron, page origin `dsh-app://app`). Under a regular browser Web profile toasts still work, but "raise the Windows window" degrades to focusing the browser itself. |
 | Notification permission | The Windows notification center must allow notifications for the application; Electron Desktop grants non-media permissions by default. If disabled by the OS or group policy, the plugin degrades without crashing. |

package/README.md

@@ -6,18 +6,22 @@
 
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 [![CI](https://github.com/game25011/dsh-notify-toast/actions/workflows/ci.yml/badge.svg)](https://github.com/game25011/dsh-notify-toast/actions/workflows/ci.yml)
-![DSH](https://img.shields.io/badge/DSH-0.2.1--rc.2-blue)
+![DSH](https://img.shields.io/badge/DSH-0.2.2--rc.1-blue)
 ![Platform](https://img.shields.io/badge/platform-Windows%2010%2F11-0078D4)
 
 > dsh-notify-toast 是一款适用于 Windows 10/11 的非官方 DSH 插件（MIT 协议）。它提供聚焦不打扰的后台提醒，通过 Windows 原生通知提示提问、授权与根会话完成；任务栏未读角标按不同根会话计数，同一会话多次完成算一个，1–3 显示数字，超过 3 显示红点。主要代码由 AI 编程助手生成，人类维护者负责需求、调试、测试与发布。
 
-- 源码/本地包名：`dsh-notify-toast` · 版本：`0.4.1` · 许可：MIT · 仓库：https://github.com/game25011/dsh-notify-toast
-- npm 状态：**尚未发布**；不要执行 `npm install dsh-notify-toast`（该名称在 npm 上属于另一个项目）
-- 适用：DeepSeek Harness Desktop `0.2.1-rc.2`（Electron 壳，profile `desktop`），Windows 10/11
+- 源码/本地包名：`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`）
+- 适用：DeepSeek Harness Desktop `0.2.2-rc.1`（Electron 壳，profile `desktop`），Windows 10/11
 - 形态：DSH 官方 bundle（Host + Web Client 两半），通过官方插件管理器安装/卸载
-- 状态：0.4.1 修复审批通知漏发；0.4.0 新增任务栏未读角标（方案 B：不同根会话计数）；0.3.0 原生进度 toast、bar-only 样式、自动收回、点击回会话与 Goal 汇总已在本机简单实测；Goal 边界场景仍待补测；「全部完成后改写标题」为可选功能（默认关）
+- 状态：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.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 均通过；上游处于预发布期，不作长效兼容承诺。
+
 ## 0.4.1 更新
 
 修复审批通知可能不出现的问题：DSH 的 `approval/request` 是 waterfall，UI 审批应答器可能先处理并短路；插件观察者已改为 `prepend + global`，发布通知后始终 `next()` 委托，不改变审批结果。
@@ -31,6 +35,9 @@
 - **可自我拓展**：MIT 许可，Host/Client/原生 helper 分层，配置和 `docs/INTERFACE.md` 开放；使用者可以调整设置、自行 fork，或按接口增加通知类型、声音和路由。当前没有在线脚本或第三方运行时扩展 API，深度定制需要改代码。
 - **持续更新**：优先兼容性、安装可靠性和真实反馈，不追求功能堆叠。
 
+## 特色
+
+轻量级 DSH 通知插件，无常驻后台，helper 按需启动。联动提示音、Windows 原生通知与任务栏未读角标，依实际使用经验覆盖约 90% 日常提示场景（经验估测，非绝对保证）。采用 MIT 协议与 Host/Client/原生 helper 分层架构，支持修改配置与 fork 扩展（暂无在线脚本 API，深度定制需修改代码）。主体代码由 AI 辅助生成，人类维护者负责需求把控、调试、测试与发布维护，并以持续跟进 DSH 兼容为目标。
 ## AI 参与说明
 
 本项目的主要代码（Host、Web Client、PowerShell/C# 原生 helper 及多数测试/文档）由 AI 编程助手生成；人类维护者负责需求、调试、测试、发布和维护。AI 生成内容可能存在错误，欢迎提交 issue 或 pull request。本项目采用 MIT License，AI 工具不是作者、版权持有者或责任主体，本说明不构成法律意见。详见 [AI-DISCLOSURE.md](AI-DISCLOSURE.md)。
@@ -71,13 +78,21 @@
 
 > 本插件只通过 **官方插件管理器** 或 GitHub Release 安装；不要手改 profile 的 `package.json` 或 `cordis.patch.yml`。
 >
-> npm 包：`@game25011/dsh-notify-toast`；npm 包用于分发/检视，DSH Desktop 仍推荐使用应用内插件管理器安装。
+> npm 包：`@game25011/dsh-notify-toast@0.4.2`；可用 `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` 为准。
+
+### 方式 0：npm 包（可选）
+
+```text
+npm pack @game25011/dsh-notify-toast --registry=https://registry.npmjs.org/
+```
 
-> 插件清单说明：`dsh-plugin.json` 只声明 Host facet（`facets.host`）；Web Client 半由 `package.json` 的 `dsh.client` 声明（同类第三方插件也采用该结构），因此未声明 `facets.client`。DSH 0.2.1-rc.2 的官方插件加载以 `package.json` 的 `dsh.bundle` / `dsh.client` 为准。
+然后按下面的 tgz / 插件管理器方式安装；DSH Desktop 仍推荐应用内插件管理器。
 
 ### 方式 A：应用内插件管理器（推荐）
 
-1. 把交付的 `dsh-notify-toast-0.4.1.tgz` 放到本机任意目录（路径不要含空格）。
+1. 把交付的 `dsh-notify-toast-0.4.2.tgz` 放到本机任意目录（路径不要含空格）。
 2. 在 DSH 里让 Agent 用官方插件管理器安装，或使用插件管理界面：
    - Agent 工具：`plugin_manager` → `action: install_bundle`，`target: <tgz 绝对路径>`
    - 命令行：**仅适用于自管 profile（web/headless）**；官方 Desktop 的 desktop profile 由 Electron 应用的插件管理器管理，请用上面的界面或 Agent 方式。
@@ -101,7 +116,7 @@ plugin_manager → install_bundle → target: <插件目录绝对路径>
 https://raw.githubusercontent.com/game25011/dsh-notify-toast/4a3c83e5634cf9dcac005ec2e9bbd4c4dd828596/market-index.json
 ```
 
-添加后搜索 `dsh-notify-toast` 即可看到本插件，并从市场安装固定版本的 Git 源。  
+添加后搜索 `dsh-notify-toast` 即可看到本插件，并从市场安装固定版本的 Git 源。
 这是**自托管索引**；DSH 官方默认索引不会自动收录本插件，其他用户需要添加同一索引或由官方目录收录。
 
 ### 升级
@@ -197,7 +212,7 @@ Host: koffi user32 SetForegroundWindow ← focus
 
 | 项目 | 说明 |
 |---|---|
-| DSH | `0.2.1-rc.2`（`engines.dsh: >=0.2.1-rc.2 <0.3.0`）；依赖的 Host 事件/RPC/settings 契约在本版本实测 |
+| DSH | `0.2.2-rc.1`（`engines.dsh: >=0.2.1-rc.2 <0.2.2-0 || >=0.2.2-rc.0 <0.3.0`）；Host 事件/RPC/settings 契约在本版本实测 |
 | 操作系统 | Windows 10/11（原生 toast + koffi user32 置前）；macOS/Linux 未验证（本插件目标为 Windows） |
 | 运行形态 | DSH Desktop（Electron，页面 origin `dsh-app://app`）。普通浏览器 Web profile 下 toast 可用，但"置前 Windows 窗口"会降级为浏览器自身聚焦 |
 | 通知权限 | Windows 通知中心需允许应用通知；Electron Desktop 默认放行非媒体权限，若被系统/组策略禁用则只降级不崩溃 |

package/docs/INTERFACE.md

@@ -7,7 +7,7 @@
 
 ```
 PKG_ID    = 'dsh-notify-toast'      // package.json name / 客户端 ModuleLoader id / 行 id / settings ns
-VERSION   = '0.4.1'
+VERSION   = '0.4.2'
 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.1",
+  "version": "0.4.2",
   "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 控制。"
+  "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 范围，不改变通知核心逻辑。"
 }

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.1'
+        const VERSION = '0.4.2'
 
         /** Multi-window leadership lease (localStorage, cross-tab visible). */
         const LEADER_STORAGE_KEY = 'dsh-notify-toast:leader'

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.1'
+export const VERSION = '0.4.2'
 /** 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.1",
+  "version": "0.4.2",
   "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",
@@ -29,7 +29,7 @@
     "CHANGELOG.md"
   ],
   "engines": {
-    "dsh": ">=0.2.1-rc.2 <0.3.0",
+    "dsh": ">=0.2.1-rc.2 <0.2.2-0 || >=0.2.2-rc.0 <0.3.0",
     "node": ">=20"
   },
   "author": "game25011 <1449262586@QQ.com>",