prts-terrarchive 0.2.0 → 0.2.2

package/ui/rhine/workbench.ts

@@ -102,6 +102,7 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
   const quality = { ...WORKBENCH_QUALITY };
   const navigationLimiter = new ArchiveNavigationLimiter();
   let manualSources: ArchiveSource[] = [];
+  let restoredSources: ArchiveSource[] = [];
   let extracts: Extract[] = [];
   let sources: ArchiveSource[] = [];
   let discoveredSources: ArchiveSource[] = [];
@@ -190,6 +191,7 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
   let navigationHint: { axis: 'row' | 'lane'; direction: number } | undefined;
   let hostState: RhineHostState | undefined = options.host?.getState();
   let hostActionBusy = false;
+  let hostCancelBusy = false;
   let hostActionError = '';
   let hostRetry: (() => Promise<void>) | undefined;
   let hostTrigger: HTMLElement | null = null;
@@ -273,8 +275,8 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
       </section>
       <section class="rhine-desk-panel" aria-label="本次调查档案架" hidden>
         <div class="tiny-label">EVIDENCE RACK / <span class="rhine-desk-count">00</span></div><h2>调查档案架</h2><p class="rhine-rack-intro">选择标题定位档案，抽取后阅读原文。</p><label class="rhine-shelf-search"><span aria-hidden="true">⌕</span><input class="rhine-shelf-filter" type="search" placeholder="在全部档案中筛选标题、内容…" aria-label="筛选全部档案"/><button type="button" class="rhine-shelf-clear" hidden aria-label="清除档案筛选">×</button></label><div class="rhine-rack-range" role="status"></div>
-        <div class="rhine-shelf-current"><span class="rhine-shelf-number">S-000</span><h3 class="rhine-shelf-title">等待第一份资料</h3><div class="rhine-shelf-meta"></div><p class="rhine-shelf-excerpt">Agent 实际读过或你主动收藏的资料，留在这里供回查。</p><label class="rhine-evidence-target"><span>证据盒归属</span><select aria-label="证据盒归属" disabled><option>正在读取调查板…</option></select></label><div class="rhine-priority-actions"><button type="button" class="rhine-shelf-open">抽取阅读 <span>↗</span></button><button type="button" class="rhine-shelf-stage">＋ 放入重点证据盒</button></div></div>
-        <div class="rhine-shelf-navigation"><button type="button" class="rhine-shelf-prev" aria-label="翻阅上一份资料">←</button><div class="rhine-desk-list" role="group" aria-label="档案标题选择列表"></div><button type="button" class="rhine-shelf-next" aria-label="翻阅下一份资料">→</button></div><div class="rhine-desk-pagination"></div><button type="button" class="rhine-rack-directory">全部资料目录 <span>↗</span></button>
+        <div class="rhine-shelf-current"><span class="rhine-shelf-number">S-000</span><h3 class="rhine-shelf-title">等待第一份资料</h3><div class="rhine-shelf-meta"></div><p class="rhine-shelf-excerpt">已交付给 Agent 的资料与手动收藏，留在这里供回查；入架不代表已读原文。</p><label class="rhine-evidence-target"><span>证据盒归属</span><select aria-label="证据盒归属" disabled><option>正在读取调查板…</option></select></label><div class="rhine-priority-actions"><button type="button" class="rhine-shelf-open">抽取阅读 <span>↗</span></button><button type="button" class="rhine-shelf-stage">＋ 放入重点证据盒</button></div></div>
+        <div class="rhine-shelf-navigation"><button type="button" class="rhine-shelf-prev" aria-label="翻阅上一份资料">←</button><div class="rhine-desk-list" role="group" aria-label="档案标题选择列表"></div><button type="button" class="rhine-shelf-next" aria-label="翻阅下一份资料">→</button></div><div class="rhine-desk-pagination"></div><button type="button" class="rhine-rack-directory">档案架目录 <span>↗</span></button>
         <div class="rhine-rack-legend"><span data-state="found">查得</span><span data-state="read">Agent 已读</span><span data-state="cited">已引用</span><span data-state="saved">手动收藏</span></div><button type="button" class="rhine-shelf-report" hidden>调查报告 <span>↗</span></button>
       </section>
       <button type="button" class="rhine-location-button"><span class="rhine-location-title">调查档案架 <b>→</b></span><span class="rhine-location-count">00</span></button>
@@ -286,7 +288,7 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
       <form class="rhine-agent-form" aria-label="向 Agent 提问">
         <div class="rhine-agent-heading"><label for="rhine-agent-question">ASK THE ARCHIVE</label><div class="rhine-agent-settings" aria-label="调查配置" hidden><button type="button" class="rhine-session-mode" aria-haspopup="dialog"><small>MODE</small><span>选择模式</span><i aria-hidden="true">⌄</i></button><button type="button" class="rhine-session-model" aria-haspopup="dialog"><small>MODEL</small><span>选择模型</span><i aria-hidden="true">⌄</i></button></div><span class="rhine-agent-availability">AGENT / READY</span></div>
         <div class="rhine-agent-field"><span aria-hidden="true">⌕</span><input id="rhine-agent-question" type="text" autocomplete="off" placeholder="输入问题，交给 Agent 调查…" maxlength="3000" aria-label="调查问题"/><button type="button" class="rhine-agent-cancel" hidden aria-label="停止当前任务">■ 停止</button><button type="submit" class="rhine-agent-submit" aria-label="提交调查问题">SEND <span>↗</span></button></div>
-        <div class="rhine-agent-board-context" title="查看或切换调查板不会改变 Agent 的工作板"></div><div class="rhine-agent-footer"><span class="rhine-agent-hint">候选资料在检索阵列；已读与收藏资料入架。</span><button type="button" class="rhine-manual-search">检索资料 <span>→</span></button></div>
+        <div class="rhine-agent-board-context" title="查看或切换调查板不会改变 Agent 的工作板"></div><div class="rhine-agent-footer"><span class="rhine-agent-hint">资料交付给 Agent 后入架，已读与引用状态分别保留。</span><button type="button" class="rhine-manual-search">检索资料 <span>→</span></button></div>
         <button type="button" class="rhine-session-alert" hidden aria-haspopup="dialog"><span>会话设置暂不可用</span><b>查看详情 ↗</b></button>
       </form>
       <section class="rhine-activity" aria-label="Agent 检索状态" hidden><span class="rhine-status-dot"></span><span class="rhine-status-title" role="status"></span><span class="rhine-activity-query"></span><span class="rhine-activity-detail"></span></section>
@@ -300,8 +302,8 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
       </section>
       <section class="rhine-basket modal-backdrop" aria-label="收藏与摘录" hidden><div class="terminal-modal rhine-basket-modal"><div class="modal-top"><span>RHINE LAB / RESEARCH EXTRACTS</span><button type="button" class="rhine-close-basket" aria-label="关闭收藏">CLOSE <span>×</span></button></div><h2>RESEARCH EXTRACTS<small>收藏与摘录 <span class="rhine-extract-count">00</span></small></h2><p class="rhine-panel-description">选取原文，保存线索和来源。摘录随你提交的调查问题一起发送。</p><div class="rhine-basket-list"></div><button type="button" class="rhine-send-extracts solid-button">将摘录交给 Agent ↗</button></div></section>
       <section class="rhine-log modal-backdrop" aria-label="Agent 调查记录" hidden><div class="terminal-modal rhine-log-modal"><div class="modal-top"><span>RHINE LAB / INVESTIGATION RECORDS</span><button type="button" class="rhine-close-log" aria-label="关闭调查记录">CLOSE <span>×</span></button></div><h2>RESEARCH LOG<small>调查记录</small></h2><div class="rhine-log-status"></div><div class="rhine-log-content"><div class="rhine-log-sources"></div><div class="rhine-log-records-heading tiny-label">TOOL RECEIPTS / 工具调用记录</div><div class="rhine-log-records"></div><div class="rhine-log-answer"></div></div></div></section>
-      <section class="rhine-rack-index modal-backdrop" aria-label="调查资料目录" hidden><div class="terminal-modal rhine-rack-index-modal"><div class="modal-top"><span>RHINE LAB / EVIDENCE INDEX</span><button type="button" class="rhine-close-rack-index" aria-label="关闭调查资料目录">CLOSE <span>×</span></button></div><h2>档案架目录<small>Agent 已读与手动收藏</small></h2><label class="search-field"><span>⌕</span><input class="rhine-rack-filter" type="search" autocomplete="off" placeholder="筛选资料标题、来源或内容" aria-label="筛选档案架资料"/></label><label class="rhine-evidence-target"><span>证据盒归属</span><select aria-label="证据盒归属" disabled><option>正在读取调查板…</option></select></label><div class="rhine-rack-index-list"></div><div class="rhine-rack-index-count" role="status"></div></div></section>
-      <section class="rhine-report modal-backdrop" aria-label="Agent 调查报告" hidden><div class="terminal-modal rhine-report-modal"><div class="modal-top"><span>RHINE LAB / RESEARCH REPORT</span><button type="button" class="rhine-close-report" aria-label="关闭调查报告">返回调查 <span>×</span></button></div><header class="rhine-report-header"><div class="rhine-report-kicker tiny-label">RESEARCH REPORT</div><h2 class="rhine-report-title">调查报告</h2><div class="rhine-report-status" role="status"></div></header><div class="rhine-report-layout"><aside class="rhine-report-outline" aria-label="报告目录"><div class="tiny-label">CONTENTS / 目录</div><nav class="rhine-report-toc"></nav></aside><article class="rhine-report-body" tabindex="0" aria-label="Agent 回答"></article><aside class="rhine-report-references" aria-label="报告引用"><div class="rhine-report-sources"></div></aside></div><footer class="rhine-report-footer"><button type="button" class="rhine-report-rack">翻阅调查资料 <span>↗</span></button><span class="rhine-report-position"></span></footer></div></section>
+      <section class="rhine-rack-index modal-backdrop" aria-label="调查资料目录" hidden><div class="terminal-modal rhine-rack-index-modal"><div class="modal-top"><span>RHINE LAB / EVIDENCE INDEX</span><button type="button" class="rhine-close-rack-index" aria-label="关闭调查资料目录">CLOSE <span>×</span></button></div><h2>档案架目录<small>Agent 上下文资料与手动收藏</small></h2><label class="search-field"><span>⌕</span><input class="rhine-rack-filter" type="search" autocomplete="off" placeholder="筛选资料标题、来源或内容" aria-label="筛选档案架资料"/></label><label class="rhine-evidence-target"><span>证据盒归属</span><select aria-label="证据盒归属" disabled><option>正在读取调查板…</option></select></label><div class="rhine-rack-index-list"></div><div class="rhine-rack-index-count" role="status"></div></div></section>
+      <section class="rhine-report modal-backdrop" aria-label="本轮答复" hidden><div class="terminal-modal rhine-report-modal"><div class="modal-top"><span>RHINE LAB / CONVERSATION</span><button type="button" class="rhine-close-report" aria-label="关闭本轮答复">返回调查 <span>×</span></button></div><header class="rhine-report-header"><div class="rhine-report-kicker tiny-label">RESEARCH REPORT</div><h2 class="rhine-report-title">调查报告</h2><div class="rhine-report-status" role="status"></div></header><div class="rhine-report-layout"><aside class="rhine-report-outline" aria-label="报告目录"><div class="tiny-label">CONTENTS / 目录</div><nav class="rhine-report-toc"></nav></aside><article class="rhine-report-body" tabindex="0" aria-label="Agent 回答"></article><aside class="rhine-report-references" aria-label="报告引用"><div class="rhine-report-sources"></div></aside></div><footer class="rhine-report-footer"><button type="button" class="rhine-report-rack">翻阅调查资料 <span>↗</span></button><span class="rhine-report-position"></span></footer></div></section>
       <section class="rhine-session-panel modal-backdrop" role="dialog" aria-modal="true" aria-labelledby="rhine-session-heading" hidden><div class="terminal-modal rhine-session-modal"><div class="modal-top"><span>RHINE LAB / SESSION CONTROL</span><button type="button" class="rhine-close-session" aria-label="关闭对话管理">CLOSE <span>×</span></button></div><h2 id="rhine-session-heading">RESEARCH SESSIONS<small>对话与模式</small></h2><p class="rhine-session-workspace"></p><div class="rhine-session-error" role="alert" hidden><p></p><button type="button" class="rhine-session-retry">重试 ↗</button></div><div class="rhine-session-content"><section class="rhine-session-config" aria-label="对话设置"><div class="rhine-session-mode-field"><label for="rhine-mode-select">AGENT MODE <span>调查模式</span></label><div class="rhine-session-select-row"><select id="rhine-mode-select" aria-describedby="rhine-mode-description rhine-mode-hint"></select><button type="button" class="rhine-mode-apply">使用此模式</button></div><p id="rhine-mode-description"></p><p id="rhine-mode-hint"></p></div><div class="rhine-session-model-field" hidden><label for="rhine-model-select">MODEL <span>当前对话模型</span></label><div class="rhine-session-select-row"><select id="rhine-model-select"></select><button type="button" class="rhine-model-apply">切换模型</button></div></div></section><section class="rhine-session-history-section" aria-label="历史会话"><div class="rhine-session-list-heading"><span>SESSION ARCHIVE / 历史会话</span><button type="button" class="rhine-session-refresh">刷新 ↻</button></div><div class="rhine-session-list" tabindex="-1"></div></section></div><div class="rhine-session-modal-footer"><span class="rhine-session-notice" role="status"></span><button type="button" class="rhine-session-create solid-button">＋ 新建对话</button></div></div></section>
       <button type="button" class="rhine-completion-notice" aria-label="调查已完成，阅读报告" hidden><span>✓ 调查完成</span><strong>阅读调查报告</strong><b aria-hidden="true">↗</b></button><div class="rhine-completion-announcement" role="status" aria-live="polite"></div><div class="rhine-toast toast" role="status" hidden></div>
     </div>
@@ -358,18 +360,18 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
   let investigationReading: ReadingObject | null = null;
   let investigationReturn = { fullscreen: false, kind: 'report' as 'report' | 'clue' | 'inbox' };
   let evidenceTarget = 'auto';
-  let investigationContext: InvestigationContext = { sessionId: snapshot.sessionId, boards: [], selectedId: '', workingId: '', ready: false };
+  let investigationContext: InvestigationContext = { sessionId: snapshot.sessionId, boards: [], selectedId: '', workingId: '', ready: false, version:0, readOnly:false, reportAvailable:false };
   let contextSignature = '';
   let investigation: ReturnType<typeof mountInvestigationBoard> | undefined;
   const archiveRack = createArchiveRack({ api: options.api,
-    changed(value) { manualSources=value;persist();mergeSources();updateReaderSave(); }, failed: toast });
+    changed(value) { restoredSources=value;manualSources=value.filter(source=>source.saved);persist();mergeSources();updateReaderSave(); }, failed: toast });
   const boardPanel = mountEvidenceBoardPanel(stage, {
     getCardBounds: id => scene?.getBoardCardBounds(id) || null,
     managed: true,
+    isReadOnly: () => investigation?.getContext().readOnly === true,
     sessionId: snapshot.sessionId,
     onChange(cards) {
       investigation?.userChange(cards);
-      $('.rhine-board-count').textContent = String(cards.length).padStart(2, '0');
     },
     onSelect(id) { scene?.selectBoardCard(id); },
     onToolChange(tool) {
@@ -393,9 +395,9 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
   investigation = mountInvestigationBoard(stage, {
     sessionId: snapshot.sessionId, api: options.api, panel: boardPanel,
     onRackRevision(revision) { void archiveRack.refresh(revision).catch(()=>{}); },
-    onCards(cards) { scene?.setBoardCards(cards); $('.rhine-board-count').textContent = String(Math.max(0, cards.length - 1)).padStart(2, '0'); },
+    onCards(cards,total) { scene?.setBoardCards(cards); $('.rhine-board-count').textContent = String(total).padStart(2, '0'); },
     openSource(source,inbox=false) { investigation?.holdReadingContext();investigationReturn={fullscreen:boardFullscreen,kind:inbox?'inbox':investigationReading?.kind||'report'};openSource(source,'investigation'); }, notify: toast,
-    onContext(value){investigationContext=value;renderInvestigationContext();},
+    onContext(value){investigationContext=value;renderInvestigationContext();renderSavedReportEntry();},
     onInbox(value,open){if(open)boardPanel.closeTools();scene?.setEvidenceInbox(value,open);},
     askInbox:options.agentAvailable===false?undefined:async(boardId,title)=>{await options.askAgent(`请继续整理调查板「${title}」（board_id: ${boardId}）的重点证据盒。先读取这块板和 inbox，resume 同一调查；核对待整理资料，尤其是我手动选入的材料，将有依据的内容整理为线索。不要仅为清空盒子而生成线索。`);},
     onReading(value) { investigationReading=value;syncReadingObject(); },
@@ -458,6 +460,7 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
   const sourceMotion = new ReadCardMotion();
   let agentReadFocus: ReturnType<typeof latestReadFocus>;
   let followAgent = true;
+  let followPausedByUser = false;
   const unseenReads = new Set<string>();
   const observedReads = new Set<string>();
   let activityTurn = '';
@@ -734,13 +737,14 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
     updateArchiveSelection(next?.id || null, next ? archiveLane(next) : archiveLaneIndex, false);
   }
   function renderFollowMode() {
-    $('.rhine-follow-status').textContent = followAgent ? '跟随 Agent 查阅' : `手动浏览${unseenReads.size ? ` · 新查阅 ${unseenReads.size} 次` : ' · 自动跟随已暂停'}`;
+    $('.rhine-follow-status').textContent = followAgent ? '跟随 Agent 查阅' : `${followPausedByUser ? '已暂停跟随' : '手动浏览 · 下次查阅时跟随'}${unseenReads.size ? ` · 新查阅 ${unseenReads.size} 次` : ''}`;
     $('.rhine-follow-toggle').textContent = followAgent ? '暂停跟随' : '恢复跟随 ↗';
     $('.rhine-follow-toggle').setAttribute('aria-pressed', String(followAgent));
   }
-  function setFollowAgent(value: boolean) {
+  function setFollowAgent(value: boolean, explicit = false) {
+    if (explicit || value) followPausedByUser = !value;
     followAgent = value; scene?.setFollowAgent(value);
-    if (value) { unseenReads.clear(); if (agentReadFocus && !selectedSource) scene?.selectArchiveSource(agentReadFocus.source.id, false); }
+    if (value) { unseenReads.clear(); if (agentReadFocus && !selectedSource && location === 'archive') scene?.selectArchiveSource(agentReadFocus.source.id, false); }
     renderFollowMode();
   }
   function selectArchiveSource(id: string) {
@@ -833,6 +837,7 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
   }
   function storageKey() { return `prts-rhine-desk:v1:${encodeURIComponent(snapshot.sessionId || 'default')}`; }
   function loadSaved() {
+    restoredSources = [];
     manualSources = [];
     extracts = [];
     try {
@@ -898,7 +903,7 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
   const hostSessionNodes = new Map<string, HTMLButtonElement>();
   function renderHostControls() { return performancePanel.capture.measureWork('host-controls', renderHostControlsBody); }
   function renderHostControlsBody() {
-    const signature = JSON.stringify([hostState, hostActionBusy, hostActionError, extracting]);
+    const signature = JSON.stringify([hostState, hostActionBusy, hostCancelBusy, hostActionError, extracting]);
     if (signature === hostPaintSignature) return;
     hostPaintSignature = signature;
     $('.rhine-session-controls').hidden = !options.host;
@@ -974,9 +979,17 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
     for (const [id, entry] of hostSessionNodes) entry.disabled = busy || id === hostState.sessionId;
     const cancel = $<HTMLButtonElement>('.rhine-agent-cancel');
     cancel.hidden = !hostState.running;
-    cancel.disabled = busy;
+    cancel.disabled = hostCancelBusy || Boolean(hostState.cancelling);
+    cancel.textContent = cancel.disabled ? '正在停止…' : '停止';
     renderHostChoice();
   }
+  async function cancelAgent() {
+    if (!options.host || hostCancelBusy || hostState?.cancelling || !hostState?.running) return;
+    hostCancelBusy = true; renderAgentControls();
+    try { await options.host.cancel(); }
+    catch (error) { if (!disposed) toast(plainError(error)); }
+    finally { if (!disposed) { hostCancelBusy = false; hostState = options.host.getState(); renderAgentControls(); } }
+  }
   async function runHostAction(action: () => Promise<void>, closeOnSuccess = false) {
     if (!options.host || hostBlocked() || extracting) return;
     hostActionBusy = true; hostActionError = ''; hostRetry = undefined;
@@ -1027,6 +1040,23 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
     scene?.setLocation(next);
     syncMode(); renderStatus();
   }
+  function renderSavedReportEntry() {
+    const saved=investigationContext.report, completed=investigationComplete();
+    const reportEntry=$('.rhine-report-open');
+    const visible=!!saved||investigationActivity(snapshot).showReport;
+    reportEntry.hidden=!visible;$('.rhine-shelf-report').hidden=!visible;
+    reportEntry.dataset.state=completed?'complete':snapshot.running?'running':snapshot.outcome==='interrupted'||snapshot.error?'error':'returned';
+    $('.rhine-report-open strong').textContent=saved?'阅读调查报告':'阅读本轮答复';
+    if(saved){
+      $('.rhine-report-open-kicker').textContent=`SAVED REPORT / V${saved.version}`;
+      $('.rhine-report-open-meta').textContent=`${saved.title} · ${saved.clues} 条依据 · ${saved.sources} 份来源`;
+    }else{
+      const received=mergeSourcesInOrder([],currentInvestigationSources());
+      const citations=(snapshot.reportSources||received.filter(source=>source.state==='cited')).length;
+      $('.rhine-report-open-kicker').textContent=completed?'✓ 调查完成 / REPORT READY':snapshot.running?'LIVE REPORT / 正在生成':snapshot.outcome==='interrupted'?'调查已停止 / 已返回内容':'RESEARCH REPORT / 已返回回答';
+      $('.rhine-report-open-meta').textContent=`本轮查得 ${received.length} 份资料 · ${citations} 份引用${completed?' · 随时核对原文':''}`;
+    }
+  }
   function renderInvestigationContext() {
     const context=investigationContext;
     const signature=JSON.stringify([context,evidenceTarget]);
@@ -1056,7 +1086,9 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
   function mergeSourcesBody(animate: boolean) {
     uiUpdates.sourceMerges++;
     activitySources = undefined;
-    discoveredSources = mergeSourcesInOrder(discoveredSources, [...snapshot.sources || [], ...manualSources]);
+    // Snapshot sources are actual tool deliveries, also on older hosts without the flag.
+    const delivered = (snapshot.sources || []).map(source => source.agentReceived ? source : { ...source, agentReceived: true });
+    discoveredSources = mergeSourcesInOrder(discoveredSources, [...delivered, ...restoredSources, ...manualSources]);
     sources = mergeSourcesInOrder(sources, discoveredSources.filter(belongsOnShelf));
     const signature = JSON.stringify(sources);
     scene?.setInvestigation(snapshot);
@@ -1142,15 +1174,15 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
     deskPage = Math.min(deskPage, Math.max(0, Math.ceil(sources.length / SHELF_PAGE_SIZE) - 1));
     const pageSources = sources.slice(deskPage * SHELF_PAGE_SIZE, (deskPage + 1) * SHELF_PAGE_SIZE);
     const visible = query ? sources.filter(source => matchesSource(source, query)) : pageSources;
-    $('.rhine-rack-range').textContent = query ? `全部档案 · 匹配 ${visible.length} / ${sources.length} 份` : sources.length ? `本架 ${deskPage * SHELF_PAGE_SIZE + 1}–${Math.min(sources.length, (deskPage + 1) * SHELF_PAGE_SIZE)} / 共 ${sources.length} 份资料` : 'Agent 读过或手动收藏后入架';
+    $('.rhine-rack-range').textContent = query ? `全部档案 · 匹配 ${visible.length} / ${sources.length} 份` : sources.length ? `本架 ${deskPage * SHELF_PAGE_SIZE + 1}–${Math.min(sources.length, (deskPage + 1) * SHELF_PAGE_SIZE)} / 共 ${sources.length} 份资料` : '资料交付给 Agent 或手动收藏后入架';
     $('.rhine-shelf-clear').hidden = !query;
-    $('.rhine-rack-directory').firstChild!.textContent = `全部资料目录 · ${sources.length} `;
+    $('.rhine-rack-directory').firstChild!.textContent = `档案架目录 · ${sources.length} `;
     if (!pageSources.some(source => source.id === shelfSelected)) shelfSelected = pageSources[0]?.id || null;
     const focused = sources.find(source => source.id === shelfSelected);
     $('.rhine-shelf-number').textContent = focused ? `已选 S-${String(sourceNumber(focused)).padStart(3, '0')} / ${shelfSlot(sources.indexOf(focused)).level === 0 ? '下层' : '上层'}` : 'NO SOURCES YET';
     $('.rhine-shelf-title').textContent = focused?.title || '留一个位置，给下一条线索。';
     $('.rhine-shelf-meta').textContent = focused ? `${kind(focused)} / ${origin(focused)} / ${state(focused)}${focused.saved ? ' / 已收藏' : ''}` : '';
-    $('.rhine-shelf-excerpt').textContent = focused?.excerpt || (focused ? '抽取档案，查看完整原文和 Agent 实际读过的段落。' : 'Agent 实际读过或你主动收藏的资料，留在这里供回查。');
+    $('.rhine-shelf-excerpt').textContent = focused?.excerpt || (focused ? '抽取档案，查看完整原文和 Agent 实际读过的段落。' : '已交付给 Agent 的资料与手动收藏，留在这里供回查；入架不代表已读原文。');
     $<HTMLButtonElement>('.rhine-shelf-open').disabled = !focused;
     $<HTMLButtonElement>('.rhine-shelf-stage').disabled = !focused;
     for (const selector of ['.rhine-shelf-prev', '.rhine-shelf-next']) $<HTMLButtonElement>(selector).disabled = visible.length < 2;
@@ -1172,7 +1204,7 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
       slot.setAttribute('aria-pressed', String(source.id === shelfSelected));
       if (list.children[position] !== slot) list.insertBefore(slot, list.children[position] || null);
     });
-    if (!visible.length) list.append(node('p', 'rhine-empty', query ? '没有匹配的档案，试试更短的标题或清除筛选。' : 'Agent 实际读过或你主动收藏的资料，会按入架顺序显示在这里。'));
+    if (!visible.length) list.append(node('p', 'rhine-empty', query ? '没有匹配的档案，试试更短的标题或清除筛选。' : '已交付给 Agent 或你主动收藏的资料，会按入架顺序显示在这里。'));
     list.dataset.selected = shelfSelected || '';
     if (previousSelected !== list.dataset.selected && location === 'desk') {
       const chosen = shelfSelected && shelfChoiceNodes.get(shelfSelected);
@@ -1211,7 +1243,7 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
       row.querySelector('span')!.textContent = `${kind(source)} · ${origin(source)} · ${state(source)} ↗`;
       if (list.children[index] !== row) list.insertBefore(row, list.children[index] || null);
     });
-    if (!matches.length) list.append(node('p', 'rhine-empty', sources.length ? '没有匹配的资料，换一个关键词试试。' : 'Agent 已读或你手动收藏的资料，会在这里按入架顺序显示。'));
+    if (!matches.length) list.append(node('p', 'rhine-empty', sources.length ? '没有匹配的资料，换一个关键词试试。' : '已交付给 Agent 或你手动收藏的资料，会在这里按入架顺序显示。'));
     $('.rhine-rack-index-count').textContent = `显示 ${matches.length} / ${sources.length} 份资料 · 点击标题打开原文`;
   }
   function openRackIndex() {
@@ -1546,7 +1578,7 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
       basket.hidden = true;
       resultsPanel.hidden = true;
       syncModalState();
-      toast('调查已交给 Agent，候选资料进入检索阵列，Agent 读过后入架。');
+      toast('调查已交给 Agent，检索返回的资料会进入档案架。');
     } catch (error) { if (!disposed && snapshot.sessionId === submissionSession) toast(`未能开始调查：${plainError(error)}`); }
     finally { if (!disposed && snapshot.sessionId === submissionSession) { extracting = false; $<HTMLButtonElement>('.rhine-agent-submit').disabled = false; $<HTMLButtonElement>('.rhine-ask-agent').disabled = false; renderBasket(); renderStatus(); } }
   }
@@ -1677,7 +1709,7 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
       reportText = ''; reportSourceSignature = ''; reportTocSignature = '';
     }
     reportMeasure('report-header', () => {
-      reportTextContent($('.rhine-report-title'), investigationTitle() || '调查报告');
+      reportTextContent($('.rhine-report-title'), '本轮答复');
       const completed = investigationComplete();
       reportTextContent($('.rhine-report-kicker'), completed ? 'INVESTIGATION COMPLETE / 调查完成' : snapshot.running ? 'LIVE REPORT / 正在生成' : 'RESEARCH RECORD / 调查记录');
       reportTextContent($('.rhine-report-status'), snapshot.error || (snapshot.running ? '内容随回答更新。你可以先阅读，或点右侧引用核对原文。' : completed ? '本轮调查已完成 · 点击目录跳转章节，点击引用查阅原文。' : snapshot.outcome === 'interrupted' ? '本轮调查已停止 · 以下保留停止前已返回的内容。' : '已返回的回答 · 来源可在右侧逐份查阅。'));
@@ -1742,7 +1774,20 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
     if (report.hidden && (snapshot.running || !snapshot.answer || reportText === snapshot.answer && reportInvestigationKey === investigationKey())) return;
     reportRenderTimer = window.setTimeout(() => { reportRenderTimer = undefined; if (!disposed) renderReport(); }, report.hidden || snapshot.running ? 180 : 0);
   }
-  function openReport(returning = false) { return reportMeasure('report-open', () => openReportBody(returning)); }
+  async function openReport(returning = false) {
+    if (!returning && investigation) {
+      try {
+        const sessionId=snapshot.sessionId;
+        const available=await investigation.prepareReport();
+        if(disposed||snapshot.sessionId!==sessionId)return;
+        if(available){
+          reportViewedKey=investigationKey();syncCompletionNotice();
+          setLocation('board');investigation.showReport();return;
+        }
+      } catch(error) { if(!disposed)toast(plainError(error));return; }
+    }
+    return reportMeasure('report-open', () => openReportBody(returning));
+  }
   function openReportBody(returning: boolean) {
     if (!returning && document.activeElement instanceof HTMLElement && !report.contains(document.activeElement) && !readerReturn && !reader.contains(document.activeElement)) reportTrigger = document.activeElement;
     // Populate while hidden so parsing/patching cannot repeatedly flush visible report layout.
@@ -1774,14 +1819,14 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
   function syncToolActivityBody() {
     const turn = `${snapshot.sessionId}:${snapshot.investigationId || ''}`;
     if (activityTurn !== turn) {
-      activityTurn = turn; agentReadFocus = undefined;
+      activityTurn = turn;
       sourceMotion.dispose();
     }
     const next = latestReadFocus(snapshot, activitySources ??= mergeSourcesInOrder(snapshot.sources || [], archiveSources));
     const changed = Boolean(next && next.key !== agentReadFocus?.key);
     for(const operation of snapshot.operations||[]){
       if(operation.kind!=='read')continue;
-      const key=`${turn}:${operation.id}`;
+      const key=`${snapshot.sessionId}:${operation.id}`;
       if(!observedReads.has(key)&&!followAgent&&activityInitialized)unseenReads.add(key);
       observedReads.add(key);
     }
@@ -1790,6 +1835,10 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
       const operation = snapshot.operations?.find(call => call.id === agentReadFocus?.operation.id);
       if (operation) agentReadFocus = { ...agentReadFocus, operation };
     }
+    // Manual navigation only holds the card until the next resolved Agent read.
+    // An explicit pause remains sticky. The open reader is independent of this
+    // card, so its document and scroll position never change during a new read.
+    if (changed && !followAgent && !followPausedByUser) setFollowAgent(true);
     updateArchiveSelection(archiveSelected, archiveLaneIndex, false);
     renderFollowMode();
     if (followAgent && changed && next?.operation.state !== 'error' && activityInitialized && snapshot.running && active && !document.hidden && !selectedSource)
@@ -1856,13 +1905,6 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
     $('.rhine-found-count').textContent = String(received.length).padStart(2, '0');
     $('.rhine-read-count').textContent = String(reads).padStart(2, '0');
     $('.rhine-cited-count').textContent = String(citations).padStart(2, '0');
-    $('.rhine-report-open').hidden = !activity.showReport;
-    $('.rhine-shelf-report').hidden = !activity.showReport;
-    const reportEntry = $('.rhine-report-open');
-    reportEntry.dataset.state = completed ? 'complete' : snapshot.running ? 'running' : snapshot.outcome === 'interrupted' || snapshot.error ? 'error' : 'returned';
-    $('.rhine-report-open-kicker').textContent = completed ? '✓ 调查完成 / REPORT READY' : snapshot.running ? 'LIVE REPORT / 正在生成' : snapshot.outcome === 'interrupted' ? '调查已停止 / 已返回内容' : 'RESEARCH REPORT / 已返回回答';
-    $('.rhine-report-open strong').textContent = completed ? '阅读调查报告' : '查看已返回的回答';
-    $('.rhine-report-open-meta').textContent = `本轮查得 ${received.length} 份资料 · ${citations} 份引用${completed ? ' · 随时核对原文' : ''}`;
     if (completed && snapshot.answer && lastCompletedKey !== investigationKey()) {
       lastCompletedKey = investigationKey();
       if (hasRenderedStatus) {
@@ -1874,6 +1916,7 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
     }
     if (!completed) for (const selector of ['.rhine-report-open', '.rhine-completion-notice']) $(selector).classList.remove('is-new');
     hasRenderedStatus = true;
+    renderSavedReportEntry();
     syncCompletionNotice();
     $('.rhine-activity').hidden = location !== 'desk' || !running && !snapshot.error;
     $('.rhine-status-title').textContent = searching ? 'RETRIEVING ARCHIVES' : snapshot.running ? 'INVESTIGATION IN PROGRESS' : 'INVESTIGATION / PAUSED';
@@ -1942,7 +1985,7 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
     evidenceTarget=select.value;renderInvestigationContext();
   });
   $('.rhine-array-stage').addEventListener('click',()=>{const source=displayedArchiveSource;if(source)pinToBoard(source);});
-  $('.rhine-follow-toggle').addEventListener('click',()=>{setFollowAgent(!followAgent);updateArchiveSelection(archiveSelected,archiveLaneIndex,false);});
+  $('.rhine-follow-toggle').addEventListener('click',()=>{setFollowAgent(!followAgent, true);updateArchiveSelection(archiveSelected,archiveLaneIndex,false);});
   $('.rhine-shelf-stage').addEventListener('click',()=>{const source=sources.find(item=>item.id===shelfSelected);if(source)pinToBoard(source);});
   $('.rhine-shelf-open').addEventListener('click', () => { const source = sources.find(item => item.id === shelfSelected); if (source) void openSource(source); });
   $('.rhine-agent-form').addEventListener('submit', event => { event.preventDefault(); void askAgent(); });
@@ -1963,7 +2006,7 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
     }
   });
   $('.rhine-model-apply').addEventListener('click', () => { const model = modelSelect.value; if (options.host && hostState?.models.some(item => item.id === model)) void runHostAction(() => options.host!.selectModel(model)); });
-  $('.rhine-agent-cancel').addEventListener('click', () => { if (options.host && hostState?.running) void runHostAction(() => options.host!.cancel()); });
+  $('.rhine-agent-cancel').addEventListener('click', () => { void cancelAgent(); });
   modeSelect.addEventListener('change', renderHostChoice);
   modelSelect.addEventListener('change', renderHostChoice);
   $('.rhine-nav-close').addEventListener('click', options.close);
@@ -2058,7 +2101,6 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
   syncMode();
   stage.classList.toggle('reduce-motion', reducedMotion.matches);
   root.dataset.location = location;
-  const initialCatalogue = search(false, false);
 
   // Keep the moment loading began as the history baseline. Fast reads that
   // finish while the GLB loads are new activity, not historical playback.
@@ -2086,6 +2128,7 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
     onLocationRequest: next => { setFollowAgent(false); setLocation(next); },
     onInboxOpen:()=>investigation?.openInbox(),
     onBoardSelect: (id, openEditor) => { if (!disposed) investigation?.select(id, openEditor); },
+    isBoardReadOnly: () => investigation?.getContext().readOnly === true,
     onBoardMove: (id, x, y) => { if (!disposed) boardPanel.moveCard(id, x, y); },
     onBoardResize: (id, scale, x, y) => { if (!disposed) boardPanel.resizeCard(id, scale, x, y); },
     onBoardAnchors: frame => { if (!disposed) { boardFrame = frame; investigation?.setBoardFrame(frame); syncBoardToolbar(); } },
@@ -2100,7 +2143,6 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
     if (!value) return;
     if (disposed || sceneStartupCancelled) { value.dispose(); return; }
     scene = value;
-    await initialCatalogue;
     if (disposed || sceneStartupCancelled) return;
     $('.rhine-loader-message').textContent = '正在准备模型与画面…';
     scene.setFollowAgent(followAgent);
@@ -2151,6 +2193,7 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
       const changedSession = changes.sessionChanged;
       snapshot = next;
       if (changedSession) {
+        agentReadFocus = undefined; activityInitialized = false; activityTurn = '';
         setBoardFullscreen(false);
         evidenceTarget='auto';contextSignature='';
         boardPanel.closeTools();
@@ -2168,7 +2211,7 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
         setArrayListExpanded(false, true);
         results = []; resultsPage = 0; deskPage = 0; searchCursor = undefined; searchDataVersion = undefined;
         sources = []; discoveredSources = []; archiveSources = []; archiveSelected = null; shelfSelected = null;
-        followAgent = true; unseenReads.clear(); observedReads.clear(); scene?.setFollowAgent(true);
+        followAgent = true; followPausedByUser = false; unseenReads.clear(); observedReads.clear(); scene?.setFollowAgent(true);
         archiveLaneIndex = 0; columnMemory.fill(null); catalogueLoaded = false;
         sourceSignature = ''; input.value = ''; agentInput.value = ''; extracting = false;
         readerBody.replaceChildren(); $('.rhine-reader-title').textContent = '';
@@ -2188,7 +2231,6 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
         searchQuery = ''; searchError = ''; searchWarning = ''; manualSearch.resetMode(); searchMode = 'local';
         scene?.setInvestigation(snapshot); scene?.setSources([], false); scene?.setArchiveSources([]);
         setLocation('archive'); updateArchiveSelection(null, 0, false); renderDesk();
-        void search(false, false);
         visibleRecordCount = 20; recordNodes.clear(); $('.rhine-log-records').replaceChildren();
         logSourcesSignature = logRecordsSignature = ''; activitySources = undefined;
         loadSaved(); renderBasket();
@@ -2204,7 +2246,7 @@ export function mountRhineWorkbench(host: HTMLElement, options: RhineOptions): R
       } finally { finishWork?.(); }
     },
     setActive(next: boolean) { active = next; if (!next) { cancelAnimationFrame(readerPositionFrame); readerPositionFrame = 0; } edgeNavigation?.sync(); performancePanel.setActive(next); scene?.setActive(next && !viewer?.isOpen); root.hidden = !next; if (next) { scheduleReportPosition(); scheduleReaderPosition(); } else { cancelAnimationFrame(reportPositionFrame); reportPositionFrame = 0; } if (next && viewer?.isOpen && !viewerFrame) viewerFrame = requestAnimationFrame(renderViewer); else if (!next) { cancelAnimationFrame(viewerFrame); viewerFrame = 0; } },
-    stats() { return { uiUpdates: { ...uiUpdates }, hostBridge: options.host?.performanceStats?.() ?? null, snapshotBridge: options.snapshotDiagnostics?.performanceStats?.() ?? null, ...scene?.stats(), board: boardPanel.stats(), investigations: investigation?.stats(), boardFullscreen, navigation: navigationLimiter.stats(), quality: { ...quality }, sourceCount: sources.length, candidateCount: archiveSources.length, followAgent, unseenReads: unseenReads.size, displayedSourceId: displayedArchiveSource?.id, manualSourceCount: manualSources.length, extractCount: extracts.length, location, readerOpen: !reader.hidden, searchBusy, resultCount: results.length, reportOpen: !report.hidden, shelfSelected, deskPage, viewerOpen: Boolean(viewer?.isOpen), archiveIndex: archiveSelected }; },
+    stats() { return { uiUpdates: { ...uiUpdates }, hostBridge: options.host?.performanceStats?.() ?? null, snapshotBridge: options.snapshotDiagnostics?.performanceStats?.() ?? null, ...scene?.stats(), board: boardPanel.stats(), investigations: investigation?.stats(), boardFullscreen, navigation: navigationLimiter.stats(), quality: { ...quality }, sourceCount: sources.length, candidateCount: archiveSources.length, followAgent, followPausedByUser, unseenReads: unseenReads.size, displayedSourceId: displayedArchiveSource?.id, manualSourceCount: manualSources.length, extractCount: extracts.length, location, readerOpen: !reader.hidden, searchBusy, resultCount: results.length, reportOpen: !report.hidden, shelfSelected, deskPage, viewerOpen: Boolean(viewer?.isOpen), archiveIndex: archiveSelected }; },
     dispose() {
       manualSearch.dispose();
       if (disposed) return;