@michengai/dsh-codex-ui 0.2.72 → 0.2.73

package/dist/client.js

@@ -18,6 +18,7 @@ window.__ModuleLoader__.load({
 				if (match !== void 0) return match;
 			}
 		}
+		let cancelPendingNavigation;
 		function openSettingsSection(root, label, onMissing) {
 			const labels = typeof label === "string" ? [label] : label;
 			const trigger = root?.querySelector("[aria-haspopup=\"dialog\"]");
@@ -25,18 +26,48 @@ window.__ModuleLoader__.load({
 				onMissing?.();
 				return;
 			}
-			trigger.click();
-			window.requestAnimationFrame(() => {
-				window.requestAnimationFrame(() => {
-					const target = pickSettingsSectionButton([...document.querySelectorAll("[role=\"dialog\"] nav button")], labels);
-					if (target !== void 0) {
-						target.click();
-						return;
-					}
-					console.warn(`[michengai-codex-ui] 未找到设置分区：${labels.join(" / ")}`);
-					onMissing?.();
+			const opening = cancelPendingNavigation !== void 0;
+			cancelPendingNavigation?.();
+			if (!opening && document.querySelector("[role=\"dialog\"]") === null) trigger.click();
+			let frame;
+			let finished = false;
+			const observer = new MutationObserver(() => {
+				schedule();
+			});
+			const cleanup = () => {
+				if (finished) return;
+				finished = true;
+				observer.disconnect();
+				window.clearTimeout(timeout);
+				if (frame !== void 0) window.cancelAnimationFrame(frame);
+				if (cancelPendingNavigation === cleanup) cancelPendingNavigation = void 0;
+			};
+			const select = () => {
+				const target = pickSettingsSectionButton([...document.querySelectorAll("[role=\"dialog\"] nav button")], labels);
+				if (target === void 0) return false;
+				cleanup();
+				target.click();
+				return true;
+			};
+			const schedule = () => {
+				if (finished || frame !== void 0) return;
+				frame = window.requestAnimationFrame(() => {
+					frame = void 0;
+					select();
 				});
+			};
+			const timeout = window.setTimeout(() => {
+				if (select()) return;
+				cleanup();
+				console.warn(`[michengai-codex-ui] 未找到设置分区：${labels.join(" / ")}`);
+				onMissing?.();
+			}, 1500);
+			observer.observe(document.body, {
+				childList: true,
+				subtree: true
 			});
+			cancelPendingNavigation = cleanup;
+			schedule();
 		}
 		//#endregion
 		//#region src/client/sidebar-search.ts
@@ -52,6 +83,7 @@ window.__ModuleLoader__.load({
 			channels: false,
 			schedule: false
 		};
+		const reportedSlotErrors = /* @__PURE__ */ new WeakSet();
 		/** 插槽声明本身不算占用；只有其他插件 register 后才视为已安装。 */
 		function readSlotEntries(slots, name) {
 			if (slots === void 0) return [];
@@ -59,7 +91,11 @@ window.__ModuleLoader__.load({
 			if (typeof read !== "function") return [];
 			try {
 				return read.call(slots, name) ?? [];
-			} catch {
+			} catch (error) {
+				if (!reportedSlotErrors.has(slots)) {
+					reportedSlotErrors.add(slots);
+					console.warn("[michengai-codex-ui] 无法读取配套插件插槽。", error);
+				}
 				return [];
 			}
 		}
@@ -251,11 +287,19 @@ window.__ModuleLoader__.load({
 			});
 		}
 		/** 读取 IM 频道分组；失败时交给界面显示空态或错误。 */
-		async function loadChannelGroups() {
-			const response = await fetch(CHANNELS_ENDPOINT, { cache: "no-store" });
-			const payload = await response.json();
-			if (!response.ok) throw new Error("无法读取频道会话");
+		async function loadChannelGroups(signal) {
+			const response = await fetch(CHANNELS_ENDPOINT, {
+				cache: "no-store",
+				signal
+			});
+			let payload;
+			try {
+				payload = await response.json();
+			} catch {
+				throw new Error(response.ok ? "频道会话数据格式无效" : "无法读取频道会话");
+			}
 			const root = payload !== null && typeof payload === "object" ? payload : {};
+			if (!response.ok) throw new Error(text(root.error, "无法读取频道会话"));
 			if (root.ok === false) throw new Error(text(root.error, "无法读取频道会话"));
 			return parseChannelGroups(payload);
 		}
@@ -679,7 +723,6 @@ window.__ModuleLoader__.load({
 					card.append(sub);
 				}
 				card.dataset.dcuUserText = text;
-				card.title = text;
 			}
 		}
 		function ensureUserBubbleStyle(doc) {
@@ -790,19 +833,25 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			slider.style.transform = `translateX(${Math.max(0, tabBox.left - listBox.left)}px)`;
 		}
 		function watchTabSelection(tabs) {
-			if (tabs.dataset.dcuTabWatch === "") return;
 			tabs.dataset.dcuTabWatch = "";
 			const sync = () => {
 				syncTabSlider(tabs);
 			};
-			new MutationObserver(sync).observe(tabs, {
+			const onClick = () => {
+				window.requestAnimationFrame(sync);
+			};
+			const observer = new MutationObserver(sync);
+			observer.observe(tabs, {
 				attributes: true,
 				subtree: true,
 				attributeFilter: ["aria-selected", "data-state"]
 			});
-			tabs.addEventListener("click", () => {
-				window.requestAnimationFrame(sync);
-			});
+			tabs.addEventListener("click", onClick);
+			return () => {
+				observer.disconnect();
+				tabs.removeEventListener("click", onClick);
+				delete tabs.dataset.dcuTabWatch;
+			};
 		}
 		function ensureStyle(doc) {
 			if (doc.getElementById("dcu-conversation-header-style") !== null) return;
@@ -818,6 +867,8 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			ensureUserBubbleStyle(doc);
 			let applying = false;
 			let frame;
+			let watchedTabs;
+			let stopWatchingTabs;
 			const run = () => {
 				frame = void 0;
 				if (applying) return;
@@ -825,7 +876,11 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 				try {
 					placeConversationTabs(doc);
 					const tabs = findConversationTablist(doc);
-					if (tabs !== void 0) watchTabSelection(tabs);
+					if (tabs !== watchedTabs) {
+						stopWatchingTabs?.();
+						watchedTabs = tabs;
+						stopWatchingTabs = tabs === void 0 ? void 0 : watchTabSelection(tabs);
+					}
 					syncTabSlider(doc);
 					decorateConversationTitle(doc);
 					decorateUserBubbles(doc);
@@ -845,6 +900,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			});
 			return () => {
 				observer.disconnect();
+				stopWatchingTabs?.();
 				if (frame !== void 0) window.cancelAnimationFrame(frame);
 			};
 		}
@@ -903,6 +959,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 						window.clearTimeout(showTipTimer.current);
 						showTipTimer.current = void 0;
 					}
+					if (hideTipTimer.current !== void 0) window.clearTimeout(hideTipTimer.current);
 					hideTipTimer.current = window.setTimeout(() => {
 						setHoverTip(void 0);
 					}, 120);
@@ -1229,6 +1286,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			};
 			const [renameDraft, setRenameDraft] = (0, react.useState)("");
 			const [busy, setBusy] = (0, react.useState)();
+			const busyRef = (0, react.useRef)();
 			const [error, setError] = (0, react.useState)();
 			const [workspaceDragId, setWorkspaceDragId] = (0, react.useState)();
 			const [workspaceDropId, setWorkspaceDropId] = (0, react.useState)();
@@ -1339,6 +1397,8 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			const assignedIds = workspaces.items.flatMap((workspace) => workspace.sessionIds.map((id) => String(id)));
 			const recentIds = ungroupedSessionIds(sessions.ids ?? Object.keys(sessions.byId), sessions.byId, assignedIds, workspaces.archivedSessionIds).sort((left, right) => (sessions.byId[right]?.updatedAt ?? 0) - (sessions.byId[left]?.updatedAt ?? 0));
 			const run = async (key, action) => {
+				if (busyRef.current !== void 0) return;
+				busyRef.current = key;
 				setBusy(key);
 				setError(void 0);
 				try {
@@ -1347,6 +1407,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 				} catch (reason) {
 					setError(reason instanceof Error ? reason.message : String(reason));
 				} finally {
+					busyRef.current = void 0;
 					setBusy(void 0);
 				}
 			};
@@ -2330,7 +2391,10 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 		function useBusyAction(onSuccess) {
 			const [busy, setBusy] = (0, react.useState)();
 			const [error, setError] = (0, react.useState)();
+			const busyRef = (0, react.useRef)();
 			const run = async (key, action) => {
+				if (busyRef.current !== void 0) return;
+				busyRef.current = key;
 				setBusy(key);
 				setError(void 0);
 				try {
@@ -2339,6 +2403,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 				} catch (reason) {
 					setError(reason instanceof Error ? reason.message : String(reason));
 				} finally {
+					busyRef.current = void 0;
 					setBusy(void 0);
 				}
 			};
@@ -2557,11 +2622,15 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			});
 			(0, react.useEffect)(() => {
 				let disposed = false;
-				let loading = false;
+				let active;
 				const load = () => {
-					if (loading) return;
-					loading = true;
-					loadChannelGroups().then((next) => {
+					if (active !== void 0 || document.visibilityState === "hidden") return;
+					const controller = new AbortController();
+					active = controller;
+					const timeout = window.setTimeout(() => {
+						controller.abort();
+					}, 8e3);
+					loadChannelGroups(controller.signal).then((next) => {
 						if (!disposed) {
 							setGroups(next);
 							setPollError(void 0);
@@ -2569,16 +2638,23 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 					}).catch(() => {
 						if (!disposed) setPollError(t("channels.loadError"));
 					}).finally(() => {
-						loading = false;
+						window.clearTimeout(timeout);
+						if (active === controller) active = void 0;
 					});
 				};
 				load();
 				const timer = window.setInterval(load, 4e3);
+				const onVisibilityChange = () => {
+					if (document.visibilityState === "visible") load();
+				};
+				document.addEventListener("visibilitychange", onVisibilityChange);
 				return () => {
 					disposed = true;
+					active?.abort();
 					window.clearInterval(timer);
+					document.removeEventListener("visibilitychange", onVisibilityChange);
 				};
-			}, []);
+			}, [t]);
 			const banner = pollError ?? error;
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
 				className: "dcu-wb",
@@ -2875,6 +2951,8 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 		}
 		//#endregion
 		//#region src/client/CodexSidebar.tsx
+		const subscribeEmptyCompanionTabs = () => () => {};
+		const getEmptyCompanionTabs = () => EMPTY_COMPANION_TABS;
 		const stylesheet$3 = `
 .dcu-root{--dcu-font:Inter,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI","Microsoft YaHei UI",sans-serif;--dcu-sidebar-primary:#393d3e;--dcu-sidebar-secondary:#676b6c;--dcu-sidebar-tertiary:#9a9f9f;--dcu-sidebar-navigation:#4e5253;--dcu-sidebar-icon:#4e5253;--dcu-sidebar-hover:#dfe8e5;--dcu-sidebar-border:rgba(37,46,41,.10);--dcu-tip-bg:#ffffff;--dcu-tip-shadow:0 10px 32px rgba(31,39,36,.22);height:100%;min-width:0;box-sizing:border-box;display:flex;flex-direction:column;background:#eef7f5;color:var(--dcu-sidebar-primary);font:14px/20px var(--dcu-font)}body[data-ds-dark-theme] .dcu-root{background:#1d2120;--dcu-sidebar-primary:#b9bab9;--dcu-sidebar-secondary:#909191;--dcu-sidebar-tertiary:#666867;--dcu-sidebar-navigation:#b9bab9;--dcu-sidebar-icon:#afafaf;--dcu-sidebar-hover:#303432;--dcu-sidebar-border:rgba(255,255,255,.08);--dcu-tip-bg:#2a2e2c;--dcu-tip-shadow:0 10px 30px rgba(0,0,0,.28)}
 .dcu-root *{box-sizing:border-box}.dcu-head{display:grid;grid-template-columns:minmax(0,1fr) auto;align-items:center;column-gap:8px;height:60px;padding:8px 8px 8px 12px}.dcu-brand{border:0;background:transparent;color:inherit;padding:0;display:flex;align-items:center;min-width:0;overflow:hidden}.dcu-brand svg{display:block;width:auto;max-width:100%;height:24px;min-width:0}.dcu-head-actions{display:grid;grid-auto-flow:column;grid-auto-columns:28px;align-items:center;column-gap:8px;height:28px}
@@ -2932,7 +3010,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			const [searchQuery, setSearchQuery] = (0, react.useState)("");
 			const [activeSearchIndex, setActiveSearchIndex] = (0, react.useState)(0);
 			const [imTab, setImTab] = (0, react.useState)("tasks");
-			const companionTabs = (0, react.useSyncExternalStore)(companionSlots?.subscribe ?? (() => () => {}), companionSlots?.getSnapshot ?? (() => EMPTY_COMPANION_TABS), companionSlots?.getSnapshot ?? (() => EMPTY_COMPANION_TABS));
+			const companionTabs = (0, react.useSyncExternalStore)(companionSlots?.subscribe ?? subscribeEmptyCompanionTabs, companionSlots?.getSnapshot ?? getEmptyCompanionTabs, companionSlots?.getSnapshot ?? getEmptyCompanionTabs);
 			const showChannels = companionTabs.channels;
 			const showSchedule = companionTabs.schedule;
 			const showCompanionTabs = showChannels || showSchedule;
@@ -3126,14 +3204,17 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			(0, react.useEffect)(() => {
 				let startX = 0;
 				let dragging = false;
+				let pointerId;
 				const onDown = (event) => {
-					if (!isSidebarDragHandle(event.target)) return;
+					if (dragging || !isSidebarDragHandle(event.target)) return;
 					dragging = true;
+					pointerId = event.pointerId;
 					startX = event.clientX;
 				};
 				const onUp = (event) => {
-					if (!dragging) return;
+					if (!dragging || event.pointerId !== pointerId) return;
 					dragging = false;
+					pointerId = void 0;
 					if (!shouldCollapseOnSidebarDrag(startX, event.clientX)) return;
 					window.requestAnimationFrame(() => {
 						window.requestAnimationFrame(() => {
@@ -3141,11 +3222,18 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 						});
 					});
 				};
+				const onCancel = (event) => {
+					if (event.pointerId !== pointerId) return;
+					dragging = false;
+					pointerId = void 0;
+				};
 				window.addEventListener("pointerdown", onDown, true);
 				window.addEventListener("pointerup", onUp, true);
+				window.addEventListener("pointercancel", onCancel, true);
 				return () => {
 					window.removeEventListener("pointerdown", onDown, true);
 					window.removeEventListener("pointerup", onUp, true);
+					window.removeEventListener("pointercancel", onCancel, true);
 				};
 			}, [toggleSidebar]);
 			if (collapsed || width < 80) return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("aside", {
@@ -3607,9 +3695,13 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			const root = (0, react.useRef)(null);
 			const stateRef = (0, react.useRef)("loading");
 			const requestId = (0, react.useRef)(0);
+			const installingRef = (0, react.useRef)();
 			stateRef.current = state;
-			(0, react.useEffect)(() => () => {
-				alive.current = false;
+			(0, react.useEffect)(() => {
+				alive.current = true;
+				return () => {
+					alive.current = false;
+				};
 			}, []);
 			const load = (0, react.useCallback)(async (signal) => {
 				const currentRequest = ++requestId.current;
@@ -3639,8 +3731,17 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 				if (node === null || typeof IntersectionObserver === "undefined") return () => {
 					controller.abort();
 				};
+				let initialized = false;
+				let wasVisible = false;
 				const observer = new IntersectionObserver((entries) => {
-					if (entries.some((entry) => entry.isIntersecting)) refresh();
+					const visible = entries.some((entry) => entry.isIntersecting);
+					if (!initialized) {
+						initialized = true;
+						wasVisible = visible;
+						return;
+					}
+					if (visible && !wasVisible) refresh();
+					wasVisible = visible;
 				}, { threshold: .2 });
 				observer.observe(node);
 				return () => {
@@ -3649,6 +3750,8 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 				};
 			}, [load]);
 			const install = async (id) => {
+				if (installingRef.current !== void 0) return;
+				installingRef.current = id;
 				setInstalling(id);
 				setMessage(void 0);
 				try {
@@ -3669,6 +3772,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 						text: error instanceof Error ? error.message : t("about.installFailed")
 					});
 				} finally {
+					installingRef.current = void 0;
 					if (alive.current) setInstalling(void 0);
 				}
 			};
@@ -3736,7 +3840,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 								(!dependency.installed || dependency.updateAvailable) && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
 									className: "dcu-about-install",
 									type: "button",
-									disabled: installing === dependency.id,
+									disabled: installing !== void 0,
 									onClick: () => {
 										install(dependency.id);
 									},
@@ -4190,11 +4294,27 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			let applying = false;
 			let frame;
 			let pending;
+			let frameObserver;
+			const watchFrame = (next) => {
+				if (frame === next) return;
+				frameObserver?.disconnect();
+				frame = next;
+				if (frame === void 0) return;
+				frameObserver = new MutationObserver(schedule);
+				frameObserver.observe(frame, {
+					attributes: true,
+					attributeFilter: [
+						"style",
+						"data-sidebar-collapsed",
+						"data-dragging"
+					]
+				});
+			};
 			const apply = () => {
 				if (applying) return;
 				applying = true;
 				try {
-					if (frame === void 0 || !frame.isConnected) frame = findSidebarFrame(document);
+					if (frame === void 0 || !frame.isConnected) watchFrame(findSidebarFrame(document));
 					if (frame !== void 0) applySlimSidebar(frame);
 				} finally {
 					applying = false;
@@ -4208,19 +4328,16 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 				});
 			};
 			apply();
-			const observer = new MutationObserver(schedule);
+			const observer = new MutationObserver(() => {
+				if (frame === void 0 || !frame.isConnected) schedule();
+			});
 			observer.observe(document.body, {
-				attributes: true,
-				attributeFilter: [
-					"style",
-					"data-sidebar-collapsed",
-					"data-dragging"
-				],
 				childList: true,
 				subtree: true
 			});
 			return () => {
 				observer.disconnect();
+				frameObserver?.disconnect();
 				if (pending !== void 0) window.cancelAnimationFrame(pending);
 			};
 		}
@@ -4234,8 +4351,16 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			return document.querySelector("[data-conversation-scroll]");
 		}
 		function conversationAnchor(root, key) {
-			for (const anchor of root.querySelectorAll("[data-chat-anchor-key]")) if (anchor.dataset.chatAnchorKey === key) return anchor;
-			return null;
+			return conversationAnchors(root).get(key) ?? null;
+		}
+		/** 一次扫描生成锚点索引，滚动帧内不得为每个轮次重复遍历 DOM。 */
+		function conversationAnchors(root) {
+			const anchors = /* @__PURE__ */ new Map();
+			for (const anchor of root.querySelectorAll("[data-chat-anchor-key]")) {
+				const key = anchor.dataset.chatAnchorKey;
+				if (key !== void 0 && !anchors.has(key)) anchors.set(key, anchor);
+			}
+			return anchors;
 		}
 		//#endregion
 		//#region src/client/TurnNavigator.tsx
@@ -4337,27 +4462,44 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 				};
 			}, []);
 			(0, react.useEffect)(() => {
-				const host = conversationScrollRoot();
-				if (host === null || turns.length === 0) return;
+				if (turns.length === 0) return;
+				let host = null;
 				let frame = null;
 				const update = () => {
 					frame = null;
+					if (host === null) return;
 					const threshold = host.getBoundingClientRect().top + Math.min(180, host.clientHeight * .35);
+					const anchors = conversationAnchors(host);
 					let next = turns[0]?.key ?? null;
 					for (const turn of turns) {
-						const anchor = conversationAnchor(host, turn.key);
-						if (anchor !== null && anchor.getBoundingClientRect().top <= threshold) next = turn.key;
+						const anchor = anchors.get(turn.key);
+						if (anchor !== void 0 && anchor.getBoundingClientRect().top <= threshold) next = turn.key;
 					}
 					setCurrent((previous) => previous === next ? previous : next);
 				};
 				const schedule = () => {
 					if (frame === null) frame = window.requestAnimationFrame(update);
 				};
-				host.addEventListener("scroll", schedule, { passive: true });
+				const bindHost = () => {
+					const next = conversationScrollRoot();
+					if (next === host) return;
+					host?.removeEventListener("scroll", schedule);
+					host = next;
+					host?.addEventListener("scroll", schedule, { passive: true });
+					schedule();
+				};
+				const observer = new MutationObserver(() => {
+					if (host === null || !host.isConnected) bindHost();
+				});
+				observer.observe(document.body, {
+					childList: true,
+					subtree: true
+				});
 				window.addEventListener("resize", schedule);
-				schedule();
+				bindHost();
 				return () => {
-					host.removeEventListener("scroll", schedule);
+					observer.disconnect();
+					host?.removeEventListener("scroll", schedule);
 					window.removeEventListener("resize", schedule);
 					if (frame !== null) window.cancelAnimationFrame(frame);
 				};
@@ -4412,7 +4554,6 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 										index: index + 1,
 										summary: turn.summary
 									}),
-									title: turn.summary,
 									style: tickStyle,
 									onFocus: () => {
 										setHoverAt(index);

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { spawn } from "node:child_process";
-import { readFile, writeFile } from "node:fs/promises";
+import { readFile, unlink, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -54,6 +54,7 @@ function managedDependency(id) {
 //#region src/dependency-manager.ts
 const PROFILE_PENDING_UPDATES_FILE = ".dsh-pending-updates.json";
 const APPLY_PLUGIN_UPDATES_IPC = "apply-plugin-updates";
+const PLUGIN_INSTALL_TIMEOUT_MS = 6e5;
 function profileDirectory() {
 	if (process.env.DSH_PROFILE_DIR !== void 0) return process.env.DSH_PROFILE_DIR;
 	return resolve(homedir(), ".dsh", "profiles", "web");
@@ -173,7 +174,7 @@ function applyReleaseExclude(source, packageName, version) {
 }
 /** 将用户本次确认的精确版本加入 Profile 的 pnpm 发布时间保护例外。 */
 async function ensureLatestReleaseAllowed(packageName, version) {
-	if (versionParts(version) === void 0) throw new Error("npm 返回了无法识别的最新版本。");
+	if (parseSemver(version) === void 0) throw new Error("npm 返回了无法识别的最新版本。");
 	const path = resolve(profileDirectory(), "pnpm-workspace.yaml");
 	let source;
 	try {
@@ -185,26 +186,40 @@ async function ensureLatestReleaseAllowed(packageName, version) {
 	const next = applyReleaseExclude(source, packageName, version);
 	if (next !== source) await writeFile(path, next, "utf8");
 }
-function versionParts(version) {
-	const match = /^v?(\d+)\.(\d+)\.(\d+)/.exec(version);
-	return match === null ? void 0 : [
-		Number(match[1]),
-		Number(match[2]),
-		Number(match[3])
-	];
+function parseSemver(version) {
+	const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/.exec(version);
+	if (match === null) return void 0;
+	return {
+		core: [
+			Number(match[1]),
+			Number(match[2]),
+			Number(match[3])
+		],
+		prerelease: match[4] === void 0 ? [] : match[4].split(".")
+	};
 }
-function prereleaseRank(version) {
-	const match = /-rc\.(\d+)/i.exec(version);
-	return match === null ? Number.POSITIVE_INFINITY : Number(match[1]);
+function comparePrerelease(left, right) {
+	if (left.length === 0 || right.length === 0) return left.length === right.length ? 0 : left.length === 0 ? 1 : -1;
+	const length = Math.max(left.length, right.length);
+	for (let index = 0; index < length; index += 1) {
+		const a = left[index];
+		const b = right[index];
+		if (a === void 0 || b === void 0) return a === b ? 0 : a === void 0 ? -1 : 1;
+		if (a === b) continue;
+		const aNumeric = /^\d+$/.test(a);
+		const bNumeric = /^\d+$/.test(b);
+		if (aNumeric && bNumeric) return Number(a) > Number(b) ? 1 : -1;
+		if (aNumeric !== bNumeric) return aNumeric ? -1 : 1;
+		return a > b ? 1 : -1;
+	}
+	return 0;
 }
 function newerVersion(installed, latest) {
-	const current = versionParts(installed);
-	const candidate = versionParts(latest);
+	const current = parseSemver(installed);
+	const candidate = parseSemver(latest);
 	if (current === void 0 || candidate === void 0) return false;
-	if (candidate[0] !== current[0]) return candidate[0] > current[0];
-	if (candidate[1] !== current[1]) return candidate[1] > current[1];
-	if (candidate[2] !== current[2]) return candidate[2] > current[2];
-	return prereleaseRank(latest) > prereleaseRank(installed);
+	for (let index = 0; index < current.core.length; index += 1) if (candidate.core[index] !== current.core[index]) return candidate.core[index] > current.core[index];
+	return comparePrerelease(candidate.prerelease, current.prerelease) > 0;
 }
 /** 返回 Web profile 中固定管理插件的实际安装版本与 npm latest 状态。 */
 async function dependencyStatuses() {
@@ -272,9 +287,31 @@ async function recordPendingUpdate(packageName, version) {
 	});
 	await writeFile(pendingPath, `${JSON.stringify({ packages }, void 0, 2)}\n`, "utf8");
 }
+async function removePendingUpdate(packageName) {
+	const pendingPath = resolve(profileDirectory(), PROFILE_PENDING_UPDATES_FILE);
+	try {
+		const parsed = JSON.parse(await readFile(pendingPath, "utf8"));
+		if (!Array.isArray(parsed.packages)) return;
+		const packages = parsed.packages.filter((item) => item === null || typeof item !== "object" || item.packageName !== packageName);
+		if (packages.length === parsed.packages.length) return;
+		if (packages.length === 0) {
+			await unlink(pendingPath);
+			return;
+		}
+		await writeFile(pendingPath, `${JSON.stringify({ packages }, void 0, 2)}\n`, "utf8");
+	} catch (error) {
+		if (error.code !== "ENOENT") throw error;
+	}
+}
 async function recordDeclaredVersion(packageName, version) {
 	const manifestPath = resolve(profileDirectory(), "package.json");
-	const manifest = JSON.parse(await readFile(manifestPath, "utf8"));
+	let manifest;
+	try {
+		manifest = JSON.parse(await readFile(manifestPath, "utf8"));
+	} catch (error) {
+		if (error.code !== "ENOENT") throw error;
+		manifest = {};
+	}
 	manifest.dependencies = {
 		...manifest.dependencies,
 		[packageName]: version
@@ -293,43 +330,87 @@ function pluginCommandError(stderr) {
 * 复用启动当前服务的 DSH CLI：它会通过 pnpm 从 npm 安装或更新，并自动维护
 * dsh.profile.bundles，避免浏览器端直接管理 profile 文件。
 */
-function runDshPlugin(args) {
-	const entry = resolveDshCliEntry();
-	return new Promise((resolvePromise, reject) => {
-		const child = spawn(process.execPath, [
-			...process.execArgv,
-			entry,
-			"plugin",
-			"--profile",
-			"web",
-			...args
+function pluginExecArgv(args = process.execArgv) {
+	return args.filter((arg) => !/^--(?:inspect|inspect-brk|debug|debug-brk)(?:=|$)/.test(arg));
+}
+const activePluginChildren = /* @__PURE__ */ new Set();
+function terminatePluginChild(child) {
+	if (child.exitCode !== null || child.killed) return;
+	if (process.platform === "win32" && child.pid !== void 0) {
+		const killer = spawn("taskkill", [
+			"/pid",
+			String(child.pid),
+			"/T",
+			"/F"
 		], {
-			cwd: process.cwd(),
-			env: {
-				...process.env,
-				CI: "true"
-			},
 			windowsHide: true,
-			stdio: [
-				"ignore",
-				"pipe",
-				"pipe"
-			]
+			stdio: "ignore"
 		});
+		killer.once("error", () => {
+			child.kill("SIGTERM");
+		});
+		killer.unref();
+		return;
+	}
+	child.kill("SIGTERM");
+}
+/** 插件停用时终止仍在运行的安装进程，避免热更新后遗留 pnpm。 */
+function disposeDependencyInstaller() {
+	for (const child of activePluginChildren) terminatePluginChild(child);
+}
+function monitorPluginChild(child, timeoutMs = PLUGIN_INSTALL_TIMEOUT_MS) {
+	return new Promise((resolvePromise, reject) => {
+		activePluginChildren.add(child);
 		let output = "";
+		let settled = false;
 		const collect = (chunk) => {
-			output += String(chunk);
+			output = `${output}${String(chunk)}`.slice(-65536);
+		};
+		const finish = (error) => {
+			if (settled) return;
+			settled = true;
+			clearTimeout(timeout);
+			activePluginChildren.delete(child);
+			error === void 0 ? resolvePromise() : reject(error);
 		};
 		child.stdout?.on("data", collect);
 		child.stderr?.on("data", collect);
 		child.once("error", () => {
-			reject(/* @__PURE__ */ new Error("无法启动 DSH 插件安装命令。请确认 Node.js 与 pnpm 可用后重试。"));
+			finish(/* @__PURE__ */ new Error("无法启动 DSH 插件安装命令。请确认 Node.js 与 pnpm 可用后重试。"));
 		});
 		child.once("exit", (code) => {
-			code === 0 ? resolvePromise() : reject(pluginCommandError(output));
+			finish(code === 0 ? void 0 : pluginCommandError(output));
 		});
+		const timeout = setTimeout(() => {
+			terminatePluginChild(child);
+			finish(/* @__PURE__ */ new Error("插件安装超时，已终止安装进程。请检查网络后重试。"));
+		}, timeoutMs);
+		timeout.unref?.();
 	});
 }
+function runDshPlugin(args, timeoutMs = PLUGIN_INSTALL_TIMEOUT_MS) {
+	const entry = resolveDshCliEntry();
+	return monitorPluginChild(spawn(process.execPath, [
+		...pluginExecArgv(),
+		entry,
+		"plugin",
+		"--profile",
+		"web",
+		...args
+	], {
+		cwd: process.cwd(),
+		env: {
+			...process.env,
+			CI: "true"
+		},
+		windowsHide: true,
+		stdio: [
+			"ignore",
+			"pipe",
+			"pipe"
+		]
+	}), timeoutMs);
+}
 /** 并发安装互斥：pnpm 锁文件竞争会触发 EPERM/EBUSY，同一时间只允许一个安装进程。 */
 let installing = false;
 /** 仅允许安装固定依赖，避免把浏览器输入转成任意命令。 */
@@ -352,10 +433,10 @@ async function installDependencyLocked(id, requestHotUpdate) {
 	const targetVersion = target === dependency.packageName ? latestVersion : await npmLatestVersion(target);
 	if (targetVersion === void 0) throw new Error("无法获取 npm 最新版本，请检查网络或 npm registry 后重试。");
 	const remove = pluginsToRemoveBeforeInstall(declared, target);
-	if (remove.length > 0) await runDshPlugin(["remove", ...remove]);
 	await ensureLatestReleaseAllowed(target, targetVersion);
 	if (!isOfficialRuntimePackage(target)) await recordDeclaredVersion(target, targetVersion);
 	await recordPendingUpdate(target, targetVersion);
+	if (remove.length > 0) await runDshPlugin(["remove", ...remove]);
 	if (requestHotUpdate()) return dependencyStatuses();
 	try {
 		await runDshPlugin([
@@ -368,6 +449,7 @@ async function installDependencyLocked(id, requestHotUpdate) {
 		throw error;
 	}
 	if (await installedPackageVersion(target) !== targetVersion) return dependencyStatuses();
+	await removePendingUpdate(target);
 	return dependencyStatuses();
 }
 //#endregion
@@ -419,7 +501,7 @@ function crossSiteRequest(request) {
 /** 把安装错误收成可给浏览器看的文案：我们自己的中文说明保留，带本地路径的底层错误脱敏。 */
 function publicDependencyError(error) {
 	const message = error instanceof Error ? error.message : "依赖管理暂不可用。";
-	if (/[A-Za-z]:[\\/]|\/(?:home|Users|var|tmp)\//.test(message)) return "依赖管理暂不可用，请查看服务端日志。";
+	if (/[A-Za-z]:[\\/]|\/(?:home|root|Users|var|tmp)\//.test(message)) return "依赖管理暂不可用，请查看服务端日志。";
 	return message;
 }
 const inject = [
@@ -528,6 +610,7 @@ function apply(ctx) {
 			}
 		});
 		return () => {
+			disposeDependencyInstaller();
 			disposeConnectors();
 			disposeDependencies();
 		};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michengai/dsh-codex-ui",
-  "version": "0.2.72",
+  "version": "0.2.73",
   "description": "以 Codex 风格重构 DSH Web 侧栏的独立客户端插件",
   "license": "Apache-2.0",
   "publishConfig": {
@@ -53,7 +53,8 @@
   },
   "scripts": {
     "build": "tsc --noEmit && tsdown",
-    "test": "tsx tests/hover-tip.assert.ts && tsx tests/companion-slots.assert.ts && tsx tests/channel-api.assert.ts && tsx tests/schedule-sessions.assert.ts && tsx tests/session-tree.assert.ts && tsx tests/pinned-sessions.assert.ts && tsx tests/session-manager.assert.ts && tsx tests/workspace-browser.assert.ts && tsx tests/sidebar-search.assert.ts && tsx tests/settings-navigation.assert.ts && tsx tests/settings-nav-icons.assert.ts && tsx tests/locales.assert.ts && vitest run tests/client-runtime.integration.spec.ts && tsx tests/settings-integration.assert.ts && tsx tests/about-dependencies.assert.ts && tsx tests/dependency-manager.assert.ts && tsx tests/conversation-bubbles.assert.ts && tsx tests/conversation-header.assert.ts && tsx tests/conversation-visuals.assert.ts && tsdown && tsx tests/client-bundle.assert.ts && tsx tests/codex-suite.assert.ts"
+    "typecheck": "tsc --noEmit",
+    "test": "pnpm run typecheck && vitest run tests/client-runtime.integration.spec.ts && tsdown && node tests/run-assertions.mjs"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.1 <5.0.0",