dsh-web-icon-indicator 0.2.2 → 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,67 @@
+# Changelog
+
+All notable changes to **dsh-web-icon-indicator** are documented here.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.3.0](https://github.com/waknow/dsh-web-icon-indicator/compare/v0.2.3...v0.3.0) (2026-08-31)
+
+### Added
+
+* show full-frame active count while multiple agents run ([d287620](https://github.com/waknow/dsh-web-icon-indicator/commit/d287620a6d66a6aa0b4ce8580adad77908ecdaab))
+
+### Changed
+
+* add npm version/downloads/license badges to both READMEs ([e3dd298](https://github.com/waknow/dsh-web-icon-indicator/commit/e3dd29806413ea5f33dd36077caa340c24e8c70c))
+* document automated release flow with commit-and-tag-version ([1754216](https://github.com/waknow/dsh-web-icon-indicator/commit/1754216c32003a722f619935ebf0ab1a402887f1))
+
+## [0.2.3](https://github.com/waknow/dsh-web-icon-indicator/compare/v0.2.2...v0.2.3) (2026-08-24)
+
+### Changed
+
+* add CHANGELOG.md with release history; link it from READMEs ([262730c](https://github.com/waknow/dsh-web-icon-indicator/commit/262730c83449b36fa60442204b3362d8a8b43e8f))
+
+## [0.2.2] - 2026-08-24
+
+### Changed
+
+- Added the [awesome · DSH plugin](https://awesome-dsh-plugin.com/badge.svg) listing badge to `README.md` and `README.zh.md` now that the plugin is featured in [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) ([9042fb3](https://github.com/waknow/dsh-web-icon-indicator/commit/9042fb3)).
+- npm publishing is now fully automated on `v*` tags via GitHub Actions (OIDC trusted publishing, no token secrets) — verified end-to-end with the `0.2.2` release.
+
+## [0.2.1] - 2026-08-21
+
+### Added
+
+- Settings card UX polish and favicon render robustness ([e584912](https://github.com/waknow/dsh-web-icon-indicator/commit/e584912)).
+- Documentation: visualize the default config and all effects in the READMEs; settings card shows a cycle field only for animated states and swatches as native color pickers; Safari favicon dynamic-color feasibility research with browser support tables ([23da09e](https://github.com/waknow/dsh-web-icon-indicator/commit/23da09e), [d99546d](https://github.com/waknow/dsh-web-icon-indicator/commit/d99546d), [04a8e58](https://github.com/waknow/dsh-web-icon-indicator/commit/04a8e58)).
+- CI: publish to npm from GitHub Actions on version tags; verify the tag matches `package.json` before publishing; switch `@deepseek-ai` deps to `peerDependencies` ([b96e90e](https://github.com/waknow/dsh-web-icon-indicator/commit/b96e90e), [61fc3bc](https://github.com/waknow/dsh-web-icon-indicator/commit/61fc3bc), [23da09e](https://github.com/waknow/dsh-web-icon-indicator/commit/23da09e)).
+
+### Fixed
+
+- Keep the heartbeat/bounce whale centered when the CSS animation runs ([4a379aa](https://github.com/waknow/dsh-web-icon-indicator/commit/4a379aa)).
+
+## [0.2.0] - 2026-08-20
+
+### Added
+
+- Full per-state visual configuration: `effect` / `colors[]` / `speed` per state, plus `askingHoldMs` / `doneHoldMs` timings ([dca6de3](https://github.com/waknow/dsh-web-icon-indicator/commit/dca6de3)).
+- DSH settings service integration (`web-icon-indicator` namespace) with a settings-page card — validate, persist to `settings.yaml`, and apply live to the running tab ([7cf6962](https://github.com/waknow/dsh-web-icon-indicator/commit/7cf6962)).
+- Sandbox-interception and approval waits surfaced as the `asking` state ([1f8ebba](https://github.com/waknow/dsh-web-icon-indicator/commit/1f8ebba)).
+- Background-tab animation fallback: wall-clock frames for animated states while `requestAnimationFrame` is paused in hidden tabs ([4abc9b2](https://github.com/waknow/dsh-web-icon-indicator/commit/4abc9b2)).
+- Polling resilience: a transient fetch failure restores the original icon and retries on the next tick instead of killing the poll ([d7b4188](https://github.com/waknow/dsh-web-icon-indicator/commit/d7b4188)).
+
+### Changed
+
+- Replaced the individual per-state SVG icons with a single [base.svg](icons/base.svg) whale template, recolored and animated entirely in the browser as `data:image/svg+xml` URIs ([0a76d0b](https://github.com/waknow/dsh-web-icon-indicator/commit/0a76d0b)).
+- Browser half rewritten to use shell UI primitives for the settings card ([971f3b6](https://github.com/waknow/dsh-web-icon-indicator/commit/971f3b6)).
+- Added live SVG previews of every state and effect to the READMEs ([a1f67ce](https://github.com/waknow/dsh-web-icon-indicator/commit/a1f67ce)).
+
+## [0.1.0] - 2026-08-19
+
+### Added
+
+- Initial release: browser tab favicon mirrors the DSH session state (`idle` / `running` / `asking` / `done`) with a single-color whale icon ([c8b66cb](https://github.com/waknow/dsh-web-icon-indicator/commit/c8b66cb)).
+- Repository metadata and install-from-source instructions ([69f550c](https://github.com/waknow/dsh-web-icon-indicator/commit/69f550c)).

package/README.md

@@ -1,8 +1,11 @@
 # dsh-web-icon-indicator
 
-> 📖 [中文文档](README.zh.md) · [English](README.md)
+> 📖 [中文文档](README.zh.md) · [English](README.md) · 📝 [Changelog](CHANGELOG.md) · [Releases](https://github.com/waknow/dsh-web-icon-indicator/releases)
 
 [![awesome · DSH plugin](https://awesome-dsh-plugin.com/badge.svg)](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)
+[![npm version](https://img.shields.io/npm/v/dsh-web-icon-indicator)](https://www.npmjs.com/package/dsh-web-icon-indicator)
+[![npm downloads](https://img.shields.io/npm/dm/dsh-web-icon-indicator)](https://www.npmjs.com/package/dsh-web-icon-indicator)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
 
 Browser tab favicon reflects the current DSH session state — `idle` / `running` / `asking` / `done` — so you can see at a glance whether a session needs your attention, even when the tab is in the background.
 
@@ -14,6 +17,7 @@ Browser tab favicon reflects the current DSH session state — `idle` / `running
 - **Fully configurable, applied live** — every state's color, effect and cycle speed, plus the asking/done hold timings, apply to the running tab within ~1 s — no reload, no restart.
 - **Built-in settings UI, zero YAML** — a *Favicon indicator* card in the DSH settings page edits the whole config with live color-swatch previews and persists it to `settings.yaml` for you (path below).
 - **Background-tab & restart-proof** — animated states keep a wall-clock fallback while `requestAnimationFrame` is paused in hidden tabs, and the status poll self-heals across host restarts.
+- **Active-agent count at a glance** — while **more than one** agent is active (non-idle: `asking` / `running` / `done`), the favicon switches from the whale to a **full-frame number block** showing the live count (up to `99+`), colored and animated exactly like the whale would be in that state; back to the whale when 0–1 agents are active. (Same visual language as the *满幅数字* channel in [`demo/badge.html`](./demo/badge.html).)
 
 ### 🛠 Configuration UI — how to get there
 
@@ -151,7 +155,7 @@ service under the `web-icon-indicator` namespace (a schemastery schema in
 ## How it works
 
 - Host plugin with a small browser half: registers routes on the existing `webServer` — the status JSON endpoint, a static `/dsh-web-icon-indicator/base.svg` (the whale template), and one `tapIndex` that injects a small browser script into every served `index.html`. The config surface is registered with the DSH settings service (`web-icon-indicator` namespace) for validation, persistence, and the settings-page card (see above).
-- Status is aggregated across live `agents.list()` with priority `asking > running > done > idle`. The aggregation runs a `reconcile()` step on every request to detect running → idle transitions, because `agent/status`'s idle delivery is not guaranteed at turn end.
+- Status is aggregated across live `agents.list()` with priority `asking > running > done > idle`. The aggregation runs a `reconcile()` step on every request to detect running → idle transitions, because `agent/status`'s idle delivery is not guaranteed at turn end. The status endpoint also reports `active` — the number of non-idle agents — and while that count is **> 1** the injected script renders a full-frame count block (the *满幅数字* channel of [`demo/badge.html`](./demo/badge.html): a rounded block filled with the same per-frame state color/effect as the whale, bold white count sized 31%–52% of the icon, capped at `99+`) instead of the whale, so the tab shows how many agents are busy at once even in a pinned 16px tab.
 - `ask_user_question` tool calls (via `tools/pre-execute` / `tools/result`) flip the session into `asking` with a configurable minimum-hold so the icon stays visible even when the user answers immediately.
 - Permission / **sandbox-interception** waits are also surfaced as `asking`: when the agent hits a sandbox denial and escalates (`sandbox_permissions` + `justification`), or any other tool asks for approval, the approval service appends an `approval/asked` session event and blocks the agent until you decide. The plugin watches `session/event` (with an authoritative fold over the live session log as a fallback) and pins the session into the `asking` state for that whole wait, clearing it on `approval/decided`.
 - The browser script polls `/dsh-web-icon-status.json` once a second, fetches `base.svg` once, and then on every `requestAnimationFrame` tick rebuilds the favicon as a `data:image/svg+xml,…` URI — replacing the `__COLOR__` placeholder with the state's configured color and applying the state's configured effect. The status response also echoes the current per-state visual config, so a settings save reaches the running tab on the next poll (~1 s) without a reload. Browsers don't play favicon SVG CSS animations, so all motion is JS-driven. Because browsers pause `requestAnimationFrame` in hidden tabs, the poll also repaints a wall-clock frame for animated states, so background tabs keep animating (coarsely) instead of freezing; full-speed animation resumes when the tab is visible again. The poll also survives host restarts: a transient fetch failure restores the original icon and retries on the next tick (the SPA reconnects in place, so the icon comes back without a manual refresh).

package/README.zh.md

@@ -1,8 +1,11 @@
 # dsh-web-icon-indicator
 
-> 📖 [English](README.md) · [中文文档](README.zh.md)
+> 📖 [English](README.md) · [中文文档](README.zh.md) · 📝 [更新记录](CHANGELOG.md) · [Releases](https://github.com/waknow/dsh-web-icon-indicator/releases)
 
 [![awesome · DSH plugin](https://awesome-dsh-plugin.com/badge.svg)](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)
+[![npm version](https://img.shields.io/npm/v/dsh-web-icon-indicator)](https://www.npmjs.com/package/dsh-web-icon-indicator)
+[![npm downloads](https://img.shields.io/npm/dm/dsh-web-icon-indicator)](https://www.npmjs.com/package/dsh-web-icon-indicator)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
 
 浏览器标签页 favicon 实时反映 DSH 会话状态——`待机` / `运行中` / `提问` / `完成`——让你在标签页置于后台时也能一眼看出是否有会话需要处理。
 
@@ -14,6 +17,7 @@
 - **完全可配置、即时生效** —— 每个状态的颜色、特效、周期，以及提问 / 完成驻留时长，改动约 1 秒内同步到已打开的标签页——无需刷新、无需重启。
 - **内置配置 UI，无需手写 YAML** —— DSH 设置页里的 *标签页图标指示器* 卡片可编辑整套配置，带实时色块预览，保存后自动写入 `settings.yaml`（路径见下）。
 - **后台标签页与重启抗性** —— 隐藏标签页中 `requestAnimationFrame` 被暂停时，动画态会按墙钟时间补帧；状态轮询还能扛住 host 重启，图标自动恢复。
+- **多 agent 一目了然** —— 当同时有**超过一个**活动 agent（非待机：`asking` / `running` / `done`）时，favicon 从鲸鱼切换为**占满整帧的数字块**，实时显示活动数（上限 `99+`），颜色与动画和该状态下鲸鱼完全一致；活动数回到 0–1 时恢复鲸鱼。（视觉与 [`demo/badge.html`](./demo/badge.html) 的「满幅数字」通道一致。）
 
 ### 🛠 配置界面——怎么找到它
 
@@ -145,7 +149,7 @@ config:
 ## 实现原理
 
 - Host 插件 + 一个小型浏览器半区：在现有 `webServer` 上注册路由——状态 JSON 端点、静态 `/dsh-web-icon-indicator/base.svg`（鲸鱼模板），以及一个 `tapIndex` 向每个 `index.html` 注入小段浏览器脚本。整套配置已注册进 DSH settings 服务（`web-icon-indicator` 命名空间）用于校验、持久化与设置页卡片（见上）。
-- 状态按 `agents.list()` 聚合，优先级 `asking > running > done > idle`。每次请求都会执行一次 `reconcile()` 检测 running → idle 的转换，因为 `agent/status` 的 idle 事件在回合结束时并不保证送达。
+- 状态按 `agents.list()` 聚合，优先级 `asking > running > done > idle`。每次请求都会执行一次 `reconcile()` 检测 running → idle 的转换，因为 `agent/status` 的 idle 事件在回合结束时并不保证送达。状态端点还会上报 `active`——非待机 agent 数——当该数 **> 1** 时，注入脚本改为渲染占满整帧的数字块（[`demo/badge.html`](./demo/badge.html) 的「满幅数字」通道：圆角色块，填充色与鲸鱼同源的逐帧状态色/特效，白色粗体数字约占图标高度 31%–52%，上限 `99+`），而不是鲸鱼，这样即使在 16px 的固定标签页里也能一眼看出同时有几个 agent 在忙。
 - `ask_user_question` 工具调用（通过 `tools/pre-execute` / `tools/result`）把会话置为 `asking`，带可配置的最小保持时长，即使你立刻回答，图标也会保持可见。
 - 权限 / **沙箱拦截**等待同样会显示为 `asking`：当 agent 命中沙箱拒绝并请求提权（`sandbox_permissions` + `justification`），或其他工具需要征得同意时，审批服务会先写入一条 `approval/asked` 会话事件并阻塞 agent，直到你做出决定。插件监听 `session/event`（并以实时会话日志的权威折叠作为兜底）在整个等待期间将会话置为 `asking` 状态，收到 `approval/decided` 后清除。
 - 浏览器脚本每秒轮询 `/dsh-web-icon-status.json`，首次获取 `base.svg`，然后每个 `requestAnimationFrame` 周期把 favicon 重建为 `data:image/svg+xml,…` URI——把 `__COLOR__` 占位符替换为状态配置的颜色，并应用该状态配置的特效。状态响应还会携带当前的每状态视觉配置，因此设置保存后约 1 秒内（下一个轮询 tick）即同步到已打开的标签页，无需刷新。浏览器不会播放 SVG favicon 的 CSS 动画，所以一切动画都由 JS 驱动。由于浏览器在**隐藏（后台）标签页会暂停 `requestAnimationFrame`**，轮询还会为动画态补绘一帧按墙钟时间计算的画面——后台标签页保持粗粒度动画（约每 1 秒）而不会冻结，切回前台后恢复满速动画。轮询还能**扛住 host 重启**：瞬时请求失败时先还原原始图标，并在下一个 tick 重试（SPA 原地重连，无需手动刷新图标即可恢复）。

package/lib/index.js

@@ -22,8 +22,16 @@
  *     session into `asking` while the agent waits on the user for a
  *     permission decision (covers sandbox escalations too).
  *   - `agent/turn-stopping` flips `running`/`asking` into `done`.
+ *   - A lost `tools/result` cannot pin `asking` forever: the hold re-arms at
+ *     most ASK_MAX_REARM times, then force-releases against live status.
  *   - `reconcile()` (on every status request) watches `agents.list()` for
  *     running→idle transitions as a fallback.
+ *   - The status endpoint also reports `active` — the number of non-idle
+ *     agents (asking / running / done). While more than one agent is active
+ *     the favicon shows that count as a full-frame number block (filled with
+ *     the aggregate state's color/effect, "满幅数字" per demo/badge.html)
+ *     instead of the whale; with 0–1 active agents the whale is drawn as
+ *     before.
  *
  * No Client half: the browser script runs outside the sandbox by being
  * injected into the served index.html, where `document` is freely available.
@@ -126,7 +134,10 @@ const INJECTED_SCRIPT = `
     var ORIGINAL = null;
     var TIMER = null;
     var RAF = null;
-    var PREV_STATE = null;   // state the current animation loop was started for
+    var PREV_KEY = null;     // render key (state + "|" + active count) the current loop was started for
+    var ACTIVE = 0;          // non-idle agent count from the status poll; >= BIG_NUM_MIN switches to the count block
+    var BIG_NUM_MIN = 2;     // show the full-frame number while more than one agent is active
+    var BIG_NUM_RX = 11;     // count-block corner radius (demo/badge.html bigNum channel)
     var ANIM_START = null;   // wall-clock start of the current loop (hidden-tab fallback)
     var STATUS_PATH = "__STATUS_PATH__";
     var BASE_PATH = "__BASE_PATH__";
@@ -209,6 +220,30 @@ const INJECTED_SCRIPT = `
     }
 
     // ---- svg frame builder --------------------------------------------------
+    // Full-frame activity count ("满幅数字", per demo/badge.html bigNum
+    // channel): while more than one agent is active the whole icon becomes a
+    // state-colored rounded block with a bold count — no whale is drawn, so
+    // count changes never show the whale through the number. Digit size shrinks
+    // by width (31%–52% of the icon height), readable at 16px and in pinned
+    // tabs; cap at "99+". The fill comes from the SAME per-frame state effect
+    // as the whale, so blink/breath/rainbow animate the block identically;
+    // geometric transform effects (heartbeat/bounce) only wrap the whale and
+    // are deliberately skipped here — a full-frame rect cannot scale without
+    // cropping (mirrors the demo's svgFrame showWhale=false branch).
+    function bigNumUri(fill) {
+      var text = String(ACTIVE > 99 ? "99+" : ACTIVE);
+      var chars = text.length;
+      var fs = chars === 1 ? 26 : chars === 2 ? 20 : 15.5;
+      var rgb = hexToRgb(fill);
+      var lum = (0.299 * rgb[0] + 0.587 * rgb[1] + 0.114 * rgb[2]) / 255;
+      var fg = lum > 0.6 ? "#111111" : "#FFFFFF"; // auto-contrast on the state color
+      var svg = '<svg xmlns="http://www.w3.org/2000/svg" width="50" height="50" viewBox="0 0 50 50" fill="none">' +
+        '<rect x="0" y="0" width="50" height="50" rx="' + BIG_NUM_RX + '" fill="' + fill + '"/>' +
+        '<text x="25" y="' + (25 + fs * 0.34).toFixed(1) + '" text-anchor="middle" font-family="system-ui, sans-serif" font-size="' + fs + '" font-weight="800" fill="' + fg + '">' + text + '</text>' +
+        '</svg>';
+      return "data:image/svg+xml," + encodeURIComponent(svg);
+    }
+
     // Reuses the fetched base template; replaces its __COLOR__ token (and,
     // for scale/translate effects, wraps the whale in a <g transform>).
     function frameUri(fill, effect, t, speed) {
@@ -259,20 +294,24 @@ const INJECTED_SCRIPT = `
       var effect = st.effect || "static";
       var speed = st.speed || DEF_SPEED;
       var cols = (st.colors && st.colors.length) ? st.colors : [DEF_COLOR];
-      return frameUri(frameColor(cols, effect, t, speed), effect, t, speed);
+      var fill = frameColor(cols, effect, t, speed);
+      // More than one active agent: the count block replaces the whale frame.
+      if (ACTIVE >= BIG_NUM_MIN) return bigNumUri(fill);
+      return frameUri(fill, effect, t, speed);
     }
     function stopAnim() { if (RAF) { cancelAnimationFrame(RAF); RAF = null; } }
     function apply(state) {
       var link = linkEl();
       if (!link) return;
       if (state == null) { stopAnim(); return; }
-      // Unchanged state: keep the running loop (don't reset the phase) — the
-      // 1 s poll would otherwise restart animated effects from phase 0 every
-      // second. Browsers PAUSE requestAnimationFrame in hidden tabs, so a
-      // background tab would freeze on the last frame: repaint here instead —
-      // animated states get a wall-clock frame (coarse ~1 Hz animation), static
-      // states repaint (self-heal / pick up changes that happened while hidden).
-      if (BASE && state === PREV_STATE) {
+      // Unchanged state AND unchanged activity count: keep the running loop
+      // (don't reset the phase) — the 1 s poll would otherwise restart
+      // animated effects from phase 0 every second. Browsers PAUSE
+      // requestAnimationFrame in hidden tabs, so a background tab would freeze
+      // on the last frame: repaint here instead — animated states get a
+      // wall-clock frame (coarse ~1 Hz animation), static states repaint
+      // (self-heal / pick up changes that happened while hidden).
+      if (BASE && state + "|" + ACTIVE === PREV_KEY) {
         if (isStatic(state)) {
           var sframe = frameAt(state, 0);
           if (sframe && link.isConnected) setHref(sframe);
@@ -282,12 +321,12 @@ const INJECTED_SCRIPT = `
         }
         return;
       }
-      PREV_STATE = state;
+      PREV_KEY = state + "|" + ACTIVE;
       stopAnim();
       if (!BASE) { // base.svg not loaded yet — fetch once, then start
         fetch(location.origin + BASE_PATH + "?t=" + Date.now(), { cache: "no-store" })
           .then(function (r) { if (!r.ok) throw new Error("base " + r.status); return r.text(); })
-          .then(function (txt) { BASE = txt; PREV_STATE = null; apply(state); })
+          .then(function (txt) { BASE = txt; PREV_KEY = null; apply(state); })
           .catch(function () {});
         return;
       }
@@ -324,12 +363,19 @@ const INJECTED_SCRIPT = `
       if (next === CFG_JSON) return;
       CFG_JSON = next;
       CFG = { states: j.states };
-      PREV_STATE = null; // force a full repaint on the next apply
+      PREV_KEY = null; // force a full repaint on the next apply
     }
     function poll() {
       fetch(location.origin + STATUS_PATH, { cache: "no-store" })
         .then(function (r) { if (!r.ok) throw new Error("bad"); return r.json(); })
-        .then(function (j) { syncCfg(j); apply(j.state || "idle"); })
+        .then(function (j) {
+          syncCfg(j);
+          // Non-idle agent count: >= BIG_NUM_MIN switches the frame to the
+          // full-frame number. Older hosts omit the field; keep the last
+          // known count (initial 0 → whale only).
+          if (typeof j.active === "number") ACTIVE = j.active;
+          apply(j.state || "idle");
+        })
         // Transient failures (host restarting, network blip) must NOT kill the
         // poll: restore the original icon and retry on the next tick. The SPA
         // reconnects in place, so the tab survives a host restart — the icon
@@ -439,18 +485,36 @@ export default {
     const askDone = new Set();       // agentIds whose ask_user_question tool call already returned
     const askTimers = new Map();     // agentId -> ctx.timer.timeout disposer
     const pendingApprovals = new Set(); // agentIds with an open approval/asked (waiting on the user)
+    // Per-agent done-hold disposers, keyed like the other maps. Tracking them
+    // explicitly (instead of firing a never-cancelled timeout) lets a state
+    // leaving `done` cancel the hold, and `agent/disposed` cancel it too; a
+    // done→running→done round-trip no longer stacks two timers that race to
+    // truncate the hold early.
+    const doneTimers = new Map();    // agentId -> ctx.timer.timeout disposer
+
+    const cancelDoneHold = (id) => {
+      const d = doneTimers.get(id);
+      if (d) { try { d(); } catch (e) {} doneTimers.delete(id); }
+    };
 
     const setState = (id, state) => {
       const prev = states.get(id);
       const now = Date.now();
       if (state === "asking") asking.add(id);
+      // Same-state transition: keep `since` and — for done — the already-armed
+      // hold untouched (never stack a second timer; never cancel the live one).
       if (prev && prev.state === state) { states.set(id, { state, since: prev.since }); return; }
+      // Leaving `done` (to running/idle/asking) cancels any in-flight hold so a
+      // stale timer can't later force the state back to idle.
+      if (prev && prev.state === "done") cancelDoneHold(id);
       states.set(id, { state, since: now });
       if (state === "done") {
         const handle = ctx.timer.timeout(() => {
           const cur = states.get(id);
           if (cur && cur.state === "done") states.set(id, { state: "idle", since: Date.now() });
+          doneTimers.delete(id);
         }, cfg.doneHoldMs);
+        doneTimers.set(id, handle);
         ctx.effect(() => handle);  // register for cleanup
       }
     };
@@ -477,13 +541,32 @@ export default {
 
     // Asking: visible minimum (askingHoldMs). Re-arm timer while user
     // is still answering; clean up to live agent status once returned.
+    // A call for a brand-new pin cancels any still-pending timer first, so a
+    // fast pre-execute→idle→pre-execute round-trip can't stack two timers.
+    // as a lost `tools/result` would otherwise re-arm forever and pin the
+    // icon to asking indefinitely.
+    const ASK_MAX_REARM = 2;         // re-arm cap while waiting on a result
+    const askWaits = new Map();      // agentId -> consecutive re-arm count
     const scheduleAskCheck = (id) => {
       const prevHandle = askTimers.get(id);
-      if (prevHandle) { try { prevHandle(); } catch (e) {} }
+      if (prevHandle) { try { prevHandle(); } catch (e) {} askTimers.delete(id); }
       const handle = ctx.timer.timeout(() => {
         askTimers.delete(id);
-        if (!asking.has(id)) return;
-        if (!askDone.has(id)) { scheduleAskCheck(id); return; }
+        if (!asking.has(id)) { askWaits.delete(id); return; }
+        if (!askDone.has(id)) {
+          const n = (askWaits.get(id) || 0) + 1;
+          if (n <= ASK_MAX_REARM) { askWaits.set(id, n); scheduleAskCheck(id); return; }
+          // Result never arrived: force-release the pin against live status so
+          // a lost tools/result cannot keep the icon blinking forever.
+          askWaits.delete(id);
+          asking.delete(id);
+          askDone.delete(id);
+          const live = agents.get(id);
+          if (live) setState(id, live.status === "running" ? "running" : "idle");
+          else setState(id, "idle");
+          return;
+        }
+        askWaits.delete(id);
         asking.delete(id);
         askDone.delete(id);
         const live = agents.get(id);
@@ -499,6 +582,7 @@ export default {
         if (id != null) {
           asking.add(id);
           askDone.delete(id);
+          askWaits.delete(id); // fresh pin restarts the re-arm budget
           setState(id, "asking");
           scheduleAskCheck(id);
         }
@@ -542,6 +626,8 @@ export default {
       askDone.delete(id);
       pendingApprovals.delete(id);
       lastSeen.delete(id);
+      askWaits.delete(id);
+      cancelDoneHold(id);
       const t = askTimers.get(id);
       if (t) { try { t(); } catch (e) {} askTimers.delete(id); }
     });
@@ -590,9 +676,16 @@ export default {
       reconcile();
       const order = ["asking", "running", "done", "idle"];
       let best = null;
+      // Non-idle agent count (asking / running / done): the favicon shows this
+      // as a full-frame number block while more than one agent is active.
+      let active = 0;
+      const counted = new Set();
       for (const a of agents.list()) {
         const id = a.id;
         const s = agentStateOf(id);
+        if (s !== "idle") {
+          if (!counted.has(id)) { active++; counted.add(id); }
+        }
         const rank = order.indexOf(s);
         if (rank === -1) continue;
         if (best === null || rank < best.rank) best = { rank, id, state: s };
@@ -600,10 +693,13 @@ export default {
       for (const [id, rec] of states) {
         if (rec.state === "done") {
           const rank = order.indexOf("done");
+          if (!counted.has(id)) active++; // done-hold agents not yet live-non-idle
           if (best === null || rank < best.rank) best = { rank, id, state: "done" };
         }
       }
-      return best ? { state: best.state, since: (states.get(best.id) || {}).since || Date.now() } : { state: "idle", since: Date.now() };
+      return best
+        ? { state: best.state, since: (states.get(best.id) || {}).since || Date.now(), active }
+        : { state: "idle", since: Date.now(), active };
     };
 
     // -- Routes --------------------------------------------------------------

package/lib/types/index.d.ts

@@ -77,6 +77,14 @@ export interface DshWebIconIndicatorAggregate {
   state: DshWebIconStateName;
   /** Epoch millis when that aggregate state was first entered. */
   since: number;
+  /**
+   * Number of non-idle agents (asking / running / done). While it is > 1 the
+   * favicon shows this count as a full-frame number block (in the aggregate
+   * state's color/effect) instead of the whale; with 0–1 active agents the
+   * whale is drawn. Echoed by the status endpoint. Added in 0.3.x; older
+   * browser bundles ignore it.
+   */
+  active: number;
   /**
    * Current per-state visual config, echoed by the status endpoint so the
    * injected browser script can apply a settings save within ~1 s (no tab

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-web-icon-indicator",
   "description": "Browser tab favicon reflects the DSH session state: idle / running / asking / done, recolored and animated from one base SVG in the browser (fully configurable colors + effects). · 浏览器标签页 favicon 实时反映 DSH 会话状态：待机 / 运行中 / 提问 / 完成，由单个 base.svg 在浏览器中动态上色与动画（颜色与特效完全可配置）。",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
@@ -30,8 +30,8 @@
     }
   },
   "peerDependencies": {
-    "@deepseek-ai/schemastery": "^3.18.0",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.7"
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.7",
+    "@deepseek-ai/schemastery": "^3.18.0"
   },
   "exports": {
     ".": {
@@ -52,6 +52,7 @@
     "assets",
     "docs",
     "cordis.patch.yml",
+    "CHANGELOG.md",
     "README.md",
     "README.zh.md",
     "LICENSE"
@@ -64,5 +65,16 @@
     "favicon",
     "icon-indicator",
     "browser-tab"
-  ]
-}
+  ],
+  "scripts": {
+    "test": "node test/verify.js",
+    "release": "commit-and-tag-version",
+    "release:patch": "commit-and-tag-version --release-as patch",
+    "release:minor": "commit-and-tag-version --release-as minor",
+    "release:major": "commit-and-tag-version --release-as major",
+    "release:dry": "commit-and-tag-version --dry-run"
+  },
+  "devDependencies": {
+    "commit-and-tag-version": "^13.1.2"
+  }
+}