@spzxg/cli-ui 0.6.0 → 0.6.2

package/src/chat/CliChat.tsx

@@ -5,16 +5,16 @@ import { useCallback, useEffect, useId, useLayoutEffect, useMemo, useRef, useSta
 import { CliErrorBoundary } from "../ui/ErrorBoundary.js";
 import type { CliEvent, CliStore, CliStoreOptions } from "../core/store.js";
 import { useCliState, useCliStore, useCliStoreContext, useComponentEvents, withOwnProvider, type ResultHandlers } from "../core/provider.js";
-import { boardContextBlock, serializeBlock } from "../core/blocks.js";
+import { boardContextBlock, serializeBlock, viewingBlock } from "../core/blocks.js";
 import { convKey, emptyConv, isChatTask, isNewInJob, isRunning, parseConvKey, runningTurn, TERMINAL_JOB, viewMessages } from "../core/conversation.js";
-import type { AskAnswers, AskQuestion, Msg } from "../core/types.js";
+import type { AskAnswers, AskQuestion, CenterTask, Msg } from "../core/types.js";
 import { Icon } from "../ui/icons.js";
 import { agentLabel as labelOf, fmtTokens, formatAnswersText, modelLabel } from "../ui/format.js";
 import { AgentBadge, Avatar, Skel, StatusDot, type DotCls } from "../ui/shared.js";
 import { HANDOFF_NOTICE_PREFIX, MessageView, SessionBreak, type MessageHandlers } from "../ui/Transcript.js";
 import { RENDER_MAX, RENDER_STEP, RENDER_WINDOW, buildTranscriptItems, hasOpenAsk, toolDataOf } from "../ui/transcriptModel.js";
 import { Composer, type ComposerOptions } from "./Composer.js";
-import { fillTemplate, resolveChatConfig, type CliChatConfig } from "../core/config.js";
+import { fillTemplate, refShown, resolveChatConfig, type CliChatConfig } from "../core/config.js";
 import { exportMarkdown } from "./export.js";
 import { FileLinkContext, FileOpenContext } from "../ui/fileLinks.js";
 import { FileViewer } from "../board/FileViewer.js";
@@ -174,17 +174,27 @@ function ChatInner({ jobId: jobIdProp, taskId: taskIdProp, title = "对话", col
   })), [allMessages, cfg.transcript.tools]);
   const running = conv ? isRunning(conv) : false;
   const job = entry?.job;
-  // 一次性任务（含续派，不是对话任务）：只读查看其中一个子任务——没有轮次，不能发消息、结束、回答。
-  // 例外是对话式子任务（续派时 mode=conversation）：当对话用，随时能接着发（= 续派一条接着它），不显示子任务状态。
+  // 一次性任务没有轮次：补充消息通过 continueTask 接在当前子任务的对话后面。
   const batch = !!conv?.batch || (!!job && job.mode !== "conversation");
   const chat = !!taskId && isChatTask(conv);
-  // 普通子任务结束后（完成 / 失败 / 取消）也能接着聊：发出去 = 续派一条接着它的对话式子任务（同一个 Agent 会话、同一个工作区）。
-  // 还在跑的时候输入框照样显示、但不能发，提示结束后再接着聊（需要登录、验证码时在看板的浏览器里接管）。
   const batchTaskStatus = batch ? conv?.batchTask?.status ?? job?.tasks?.find((t) => t.id === (taskId ?? conv?.task?.id))?.status ?? null : null;
-  const batchSettled = batch && !chat && !!batchTaskStatus && SETTLED_TASK.has(batchTaskStatus) && !!store.client.continueTask;
-  const readOnly = !!readOnlyProp || !cfg.composer.show || (batch && !chat && !batchSettled);
-  // 一次性任务的子任务没结束、不能发时，输入框也露出来（禁用 + 说明），别让人以为没有输入框。
-  const showComposer = !readOnly || (batch && !readOnlyProp && cfg.composer.show);
+  const batchWritable = batch && !!(taskId ?? conv?.task?.id) && !!store.client.continueTask;
+  const readOnly = !!readOnlyProp || !cfg.composer.show || (batch && !batchWritable);
+  const showComposer = !readOnlyProp && cfg.composer.show;
+  // 最新消息可能还在排队：沿当前对话的接续链找正在执行 / 暂停的子任务，不能误停同 Job 的其他对话。
+  const controlTask = useMemo(() => {
+    if (!batch || !conv?.batchTask) return null;
+    const tasks = new Map<string, Pick<CenterTask, "id" | "status" | "continue_from_task_id">>((job?.tasks ?? []).map((t) => [t.id, t]));
+    tasks.set(conv.batchTask.id, { ...conv.batchTask, continue_from_task_id: conv.batchTask.continue_from_task_id ?? undefined });
+    const chain = [];
+    const seen = new Set<string>();
+    let t = tasks.get(conv.batchTask.id);
+    while (t && !seen.has(t.id)) { chain.push(t); seen.add(t.id); t = tasks.get(t.continue_from_task_id ?? ""); }
+    return chain.find((t) => ["dispatching", "running", "verifying"].includes(t.status))
+      ?? chain.find((t) => t.status === "paused")
+      ?? chain.reverse().find((t) => ["queued", "blocked"].includes(t.status)) ?? null;
+  }, [batch, conv?.batchTask, job?.tasks]);
+  const batchPending = batch && !!batchTaskStatus && !SETTLED_TASK.has(batchTaskStatus);
   // 这个对话对应的子任务：指定了就是它，否则对话任务的第一个（「新开」时借用第一个的智能体显示）；
   // 一次性任务没指定时是实时流挑的那个（最近一个派发过的）。
   const shownTaskId = taskId ?? (batch ? conv?.task?.id : undefined);
@@ -194,10 +204,10 @@ function ChatInner({ jobId: jobIdProp, taskId: taskIdProp, title = "对话", col
   const agentText = labelOf(agent);
   const jobStatus = conv?.job?.status ?? job?.status ?? null;
   // 对话式子任务没有「结束」：大任务结束了，再发一条会重新打开它。
-  // 普通子任务结束后能接着聊的（batchSettled）同理：大任务结束不挡输入框。
-  const jobEnded = !chat && !batchSettled && !!jobStatus && TERMINAL_JOB.has(jobStatus);
+  // 支持续派的普通子任务同理：大任务结束不挡输入框。
+  const jobEnded = !chat && !batchWritable && !!jobStatus && TERMINAL_JOB.has(jobStatus);
   // 只关掉了这一个对话（对话任务还开着）：按「这个对话已结束」显示，不能再发消息。
-  const convClosed = !jobEnded && !batchSettled && !!(conv?.task?.closed ?? info?.closed);
+  const convClosed = !jobEnded && !batchWritable && !!(conv?.task?.closed ?? info?.closed);
   const status = convClosed ? "succeeded" : jobStatus;
   const closedReason = convClosed ? "conversation_closed" : conv?.job?.closed_reason ?? job?.conversation?.closed_reason ?? null;
   const ended = jobEnded || convClosed;
@@ -263,12 +273,15 @@ function ChatInner({ jobId: jobIdProp, taskId: taskIdProp, title = "对话", col
     // 一次性任务：发给正在看的那个子任务（接着它聊）。
     const id = latest.current.conv?.batch ? latest.current.runKey : latest.current.key;
     // 看板里引用到这个对话的东西：合成一个「看板上下文」块跟着这条消息发出去；发失败就放回去。
-    // 看板上正在看的文件缺省也带上一次（已经明确引用了的不重复）。
+    // 看板上正在看的文件缺省也带上一次（已经明确引用了的不重复），单独一块「看板正在看」：转录里按 config.refs.viewing 显示或不显示。
     const refKey = latest.current.key;
     const refs = refKey ? store.takeRefs(refKey) : [];
     const viewing = refKey ? store.takeViewing(refKey) : null;
-    const lines = [...(viewing && !refs.some((r) => r.id === viewing.id) ? [viewing.text] : []), ...refs.map((r) => r.text)];
-    const full = lines.length ? `${text}\n\n${serializeBlock(boardContextBlock(lines))}` : text;
+    const blocks = [
+      ...(viewing && !refs.some((r) => r.id === viewing.id) ? [viewingBlock(viewing.text)] : []),
+      ...(refs.length ? [boardContextBlock(refs.map((r) => r.text))] : []),
+    ];
+    const full = blocks.length ? [text, ...blocks.map(serializeBlock)].join("\n\n") : text;
     let target: string;
     try {
       target = await store.send(id ?? null, full, sendOpts.current);
@@ -280,7 +293,10 @@ function ChatInner({ jobId: jobIdProp, taskId: taskIdProp, title = "对话", col
   }, [store, go]);
   const refs = useCliState((s) => (key ? s.refs[key] : undefined));
   const viewingState = useCliState((s) => (key ? s.viewing[key] : undefined));
-  const viewing = viewingState && !viewingState.off && !refs?.some((r) => r.id === viewingState.ref.id) ? viewingState.ref : null;
+  const viewingRef = viewingState && !viewingState.off && !refs?.some((r) => r.id === viewingState.ref.id) ? viewingState.ref : null;
+  // 输入框上方显示哪些（config.refs）：不显示的照样随消息带上。正在看的缺省不显示。
+  const viewing = viewingRef && refShown(cfg, "viewing") ? viewingRef : null;
+  const shownRefs = refs?.filter((r) => refShown(cfg, r.kind));
   // 业务方补充的背景（store.appendContext）：随下一条消息带上，输入框上方显示出来，让用户知道会带上什么。
   const contextItems = useCliState((s) => s.context[key ?? ""]);
   // AI 把浏览器交给用户（实时新来的「🖐 …」行）：同一 Provider 里有看板在看这个对话，就把看板切到浏览器（收起的会请宿主展开）。
@@ -379,7 +395,8 @@ function ChatInner({ jobId: jobIdProp, taskId: taskIdProp, title = "对话", col
   const [loadingOlder, setLoadingOlder] = useState(false);
   const olderRef = useRef(older); olderRef.current = older;
   const keyRef2 = useRef(key); keyRef2.current = key;
-  const items = useMemo(() => buildTranscriptItems(committed, older > 0), [committed, older]);
+  const items = useMemo(() => buildTranscriptItems(committed, older > 0)
+    .filter((it) => cfg.transcript.initialPrompt || it.kind !== "msg" || !it.initial), [committed, older, cfg.transcript.initialPrompt]);
   // 展开了的「续等」折叠行（按折叠行的 key）。
   const [openFolds, setOpenFolds] = useState<Set<string>>(() => new Set());
   const [win, setWin] = useState<{ start: string | null; end: string | null }>({ start: null, end: null });
@@ -527,7 +544,7 @@ function ChatInner({ jobId: jobIdProp, taskId: taskIdProp, title = "对话", col
 
   const contextReset = !!lastTurn?.context_reset && conv?.turns.some((turn) => turn.context_reset);
   const h = cfg.header;
-  const view = useMemo(() => ({ timestamps: cfg.transcript.timestamps, initialBadge: cfg.transcript.initialBadge, userLabel: cfg.labels.user, agentName: cfg.labels.agent }), [cfg]);
+  const view = useMemo(() => ({ timestamps: cfg.transcript.timestamps, initialBadge: cfg.transcript.initialBadge, userLabel: cfg.labels.user, agentName: cfg.labels.agent, viewingBlock: refShown(cfg, "viewing") }), [cfg]);
   const composerOptions = useMemo<ComposerOptions>(() => ({
     placeholderRunning: cfg.composer.placeholderRunning, hints: cfg.composer.hints, charCount: cfg.composer.charCount,
     fileUpload: cfg.composer.fileUpload, fileButtonText: cfg.composer.fileButtonText, queue: cfg.composer.queue,
@@ -535,9 +552,7 @@ function ChatInner({ jobId: jobIdProp, taskId: taskIdProp, title = "对话", col
   const composerDisabled = !!readOnly || finalEnd || conv?.stream === "error";
   const disabledHint = readOnly
     ? batch && !readOnlyProp && cfg.composer.show
-      ? (batchTaskStatus && SETTLED_TASK.has(batchTaskStatus) ? "只读（当前中枢不支持接着子任务聊）"
-        : batchTaskStatus === "blocked" || batchTaskStatus === "queued" ? "子任务还没开始，开始并结束后可以接着它聊"
-        : "子任务运行中，结束后可以接着它继续聊；需要登录等操作请在右侧浏览器里接管")
+      ? "当前任务暂不支持发送消息"
       : "只读"
     : finalEnd ? "对话已结束，不能再发消息" : conv?.streamError ?? undefined;
 
@@ -567,15 +582,10 @@ function ChatInner({ jobId: jobIdProp, taskId: taskIdProp, title = "对话", col
     <div 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.export || h.title) && <div className="sh-main">
-            {(h.crumb || h.export) && <div className="crumb">
-              {h.crumb && <>
+          {(h.crumb || h.title) && <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> 对话
-              </>}
-              {h.export && key && allMessages.length > 0 && (
-                <button className="crumb-export" onClick={() => exportMarkdown(convTitle, taskId ? `${jobId}-${taskId}` : jobId!, allMessages, conv?.turns ?? [])} title="导出这个对话的完整过程（Markdown）">{Icon.download()} 导出执行过程</button>
-              )}
             </div>}
             {h.title && <div className="sh-title"><span className="sht-text" title={convTitle}>{convTitle}</span></div>}
           </div>}
@@ -597,6 +607,12 @@ function ChatInner({ jobId: jobIdProp, taskId: taskIdProp, title = "对话", col
               <StatusDot cls={dotCls} running={running} awaiting={awaiting} title={statusText} />
               <span className="cv">{statusText}</span>
             </span>}
+            {h.export && key && <button type="button" className="btn btn-line btn-sm cli-export" disabled={!allMessages.length}
+              aria-label="导出执行过程（Markdown）"
+              title={older > 0 ? "下载已加载的执行过程（Markdown）；更早的消息尚未加载" : "下载执行过程（Markdown），包含初始上下文和工具记录"}
+              onClick={() => exportMarkdown(convTitle, taskId ? `${jobId}-${taskId}` : jobId!, allMessages, conv?.turns ?? [])}>
+              {Icon.download()}<span>{older > 0 ? "导出已加载" : "导出"}</span>
+            </button>}
             {h.close && key && !isNew && allowClose && !readOnly && !ended && !batch && (
               <button className="btn btn-line btn-sm" onClick={() => setClosing("confirm")} disabled={closing === "busy"} title={taskId ? "只结束这个对话：之后它不再接收消息，正在跑的一轮会被中止；同一任务里的其他对话不受影响" : "结束这个对话：之后不再接收消息，正在跑的一轮会被中止"}>{Icon.stop()} 结束对话</button>
             )}
@@ -703,7 +719,7 @@ function ChatInner({ jobId: jobIdProp, taskId: taskIdProp, title = "对话", col
             ))}
           </div>
         )}
-        {showComposer && (!!refs?.length || !!viewing) && (
+        {showComposer && (!!shownRefs?.length || !!viewing) && (
           <div className="cli-refs" aria-label="引用自看板，下一条消息会带上">
             <span className="cli-refs-t">{Icon.board()} 引用自看板</span>
             {viewing && (
@@ -713,7 +729,7 @@ function ChatInner({ jobId: jobIdProp, taskId: taskIdProp, title = "对话", col
                 <button className="cli-ref-x" onClick={() => key && store.dismissViewing(key)} title="这次不带上" aria-label={`不带上 ${viewing.label}`}>{Icon.x()}</button>
               </span>
             )}
-            {(refs ?? []).map((r) => (
+            {(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>
@@ -728,9 +744,16 @@ function ChatInner({ jobId: jobIdProp, taskId: taskIdProp, title = "对话", col
             placeholder={fillTemplate(key && !isNew ? cfg.composer.placeholder : cfg.composer.placeholderNew, { title: convTitle, agent: agentText })}
             disabled={composerDisabled}
             disabledHint={cfg.composer.placeholderDisabled ? fillTemplate(cfg.composer.placeholderDisabled, { title: convTitle, agent: agentText }) : disabledHint}
-            running={running}
+            running={running || batchPending}
             onSend={send}
             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",
+              onToggle: async () => {
+                const action = controlTask.status === "paused" ? store.client.resumeTask! : store.client.pauseTask!;
+                await report(action(controlTask.id).then(() => store.refreshJob(jobId, true)), controlTask.status === "paused" ? "继续任务失败" : "暂停任务失败");
+              },
+            } : undefined}
             options={composerOptions}
           />
         )}

package/src/chat/Composer.tsx

@@ -1,9 +1,9 @@
 // 输入框。结构与 Operator 的 Composer.tsx 一致（comp-box / comp-area / send-group / comp-foot），
-// 但只发文本：不收图片和其他附件。文件只收 TXT、Markdown、Word，在前端解析成纯文本，
+// 但只发文本：不收图片和其他附件。文件只收文档（Word、Excel、Markdown、TXT、HTML、CSV），在前端解析成纯文本，
 // 和长粘贴一样变成可折叠的文本块，发送时按统一格式拼进正文（见 core/blocks.ts）。
 import { useEffect, useRef, useState } from "react";
 import {
-  ACCEPT_ATTR, MAX_MESSAGE_CHARS, PASTE_NAME, charCount, composeMessage, isLongText, readFileText, type TextBlock,
+  ACCEPT_ATTR, ACCEPTED_LABEL, MAX_MESSAGE_CHARS, PASTE_NAME, charCount, composeMessage, isLongText, readFileText, type TextBlock,
 } from "../core/blocks.js";
 import { Icon } from "../ui/icons.js";
 import { TextBlockCard } from "../ui/TextBlock.js";
@@ -30,7 +30,7 @@ export interface ComposerOptions {
   queue: boolean;
 }
 
-export function Composer({ draft, placeholder, disabled, disabledHint, running, onSend, onStop, options }: {
+export function Composer({ draft, placeholder, disabled, disabledHint, running, onSend, onStop, taskControl, options }: {
   /** 草稿按这个键存在 localStorage（一般是对话 id）。 */
   draft: string;
   placeholder: string;
@@ -39,6 +39,7 @@ export function Composer({ draft, placeholder, disabled, disabledHint, running,
   running: boolean;
   onSend: (text: string) => Promise<void>;
   onStop?: () => Promise<void> | void;
+  taskControl?: { paused: boolean; onToggle: () => Promise<void> };
   options: ComposerOptions;
 }) {
   const [val, setVal] = useState(() => loadDraft(draft));
@@ -47,6 +48,7 @@ export function Composer({ draft, placeholder, disabled, disabledHint, running,
   const [error, setError] = useState<string | null>(null);
   const [sending, setSending] = useState(false);
   const [stopping, setStopping] = useState(false);
+  const [controlling, setControlling] = useState(false);
   const [dragging, setDragging] = useState(false);
   const dragDepth = useRef(0);
   const seq = useRef(0);
@@ -56,7 +58,7 @@ export function Composer({ draft, placeholder, disabled, disabledHint, running,
   useEffect(() => { if (!running) setStopping(false); }, [running]);
   useEffect(() => { saveDraft(draft, val); }, [draft, val]);
   const autosize = (el: HTMLTextAreaElement) => { el.style.height = "auto"; el.style.height = Math.min(el.scrollHeight, 160) + "px"; };
-  useEffect(() => { if (ref.current) autosize(ref.current); }, [draft]);
+  useEffect(() => { if (ref.current) autosize(ref.current); }, [draft, disabled]);
 
   const nextKey = () => `blk-${++seq.current}`;
   const addBlock = (block: TextBlock) => setBlocks((prev) => [...prev, { ...block, key: nextKey() }]);
@@ -108,6 +110,10 @@ export function Composer({ draft, placeholder, disabled, disabledHint, running,
 
   const isFileDrag = (e: React.DragEvent) => Array.from(e.dataTransfer?.types ?? []).includes("Files");
   const hasFileDrag = (e: React.DragEvent) => options.fileUpload && isFileDrag(e);
+  const stopButton = running && onStop && (
+    <button type="button" className="send stop" onClick={() => { setStopping(true); void Promise.resolve(onStop()).catch(() => setStopping(false)); }}
+      disabled={stopping} aria-label={stopping ? "正在停止" : "停止当前轮次"} title={stopping ? "正在停止…" : "停止当前轮次"}>{Icon.stop()}</button>
+  );
 
   return (
     <div className="composer">
@@ -145,8 +151,8 @@ export function Composer({ draft, placeholder, disabled, disabledHint, running,
           )}
           <div className="comp-area">
             <textarea
-              ref={ref} rows={1} value={val} disabled={disabled}
-              placeholder={disabled ? disabledHint ?? "暂时不能发送" : running && options.queue ? options.placeholderRunning : placeholder}
+              ref={ref} rows={2} value={val} disabled={disabled} aria-label="消息内容"
+              placeholder={disabled ? disabledHint ?? "暂时不能发送" : taskControl?.paused ? "任务已暂停，可补充消息，继续后依次执行…" : running && options.queue ? options.placeholderRunning : placeholder}
               onChange={(e) => { setVal(e.target.value); autosize(e.target); }}
               onKeyDown={(e) => { if (e.key === "Enter" && !e.shiftKey && !e.nativeEvent.isComposing) { e.preventDefault(); void submit(); } }}
               onPaste={(e) => {
@@ -154,7 +160,7 @@ export function Composer({ draft, placeholder, disabled, disabledHint, running,
                 if (files.length) {
                   e.preventDefault();
                   if (!options.fileUpload) { setError("这里只能发送文字"); return; }
-                  if (files.some((f) => f.type.startsWith("image/"))) setError("不支持发送图片，只能发送文字，或上传 TXT / Markdown / Word 文件");
+                  if (files.some((f) => f.type.startsWith("image/"))) setError(`不支持发送图片，只能发送文字，或上传文档：${ACCEPTED_LABEL}`);
                   addFiles(files.filter((f) => !f.type.startsWith("image/")));
                   return;
                 }
@@ -166,27 +172,32 @@ export function Composer({ draft, placeholder, disabled, disabledHint, running,
                 }
               }}
             />
-            {running ? (
-              <div className="send-group">
-                {canSend && <button className="send queue" onClick={() => void submit()} title="把这条后续消息排队 —— 当前轮次结束后自动发送" disabled={disabled}>{Icon.send()}</button>}
-                {onStop && <button className="send stop" onClick={() => { setStopping(true); void Promise.resolve(onStop()).catch(() => setStopping(false)); }} disabled={stopping} title={stopping ? "正在停止…" : "停止当前轮次"}>{Icon.stop()}</button>}
-              </div>
-            ) : (
-              <button className="send" disabled={!canSend || disabled} onClick={() => void submit()}>{Icon.send()}</button>
-            )}
           </div>
-          {/* 底部栏的内容都关掉时整行不占位。 */}
-          {(options.hints || options.charCount || options.fileUpload || tooLong) && <div className="comp-foot">
-            {options.hints && <span className="hint"><span className="kbd">⏎</span> 发送</span>}
-            {options.hints && <span className="hint comp-hint-extra"><span className="kbd">⇧⏎</span> 换行</span>}
+          <div className="comp-foot">
+            {options.fileUpload && !disabled && <>
+              <input ref={fileRef} type="file" accept={ACCEPT_ATTR} multiple hidden onChange={(e) => { addFiles(Array.from(e.target.files ?? [])); e.target.value = ""; }} />
+              <button type="button" className="cli-attach" title={`添加文档：${ACCEPTED_LABEL}（也可拖拽进来），内容会转成文字发送`}
+                onClick={() => fileRef.current?.click()}>{Icon.clip()} {options.fileButtonText}</button>
+            </>}
+            {options.hints && !disabled && <span className="hint comp-hint-extra">Shift + Enter 换行</span>}
+            <span className="spacer" />
             {options.charCount && total > 0 && <span className={`hint cli-count ${tooLong ? "over" : ""}`}>{fmtCount(total)} 字</span>}
             {!options.charCount && tooLong && <span className="hint cli-count over">{fmtCount(total)} 字</span>}
-            <span className="spacer" />
-            {options.fileUpload && <input ref={fileRef} type="file" accept={ACCEPT_ATTR} multiple hidden onChange={(e) => { addFiles(Array.from(e.target.files ?? [])); e.target.value = ""; }} />}
-            {options.fileUpload && !disabled && (
-              <button className="hint" style={{ cursor: "pointer" }} title="添加 TXT / Markdown / Word 文件（也可拖拽进来），内容会转成文字发送" onMouseDown={(e) => { e.preventDefault(); fileRef.current?.click(); }}>{Icon.clip()} {options.fileButtonText}</button>
-            )}
-          </div>}
+            <div className="send-group">
+              {taskControl && <button type="button" className="btn btn-line cli-task-control" disabled={controlling}
+                aria-label={taskControl.paused ? "继续任务" : "暂停任务"}
+                title={taskControl.paused ? "重新派发当前子任务，排队消息随后执行" : "暂停当前子任务，继续时重新派发"}
+                onClick={async () => { setControlling(true); try { await taskControl.onToggle(); } catch { /* 错误由调用方显示，保留草稿和当前状态 */ } finally { setControlling(false); } }}>
+                {taskControl.paused ? Icon.play() : Icon.pause()}<span>{controlling ? "处理中…" : taskControl.paused ? "继续" : "暂停"}</span>
+              </button>}
+              {(!running || options.queue) && <button type="button" className={`send cli-send${running ? " queue" : ""}`} disabled={disabled || !canSend}
+                onClick={() => void submit()} aria-label={sending ? "正在发送" : running ? "排队发送" : "发送消息"}
+                title={taskControl?.paused ? "排队发送，继续任务后依次执行" : running ? "排队发送，当前轮次结束后执行" : "发送消息（Enter）"}>
+                {Icon.send()}<span>{sending ? "发送中…" : running ? "排队发送" : "发送"}</span>
+              </button>}
+              {stopButton}
+            </div>
+          </div>
         </div>
       </div>
     </div>

package/src/core/blocks.ts

@@ -1,5 +1,5 @@
 /**
- * 「文本块」：上传的文件（TXT / Markdown / Word）和粘贴的大段文字。
+ * 「文本块」：上传的文档（Word / Excel / Markdown / TXT / HTML / CSV）和粘贴的大段文字。
  *
  * 前端先把文件解析成纯文本，再按统一格式拼进消息正文发给 center——center 只收纯文本。
  * 同一个格式两头用：输入框里是可折叠的卡片，发出去之后转录里也解析回同样的卡片，
@@ -12,11 +12,13 @@
  * 对 Agent 来说这也是清楚的分隔：哪段是附件、叫什么、在哪结束。
  */
 
+import { decodeText } from "./textDecode.js";
+
 export interface TextBlock {
   /** 显示名：文件名，粘贴的文字为「粘贴的文本」。 */
   name: string;
   text: string;
-  kind: "file" | "paste" | "context" | "background";
+  kind: "file" | "paste" | "context" | "background" | "viewing";
 }
 
 /** 看板引用合成的块的名字（转录里按它认出来，显示成「看板上下文」卡片）。 */
@@ -27,6 +29,14 @@ export function boardContextBlock(lines: string[]): TextBlock {
   return { name: BOARD_CONTEXT_NAME, kind: "context", text: ["用户在右侧看板里引用了下面这些，供这条消息参考：", ...lines.map((l) => `- ${l}`)].join("\n") };
 }
 
+/** 看板上正在看的东西（缺省随消息带上、不显示）合成的块的名字：和明确引用的分开，转录里可以单独不显示。 */
+export const VIEWING_NAME = "看板正在看";
+
+/** 看板上正在看的东西 → 发给智能体的块。 */
+export function viewingBlock(line: string): TextBlock {
+  return { name: VIEWING_NAME, kind: "viewing", text: `${line}。用户没有另外说明时，消息里说的「这个」「这里」「改一下」等就是指它。` };
+}
+
 /** 补充背景合成的块的名字（转录里显示成「补充背景」卡片）。 */
 export const BACKGROUND_NAME = "补充背景";
 
@@ -38,9 +48,25 @@ export function backgroundBlock(items: Array<{ title?: string; text: string }>):
   return { name: BACKGROUND_NAME, kind: "background", text: `以下是补充的项目背景信息，请在这次及之后的工作中一并参考：\n\n${body}` };
 }
 
-/** 支持的文件：只有 TXT、Markdown、Word（.docx）。 */
-export const ACCEPTED_EXTENSIONS = [".txt", ".md", ".markdown", ".docx"] as const;
-export const ACCEPT_ATTR = ".txt,.md,.markdown,.docx,text/plain,text/markdown,application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+/** 支持的文件：只收文档——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;
+export const ACCEPT_ATTR = [
+  ...ACCEPTED_EXTENSIONS,
+  "text/plain", "text/markdown", "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";
+/** 一些常见但读不了的文档：给出另存为什么。 */
+const SAVE_AS: Record<string, string> = {
+  ".doc": "老版 Word（.doc）请另存为 .docx 后再上传",
+  ".xls": "老版 Excel（.xls）请另存为 .xlsx 或 CSV 后再上传",
+  ".wps": "WPS 文字请另存为 .docx 后再上传",
+  ".et": "WPS 表格请另存为 .xlsx 后再上传",
+};
+/** HTML 里内嵌的大段 data: 数据（图片、字体）：换成占位，免得一张图就把消息撑爆。 */
+const INLINE_DATA = /data:[\w.+-]+\/[\w.+-]+(?:;[\w=.+-]+)*,[^"')\s]{200,}/g;
 /** 粘贴超过这个长度（或行数）就转成文本块，不放进输入框。 */
 export const PASTE_BLOCK_CHARS = 2_000;
 export const PASTE_BLOCK_LINES = 40;
@@ -82,7 +108,7 @@ export function splitMessage(content: string): MessagePart[] {
     if (!open || end === -1) { text.push(lines[i]); continue; }
     flush();
     const name = open[1];
-    parts.push({ kind: "block", block: { name, text: lines.slice(i + 1, end).join("\n"), kind: name === PASTE_NAME ? "paste" : name === BOARD_CONTEXT_NAME ? "context" : name === BACKGROUND_NAME ? "background" : "file" } });
+    parts.push({ kind: "block", block: { name, text: lines.slice(i + 1, end).join("\n"), kind: name === PASTE_NAME ? "paste" : name === BOARD_CONTEXT_NAME ? "context" : name === VIEWING_NAME ? "viewing" : name === BACKGROUND_NAME ? "background" : "file" } });
     i = end;
   }
   flush();
@@ -105,13 +131,24 @@ export function extensionOf(name: string) {
 export class FileReadError extends Error {}
 
 /**
- * 读出文件的纯文本。TXT / Markdown 直接按 UTF-8 读；Word 用 mammoth 取正文文字（不带格式、图片）。
- * 老式 .doc（二进制）浏览器里读不了，提示另存为 .docx。
+ * 读出文件的纯文本：
+ *   · TXT / Markdown / CSV / TSV / HTML —— 按编码解（UTF-8，导出的 GBK 文件按 GB18030），HTML 保留源码、内嵌的大段 data: 数据换成占位；
+ *   · Word —— mammoth 取正文文字（不带格式、图片）；
+ *   · Excel —— 每个工作表一段 CSV（单元格的值，日期写成 2026-08-10），见 xlsx.ts。
+ * 其他文件（图片、PDF、压缩包……）不收；老版 .doc / .xls 浏览器里读不了，提示另存为。
  */
 export async function readFileText(file: File): Promise<string> {
   const ext = extensionOf(file.name);
-  if (ext === ".doc") throw new FileReadError("不支持老版 Word（.doc），请另存为 .docx 后再上传");
-  if (!(ACCEPTED_EXTENSIONS as readonly string[]).includes(ext)) throw new FileReadError("只支持 TXT、Markdown 和 Word（.docx）文件");
+  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}`);
+  if (ext === ".xlsx" || ext === ".xlsm") {
+    const { readXlsx, sheetsToText } = await import("./xlsx.js");
+    try {
+      return normalizeText(sheetsToText(await readXlsx(await readAs(file, "buffer"))));
+    } catch {
+      throw new FileReadError("Excel 文件解析失败，文件可能已损坏、加了密码，或不是 .xlsx 格式");
+    }
+  }
   if (ext === ".docx") {
     // 按需加载：mammoth 不小，只有真的传 Word 时才下载。
     const mammoth = await import("mammoth");
@@ -127,7 +164,9 @@ export async function readFileText(file: File): Promise<string> {
       throw new FileReadError("Word 文件解析失败，文件可能已损坏或不是 .docx 格式");
     }
   }
-  return normalizeText(await readAs(file, "text"));
+  const { text } = decodeText(new Uint8Array(await readAs(file, "buffer")));
+  if (ext === ".html" || ext === ".htm") return normalizeText(text.replace(INLINE_DATA, (m) => `${m.slice(0, m.indexOf(",") + 1)}…（内嵌数据已省略）`));
+  return normalizeText(text);
 }
 
 /** Blob.text() / arrayBuffer() 老浏览器（Safari 14 以前）没有，退回 FileReader。 */

package/src/core/client.ts

@@ -75,6 +75,9 @@ const ERROR_TEXT: Record<string, string> = {
   viewer_not_ready: "画面连接还没就绪，正在重连",
   link_expired: "文件链接已失效，请刷新",
   task_not_found: "这个子任务不在对应的任务里",
+  task_already_finished: "当前子任务已经结束，请刷新状态后继续",
+  task_not_paused: "当前子任务没有暂停，请刷新状态后重试",
+  job_already_paused: "整个任务已暂停，请先恢复整个任务",
 };
 
 /**
@@ -102,6 +105,9 @@ export interface ConversationBackend {
    * 返回新子任务的 id。
    */
   continueTask?(jobId: string, taskId: string, text: string, opts?: { title?: string; businessId?: string }): Promise<{ task_id: string }>;
+  /** 暂停 / 继续一次性任务中的单个子任务。继续会重新派发该子任务。 */
+  pauseTask?(taskId: string): Promise<CenterTask>;
+  resumeTask?(taskId: string): Promise<CenterTask>;
   /** 在对话任务里新开一个对话（同一节点、同一工作区），text 是它的第一条消息。 */
   openConversation?(jobId: string, text: string, opts?: { title?: string; agent?: string; browser?: boolean; businessId?: string; timeoutSeconds?: number }): Promise<SendResult>;
   cancelTurn(jobId: string, turnId: string): Promise<CenterTurn>;
@@ -150,7 +156,12 @@ export interface BoardBackend {
    * tail = 读末尾那一段（超大日志）；节点不支持只读一段时退回开头（返回的 tail 为 false）。
    * 不是 UTF-8 的（GBK 导出的 CSV 之类）按 GB18030 解，encoding 说明按什么解的。
    */
-  readText(jobId: string, path: string, maxBytes?: number, opts?: { tail?: boolean }): Promise<TextChunk>;
+  readText(jobId: string, path: string, maxBytes?: number, opts?: { tail?: boolean; 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>;
   /**
    * 读整个文件。signal 取消（打包下载点了取消）；onBytes 报已收到的字节数（大文件显示进度）。
    * 弱网：FILE_HEADER_TIMEOUT_MS 内没回响应头、或传输中 FILE_STALL_MS 没收到数据，按网络错误（NETWORK）失败。
@@ -171,6 +182,15 @@ export interface BoardBackend {
   browserLive?(jobId: string, handlers: BrowserLiveHandlers): () => void;
 }
 
+/** readBytes 读到的一段。 */
+export interface ByteChunk {
+  bytes: Uint8Array<ArrayBuffer>;
+  /** 这段在文件里从第几个字节开始。 */
+  start: number;
+  /** 文件总大小。 */
+  size: number;
+}
+
 export interface TextChunk {
   text: string;
   /** 只读到了一部分。 */
@@ -322,6 +342,8 @@ export function createCenterClient(options: CenterClientOptions = {}): Conversat
       });
       return { task_id: result.task_ids[0] };
     },
+    pauseTask: (taskId: string) => post<CenterTask>(`/api/tasks/${id(taskId)}/pause`, {}),
+    resumeTask: (taskId: string) => post<CenterTask>(`/api/tasks/${id(taskId)}/resume`, {}),
     /** 同一个 business_id 重发只开一个对话。 */
     openConversation: (jobId: string, text: string, opts: { title?: string; agent?: string; browser?: boolean; businessId?: string; timeoutSeconds?: number } = {}) =>
       post<SendResult>(`/api/jobs/${id(jobId)}/conversations`, {
@@ -590,6 +612,30 @@ function createBoardClient(
     };
     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 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 contentType = response.headers.get("content-type") ?? "text/plain";
+    const total = /\/(\d+)\s*$/.exec(response.headers.get("content-range") ?? "")?.[1];
+    // 416：要的起点不在文件里（空文件，或文件变短了）。
+    if (response.status === 416) { await body(); return { bytes: new Uint8Array(0), start: from, size: total ? Number(total) : 0, contentType }; }
+    const length = Number(response.headers.get("content-length") ?? 0);
+    if (response.status === 206) {
+      // 节点给的一段可能比要的长（不严格按 Range）：也只留 maxBytes。
+      const bytes = await body({ limit: maxBytes, onBytes: opts.onBytes });
+      const start = Number(/bytes (\d+)-/.exec(response.headers.get("content-range") ?? "")?.[1] ?? 0);
+      return { bytes, start, size: total ? Number(total) : start + bytes.length, contentType };
+    }
+    // 回了整个文件：跳过 from 之前的，留 maxBytes。
+    const all = await body({ limit: from + maxBytes, onBytes: opts.onBytes });
+    const size = length || all.length;
+    return { bytes: all.slice(Math.min(from, all.length)), start: Math.min(from, all.length), size, contentType };
+  };
   // 文件链接令牌：按对话键缓存，离过期不到 5 分钟就换新的；同一时刻只换一次。
   const links = new Map<string, { base: string; until: number }>();
   const minting = new Map<string, Promise<string | null>>();
@@ -621,25 +667,14 @@ function createBoardClient(
       return work;
     },
     async readText(jobId, path, maxBytes = 512 * 1024, opts = {}) {
-      // 只要需要的那一段：开头 maxBytes，或者末尾 maxBytes（超大日志）。不支持 Range 的节点回整个文件（200），下面边读边截。
-      const { response, body } = await fileFetch(jobId, path, { Range: opts.tail ? `bytes=-${maxBytes}` : `bytes=0-${maxBytes - 1}` });
-      const contentType = response.headers.get("content-type") ?? "text/plain";
-      if (response.status === 416) { await body(); return { text: "", truncated: false, size: 0, contentType }; }
-      const total = /\/(\d+)\s*$/.exec(response.headers.get("content-range") ?? "")?.[1];
-      const length = Number(response.headers.get("content-length") ?? 0);
-      if (response.status === 206) {
-        // 节点给的一段可能比要的长（不严格按 Range）：也只留 maxBytes。
-        const bytes = await body({ limit: maxBytes });
-        const size = total ? Number(total) : bytes.length;
-        const start = Number(/bytes (\d+)-/.exec(response.headers.get("content-range") ?? "")?.[1] ?? 0);
-        const { text, encoding } = decodeText(bytes, { fromMiddle: start > 0 });
-        return { text, truncated: bytes.length < size, size, contentType, tail: start > 0, encoding };
-      }
-      // 不支持 Range（回 200 整个文件）：只读前 maxBytes，大文件不整个拉进浏览器。
-      const all = await body({ limit: maxBytes });
-      const truncated = all.length >= maxBytes && (!length || length > maxBytes);
-      const { text, encoding } = decodeText(all);
-      return { text, truncated, size: length || all.length, contentType, encoding };
+      const { bytes, start, size, contentType } = await readRange(jobId, path, { maxBytes, tail: opts.tail, 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 };
+    },
+    async readBytes(jobId, path, opts) {
+      const { bytes, start, size } = await readRange(jobId, path, opts);
+      return { bytes, start, size };
     },
     async readBuffer(jobId, path, opts = {}) {
       const { body } = await fileFetch(jobId, path, {}, opts.signal);