@michengai/dsh-codex-ui 0.2.59 → 0.2.61

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,.dcu-wb-pin-start{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-pin-start.dcu-wb-drop::before{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,28 @@ 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",
 								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 +1974,171 @@ 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: [
+										(pinDragActive || pinSlot === "header") && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+											className: `dcu-wb-pin-start${pinSlot === "header" ? " dcu-wb-drop" : ""}`,
+											onDragOver: (event) => {
+												if (!pinDragActive && !isSidebarItemDrag(event.dataTransfer)) return;
+												event.preventDefault();
+												event.stopPropagation();
+												event.dataTransfer.dropEffect = "move";
+												setPinSlot("header");
+												setWorkspaceDropId(void 0);
+												setWorkspaceDropAfter(false);
+											}
+										}),
+										pinSectionSessions.length === 0 && pinnedGroups.length === 0 && pinSlot !== "header" && /* @__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 +2244,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,10 +3730,12 @@ 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: "dsh",
+				packageName: "@deepseek-ai/dsh"
 			},
 			{
 				id: "ui",
@@ -3469,31 +3784,48 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			const [installing, setInstalling] = (0, react.useState)();
 			const [message, setMessage] = (0, react.useState)();
 			const alive = (0, react.useRef)(true);
+			const root = (0, react.useRef)(null);
+			const stateRef = (0, react.useRef)("loading");
+			const requestId = (0, react.useRef)(0);
+			stateRef.current = state;
 			(0, react.useEffect)(() => () => {
 				alive.current = false;
 			}, []);
 			const load = (0, react.useCallback)(async (signal) => {
-				setState("loading");
+				const currentRequest = ++requestId.current;
+				if (stateRef.current !== "ready") setState("loading");
 				try {
 					const response = await fetch(endpoint, {
 						cache: "no-store",
 						signal
 					});
 					const payload = await response.json();
-					if (signal?.aborted) return;
+					if (signal?.aborted || currentRequest !== requestId.current) return;
 					if (!response.ok || !Array.isArray(payload.dependencies) || !payload.dependencies.every(isDependencyStatus)) throw new Error();
 					setDependencies(payload.dependencies);
 					setState("ready");
 				} catch (error) {
-					if (signal?.aborted || error instanceof DOMException && error.name === "AbortError") return;
-					setState("failed");
+					if (signal?.aborted || error instanceof DOMException && error.name === "AbortError" || currentRequest !== requestId.current) return;
+					if (stateRef.current !== "ready") setState("failed");
 				}
 			}, []);
 			(0, react.useEffect)(() => {
+				const node = root.current;
 				const controller = new AbortController();
-				load(controller.signal);
+				const refresh = () => {
+					load(controller.signal);
+				};
+				refresh();
+				if (node === null || typeof IntersectionObserver === "undefined") return () => {
+					controller.abort();
+				};
+				const observer = new IntersectionObserver((entries) => {
+					if (entries.some((entry) => entry.isIntersecting)) refresh();
+				}, { threshold: .2 });
+				observer.observe(node);
 				return () => {
 					controller.abort();
+					observer.disconnect();
 				};
 			}, [load]);
 			const install = async (id) => {
@@ -3522,6 +3854,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			};
 			const title = (id) => t(`about.dependency.${id}`);
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+				ref: root,
 				className: "dcu-about",
 				"aria-label": t("about.nav"),
 				children: [
@@ -3711,7 +4044,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 +4115,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 +4125,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 +4176,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 +4238,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 +4248,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

@@ -15,8 +15,8 @@ const SUITE_MEMBER_PACKAGES = [
 ];
 const MANAGED_DEPENDENCIES = [
 	{
-		id: "suite",
-		packageName: SUITE_PACKAGE
+		id: "dsh",
+		packageName: "@deepseek-ai/dsh"
 	},
 	{
 		id: "ui",
@@ -52,6 +52,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");
@@ -59,50 +61,60 @@ function profileDirectory() {
 async function declaredPluginNames() {
 	try {
 		const manifest = JSON.parse(await readFile(resolve(profileDirectory(), "package.json"), "utf8"));
-		return Object.keys({
+		return [.../* @__PURE__ */ new Set([...Object.keys({
 			...manifest.devDependencies,
 			...manifest.dependencies
-		});
+		}), ...manifest.dsh?.profile?.bundles ?? []])];
 	} catch (error) {
 		if (error.code === "ENOENT") return [];
 		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;
 }
+function isOfficialRuntimePackage(packageName) {
+	return packageName === "@deepseek-ai/dsh" || packageName.startsWith("@deepseek-ai/dsh-");
+}
+function packageLookupRoots(packageName) {
+	if (isOfficialRuntimePackage(packageName) && process.env.DSH_RUNTIME_DIR !== void 0 && process.env.DSH_RUNTIME_DIR !== "") return [process.env.DSH_RUNTIME_DIR, profileDirectory()];
+	return [profileDirectory()];
+}
 async function installedPackageVersion(packageName) {
-	try {
-		const manifest = JSON.parse(await readFile(resolve(profileDirectory(), "node_modules", ...packageName.split("/"), "package.json"), "utf8"));
-		return typeof manifest.version === "string" ? manifest.version : void 0;
+	for (const root of packageLookupRoots(packageName)) try {
+		const manifest = JSON.parse(await readFile(resolve(root, "node_modules", ...packageName.split("/"), "package.json"), "utf8"));
+		if (typeof manifest.version === "string" && manifest.version !== "") return manifest.version;
 	} catch (error) {
-		if (error.code === "ENOENT") return void 0;
-		throw error;
+		if (error.code !== "ENOENT") throw error;
 	}
 }
-/** 以 node_modules 实际版本为准；套件嵌套安装没有写进顶层 dependencies，也算已安装。 */
+/** 磁盘有包且仍在 profile 声明里，才算已安装。卸载后残留的 node_modules 不算。 */
 function isManagedPackageInstalled(input) {
-	return input.installedVersion !== void 0 && input.installedVersion !== "";
+	return input.declared && input.installedVersion !== void 0 && input.installedVersion !== "";
 }
 /** npm latest 查询缓存有效期：避免每次打开“关于”页都打 7 个 registry 请求。 */
 const LATEST_CACHE_TTL_MS = 3e5;
 const latestCache = /* @__PURE__ */ new Map();
-async function npmLatestVersion(packageName) {
-	const hit = latestCache.get(packageName);
+function cacheKey(packageName, tag) {
+	return packageName + "@" + tag;
+}
+async function npmTaggedVersion(packageName, tag) {
+	const key = cacheKey(packageName, tag);
+	const hit = latestCache.get(key);
 	if (hit !== void 0 && Date.now() - hit.at < LATEST_CACHE_TTL_MS) return hit.version;
 	try {
-		const response = await fetch(`https://registry.npmjs.org/${encodeURIComponent(packageName)}/latest`, { signal: AbortSignal.timeout(5e3) });
+		const response = await fetch(`https://registry.npmjs.org/${encodeURIComponent(packageName)}/${tag}`, { signal: AbortSignal.timeout(5e3) });
 		if (!response.ok) return void 0;
 		const manifest = await response.json();
 		if (typeof manifest.version !== "string") return void 0;
-		latestCache.set(packageName, {
+		latestCache.set(key, {
 			version: manifest.version,
 			at: Date.now()
 		});
@@ -111,6 +123,10 @@ async function npmLatestVersion(packageName) {
 		return;
 	}
 }
+async function npmLatestVersion(packageName) {
+	if (isOfficialRuntimePackage(packageName)) return await npmTaggedVersion(packageName, "next") ?? await npmTaggedVersion(packageName, "latest");
+	return npmTaggedVersion(packageName, "latest");
+}
 function escapeRegExp(value) {
 	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
@@ -156,17 +172,29 @@ function versionParts(version) {
 		Number(match[3])
 	];
 }
+function prereleaseRank(version) {
+	const match = /-rc\.(\d+)/i.exec(version);
+	return match === null ? Number.POSITIVE_INFINITY : Number(match[1]);
+}
 function newerVersion(installed, latest) {
 	const current = versionParts(installed);
 	const candidate = versionParts(latest);
 	if (current === void 0 || candidate === void 0) return false;
-	return candidate[0] > current[0] || candidate[0] === current[0] && candidate[1] > current[1] || candidate[0] === current[0] && candidate[1] === current[1] && candidate[2] > current[2];
+	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);
 }
 /** 返回 Web profile 中固定管理插件的实际安装版本与 npm latest 状态。 */
 async function dependencyStatuses() {
+	const declaredNames = await declaredPluginNames();
 	return Promise.all(MANAGED_DEPENDENCIES.map(async (dependency) => {
 		const version = await installedPackageVersion(dependency.packageName);
-		if (!isManagedPackageInstalled({ installedVersion: version })) return {
+		const declared = isOfficialRuntimePackage(dependency.packageName) || declaredNames.includes(dependency.packageName);
+		if (version === void 0 || !isManagedPackageInstalled({
+			installedVersion: version,
+			declared
+		})) return {
 			...dependency,
 			installed: false,
 			updateAvailable: false
@@ -190,12 +218,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 +291,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 +333,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 后再更新。`);
+	if (!isOfficialRuntimePackage(target)) 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.59",
+  "version": "0.2.61",
   "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"
   }
-}
+}