dsh-life-pack 0.3.18 → 0.3.20

package/dist/client.js

@@ -174,12 +174,6 @@ window.__ModuleLoader__.load({
 			* 也不该把名字再写一份（写两份必然走散）。宿主把名字表连同版本行一起交出去，
 			* 面板一行字面量都不留。 */
 			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",
 			/** 本机「根」清单（票 #744）：入参 `{}`，回包 `{roots: [{path, kind}]}`。
 			*
 			* 为什么这条能力住在总管：浏览器里没有卷清单接口，而宿主那条目录选择接缝只有
@@ -188,15 +182,9 @@ window.__ModuleLoader__.load({
 			* 回包**恒成功**：列不出来是空清单，不是错误码（界面据此只是不画那一行）。 */
 			roots: "ilife-manager.roots"
 		};
-		/** 版本读不到时两侧共用的降级字面量（面板照原样显示，不假装知道版本）。
-		*
-		* 一处定义、两侧引用：宿主半 `manager-version.ts` 读失败时回它，面板半 `update-client.ts`
-		* 归一化时也认它——面板侧不许 import 宿主半（会把 node 内建带进浏览器束）。 */
-		const VERSION_UNKNOWN = "unknown";
 		/** 挂载取数失败的退避重试表（票 #982，更新目标表用）。
 		*
-		* 一处定义：与版本读取重试同形（`client.ts` 的退避三次）——挂载时首次传输失败
-		* （宿主路由尚未就绪）会使错误态常驻整个会话；单次直返是当时的缺口。
+		* 挂载时首次传输失败（宿主路由尚未就绪）会使错误态常驻整个会话；单次直返是当时的缺口。
 		* 次数有界、调用方负责卸载清理（见 `update-panel.ts` 的取数），不是无界轮询。 */
 		const LOAD_RETRY_MS = [
 			1e3,
@@ -237,15 +225,17 @@ window.__ModuleLoader__.load({
 		}
 		//#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.version`（宿主读自己那份包描述文件，见 `manager-version.ts`）。
+		* - 装上缺席的包：走总管自有的 `ilife-manager.install`（更新包的三个电话只管已装的包）。
+		*
+		* 版本号**不在这三条里**（票 #986）：面板那行版本由构建期注入产物（见 `client.ts`），
+		* 不再经 `ilife-manager.version` 往返——标签的延迟不依赖宿主可用性。
 		*/
 		/** 轮询上限：1 秒一次、最多 900 次（覆盖更新包 15 分钟的安装时限）。 */
 		const MAX_POLL_TRIES = 900;
@@ -323,16 +313,6 @@ 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;
@@ -555,6 +535,29 @@ window.__ModuleLoader__.load({
 			if (typeof raw === "string" && raw.length > 0) return failure.code + " detail=" + raw.slice(0, 300);
 			return failure.code;
 		}
+		/** 失败原文那一行（票 #988）：宿主回包 `details.detail` 里那句人话，面板把它摊在原因句下面。
+		*
+		* 为什么要摊：`install-failed` 这句人话对每一种装不上都长一个样，光看它分不出「这个宿主没有安装出口」
+		* 与「pnpm 退出码非零」。原文由宿主半取好并回传（`update-host.ts` 的 `installErrorDetail`），
+		* 这里只取值与截断（长文本会撑爆那一行）。没有原文回 null——面板不自己编原因。 */
+		function failureDetailOf(failure) {
+			const raw = failure?.details?.detail;
+			if (typeof raw !== "string") return null;
+			const text = raw.trim();
+			return text.length === 0 ? null : text.slice(0, 300);
+		}
+		/** 题头两颗按钮的悬停标题（票 #986 第二半：目标表未就绪时说真因）。
+		*
+		* 住这里（不是面板组件旁边）：标题口径只有一个定义地，面板与单测共用同一份；
+		* 忙时沿用 update-busy 原句（与禁用判据同源），未就绪且空闲时说「还在读更新目标」，
+		* 就绪后回到调用方给的动作说明（本函数不写死那两句动作说明，由调用方传入）。
+		*
+		* 入参只取判据形状（blocked 与 empty），不 import 面板钩子。 */
+		function headerButtonTitle(input) {
+			if (input.blocked) return reasonText("update-busy");
+			if (input.empty) return "还在读更新目标，稍候再试";
+			return input.readyText ?? "";
+		}
 		//#endregion
 		//#region src/update-queue.ts
 		/** 任一行 installing 即忙：题头检查更新禁用、行按钮全局互斥、checkAll/act 入口直接返回的同一判据。 */
@@ -921,6 +924,13 @@ window.__ModuleLoader__.load({
 				marginTop: 4
 			}
 		};
+		/** 失败原文那一块（票 #988）：宿主回来的细节单放一个可复制块（`cmd` 样式带 `userSelect: all`，
+		* 点一下全选即拷走），不与可执行的手工命令拼在同一块里——拼一起用户会整块拷去终端敲。
+		* 两处失败行（结果行与缺席卡）共用这一块，口径一处。 */
+		function failureDetailCode(detail) {
+			if (!detail) return null;
+			return react.createElement("code", { style: PANEL_STYLE.cmd }, "宿主原话：" + detail);
+		}
 		const ROW_TONE = {
 			update: {
 				mark: "↑",
@@ -1053,6 +1063,10 @@ window.__ModuleLoader__.load({
 			react.useEffect(() => {
 				reload(true);
 			}, [reload]);
+			/** 取数失败后的手动重试（票 #986 第二半）：不依赖目标表，挂载那次的退避表复用。 */
+			const retry = react.useCallback(() => {
+				reload(true);
+			}, [reload]);
 			const patch = react.useCallback((key, next) => {
 				setRows((previous) => ({
 					...previous,
@@ -1072,6 +1086,7 @@ window.__ModuleLoader__.load({
 				checking,
 				updatingAll,
 				open,
+				retry,
 				close: () => setOpen(resolveDialogOpen("hide")),
 				showProgress: () => setOpen(resolveDialogOpen("show")),
 				checkAll: react.useCallback(() => {
@@ -1213,6 +1228,21 @@ window.__ModuleLoader__.load({
 				])
 			};
 		}
+		/** 取数失败的出口卡（票 #986 第二半：失败必须有出口）。
+		*
+		* 纯组件（无钩子）：错误原文＋一颗可点的「重试」。重试不依赖目标表——
+		* 目标表为空时两题头按钮仍禁用，但这颗可点；点它重走取数，成功后按钮与行恢复。
+		*/
+		function TargetsLoadError(props) {
+			return react.createElement("div", { style: PANEL_STYLE.reason }, "更新能力没接上：" + props.message, react.createElement("button", {
+				type: "button",
+				style: {
+					...PANEL_STYLE.btn,
+					marginLeft: 8
+				},
+				onClick: props.onRetry
+			}, "重试"));
+		}
 		/** 标题右侧两件：「检查更新」一次查七家 ＋ 「全部更新」按顺序串行装（吃 `useUpdateRows` 的表）。
 		*
 		* 禁用形状（#925 第 2 条 ＋ #980 检查中）：任一行 installing、一键串行中或检查轮未收尾时两件都点不得；人话沿用 `update-busy` 原句
@@ -1225,30 +1255,37 @@ window.__ModuleLoader__.load({
 				updatingAll,
 				checking
 			});
-			const checkDisabled = blocked || targets.length === 0;
-			const allDisabled = blocked || targets.length === 0;
-			const busyText = reasonText("update-busy");
+			const targetsEmpty = targets.length === 0;
+			const headerDisabled = blocked || targetsEmpty;
 			const installingNow = hasInstallingRow(rows) || updatingAll;
 			return react.createElement("span", { style: PANEL_STYLE.actions }, react.createElement("button", {
 				type: "button",
-				style: checkDisabled ? {
+				style: headerDisabled ? {
 					...PANEL_STYLE.btn,
 					opacity: .55,
 					cursor: "default"
 				} : PANEL_STYLE.btn,
-				disabled: checkDisabled,
+				disabled: headerDisabled,
 				onClick: checkAll,
-				title: blocked ? busyText : "检查总管与六家插件的版本"
+				title: headerButtonTitle({
+					blocked,
+					empty: targetsEmpty,
+					readyText: "检查总管与六家插件的版本"
+				})
 			}, checking ? "检查中…" : "检查更新"), react.createElement("button", {
 				type: "button",
-				style: allDisabled ? {
+				style: headerDisabled ? {
 					...PANEL_STYLE.btn,
 					opacity: .55,
 					cursor: "default"
 				} : PANEL_STYLE.btn,
-				disabled: allDisabled,
+				disabled: headerDisabled,
 				onClick: updateAll,
-				title: blocked ? busyText : "按顺序逐家装上更新（一家收尾才起下一家）"
+				title: headerButtonTitle({
+					blocked,
+					empty: targetsEmpty,
+					readyText: "按顺序逐家装上更新（一家收尾才起下一家）"
+				})
 			}, installingNow ? "更新中…" : "全部更新"));
 		}
 		/** 待重启横幅：一行总账，只点名哪几家要重启（理由与做法写在各家卡片上，见 `restartBannerText`）。 */
@@ -1272,13 +1309,16 @@ window.__ModuleLoader__.load({
 		* 手工命令只在「装不了」或「装失败」的行显示：正常用户用不到，摊在每行上既吵又误导。
 		*/
 		function UpdateResults(props) {
-			const { targets, rows, loadError, checking, updatingAll, open, close, showProgress } = props.face;
+			const { targets, rows, loadError, checking, updatingAll, open, close, showProgress, retry } = props.face;
 			const dialogRef = react.useRef(null);
 			react.useEffect(() => {
 				if (open) dialogRef.current?.focus();
 			}, [open]);
 			const shown = targets.filter((target) => rows[target.key] && rows[target.key].phase !== "idle");
-			if (loadError) return react.createElement("div", { style: PANEL_STYLE.reason }, "更新能力没接上：" + loadError);
+			if (loadError) return react.createElement(TargetsLoadError, {
+				message: loadError,
+				onRetry: retry
+			});
 			if (targets.length === 0) return null;
 			if (shown.length === 0 && !open) return null;
 			const locked = shouldBlockBatchStart({
@@ -1337,7 +1377,7 @@ window.__ModuleLoader__.load({
 					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", {
+				}, ACTION_LABEL[buttonAction]) : null, row.failure ? react.createElement("div", { style: PANEL_STYLE.reason }, "装不上：" + row.failure.message) : null, failureDetailCode(failureDetailOf(row.failure)), versionLines(target, snapshot).map((line, index) => react.createElement("div", {
 					key: String(index),
 					style: PANEL_STYLE.skill
 				}, line)), showManual ? react.createElement("div", { style: PANEL_STYLE.skill }, "在终端里执行这条命令可以手动完成这一步：") : null, showManual ? react.createElement("code", { style: PANEL_STYLE.cmd }, manual) : null);
@@ -1441,7 +1481,7 @@ window.__ModuleLoader__.load({
 				disabled: locked,
 				title: locked ? reasonText("update-busy") : void 0,
 				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));
+			}, ACTION_LABEL.recheck) : null, reason ? react.createElement("div", { style: PANEL_STYLE.reason }, reason) : null, failureDetailCode(failureDetailOf(row?.failure)), react.createElement("code", { style: PANEL_STYLE.cmd }, manual));
 		}
 		//#endregion
 		//#region src/health-contract.ts
@@ -3069,48 +3109,8 @@ 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；#937 改口）：**不手写**，问宿主——宿主读自己这份已安装包的 `package.json`。
-		*
-		* 三态（#937）：`loading`（首帧就画胶囊占位 `…`）／`ready`（读到，画包名 · 版本）／`missing`（读不到，画「版本未知」）。
-		* **失败要重试**：原先只取一次、一失败就永远停在未知（#937 查出来的真缺陷）；这里按 1s／3s／8s 退避重试三次。
-		* 与卡路里 #130 同一条路：面板是浏览器产物、禁 node 内建，读盘只许在宿主半。 */
-		/** 读中 / 读不到 两种胶囊文案（#937：占位符用 `…`，读不到给人话，不把 `unknown` 印给人看）。 */
-		const VERSION_PENDING_TEXT = "…";
-		const VERSION_MISSING_TEXT = "版本未知";
-		/** 重试间隔（#937）：三次退避，之后不再打扰宿主。 */
-		const VERSION_RETRY_MS = [
-			1e3,
-			3e3,
-			8e3
-		];
-		function useManagerVersion(getCall) {
-			const [state, setState] = react.useState({ kind: "loading" });
-			react.useEffect(() => {
-				let alive = true;
-				const timers = [];
-				const attempt = (index) => {
-					loadManagerVersion(getCall()).then((next) => {
-						if (!alive) return;
-						if (next !== "unknown") {
-							setState({
-								kind: "ready",
-								version: next
-							});
-							return;
-						}
-						setState({ kind: "missing" });
-						const wait = VERSION_RETRY_MS[index];
-						if (wait !== void 0) timers.push(setTimeout(() => attempt(index + 1), wait));
-					});
-				};
-				attempt(0);
-				return () => {
-					alive = false;
-					for (const id of timers) clearTimeout(id);
-				};
-			}, [getCall]);
-			return state;
-		}
+		/** 版本胶囊那一行字：只在这里拼一次，屏上与用例读的是同一串。 */
+		const MANAGER_VERSION_TEXT = "dsh-life-pack · 0.3.20";
 		/** 爱生活面板：总设置区 ＋ 检查更新（七家）＋ 爱生活页签条（slot 驱动）＋ 技能设置页投影/缺席卡。 */
 		function LifePackSection(props) {
 			const tabsId = react.useId();
@@ -3118,7 +3118,6 @@ 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
@@ -3192,7 +3191,7 @@ window.__ModuleLoader__.load({
 			return react.createElement("div", null, react.createElement("div", { style: S.headRow }, react.createElement("div", { style: S.head }, "爱生活"), react.createElement("span", {
 				style: S.versionCapsule,
 				"data-ilife-version": "capsule"
-			}, managerVersion.kind === "ready" ? "dsh-life-pack · " + managerVersion.version : managerVersion.kind === "missing" ? VERSION_MISSING_TEXT : VERSION_PENDING_TEXT), react.createElement("div", { style: S.headActions }, react.createElement(CheckUpdateButton, { face }), react.createElement(PanelActions, null))), react.createElement(UpdateResults, { face }), react.createElement(HealthSummaryLine, {
+			}, MANAGER_VERSION_TEXT), react.createElement("div", { style: S.headActions }, react.createElement(CheckUpdateButton, { face }), react.createElement(PanelActions, null))), react.createElement(UpdateResults, { face }), react.createElement(HealthSummaryLine, {
 				lights,
 				running: health.running,
 				error: summaryErrorOf(health),