dsh-life-pack 0.2.7 → 0.3.1

package/dist/client.js

@@ -38,42 +38,48 @@ window.__ModuleLoader__.load({
 				slotId: "ilife:memo",
 				order: 70,
 				title: "备忘录",
-				plugin: "dsh-memo-ilife"
+				plugin: "dsh-memo-ilife",
+				channel: "/ilife-memo"
 			},
 			{
 				skill: "calorie",
 				slotId: "ilife:calorie",
 				order: 75,
 				title: "卡路里",
-				plugin: "dsh-calorie"
+				plugin: "dsh-calorie",
+				channel: "/ilife-calorie"
 			},
 			{
 				skill: "schedule",
 				slotId: "ilife:schedule",
 				order: 80,
-				title: "作息",
-				plugin: "dsh-schedule-ilife"
+				title: "作息管家",
+				plugin: "dsh-schedule-ilife",
+				channel: "/ilife-schedule-ilife"
 			},
 			{
 				skill: "home",
 				slotId: "ilife:home",
 				order: 85,
-				title: "居家",
-				plugin: "dsh-home-ilife"
+				title: "居家管家",
+				plugin: "dsh-home-ilife",
+				channel: "/ilife-home-ilife"
 			},
 			{
 				skill: "chef",
 				slotId: "ilife:chef",
 				order: 90,
-				title: "大厨",
-				plugin: "dsh-chef"
+				title: "私家大厨",
+				plugin: "dsh-chef",
+				channel: "/ilife-chef"
 			},
 			{
 				skill: "bill",
 				slotId: "ilife:cookie",
 				order: 95,
-				title: "记账",
-				plugin: "dsh-bill-ilife"
+				title: "饼干记账",
+				plugin: "dsh-bill-ilife",
+				channel: "/ilife-bill-ilife"
 			}
 		];
 		function recoFor(tab) {
@@ -139,10 +145,17 @@ window.__ModuleLoader__.load({
 		* 一处定义、两边引用（结构纪律「概念唯一」）：名字改了只有这一行要动。
 		* 宿主判据为什么要读这个字面量、以及它的边界，见 `readPanelRegistered` 的头注。 */
 		const CONFIG_TAB_SLOT = "ilife.config-tab";
+		/** 载体基段：`connection.rpc.call` 的**第一段**参数，宿主注册路径与它同源（`'/api' ＋ 通道名`）。
+		*
+		* 一处定义（#735）：总管自己的电话、以及面板到各家的每一通电话，第一段都必须是它。
+		* 真机实现（`dsh-client-connection/lib/client.js`）：URL ＝ `${第一段}/${第二段}`、信封 `method` ＝ 第二段。
+		* 传错第一段就是 404：总管自己的电话在 #678 栽过一次，各家的配置体检在 #735 又栽过一次
+		* （那次传的是通道名 `/ilife-<技能>`，拼出来的地址上没有注册过那条路由，六家全 404）。 */
+		const CARRIER_BASE = "/api";
 		/** 载体：宿主注册 `connection.fetch.register` 的路径 / 面板 `connection.rpc.call` 的两段参数。 */
 		const MANAGER_RPC = {
 			/** 载体基段（`connection.rpc.call` 的**第一段**参数）。传错第一段就是 404：真机上踩过一次。 */
-			base: "/api",
+			base: CARRIER_BASE,
 			/** 单段通道名，须 match `/^\/[A-Za-z0-9._~-]+$/`（cookbook §6）。 */
 			channel: "/ilife-manager",
 			/** 面板侧第二段参数（等于通道名去掉前导斜杠那一段）。 */
@@ -160,41 +173,62 @@ window.__ModuleLoader__.load({
 			* （`update.phoneNames`，`host.ts:335`）；面板侧既不能 import 更新包（浏览器产物纯度门）
 			* 也不该把名字再写一份（写两份必然走散）。宿主把名字表连同版本行一起交出去，
 			* 面板一行字面量都不留。 */
-			targets: "ilife-manager.targets"
+			targets: "ilife-manager.targets",
+			/** 总管自述版本（票 #737）：入参 `{}`，回包 `{version}`。
+			*
+			* 宿主读**自己这份已安装包**的 `package.json`（`manager-version.ts`），面板只渲染读到的值。
+			* 为什么走电话：面板是浏览器产物，禁 node 内建（`test/client-bundle-48.test.mjs` 看门），
+			* 读盘只许在宿主半；与卡路里 #130 同一条路（host 读 → RPC → client 纯渲染）。 */
+			version: "ilife-manager.version"
 		};
-		/** 装不了 / 装不成的人话原因表：八种 `blockedReason` ＋ 过程错误码（更新包 README 第 8、12 节）。 */
+		/** 版本读不到时两侧共用的降级字面量（面板照原样显示，不假装知道版本）。
+		*
+		* 一处定义、两侧引用：宿主半 `manager-version.ts` 读失败时回它，面板半 `update-client.ts`
+		* 归一化时也认它——面板侧不许 import 宿主半（会把 node 内建带进浏览器束）。 */
+		const VERSION_UNKNOWN = "unknown";
+		/** 装不了 / 装不成的人话原因表：八种 `blockedReason` ＋ 过程错误码（更新包 README 第 8、12 节）。
+		*
+		* 每条都要三段齐全（票 #740 的文案判据）：**事实**（哪里对不上）→ **后果**（这家现在能不能装）
+		* → **动作**（用户做得到、且面板上真有的那一步；面板代劳不了的走「下面这条命令」）。
+		* 禁用口语与自造词：「半截任务」「电话没接上」「回执异常」「还出现就重装」「查宿主日志」一律不写。
+		*
+		* 点名的按钮必须是**这一行上真够得着**的那颗（票 #740 第三轮）：结果浮层一开就盖住题头的
+		* 「检查更新」，所以「改完再读一次」这类下一步一律写「重新检查」（画在那一行上）；
+		* 只有发生在**重启之后**的下一步才写「检查更新」。反过来，凡是写着「下面这条命令」的那几句，
+		* 那一行的命令块必须真出来（判据 `Verdict.manualHint`）——两处都由门禁守着。 */
 		const REASON_TEXT = {
-			"unknown-profile": "使用范围认不出（名字非法或目录不存在）：先检查使用范围名与目录，这种情形不给手工命令。",
-			"source-install": "当前是从源码装的，不是按版本号装的：想走更新，先按版本号重装一次。",
-			"invalid-installation": "已装的包不完整（名字对不上、版本非法、入口文件缺失）：重装当前版本，修好已装目录再查。",
-			"installation-changed": "安装位置在使用中途变了：重新打开宿主再查一次；还出现就重装。",
-			"pending-restart": "新版已装到磁盘，正在跑的还是旧版：重启宿主后生效。",
-			"registry-conflict": "本地声明的版本与磁盘实际版本互相矛盾：打开使用范围的清单，把目标包名那行改成版本号再试。",
-			"incompatible-node": "新版要求的 Node 与当前运行的 Node 对不上：先把 Node 升到 22 或更高，再查。",
-			"recovery-required": "上次安装被打断，留下一个半截任务：重新点一次安装；一直出现就查宿主日志。",
-			"check-failed": "查新版失败（联网不通或官方源不可达）：检查网络与官方源地址，再查一次。",
-			"invalid-release": "远端发行信息不合规（名字对不上、版本非法、包地址或完整性校验不过）：换个版本再查。",
-			"check-expired": "上次查新版的凭证过期了：重新查一次再点安装（不要重试旧编号）。",
-			"update-busy": "同一个使用范围同时只装一个：等当前任务结束再点。",
-			"install-failed": "安装没跑成：按下面那条手工命令在终端执行一次。",
-			"manager-unreachable": "总管的电话没接上（宿主半没注册或版本对不上）：重启宿主后再试；仍不行看宿主日志。",
-			"bad-request": "回执异常（请求形状不对）：把宿主日志里的事件名报给作者。",
-			internal: "回执异常（总管内部错误）：把宿主日志里的事件名报给作者。"
+			"unknown-profile": "认不出这台机器上的安装位置（使用范围的目录不存在，或名字不合法）。把使用范围目录建好，再点「重新检查」。",
+			"source-install": "这一份不是从 npm 发行包装的（源码装），面板不能更新它。要更新，照下面这条命令重装，装完再点「重新检查」。",
+			"invalid-installation": "磁盘上这一份装得不完整（包名或版本对不上、入口文件缺失）。照下面这条命令重装，装完再点「重新检查」。",
+			"installation-changed": "这台机器的安装清单变了（在别处装过、或清单被手工改过），这一家现在不能装。点「重新检查」重新读一次，再点「装上更新」。",
+			"pending-restart": "新版已装到磁盘，正在运行的是旧版本。重启 DSH（退出后重新打开）后生效。",
+			"registry-conflict": "使用范围清单里写的版本与磁盘上的实际版本对不上。打开使用范围的 `package.json`，把这一行改成磁盘上的版本号，再点「重新检查」。",
+			"incompatible-node": "新版本要求 Node 22 或更高，当前运行的是更低版本。升级 Node、重启 DSH 后，再点「检查更新」。",
+			"recovery-required": "上次安装没有收尾。点「重试安装」再跑一次；还出现这一条，就用下面这条命令重装。",
+			"check-failed": "查不到最新版本：联网失败，或官方源（registry.npmjs.org）不可达。确认网络与源地址后，再点「重新检查」。",
+			"invalid-release": "官方源上这个版本的元数据不完整（包名或版本不合法、包地址或校验值缺失）。换一个版本，或稍后重试。",
+			"check-expired": "上次检查的结果已过期。点「重新检查」重查一次，再点「装上更新」。",
+			"update-busy": "同一时间只能安装一个插件。等这次装完，再点「装上更新」。",
+			"install-failed": "安装没有完成。在终端里执行下面这条命令把它装完，装完再点「重新检查」。",
+			"manager-unreachable": "面板连不上总管插件（宿主里没注册，或版本对不上）。重启 DSH 后重试；仍不行就在 DSH 日志里找 `[dsh-life-pack]` 的报错。",
+			"bad-request": "面板与总管之间的请求出错了（属程序缺陷）。请在 DSH 日志里找 `[dsh-life-pack]` 的报错，连同这家插件的名字报到本仓 issue。",
+			internal: "面板与总管之间的请求出错了（属程序缺陷）。请在 DSH 日志里找 `[dsh-life-pack]` 的报错，连同这家插件的名字报到本仓 issue。"
 		};
 		/** 原因码 → 人话（认不出的码不猜、原样回码并说明这是未知原因）。 */
 		function reasonText(code) {
-			return REASON_TEXT[code] ?? "未知原因（" + code + "）：把宿主日志里的事件名报给作者。";
+			return REASON_TEXT[code] ?? "面板不认识这个原因码（" + code + "）。请在 DSH 日志里找同一处报错，报到本仓 issue。";
 		}
 		//#endregion
 		//#region src/update-client.ts
-		/** 面板到宿主的三条流程（纯异步函数：无 DOM、无 react；传输口由调用方注入，便于单测）。
+		/** 面板到宿主的四条流程（纯异步函数：无 DOM、无 react；传输口由调用方注入，便于单测）。
 		*
-		* 三条流程与更新包 README 的对应关系：
+		* 四条流程与更新包 README 的对应关系：
 		* - 检查更新：`updateCheck`（第 3 节第 3 步的 `host.call(UPD_CHECK, {})`）；
 		* - 装上更新：`updateCheck` 拿凭证 → `updateInstall` 提交 → **按间隔轮询 `updateStatus`**
 		*   直到任务离开 `installing`/`verifying`（第 3 节第 3 步与第 9 节：安装是后台跑，
 		*   调用方不干等；凭证过期 `check-expired` 是正常错误码，重查一次再提交，见第 11 节）；
-		* - 装上缺席的包：走总管自有的 `ilife-manager.install`（更新包的三个电话只管已装的包）。
+		* - 装上缺席的包：走总管自有的 `ilife-manager.install`（更新包的三个电话只管已装的包）；
+		* - 总管自述版本：走总管自有的 `ilife-manager.version`（宿主读自己那份包描述文件，见 `manager-version.ts`）。
 		*/
 		/** 轮询上限：1 秒一次、最多 900 次（覆盖更新包 15 分钟的安装时限）。 */
 		const MAX_POLL_TRIES = 900;
@@ -253,6 +287,16 @@ window.__ModuleLoader__.load({
 				}
 			};
 		}
+		/** 取总管自述版本（票 #737）：宿主读**自己这份已安装包**的 `package.json`，面板只渲染读到的值。
+		*
+		* 单次、无轮询；宿主读不到会回 `unknown`，传输层失败也回同一个字面量——面板照原样显示，
+		* 不假装知道版本（与卡路里 #130 的降级口径一致）。 */
+		async function loadManagerVersion(call) {
+			const out = await callManager(call, MANAGER_ACTIONS.version, {});
+			if (!out.ok) return VERSION_UNKNOWN;
+			const raw = out.value?.version;
+			return typeof raw === "string" && raw.trim().length > 0 ? raw.trim() : VERSION_UNKNOWN;
+		}
 		/** 查一家：默认查新版（`updateCheck`，顺带回最新版本与凭证）；给 `phoneName` 时查那个电话。 */
 		async function checkTarget(call, target, phoneName) {
 			const name = phoneName ?? target.phones?.check;
@@ -322,57 +366,136 @@ window.__ModuleLoader__.load({
 			if (target.panelRegistered === false) return "unregistered-product";
 			return "not-connected";
 		}
-		/** 把快照翻成一行结论：还没查 / 已是最新 / 有新版 / 装不了（附人话原因）。 */
+		/** 这一家是不是「装好了、只差重启」——判据是**事实**（磁盘版本 ≠ 正在跑的版本），不是原因码。
+		*
+		* 为什么不许按原因码判（票 #740 真机）：同一种事实在更新核心里可能报成两种码——
+		* `pending-restart`，或者被上一次中断的任务盖成 `recovery-required`。按码判会把「该重启」
+		* 漏成一句「装不上」，用户看到的正是那种读不懂的屏。 */
+		function restartPendingOf(snapshot) {
+			const installed = snapshot.installedVersion;
+			return installed !== null && installed !== snapshot.runningVersion;
+		}
+		/** 待重启那一句（三段齐全：事实 → 后果 → 动作）。
+		*
+		* 措辞不写「新版」：磁盘上那份也可能比正在跑的**低**（手工降级），「新版」就不实了；
+		* 只照事实说「磁盘上装的是 X、正在运行的是 Y」。
+		* 动作只给「重启 DSH」：这一态下面板**做不了别的**——更新包的可装判据要求最新版严格高于
+		* **正在运行**的版本（`service.js:219`），而凭证只发在可装态（`service.js:256`：`receipt` 只在
+		* `canInstall` 时给），所以这一态里「重试安装」点了也是白点。 */
+		function restartLine(snapshot) {
+			const installed = snapshot.installedVersion ?? snapshot.job?.targetVersion ?? "新版本";
+			return "磁盘上装的是 " + String(installed) + "；正在运行的是 " + snapshot.runningVersion + "。重启 DSH（退出后重新打开）后生效。";
+		}
+		/** 「条件在别处（目录／清单／别处装的），改完回来重读一次」的原因码：面板能给的下一步就是「重新检查」。
+		*
+		*  为什么要逐码列（票 #740 第三轮的朗读表）：`unknown-profile`／`registry-conflict`／`invalid-installation`／
+		*  `source-install` 这四态原先一个动作都不给，屏上那句却写着「再点「检查更新」」——那颗按钮住在面板题头，
+		*  结果浮层一开（点「检查更新」就开）就被浮层盖住，够不着。跟两张「还没查过」的卡是同一类病。 */
+		const RECHECK_REASONS = /* @__PURE__ */ new Set([
+			"installation-changed",
+			"unknown-profile",
+			"registry-conflict",
+			"invalid-installation",
+			"source-install"
+		]);
+		/** 「这一步面板代劳不了、得照下面那条命令做」的原因码：这些话下面必须真有命令块。 */
+		const NEEDS_MANUAL = /* @__PURE__ */ new Set([
+			"source-install",
+			"invalid-installation",
+			"recovery-required"
+		]);
+		/** 拦截态各自给得出的下一步：面板能代劳的给按钮，代劳不了的给 null（那种走手工命令块）。 */
+		function actionForBlocked(reason) {
+			if (RECHECK_REASONS.has(reason)) return "recheck";
+			if (reason === "recovery-required") return "retry";
+			return null;
+		}
+		/** 这一行此刻该画哪颗按钮：结论自带的动作优先，**失败的行一律给「重新检查」**（票 #740 第三轮）。
+		*
+		*  失败的行（查不到最新版／检查过期／装失败）没有快照、也就没有结论，原先一颗按钮都不画：
+		*  屏上写着「再点「检查更新」」，那颗按钮却在浮层底下 ⇒ 无路可走。重新查一次对每一种失败都成立。 */
+		function cardActionOf(verdict, phase) {
+			if (verdict?.action) return verdict.action;
+			return phase === "failed" ? "recheck" : null;
+		}
+		/** 装成一家之后，其余各家的读数一律作废（票 #740）：七家共用同一份使用范围清单，
+		*  刚那次安装已经改写了它，旧快照再拿去装必然被守卫拦下。这句话就是那条守卫的人话。 */
+		function staleVerdict() {
+			return {
+				kind: "blocked",
+				text: "刚在本面板装过别的插件，共用的安装清单变了，这一家要先重读一次。点「重新检查」，再点「装上更新」。",
+				action: "recheck"
+			};
+		}
+		/** 把除 `keepKey` 之外的行全标成过期（票 #740）：装成一家 ⇒ 七家共用的安装清单被改写，
+		*  其余各家的旧快照再拿去装必然被守卫拦下。纯函数：状态源与单测共用同一份判据，
+		*  不关心行里还有什么（泛型只要求有 `stale` 这一格）。 */
+		function markStaleOthers(rows, keepKey) {
+			const next = {};
+			for (const [key, row] of Object.entries(rows)) next[key] = key === keepKey ? row : {
+				...row,
+				stale: true
+			};
+			return next;
+		}
+		/** 把快照翻成一行结论：还没查 / 已是最新 / 有新版 / 待重启 / 装不了（附人话原因与下一步）。 */
 		function verdictOf(target, snapshot) {
 			const absent = isAbsent(target);
 			const latest = snapshot.latestVersion;
 			if (absent && latest === null) return {
 				kind: "unknown",
-				text: "未安装；点「检查更新」查最新版本后装上。",
-				action: null
+				text: "未安装。点「重新检查」查最新版本，再点「装上」。",
+				action: "recheck"
 			};
 			if (absent) return {
 				kind: "update-available",
-				text: "未安装；最新版本 " + String(latest) + "。",
+				text: "未安装；最新版本 " + String(latest) + "。点「装上」安装。",
 				action: "install"
 			};
-			if (snapshot.blockedReason !== null) {
+			if (restartPendingOf(snapshot)) return {
+				kind: "blocked",
+				text: restartLine(snapshot),
+				action: null
+			};
+			const installed = snapshot.installedVersion;
+			const hasNewer = latest !== null && latest !== installed;
+			if (snapshot.blockedReason !== null && hasNewer) {
 				const blocked = snapshot.blockedReason;
-				if (blocked === "pending-restart") return {
-					kind: "blocked",
-					text: reasonText(blocked),
-					action: null
-				};
 				return {
 					kind: "blocked",
 					text: reasonText(blocked),
-					action: null
+					action: actionForBlocked(blocked),
+					manualHint: NEEDS_MANUAL.has(blocked)
 				};
 			}
 			if (latest === null) return {
 				kind: "unknown",
-				text: "还没查过最新版本；点「检查更新」。",
-				action: null
+				text: "还没查过最新版本。点「重新检查」。",
+				action: "recheck"
 			};
 			if (snapshot.canInstall) return {
 				kind: "update-available",
-				text: "有新版：" + String(latest) + "，点「装上更新」。",
+				text: "有新版本 " + String(latest) + "（正在运行 " + snapshot.runningVersion + "）。点「装上更新」。",
 				action: "update"
 			};
+			if (hasNewer) return {
+				kind: "update-available",
+				text: "有新版本 " + String(latest) + "（正在运行 " + snapshot.runningVersion + "）。点「重新检查」，再点「装上更新」。",
+				action: "recheck"
+			};
 			return {
 				kind: "up-to-date",
-				text: "已是最新（" + String(latest) + "）。",
+				text: "已是最新版本 " + String(latest) + "。",
 				action: null
 			};
 		}
-		/** 待重启横幅文案（更新包 README 第 10 节：说清新版号与「重启后才生效」两件事）。 */
-		function pendingRestartText(target, snapshot) {
-			if (snapshot.blockedReason !== "pending-restart") return null;
-			const installed = snapshot.installedVersion ?? snapshot.job?.targetVersion ?? null;
-			const running = snapshot.runningVersion;
-			if (installed === null) return "⚠️ 新版已装好，重启宿主后生效。";
-			if (installed === running) return "⚠️ 新版 " + installed + " 已装好，重启宿主后生效。";
-			return "⚠️ 新版 " + installed + " 已装好，正在跑的还是 " + running + "，重启宿主后生效。";
+		/** 待重启横幅：**一行总账**，只点名哪几家要做「重启 DSH」这件事。
+		*
+		*  为什么不再逐家重复那句话（票 #740 对抗式审查第三轮的朗读表逮到）：同一句「重启 DSH…后生效」
+		*  会同时出现在横幅和那家卡片上，一屏两遍。分工定死：**横幅答「谁要重启」，卡片答「为什么、怎么做」**。 */
+		function restartBannerText(titles) {
+			if (titles.length === 0) return null;
+			return "⚠️ 待重启 DSH（退出后重新打开）：" + titles.join("、");
 		}
 		/** 面板展示的那条可复制命令（用户会照着敲的那一条）。
 		*
@@ -657,6 +780,13 @@ window.__ModuleLoader__.load({
 				default: return "idle";
 			}
 		}
+		/** 四个动作在屏上的名字：按钮文案与判据同源（票 #740）。 */
+		const ACTION_LABEL = {
+			install: "装上",
+			update: "装上更新",
+			retry: "重试安装",
+			recheck: "重新检查"
+		};
 		const IDLE$1 = {
 			phase: "idle",
 			outcome: null,
@@ -693,6 +823,10 @@ window.__ModuleLoader__.load({
 					[key]: next
 				}));
 			}, []);
+			/** 装成一家 ⇒ 其余各家的旧快照一律作废（票 #740）：判据见 `markStaleOthers`。 */
+			const staleOthers = react.useCallback((keepKey) => {
+				setRows((previous) => markStaleOthers(previous, keepKey));
+			}, []);
 			return {
 				targets,
 				rows,
@@ -708,18 +842,21 @@ window.__ModuleLoader__.load({
 					for (const target of list) patch(target.key, {
 						phase: "checking",
 						outcome: rows[target.key]?.outcome ?? null,
-						failure: null
+						failure: null,
+						stale: false
 					});
 					Promise.all(list.map(async (target) => {
 						const result = await checkTarget(getCall(), target);
 						patch(target.key, result.ok ? {
 							phase: "ready",
 							outcome: result.value,
-							failure: null
+							failure: null,
+							stale: false
 						} : {
 							phase: "failed",
 							outcome: null,
-							failure: result
+							failure: result,
+							stale: false
 						});
 					})).finally(() => setChecking(false));
 				}, [
@@ -728,12 +865,36 @@ window.__ModuleLoader__.load({
 					rows,
 					targets
 				]),
-				act: react.useCallback((target) => {
+				act: react.useCallback((target, action) => {
 					const current = rows[target.key] ?? IDLE$1;
+					if (action === "recheck") {
+						patch(target.key, {
+							phase: "checking",
+							outcome: current.outcome,
+							failure: null,
+							stale: false
+						});
+						(async () => {
+							const checked = await checkTarget(getCall(), target);
+							patch(target.key, checked.ok ? {
+								phase: "ready",
+								outcome: checked.value,
+								failure: null,
+								stale: false
+							} : {
+								phase: "failed",
+								outcome: null,
+								failure: checked,
+								stale: false
+							});
+						})();
+						return;
+					}
 					patch(target.key, {
 						...current,
 						phase: "installing",
-						failure: null
+						failure: null,
+						stale: false
 					});
 					(async () => {
 						const absent = isAbsent(target);
@@ -744,29 +905,36 @@ window.__ModuleLoader__.load({
 								patch(target.key, {
 									phase: "failed",
 									outcome: null,
-									failure: checked
+									failure: checked,
+									stale: false
 								});
 								return;
 							}
 							patch(target.key, {
 								phase: "installing",
 								outcome: checked.value,
-								failure: null
+								failure: null,
+								stale: false
 							});
 							version = checked.value.snapshot.latestVersion;
 						}
 						const result = absent ? await installAbsent(getCall(), target, version ?? "") : await updateInstalled(getCall(), target, pollMs);
 						if (result.ok) {
+							const before = current.outcome?.snapshot.installedVersion ?? null;
 							const refreshed = await checkTarget(getCall(), target, target.phones?.status);
+							const after = refreshed.ok ? refreshed.value.snapshot.installedVersion ?? null : null;
 							patch(target.key, refreshed.ok ? {
 								phase: "ready",
 								outcome: refreshed.value,
-								failure: null
+								failure: null,
+								stale: false
 							} : {
 								phase: "failed",
 								outcome: null,
-								failure: refreshed
+								failure: refreshed,
+								stale: false
 							});
+							if (after !== null && after !== before) staleOthers(target.key);
 							await reload();
 							return;
 						}
@@ -776,7 +944,8 @@ window.__ModuleLoader__.load({
 							failure: {
 								...result,
 								manual: result.manual ?? current.outcome?.manual ?? null
-							}
+							},
+							stale: false
 						});
 					})();
 				}, [
@@ -784,7 +953,8 @@ window.__ModuleLoader__.load({
 					patch,
 					pollMs,
 					reload,
-					rows
+					rows,
+					staleOthers
 				])
 			};
 		}
@@ -801,20 +971,20 @@ window.__ModuleLoader__.load({
 				} : PANEL_STYLE.btn,
 				disabled,
 				onClick: checkAll,
-				title: "一次查七家（总管自己 ＋ 六个单品）的插件包版本"
+				title: "检查总管与六家插件的版本"
 			}, checking ? "检查中…" : "检查更新");
 		}
-		/** 待重启横幅：任何一家成 `pending-restart` 就常驻显示，重启宿主后自动消失（更新包 README 第 10 节）。 */
+		/** 待重启横幅：一行总账，只点名哪几家要重启（理由与做法写在各家卡片上，见 `restartBannerText`）。 */
 		function RestartBanners(props) {
-			const lines = [];
+			const titles = [];
 			for (const target of props.face.targets) {
 				const outcome = props.face.rows[target.key]?.outcome;
 				if (!outcome) continue;
-				const text = pendingRestartText(target, outcome.snapshot);
-				if (text) lines.push(text);
+				if (restartPendingOf(outcome.snapshot)) titles.push(target.title);
 			}
-			if (lines.length === 0) return null;
-			return react.createElement("div", { style: PANEL_STYLE.banner }, lines.map((line, index) => react.createElement("div", { key: String(index) }, line)));
+			const text = restartBannerText(titles);
+			if (text === null) return null;
+			return react.createElement("div", { style: PANEL_STYLE.banner }, text);
 		}
 		/** 七家结果：装不了的与待重启的常驻（横幅），详细结果放**居中浮层**（点「检查更新」开）。
 		*
@@ -837,10 +1007,11 @@ window.__ModuleLoader__.load({
 			const body = shown.map((target) => {
 				const row = rows[target.key];
 				const snapshot = row.outcome?.snapshot ?? null;
-				const verdict = snapshot ? verdictOf(target, snapshot) : null;
+				const verdict = row.stale === true ? staleVerdict() : snapshot ? verdictOf(target, snapshot) : null;
 				const manual = manualForDisplay(target, row.failure?.manual ?? row.outcome?.manual ?? null);
 				const busy = row.phase === "installing";
-				const showManual = manual !== null && (row.phase === "failed" || verdict?.kind === "blocked");
+				const showManual = manual !== null && (row.phase === "failed" || verdict?.manualHint === true || verdict?.kind === "blocked" && verdict.action === null);
+				const buttonAction = cardActionOf(verdict, row.phase);
 				const tone = rowToneOf(row, verdict);
 				const paint = ROW_TONE[tone];
 				/** 这一行「当前／最新」两个版本号：不等才算有新版，把「最新」那格上色（用户扫一眼先看有没有箭头）。 */
@@ -871,7 +1042,7 @@ window.__ModuleLoader__.load({
 				} : {
 					...PANEL_STYLE.verdictLine,
 					color: "var(--dsw-alias-label-secondary, #9a9a9a)"
-				} }, busy ? "正在装，请稍候…" : verdict?.text ?? (checking ? "检查中…" : "")), verdict?.action ? react.createElement("button", {
+				} }, busy ? "正在装，请稍候…" : verdict?.text ?? (checking ? "检查中…" : "")), buttonAction ? react.createElement("button", {
 					type: "button",
 					style: busy ? {
 						...PANEL_STYLE.btnPrimary,
@@ -879,11 +1050,13 @@ window.__ModuleLoader__.load({
 						cursor: "default"
 					} : PANEL_STYLE.btnPrimary,
 					disabled: busy,
-					onClick: () => props.face.act(target)
-				}, verdict.action === "install" ? "装上" : "装上更新") : null, row.failure ? react.createElement("div", { style: PANEL_STYLE.reason }, "装不上：" + row.failure.message) : null, versionLines(target, snapshot).map((line, index) => react.createElement("div", {
+					onClick: () => {
+						props.face.act(target, buttonAction);
+					}
+				}, ACTION_LABEL[buttonAction]) : null, row.failure ? react.createElement("div", { style: PANEL_STYLE.reason }, "装不上：" + row.failure.message) : null, versionLines(target, snapshot).map((line, index) => react.createElement("div", {
 					key: String(index),
 					style: PANEL_STYLE.skill
-				}, line)), showManual ? react.createElement("code", { style: PANEL_STYLE.cmd }, manual) : null);
+				}, line)), showManual ? react.createElement("div", { style: PANEL_STYLE.skill }, "在终端里执行这条命令可以手动完成这一步：") : null, showManual ? react.createElement("code", { style: PANEL_STYLE.cmd }, manual) : null);
 			});
 			return react.createElement("div", null, react.createElement(RestartBanners, { face: props.face }), open ? react.createElement("div", {
 				style: PANEL_STYLE.overlay,
@@ -905,7 +1078,7 @@ window.__ModuleLoader__.load({
 				onClick: () => close(),
 				title: "关闭",
 				"aria-label": "关闭"
-			}, "×")), react.createElement("div", { style: PANEL_STYLE.dialogBody }, body, react.createElement("div", { style: PANEL_STYLE.dialogNote }, "装与更新都在宿主后台跑：关掉这块不影响正在进行的安装，再点「检查更新」可以看到最新状态。")))) : null);
+			}, "×")), react.createElement("div", { style: PANEL_STYLE.dialogBody }, body, react.createElement("div", { style: PANEL_STYLE.dialogNote }, "安装在宿主后台继续：关掉这块不会中断它。再点「检查更新」看最新进度。")))) : null);
 		}
 		/** 缺席卡：**按两处独立事实分三态**，每态只给能改变状态的动作。
 		*
@@ -926,17 +1099,19 @@ window.__ModuleLoader__.load({
 			const manual = (target ? manualForDisplay(target, row?.failure?.manual ?? row?.outcome?.manual ?? null) : null) ?? props.fallbackCommand;
 			const installed = target ? target.installedVersion ?? target.runningVersion : null;
 			const state = slotStateOf(target, props.inLedger);
+			const blockedVerdict = target && row?.outcome && row.outcome.snapshot.blockedReason !== null ? verdictOf(target, row.outcome.snapshot) : null;
 			let reason = row?.failure?.message ?? null;
-			if (target && reason === null && row?.outcome && row.outcome.snapshot.blockedReason !== null) reason = verdictOf(target, row.outcome.snapshot).text;
+			if (reason === null && blockedVerdict) reason = blockedVerdict.text;
+			const retryAction = row ? cardActionOf(blockedVerdict, row.phase) : null;
 			let headline;
 			switch (state) {
 				case "absent":
 					headline = target ? "未安装[" + target.packageName + "]，装上后这个页签就能用了。" : "这个页签对应的插件还没装。";
 					break;
 				case "unregistered-product":
-					headline = target.packageName + " " + String(installed) + " 装着，但它这一版的产物里没有爱生活页签的注册代码：得等它发一个带注册代码的新版才对得上。重启与重装都不会变（重装只是把同一版再装一次）。";
+					headline = target.packageName + " " + String(installed) + " 已安装，但这一版的插件包里没有「爱生活页签」的注册代码：要等它发布带注册代码的新版本。重启和重装都不会改变这一点。";
 					break;
-				default: headline = target.packageName + " " + String(installed) + " 装着、产物里也有注册代码，但它的设置页没送到浏览器：重启宿主后再看这个页签；仍然这样就去宿主日志里找它的报错。";
+				default: headline = target.packageName + " " + String(installed) + " 已安装，插件包里也有注册代码，但它的设置页没有加载到面板：重启 DSH 后再看这个页签；仍然这样，就在 DSH 日志里找它的报错。";
 			}
 			return react.createElement("div", { style: PANEL_STYLE.reco }, react.createElement("div", null, headline), state === "absent" ? react.createElement("button", {
 				type: "button",
@@ -950,9 +1125,23 @@ window.__ModuleLoader__.load({
 				},
 				disabled: busy,
 				onClick: () => {
-					if (target) props.face.act(target);
+					if (target) props.face.act(target, "install");
 				}
-			}, busy ? "正在装，请稍候…" : "装上") : null, reason ? react.createElement("div", { style: PANEL_STYLE.reason }, reason) : null, react.createElement("code", { style: PANEL_STYLE.cmd }, manual));
+			}, busy ? "正在装，请稍候…" : "装上") : null, retryAction === "recheck" && target ? react.createElement("button", {
+				type: "button",
+				style: busy ? {
+					...PANEL_STYLE.btn,
+					marginTop: 8,
+					marginLeft: 8,
+					opacity: .55
+				} : {
+					...PANEL_STYLE.btn,
+					marginTop: 8,
+					marginLeft: 8
+				},
+				disabled: busy,
+				onClick: () => props.face.act(target, "recheck")
+			}, ACTION_LABEL.recheck) : null, reason ? react.createElement("div", { style: PANEL_STYLE.reason }, reason) : null, react.createElement("code", { style: PANEL_STYLE.cmd }, manual));
 		}
 		//#endregion
 		//#region src/health-contract.ts
@@ -998,20 +1187,38 @@ window.__ModuleLoader__.load({
 		/** 面板到各家的配置体检：一次取数、六份报告（纯异步函数：无 DOM、无 react；传输口注入，便于单测）。
 		*
 		* 三条纪律：
-		*   · **只走各家自己的通道**（`rpc.call(channel, HEALTH_ENDPOINT, …)`）——总管不认任何一家、也不加
-		*     任何单品的依赖；通道名从「爱生活页签槽」的账本条目带出来（各家注册时写进 options）。
+		*   · **只走各家自己的电话**（`rpc.call(CARRIER_BASE, <电话名>, {method, payload}, …)`）——总管不认任何
+		*     一家的端点、也不加任何单品的依赖；电话名与端点名都是各家契约件公开的事实。
+		*     ⚠ **载体形状**（#735 真机踩到）：第一段必须是**载体基段** `/api`，第二段是那家的电话名
+		*     （＝它注册在 `/api<通道>` 上的那一段），端点名写进载荷的 `method`。写错第一段就是 404，
+		*     而 404 只落成「那一家取不到数」，屏上看起来像按钮坏了（先例：总管自己的电话在 #678 栽过同一处，
+		*     见 `update-contract.ts` 的 `CARRIER_BASE`）。
 		*   · **一次取数，六份报告**：总览那行与各家那张表读的是同一份结果（见 `health-panel.ts` 的单一状态源），
 		*     不许两处各算一遍。
 		*   · 有界超时：一家不回不该拖死整屏（技能侧 spawn 上限 20 s，这里给 25 s）。
 		*/
-		/** 一次取数的时限（毫秒）：技能侧 spawn 上限 20 s，这里留一点余量。 */
-		const HEALTH_TIMEOUT_MS = 25e3;
+		/** 一家的电话名：通道名去掉前导斜杠那一段（各家宿主半注册在 `/api` ＋ 通道名，信封 `method` 就是它）。 */
+		function phoneOf(channel) {
+			return channel.startsWith("/") ? channel.slice(1) : channel;
+		}
+		/** 整批取数的时限（毫秒），**不是**一家一份：六家的活是在**同一个宿主线程**上排队干的。
+		*
+		* 为什么不是「技能侧 spawn 上限 20 s ＋ 一点余量」（票 #740 对抗式审查第二轮逮到）：
+		* 各家的宿主半用的是 `spawnSync`（各单品的 `src/bridge.ts` 里 `SPAWN_TIMEOUT_MS = 20_000`），
+		* 它**阻塞**宿主的事件循环——六通电话同时打进来，真正干活的是一个接一个串起来的。
+		* 于是「六家之和」才是这一批的真实上界：按一家 20 s 算最坏 120 s，常见情形（一家 1～3 s）约 10 s。
+		* 60 s 取两者之间：给常见情形留足余量，又不至于让一次卡死把按钮按成两分钟不动。
+		* 单家的错照样逐家报（那家页签里的体检表会写「体检超时（60s）…」）。 */
+		const HEALTH_TIMEOUT_MS = 6e4;
 		function timeoutText() {
 			return "体检超时（" + String(Math.round(HEALTH_TIMEOUT_MS / 1e3)) + "s）：技能没在时限内回话。";
 		}
 		async function fetchOne(call, row) {
 			try {
-				const result = await call(row.channel, HEALTH_ENDPOINT, {}, AbortSignal.timeout(HEALTH_TIMEOUT_MS));
+				const result = await call(CARRIER_BASE, phoneOf(row.channel), {
+					method: HEALTH_ENDPOINT,
+					payload: {}
+				}, AbortSignal.timeout(HEALTH_TIMEOUT_MS));
 				if (!result || typeof result !== "object" || typeof result.ok !== "boolean") return {
 					report: null,
 					error: "回执信封异常（非 ok 信封）。"
@@ -1118,6 +1325,17 @@ window.__ModuleLoader__.load({
 			} catch {}
 			return face;
 		}
+		/** 汇总行该显示哪一句错（票 #735）：取数过程本身的错优先；**一家报告都没回来**时，把第一条家错误顶上来。
+		*
+		* 为什么要有这一格：各家的错只画在那家页签里的体检表上，一行摘要看不见 ⇒ 用户点完只见「体检中…」闪一下、
+		* 接着仍旧「还没体检」，会以为按钮坏了（真机上就是这么被误判的；那次六家全 404，汇总行一声不吭）。
+		* 有报告回来时不顶：那时各家那张表里已经把错说清楚了，摘要行只管读数。 */
+		function summaryErrorOf(face) {
+			if (face.error !== null) return face.error;
+			const rows = Object.values(face.rows);
+			if (rows.some((row) => row.report !== null)) return null;
+			return rows.find((row) => row.error !== null)?.error ?? null;
+		}
 		//#endregion
 		//#region src/health-view.ts
 		/** 配置体检的两个画法：面板顶部那行总览（六家一盏灯）＋ 各家那张表。
@@ -1339,15 +1557,26 @@ window.__ModuleLoader__.load({
 		}
 		/** 几截读数之间那个分隔符：不许染档位色（它不属于任何一档）。 */
 		const SEG_SEP = " · ";
-		/** 汇总行那一句：绿要显眼（它是「正常」这件事本身），没通道的那几家不冒充绿。 */
+		/** 汇总行那一句：绿要显眼（它是「正常」这件事本身），没通道的那几家不冒充绿。
+		*
+		*  「没有体检出口」与「还没跑过体检」是**两件事**（票 #735）：前者那颗「体检一次」按下去不会有任何反应，
+		*  必须自己说出来——两态共用一句「还没体检」时，用户与诊断都会被引到「点了没跑」上去。 */
 		function overallText(lights) {
 			const pending = lights.filter((light) => !light.hasChannel).length;
-			const withReport = lights.filter((light) => light.hasChannel);
-			const tail = pending > 0 ? " · " + String(pending) + " 家还没体检" : "";
-			if (withReport.length > 0 && withReport.every((light) => light.status === "green")) return react.createElement("span", { style: {
+			const withChannel = lights.filter((light) => light.hasChannel);
+			const tail = pending > 0 ? " · " + String(pending) + " 家没有体检出口" : "";
+			if (withChannel.length === 0) {
+				const what = lights.length === 0 ? "还没有任何一家登记体检出口" : String(lights.length) + " 家都没有体检出口（通道名没登记上）";
+				return react.createElement("span", { style: {
+					color: STATUS_TEXT.red,
+					fontWeight: 700
+				} }, "没有可体检的家：" + what);
+			}
+			const allGreen = withChannel.every((light) => light.status === "green");
+			if (allGreen && pending === 0) return react.createElement("span", { style: {
 				color: STATUS_COLOR.green,
 				fontWeight: 700
-			} }, "六家正常" + tail);
+			} }, "六家正常");
 			const parts = [];
 			for (const status of ["red", "yellow"]) {
 				let count = 0;
@@ -1365,7 +1594,7 @@ window.__ModuleLoader__.load({
 					}
 				}, STATUS_LABEL[status] + " " + String(count)));
 			}
-			if (parts.length === 0) return react.createElement("span", { style: { color: INK_DIM } }, "还没体检" + tail);
+			if (parts.length === 0) return react.createElement("span", { style: { color: INK_DIM } }, (allGreen ? "有出口的都正常" : "还没体检") + tail);
 			parts.push(react.createElement("span", {
 				key: "todo",
 				style: { color: INK }
@@ -1409,11 +1638,10 @@ window.__ModuleLoader__.load({
 		*  与页签的分工：这行只答「一共几条要处理」；「哪几家、各几条」由页签的圆点与小数字答；
 		*  「具体哪一条坏了、去哪修」由那家页签里的 `HealthTable` 答。 */
 		function HealthSummaryLine(props) {
-			const hasLights = props.lights.length > 0;
 			return react.createElement("div", {
 				style: HEALTH_STYLE.summaryRow,
 				"data-ilife-health": "summary"
-			}, react.createElement("div", { style: HEALTH_STYLE.head }, "配置体检"), react.createElement("div", { style: HEALTH_STYLE.summaryText }, props.error !== null ? react.createElement("span", { style: { color: STATUS_TEXT.red } }, props.error) : hasLights ? overallText(props.lights) : react.createElement("span", { style: { color: INK_DIM } }, "还没体检")), react.createElement("button", {
+			}, react.createElement("div", { style: HEALTH_STYLE.head }, "配置体检"), react.createElement("div", { style: HEALTH_STYLE.summaryText }, props.error !== null ? react.createElement("span", { style: { color: STATUS_TEXT.red } }, props.error) : overallText(props.lights)), react.createElement("button", {
 				type: "button",
 				style: props.running ? {
 					...HEALTH_STYLE.btn,
@@ -1533,6 +1761,9 @@ window.__ModuleLoader__.load({
 		*   文案与网址都取自 nav.ts 的两张静态表，本文件只画不算。
 		*/
 		const inject = ["slots", "connection"];
+		/** 包名 → 本家那条客户端通道（票 #735）。取值面是导航表那份镜像，不再从页签槽账本的自定义选项里读：
+		*  装机槽位面不透传自定义键，读了恒是空串（详见 `nav.ts` 上 `ManagerTab.channel` 的注释）。 */
+		const CHANNEL_BY_PLUGIN = new Map(MANAGER_TABS.map((tab) => [tab.plugin, tab.channel]));
 		/** 总管视觉（内联 style；颜色走 DSH 主题别名，深浅主题自适应，写死值只做回退；与技能面板同语言）。 */
 		const S = {
 			headRow: {
@@ -1710,6 +1941,23 @@ window.__ModuleLoader__.load({
 				style: S.moreRow
 			}, react.createElement("span", { style: S.morePkg }, row.pkg), react.createElement("span", { style: S.moreDesc }, row.desc), react.createElement("span", { style: S.moreIcon }, react.createElement(ExternalIcon, null)))));
 		}
+		/** 总管自述版本（票 #737）：**不手写**，问宿主——宿主读自己这份已安装包的 `package.json`。
+		*
+		* 单次取数（`loadManagerVersion`），无轮询；初值 `unknown`，读不到也停在 `unknown`。
+		* 与卡路里 #130 同一条路：面板是浏览器产物、禁 node 内建，读盘只许在宿主半。 */
+		function useManagerVersion(getCall) {
+			const [version, setVersion] = react.useState(VERSION_UNKNOWN);
+			react.useEffect(() => {
+				let alive = true;
+				loadManagerVersion(getCall()).then((next) => {
+					if (alive) setVersion(next);
+				});
+				return () => {
+					alive = false;
+				};
+			}, [getCall]);
+			return version;
+		}
 		/** 爱生活面板：总设置区 ＋ 检查更新（七家）＋ 爱生活页签条（slot 驱动）＋ 技能设置页投影/缺席卡。 */
 		function LifePackSection(props) {
 			const tabsId = react.useId();
@@ -1717,6 +1965,7 @@ window.__ModuleLoader__.load({
 			const rows = props.useTabs((value) => value);
 			const present = new Set(rows.map((r) => r.id));
 			const face = useUpdateRows(props.getCall);
+			const managerVersion = useManagerVersion(props.getCall);
 			const health = useHealthPanel(() => props.getCall(), react.useMemo(() => rows.filter((row) => row.channel.length > 0).map((row) => ({
 				id: row.id,
 				channel: row.channel
@@ -1766,10 +2015,10 @@ window.__ModuleLoader__.load({
 				setActiveId(next.plugin);
 				tabRefs.current[nextIndex]?.focus();
 			}
-			return react.createElement("div", null, react.createElement("div", { style: S.headRow }, react.createElement("div", { style: S.head }, "爱生活"), react.createElement("div", { style: S.headActions }, react.createElement(CheckUpdateButton, { face }), react.createElement(PanelActions, null))), react.createElement("div", { style: S.meta }, react.createElement("div", null, "总开关 · 开关（缺省启用，只读）"), react.createElement("div", null, "总管 dsh-life-pack · 0.2.6")), react.createElement(UpdateResults, { face }), react.createElement(HealthSummaryLine, {
+			return react.createElement("div", null, react.createElement("div", { style: S.headRow }, react.createElement("div", { style: S.head }, "爱生活"), react.createElement("div", { style: S.headActions }, react.createElement(CheckUpdateButton, { face }), react.createElement(PanelActions, null))), react.createElement("div", { style: S.meta }, react.createElement("div", null, "总管 dsh-life-pack · " + managerVersion)), react.createElement(UpdateResults, { face }), react.createElement(HealthSummaryLine, {
 				lights,
 				running: health.running,
-				error: health.error,
+				error: summaryErrorOf(health),
 				onRun: health.run
 			}), react.createElement("div", {
 				role: "tablist",
@@ -1853,7 +2102,7 @@ window.__ModuleLoader__.load({
 							id: entry.options.id ?? "",
 							order: entry.options.order ?? 0,
 							label: resolveLabel(entry.options.label),
-							channel: entry.options.channel ?? ""
+							channel: CHANNEL_BY_PLUGIN.get(entry.options.id ?? "") ?? ""
 						})).sort((a, b) => a.order - b.order);
 					}
 					return tabs;