@spzxg/cli-ui 0.6.5 → 0.6.6

package/src/board/workspace.ts

@@ -62,7 +62,7 @@ export interface CliWorkspace {
   /** 列 dir 下所有文件（递归，只含文件）。 */
   listAll(dir?: string, opts?: { signal?: AbortSignal }): Promise<FileEntry[]>;
   /** 读成文字（GBK 导出的文件会自动转码）。 */
-  readText(path: string): Promise<string>;
+  readText(path: string, opts?: { signal?: AbortSignal }): Promise<string>;
   /** 读成 Blob。onProgress 报已收到的字节数；超过 maxBytes（缺省 500 MB）报错，改用 fileUrl / download。 */
   readFile(path: string, opts?: { signal?: AbortSignal; onProgress?: (bytes: number) => void; maxBytes?: number }): Promise<Blob>;
   /** 浏览器能直接打开 / 下载的地址（没有同源代理时是 30 分钟有效的短期链接）；接入方式不支持时为 null，改用 readFile。 */
@@ -110,10 +110,20 @@ export function createWorkspace(deps: {
       const files = await listFolder(backend(), key, clean(dir), { signal: opts.signal, maxFiles: WORKSPACE_LIST_MAX, maxBytes: Infinity });
       return files.map((f) => ({ name: f.path.split("/").pop() || f.path, path: f.path, type: "file" as const, size: f.size, mtime: f.mtime }));
     },
-    async readText(path) {
-      const r = await backend().readText(key, clean(path), WORKSPACE_TEXT_MAX);
-      if (r.truncated) throw new Error(`文件较大（超过 ${WORKSPACE_TEXT_MAX / 1024 / 1024} MB），请用 readFile 读成 Blob`);
-      return r.text;
+    async readText(path, opts = {}) {
+      const signal = opts.signal;
+      if (signal?.aborted) throw new DOMException("已取消", "AbortError");
+      let rejectAbort: (() => void) | undefined;
+      try {
+        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"));
+          signal.addEventListener("abort", rejectAbort, { once: true });
+          if (signal.aborted) rejectAbort();
+        })]) : await reading;
+        if (r.truncated) throw new Error(`文件较大（超过 ${WORKSPACE_TEXT_MAX / 1024 / 1024} MB），请用 readFile 读成 Blob`);
+        return r.text;
+      } finally { if (rejectAbort) signal?.removeEventListener("abort", rejectAbort); }
     },
     async readFile(path, opts = {}) {
       const p = clean(path);

package/src/chat/CliChat.tsx

@@ -169,7 +169,7 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
   useEffect(() => (key ? store.open(key) : undefined), [store, key]);
   // 正在看的对话被接续成了新 job（别处发消息触发的也算）：跟过去。
   const keyRef = useRef(key);
-  keyRef.current = key;
+  useLayoutEffect(() => { keyRef.current = key; }, [key]);
   useEffect(() => store.on((event) => {
     if (event.type === "job_change" && event.previousKey && event.previousKey === keyRef.current) go(event.key);
   }), [store, go]);
@@ -235,7 +235,13 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
       : jobTitle ?? (key ? "对话" : "新对话");
   const awaitingAnswer = useMemo(() => hasOpenAsk(messages), [messages]);
   const lastTurn = conv?.turns[conv.turns.length - 1];
-  const awaiting = !ended && !running && !!lastTurn?.asked && lastTurn.status === "succeeded";
+  const listedAwaiting = (info ?? job?.conversation?.conversations?.find(item => item.task_id === task?.id))?.awaiting_input;
+  // An explicit null retires an old wait flag when its node observation expires.
+  const remoteAwaiting = conv?.task?.awaiting_input !== undefined ? conv.task.awaiting_input
+    : listedAwaiting !== undefined ? listedAwaiting : task?.awaiting_input !== undefined ? task.awaiting_input
+    : !manyConvs ? job?.conversation?.awaiting_input : undefined;
+  const awaiting = !ended && !TERMINAL_JOB.has(jobStatus ?? "") && !(batch && batchTaskStatus && SETTLED_TASK.has(batchTaskStatus))
+    && (remoteAwaiting === true || (!running && !!lastTurn?.asked && lastTurn.status === "succeeded"));
   // 一次性任务的子任务还没派发（没有节点对话）、或者流已经结束还没有转录：不再转圈，转录里有说明。
   const loading = !!key && !isNew && !!conv && !conv.hasTranscript && !conv.turns.length && conv.stream !== "error" && conv.stream !== "ended" && !(conv.batch && !conv.remoteTaskId);
   const batchStatus = batch ? conv?.batchTask?.status ?? task?.status ?? null : null;
@@ -248,9 +254,9 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
 
   const { dotCls, statusText } = useMemo((): { dotCls: DotCls; statusText: string } => {
     if (!key || isNew) return { dotCls: "r", statusText: "未开始" };
+    if (awaiting) return { dotCls: "a", statusText: "需要你处理" };
     if (batch && !chat) return batchStatusView(batchStatus, jobStatus);
     if (ended) return { dotCls: status === "succeeded" ? "g" : "x", statusText: REASON_TEXT[closedReason ?? ""] ?? (status === "succeeded" ? "已结束" : status === "cancelled" ? "已取消" : "已失败") };
-    if (awaiting) return { dotCls: "a", statusText: "需要你处理" };
     if (running) return { dotCls: "a", statusText: "运行中" };
     if (status === "queued") return { dotCls: "a", statusText: "等待执行节点" };
     return { dotCls: "a", statusText: "进行中" };
@@ -261,12 +267,13 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
   const [actionError, setActionError] = useState<string | null>(null);
   useEffect(() => setActionError(null), [key]);
   const report = useCallback(async <T,>(work: Promise<T>, what: string) => {
+    const sourceKey = keyRef.current;
     try {
       const result = await work;
-      setActionError(null);
+      if (keyRef.current === sourceKey) setActionError(null);
       return result;
     } catch (error) {
-      setActionError(`${what}：${error instanceof Error ? error.message : String(error)}`);
+      if (keyRef.current === sourceKey) setActionError(`${what}：${error instanceof Error ? error.message : String(error)}`);
       throw error;
     }
   }, []);
@@ -274,12 +281,15 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
   // （几个子任务同时跑时，卡片属于它，不是中枢缺省的那个）。和能不能发消息无关。
   const runKey = batch && !taskId && conv?.task?.id && jobId ? convKey(jobId, conv.task.id) : key;
   const latest = useRef({ key, messages, conv, runKey });
-  latest.current = { key, messages, conv, runKey };
+  // A concurrent render may suspend while the old chat remains interactive.
+  // Event handlers must keep the target and options of the committed view.
+  useLayoutEffect(() => { latest.current = { key, messages, conv, runKey }; });
   // 本组件的新建参数随每次发送带上：放进共享 Provider 时也用自己的，不依赖仓库是谁建的。
   const sendOpts = useRef({ newConversation, createConversation, businessIdFor, select: !controlled });
-  sendOpts.current = { newConversation, createConversation, businessIdFor, select: !controlled };
+  useLayoutEffect(() => { sendOpts.current = { newConversation, createConversation, businessIdFor, select: !controlled }; });
   const [skipPassive,setSkipPassive]=useState(false);
-  const skipPassiveRef=useRef(false);skipPassiveRef.current=skipPassive;
+  const skipPassiveRef=useRef(false);
+  useLayoutEffect(()=>{skipPassiveRef.current=skipPassive;},[skipPassive]);
   useEffect(()=>setSkipPassive(false),[key]);
   const send = useCallback(async (text: string) => {
     // 一次性任务：发给正在看的那个子任务（接着它聊）。
@@ -306,7 +316,7 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
       throw error;
     }
     if(latest.current.key===refKey)setSkipPassive(false);
-    if (target !== id) go(target);
+    if (target !== id && latest.current.key === refKey) go(target);
   }, [store, go, passiveContext]);
   const passiveView=useCliState(state=>key?state.boardContext[key]:undefined);
   const passiveText=passiveContext&&passiveView?formatBoardContext(passiveView,key??undefined):'';
@@ -351,7 +361,7 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
       // 一次性任务：提问时回合开着等，答案直接交给节点；不能改发消息。
       if (batch && !chat) { await report(store.answerAsk(latest.current.runKey ?? id, askId, questions, answers, { fallback: false }).then(() => undefined), "回答没有送到"); return; }
       const sent = askId
-        ? store.answerAsk(id, askId, questions, answers, sendOpts.current).then((target) => { if (target !== id) go(target); })
+        ? store.answerAsk(id, askId, questions, answers, sendOpts.current).then((target) => { if (target !== id && latest.current.key === id) go(target); })
         : send(formatAnswersText(questions, answers));
       await report(sent, "回答没有发出去");
     },
@@ -726,7 +736,7 @@ function ChatInner({ slots, passiveContext = true, configurationBusy, onClear, j
                   <button className="btn btn-ghost btn-sm" onClick={() => scrollToBottom("auto")}>跳到最新</button>
                 </div>
               )}
-              {cfg.transcript.runningIndicator && running && !awaitingAnswer && !hasBelow && <RunningIndicator agent={agent} agentName={cfg.labels.agent} startedAt={turnStartedAt} lastActivityRef={lastActivityRef} />}
+              {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>

package/src/chat/Composer.tsx

@@ -67,7 +67,9 @@ export function Composer({ draft, placeholder, disabled, disabledHint, running,
       readFileText(file)
         .then((text) => {
           if (!text.trim()) throw new Error(`「${file.name}」里没有可读的文字`);
-          updateComposerDraft(draft, s => ({ ...s, pending: s.pending.filter(p => p.key !== key), blocks: [...s.blocks, { key, name: file.name, text, kind: "file" }] }));
+          updateComposerDraft(draft, s => s.pending.some(p => p.key === key && p.status === "reading")
+            ? { ...s, pending: s.pending.filter(p => p.key !== key), blocks: [...s.blocks, { key, name: file.name, text, kind: "file" }] }
+            : s);
         })
         .catch((err: unknown) => {
           setPending((prev) => prev.map((p) => (p.key === key ? { ...p, status: "error", error: err instanceof Error ? err.message : String(err) } : p)));
@@ -142,7 +144,7 @@ export function Composer({ draft, placeholder, disabled, disabledHint, running,
                 <div key={p.key} className={`attach-chip file ${p.status}`} title={p.error || p.name}>
                   <span className="attach-file">{Icon.doc()} {p.name}</span>
                   <span className={`attach-badge ${p.status === "error" ? "err" : ""}`}>{p.status === "reading" ? "解析中…" : p.error}</span>
-                  {p.status === "error" && <button className="attach-x" title="移除" aria-label={`移除 ${p.name}`} onClick={() => setPending((prev) => prev.filter((x) => x.key !== p.key))}>×</button>}
+                  <button type="button" className="attach-x" title={p.status === "reading" ? "取消添加，忽略尚未完成的解析结果" : "移除"} aria-label={`移除 ${p.name}`} onClick={() => setPending((prev) => prev.filter((x) => x.key !== p.key))}>×</button>
                 </div>
               ))}
             </div>

package/src/core/blocks.ts

@@ -48,16 +48,16 @@ export function backgroundBlock(items: Array<{ title?: string; text: string }>):
   return { name: BACKGROUND_NAME, kind: "background", text: `以下是补充的项目背景信息，请在这次及之后的工作中一并参考：\n\n${body}` };
 }
 
-/** 支持的文件：只收文档——Word（.docx）、Excel（.xlsx / .xlsm）、Markdown、TXT、HTML、CSV / TSV。都在浏览器里转成文字。 */
-export const ACCEPTED_EXTENSIONS = [".docx", ".xlsx", ".xlsm", ".md", ".markdown", ".txt", ".html", ".htm", ".csv", ".tsv"] as const;
+/** 支持的文件：只收文档——Word（.docx）、Excel（.xlsx / .xlsm）、Markdown、TXT、YAML、HTML、CSV / TSV。都在浏览器里转成文字。 */
+export const ACCEPTED_EXTENSIONS = [".docx", ".xlsx", ".xlsm", ".md", ".markdown", ".txt", ".yaml", ".yml", ".html", ".htm", ".csv", ".tsv"] as const;
 export const ACCEPT_ATTR = [
   ...ACCEPTED_EXTENSIONS,
-  "text/plain", "text/markdown", "text/html", "text/csv", "text/tab-separated-values",
+  "text/plain", "text/markdown", "text/yaml", "application/yaml", "text/html", "text/csv", "text/tab-separated-values",
   "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
   "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "application/vnd.ms-excel.sheet.macroEnabled.12",
 ].join(",");
 /** 不支持时提示里列的格式。 */
-export const ACCEPTED_LABEL = "Word（.docx）、Excel（.xlsx）、Markdown、TXT、HTML、CSV";
+export const ACCEPTED_LABEL = "Word（.docx）、Excel（.xlsx）、Markdown、TXT、YAML（.yaml / .yml）、HTML、CSV";
 /** 一些常见但读不了的文档：给出另存为什么。 */
 const SAVE_AS: Record<string, string> = {
   ".doc": "老版 Word（.doc）请另存为 .docx 后再上传",
@@ -72,6 +72,8 @@ export const PASTE_BLOCK_CHARS = 2_000;
 export const PASTE_BLOCK_LINES = 40;
 /** center 单条消息上限（POST /api/jobs/:id/messages 的 text 最长 200,000 字符）。 */
 export const MAX_MESSAGE_CHARS = 200_000;
+/** Same source-file budget as the full node composer; reject before reading/parsing. */
+export const MAX_DOCUMENT_BYTES = 10 * 1024 * 1024;
 export const PASTE_NAME = "粘贴的文本";
 
 const OPEN = /^----- 附件：(.+?)（[\d,]+ 字）-----$/;
@@ -138,6 +140,13 @@ export class FileReadError extends Error {}
  * 其他文件（图片、PDF、压缩包……）不收；老版 .doc / .xls 浏览器里读不了，提示另存为。
  */
 export async function readFileText(file: File): Promise<string> {
+  if (file.size > MAX_DOCUMENT_BYTES) throw new FileReadError(`“${file.name}”超过 10 MB，请缩小后重试。`);
+  const text = await extractFileText(file);
+  if (text.length > MAX_MESSAGE_CHARS) throw new FileReadError(`“${file.name}”解析后的正文超过 ${MAX_MESSAGE_CHARS.toLocaleString("en-US")} 字符，请拆分后重试。`);
+  return text;
+}
+
+async function extractFileText(file: File): Promise<string> {
   const ext = extensionOf(file.name);
   if (SAVE_AS[ext]) throw new FileReadError(`不支持这种格式：${SAVE_AS[ext]}`);
   if (!(ACCEPTED_EXTENSIONS as readonly string[]).includes(ext)) throw new FileReadError(`「${file.name}」不是支持的文档，只能上传 ${ACCEPTED_LABEL}`);
@@ -165,6 +174,8 @@ export async function readFileText(file: File): Promise<string> {
     }
   }
   const { text } = decodeText(new Uint8Array(await readAs(file, "buffer")));
+  // YAML literal scalars depend on blank lines, indentation and the final newline.
+  if (ext === ".yaml" || ext === ".yml") return text;
   if (ext === ".html" || ext === ".htm") return normalizeText(text.replace(INLINE_DATA, (m) => `${m.slice(0, m.indexOf(",") + 1)}…（内嵌数据已省略）`));
   return normalizeText(text);
 }

package/src/core/client.ts

@@ -2,7 +2,7 @@ import { createSseParser } from "./sse";
 import { NEW_TASK, parseConvKey } from "./conversation";
 import type {
   BoardInfo, BrowserMessage, BrowserStatus, CenterJob, CenterTask, CenterTurn, DiffResult, DirListing, FileInfo, Message,
-  BatchStreamSnapshot, BrowserFramesState, NewConversationOptions, SendResult, StreamEnd, StreamItem, StreamSnapshot,
+  BatchStreamSnapshot, BrowserFramesState, NewConversationOptions, SendResult, StreamEnd, StreamItem, StreamSnapshot, WorkspaceFileBatch,
 } from "./types";
 import { decodeText } from "./textDecode";
 
@@ -78,6 +78,11 @@ const ERROR_TEXT: Record<string, string> = {
   task_already_finished: "当前子任务已经结束，请刷新状态后继续",
   task_not_paused: "当前子任务没有暂停，请刷新状态后重试",
   job_already_paused: "整个任务已暂停，请先恢复整个任务",
+  file_watch_unsupported: "当前服务不支持文件事件",
+  browser_required: "传递浏览器 YAML 手册或操作间隔时，需要同时启用 browser: true",
+  invalid_browser_playbook: "浏览器 YAML 手册校验失败，请检查格式和步骤配置",
+  invalid_browser_pacing: "浏览器操作间隔无效，请检查最小值和最大值",
+  conversation_browser_fields_fixed: "浏览器手册和操作间隔在创建对话时确定，追加消息不能修改",
 };
 
 /**
@@ -158,12 +163,12 @@ export interface BoardBackend {
    * tail = 读末尾那一段（超大日志）；节点不支持只读一段时退回开头（返回的 tail 为 false）。
    * 不是 UTF-8 的（GBK 导出的 CSV 之类）按 GB18030 解，encoding 说明按什么解的。
    */
-  readText(jobId: string, path: string, maxBytes?: number, opts?: { tail?: boolean; onBytes?: (bytes: number) => void }): Promise<TextChunk>;
+  readText(jobId: string, path: string, maxBytes?: number, opts?: { tail?: boolean; signal?: AbortSignal; onBytes?: (bytes: number) => void }): Promise<TextChunk>;
   /**
    * 读一段原始字节：从 start 开始（缺省 0）最多 maxBytes；tail = 末尾 maxBytes。返回这段在文件里的起点和文件总大小。
    * 看板用它在文件变长时只取新增的部分（日志、还在写的报告），不整个重读。没有这个方法的后端每次整个重读。
    */
-  readBytes?(jobId: string, path: string, opts: { start?: number; maxBytes: number; tail?: boolean; onBytes?: (bytes: number) => void }): Promise<ByteChunk>;
+  readBytes?(jobId: string, path: string, opts: { start?: number; maxBytes: number; tail?: boolean; signal?: AbortSignal; onBytes?: (bytes: number) => void }): Promise<ByteChunk>;
   /**
    * 读整个文件。signal 取消（打包下载点了取消）；onBytes 报已收到的字节数（大文件显示进度）。
    * 弱网：FILE_HEADER_TIMEOUT_MS 内没回响应头、或传输中 FILE_STALL_MS 没收到数据，按网络错误（NETWORK）失败。
@@ -325,7 +330,9 @@ export function createCenterClient(options: CenterClientOptions = {}): Conversat
           ...(opts.businessId ? { business_id: opts.businessId } : {}),
           ...(opts.agent ? { agent: opts.agent } : {}),
           ...(opts.timeoutSeconds ? { timeout_seconds: opts.timeoutSeconds } : {}),
-          ...(opts.browser ? { browser: true } : {}),
+          ...(opts.browser !== undefined ? { browser: opts.browser } : {}),
+          ...(opts.browserPlaybook !== undefined ? { browser_playbook: opts.browserPlaybook } : {}),
+          ...(opts.browserPacing !== undefined ? { browser_pacing: opts.browserPacing } : {}),
         }],
       });
     },
@@ -465,6 +472,13 @@ function openSse(
     try {
       arm();
       const response = await doFetch(url, { headers: { ...headers, Accept: "text/event-stream" }, signal: ctl.signal });
+      // A host-supplied fetch may resolve after cancellation despite signal.
+      // Retire its body before acquiring a reader or restarting the watchdog.
+      if (ctl.signal.aborted) {
+        void response.body?.cancel().catch(() => undefined);
+        if (silent) onClose?.(new CenterError("连接长时间没有数据，已断开重连", "NETWORK", 0));
+        return;
+      }
       if (!response.ok || !response.body) {
         const body = (await response.json().catch(() => null)) as { error?: string; detail?: string } | null;
         throw new CenterError(body?.detail ?? ERROR_TEXT[body?.error ?? ""] ?? `连接失败（HTTP ${response.status}）`, body?.error ?? `HTTP_${response.status}`, response.status);
@@ -520,6 +534,31 @@ function boardPath(key: string, rest: string, query = "") {
   return `/api/jobs/${job}/${rest}${params ? `?${params}` : ""}`;
 }
 
+/** Reject a malformed manifest as a whole: silently dropping entries could invent deletions. */
+function isWorkspaceFileBatch(value: unknown): value is WorkspaceFileBatch {
+  if (!value || typeof value !== "object") return false;
+  const batch = value as Record<string, unknown>;
+  if (typeof batch.complete !== "boolean" || (batch.revision !== undefined && typeof batch.revision !== "string")) return false;
+  const file = (value: unknown) => {
+    if (!value || typeof value !== "object") return false;
+    const entry = value as Record<string, unknown>;
+    return typeof entry.name === "string" && typeof entry.path === "string" && !!entry.path
+      && (entry.type === "file" || entry.type === "dir")
+      && typeof entry.size === "number" && Number.isFinite(entry.size) && entry.size >= 0
+      && typeof entry.mtime === "number" && Number.isFinite(entry.mtime)
+      && (entry.changeToken === undefined || typeof entry.changeToken === "string");
+  };
+  if (batch.type === "snapshot") return Array.isArray(batch.files) && batch.files.every(file);
+  if (batch.type === "resync") return batch.complete === false && typeof batch.reason === "string";
+  return batch.type === "changes" && Array.isArray(batch.changes) && batch.changes.every(value => {
+    if (!value || typeof value !== "object") return false;
+    const change = value as Record<string, unknown>;
+    return ["created", "modified", "deleted"].includes(String(change.kind)) && typeof change.path === "string" && !!change.path
+      && (change.file === undefined || (file(change.file) && (change.file as { path: string }).path === change.path))
+      && (change.previous === undefined || (file(change.previous) && (change.previous as { path: string }).path === change.path));
+  });
+}
+
 function createBoardClient(
   base: string,
   headers: (extra?: Record<string, string>) => Record<string, string>,
@@ -548,7 +587,11 @@ function createBoardClient(
         if (ctl.signal.aborted) reject(new DOMException("aborted", "AbortError"));
         ctl.signal.addEventListener("abort", () => reject(new DOMException("aborted", "AbortError")), { once: true });
       });
-      response = await Promise.race([doFetch(boardFileUrl(base, jobId, path), { headers: headers(extra), signal: ctl.signal, cache: "no-store" }), stopped]);
+      const fetching = doFetch(boardFileUrl(base, jobId, path), { headers: headers(extra), signal: ctl.signal, cache: "no-store" });
+      // Host fetch adapters can ignore abort. Dispose a response that arrives
+      // after the caller already cancelled or timed out.
+      void fetching.then(late => { if (ctl.signal.aborted) void late.body?.cancel().catch(() => undefined); }, () => undefined);
+      response = await Promise.race([fetching, stopped]);
     } catch (error) {
       release();
       if (signal?.aborted) throw aborted();
@@ -556,21 +599,19 @@ function createBoardClient(
       throw new CenterError(`连不上任务中心：${error instanceof Error ? error.message : String(error)}`, "NETWORK", 0);
     }
     clearTimeout(timer);
-    if (!response.ok && response.status !== 416) {
-      release();
-      const body = (await response.json().catch(() => null)) as { error?: string; detail?: string } | null;
-      const fallback = response.status === 404 ? "文件不存在（可能已被任务删除或改名）" : body?.error ?? `读取失败（HTTP ${response.status}）`;
-      throw new CenterError(body?.detail ?? ERROR_TEXT[body?.error ?? ""] ?? fallback, body?.error ?? `HTTP_${response.status}`, response.status);
-    }
     const stallError = () => new CenterError(`读取「${name}」时 ${FILE_STALL_MS / 1000} 秒没有收到数据，传输已中断，请重试`, "NETWORK", 0);
     /** 读响应体：limit 读够就停；onBytes 报进度；FILE_STALL_MS 没数据当断线。 */
     const body = async (opts: { limit?: number; onBytes?: (bytes: number) => void } = {}): Promise<Uint8Array<ArrayBuffer>> => {
+      if (signal?.aborted) { release(); void response.body?.cancel().catch(() => undefined); throw aborted(); }
       // 空文件要「前 N 字节」：节点回 416，就是空的。
       if (response.status === 416) { release(); return new Uint8Array(0); }
       const reader = response.body?.getReader();
       if (!reader) {
         try { return new Uint8Array(await response.arrayBuffer()); } finally { release(); }
       }
+      const cancelBody = () => { void reader.cancel().catch(() => undefined); };
+      ctl.signal.addEventListener("abort", cancelBody, { once: true });
+      if (ctl.signal.aborted) cancelBody();
       const chunks: Uint8Array[] = [];
       let got = 0;
       let stalled = false;
@@ -598,6 +639,11 @@ function createBoardClient(
         throw new CenterError(`读取「${name}」中断：${error instanceof Error ? error.message : String(error)}`, "NETWORK", 0);
       } finally {
         clearTimeout(stall);
+        ctl.signal.removeEventListener("abort", cancelBody);
+        // Progress callbacks may throw too; no abandoned response should keep
+        // consuming the mobile connection after the read has failed.
+        void reader.cancel().catch(() => undefined);
+        try { reader.releaseLock(); } catch { /* already released */ }
         release();
       }
       if (signal?.aborted) throw aborted();
@@ -612,16 +658,25 @@ function createBoardClient(
       }
       return all;
     };
+    if (!response.ok && response.status !== 416) {
+      // Error bodies need the same abort/stall bounds as file data. A proxy
+      // returning 401 headers and then hanging must not park a read forever.
+      const bytes = await body({ limit: 8192 });
+      let problem: { error?: string; detail?: string } | null = null;
+      try { problem = JSON.parse(new TextDecoder().decode(bytes)); } catch { /* use the HTTP fallback */ }
+      const fallback = response.status === 404 ? "文件不存在（可能已被任务删除或改名）" : problem?.error ?? `读取失败（HTTP ${response.status})`;
+      throw new CenterError(problem?.detail ?? ERROR_TEXT[problem?.error ?? ""] ?? fallback, problem?.error ?? `HTTP_${response.status}`, response.status);
+    }
     return { response, body };
   };
   /**
    * 读一段：开头 / 从 start 起 maxBytes，或者末尾 maxBytes（超大日志）。只向中枢要这一段（Range）；
    * 不支持 Range 的节点回整个文件（200），这里边读边截，大文件不整个拉进浏览器。
    */
-  const readRange = async (jobId: string, path: string, opts: { start?: number; maxBytes: number; tail?: boolean; onBytes?: (bytes: number) => void }) => {
+  const readRange = async (jobId: string, path: string, opts: { start?: number; maxBytes: number; tail?: boolean; signal?: AbortSignal; onBytes?: (bytes: number) => void }) => {
     const from = Math.max(0, opts.start ?? 0);
     const { maxBytes } = opts;
-    const { response, body } = await fileFetch(jobId, path, { Range: opts.tail ? `bytes=-${maxBytes}` : `bytes=${from}-${from + maxBytes - 1}` });
+    const { response, body } = await fileFetch(jobId, path, { Range: opts.tail ? `bytes=-${maxBytes}` : `bytes=${from}-${from + maxBytes - 1}` }, opts.signal);
     const contentType = response.headers.get("content-type") ?? "text/plain";
     const total = /\/(\d+)\s*$/.exec(response.headers.get("content-range") ?? "")?.[1];
     // 416：要的起点不在文件里（空文件，或文件变短了）。
@@ -646,6 +701,33 @@ function createBoardClient(
   return {
     directLinks,
     info: (jobId) => request<BoardInfo>(boardPath(jobId, "board")),
+    watchFiles(jobId, handlers) {
+      let active = true;
+      let stop: () => void = () => {};
+      const close = (error: CenterError | null) => {
+        if (!active) return;
+        active = false; stop(); handlers.onClose(error);
+      };
+      const fetchStream: typeof fetch = async (input, init) => {
+        const response = await doFetch(input, init);
+        if (response.ok && !/^text\/event-stream(?:\s*;|$)/i.test(response.headers.get("content-type") ?? "")) {
+          await response.body?.cancel().catch(() => undefined);
+          throw new CenterError("文件事件接口未返回事件流，请检查服务代理配置", "INVALID_RESPONSE", 502);
+        }
+        return response;
+      };
+      stop = openSse(fetchStream, `${base}${boardPath(jobId, "files/events")}`, headers(), (event, data) => {
+        if (!active) return;
+        if (event === "files" || event === "message") {
+          if (!isWorkspaceFileBatch(data)) { close(new CenterError("文件事件数据不完整，正在重新同步", "INVALID_RESPONSE", 502)); return; }
+          handlers.onEvent(data);
+        } else if (event === "end") {
+          const end = data && typeof data === "object" ? data as Record<string, unknown> : {};
+          close(new CenterError(typeof end.detail === "string" ? end.detail : "文件监听连接中断，正在重连", typeof end.reason === "string" ? end.reason : "NETWORK", typeof end.status === "number" ? end.status : 0));
+        }
+      }, close);
+      return () => { active = false; stop(); };
+    },
     stat: (jobId, path = ".") => request<DirListing | FileInfo>(boardPath(jobId, "files", `path=${encodeURIComponent(path)}`)),
     fileUrl: (jobId, path, opts = {}) => boardFileUrl(base, jobId, path, opts.download),
     async fileLinkBase(jobId) {
@@ -669,7 +751,7 @@ function createBoardClient(
       return work;
     },
     async readText(jobId, path, maxBytes = 512 * 1024, opts = {}) {
-      const { bytes, start, size, contentType } = await readRange(jobId, path, { maxBytes, tail: opts.tail, onBytes: opts.onBytes });
+      const { bytes, start, size, contentType } = await readRange(jobId, path, { maxBytes, tail: opts.tail, signal: opts.signal, onBytes: opts.onBytes });
       if (!size && !bytes.length) return { text: "", truncated: false, size: 0, contentType };
       const { text, encoding } = decodeText(bytes, { fromMiddle: start > 0 });
       return { text, truncated: bytes.length < size, size, contentType, tail: start > 0, encoding };

package/src/core/conversation.ts

@@ -135,6 +135,7 @@ const batchStreamTask = (task: BatchStreamTask): StreamTask => ({
   // 对话式子任务跑完一条不算结束：还能接着聊。
   id: task.id, seq: task.seq, title: task.title, status: task.status, closed: !task.conversation && TERMINAL_TASK.has(task.status),
   remote_task_id: task.remote_task_id, continue_from_task_id: task.continue_from_task_id,
+  awaiting_input: task.awaiting_input, awaiting_input_observed_at: task.awaiting_input_observed_at,
 });
 
 /** 没指定子任务时看哪个：最近一个派发过的，都没派发过就是最后一个。 */

package/src/core/provider.tsx

@@ -70,6 +70,13 @@ export function CliCenterProvider({ store: external, selectedId, onEvent, onTurn
     if (selectedId !== undefined) { created.select(selectedId); applied.current = selectedId; }
     return created;
   }, [external]); // eslint-disable-line react-hooks/exhaustive-deps
+  // Creation defaults can arrive after a file/configuration load. Update only
+  // these defaults on commit; the connection and workspace state stay stable.
+  useLayoutEffect(() => {
+    optionsRef.current.newConversation = options.newConversation;
+    optionsRef.current.createConversation = options.createConversation;
+    optionsRef.current.businessIdFor = options.businessIdFor;
+  }, [options.newConversation, options.createConversation, options.businessIdFor]);
   // 之后宿主改了 selectedId：一起切过去（在绘制前，免得闪一下旧的）。
   useLayoutEffect(() => {
     if (selectedId === undefined || selectedId === applied.current) return;

package/src/core/store.ts

@@ -121,6 +121,9 @@ export type CliEvent =
 export function cloneWorkspaceEvent(event:CliEvent):CliEvent {
   if(event.type==='files_changed')return cloneWorkspaceChange(event);
   if(event.type==='files_watch')return {...event};
+  if(event.type==='board_ref')return {...event,refs:event.refs.map(ref=>({...ref}))};
+  if(event.type==='context')return {...event,pending:event.pending.map(item=>({...item})),...(event.sent?{sent:event.sent.map(item=>({...item}))}:{})};
+  if(event.type==='open')return {...event,target:{...event.target}};
   if(event.type==='board_context')return {...event,view:cloneBoardView(event.view)};
   if(event.type==='board_change')return {...event,view:event.view?cloneBoardView(event.view):null};
   return event;
@@ -384,24 +387,27 @@ export function createCliStore(options: CliStoreOptions = {}) {
   function connect(key: string) {
     const entry = streams.get(key);
     if (!entry || entry.refs <= 0) return;
+    const previous = entry.stop;
+    entry.stop = null;
+    previous?.();
+    if (streams.get(key) !== entry || entry.refs <= 0) return;
     const { jobId, taskId } = parseConvKey(key);
-    patchConv(key, (conv) => ({ ...conv, stream: entry.attempt ? "reconnecting" : "connecting", streamError: null }));
-    let ended = false;
-    entry.stop = client.stream(jobId, {
-      onOpen: () => { entry.attempt = 0; patchConv(key, (conv) => ({ ...conv, stream: "live", streamError: null })); },
-      onSnapshot: (snapshot) => patchConv(key, (conv) => applySnapshot(conv, snapshot)),
-      onChunk: (items) => patchConv(key, (conv) => applyItems(conv, items)),
-      onEnd: (end) => {
-        ended = true;
-        // 接续的新对话：指定了对话的跟到接续它的那个对话（还没有就不跟，再发消息时 center 会开出来）；只有 job_id 的照旧跟新 job。
-        const continuedBy = taskId ? (end.continued_by_job_id && end.continued_by_task_id ? convKey(end.continued_by_job_id, end.continued_by_task_id) : null) : end.continued_by_job_id ?? null;
-        patchConv(key, (conv) => ({ ...conv, stream: "ended", endReason: end.reason, continuedBy, nodeRunning: false }));
-        void refreshJob(jobId, true);
-      },
-      onClose: (error) => {
-        entry.stop = null;
-        const current = streams.get(key);
-        if (!current || current.refs <= 0) return;
+    let ended = false, retired = false;
+    let cleanup: (() => void) | null = null;
+    const owns = () => streams.get(key) === entry && entry.refs > 0 && entry.stop === retire;
+    const active = () => !retired && owns();
+    const retire = () => {
+      if (retired) return;
+      retired = true;
+      if (entry.stop === retire) entry.stop = null;
+      const dispose = cleanup; cleanup = null;
+      notifyCallback(dispose ?? undefined, undefined);
+    };
+    const close = (error: CenterError | null) => {
+      if (!active()) return;
+      retire();
+      const current = streams.get(key);
+      if (current !== entry || current.refs <= 0 || current.stop) return;
         // 对话结束（end）不再连；中枢停机（server_shutdown）稍后重连。
         if (ended && state.convs[key]?.endReason !== "server_shutdown") return;
         // 404：对话不存在，重连也没用。
@@ -422,8 +428,32 @@ export function createCliStore(options: CliStoreOptions = {}) {
         current.attempt += 1;
         patchConv(key, (conv) => ({ ...conv, stream: "reconnecting", streamError: error?.message ?? null }));
         current.timer = setTimeout(() => { current.timer = null; connect(key); }, jitter(delay));
-      },
-    }, undefined, taskId);
+    };
+    entry.stop = retire;
+    patchConv(key, (conv) => ({ ...conv, stream: entry.attempt ? "reconnecting" : "connecting", streamError: null }));
+    if (!active()) return;
+    try {
+      cleanup = client.stream(jobId, {
+        onOpen: () => { if (!active()) return; entry.attempt = 0; patchConv(key, (conv) => ({ ...conv, stream: "live", streamError: null })); },
+        onSnapshot: (snapshot) => { if (active()) patchConv(key, (conv) => applySnapshot(conv, snapshot)); },
+        onChunk: (items) => { if (active()) patchConv(key, (conv) => applyItems(conv, items)); },
+        onEnd: (end) => {
+          if (!active()) return;
+          ended = true;
+          const continuedBy = taskId ? (end.continued_by_job_id && end.continued_by_task_id ? convKey(end.continued_by_job_id, end.continued_by_task_id) : null) : end.continued_by_job_id ?? null;
+          patchConv(key, (conv) => ({ ...conv, stream: "ended", endReason: end.reason, continuedBy, nodeRunning: false }));
+          void refreshJob(jobId, true);
+        },
+        onClose: close,
+      }, undefined, taskId);
+      // Some custom transports close synchronously before returning cleanup.
+      if (retired || !owns()) {
+        const dispose = cleanup; cleanup = null;
+        notifyCallback(dispose ?? undefined, undefined);
+      }
+    } catch (error) {
+      close(error instanceof CenterError ? error : new CenterError(String(error), "NETWORK", 0));
+    }
   }
 
   // 网络恢复 / 标签页切回来时，正在退避等待的连接立刻重连，不用等完退避时间。
@@ -472,16 +502,22 @@ export function createCliStore(options: CliStoreOptions = {}) {
       void refreshJob(jobId);
       connect(key);
     }
+    const owned = entry;
+    let active = true;
     return () => {
+      if (!active) return;
+      active = false;
       const current = streams.get(key);
-      if (!current) return;
+      if (current !== owned) return;
       current.refs -= 1;
       if (current.refs > 0) return;
-      current.stop?.();
-      if (current.timer) clearTimeout(current.timer);
+      // Retire the registry before calling host cleanup: it may synchronously
+      // acquire a new lease for the same task.
       streams.delete(key);
+      if (current.timer) { clearTimeout(current.timer); current.timer = null; }
       syncLive();
-      patchConv(key, (conv) => ({ ...conv, stream: conv.stream === "ended" ? "ended" : "idle" }));
+      current.stop?.();
+      if (!streams.has(key)) patchConv(key, (conv) => ({ ...conv, stream: conv.stream === "ended" ? "ended" : "idle" }));
     };
   }
 
@@ -552,6 +588,7 @@ export function createCliStore(options: CliStoreOptions = {}) {
         return target;
       }
       if (!key || !ref) {
+        const selectedBeforeCreate = state.selected;
         let newId: string;
         if (createConversation) {
           newId = await createConversation(text);
@@ -563,7 +600,7 @@ export function createCliStore(options: CliStoreOptions = {}) {
         }
         addJob(newId);
         // 共享选中只由「跟着选中走」的组件改；传了 jobId、自己接管的对话组件新建对话不去动别人的选中。
-        if (overrides.select !== false) set({ selected: newId });
+        if (overrides.select !== false && state.selected === selectedBeforeCreate) set({ selected: newId });
         emit({ type: "job_change", jobId: newId, previousJobId: null, taskId: null, key: newId, previousKey: null });
         void refreshJob(newId, true);
         return newId;
@@ -695,7 +732,7 @@ export function createCliStore(options: CliStoreOptions = {}) {
 
   function setRefs(key: string, refs: BoardRef[]) {
     const next = { ...state.refs };
-    if (refs.length) next[key] = refs; else delete next[key];
+    if (refs.length) next[key] = refs.map(ref => ({ ...ref })); else delete next[key];
     set({ refs: next });
     emit({ type: "board_ref", key, refs });
   }
@@ -822,7 +859,7 @@ export function createCliStore(options: CliStoreOptions = {}) {
     if (next.length !== list.length) setContext(k, next);
   }
   /** 还没发出的补充背景。 */
-  const pendingContext = (key: string | null): ContextItem[] => [...(state.context[ctxKey(key)] ?? [])];
+  const pendingContext = (key: string | null): ContextItem[] => (state.context[ctxKey(key)] ?? []).map(item => ({ ...item }));
 
   function workspace(key?: string | null): CliWorkspace {
     const k = key ?? state.selected;
@@ -855,7 +892,11 @@ export function createCliStore(options: CliStoreOptions = {}) {
 
   function openInBoard(jobId: string, target: OpenTarget): boolean {
     let handled = false;
-    for (let i = surfaces.length - 1; i >= 0 && !handled; i--) handled = surfaces[i](jobId, target);
+    for (const surface of [...surfaces].reverse()) {
+      try { handled = surface(jobId, { ...target }); }
+      catch (error) { console.error("[@spzxg/cli-ui] board surface callback failed", error); }
+      if (handled) break;
+    }
     emit({ type: "open", jobId, target, handled });
     return handled;
   }