dsh-notify-me 1.9.0 → 1.9.2

package/CHANGELOG.md

@@ -2,6 +2,32 @@
 
 All notable changes to **dsh-notify-me** are documented here.
 
+## [1.9.2] — 2026-10-20
+
+### 变更
+
+- **设置页的说明文字改成悬浮提示**：每行只留标题，鼠标移上去约 0.3 秒后在指针旁边弹出小方框显示原来的说明；靠近视口右侧/底部自动翻到另一边，滚动即收起。页面因此短了很多，一屏能扫完所有开关。
+- 读屏仍能读到完整说明（每行保留视觉隐藏的 `.dnm-srOnly` 文本）；音量百分比、权限提示、外部推送说明这类状态信息仍常显。
+- README（中英）与设置页预览截图同步更新；徽章 bundle 尺寸更新为 ~164 KiB。
+
+### 测试
+
+- `npm test` 两套件通过；另在无头 Chromium 里用真 bundle + 假设置外壳验证悬浮出现/跟随/右缘翻转的坐标（`box=544,827 270x50 vw=900` 未越界）与中英两版截图。
+
+## [1.9.1] — 2026-10-20
+
+### 新增
+
+- **设置左侧导航行换成品牌铃铛**：DSH 的设置外壳按分区 id 硬编码导航图标，`settings.section` 没有图标字段，所以插件改为面板渲染后打补丁——按本地化标签找到自己那一行的导航按钮，把宿主生成的 `<svg>` 换成品牌线稿（形状与 `docs/brand/icon-outline.svg` 一致），沿用宿主给的 icon class，并用 MutationObserver 跟随面板重渲染与重开。
+- 宿主改结构时补丁静默放弃，显示回默认齿轮，其他功能不受影响。
+
+### 变更
+
+- README（中英）与 `docs/brand/README.md` 的旧口径「导航行图标换不了」改成实际做法与失效条件；`screenshots.json` 补上 1.8.0 / 1.9.0 的截图并修正已删除的 `.jpg` 路径；徽章 bundle 尺寸更新为 ~161 KiB。
+
+### 测试
+
+- `npm test` 两套件通过；另用真 bundle + 合成宿主面板（`data-shortcut-modal="settings"`、`button.navCell > svg + span.navLabel`）在无头 Chromium 里验证：三行导航里只有「通知提醒」变成铃铛（`data-dnm-nav="1"`、三条 shape），另外两行保持齿轮，图标 class 未丢。
 ## [Unreleased]
 
 ### 兼容性

package/README.en.md

@@ -13,7 +13,7 @@
 [![npm total downloads](https://img.shields.io/npm/dt/dsh-notify-me?style=flat-square&label=total%20downloads&color=1F883D)](https://www.npmjs.com/package/dsh-notify-me)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)
 [![DSH Web and Desktop](https://img.shields.io/badge/DSH-Web%20%7C%20Desktop-blue?style=flat-square)](#installation)
-[![Client bundle size](https://img.shields.io/badge/client-%7E156%20KiB-green?style=flat-square)](lib/client.js)
+[![Client bundle size](https://img.shields.io/badge/client-%7E164%20KiB-green?style=flat-square)](lib/client.js)
 [![DSH Compatibility](https://img.shields.io/badge/DSH-tested%200.2.1--rc.2-6366f1.svg?style=flat-square)](#compatibility)
 [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
 
@@ -47,7 +47,7 @@ A notification plugin for DSH Web / Desktop, so you can keep full access off wit
 
 ![The Notify me settings page: header, how you get told, when to alert, try it, and the collapsed Advanced block](https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/screenshots/settings-en.png)
 
-The real settings component (v1.9.0 defaults) rendered full-page in a standalone demo shell; the sidebar is kept for context, it is not the DSH shell.
+The real settings component (v1.9.2 defaults) rendered as the content column in a standalone demo shell. Row explanations now live in a hover tooltip, which is why only the titles show here.
 </details>
 
 ## Installation
@@ -116,7 +116,7 @@ dsh-notify-me decouples **supervision** from **sitting in front of the screen**:
 
 ## Configure it from DSH Settings
 
-Open **Settings → Notify me**. The page runs as how you get told, when to alert, and a try-it block; the knobs you rarely touch fold into **Advanced** at the bottom.
+Open **Settings → Notify me**. The page runs as how you get told, when to alert, and a try-it block; the knobs you rarely touch fold into **Advanced** at the bottom. Rows show titles only — the explanation pops up next to the pointer on hover, with a hidden copy kept for screen readers.
 
 ### How you get told
 
@@ -193,7 +193,7 @@ The last block inside Advanced. The page protocol is detected automatically to t
 
 </details>
 
-> The settings sidebar icon is rendered by the DSH settings shell: it hard-codes icons per section id (account / models / agent-presets / plugins / archived-sessions) and gives every other section the default gear — `settings.section` has no icon field, so the plugin's bell can only appear inside its own page.
+> The settings sidebar icon is rendered by the DSH settings shell: it hard-codes icons per section id (account / models / agent-presets / plugins / archived-sessions) and `settings.section` has no icon field. The plugin therefore patches that row after the panel renders: it finds its own entry by the localised label text, swaps the host `<svg>` for the brand bell (keeping the host icon class), and follows re-renders with a MutationObserver; if the host changes its markup the patch quietly gives up and the default gear stays.
 
 > Notification permission is required: click once on the page → **Allow** (or address-bar lock → Site settings → Notifications → Allow → reload). On macOS, also allow the browser under System Settings → Notifications.
 
@@ -322,7 +322,7 @@ Verified on the real shell (DSH Desktop 0.2.0-rc.2, three rounds of retesting in
 - "Stay quiet for the conversation on screen" is judged by `document.hidden`: a window fully covered by other apps still counts as visible, so waits in the current conversation stay quiet there too.
 - External notification forwarding is subject to browser CORS rules: an endpoint that does not allow cross-origin requests falls back to a "sent but unverifiable" delivery (no-cors) and is reported honestly as such; Discord webhooks do allow cross-origin, so delivery to them is confirmed. HTTP errors are recorded as failures and never blindly retried. Forwarding runs only after the local alert has decided to fire, so anything the rules silence is never sent out.
 
-- **The settings sidebar row keeps the host's default gear icon**: the settings shell hard-codes icons per section id, gives every other section the default gear, and `settings.section` exposes no icon field — the plugin cannot change it. Its own bell only appears inside the settings page and in this README.
+- **The settings sidebar glyph relies on a DOM patch**: the shell hard-codes icons per section id and `settings.section` exposes no icon field, so the plugin can only swap the `<svg>` in its own row after the panel renders. It depends on the current panel structure (`data-shortcut-modal="settings"` plus a label `<span>` inside each nav button); if DSH changes that markup the patch silently stops working and the default gear shows instead — nothing else is affected.
 
 ## Development
 

package/README.md

@@ -13,7 +13,7 @@
 [![npm total downloads](https://img.shields.io/npm/dt/dsh-notify-me?style=flat-square&label=total%20downloads&color=1F883D)](https://www.npmjs.com/package/dsh-notify-me)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)
 [![DSH Web and Desktop](https://img.shields.io/badge/DSH-Web%20%7C%20Desktop-blue?style=flat-square)](#安装)
-[![Client bundle size](https://img.shields.io/badge/client-%7E156%20KiB-green?style=flat-square)](lib/client.js)
+[![Client bundle size](https://img.shields.io/badge/client-%7E164%20KiB-green?style=flat-square)](lib/client.js)
 [![DSH Compatibility](https://img.shields.io/badge/DSH-%E5%B7%B2%E9%80%82%E9%85%8D%200.2.1--rc.2-6366f1.svg?style=flat-square)](#兼容性)
 [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
 
@@ -47,7 +47,7 @@ DSH Web / Desktop 的通知插件，让你敢不开完整访问，也不必一
 
 ![通知提醒设置页：页眉、提醒方式、什么时候提醒、试一试与折叠的高级设置](https://raw.githubusercontent.com/chromoany/dsh-notify-me/main/docs/screenshots/settings-zh.png)
 
-真实插件设置组件（v1.9.0 默认配置）在独立演示环境里整页渲染；只保留左侧导航作参照，不是 DSH 宿主外壳。
+真实插件设置组件（v1.9.2 默认配置）在独立演示环境里按内容列整页渲染；每行的说明改成鼠标悬浮才出现的小方框，所以这里只看到标题。
 </details>
 
 ## 安装
@@ -112,7 +112,7 @@ dsh-notify-me 把「监督」和「守在屏幕前」解耦：只在真的出现
 
 ## 在 DSH 设置里改配置
 
-打开 **设置 → 通知提醒**。页面按「提醒方式 → 什么时候提醒 → 试一试」三段排开，不常改的收进底部「高级设置」，点一下展开。
+打开 **设置 → 通知提醒**。页面按「提醒方式 → 什么时候提醒 → 试一试」三段排开，不常改的收进底部「高级设置」，点一下展开。每行只写标题，具体说明在鼠标移上去时弹出的小方框里（触屏或键盘操作时留一份隐藏文本给读屏）。
 
 ### 提醒方式
 
@@ -189,7 +189,7 @@ Windows 的系统通知横幅固定画在主屏上，系统没有设置项、浏
 
 </details>
 
-> 左侧导航行的图标由 DSH 设置外壳统一渲染：外壳按分区 id 硬编码（只认 account / models / agent-presets / plugins / archived-sessions），其他分区一律给默认齿轮，`settings.section` 也没有图标字段——插件的铃铛标志只能出现在自己的页面里，换不了导航行。
+> 左侧导航行的图标由 DSH 设置外壳统一渲染：外壳按分区 id 硬编码（只认 account / models / agent-presets / plugins / archived-sessions），其他分区一律给默认齿轮，`settings.section` 也没有图标字段。插件的做法是在设置面板渲染后替换那一行：按本地化标签文本找到自己的入口，把宿主的 `<svg>` 换成品牌铃铛（保留宿主给的 icon class），并用 MutationObserver 跟随重渲染；宿主改结构时会自动放弃、回落到齿轮。
 
 > 需要浏览器通知权限：页面上点一下 → 允许；或地址栏锁 → 站点设置 → 通知 → 允许 → 刷新。macOS 还要在 系统设置 → 通知 里允许该浏览器。
 
@@ -318,7 +318,7 @@ DSH Desktop 是一层 Electron 壳，页面跑在 `dsh-app://app` 下：DOM 的
 - 「当前对话不弹通知」按 `document.hidden` 判定：窗口被别的应用完全盖住时仍算「页面可见」，此时当前对话的等待照样静默。
 - 外部通知转发受浏览器跨域（CORS）限制：端点不放行时自动降级为「送出但不可确认」（no-cors），如实标为「已送出不可确认」；Discord Webhook 官方放行跨域，可直接确认送达。HTTP 错误如实记失败、不重试。转发在本地提醒决定要发之后才触发，所以被「当前对话不弹通知」等规则静音的提醒也不会外发。
 
-- **设置左侧导航行是宿主的默认齿轮图标**：设置外壳按分区 id 硬编码图标，其它分区一律给默认齿轮，`settings.section` 没有图标字段，插件改不了；插件自己的铃铛标志只出现在设置页页眉与 README。
+- **设置左侧导航行图标靠 DOM 补丁**：外壳按分区 id 硬编码图标且 `settings.section` 没有图标字段，插件只能在面板渲染后把那一行的 `<svg>` 换成铃铛。命中依赖宿主当前的面板结构（`data-shortcut-modal="settings"` + 导航按钮里的标签 `<span>`）；如果 DSH 改了这套结构，补丁会静默失效、显示回默认齿轮，其他功能不受影响。
 
 ## 开发自检
 

package/lib/client.js

@@ -1937,7 +1937,7 @@
       });
     } catch (e) {}
     // keep in sync with package.json "version" on every release
-    api.version = "1.9.0";
+    api.version = "1.9.2";
     api.setConfig = function (patch) { return setConfigLocal(patch); };
     api.resetConfig = function () {
       try {
@@ -2311,6 +2311,94 @@
       offHint: "Reminders are off: enable them first, then test.",
       versionLine: "Plugin version: dsh-notify-me v"
     };
+    // ─────────────────── sidebar row glyph ───────────────────────────
+    // The settings shell picks the nav glyph from a table keyed by section id
+    // (account / models / agent-presets / plugins / archived-sessions) and hands
+    // every other section the settings gear; settings.section carries no icon
+    // field, so there is no supported way to give our row the bell. Patch the
+    // rendered cell instead: find the nav button whose label is ours and swap
+    // its <svg> for the brand bell. The panel is portaled fresh on every open,
+    // so this re-applies itself; if a host updates its markup the label lookup
+    // simply finds nothing and the gear stays.
+    function bellNavSvg() {
+      var NS = "http://www.w3.org/2000/svg";
+      var svg = document.createElementNS(NS, "svg");
+      var attrs = {
+        viewBox: "0 0 24 24", width: "16", height: "16", fill: "none",
+        stroke: "currentColor", "stroke-width": "1.6", "stroke-linecap": "round",
+        "stroke-linejoin": "round", "aria-hidden": "true", "data-dnm-nav": "1"
+      };
+      for (var k in attrs) if (Object.prototype.hasOwnProperty.call(attrs, k)) svg.setAttribute(k, attrs[k]);
+      var shapes = [
+        ["path", { d: "M12 3.4a5.1 5.1 0 0 0-5.1 5.1v3.1c0 .9-.3 1.7-.9 2.4l-1.1 1.3c-.5.6-.1 1.5.7 1.5h12.8c.8 0 1.2-.9.7-1.5l-1.1-1.3a3.8 3.8 0 0 1-.9-2.4V8.5A5.1 5.1 0 0 0 12 3.4Z" }],
+        ["path", { d: "M9.8 19.2a2.4 2.4 0 0 0 4.4 0" }],
+        ["circle", { cx: "18.3", cy: "5.3", r: "2.35", fill: "currentColor", stroke: "none" }]
+      ];
+      for (var i = 0; i < shapes.length; i++) {
+        var el = document.createElementNS(NS, shapes[i][0]);
+        for (var a in shapes[i][1]) if (Object.prototype.hasOwnProperty.call(shapes[i][1], a)) el.setAttribute(a, shapes[i][1][a]);
+        svg.appendChild(el);
+      }
+      return svg;
+    }
+
+    function installNavBell(labelOf) {
+      if (typeof document === "undefined" || !document.body || typeof MutationObserver !== "function") {
+        return function () {};
+      }
+      var PANEL = '[data-shortcut-modal="settings"]';
+      var observed = null;
+      var watching = null;
+
+      function patchPanel(panel) {
+        try {
+          var label = String(labelOf() || "").trim();
+          if (!label || !panel) return;
+          var cells = panel.querySelectorAll("button");
+          for (var i = 0; i < cells.length; i++) {
+            var cell = cells[i];
+            var spans = cell.querySelectorAll("span");
+            var hit = false;
+            for (var s = 0; s < spans.length; s++) {
+              if (String(spans[s].textContent || "").trim() === label) { hit = true; break; }
+            }
+            if (!hit) continue;
+            var svg = cell.querySelector("svg");
+            if (!svg || svg.getAttribute("data-dnm-nav") === "1") continue;
+            var bell = bellNavSvg();
+            // Keep the shell's own icon class so the box size and color match.
+            var cls = svg.getAttribute("class");
+            if (cls) bell.setAttribute("class", cls);
+            if (svg.parentNode) svg.parentNode.replaceChild(bell, svg);
+          }
+        } catch (e) {}
+      }
+
+      function watchPanel(panel) {
+        if (!panel || panel === observed) return;
+        observed = panel;
+        patchPanel(panel);
+        if (watching) { try { watching.disconnect(); } catch (e) {} }
+        watching = new MutationObserver(function () { patchPanel(observed); });
+        watching.observe(panel, { childList: true, subtree: true });
+      }
+
+      // The panel is portaled onto <body>, so a body-level childList observer is
+      // enough to notice it opening without watching the whole page.
+      var opener = new MutationObserver(function () {
+        var panel = document.querySelector(PANEL);
+        if (panel) watchPanel(panel);
+        else if (watching) { try { watching.disconnect(); } catch (e) {} watching = null; observed = null; }
+      });
+      opener.observe(document.body, { childList: true });
+      var existing = document.querySelector(PANEL);
+      if (existing) watchPanel(existing);
+      return function () {
+        try { opener.disconnect(); } catch (e) {}
+        if (watching) { try { watching.disconnect(); } catch (e) {} }
+      };
+    }
+
     // Small element helper to keep the hand-written page readable.
     function h(tag, props) {
       var args = [tag, props || null];
@@ -2362,6 +2450,13 @@
       ".dnm-advToggle:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary,#3b82f6);outline-offset:2px}" +
       ".dnm-advRight{display:flex;align-items:center;gap:8px;flex:none;font-weight:400;color:var(--dsw-alias-label-tertiary,rgba(120,120,120,.9))}" +
       ".dnm-advChev{font-size:10px;translate:0 1px;transition:transform .15s ease}" +
+      ".dnm-rowTip{cursor:help}" +
+      ".dnm-rowValue{font-size:12px;line-height:18px;color:var(--dsw-alias-label-tertiary,rgba(120,120,120,.9))}" +
+      // The long explanation lives in a tooltip next to the pointer, so a
+      // row is one line tall. Screen readers still get the text.
+      ".dnm-srOnly{position:absolute;width:1px;height:1px;margin:-1px;padding:0;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap;border:0}" +
+      ".dnm-tip{position:fixed;left:-9999px;top:-9999px;z-index:2147483001;max-width:270px;box-sizing:border-box;padding:7px 10px;border-radius:8px;border:1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.35));background:var(--dsw-alias-bg-layer-3,#26282c);color:var(--dsw-alias-label-secondary,rgba(90,90,90,.9));font-size:12px;line-height:17px;box-shadow:0 6px 18px rgba(0,0,0,.35);pointer-events:none;opacity:0;transition:opacity .12s ease}" +
+      ".dnm-tip.on{opacity:1}" +
       ".dnm-advChev.open{transform:rotate(180deg)}";
     (function injectStyle() {
       try {
@@ -2376,11 +2471,101 @@
       } catch (e) {}
     })();
 
+    // Hover hints: a row keeps one line of text; its explanation shows up in a
+    // small box beside the pointer after a short delay. One shared node, so
+    // nothing has to be cleaned up per row.
+    var TIP_ID = "dsh-notify-me-tip";
+    var tipEl = null;
+    var tipTimer = null;
+    var tipShown = false;
+    var tipX = 0;
+    var tipY = 0;
+    function tipNode() {
+      try {
+        if (tipEl && tipEl.parentNode) return tipEl;
+        if (typeof document === "undefined" || !document.body) return null;
+        var node = document.createElement("div");
+        node.id = TIP_ID;
+        node.className = "dnm-tip";
+        node.setAttribute("role", "tooltip");
+        document.body.appendChild(node);
+        tipEl = node;
+        return node;
+      } catch (e) { return null; }
+    }
+    function hideTip() {
+      if (tipTimer) { clearTimeout(tipTimer); tipTimer = null; }
+      if (!tipShown) return;
+      tipShown = false;
+      if (tipEl) tipEl.className = "dnm-tip";
+    }
+    // Keep the box on screen: flip left of the pointer near the right edge,
+    // flip above it near the bottom.
+    function placeTip() {
+      var node = tipEl;
+      if (!node || !tipShown) return;
+      var pad = 12;
+      var rect = node.getBoundingClientRect();
+      var vw = window.innerWidth || 0;
+      var vh = window.innerHeight || 0;
+      var x = tipX + 14;
+      if (x + rect.width + pad > vw) x = tipX - rect.width - 14;
+      if (x < pad) x = pad;
+      var y = tipY + 18;
+      if (y + rect.height + pad > vh) y = tipY - rect.height - 12;
+      if (y < pad) y = pad;
+      node.style.left = Math.round(x) + "px";
+      node.style.top = Math.round(y) + "px";
+    }
+    function showTip(text) {
+      var node = tipNode();
+      if (!node) return;
+      node.textContent = text;
+      tipShown = true;
+      node.className = "dnm-tip on";
+      placeTip();
+    }
+    function tipHandlers(text) {
+      return {
+        onMouseEnter: function (e) {
+          tipX = e.clientX;
+          tipY = e.clientY;
+          if (tipTimer) clearTimeout(tipTimer);
+          tipTimer = setTimeout(function () { tipTimer = null; showTip(text); }, 320);
+        },
+        onMouseMove: function (e) {
+          tipX = e.clientX;
+          tipY = e.clientY;
+          if (tipShown) placeTip();
+        },
+        onMouseLeave: hideTip
+      };
+    }
+    // A row that has an explanation: single-line label, text in the tooltip.
+    function tipRow(className, hintText, children) {
+      var props = { className: className + (hintText ? " dnm-rowTip" : "") };
+      if (hintText) {
+        props["data-dnm-tip"] = hintText;
+        var handlers = tipHandlers(hintText);
+        props.onMouseEnter = handlers.onMouseEnter;
+        props.onMouseMove = handlers.onMouseMove;
+        props.onMouseLeave = handlers.onMouseLeave;
+      }
+      return h("div", props, children);
+    }
+    // Read-screen-only copy of the tooltip text.
+    function srOnly(text) {
+      return text ? h("span", { className: "dnm-srOnly" }, text) : null;
+    }
+    (function tipDismissOnScroll() {
+      try { window.addEventListener("scroll", hideTip, true); } catch (e) {}
+    })();
+
     function rowSwitch(key, labelText, hintText, checked, onChange) {
-      return h("div", { className: "dnm-row" }, [
+      return tipRow("dnm-row", hintText, [
         h("div", { className: "dnm-rowText" }, [
           h("div", { className: "dnm-rowLabel" }, labelText),
-          hintText ? h("div", { className: "dnm-rowHint" }, hintText) : null
+          srOnly(hintText)
         ]),
         h("button", {
           type: "button",
@@ -2453,7 +2638,7 @@
           h("div", { className: "dnm-row" }, [
             h("div", { className: "dnm-rowText" }, [
               h("div", { className: "dnm-rowLabel" }, labelText),
-              h("div", { className: "dnm-rowHint" }, note)
+              h("div", { className: "dnm-rowValue" }, note)
             ]),
             h("div", { className: "dnm-btnRow" }, [
               h("select", {
@@ -2481,11 +2666,12 @@
           ])
         ];
         if (mode !== "custom") return rows;
-        rows.push(h("div", { className: "dnm-row" }, [
+        var pickNote = (rec ? Math.round((rec.size || 0) / 1024) + " KB · " : t("soundNone") + " · ")
+          + "≤" + Math.round(SOUND_MAX_BYTES / 1024) + " KB";
+        rows.push(tipRow("dnm-row", pickNote, [
           h("div", { className: "dnm-rowText" }, [
             h("div", { className: "dnm-rowLabel" }, t("soundPick")),
-            h("div", { className: "dnm-rowHint" }, (rec ? Math.round((rec.size || 0) / 1024) + " KB · " : t("soundNone") + " · ")
-              + "≤" + Math.round(SOUND_MAX_BYTES / 1024) + " KB")
+            srOnly(pickNote)
           ]),
           h("div", { className: "dnm-btnRow" }, [
             h("input", {
@@ -2638,6 +2824,7 @@
       var permOK = ("Notification" in window) ? Notification.permission === "granted" : false;
       var resolvedLang = effectiveLang();
       var resolvedLangName = resolvedLang === "en" ? t("langEn") : t("langZh");
+      var langNote = resolvedLangName + (cfg.language === "auto" ? t("langAutoNote") : "");
       // The environment row states what detection saw whenever the manual
       // choice disagrees with it — the override exists for hosts where the
       // protocol read comes out wrong, so the divergence must be visible.
@@ -2667,10 +2854,10 @@
       var advState = React.useState(false);
       var advancedOpen = advState[0];
       var setAdvancedOpen = advState[1];
-      var testRow = h("div", { className: "dnm-row dnm-rowStack" }, [
+      var testRow = tipRow("dnm-row dnm-rowStack", t("testHint"), [
         h("div", { className: "dnm-rowText" }, [
           h("div", { className: "dnm-rowLabel" }, t("testTitle")),
-          h("div", { className: "dnm-rowHint" }, t("testHint"))
+          srOnly(t("testHint"))
         ]),
         h("div", { className: "dnm-btnRow" }, [
           h("button", { type: "button", className: "dnm-btn", disabled: !cfg.enabled, onClick: function () { runTest("attention"); } }, t("testAttention")),
@@ -2696,10 +2883,10 @@
           }),
           rowSwitch("toast", t("toast"), toastHintText(), cfg.toast, function (v) { patch({ toast: v }); }),
           rowSwitch("overlay", t("overlay"), t("overlayHint"), cfg.overlay, function (v) { patch({ overlay: v }); }),
-          cfg.overlay ? h("div", { className: "dnm-row dnm-rowSub" }, [
+          cfg.overlay ? tipRow("dnm-row dnm-rowSub", t("overlayCornerHint"), [
             h("div", { className: "dnm-rowText" }, [
               h("div", { className: "dnm-rowLabel" }, t("overlayCorner")),
-              h("div", { className: "dnm-rowHint" }, t("overlayCornerHint"))
+              srOnly(t("overlayCornerHint"))
             ]),
             h("select", {
               className: "dnm-select",
@@ -2792,10 +2979,10 @@
             [rowSwitch("externalEnabled", t("externalEnable"), t("externalEnableHint"), cfg.externalEnabled, function (v) { patch({ externalEnabled: v }); })],
             [rowSwitch("externalAttention", t("externalAttentionLabel"), t("externalAttentionHint"), cfg.externalAttention, function (v) { patch({ externalAttention: v }); })],
             [rowSwitch("externalDone", t("externalDoneLabel"), t("externalDoneHint"), cfg.externalDone, function (v) { patch({ externalDone: v }); })],
-            [h("div", { className: "dnm-row" }, [
+            [tipRow("dnm-row", t("externalTargetsHint"), [
               h("div", { className: "dnm-rowText" }, [
                 h("div", { className: "dnm-rowLabel" }, t("externalTargetsLabel")),
-                h("div", { className: "dnm-rowHint" }, t("externalTargetsHint"))
+                srOnly(t("externalTargetsHint"))
               ])
             ])],
             externalRows(),
@@ -2814,10 +3001,10 @@
                 }, t("externalAdd"))
               ])
             ])],
-            [h("div", { className: "dnm-row" }, [
+            [tipRow("dnm-row", t("externalTestHint"), [
               h("div", { className: "dnm-rowText" }, [
                 h("div", { className: "dnm-rowLabel" }, t("externalTestLabel")),
-                h("div", { className: "dnm-rowHint" }, t("externalTestHint"))
+                srOnly(t("externalTestHint"))
               ]),
               h("div", { className: "dnm-btnRow" }, [
                 h("button", {
@@ -2832,10 +3019,10 @@
           )),
           secTitle(t("secDiag")),
           card([
-            h("div", { className: "dnm-row" }, [
+            tipRow("dnm-row", envHint, [
               h("div", { className: "dnm-rowText" }, [
                 h("div", { className: "dnm-rowLabel" }, t("hostEnv")),
-                h("div", { className: "dnm-rowHint" }, envHint)
+                srOnly(envHint)
               ]),
               h("select", {
                 className: "dnm-select",
@@ -2848,10 +3035,10 @@
                 h("option", { value: "web" }, t("hostEnvWeb"))
               ])
             ]),
-            h("div", { className: "dnm-row" }, [
+            tipRow("dnm-row", langNote, [
               h("div", { className: "dnm-rowText" }, [
                 h("div", { className: "dnm-rowLabel" }, t("language")),
-                h("div", { className: "dnm-rowHint" }, resolvedLangName + (cfg.language === "auto" ? t("langAutoNote") : ""))
+                srOnly(langNote)
               ]),
               h("select", {
                 className: "dnm-select",
@@ -2864,10 +3051,10 @@
                 h("option", { value: "en" }, t("langEn"))
               ])
             ]),
-            h("div", { className: "dnm-row" }, [
+            tipRow("dnm-row", t("resetHint"), [
               h("div", { className: "dnm-rowText" }, [
                 h("div", { className: "dnm-rowLabel" }, t("reset")),
-                h("div", { className: "dnm-rowHint" }, t("resetHint"))
+                srOnly(t("resetHint"))
               ]),
               h("button", { type: "button", className: "dnm-btn", onClick: function () {
                 // api.resetConfig() also drops the picked cue files, which are
@@ -2932,6 +3119,11 @@
               return React.createElement(NotifySettingsView, { ctx: ctx, t: t });
             });
           });
+          // Same page, different layer: give the sidebar row the bell instead of
+          // the gear the shell falls back to for unknown section ids.
+          ctx.effect(function () {
+            return installNavBell(function () { return t("nav"); });
+          }, "dsh-notify-me: sidebar glyph");
         }
       } catch (e) {
         try { console.error("[dsh-notify-me] settings page unavailable", e); } catch (e2) {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-notify-me",
-  "version": "1.9.0",
+  "version": "1.9.2",
   "description": "离开 DSH 页面也能收到提醒：需要你操作 / 后台回复完成时发系统通知、标题标记与可选页面浮层（副屏也能看见），支持审批快捷裁决与外部推送。Brand icon and a reworked settings page in 1.9.0.",
   "license": "MIT",
   "type": "module",