@michengai/dsh-codex-ui 0.2.111 → 0.2.113

package/lib/client.js

@@ -848,6 +848,32 @@ window.__ModuleLoader__.load({
 		function pendingInteractionForSession(sessionId, pendingInteractions, summaryKind) {
 			return visiblePendingKind(summaryKind) ?? visiblePendingKind(pendingInteractions.get(sessionId)?.kind);
 		}
+		//#endregion
+		//#region src/business-api.ts
+		const CODEX_UI_API_BASE = "/api/dsh-codex-ui";
+		const CODEX_UI_API_ENDPOINTS = Object.freeze({
+			connectors: `${CODEX_UI_API_BASE}/connectors`,
+			dependencies: `${CODEX_UI_API_BASE}/dependencies`,
+			openInExplorer: `${CODEX_UI_API_BASE}/open-in-explorer`,
+			preferences: `${CODEX_UI_API_BASE}/preferences`,
+			sessionMove: `${CODEX_UI_API_BASE}/session-move`
+		});
+		//#endregion
+		//#region src/client/business-request-error.ts
+		var BusinessRequestError = class extends Error {
+			status;
+			constructor(status) {
+				super(`业务请求失败：HTTP ${status}`);
+				this.status = status;
+				this.name = "BusinessRequestError";
+			}
+		};
+		function businessRequestErrorKey(error) {
+			if (!(error instanceof BusinessRequestError)) return void 0;
+			if (error.status === 401) return "errors.unauthorized";
+			if (error.status === 403) return "errors.forbidden";
+			if (error.status === 503) return "errors.serviceUnavailable";
+		}
 		const WORKSPACE_GROUP_ERROR_MESSAGES = {
 			"group-invalid": "分组信息无效。",
 			"workspace-invalid": "项目标识无效。",
@@ -1001,7 +1027,7 @@ window.__ModuleLoader__.load({
 		/** 浏览器本地持久化键；用于工作区偏好的首帧恢复与 Host 故障兜底。 */
 		const PINNED_WORKSPACES_STORAGE_KEY = "dsh-codex-ui.pinned-workspace-ids";
 		const WORKSPACE_GROUPS_STORAGE_KEY = "dsh-codex-ui.workspace-groups.v1";
-		const WORKSPACE_PREFERENCES_ENDPOINT = "/api/michengai/codex-ui/preferences";
+		const WORKSPACE_PREFERENCES_ENDPOINT = CODEX_UI_API_ENDPOINTS.preferences;
 		/** 清理无效或重复的工作区标识。 */
 		function normalizePinnedWorkspaceIds(ids) {
 			return [...new Set(ids.filter((id) => id.trim() !== ""))];
@@ -1040,7 +1066,7 @@ window.__ModuleLoader__.load({
 				cache: "no-store",
 				signal: AbortSignal.timeout(5e3)
 			});
-			if (!response.ok) throw new Error(`读取置顶偏好失败：HTTP ${response.status}`);
+			if (!response.ok) throw new BusinessRequestError(response.status);
 			const payload = await response.json();
 			if (payload === null || typeof payload !== "object") throw new Error("置顶偏好响应格式无效。");
 			const record = payload;
@@ -1067,7 +1093,7 @@ window.__ModuleLoader__.load({
 				}),
 				signal: AbortSignal.timeout(5e3)
 			});
-			if (!response.ok) throw new Error(`保存置顶偏好失败：HTTP ${response.status}`);
+			if (!response.ok) throw new BusinessRequestError(response.status);
 		}
 		/** 兼容旧调用方；新代码应同时写入分组。 */
 		async function readHostPinnedWorkspaceIds(fetcher = fetch) {
@@ -2009,6 +2035,8 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 		}
 		/** 将业务错误映射为当前语言，未知底层错误统一脱敏。 */
 		function userErrorText(error, t) {
+			const requestKey = businessRequestErrorKey(error);
+			if (requestKey !== void 0) return t(requestKey);
 			if (error instanceof UserFacingError) return error.message;
 			if (error instanceof WorkspaceGroupError) return t(WORKSPACE_GROUP_ERROR_KEYS[error.code]);
 			if (error instanceof HostActionError) return t(hostActionErrorKey(error));
@@ -2016,16 +2044,20 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 		}
 		/** 安装错误保留用户可执行的处理建议，但不直接展示 Host 原文。 */
 		function installErrorText(error, t) {
+			const requestKey = businessRequestErrorKey(error);
+			if (requestKey !== void 0) return t(requestKey);
 			const message = error instanceof Error ? error.message : String(error);
 			return t(INSTALL_ERROR_KEYS.find(([pattern]) => pattern.test(message))?.[1] ?? "about.installFailed");
 		}
 		//#endregion
 		//#region src/client/session-move.ts
-		const SESSION_MOVE_ENDPOINT = "/api/michengai/codex-ui/session-move";
+		const SESSION_MOVE_ENDPOINT = CODEX_UI_API_ENDPOINTS.sessionMove;
 		const MOVE_ACTION_PREFIX = "move-session:";
 		const SESSION_MOVE_ERROR_KEYS = {
 			"session-move/unavailable": "sessions.moveUnavailable",
 			"session-move/service-unavailable": "sessions.moveUnavailable",
+			"session-move/unauthorized": "sessions.moveUnauthorized",
+			"session-move/forbidden": "sessions.moveForbidden",
 			"session-move/session-not-found": "sessions.moveNotFound",
 			"session-move/workspace-not-found": "sessions.moveNotFound",
 			"session-move/subagent-unsupported": "sessions.moveSubagent",
@@ -2101,6 +2133,85 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			for (const sessionId of new Set(sessionIds)) await archiveSession(sessionId);
 		}
 		//#endregion
+		//#region src/client/workspace-drop-indicator.ts
+		const ROWS = ".dcu-wb-section-head,.dcu-wb-collection-head,.dcu-wb-project-head,.dcu-wb-session,.dcu-wb-nochat,.dcu-wb-empty";
+		const TARGETS = ".dcu-wb-drop,.dcu-wb-group-order-drop";
+		function measureWorkspaceDropIndicator(root, onTargets) {
+			const measured = Array.from(root.querySelectorAll(TARGETS)).filter((node) => node.closest("[data-open=false]") === null).map((target) => ({
+				target,
+				rect: measureTarget(root, target)
+			})).filter((item) => item.rect !== void 0);
+			const unique = measured.filter((item, index) => !measured.slice(0, index).some((previous) => previous.rect.top === item.rect.top && previous.rect.left === item.rect.left && previous.rect.width === item.rect.width));
+			onTargets?.(unique.map((item) => item.target));
+			return unique[0]?.rect;
+		}
+		function measureTarget(root, target) {
+			const section = target.closest(".dcu-wb-section") ?? root;
+			const rows = Array.from(section.querySelectorAll(ROWS)).filter((node) => node.closest("[data-open=false]") === null).map((node) => ({
+				node,
+				rect: node.getBoundingClientRect()
+			})).filter((row) => row.rect.height > 0 && row.rect.width > 0);
+			const owned = rows.filter((row) => row.node === target || target.contains(row.node));
+			const after = target.classList.contains("dcu-wb-drop-after");
+			let upper;
+			let lower;
+			let anchor = target.getBoundingClientRect();
+			if (owned.length > 0) {
+				const edge = after ? owned[owned.length - 1] : owned[0];
+				const index = rows.indexOf(edge);
+				anchor = edge.rect;
+				upper = after ? edge.rect.bottom : rows[index - 1]?.rect.bottom;
+				lower = after ? rows[index + 1]?.rect.top : edge.rect.top;
+			} else if (target.matches(".dcu-wb-pin-start,.dcu-wb-pin-end")) {
+				if (anchor.width <= 0 || anchor.height <= 0) return void 0;
+				upper = rows.filter((row) => row.rect.bottom <= anchor.top).at(-1)?.rect.bottom;
+				lower = rows.find((row) => row.rect.top >= anchor.bottom)?.rect.top;
+				if (lower === void 0) lower = anchor.bottom;
+				if (upper === void 0) upper = anchor.top;
+			} else return void 0;
+			const center = upper === void 0 ? lower - 4 : lower === void 0 ? upper + 4 : (upper + lower) / 2;
+			const box = root.getBoundingClientRect();
+			return {
+				top: center - box.top - root.clientTop + root.scrollTop - 4,
+				left: anchor.left - box.left - root.clientLeft + root.scrollLeft + 4,
+				width: Math.max(0, anchor.width - 12)
+			};
+		}
+		/** 仅拖拽期间刷新，滚动、折叠动画和尺寸变化都使用当前帧的布局；结束时完整清理。 */
+		function mountWorkspaceDropIndicator(root) {
+			const line = root.ownerDocument.createElement("div");
+			line.className = "dcu-wb-drop-indicator";
+			line.setAttribute("aria-hidden", "true");
+			root.append(line);
+			root.dataset.dropIndicator = "measured";
+			const view = root.ownerDocument.defaultView;
+			let frame = 0;
+			let previous = "";
+			let previousConflict = [];
+			const update = () => {
+				const rect = measureWorkspaceDropIndicator(root, (targets) => {
+					const conflict = targets.length > 1 ? targets : [];
+					if (conflict.length > 1 && (conflict.length !== previousConflict.length || conflict.some((target, index) => target !== previousConflict[index]))) console.warn("Codex UI 拖拽存在多个有效落点，请检查跨区状态清理。", { count: conflict.length });
+					previousConflict = conflict;
+				});
+				const next = rect === void 0 ? "" : `${rect.top},${rect.left},${rect.width}`;
+				line.hidden = rect === void 0;
+				if (rect !== void 0 && next !== previous) {
+					line.style.top = `${rect.top}px`;
+					line.style.left = `${rect.left}px`;
+					line.style.width = `${rect.width}px`;
+				}
+				previous = next;
+				frame = view.requestAnimationFrame(update);
+			};
+			update();
+			return () => {
+				view.cancelAnimationFrame(frame);
+				line.remove();
+				delete root.dataset.dropIndicator;
+			};
+		}
+		//#endregion
 		//#region src/client/CodexWorkspaceBrowser.tsx
 		const DISCLOSURE_EXIT_MS = 180;
 		function NewSessionIcon() {
@@ -2259,8 +2370,40 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 .dcu-wb-rename-input:focus{border-color:var(--dsw-alias-state-business-primary);box-shadow:0 0 0 1px color-mix(in srgb,var(--dsw-alias-state-business-primary) 28%,transparent)}
 `;
 		const runningStyles = `.dcu-wb-running{position:absolute;right:10px;top:50%;flex:none;width:12px;height:12px;margin-top:-6px;border:2px solid color-mix(in srgb,var(--dcu-sidebar-secondary) 25%,transparent);border-top-color:var(--dcu-sidebar-secondary);border-radius:50%;animation:dcu-wb-spin .8s linear infinite}@keyframes dcu-wb-spin{to{transform:rotate(360deg)}}@media (prefers-reduced-motion:reduce){.dcu-wb-running{animation:none}}`;
-		const typographyStyles = `.dcu-wb{--dcu-wb-disclosure-duration:180ms;--dcu-wb-disclosure-ease:cubic-bezier(.16,1,.3,1);font:14px/20px var(--dcu-font,var(--dsw-font-family))}.dcu-wb-section-label{color:var(--dcu-sidebar-secondary);font:13px/20px var(--dcu-font,var(--dsw-font-family));font-weight:400;letter-spacing:0;padding-left:0}.dcu-wb-section-caret{transition:opacity var(--dcu-wb-disclosure-duration) var(--dcu-wb-disclosure-ease),transform var(--dcu-wb-disclosure-duration) var(--dcu-wb-disclosure-ease)}.dcu-wb-section-head .dcu-wb-section-caret{position:static;left:auto;top:auto;opacity:.78}.dcu-wb-section-body,.dcu-wb-project-body,.dcu-wb-collection-body{display:block;min-height:0;height:auto;overflow:clip;opacity:1;transform:none;visibility:visible}.dcu-wb-section-body[data-open=false],.dcu-wb-project-body[data-open=false],.dcu-wb-collection-body[data-open=false]{display:block;height:0;opacity:0;transform:translateY(-2px);pointer-events:none}.dcu-wb-section-body[data-open=true]:has(.dcu-wb-drop),.dcu-wb-project-body[data-open=true]:has(.dcu-wb-drop),.dcu-wb-collection-body[data-open=true]:has(.dcu-wb-drop){overflow:visible}.dcu-wb-section-body[data-open=true]>div{animation:none}@media (prefers-reduced-motion:reduce){.dcu-wb-section-caret{transition:none}}.dcu-wb-project-title{font-size:14px;line-height:20px;font-weight:400;color:var(--dcu-sidebar-primary)}.dcu-wb-session-title{font-size:14px;line-height:20px;font-weight:400;color:var(--dcu-sidebar-secondary)}.dcu-wb-session.dcu-wb-selected .dcu-wb-session-title,.dcu-wb-session:hover .dcu-wb-session-title{color:var(--dcu-sidebar-primary)}.dcu-wb-empty{color:var(--dcu-sidebar-tertiary);font-size:13px;line-height:18px}.dcu-wb-nochat{padding:0 8px 4px 28px;color:var(--dcu-sidebar-tertiary);font-size:14px;line-height:20px}`;
-		const collectionLayoutStyles = `.dcu-wb-collection-body{padding-left:0}.dcu-wb-collection-body .dcu-wb-project-head{padding-left:8px}.dcu-wb-collection-body::before,.dcu-wb-group-member::after{display:none}.dcu-wb-collection-head,.dcu-wb-collection-head:focus-within{background:color-mix(in srgb,var(--dcu-sidebar-hover) 28%,transparent)}.dcu-wb-collection-head:hover{background:var(--dcu-sidebar-hover)}.dcu-wb-collection-head.dcu-wb-group-drop{background:var(--dcu-sidebar-hover)}.dcu-wb-workspace-move-drop>.dcu-wb-collection-head{background:transparent}`;
+		const typographyStyles = `.dcu-wb{--dcu-wb-disclosure-duration:180ms;--dcu-wb-disclosure-ease:cubic-bezier(.16,1,.3,1);font:14px/20px var(--dcu-font,var(--dsw-font-family))}.dcu-wb-section-label{color:var(--dcu-sidebar-secondary);font:13px/20px var(--dcu-font,var(--dsw-font-family));font-weight:400;letter-spacing:0;padding-left:0}.dcu-wb-section-caret{transition:opacity var(--dcu-wb-disclosure-duration) var(--dcu-wb-disclosure-ease),transform var(--dcu-wb-disclosure-duration) var(--dcu-wb-disclosure-ease)}.dcu-wb-section-head .dcu-wb-section-caret{position:static;left:auto;top:auto;opacity:.78}.dcu-wb-section-body,.dcu-wb-project-body,.dcu-wb-collection-body{display:block;min-height:0;height:auto;overflow:clip;opacity:1;transform:none;visibility:visible}.dcu-wb-section-body[data-open=false],.dcu-wb-project-body[data-open=false],.dcu-wb-collection-body[data-open=false]{display:block;height:0;opacity:0;transform:translateY(-2px);pointer-events:none}.dcu-wb-section-body[data-open=true]:has(.dcu-wb-drop),.dcu-wb-project-body[data-open=true]:has(.dcu-wb-drop),.dcu-wb-collection-body[data-open=true]:has(.dcu-wb-drop){overflow:visible}.dcu-wb-section-body[data-open=true]>div{animation:none}@media (prefers-reduced-motion:reduce){.dcu-wb-section-caret{transition:none}}.dcu-wb-project-title{font-size:14px;line-height:20px;font-weight:400;color:var(--dcu-sidebar-primary)}.dcu-wb-session-title{font-size:14px;line-height:20px;font-weight:400;color:var(--dcu-sidebar-secondary)}.dcu-wb-session.dcu-wb-selected .dcu-wb-session-title,.dcu-wb-session:hover .dcu-wb-session-title{color:var(--dcu-sidebar-primary)}.dcu-wb-empty{color:var(--dcu-sidebar-tertiary);font-size:13px;line-height:18px}`;
+		const collectionLayoutStyles = `
+.dcu-wb-tree{position:relative}
+.dcu-wb-tree[data-drop-indicator=measured] .dcu-wb-drop::before,.dcu-wb-tree[data-drop-indicator=measured] .dcu-wb-group-order-drop::before{display:none}
+.dcu-wb-drop-indicator{position:absolute;z-index:3;height:8px;pointer-events:none;color:var(--dsw-alias-state-business-primary)}
+.dcu-wb-drop-indicator::before{content:"";position:absolute;left:6px;right:0;top:3px;height:2px;border-radius:999px;background:currentColor}
+.dcu-wb-drop-indicator::after{content:"";position:absolute;box-sizing:border-box;left:0;top:0;width:8px;height:8px;border:2px solid currentColor;border-radius:50%}
+.dcu-wb-project-body:has(>.dcu-wb-session)::after{content:"";display:block;height:4px;pointer-events:none}
+.dcu-wb-section-body[data-open=true]:has(.dcu-wb-group-order-drop){overflow:visible}
+.dcu-wb-collection-body{padding-left:0}
+.dcu-wb-collection-body>.dcu-wb-group-member:first-child{padding-top:4px}
+.dcu-wb-collection-body .dcu-wb-project-head{padding-left:8px}
+.dcu-wb-collection-body>.dcu-wb-empty{padding:8px 8px 8px 26px}
+.dcu-wb-collection-body>.dcu-wb-empty,.dcu-wb-nochat{font-size:13px;line-height:18px;color:var(--dcu-sidebar-tertiary)}
+.dcu-wb-nochat{padding:1px 8px 5px 28px}
+.dcu-wb-collection:has(+.dcu-wb-collection)>.dcu-wb-collection-body>.dcu-wb-empty,.dcu-wb-collection:has(+.dcu-wb-ungrouped)>.dcu-wb-collection-body>.dcu-wb-empty{padding-top:14px;padding-bottom:2px}
+.dcu-wb-collection-body::before,.dcu-wb-group-member::after{display:none}
+.dcu-wb-collections{gap:12px}
+.dcu-wb-collections:has(>.dcu-wb-project){gap:0}
+.dcu-wb-collection-head{min-height:32px}
+.dcu-wb-collection-head:hover{background:var(--dcu-sidebar-hover)}
+.dcu-wb-collection-head.dcu-wb-group-drop{background:var(--dcu-sidebar-hover)}
+.dcu-wb-collection-head{background:color-mix(in srgb,var(--dcu-sidebar-hover) 55%,transparent)}
+.dcu-wb-collection-label{gap:4px;min-height:32px;font-size:14px;font-weight:600}
+.dcu-wb-collection-label .dcu-wb-section-caret{width:14px;height:14px;opacity:1;color:var(--dcu-sidebar-primary)}
+.dcu-wb-collection-label .dcu-wb-section-caret svg{width:14px;height:14px}
+.dcu-wb-collection-label .dcu-wb-section-caret svg path{stroke-width:2}
+.dcu-wb-collection-count{flex:none;font-size:12px;font-weight:400;padding-left:8px}
+.dcu-wb-ungrouped .dcu-wb-collection-label{color:var(--dcu-sidebar-secondary)}
+.dcu-wb-collection-head:focus-within,.dcu-wb-collection-head:has(.dcu-wb-more[aria-expanded=true]){background:var(--dcu-sidebar-hover)}
+.dcu-wb-workspace-move-drop>.dcu-wb-collection-head{background:transparent}
+.dcu-wb-collection-label:focus-visible,.dcu-wb-project-head:focus-visible,.dcu-wb-session:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:-2px;border-radius:6px}
+@media (pointer:coarse){.dcu-wb-collection-head,.dcu-wb-collection-label{min-height:36px}.dcu-wb-collection-actions{width:28px}.dcu-wb-collection-actions .dcu-wb-more{width:28px;height:28px}}
+`;
 		const WORKSPACE_TREE_STYLE = stylesheet$4 + runningStyles + typographyStyles + collectionLayoutStyles;
 		function storage$1() {
 			return browserStorage();
@@ -2296,6 +2439,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			const pinnedHostDirtyRef = (0, react.useRef)(false);
 			const pinnedHostSkipWriteRef = (0, react.useRef)();
 			const pinnedHostWriteRef = (0, react.useRef)(Promise.resolve());
+			const [preferencesFailure, setPreferencesFailure] = (0, react.useState)();
 			const workspaceBaselineRef = (0, react.useRef)({
 				ready: false,
 				validIds: []
@@ -2314,12 +2458,15 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 				};
 				const pending = pinnedHostWriteRef.current.then(async () => {
 					await writeHostWorkspacePreferences(snapshot.pinnedWorkspaceIds, snapshot.workspaceGroups);
+					setPreferencesFailure(void 0);
 					if (!pinnedHostSupportsWorkspaceGroupsRef.current) return;
 					if (!sameIds(pinnedWorkspaceIdsRef.current, snapshot.pinnedWorkspaceIds) || !sameWorkspaceGroups(workspaceGroupsRef.current, snapshot.workspaceGroups)) return;
 					workspaceGroupsPendingHostSyncRef.current = false;
 					saveWorkspaceGroupsCache(storage$1(), snapshot.workspaceGroups, false);
 				});
-				pinnedHostWriteRef.current = pending.catch(() => void 0);
+				pinnedHostWriteRef.current = pending.catch((reason) => {
+					setPreferencesFailure(reason);
+				});
 			};
 			const setPinnedWorkspaceIds = (update) => {
 				pinnedHostDirtyRef.current = true;
@@ -2427,7 +2574,9 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 					}
 					savePinnedWorkspaceIds(storage$1(), ids);
 					if (writeHost) queuePinnedHostWrite(ids, groups);
-				}).catch(() => {
+				}).catch((reason) => {
+					if (!alive) return;
+					setPreferencesFailure(reason);
 					pinnedHostHydratedRef.current = true;
 				});
 				return () => {
@@ -2980,7 +3129,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 										top: box.top
 									}, { immediate: true });
 								},
-								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconFolderClose16, { size: 16 })
+								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 })
 							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 								className: "dcu-wb-project-title",
@@ -3592,6 +3741,11 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			};
 			const treeRef = (0, react.useRef)(null);
 			useSectionDisclosureMotion(treeRef);
+			const sorting = workspaceDragId !== void 0 || workspaceGroupDragId !== void 0 || sessionDrag !== void 0;
+			(0, react.useLayoutEffect)(() => {
+				if (!wide || !sorting || treeRef.current === null) return;
+				return mountWorkspaceDropIndicator(treeRef.current);
+			}, [wide, sorting]);
 			if (!wide) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 				className: "dcu-wb dcu-wb-rail",
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("style", { children: stylesheet$4 })
@@ -3606,6 +3760,11 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 						typographyStyles,
 						collectionLayoutStyles
 					] }),
+					preferencesFailure !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "dcu-wb-error",
+						role: "status",
+						children: [t("workspace.preferencesLocalOnly"), businessRequestErrorKey(preferencesFailure) !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [" ", userErrorText(preferencesFailure, t)] })]
+					}),
 					error !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 						className: "dcu-wb-error",
 						role: "alert",
@@ -5098,15 +5257,18 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			const next = `${width}px ${tracks.middle} ${tracks.details}px`;
 			const changed = frame.style.gridTemplateColumns !== next;
 			if (changed) frame.style.gridTemplateColumns = next;
+			const contentWidth = `${width}px`;
+			if (frame.style.getPropertyValue("--dcu-sidebar-expanded-width") !== contentWidth) frame.style.setProperty("--dcu-sidebar-expanded-width", contentWidth);
 			const handle = frame.querySelector("[data-side=\"sidebar\"]");
-			if (handle !== null) handle.style.left = `${width}px`;
+			if (handle !== null && handle.style.left !== contentWidth) handle.style.left = contentWidth;
 			return changed;
 		}
 		function applySlimSidebar(frame) {
 			if (frame.hasAttribute("data-dragging")) return false;
 			if (parseSidebarGrid(frame.style.gridTemplateColumns) === void 0 || frame.hasAttribute("data-sidebar-collapsed")) return false;
-			const changed = applySidebarWidth(frame, frame.hasAttribute("data-dcu-codex-sidebar-initialized") ? visibleSidebarWidths.get(frame) ?? 240 : 240);
-			frame.setAttribute("data-dcu-codex-sidebar-initialized", "");
+			const initialized = frame.hasAttribute("data-dcu-codex-sidebar-initialized");
+			const changed = applySidebarWidth(frame, initialized ? visibleSidebarWidths.get(frame) ?? 240 : 240);
+			if (!initialized) frame.setAttribute("data-dcu-codex-sidebar-initialized", "");
 			return changed;
 		}
 		/** 仅在首帧覆盖宿主默认宽度时关闭过渡，避免刷新出现收缩动画。 */
@@ -5132,7 +5294,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 				frameObserver?.disconnect();
 				frame = next;
 				if (frame === void 0) return;
-				frameObserver = new MutationObserver(schedule);
+				frameObserver = new MutationObserver(apply);
 				frameObserver.observe(frame, {
 					attributes: true,
 					attributeFilter: [
@@ -5232,7 +5394,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 		//#region src/client/CodexSidebar.tsx
 		const subscribeEmptyCompanionTabs = () => () => {};
 		const getEmptyCompanionTabs = () => EMPTY_COMPANION_TABS;
-		const SIDEBAR_COLLAPSE_SETTLE_MS = 140;
+		const SIDEBAR_COLLAPSE_SETTLE_MS = 500;
 		const SIDEBAR_EXPANSION_STORAGE_KEY = "dsh-codex-ui.sidebar-expansion.v1";
 		const EXTENSIONS_EXPANSION_KEY = "extensions";
 		function readExtensionsOpen() {
@@ -5251,14 +5413,14 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 /* 滤镜只作用于背景，避免为设置和搜索等 fixed 后代创建侧栏包含块。 */
 body[data-we-sidebar-glass] .dcu-root{position:relative;background:transparent}body[data-we-sidebar-glass] .dcu-root::before{content:"";position:absolute;inset:0;z-index:0;pointer-events:none;background-color:color-mix(in srgb,var(--we-sidebar-color,#fff) calc(var(--we-sidebar-alpha,.15)*.66*100%),transparent);background-image:linear-gradient(180deg,rgba(255,255,255,calc(var(--we-sidebar-sheen,1)*.14)),rgba(255,255,255,calc(var(--we-sidebar-sheen,1)*.04)) 38%,rgba(255,255,255,calc(var(--we-sidebar-sheen,1)*.01)));-webkit-backdrop-filter:blur(var(--we-sidebar-blur,16px)) saturate(var(--we-sidebar-saturate,1.8)) brightness(var(--we-glass-brightness,1.04)) contrast(1.01);backdrop-filter:blur(var(--we-sidebar-blur,16px)) saturate(var(--we-sidebar-saturate,1.8)) brightness(var(--we-glass-brightness,1.04)) contrast(1.01);box-shadow:inset 0 1px 0 rgba(255,255,255,calc(var(--we-sidebar-sheen,1)*.32)),inset 0 -1px 0 rgba(255,255,255,calc(var(--we-sidebar-sheen,1)*.08)),inset 0 0 0 .5px rgba(255,255,255,calc(var(--we-sidebar-sheen,1)*.06))}body[data-ds-dark-theme][data-we-sidebar-glass] .dcu-root::before{background-color:color-mix(in srgb,var(--we-sidebar-color,#fff) calc(var(--we-sidebar-alpha,.15)*.33*100%),transparent)}body[data-we-appwindow][data-we-sidebar-glass] .dcu-root::before{-webkit-backdrop-filter:none;backdrop-filter:none}@supports not ((backdrop-filter:blur(1px)) or (-webkit-backdrop-filter:blur(1px))){body[data-we-sidebar-glass] .dcu-root{background:#eef7f5}body[data-ds-dark-theme][data-we-sidebar-glass] .dcu-root{background:#1d2120}body[data-we-sidebar-glass] .dcu-root::before{display:none}}
 body[data-we-sidebar-glass] .dcu-expanded-shell,body[data-we-sidebar-glass] .dcu-compact-shell,body[data-we-sidebar-glass] .dcu-foot{position:relative}
-.dcu-expanded-shell{display:flex;width:100%;min-height:0;flex:1 1 0;overflow:hidden;flex-direction:column;transform-origin:left center;transition:opacity 140ms ease-out,transform 180ms cubic-bezier(.16,1,.3,1);animation:dcu-sidebar-expanded-in 180ms cubic-bezier(.16,1,.3,1)}.dcu-compact-shell{display:none;width:56px}.dcu-root.dcu-collapsing .dcu-expanded-shell{opacity:0;transform:translateX(-6px);pointer-events:none}.dcu-root.dcu-compact .dcu-expanded-shell{display:none}.dcu-root.dcu-compact .dcu-compact-shell{display:flex;min-height:0;flex:1;flex-direction:column;align-items:center;animation:dcu-sidebar-compact-in 140ms ease-out}@keyframes dcu-sidebar-expanded-in{from{opacity:0;transform:translateX(-6px)}to{opacity:1;transform:none}}@keyframes dcu-sidebar-compact-in{from{opacity:0;transform:translateX(-4px)}to{opacity:1;transform:none}}
+.dcu-expanded-shell{display:flex;width:100%;min-height:0;flex:1 1 0;overflow:hidden;flex-direction:column;transform-origin:left center;transition:opacity 500ms cubic-bezier(.16,1,.3,1),transform 500ms cubic-bezier(.16,1,.3,1);animation:dcu-sidebar-expanded-in 500ms cubic-bezier(.16,1,.3,1)}.dcu-compact-shell{display:none;width:56px}.dcu-root.dcu-collapsing .dcu-expanded-shell{opacity:0;transform:translateX(-6px);pointer-events:none}.dcu-root.dcu-compact .dcu-expanded-shell{display:none}.dcu-root.dcu-compact .dcu-compact-shell{display:flex;min-height:0;flex:1;flex-direction:column;align-items:center;animation:dcu-sidebar-compact-in 140ms ease-out}@keyframes dcu-sidebar-expanded-in{from{opacity:0;transform:translateX(-6px)}to{opacity:1;transform:none}}@keyframes dcu-sidebar-compact-in{from{opacity:0;transform:translateX(-4px)}to{opacity:1;transform:none}}
 .dcu-root *{box-sizing:border-box}.dcu-head{display:grid;grid-template-columns:minmax(0,1fr) auto;align-items:center;column-gap:8px;height:60px;padding:8px 8px 8px 12px}.dcu-brand{border:0;background:transparent;color:inherit;padding:0;display:flex;align-items:center;min-width:0;overflow:hidden}.dcu-brand svg{display:block;width:auto;max-width:100%;height:24px;min-width:0}.dcu-head-actions{display:grid;grid-auto-flow:column;grid-auto-columns:28px;align-items:center;column-gap:8px;height:28px}
 .dcu-icon,.dcu-menu button,.dcu-footer-link{appearance:none;border:0;background:transparent;color:inherit;font:inherit;cursor:pointer}.dcu-icon{display:grid;place-items:center;width:36px;height:36px;border-radius:8px;color:var(--dcu-sidebar-icon)}.dcu-head .dcu-icon{display:inline-flex;align-items:center;justify-content:center;width:28px;height:28px;margin:0;padding:0;border-radius:50%;line-height:0}.dcu-head .dcu-icon svg{display:block;width:16px;height:16px}
 .dcu-icon:hover,.dcu-menu button:hover:not(:disabled),.dcu-footer-link:hover{background:var(--dcu-sidebar-hover);color:var(--dcu-sidebar-primary)}
 .dcu-menu{padding:0 6px 8px;display:grid;gap:2px}.dcu-menu button,.dcu-footer-link{display:grid;grid-template-columns:20px minmax(0,1fr);column-gap:8px;align-items:center;width:100%;min-height:36px;padding:0 4px;border-radius:8px;color:var(--dcu-sidebar-navigation);font-size:14px;line-height:20px;text-align:left;font-weight:400}
 .dcu-menu-icon{display:grid;place-items:center start;width:20px;height:20px}.dcu-menu-icon svg,.dcu-footer-link svg{display:block;width:16px;height:16px;color:var(--dcu-sidebar-icon)}.dcu-menu button:disabled{color:var(--dcu-sidebar-secondary);cursor:default;opacity:1}.dcu-menu button:disabled svg{color:var(--dcu-sidebar-secondary)}
 .dcu-extensions-group{display:grid}.dcu-extension-leading{position:relative;display:block;width:16px;height:16px}.dcu-extension-leading svg{position:absolute;inset:0;transition:opacity 140ms ease-out,transform 220ms cubic-bezier(.16,1,.3,1)}.dcu-extension-default-icon{opacity:1}.dcu-extension-state-arrow{opacity:0;transform:rotate(0)}.dcu-extensions-group:hover .dcu-extension-default-icon,.dcu-extensions-toggle:focus-visible .dcu-extension-default-icon{opacity:0}.dcu-extensions-group:hover .dcu-extension-state-arrow,.dcu-extensions-toggle:focus-visible .dcu-extension-state-arrow{opacity:1}.dcu-extensions-toggle[aria-expanded=true] .dcu-extension-state-arrow{transform:rotate(90deg)}.dcu-extension-panel{display:grid;grid-template-rows:1fr;opacity:1;transition:grid-template-rows 220ms cubic-bezier(.16,1,.3,1),opacity 160ms ease-out}.dcu-extension-panel[data-open=false]{grid-template-rows:0fr;opacity:0;pointer-events:none}.dcu-extension-panel-inner{position:relative;min-height:0;overflow:hidden}.dcu-extension-items{position:relative;display:grid;gap:1px;margin:1px 0 4px 28px}.dcu-extension-items::before{content:"";position:absolute;left:-16px;top:0;bottom:4px;width:1px;background:var(--dcu-sidebar-border)}.dcu-extension-items button{grid-template-columns:minmax(0,1fr);min-height:32px;color:var(--dcu-sidebar-secondary);font-size:13px;font-weight:400}.dcu-extension-items .dcu-menu-icon{display:none}
-.dcu-workspaces{display:flex;min-height:0;flex:1;flex-direction:column;margin-top:2px;padding-top:8px;border-top:1px solid var(--dcu-sidebar-border)}.dcu-workspaces.dcu-workspaces-tabs{padding-top:0;border-top:0}.dcu-im-tabs{display:flex;gap:16px;margin:0 8px 12px;padding:0;border-bottom:1px solid var(--dcu-sidebar-border)}.dcu-im-tab{appearance:none;border:0;background:transparent;color:var(--dcu-sidebar-secondary);padding:8px 0 7px;font:14px/22px var(--dcu-font);font-weight:500;cursor:pointer}.dcu-im-tab[data-on=true]{color:var(--dcu-sidebar-primary);font-weight:600;box-shadow:inset 0 -2px 0 currentColor}.dcu-native-workspaces{display:flex;min-height:0;flex:1}.dcu-native-workspaces>*{min-width:0;flex:1}.dcu-native-workspaces .ima-tabs,.dcu-native-workspaces [role=tablist]{display:none!important}.dcu-schedule-browser{display:flex;min-height:0;flex:1;flex-direction:column}.dcu-native-workspaces .dcu-schedule-views{display:flex!important;flex:none;min-height:30px;margin:0 8px 8px;padding:2px;border:1px solid var(--dcu-sidebar-border);border-radius:8px;background:rgba(255,255,255,.025)}.dcu-schedule-views button{appearance:none;flex:1;min-width:0;height:24px;border:0;border-radius:6px;background:transparent;color:var(--dcu-sidebar-secondary);font:600 12px/18px var(--dcu-font);cursor:pointer}.dcu-schedule-views button[aria-selected=true]{background:var(--dcu-sidebar-hover);color:var(--dcu-sidebar-primary);box-shadow:inset 0 0 0 1px var(--dcu-sidebar-border)}.dcu-schedule-pane{display:flex;min-height:0;flex:1}.dcu-schedule-pane>*{min-width:0;flex:1}.dcu-schedule-pane>[data-slot="sidebar.schedule"]{display:flex!important;width:100%;min-width:0;flex:1}.dcu-schedule-pane>[data-slot="sidebar.schedule"]>.dsh-st-rail{width:100%;min-width:0;padding-right:8px;scrollbar-gutter:auto}.dcu-schedule-pane .dsh-st-overview{padding-right:8px}.dcu-foot{display:grid;width:100%;gap:4px;padding:8px 6px 12px;border-top:1px solid var(--dcu-sidebar-border);transition:opacity 120ms ease-out,transform 160ms cubic-bezier(.16,1,.3,1)}.dcu-root.dcu-collapsing>.dcu-foot{opacity:0;transform:translateX(-4px);pointer-events:none}.dcu-footer-actions:empty,.dcu-settings-seat:empty{display:none}.dcu-settings-seat>button{width:100%;min-height:36px;padding-left:4px!important;color:var(--dcu-sidebar-navigation);font:14px/20px var(--dcu-font);font-weight:400}.dcu-compact{width:100%;align-items:flex-start;overflow:hidden;padding:10px 0 8px}.dcu-compact-nav{display:flex;flex:1;min-height:0;flex-direction:column;align-items:center;gap:2px;overflow:auto;padding:6px 0}.dcu-compact .dcu-icon{width:36px;height:36px;flex:none}.dcu-compact .dcu-foot{width:36px;margin-top:auto;margin-left:10px;padding:8px 0;border-top:0}.dcu-compact .dcu-settings-seat{width:36px;overflow:hidden}.dcu-compact .dcu-settings-seat>button{display:grid;place-items:center;width:36px;min-height:36px;padding:0!important;font-size:0!important;line-height:0}.dcu-compact .dcu-settings-seat>button svg{width:16px;height:16px}.dcu-compact .dcu-footer-link{display:flex;justify-content:center;width:36px;padding:0;font-size:0}.dcu-compact .dcu-footer-link svg{width:16px;height:16px}
+.dcu-workspaces{display:flex;min-height:0;flex:1;flex-direction:column;margin-top:2px;padding-top:8px;border-top:1px solid var(--dcu-sidebar-border)}.dcu-workspaces.dcu-workspaces-tabs{padding-top:0;border-top:0}.dcu-im-tabs{display:flex;gap:16px;margin:0 8px 12px;padding:0;border-bottom:1px solid var(--dcu-sidebar-border)}.dcu-im-tab{appearance:none;border:0;background:transparent;color:var(--dcu-sidebar-secondary);padding:8px 0 7px;font:14px/22px var(--dcu-font);font-weight:500;cursor:pointer}.dcu-im-tab[data-on=true]{color:var(--dcu-sidebar-primary);font-weight:600;box-shadow:inset 0 -2px 0 currentColor}.dcu-native-workspaces{display:flex;min-height:0;flex:1}.dcu-native-workspaces>*{min-width:0;flex:1}.dcu-native-workspaces .ima-tabs,.dcu-native-workspaces [role=tablist]{display:none!important}.dcu-schedule-browser{display:flex;min-height:0;flex:1;flex-direction:column}.dcu-native-workspaces .dcu-schedule-views{display:flex!important;flex:none;min-height:30px;margin:0 8px 8px;padding:2px;border:1px solid var(--dcu-sidebar-border);border-radius:8px;background:rgba(255,255,255,.025)}.dcu-schedule-views button{appearance:none;flex:1;min-width:0;height:24px;border:0;border-radius:6px;background:transparent;color:var(--dcu-sidebar-secondary);font:600 12px/18px var(--dcu-font);cursor:pointer}.dcu-schedule-views button[aria-selected=true]{background:var(--dcu-sidebar-hover);color:var(--dcu-sidebar-primary);box-shadow:inset 0 0 0 1px var(--dcu-sidebar-border)}.dcu-schedule-pane{display:flex;min-height:0;flex:1}.dcu-schedule-pane>*{min-width:0;flex:1}.dcu-schedule-pane>[data-slot="sidebar.schedule"]{display:flex!important;width:100%;min-width:0;flex:1}.dcu-schedule-pane>[data-slot="sidebar.schedule"]>.dsh-st-rail{width:100%;min-width:0;padding-right:8px;scrollbar-gutter:auto}.dcu-schedule-pane .dsh-st-overview{padding-right:8px}.dcu-foot{display:grid;width:100%;gap:4px;padding:8px 6px 12px;border-top:1px solid var(--dcu-sidebar-border);transition:opacity 500ms cubic-bezier(.16,1,.3,1),transform 500ms cubic-bezier(.16,1,.3,1)}.dcu-root.dcu-collapsing>.dcu-foot{opacity:0;transform:translateX(-4px);pointer-events:none}.dcu-footer-actions:empty,.dcu-settings-seat:empty{display:none}.dcu-settings-seat>button{width:100%;min-height:36px;padding-left:4px!important;color:var(--dcu-sidebar-navigation);font:14px/20px var(--dcu-font);font-weight:400}.dcu-compact{width:100%;align-items:flex-start;overflow:hidden;padding:10px 0 8px}.dcu-compact-nav{display:flex;flex:1;min-height:0;flex-direction:column;align-items:center;gap:2px;overflow:auto;padding:6px 0}.dcu-compact .dcu-icon{width:36px;height:36px;flex:none}.dcu-compact .dcu-foot{width:36px;margin-top:auto;margin-left:10px;padding:8px 0;border-top:0}.dcu-compact .dcu-settings-seat{width:36px;overflow:hidden}.dcu-compact .dcu-settings-seat>button{display:grid;place-items:center;width:36px;min-height:36px;padding:0!important;font-size:0!important;line-height:0}.dcu-compact .dcu-settings-seat>button svg{width:16px;height:16px}.dcu-compact .dcu-footer-link{display:flex;justify-content:center;width:36px;padding:0;font-size:0}.dcu-compact .dcu-footer-link svg{width:16px;height:16px}
 /* 仅适配费用插件入口；通过标记及入口结构定位，保留原生统计、浮层和容器查询。 */
 .dcu-footer-actions [data-testid="billing-trigger"]{box-sizing:border-box;width:100%;min-width:0;min-height:52px;padding:8px 6px;gap:8px;border:0;border-radius:6px;background:transparent;color:var(--dcu-sidebar-primary);font-family:var(--dcu-font);box-shadow:none;transform:none;transition:background-color 120ms ease-out,color 120ms ease-out}
 .dcu-footer-actions :is([data-testid="billing-trigger"],[data-testid="billing-rail-button"]):hover{border-color:transparent;background:var(--dcu-sidebar-hover);box-shadow:none;transform:none}
@@ -5278,7 +5440,21 @@ body[data-we-sidebar-glass] .dcu-expanded-shell,body[data-we-sidebar-glass] .dcu
 .dcu-settings-seat [data-slot="settings.trigger"]>svg{color:var(--dcu-sidebar-icon)}
 .dcu-root:not(.dcu-compact) .dcu-settings-seat [data-slot="settings.trigger"]>span{margin-left:4px}
 @media (prefers-reduced-motion:reduce){.dcu-footer-actions :is([data-testid="billing-trigger"],[data-testid="billing-rail-button"]){transition:none}}
-.dcu-expanded-shell,.dcu-foot{width:100%}
+/* 宿主列负责缩放，宽态内容保持展开宽度，避免中文竖排与工作区逐帧重排。 */
+.dcu-expanded-shell,.dcu-root:not(.dcu-compact)>.dcu-foot{width:var(--dcu-sidebar-expanded-width,240px);flex-shrink:0}
+/* 对齐 Codex 的半秒布局节奏；显式声明避免依赖宿主主题的动画 token。 */
+.dcu-root{position:relative}
+.dcu-root.dcu-collapsing .dcu-compact-shell{position:absolute;left:0;top:10px;bottom:8px;display:flex;flex-direction:column;align-items:center;animation:dcu-sidebar-compact-in 500ms cubic-bezier(.16,1,.3,1)}
+.dcu-root.dcu-collapsing .dcu-compact-shell .dcu-icon{width:36px;height:36px;flex:none}
+/* 收尾仅移除宽态层，窄轨不重复淡入，否则会在半秒处闪烁。 */
+.dcu-root.dcu-compact .dcu-compact-shell{animation:none}
+[data-dcu-codex-sidebar-initialized]{transition:grid-template-columns 500ms cubic-bezier(.16,1,.3,1)}
+/* dsh-better-sidebar 的 #root 布局规则会覆盖 transition 简写；合并两侧过渡而非只争抢左栏。 */
+#root [data-dcu-codex-sidebar-initialized]:not([data-dragging]){transition:grid-template-columns 500ms cubic-bezier(.16,1,.3,1),padding-right var(--ds-transition-duration-slow,.3s) var(--ds-ease-in-out,cubic-bezier(.4,0,.2,1))}
+#root [data-dcu-codex-sidebar-initialized][data-dragging]{transition:none}
+[data-dcu-codex-sidebar-initialized] [data-side="sidebar"]{transition:left 500ms cubic-bezier(.16,1,.3,1)}
+[data-dcu-codex-sidebar-initialized][data-dragging],[data-dcu-codex-sidebar-initialized][data-dragging] [data-side="sidebar"]{transition:none}
+@media (prefers-reduced-motion:reduce){[data-dcu-codex-sidebar-initialized],[data-dcu-codex-sidebar-initialized] [data-side="sidebar"],#root [data-dcu-codex-sidebar-initialized]:not([data-dragging]){transition:none}.dcu-root.dcu-collapsing .dcu-compact-shell{animation:none}}
 .dcu-native-workspaces{flex-direction:column}.dcu-native-workspaces>[data-mcp-connector-top-mount=true]{flex:none}.dcu-root .mcpConnectorLauncher,.dcu-root [data-mcp-connector-top-mount=true]{display:none!important}
 .dcu-dependency-notice{margin:0 10px 8px;border:1px solid var(--dcu-sidebar-border);border-radius:8px;padding:8px;color:var(--dcu-sidebar-secondary);font-size:12px;line-height:18px}
 [role="dialog"][aria-labelledby]{width:min(1000px,calc(100vw - 48px));max-width:calc(100vw - 48px);height:min(800px,calc(100vh - 48px))}
@@ -6139,7 +6315,7 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 			"linking",
 			"building"
 		]);
-		const endpoint = "/api/michengai/codex-ui/dependencies";
+		const endpoint = CODEX_UI_API_ENDPOINTS.dependencies;
 		const stylesheet$2 = `
 .dcu-about{color:var(--dsw-alias-label-primary)}.dcu-about h2{margin:0;font-size:20px;line-height:28px}.dcu-about-intro{margin:6px 0 22px;color:var(--dsw-alias-label-secondary);font-size:13px;line-height:20px}.dcu-about h3{margin:24px 0 8px;font-size:14px;line-height:20px}.dcu-about-features{margin:0;padding-left:20px;color:var(--dsw-alias-label-secondary);font-size:13px;line-height:24px}.dcu-about-dependencies-heading{display:flex;align-items:center;justify-content:space-between;gap:12px;margin-top:24px}.dcu-about-dependencies-heading h3{margin:0}.dcu-about-dependencies-heading+.dcu-about-intro{margin-bottom:14px}.dcu-about-dependencies{overflow:hidden;border:1px solid var(--dsw-alias-border-l2);border-radius:10px}.dcu-about-dependency{display:flex;align-items:center;gap:12px;min-height:64px;padding:12px;border-bottom:1px solid var(--dsw-alias-border-l2)}.dcu-about-dependency:last-child{border-bottom:0}.dcu-about-copy{min-width:0;flex:1}.dcu-about-name{font-size:13px;line-height:20px;font-weight:600}.dcu-about-package{overflow:hidden;margin-top:2px;color:var(--dsw-alias-label-tertiary);font-size:12px;text-overflow:ellipsis;white-space:nowrap}.dcu-about-status{display:flex;align-items:center;gap:5px;font-size:12px}.dcu-about-status[data-installed=true]{color:var(--dsw-alias-state-success-primary)}.dcu-about-status[data-installed=false]{color:var(--dsw-alias-state-error-primary)}.dcu-about-status[data-update=true]{color:var(--dsw-alias-state-warning-primary)}.dcu-about-install{display:inline-flex;align-items:center;justify-content:center;gap:5px;min-height:32px;border:1px solid var(--dsw-alias-border-l2);border-radius:7px;padding:6px 9px;background:transparent;color:var(--dsw-alias-label-primary);font:inherit;font-size:12px;cursor:pointer}.dcu-about-install:hover:not(:disabled){background:var(--dsw-specific-menu-item-hover)}.dcu-about-install:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px}.dcu-about-install:disabled{cursor:wait;opacity:.65}.dcu-about-update-all{min-width:92px}.dcu-about-message{margin:10px 0 0;border-radius:8px;padding:9px 10px;background:color-mix(in srgb,var(--dsw-alias-state-business-primary) 12%,transparent);color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px}.dcu-about-message[data-error=true]{background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 12%,transparent);color:var(--dsw-alias-state-error-primary)}.dcu-about-progress{display:grid;grid-template-columns:auto 1fr auto;gap:8px 10px;align-items:center;margin-top:10px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:9px 10px}.dcu-about-progress code{min-width:0;color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.dcu-about-progress-pct{color:var(--dsw-alias-label-tertiary);font-size:12px;font-variant-numeric:tabular-nums}.dcu-about-progress-bar{grid-column:1/-1;height:4px;overflow:hidden;border-radius:99px;background:var(--dsw-alias-border-l2)}.dcu-about-progress-fill{height:100%;background:var(--dsw-alias-state-business-primary);transition:width .2s ease}.dcu-about-progress-fill[data-wave=true]{width:28%;animation:dcu-about-progress-wave 1.2s ease-in-out infinite}@keyframes dcu-about-progress-wave{0%{transform:translateX(-60%)}100%{transform:translateX(280%)}}
 .dcu-about-title-row{display:flex;align-items:center;gap:8px;min-width:0}.dcu-about-links{display:flex;align-items:center;gap:4px}.dcu-about-external-link{display:inline-flex;align-items:center;gap:5px;min-height:28px;padding:0 8px;color:var(--dsw-alias-label-secondary);background:transparent;border:1px solid var(--dsw-alias-border-l2);border-radius:7px;font-size:12px;font-weight:500;line-height:18px;text-decoration:none;white-space:nowrap}.dcu-about-external-link:hover{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-interactive-bg-hover)}.dcu-about-external-link:focus-visible{outline:2px solid var(--dsw-alias-state-success-primary);outline-offset:2px}.dcu-about-external-link svg{flex:none}@media(max-width:720px){.dcu-about-title-row{flex-wrap:wrap}}
@@ -6190,6 +6366,7 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 			const [progress, setProgress] = (0, react.useState)();
 			const [message, setMessage] = (0, react.useState)();
 			const [refreshFailed, setRefreshFailed] = (0, react.useState)(false);
+			const [loadFailure, setLoadFailure] = (0, react.useState)();
 			const alive = (0, react.useRef)(true);
 			const root = (0, react.useRef)(null);
 			const stateRef = (0, react.useRef)("loading");
@@ -6210,14 +6387,17 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 						cache: "no-store",
 						signal
 					});
+					if (!response.ok) throw new BusinessRequestError(response.status);
 					const payload = await response.json();
 					if (signal?.aborted || currentRequest !== requestId.current) return;
-					if (!response.ok || !Array.isArray(payload.dependencies) || !payload.dependencies.every(isDependencyStatus)) throw new Error();
+					if (!Array.isArray(payload.dependencies) || !payload.dependencies.every(isDependencyStatus)) throw new Error();
 					setDependencies(payload.dependencies);
 					setState("ready");
 					setRefreshFailed(false);
+					setLoadFailure(void 0);
 				} catch (error) {
 					if (signal?.aborted || error instanceof DOMException && error.name === "AbortError" || currentRequest !== requestId.current) return;
+					setLoadFailure(error);
 					if (stateRef.current === "ready") setRefreshFailed(true);
 					else setState("failed");
 				}
@@ -6282,6 +6462,11 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 				setMessage(void 0);
 				try {
 					const response = await fetch(`${endpoint}?dependency=${encodeURIComponent(id)}`, { method: "POST" });
+					if ([
+						401,
+						403,
+						503
+					].includes(response.status)) throw new BusinessRequestError(response.status);
 					const payload = await response.json();
 					if (!response.ok || !Array.isArray(payload.dependencies) || !payload.dependencies.every(isDependencyStatus)) throw new Error(typeof payload.error === "string" ? payload.error : t("about.installFailed"));
 					if (!alive.current) return;
@@ -6310,6 +6495,11 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 				setMessage(void 0);
 				try {
 					const response = await fetch(`${endpoint}?action=update-all`, { method: "POST" });
+					if ([
+						401,
+						403,
+						503
+					].includes(response.status)) throw new BusinessRequestError(response.status);
 					const payload = await response.json();
 					if (!response.ok || !Array.isArray(payload.dependencies) || !payload.dependencies.every(isDependencyStatus)) throw new Error(typeof payload.error === "string" ? payload.error : t("about.installFailed"));
 					if (!alive.current) return;
@@ -6405,7 +6595,7 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 						className: "dcu-about-message",
 						"data-error": "true",
 						role: "alert",
-						children: t("about.statusFailed")
+						children: t(businessRequestErrorKey(loadFailure) ?? "about.statusFailed")
 					}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 						className: "dcu-about-dependencies",
 						"aria-busy": installing !== void 0,
@@ -6468,7 +6658,7 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 						className: "dcu-about-message",
 						"data-error": "true",
 						role: "status",
-						children: t("about.refreshFailed")
+						children: t(businessRequestErrorKey(loadFailure) ?? "about.refreshFailed")
 					}),
 					message !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 						className: "dcu-about-message",
@@ -6560,6 +6750,7 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 			const sessionId = (0, react.useSyncExternalStore)(sessionStore.subscribe, () => sessionStore.getSnapshot().current);
 			const [connectors, setConnectors] = (0, react.useState)([]);
 			const [state, setState] = (0, react.useState)("loading");
+			const [failure, setFailure] = (0, react.useState)();
 			(0, react.useEffect)(() => {
 				if (sessionId === void 0) {
 					setConnectors([]);
@@ -6568,15 +6759,18 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 				}
 				const controller = new AbortController();
 				setState("loading");
-				fetch(`/api/michengai/codex-ui/connectors?sessionId=${encodeURIComponent(sessionId)}`, { signal: controller.signal }).then(async (response) => {
-					if (!response.ok) throw new Error("连接器目录暂不可用。");
+				fetch(`${CODEX_UI_API_ENDPOINTS.connectors}?sessionId=${encodeURIComponent(sessionId)}`, { signal: controller.signal }).then(async (response) => {
+					if (!response.ok) throw new BusinessRequestError(response.status);
 					const payload = await response.json();
 					if (!Array.isArray(payload.connectors) || !payload.connectors.every(isConnector)) throw new Error("连接器目录返回格式无效。");
 					if (!controller.signal.aborted) setConnectors(payload.connectors);
 				}).then(() => {
 					if (!controller.signal.aborted) setState("ready");
-				}).catch(() => {
-					if (!controller.signal.aborted) setState("failed");
+				}).catch((error) => {
+					if (!controller.signal.aborted) {
+						setFailure(error);
+						setState("failed");
+					}
 				});
 				return () => {
 					controller.abort();
@@ -6592,7 +6786,8 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 			});
 			if (state === "failed") return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 				className: "dcu-connector-empty",
-				children: t("connectors.failed")
+				role: "alert",
+				children: t(businessRequestErrorKey(failure) ?? "connectors.failed")
 			});
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "dcu-connector-list",
@@ -6722,7 +6917,7 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 			"workspace.renameGroup": "重命名分组",
 			"workspace.recent": "最近",
 			"workspace.recentEmpty": "无聊天",
-			"workspace.noChat": "没有聊天",
+			"workspace.noChat": "暂无聊天",
 			"workspace.empty": "暂无项目",
 			"workspace.newSession": "新建会话",
 			"workspace.rename": "重命名项目",
@@ -6770,6 +6965,8 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 			"sessions.openPath": "在资源管理器中打开",
 			"sessions.moveWorkspace": "项目",
 			"sessions.moveUnavailable": "会话移动服务暂不可用，请重启 DSH 后重试。",
+			"sessions.moveUnauthorized": "登录状态已失效，请刷新页面并重新登录。",
+			"sessions.moveForbidden": "当前访问地址不受信任，或请求来源已被拒绝。",
 			"sessions.moveNotFound": "会话或目标项目已不存在，请刷新后重试。",
 			"sessions.moveSubagent": "子代理会话不能移动到其他项目。",
 			"sessions.moveBusy": "该会话正在移动，请稍后重试。",
@@ -6859,6 +7056,10 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 			"time.minutes": "{count}分",
 			"time.hours": "{count}小时",
 			"time.days": "{count}天",
+			"errors.unauthorized": "请先登录 DSH，再重试。",
+			"errors.forbidden": "请求被安全检查拒绝，请从可信的 DSH 地址重试。",
+			"errors.serviceUnavailable": "服务暂不可用，请稍后重试。",
+			"workspace.preferencesLocalOnly": "项目偏好尚未同步，当前使用本地缓存。",
 			"errors.generic": "操作未完成，请重试。",
 			"errors.groupInvalid": "分组信息无效。",
 			"errors.workspaceInvalid": "项目标识无效。",
@@ -6976,6 +7177,8 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 			"sessions.openPath": "Open in file explorer",
 			"sessions.moveWorkspace": "Project",
 			"sessions.moveUnavailable": "Conversation moving is unavailable. Restart DSH and try again.",
+			"sessions.moveUnauthorized": "Your login session has expired. Refresh the page and sign in again.",
+			"sessions.moveForbidden": "The current address is not trusted, or the request origin was rejected.",
 			"sessions.moveNotFound": "The conversation or target project no longer exists. Refresh and try again.",
 			"sessions.moveSubagent": "Subagent conversations cannot be moved to another project.",
 			"sessions.moveBusy": "This conversation is already being moved. Try again shortly.",
@@ -7065,6 +7268,10 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 			"time.minutes": "{count}m",
 			"time.hours": "{count}h",
 			"time.days": "{count}d",
+			"errors.unauthorized": "Sign in to DSH, then try again.",
+			"errors.forbidden": "The security check rejected this request. Try again from a trusted DSH address.",
+			"errors.serviceUnavailable": "The service is unavailable. Try again later.",
+			"workspace.preferencesLocalOnly": "Workspace preferences are not synced. Using the local cache.",
 			"errors.generic": "The action could not be completed. Try again.",
 			"errors.groupInvalid": "The group information is invalid.",
 			"errors.workspaceInvalid": "The project identifier is invalid.",
@@ -7074,7 +7281,7 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 		};
 		//#endregion
 		//#region src/client/host-open-path.ts
-		const OPEN_IN_EXPLORER_ENDPOINT = "/api/michengai/codex-ui/open-in-explorer";
+		const OPEN_IN_EXPLORER_ENDPOINT = CODEX_UI_API_ENDPOINTS.openInExplorer;
 		/** “在资源管理器中打开”属于明确的系统动作，不应被侧边栏文件预览器接管。 */
 		async function openPathInHost(connection, path, fetcher = fetch) {
 			let foregroundResponse;
@@ -7086,6 +7293,11 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 				});
 			} catch {}
 			if (foregroundResponse?.ok) return;
+			if (foregroundResponse !== void 0 && [
+				401,
+				403,
+				503
+			].includes(foregroundResponse.status)) throw new BusinessRequestError(foregroundResponse.status);
 			if (foregroundResponse !== void 0 && foregroundResponse.status !== 404 && foregroundResponse.status !== 501) {
 				const payload = await foregroundResponse.json().catch(() => ({}));
 				throw new Error(typeof payload.error === "string" ? payload.error : "无法在前台打开资源管理器。");
@@ -7326,7 +7538,7 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 		const OFFICIAL_TURN_MARK_ATTRIBUTE = "data-dcu-official-turn-mark";
 		const OFFICIAL_TURN_TOOLTIP_ATTRIBUTE = "data-dcu-official-turn-tooltip";
 		const OFFICIAL_TURN_NAVIGATOR_SUPPORTED_ATTRIBUTE = "data-dcu-official-turn-navigator-supported";
-		const CAPABILITIES_ENDPOINT = "/api/michengai/codex-ui/dependencies?action=capabilities";
+		const CAPABILITIES_ENDPOINT = `${CODEX_UI_API_ENDPOINTS.dependencies}?action=capabilities`;
 		function isOfficialTurnNavigator(element) {
 			return element instanceof HTMLElement && element.tagName === "NAV" && element.style.getPropertyValue("--turn-natural-height") !== "" && element.querySelector("button[type=\"button\"][aria-label]") !== null;
 		}

package/lib/index.d.mts

@@ -4,16 +4,8 @@ type HostRequest = {
   method?: string;
   url?: string;
   headers?: Record<string, string | string[] | undefined>;
-  socket?: {
-    remoteAddress?: string;
-  };
   [Symbol.asyncIterator]?: () => AsyncIterator<Uint8Array | string>;
 };
-/**
- * 依赖安装会改写用户配置并拉起子进程，只允许回环地址上的同源浏览器请求。
- * Origin、Host 和 Sec-Fetch-Site 都可被非浏览器客户端伪造，不能单独作为授权依据。
- */
-declare function crossSiteRequest(request: HostRequest): boolean;
 /** 把安装错误收成可给浏览器看的文案：我们自己的中文说明保留，带本地路径的底层错误脱敏。 */
 declare function publicDependencyError(error: unknown): string;
 declare class RequestBodyTooLargeError extends Error {}
@@ -23,4 +15,4 @@ declare const inject: string[];
 /** 提供不泄露地址、命令和凭证的连接器目录。 */
 declare function apply(ctx: Context): void;
 //#endregion
-export { RequestBodyTooLargeError, apply, crossSiteRequest, inject, publicDependencyError, readRequestBody };
+export { RequestBodyTooLargeError, apply, inject, publicDependencyError, readRequestBody };