@lmzhen/dsh-evolution-ui 0.33.0 → 0.35.0

package/lib/client.js

@@ -841,12 +841,12 @@ window.__ModuleLoader__.load({
 			projectionFailed: "这一块读设置时出错，已记入日志；其它参数不受影响",
 			readonly: "本次会话不允许写入设置（临时运行模式）",
 			apply: "保存",
-			reset: "恢复默认值",
+			reset: "复位",
 			empty: "这里没有可改项",
 			changed: "{n} 项已覆盖",
 			discard: "放弃修改",
 			saving: "保存中…",
-			resetting: "恢复中…",
+			resetting: "复位中…",
 			writeTargetHost: "保存去向：宿主配置（对所有会话生效）",
 			invalidNumber: "需要一个数字",
 			invalidSelect: "不在允许的取值里",
@@ -858,6 +858,7 @@ window.__ModuleLoader__.load({
 			resetTo: "复位为 {value}",
 			saved: "已保存。",
 			saveReadbackFailed: "写入已被接受，但回读失败；点刷新重读后再确认。",
+			readbackStale: "显示的是最后一次成功读取的值；当前回读失败，刷新后可能变化。",
 			saveConflict: "这个值没有被接受：设置已被其他页面修改。请重读后再保存。",
 			resetDone: "已恢复默认值。",
 			refused: "这个值没有被接受（界面上保持原样）。想看原因：在对话里让它说明。",
@@ -926,6 +927,8 @@ window.__ModuleLoader__.load({
 			diagStatusUnknown: "未知",
 			diagRemedy: "建议：",
 			diagNoRows: "没有可显示的运行状态",
+			diagPurpose: "用途：检查插件挂载、平台服务和数据面是否正常，不修改任何状态。",
+			diagFooter: "诊断 schema v{version} · 生成于 {at}",
 			stateLoading: "正在读取…",
 			failureUnauthorized: "需要登录：重新打开这个页面完成登录后再试。",
 			failureForbidden: "平台拒绝了这个请求（身份不是 owner）。",
@@ -946,7 +949,7 @@ window.__ModuleLoader__.load({
 			projectionFailed: "reading this row failed and the error is in the log; the other parameters are unaffected",
 			readonly: "settings cannot be written in this session (temporary mode)",
 			apply: "Save",
-			reset: "Reset to default",
+			reset: "Reset",
 			empty: "nothing to change here",
 			changed: "{n} overridden",
 			discard: "Discard",
@@ -963,6 +966,7 @@ window.__ModuleLoader__.load({
 			resetTo: "Restores {value}",
 			saved: "Saved.",
 			saveReadbackFailed: "The write was accepted, but reading it back failed; refresh and confirm.",
+			readbackStale: "Showing the last successfully read values; the current re-read failed and may change after refresh.",
 			saveConflict: "The value was not accepted: settings changed in another page. Re-read before saving again.",
 			resetDone: "Default restored.",
 			refused: "The value was not accepted (the page keeps what you see). For the reason, ask in the conversation.",
@@ -1031,6 +1035,8 @@ window.__ModuleLoader__.load({
 			diagStatusUnknown: "unknown",
 			diagRemedy: "Suggested: ",
 			diagNoRows: "no runtime status to show",
+			diagPurpose: "Purpose: check plugin mounting, platform services and data planes; nothing is changed.",
+			diagFooter: "diagnostics schema v{version} · generated {at}",
 			stateLoading: "reading…",
 			failureUnauthorized: "Sign-in is required: reopen this page and sign in, then retry.",
 			failureForbidden: "The platform refused this request (not the owner principal).",
@@ -1264,10 +1270,12 @@ window.__ModuleLoader__.load({
 				type: "button",
 				className: "evolution-param-button",
 				disabled: props.disabled || props.clearing,
+				"data-role": "reset",
+				title: props.resetTo === null ? void 0 : t("resetTo", { value: props.resetTo }),
 				onClick: () => {
 					props.onClear(field.id);
 				}
-			}, props.clearing ? t("resetting") : t("reset")), props.resetTo === null ? null : (0, react.createElement)("span", { className: "evolution-param-hint" }, t("resetTo", { value: props.resetTo }))) : null);
+			}, props.clearing ? t("resetting") : t("reset"))) : null);
 		}
 		/**
 		* Render one row's card body from a supplied snapshot.
@@ -1426,7 +1434,11 @@ window.__ModuleLoader__.load({
 				onClick: () => {
 					setOpen(!open);
 				}
-			}, (0, react.createElement)("span", { className: "evolution-param-card-title" }, title), changed === 0 ? null : (0, react.createElement)("span", { className: "evolution-param-count" }, t("changed", { n: changed })), (0, react.createElement)("span", { className: "evolution-param-chevron" }, open ? "▲" : "▼")), open ? (0, react.createElement)("div", { className: "evolution-param-body" }, hintKey === void 0 ? null : (0, react.createElement)("p", { className: "evolution-param-note" }, t(hintKey)), disabled ? (0, react.createElement)("p", {
+			}, (0, react.createElement)("span", { className: "evolution-param-card-title" }, title), changed === 0 ? null : (0, react.createElement)("span", { className: "evolution-param-count" }, t("changed", { n: changed })), (0, react.createElement)("span", { className: "evolution-param-chevron" }, open ? "▲" : "▼")), open ? (0, react.createElement)("div", { className: "evolution-param-body" }, hintKey === void 0 ? null : (0, react.createElement)("p", { className: "evolution-param-note" }, t(hintKey)), snapshot.stale === true ? (0, react.createElement)("p", {
+				className: "evolution-param-note",
+				role: "status",
+				"data-role": "stale-note"
+			}, t("readbackStale")) : null, disabled ? (0, react.createElement)("p", {
 				className: "evolution-param-note",
 				role: "status"
 			}, t("readonly")) : null, fields.length === 0 ? (0, react.createElement)("p", {
@@ -1677,34 +1689,51 @@ window.__ModuleLoader__.load({
 				...EMPTY,
 				reason: "seat-missing"
 			};
+			let lastReady;
+			let generation = 0;
 			const listeners = /* @__PURE__ */ new Set();
-			let started = false;
-			let listening = false;
+			let remoteOff;
 			const notify = () => {
 				for (const listener of listeners) listener();
 			};
-			const refresh = async () => {
-				snapshot = await describe(namespace);
+			const absorb = (next) => {
+				if (next.status === "ready") {
+					lastReady = next;
+					snapshot = next;
+				} else if (lastReady !== void 0) snapshot = {
+					...lastReady,
+					stale: true,
+					reason: next.reason ?? "readback-failed"
+				};
+				else snapshot = next;
 				notify();
 			};
-			const start = () => {
-				if (started) return;
-				started = true;
-				if (!listening) {
-					listening = true;
-					(ctx.get?.("remote"))?.$on?.("settings/document-updated", (changed) => {
-						if (changed === namespace) refresh();
-					});
-				}
-				refresh();
+			const refresh = async () => {
+				const ticket = ++generation;
+				const next = await describe(namespace);
+				if (ticket !== generation) return;
+				absorb(next);
+			};
+			const remote = () => ctx.get?.("remote");
+			const stopRemote = () => {
+				remoteOff?.();
+				remoteOff = void 0;
+			};
+			const startRemote = () => {
+				if (remoteOff !== void 0) return;
+				remoteOff = remote()?.$on?.("settings/document-updated", (changed) => {
+					if (changed === namespace) refresh();
+				});
 			};
 			const form = {
 				getSnapshot: () => snapshot,
 				subscribe: (listener) => {
 					listeners.add(listener);
-					start();
+					startRemote();
+					refresh();
 					return () => {
 						listeners.delete(listener);
+						if (listeners.size === 0) stopRemote();
 					};
 				},
 				set: async (field, value) => await form.mutate([{
@@ -1718,37 +1747,63 @@ window.__ModuleLoader__.load({
 				}]),
 				mutate: async (ops, expectedRevision) => {
 					const outcome = await write(namespace, ops, expectedRevision ?? snapshot.revision);
-					if (outcome.snapshot !== void 0) {
-						snapshot = outcome.snapshot;
-						notify();
-					} else await refresh();
+					if (outcome.snapshot !== void 0) absorb(outcome.snapshot);
+					else await refresh();
 					return outcome.ok;
+				},
+				refresh,
+				dispose: () => {
+					stopRemote();
+					listeners.clear();
 				}
 			};
 			return form;
 		}
 		/**
-		* Build one cached form per family namespace over the family settings routes.
-		* @param ctx - the client plugin context (remote subscription is optional).
-		* @returns the seat; each namespace is served by /api/dsh-evolution/settings/*.
+		* Build one seat per client registration; every form's remote listener is released by
+		* the caller's effect. No module-level WeakMap: a replaced registration must not share
+		* a dead seat with the previous one.
 		*/
-		const seats = /* @__PURE__ */ new WeakMap();
 		function createSettingsSeat(ctx) {
-			const cached = seats.get(ctx);
-			if (cached !== void 0) return cached;
 			const forms = /* @__PURE__ */ new Map();
-			const seat = { get(namespace) {
-				let form = forms.get(namespace);
-				if (form === void 0) {
-					form = createForm(namespace, ctx);
-					forms.set(namespace, form);
+			return {
+				get(namespace) {
+					let form = forms.get(namespace);
+					if (form === void 0) {
+						form = createForm(namespace, ctx);
+						forms.set(namespace, form);
+					}
+					return form;
+				},
+				dispose: () => {
+					for (const form of forms.values()) form.dispose?.();
+					forms.clear();
 				}
-				return form;
-			} };
-			seats.set(ctx, seat);
-			return seat;
+			};
 		}
 		//#endregion
+		//#region ../evolution-client-kit/src/format.ts
+		/**
+		* Format an ISO string, epoch milliseconds, or null as local wall time.
+		* Invalid values return null; callers decide how to say "unknown".
+		* @param value - ISO string, epoch ms, or null.
+		* @param options - seconds on/off; defaults to on.
+		* @returns the formatted local time, or null when the value is absent/invalid.
+		*/
+		function formatLocalDateTime(value, options = {}) {
+			if (value === null || value === void 0) return null;
+			const ms = typeof value === "number" ? value : Date.parse(value);
+			if (!Number.isFinite(ms)) return null;
+			const date = new Date(ms);
+			if (Number.isNaN(date.getTime())) return null;
+			const pad = (part) => String(part).padStart(2, "0");
+			const head = String(date.getFullYear()) + "-" + pad(date.getMonth() + 1) + "-" + pad(date.getDate()) + " " + pad(date.getHours()) + ":" + pad(date.getMinutes());
+			return options.seconds === false ? head : head + ":" + pad(date.getSeconds());
+		}
+		//#endregion
+		//#region ../evolution-client-kit/src/notice.ts
+		/** One inline state notice: semantic tone plus text, no surface-specific styling. */
+		//#endregion
 		//#region ../evolution-client-kit/src/action.ts
 		/**
 		* Command-only actions. Approval decisions are a separate host API and must never
@@ -1848,7 +1903,8 @@ window.__ModuleLoader__.load({
 				user: snapshot.user,
 				writable: snapshot.writable,
 				base: isRecord(snapshot.base) ? snapshot.base : void 0,
-				...snapshot.status === "unavailable" ? { reason: snapshot.reason ?? "not-served" } : {}
+				...snapshot.status === "unavailable" ? { reason: snapshot.reason ?? "not-served" } : {},
+				...snapshot.stale === true ? { stale: true } : {}
 			};
 		}
 		/**
@@ -1958,7 +2014,6 @@ window.__ModuleLoader__.load({
 					readback: "failed",
 					kind: "transport"
 				};
-				const before = seat.getSnapshot().revision;
 				let written = false;
 				try {
 					written = await seat.mutate(ops);
@@ -1970,12 +2025,15 @@ window.__ModuleLoader__.load({
 						failure
 					};
 				}
-				const snapshot = seat.getSnapshot();
 				if (!written) return {
 					written: false,
 					readback: "failed",
 					kind: "conflict"
 				};
+				try {
+					await seat.refresh?.();
+				} catch {}
+				const snapshot = seat.getSnapshot();
 				if (snapshot.status !== "ready") return {
 					written: true,
 					readback: "failed",
@@ -1983,7 +2041,8 @@ window.__ModuleLoader__.load({
 				};
 				return {
 					written: true,
-					readback: snapshot.revision !== before ? "ok" : "failed"
+					readback: snapshot.stale === true ? "failed" : "ok",
+					...snapshot.stale === true ? { kind: "transport" } : {}
 				};
 			};
 			return {
@@ -2586,6 +2645,8 @@ window.__ModuleLoader__.load({
 			* read, because a half-list would read as a complete window.
 			*/
 			const readTicket = (0, react.useRef)(0);
+			const previewTicket = (0, react.useRef)(0);
+			const actionTickets = (0, react.useRef)(/* @__PURE__ */ new Map());
 			const load = async () => {
 				apply(loading);
 				const ticket = readTicket.current + 1;
@@ -2613,9 +2674,13 @@ window.__ModuleLoader__.load({
 				};
 			}, []);
 			const decide = (id, action) => {
+				if (latest.current.busy.includes(id)) return;
+				const ticket = (actionTickets.current.get(id) ?? 0) + 1;
+				actionTickets.current.set(id, ticket);
 				apply((current) => beginAction(current, id));
 				(async () => {
 					const answer = action === "approve" ? await api.approve(id) : action === "reject" ? await api.reject(id) : await api.release(id);
+					if (actionTickets.current.get(id) !== ticket) return;
 					if (!answer.ok) {
 						apply((current) => noticed(endAction(current, id), failureText(answer.failure, translate)));
 						return;
@@ -2631,7 +2696,9 @@ window.__ModuleLoader__.load({
 			};
 			/** Ask the host what this record would store; the answer lands only if the row is still open. */
 			const loadPreview = async (id) => {
+				const ticket = ++previewTicket.current;
 				const answer = await api.preview(id);
+				if (ticket !== previewTicket.current || latest.current.open !== id) return;
 				const view = answer.ok ? answer.data.available ? {
 					kind: "ready",
 					answer: answer.data
@@ -2685,7 +2752,13 @@ window.__ModuleLoader__.load({
 					}, t("approvalDiffCut"))] : []
 				];
 				const lines = [];
+				const multiHunk = view.answer.hunks.length > 1 || view.answer.hunks.some((hunk) => hunk.path !== view.answer.path);
 				for (const [hunkIndex, hunk] of view.answer.hunks.entries()) {
+					if (multiHunk) lines.push((0, react.createElement)("div", {
+						key: "hunk-" + String(hunkIndex),
+						className: "evolution-param-hunk-path",
+						"data-role": "hunk-path"
+					}, hunk.path));
 					for (const [index, line] of hunk.oldText.split("\n").entries()) {
 						if (hunk.oldText === "" && line === "") continue;
 						lines.push((0, react.createElement)("div", {
@@ -2854,6 +2927,7 @@ window.__ModuleLoader__.load({
 		const zh = {
 			"entry.label": "技能历史",
 			title: "技能历史",
+			bodyTitle: "正文版本",
 			"workbench.history": "技能历史",
 			"workbench.pending": "待批",
 			"workbench.merge": "合并",
@@ -2883,6 +2957,7 @@ window.__ModuleLoader__.load({
 			"failure.server": "读取失败，可以重试。",
 			"fallback.hint": "可以改用命令：{command}",
 			"undo.confirm": "确认回退（会写入一版，可再回退）",
+			"undo.confirmUnit": "确认回退整个跨技能写入单元（会写入一版，可再回退）",
 			"undo.no": "取消",
 			current: "当前",
 			"versions.count": "{n} 个版本",
@@ -2923,6 +2998,7 @@ window.__ModuleLoader__.load({
 			"action.archive": "归档",
 			"action.archive.note": "这一版存的是被归档的正文",
 			"action.consolidate": "合并",
+			"action.merge": "合并",
 			"action.restructure": "结构调整",
 			"action.extract": "跨技能提取",
 			"action.support-write": "写入附带文件",
@@ -2946,6 +3022,7 @@ window.__ModuleLoader__.load({
 		const en = {
 			"entry.label": "Skill history",
 			title: "Skill history",
+			bodyTitle: "Body versions",
 			"workbench.history": "Skill history",
 			"workbench.pending": "Pending",
 			"workbench.merge": "Merge",
@@ -2975,6 +3052,7 @@ window.__ModuleLoader__.load({
 			"failure.server": "The read failed; you can retry.",
 			"fallback.hint": "Command fallback: {command}",
 			"undo.confirm": "Confirm restore (writes a new version; can be undone)",
+			"undo.confirmUnit": "Confirm restoring the whole cross-skill unit (writes a new version; can be undone)",
 			"undo.no": "Cancel",
 			current: "Current",
 			"versions.count": "{n} versions",
@@ -3015,6 +3093,7 @@ window.__ModuleLoader__.load({
 			"action.archive": "archived",
 			"action.archive.note": "this version holds the archived body",
 			"action.consolidate": "merged",
+			"action.merge": "merged",
 			"action.restructure": "restructured",
 			"action.extract": "extracted across skills",
 			"action.support-write": "support file written",
@@ -3081,6 +3160,7 @@ window.__ModuleLoader__.load({
 			".evo-hist-skill[aria-current=\"true\"]{background:var(--dsw-alias-interactive-bg-active);color:var(--dsw-alias-label-primary);font-weight:500}",
 			".evo-hist-cell-line{display:flex;align-items:baseline;gap:var(--evo-space-6);min-width:0}",
 			".evo-hist-cell-meta{margin-top:var(--evo-space-2)}",
+			".evo-hist-skill-description{display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden;margin-top:var(--evo-space-2);color:var(--dsw-alias-label-tertiary)}",
 			".evo-hist-cell{min-width:0;font-variant-numeric:tabular-nums}",
 			".evo-hist-slot-lead{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}",
 			".evo-hist-slot-meta{flex:none;white-space:nowrap}",
@@ -3124,7 +3204,7 @@ window.__ModuleLoader__.load({
 			".evo-doc-tag{position:absolute;left:var(--evo-space-8);top:var(--evo-space-8);color:var(--dsw-alias-label-tertiary)}",
 			".evo-doc-line-add{color:var(--evo-tone-success)}",
 			".evo-doc-line-del{color:var(--evo-tone-danger)}",
-			"@media (max-width:720px){.evo-hist-root{flex-direction:column}.evo-hist-aside{flex:0 0 auto;width:100%;max-height:42%;border-right:0;border-bottom:var(--evo-hairline-width) solid var(--dsw-alias-border-l2)}.evo-hist-row{max-width:none}}"
+			"@media (max-width:900px){.evo-hist-root{flex-direction:column}.evo-hist-aside{flex:0 0 auto;width:100%;max-height:42%;border-right:0;border-bottom:var(--evo-hairline-width) solid var(--dsw-alias-border-l2)}.evo-hist-row{max-width:none}}"
 		].join("\n");
 		//#endregion
 		//#region src/panels/history/client/atoms.ts
@@ -3232,11 +3312,7 @@ window.__ModuleLoader__.load({
 		*/
 		/** The local time an ISO timestamp names, as the operator's own clock shows it. */
 		function localTime(at) {
-			const parsed = Date.parse(at);
-			if (Number.isNaN(parsed)) return at;
-			const date = new Date(parsed);
-			const pad = (value) => String(value).padStart(2, "0");
-			return String(date.getFullYear()) + "-" + pad(date.getMonth() + 1) + "-" + pad(date.getDate()) + " " + pad(date.getHours()) + ":" + pad(date.getMinutes());
+			return formatLocalDateTime(at, { seconds: false }) ?? at;
 		}
 		/** The text one cell shows, resolved through the seat. */
 		function cellText(copy, cell) {
@@ -3285,7 +3361,11 @@ window.__ModuleLoader__.load({
 				className: "evo-hist-skill",
 				"aria-current": selected ? "true" : void 0,
 				onClick: onOpen
-			}, cellLine(row.cells.title, copy, "evo-hist-cell-line"), cellLine(row.cells.meta, copy, "evo-hist-cell-line evo-hist-cell-meta"));
+			}, cellLine(row.cells.title, copy, "evo-hist-cell-line"), (() => {
+				const description = row.cells.meta.filter((cell) => cell.key === "description");
+				const facts = row.cells.meta.filter((cell) => cell.key !== "description");
+				return [description.length === 0 ? null : cellLine(description, copy, "evo-hist-cell-line evo-hist-skill-description"), facts.length === 0 ? null : cellLine(facts, copy, "evo-hist-cell-line evo-hist-cell-meta")];
+			})());
 		}
 		/**
 		* One version row: what happened, when, how big — then the controls, then whatever is expanded.
@@ -3313,7 +3393,7 @@ window.__ModuleLoader__.load({
 					key: "undo",
 					tone: confirming ? "primary" : "quiet",
 					onClick: onRestore,
-					children: confirming ? copy.t("undo.confirm") : copy.t("undo")
+					children: confirming ? copy.t(row.unitId === void 0 ? "undo.confirm" : "undo.confirmUnit") : copy.t("undo")
 				}));
 			}
 			if (row.undoable === true || row.charsDelta !== void 0) actions.push(button({
@@ -3373,8 +3453,8 @@ window.__ModuleLoader__.load({
 			});
 		}
 		/** The pane's heading and its one control. */
-		function panelHead(copy, onRefresh) {
-			return (0, react.createElement)("div", { className: "evo-hist-head" }, (0, react.createElement)("h2", { className: "evo-hist-title" }, copy.t("title")), button({
+		function panelHead(copy, onRefresh, title) {
+			return (0, react.createElement)("div", { className: "evo-hist-head" }, (0, react.createElement)("h2", { className: "evo-hist-title" }, title ?? copy.t("title")), button({
 				key: "refresh",
 				title: copy.t("refresh"),
 				onClick: onRefresh,
@@ -3900,7 +3980,7 @@ window.__ModuleLoader__.load({
 			};
 			return (0, react.createElement)("div", { className: "evo-hist-root" }, (0, react.createElement)("aside", { className: "evo-hist-aside" }, searchField(face, query, setQuery), (0, react.createElement)("div", { className: "evo-hist-list" }, skills.length === 0 ? emptyState(face.t(skillsLoaded ? "empty.skills" : "loading")) : visible.length === 0 ? emptyState(face.t("search.none")) : visible.map((skill) => skillLine(face, skill, skill.name === selected, () => {
 				open(skill.name);
-			})))), (0, react.createElement)("div", { className: "evo-hist-main" }, panelHead(face, refresh), notice(noteText, noteError), failure === void 0 ? null : (0, react.createElement)("div", { className: "evo-hist-failure" }, failureBlock(face.t, failure)), selected === void 0 ? [emptyState(face.t(skills.length === 0 ? skillsLoaded ? "empty.skills" : "loading" : "empty.pick"), "empty"), (0, react.createElement)("p", {
+			})))), (0, react.createElement)("div", { className: "evo-hist-main" }, panelHead(face, refresh, selected ?? face.t("bodyTitle")), notice(noteText, noteError), failure === void 0 ? null : (0, react.createElement)("div", { className: "evo-hist-failure" }, failureBlock(face.t, failure)), selected === void 0 ? [emptyState(face.t(skills.length === 0 ? skillsLoaded ? "empty.skills" : "loading" : "empty.pick"), "empty"), (0, react.createElement)("p", {
 				key: "hint",
 				className: "evo-hist-hint"
 			}, face.t("hint"))] : loaded ? null : emptyState(versionsFailed === void 0 ? face.t("loading") : `${face.t("empty.versions.failed")} — ${versionsFailed}`), loaded ? (0, react.createElement)("div", null, group(face.t("group.content"), payload.content, void 0), group(face.t("group.support"), payload.support, face.t("group.support.note")), payload.content.length === 0 && payload.support.length === 0 ? (0, react.createElement)("p", { className: "evo-hist-hint" }, face.t("empty.versions")) : null) : null));
@@ -3980,19 +4060,26 @@ window.__ModuleLoader__.load({
 			const translate = (key, values) => t(key, values);
 			const [state, setState] = (0, react.useState)({ phase: "loading" });
 			const [refreshing, setRefreshing] = (0, react.useState)(false);
+			const [refreshFailure, setRefreshFailure] = (0, react.useState)(void 0);
 			const [open, setOpen] = (0, react.useState)(false);
 			const ticket = (0, react.useRef)(0);
 			const read = (keepView) => {
 				const current = ticket.current + 1;
 				ticket.current = current;
-				if (keepView) setRefreshing(true);
-				else setState({ phase: "loading" });
+				if (keepView) {
+					setRefreshing(true);
+					setRefreshFailure(void 0);
+				} else setState({ phase: "loading" });
 				api.view().then((answer) => {
 					if (ticket.current !== current) return;
-					setState(answer.ok ? {
-						phase: "ready",
-						view: answer.data
-					} : {
+					if (answer.ok) {
+						setState({
+							phase: "ready",
+							view: answer.data
+						});
+						setRefreshFailure(void 0);
+					} else if (keepView) setRefreshFailure(answer.failure);
+					else setState({
 						phase: "failed",
 						failure: answer.failure
 					});
@@ -4007,6 +4094,7 @@ window.__ModuleLoader__.load({
 				read(true);
 			};
 			const summary = state.phase === "ready" ? summaryOf(state.view.runtime) : void 0;
+			const focusRow = summary === void 0 || summary.status === "ok" || state.phase !== "ready" ? void 0 : state.view.runtime.find((row) => row.status === summary.status);
 			const header = (0, react.createElement)("button", {
 				type: "button",
 				className: "evolution-param-head",
@@ -4017,7 +4105,7 @@ window.__ModuleLoader__.load({
 			}, (0, react.createElement)("span", { className: "evolution-param-card-title" }, t("diagTitle")), summary === void 0 ? null : (0, react.createElement)("span", {
 				className: "evo-diag-badge",
 				"data-status": summary.status
-			}, t(SUMMARY_KEYS[summary.status], summary.count === 0 ? void 0 : { n: summary.count })), (0, react.createElement)("span", { className: "evolution-param-chevron" }, open ? "▲" : "▼"));
+			}, t(SUMMARY_KEYS[summary.status], summary.count === 0 ? void 0 : { n: summary.count })), focusRow === void 0 ? null : (0, react.createElement)("span", { "data-role": "diag-focus" }, focusRow.label), (0, react.createElement)("span", { className: "evolution-param-chevron" }, open ? "▲" : "▼"));
 			const runtime = (view) => view.runtime.length === 0 ? null : (0, react.createElement)("div", {}, (0, react.createElement)("h3", { className: "evolution-param-group" }, t("diagRuntimeTitle")), (0, react.createElement)("div", { className: "evo-diag-list" }, ...view.runtime.map((row) => (0, react.createElement)("div", {
 				key: "runtime-" + row.key,
 				className: "evo-diag-item",
@@ -4032,13 +4120,26 @@ window.__ModuleLoader__.load({
 					fallback: props.fallback
 				});
 				const view = state.view;
-				return (0, react.createElement)("div", {}, (0, react.createElement)("p", { className: "evolution-param-note" }, t("diagSubtitle")), (0, react.createElement)("div", { className: "evolution-param-actions" }, (0, react.createElement)("button", {
+				return (0, react.createElement)("div", {}, (0, react.createElement)("p", { className: "evolution-param-note" }, t("diagSubtitle")), refreshFailure === void 0 ? null : FailureBlock({
+					failure: refreshFailure,
+					t: translate,
+					fallback: props.fallback
+				}), (0, react.createElement)("div", { className: "evolution-param-actions" }, (0, react.createElement)("button", {
 					type: "button",
 					className: "evolution-param-button",
 					onClick: refresh,
 					disabled: refreshing,
 					"data-action": "diag-refresh"
-				}, t(refreshing ? "diagRefreshing" : "diagRefresh"))), runtime(view), view.runtime.length === 0 ? (0, react.createElement)("p", { className: "evolution-param-note" }, t("diagNoRows")) : null);
+				}, t(refreshing ? "diagRefreshing" : "diagRefresh"))), runtime(view), view.runtime.length === 0 ? (0, react.createElement)("p", { className: "evolution-param-note" }, t("diagNoRows")) : null, (0, react.createElement)("p", {
+					className: "evolution-param-note",
+					"data-role": "diag-purpose"
+				}, t("diagPurpose")), (0, react.createElement)("p", {
+					className: "evolution-param-hint",
+					"data-role": "diag-footer"
+				}, t("diagFooter", {
+					version: String(view.schemaVersion),
+					at: new Date(view.generatedAt).toLocaleString()
+				})));
 			};
 			return (0, react.createElement)("section", {
 				className: "evolution-param-card",
@@ -4061,16 +4162,23 @@ window.__ModuleLoader__.load({
 		* @returns the page surface.
 		*/
 		function WorkbenchPage(props) {
-			const [selectedSkill, setSelectedSkill] = (0, react.useState)(void 0);
-			const [view, setView] = (0, react.useState)("history");
-			const [focusRevision, setFocusRevision] = (0, react.useState)(0);
+			const state = (0, react.useSyncExternalStore)(props.store.subscribe, props.store.getState, props.store.getState);
+			const view = state.view;
+			const selectedSkill = state.selectedSkill;
+			const focusRevision = state.focusRevision;
 			const openHistory = (skill) => {
-				setSelectedSkill(skill);
-				setView("history");
-				setFocusRevision((value) => value + 1);
+				props.store.openHistory(skill);
 			};
 			const hasMerge = props.hasView?.("merge") ?? true;
 			const hasHealth = props.hasView?.("health") ?? true;
+			(0, react.useEffect)(() => {
+				if (view === "merge" && !hasMerge || view === "health" && !hasHealth) props.store.setView("history");
+			}, [
+				view,
+				hasMerge,
+				hasHealth,
+				props.store
+			]);
 			const viewOrder = [
 				"history",
 				"pending",
@@ -4084,7 +4192,7 @@ window.__ModuleLoader__.load({
 				event.preventDefault();
 				const index = viewOrder.indexOf(current);
 				const next = event.key === "Home" ? viewOrder[0] : event.key === "End" ? viewOrder[viewOrder.length - 1] : viewOrder[(index + delta + viewOrder.length) % viewOrder.length];
-				setView(next);
+				props.store.setView(next);
 				requestAnimationFrame(() => {
 					document.getElementById("evo-workbench-tab-" + next)?.focus();
 				});
@@ -4105,7 +4213,7 @@ window.__ModuleLoader__.load({
 				"aria-controls": "evo-workbench-panel",
 				"data-active": view === "history" ? "true" : void 0,
 				onClick: () => {
-					setView("history");
+					props.store.setView("history");
 				},
 				onKeyDown: (event) => {
 					onTabKey(event, "history");
@@ -4119,7 +4227,7 @@ window.__ModuleLoader__.load({
 				"aria-controls": "evo-workbench-panel",
 				"data-active": view === "pending" ? "true" : void 0,
 				onClick: () => {
-					setView("pending");
+					props.store.setView("pending");
 				},
 				onKeyDown: (event) => {
 					onTabKey(event, "pending");
@@ -4133,7 +4241,7 @@ window.__ModuleLoader__.load({
 				"aria-controls": "evo-workbench-panel",
 				"data-active": view === "merge" ? "true" : void 0,
 				onClick: () => {
-					setView("merge");
+					props.store.setView("merge");
 				},
 				onKeyDown: (event) => {
 					onTabKey(event, "merge");
@@ -4147,7 +4255,7 @@ window.__ModuleLoader__.load({
 				"aria-controls": "evo-workbench-panel",
 				"data-active": view === "health" ? "true" : void 0,
 				onClick: () => {
-					setView("health");
+					props.store.setView("health");
 				},
 				onKeyDown: (event) => {
 					onTabKey(event, "health");
@@ -4161,7 +4269,7 @@ window.__ModuleLoader__.load({
 				"aria-controls": "evo-workbench-panel",
 				"data-active": view === "diagnostics" ? "true" : void 0,
 				onClick: () => {
-					setView("diagnostics");
+					props.store.setView("diagnostics");
 				},
 				onKeyDown: (event) => {
 					onTabKey(event, "diagnostics");
@@ -4211,12 +4319,51 @@ window.__ModuleLoader__.load({
 			".evo-workbench-title{margin:0;font-size:var(--evo-type-lg);font-weight:600;line-height:var(--evo-leading-base)}",
 			".evo-workbench-body{display:flex;flex:1;min-height:0;min-width:0;overflow:hidden}",
 			".evo-workbench-body>.evolution-param-card{flex:1;min-width:0;overflow:auto}",
-			".evo-workbench-nav{display:flex;width:100%;align-items:center;gap:var(--evo-space-8);padding:var(--evo-space-6) var(--evo-space-12);border:0;border-radius:var(--evo-radius-control);background:transparent;color:var(--dsw-alias-label-secondary);font:inherit;font-size:var(--evo-type-sm);text-align:left;cursor:pointer}",
-			".evo-workbench-nav:hover,.evo-workbench-nav[data-active=\"true\"]{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary)}",
-			".evo-workbench-nav:focus-visible{outline:var(--evo-focus-ring);outline-offset:var(--evo-focus-offset)}",
 			"@media (max-width:720px){.evo-workbench-head{flex-wrap:wrap}.evo-workbench-tabs{flex-wrap:wrap}}"
 		].join("");
 		//#endregion
+		//#region src/panels/history/client/WorkbenchStore.ts
+		function createWorkbenchStore(initial = {
+			view: "history",
+			focusRevision: 0
+		}) {
+			let state = initial;
+			const listeners = /* @__PURE__ */ new Set();
+			const emit = (next) => {
+				state = next;
+				for (const listener of listeners) listener();
+			};
+			return {
+				getState: () => state,
+				subscribe(listener) {
+					listeners.add(listener);
+					return () => {
+						listeners.delete(listener);
+					};
+				},
+				setView(view) {
+					if (state.view !== view) emit({
+						...state,
+						view
+					});
+				},
+				openHistory(skill) {
+					emit({
+						view: "history",
+						...skill === void 0 ? {} : { selectedSkill: skill },
+						focusRevision: state.focusRevision + 1
+					});
+				},
+				clearSelection() {
+					const { selectedSkill: _selected, ...rest } = state;
+					emit({
+						...rest,
+						focusRevision: state.focusRevision + 1
+					});
+				}
+			};
+		}
+		//#endregion
 		//#region src/panels/history/client/index.ts
 		/**
 		* Register the locale namespace, the workbench main occupant and its sidebar row.
@@ -4225,6 +4372,9 @@ window.__ModuleLoader__.load({
 		function apply$1(ctx) {
 			const api = createSkillHistoryApi();
 			const settingsSeat = createSettingsSeat(ctx);
+			ctx.effect(() => () => {
+				settingsSeat.dispose?.();
+			}, "evolution-ui: settings seat");
 			let approvalConfirmMode = "ask";
 			const approvalForm = settingsSeat.get("evolution-approval");
 			const stopApprovalWatch = approvalForm?.subscribe(() => {
@@ -4273,6 +4423,7 @@ window.__ModuleLoader__.load({
 				api: createDiagnosticsApi((input, init) => fetch(input, init)),
 				fallback: FALLBACKS.diagnostics
 			});
+			const workbenchStore = createWorkbenchStore();
 			registerSidebarPanel(ctx, {
 				id: WORKBENCH_ID,
 				order: 35,
@@ -4289,6 +4440,7 @@ window.__ModuleLoader__.load({
 				component: WorkbenchPage,
 				body: (t) => ({
 					t,
+					store: workbenchStore,
 					history: historyFace(t),
 					pending: pendingFace(),
 					diagnostics: diagnosticsFace(),

package/lib/types/panels/history/client/Workbench.d.ts

@@ -7,23 +7,20 @@ import { type ReactNode } from 'react';
 import { type PanelFace } from './Panel.ts';
 import { type PendingCardFace } from '../../settings/PendingCard.ts';
 import { type DiagnosticsCardFace } from '../../settings/DiagnosticsCard.ts';
+import type { WorkbenchStore } from './WorkbenchStore.ts';
 /** Stable page id used by the sidebar row, the page slot key, and navigation params. */
 export declare const WORKBENCH_ID = "evolution.workbench";
 /** Injected face: copy plus the history view's data callbacks. */
 export interface WorkbenchFace {
     readonly t: (key: string) => string;
+    readonly store: WorkbenchStore;
     readonly history: PanelFace;
     readonly pending: PendingCardFace;
     readonly diagnostics: DiagnosticsCardFace;
     /** Whether a feature view is actually mounted (health is disabled by default). */
     readonly hasView?: (view: 'merge' | 'health') => boolean;
 }
-/** The two views the workbench owns today. */
-export type WorkbenchView = 'history' | 'pending' | 'merge' | 'health' | 'diagnostics';
-/** Sidebar row injected face. */
-export interface WorkbenchNavFace {
-    readonly t: (key: string) => string;
-}
+export type { WorkbenchView } from './WorkbenchStore.ts';
 /**
  * Render the workbench page. The platform keeps it mounted; this component only
  * consumes a new explicit revision exactly once.

package/lib/types/panels/history/client/WorkbenchStore.d.ts

@@ -0,0 +1,16 @@
+/** Registration-owned workbench navigation state. No module-level singleton. */
+export type WorkbenchView = 'history' | 'pending' | 'merge' | 'health' | 'diagnostics';
+export interface WorkbenchState {
+    readonly view: WorkbenchView;
+    readonly selectedSkill?: string;
+    readonly focusRevision: number;
+}
+export interface WorkbenchStore {
+    getState(): WorkbenchState;
+    subscribe(listener: () => void): () => void;
+    setView(view: WorkbenchView): void;
+    openHistory(skill?: string): void;
+    clearSelection(): void;
+}
+export declare function createWorkbenchStore(initial?: WorkbenchState): WorkbenchStore;
+//# sourceMappingURL=WorkbenchStore.d.ts.map

package/lib/types/panels/history/client/chrome.d.ts

@@ -72,5 +72,5 @@ export declare function emptyState(text: string, key?: string): ReactNode;
 /** One notice about what just happened. */
 export declare function notice(text: string | undefined, error: boolean): ReactNode;
 /** The pane's heading and its one control. */
-export declare function panelHead(copy: Copy, onRefresh: () => void): ReactNode;
+export declare function panelHead(copy: Copy, onRefresh: () => void, title?: string): ReactNode;
 //# sourceMappingURL=chrome.d.ts.map

package/lib/types/panels/settings/generated-about.d.ts

@@ -5,7 +5,7 @@
  * description, so the settings surface can state both without a hand-written copy.
  */
 /** The family version this surface belongs to. */
-export declare const FAMILY_VERSION = "0.33.0";
+export declare const FAMILY_VERSION = "0.35.0";
 /** What this surface is for, in one line. */
 export declare const PACKAGE_PURPOSE = "Web UI umbrella for the evolution family: settings and skill-history panels";
 //# sourceMappingURL=generated-about.d.ts.map

package/lib/types/panels/settings/messages.d.ts

@@ -23,12 +23,12 @@ export declare const zh: {
     readonly projectionFailed: "这一块读设置时出错，已记入日志；其它参数不受影响";
     readonly readonly: "本次会话不允许写入设置（临时运行模式）";
     readonly apply: "保存";
-    readonly reset: "恢复默认值";
+    readonly reset: "复位";
     readonly empty: "这里没有可改项";
     readonly changed: "{n} 项已覆盖";
     readonly discard: "放弃修改";
     readonly saving: "保存中…";
-    readonly resetting: "恢复中…";
+    readonly resetting: "复位中…";
     readonly writeTargetHost: "保存去向：宿主配置（对所有会话生效）";
     readonly invalidNumber: "需要一个数字";
     readonly invalidSelect: "不在允许的取值里";
@@ -40,6 +40,7 @@ export declare const zh: {
     readonly resetTo: "复位为 {value}";
     readonly saved: "已保存。";
     readonly saveReadbackFailed: "写入已被接受，但回读失败；点刷新重读后再确认。";
+    readonly readbackStale: "显示的是最后一次成功读取的值；当前回读失败，刷新后可能变化。";
     readonly saveConflict: "这个值没有被接受：设置已被其他页面修改。请重读后再保存。";
     readonly resetDone: "已恢复默认值。";
     readonly refused: "这个值没有被接受（界面上保持原样）。想看原因：在对话里让它说明。";
@@ -108,6 +109,8 @@ export declare const zh: {
     readonly diagStatusUnknown: "未知";
     readonly diagRemedy: "建议：";
     readonly diagNoRows: "没有可显示的运行状态";
+    readonly diagPurpose: "用途：检查插件挂载、平台服务和数据面是否正常，不修改任何状态。";
+    readonly diagFooter: "诊断 schema v{version} · 生成于 {at}";
     readonly stateLoading: "正在读取…";
     readonly failureUnauthorized: "需要登录：重新打开这个页面完成登录后再试。";
     readonly failureForbidden: "平台拒绝了这个请求（身份不是 owner）。";

package/lib/types/panels/settings/seam.d.ts

@@ -45,7 +45,9 @@ export interface ParamSectionSnapshot {
      * all, or the seat is there and serves no such row. The two read differently to the
      * operator (one is the UI's own gap, the other is a row that is not composed).
      */
-    reason?: 'seat-missing' | 'not-served' | 'projection-failed';
+    reason?: 'seat-missing' | 'not-served' | 'projection-failed' | 'readback-failed';
+    /** Last-known values are still shown; the row could not be re-read. */
+    stale?: boolean;
 }
 /** The reactive source the renderer binds to a `use<Name>` seat. */
 export interface ParamSectionSource {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-ui",
   "description": "Web UI umbrella for the evolution family: settings and skill-history panels (community build)",
-  "version": "0.33.0",
+  "version": "0.35.0",
   "publishConfig": {
     "access": "public"
   },
@@ -45,9 +45,9 @@
     "react": "^18.2.0"
   },
   "dependencies": {
-    "@lmzhen/dsh-evolution-client-kit": "^0.33.0",
-    "@lmzhen/dsh-evolution-core": "^0.33.0",
-    "@lmzhen/dsh-evolution-curator": "^0.33.0"
+    "@lmzhen/dsh-evolution-client-kit": "^0.35.0",
+    "@lmzhen/dsh-evolution-core": "^0.35.0",
+    "@lmzhen/dsh-evolution-curator": "^0.35.0"
   },
   "devDependencies": {
     "@types/react": "~18.3.1",