dsh-life-pack 0.3.0 → 0.3.1

package/dist/client.js

@@ -186,28 +186,37 @@ window.__ModuleLoader__.load({
 		* 一处定义、两侧引用：宿主半 `manager-version.ts` 读失败时回它，面板半 `update-client.ts`
 		* 归一化时也认它——面板侧不许 import 宿主半（会把 node 内建带进浏览器束）。 */
 		const VERSION_UNKNOWN = "unknown";
-		/** 装不了 / 装不成的人话原因表：八种 `blockedReason` ＋ 过程错误码（更新包 README 第 8、12 节）。 */
+		/** 装不了 / 装不成的人话原因表：八种 `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
@@ -357,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("、");
 		}
 		/** 面板展示的那条可复制命令（用户会照着敲的那一条）。
 		*
@@ -692,6 +780,13 @@ window.__ModuleLoader__.load({
 				default: return "idle";
 			}
 		}
+		/** 四个动作在屏上的名字：按钮文案与判据同源（票 #740）。 */
+		const ACTION_LABEL = {
+			install: "装上",
+			update: "装上更新",
+			retry: "重试安装",
+			recheck: "重新检查"
+		};
 		const IDLE$1 = {
 			phase: "idle",
 			outcome: null,
@@ -728,6 +823,10 @@ window.__ModuleLoader__.load({
 					[key]: next
 				}));
 			}, []);
+			/** 装成一家 ⇒ 其余各家的旧快照一律作废（票 #740）：判据见 `markStaleOthers`。 */
+			const staleOthers = react.useCallback((keepKey) => {
+				setRows((previous) => markStaleOthers(previous, keepKey));
+			}, []);
 			return {
 				targets,
 				rows,
@@ -743,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));
 				}, [
@@ -763,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);
@@ -779,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;
 						}
@@ -811,7 +944,8 @@ window.__ModuleLoader__.load({
 							failure: {
 								...result,
 								manual: result.manual ?? current.outcome?.manual ?? null
-							}
+							},
+							stale: false
 						});
 					})();
 				}, [
@@ -819,7 +953,8 @@ window.__ModuleLoader__.load({
 					patch,
 					pollMs,
 					reload,
-					rows
+					rows,
+					staleOthers
 				])
 			};
 		}
@@ -836,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);
 		}
 		/** 七家结果：装不了的与待重启的常驻（横幅），详细结果放**居中浮层**（点「检查更新」开）。
 		*
@@ -872,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];
 				/** 这一行「当前／最新」两个版本号：不等才算有新版，把「最新」那格上色（用户扫一眼先看有没有箭头）。 */
@@ -906,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,
@@ -914,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,
@@ -940,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);
 		}
 		/** 缺席卡：**按两处独立事实分三态**，每态只给能改变状态的动作。
 		*
@@ -961,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",
@@ -985,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
@@ -1047,8 +1201,15 @@ window.__ModuleLoader__.load({
 		function phoneOf(channel) {
 			return channel.startsWith("/") ? channel.slice(1) : channel;
 		}
-		/** 一次取数的时限（毫秒）：技能侧 spawn 上限 20 s，这里留一点余量。 */
-		const HEALTH_TIMEOUT_MS = 25e3;
+		/** 整批取数的时限（毫秒），**不是**一家一份：六家的活是在**同一个宿主线程**上排队干的。
+		*
+		* 为什么不是「技能侧 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）：技能没在时限内回话。";
 		}