dsh-plugin-deck-studio 0.2.12 → 0.2.14

package/client.js

@@ -5,8 +5,8 @@
  * 数据全部由宿主半聚合好（浏览器半只做展示，不重算业务口径）。
  *
  * 形态：主区「Deck 工作台」面板（iframe 复用 /api/deck-studio.app?embed=1）。
- * 启动后自动打开（零点击进入），左侧 foote 只保留一个「Deckline」入口用于重新打开；
- * 不再注册右侧 dockkit 观测标签页（F-63：入口太多且丑）。
+ * 启动后自动打开（零点击进入），侧栏只保留一个带图标的「Deckline」面板入口（与其它插件同形态）；
+ * 不再注册右侧 dockkit 观测标签页（F-63：入口太多且丑），也不再占用侧栏脚部按钮。
  * 宿主没有 layout 主区面板契约时降级为 main 面板 + sidebar.panellist。
  *
  * Chatbox 说明（ADR-0006 D1）：对话入口就是 DSH 原生 Chat——选择
@@ -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) {
@@ -235,9 +243,34 @@ div[data-sidebar-collapsed]{grid-template-columns:0px minmax(0px,1fr) 0px!import
       );
     }
 
-    /** 侧栏 glyph（降级 panellist / footer 用）。 */
-    function DeckGlyph() {
-      return h("span", { style: { fontSize: 13 } }, "▦");
+    /** 侧栏图标（panellist 行用）：叠卡片 + 星芒，单色 currentColor，跟随主题深浅色。 */
+    function DeckGlyph({ size }) {
+      const edge = size || 16;
+      return h("svg", {
+        width: edge,
+        height: edge,
+        viewBox: "0 0 16 16",
+        fill: "none",
+        "aria-hidden": "true",
+        style: { display: "block" },
+      },
+        h("rect", {
+          x: 4.8, y: 2.4, width: 8.2, height: 6.2, rx: 1.5,
+          stroke: "currentColor", strokeWidth: 1.2, opacity: 0.55,
+        }),
+        h("rect", {
+          x: 2.4, y: 5.2, width: 9.2, height: 6.8, rx: 1.6,
+          stroke: "currentColor", strokeWidth: 1.35,
+        }),
+        h("path", {
+          d: "M4.6 7.6h4.6M4.6 9.6h3",
+          stroke: "currentColor", strokeWidth: 1.2, strokeLinecap: "round",
+        }),
+        h("path", {
+          d: "M12.5 9.9l.45 1.15 1.15.45-1.15.45-.45 1.15-.45-1.15-1.15-.45 1.15-.45z",
+          fill: "currentColor",
+        }),
+      );
     }
 
     function MainPanel() {
@@ -249,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" },
@@ -261,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";
@@ -406,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;
@@ -461,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));
             }
@@ -475,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(() => {
@@ -535,17 +720,16 @@ div[data-sidebar-collapsed]{grid-template-columns:0px minmax(0px,1fr) 0px!import
           return () => window.clearTimeout(timer);
         }, "deck-studio: auto-open workbench");
 
-        // 唯一入口：侧栏脚部一个「Deckline」按钮（重新打开工作台）；→ 对话用工作台里的「← 回到对话」。
+        // 唯一入口：侧栏面板行「Deckline」（与 plugins / schedules 等插件同一种形态，带图标）；
+        // → 对话用工作台里的「← 回到对话」。
         if (hasRightbar) {
-          ctx.effect(
-            () => ctx.slots.inject("sidebar.footer.action", () =>
-              ctx.slots.register({ name: "sidebar.footer.action", id: `${PLUGIN_ID}-workbench` }, (props) => {
-                const button = h("button", { onClick: openWorkbench, title: "打开 Deck 工作台（对话在 DSH 原生 Chat）", style: { cursor: "pointer" } },
-                  h("span", { style: { fontSize: 13 } }, "▤"), props?.wide ? h("span", { style: { marginLeft: 4 } }, "Deckline") : null);
-                return button;
-              })),
-            "deck-studio: workbench footer button",
-          );
+          if (layout?.selectPanel) {
+            ctx.effect(
+              () => ctx.slots.inject("sidebar.panellist", () =>
+                ctx.slots.register({ name: "sidebar.panellist", id: WORKBENCH_KEY, order: 46, label: () => "Deckline" }, DeckGlyph)),
+              "deck-studio: workbench sidebar entry",
+            );
+          }
           ctx.logger?.info?.("deck-studio client: workbench-only mode");
         } else {
           ctx.effect(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-deck-studio",
-  "version": "0.2.12",
+  "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/seeds/docs/install.en.md

@@ -43,7 +43,7 @@ node -v && pnpm -v && dsh --version
 dsh --profile deckline --from-default-profile web
 
 # 2) install the plugin; dsh plugin add adds the bundle to the profile and enables it
-dsh plugin --profile deckline add dsh-plugin-deck-studio@0.2.12
+dsh plugin --profile deckline add dsh-plugin-deck-studio@0.2.13
 ```
 
 > Do not skip step 1: the `deckline` profile is **never created automatically**. Running
@@ -181,7 +181,7 @@ From zero to 13090, run these three commands in order (options for steps 1–2 a
 dsh --profile deckline --from-default-profile web
 
 # 2) install the plugin (adds it to that profile and enables it)
-dsh plugin --profile deckline add dsh-plugin-deck-studio@0.2.12
+dsh plugin --profile deckline add dsh-plugin-deck-studio@0.2.13
 
 # 3) start
 dsh --profile deckline --port 13090

package/seeds/docs/install.md

@@ -45,7 +45,7 @@ node -v && pnpm -v && dsh --version
 dsh --profile deckline --from-default-profile web
 
 # 2) 装插件；dsh plugin add 会自动把组合包加入 profile 并默认启用
-dsh plugin --profile deckline add dsh-plugin-deck-studio@0.2.12
+dsh plugin --profile deckline add dsh-plugin-deck-studio@0.2.13
 ```
 
 > 第 1 步不能省：`deckline` profile **不会**被自动创建。跳过第 1 步直接 `dsh --profile deckline --port 13090`，
@@ -54,7 +54,7 @@ dsh plugin --profile deckline add dsh-plugin-deck-studio@0.2.12
 
 > 国内网络直连 `registry.npmjs.org` 可能很慢（20 MB 包实测约 19 KB/s，要十几分钟）。换镜像会快很多：
 > ```sh
-> npm_config_registry=https://registry.npmmirror.com dsh plugin --profile deckline add dsh-plugin-deck-studio@0.2.12
+> npm_config_registry=https://registry.npmmirror.com dsh plugin --profile deckline add dsh-plugin-deck-studio@0.2.13
 > ```
 > 或一次性 `npm config set registry https://registry.npmmirror.com`。
 
@@ -75,7 +75,7 @@ DSH 目前没有官方插件市场，市场是「索引源」模式：添加下
    https://raw.githubusercontent.com/yuna78/dsh-deck-studio/main/market-index.json
    ```
 
-3. 搜索 `Deckline` 或 `PPT` → **安装**，会安装 `dsh-plugin-deck-studio@0.2.12`（索引里声明了国内镜像 registry）。
+3. 搜索 `Deckline` 或 `PPT` → **安装**，会安装 `dsh-plugin-deck-studio@0.2.13`（索引里声明了国内镜像 registry）。
 4. 之后同 A 的第 3 步启动。
 
 索引文件就是仓库根目录的 [`market-index.json`](../market-index.json)（格式 1），新版本发布后更新版本号即可。
@@ -210,7 +210,7 @@ profile "deckline" does not exist
 dsh --profile deckline --from-default-profile web
 
 # 2) 装插件（自动加进该 profile 并启用）
-dsh plugin --profile deckline add dsh-plugin-deck-studio@0.2.12
+dsh plugin --profile deckline add dsh-plugin-deck-studio@0.2.13
 
 # 3) 启动
 dsh --profile deckline --port 13090

package/ui/workbench.css

@@ -238,6 +238,44 @@ body.resizing{user-select:none;cursor:col-resize}
 .hn-label{flex:1}
 .home-nav-item em{font-style:normal;font-size:10px;color:#93a0a3;background:#fffdf8;border:1px solid var(--line);border-radius:9px;padding:0 5px}
 .home-nav-item.active em{color:var(--teal);border-color:#bfe0dc}
+/* F-193/F-194：左栏「关于」单入口（版本 chip + 有新版小圆点） */
+.home-nav-sep{height:1px;background:var(--line);margin:10px 4px 0}
+.hn-dot{width:6px;height:6px;border-radius:50%;background:var(--gold);box-shadow:0 0 0 3px color-mix(in srgb,var(--gold) 18%,transparent)}
+.hn-dot[hidden]{display:none}
+/* F-194：「关于」单页——从上到下：作者 → 公众号 → 版本 → 开源 → 其他项目 */
+.about-stack{display:flex;flex-direction:column;gap:12px;max-width:880px}
+.about-card{border:1px solid var(--line);background:#fffdf8;border-radius:10px;padding:16px 18px;min-width:0}
+.about-card h3{display:flex;align-items:baseline;gap:8px;flex-wrap:wrap;margin:0 0 8px;font-family:"Noto Serif SC",Georgia,serif;font-size:16px;color:var(--ink)}
+.about-role{font-family:Inter,-apple-system,sans-serif;font-size:10.5px;font-weight:400;color:#93a0a3;letter-spacing:.02em}
+.about-hero{display:flex;flex-direction:column;gap:14px;background:linear-gradient(180deg,#fffdf8 0%,#faf5e9 100%)}
+.about-profile{display:flex;gap:14px;align-items:center;min-width:0}
+.about-wechat{display:flex;align-items:center;gap:14px;border-top:1px solid var(--line);padding-top:13px}
+.about-wechat-text{flex:1;min-width:0;display:flex;flex-direction:column;gap:2px}
+.about-wechat b{font-size:13px;color:var(--teal);line-height:1.5}
+.about-wechat .eyebrow{color:#93a0a3}
+.about-wechat .about-hint{margin:2px 0 0}
+.about-wechat .about-qr{flex:0 0 auto;width:104px;max-width:104px;border-radius:7px}
+.about-avatar{flex:0 0 auto;width:58px;height:58px;border-radius:14px;display:flex;align-items:center;justify-content:center;font-family:"Noto Serif SC",Georgia,serif;font-size:24px;color:#fffdf8;background:linear-gradient(145deg,#0e5563,#08343d);box-shadow:inset 0 0 0 1px #ffffff22}
+.about-profile-body{min-width:0;max-width:560px}
+.about-desc{margin:0 0 8px;color:#5d7276;font-size:12px;line-height:1.65}
+.about-line{margin:0 0 4px;color:#728086;font-size:11.5px}
+.about-line b{color:var(--teal)}
+.about-line code{font-size:11px;color:#5d7276;background:#f3efe4;border:1px solid var(--line);border-radius:5px;padding:1px 5px}
+.about-hint{margin:8px 0 0;color:#93a0a3;font-size:10.5px;line-height:1.6;word-break:break-word}
+.about-actions{display:flex;gap:8px;flex-wrap:wrap;margin-top:10px}
+.about-actions .btn{font-size:11px}
+.about-state{margin:8px 0 0;color:var(--gold)}
+.about-qr{display:block;width:140px;max-width:140px;aspect-ratio:1;object-fit:contain;border:1px solid var(--line);border-radius:8px;background:#fff}
+.about-qr-empty{display:flex;align-items:center;justify-content:center;width:140px;aspect-ratio:1;color:#93a0a3;font-size:11px;border:1px dashed var(--line);border-radius:8px;background:#f8f5ed;text-align:center;padding:8px}
+.about-project-list{list-style:none;margin:2px 0 0;padding:0}
+.about-project-row{display:flex;gap:14px;align-items:flex-start;justify-content:space-between;padding:12px 0;border-top:1px solid var(--line)}
+.about-project-row:first-child{border-top:0;padding-top:2px}
+.about-project-main{flex:1;min-width:0}
+.about-project-head{display:flex;align-items:center;gap:8px;flex-wrap:wrap}
+.about-project-head b{font-size:13px;color:var(--ink)}
+.about-badge{flex:0 0 auto;font-size:10px;color:var(--teal);background:#e2f1ef;border:1px solid #bfe0dc;border-radius:9px;padding:1px 7px}
+.about-project-row .about-desc{margin:4px 0 0}
+.about-project-row .btn{flex:0 0 auto}
 .home-main{padding:26px 32px;overflow-y:auto;min-width:0}
 .home-greet{padding-bottom:16px;border-bottom:1px solid var(--line);margin-bottom:18px}
 .home-greet h1{margin:5px 0 4px;font-family:"Noto Serif SC",Georgia,serif;font-size:30px;color:var(--ink);letter-spacing:.01em}
@@ -441,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

@@ -134,6 +134,11 @@
       <button class="home-nav-item" data-section="resources"><span class="hn-icon">◇</span><span class="hn-label">资源库</span><em id="navCountResources">0</em></button>
       <button class="home-nav-item" data-section="conversations"><span class="hn-icon">☰</span><span class="hn-label">Conversations</span><em id="navCountConvs">0</em></button>
       <button class="home-nav-item" data-section="manual"><span class="hn-icon">?</span><span class="hn-label">使用手册</span></button>
+      <!-- F-193/F-194：关于只留一页入口；版本 chip + 有新版小圆点仍常驻，升级入口不藏在顶栏图标里 -->
+      <div class="home-nav-sep" aria-hidden="true"></div>
+      <button class="home-nav-item" data-section="about" id="aboutNavBtn" title="关于 Deckline：版本 / 公众号 / 开源地址 / 其他项目">
+        <span class="hn-icon">☺</span><span class="hn-label">关于</span><em id="navUpdateVer">—</em><i class="hn-dot" id="navUpdateDot" hidden></i>
+      </button>
     </nav>
   </aside>
   <main class="home-main">
@@ -281,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>
@@ -578,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);
@@ -1449,8 +1467,8 @@ async function copyDataDirDiagnostics() {
 
 /* ---------------- 首页（左侧导航 + 右侧分区 blocks） ---------------- */
 
-const HOME_SECTIONS = ["decks", "designs", "resources", "conversations", "manual"];
-const HOME_TITLES = { decks: "Decks", designs: "Designs", resources: "资源库", conversations: "Conversations" };
+const HOME_SECTIONS = ["decks", "designs", "resources", "conversations", "manual", "about"];
+const HOME_TITLES = { decks: "Decks", designs: "Designs", resources: "资源库", conversations: "Conversations", manual: "使用手册", about: "关于" };
 
 function homeDateText() {
   const now = new Date();
@@ -1531,6 +1549,7 @@ function renderHome() {
     resources: `${resources.length} 个资源（logo / 素材）；点开预览。`,
     conversations: `${sessions.length} 个历史会话；点一个继续聊。`,
     manual: "从新建到导出：截图 + 步骤；找不到就直接在 Chat 里问。",
+    about: "作者 / 公众号 / 版本更新 / 开源地址 / 其他项目，都在这一页。",
   }[section];
   getEl("homeGreetSub").textContent = greet;
 
@@ -1550,8 +1569,22 @@ function renderHome() {
     if (STATE.manualDoc) openManualDoc(box, STATE.manualDoc);
     else renderManualHome(box);
   }
+  else if (section === "about") {
+    box.innerHTML = renderHomeAbout(resources);
+    paintUpdate(); // 版本 chip / 更新状态在关于页也要跟着顶栏走（F-193）
+  }
   else box.innerHTML = renderHomeConversations(sessions, bindings);
 
+  // F-193：「关于」分区里的按钮（检查更新 / 外链）——外链直接开新标签。
+  box.querySelectorAll("[data-about-check]").forEach((node) => node.addEventListener("click", () => checkPluginUpdate()));
+  box.querySelectorAll("[data-about-external]").forEach((node) => node.addEventListener("click", () => {
+    const links = aboutLinks();
+    const kind = node.dataset.aboutExternal;
+    if (kind === "repo") openExternalUrl(links.repo, "还没拿到仓库地址");
+    else if (kind === "issues") openExternalUrl(links.issues, "还没拿到提建议地址");
+    else if (kind === "profile") openExternalUrl(links.profile, "还没拿到 GitHub 主页地址");
+  }));
+
   box.querySelectorAll("[data-home-deck]").forEach((node) => node.addEventListener("click", async () => {
     const deckId = node.dataset.homeDeck;
     // 先等 deck 切完（iframe 里的 Chat 也要加载完），再选默认会话——否则 postMessage 发早了会落到旧会话。
@@ -1711,6 +1744,90 @@ function renderHomeResources(resources) {
       </button>`).join("")}</div>`;
 }
 
+/* ---------------- F-193 / F-194：首页「关于」单页（作者 → 公众号 → 版本 → 开源 → 其他项目） ---------------- */
+
+/** 公众号二维码从资源库现取（个人二维码不进仓库）；拿不到就降级成说明，不显示破图。 */
+function aboutWechatQr(resources = []) {
+  return resources.find((resource) => /二维码|qr|微信|wechat/i.test(`${resource?.name || ""} ${resource?.description || ""} ${resource?.url || ""}`)) || null;
+}
+
+function renderHomeAbout(resources = []) {
+  const links = aboutLinks();
+  const qr = aboutWechatQr(resources);
+  const versionLine = UPDATE.current ? `v${UPDATE.current}` : "读取中…";
+  const installNote = UPDATE.installMode === "linked"
+    ? "本机是开发链接安装（link:/file:）：更新走仓库，界面不执行 pnpm。"
+    : UPDATE.installMode === "npm"
+      ? "npm 安装：有新版可以在这里直接更新，重启 DSH 生效。"
+      : "没识别出安装方式时，可手动 dsh plugin add。";
+  const repoShort = links.repo.replace(/^https?:\/\//, "");
+  const projectRows = [
+    { name: "Deckline · dsh-deck-studio", badge: "本插件", external: "repo", desc: "DSH 的 image deck / PPT 工作台：故事线、逐页 prompt、AI 出图与版本留存、风格库、导出 PDF/PPTX。" },
+  ];
+  if (links.profile) {
+    projectRows.push({
+      name: `GitHub @${links.profile.split("/").pop()}`,
+      badge: "全部项目",
+      external: "profile",
+      desc: "我的开源主页：插件、实验和工具会陆续挂在这里。",
+    });
+  }
+  return `<div class="section-head"><h2>关于</h2><span class="small">作者 · 公众号 · 版本更新 · 开源</span></div>
+  <div class="about-stack">
+    <section class="about-card about-hero">
+      <div class="about-profile">
+        <div class="about-avatar" aria-hidden="true">Y</div>
+        <div class="about-profile-body">
+          <h3>${esc(ABOUT.author)}<span class="about-role">${esc(ABOUT.role)}</span></h3>
+          <p class="about-desc">${esc(ABOUT.intro)}</p>
+        </div>
+      </div>
+      <div class="about-wechat">
+        <div class="about-wechat-text">
+          <div class="eyebrow">微信公众号</div>
+          <b>${esc(ABOUT.account)}</b>
+          <p class="about-hint">${qr ? "扫码关注 / 加我微信" : `把二维码图片放进数据目录的 <code>resources/</code>（资源库），这里会自动显示。`}</p>
+        </div>
+        ${qr
+          ? `<img class="about-qr" src="${esc(qr.url)}" alt="${esc(qr.name || "公众号二维码")}" loading="lazy">`
+          : `<div class="about-qr about-qr-empty">二维码未收录</div>`}
+      </div>
+    </section>
+
+    <section class="about-card">
+      <h3>版本与更新</h3>
+      <p class="about-line">当前版本 <b>${esc(versionLine)}</b></p>
+      <p class="about-desc">${esc(installNote)}</p>
+      <div class="about-actions">
+        <button class="btn" data-about-check>检查新版本</button>
+      </div>
+      <p class="small about-state" data-about-state></p>
+    </section>
+    <section class="about-card">
+      <h3>开源地址与反馈</h3>
+      <p class="about-line"><code>${esc(repoShort)}</code></p>
+      <p class="about-desc">用着不对、想要什么功能，直接提 issue；仓库里能看到版本记录与路线。</p>
+      <div class="about-actions">
+        <button class="btn ghost" data-about-external="repo">仓库地址</button>
+        <button class="btn alt" data-about-external="issues">提交建议 / 问题</button>
+      </div>
+    </section>
+    <section class="about-card">
+      <h3>其他开源项目</h3>
+      <ul class="about-project-list">${projectRows.map((row) => `
+        <li class="about-project-row">
+          <div class="about-project-main">
+            <div class="about-project-head"><b>${esc(row.name)}</b><span class="about-badge">${esc(row.badge)}</span></div>
+            <p class="about-desc">${esc(row.desc)}</p>
+          </div>
+          <button class="btn ghost" data-about-external="${esc(row.external)}">打开</button>
+        </li>`).join("")}
+      </ul>
+      <p class="about-hint">最新列表以 GitHub 主页为准；想第一时间看到更新，关注公众号「${esc(ABOUT.account)}」。</p>
+    </section>
+  </div>`;
+}
+
 function renderHomeConversations(sessions, bindings = []) {
   const bound = new Map((bindings || []).map((binding) => [binding.sessionId, binding]));
   const targetLabel = (binding) => {
@@ -1813,19 +1930,55 @@ function dlToast(text, ms = 4200) {
 /** F-188：更新状态（版本 / 安装方式 / 仓库链接）由 workbench payload 带下来。 */
 const UPDATE = { current: "", latest: "", hasUpdate: false, installMode: "", repo: "", suggest: "", note: "" };
 
+/** F-193：左栏「关于」分组用的作者 / 公众号信息；仓库链接优先用包里的 repository，兜底写死公开地址。 */
+const ABOUT = {
+  author: "Yuna",
+  role: "Deckline 作者",
+  account: "Yuna 的 AI 修炼手册",
+  intro: "把 AI 落到工作现场：用对话把分享、培训、汇报做成整页图片 deck。",
+  fallbackRepo: "https://github.com/yuna78/dsh-deck-studio",
+};
+
+function aboutLinks() {
+  const repo = UPDATE.repo || ABOUT.fallbackRepo;
+  const issues = UPDATE.suggest || UPDATE.issues || `${repo.replace(/\/+$/, "")}/issues/new/choose`;
+  const profile = repo.replace(/^https?:\/\/(?:www\.)?github\.com\/([^/]+).*$/i, "https://github.com/$1");
+  return { repo, issues, profile: profile === repo ? "" : profile };
+}
+
+/** 外链统一走这里：拿不到地址时给 toast，不让按钮静默没反应。 */
+function openExternalUrl(url, missingMessage) {
+  if (!url) {
+    dlToast(missingMessage || "链接还没拿到：插件包或运行环境里没有配置地址", 5000);
+    return;
+  }
+  window.open(url, "_blank", "noopener");
+}
+
 function paintUpdate() {
   const ver = getEl("updateVer");
   if (ver) ver.textContent = UPDATE.current ? `v${UPDATE.current}` : "—";
   const dot = getEl("updateDot");
   if (dot) dot.hidden = !UPDATE.hasUpdate;
+  const title = UPDATE.hasUpdate
+    ? `有新版 v${UPDATE.latest}（当前 v${UPDATE.current}）`
+    : UPDATE.installMode === "linked"
+      ? "本机是开发链接安装：更新走 git pull"
+      : "检查更新";
   const btn = getEl("updateBtn");
-  if (btn) {
-    btn.title = UPDATE.hasUpdate
-      ? `有新版 v${UPDATE.latest}（当前 v${UPDATE.current}）`
-      : UPDATE.installMode === "linked"
-        ? "本机是开发链接安装：更新走 git pull"
-        : "检查更新";
-  }
+  if (btn) btn.title = title;
+  // F-193：左栏「检查新版本」与顶栏 ↻ 共用同一份状态（版本 chip + 有新版小圆点）
+  const navVer = getEl("navUpdateVer");
+  if (navVer) navVer.textContent = UPDATE.current ? `v${UPDATE.current}` : "—";
+  const navDot = getEl("navUpdateDot");
+  if (navDot) navDot.hidden = !UPDATE.hasUpdate;
+  const aboutNavBtn = getEl("aboutNavBtn");
+  if (aboutNavBtn) aboutNavBtn.title = UPDATE.hasUpdate ? `关于 Deckline · ${title}` : "关于 Deckline：版本 / 公众号 / 开源地址 / 其他项目";
+  const aboutState = document.querySelectorAll("[data-about-state]");
+  aboutState.forEach((node) => {
+    // 只在「有新版」时占用这行；「当前版本」上面已经写过了，别重复。
+    node.textContent = UPDATE.hasUpdate ? `发现新版 v${UPDATE.latest}（当前 v${UPDATE.current}）` : "";
+  });
 }
 
 function absorbUpdate(payload) {
@@ -4758,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"]');
@@ -4797,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);
@@ -4806,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) {
@@ -4868,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;
@@ -4935,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) {
@@ -4987,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;
@@ -5030,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");
@@ -5144,6 +5398,7 @@ function renderChatSessionMenu(sessions, target) {
     STATE.chatSessionId = sessionId;
     await refreshSessions();
     renderChatHeader();
+    // 桌面：会话已在宿主主区打开，把工作台面板让出来（web 版留在内嵌 iframe 里）。
   }));
 }
 
@@ -5342,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;
     }
@@ -5349,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;
   }
@@ -5621,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");
@@ -5636,7 +5895,7 @@ function backToManual(box) {
     getEl("workspaceView").style.display = "grid";
     switchChatToBoundSession().catch(() => {});
   } else {
-    const match = location.hash.match(/^#\/home\/(decks|designs|resources|conversations|manual)/);
+    const match = location.hash.match(/^#\/home\/(decks|designs|resources|conversations|manual|about)/);
     STATE.homeSection = match ? match[1] : "decks";
     showHome();
   }