dsh-plugin-deck-studio 0.2.14 → 0.2.24

package/client.js

@@ -339,8 +339,62 @@ div[data-sidebar-collapsed]{grid-template-columns:0px minmax(0px,1fr) 0px!import
         const session = useSession((value) => value);
         const active = useConversation((value) => value).activeTargets;
         const phase = (!session.blank || session.running || active.size > 0) ? "active" : "hero";
+        /**
+         * 0.2.23：**回退** 0.2.22 的 sessionId 透传。
+         *
+         * 为什么当时要透传：宿主的 composer 链是
+         *   useSessionStatus(s => s.get(sessionId)?.pendingInteraction) → renderSlotChain(...)
+         * 审批面板要靠 pendingInteraction 才渲染，我们没传 sessionId 就永远不弹 ask。
+         *
+         * 为什么回退：透传之后真机上「点会话 → 工作台闪出 → 不到 1s 整片变灰」——
+         * 说明在 shell.overlay 这个上下文里让 composer 链去查宿主的主区 pendingInteraction 会直接崩掉
+         * 整棵 Dock 子树（外面看不到原因，只看到灰屏）。宁可先保住对话可用，再想别的办法把 ask 露出来。
+         */
         return renderFactorySlot("conversation.content", { variant: "embedded", phase, hero: phase === "hero" }, { slots: { views: DeckChatView } });
       }
+
+      /**
+       * 0.2.23：Dock 子树的错误边界。
+       *
+       * 之前 slot 里任何一个组件抛错，整个 overlay 会变成一片空白灰，用户完全不知道发生了什么
+       * （这次灰屏就是）。用边界把错误收住，至少把原因写在屏幕上 + 给重试和「去主区对话」的出路。
+       */
+      class DockErrorBoundary extends React.Component {
+        constructor(props) {
+          super(props);
+          this.state = { error: null };
+        }
+        static getDerivedStateFromError(error) {
+          return { error };
+        }
+        componentDidCatch(error) {
+          try {
+            ctx.logger?.warn?.("deck-studio: chat dock crashed", error);
+          } catch {
+            /* 日志不可用时忽略 */
+          }
+        }
+        render() {
+          if (!this.state.error) return this.props.children;
+          const message = String(this.state.error?.message ?? this.state.error ?? "未知错误");
+          return h(
+            "div",
+            { style: { height: "100%", padding: 16, overflow: "auto", background: "#fdf7f3", color: "#7a3b2e", fontSize: 12, lineHeight: 1.7 } },
+            h("div", { style: { fontWeight: 600, marginBottom: 6 } }, "对话区加载失败"),
+            h("div", { style: { color: "#5c6464", wordBreak: "break-word" } }, message),
+            h(
+              "button",
+              {
+                type: "button",
+                style: { marginTop: 10, marginRight: 8, padding: "4px 10px", fontSize: 12, cursor: "pointer" },
+                onClick: () => this.setState({ error: null }),
+              },
+              "重试",
+            ),
+            h("div", { style: { marginTop: 10, color: "#5c6464" } }, "也可以点顶栏「☰ DSH」去宿主主区的对话里继续。"),
+          );
+        }
+      }
       /** Dock：测量工作台对话占位矩形；用 retain 的会话引用喂 SessionProvider。 */
       function DeckChatDock({ SessionProvider, renderSlot }) {
         const sessionId = React.useSyncExternalStore(subscribeDockSession, () => dockState.sessionId);
@@ -389,10 +443,18 @@ div[data-sidebar-collapsed]{grid-template-columns:0px minmax(0px,1fr) 0px!import
           try { frameEl.contentWindow.postMessage({ type: "dsh-deck-studio:chat-dock" }, "*"); } catch { /* 不可达时降级卡留着 */ }
         }, [rect, reference]);
         if (!SessionProvider || !renderSlot || !reference || !rect) return null;
+        // 0.2.23：把覆盖层夹在可视区内。测量一旦拿到「整窗」尺寸（面板刚切换、iframe 还没布局），
+        // 这个 fixed 覆盖层会把整个应用盖住，看起来就是「整片灰、啥也没有」。
+        const viewportW = typeof window !== "undefined" ? window.innerWidth : rect.width;
+        const viewportH = typeof window !== "undefined" ? window.innerHeight : rect.height;
+        const left = Math.max(0, Math.min(rect.left, Math.max(0, viewportW - 120)));
+        const top = Math.max(0, Math.min(rect.top, Math.max(0, viewportH - 120)));
+        const width = Math.max(120, Math.min(rect.width, viewportW - left));
+        const height = Math.max(160, Math.min(rect.height, viewportH - top));
         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, {})));
+          style: { position: "fixed", left: `${left}px`, top: `${top}px`, width: `${width}px`, height: `${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(DockErrorBoundary, null, h(SessionProvider, { session: reference }, renderSlot(CHAT_SLOT, {}))));
       }
       // 工作台左栏会把 DSH 原生 Chat 以 `/?decklineChat=1` 嵌进来（同源 iframe）。
       // 那个嵌套的 DSH 实例不再自动打开工作台，否则会层层嵌套（F-68）。
@@ -423,6 +485,140 @@ div[data-sidebar-collapsed]{grid-template-columns:0px minmax(0px,1fr) 0px!import
       };
       const closeWorkbench = () => layout?.selectPanel?.(null);
 
+      /**
+       * 0.2.17：从 DSH 侧栏的会话直接拉起 Deckline 工作区（对齐 html-deck-studio 的同款交互）。
+       *
+       * 宿主把「当前主区会话」记在 `sessions.list` 的 `retainedBy.mainView` 上。切到一本
+       * 已绑定 deck / design 的会话时，自动打开工作台并切到那本 deck —— 省掉「先点 Deckline
+       * 面板、再选 deck」两步；会话行「⋯」菜单里也给一个显式入口。
+       */
+      const activeMainSessionId = () => {
+        try {
+          const list = ctx.sessions?.list?.getSnapshot?.();
+          if (!list?.byId) return "";
+          return Object.values(list.byId).find((row) => (row?.retainedBy?.mainView ?? 0) > 0)?.id ?? "";
+        } catch {
+          return "";
+        }
+      };
+      const activePanelIdOf = () => {
+        try {
+          return layout?.panelInfo?.getSnapshot?.()?.activePanelId ?? null;
+        } catch {
+          return null;
+        }
+      };
+      /** 会话 → 绑定实体（服务端绑定表；3s 内复用，列表频繁变化时不重复打接口）。 */
+      let bindingsCache = { at: 0, rows: [] };
+      const readSessionBindings = async () => {
+        if (Date.now() - bindingsCache.at < 3000) return bindingsCache.rows;
+        try {
+          const res = await fetch("/api/deck-studio.session-bindings", { headers: { accept: "application/json" } });
+          const data = await res.json();
+          bindingsCache = { at: Date.now(), rows: Array.isArray(data?.bindings) ? data.bindings : [] };
+        } catch {
+          bindingsCache = { at: Date.now(), rows: bindingsCache.rows };
+        }
+        return bindingsCache.rows;
+      };
+      /**
+       * 待发往工作台 iframe 的「打开某个 deck / design」指令。
+       *
+       * 0.2.21：发出去**不清空**——面板刚挂载时 iframe 里的脚本还没起来，早发的那几帧会被丢掉，
+       * 表现成「工作区弹出来了但停在首页」。现在等 iframe 回 `open-binding-ack` 才算送达，
+       * 期间由 ready 消息 + 多档定时重试兜底；20s 还没 ack 就放弃，避免下次误打开旧 deck。
+       */
+      let pendingOpen = null;
+      const flushPendingOpen = () => {
+        const pending = pendingOpen;
+        const win = frameState.el?.contentWindow;
+        if (!pending || !win) return;
+        try {
+          win.postMessage({ type: "dsh-deck-studio:open-binding", ...pending }, "*");
+        } catch {
+          /* iframe 还没就绪：等 ready 消息或下一次重试 */
+        }
+      };
+      const scheduleFlush = () => {
+        [60, 220, 600, 1400, 2600, 4200].forEach((delay) => window.setTimeout(flushPendingOpen, delay));
+      };
+      const openBindingInWorkbench = (target) => {
+        if (!target || (!target.id && !target.notice)) return false;
+        openWorkbench();
+        pendingOpen = { kind: target.kind ?? "deck", id: target.id ?? "", title: target.title ?? "", notice: target.notice ?? "" };
+        flushPendingOpen();
+        scheduleFlush();
+        const expected = pendingOpen;
+        window.setTimeout(() => {
+          if (pendingOpen === expected) pendingOpen = null;
+        }, 20000);
+        return true;
+      };
+      /** 侧栏点了一个会话：已绑定就直接进那本 deck；没绑定就进工作台并说明怎么绑。 */
+      const openSessionInWorkbench = async (sessionId, options = {}) => {
+        const id = String(sessionId ?? "").trim();
+        if (!id) return false;
+        const rows = await readSessionBindings();
+        const binding = rows.find((row) => row?.sessionId === id) ?? null;
+        if (!binding) {
+          if (options.auto) return false;
+          return openBindingInWorkbench({
+            kind: "none",
+            id: "",
+            notice: "这个会话还没有绑定 deck / 风格：先选一本 deck，用「＋」新建或切换绑定。",
+          });
+        }
+        return openBindingInWorkbench({
+          kind: binding.kind === "design" ? "design" : "deck",
+          id: binding.id,
+          title: binding.title ?? "",
+        });
+      };
+      /** 会话行「⋯」菜单项：在 Deckline 里打开这个会话绑定的 deck（未绑定给可见提示）。 */
+      function OpenDecklineMenuItem({ sessionId, useMenuOpenState }) {
+        const menu = typeof useMenuOpenState === "function" ? useMenuOpenState : () => [false, () => {}];
+        const [, setMenuOpen] = menu();
+        const [busy, setBusy] = React.useState(false);
+        const label = busy ? "正在打开 Deckline…" : "在 Deckline 打开";
+        const onSelect = () => {
+          try {
+            setMenuOpen(false);
+          } catch {
+            /* 菜单状态不可用时仍然执行动作 */
+          }
+          if (busy) return;
+          setBusy(true);
+          void openSessionInWorkbench(sessionId).finally(() => setBusy(false));
+        };
+        return h(
+          "button",
+          {
+            type: "button",
+            role: "menuitem",
+            "aria-label": label,
+            "data-deck-studio-open": "",
+            disabled: busy,
+            style: {
+              width: "100%",
+              minHeight: 32,
+              padding: "0 12px",
+              fontSize: 13,
+              display: "flex",
+              alignItems: "center",
+              justifyContent: "flex-start",
+              textAlign: "left",
+              border: 0,
+              background: "transparent",
+              color: "var(--dsw-alias-label-primary)",
+              borderRadius: "var(--dsw-radius-sm)",
+              cursor: busy ? "default" : "pointer",
+            },
+            onClick: onSelect,
+          },
+          label,
+        );
+      }
+
       const currentSessionId = () => {
         try {
           const raw = window.localStorage.getItem("dsh.sessions.current");
@@ -435,7 +631,20 @@ div[data-sidebar-collapsed]{grid-template-columns:0px minmax(0px,1fr) 0px!import
         const sessions = ctx.sessions;
         if (!sessions?.scope) throw new Error("sessions service unavailable");
         if (!sessionId) throw new Error("no target session");
-        const scoped = sessions.scope(sessionId);
+        /**
+         * 0.2.20：刚建出来的会话还没被 Dock retain 过，`sessions.scope()` 就是 null——
+         * 以前直接抛 `session … is not retained`，于是「新建 deck 后点发送」整条链路失败：
+         * 会话建出来了却没绑定、工作区也不弹。这里先自己 retain 一次再取 scope。
+         */
+        let scoped = sessions.scope(sessionId);
+        if (!scoped && typeof sessions.retain === "function") {
+          try {
+            sessions.retain(sessionId, { source: WORKBENCH_KEY });
+          } catch (error) {
+            ctx.logger?.warn?.(`deck-studio: retain before send failed: ${error?.message ?? error}`);
+          }
+          scoped = sessions.scope(sessionId);
+        }
         if (!scoped) throw new Error(`session ${sessionId} is not retained`);
         // 会话级上下文需要显式 inject 才能拿到 conversation 服务。
         await new Promise((resolve, reject) => {
@@ -545,6 +754,28 @@ div[data-sidebar-collapsed]{grid-template-columns:0px minmax(0px,1fr) 0px!import
         const sourceRoot = String(data.sourceRoot ?? "").trim();
         const sourceWorkspace = sourceRoot ? containing(sourceRoot) : null;
         if (sourceWorkspace) return sourceWorkspace.workspaceId;
+        /**
+         * 0.2.16：deck 自己的项目目录（工作台载荷里的 sessionWorkspacePath）。
+         * 桌面宿主里上面几级会全落空——cwd 是 profile 目录被守卫挡掉、源目录还没登记成工作区、
+         * 客户端 workspaces 服务也没有 initializeDefault——结果是「从没有会话的 deck」
+         * 永远建不出会话、也就永远绑不上（点了 ＋ 没反应）。这里按 deck 项目目录建/复用工作区，
+         * 保证每本 deck 都有落点；工作区名只是侧栏文案，命名失败不影响建会话。
+         */
+        const projectPath = String(data.sessionWorkspacePath ?? "").trim();
+        if (projectPath) {
+          const existing = containing(projectPath);
+          if (existing) return existing.workspaceId;
+          const projectWorkspaceId = await register(projectPath);
+          const title = String(data.title ?? "").trim().slice(0, 60);
+          if (title && typeof workspaces.rename === "function") {
+            try {
+              await workspaces.rename(projectWorkspaceId, `Deckline · ${title}`);
+            } catch {
+              /* 工作区重名等失败只影响侧栏文案，会话照建 */
+            }
+          }
+          return projectWorkspaceId;
+        }
         const fallback = await workspaces.initializeDefault?.();
         if (fallback?.workspaceId) return fallback.workspaceId;
         throw new Error("无法确定启动工作区，未创建会话；请配置 workspacePath 后重试");
@@ -614,10 +845,18 @@ div[data-sidebar-collapsed]{grid-template-columns:0px minmax(0px,1fr) 0px!import
               if (lastError) throw lastError;
               if (data.takeMain === true && DESKTOP_SHELL) closeWorkbench();
             }
+            let notice = "";
             if (data.prompt && data.action === "ensure" && sessionId !== String(data.sessionId ?? "")) {
-              await sendToSession(sessionId, String(data.prompt));
+              // 0.2.20：首条指令发不出去不该让整条 ensure 失败——会话已经建好，
+              // 绑定必须照写（否则 deck 变「未绑定」，工作区也不会自动弹出来）。
+              try {
+                await sendToSession(sessionId, String(data.prompt));
+              } catch (error) {
+                notice = `会话已建好并绑定，但首条指令没发出去：${error?.message ?? error}；在工作台里再发一次即可。`;
+                ctx.logger?.warn?.(`deck-studio: prompt send failed after ensure: ${error?.message ?? error}`);
+              }
             }
-            reply({ ok: true, sessionId });
+            reply({ ok: true, sessionId, ...(notice ? { notice } : {}) });
           } catch (error) {
             ctx.logger?.warn?.("deck-studio: conversation bridge failed", error);
             reply({ ok: false, reason: String(error?.message ?? error) });
@@ -720,6 +959,78 @@ div[data-sidebar-collapsed]{grid-template-columns:0px minmax(0px,1fr) 0px!import
           return () => window.clearTimeout(timer);
         }, "deck-studio: auto-open workbench");
 
+        /**
+         * 0.2.17：切到「已绑定 deck / design 的会话」时自动拉起工作区。
+         * 只在会话真的换了、且主区没有停在别的插件面板时动作；启动时先只记住当前会话不抢视图，
+         * 工作台自己打开的那一下不算用户切换（pendingOpen / 自身面板判定都挡掉）。
+         */
+        ctx.effect(() => {
+          const store = ctx.sessions?.list;
+          if (!store?.subscribe) return undefined;
+          let primed = false;
+          let lastActive = "";
+          let timer = null;
+          let token = 0;
+          const onChange = () => {
+            const list = store.getSnapshot?.();
+            if (!list || list.phase !== "ready") return;
+            const active = activeMainSessionId();
+            if (!primed) {
+              primed = true;
+              lastActive = active;
+              return;
+            }
+            if (active === lastActive) return;
+            lastActive = active;
+            if (!active) return;
+            // 会话变化的那一刻取面板：宿主随后会 selectPanel(null)，晚一步就分不清原来停在哪。
+            const panelAtChange = activePanelIdOf();
+            const mine = ++token;
+            window.clearTimeout(timer);
+            timer = window.setTimeout(() => {
+              if (mine !== token || activeMainSessionId() !== active) return;
+              if (panelAtChange !== null && panelAtChange !== WORKBENCH_KEY) return;
+              const panel = activePanelIdOf();
+              if (panel !== null && panel !== WORKBENCH_KEY) return;
+              void openSessionInWorkbench(active, { auto: true }).catch((error) =>
+                ctx.logger?.warn?.(`deck-studio: auto-open bound session failed: ${error?.message ?? error}`));
+            }, 260);
+          };
+          const dispose = store.subscribe(onChange);
+          onChange();
+          return () => {
+            window.clearTimeout(timer);
+            token += 1;
+            if (typeof dispose === "function") dispose();
+          };
+        }, "deck-studio: session → workbench");
+
+        // 工作台 iframe 就绪：把还没送出去的「打开某本 deck」补发一次。
+        ctx.effect(() => {
+          const onReady = (event) => {
+            if (event.data?.type !== "dsh-deck-studio:workbench-ready") return;
+            if (event.source !== (frameState.el?.contentWindow ?? null)) return;
+            flushPendingOpen();
+          };
+          window.addEventListener("message", onReady);
+          return () => window.removeEventListener("message", onReady);
+        }, "deck-studio: workbench ready bridge");
+
+        // 工作台确认收到「打开某本 deck」→ 才算送达，清掉 pending（没 ack 就继续重试）。
+        ctx.effect(() => {
+          const onAck = (event) => {
+            const data = event.data ?? {};
+            if (data.type !== "dsh-deck-studio:open-binding-ack") return;
+            if (event.source !== (frameState.el?.contentWindow ?? null)) return;
+            if (!pendingOpen || String(data.id ?? "") !== String(pendingOpen.id ?? "")) return;
+            const failed = data.ok === false;
+            pendingOpen = null;
+            if (failed) ctx.logger?.warn?.(`deck-studio: open binding failed: ${data.reason ?? "unknown"}`);
+          };
+          window.addEventListener("message", onAck);
+          return () => window.removeEventListener("message", onAck);
+        }, "deck-studio: open-binding ack bridge");
+
         // 唯一入口：侧栏面板行「Deckline」（与 plugins / schedules 等插件同一种形态，带图标）；
         // → 对话用工作台里的「← 回到对话」。
         if (hasRightbar) {
@@ -729,6 +1040,21 @@ div[data-sidebar-collapsed]{grid-template-columns:0px minmax(0px,1fr) 0px!import
                 ctx.slots.register({ name: "sidebar.panellist", id: WORKBENCH_KEY, order: 46, label: () => "Deckline" }, DeckGlyph)),
               "deck-studio: workbench sidebar entry",
             );
+            // 会话行「⋯」菜单：把当前会话绑定的 deck 在工作台里打开（未绑定给可见提示）。
+            // 该槽位是宿主可选契约，旧版本没有时只记一条警告，不能影响面板本身注册。
+            try {
+              ctx.effect(
+                () => ctx.slots.inject("sidebar.workspaces.session.menu.item", () =>
+                  ctx.slots.register({
+                    name: "sidebar.workspaces.session.menu.item",
+                    id: "dsh-plugin-deck-studio.open-binding",
+                    order: 150,
+                  }, OpenDecklineMenuItem)),
+                "deck-studio: session menu entry",
+              );
+            } catch (error) {
+              ctx.logger?.warn?.(`deck-studio: session menu slot unavailable: ${error?.message ?? error}`);
+            }
           }
           ctx.logger?.info?.("deck-studio client: workbench-only mode");
         } else {

package/index.js

@@ -395,9 +395,38 @@ export function createService(config, logger, env = process.env) {
     // F-71：标出「来自注册表」——preset 工具实例靠它区分静态源，运行时删除的 deck 才能被移除。
     config.decks.push({ id: entry.id, label: entry.label || entry.id, sourceRoot: entry.sourceRoot, kind: entry.kind ?? "deck", designId: entry.designId ?? null, fromRegistry: true });
   }
+  /**
+   * 0.2.15：补挂「工作副本里有 manifest、但注册表里没有条目」的 deck（ghost deck）。
+   *
+   * 以前这类 deck 只在 status() 的兜底分支里露一个标题：没有 adapter → 源里已出好的整页图
+   * baseline、资源库、封面、9 份文档全部拿不到，工作台打开就是一屏「未出图」的空白页，
+   * 看起来像「资源都在就是没显示」。这里在 adapters 之前补挂：manifest 里的源还可读
+   * （script.md 在）就造一个只读 adapter；读不到的留给 status() 标「未挂载」。
+   */
+  function adoptManifestDecks() {
+    const adopted = [];
+    for (const deckId of workspace.listDeckIds()) {
+      if (config.decks.some((deck) => deck.id === deckId)) continue;
+      const manifest = workspace.manifest(deckId);
+      const root = String(manifest?.source?.root ?? "").trim();
+      if (!root || !existsSync(join(root, "script.md"))) continue;
+      const kind = manifest?.kind === "design-canvas" ? "design-canvas" : "deck";
+      config.decks.push({
+        id: deckId,
+        label: String(manifest?.title ?? "").trim() || deckId,
+        sourceRoot: root,
+        kind,
+        designId: manifest?.designId ?? null,
+        fromManifest: true,
+      });
+      adopted.push(deckId);
+    }
+    return adopted;
+  }
   // F-157 首次启动自举：新装 profile 打开 bootstrap 时，自动登记示例 deck / 拷资源库 / 导入预设风格，
   // 避免「装完四个页面全是空的」。可用 profile patch 里 bootstrap: false 关掉。
   // 示例 deck 必须在 adapters 之前登记；资源和 fashioned 风格放后面（依赖 adapters/workspace）。
+  const adoptedDeckIds = adoptManifestDecks();
   if (config.bootstrap === true) bootstrapSampleDeck();
   const adapters = config.decks.map((deck) => createLocalSourceAdapter(deck));
 
@@ -517,9 +546,12 @@ export function createService(config, logger, env = process.env) {
     const success = String(payload.success ?? "").trim();
     const scopeOut = String(payload.scopeOut ?? "").trim();
     if (!title) throw new Error("deck 标题不能为空");
+    // 0.2.18：开工方式。表单式（默认）要求先把受众 / 意图 / 页数定清楚；
+    // 探索式只要一个标题——主意还模糊时先建本 deck，简报随对话补充（对齐 html deck-studio 的 explore）。
+    const creationMode = payload.mode === "explore" ? "explore" : "form";
     // 空白画布（design 会话用）：0 页，等 Agent 把风格样张沉淀到 designs/<ABBR>/。
     const blank = Boolean(payload.blank);
-    const pageTitles = newDeckPageTitles(payload, blank);
+    const pageTitles = creationMode === "explore" ? ["待定 · 边聊边定"] : newDeckPageTitles(payload, blank);
     const pad = (n) => String(n).padStart(2, "0");
     const now = new Date();
     const id = `deck-${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}-${pad(now.getHours())}${pad(now.getMinutes())}-${Math.random().toString(36).slice(2, 6)}`;
@@ -553,13 +585,16 @@ export function createService(config, logger, env = process.env) {
       "confidential: client",
       "render: image",
       "deck-type: talk",
+      ...(creationMode === "explore" ? ["creation-mode: explore"] : []),
       `pages: ${pageTitles.length}`,
       "status: draft",
       "---",
       "",
       `# ${title}`,
       "",
-      "> 由「新建 Deck」创建：先补意图与资料，再改 script；未确认前不出图。",
+      creationMode === "explore"
+        ? "> 由「新建 Deck · 探索模式」创建：还没定简报，先和 Agent 把听众 / 想让人带走什么 / 场合聊清楚，再补 script；未确认前不出图。"
+        : "> 由「新建 Deck」创建：先补意图与资料，再改 script；未确认前不出图。",
       "",
       "## 故事线",
       "",
@@ -594,6 +629,7 @@ export function createService(config, logger, env = process.env) {
         scopeOut,
         created: now.toISOString(),
         owner: config.userName,
+        creationMode,
       }),
       "utf8",
     );
@@ -672,6 +708,8 @@ export function createService(config, logger, env = process.env) {
       style: { abbr: styleAbbr, description: styleDescription },
       kind: payload.kind ?? "deck",
       designId: payload.designId ?? null,
+      // 0.2.18：探索式建档在注册表里也留痕（重启后 UI 能显示「探索式」）。
+      creationMode,
     });
     writeFileSync(decksRegistryFile, `${JSON.stringify({ decks: entries }, null, 2)}\n`, "utf8");
 
@@ -700,7 +738,8 @@ export function createService(config, logger, env = process.env) {
         designId: payload.designId ?? null,
         style: { abbr: styleAbbr, description: styleDescription },
         pages: pageTitles.length,
-        note: `初始化：script ${pageTitles.length} 页 + 意图 / 风格 / 参考资料清单 / 文档骨架`,
+        creationMode,
+        note: `初始化：script ${pageTitles.length} 页 + 意图 / 风格 / 参考资料清单 / 文档骨架${creationMode === "explore" ? "（探索式：简报随对话补充）" : ""}`,
       },
     });
     return {
@@ -837,9 +876,16 @@ export function createService(config, logger, env = process.env) {
     return { designId: design.designId, added, design: designProjectView(design) };
   }
 
-  /** F-157：把仓库自带的示例 deck 登记成只读源（没有配置任何 decks 时）。 */
+  /**
+   * F-157：把仓库自带的示例 deck 登记成只读源。
+   *
+   * 0.2.15：判定从「`config.decks` 非空就跳过」改成「这份示例没被挂上才登记」。
+   * 旧口径会被「导入预设风格时自动建的 8 本风格画布」顶掉——装过风格的机器上示例 deck
+   * 永远不会再登记，而它的工作副本还在 `decks/<id>/deck.json`，于是变成 ghost deck：
+   * 列表里有 10 页标题，打开却一页图都没有。
+   */
   function bootstrapSampleDeck() {
-    if (config.decks.length > 0) return;
+    if (config.decks.some((deck) => deck.id === "sample-deckline-intro")) return;
     const sampleRoot = join(REPO_ROOT, "samples", "deckline-intro");
     if (!existsSync(join(sampleRoot, "script.md"))) return;
     config.decks.push({ id: "sample-deckline-intro", label: "Deckline 示例手册", sourceRoot: sampleRoot, kind: "deck", designId: null, fromBootstrap: true });
@@ -1874,6 +1920,29 @@ export function createService(config, logger, env = process.env) {
     };
   }
 
+  /**
+   * 0.2.16：这本 deck 该用哪个目录当「会话工作区」。
+   *
+   * 背景：桌面宿主的 shell cwd 是 profile 目录（被工作区守卫挡掉），宿主客户端的
+   * workspaces 服务又没有 initializeDefault，源目录也常常还没登记成工作区——三者叠加，
+   * 「＋ 新建会话」永远解析不到工作区，于是**从没有会话的 deck 永远建不出会话**（点了没反应）。
+   * 这里给宿主桥一个明确的落点：deck 自己的项目目录优先；源落在插件安装位（node_modules）
+   * 或 App 包里时不拿来当工作区，退回这本 deck 的工作副本目录 <dataRoot>/decks/<id>。
+   */
+  function sessionWorkspacePathOf(deckId) {
+    const sourceRoot = String(adapterOf(deckId)?.sourceRoot ?? "").trim();
+    const installed = /[/\\]node_modules[/\\]/.test(sourceRoot) || sourceRoot.startsWith("/Applications/");
+    if (sourceRoot && !installed) return sourceRoot;
+    try {
+      const dir = workspace.deckDir(deckId);
+      // 工作区必须指向真实存在的目录；工作副本还没建出来时先建空的（没有 deck.json，不会被当成 deck 列出）。
+      mkdirSync(dir, { recursive: true });
+      return dir;
+    } catch {
+      return "";
+    }
+  }
+
   /** media 路由解析：只放行白名单目录的图片。 */
   function mediaFile(deckId, scope, path) {
     const adapter = adapterOf(deckId);
@@ -1951,8 +2020,11 @@ export function createService(config, logger, env = process.env) {
     }
     for (const deckId of workspace.listDeckIds()) {
       if (decks.some((deck) => deck.deckId === deckId)) continue;
+      // 0.2.15：走到这里说明这本 deck 的源没挂上（目录不在了 / script.md 丢了）。
+      // 明确标 unmounted + sourceAvailable:false，前端据此给「重新登记 / 换源」的入口，
+      // 而不是列一屏看起来正常、点开全是空白页的 deck。
       const manifest = workspace.manifest(deckId);
-      decks.push({ deckId, label: manifest?.title ?? deckId, sourceRoot: manifest?.source?.root ?? "", sourceAvailable: Boolean(manifest?.source?.root), title: manifest?.title ?? deckId, pageCount: manifest?.slides?.length ?? 0, status: manifest?.status ?? "", warnings: [] });
+      decks.push({ deckId, label: manifest?.title ?? deckId, sourceRoot: manifest?.source?.root ?? "", sourceAvailable: false, unmounted: true, title: manifest?.title ?? deckId, pageCount: manifest?.slides?.length ?? 0, status: manifest?.status ?? "", warnings: [] });
     }
     const tasks = store.taskList(200);
     const counts = {};
@@ -2276,10 +2348,12 @@ export function createService(config, logger, env = process.env) {
         // 当前 deck 生效的出图节点/模型（下拉可换）
         renderNodes: renderState(activeId),
         // 首页/标签用：deck 列表、风格（designs/<ABBR>/ 样张）、资源库
-        decks: decks.map((item) => ({ deckId: item.deckId, label: item.label, pageCount: item.pageCount, status: item.status ?? "", sourceRoot: item.sourceRoot ?? "", kind: item.kind ?? "deck" })),
+        decks: decks.map((item) => ({ deckId: item.deckId, label: item.label, pageCount: item.pageCount, status: item.status ?? "", sourceRoot: item.sourceRoot ?? "", kind: item.kind ?? "deck", sourceAvailable: item.sourceAvailable !== false, unmounted: item.unmounted === true })),
         designs: designSamples(activeId),
         ...homeCatalog(activeId),
         sourceRoot: adapter?.sourceRoot ?? deck?.source?.root ?? "",
+        // 0.2.16：给宿主桥注册 DSH 工作区用的项目目录（见 sessionWorkspacePathOf）。
+        sessionWorkspacePath: sessionWorkspacePathOf(activeId),
         // P0：黄条与 Inspector 用的数据目录状态（active 级别）
         dataDir: activeDataDir,
         dataDirMismatch: needsBanner,

package/lib/deck-templates.js

@@ -20,7 +20,7 @@ const orPlaceholder = (value, hint) => (pad(value) ? pad(value) : `（待补：$
  * intent.md 初始内容。
  * @param {{title:string, audience?:string, topic?:string, intent?:string, references?:string, created?:string, owner?:string}} input
  */
-export function buildIntentMarkdown({ title, audience = "", topic = "", intent = "", references = "", occasion = "", success = "", scopeOut = "", argument = "", skeletonType = "", pageOrder = "", keepThree = "", created = "", owner = "" } = {}) {
+export function buildIntentMarkdown({ title, audience = "", topic = "", intent = "", references = "", occasion = "", success = "", scopeOut = "", argument = "", skeletonType = "", pageOrder = "", keepThree = "", created = "", owner = "", creationMode = "" } = {}) {
   const heading = pad(title) || "（deck 标题）";
   return [
     "---",
@@ -28,10 +28,15 @@ export function buildIntentMarkdown({ title, audience = "", topic = "", intent =
     `owner: ${owner}`,
     ...(created ? [`created: ${created}`] : []),
     "status: draft",
+    // 0.2.18：探索式建档留痕——重启 / 重读 intent 时仍然知道这本是「边聊边定」的。
+    ...(creationMode === "explore" ? ["creation-mode: explore"] : []),
     "---",
     "",
     "# 意图",
     "",
+    ...(creationMode === "explore"
+      ? ["- **创建模式**：探索式 —— 简报随对话补充；下面「待补」的字段由 Agent 逐条问清楚，不是漏填表单。"]
+      : []),
     `- **听众**：${orPlaceholder(audience, "讲给谁：角色 / 部门 / 层级 / 对 AI 的熟悉度")}`,
     `- **主题**：${orPlaceholder(topic || heading, "一句话说清这场讲什么")}`,
     `- **带走**：${orPlaceholder(intent, "听完他们应该能带走什么（1–3 条，可验证）")}`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-deck-studio",
-  "version": "0.2.14",
+  "version": "0.2.24",
   "description": "Deckline：DSH 的 image deck / PPT 工作台插件——原生 Chat + 整页图片 deck 工作区 + 设计风格库；用对话做 PPT、按页出图、版本可追踪、导出 PDF/PPTX。",
   "icon": "assets/icon.svg",
   "homepage": "https://github.com/yuna78/dsh-deck-studio#readme",

package/ui/workbench.css

@@ -371,6 +371,19 @@ body.resizing{user-select:none;cursor:col-resize}
 .newdeck-body .nd-row{display:grid;grid-template-columns:1fr 1fr;gap:10px}
 .newdeck-body .field > span{font-size:10.5px;color:#5c6464}
 .newdeck-body input,.newdeck-body textarea,.newdeck-body select{width:100%;font:inherit;font-size:12px;padding:7px 9px;border:1px solid var(--line);border-radius:5px;background:#fffdf8;color:var(--ink);resize:vertical}
+/* 0.2.18 / 0.2.19：表单 / 探索两种开工方式。
+   必须写成 .newdeck-body .nd-mode-opt 这种权重，并且放在上面那条基础 input 规则之后——
+   否则 radio 会被 `.newdeck-body input{width:100%;padding:7px 9px}` 接管：撑满整行、把文字挤成一字一行
+   （0.2.18 的排版事故就是同权重 + 顺序靠前导致的）。 */
+.newdeck-body .nd-mode{display:grid;grid-template-columns:1fr 1fr;gap:8px;margin:0 0 10px}
+.newdeck-body .nd-mode-opt{display:flex;align-items:flex-start;gap:8px;padding:8px 10px;border:1px solid var(--line);border-radius:6px;background:#fffdf8;cursor:pointer;font-size:12px;color:var(--ink);min-width:0}
+.newdeck-body .nd-mode-opt input[type="radio"]{width:auto;height:auto;flex:0 0 auto;margin:2px 0 0;padding:0;border:0;background:none;accent-color:#0c4651}
+.newdeck-body .nd-mode-opt > span{flex:1 1 auto;display:flex;flex-direction:column;gap:2px;min-width:0}
+.newdeck-body .nd-mode-opt b{font-weight:600;font-size:12px;line-height:1.35}
+.newdeck-body .nd-mode-opt em{font-style:normal;font-size:11px;line-height:1.45;color:#728086;overflow-wrap:anywhere}
+.newdeck-body .nd-mode-opt:has(input:checked){border-color:#0c4651;box-shadow:inset 0 0 0 1px #0c4651}
+.newdeck-body .nd-mode-opt:has(input:checked) em{color:#48605f}
+.newdeck-body .nd-mode-note{margin:0 0 10px}
 /* 新建 Deck · 风格选择：样张预览卡片（F-45） */
 .nd-styles{display:grid;grid-template-columns:repeat(auto-fill,minmax(158px,1fr));gap:8px;margin-bottom:8px}
 .nd-style{display:flex;flex-direction:column;padding:0;border:1px solid var(--line);border-radius:8px;background:#fffdf8;cursor:pointer;font:inherit;text-align:left;overflow:hidden;transition:border-color .12s,box-shadow .12s}
@@ -677,7 +690,10 @@ body.has-chat .layout{grid-template-columns:var(--nav-w,430px) 5px minmax(0,1fr)
 body.presenting{overflow:hidden}
 .present-stage{width:100%;height:100%;display:flex;align-items:center;justify-content:center;padding:22px 22px 82px;cursor:pointer}
 .present-slide{margin:0;width:100%;height:100%;display:flex;align-items:center;justify-content:center}
-.present-slide img{max-width:100%;max-height:100%;object-fit:contain;border-radius:3px;background:#000;box-shadow:0 24px 80px #000c;user-select:none;-webkit-user-drag:none}
+/* 0.2.24：放映时整页图必须随屏幕放大——以前只写 max-width/max-height，图小于画布时永远保持
+   自然尺寸（1280×720 的页图在 2K/4K 屏上就缩在中间一小块）。改成 width/height:100% + object-fit:contain，
+   大图缩小、小图放大都按比例铺满；阴影改用 drop-shadow，跟着图片轮廓而不是整块元素。 */
+.present-slide img{width:100%;height:100%;max-width:none;max-height:none;object-fit:contain;border-radius:0;background:transparent;filter:drop-shadow(0 22px 62px #000b);user-select:none;-webkit-user-drag:none}
 .present-empty{width:min(900px,82vw);aspect-ratio:16/9;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:10px;border:1px dashed #ffffff2e;border-radius:8px;color:#c9c2b4;font-size:13px;text-align:center;padding:24px}
 .present-empty b{font-size:20px;color:#f3ede1}
 .present-bar{position:absolute;left:50%;bottom:18px;transform:translateX(-50%);display:flex;align-items:center;gap:10px;padding:6px 10px 6px 6px;border-radius:999px;background:#0c4651d9;border:1px solid #ffffff24;box-shadow:0 12px 34px #0009;font-size:12px;color:#e9e4d8;max-width:calc(100% - 28px);backdrop-filter:blur(8px)}

package/ui/workbench.html

@@ -177,6 +177,11 @@
       <button class="modal-close" id="ndClose" title="关闭">✕</button>
     </div>
     <form class="modal-body newdeck-body" id="newDeckForm">
+      <div class="nd-mode" id="ndMode" role="radiogroup" aria-label="开工方式">
+        <label class="nd-mode-opt"><input type="radio" name="ndMode" value="form" checked><span><b>表单模式</b><em>受众 / 意图 / 页数先定清楚</em></span></label>
+        <label class="nd-mode-opt"><input type="radio" name="ndMode" value="explore"><span><b>探索模式</b><em>只有一句模糊想法也能开工，边聊边定</em></span></label>
+      </div>
+      <p class="engine-note nd-mode-note" id="ndModeNote" hidden>探索模式只留「标题 + 风格」：其余字段先隐藏。建完 Agent 会在对话里一次问清听众 / 想让人带走什么 / 场合 / 材料 / 边界，再给你一版故事线草案——问清之前不出图、不留 TODO。</p>
       <p class="nd-tip">先定「讲给谁、讲什么、想带走什么」+ 视觉风格。创建后会开出源目录与 9 份文档骨架，然后在对话里继续补资料、改 script，直到可以出图。<br>新项目保存位置：<code id="ndStoragePath">正在读取配置…</code>。<span id="ndStorageNote"></span></p>
       <label class="field"><span>主题 / 标题</span><input id="ndTitle" required placeholder="例：XX 业务场景的 AI 落地分享"></label>
       <label class="field"><span>项目目录名（可选，英文小写中划线；留空自动生成）</span><input id="ndDirName" placeholder="例：talk-ai-transformation-6-stages"></label>
@@ -599,6 +604,59 @@ const DESKTOP_HOST = !/^(https?:)$/.test(location.protocol)
 
 const esc = (v) => String(v ?? "").replace(/[&<>"']/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" }[c]));
 const getEl = (id) => document.getElementById(id);
+
+/* 0.2.21：宿主「点左侧会话 → 打开这本 deck」的指令常常比本脚本启动还早（面板刚挂载就开始发），
+   旧实现把监听注册在 boot 末尾，消息就直接丢了——表现成「工作区弹出来了，但停在首页」。
+   这里一启动就注册监听：没 boot 完先暂存，boot 完再执行，并回 ack 让宿主确认送达。 */
+const OPEN_BINDING = { pending: null, booted: false };
+
+function ackOpenBinding(data, result) {
+  try {
+    window.parent?.postMessage({ type: "dsh-deck-studio:open-binding-ack", id: data?.id ?? "", kind: data?.kind ?? "", ...result }, "*");
+  } catch {
+    /* 独立打开（无宿主）时忽略 */
+  }
+}
+
+function applyOpenBinding(data) {
+  if (!data || typeof data !== "object") return;
+  if (data.notice) {
+    flash(data.notice);
+    ackOpenBinding(data, { ok: true, action: "notice" });
+    return;
+  }
+  if (!data.id) return;
+  if (data.kind === "design") {
+    const project = (STATE.data?.designProjects || []).find((item) => item.designId === data.id);
+    const canvasId = project?.canvasDeckId || "";
+    if (!canvasId) {
+      flash(`找不到这个风格的画布：${data.id}`, "error");
+      ackOpenBinding(data, { ok: false, reason: "design canvas not found" });
+      return;
+    }
+    showDeck(canvasId)
+      .then(() => ackOpenBinding(data, { ok: true, deckId: canvasId }))
+      .catch((error) => {
+        flash(`打开风格画布失败：${error?.message ?? error}`, "error");
+        ackOpenBinding(data, { ok: false, reason: String(error?.message ?? error) });
+      });
+    return;
+  }
+  showDeck(data.id)
+    .then(() => ackOpenBinding(data, { ok: true, deckId: data.id }))
+    .catch((error) => {
+      flash(`打开 deck 失败：${error?.message ?? error}`, "error");
+      ackOpenBinding(data, { ok: false, reason: String(error?.message ?? error) });
+    });
+}
+
+window.addEventListener("message", (event) => {
+  if (event.source !== window.parent) return;
+  const data = event.data ?? {};
+  if (data.type !== "dsh-deck-studio:open-binding") return;
+  if (OPEN_BINDING.booted) applyOpenBinding(data);
+  else OPEN_BINDING.pending = data;
+});
 const fmtBytes = (n) => (n ? (n > 1048576 ? (n / 1048576).toFixed(1) + " MB" : Math.round(n / 1024) + " KB") : "");
 const fmtTime = (iso) => String(iso ?? "").replace("T", " ").replace(/\.\d+Z$/, "Z").replace("Z", "").slice(5);
 
@@ -1648,8 +1706,8 @@ function renderHomeDecks(decks, active, gov) {
         ${deck.deletable ? `<button type="button" class="design-tool danger deck-tool" data-deck-delete="${esc(deck.deckId)}" title="删除这个 deck（本机新建的才可以）">${TRASH_ICON}</button>` : ""}
         <div class="home-block-media">${homeThumb(deck)}</div>
         <div class="home-block-body">
-          <div class="home-block-title">${esc(homeDeckTitle(deck))}${deck.kind === "design-canvas" ? `<span class="pill canvas-pill">风格画布</span>` : ""}</div>
-          <div class="home-block-meta">${deck.kind === "design-canvas" ? "风格画布" : `${esc(String(deck.pageCount ?? 0))} 页`}${score != null ? ` · 治理 ${score}/100` : ""}</div>
+          <div class="home-block-title">${esc(homeDeckTitle(deck))}${deck.kind === "design-canvas" ? `<span class="pill canvas-pill">风格画布</span>` : ""}${deck.unmounted ? `<span class="pill canvas-pill" title="这份 deck 的源目录不在了（只剩工作副本）：点开在右侧 Inspector 换源 / 重新登记">源未挂载</span>` : ""}</div>
+          <div class="home-block-meta">${deck.unmounted ? "源未挂载 · 只剩工作副本" : deck.kind === "design-canvas" ? "风格画布" : `${esc(String(deck.pageCount ?? 0))} 页`}${score != null ? ` · 治理 ${score}/100` : ""}</div>
           ${styleChip || docTags || rulesChip ? `<div class="home-block-tags">${styleChip}${rulesChip}${docTags}</div>` : ""}
         </div>
       </div>`;
@@ -4657,6 +4715,41 @@ function newDeckStorageInfo(config = {}) {
   return { path: "暂时无法确定", note: "请等待工作台配置加载后重试；未配置 projectsRoot 时使用 <dataRoot>/projects/<deck-id>/source/。" };
 }
 
+/** 0.2.18：探索模式要藏起来的表单字段（标题 / 风格 / 参考资料之外的「先填清楚」项）。 */
+const ND_FORM_ONLY = ["ndDirName", "ndPages", "ndDensity", "ndAudience", "ndTopic", "ndIntent", "ndOccasion", "ndSuccess", "ndScopeOut", "ndRefs"];
+
+/** 当前开工方式：form（表单）/ explore（探索，主意还没定清楚）。 */
+function newDeckMode() {
+  return document.querySelector('#ndMode input[name="ndMode"]:checked')?.value === "explore" ? "explore" : "form";
+}
+
+/**
+ * 切换开工方式：探索式只留「标题 + 风格」，其余字段隐藏（值保留，切回表单还在）；
+ * 隐藏的字段不能用 hidden 属性就完事——.newdeck-body .field 是 display:flex，会盖掉浏览器默认样式。
+ */
+function applyNewDeckMode() {
+  const explore = newDeckMode() === "explore";
+  for (const id of ND_FORM_ONLY) {
+    const field = getEl(id)?.closest(".field");
+    if (!field) continue;
+    field.hidden = explore;
+    field.style.display = explore ? "none" : "";
+  }
+  // 成对的行（场合 / 成功标准）两个字段都藏起来后，行本身也要收掉，否则会留一条空栅格。
+  document.querySelectorAll("#newDeckForm .nd-row").forEach((row) => {
+    const allHidden = [...row.querySelectorAll(".field")].every((field) => field.hidden);
+    row.hidden = explore && allHidden;
+    row.style.display = explore && allHidden ? "none" : "";
+  });
+  const pages = getEl("ndPages");
+  if (pages) pages.required = !explore;
+  getEl("ndModeNote").hidden = !explore;
+  const button = getEl("ndCreate");
+  if (button) button.textContent = explore ? "开始探索 →" : "创建并开始对话";
+  getEl("newDeckModal").dataset.mode = explore ? "explore" : "form";
+  return explore;
+}
+
 function openNewDeckModal() {
   // F-112：profile 里配了 defaultStyleAbbr 就默认预选这个风格（用户仍可改/取消）。
   STATE.ndStyleAbbr = String(STATE.data?.config?.defaultStyleAbbr || "");
@@ -4666,6 +4759,7 @@ function openNewDeckModal() {
   getEl("ndStoragePath").textContent = storage.path;
   getEl("ndStorageNote").textContent = storage.note;
   getEl("newDeckModal").hidden = false;
+  applyNewDeckMode();
   renderDeckStyleChoices();
   setTimeout(() => getEl("ndTitle").focus(), 30);
 }
@@ -4678,26 +4772,33 @@ getEl("newDeckBtn").addEventListener("click", openNewDeckModal);
 getEl("ndClose").addEventListener("click", closeNewDeckModal);
 getEl("ndCancel").addEventListener("click", closeNewDeckModal);
 getEl("newDeckModal").addEventListener("click", (event) => { if (event.target === getEl("newDeckModal")) closeNewDeckModal(); });
+getEl("ndMode").addEventListener("change", applyNewDeckMode);
 getEl("newDeckForm").addEventListener("submit", async (event) => {
   event.preventDefault();
-  const payload = {
-    title: getEl("ndTitle").value.trim(),
-    dirName: getEl("ndDirName").value.trim(),
-    pages: Math.min(Math.max(Number.parseInt(getEl("ndPages").value, 10) || 6, 1), 40),
-    contentDensity: getEl("ndDensity").value || "auto",
-    audience: getEl("ndAudience").value.trim(),
-    topic: getEl("ndTopic").value.trim(),
-    intent: getEl("ndIntent").value.trim(),
-    occasion: getEl("ndOccasion").value.trim(),
-    success: getEl("ndSuccess").value.trim(),
-    scopeOut: getEl("ndScopeOut").value.trim(),
-    references: getEl("ndRefs").value.trim(),
-    style: {
-      abbr: STATE.ndStyleAbbr || "",
-      // preset 选中的话，description 仍带完整风格定义（只是不给用户看）
-      description: pickedDeckStyle()?.description || getEl("ndStyle").value.trim(),
-    },
+  const explore = newDeckMode() === "explore";
+  const style = {
+    abbr: STATE.ndStyleAbbr || "",
+    // preset 选中的话，description 仍带完整风格定义（只是不给用户看）
+    description: pickedDeckStyle()?.description || getEl("ndStyle").value.trim(),
   };
+  // 0.2.18：探索式只提交「标题 + 风格」——被隐藏字段里可能还留着旧值，不能偷偷带上；
+  // 页数先占 1 页占位，等对话里把故事线聊清楚再追加。
+  const payload = explore
+    ? { title: getEl("ndTitle").value.trim(), mode: "explore", pages: 1, style }
+    : {
+        title: getEl("ndTitle").value.trim(),
+        dirName: getEl("ndDirName").value.trim(),
+        pages: Math.min(Math.max(Number.parseInt(getEl("ndPages").value, 10) || 6, 1), 40),
+        contentDensity: getEl("ndDensity").value || "auto",
+        audience: getEl("ndAudience").value.trim(),
+        topic: getEl("ndTopic").value.trim(),
+        intent: getEl("ndIntent").value.trim(),
+        occasion: getEl("ndOccasion").value.trim(),
+        success: getEl("ndSuccess").value.trim(),
+        scopeOut: getEl("ndScopeOut").value.trim(),
+        references: getEl("ndRefs").value.trim(),
+        style,
+      };
   if (!payload.title) return;
   getEl("ndCreate").disabled = true;
   getEl("ndState").textContent = "正在创建 deck 项目（源目录 + 9 份文档骨架）…";
@@ -4716,6 +4817,18 @@ getEl("newDeckForm").addEventListener("submit", async (event) => {
     // 停在 home（loadWorkbench 在 home 视图下只会重渲染首页，用户会以为「没自动打开」）。
     await showDeck(deckId);
     getEl("renderStatus").textContent = `已创建 ${label}；对话在 DSH 原生 Chat 里继续。`;
+    if (explore) {
+      sendPrompt(
+        `我刚新建了 deck「${label}」（${deckId}），用的是**探索模式**：我一开始只有个模糊想法，没有现成简报。\n` +
+        `请按这个顺序把我带清楚，不要留 TODO、不要出图：\n` +
+        `1) 先一次问完 3–5 个关键问题（讲给谁 / 听完要带走什么 / 什么场合和时长 / 手上有没有现成材料 / 有没有必须避开的边界），别一条一条挤牙膏；\n` +
+        `2) 我回答后，用 deck_doc_update（docId=intent）把听众 / 带走 / 场合 / 成功标准 / 不讲的写回去；没依据的字段写成「待确认：缺依据，已列问题」，不要编，也不要留模板占位；\n` +
+        `3) 再给一版故事线草案：分几段、每段回答什么、大概几页（不确定就给区间），等我确认；\n` +
+        `4) 我确认后再用 deck_script_add_page / 提案改 script；要出图我会明确说。\n` +
+        `材料里没有的数字 / 客户 / 案例 / URL 不要编。`,
+        "探索式新建 · 首条消息发给 Agent",
+      );
+    } else {
     sendPrompt(
       `我刚新建了 deck「${label}」（${deckId}）。\n` +
       `页数：已按 ${payload.pages} 页占位（P01–P${String(payload.pages).padStart(2, "0")}）；页数要改就在对话里说，用 deck_script_add_page 追加。\n` +
@@ -4737,6 +4850,7 @@ getEl("newDeckForm").addEventListener("submit", async (event) => {
       `材料里没有的数字 / 客户 / 案例 / URL 不要编。做完复述你补了什么、还缺什么，再等我确认后起 script 草案，不要直接出图。`,
       "新建 deck · 下一步发给 Agent",
     );
+    }
   } catch (error) {
     getEl("ndState").textContent = "创建失败：" + error.message;
   } finally {
@@ -5107,6 +5221,8 @@ function requestConversation(payload) {
       cwd: STATE.data?.cwd || "",
       workspacePath: STATE.data?.workspacePath || "",
       sourceRoot: STATE.data?.active?.sourceRoot || "",
+      // 0.2.16：宿主要按「deck 自己的项目目录」建会话工作区（桌面里 cwd 是 profile 目录，用不了）。
+      sessionWorkspacePath: STATE.data?.active?.sessionWorkspacePath || "",
       ...payload,
       // F-202B：桌面 Dock 模式默认不抢主区（open:false）；显式 takeMain → open:true 切宿主主区。
       // web 不传 open（undefined → 宿主按原语义 openSession）。
@@ -5184,8 +5300,11 @@ async function ensureDeckConversation(deckId) {
   });
   if (!result.ok) {
     getEl("chatBindChip").textContent = `会话打开失败：${result.reason || "未知原因"}`;
+    flash(`会话打开失败：${result.reason || "未知原因"}`, "error");
     return result;
   }
+  // 0.2.20：会话建好了但首条指令没发出去时，宿主会带 notice——别让它悄悄消失。
+  if (result.notice) flash(result.notice);
   if (!binding || binding.sessionId !== result.sessionId) {
     await bindConversation({ sessionId: result.sessionId, kind: "deck", id: deckId, title: label });
   }
@@ -5591,23 +5710,33 @@ function renderChatHeader() {
 /** ＋ 新建会话：建完立即绑定当前 deck / design（不再产生未绑定会话）。 */
 async function newChatForTarget() {
   const target = activeChatTarget();
-  if (!target) return;
+  if (!target) {
+    // 0.2.16：以前这里静默 return——点了 ＋ 什么都不发生，用户只能猜。
+    flash("当前没有可绑定的 deck / 风格：先打开一本 deck 再新建会话", "error");
+    return;
+  }
   const button = getEl("newChatBtn");
   button.disabled = true;
   try {
     const result = await requestConversation({ action: "ensure", kind: target.kind, id: target.id, title: target.label });
     if (!result.ok || !result.sessionId) {
+      const reason = result.reason || "未知原因";
       // F-202B：失败要用户可见——之前只写按钮 title，Dock 模式下看起来像「点了没反应」。
+      // 0.2.16：再加一条常驻 toast，光靠 chip 文案还是容易被当成没反应。
+      flash(`新建会话失败：${reason}`, "error");
       getEl("chatBindChip").textContent = "会话新建失败";
-      getEl("chatBindChip").title = `新建会话失败：${result.reason || "未知原因"}；点这里重试`;
-      getEl("chatSessionBtn").title = `新建会话失败：${result.reason || "未知原因"}`;
+      getEl("chatBindChip").title = `新建会话失败：${reason}；点这里重试`;
+      getEl("chatSessionBtn").title = `新建会话失败：${reason}`;
       return;
     }
     STATE.chatSessionId = result.sessionId;
+    if (result.notice) flash(result.notice);
     await bindConversation({ sessionId: result.sessionId, kind: target.kind, id: target.id, title: target.label });
     await refreshSessions();
     renderChatHeader();
     // 桌面：新建就是要点开聊——切到宿主主区的原生会话。
+  } catch (error) {
+    flash(`新建会话失败：${error?.message ?? error}`, "error");
   } finally {
     button.disabled = false;
   }
@@ -5900,6 +6029,22 @@ function backToManual(box) {
     showHome();
   }
   setInterval(() => loadWorkbench(STATE.deckId), 5000);
+
+  /**
+   * 0.2.21：boot 完成 → 把启动期间暂存的「打开某本 deck」执行掉，再向宿主报 ready。
+   * 顺序很关键：先 booted=true 再执行，避免执行期间又来一条指令被丢进 pending 里没人取。
+   */
+  OPEN_BINDING.booted = true;
+  if (OPEN_BINDING.pending) {
+    const pending = OPEN_BINDING.pending;
+    OPEN_BINDING.pending = null;
+    applyOpenBinding(pending);
+  }
+  try {
+    window.parent?.postMessage({ type: "dsh-deck-studio:workbench-ready" }, "*");
+  } catch {
+    /* 直接打开（无宿主）时没有 parent */
+  }
 })();
 </script>
 </body>