@michengai/dsh-codex-ui 0.2.96 → 0.2.97

package/CHANGELOG.md

@@ -4,6 +4,26 @@
 
 This changelog records recent releases of DSH Codex UI and its one-click installer. Earlier changes remain available in the [Git history](https://github.com/MichengAI/dsh-codex-ui/commits/main).
 
+## 0.2.97 — 2026-09-01
+
+Companion release: `@michengai/dsh-codex-suite-installer@0.1.14`.
+
+### Compatibility
+
+- Adopted the official DSH alpha turn navigator while preserving the legacy navigator on older runtimes, with runtime capability gating and resilient left-side mirroring that no longer depends on private stylesheet names or host DOM nesting.
+- Preserved upstream conversation width dragging, adaptive transcript sizing, and turn navigation while retaining the Codex composer treatment.
+
+### Fixed
+
+- Reworked About-page companion installs with live pnpm progress, accurate Profile mount verification, bulk installation of missing or outdated plugins, stale junction cleanup, and correct Desktop versus standalone Web restart guidance.
+- Hardened pnpm discovery for GUI environments without trusting unrelated package-manager entry points or leaking the inferred entry into later child processes.
+- Added strict progress payload validation and extended slow Desktop bundle reconciliation tolerance.
+- Filtered and frame-coalesced navigator DOM observation so streaming responses do not trigger repeated document-wide scans.
+
+### Dependencies
+
+- Prepared Suite Installer `0.1.14` to resolve the latest exact companion versions after this release is published.
+
 ## 0.2.96 — 2026-09-01
 
 Companion release: `@michengai/dsh-codex-suite-installer@0.1.13`.

package/CHANGELOG.zh-CN.md

@@ -4,6 +4,26 @@
 
 本日志记录 DSH Codex UI 及其一键安装器的最近发布；更早的变更可查看 [Git 提交历史](https://github.com/MichengAI/dsh-codex-ui/commits/main)。
 
+## 0.2.97 — 2026-09-01
+
+配套版本：`@michengai/dsh-codex-suite-installer@0.1.14`。
+
+### 兼容性
+
+- 在新版 DSH 中采用官方轮次导航，并为旧运行时保留自定义导航；通过运行时能力判断和更稳健的左侧镜像，不再依赖私有样式文件名或宿主 DOM 层级。
+- 保留官方会话宽度拖拽、自适应正文宽度与轮次导航，同时继续使用 Codex 风格输入区。
+
+### 修复
+
+- 重构“关于”页配套插件安装：显示 pnpm 实时进度、以实际进入 Profile 为成功标准、批量安装缺失或可更新插件、清理残留 Junction，并正确区分 Desktop 自动重载与独立 Web 手动重启。
+- 强化 GUI 环境下的 pnpm 定位，不再信任其他包管理器入口，也不会把推断出的入口泄漏给后续子进程。
+- 严格校验安装进度数据，并为 Desktop 较慢的 bundles 写入留出更充足的等待时间。
+- 对轮次导航 DOM 监听增加相关变更过滤和逐帧合并，避免流式回答触发反复全文档扫描。
+
+### 依赖
+
+- 准备 Suite Installer `0.1.14`，在本版本发布后解析全部配套插件的最新精确版本。
+
 ## 0.2.96 — 2026-09-01
 
 配套版本：`@michengai/dsh-codex-suite-installer@0.1.13`。

package/dist/client.js

@@ -734,87 +734,12 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/client/conversation-bubbles.ts
-		/** 把 DSH 右侧气泡改成 Codex 的左对齐紧凑卡片，不改会话数据。 */
+		/** 撤回旧版 Codex 用户卡片，恢复 DSH 官方问题气泡。 */
 		const USER_BUBBLE_STYLE_ID = "dcu-user-bubble-style";
-		const USER_BUBBLE_STYLE = `
-[data-conversation-scroll] [data-chat-flow-kind="user"] [data-time-hover-root],
-[data-conversation-scroll] [data-pending-steering][data-time-hover-root]{align-items:flex-start!important}
-[data-conversation-scroll] [data-chat-flow-kind="user"] [data-time-hover-root]>div,
-[data-conversation-scroll] [data-pending-steering][data-time-hover-root]>div{align-items:flex-start!important;max-width:min(640px,100%)!important}
-[data-conversation-scroll] [data-dcu-user-source]{display:none!important}
-[data-conversation-scroll] [data-dcu-user-card],
-[data-conversation-scroll] [data-chat-flow-kind="user"] [data-time-hover-root]>div>[class*="bubble"],
-[data-conversation-scroll] [data-pending-steering][data-time-hover-root]>div>[class*="bubble"]{background:color-mix(in srgb,var(--dsw-specific-bubble,rgba(255,255,255,.08)) 72%,transparent);color:var(--dsw-alias-label-primary,currentColor);border-radius:16px;padding:10px 14px;font-size:14px;line-height:20px;max-width:100%;box-sizing:border-box}
-[data-conversation-scroll] [data-dcu-user-title]{display:block;color:var(--dsw-alias-label-primary,currentColor);font-size:14px;line-height:20px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
-[data-conversation-scroll] [data-dcu-user-sub]{display:block;margin-top:2px;color:var(--dsw-alias-label-tertiary,currentColor);font-size:13px;line-height:18px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
-`;
-		function splitUserCard(text) {
-			const lines = text.split(/\r?\n/).map((line) => line.trim()).filter((line) => line !== "");
-			if (lines.length >= 2) return {
-				title: lines[0] ?? text,
-				sub: lines.slice(1).join(" ")
-			};
-			return { title: text.trim() };
-		}
-		function findPlainBubble(stack) {
-			for (const child of stack.children) {
-				if (!(child instanceof HTMLElement)) continue;
-				if (child.dataset.dcuUserCard !== void 0) continue;
-				if (child.matches("[class*=\"bubble\"]")) return child;
-			}
-		}
-		function isPlainTextBubble(bubble) {
-			return bubble.querySelector("pre,table,img,[class*=\"Json\"]") === null;
-		}
-		/** 撤销某个气泡的替换装饰：删除卡片并恢复原气泡显示。 */
-		function rollbackUserCard(stack) {
-			for (const card of stack.querySelectorAll("[data-dcu-user-card]")) card.remove();
-			for (const source of stack.querySelectorAll("[data-dcu-user-source]")) delete source.dataset.dcuUserSource;
-		}
-		function decorateUserBubbles(root) {
-			const rows = root.querySelectorAll("[data-chat-flow-kind=\"user\"] [data-time-hover-root], [data-pending-steering][data-time-hover-root]");
-			for (const row of rows) {
-				const stack = row.firstElementChild;
-				if (!(stack instanceof HTMLElement)) continue;
-				const bubble = findPlainBubble(stack);
-				if (bubble === void 0 || !isPlainTextBubble(bubble)) {
-					rollbackUserCard(stack);
-					continue;
-				}
-				const text = (bubble.textContent ?? "").replace(/\s+\n/g, "\n").trim();
-				if (text === "") {
-					rollbackUserCard(stack);
-					continue;
-				}
-				bubble.dataset.dcuUserSource = "";
-				let card = stack.querySelector(":scope > [data-dcu-user-card]");
-				if (card === null) {
-					card = bubble.ownerDocument.createElement("div");
-					card.dataset.dcuUserCard = "";
-					bubble.after(card);
-				}
-				if (card.dataset.dcuUserText === text) continue;
-				const parts = splitUserCard(text);
-				const title = bubble.ownerDocument.createElement("span");
-				title.dataset.dcuUserTitle = "";
-				title.textContent = parts.title;
-				card.replaceChildren(title);
-				if (parts.sub !== void 0 && parts.sub !== "") {
-					const sub = bubble.ownerDocument.createElement("span");
-					sub.dataset.dcuUserSub = "";
-					sub.textContent = parts.sub;
-					card.append(sub);
-				}
-				card.dataset.dcuUserText = text;
-			}
-		}
-		function ensureUserBubbleStyle(doc) {
-			if (doc.getElementById("dcu-user-bubble-style") !== null) return;
-			if (doc.head === null) return;
-			const style = doc.createElement("style");
-			style.id = USER_BUBBLE_STYLE_ID;
-			style.textContent = USER_BUBBLE_STYLE;
-			doc.head.append(style);
+		function restoreOfficialUserBubbles(root) {
+			("getElementById" in root ? root : root.ownerDocument)?.getElementById(USER_BUBBLE_STYLE_ID)?.remove();
+			for (const card of root.querySelectorAll("[data-dcu-user-card]")) card.remove();
+			for (const source of root.querySelectorAll("[data-dcu-user-source]")) delete source.dataset.dcuUserSource;
 		}
 		//#endregion
 		//#region src/client/conversation-header.ts
@@ -965,16 +890,16 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			style.textContent = CONVERSATION_HEADER_STYLE;
 			doc.head.append(style);
 		}
-		const CONVERSATION_DECORATION_SELECTOR = "header, [data-conversation-scroll], [data-chat-flow-kind=\"user\"], [data-pending-steering]";
+		const CONVERSATION_DECORATION_SELECTOR = "header";
 		function conversationDecorationMutation(records) {
-			const relevant = (node) => node instanceof Element && (node.matches(CONVERSATION_DECORATION_SELECTOR) || node.closest("header, [data-chat-flow-kind=\"user\"], [data-pending-steering]") !== null || node.querySelector(CONVERSATION_DECORATION_SELECTOR) !== null);
+			const relevant = (node) => node instanceof Element && (node.matches(CONVERSATION_DECORATION_SELECTOR) || node.closest(CONVERSATION_DECORATION_SELECTOR) !== null || node.querySelector(CONVERSATION_DECORATION_SELECTOR) !== null);
 			return records.some((record) => relevant(record.target) || [...record.addedNodes].some(relevant) || [...record.removedNodes].some(relevant));
 		}
-		/** 观察会话顶栏与用户气泡；只对相关子树变更按帧合并，流式回答不会触发全文档扫描。 */
+		/** 观察会话顶栏；只对相关子树变更按帧合并，流式回答不会触发全文档扫描。 */
 		function observeConversationHeader(doc = document) {
 			if (doc.head === null || doc.body === null) return () => {};
 			ensureStyle(doc);
-			ensureUserBubbleStyle(doc);
+			restoreOfficialUserBubbles(doc);
 			let applying = false;
 			let frame;
 			let watchedTabs;
@@ -994,7 +919,6 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 					syncTabSlider(doc);
 					decorateConversationTitle(doc);
 					decorateSessionLogDownload(doc);
-					decorateUserBubbles(doc);
 				} finally {
 					applying = false;
 				}
@@ -3542,7 +3466,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 		const getEmptyCompanionTabs = () => EMPTY_COMPANION_TABS;
 		const SIDEBAR_COLLAPSE_SETTLE_MS = 140;
 		const stylesheet$3 = `
-.dcu-root{--dcu-font:Inter,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI","Microsoft YaHei UI",sans-serif;--dcu-sidebar-wide-width:240px;--dcu-sidebar-primary:#393d3e;--dcu-sidebar-secondary:#676b6c;--dcu-sidebar-tertiary:#9a9f9f;--dcu-sidebar-navigation:#4e5253;--dcu-sidebar-icon:#4e5253;--dcu-sidebar-hover:#dfe8e5;--dcu-sidebar-border:rgba(37,46,41,.10);--dcu-tip-bg:#ffffff;--dcu-tip-shadow:0 10px 32px rgba(31,39,36,.22);height:100%;min-width:0;box-sizing:border-box;display:flex;flex-direction:column;overflow:hidden;background:var(--dsw-alias-bg-base);color:var(--dcu-sidebar-primary);font:14px/20px var(--dcu-font)}body[data-ds-dark-theme] .dcu-root{--dcu-sidebar-primary:#b9bab9;--dcu-sidebar-secondary:#909191;--dcu-sidebar-tertiary:#666867;--dcu-sidebar-navigation:#b9bab9;--dcu-sidebar-icon:#afafaf;--dcu-sidebar-hover:#303432;--dcu-sidebar-border:rgba(255,255,255,.08);--dcu-tip-bg:#2a2e2c;--dcu-tip-shadow:0 10px 30px rgba(0,0,0,.28)}
+.dcu-root{--dcu-font:Inter,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI","Microsoft YaHei UI",sans-serif;--dcu-sidebar-wide-width:240px;--dcu-sidebar-primary:#393d3e;--dcu-sidebar-secondary:#676b6c;--dcu-sidebar-tertiary:#9a9f9f;--dcu-sidebar-navigation:#4e5253;--dcu-sidebar-icon:#4e5253;--dcu-sidebar-hover:#dfe8e5;--dcu-sidebar-border:rgba(37,46,41,.10);--dcu-tip-bg:#ffffff;--dcu-tip-shadow:0 10px 32px rgba(31,39,36,.22);height:100%;min-width:0;box-sizing:border-box;display:flex;flex-direction:column;overflow:hidden;background:#eef7f5;color:var(--dcu-sidebar-primary);font:14px/20px var(--dcu-font)}body[data-ds-dark-theme] .dcu-root{background:#1d2120;--dcu-sidebar-primary:#b9bab9;--dcu-sidebar-secondary:#909191;--dcu-sidebar-tertiary:#666867;--dcu-sidebar-navigation:#b9bab9;--dcu-sidebar-icon:#afafaf;--dcu-sidebar-hover:#303432;--dcu-sidebar-border:rgba(255,255,255,.08);--dcu-tip-bg:#2a2e2c;--dcu-tip-shadow:0 10px 30px rgba(0,0,0,.28)}
 .dcu-expanded-shell{display:flex;width:var(--dcu-sidebar-wide-width);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-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}
@@ -3555,7 +3479,12 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 .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))}
 .dcu-search-scrim{position:fixed;z-index:10020;inset:0;display:flex;justify-content:center;align-items:flex-start;padding:72px 20px;background:color-mix(in srgb,#000 48%,transparent);animation:dcu-search-scrim-in 140ms ease-out}.dcu-search-dialog{width:min(560px,100%);max-height:min(640px,calc(100vh - 120px));overflow:auto;border:1px solid var(--dcu-sidebar-border);border-radius:16px;padding:10px;background:var(--dsw-specific-menu);box-shadow:var(--dsw-shadow-lv4);animation:dcu-search-dialog-in 180ms cubic-bezier(.16,1,.3,1)}@keyframes dcu-search-scrim-in{from{opacity:0}to{opacity:1}}@keyframes dcu-search-dialog-in{from{opacity:0;transform:translateY(-6px) scale(.985)}to{opacity:1;transform:none}}.dcu-search-input{margin-bottom:8px}.dcu-search-section{padding:6px 0}.dcu-search-title{padding:0 8px 4px;color:var(--dcu-sidebar-tertiary);font-size:12px;font-weight:600}.dcu-search-row{display:grid;grid-template-columns:minmax(0,1fr) auto;align-items:center;gap:12px;width:100%;min-height:34px;border:0;border-radius:8px;padding:6px 8px;background:transparent;color:var(--dcu-sidebar-primary);font:inherit;text-align:left;cursor:pointer}.dcu-search-row:hover,.dcu-search-row[data-active=true]{background:var(--dcu-sidebar-hover)}.dcu-search-main{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.dcu-search-detail{max-width:160px;overflow:hidden;color:var(--dcu-sidebar-tertiary);font-size:12px;text-overflow:ellipsis;white-space:nowrap}.dcu-search-empty{padding:18px 8px;color:var(--dcu-sidebar-tertiary);font-size:13px}@media (prefers-reduced-motion:reduce){.dcu-expanded-shell,.dcu-root.dcu-compact .dcu-compact-shell,.dcu-foot,.dcu-search-scrim,.dcu-search-dialog{animation:none;transition:none}}
-[data-conversation-scroll]{--dsh-chat-content-width:800px;--dsh-composer-card-max-width:calc(var(--dsh-chat-content-width) + 32px);--dsh-composer-side-clearance:24px}[data-conversation-scroll] [data-chat-flow]{gap:20px}[data-conversation-scroll] [data-composer-card]{min-height:96px;padding-top:10px;border-radius:16px;box-shadow:var(--dsw-shadow-lv3);transition:border-color 180ms ease,box-shadow 180ms ease}[data-conversation-scroll] [data-composer-card]:focus-within{border-color:var(--dsw-alias-button-info-fill);box-shadow:0 0 0 2px var(--dsw-static-deepseek-50),var(--dsw-shadow-lv3)}[data-conversation-scroll] [data-input-mirror]{min-height:44px}@media (prefers-reduced-motion:reduce){[data-conversation-scroll] [data-composer-card]{transition:none}}
+[data-conversation-scroll]{--dsh-composer-card-max-width:calc(var(--dsh-chat-content-width) + 32px);--dsh-composer-side-clearance:24px}[data-conversation-scroll] [data-composer-card]{min-height:96px;padding-top:10px;border-radius:16px;box-shadow:var(--dsw-shadow-lv3);transition:border-color 180ms ease,box-shadow 180ms ease}[data-conversation-scroll] [data-composer-card]:focus-within{border-color:var(--dsw-alias-button-info-fill);box-shadow:0 0 0 2px var(--dsw-static-deepseek-50),var(--dsw-shadow-lv3)}[data-conversation-scroll] [data-input-mirror]{min-height:44px}@media (prefers-reduced-motion:reduce){[data-conversation-scroll] [data-composer-card]{transition:none}}
+html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:has([data-dcu-official-turn-navigator]) .dcu-turn-navigator{display:none}
+[data-dcu-official-turn-navigator]{right:auto!important;left:calc(12px - (var(--dsh-composer-side-clearance) + 16px))!important}
+[data-dcu-official-turn-mark]{inset:0 auto 0 0!important}
+[data-dcu-official-turn-mark]:before{right:auto!important;left:0!important}
+[data-dcu-official-turn-tooltip]{right:auto!important;left:calc(100% + 10px)!important;animation:none!important}
 `;
 		function MenuIcon({ children }) {
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
@@ -4327,20 +4256,50 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 		];
 		//#endregion
 		//#region src/client/AboutSection.tsx
+		const PROGRESS_PHASES = /* @__PURE__ */ new Set([
+			"resolving",
+			"downloading",
+			"linking",
+			"building"
+		]);
 		const endpoint = "/api/michengai/codex-ui/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;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{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%)}}
 `;
 		function isDependencyStatus(value) {
 			if (value === null || typeof value !== "object") return false;
 			const status = value;
 			return MANAGED_DEPENDENCIES.some((dependency) => dependency.id === status.id) && typeof status.packageName === "string" && typeof status.installed === "boolean" && typeof status.updateAvailable === "boolean";
 		}
+		function isInstallProgress(value) {
+			if (value === null || typeof value !== "object") return false;
+			const progress = value;
+			const phase = progress.phase;
+			const total = progress.total;
+			const percent = progress.percent;
+			const currentPackage = progress.currentPackage;
+			return typeof progress.active === "boolean" && typeof progress.target === "string" && typeof progress.seconds === "number" && Number.isInteger(progress.seconds) && progress.seconds >= 0 && typeof progress.lastLine === "string" && (phase === null || typeof phase === "string" && PROGRESS_PHASES.has(phase)) && typeof progress.done === "number" && Number.isInteger(progress.done) && progress.done >= 0 && (total === null || typeof total === "number" && Number.isInteger(total) && total >= 0) && (percent === null || typeof percent === "number" && Number.isFinite(percent) && percent >= 0 && percent <= 100) && (currentPackage === null || typeof currentPackage === "string");
+		}
+		function installErrorText(error, t) {
+			const message = error instanceof Error ? error.message : "";
+			if (message.includes("没有进入当前 Profile") || message.includes("did not enter this profile")) return t("about.installUnchanged");
+			return message !== "" ? message : t("about.installFailed");
+		}
+		function progressLabel(progress, t) {
+			if (progress.phase !== null) {
+				const current = progress.currentPackage === null || progress.currentPackage === "" ? "" : ` · ${progress.currentPackage}`;
+				const done = progress.done > 0 ? ` · ${t("about.packagesDone").replace("{0}", String(progress.done))}` : "";
+				return `${t(`about.progress.${progress.phase}`)}${current}${done}`;
+			}
+			if (progress.lastLine !== "") return `${progress.lastLine}  (${progress.seconds}s)`;
+			return t("about.progressHint");
+		}
 		/** Codex UI 的功能说明、配套管理插件状态与受限安装入口。 */
 		function AboutSection({ t }) {
 			const [dependencies, setDependencies] = (0, react.useState)([]);
 			const [state, setState] = (0, react.useState)("loading");
 			const [installing, setInstalling] = (0, react.useState)();
+			const [progress, setProgress] = (0, react.useState)();
 			const [message, setMessage] = (0, react.useState)();
 			const alive = (0, react.useRef)(true);
 			const root = (0, react.useRef)(null);
@@ -4400,6 +4359,31 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 					observer.disconnect();
 				};
 			}, [load]);
+			(0, react.useEffect)(() => {
+				if (installing === void 0) {
+					setProgress(void 0);
+					return;
+				}
+				let cancelled = false;
+				const pull = async () => {
+					try {
+						const response = await fetch(`${endpoint}?action=progress`, { cache: "no-store" });
+						const payload = await response.json();
+						if (cancelled || !response.ok || !isInstallProgress(payload.progress)) return;
+						setProgress(payload.progress);
+					} catch {
+						if (!cancelled) return;
+					}
+				};
+				pull();
+				const timer = window.setInterval(() => {
+					pull();
+				}, 800);
+				return () => {
+					cancelled = true;
+					window.clearInterval(timer);
+				};
+			}, [installing]);
 			const install = async (id) => {
 				if (installingRef.current !== void 0) return;
 				installingRef.current = id;
@@ -4414,13 +4398,13 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 					setState("ready");
 					setMessage({
 						error: false,
-						text: t("about.restartRequired")
+						text: payload.autoReload === false ? t("about.restartManually") : t("about.restartRequired")
 					});
 				} catch (error) {
 					if (!alive.current) return;
 					setMessage({
 						error: true,
-						text: error instanceof Error ? error.message : t("about.installFailed")
+						text: installErrorText(error, t)
 					});
 				} finally {
 					installingRef.current = void 0;
@@ -4441,20 +4425,20 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 					setState("ready");
 					setMessage({
 						error: false,
-						text: payload.restartRequired === false ? t("about.upToDate") : t("about.restartRequired")
+						text: payload.restartRequired === false ? t("about.upToDate") : payload.autoReload === false ? t("about.restartManually") : t("about.restartRequired")
 					});
 				} catch (error) {
 					if (!alive.current) return;
 					setMessage({
 						error: true,
-						text: error instanceof Error ? error.message : t("about.installFailed")
+						text: installErrorText(error, t)
 					});
 				} finally {
 					installingRef.current = void 0;
 					if (alive.current) setInstalling(void 0);
 				}
 			};
-			const updateCount = dependencies.filter((dependency) => dependency.installed && dependency.updateAvailable).length;
+			const actionableCount = dependencies.filter((dependency) => !dependency.installed || dependency.updateAvailable).length;
 			const title = (id) => t(`about.dependency.${id}`);
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
 				ref: root,
@@ -4481,7 +4465,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: "dcu-about-dependencies-heading",
-						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", { children: t("about.dependencies") }), state === "ready" && updateCount > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", { children: t("about.dependencies") }), state === "ready" && actionableCount > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
 							className: "dcu-about-install dcu-about-update-all",
 							type: "button",
 							"aria-busy": installing === "all",
@@ -4543,6 +4527,26 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 							]
 						}, dependency.id))
 					}),
+					installing !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "dcu-about-progress",
+						role: "status",
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconLoadingOutline16, { size: 14 }) }),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", { children: progress === void 0 ? t("about.progressHint") : progressLabel(progress, t) }),
+							progress?.percent !== null && progress?.percent !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								className: "dcu-about-progress-pct",
+								children: [progress.percent, "%"]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: "dcu-about-progress-bar",
+								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: "dcu-about-progress-fill",
+									"data-wave": progress?.percent === null || progress?.percent === void 0,
+									style: progress?.percent === null || progress?.percent === void 0 ? void 0 : { width: `${progress.percent}%` }
+								})
+							})
+						]
+					}),
 					message !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 						className: "dcu-about-message",
 						"data-error": message.error,
@@ -4834,7 +4838,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 UI、专家、技能、归档、IM、定时任务和第三方插件市场。",
+			"about.dependenciesDescription": "每个配套插件都可单独安装和更新，也可一键安装缺失项并更新旧版本。可分别检查 Codex UI、专家、技能、归档、IM、定时任务和第三方插件市场。",
 			"about.loading": "正在读取依赖安装状态…",
 			"about.statusFailed": "暂时无法读取依赖安装状态。",
 			"about.installed": "已安装",
@@ -4843,11 +4847,19 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			"about.install": "安装",
 			"about.update": "更新",
 			"about.installing": "安装中",
-			"about.updateAll": "全部更新",
-			"about.updatingAll": "更新中",
-			"about.upToDate": "所有已安装插件均为最新版本。",
+			"about.updateAll": "全部安装/更新",
+			"about.updatingAll": "安装/更新中",
+			"about.upToDate": "所有配套插件均已安装并为最新版本。",
 			"about.installFailed": "依赖安装失败，请稍后重试。",
+			"about.installUnchanged": "安装命令已结束，但插件没有进入当前 Profile。请重试。",
 			"about.restartRequired": "正在热更新插件，窗口会自动刷新。",
+			"about.restartManually": "安装完成。当前 Web 无法自动重启，请重启 DSH Web 后刷新页面。",
+			"about.progressHint": "正在安装插件…",
+			"about.packagesDone": "已完成 {0} 个包",
+			"about.progress.resolving": "解析依赖",
+			"about.progress.downloading": "下载中",
+			"about.progress.linking": "写入文件",
+			"about.progress.building": "构建中",
 			"about.dependency.dsh": "DeepSeek Harness",
 			"about.dependency.suite": "Codex 套件",
 			"about.dependency.ui": "Codex UI",
@@ -4966,7 +4978,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 or update each companion plugin separately, or update every available plugin at once. Check Codex UI, expert, skill, archive, IM, scheduled-task, and marketplace plugins on their own.",
+			"about.dependenciesDescription": "Install or update each companion separately, or install missing plugins and update old versions in one action. 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",
@@ -4975,11 +4987,19 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			"about.install": "Install",
 			"about.update": "Update",
 			"about.installing": "Installing",
-			"about.updateAll": "Update all",
-			"about.updatingAll": "Updating",
-			"about.upToDate": "All installed plugins are up to date.",
+			"about.updateAll": "Install/update all",
+			"about.updatingAll": "Installing/updating",
+			"about.upToDate": "All companion plugins are installed and up to date.",
 			"about.installFailed": "Dependency installation failed. Try again later.",
+			"about.installUnchanged": "The install command finished, but the plugin did not enter this profile. Try again.",
 			"about.restartRequired": "Updating plugins now. The window will refresh automatically.",
+			"about.restartManually": "Installation complete. This Web host cannot restart itself; restart DSH Web, then refresh the page.",
+			"about.progressHint": "Installing plugin…",
+			"about.packagesDone": "{0} packages done",
+			"about.progress.resolving": "Resolving",
+			"about.progress.downloading": "Downloading",
+			"about.progress.linking": "Writing files",
+			"about.progress.building": "Building",
 			"about.dependency.dsh": "DeepSeek Harness",
 			"about.dependency.suite": "Codex suite",
 			"about.dependency.ui": "Codex UI",
@@ -5233,6 +5253,98 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			};
 		}
 		//#endregion
+		//#region src/client/official-turn-navigator.ts
+		const OFFICIAL_TURN_NAVIGATOR_ATTRIBUTE = "data-dcu-official-turn-navigator";
+		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";
+		function isOfficialTurnNavigator(element) {
+			return element instanceof HTMLElement && element.tagName === "NAV" && element.style.getPropertyValue("--turn-natural-height") !== "" && element.querySelector("button[type=\"button\"][aria-label]") !== null;
+		}
+		function markOfficialTurnNavigatorParts(navigator) {
+			for (const button of navigator.querySelectorAll("button[type=\"button\"][aria-label]")) button.setAttribute(OFFICIAL_TURN_MARK_ATTRIBUTE, "true");
+			for (const tooltip of navigator.querySelectorAll("[role=\"tooltip\"]")) tooltip.setAttribute(OFFICIAL_TURN_TOOLTIP_ATTRIBUTE, "true");
+		}
+		/** 标记实际挂载的官方轮次导航，避免依赖宿主样式文件名或会话 DOM 层级。 */
+		function markOfficialTurnNavigators(root = document) {
+			for (const element of root.querySelectorAll(`[${OFFICIAL_TURN_NAVIGATOR_ATTRIBUTE}]`)) {
+				if (isOfficialTurnNavigator(element)) continue;
+				element.removeAttribute(OFFICIAL_TURN_NAVIGATOR_ATTRIBUTE);
+				for (const part of element.querySelectorAll(`[${OFFICIAL_TURN_MARK_ATTRIBUTE}],[${OFFICIAL_TURN_TOOLTIP_ATTRIBUTE}]`)) {
+					part.removeAttribute(OFFICIAL_TURN_MARK_ATTRIBUTE);
+					part.removeAttribute(OFFICIAL_TURN_TOOLTIP_ATTRIBUTE);
+				}
+			}
+			for (const element of root.querySelectorAll("nav")) {
+				if (!isOfficialTurnNavigator(element)) continue;
+				element.setAttribute(OFFICIAL_TURN_NAVIGATOR_ATTRIBUTE, "true");
+				markOfficialTurnNavigatorParts(element);
+			}
+			return root.querySelectorAll(`[${OFFICIAL_TURN_NAVIGATOR_ATTRIBUTE}]`).length;
+		}
+		function nodeTouchesTurnNavigator(node) {
+			return node instanceof Element && (node.matches(`nav,[${OFFICIAL_TURN_NAVIGATOR_ATTRIBUTE}]`) || node.closest(`[${OFFICIAL_TURN_NAVIGATOR_ATTRIBUTE}]`) !== null || node.querySelector(`nav,[${OFFICIAL_TURN_NAVIGATOR_ATTRIBUTE}]`) !== null);
+		}
+		function nodeInsideTurnNavigator(node) {
+			return node instanceof Element && (node.matches(`[${OFFICIAL_TURN_NAVIGATOR_ATTRIBUTE}]`) || node.closest(`[${OFFICIAL_TURN_NAVIGATOR_ATTRIBUTE}]`) !== null);
+		}
+		function turnNavigatorMutationRelevant(records) {
+			return records.some((record) => record.type === "attributes" ? record.target instanceof Element && record.target.matches("nav") : nodeInsideTurnNavigator(record.target) || [...record.addedNodes].some(nodeTouchesTurnNavigator) || [...record.removedNodes].some(nodeTouchesTurnNavigator));
+		}
+		async function runtimeSupportsOfficialTurnNavigator(fetchImpl) {
+			try {
+				const response = await fetchImpl(CAPABILITIES_ENDPOINT, { cache: "no-store" });
+				if (!response.ok) return false;
+				const payload = await response.json();
+				if (payload === null || typeof payload !== "object") return false;
+				const capabilities = payload.capabilities;
+				return capabilities !== null && typeof capabilities === "object" && capabilities.officialTurnNavigator === true;
+			} catch {
+				return false;
+			}
+		}
+		/** 官方导航可能在会话切换后异步挂载；仅对相关变更按帧检测，并在停用时清理标记。 */
+		function observeOfficialTurnNavigators(doc = document, fetchImpl = fetch) {
+			if (doc.body === null || doc.documentElement === null) return () => {};
+			let active = true;
+			let frame;
+			const run = () => {
+				frame = void 0;
+				markOfficialTurnNavigators(doc);
+			};
+			const schedule = () => {
+				if (frame !== void 0) return;
+				frame = window.requestAnimationFrame(run);
+			};
+			const observer = new MutationObserver((records) => {
+				if (turnNavigatorMutationRelevant(records)) schedule();
+			});
+			observer.observe(doc.body, {
+				childList: true,
+				subtree: true,
+				attributes: true,
+				attributeFilter: ["style"]
+			});
+			schedule();
+			runtimeSupportsOfficialTurnNavigator(fetchImpl).then((supported) => {
+				if (!active) return;
+				if (supported) doc.documentElement.setAttribute(OFFICIAL_TURN_NAVIGATOR_SUPPORTED_ATTRIBUTE, "true");
+				else doc.documentElement.removeAttribute(OFFICIAL_TURN_NAVIGATOR_SUPPORTED_ATTRIBUTE);
+			});
+			return () => {
+				active = false;
+				observer.disconnect();
+				if (frame !== void 0) window.cancelAnimationFrame(frame);
+				doc.documentElement.removeAttribute(OFFICIAL_TURN_NAVIGATOR_SUPPORTED_ATTRIBUTE);
+				for (const element of doc.querySelectorAll(`[${OFFICIAL_TURN_NAVIGATOR_ATTRIBUTE}],[${OFFICIAL_TURN_MARK_ATTRIBUTE}],[${OFFICIAL_TURN_TOOLTIP_ATTRIBUTE}]`)) {
+					element.removeAttribute(OFFICIAL_TURN_NAVIGATOR_ATTRIBUTE);
+					element.removeAttribute(OFFICIAL_TURN_MARK_ATTRIBUTE);
+					element.removeAttribute(OFFICIAL_TURN_TOOLTIP_ATTRIBUTE);
+				}
+			};
+		}
+		//#endregion
 		//#region src/client/conversation-dom.ts
 		/**
 		* DSH 尚未公开会话滚动容器和消息锚点服务；把兼容读取集中在这里，方便
@@ -5512,6 +5624,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			ctx.effect(() => observeSettingsNavIcons(), "michengai-codex-ui: settings nav icons");
 			ctx.effect(() => observePermissionLabels(ctx.locale), "michengai-codex-ui: permission labels");
 			ctx.effect(() => observeConversationHeader(), "michengai-codex-ui: conversation header");
+			ctx.effect(() => observeOfficialTurnNavigators(), "michengai-codex-ui: official turn navigator");
 			const companionSlots = createCompanionTabSource(ctx.slots);
 			ctx.slots.inject("sidebar", () => ctx.slots.register({
 				name: "sidebar",

package/dist/index.mjs

@@ -1,4 +1,5 @@
 import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
 import { mkdir, readFile, rename, rm, unlink, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { basename, dirname, isAbsolute, join, resolve, sep, win32 } from "node:path";
@@ -56,6 +57,7 @@ function managedDependency(id) {
 const PROFILE_PENDING_UPDATES_FILE = ".dsh-pending-updates.json";
 const APPLY_PLUGIN_UPDATES_IPC = "apply-plugin-updates";
 const PLUGIN_INSTALL_TIMEOUT_MS = 6e5;
+const PLUGIN_MOUNT_TIMEOUT_MS = 15e3;
 function optionalService(ctx, name) {
 	if (ctx === void 0) return void 0;
 	return typeof ctx.get === "function" ? ctx.get(name) : ctx[name];
@@ -111,18 +113,37 @@ function resolveDependencyRuntime(ctx, options = {}) {
 function profileDirectory(runtime) {
 	return runtime.profileDir;
 }
-async function declaredPluginNames(runtime) {
+async function readProfileManifest(runtime) {
 	try {
-		const manifest = JSON.parse(await readFile(resolve(profileDirectory(runtime), "package.json"), "utf8"));
-		return [.../* @__PURE__ */ new Set([...Object.keys({
-			...manifest.devDependencies,
-			...manifest.dependencies
-		}), ...manifest.dsh?.profile?.bundles ?? []])];
+		return JSON.parse(await readFile(resolve(profileDirectory(runtime), "package.json"), "utf8"));
 	} catch (error) {
-		if (error.code === "ENOENT") return [];
+		if (error.code === "ENOENT") return {};
 		throw error;
 	}
 }
+async function declaredPluginNames(runtime) {
+	const manifest = await readProfileManifest(runtime);
+	return [.../* @__PURE__ */ new Set([...Object.keys({
+		...manifest.devDependencies,
+		...manifest.dependencies
+	}), ...manifest.dsh?.profile?.bundles ?? []])];
+}
+/** 真正挂进 Profile 的插件名单；残留 node_modules 或仅写在 dependencies 里都不算。 */
+async function profileBundleNames(runtime) {
+	return (await readProfileManifest(runtime)).dsh?.profile?.bundles ?? [];
+}
+/** 安装缺失插件前移除卸载遗留的目录或 Junction；已挂载插件绝不触碰。 */
+async function removeUnmountedPackagePath(packageName, runtime) {
+	if (!MANAGED_DEPENDENCIES.some((dependency) => dependency.packageName === packageName)) throw new Error("不支持清理该依赖。");
+	if (isManagedPackageDeclared(packageName, await profileBundleNames(runtime))) return;
+	const packagePath = resolve(profileDirectory(runtime), "node_modules", ...packageName.split("/"));
+	await rm(packagePath, {
+		recursive: true,
+		force: true,
+		maxRetries: 2,
+		retryDelay: 50
+	});
+}
 /** 单独更新子插件时先卸套件，避免两套 patch 冲突。 */
 function pluginsToRemoveBeforeInstall(declared, installing) {
 	if (SUITE_MEMBER_PACKAGES.includes(installing) && declared.includes("@michengai/dsh-codex-suite")) return [SUITE_PACKAGE];
@@ -305,9 +326,19 @@ function newerVersion(installed, latest) {
 	for (let index = 0; index < current.core.length; index += 1) if (candidate.core[index] !== current.core[index]) return candidate.core[index] > current.core[index];
 	return comparePrerelease(candidate.prerelease, current.prerelease) > 0;
 }
+const OFFICIAL_TURN_NAVIGATOR_MIN_VERSION = "0.1.2-alpha.2";
+/** 官方轮次导航从 DSH alpha.2 起成为运行时能力；版本判断不依赖其私有 DOM。 */
+function supportsOfficialTurnNavigator(version) {
+	return version === OFFICIAL_TURN_NAVIGATOR_MIN_VERSION || newerVersion(OFFICIAL_TURN_NAVIGATOR_MIN_VERSION, version);
+}
+/** 只读取本地运行时清单，不访问 npm registry。 */
+async function runtimeSupportsOfficialTurnNavigator(runtime = resolveDependencyRuntime()) {
+	const version = await installedPackageVersion("@deepseek-ai/dsh", runtime);
+	return version !== void 0 && supportsOfficialTurnNavigator(version);
+}
 /** 返回当前 profile 中固定管理插件的实际安装版本与 npm latest 状态。 */
 async function dependencyStatuses(runtime = resolveDependencyRuntime()) {
-	const declaredNames = await declaredPluginNames(runtime);
+	const bundleNames = await profileBundleNames(runtime);
 	return Promise.all(MANAGED_DEPENDENCIES.map(async (dependency) => {
 		const version = await installedPackageVersion(dependency.packageName, runtime);
 		if (version === void 0 && runtime.environmentKind === "desktop" && isOfficialRuntimePackage(dependency.packageName)) return {
@@ -315,7 +346,7 @@ async function dependencyStatuses(runtime = resolveDependencyRuntime()) {
 			installed: true,
 			updateAvailable: false
 		};
-		const declared = isOfficialRuntimePackage(dependency.packageName) || isManagedPackageDeclared(dependency.packageName, declaredNames);
+		const declared = isOfficialRuntimePackage(dependency.packageName) || isManagedPackageDeclared(dependency.packageName, bundleNames);
 		if (version === void 0 || !isManagedPackageInstalled({
 			installedVersion: version,
 			declared
@@ -348,10 +379,6 @@ function requestDesktopHotUpdate(send = process.send) {
 	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, runtime) {
 	const pendingPath = resolve(profileDirectory(runtime), PROFILE_PENDING_UPDATES_FILE);
 	let packages = [];
@@ -407,16 +434,171 @@ async function recordDeclaredVersion(packageName, version, runtime) {
 	};
 	await writeFile(manifestPath, `${JSON.stringify(manifest, void 0, 2)}\n`, "utf8");
 }
+const progressState = {
+	active: false,
+	target: "",
+	seconds: 0,
+	lastLine: "",
+	phase: null,
+	done: 0,
+	total: null,
+	percent: null,
+	currentPackage: null,
+	leftover: "",
+	startedAt: 0
+};
+function beginInstallProgress(target) {
+	progressState.active = true;
+	progressState.target = target;
+	progressState.startedAt = Date.now();
+	progressState.seconds = 0;
+	progressState.lastLine = "";
+	progressState.phase = null;
+	progressState.done = 0;
+	progressState.total = null;
+	progressState.percent = null;
+	progressState.currentPackage = null;
+	progressState.leftover = "";
+}
+function endInstallProgress() {
+	if (progressState.leftover !== "") applyProgressLine(progressState.leftover.trim());
+	progressState.active = false;
+	progressState.leftover = "";
+}
+function installProgressSnapshot() {
+	return {
+		active: progressState.active,
+		target: progressState.target,
+		seconds: progressState.active && progressState.startedAt > 0 ? Math.max(0, Math.round((Date.now() - progressState.startedAt) / 1e3)) : 0,
+		lastLine: progressState.lastLine,
+		phase: progressState.phase,
+		done: progressState.done,
+		total: progressState.total,
+		percent: progressState.percent,
+		currentPackage: progressState.currentPackage
+	};
+}
+function applyProgressLine(line) {
+	if (line === "") return;
+	const human = /Progress:\s*resolved\s+(\d+),\s*reused\s+(\d+),\s*downloaded\s+(\d+),\s*added\s+(\d+)/.exec(line);
+	if (human !== null) {
+		const resolved = Number(human[1]);
+		const added = Number(human[4]);
+		progressState.lastLine = line.slice(0, 200);
+		progressState.total = resolved;
+		progressState.done = added;
+		progressState.percent = resolved > 0 ? Math.max(1, Math.min(/done/i.test(line) ? 100 : 99, Math.round(added / resolved * 100))) : null;
+		if (added > 0) progressState.phase = "linking";
+		else if (Number(human[3]) > 0) progressState.phase = "downloading";
+		else progressState.phase = "resolving";
+		return;
+	}
+	if (/^Done in /i.test(line)) {
+		progressState.lastLine = line.slice(0, 200);
+		if (progressState.percent !== null) progressState.percent = 100;
+		progressState.phase = "linking";
+		return;
+	}
+	if (line.startsWith("{")) {
+		try {
+			const event = JSON.parse(line);
+			if (typeof event.name !== "string" || !event.name.startsWith("pnpm:")) return;
+			if (event.name === "pnpm:stage" && typeof event.stage === "string") {
+				if (event.stage.includes("resolution")) progressState.phase = "resolving";
+				else if (event.stage.includes("import")) progressState.phase = "linking";
+				else if (event.stage.includes("build")) progressState.phase = "building";
+			}
+			if (event.name === "pnpm:progress" && typeof event.packageId === "string" && event.packageId !== "") {
+				progressState.currentPackage = event.packageId.split(">")[0] ?? event.packageId;
+				if (event.status === "fetched") progressState.phase = "downloading";
+			}
+		} catch {
+			return;
+		}
+		return;
+	}
+	progressState.lastLine = line.slice(0, 200);
+}
+/** 把 pnpm / dsh plugin 的输出收成关于页可轮询的进度。 */
+function noteInstallOutput(chunk) {
+	if (!progressState.active) return;
+	const lines = `${progressState.leftover}${chunk}`.split(/\r?\n/);
+	progressState.leftover = lines.pop() ?? "";
+	for (const line of lines) applyProgressLine(line.trim());
+}
+function pluginUnchangedError() {
+	return /* @__PURE__ */ new Error("安装命令已结束，但插件没有进入当前 Profile。请重试。");
+}
+async function waitUntilPluginMounted(packageName, version, runtime, timeoutMs = PLUGIN_MOUNT_TIMEOUT_MS) {
+	const deadline = Date.now() + timeoutMs;
+	while (Date.now() <= deadline) {
+		const bundles = await profileBundleNames(runtime);
+		const inBundles = isOfficialRuntimePackage(packageName) || isManagedPackageDeclared(packageName, bundles);
+		const installed = await installedPackageVersion(packageName, runtime);
+		if (inBundles && installed === version) return;
+		await new Promise((resolve) => setTimeout(resolve, 80));
+	}
+	throw pluginUnchangedError();
+}
 function pluginCommandError(stderr) {
 	const detail = stderr.replace(/\s+/g, " ").trim();
 	if (detail.includes("minimumReleaseAge") || detail.includes("Release age")) return /* @__PURE__ */ new Error("更新被 pnpm 发布时间保护拦截。请确认已写入当前版本白名单后重试。");
 	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 (/ERR_PNPM_IGNORED_BUILDS|Ignored build scripts/i.test(detail)) return /* @__PURE__ */ new Error("插件依赖的 pnpm 构建脚本策略尚未确认。请更新 Profile 的 allowBuilds 配置后重试。");
-	if (/pnpm not found/i.test(detail)) return /* @__PURE__ */ new Error("当前环境找不到 pnpm。请从桌面端启动后再更新。");
+	if (/pnpm not found|未找到 pnpm/i.test(detail)) return /* @__PURE__ */ new Error("当前环境找不到 pnpm。请确认已安装 pnpm 后重启 DSH 再试。");
 	return /* @__PURE__ */ new Error("无法在应用运行时更新插件。请先完全退出桌面端，再重新打开后更新。");
 }
 /**
+* 图形界面或桌面启动往往没有 shell PATH。把 pnpm 常见安装目录补进去，
+* 让 `dsh plugin add` 能找到本机已有的 pnpm，而不是直接启动它。
+*/
+function pluginToolSearchDirs(platform = process.platform, env = process.env, home = homedir(), nodeDir = dirname(process.execPath)) {
+	const dirs = [];
+	const pnpmHome = (env.PNPM_HOME ?? "").trim();
+	if (pnpmHome !== "") dirs.push(pnpmHome);
+	if (platform === "win32") {
+		const local = (env.LOCALAPPDATA ?? "").trim();
+		const roaming = (env.APPDATA ?? "").trim();
+		if (local !== "") dirs.push(join(local, "pnpm"));
+		if (roaming !== "") dirs.push(join(roaming, "npm"));
+	} else dirs.push("/opt/homebrew/bin", "/usr/local/bin", join(home, ".local", "bin"), join(home, ".local", "share", "pnpm"));
+	if (nodeDir.trim() !== "") dirs.push(nodeDir);
+	return [...new Set(dirs.filter((dir) => dir.trim() !== ""))];
+}
+function pluginSpawnEnv(env = process.env, platform = process.platform, home = homedir(), nodeDir = dirname(process.execPath)) {
+	const separator = platform === "win32" ? ";" : ":";
+	const parts = (env.PATH ?? env.Path ?? "").split(separator).filter((part) => part !== "");
+	for (const dir of pluginToolSearchDirs(platform, env, home, nodeDir)) if (!parts.includes(dir)) parts.push(dir);
+	return {
+		...env,
+		CI: "true",
+		PATH: parts.join(separator)
+	};
+}
+/** Desktop 桥接在 Web 下不会设置 DSH_PNPM_ENTRY；补上 Node 自带的 corepack pnpm。 */
+function ensurePnpmEntry(env = process.env, nodeDir = dirname(process.execPath)) {
+	const existing = (env.DSH_PNPM_ENTRY ?? "").trim();
+	if (existing !== "") return existing;
+	const candidate = join(nodeDir, "node_modules", "corepack", "dist", "pnpm.js");
+	if (!existsSync(candidate)) return void 0;
+	return candidate;
+}
+/** Desktop 桥接当前从 process.env 同步读取 pnpm 入口；调用结束后立即恢复，避免污染后续子进程。 */
+function withPnpmEntry(callback, env = process.env, nodeDir = dirname(process.execPath)) {
+	const entry = ensurePnpmEntry(env, nodeDir);
+	if (entry === void 0) return callback();
+	const hadEntry = Object.prototype.hasOwnProperty.call(env, "DSH_PNPM_ENTRY");
+	const previous = env.DSH_PNPM_ENTRY;
+	env.DSH_PNPM_ENTRY = entry;
+	try {
+		return callback();
+	} finally {
+		if (hadEntry) env.DSH_PNPM_ENTRY = previous;
+		else delete env.DSH_PNPM_ENTRY;
+	}
+}
+/**
 * 复用启动当前服务的 DSH CLI：它会通过 pnpm 从 npm 安装或更新，并自动维护
 * dsh.profile.bundles，避免浏览器端直接管理 profile 文件。
 */
@@ -456,7 +638,9 @@ function monitorPluginChild(child, timeoutMs = PLUGIN_INSTALL_TIMEOUT_MS) {
 		let output = "";
 		let settled = false;
 		const collect = (chunk) => {
-			output = `${output}${String(chunk)}`.slice(-65536);
+			const text = String(chunk);
+			output = `${output}${text}`.slice(-65536);
+			noteInstallOutput(text);
 		};
 		const finish = (error) => {
 			if (settled) return;
@@ -486,7 +670,9 @@ function monitorDesktopPlugin(handle, timeoutMs = PLUGIN_INSTALL_TIMEOUT_MS) {
 		let output = "";
 		let settled = false;
 		const collect = (chunk) => {
-			output = `${output}${String(chunk)}`.slice(-65536);
+			const text = String(chunk);
+			output = `${output}${text}`.slice(-65536);
+			noteInstallOutput(text);
 		};
 		const finish = (error) => {
 			if (settled) return;
@@ -518,7 +704,8 @@ function monitorDesktopPlugin(handle, timeoutMs = PLUGIN_INSTALL_TIMEOUT_MS) {
 	});
 }
 function runDshPlugin(args, runtime = resolveDependencyRuntime(), timeoutMs = PLUGIN_INSTALL_TIMEOUT_MS) {
-	if (runtime.desktopPnpm !== void 0) return monitorDesktopPlugin(runtime.desktopPnpm.runPlugin(args, runtime.profileDir), timeoutMs);
+	const desktopPnpm = runtime.desktopPnpm;
+	if (desktopPnpm !== void 0) return monitorDesktopPlugin(withPnpmEntry(() => desktopPnpm.runPlugin(args, runtime.profileDir)), timeoutMs);
 	const entry = resolveDshCliEntry();
 	return monitorPluginChild(spawn(process.execPath, [
 		...pluginExecArgv(),
@@ -529,10 +716,7 @@ function runDshPlugin(args, runtime = resolveDependencyRuntime(), timeoutMs = PL
 		...args
 	], {
 		cwd: process.cwd(),
-		env: {
-			...process.env,
-			CI: "true"
-		},
+		env: pluginSpawnEnv(),
 		windowsHide: true,
 		stdio: [
 			"ignore",
@@ -553,11 +737,11 @@ async function installDependency(id, requestHotUpdate = requestDesktopHotUpdate,
 		installing = false;
 	}
 }
-/** 只挑选已安装且确有新版本的插件，缺失插件仍交给各行的“安装”按钮。 */
+/** 顶部批量操作同时安装缺失插件并更新落后版本。 */
 function updatableDependencyIds(statuses) {
-	return statuses.filter((status) => status.installed && status.updateAvailable).map((status) => status.id);
+	return statuses.filter((status) => !status.installed || status.updateAvailable).map((status) => status.id);
 }
-/** 把所有待更新版本一次写入清单，最后只请求一次桌面热更新。 */
+/** 把所有待安装/更新版本一次写入清单，最后只请求一次桌面热更新。 */
 async function updateAllDependencies(requestHotUpdate = requestDesktopHotUpdate, runtime = resolveDependencyRuntime()) {
 	if (installing) throw new Error("已有依赖安装正在进行，请等待完成后再试。");
 	installing = true;
@@ -609,30 +793,39 @@ async function installDependenciesLocked(ids, requestHotUpdate, runtime) {
 			version
 		};
 	}));
-	const remove = [...new Set(targets.flatMap((target) => pluginsToRemoveBeforeInstall(declared, target.packageName)))];
-	await ensureRequiredBuildPolicies(runtime);
-	for (const target of targets) {
-		await ensureLatestReleaseAllowed(target.packageName, target.version, runtime);
-		if (!isOfficialRuntimePackage(target.packageName)) await recordDeclaredVersion(target.packageName, target.version, runtime);
-		await recordPendingUpdate(target.packageName, target.version, runtime);
-	}
-	if (remove.length > 0) await runDshPlugin(["remove", ...remove], runtime);
-	if (runtime.desktopPnpm === void 0 && requestHotUpdate()) return dependencyStatuses(runtime);
-	for (const target of targets) {
-		try {
+	beginInstallProgress(targets.map((target) => `${target.packageName}@${target.version}`).join(", "));
+	try {
+		const remove = [...new Set(targets.flatMap((target) => pluginsToRemoveBeforeInstall(declared, target.packageName)))];
+		await ensureRequiredBuildPolicies(runtime);
+		for (const target of targets) {
+			await ensureLatestReleaseAllowed(target.packageName, target.version, runtime);
+			if (!isOfficialRuntimePackage(target.packageName)) await removeUnmountedPackagePath(target.packageName, runtime);
+			await recordPendingUpdate(target.packageName, target.version, runtime);
+		}
+		if (remove.length > 0) await runDshPlugin(["remove", ...remove], runtime);
+		if (runtime.desktopPnpm === void 0 && requestHotUpdate()) {
+			for (const target of targets) if (!isOfficialRuntimePackage(target.packageName)) await recordDeclaredVersion(target.packageName, target.version, runtime);
+			return dependencyStatuses(runtime);
+		}
+		const officialTargets = targets.filter((target) => isOfficialRuntimePackage(target.packageName));
+		const communityTargets = targets.filter((target) => !isOfficialRuntimePackage(target.packageName));
+		const batches = [...officialTargets.map((target) => [target]), ...communityTargets.length === 0 ? [] : [communityTargets]];
+		for (const batch of batches) {
 			await runDshPlugin([
 				"add",
-				`${target.packageName}@${target.version}`,
+				...batch.map((target) => `${target.packageName}@${target.version}`),
 				"--registry=https://registry.npmjs.org/"
 			], runtime);
-		} catch (error) {
-			if (isRestartableInstallError(error)) return dependencyStatuses(runtime);
-			throw error;
+			for (const target of batch) {
+				await waitUntilPluginMounted(target.packageName, target.version, runtime);
+				if (!isOfficialRuntimePackage(target.packageName)) await recordDeclaredVersion(target.packageName, target.version, runtime);
+				await removePendingUpdate(target.packageName, runtime);
+			}
 		}
-		if (await installedPackageVersion(target.packageName, runtime) !== target.version) return dependencyStatuses(runtime);
-		await removePendingUpdate(target.packageName, runtime);
+		return dependencyStatuses(runtime);
+	} finally {
+		endInstallProgress();
 	}
-	return dependencyStatuses(runtime);
 }
 //#endregion
 //#region src/explorer-path-policy.ts
@@ -1071,6 +1264,23 @@ function apply(ctx) {
 				const url = new URL(request.url ?? "/", "http://localhost");
 				try {
 					if (request.method === "GET") {
+						if (url.searchParams.get("action") === "capabilities") {
+							const capabilities = { officialTurnNavigator: await runtimeSupportsOfficialTurnNavigator(resolveDependencyRuntime(ctx)) };
+							response.writeHead(200, {
+								"content-type": "application/json; charset=utf-8",
+								"cache-control": "no-store"
+							});
+							response.end(JSON.stringify({ capabilities }));
+							return;
+						}
+						if (url.searchParams.get("action") === "progress") {
+							response.writeHead(200, {
+								"content-type": "application/json; charset=utf-8",
+								"cache-control": "no-store"
+							});
+							response.end(JSON.stringify({ progress: installProgressSnapshot() }));
+							return;
+						}
 						const dependencies = await dependencyStatuses(resolveDependencyRuntime(ctx));
 						response.writeHead(200, {
 							"content-type": "application/json; charset=utf-8",
@@ -1089,9 +1299,10 @@ function apply(ctx) {
 							return;
 						}
 						if (url.searchParams.get("action") === "update-all") {
+							const autoReload = typeof process.send === "function";
 							let restartAfterResponse = false;
 							const { dependencies, updatedCount } = await updateAllDependencies(() => {
-								restartAfterResponse = typeof process.send === "function";
+								restartAfterResponse = autoReload;
 								return restartAfterResponse;
 							}, resolveDependencyRuntime(ctx));
 							response.writeHead(200, {
@@ -1100,16 +1311,18 @@ function apply(ctx) {
 							});
 							response.end(JSON.stringify({
 								dependencies,
-								restartRequired: updatedCount > 0
+								restartRequired: updatedCount > 0,
+								autoReload: typeof process.send === "function"
 							}));
 							if (restartAfterResponse) setTimeout(() => {
 								requestDesktopHotUpdate();
 							}, 150).unref?.();
 							return;
 						}
+						const autoReload = typeof process.send === "function";
 						let restartAfterResponse = false;
 						const dependencies = await installDependency(url.searchParams.get("dependency"), () => {
-							restartAfterResponse = typeof process.send === "function";
+							restartAfterResponse = autoReload;
 							return restartAfterResponse;
 						}, resolveDependencyRuntime(ctx));
 						response.writeHead(200, {
@@ -1118,7 +1331,8 @@ function apply(ctx) {
 						});
 						response.end(JSON.stringify({
 							dependencies,
-							restartRequired: true
+							restartRequired: true,
+							autoReload: typeof process.send === "function"
 						}));
 						if (restartAfterResponse) setTimeout(() => {
 							requestDesktopHotUpdate();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michengai/dsh-codex-ui",
-  "version": "0.2.96",
+  "version": "0.2.97",
   "description": "以 Codex 风格重构 DSH Web 侧栏的独立客户端插件",
   "license": "Apache-2.0",
   "publishConfig": {