dsh-desktop-statusbar 2.1.1 → 2.1.2

package/lib/client.js

@@ -50,6 +50,8 @@ window.__ModuleLoader__.load({
 		const PRICES_URL = "/dsh-desktop-statusbar/api/prices";
 		const HOLIDAYS_URL = "/dsh-desktop-statusbar/api/holidays";
 		const VERSION_URL = "/dsh-desktop-statusbar/api/version";
+		/** 一键更新：由本插件自己的 host 端执行（不依赖任何别的插件，见 self-update 说明）。 */
+		const SELF_UPDATE_URL = "/dsh-desktop-statusbar/api/self-update";
 		/* 子智能体（Agent Teams 的队友）用量的聚合端点：队友是**独立会话**，它的消耗不在本会话
 		   的投影里，只能由 host 按 parentSession 找出来，「总计」「本轮」才真的把队友算进去。
 		   带 since（毫秒）= 只要那个时刻之后的用量，客户端拿它取「本轮」这一段。 */
@@ -66,7 +68,7 @@ window.__ModuleLoader__.load({
 		 */
 		const CONFIG_VERSION = 6;
 		/** 插件版本：显示在设置页底部，用来确认页面加载的是哪一版客户端代码。 */
-		const VERSION = "2.1.1";
+		const VERSION = "2.1.2";
 		/** 官方参考价的版本：官方调价时改这个数字，老价格库会自动并入新参考价。 */
 		const PRICE_VERSION = 2;
 		/** 项目主页：设置页那个「去 GitHub 点 star」按钮跳这里（与 package.json 的 repository 同址）。 */
@@ -650,6 +652,21 @@ window.__ModuleLoader__.load({
 				+ (bucket.output || 0) * tier.output) / 1e6;
 		}
 
+		/**
+		 * 按**指定档位**算一段用量的费用（不按时刻判断）。返回未舍入数值；没单价返回 null。
+		 * 专供 host 回传的 overflow 用 —— 那部分已经按档归好类（host 侧判的峰谷），
+		 * 这里不能再拿一个时刻去猜档位。没勾「峰谷计价」的条目两档同价，取 peak 即可。
+		 */
+		function costOfTier(bucket, model, peak) {
+			const price = priceOf(model);
+			if (price === null || bucket === undefined || bucket === null) return null;
+			const tier = price.tiered === false ? price.peak : (peak === true ? price.peak : price.offPeak);
+			return ((bucket.input || 0) * tier.input
+				+ (bucket.cacheRead || 0) * tier.cacheRead
+				+ (bucket.cacheWrite || 0) * tier.cacheWrite
+				+ (bucket.output || 0) * tier.output) / 1e6;
+		}
+
 		/**
 		 * 费用显示：一律两位小数，不满一分钱也进到 0.01（0.0075 → 0.01），不出现更长的小数位。
 		 * 累加用 costOf 的原始值，只在这里做一次舍入。
@@ -984,6 +1001,11 @@ window.__ModuleLoader__.load({
 			updateTo: "更新 {version} 版本",
 			updateRunning: "正在更新中",
 			updateFailed: "更新失败",
+			updateDone: "更新成功，重启 DSH 后生效",
+			/* 开发模式：连点版本号 5 次进入。不做成可见控件 —— 它面向作者调试，
+			   普通用户装了插件也不该看到一个「预览」勾选框。进入后标题右侧挂一枚胶囊。 */
+			devModeBadge: "开发模式",
+			devModeHint: "开发模式：点更新按钮只演示状态，不会真的安装",
 			sectionTitle: "状态栏设置",
 			intro: "接管对话区底部的统计行。勾选要显示的字段、拖动调整顺序或配置模型费用单价。",
 			segContext: "上下文占用",
@@ -1095,6 +1117,9 @@ window.__ModuleLoader__.load({
 			updateTo: "Update to {version}",
 			updateRunning: "Updating",
 			updateFailed: "Update failed",
+			updateDone: "Update succeeded — restart DSH to apply",
+			devModeBadge: "Dev mode",
+			devModeHint: "Dev mode: the update button only simulates states — nothing is installed",
 			sectionTitle: "Status Bar Settings",
 			intro: "Replaces the stats line under the message input. Select the fields to show, drag to reorder, or set model prices.",
 			segContext: "Context usage",
@@ -1875,7 +1900,16 @@ window.__ModuleLoader__.load({
 			tool: "var(--dsw-static-blue-450)"
 		};
 
-		/** 本地日期键，用来认「今天」那根柱子。 */
+		/**
+		 * 日期键（YYYY-MM-DD），用来认「今天」那根柱子。
+		 *
+		 * 按**装机者所在时区**取，与 host 的 localDateKey 同一口径：使用者看的是自己
+		 * 日历上的今天/昨天。曾经固定用北京时间，UTC+8 装机时看不出差别，非 UTC+8 的
+		 * 机器上整块活跃总览会错一天（「今天」高亮成昨天、未来/过去的灰阶也偏）。
+		 *
+		 * 注意与 isPeakTime 区分：**峰谷计价**仍按北京时间，那是 DeepSeek 的官方规则；
+		 * 只有「日期归属」跟着装机者时区走。
+		 */
 		function dateKeyOf(ms) {
 			const d = new Date(ms === undefined || ms === null ? Date.now() : ms);
 			const pad = (n) => (n < 10 ? "0" + n : String(n));
@@ -2128,7 +2162,6 @@ window.__ModuleLoader__.load({
 				const hasPeak = pkHit + pkMiss + pkOut > 0;
 				return h("span", {
 					className: "dsb-day"
-						+ (day.date === tip.today ? " dsb-day-today" : "")
 						+ (activeBar === index ? " dsb-day-active" : ""),
 					key: "__wd" + index,
 					/* 悬停整列都让判定区变灰 —— 没有用量的天也一样；浮层只在有用量时弹 */
@@ -2817,6 +2850,27 @@ window.__ModuleLoader__.load({
 					priced = true;
 					total += toDisplayCurrency(one, src.models, callModel, symbolCurrency, src.defaultCurrency);
 				}
+				/* 被 host 的 MAX_CALLS 截掉的那部分（host 按「模型 + 峰谷档」累计好给回来）。
+				   不补这一段的话，长会话的费用只算了最近 4000 条 —— 实测 5000 次少 20%、
+				   2 万次少 80%，而「总计用量」用的是官方全量数据，两者会在同一个界面上对不上。
+				   档位由 host 按北京时间判定（与逐条计价同一套规则），所以这里直接按档取价即可。 */
+				const overflow = sessionUsage === undefined || sessionUsage === null
+					|| sessionUsage.overflow === undefined || sessionUsage.overflow === null
+					|| typeof sessionUsage.overflow !== "object"
+					? {}
+					: sessionUsage.overflow;
+				const overflowNames = Object.keys(overflow);
+				for (let i = 0; i < overflowNames.length; i += 1) {
+					const overflowModel = overflowNames[i];
+					const byTier = overflow[overflowModel];
+					if (byTier === undefined || byTier === null) continue;
+					const peakCost = costOfTier(byTier.peak, overflowModel, true);
+					const offPeakCost = costOfTier(byTier.offPeak, overflowModel, false);
+					if (peakCost === null && offPeakCost === null) continue;
+					priced = true;
+					total += toDisplayCurrency((peakCost === null ? 0 : peakCost) + (offPeakCost === null ? 0 : offPeakCost),
+						src.models, overflowModel, symbolCurrency, src.defaultCurrency);
+				}
 				/* 队友（子智能体）是**独立会话**，它的用量不在上面这份本会话调用表里，
 				   host 按 parentSession 算好单独给回来；这里直接把数字并进「总计」，
 				   不另开一行也不加任何提示字 —— 用户报的正是"总计没算队友"。
@@ -3086,8 +3140,9 @@ window.__ModuleLoader__.load({
 			 * 两条不依赖官方构建 hash 的要点：
 			 *   1. 用 .dsb-root 认自己，而不是官方组件的类名（hash 会随 DSH 更新变，2.0.10 踩过）；
 			 *   2. 自己带标记与“后代里带标记”都要判 —— :has() 只看后代，漏掉前者会把自己的行也藏掉。
-			 * 整条规则挂在 html.dsb-on 上：设置页取消勾选「启用状态栏」后这个类会被摘掉，
-			 * 官方原本的统计行与上下文按钮随即恢复（不然关掉插件只剩一片空白）。 */
+			 * 整条规则挂在 html.dsb-on 上：这个类由插件挂载/卸载时增删（设置页里
+			 * **没有**「启用状态栏」开关，别按那个理解）。卸下后官方原本的统计行与
+			 * 上下文按钮随即恢复（否则关掉插件只剩一片空白）。 */
 			'html.dsb-on [data-slot="conversation.composer.dock"] > *:not(.dsb-root):not(:has(.dsb-root)){display:none !important}',
 			/* 官方新版在输入卡片下方右侧另有一个上下文占用按钮：已被本插件的圆环接管，藏掉它。
 			 * 用 aria-label 认它（中文含"上下文"、英文含"context used"，随语言变），不碰官方 hash 类名。 */
@@ -3371,6 +3426,20 @@ window.__ModuleLoader__.load({
 			".dsb-settings .dsb-star-wrap:hover .dsb-star-tip,.dsb-settings .dsb-star-wrap:focus-within .dsb-star-tip{visibility:visible;opacity:1}",
 			/* 导航项后面的「发现新版本」胶囊：细描边圆角胶囊 + 次级文字色，字号刻意比导航文字小一档 */
 			".dsb-nav-pill{box-sizing:border-box;margin-left:4px;padding:0 5px;border:1px solid var(--dsw-alias-separator-primary,rgba(127,127,127,.3));border-radius:999px;font-size:8px;line-height:1.4;font-weight:400;color:var(--dsw-alias-label-secondary);white-space:nowrap}",
+			/* 开发模式**不给可见开关**：入口是页脚版本号的「连点 5 次」。
+			   胶囊做成标题的上标角标（像 x² 的那个 2）：
+			     · 行内 flex + 靠左对齐 → 胶囊紧跟着标题文字，不甩到面板最右；
+			     · align-items:flex-start → 胶囊浮在标题文字的右上角，而不是垂直居中。
+			   三个刻意的取值：
+			     · font-size 与「发现新版本」那枚导航胶囊**逐字一致**（都走 .dsb-nav-pill 的 8px），
+			       所以这里不覆盖字号 —— 覆盖过一次（10px）就显得比导航那枚大，两处观感不统一。
+			     · **不做负 margin-top**：父级 .dsb-head 是纵向 flex，把胶囊往上顶出容器会被裁掉
+			       （实测缺陷：胶囊上边框被切）。
+			     · 用 `margin-top:2px` **往下压一点**：标题是 18px、行盒有约 2px 的行距余量，
+			       胶囊要落在这段余量里，顶端才不高于标题文字的上边界。 */
+			".dsb-settings .dsb-titlerow{display:flex;align-items:flex-start;justify-content:flex-start;gap:4px}",
+			".dsb-settings .dsb-dev-pill{margin-left:0;margin-top:2px;padding:0 5px;cursor:default}",
+			".dsb-settings .dsb-version{user-select:none;-webkit-user-select:none}",
 		].join("");
 
 		/* 导航图标使用外部传入的 gauge（24x24 lucide，stroke=currentColor，随主题变色） */
@@ -3383,15 +3452,39 @@ window.__ModuleLoader__.load({
 		/* 导航项里挂「发现新版本」胶囊用：标记本插件那一项，避免胶囊文字混进文案后匹配不上。 */
 		const NAV_MARK = "data-dsb-nav";
 
-		/* 宿主上下文（apply 时存下来）：一键更新要用它的 remote 命名空间。 */
-		let pluginCtx = null;
-
 		/**
 		 * 版本自检结果 —— 导航胶囊和设置页那颗「更新」按钮共用这一份，两边同进同出。
 		 * 默认什么都没有：只有 registry 上确实更新才显示，查不到就安静地不显示。
-		 * note 是更新动作的结果：null / "done" / "failed" / "no-manager"。
+		 * note 是更新动作的结果：null / "done" / "failed"。
 		 */
 		let updateState = { hasUpdate: false, latest: null, busy: false, note: null, reason: null };
+
+		/**
+		 * 开发模式（连点版本号 5 次进入）：让作者在没有新版本的时候也能看到更新按钮的
+		 * **全部**状态与动效，用来检查「点下去有没有反馈、文案看不看得懂、失败会不会静默」。
+		 *
+		 * 打开后：
+		 *   - 按钮**常驻**显示（不看 registry 有没有新版），版本号用一个假的演示版本；
+		 *   - 每点一次，依次演示「更新中 → 已更新 → 更新失败 → 回到空闲」四种状态；
+		 *   - **绝不发安装请求**：走的是纯本地的状态机，不碰任何网络与子进程。
+		 *
+		 * 为什么不给一个可见的开关：普通用户装了这插件，界面上不该多出一个面向作者的调试项。
+		 * 入口做成「连点版本号 5 次」——记得住、够隐蔽，也不会被误触（这是常见的开发者模式手势）。
+		 * 进入后标题右侧挂一枚「开发模式」胶囊，明确告诉你当前处于这个状态；再连点 5 次退出。
+		 *
+		 * 它只影响本插件的界面，不改变任何真实配置；退出即恢复原样。
+		 */
+		let devMode = false;
+		/** 演示用的假版本号：一眼看出不是真版本，避免被误当成真实更新。 */
+		const DEV_VERSION = "9.9.9";
+		/** 演示用的假失败原因，走的就是真实失败时那条显示路径。 */
+		const DEV_FAIL_REASON = "release-age";
+		/** 「更新中」演示的时长：够看清三个点的动效，又不至于让人等。 */
+		const DEV_BUSY_MS = 2200;
+		/** 进入/退出开发模式需要连点几次版本号。 */
+		const DEV_CLICKS = 5;
+		/** 连点计数：两次点击间隔超过这个毫秒数就重新计数（否则慢慢点 5 次也会进去）。 */
+		const DEV_CLICK_WINDOW_MS = 1500;
 		const updateListeners = new Set();
 		function subscribeUpdate(fn) {
 			updateListeners.add(fn);
@@ -3413,7 +3506,13 @@ window.__ModuleLoader__.load({
 				if (has !== null && typeof has.remove === "function") has.remove();
 				return;
 			}
-			if (has !== null) { has.textContent = text; return; }
+			/* 已经挂上就只更新文字。**必须先比值**：写 textContent 即使内容一样也会
+			   替换文本节点、产生 childList 记录，而上面那个 observer 监听的正是
+			   childList+subtree —— 不比较就会「写 → 触发 → 下一帧再写」一直空转。 */
+			if (has !== null) {
+				if (has.textContent !== text) has.textContent = text;
+				return;
+			}
 			const pill = document.createElement("span");
 			pill.className = "dsb-nav-pill";
 			pill.textContent = text;
@@ -3436,38 +3535,144 @@ window.__ModuleLoader__.load({
 				.catch(() => null);
 		}
 
-		/** 从安装结果里抠出失败原因；拿不到就给空串。 */
+		/** 从更新结果里抠出人能看懂的原因；拿不到就给空串。 */
 		function reasonOf(result) {
 			const raw = result === null || result === undefined ? null : result.reason;
 			return typeof raw === "string" && raw.length > 0 ? raw : "";
 		}
 
 		/**
-		 * 一键更新：调 DSH 官方的插件安装接口（和插件管理页同一条路，内部跑 pnpm）。
-		 * 装完由 DSH 自己接管生效；客户端这半边是旧代码，得刷新页面才是新的。
+		 * 一键更新：调**本插件自己的** host 路由，由它自己跑 pnpm 把新版本装上。
+		 *
+		 * 为什么不用 DSH 官方的 `ctx.remote.pluginManager.installBundle`：
+		 *   1. 那个服务由「插件管理器」这个**别的插件**提供。没装它的 profile 上，
+		 *      读 `ctx.remote` 会直接抛错（DSH 的依赖注入对未声明服务就这个行为），
+		 *      异常冒出 onClick 没人接 —— 界面表现就是「点了完全没反应」。
+		 *   2. 它跑裸 `pnpm add pkg@版本`，会被 pnpm 11 的 24 小时发布年龄策略拦下
+		 *      （报 NO_MATURE_MATCHING_VERSION），新版本刚发布时装不上。
+		 *
+		 * 所以更新必须由插件自己完成：host 端先把这个精确版本写进 profile 的
+		 * `minimumReleaseAgeExclude` 放行，再用精确版本安装。
+		 *
+		 * **装完要重启 DSH，光刷新页面不生效**：插件包元数据（含 client.js 的 revision）
+		 * 在 DSH 里「缓存至重启」（见 dsh-client-modules 的说明），刷新只会重新拉同一份
+		 * 旧 bundle。官方插件管理器也是这个口径（「已安装，下次启动后加载」）。
+		 * 按钮文案据此提示重启，而不是刷新。
 		 */
 		function startPluginUpdate() {
-			const remote = pluginCtx === null || pluginCtx === undefined ? null : pluginCtx.remote;
-			const manager = remote === null || remote === undefined ? null : remote.pluginManager;
-			/* 官方桌面端一定带插件管理器；真取不到就按失败处理，不另开一个用户看不懂的分支 */
-			if (manager === null || manager === undefined || typeof manager.installBundle !== "function") {
-				setUpdateState({ busy: false, note: "failed", reason: null });
-				return;
-			}
+			/* 开发模式下只演示：不真实安装（见 runDevPreview） */
+			if (devMode === true) { runDevPreview(); return; }
 			if (updateState.latest === null || updateState.busy === true) return;
 			const target = updateState.latest;
 			setUpdateState({ busy: true, note: null, reason: null });
-			Promise.resolve(manager.installBundle(
-				"dsh-desktop-statusbar@" + target,
-				{ requestId: "dsh-desktop-statusbar-" + String(Date.now()) }
-			)).then((result) => {
-				const ok = result !== null && result !== undefined && result.ok === true;
-				setUpdateState({ busy: false, note: ok ? "done" : "failed", reason: ok ? null : reasonOf(result) });
-			}).catch(() => {
-				setUpdateState({ busy: false, note: "failed", reason: null });
-			});
+			window.fetch(SELF_UPDATE_URL, {
+				method: "POST",
+				headers: { "content-type": "application/json" },
+				body: JSON.stringify({ version: target })
+			}).then((response) => (response.ok === true ? response.json() : null))
+				.then((payload) => {
+					/* 响应都解不出来（服务端崩了、被代理拦了）：按失败处理并说清楚 */
+					if (payload === null || payload === undefined) {
+						setUpdateState({ busy: false, note: "failed", reason: "no-response" });
+						return;
+					}
+					const ok = payload.ok === true;
+					setUpdateState({
+						busy: false,
+						note: ok ? "done" : "failed",
+						reason: ok ? null : reasonOf(payload)
+					});
+				})
+				.catch((error) => {
+					setUpdateState({ busy: false, note: "failed", reason: "network" });
+				});
+		}
+
+		/**
+		 * 开发模式下的一次点击：纯本地状态机，走完「更新中 → 已更新 → 更新失败 → 空闲」。
+		 *
+		 * 用真的 setUpdateState / 真的渲染分支，所以看到的动效、文案、按钮禁用行为
+		 * 与真实更新**完全一致**；唯一的区别是不发请求、不安装。
+		 */
+		function runDevPreview() {
+			const phase = updateState.note;
+			if (updateState.busy === true) return;
+			if (phase === null) {
+				/* ① 更新中：亮起那三个点 */
+				setUpdateState({ busy: true, note: null, reason: null, latest: DEV_VERSION });
+				devTimer = setTimeout(() => {
+					devTimer = null;
+					/* ② 已更新 */
+					setUpdateState({ busy: false, note: "done", reason: null });
+				}, DEV_BUSY_MS);
+				return;
+			}
+			if (phase === "done") {
+				/* ③ 更新失败：走真实失败那条显示路径 */
+				setUpdateState({ busy: false, note: "failed", reason: DEV_FAIL_REASON });
+				return;
+			}
+			/* ④ 回到空闲，可以再点一遍 */
+			setUpdateState({ busy: false, note: null, reason: null, latest: DEV_VERSION });
+		}
+
+		/** 开发模式里「更新中」那一步的定时器；退出开发模式或卸载时要清掉。 */
+		let devTimer = null;
+
+		/** 开发模式当前是否开着（给测试与自检读）。 */
+		function isDevMode() {
+			return devMode;
 		}
 
+		/**
+		 * 开关开发模式。
+		 * 打开时把状态摆成「有新版本可更新」的样子（但版本号是假的一眼可辨），
+		 * 关闭时清掉定时器并恢复成「没有更新」。
+		 */
+		function setDevMode(on) {
+			devMode = on === true;
+			if (devTimer !== null) { clearTimeout(devTimer); devTimer = null; }
+			if (devMode === true) {
+				setUpdateState({ hasUpdate: true, latest: DEV_VERSION, busy: false, note: null, reason: null });
+			} else {
+				/* 关掉时**同步**把演示相关状态一次清干净：忙碌态、结论、演示版本、按钮可见性。
+				   这几项都先落到「没有更新」，再去问真实的 registry 结果 —— 反过来（先等网络）
+				   会让按钮在关掉之后还多显示一会儿，看起来像没关掉。
+				   清 busy 尤其必要：演示可能正停在「更新中」，只撤按钮不撤 busy，
+				   界面会留在一个永远转下去的「正在更新中」。 */
+				setUpdateState({ hasUpdate: false, latest: null, busy: false, note: null, reason: null });
+				loadUpdateFlag().then((result) => {
+					if (result !== null) setUpdateState(result);
+				});
+			}
+		}
+
+		/**
+		 * 版本号被点了一下：连点 DEV_CLICKS 次进入（或退出）开发模式。
+		 *
+		 * 为什么用「连点」而不是一个可见开关：普通用户装了这插件，界面上不该多出
+		 * 一个面向作者的调试项。连点是常见的开发者模式手势，记得住、不会被误触。
+		 * 两次点击间隔超过 DEV_CLICK_WINDOW_MS 就重新计数 —— 否则慢慢点 5 次也会进去。
+		 *
+		 * @returns {object} 供测试断言的计数快照
+		 */
+		function onVersionClick() {
+			const now = Date.now();
+			if (devClickAt !== 0 && now - devClickAt > DEV_CLICK_WINDOW_MS) devClickCount = 0;
+			devClickAt = now;
+			devClickCount += 1;
+			if (devClickCount >= DEV_CLICKS) {
+				devClickCount = 0;
+				devClickAt = 0;
+				setDevMode(devMode !== true);
+			}
+			return { count: devClickCount, on: devMode };
+		}
+
+		/** 连点计数与最近一次点击时刻。 */
+		let devClickCount = 0;
+		let devClickAt = 0;
+
 		/**
 		 * 把设置导航里本插件那一项的前导图标换成 gauge。
 		 * 定位方式是按导航文案匹配（DSH 没给导航项留 id 属性），匹配不到就什么都不做。
@@ -3505,10 +3710,13 @@ window.__ModuleLoader__.load({
 			observer.observe(document.body, { childList: true, subtree: true });
 			/* 版本状态一变就重挂一次胶囊：查完发现没新版（撤掉）、或有新版（挂上） */
 			const stopWatch = subscribeUpdate(apply);
-			/* 启动自检一次。卸载之后结果才到的话直接丢弃，别再往 DOM 里塞东西。 */
+			/* 启动自检一次。卸载之后结果才到的话直接丢弃，别再往 DOM 里塞东西。
+			   开发模式期间也要丢弃：它是模块级开关，用户可能在这次网络请求返回前就连点
+			   进去了，此时真实结果会把演示状态冲掉 —— 胶囊还在、按钮却没了。 */
 			let alive = true;
 			loadUpdateFlag().then((result) => {
 				if (alive !== true || result === null) return;
+				if (devMode === true) return;
 				setUpdateState(result);
 			});
 			return () => {
@@ -3546,7 +3754,6 @@ window.__ModuleLoader__.load({
 			const t = props.t;
 			const useProjection = props.useProjection;
 			const useSession = props.useSession;
-			const useSessions = props.useSessions;
 			const sessionId = props.sessionId;
 			const cfg = useConfig();
 
@@ -3596,7 +3803,20 @@ window.__ModuleLoader__.load({
 					method: "POST",
 					headers: { "content-type": "application/json" },
 					body: JSON.stringify({ models: models })
-				}).catch(() => { /* 上报失败不影响底栏 */ });
+				}).then((response) => {
+					/* 失败要说出来。原先只有 `.catch(() => {})`，而 fetch 对 4xx/5xx 是
+					   **resolve** 不是 reject —— 上报被拒（如体积超限返回 400）时既不进
+					   catch 也没人看 response，于是用户的价目表一直送不到 host。
+					   后果分两种：**新产生**的用量会按内置官方价计费（不是用户填的价）；
+					   只在自定义表里的模型则永远算不出钱、一直留在欠费明细里。
+					   已算好的费用不受影响，也不会被改写 —— 那是既定语义。
+					   底栏本身不受影响，所以只告警、不改界面。 */
+					if (response.ok !== true) {
+						console.warn("[dsh-desktop-statusbar] 价格库上报被拒 HTTP " + String(response.status) + "，host 会继续用内置参考价给新用量记账");
+					}
+				}).catch((error) => {
+					console.warn("[dsh-desktop-statusbar] 价格库上报失败：" + String(error && error.message));
+				});
 			}, [reportedPrices]);
 
 			const running = pick(useSession, (s) => s.running, undefined);
@@ -3618,7 +3838,7 @@ window.__ModuleLoader__.load({
 			/* 「本轮」显示值的粘性下限盒子（同轮内只增不减，换轮作废）：一个可变盒子，
 			   由 lastCost 段在渲染时更新，跨渲染靠这个 ref 留住（见 applyTurnFloor）。 */
 			const lastCostHoldRef = react.useRef({ sessionId: null, turnKey: null, value: 0 });
-			/* 点开「总计」气泡时 +1：强制重拉一次队友用量（别的触发条件都带 3 秒节流） */
+			/* 点开「总计」气泡时 +1：强制重拉一次队友用量（别的触发条件都带 SUBAGENT_REFRESH_MS 节流） */
 			const [subagentTick, setSubagentTick] = react.useState(0);
 			const [tipId, setTipId] = react.useState(null);
 			const [tipPos, setTipPos] = react.useState(null);
@@ -4141,7 +4361,8 @@ window.__ModuleLoader__.load({
 				/* 点开余额 / 峰谷用量：顺手重查一次（收起那一下不查），数据回来气泡自己更新 */
 				if (id === "balance" && balanceReloadRef.current !== null) balanceReloadRef.current();
 				if (id === "status" && dailyReloadRef.current !== null) dailyReloadRef.current();
-				/* 总计：队友的数字也要重取一次 —— 3 秒节流靠的是那条每秒时钟，而会话完全空闲时
+				/* 总计：队友的数字也要重取一次 —— 节流靠的是那条每秒时钟（SUBAGENT_REFRESH_MS），
+			   而会话完全空闲时
 				   它不跳（睡到下一个峰谷边界），光靠它会让数字停在旧值 */
 				if (id === "cost" && subagentReloadRef.current !== null) subagentReloadRef.current();
 				const target = event !== undefined && event !== null ? event.currentTarget : null;
@@ -4259,6 +4480,26 @@ window.__ModuleLoader__.load({
 			const t = props.t;
 			const cfg = useConfig();
 			const update = useUpdateState();
+			/* 开发模式是本组件内的界面状态；它不写配置、不动真实更新。
+			   **不给它可见开关**：入口是页脚版本号的「连点 5 次」（见 onVersionClick）。
+			   进入后标题右侧挂一枚「开发模式」胶囊，这是唯一的可见迹象。 */
+			const [devOn, setDevOn] = react.useState(false);
+			/* 版本号被点击：累计连点次数，够 5 次就切换开发模式。
+			   计数与时间窗在模块级（onVersionClick），这里只负责把结果同步给 React。 */
+			const onVersionClicked = () => {
+				const state = onVersionClick();
+				setDevOn(state.on === true);
+			};
+			/* 卸载时清掉演示的定时器，并把开发模式**一并关掉**。
+			   只清定时器是不够的：devMode 是模块级变量，而 devOn 是本组件的 useState。
+			   卸载后重挂时 devOn 回到 false，devMode 若还是 true，两者就不同步了 ——
+			   界面看不见「开发模式」胶囊，更新按钮却仍显示演示版本号，点下去走
+			   startPluginUpdate 的 devMode 分支只播演示、不安装也不报错，用户无从判断。
+			   只在**真的开着**时才复位：setDevMode(false) 会顺手重查一次 registry，
+			   没开还调用等于每次卸载白打一次网络请求，并且会把已有的真实更新提示清掉。 */
+			react.useEffect(() => () => {
+				if (devMode === true) setDevMode(false);
+			}, []);
 
 			/* 自绘拖拽：全程用 pointer 事件自己跟手。不用原生 HTML5 拖拽 ——
 			   原生拖拽会话期间浏览器不给页面 wheel 事件（滚轮失灵），而且只有松手才换位。 */
@@ -4566,7 +4807,15 @@ window.__ModuleLoader__.load({
 			const sections = [];
 
 			sections.push(h("div", { className: "dsb-head", key: "__head" }, [
-				h("h2", { className: "dsb-pagetitle" }, t("sectionTitle")),
+				/* 标题那一行：开发模式开着时，标题文字右上角跟一枚胶囊 —— 像 x² 的上标那样
+				   紧贴着标题，而不是甩到面板最右边（那样看不出是「这个标题的」标记）。
+				   关着时这一行与原来**完全一样** —— 不多任何元素。 */
+				h("div", { className: "dsb-titlerow", key: "__titlerow" },
+					h("h2", { className: "dsb-pagetitle" }, t("sectionTitle")),
+					devOn === true
+						? h("span", { className: "dsb-nav-pill dsb-dev-pill", key: "__devpill", title: t("devModeHint") }, t("devModeBadge"))
+						: null
+				),
 				h("p", { className: "dsb-intro" }, t("intro"))
 			]));
 
@@ -4994,9 +5243,17 @@ window.__ModuleLoader__.load({
 						type: "button",
 						className: "dsb-action",
 						key: "__star",
-						/* window.open 会被主窗口的 setWindowOpenHandler 接住，转 shell.openExternal → 默认浏览器；
+						/* 点完**主动松开焦点**再跳转。气泡的显示条件是 `:hover` 或 `:focus-within`；
+						   点击会让按钮获得 DOM 焦点，而跳去浏览器只让**窗口**失焦、DOM 焦点还留在按钮上 ——
+						   于是 `:focus-within` 一直为真，用户关掉浏览器回来时气泡就卡住常显（实测缺陷）。
+						   blur 掉之后气泡回到只跟鼠标悬停走，行为才符合预期。
+						   window.open 会被主窗口的 setWindowOpenHandler 接住，转 shell.openExternal → 默认浏览器；
 						   noopener 只是不给新窗口留 window.opener（这里窗口本来就被拒了） */
-						onClick: () => window.open(REPO_URL, "_blank", "noopener")
+						onClick: (event) => {
+							const button = event === null || event === undefined ? null : event.currentTarget;
+							if (button !== null && button !== undefined && typeof button.blur === "function") button.blur();
+							window.open(REPO_URL, "_blank", "noopener");
+						}
 					}, t("starRepo"))
 				]),
 				h("button", {
@@ -5026,10 +5283,20 @@ window.__ModuleLoader__.load({
 						});
 					}
 				}, t("reset")),
-				/* 有新版才出现：与导航胶囊同一个来源（updateState），点它走 DSH 官方的插件安装接口。
-				   三种状态都写在按钮自己身上：空闲报版本号、更新中带动效点、失败就说「更新失败」；
-				   装完直接撤掉 —— 末尾的版本号尾标会变成新版本，不必再多一句提示。 */
-				update.hasUpdate === true && update.note !== "done"
+				/* 有新版才出现：与导航胶囊同一个来源（updateState）。
+				   点它由本插件自己的 host 端执行更新（不依赖插件管理器，也不吃 pnpm 的
+				   24 小时发布年龄限制）。三种状态都写在按钮自己身上：空闲报版本号、
+				   更新中带动效点、失败就说「更新失败」。
+
+				   **装完必须重启 DSH，刷新页面没有用** —— 这不是保守说法，是 DSH 的设计：
+				     · `@deepseek-ai/dsh-hmr` 的已知限制原文：「通过插件管理器替换已安装包版本
+				       仍需要重启。浏览器 Client 模块图保留独立的浏览器侧加载机制。」
+				     · `dsh-client-modules` 的包元数据（含 client.js 的 revision）
+				       「缓存至重启」，所以刷新只会重新拉同一份旧 bundle。
+				     · 官方插件管理器的文案也是同一口径：「已安装，下次启动后加载。」
+				   桌面宿主只提供退出能力、没有自我重启能力（`app.relaunch()` 只在开发模式
+				   的菜单里），所以这里只如实提示，不假装能替用户重启。 */
+				update.hasUpdate === true
 					? h("button", {
 						type: "button",
 						className: "dsb-action",
@@ -5042,12 +5309,25 @@ window.__ModuleLoader__.load({
 							h("span", { key: "__d2" }, "."),
 							h("span", { key: "__d3" }, ".")
 						])]
-						: (update.note === "failed"
-							? t("updateFailed")
-							: t("updateTo", { version: update.latest === null ? "" : update.latest })))
+						: (update.note === "done"
+							? t("updateDone")
+							: (update.note === "failed"
+								? t("updateFailed")
+								: t("updateTo", { version: update.latest === null ? "" : update.latest }))))
 					: null,
-				/* 版本标记贴右、与行内底边对齐：改了客户端代码要刷新页面才生效，这行字让"跑的是哪版"一眼可见 */
-				h("span", { className: "dsb-version", key: "__version" }, "dsh-desktop-statusbar " + VERSION)
+				/* 版本标记贴右、与行内底边对齐：这行字让「现在跑的是哪一版」一眼可见 ——
+				   注意**光刷新页面看不出差别**：插件包元数据缓存至重启，刷新拿到的还是旧 bundle；
+				   要换版本必须重启 DSH，重启后这行字才会变成新号。
+
+				   它同时是**开发模式的隐藏入口**：连点 5 次进入 / 退出（见 onVersionClick）。
+				   挂在版本号上的原因：这个入口面向作者调试，普通用户的界面里不该多出
+				   任何可见元素；连点是常见手势，记得住又不会被误触。
+				   进入后的可见迹象是标题右侧那枚「开发模式」胶囊，不在这一行。 */
+				h("span", {
+					className: "dsb-version",
+					key: "__version",
+					onClick: onVersionClicked
+				}, "dsh-desktop-statusbar " + VERSION)
 			]));
 
 			return h("div", { className: "dsb-settings" }, sections);
@@ -5062,12 +5342,23 @@ window.__ModuleLoader__.load({
 		exports.__test = {
 			nextSubagentState: nextSubagentState,
 			applyTurnFloor: applyTurnFloor,
-			SUBAGENT_STATE_EMPTY: SUBAGENT_STATE_EMPTY
+			SUBAGENT_STATE_EMPTY: SUBAGENT_STATE_EMPTY,
+			/* 开发模式的驱动入口：测试要能直接触发连点、并读回状态，
+			   不然这段只存在于设置页组件里的逻辑没法离线验证。 */
+			setDevMode: setDevMode,
+			runDevPreview: runDevPreview,
+			isDevMode: isDevMode,
+			onVersionClick: onVersionClick,
+			DEV_VERSION: DEV_VERSION,
+			DEV_FAIL_REASON: DEV_FAIL_REASON,
+			DEV_CLICKS: DEV_CLICKS,
+			DEV_CLICK_WINDOW_MS: DEV_CLICK_WINDOW_MS
 		};
 
 		function apply(ctx) {
-			/* 存下来给「更新」按钮用：它要调 ctx.remote.pluginManager */
-			pluginCtx = ctx;
+			/* 注意：这里**不保存 ctx**。更新走本插件自己的 host 路由
+			   （见 startPluginUpdate 的说明），界面其余部分也不需要宿主上下文 ——
+			   曾经存过一份 `pluginCtx` 只写不读，已删除。 */
 			ctx.effect(installStyles, "dsh-desktop-statusbar: styles");
 			ctx.effect(() => ctx.locale.register(NS, { zh: zh, en: en }), "dsh-desktop-statusbar: locale");
 			ctx.effect(() => installNavIcon(