dsh-notify-me 1.1.0 → 1.1.2

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to **dsh-notify-me** are documented here.
 
+## [1.1.2] — 2026-09-08
+
+### 变更
+- **README 新增「为什么需要它」**（中英双语）：把定位写清楚——不开完整访问要付「等待」成本，开了要付「不可逆风险」成本；插件把「监督」与「守在屏幕前」解耦，**让你敢不开完整访问**，并注明它不降低 full access 本身的权限风险（它不是沙箱）。
+- README 预览图改用绝对地址：`docs/` 不在发布文件集内，相对路径在 npm 页面会裂；简体版补齐 bundle 体积 badge，与英文版对齐。
+- 中文正文标点统一：半角 `;` → `；`，直引号 `"…"` → `「…」`。
+- 仓库新增 `.gitignore`（`node_modules/`、`.npm-cache/`、`*.tgz`）。
+
+### 修复
+- `window.__dshNotifyMe.version` 与包版本脱节（停在 `0.2.0`），现随 `package.json` 同步为 `1.1.2`。
+- `CHANGELOG` 1.0.0 条目中的字面量 `\n`（页面上会渲染成 "\n"）改为真实换行；1.0.1 条目英文措辞自相矛盾处修正；版本链接修正为真实存在的目标（1.0.0 / 1.0.1 没有对应 git tag，原链接 404）。
+
+## [1.1.1] — 2026-09-08
+
+### Fixed
+- **测试按钮不再被「页面打开时也提醒」开关吞掉**：页面可见且「回复完成」保持默认（仅后台提醒）时，点「测试「回复完成」」现在会正常弹出提醒——测试路径改为绕过可见性规则（只受主开关与浏览器通知权限影响），并补上对应的回归用例。
+- 「需要你」测试提醒的标签页标记约 6 秒后自动消失，不再留下一个看起来像「真有待办」的常驻标记。
+
 ## [1.1.0] — 2026-09-08
 
 ### Added
@@ -14,23 +32,26 @@ All notable changes to **dsh-notify-me** are documented here.
 - `lib/client.js` 重写：提醒核心保持零第三方依赖与自包含；新增语言解析/多语言文案表与可选 Settings 页面（依赖 `slots`/`locale`/`react`，注册前做能力守卫）。
 - 冒烟测试扩展：覆盖主开关、`language` 中英切换后的通知文案与标题标记、`resetConfig` 恢复新增默认项。
 
-## [1.0.1] — 2026-09-08
+## 1.0.1 — 2026-09-08
 
 ### Changed
-- README is now **简体中文-primary** homepage with a `简体中文` homepage plus an English version (`README.en.md`), plus this changelog, mirroring the ecosystem's documentation conventions.
+- README is now a **Simplified-Chinese-primary** homepage (`README.md`) with a parallel English version (`README.en.md`) and this changelog, mirroring the ecosystem's documentation conventions.
 - `package.json`: added `publishConfig.access: public`, `repository`/`homepage`/`bugs` links, and added `README.en.md` + `CHANGELOG.md` to the published `files` set.
 
-## [1.0.0] — 2026-09-08
+## 1.0.0 — 2026-09-08
 
 ### Added
 - First release. Browser-layer desktop reminder plugin for the DeepSeek Harness web UI.
 - 🔔 **Needs-your-input alerts**: fires on new pending interactions — sandbox `approval`, `plan-review`, and `question` (`ask_user_question`) — with toast + sound + `🔔 需要你 ·` tab-title marker (alerts even while the page is visible).
 - ✅ **Reply-finished alerts**: detects the selected session's `running: true → false` edge (and background sessions' completion) — toast + sound, by default only while the page is hidden/backgrounded.
 - Clicking a toast focuses the DSH window.
-- Zero-UI, zero-server-logic: pure client-side bundle subscribing to the `sessions` service; preferences in `localStorage`; auditable, self-contained code (`<20 KB`).
-- Offline smoke test (`smoke/smoke-test.cjs`) covering the alert state machine.\n- Screenshot + `screenshots.json` for the plugin-market page; UI preview shown in the README.
+- Zero-UI, zero-server-logic: pure client-side bundle subscribing to the `sessions` service; preferences in `localStorage`; auditable, self-contained code (`<20 KB` at 1.0.0).
+- Offline smoke test (`smoke/smoke-test.cjs`) covering the alert state machine.
+- Screenshot + `screenshots.json` for the plugin-market page; UI preview shown in the README.
 
 <!-- versions -->
+> 1.0.0 与 1.0.1 早于本仓库的 GitHub 标签历史（tag 从 `v1.1.0` 起，且 npm 上只有 1.0.0 / 1.1.0 / 1.1.1），故不附链接。
+
+[1.1.2]: https://github.com/chromoany/dsh-notify-me/compare/v1.1.1...v1.1.2
+[1.1.1]: https://github.com/chromoany/dsh-notify-me/compare/v1.1.0...v1.1.1
 [1.1.0]: https://github.com/chromoany/dsh-notify-me/releases/tag/v1.1.0
-[1.0.1]: https://github.com/chromoany/dsh-notify-me/compare/v1.0.0...v1.0.1
-[1.0.0]: https://github.com/chromoany/dsh-notify-me/releases/tag/v1.0.0

package/README.en.md

@@ -14,13 +14,26 @@
 
 ---
 
+## Why you need it
+
+Both of DSH's permission modes cost you something:
+
+| Mode | What it costs you | Cost type |
+| --- | --- | --- |
+| No full access (`workspace-write` + ask) | **Waiting** — the agent stops on an approval; if you aren't watching the page, you're just burning wall-clock time | Time, growing with the number of sessions |
+| Full access | **Irreversible risk** — you give up the ability to intercept before anything happens | Risk, independent of whether you watch |
+
+dsh-notify-me decouples **supervision** from **sitting in front of the screen**: it pulls you back with a system notification only when a decision is genuinely needed (approval / plan review / question) or a reply finishes — **so you can afford to keep full access off** instead of trading away interception for speed. It does not lower the risk of full access itself (it is not a sandbox); it just drives the waiting cost of ask-mode down to roughly zero.
+
+---
+
 > 🔎 Looking for it? Search `dsh-notify-me`, **message alerts**, **notification**, **desktop notification**, **reminder**, **approval alert** or **可操作提醒 / 消息提醒 / 桌面通知 / 需要你操作** (npm keywords include both English and Chinese terms).
 
 ## UI Preview
 
 | Windows system notification |
 | --- |
-| ![DSH notification](docs/screenshots/notify-toast.png) |
+| ![DSH notification](https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/screenshots/notify-toast.png) |
 
 [Changelog](CHANGELOG.md)
 
@@ -39,7 +52,7 @@ Open **Settings → Notify me** (refresh the page once after installing):
 - **System notifications / Sound / Volume** — toast toggle, WebAudio beep toggle and a volume slider;
 - **"Needs you" alerts while the page is open** (default on) and **"Reply finished" alerts while the page is open** (default off);
 - **Notification language** — follow the interface / 简体中文 / English: controls the language of the alert text and the `🔔 …` title marker;
-- **Test buttons** — send one "needs you" or "reply finished" test alert with the current settings.
+- **Test buttons** — send one "needs you" or "reply finished" test alert with the current settings (**not** limited by the "while the page is open" toggles; the "needs you" test's title marker clears itself after ~6s).
 
 > Notification permission is required: click once on the page → **Allow** (or address-bar lock → Site settings → Notifications → Allow → reload).
 
@@ -99,7 +112,7 @@ The browser half subscribes to the client `sessions` service — the same source
 - the **selected session's** `ConversationSnapshot`: a `running: true → false` edge means a reply finished; a new entry in `pending[]` of kind `approval` / `plan-review` / `question` means the agent is waiting on you (payload text is shown in the alert when available);
 - **every other listed session's** summary: a new `pendingInteraction`, or the `completed` edge (finished while not selected), alerts you about background work.
 
-The reminder core stays dependency-free and self-contained: notification copy resolves at alert time from the chosen language (follow-interface / Simplified Chinese / English). The Settings page is an **optional** React surface — it only registers into Settings when the web profile provides the `slots` / `locale` services and react; without them the plugin degrades gracefully to alerts-only (no Settings page).
+The reminder core stays dependency-free and self-contained: notification copy resolves at alert time from the chosen language (follow-interface / Simplified Chinese / English). The Settings page is an **optional** React surface — it only registers into Settings when the web profile provides the `slots` / `locale` services and `react`; without them the plugin degrades gracefully to alerts-only (no Settings page).
 
 ## Known limitations
 

package/README.md

@@ -6,6 +6,7 @@
 [![npm downloads](https://img.shields.io/npm/dm/dsh-notify-me?style=flat-square&label=downloads&color=1F883D)](https://www.npmjs.com/package/dsh-notify-me)
 ![License](https://img.shields.io/badge/license-MIT-blue)
 ![Platform](https://img.shields.io/badge/platform-browser-blue)
+![Size](https://img.shields.io/badge/bundle-%7E37KB-green)
 
 ---
 
@@ -13,13 +14,26 @@
 
 ---
 
+## 为什么需要它
+
+DSH 的两种权限模式各有代价：
+
+| 模式 | 你付出的代价 | 代价形态 |
+| --- | --- | --- |
+| 不开完整访问（`workspace-write` + ask） | **等待**——agent 卡在审批上，不盯着页面就是干等 | 时间成本，随会话数增长 |
+| 开完整访问（full access） | **不可逆风险**——放弃的是事前拦截能力 | 风险成本，与你盯不盯无关 |
+
+dsh-notify-me 把「监督」和「守在屏幕前」解耦：只在真的出现决策点（审批 / 方案确认 / 提问）或回复跑完时，才用系统通知把你叫回来——**让你敢不开完整访问**，不必靠放弃拦截能力来换效率。它不降低 full access 本身的权限风险（它不是沙箱），只是把 ask 模式的等待成本压到接近零。
+
+---
+
 > 🔎 想找这个插件？可以搜：`dsh-notify-me`、**消息提醒**、**可操作提醒**、**桌面通知**、**需要你操作**、**回复完成提醒**、**后台完成提醒**（npm 关键词已含以上中英文词）。
 
 ## 效果预览
 
 | Windows 系统通知效果 |
 | --- |
-| ![DSH 通知效果](docs/screenshots/notify-toast.png) |
+| ![DSH 通知效果](https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/screenshots/notify-toast.png) |
 
 [更新日志](CHANGELOG.md)
 
@@ -36,19 +50,19 @@
 
 - **启用提醒** 主开关：关闭后不再弹系统通知、不播放提示音、也不改标签页标题；
 - **系统通知 / 提示音 / 音量**：Toast、WebAudio 提示音与音量滑块；
-- **页面打开时也提醒「需要你」**（默认开）与 **页面打开时也提醒「回复完成」**（默认关）;
+- **页面打开时也提醒「需要你」**（默认开）与 **页面打开时也提醒「回复完成」**（默认关）；
 - **通知语言**：跟随界面 / 简体中文 / English——决定通知文字与 `🔔 …` 标题标记使用的语言；
-- **测试按钮**：用当前设置立即发一条「需要你」或「回复完成」测试提醒。
+- **测试按钮**：用当前设置立即发一条「需要你」或「回复完成」测试提醒（**不受**上面「页面打开时也提醒」开关限制；「需要你」测试的标题标记约 6 秒后自动消失）。
 
 > 需要浏览器通知权限：页面上点一下 → 允许；或地址栏锁 → 站点设置 → 通知 → 允许 → 刷新。
 
 ## 提醒方式
 
 - **系统通知**：Windows 通知中心 Toast（点击可把 DSH 窗口切回前台）
-- **提示音**：WebAudio 合成音（"需要你"与"完成"使用不同音型）
+- **提示音**：WebAudio 合成音（「需要你」与「完成」使用不同音型）
 - **标签页标题标记**：有待处理事项时，标题前出现 `🔔 需要你 · …` / `🔔 Action needed · …`
 
-本插件是**浏览器层**实现：DSH 页面需保持打开（最小化/后台即可——那正是它监听的"离开"状态）。
+本插件是**浏览器层**实现：DSH 页面需保持打开（最小化/后台即可——那正是它监听的「离开」状态）。
 
 ## 安装
 
@@ -62,11 +76,11 @@ dsh plugin --profile web add dsh-notify-me
 **验证** — F12 控制台执行：
 
 ```js
-window.__dshNotifyMe.test("done")        // "完成"示例
-window.__dshNotifyMe.test("attention")   // "需要你"示例
+window.__dshNotifyMe.test("done")        // 「完成」示例
+window.__dshNotifyMe.test("attention")   // 「需要你」示例
 ```
 
-没反应？九成是：通知权限被拒绝（在页面上点一下 → 选"允许"；或地址栏锁 → 站点设置 → 通知 → 允许 → 刷新）、装完没重启 DSH、系统设置里浏览器通知被关。
+没反应？九成是：通知权限被拒绝（在页面上点一下 → 选「允许」；或地址栏锁 → 站点设置 → 通知 → 允许 → 刷新）、装完没重启 DSH、系统设置里浏览器通知被关。
 
 ## 控制台高级配置
 
@@ -77,8 +91,8 @@ window.__dshNotifyMe.config                       // 查看
 window.__dshNotifyMe.setConfig({
   enabled: true,           // false = 关闭所有提醒（主开关）
   language: "auto",        // 'auto' 跟随界面 | 'zh' 简体中文 | 'en' English
-  attentionHiddenOnly: false, // true = 页面可见时"需要你"不提醒
-  doneHiddenOnly: true,       // false = 页面可见时"完成"也提醒
+  attentionHiddenOnly: false, // true = 页面可见时「需要你」不提醒
+  doneHiddenOnly: true,       // false = 页面可见时「完成」也提醒
   toast: true,                // 系统通知开关
   sound: true,                // 提示音开关
   volume: 0.5,                // 音量 0~1

package/lib/client.js

@@ -295,6 +295,22 @@ window.__ModuleLoader__.load({
       if (snippet) body = body + "\n" + snippet;
       fire("done", d.doneTitle, body);
     }
+    // Test alerts deliberately ignore the visibility rules (attentionHiddenOnly
+    // / doneHiddenOnly): the whole point of a test button is to prove the
+    // channel works while you are looking at the page. Only the master switch
+    // (and browser notification permission) can stop them. The attention test
+    // also drops its title marker again shortly after, so a test never leaves a
+    // standing "waiting on you" mark in the tab.
+    var TEST_MARK_RELEASE_MS = 6000;
+    function testAlert(kind) {
+      var d = texts();
+      if (kind === "attention") {
+        deliver("attention", "DSH · " + d.kind.question, d.testAttention);
+        setTimeout(function () { releaseTitleMark(); }, TEST_MARK_RELEASE_MS);
+      } else {
+        deliver("done", d.doneTitle, d.testDone);
+      }
+    }
 
     // ───────────────────────── state machine ─────────────────────────
     // prevById: per-session-id baseline of what we have already reported.
@@ -473,7 +489,8 @@ window.__ModuleLoader__.load({
 
     // ──────────────────────── global control API ─────────────────────
     var api = {
-      version: "0.2.0",
+      // keep in sync with package.json "version" on every release
+      version: "1.1.2",
       get config() { return readConfig(); },
       setConfig: function (patch) { return setConfigLocal(patch); },
       resetConfig: function () {
@@ -482,12 +499,11 @@ window.__ModuleLoader__.load({
         return config;
       },
       // manual test; run it after clicking anywhere so permission can be granted.
+      // Test alerts fire regardless of the page-open visibility rules.
       test: function (kind) {
         kind = kind === "attention" ? "attention" : "done";
         unlockOnce();
-        var d = texts();
-        if (kind === "attention") fireAttention("question", "", d.testAttention);
-        else fireDone("", d.testDone);
+        testAlert(kind);
         return "sent " + kind + " (lang=" + effectiveLang() + ", permission=" + ("Notification" in window ? Notification.permission : "n/a") + ")";
       }
     };
@@ -519,7 +535,7 @@ window.__ModuleLoader__.load({
       langAutoNote: "（跟随界面）",
       current: "界面当前语言",
       testTitle: "快速测试",
-      testHint: "用当前设置各发一条测试提醒。",
+      testHint: "用当前设置各发一条测试提醒（不受上面「页面打开时也提醒」开关限制）。",
       testAttention: "测试「需要你」",
       testDone: "测试「回复完成」",
       reset: "恢复默认设置",
@@ -550,7 +566,7 @@ window.__ModuleLoader__.load({
       langAutoNote: " (follows the interface)",
       current: "Current interface language",
       testTitle: "Quick test",
-      testHint: "Send one test alert with the current settings.",
+      testHint: "Send one test alert with the current settings (not limited by the \"while the page is open\" toggles above).",
       testAttention: "Test \"needs you\"",
       testDone: "Test \"reply finished\"",
       reset: "Restore defaults",
@@ -636,8 +652,9 @@ window.__ModuleLoader__.load({
       function runTest(kind) {
         if (!config.enabled) { setFeedback(t("offHint")); return; }
         unlockOnce();
-        if (kind === "attention") fireAttention("question", "", texts().testAttention);
-        else fireDone("", texts().testDone);
+        // Bypasses the visibility rules on purpose: a test must fire while the
+        // page is open, otherwise the button proves nothing.
+        testAlert(kind);
         var langName = effectiveLang() === "en" ? t("langEn") : t("langZh");
         setFeedback(t("sent") + langName);
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-notify-me",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "DSH 桌面消息提醒插件：模型需要你操作（审批/方案确认/提问的可操作提醒）或回复在后台完成时，系统通知+提示音+标签页标题提醒你；可在设置页开关并切换通知语言。Desktop notification & message alerts for DeepSeek Harness web — toasts, sounds and a tab-title marker when the agent needs your input (approval / plan review / question) or a reply finishes in the background; toggleable from Settings with zh/en notification language.",
   "license": "MIT",
   "type": "module",