dsh-better-notice 5.1.7 → 5.1.8

package/README.md

@@ -13,7 +13,7 @@ dsh plugin --profile <profile> add dsh-better-notice
 ```
 
 - Package: `dsh-better-notice` (module id is the same string)
-- Version: `5.1.7` (see [CHANGELOG.md](CHANGELOG.md))
+- Version: `5.1.8` (see [CHANGELOG.md](CHANGELOG.md))
 - License: MIT
 - Settings live in **account menu → Settings → “Better Notice”** (a `settings.section` entry, id `hotlist`, order `30`)
 
@@ -93,7 +93,7 @@ Only those three states ship raster art (4 tiers each: 64 / 320 / 780 / 1560 px,
 | 🔐 `pending` | Waiting for your approval / answer / plan review (secondary glyph ❓) | — | ✅ | ✅ | ✅ | 🔈 |
 | ✅ `completed` | This plugin saw it finish, within the last 7 min | — | ✅ | ✅ | ✅ | 🔈 |
 | ⏳ `running` | Working (includes “a subagent is running, parent idle”) | — | — | ✅ | — | — |
-| 🧊 `idle` | Idle, and last activity is inside the *recent window* (default 5 min) | ✅ | — | ✅ | — | — |
+| 🧊 `idle` | Idle, and last activity is inside the *recent window* (default 17 min) | ✅ | — | ✅ | — | — |
 
 ✅ = on by default · — = off by default · 🔈 = a bundled sound exists but **stays silent until you enable that category** in settings.
 
@@ -125,7 +125,7 @@ dsh plugin --profile <profile> add dsh-better-notice
 dsh --profile <profile>
 ```
 
-- **Published on npm:** [dsh-better-notice](https://www.npmjs.com/package/dsh-better-notice) (current `5.1.7`). If npm is unreachable, the same tarball is attached to the [latest release](https://github.com/MeruSu/better-notice/releases) — `dsh plugin --profile <profile> add <absolute path>/dsh-better-notice-5.1.7.tgz` gives the same result and the same restart.
+- **Published on npm:** [dsh-better-notice](https://www.npmjs.com/package/dsh-better-notice) (current `5.1.8`). If npm is unreachable, the same tarball is attached to the [latest release](https://github.com/MeruSu/better-notice/releases) — `dsh plugin --profile <profile> add <absolute path>/dsh-better-notice-5.1.8.tgz` gives the same result and the same restart.
 - **Use an absolute path, forward slashes** when you install from a local directory instead of the registry: `dsh plugin` forwards the argument to pnpm *inside the profile directory*, so a relative path points into the profile.
 - Installing from a directory uses `link:` — code edits need no reinstall. `client.js` changes apply on page refresh; `index.js` / `cordis.patch.yml` / `package.json` changes need a GUI restart.
 - Install from a git checkout when you also want the TTS helper (see [Sounds](#sounds-and-the-bundled-tts-tool)). The npm package's `files` field only ships `index.js`, `client.js`, `cordis.patch.yml` and `assets`, so `tools/` is **not** in it.
@@ -150,7 +150,7 @@ The host route is created during process start-up, so a page refresh is not enou
 
 In the GUI's browser console:
 
-1. `window.__HOTLIST_VERSION__` → the version string, e.g. `'5.1.7'`.
+1. `window.__HOTLIST_VERSION__` → the version string, e.g. `'5.1.8'`.
 2. `Object.keys(window.__HOTLIST__)` → `['version','settings','assets']`.
 3. Settings → the left nav has **“Better Notice”**, and the page shows a global block plus **6** collapsible category cards.
 4. Session rows in the sidebar now start with a status glyph.
@@ -258,9 +258,9 @@ Per-category placement is a second layer: `categories.<id>.surfaces.{tab,sidebar
 | I want… | Field | Values | Default |
 |---|---|---|---|
 | Keep a just-finished session in ✅ longer | `collect.completedTtlMs` | `1`–`1440` **minutes** | `7` |
-| Decide how stale a session may be and still count as `idle` | `collect.recentWindowMinutes` | **minutes**; settings exposes `1`–`36`, the API accepts `0`–`120` (`0` = never show idle) | `5` |
+| Decide how stale a session may be and still count as `idle` | `collect.recentWindowMinutes` | **minutes**; settings offers `1`–`120`, the API also accepts `0` (= never show idle) | `17` |
 
-> The recent window has **two layers on purpose**: storage clamps `0`–`120` (so scripts can set 90), the settings control only offers `1`–`36`. Don't mistake the UI bound for the data bound.
+> The recent window has **two layers on purpose**: the settings control offers `1`–`120`; storage clamps `0`–`120` and keeps `0` for a caller that wants "never show idle". Don't mistake the UI bound for the data bound.
 
 ### The six categories — each one is configured separately
 
@@ -313,7 +313,7 @@ Field-name-level documentation for people writing scripts.
 
 - **Collapsed card:** glyph preview, category name, `· order N`, five read-only chips (Tab / Bar / Top / Pop / Snd — highlighted = on), caret. Click the row to expand; **several cards may be open at once**. Open state lives in `sessionStorage` (`dsh.hotlist.open`), never in settings.
 - **Expanded area** (compact multi-column): ① glyph (source / upload / value / frequency slider); ② motion (`motion` + target `glyph`/`row`); ③ popout (enabled / image / entrance·ambient·exit / side·display time); ④ sound (enabled / source / preview); ⑤ order.
-- **Global block:** scope (workspace / all / smart), seat limit (with “auto”), **pinned seats**, completed TTL in minutes, global volume, **recent window** (minutes), `positions.tab`, `positions.topbar`, `positions.sidebar` (API only), `takeOverStatusDot`. The band block (style / label display / pill count / pill width / web preview) only exists while `positions.topbar` is on.
+- **Global block:** scope (workspace / all / smart), seat limit, **pinned seats**, completed TTL in minutes, global volume, **recent window** (minutes), `positions.tab`, `positions.topbar`, `positions.sidebar` (API only), `takeOverStatusDot`. The band block (style / label display / pill count / pill width / web preview) only exists while `positions.topbar` is on.
 - Out-of-range writes are clamped. A failed write (localStorage quota) is reported in the page footer and through `window.__HOTLIST_SETTINGS__.lastError()`.
 
 ### Global defaults
@@ -336,7 +336,7 @@ Field-name-level documentation for people writing scripts.
 | `takeOverStatusDot` | `true` | take over the status dot drawn by other plugins (`dsh-sessions-manager`) |
 | `hideNativeDot` | `true` | hide the host's native status slot (no settings row since 4.4; field kept) |
 | `collect.completedTtlMs` | `420000` (7 min) | 1–1440 minutes |
-| `collect.recentWindowMinutes` | `5` | **minutes**. Settings offers `1`–`36`; API accepts `0`–`120` (`0` = hide `idle`) |
+| `collect.recentWindowMinutes` | `17` | **minutes**. Settings offers `1`–`120`; API also accepts `0` (= hide `idle`) |
 | `sound.volume` | `60` | 0–100, global |
 | `overlay.side` | `'auto'` | `auto` / `left` / `right` |
 | `overlay.sizeMin` / `sizeMax` | `260` / `520` | 120–900 px (no settings row since 4.5; midpoint, narrowed to the viewport) |
@@ -500,7 +500,7 @@ s.lastError()      // last storage write error (string or null)
 
 // settings + the three asset pools
 const api = window.__HOTLIST__;
-api.version                                        // '5.1.7'
+api.version                                        // '5.1.8'
 api.settings.get() / .set(patch) / .reset() / .subscribe(fn)
 api.settings.backups()                             // → [{ at, version }]
 api.settings.restore(index)                        // → { ok, at? }

package/README.zh.md

@@ -13,7 +13,7 @@ dsh plugin --profile <profile> add dsh-better-notice
 ```
 
 - 包名：`dsh-better-notice`（模块 id 与包名相同）
-- 版本：`5.1.7`（见 [CHANGELOG.md](CHANGELOG.md)）
+- 版本：`5.1.8`（见 [CHANGELOG.md](CHANGELOG.md)）
 - 许可：MIT
 - 设置位置：**账号菜单 →「设置」→ 左导航「热表」**（`settings.section`，id `hotlist`，order `30`）
 
@@ -125,7 +125,7 @@ dsh plugin --profile <profile> add dsh-better-notice
 dsh --profile <profile>
 ```
 
-- **已发布到 npm：**[dsh-better-notice](https://www.npmjs.com/package/dsh-better-notice)（当前 `5.1.7`）。如果 npm 拉不动，同样的 tarball 也附在[最新 Release](https://github.com/MeruSu/better-notice/releases) 里——`dsh plugin --profile <profile> add <绝对路径>/dsh-better-notice-5.1.7.tgz`，效果一样，同样要重启。
+- **已发布到 npm：**[dsh-better-notice](https://www.npmjs.com/package/dsh-better-notice)（当前 `5.1.8`）。如果 npm 拉不动，同样的 tarball 也附在[最新 Release](https://github.com/MeruSu/better-notice/releases) 里——`dsh plugin --profile <profile> add <绝对路径>/dsh-better-notice-5.1.8.tgz`，效果一样，同样要重启。
 - 从**本地目录**安装时要用**绝对路径、正斜杠**：`dsh plugin` 是把参数在 profile 目录里转交给 pnpm 的，相对路径会指到 profile 里去。
 - 装目录用的是 `link:`，之后改代码不用重装：`client.js` 改完刷新页面即生效；`index.js` / `cordis.patch.yml` / `package.json` 改完要重启 GUI。
 - 想连 TTS 小工具一起用就装 git 仓库（见[提示音](#提示音与仓库自带的-tts-工具)）。npm 包的 `files` 只有 `index.js`、`client.js`、`cordis.patch.yml`、`assets`，`tools/` **不在包里**。
@@ -150,7 +150,7 @@ host 路由在进程启动时创建，只刷新页面不够。
 
 在 GUI 的浏览器控制台里依次确认：
 
-1. `window.__HOTLIST_VERSION__` → 版本号，例如 `'5.1.7'`；
+1. `window.__HOTLIST_VERSION__` → 版本号，例如 `'5.1.8'`；
 2. `Object.keys(window.__HOTLIST__)` → `['version','settings','assets']`；
 3. 打开设置，左导航有**「热表」**，页面里是一块全局区 + **6** 张可折叠的类别卡；
 4. 侧栏的会话行前面出现了状态图标；
@@ -258,9 +258,9 @@ Windows 上的 GUI 顶部有一条 40px 标题带。插件可以往里面画一
 | 我想… | 字段 | 取值 | 默认 |
 |---|---|---|---|
 | 让刚跑完的会话在 ✅ 里多待一会儿 | `collect.completedTtlMs` | `1`–`1440` **分钟** | `7` |
-| 决定多久没动过的会话还算 `idle` | `collect.recentWindowMinutes` | **分钟**；设置页给 `1`–`36`，走 API 可写 `0`–`120`（`0` = 不显示闲置） | `5` |
+| 决定多久没动过的会话还算 `idle` | `collect.recentWindowMinutes` | **分钟**；设置页给 `1`–`120`，走 API 也可写 `0`（= 不显示闲置） | `17` |
 
-> 最近窗口**故意分两层**：存储层夹 `0`–`120`（所以脚本能写 90），设置页控件只给 `1`–`36`。别把界面上的上限当成数据上限。
+> 最近窗口**故意分两层**：设置页控件给 `1`–`120`；存储层夹 `0`–`120`，`0` 只留给 API 表示「不显示闲置」。别把界面上的范围当成全部。
 
 ### 六个类别：每一类都能单独设
 
@@ -313,7 +313,7 @@ Windows 上的 GUI 顶部有一条 40px 标题带。插件可以往里面画一
 
 - **折叠卡**：图标预览、类别名、`· 顺序 N`、五个只读小标签（Tab / 栏 / 顶 / 弹 / 音，高亮 = 开）、右端 caret。点整行展开，**可以同时开多张卡**。展开状态存 `sessionStorage`（`dsh.hotlist.open`），不写进设置。
 - **展开区**（紧凑多列）：① 图标（来源 / 上传 / 图标值 / 频率滑块）；② 动效（`motion` + 作用于 `glyph`/`row`）；③ 弹出（开关 / 弹出图 / 入场·待机·退出 / 出现侧·停留时长）；④ 音效（启用 / 来源 / 试听）；⑤ 顺序。
-- **全局区**：范围（当前工作区 / 全部 / 智能）、座位上限（含「自动」）、**置顶最多显示**、刚完成保持时长（分钟）、全局音量、**最近窗口**（分钟）、`positions.tab`、`positions.topbar`、`positions.sidebar`（仅 API）、`takeOverStatusDot`。顶栏那一段（样式 / 标签显示 / 胶囊数 / 胶囊宽度 / 网页预览）只在 `positions.topbar` 打开时才存在。
+- **全局区**：范围（当前工作区 / 全部 / 智能）、座位上限、**置顶最多显示**、刚完成保持时长（分钟）、全局音量、**最近窗口**（分钟）、`positions.tab`、`positions.topbar`、`positions.sidebar`（仅 API）、`takeOverStatusDot`。顶栏那一段（样式 / 标签显示 / 胶囊数 / 胶囊宽度 / 网页预览）只在 `positions.topbar` 打开时才存在。
 - 越界写入会被夹回范围。写盘失败（localStorage 配额满）会在页脚提示，也能从 `window.__HOTLIST_SETTINGS__.lastError()` 拿到原因。
 
 ### 全局默认值
@@ -500,7 +500,7 @@ s.lastError()      // 最近一次写盘错误（字符串或 null）
 
 // 设置 + 三个素材池
 const api = window.__HOTLIST__;
-api.version                                        // '5.1.7'
+api.version                                        // '5.1.8'
 api.settings.get() / .set(patch) / .reset() / .subscribe(fn)
 api.settings.backups()                             // → [{ at, version }]
 api.settings.restore(index)                        // → { ok, at? }

package/client.js

@@ -79,7 +79,7 @@ window.__ModuleLoader__.load({
 
     const SLOT = 'conversation.view';
     const NS = 'hotlist';
-    const VERSION = '5.1.7';
+    const VERSION = '5.1.8';
     /** Seat view ids are namespaced so a persisted leftover can be recognised and repaired. */
     const SEAT_PREFIX = 'hotlist-seat-';
     /** Every prefix ever written for a seat id; a persisted one is repaired back to `chat` on load. */
@@ -224,6 +224,11 @@ window.__ModuleLoader__.load({
        * band switched off forever.
        */
       'positions.topbar': [false],
+      /**
+       * v4.6 shipped 5 minutes as the window default. A stored 5 with no marker is that default,
+       * not a pick, so the current 17 replaces it; anyone who typed 5 gets a marker and keeps it.
+       */
+      'collect.recentWindowMinutes': [5],
     };
     /**
      * Which picks the page can offer, and where their marker lives. Writing one of those fields
@@ -231,7 +236,7 @@ window.__ModuleLoader__.load({
      */
     const CHOICE_SLOTS = ['glyph', 'glyphSecondary'];
     const CHOICE_FIELDS = ['value', 'motion', 'motionTarget', 'frequency'];
-    const CHOICE_KEY = /^(?:categories\.[a-z]+\.[a-zA-Z]+(?:\.[a-zA-Z]+)?|positions\.topbar)$/;
+    const CHOICE_KEY = /^(?:categories\.[a-z]+\.[a-zA-Z]+(?:\.[a-zA-Z]+)?|positions\.topbar|collect\.recentWindowMinutes)$/;
     const CHOICE_LIMIT = 256;
     /**
      * Which surface each class belongs to. The split is the point of the feature: the band is
@@ -278,13 +283,12 @@ window.__ModuleLoader__.load({
     const ALWAYS_OVERFLOW = 4;
     const TTL_MINUTES = { min: 1, max: 1440 };
     /** One global window: how recently a session moved to enter the idle tier. */
-    const RECENT_WINDOW_MINUTES = { min: 0, max: 120, fallback: 5 };
+    const RECENT_WINDOW_MINUTES = { min: 0, max: 120, fallback: 17 };
     /**
-     * What the settings page offers for that window. Storage and the API stay on
-     * `RECENT_WINDOW_MINUTES` (0–120), so a caller may still ask for a wider window; the row only
-     * shows the range a person actually wants, and 0 is not one of them.
+     * What the settings page offers for that window: the same 1–120 a person may want. Storage and
+     * the API keep 0 as "no window" for a caller that asks for it explicitly; the row never shows 0.
      */
-    const RECENT_WINDOW_UI = { min: 1, max: 36 };
+    const RECENT_WINDOW_UI = { min: 1, max: 120 };
     /** One-slot animation bursts: never more than this many glyphs animating at once. */
     // four titles moving at once is the readability ceiling; frequency decides how often.
     const MOTION_CONCURRENCY = 4;
@@ -485,7 +489,6 @@ window.__ModuleLoader__.load({
       'settings.group.motion': '动效',
       'settings.maxSeats': '座位上限',
       'settings.maxSeatsHint': '对话区 tab 行最多显示几个会话（1–12）。',
-      'settings.maxSeatsAuto': '自动',
       'settings.scope': '显示范围',
       'settings.scopeHint': '哪些工作区的会话进列表（顶栏、tab 行与侧栏一致）。',
       'settings.scope.workspace': '仅当前工作区',
@@ -496,7 +499,7 @@ window.__ModuleLoader__.load({
       'settings.ttl': '刚完成保持时长（分钟）',
       'settings.ttlHint': '会话跑完后仍留在列表里的时间。',
       'settings.recentWindow': '最近对话展示时间（分钟）',
-      'settings.recentWindowHint': '1–36 分钟。最后活动在这个时间内的会话会进第 3 级（闲置）并出现在对话区 tab 行。API 可写 0–120。',
+      'settings.recentWindowHint': '1–120 分钟。最后活动在这个时间内的会话会进第 3 级（闲置）并出现在对话区 tab 行。',
       'settings.motion': '动效',
       'settings.motion.none': '不动',
       'settings.motion.spin': '旋转',
@@ -677,7 +680,6 @@ window.__ModuleLoader__.load({
       'settings.group.motion': 'Motion',
       'settings.maxSeats': 'Maximum seats',
       'settings.maxSeatsHint': 'How many sessions the tab row may show (1–12).',
-      'settings.maxSeatsAuto': 'Automatic',
       'settings.scope': 'Scope',
       'settings.scopeHint': 'Which workspaces feed the list (top bar, tab row and sidebar alike).',
       'settings.scope.workspace': 'Current workspace only',
@@ -688,7 +690,7 @@ window.__ModuleLoader__.load({
       'settings.ttl': 'Keep finished seats for (minutes)',
       'settings.ttlHint': 'How long a finished session stays in the list.',
       'settings.recentWindow': 'Recent conversation window (minutes)',
-      'settings.recentWindowHint': '1–36 minutes. Sessions active within this window enter the third tier (idle) and show in the conversation tab row. The API accepts 0–120.',
+      'settings.recentWindowHint': '1–120 minutes. Sessions active within this window enter the third tier (idle) and show in the conversation tab row.',
       'settings.motion': 'Motion',
       'settings.motion.none': 'Still',
       'settings.motion.spin': 'Spin',
@@ -992,6 +994,9 @@ const FULL_WIDTH = /[\u1100-\u115f\u2e80-\u303e\u3041-\u33ff\u3400-\u4dbf\u4e00-
       const next = { ...(isPlainObject(base.choices) ? base.choices : {}) };
       if (isPlainObject(patch) === false) return next;
       if (isPlainObject(patch.positions) && typeof patch.positions.topbar === 'boolean') next['positions.topbar'] = true;
+      if (isPlainObject(patch.collect) && typeof patch.collect.recentWindowMinutes === 'number') {
+        next['collect.recentWindowMinutes'] = true;
+      }
       const categories = isPlainObject(patch.categories) ? patch.categories : {};
       for (const [category, change] of Object.entries(categories)) {
         if (CATEGORY_IDS.includes(category) === false || isPlainObject(change) === false) continue;
@@ -1234,9 +1239,16 @@ const FULL_WIDTH = /[\u1100-\u115f\u2e80-\u303e\u3041-\u33ff\u3400-\u4dbf\u4e00-
         ? clamp(Math.round(legacyIdle.within), RECENT_WINDOW_MINUTES.min, RECENT_WINDOW_MINUTES.max)
         : null;
       if (isPlainObject(raw.collect) && typeof raw.collect.recentWindowMinutes === 'number' && Number.isFinite(raw.collect.recentWindowMinutes)) {
-        next.collect.recentWindowMinutes = clamp(Math.round(raw.collect.recentWindowMinutes), RECENT_WINDOW_MINUTES.min, RECENT_WINDOW_MINUTES.max);
+        const minutes = clamp(Math.round(raw.collect.recentWindowMinutes), RECENT_WINDOW_MINUTES.min, RECENT_WINDOW_MINUTES.max);
+        /** Same boundary as the presets: an unmarked value equal to the old default follows the default. */
+        const stale = isLegacyValue(legacyValuesOf('collect', 'recentWindowMinutes'), minutes);
+        const chosen = next.choices['collect.recentWindowMinutes'] === true;
+        next.collect.recentWindowMinutes = stale === true && chosen === false ? next.collect.recentWindowMinutes : minutes;
       } else if (legacyWithin !== null) {
-        next.collect.recentWindowMinutes = legacyWithin;
+        /** The class field had the same 5-minute factory default, so an unmarked 5 follows the default too. */
+        const stale = isLegacyValue(legacyValuesOf('collect', 'recentWindowMinutes'), legacyWithin);
+        const chosen = next.choices['collect.recentWindowMinutes'] === true;
+        if (stale === false || chosen === true) next.collect.recentWindowMinutes = legacyWithin;
       }
       /** v4.6 dropped the hand-written pin list: pins live in the workspace store, this only caps the row. */
       if (isPlainObject(raw.pinned) && typeof raw.pinned.maxSeats === 'number' && Number.isFinite(raw.pinned.maxSeats)) {
@@ -4083,19 +4095,17 @@ const FULL_WIDTH = /[\u1100-\u115f\u2e80-\u303e\u3041-\u33ff\u3400-\u4dbf\u4e00-
             h('span', { key: 'title', className: 'hl-rowTitle' }, t('settings.maxSeats')),
             h('span', { key: 'hint', className: 'hl-rowHint' }, t('settings.maxSeatsHint')),
           ]),
+          /**
+           * No "automatic" option: it was a second, differently-shaped control on a row that is
+           * otherwise a plain stepper, and every other seat count here is a plain stepper too. A
+           * stored `'auto'` is still honoured (`buildSeatPlan` reads it), the stepper just starts
+           * from the fallback and the first click writes a number.
+           */
           h('div', { key: 'control', className: 'hl-fieldControl' }, numberStepper(
             settings.maxSeats === 'auto' ? MAX_SEATS.fallback : settings.maxSeats,
             MAX_SEATS.min,
             MAX_SEATS.max,
             (value) => patch({ maxSeats: value }),
-            h('button', {
-              key: 'auto',
-              type: 'button',
-              className: 'hl-link',
-              'aria-pressed': settings.maxSeats === 'auto' ? 'true' : 'false',
-              onClick: () => patch({ maxSeats: settings.maxSeats === 'auto' ? MAX_SEATS.fallback : 'auto' }),
-            }, t('settings.maxSeatsAuto')),
-            settings.maxSeats === 'auto',
           )),
         ]),
         h('div', { key: 'pinnedSeats', className: 'hl-row', 'data-hotlist-row': 'pinned.maxSeats' }, [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-better-notice",
-  "version": "5.1.7",
+  "version": "5.1.8",
   "private": false,
   "description": "Better Notice — unified visual and audible session notices for DeepSeek Harness: hot-session tab seats, sidebar state glyphs, per-state sounds and popout artwork",
   "type": "module",