@michengai/dsh-codex-ui 0.2.58 → 0.2.60

package/dist/client.js

@@ -262,6 +262,7 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/client/session-manager.ts
 		const SESSION_PINS_STORAGE_KEY = "dsh.session-pins.v1";
+		const SESSION_SECTION_PINS_STORAGE_KEY = "dsh-codex-ui.pinned-section-sessions.v1";
 		const SESSION_UNREAD_STORAGE_KEY = "dsh.session-unread.v1";
 		function normalizeSessionIds(ids) {
 			return [...new Set(ids.filter((id) => id.trim() !== ""))];
@@ -294,6 +295,15 @@ window.__ModuleLoader__.load({
 			url.searchParams.set("session", sessionId);
 			return url.toString();
 		}
+		/** 把会话插入置顶列表的指定位置；省略锚点时追加到末尾。 */
+		function insertSessionId(ids, id, beforeId) {
+			const next = ids.filter((item) => item !== id);
+			if (beforeId === void 0) return [...next, id];
+			if (beforeId === id) return ids.includes(id) ? [...ids] : [...next, id];
+			const index = next.indexOf(beforeId);
+			next.splice(index < 0 ? next.length : index, 0, id);
+			return next;
+		}
 		//#endregion
 		//#region src/client/session-tree.tsx
 		function PinIcon() {
@@ -430,19 +440,33 @@ window.__ModuleLoader__.load({
 		function pointerMenuRect(x, y) {
 			return new DOMRect(x, y, 0, 0);
 		}
-		function SessionRow({ id, title, selected, menuOpen, pinned, unread, running, t, menuItems, onOpen, onMenuChange, onSelectAction, onPin, onArchive, onHover, onLeave, onContextMenu, menuPoint }) {
+		function SessionRow({ id, title, selected, menuOpen, pinned, unread, running, t, menuItems, onOpen, onMenuChange, onSelectAction, onPin, onArchive, onHover, onLeave, onContextMenu, menuPoint, subtitle, flat, draggable, dropActive, onDragStart, onDragEnd, onDragOver, onDrop }) {
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-				className: `dcu-wb-session${selected ? " dcu-wb-selected" : ""}${menuOpen ? " dcu-wb-menu-open" : ""}`,
+				className: `dcu-wb-session${selected ? " dcu-wb-selected" : ""}${menuOpen ? " dcu-wb-menu-open" : ""}${dropActive === true ? " dcu-wb-drop" : ""}${flat === true ? " dcu-wb-session-flat" : ""}`,
 				role: "treeitem",
 				"aria-selected": selected,
+				draggable,
+				onDragStart,
+				onDragEnd,
+				onDragOver,
+				onDrop,
 				onClick: onOpen,
 				onContextMenu,
 				onMouseEnter: onHover,
 				onMouseLeave: onLeave,
 				children: [
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					subtitle !== void 0 && subtitle !== "" ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+						className: "dcu-wb-session-copy",
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							className: "dcu-wb-session-title",
+							children: title.split(/\r?\n/)[0] ?? title
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							className: "dcu-wb-session-sub",
+							children: subtitle
+						})]
+					}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 						className: "dcu-wb-session-title",
-						children: title
+						children: title.split(/\r?\n/)[0] ?? title
 					}),
 					pinned && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 						className: "dcu-wb-pin",
@@ -1097,6 +1121,65 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 				return item === void 0 ? [] : [item];
 			});
 		}
+		/** 置顶区的会话按拖入顺序展示；不因父项目已置顶而隐藏。 */
+		function standalonePinnedSessionIds(pinnedSessionIds) {
+			return [...pinnedSessionIds];
+		}
+		/** 置顶区已有会话时，不再同时展示任何项目文件夹，避免旧置顶项目叠成两条。 */
+		function workspaceIdsHiddenByPinnedSessions(workspaces, pinnedSessionIds) {
+			if (pinnedSessionIds.length === 0) return [];
+			return workspaces.map((workspace) => String(workspace.workspaceId));
+		}
+		const SESSION_DRAG_TYPE = "application/x-dcu-session";
+		const WORKSPACE_DRAG_TYPE = "application/x-dcu-workspace";
+		const SESSION_DRAG_PREFIX = "dcu-session:";
+		const WORKSPACE_DRAG_PREFIX = "dcu-workspace:";
+		function dragTypes(data) {
+			return data === void 0 ? [] : Array.from(data.types);
+		}
+		function textPayload(data) {
+			try {
+				return data?.getData("text/plain") ?? "";
+			} catch {
+				return "";
+			}
+		}
+		/** 拖过置顶区时用来决定是否 preventDefault；只看 types，不读数据。 */
+		function isSidebarItemDrag(data) {
+			const types = dragTypes(data);
+			return types.includes("application/x-dcu-session") || types.includes("application/x-dcu-workspace") || types.includes("text/plain");
+		}
+		/** 写入会话拖拽载荷；drop 时以这个为准，不依赖尚未刷新的 React 状态。 */
+		function writeSessionDrag(data, sessionId, title) {
+			data.effectAllowed = "move";
+			data.setData("text/plain", `${SESSION_DRAG_PREFIX}${sessionId}`);
+			data.setData(SESSION_DRAG_TYPE, sessionId);
+		}
+		function writeWorkspaceDrag(data, workspaceId, title) {
+			data.effectAllowed = "move";
+			data.setData("text/plain", `${WORKSPACE_DRAG_PREFIX}${workspaceId}`);
+			data.setData(WORKSPACE_DRAG_TYPE, workspaceId);
+		}
+		function readSessionDrag(data, fallback) {
+			try {
+				const typed = data?.getData(SESSION_DRAG_TYPE);
+				if (typed !== void 0 && typed.trim() !== "") return typed;
+			} catch {}
+			const text = textPayload(data);
+			if (text.startsWith(SESSION_DRAG_PREFIX)) return text.slice(12);
+			return fallback !== void 0 && fallback.trim() !== "" ? fallback : void 0;
+		}
+		/** 会话拖拽优先；有会话载荷时不得再把父项目置顶。 */
+		function readWorkspaceDrag(data, fallback) {
+			if (readSessionDrag(data) !== void 0) return void 0;
+			try {
+				const typed = data?.getData(WORKSPACE_DRAG_TYPE);
+				if (typed !== void 0 && typed.trim() !== "") return typed;
+			} catch {}
+			const text = textPayload(data);
+			if (text.startsWith(WORKSPACE_DRAG_PREFIX)) return text.slice(14);
+			return fallback !== void 0 && fallback.trim() !== "" ? fallback : void 0;
+		}
 		//#endregion
 		//#region src/client/CodexWorkspaceBrowser.tsx
 		const stylesheet$4 = `
@@ -1111,13 +1194,13 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 .dcu-wb-project-head:hover,.dcu-wb-project-head.dcu-wb-menu-open,.dcu-wb-session:hover,.dcu-wb-session.dcu-wb-selected,.dcu-wb-session.dcu-wb-menu-open{background:var(--dcu-sidebar-hover)}.dcu-wb-project-head+.dcu-wb-session,.dcu-wb-project-head+.dcu-wb-nochat{margin-top:4px}.dcu-wb-session+.dcu-wb-session{margin-top:2px}
 .dcu-wb-project-head[draggable=true],.dcu-wb-session[draggable=true]{cursor:grab}
 .dcu-wb-project-head[draggable=true]:active,.dcu-wb-session[draggable=true]:active{cursor:grabbing}
-.dcu-wb-section,.dcu-wb-section:focus,.dcu-wb-section:focus-visible,.dcu-wb-project-head:focus,.dcu-wb-session:focus{outline:0}.dcu-wb-pin-end{position:relative;height:8px}.dcu-wb-project-head.dcu-wb-drop::before,.dcu-wb-session.dcu-wb-drop::before,.dcu-wb-pin-end.dcu-wb-drop::before,.dcu-wb-section[data-pin-over=true] .dcu-wb-section-head::after{content:"";position:absolute;left:8px;right:8px;top:-4px;height:8px;pointer-events:none;background:radial-gradient(circle at 4px 50%,var(--dsw-alias-state-business-primary) 3.25px,transparent 3.45px),linear-gradient(var(--dsw-alias-state-business-primary),var(--dsw-alias-state-business-primary)) 10px 50%/calc(100% - 10px) 2px no-repeat}.dcu-wb-drag-ghost{position:fixed;top:-120px;left:-240px;z-index:10040;max-width:220px;height:32px;padding:0 10px;border:1px solid var(--dcu-sidebar-border);border-radius:8px;background:var(--dcu-sidebar-hover);color:var(--dcu-sidebar-primary);font:13px/32px var(--dcu-font,inherit);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;pointer-events:none}
+.dcu-wb-section,.dcu-wb-section:focus,.dcu-wb-section:focus-visible,.dcu-wb-project-head:focus,.dcu-wb-session:focus{outline:0}.dcu-wb-pin-end{position:relative;height:8px}.dcu-wb-project-head.dcu-wb-drop::before,.dcu-wb-session.dcu-wb-drop::before,.dcu-wb-pin-end.dcu-wb-drop::before,.dcu-wb-section[data-pin-over=true] .dcu-wb-section-head::after{content:"";position:absolute;left:8px;right:8px;top:-4px;height:8px;pointer-events:none;background:radial-gradient(circle at 4px 50%,var(--dsw-alias-state-business-primary) 3.25px,transparent 3.45px),linear-gradient(var(--dsw-alias-state-business-primary),var(--dsw-alias-state-business-primary)) 10px 50%/calc(100% - 10px) 2px no-repeat}.dcu-wb-project-head.dcu-wb-drop-after::before,.dcu-wb-session.dcu-wb-drop-after::before{top:auto;bottom:-4px}.dcu-wb-dragging{opacity:.28}.dcu-wb-drag-ghost{position:fixed;top:-120px;left:-240px;z-index:10040;max-width:220px;height:32px;padding:0 10px;border:1px solid var(--dcu-sidebar-border);border-radius:8px;background:var(--dcu-sidebar-hover);color:var(--dcu-sidebar-primary);font:13px/32px var(--dcu-font,inherit);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;pointer-events:none}
 .dcu-wb-folder{display:grid;place-items:center;flex:none;width:16px;height:20px;color:var(--dcu-sidebar-icon)}.dcu-wb-brand{display:block;width:16px;height:16px}
 .dcu-wb-project-current .dcu-wb-folder{color:var(--dsw-alias-state-business-primary)}
 .dcu-wb-project-title,.dcu-wb-session-title{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:14px;line-height:20px}
 .dcu-wb-project-title{flex:1;font-weight:550;color:var(--dcu-sidebar-primary)}
 .dcu-wb-session{position:relative;min-height:32px;gap:0;padding-left:28px}
-.dcu-wb-session-title{flex:1;margin-left:0}
+.dcu-wb-session-title{flex:1;margin-left:0}.dcu-wb-session-copy{flex:1;min-width:0;display:flex;flex-direction:column;justify-content:center}.dcu-wb-session-sub{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:var(--dcu-sidebar-tertiary);font-size:12px;line-height:16px}.dcu-wb-session-flat,.dcu-wb-session-top{padding-left:8px}
 .dcu-wb-pin{display:grid;place-items:center;flex:none;width:16px;height:20px;margin-left:6px;color:var(--dcu-sidebar-tertiary)}
 .dcu-wb-pin svg,.dcu-wb-quick-pin svg{width:13px;height:13px;fill:none;stroke:currentColor;stroke-linecap:round;stroke-linejoin:round;stroke-width:1.4}
 .dcu-wb-actions{display:none;align-items:center;gap:8px;flex:none}
@@ -1162,6 +1245,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			const [expanded, setExpanded] = (0, react.useState)({});
 			const [pinnedWorkspaceIds, setPinnedWorkspaceIds] = (0, react.useState)(() => readPinnedWorkspaceIds(storage$1()));
 			const [pinnedSessionIds, setPinnedSessionIds] = (0, react.useState)(() => readSessionIds(storage$1(), SESSION_PINS_STORAGE_KEY));
+			const [sectionSessionIds, setSectionSessionIds] = (0, react.useState)(() => readSessionIds(storage$1(), SESSION_SECTION_PINS_STORAGE_KEY));
 			const [unreadSessionIds, setUnreadSessionIds] = (0, react.useState)(() => readSessionIds(storage$1(), SESSION_UNREAD_STORAGE_KEY));
 			const [menu, setMenu] = (0, react.useState)();
 			const [renameTarget, setRenameTarget] = (0, react.useState)();
@@ -1176,6 +1260,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			const [error, setError] = (0, react.useState)();
 			const [workspaceDragId, setWorkspaceDragId] = (0, react.useState)();
 			const [workspaceDropId, setWorkspaceDropId] = (0, react.useState)();
+			const [workspaceDropAfter, setWorkspaceDropAfter] = (0, react.useState)(false);
 			const [headerMenu, setHeaderMenu] = (0, react.useState)();
 			const headerMenuRef = (0, react.useRef)();
 			headerMenuRef.current = headerMenu;
@@ -1189,6 +1274,13 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			(0, react.useEffect)(() => {
 				writeSessionIds(storage$1(), SESSION_PINS_STORAGE_KEY, pinnedSessionIds);
 			}, [pinnedSessionIds]);
+			(0, react.useEffect)(() => {
+				writeSessionIds(storage$1(), SESSION_SECTION_PINS_STORAGE_KEY, sectionSessionIds);
+			}, [sectionSessionIds]);
+			(0, react.useEffect)(() => {
+				if (sectionSessionIds.length === 0) return;
+				setPinnedWorkspaceIds((ids) => ids.length === 0 ? ids : []);
+			}, [sectionSessionIds]);
 			(0, react.useEffect)(() => {
 				writeSessionIds(storage$1(), SESSION_UNREAD_STORAGE_KEY, unreadSessionIds);
 			}, [unreadSessionIds]);
@@ -1275,11 +1367,14 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 				sessions.current,
 				menu
 			]);
-			const projectPinned = (id) => pinnedWorkspaceIds.includes(String(id));
-			const pinnedGroups = orderByIds(groups.items, pinnedWorkspaceIds, (workspace) => String(workspace.workspaceId));
+			const pinSectionSessions = standalonePinnedSessionIds(sectionSessionIds);
+			const hiddenPinnedWorkspaceIds = new Set(workspaceIdsHiddenByPinnedSessions(groups.items, pinSectionSessions));
+			const projectPinned = (id) => pinnedWorkspaceIds.includes(String(id)) && !hiddenPinnedWorkspaceIds.has(String(id));
+			const pinnedGroups = orderByIds(groups.items, pinnedWorkspaceIds, (workspace) => String(workspace.workspaceId)).filter((workspace) => !hiddenPinnedWorkspaceIds.has(String(workspace.workspaceId)));
 			const regularGroups = groups.items.filter((workspace) => !projectPinned(workspace.workspaceId));
+			const pinDragActive = workspaceDragId !== void 0 || sessionDrag !== void 0;
 			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 recentIds = ungroupedSessionIds(sessions.ids ?? Object.keys(sessions.byId), sessions.byId, assignedIds, workspaces.archivedSessionIds).filter((id) => !pinSectionSessions.includes(id)).sort((left, right) => (sessions.byId[right]?.updatedAt ?? 0) - (sessions.byId[left]?.updatedAt ?? 0));
 			const run = async (key, action) => {
 				setBusy(key);
 				setError(void 0);
@@ -1317,6 +1412,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 					if (target.kind === "session") {
 						await deleteSession(target.id);
 						setPinnedSessionIds((ids) => ids.filter((id) => id !== target.id));
+						setSectionSessionIds((ids) => ids.filter((id) => id !== target.id));
 						setUnreadSessionIds((ids) => ids.filter((id) => id !== target.id));
 					} else {
 						await deleteWorkspace(target.id);
@@ -1331,10 +1427,10 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 					await (0, _deepseek_ai_dsh_client_ui_primitives.writeClipboard)(value);
 				});
 			};
-			const toggleGroup = (workspaceId) => {
+			const toggleGroup = (key, defaultOpen = true) => {
 				setExpanded((current) => ({
 					...current,
-					[workspaceId]: !(current[workspaceId] ?? true)
+					[key]: !(current[key] ?? defaultOpen)
 				}));
 			};
 			const sectionOpen = (id) => expanded[`section:${id}`] ?? true;
@@ -1385,8 +1481,14 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			const pinWorkspaceAt = (id, beforeId) => {
 				setPinnedWorkspaceIds((ids) => insertPinnedWorkspace(ids, id, beforeId));
 			};
+			const pinSessionAt = (id, beforeId) => {
+				setSectionSessionIds((ids) => insertSessionId(ids, id, beforeId));
+				setPinnedWorkspaceIds((ids) => ids.length === 0 ? ids : []);
+			};
 			const renderGroup = (workspace, zone) => {
-				const isExpanded = expanded[workspace.workspaceId] ?? true;
+				const expandKey = zone === "pinned" ? `pin:${workspace.workspaceId}` : String(workspace.workspaceId);
+				const isExpanded = expanded[expandKey] ?? zone !== "pinned";
+				const shownIds = workspace.visibleIds.filter((id) => !pinSectionSessions.includes(id));
 				const menuOpen = menu?.type === "workspace" && menu.id === workspace.workspaceId;
 				const menuAt = menuOpen && menu.x !== void 0 && menu.y !== void 0 ? {
 					x: menu.x,
@@ -1396,27 +1498,43 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 				return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 					className: `dcu-wb-project${isCurrentWorkspace ? " dcu-wb-project-current" : ""}`,
 					onDragOver: (event) => {
-						if (workspaceDragId === void 0) return;
+						if (workspaceDragId === void 0 && !isSidebarItemDrag(event.dataTransfer) && !(zone === "pinned" && sessionDrag !== void 0)) return;
 						event.preventDefault();
 						event.stopPropagation();
+						event.dataTransfer.dropEffect = "move";
 						const after = event.clientY > event.currentTarget.getBoundingClientRect().top + event.currentTarget.getBoundingClientRect().height / 2;
-						if (zone === "pinned") {
-							const beforeId = dropBeforeId(pinnedGroups.map((item) => String(item.workspaceId)), String(workspace.workspaceId), after);
-							setPinSlot(beforeId === void 0 ? "end" : beforeId);
-							setWorkspaceDropId(beforeId === void 0 ? String(workspace.workspaceId) : beforeId);
+						const id = String(workspace.workspaceId);
+						const ids = (zone === "pinned" ? pinnedGroups : regularGroups).map((item) => String(item.workspaceId));
+						const last = ids.length > 0 && ids[ids.length - 1] === id;
+						if (zone === "pinned" && after && last) {
+							setPinSlot("end");
+							setWorkspaceDropId(void 0);
+							setWorkspaceDropAfter(false);
 						} else {
-							const beforeId = dropBeforeId(regularGroups.map((item) => String(item.workspaceId)), String(workspace.workspaceId), after);
-							setPinSlot(beforeId === void 0 ? "end" : beforeId);
-							setWorkspaceDropId(beforeId === void 0 ? String(workspace.workspaceId) : beforeId);
+							setPinSlot(zone === "pinned" ? id : void 0);
+							setWorkspaceDropId(id);
+							setWorkspaceDropAfter(after);
 						}
 					},
 					onDrop: (event) => {
 						event.preventDefault();
 						event.stopPropagation();
-						const dragged = workspaceDragId;
+						const droppedSession = readSessionDrag(event.dataTransfer, sessionDrag?.sessionId);
+						if (zone === "pinned" && droppedSession !== void 0) {
+							setSessionDrag(void 0);
+							setSessionDropId(void 0);
+							setWorkspaceDragId(void 0);
+							setWorkspaceDropId(void 0);
+							setWorkspaceDropAfter(false);
+							setPinSlot(void 0);
+							pinSessionAt(droppedSession);
+							return;
+						}
+						const dragged = readWorkspaceDrag(event.dataTransfer, workspaceDragId);
 						const after = event.clientY > event.currentTarget.getBoundingClientRect().top + event.currentTarget.getBoundingClientRect().height / 2;
 						setWorkspaceDragId(void 0);
 						setWorkspaceDropId(void 0);
+						setWorkspaceDropAfter(false);
 						setPinSlot(void 0);
 						if (dragged === void 0) return;
 						if (zone === "pinned") {
@@ -1431,14 +1549,15 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 					},
 					children: [
 						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-							className: `dcu-wb-project-head${menuOpen ? " dcu-wb-menu-open" : ""}${workspaceDropId === workspace.workspaceId ? " dcu-wb-drop" : ""}`,
+							className: `dcu-wb-project-head${menuOpen ? " dcu-wb-menu-open" : ""}${workspaceDropId === workspace.workspaceId ? workspaceDropAfter ? " dcu-wb-drop dcu-wb-drop-after" : " dcu-wb-drop" : ""}${workspaceDragId === String(workspace.workspaceId) ? " dcu-wb-dragging" : ""}`,
 							role: "treeitem",
 							"aria-expanded": isExpanded,
 							tabIndex: 0,
 							draggable: true,
 							onDragStart: (event) => {
-								event.dataTransfer.effectAllowed = "move";
-								event.dataTransfer.setData("text/plain", workspace.title);
+								event.stopPropagation();
+								setSessionDrag(void 0);
+								writeWorkspaceDrag(event.dataTransfer, String(workspace.workspaceId), workspace.title);
 								const preview = document.createElement("div");
 								preview.className = "dcu-wb-drag-ghost";
 								preview.textContent = workspace.title;
@@ -1452,10 +1571,11 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 							onDragEnd: () => {
 								setWorkspaceDragId(void 0);
 								setWorkspaceDropId(void 0);
+								setWorkspaceDropAfter(false);
 								setPinSlot(void 0);
 							},
 							onClick: () => {
-								toggleGroup(workspace.workspaceId);
+								if (zone !== "pinned") toggleGroup(expandKey, true);
 							},
 							onContextMenu: (event) => {
 								event.preventDefault();
@@ -1484,7 +1604,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 							onKeyDown: (event) => {
 								if (event.key === "Enter" || event.key === " ") {
 									event.preventDefault();
-									toggleGroup(workspace.workspaceId);
+									if (zone !== "pinned") toggleGroup(expandKey, true);
 								}
 							},
 							children: [
@@ -1507,7 +1627,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 											top: box.top
 										}, { immediate: true });
 									},
-									children: isExpanded ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconFolderOpenOutline16, { size: 16 }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconFolderClose16, { size: 16 })
+									children: zone !== "pinned" && isExpanded ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconFolderOpenOutline16, { size: 16 }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconFolderClose16, { size: 16 })
 								}),
 								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 									className: "dcu-wb-project-title",
@@ -1577,11 +1697,11 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 								})
 							]
 						}),
-						isExpanded && workspace.visibleIds.length === 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						zone !== "pinned" && isExpanded && shownIds.length === 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 							className: "dcu-wb-nochat",
 							children: t("workspace.noChat")
 						}),
-						isExpanded && workspace.visibleIds.map((id) => {
+						zone !== "pinned" && isExpanded && shownIds.map((id) => {
 							const session = sessions.byId[id];
 							if (session === void 0) return null;
 							const path = session.cwd ?? workspace.path;
@@ -1598,7 +1718,16 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 								draggable: true,
 								onDragStart: (event) => {
 									event.stopPropagation();
-									event.dataTransfer.effectAllowed = "move";
+									setWorkspaceDragId(void 0);
+									writeSessionDrag(event.dataTransfer, id, session.displayTitle);
+									const preview = document.createElement("div");
+									preview.className = "dcu-wb-drag-ghost";
+									preview.textContent = session.displayTitle;
+									document.body.appendChild(preview);
+									event.dataTransfer.setDragImage(preview, 16, 18);
+									window.requestAnimationFrame(() => {
+										preview.remove();
+									});
 									setSessionDrag({
 										sessionId: id,
 										workspaceId: workspace.workspaceId
@@ -1657,7 +1786,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 								children: [
 									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 										className: "dcu-wb-session-title",
-										children: session.displayTitle
+										children: session.displayTitle.split(/\r?\n/)[0] ?? session.displayTitle
 									}),
 									pinnedSessionIds.includes(id) && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 										className: "dcu-wb-pin",
@@ -1788,20 +1917,29 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
 								className: "dcu-wb-section",
 								"aria-label": t("workspace.pinned"),
-								"data-pin-over": workspaceDragId !== void 0 && pinSlot === "header",
+								"data-pin-over": pinDragActive && pinSlot === "header",
 								onDragOver: (event) => {
-									if (workspaceDragId === void 0) return;
+									if (!pinDragActive && !isSidebarItemDrag(event.dataTransfer)) return;
 									event.preventDefault();
+									event.dataTransfer.dropEffect = "move";
 									if (event.target === event.currentTarget || event.target instanceof Element && event.target.closest(".dcu-wb-section-head") !== null) setPinSlot("header");
 								},
 								onDrop: (event) => {
 									event.preventDefault();
-									const dragged = workspaceDragId;
+									const draggedSession = readSessionDrag(event.dataTransfer, sessionDrag?.sessionId);
+									const draggedWorkspace = readWorkspaceDrag(event.dataTransfer, workspaceDragId);
 									const slot = pinSlot;
 									setWorkspaceDragId(void 0);
 									setWorkspaceDropId(void 0);
+									setWorkspaceDropAfter(false);
+									setSessionDrag(void 0);
+									setSessionDropId(void 0);
 									setPinSlot(void 0);
-									if (dragged !== void 0) pinWorkspaceAt(dragged, slot === "header" ? pinnedGroups[0] === void 0 ? void 0 : String(pinnedGroups[0].workspaceId) : slot === "end" || slot === void 0 ? void 0 : slot);
+									if (draggedSession !== void 0) {
+										pinSessionAt(draggedSession, slot === "header" ? pinSectionSessions[0] : slot === "end" || slot === void 0 || !pinSectionSessions.includes(slot) ? void 0 : slot);
+										return;
+									}
+									if (draggedWorkspace !== void 0) pinWorkspaceAt(draggedWorkspace, slot === "header" ? pinnedGroups[0] === void 0 ? void 0 : String(pinnedGroups[0].workspaceId) : slot === "end" || slot === void 0 || pinSectionSessions.includes(slot) ? void 0 : slot);
 								},
 								onDragLeave: (event) => {
 									if (event.currentTarget.contains(event.relatedTarget)) return;
@@ -1837,18 +1975,159 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 									className: "dcu-wb-section-body",
 									"data-open": sectionOpen("pinned"),
-									children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", { children: [pinnedGroups.length > 0 ? pinnedGroups.map((workspace) => renderGroup(workspace, "pinned")) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-										className: "dcu-wb-empty",
-										children: t("workspace.pinnedEmpty")
-									}), workspaceDragId !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-										className: `dcu-wb-pin-end${pinSlot === "end" ? " dcu-wb-drop" : ""}`,
-										onDragOver: (event) => {
-											event.preventDefault();
-											event.stopPropagation();
-											setPinSlot("end");
-											setWorkspaceDropId(void 0);
-										}
-									})] })
+									children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", { children: [
+										pinSectionSessions.length === 0 && pinnedGroups.length === 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+											className: "dcu-wb-empty",
+											children: t("workspace.pinnedEmpty")
+										}),
+										pinSectionSessions.map((id) => {
+											const session = sessions.byId[id];
+											if (session === void 0) return null;
+											const title = session.displayTitle;
+											const workspace = groups.items.find((item) => item.visibleIds.includes(id));
+											const path = session.cwd ?? workspace?.path;
+											return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SessionRow, {
+												id,
+												title,
+												flat: true,
+												selected: sessions.current === id,
+												menuOpen: menu?.type === "session" && menu.id === id,
+												pinned: true,
+												unread: unreadSessionIds.includes(id),
+												running: session.running === true,
+												t,
+												menuItems: sessionMenu(id, title, path),
+												menuPoint: menu?.type === "session" && menu.id === id && menu.x !== void 0 && menu.y !== void 0 ? {
+													x: menu.x,
+													y: menu.y
+												} : void 0,
+												draggable: true,
+												dropActive: sessionDropId === id,
+												onDragStart: (event) => {
+													event.stopPropagation();
+													setWorkspaceDragId(void 0);
+													writeSessionDrag(event.dataTransfer, id, title);
+													const preview = document.createElement("div");
+													preview.className = "dcu-wb-drag-ghost";
+													preview.textContent = title;
+													document.body.appendChild(preview);
+													event.dataTransfer.setDragImage(preview, 16, 18);
+													window.requestAnimationFrame(() => {
+														preview.remove();
+													});
+													setSessionDrag({
+														sessionId: id,
+														workspaceId: workspace?.workspaceId ?? ""
+													});
+												},
+												onDragEnd: () => {
+													setSessionDrag(void 0);
+													setSessionDropId(void 0);
+													setPinSlot(void 0);
+												},
+												onDragOver: (event) => {
+													if (sessionDrag === void 0) return;
+													event.preventDefault();
+													event.stopPropagation();
+													setSessionDropId(id);
+													setPinSlot(id);
+												},
+												onDrop: (event) => {
+													event.preventDefault();
+													event.stopPropagation();
+													const draggedSession = readSessionDrag(event.dataTransfer, sessionDrag?.sessionId);
+													const after = event.clientY > event.currentTarget.getBoundingClientRect().top + event.currentTarget.getBoundingClientRect().height / 2;
+													setSessionDrag(void 0);
+													setSessionDropId(void 0);
+													setPinSlot(void 0);
+													if (draggedSession === void 0) return;
+													pinSessionAt(draggedSession, dropBeforeId(pinSectionSessions, id, after));
+												},
+												onOpen: () => {
+													setUnreadSessionIds((ids) => ids.filter((item) => item !== id));
+													openSession(id);
+												},
+												onMenuChange: (open) => {
+													setMenu(open ? {
+														id,
+														type: "session"
+													} : void 0);
+												},
+												onPin: () => {
+													setSectionSessionIds((ids) => ids.filter((item) => item !== id));
+												},
+												onArchive: () => {
+													run("archive", () => archiveSession(id));
+												},
+												onHover: (event) => {
+													const box = hoverCardAnchor(event.currentTarget.getBoundingClientRect());
+													showTip({
+														kind: "session",
+														id,
+														title,
+														project: workspace?.title,
+														path,
+														time: formatHoverTime(session.updatedAt),
+														left: box.left,
+														top: box.top
+													});
+												},
+												onLeave: hideTip,
+												onContextMenu: (event) => {
+													event.preventDefault();
+													event.stopPropagation();
+													dismissTip();
+													setMenu({
+														id,
+														type: "session",
+														x: event.clientX,
+														y: event.clientY
+													});
+												},
+												onSelectAction: (action) => {
+													if (busy !== void 0) return;
+													if (action === "rename") beginRename("session", id, title);
+													if (action === "pin") {
+														setSectionSessionIds((ids) => ids.filter((item) => item !== id));
+														setMenu(void 0);
+													}
+													if (action === "unread") {
+														setUnreadSessionIds((ids) => toggleSessionId(ids, id));
+														setMenu(void 0);
+													}
+													if (action === "archive") run("archive", () => archiveSession(id));
+													if (action === "delete") {
+														setDeleteTarget({
+															id,
+															kind: "session",
+															title
+														});
+														setError(void 0);
+														setMenu(void 0);
+													}
+													if (action === "fork") run("fork", () => forkSession(id));
+													if (action === "openPath" && path !== void 0) run("open-path", () => openPath(path));
+													if (action === "copyPath") copy(path);
+													if (action === "copyTitle") copy(title);
+													if (action === "copyId") copy(id);
+													if (action === "copyLink") copy(sessionDeepLink(browserBase(), id));
+												}
+											}, id);
+										}),
+										pinnedGroups.map((workspace) => renderGroup(workspace, "pinned")),
+										pinDragActive && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+											className: `dcu-wb-pin-end${pinSlot === "end" ? " dcu-wb-drop" : ""}`,
+											onDragOver: (event) => {
+												if (!pinDragActive && !isSidebarItemDrag(event.dataTransfer)) return;
+												event.preventDefault();
+												event.stopPropagation();
+												event.dataTransfer.dropEffect = "move";
+												setPinSlot("end");
+												setWorkspaceDropId(void 0);
+												setWorkspaceDropAfter(false);
+											}
+										})
+									] })
 								})]
 							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
@@ -1954,6 +2233,29 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 											running: session.running === true,
 											t,
 											menuItems: sessionMenu(id, title, session.cwd),
+											draggable: true,
+											onDragStart: (event) => {
+												event.stopPropagation();
+												setWorkspaceDragId(void 0);
+												writeSessionDrag(event.dataTransfer, id, title);
+												const preview = document.createElement("div");
+												preview.className = "dcu-wb-drag-ghost";
+												preview.textContent = title;
+												document.body.appendChild(preview);
+												event.dataTransfer.setDragImage(preview, 16, 18);
+												window.requestAnimationFrame(() => {
+													preview.remove();
+												});
+												setSessionDrag({
+													sessionId: id,
+													workspaceId: ""
+												});
+											},
+											onDragEnd: () => {
+												setSessionDrag(void 0);
+												setSessionDropId(void 0);
+												setPinSlot(void 0);
+											},
 											menuPoint: menu?.type === "session" && menu.id === id && menu.x !== void 0 && menu.y !== void 0 ? {
 												x: menu.x,
 												y: menu.y
@@ -3417,11 +3719,9 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			});
 		}
 		CodexSidebar.displayName = "michengai-codex-ui";
+		//#endregion
+		//#region src/dependencies.ts
 		const MANAGED_DEPENDENCIES = [
-			{
-				id: "suite",
-				packageName: "@michengai/dsh-codex-suite"
-			},
 			{
 				id: "ui",
 				packageName: "@michengai/dsh-codex-ui"
@@ -3711,7 +4011,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			"search.actions": "快捷操作",
 			"workspace.label": "工作区会话",
 			"workspace.pinned": "置顶",
-			"workspace.pinnedEmpty": "拖动项目到此处置顶",
+			"workspace.pinnedEmpty": "拖动项目或会话到此处置顶",
 			"workspace.projects": "项目",
 			"workspace.recent": "最近",
 			"workspace.recentEmpty": "无聊天",
@@ -3782,7 +4082,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			"about.feature.conversation": "保留原生消息、工具调用、输入、权限和模型选择，仅调整容器视觉",
 			"about.feature.navigator": "当前会话提供轮次缩略导航，可快速跳转至每一次用户提问",
 			"about.dependencies": "配套管理插件",
-			"about.dependenciesDescription": "可先安装 Codex 套件一键装齐配套插件，也可单独检查并更新专家、技能、归档、IM、定时任务和第三方插件市场。",
+			"about.dependenciesDescription": "每个配套插件都单独安装和更新，互不影响。可分别检查 Codex UI、专家、技能、归档、IM、定时任务和第三方插件市场。",
 			"about.loading": "正在读取依赖安装状态…",
 			"about.statusFailed": "暂时无法读取依赖安装状态。",
 			"about.installed": "已安装",
@@ -3792,7 +4092,8 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			"about.update": "更新",
 			"about.installing": "安装中",
 			"about.installFailed": "依赖安装失败，请稍后重试。",
-			"about.restartRequired": "依赖安装完成。请重启 DSH Web 服务以加载新插件。",
+			"about.restartRequired": "正在热更新插件，窗口会自动刷新。",
+			"about.dependency.dsh": "DeepSeek Harness",
 			"about.dependency.suite": "Codex 套件",
 			"about.dependency.ui": "Codex UI",
 			"about.dependency.experts": "专家管理",
@@ -3842,7 +4143,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			"workspace.pin": "Pin project",
 			"workspace.unpin": "Unpin",
 			"workspace.pinned": "Pinned",
-			"workspace.pinnedEmpty": "Drag a project here to pin it",
+			"workspace.pinnedEmpty": "Drag a project or chat here to pin it",
 			"workspace.openPath": "Open in file explorer",
 			"workspace.delete": "Delete project",
 			"workspace.deleteDescription": "This removes “{name}” from the project list. The folder and conversation records remain.",
@@ -3904,7 +4205,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			"about.feature.conversation": "Keeps native messages, tool calls, composer, permissions, and model selection while refining the container visuals",
 			"about.feature.navigator": "Navigate directly to each user prompt with the current conversation turn navigator",
 			"about.dependencies": "Companion management plugins",
-			"about.dependenciesDescription": "Install the Codex suite to get all companion plugins at once, or check and update the expert, skill, archive, IM, scheduled-task, and marketplace plugins individually.",
+			"about.dependenciesDescription": "Each companion plugin is installed and updated separately. Check Codex UI, expert, skill, archive, IM, scheduled-task, and marketplace plugins on their own.",
 			"about.loading": "Loading dependency status…",
 			"about.statusFailed": "Dependency status is temporarily unavailable.",
 			"about.installed": "Installed",
@@ -3914,7 +4215,8 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			"about.update": "Update",
 			"about.installing": "Installing",
 			"about.installFailed": "Dependency installation failed. Try again later.",
-			"about.restartRequired": "Installation is complete. Restart DSH Web to load the new plugin.",
+			"about.restartRequired": "Updating plugins now. The window will refresh automatically.",
+			"about.dependency.dsh": "DeepSeek Harness",
 			"about.dependency.suite": "Codex suite",
 			"about.dependency.ui": "Codex UI",
 			"about.dependency.experts": "Expert management",

package/dist/index.mjs

@@ -14,10 +14,6 @@ const SUITE_MEMBER_PACKAGES = [
 	"@michengai/dsh-automation"
 ];
 const MANAGED_DEPENDENCIES = [
-	{
-		id: "suite",
-		packageName: SUITE_PACKAGE
-	},
 	{
 		id: "ui",
 		packageName: "@michengai/dsh-codex-ui"
@@ -52,6 +48,8 @@ function managedDependency(id) {
 }
 //#endregion
 //#region src/dependency-manager.ts
+const PROFILE_PENDING_UPDATES_FILE = ".dsh-pending-updates.json";
+const APPLY_PLUGIN_UPDATES_IPC = "apply-plugin-updates";
 function profileDirectory() {
 	if (process.env.DSH_PROFILE_DIR !== void 0) return process.env.DSH_PROFILE_DIR;
 	return resolve(homedir(), ".dsh", "profiles", "web");
@@ -68,14 +66,14 @@ async function declaredPluginNames() {
 		throw error;
 	}
 }
-/** 安装套件前卸掉已单独安装的子插件，避免两套 patch 重复注册同一 id。 */
+/** 单独更新子插件时先卸套件，避免两套 patch 冲突。 */
 function pluginsToRemoveBeforeInstall(declared, installing) {
-	if (installing !== "@michengai/dsh-codex-suite") return [];
-	return SUITE_MEMBER_PACKAGES.filter((name) => declared.includes(name));
+	if (SUITE_MEMBER_PACKAGES.includes(installing) && declared.includes("@michengai/dsh-codex-suite")) return [SUITE_PACKAGE];
+	if (installing === "@michengai/dsh-codex-suite") return SUITE_MEMBER_PACKAGES.filter((name) => declared.includes(name));
+	return [];
 }
-/** 已装套件时，子插件的安装/更新改走套件，避免再写入一份 bundle。 */
-function resolveDshPluginTarget(installing, declared) {
-	if (installing !== "@michengai/dsh-codex-suite" && SUITE_MEMBER_PACKAGES.includes(installing) && declared.includes("@michengai/dsh-codex-suite")) return SUITE_PACKAGE;
+/** 点击哪个包就更新哪个包，不再把子插件重定向到套件。 */
+function resolveDshPluginTarget(installing, _declared = []) {
 	return installing;
 }
 async function installedPackageVersion(packageName) {
@@ -190,12 +188,55 @@ function resolveDshCliEntry(entry = process.argv[1], cwd = process.cwd()) {
 	if (entry.startsWith("file:")) return fileURLToPath(entry);
 	return resolve(cwd, entry);
 }
+function requestDesktopHotUpdate(send = process.send) {
+	if (typeof send !== "function") return false;
+	send(APPLY_PLUGIN_UPDATES_IPC);
+	return true;
+}
+function isRestartableInstallError(error) {
+	const message = error instanceof Error ? error.message : String(error);
+	return /完全退出桌面端|正在运行的插件|pnpm 仓库不一致/.test(message);
+}
+async function recordPendingUpdate(packageName, version) {
+	const pendingPath = resolve(profileDirectory(), PROFILE_PENDING_UPDATES_FILE);
+	let packages = [];
+	try {
+		const parsed = JSON.parse(await readFile(pendingPath, "utf8"));
+		if (Array.isArray(parsed.packages)) packages = parsed.packages.flatMap((item) => {
+			if (item === null || typeof item !== "object") return [];
+			const record = item;
+			if (typeof record.packageName !== "string" || typeof record.version !== "string") return [];
+			return [{
+				packageName: record.packageName,
+				version: record.version
+			}];
+		});
+	} catch (error) {
+		if (error.code !== "ENOENT") throw error;
+	}
+	packages = packages.filter((item) => item.packageName !== packageName);
+	packages.push({
+		packageName,
+		version
+	});
+	await writeFile(pendingPath, `${JSON.stringify({ packages }, void 0, 2)}\n`, "utf8");
+}
+async function recordDeclaredVersion(packageName, version) {
+	const manifestPath = resolve(profileDirectory(), "package.json");
+	const manifest = JSON.parse(await readFile(manifestPath, "utf8"));
+	manifest.dependencies = {
+		...manifest.dependencies,
+		[packageName]: version
+	};
+	await writeFile(manifestPath, `${JSON.stringify(manifest, void 0, 2)}\n`, "utf8");
+}
 function pluginCommandError(stderr) {
 	const detail = stderr.replace(/\s+/g, " ").trim();
 	if (detail.includes("minimumReleaseAge") || detail.includes("Release age")) return /* @__PURE__ */ new Error("更新被 pnpm 发布时间保护拦截。请确认已写入当前版本白名单后重试。");
-	if (detail.includes("EPERM") || detail.includes("EBUSY") || detail.includes("EACCES")) return /* @__PURE__ */ new Error("无法覆盖正在运行的插件文件。请先停止 DSH Web，再点击更新。");
-	if (detail.includes("NO_MATCHING_VERSION") || detail.includes("No matching version")) return /* @__PURE__ */ new Error("当前 npm 镜像还没有这个版本。请稍后重试，或改用官方源安装。");
-	return /* @__PURE__ */ new Error("从 npm 安装或更新依赖失败。请检查网络、npm registry 或发布时间保护后重试。");
+	if (/EPERM|EBUSY|EACCES|unable to unlink|ERR_PNPM_LOCKED|Lock/i.test(detail)) return /* @__PURE__ */ new Error("无法覆盖正在运行的插件文件。请先完全退出桌面端，再重新打开后更新。");
+	if (/UNEXPECTED_STORE|Unexpected store location/i.test(detail)) return /* @__PURE__ */ new Error("插件目录和 pnpm 仓库不一致。请完全退出桌面端后再更新。");
+	if (/pnpm not found/i.test(detail)) return /* @__PURE__ */ new Error("当前环境找不到 pnpm。请从桌面端启动后再更新。");
+	return /* @__PURE__ */ new Error("无法在应用运行时更新插件。请先完全退出桌面端，再重新打开后更新。");
 }
 /**
 * 复用启动当前服务的 DSH CLI：它会通过 pnpm 从 npm 安装或更新，并自动维护
@@ -220,19 +261,21 @@ function runDshPlugin(args) {
 			windowsHide: true,
 			stdio: [
 				"ignore",
-				"ignore",
+				"pipe",
 				"pipe"
 			]
 		});
-		let stderr = "";
-		child.stderr?.on("data", (chunk) => {
-			stderr += String(chunk);
-		});
+		let output = "";
+		const collect = (chunk) => {
+			output += String(chunk);
+		};
+		child.stdout?.on("data", collect);
+		child.stderr?.on("data", collect);
 		child.once("error", () => {
 			reject(/* @__PURE__ */ new Error("无法启动 DSH 插件安装命令。请确认 Node.js 与 pnpm 可用后重试。"));
 		});
 		child.once("exit", (code) => {
-			code === 0 ? resolvePromise() : reject(pluginCommandError(stderr));
+			code === 0 ? resolvePromise() : reject(pluginCommandError(output));
 		});
 	});
 }
@@ -260,13 +303,20 @@ async function installDependencyLocked(id) {
 	const remove = pluginsToRemoveBeforeInstall(declared, target);
 	if (remove.length > 0) await runDshPlugin(["remove", ...remove]);
 	await ensureLatestReleaseAllowed(target, targetVersion);
-	await runDshPlugin([
-		"add",
-		`${target}@${targetVersion}`,
-		"--registry=https://registry.npmjs.org/"
-	]);
-	const installed = await installedPackageVersion(target);
-	if (installed !== targetVersion) throw new Error(`已请求 ${target}@${targetVersion}，但当前仍是 ${installed ?? "未安装"}。请先停止 DSH Web 后再更新。`);
+	await recordDeclaredVersion(target, targetVersion);
+	await recordPendingUpdate(target, targetVersion);
+	if (requestDesktopHotUpdate()) return dependencyStatuses();
+	try {
+		await runDshPlugin([
+			"add",
+			`${target}@${targetVersion}`,
+			"--registry=https://registry.npmjs.org/"
+		]);
+	} catch (error) {
+		if (isRestartableInstallError(error)) return dependencyStatuses();
+		throw error;
+	}
+	if (await installedPackageVersion(target) !== targetVersion) return dependencyStatuses();
 	return dependencyStatuses();
 }
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michengai/dsh-codex-ui",
-  "version": "0.2.58",
+  "version": "0.2.60",
   "description": "以 Codex 风格重构 DSH Web 侧栏的独立客户端插件",
   "license": "Apache-2.0",
   "publishConfig": {
@@ -51,6 +51,10 @@
       "platform": "web"
     }
   },
+  "scripts": {
+    "build": "tsc --noEmit && tsdown",
+    "test": "tsx tests/permission-i18n.assert.ts && 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"
+  },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.1 <5.0.0",
     "@deepseek-ai/dsh-client-locale": ">=0.1.0-rc.0 <0.2.0",
@@ -96,9 +100,5 @@
     "tsx": "^4.22.4",
     "typescript": "^6.0.3",
     "vitest": "^4.1.8"
-  },
-  "scripts": {
-    "build": "tsc --noEmit && tsdown",
-    "test": "tsx tests/permission-i18n.assert.ts && 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"
   }
-}
+}