@spzxg/cli-ui 0.6.6 → 0.6.7

package/src/operator/node/SessionView.tsx

@@ -5,7 +5,6 @@ import type { Status, Priority, AskQuestion, AskAnswers } from "./protocol/types
 import { OperatorBoardContext, OperatorBoardQuoteContext, type OperatorBoardOptions, type OperatorBoardRequest, type OperatorBoardTarget } from "./boardInteraction";
 import { readDraft, writeDraft, type Quote } from "./composerDraft";
 import { clientFeatures } from "./protocol/features";
-import { toolDataOf } from "./transcriptModel";
 import { Icon } from "./icons";
 import { type ResolveResult } from "./TaskChanges";
 import { fmtTokens, fmtCost, fmtJobCost, isAwaiting, buildSessions, usageSplit, costDisplay } from "./format";
@@ -27,7 +26,9 @@ import { registerOperatorBoard } from "./boardInteraction";
 import { useConfigurationBusy } from "../../chat/configuration";
 import type { SessionRail as NodeSessionRail } from "./SessionRail";
 const SessionRail=(props:ComponentProps<typeof NodeSessionRail>)=><CliBoard operator={props}/>;
-import { ColResize, ColRail } from "./Layout";
+import { ColResize } from "./Layout";
+import { WorkspaceTabs } from "../../ui/WorkspaceTabs";
+import { WorkspaceDrawer, useWorkspaceDrawer } from "../../ui/WorkspaceDrawer";
 import { jget, downloadExport } from "./api";
 
 // Non-blocking banner shown when a reopened task's worktree is behind its base
@@ -134,21 +135,24 @@ function SessionViewInner({ project, task, tasks, onSelectTask, onFork, agents,
     return () => observer.disconnect();
   }, [railW]);
   const singlePane = mobile || compact;
+  const drawerMode = useWorkspaceDrawer(sessionRef, !!mobile);
+  const tabMode = !drawerMode && (singlePane || railCollapsed);
+  const [tabsHost, setTabsHost] = useState<HTMLDivElement|null>(null);
   const [statusOpen, setStatusOpen] = useState(false);
   const [moreOpen, setMoreOpen] = useState(false);
   const [view, setView] = useState<"chat" | "changes">("chat");
   const [boardRequest,setBoardRequest]=useState<OperatorBoardRequest|null>(null);
   const boardSequence=useRef(0);
   const acknowledgeBoardRequest=useCallback((sequence:number)=>setBoardRequest(previous=>previous?.sequence===sequence?null:previous),[]);
-  const routing=useRef({singlePane,railCollapsed,onRailExpand,task,tasks,board});
-  routing.current={singlePane,railCollapsed,onRailExpand,task,tasks,board};
+  const routing=useRef({tabMode,drawerMode,task,tasks,board});
+  routing.current={tabMode,drawerMode,task,tasks,board};
   const openBoard=useCallback((target:OperatorBoardTarget)=>{
     const context=routing.current;
     if(target.kind==='browser'&&(target.taskId!==context.task.id||!clientFeatures().browser))return false;
     if(target.kind==='file'&&(!target.path||![context.task,...context.tasks].some(t=>t.id===target.taskId&&t.project_id===context.task.project_id)))return false;
     if(context.board?.availableTabs&&!context.board.availableTabs.includes(target.kind==='file'?'files':'browser'))return false;
     setBoardRequest({sequence:++boardSequence.current,target});
-    if(context.singlePane)setView('changes');else if(context.railCollapsed)context.onRailExpand();
+    if(context.tabMode||context.drawerMode)setView('changes');
     return true;
   },[]);
   useEffect(()=>registerOperatorBoard(target=>target.taskId===task.id?openBoard(target):false),[task.id,openBoard]);
@@ -159,10 +163,9 @@ function SessionViewInner({ project, task, tasks, onSelectTask, onFork, agents,
   const quoteFromBoard=useCallback((quote:Quote)=>{
     const context=routing.current;
     writeDraft(context.task.id,{...readDraft(context.task.id),quote});
-    if(context.singlePane)setView('chat');
+    if(context.tabMode||context.drawerMode)setView('chat');
     requestAnimationFrame(()=>sessionRef.current?.querySelector<HTMLTextAreaElement>('.composer textarea')?.focus({preventScroll:true}));
   },[]);
-  const activity=useMemo(()=>{const tool=[...messages].reverse().find(m=>m.role==='tool');return `${messages.length}:${tool?.id??''}:${tool?toolDataOf(tool).result!==undefined:false}`;},[messages]);
   const [clearEstimate, setClearEstimate] = useState<InternalUsageEstimate | null>(null);
   const sessions = useMemo(() => buildSessions(messages), [messages]);
   const hasSession = task.started === 1 || messages.length > 0 || !!task.parent_task_id;
@@ -193,7 +196,7 @@ function SessionViewInner({ project, task, tasks, onSelectTask, onFork, agents,
       <div className={`session${singlePane ? " compact-session" : ""}`} ref={sessionRef}>
         <div className="sess-head">
           {onBack && <button className="mobile-back" onClick={onBack} title="返回任务列表" aria-label="返回任务列表">{Icon.chevRight({ style: { transform: "rotate(180deg)" } })}</button>}
-          <div className="sh-main">
+          {hasSession&&tabMode ? <WorkspaceTabs title={task.title} subtitle={project.name} chatActive={view==='chat'} onChat={()=>setView('chat')} onTabsHost={setTabsHost}/> : <div className="sh-main">
             <div className="crumb">
               <span className="pic" style={{ width: 16, height: 16, borderRadius: 5, background: project.color, display: "grid", placeItems: "center", color: "#fff", fontSize: 9, fontWeight: 700 }}>{project.name[0]}</span>
               <span className="session-project-name" title={project.name}>{project.name}</span>
@@ -203,8 +206,9 @@ function SessionViewInner({ project, task, tasks, onSelectTask, onFork, agents,
               <span className="sht-text" title={task.title}>{task.title}</span>
               <button className="icon-btn sh-edit" title="查看并编辑任务详情" aria-label="查看并编辑任务详情" onClick={onEdit}>{Icon.edit()}</button>
             </div>
-          </div>
+          </div>}
           <div className="sh-tools">
+            {hasSession&&drawerMode&&<button className="icon-btn workspace-open" title="打开工作区" aria-label="打开工作区" aria-haspopup="dialog" aria-expanded={view==='changes'} onClick={()=>setView('changes')}>{Icon.folder()}</button>}
             <div style={{ position: "relative" }}>
               <button className={`status-ctl ${awaiting ? "awaiting" : ""}`} onClick={(e) => { e.stopPropagation(); setStatusOpen((o) => !o); setMoreOpen(false); }}>
                 <StatusDot status={task.status} running={running} awaiting={awaiting} />
@@ -227,6 +231,7 @@ function SessionViewInner({ project, task, tasks, onSelectTask, onFork, agents,
               <button className="icon-btn session-more" aria-label="更多任务操作" aria-expanded={moreOpen} onClick={(e) => { e.stopPropagation(); setMoreOpen(!moreOpen); setStatusOpen(false); }}>{Icon.dots()}</button>
               {moreOpen && <Popover onClose={() => setMoreOpen(false)}>
                 <div className="pop-sec">{agentLabel(agents, task.agent)} · {fmtTokens(usage.fresh)} tokens{cost.show && task.cost_usd > 0 ? ` · ${cost.approx ? "~" : ""}${fmtCost(task.cost_usd)}` : ""}</div>
+                <div className="pop-note session-origin" title={task.work_branch || ""}>{Icon.git()}<span>{task.parent_task_id ? `来自 ${task.fork_source_title || "来源任务"}` : "独立任务分支"}</span></div>
                 <button className="pop-item" onClick={() => { setMoreOpen(false); onEdit(); }}>{Icon.edit()} 编辑任务详情</button>
                 <button className="pop-item" onClick={() => { setMoreOpen(false); downloadExport(`/api/tasks/${task.id}/export`); }}>{Icon.download()} 导出执行过程</button>
                 {task.pr_url && <a className="pop-item" href={task.pr_url} target="_blank" rel="noreferrer">{Icon.github()} 打开 PR{prNum ? ` #${prNum}` : ""}</a>}
@@ -239,14 +244,6 @@ function SessionViewInner({ project, task, tasks, onSelectTask, onFork, agents,
           </div>
         </div>
 
-        {hasSession && <div className="session-viewbar">
-          {singlePane ? <div className="viewseg">
-            <button className={`viewseg-btn ${view === "chat" ? "on" : ""}`} onClick={() => setView("chat")}>对话</button>
-            <button className={`viewseg-btn ${view === "changes" ? "on" : ""}`} onClick={() => setView("changes")}>看板</button>
-          </div> : <span className="session-agent-label">{agentLabel(agents, task.agent)}</span>}
-          <span className="session-branch" title={task.work_branch || ""}>{Icon.git()} {task.parent_task_id ? `来自 ${task.fork_source_title}` : "独立任务分支"}</span>
-        </div>}
-
         {hasSession && (
           <SyncBanner taskId={task.id} running={running} pinned={!!task.fork_commit} onResolveWithAI={onResolveWithAI} onSwitchToChat={() => setView("chat")} />
         )}
@@ -267,19 +264,22 @@ function SessionViewInner({ project, task, tasks, onSelectTask, onFork, agents,
           // Keep the chat at the same React position across all widths. Moving
           // it between different parents remounted the composer during resize
           // and could drop a keystroke, an upload, or an in-flight setting save.
-          <div className={singlePane ? "sess-responsive" : "sess-split"} style={singlePane ? undefined : { gridTemplateColumns: railCollapsed ? "minmax(0,1fr) 30px" : `minmax(0,1fr) 0px ${railW}px` }}>
-            <div className={`sess-main${singlePane ? " compact-chat" : ""}`} hidden={singlePane && view !== "chat"}><Chat project={project} task={task} tasks={tasks} agents={agents} messages={messages}
+          <div className={tabMode||drawerMode ? "sess-responsive" : "sess-split"} style={tabMode||drawerMode ? undefined : { gridTemplateColumns: `minmax(0,1fr) 0px ${railW}px` }}>
+            <div className={`sess-main${tabMode||drawerMode ? " compact-chat" : ""}`} data-chat-layout={tabMode||drawerMode?"centered":"wide"} hidden={tabMode && view !== "chat"}><Chat project={project} task={task} tasks={tasks} agents={agents} messages={messages}
               running={running} blockedBy={blockedBy} transcriptLoading={transcriptLoading} older={older} onLoadOlder={onLoadOlder}
-              controls={controls} configBusy={configBusy} active={!singlePane || view === "chat"}
+              controls={controls} configBusy={configBusy} active={!tabMode&&!drawerMode || view === "chat"}
               onSelectTask={onSelectTask} onFork={onFork} onSend={onSend} onStop={onStop}
               onStart={onStart} onEdit={onEdit} onClear={onClear} onSetSendContext={onSetSendContext}
               onReconnect={onReconnect} onAnswer={onAnswer} onCancelQueued={onCancelQueued} /></div>
-            {!singlePane && !railCollapsed && <ColResize side="right" min={RAIL_W.min} max={RAIL_W.max} onWidth={onRailWidth} onReset={onRailReset} />}
-            {!singlePane && railCollapsed ? <ColRail label="看板" right onExpand={onRailExpand} /> : (!singlePane || view === "changes") && (
-              <SessionRail {...board} openRequest={boardRequest} onRequestHandled={acknowledgeBoardRequest} activity={activity} project={project} task={task} sessions={sessions} running={running}
+            {!tabMode&&!drawerMode && <ColResize side="right" min={RAIL_W.min} max={RAIL_W.max} onWidth={onRailWidth} onReset={onRailReset} />}
+            <WorkspaceDrawer enabled={drawerMode} open={view==='changes'} onClose={()=>setView('chat')}>
+              <SessionRail {...board} openRequest={boardRequest} onRequestHandled={acknowledgeBoardRequest} project={project} task={task} sessions={sessions} running={running}
                 onResolveWithAI={onResolveWithAI} onMerged={onMerged} onPrCreated={onPrCreated} onClear={onClear}
-                onCollapse={singlePane ? () => setView("chat") : onRailCollapse} onSwitchToChat={() => setView("chat")} />
-            )}
+                inlineLayout={tabMode?{tabsHost,active:view==='changes',onActivate:()=>setView('changes'),onChat:()=>setView('chat')}:undefined}
+                visible={!drawerMode||view==='changes'}
+                onExpand={tabMode&&!singlePane?onRailExpand:undefined}
+                onCollapse={tabMode||drawerMode ? () => setView("chat") : onRailCollapse} onSwitchToChat={() => setView("chat")} />
+            </WorkspaceDrawer>
           </div>
         )}
       </div>

package/src/operator/node/Transcript.tsx

@@ -3,7 +3,7 @@ import { useContext } from "react";
 import { OperatorBoardContext } from "./boardInteraction";
 import { FileLinkContext } from "./fileLinks";
 
-import { memo, useState } from "react";
+import { memo, useId, useState } from "react";
 import type { ToolData, ToolPeek, AskQuestion, AskAnswers, InputRequest } from "./protocol/types";
 import { Icon } from "./icons";
 import { Markdown } from "./Markdown";
@@ -18,6 +18,8 @@ import type { Msg } from "./types";
 import { clientFeatures } from "./protocol/features";
 import { Avatar } from "./shared";
 import { toolDataOf } from "./transcriptModel";
+import { ReferenceCard } from "../../ui/ReferenceCard";
+import { splitQuotedMessage } from "../../ui/reference";
 
 // The always-visible "peek" tier — Claude Code's `⎿` line. Counts show no
 // content; diffs/snippets show a capped hunk with a clickable "+N more" that
@@ -64,21 +66,22 @@ function PeekView({ peek, expandable, onExpand }: { peek: ToolPeek; expandable:
 }
 
 function ToolView({ data }: { data: ToolData }) {
-  const [open, setOpen] = useState(false);
+  const [open, setOpen] = useState<boolean | null>(null);
+  const bodyId = useId();
   const hasDiff = !!data.diff?.length;
   const expandable = !!(data.detail || hasDiff || data.result !== undefined);
   // Failures surface their output automatically, like Claude Code.
-  const showBody = open || (!!data.isError && data.result !== undefined);
+  const showBody = open ?? (!!data.isError && data.result !== undefined);
   return (
     <div className="tool">
-      <button className="tool-h" style={{ cursor: expandable ? "pointer" : "default" }} onClick={() => expandable && setOpen((o) => !o)}>
+      <button className="tool-h" title={data.title} aria-expanded={expandable ? showBody : undefined} aria-controls={expandable ? bodyId : undefined} style={{ cursor: expandable ? "pointer" : "default" }} onClick={() => expandable && setOpen(!showBody)}>
         {expandable && <span className={`tchev ${showBody ? "open" : ""}`}>{Icon.chevRight()}</span>}
         <span className="tg">{data.title}</span>
         {data.result !== undefined && <span className={data.isError ? "tx" : "tcheck"}>{data.isError ? Icon.x() : Icon.check()}</span>}
       </button>
       {data.peek && !showBody && <PeekView peek={data.peek} expandable={expandable} onExpand={() => setOpen(true)} />}
       {showBody && (
-        <div className="tool-body">
+        <div className="tool-body" id={bodyId}>
           {data.detail && <pre className="tool-pre">{data.detail}</pre>}
           {hasDiff && (
             <pre className="tool-pre diff">{data.diff!.map((l, i) => <div className={`dl ${diffCls(l.sign)}`} key={i}>{l.sign} {l.text}</div>)}</pre>
@@ -280,6 +283,7 @@ function HandoffLine({ text, onBrowser, onShowBrowser, readOnly }: { readOnly?:b
 // (click opens full size) and text-file chips (a big paste diverted to a file;
 // click opens it). Both are served from the task's uploads dir.
 function AttachmentStrip({ items }: { items: MsgAttachment[] }) {
+  const open = useContext(OperatorBoardContext), scope = useContext(FileLinkContext);
   if (!items.length) return null;
   return (
     <div className="msg-attachments">
@@ -290,8 +294,11 @@ function AttachmentStrip({ items }: { items: MsgAttachment[] }) {
             <img src={a.url} alt="附件图片" loading="lazy" />
           </a>
         ) : (
-          <a key={i} href={a.url} target="_blank" rel="noreferrer" className="file-chip" title={`打开 ${a.name}`}>
-            {Icon.clip()} <span>附件文件</span>
+          <a key={i} href={a.url} target="_blank" rel="noreferrer" className="file-chip" title={`打开 ${a.name}`} onClick={event => {
+            const taskId = /\/api\/tasks\/([^/]+)\/uploads\//.exec(a.url)?.[1] ?? scope?.taskId;
+            if (taskId && event.button === 0 && !event.metaKey && !event.ctrlKey && !event.shiftKey && !event.altKey && open?.({ kind: "file", taskId: decodeURIComponent(taskId), path: a.path })) event.preventDefault();
+          }}>
+            {Icon.clip()} <span>{a.name}</span>
           </a>
         )
       )}
@@ -310,6 +317,11 @@ function AutomaticBoardBackground({content}:{content:string}) {
  return <details className="cli-auto-background"><summary>自动看板背景</summary>{blocks.map((part,index)=>part.kind==='block'?<pre key={index}>{part.block.text}</pre>:null)}</details>;
 }
 
+function QuotedUserText({ text }: { text: string }) {
+  const quoted = splitQuotedMessage(text);
+  return quoted ? <><ReferenceCard title={quoted.quote.author} text={quoted.quote.text} renderContent={value => <Markdown>{value}</Markdown>} />{quoted.text && <Markdown>{quoted.text}</Markdown>}</> : <Markdown>{text}</Markdown>;
+}
+
 export const MessageView = memo(function MessageView({ m, initial, hideWho, running, agent, agentLabel = "智能体", onAnswer, onInput, onBrowser, onCancelQueued, onClear, onReconnect, onRetry, onQuote, readOnly }: { readOnly?: boolean; onQuote?: (m: Msg, selected?: string) => void; m: Msg; initial: boolean; hideWho: boolean; running?: boolean; agent?: string | null; agentLabel?: string; onAnswer?: (askId: string, questions: AskQuestion[], answers: AskAnswers) => void; onInput?: (inputId: string, values: string[]) => Promise<string | null>; onBrowser?: (action: "handback") => Promise<string | null>; onCancelQueued?: (pendingId: string) => void; onClear?: () => void; onReconnect?: () => void; onRetry?: (msgId: string) => void }) {
   const openBoard=useContext(OperatorBoardContext);
   const fileScope=useContext(FileLinkContext);
@@ -323,7 +335,7 @@ export const MessageView = memo(function MessageView({ m, initial, hideWho, runn
       <div className="msg user queued">
         <div className="who"><Avatar who="user" /> 你<span className="badge queued-badge">排队中</span>{m.ts != null && <span className="msg-time">{clockTime(m.ts)}</span>}</div>
         <div className="msg-body">
-          {text && <Markdown>{text}</Markdown>}
+          {text && <QuotedUserText text={text} />}
           <AutomaticBoardBackground content={m.content}/>
           <AttachmentStrip items={attachments} />
           {onCancelQueued && <button className="queued-x" title="从队列中移除" aria-label="从队列中移除" onClick={() => onCancelQueued(m.id)}>{Icon.x()}</button>}
@@ -440,7 +452,7 @@ export const MessageView = memo(function MessageView({ m, initial, hideWho, runn
       )}
       <div className="msg-body">
         {initial && <div className="initial-tag">{Icon.spark()} 已随项目上下文发送</div>}
-        {text && <Markdown>{text}</Markdown>}
+        {text && (isUser ? <QuotedUserText text={text} /> : <Markdown>{text}</Markdown>)}
         {isUser&&<AutomaticBoardBackground content={m.content}/>}
         <AttachmentStrip items={attachments} />
       </div>

package/src/operator/node/boardBackend.ts

@@ -24,25 +24,6 @@ export function createOperatorBoardBackend(fetcher: typeof fetch = (...args) =>
     },
     fileUrl(id, path, options) { const url = taskFileApiUrl(id, path); return options?.download ? `${url}${url.includes('?') ? '&' : '?'}download=1` : url; },
     fileLinkBase: async id => `/api/tasks/${encodeURIComponent(id)}/files`,
-    watchFiles(id,handlers) {
-      let stopped=false,ended=false;
-      const disrupted=(reason:string)=>{if(!stopped&&!ended)handlers.onEvent({type:'resync',reason,complete:false});};
-      const subscription=openLive(`/api/tasks/${encodeURIComponent(id)}/files/events`,{
-        onMessage:data=>{
-          if(stopped||ended)return;
-          try{const event=JSON.parse(data);if(['snapshot','changes','resync'].includes(event.type))handlers.onEvent(event);}catch{/* Ignore invalid event. */}
-        },
-        onEnd:code=>{
-          if(stopped||ended)return;
-          if(code===0||code===408||code===429||(code>=500&&code!==501)){disrupted(code===429?'文件监听暂时限流，正在等待恢复':'文件监听连接中断，正在重连');return;}
-          ended=true;
-          const message=code===401?'文件监听登录已过期，请重新登录':code===403?'文件监听被拒绝，请检查任务权限或登录':code===404?'未找到任务或节点不支持文件事件接口':`文件监听请求失败（HTTP ${code}）`;
-          handlers.onClose(new CenterError(message,`HTTP_${code}`,code));
-        },
-        onError:error=>disrupted(error.message),
-      });
-      return()=>{stopped=true;subscription.close();};
-    },
     browserEvents(id,handlers) {
       let stopped=false,ended=false;
       const disrupted=(error:CenterError)=>{if(!stopped&&!ended)handlers.onError?.(error);};

package/src/operator/node/boardEvents.ts

@@ -4,16 +4,34 @@ import type { WorkspaceHandlers } from '../../core/provider';
 import type { WorkspaceChangeEvent } from '../../core/types';
 import { cloneBoardView } from '../../board/context';
 import type { CliEvent } from '../../core/store';
-import { cloneWorkspaceChange, subscribeWorkspaceFiles } from '../../board/fileWatch';
+import { cloneWorkspaceChange, subscribeWorkspaceFiles, retryWorkspaceFiles, type WorkspaceRefreshOptions } from '../../board/fileWatch';
 import { getOperatorBoardBackend } from './boardBackend';
-import { readBoardState, subscribeBoardState } from './boardState';
+import { readBoardState, readVisibleBoardSources, subscribeBoardState } from './boardState';
+import { observeLiveMessages } from './liveStream';
+export function refreshOperatorWorkspaceFiles(taskId:string,options?:WorkspaceRefreshOptions):void {
+ const backend=getOperatorBoardBackend(),sources=new Set([taskId,...readVisibleBoardSources(taskId)]);
+ for(const source of sources)options?retryWorkspaceFiles(backend,source,options):retryWorkspaceFiles(backend,source);
+}
+const observedTasks=new Map<string,{refs:number;stop:()=>void}>();
+function observeTaskFiles(taskId:string):()=>void {
+ let entry=observedTasks.get(taskId);
+ if(!entry){
+  entry={refs:0,stop:observeLiveMessages(`/api/tasks/${taskId}/messages`,data=>{
+   try{const event=JSON.parse(data);if(event.type==='turn_end'||event.type==='snapshot')refreshOperatorWorkspaceFiles(taskId);}catch{/* Ignore unrelated/malformed stream payloads. */}
+  })};observedTasks.set(taskId,entry);
+ }
+ const owned=entry;owned.refs++;let active=true;
+ return()=>{if(!active)return;active=false;if(--owned.refs===0){observedTasks.delete(taskId);owned.stop();}};
+}
 export type OperatorBoardHandlers=WorkspaceHandlers&{onEvent?:(event:CliEvent)=>void};
 export function useOperatorFileWatch(taskId:string,enabled:boolean,handlers:OperatorBoardHandlers={},onChange?:(event:WorkspaceChangeEvent)=>void,intervalMs?:number){
  const current=useRef({handlers,onChange});current.current={handlers,onChange};
  useEffect(()=>{
   if(!enabled)return;
-  return subscribeWorkspaceFiles(getOperatorBoardBackend(),taskId,event=>{current.current.onChange?.(event);notifyCallback(current.current.handlers.onFilesChange,cloneWorkspaceChange(event));notifyCallback(current.current.handlers.onEvent,cloneWorkspaceChange(event));},
+  const unobserve=observeTaskFiles(taskId);
+  const unsubscribe=subscribeWorkspaceFiles(getOperatorBoardBackend(),taskId,event=>{current.current.onChange?.(event);notifyCallback(current.current.handlers.onFilesChange,cloneWorkspaceChange(event));notifyCallback(current.current.handlers.onEvent,cloneWorkspaceChange(event));},
    {intervalMs,onStatus:status=>{notifyCallback(current.current.handlers.onFilesWatch,{...status});notifyCallback(current.current.handlers.onEvent,{...status});}});
+  return()=>{unobserve();unsubscribe();};
  },[taskId,enabled,intervalMs]);
 }
 export function useOperatorContextEvents(taskId:string,enabled:boolean,handlers:OperatorBoardHandlers={}){

package/src/operator/node/boardState.ts

@@ -5,6 +5,8 @@ import { notifyCallback } from '../../core/callbacks';
 const cache=new Map<string,{stamp:string;view:BoardView|null}>();
 const listeners=new Map<string,Set<()=>void>>();
 const owners=new Map<string,Map<string,BoardView>>();
+// Mounted directory identity is transient; it must not become retained browsing history.
+const directorySources=new Map<string,Map<string,string>>();
 const key=(id:string)=>`cli-ui:operator-board:${id}`;
 const stamp=(id:string)=>{try{return sessionStorage.getItem(key(id))??'';}catch{return 'blocked';}};
 const validFile=(value:unknown):value is BoardFile=>!!value&&typeof value==='object'&&typeof (value as BoardFile).path==='string'&&!!(value as BoardFile).path&&((value as BoardFile).sourceId===undefined||typeof (value as BoardFile).sourceId==='string');
@@ -20,6 +22,18 @@ export function readBoardState(taskId:string):BoardView|null {
  }catch{/* Broken preferences cannot stop the workspace. */}
  cache.set(taskId,{stamp:saved,view});return view;
 }
+/** Internal: background refresh covers every visible owner, not just the selected board. */
+export function readVisibleBoardSources(taskId:string):string[] {
+ const active=owners.get(taskId);
+ const views=active?.size?[...active]:[['',readBoardState(taskId)] as const];
+ const sources=new Set<string>();
+ for(const [owner,view] of views){
+  if(!view||view.visible===false)continue;
+  for(const file of view.opened??[])sources.add(file.sourceId??taskId);
+  const directory=directorySources.get(taskId)?.get(owner);if(directory)sources.add(directory);
+ }
+ return [...sources];
+}
 export function subscribeBoardState(taskId:string,listener:()=>void):()=>void {
  const set=listeners.get(taskId)??new Set<()=>void>();set.add(listener);listeners.set(taskId,set);return()=>{set.delete(listener);if(!set.size)listeners.delete(taskId);};
 }
@@ -36,8 +50,10 @@ export function visitBoardFile(taskId:string,file:BoardFile):void {
  const current=readBoardState(taskId)??{tab:'files',dir:'',file:null,files:[]};
  publishBoardState(taskId,{...current,history:recent([...(current.history??[]),file])});
 }
-export function reportBoardState(taskId:string,owner:string,view:BoardView):void {
+export function reportBoardState(taskId:string,owner:string,view:BoardView,directorySource?:string):void {
  const sources=owners.get(taskId)??new Map<string,BoardView>();
+ if(directorySource){const directories=directorySources.get(taskId)??new Map<string,string>();directories.set(owner,directorySource);directorySources.set(taskId,directories);}
+ else{const directories=directorySources.get(taskId);directories?.delete(owner);if(!directories?.size)directorySources.delete(taskId);}
  const history=readBoardState(taskId)?.history??view.history??[];
  const selected=reportBoardOwner(sources,owner,{...view,history});owners.set(taskId,sources);
  if(selected)publishBoardState(taskId,{...selected[1],history});
@@ -51,6 +67,7 @@ export function activateBoardState(taskId:string,owner:string):void {
 }
 export function releaseBoardState(taskId:string,owner:string):void {
  const sources=owners.get(taskId);sources?.delete(owner);if(!sources?.size)owners.delete(taskId);
+ const directories=directorySources.get(taskId);directories?.delete(owner);if(!directories?.size)directorySources.delete(taskId);
  const previous=readBoardState(taskId);if(!previous)return;
  const remaining=sources?.size?selectedBoardOwner(sources)?.[1]:null;
  publishBoardState(taskId,remaining?{...remaining,history:previous.history,visible:remaining.visible!==false}:{...previous,visible:false});

package/src/operator/node/boardWorkspace.ts

@@ -1,12 +1,15 @@
+import type { WorkspaceRefreshOptions } from '../../board/fileWatch';
 import { createWorkspace } from '../../board/workspace';
 import { cloneBoardView } from '../../board/context';
 import { getOperatorBoardBackend } from './boardBackend';
 import { readBoardState } from './boardState';
 import { openOperatorBoard } from './boardInteraction';
+import { refreshOperatorWorkspaceFiles } from './boardEvents';
 /** Host API for the node workspace. Uses the same cloud-facing file API as the board. */
 export function createOperatorWorkspace(taskId:string){
- return createWorkspace({backend:getOperatorBoardBackend(),key:taskId,
+ const workspace=createWorkspace({backend:getOperatorBoardBackend(),key:taskId,
   view:()=>{const view=readBoardState(taskId);return view?.visible?cloneBoardView(view):undefined;},
   context:()=>{const view=readBoardState(taskId);return view?cloneBoardView(view):null;},
   open:path=>openOperatorBoard({kind:'file',taskId,path})});
+ return {...workspace,refresh:(options?:WorkspaceRefreshOptions)=>refreshOperatorWorkspaceFiles(taskId,options)};
 }

package/src/operator/node/composerDraft.ts

@@ -1,5 +1,9 @@
-export type Quote = { id: string; author: string; text: string };
+import type { UploadPhase } from "../../core/documentUpload";
+
+export type Quote = { id: string; author: string; text: string; sourceTaskId?: string };
 export type Attachment = {
+  progress?: number;
+  phase?: UploadPhase; bytes?: number; size?: number;
   key: string; kind: "image" | "file"; name: string; preview: string; path: string;
   status: "uploading" | "ready" | "error"; error?: string;
 };
@@ -15,7 +19,7 @@ export function readDraft(id: string): ComposerDraft {
     const raw = localStorage.getItem(key(id));
     if (raw) {
       const d = JSON.parse(raw) as ComposerDraft;
-      if (typeof d.text === "string" && Array.isArray(d.attachments)) return { ...d, attachments: d.attachments.map((a) => a.status === "uploading" ? { ...a, preview: "", status: "error", error: "上传已中断，请移除后重新添加。" } : a) };
+      if (typeof d.text === "string" && Array.isArray(d.attachments)) return { ...d, attachments: d.attachments.map((a) => a.status === "uploading" ? { ...a, preview: "", status: "error", error: "上传已中断，请重新选择文件。" } : a) };
     }
     return { ...emptyDraft(), text: localStorage.getItem(`orch:draft:${id}`) ?? "" };
   } catch { return emptyDraft(); }

package/src/operator/node/format.ts

@@ -279,9 +279,11 @@ export function splitAttachments(content: string): { text: string; attachments:
   for (const line of content.split("\n")) {
     const m = ATTACHMENT_RE.exec(line.trim());
     const parts = m ? m[2].split(/[\\/]/).filter(Boolean) : [];
-    if (m && parts.length >= 3 && parts[parts.length - 3] === "uploads") {
+    const upload = parts.length >= 3 && parts[parts.length - 3] === "uploads";
+    const managed = parts.length >= 4 && parts[parts.length - 4] === ".workspace" && parts[parts.length - 3] === "attachments";
+    if (m && (upload || managed) && parts.slice(-2).every(part => part !== "." && part !== "..")) {
       const [taskId, file] = parts.slice(-2);
-      attachments.push({ path: m[2], url: `/api/tasks/${taskId}/uploads/${file}`, kind: m[1] === "image" ? "image" : "file", name: file });
+      attachments.push({ path: m[2], url: `/api/tasks/${encodeURIComponent(taskId)}/uploads/${encodeURIComponent(file)}`, kind: m[1] === "image" ? "image" : "file", name: file });
     } else {
       kept.push(line);
     }

package/src/operator/node/liveStream.ts

@@ -45,6 +45,18 @@ const BACKOFF_MS = [500, 1000, 2000, 4000, 8000];
 const PROBE_MS = 30_000;
 
 const subs = new Map<number, Sub>();
+const observers = new Map<string, Set<(data: string) => void>>();
+/** Observe an existing route without opening a connection or server subscription. */
+export function observeLiveMessages(path: string, listener: (data: string) => void): () => void {
+  const key = path.split("?")[0];
+  const listeners = observers.get(key) ?? new Set(); observers.set(key, listeners); listeners.add(listener);
+  return () => { listeners.delete(listener); if (!listeners.size) observers.delete(key); };
+}
+function deliver(s: Sub, data: string) {
+  if (subs.get(s.id) !== s) return;
+  for (const listener of [...observers.get(s.url.split("?")[0]) ?? []]) notifyCallback(listener, data);
+  if (subs.get(s.id) === s) s.h.onMessage(data);
+}
 let nextId = 1;
 let mode: "ws" | "sse" | null = null;
 let ws: WebSocket | null = null;
@@ -91,7 +103,7 @@ function openEventSource(s: Sub) {
   const es = new EventSource(s.url);
   const active = () => subs.get(s.id) === s && s.es === es;
   es.onopen = () => { if (!active()) return; if (s.retry) { clearTimeout(s.retry); s.retry = undefined; } s.fails = 0; s.h.onOpen?.(); };
-  es.onmessage = (event) => { if (active()) s.h.onMessage(event.data); };
+  es.onmessage = (event) => { if (active()) deliver(s, event.data); };
   es.onerror = () => {
     if (!active()) return;
     notifyCallback(s.h.onError, new Error("实时事件连接中断，正在等待恢复"));
@@ -203,7 +215,7 @@ function onFrame(text: string) {
   const nl = text.indexOf("\n");
   if (nl <= 0) return;
   const s = subs.get(Number(text.slice(0, nl)));
-  if (s) s.h.onMessage(text.slice(nl + 1));
+  if (s) deliver(s, text.slice(nl + 1));
 }
 
 function connect() {

package/src/operator/node/useTaskStream.ts

@@ -232,12 +232,14 @@ export function useTaskStream({ selTask, selProjRef, agentsRef, setTaskRunning,
       setOlderByTask(drop);
       for (const t of evicted) { delete openAsksRef.current[t]; delete loadingOlderRef.current[t]; }
     }
+    let active = true;
     const sub = openLive(`/api/tasks/${id}/messages?tail=${SNAPSHOT_TAIL}`, {
       onMessage: (data) => {
+        if (!active) return;
         try { handleStreamEventRef.current(id, JSON.parse(data) as TaskStreamEvent); } catch {}
       },
     });
-    return () => sub.close();
+    return () => { active = false; sub.close(); };
   }, [selTask]);
 
   // Page in the next batch of earlier messages for a task (the transcript calls