@spzxg/cli-ui 0.6.1 → 0.6.2

package/dist/cli-ui.js

@@ -1,4 +1,4 @@
-import { C as a, b as i, d as r, e as t, f as o, h as C, i as l, j as n, k as m, m as d, l as u, n as w, o as B, p as f } from "./cli-ui-embed-Dk2QGHxn.js";
+import { C as a, b as i, d as r, e as t, f as o, h as C, i as l, j as n, k as m, m as d, l as u, n as w, o as B, p as f } from "./cli-ui-embed-6IJ_jRVh.js";
 export {
   a as CliBoard,
   i as CliBrowserView,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spzxg/cli-ui",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "type": "module",
   "description": "任务中心（cli-task-center）对话任务的前端积木：cli-msglist 消息对话列表、cli-chat 对话，数据全部来自 center 服务。",
   "main": "src/index.ts",

package/src/chat/CliChat.tsx

@@ -7,7 +7,7 @@ import type { CliEvent, CliStore, CliStoreOptions } from "../core/store.js";
 import { useCliState, useCliStore, useCliStoreContext, useComponentEvents, withOwnProvider, type ResultHandlers } from "../core/provider.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";
@@ -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;
@@ -385,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 });
@@ -541,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;
 
@@ -573,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>}
@@ -603,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>
             )}
@@ -734,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

@@ -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) => {
@@ -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={`添加文档：${ACCEPTED_LABEL}（也可拖拽进来），内容会转成文字发送`} 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/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>;
@@ -336,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`, {

package/src/core/config.ts

@@ -1,5 +1,5 @@
 /**
- * 组件的界面配置：哪些模块显示、文案怎么写。全部可选，不给就是缺省（默认文案；cli-chat 的顶部栏缺省隐藏，其余全部显示）。
+ * 组件的界面配置：哪些模块显示、文案怎么写。全部可选，缺省值见下方 DEFAULT_*_CONFIG。
  *
  *   <CliChat config={{ header: { title: true, status: true }, composer: { placeholder: "问点什么…", fileUpload: false } }} />
  *   <CliMsgList config={{ header: { refresh: false }, card: { turns: false } }} />
@@ -39,7 +39,7 @@ export interface CliChatConfig {
     placeholderRunning?: string;
     /** 不能发送时（对话已结束、只读）的占位文案。 */
     placeholderDisabled?: string;
-    /** 底部「⏎ 发送 / ⇧⏎ 换行」提示。 */
+    /** 底部「Shift + Enter 换行」提示；发送快捷键仍为 Enter。 */
     hints?: boolean;
     /** 底部字数统计。 */
     charCount?: boolean;
@@ -47,7 +47,7 @@ export interface CliChatConfig {
     fileUpload?: boolean;
     /** 「文件」按钮的文字。 */
     fileButtonText?: string;
-    /** 运行中的停止按钮。 */
+    /** 执行控制：普通对话停止当前轮次，一次性子任务暂停 / 继续。 */
     stop?: boolean;
     /** 运行中允许发消息排队；false = 运行中不能发。 */
     queue?: boolean;
@@ -60,6 +60,8 @@ export interface CliChatConfig {
     sessionLabel?: boolean;
     /** 消息时间。 */
     timestamps?: boolean;
+    /** 已随项目上下文发送的初始提示。缺省不渲染；true 显示原文。 */
+    initialPrompt?: boolean;
     /** 首条消息上的「初始提示」「已随项目上下文发送」标记。 */
     initialBadge?: boolean;
     /** 工具调用卡片（命令、读写文件……）；false 只留文字往来（提问卡片照常显示）。 */
@@ -87,7 +89,7 @@ export interface ResolvedChatConfig {
     show: boolean; placeholder: string; placeholderNew: string; placeholderRunning: string; placeholderDisabled: string | null;
     hints: boolean; charCount: boolean; fileUpload: boolean; fileButtonText: string; stop: boolean; queue: boolean;
   };
-  transcript: { nav: boolean; sessionLabel: boolean; timestamps: boolean; initialBadge: boolean; tools: boolean; runningIndicator: boolean; status: boolean };
+  transcript: { nav: boolean; sessionLabel: boolean; timestamps: boolean; initialPrompt: boolean; initialBadge: boolean; tools: boolean; runningIndicator: boolean; status: boolean };
   labels: { user: string; agent: string };
   empty: { show: boolean; title: string; description: string };
   /** 按种类显示 / 不显示；"*" 是没列出的种类。用 refShown 判断。 */
@@ -102,13 +104,13 @@ export const DEFAULT_CHAT_CONFIG: ResolvedChatConfig = {
   header: { show: true, crumb: false, export: false, title: false, agent: false, usage: false, model: false, status: false, close: false },
   composer: {
     show: true,
-    placeholder: "在“{title}”中回复 {agent}…（可拖入 Word / Excel / Markdown 等文档）",
-    placeholderNew: "输入第一条消息，开始新对话…（可拖入 Word / Excel / Markdown 等文档）",
+    placeholder: "回复 {agent}…",
+    placeholderNew: "输入消息，开始新对话…",
     placeholderRunning: "排队一条后续消息…（本轮结束后发送）",
     placeholderDisabled: null,
     hints: true, charCount: true, fileUpload: true, fileButtonText: "文件", stop: true, queue: true,
   },
-  transcript: { nav: true, sessionLabel: true, timestamps: true, initialBadge: true, tools: true, runningIndicator: true, status: false },
+  transcript: { nav: true, sessionLabel: true, timestamps: true, initialPrompt: false, initialBadge: true, tools: true, runningIndicator: true, status: false },
   labels: { user: "你", agent: "智能体" },
   empty: { show: true, title: "开始一个新对话", description: "在下面输入第一条消息。可以附上 Word、Excel、Markdown、TXT、HTML、CSV 文档，内容会转成文字一起发送。" },
   refs: { "*": true, viewing: false },
@@ -119,12 +121,6 @@ export function resolveChatConfig(config: CliChatConfig = {}): ResolvedChatConfi
   const header = config.header === true ? allOn(d.header) : toggle(config.header, d.header);
   const composer = toggle(config.composer, d.composer);
   const empty = toggle(config.empty, d.empty);
-  // 没有文件上传时，缺省文案里的「可拖入文件」提示也去掉。
-  if (!composer.fileUpload) {
-    const strip = (text: string) => text.replace(/（可拖入 Word \/ Excel \/ Markdown 等文档）$/, "");
-    if (!isObj(config.composer) || config.composer.placeholder === undefined) composer.placeholder = strip(composer.placeholder);
-    if (!isObj(config.composer) || config.composer.placeholderNew === undefined) composer.placeholderNew = strip(composer.placeholderNew);
-  }
   return {
     header,
     composer,
@@ -146,7 +142,7 @@ export interface CliMsgListConfig {
     newButton?: boolean;
     /** 「+ 对话」按钮的文字。 */
     newButtonText?: string;
-    /** 刷新按钮。 */
+    /** 手动刷新按钮，缺省隐藏；列表仍按 pollMs 自动更新。 */
     refresh?: boolean;
     /** 上下文说明框（需同时给 context 或 onEditContext）。 */
     context?: boolean;
@@ -192,7 +188,7 @@ export interface ResolvedMsgListConfig {
 }
 
 export const DEFAULT_MSGLIST_CONFIG: ResolvedMsgListConfig = {
-  header: { show: true, title: true, newButton: true, newButtonText: "对话", refresh: true, context: true },
+  header: { show: true, title: true, newButton: true, newButtonText: "对话", refresh: false, context: true },
   search: "auto",
   searchPlaceholder: "搜索对话…",
   grouped: false,

package/src/core/conversation.ts

@@ -403,10 +403,10 @@ function batchViewMessages(conv: ConvState): Msg[] {
   }
   const generation = out.length ? out[out.length - 1].generation : 1;
   const note = (id: string, content: string) => out.push({ id: `batch-${id}`, role: "system", content, generation });
+  for (const q of task?.queued ?? []) out.push({ id: `batch-q-${q.id}`, role: "queued", content: q.prompt, generation, ...(q.created_at ? { ts: new Date(q.created_at).getTime() } : {}) });
   if (task?.conversation) {
     // 对话式：像对话一样显示——还没派发的消息是「排队中」气泡，没有「子任务」字样。
     if (CHAT_TASK_ERROR[task.status]) note(`err-${task.id}-${task.attempt}`, `⚠ ${CHAT_TASK_ERROR[task.status]}${task.last_error ? `：${describeTurnError(task.last_error)}` : ""}`);
-    for (const q of task.queued ?? []) out.push({ id: `batch-q-${q.id}`, role: "queued", content: q.prompt, generation, ...(q.created_at ? { ts: new Date(q.created_at).getTime() } : {}) });
     return out;
   }
   if (!task) {

package/src/styles.css

@@ -46,6 +46,37 @@
 .cli-ui .cli-count{font-family:var(--mono);}
 .cli-ui .cli-count.over{color:var(--red);}
 
+/* 组件在侧栏中也保持清晰的标题、操作和输入区。 */
+.cli-ui.cli-chat{container:cli-chat / inline-size;}
+.cli-ui .sess-head .sh-main{min-width:0;flex:1 1 180px;}
+.cli-ui .sess-head .sh-tools{min-width:0;max-width:100%;flex-wrap:wrap;justify-content:flex-end;margin-left:auto;}
+.cli-ui .sess-head .crumb{overflow-wrap:anywhere;}
+.cli-ui .cli-export{white-space:nowrap;}
+.cli-ui .comp-area textarea{min-width:0;min-height:48px;}
+.cli-ui .comp-foot{gap:8px;padding:8px 10px;background:transparent;border-top:0;flex-wrap:wrap;}
+.cli-ui .cli-attach{display:inline-flex;align-items:center;gap:5px;min-height:32px;padding:0 8px;border-radius:7px;color:var(--ink-3);font-size:12px;}
+.cli-ui .cli-attach:hover{background:var(--surface-2);color:var(--ink);}
+.cli-ui .cli-attach svg{width:15px;height:15px;}
+.cli-ui .send.cli-send{display:inline-flex;justify-content:center;gap:5px;width:auto;min-width:76px;padding:0 12px;font-size:12.5px;font-weight:600;}
+.cli-ui .send.cli-send:disabled{background:var(--surface-2);color:var(--ink-4);box-shadow:none;opacity:1;}
+.cli-ui .cli-export:focus-visible,.cli-ui .cli-attach:focus-visible,.cli-ui .send:focus-visible{outline:2px solid var(--accent);outline-offset:3px;}
+.cli-ui .cli-task-control{height:34px;padding:0 10px;white-space:nowrap;}
+.cli-ui .cli-task-control:focus-visible{outline:2px solid var(--accent);outline-offset:3px;}
+@container cli-chat (max-width:560px){
+  .cli-ui .sess-head{gap:8px;padding:12px 14px;}
+  .cli-ui .sess-head .sh-main{flex-basis:100%;}
+  .cli-ui .sess-head .sh-tools{flex:1;justify-content:flex-start;margin-left:0;}
+  .cli-ui .sess-head .cli-export{margin-left:auto;}
+  .cli-ui .tw{padding:0 16px;}
+  .cli-ui .composer{padding:10px 12px;}
+}
+
+/* 普通文本和 URL 换行；代码、宽表格只在各自区域内横向滚动。聊天和看板预览共用。 */
+.cli-ui .transcript-wrap,.cli-ui .transcript,.cli-ui .tw,.cli-ui .msg,.cli-ui .msg-body,.cli-ui .md{min-width:0;}
+.cli-ui .msg-body,.cli-ui .md{overflow-wrap:anywhere;}
+.cli-ui .md pre{max-width:100%;overflow-wrap:normal;}
+.cli-ui .md table{display:block;max-width:100%;overflow-x:auto;}
+
 /* 排队气泡下的等待原因（中枢给的：节点连不上、没有可用节点……） */
 .cli-ui .cli-queued-note{margin-top:6px;font-size:12px;color:var(--amber);}
 

package/src/ui/icons.tsx

@@ -54,6 +54,7 @@ export const Icon = {
   external: (p?: P) => S(<><path d="M14 4h6v6" /><path d="M20 4l-9 9" /><path d="M19 13v5a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V7a2 2 0 0 1 2-2h5" /></>, p),
   copy: (p?: P) => S(<><rect x={9} y={9} width={12} height={12} rx={2} /><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1" /></>, p),
   play: (p?: P) => S(<path d="M7 5l11 7-11 7z" />, p),
+  pause: (p?: P) => S(<><path d="M9 5v14" /><path d="M15 5v14" /></>, p),
   stop: (p?: P) => S(<rect x={6} y={6} width={12} height={12} rx={2} />, p),
   sliders: (p?: P) => S(<><line x1={4} y1={21} x2={4} y2={14} /><line x1={4} y1={10} x2={4} y2={3} /><line x1={12} y1={21} x2={12} y2={12} /><line x1={12} y1={8} x2={12} y2={3} /><line x1={20} y1={21} x2={20} y2={16} /><line x1={20} y1={12} x2={20} y2={3} /><line x1={1} y1={14} x2={7} y2={14} /><line x1={9} y1={8} x2={15} y2={8} /><line x1={17} y1={16} x2={23} y2={16} /></>, p),
   search: (p?: P) => S(<><circle cx={11} cy={11} r={7} /><line x1={21} y1={21} x2={16.65} y2={16.65} /></>, p),