@zhengjunyao/dsh-restart 0.1.0

package/lib/client.js

@@ -0,0 +1,1706 @@
+window.__ModuleLoader__.load({
+	id: "@zhengjunyao/dsh-restart",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react = require("react");
+		let react_dom_client = require("react-dom/client");
+		let react_jsx_runtime = require("react/jsx-runtime");
+		//#region src/client/api.ts
+		/** Error carrying the route's JSON error message. */
+		var RestartApiError = class extends Error {
+			status;
+			constructor(message, status = 0) {
+				super(message);
+				this.status = status;
+				this.name = "RestartApiError";
+			}
+		};
+		/** One JSON request with a hard timeout (a dead server must not hang the UI). */
+		async function request(path, init = {}, timeoutMs = 6e3) {
+			const controller = new AbortController();
+			const timer = setTimeout(() => controller.abort(), timeoutMs);
+			let response;
+			try {
+				response = await fetch(path, {
+					...init,
+					signal: controller.signal,
+					cache: "no-store"
+				});
+			} catch (error) {
+				throw new RestartApiError(error instanceof Error && error.name === "AbortError" ? "请求超时（服务可能正在重启）" : "网络请求失败: " + String(error instanceof Error ? error.message : error));
+			} finally {
+				clearTimeout(timer);
+			}
+			let body;
+			try {
+				body = await response.json();
+			} catch {
+				throw new RestartApiError("HTTP " + response.status + ": 响应不是合法 JSON", response.status);
+			}
+			if (!response.ok) throw new RestartApiError(typeof body === "object" && body !== null && typeof body.error === "string" ? body.error : "HTTP " + response.status, response.status);
+			return body;
+		}
+		/** The dsh-restart panel API. */
+		var RestartApi = class {
+			/** Host + helper + config + history. */
+			async status() {
+				return request("/api/dsh-restart/status");
+			}
+			/** Liveness probe used while reconnecting (short timeout, tiny body). */
+			async probe(timeoutMs = 2500) {
+				return request("/api/dsh-restart/probe", {}, timeoutMs);
+			}
+			/** Ask for a restart; the host answers before it exits. */
+			async restart(reason, source = "web") {
+				return request("/api/dsh-restart/restart", {
+					method: "POST",
+					headers: { "Content-Type": "application/json" },
+					body: JSON.stringify({
+						reason,
+						source
+					})
+				}, 1e4);
+			}
+			/** Boot-log tail; `which: 'latest'` = newest log file on disk. */
+			async logs(which = "latest", lines = 200) {
+				return request(`/api/dsh-restart/logs?which=${encodeURIComponent(which)}&lines=${String(lines)}`, {}, 8e3);
+			}
+			/** Restart history, newest first. */
+			async history(limit = 20) {
+				return request(`/api/dsh-restart/history?limit=${String(limit)}`);
+			}
+			/** Patch (or reset) the plugin config. */
+			async setConfig(patch) {
+				return request("/api/dsh-restart/config", {
+					method: "POST",
+					headers: { "Content-Type": "application/json" },
+					body: JSON.stringify(patch)
+				});
+			}
+			/** Live helper state (through the host). */
+			async helper() {
+				return request("/api/dsh-restart/helper");
+			}
+			/** Ask a failed helper to try again. */
+			async helperRetry() {
+				return request("/api/dsh-restart/helper/retry", { method: "POST" }, 4e3);
+			}
+		};
+		/**
+		* Read the detached helper's live state straight from its console port.
+		*
+		* Used only while DSH itself is unreachable: the helper is a different origin
+		* (another port) but answers with `Access-Control-Allow-Origin: *`.
+		*/
+		async function fetchHelperDirect(consoleUrl, timeoutMs = 2500) {
+			if (consoleUrl === "") return null;
+			const controller = new AbortController();
+			const timer = setTimeout(() => controller.abort(), timeoutMs);
+			try {
+				const response = await fetch(`${consoleUrl}/status`, {
+					signal: controller.signal,
+					cache: "no-store"
+				});
+				if (!response.ok) return null;
+				return await response.json();
+			} catch {
+				return null;
+			} finally {
+				clearTimeout(timer);
+			}
+		}
+		/**
+		* Fetch the helper's copy-ready failure report.
+		*
+		* Served by the recovery console (a different port, CORS-open), so it is
+		* reachable exactly when the main server is not — which is when a failure
+		* report matters.
+		*/
+		async function fetchHelperReport(consoleUrl, timeoutMs = 3e3) {
+			if (consoleUrl === "") return "";
+			const controller = new AbortController();
+			const timer = setTimeout(() => controller.abort(), timeoutMs);
+			try {
+				const response = await fetch(`${consoleUrl}/report`, {
+					signal: controller.signal,
+					cache: "no-store"
+				});
+				return response.ok ? await response.text() : "";
+			} catch {
+				return "";
+			} finally {
+				clearTimeout(timer);
+			}
+		}
+		/** Ask the helper (direct) to relaunch after a failure. */
+		async function requestHelperRetry(consoleUrl, timeoutMs = 3e3) {
+			if (consoleUrl === "") return false;
+			const controller = new AbortController();
+			const timer = setTimeout(() => controller.abort(), timeoutMs);
+			try {
+				return (await fetch(`${consoleUrl}/retry`, {
+					method: "POST",
+					signal: controller.signal
+				})).ok;
+			} catch {
+				return false;
+			} finally {
+				clearTimeout(timer);
+			}
+		}
+		//#endregion
+		//#region src/client/state.ts
+		/**
+		* dsh-restart — the browser-side restart state machine.
+		*
+		* One module-level store, subscribed to by every surface (settings card,
+		* sidebar popover, full-screen overlay). A restart is a process that outlives
+		* the page it started from, so the state is mirrored into sessionStorage: if
+		* the tab reloads mid-restart, the overlay picks the wait back up instead of
+		* leaving the user on a dead page with no explanation.
+		*
+		* The lifecycle:
+		*
+		*   requesting ──POST /api/dsh-restart/restart──▶ waiting
+		*   waiting ──probe /api/dsh-restart/probe every N ms──▶ ready ──▶ location.reload()
+		*   waiting ──helper reports failure──▶ failed (keeps probing; the helper can
+		*                                       be retried from the overlay)
+		*/
+		/** Storage key for resuming across a reload. */
+		const STORAGE_KEY = "dsh-restart/pending";
+		/** A pending restart older than this is treated as stale and dropped. */
+		const RESUME_WINDOW_MS = 15 * 6e4;
+		/** Grace period before the helper is consulted (the old host needs to die first). */
+		const HELPER_PROBE_AFTER_MS = 5e3;
+		/** How long the page waits after the server answers before reloading. */
+		const RELOAD_DELAY_MS = 700;
+		const api$1 = new RestartApi();
+		let state = {
+			phase: "idle",
+			startedAt: 0,
+			elapsedMs: 0,
+			fallbackUrl: "",
+			port: 0,
+			logFile: "",
+			error: "",
+			note: "",
+			helper: null,
+			ack: null,
+			config: null,
+			reloadAt: null,
+			source: "web",
+			reason: "",
+			retrying: false
+		};
+		const listeners = /* @__PURE__ */ new Set();
+		let ticker = null;
+		let prober = null;
+		let probing = false;
+		/** Current snapshot (stable identity between mutations). */
+		function getState() {
+			return state;
+		}
+		/** Subscribe to state changes. */
+		function subscribe(listener) {
+			listeners.add(listener);
+			return () => {
+				listeners.delete(listener);
+			};
+		}
+		/** Merge a patch into the snapshot and notify subscribers. */
+		function setState(patch) {
+			state = {
+				...state,
+				...patch
+			};
+			for (const listener of listeners) listener();
+		}
+		/** Remember the essentials so a reload can resume the wait. */
+		function persist() {
+			try {
+				if (state.phase === "idle") {
+					sessionStorage.removeItem(STORAGE_KEY);
+					return;
+				}
+				sessionStorage.setItem(STORAGE_KEY, JSON.stringify({
+					phase: state.phase,
+					startedAt: state.startedAt,
+					fallbackUrl: state.fallbackUrl,
+					port: state.port,
+					logFile: state.logFile,
+					source: state.source,
+					reason: state.reason,
+					ack: state.ack
+				}));
+			} catch {}
+		}
+		/** Drop the persisted marker. */
+		function clearPersisted() {
+			try {
+				sessionStorage.removeItem(STORAGE_KEY);
+			} catch {}
+		}
+		/** Keep the two timers from stacking up. */
+		function stopLoops() {
+			if (ticker !== null) {
+				clearInterval(ticker);
+				ticker = null;
+			}
+			if (prober !== null) {
+				clearTimeout(prober);
+				prober = null;
+			}
+			probing = false;
+		}
+		/** Start the elapsed-time ticker (cheap; drives the overlay counter). */
+		function startTicker() {
+			if (ticker !== null) return;
+			ticker = setInterval(() => {
+				if (state.startedAt === 0) return;
+				setState({ elapsedMs: Date.now() - state.startedAt });
+			}, 250);
+		}
+		/** Reload as soon as the new host answered. */
+		function scheduleReload() {
+			if (state.reloadAt !== null) return;
+			setState({
+				reloadAt: Date.now(),
+				note: "已就绪，正在刷新页面…"
+			});
+			clearPersisted();
+			setTimeout(() => {
+				try {
+					location.reload();
+				} catch {}
+			}, RELOAD_DELAY_MS);
+		}
+		/** One reconnect probe; schedules the next one. */
+		async function probeOnce() {
+			if (probing) return;
+			probing = true;
+			let ok = false;
+			try {
+				await api$1.probe();
+				ok = true;
+			} catch {
+				ok = false;
+			}
+			probing = false;
+			if (ok) {
+				setState({
+					phase: "ready",
+					helper: null,
+					error: ""
+				});
+				stopLoops();
+				if (state.config?.autoReload === false) setState({ note: "新宿主已就绪，点击「刷新页面」加载新代码。" });
+				else scheduleReload();
+				persist();
+				return;
+			}
+			setState({
+				phase: state.phase === "failed" ? "failed" : "waiting",
+				note: state.phase === "failed" ? "启动失败，可重试或查看报错。" : "正在等待新宿主启动…"
+			});
+			const waited = Date.now() - state.startedAt;
+			if (waited >= HELPER_PROBE_AFTER_MS && state.fallbackUrl !== "") {
+				const helper = await fetchHelperDirect(state.fallbackUrl);
+				if (helper !== null) {
+					const failedNow = helper.phase === "failed";
+					setState({
+						helper,
+						error: failedNow ? helper.failure?.message ?? "启动失败（助手未给出原因）" : state.error,
+						phase: failedNow ? "failed" : "waiting",
+						note: failedNow ? "启动失败：新进程没能起来，下面是它的输出。" : "正在启动新宿主…（可通过恢复控制台查看日志）"
+					});
+				} else if (state.helper === null && waited > 2e4) setState({ note: "仍在等待新宿主；若长时间没有响应，请打开恢复控制台查看日志。" });
+			}
+			persist();
+			scheduleProbe(state.config?.probeIntervalMs ?? 1200);
+		}
+		/** Queue the next probe. */
+		function scheduleProbe(intervalMs) {
+			if (prober !== null) clearTimeout(prober);
+			prober = setTimeout(() => {
+				probeOnce();
+			}, Math.max(300, intervalMs));
+		}
+		/** Load the config once so the reconnect follows the user's preferences. */
+		async function refreshConfig() {
+			try {
+				const status = await api$1.status();
+				setState({ config: status.config });
+				return status.config;
+			} catch {
+				return null;
+			}
+		}
+		/**
+		* Start a restart and stay on top of it.
+		* @param reason - free-text reason recorded in the host's history.
+		* @param source - who asked (the panel passes 'web').
+		*/
+		async function startRestart(reason = "", source = "web") {
+			if (state.phase === "requesting" || state.phase === "waiting") return;
+			stopLoops();
+			setState({
+				phase: "requesting",
+				startedAt: Date.now(),
+				elapsedMs: 0,
+				error: "",
+				note: "正在下发重启指令…",
+				helper: null,
+				ack: null,
+				reloadAt: null,
+				source,
+				reason,
+				retrying: false
+			});
+			persist();
+			try {
+				const ack = await api$1.restart(reason, source);
+				const config = state.config ?? await refreshConfig();
+				setState({
+					phase: "waiting",
+					ack,
+					fallbackUrl: ack.fallbackUrl,
+					port: ack.fallbackPort,
+					logFile: ack.logFile,
+					note: "旧进程正在退出，等待新宿主启动…",
+					config
+				});
+				persist();
+				startTicker();
+				scheduleProbe(1e3);
+			} catch (error) {
+				setState({
+					phase: "failed",
+					error: "重启指令下发失败：" + (error instanceof RestartApiError ? error.message : String(error instanceof Error ? error.message : error)),
+					note: "宿主没有接受重启请求，服务仍在运行。"
+				});
+				persist();
+			}
+		}
+		/** Probe right now (the overlay's "立即重试" button). */
+		async function checkNow() {
+			if (state.phase === "idle") return;
+			setState({ note: "正在检测…" });
+			await probeOnce();
+		}
+		/** Ask the helper to relaunch after a failed boot. */
+		async function retryBoot() {
+			if (state.phase !== "failed") return;
+			setState({
+				retrying: true,
+				note: "已请求重启助手再试一次…"
+			});
+			let ok = false;
+			try {
+				ok = (await api$1.helperRetry()).ok;
+			} catch {
+				ok = await requestHelperRetry(state.fallbackUrl);
+			}
+			if (!ok) ok = await requestHelperRetry(state.fallbackUrl);
+			setState({
+				retrying: false,
+				phase: ok ? "waiting" : "failed",
+				error: ok ? "" : state.error,
+				note: ok ? "重启助手正在重新拉起…" : "重试请求没有送达；请打开恢复控制台手动重试。"
+			});
+			if (ok) {
+				startTicker();
+				scheduleProbe(1e3);
+			}
+		}
+		/** Dismiss the overlay without touching the server. */
+		function dismiss() {
+			stopLoops();
+			clearPersisted();
+			setState({
+				phase: "idle",
+				startedAt: 0,
+				elapsedMs: 0,
+				error: "",
+				note: "",
+				helper: null,
+				ack: null,
+				reloadAt: null,
+				retrying: false
+			});
+		}
+		/**
+		* Resume a restart that was in flight when the page went away.
+		*
+		* Called once at mount by the overlay; a no-op when nothing is pending.
+		*/
+		function resumeIfPending() {
+			if (state.phase !== "idle") return;
+			let raw = null;
+			try {
+				raw = sessionStorage.getItem(STORAGE_KEY);
+			} catch {
+				return;
+			}
+			if (raw === null) return;
+			let parsed = null;
+			try {
+				parsed = JSON.parse(raw);
+			} catch {
+				clearPersisted();
+				return;
+			}
+			const startedAt = typeof parsed?.startedAt === "number" ? parsed.startedAt : 0;
+			if (startedAt === 0 || Date.now() - startedAt > RESUME_WINDOW_MS) {
+				clearPersisted();
+				return;
+			}
+			if (parsed?.phase !== "waiting" && parsed?.phase !== "requesting" && parsed?.phase !== "failed") return;
+			setState({
+				phase: "waiting",
+				startedAt,
+				elapsedMs: Date.now() - startedAt,
+				fallbackUrl: typeof parsed.fallbackUrl === "string" ? parsed.fallbackUrl : "",
+				port: typeof parsed.port === "number" ? parsed.port : 0,
+				logFile: typeof parsed.logFile === "string" ? parsed.logFile : "",
+				source: typeof parsed.source === "string" ? parsed.source : "web",
+				reason: typeof parsed.reason === "string" ? parsed.reason : "",
+				ack: parsed.ack ?? null,
+				note: "检测到未完成的重启，继续等待新宿主…",
+				error: typeof parsed.error === "string" ? parsed.error : ""
+			});
+			refreshConfig().then(() => {
+				scheduleProbe(600);
+			});
+			startTicker();
+		}
+		/** React binding: re-renders the caller whenever the restart state changes. */
+		function useRestartState() {
+			return (0, react.useSyncExternalStore)(subscribe, getState, getState);
+		}
+		//#endregion
+		//#region src/client/RestartPanel.tsx
+		/**
+		* dsh-restart panel — the visible entry for the restart plugin.
+		*
+		* Rendered in two places from one component: as a settings-page section
+		* (`settings.section` slot, variant="settings") and inside the popover opened
+		* from the sidebar entry (variant="floating"). It shows what is running, offers
+		* the one-click restart, and — this is the point — surfaces the boot log and
+		* the lines that look like errors, so a plugin that fails to load is visible
+		* without going back to a terminal.
+		*
+		* Plain React, inline styles only, theme-agnostic, no emoji.
+		*/
+		/** Module-level API client (stateless; the component closes over it). */
+		const api = new RestartApi();
+		/** Accent for primary actions. */
+		const ACCENT = "#2b6cb0";
+		/** Failure colour. */
+		const DANGER$1 = "#c0392b";
+		/** Healthy colour. */
+		const OK = "#2f9e5f";
+		/** One shared style sheet. */
+		const s = {
+			card: {
+				display: "flex",
+				flexDirection: "column",
+				gap: "12px",
+				maxWidth: "680px",
+				padding: "14px 16px",
+				borderRadius: "10px",
+				border: "1px solid rgba(128,128,128,0.3)",
+				fontSize: "13px",
+				color: "inherit",
+				boxSizing: "border-box"
+			},
+			floatCard: {
+				display: "flex",
+				flexDirection: "column",
+				gap: "10px",
+				width: "420px",
+				maxHeight: "74vh",
+				overflowY: "auto",
+				padding: "14px 16px",
+				borderRadius: "12px",
+				border: "1px solid rgba(128,128,128,0.3)",
+				fontSize: "13px",
+				color: "inherit",
+				boxSizing: "border-box"
+			},
+			head: {
+				display: "flex",
+				alignItems: "center",
+				gap: "8px"
+			},
+			dot: {
+				width: 8,
+				height: 8,
+				borderRadius: "50%",
+				flex: "none",
+				background: "#c9cdd4"
+			},
+			title: {
+				fontWeight: 600,
+				fontSize: "13px",
+				margin: 0,
+				flex: 1
+			},
+			grid: {
+				display: "grid",
+				gridTemplateColumns: "76px 1fr",
+				gap: "4px 12px",
+				fontSize: "12px"
+			},
+			label: { opacity: .6 },
+			value: { wordBreak: "break-all" },
+			primary: {
+				padding: "9px 14px",
+				borderRadius: "8px",
+				border: "1px solid #2b6cb0",
+				background: ACCENT,
+				color: "#fff",
+				cursor: "pointer",
+				fontSize: "13px",
+				fontWeight: 600
+			},
+			danger: {
+				padding: "9px 14px",
+				borderRadius: "8px",
+				border: "1px solid #c0392b",
+				background: DANGER$1,
+				color: "#fff",
+				cursor: "pointer",
+				fontSize: "13px",
+				fontWeight: 600
+			},
+			button: {
+				padding: "6px 11px",
+				borderRadius: "7px",
+				border: "1px solid rgba(128,128,128,0.35)",
+				background: "transparent",
+				color: "inherit",
+				cursor: "pointer",
+				fontSize: "12px"
+			},
+			row: {
+				display: "flex",
+				gap: "8px",
+				flexWrap: "wrap",
+				alignItems: "center"
+			},
+			log: {
+				margin: 0,
+				maxHeight: "180px",
+				overflow: "auto",
+				padding: "9px 11px",
+				borderRadius: "8px",
+				background: "rgba(128,128,128,0.10)",
+				border: "1px solid rgba(128,128,128,0.22)",
+				font: "11.5px/1.55 ui-monospace,SFMono-Regular,Menlo,monospace",
+				whiteSpace: "pre-wrap",
+				wordBreak: "break-word",
+				color: "inherit"
+			},
+			error: {
+				color: DANGER$1,
+				fontWeight: 600,
+				wordBreak: "break-word"
+			},
+			muted: {
+				opacity: .62,
+				fontSize: "12px"
+			},
+			section: {
+				display: "flex",
+				flexDirection: "column",
+				gap: "8px",
+				paddingTop: "10px",
+				borderTop: "1px solid rgba(128,128,128,0.22)"
+			},
+			field: {
+				display: "flex",
+				alignItems: "center",
+				gap: "8px",
+				justifyContent: "space-between"
+			},
+			input: {
+				width: "108px",
+				padding: "4px 7px",
+				borderRadius: "6px",
+				border: "1px solid rgba(128,128,128,0.35)",
+				background: "transparent",
+				color: "inherit",
+				fontSize: "12px",
+				boxSizing: "border-box"
+			},
+			badge: {
+				padding: "1px 7px",
+				borderRadius: "999px",
+				border: "1px solid rgba(128,128,128,0.35)",
+				fontSize: "11px",
+				opacity: .85
+			}
+		};
+		/** Human duration from milliseconds. */
+		function human$1(ms) {
+			if (!Number.isFinite(ms) || ms <= 0) return "—";
+			const total = Math.round(ms / 1e3);
+			if (total < 60) return `${total} 秒`;
+			const minutes = Math.floor(total / 60);
+			const seconds = total % 60;
+			if (minutes < 60) return `${minutes} 分 ${seconds} 秒`;
+			return `${Math.floor(minutes / 60)} 小时 ${minutes % 60} 分`;
+		}
+		/** Local time from an ISO string. */
+		function localTime(iso) {
+			if (iso === "") return "—";
+			const date = new Date(iso);
+			if (Number.isNaN(date.getTime())) return iso;
+			const pad = (value) => String(value).padStart(2, "0");
+			return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`;
+		}
+		/** Phase label for the live helper. */
+		const PHASE_LABEL = {
+			"waiting-port-free": "等待旧进程退出",
+			starting: "正在启动",
+			"waiting-ready": "等待就绪",
+			ready: "已就绪",
+			retrying: "正在重试",
+			failed: "启动失败"
+		};
+		/** Copy text to the clipboard, reporting whether it worked. */
+		async function copyText(text) {
+			try {
+				await navigator.clipboard.writeText(text);
+				return true;
+			} catch {
+				return false;
+			}
+		}
+		/** One panel render. */
+		function RestartPanel(props) {
+			const variant = props.variant ?? "settings";
+			const live = useRestartState();
+			const [status, setStatus] = (0, react.useState)(null);
+			const [logs, setLogs] = (0, react.useState)(null);
+			const [draft, setDraft] = (0, react.useState)(null);
+			const [busy, setBusy] = (0, react.useState)(false);
+			const [error, setError] = (0, react.useState)("");
+			const [notice, setNotice] = (0, react.useState)("");
+			const [showLog, setShowLog] = (0, react.useState)(false);
+			const [showSettings, setShowSettings] = (0, react.useState)(false);
+			/** Load status + boot log. */
+			const load = (0, react.useCallback)(async () => {
+				setBusy(true);
+				try {
+					const next = await api.status();
+					setStatus(next);
+					setDraft((current) => current ?? next.config);
+					setError("");
+					const tail = await api.logs("latest", Math.max(60, next.config.logLines));
+					setLogs(tail);
+				} catch (caught) {
+					setError(caught instanceof RestartApiError ? caught.message : String(caught));
+				} finally {
+					setBusy(false);
+				}
+			}, []);
+			(0, react.useEffect)(() => {
+				load();
+				const timer = setInterval(() => {
+					if (live.phase === "idle") load();
+				}, 2e4);
+				return () => clearInterval(timer);
+			}, [load, live.phase]);
+			(0, react.useEffect)(() => {
+				if (!notice) return;
+				const timer = setTimeout(() => setNotice(""), 2600);
+				return () => clearTimeout(timer);
+			}, [notice]);
+			const restarting = live.phase === "requesting" || live.phase === "waiting";
+			const config = draft ?? status?.config ?? null;
+			/**
+			* Only ever show helper state that belongs to THIS host.
+			*
+			* A helper reports the pid it replaced (`oldPid`) and the pid it started
+			* (`childPid`); neither matching this process means it is somebody else's
+			* restart — a leftover helper on the fallback port, for instance. Rendering
+			* that as "重启助手 启动失败" claims a failure the user never had.
+			*/
+			const ownedHelper = (0, react.useMemo)(() => {
+				const candidate = live.helper ?? status?.helper ?? null;
+				if (candidate === null) return null;
+				const hostPid = status?.host.pid;
+				if (hostPid === void 0) return live.phase !== "idle" ? candidate : null;
+				return candidate.oldPid === hostPid || candidate.childPid === hostPid ? candidate : null;
+			}, [
+				live.helper,
+				live.phase,
+				status?.helper,
+				status?.host.pid
+			]);
+			const helper = ownedHelper;
+			const helperAlive = live.phase !== "idle" ? live.helper !== null : ownedHelper !== null && (status?.helperAlive ?? false);
+			const bootErrors = logs?.errorLines ?? [];
+			const consoleUrl = live.fallbackUrl !== "" ? live.fallbackUrl : status?.consoleUrl ?? "";
+			/** One-click restart. */
+			const onRestart = (0, react.useCallback)(async () => {
+				setNotice("");
+				if (restarting) return;
+				try {
+					await refreshConfig();
+				} catch {}
+				await startRestart("web 面板点击重启", "web");
+			}, [restarting]);
+			/**
+			* Copy a self-contained diagnosis report.
+			*
+			* The restart failure report (written by the helper) wins when it exists;
+			* otherwise compose the same shape from the status + boot log this panel
+			* already has, so the button is always useful.
+			*/
+			const copyDiagnosis = (0, react.useCallback)(async () => {
+				const fromHelper = await fetchHelperReport(consoleUrl);
+				if (fromHelper !== "") {
+					const ok = await copyText(fromHelper);
+					setNotice(ok ? "已复制重启失败报告（来自恢复控制台），可直接粘贴给 AI" : "复制失败");
+					return;
+				}
+				const ok = await copyText([
+					"# DSH 重启插件诊断报告",
+					"",
+					`- 时间：${(/* @__PURE__ */ new Date()).toISOString()}`,
+					`- 宿主：pid ${status?.host.pid ?? "?"}｜${status?.host.url ?? ""}｜DSH ${status?.host.dshVersion ?? "?"}｜Node ${status?.host.nodeVersion ?? "?"}`,
+					`- 已运行：${status === null ? "?" : human$1(status.host.uptimeMs)}　启动于 ${localTime(status?.host.startedAt ?? "")}`,
+					`- 启动命令：${status?.host.command ?? "?"}`,
+					`- 重启方式：${status?.host.launchd.managed === true ? `launchd ${status.host.launchd.label}（${status.host.launchd.state}）` : "分离助手自拉起"}`,
+					`- 助手：${helperAlive ? `运行中（${PHASE_LABEL[helper?.phase ?? ""] ?? helper?.phase ?? "?"}，第 ${helper?.attempt ?? 1}/${helper?.maxAttempts ?? 1} 次）` : "未运行"}`,
+					helper?.failure?.message !== void 0 ? `- 上次失败原因：${helper.failure.message}` : "",
+					helper?.childExit != null ? `- 退出码：${String(helper.childExit.code)}${helper.childExit.signal != null ? " / " + helper.childExit.signal : ""}` : "",
+					`- 启动日志：${logs?.file ?? "（无）"}`,
+					live.error !== "" ? `- 面板错误：${live.error}` : "",
+					error !== "" ? `- 接口错误：${error}` : "",
+					"",
+					"## 疑似报错行",
+					"",
+					"```",
+					bootErrors.length === 0 ? "（未识别出明显报错行）" : bootErrors.join("\n"),
+					"```",
+					"",
+					"## 启动日志（最后 80 行）",
+					"",
+					"```",
+					(logs?.lines ?? []).slice(-80).join("\n") || "（无日志）",
+					"```",
+					"",
+					"## 最近重启记录",
+					"",
+					...(status?.history ?? []).slice(0, 5).map((record) => `- ${record.at}｜${record.source}｜${record.reason}｜pid ${record.oldPid} → 助手 ${record.helperPid ?? "—"}`),
+					""
+				].filter((line) => line !== "").join("\n"));
+				setNotice(ok ? "已复制诊断报告，可直接粘贴给 AI" : "复制失败");
+			}, [
+				bootErrors,
+				consoleUrl,
+				error,
+				helper,
+				helperAlive,
+				live.error,
+				logs,
+				status
+			]);
+			/** Persist the config patch. */
+			const saveConfig = (0, react.useCallback)(async (patch) => {
+				try {
+					const result = await api.setConfig(patch);
+					setDraft(result.config);
+					setStatus((current) => current === null ? current : {
+						...current,
+						config: result.config
+					});
+					setNotice("已保存（下次重启生效的项会在重启后应用）");
+					setError("");
+				} catch (caught) {
+					setError(caught instanceof RestartApiError ? caught.message : String(caught));
+				}
+			}, []);
+			/** The boot-log block, shared by both variants. */
+			const logBlock = (0, react.useMemo)(() => {
+				if (logs === null) return null;
+				if (!logs.exists) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					style: s.muted,
+					children: "暂无启动日志（重启一次后，新宿主的输出会记录在这里）。"
+				});
+				const lines = logs.lines.slice(-80);
+				return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						style: s.row,
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								style: s.muted,
+								children: logs.file
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { style: { marginLeft: "auto" } }),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								style: s.button,
+								onClick: () => {
+									copyText([
+										...bootErrors,
+										"",
+										...lines
+									].join("\n")).then((ok) => setNotice(ok ? "已复制启动日志" : "复制失败"));
+								},
+								children: "复制"
+							})
+						]
+					}),
+					bootErrors.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						style: s.error,
+						children: [
+							"检测到 ",
+							bootErrors.length,
+							" 行疑似报错："
+						]
+					}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						style: s.muted,
+						children: "未发现明显报错。"
+					}),
+					bootErrors.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("pre", {
+						style: s.log,
+						children: bootErrors.join("\n")
+					}) : null,
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("pre", {
+						style: s.log,
+						children: lines.join("\n")
+					})
+				] });
+			}, [logs, bootErrors]);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				style: variant === "settings" ? s.card : s.floatCard,
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						style: s.head,
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { style: {
+								...s.dot,
+								background: error !== "" ? DANGER$1 : restarting ? "#e0a13a" : OK
+							} }),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
+								style: s.title,
+								children: "重启 DSH"
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								style: s.badge,
+								children: live.phase === "idle" ? "空闲" : PHASE_LABEL[live.phase] ?? live.phase
+							}),
+							props.onClose !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								style: s.button,
+								onClick: props.onClose,
+								children: "收起"
+							}) : null
+						]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						style: s.grid,
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								style: s.label,
+								children: "宿主"
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								style: s.value,
+								children: status === null ? "读取中…" : `pid ${status.host.pid} · ${status.host.url}`
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								style: s.label,
+								children: "版本"
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								style: s.value,
+								children: status === null ? "—" : `DSH ${status.host.dshVersion || "未知"} · Node ${status.host.nodeVersion}`
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								style: s.label,
+								children: "已运行"
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								style: s.value,
+								children: status === null ? "—" : `${human$1(status.host.uptimeMs)}（启动于 ${localTime(status.host.startedAt)}）`
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								style: s.label,
+								children: "重启方式"
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								style: s.value,
+								children: [status === null ? "—" : status.host.launchd.managed ? `launchd 托管（${status.host.launchd.label}${status.host.launchd.state === "" ? "" : " · " + status.host.launchd.state}）— 由 launchd 拉起，避免与自己拉起的进程抢端口` : "分离助手自拉起（等端口释放后用相同命令重启）", config !== null && config.restartMode !== "auto" ? `　·　配置强制：${config.restartMode}` : ""]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								style: s.label,
+								children: "启动命令"
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								style: {
+									...s.value,
+									fontFamily: "ui-monospace, Menlo, monospace",
+									fontSize: "11.5px"
+								},
+								children: status === null ? "—" : status.host.command
+							})
+						]
+					}),
+					restarting || live.phase === "failed" ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						style: live.phase === "failed" ? s.error : s.muted,
+						children: [live.note, live.phase === "failed" && live.error !== "" ? `｜${live.error}` : ""]
+					}) : null,
+					error !== "" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						style: s.error,
+						children: error
+					}) : null,
+					notice !== "" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						style: s.muted,
+						children: notice
+					}) : null,
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						style: s.row,
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								style: restarting || busy ? {
+									...s.primary,
+									opacity: .6,
+									cursor: "default"
+								} : s.primary,
+								disabled: restarting,
+								onClick: () => {
+									onRestart();
+								},
+								children: restarting ? "正在重启…" : "立即重启"
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								style: s.button,
+								onClick: () => {
+									load();
+								},
+								children: "刷新状态"
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								style: s.button,
+								onClick: () => {
+									copyDiagnosis();
+								},
+								children: "复制诊断报告"
+							}),
+							consoleUrl !== "" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								style: s.button,
+								onClick: () => window.open(consoleUrl, "_blank", "noopener"),
+								children: "恢复控制台"
+							}) : null
+						]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						style: s.muted,
+						children: "点击后旧进程退出、分离的重启助手用完全相同的命令拉起新宿主，本页会自动重连并刷新；若新宿主启动失败，报错会直接显示在上方遮罩与恢复控制台。"
+					}),
+					helperAlive && helper !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						style: s.section,
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								style: s.row,
+								children: [
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("strong", { children: "重启助手" }),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										style: s.badge,
+										children: PHASE_LABEL[helper.phase ?? ""] ?? helper.phase ?? "未知"
+									}),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+										style: s.muted,
+										children: [
+											"第 ",
+											helper.attempt ?? 1,
+											"/",
+											helper.maxAttempts ?? 1,
+											" 次 · 已 ",
+											human$1(helper.elapsedMs ?? 0)
+										]
+									})
+								]
+							}),
+							helper.failure?.message !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								style: s.error,
+								children: helper.failure.message
+							}) : null,
+							helper.errorLines !== void 0 && helper.errorLines.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("pre", {
+								style: s.log,
+								children: helper.errorLines.map((entry) => entry.text).join("\n")
+							}) : null,
+							helper.logFile != null && helper.logFile !== "" ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								style: s.muted,
+								children: ["日志：", helper.logFile]
+							}) : null
+						]
+					}) : null,
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						style: s.section,
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							style: s.row,
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								style: s.button,
+								onClick: () => setShowLog((value) => !value),
+								children: showLog ? "收起启动日志" : "上次启动日志"
+							}), bootErrors.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								style: s.error,
+								children: [bootErrors.length, " 行疑似报错"]
+							}) : logs?.exists === true ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								style: s.muted,
+								children: "无明显报错"
+							}) : null]
+						}), showLog ? logBlock : null]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						style: s.section,
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							style: s.row,
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("strong", { children: "重启记录" }), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								style: s.muted,
+								children: [status?.history.length ?? 0, " 条"]
+							})]
+						}), status === null || status.history.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							style: s.muted,
+							children: "还没有通过本插件重启过。"
+						}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							style: {
+								display: "flex",
+								flexDirection: "column",
+								gap: "4px"
+							},
+							children: status.history.slice(0, 6).map((record) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								style: s.muted,
+								children: [
+									localTime(record.at),
+									" · ",
+									record.source,
+									record.reason === "" ? "" : `（${record.reason}）`,
+									" · pid ",
+									record.oldPid,
+									" →",
+									" ",
+									record.helperPid === null ? "—" : `助手 ${record.helperPid}`
+								]
+							}, `${record.at}-${record.helperPid ?? 0}`))
+						})]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						style: s.section,
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							style: s.row,
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								style: s.button,
+								onClick: () => setShowSettings((value) => !value),
+								children: showSettings ? "收起设置" : "插件设置"
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								style: s.muted,
+								children: ["配置文件：", status?.configFile ?? "—"]
+							})]
+						}), showSettings && config !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+								style: s.field,
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: "重启方式（auto 自动识别 launchd）" }), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
+									style: s.input,
+									value: config.restartMode,
+									onChange: (event) => void saveConfig({ restartMode: event.target.value }),
+									children: [
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+											value: "auto",
+											children: "auto"
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+											value: "launchd",
+											children: "launchd"
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+											value: "helper",
+											children: "helper"
+										})
+									]
+								})]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+								style: s.field,
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: "新宿主应答后自动刷新页面" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+									type: "checkbox",
+									checked: config.autoReload,
+									onChange: (event) => void saveConfig({ autoReload: event.target.checked })
+								})]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+								style: s.field,
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: "重启时显示全屏遮罩" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+									type: "checkbox",
+									checked: config.showOverlay,
+									onChange: (event) => void saveConfig({ showOverlay: event.target.checked })
+								})]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+								style: s.field,
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: "启动超时（毫秒，3000-900000）" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+									type: "number",
+									style: s.input,
+									defaultValue: config.bootTimeoutMs,
+									onBlur: (event) => void saveConfig({ bootTimeoutMs: Number(event.target.value) })
+								})]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+								style: s.field,
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: "自动重试次数（1-5）" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+									type: "number",
+									style: s.input,
+									defaultValue: config.maxAttempts,
+									onBlur: (event) => void saveConfig({ maxAttempts: Number(event.target.value) })
+								})]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+								style: s.field,
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: "恢复控制台端口（默认 3099）" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+									type: "number",
+									style: s.input,
+									defaultValue: config.fallbackPort,
+									onBlur: (event) => void saveConfig({ fallbackPort: Number(event.target.value) })
+								})]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								style: s.row,
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									style: s.button,
+									onClick: () => {
+										api.setConfig({ reset: true }).then((result) => {
+											setDraft(result.config);
+											setNotice("已恢复默认设置");
+										}).catch((caught) => setError(String(caught)));
+									},
+									children: "恢复默认设置"
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									style: s.muted,
+									children: "重启助手每次重启都会重新读取这些设置。"
+								})]
+							})
+						] }) : null]
+					})
+				]
+			});
+		}
+		//#endregion
+		//#region src/client/floating.tsx
+		/**
+		* Sidebar entry for dsh-restart.
+		*
+		* The restart control belongs next to the other plugin entries in the left
+		* sidebar's settings area (`[class*="settingsArea"]`), not in a corner of its
+		* own — my other plugins already mount there, so this entry joins their
+		* horizontal row when it exists and creates the row when it does not.
+		*
+		* The button itself only opens the panel; the actual restart is the panel's
+		* primary button, so a stray click in the sidebar can never kill the session.
+		* The icon reflects live state (idle / restarting / failed) so the sidebar is
+		* enough to tell whether something went wrong.
+		*
+		* If the settings area never appears (a shell without it), the entry falls back
+		* to a fixed bottom-right ball. A MutationObserver re-places it whenever the
+		* anchor changes, because the sidebar is React-rendered and may be recreated.
+		*/
+		/** Container id, so a hot reload does not stack copies. */
+		const CONTAINER_ID$1 = "dsh-restart-entry";
+		/** Stylesheet id. */
+		const STYLE_ID$1 = "dsh-restart/entry.css";
+		/** Class marking the inline (sidebar) placement. */
+		const INLINE_CLASS = "dshrst-inline";
+		/** The settings area my other plugin entries mount into. */
+		const SETTINGS_AREA_SELECTOR = "[class*=\"settingsArea\"]";
+		/** The WeChat bridge's ball — used to seed a shared row when no row exists yet. */
+		const ANCHOR_BALL_SELECTOR = ".dshwx-ball";
+		/** Existing shared row (created by dsh-zhihu); reused when present. */
+		const EXISTING_ROW_SELECTOR = ".dsh-zhihu-row";
+		/** Row this plugin creates when nothing else provides one. */
+		const ROW_CLASS = "dshrst-row";
+		const ROW_SELECTOR = ".dshrst-row";
+		/** Debounce for the placement observer (ms). */
+		const PLACEMENT_DEBOUNCE_MS = 250;
+		const BUSY_COLOR = "#e0a13a";
+		const FAIL_COLOR = "#c0392b";
+		const CSS$1 = [
+			"#dsh-restart-entry .dshrst-fab{position:fixed;right:24px;bottom:24px;width:50px;height:50px;",
+			"border-radius:50%;border:none;outline:none;cursor:pointer;z-index:2147483000;",
+			"background:#2b6cb0;color:#fff;display:flex;align-items:center;justify-content:center;",
+			"box-shadow:0 6px 20px rgba(43,108,176,.32);transition:transform .15s,background .2s}",
+			"#dsh-restart-entry .dshrst-fab:hover{transform:scale(1.06)}",
+			".dshrst-row{display:flex;align-items:center;justify-content:flex-start}",
+			"#dsh-restart-entry.dshrst-inline{display:flex;align-items:center;flex:none}",
+			"#dsh-restart-entry.dshrst-inline .dshrst-fab{position:static;width:36px;height:36px;",
+			"margin:0 0 0 8px;border-radius:8px;background:transparent;color:inherit;box-shadow:none;",
+			"border:1px solid rgba(128,128,128,.35);opacity:.78;transition:opacity .15s,border-color .15s,color .2s}",
+			"#dsh-restart-entry.dshrst-inline .dshrst-fab:hover{opacity:1;border-color:rgba(128,128,128,.7);transform:none}",
+			"#dsh-restart-entry .dshrst-spin{animation:dshrst-side-spin 1s linear infinite}",
+			"@keyframes dshrst-side-spin{to{transform:rotate(360deg)}}",
+			"#dsh-restart-entry .dshrst-pop{position:fixed;right:24px;bottom:86px;z-index:2147483001;",
+			"border-radius:12px;box-shadow:0 14px 44px rgba(0,0,0,.22);overflow:hidden;color:inherit}",
+			"#dsh-restart-entry.dshrst-inline .dshrst-pop{right:auto;left:24px;bottom:92px}"
+		].join("");
+		/** Inject the stylesheet once. */
+		function injectStyles$1() {
+			if (document.querySelector("style[data-plugin-css=" + JSON.stringify(STYLE_ID$1) + "]") !== null) return;
+			const style = document.createElement("style");
+			style.dataset.plugin = "dsh-restart";
+			style.dataset.pluginCss = STYLE_ID$1;
+			style.textContent = CSS$1;
+			document.head.appendChild(style);
+		}
+		/** Sample the shell's surface colour so the popover matches the active theme. */
+		function surfaceColor() {
+			const isOpaque = (value) => value !== "" && value !== "transparent" && value !== "rgba(0, 0, 0, 0)";
+			const body = getComputedStyle(document.body).backgroundColor;
+			if (isOpaque(body)) return body;
+			const html = getComputedStyle(document.documentElement).backgroundColor;
+			if (isOpaque(html)) return html;
+			const root = document.documentElement;
+			return root.classList.contains("dark") || root.dataset.theme === "dark" || window.matchMedia?.("(prefers-color-scheme: dark)").matches === true ? "#1c1c1e" : "#ffffff";
+		}
+		/** The circular-arrow glyph (monochrome, no emoji). */
+		function RestartIcon(props) {
+			return (0, react.createElement)("svg", {
+				viewBox: "0 0 24 24",
+				width: 17,
+				height: 17,
+				fill: "none",
+				stroke: "currentColor",
+				strokeWidth: 2,
+				strokeLinecap: "round",
+				strokeLinejoin: "round",
+				"aria-hidden": true,
+				className: props.spinning ? "dshrst-spin" : void 0
+			}, (0, react.createElement)("path", { d: "M21 12a9 9 0 1 1-2.64-6.36" }), (0, react.createElement)("polyline", { points: "21 3 21 9 15 9" }));
+		}
+		/** The entry button plus its popover. */
+		function Entry(props) {
+			const [open, setOpen] = (0, react.useState)(false);
+			const live = useRestartState();
+			const busy = live.phase === "requesting" || live.phase === "waiting";
+			const failed = live.phase === "failed";
+			const colour = failed ? FAIL_COLOR : busy ? BUSY_COLOR : void 0;
+			return (0, react.createElement)("div", null, open ? (0, react.createElement)("div", {
+				className: "dshrst-pop",
+				style: { background: surfaceColor() }
+			}, (0, react.createElement)(RestartPanel, {
+				variant: "floating",
+				onClose: () => setOpen(false)
+			})) : null, (0, react.createElement)("button", {
+				type: "button",
+				className: "dshrst-fab",
+				style: colour === void 0 ? void 0 : {
+					background: props.mode === "ball" ? colour : void 0,
+					color: props.mode === "ball" ? "#fff" : colour
+				},
+				title: failed ? "DSH 重启失败 — 点击查看报错" : busy ? "DSH 正在重启…" : "重启 DSH",
+				"aria-label": "重启 DSH",
+				onClick: () => setOpen((value) => !value)
+			}, (0, react.createElement)(RestartIcon, { spinning: busy })));
+		}
+		/** React root handle. */
+		let root$1 = null;
+		/** Place the entry into the sidebar (or fall back to a fixed ball). */
+		function place(container, mode) {
+			if (mode === "ball") {
+				if (container.parentElement !== document.body) document.body.appendChild(container);
+				container.classList.remove(INLINE_CLASS);
+				return;
+			}
+			const settingsArea = document.querySelector(SETTINGS_AREA_SELECTOR);
+			if (settingsArea === null) {
+				if (container.parentElement !== document.body) document.body.appendChild(container);
+				container.classList.remove(INLINE_CLASS);
+				return;
+			}
+			let row = document.querySelector(EXISTING_ROW_SELECTOR) ?? document.querySelector(ROW_SELECTOR);
+			const anchor = document.querySelector(ANCHOR_BALL_SELECTOR);
+			if (row === null && anchor !== null && anchor.parentElement !== null) {
+				const parent = anchor.parentElement;
+				if (parent === settingsArea || settingsArea.contains(parent)) {
+					const created = document.createElement("div");
+					created.className = ROW_CLASS;
+					parent.insertBefore(created, anchor);
+					created.appendChild(anchor);
+					row = created;
+				}
+			}
+			const target = row ?? settingsArea;
+			if (container.parentElement !== target) target.appendChild(container);
+			container.classList.add(INLINE_CLASS);
+		}
+		/** Mount the sidebar entry (idempotent). */
+		async function mountRestartEntry() {
+			if (typeof document === "undefined") return;
+			injectStyles$1();
+			let config = null;
+			try {
+				config = (await new RestartApi().status()).config;
+			} catch {
+				config = null;
+			}
+			const entryMode = config?.entry ?? "sidebar";
+			if (entryMode === "off") return;
+			let container = document.getElementById(CONTAINER_ID$1);
+			if (container === null) {
+				container = document.createElement("div");
+				container.id = CONTAINER_ID$1;
+				container.dataset.plugin = "dsh-restart";
+			}
+			const mode = entryMode === "ball" ? "ball" : "sidebar";
+			place(container, mode);
+			if (root$1 === null) {
+				root$1 = (0, react_dom_client.createRoot)(container);
+				root$1.render((0, react.createElement)(Entry, { mode }));
+			}
+			if (entryMode === "both") {
+				const ballId = "dsh-restart-entry-ball";
+				if (document.getElementById(ballId) === null) {
+					const ball = document.createElement("div");
+					ball.id = ballId;
+					ball.dataset.plugin = "dsh-restart";
+					document.body.appendChild(ball);
+					(0, react_dom_client.createRoot)(ball).render((0, react.createElement)(Entry, { mode: "ball" }));
+				}
+			}
+			let timer = null;
+			new MutationObserver(() => {
+				if (timer !== null) clearTimeout(timer);
+				timer = setTimeout(() => {
+					if (entryMode !== "ball") place(container, "sidebar");
+				}, PLACEMENT_DEBOUNCE_MS);
+			}).observe(document.body, {
+				childList: true,
+				subtree: true
+			});
+		}
+		//#endregion
+		//#region src/client/overlay.tsx
+		/**
+		* dsh-restart — the full-screen restart overlay.
+		*
+		* Restarting DSH kills the very server this page is talking to, so without an
+		* overlay the tab just goes dead: no spinner, no progress, no explanation.
+		* This layer covers the shell while the handoff happens, then reloads the page
+		* by itself. When the new host fails to boot, it shows the failing output — the
+		* helper streams it to the recovery console, which is still reachable even
+		* though DSH is not.
+		*
+		* Rendered from its own React root so it survives any shell re-render.
+		*/
+		/** Container id, so a hot reload does not stack overlays. */
+		const CONTAINER_ID = "dsh-restart-overlay-root";
+		/** Stylesheet id. */
+		const STYLE_ID = "dsh-restart/overlay.css";
+		const DANGER = "#c0392b";
+		const CSS = [
+			"#dsh-restart-overlay-root .dshrst-mask{position:fixed;inset:0;z-index:2147483100;",
+			"background:rgba(12,14,18,.42);backdrop-filter:blur(3px);-webkit-backdrop-filter:blur(3px);",
+			"display:flex;align-items:flex-start;justify-content:center;padding:8vh 20px 40px;overflow:auto}",
+			"#dsh-restart-overlay-root .dshrst-card{width:100%;max-width:680px;border-radius:14px;overflow:hidden;",
+			"box-shadow:0 24px 70px rgba(0,0,0,.35);border:1px solid rgba(128,128,128,.28);color:inherit;",
+			"background:var(--dshrst-surface,#fff);display:flex;flex-direction:column}",
+			"#dsh-restart-overlay-root .dshrst-head{display:flex;align-items:center;gap:10px;padding:16px 20px;",
+			"border-bottom:1px solid rgba(128,128,128,.2)}",
+			"#dsh-restart-overlay-root .dshrst-spin{width:15px;height:15px;border-radius:50%;flex:none;",
+			"border:2px solid rgba(128,128,128,.35);border-top-color:#2b6cb0;animation:dshrst-spin .8s linear infinite}",
+			"@keyframes dshrst-spin{to{transform:rotate(360deg)}}",
+			"#dsh-restart-overlay-root .dshrst-body{padding:16px 20px;display:flex;flex-direction:column;gap:12px}",
+			"#dsh-restart-overlay-root .dshrst-log{margin:0;max-height:220px;overflow:auto;padding:10px 12px;",
+			"border-radius:8px;background:rgba(128,128,128,.10);border:1px solid rgba(128,128,128,.22);",
+			"font:12px/1.55 ui-monospace,SFMono-Regular,Menlo,monospace;white-space:pre-wrap;word-break:break-word}",
+			"#dsh-restart-overlay-root .dshrst-actions{display:flex;gap:8px;flex-wrap:wrap}",
+			"#dsh-restart-overlay-root button{font:inherit;font-size:13px;padding:7px 13px;border-radius:7px;",
+			"border:1px solid rgba(128,128,128,.35);background:transparent;color:inherit;cursor:pointer}",
+			"#dsh-restart-overlay-root button:hover{border-color:rgba(128,128,128,.65)}",
+			"#dsh-restart-overlay-root button.primary{background:#2b6cb0;border-color:#2b6cb0;color:#fff}",
+			"#dsh-restart-overlay-root button.danger{background:#c0392b;border-color:#c0392b;color:#fff}",
+			"#dsh-restart-overlay-root .dshrst-err{color:#c0392b;font-weight:600}",
+			"#dsh-restart-overlay-root .dshrst-muted{opacity:.66;font-size:12px}",
+			"#dsh-restart-overlay-root .dshrst-steps{display:flex;gap:6px;flex-wrap:wrap;font-size:12px}",
+			"#dsh-restart-overlay-root .dshrst-step{padding:2px 9px;border-radius:999px;border:1px solid rgba(128,128,128,.28)}",
+			"#dsh-restart-overlay-root .dshrst-step.on{border-color:#2b6cb0;color:#2b6cb0}"
+		].join("");
+		/** Inject the overlay stylesheet once. */
+		function injectStyles() {
+			if (document.querySelector("style[data-plugin-css=" + JSON.stringify(STYLE_ID) + "]") !== null) return;
+			const style = document.createElement("style");
+			style.dataset.plugin = "dsh-restart";
+			style.dataset.pluginCss = STYLE_ID;
+			style.textContent = CSS;
+			document.head.appendChild(style);
+		}
+		/** The four steps shown as a progress strip. */
+		const STEPS = [
+			{
+				key: "requesting",
+				label: "下发指令"
+			},
+			{
+				key: "restarting",
+				label: "旧进程退出"
+			},
+			{
+				key: "booting",
+				label: "新宿主启动"
+			},
+			{
+				key: "ready",
+				label: "已就绪"
+			}
+		];
+		/** Which step is active for a given phase. */
+		function stepIndex(state) {
+			if (state.phase === "requesting") return 0;
+			if (state.phase === "ready") return 3;
+			if (state.phase === "failed") return 1;
+			const waited = state.elapsedMs;
+			return waited < 2500 ? 0 : waited < 6e3 ? 1 : 2;
+		}
+		/** Title for the overlay header. */
+		function titleOf(state) {
+			if (state.phase === "requesting") return "正在重启 DSH…";
+			if (state.phase === "waiting") return "正在重启 DSH…";
+			if (state.phase === "ready") return "DSH 已就绪";
+			return "DSH 启动失败";
+		}
+		/** Human duration. */
+		function human(ms) {
+			const total = Math.max(0, Math.round(ms / 1e3));
+			const minutes = Math.floor(total / 60);
+			const seconds = total % 60;
+			return minutes > 0 ? `${minutes} 分 ${seconds} 秒` : `${seconds} 秒`;
+		}
+		/** One overlay render. */
+		function Overlay() {
+			const state = useRestartState();
+			const logRef = (0, react.useRef)(null);
+			const [copied, setCopied] = (0, react.useState)(false);
+			const visible = state.phase !== "idle" && (state.config === null || state.config.showOverlay !== false);
+			const tail = (0, react.useMemo)(() => {
+				const lines = state.helper?.tail ?? [];
+				return (state.helper === null && state.error !== "" ? [state.error] : lines).slice(-40);
+			}, [state.helper, state.error]);
+			(0, react.useEffect)(() => {
+				if (logRef.current !== null) logRef.current.scrollTop = logRef.current.scrollHeight;
+			}, [tail]);
+			(0, react.useEffect)(() => {
+				if (!copied) return;
+				const timer = setTimeout(() => setCopied(false), 1800);
+				return () => clearTimeout(timer);
+			}, [copied]);
+			if (!visible) return null;
+			const active = stepIndex(state);
+			const errorText = state.error !== "" ? state.error : state.helper?.failure?.message ?? "";
+			const exit = state.helper?.childExit;
+			const copy = async () => {
+				const report = await fetchHelperReport(state.fallbackUrl);
+				if (report !== "") try {
+					await navigator.clipboard?.writeText(report);
+					setCopied(true);
+					return;
+				} catch {}
+				const text = [
+					`DSH 重启${state.phase === "failed" ? "失败" : ""}报告`,
+					`时间：${new Date(state.startedAt).toISOString()}`,
+					`已等待：${human(state.elapsedMs)}`,
+					errorText === "" ? "" : `错误：${errorText}`,
+					exit != null ? `退出码：${String(exit.code)}${exit.signal != null ? " / " + exit.signal : ""}` : "",
+					state.logFile !== "" ? `日志：${state.logFile}` : "",
+					state.helper?.errorLines?.length ? "\n—— 疑似报错 ——\n" + state.helper.errorLines.map((e) => e.text).join("\n") : "",
+					tail.length > 0 ? "\n—— 启动输出 ——\n" + tail.join("\n") : ""
+				].filter((line) => line !== "").join("\n");
+				try {
+					await navigator.clipboard?.writeText(text);
+					setCopied(true);
+				} catch {
+					setCopied(false);
+				}
+			};
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				className: "dshrst-mask",
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "dshrst-card",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "dshrst-head",
+						children: [
+							state.phase === "ready" ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: "dshrst-spin",
+								style: state.phase === "failed" ? { borderTopColor: DANGER } : void 0
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("strong", {
+								style: { fontSize: 15 },
+								children: titleOf(state)
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								className: "dshrst-muted",
+								style: { marginLeft: "auto" },
+								children: ["已等待 ", human(state.elapsedMs)]
+							})
+						]
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "dshrst-body",
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: "dshrst-steps",
+								children: STEPS.map((step, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: "dshrst-step" + (index <= active ? " on" : ""),
+									style: state.phase === "failed" && index === active ? {
+										borderColor: DANGER,
+										color: DANGER
+									} : void 0,
+									children: step.label
+								}, step.key))
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: "dshrst-muted",
+								children: state.note
+							}),
+							errorText !== "" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: "dshrst-err",
+								children: errorText
+							}) : null,
+							state.helper !== null || tail.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("pre", {
+								className: "dshrst-log",
+								ref: logRef,
+								children: tail.length > 0 ? tail.join("\n") : "（等待新进程输出…）"
+							}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: "dshrst-muted",
+								children: "等待新进程输出…（旧进程退出后，重启助手会接管并记录日志）"
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: "dshrst-muted",
+								style: {
+									display: "flex",
+									gap: 12,
+									flexWrap: "wrap"
+								},
+								children: [
+									state.logFile !== "" ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", { children: ["日志：", state.logFile] }) : null,
+									state.helper?.childPid != null ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", { children: ["新进程 pid：", state.helper.childPid] }) : null,
+									state.ack !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", { children: ["助手 pid：", state.ack.helperPid ?? "—"] }) : null
+								]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: "dshrst-actions",
+								children: [
+									state.phase === "ready" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: "primary",
+										onClick: () => location.reload(),
+										children: "刷新页面"
+									}) : null,
+									state.phase === "failed" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: "danger",
+										onClick: () => void retryBoot(),
+										disabled: state.retrying,
+										children: state.retrying ? "正在重试…" : "让助手重试启动"
+									}) : null,
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										onClick: () => void checkNow(),
+										children: "立即检测"
+									}),
+									state.fallbackUrl !== "" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										onClick: () => window.open(state.fallbackUrl, "_blank", "noopener"),
+										children: "打开恢复控制台"
+									}) : null,
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										onClick: () => void copy(),
+										children: copied ? "已复制" : "复制完整报告"
+									}),
+									state.phase === "failed" || state.phase === "ready" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										onClick: () => {
+											dismiss();
+										},
+										children: "关闭遮罩"
+									}) : null
+								]
+							}),
+							state.phase !== "failed" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: "dshrst-muted",
+								children: "重启期间这个页面会自动重连；新宿主一旦应答，页面会自动刷新加载新代码。"
+							}) : null
+						]
+					})]
+				})
+			});
+		}
+		/** React root handle, so mounting twice is a no-op. */
+		let root = null;
+		/** Mount the overlay root (called once by the client entry). */
+		function mountRestartOverlay() {
+			if (root !== null) return;
+			if (typeof document === "undefined") return;
+			injectStyles();
+			let container = document.getElementById(CONTAINER_ID);
+			if (container === null) {
+				container = document.createElement("div");
+				container.id = CONTAINER_ID;
+				container.dataset.plugin = "dsh-restart";
+				document.body.appendChild(container);
+			}
+			root = (0, react_dom_client.createRoot)(container);
+			root.render(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Overlay, {}));
+			resumeIfPending();
+		}
+		//#endregion
+		//#region src/client/index.ts
+		/** Required services. */
+		const inject = ["slots"];
+		/**
+		* Register the settings card, mount the sidebar entry and the overlay.
+		* @param ctx - client root context.
+		*/
+		function apply(ctx) {
+			try {
+				ctx.slots.inject("settings.section", () => ctx.slots.register({
+					name: "settings.section",
+					id: "restart",
+					order: 338,
+					label: () => "重启"
+				}, RestartPanel));
+			} catch (error) {
+				console.warn("[dsh-restart] settings panel registration failed:", error);
+			}
+			try {
+				mountRestartOverlay();
+			} catch (error) {
+				console.warn("[dsh-restart] overlay mount failed:", error);
+			}
+			try {
+				mountRestartEntry().catch((error) => {
+					console.warn("[dsh-restart] sidebar entry mount failed:", error);
+				});
+			} catch (error) {
+				console.warn("[dsh-restart] sidebar entry mount failed:", error);
+			}
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map