🐛 fix(client): 配置块去掉与插件页顶部重复的标题和描述

README.md

@@ -19,32 +19,53 @@ Windows / macOS / Linux 三个平台走的是同一条通知通道（渲染进
 | 状态 | 行为 |
 | --- | --- |
 | DSH 窗口**不在前台** | **系统通知**（这是插件唯一能拿到的系统通知通道，三个平台一致）。点通知：窗口回到前台并跳到该会话 |
-| DSH 窗口在前台，且**不是**你正在看的那个会话 | **应用内轻弹窗**：右上角悬浮，点「查看」跳过去，6 秒自动消失，鼠标悬停时不消失，Esc 关掉最上面一条 |
+| DSH 窗口在前台，且**不是**你正在看的那个会话 | **应用内轻弹窗**：右上角悬浮，标题是提醒类型、下面一行是会话题目与细节；点「查看」跳过去，6 秒自动消失，鼠标悬停时不消失，Esc 或者 ✕ 关掉 |
 | DSH 窗口在前台，且就是你**正在看的**那个会话 | 不打扰（你在看，不需要弹） |
 
 ## 设置
 
-**设置 → 通用 → 会话通知**：
+**插件 → 会话通知**（插件自己的介绍页里）：
 
 - 显示系统通知权限状态；
 - 未授权时点「允许通知」请求权限（浏览器要求必须由你手动点击才能弹权限框），授权后自动发一条测试通知；
 - 已授权时点「测试通知」随时验证；
 - 权限被系统层关闭时，按平台给出开启路径（Windows / macOS 的通知设置、Linux 桌面环境的通知设置）；
-- 三个开关分别控制**完成 / 授权 / 提问**三类提醒（默认全开；开关状态存在当前页面内存里，刷新回到默认——本插件不写配置文件）。
+- 三个开关分别控制**完成 / 授权 / 提问**三类提醒（默认全开），状态存在浏览器本地，重装插件不丢；
+- 最后一段显示观察器自身的健康状态（收不到会话状态时直接标红）。
+
+设置放在插件自己的页面里，而不是「设置 → 通用」：它是这个插件的配置，不是 DSH 的通用偏好。页面顶部是 DSH 自己渲染的插件标题与描述，所以这块配置不再重复标题，直接用一句「提醒是怎么送出去的」开头。
+
+### 关于「包含的组件」
+
+插件页下方那一段（`组件` / `包含的组件`）是 **DSH 插件页固定渲染**的：`ui-plugin-manager` 的 `RowsSection` 无条件列出这个 bundle 在 `cordis.patch.yml` 里声明的**每一行**（行 id、运行状态、单独开关），没有"跳过"的口子。因为任何 bundle 都至少要声明一行才能挂上宿主半，所以这一节必然出现——本插件就是这一行。
+
+它也不是纯冗余：它标出运行状态、允许单独关掉这个组件，并且当 bundle 与组件的关系变得复杂时是唯一的入口。如果你觉得一个组件时看着奇怪，那是 DSH 的呈现方式，插件侧没法隐藏。
 
 ## 安装
 
-在 DSH 的 **插件 → 添加插件** 里填本目录的绝对路径即可（`plugin_manager` 也会做同样的安装）：
+### 1. 从 Git 仓库安装（推荐）
+
+在 DSH 的 **插件 → 添加插件** 的上方输入框里填：
+
+```text
+https://gitea.iwake.top/dsh-plugin/session-notify.git#v1.0.3
+```
+
+`#` 后面跟标签或提交，用来锁定版本；不写则取默认分支。跟随 1.x 最新版可以写 `#semver:^1.0.3`。仓库是公开的，不需要凭据，也不用改「安装源」。
+
+### 2. 本地路径安装
+
+把仓库克隆或下载到本机，在同一个输入框里填包目录的绝对路径，例如：
 
 ```text
 D:\DeepSeek Harness Plugins\dsh-session-notify
 ```
 
-安装后：
+### 装完之后
 
-- **浏览器半**随页面加载，刷新页面即生效；
+- **浏览器半**随页面加载，**刷新页面**即生效；
-- **宿主半**为空壳（不改任何 DSH 状态），如需重启才生效，完全退出 DSH 再打开即可；
+- **宿主半**是空壳（不改任何 DSH 状态、不注册服务与路由），只有它变化时才需要完全退出 DSH 再打开；
-- 本插件没有第三方依赖，不需要 pnpm 下载，也不需要构建步骤。
+- 本插件没有第三方依赖，不需要 pnpm 下载，也没有构建步骤。
 
 卸载：插件页里移除 `@dsh-plugin/session-notify`（它同时是 profile 的一个 bundle）。
 
@@ -52,7 +73,7 @@ D:\DeepSeek Harness Plugins\dsh-session-notify
 
 - **通道是跨平台统一的**：插件的提醒都通过页面（Electron 渲染进程）的 `Notification` 构造器发出，Windows 通知中心 / macOS 通知中心 / Linux 通知守护（libnotify、GNOME、KDE）都由系统把它转成原生通知；应用内轻弹窗是纯 DOM，与平台无关。
 - **宿主半拿不到系统通知**：DSH Desktop 的宿主进程是纯 Node 进程（不是 Electron 主进程），没有 Electron 的 `Notification` 可用，所以插件的所有提醒都在浏览器半产生——这也正是"三个平台一套代码"的原因。
-- **已验证**：Windows 上的安装、三个 slot 条目注册、以及 22 条投递规则（见下）的离线验证；设置行与轻弹窗的文案/交互按 DSH 自带的 toast 与 switch 组件对齐。
+- **已验证**：Windows 上的安装、三个 slot 条目注册、以及 52 项离线断言（接线 / 国际化 / 轻弹窗结构 / 开关持久化 / 全部投递规则）。
 - **未验证**：macOS 与 Linux 上的实际弹窗效果本机无法测试。结构上它们与 Windows 共用同一条通道、同一份代码，只有"权限被系统关闭时显示的开启路径"是分平台的。
 - 提醒只在 DSH 进程运行、页面打开时产生：**DSH 完全退出期间结束的会话不会再补发通知**。
 
@@ -72,10 +93,13 @@ D:\DeepSeek Harness Plugins\dsh-session-notify
 依赖的都是稳定契约：
 
 - 浏览器半只依赖 **slot 的标准 props**（`useSessions`、`useSessionStatus`）读取会话状态，这是 DSH 官方给插件读会话数据的方式；不轮询、不自己订阅会话事件、不读别的插件的 DOM；
-- 只往两个官方 slot 注册：`settings.general.item`（设置行）与 `shell.overlay`（两个条目：轻弹窗层 + 无渲染的观察器，内容永远是 `null`）；
+- 只往两个官方 slot 注册：`plugins.bundle.config`（本插件在插件页里的配置，key 就是包名）与 `shell.overlay`（两个条目：轻弹窗层 + 无渲染的观察器，内容永远是 `null`）；
+- **配置放在插件页**：`plugins.bundle.config` 的 key 取包名（`@dsh-plugin/session-notify`），插件页就会渲染这块配置；官方 `dsh-experimental-voice-input-bundle` 用的就是这个口子。行级口子是 `plugins.row.config`，key 形如 `<包名>#<行 id>`，会在该行上多出一个「配置」入口；
 - **不要**把"无渲染"条目放进 `sidebar.panellist`：该 slot 的宿主会把**每个条目的 id 当成一个左侧面板按钮**（`entriesOfSlot('sidebar.panellist')` → 面板列表，按钮文字取 `options.label ?? options.id`，条目本身作为图标内联渲染），放进去会在左侧多出一行空面板并挤坏侧边栏。本插件第一版踩过这个坑，现已改挂到通用浮层；
+- **文案必须注册字典**：`ctx.locale.register('session-notify', { zh, en })`，否则 `locale.bind(ns)` 在查不到该命名空间时会把 key 原样返回——界面上就会显示成 `settings.title` 这样的原始键（本插件第二版踩过这个坑）。注册会在 locale 修订号上打点，已经渲染出来的部件会自动换上文案，不需要刷新；
+- 另外自带一份本地字典兜底：即使拿不到框架的 `t`、或 locale 服务没有保存注册，也会渲染中文/英文文案而不是原始键；
 - 样式只用主题 token，不 import 任何 `@deepseek-ai/dsh-client-*` 包（规范要求，也是渲染不被上游改动打断的前提）；
-- 宿主半不声明 `inject`、不注册服务、不注册路由。
+- 宿主半不声明 `inject`、不注册服务、不注册路由；三个开关存浏览器本地，不改 DSH 的配置文件。
 
 上游若改动 slot 名或 hook 名：注册会静默跳过而不是把页面弄坏，插件会退化成"不提醒"；这类情况请按上面的契约名核对。
 
@@ -83,8 +107,14 @@ D:\DeepSeek Harness Plugins\dsh-session-notify
 
 `client.js` 是纯 JavaScript、浏览器端运行，可以在 Node 里用桩模块加载器评估并驱动：
 
-- 模块接线：加载后返回的插件、`inject` 声明、注册集合（含"观察器绝不在 sidebar.* 里"这一条）、以及各组件在空状态 / 权限被拒 / 无 Notification API 下的渲染都不报错；
+- 模块接线：插件返回值、`inject` 声明、注册集合（含"配置挂在插件页""观察器绝不在 `sidebar.*` 里"这两条）；
-- 投递规则：40 项断言覆盖上面"行为细节"里的每一条（完成提醒一次、当前会话不打扰、后台走系统通知、授权/提问各提醒一次、运行中延后、子会话跳过、历史不补发、开关生效、弹窗自动消失等）。
+- 国际化：字典已注册且中英键集合一致、插件页与弹窗渲染出的每个字符串都不是原始键、拿不到框架 `t` 时本地字典兜底、locale 服务不保存注册时仍然有文案；
+- 轻弹窗结构：标题是触发类型、描述含会话名与细节；
+- 开关：切换即写入浏览器本地，重开页面能读回；
+- 渲染健壮性：各组件在空状态 / 权限被拒 / 无 Notification API 下渲染都不报错；
+- 投递规则：完成提醒一次、当前会话不打扰、后台走系统通知、授权/提问各提醒一次、运行中延后、子会话跳过、空白会话跳过、历史不补发、开关生效、弹窗自动消失等。
+
+合计 52 项断言。
 
 ## License
 

client.js

@@ -36,6 +36,8 @@ window.__ModuleLoader__.load({
 
     /** Locale namespace owned by this package. */
     const NS = 'session-notify'
+    /** This package's name: the plugin manager keys a bundle's configuration by it. */
+    const PACKAGE_NAME = '@dsh-plugin/session-notify'
     /** Trigger ids shared by the store, the copy table, and the settings row. */
     const KINDS = ['completion', 'approval', 'question']
     /** Pending-interaction kinds the Harness itself renders, and this plugin serves. */
@@ -82,6 +84,11 @@ window.__ModuleLoader__.load({
       'settings.kind.completion': '完成',
       'settings.kind.approval': '授权',
       'settings.kind.question': '提问',
+      'config.section.kinds': '提醒内容',
+      'config.section.permission': '系统通知权限',
+      'config.section.status': '运行状态',
+      'config.intro': '提醒都从当前页面发出：窗口不在前台时是系统通知，窗口在前台时是这里的轻弹窗。',
+      'config.saveNote': '开关保存在浏览器本地，重装插件不会丢失。',
     }
     const en = {
       'notification.completion': 'Conversation finished',
@@ -117,42 +124,53 @@ window.__ModuleLoader__.load({
       'settings.kind.completion': 'Finished',
       'settings.kind.approval': 'Approval',
       'settings.kind.question': 'Questions',
+      'config.section.kinds': 'What to notify about',
+      'config.section.permission': 'System notification permission',
+      'config.section.status': 'Status',
+      'config.intro': 'Every alert comes from this page: a system notification while the window is in the background, the light popup here while it is in the foreground.',
+      'config.saveNote': 'The switches are stored in this browser and survive reinstalling the plugin.',
     }
 
     /**
      * Every declaration below belongs to this package. The popup copies the
      * shipped toast surface (a fixed entry in the frame-wide overlay, the
      * `--dsw-alias-toast-bg` / `--dsw-alias-toast-label` pair, `--dsw-radius-lg`,
-     * `--dsw-shadow-lv3`), the switch copies `Switch.module.css` behavior and
+     * `--dsw-shadow-lv3`) and adds a title line above the text; the switch copies
-     * proportion, and the settings row copies the General-section row pattern.
+     * `Switch.module.css` behavior and proportion; the configuration sections
+     * follow the Plugin Manager page's own section rhythm (a column, 32px apart).
      * Class names are renamed under `dsn-`; only the popup glyphs carry their own
      * artwork colors.
      */
     const CSS = `
 .dsn-stack{position:fixed;top:40px;right:24px;z-index:1100;display:flex;flex-direction:column;align-items:flex-end;gap:8px;pointer-events:none}
 @media (max-width:520px){.dsn-stack{right:12px}}
-.dsn-toast{box-sizing:border-box;pointer-events:auto;display:flex;align-items:center;gap:10px;width:max-content;max-width:min(420px,calc(100vw - 48px));padding:12px 16px;border-radius:var(--dsw-radius-lg);background:var(--dsw-alias-toast-bg);color:var(--dsw-alias-toast-label);font-size:14px;line-height:22px;box-shadow:var(--dsw-shadow-lv3);animation:dsn-toast-in 160ms ease-out}
+.dsn-toast{box-sizing:border-box;pointer-events:auto;display:flex;align-items:flex-start;gap:10px;width:max-content;max-width:min(420px,calc(100vw - 48px));padding:12px 12px 12px 16px;border-radius:var(--dsw-radius-lg);background:var(--dsw-alias-toast-bg);color:var(--dsw-alias-toast-label);font-size:14px;line-height:22px;box-shadow:var(--dsw-shadow-lv3);animation:dsn-toast-in 160ms ease-out}
 @keyframes dsn-toast-in{from{opacity:0;transform:translateX(8px)}to{opacity:1;transform:translateX(0)}}
 @media (prefers-reduced-motion: reduce){.dsn-toast{animation:none}}
-.dsn-toast-icon{display:grid;place-items:center;flex:none;color:var(--dsw-alias-state-warn-label)}
+.dsn-toast-icon{display:grid;place-items:center;flex:none;height:22px;color:var(--dsw-alias-state-warn-label)}
 .dsn-toast-icon.is-completion{color:var(--dsw-alias-state-success-primary)}
 .dsn-toast-icon.is-question{color:var(--dsw-alias-brand-primary)}
-.dsn-toast-text{min-width:0}
+.dsn-toast-text{flex:1;min-width:0;display:flex;flex-direction:column;gap:2px}
-.dsn-toast-action{padding:0;border:0;background:none;color:var(--dsw-static-deepseek-400);font:inherit;cursor:pointer;margin-inline:3px}
+.dsn-toast-title{font-weight:500;font-size:14px;line-height:22px}
-.dsn-toast-action:hover{opacity:.8}
+.dsn-toast-desc{color:var(--dsw-alias-toast-label);opacity:.8;font-size:13px;line-height:20px;overflow-wrap:break-word}
+.dsn-toast-actions{display:flex;align-items:center;gap:2px;flex:none}
+.dsn-toast-action{display:inline-flex;align-items:center;height:28px;padding:0 8px;border:0;border-radius:var(--dsw-radius-sm);background:none;color:var(--dsw-static-deepseek-400);font:inherit;font-size:13px;line-height:20px;cursor:pointer}
+.dsn-toast-action:hover{background:var(--dsw-alias-interactive-bg-hover)}
 .dsn-toast-action:focus-visible{outline:var(--dsw-focus-ring-width) solid var(--dsw-focus-ring-color,var(--dsw-alias-state-business-primary));outline-offset:2px}
-.dsn-toast-close{flex:none;display:inline-flex;align-items:center;justify-content:center;width:18px;height:18px;border:0;border-radius:var(--dsw-radius-xs);background:transparent;color:var(--dsw-alias-toast-label);opacity:.7;cursor:pointer}
+.dsn-toast-close{flex:none;display:inline-flex;align-items:center;justify-content:center;width:28px;height:28px;border:0;border-radius:var(--dsw-radius-sm);background:transparent;color:var(--dsw-alias-toast-label);opacity:.8;cursor:pointer}
-.dsn-toast-close:hover{opacity:1}
+.dsn-toast-close:hover{background:var(--dsw-alias-interactive-bg-hover);opacity:1}
 .dsn-toast-close:focus-visible{outline:var(--dsw-focus-ring-width) solid var(--dsw-focus-ring-color,var(--dsw-alias-state-business-primary));outline-offset:2px}
-.dsn-row{border-bottom:.5px solid var(--dsw-alias-border-l2);align-items:center;gap:8px;padding:16px 0;display:flex}
+.dsn-sections{display:flex;flex-direction:column;gap:24px}
-.dsn-row-text{flex-direction:column;flex:1;gap:4px;min-width:0;padding-right:48px;display:flex}
+.dsn-section{display:flex;flex-direction:column;gap:10px}
-.dsn-row-title{color:var(--dsw-alias-label-primary);font-size:14px;font-weight:400;line-height:22px}
+.dsn-section-title{margin:0;color:var(--dsw-alias-label-primary);font-size:14px;font-weight:500;line-height:22px}
-.dsn-row-desc{color:var(--dsw-alias-label-tertiary);font-size:12px;font-weight:400;line-height:18px}
+.dsn-section-desc{margin:0;color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:18px}
-.dsn-status{color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px}
+.dsn-row{display:flex;align-items:center;justify-content:space-between;gap:16px;padding:10px 0;border-bottom:.5px solid var(--dsw-alias-border-l2)}
-.dsn-status + .dsn-status,.dsn-row-desc + .dsn-status,.dsn-kinds + .dsn-status{margin-top:8px}
+.dsn-row:last-child{border-bottom:0}
+.dsn-row-text{display:flex;flex-direction:column;gap:2px;min-width:0}
+.dsn-row-title{color:var(--dsw-alias-label-primary);font-size:14px;line-height:22px}
+.dsn-row-desc{color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:18px}
+.dsn-status{margin:0;color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px}
 .dsn-status-error{color:var(--dsw-alias-state-error-primary)}
-.dsn-kinds{display:flex;align-items:center;gap:10px;flex-wrap:wrap;margin-top:10px;color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:18px}
-.dsn-kind{display:inline-flex;align-items:center;gap:6px;color:var(--dsw-alias-label-secondary)}
 .dsn-switch{box-sizing:border-box;position:relative;flex:0 0 auto;width:36px;height:20px;padding:2px;border:0;border-radius:999px;background:var(--dsw-alias-border-l3);cursor:pointer}
 .dsn-switch[aria-checked='true']{background:var(--dsw-alias-brand-primary)}
 .dsn-switch:disabled{cursor:default;opacity:.5}
@@ -375,10 +393,35 @@ window.__ModuleLoader__.load({
       return preview(interaction.displayReason?.text ?? interaction.reason?.text ?? '')
     }
 
+    /**
+     * Register this package's dictionaries with the locale service.
+     *
+     * Without this the service has no entry for the namespace and every
+     * `locale.bind(NS)` lookup answers with the key itself, so the settings row
+     * shows `settings.title` instead of its copy. The typed form takes every
+     * shipped locale in one call, and the older single-locale form stays
+     * supported as a fallback. Registration bumps the locale revision, so
+     * already-rendered entries pick the copy up without a reload.
+     * @param locale - the locale service, or undefined when this profile has none.
+     * @returns a disposer for whichever registrations were installed.
+     */
+    function registerDictionaries(locale) {
+      if (locale === undefined || typeof locale.register !== 'function') return () => {}
+      const dictionaries = { zh, en }
+      try {
+        return locale.register(NS, dictionaries)
+      } catch {
+        const disposers = Object.entries(dictionaries).map(([id, dict]) => locale.register(NS, id, dict))
+        return () => {
+          for (const dispose of disposers) dispose?.()
+        }
+      }
+    }
+
     /**
      * Build a translate function for one locale service: the service's own bound
-     * namespace first, then the current language's dictionary, then the key
+     * namespace first, then this package's dictionaries, then the key itself, so
-     * itself, so a missing seat degrades copy instead of rendering.
+     * a missing seat degrades copy instead of rendering.
      * @param locale - the locale service, or undefined when this profile has none.
      * @returns a translate function with `{ name }` interpolation.
      */
@@ -387,7 +430,10 @@ window.__ModuleLoader__.load({
         if (locale !== undefined && typeof locale.bind === 'function') {
           try {
             const bound = locale.bind(NS)
-            if (typeof bound === 'function') return bound(key, params)
+            if (typeof bound === 'function') {
+              const translated = bound(key, params)
+              if (typeof translated === 'string' && translated !== key) return translated
+            }
           } catch {
             /* a locale service without this namespace still renders the fallback */
           }
@@ -395,7 +441,7 @@ window.__ModuleLoader__.load({
         let language = ''
         try {
           const snapshot = locale?.getSnapshot?.()
-          language = String(snapshot?.language ?? snapshot?.locale ?? snapshot?.id ?? '')
+          language = String(snapshot?.active ?? '')
         } catch {
           language = ''
         }
@@ -408,6 +454,42 @@ window.__ModuleLoader__.load({
       }
     }
 
+    /** Storage key for this package's own preferences. */
+    const STORAGE_KEY = 'dsh-plugin/session-notify'
+
+    /**
+     * Read this package's stored trigger switches.
+     *
+     * These are browser preferences rather than cordis configuration, so they live
+     * in this origin's own storage instead of the profile's patch file: the plugin
+     * writes nothing into DSH's configuration, and every read is defensive because
+     * storage can be unavailable or hold something an older version wrote.
+     * @returns the stored switches, defaulting to everything on.
+     */
+    function readStoredKinds() {
+      const kinds = { completion: true, approval: true, question: true }
+      try {
+        const raw = globalThis.localStorage?.getItem(STORAGE_KEY)
+        if (typeof raw !== 'string' || raw === '') return kinds
+        const stored = JSON.parse(raw)
+        for (const kind of KINDS) {
+          if (typeof stored?.[kind] === 'boolean') kinds[kind] = stored[kind]
+        }
+      } catch {
+        /* unreadable or foreign storage keeps the defaults */
+      }
+      return kinds
+    }
+
+    /** Store one trigger switch, ignoring storage that refuses to write. */
+    function writeStoredKinds(kinds) {
+      try {
+        globalThis.localStorage?.setItem(STORAGE_KEY, JSON.stringify(kinds))
+      } catch {
+        /* a refused write leaves the switches live for this page only */
+      }
+    }
+
     /**
      * Install the plugin.
      * @param ctx - Client root context providing `slots` and `locale`.
@@ -418,7 +500,7 @@ window.__ModuleLoader__.load({
 
       const store = createStore({
         permission: notificationPermission(),
-        kinds: { completion: true, approval: true, question: true },
+        kinds: readStoredKinds(),
         toasts: [],
         promptError: '',
         health: { state: 'starting', message: '' },
@@ -511,13 +593,18 @@ window.__ModuleLoader__.load({
         timers.delete(id)
       }
 
-      /** Show one light in-app popup. */
+      /**
+       * Show one light in-app popup: the trigger as the title, the conversation
+       * and its detail as the description, so the heading says what happened and
+       * the line under it says where.
+       */
       const showToast = (candidate) => {
         const notice = copyFor(candidate)
         state.toastSeq += 1
         const toast = {
           id: `dsn-${String(state.toastSeq)}`,
           kind: notice.kind,
+          title: notice.title,
           body: notice.body,
           sessionId: candidate.sessionId,
         }
@@ -752,10 +839,12 @@ window.__ModuleLoader__.load({
         if (notificationPermission() === 'granted') sendTest()
       }
 
-      /** Toggle one trigger. */
+      /** Toggle one trigger and remember the choice. */
       const setKindEnabled = (kind, enabled) => {
         const snapshot = store.getSnapshot()
-        store.set({ ...snapshot, kinds: { ...snapshot.kinds, [kind]: enabled } })
+        const kinds = { ...snapshot.kinds, [kind]: enabled }
+        writeStoredKinds(kinds)
+        store.set({ ...snapshot, kinds })
       }
 
       // ----------------------------------------------------------- components
@@ -845,30 +934,60 @@ window.__ModuleLoader__.load({
               onMouseLeave: () => props.arm(toast.id),
             },
             h('span', { className: `dsn-toast-icon is-${toast.kind}` }, h(KindIcon, { kind: toast.kind, size: 16 })),
-            h('span', { className: 'dsn-toast-text' }, toast.body),
+            h('div', { className: 'dsn-toast-text' },
-            h('button', {
+              h('div', { className: 'dsn-toast-title' }, toast.title),
-              type: 'button',
+              h('div', { className: 'dsn-toast-desc' }, toast.body)),
-              className: 'dsn-toast-action',
+            h('div', { className: 'dsn-toast-actions' },
-              onClick: () => {
+              h('button', {
-                props.dismiss(toast.id)
+                type: 'button',
-                props.open(toast.sessionId)
+                className: 'dsn-toast-action',
-              },
+                onClick: () => {
-            }, tr('toast.view')),
+                  props.dismiss(toast.id)
-            h('button', {
+                  props.open(toast.sessionId)
-              type: 'button',
+                },
-              className: 'dsn-toast-close',
+              }, tr('toast.view')),
-              'aria-label': tr('toast.dismiss'),
+              h('button', {
-              onClick: () => props.dismiss(toast.id),
+                type: 'button',
-            }, h(CloseIcon, { size: 12 }))))))
+                className: 'dsn-toast-close',
+                'aria-label': tr('toast.dismiss'),
+                onClick: () => props.dismiss(toast.id),
+              }, h(CloseIcon, { size: 14 })))))))
       }
 
-      /** The General-settings row: permission state, one action, per-trigger switches. */
+      /**
-      function SettingsRow(props) {
+       * One trigger switch row: the label says which notification it governs and
+       * the switch is the control, so the row never needs a second description.
+       */
+      function KindRow(props) {
+        return h('div', { className: 'dsn-row' },
+          h('div', { className: 'dsn-row-text' },
+            h('div', { className: 'dsn-row-title' }, props.label)),
+          h('button', {
+            type: 'button',
+            role: 'switch',
+            className: 'dsn-switch',
+            'aria-checked': props.checked,
+            'aria-label': props.label,
+            disabled: props.disabled,
+            onClick: props.onToggle,
+          }, h('span', { className: 'dsn-thumb' })))
+      }
+
+      /**
+       * This plugin's configuration, rendered on its own page in the plugin
+       * manager (`plugins.bundle.config`, keyed by this package's name).
+       *
+       * The owner asks for two views: `summary` (a one-liner that stands in for
+       * the row's description) and `page` (the whole form). Everything visible here
+       * belongs to this package, including the platform-specific permission hint.
+       */
+      function ConfigSection(props) {
         const snapshot = useOwnStore(props.store)
+        const tr = seatFor(props)
+        if (props.view === 'summary') return h(React.Fragment, null, tr('settings.description'))
         const permission = snapshot.permission
         const supported = permission !== 'unsupported'
         const failed = permission === 'denied' || snapshot.promptError !== ''
-        const tr = seatFor(props)
         const statusKey = permission === 'granted'
           ? 'settings.permission.granted'
           : permission === 'denied'
@@ -876,7 +995,7 @@ window.__ModuleLoader__.load({
             : supported
               ? 'settings.permission.default'
               : 'settings.permission.unsupported'
-        const statusText = snapshot.promptError === ''
+        const permissionText = snapshot.promptError === ''
           ? `${tr(statusKey)}${permission === 'denied' || !supported ? ` · ${tr(`settings.permission.hint.${props.platform}`)}` : ''}`
           : snapshot.promptError
         const health = snapshot.health
@@ -887,39 +1006,49 @@ window.__ModuleLoader__.load({
             : health.state === 'error'
               ? tr('settings.health.error', { message: health.message })
               : tr('settings.health.starting')
+        const healthFailed = health.state !== 'watching' && health.state !== 'starting'
         return h(React.Fragment, null,
           h('style', null, CSS),
-          h('div', { className: 'dsn-row' },
+          h('div', { className: 'dsn-sections' },
-            h('div', { className: 'dsn-row-text' },
+            // The page header already shows this bundle's title and description, so
-              h('div', { className: 'dsn-row-title' }, tr('settings.title')),
+            // this section opens with what the header cannot say: how alerts are
-              h('div', { className: 'dsn-row-desc' }, tr('settings.description')),
+            // carried, and what this form changes.
-              h('div', {
+            h('section', { className: 'dsn-section' },
-                className: `dsn-status${failed ? ' dsn-status-error' : ''}`,
+              h('p', { className: 'dsn-section-desc' }, tr('config.intro'))),
-                role: failed ? 'alert' : 'status',
+            h('section', { className: 'dsn-section' },
-              }, statusText),
+              h('h3', { className: 'dsn-section-title' }, tr('config.section.kinds')),
-              h('div', {
+              KINDS.map((kind) => h(KindRow, {
-                className: `dsn-status${health.state === 'watching' || health.state === 'starting' ? '' : ' dsn-status-error'}`,
+                key: kind,
-                role: health.state === 'watching' || health.state === 'starting' ? 'status' : 'alert',
+                label: tr(`settings.kind.${kind}`),
-              }, healthText),
+                checked: snapshot.kinds[kind] === true,
-              h('div', { className: 'dsn-kinds' },
+                disabled: false,
-                h('span', null, tr('settings.kinds.label')),
+                onToggle: () => props.setKind(kind, snapshot.kinds[kind] !== true),
-                KINDS.map((kind) => h('span', { className: 'dsn-kind', key: kind },
+              })),
-                  h('span', null, tr(`settings.kind.${kind}`)),
+              h('p', { className: 'dsn-section-desc' }, tr('config.saveNote'))),
-                  h('button', {
+            h('section', { className: 'dsn-section' },
-                    type: 'button',
+              h('h3', { className: 'dsn-section-title' }, tr('config.section.permission')),
-                    role: 'switch',
+              h('div', { className: 'dsn-row' },
-                    className: 'dsn-switch',
+                h('div', { className: 'dsn-row-text' },
-                    'aria-checked': snapshot.kinds[kind] === true,
+                  h('p', {
-                    'aria-label': tr(`settings.kind.${kind}`),
+                    className: `dsn-status${failed ? ' dsn-status-error' : ''}`,
-                    disabled: !supported,
+                    role: failed ? 'alert' : 'status',
-                    onClick: () => props.setKind(kind, snapshot.kinds[kind] !== true),
+                  }, permissionText)),
-                  }, h('span', { className: 'dsn-thumb' })))))),
+                h('button', {
-            h('button', {
+                  type: 'button',
-              type: 'button',
+                  className: 'dsn-button',
-              className: 'dsn-button',
+                  disabled: !supported,
-              disabled: !supported,
+                  onClick: permission === 'granted' ? props.test : props.ask,
-              onClick: permission === 'granted' ? props.test : props.ask,
+                }, tr(!supported
-            }, tr(!supported ? 'settings.action.unsupported' : permission === 'granted' ? 'settings.action.test' : 'settings.action.allow'))))
+                  ? 'settings.action.unsupported'
+                  : permission === 'granted' ? 'settings.action.test' : 'settings.action.allow')))),
+            h('section', { className: 'dsn-section' },
+              h('h3', { className: 'dsn-section-title' }, tr('config.section.status')),
+              h('div', { className: 'dsn-row' },
+                h('div', { className: 'dsn-row-text' },
+                  h('p', {
+                    className: `dsn-status${healthFailed ? ' dsn-status-error' : ''}`,
+                    role: healthFailed ? 'alert' : 'status',
+                  }, healthText))))))
       }
 
       // ---------------------------------------------------------- registration
@@ -951,6 +1080,7 @@ window.__ModuleLoader__.load({
         }
       }
 
+      ctx.effect(() => registerDictionaries(locale), 'session-notify: dictionaries')
       ctx.effect(() => installBridges(), 'session-notify: window focus')
       ctx.effect(() => () => {
         disposed = true
@@ -973,10 +1103,14 @@ window.__ModuleLoader__.load({
         }),
       }, ToastLayer))
 
-      ctx.slots.inject('settings.general.item', () => ctx.slots.register({
+      // This plugin's configuration lives on its own page in the plugin manager,
-        name: 'settings.general.item',
+      // keyed by this package's name — the seat the shipped experimental bundle
-        id: NS,
+      // uses for its own settings, and the one the plugin page renders between the
-        order: 97,
+      // bundle's description and its rows. It is deliberately NOT a General
+      // settings row: a plugin's options belong to the plugin.
+      ctx.slots.inject('plugins.bundle.config', () => ctx.slots.register({
+        name: 'plugins.bundle.config',
+        key: PACKAGE_NAME,
         locale: NS,
         inject: () => ({
           store,
@@ -985,7 +1119,7 @@ window.__ModuleLoader__.load({
           test: sendTest,
           setKind: setKindEnabled,
         }),
-      }, SettingsRow))
+      }, ConfigSection))
 
       // The observer lives in the frame-wide overlay, NOT in `sidebar.panellist`.
       //

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plugin/session-notify",
-  "version": "1.0.1",
+  "version": "1.0.4",
   "private": true,
   "type": "module",
   "description": "会话完成、需要授权、需要回答时提醒你：窗口不在前台用系统通知，窗口在前台用应用内轻弹窗。",