@huaqiu/dsh-tool-plugin-update 0.6.6 → 0.6.8

package/lib/client.js

@@ -375,6 +375,108 @@ window.__ModuleLoader__.load({
 			}
 			return null;
 		}
+		/** Phases after which a job never runs again — polling stops and a result view
+		*  replaces the active-job view. */
+		const TERMINAL_PHASES = /* @__PURE__ */ new Set([
+			"done",
+			"failed",
+			"rolled-back",
+			"abandoned"
+		]);
+		const PHASE_VALUES = /* @__PURE__ */ new Set([
+			"queued",
+			"resolving",
+			"downloading",
+			"verifying",
+			"staging",
+			"activating",
+			"awaiting-host",
+			"restarting",
+			"verifying-after-restart",
+			"done",
+			"failed",
+			"rolled-back",
+			"abandoned"
+		]);
+		function asFiniteNumber(value) {
+			return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+		}
+		/** Defensively normalize one job payload from the wire into {@link UpdateJob}.
+		*  Unknown/older servers may omit fields; a malformed `phase` falls back to
+		*  `queued` rather than crashing the view. */
+		function normalizeJob(raw) {
+			if (raw === null || typeof raw !== "object") return null;
+			const r = raw;
+			if (typeof r.id !== "string" || r.id.length === 0) return null;
+			const phase = typeof r.phase === "string" && PHASE_VALUES.has(r.phase) ? r.phase : "queued";
+			const progressRaw = r.progress ?? {};
+			const percentRaw = asFiniteNumber(progressRaw.percent);
+			const progress = { percent: percentRaw === void 0 ? null : Math.min(100, Math.max(0, percentRaw)) };
+			const bytesDone = asFiniteNumber(progressRaw.bytesDone);
+			const bytesTotal = asFiniteNumber(progressRaw.bytesTotal);
+			const bytesPerSecond = asFiniteNumber(progressRaw.bytesPerSecond);
+			const etaSeconds = asFiniteNumber(progressRaw.etaSeconds);
+			if (bytesDone !== void 0) progress.bytesDone = bytesDone;
+			if (bytesTotal !== void 0) progress.bytesTotal = bytesTotal;
+			if (bytesPerSecond !== void 0) progress.bytesPerSecond = bytesPerSecond;
+			if (etaSeconds !== void 0) progress.etaSeconds = etaSeconds;
+			const job = {
+				id: r.id,
+				kind: r.kind === "runtime" ? "runtime" : "plugin-set",
+				targetVersion: typeof r.targetVersion === "string" ? r.targetVersion : "",
+				previousVersion: typeof r.previousVersion === "string" ? r.previousVersion : null,
+				startedAt: typeof r.startedAt === "string" ? r.startedAt : "",
+				updatedAt: typeof r.updatedAt === "string" ? r.updatedAt : "",
+				phase,
+				progress
+			};
+			if (typeof r.message === "string" && r.message.length > 0) job.message = r.message;
+			if (typeof r.logHint === "string" && r.logHint.length > 0) job.logHint = r.logHint;
+			if (Array.isArray(r.steps)) {
+				const steps = [];
+				for (const entry of r.steps) {
+					if (entry === null || typeof entry !== "object") continue;
+					const s = entry;
+					if (typeof s.name !== "string") continue;
+					const state = s.state === "running" || s.state === "installed" || s.state === "skipped" || s.state === "failed" ? s.state : "pending";
+					const step = {
+						name: s.name,
+						state
+					};
+					const pct = asFiniteNumber(s.percent);
+					if (pct !== void 0) step.percent = pct;
+					if (typeof s.message === "string" && s.message.length > 0) step.message = s.message;
+					steps.push(step);
+				}
+				if (steps.length > 0) job.steps = steps;
+			}
+			if (r.result !== null && typeof r.result === "object") {
+				const res = r.result;
+				const result = {
+					ok: res.ok === true,
+					installedVersion: typeof res.installedVersion === "string" ? res.installedVersion : null,
+					rolledBack: res.rolledBack === true,
+					finishedAt: typeof res.finishedAt === "string" ? res.finishedAt : ""
+				};
+				if (typeof res.errorCode === "string" && res.errorCode.length > 0) result.errorCode = res.errorCode;
+				if (typeof res.message === "string" && res.message.length > 0) result.message = res.message;
+				job.result = result;
+			}
+			return job;
+		}
+		/** Normalize a `GET /status` payload; an empty/absent body degrades to "no
+		*  active job" rather than throwing. */
+		function normalizeJobStatus(raw) {
+			if (raw === null || typeof raw !== "object") return {
+				activeJob: null,
+				recentJobs: []
+			};
+			const r = raw;
+			return {
+				activeJob: normalizeJob(r.activeJob),
+				recentJobs: Array.isArray(r.recentJobs) ? r.recentJobs.map(normalizeJob).filter((j) => j !== null) : []
+			};
+		}
 		async function request(path, init) {
 			const res = await fetch(`${UPDATE_BASE}${path}`, {
 				cache: "no-store",
@@ -459,87 +561,221 @@ window.__ModuleLoader__.load({
 				body: JSON.stringify({ url })
 			});
 		}
-		const COPY = {
-			zh: {
-				entryLabel: "插件更新",
-				entryTooltip: "查看可用的插件更新",
-				viewTitle: "插件更新",
-				viewIntro: "检查并安装可用的插件更新",
-				viewInfo: "在这里查看插件集的更新。标注为「被阻止」的插件因主机或 HQ Edge 版本不兼容而无法安装；已是最新的插件无需操作。",
-				refresh: "刷新",
-				close: "关闭",
-				loading: "正在读取插件更新…",
-				empty: "没有可用的插件更新",
-				checkFailed: "检查更新失败，请重试",
-				installAll: (count) => `安装 ${count} 项更新`,
-				installOne: "安装",
-				installing: "正在安装…（DSH 将自动重启）",
-				nothingToInstall: "暂无可安装的更新",
-				ignore: "忽略此版本",
-				unignore: "恢复提醒",
-				ignoredOffer: "已忽略当前插件集更新",
-				groupCount: (count) => `${count} 个插件`,
-				group: {
-					actionable: "待处理",
-					blocked: "无法安装",
-					ignored: "已忽略",
-					current: "已是最新"
-				},
-				state: {
-					current: "当前",
-					update: "可更新",
-					install: "待安装",
-					ignored: "已忽略",
-					blocked: "被阻止"
-				},
-				blockedReason: {
-					host: "不适用于当前 EDA 主机",
-					"hq-edge-version": "当前 HQ Edge 版本不兼容",
-					"runtime-unknown": "HQ Edge 版本未知，无法校验"
-				},
-				runtime: {
-					title: "HQ Edge 运行时",
-					current: "当前版本",
-					latest: "最新版本",
-					set: "发布插件集",
-					checkedAt: "上次检查",
-					source: "更新源",
-					unknown: "版本未知",
-					notConfigured: "未配置更新源",
-					note: "运行时更新由 EDA 安装器处理",
-					update: "安装运行时更新",
-					updateConfirm: (version) => `安装 HQ Edge 运行时 ${version}？HQ Edge 会先关闭并完成替换，然后重新启动。`,
-					updating: "正在下载并校验运行时包，可能需要一分钟…",
-					updateAccepted: "运行时更新已受理，HQ Edge 正在重启…",
-					sourceHint: "运行时更新清单的下载地址，保存后立即生效",
-					sourceEdit: "修改",
-					sourceSave: "保存",
-					sourceReset: "恢复默认",
-					saved: "更新源已保存，正在重新检查更新…",
-					saveFailed: "保存更新源失败",
-					sourceInputLabel: "运行时更新清单地址",
-					sourcePlaceholder: "https://gitee.com/huaqiu-electronics/dsh-pcb-eda/raw/main/edge-headless-release-manifest.json"
+		/**
+		* GET the durable job status: the currently active job (if any) plus a bounded
+		* list of recent jobs. This is what the panel reads BEFORE running discovery
+		* on open, so an in-flight install/runtime update is resumed instead of
+		* forgotten. An older hq-edge without the status route 404s — callers catch
+		* that and degrade to "no active job".
+		*/
+		function fetchJobStatus() {
+			return request("/status").then(normalizeJobStatus);
+		}
+		//#endregion
+		//#region src/client/copy.ts
+		/**
+		* Localized copy for the plugin-update UI (browser half).
+		*
+		* zh is the fallback, matching the rest of the Huaqiu plugin family
+		* (`<html lang>` drives the resolution via the shared sidebar-entry locale
+		* helpers). The wording follows the shell's own plugin manager
+		* (`ui-plugin-manager/src/client/locales.ts`) so both read as one product.
+		*
+		* @module
+		*/
+		const zh = {
+			entryLabel: "插件更新",
+			entryTooltip: "查看可用的插件更新",
+			viewTitle: "插件更新",
+			viewIntro: "检查并安装可用的插件更新",
+			viewInfo: "在这里查看插件集的更新。标注为「被阻止」的插件因主机或 HQ Edge 版本不兼容而无法安装；已是最新的插件无需操作。",
+			refresh: "刷新",
+			close: "关闭",
+			loading: "正在读取插件更新…",
+			empty: "没有可用的插件更新",
+			checkFailed: "检查更新失败，请重试",
+			installAll: (count) => `安装整套更新（${count} 项）`,
+			installOne: "安装整套",
+			installOneTip: "将安装整套 N 项更新并自动重启 DSH，而不仅是此插件",
+			installing: "正在安装…（DSH 将自动重启）",
+			retry: "重试",
+			checkedAt: (when) => `上次检查：${when}`,
+			checkFailedBanner: (message) => `检查更新失败：${message}`,
+			staleNote: "以下为上次成功检查的结果，可能已过期",
+			nothingToInstall: "暂无可安装的更新",
+			ignore: "忽略此版本",
+			unignore: "恢复提醒",
+			ignoredOffer: "已忽略当前插件集更新",
+			groupCount: (count) => `${count} 个插件`,
+			group: {
+				actionable: "待处理",
+				blocked: "无法安装",
+				ignored: "已忽略",
+				current: "已是最新"
+			},
+			state: {
+				current: "当前",
+				update: "可更新",
+				install: "待安装",
+				ignored: "已忽略",
+				blocked: "被阻止"
+			},
+			blockedReason: {
+				host: "不适用于当前 EDA 主机",
+				"hq-edge-version": "当前 HQ Edge 版本不兼容",
+				"runtime-unknown": "HQ Edge 版本未知，无法校验"
+			},
+			runtime: {
+				title: "HQ Edge 运行时",
+				current: "当前版本",
+				latest: "最新版本",
+				set: "发布插件集",
+				checkedAt: "上次检查",
+				source: "更新源",
+				unknown: "版本未知",
+				notConfigured: "未配置更新源",
+				note: "运行时更新由 EDA 安装器处理",
+				sizeLabel: "包大小",
+				update: "安装运行时更新",
+				updateConfirm: (version) => `安装 HQ Edge 运行时 ${version}？HQ Edge 会先关闭并完成替换，然后重新启动。`,
+				updating: "正在下载并校验运行时包…",
+				durationNote: "耗时取决于下载速度与包体大小；运行时包较大，替换后 HQ Edge 会自动重启。",
+				updateAccepted: "运行时更新已受理，HQ Edge 正在重启…",
+				size: (bytes) => `约 ${formatMb(bytes)}`,
+				lastResult: {
+					title: "上次运行时更新结果",
+					succeeded: "运行时更新成功",
+					failed: "运行时更新失败",
+					rolledBack: "运行时更新已回滚（已恢复旧版本）",
+					elevation: "系统级安装可能弹出 UAC 提权窗口；拒绝提权会导致替换失败并自动回滚到旧版本。"
 				},
-				pluginSource: {
-					title: "插件更新源",
-					hint: "插件更新清单的下载地址，保存后立即生效",
-					edit: "修改",
-					save: "保存",
-					reset: "恢复默认",
-					saved: "更新源已保存，正在重新检查更新…",
-					saveFailed: "保存更新源失败",
-					inputLabel: "插件更新清单地址",
-					placeholder: "https://gitee.com/huaqiu-electronics/dsh-pcb-eda/raw/main/plugins-release-manifest.json"
+				sourceHint: "运行时更新清单的下载地址，保存后立即生效",
+				sourceEdit: "修改",
+				sourceSave: "保存",
+				sourceReset: "恢复默认",
+				saved: "更新源已保存，正在重新检查更新…",
+				saveFailed: "保存更新源失败",
+				sourceInputLabel: "运行时更新清单地址",
+				sourcePlaceholder: "https://gitee.com/huaqiu-electronics/dsh-pcb-eda/raw/main/edge-headless-release-manifest.json"
+			},
+			pluginSource: {
+				title: "插件更新源",
+				hint: "插件更新清单的下载地址，保存后立即生效",
+				edit: "修改",
+				save: "保存",
+				reset: "恢复默认",
+				saved: "更新源已保存，正在重新检查更新…",
+				saveFailed: "保存更新源失败",
+				inputLabel: "插件更新清单地址",
+				placeholder: "https://gitee.com/huaqiu-electronics/dsh-pcb-eda/raw/main/plugins-release-manifest.json"
+			},
+			originOverride: "自定义",
+			originConfig: "默认配置",
+			originUnset: "未配置",
+			lastError: "上次检查失败",
+			installError: "安装失败",
+			installSuccess: "更新已安装，正在重启 DSH…",
+			confirmInstall: "确认安装",
+			cancel: "取消",
+			job: {
+				kindPluginSet: "插件集更新",
+				kindRuntime: "HQ Edge 运行时更新",
+				phase: {
+					queued: "排队中",
+					resolving: "解析版本",
+					downloading: "下载中",
+					verifying: "校验完整性",
+					staging: "暂存文件",
+					activating: "启用插件集",
+					"awaiting-host": "等待主机替换运行时",
+					restarting: "正在重启",
+					"verifying-after-restart": "重启后校验",
+					done: "已完成",
+					failed: "失败",
+					"rolled-back": "已回滚",
+					abandoned: "已中断"
 				},
-				originOverride: "自定义",
-				originConfig: "默认配置",
-				originUnset: "未配置",
-				lastError: "上次检查失败",
-				installError: "安装失败",
-				installSuccess: "更新已安装，正在重启 DSH…",
-				confirmInstall: "确认安装",
-				cancel: "取消"
+				willRestartDsh: "完成后 DSH 将自动重启，更新本身会在后台继续。",
+				willSwapRuntime: "HQ Edge 会下载完整运行时包并退出，由 EDA 主机替换后重启；系统级安装可能弹出 UAC 提权窗口。",
+				closeNote: "关闭此面板不会取消更新。",
+				bytes: (done, total) => `${done} / ${total}`,
+				speed: (v) => `${v}/s`,
+				eta: (s) => `剩余约 ${s}`,
+				nextDone: "正在完成，请稍候…",
+				resultDone: "更新已完成",
+				resultFailed: "更新失败",
+				resultRolledBack: "更新已回滚",
+				resultAbandoned: "更新未完成",
+				retry: "重新尝试（发起新的更新）",
+				recentTitle: "最近更新",
+				stepsTitle: "各组件进度",
+				logHint: (hint) => `日志标识：${hint}`
+			},
+			release: {
+				summaryTitle: "版本说明",
+				notesLink: "查看发布说明",
+				breakingTitle: "破坏性变更",
+				changesTitle: "更新内容",
+				advanced: "高级：更新源",
+				publishedAt: (when) => `发布于 ${when}`
 			},
+			ui: {
+				title: "更新中心",
+				gearTooltip: "高级设置",
+				settingsTitle: "更新源配置 (高级)",
+				originDefault: "默认源",
+				originCustom: "自定义源",
+				pluginUrlLabel: "插件 Manifest URL",
+				runtimeUrlLabel: "运行时 Manifest URL",
+				saveAndRefresh: "保存并刷新",
+				checkedAgo: (ago) => `上次检查: ${ago}`,
+				checkedUnknown: "尚未检查更新",
+				agoJust: "刚刚",
+				agoMinutes: (n) => `${n} 分钟前`,
+				agoHours: (n) => `${n} 小时前`,
+				agoDays: (n) => `${n} 天前`,
+				jobPluginTitle: (v) => `正在升级全套插件 (v${v})`,
+				jobRuntimeTitle: (v) => `正在升级 HQ Edge 运行时 (v${v})`,
+				jobSteps: [
+					"下载",
+					"校验",
+					"替换",
+					"重启"
+				],
+				rollbackTitle: "上次 HQ Edge 运行时更新已自动回滚",
+				failedTitle: "上次 HQ Edge 运行时更新失败",
+				rollbackBody: (oldVer, code) => `系统已安全恢复至旧版本 (v${oldVer})。代码: ${code}`,
+				failedBody: (oldVer, code) => `未能完成运行时替换 (旧版本 v${oldVer})。代码: ${code}`,
+				dismiss: "忽略",
+				successInline: "上次运行时更新成功",
+				runtimeEngine: "HQ Edge 核心运行时",
+				currentChip: (v) => `v${v} (当前)`,
+				newVersion: (v) => `新版本 v${v} 可用`,
+				breakingTag: "关键修复",
+				sizeLine: (size, summary) => `体积: ${size}${summary ? ` · ${summary}` : ""}`,
+				upgradeCore: "升级核心",
+				runtimeRestartNote: "升级运行时需自动重启 KiCad 进程服务",
+				pendingTitle: "待更新插件",
+				allChangelog: "展开全部更新日志",
+				changelogBtn: "日志",
+				changelogTitle: "更新内容:",
+				blockedBadge: "无法安装",
+				footerCount: (n) => `准备安装 ${n} 项兼容插件`,
+				footerSet: (v) => `版本集: v${v}`,
+				installAllSet: (v) => `一键更新全套插件 (v${v})`,
+				ignoreBtn: "忽略",
+				footnote: "更新将自动应用并重启 DSH 视图，不影响 EDA 图纸数据"
+			}
+		};
+		/** Compact a byte count for display: "约 12.3 MB" / "约 480 MB". */
+		function formatMb(bytes) {
+			if (!Number.isFinite(bytes) || bytes <= 0) return "";
+			const mb = bytes / 1048576;
+			if (mb >= 100) return `${Math.round(mb)} MB`;
+			return `${mb.toFixed(1)} MB`;
+		}
+		const COPY = {
+			zh,
 			en: {
 				entryLabel: "Plugin Updates",
 				entryTooltip: "Review available plugin updates",
@@ -551,9 +787,14 @@ window.__ModuleLoader__.load({
 				loading: "Reading plugin updates…",
 				empty: "No plugin updates available",
 				checkFailed: "Failed to check for updates — please retry",
-				installAll: (count) => `Install ${count} update${count === 1 ? "" : "s"}`,
-				installOne: "Install",
+				installAll: (count) => `Install whole set (${count})`,
+				installOne: "Install set",
+				installOneTip: "Installs the whole set of N updates and restarts DSH — not just this plugin",
 				installing: "Installing… (DSH will restart)",
+				retry: "Retry",
+				checkedAt: (when) => `Last checked: ${when}`,
+				checkFailedBanner: (message) => `Update check failed: ${message}`,
+				staleNote: "Showing the last successful check — it may be stale",
 				nothingToInstall: "Nothing to install right now",
 				ignore: "Ignore this release",
 				unignore: "Show again",
@@ -587,10 +828,20 @@ window.__ModuleLoader__.load({
 					unknown: "Version unknown",
 					notConfigured: "No update source configured",
 					note: "Runtime updates are handled by the EDA installer",
+					sizeLabel: "Package size",
 					update: "Install runtime update",
 					updateConfirm: (version) => `Install HQ Edge runtime ${version}? HQ Edge shuts down to swap the runtime, then restarts.`,
-					updating: "Downloading and verifying the runtime bundle — this can take a minute…",
+					updating: "Downloading and verifying the runtime bundle…",
+					durationNote: "Duration depends on download speed and package size; the runtime bundle is large, and HQ Edge restarts after the swap.",
 					updateAccepted: "Runtime update accepted — HQ Edge is restarting…",
+					size: (bytes) => `~ ${formatMb(bytes)}`,
+					lastResult: {
+						title: "Last runtime update result",
+						succeeded: "Runtime update succeeded",
+						failed: "Runtime update failed",
+						rolledBack: "Runtime update rolled back (previous version restored)",
+						elevation: "A system-wide install may show a UAC elevation prompt; declining it fails the swap and rolls back to the previous version."
+					},
 					sourceHint: "Where the runtime update manifest is fetched from; saved changes take effect immediately",
 					sourceEdit: "Edit",
 					sourceSave: "Save",
@@ -618,7 +869,96 @@ window.__ModuleLoader__.load({
 				installError: "Install failed",
 				installSuccess: "Update installed — restarting DSH…",
 				confirmInstall: "Confirm install",
-				cancel: "Cancel"
+				cancel: "Cancel",
+				job: {
+					kindPluginSet: "Plugin-set update",
+					kindRuntime: "HQ Edge runtime update",
+					phase: {
+						queued: "Queued",
+						resolving: "Resolving version",
+						downloading: "Downloading",
+						verifying: "Verifying integrity",
+						staging: "Staging files",
+						activating: "Activating plugin set",
+						"awaiting-host": "Waiting for host to swap runtime",
+						restarting: "Restarting",
+						"verifying-after-restart": "Verifying after restart",
+						done: "Done",
+						failed: "Failed",
+						"rolled-back": "Rolled back",
+						abandoned: "Abandoned"
+					},
+					willRestartDsh: "DSH restarts automatically once this finishes; the update continues in the background.",
+					willSwapRuntime: "HQ Edge downloads the full runtime bundle and exits; the EDA host swaps and relaunches it. A system-wide install may show a UAC prompt.",
+					closeNote: "Closing this panel does not cancel the update.",
+					bytes: (done, total) => `${done} / ${total}`,
+					speed: (v) => `${v}/s`,
+					eta: (s) => `~${s} left`,
+					nextDone: "Finishing — please wait…",
+					resultDone: "Update completed",
+					resultFailed: "Update failed",
+					resultRolledBack: "Update rolled back",
+					resultAbandoned: "Update did not complete",
+					retry: "Retry (start a new update)",
+					recentTitle: "Recent updates",
+					stepsTitle: "Per-component progress",
+					logHint: (hint) => `Log id: ${hint}`
+				},
+				release: {
+					summaryTitle: "Release notes",
+					notesLink: "View release notes",
+					breakingTitle: "Breaking changes",
+					changesTitle: "What changed",
+					advanced: "Advanced: update sources",
+					publishedAt: (when) => `Published ${when}`
+				},
+				ui: {
+					title: "Update Center",
+					gearTooltip: "Advanced settings",
+					settingsTitle: "Update source (advanced)",
+					originDefault: "Default source",
+					originCustom: "Custom source",
+					pluginUrlLabel: "Plugin manifest URL",
+					runtimeUrlLabel: "Runtime manifest URL",
+					saveAndRefresh: "Save & refresh",
+					checkedAgo: (ago) => `Last checked: ${ago}`,
+					checkedUnknown: "No check yet",
+					agoJust: "just now",
+					agoMinutes: (n) => `${n} min ago`,
+					agoHours: (n) => `${n} h ago`,
+					agoDays: (n) => `${n} d ago`,
+					jobPluginTitle: (v) => `Updating plugin set (v${v})`,
+					jobRuntimeTitle: (v) => `Upgrading HQ Edge runtime (v${v})`,
+					jobSteps: [
+						"Download",
+						"Verify",
+						"Swap",
+						"Restart"
+					],
+					rollbackTitle: "Last HQ Edge runtime update rolled back automatically",
+					failedTitle: "Last HQ Edge runtime update failed",
+					rollbackBody: (oldVer, code) => `Safely restored to the previous version (v${oldVer}). Code: ${code}`,
+					failedBody: (oldVer, code) => `Runtime swap did not complete (old v${oldVer}). Code: ${code}`,
+					dismiss: "Dismiss",
+					successInline: "Last runtime update succeeded",
+					runtimeEngine: "HQ Core Runtime",
+					currentChip: (v) => `v${v} (current)`,
+					newVersion: (v) => `New v${v} available`,
+					breakingTag: "Critical fix",
+					sizeLine: (size, summary) => `Size: ${size}${summary ? ` · ${summary}` : ""}`,
+					upgradeCore: "Upgrade core",
+					runtimeRestartNote: "Upgrading the runtime restarts the KiCad process service",
+					pendingTitle: "Plugins to update",
+					allChangelog: "Expand all changelogs",
+					changelogBtn: "Log",
+					changelogTitle: "What changed:",
+					blockedBadge: "Cannot install",
+					footerCount: (n) => `Ready to install ${n} compatible plugin${n === 1 ? "" : "s"}`,
+					footerSet: (v) => `Set: v${v}`,
+					installAllSet: (v) => `Update all plugins (v${v})`,
+					ignoreBtn: "Ignore",
+					footnote: "Updates apply automatically and restart the DSH view — your EDA schematic data is untouched"
+				}
 			}
 		};
 		//#endregion
@@ -672,18 +1012,6 @@ window.__ModuleLoader__.load({
 		]);
 		/** The settled-state glyph (`IconCheckCircleFillRegular`). */
 		const CHECK_CIRCLE_ICON = (size = 16) => fillGlyph(size, ["M28.1936 14.6936L19.8066 23.0806C19.2373 23.65 18.7159 24.1742 18.24 24.5571C17.7389 24.9602 17.1365 25.3359 16.3657 25.458C15.9581 25.5225 15.5428 25.5225 15.1353 25.458C14.3645 25.3359 13.7621 24.9602 13.261 24.5571C12.7851 24.1742 12.2637 23.65 11.6943 23.0806L7.80737 19.1936L10.1936 16.8074L14.0806 20.6943C14.7033 21.317 15.0763 21.6873 15.377 21.9292C15.6523 22.1507 15.7109 22.1325 15.6626 22.1248C15.7208 22.1339 15.7802 22.1339 15.8384 22.1248C15.7901 22.1325 15.8486 22.1507 16.124 21.9292C16.4247 21.6873 16.7977 21.317 17.4204 20.6943L25.8074 12.3074L28.1936 14.6936Z", "M32.8496 18.0005C32.8496 9.79906 26.2019 3.15137 18.0005 3.15137C9.79906 3.15137 3.15137 9.79906 3.15137 18.0005C3.15137 26.2019 9.79906 32.8496 18.0005 32.8496C26.2019 32.8496 32.8496 26.2019 32.8496 18.0005ZM35.7764 18.0005C35.7764 27.8173 27.8173 35.7764 18.0005 35.7764C8.18363 35.7764 0.224609 27.8173 0.224609 18.0005C0.224609 8.18363 8.18363 0.224609 18.0005 0.224609C27.8173 0.224609 35.7764 8.18363 35.7764 18.0005Z"], "0 0 36 36");
-		/** The install action (`IconDownloadOutlineRegular`). */
-		const DOWNLOAD_ICON = (size = 16) => glyph(size, REGULAR, [
-			"M8 1.95317V10.0469",
-			"M4.25 6.29688L8 10.0469L11.75 6.29688",
-			"M1.5 10.0469V13.158C1.5 13.3937 1.60536 13.6198 1.79289 13.7865C1.98043 13.9532 2.23478 14.0469 2.5 14.0469H13.5C13.7652 14.0469 14.0196 13.9532 14.2071 13.7865C14.3946 13.6198 14.5 13.3937 14.5 13.158V10.0469"
-		]);
-		/** The head's info affordance (`IconInfoOutlineRegular`, fill-only artwork). */
-		const INFO_ICON = (size = 11) => fillGlyph(size, [
-			"M12.5757 7.00012C12.5757 3.92085 10.0794 1.42463 7.00012 1.42456C3.9208 1.42456 1.42456 3.9208 1.42456 7.00012C1.42463 10.0794 3.92085 12.5757 7.00012 12.5757C10.0793 12.5756 12.5756 10.0793 12.5757 7.00012ZM13.8002 7.00012C13.8001 10.7559 10.7559 13.8001 7.00012 13.8002C3.2443 13.8002 0.199291 10.7559 0.199219 7.00012C0.199219 3.24426 3.24426 0.199219 7.00012 0.199219C10.7559 0.199291 13.8002 3.2443 13.8002 7.00012Z",
-			"M7.6127 3.18921V4.55986H6.38735V3.18921H7.6127Z",
-			"M7.6127 5.68921V10.8109H6.38735V5.68921H7.6127Z"
-		], "0 0 14 14");
 		//#endregion
 		//#region src/client/update-view.ts
 		/**
@@ -737,33 +1065,6 @@ window.__ModuleLoader__.load({
 			if (Array.isArray(by)) return by.filter((entry) => typeof entry === "string");
 			return typeof by === "string" && by.length > 0 ? [by] : [];
 		}
-		/** The tag tone a state reads as, matching the shell's Tag palette. */
-		function stateTone(item) {
-			switch (item.state) {
-				case "update": return "info";
-				case "install": return "warning";
-				case "blocked": return "danger";
-				case "ignored": return "neutral";
-				case "current": return "success";
-			}
-		}
-		function stateLabel(item, copy) {
-			switch (item.state) {
-				case "current": return copy.state.current;
-				case "update": return copy.state.update;
-				case "install": return copy.state.install;
-				case "ignored": return copy.state.ignored;
-				case "blocked": return copy.state.blocked;
-			}
-		}
-		/** The one-line version transition under a card's title. */
-		function versionLine(item) {
-			switch (item.state) {
-				case "current": return item.currentVersion ?? item.availableVersion;
-				case "install": return item.availableVersion;
-				default: return item.currentVersion === null ? item.availableVersion : `${item.currentVersion} → ${item.availableVersion}`;
-			}
-		}
 		function blockedReason(item, copy) {
 			const by = blockedByList(item);
 			if (by.includes("host")) return copy.blockedReason.host;
@@ -771,55 +1072,93 @@ window.__ModuleLoader__.load({
 			if (by.includes("runtime-unknown")) return copy.blockedReason["runtime-unknown"];
 			return by.length > 0 ? by.join(", ") : void 0;
 		}
-		/** One package card: glyph, name with its state tag, version line, end actions. */
-		function packageCard(item, copy, installing, store) {
-			const card = el("li", "hqpu-card");
+		/** Two-letter avatar initials for a card (CJK-safe). */
+		function avatarInitials(item) {
+			const src = typeof item.displayName === "string" && item.displayName.trim().length > 0 ? item.displayName.trim() : shortName(item.name);
+			if (/[⺀-鿿]/.test(src)) return src.slice(0, 2);
+			const words = src.split(/[\s_\-./@]+/).filter(Boolean);
+			if (words.length >= 2) return (words[0][0] + words[1][0]).toUpperCase();
+			return src.replace(/^@/, "").slice(0, 2).toUpperCase();
+		}
+		/** Shared per-card changelog toggle drawer (the per-plugin changes[] list). */
+		function changelogDrawer(item, copy, open) {
+			const drawer = el("div", "hqpu-changelog-drawer");
+			drawer.style.display = open ? "" : "none";
+			drawer.append(el("div", "hqpu-changelog-drawer-title", copy.ui.changelogTitle));
+			const ul = el("ul");
+			for (const change of item.changes ?? []) if (typeof change === "string" && change.length > 0) ul.append(el("li", "", change));
+			drawer.append(ul);
+			return drawer;
+		}
+		/** One package card per the mockup: avatar initials, display name + package
+		*  subtitle, old→new version row (new in emerald), a 日志 toggle expanding the
+		*  inline changelog. Blocked/incompatible cards are dimmed with a rose
+		*  无法安装 badge and a reason line, and carry NO install button. */
+		function packageCard(item, copy, open, onToggle) {
+			const blocked = item.state === "blocked";
+			const card = el("li", blocked ? "hqpu-card hqpu-card--blocked" : "hqpu-card");
 			card.dataset.pluginName = item.name;
 			card.dataset.state = item.state;
-			card.title = `${item.name} · ${versionLine(item)}`;
 			const head = el("div", "hqpu-card-head");
-			const glyph = el("span", "hqpu-card-icon");
-			glyph.setAttribute("aria-hidden", "true");
-			glyph.innerHTML = PLUGIN_ICON(24);
+			const left = el("div");
+			const avatar = el("span", "hqpu-avatar", avatarInitials(item));
+			avatar.setAttribute("aria-hidden", "true");
 			const main = el("div", "hqpu-card-main");
-			const titleRow = el("div", "hqpu-title-row");
-			const title = el("span", "hqpu-card-title", shortName(item.name));
-			const tag = el("span", "hqpu-tag");
-			tag.dataset.tone = stateTone(item);
-			tag.textContent = stateLabel(item, copy);
-			titleRow.append(title, tag);
-			const desc = el("span", "hqpu-card-desc", versionLine(item));
-			main.append(titleRow, desc);
-			head.append(glyph, main);
-			const end = el("div", "hqpu-card-end");
-			if (item.state === "update" || item.state === "install") {
-				const button = el("button", "hqpu-btn hqpu-btn--sm hqpu-btn--primary");
-				button.type = "button";
-				button.disabled = installing;
-				button.innerHTML = `${DOWNLOAD_ICON(13)}<span>${copy.installOne}</span>`;
-				button.addEventListener("click", () => {
-					runInstall(store, copy);
-				});
-				end.append(button);
+			const titleText = typeof item.displayName === "string" && item.displayName.trim().length > 0 ? item.displayName.trim() : shortName(item.name);
+			main.append(el("span", "hqpu-card-title", titleText));
+			main.append(el("span", "hqpu-card-sub", shortName(item.name)));
+			const ver = el("div", "hqpu-version-row");
+			if (item.currentVersion !== null && item.currentVersion !== void 0) {
+				ver.append(el("span", "hqpu-ver-old", item.currentVersion));
+				ver.append(el("span", "hqpu-ver-arrow", "→"));
 			}
-			head.append(end);
+			const size = formatMb(item.sizeBytes ?? 0);
+			ver.append(el("span", "hqpu-ver-new", size.length > 0 ? `${item.availableVersion} (${size})` : item.availableVersion));
+			main.append(ver);
+			left.append(avatar, main);
+			const right = el("div", "hqpu-card-end");
+			if (blocked) right.append(el("span", "hqpu-blocked-badge", copy.ui.blockedBadge));
+			else if (Array.isArray(item.changes) && item.changes.length > 0) {
+				const toggle = el("button", "hqpu-log-toggle");
+				toggle.type = "button";
+				toggle.dataset.open = open ? "true" : "false";
+				toggle.innerHTML = `${copy.ui.changelogBtn}<svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.2" stroke-linecap="round" stroke-linejoin="round"><path d="M4 6L7.29289 9.29289C7.68342 9.68342 8.31658 9.68342 8.70711 9.29289L12 6"/></svg>`;
+				toggle.addEventListener("click", onToggle);
+				right.append(toggle);
+			}
+			head.append(left, right);
 			card.append(head);
-			if (item.state === "blocked") {
+			if (!blocked && Array.isArray(item.changes) && item.changes.length > 0) card.append(changelogDrawer(item, copy, open));
+			if (blocked) {
 				const reason = blockedReason(item, copy);
-				if (reason !== void 0) card.append(el("p", "hqpu-card-reason", reason));
+				const entries = [...reason !== void 0 ? [reason] : [], ...[...item.reasons ?? [], ...item.notes ?? []].filter((e) => typeof e === "string" && e.length > 0)];
+				for (const entry of entries) {
+					const line = el("p", "hqpu-reason-line");
+					line.innerHTML = `<svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.2" stroke-linecap="round" stroke-linejoin="round"><path d="M8 5V8.5M8 11.25h.01M14.5 8a6.5 6.5 0 11-13 0 6.5 6.5 0 0113 0Z"/></svg>`;
+					line.append(document.createTextNode(entry));
+					card.append(line);
+				}
 			}
 			return card;
 		}
-		/** A section: group head with its count, then the cards. */
-		function group(heading, items, copy, installing, store) {
+		/** A section: head (title + count pill + expand-all toggle) then its cards. */
+		function group(heading, items, copy, changelogOpen, allOpen, onToggle, onToggleAll) {
 			if (items.length === 0) return null;
 			const section = el("section", "hqpu-group");
 			section.dataset.group = heading;
-			const head = el("div", "hqpu-group-head");
-			head.append(el("h3", "hqpu-group-title", heading));
-			head.append(el("span", "hqpu-group-count", copy.groupCount(items.length)));
+			const head = el("div", "hqpu-section-head");
+			const titleWrap = el("div", "hqpu-section-title");
+			titleWrap.append(el("span", "", heading));
+			titleWrap.append(el("span", "hqpu-count-pill", String(items.length)));
+			head.append(titleWrap);
+			if (items.some((i) => i.state !== "blocked" && Array.isArray(i.changes) && i.changes.length > 0)) {
+				const all = el("button", "hqpu-all-changelog", copy.ui.allChangelog);
+				all.type = "button";
+				all.addEventListener("click", onToggleAll);
+				head.append(all);
+			}
 			const list = el("ul", "hqpu-cards");
-			for (const item of items) list.append(packageCard(item, copy, installing, store));
+			for (const item of items) list.append(packageCard(item, copy, allOpen || changelogOpen.has(item.name), () => onToggle(item.name)));
 			section.append(head, list);
 			return section;
 		}
@@ -859,6 +1198,234 @@ window.__ModuleLoader__.load({
 			section.setAttribute("aria-label", copy.loading);
 			return section;
 		}
+		/** Format a byte count for the progress line, or null when unknown. */
+		function formatBytes(n) {
+			if (n === void 0 || !Number.isFinite(n) || n < 0) return null;
+			if (n >= 1024 ** 3) return `${(n / 1024 ** 3).toFixed(1)} GB`;
+			if (n >= 1024 ** 2) return `${(n / 1024 ** 2).toFixed(1)} MB`;
+			if (n >= 1024) return `${(n / 1024).toFixed(0)} KB`;
+			return `${n} B`;
+		}
+		/** "上次检查: N 分钟前" — relative time from an ISO timestamp. */
+		function relativeAgo(iso, copy) {
+			if (typeof iso !== "string" || iso.length === 0) return null;
+			const then = new Date(iso).getTime();
+			if (!Number.isFinite(then)) return null;
+			const diffMin = Math.round((Date.now() - then) / 6e4);
+			if (diffMin < 1) return copy.ui.agoJust;
+			if (diffMin < 60) return copy.ui.agoMinutes(diffMin);
+			const hours = Math.round(diffMin / 60);
+			if (hours < 24) return copy.ui.agoHours(hours);
+			return copy.ui.agoDays(Math.round(hours / 24));
+		}
+		function jobKindLabel(job, copy) {
+			return job.kind === "runtime" ? copy.job.kindRuntime : copy.job.kindPluginSet;
+		}
+		/** The phase in human words, falling back to the raw code. */
+		function phaseLabel(job, copy) {
+			return copy.job.phase[job.phase] ?? job.phase;
+		}
+		/** One per-step line for plugin-set installs (and any job that reports steps). */
+		function stepsList(job, copy) {
+			if (!Array.isArray(job.steps) || job.steps.length === 0) return null;
+			const wrap = el("div", "hqpu-job-steps");
+			wrap.append(el("p", "hqpu-group-count", copy.job.stepsTitle));
+			const ol = el("ol", "hqpu-steps");
+			for (const step of job.steps) {
+				const li = el("li", `hqpu-step hqpu-step--${step.state}`);
+				const dot = el("span", "hqpu-dot");
+				dot.dataset.state = step.state === "installed" ? "done" : step.state === "failed" ? "error" : step.state === "running" ? "warning" : "idle";
+				li.append(dot);
+				const text = step.message && step.message.length > 0 ? `${step.name} — ${step.message}` : step.name;
+				li.append(el("span", "", text));
+				ol.append(li);
+			}
+			wrap.append(ol);
+			return wrap;
+		}
+		/** Map a job phase onto the 4-step indicator index (下载/校验/替换/重启). */
+		function stepIndex(phase) {
+			switch (phase) {
+				case "downloading": return 0;
+				case "verifying":
+				case "resolving": return 1;
+				case "staging":
+				case "activating":
+				case "awaiting-host": return 2;
+				case "restarting":
+				case "verifying-after-restart": return 3;
+				case "queued": return -1;
+				default: return -1;
+			}
+		}
+		/**
+		* The ACTIVE-JOB banner per the mockup: pulsing brand dot + job title with the
+		* target version, mono percentage, a gradient bar only when `percent != null`,
+		* phase + speed line ("3.1 MB/s (286MB / 450MB)"), and a 4-step indicator row
+		* (done=emerald, active=pulsing brand, upcoming=muted).
+		*/
+		function activeJobView(job, copy) {
+			const section = el("section", "hqpu-group");
+			section.dataset.group = "active-job";
+			const card = el("div", "hqpu-active");
+			const top = el("div", "hqpu-active-top");
+			const titleWrap = el("div", "hqpu-active-title");
+			const pulse = el("span", "hqpu-pulse-dot");
+			pulse.append(el("span", "hqpu-pulse-ring"));
+			const title = job.kind === "runtime" ? copy.ui.jobRuntimeTitle(job.targetVersion) : copy.ui.jobPluginTitle(job.targetVersion);
+			titleWrap.append(pulse, el("span", "", title));
+			const pct = job.progress.percent;
+			if (pct !== null) top.append(el("span", "hqpu-active-percent", `${Math.round(pct)}%`));
+			card.append(top);
+			if (pct !== null) {
+				const bar = el("div", "hqpu-progress");
+				const fill = el("div", "hqpu-progress-fill");
+				fill.style.width = `${Math.min(100, Math.max(0, pct))}%`;
+				bar.append(fill);
+				card.append(bar);
+			}
+			const meta = el("div", "hqpu-active-meta");
+			const phaseText = typeof job.message === "string" && job.message.length > 0 ? job.message : phaseLabel(job, copy);
+			meta.append(el("span", "", phaseText));
+			const speed = formatBytes(job.progress.bytesPerSecond);
+			const done = formatBytes(job.progress.bytesDone);
+			const total = formatBytes(job.progress.bytesTotal);
+			const telemetry = speed !== null && done !== null && total !== null ? `${speed}/s (${done} / ${total})` : speed !== null ? `${speed}/s` : done !== null && total !== null ? copy.job.bytes(done, total) : "";
+			if (telemetry.length > 0) meta.append(el("span", "", telemetry));
+			card.append(meta);
+			const transition = el("div", "hqpu-active-meta");
+			transition.append(el("span", "", job.previousVersion !== null && job.previousVersion.length > 0 ? `${job.previousVersion} → ${job.targetVersion}` : job.targetVersion));
+			transition.append(el("span", "", job.kind === "runtime" ? copy.job.willSwapRuntime : copy.job.willRestartDsh));
+			card.append(transition);
+			card.append(el("p", "hqpu-job-meta", copy.job.closeNote));
+			const current = stepIndex(job.phase);
+			const stepsRow = el("div", "hqpu-job-steps4");
+			copy.ui.jobSteps.forEach((label, index) => {
+				const cls = current === -1 ? "hqpu-job-step--todo" : index < current ? "hqpu-job-step--done" : index === current ? "hqpu-job-step--active" : "hqpu-job-step--todo";
+				stepsRow.append(el("div", cls, label));
+			});
+			card.append(stepsRow);
+			section.append(card);
+			return section;
+		}
+		/**
+		* The RESULT view for a terminal job: success / failed / rolled-back /
+		* abandoned, previous→installed, per-package steps, errorCode + message, a log
+		* correlation hint, and retry guidance (a retry starts a NEW job).
+		*/
+		function resultView(job, copy, onRetry) {
+			const section = el("section", "hqpu-group");
+			section.dataset.group = "job-result";
+			const tone = job.phase === "done" ? "success" : job.phase === "failed" ? "danger" : "warning";
+			const titleText = job.phase === "done" ? copy.job.resultDone : job.phase === "failed" ? copy.job.resultFailed : job.phase === "rolled-back" ? copy.job.resultRolledBack : copy.job.resultAbandoned;
+			const head = el("div", "hqpu-group-head");
+			const tag = el("span", "hqpu-tag");
+			tag.dataset.tone = tone;
+			tag.textContent = titleText;
+			head.append(el("h3", "hqpu-group-title", `${jobKindLabel(job, copy)} ${job.targetVersion}`), tag);
+			section.append(head);
+			const card = el("div", "hqpu-job");
+			const res = job.result;
+			const from = job.previousVersion ?? res?.installedVersion ?? "—";
+			const to = res?.installedVersion ?? job.targetVersion;
+			const finished = res !== void 0 && res.finishedAt.length > 0 ? ` · ${new Date(res.finishedAt).toLocaleString()}` : "";
+			card.append(el("p", "hqpu-status", `${from} → ${to}${finished}`));
+			if (res !== void 0 && res.message !== void 0 && res.message.length > 0) card.append(el("p", "hqpu-status", res.message));
+			if (res !== void 0 && res.errorCode !== void 0 && res.errorCode.length > 0) card.append(el("p", "hqpu-status", res.errorCode));
+			if (typeof job.logHint === "string" && job.logHint.length > 0) card.append(el("p", "hqpu-status hqpu-job-meta", copy.job.logHint(job.logHint)));
+			const steps = stepsList(job, copy);
+			if (steps !== null) card.append(steps);
+			if (job.phase === "failed" || job.phase === "abandoned") {
+				const retry = el("button", "hqpu-btn hqpu-btn--outline hqpu-btn--sm", copy.job.retry);
+				retry.type = "button";
+				retry.addEventListener("click", onRetry);
+				card.append(retry);
+			}
+			section.append(card);
+			return section;
+		}
+		/** A one-line row for older recent jobs (newest already shown as the card). */
+		function recentJobsList(jobs, copy) {
+			const older = jobs.slice(1, 5);
+			if (older.length === 0) return null;
+			const wrap = el("div", "hqpu-group");
+			wrap.dataset.group = "recent-jobs";
+			wrap.append(el("h3", "hqpu-group-count", copy.job.recentTitle));
+			const ul = el("ul", "hqpu-cards");
+			for (const job of older) {
+				const li = el("li", "hqpu-status");
+				const when = job.updatedAt.length > 0 ? ` · ${new Date(job.updatedAt).toLocaleString()}` : "";
+				li.textContent = `${jobKindLabel(job, copy)} ${job.targetVersion} · ${phaseLabel(job, copy)}${when}`;
+				ul.append(li);
+			}
+			wrap.append(ul);
+			return wrap;
+		}
+		/**
+		* Check-status banner: a FAILED check shows a clear error row + Retry (never
+		* the silent "no updates" empty state); a successful check shows the time;
+		* when a check failed but a prior report exists it is labelled stale.
+		*/
+		function checkBanner(report, copy, onRetry) {
+			const failed = typeof report.lastError === "string" && report.lastError.length > 0;
+			const checked = typeof report.checkedAt === "string" && report.checkedAt.length > 0;
+			if (!failed && !checked) return null;
+			const wrap = el("section", "hqpu-group");
+			wrap.dataset.group = "check-status";
+			if (failed) {
+				const banner = el("div", "hqpu-banner");
+				banner.dataset.tone = "danger";
+				banner.innerHTML = WARNING_ICON(14);
+				banner.append(el("span", "", copy.checkFailedBanner(report.lastError)));
+				wrap.append(banner);
+				if (report.items.length > 0) wrap.append(el("p", "hqpu-status", copy.staleNote));
+				const row = el("div", "hqpu-actions");
+				const retry = el("button", "hqpu-btn hqpu-btn--primary hqpu-btn--sm", copy.retry);
+				retry.type = "button";
+				retry.addEventListener("click", onRetry);
+				row.append(retry);
+				wrap.append(row);
+				return wrap;
+			}
+			wrap.append(el("p", "hqpu-status", copy.checkedAt(new Date(report.checkedAt).toLocaleString())));
+			return wrap;
+		}
+		/** Set-level release metadata (v2 manifest): summary, notes, breaking, link. */
+		function releaseHeader(release, copy) {
+			if (release === null || release === void 0) return null;
+			const notes = Array.isArray(release.notes) ? release.notes.filter((n) => typeof n === "string" && n.length > 0) : [];
+			const breaking = Array.isArray(release.breaking) ? release.breaking.filter((n) => typeof n === "string" && n.length > 0) : [];
+			if (!(typeof release.summary === "string" && release.summary.length > 0 || notes.length > 0 || breaking.length > 0 || typeof release.notesUrl === "string" || typeof release.publishedAt === "string")) return null;
+			const section = el("section", "hqpu-group");
+			section.dataset.group = "release";
+			section.append(el("h3", "hqpu-group-title", copy.release.summaryTitle));
+			if (typeof release.summary === "string" && release.summary.length > 0) section.append(el("p", "hqpu-status", release.summary));
+			if (typeof release.publishedAt === "string" && release.publishedAt.length > 0) section.append(el("p", "hqpu-status", copy.release.publishedAt(new Date(release.publishedAt).toLocaleString())));
+			if (release.requiresRestart === true) section.append(el("p", "hqpu-status", copy.job.willRestartDsh));
+			if (notes.length > 0) {
+				const ul = el("ul", "hqpu-release-notes");
+				for (const note of notes) ul.append(el("li", "", note));
+				section.append(ul);
+			}
+			if (breaking.length > 0) {
+				const banner = el("div", "hqpu-banner");
+				banner.dataset.tone = "danger";
+				banner.innerHTML = WARNING_ICON(14);
+				const inner = el("span");
+				inner.append(el("strong", "", `${copy.release.breakingTitle}: `));
+				inner.append(document.createTextNode(breaking.join(" · ")));
+				banner.append(inner);
+				section.append(banner);
+			}
+			if (typeof release.notesUrl === "string" && release.notesUrl.length > 0) {
+				const link = el("a", "hqpu-status hqpu-release-link", copy.release.notesLink);
+				link.href = release.notesUrl;
+				link.target = "_blank";
+				link.rel = "noreferrer";
+				section.append(link);
+			}
+			return section;
+		}
 		/**
 		* Normalize the report's `runtime.source` to the full shape.
 		*
@@ -877,29 +1444,6 @@ window.__ModuleLoader__.load({
 				override: candidate.override === true
 			};
 		}
-		/** The tag naming where the URL in effect came from. */
-		function originLabel(origin, copy) {
-			switch (origin) {
-				case "override": return copy.originOverride;
-				case "config": return copy.originConfig;
-				default: return copy.originUnset;
-			}
-		}
-		/** The 更新源 fact row: the URL in effect plus an origin tag. */
-		function sourceFactRow(facts, source, copy) {
-			const wrap = el("div");
-			wrap.append(el("dt", "", copy.runtime.source));
-			const dd = el("dd");
-			const line = el("div", "hqpu-source-line");
-			const code = el("code", "hqpu-source-url", source.url.length > 0 ? source.url : copy.runtime.notConfigured);
-			const tag = el("span", "hqpu-tag");
-			tag.dataset.tone = source.override ? "info" : source.origin === "config" ? "success" : "neutral";
-			tag.textContent = originLabel(source.origin, copy);
-			line.append(code, tag);
-			dd.append(line);
-			wrap.append(dd);
-			facts.append(wrap);
-		}
 		/** Pick the labels for one kind out of the copy table. */
 		function sourceLabels(copy, kind) {
 			return kind === "runtime" ? {
@@ -932,6 +1476,9 @@ window.__ModuleLoader__.load({
 			const labels = sourceLabels(copy, kind);
 			const block = el("div", `hqpu-source-editor hqpu-source-editor--${kind}`);
 			if (!actions.sourceEditing) {
+				const urlLine = el("p", "hqpu-source-current-url", source.url);
+				urlLine.style.cssText = "margin:2px 0 6px;font-size:9px;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;color:#a1a1aa;word-break:break-all;";
+				block.append(urlLine);
 				block.append(el("p", "hqpu-status hqpu-source-hint", labels.hint));
 				const edit = el("button", "hqpu-btn hqpu-btn--outline hqpu-btn--sm", labels.edit);
 				edit.type = "button";
@@ -986,109 +1533,119 @@ window.__ModuleLoader__.load({
 			return block;
 		}
 		/**
-		* The plugin release-manifest source, as its own group above the plugin
-		* groups: it says where the whole list comes from, so it belongs above the
-		* list rather than inside it. Absent on an older hq-edge (no `pluginSource`
-		* in the report) — then nothing is rendered at all.
+		* The host's own report of the last runtime swap. Rolled-back / failed renders
+		* as an AMBER alert card (title, old→new body, errorCode chip, 忽略 dismiss);
+		* succeeded renders as a subtle green inline line — not a loud banner. The
+		* plugin has NO log-open affordance, so "查看诊断日志" is omitted (never faked).
 		*/
-		function pluginSourceGroup(report, copy, actions) {
-			const source = normalizeSource(report.pluginSource);
-			if (source === null) return null;
+		function runtimeResultAlert(report, copy, dismissed, onDismiss) {
+			const lastResult = report.runtime.lastResult;
+			if (lastResult === null || lastResult === void 0) return null;
+			if (lastResult.state === "succeeded") {
+				const line = el("p", "hqpu-alert-green");
+				line.dataset.role = "runtime-success";
+				line.textContent = copy.ui.successInline;
+				return line;
+			}
+			if (dismissed) return null;
 			const section = el("section", "hqpu-group");
-			section.dataset.group = "plugin-source";
-			const head = el("div", "hqpu-group-head");
-			head.append(el("h3", "hqpu-group-title", copy.pluginSource.title));
-			section.append(head);
-			const facts = el("dl", "hqpu-facts");
-			sourceFactRow(facts, source, copy);
-			section.append(facts);
-			section.append(sourceEditor("plugin", source, copy, actions));
+			section.dataset.group = "runtime-alert";
+			const card = el("div", "hqpu-alert hqpu-alert--amber");
+			card.innerHTML = WARNING_ICON(14);
+			const body = el("div");
+			const title = el("div", "hqpu-alert-title");
+			title.textContent = lastResult.state === "failed" ? copy.ui.failedTitle : copy.ui.rollbackTitle;
+			body.append(title);
+			const oldVer = lastResult.installedVersion ?? lastResult.targetVersion ?? "—";
+			const code = typeof lastResult.errorCode === "string" && lastResult.errorCode.length > 0 ? lastResult.errorCode : "—";
+			lastResult.state === "failed" ? copy.ui.failedBody(oldVer, code) : copy.ui.rollbackBody(oldVer, code);
+			const bodyP = el("p", "hqpu-alert-body");
+			const textOnly = lastResult.state === "failed" ? copy.ui.failedBody(oldVer, "") : copy.ui.rollbackBody(oldVer, "");
+			bodyP.append(document.createTextNode(textOnly.replace(/\s*$/, "")));
+			if (typeof lastResult.errorCode === "string" && lastResult.errorCode.length > 0) {
+				bodyP.append(document.createTextNode(" "));
+				const chip = el("code", "", lastResult.errorCode);
+				bodyP.append(chip);
+			}
+			if (typeof lastResult.message === "string" && lastResult.message.length > 0) bodyP.append(el("br"), document.createTextNode(lastResult.message));
+			body.append(bodyP);
+			const actions = el("div", "hqpu-alert-actions");
+			const dismiss = el("button", "hqpu-alert-dismiss", copy.ui.dismiss);
+			dismiss.type = "button";
+			dismiss.addEventListener("click", onDismiss);
+			actions.append(dismiss);
+			body.append(actions);
+			card.append(body);
+			section.append(card);
 			return section;
 		}
-		/** The independent HQ Edge runtime report, as ruled fact rows. */
-		function runtimeGroup(report, copy, actions) {
-			const section = el("section", "hqpu-group");
-			section.dataset.group = "runtime";
-			const head = el("div", "hqpu-group-head");
-			head.append(el("h3", "hqpu-group-title", copy.runtime.title));
-			section.append(head);
-			const facts = el("dl", "hqpu-facts");
+		/** The HQ Edge runtime engine card per the mockup: current chip, "新版本 vY
+		*  可用" with a 关键修复 tag when breaking/notes exist, size+summary line, a
+		*  升级核心 button (existing arm→confirm flow), and the amber restart note. */
+		function runtimeEngineCard(report, copy, actions) {
 			const runtime = report.runtime;
 			const latestVersion = runtimeLatestVersion(runtime);
-			const row = (label, value, code = false) => {
-				const wrap = el("div");
-				wrap.append(el("dt", "", label));
-				const dd = el("dd");
-				if (code) {
-					const node = el("code", "", value);
-					dd.append(node);
-				} else dd.textContent = value;
-				wrap.append(dd);
-				facts.append(wrap);
-			};
-			const source = normalizeSource(runtime.source);
-			if (runtime.configured === false) {
-				if (source !== null) sourceFactRow(facts, source, copy);
-				else row(copy.runtime.source, copy.runtime.notConfigured);
-			} else {
-				row(copy.runtime.current, runtime.currentVersion ?? copy.runtime.unknown);
-				if (runtime.updateAvailable && latestVersion !== null) row(copy.runtime.latest, latestVersion);
-				if (report.manifestVersion !== null) row(copy.runtime.set, report.manifestVersion, true);
-				if (typeof runtime.checkedAt === "string" && runtime.checkedAt.length > 0) row(copy.runtime.checkedAt, new Date(runtime.checkedAt).toLocaleString());
-				if (source !== null) sourceFactRow(facts, source, copy);
-			}
-			section.append(facts);
-			if (source !== null) section.append(sourceEditor("runtime", source, copy, actions));
+			const card = el("section", "hqpu-engine");
+			card.dataset.group = "runtime";
+			const head = el("div", "hqpu-engine-head");
+			const titleWrap = el("div", "hqpu-engine-title");
+			titleWrap.innerHTML = `<svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.2" stroke-linecap="round" stroke-linejoin="round"><path d="M9.33333 2L4.66667 8H8L6.66667 14L11.33333 8H8L9.33333 2Z"/></svg>`;
+			titleWrap.append(el("span", "", copy.ui.runtimeEngine));
+			head.append(titleWrap);
+			if (typeof runtime.currentVersion === "string" && runtime.currentVersion.length > 0) head.append(el("span", "hqpu-chip", copy.ui.currentChip(runtime.currentVersion)));
+			card.append(head);
 			if (runtime.updateAvailable && latestVersion !== null) {
-				const row = el("div", "hqpu-actions hqpu-runtime-actions");
-				if (actions.accepted) {
-					const line = el("span", "hqpu-status hqpu-status--dot");
-					line.setAttribute("role", "status");
-					line.append(el("span", "hqpu-spinner"), el("span", "", copy.runtime.updateAccepted));
-					row.append(line);
-				} else if (actions.busy) {
-					const line = el("span", "hqpu-status hqpu-status--dot");
-					line.setAttribute("role", "status");
-					line.append(el("span", "hqpu-spinner"), el("span", "", copy.runtime.updating));
-					row.append(line);
-				} else if (actions.armed) {
-					row.append(el("p", "hqpu-status hqpu-runtime-confirm", copy.runtime.updateConfirm(latestVersion)));
-					const yes = el("button", "hqpu-btn hqpu-btn--primary hqpu-btn--sm", copy.confirmInstall);
+				const row = el("div", "hqpu-engine-update-row");
+				const left = el("div");
+				const newLine = el("div", "hqpu-engine-new-line");
+				newLine.append(el("span", "", copy.ui.newVersion(latestVersion)));
+				const latestEntry = runtime.latest;
+				if (Array.isArray(latestEntry?.breaking) && (latestEntry?.breaking?.length ?? 0) > 0 || Array.isArray(latestEntry?.notes) && (latestEntry?.notes?.length ?? 0) > 0) newLine.append(el("span", "hqpu-tag--brand", copy.ui.breakingTag));
+				left.append(newLine);
+				const size = typeof latestEntry?.sizeBytes === "number" ? formatMb(latestEntry.sizeBytes) : "";
+				const summary = typeof latestEntry?.summary === "string" ? latestEntry.summary : "";
+				if (size.length > 0 || summary.length > 0) left.append(el("p", "hqpu-engine-size", copy.ui.sizeLine(size, summary)));
+				row.append(left);
+				if (actions.accepted) row.append(el("span", "hqpu-status", copy.runtime.updateAccepted));
+				else if (actions.busy) row.append(el("span", "hqpu-status", copy.runtime.updating));
+				else if (actions.armed) {
+					const confirmWrap = el("div");
+					confirmWrap.append(el("p", "hqpu-status", copy.runtime.updateConfirm(latestVersion)));
+					const yes = el("button", "hqpu-btn hqpu-btn--engine", copy.confirmInstall);
 					yes.type = "button";
 					yes.dataset.runtimeConfirm = "";
 					yes.addEventListener("click", actions.onConfirm);
-					const no = el("button", "hqpu-btn hqpu-btn--outline hqpu-btn--sm", copy.cancel);
+					const no = el("button", "hqpu-btn hqpu-btn--engine", copy.cancel);
 					no.type = "button";
 					no.addEventListener("click", actions.onCancel);
-					row.append(yes, no);
+					confirmWrap.append(yes, no);
+					row.append(confirmWrap);
 				} else {
-					const start = el("button", "hqpu-btn hqpu-btn--primary hqpu-btn--sm");
+					const start = el("button", "hqpu-btn hqpu-btn--engine", copy.ui.upgradeCore);
 					start.type = "button";
 					start.dataset.runtimeUpdate = "";
-					start.innerHTML = `${DOWNLOAD_ICON(13)}<span>${copy.runtime.update}</span>`;
 					start.addEventListener("click", actions.onArm);
 					row.append(start);
 				}
-				section.append(row);
-			} else section.append(el("p", "hqpu-status", copy.runtime.note));
-			if (typeof runtime.lastError === "string" && runtime.lastError.length > 0) {
-				const line = el("p", "hqpu-status hqpu-status--dot");
-				line.setAttribute("role", "status");
-				const dot = el("span", "hqpu-dot");
-				dot.dataset.state = "error";
-				line.append(dot, el("span", "", `${copy.lastError}: ${runtime.lastError}`));
-				section.append(line);
-			}
-			return section;
+				card.append(row);
+				const note = el("p", "hqpu-engine-note");
+				note.innerHTML = `<svg xmlns="http://www.w3.org/2000/svg" width="10" height="10" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round" stroke-linejoin="round"><path d="M8 2.5L14 13H2L8 2.5Z"/></svg><span>${copy.ui.runtimeRestartNote}</span>`;
+				card.append(note);
+			} else if (typeof runtime.lastError === "string" && runtime.lastError.length > 0) card.append(el("p", "hqpu-status", `${copy.lastError}: ${runtime.lastError}`));
+			return card;
 		}
-		function renderList(section, report, copy, installing, store) {
+		function renderList(section, report, copy, changelogOpen, allOpen, onToggleCard, onToggleAll, onRetryCheck) {
 			section.textContent = "";
 			if (report === null) {
 				section.append(skeleton(copy));
 				return;
 			}
+			const banner = checkBanner(report, copy, onRetryCheck);
+			if (banner !== null) section.append(banner);
+			const release = releaseHeader(report.release, copy);
+			if (release !== null) section.append(release);
 			if (report.items.length === 0) {
-				section.append(el("div", "hqpu-empty", copy.empty));
+				if (typeof report.lastError !== "string" || report.lastError.length === 0) section.append(el("div", "hqpu-empty", copy.empty));
 				return;
 			}
 			const byState = (state) => report.items.filter((item) => item.state === state);
@@ -1099,23 +1656,19 @@ window.__ModuleLoader__.load({
 				[copy.group.current, byState("current")]
 			];
 			for (const [heading, items] of order) {
-				const node = group(heading, items, copy, installing, store);
+				const node = group(heading, items, copy, changelogOpen, allOpen, onToggleCard, onToggleAll);
 				if (node !== null) section.append(node);
 			}
 		}
-		function renderRuntime(section, report, copy, actions) {
-			section.textContent = "";
-			if (report === null) return;
-			section.append(runtimeGroup(report, copy, actions));
-		}
-		/** The plugin-source group, above the plugin groups. No-op without the field. */
-		function renderPluginSource(section, report, copy, actions) {
+		function renderRuntime(section, report, copy, actions, dismissedAlert, onDismissAlert) {
 			section.textContent = "";
 			if (report === null) return;
-			const node = pluginSourceGroup(report, copy, actions);
-			if (node !== null) section.append(node);
+			const alert = runtimeResultAlert(report, copy, dismissedAlert, onDismissAlert);
+			if (alert !== null) section.append(alert);
+			const engine = runtimeEngineCard(report, copy, actions);
+			if (engine !== null) section.append(engine);
 		}
-		/** Run the install transaction, then keep polling until the state settles. */
+		/** Run the install transaction (a new durable job), then let the store poll it. */
 		async function runInstall(store, copy) {
 			const report = store.report();
 			if (report === null) return;
@@ -1123,15 +1676,18 @@ window.__ModuleLoader__.load({
 				showToast(copy.checkFailed, "error");
 				return;
 			}
+			store.setInstalling(true);
 			try {
 				const result = await installSet(report.manifestVersion);
 				if (result.error !== void 0) {
+					store.setInstalling(false);
 					showToast(`${copy.installError}: ${result.error}`, "error");
 					return;
 				}
 				showToast(copy.installSuccess, "success");
-				pollUntilSettled(store);
+				store.fetchStatus();
 			} catch (err) {
+				store.setInstalling(false);
 				showToast(`${copy.installError}: ${err instanceof Error ? err.message : String(err)}`, "error");
 			}
 		}
@@ -1154,61 +1710,65 @@ window.__ModuleLoader__.load({
 				toastTimer = null;
 			}, TOAST_HOLD_MS);
 		}
-		function renderActions(bar, report, copy, store, installing) {
-			bar.textContent = "";
-			if (report === null) return;
-			if (installing) {
-				const line = el("span", "hqpu-status hqpu-status--dot");
-				const spinner = el("span", "hqpu-spinner");
-				line.append(spinner, el("span", "", copy.installing));
-				bar.append(line);
+		/**
+		* The collapsible "更新源配置 (高级)" panel (gear-toggled). It hosts the
+		* EXISTING plugin-source and runtime-source editors (POST /plugin-source,
+		* POST /runtime-source, save→check→refresh already wired). No new endpoints:
+		* if a manifest source has no data, that field is omitted rather than faked.
+		*/
+		function renderSettingsPanel(panel, report, copy, open, pluginActions, runtimeActions) {
+			panel.textContent = "";
+			panel.style.display = open ? "" : "none";
+			if (!open || report === null) return;
+			const row = el("div", "hqpu-settings-row");
+			row.append(el("div", "hqpu-settings-title", copy.ui.settingsTitle));
+			const pluginSource = normalizeSource(report.pluginSource);
+			const runtimeSource = normalizeSource(report.runtime.source);
+			const overridden = (pluginSource?.override ?? false) || (runtimeSource?.override ?? false);
+			const badge = el("span", "hqpu-origin-badge", overridden ? copy.ui.originCustom : copy.ui.originDefault);
+			badge.dataset.origin = overridden ? "override" : "config";
+			row.append(badge);
+			panel.append(row);
+			if (pluginSource !== null) {
+				panel.append(el("label", "", copy.ui.pluginUrlLabel));
+				panel.append(sourceEditor("plugin", pluginSource, copy, pluginActions));
+			}
+			if (runtimeSource !== null) {
+				panel.append(el("label", "", copy.ui.runtimeUrlLabel));
+				panel.append(sourceEditor("runtime", runtimeSource, copy, runtimeActions));
+			}
+		}
+		/**
+		* The sticky footer: left meta ("准备安装 N 项兼容插件" / "版本集: vX"), a
+		* full-width primary "一键更新全套插件 (vX)" (install = one durable job),
+		* a secondary 忽略 wired to the existing ignore/unignore affordance, and the
+		* footnote. The count EXCLUDES blocked / ignored / already-current entries.
+		*/
+		function renderFooter(footer, installBtn, ignoreBtn, countEl, setEl, report, copy, installing, store) {
+			if (report === null) {
+				countEl.textContent = "";
+				setEl.textContent = "";
+				installBtn.disabled = true;
+				ignoreBtn.style.display = "none";
 				return;
 			}
 			const actionable = report.items.filter((item) => item.state === "update" || item.state === "install").length;
 			const hasSet = report.manifestVersion !== null;
-			if (actionable === 0) bar.append(el("span", "hqpu-status", copy.nothingToInstall));
-			else {
-				const installBtn = el("button", "hqpu-btn hqpu-btn--primary");
-				installBtn.type = "button";
-				installBtn.disabled = !hasSet || report.ignoredSet;
-				installBtn.innerHTML = `${DOWNLOAD_ICON(13)}<span>${copy.installAll(actionable)}</span>`;
-				installBtn.addEventListener("click", () => {
-					runInstall(store, copy);
-				});
-				bar.append(installBtn);
-			}
-			if (!hasSet) return;
-			if (report.ignoredSet) {
-				const unignore = el("button", "hqpu-btn hqpu-btn--outline hqpu-btn--sm", copy.unignore);
-				unignore.type = "button";
-				unignore.addEventListener("click", () => {
-					unignoreOffer(report.manifestVersion).then(() => store.refresh()).catch(() => void 0);
-				});
-				bar.append(unignore);
-			} else if (actionable > 0) {
-				const ignore = el("button", "hqpu-btn hqpu-btn--ghost hqpu-btn--sm", copy.ignore);
-				ignore.type = "button";
-				ignore.addEventListener("click", () => {
-					ignoreOffer(report.manifestVersion).then(() => store.refresh()).catch(() => void 0);
-				});
-				bar.append(ignore);
-			}
-		}
-		/** After an install, poll the backend until the update report settles
-		*  (installing flag clears or DSH restarts under us — the next load re-reads
-		*  the fresh state). */
-		function pollUntilSettled(store) {
-			let attempts = 0;
-			const tick = () => {
-				store.refresh().then((report) => {
-					if (store.installing()) return;
-					if (report !== null && report.ignoredSet === false && attempts >= 2) return;
-				}).catch(() => void 0).finally(() => {
-					attempts += 1;
-					if (attempts < 10) window.setTimeout(tick, 2e3);
-				});
+			const setVersion = report.manifestVersion ?? "";
+			countEl.textContent = copy.ui.footerCount(actionable);
+			setEl.textContent = hasSet ? copy.ui.footerSet(setVersion) : "";
+			installBtn.textContent = hasSet ? copy.ui.installAllSet(setVersion) : copy.ui.installAllSet("—");
+			installBtn.disabled = installing || actionable === 0 || !hasSet || report.ignoredSet;
+			installBtn.dataset.busy = installing ? "true" : "false";
+			installBtn.onclick = () => {
+				runInstall(store, copy);
+			};
+			ignoreBtn.style.display = hasSet ? "" : "none";
+			ignoreBtn.textContent = report.ignoredSet ? copy.unignore : copy.ui.ignoreBtn;
+			ignoreBtn.onclick = () => {
+				const version = report.manifestVersion;
+				(report.ignoredSet ? unignoreOffer(version) : ignoreOffer(version)).then(() => store.refresh()).catch(() => void 0);
 			};
-			tick();
 		}
 		/**
 		* Open (or focus) the update panel. Re-renders from the store; when the store
@@ -1233,39 +1793,53 @@ window.__ModuleLoader__.load({
 			panel.tabIndex = -1;
 			const head = el("div", "hqpu-head");
 			const headMain = el("div", "hqpu-head-main");
-			headMain.append(el("h1", "hqpu-title", copy.viewTitle));
-			const intro = el("p", "hqpu-intro");
-			intro.append(el("span", "", copy.viewIntro));
-			const info = el("button", "hqpu-info");
-			info.type = "button";
-			info.setAttribute("aria-label", copy.viewInfo);
-			info.title = copy.viewInfo;
-			info.innerHTML = INFO_ICON(11);
-			intro.append(info);
-			headMain.append(intro);
+			const brandIcon = el("span", "hqpu-brand-icon");
+			brandIcon.innerHTML = `<svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round" stroke-linejoin="round"><path d="M5.6 2.6a6 6 0 015.6 1.6M12.4 13.4a6 6 0 01-5.6-1.6M10.6 2V5.4H7.2M5.4 14V10.6H8.8"/></svg>`;
+			const titleBlock = el("div", "hqpu-title-block");
+			titleBlock.append(el("h1", "hqpu-title", copy.ui.title));
+			const sub = el("p", "hqpu-sub");
+			titleBlock.append(sub);
+			headMain.append(brandIcon, titleBlock);
 			const toolbar = el("div", "hqpu-toolbar");
 			const refreshBtn = iconButton("hqpu-icon-btn", REFRESH_ICON(16), copy.refresh, () => {
-				store.refresh();
+				store.check();
 			});
 			toolbar.append(refreshBtn);
+			const gearBtn = iconButton("hqpu-icon-btn", `<svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.2" stroke-linecap="round" stroke-linejoin="round"><circle cx="8" cy="8" r="2.2"/><path d="M13.5 9.2v-2.4l-1.8-.6a4.4 4.4 0 00-.5-1.2l.9-1.7-1.7-1.7-1.7.9a4.4 4.4 0 00-1.2-.5L7.2 2.5H4.8l-.6 1.8a4.4 4.4 0 00-1.2.5l-1.7-.9-1.7 1.7.9 1.7a4.4 4.4 0 00-.5 1.2L2.5 7.2v2.4l1.8.6a4.4 4.4 0 00.5 1.2l-.9 1.7 1.7 1.7 1.7-.9a4.4 4.4 0 001.2.5l.6 1.8h2.4l.6-1.8a4.4 4.4 0 001.2-.5l1.7.9 1.7-1.7-.9-1.7a4.4 4.4 0 00.5-1.2l1.8-.6z"/></svg>`, copy.ui.gearTooltip, () => {
+				settingsOpen = !settingsOpen;
+				render();
+			});
+			toolbar.append(gearBtn);
 			const closeBtn = iconButton("hqpu-icon-btn", CLOSE_ICON(16), copy.close, () => {
 				onClose();
 			});
 			toolbar.append(closeBtn);
 			head.append(headMain, toolbar);
 			panel.append(head);
+			const settingsPanel = el("div", "hqpu-settings");
+			panel.append(settingsPanel);
 			const scroll = el("div", "hqpu-scroll");
 			const column = el("div", "hqpu-column");
-			const pluginSourceSection = el("div", "hqpu-stack");
+			const jobSection = el("div", "hqpu-stack");
 			const listSection = el("div", "hqpu-stack");
 			const runtimeSection = el("div", "hqpu-stack");
 			const toastSection = el("div", "hqpu-toast-host");
-			column.append(pluginSourceSection, listSection, runtimeSection, toastSection);
+			column.append(jobSection, listSection, runtimeSection, toastSection);
 			scroll.append(column);
 			panel.append(scroll);
 			const footer = el("div", "hqpu-footer");
-			const actionBar = el("div", "hqpu-actions");
-			footer.append(actionBar);
+			const footMeta = el("div", "hqpu-foot-meta");
+			const footCount = el("span", "");
+			const footSet = el("span", "hqpu-foot-set");
+			footMeta.append(footCount, footSet);
+			const footActions = el("div", "hqpu-foot-actions");
+			const installAllBtn = el("button", "hqpu-btn hqpu-btn--block");
+			installAllBtn.type = "button";
+			const ignoreBtn = el("button", "hqpu-btn--ignore", copy.ui.ignoreBtn);
+			ignoreBtn.type = "button";
+			footActions.append(installAllBtn, ignoreBtn);
+			const footnote = el("p", "hqpu-footnote", copy.ui.footnote);
+			footer.append(footMeta, footActions, footnote);
 			panel.append(footer);
 			overlay.append(scrim, panel);
 			document.body.appendChild(overlay);
@@ -1275,6 +1849,10 @@ window.__ModuleLoader__.load({
 			let runtimeArmed = false;
 			let runtimeBusy = false;
 			let runtimeAccepted = false;
+			const changelogOpen = /* @__PURE__ */ new Set();
+			let allOpen = false;
+			let settingsOpen = false;
+			let dismissedAlert = false;
 			const runtimeSourceState = {
 				editing: false,
 				saving: false,
@@ -1403,6 +1981,7 @@ window.__ModuleLoader__.load({
 					}
 					runtimeAccepted = true;
 					showToast(copy.runtime.updateAccepted, "success");
+					store.fetchStatus();
 				} catch (err) {
 					showToast(`${copy.installError}: ${err instanceof Error ? err.message : String(err)}`, "error");
 				} finally {
@@ -1410,18 +1989,59 @@ window.__ModuleLoader__.load({
 					render();
 				}
 			}
+			/** Retry a failed/abandoned job: plugin-set → a fresh install; runtime →
+			*  re-arm the runtime confirm flow. Always a NEW job, never re-clicking the
+			*  settled job id. */
+			const retryJob = (kind) => {
+				if (kind === "runtime") {
+					runtimeArmed = true;
+					render();
+				} else runInstall(store, copy);
+			};
+			const renderJobSection = () => {
+				jobSection.textContent = "";
+				const active = store.activeJob();
+				if (active !== null && !TERMINAL_PHASES.has(active.phase)) {
+					jobSection.append(activeJobView(active, copy));
+					return;
+				}
+				const recent = store.recentJobs();
+				const latest = recent[0];
+				if (latest !== void 0 && TERMINAL_PHASES.has(latest.phase)) {
+					jobSection.append(resultView(latest, copy, () => retryJob(latest.kind)));
+					const older = recentJobsList(recent, copy);
+					if (older !== null) jobSection.append(older);
+				}
+			};
 			const render = () => {
 				const report = store.report();
-				const installing = store.installing();
+				const jobActive = store.activeJob() !== null && !TERMINAL_PHASES.has(store.activeJob().phase);
+				const installing = store.installing() || jobActive;
 				const stale = report === null;
 				refreshBtn.disabled = stale;
+				refreshBtn.title = copy.refresh;
+				const ago = relativeAgo(report?.checkedAt, copy);
+				sub.textContent = ago !== null ? copy.ui.checkedAgo(ago) : copy.ui.checkedUnknown;
+				renderSettingsPanel(settingsPanel, report, copy, settingsOpen, pluginActions, runtimeSourceActions);
+				renderJobSection();
 				if (stale) {
 					listSection.textContent = "";
 					listSection.append(skeleton(copy));
-				} else renderList(listSection, report, copy, installing, store);
-				renderPluginSource(pluginSourceSection, report, copy, pluginActions);
-				renderRuntime(runtimeSection, report, copy, runtimeActions);
-				renderActions(actionBar, report, copy, store, installing);
+				} else renderList(listSection, report, copy, changelogOpen, allOpen, (name) => {
+					if (changelogOpen.has(name)) changelogOpen.delete(name);
+					else changelogOpen.add(name);
+					render();
+				}, () => {
+					allOpen = !allOpen;
+					render();
+				}, () => {
+					store.check();
+				});
+				renderRuntime(runtimeSection, report, copy, runtimeActions, dismissedAlert, () => {
+					dismissedAlert = true;
+					render();
+				});
+				renderFooter(footer, installAllBtn, ignoreBtn, footCount, footSet, report, copy, installing, store);
 			};
 			const unsubscribe = store.subscribe(render);
 			disposers.push(unsubscribe);
@@ -2202,6 +2822,97 @@ window.__ModuleLoader__.load({
   padding: 0 24px 20px;
 }
 
+/* ── Durable job (active / result) ────────────────────────────────────── */
+.hqpu-job {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 12px;
+  border: 0.5px solid var(--dsw-alias-border-l2);
+  border-radius: var(--dsw-radius-lg);
+  background: var(--dsw-alias-bg-layer-3);
+}
+.hqpu-job-meta {
+  font-variant-numeric: tabular-nums;
+}
+.hqpu-progress {
+  height: 6px;
+  border-radius: 999px;
+  background: var(--dsw-alias-bg-module-platform);
+  overflow: hidden;
+}
+.hqpu-progress-fill {
+  height: 100%;
+  border-radius: 999px;
+  background: var(--dsw-alias-state-business-primary);
+  transition: width var(--ds-transition-duration, 0.2s) ease;
+}
+.hqpu-job-steps {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+.hqpu-steps {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+.hqpu-step {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  font-size: 12.5px;
+  line-height: 18px;
+  color: var(--dsw-alias-label-secondary);
+}
+.hqpu-step--skipped,
+.hqpu-step--pending { opacity: 0.6; }
+
+/* ── Per-plugin change list + release notes ────────────────────────────── */
+.hqpu-changes {
+  padding: 0 8px 8px 70px;
+}
+.hqpu-changes-list,
+.hqpu-release-notes {
+  margin: 4px 0 0;
+  padding-left: 18px;
+  font-size: 12.5px;
+  line-height: 19px;
+  color: var(--dsw-alias-label-secondary);
+}
+.hqpu-release-link {
+  align-self: flex-start;
+}
+
+/* ── Advanced disclosure (source editors) ───────────────────────────────── */
+.hqpu-advanced > summary {
+  cursor: pointer;
+  font-size: 12.5px;
+  line-height: 20px;
+  color: var(--dsw-alias-label-tertiary);
+  list-style: none;
+  padding: 2px 0;
+}
+.hqpu-advanced > summary::-webkit-details-marker { display: none; }
+.hqpu-advanced > summary::before {
+  content: '▸ ';
+}
+.hqpu-advanced[open] > summary::before {
+  content: '▾ ';
+}
+
+/* Danger-toned banner (check failure, breaking changes) */
+.hqpu-banner[data-tone='danger'] {
+  background: color-mix(in srgb, var(--dsw-alias-state-error-primary) 8%, transparent);
+  color: var(--dsw-alias-label-secondary);
+}
+.hqpu-banner[data-tone='danger'] > svg {
+  color: var(--dsw-alias-state-error-primary);
+}
+
 .hqpu-visually-hidden {
   position: absolute;
   width: 1px;
@@ -2220,58 +2931,697 @@ window.__ModuleLoader__.load({
   .hqpu-panel,
   .hqpu-skeleton-fill,
   .hqpu-spinner,
-  .hqpu-toast {
+  .hqpu-toast,
+  .hqpu-pulse-ring,
+  .hqpu-job-step--active {
     animation: none;
   }
 }
-`;
-		const STYLE_TAG_ID = "data-plugin-css=\"huaqiu-plugin-update\"";
-		/**
-		* Design tokens the bundled DSH shell may not publish.
-		*
-		* hq-edge ships an older `ui-theme` build. A live probe of the running shell
-		* (both themes) shows 13 of the tokens this stylesheet reads are absent:
-		* `--dsw-radius-{xs,sm,md,lg,xl,panel}`, `--dsw-focus-ring-width`,
-		* `--dsw-focus-ring-color`, `--dsw-alias-toast-label`,
-		* `--dsw-alias-state-idle-primary`, `--dsw-font-mono`,
-		* `--dsh-frame-overlay-top` and `--dsh-frame-chrome-top`.
-		*
-		* An unresolved `var()` is not an error — it silently degrades the property to
-		* its initial value. That is how this panel once rendered with
-		* `border-radius: 0px` and a 3px `auto` focus ring while every colour was
-		* already correct.
-		*
-		* The last three (`--dsw-font-mono`, `--dsh-frame-*`) are deliberately NOT
-		* backfilled: the shell's own primitives rely on the inline `var(…, fallback)`
-		* form for those (`Modal.module.css`, `PluginManagerPage.module.css`), so this
-		* sheet does too. Everything else is backfilled below with the canonical value
-		* from `ui-theme/src/styles/{base,focus,design-platform}.css`.
-		*
-		* Values are feature-detected at runtime and scoped to this plugin's own roots
-		* rather than `:root`, so a newer shell always wins and filling a gap can never
-		* restyle the host.
-		*/
-		/** The two roots this plugin styles: the view overlay (built in
-		*  update-view.ts) and the sidebar row ({@link ENTRY_CSS}.entry). */
-		const STYLE_ROOTS = ".hqpu-overlay, .hqpu-sidebar-entry";
-		/** The shell's dark-theme carrier — audited live as `body[data-ds-dark-theme]`. */
-		const DARK_THEME_SELECTOR = "body[data-ds-dark-theme]";
-		/** Same roots, one rule per theme, for tokens whose official value flips. */
-		const DARK_STYLE_ROOTS = STYLE_ROOTS.split(",").map((root) => `${DARK_THEME_SELECTOR} ${root.trim()}`).join(",");
-		const DESIGN_TOKEN_FALLBACKS = [
-			{
-				token: "--dsw-radius-xs",
-				value: "4px"
-			},
-			{
-				token: "--dsw-radius-sm",
-				value: "8px"
-			},
-			{
-				token: "--dsw-radius-md",
-				value: "12px"
-			},
-			{
+
+/* ════════════════════════════════════════════════════════════════════════
+ * Refactored dock (interactive_refactored_ui_mockup.html) — a narrow dark-zinc
+ * update-center column. These rules cascade over the shell-token base: the
+ * panel becomes ~340px wide, the zinc palette hard-coded per mockup, with a
+ * sticky header / scroll body / sticky footer. No Tailwind, no dependencies.
+ * ════════════════════════════════════════════════════════════════════════ */
+.hqpu-panel,
+.hqpu-panel * {
+  --hq-bg: #18181b;
+  --hq-card: #27272a;
+  --hq-card-soft: #1c1c1f;
+  --hq-border: #3f3f46;
+  --hq-hover: #323236;
+  --hq-text: #f4f4f5;
+  --hq-muted: #a1a1aa;
+  --hq-faint: #71717a;
+  --hq-brand: #dc2626;
+  --hq-brand-soft: #ef4444;
+  --hq-emerald: #34d399;
+  --hq-amber: #f59e0b;
+}
+.hqpu-panel {
+  width: min(360px, calc(100vw - 32px));
+  max-height: min(86vh, 720px);
+  background: var(--hq-bg);
+  color: var(--hq-text);
+  border: 0.5px solid var(--hq-border);
+  border-radius: 12px;
+  gap: 0;
+  overflow: hidden;
+}
+.hqpu-scrim {
+  background: rgba(0, 0, 0, 0.55);
+}
+
+/* Sticky header */
+.hqpu-head {
+  flex: none;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  padding: 10px 12px;
+  border-bottom: 0.5px solid var(--hq-border);
+  background: color-mix(in srgb, var(--hq-bg) 95%, transparent);
+  position: sticky;
+  top: 0;
+  z-index: 2;
+}
+.hqpu-head-main {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  min-width: 0;
+  margin: 0;
+}
+.hqpu-brand-icon {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  flex: none;
+  width: 24px;
+  height: 24px;
+  border-radius: 6px;
+  background: color-mix(in srgb, var(--hq-brand) 20%, transparent);
+  color: var(--hq-brand-soft);
+}
+.hqpu-brand-icon svg { width: 14px; height: 14px; display: block; }
+.hqpu-title-block { min-width: 0; }
+.hqpu-title {
+  margin: 0;
+  font-size: 13px;
+  font-weight: 600;
+  line-height: 16px;
+  color: var(--hq-text);
+}
+.hqpu-sub {
+  margin: 2px 0 0;
+  font-size: 10px;
+  line-height: 14px;
+  color: var(--hq-muted);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.hqpu-toolbar { gap: 2px; }
+.hqpu-icon-btn {
+  width: 26px;
+  height: 26px;
+  border-radius: 6px;
+  color: var(--hq-muted);
+}
+.hqpu-icon-btn:hover:not(:disabled) {
+  background: var(--hq-hover);
+  color: var(--hq-text);
+}
+.hqpu-icon-btn svg { width: 14px; height: 14px; }
+
+/* Collapsible settings panel */
+.hqpu-settings {
+  flex: none;
+  padding: 10px 12px;
+  border-bottom: 0.5px solid var(--hq-border);
+  background: #131316;
+}
+.hqpu-settings-row {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  margin-bottom: 8px;
+}
+.hqpu-settings-title {
+  font-size: 11px;
+  font-weight: 500;
+  color: #d4d4d8;
+}
+.hqpu-origin-badge {
+  font-size: 9px;
+  padding: 1px 6px;
+  border-radius: 4px;
+  border: 0.5px solid;
+}
+.hqpu-origin-badge[data-origin='config'] {
+  background: rgba(6, 78, 59, 0.4);
+  color: var(--hq-emerald);
+  border-color: rgba(6, 95, 70, 0.6);
+}
+.hqpu-origin-badge[data-origin='override'] {
+  background: rgba(120, 53, 15, 0.4);
+  color: var(--hq-amber);
+  border-color: rgba(180, 83, 9, 0.5);
+}
+.hqpu-settings label {
+  display: block;
+  font-size: 10px;
+  color: var(--hq-muted);
+  margin: 6px 0 3px;
+}
+.hqpu-source-input {
+  width: 100%;
+  height: 26px;
+  font-size: 10px;
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  background: var(--hq-bg);
+  border: 0.5px solid var(--hq-border);
+  border-radius: 5px;
+  color: #d4d4d8;
+  padding: 0 8px;
+  box-sizing: border-box;
+}
+.hqpu-source-input:focus-visible {
+  outline: none;
+  border-color: var(--hq-brand-soft);
+}
+.hqpu-settings-actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: 6px;
+  margin-top: 8px;
+}
+
+/* Scroll body */
+.hqpu-scroll {
+  flex: 1;
+  padding: 12px;
+  background: var(--hq-bg);
+  --dsh-scrollbar-thumb: #3f3f46;
+  --dsh-scrollbar-thumb-hover: #52525b;
+}
+.hqpu-column {
+  max-width: none;
+  margin: 0;
+  gap: 10px;
+}
+.hqpu-stack { gap: 10px; }
+
+/* ── Active-job banner ─────────────────────────────────────────────────── */
+.hqpu-active {
+  position: relative;
+  padding: 12px;
+  border-radius: 8px;
+  border: 0.5px solid color-mix(in srgb, var(--hq-brand-soft) 30%, transparent);
+  background: #18181b;
+  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.4);
+}
+.hqpu-active-top {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+}
+.hqpu-active-title {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  min-width: 0;
+  font-size: 11px;
+  font-weight: 600;
+  color: #e4e4e7;
+}
+.hqpu-pulse-dot {
+  position: relative;
+  flex: none;
+  width: 8px;
+  height: 8px;
+}
+.hqpu-pulse-dot::before {
+  content: '';
+  position: absolute;
+  inset: 0;
+  border-radius: 50%;
+  background: var(--hq-brand-soft);
+}
+.hqpu-pulse-ring {
+  position: absolute;
+  inset: 0;
+  border-radius: 50%;
+  background: var(--hq-brand-soft);
+  opacity: 0.6;
+  animation: hqpu-ping 1.4s cubic-bezier(0, 0, 0.2, 1) infinite;
+}
+@keyframes hqpu-ping {
+  75%, 100% { transform: scale(2.2); opacity: 0; }
+}
+.hqpu-active-percent {
+  flex: none;
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  font-size: 11px;
+  font-weight: 500;
+  color: var(--hq-brand-soft);
+}
+.hqpu-progress {
+  height: 6px;
+  margin-top: 10px;
+  border-radius: 999px;
+  background: #27272a;
+  overflow: hidden;
+}
+.hqpu-progress-fill {
+  background: linear-gradient(to right, var(--hq-brand), var(--hq-brand-soft));
+  transition: width 0.3s ease;
+}
+.hqpu-active-meta {
+  display: flex;
+  justify-content: space-between;
+  gap: 8px;
+  margin-top: 4px;
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  font-size: 10px;
+  color: var(--hq-muted);
+}
+/* 4-step indicator row */
+.hqpu-job-steps4 {
+  display: grid;
+  grid-template-columns: repeat(4, 1fr);
+  gap: 4px;
+  margin-top: 10px;
+  padding-top: 8px;
+  border-top: 0.5px solid #27272a;
+  text-align: center;
+  font-size: 9px;
+  font-weight: 500;
+}
+.hqpu-job-step--done { color: var(--hq-emerald); }
+.hqpu-job-step--active {
+  color: var(--hq-brand-soft);
+  animation: hqpu-step-pulse 1.2s ease-in-out infinite;
+}
+.hqpu-job-step--todo { color: var(--hq-muted); }
+@keyframes hqpu-step-pulse {
+  0%, 100% { opacity: 1; }
+  50% { opacity: 0.45; }
+}
+
+/* ── Result / rollback alert (amber) vs green success ──────────────────── */
+.hqpu-alert {
+  display: flex;
+  align-items: flex-start;
+  gap: 8px;
+  padding: 10px;
+  border-radius: 8px;
+}
+.hqpu-alert--amber {
+  background: rgba(69, 26, 3, 0.35);
+  border: 0.5px solid rgba(180, 83, 9, 0.4);
+}
+.hqpu-alert--amber svg { color: var(--hq-amber); flex: none; margin-top: 1px; }
+.hqpu-alert-green {
+  background: rgba(6, 78, 59, 0.3);
+  border: 0.5px solid rgba(6, 95, 70, 0.4);
+  color: #a7f3d0;
+  font-size: 11px;
+}
+.hqpu-alert-title {
+  font-size: 11px;
+  font-weight: 500;
+  color: #fcd34d;
+}
+.hqpu-alert-body {
+  margin: 2px 0 0;
+  font-size: 10px;
+  line-height: 15px;
+  color: rgba(252, 211, 77, 0.8);
+}
+.hqpu-alert-body code {
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  background: rgba(120, 53, 15, 0.5);
+  padding: 1px 4px;
+  border-radius: 3px;
+}
+.hqpu-alert-actions {
+  display: flex;
+  gap: 8px;
+  margin-top: 6px;
+}
+.hqpu-alert-dismiss {
+  background: none;
+  border: 0;
+  padding: 0;
+  font-size: 10px;
+  color: #fbbf24;
+  cursor: pointer;
+  text-decoration: underline;
+}
+
+/* ── Runtime engine card ────────────────────────────────────────────────── */
+.hqpu-engine {
+  padding: 12px;
+  border-radius: 8px;
+  border: 0.5px solid var(--hq-border);
+  background: var(--hq-card);
+}
+.hqpu-engine-head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+}
+.hqpu-engine-title {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  font-size: 12px;
+  font-weight: 600;
+  color: #e4e4e7;
+}
+.hqpu-engine-title svg { width: 14px; height: 14px; color: #a1a1aa; }
+.hqpu-chip {
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  font-size: 9px;
+  padding: 2px 6px;
+  border-radius: 4px;
+  background: #27272a;
+  border: 0.5px solid #52525b;
+  color: #d4d4d8;
+}
+.hqpu-engine-update-row {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  margin-top: 10px;
+  padding: 8px;
+  border-radius: 6px;
+  border: 0.5px solid rgba(63, 63, 70, 0.7);
+  background: rgba(24, 24, 27, 0.6);
+}
+.hqpu-engine-new-line {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  font-size: 11px;
+  font-weight: 500;
+  color: #d4d4d8;
+}
+.hqpu-tag--brand {
+  font-size: 9px;
+  padding: 1px 4px;
+  border-radius: 3px;
+  color: var(--hq-brand-soft);
+  background: rgba(69, 10, 10, 0.6);
+  border: 0.5px solid rgba(153, 27, 27, 0.5);
+}
+.hqpu-engine-size {
+  margin: 3px 0 0;
+  font-size: 10px;
+  color: var(--hq-muted);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.hqpu-btn--engine {
+  flex: none;
+  height: auto;
+  padding: 6px 10px;
+  font-size: 10px;
+  background: #27272a;
+  border: 0.5px solid #52525b;
+  color: #e4e4e7;
+  border-radius: 5px;
+}
+.hqpu-btn--engine:hover:not(:disabled) { background: #3f3f46; }
+.hqpu-engine-note {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  margin: 8px 0 0;
+  font-size: 9px;
+  color: var(--hq-muted);
+}
+.hqpu-engine-note svg { width: 10px; height: 10px; color: var(--hq-amber); flex: none; }
+
+/* ── Plugin cards ───────────────────────────────────────────────────────── */
+.hqpu-section-head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  padding: 0 2px;
+}
+.hqpu-section-title {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  font-size: 12px;
+  font-weight: 600;
+  color: #e4e4e7;
+}
+.hqpu-count-pill {
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  font-size: 10px;
+  font-weight: 700;
+  padding: 1px 6px;
+  border-radius: 999px;
+  background: color-mix(in srgb, var(--hq-brand) 20%, transparent);
+  color: var(--hq-brand-soft);
+}
+.hqpu-all-changelog {
+  background: none;
+  border: 0;
+  padding: 0;
+  font-size: 10px;
+  color: var(--hq-muted);
+  cursor: pointer;
+}
+.hqpu-all-changelog:hover { color: var(--hq-text); }
+
+.hqpu-cards { gap: 8px; }
+.hqpu-card {
+  margin: 0;
+  padding: 10px;
+  border-radius: 8px;
+  border: 0.5px solid var(--hq-border);
+  background: var(--hq-card);
+  transition: border-color 0.15s ease;
+}
+.hqpu-card:hover { border-color: #52525b; }
+.hqpu-card-head {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 8px;
+  padding: 0;
+}
+.hqpu-card-head > * { display: flex; align-items: center; gap: 8px; min-width: 0; }
+.hqpu-avatar {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  flex: none;
+  width: 28px;
+  height: 28px;
+  border-radius: 6px;
+  border: 0.5px solid #52525b;
+  background: #27272a;
+  color: #d4d4d8;
+  font-size: 10px;
+  font-weight: 700;
+}
+.hqpu-card-title {
+  font-size: 12px;
+  font-weight: 600;
+  color: #e4e4e7;
+}
+.hqpu-card-sub {
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  font-size: 9px;
+  color: var(--hq-faint);
+}
+.hqpu-version-row {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  margin-top: 2px;
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  font-size: 10px;
+}
+.hqpu-ver-old { color: var(--hq-muted); }
+.hqpu-ver-arrow { color: #52525b; }
+.hqpu-ver-new { color: var(--hq-emerald); font-weight: 700; }
+.hqpu-log-toggle {
+  display: inline-flex;
+  align-items: center;
+  gap: 2px;
+  background: none;
+  border: 0;
+  padding: 4px;
+  font-size: 10px;
+  color: var(--hq-muted);
+  cursor: pointer;
+}
+.hqpu-log-toggle:hover { color: var(--hq-text); }
+.hqpu-log-toggle svg { width: 12px; height: 12px; transition: transform 0.15s ease; }
+.hqpu-log-toggle[data-open='true'] svg { transform: rotate(180deg); }
+.hqpu-changelog-drawer {
+  margin-top: 8px;
+  padding: 8px;
+  border-radius: 6px;
+  border: 0.5px solid #27272a;
+  background: rgba(24, 24, 27, 0.8);
+  font-size: 10px;
+}
+.hqpu-changelog-drawer-title {
+  font-size: 9px;
+  font-weight: 500;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  color: #a1a1aa;
+}
+.hqpu-changelog-drawer ul {
+  margin: 4px 0 0;
+  padding-left: 16px;
+  color: #d4d4d8;
+  line-height: 16px;
+}
+
+/* Blocked / incompatible card: dimmed, rose badge, no install button */
+.hqpu-card--blocked {
+  opacity: 0.8;
+  background: rgba(39, 39, 42, 0.6);
+  border-color: #27272a;
+}
+.hqpu-card--blocked .hqpu-avatar {
+  background: rgba(39, 39, 42, 0.5);
+  border-color: #27272a;
+  color: #71717a;
+}
+.hqpu-card--blocked .hqpu-card-title { color: #a1a1aa; }
+.hqpu-blocked-badge {
+  font-size: 9px;
+  padding: 2px 6px;
+  border-radius: 4px;
+  color: #fb7185;
+  background: rgba(76, 5, 25, 0.5);
+  border: 0.5px solid rgba(136, 19, 55, 0.5);
+}
+.hqpu-reason-line {
+  display: flex;
+  align-items: flex-start;
+  gap: 4px;
+  margin: 8px 0 0;
+  padding: 6px;
+  border-radius: 5px;
+  border: 0.5px solid rgba(136, 19, 55, 0.2);
+  background: rgba(76, 5, 25, 0.2);
+  font-size: 10px;
+  color: rgba(251, 113, 133, 0.9);
+}
+.hqpu-reason-line svg { width: 12px; height: 12px; flex: none; margin-top: 1px; }
+
+/* Sticky footer */
+.hqpu-footer {
+  flex: none;
+  display: flex;
+  flex-direction: column;
+  align-items: stretch;
+  gap: 8px;
+  padding: 10px 12px 12px;
+  border-top: 0.5px solid var(--hq-border);
+  background: color-mix(in srgb, var(--hq-bg) 95%, transparent);
+}
+.hqpu-foot-meta {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  font-size: 10px;
+  color: var(--hq-muted);
+}
+.hqpu-foot-set {
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+}
+.hqpu-foot-actions {
+  display: flex;
+  gap: 8px;
+}
+.hqpu-btn--block {
+  flex: 1;
+  height: 32px;
+  background: var(--hq-brand);
+  color: #fff;
+  font-size: 11px;
+  font-weight: 500;
+  border-radius: 6px;
+  box-shadow: 0 4px 12px rgba(127, 29, 29, 0.4);
+}
+.hqpu-btn--block:hover:not(:disabled) { background: var(--hq-brand-soft); }
+.hqpu-btn--block:disabled { opacity: 0.5; box-shadow: none; }
+.hqpu-btn--ignore {
+  height: 32px;
+  padding: 0 10px;
+  background: var(--hq-card);
+  border: 0.5px solid var(--hq-border);
+  color: var(--hq-muted);
+  font-size: 10px;
+  border-radius: 6px;
+}
+.hqpu-btn--ignore:hover:not(:disabled) { background: var(--hq-hover); color: var(--hq-text); }
+.hqpu-footnote {
+  margin: 0;
+  font-size: 9px;
+  text-align: center;
+  color: var(--hq-muted);
+}
+
+/* Shared bits on the new palette */
+.hqpu-status { color: var(--hq-muted); font-size: 11px; }
+.hqpu-empty { color: var(--hq-muted); font-size: 11px; padding: 16px 0; }
+.hqpu-toast { background: var(--hq-card); border: 0.5px solid var(--hq-border); color: var(--hq-text); font-size: 12px; }
+.hqpu-skeleton-fill { background: #3f3f46; }
+.hqpu-job { background: var(--hq-card); border-color: var(--hq-border); }
+.hqpu-job-meta { color: var(--hq-muted); }
+.hqpu-release-notes { color: var(--hq-muted); font-size: 11px; }
+.hqpu-advanced > summary { color: var(--hq-muted); }
+.hqpu-recent-jobs li { color: var(--hq-muted); font-size: 10px; }
+`;
+		const STYLE_TAG_ID = "data-plugin-css=\"huaqiu-plugin-update\"";
+		/**
+		* Design tokens the bundled DSH shell may not publish.
+		*
+		* hq-edge ships an older `ui-theme` build. A live probe of the running shell
+		* (both themes) shows 13 of the tokens this stylesheet reads are absent:
+		* `--dsw-radius-{xs,sm,md,lg,xl,panel}`, `--dsw-focus-ring-width`,
+		* `--dsw-focus-ring-color`, `--dsw-alias-toast-label`,
+		* `--dsw-alias-state-idle-primary`, `--dsw-font-mono`,
+		* `--dsh-frame-overlay-top` and `--dsh-frame-chrome-top`.
+		*
+		* An unresolved `var()` is not an error — it silently degrades the property to
+		* its initial value. That is how this panel once rendered with
+		* `border-radius: 0px` and a 3px `auto` focus ring while every colour was
+		* already correct.
+		*
+		* The last three (`--dsw-font-mono`, `--dsh-frame-*`) are deliberately NOT
+		* backfilled: the shell's own primitives rely on the inline `var(…, fallback)`
+		* form for those (`Modal.module.css`, `PluginManagerPage.module.css`), so this
+		* sheet does too. Everything else is backfilled below with the canonical value
+		* from `ui-theme/src/styles/{base,focus,design-platform}.css`.
+		*
+		* Values are feature-detected at runtime and scoped to this plugin's own roots
+		* rather than `:root`, so a newer shell always wins and filling a gap can never
+		* restyle the host.
+		*/
+		/** The two roots this plugin styles: the view overlay (built in
+		*  update-view.ts) and the sidebar row ({@link ENTRY_CSS}.entry). */
+		const STYLE_ROOTS = ".hqpu-overlay, .hqpu-sidebar-entry";
+		/** The shell's dark-theme carrier — audited live as `body[data-ds-dark-theme]`. */
+		const DARK_THEME_SELECTOR = "body[data-ds-dark-theme]";
+		/** Same roots, one rule per theme, for tokens whose official value flips. */
+		const DARK_STYLE_ROOTS = STYLE_ROOTS.split(",").map((root) => `${DARK_THEME_SELECTOR} ${root.trim()}`).join(",");
+		const DESIGN_TOKEN_FALLBACKS = [
+			{
+				token: "--dsw-radius-xs",
+				value: "4px"
+			},
+			{
+				token: "--dsw-radius-sm",
+				value: "8px"
+			},
+			{
+				token: "--dsw-radius-md",
+				value: "12px"
+			},
+			{
 				token: "--dsw-radius-lg",
 				value: "16px"
 			},
@@ -2346,33 +3696,114 @@ window.__ModuleLoader__.load({
 		var UpdateStore = class {
 			current = null;
 			installingFlag = false;
+			/** The durable job the server currently reports as active (resumed across
+			*  panel close and DSH restart); null when idle. */
+			active = null;
+			recent = [];
 			listeners = /* @__PURE__ */ new Set();
 			refreshTimer = null;
+			pollTimer = null;
+			pollBackoffMs = 1e3;
+			pollInFlight = false;
 			report() {
 				return this.current;
 			}
 			installing() {
 				return this.installingFlag;
 			}
+			activeJob() {
+				return this.active;
+			}
+			recentJobs() {
+				return [...this.recent];
+			}
 			subscribe(listener) {
 				this.listeners.add(listener);
 				return () => {
 					this.listeners.delete(listener);
 				};
 			}
-			/** Badge count per spec §6.3: actionable `update` + `install`, excluding the
-			*  ignored offer (the server already folds ignore into item states; keep the
-			*  client-side filter as a defensive second pass). */
+			/**
+			* Badge: counts actionable plugin updates AND an available runtime update AND
+			* (while a job runs) an attention pill. A recent failed/rolled-back job with
+			* nothing actionable left also keeps a dot, so the outcome is never silently
+			* forgotten after the panel closes.
+			*/
 			badgeCount() {
+				const job = this.active;
+				if (job !== null && !TERMINAL_PHASES.has(job.phase)) return 1;
 				const report = this.current;
 				if (report === null) return 0;
-				return report.items.filter((item) => item.state === "update" || item.state === "install").length;
+				let count = report.items.filter((item) => item.state === "update" || item.state === "install").length;
+				if (report.runtime?.updateAvailable) count += 1;
+				if (count === 0) {
+					const latest = this.recent[0];
+					if (latest !== void 0 && (latest.phase === "failed" || latest.phase === "rolled-back")) count = 1;
+				}
+				return count;
 			}
 			emit() {
 				for (const listener of [...this.listeners]) try {
 					listener();
 				} catch {}
 			}
+			/** Adopt a fresh `/status` snapshot and (re)arm the poll loop. */
+			applyStatus(status) {
+				const wasActive = this.active !== null;
+				this.active = status.activeJob;
+				this.recent = status.recentJobs;
+				if (wasActive && this.active === null) this.installingFlag = false;
+				this.emit();
+				this.schedulePoll();
+			}
+			/**
+			* Fetch the durable job status. Called on mount, on panel open (BEFORE
+			* discovery) and by the poll loop. A failure (older hq-edge with no
+			* `/status`, or a transient HTTP error) is swallowed: the last known job is
+			* kept and the poller backs off and retries.
+			*/
+			async fetchStatus() {
+				try {
+					const status = await fetchJobStatus();
+					this.pollBackoffMs = 1e3;
+					this.applyStatus(status);
+				} catch {
+					this.schedulePoll();
+				}
+			}
+			/** ~1 s poll while a job is active; stop on terminal; back off on error
+			*  without discarding the last known job; never overlap requests. */
+			schedulePoll() {
+				if (this.pollTimer !== null) {
+					window.clearTimeout(this.pollTimer);
+					this.pollTimer = null;
+				}
+				const job = this.active;
+				if (job === null || TERMINAL_PHASES.has(job.phase)) {
+					this.pollBackoffMs = 1e3;
+					return;
+				}
+				this.pollTimer = window.setTimeout(() => {
+					this.pollTick();
+				}, this.pollBackoffMs);
+			}
+			async pollTick() {
+				if (this.pollInFlight) {
+					this.schedulePoll();
+					return;
+				}
+				this.pollInFlight = true;
+				try {
+					const status = await fetchJobStatus();
+					this.pollBackoffMs = 1e3;
+					this.applyStatus(status);
+				} catch {
+					this.pollBackoffMs = Math.min(5e3, Math.max(1e3, this.pollBackoffMs * 2));
+					this.schedulePoll();
+				} finally {
+					this.pollInFlight = false;
+				}
+			}
 			async refresh() {
 				try {
 					const report = await fetchReport();
@@ -2410,6 +3841,10 @@ window.__ModuleLoader__.load({
 					window.clearInterval(this.refreshTimer);
 					this.refreshTimer = null;
 				}
+				if (this.pollTimer !== null) {
+					window.clearTimeout(this.pollTimer);
+					this.pollTimer = null;
+				}
 				this.listeners.clear();
 			}
 		};
@@ -2450,9 +3885,23 @@ window.__ModuleLoader__.load({
 			});
 			const openView = () => {
 				ensureDesignTokens();
-				store.check().then((report) => {
-					if (report !== null) openUpdateView(store, copyFor());
-				});
+				store.fetchStatus();
+				openUpdateView(store, copyFor());
+				store.check();
+			};
+			const statusLabel = () => {
+				const base = entryCopy(locale);
+				const job = store.activeJob();
+				if (job !== null) {
+					const cc = copyFor();
+					const pct = job.progress.percent;
+					const phase = cc.job.phase[job.phase] ?? job.phase;
+					return {
+						label: pct !== null ? `${base.label} · ${Math.round(pct)}%` : `${base.label} · ${phase}`,
+						tooltip: `${base.tooltip} · ${phase}`
+					};
+				}
+				return base;
 			};
 			const disposeEntry = mountSidebarEntry({
 				rowAttribute: UPDATE_ENTRY_ATTRIBUTE,
@@ -2460,8 +3909,8 @@ window.__ModuleLoader__.load({
 				plugin: PLUGIN_ID,
 				icon: UPDATE_ICON,
 				css: ENTRY_CSS,
-				label: () => entryCopy(locale).label,
-				tooltip: () => entryCopy(locale).tooltip,
+				label: () => statusLabel().label,
+				tooltip: () => statusLabel().tooltip,
 				refresh: { subscribe: refreshSubscribe },
 				badge: {
 					subscribe: (listener) => store.subscribe(listener),
@@ -2471,8 +3920,14 @@ window.__ModuleLoader__.load({
 				position: "after",
 				familySelectors: HUAQIU_SIDEBAR_ENTRY_FAMILY
 			});
+			store.subscribe(() => {
+				for (const fn of [...localeSubscribers]) try {
+					fn();
+				} catch {}
+			});
 			store.startIdleRefresh();
 			store.refresh();
+			store.fetchStatus();
 			const dispose = () => {
 				try {
 					disposeEntry();