dsh-life-pack 0.3.15 → 0.3.17

package/dist/client.js

@@ -193,6 +193,16 @@ window.__ModuleLoader__.load({
 		* 一处定义、两侧引用：宿主半 `manager-version.ts` 读失败时回它，面板半 `update-client.ts`
 		* 归一化时也认它——面板侧不许 import 宿主半（会把 node 内建带进浏览器束）。 */
 		const VERSION_UNKNOWN = "unknown";
+		/** 挂载取数失败的退避重试表（票 #982，更新目标表用）。
+		*
+		* 一处定义：与版本读取重试同形（`client.ts` 的退避三次）——挂载时首次传输失败
+		* （宿主路由尚未就绪）会使错误态常驻整个会话；单次直返是当时的缺口。
+		* 次数有界、调用方负责卸载清理（见 `update-panel.ts` 的取数），不是无界轮询。 */
+		const LOAD_RETRY_MS = [
+			1e3,
+			3e3,
+			8e3
+		];
 		/** 装不了 / 装不成的人话原因表：八种 `blockedReason` ＋ 过程错误码（更新包 README 第 8、12 节）。
 		*
 		* 每条都要三段齐全（票 #740 的文案判据）：**事实**（哪里对不上）→ **后果**（这家现在能不能装）
@@ -282,8 +292,27 @@ window.__ModuleLoader__.load({
 			const error = result.error;
 			return failure(typeof error?.code === "string" ? error.code : "internal", error && typeof error.details === "object" && error.details !== null ? error.details : {});
 		}
-		/** 取七个更新目标的表（宿主转交更新包的三个电话名与版本行，面板不写死任何电话名）。 */
-		async function loadTargets(call) {
+		/** 取七个更新目标的表（宿主转交更新包的三个电话名与版本行，面板不写死任何电话名）。
+		*
+		* 重试参数（票 #982）：缺省单次（与旧行为一致）；给 `delays` 即按退避重试——
+		* 挂载时首次传输失败不再直接进入错误态。`sleep`／`isAlive` 可注入（测试与卸载清理用），
+		* 缺省走本模块同形的等待与恒真。首次成功即返回，否则返回最后一次失败。 */
+		async function loadTargets(call, retry) {
+			const delays = retry?.delays ?? [];
+			const sleepFn = retry?.sleep ?? sleep;
+			const alive = retry?.isAlive ?? (() => true);
+			let last = await loadTargetsOnce(call);
+			for (let i = 0; i < delays.length && !last.ok; i += 1) {
+				if (!alive()) return last;
+				const wait = delays[i];
+				if (wait > 0) await sleepFn(wait);
+				if (!alive()) return last;
+				last = await loadTargetsOnce(call);
+			}
+			return last;
+		}
+		/** 取七个更新目标的表：单次（重试循环的每一步都是它）。 */
+		async function loadTargetsOnce(call) {
 			const out = await callManager(call, MANAGER_ACTIONS.targets, {});
 			if (!out.ok) return out;
 			return {
@@ -517,6 +546,15 @@ window.__ModuleLoader__.load({
 			else lines.push("技能包随插件（不单独查更新）");
 			return lines;
 		}
+		/** 取数失败的日志细节（票 #982）：传输层返回的原文优先，否则返回原因码——短文本，不带用户数据。
+		*
+		* 住这里（不是取数钩子旁边）：本文件是面板纯函数与单测共用的那一份，判据可单测；
+		* 参数只取失败体的形状（`code`＋`details`），不 import 取数模块。 */
+		function loadFailureDetail(failure) {
+			const raw = failure.details?.detail;
+			if (typeof raw === "string" && raw.length > 0) return failure.code + " detail=" + raw.slice(0, 300);
+			return failure.code;
+		}
 		//#endregion
 		//#region src/update-queue.ts
 		/** 任一行 installing 即忙：题头检查更新禁用、行按钮全局互斥、checkAll/act 入口直接返回的同一判据。 */
@@ -524,6 +562,40 @@ window.__ModuleLoader__.load({
 			for (const key of Object.keys(rows)) if (rows[key]?.phase === "installing") return true;
 			return false;
 		}
+		/** 批量入口点不得：一键串行中、任一行安装中、检查轮未收尾，三者任一即拦。
+		*
+		* 面板 `checkAll`／`updateAll`／`act` 共用同一判据：双轮同时写同一行即错（#980：
+		* 原先缺 `checking`，检查未收尾即点一键会另起一轮覆盖行状态）。
+		* 人话仍沿用 `update-busy` 原句，本函数只回答拦不拦。 */
+		function shouldBlockBatchStart(state) {
+			return state.hasInstallingRow || state.updatingAll || state.checking;
+		}
+		/** 重取目标表时保不保留旧表：新表为空且屏上有进度（任一行非空闲或一键串行中）
+		* 则保留旧表——否则可见行计算短暂为空，整块闪掉如重载（#980）。
+		* 首挂全空闲与正常非空表不受影响，照常替换。 */
+		function shouldKeepTargetsOnReload(loadedCount, rows, updatingAll) {
+			if (loadedCount > 0) return false;
+			if (updatingAll) return true;
+			for (const key of Object.keys(rows)) if (rows[key]?.phase !== "idle") return true;
+			return false;
+		}
+		/** 重取目标表后的下一张表：空表保旧（见 `shouldKeepTargetsOnReload`）；非空表照常换，
+		* 但批量进行中（串行中或有安装中）时在新表里缺失、屏上又有进度的旧目标会被追加到表尾——
+		* 键乱序或短暂缺键时不断进度、不闪掉整块（#980 验收“顺序变化时不把整块置空”）。
+		* 空闲时不追加：正常下架由新表说了算。 */
+		function mergeTargetsOnReload(previous, loaded, rows, updatingAll) {
+			if (shouldKeepTargetsOnReload(loaded.length, rows, updatingAll)) return previous;
+			if (!updatingAll && !hasInstallingRow(rows)) return loaded;
+			const keys = new Set(loaded.map((target) => target.key));
+			const kept = previous.filter((target) => {
+				const row = rows[target.key];
+				return row !== void 0 && !keys.has(target.key) && row.phase !== "idle";
+			});
+			return kept.length > 0 ? [...loaded, ...kept] : loaded;
+		}
+		function resolveDialogOpen(event) {
+			return event === "show";
+		}
 		/** 按目标顺序逐家查→装→收尾：一家收尾才起下一家；失败记 failed 继续；待重启跳过安装。
 		*
 		* 跳过安装只有一种：快照事实已是待重启（`restartPendingOf`）——由横幅点名，不在这里装第二遍。
@@ -920,18 +992,66 @@ window.__ModuleLoader__.load({
 			react.useEffect(() => () => {
 				alive.current = false;
 			}, []);
-			/** 重取七个目标的表（装机读数变了就重取：缺席卡的态是拿这张表算的，缓存住它会继续说旧话）。 */
-			const reload = react.useCallback(async () => {
-				const loaded = await loadTargets(getCall());
+			const rowsRef = react.useRef(rows);
+			rowsRef.current = rows;
+			const targetsRef = react.useRef(targets);
+			targetsRef.current = targets;
+			const pollMsRef = react.useRef(pollMs);
+			pollMsRef.current = pollMs;
+			const checkingRef = react.useRef(false);
+			checkingRef.current = checking;
+			const updatingAllRef = react.useRef(false);
+			const retryTimers = react.useRef([]);
+			react.useEffect(() => () => {
+				for (const id of retryTimers.current) clearTimeout(id);
+				retryTimers.current = [];
+			}, []);
+			/** 重取七个目标的表（装机读数变了就重取：缺席卡的态是拿这张表算的，缓存住它会继续说旧话）。
+			*
+			* 进度在屏上时不断进度（#980）：空表保旧表，非空表把批量中缺失的旧目标追加到表尾——
+			* 否则可见行计算短暂为空或缺键，整块闪掉如重载。
+			*
+			* 首帧失败重试（票 #982）：挂载时首次传输失败（宿主路由尚未就绪）不再直接进入错误态，
+			* 只在挂载那一次按退避表重试；装后重取走单次（此前刚成功调用过宿主，不必等）。
+			* 重试用尽仍失败才显示红色错误行，并把传输层细节打到 `[dsh-life-pack]` 前缀的日志里——
+			* 面板指引用户去日志里找的那一行，此前在这里从未输出过（浏览器侧只能打到控制台）。
+			*
+			* 已超线，需要根据规则进行重构：本文件改前约 747 行（本包告警线 350 行），本次 #982 增加约 60 行
+			* （重试等待、卸载清理、失败日志）。暂不拆分——拆分面板文件（取数、行渲染、浮层、缺席卡）是独立重构，
+			* 与本次修复无关；下轮单独立项。 */
+			const reload = react.useCallback(async (withRetry) => {
+				let tries = 0;
+				const sleep = (ms) => new Promise((resolve) => {
+					tries += 1;
+					if (tries >= LOAD_RETRY_MS.length + 1) {
+						resolve();
+						return;
+					}
+					const timer = setTimeout(() => {
+						clearTimeout(timer);
+						resolve();
+					}, ms);
+					retryTimers.current.push(timer);
+				});
+				const loaded = await loadTargets(getCall(), {
+					delays: withRetry ? LOAD_RETRY_MS : [],
+					sleep,
+					isAlive: () => alive.current
+				});
+				for (const id of retryTimers.current) clearTimeout(id);
+				retryTimers.current = [];
 				if (!alive.current) return;
 				if (loaded.ok) {
-					setTargets(loaded.value.targets);
+					setTargets(mergeTargetsOnReload(targetsRef.current, loaded.value.targets, rowsRef.current, updatingAllRef.current));
 					setPollMs(loaded.value.pollMs);
 					setLoadError(null);
-				} else setLoadError(loaded.message);
+				} else {
+					setLoadError(loaded.message);
+					console.warn("[dsh-life-pack] update targets load failed: " + loadFailureDetail(loaded));
+				}
 			}, [getCall]);
 			react.useEffect(() => {
-				reload();
+				reload(true);
 			}, [reload]);
 			const patch = react.useCallback((key, next) => {
 				setRows((previous) => ({
@@ -939,13 +1059,11 @@ window.__ModuleLoader__.load({
 					[key]: next
 				}));
 			}, []);
-			const rowsRef = react.useRef(rows);
-			rowsRef.current = rows;
-			const targetsRef = react.useRef(targets);
-			targetsRef.current = targets;
-			const pollMsRef = react.useRef(pollMs);
-			pollMsRef.current = pollMs;
-			const updatingAllRef = react.useRef(false);
+			const batchBlocked = react.useCallback(() => shouldBlockBatchStart({
+				hasInstallingRow: hasInstallingRow(rowsRef.current),
+				updatingAll: updatingAllRef.current,
+				checking: checkingRef.current
+			}), []);
 			return {
 				targets,
 				rows,
@@ -954,11 +1072,12 @@ window.__ModuleLoader__.load({
 				checking,
 				updatingAll,
 				open,
-				close: () => setOpen(false),
+				close: () => setOpen(resolveDialogOpen("hide")),
+				showProgress: () => setOpen(resolveDialogOpen("show")),
 				checkAll: react.useCallback(() => {
-					if (hasInstallingRow(rowsRef.current) || updatingAllRef.current) return;
+					if (batchBlocked()) return;
 					setChecking(true);
-					setOpen(true);
+					setOpen(resolveDialogOpen("show"));
 					const list = targetsRef.current;
 					const snapshot = rowsRef.current;
 					for (const target of list) patch(target.key, {
@@ -980,14 +1099,18 @@ window.__ModuleLoader__.load({
 					})).finally(() => {
 						if (alive.current) setChecking(false);
 					});
-				}, [getCall, patch]),
+				}, [
+					getCall,
+					patch,
+					batchBlocked
+				]),
 				updateAll: react.useCallback(() => {
-					if (hasInstallingRow(rowsRef.current) || updatingAllRef.current) return;
+					if (batchBlocked()) return;
 					const list = targetsRef.current;
 					if (list.length === 0) return;
 					updatingAllRef.current = true;
 					setUpdatingAll(true);
-					setOpen(true);
+					setOpen(resolveDialogOpen("show"));
 					(async () => {
 						try {
 							await runSerialUpdateAll(list, {
@@ -998,7 +1121,7 @@ window.__ModuleLoader__.load({
 								patch,
 								getRow: (key) => rowsRef.current[key]
 							});
-							await reload();
+							await reload(false);
 						} finally {
 							updatingAllRef.current = false;
 							if (alive.current) setUpdatingAll(false);
@@ -1007,10 +1130,11 @@ window.__ModuleLoader__.load({
 				}, [
 					getCall,
 					patch,
-					reload
+					reload,
+					batchBlocked
 				]),
 				act: react.useCallback((target, action) => {
-					if (hasInstallingRow(rowsRef.current) || updatingAllRef.current) return;
+					if (batchBlocked()) return;
 					const current = rowsRef.current[target.key] ?? IDLE$1;
 					if (action === "recheck") {
 						patch(target.key, {
@@ -1069,7 +1193,7 @@ window.__ModuleLoader__.load({
 								outcome: null,
 								failure: refreshed
 							});
-							await reload();
+							await reload(false);
 							return;
 						}
 						patch(target.key, {
@@ -1084,21 +1208,27 @@ window.__ModuleLoader__.load({
 				}, [
 					getCall,
 					patch,
-					reload
+					reload,
+					batchBlocked
 				])
 			};
 		}
 		/** 标题右侧两件：「检查更新」一次查七家 ＋ 「全部更新」按顺序串行装（吃 `useUpdateRows` 的表）。
 		*
-		* 禁用形状（#925 第 2 条）：任一行 installing 时两件都点不得；人话沿用 `update-busy` 原句
+		* 禁用形状（#925 第 2 条 ＋ #980 检查中）：任一行 installing、一键串行中或检查轮未收尾时两件都点不得；人话沿用 `update-busy` 原句
 		* （挂在 title 上，按钮文本仍是动作名）。题头不汇总排队数：串行进度只在各行自己显示。
 		*/
 		function CheckUpdateButton(props) {
 			const { checking, updatingAll, checkAll, updateAll, targets, rows } = props.face;
-			const busy = hasInstallingRow(rows) || updatingAll;
-			const checkDisabled = checking || updatingAll || busy || targets.length === 0;
-			const allDisabled = checking || updatingAll || busy || targets.length === 0;
+			const blocked = shouldBlockBatchStart({
+				hasInstallingRow: hasInstallingRow(rows),
+				updatingAll,
+				checking
+			});
+			const checkDisabled = blocked || targets.length === 0;
+			const allDisabled = blocked || targets.length === 0;
 			const busyText = reasonText("update-busy");
+			const installingNow = hasInstallingRow(rows) || updatingAll;
 			return react.createElement("span", { style: PANEL_STYLE.actions }, react.createElement("button", {
 				type: "button",
 				style: checkDisabled ? {
@@ -1108,7 +1238,7 @@ window.__ModuleLoader__.load({
 				} : PANEL_STYLE.btn,
 				disabled: checkDisabled,
 				onClick: checkAll,
-				title: busy ? busyText : "检查总管与六家插件的版本"
+				title: blocked ? busyText : "检查总管与六家插件的版本"
 			}, checking ? "检查中…" : "检查更新"), react.createElement("button", {
 				type: "button",
 				style: allDisabled ? {
@@ -1118,8 +1248,8 @@ window.__ModuleLoader__.load({
 				} : PANEL_STYLE.btn,
 				disabled: allDisabled,
 				onClick: updateAll,
-				title: busy ? busyText : "按顺序逐家装上更新（一家收尾才起下一家）"
-			}, updatingAll ? "更新中…" : "全部更新"));
+				title: blocked ? busyText : "按顺序逐家装上更新（一家收尾才起下一家）"
+			}, installingNow ? "更新中…" : "全部更新"));
 		}
 		/** 待重启横幅：一行总账，只点名哪几家要重启（理由与做法写在各家卡片上，见 `restartBannerText`）。 */
 		function RestartBanners(props) {
@@ -1142,7 +1272,7 @@ window.__ModuleLoader__.load({
 		* 手工命令只在「装不了」或「装失败」的行显示：正常用户用不到，摊在每行上既吵又误导。
 		*/
 		function UpdateResults(props) {
-			const { targets, rows, loadError, checking, updatingAll, open, close } = props.face;
+			const { targets, rows, loadError, checking, updatingAll, open, close, showProgress } = props.face;
 			const dialogRef = react.useRef(null);
 			react.useEffect(() => {
 				if (open) dialogRef.current?.focus();
@@ -1151,7 +1281,12 @@ window.__ModuleLoader__.load({
 			if (loadError) return react.createElement("div", { style: PANEL_STYLE.reason }, "更新能力没接上：" + loadError);
 			if (targets.length === 0) return null;
 			if (shown.length === 0 && !open) return null;
-			const locked = hasInstallingRow(rows) || updatingAll;
+			const locked = shouldBlockBatchStart({
+				hasInstallingRow: hasInstallingRow(rows),
+				updatingAll,
+				checking
+			});
+			const installingNow = hasInstallingRow(rows) || updatingAll;
 			const body = shown.map((target) => {
 				const row = rows[target.key];
 				const snapshot = row.outcome?.snapshot ?? null;
@@ -1207,7 +1342,16 @@ window.__ModuleLoader__.load({
 					style: PANEL_STYLE.skill
 				}, 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", {
+			const progressStrip = !open && (locked || shown.length > 0) ? react.createElement("div", { style: PANEL_STYLE.banner }, installingNow ? "有更新正在安装：关掉对话框不会中断。" : checking ? "正在检查更新，稍候。" : "上次检查的结果还在，直接打开看。", react.createElement("button", {
+				type: "button",
+				style: {
+					...PANEL_STYLE.btn,
+					marginLeft: 8
+				},
+				onClick: () => showProgress()
+			}, "查看进度")) : null;
+			const dialogNote = installingNow ? "安装在后台继续：关掉这块不会中断它。点「查看进度」可随时重新打开。" : checking ? "正在检查更新：关掉这块不会中断它，查完点「查看进度」看结果。" : "安装在宿主后台继续：关掉这块不会中断它。再点「检查更新」看最新进度。";
+			return react.createElement("div", null, react.createElement(RestartBanners, { face: props.face }), progressStrip, open ? react.createElement("div", {
 				style: PANEL_STYLE.overlay,
 				role: "presentation",
 				onClick: () => close()
@@ -1227,7 +1371,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 }, dialogNote)))) : null);
 		}
 		/** 缺席卡：**按两处独立事实分三态**，每态只给能改变状态的动作。
 		*
@@ -1245,7 +1389,11 @@ window.__ModuleLoader__.load({
 			const target = props.target;
 			const row = target ? props.face.rows[target.key] : null;
 			const busy = row?.phase === "installing";
-			const locked = busy || hasInstallingRow(props.face.rows) || props.face.updatingAll;
+			const locked = shouldBlockBatchStart({
+				hasInstallingRow: hasInstallingRow(props.face.rows),
+				updatingAll: props.face.updatingAll,
+				checking: props.face.checking
+			});
 			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);