dsh-life-pack 0.2.0 → 0.2.1

package/dist/client.js

@@ -85,6 +85,616 @@ window.__ModuleLoader__.load({
 				hint: "未安装[" + tab.plugin + "]，请补装后使用：" + installCmd
 			};
 		}
+		/** 面板右上角两个入口：星（去本仓点 star）＋ 气泡（去本仓开 issue）。
+		*
+		* 两处都指本仓 FeatherHunter/ilife——这是 map #671 裁定过的（「星与气泡指向哪个仓」
+		* 一问：反馈要落在本仓的需求池，「引流到作者其他技能」是底部那张卡的事）。
+		* 三件并排里的第三件「检查更新」住隔壁票（#678），本表不管它。
+		*/
+		const PANEL_LINKS = [{
+			key: "star",
+			glyph: "⭐",
+			tip: "去 GitHub 点 Star",
+			url: "https://github.com/FeatherHunter/ilife"
+		}, {
+			key: "feedback",
+			glyph: "💬",
+			tip: "反馈问题",
+			url: "https://github.com/FeatherHunter/ilife/issues/new"
+		}];
+		/** 「作者其他插件」四行：包名 ＋ 一句说明 ＋ 仓库地址。
+		*
+		* 文案口径（用户 2026-09-18 拍板）：**不写数字**——数字会过期（用户截图里的「34 款」实测已到 38 款），
+		* 写错最伤推荐位的可信度；第一行也不用 deck 自己面板里的自指「本面板自己」，改成不自指的说法。
+		* 只收真实存在的仓库，网址已逐个验真。第一行的说明描述的是 deck 那个包（工程技能面板），不是爱生活面板。
+		*/
+		const MORE_PLUGINS = [
+			{
+				pkg: "dsh-mattpocock-skills-deck",
+				desc: "工程技能面板：装好就能在右侧直接用",
+				url: "https://github.com/FeatherHunter/dsh-mattpocock-skills-deck"
+			},
+			{
+				pkg: "dsh-opencode-palette",
+				desc: "多款长时间编程护眼配色，一键换上",
+				url: "https://github.com/FeatherHunter/dsh-opencode-palette"
+			},
+			{
+				pkg: "dsh-prompt",
+				desc: "常用提示模板随手点，不用来回复制粘贴",
+				url: "https://github.com/FeatherHunter/dsh-prompt"
+			},
+			{
+				pkg: "dsh-im-companion",
+				desc: "聊天机器人的伴侣插件：扫码或填凭据就把飞书、微信等聊天接进来",
+				url: "https://github.com/FeatherHunter/dsh-im-companion"
+			}
+		];
+		//#endregion
+		//#region src/update-contract.ts
+		/** 载体：宿主注册 `connection.fetch.register` 的路径 / 面板 `connection.rpc.call` 的两段参数。 */
+		const MANAGER_RPC = {
+			/** 单段通道名，须 match `/^\/[A-Za-z0-9._~-]+$/`（cookbook §6）。 */
+			channel: "/ilife-manager",
+			/** 面板侧第二段参数（等于注册路径去掉 `/api` 前缀后那一段）。 */
+			endpoint: "ilife-manager",
+			/** 宿主侧注册的完整路径（`/api` 是 DSH 公开载体）。 */
+			path: "/api/ilife-manager"
+		};
+		/** 总管自有电话名：更新包的三个动作名是冻结集合（`config.ts:14`），这里另起名字不撞车。 */
+		const MANAGER_ACTIONS = {
+			/** 装上缺席的目标包：入参 `{packageName, version}`，回包 `{packageName, version}`。 */
+			install: "ilife-manager.install",
+			/** 七个更新目标的表：入参 `{}`，回包 `{targets: [{key, title, packageName, phones, runningVersion, installedVersion, skill}]}`。
+			*
+			* 电话名为什么由宿主转交而不是面板侧写死：更新包的三个电话名只有它自己知道
+			* （`update.phoneNames`，`host.ts:335`）；面板侧既不能 import 更新包（浏览器产物纯度门）
+			* 也不该把名字再写一份（写两份必然走散）。宿主把名字表连同版本行一起交出去，
+			* 面板一行字面量都不留。 */
+			targets: "ilife-manager.targets"
+		};
+		/** 装不了 / 装不成的人话原因表：八种 `blockedReason` ＋ 过程错误码（更新包 README 第 8、12 节）。 */
+		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": "安装没跑成：按下面那条手工命令在终端执行一次。",
+			"bad-request": "回执异常（请求形状不对）：把宿主日志里的事件名报给作者。",
+			internal: "回执异常（总管内部错误）：把宿主日志里的事件名报给作者。"
+		};
+		/** 原因码 → 人话（认不出的码不猜、原样回码并说明这是未知原因）。 */
+		function reasonText(code) {
+			return REASON_TEXT[code] ?? "未知原因（" + code + "）：把宿主日志里的事件名报给作者。";
+		}
+		//#endregion
+		//#region src/update-client.ts
+		/** 面板到宿主的三条流程（纯异步函数：无 DOM、无 react；传输口由调用方注入，便于单测）。
+		*
+		* 三条流程与更新包 README 的对应关系：
+		* - 检查更新：`updateCheck`（第 3 节第 3 步的 `host.call(UPD_CHECK, {})`）；
+		* - 装上更新：`updateCheck` 拿凭证 → `updateInstall` 提交 → **按间隔轮询 `updateStatus`**
+		*   直到任务离开 `installing`/`verifying`（第 3 节第 3 步与第 9 节：安装是后台跑，
+		*   调用方不干等；凭证过期 `check-expired` 是正常错误码，重查一次再提交，见第 11 节）；
+		* - 装上缺席的包：走总管自有的 `ilife-manager.install`（更新包的三个电话只管已装的包）。
+		*/
+		/** 轮询上限：1 秒一次、最多 900 次（覆盖更新包 15 分钟的安装时限）。 */
+		const MAX_POLL_TRIES = 900;
+		/** 轮询默认间隔（只有在宿主没给 `pollMs` 时才用；正常取值由宿主转交更新包的 panelPollMs）。 */
+		const FALLBACK_POLL_MS = 1e3;
+		let requestSeq = 0;
+		function failure(code, details = {}, manual = null) {
+			return {
+				ok: false,
+				code,
+				message: reasonText(code),
+				details,
+				manual
+			};
+		}
+		/** 取数间隔：settle 即清 timer。定时器有界重试的例外依据（p10 静态门三件套）：
+		* 这里有清理（clearTimeout）、有次数上限（MAX_POLL_TRIES）、间隔取自宿主转交的更新包
+		* `panelPollMs`（不写死）；用途是更新包 README 第 3 节要求的状态轮询（安装是后台跑，
+		* 面板每秒问一次进度），不是无界重试。 */
+		function sleep(ms) {
+			return new Promise((resolve) => {
+				const timer = setTimeout(() => {
+					clearTimeout(timer);
+					resolve();
+				}, ms);
+			});
+		}
+		async function callManager(call, method, payload) {
+			if (typeof call !== "function") return failure("internal", { detail: "宿主连接缺席：connection.rpc.call 不可用" });
+			let result;
+			try {
+				result = await call(MANAGER_RPC.channel, MANAGER_RPC.endpoint, {
+					method,
+					payload
+				});
+			} catch (error) {
+				return failure("check-failed", { detail: String(error?.message ?? error) });
+			}
+			if (!result || typeof result !== "object" || typeof result.ok !== "boolean") return failure("internal", { detail: "回执信封异常（非 ok 信封）" });
+			if (result.ok) return {
+				ok: true,
+				value: result.value
+			};
+			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) {
+			const out = await callManager(call, MANAGER_ACTIONS.targets, {});
+			if (!out.ok) return out;
+			return {
+				ok: true,
+				value: {
+					targets: Array.isArray(out.value?.targets) ? out.value.targets : [],
+					pollMs: typeof out.value?.pollMs === "number" && out.value.pollMs > 0 ? out.value.pollMs : FALLBACK_POLL_MS
+				}
+			};
+		}
+		/** 查一家：默认查新版（`updateCheck`，顺带回最新版本与凭证）；给 `phoneName` 时查那个电话。 */
+		async function checkTarget(call, target, phoneName) {
+			const name = phoneName ?? target.phones?.check;
+			if (!target.phones || !name) return failure("bad-request", { target: target.key });
+			return callManager(call, name, {});
+		}
+		/** 装上缺席的包：版本取自查新版拿到的「最新版本」（宿主用更新包的执行器真装）。 */
+		async function installAbsent(call, target, version) {
+			return callManager(call, MANAGER_ACTIONS.install, {
+				packageName: target.packageName,
+				version
+			});
+		}
+		/** 装上更新：查新版 → 提交安装 → 有界轮询查状态到任务收尾；凭证过期重查一次再提交。 */
+		async function updateInstalled(call, target, pollMs) {
+			if (!target.phones) return failure("bad-request", { target: target.key });
+			const first = await checkTarget(call, target);
+			if (!first.ok) return first;
+			let checked = first.value;
+			if (!checked.receipt) return failure(checked.snapshot.blockedReason ?? "check-failed", { target: target.key }, checked.manual);
+			requestSeq += 1;
+			const requestId = "ilife-manager-" + Date.now().toString(36) + "-" + String(requestSeq);
+			let submitted = await callManager(call, target.phones.install, {
+				checkId: checked.receipt.checkId,
+				requestId
+			});
+			if (!submitted.ok && submitted.code === "check-expired") {
+				const again = await checkTarget(call, target);
+				if (!again.ok) return again;
+				checked = again.value;
+				if (!checked.receipt) return failure(checked.snapshot.blockedReason ?? "check-failed", { target: target.key }, checked.manual);
+				submitted = await callManager(call, target.phones.install, {
+					checkId: checked.receipt.checkId,
+					requestId: requestId + "r"
+				});
+			}
+			if (!submitted.ok) return {
+				...submitted,
+				manual: submitted.manual ?? checked.manual
+			};
+			let latest = submitted.value;
+			const interval = pollMs > 0 ? pollMs : FALLBACK_POLL_MS;
+			for (let tries = 0;; tries += 1) {
+				const job = latest.snapshot.job;
+				if (job === null || job.state !== "installing" && job.state !== "verifying") break;
+				if (tries >= MAX_POLL_TRIES) break;
+				await sleep(interval);
+				const status = await checkTarget(call, target, target.phones.status);
+				if (!status.ok) return status;
+				latest = status.value;
+			}
+			return {
+				ok: true,
+				value: latest
+			};
+		}
+		//#endregion
+		//#region src/update-view.ts
+		/** 缺席：宿主启动时没装、现在磁盘上也没有（`runningVersion`/`installedVersion` 都是 null）。 */
+		function isAbsent(target) {
+			return target.runningVersion === null && target.installedVersion === null;
+		}
+		/** 把快照翻成一行结论：还没查 / 已是最新 / 有新版 / 装不了（附人话原因）。 */
+		function verdictOf(target, snapshot) {
+			const absent = isAbsent(target);
+			const latest = snapshot.latestVersion;
+			if (absent && latest === null) return {
+				kind: "unknown",
+				text: "未安装；点「检查更新」查最新版本后装上。",
+				action: null
+			};
+			if (absent) return {
+				kind: "update-available",
+				text: "未安装；最新版本 " + String(latest) + "。",
+				action: "install"
+			};
+			if (snapshot.blockedReason !== null) {
+				const blocked = snapshot.blockedReason;
+				if (blocked === "pending-restart") return {
+					kind: "blocked",
+					text: reasonText(blocked),
+					action: null
+				};
+				return {
+					kind: "blocked",
+					text: reasonText(blocked),
+					action: null
+				};
+			}
+			if (latest === null) return {
+				kind: "unknown",
+				text: "还没查过最新版本；点「检查更新」。",
+				action: null
+			};
+			if (snapshot.canInstall) return {
+				kind: "update-available",
+				text: "有新版：" + String(latest) + "，点「装上更新」。",
+				action: "update"
+			};
+			return {
+				kind: "up-to-date",
+				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 + "，重启宿主后生效。";
+		}
+		/** 版本行两行文字：插件包（本家） ＋ 技能包（随插件，不单独查更新）。 */
+		function versionLines(target, snapshot) {
+			const running = snapshot?.runningVersion ?? target.runningVersion ?? "unknown";
+			const installed = snapshot?.installedVersion ?? target.installedVersion;
+			const lines = [target.packageName + " " + running + (installed && installed !== running ? "（磁盘已装 " + installed + "）" : "")];
+			if (target.skill) lines.push(target.skill.packageName + " " + target.skill.version + "（随插件，不单独查更新）");
+			else lines.push("技能包随插件（不单独查更新）");
+			return lines;
+		}
+		//#endregion
+		//#region src/update-panel.ts
+		/** 爱生活面板的更新界面：检查更新按钮、七家结果行、待重启横幅、缺席卡的「装上」。
+		*
+		* 面板侧纪律（沿 `client.ts` 既有口径）：React.createElement 手写（禁 JSX）、内联 style、
+		* 颜色走 DSH 主题别名（深浅主题自适应，写死值只做回退）、只用 `dsh-ctx` 镜像内的上下文成员、
+		* 不 import 更新包（电话名与轮询间隔由宿主转交，见 `update-contract.ts` 的 `MANAGER_ACTIONS.targets`）。
+		*
+		* 视觉对照（用户给的第二张截图，参照实现 `dsh-mattpocock-skills-deck/src/client/views/SettingsPage.js:152-168`）：
+		* 标题右侧并排若干件——本文件出「检查更新」一件，隔壁票（爱生活面板头部与底部）在同一个
+		* `actions` 容器里补星与气泡两件，故这里把容器单独留出来。
+		*/
+		/** 面板视觉（沿用总管既有语言：内联 style，主题别名带回退）。 */
+		const PANEL_STYLE = {
+			head: {
+				fontSize: 15,
+				fontWeight: 700,
+				margin: "2px 0 8px",
+				color: "var(--dsw-alias-label-primary, inherit)"
+			},
+			headRow: {
+				display: "flex",
+				alignItems: "center",
+				justifyContent: "space-between",
+				gap: 8,
+				flexWrap: "wrap"
+			},
+			actions: {
+				display: "inline-flex",
+				alignItems: "center",
+				gap: 6
+			},
+			meta: {
+				color: "var(--dsw-alias-label-secondary, #9a9a9a)",
+				fontSize: 12,
+				lineHeight: 1.7,
+				marginBottom: 10
+			},
+			tablist: {
+				display: "flex",
+				flexWrap: "wrap",
+				gap: 6,
+				marginBottom: 10
+			},
+			tab: {
+				border: "1px solid var(--dsw-alias-border, rgba(128,128,128,.35))",
+				background: "transparent",
+				color: "var(--dsw-alias-label-primary, inherit)",
+				borderRadius: 999,
+				padding: "4px 12px",
+				fontSize: 13,
+				cursor: "pointer"
+			},
+			tabActive: {
+				background: "var(--dsw-alias-brand-primary, #0a84ff)",
+				borderColor: "transparent",
+				color: "#fff",
+				fontWeight: 700
+			},
+			reco: {
+				padding: "12px 14px",
+				borderRadius: 10,
+				border: "1px dashed var(--dsw-alias-border, rgba(128,128,128,.45))",
+				color: "var(--dsw-alias-label-secondary, #9a9a9a)",
+				fontSize: 13,
+				lineHeight: 1.7
+			},
+			cmd: {
+				display: "block",
+				marginTop: 8,
+				padding: "8px 10px",
+				borderRadius: 8,
+				background: "var(--dsw-alias-bg-base, rgba(128,128,128,.12))",
+				color: "var(--dsw-alias-label-primary, inherit)",
+				fontFamily: "ui-monospace, SFMono-Regular, Menlo, monospace",
+				fontSize: 12,
+				userSelect: "all"
+			},
+			btn: {
+				border: "1px solid var(--dsw-alias-border, rgba(128,128,128,.35))",
+				background: "transparent",
+				color: "var(--dsw-alias-label-primary, inherit)",
+				borderRadius: 8,
+				padding: "4px 12px",
+				fontSize: 13,
+				cursor: "pointer"
+			},
+			banner: {
+				padding: "10px 12px",
+				marginBottom: 10,
+				borderRadius: 8,
+				border: "1px solid var(--dsw-alias-state-warning-primary, #d8a300)",
+				background: "var(--dsw-alias-bg-base, rgba(216,163,0,.12))",
+				color: "var(--dsw-alias-label-primary, inherit)",
+				fontSize: 13,
+				lineHeight: 1.7
+			},
+			row: {
+				padding: "10px 12px",
+				marginBottom: 8,
+				borderRadius: 10,
+				border: "1px solid var(--dsw-alias-border, rgba(128,128,128,.3))",
+				fontSize: 13,
+				lineHeight: 1.7
+			},
+			rowHead: {
+				fontWeight: 700,
+				marginBottom: 2
+			},
+			rowMeta: {
+				color: "var(--dsw-alias-label-secondary, #9a9a9a)",
+				fontSize: 12
+			},
+			reason: {
+				color: "var(--dsw-alias-state-error-primary, #ff6b6b)",
+				fontSize: 12,
+				marginTop: 4
+			},
+			skill: {
+				color: "var(--dsw-alias-label-tertiary, #8a8a8a)",
+				fontSize: 12,
+				marginTop: 4
+			}
+		};
+		const IDLE = {
+			phase: "idle",
+			outcome: null,
+			failure: null
+		};
+		/** 面板的更新状态源：挂载时取七个目标的表，之后按需查／装（组件与按钮共用一个 face）。 */
+		function useUpdateRows(getCall) {
+			const [targets, setTargets] = react.useState([]);
+			const [rows, setRows] = react.useState({});
+			const [pollMs, setPollMs] = react.useState(1e3);
+			const [loadError, setLoadError] = react.useState(null);
+			const [checking, setChecking] = react.useState(false);
+			react.useEffect(() => {
+				let alive = true;
+				(async () => {
+					const loaded = await loadTargets(getCall());
+					if (!alive) return;
+					if (loaded.ok) {
+						setTargets(loaded.value.targets);
+						setPollMs(loaded.value.pollMs);
+					} else setLoadError(loaded.message);
+				})();
+				return () => {
+					alive = false;
+				};
+			}, [getCall]);
+			const patch = react.useCallback((key, next) => {
+				setRows((previous) => ({
+					...previous,
+					[key]: next
+				}));
+			}, []);
+			return {
+				targets,
+				rows,
+				pollMs,
+				loadError,
+				checking,
+				checkAll: react.useCallback(() => {
+					setChecking(true);
+					const list = targets;
+					for (const target of list) patch(target.key, {
+						phase: "checking",
+						outcome: rows[target.key]?.outcome ?? null,
+						failure: null
+					});
+					Promise.all(list.map(async (target) => {
+						const result = await checkTarget(getCall(), target);
+						patch(target.key, result.ok ? {
+							phase: "ready",
+							outcome: result.value,
+							failure: null
+						} : {
+							phase: "failed",
+							outcome: null,
+							failure: result
+						});
+					})).finally(() => setChecking(false));
+				}, [
+					getCall,
+					patch,
+					rows,
+					targets
+				]),
+				act: react.useCallback((target) => {
+					const current = rows[target.key] ?? IDLE;
+					patch(target.key, {
+						...current,
+						phase: "installing",
+						failure: null
+					});
+					(async () => {
+						const absent = isAbsent(target);
+						let version = current.outcome?.snapshot.latestVersion ?? null;
+						if (absent && version === null) {
+							const checked = await checkTarget(getCall(), target);
+							if (!checked.ok) {
+								patch(target.key, {
+									phase: "failed",
+									outcome: null,
+									failure: checked
+								});
+								return;
+							}
+							patch(target.key, {
+								phase: "installing",
+								outcome: checked.value,
+								failure: null
+							});
+							version = checked.value.snapshot.latestVersion;
+						}
+						const result = absent ? await installAbsent(getCall(), target, version ?? "") : await updateInstalled(getCall(), target, pollMs);
+						if (result.ok) {
+							const refreshed = await checkTarget(getCall(), target, target.phones?.status);
+							patch(target.key, refreshed.ok ? {
+								phase: "ready",
+								outcome: refreshed.value,
+								failure: null
+							} : {
+								phase: "failed",
+								outcome: null,
+								failure: refreshed
+							});
+							return;
+						}
+						patch(target.key, {
+							phase: "failed",
+							outcome: current.outcome,
+							failure: {
+								...result,
+								manual: result.manual ?? current.outcome?.manual ?? null
+							}
+						});
+					})();
+				}, [
+					getCall,
+					patch,
+					pollMs,
+					rows
+				])
+			};
+		}
+		/** 标题右侧的「检查更新」：一个按钮一次查七家（吃 `useUpdateRows` 的表）。 */
+		function CheckUpdateButton(props) {
+			const { checking, checkAll, targets } = props.face;
+			const disabled = checking || targets.length === 0;
+			return react.createElement("button", {
+				type: "button",
+				style: disabled ? {
+					...PANEL_STYLE.btn,
+					opacity: .55,
+					cursor: "default"
+				} : PANEL_STYLE.btn,
+				disabled,
+				onClick: checkAll,
+				title: "一次查七家（总管自己 ＋ 六个单品）的插件包版本"
+			}, checking ? "检查中…" : "检查更新");
+		}
+		/** 待重启横幅：任何一家成 `pending-restart` 就常驻显示，重启宿主后自动消失（更新包 README 第 10 节）。 */
+		function RestartBanners(props) {
+			const lines = [];
+			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 (lines.length === 0) return null;
+			return react.createElement("div", { style: PANEL_STYLE.banner }, lines.map((line, index) => react.createElement("div", { key: String(index) }, line)));
+		}
+		/** 七家结果行：一家一行（版本行两行、结论一句、按钮一个、装不了给原因与手工命令）。 */
+		function UpdateResults(props) {
+			const { targets, rows, loadError, checking } = props.face;
+			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 (targets.length === 0) return null;
+			if (shown.length === 0) return null;
+			return react.createElement("div", null, react.createElement(RestartBanners, { face: props.face }), shown.map((target) => {
+				const row = rows[target.key];
+				const snapshot = row.outcome?.snapshot ?? null;
+				const verdict = snapshot ? verdictOf(target, snapshot) : null;
+				const manual = row.failure?.manual ?? row.outcome?.manual ?? null;
+				const busy = row.phase === "installing";
+				return react.createElement("div", {
+					key: target.key,
+					style: PANEL_STYLE.row
+				}, react.createElement("div", { style: PANEL_STYLE.rowHead }, target.title + " · " + target.packageName), react.createElement("div", { style: PANEL_STYLE.rowMeta }, "当前 " + String(snapshot?.runningVersion ?? target.runningVersion ?? "未安装") + " · 最新 " + String(snapshot?.latestVersion ?? "未查")), react.createElement("div", null, busy ? "正在装，请稍候…" : verdict?.text ?? (checking ? "检查中…" : "")), verdict?.action ? react.createElement("button", {
+					type: "button",
+					style: busy ? {
+						...PANEL_STYLE.btn,
+						opacity: .55
+					} : {
+						...PANEL_STYLE.btn,
+						marginTop: 6
+					},
+					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", {
+					key: String(index),
+					style: PANEL_STYLE.skill
+				}, line)), manual ? react.createElement("code", { style: PANEL_STYLE.cmd }, manual) : null);
+			}));
+		}
+		/** 缺席卡：一句人话 ＋「装上」按钮（复制命令降为辅助展示）；总管缺席时不显示此卡（面板也看不到）。 */
+		function AbsentCard(props) {
+			const target = props.target;
+			const row = target ? props.face.rows[target.key] : null;
+			const busy = row?.phase === "installing";
+			const manual = row?.failure?.manual ?? row?.outcome?.manual ?? props.fallbackCommand;
+			let reason = row?.failure?.message ?? null;
+			if (target && reason === null && row?.outcome && row.outcome.snapshot.blockedReason !== null) reason = verdictOf(target, row.outcome.snapshot).text;
+			return react.createElement("div", { style: PANEL_STYLE.reco }, react.createElement("div", null, target ? "未安装[" + target.packageName + "]，装上后这个页签就能用了。" : "这个页签对应的插件还没装。"), target ? react.createElement("button", {
+				type: "button",
+				style: busy ? {
+					...PANEL_STYLE.btn,
+					marginTop: 8,
+					opacity: .55
+				} : {
+					...PANEL_STYLE.btn,
+					marginTop: 8
+				},
+				disabled: busy,
+				onClick: () => props.face.act(target)
+			}, busy ? "正在装，请稍候…" : "装上") : null, reason ? react.createElement("div", { style: PANEL_STYLE.reason }, reason) : null, react.createElement("code", { style: PANEL_STYLE.cmd }, manual));
+		}
 		//#endregion
 		//#region src/client.ts
 		/** dsh-life-pack client 适配器（六边形：browser 侧；爱生活单卡方案）。
@@ -93,33 +703,205 @@ window.__ModuleLoader__.load({
 		* - 本文件经 tsdown 打成 loader 工厂包（browser/CJS + 注册包裹），classic 执行
 		*   只注册，副作用全在 factory 内；传递闭包禁 node 内建与 ESM 语法（回路
 		*   test/client-bundle-48.test.mjs 看门）。
-		* - inject 短名 ['slots']（总管机制范围无 RPC，不声明 connection，不碰 sidebar）；
-		*   apply 只注册一处 DSH设置面板槽（kind list，id 必填）。
+		* - inject 短名 ['slots','connection']：本包现在有 RPC（装与更新的能力由宿主半提供，
+		*   电话名与轮询间隔由宿主转交，面板不写死），读了 ctx.connection 就必须声明 'connection'（#48 血例）。
 		* - 爱生活页签条走 slot 驱动（settings-plugins 先例，禁纯 useState 手画 tab）：
 		*   section 声明 children 爱生活页签槽，各技能往里注册自家技能设置页；
 		*   tab 行从 ledger 投影（entries+getVersion+subscribe），面板用 props.renderSlot
 		*   按 `{only}` 投影（一次只挂载一个）+ visited 缓存；ledger 无某技能=缺席，
 		*   显示推荐安装只读文本（不返空冒充）。
 		* - 组件 React.createElement 手写（禁 JSX），无数据轮询、无 document/window/process。
+		* - 面板外壳两处（票 #679）：标题行右上角两个入口（星／气泡，悬停出说明文字，
+		*   窄窗口折到标题下方）；页签面板之后是底部「作者其他插件」引流卡（四行，点开新窗口）。
+		*   文案与网址都取自 nav.ts 的两张静态表，本文件只画不算。
 		*/
-		const inject = ["slots"];
+		const inject = ["slots", "connection"];
 		/** 爱生活页签槽（总管声明的 children，技能设置页注册进来；单段名，避开官方 settings.* 前缀）。 */
 		const CONFIG_TAB_SLOT = "ilife.config-tab";
+		/** 总管视觉（内联 style；颜色走 DSH 主题别名，深浅主题自适应，写死值只做回退；与技能面板同语言）。 */
+		const S = {
+			headRow: {
+				display: "flex",
+				flexWrap: "wrap",
+				alignItems: "center",
+				gap: 8,
+				margin: "2px 0 8px"
+			},
+			head: {
+				fontSize: 15,
+				fontWeight: 700,
+				flex: "0 0 auto",
+				color: "var(--dsw-alias-label-primary, inherit)"
+			},
+			headActions: {
+				display: "inline-flex",
+				alignItems: "center",
+				gap: 2,
+				marginLeft: "auto",
+				flex: "0 0 auto"
+			},
+			iconLink: {
+				display: "inline-flex",
+				alignItems: "center",
+				justifyContent: "center",
+				width: 26,
+				height: 26,
+				borderRadius: 6,
+				border: "1px solid transparent",
+				color: "var(--dsw-alias-label-primary, inherit)",
+				textDecoration: "none",
+				fontSize: 14,
+				lineHeight: 1
+			},
+			meta: {
+				color: "var(--dsw-alias-label-secondary, #9a9a9a)",
+				fontSize: 12,
+				lineHeight: 1.7,
+				marginBottom: 10
+			},
+			tablist: {
+				display: "flex",
+				flexWrap: "wrap",
+				gap: 6,
+				marginBottom: 10
+			},
+			tab: {
+				border: "1px solid var(--dsw-alias-border, rgba(128,128,128,.35))",
+				background: "transparent",
+				color: "var(--dsw-alias-label-primary, inherit)",
+				borderRadius: 999,
+				padding: "4px 12px",
+				fontSize: 13,
+				cursor: "pointer"
+			},
+			tabActive: {
+				background: "var(--dsw-alias-brand-primary, #0a84ff)",
+				borderColor: "transparent",
+				color: "#fff",
+				fontWeight: 700
+			},
+			reco: {
+				padding: "12px 14px",
+				borderRadius: 10,
+				border: "1px dashed var(--dsw-alias-border, rgba(128,128,128,.45))",
+				color: "var(--dsw-alias-label-secondary, #9a9a9a)",
+				fontSize: 13,
+				lineHeight: 1.7
+			},
+			cmd: {
+				display: "block",
+				marginTop: 8,
+				padding: "8px 10px",
+				borderRadius: 8,
+				background: "var(--dsw-alias-bg-base, rgba(128,128,128,.12))",
+				color: "var(--dsw-alias-label-primary, inherit)",
+				fontFamily: "ui-monospace, SFMono-Regular, Menlo, monospace",
+				fontSize: 12,
+				userSelect: "all"
+			},
+			moreCard: {
+				marginTop: 16,
+				padding: "10px 12px",
+				borderRadius: 10,
+				border: "1px solid var(--dsw-alias-border, rgba(128,128,128,.35))"
+			},
+			moreTitle: {
+				fontSize: 13,
+				fontWeight: 700,
+				marginBottom: 4,
+				color: "var(--dsw-alias-label-primary, inherit)"
+			},
+			moreRow: {
+				display: "flex",
+				flexWrap: "wrap",
+				alignItems: "center",
+				gap: "2px 8px",
+				padding: "7px 4px",
+				textDecoration: "none",
+				color: "inherit"
+			},
+			morePkg: {
+				flex: "0 1 auto",
+				minWidth: 0,
+				overflowWrap: "anywhere",
+				fontFamily: "ui-monospace, SFMono-Regular, Menlo, monospace",
+				fontSize: 12,
+				fontWeight: 650
+			},
+			moreDesc: {
+				flex: "1 1 180px",
+				minWidth: 0,
+				fontSize: 11.5,
+				lineHeight: 1.6,
+				color: "var(--dsw-alias-label-secondary, #9a9a9a)"
+			},
+			moreIcon: {
+				flex: "0 0 auto",
+				marginLeft: "auto",
+				display: "inline-flex",
+				color: "var(--dsw-alias-label-secondary, #9a9a9a)"
+			}
+		};
+		/** 缺席卡的画法与流程住 `update-panel.ts`（票 #678：一句人话 ＋「装上」按钮 ＋ 可复制命令），
+		*  `recoFor` 的补装命令仍是卡里那条辅助展示（B11 口径不变）。 */
 		/** 标签解析（resolveSlotLabel 同形：thunk 跟活，无则空字串；见 slots lib:27-29）。 */
 		function resolveLabel(label) {
 			if (typeof label === "function") return label();
 			return label ?? "";
 		}
-		/** 缺席文案（grill 定案 Q2/Q5：调不通=没装；只读文本，不做假导航）。 */
-		function absentHint(tab) {
-			return recoFor(tab).hint;
+		/** 外链图标（行尾那个；纯装饰，语义在链接自己的 aria-label／文字上）。 */
+		function ExternalIcon() {
+			return react.createElement("svg", {
+				viewBox: "0 0 24 24",
+				width: 13,
+				height: 13,
+				fill: "none",
+				stroke: "currentColor",
+				strokeWidth: 1.9,
+				strokeLinecap: "round",
+				strokeLinejoin: "round",
+				"aria-hidden": "true",
+				focusable: "false"
+			}, react.createElement("path", { d: "M13.5 4.5H19.5V10.5" }), react.createElement("path", { d: "M19.5 4.5L11 13" }), react.createElement("path", { d: "M18 14.5V18A2 2 0 0 1 16 20H6A2 2 0 0 1 4 18V8A2 2 0 0 1 6 6H9.5" }));
+		}
+		/** 标题行右上角两件：星（去本仓点 Star）＋ 气泡（去本仓开 issue），悬停出说明文字。
+		*
+		* 三件并排里的第三件「检查更新」住隔壁票（#678）：本票只留位子——它就接在本组件之前，
+		* 不画一个点了没反应的假按钮。窄窗口靠 headRow 的 flexWrap 折到标题下方，
+		* 标题与两件都是 flex:'0 0 auto'，谁也不挤谁。
+		*/
+		function PanelActions() {
+			return react.createElement("div", { style: S.headActions }, PANEL_LINKS.map((link) => react.createElement("a", {
+				key: link.key,
+				href: link.url,
+				target: "_blank",
+				rel: "noreferrer",
+				title: link.tip,
+				"aria-label": link.tip,
+				style: S.iconLink
+			}, react.createElement("span", { "aria-hidden": "true" }, link.glyph))));
 		}
-		/** 爱生活面板：总设置区 + 爱生活页签条（slot 驱动）+ 技能设置页投影/缺席文案。 */
+		/** 底部「作者其他插件」引流卡：四行（包名 ＋ 一句说明 ＋ 行尾外链图标），点开新窗口。
+		*
+		* 卡片在页签面板之后，六页签切换它都在（它不属于任何一个页签）。
+		*/
+		function MorePluginsCard() {
+			return react.createElement("div", { style: S.moreCard }, react.createElement("div", { style: S.moreTitle }, "作者其他插件"), MORE_PLUGINS.map((row) => react.createElement("a", {
+				key: row.pkg,
+				href: row.url,
+				target: "_blank",
+				rel: "noreferrer",
+				title: row.pkg + " 的 GitHub 仓库",
+				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)))));
+		}
+		/** 爱生活面板：总设置区 ＋ 检查更新（七家）＋ 爱生活页签条（slot 驱动）＋ 技能设置页投影/缺席卡。 */
 		function LifePackSection(props) {
 			const tabsId = react.useId();
 			const tabRefs = react.useRef([]);
 			const rows = props.useTabs((value) => value);
 			const present = new Set(rows.map((r) => r.id));
+			const face = useUpdateRows(props.getCall);
 			const [activeId, setActiveId] = react.useState(void 0);
 			const [visitedIds, setVisitedIds] = react.useState(() => /* @__PURE__ */ new Set());
 			const active = MANAGER_TABS.some((t) => t.plugin === activeId) ? activeId : MANAGER_TABS[0].plugin;
@@ -133,6 +915,9 @@ window.__ModuleLoader__.load({
 				const row = rows.find((r) => r.id === tab.plugin);
 				return row && row.label.length > 0 ? row.label : tab.title;
 			}
+			function targetForTab(tab) {
+				return face.targets.find((t) => t.packageName === tab.plugin) ?? null;
+			}
 			function onTabKeyDown(event, index) {
 				let nextIndex;
 				switch (event.key) {
@@ -155,9 +940,10 @@ window.__ModuleLoader__.load({
 				setActiveId(next.plugin);
 				tabRefs.current[nextIndex]?.focus();
 			}
-			return react.createElement("div", null, react.createElement("h2", null, "爱生活"), react.createElement("div", null, react.createElement("div", null, "总开关 · 开关（缺省启用，只读）"), react.createElement("div", null, "总管 dsh-life-pack · 0.2.0")), react.createElement("div", {
+			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.1")), react.createElement(UpdateResults, { face }), react.createElement("div", {
 				role: "tablist",
-				"aria-label": "爱生活技能页签"
+				"aria-label": "爱生活技能页签",
+				style: S.tablist
 			}, MANAGER_TABS.map((tab, index) => {
 				const selected = tab.plugin === active;
 				return react.createElement("button", {
@@ -171,13 +957,17 @@ window.__ModuleLoader__.load({
 					"aria-selected": selected,
 					"aria-controls": tabsId + "-panel-" + tab.plugin,
 					tabIndex: selected ? 0 : -1,
+					style: selected ? {
+						...S.tab,
+						...S.tabActive
+					} : S.tab,
 					onClick: () => {
 						setActiveId(tab.plugin);
 					},
 					onKeyDown: (event) => {
 						onTabKeyDown(event, index);
 					}
-				}, labelFor(tab));
+				}, (present.has(tab.plugin) ? "● " : "○ ") + labelFor(tab));
 			})), MANAGER_TABS.filter((tab) => tab.plugin === active || visitedIds.has(tab.plugin)).map((tab) => {
 				const selected = tab.plugin === active;
 				return react.createElement("div", {
@@ -186,10 +976,15 @@ window.__ModuleLoader__.load({
 					role: "tabpanel",
 					"aria-labelledby": tabsId + "-tab-" + tab.plugin,
 					hidden: !selected
-				}, present.has(tab.plugin) ? props.renderSlot(CONFIG_TAB_SLOT, {}, { only: tab.plugin }) : absentHint(tab));
-			}));
+				}, present.has(tab.plugin) ? props.renderSlot(CONFIG_TAB_SLOT, {}, { only: tab.plugin }) : react.createElement(AbsentCard, {
+					target: targetForTab(tab),
+					fallbackCommand: recoFor(tab).installCmd,
+					face
+				}));
+			}), react.createElement(MorePluginsCard, null));
 		}
 		function apply(ctx) {
+			const getCall = () => ctx.connection?.rpc?.call ?? null;
 			let tabsVersion = -1;
 			let tabs = [];
 			const sectionInjected = () => ({ hooks: { tabs: {
@@ -217,7 +1012,10 @@ window.__ModuleLoader__.load({
 					kind: "list",
 					scope: "root"
 				} }
-			}, LifePackSection));
+			}, (props) => react.createElement(LifePackSection, {
+				...props,
+				getCall
+			})));
 		}
 		//#endregion
 		exports.CONFIG_TAB_SLOT = CONFIG_TAB_SLOT;