@spzxg/cli-ui 0.6.6 → 0.6.7

package/src/board/textLoad.ts

@@ -1,17 +1,16 @@
 // 预览里文本文件（代码、日志、Markdown、CSV）的读取。
 //
 // 能读多大：一次最多 max 字节（预览里是 32 MB），更大的只看开头或末尾。
-// 文件在变（任务在写日志、在改报告）时不整个重读：后端有 readBytes 时，从上次读到的地方往前多取一小段（OVERLAP），
-// 这一小段和手里的末尾一模一样就说明文件只是往后追加了，只取新增的部分接上；对不上（文件被改写、变短了）才整个重读。
-// 只对 UTF-8 文件这样做（GBK 的字节边界不好对齐，整个重读）。
+// 新协议以不可变修订和内容块进行同步；旧后端不能通过尾部重叠推断整份文件未变化。
 
 import type { BoardBackend } from "../core/client";
 import { decodeText } from "../core/textDecode";
+import { syncFile } from "./fileSync";
 
 /** 往前多取这么多字节，用来确认文件只是追加。 */
 export const OVERLAP = 256;
 /** 追加的段落多了合成一段（每段是 <pre> 里的一个文字节点）。 */
-const MAX_PARTS = 200;
+
 
 export interface LoadedText {
   text: string;
@@ -24,6 +23,7 @@ export interface LoadedText {
   /** 读的是末尾。 */
   tail: boolean;
   encoding?: string;
+  revision?: string;
   /** 读到的内容在文件里的字节范围 [start, end)。 */
   start: number;
   end: number;
@@ -44,11 +44,16 @@ export function incompleteUtf8Tail(bytes: Uint8Array) {
   return 0;
 }
 
-const sameBytes = (a: Uint8Array, b: Uint8Array) => a.length === b.length && a.every((x, i) => x === b[i]);
+
 
 /** 第一次读：开头（或末尾）最多 max 字节。 */
-export async function loadText(backend: BoardBackend, jobId: string, path: string, opts: { max: number; tail?: boolean; onBytes?: (bytes: number) => void; signal?: AbortSignal }): Promise<LoadedText> {
+export async function loadText(backend: BoardBackend, jobId: string, path: string, opts: { max: number; tail?: boolean; onBytes?: (bytes: number) => void; signal?: AbortSignal; preview?: boolean; fresh?: boolean }): Promise<LoadedText> {
   if (opts.signal?.aborted) throw new DOMException("文件读取已取消", "AbortError");
+  if (backend.fileSync) {
+    const result = await syncFile(backend.fileSync, jobId, path, { signal: opts.signal, preview: opts.preview, fresh: opts.fresh, range: { maxBytes: opts.max, ...(opts.tail ? { tail: true } : {}) }, onProgress: progress => opts.onBytes?.(progress.loadedBytes) });
+    const text = result.text ?? decodeText(result.bytes, { fromMiddle: result.start > 0 }).text;
+    return { text, parts: [text], truncated: result.truncated, size: result.size, tail: result.start > 0, encoding: result.encoding, revision: result.revision, start: result.start, end: result.start + result.bytes.length, tailBytes: null };
+  }
   if (!backend.readBytes) {
     const r = await backend.readText(jobId, path, opts.max, { tail: opts.tail, onBytes: opts.onBytes, signal: opts.signal });
     return { text: r.text, parts: [r.text], truncated: r.truncated, size: r.size, tail: !!r.tail, encoding: r.encoding, start: 0, end: 0, tailBytes: null };
@@ -64,38 +69,8 @@ export async function loadText(backend: BoardBackend, jobId: string, path: strin
   };
 }
 
-/**
- * 文件变了：能接上就只取新增的部分，返回新的内容；返回 null = 接不上（被改写 / 变短 / 不是 UTF-8 / 后端不支持），调用方整个重读。
- * 只看开头且文件比 max 大时，开头没变就不用重读（追加的在后面，本来就不显示）。
- */
-export async function refreshText(backend: BoardBackend, jobId: string, path: string, prev: LoadedText, max: number, options: { signal?: AbortSignal } = {}): Promise<LoadedText | null> {
+/** Every refresh verifies a revision. A matching tail cannot prove the rest stayed unchanged. */
+export async function refreshText(backend: BoardBackend, jobId: string, path: string, prev: LoadedText, max: number, options: { signal?: AbortSignal; preview?: boolean; fresh?: boolean } = {}): Promise<LoadedText | null> {
   if (options.signal?.aborted) throw new DOMException("文件读取已取消", "AbortError");
-  if (!backend.readBytes || !prev.tailBytes) return null;
-  const overlap = prev.tailBytes.length;
-  const from = prev.end - overlap;
-  const headOnly = !prev.tail && prev.truncated;
-  // 末尾模式攒多了（超过 1.5 倍）：整个重读末尾，免得越攒越大。
-  if (prev.tail && prev.end - prev.start > max * 1.5) return null;
-  const room = headOnly ? 0 : prev.tail ? max : Math.max(0, max - (prev.end - prev.start));
-  const chunk = await backend.readBytes(jobId, path, { start: from, maxBytes: overlap + room, signal: options.signal });
-  if (chunk.size < prev.end || chunk.start !== from || chunk.bytes.length < overlap) return null;
-  if (!sameBytes(chunk.bytes.subarray(0, overlap), prev.tailBytes)) return null;
-  const readEnd = from + chunk.bytes.length;
-  if (headOnly) return { ...prev, size: chunk.size };
-  const added = chunk.bytes.subarray(overlap);
-  const k = incompleteUtf8Tail(added);
-  const delta = added.subarray(0, added.length - k);
-  let addedText: string;
-  try { addedText = new TextDecoder("utf-8", { fatal: true }).decode(delta); } catch { return null; }
-  const end = prev.end + delta.length;
-  const tailBytes = new Uint8Array(Math.min(OVERLAP, overlap + delta.length));
-  const joined = new Uint8Array(overlap + delta.length);
-  joined.set(prev.tailBytes, 0);
-  joined.set(delta, overlap);
-  tailBytes.set(joined.subarray(joined.length - tailBytes.length));
-  const parts = addedText ? (prev.parts.length >= MAX_PARTS ? [prev.text, addedText] : [...prev.parts, addedText]) : prev.parts;
-  return {
-    ...prev, text: addedText ? prev.text + addedText : prev.text, parts, size: chunk.size, end, tailBytes,
-    truncated: prev.tail || chunk.size > readEnd,
-  };
+  return backend.fileSync ? loadText(backend, jobId, path, { max, tail: prev.tail, signal: options.signal, preview: options.preview, fresh: options.fresh }) : null;
 }

package/src/board/useBoardUpload.tsx

@@ -0,0 +1,51 @@
+import { useLayoutEffect, useRef, useState } from "react";
+import { clientId } from "../core/id";
+import type { DocumentReceipt, UploadDocument, UploadPhase } from "../core/documentUpload";
+import { FILE_UPLOAD_ACCEPT } from "../core/documentUpload";
+import { UploadProgress } from "../ui/UploadProgress";
+
+type PendingUpload = { file: File; phase: UploadPhase | "ready" | "error"; bytes: number; error?: string };
+
+/** Uploading a file only changes the current workspace. It never submits a message. */
+export function useBoardUpload(scope: string | null, upload: UploadDocument | undefined, onUploaded: (receipt: DocumentReceipt) => void) {
+  const inputRef = useRef<HTMLInputElement>(null);
+  const active = useRef<AbortController | null>(null);
+  const committedScope = useRef(scope);
+  const [pending, setPending] = useState<PendingUpload | null>(null);
+  useLayoutEffect(() => {
+    committedScope.current = scope;
+    setPending(null);
+    return () => { active.current?.abort(); active.current = null; };
+  }, [scope, upload]);
+
+  const start = (file: File) => {
+    if (!scope || !upload || active.current) return;
+    const controller = new AbortController();
+    active.current = controller;
+    const current = () => active.current === controller && committedScope.current === scope && !controller.signal.aborted;
+    setPending({ file, phase: "queued", bytes: 0 });
+    void Promise.resolve().then(() => upload(file, {
+      draftId: clientId(), signal: controller.signal,
+      onPhase: phase => { if (current()) setPending(previous => previous ? { ...previous, phase } : previous); },
+      onBytes: bytes => { if (current()) setPending(previous => previous ? { ...previous, bytes } : previous); },
+    })).then(receipt => {
+      if (!current()) return;
+      if (!receipt.path) throw new Error("文件尚未进入当前工作区，请稍后重试");
+      setPending({ file, phase: "ready", bytes: file.size });
+      onUploaded(receipt);
+    }).catch(error => {
+      if (current()) setPending(previous => previous ? { ...previous, phase: "error", error: error instanceof Error ? error.message : "上传失败，请重试" } : previous);
+    }).finally(() => { if (active.current === controller) active.current = null; });
+  };
+  const dismiss = () => { active.current?.abort(); active.current = null; setPending(null); };
+  const busy = !!pending && pending.phase !== "ready" && pending.phase !== "error";
+  return {
+    busy,
+    choose: () => { if (!busy) inputRef.current?.click(); },
+    input: <input ref={inputRef} type="file" hidden accept={FILE_UPLOAD_ACCEPT} aria-label="上传文件到工作区"
+      onChange={event => { const file = event.target.files?.[0]; event.target.value = ""; if (file) start(file); }} />,
+    progress: pending && <div className="cli-board-upload"><UploadProgress name={pending.file.name} status={pending.phase}
+      bytes={pending.bytes} total={pending.file.size} error={pending.error} onCancel={dismiss} onRemove={dismiss}
+      onRetry={() => start(pending.file)} /></div>,
+  };
+}

package/src/board/useBoardVisibility.ts

@@ -0,0 +1,35 @@
+import { useEffect, useLayoutEffect, useState, type RefObject } from "react";
+
+const useLayout = typeof window === "undefined" ? useEffect : useLayoutEffect;
+
+/** Observe this board's ancestor chain, including host CSS that hides a pane. */
+export function useBoardVisibility(ref: RefObject<HTMLElement | null>, enabled: boolean) {
+  const [visible, setVisible] = useState(true);
+  useLayout(() => {
+    if (!enabled || !ref.current) return;
+    const ancestors: HTMLElement[] = [];
+    for (let node: HTMLElement | null = ref.current; node; node = node.parentElement) ancestors.push(node);
+    let pending = false, alive = true;
+    const read = () => {
+      pending = false;
+      if (!alive) return;
+      setVisible(ancestors.every(node => {
+        const style = getComputedStyle(node);
+        return !node.hidden && style.display !== "none" && style.visibility !== "hidden" && style.visibility !== "collapse" && style.contentVisibility !== "hidden";
+      }));
+    };
+    const schedule = () => {
+      if (pending) return;
+      pending = true;
+      queueMicrotask(read);
+    };
+    const mutations = new MutationObserver(schedule);
+    for (const node of ancestors) mutations.observe(node, { attributes: true, attributeFilter: ["class", "style", "hidden"] });
+    const resize = typeof ResizeObserver === "undefined" ? null : new ResizeObserver(schedule);
+    resize?.observe(ref.current);
+    window.addEventListener("resize", schedule);
+    read();
+    return () => { alive = false; mutations.disconnect(); resize?.disconnect(); window.removeEventListener("resize", schedule); };
+  }, [ref, enabled]);
+  return visible;
+}

package/src/board/workspace.ts

@@ -11,11 +11,14 @@
  *
  * 数据都经中枢读执行节点（和看板一样），弱网时按网络错误（CenterError，code = "NETWORK"）失败，可以重试。
  */
-import { subscribeWorkspaceFiles, type WorkspaceWatchOptions } from "./fileWatch";
+import { retryWorkspaceFiles, subscribeWorkspaceFiles, type WorkspaceWatchOptions, type WorkspaceRefreshOptions } from "./fileWatch";
 import type { BoardBackend } from "../core/client";
-import type { BoardInfo, FileEntry, WorkspaceChangeEvent } from "../core/types";
+import type { BoardInfo, FileEntry, DirListing, WorkspaceChangeEvent } from "../core/types";
 import { directFileUrl, downloadFile, mimeOf } from "./fileOps";
 import { fmtSize } from "./fileKind";
+import { syncFile, FILE_SYNC_MAX } from "./fileSync";
+import { isOriginalDocument } from "../core/documentUpload";
+import { loadText } from "./textLoad";
 import { downloadFolder, listFolder, zipFolder, type FolderOptions, type FolderResult, type FolderZip } from "./folderDownload";
 
 /** readText 最多读这么大（更大的用 readFile）。 */
@@ -55,9 +58,13 @@ export interface CliWorkspace {
   stat(path: string): ReturnType<BoardBackend["stat"]>;
   /** 订阅文件变更。初始快照只建立基线；返回取消函数。 */
   watch(listener: (event: WorkspaceChangeEvent) => void, options?: WorkspaceWatchOptions): () => void;
+  /** 请求一次增量检查。轮末回调用无参；用户明确重试可传 manual:true（仍遵守服务端冷却）。不创建连接或周期轮询。 */
+  refresh(options?: WorkspaceRefreshOptions): void;
   /** 包括当前文件、打开页签、最近浏览和显示状态的背景快照。 */
   context(): BoardView | null;
-  /** 列一个目录（不递归）。 */
+  /** 按需读取单层目录的一页；nextCursor 非空时还有后续页。 */
+  listPage(dir?: string, opts?: { cursor?: string; limit?: number; signal?: AbortSignal }): Promise<DirListing>;
+  /** 显式列出一个目录（不递归，最多10000项）；界面首屏推荐 listPage。 */
   list(dir?: string): Promise<FileEntry[]>;
   /** 列 dir 下所有文件（递归，只含文件）。 */
   listAll(dir?: string, opts?: { signal?: AbortSignal }): Promise<FileEntry[]>;
@@ -100,11 +107,27 @@ export function createWorkspace(deps: {
     info: () => backend().info(key),
     stat: path => backend().stat(key, clean(path) || "."),
     watch: (listener, options) => deps.watch ? deps.watch(listener,options) : subscribeWorkspaceFiles(backend(), key, listener, options),
+    refresh: options => options ? retryWorkspaceFiles(backend(), key, options) : retryWorkspaceFiles(backend(), key),
     context: () => deps.context?.() ?? deps.view() ?? null,
+    async listPage(dir = "", opts = {}) {
+      const api = backend();
+      const result = api.listFiles ? await api.listFiles(key, clean(dir) || ".", opts) : await api.stat(key, clean(dir) || ".");
+      if (result.type !== "dir") throw new Error(`「${dir}」不是目录`);
+      return result;
+    },
     async list(dir = "") {
-      const res = await backend().stat(key, clean(dir) || ".");
-      if (res.type !== "dir") throw new Error(`「${dir}」不是目录`);
-      return res.entries;
+      const api = backend(), entries: FileEntry[] = [], seen = new Set<string>();
+      let cursor: string | undefined;
+      do {
+        const result = api.listFiles ? await api.listFiles(key, clean(dir) || ".", { cursor, limit: 200 }) : await api.stat(key, clean(dir) || ".");
+        if (result.type !== "dir") throw new Error(`「${dir}」不是目录`);
+        entries.push(...result.entries);
+        if (entries.length > WORKSPACE_LIST_MAX) throw new Error("目录超过10000项，请用 listPage 按需读取");
+        cursor = result.nextCursor;
+        if ((result.truncated && (!cursor || !api.listFiles)) || (cursor && seen.has(cursor))) throw new Error("目录列表不完整，请使用支持分页的服务端");
+        if (cursor) seen.add(cursor);
+      } while (cursor);
+      return entries;
     },
     async listAll(dir = "", opts = {}) {
       const files = await listFolder(backend(), key, clean(dir), { signal: opts.signal, maxFiles: WORKSPACE_LIST_MAX, maxBytes: Infinity });
@@ -115,6 +138,10 @@ export function createWorkspace(deps: {
       if (signal?.aborted) throw new DOMException("已取消", "AbortError");
       let rejectAbort: (() => void) | undefined;
       try {
+        if (backend().fileSync && isOriginalDocument(path)) {
+          const result = await loadText(backend(), key, clean(path), { max: FILE_SYNC_MAX, signal });
+          return result.text;
+        }
         const reading = signal ? backend().readText(key, clean(path), WORKSPACE_TEXT_MAX, { signal }) : backend().readText(key, clean(path), WORKSPACE_TEXT_MAX);
         const r = signal ? await Promise.race([reading, new Promise<never>((_resolve, reject) => {
           rejectAbort = () => reject(new DOMException("已取消", "AbortError"));
@@ -129,6 +156,11 @@ export function createWorkspace(deps: {
       const p = clean(path);
       const max = opts.maxBytes ?? WORKSPACE_FILE_MAX;
       if(!Number.isFinite(max)||max<0)throw new RangeError("maxBytes 必须是非负有限字节数");
+      if (backend().fileSync && isOriginalDocument(p)) {
+        const result = await syncFile(backend().fileSync!, key, p, { signal: opts.signal, decode: false, range: { maxBytes: Math.min(max, FILE_SYNC_MAX) }, onProgress: progress => opts.onProgress?.(progress.loadedBytes) });
+        if (result.truncated) throw new Error(`文件超过 ${fmtSize(max)}，请用 fileUrl / download`);
+        return new Blob([result.bytes], { type: mimeOf(p) });
+      }
       // 太大的读到一半就停：整个读进内存会把页面撑爆。
       const ctl = new AbortController();
       const stop = () => ctl.abort();

package/src/chat/CliChat.tsx

@@ -20,9 +20,19 @@ import { exportMarkdown } from "./export";
 import { FileLinkContext, FileOpenContext } from "../ui/fileLinks";
 import { FileViewer } from "../board/FileViewer";
 import { BrowserPane } from "../board/BrowserPane";
+import { CliBoard } from "../board/CliBoard";
+import { WorkspaceTabs } from "../ui/WorkspaceTabs";
+import { WorkspaceDrawer, useWorkspaceDrawer } from "../ui/WorkspaceDrawer";
+import { useChatScrollbar } from "../ui/useChatScrollbar";
+import { QueuedMessages } from "../ui/QueuedMessages";
+import { ReferenceCard } from "../ui/ReferenceCard";
+import type { UploadDocument } from "../core/documentUpload";
+import { GroupChat, type GroupChatAdapter } from "./GroupChat";
 
 /** onTurnEnd / onConversationEnd：浏览器里从实时流算出的结果通知，不依赖 center 的 callback.url。 */
 export interface CliChatProps extends CliStoreOptions, ResultHandlers {
+  /** 宿主提供的多发言人群聊；发送统一交给 group.onSend，不连接普通单任务转录。 */
+  group?: GroupChatAdapter;
   /** Integration slots share this transcript/composer; they do not create another chat implementation. */
   slots?: { beforeMessages?: ReactNode; afterMessages?: ReactNode; composerToolbar?: ReactNode; beforeComposer?: ReactNode };
   /** Saving execution settings blocks send until persistence completes. */
@@ -77,6 +87,7 @@ export interface CliChatProps extends CliStoreOptions, ResultHandlers {
 
 export function CliChat(props: CliChatProps) {
   const ctx = useCliStoreContext();
+  if (props.group) return <CliErrorBoundary component="cli-chat" theme={props.theme}>{withOwnProvider(props, <GroupChat key={props.group.scopeKey} group={props.group} theme={props.theme} className={props.className} style={props.style} readOnly={props.readOnly} />, !!ctx)}</CliErrorBoundary>;
   return <CliErrorBoundary component="cli-chat" theme={props.theme}>{withOwnProvider(props, <ChatInner {...props} inProvider={!!ctx} />, !!ctx)}</CliErrorBoundary>;
 }
 
@@ -143,6 +154,7 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
   // 内部用对话键（key）：只有 job_id = 对话任务的第一个对话；"job#task" = 里面指定的那个对话（见 core/conversation.ts）。
   // 新对话的草稿按组件实例存（对话的草稿按对话键存，看同一个对话的组件共用一份是对的）。
   const instanceId = useId();
+  const inlineOwner = `chat-board-${instanceId}`;
   const controlled = jobIdProp !== undefined;
   // jobId 也可以直接给对话键（例如 cli-msglist 的 onSelect 给的 "job#task"），taskId 再给就以 taskId 为准。
   const keyProp = jobIdProp === undefined ? undefined : jobIdProp ? convKey(parseConvKey(jobIdProp).jobId, taskIdProp ?? parseConvKey(jobIdProp).taskId) : null;
@@ -164,6 +176,13 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
   }, [controlled, store]);
   const conv = useCliState((s) => (key && !isNew ? s.convs[key] : undefined)) ?? (key && !isNew ? emptyConv(key) : null);
   const entry = useCliState((s) => (jobId ? s.jobs[jobId] : undefined));
+  const externalBoardVisible = useCliState(s => !!(key && s.externalBoards[key]));
+  const listVisible = useCliState(s => s.listVisible);
+  const externalBoardOptions = useCliState(s => key ? s.externalBoardOptions[key] : undefined);
+  const [tabsHost, setTabsHost] = useState<HTMLDivElement | null>(null);
+  const [workspace, setWorkspace] = useState<{ key: string | null; active: boolean }>({ key: null, active: false });
+  const showChat = useCallback(() => setWorkspace({ key, active: false }), [key]);
+  const showWorkspace = useCallback(() => setWorkspace({ key, active: true }), [key]);
 
   // 看这个对话：开实时流（同一对话多处看只连一次）。
   useEffect(() => (key ? store.open(key) : undefined), [store, key]);
@@ -287,10 +306,6 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
   // 本组件的新建参数随每次发送带上：放进共享 Provider 时也用自己的，不依赖仓库是谁建的。
   const sendOpts = useRef({ newConversation, createConversation, businessIdFor, select: !controlled });
   useLayoutEffect(() => { sendOpts.current = { newConversation, createConversation, businessIdFor, select: !controlled }; });
-  const [skipPassive,setSkipPassive]=useState(false);
-  const skipPassiveRef=useRef(false);
-  useLayoutEffect(()=>{skipPassiveRef.current=skipPassive;},[skipPassive]);
-  useEffect(()=>setSkipPassive(false),[key]);
   const send = useCallback(async (text: string) => {
     // 一次性任务：发给正在看的那个子任务（接着它聊）。
     const id = latest.current.conv?.batch ? latest.current.runKey : latest.current.key;
@@ -299,7 +314,7 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
     const refKey = latest.current.key;
     const refs = refKey ? store.takeRefs(refKey) : [];
     const passiveView=refKey?store.getState().boardContext[refKey]:null;
-    const passive=passiveContext&&!skipPassiveRef.current&&passiveView?formatBoardContext(passiveView,refKey??undefined):'';
+    const passive=passiveContext&&passiveView?formatBoardContext(passiveView,refKey??undefined):'';
     const viewing = !passive && refKey ? store.takeViewing(refKey) : null;
     const blocks = [
       ...(passive ? [{name:"看板正在看",kind:"viewing" as const,text:passive}] : []),
@@ -309,13 +324,12 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
     const full = blocks.length ? [text, ...blocks.map(serializeBlock)].join("\n\n") : text;
     let target: string;
     try {
-      if(charCount(full)>MAX_MESSAGE_CHARS)throw new Error("加上看板背景后消息过长，请精简内容或取消本次自动附带。");
+      if(charCount(full)>MAX_MESSAGE_CHARS)throw new Error("加上看板背景后消息过长，请精简消息内容后重试。");
       target = await store.send(id ?? null, full, sendOpts.current);
     } catch (error) {
       if (refKey) { store.restoreRefs(refKey, refs); store.restoreViewing(refKey, viewing); }
       throw error;
     }
-    if(latest.current.key===refKey)setSkipPassive(false);
     if (target !== id && latest.current.key === refKey) go(target);
   }, [store, go, passiveContext]);
   const passiveView=useCliState(state=>key?state.boardContext[key]:undefined);
@@ -326,6 +340,7 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
   // 输入框上方显示哪些（config.refs）：不显示的照样随消息带上。正在看的缺省不显示。
   const viewing = !passiveText && viewingRef && refShown(cfg, "viewing") ? viewingRef : null;
   const shownRefs = refs?.filter((r) => refShown(cfg, r.kind));
+  const chatRef = useRef<HTMLDivElement>(null);
   // 业务方补充的背景（store.appendContext）：随下一条消息带上，输入框上方显示出来，让用户知道会带上什么。
   const contextItems = useCliState((s) => s.context[key ?? ""]);
   // AI 把浏览器交给用户（实时新来的「🖐 …」行）：同一 Provider 里有看板在看这个对话，就把看板切到浏览器（收起的会请宿主展开）。
@@ -340,8 +355,8 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
     if (!seen.ids) { seen.ids = new Set(handoffs.map((m) => m.id)); return; }
     const fresh = handoffs.filter((m) => !seen.ids!.has(m.id));
     for (const m of fresh) seen.ids.add(m.id);
-    if (fresh.length) store.openInBoard(key, { kind: "browser" });
-  }, [key, conv, fileOpen, store]);
+    if (fresh.length) store.openInBoard(key, { kind: "browser" }, inlineOwner);
+  }, [key, conv, fileOpen, store, inlineOwner]);
 
   // 对话里弹窗打开的文件 / 浏览器（没有看板接的时候）。换对话就关掉。
   const [popup, setPopup] = useState<{ kind: "file"; path: string } | { kind: "browser" } | null>(null);
@@ -353,7 +368,12 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
     return () => window.removeEventListener("keydown", onKey);
   }, [popup]);
   const handlers = useMemo<MessageHandlers>(() => ({
-    onQuote: readOnly ? undefined : (m,selected) => {const id=latest.current.key;if(id) store.addRef(id,{id:`message:${m.id}`,kind:"message",label:m.role==='user'?'引用你的消息':'引用智能体消息',text:selected||(m.role==='user'?withoutBoardContext(m.content):m.content)});},
+    onQuote: readOnly ? undefined : (m,selected) => {
+      const id = latest.current.key;
+      if (!id) return;
+      store.addRef(id,{id:`message:${m.id}`,kind:"message",label:m.role==='user'?'引用你的消息':'引用智能体消息',text:selected||(m.role==='user'?withoutBoardContext(m.content):m.content)});
+      chatRef.current?.querySelector<HTMLTextAreaElement>(".composer textarea")?.focus({ preventScroll: true });
+    },
     // 与 Operator 的 answerQuestion 一致：先把卡片标成已答，再把回答发出去（center 已结束提问那一轮，回答就是下一条消息）。
     onAnswer: readOnlyProp || (readOnly && !(batch && store.client.answerAsk)) ? undefined : async (askId: string, questions: AskQuestion[], answers: AskAnswers) => {
       const id = latest.current.key;
@@ -385,7 +405,7 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
     onShowBrowser: !store.client.board || fileOpen === "link" ? undefined : () => {
       const id = latest.current.key;
       if (!id) return;
-      if (fileOpen !== "modal" && store.openInBoard(id, { kind: "browser" })) return;
+      if (fileOpen !== "modal" && store.openInBoard(id, { kind: "browser" }, inlineOwner)) return;
       if (fileOpen !== "board") setPopup({ kind: "browser" });
     },
     onRetry: readOnly ? undefined : (msgId: string) => {
@@ -393,7 +413,7 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
       const at = list.findIndex((m) => m.id === msgId);
       for (let j = (at === -1 ? list.length : at) - 1; j >= 0; j--) if (list[j].role === "user") { void report(send(withoutBoardContext(list[j].content)), "重试没有发出去").catch(() => undefined); return; }
     },
-  }), [readOnly, readOnlyProp, batch, chat, send, store, go, report, fileOpen]);
+  }), [readOnly, readOnlyProp, batch, chat, send, store, go, report, fileOpen, inlineOwner]);
   const stop = useCallback(async () => {
     const { key: id, conv: c } = latest.current;
     const turn = c ? runningTurn(c) : null;
@@ -428,6 +448,7 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
 
   // ── 分窗渲染（移植自 Operator 的 SessionView）：DOM 里最多 RENDER_MAX 行，几千条消息也照样流畅 ──
   const scrollRef = useRef<HTMLDivElement>(null);
+  useChatScrollbar(scrollRef, key);
   const pinned = useRef(true);
   const [atBottom, setAtBottom] = useState(true);
   const committed = useMemo(() => messages.filter((m) => m.role !== "queued"), [messages]);
@@ -569,7 +590,7 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
       if (el && node) { const delta = node.getBoundingClientRect().top - a.top; if (Math.abs(delta) > 1) el.scrollTop += delta; }
     }
   }, [win]);
-  useLayoutEffect(() => { if (pinned.current && scrollRef.current) scrollRef.current.scrollTop = scrollRef.current.scrollHeight; }, [messages, running, startIdx, endIdx]);
+  useLayoutEffect(() => { if (pinned.current && scrollRef.current) scrollRef.current.scrollTop = scrollRef.current.scrollHeight; }, [messages, running, startIdx, endIdx, win]);
   useEffect(() => {
     const el = scrollRef.current;
     if (!el || typeof ResizeObserver === "undefined") return;
@@ -601,6 +622,18 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
   const fileUrlRef = useRef(fileUrl);
   fileUrlRef.current = fileUrl;
   const board = store.client.board;
+  const mobileWorkspace = useWorkspaceDrawer(chatRef);
+  const workspaceAvailable = h.show && !!key && !isNew && !!board && !externalBoardVisible;
+  const workspaceTabs = workspaceAvailable && !mobileWorkspace;
+  const workspaceActive = workspaceAvailable && workspace.key === key && workspace.active;
+  const showCurrentTitle = h.title || externalBoardVisible || (mobileWorkspace && workspaceAvailable);
+  const quoteToChat = useCallback(() => {
+    const sourceKey = key;
+    showChat();
+    requestAnimationFrame(() => {
+      if (keyRef.current === sourceKey) chatRef.current?.querySelector<HTMLTextAreaElement>(".composer textarea")?.focus({ preventScroll: true });
+    });
+  }, [key, showChat]);
   // 文件地址：宿主给的 fileUrl 优先；没给且后端有看板接口、地址能直接打开时，用 center 的文件接口。
   const resolveFile = useMemo(() => {
     if (fileUrl) return (path: string, kind: "link" | "image") => (jobId ? fileUrlRef.current?.(path, jobId, kind, taskId) ?? null : null);
@@ -611,27 +644,44 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
   const openFile = useMemo(() => {
     if (!key || fileOpen === "link") return null;
     return (path: string) => {
-      if (fileOpen !== "modal" && store.openInBoard(key, { kind: "file", path })) return true;
+      if (fileOpen !== "modal" && store.openInBoard(key, { kind: "file", path }, inlineOwner)) return true;
       if (fileOpen === "board" || !board) return false;
       setPopup({ kind: "file", path });
       return true;
     };
-  }, [key, fileOpen, store, board]);
+  }, [key, fileOpen, store, board, inlineOwner]);
+  const uploadDocument = useMemo<UploadDocument | undefined>(() => {
+    const staging = store.client.uploadDocument;
+    if (!key || isNew || !board?.uploadFile) return staging;
+    return async (file, options) => {
+      const target = await board.info(key);
+      if (options.signal?.aborted) throw new DOMException("上传已取消", "AbortError");
+      if (!target.dispatched) {
+        if (staging) return staging(file, options);
+        throw new Error("当前会话工作区尚未就绪");
+      }
+      const receipt = await board.uploadFile!(key, file, options);
+      if (!receipt.path) throw new Error("文件尚未进入当前工作区，请重试");
+      if (!options.signal?.aborted && latest.current.key === key) openFile?.(receipt.path);
+      return receipt;
+    };
+  }, [store, key, isNew, board, openFile]);
 
   return (
     <FileLinkContext.Provider value={resolveFile}>
     <FileOpenContext.Provider value={openFile}>
-    <div className={`cli-ui cli-chat ${className ?? ""}`} data-theme={theme} style={style}>
+    <div ref={chatRef} className={`cli-ui cli-chat ${className ?? ""}`} data-theme={theme} style={style}>
       <div className="session">
-        {h.show && (h.crumb || h.export || h.title || h.agent || h.usage || h.model || h.status || h.close) && <div className="sess-head">
-          {(h.crumb || h.title) && <div className="sh-main">
+        {h.show && (workspaceAvailable || externalBoardVisible || h.crumb || h.export || h.title || h.agent || h.usage || h.model || h.status || h.close) && <div className="sess-head">
+          {workspaceTabs ? <WorkspaceTabs title={convTitle} subtitle={h.crumb ? title : undefined} chatActive={!workspaceActive} onChat={showChat} onTabsHost={setTabsHost} /> : (h.crumb || showCurrentTitle) && <div className="sh-main">
             {h.crumb && <div className="crumb">
                 <span className="pic" style={{ width: 16, height: 16, borderRadius: 5, background: color, display: "grid", placeItems: "center", color: "#fff", fontSize: 9, fontWeight: 700 }}>{title[0]}</span>
                 {title} <span className="sep">/</span> 对话
             </div>}
-            {h.title && <div className="sh-title"><span className="sht-text" title={convTitle}>{convTitle}</span></div>}
+            {showCurrentTitle && <div className="sh-title"><span className="sht-text" title={convTitle}>{convTitle}</span></div>}
           </div>}
           <div className="sh-tools">
+            {mobileWorkspace && workspaceAvailable && <button type="button" className="btn btn-ghost btn-sm workspace-open" aria-label="打开工作区" aria-haspopup="dialog" aria-expanded={workspaceActive} title="打开工作区" onClick={showWorkspace}>{Icon.board()}</button>}
             {h.agent && agent && <AgentBadge label={agentText} />}
             {h.usage && (fresh > 0 || cacheRead > 0) && (
               <span className="usage-chip" title={`新增 ${fresh.toLocaleString()} tokens${cacheRead ? `\n缓存读取 ${cacheRead.toLocaleString()}（每轮重复读取的上下文）` : ""}`}>
@@ -661,6 +711,7 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
           </div>
         </div>}
 
+        <div className="workspace-chat-content" data-chat-layout={listVisible || externalBoardVisible ? "wide" : "centered"} hidden={workspaceActive && !mobileWorkspace} style={workspaceActive && !mobileWorkspace ? { display: "none" } : undefined}>
         {closing !== "idle" && key && (
           <div className="clear-confirm">
             <span>结束这个对话？结束后不能再发消息{running ? "，正在执行的一轮会被中止" : ""}{taskId && manyConvs ? "；同一任务里的其他对话不受影响" : ""}。</span>
@@ -737,7 +788,6 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
                 </div>
               )}
               {cfg.transcript.runningIndicator && running && !awaiting && !awaitingAnswer && !hasBelow && <RunningIndicator agent={agent} agentName={cfg.labels.agent} startedAt={turnStartedAt} lastActivityRef={lastActivityRef} />}
-              {!hasBelow && queued.map((m) => <MessageView key={m.id} m={m} initial={false} hideWho={false} handlers={handlers} view={view} />)}
               {ended && cfg.transcript.status && (
                 <div className="session-label"><span className="ln" />{batch ? statusText : <>{REASON_TEXT[closedReason ?? ""] ?? "对话已结束"}{!finalEnd ? " · 再发消息会开一个新对话接着聊" : ""}</>}<span className="ln" /></div>
               )}
@@ -763,42 +813,24 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
             ))}
           </div>
         )}
-        {showComposer && (!!shownRefs?.length || !!viewing) && (
-          <div className="cli-refs" aria-label="引用自看板，下一条消息会带上">
-            <span className="cli-refs-t">{Icon.board()} 引用自看板</span>
-            {viewing && (
-              <span className="cli-ref auto" title={`${viewing.text}\n（看板上正在看，下一条消息缺省带上；点 × 这次不带）`}>
-                <span className="cli-ref-k">正在看</span>
-                <span className="cli-ref-l">{viewing.label}</span>
-                <button className="cli-ref-x" onClick={() => key && store.dismissViewing(key)} title="这次不带上" aria-label={`不带上 ${viewing.label}`}>{Icon.x()}</button>
-              </span>
-            )}
-            {(shownRefs ?? []).map((r) => (
-              <span key={r.id} className={`cli-ref ${r.kind === "selection" ? "sel" : ""}`} title={r.text}>
-                <span className="cli-ref-l">{r.label}</span>
-                <button className="cli-ref-x" onClick={() => key && store.removeRef(key, r.id)} title="不带上" aria-label={`不带上 ${r.label}`}>{Icon.x()}</button>
-              </span>
-            ))}
-          </div>
-        )}
-        {showComposer && passiveText && passiveView && <div className="cli-board-background" role="note" aria-label="看板浏览背景">
-          <details><summary>看板背景 · {(passiveView.current?.path??passiveView.file)?.split('/').pop()??'未选中文件'} · 打开 {(passiveView.opened??passiveView.files).length} · 最近浏览 {passiveView.history?.length??0}</summary>
-            <div>{passiveView.visible===false?'看板已收起，将附带上次选中的文件及浏览记录。':'将附带当前文件、打开页签和最近浏览记录，仅发送路径等信息。'}</div>
-            <ul>{(passiveView.history??[]).map((file,index)=><li key={`${file.sourceId}:${file.path}:${index}`}>{file.path}{file.sourceId&&file.sourceId!==key?'（来源任务）':''}</li>)}</ul>
-          </details>
-          <label><input type="checkbox" checked={!skipPassive} onChange={event=>setSkipPassive(!event.target.checked)} />下条消息带入</label>
-        </div>}
         {slots?.beforeComposer}
+        {!showComposer && <QueuedMessages scopeKey={key ?? "new"} messages={queued} onCancel={handlers.onCancelQueued} attachmentUrl={handlers.attachmentUrl} />}
         {showComposer && (
           <Composer
+            uploadDocument={uploadDocument}
             key={key ?? "new"}
             draft={store.draftScope ? `${store.draftScope}:${key ?? `new:${instanceId}`}` : key ?? `new:${instanceId}`}
+            context={(!!shownRefs?.length || !!viewing) && <div className="cli-refs composer-references" aria-label="下一条消息的引用">
+              {viewing && <ReferenceCard key={`${key}:viewing:${viewing.id}`} className="reference-viewing" title={`正在看${viewing.label}`} text={viewing.text} disabled={composerDisabled || !!configurationBusy} removeLabel={`不带上 ${viewing.label}`} onRemove={() => { if (key) store.dismissViewing(key); chatRef.current?.querySelector<HTMLTextAreaElement>(".composer textarea")?.focus({ preventScroll: true }); }} />}
+              {(shownRefs ?? []).map(ref => <ReferenceCard key={`${key}:${ref.id}`} title={ref.kind === "message" && ref.label === "引用你的消息" ? "你" : ref.kind === "message" && ref.label === "引用智能体消息" ? "智能体" : ref.label} text={ref.text} disabled={composerDisabled || !!configurationBusy} removeLabel={`不带上 ${ref.label}`} onRemove={() => { if (key) store.removeRef(key, ref.id); chatRef.current?.querySelector<HTMLTextAreaElement>(".composer textarea")?.focus({ preventScroll: true }); }} />)}
+            </div>}
             placeholder={fillTemplate(key && !isNew ? cfg.composer.placeholder : cfg.composer.placeholderNew, { title: convTitle, agent: agentText })}
             disabled={composerDisabled || !!configurationBusy}
             disabledHint={cfg.composer.placeholderDisabled ? fillTemplate(cfg.composer.placeholderDisabled, { title: convTitle, agent: agentText }) : disabledHint}
             running={running || batchPending}
             toolbar={slots?.composerToolbar}
-            onSend={async text => { if (text.trim() === "/clear" && onClear) { onClear(); return; } await send(text); }}
+            queued={<QueuedMessages scopeKey={key ?? "new"} messages={queued} onCancel={handlers.onCancelQueued} attachmentUrl={handlers.attachmentUrl} />}
+            onSend={async text => { if (text.trim() === "/clear" && onClear) { onClear(); return; } const sentFrom = key; await send(text); if (!running && !batchPending && latest.current.key === sentFrom) scrollToBottom("auto"); }}
             onStop={cfg.composer.stop && key && conv && runningTurn(conv) ? stop : undefined}
             taskControl={cfg.composer.stop && !readOnlyProp && controlTask && jobId && store.client.pauseTask && store.client.resumeTask ? {
               paused: controlTask.status === "paused",
@@ -810,6 +842,14 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
             options={composerOptions}
           />
         )}
+        </div>
+        <WorkspaceDrawer enabled={mobileWorkspace} open={workspaceActive} onClose={showChat}>
+        {workspaceAvailable && <CliBoard jobId={key} inlineOwner={inlineOwner} quoteToChat={!readOnly} autoQuoteOpenFile={passiveContext}
+          readOnly={readOnly || externalBoardOptions?.readOnly} availableTabs={externalBoardOptions?.availableTabs}
+          acceptOpen={fileOpen !== "modal" && fileOpen !== "link"} theme={theme}
+          visible={workspaceActive} onExpand={showWorkspace} onQuoteToChat={quoteToChat}
+          inlineLayout={mobileWorkspace ? undefined : { tabsHost, active: workspaceActive, onActivate: showWorkspace, onChat: showChat }} />}
+        </WorkspaceDrawer>
       </div>
       {popup && key && board && (
         <div className="scrim" onClick={(e) => { if (e.target === e.currentTarget) setPopup(null); }}>