dsh-plugin-deck-studio 0.2.13 → 0.2.14

package/client.js

@@ -29,6 +29,14 @@ window.__ModuleLoader__.load({
     const WORKBENCH_KEY = "deck-studio-workbench";
     const ROUTE_PREFIX = "/api/deck-studio.";
     const POLL_MS = 5000;
+    /**
+     * F-202B（ADR-0027）：桌面宿主的 shell 起源是自定义协议（如 dsh-app://），嵌 DSH 页面的
+     * 子帧拿不到 boot 注入、流式端点也不可达 —— 桌面里对话改用「原生会话 Dock」；
+     * web（http）宿主继续走工作台内嵌的 DSH iframe。
+     */
+    const DESKTOP_SHELL = !/^(https?:)$/.test(location.protocol);
+    /** 桌面 Dock 渲染会话用的子弹槽名（shell.overlay 条目下的 session 作用域子槽）。 */
+    const CHAT_SLOT = `${WORKBENCH_KEY}.chat`;
 
     /** 路由白名单：getJson 只放行这一族地址。 */
     async function getJson(path) {
@@ -274,9 +282,21 @@ div[data-sidebar-collapsed]{grid-template-columns:0px minmax(0px,1fr) 0px!import
      * 打开先到主页（#/home/decks），点 deck 后是左中右三栏：左原生 Chat / 中间整页图片 / 右资料库。
      * 对话仍走 DSH 原生 Chat（工作台左栏嵌 `/?decklineChat=1`），权限、附件、模型、思考过程、气泡都是原生的。
      */
+
+    /**
+     * 桌面 Dock（F-202B / ADR-0027 升级）：桌面里不再嵌 DSH 页面，用宿主 `shell.overlay` +
+     * SessionProvider + `sessions.retain` 把**原生会话**渲染到工作台对话列的位置
+     * （multichat / html-deck-studio 同款做法，注册形状已在该宿主验证）。
+     * 工作台（iframe）把当前绑定会话经 `dsh-deck-studio:chat-session` 报上来；
+     * Dock 测量工作台 iframe 里 `#chatDockArea` 的矩形后固定覆盖其上。
+     */
+    /** 客户端插件体：样式 + 槽位注册。 */
+    function apply(ctx) {
+      injectStylesheet();
     function WorkbenchFrame() {
       return h("iframe", {
         id: "dsh-deck-workbench-frame",
+        ref: (node) => setWorkbenchFrame(node),
         title: "Deckline 工作台",
         src: "/api/deck-studio.app#/home/decks",
         style: { width: "100%", height: "100%", border: 0, display: "block", background: "#faf8f2" },
@@ -286,9 +306,94 @@ div[data-sidebar-collapsed]{grid-template-columns:0px minmax(0px,1fr) 0px!import
       });
     }
 
-    /** 客户端插件体：样式 + 槽位注册。 */
-    function apply(ctx) {
-      injectStylesheet();
+      const dockState = { sessionId: "", listeners: new Set() };
+      function publishDockSession(sessionId) {
+        const next = typeof sessionId === "string" ? sessionId : "";
+        if (dockState.sessionId === next) return;
+        dockState.sessionId = next;
+        for (const listener of dockState.listeners) listener();
+      }
+      function subscribeDockSession(listener) {
+        dockState.listeners.add(listener);
+        return () => dockState.listeners.delete(listener);
+      }
+
+      /** 工作台 iframe 元素引用（React ref）；Dock 靠它测矩形 / 报「Dock 已就绪」。 */
+      const frameState = { el: null, listeners: new Set() };
+      function setWorkbenchFrame(node) {
+        const next = node ?? null;
+        if (frameState.el === next) return;
+        frameState.el = next;
+        for (const listener of frameState.listeners) listener();
+      }
+      function subscribeWorkbenchFrame(listener) {
+        frameState.listeners.add(listener);
+        return () => frameState.listeners.delete(listener);
+      }
+
+      /** 会话内容视图：复用宿主 `conversation.session` 槽（不是复制品）。 */
+      function DeckChatView(props) {
+        return props.renderSlot("conversation.session", { view: "chat" });
+      }
+      function DeckChatBody({ useSession, useConversation, renderFactorySlot }) {
+        const session = useSession((value) => value);
+        const active = useConversation((value) => value).activeTargets;
+        const phase = (!session.blank || session.running || active.size > 0) ? "active" : "hero";
+        return renderFactorySlot("conversation.content", { variant: "embedded", phase, hero: phase === "hero" }, { slots: { views: DeckChatView } });
+      }
+      /** Dock：测量工作台对话占位矩形；用 retain 的会话引用喂 SessionProvider。 */
+      function DeckChatDock({ SessionProvider, renderSlot }) {
+        const sessionId = React.useSyncExternalStore(subscribeDockSession, () => dockState.sessionId);
+        // 主区面板卸载/重建时 iframe 元素会换，Dock 必须跟着重算位置，否则切走再切回来就不见了。
+        const frameEl = React.useSyncExternalStore(subscribeWorkbenchFrame, () => frameState.el);
+        const [rect, setRect] = React.useState(null);
+        const [reference, setReference] = React.useState(null);
+        React.useEffect(() => {
+          const measure = () => {
+            let next = null;
+            try {
+              const outer = frameEl?.getBoundingClientRect?.();
+              // 只盖住对话框的内容区（#chatDockArea），把上面的绑定/＋/会话菜单那一行留出来。
+              const inner = frameEl?.contentDocument?.querySelector("#chatDockArea")?.getBoundingClientRect?.();
+              if (outer && inner && outer.width > 0 && inner.width > 4 && inner.height > 4) {
+                next = {
+                  left: Math.round(outer.left + inner.left),
+                  top: Math.round(outer.top + inner.top),
+                  width: Math.round(inner.width),
+                  height: Math.round(inner.height),
+                };
+              }
+            } catch {
+              next = null;
+            }
+            setRect((prev) => (prev && next && prev.left === next.left && prev.top === next.top && prev.width === next.width && prev.height === next.height) ? prev : next);
+          };
+          measure();
+          if (!frameEl) { setRect(null); return undefined; }
+          const timer = setInterval(measure, 800);
+          window.addEventListener("resize", measure);
+          return () => { clearInterval(timer); window.removeEventListener("resize", measure); };
+        }, [frameEl]);
+        // 引用放 state（不是 ref）：StrictMode 的 effect 重放与 ref 释放会让提交渲染时 ref 为空。
+        React.useEffect(() => {
+          const sessions = ctx.sessions;
+          if (!sessionId || typeof sessions?.retain !== "function") { setReference(null); return undefined; }
+          let held = null;
+          try { held = sessions.retain(sessionId, { source: WORKBENCH_KEY }); } catch (error) { ctx.logger?.warn?.(`deck-studio: retain failed: ${error?.message ?? error}`); }
+          setReference(held ?? null);
+          return () => { try { held?.release?.(); } catch { /* 已释放 */ } };
+        }, [sessionId]);
+        // Dock 已在渲染：告诉工作台 iframe 收起降级卡（#chatHostCard）。
+        React.useEffect(() => {
+          if (!rect || !reference || !frameEl?.contentWindow) return;
+          try { frameEl.contentWindow.postMessage({ type: "dsh-deck-studio:chat-dock" }, "*"); } catch { /* 不可达时降级卡留着 */ }
+        }, [rect, reference]);
+        if (!SessionProvider || !renderSlot || !reference || !rect) return null;
+        return h("div", {
+          "data-deck-studio-chat-dock": "",
+          style: { position: "fixed", left: `${rect.left}px`, top: `${rect.top}px`, width: `${rect.width}px`, height: `${rect.height}px`, zIndex: 40, display: "flex", flexDirection: "column", minHeight: 0, overflow: "hidden", background: "var(--paper,#faf8f2)", borderRight: "1px solid var(--line,#e8e2d6)", pointerEvents: "auto" },
+        }, h(SessionProvider, { session: reference }, renderSlot(CHAT_SLOT, {})));
+      }
       // 工作台左栏会把 DSH 原生 Chat 以 `/?decklineChat=1` 嵌进来（同源 iframe）。
       // 那个嵌套的 DSH 实例不再自动打开工作台，否则会层层嵌套（F-68）。
       const chatEmbed = new URLSearchParams(window.location.search).get("decklineChat") === "1";
@@ -431,7 +536,11 @@ div[data-sidebar-collapsed]{grid-template-columns:0px minmax(0px,1fr) 0px!import
           // 不把插件安装目录或 DSH 私有数据目录登记成用户工作区。
           const path = normalize(cwd);
           const internal = /(^|\/)node_modules(\/|$)|(^|\/)\.dsh(\/|$)/.test(path);
-          if (path && path !== "/" && !internal) return register(cwd);
+          // F-202B：桌面宿主里 shell 的 process.cwd 是 App 包目录（/Applications/DeepSeek Harness.app）
+          // ——把它登记成用户工作区是错的（web 宿主的 cwd 才是启动目录）。这类系统路径视为不可信，
+          // 落到 sourceRoot / 默认工作区兜底，而不是新建一个垃圾工作区。
+          const systemPath = path === "/" || path.startsWith("/Applications/") || /^(\/System(\/|$)|\/Library(\/|$)|\/private\/var|\/usr\/|\/opt\/|\/Volumes\/)/.test(path);
+          if (path && !internal && !systemPath) return register(cwd);
         }
         const sourceRoot = String(data.sourceRoot ?? "").trim();
         const sourceWorkspace = sourceRoot ? containing(sourceRoot) : null;
@@ -486,7 +595,25 @@ div[data-sidebar-collapsed]{grid-template-columns:0px minmax(0px,1fr) 0px!import
             let sessionId = String(data.sessionId ?? "").trim();
             if (data.action === "ensure") sessionId = await ensureConversationSession(data);
             if (!sessionId) throw new Error("没有目标会话");
-            if (data.action === "open" || data.action === "ensure") uiWorkspace.openSession(sessionId);
+            /**
+             * F-202B（ADR-0027）：`open !== false` = 把会话切到宿主主区（web 内嵌 iframe 的原语义，
+             * 桌面「在主区打开」的显式入口）；`open:false` = 桌面 Dock 模式——会话已在工作台
+             * 左栏原生渲染，只把会话准备好并回 id，不抢宿主主区。会话目录未就绪时短重试
+             * （`sessions.retain: unknown session...` 是自愈错误，不是会话丢失）。
+             */
+            if ((data.action === "open" || data.action === "ensure") && data.open !== false) {
+              const delays = [0, 300, 700, 1500, 2500];
+              let lastError = null;
+              for (const delay of delays) {
+                if (delay) await new Promise((resolve) => setTimeout(resolve, delay));
+                try { await uiWorkspace.openSession(sessionId); lastError = null; break; } catch (error) {
+                  lastError = error;
+                  if (!/sessions\.retain|unknown session/i.test(String(error?.message ?? error))) throw error;
+                }
+              }
+              if (lastError) throw lastError;
+              if (data.takeMain === true && DESKTOP_SHELL) closeWorkbench();
+            }
             if (data.prompt && data.action === "ensure" && sessionId !== String(data.sessionId ?? "")) {
               await sendToSession(sessionId, String(data.prompt));
             }
@@ -500,6 +627,39 @@ div[data-sidebar-collapsed]{grid-template-columns:0px minmax(0px,1fr) 0px!import
         return () => window.removeEventListener("message", onMessage);
       }, "deck-studio: conversation bridge");
 
+      /* 桌面 Dock 的会话源：工作台（iframe）周期性把当前绑定会话报上来。 */
+      ctx.effect(() => {
+        const onMessage = (event) => {
+          const data = event?.data ?? {};
+          if (data?.type !== "dsh-deck-studio:chat-session" || typeof data.sessionId !== "string") return;
+          if (event.source !== (frameState.el?.contentWindow ?? null)) return;
+          publishDockSession(data.sessionId);
+        };
+        window.addEventListener("message", onMessage);
+        return () => window.removeEventListener("message", onMessage);
+      }, "deck-studio: chat-session bridge");
+
+      /**
+       * F-202B：桌面「原生会话 Dock」——shell.overlay 容器 + session 作用域内容槽
+       * （multichat / html-deck-studio 同款注册形状，SessionProvider 由宿主注入）。
+       * web（http 起源）不用 Dock：工作台 iframe 里的 DSH 对话本来就是好的。
+       */
+      if (DESKTOP_SHELL) {
+        ctx.effect(
+          () => ctx.slots.inject("shell.overlay", () => ctx.slots.register({
+            name: "shell.overlay",
+            id: `${WORKBENCH_KEY}.chat`,
+            order: 58,
+            children: { [CHAT_SLOT]: { kind: "single", scope: "session" } },
+          }, DeckChatDock)),
+          "deck-studio: chat dock",
+        );
+        ctx.effect(
+          () => ctx.slots.inject(CHAT_SLOT, () => ctx.slots.register({ name: CHAT_SLOT }, DeckChatBody)),
+          "deck-studio: chat dock body",
+        );
+      }
+
       if (!chatEmbed) {
         /* 工作台顶栏「☰ DSH」→ 宿主：临时展开 / 收起左侧栏（需要看会话、插件、设置时用）。 */
         ctx.effect(() => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-deck-studio",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "description": "Deckline：DSH 的 image deck / PPT 工作台插件——原生 Chat + 整页图片 deck 工作区 + 设计风格库；用对话做 PPT、按页出图、版本可追踪、导出 PDF/PPTX。",
   "icon": "assets/icon.svg",
   "homepage": "https://github.com/yuna78/dsh-deck-studio#readme",
@@ -45,7 +45,7 @@
   },
   "scripts": {
     "verify": "node verify/smoke.mjs",
-    "prepublishOnly": "node verify/smoke.mjs",
+    "prepublishOnly": "node -e \"const fs=require('fs');const{execSync}=require('child_process');if(fs.existsSync('verify/smoke.mjs')){execSync('node verify/smoke.mjs',{stdio:'inherit'})}else{console.log('[prepublishOnly] verify/ 不在发布目录（公开包白名单不含），跳过；发布前请在开发仓跑 npm run smoke')}\"",
     "prepack": "node scripts/prepack-assets.mjs"
   },
   "dsh": {

package/ui/workbench.css

@@ -479,6 +479,15 @@ body.has-chat .layout{grid-template-columns:var(--nav-w,430px) 5px minmax(0,1fr)
 .chat-session-item span{font-size:9.5px;color:#8a9599}
 .chat-session-empty{margin:6px 8px 8px;font-size:10.5px;color:#8a9599;line-height:1.6}
 #nativeChatFrame{flex:1;min-height:0;width:100%;border:0;background:var(--paper)}
+/* F-202B：桌面宿主（dsh-app://app）不嵌 DSH 页面——工作台对话列留一个 Dock 占位，
+ * 宿主用 shell.overlay 把原生会话精确盖在这里；原生 Dock 不可达时回退 #chatHostCard。 */
+#chatDockArea{flex:1;min-height:0;background:var(--paper)}
+#chatDockArea[hidden]{display:none}
+#chatDockArea:empty::before{content:"还没有绑定会话——点上方 ＋ 新建";margin:44px auto;display:block;width:80%;text-align:center;color:#8a9599;font-size:11px}
+#chatHostCard{flex:1;min-height:0;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:10px;padding:26px 20px;overflow:auto}
+#chatHostCard[hidden]{display:none}
+#chatHostCard .chat-host-hint{margin:0;font-size:11px;line-height:1.7;color:var(--ink);opacity:.78;text-align:center;max-width:30em}
+#chatHostCard .btn{min-width:180px;text-align:center}
 
 /* 叙事结构概览（脚本页顶部，从 script 派生） */
 .story-overview{margin:10px 0 18px;border:1px solid var(--line);border-radius:7px;background:#f8f6f0;padding:10px 14px}

package/ui/workbench.html

@@ -286,6 +286,11 @@
       </div>
       <div class="chat-session-menu" id="chatSessionMenu" hidden></div>
     </div>
+    <div id="chatDockArea" hidden title="这里由宿主渲染原生会话（桌面 Dock）"></div>
+    <div id="chatHostCard" hidden>
+      <p class="chat-host-hint">桌面 App 里内嵌 DSH 页面无法启动（子帧拿不到 boot 注入）。宿主原生会话 Dock 没有就绪——对话将<b>在宿主主区</b>打开，点 ☰ 或左侧栏 Deckline 行切回工作台。</p>
+      <button type="button" class="btn alt" id="chatHostOpen">在宿主主区打开对话 →</button>
+    </div>
     <iframe id="nativeChatFrame" title="DSH 原生对话"></iframe>
   </aside>
   <div class="splitter" data-split="nav" title="拖动调整对话栏宽度" hidden></div>
@@ -583,6 +588,14 @@ let SETTINGS_FORM_DIRTY = false;
 
 const STATE = { sid: null, sessionTitle: "", data: null, selected: null, running: false, demo: false, tab: "deck", entityKind: "", sig: "", docCache: {}, docLoading: null, view: "home", deckId: null, rightTab: "", sessions: [], editorPage: null, ndStyleAbbr: "", designCards: [] };
 const EMBED = new URLSearchParams(location.search).get("embed") === "1";
+/**
+ * F-202B：桌面宿主（自定义协议 `dsh-app://app`）的 DSH 子帧拿不到 boot 注入（`__DSH_BOOT_READY__`
+ * 只注入主帧），流式端点也在子帧 404 —— `/?decklineChat=1` 嵌套实例永远停在「Loading plugins…」。
+ * 桌面上对话改走宿主原生（client.js 的 conversation 桥 → 宿主 uiWorkspace.openSession，会话开在宿主主区）；
+ * web 版（http 起源，如 13090 / 3080）保持 iframe 内嵌不动。
+ */
+const DESKTOP_HOST = !/^(https?:)$/.test(location.protocol)
+  || new URLSearchParams(location.search).get("chatHost") === "panel";
 
 const esc = (v) => String(v ?? "").replace(/[&<>"']/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" }[c]));
 const getEl = (id) => document.getElementById(id);
@@ -4898,6 +4911,7 @@ function decorateNativeChat(doc) {
 
 function setupNativeChat() {
   if (EMBED) return; // embed 模式下宿主 shell 本身就有原生 Chat
+  if (DESKTOP_HOST) return setupHostChatColumn(); // F-202B：桌面不嵌 DSH 页面
   const column = getEl("chatCol");
   const frame = getEl("nativeChatFrame");
   const splitter = document.querySelector('.splitter[data-split="nav"]');
@@ -4937,6 +4951,92 @@ function setupNativeChat() {
   });
 }
 
+/**
+ * 桌面（dsh-app://app）的对话列：不嵌 DSH 页面，把头部保留成「绑定 + 会话切换」，
+ * 动作经宿主桥（client.js）在宿主主区打开原生会话；打开成功后关闭工作台面板。
+ */
+function setupHostChatColumn() {
+  const column = getEl("chatCol");
+  const frame = getEl("nativeChatFrame");
+  const splitter = document.querySelector('.splitter[data-split="nav"]');
+  if (!column || !frame) return;
+  column.hidden = false;
+  if (splitter) splitter.hidden = false;
+  document.body.classList.add("has-chat");
+  frame.hidden = true;
+  getEl("chatDockArea").hidden = false;
+  STATE.dockActive = false;
+  // 降级卡：宿主原生 Dock 没接上（少见；比如 shell.overlay 契约缺失）时，退回「在主区打开」。
+  const fallbackTimer = setTimeout(() => {
+    if (!STATE.dockActive) getEl("chatHostCard").hidden = false;
+  }, 6000);
+  // 心跳把当前绑定会话报给宿主：Dock 据此用原生会话盖住 #chatDockArea。
+  let lastPublished = "§init§";
+  const publishChatSession = () => {
+    const sessionId = currentChatSessionId();
+    if (sessionId === lastPublished) return;
+    lastPublished = sessionId;
+    try { window.parent?.postMessage({ type: "dsh-deck-studio:chat-session", sessionId }, "*"); } catch { /* 宿主桥不可用 */ }
+  };
+  setInterval(publishChatSession, 1200);
+  try { window.parent?.postMessage({ type: "dsh-deck-studio:chat-session", sessionId: lastPublished = currentChatSessionId() }, "*"); } catch { /* 同上 */ }
+  window.addEventListener("message", (event) => {
+    if (event.source !== window.parent) return;
+    if (event.data?.type !== "dsh-deck-studio:chat-dock") return;
+    STATE.dockActive = true;
+    getEl("chatHostCard").hidden = true;
+    clearInterval(fallbackTimer);
+  });
+  getEl("chatBindChip").addEventListener("click", () => {
+    if (!getEl("chatBindChip").classList.contains("unbound")) return;
+    bindCurrentChatToTarget().catch(() => {});
+  });
+  getEl("newChatBtn").addEventListener("click", () => {
+    newChatForTarget().catch(() => {});
+  });
+  // ↗（在 DSH 里打开完整对话）：桌面=显式把会话开到宿主主区；web=开独立窗口。
+  getEl("expandChatBtn").addEventListener("click", () => takeMainAreaOnHost());
+  getEl("chatHostOpen").addEventListener("click", () => takeMainAreaOnHost());
+  getEl("chatSessionBtn").addEventListener("click", (event) => {
+    event.stopPropagation();
+    toggleChatSessionMenu();
+  });
+  document.addEventListener("click", (event) => {
+    const menu = getEl("chatSessionMenu");
+    if (menu.hidden) return;
+    if (menu.contains(event.target) || event.target.closest?.("#chatSessionBtn")) return;
+    menu.hidden = true;
+  });
+  document.addEventListener("keydown", (event) => {
+    if (event.key === "Escape") getEl("chatSessionMenu").hidden = true;
+  });
+  document.body.classList.add("desktop-host");
+  refreshSessions().then(renderChatHeader).catch(() => renderChatHeader());
+}
+
+/** 桌面：显式把会话开到宿主主区（优先当前会话，其次最近绑定，再不行 ensure 一个）。
+ * 成功后宿主关闭工作台面板——这是唯一的「跳出工作台」路径。 */
+async function takeMainAreaOnHost() {
+  const target = activeChatTarget();
+  const current = currentChatSessionId();
+  const target_ = target;
+  const bound = target_ ? chatSessionsForTarget(target_) : [];
+  const sessionId = current || bound[0]?.sessionId || "";
+  return requestConversation({
+    action: sessionId ? "open" : "ensure",
+    sessionId,
+    kind: target_?.kind,
+    id: target_?.id,
+    title: target_?.label,
+    takeMain: true,
+    prompt: sessionId
+      ? undefined
+      : target_
+        ? `本对话绑定 ${target_.kind === "deck" ? `deck ${target_.id}（${target_.label}）` : `风格设计 ${target_.label}`}。等我的指令，不要直接出图。`
+        : undefined,
+  });
+}
+
 function copyText(text) {
   try {
     navigator.clipboard.writeText(text);
@@ -4946,13 +5046,13 @@ function copyText(text) {
   }
 }
 
-/** 工作台 → 原生 Chat 的窗口：非 embed 用左栏自己的 iframe，embed 用宿主 DSH 壳。 */
+/** 工作台 → 原生 Chat 的窗口：非 embed 用左栏自己的 iframe；embed / 桌面用宿主 DSH 壳。 */
 function nativeChatWindow() {
-  if (!EMBED) {
+  if (!EMBED && !DESKTOP_HOST) {
     const frame = getEl("nativeChatFrame");
     return frame && frame.contentWindow ? frame.contentWindow : null;
   }
-  return window.parent !== window ? window.parent : null; // embed：宿主 DSH 壳
+  return window.parent !== window ? window.parent : null; // embed / 桌面：宿主 DSH 壳
 }
 
 function requestNativeChat(text) {
@@ -5008,6 +5108,9 @@ function requestConversation(payload) {
       workspacePath: STATE.data?.workspacePath || "",
       sourceRoot: STATE.data?.active?.sourceRoot || "",
       ...payload,
+      // F-202B：桌面 Dock 模式默认不抢主区（open:false）；显式 takeMain → open:true 切宿主主区。
+      // web 不传 open（undefined → 宿主按原语义 openSession）。
+      open: DESKTOP_HOST ? payload.takeMain === true : undefined,
     }, "*");
     setTimeout(() => {
       if (settled) return;
@@ -5075,6 +5178,8 @@ async function ensureDeckConversation(deckId) {
     kind: "deck",
     id: deckId,
     title: label,
+    // 桌面：点 deck 是进工作台，不是切出去聊天——后台 ensure，不切换宿主视图。
+    
     prompt: `本对话绑定 deck ${deckId}（${label}）。后续所有修改都在这个 deck 上进行；先读 intent 与 script 概要，等我的指令，不要直接出图。`,
   });
   if (!result.ok) {
@@ -5127,6 +5232,12 @@ async function openBoundConversation(sessionId) {
     getEl("homeGreetSub").textContent = `没能切到会话：${result.reason || "未知原因"}`;
     return;
   }
+  if (DESKTOP_HOST) {
+    // 桌面：用户点会话就是要对话；宿主主区已切到该会话，收起工作台（回工作台时再对齐到绑定的 deck）。
+    STATE.chatSessionId = sessionId;
+    showDeck(binding?.kind === "deck" ? binding.id : null);
+    return;
+  }
   if (binding?.kind === "deck") {
     showDeck(binding.id);
     return;
@@ -5170,8 +5281,11 @@ function activeChatTarget() {
   return chatTargetForBinding({ kind: "deck", id: active.deckId });
 }
 
-/** 当前 Chat 所在会话 id：优先读 iframe 里 shell 的 dsh.sessions.current（同源），退回本地记录。 */
+/** 当前 Chat 所在会话 id：优先读 iframe 里 shell 的 dsh.sessions.current（同源），退回本地记录。
+ * F-202B：桌面宿主不读——隐藏 iframe 继承 dsh-app origin，localStorage 就是
+ * 宿主 shell 的存储，读到的是「宿主当前会话」而不是本 deck 绑定会话（Dock 被它顶掉）。 */
 function currentChatSessionId() {
+  if (DESKTOP_HOST) return STATE.chatSessionId || "";
   try {
     const win = getEl("nativeChatFrame")?.contentWindow;
     const raw = win?.localStorage?.getItem("dsh.sessions.current");
@@ -5284,6 +5398,7 @@ function renderChatSessionMenu(sessions, target) {
     STATE.chatSessionId = sessionId;
     await refreshSessions();
     renderChatHeader();
+    // 桌面：会话已在宿主主区打开，把工作台面板让出来（web 版留在内嵌 iframe 里）。
   }));
 }
 
@@ -5482,6 +5597,9 @@ async function newChatForTarget() {
   try {
     const result = await requestConversation({ action: "ensure", kind: target.kind, id: target.id, title: target.label });
     if (!result.ok || !result.sessionId) {
+      // F-202B：失败要用户可见——之前只写按钮 title，Dock 模式下看起来像「点了没反应」。
+      getEl("chatBindChip").textContent = "会话新建失败";
+      getEl("chatBindChip").title = `新建会话失败：${result.reason || "未知原因"}；点这里重试`;
       getEl("chatSessionBtn").title = `新建会话失败：${result.reason || "未知原因"}`;
       return;
     }
@@ -5489,6 +5607,7 @@ async function newChatForTarget() {
     await bindConversation({ sessionId: result.sessionId, kind: target.kind, id: target.id, title: target.label });
     await refreshSessions();
     renderChatHeader();
+    // 桌面：新建就是要点开聊——切到宿主主区的原生会话。
   } finally {
     button.disabled = false;
   }
@@ -5761,7 +5880,7 @@ function backToManual(box) {
   getEl("updateBtn").addEventListener("click", checkPluginUpdate);
   getEl("repoBtn").addEventListener("click", openRepo);
   await refreshSessions();
-  getEl("save").textContent = EMBED ? "对话在 DSH 原生 Chat" : "对话在左侧 · DSH 原生";
+  getEl("save").textContent = EMBED ? "对话在 DSH 原生 Chat" : DESKTOP_HOST ? "对话 · 原生（桌面 Dock）" : "对话在左侧 · DSH 原生";
   // F-69：只有 profile 开了 hideShellSidebar，宿主左侧栏才会默认收起；此时顶栏给一个切换入口。
   if (!EMBED && window.parent !== window && STATE.data?.hideShellSidebar === true) {
     const shellBtn = getEl("shellSidebarBtn");