Merge remote-tracking branch 'origin/master' into ji

# Conflicts: # offline-backend-20260512/backend/app/gateway/app.py
2026-09-09 10:00:24 +08:00
commit 67d12929fc
@@ -17,6 +17,9 @@ VITE_MOCK_COP_TASK_DETAIL=true
 VITE_BACKEND_BASE_URL=http://127.0.0.1:8001
 VITE_LANGGRAPH_BASE_URL=http://127.0.0.1:8001/api

+# 开发环境普通登录后进入 Vite 内隔离的官方风格页面；/page/* 仍访问当前定制版。
+VITE_USE_OFFICIAL_DEERFLOW_ENTRY=true
+
 # 轻应用「新建笔记」系列接口
 VITE_NOTE_API_BASE_URL=http://47.88.25.99:8000
 # CMZS后端接口
@@ -60,3 +60,9 @@
 # 不填或留空时按类型 A，继续使用原来的简介菜单数据。
 # VITE_COMPACT_MENU_TYPE=A
 # VITE_GITHUB_OAUTH_TOKEN=
+
+# --- 官方 DeerFlow 风格页面入口（仅 Vite，不引入 Next.js）---
+# true 时，普通登录后进入同一 Vite 应用中隔离的 /official/*。
+# 已指定 redirect 或 taskId/goPath 的登录仍保持原来的优先级。
+# 仅 .env.development 默认 true；其余环境保持 false。
+# VITE_USE_OFFICIAL_DEERFLOW_ENTRY=false
@@ -17,6 +17,9 @@ VITE_MOCK_COP_TASK_DETAIL=false
 VITE_BACKEND_BASE_URL=http://10.19.200.5:2026
 VITE_LANGGRAPH_BASE_URL=http://10.19.200.5:2026/api

+# 内网环境保持当前定制版默认入口。
+VITE_USE_OFFICIAL_DEERFLOW_ENTRY=false
+
 # 轻应用「新建笔记」系列接口
 VITE_NOTE_API_BASE_URL=http://47.88.25.99:8000
 # CMZS后端接口
@@ -14,6 +14,9 @@ VITE_MOCK_SQ_REPORT=false
 VITE_BACKEND_BASE_URL=https://ch1.b.uat.4.cn/deerflow
 VITE_LANGGRAPH_BASE_URL=https://ch1.b.uat.4.cn/deerflow/api

+# 线上保持当前定制版默认入口。
+VITE_USE_OFFICIAL_DEERFLOW_ENTRY=false
+
 # 轻应用「新建笔记」系列接口
 VITE_NOTE_API_BASE_URL=https://your-intranet-host/note-api
 # CMZS后端接口
@@ -17,6 +17,9 @@ VITE_MOCK_COP_TASK_DETAIL=false
 VITE_BACKEND_BASE_URL=https://ch1.b.sit.4.cn/deerflow
 VITE_LANGGRAPH_BASE_URL=https://ch1.b.sit.4.cn/deerflow/api

+# SIT 环境保持当前定制版默认入口。
+VITE_USE_OFFICIAL_DEERFLOW_ENTRY=false
+
 # 轻应用「新建笔记」系列接口
 VITE_NOTE_API_BASE_URL=https://your-intranet-host/note-api
 # CMZS后端接口
@@ -11,6 +11,7 @@
    "build:network": "node --max-old-space-size=8192 ./node_modules/vite/bin/vite.js build --mode network",
    "preview": "vite preview",
    "typecheck": "tsc --noEmit",
+    "test:report-collaboration": "npx esbuild src/report-collaboration/tests/event-reducer.test.ts --bundle --platform=node --format=esm --outfile=.runtime/unit-tests/event-reducer.test.mjs && npx esbuild src/report-collaboration/tests/message-adapter.test.ts --bundle --platform=node --format=esm --outfile=.runtime/unit-tests/message-adapter.test.mjs && node --test .runtime/unit-tests/event-reducer.test.mjs .runtime/unit-tests/message-adapter.test.mjs",
    "check:chrome109-css": "node scripts/check-chrome109-css.mjs",
    "check:legacy-chrome-css": "node scripts/check-chrome109-css.mjs"
  },
@@ -45,6 +45,7 @@ import {
 } from "@/position-roundtable/demo/position-roundtable-demo-config";
 import { ChatRuntime } from "./pages/WorkspaceRoutes";
 import { NotFoundPage } from "./pages/NotFoundPage";
+import OfficialDeerFlowEntry from "./pages/OfficialDeerFlowEntry";

 const PUBLIC_EMBED_PREFIXES = [
  "/share/",
@@ -203,6 +204,7 @@ export function App() {
            path="/roundtable-dashboard"
            element={<DashboardStandalonePage />}
          />
+          <Route path="/official/*" element={<OfficialDeerFlowEntry />} />
          <Route path="/page/*" element={pageElement} />
          <Route path="*" element={<NotFoundPage />} />
        </Routes>
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="2064"
+  height="2591" viewBox="0 0 2064 2591">
+  <path fill-rule="nonzero"
+    d="M 68.582031 0 C 66.890625 0 65.300781 1 64.617188 2.640625 C 49.46875 38.800781 33.71875 76.199219 33.628906 106.539062 C 33.550781 134.230469 46.445312 155.730469 59.949219 175.71875 L 59.949219 175.730469 C 52.414062 175.671875 44.992188 175.371094 37.472656 174.171875 C 27.210938 172.53125 16.585938 169.199219 5.585938 165.738281 C 5.15625 165.609375 4.722656 165.539062 4.296875 165.539062 C 2.824219 165.539062 1.417969 166.300781 0.625 167.609375 C -0.402344 169.300781 -0.140625 171.46875 1.257812 172.871094 L 1.261719 172.878906 C 11.230469 182.871094 21.8125 193.53125 36.980469 200.050781 C 51.5625 206.320312 70.167969 208.628906 88.085938 210.78125 L 88.027344 210.78125 C 127.152344 253.410156 166.617188 296.300781 215.761719 334.941406 C 230.558594 346.578125 246.292969 357.878906 261.785156 369 C 277.171875 380.050781 292.441406 391.011719 306.660156 402.191406 C 326.132812 417.511719 343.5625 433.179688 356.773438 450.019531 C 377.808594 476.828125 388.449219 506.960938 395.4375 538.628906 L 395.4375 538.640625 C 372.683594 510.710938 349.328125 483.929688 324.855469 469.339844 C 295.957031 452.121094 265.800781 452 236.960938 451.808594 L 236.933594 451.820312 C 235.792969 451.808594 234.707031 452.261719 233.898438 453.070312 C 233.085938 453.871094 232.632812 454.96875 232.636719 456.121094 C 232.722656 494.011719 232.699219 533.539062 256.304688 567.480469 C 279.351562 600.621094 324.738281 628.019531 369.191406 654.679688 L 369.132812 654.691406 C 371.476562 683.539062 373.40625 710.691406 367.109375 728.03125 C 365.828125 731.558594 364.191406 734.71875 362.058594 738.820312 C 358.910156 744.871094 354.964844 752.441406 350.417969 764.960938 C 342.890625 785.699219 333.769531 819.839844 323.648438 883.109375 C 303.347656 1010.019531 278.722656 1255.949219 308.882812 1409.269531 C 326.265625 1497.660156 361.828125 1555.210938 393.511719 1606.519531 C 417.042969 1644.632812 438.207031 1678.960938 448.835938 1720.09375 C 466.921875 1790.089844 454.648438 1880.246094 444.5 1954.386719 C 440.613281 1982.78125 437.042969 2008.839844 435.726562 2030.261719 C 433.410156 2067.929688 438.066406 2091.179688 442.304688 2112.347656 L 442.304688 2112.355469 C 445.910156 2130.347656 449.152344 2146.589844 447.757812 2169.28125 C 447.429688 2174.613281 446.835938 2180.359375 445.933594 2186.535156 L 445.933594 2186.542969 C 436.582031 2250.328125 393.613281 2362.808594 362.105469 2416.636719 C 339.761719 2454.804688 323.546875 2462.851562 309.597656 2469.925781 C 303.980469 2472.777344 298.261719 2475.660156 292.691406 2480.238281 C 273.378906 2496.113281 256.457031 2532.078125 240.183594 2566.417969 C 239.578125 2567.703125 239.640625 2569.203125 240.363281 2570.429688 C 241.082031 2571.65625 242.359375 2572.449219 243.777344 2572.542969 L 243.789062 2572.542969 L 243.882812 2572.550781 L 243.882812 2572.554688 C 261.582031 2573.746094 279.460938 2574.957031 296.386719 2574.957031 C 323.671875 2574.957031 349.332031 2571.84375 368.355469 2559.785156 C 392.640625 2544.394531 405.109375 2514.960938 414.488281 2493.074219 C 417.011719 2487.183594 419.289062 2481.871094 421.546875 2477.308594 C 432.054688 2456.039062 441.753906 2451.664062 451.855469 2446.960938 C 453.054688 2446.402344 453.929688 2445.320312 454.226562 2444.042969 L 454.238281 2443.996094 L 454.238281 2443.988281 C 476.210938 2348.800781 498.035156 2254.347656 524.300781 2196.363281 L 524.300781 2196.367188 C 536.363281 2169.730469 549.363281 2150.796875 562.695312 2131.402344 C 576.28125 2111.625 590.1875 2091.402344 603.300781 2062.445312 L 603.304688 2062.453125 C 605.183594 2058.292969 607.054688 2053.949219 608.894531 2049.421875 C 625.066406 2009.675781 639.746094 1954.289062 653.585938 1902.101562 C 663.0625 1866.367188 672.15625 1832.09375 681.085938 1805.085938 C 699.308594 1749.992188 716.863281 1725.09375 734.371094 1705.144531 L 734.421875 1705.148438 C 727.285156 1740.746094 721.597656 1776.628906 729.320312 1807.472656 C 733.351562 1823.570312 740.996094 1838.160156 749.066406 1853.613281 C 758.828125 1872.296875 769.433594 1892.636719 776.359375 1919.675781 C 783.289062 1946.71875 786.574219 1980.605469 789.527344 2011.140625 L 789.527344 2011.148438 C 791.875 2035.402344 794.023438 2057.78125 797.746094 2072.316406 L 797.746094 2072.320312 C 797.929688 2073.023438 798.128906 2073.769531 798.316406 2074.441406 L 798.320312 2074.441406 C 802.132812 2087.941406 807.617188 2093.914062 813.515625 2100.324219 C 821.132812 2108.597656 830.351562 2118.441406 839.742188 2151.671875 L 839.738281 2151.675781 C 840.105469 2152.96875 840.402344 2154.039062 840.765625 2155.398438 C 857.484375 2217.601562 874.097656 2354.589844 872.078125 2423.390625 C 870.472656 2478.15625 857.140625 2488.390625 845.339844 2498.136719 C 842.320312 2500.632812 839.085938 2503.296875 836.09375 2506.566406 C 820.847656 2523.230469 812.652344 2554.886719 804.800781 2584.753906 C 804.457031 2586.0625 804.75 2587.453125 805.589844 2588.515625 C 806.40625 Line truncated
+</svg>
@@ -3,6 +3,7 @@
 import { ChevronRightIcon } from "lucide-react";
 import Link from "next/link";

+import deerMaskUrl from "@/assets/deer.svg";
 import { Button } from "@/components/ui/button";
 import { FlickeringGrid } from "@/components/ui/flickering-grid";
 import Galaxy from "@/components/ui/galaxy";
@@ -29,7 +30,11 @@ export function Hero({ className }: { className?: string }) {
        />
      </div>
      <FlickeringGrid
-        className="absolute inset-0 z-0 translate-y-8 mask-[url(/images/deer.svg)] mask-size-[100vw] mask-center mask-no-repeat md:mask-size-[72vh]"
+        className="absolute inset-0 z-0 translate-y-8 mask-size-[100vw] mask-center mask-no-repeat md:mask-size-[72vh]"
+        style={{
+          WebkitMaskImage: `url("${deerMaskUrl}")`,
+          maskImage: `url("${deerMaskUrl}")`,
+        }}
        squareSize={4}
        gridGap={4}
        color={"white"}
@@ -56,7 +56,7 @@ type PageSidebarProps = {
  headerHidden?: boolean;
 };

-type SettingsSection = "account" | "appearance" | "memory" | "tools" | "about";
+type SettingsSection = "account" | "appearance" | "memory" | "tools" | "encoder" | "about";

 const hasActiveChild = (item: MenuItem, pathname: string): boolean =>
  menuItemContainsPath(item, pathname);
@@ -270,6 +270,12 @@ function SecondaryNavSidebar({ headerHidden }: { headerHidden: boolean }) {
                      模型配置
                    </DropdownMenuItem>
                  )}
+                  {isAdmin && (
+                    <DropdownMenuItem onClick={() => openSettings("encoder")}>
+                      <Cpu className="size-4" />
+                      本地编码器
+                    </DropdownMenuItem>
+                  )}
                  {isAdmin && (
                    <DropdownMenuItem
                      onClick={() => navigate("/page/strategy/settings/model-concurrency")}
@@ -585,6 +591,12 @@ function LegacyAccordionSidebar({
                  模型配置
                </DropdownMenuItem>
              )}
+              {isAdmin && (
+                <DropdownMenuItem onClick={() => openSettings("encoder")}>
+                  <Cpu className="size-4" />
+                  本地编码器
+                </DropdownMenuItem>
+              )}
              {isAdmin && (
                <DropdownMenuItem onClick={() => navigate("/page/strategy/admin/login-whitelist")}>
                  <ShieldCheck className="size-4" />
@@ -223,22 +223,19 @@ const LAYOUT_OPTIONS = [
 * 界面模式（全量 / 简洁）下拉切换。换肤旁并排，图标 + 下拉：
 *   - 简洁模式 ChatPage 顶栏（全局顶栏被隐藏）。
 *   - 全量模式 Header 右上角。
- * 用户未显式设置过界面模式时（mode === undefined），当前态按调用方所在的实际界面
- * 兜底——`fallback` 指明这一回退值（Header 传 "full"，ChatPage 传 "compact"）。
+ * 当前态为有效界面模式（用户自选 > 管理员系统默认 > 内置简洁默认）——
+ * useLayoutMode 总会返回具体值，不再有 undefined 兜底。
 */
 export function LayoutModeSwitcher({
  tone,
-  fallback = "compact",
  navigateTo = "/page/workspace/chats/new",
 }: {
  tone: AppearanceControlTone;
-  fallback?: "full" | "compact";
  navigateTo?: string | null;
 }) {
  const [mode, setLayoutMode] = useLayoutMode();
  const navigate = useNavigate();
-  const current = mode ?? fallback;
-  const TriggerIcon = current === "full" ? PanelLeftIcon : LayoutIcon;
+  const TriggerIcon = mode === "full" ? PanelLeftIcon : LayoutIcon;

  if (env.FORCE_COLLAPSED_SIDEBAR || isHideChromeActive()) return null;

@@ -262,7 +259,7 @@ export function LayoutModeSwitcher({
        <DropdownMenuSeparator />
        {LAYOUT_OPTIONS.map((option) => {
          const Icon = option.icon;
-          const active = current === option.id;
+          const active = mode === option.id;
          return (
            <DropdownMenuItem
              key={option.id}
@@ -85,7 +85,7 @@ import {
 import { isArtifactApiPath } from "@/core/artifacts/streaming-write-preview";
 import { useI18n } from "@/core/i18n/hooks";
 import { downloadMarkdownAsDocx } from "@/core/scheduled-tasks/markdown-docx";
-import { streamdownPlugins } from "@/core/streamdown";
+import { streamdownPlugins, useStreamdownMermaidPngDownload } from "@/core/streamdown";
 import {
  checkCodeFile,
  getFileName,
@@ -93,6 +93,7 @@ import {
 } from "@/core/utils/files";
 import {
  downloadMermaidSvgFile,
+  downloadSvgElementAsPng,
  isMermaidFile,
  openMermaidSvgInNewTab,
  renderMermaidToSvg,
@@ -428,15 +429,15 @@ export function ArtifactFileDetail({
    if (streamPerfEnabled && isLiveStreaming) return raw;
    return desensitize(raw);
  }, [disableDesensitize, displayContent, isLiveStreaming, streamPerfEnabled]);
-  const artifactContentPending =
-    isCodeFile &&
-    !useWriteFileStreaming &&
-    content === undefined &&
-    isArtifactContentLoading;
-  // `write_file` 的 path 会先于正文抵达。它仍是正常的流式过程，不能显示成一块
-  // 空白编辑器，更不能误导用户去点击重试真实文件；下一帧内容到达后会自然切换为代码视图。
-  const streamingWriteContentPending =
-    useWriteFileStreaming && writeFileInFlight && !content;
+  const artifactContentPending =
+    isCodeFile &&
+    !useWriteFileStreaming &&
+    content === undefined &&
+    isArtifactContentLoading;
+  // `write_file` 的 path 会先于正文抵达。它仍是正常的流式过程，不能显示成一块
+  // 空白编辑器，更不能误导用户去点击重试真实文件；下一帧内容到达后会自然切换为代码视图。
+  const streamingWriteContentPending =
+    useWriteFileStreaming && writeFileInFlight && !content;
  const artifactContentUnavailable =
    isCodeFile &&
    !useWriteFileStreaming &&
@@ -1770,10 +1771,10 @@ export function ArtifactFileDetail({
                activeCursor={isApplyingEdit}
              />
            )}
-        {(artifactContentPending || streamingWriteContentPending) && viewMode === "code" && (
-          <div className="text-muted-foreground flex size-full flex-col items-center justify-center gap-3 text-sm">
-            <LoaderIcon aria-hidden="true" className="size-5 animate-spin" />
-            {streamingWriteContentPending ? "正在接收文件内容…" : "正在加载文档内容…"}
+        {(artifactContentPending || streamingWriteContentPending) && viewMode === "code" && (
+          <div className="text-muted-foreground flex size-full flex-col items-center justify-center gap-3 text-sm">
+            <LoaderIcon aria-hidden="true" className="size-5 animate-spin" />
+            {streamingWriteContentPending ? "正在接收文件内容…" : "正在加载文档内容…"}
          </div>
        )}
        {artifactContentUnavailable && viewMode === "code" && (
@@ -1791,7 +1792,7 @@ export function ArtifactFileDetail({
            </button>
          </div>
        )}
-        {isCodeFile && viewMode === "code" && !artifactContentPending && !streamingWriteContentPending && !artifactContentUnavailable && (
+        {isCodeFile && viewMode === "code" && !artifactContentPending && !streamingWriteContentPending && !artifactContentUnavailable && (
          <div className="size-full">
            <CodeEditor
              className="size-full resize-none rounded-none border-none bg-transparent"
@@ -2011,6 +2012,9 @@ export function ArtifactFilePreview({
  const [htmlPreviewUrl, setHtmlPreviewUrl] = useState<string>();
  const [mermaidSvg, setMermaidSvg] = useState<string | null>(null);
  const [mermaidError, setMermaidError] = useState<string | null>(null);
+  const markdownPreviewRef = useRef<HTMLDivElement>(null);
+  const mermaidChartRef = useRef<HTMLDivElement>(null);
+  useStreamdownMermaidPngDownload(markdownPreviewRef);
  const researchSourcesQuery = useResearchSources(
    language === "markdown" ? (researchSessionId ?? null) : null,
  );
@@ -2135,6 +2139,7 @@ export function ArtifactFilePreview({
  if (language === "markdown") {
    return (
      <div
+        ref={markdownPreviewRef}
        data-artifact-preview-scroll
        data-markdown-anchor-root
        className={cn(
@@ -2199,10 +2204,42 @@ export function ArtifactFilePreview({
        )}
      >
        {mermaidSvg ? (
-          <div
-            className="mx-auto flex min-h-full items-start justify-center rounded-2xl border border-slate-200 bg-white p-4 shadow-sm"
-            dangerouslySetInnerHTML={{ __html: mermaidSvg }}
-          />
+          <div className="relative mx-auto flex min-h-full items-start justify-center rounded-2xl border border-slate-200 bg-white p-4 pt-12 shadow-sm">
+            <div className="absolute right-3 top-3 flex items-center gap-1">
+              <button
+                type="button"
+                className="text-muted-foreground hover:text-foreground rounded-md p-1"
+                title="下载图片"
+                onClick={() => {
+                  const svg = mermaidChartRef.current?.querySelector("svg");
+                  if (!(svg instanceof SVGSVGElement)) {
+                    toast.error("流程图尚未渲染完成，请稍后再下载");
+                    return;
+                  }
+                  void downloadSvgElementAsPng(svg, "flowchart.png").catch((error) => {
+                    console.error("Failed to download mermaid image:", error);
+                    toast.error(error instanceof Error ? error.message : "下载流程图失败");
+                  });
+                }}
+              >
+                <DownloadIcon className="size-3.5" />
+              </button>
+              <button
+                type="button"
+                className="text-muted-foreground hover:text-foreground rounded-md p-1"
+                title="新窗口打开"
+                onClick={() => {
+                  void openMermaidSvgInNewTab(content ?? "").catch((error) => {
+                    console.error("Failed to open mermaid preview:", error);
+                    toast.error(error instanceof Error ? error.message : "打开流程图失败");
+                  });
+                }}
+              >
+                <ExternalLinkIcon className="size-3.5" />
+              </button>
+            </div>
+            <div ref={mermaidChartRef} dangerouslySetInnerHTML={{ __html: mermaidSvg }} />
+          </div>
        ) : mermaidError ? (
          <div className="space-y-3">
            <div className="rounded-xl border border-rose-200 bg-rose-50 px-4 py-3 text-sm text-rose-700">
@@ -25,7 +25,6 @@ import { getBackendBaseURL } from "@/core/config";
 import { isThreadRagModeLocked, useLocalSettings } from "@/core/settings";
 import { useCitationDisplaySettings } from "@/core/system-settings/hooks";
 import { isSingleRoundRagMessage } from "@/core/threads/use-single-round-rag";
-import { isMultiRoundRagMessage } from "@/core/threads/use-multi-round-rag";
 import { useSkills } from "@/core/skills/hooks";
 import type { SkillDisplayConfig } from "@/core/skills/type";
 import {
@@ -130,9 +129,8 @@ const ChatBox: React.FC<{
  // batches through DeerFlow's backend APIs.
  const hasFrontendRag = useMemo(
    () =>
-      (thread.values.messages ?? []).some(
-        (message) =>
-          isSingleRoundRagMessage(message) || isMultiRoundRagMessage(message),
+      (thread.values.messages ?? []).some((message) =>
+        isSingleRoundRagMessage(message),
      ),
    [thread.values.messages],
  );
@@ -1007,8 +1005,7 @@ function buildTurnReferenceBatches(
    // GeneralQA's single-RAG stream sends `docs` before the answer.  Make
    // those cards available immediately, while keeping normal streaming turns
    // on their existing "wait for an answer" behavior.
-    const isFrontendRagTurn =
-      isSingleRoundRagMessage(assistant) || isMultiRoundRagMessage(assistant);
+    const isFrontendRagTurn = isSingleRoundRagMessage(assistant);
    if (nextHumanIndex === -1 && isLoading && !isFrontendRagTurn) {
      continue;
    }
@@ -1059,7 +1056,7 @@ function findFrontendRagAssistant(
    const message = messages[index];
    if (
      message?.type === "ai" &&
-      (isSingleRoundRagMessage(message) || isMultiRoundRagMessage(message))
+      isSingleRoundRagMessage(message)
    ) {
      return message;
    }
@@ -6,13 +6,22 @@ import { toast } from "sonner";
 import { Button } from "@/components/ui/button";
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select";
 import { getStoredAuth } from "@/core/auth";
+import { useLlmWikiRuntime } from "@/strategy-components/api/llmwiki";
 import {
  loadKnowledgeBaseProductVersion,
+  loadOrdinaryKnowledgeLanding,
+  saveOrdinaryKnowledgeLanding,
+  type OrdinaryKnowledgeLanding,
  type KnowledgeBaseProductVersion,
  updateKnowledgeBaseProductVersion,
 } from "@/core/system-settings/api";

 export const KNOWLEDGE_PRODUCT_KEY = ["system-settings", "knowledge-base-product-version"] as const;
+const LANDING_KEY = ["system-settings", "ordinary-knowledge-landing"] as const;
+
+export function useOrdinaryKnowledgeLanding() {
+  return useQuery({ queryKey: LANDING_KEY, queryFn: loadOrdinaryKnowledgeLanding, staleTime: 0 });
+}
 export const KNOWLEDGE_NORMAL_VIEW_VALUE = "normal";
 export const KNOWLEDGE_NORMAL_VIEW_SEARCH = `?view=${KNOWLEDGE_NORMAL_VIEW_VALUE}`;

@@ -25,6 +34,14 @@ export function KnowledgeProductNav() {
  const navigate = useNavigate();
  const client = useQueryClient();
  const version = useKnowledgeBaseProductVersion();
+  const landing = useOrdinaryKnowledgeLanding();
+  const saveLanding = useMutation({
+    mutationFn: saveOrdinaryKnowledgeLanding,
+    onSuccess: (mode) => { client.setQueryData(LANDING_KEY, mode); toast.success("普通知识库默认页面已更新"); },
+    onError: (error) => toast.error(error.message),
+  });
+  const runtime = useLlmWikiRuntime();
+  const normalAvailable = runtime.data?.provider === "weknora" && Boolean(runtime.data.api_base_url?.trim());
  const isAdmin = getStoredAuth()?.system_role === "admin";
  const save = useMutation({
    mutationFn: updateKnowledgeBaseProductVersion,
@@ -36,15 +53,20 @@ export function KnowledgeProductNav() {
  const assistant = location.pathname.includes("/knowledge/assistant");

  return (
-    <div className="flex items-center gap-2 border-b bg-card px-6 py-2">
-      <Button size="sm" variant={assistant ? "ghost" : "secondary"} onClick={() => navigate(`/page/workspace/knowledge${KNOWLEDGE_NORMAL_VIEW_SEARCH}`)}>
+    <div className="flex flex-wrap items-center gap-2 border-b bg-card px-6 py-2">
+      <Button size="sm" disabled={!normalAvailable} title={normalAvailable ? "普通知识库" : "管理员配置知识服务地址后可用"} variant={assistant ? "ghost" : "secondary"} onClick={() => navigate(`/page/workspace/knowledge${KNOWLEDGE_NORMAL_VIEW_SEARCH}`)}>
        <BookOpen />普通知识库
      </Button>
      <Button size="sm" variant={assistant ? "secondary" : "ghost"} onClick={() => navigate("/page/workspace/knowledge/assistant")}>
        <Database />助手知识库
      </Button>
      {isAdmin && (
-        <div className="ml-auto flex items-center gap-2 text-xs text-muted-foreground">
+        <div className="ml-auto flex flex-wrap items-center gap-2 text-xs text-muted-foreground">
+          普通知识库默认页面
+          <Select disabled={landing.isLoading || saveLanding.isPending} value={landing.data ?? "wiki"} onValueChange={(value) => saveLanding.mutate(value as OrdinaryKnowledgeLanding)}>
+            <SelectTrigger className="h-8 w-40" aria-label="普通知识库默认页面"><SelectValue /></SelectTrigger>
+            <SelectContent><SelectItem value="wiki">本系统 Wiki 索引</SelectItem><SelectItem value="weknora">知识库管理页面</SelectItem></SelectContent>
+          </Select>
          默认产品版本
          <Select value={version.data ?? "v1"} onValueChange={(value) => save.mutate(value as KnowledgeBaseProductVersion)}>
            <SelectTrigger className="h-8 w-40"><SelectValue /></SelectTrigger>
@@ -1,6 +1,6 @@
 "use client";

-import { useMemo } from "react";
+import { useMemo, useRef } from "react";
 import type {
  AnchorHTMLAttributes,
  HTMLAttributes,
@@ -12,7 +12,7 @@ import {
  MessageResponse,
  type MessageResponseProps,
 } from "@/components/ai-elements/message";
-import { streamdownPlugins } from "@/core/streamdown";
+import { streamdownPlugins, useStreamdownMermaidPngDownload } from "@/core/streamdown";
 import {
  createMarkdownAnchorResolver,
  isInPageAnchor,
@@ -57,7 +57,9 @@ export function MarkdownContent({
  linkClassName,
  onLinkClick,
 }: MarkdownContentProps) {
+  const rootRef = useRef<HTMLDivElement>(null);
  const anchorResolver = useMemo(() => createMarkdownAnchorResolver(content), [content]);
+  useStreamdownMermaidPngDownload(rootRef);
  const components = useMemo(() => {
    const heading = (level: 1 | 2 | 3 | 4 | 5 | 6) => {
      const Tag = `h${level}` as const;
@@ -138,7 +140,7 @@ export function MarkdownContent({
  if (!content) return null;

  return (
-    <div data-markdown-anchor-root className="contents">
+    <div ref={rootRef} data-markdown-anchor-root className="contents">
      <MessageResponse
        className={className}
        remarkPlugins={remarkPlugins}
@@ -7,8 +7,6 @@ import {
  FileIcon,
  Loader2Icon,
  PencilIcon,
-  SearchIcon,
-  SparklesIcon,
 } from 'lucide-react';
 import {
  memo,
@@ -77,7 +75,6 @@ import { humanMessagePlugins } from '@/core/streamdown';
 import {
  getMultiRoundRagTrace,
  isMultiRoundRagMessage,
-  type MultiRoundRagRound,
 } from '@/core/threads/use-multi-round-rag';
 import { cn } from '@/lib/utils';

@@ -90,6 +87,7 @@ import { DeleteMessageButton } from './delete-message-button';
 import { DownloadWordButton } from './download-word-button';
 import { MarkdownContent, type MarkdownContentProps } from './markdown-content';
 import { MessageTokenUsage } from './message-token-usage';
+import { MultiRoundRagAssistantBody } from './multi-round-rag-message-list';

 type EmbeddedPageContext = {
  title?: string;
@@ -159,9 +157,9 @@ export function MessageListItem({
  className,
  fitRowToContent = false,
  anchorId,
-  message,
-  questionMarkdown,
-  isLoading,
+  message,
+  questionMarkdown,
+  isLoading,
  threadId,
  tokenUsageEnabled = false,
  displaySources = [],
@@ -178,9 +176,9 @@ export function MessageListItem({
   * message. `scroll-mt` keeps the target clear of the overlay header.
   */
  anchorId?: string;
-  message: Message;
-  /** Nearest preceding user question, used by the current-Q&A Word export. */
-  questionMarkdown?: string;
+  message: Message;
+  /** Nearest preceding user question, used by the current-Q&A Word export. */
+  questionMarkdown?: string;
  isLoading?: boolean;
  threadId: string;
  tokenUsageEnabled?: boolean;
@@ -330,12 +328,12 @@ export function MessageListItem({
          <div className="flex gap-1">
            <CopyButton clipboardData={messageMarkdown} />
            {messageMarkdown && (
-              <DownloadWordButton
-                markdown={messageMarkdown}
-                fileName="message"
-                title="问答回答"
-                questionMarkdown={questionMarkdown}
-              />
+              <DownloadWordButton
+                markdown={messageMarkdown}
+                fileName="message"
+                title="问答回答"
+                questionMarkdown={questionMarkdown}
+              />
            )}
            {canSaveAssistantEdit && (
              <Tooltip content="编辑消息">
@@ -380,12 +378,12 @@ function HumanMessageBlock({
  messageId?: string;
  text: string;
  pageContext?: EmbeddedPageContext | null;
-  filesList: React.ReactNode;
+  filesList: ReactNode;
  messageTime: { label: string; full: string } | null;
  components: MarkdownContentProps["components"];
  onEditResubmit?: (text: string) => void;
  onEditSave?: (messageId: string, text: string) => void | Promise<void>;
-  deleteButton?: React.ReactNode;
+  deleteButton?: ReactNode;
 }) {
  const { t } = useI18n();
  const [editing, setEditing] = useState(false);
@@ -629,9 +627,7 @@ function MessageContent_({
              href={href}
              {...props}
              onReferenceClick={
-                isSingleRoundRag || isMultiRoundRag
-                  ? handleCitationClick
-                  : undefined
+                isSingleRoundRag ? handleCitationClick : undefined
              }
            />
          );
@@ -658,7 +654,6 @@ function MessageContent_({
    }),
    [
      handleCitationClick,
-      isMultiRoundRag,
      isSingleRoundRag,
      resolveArtifact,
      threadId,
@@ -697,9 +692,12 @@ function MessageContent_({
        ? stripArtifactTag(stripUploadedFilesTag(rawContent))
        : '';
    }
+    if (isMultiRoundRag) {
+      return stripIncompleteCitationMarker(rawContent ?? '');
+    }
    const withCitations = applyInlineCitations(rawContent ?? '', displaySources);
    return stripIncompleteCitationMarker(withCitations);
-  }, [rawContent, isHuman, displaySources]);
+  }, [rawContent, isHuman, isMultiRoundRag, displaySources]);
  const markdownRehypePlugins = useMemo(
    () => [...rehypePlugins, [rehypeKatex, { output: 'html' as const }]],
    [rehypePlugins],
@@ -734,7 +732,7 @@ function MessageContent_({
  }

  // Reasoning-only AI message (no main response content yet)
-  if (!isHuman && reasoningContent && !rawContent && !multiRoundTrace) {
+  if (!isHuman && reasoningContent && !rawContent && !isMultiRoundRag) {
    return (
      <AIElementMessageContent className={className}>
        <Reasoning isStreaming={isLoading}>
@@ -755,7 +753,11 @@ function MessageContent_({
    // it exists server-side (real, non-optimistic id). Deleting it cascades to
    // its answer on the backend.
    const canDelete =
-      !!onMessageDeleted && !!message.id && !message.id.startsWith('opt-');
+      !!onMessageDeleted &&
+      !!message.id &&
+      !message.id.startsWith('opt-') &&
+      !isMultiRoundRag &&
+      !isSingleRoundRag;
    return (
      <HumanMessageBlock
        messageId={message.id}
@@ -764,8 +766,10 @@ function MessageContent_({
        filesList={filesList}
        messageTime={messageTime}
        components={components}
-        onEditResubmit={onEditResubmit}
-        onEditSave={onEditSave}
+        onEditResubmit={
+          isMultiRoundRag || isSingleRoundRag ? undefined : onEditResubmit
+        }
+        onEditSave={isMultiRoundRag || isSingleRoundRag ? undefined : onEditSave}
        deleteButton={
          canDelete ? (
            <DeleteMessageButton
@@ -785,14 +789,12 @@ function MessageContent_({
      <AIElementMessageContent className={className}>
        {filesList}
        <div data-reference-batch-id={message.id} className="contents">
-          {multiRoundTrace ? (
-            <MultiRoundRagContent
-              trace={multiRoundTrace}
+          {isMultiRoundRag ? (
+            <MultiRoundRagAssistantBody
              content={contentToDisplay}
-              displaySources={displaySources}
+              thinkingTrace={multiRoundTrace}
              isLoading={isLoading}
              rehypePlugins={markdownRehypePlugins}
-              components={components}
            />
          ) : (
            <AssistantDisplayContent
@@ -805,7 +807,7 @@ function MessageContent_({
            />
          )}
        </div>
-        {(isSingleRoundRag || isMultiRoundRag) && displaySources.length > 0 && (
+        {isSingleRoundRag && displaySources.length > 0 && (
          <FrontendRagSourcesPanel
            sources={displaySources}
            onSelect={setSelectedCitation}
@@ -820,7 +822,7 @@ function MessageContent_({
          <MessageTimeStamp time={messageTime} align="left" />
        ) : null}
      </AIElementMessageContent>
-      {(isSingleRoundRag || isMultiRoundRag) && (
+      {isSingleRoundRag && (
        <SingleRoundRagCitationDialog
          source={selectedCitation}
          onOpenChange={(open) => {
@@ -833,11 +835,9 @@ function MessageContent_({
 }

 /**
- * 单轮/多轮 RAG 专属的「引用来源」折叠面板。
+ * 单轮 RAG 专属的「引用来源」折叠面板。
 *
- * 参考 GeneralQA 的引用来源区：默认折叠，列出全部参考资料，点击任一条打开详情
- * 弹窗（复用 SingleRoundRagCitationDialog）。这样即使模型正文里没有 `[1]` 编号，
- * 用户也能看到本次回答依据的资料。
+ * 多轮 RAG 的检索卡片已经画在思考过程里，正文下面不再重复一份来源列表。
 */
 function FrontendRagSourcesPanel({
  sources,
@@ -941,349 +941,6 @@ export function SingleRoundRagCitationDialog({
  );
 }

-function MultiRoundRagContent({
-  trace,
-  content,
-  displaySources,
-  isLoading,
-  rehypePlugins,
-  components,
-}: {
-  trace: NonNullable<ReturnType<typeof getMultiRoundRagTrace>>;
-  content: string;
-  displaySources: RuntimeDisplaySource[];
-  isLoading: boolean;
-  rehypePlugins: MarkdownContentProps['rehypePlugins'];
-  components: MarkdownContentProps['components'];
-}) {
-  const [open, setOpen] = useState(!trace.isComplete);
-  useEffect(() => {
-    // Keep the active turn expanded so each new retrieval is visible as it
-    // arrives, then match GeneralQA by collapsing the completed trace.  The
-    // header still carries the total round count for quick scanning.
-    setOpen(!trace.isComplete);
-  }, [trace.isComplete]);
-
-  return (
-    <div className="w-full min-w-0 max-w-5xl space-y-4 overflow-hidden">
-      <section className="border-border/70 overflow-hidden rounded-xl border bg-muted/20">
-        <button
-          type="button"
-          className="hover:bg-muted/50 flex w-full items-center justify-between gap-3 px-4 py-3 text-left transition-colors"
-          onClick={() => setOpen((value) => !value)}
-        >
-          <div className="flex min-w-0 items-center gap-2">
-            {trace.isComplete ? (
-              <SearchIcon className="text-primary size-4 shrink-0" />
-            ) : (
-              <Loader2Icon className="text-primary size-4 shrink-0 animate-spin" />
-            )}
-            <div>
-              <div className="text-sm font-medium">多轮检索思考过程</div>
-              <div className="text-muted-foreground text-xs">
-                {trace.isComplete
-                  ? `共 ${trace.rounds.length} 轮推理与检索，可展开查看细节`
-                  : '正在分析问题并检索资料'}
-              </div>
-            </div>
-          </div>
-          <ChevronDownIcon
-            className={cn('text-muted-foreground size-4 transition-transform', !open && '-rotate-90')}
-          />
-        </button>
-        {open && (
-          <div className="border-border/60 space-y-3 border-t px-4 py-3">
-            {trace.rounds.map((round, index) => (
-              <div
-                key={round.id}
-                className={cn(
-                  'relative pl-5',
-                  index < trace.rounds.length - 1 && 'pb-1',
-                )}
-              >
-                {index < trace.rounds.length - 1 && (
-                  <span className="bg-border absolute bottom-0 left-[7px] top-8 w-px" />
-                )}
-                <span className="border-primary bg-background absolute left-0 top-4 size-3.5 rounded-full border-2" />
-                <MultiRoundRagRoundCard
-                  index={index + 1}
-                  round={round}
-                  displaySources={displaySources}
-                  isLoading={isLoading}
-                  rehypePlugins={rehypePlugins}
-                  components={components}
-                />
-              </div>
-            ))}
-          </div>
-        )}
-      </section>
-      <section className="border-border/70 rounded-xl border p-4">
-        <div className="mb-3 text-sm font-semibold">最终回答</div>
-        {content ? (
-          <AssistantDisplayContent
-            content={content}
-            displaySources={displaySources}
-            isLoading={isLoading}
-            renderSkillDisplayBlocks={false}
-            rehypePlugins={rehypePlugins}
-            components={components}
-          />
-        ) : (
-          <div className="text-muted-foreground flex items-center gap-2 text-sm">
-            <Loader2Icon className="size-4 animate-spin" />
-            正在生成最终回答…
-          </div>
-        )}
-      </section>
-    </div>
-  );
-}
-
-function MultiRoundRagRoundCard({
-  index,
-  round,
-  displaySources,
-  isLoading,
-  rehypePlugins,
-  components,
-}: {
-  index: number;
-  round: MultiRoundRagRound;
-  displaySources: RuntimeDisplaySource[];
-  isLoading: boolean;
-  rehypePlugins: MarkdownContentProps['rehypePlugins'];
-  components: MarkdownContentProps['components'];
-}) {
-  const [open, setOpen] = useState(!round.query || round.isSearching);
-  useEffect(() => {
-    // A newly created round stays expanded to expose its thought and loading
-    // query. Once that query has returned, retain only the round header until
-    // the user asks to inspect the completed detail again.
-    setOpen(!round.query || round.isSearching);
-  }, [round.id, round.isSearching, round.query]);
-  const thoughtContent = useMemo(
-    () =>
-      applyInlineCitations(round.thought, displaySources, {
-        appendSummary: false,
-      }),
-    [displaySources, round.thought],
-  );
-
-  return (
-    <Collapsible open={open} onOpenChange={setOpen}>
-      <article className="border-border/60 bg-background/80 overflow-hidden rounded-xl border shadow-sm">
-        <CollapsibleTrigger asChild>
-          <button
-            type="button"
-            className="hover:bg-muted/40 focus-visible:ring-ring flex min-h-11 w-full min-w-0 items-center gap-2 px-3 py-2.5 text-left text-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset"
-          >
-            <span className="bg-primary/10 text-primary flex size-6 shrink-0 items-center justify-center rounded-full text-xs font-semibold">
-              {index}
-            </span>
-            <span className="min-w-0 flex-1 truncate">{round.title}</span>
-            {round.isSearching ? (
-              <span className="bg-primary/10 text-primary inline-flex shrink-0 items-center gap-1 rounded-full px-2 py-1 text-[11px] font-medium">
-                <Loader2Icon className="size-3 motion-reduce:animate-none animate-spin" />
-                检索中
-              </span>
-            ) : (
-              <span className="text-muted-foreground shrink-0 text-[11px]">已完成</span>
-            )}
-            <ChevronDownIcon
-              className={cn(
-                'text-muted-foreground size-4 shrink-0 transition-transform duration-200 motion-reduce:transition-none',
-                !open && '-rotate-90',
-              )}
-            />
-          </button>
-        </CollapsibleTrigger>
-        <CollapsibleContent className="border-border/50 border-t px-3 pb-3">
-          <div className="pt-3">
-            {round.thought && (
-              <MultiRoundRagDetailSection
-                title="思考内容"
-                icon={<SparklesIcon className="text-primary size-4" />}
-              >
-                <MarkdownContent
-                  content={thoughtContent}
-                  isLoading={isLoading}
-                  rehypePlugins={rehypePlugins}
-                  components={components}
-                  className="text-muted-foreground text-sm"
-                />
-              </MultiRoundRagDetailSection>
-            )}
-            {round.body && (
-              <section className="border-border/50 mt-3 rounded-lg border p-3">
-                <div className="text-muted-foreground mb-2 text-xs font-medium">本轮正文</div>
-                <MarkdownContent
-                  content={round.body}
-                  isLoading={isLoading}
-                  rehypePlugins={rehypePlugins}
-                  components={components}
-                  className="text-sm"
-                />
-              </section>
-            )}
-            {(round.query || round.isSearching) && (
-              <div
-                className={cn(
-                  'border-primary/20 bg-primary/5 text-primary mt-3 inline-flex max-w-full items-center gap-1.5 rounded-full border px-2.5 py-1.5 text-xs',
-                  round.isSearching && 'animate-pulse motion-reduce:animate-none',
-                )}
-                aria-live={round.isSearching ? 'polite' : undefined}
-              >
-                {round.isSearching ? (
-                  <Loader2Icon className="size-3.5 shrink-0 motion-reduce:animate-none animate-spin" />
-                ) : (
-                  <SearchIcon className="size-3.5 shrink-0" />
-                )}
-                <span className="shrink-0 text-muted-foreground">检索词</span>
-                <span className="min-w-0 truncate font-medium">
-                  {round.query || '正在生成检索词…'}
-                </span>
-              </div>
-            )}
-            {(round.query || round.isSearching || round.retrievals.length > 0) && (
-              <MultiRoundRagDetailSection
-                defaultOpen={!round.isSearching}
-                title="检索内容"
-                icon={<FileIcon className="text-primary size-3.5" />}
-                suffix={<span className="text-muted-foreground text-xs">{round.retrievals.length} 条</span>}
-              >
-                {round.isSearching ? (
-                  <div className="text-muted-foreground flex items-center gap-2 py-1 text-sm">
-                    <Loader2Icon className="text-primary size-4 motion-reduce:animate-none animate-spin" />
-                    正在召回相关内容…
-                  </div>
-                ) : (
-                  <div className="space-y-2">
-                    {round.retrievals.length > 0 ? (
-                      round.retrievals.map((item, resultIndex) => (
-                        <MultiRoundRagResultCard
-                          key={`${item.id ?? item.title}-${resultIndex}`}
-                          item={item}
-                          index={resultIndex + 1}
-                        />
-                      ))
-                    ) : (
-                      <p className="text-muted-foreground py-1 text-sm">
-                        本轮未召回相关资料。
-                      </p>
-                    )}
-                  </div>
-                )}
-              </MultiRoundRagDetailSection>
-            )}
-          </div>
-        </CollapsibleContent>
-      </article>
-    </Collapsible>
-  );
-}
-
-function MultiRoundRagDetailSection({
-  title,
-  icon,
-  suffix,
-  defaultOpen = true,
-  children,
-}: {
-  title: string;
-  icon: ReactNode;
-  suffix?: ReactNode;
-  defaultOpen?: boolean;
-  children: ReactNode;
-}) {
-  const [open, setOpen] = useState(defaultOpen);
-  useEffect(() => setOpen(defaultOpen), [defaultOpen]);
-
-  return (
-    <Collapsible open={open} onOpenChange={setOpen}>
-      <section className="border-border/50 bg-muted/20 mt-3 overflow-hidden rounded-lg border">
-        <CollapsibleTrigger asChild>
-          <button
-            type="button"
-            className="hover:bg-muted/40 focus-visible:ring-ring flex min-h-11 w-full min-w-0 items-center gap-2 px-3 py-2 text-left transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset"
-          >
-            {icon}
-            <span className="min-w-0 flex-1 text-sm font-medium">{title}</span>
-            {suffix}
-            <ChevronDownIcon
-              className={cn(
-                'text-muted-foreground size-4 shrink-0 transition-transform duration-200 motion-reduce:transition-none',
-                !open && '-rotate-90',
-              )}
-            />
-          </button>
-        </CollapsibleTrigger>
-        <CollapsibleContent className="border-border/50 border-t px-3 pb-3 pt-2.5">
-          {children}
-        </CollapsibleContent>
-      </section>
-    </Collapsible>
-  );
-}
-
-function MultiRoundRagResultCard({
-  item,
-  index,
-}: {
-  item: MultiRoundRagRound['retrievals'][number];
-  index: number;
-}) {
-  const [open, setOpen] = useState(index === 1);
-  const sourceMeta = [item.source, item.time].filter(Boolean).join(' · ');
-
-  return (
-    <Collapsible open={open} onOpenChange={setOpen}>
-      <div className="border-border/60 hover:border-primary/30 bg-background rounded-lg border transition-colors">
-        <CollapsibleTrigger asChild>
-          <button
-            type="button"
-            className="hover:bg-muted/40 focus-visible:ring-ring flex min-h-11 w-full min-w-0 items-center gap-2 rounded-lg px-3 py-2.5 text-left transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset"
-          >
-            <span className="bg-primary/10 text-primary flex size-5 shrink-0 items-center justify-center rounded-md text-[11px] font-semibold">
-              {index}
-            </span>
-            <span className="min-w-0 flex-1 truncate text-sm font-medium" title={item.title}>
-              {item.title}
-            </span>
-            <ChevronDownIcon
-              className={cn(
-                'text-muted-foreground size-4 shrink-0 transition-transform duration-200 motion-reduce:transition-none',
-                !open && '-rotate-90',
-              )}
-            />
-          </button>
-        </CollapsibleTrigger>
-        <CollapsibleContent className="border-border/50 border-t px-3 pb-3 pt-2.5">
-          <p className="text-muted-foreground text-sm leading-6 whitespace-pre-wrap">
-            {item.content || '暂无资料摘要'}
-          </p>
-          {(sourceMeta || item.url) && (
-            <div className="text-muted-foreground mt-2 flex flex-wrap items-center gap-x-2 gap-y-1 text-xs">
-              {sourceMeta && <span>{sourceMeta}</span>}
-              {item.url && (
-                <a
-                  href={item.url}
-                  target="_blank"
-                  rel="noopener noreferrer"
-                  className="text-primary hover:underline inline-flex items-center gap-1"
-                >
-                  查看原文
-                  <ExternalLinkIcon className="size-3" />
-                </a>
-              )}
-            </div>
-          )}
-        </CollapsibleContent>
-      </div>
-    </Collapsible>
-  );
-}
-
 function resolveSingleRoundRagSourceUrl(
  source: RuntimeDisplaySource | null,
 ): string | undefined {
@@ -1,7 +1,7 @@
 import type { Message } from "@langchain/langgraph-sdk";
 import type { BaseStream } from "@langchain/langgraph-sdk/react";
 import { CheckIcon, PenLineIcon, SendIcon, XIcon } from "lucide-react";
-import { useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
+import { useCallback, useContext, useEffect, useMemo, useRef, useState, type ReactNode } from "react";
 import { useStickToBottomContext } from "use-stick-to-bottom";

 import {
@@ -28,12 +28,12 @@ import {
  hasToolCalls,
  isHiddenFromUIMessage,
 } from "@/core/messages/utils";
-import { useRehypeSplitWordsIntoSpans } from "@/core/rehype";
-import { isThreadRagModeLocked, useLocalSettings } from "@/core/settings";
-import { useSkills } from "@/core/skills/hooks";
-import { useCitationDisplaySettings } from "@/core/system-settings/hooks";
-import {
-  buildSkillDisplayMap,
+import { useRehypeSplitWordsIntoSpans } from "@/core/rehype";
+import { isThreadRagModeLocked, useLocalSettings } from "@/core/settings";
+import { useSkills } from "@/core/skills/hooks";
+import { useCitationDisplaySettings } from "@/core/system-settings/hooks";
+import {
+  buildSkillDisplayMap,
  collectRuntimeDisplaySources,
  type RuntimeDisplaySource,
 } from "@/core/skill-display/runtime";
@@ -136,6 +136,8 @@ export function MessageList({
  onSetupReportStructureReject,
  researchApprovalSlot,
  taskReportImportSlot,
+  businessCardSlot,
+  speakerShell,
  onOpenArtifact,
  onDownloadArtifact,
  afterDocumentRewriteItems,
@@ -176,6 +178,19 @@ export function MessageList({
   * 「是否入库」卡片。不传该 slot 时（普通对话等）该分组不渲染，零行为变化。
   */
  taskReportImportSlot?: (message: Message) => React.ReactNode;
+  /**
+   * 通用业务卡插槽（报告协作工作台等）：宿主向 displayThread 注入带
+   * `additional_kwargs.report_collaboration_card` 的虚拟 ai 消息（方案组 /
+   * 命令确认 / 报告入口），由本插槽渲染。不传该 slot 时（普通对话等）该
+   * 分组不渲染，零行为变化；卡 payload 结构由各页面在 message-adapter
+   * 层定义，MessageList 不感知具体业务字段。
+   */
+  businessCardSlot?: (message: Message) => React.ReactNode;
+  /**
+   * 可选说话人壳（报告协作对齐会商第二步）：包住 assistant / processing 分组。
+   * 不传则问答页零变化。
+   */
+  speakerShell?: (messages: Message[], children: ReactNode) => ReactNode;
  onOpenArtifact?: (filepath: string) => void;
  /** Host override for downloading virtual/session-owned files in a present-files card. */
  onDownloadArtifact?: (filepath: string) => void | Promise<void>;
@@ -300,23 +315,19 @@ export function MessageList({
    }
    return map;
  }, [messages]);
-
-  const [settings] = useLocalSettings();
-  const { data: citationDisplay } = useCitationDisplaySettings();
-  const referenceModeEntryEnabled =
-    citationDisplay?.reference_mode_enabled ?? false;
-  const knowledgeReferencesEnabled =
-    threadContext?.knowledgeReferencesEnabled === true;
-  const ragModeEnabled =
-    (referenceModeEntryEnabled && settings.display.ragModeEnabled) ||
-    isThreadRagModeLocked(threadId) ||
-    knowledgeReferencesEnabled;
+
+  const [settings] = useLocalSettings();
+  const { data: citationDisplay } = useCitationDisplaySettings();
+  const referenceModeEntryEnabled =
+    citationDisplay?.reference_mode_enabled ?? false;
+  const knowledgeReferencesEnabled =
+    threadContext?.knowledgeReferencesEnabled === true;
+  const ragModeEnabled =
+    (referenceModeEntryEnabled && settings.display.ragModeEnabled) ||
+    isThreadRagModeLocked(threadId) ||
+    knowledgeReferencesEnabled;
  const hasSingleRoundRag = useMemo(
-    () =>
-      messages.some(
-        (message) =>
-          isSingleRoundRagMessage(message) || isMultiRoundRagMessage(message),
-      ),
+    () => messages.some((message) => isSingleRoundRagMessage(message)),
    [messages],
  );
  const referencesEnabled = ragModeEnabled || hasSingleRoundRag;
@@ -331,7 +342,7 @@ export function MessageList({
  // frontend tool-message scan below comes up empty (e.g. after a reload).
  const referenceBatches = useContext(ReferenceBatchesContext);

-  // 单轮/多轮 RAG 的参考资料存放在一条 hide_from_ui 的 tool 消息里（紧挨在
+  // 单轮 RAG 的参考资料存放在一条 hide_from_ui 的 tool 消息里（紧挨在
  // assistant 消息之前）。allMessages 会把 hide_from_ui 消息过滤掉，导致通用
  // 的 collectRuntimeDisplaySources 扫描不到它们。这里直接在原始消息流里按
  // assistant 消息提取其对应的参考资料，保证 `[1]` 等编号能解析成可点击引用。
@@ -342,7 +353,7 @@ export function MessageList({
      const msg = raw[i];
      if (!msg || msg.type !== "ai" || !msg.id) continue;
      const kwargs = msg.additional_kwargs;
-      if (!kwargs || (kwargs.single_round_rag !== true && kwargs.multi_round_rag !== true)) {
+      if (!kwargs || kwargs.single_round_rag !== true) {
        continue;
      }
      let sources: RuntimeDisplaySource[] = [];
@@ -353,19 +364,13 @@ export function MessageList({
        if (prev.type === "human" || prev.type === "ai") break;
        if (prev.type !== "tool") continue;
        const prevKwargs = prev.additional_kwargs;
-        if (
-          !prevKwargs ||
-          (prevKwargs.single_round_rag !== true && prevKwargs.multi_round_rag !== true)
-        ) {
+        if (!prevKwargs || prevKwargs.single_round_rag !== true) {
          continue;
        }
        const results = extractFrontendRagResults(prev.content);
        if (results && results.length > 0) {
          const toolName = String(
-            (prev as { name?: unknown }).name ??
-              (prevKwargs.multi_round_rag === true
-                ? "multi_round_rag_references"
-                : "knowledge_base_search"),
+            (prev as { name?: unknown }).name ?? "knowledge_base_search",
          );
          sources = results.map((item, index) =>
            toRuntimeDisplaySource(item, index + 1, toolName),
@@ -381,6 +386,7 @@ export function MessageList({
  const resolveDisplaySources = useCallback(
    (msg: Message | undefined): RuntimeDisplaySource[] => {
      if (!referencesEnabled || !msg || msg.type !== "ai") return [];
+      if (isMultiRoundRagMessage(msg)) return [];
      const batchSources =
        referenceBatches.find((batch) => batch.assistant_message_id === msg.id)
          ?.sources ?? [];
@@ -536,7 +542,7 @@ export function MessageList({
          let didRenderRewriteAboveFile = false;
          const grouped = groupMessages(messages, (group) => {
          if (group.type === "human" || group.type === "assistant") {
-            return group.messages.map((msg) => {
+            const items = group.messages.map((msg) => {
              // 深度研究的报告摘要由独立 SSE 作业驱动；把它接入既有 assistant 流式状态，
              // 便于 Streamdown 在每次 summary_delta 到达时立即更新该普通消息行。
              const messageIsLoading =
@@ -563,7 +569,12 @@ export function MessageList({
                  questionMarkdown={
                    msg.id ? questionMarkdownByAssistantId.get(msg.id) : undefined
                  }
-                  isLoading={messageIsLoading}
+                  isLoading={
+                    isMultiRoundRagMessage(msg)
+                      ? thread.isLoading &&
+                        msg.id === messages[messages.length - 1]?.id
+                      : messageIsLoading
+                  }
                  threadId={threadId}
                  tokenUsageEnabled={tokenUsageEnabled}
                  displaySources={displaySources}
@@ -577,6 +588,14 @@ export function MessageList({
                />
              );
            });
+            if (speakerShell && group.type === "assistant") {
+              return (
+                <div key={group.id} className="w-full">
+                  {speakerShell(group.messages, items)}
+                </div>
+              );
+            }
+            return items;
          } else if (group.type === "assistant:clarification") {
            const message = group.messages[0];
            if (message && hasContent(message)) {
@@ -692,6 +711,14 @@ export function MessageList({
                {taskReportImportSlot(message)}
              </div>
            ) : null;
+          } else if (group.type === "assistant:business-card") {
+            // 通用业务卡（报告协作）：宿主不传渲染函数时该分组不渲染。
+            const message = group.messages[0];
+            return businessCardSlot && message ? (
+              <div key={group.id} className="w-full pb-2">
+                {businessCardSlot(message)}
+              </div>
+            ) : null;
          } else if (group.type === "assistant:present-files") {
            const files: string[] = [];
            for (const message of group.messages) {
@@ -786,13 +813,13 @@ export function MessageList({
            )) {
              if (hasReasoning(message)) {
                results.push(
-                  <MessageGroup
-                    key={"thinking-group-" + message.id}
-                    messages={[message]}
-                    isLoading={thread.isLoading}
-                    displaySources={resolveDisplaySources(message)}
-                    ragModeEnabled={ragModeEnabled}
-                  />,
+                  <MessageGroup
+                    key={"thinking-group-" + message.id}
+                    messages={[message]}
+                    isLoading={thread.isLoading}
+                    displaySources={resolveDisplaySources(message)}
+                    ragModeEnabled={ragModeEnabled}
+                  />,
                );
              }
              results.push(
@@ -838,14 +865,14 @@ export function MessageList({
          const processingAi = [...group.messages]
            .reverse()
            .find((message) => message.type === "ai");
-          return (
-            <div key={"group-" + group.id} className="w-full">
-              <MessageGroup
-                messages={group.messages}
-                isLoading={thread.isLoading}
-                displaySources={resolveDisplaySources(processingAi)}
-                ragModeEnabled={ragModeEnabled}
-              />
+          const processingBody = (
+            <div className="w-full">
+              <MessageGroup
+                messages={group.messages}
+                isLoading={thread.isLoading}
+                displaySources={resolveDisplaySources(processingAi)}
+                ragModeEnabled={ragModeEnabled}
+              />
              <MessageTokenUsageList
                enabled={tokenUsageEnabled}
                isLoading={thread.isLoading}
@@ -853,6 +880,11 @@ export function MessageList({
              />
            </div>
          );
+          return (
+            <div key={"group-" + group.id} className="w-full">
+              {speakerShell ? speakerShell(group.messages, processingBody) : processingBody}
+            </div>
+          );
        });
          const leftoverRewriteItems = didRenderRewriteAboveFile
            ? rewriteItemsBelowFile
@@ -0,0 +1,472 @@
+import {
+  BookOpenIcon,
+  ChevronDownIcon,
+  FileTextIcon,
+  Loader2Icon,
+  SearchIcon,
+  SparklesIcon,
+} from "lucide-react";
+import { useState } from "react";
+
+import {
+  Conversation,
+  ConversationContent,
+  ConversationScrollButton,
+} from "@/components/ai-elements/conversation";
+import {
+  Message as AIElementMessage,
+  MessageContent as AIElementMessageContent,
+} from "@/components/ai-elements/message";
+import {
+  Collapsible,
+  CollapsibleContent,
+  CollapsibleTrigger,
+} from "@/components/ui/collapsible";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogHeader,
+  DialogTitle,
+} from "@/components/ui/dialog";
+import { useRehypeSplitWordsIntoSpans } from "@/core/rehype";
+import type { MessageResponseProps } from "@/components/ai-elements/message";
+import type {
+  MultiRoundRagChatMessage,
+  MultiRoundRagRetrieval,
+  MultiRoundRagRound,
+  MultiRoundRagTrace,
+} from "@/core/threads/use-multi-round-rag";
+import { cn } from "@/lib/utils";
+
+import { MarkdownContent } from "./markdown-content";
+
+export function MultiRoundRagMessageList({
+  className,
+  messages,
+  isLoading,
+  paddingBottom = 160,
+}: {
+  className?: string;
+  messages: MultiRoundRagChatMessage[];
+  isLoading: boolean;
+  paddingBottom?: number;
+}) {
+  const rehypePlugins = useRehypeSplitWordsIntoSpans(isLoading);
+
+  return (
+    <Conversation className={cn("flex size-full flex-col justify-center", className)}>
+      <ConversationContent
+        className="mx-auto w-full max-w-(--container-width-lg) gap-8 pt-10"
+      >
+        {messages.map((message, index) => {
+          const isLastAssistant =
+            message.role === "assistant" && index === messages.length - 1;
+          return (
+            <AIElementMessage
+              key={message.id}
+              className="group/conversation-message relative w-full"
+              from={message.role === "user" ? "user" : "assistant"}
+            >
+              {message.role === "user" ? (
+                <AIElementMessageContent className="w-fit">
+                  <p className="whitespace-pre-wrap text-[15px] leading-7">
+                    {message.content}
+                  </p>
+                </AIElementMessageContent>
+              ) : (
+                <AIElementMessageContent className="w-full">
+                  <MultiRoundRagAssistantBody
+                    content={
+                      typeof message.content === "string" ? message.content : ""
+                    }
+                    thinkingTrace={message.thinkingTrace}
+                    isLoading={isLastAssistant && isLoading}
+                    rehypePlugins={rehypePlugins}
+                  />
+                </AIElementMessageContent>
+              )}
+            </AIElementMessage>
+          );
+        })}
+        <div style={{ height: `${paddingBottom}px` }} />
+      </ConversationContent>
+      <ConversationScrollButton
+        className="pointer-events-auto z-20 size-9 shadow-md bottom-40"
+        aria-label="回到最新"
+        title="回到最新"
+      />
+    </Conversation>
+  );
+}
+
+export function MultiRoundRagAssistantBody({
+  content,
+  thinkingTrace,
+  isLoading,
+  rehypePlugins,
+}: {
+  content: string;
+  thinkingTrace?: MultiRoundRagTrace | null;
+  isLoading: boolean;
+  rehypePlugins: MessageResponseProps["rehypePlugins"];
+}) {
+  const [selected, setSelected] = useState<MultiRoundRagRetrieval | null>(
+    null,
+  );
+  const trace = thinkingTrace;
+  const answer = trace?.finalAnswerMarkdown || content;
+
+  return (
+    <>
+      {trace && (
+        <MultiRoundRagTraceView
+          trace={trace}
+          isLoading={isLoading}
+          rehypePlugins={rehypePlugins}
+          onSelectRetrieval={setSelected}
+        />
+      )}
+      <section className="mt-4">
+        <div className="text-foreground mb-2 text-sm font-medium">最终回答</div>
+        {answer ? (
+          <MarkdownContent
+            content={answer}
+            isLoading={isLoading}
+            rehypePlugins={rehypePlugins}
+            className="my-0 text-[15px] leading-7"
+          />
+        ) : (
+          <div className="text-muted-foreground flex items-center gap-2 text-sm">
+            <Loader2Icon className="size-4 animate-spin" />
+            正在生成思考过程与检索内容...
+          </div>
+        )}
+      </section>
+      <RetrievalDetailDialog
+        item={selected}
+        onOpenChange={(open) => {
+          if (!open) setSelected(null);
+        }}
+      />
+    </>
+  );
+}
+
+function MultiRoundRagTraceView({
+  trace,
+  isLoading,
+  rehypePlugins,
+  onSelectRetrieval,
+}: {
+  trace: MultiRoundRagTrace;
+  isLoading: boolean;
+  rehypePlugins: MessageResponseProps["rehypePlugins"];
+  onSelectRetrieval: (item: MultiRoundRagRetrieval) => void;
+}) {
+  const [open, setOpen] = useState(!trace.thinkingComplete);
+
+  return (
+    <Collapsible
+      open={open}
+      onOpenChange={setOpen}
+      className="not-prose w-full min-w-0 max-w-5xl"
+    >
+      <CollapsibleTrigger asChild>
+        <button
+          type="button"
+          className="text-muted-foreground hover:text-foreground flex w-full items-center gap-2 text-sm transition-colors"
+        >
+          {trace.thinkingComplete ? (
+            <SparklesIcon className="text-primary size-4 shrink-0" />
+          ) : (
+            <Loader2Icon className="text-primary size-4 shrink-0 animate-spin" />
+          )}
+          <span>{trace.title || "思考过程"}</span>
+          <span className="text-muted-foreground/70 text-xs">
+            共 {trace.rounds.length} 轮推理与检索
+          </span>
+          <ChevronDownIcon
+            className={cn("ml-auto size-4 transition-transform", !open && "-rotate-90")}
+          />
+        </button>
+      </CollapsibleTrigger>
+      <CollapsibleContent className="mt-3 space-y-3">
+        {trace.rounds.map((round, index) => (
+          <div
+            key={round.id}
+            className={cn("relative pl-5", index < trace.rounds.length - 1 && "pb-1")}
+          >
+            {index < trace.rounds.length - 1 && (
+              <span className="bg-primary/25 absolute bottom-0 left-[7px] top-8 w-px" />
+            )}
+            <span className="border-primary bg-background absolute left-0 top-4 size-3.5 rounded-full border-2" />
+            <MultiRoundRagRoundCard
+              index={index + 1}
+              round={round}
+              isLoading={isLoading}
+              isActiveRound={isLoading && index === trace.rounds.length - 1}
+              rehypePlugins={rehypePlugins}
+              onSelectRetrieval={onSelectRetrieval}
+            />
+          </div>
+        ))}
+      </CollapsibleContent>
+    </Collapsible>
+  );
+}
+
+function MultiRoundRagRoundCard({
+  index,
+  round,
+  isLoading,
+  isActiveRound,
+  rehypePlugins,
+  onSelectRetrieval,
+}: {
+  index: number;
+  round: MultiRoundRagRound;
+  isLoading: boolean;
+  isActiveRound: boolean;
+  rehypePlugins: MessageResponseProps["rehypePlugins"];
+  onSelectRetrieval: (item: MultiRoundRagRetrieval) => void;
+}) {
+  const query = round.query.trim();
+  const searching = Boolean(query && round.queryLoading);
+  const showQuery = Boolean(query);
+  const showRetrievals = showQuery || round.retrievals.length > 0;
+  const [open, setOpen] = useState(true);
+
+  return (
+    <Collapsible open={open} onOpenChange={setOpen}>
+      <article className="overflow-hidden rounded-lg border border-border/70 bg-background">
+        <CollapsibleTrigger asChild>
+          <button
+            type="button"
+            className="hover:bg-muted/40 flex min-h-11 w-full items-center gap-2 px-3 py-2.5 text-left text-sm transition-colors"
+          >
+            <span className="bg-primary/10 text-primary flex size-6 shrink-0 items-center justify-center rounded-full text-xs font-medium">
+              {index}
+            </span>
+            <span className="min-w-0 flex-1 truncate font-medium">{round.title}</span>
+            {searching ? (
+              <span className="text-primary inline-flex items-center gap-1 text-[11px]">
+                <Loader2Icon className="size-3 animate-spin" />
+                检索中
+              </span>
+            ) : isActiveRound ? null : (
+              <span className="text-muted-foreground text-[11px]">已完成</span>
+            )}
+            <ChevronDownIcon
+              className={cn("text-muted-foreground size-4 shrink-0 transition-transform", !open && "-rotate-90")}
+            />
+          </button>
+        </CollapsibleTrigger>
+        <CollapsibleContent className="border-border/60 space-y-3 border-t px-3 pb-3 pt-3">
+        {round.thoughtMarkdown && (
+          <section>
+            <div className="text-muted-foreground mb-1.5 flex items-center gap-2 text-sm font-medium">
+              <SparklesIcon className="size-4" />
+              思考内容
+            </div>
+            <MarkdownContent
+              content={round.thoughtMarkdown}
+              isLoading={isLoading}
+              rehypePlugins={rehypePlugins}
+              className="text-muted-foreground my-0 text-sm leading-6"
+            />
+          </section>
+        )}
+        {showQuery && (
+          <div
+            className="border-primary/20 bg-primary/5 text-primary inline-flex max-w-full items-center gap-2 rounded-full border px-3 py-1.5"
+            aria-live={searching ? "polite" : undefined}
+          >
+            {searching ? (
+              <Loader2Icon className="size-3.5 shrink-0 animate-spin" />
+            ) : (
+              <SearchIcon className="size-3.5 shrink-0" />
+            )}
+            <span className="text-primary/80 shrink-0 text-xs">
+              {round.queryTitle || "检索词"}
+            </span>
+            <span className="min-w-0 truncate text-xs font-medium">
+              {query}
+            </span>
+          </div>
+        )}
+        {showRetrievals && (
+          <section>
+            <div className="mb-2 flex items-center gap-2 text-sm font-medium">
+              <FileTextIcon className="text-muted-foreground size-4" />
+              检索内容
+              <span className="text-muted-foreground text-xs font-normal">
+                {round.retrievals.length} 条
+              </span>
+            </div>
+            {searching ? (
+              <div className="text-muted-foreground flex items-center gap-2 rounded-lg border border-border/70 px-3 py-3 text-sm">
+                <Loader2Icon className="text-primary size-4 animate-spin" />
+                正在召回相关内容...
+              </div>
+            ) : (
+              <RetrievalCardList
+                items={round.retrievals}
+                onSelect={onSelectRetrieval}
+              />
+            )}
+          </section>
+        )}
+        {(round.extractInfo || round.extractContent || round.extractLoading) && (
+          <section className="rounded-lg border border-border/70 px-3 py-3">
+            <div className="mb-2 flex items-center gap-2 text-sm font-medium">
+              <BookOpenIcon className="text-muted-foreground size-4" />
+              阅读内容
+              {round.extractLoading && <Loader2Icon className="text-primary size-3.5 animate-spin" />}
+            </div>
+            {round.extractInfo && (
+              <p className="text-muted-foreground text-sm leading-6">{round.extractInfo}</p>
+            )}
+            {round.extractContent && (
+              <p className="mt-2 text-sm leading-6 whitespace-pre-wrap">{round.extractContent}</p>
+            )}
+          </section>
+        )}
+        {round.textidContent && (
+          <section className="rounded-lg border border-border/70 px-3 py-3 text-sm leading-6 whitespace-pre-wrap">
+            {round.textidContent}
+          </section>
+        )}
+      </CollapsibleContent>
+      </article>
+    </Collapsible>
+  );
+}
+
+function RetrievalCardList({
+  items,
+  onSelect,
+}: {
+  items: MultiRoundRagRetrieval[];
+  onSelect: (item: MultiRoundRagRetrieval) => void;
+}) {
+  if (items.length === 0) {
+    return <p className="text-muted-foreground py-1 text-sm">本轮未召回相关资料。</p>;
+  }
+  return (
+    <div className="space-y-2">
+      {items.map((item, index) => (
+        <RetrievalCard
+          key={`${item.id ?? item.title}-${index}`}
+          item={item}
+          index={index + 1}
+          defaultOpen={index === 0}
+          onSelect={onSelect}
+        />
+      ))}
+    </div>
+  );
+}
+
+function RetrievalCard({
+  item,
+  index,
+  defaultOpen,
+  onSelect,
+}: {
+  item: MultiRoundRagRetrieval;
+  index: number;
+  defaultOpen: boolean;
+  onSelect: (item: MultiRoundRagRetrieval) => void;
+}) {
+  const [open, setOpen] = useState(defaultOpen);
+  const meta = retrievalMeta(item);
+
+  if (item.type === "user_behavior") {
+    return (
+      <div className="rounded-xl border border-border/70 px-3 py-2 text-sm">
+        <span className="text-muted-foreground mr-2 font-medium">{index}.</span>
+        {item.title}
+      </div>
+    );
+  }
+
+  return (
+    <Collapsible open={open} onOpenChange={setOpen}>
+      <div className="overflow-hidden rounded-xl border border-border/70 bg-background">
+        <CollapsibleTrigger asChild>
+          <button
+            type="button"
+            className="hover:bg-muted/40 flex min-h-11 w-full items-center gap-2 px-3 py-2.5 text-left transition-colors"
+          >
+            <span className="bg-muted text-muted-foreground flex size-5 shrink-0 items-center justify-center rounded-md text-[11px] font-medium">
+              {index}
+            </span>
+            <div className="min-w-0 flex-1">
+              <div className="truncate text-sm font-medium" title={item.title}>
+                {item.title}
+              </div>
+              {meta && (
+                <div className="text-muted-foreground truncate text-xs">{meta}</div>
+              )}
+            </div>
+            <ChevronDownIcon
+              className={cn("text-muted-foreground size-4 shrink-0 transition-transform", !open && "-rotate-90")}
+            />
+          </button>
+        </CollapsibleTrigger>
+        <CollapsibleContent className="border-border/60 border-t px-3 pb-3 pt-2.5">
+          <button
+            type="button"
+            className="text-muted-foreground hover:text-foreground line-clamp-3 w-full text-left text-sm leading-6 whitespace-pre-wrap"
+            onClick={() => onSelect(item)}
+          >
+            {item.content || "暂无资料摘要"}
+          </button>
+        </CollapsibleContent>
+      </div>
+    </Collapsible>
+  );
+}
+
+function retrievalMeta(item: MultiRoundRagRetrieval): string {
+  if (item.type === "more") return `时间：${item.time || "-"}`;
+  if (item.type === "task") return `关键词：${item.keywords || "-"}`;
+  if (item.type === "hx") return `平台：${item.platform || "-"}  粉丝数:${item.fans ?? "-"}`;
+  if (
+    item.type === "taiwan_news" ||
+    item.type === "world_news" ||
+    item.type === "messaage_comment" ||
+    item.type === "america_news"
+  ) {
+    return `平台：${item.platform || "-"}${item.comment_count ? `  评论数:${item.comment_count}` : ""}`;
+  }
+  if (item.type === "get_time_data") return `时间：${item.time || "-"}  热度:${item.hot_num ?? "-"}`;
+  return [item.source, item.time].filter(Boolean).join(" · ");
+}
+
+function RetrievalDetailDialog({
+  item,
+  onOpenChange,
+}: {
+  item: MultiRoundRagRetrieval | null;
+  onOpenChange: (open: boolean) => void;
+}) {
+  const content = item?.content;
+  return (
+    <Dialog open={!!item} onOpenChange={onOpenChange}>
+      <DialogContent className="max-h-[min(42rem,calc(100vh-2rem))] max-w-2xl overflow-hidden p-5 sm:max-w-2xl">
+        <DialogHeader className="pr-8">
+          <DialogTitle className="leading-relaxed">{item?.title || "引用资料"}</DialogTitle>
+          <DialogDescription className="space-y-1 text-xs">
+            {item?.time && <span className="block">时间：{item.time}</span>}
+            {item?.source && <span className="block">来源：{item.source}</span>}
+          </DialogDescription>
+        </DialogHeader>
+        <div className="bg-muted/50 max-h-[min(26rem,calc(100vh-16rem))] overflow-auto rounded-xl p-3 text-sm leading-7 whitespace-pre-wrap">
+          {content || "暂无引用内容"}
+        </div>
+      </DialogContent>
+    </Dialog>
+  );
+}
@@ -188,7 +188,7 @@ export function AppearanceSettingsPage({ onClose }: { onClose?: () => void }) {
  const globalDefault = appearance?.default_theme ?? "light";
  const globalSkillView = appearance?.default_skill_view ?? "list";
  const globalAgentView = appearance?.default_agent_view ?? "card";
-  const globalLayoutMode = appearance?.default_layout_mode ?? "full";
+  const globalLayoutMode = appearance?.default_layout_mode ?? "compact";
  const globalDefaultLabel = useMemo(() => {
    const customTheme = (appearance?.custom_themes ?? []).find(
      (preset) => preset.id === globalDefault,
@@ -201,7 +201,7 @@ export function AppearanceSettingsPage({ onClose }: { onClose?: () => void }) {
    if (globalDefault === "lightyellow") return "浅黄色";
    return "浅蓝";
  }, [appearance?.custom_themes, globalDefault]);
-  // 有效界面模式：用户自己选过则以其为准，否则跟随管理员系统默认（再否则会话级回退）。
+  // 有效界面模式：用户自己选过则以其为准，否则跟随管理员系统默认（再否则内置默认简洁模式）。
  const [effectiveLayoutMode, setLayoutMode] = useLayoutMode();
  const cleanupWords =
    citationDisplay?.cleanup_words ?? settings.display.citationCleanupWords ?? [];
@@ -1,6 +1,6 @@
 "use client";

-import { BellIcon, PaletteIcon, SparklesIcon, UserIcon, WrenchIcon } from "lucide-react";
+import { BellIcon, CpuIcon, PaletteIcon, SparklesIcon, UserIcon, WrenchIcon } from "lucide-react";
 import { useEffect, useMemo, useState } from "react";

 import {
@@ -14,16 +14,19 @@ import { AboutSettingsPage } from "@/components/workspace/settings/about-setting
 import { AccountSettingsPage } from "@/components/workspace/settings/account-settings-page";
 import { AppearanceSettingsPage } from "@/components/workspace/settings/appearance-settings-page";
 import { MemorySettingsPage } from "@/components/workspace/settings/memory-settings-page";
-import { ToolSettingsPage } from "@/components/workspace/settings/tool-settings-page";
-import { useI18n } from "@/core/i18n/hooks";
-import { cn } from "@/lib/utils";
+import { ToolSettingsPage } from "@/components/workspace/settings/tool-settings-page";
+import { getStoredAuth } from "@/core/auth";
+import { useI18n } from "@/core/i18n/hooks";
+import { cn } from "@/lib/utils";
+import { LocalEncoderSettingsCard } from "@/strategy-components/components/resource-management/llmwiki/WeKnoraKnowledgeWorkspace";

 type SettingsSection =
  | "account"
  | "appearance"
-  | "memory"
-  | "tools"
-  | "about";
+  | "memory"
+  | "tools"
+  | "encoder"
+  | "about";

 type SettingsDialogProps = React.ComponentProps<typeof Dialog> & {
  defaultSection?: SettingsSection;
@@ -31,7 +34,8 @@ type SettingsDialogProps = React.ComponentProps<typeof Dialog> & {

 export function SettingsDialog(props: SettingsDialogProps) {
  const { defaultSection = "appearance", ...dialogProps } = props;
-  const { t } = useI18n();
+  const { t } = useI18n();
+  const isAdmin = getStoredAuth()?.system_role === "admin";
  const [activeSection, setActiveSection] =
    useState<SettingsSection>(defaultSection);

@@ -63,7 +67,10 @@ export function SettingsDialog(props: SettingsDialogProps) {
      //   label: t.settings.sections.memory,
      //   icon: BrainIcon,
      // },
-      { id: "tools", label: t.settings.sections.tools, icon: WrenchIcon },
+      { id: "tools", label: t.settings.sections.tools, icon: WrenchIcon },
+      ...(isAdmin
+        ? [{ id: "encoder", label: "本地编码器", icon: CpuIcon }]
+        : []),
      {
        id: "account",
        label: "个人信息",
@@ -75,7 +82,8 @@ export function SettingsDialog(props: SettingsDialogProps) {
      t.settings.sections.appearance,
      t.settings.sections.memory,
      t.settings.sections.tools,
-      t.settings.sections.about,
+      t.settings.sections.about,
+      isAdmin,
    ],
  );
  return (
@@ -125,7 +133,8 @@ export function SettingsDialog(props: SettingsDialogProps) {
                <AppearanceSettingsPage onClose={() => props.onOpenChange?.(false)} />
              )}
              {activeSection === "memory" && <MemorySettingsPage />}
-              {activeSection === "tools" && <ToolSettingsPage />}
+              {activeSection === "tools" && <ToolSettingsPage />}
+              {activeSection === "encoder" && isAdmin && <LocalEncoderSettingsCard />}
              {activeSection === "about" && <AboutSettingsPage />}
            </div>
          </ScrollArea>
@@ -102,9 +102,16 @@ import { cn } from "@/lib/utils";
 import { SettingsSection } from "./settings-section";
 import { SkillStateSheet } from "./skill-state-sheet";

-export function SkillSettingsPage({ onClose }: { onClose?: () => void } = {}) {
-  const { t } = useI18n();
-  return (
+export function SkillSettingsPage({
+  onClose,
+  embedded = false,
+}: {
+  onClose?: () => void;
+  embedded?: boolean;
+} = {}) {
+  const { t } = useI18n();
+  if (embedded) return <SkillSettingsList onClose={onClose} />;
+  return (
    <SettingsSection
      title={t.settings.skills.title}
      description={t.settings.skills.description}
@@ -1,4 +1,4 @@
-import { Database, Loader2, RefreshCw, Search, Sparkles } from "lucide-react";
+import { CheckCircle2, Database, Loader2, RefreshCw, Search, Sparkles } from "lucide-react";
 import { useEffect, useMemo, useState } from "react";
 import { toast } from "sonner";

@@ -8,8 +8,7 @@ import { Checkbox } from "@/components/ui/checkbox";
 import { Input } from "@/components/ui/input";
 import { Progress } from "@/components/ui/progress";
 import { ScrollArea } from "@/components/ui/scroll-area";
-import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select";
-import { useAllSkillsAdmin } from "@/core/skills/hooks";
+import { useAllSkillsAdmin, useSkills } from "@/core/skills/hooks";
 import { useLlmWikiKnowledgeBases, useLlmWikiRuntime } from "@/strategy-components/api/llmwiki";
 import {
  type SkillKnowledgeTarget,
@@ -33,17 +32,29 @@ const PHASE_LABELS: Record<string, string> = {
  completed: "完成",
 };

-export function SkillKnowledgePanel() {
-  const { skills, isLoading } = useAllSkillsAdmin(true);
+const STATUS_LABELS: Record<string, string> = {
+  queued: "等待处理",
+  running: "处理中",
+  awaiting_review: "等待管理员审核",
+  completed: "已完成",
+  partial_failed: "部分失败",
+  failed: "失败",
+  canceled: "已取消",
+};
+
+export function SkillKnowledgePanel({ adminMode = false }: { adminMode?: boolean }) {
+  const visibleSkills = useSkills();
+  const allSkills = useAllSkillsAdmin(adminMode);
+  const skills = adminMode ? allSkills.skills : visibleSkills.skills;
+  const isLoading = adminMode ? allSkills.isLoading : visibleSkills.isLoading;
  const liveSkills = useMemo(() => skills.filter((skill) => (skill.state ?? "active") === "active"), [skills]);
  const [selectedSkills, setSelectedSkills] = useState<string[]>([]);
  const [skillQuery, setSkillQuery] = useState("");
  const [selectedTargetKey, setSelectedTargetKey] = useState<string | null>(null);
-  const [reviewMode, setReviewMode] = useState<"auto_high_confidence" | "off">("off");
  const runtime = useLlmWikiRuntime();
  const knowledgeBases = useLlmWikiKnowledgeBases("all", runtime.data?.provider === "weknora");
-  const bindings = useSkillKnowledgeBindings();
-  const jobs = useSkillKnowledgeJobs();
+  const bindings = useSkillKnowledgeBindings(undefined, !adminMode);
+  const jobs = useSkillKnowledgeJobs(!adminMode);
  const actions = useSkillKnowledgeActions();

  const targets = useMemo<SkillKnowledgeTarget[]>(() => {
@@ -122,7 +133,7 @@ export function SkillKnowledgePanel() {
      const job = await actions.createJob.mutateAsync({
        skill_names: selectedSkills,
        targets: selectedTargets,
-        review_mode: reviewMode,
+        review_mode: "off",
      });
      toast.success(`已创建 ${job.total_count} 个归纳项`);
      setSelectedSkills([]);
@@ -132,17 +143,17 @@ export function SkillKnowledgePanel() {
  };

  return (
-    <div className="grid size-full min-h-0 grid-cols-[minmax(320px,0.9fr)_minmax(420px,1.1fr)] gap-4 overflow-hidden p-6">
+    <div className="grid size-full min-h-0 gap-4 overflow-auto p-4 lg:grid-cols-[minmax(320px,0.9fr)_minmax(420px,1.1fr)] lg:overflow-hidden lg:p-6">
      <section className="flex min-h-0 flex-col rounded-lg border bg-card">
        <div className="border-b p-4">
-          <h2 className="font-semibold">技能到知识库管理</h2>
-          <p className="mt-1 text-xs text-muted-foreground">一次选择多个技能归纳到一个 WeKnora Wiki 知识库；代码与脚本不会被读取。</p>
+          <h2 className="font-semibold">归纳技能知识</h2>
+          <p className="mt-1 text-xs leading-5 text-muted-foreground">选择技能和一个目标知识库后，系统会在后台提取 Markdown 等知识资料，忽略 Python 等代码文件，自动生成 Wiki、关系和向量索引。</p>
        </div>
        <ScrollArea className="min-h-0 flex-1">
          <div className="space-y-5 p-4">
            <div>
              <div className="mb-2 flex items-center justify-between">
-                <span className="text-sm font-medium">1. 选择技能（{selectedSkills.length}）</span>
+                <span className="text-sm font-medium">第一步：选择技能（已选 {selectedSkills.length}）</span>
                <Button variant="ghost" size="sm" onClick={toggleFilteredSkills}>
                  {allFilteredSelected ? "清空当前结果" : "选择当前结果"}
                </Button>
@@ -162,6 +173,13 @@ export function SkillKnowledgePanel() {
                    <Checkbox checked={selectedSkills.includes(skill.name)} onCheckedChange={() => toggle(selectedSkills, skill.name, setSelectedSkills)} />
                    <span className="truncate text-sm">{skill.name_zh || skill.name}</span>
                    <span className="ml-auto truncate text-xs text-muted-foreground">{skill.name}</span>
+                    {(bindings.data ?? []).some((binding) => binding.skill_name === skill.name) && (
+                      <Badge variant="secondary" className="shrink-0 text-[10px]">
+                        {(bindings.data ?? []).some((binding) => binding.skill_name === skill.name && `${binding.target_type}:${binding.target_id}` === selectedTargetKey)
+                          ? "已在目标库"
+                          : `已归纳 ${(bindings.data ?? []).filter((binding) => binding.skill_name === skill.name).length} 库`}
+                      </Badge>
+                    )}
                  </label>
                ))}
                {!isLoading && !filteredSkills.length && (
@@ -174,7 +192,7 @@ export function SkillKnowledgePanel() {
            </div>
            <div>
              <div className="mb-2 flex items-center justify-between">
-                <span className="text-sm font-medium">2. 选择目标知识库（{selectedTargetKey ? 1 : 0}）</span>
+                <span className="text-sm font-medium">第二步：选择一个目标知识库</span>
              </div>
              <div className="space-y-1 rounded-md border p-2">
                {targets.map((target) => {
@@ -187,39 +205,32 @@ export function SkillKnowledgePanel() {
                      />
                      <Database className="size-4 text-muted-foreground" />
                      <span className="text-sm">{target.target_name}</span>
-                      <Badge variant="outline" className="ml-auto text-[10px]">WeKnora Wiki</Badge>
+                      <Badge variant="outline" className="ml-auto text-[10px]">普通 Wiki 库</Badge>
                    </label>
                  );
                })}
                {(runtime.isLoading || knowledgeBases.isLoading) && <Loader2 className="m-4 size-5 animate-spin" />}
                {!runtime.isLoading && !knowledgeBases.isLoading && knowledgeBases.error && (
                  <p className="p-3 text-xs text-destructive">
-                    读取 WeKnora 普通知识库失败：
+                    读取普通知识库失败：
                    {knowledgeBases.error instanceof Error ? knowledgeBases.error.message : String(knowledgeBases.error)}
                  </p>
                )}
                {!runtime.isLoading && !knowledgeBases.isLoading && !knowledgeBases.error && !targets.length && (
                  <p className="p-3 text-xs text-muted-foreground">
                    {runtime.data?.provider !== "weknora"
-                      ? "当前未配置 WeKnora 普通知识库地址；技能需要先归纳到普通知识库，再导入助手知识库。"
+                      ? "当前未配置普通知识库地址；技能需要先归纳到普通知识库，再导入助手知识库。"
                      : "当前没有可写且已开启 Wiki 的普通知识库；请确认该库不是 FAQ/会话沉淀库，并已开启 Wiki。"}
                  </p>
                )}
              </div>
            </div>
-            <div className="flex items-center gap-3">
-              <span className="text-sm font-medium">审核策略</span>
-              <Select value={reviewMode} onValueChange={(value) => setReviewMode(value as typeof reviewMode)}>
-                <SelectTrigger className="w-52"><SelectValue /></SelectTrigger>
-                <SelectContent>
-                  <SelectItem value="auto_high_confidence">高置信自动通过</SelectItem>
-                  <SelectItem value="off">不阻塞写入</SelectItem>
-                </SelectContent>
-              </Select>
+            <div className="rounded-lg border bg-muted/30 p-3 text-xs leading-5 text-muted-foreground">
+              第三步：提交后可离开本页。归纳、Wiki 生成、向量化及同步到“知识梳理”总库均在后台完成。
            </div>
-            <Button className="w-full" disabled={actions.createJob.isPending} onClick={() => void submit()}>
+            <Button className="w-full" disabled={actions.createJob.isPending || !selectedSkills.length || !selectedTargetKey} onClick={() => void submit()}>
              {actions.createJob.isPending ? <Loader2 className="animate-spin" /> : <Sparkles />}
-              开始归纳（{selectedSkills.length * (selectedTargetKey ? 1 : 0)} 项）
+              开始归纳 {selectedSkills.length ? `${selectedSkills.length} 个技能` : ""}
            </Button>
          </div>
        </ScrollArea>
@@ -228,22 +239,26 @@ export function SkillKnowledgePanel() {
      <section className="flex min-h-0 flex-col gap-4 overflow-hidden">
        <div className="flex min-h-0 flex-1 flex-col rounded-lg border bg-card">
          <div className="flex items-center justify-between border-b p-4">
-            <div><h2 className="font-semibold">归纳任务</h2><p className="text-xs text-muted-foreground">后台执行、失败可单项重试</p></div>
+            <div><h2 className="font-semibold">我的归纳任务</h2><p className="text-xs text-muted-foreground">任务会自动刷新，失败项可直接重试</p></div>
            <Button size="icon" variant="ghost" onClick={() => void jobs.refetch()}><RefreshCw className="size-4" /></Button>
          </div>
          <ScrollArea className="min-h-0 flex-1">
            <div className="space-y-3 p-4">
              {(jobs.data ?? []).map((job) => {
-                const done = job.success_count + job.partial_failed_count + job.failed_count;
+                const countedDone = job.success_count + job.partial_failed_count + job.failed_count;
+                const itemDone = (job.items ?? []).filter((item) =>
+                  ["completed", "partial_failed", "failed", "canceled"].includes(item.status),
+                ).length;
+                const done = Math.max(countedDone, itemDone);
                const progress = job.total_count ? Math.round((done / job.total_count) * 100) : 0;
                return (
                  <div key={job.id} className="rounded-md border p-3">
-                    <div className="flex items-center gap-2 text-sm"><Badge variant={job.status === "completed" ? "default" : "secondary"}>{job.status}</Badge><span>{done}/{job.total_count} 项</span><span className="ml-auto text-xs text-muted-foreground">{new Date(job.created_at).toLocaleString()}</span></div>
+                    <div className="flex items-center gap-2 text-sm"><Badge variant={job.status === "completed" ? "default" : "secondary"}>{STATUS_LABELS[job.status] || job.status}</Badge><span>{done}/{job.total_count} 项</span><span className="ml-auto text-xs text-muted-foreground">{new Date(job.created_at).toLocaleString()}</span></div>
                    <Progress className="my-2" value={progress} />
                    {job.items?.map((item) => (
                      <div key={item.id} className="mt-2 flex items-center gap-2 border-t pt-2 text-xs">
                        <span className="max-w-36 truncate font-medium">{item.skill_name}</span>
-                        <span className="text-muted-foreground">{PHASE_LABELS[item.phase] || item.phase}</span>
+                        <span className="text-muted-foreground">{PHASE_LABELS[item.phase] || STATUS_LABELS[item.status] || item.phase}</span>
                        <span className="ml-auto">{item.progress}%</span>
                        {item.status === "failed" && <Button size="sm" variant="outline" onClick={() => actions.retry.mutate(item.id)}>重试</Button>}
                      </div>
@@ -256,8 +271,8 @@ export function SkillKnowledgePanel() {
          </ScrollArea>
        </div>
        <div className="max-h-80 overflow-auto rounded-lg border bg-card p-3 text-xs">
-          <div className="mb-2 text-muted-foreground">当前有效绑定：{bindings.data?.length ?? 0}；同名同类型实体按来源贡献合并。</div>
-          <div className="space-y-2">{bindings.data?.map((binding) => <div key={binding.id} className="flex flex-wrap items-center gap-2 rounded border p-2"><span className="max-w-32 truncate font-medium">{binding.skill_name}</span><span className="max-w-40 truncate text-muted-foreground">→ {binding.target_name}</span><Badge variant="outline">{binding.status}</Badge><code className="max-w-40 truncate text-[10px] text-muted-foreground">{binding.remote_business_key}</code><Button size="sm" variant="outline" className="ml-auto" disabled={actions.resync.isPending} onClick={() => actions.resync.mutate(binding.id)}>重归纳</Button><Button size="sm" variant="ghost" onClick={() => { if (window.confirm("解除关联并保留目标知识内容？")) actions.detach.mutate({ id: binding.id, deleteContributions: false }); }}>解绑并保留</Button><Button size="sm" variant="destructive" onClick={() => { if (window.confirm("解除关联并删除此技能贡献？共享知识仍会保留其他来源。")) actions.detach.mutate({ id: binding.id, deleteContributions: true }); }}>解绑并删除贡献</Button></div>)}</div>
+          <div className="mb-2 flex items-center gap-2 text-muted-foreground"><CheckCircle2 className="size-4 text-emerald-600" />已归纳关联：{bindings.data?.length ?? 0}</div>
+          <div className="space-y-2">{bindings.data?.map((binding) => <div key={binding.id} className="flex flex-wrap items-center gap-2 rounded border p-2"><span className="max-w-40 truncate font-medium">{binding.skill_name}</span><span className="max-w-48 truncate text-muted-foreground">已归纳到 {binding.target_name}</span><Badge variant="outline">{STATUS_LABELS[binding.status] || binding.status}</Badge><Button size="sm" variant="outline" className="ml-auto" disabled={actions.resync.isPending} onClick={() => actions.resync.mutate(binding.id)}>重新归纳</Button><Button size="sm" variant="ghost" onClick={() => { if (window.confirm("解除关联并保留目标知识内容？")) actions.detach.mutate({ id: binding.id, deleteContributions: false }); }}>解除关联</Button>{adminMode && <Button size="sm" variant="destructive" onClick={() => { if (window.confirm("解除关联并删除此技能贡献？共享知识仍会保留其他来源。")) actions.detach.mutate({ id: binding.id, deleteContributions: true }); }}>删除贡献</Button>}</div>)}</div>
        </div>
      </section>
    </div>
@@ -14,7 +14,7 @@ import {
  SidebarMenuItem,
 } from "@/components/ui/sidebar";
 import { useI18n } from "@/core/i18n/hooks";
-import { BookOpen, BotIcon, BrainIcon, FileSearch, Library, ListChecks, MessageSquarePlus, MessagesSquare, PenLine, Plus, SparklesIcon, Telescope, Users } from "lucide-react";
+import { BookOpen, BotIcon, BrainIcon, FileSearch, FileText, Library, ListChecks, MessageSquarePlus, MessagesSquare, PenLine, Plus, SparklesIcon, Telescope, Users } from "lucide-react";

 import { KnowledgeRagToggle } from "./knowledge-rag-toggle";
 import { SidebarCollapseButton } from "./workspace-header";
@@ -108,6 +108,13 @@ export const WORKSPACE_COMPACT_NAV_ITEMS: WorkspaceCompactNavItem[] = [
    match: (pathname) => pathname.startsWith("/page/workspace/deep-research"),
  },
  // {
+  //   id: "workspace-report-collaboration",
+  //   label: "报告协作",
+  //   icon: FileText,
+  //   path: "/page/workspace/report-collaboration",
+  //   match: (pathname) => pathname.startsWith("/page/workspace/report-collaboration"),
+  // },
+  // {
  //   id: "workspace-enterprise-research",
  //   label: "企业深度研究",
  //   icon: FileSearch,
@@ -83,7 +83,7 @@ export function WorkspaceNavMenu() {
  const isAdmin = getStoredAuth()?.system_role === "admin";
  const [settingsOpen, setSettingsOpen] = useState(false);
  const [settingsDefaultSection, setSettingsDefaultSection] = useState<
-    "appearance" | "memory" | "tools" | "about"
+    "appearance" | "memory" | "tools" | "encoder" | "about"
  >("appearance");
  const [notificationOpen, setNotificationOpen] = useState(false);
  const [mounted, setMounted] = useState(false);
@@ -189,6 +189,17 @@ export function WorkspaceNavMenu() {
                    <Settings2Icon />
                    {t.common.settings}
                  </DropdownMenuItem>
+                  {isAdmin && (
+                    <DropdownMenuItem
+                      onClick={() => {
+                        setSettingsDefaultSection("encoder");
+                        setSettingsOpen(true);
+                      }}
+                    >
+                      <CpuIcon />
+                      本地编码器
+                    </DropdownMenuItem>
+                  )}
                  {isAdmin && (
                    <DropdownMenuItem
                      onClick={() =>
@@ -254,14 +265,6 @@ export function WorkspaceNavMenu() {
                      技能管理
                    </DropdownMenuItem>
                  )}
-                  {isAdmin && (
-                    <DropdownMenuItem
-                      onClick={() => navigate("/page/workspace/admin/skills?tab=knowledge")}
-                    >
-                      <DatabaseZapIcon />
-                      技能到知识库管理
-                    </DropdownMenuItem>
-                  )}
                  {isAdmin && (
                    <DropdownMenuItem
                      onClick={() => navigate("/page/workspace/admin/models")}
@@ -7,7 +7,7 @@
 *      ``GET {backend}/taskAnalyseSearch/cop-task-detail?taskId=``（带 DeerFlow 登录态，任务数据
 *      来自 TaskCOP 任务表，即任务列表 / 报告导入用的同一份）。
 *   2. **固定使用内置智能体** ``agentfx-analyst``（后端 seeder ``_agentfx_seed.py`` 启动时补建：
- *      搜集信息 → 生成 report.md + task-reports.json（14 类）→ 总结 → 前端「入库」协助卡 /
+ *      搜集信息 → hits 落盘 → task-report-build 一条命令转换成 14 类 task-reports.json → 写 report.md → 总结 → 前端「入库」协助卡 /
 *      task-report-import 技能入库），不走「配置管理」业务映射。
 *   3. 路由挂在 ``plan-task-agentfx`` 前缀下，页面代码见 [[AgentFxWorkspace]]。
 *
@@ -109,8 +109,8 @@ export interface TaskButton {
  /** 追加的查询参数名（如 ``id`` / ``task_id``）；空则用 ``id``。 */
  idParam: string;
  /**
-   * ``url`` 追加 id 时取任务id 还是行动id。仅 xdfx（行动分析）二者不同：深链原始 ``?taskId=``
-   * 实为行动id，任务id 由 action 接口解析。其它业务两者相同。
+   * ``url`` / ``host`` 追加 id 时取任务id 还是行动id。仅 xdfx（行动分析）二者不同：深链原始
+   * ``?taskId=`` 实为行动id，任务id 由 action 接口解析。其它业务两者相同。
   */
  idKind: TaskButtonIdKind;
  /** ``url`` 外链打开方式：``blank``=新窗口（默认）/ ``self``=当前窗口。仅 ``url`` 类型有意义。 */
@@ -327,7 +327,8 @@ export interface RunTaskButtonCtx {
 * 执行一个跳转按钮：
 *   - ``url``：拼地址（可选追加 ``?id=``，取任务id 或行动id 视 ``idKind``）新标签打开；地址为空提示未配置。
 *   - ``business``：复用深链解析（会按目标业务重绑任务上下文）后 ``navigate``（始终用任务id）。
- *   - ``host``：向 ``window.parent`` 发 ``HOST_NAVIGATE``，由宿主系统跳转（仅 iframe 嵌入时生效）。
+ *   - ``host``：向 ``window.parent`` 发 ``HOST_NAVIGATE``，由宿主系统跳转（仅 iframe 嵌入时生效；
+ *     追加 id 时同样按 ``idKind`` 取任务id / 行动id）。
 */
 export async function runTaskButton(btn: TaskButton, ctx: RunTaskButtonCtx): Promise<void> {
  const fail = (m: string) => ctx.onError?.(m);
@@ -355,9 +356,11 @@ export async function runTaskButton(btn: TaskButton, ctx: RunTaskButtonCtx): Pro
    }
    const queryParams: Record<string, number> = {};
    if (btn.appendTaskId) {
-      const id = parseHostTaskId(ctx.taskId);
+      // 行动分析（xdfx）可选发行动id；与 url 外链同规则：行动id 缺失时回退任务id。
+      const raw = btn.idKind === "action" ? ctx.actionId || ctx.taskId : ctx.taskId;
+      const id = parseHostTaskId(raw);
      if (id === null) {
-        fail("任务id不是数字，无法跳转宿主系统");
+        fail(`${btn.idKind === "action" ? "行动id" : "任务id"}不是数字，无法跳转宿主系统`);
        return;
      }
      queryParams[(btn.idParam || "id").trim() || "id"] = id;
@@ -111,6 +111,28 @@ test("a lone deep-research progress bar still opens its own group", () => {
  assert.deepEqual(types, ["assistant:processing"]);
 });

+test("multi-round RAG assistant rows render even while the final answer is still empty", () => {
+  const types = groupTypes([
+    { type: "human", id: "h1", content: "检索一下", additional_kwargs: { multi_round_rag: true } } as Message,
+    {
+      type: "ai",
+      id: "a1",
+      content: "",
+      additional_kwargs: {
+        multi_round_rag: true,
+        multi_round_rag_trace: {
+          title: "多轮检索思考过程",
+          rounds: [{ id: "r1", title: "思考过程", thoughtMarkdown: "正在拆解问题", query: "", queryShow: true, retrievals: [] }],
+          finalAnswerMarkdown: "",
+          thinkingComplete: false,
+        },
+      },
+    } as Message,
+  ]);
+
+  assert.deepEqual(types, ["human", "assistant"]);
+});
+
 test("tool messages still attach to an open processing group", () => {
  const types = groupTypes([
    {
@@ -28,6 +28,8 @@ interface AssistantResearchApprovalGroup extends GenericMessageGroup<"assistant:

 interface AssistantTaskReportImportGroup extends GenericMessageGroup<"assistant:task-report-import"> {}

+interface AssistantBusinessCardGroup extends GenericMessageGroup<"assistant:business-card"> {}
+
 interface AssistantSubagentGroup extends GenericMessageGroup<"assistant:subagent"> {}

 type MessageGroup =
@@ -41,6 +43,7 @@ type MessageGroup =
  | AssistantSetupReportStructureApprovalGroup
  | AssistantResearchApprovalGroup
  | AssistantTaskReportImportGroup
+  | AssistantBusinessCardGroup
  | AssistantSubagentGroup;

 export function groupMessages<T>(
@@ -65,7 +68,8 @@ export function groupMessages<T>(
      last.type !== "assistant:setup-agent-approval" &&
      last.type !== "assistant:setup-writing-approval" &&
      last.type !== "assistant:setup-report-structure-approval" &&
-      last.type !== "assistant:research-approval"
+      last.type !== "assistant:research-approval" &&
+      last.type !== "assistant:business-card"
    ) {
      return last;
    }
@@ -137,6 +141,16 @@ export function groupMessages<T>(
    }

    if (message.type === "ai") {
+      // Multi-round RAG keeps rounds/retrievals on additional_kwargs while the
+      // visible answer is still empty. The default rule below only opens an
+      // assistant bubble when hasContent() is true, which would swallow the
+      // live thinking cards until the final answer arrives (or forever, if the
+      // turn is think/search-only). Force a normal assistant row so
+      // MessageListItem can render MultiRoundRagAssistantBody immediately.
+      if (message.additional_kwargs?.multi_round_rag === true) {
+        groups.push({ id: message.id, type: "assistant", messages: [message] });
+        continue;
+      }
      // Deep-research interaction card: virtual ai messages injected by the
      // workbench (additional_kwargs.setup_research_approval) render through
      // the host-provided slot. Writing phases use ordinary virtual tool calls
@@ -159,6 +173,17 @@ export function groupMessages<T>(
        });
        continue;
      }
+      // 通用业务卡（报告协作方案组/命令确认/报告入口等）：虚拟 ai 消息
+      // （additional_kwargs.report_collaboration_card），由宿主注入并经
+      // businessCardSlot 渲染；不传插槽的页面零渲染、零行为变化。
+      if (hasBusinessCard(message)) {
+        groups.push({
+          id: message.id,
+          type: "assistant:business-card",
+          messages: [message],
+        });
+        continue;
+      }
      if (hasPresentFiles(message)) {
        groups.push({
          id: message.id,
@@ -487,6 +512,19 @@ export function hasTaskReportImportApproval(message: Message) {
  );
 }

+/**
+ * 通用业务卡（报告协作等页面）：宿主注入的虚拟 ai 消息
+ * （additional_kwargs.report_collaboration_card），经 MessageList 的
+ * businessCardSlot 渲染。集中在此识别，业务卡 payload 结构由各页面自定义。
+ */
+export function hasBusinessCard(message: Message) {
+  return (
+    message.type === "ai" &&
+    typeof message.additional_kwargs?.report_collaboration_card === "object" &&
+    message.additional_kwargs.report_collaboration_card !== null
+  );
+}
+
 export function extractPresentFilesFromMessage(message: Message) {
  if (message.type !== "ai" || !hasPresentFiles(message)) {
    return [];
@@ -0,0 +1,13 @@
+/**
+ * Hash-router entry used by the customized Vite application for the isolated
+ * official-style UI. Keeping this prefix distinct from `/page/*` prevents its
+ * routes and mock state from altering the customized application.
+ */
+export const OFFICIAL_DEERFLOW_ROUTE_PREFIX = "/official";
+
+/** The official-style workspace home shown after a normal login. */
+export const OFFICIAL_DEERFLOW_HOME_ROUTE =
+  `${OFFICIAL_DEERFLOW_ROUTE_PREFIX}/workspace/chats/new`;
+
+/** Existing customized application's normal post-login destination. */
+export const CUSTOMIZED_DEERFLOW_HOME_ROUTE = "/page/workspace/chats/new";
@@ -10,6 +10,7 @@
 import { apiFetch } from "@/core/api/fetch-client";
 import { getBackendBaseURL } from "@/core/config";
 import { OptType, writeYLog } from "@/core/log/y-log";
+import { replaceMermaidFencesForWordExport } from "@/core/utils/mermaid";

 const DOCX_MEDIA_TYPE =
  "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
@@ -38,13 +39,15 @@ export async function markdownToDocxBlob(
  const source = markdown?.trim();
  if (!source) throw new Error("文档内容为空");

+  const prepared = await replaceMermaidFencesForWordExport(source);
  const endpoint = `${getBackendBaseURL()}/api/writing/export/docx`;
  const response = await apiFetch(endpoint, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      title: title?.trim() || undefined,
-      markdown: source,
+      markdown: prepared.markdown,
+      embedded_images: prepared.embeddedImages,
    }),
  });
  if (!response.ok) throw await responseError(response);
@@ -1 +1,2 @@
 export * from "./plugins";
+export * from "./mermaid-png-download";
@@ -0,0 +1,56 @@
+import { useEffect, type RefObject } from "react";
+import { toast } from "sonner";
+
+import { downloadSvgElementAsPng } from "@/core/utils/mermaid";
+
+function findStreamdownMermaidDownloadBlock(target: EventTarget | null): HTMLElement | null {
+  if (!(target instanceof Element)) return null;
+  const button = target.closest("button");
+  if (!(button instanceof HTMLButtonElement)) return null;
+  if (button.getAttribute("title") !== "Download file") return null;
+  const block = button.closest('[data-streamdown="mermaid-block"]');
+  return block instanceof HTMLElement ? block : null;
+}
+
+function findRenderedMermaidChartSvg(block: HTMLElement): SVGSVGElement | null {
+  const fromChart = block.querySelector('[aria-label="Mermaid chart"] svg, [role="img"] svg');
+  if (fromChart instanceof SVGSVGElement && !fromChart.closest("button")) {
+    return fromChart;
+  }
+  for (const svg of block.querySelectorAll("svg")) {
+    if (svg instanceof SVGSVGElement && !svg.closest("button")) {
+      return svg;
+    }
+  }
+  return null;
+}
+
+/** Intercept Streamdown mermaid download buttons and save a PNG of the chart. */
+export function useStreamdownMermaidPngDownload(rootRef: RefObject<HTMLElement | null>) {
+  useEffect(() => {
+    const onClickCapture = (event: MouseEvent) => {
+      const root = rootRef.current;
+      if (!root || !root.contains(event.target as Node)) return;
+      const block = findStreamdownMermaidDownloadBlock(event.target);
+      if (!block) return;
+
+      event.preventDefault();
+      event.stopPropagation();
+      event.stopImmediatePropagation();
+
+      const svg = findRenderedMermaidChartSvg(block);
+      if (!svg) {
+        toast.error("流程图尚未渲染完成，请稍后再下载");
+        return;
+      }
+
+      void downloadSvgElementAsPng(svg, "flowchart.png").catch((error) => {
+        console.error("Failed to download mermaid image:", error);
+        toast.error(error instanceof Error ? error.message : "下载流程图失败");
+      });
+    };
+
+    document.addEventListener("click", onClickCapture, true);
+    return () => document.removeEventListener("click", onClickCapture, true);
+  }, [rootRef]);
+}
@@ -11,6 +11,22 @@ export interface PromptPrefixSettings {

 export type KnowledgeBaseProductVersion = "v1" | "v2";

+export type OrdinaryKnowledgeLanding = "wiki" | "weknora";
+
+export async function loadOrdinaryKnowledgeLanding(): Promise<OrdinaryKnowledgeLanding> {
+  const response = await apiFetch(`${getBackendBaseURL()}/api/system-settings/ordinary-knowledge-landing`);
+  if (!response.ok) throw new Error("无法读取普通知识库默认页面设置");
+  return ((await response.json()) as { mode: OrdinaryKnowledgeLanding }).mode;
+}
+
+export async function saveOrdinaryKnowledgeLanding(mode: OrdinaryKnowledgeLanding): Promise<OrdinaryKnowledgeLanding> {
+  const response = await apiFetch(`${getBackendBaseURL()}/api/system-settings/ordinary-knowledge-landing`, {
+    method: "PUT", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ mode }),
+  });
+  if (!response.ok) throw new Error("保存失败，仅管理员可配置普通知识库默认页面");
+  return ((await response.json()) as { mode: OrdinaryKnowledgeLanding }).mode;
+}
+
 export async function loadKnowledgeBaseProductVersion(): Promise<KnowledgeBaseProductVersion> {
  const response = await apiFetch(
    `${getBackendBaseURL()}/api/system-settings/knowledge-base-product-version`,
@@ -164,19 +164,15 @@ export function useViewMode(
 /**
 * Effective interface layout mode (full chrome vs compact). A user's own choice
 * (persisted in local settings) wins; otherwise the admin-configured system
- * default applies; otherwise `undefined` (callers fall back to the session-level
- * `sidebarEnabled` flag set by portal / yUserId login). `setMode` persists the
- * user's override locally.
+ * default applies; otherwise the built-in default is compact (简洁模式).
+ * `setMode` persists the user's override locally.
 */
-export function useLayoutMode(): [
-  LayoutMode | undefined,
-  (mode: LayoutMode) => void,
-] {
+export function useLayoutMode(): [LayoutMode, (mode: LayoutMode) => void] {
  const [settings, setSettings] = useLocalSettings();
  const { data: appearance } = useAppearanceSettings();
  const userOverride = settings.display.layoutMode;
  const adminDefault = appearance?.default_layout_mode;
-  const mode = userOverride ?? adminDefault;
+  const mode: LayoutMode = userOverride ?? adminDefault ?? "compact";
  const setMode = (next: LayoutMode) =>
    setSettings("display", { layoutMode: next });
  return [mode, setMode];
@@ -1,7 +1,7 @@
 import assert from "node:assert/strict";
 import test from "node:test";

-import { sanitizeMermaidSource } from "./mermaid";
+import { findMermaidFenceMatches, getMermaidImageFileName, sanitizeMermaidSource } from "./mermaid";

 test("inserts a missing arrow before a bare edge label", () => {
  const input = "E --> G|价值输出 V_s| H[PPO 损失]";
@@ -69,3 +69,17 @@ test("repairs the DAC-PPO architecture diagram class block", () => {
  assert.doesNotMatch(output, /class,/);
  assert.doesNotMatch(output, /input,module/);
 });
+
+test("turns mermaid source filenames into png downloads", () => {
+  assert.equal(getMermaidImageFileName("outputs/图2.mmd"), "图2.png");
+  assert.equal(getMermaidImageFileName("chart.mermaid", "png"), "chart.png");
+  assert.equal(getMermaidImageFileName("flowchart.png"), "flowchart.png");
+});
+
+test("finds mermaid fences for Word image replacement", () => {
+  const markdown = "前文\n```mermaid\nflowchart TB\nA-->B\n```\n后文\n```mmd\ngraph LR\nC-->D\n```";
+  const fences = findMermaidFenceMatches(markdown);
+  assert.equal(fences.length, 2);
+  assert.equal(fences[0].source, "flowchart TB\nA-->B");
+  assert.equal(fences[1].source, "graph LR\nC-->D");
+});
@@ -96,12 +96,209 @@ function sanitizeMermaidClassStatements(source: string): string {
  );
 }

+const MERMAID_FILE_EXT = /\.(mmd|mermaid)$/i;
+
 export function isMermaidFile(filepath: string): boolean {
-  return /\.mmd$/i.test(filepath);
+  return MERMAID_FILE_EXT.test(filepath);
 }

-export function getMermaidImageFileName(filepath: string, extension = "svg"): string {
-  return getFileName(filepath).replace(/\.mmd$/i, `.${extension}`);
+export function getMermaidImageFileName(filepath: string, extension = "png"): string {
+  const name = getFileName(filepath) || "mermaid-diagram";
+  if (MERMAID_FILE_EXT.test(name)) {
+    return name.replace(MERMAID_FILE_EXT, `.${extension}`);
+  }
+  if (/\.(svg|png|jpe?g|webp)$/i.test(name)) {
+    return name.replace(/\.(svg|png|jpe?g|webp)$/i, `.${extension}`);
+  }
+  return `${name}.${extension}`;
+}
+
+function triggerBlobDownload(blob: Blob, filename: string): void {
+  const objectUrl = URL.createObjectURL(blob);
+  const a = document.createElement("a");
+  a.href = objectUrl;
+  a.download = filename;
+  a.rel = "noopener";
+  document.body.appendChild(a);
+  a.click();
+  a.remove();
+  window.setTimeout(() => URL.revokeObjectURL(objectUrl), 30_000);
+}
+
+function readPositiveNumber(value: string | null): number | null {
+  if (!value) return null;
+  const parsed = Number.parseFloat(value);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : null;
+}
+
+function getSvgExportSize(svg: SVGSVGElement): { width: number; height: number } {
+  const viewBox = svg.viewBox?.baseVal;
+  if (viewBox && viewBox.width > 0 && viewBox.height > 0) {
+    return { width: viewBox.width, height: viewBox.height };
+  }
+  const attrWidth = readPositiveNumber(svg.getAttribute("width"));
+  const attrHeight = readPositiveNumber(svg.getAttribute("height"));
+  if (attrWidth && attrHeight) {
+    return { width: attrWidth, height: attrHeight };
+  }
+  try {
+    const box = svg.getBBox();
+    if (box.width > 0 && box.height > 0) {
+      return { width: box.width, height: box.height };
+    }
+  } catch {
+    // Detached SVGs may throw on getBBox().
+  }
+  return {
+    width: Math.max(1, svg.clientWidth),
+    height: Math.max(1, svg.clientHeight),
+  };
+}
+
+function serializeSvg(svg: SVGSVGElement): string {
+  const clone = svg.cloneNode(true) as SVGSVGElement;
+  if (!clone.getAttribute("xmlns")) {
+    clone.setAttribute("xmlns", "http://www.w3.org/2000/svg");
+  }
+  if (!clone.getAttribute("xmlns:xlink")) {
+    clone.setAttribute("xmlns:xlink", "http://www.w3.org/1999/xlink");
+  }
+  return new XMLSerializer().serializeToString(clone);
+}
+
+export async function renderSvgElementToPngBlob(svg: SVGSVGElement): Promise<Blob> {
+  const { width, height } = getSvgExportSize(svg);
+  const scale = 2;
+  const markup = serializeSvg(svg);
+  const blob = new Blob([markup], { type: "image/svg+xml;charset=utf-8" });
+  const objectUrl = URL.createObjectURL(blob);
+
+  try {
+    const image = new Image();
+    await new Promise<void>((resolve, reject) => {
+      image.onload = () => resolve();
+      image.onerror = () => reject(new Error("流程图转图片失败"));
+      image.src = objectUrl;
+    });
+
+    const canvas = document.createElement("canvas");
+    canvas.width = Math.max(1, Math.ceil(width * scale));
+    canvas.height = Math.max(1, Math.ceil(height * scale));
+    const context = canvas.getContext("2d");
+    if (!context) {
+      throw new Error("无法创建画布");
+    }
+    context.fillStyle = "#ffffff";
+    context.fillRect(0, 0, canvas.width, canvas.height);
+    context.drawImage(image, 0, 0, canvas.width, canvas.height);
+
+    const png = await new Promise<Blob>((resolve, reject) => {
+      canvas.toBlob(
+        (result) => (result ? resolve(result) : reject(new Error("生成 PNG 失败"))),
+        "image/png",
+      );
+    });
+    return png;
+  } finally {
+    URL.revokeObjectURL(objectUrl);
+  }
+}
+
+export async function downloadSvgElementAsPng(
+  svg: SVGSVGElement,
+  filename: string,
+): Promise<void> {
+  const png = await renderSvgElementToPngBlob(svg);
+  triggerBlobDownload(png, getMermaidImageFileName(filename, "png"));
+}
+
+function blobToBase64(blob: Blob): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.onload = () => {
+      const result = String(reader.result || "");
+      const comma = result.indexOf(",");
+      resolve(comma >= 0 ? result.slice(comma + 1) : result);
+    };
+    reader.onerror = () => reject(new Error("图片编码失败"));
+    reader.readAsDataURL(blob);
+  });
+}
+
+const MERMAID_FENCE_RE = /```(?:mermaid|mmd)[^\n]*\r?\n([\s\S]*?)```/gi;
+
+export function findMermaidFenceMatches(markdown: string): Array<{
+  index: number;
+  length: number;
+  source: string;
+}> {
+  const matches: Array<{ index: number; length: number; source: string }> = [];
+  const matcher = new RegExp(MERMAID_FENCE_RE.source, MERMAID_FENCE_RE.flags);
+  let match: RegExpExecArray | null;
+  while ((match = matcher.exec(markdown)) !== null) {
+    matches.push({
+      index: match.index,
+      length: match[0].length,
+      source: (match[1] ?? "").trim(),
+    });
+  }
+  return matches;
+}
+
+export async function renderMermaidToPngBlob(source: string): Promise<Blob> {
+  const markup = await renderMermaidToSvg(source);
+  const host = document.createElement("div");
+  host.style.position = "fixed";
+  host.style.left = "-10000px";
+  host.style.top = "-10000px";
+  host.style.pointerEvents = "none";
+  host.style.opacity = "0";
+  host.innerHTML = markup;
+  document.body.appendChild(host);
+  try {
+    const svg = host.querySelector("svg");
+    if (!(svg instanceof SVGSVGElement)) {
+      throw new Error("无法生成流程图图片");
+    }
+    return await renderSvgElementToPngBlob(svg);
+  } finally {
+    host.remove();
+  }
+}
+
+export async function replaceMermaidFencesForWordExport(markdown: string): Promise<{
+  markdown: string;
+  embeddedImages: Record<string, string>;
+}> {
+  const fences = findMermaidFenceMatches(markdown);
+  if (fences.length === 0) {
+    return { markdown, embeddedImages: {} };
+  }
+
+  const embeddedImages: Record<string, string> = {};
+  const replacements: Array<{ index: number; length: number; text: string }> = [];
+
+  for (const [offset, fence] of fences.entries()) {
+    if (!fence.source) continue;
+    try {
+      const png = await renderMermaidToPngBlob(fence.source);
+      const id = `mermaid-${offset + 1}`;
+      embeddedImages[id] = await blobToBase64(png);
+      replacements.push({
+        index: fence.index,
+        length: fence.length,
+        text: `\n![流程图](embedded:${id})\n`,
+      });
+    } catch (error) {
+      console.error("Failed to render mermaid for Word export:", error);
+    }
+  }
+
+  let next = markdown;
+  for (const piece of replacements.sort((left, right) => right.index - left.index)) {
+    next = `${next.slice(0, piece.index)}${piece.text}${next.slice(piece.index + piece.length)}`;
+  }
+  return { markdown: next, embeddedImages };
 }

 async function getMermaidModule() {
@@ -152,15 +349,6 @@ export async function openMermaidSvgInNewTab(source: string): Promise<void> {
 }

 export async function downloadMermaidSvgFile(source: string, filepath: string): Promise<void> {
-  const svg = await renderMermaidToSvg(source);
-  const blob = new Blob([svg], { type: "image/svg+xml;charset=utf-8" });
-  const objectUrl = URL.createObjectURL(blob);
-  const a = document.createElement("a");
-  a.href = objectUrl;
-  a.download = getMermaidImageFileName(filepath);
-  a.rel = "noopener";
-  document.body.appendChild(a);
-  a.click();
-  a.remove();
-  window.setTimeout(() => URL.revokeObjectURL(objectUrl), 30_000);
+  const png = await renderMermaidToPngBlob(source);
+  triggerBlobDownload(png, getMermaidImageFileName(filepath, "png"));
 }
@@ -31,6 +31,7 @@ import {
  syncPositionOptionsFromRoles,
 } from "@/position-roundtable/lib/positions";
 import type { DraftStep3SummarySnapshot } from "@/roundtable-planning/api/drafts";
+import { EIGHTBF_INTENT_AGENT_ID } from "@/roundtable-planning/api/intent";
 import type { ThreadIdMap } from "@/roundtable-planning/api/multi-agent";
 import "@/position-roundtable/styles/intent-understanding.css";
 import type { Step1PanelProps } from "@/roundtable-planning/components/Step1Panel";
@@ -96,6 +97,8 @@ export function EightBfStep1Panel({
 }: EightBfStep1PanelProps) {
  const [rightPanelOpen, setRightPanelOpen] = useState(true);
  const [rightTab, setRightTab] = useState<"agents" | "results">("agents");
+  // 第一步内置任务理解智能体：其「常用问题」显示在输入框左上角，点击直接发送。
+  const { agent: intentAgent } = useAgent(EIGHTBF_INTENT_AGENT_ID);

  const openPanel = (tab: "agents" | "results") => {
    if (rightPanelOpen && rightTab === tab) {
@@ -167,6 +170,8 @@ export function EightBfStep1Panel({
            modelOptions={modelOptions}
            selectedModel={selectedModel}
            onSelectedModelChange={onSelectedModelChange}
+            commonQuestions={intentAgent?.common_questions ?? null}
+            sendCommonQuestionOnClick
          />
        )}
        intentReady={intentReady}
@@ -331,8 +336,26 @@ function EightBfAgentWorkspace({
    summaryReport: step3Summary,
  });

+  // 第一步绑定的内置任务理解智能体：不在业务链席位里，固定置顶展示，
+  // 供管理员在本面板查看 / 配置其提示词与常用问题。
+  const intentAgent = useMemo(
+    () => agents.find((agent) => agent.id === EIGHTBF_INTENT_AGENT_ID) ?? null,
+    [agents],
+  );
+  const intentAgentMatchesKeyword = useMemo(() => {
+    const keyword = agentKeyword.trim().toLowerCase();
+    if (!keyword) return true;
+    const name = (intentAgent?.name || "8BF 任务理解").toLowerCase();
+    const description = (intentAgent?.description || "").toLowerCase();
+    return name.includes(keyword) || description.includes(keyword);
+  }, [agentKeyword, intentAgent]);
+
  useEffect(() => {
-    if (selectedAgentId && !seats.some((seat) => seat.agent_id === selectedAgentId)) {
+    if (
+      selectedAgentId &&
+      selectedAgentId !== EIGHTBF_INTENT_AGENT_ID &&
+      !seats.some((seat) => seat.agent_id === selectedAgentId)
+    ) {
      setSelectedAgentId(null);
    }
  }, [seats, selectedAgentId]);
@@ -412,7 +435,12 @@ function EightBfAgentWorkspace({
          ) : (
            <AgentDetailPanel
              agent={selectedAgent}
-              agentName={selectedAgent?.name ?? selectedSeat?.name ?? ""}
+              agentName={
+                selectedAgent?.name
+                ?? (selectedAgentId === EIGHTBF_INTENT_AGENT_ID
+                  ? "8BF 任务理解"
+                  : selectedSeat?.name ?? "")
+              }
              onAskQuestion={() => toast.info("请在中间对话区向任务理解智能体发起问题")}
              showRecentChats={false}
              avatarSrc={agentConfigLogo}
@@ -468,7 +496,7 @@ function EightBfAgentWorkspace({
        </header>
        {isLoading && seats.length > 0 ? (
          <div className="eightbf-roundtable__agent-selector-empty">正在加载智能体…</div>
-        ) : filteredSeatAgents.length === 0 ? (
+        ) : filteredSeatAgents.length === 0 && !intentAgentMatchesKeyword ? (
          <div className="eightbf-roundtable__agent-selector-empty">
            <p>{seatAgents.length ? "没有符合条件的智能体" : "当前岗位尚未配置智能体"}</p>
            {!seatAgents.length && canConfigureChain && (
@@ -477,6 +505,13 @@ function EightBfAgentWorkspace({
          </div>
        ) : (
          <div className="eightbf-roundtable__agent-selector-list">
+            {intentAgentMatchesKeyword && (
+              <EightBfAgentCard
+                name={intentAgent?.name || "8BF 任务理解"}
+                description={intentAgent?.description || "第一步「意图识别」的内置任务理解智能体"}
+                onSelect={() => setSelectedAgentId(EIGHTBF_INTENT_AGENT_ID)}
+              />
+            )}
            {filteredSeatAgents.map(({ seat, agent }) => (
              <EightBfAgentRow
                key={seat.agent_id}
@@ -503,6 +538,19 @@ function EightBfAgentRow({
 }) {
  const name = agent?.name || seat.name || "未命名智能体";
  const description = agent?.description || seat.description || "智能体助手";
+  return <EightBfAgentCard name={name} description={description} onSelect={onSelect} />;
+}
+
+/** 智能体列表卡片：席位智能体与置顶的内置任务理解智能体共用同一展示结构。 */
+function EightBfAgentCard({
+  name,
+  description,
+  onSelect,
+}: {
+  name: string;
+  description: string;
+  onSelect: () => void;
+}) {
  const avatarText = firstAgentAvatarChar(name);
  return (
    <button type="button" className="eightbf-roundtable__agent-selector-card" onClick={onSelect}>
@@ -3,6 +3,7 @@ import { useSearchParams } from "react-router-dom";
 import { Loader2, Save, X } from "lucide-react";

 import { getAccountDisplayName, getStoredAuth } from "@/core/auth";
+import { EIGHTBF_INTENT_AGENT_ID } from "@/roundtable-planning/api/intent";
 import { EightBfTaskCard } from "@/eightbf-roundtable/components/EightBfTaskCard";
 import {
  EightBfStep1Panel,
@@ -76,6 +77,9 @@ export default function EightBfRoundtablePage({ compactChrome = false }: { compa
  const [selectedChainId, setSelectedChainId] = useState("");
  const [isSaving, setIsSaving] = useState(false);
  const [error, setError] = useState<string | null>(null);
+  // 第二步「人工干预」：开启后每走一步暂停等待用户输入；关闭自动推进。会话内状态，
+  // 新建会话 / 刷新后回到默认关闭（与现状一致）。
+  const [step2Intervention, setStep2Intervention] = useState(false);
  const configuredChain = useMemo(
    () => chains.find((chain) => chain.id === mapping?.chainId) ?? null,
    [chains, mapping?.chainId],
@@ -260,6 +264,12 @@ export default function EightBfRoundtablePage({ compactChrome = false }: { compa
      // 无 taskId 进入时每次都开全新会话（不回显 anonymous 键下的最新草稿）；带 taskId 保持回显现状。
      skipInitialDraftRestore={!taskId}
      taskContext={taskContext as Record<string, unknown> | null}
+      // 第一步绑定 8BF 专属内置意图智能体（roundtable-intent 的同源复制，
+      // 提示词独立可调优），不再与通用多智能体会商共用一个 SOUL。
+      intentAgentId={EIGHTBF_INTENT_AGENT_ID}
+      // 页头「人工干预」开关：控制第二步是否每步暂停等待用户输入。
+      step2InterventionEnabled={step2Intervention}
+      onStep2InterventionChange={setStep2Intervention}
      entryRailTaskId={taskId || null}
      entryRailTaskCardSlot={taskId ? (
        <EightBfTaskCard
@@ -41,6 +41,13 @@ export const env = {
   * flag so operations can switch the shell without rebuilding the frontend.
   */
  FORCE_COLLAPSED_SIDEBAR: readRuntimeFlag("VITE_FORCE_COLLAPSED_SIDEBAR"),
+  /**
+   * Development-only default entry switch for the isolated Vite-native
+   * official-style workspace. It never starts or embeds a Next.js app.
+   */
+  USE_OFFICIAL_DEERFLOW_ENTRY: readRuntimeFlag(
+    "VITE_USE_OFFICIAL_DEERFLOW_ENTRY",
+  ),
  /**
   * Compact-menu variant for this website. Pair with the admin 简介模式
   * type (A / B) so two deployments can show different left-nav items.
@@ -0,0 +1,4 @@
+/** Neutral product terminology for system messages; never apply to knowledge content or API identifiers. */
+export function userFacingKnowledgeMessage(value: string): string {
+  return value.replace(/weknora/gi, "知识服务");
+}
@@ -3,7 +3,6 @@
 import {
  ChevronLeftIcon,
  ChevronRightIcon,
-  DatabaseZap,
  Replace,
  SearchIcon,
  SparklesIcon,
@@ -20,7 +19,6 @@ import {
  WorkspaceHeader,
 } from "@/components/workspace/workspace-container";
 import { SkillRow } from "@/components/workspace/settings/skill-settings-page";
-import { SkillKnowledgePanel } from "@/components/workspace/skills/SkillKnowledgePanel";
 import { getStoredAuth } from "@/core/auth";
 import { useAllSkillsAdmin } from "@/core/skills/hooks";
 import { desensitize } from "@/lib/desensitize";
@@ -37,7 +35,7 @@ export default function AdminSkillsPage() {
  const knowledgeBindings = useSkillKnowledgeBindings();
  const activeTab = useMemo(() => {
    const tab = searchParams.get("tab");
-    return tab === "addresses" || tab === "knowledge" ? tab : "skills";
+    return tab === "addresses" ? tab : "skills";
  }, [searchParams]);

  const changeTab = (value: string) => {
@@ -89,10 +87,6 @@ export default function AdminSkillsPage() {
                  <Replace />
                  技能地址管理
                </TabsTrigger>
-                <TabsTrigger value="knowledge">
-                  <DatabaseZap />
-                  技能到知识库管理
-                </TabsTrigger>
              </TabsList>
            </div>
          </div>
@@ -189,12 +183,6 @@ export default function AdminSkillsPage() {
          >
            <SkillAddressesPanel />
          </TabsContent>
-          <TabsContent
-            value="knowledge"
-            className="mt-0 min-h-0 flex-1 overflow-hidden"
-          >
-            <SkillKnowledgePanel />
-          </TabsContent>
        </Tabs>
      </WorkspaceBody>
    </WorkspaceContainer>
@@ -12,6 +12,7 @@ import { useParams, useRouter } from "next/navigation";
 import { useLocation } from "react-router-dom";
 import { useRouteBase } from "@/core/route-base";
 import { useCallback, useEffect, useMemo, useRef, useState, type ReactNode } from "react";
+import { useQuery } from "@tanstack/react-query";

 import type { PromptInputMessage } from "@/components/ai-elements/prompt-input";
 import { Button } from "@/components/ui/button";
@@ -25,6 +26,7 @@ import {
 } from "@/components/workspace/agents/agent-guide";
 import { AgentWelcome } from "@/components/workspace/agent-welcome";
 import { ArtifactTrigger } from "@/components/workspace/artifacts";
+import { listThreadArtifacts } from "@/core/artifacts/listing";
 import { ChatBox, useThreadChat } from "@/components/workspace/chats";
 import { ExportTrigger } from "@/components/workspace/export-trigger";
 import { InputBox } from "@/components/workspace/input-box";
@@ -98,6 +100,14 @@ const PAGE_REPORT_DESIGNER_AGENT_ID = "page-report-designer";
 const RWFX_SQ_REPORT_CONTEXT_MAX_CHARS = 12000;
 const RWFX_SQ_REPORT_CONTEXT_TAIL_CHARS = 2000;

+function isTaskReportsJsonPath(path: string | undefined): boolean {
+  const normalized = (path ?? "").replace(/\\/g, "/");
+  return (
+    normalized === "task-reports.json" ||
+    normalized.endsWith("/task-reports.json")
+  );
+}
+
 function readPendingKnowledgeSelection(agentId: string | undefined): string[] | null {
  if (typeof window === "undefined" || !agentId) return null;
  try {
@@ -557,9 +567,11 @@ export default function AgentChatPage({
  // ── agentfx「入库」协助卡 ──────────────────────────────────────────────────
  // 任务工作区（taskBind）里，内置研判智能体写出的 task-reports.json 产物落地且
  // 本轮流式结束后，向消息流尾部注入「是否入库」卡片。本地沙箱下 artifacts 可能
-  // 记录宿主真实路径，按文件名匹配（虚拟/宿主路径都命中）。任务已有详情**不抑制**
-  // 卡片（入库是整体替换，由卡片文案说明覆盖语义）；已导入按 thread 记忆在
-  // sessionStorage（刷新后不再重复询问）、「暂不入库」为本次会话内记忆。
+  // 记录宿主真实路径，按文件名匹配（虚拟/宿主路径都命中）。转换脚本已函数合并
+  // 写出该文件，即使模型中断、没跑 present_files，也再扫一遍 outputs 目录。
+  // 任务已有详情**不抑制**卡片（入库是整体替换，由卡片文案说明覆盖语义）；
+  // 已导入按 thread 记忆在 sessionStorage（刷新后不再重复询问）、
+  // 「暂不入库」为本次会话内记忆。
  const reportImportSessionKey = threadId
    ? `agentfx.reportImport.done.${threadId}`
    : "";
@@ -572,9 +584,19 @@ export default function AgentChatPage({
    }
  });
  const [reportImportDismissed, setReportImportDismissed] = useState(false);
-  const reportJsonArtifactReady = (thread.values.artifacts ?? []).some((path) =>
-    path.replace(/\\/g, "/").endsWith("/task-reports.json"),
-  );
+  const listedReportJsonQuery = useQuery({
+    queryKey: ["agentfx-task-reports", threadId],
+    queryFn: ({ signal }) => listThreadArtifacts(threadId, signal),
+    enabled: Boolean(
+      taskBind && !taskGate && threadId && threadId !== "new" && !thread.isLoading,
+    ),
+    retry: false,
+  });
+  const reportJsonArtifactReady =
+    (thread.values.artifacts ?? []).some(isTaskReportsJsonPath) ||
+    (listedReportJsonQuery.data?.files ?? []).some((file) =>
+      isTaskReportsJsonPath(file.path) || file.name === "task-reports.json",
+    );
  const showReportImportCard =
    taskBind &&
    !taskGate &&
@@ -1,11 +1,14 @@
+import { userFacingKnowledgeMessage } from "@/lib/knowledge-message";
 import {
  ArrowLeft,
  BookOpenText,
  Database,
+  Edit3,
  Loader2,
  Plus,
  RefreshCw,
  Search,
+  Trash2,
  Upload,
 } from "lucide-react";
 import { useEffect, useMemo, useRef, useState } from "react";
@@ -17,12 +20,14 @@ import { Button } from "@/components/ui/button";
 import {
  Dialog,
  DialogContent,
+  DialogDescription,
+  DialogFooter,
  DialogHeader,
  DialogTitle,
-  DialogFooter,
 } from "@/components/ui/dialog";
 import { Input } from "@/components/ui/input";
 import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
+import { Textarea } from "@/components/ui/textarea";
 import { KnowledgeProductNav } from "@/components/workspace/knowledge-product-nav";
 import { getStoredAuth } from "@/core/auth";
 import { buildAppHashUrl } from "@/core/llmwiki/source-links";
@@ -33,6 +38,7 @@ import {
  useAssistantKnowledgeBases,
  useAssistantKnowledgeSources,
  useAssistantWikiPages,
+  type AssistantKnowledgeBase,
 } from "@/strategy-components/api/assistant-knowledge";
 import {
  WikiLibraryReader,
@@ -53,6 +59,8 @@ export default function AssistantKnowledgePage() {
  const client = useQueryClient();
  const [tab, setTab] = useState("wiki");
  const [createOpen, setCreateOpen] = useState(false);
+  const [editingBase, setEditingBase] =
+    useState<AssistantKnowledgeBase | null>(null);
  const [name, setName] = useState("");
  const [query, setQuery] = useState("");
  const [searching, setSearching] = useState(false);
@@ -60,6 +68,7 @@ export default function AssistantKnowledgePage() {
    ReturnType<typeof searchAssistantWiki>
  > | null>(null);
  const upload = useRef<HTMLInputElement>(null);
+  const documentUpload = useRef<HTMLInputElement>(null);
  const base = bases.data?.find((b) => b.id === baseId);
  const libraryPages = useMemo<LibraryWikiPage[]>(
    () =>
@@ -124,6 +133,25 @@ export default function AssistantKnowledgePage() {
  };
  const refresh = () =>
    void client.invalidateQueries({ queryKey: ["assistant-knowledge"] });
+  const removeBase = async (target: AssistantKnowledgeBase) => {
+    if (target.is_global) {
+      toast.error("知识梳理总库承担全库沉淀，不能删除");
+      return;
+    }
+    if (
+      !window.confirm(
+        `确定删除助手知识库“${target.name}”吗？库内 Wiki、向量、实体、关系和导入记录都会删除。`,
+      )
+    )
+      return;
+    try {
+      await actions.deleteBase.mutateAsync(target.id);
+      if (baseId === target.id) setParams({});
+      toast.success("助手知识库已删除");
+    } catch (error) {
+      toast.error((error as Error).message);
+    }
+  };
  return (
    <div className="flex size-full min-h-0 flex-col bg-background">
      <KnowledgeProductNav />
@@ -133,8 +161,7 @@ export default function AssistantKnowledgePage() {
            <div>
              <h1 className="text-2xl font-semibold">助手知识库</h1>
              <p className="mt-2 text-sm text-muted-foreground">
-                浏览分类
-                Wiki、关联知识与来源。普通知识库向量化完成后自动沉淀到知识梳理。
+                选择或新建知识库，上传文档后自动生成分类 Wiki、关联知识和向量索引。可独立使用，也可导入 普通知识库数据包；各库知识汇入知识梳理总库。
              </p>
            </div>
            {isAdmin && (
@@ -150,34 +177,69 @@ export default function AssistantKnowledgePage() {
          )}
          <div className="grid gap-5 md:grid-cols-2 xl:grid-cols-3">
            {bases.data?.map((b) => (
-              <button
+              <div
                key={b.id}
-                onClick={() => setParams({ base_id: b.id })}
-                className="group rounded-2xl border bg-card p-6 text-left shadow-sm transition hover:border-primary/40 hover:shadow-md"
+                className="group overflow-hidden rounded-2xl border bg-card text-left shadow-sm transition hover:border-primary/40 hover:shadow-md"
              >
-                <div className="mb-5 flex items-center justify-between">
-                  <div className="rounded-xl bg-emerald-100 p-3 text-emerald-700 dark:bg-emerald-950">
-                    <Database className="size-6" />
+                <button
+                  type="button"
+                  onClick={() => setParams({ base_id: b.id })}
+                  className="w-full p-6 text-left"
+                >
+                  <div className="mb-5 flex items-center justify-between">
+                    <div className="rounded-xl bg-emerald-100 p-3 text-emerald-700 dark:bg-emerald-950">
+                      <Database className="size-6" />
+                    </div>
+                    {b.is_global && (
+                      <Badge variant="secondary">全库知识梳理</Badge>
+                    )}
                  </div>
-                  {b.is_global && (
-                    <Badge variant="secondary">全库知识梳理</Badge>
-                  )}
-                </div>
-                <h2 className="text-lg font-semibold group-hover:text-primary">
-                  {b.name}
-                </h2>
-                <p className="mt-2 line-clamp-2 min-h-10 text-sm text-muted-foreground">
-                  {b.is_global
-                    ? "汇聚普通知识库的分析成果，保留分类、标签和知识关联。"
-                    : b.description ||
-                      "独立的 Wiki 知识空间，支持导入、导出与向量检索。"}
-                </p>
-                <div className="mt-6 flex gap-5 text-xs text-muted-foreground">
-                  <span>{b.page_count || 0} Wiki</span>
-                  <span>{b.source_count || 0} 来源</span>
-                  <span>{b.relation_count || 0} 关系</span>
-                </div>
-              </button>
+                  <h2 className="text-lg font-semibold group-hover:text-primary">
+                    {b.name}
+                  </h2>
+                  <p className="mt-2 line-clamp-2 min-h-10 text-sm text-muted-foreground">
+                    {b.description ||
+                      (b.is_global
+                        ? "汇聚普通知识库的分析成果，保留分类、标签和知识关联。"
+                        : "独立的 Wiki 知识空间，支持导入、导出与向量检索。")}
+                  </p>
+                  <div className="mt-6 flex gap-5 text-xs text-muted-foreground">
+                    <span>{b.page_count || 0} Wiki</span>
+                    <span>{b.source_count || 0} 来源</span>
+                    <span>{b.relation_count || 0} 关系</span>
+                  </div>
+                </button>
+                {isAdmin && (
+                  <div className="flex items-center gap-2 border-t bg-muted/20 px-6 py-3">
+                    <Button
+                      size="sm"
+                      variant="outline"
+                      disabled={actions.updateBase.isPending}
+                      onClick={() => setEditingBase(b)}
+                    >
+                      <Edit3 className="mr-2 size-4" />
+                      编辑
+                    </Button>
+                    {!b.is_global && (
+                      <Button
+                        size="sm"
+                        variant="ghost"
+                        className="ml-auto text-destructive hover:bg-destructive/10 hover:text-destructive"
+                        disabled={actions.deleteBase.isPending}
+                        onClick={() => void removeBase(b)}
+                      >
+                        <Trash2 className="mr-2 size-4" />
+                        删除
+                      </Button>
+                    )}
+                    {b.is_global && (
+                      <span className="ml-auto text-xs text-muted-foreground">
+                        系统大库不可删除
+                      </span>
+                    )}
+                  </div>
+                )}
+              </div>
            ))}
          </div>
          {!bases.isLoading && !bases.data?.length && isAdmin && (
@@ -222,6 +284,35 @@ export default function AssistantKnowledgePage() {
                <RefreshCw className="mr-2 size-4" />
                刷新
              </Button>
+              {isAdmin && (
+                <Button
+                  variant="outline"
+                  size="sm"
+                  disabled={!base || actions.updateBase.isPending}
+                  onClick={() => base && setEditingBase(base)}
+                >
+                  <Edit3 className="mr-2 size-4" />
+                  编辑
+                </Button>
+              )}
+              {isAdmin && base && !base.is_global && (
+                <Button
+                  variant="outline"
+                  size="sm"
+                  className="text-destructive hover:bg-destructive/10 hover:text-destructive"
+                  disabled={actions.deleteBase.isPending}
+                  onClick={() => void removeBase(base)}
+                >
+                  <Trash2 className="mr-2 size-4" />
+                  删除
+                </Button>
+              )}
+              {isAdmin && (
+                <Button size="sm" disabled={actions.uploadDocument.isPending} onClick={() => documentUpload.current?.click()}>
+                  {actions.uploadDocument.isPending ? <Loader2 className="mr-2 size-4 animate-spin" /> : <Upload className="mr-2 size-4" />}
+                  上传文件生成 Wiki
+                </Button>
+              )}
              {isAdmin && (
                <Button
                  variant="outline"
@@ -230,10 +321,23 @@ export default function AssistantKnowledgePage() {
                  onClick={() => upload.current?.click()}
                >
                  <Upload className="mr-2 size-4" />
-                  导入数据包
+                  导入 普通知识库数据包
                </Button>
              )}
            </div>
+            <input ref={documentUpload} type="file" multiple accept=".md,.markdown,.txt,.csv,.pdf,.doc,.docx,.xls,.xlsx,.ppt,.pptx,.odt,.ods,.odp" className="hidden"
+              onChange={async (event) => {
+                const files = Array.from(event.target.files || []);
+                event.target.value = "";
+                setTab("transfer");
+                for (const file of files) {
+                  if (file.size > 100 * 1024 * 1024) { toast.error(`${file.name} 超过 100 MB，请拆分后上传`); continue; }
+                  try {
+                    await actions.uploadDocument.mutateAsync({ file, assistantBaseId: baseId });
+                    toast.success(`${file.name} 已上传，后台正在解析、生成 Wiki 并向量化`);
+                  } catch (error) { toast.error(`${file.name}：${(error as Error).message}`); }
+                }
+              }} />
            <input
              ref={upload}
              type="file"
@@ -265,7 +369,7 @@ export default function AssistantKnowledgePage() {
                <TabsTrigger value="wiki">
                  Wiki（{base?.page_count || 0}）
                </TabsTrigger>
-                <TabsTrigger value="search">向量检索</TabsTrigger>
+                <TabsTrigger value="search">知识检索</TabsTrigger>
                <TabsTrigger value="sources">来源与同步</TabsTrigger>
                {isAdmin && (
                  <TabsTrigger value="transfer">导入 / 导出记录</TabsTrigger>
@@ -274,6 +378,7 @@ export default function AssistantKnowledgePage() {
            </div>
            <TabsContent value="wiki" className="mt-0 flex min-h-0 flex-1">
              <WikiLibraryReader
+                key={baseId}
                pages={libraryPages}
                activePage={active}
                onNavigate={navigatePage}
@@ -285,6 +390,7 @@ export default function AssistantKnowledgePage() {
                mappingId={
                  active?.origins?.find((o) => o.mapping_id)?.mapping_id
                }
+                initiallyCollapseTree
              />
            </TabsContent>
            <TabsContent value="search" className="overflow-auto p-6">
@@ -310,26 +416,36 @@ export default function AssistantKnowledgePage() {
                <>
                  <Badge variant="outline">
                    {searchResult.retrieval_mode === "vector"
-                      ? "向量检索 · 余弦相似度"
+                      ? "知识正文 / 片段 · 向量检索"
                      : searchResult.retrieval_mode === "empty"
                        ? "没有匹配结果"
-                        : "关键词检索（暂无匹配模型的向量）"}
+                        : "知识正文 / 片段 · 关键词检索（暂无匹配模型的向量）"}
                  </Badge>
                  <div className="mt-4 space-y-3">
                    {searchResult.results.map((p) => (
                      <button
                        key={p.id}
-                        onClick={() => navigatePage(p.slug)}
-                        className="block w-full max-w-4xl rounded-xl border p-5 text-left hover:bg-muted"
+                        type="button"
+                        onClick={() => {
+                          if (p.page_type !== "chunk") navigatePage(p.slug);
+                        }}
+                        className={`block w-full max-w-4xl rounded-xl border p-5 text-left ${p.page_type === "chunk" ? "cursor-default" : "hover:bg-muted"}`}
                      >
                        <div className="font-medium">
                          {p.title}
+                          {p.page_type === "chunk" && (
+                            <Badge variant="secondary" className="ml-2">
+                              知识片段
+                            </Badge>
+                          )}
                          <span className="float-right text-xs text-muted-foreground">
                            {p.score?.toFixed(4)}
                          </span>
                        </div>
                        <p className="mt-2 line-clamp-3 text-sm text-muted-foreground">
-                          {p.summary || p.content_markdown}
+                          {p.matched_section?.content ||
+                            p.matched_content ||
+                            p.content_markdown}
                        </p>
                      </button>
                    ))}
@@ -345,7 +461,8 @@ export default function AssistantKnowledgePage() {
                    <p className="mt-2 text-xs text-muted-foreground">
                      上次同步：{new Date(s.updated_at).toLocaleString()}
                    </p>
-                    {isAdmin && (
+                    {s.source_type === "file" && <p className="mt-2 text-xs text-muted-foreground">本地上传文档 · 处理进度及重试请查看导入记录</p>}
+                    {isAdmin && s.source_type === "weknora" && (
                      <Button
                        className="mt-4"
                        size="sm"
@@ -373,8 +490,10 @@ export default function AssistantKnowledgePage() {
              >
                <WikiPackageTransfers id={baseId} assistant />
                <h2 className="text-base font-semibold">导入与同步记录</h2>
+                <p className="text-sm text-muted-foreground">可直接上传文档，独立生成 Wiki 并进行向量检索，无需配置普通知识库服务。支持 PDF、Word、Excel、PowerPoint、Markdown、TXT、CSV，单文件最大 100 MB。生成失败时可配置语言模型或编码器后重试。</p>
                {jobs.data?.map((j) => (
                  <div key={j.id} className="rounded-xl border p-4">
+                    <p className="mb-2 font-medium">{sources.data?.find((source) => source.id === j.source_id)?.source_name || (j.trigger === "local_file_upload" ? "上传文档" : "知识数据同步")}</p>
                    <div className="flex items-center gap-3">
                      <Badge variant="outline">
                        {{
@@ -388,6 +507,9 @@ export default function AssistantKnowledgePage() {
                        {new Date(j.created_at).toLocaleString()}
                      </span>
                    </div>
+                    <p className="mt-2 text-sm text-muted-foreground">{({ uploading: "接收文件", parsing: "解析文档", generating_wiki: "生成 Wiki", vectorizing: "正文向量化", importing: "保存知识并同步总库", queued: "等待处理", interrupted: "处理已中断" } as Record<string, string>)[j.phase] || j.phase}</p>
+                    {j.counts?.parts_total > 0 && <p className="text-xs text-muted-foreground">文档分段：{j.counts.parts_done || 0} / {j.counts.parts_total}</p>}
+                    {j.counts?.vectors_total > 0 && <p className="text-xs text-muted-foreground">向量化：{j.counts.vectors || 0} / {j.counts.vectors_total}</p>}
                    <p className="mt-3 text-sm">
                      {j.counts?.wiki_pages || 0} Wiki ·{" "}
                      {j.counts?.vectors || 0} 向量 · {j.counts?.entities || 0}{" "}
@@ -395,9 +517,15 @@ export default function AssistantKnowledgePage() {
                    </p>
                    {j.last_error_message && (
                      <p className="mt-2 text-sm text-destructive">
-                        {j.last_error_message}
+                        {userFacingKnowledgeMessage(j.last_error_message)}
                      </p>
                    )}
+                    {j.trigger === "local_file_upload" && j.status !== "completed" && (
+                      <Button className="mt-2" size="sm" variant="outline" disabled={actions.retryDocument.isPending} onClick={async () => {
+                        try { await actions.retryDocument.mutateAsync(j.id); toast.success("已继续处理，复用已有解析和向量结果"); }
+                        catch (error) { toast.error((error as Error).message); }
+                      }}>重试 / 恢复处理</Button>
+                    )}
                  </div>
                ))}
              </TabsContent>
@@ -425,6 +553,111 @@ export default function AssistantKnowledgePage() {
          </DialogFooter>
        </DialogContent>
      </Dialog>
+      {editingBase && (
+        <EditAssistantBaseDialog
+          key={editingBase.id}
+          base={editingBase}
+          pending={actions.updateBase.isPending}
+          onClose={() => setEditingBase(null)}
+          onSave={async (input) => {
+            try {
+              await actions.updateBase.mutateAsync({
+                id: editingBase.id,
+                ...input,
+              });
+              setEditingBase(null);
+              toast.success("助手知识库信息已保存");
+            } catch (error) {
+              toast.error((error as Error).message);
+            }
+          }}
+        />
+      )}
    </div>
  );
 }
+
+function EditAssistantBaseDialog({
+  base,
+  pending,
+  onClose,
+  onSave,
+}: {
+  base: AssistantKnowledgeBase;
+  pending: boolean;
+  onClose: () => void;
+  onSave: (input: { name: string; description: string }) => Promise<void>;
+}) {
+  const [name, setName] = useState(base.name);
+  const [description, setDescription] = useState(base.description || "");
+
+  return (
+    <Dialog
+      open
+      onOpenChange={(open) => {
+        if (!open && !pending) onClose();
+      }}
+    >
+      <DialogContent>
+        <form
+          onSubmit={(event) => {
+            event.preventDefault();
+            if (!pending && name.trim()) {
+              void onSave({
+                name: name.trim(),
+                description: description.trim(),
+              });
+            }
+          }}
+        >
+          <DialogHeader>
+            <DialogTitle>编辑助手知识库</DialogTitle>
+            <DialogDescription>
+              修改知识库名称和描述。知识内容、向量和关联关系不会受到影响。
+            </DialogDescription>
+          </DialogHeader>
+          <div className="space-y-4 py-4">
+            <div className="space-y-2">
+              <label className="text-sm font-medium" htmlFor="assistant-base-name">
+                名称
+              </label>
+              <Input
+                id="assistant-base-name"
+                value={name}
+                onChange={(event) => setName(event.target.value)}
+                maxLength={255}
+                disabled={pending}
+                required
+              />
+            </div>
+            <div className="space-y-2">
+              <label
+                className="text-sm font-medium"
+                htmlFor="assistant-base-description"
+              >
+                描述
+              </label>
+              <Textarea
+                id="assistant-base-description"
+                value={description}
+                onChange={(event) => setDescription(event.target.value)}
+                maxLength={2048}
+                rows={4}
+                disabled={pending}
+              />
+            </div>
+          </div>
+          <DialogFooter>
+            <Button type="button" variant="outline" disabled={pending} onClick={onClose}>
+              取消
+            </Button>
+            <Button type="submit" disabled={pending || !name.trim()}>
+              {pending && <Loader2 className="mr-2 size-4 animate-spin" />}
+              保存
+            </Button>
+          </DialogFooter>
+        </form>
+      </DialogContent>
+    </Dialog>
+  );
+}
@@ -37,7 +37,6 @@ import { UserIdentityBadge } from "@/components/workspace/user-identity-badge";
 import { CompactModeGuide } from "@/components/workspace/compact-mode-guide";
 import { Welcome } from "@/components/workspace/welcome";
 import { CompactWelcome } from "@/components/workspace/compact-welcome";
-import { readSidebarEnabled } from "@/core/page-layout/sidebar-enabled";
 import {
  buildFullChatNavigationPath,
  isChatsIframeWorkspacePath,
@@ -70,7 +69,7 @@ import { clearResearchReportStream } from "@/core/threads/use-research-report-st
 import { resolveWritingModeReportPath } from "@/core/threads/writing-mode";
 import { queueLlmWikiConversationDeposit } from "@/core/llmwiki/conversation-deposit";
 import { useSingleRoundRagMessages } from "@/core/threads/use-single-round-rag";
-import { useMultiRoundRagMessages } from "@/core/threads/use-multi-round-rag";
+import { useMultiRoundRagMessages, mergeMessagesByTime, toLangGraphMessages } from "@/core/threads/use-multi-round-rag";
 import { useLayoutMode } from "@/core/system-settings/hooks";
 import { useRouteBase } from "@/core/route-base";
 import { textOfMessage } from "@/core/threads/utils";
@@ -129,7 +128,7 @@ export default function ChatPage() {
  const { open: historySidebarOpen, toggleSidebar: toggleHistorySidebar } =
    useSidebar();
  const { t } = useI18n();
-  // 有效界面模式：用户自选 > 管理员系统默认 > （下方再回退会话级 sidebarEnabled）
+  // 有效界面模式：用户自选 > 管理员系统默认 > 内置默认「简洁模式」
  const [effectiveLayoutMode] = useLayoutMode();
  const [showFollowups, setShowFollowups] = useState(false);
  const [hasStartedConversation, setHasStartedConversation] = useState(false);
@@ -357,19 +356,19 @@ export default function ChatPage() {
  const { displayThread: researchDisplayThread } = useResearchWritingFeed(threadId, thread);
  const displayThread = useMemo(() => {
    const base = researchDisplayThread;
+    const ragMessages = toLangGraphMessages(multiRoundRag.messages);
    if (
      singleRoundRag.messages.length === 0 &&
-      multiRoundRag.messages.length === 0 &&
+      ragMessages.length === 0 &&
      !singleRoundRag.isLoading &&
      !multiRoundRag.isLoading
    ) {
      return base;
    }
-    const messages = [
-      ...base.messages,
-      ...singleRoundRag.messages,
-      ...multiRoundRag.messages,
-    ];
+    const messages = mergeMessagesByTime(
+      [...base.messages, ...singleRoundRag.messages],
+      ragMessages,
+    );
    return {
      ...base,
      values: { ...base.values, messages },
@@ -380,9 +379,9 @@ export default function ChatPage() {
  }, [
    multiRoundRag.isLoading,
    multiRoundRag.messages,
+    researchDisplayThread,
    singleRoundRag.isLoading,
    singleRoundRag.messages,
-    researchDisplayThread,
  ]);

  const writingArtifactPath = useMemo(
@@ -695,16 +694,10 @@ export default function ChatPage() {
  const isLandingState = isNewThread && !hasStartedConversation;
  // 紧凑模式（正常 App，有外层页面侧栏）落地态：用 CM 参考图样式重画；
  // 判定与 PageRoutes 的 compactWorkspaceSidebar(pageSidebarAllowed) 保持一致 ——
-  // 优先看外观设置的「全量/简洁」，未设置过才回退到会话级 sidebarEnabled。否则用户显式
-  // 选「全量」时 PageRoutes 已挂出顶栏+侧栏，这里却还按旧 sidebarEnabled 判定，导致深蓝
-  // 主题底图(workspace-chat-bg)不生效。非紧凑（嵌入/standalone）保持原样。
-  const layoutMode = effectiveLayoutMode;
+  // 用 useLayoutMode 的有效界面模式（用户自选 > 管理员系统默认 > 内置简洁默认），
+  // 与 PageRoutes 的 chrome 判定同源。非紧凑（嵌入/standalone）保持原样。
  const chromeByPreference =
-    fullChatMode || layoutMode === "full"
-      ? true
-      : layoutMode === "compact"
-        ? false
-        : readSidebarEnabled();
+    fullChatMode || effectiveLayoutMode === "full" ? true : false;
  const compactChrome =
    chromeByPreference && !isChatsIframeWorkspacePath(pathname);
  const compactLanding = isLandingState && compactChrome;
@@ -909,7 +902,7 @@ export default function ChatPage() {
                      status={
                        thread.error
                          ? "error"
-                          : displayThread.isLoading
+                          : displayThread.isLoading || multiRoundRag.isLoading
                            ? "streaming"
                            : "ready"
                      }
@@ -1,3 +1,4 @@
+import { userFacingKnowledgeMessage } from "@/lib/knowledge-message";
 import { type FormEvent, useEffect, useMemo, useRef, useState } from "react";
 import {
  AlertCircle,
@@ -211,7 +212,7 @@ export default function EnterpriseResearchPage() {
          setTasks((current) => current.map((task) => task.id === taskId ? { ...task, active_report_job_id: null } : task));
        }
        if (event.type === "completed") toast.success("企业研究报告已完成");
-        if (event.type === "failed") toast.error(event.job.error_message || "报告生成失败");
+        if (event.type === "failed") toast.error(userFacingKnowledgeMessage(event.job.error_message || "报告生成失败"));
      }
    },
  }).catch((error: unknown) => {
@@ -290,7 +291,7 @@ export default function EnterpriseResearchPage() {
      return;
    }
    if (!isWeKnoraReady) {
-      toast.error("知识服务尚未启用，请先在系统中配置 WeKnora");
+      toast.error("知识服务尚未启用，请先在系统中配置知识服务");
      return;
    }

@@ -442,7 +443,7 @@ export default function EnterpriseResearchPage() {
              <section>
                <Badge variant="secondary" className="mb-3"><Sparkles className="size-3" />阶段一：证据编排</Badge>
                <h2 className="text-xl font-semibold tracking-tight">建立一个可追溯的研究任务</h2>
-                <p className="mt-2 max-w-xl text-sm leading-6 text-muted-foreground">页面独立于现有“深度研究”功能。任务、检索词与证据快照保存在 DeerFlow 后端；当前版本只使用已授权的 WeKnora 知识库，不会修改任何知识库或既有报告。</p>
+                <p className="mt-2 max-w-xl text-sm leading-6 text-muted-foreground">页面独立于现有“深度研究”功能。任务、检索词与证据快照保存在 DeerFlow 后端；当前版本只使用已授权的 普通知识库，不会修改任何知识库或既有报告。</p>
              </section>

              <Card>
@@ -609,12 +610,12 @@ function TaskOverview({
      <CardContent><ol className="space-y-4">{template.stages.map((stage, index) => {
        const complete = task.status !== "collecting" && (index < 2 || task.sources.length > 0);
        const current = task.status === "collecting" && index === 1;
-        return <li key={stage} className="flex gap-3"><span className={cn("flex size-7 shrink-0 items-center justify-center rounded-full border text-xs font-semibold", complete ? "border-emerald-300 bg-emerald-50 text-emerald-700" : current ? "border-primary bg-primary/10 text-primary" : "text-muted-foreground")}>{complete ? <CheckCircle2 className="size-4" /> : index + 1}</span><div className="min-w-0 pt-0.5"><p className="text-sm font-medium">{stage}</p><p className="mt-1 text-xs leading-5 text-muted-foreground">{index === 0 ? "已固定研究主题、范围和知识库权限。" : index === 1 ? task.status === "collecting" ? "正在调用 WeKnora 检索并去重证据。" : `已执行 ${task.queries.length} 个检索方向。` : index === 2 ? `${task.sources.length} 条去重后的资料可在右侧逐条核验。` : "研究计划会固定选用资料、章节结构和写作约束。"}</p></div></li>;
+        return <li key={stage} className="flex gap-3"><span className={cn("flex size-7 shrink-0 items-center justify-center rounded-full border text-xs font-semibold", complete ? "border-emerald-300 bg-emerald-50 text-emerald-700" : current ? "border-primary bg-primary/10 text-primary" : "text-muted-foreground")}>{complete ? <CheckCircle2 className="size-4" /> : index + 1}</span><div className="min-w-0 pt-0.5"><p className="text-sm font-medium">{stage}</p><p className="mt-1 text-xs leading-5 text-muted-foreground">{index === 0 ? "已固定研究主题、范围和知识库权限。" : index === 1 ? task.status === "collecting" ? "正在调用知识服务检索并去重证据。" : `已执行 ${task.queries.length} 个检索方向。` : index === 2 ? `${task.sources.length} 条去重后的资料可在右侧逐条核验。` : "研究计划会固定选用资料、章节结构和写作约束。"}</p></div></li>;
      })}</ol></CardContent>
    </Card>
    <Card>
-      <CardHeader className="gap-1"><CardTitle className="text-base">已执行检索词</CardTitle><CardDescription>检索词由模板和你的研究范围生成，结果仅来自当前账号可见的 WeKnora 知识库。</CardDescription></CardHeader>
-      <CardContent><div className="flex flex-wrap gap-2">{task.queries.map((query) => <Badge key={query} variant="outline" className="max-w-full whitespace-normal py-1 text-left"><Search className="size-3" />{query}</Badge>)}</div>{task.warning ? <div className="mt-4 flex gap-2 rounded-md border border-amber-300 bg-amber-50 p-3 text-sm text-amber-900 dark:border-amber-900 dark:bg-amber-950/40 dark:text-amber-100"><AlertCircle className="mt-0.5 size-4 shrink-0" />{task.warning}</div> : null}</CardContent>
+      <CardHeader className="gap-1"><CardTitle className="text-base">已执行检索词</CardTitle><CardDescription>检索词由模板和你的研究范围生成，结果仅来自当前账号可见的 普通知识库。</CardDescription></CardHeader>
+      <CardContent><div className="flex flex-wrap gap-2">{task.queries.map((query) => <Badge key={query} variant="outline" className="max-w-full whitespace-normal py-1 text-left"><Search className="size-3" />{query}</Badge>)}</div>{task.warning ? <div className="mt-4 flex gap-2 rounded-md border border-amber-300 bg-amber-50 p-3 text-sm text-amber-900 dark:border-amber-900 dark:bg-amber-950/40 dark:text-amber-100"><AlertCircle className="mt-0.5 size-4 shrink-0" />{userFacingKnowledgeMessage(task.warning)}</div> : null}</CardContent>
    </Card>
    {canPlan ? <Card>
      <CardHeader className="gap-1"><CardTitle className="text-base">研究计划与选用资料</CardTitle><CardDescription>计划和资料选择会保存到当前任务；后续报告只能使用这里确认过的证据。</CardDescription></CardHeader>
@@ -91,7 +91,7 @@ export default function LlmWikiKnowledgePage({
    return <Navigate to="/page/workspace/knowledge/assistant" replace />;
  }

-  if (runtime.isError || runtime.data?.provider !== "weknora") {
+  if (runtime.isError || runtime.data?.provider !== "weknora" || !runtime.data?.api_base_url?.trim()) {
    if (mode === "list" || mode === "detail") {
      return <Navigate to="/page/workspace/knowledge/assistant" replace />;
    }
@@ -37,7 +37,6 @@ import { isWujieEnv, useWujieProps } from '@/core/embed/wujie';
 import { isEmbeddedHost } from '@/core/embed/frame-context';
 import { readEmbedParam } from '@/core/embed/embed-session';
 import {
-  GENERAL_QA_ROUTE,
  loginByYUserId,
  persistAccessToken,
  persistToolsToken,
@@ -61,6 +60,11 @@ import { persistYLogToken } from '@/core/log/y-log-token';
 import { persistLoginCredentials } from '@/core/auth/login-credentials';
 import { OptType, writeYLog } from '@/core/log/y-log';
 import { authStorageGet } from '@/core/auth/scoped-storage';
+import {
+  CUSTOMIZED_DEERFLOW_HOME_ROUTE,
+  OFFICIAL_DEERFLOW_HOME_ROUTE,
+} from '@/core/official-deerflow/routes';
+import { env } from '@/env';

 /** 令牌脱敏：日志里只露头尾，避免完整令牌泄漏。 */
 function maskLoginToken(value: string): string {
@@ -103,7 +107,11 @@ function summarizeStoredUserInfo(): Record<string, unknown> | null {

 const DEFAULT_USERNAME = 'guest';
 const IFRAME_CHAT_MODE = 'iframe';
-const DEFAULT_REDIRECT_PATH = '/page/workspace/chats/new';
+// Explicit redirects and task deep links retain their existing higher
+// priority. This only picks the destination for a standard completed login.
+const DEFAULT_REDIRECT_PATH = env.USE_OFFICIAL_DEERFLOW_ENTRY
+  ? OFFICIAL_DEERFLOW_HOME_ROUTE
+  : CUSTOMIZED_DEERFLOW_HOME_ROUTE;
 const FULL_CHAT_MODE = 'full';

 type LoginStatus = 'loading' | 'success' | 'error';
@@ -191,7 +199,7 @@ export default function LoginPage() {
      // External iframe callers frequently also provide yUserId for login.
      // That identity parameter must not steal a deliberate iframe entry and
      // send it to the generic full-chat home before the route split above.
-      if (yUserId) return GENERAL_QA_ROUTE;
+      if (yUserId) return DEFAULT_REDIRECT_PATH;
      return resolvePostLoginRedirectPath(
        searchParams.toString(),
        DEFAULT_REDIRECT_PATH,
@@ -0,0 +1,776 @@
+import type { Message } from "@langchain/langgraph-sdk";
+import {
+  Bot,
+  CalendarClock,
+  ChevronDown,
+  CircleHelp,
+  Clock3,
+  LoaderCircle,
+  MessageSquareText,
+  PanelLeftClose,
+  Pause,
+  Play,
+  PlusSquare,
+  Search,
+  SendHorizontal,
+  Settings2,
+  Sparkles,
+  UserRound,
+  X,
+} from "lucide-react";
+import { type FormEvent, useCallback, useMemo, useState } from "react";
+import { useLocation, useNavigate } from "react-router-dom";
+
+import { useAgent, useAgents } from "@/core/agents";
+import { getAccountDisplayName } from "@/core/auth";
+import {
+  type ScheduledTask,
+  useScheduledTaskActions,
+  useScheduledTaskRuns,
+  useScheduledTasks,
+} from "@/core/scheduled-tasks";
+import { useLocalSettings } from "@/core/settings";
+import {
+  useAppearanceSettings,
+  useCitationDisplaySettings,
+} from "@/core/system-settings/hooks";
+import { useThreadStream, useThreads } from "@/core/threads/hooks";
+import { textOfMessage, titleOfThread } from "@/core/threads/utils";
+import { uuid } from "@/core/utils/uuid";
+import {
+  OFFICIAL_DEERFLOW_HOME_ROUTE,
+  OFFICIAL_DEERFLOW_ROUTE_PREFIX,
+} from "@/core/official-deerflow/routes";
+
+import "./official-deerflow-entry.css";
+
+type OfficialPage = "chat" | "agents" | "agent-chat" | "scheduled" | "settings";
+
+function pageFromPath(pathname: string): OfficialPage {
+  const path = pathname.slice(OFFICIAL_DEERFLOW_ROUTE_PREFIX.length);
+  if (path.startsWith("/workspace/agents/") && path.includes("/chats")) {
+    return "agent-chat";
+  }
+  if (path.startsWith("/workspace/agents")) return "agents";
+  if (path.startsWith("/workspace/scheduled-tasks")) return "scheduled";
+  if (path.startsWith("/workspace/settings")) return "settings";
+  return "chat";
+}
+
+function parseChatRoute(pathname: string) {
+  const chatMatch = pathname.match(/\/workspace\/chats\/([^/]+)/);
+  if (chatMatch) return { threadId: decodeURIComponent(chatMatch[1]!), agentId: null };
+
+  const agentMatch = pathname.match(
+    /\/workspace\/agents\/([^/]+)\/chats\/([^/]+)/,
+  );
+  if (agentMatch) {
+    return {
+      agentId: decodeURIComponent(agentMatch[1]!),
+      threadId: decodeURIComponent(agentMatch[2]!),
+    };
+  }
+  return { threadId: "new", agentId: null };
+}
+
+function parseScheduledTaskId(pathname: string) {
+  const match = pathname.match(/\/workspace\/scheduled-tasks\/([^/]+)/);
+  return match ? decodeURIComponent(match[1]!) : null;
+}
+
+function readableError(error: unknown, fallback: string) {
+  return error instanceof Error && error.message ? error.message : fallback;
+}
+
+function formatTimestamp(value: string | null | undefined) {
+  if (!value) return "";
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) return "";
+  const elapsed = Date.now() - date.getTime();
+  if (elapsed < 60_000) return "刚刚";
+  if (elapsed < 3_600_000) return `${Math.max(1, Math.floor(elapsed / 60_000))} 分钟前`;
+  if (elapsed < 86_400_000) return `${Math.floor(elapsed / 3_600_000)} 小时前`;
+  return new Intl.DateTimeFormat("zh-CN", { month: "numeric", day: "numeric" }).format(date);
+}
+
+function statusForTask(task: ScheduledTask) {
+  const status = task.last_status;
+  if (status === "running" || status === "pending") {
+    return { className: status, label: "执行中" };
+  }
+  if (!task.enabled) return { className: "paused", label: "已暂停" };
+  if (status === "failed") return { className: "failed", label: "执行失败" };
+  if (status === "succeeded") return { className: "succeeded", label: "已完成" };
+  return { className: "ready", label: "已启用" };
+}
+
+function runStatusText(status: string) {
+  if (status === "running" || status === "pending") return "执行中";
+  if (status === "succeeded") return "已完成";
+  if (status === "failed") return "执行失败";
+  return status || "等待执行";
+}
+
+function OfficialNavItem({
+  active,
+  icon: Icon,
+  label,
+  onClick,
+}: {
+  active: boolean;
+  icon: typeof MessageSquareText;
+  label: string;
+  onClick: () => void;
+}) {
+  return (
+    <button
+      className={`official-nav-item${active ? " is-active" : ""}`}
+      onClick={onClick}
+      type="button"
+    >
+      <Icon aria-hidden="true" size={18} strokeWidth={1.8} />
+      <span>{label}</span>
+    </button>
+  );
+}
+
+function ThreadMessage({ message }: { message: Message }) {
+  const text = textOfMessage(message)?.trim();
+  if (!text) return null;
+  const isUser = message.type === "human";
+  return (
+    <div className={`official-message official-message-${isUser ? "user" : "assistant"}`}>
+      {!isUser && (
+        <div className="official-assistant-mark">
+          <Sparkles aria-hidden="true" size={16} />
+          DeerFlow
+        </div>
+      )}
+      <p>{text}</p>
+    </div>
+  );
+}
+
+function ChatWorkspace({
+  agentId,
+  routeThreadId,
+}: {
+  agentId: string | null;
+  routeThreadId: string;
+}) {
+  const navigate = useNavigate();
+  const [prompt, setPrompt] = useState("");
+  const [sendError, setSendError] = useState<string | null>(null);
+  const isNewThread = routeThreadId === "new";
+  // A new conversation uses the same client-generated id approach as the
+  // existing ChatPage. The backend owns the persisted id once streaming starts.
+  const [draftThreadId] = useState<string>(() => uuid() as string);
+  const activeThreadId = isNewThread ? draftThreadId : routeThreadId;
+  const { agent } = useAgent(agentId, { enabled: !!agentId });
+  const [localSettings] = useLocalSettings();
+  const [thread, sendMessage, isUploading] = useThreadStream({
+    threadId: isNewThread ? undefined : routeThreadId,
+    assistantId: agentId ?? undefined,
+    context: {
+      ...localSettings.context,
+      ...(agentId ? { agent_id: agentId } : {}),
+    },
+    onStart: (createdThreadId) => {
+      const nextPath = agentId
+        ? `${OFFICIAL_DEERFLOW_ROUTE_PREFIX}/workspace/agents/${encodeURIComponent(agentId)}/chats/${encodeURIComponent(createdThreadId)}`
+        : `${OFFICIAL_DEERFLOW_ROUTE_PREFIX}/workspace/chats/${encodeURIComponent(createdThreadId)}`;
+      navigate(nextPath, { replace: true });
+    },
+  });
+
+  const messages = useMemo(
+    () =>
+      (thread.messages ?? []).filter(
+        (message): message is Message =>
+          message.type === "human" || message.type === "ai",
+      ),
+    [thread.messages],
+  );
+  const title = isNewThread
+    ? agent?.name ?? "新对话"
+    : thread.values?.title ?? agent?.name ?? "对话";
+  const streamError = thread.error
+    ? readableError(thread.error, "对话加载失败，请稍后重试。")
+    : null;
+
+  const handleSubmit = useCallback(
+    (event: FormEvent<HTMLFormElement>) => {
+      event.preventDefault();
+      const text = prompt.trim();
+      if (!text || thread.isLoading || isUploading) return;
+      setPrompt("");
+      setSendError(null);
+      void sendMessage(activeThreadId, { text, files: [] }).catch((error) => {
+        setSendError(readableError(error, "消息发送失败，请稍后重试。"));
+      });
+    },
+    [activeThreadId, isUploading, prompt, sendMessage, thread.isLoading],
+  );
+
+  return (
+    <section className="official-chat-page">
+      <header className="official-page-header official-chat-header">
+        <div className="official-thread-title">
+          {title}
+          <ChevronDown aria-hidden="true" size={16} />
+        </div>
+        <div className="official-header-actions">
+          <button
+            className="official-outline-button"
+            onClick={() => navigate(`${OFFICIAL_DEERFLOW_ROUTE_PREFIX}/workspace/scheduled-tasks`)}
+            type="button"
+          >
+            <CalendarClock aria-hidden="true" size={17} />
+            定时任务
+          </button>
+          <button aria-label="帮助" className="official-icon-button" type="button">
+            <CircleHelp aria-hidden="true" size={18} />
+          </button>
+        </div>
+      </header>
+
+      <div className={`official-chat-canvas${messages.length ? " has-history" : ""}`}>
+        {messages.length ? (
+          <div className="official-message-list">
+            {messages.map((message, index) => (
+              <ThreadMessage key={message.id ?? `${message.type}-${index}`} message={message} />
+            ))}
+            {thread.isLoading && (
+              <div className="official-streaming-indicator">
+                <LoaderCircle aria-hidden="true" size={15} />
+                DeerFlow 正在回复…
+              </div>
+            )}
+          </div>
+        ) : (
+          <div className="official-chat-welcome">
+            <div className="official-logo-orb">
+              <Sparkles aria-hidden="true" size={28} />
+            </div>
+            <h1>{agent?.name ? `与 ${agent.name} 开始对话` : "今天想一起完成什么？"}</h1>
+            <p>直接连接当前 DeerFlow 后端；消息与历史记录会同步保存。</p>
+            {!agentId && (
+              <div className="official-suggestion-grid">
+                {[
+                  ["做一份市场调研", "比较行业趋势并形成要点"],
+                  ["规划项目", "把目标拆解成清晰步骤"],
+                  ["写一篇初稿", "从想法到结构化内容"],
+                ].map(([suggestion, detail]) => (
+                  <button key={suggestion} onClick={() => setPrompt(suggestion)} type="button">
+                    <strong>{suggestion}</strong>
+                    <span>{detail}</span>
+                  </button>
+                ))}
+              </div>
+            )}
+          </div>
+        )}
+      </div>
+
+      {(streamError || sendError) && (
+        <p className="official-inline-error" role="alert">
+          {sendError ?? streamError}
+        </p>
+      )}
+      <form className="official-composer-shell" onSubmit={handleSubmit}>
+        <div className="official-composer">
+          <textarea
+            aria-label="输入消息"
+            disabled={thread.isLoading || isUploading}
+            onChange={(event) => setPrompt(event.target.value)}
+            placeholder="给 DeerFlow 发送消息…"
+            rows={1}
+            value={prompt}
+          />
+          <button
+            aria-label="发送"
+            disabled={!prompt.trim() || thread.isLoading || isUploading}
+            type="submit"
+          >
+            <SendHorizontal aria-hidden="true" size={18} />
+          </button>
+        </div>
+        <p>连接当前 DeerFlow 后端</p>
+      </form>
+    </section>
+  );
+}
+
+function AgentsPage({ openAgent }: { openAgent: (id: string) => void }) {
+  const navigate = useNavigate();
+  const [query, setQuery] = useState("");
+  const { agents, isLoading, error } = useAgents({ search: query });
+
+  return (
+    <section className="official-content-page">
+      <header className="official-page-header">
+        <div>
+          <p className="official-eyebrow">工作区</p>
+          <h1>智能体</h1>
+          <p>以下智能体直接来自当前 DeerFlow 后端。</p>
+        </div>
+        <button
+          className="official-primary-button"
+          onClick={() => navigate("/page/workspace/agents/new")}
+          type="button"
+        >
+          <PlusSquare aria-hidden="true" size={17} />
+          创建智能体
+        </button>
+      </header>
+      <div className="official-toolbar">
+        <label className="official-search">
+          <Search aria-hidden="true" size={17} />
+          <input
+            onChange={(event) => setQuery(event.target.value)}
+            placeholder="搜索智能体"
+            value={query}
+          />
+        </label>
+      </div>
+      {error ? (
+        <p className="official-query-error" role="alert">
+          {readableError(error, "智能体列表加载失败。")}
+        </p>
+      ) : isLoading ? (
+        <div className="official-loading-state"><LoaderCircle aria-hidden="true" size={18} /> 正在加载智能体…</div>
+      ) : agents.length ? (
+        <div className="official-agent-grid">
+          {agents.map((agent, index) => (
+            <article className="official-agent-card" key={agent.id}>
+              <div className={`official-agent-avatar ${["violet", "sky", "amber"][index % 3]}`}>
+                {agent.name.slice(0, 2).toLocaleUpperCase()}
+              </div>
+              <h2>{agent.name}</h2>
+              <p>{agent.description || "暂无简介"}</p>
+              <button onClick={() => openAgent(agent.id)} type="button">
+                开始对话
+              </button>
+            </article>
+          ))}
+        </div>
+      ) : (
+        <div className="official-empty-panel">
+          <div className="official-empty-icon"><Bot aria-hidden="true" size={24} /></div>
+          <h2>暂无可用智能体</h2>
+          <p>可从“创建智能体”进入现有的完整配置页面。</p>
+        </div>
+      )}
+    </section>
+  );
+}
+
+function ScheduledTasksPage({ selectedTaskId }: { selectedTaskId: string | null }) {
+  const navigate = useNavigate();
+  const { data: tasks = [], isLoading, error } = useScheduledTasks();
+  const { data: runs = [], isLoading: runsLoading, error: runsError } =
+    useScheduledTaskRuns(selectedTaskId);
+  const actions = useScheduledTaskActions();
+  const [actionTaskId, setActionTaskId] = useState<string | null>(null);
+  const [actionError, setActionError] = useState<string | null>(null);
+  const selectedTask = tasks.find((task) => task.task_id === selectedTaskId) ?? null;
+
+  const openTask = useCallback(
+    (taskId: string) => {
+      navigate(
+        `${OFFICIAL_DEERFLOW_ROUTE_PREFIX}/workspace/scheduled-tasks/${encodeURIComponent(taskId)}`,
+      );
+    },
+    [navigate],
+  );
+
+  const closeTask = useCallback(() => {
+    navigate(`${OFFICIAL_DEERFLOW_ROUTE_PREFIX}/workspace/scheduled-tasks`);
+  }, [navigate]);
+
+  const runTaskAction = useCallback(
+    async (task: ScheduledTask, action: "trigger" | "pause" | "resume") => {
+      setActionTaskId(task.task_id);
+      setActionError(null);
+      try {
+        if (action === "trigger") {
+          await actions.trigger.mutateAsync(task.task_id);
+          openTask(task.task_id);
+        } else if (action === "pause") {
+          await actions.pause.mutateAsync(task.task_id);
+        } else {
+          await actions.resume.mutateAsync(task.task_id);
+        }
+      } catch (actionFailure) {
+        setActionError(
+          readableError(
+            actionFailure,
+            action === "trigger" ? "任务触发失败。" : "任务状态更新失败。",
+          ),
+        );
+      } finally {
+        setActionTaskId(null);
+      }
+    },
+    [actions.pause, actions.resume, actions.trigger, openTask],
+  );
+
+  const actionIsPending = (taskId: string) => actionTaskId === taskId;
+
+  return (
+    <section className="official-content-page">
+      <header className="official-page-header">
+        <div>
+          <p className="official-eyebrow">工作区</p>
+          <h1>定时任务</h1>
+          <p>任务、运行记录和控制操作均直接请求当前 DeerFlow 后端。</p>
+        </div>
+        <button
+          className="official-primary-button"
+          onClick={() => navigate("/page/workspace/scheduled/tasks")}
+          type="button"
+        >
+          <PlusSquare aria-hidden="true" size={17} />
+          新建任务
+        </button>
+      </header>
+      {actionError && (
+        <p className="official-query-error" role="alert">
+          {actionError}
+        </p>
+      )}
+      {selectedTask && (
+        <section className="official-task-detail" aria-label={`${selectedTask.name}详情`}>
+          <header>
+            <div>
+              <p className="official-eyebrow">任务详情</p>
+              <h2>{selectedTask.name}</h2>
+              <p>{selectedTask.description || selectedTask.prompt}</p>
+            </div>
+            <button
+              aria-label="关闭任务详情"
+              className="official-icon-button"
+              onClick={closeTask}
+              type="button"
+            >
+              <X aria-hidden="true" size={18} />
+            </button>
+          </header>
+          <div className="official-task-meta">
+            <span>计划：{selectedTask.schedule_text || selectedTask.cron_expr}</span>
+            <span>时区：{selectedTask.timezone}</span>
+            <span>下次执行：{formatTimestamp(selectedTask.next_run_at) || "未计划"}</span>
+          </div>
+          <div className="official-task-detail-actions">
+            <button
+              className="official-secondary-button"
+              disabled={actionIsPending(selectedTask.task_id)}
+              onClick={() => void runTaskAction(selectedTask, "trigger")}
+              type="button"
+            >
+              {actionIsPending(selectedTask.task_id) ? <LoaderCircle aria-hidden="true" size={15} /> : <Play aria-hidden="true" size={15} />}
+              立即执行
+            </button>
+            <button
+              className="official-secondary-button"
+              disabled={actionIsPending(selectedTask.task_id)}
+              onClick={() =>
+                void runTaskAction(
+                  selectedTask,
+                  selectedTask.enabled ? "pause" : "resume",
+                )
+              }
+              type="button"
+            >
+              {selectedTask.enabled ? <Pause aria-hidden="true" size={15} /> : <Play aria-hidden="true" size={15} />}
+              {selectedTask.enabled ? "暂停任务" : "恢复任务"}
+            </button>
+          </div>
+          <div className="official-run-list">
+            <h3>最近运行</h3>
+            {runsError ? (
+              <p className="official-query-error" role="alert">
+                {readableError(runsError, "运行记录加载失败。")}
+              </p>
+            ) : runsLoading ? (
+              <p className="official-run-empty"><LoaderCircle aria-hidden="true" size={15} /> 正在加载运行记录…</p>
+            ) : runs.length ? (
+              runs.slice(0, 8).map((run) => (
+                <button
+                  className="official-run-row"
+                  key={run.id}
+                  onClick={() => navigate(`/page/workspace/scheduled/runs/${encodeURIComponent(run.id)}`)}
+                  type="button"
+                >
+                  <span className={`official-run-status is-${run.status}`}>{runStatusText(run.status)}</span>
+                  <span>{formatTimestamp(run.started_at ?? run.scheduled_for) || "等待执行"}</span>
+                  <span>{run.result?.title || run.error || "查看完整运行结果"}</span>
+                </button>
+              ))
+            ) : (
+              <p className="official-run-empty">该任务暂时没有运行记录。</p>
+            )}
+          </div>
+        </section>
+      )}
+      {error ? (
+        <p className="official-query-error" role="alert">
+          {readableError(error, "定时任务列表加载失败。")}
+        </p>
+      ) : isLoading ? (
+        <div className="official-loading-state"><LoaderCircle aria-hidden="true" size={18} /> 正在加载定时任务…</div>
+      ) : tasks.length ? (
+        <div className="official-task-list">
+          {tasks.map((task) => {
+            const status = statusForTask(task);
+            const pending = actionIsPending(task.task_id);
+            return (
+              <article
+                className={`official-task-card${selectedTaskId === task.task_id ? " is-selected" : ""}`}
+                key={task.task_id}
+              >
+                <button
+                  className="official-task-card-main"
+                  onClick={() => openTask(task.task_id)}
+                  type="button"
+                >
+                  <span className="official-task-icon"><Clock3 aria-hidden="true" size={18} /></span>
+                  <span className="official-task-copy">
+                    <strong>{task.name}</strong>
+                    <small>{task.schedule_text || task.cron_expr}</small>
+                  </span>
+                  <span className={`official-task-status is-${status.className}`}>{status.label}</span>
+                  <time>{formatTimestamp(task.next_run_at ?? task.updated_at)}</time>
+                </button>
+                <div className="official-task-card-actions">
+                  <button
+                    aria-label={`立即执行 ${task.name}`}
+                    disabled={pending}
+                    onClick={() => void runTaskAction(task, "trigger")}
+                    title="立即执行"
+                    type="button"
+                  >
+                    {pending ? <LoaderCircle aria-hidden="true" size={16} /> : <Play aria-hidden="true" size={16} />}
+                  </button>
+                  <button
+                    aria-label={task.enabled ? `暂停 ${task.name}` : `恢复 ${task.name}`}
+                    disabled={pending}
+                    onClick={() => void runTaskAction(task, task.enabled ? "pause" : "resume")}
+                    title={task.enabled ? "暂停任务" : "恢复任务"}
+                    type="button"
+                  >
+                    {task.enabled ? <Pause aria-hidden="true" size={16} /> : <Play aria-hidden="true" size={16} />}
+                  </button>
+                </div>
+              </article>
+            );
+          })}
+        </div>
+      ) : (
+        <div className="official-empty-panel">
+          <div className="official-empty-icon"><Clock3 aria-hidden="true" size={24} /></div>
+          <h2>还没有定时任务</h2>
+          <p>创建一个任务，按天、周或自定义时间自动执行。</p>
+          <button
+            className="official-secondary-button"
+            onClick={() => navigate("/page/workspace/scheduled/tasks")}
+            type="button"
+          >
+            创建定时任务
+          </button>
+        </div>
+      )}
+    </section>
+  );
+}
+
+function SettingsPage() {
+  const { data: appearance, isLoading: appearanceLoading, error: appearanceError } =
+    useAppearanceSettings();
+  const { data: citation, isLoading: citationLoading, error: citationError } =
+    useCitationDisplaySettings();
+  const settings = [
+    appearance && {
+      label: "默认外观",
+      detail: `主题：${appearance.default_theme}；布局：${appearance.default_layout_mode}`,
+    },
+    appearance && {
+      label: "默认展示方式",
+      detail: `智能体：${appearance.default_agent_view}；技能：${appearance.default_skill_view}`,
+    },
+    citation && {
+      label: "引用展示",
+      detail: citation.reference_mode_enabled ? "已启用引用模式" : "未启用引用模式",
+    },
+  ].filter(Boolean) as Array<{ label: string; detail: string }>;
+  const isLoading = appearanceLoading || citationLoading;
+
+  return (
+    <section className="official-content-page">
+      <header className="official-page-header">
+        <div>
+          <p className="official-eyebrow">工作区</p>
+          <h1>设置</h1>
+          <p>只展示已由当前 DeerFlow 后端提供的配置，不使用模拟值。</p>
+        </div>
+      </header>
+      {isLoading && !settings.length ? (
+        <div className="official-loading-state"><LoaderCircle aria-hidden="true" size={18} /> 正在加载系统配置…</div>
+      ) : settings.length ? (
+        <div className="official-settings-list">
+          {settings.map((setting) => (
+            <div className="official-setting-row" key={setting.label}>
+              <strong>{setting.label}</strong>
+              <small>{setting.detail}</small>
+            </div>
+          ))}
+        </div>
+      ) : (
+        <div className="official-empty-panel">
+          <div className="official-empty-icon"><Settings2 aria-hidden="true" size={24} /></div>
+          <h2>暂时没有可读取的系统配置</h2>
+          <p>不会用静态数据替代未返回的后端配置。</p>
+        </div>
+      )}
+      {(appearanceError || citationError) && (
+        <p className="official-query-error" role="alert">
+          部分系统配置不可读取：{readableError(appearanceError ?? citationError, "请检查登录权限。")}
+        </p>
+      )}
+    </section>
+  );
+}
+
+/**
+ * Vite-native official-style workspace. It reuses the current frontend's
+ * backend clients and stream adapter; only reference-only UI has local state.
+ */
+export default function OfficialDeerFlowEntry() {
+  const location = useLocation();
+  const navigate = useNavigate();
+  const [sidebarCollapsed, setSidebarCollapsed] = useState(false);
+  const page = pageFromPath(location.pathname);
+  const chatRoute = useMemo(
+    () => parseChatRoute(location.pathname),
+    [location.pathname],
+  );
+  const scheduledTaskId = useMemo(
+    () => parseScheduledTaskId(location.pathname),
+    [location.pathname],
+  );
+  const { data: threads = [], isLoading: threadsLoading, error: threadsError } =
+    useThreads({
+      limit: 20,
+      sortBy: "updated_at",
+      sortOrder: "desc",
+      select: ["thread_id", "updated_at", "values", "metadata"],
+    });
+  const go = (path: string) => navigate(path);
+
+  const nav = [
+    { icon: PlusSquare, label: "新对话", path: OFFICIAL_DEERFLOW_HOME_ROUTE, pages: ["chat"] },
+    { icon: MessageSquareText, label: "对话", path: `${OFFICIAL_DEERFLOW_ROUTE_PREFIX}/workspace/chats/new`, pages: ["chat"] },
+    { icon: Bot, label: "智能体", path: `${OFFICIAL_DEERFLOW_ROUTE_PREFIX}/workspace/agents`, pages: ["agents", "agent-chat"] },
+    { icon: CalendarClock, label: "定时任务", path: `${OFFICIAL_DEERFLOW_ROUTE_PREFIX}/workspace/scheduled-tasks`, pages: ["scheduled"] },
+  ] as const;
+
+  return (
+    <main className={`official-deerflow${sidebarCollapsed ? " sidebar-collapsed" : ""}`}>
+      <aside className="official-sidebar">
+        <div className="official-brand-row">
+          <div className="official-brand">DeerFlow</div>
+          <button
+            aria-label="折叠侧栏"
+            className="official-collapse-button"
+            onClick={() => setSidebarCollapsed((value) => !value)}
+            type="button"
+          >
+            <PanelLeftClose aria-hidden="true" size={17} />
+          </button>
+        </div>
+        <nav aria-label="官方页面导航" className="official-nav">
+          {nav.map((item) => (
+            <OfficialNavItem
+              active={item.pages.some((candidate) => candidate === page)}
+              icon={item.icon}
+              key={item.label}
+              label={item.label}
+              onClick={() => go(item.path)}
+            />
+          ))}
+        </nav>
+        <div className="official-recent-section">
+          <p>最近对话</p>
+          {threadsLoading ? (
+            <div className="official-sidebar-loading"><LoaderCircle aria-hidden="true" size={14} /> 加载中…</div>
+          ) : threadsError ? (
+            <p className="official-sidebar-error">对话列表加载失败</p>
+          ) : threads.length ? (
+            threads.map((chat) => (
+              <button
+                className={`official-recent-chat${chatRoute.threadId === chat.thread_id ? " is-active" : ""}`}
+                key={chat.thread_id}
+                onClick={() => {
+                  const agentId = typeof chat.context?.agent_id === "string"
+                    ? chat.context.agent_id
+                    : typeof chat.metadata?.agent_id === "string"
+                      ? chat.metadata.agent_id
+                      : null;
+                  go(
+                    agentId
+                      ? `${OFFICIAL_DEERFLOW_ROUTE_PREFIX}/workspace/agents/${encodeURIComponent(agentId)}/chats/${encodeURIComponent(chat.thread_id)}`
+                      : `${OFFICIAL_DEERFLOW_ROUTE_PREFIX}/workspace/chats/${encodeURIComponent(chat.thread_id)}`,
+                  );
+                }}
+                type="button"
+              >
+                <MessageSquareText aria-hidden="true" size={15} />
+                <span>{titleOfThread(chat, "未命名对话")}</span>
+                <small>{formatTimestamp(chat.updated_at)}</small>
+              </button>
+            ))
+          ) : (
+            <p className="official-sidebar-empty">暂无历史对话</p>
+          )}
+        </div>
+        <div className="official-sidebar-footer">
+          <button onClick={() => go(`${OFFICIAL_DEERFLOW_ROUTE_PREFIX}/workspace/settings`)} type="button">
+            <Settings2 aria-hidden="true" size={18} />
+            <span>设置和更多</span>
+            <ChevronDown aria-hidden="true" size={15} />
+          </button>
+          <div className="official-user-row">
+            <span className="official-user-avatar"><UserRound aria-hidden="true" size={15} /></span>
+            <span>{getAccountDisplayName()}</span>
+          </div>
+        </div>
+      </aside>
+
+      <div className="official-main-panel">
+        {page === "chat" && (
+          <ChatWorkspace
+            agentId={null}
+            key={location.key}
+            routeThreadId={chatRoute.threadId}
+          />
+        )}
+        {page === "agents" && (
+          <AgentsPage
+            openAgent={(agentId) =>
+              go(`${OFFICIAL_DEERFLOW_ROUTE_PREFIX}/workspace/agents/${encodeURIComponent(agentId)}/chats/new`)
+            }
+          />
+        )}
+        {page === "agent-chat" && (
+          <ChatWorkspace
+            agentId={chatRoute.agentId}
+            key={location.key}
+            routeThreadId={chatRoute.threadId}
+          />
+        )}
+        {page === "scheduled" && <ScheduledTasksPage selectedTaskId={scheduledTaskId} />}
+        {page === "settings" && <SettingsPage />}
+      </div>
+    </main>
+  );
+}
@@ -5,7 +5,6 @@ import { PageSidebar } from "@/components/page-sidebar";
 import { PageSidebarDark } from "@/components/page-sidebar-dark";
 import { CompactToolbox } from "@/components/workspace/compact-toolbox";
 import { isChatsIframeWorkspacePath } from "@/core/page-layout/chats-iframe-route";
-import { readSidebarEnabled } from "@/core/page-layout/sidebar-enabled";
 import { isWujieEnv } from "@/core/embed/wujie";
 import {
  isEmbedActive,
@@ -34,7 +33,6 @@ import { RoundtableJobNotifier } from "@/roundtable-planning/components/Roundtab
 function PageLayout() {
  const [collapsed, setCollapsed] = useState(false);
  const forceCollapsedSidebar = env.FORCE_COLLAPSED_SIDEBAR;
-  const sidebarEnabled = useMemo(() => readSidebarEnabled(), []);
  const location = useLocation();
  const { theme } = useTheme();
  const isDark = theme === "dark";
@@ -45,17 +43,11 @@ function PageLayout() {
  const thirdLevel = useActiveThirdLevel();
  const lightExpanded = lightNarrowSidebar && thirdLevel.length > 0;
  // 界面模式（外观设置）：用户显式选「全量/简洁」时以其为准；否则跟随管理员系统默认
-  // (default_layout_mode)；两者都没有才回退到会话级 sidebarEnabled（外部门户/yUserId
-  // 登录时置位）这一旧默认。这样无论是否走门户登录，「全量↔简洁」都能真正控制顶栏+侧边栏。
+  // (default_layout_mode)；两者都没有时使用内置默认「简洁模式」（useLayoutMode 兜底，
+  // 不再回退到会话级 sidebarEnabled 旧默认）。「全量↔简洁」始终能真正控制顶栏+侧边栏。
  const [layoutMode] = useLayoutMode();
  const chromeByPreference =
-    forceCollapsedSidebar
-      ? false
-      : layoutMode === "full"
-        ? true
-        : layoutMode === "compact"
-          ? false
-          : sidebarEnabled;
+    forceCollapsedSidebar ? false : layoutMode === "compact" ? false : true;
  // iframe 嵌入模式（外部系统 `&embed=1`，按标签页 sessionStorage）：去掉全局导航栏 + 侧边栏，
  // 只留问答/会商工作区本体。按 location 重算以跟随页内导航；非嵌入标签页恒为 false，不受影响。
  const embedActive = useMemo(
@@ -138,8 +138,9 @@ const emptyForm = {
  html_negative_prompt: "",
  html_reference_favorite_id: "",
  html_model_name: "",
-  // 参考选了内置模板(tpl:<id>)时的「数据抽取」开关：关闭=用模板默认数据，开启=检索抽取。
-  html_template_extract: false,
+  // 参考选了内置模板(tpl:<id>)时的「数据抽取」开关：默认开启(检索抽取+抽不到回退
+  // 模板原数据)，仅可转换模板生效；显式关闭=直接用模板默认数据。
+  html_template_extract: true,
 };

 /** 覆盖 Textarea 默认 field-sizing-content，避免输入过多时撑破弹窗 */
@@ -331,7 +332,8 @@ export default function ScheduledTasksPage({
      html_negative_prompt: html.negative_prompt ?? "",
      html_reference_favorite_id: html.reference_favorite_id ?? "",
      html_model_name: html.model_name ?? "",
-      html_template_extract: !!html.template_extract,
+      // 与后端缺省一致：未存该键(老任务)视为开启，仅显式 false 才关闭。
+      html_template_extract: html.template_extract !== false,
    });
    // Prefer the canonical cron_expr over the user-typed schedule_text: the
    // latter may be natural language ("每天9点") that parseCron can't read,
@@ -358,6 +360,10 @@ export default function ScheduledTasksPage({
    isTemplateAgent || form.require_html,
  );
  const selectedTemplate = htmlTemplates.find((t) => t.id === form.template_id);
+  // 「参考收藏页面」选中的内置模板(require_html 模式,值形如 tpl:<id>)。
+  const selectedTplRef = htmlTemplates.find(
+    (t) => `tpl:${t.id}` === form.html_reference_favorite_id,
+  );
  // 选中的模板是「只展示」型(convertible===false)时,不需要源 JSON,隐藏上传/输入。
  const templateDisplayOnly =
    isTemplateAgent && selectedTemplate?.convertible === false;
@@ -1396,23 +1402,28 @@ export default function ScheduledTasksPage({
                    )}
                  </div>
                </div>
-                {/* 参考选了内置模板(tpl:<id>)时：数据抽取开关。关闭=用模板默认数据。 */}
-                {form.html_reference_favorite_id.startsWith("tpl:") && (
-                  <div className="flex items-center justify-between rounded-md border p-3">
-                    <div className="min-w-0 pr-3">
-                      <p className="text-sm font-medium">执行数据抽取</p>
-                      <p className="text-muted-foreground text-xs">
-                        关闭则直接用所选模板的默认数据生成（含全部子页面）；开启才检索并按模板结构抽取数据填充。
-                      </p>
+                {/* 参考选了内置模板(tpl:<id>)时：数据抽取开关(仅可转换模板;只展示模板给提示)。 */}
+                {form.html_reference_favorite_id.startsWith("tpl:") &&
+                  (selectedTplRef?.convertible === false ? (
+                    <p className="text-muted-foreground rounded-md border p-3 text-xs">
+                      该模板暂为「直接展示已有数据」，执行时将原样输出其现有页面，不做数据抽取。
+                    </p>
+                  ) : (
+                    <div className="flex items-center justify-between rounded-md border p-3">
+                      <div className="min-w-0 pr-3">
+                        <p className="text-sm font-medium">执行数据抽取</p>
+                        <p className="text-muted-foreground text-xs">
+                          开启后执行时由所选智能体检索生成内容，并按模板结构抽取数据填充；抽取不到的子页面自动回退模板原有数据。关闭则直接用所选模板的默认数据生成（含全部子页面）。
+                        </p>
+                      </div>
+                      <Switch
+                        checked={form.html_template_extract}
+                        onCheckedChange={(v) =>
+                          setForm((value) => ({ ...value, html_template_extract: v }))
+                        }
+                      />
                    </div>
-                    <Switch
-                      checked={form.html_template_extract}
-                      onCheckedChange={(v) =>
-                        setForm((value) => ({ ...value, html_template_extract: v }))
-                      }
-                    />
-                  </div>
-                )}
+                  ))}
                <div className="flex flex-col gap-1">
                  <p className="text-muted-foreground text-xs">生成模型</p>
                  <Select
@@ -1,9 +1,55 @@
+import { BookOpenCheck, Sparkles } from "lucide-react";
+import { useMemo } from "react";
+import { useSearchParams } from "react-router-dom";
+
 import { SkillSettingsPage } from "@/components/workspace/settings/skill-settings-page";
+import { SkillKnowledgePanel } from "@/components/workspace/skills/SkillKnowledgePanel";
+import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";

 export default function SkillsPage() {
+  const [searchParams, setSearchParams] = useSearchParams();
+  const tab = useMemo(
+    () => (searchParams.get("tab") === "knowledge" ? "knowledge" : "skills"),
+    [searchParams],
+  );
+
+  const changeTab = (value: string) => {
+    const next = new URLSearchParams(searchParams);
+    if (value === "knowledge") next.set("tab", "knowledge");
+    else next.delete("tab");
+    setSearchParams(next, { replace: true });
+  };
+
  return (
-    <div className="flex size-full min-h-0 flex-col overflow-auto p-6">
-      <SkillSettingsPage />
-    </div>
+    <Tabs
+      value={tab}
+      onValueChange={changeTab}
+      className="flex size-full min-h-0 flex-col gap-0 overflow-hidden"
+    >
+      <header className="flex flex-wrap items-center justify-between gap-4 border-b bg-background px-6 py-4">
+        <div>
+          <h1 className="text-xl font-semibold">技能</h1>
+          <p className="mt-1 text-sm text-muted-foreground">
+            浏览和维护技能，也可以把多个技能的知识一次归纳到一个 Wiki 知识库。
+          </p>
+        </div>
+        <TabsList>
+          <TabsTrigger value="skills">
+            <Sparkles className="mr-2 size-4" />
+            技能列表
+          </TabsTrigger>
+          <TabsTrigger value="knowledge">
+            <BookOpenCheck className="mr-2 size-4" />
+            归纳到知识库
+          </TabsTrigger>
+        </TabsList>
+      </header>
+      <TabsContent value="skills" className="mt-0 min-h-0 flex-1 overflow-auto p-6">
+        <SkillSettingsPage embedded />
+      </TabsContent>
+      <TabsContent value="knowledge" className="mt-0 min-h-0 flex-1 overflow-hidden">
+        <SkillKnowledgePanel />
+      </TabsContent>
+    </Tabs>
  );
 }
@@ -309,7 +309,24 @@ export default function TaskButtonsPage() {
                              className="h-8 w-24"
                              title="发给宿主的参数名（默认 id）"
                            />
-                            <span className="text-muted-foreground">= 任务id（数字）</span>
+                            <span className="text-muted-foreground">=</span>
+                            {/* 行动分析(xdfx)：行动id 与任务id 不同，可选发哪种；其它业务固定任务id */}
+                            {tab === "xdfx" ? (
+                              <Select
+                                value={r.idKind}
+                                onValueChange={(v) => update(r.id, { idKind: v as TaskButton["idKind"] })}
+                              >
+                                <SelectTrigger className="h-8 w-24">
+                                  <SelectValue />
+                                </SelectTrigger>
+                                <SelectContent>
+                                  <SelectItem value="task">任务id</SelectItem>
+                                  <SelectItem value="action">行动id</SelectItem>
+                                </SelectContent>
+                              </Select>
+                            ) : (
+                              <span className="text-muted-foreground">任务id（数字）</span>
+                            )}
                          </div>
                        )}
                        <span className="text-muted-foreground w-full text-[11px]">
@@ -1,85 +1,96 @@
-import { useEffect, useState, type CSSProperties, type ReactNode } from 'react';
-import { Navigate, Route, Routes, useLocation, useParams } from 'react-router-dom';
+import { useEffect, useState, type CSSProperties, type ReactNode } from "react";
+import {
+  Navigate,
+  Route,
+  Routes,
+  useLocation,
+  useParams,
+} from "react-router-dom";

-import { getStoredAuth } from '@/core/auth';
-import { getAPIClient } from '@/core/api';
-import { isSentimentAgentVisible } from '@/core/sentiment-agent/config';
+import { getStoredAuth } from "@/core/auth";
+import { getAPIClient } from "@/core/api";
+import { isSentimentAgentVisible } from "@/core/sentiment-agent/config";
 import {
  resolveChatsIframeEntryRedirect,
  resolveStandardChatFallback,
-} from '@/core/page-layout/chats-iframe-route';
-import { isEmbeddedHost } from '@/core/embed/frame-context';
+} from "@/core/page-layout/chats-iframe-route";
+import { isEmbeddedHost } from "@/core/embed/frame-context";

-import { SidebarInset, SidebarProvider } from '@/components/ui/sidebar';
-import { PromptInputProvider } from '@/components/ai-elements/prompt-input';
+import { SidebarInset, SidebarProvider } from "@/components/ui/sidebar";
+import { PromptInputProvider } from "@/components/ai-elements/prompt-input";
 import {
  CompactShortcutButtons,
  LayoutModeSwitcher,
  ThemeSwitcher,
-} from '@/components/workspace/appearance-controls';
-import { WorkspaceSidebar } from '@/components/workspace/workspace-sidebar';
-import { UserIdentityBadge } from '@/components/workspace/user-identity-badge';
-import { CommandPalette } from '@/components/workspace/command-palette';
-import { Toaster } from 'sonner';
-import { SubtasksProvider } from '@/core/tasks/context';
-import { ArtifactsProvider } from '@/components/workspace/artifacts';
-import { DocumentRewritePresentationProvider } from '@/core/document-rewrite/context';
+} from "@/components/workspace/appearance-controls";
+import { WorkspaceSidebar } from "@/components/workspace/workspace-sidebar";
+import { UserIdentityBadge } from "@/components/workspace/user-identity-badge";
+import { CommandPalette } from "@/components/workspace/command-palette";
+import { Toaster } from "sonner";
+import { SubtasksProvider } from "@/core/tasks/context";
+import { ArtifactsProvider } from "@/components/workspace/artifacts";
+import { DocumentRewritePresentationProvider } from "@/core/document-rewrite/context";

-import { RouteBaseProvider } from '@/core/route-base';
-import { agentRefOfThread } from '@/core/threads/utils';
+import { RouteBaseProvider } from "@/core/route-base";
+import { agentRefOfThread } from "@/core/threads/utils";

-import ChatsPage from './ChatsPage';
-import ChatPage from './ChatPage';
-import ArtifactLibraryPage from './ArtifactLibraryPage';
-import IframeChatPage from './IframeChatPage';
-import AgentsPage from './AgentsPage';
-import AgentChatPage from './AgentChatPage';
-import SentimentAgentChatPage from './SentimentAgentChatPage';
-import NewAgentPage from './NewAgentPage';
-import AdminAgentsPage from './AdminAgentsPage';
-import AdminScheduledTasksPage from './AdminScheduledTasksPage';
-import AdminSkillsPage from './AdminSkillsPage';
-import ScheduledTaskRunDetailPage from './ScheduledTaskRunDetailPage';
-import ScheduledTasksPage from './ScheduledTasksPage';
-import LlmWikiKnowledgePage from './LlmWikiKnowledgePage';
-import AssistantKnowledgePage from './AssistantKnowledgePage';
-import WeKnoraWikiManagementPage from '@/strategy-components/components/resource-management/llmwiki/WeKnoraWikiManagementPage';
-import WeKnoraWikiPageView from '@/strategy-components/components/resource-management/llmwiki/WeKnoraWikiPageView';
-import MarkdownDocxEditorPage from './MarkdownDocxEditorPage';
-import LlmMetricsPage from './LlmMetricsPage';
-import CheckpointMigrationPage from './CheckpointMigrationPage';
-import MemoryPage from './MemoryPage';
-import PromptPrefixSettingsPage from './PromptPrefixSettingsPage';
-import PrivateSquareSettingsPage from './PrivateSquareSettingsPage';
-import ModelConcurrencySettingsPage from './ModelConcurrencySettingsPage';
-import ModelManagementPage from './ModelManagementPage';
-import PublishSquaresSettingsPage from './PublishSquaresSettingsPage';
-import SkillCompressionSettingsPage from './SkillCompressionSettingsPage';
-import SkillEvolutionPage from './SkillEvolutionPage';
-import SkillsPage from './SkillsPage';
-import UsersPage from './UsersPage';
-import AdminUserActivityPage from './AdminUserActivityPage';
-import AdminMemoryPage from './AdminMemoryPage';
-import AdminUserHubPage from './AdminUserHubPage';
-import TagsPage from './TagsPage';
-import PositionsPage from './PositionsPage';
-import PositionRolesPage from './PositionRolesPage';
-import PluginManagementPage from './PluginManagementPage';
-import RecommendedQuestionsPage from './RecommendedQuestionsPage';
-import AIWritingPage from '@/open-canvas/pages/AIWritingPage';
-import DeepResearchPage from './DeepResearchPage';
-import ReportStructureCreatePage from './deep-research/ReportStructureCreatePage';
-import EnterpriseResearchPage from './EnterpriseResearchPage';
-import StudioNotebooksPage from './StudioNotebooksPage';
-import StudioNotebookDetailPage from './StudioNotebookDetailPage';
-import RoundtablePlanningPage from '@/roundtable-planning/pages/RoundtablePlanningPage';
-import PositionRoundtablePage from '@/position-roundtable/pages/PositionRoundtablePage';
-import EightBfRoundtablePage from '@/eightbf-roundtable/pages/EightBfRoundtablePage';
-import BusinessChainEditorPage from '@/roundtable-planning/pages/BusinessChainEditorPage';
-import BusinessChainListPage from '@/roundtable-planning/pages/BusinessChainListPage';
-import DispatchChainPreviewPage from '@/roundtable-planning/pages/DispatchChainPreviewPage';
-import '@/roundtable-planning/styles/roundtable-planning.css';
-import { cn } from '@/lib/utils';
+import ChatsPage from "./ChatsPage";
+import ChatPage from "./ChatPage";
+import ArtifactLibraryPage from "./ArtifactLibraryPage";
+import IframeChatPage from "./IframeChatPage";
+import AgentsPage from "./AgentsPage";
+import AgentChatPage from "./AgentChatPage";
+import SentimentAgentChatPage from "./SentimentAgentChatPage";
+import NewAgentPage from "./NewAgentPage";
+import AdminAgentsPage from "./AdminAgentsPage";
+import AdminScheduledTasksPage from "./AdminScheduledTasksPage";
+import AdminSkillsPage from "./AdminSkillsPage";
+import ScheduledTaskRunDetailPage from "./ScheduledTaskRunDetailPage";
+import ScheduledTasksPage from "./ScheduledTasksPage";
+import LlmWikiKnowledgePage from "./LlmWikiKnowledgePage";
+import AssistantKnowledgePage from "./AssistantKnowledgePage";
+import WeKnoraWikiManagementPage from "@/strategy-components/components/resource-management/llmwiki/WeKnoraWikiManagementPage";
+import WeKnoraWikiPageView from "@/strategy-components/components/resource-management/llmwiki/WeKnoraWikiPageView";
+import WeKnoraPackageTransfersPage from "@/strategy-components/components/resource-management/llmwiki/WeKnoraPackageTransfersPage";
+import MarkdownDocxEditorPage from "./MarkdownDocxEditorPage";
+import LlmMetricsPage from "./LlmMetricsPage";
+import CheckpointMigrationPage from "./CheckpointMigrationPage";
+import MemoryPage from "./MemoryPage";
+import PromptPrefixSettingsPage from "./PromptPrefixSettingsPage";
+import PrivateSquareSettingsPage from "./PrivateSquareSettingsPage";
+import ModelConcurrencySettingsPage from "./ModelConcurrencySettingsPage";
+import ModelManagementPage from "./ModelManagementPage";
+import PublishSquaresSettingsPage from "./PublishSquaresSettingsPage";
+import SkillCompressionSettingsPage from "./SkillCompressionSettingsPage";
+import SkillEvolutionPage from "./SkillEvolutionPage";
+import SkillsPage from "./SkillsPage";
+import UsersPage from "./UsersPage";
+import AdminUserActivityPage from "./AdminUserActivityPage";
+import AdminMemoryPage from "./AdminMemoryPage";
+import AdminUserHubPage from "./AdminUserHubPage";
+import TagsPage from "./TagsPage";
+import PositionsPage from "./PositionsPage";
+import PositionRolesPage from "./PositionRolesPage";
+import PluginManagementPage from "./PluginManagementPage";
+import RecommendedQuestionsPage from "./RecommendedQuestionsPage";
+import AIWritingPage from "@/open-canvas/pages/AIWritingPage";
+import DeepResearchPage from "./DeepResearchPage";
+import ReportStructureCreatePage from "./deep-research/ReportStructureCreatePage";
+import EnterpriseResearchPage from "./EnterpriseResearchPage";
+import StudioNotebooksPage from "./StudioNotebooksPage";
+import StudioNotebookDetailPage from "./StudioNotebookDetailPage";
+import RoundtablePlanningPage from "@/roundtable-planning/pages/RoundtablePlanningPage";
+import PositionRoundtablePage from "@/position-roundtable/pages/PositionRoundtablePage";
+import EightBfRoundtablePage from "@/eightbf-roundtable/pages/EightBfRoundtablePage";
+import BusinessChainEditorPage from "@/roundtable-planning/pages/BusinessChainEditorPage";
+import BusinessChainListPage from "@/roundtable-planning/pages/BusinessChainListPage";
+import DispatchChainPreviewPage from "@/roundtable-planning/pages/DispatchChainPreviewPage";
+import "@/roundtable-planning/styles/roundtable-planning.css";
+import ReportCollaborationPage, {
+  ReportCollaborationSessionPage,
+} from "@/report-collaboration/pages/ReportCollaborationPage";
+import "@/report-collaboration/styles/report-collaboration.css";
+import { cn } from "@/lib/utils";

 function NotebookDetailPageWithKey() {
  const { notebookId } = useParams<{ notebookId: string }>();
@@ -92,14 +103,37 @@ function NewAgentPageWithKey() {
  return <NewAgentPage key={thread_id} />;
 }

+// 报告协作会话页：按 sessionId 重挂（旧 SSE/状态不串台）。
+function ReportCollaborationSessionRoute({
+  layoutProps,
+}: {
+  layoutProps: {
+    pageSidebarCollapsed: boolean;
+    pageSidebarHidden: boolean;
+    workspaceSidebarHidden: boolean;
+    headerHidden: boolean;
+    compactActionsHidden: boolean;
+    compactWorkspaceSidebar: boolean;
+    pageSidebarDark: boolean;
+    forceWorkspaceSidebarCollapsed: boolean;
+  };
+}) {
+  const { sessionId } = useParams<{ sessionId: string }>();
+  return (
+    <WorkspaceLayout {...layoutProps}>
+      <ReportCollaborationSessionPage key={sessionId} sessionId={sessionId ?? ""} />
+    </WorkspaceLayout>
+  );
+}
+
 function shouldShowCompactTopActions(pathname: string): boolean {
  return (
-    pathname === '/page/workspace/agents' ||
-    pathname === '/page/workspace/skills' ||
-    pathname === '/page/workspace/memory' ||
-    pathname === '/page/workspace/library' ||
-    pathname === '/page/workspace/knowledge' ||
-    pathname.startsWith('/page/workspace/knowledge/')
+    pathname === "/page/workspace/agents" ||
+    pathname === "/page/workspace/skills" ||
+    pathname === "/page/workspace/memory" ||
+    pathname === "/page/workspace/library" ||
+    pathname === "/page/workspace/knowledge" ||
+    pathname.startsWith("/page/workspace/knowledge/")
  );
 }

@@ -157,47 +191,52 @@ export function WorkspaceLayout({
  // 全量模式下通用问答（/page/workspace/chats*）的历史侧栏默认展开；其余紧凑页
  // （如智能体对话，为聊天区更宽而默认收起）维持原默认。
  const pathname = useLocation().pathname;
-  const isGeneralQa = pathname.startsWith('/page/workspace/chats');
+  const isGeneralQa = pathname.startsWith("/page/workspace/chats");
  const showCompactTopActions =
-    headerHidden && !compactActionsHidden && shouldShowCompactTopActions(pathname);
+    headerHidden &&
+    !compactActionsHidden &&
+    shouldShowCompactTopActions(pathname);

  const pageSidebarWidth = pageSidebarHidden
-    ? '0rem'
+    ? "0rem"
    : pageSidebarDark
      ? pageSidebarCollapsed
-        ? '0rem'
-        : '118px'
+        ? "0rem"
+        : "118px"
      : pageSidebarCollapsed
-        ? '4rem'
-        : '16rem';
+        ? "4rem"
+        : "16rem";

  return (
    <SidebarProvider
      className={[
-        'relative h-full w-full overflow-x-hidden',
-        '[&_[data-slot=sidebar-container]]:absolute',
-        '[&_[data-slot=sidebar-container]]:left-0',
-        '[&_[data-slot=sidebar-container]]:top-0',
-      ].join(' ')}
+        "relative h-full w-full overflow-x-hidden",
+        "[&_[data-slot=sidebar-container]]:absolute",
+        "[&_[data-slot=sidebar-container]]:left-0",
+        "[&_[data-slot=sidebar-container]]:top-0",
+      ].join(" ")}
      style={
        {
-          '--page-sidebar-width': pageSidebarWidth,
-          '--header-height': headerHidden ? '0rem' : '4rem',
+          "--page-sidebar-width": pageSidebarWidth,
+          "--header-height": headerHidden ? "0rem" : "4rem",
        } as CSSProperties
      }
      // Agent and general-chat routes share this layout component. Keep their
      // sidebar state separate: otherwise React preserves the collapsed agent
      // state when a history item switches to `/chats/:thread_id`, while the
      // new page's header button is meant to control GeneralQaSidebar.
-      key={`${String(compactWorkspaceSidebar)}:${isGeneralQa ? 'general' : 'workspace'}`}
+      key={`${String(compactWorkspaceSidebar)}:${isGeneralQa ? "general" : "workspace"}`}
      data-page-sidebar-collapsed={pageSidebarCollapsed}
      defaultOpen={
        forceWorkspaceSidebarCollapsed
          ? false
-          : (defaultHistorySidebarOpen ?? (isGeneralQa || !compactWorkspaceSidebar))
+          : (defaultHistorySidebarOpen ??
+            (isGeneralQa || !compactWorkspaceSidebar))
      }
      open={forceWorkspaceSidebarCollapsed ? false : undefined}
-      onOpenChange={forceWorkspaceSidebarCollapsed ? () => undefined : undefined}
+      onOpenChange={
+        forceWorkspaceSidebarCollapsed ? () => undefined : undefined
+      }
      disableToggle={forceWorkspaceSidebarCollapsed}
    >
      {!workspaceSidebarHidden && (
@@ -207,7 +246,7 @@ export function WorkspaceLayout({
        />
      )}
      <SidebarInset
-        className={cn('min-w-0', insetOverflowHidden && 'overflow-hidden')}
+        className={cn("min-w-0", insetOverflowHidden && "overflow-hidden")}
      >
        {showCompactTopActions ? (
          <>
@@ -244,9 +283,14 @@ export function ChatRuntime({ children }: { children: ReactNode }) {
 */
 function NewChatContent() {
  const location = useLocation();
-  const agentId = new URLSearchParams(location.search).get('agent');
+  const agentId = new URLSearchParams(location.search).get("agent");
  if (agentId) {
-    return <AgentChatPage key={`${agentId}:${location.key}`} embeddedAgentId={agentId} />;
+    return (
+      <AgentChatPage
+        key={`${agentId}:${location.key}`}
+        embeddedAgentId={agentId}
+      />
+    );
  }
  return <ChatPage />;
 }
@@ -393,8 +437,8 @@ function AgentAwareChatThreadContent() {
        };
        // Task-bound threads need their task host to preserve the purpose gate,
        // action partitioning, and other task-specific controls.
-        const isTaskThread = typeof record.metadata?.taskId === 'string';
-        setAgentId(isTaskThread ? null : agentRefOfThread(record) ?? null);
+        const isTaskThread = typeof record.metadata?.taskId === "string";
+        setAgentId(isTaskThread ? null : (agentRefOfThread(record) ?? null));
      })
      .catch(() => {
        if (!cancelled) setAgentId(null);
@@ -537,11 +581,18 @@ export default function WorkspaceRoutes({
        />
        <Route
          path="chats_iframe/new"
-          element={<IframeChatEntryRoute layoutProps={layoutProps} hasThreadParam={false} />}
+          element={
+            <IframeChatEntryRoute
+              layoutProps={layoutProps}
+              hasThreadParam={false}
+            />
+          }
        />
        <Route
          path="chats_iframe/:thread_id"
-          element={<IframeChatEntryRoute layoutProps={layoutProps} hasThreadParam />}
+          element={
+            <IframeChatEntryRoute layoutProps={layoutProps} hasThreadParam />
+          }
        />
        <Route
          path="agents"
@@ -575,7 +626,10 @@ export default function WorkspaceRoutes({
          path="agents/sentiment-analysis/chats"
          element={
            isSentimentAgentVisible() ? (
-              <Navigate to="/page/workspace/agents/sentiment-analysis/chats/new" replace />
+              <Navigate
+                to="/page/workspace/agents/sentiment-analysis/chats/new"
+                replace
+              />
            ) : (
              <Navigate to="/page/workspace/agents" replace />
            )
@@ -605,7 +659,9 @@ export default function WorkspaceRoutes({
                <AgentChatPage
                  showAgentList
                  compactAppearanceActions={
-                    headerHidden && !compactActionsHidden ? <CompactAppearanceActions /> : undefined
+                    headerHidden && !compactActionsHidden ? (
+                      <CompactAppearanceActions />
+                    ) : undefined
                  }
                />
              </ChatRuntime>
@@ -704,7 +760,9 @@ export default function WorkspaceRoutes({
          element={
            <WorkspaceLayout {...layoutProps}>
              <ChatRuntime>
-                <RoundtablePlanningPage compactChrome={headerHidden && !compactActionsHidden} />
+                <RoundtablePlanningPage
+                  compactChrome={headerHidden && !compactActionsHidden}
+                />
              </ChatRuntime>
            </WorkspaceLayout>
          }
@@ -714,7 +772,9 @@ export default function WorkspaceRoutes({
          element={
            <WorkspaceLayout {...layoutProps}>
              <ChatRuntime>
-                <EightBfRoundtablePage compactChrome={headerHidden && !compactActionsHidden} />
+                <EightBfRoundtablePage
+                  compactChrome={headerHidden && !compactActionsHidden}
+                />
              </ChatRuntime>
            </WorkspaceLayout>
          }
@@ -724,7 +784,9 @@ export default function WorkspaceRoutes({
          element={
            <WorkspaceLayout {...layoutProps}>
              <ChatRuntime>
-                <PositionRoundtablePage compactChrome={headerHidden && !compactActionsHidden} />
+                <PositionRoundtablePage
+                  compactChrome={headerHidden && !compactActionsHidden}
+                />
              </ChatRuntime>
            </WorkspaceLayout>
          }
@@ -745,6 +807,20 @@ export default function WorkspaceRoutes({
            </WorkspaceLayout>
          }
        />
+        {/* AgentScope 报告协作工作台：左对话（复用 MessageList）/右画布的独立新页面，
+            不与旧多智能体会商共享状态。key 绑定 sessionId——切换会话重挂干净的页面。 */}
+        <Route
+          path="report-collaboration"
+          element={
+            <WorkspaceLayout {...layoutProps}>
+              <ReportCollaborationPage />
+            </WorkspaceLayout>
+          }
+        />
+        <Route
+          path="report-collaboration/:sessionId"
+          element={<ReportCollaborationSessionRoute layoutProps={layoutProps} />}
+        />
        {/* Phase 7 临时预览入口：派活链路流程图弹窗（假数据自测，接通后台后可删） */}
        <Route
          path="roundtable/chain-preview"
@@ -794,6 +870,14 @@ export default function WorkspaceRoutes({
            </WorkspaceLayout>
          }
        />
+        <Route
+          path="knowledge/:noteId/packages"
+          element={
+            <WorkspaceLayout {...layoutProps}>
+              <WeKnoraPackageTransfersPage />
+            </WorkspaceLayout>
+          }
+        />
        <Route
          path="knowledge/markdown-editor"
          element={
@@ -818,7 +902,9 @@ export default function WorkspaceRoutes({
          path="scheduled/tasks"
          element={
            <WorkspaceLayout {...layoutProps}>
-              <ScheduledTasksPage compactChrome={headerHidden && !compactActionsHidden} />
+              <ScheduledTasksPage
+                compactChrome={headerHidden && !compactActionsHidden}
+              />
            </WorkspaceLayout>
          }
        />
@@ -834,7 +920,7 @@ export default function WorkspaceRoutes({
        <Route
          path="admin"
          element={
-            getStoredAuth()?.system_role === 'admin' ? (
+            getStoredAuth()?.system_role === "admin" ? (
              <WorkspaceLayout {...layoutProps} pageSidebarHidden>
                <AdminUserHubPage />
              </WorkspaceLayout>
@@ -859,7 +945,7 @@ export default function WorkspaceRoutes({
        <Route
          path="admin/scheduled-tasks"
          element={
-            getStoredAuth()?.system_role === 'admin' ? (
+            getStoredAuth()?.system_role === "admin" ? (
              <WorkspaceLayout {...layoutProps}>
                <AdminScheduledTasksPage />
              </WorkspaceLayout>
@@ -871,7 +957,7 @@ export default function WorkspaceRoutes({
        <Route
          path="admin/agents"
          element={
-            getStoredAuth()?.system_role === 'admin' ? (
+            getStoredAuth()?.system_role === "admin" ? (
              <WorkspaceLayout {...layoutProps}>
                <AdminAgentsPage />
              </WorkspaceLayout>
@@ -883,7 +969,7 @@ export default function WorkspaceRoutes({
        <Route
          path="admin/skills"
          element={
-            getStoredAuth()?.system_role === 'admin' ? (
+            getStoredAuth()?.system_role === "admin" ? (
              <WorkspaceLayout {...layoutProps}>
                <AdminSkillsPage />
              </WorkspaceLayout>
@@ -903,7 +989,7 @@ export default function WorkspaceRoutes({
        <Route
          path="admin/plugins"
          element={
-            getStoredAuth()?.system_role === 'admin' ? (
+            getStoredAuth()?.system_role === "admin" ? (
              <WorkspaceLayout {...layoutProps}>
                <PluginManagementPage />
              </WorkspaceLayout>
@@ -915,7 +1001,7 @@ export default function WorkspaceRoutes({
        <Route
          path="admin/positions"
          element={
-            getStoredAuth()?.system_role === 'admin' ? (
+            getStoredAuth()?.system_role === "admin" ? (
              <WorkspaceLayout {...layoutProps}>
                <PositionsPage />
              </WorkspaceLayout>
@@ -927,7 +1013,7 @@ export default function WorkspaceRoutes({
        <Route
          path="admin/position-roles"
          element={
-            getStoredAuth()?.system_role === 'admin' ? (
+            getStoredAuth()?.system_role === "admin" ? (
              <WorkspaceLayout {...layoutProps}>
                <PositionRolesPage />
              </WorkspaceLayout>
@@ -939,7 +1025,7 @@ export default function WorkspaceRoutes({
        <Route
          path="settings/recommended-questions"
          element={
-            getStoredAuth()?.system_role === 'admin' ? (
+            getStoredAuth()?.system_role === "admin" ? (
              <WorkspaceLayout {...layoutProps}>
                <RecommendedQuestionsPage />
              </WorkspaceLayout>
@@ -951,7 +1037,7 @@ export default function WorkspaceRoutes({
        <Route
          path="settings/prompt-prefix"
          element={
-            getStoredAuth()?.system_role === 'admin' ? (
+            getStoredAuth()?.system_role === "admin" ? (
              <WorkspaceLayout {...layoutProps}>
                <PromptPrefixSettingsPage />
              </WorkspaceLayout>
@@ -963,7 +1049,7 @@ export default function WorkspaceRoutes({
        <Route
          path="settings/private-square"
          element={
-            getStoredAuth()?.system_role === 'admin' ? (
+            getStoredAuth()?.system_role === "admin" ? (
              <WorkspaceLayout {...layoutProps}>
                <PrivateSquareSettingsPage />
              </WorkspaceLayout>
@@ -975,7 +1061,7 @@ export default function WorkspaceRoutes({
        <Route
          path="admin/models"
          element={
-            getStoredAuth()?.system_role === 'admin' ? (
+            getStoredAuth()?.system_role === "admin" ? (
              <WorkspaceLayout {...layoutProps}>
                <ModelManagementPage />
              </WorkspaceLayout>
@@ -987,7 +1073,7 @@ export default function WorkspaceRoutes({
        <Route
          path="settings/model-concurrency"
          element={
-            getStoredAuth()?.system_role === 'admin' ? (
+            getStoredAuth()?.system_role === "admin" ? (
              <WorkspaceLayout {...layoutProps}>
                <ModelConcurrencySettingsPage />
              </WorkspaceLayout>
@@ -999,7 +1085,7 @@ export default function WorkspaceRoutes({
        <Route
          path="settings/publish-squares"
          element={
-            getStoredAuth()?.system_role === 'admin' ? (
+            getStoredAuth()?.system_role === "admin" ? (
              <WorkspaceLayout {...layoutProps}>
                <PublishSquaresSettingsPage />
              </WorkspaceLayout>
@@ -1011,7 +1097,7 @@ export default function WorkspaceRoutes({
        <Route
          path="settings/skill-compression"
          element={
-            getStoredAuth()?.system_role === 'admin' ? (
+            getStoredAuth()?.system_role === "admin" ? (
              <WorkspaceLayout {...layoutProps}>
                <SkillCompressionSettingsPage />
              </WorkspaceLayout>
@@ -1023,7 +1109,7 @@ export default function WorkspaceRoutes({
        <Route
          path="settings/llm-metrics"
          element={
-            getStoredAuth()?.system_role === 'admin' ? (
+            getStoredAuth()?.system_role === "admin" ? (
              <WorkspaceLayout {...layoutProps}>
                <LlmMetricsPage />
              </WorkspaceLayout>
@@ -1035,7 +1121,7 @@ export default function WorkspaceRoutes({
        <Route
          path="settings/checkpoint-migration"
          element={
-            getStoredAuth()?.system_role === 'admin' ? (
+            getStoredAuth()?.system_role === "admin" ? (
              <WorkspaceLayout {...layoutProps}>
                <CheckpointMigrationPage />
              </WorkspaceLayout>
@@ -99,6 +99,7 @@ import {
  extractToolResultPayload,
  hasToolCalls,
 } from "@/core/messages/utils";
+import { normalizeSearchResults } from "@/core/messages/search-results";
 import { downloadMarkdownAsDocx } from "@/core/scheduled-tasks/markdown-docx";
 import {
  type DeepResearchSession,
@@ -273,6 +274,23 @@ function assembleStreamingReport(targets: Record<string, { content: string; vers
  return parts.join("\n\n");
 }

+const REPORT_REFUSAL_PATTERN = /(?:无法|不能|未能|不可以).{0,24}?(?:生成|撰写|产出|输出).{0,12}?报告/s;
+
+function isRefusalReportText(value: string): boolean {
+  const text = value || "";
+  const compact = text.replace(/\s+/g, "");
+  // Empty means the writer has not emitted Markdown yet (thinking / connecting).
+  // Treating that as a refusal opened the sandbox on an error card while the
+  // model was still working.
+  if (!compact) return false;
+  const headings = text.match(/^#{1,6}\s+\S+/gm) ?? [];
+  // A structured report may discuss evidence gaps. Only treat a short,
+  // unstructured refusal as “no report”, otherwise the zero-source fallback
+  // is hidden behind the diagnostic card and looks like writing failed.
+  if (headings.length >= 2) return false;
+  return REPORT_REFUSAL_PATTERN.test(compact);
+}
+
 function researchExportBaseName(session: DeepResearchSession): string {
  const title = (session.title || session.query || "研究报告")
    .replace(/[\\/:*?"<>|]/g, "-")
@@ -416,6 +434,100 @@ function countCollectorMaterials(messages: readonly Message[] | undefined): numb
  return unique.size;
 }

+const COLLECTOR_PERSIST_LIMIT = 80;
+const WRITE_FALLBACK_MATERIAL_LIMIT = 20;
+const SKIP_COLLECTOR_PERSIST_TOOLS = new Set(["ask_clarification", "write_todos"]);
+
+function collectorMaterialKey(item: Record<string, unknown>): string {
+  const text = (value: unknown) => typeof value === "string" ? value.trim() : "";
+  return text(item.id) || text(item.url) || `${text(item.title)}\n${text(item.raw_content).slice(0, 240)}`;
+}
+
+function isCompleteToolPayload(message: Message): boolean {
+  const payload = extractToolResultPayload(message);
+  if (payload == null) return false;
+  if (typeof payload === "string") {
+    const trimmed = payload.trim();
+    if (!trimmed) return false;
+    if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
+      try {
+        JSON.parse(trimmed);
+        return true;
+      } catch {
+        return false;
+      }
+    }
+    return trimmed.length > 20;
+  }
+  return typeof payload === "object";
+}
+
+/** Freeze a compact evidence pool for a worker-independent report job. */
+function snapshotCollectorMaterials(
+  messages: readonly Message[] | undefined,
+  options?: { limit?: number; includeSummary?: boolean },
+): Record<string, unknown>[] {
+  if (!messages?.length) return [];
+  const limit = options?.limit ?? COLLECTOR_PERSIST_LIMIT;
+  const frozen: Record<string, unknown>[] = [];
+  const seen = new Set<string>();
+  const text = (value: unknown) => typeof value === "string" ? value.trim() : "";
+  const addNormalized = (item: ReturnType<typeof normalizeSearchResults>[number], toolName: string) => {
+    const url = text(item.url);
+    const id = text(item.id) || text(item.recUuid) || text(item.uuid) || text(item.docId);
+    const title = text(item.title) || `检索结果 ${frozen.length + 1}`;
+    const content = text(item.content) || text(item.snippet);
+    if (!url && !id && !content) return;
+    const key = id || url || `${title}\n${content.slice(0, 240)}`;
+    if (seen.has(key) || frozen.length >= limit) return;
+    seen.add(key);
+    frozen.push({
+      id: id || undefined,
+      title: title.slice(0, 500),
+      url: url.slice(0, 2_000) || undefined,
+      raw_content: content.slice(0, 6_000),
+      snippet: (text(item.snippet) || content).slice(0, 500) || undefined,
+      source: text(item.source) || toolName || "collector",
+      source_type: toolName === "web_search" ? "web" : "other",
+      published_at: text(item.published_date) || text(item.publishedDate) || text(item.date) || undefined,
+      rec_uuid: text(item.recUuid) || text(item.uuid) || undefined,
+    });
+  };
+  for (const message of messages) {
+    if (message.type === "tool" && message.name && SKIP_COLLECTOR_PERSIST_TOOLS.has(message.name)) {
+      continue;
+    }
+    const toolName = message.name || (message.type === "tool" ? "collector_tool" : "");
+    const payload = message.type === "tool" || message.type === "ai"
+      ? extractToolResultPayload(message)
+      : undefined;
+    const rows = normalizeSearchResults(
+      payload && typeof payload === "object" && !Array.isArray(payload)
+        ? payload
+        : typeof payload === "string"
+          ? payload
+          : undefined,
+    );
+    for (const row of rows) addNormalized(row, toolName || "collector");
+  }
+  if (!frozen.length && options?.includeSummary !== false) {
+    const summary = [...messages].reverse().find(
+      (message) => message.type === "ai" && extractContentFromMessage(message).trim(),
+    );
+    const content = summary ? extractContentFromMessage(summary).trim() : "";
+    if (content) {
+      frozen.push({
+        title: "收集员小结",
+        raw_content: content.slice(0, 6_000),
+        snippet: content.slice(0, 500),
+        source: "collector",
+        source_type: "other",
+      });
+    }
+  }
+  return frozen;
+}
+
 function countEventMaterials(events: ProgressEvent[]): number {
  const unique = new Set<string>();
  for (const event of events) {
@@ -512,9 +624,18 @@ function DeepResearchWorkbenchInner() {
  const replayedTraceJobs = useRef(new Set<string>());
  const pendingReportEvents = useRef<ProgressEvent[]>([]);
  const reportAnimationFrame = useRef<number | null>(null);
+  const boundStreamJobRef = useRef<string | null>(null);
+  const openReportRef = useRef<() => void>(() => {});
+  const refetchLiveJobRef = useRef<() => void>(() => {});
+  const inlineGenerationSessionRef = useRef<DeepResearchSession | null>(null);
  // Chat-collection flow bookkeeping.
  const pendingInitialQuery = useRef<string | null>(null);
  const finishedTurnKey = useRef<string | null>(null);
+  const persistedCollectorKey = useRef("");
+  const persistedCollectorToolIds = useRef(new Set<string>());
+  const persistedCollectorMaterialKeys = useRef(new Set<string>());
+  const collectorPersistChain = useRef(Promise.resolve());
+  const collectorSessionIdRef = useRef<string | null>(null);
  const followUpAbortRef = useRef<AbortController | null>(null);

  const refetchSession = sessionQuery.refetch;
@@ -523,6 +644,22 @@ function DeepResearchWorkbenchInner() {
  const refetchReportVariants = reportVariants.refetch;

  const session = sessionQuery.data;
+  const loggedSessionDiagnosticKey = useRef<string | null>(null);
+  useEffect(() => {
+    if (!session) return;
+    const diagnostics = session.runtimeDiagnostics;
+    if (!session.error && !diagnostics) return;
+    const key = `${session.id}:${session.activeJobId ?? session.usage?.lastJobId ?? ""}:${session.error ?? ""}`;
+    if (loggedSessionDiagnosticKey.current === key) return;
+    loggedSessionDiagnosticKey.current = key;
+    console.warn("[深度研究] session_runtime_diagnostic", {
+      sessionId: session.id,
+      status: session.status,
+      error: session.error,
+      activeJobId: session.activeJobId,
+      runtimeDiagnostics: diagnostics,
+    });
+  }, [session]);
  const generatedReportVariants = useMemo(() => {
    const byId = new Map((reportVariants.data ?? []).map((item) => [item.id, item]));
    if (inlineGeneratedReport && session && inlineGeneratedReport.parentSessionId === session.id) {
@@ -585,7 +722,7 @@ function DeepResearchWorkbenchInner() {
      : "";
  // 全文改写启动后，右侧只渲染临时草稿：首个 token 到达前保持空白，
  // 不把旧报告混在新稿前面。真实 report.md 仍只在后台校验 + CAS 成功后替换。
-  const displayedReport = reportDocumentRewrite.isActive
+  const rawDisplayedReport = reportDocumentRewrite.isActive
    ? reportDocumentRewrite.run.draft
    : reportRewritePreview
      || (viewingLiveGeneration
@@ -593,6 +730,65 @@ function DeepResearchWorkbenchInner() {
        : viewingParentReport
          ? (session?.reportMarkdown || "")
          : sandboxVariantSession?.reportMarkdown || "");
+  // Never hide a backend response.  Hiding refusal prose also removed the
+  // virtual report file and its sandbox-open trigger, leaving operators with
+  // neither a report nor an error.  The backend now replaces refusal output at
+  // its final persistence gate; this client-side signal remains visible when
+  // a worker is stale or a new provider wording escapes that guard.
+  const refusalReportDetected = isRefusalReportText(rawDisplayedReport);
+  const hasUsableDisplayedReport = Boolean(rawDisplayedReport.trim()) && !refusalReportDetected;
+  const streamStillOpen = Boolean(run.jobId && run.phase !== "done" && run.phase !== "failed");
+  const liveWriting = Boolean(
+    isRunning
+    || isAwaitingReview
+    || reportDocumentRewrite.isActive
+    || streamStillOpen
+    || (viewingLiveGeneration && run.phase !== "done"),
+  );
+  // Never replace a live write with the operator diagnostic. An empty sandbox
+  // during thinking is normal; the JSON dump is only for a finished run that
+  // still has no usable Markdown.
+  const repairOnlyError = typeof session?.error === "string"
+    && session.error.includes("session_read_repair");
+  const showRunDiagnostic = Boolean(
+    !liveWriting && !hasUsableDisplayedReport && (
+      refusalReportDetected
+      || session?.status === "failed"
+      || (Boolean(session?.error) && !repairOnlyError)
+    ),
+  );
+  const runtimeDiagnosticText = JSON.stringify(
+    session?.runtimeDiagnostics ?? {
+      revision: "frontend-fallback-diagnostic",
+      session: {
+        id: session?.id,
+        status: session?.status,
+        sourceCount: session?.sourceCount ?? 0,
+        activeJobId: session?.activeJobId,
+      },
+      error: session?.error ?? "报告正文被识别为拒绝型输出",
+      invalidOutputPreview: refusalReportDetected ? rawDisplayedReport.slice(0, 1_200) : undefined,
+    },
+    null,
+    2,
+  );
+  const diagnosticMarkdown = showRunDiagnostic
+    ? [
+        "## 系统运行说明",
+        "",
+        "> 本次报告生成链路出现异常。系统不能据此判断为‘没有收集到素材’，已有素材不会被删除。请将下面的诊断信息复制给管理员排查。",
+        "",
+        "```json",
+        runtimeDiagnosticText,
+        "```",
+      ].join("\n")
+    : "";
+  // Invalid refusal prose (or a failed run with no report) is replaced instead
+  // of repeated to the user. Any usable normal/fallback/partial report is shown
+  // as-is and never receives diagnostic text.
+  const displayedReport = showRunDiagnostic
+    ? `# 报告生成异常\n\n${diagnosticMarkdown}`
+    : rawDisplayedReport;

  const updateFullReportRewritePresentation = useCallback(
    (presentationId: string | null, event: DocumentRewriteStreamEvent) => {
@@ -676,10 +872,19 @@ function DeepResearchWorkbenchInner() {
    report: displayedReport,
    writing: sandboxWriting,
    onFirstReportContent: handleFirstReportContent,
+    // Open only after thinking has finished and the first write token exists.
+    // Thinking stays on the left progress card; an empty writing-phase stub
+    // must not steal the right panel.
+    activity: Boolean(run.report.trim()),
    // Open on the first visible write, including first-generation reports and
    // a new sibling. Stay put if the user has already switched to another card.
    autoOpen: viewingLiveGeneration || reportDocumentRewrite.isActive,
  });
+  openReportRef.current = openReport;
+  inlineGenerationSessionRef.current = inlineGenerationSession;
+  refetchLiveJobRef.current = () => {
+    void Promise.all([refetchSession(), refetchSessions(), refetchSources(), refetchReportVariants()]);
+  };
  const sandboxVisible = sandboxOpen && Boolean(
    displayedReport || isRunning || isAwaitingReview || reportDocumentRewrite.isActive || isGeneratingNewReport,
  );
@@ -688,6 +893,13 @@ function DeepResearchWorkbenchInner() {
    openReport();
  }, [openReport]);

+  useEffect(() => {
+    if (!viewingLiveGeneration && !reportDocumentRewrite.isActive) return;
+    if (!run.report.trim()) return;
+    setSandboxOpen(true);
+    openReport();
+  }, [openReport, reportDocumentRewrite.isActive, run.report, viewingLiveGeneration]);
+
  // ArtifactFileList invokes its handler synchronously. Switch the virtual
  // sandbox file first, then open it from an effect once useReportSandbox has
  // rebuilt its URL for the generated report session.
@@ -986,6 +1198,66 @@ function DeepResearchWorkbenchInner() {
    session,
  ]);

+  // Persist each completed search as it lands in the step list, instead of
+  // waiting until the whole collection turn finishes and writing 80 rows at once.
+  useEffect(() => {
+    collectorSessionIdRef.current = session?.id ?? null;
+    persistedCollectorToolIds.current = new Set();
+    persistedCollectorMaterialKeys.current = new Set();
+    persistedCollectorKey.current = "";
+    collectorPersistChain.current = Promise.resolve();
+  }, [session?.id]);
+
+  useEffect(() => {
+    if (!isChatSession || !session?.id) return;
+    if (session.status !== "collecting" && session.status !== "draft") return;
+    const remaining = COLLECTOR_PERSIST_LIMIT - persistedCollectorMaterialKeys.current.size;
+    if (remaining <= 0) return;
+    const pending: Record<string, unknown>[] = [];
+    const claimedToolIds: string[] = [];
+    const claimedKeys: string[] = [];
+    for (const message of collectorThread.messages ?? []) {
+      if (message.type !== "tool" || !message.id) continue;
+      if (message.name && SKIP_COLLECTOR_PERSIST_TOOLS.has(message.name)) continue;
+      if (persistedCollectorToolIds.current.has(message.id)) continue;
+      if (!isCompleteToolPayload(message)) continue;
+      const rows = snapshotCollectorMaterials([message], {
+        limit: remaining - pending.length,
+        includeSummary: false,
+      });
+      persistedCollectorToolIds.current.add(message.id);
+      claimedToolIds.push(message.id);
+      for (const row of rows) {
+        const key = collectorMaterialKey(row);
+        if (!key || persistedCollectorMaterialKeys.current.has(key)) continue;
+        persistedCollectorMaterialKeys.current.add(key);
+        claimedKeys.push(key);
+        pending.push(row);
+        if (pending.length >= remaining) break;
+      }
+      if (pending.length >= remaining) break;
+    }
+    if (!pending.length) return;
+    const sessionId = session.id;
+    collectorPersistChain.current = collectorPersistChain.current
+      .then(() => actions.persistCollectorMaterials.mutateAsync({
+        sessionId,
+        collectorMaterials: pending,
+        quiet: true,
+      }))
+      .catch(() => {
+        if (collectorSessionIdRef.current !== sessionId) return;
+        for (const toolId of claimedToolIds) persistedCollectorToolIds.current.delete(toolId);
+        for (const key of claimedKeys) persistedCollectorMaterialKeys.current.delete(key);
+      });
+  }, [
+    actions.persistCollectorMaterials,
+    collectorThread.messages,
+    isChatSession,
+    session?.id,
+    session?.status,
+  ]);
+
  // Turn finished without a pending clarification → surface the config card.
  // Requiring a non-human tail closes the window between the optimistic user
  // message and the run flag flipping, where the turn would look "ended".
@@ -1002,7 +1274,20 @@ function DeepResearchWorkbenchInner() {
    if (finishedTurnKey.current === key) return;
    finishedTurnKey.current = key;
    if (session) {
-      void actions.updateStatus.mutate({ sessionId: session.id, status: "awaiting_report" });
+      const leftover = snapshotCollectorMaterials(collectorThread.messages, {
+        limit: COLLECTOR_PERSIST_LIMIT,
+      }).filter((item) => {
+        const materialKey = collectorMaterialKey(item);
+        if (!materialKey || persistedCollectorMaterialKeys.current.has(materialKey)) return false;
+        persistedCollectorMaterialKeys.current.add(materialKey);
+        return true;
+      });
+      persistedCollectorKey.current = `${session.id}:${persistedCollectorMaterialKeys.current.size}`;
+      void actions.updateStatus.mutate({
+        sessionId: session.id,
+        status: "awaiting_report",
+        ...(leftover.length ? { collectorMaterials: leftover } : {}),
+      });
    }
  }, [
    actions.updateStatus,
@@ -1010,10 +1295,45 @@ function DeepResearchWorkbenchInner() {
    collectorPendingClarification,
    collectorStreaming,
    collectorTailIsHuman,
+    collectorThread.messages,
    isChatSession,
    session,
  ]);

+  // After a refresh the collector messages reload from the thread. Persist
+  // anything the incremental writer missed so 「选择结构再生成」 still has rows.
+  useEffect(() => {
+    if (!isChatSession || !session?.id) return;
+    if (session.status !== "awaiting_report") return;
+    const leftover = snapshotCollectorMaterials(collectorThread.messages, {
+      limit: COLLECTOR_PERSIST_LIMIT,
+    }).filter((item) => {
+      const materialKey = collectorMaterialKey(item);
+      if (!materialKey || persistedCollectorMaterialKeys.current.has(materialKey)) return false;
+      persistedCollectorMaterialKeys.current.add(materialKey);
+      return true;
+    });
+    if (!leftover.length) return;
+    const persistKey = `${session.id}:${persistedCollectorMaterialKeys.current.size}`;
+    if (persistedCollectorKey.current === persistKey) return;
+    persistedCollectorKey.current = persistKey;
+    void actions.persistCollectorMaterials.mutateAsync({
+      sessionId: session.id,
+      collectorMaterials: leftover,
+    }).catch(() => {
+      persistedCollectorKey.current = "";
+      for (const item of leftover) {
+        persistedCollectorMaterialKeys.current.delete(collectorMaterialKey(item));
+      }
+    });
+  }, [
+    actions.persistCollectorMaterials,
+    collectorThread.messages,
+    isChatSession,
+    session?.id,
+    session?.status,
+  ]);
+
  const collectedMaterialCount = useMemo(
    () => countCollectorMaterials(collectorThread.messages),
    [collectorThread.messages],
@@ -1267,18 +1587,21 @@ function DeepResearchWorkbenchInner() {
    if (!streamJobId || (!isRunning && !isAwaitingReview && !replayingTerminalTrace)) return;
    if (replayingTerminalTrace && replayedTraceJobs.current.has(streamJobId)) return;
    if (replayingTerminalTrace) replayedTraceJobs.current.add(streamJobId);
-    seenEventKeys.current = new Set();
-    liveEventSerial.current = 0;
-    pendingReportEvents.current = [];
-    setRun({ ...EMPTY_RUN, jobId: streamJobId });
-    // Keep the sandbox closed until a report delta is available. `useReportSandbox`
-    // opens it at that first visible write, rather than during model thinking
-    // or after the report has already finished. If the user has already opened
-    // another file card, leave that view alone.
    const keepCurrentSandbox = Boolean(
-      inlineGenerationSession && sandboxSessionId !== inlineGenerationSession.id,
+      inlineGenerationSessionRef.current && sandboxSessionId !== inlineGenerationSessionRef.current.id,
    );
-    if (!replayingTerminalTrace && !keepCurrentSandbox) setSandboxOpen(false);
+    const jobChanged = boundStreamJobRef.current !== streamJobId;
+    if (jobChanged) {
+      boundStreamJobRef.current = streamJobId;
+      seenEventKeys.current = new Set();
+      liveEventSerial.current = 0;
+      pendingReportEvents.current = [];
+      setRun({ ...EMPTY_RUN, jobId: streamJobId });
+      // Only close the sandbox when a *new* job starts. Reconnecting the same
+      // write stream used to wipe the live draft and flip auto-open off, so
+      // thinking could finish while the right panel stayed closed.
+      if (!replayingTerminalTrace && !keepCurrentSandbox) setSandboxOpen(false);
+    }

    const flushReportEvents = () => {
      reportAnimationFrame.current = null;
@@ -1329,6 +1652,7 @@ function DeepResearchWorkbenchInner() {
            continue;
          }
          const version = typeof event.payload.reportVersion === "number" ? event.payload.reportVersion : reportVersion;
+          if (version < reportVersion) continue;
          const target = typeof event.payload.target === "string" ? event.payload.target : "report";
          const currentTarget = reportTargets[target];
          if (!currentTarget || version >= currentTarget.version) {
@@ -1353,6 +1677,13 @@ function DeepResearchWorkbenchInner() {
            : eventKey(event);
          if (seenEventKeys.current.has(key)) return;
          seenEventKeys.current.add(key);
+          const firstWriteToken = (
+            event.type === "report_delta" || event.type === "report_chunk"
+          ) && typeof event.payload?.delta === "string" && event.payload.delta.trim();
+          if (firstWriteToken && !keepCurrentSandbox) {
+            setSandboxOpen(true);
+            openReportRef.current();
+          }
          if (
            event.type === "plan_delta" ||
            event.type === "plan_reasoning" ||
@@ -1385,8 +1716,9 @@ function DeepResearchWorkbenchInner() {
        },
        onTerminal: () => {
          if (!replayingTerminalTrace) replayedTraceJobs.current.add(streamJobId);
-          if (inlineGenerationSession) {
-            void getResearchSession(inlineGenerationSession.id).then((completed) => {
+          const liveInline = inlineGenerationSessionRef.current;
+          if (liveInline) {
+            void getResearchSession(liveInline.id).then((completed) => {
              setInlineGeneratedReport((current) => current?.session.id === completed.id
                ? { ...current, session: completed }
                : current);
@@ -1395,7 +1727,7 @@ function DeepResearchWorkbenchInner() {
              console.error("刷新新报告状态失败：", error);
            });
          }
-          void Promise.all([refetchSession(), refetchSessions(), refetchSources(), refetchReportVariants()]);
+          refetchLiveJobRef.current();
        },
        onError: (detail) => setRun((current) => current.jobId === streamJobId ? { ...current, error: detail } : current),
      },
@@ -1409,15 +1741,25 @@ function DeepResearchWorkbenchInner() {
      }
      pendingReportEvents.current = [];
    };
-  }, [activeJobId, inlineGenerationSession, isAwaitingReview, isRunning, refetchReportVariants, refetchSession, refetchSessions, refetchSources, sandboxSessionId, session?.status, streamJobId]);
+  }, [activeJobId, isAwaitingReview, isRunning, sandboxSessionId, session?.status, streamJobId]);

  useEffect(() => {
    if (!session?.reportMarkdown) return;
    // A background regeneration writes into `run` for the child job. Do not
    // copy the parent markdown over that live stream.
    if (inlineGenerationSession && inlineGenerationSession.id !== session.id) return;
-    setRun((current) => current.jobId === streamJobId ? { ...current, report: session.reportMarkdown! } : current);
-  }, [inlineGenerationSession, session?.id, session?.reportMarkdown, streamJobId]);
+    // A new write must start from a blank sandbox. Copying the previous
+    // durable report into `run` opened the panel with stale text, then the
+    // model only thought (summary / reasoning) and the sandbox never grew.
+    if (isRunning || isAwaitingReview) return;
+    const lastJobId = typeof session.usage?.lastJobId === "string" ? session.usage.lastJobId : null;
+    setRun((current) => {
+      if (current.jobId !== streamJobId) return current;
+      if (current.jobId && lastJobId !== current.jobId) return current;
+      if (current.report === session.reportMarkdown) return current;
+      return { ...current, report: session.reportMarkdown! };
+    });
+  }, [inlineGenerationSession, isAwaitingReview, isRunning, session?.id, session?.reportMarkdown, session?.usage?.lastJobId, streamJobId]);

  // ── actions ────────────────────────────────────────────────────────────────

@@ -1435,6 +1777,10 @@ function DeepResearchWorkbenchInner() {
    setFollowUpStream(null);
    pendingInitialQuery.current = null;
    finishedTurnKey.current = null;
+    persistedCollectorKey.current = "";
+    persistedCollectorToolIds.current = new Set();
+    persistedCollectorMaterialKeys.current = new Set();
+    collectorPersistChain.current = Promise.resolve();
  }, []);

  // 历史报告不抢占对话区域：切换研究记录时总是先折叠右侧沙箱；用户可通过
@@ -1484,6 +1830,10 @@ function DeepResearchWorkbenchInner() {
      });
      pendingInitialQuery.current = query;
      finishedTurnKey.current = null;
+      persistedCollectorKey.current = "";
+      persistedCollectorToolIds.current = new Set();
+      persistedCollectorMaterialKeys.current = new Set();
+      collectorPersistChain.current = Promise.resolve();
      setSelectedId(created.id);
      setSandboxOpen(false);
    } catch (error) {
@@ -1800,10 +2150,16 @@ function DeepResearchWorkbenchInner() {
    if (!activeJobId) return;
    try {
      await actions.cancelJob.mutateAsync(activeJobId);
-      toast.success("已请求停止研究");
+      toast.success("已停止撰写");
      await Promise.all([refetchSession(), refetchSessions()]);
    } catch (error) {
-      toast.error(error instanceof Error ? error.message : "停止研究失败");
+      const message = error instanceof Error ? error.message : "停止研究失败";
+      if (/not in a cancellable state/i.test(message) || /409/.test(message)) {
+        toast.success("已停止撰写");
+        await Promise.all([refetchSession(), refetchSessions()]);
+        return;
+      }
+      toast.error(message);
    }
  }, [actions.cancelJob, activeJobId, refetchSession, refetchSessions]);

@@ -1841,14 +2197,23 @@ function DeepResearchWorkbenchInner() {
  const handleReopenReportCard = useCallback(async () => {
    if (!session) return;
    try {
-      await actions.updateStatus.mutateAsync({ sessionId: session.id, status: "awaiting_report" });
+      await actions.updateStatus.mutateAsync({
+        sessionId: session.id,
+        status: "awaiting_report",
+        collectorMaterials: snapshotCollectorMaterials(collectorThread.messages, {
+          limit: COLLECTOR_PERSIST_LIMIT,
+        }),
+      });
      await refetchSession();
    } catch (error) {
      toast.error(error instanceof Error ? error.message : "打开报告配置失败");
    }
-  }, [actions.updateStatus, refetchSession, session]);
+  }, [actions.updateStatus, collectorThread.messages, refetchSession, session]);

-  const handleConfirmReportCard = useCallback(async (config: Record<string, unknown>) => {
+  const handleConfirmReportCard = useCallback(async (
+    config: Record<string, unknown>,
+    extras?: { writeWithoutMaterials?: boolean },
+  ) => {
    if (!session) return;
    // Keep the composer's explicit choice authoritative when the collection
    // phase turns into a report-writing job.
@@ -1856,17 +2221,47 @@ function DeepResearchWorkbenchInner() {
      ? { fast_model: selectedModel, smart_model: selectedModel, strategic_model: selectedModel }
      : {};
    try {
-      await actions.startJob.mutateAsync({
+      const writeWithoutMaterials = extras?.writeWithoutMaterials === true;
+      const collectorMaterials = writeWithoutMaterials
+        ? []
+        : snapshotCollectorMaterials(collectorThread.messages, { limit: WRITE_FALLBACK_MATERIAL_LIMIT });
+      console.warn("[深度研究] browser_snapshot_sending", {
+        sessionId: session.id,
+        messageCount: collectorThread.messages?.length ?? 0,
+        toolMessageCount: (collectorThread.messages ?? []).filter((message) => message.type === "tool").length,
+        snapshotCount: collectorMaterials.length,
+        snapshotLimit: WRITE_FALLBACK_MATERIAL_LIMIT,
+        writeWithoutMaterials,
+        sampleTitles: collectorMaterials.slice(0, 5).map((item) => item.title),
+      });
+      const started = await actions.startJob.mutateAsync({
        sessionId: session.id,
        entry: "chat",
+        query: session.query,
+        title: session.title,
        config: { ...config, ...modelConfig },
+        collectorMaterials,
+        forceNoMaterials: writeWithoutMaterials,
      });
+      console.warn("[深度研究] browser_snapshot_accepted", started);
+      if (writeWithoutMaterials) {
+        toast.warning("已按无素材模式启动撰写，对话里收集到的资料本次不会送入写作。");
+      } else if (!collectorMaterials.length) {
+        toast.warning("未传入检索素材，将按无素材模式撰写。请看控制台 [深度研究] browser_snapshot_sending");
+      }
      setSandboxOpen(false);
      toast.success("开始撰写研究报告");
    } catch (error) {
+      console.error("[深度研究] write_report_failed", {
+        sessionId: session.id,
+        query: session.query,
+        title: session.title,
+        detail: error instanceof Error ? error.message : String(error),
+        error,
+      });
      toast.error(error instanceof Error ? error.message : "启动报告撰写失败");
    }
-  }, [actions.startJob, selectedModel, session]);
+  }, [actions.startJob, collectorThread.messages, selectedModel, session]);

  const handleContinueCollecting = useCallback(() => {
    document.getElementById("deep-research-composer")?.focus();
@@ -2059,7 +2454,7 @@ function DeepResearchWorkbenchInner() {
            imageGenerationAvailable={imageGenerationAvailable}
            imageLimit={capabilities.data?.imageGeneration?.maxImages ?? 4}
            submitting={actions.startJob.isPending}
-            onConfirm={(config) => void handleConfirmReportCard(config)}
+            onConfirm={(config, extras) => void handleConfirmReportCard(config, extras)}
            onContinueCollecting={handleContinueCollecting}
          />
        );
@@ -2739,7 +3134,7 @@ function ResearchConversation({
 }) {
  const active = session.status === "running" || session.status === "awaiting_input";
  const hasTrace = active || events.length > 0;
-  const streamedSourceCount = events.reduce((count, event) => count + (event.type === "source_added" ? 1 : 0), 0);
+  const streamedSourceCount = countEventMaterials(events);
  const liveSourceCount = Math.max(sourceCount, streamedSourceCount);
  const requestedImageCount = requestedReportImageCount(session.config);
  return (
@@ -2847,6 +3242,7 @@ type TraceSnapshot = {
  images: TraceImage[];
  imagePhaseFinished: boolean;
  warnings: string[];
+  diagnostics: Record<string, unknown>[];
 };

 function traceRecord(value: unknown): Record<string, unknown> {
@@ -2884,6 +3280,8 @@ function buildTraceSnapshot(events: ProgressEvent[]): TraceSnapshot {
  const selectedIds = new Set<string>();
  const removedIds = new Set<string>();
  const warnings: string[] = [];
+  const diagnostics: Record<string, unknown>[] = [];
+  const diagnosticKeys = new Set<string>();
  let curationReason: string | undefined;
  let compressedSourceCount: number | undefined;
  let reportCompleted = false;
@@ -2995,6 +3393,19 @@ function buildTraceSnapshot(events: ProgressEvent[]): TraceSnapshot {
    if (event.type === "warning" || event.type === "error") {
      const message = traceString(payload.message) ?? traceString(payload.detail);
      if (message && !warnings.includes(message)) warnings.push(message);
+      const diagnostic = traceRecord(payload.diagnostic);
+      if (Object.keys(diagnostic).length > 0) {
+        const item = {
+          code: traceString(payload.code) ?? event.type,
+          ...(message ? { message } : {}),
+          ...diagnostic,
+        };
+        const key = JSON.stringify(item);
+        if (!diagnosticKeys.has(key)) {
+          diagnosticKeys.add(key);
+          diagnostics.push(item);
+        }
+      }
      if (traceString(payload.code) === "image_generation_failed") {
        const position = Math.max(1, Math.floor(numberValue(payload.position) ?? imageMap.size + 1));
        const total = numberValue(payload.total);
@@ -3027,6 +3438,7 @@ function buildTraceSnapshot(events: ProgressEvent[]): TraceSnapshot {
    images: [...imageMap.values()].sort((left, right) => left.position - right.position),
    imagePhaseFinished,
    warnings,
+    diagnostics,
  };
 }

@@ -3123,6 +3535,7 @@ const ResearchTrace = memo(function ResearchTrace({ events, phase, planText, pla
        </TraceStage>}

        {snapshot.warnings.length > 0 && <div className="rounded-lg bg-amber-500/10 px-3 py-2.5 text-xs leading-5 text-amber-800 dark:text-amber-200"><p className="font-medium">过程提示</p>{snapshot.warnings.map((warning) => <p key={warning} className="mt-1">{warning}</p>)}</div>}
+        {snapshot.diagnostics.length > 0 && <details className="rounded-lg border border-amber-500/20 bg-amber-500/[0.05] px-3 py-2 text-xs"><summary className="cursor-pointer font-medium text-amber-800 dark:text-amber-200">运行诊断（用于排查，可复制）</summary><pre className="mt-2 max-h-52 overflow-auto whitespace-pre-wrap break-all rounded bg-background/70 p-2 text-[11px] leading-5 text-muted-foreground">{snapshot.diagnostics.map((item) => JSON.stringify(item, null, 2)).join("\n\n")}</pre></details>}
        {error && <p className="rounded-lg bg-destructive/10 px-3 py-2 text-xs text-destructive">实时连接提示：{error}。研究仍会继续，页面会从已保存的事件记录恢复。</p>}
      </div>}
    </div>
@@ -507,7 +507,7 @@ export function ReportConfigCard({
  imageGenerationAvailable: boolean;
  imageLimit: number;
  submitting: boolean;
-  onConfirm: (config: Record<string, unknown>) => void;
+  onConfirm: (config: Record<string, unknown>, extras?: { writeWithoutMaterials?: boolean }) => void;
  onContinueCollecting: () => void;
 }) {
  const [mode, setMode] = useState<ResearchMode>(
@@ -521,6 +521,7 @@ export function ReportConfigCard({
    retrievalSkills: retrievalSkillsOverride ?? defaultOptions.retrievalSkills,
  }));
  const [generateImages, setGenerateImages] = useState(defaultGenerateImages);
+  const [writeWithoutMaterials, setWriteWithoutMaterials] = useState(false);
  const [advancedOpen, setAdvancedOpen] = useState(false);

  // The collector composer and this confirmation card are both reachable while
@@ -572,9 +573,11 @@ export function ReportConfigCard({
            下方选项沿用原研究配置并可调整；确认后将基于以上对话收集到的资料撰写报告。
            {modelLabel ? <>写作模型：<span className="font-medium text-foreground">{modelLabel}</span>。</> : null}
          </p>
-          <div className="mt-2 inline-flex items-center gap-1.5 rounded-md border border-primary/15 bg-primary/[0.06] px-2 py-1 text-[11px] text-primary">
+          <div className={`mt-2 inline-flex items-center gap-1.5 rounded-md border px-2 py-1 text-[11px] ${writeWithoutMaterials ? "border-amber-500/30 bg-amber-500/10 text-amber-800 dark:text-amber-200" : "border-primary/15 bg-primary/[0.06] text-primary"}`}>
            <span className="font-medium">已收集 {materialCount} 条资料</span>
-            <span className="text-primary/70">将作为本次报告的写作依据</span>
+            <span className={writeWithoutMaterials ? "opacity-80" : "text-primary/70"}>
+              {writeWithoutMaterials ? "本次不送入写作，按无素材模式成稿" : "将作为本次报告的写作依据"}
+            </span>
          </div>
        </div>
      </div>
@@ -621,6 +624,19 @@ export function ReportConfigCard({
        )}
      </div>

+      <label className="mt-3 flex cursor-pointer items-start gap-2 rounded-lg border border-border/70 bg-background/60 p-2.5 text-[11px] leading-4">
+        <input
+          type="checkbox"
+          checked={writeWithoutMaterials}
+          onChange={(event) => setWriteWithoutMaterials(event.target.checked)}
+          className="mt-0.5 accent-primary"
+        />
+        <span>
+          <span className="block font-medium text-foreground">无素材写作</span>
+          忽略对话里已收集的资料，直接走无素材成稿，用来确认这条链路是否生效。已落库的来源不会被删除。
+        </span>
+      </label>
+
      <div className="mt-3 overflow-hidden rounded-xl border border-border/70">
        <button
          type="button"
@@ -710,7 +726,14 @@ export function ReportConfigCard({
          <MessageSquarePlus className="mr-1.5 h-3.5 w-3.5" />
          继续补充资料
        </Button>
-        <Button size="sm" disabled={submitting} onClick={() => onConfirm(buildReportCardConfig(mode, generateImages, options))}>
+        <Button
+          size="sm"
+          disabled={submitting}
+          onClick={() => onConfirm(
+            buildReportCardConfig(mode, generateImages, options),
+            { writeWithoutMaterials },
+          )}
+        >
          {submitting && <Loader2 className="mr-1.5 h-3.5 w-3.5 animate-spin" />}
          <Sparkles className="mr-1.5 h-3.5 w-3.5" />
          开始撰写报告
@@ -8,8 +8,10 @@
 *    全新部署自动播种「通用分析结构 / 递进式论证结构」），支持 启用/停用 筛选
 *    与 标题 筛选；卡片上可 switch 启停、编辑、删除（二次确认），并显示
 *    最后修改时间与创建用户名；新增时不填状态（服务端强制默认启用）。
- *  - 详情视图：点击卡片即「选择」该结构（内容回填到高级配置的报告结构
- *    custom_outline），弹窗切换为展示 标题 + Markdown 大纲预览，右上角「返回」回列表。
+ *    **点击卡片即「选择」该结构（内容回填到高级配置的报告结构 custom_outline，
+ *    卡片留在列表中高亮为当前使用，不进入详情）**。
+ *  - 详情视图：通过卡片右上角「查看大纲结构」眼睛图标进入，展示 标题 + Markdown
+ *    大纲预览，右上角「返回」回列表。
 */

 import { useEffect, useMemo, useState } from "react";
@@ -238,8 +240,9 @@ export function WorkflowConfigDialog({
      toast.error(`「${structure.title}」已停用，请先启用后再选用`);
      return;
    }
+    // 点击卡片只做「选择」：内容回填后留在列表视图（卡片高亮为当前使用），
+    // 详情视图通过卡片上的「查看大纲结构」眼睛图标进入。
    onApply?.(structure.content, structure.structureMode, structure.retrievalDirections, structure.retrievalSkills);
-    setDetailId(structure.id);
    toast.success(`已选择报告结构「${structure.title}」，并填充到报告结构配置`);
  };

@@ -325,7 +328,7 @@ export function WorkflowConfigDialog({
                    </h2>
                  </div>
                  <p className="mt-1 text-xs text-slate-500 dark:text-slate-400 sm:text-[13px]">
-                    点击卡片选择报告结构（自动填充到报告结构配置）；可启停、编辑、删除。
+                    点击卡片选择报告结构（自动填充到报告结构配置）；点击卡片上的眼睛图标查看大纲详情；可启停、编辑、删除。
                  </p>
                </div>
                <Button
@@ -501,7 +504,7 @@ export function WorkflowConfigDialog({
                          key={structure.id}
                          structure={structure}
                          applied={structure.id === appliedStructureId}
-                          onOpen={() => handleSelect(structure)}
+                          onSelect={() => handleSelect(structure)}
                          onPreview={(event) => {
                            event.stopPropagation();
                            setDetailId(structure.id);
@@ -750,7 +753,7 @@ export function WorkflowConfigDialog({
 function StructureCard({
  structure,
  applied,
-  onOpen,
+  onSelect,
  onPreview,
  onDuplicate,
  onEdit,
@@ -760,7 +763,7 @@ function StructureCard({
 }: {
  structure: ReportStructure;
  applied: boolean;
-  onOpen: () => void;
+  onSelect: () => void;
  onPreview: (event: React.MouseEvent) => void;
  onDuplicate: (event: React.MouseEvent) => void;
  onEdit: (event: React.MouseEvent) => void;
@@ -775,11 +778,11 @@ function StructureCard({
    <div
      role="button"
      tabIndex={0}
-      onClick={onOpen}
+      onClick={onSelect}
      onKeyDown={(event) => {
        if (event.key === "Enter" || event.key === " ") {
          event.preventDefault();
-          onOpen();
+          onSelect();
        }
      }}
      className={`group relative flex cursor-pointer select-none flex-col justify-between rounded-2xl border p-5 text-left transition-all duration-200 outline-none focus-visible:ring-2 focus-visible:ring-[#F5222D]/30 ${
@@ -36,6 +36,14 @@ export type ReportStubAiMessage = {
  }[];
 };

+export type ReportStubToolMessage = {
+  id: string;
+  type: "tool";
+  name: "write_file";
+  tool_call_id: string;
+  content: string;
+};
+
 interface UseReportSandboxOptions {
  /** stub 线程标识（建议用 sessionId/jobId 派生，切换会话即切换 stub）。 */
  threadKey: string;
@@ -45,6 +53,13 @@ interface UseReportSandboxOptions {
  writing: boolean;
  /** First visible Markdown has arrived; the host can expand the right panel then. */
  onFirstReportContent?: () => void;
+  /**
+   * The writing run has produced something observable (report text or model
+   * reasoning). Report text streams as non-durable live frames, so on a
+   * multi-worker backend it can lag well behind the actual write; this lets
+   * the host open the sandbox on the first sign of progress instead.
+   */
+  activity?: boolean;
  /**
   * A structural regeneration writes a sibling file in the background. Leave
   * the currently displayed report in the sandbox until the user opens that
@@ -58,6 +73,7 @@ export function useReportSandbox({
  report,
  writing,
  onFirstReportContent,
+  activity = false,
  autoOpen = true,
 }: UseReportSandboxOptions) {
  const { select, setOpen, openStreamedArtifact } = useArtifacts();
@@ -87,9 +103,37 @@ export function useReportSandbox({
    wasWritingRef.current = writing;
  }, [writing]);

-  // 每帧 upsert stub（带防抹空：新帧为空而旧内容非空时保留旧内容）。
+  const hadReportRef = useRef(Boolean(report.trim()));
  useEffect(() => {
-    if (!report) return;
+    const hasReport = Boolean(report.trim());
+    // Keep the panel closed through reasoning. When the first Markdown token
+    // arrives, allow auto-open even if an earlier empty stub was prepared.
+    if (writing && hasReport && !hadReportRef.current) autoOpenedRef.current = false;
+    hadReportRef.current = hasReport;
+  }, [report, writing]);
+
+  // 每帧 upsert stub。普通空帧不抹掉已渲染的文件，但写作过程中的
+  // 空正文表示后端要求重置报告版本（report_reset）或新稿尚未出首字，
+  // 此时必须清掉旧版，避免把首版失败文本继续展示在沙箱里。
+  //
+  // 清掉的是**正文**而不是文件本身：多 worker 部署下 report_delta 属于
+  // 进程内 live 帧，观察端可能连在另一个 worker 上，首帧要等 0.8s 的
+  // 落库轮询（report_chunk）才到。若此时把 stub 置为 null，右栏就没有
+  // 可打开的虚拟文件，"开始撰写即打开沙箱" 会整段失效。
+  useEffect(() => {
+    if (!report) {
+      if (writing) {
+        setStubMessage({
+          id: messageId,
+          type: "ai",
+          content: "",
+          tool_calls: [
+            { id: toolCallId, name: "write_file", args: { path: REPORT_OUTPUT_PATH, content: "" } },
+          ],
+        });
+      }
+      return;
+    }
    setStubMessage((prev) => {
      const prevArgs = prev?.tool_calls?.[0]?.args as { content?: unknown } | undefined;
      const prevContent = typeof prevArgs?.content === "string" ? prevArgs.content : "";
@@ -106,16 +150,16 @@ export function useReportSandbox({
        tool_calls: [{ id: toolCallId, name: "write_file", args: { path: REPORT_OUTPUT_PATH, content } }],
      };
    });
-  }, [messageId, report, toolCallId]);
+  }, [messageId, report, toolCallId, writing]);

-  // 报告首帧到达且仍在写入 → 自动展开右栏并选中虚拟 URL。
+  // 思考结束后的报告正文首帧到达且仍在写入 → 自动展开右栏并选中虚拟 URL。
  // openStreamedArtifact 尊重用户手动关闭（suppress），不会强行弹回。
  useEffect(() => {
-    if (!autoOpen || !report.trim() || !writing || autoOpenedRef.current) return;
+    if (!autoOpen || (!report.trim() && !activity) || !writing || autoOpenedRef.current) return;
    autoOpenedRef.current = true;
    onFirstReportContent?.();
    openStreamedArtifact(virtualUrl, artifactPreviewKey(virtualUrl));
-  }, [autoOpen, onFirstReportContent, openStreamedArtifact, report, virtualUrl, writing]);
+  }, [activity, autoOpen, onFirstReportContent, openStreamedArtifact, report, virtualUrl, writing]);

  /** 手动打开（头部「报告」按钮 / 完成卡「查看报告」）：始终选中虚拟 URL。 */
  const openReport = useCallback(() => {
@@ -132,8 +176,23 @@ export function useReportSandbox({
  return {
    virtualUrl,
    stubMessages: useMemo(
-      () => (currentStubMessage ? [currentStubMessage] : []),
-      [currentStubMessage],
+      () => {
+        if (!currentStubMessage) return [];
+        if (writing) return [currentStubMessage];
+        // ArtifactFileDetail determines whether a write is still streaming by
+        // matching the write_file call with its tool result. `isLoading=false`
+        // alone is intentionally ignored there, so completed and historical
+        // virtual reports must include this synthetic completion receipt.
+        const completedWrite: ReportStubToolMessage = {
+          id: `${toolCallId}-result`,
+          type: "tool",
+          name: "write_file",
+          tool_call_id: toolCallId,
+          content: "ok",
+        };
+        return [currentStubMessage, completedWrite];
+      },
+      [currentStubMessage, toolCallId, writing],
    ),
    openReport,
  };
@@ -0,0 +1,239 @@
+.official-deerflow {
+  --official-ink: #232323;
+  --official-muted: #787878;
+  --official-border: #eeeeeb;
+  --official-sidebar: #fbfbfa;
+  --official-accent: #111111;
+  background: #fff;
+  color: var(--official-ink);
+  display: flex;
+  font-family: Inter, "Noto Sans SC", "PingFang SC", system-ui, sans-serif;
+  height: 100vh;
+  isolation: isolate;
+  overflow: hidden;
+}
+
+.official-deerflow *,
+.official-deerflow *::before,
+.official-deerflow *::after { box-sizing: border-box; }
+.official-deerflow button,
+.official-deerflow input,
+.official-deerflow textarea { font: inherit; }
+
+.official-sidebar {
+  background: var(--official-sidebar);
+  border-right: 1px solid var(--official-border);
+  display: flex;
+  flex: 0 0 288px;
+  flex-direction: column;
+  min-width: 0;
+  padding: 16px 10px 12px;
+  transition: flex-basis 180ms ease;
+}
+.sidebar-collapsed .official-sidebar { flex-basis: 64px; }
+.sidebar-collapsed .official-sidebar span,
+.sidebar-collapsed .official-sidebar p,
+.sidebar-collapsed .official-sidebar small,
+.sidebar-collapsed .official-brand { display: none; }
+.sidebar-collapsed .official-brand-row { justify-content: center; }
+.sidebar-collapsed .official-collapse-button { transform: rotate(180deg); }
+.sidebar-collapsed .official-nav-item,
+.sidebar-collapsed .official-recent-chat,
+.sidebar-collapsed .official-sidebar-footer > button,
+.sidebar-collapsed .official-user-row { justify-content: center; }
+
+.official-brand-row { align-items: center; display: flex; height: 34px; justify-content: space-between; padding: 0 4px 0 1px; }
+.official-brand { font-family: Georgia, "Times New Roman", serif; font-size: 20px; font-weight: 700; letter-spacing: -0.5px; }
+.official-collapse-button,
+.official-icon-button { align-items: center; background: transparent; border: 0; border-radius: 7px; color: #787878; cursor: pointer; display: inline-flex; justify-content: center; padding: 6px; }
+.official-collapse-button:hover,
+.official-icon-button:hover { background: #f0f0ee; color: var(--official-ink); }
+
+.official-nav { display: grid; gap: 3px; margin-top: 31px; }
+.official-nav-item,
+.official-recent-chat,
+.official-sidebar-footer > button { align-items: center; background: transparent; border: 0; border-radius: 7px; color: #6e6e6e; cursor: pointer; display: flex; gap: 10px; min-width: 0; padding: 9px 8px; text-align: left; width: 100%; }
+.official-nav-item { font-size: 16px; }
+.official-nav-item:hover,
+.official-recent-chat:hover,
+.official-sidebar-footer > button:hover { background: #f0f0ee; color: #222; }
+.official-nav-item.is-active { background: #efefed; color: #252525; font-weight: 600; }
+.official-nav-item span { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+
+.official-recent-section { border-top: 1px solid var(--official-border); margin-top: 25px; padding-top: 18px; }
+.official-recent-section > p { color: #90908e; font-size: 12px; margin: 0 8px 9px; }
+.official-recent-chat { display: grid; font-size: 13px; gap: 8px; grid-template-columns: 15px minmax(0, 1fr) auto; padding: 8px; }
+.official-recent-chat span { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.official-recent-chat small { color: #acaca9; font-size: 11px; }
+.official-recent-chat.is-active { background: #efefed; color: #252525; }
+.official-sidebar-loading,
+.official-sidebar-error,
+.official-sidebar-empty { align-items: center; color: #989895; display: flex; font-size: 12px; gap: 6px; margin: 0; padding: 8px; }
+.official-sidebar-error { color: #b04747; }
+
+.official-sidebar-footer { border-top: 1px solid var(--official-border); margin-top: auto; padding-top: 9px; }
+.official-sidebar-footer > button { font-size: 14px; }
+.official-sidebar-footer > button svg:last-child { margin-left: auto; }
+.official-user-row { align-items: center; color: #777; display: flex; font-size: 13px; gap: 8px; margin: 10px 8px 1px; }
+.official-user-avatar { align-items: center; background: #ecece9; border-radius: 50%; color: #71716f; display: inline-flex; height: 25px; justify-content: center; width: 25px; }
+
+.official-main-panel { background: #fff; flex: 1; min-width: 0; overflow: auto; }
+.official-page-header { align-items: flex-start; border-bottom: 1px solid var(--official-border); display: flex; justify-content: space-between; min-height: 104px; padding: 27px max(32px, 5vw); }
+.official-page-header h1 { font-size: 24px; letter-spacing: -0.5px; line-height: 1.2; margin: 3px 0 7px; }
+.official-page-header p { color: var(--official-muted); font-size: 14px; margin: 0; }
+.official-eyebrow { color: #9a9a98 !important; font-size: 12px !important; }
+.official-primary-button,
+.official-secondary-button,
+.official-outline-button { align-items: center; border-radius: 8px; cursor: pointer; display: inline-flex; gap: 7px; font-size: 14px; font-weight: 550; justify-content: center; white-space: nowrap; }
+.official-primary-button { background: var(--official-accent); border: 1px solid var(--official-accent); color: #fff; padding: 9px 13px; }
+.official-primary-button:hover { background: #303030; }
+.official-secondary-button,
+.official-outline-button { background: #fff; border: 1px solid #dededb; color: #3d3d3d; padding: 8px 12px; }
+.official-secondary-button:hover,
+.official-outline-button:hover { background: #f7f7f5; }
+.official-secondary-button:disabled { cursor: not-allowed; opacity: .55; }
+
+.official-chat-page { display: flex; flex-direction: column; height: 100%; min-height: 660px; }
+.official-chat-header { align-items: center; min-height: 62px; padding-bottom: 12px; padding-top: 12px; }
+.official-thread-title { align-items: center; display: flex; font-size: 14px; font-weight: 600; gap: 3px; }
+.official-header-actions { align-items: center; display: flex; gap: 10px; }
+.official-chat-canvas { align-items: center; display: flex; flex: 1; justify-content: center; min-height: 0; padding: 32px; }
+.official-chat-canvas.has-history { align-items: stretch; justify-content: center; overflow: auto; }
+.official-chat-welcome { margin: auto; max-width: 650px; text-align: center; transform: translateY(-35px); }
+.official-logo-orb { align-items: center; background: linear-gradient(145deg, #202020, #626260); border-radius: 18px; color: white; display: inline-flex; height: 55px; justify-content: center; width: 55px; }
+.official-chat-welcome h1 { font-size: clamp(25px, 3vw, 35px); letter-spacing: -1.15px; line-height: 1.2; margin: 21px 0 9px; }
+.official-chat-welcome > p { color: var(--official-muted); font-size: 15px; margin: 0; }
+.official-suggestion-grid { display: grid; gap: 10px; grid-template-columns: repeat(3, 1fr); margin-top: 31px; text-align: left; }
+.official-suggestion-grid button { background: #fff; border: 1px solid #e7e7e4; border-radius: 11px; color: #363636; cursor: pointer; min-height: 94px; padding: 14px; text-align: left; transition: border-color 120ms ease, box-shadow 120ms ease; }
+.official-suggestion-grid button:hover { border-color: #bdbdba; box-shadow: 0 4px 18px #0000000a; }
+.official-suggestion-grid strong,
+.official-suggestion-grid span { display: block; }
+.official-suggestion-grid strong { font-size: 14px; margin-bottom: 6px; }
+.official-suggestion-grid span { color: #8a8a87; font-size: 12px; line-height: 1.45; }
+
+.official-composer-shell { margin: 0 auto; max-width: 850px; padding: 0 24px 19px; width: 100%; }
+.official-composer { align-items: flex-end; background: #fff; border: 1px solid #dcdcd8; border-radius: 13px; box-shadow: 0 7px 20px #00000008; display: flex; gap: 8px; padding: 11px 11px 10px 15px; }
+.official-composer:focus-within { border-color: #adadaa; box-shadow: 0 0 0 3px #00000009; }
+.official-composer textarea { background: transparent; border: 0; color: #333; flex: 1; font-size: 15px; line-height: 24px; max-height: 144px; outline: 0; resize: none; }
+.official-composer textarea::placeholder { color: #a2a2a0; }
+.official-composer button { align-items: center; background: #222; border: 0; border-radius: 8px; color: #fff; cursor: pointer; display: inline-flex; height: 31px; justify-content: center; transition: opacity 100ms ease; width: 31px; }
+.official-composer button:disabled { cursor: not-allowed; opacity: .3; }
+.official-composer-shell > p { color: #acaca8; font-size: 11px; margin: 9px 0 0; text-align: center; }
+.official-message-list { display: grid; gap: 18px; margin: 0 auto; max-width: 760px; padding: 12px 0 22px; width: 100%; }
+.official-message { border-radius: 12px; font-size: 15px; line-height: 1.65; padding: 14px 16px; }
+.official-message-user { background: #f4f4f2; justify-self: end; max-width: 76%; }
+.official-message-assistant { border: 1px solid #eeeeeb; justify-self: start; max-width: 88%; }
+.official-message p { margin: 0; white-space: pre-wrap; }
+.official-message-assistant p { margin: 10px 0 13px; }
+.official-assistant-mark { align-items: center; color: #5c5c5a; display: flex; font-size: 12px; font-weight: 600; gap: 6px; }
+.official-insight-card { background: #f7f7f5; border-radius: 8px; display: grid; gap: 3px; padding: 10px 11px; }
+.official-insight-card strong { font-size: 13px; }
+.official-insight-card span { color: #858582; font-size: 12px; }
+.official-streaming-indicator { align-items: center; color: #7d7d7a; display: flex; font-size: 13px; gap: 7px; padding: 6px 1px; }
+.official-streaming-indicator svg,
+.official-loading-state svg,
+.official-sidebar-loading svg { animation: official-spin 900ms linear infinite; }
+.official-inline-error { color: #ae3e3e; font-size: 12px; margin: 0 auto 8px; max-width: 850px; padding: 0 24px; width: 100%; }
+
+.official-content-page { margin: 0 auto; max-width: 1180px; min-height: 100%; }
+.official-content-page .official-page-header { padding-left: max(32px, 5vw); padding-right: max(32px, 5vw); }
+.official-toolbar { padding: 22px max(32px, 5vw) 0; }
+.official-search { align-items: center; background: #f7f7f5; border: 1px solid transparent; border-radius: 8px; color: #8a8a87; display: flex; gap: 8px; max-width: 330px; padding: 8px 10px; }
+.official-search:focus-within { background: #fff; border-color: #d1d1ce; }
+.official-search input { background: transparent; border: 0; color: #333; font-size: 14px; min-width: 0; outline: 0; width: 100%; }
+.official-agent-grid { display: grid; gap: 15px; grid-template-columns: repeat(3, minmax(0, 1fr)); padding: 24px max(32px, 5vw) 40px; }
+.official-agent-card { border: 1px solid #e8e8e5; border-radius: 12px; min-height: 244px; padding: 19px; position: relative; }
+.official-agent-card:hover { border-color: #cfcfcb; box-shadow: 0 8px 22px #00000008; }
+.official-agent-avatar { align-items: center; border-radius: 9px; display: inline-flex; font-size: 13px; font-weight: 700; height: 38px; justify-content: center; width: 38px; }
+.official-agent-avatar.violet { background: #eeeafe; color: #6d56b7; }
+.official-agent-avatar.sky { background: #e6f4ff; color: #2786bc; }
+.official-agent-avatar.amber { background: #fff1d7; color: #b46d0d; }
+.official-agent-card h2 { font-size: 16px; letter-spacing: -.2px; margin: 17px 0 7px; }
+.official-agent-card p { color: #80807e; font-size: 13px; line-height: 1.55; margin: 0; }
+.official-agent-card button { background: transparent; border: 0; bottom: 17px; color: #3c3c3a; cursor: pointer; font-size: 13px; font-weight: 600; left: 14px; padding: 5px; position: absolute; }
+.official-agent-card button:hover { text-decoration: underline; }
+.official-query-error { color: #ae3e3e; font-size: 14px; margin: 26px max(32px, 5vw); }
+.official-loading-state { align-items: center; color: #7e7e7b; display: flex; font-size: 14px; gap: 8px; justify-content: center; min-height: 300px; }
+.official-empty-panel { align-items: center; display: flex; flex-direction: column; justify-content: center; min-height: 430px; padding: 32px; text-align: center; }
+.official-empty-icon { align-items: center; background: #f3f3f1; border-radius: 13px; color: #666; display: flex; height: 52px; justify-content: center; width: 52px; }
+.official-empty-panel h2 { font-size: 18px; margin: 17px 0 7px; }
+.official-empty-panel p { color: #858582; font-size: 14px; margin: 0 0 18px; }
+.official-settings-list { display: grid; gap: 8px; padding: 25px max(32px, 5vw); }
+.official-setting-row { background: #fff; border: 1px solid #e8e8e5; border-radius: 10px; color: #3b3b39; display: block; padding: 15px 17px; text-align: left; }
+.official-settings-list strong,
+.official-settings-list small { display: block; }
+.official-settings-list strong { font-size: 14px; }
+.official-settings-list small { color: #888885; font-size: 12px; margin-top: 3px; }
+.official-task-list { display: grid; gap: 9px; padding: 24px max(32px, 5vw) 40px; }
+.official-task-card { align-items: center; background: #fff; border: 1px solid #e8e8e5; border-radius: 10px; color: #393937; display: flex; min-width: 0; padding: 5px 6px 5px 15px; transition: border-color 120ms ease, box-shadow 120ms ease; }
+.official-task-card:hover { background: #fafaf8; border-color: #d2d2ce; }
+.official-task-card.is-selected { border-color: #969692; box-shadow: 0 0 0 3px #00000008; }
+.official-task-card-main { align-items: center; background: transparent; border: 0; color: inherit; cursor: pointer; display: grid; flex: 1; gap: 12px; grid-template-columns: 38px minmax(0, 1fr) auto auto; min-width: 0; padding: 8px 0; text-align: left; }
+.official-task-icon { align-items: center; background: #f0f0ed; border-radius: 8px; color: #686865; display: flex; height: 34px; justify-content: center; width: 34px; }
+.official-task-copy { min-width: 0; }
+.official-task-copy strong,
+.official-task-copy small { display: block; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.official-task-copy strong { font-size: 14px; }
+.official-task-copy small { color: #888885; font-size: 12px; margin-top: 3px; }
+.official-task-status { background: #eef5ef; border-radius: 999px; color: #46804e; font-size: 11px; padding: 3px 8px; white-space: nowrap; }
+.official-task-status.is-running,
+.official-task-status.is-pending { background: #fff4de; color: #a97018; }
+.official-task-status.is-paused { background: #f0f0ee; color: #7e7e7b; }
+.official-task-status.is-failed { background: #fff0f0; color: #b34e4e; }
+.official-task-card time { color: #9a9a97; font-size: 12px; white-space: nowrap; }
+.official-task-card-actions { display: flex; gap: 3px; margin-left: 11px; }
+.official-task-card-actions button { align-items: center; background: transparent; border: 0; border-radius: 7px; color: #686865; cursor: pointer; display: inline-flex; height: 30px; justify-content: center; width: 30px; }
+.official-task-card-actions button:hover { background: #ededeb; color: #242422; }
+.official-task-card-actions button:disabled { cursor: not-allowed; opacity: .45; }
+.official-task-card-actions button:disabled svg { animation: official-spin 900ms linear infinite; }
+
+.official-task-detail { border-bottom: 1px solid var(--official-border); padding: 24px max(32px, 5vw); }
+.official-task-detail > header { align-items: flex-start; display: flex; gap: 16px; justify-content: space-between; }
+.official-task-detail h2 { font-size: 19px; margin: 3px 0 7px; }
+.official-task-detail header p:not(.official-eyebrow) { color: #777774; font-size: 13px; line-height: 1.5; margin: 0; max-width: 720px; }
+.official-task-meta { color: #787875; display: flex; flex-wrap: wrap; font-size: 12px; gap: 7px 16px; margin-top: 16px; }
+.official-task-detail-actions { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 17px; }
+.official-task-detail-actions button:disabled svg { animation: official-spin 900ms linear infinite; }
+.official-run-list { margin-top: 24px; }
+.official-run-list h3 { font-size: 14px; margin: 0 0 10px; }
+.official-run-row { align-items: center; background: transparent; border: 0; border-top: 1px solid #eeeeeb; color: #4c4c49; cursor: pointer; display: grid; font-size: 12px; gap: 13px; grid-template-columns: 76px 92px minmax(0, 1fr); padding: 11px 2px; text-align: left; width: 100%; }
+.official-run-row:hover { color: #111; }
+.official-run-row > span:last-child { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.official-run-status { background: #f0f0ee; border-radius: 999px; color: #777774; justify-self: start; padding: 3px 7px; }
+.official-run-status.is-running,
+.official-run-status.is-pending { background: #fff4de; color: #a97018; }
+.official-run-status.is-succeeded { background: #eef5ef; color: #46804e; }
+.official-run-status.is-failed { background: #fff0f0; color: #b34e4e; }
+.official-run-empty { align-items: center; color: #858582; display: flex; font-size: 12px; gap: 6px; margin: 10px 0 0; }
+.official-run-empty svg { animation: official-spin 900ms linear infinite; }
+
+@keyframes official-spin { to { transform: rotate(360deg); } }
+
+@media (max-width: 760px) {
+  .official-sidebar { flex-basis: 62px; padding-left: 7px; padding-right: 7px; }
+  .official-sidebar span,
+  .official-sidebar p,
+  .official-sidebar small,
+  .official-brand { display: none; }
+  .official-brand-row { justify-content: center; }
+  .official-collapse-button { display: none; }
+  .official-nav-item,
+  .official-recent-chat,
+  .official-sidebar-footer > button,
+  .official-user-row { justify-content: center; }
+  .official-page-header { padding-left: 22px; padding-right: 22px; }
+  .official-page-header h1 { font-size: 21px; }
+  .official-agent-grid { grid-template-columns: 1fr; padding-left: 22px; padding-right: 22px; }
+  .official-toolbar { padding-left: 22px; padding-right: 22px; }
+  .official-content-page .official-page-header { padding-left: 22px; padding-right: 22px; }
+  .official-suggestion-grid { grid-template-columns: 1fr; }
+  .official-chat-welcome { transform: none; }
+  .official-message-list { padding-left: 0; padding-right: 0; }
+  .official-outline-button { font-size: 0; gap: 0; padding: 8px; }
+  .official-composer-shell { padding-left: 14px; padding-right: 14px; }
+  .official-task-card-main { gap: 8px; grid-template-columns: 38px minmax(0, 1fr) auto; }
+  .official-task-card time { display: none; }
+  .official-task-detail { padding-left: 22px; padding-right: 22px; }
+  .official-run-row { grid-template-columns: 76px minmax(0, 1fr); }
+  .official-run-row > span:nth-child(2) { display: none; }
+}
@@ -26,6 +26,11 @@ interface PositionIntentInputProps extends Step1InputAreaProps {
  selectedModel?: string;
  onSelectedModelChange?: (model: string) => void;
  commonQuestions?: (string | AgentQuestion)[] | null;
+  /**
+   * 点击常用问题 chip 时直接把问题发送出去（8BF 第一步）。
+   * 缺省 false：仅填充输入框（岗位会商等既有页面的行为保持不变）。
+   */
+  sendCommonQuestionOnClick?: boolean;
  /** 仅保留上传、模型选择和发送的紧凑输入区（用于会商第 3 步）。 */
  hideUtilityActions?: boolean;
 }
@@ -68,6 +73,7 @@ export function PositionIntentInput({
  selectedModel,
  onSelectedModelChange,
  commonQuestions,
+  sendCommonQuestionOnClick = false,
  hideUtilityActions = false,
 }: PositionIntentInputProps) {
  // Files are owned by Step1Panel. This ref only opens the native picker and
@@ -86,7 +92,13 @@ export function PositionIntentInput({
    : (modelOptions[0]?.value ?? "");

  const pickCommonQuestion = (question: AgentQuestion) => {
-    onValueChange(question.prompt);
+    // 直接发送模式：以问题全文为覆盖文本调 onSend，绕过输入框 state 的
+    // 异步更新（同 tick 里 onSend 闭包读不到刚 setValue 的新值）。
+    if (sendCommonQuestionOnClick) {
+      onSend(question.prompt);
+    } else {
+      onValueChange(question.prompt);
+    }
    setShowMoreQuestions(false);
  };

@@ -160,6 +172,7 @@ export function PositionIntentInput({
                  type="button"
                  className="position-roundtable-intent-common-question"
                  title={question.prompt}
+                  disabled={sendCommonQuestionOnClick ? isSending : undefined}
                  onClick={() => pickCommonQuestion(question)}
                >
                  <span aria-hidden="true" />
@@ -185,6 +198,7 @@ export function PositionIntentInput({
                          key={`${question.prompt}-${index}`}
                          type="button"
                          title={question.prompt}
+                          disabled={sendCommonQuestionOnClick ? isSending : undefined}
                          onClick={() => pickCommonQuestion(question)}
                        >
                          {question.title}
@@ -268,7 +282,7 @@ export function PositionIntentInput({
          <button
            id="send-message-btn"
            type="button"
-            onClick={isSending ? onStop : onSend}
+            onClick={() => (isSending ? onStop() : onSend())}
            disabled={isSending ? false : !canSend}
            aria-label={isSending ? "暂停生成" : "发送"}
            title={isSending ? "暂停生成" : "发送"}
@@ -0,0 +1,68 @@
+# 报告协作工作台（AgentScope 多智能体）—— 前端模块
+
+实现计划：`docs/agentscope-多智能体报告协作工作台-前端实施计划.md`
+（配套后端计划：`docs/agentscope-多智能体报告协作工作台-后端实施计划.md`）。
+
+**联调对接：** `docs/agentscope-多智能体报告协作工作台-前端对接指南.md`（环境配置、API 时序、验收清单）。
+
+**进度（2026-09-06）：** 页面与契约已完成，默认对接真实后端（`GET/POST /api/report-collaboration/*`）。后端 `RC-BE-000`～`018` 已落地。联调见 `docs/agentscope-多智能体报告协作工作台-前端对接指南.md`。
+
+## 结构
+
+```text
+src/report-collaboration/
+  api/        # 契约类型 + REST/SSE 客户端
+    types.ts        # 前后端共享领域类型（冻结契约，字段与后端 Pydantic 一致）
+    client.ts       # rcFetch：鉴权、X-Idempotency-Key、X-Expected-Revision、409/422/429/5xx 错误映射
+    sessions.ts / plans.ts / runs.ts / reports.ts   # 端点函数
+    driver.ts       # 真实后端统一门面（getReportCollaborationDriver；Mock 驱动已移除）
+  state/
+    event-normalizer.ts  # SSE/REST 事件防御性归一化
+    event-reducer.ts     # durable 事件 reducer（seq 去重、乱序缓冲、节点状态机守卫、乐观消息替换）
+    selectors.ts         # 页面状态投影（并行聚焦过滤、画布方案、阶段推导）
+    message-adapter.ts   # CollaborationMessage → LangGraph Message + BaseStream 外观 + 虚拟业务卡
+  hooks/
+    useReportCollaborationSession.ts  # 快照→SSE→合帧 reducer→动作（send/select/startRun/commands）
+    useReportCollaborationStream.ts   # SSE 连接/指数退避重连/after_seq 续接
+    useReportCollaborationMessages.ts # 消息组装（聚焦过滤 + 业务卡 + thread 外观）
+    useReportPanelLayout.ts           # 两栏宽度（持久化）、窄屏切换、键盘分隔条
+    useReportPlanSelection.ts         # 预览（纯前端）与选定（服务器事实）分离
+  components/  # Header / 两栏 Layout / 会话面板（复用 MessageList）/ 方案卡 /
+               # 画布（@xyflow/react）/ 节点抽屉 / Composer / 干预卡 / 报告预览 / 历史 / 状态栏
+  pages/ReportCollaborationPage.tsx
+  styles/report-collaboration.css   # --rc-* 语义 token（Chrome 109 兼容，无 color-mix）
+  tests/        # node:test 单测（reducer / adapter），运行：pnpm test:report-collaboration
+```
+
+## 路由与入口
+
+- `/page/workspace/report-collaboration` 新会话；`/page/workspace/report-collaboration/:sessionId` 会话页（按 sessionId 重挂）。
+- 侧边栏导航项「报告协作」（`workspace-nav-chat-list.tsx`）。
+- `WorkspaceRoutes.tsx` 引入页面与 CSS。
+
+## 关键约束（与计划一致）
+
+- 消息区**复用** `MessageList`：AgentScope 文本 / TeamSay / 工具调用与返回经
+  `message-adapter.ts` 一对一映射，经 `ThreadContext.Provider` + 合成 `BaseStream` 渲染；
+  不另做摘要卡或第二套渲染器。
+- MessageList 新增的**通用业务卡插槽** `businessCardSlot`（分组 `assistant:business-card`，
+  判据 `additional_kwargs.report_collaboration_card`，见 `core/messages/utils.ts`）只在本页
+  传入；其他页面零行为变化。
+- 服务器快照 + durable SSE 是唯一事实源；`previewPlanId` / 聚焦成员 / 面板宽度均为纯展示状态。
+- 节点抽屉只读合同；重跑/纠偏经对话命令（`targetNodeId`/`agentRunId`）。
+
+## 只走真实后端
+
+Mock 驱动（`mock.ts`）与切换开关（`deerflow.rc-mock` / `VITE_RC_MOCK`）已移除，
+页面永远请求真实后端。历史遗留的浏览器设置可执行
+`localStorage.removeItem('deerflow.rc-mock')` 清掉（不再被读取）。日常联调请保证：
+
+- `config.yaml` → `report_collaboration.enabled: true`
+- 需要成员自动执行时再开 `worker_enabled: true`
+
+## 后端契约冻结说明
+
+`api/types.ts` 按后端计划 §5/§7 编写，已与 `app/report_collaboration/contracts/` 对齐。
+快照端点约定 `GET /sessions/{id}` 返回 `SessionSnapshot`
+（session/messages/plans/run/nodes/agent_runs/commands/report_versions/last_seq）。
+`GET /runs/{id}/stream` 已按 `after_seq` / `Last-Event-ID` 重放 durable 事件（`RC-BE-011`）。queued run 的领取/租约恢复已落地（`RC-BE-012`），质量角色内核已落地（`RC-BE-013`）。报告改写 / apply / restore 已由 `RC-BE-015` 挂载。后端 20 项质量评测集见 `RC-BE-018`（确定性打分，不替代上线前真人盲评）。
@@ -0,0 +1,142 @@
+/**
+ * 报告协作 API 基础客户端：鉴权、幂等键、乐观锁与统一错误映射。
+ *
+ * - 写请求自动携带 `X-Idempotency-Key` 与 `X-Expected-Revision`。
+ * - 409 → ConflictError（刷新快照后由用户重新确认）；422 → ValidationError；
+ *   429 → RateLimitError（预算/并发限制，不自动重试）；5xx → ServerError
+ *   （保留输入，允许同一幂等键重试）。
+ */
+
+import { apiFetch } from "@/core/api/fetch-client";
+import { getBackendBaseURL } from "@/core/config";
+
+import type { ApiErrorDetail } from "./types";
+
+export const REPORT_COLLABORATION_BASE = () =>
+  `${getBackendBaseURL()}/api/report-collaboration`;
+
+export class ApiError extends Error {
+  readonly status: number;
+  readonly code?: string;
+  readonly detail?: unknown;
+
+  constructor(status: number, message: string, code?: string, detail?: unknown) {
+    super(message);
+    this.name = "ApiError";
+    this.status = status;
+    this.code = code;
+    this.detail = detail;
+  }
+}
+
+/** 409：期望 revision 已过期（或 active run 冲突），不能静默覆盖。 */
+export class ConflictError extends ApiError {}
+/** 422：请求参数/语义错误，需在对应操作附近展示。 */
+export class ValidationError extends ApiError {}
+/** 429：预算、并发或速率限制，不自动重试。 */
+export class RateLimitError extends ApiError {}
+/** 5xx：服务端错误，可带同一幂等键重试。 */
+export class ServerError extends ApiError {}
+/** 网络层错误（fetch reject）。 */
+export class NetworkError extends ApiError {
+  constructor(message: string) {
+    super(0, message, "network");
+  }
+}
+
+export function newIdempotencyKey(): string {
+  if (typeof crypto !== "undefined" && "randomUUID" in crypto) {
+    return `rc-${crypto.randomUUID()}`;
+  }
+  return `rc-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+}
+
+async function parseErrorDetail(res: Response): Promise<ApiErrorDetail | null> {
+  try {
+    const data = (await res.json()) as ApiErrorDetail | { detail?: unknown };
+    const source = "message" in data ? data : null;
+    if (source) return source;
+    if (typeof data.detail === "string") {
+      return { message: data.detail };
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+function errorForStatus(res: Response, message: string, code?: string, detail?: unknown) {
+  if (res.status === 409) return new ConflictError(409, message, code, detail);
+  if (res.status === 422) return new ValidationError(422, message, code, detail);
+  if (res.status === 429) return new RateLimitError(429, message, code, detail);
+  if (res.status >= 500) return new ServerError(res.status, message, code, detail);
+  return new ApiError(res.status, message, code, detail);
+}
+
+export interface RcRequestInit extends Omit<RequestInit, "body"> {
+  body?: unknown;
+  idempotencyKey?: string;
+  expectedRevision?: number | null;
+  /** 404 时返回 null 而不是抛错。 */
+  nullOn404?: boolean;
+  signal?: AbortSignal;
+}
+
+export async function rcRequest<T>(path: string, init: RcRequestInit = {}): Promise<T | null> {
+  const headers = new Headers();
+  headers.set("Accept", "application/json");
+  if (init.body !== undefined) {
+    headers.set("Content-Type", "application/json");
+  }
+  if (init.idempotencyKey) {
+    headers.set("X-Idempotency-Key", init.idempotencyKey);
+  }
+  if (init.expectedRevision !== undefined && init.expectedRevision !== null) {
+    headers.set("X-Expected-Revision", String(init.expectedRevision));
+  }
+
+  let res: Response;
+  try {
+    res = await apiFetch(`${REPORT_COLLABORATION_BASE()}${path}`, {
+      method: init.method ?? (init.body !== undefined ? "POST" : "GET"),
+      headers,
+      body: init.body !== undefined ? JSON.stringify(init.body) : undefined,
+      credentials: "include",
+      signal: init.signal,
+    });
+  } catch (err) {
+    throw new NetworkError(err instanceof Error ? err.message : String(err));
+  }
+
+  if (res.status === 404 && init.nullOn404) {
+    return null;
+  }
+
+  if (!res.ok) {
+    const detail = await parseErrorDetail(res);
+    throw errorForStatus(
+      res,
+      detail?.message ?? `request failed (${res.status})`,
+      detail?.code,
+      detail?.detail,
+    );
+  }
+
+  if (res.status === 204) {
+    return null;
+  }
+  const text = await res.text();
+  if (!text) {
+    return null;
+  }
+  return JSON.parse(text) as T;
+}
+
+/** GET 便捷封装（非空断言版）。 */
+export async function rcGet<T>(path: string, signal?: AbortSignal): Promise<T> {
+  const data = await rcRequest<T>(path, { method: "GET", signal });
+  if (data === null) {
+    throw new ApiError(404, `resource not found: ${path}`);
+  }
+  return data;
+}
@@ -0,0 +1,117 @@
+/**
+ * 驱动接口：直接请求真实后端（不再提供 Mock 驱动）。
+ */
+
+import * as plansApi from "@/report-collaboration/api/plans";
+import * as reportsApi from "@/report-collaboration/api/reports";
+import * as runsApi from "@/report-collaboration/api/runs";
+import * as sessionsApi from "@/report-collaboration/api/sessions";
+import type {
+  CollaborationCommand,
+  CollaborationEvent,
+  CollaborationMessage,
+  CreateCommandPayload,
+  CreateRewritePayload,
+  NodeContractDetail,
+  ReportRewriteProposal,
+  ReportRun,
+  ReportSession,
+  ReportSessionSummary,
+  ReportVersion,
+  SendMessagePayload,
+  SessionSnapshot,
+  StartRunPayload,
+} from "@/report-collaboration/api/types";
+
+export interface OpenStreamHandlers {
+  onEvent: (event: CollaborationEvent) => void;
+  onOpen?: () => void;
+  onClose?: () => void;
+  onError?: (message: string) => void;
+}
+
+export interface ReportCollaborationDriver {
+  listSessions(signal?: AbortSignal): Promise<ReportSessionSummary[]>;
+  getSnapshot(sessionId: string, signal?: AbortSignal): Promise<SessionSnapshot | null>;
+
+  createSession(title?: string): Promise<ReportSession>;
+  updateSession(
+    sessionId: string,
+    patch: { title?: string },
+    expectedRevision?: number | null,
+  ): Promise<ReportSession | null>;
+  deleteSession(sessionId: string): Promise<void>;
+
+  sendMessage(
+    sessionId: string,
+    payload: SendMessagePayload,
+    idempotencyKey: string,
+  ): Promise<CollaborationMessage>;
+
+  requestPlans(sessionId: string, expectedRevision?: number | null): Promise<void>;
+  selectPlan(
+    sessionId: string,
+    planId: string,
+    expectedRevision?: number | null,
+  ): Promise<void>;
+  startRun(
+    sessionId: string,
+    payload: StartRunPayload,
+    expectedRevision?: number | null,
+  ): Promise<ReportRun>;
+
+  getRun(runId: string, signal?: AbortSignal): Promise<ReportRun | null>;
+  listRunEvents(runId: string, afterSeq: number, signal?: AbortSignal): Promise<CollaborationEvent[]>;
+  openRunStream(
+    runId: string,
+    afterSeq: number,
+    handlers: OpenStreamHandlers,
+  ): () => void;
+  cancelRun(runId: string): Promise<ReportRun>;
+
+  createCommand(
+    runId: string,
+    payload: CreateCommandPayload,
+    idempotencyKey: string,
+  ): Promise<CollaborationCommand>;
+  confirmCommand(runId: string, commandId: string): Promise<CollaborationCommand>;
+  cancelCommand(runId: string, commandId: string): Promise<CollaborationCommand>;
+
+  getNodeContract(runId: string, nodeId: string, signal?: AbortSignal): Promise<NodeContractDetail>;
+
+  listReportVersions(sessionId: string, signal?: AbortSignal): Promise<ReportVersion[]>;
+  createRewrite(sessionId: string, payload: CreateRewritePayload): Promise<ReportRewriteProposal>;
+  applyRewrite(sessionId: string, rewriteId: string): Promise<ReportVersion>;
+  restoreReportVersion(sessionId: string, versionId: string): Promise<ReportVersion>;
+}
+
+export const realDriver: ReportCollaborationDriver = {
+  listSessions: sessionsApi.listSessions,
+  getSnapshot: sessionsApi.getSessionSnapshot,
+  createSession: (title) => sessionsApi.createSession(title ? { title } : {}),
+  updateSession: sessionsApi.updateSession,
+  deleteSession: sessionsApi.deleteSession,
+  sendMessage: sessionsApi.sendMessage,
+  requestPlans: (sessionId, expectedRevision) =>
+    plansApi.requestPlans(sessionId, undefined, expectedRevision),
+  selectPlan: async (sessionId, planId, expectedRevision) => {
+    await plansApi.selectPlan(sessionId, planId, expectedRevision);
+  },
+  startRun: runsApi.startRun,
+  getRun: runsApi.getRun,
+  listRunEvents: runsApi.listRunEvents,
+  openRunStream: runsApi.openRunStream,
+  cancelRun: runsApi.cancelRun,
+  createCommand: runsApi.createCommand,
+  confirmCommand: runsApi.confirmCommand,
+  cancelCommand: runsApi.cancelCommand,
+  getNodeContract: runsApi.getNodeContract,
+  listReportVersions: reportsApi.listReportVersions,
+  createRewrite: reportsApi.createRewrite,
+  applyRewrite: reportsApi.applyRewrite,
+  restoreReportVersion: reportsApi.restoreReportVersion,
+};
+
+export function getReportCollaborationDriver(): ReportCollaborationDriver {
+  return realDriver;
+}
@@ -0,0 +1,46 @@
+/**
+ * 候选计划：plan request / 查询 / 选定（`/sessions/{id}/plans*`）。
+ *
+ * 选择方案与开始执行是两个独立命令：select 只写 `selected_plan_id`，
+ * 不创建 run。
+ */
+
+import { newIdempotencyKey, rcGet, rcRequest } from "./client";
+import type { ReportPlanCandidate } from "./types";
+
+export async function requestPlans(
+  sessionId: string,
+  idempotencyKey = newIdempotencyKey(),
+  expectedRevision?: number | null,
+): Promise<void> {
+  await rcRequest<void>(`/sessions/${encodeURIComponent(sessionId)}/plan-requests`, {
+    method: "POST",
+    body: {},
+    idempotencyKey,
+    expectedRevision,
+  });
+}
+
+export async function listPlans(
+  sessionId: string,
+  signal?: AbortSignal,
+): Promise<ReportPlanCandidate[]> {
+  const data = await rcGet<{ plans: ReportPlanCandidate[] }>(
+    `/sessions/${encodeURIComponent(sessionId)}/plans`,
+    signal,
+  );
+  return data.plans ?? [];
+}
+
+/** 采用方案：409 表示方案 revision 过期或会话已选定，需刷新后重新确认。 */
+export async function selectPlan(
+  sessionId: string,
+  planId: string,
+  expectedRevision?: number | null,
+  idempotencyKey = newIdempotencyKey(),
+): Promise<{ selected_plan_id: string }> {
+  return rcRequest<{ selected_plan_id: string }>(
+    `/sessions/${encodeURIComponent(sessionId)}/plans/${encodeURIComponent(planId)}/select`,
+    { method: "POST", body: {}, idempotencyKey, expectedRevision },
+  ).then((res) => res as { selected_plan_id: string });
+}
@@ -0,0 +1,52 @@
+/**
+ * 报告版本、章节改写候选与版本恢复（`/sessions/{id}/reports*`）。
+ */
+
+import { newIdempotencyKey, rcGet, rcRequest } from "./client";
+import type { CreateRewritePayload, ReportRewriteProposal, ReportVersion } from "./types";
+
+export async function listReportVersions(
+  sessionId: string,
+  signal?: AbortSignal,
+): Promise<ReportVersion[]> {
+  const data = await rcGet<{ versions: ReportVersion[] }>(
+    `/sessions/${encodeURIComponent(sessionId)}/reports`,
+    signal,
+  );
+  return data.versions ?? [];
+}
+
+/** 发起章节重写 / 润色：只生成 replacement candidate，不直接覆盖正式版本。 */
+export async function createRewrite(
+  sessionId: string,
+  payload: CreateRewritePayload,
+  idempotencyKey = newIdempotencyKey(),
+): Promise<ReportRewriteProposal> {
+  return rcRequest<ReportRewriteProposal>(
+    `/sessions/${encodeURIComponent(sessionId)}/report-rewrites`,
+    { method: "POST", body: payload, idempotencyKey },
+  ).then((res) => res as ReportRewriteProposal);
+}
+
+export async function applyRewrite(
+  sessionId: string,
+  rewriteId: string,
+  idempotencyKey = newIdempotencyKey(),
+): Promise<ReportVersion> {
+  return rcRequest<ReportVersion>(
+    `/sessions/${encodeURIComponent(sessionId)}/report-rewrites/${encodeURIComponent(rewriteId)}/apply`,
+    { method: "POST", body: {}, idempotencyKey },
+  ).then((res) => res as ReportVersion);
+}
+
+/** 版本恢复：创建新的头版本，不删除历史。 */
+export async function restoreReportVersion(
+  sessionId: string,
+  versionId: string,
+  idempotencyKey = newIdempotencyKey(),
+): Promise<ReportVersion> {
+  return rcRequest<ReportVersion>(
+    `/sessions/${encodeURIComponent(sessionId)}/report-versions/${encodeURIComponent(versionId)}/restore`,
+    { method: "POST", body: {}, idempotencyKey },
+  ).then((res) => res as ReportVersion);
+}
@@ -0,0 +1,205 @@
+/**
+ * Run 执行与干预：查询、事件回放、SSE 流、命令、取消、节点合同。
+ */
+
+import { apiFetch } from "@/core/api/fetch-client";
+import { REPORT_COLLABORATION_BASE, newIdempotencyKey, rcGet, rcRequest } from "./client";
+import type {
+  CollaborationCommand,
+  CollaborationEvent,
+  CreateCommandPayload,
+  NodeContractDetail,
+  ReportRun,
+  StartRunPayload,
+} from "./types";
+
+export async function startRun(
+  sessionId: string,
+  payload: StartRunPayload,
+  expectedRevision?: number | null,
+  idempotencyKey = newIdempotencyKey(),
+): Promise<ReportRun> {
+  return rcRequest<ReportRun>(`/sessions/${encodeURIComponent(sessionId)}/runs`, {
+    method: "POST",
+    body: payload,
+    idempotencyKey,
+    expectedRevision,
+  }).then((res) => res as ReportRun);
+}
+
+export async function getRun(runId: string, signal?: AbortSignal): Promise<ReportRun | null> {
+  return rcRequest<ReportRun>(`/runs/${encodeURIComponent(runId)}`, {
+    method: "GET",
+    signal,
+    nullOn404: true,
+  });
+}
+
+/** 历史事件回放（断线补拉 / 序号缺口补齐）。 */
+export async function listRunEvents(
+  runId: string,
+  afterSeq: number,
+  signal?: AbortSignal,
+): Promise<CollaborationEvent[]> {
+  const data = await rcGet<{ events: CollaborationEvent[] }>(
+    `/runs/${encodeURIComponent(runId)}/events?after_seq=${Math.max(0, afterSeq)}`,
+    signal,
+  );
+  return data.events ?? [];
+}
+
+export async function cancelRun(
+  runId: string,
+  idempotencyKey = newIdempotencyKey(),
+): Promise<ReportRun> {
+  return rcRequest<ReportRun>(`/runs/${encodeURIComponent(runId)}/cancel`, {
+    method: "POST",
+    body: {},
+    idempotencyKey,
+  }).then((res) => res as ReportRun);
+}
+
+export async function getNodeContract(
+  runId: string,
+  nodeId: string,
+  signal?: AbortSignal,
+): Promise<NodeContractDetail> {
+  return rcGet<NodeContractDetail>(
+    `/runs/${encodeURIComponent(runId)}/nodes/${encodeURIComponent(nodeId)}/contract`,
+    signal,
+  );
+}
+
+// ── 用户命令（全过程干预）────────────────────────────────────────────────────
+
+export async function createCommand(
+  runId: string,
+  payload: CreateCommandPayload,
+  idempotencyKey = newIdempotencyKey(),
+): Promise<CollaborationCommand> {
+  return rcRequest<CollaborationCommand>(`/runs/${encodeURIComponent(runId)}/commands`, {
+    method: "POST",
+    body: payload,
+    idempotencyKey,
+  }).then((res) => res as CollaborationCommand);
+}
+
+export async function confirmCommand(
+  runId: string,
+  commandId: string,
+  idempotencyKey = newIdempotencyKey(),
+): Promise<CollaborationCommand> {
+  return rcRequest<CollaborationCommand>(
+    `/runs/${encodeURIComponent(runId)}/commands/${encodeURIComponent(commandId)}/confirm`,
+    { method: "POST", body: {}, idempotencyKey },
+  ).then((res) => res as CollaborationCommand);
+}
+
+export async function cancelCommand(
+  runId: string,
+  commandId: string,
+  idempotencyKey = newIdempotencyKey(),
+): Promise<CollaborationCommand> {
+  return rcRequest<CollaborationCommand>(
+    `/runs/${encodeURIComponent(runId)}/commands/${encodeURIComponent(commandId)}/cancel`,
+    { method: "POST",
+      body: {},
+      idempotencyKey },
+  ).then((res) => res as CollaborationCommand);
+}
+
+// ── SSE 订阅 ─────────────────────────────────────────────────────────────────
+
+export interface RunStreamHandlers {
+  onEvent: (event: CollaborationEvent) => void;
+  onOpen?: () => void;
+  /** 服务端正常关流（终态）。 */
+  onClose?: () => void;
+  /** 传输层异常（触发重连）。 */
+  onError?: (message: string) => void;
+}
+
+/**
+ * 订阅 run 的 durable SSE 流。支持 `after_seq` 与 `Last-Event-ID`。
+ *
+ * 返回 close 函数：幂等，调用后中断连接且不再触发回调。
+ * 注意：fetch 流式读取无法携带 EventSource 的自动重连，重连由
+ * useReportCollaborationStream 以指数退避驱动。
+ */
+export function openRunStream(
+  runId: string,
+  afterSeq: number,
+  handlers: RunStreamHandlers,
+): () => void {
+  const controller = new AbortController();
+  let closed = false;
+
+  const close = () => {
+    if (closed) return;
+    closed = true;
+    controller.abort();
+  };
+
+  void (async () => {
+    try {
+      const res = await apiFetch(
+        `${REPORT_COLLABORATION_BASE()}/runs/${encodeURIComponent(runId)}/stream?after_seq=${Math.max(0, afterSeq)}`,
+        { method: "GET", signal: controller.signal, headers: { Accept: "text/event-stream" } },
+      );
+      if (!res.ok || !res.body) {
+        if (!closed) handlers.onError?.(`stream failed (${res.status})`);
+        return;
+      }
+      handlers.onOpen?.();
+
+      const reader = res.body.getReader();
+      const decoder = new TextDecoder();
+      let buffer = "";
+      let dataLines: string[] = [];
+      let lastEventId: string | undefined;
+
+      const flushData = () => {
+        if (dataLines.length === 0) return;
+        const json = dataLines.join("\n").trim();
+        dataLines = [];
+        if (!json) return;
+        try {
+          const event = JSON.parse(json) as CollaborationEvent;
+          if (lastEventId) event.eventId = event.eventId || lastEventId;
+          handlers.onEvent(event);
+        } catch {
+          // 非 JSON 帧（如注释/心跳文本）忽略，不中断连接。
+        }
+      };
+
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const raw of lines) {
+          const line = raw.replace(/\r$/, "");
+          if (line === "") {
+            flushData();
+            continue;
+          }
+          if (line.startsWith("id:")) {
+            lastEventId = line.slice(3).trim() || undefined;
+          } else if (line.startsWith("data:")) {
+            dataLines.push(line.slice(5).trimStart());
+          }
+          // `event:` / `:` 注释行不影响 data 解析。
+        }
+      }
+      flushData();
+      if (!closed) handlers.onClose?.();
+    } catch (err) {
+      if (!closed && !controller.signal.aborted) {
+        handlers.onError?.(err instanceof Error ? err.message : String(err));
+      }
+    }
+  })();
+
+  return close;
+}
@@ -0,0 +1,84 @@
+/**
+ * 会话 CRUD 与消息读写（`/api/report-collaboration/sessions`）。
+ */
+
+import { newIdempotencyKey, rcGet, rcRequest } from "./client";
+import type {
+  CollaborationMessage,
+  CreateSessionPayload,
+  ReportSession,
+  ReportSessionSummary,
+  SendMessagePayload,
+  SessionSnapshot,
+  UpdateSessionPayload,
+} from "./types";
+
+export async function listSessions(signal?: AbortSignal): Promise<ReportSessionSummary[]> {
+  const data = await rcGet<{ sessions: ReportSessionSummary[] }>("/sessions", signal);
+  return data.sessions ?? [];
+}
+
+export async function getSessionSnapshot(
+  sessionId: string,
+  signal?: AbortSignal,
+): Promise<SessionSnapshot | null> {
+  return rcRequest<SessionSnapshot>(`/sessions/${encodeURIComponent(sessionId)}`, {
+    method: "GET",
+    signal,
+    nullOn404: true,
+  });
+}
+
+export async function createSession(
+  payload: CreateSessionPayload = {},
+  idempotencyKey = newIdempotencyKey(),
+): Promise<ReportSession> {
+  return rcRequest<ReportSession>("/sessions", {
+    method: "POST",
+    body: payload,
+    idempotencyKey,
+  }).then((res) => res as ReportSession);
+}
+
+export async function updateSession(
+  sessionId: string,
+  patch: UpdateSessionPayload,
+  expectedRevision?: number | null,
+  idempotencyKey = newIdempotencyKey(),
+): Promise<ReportSession | null> {
+  return rcRequest<ReportSession>(`/sessions/${encodeURIComponent(sessionId)}`, {
+    method: "PATCH",
+    body: patch,
+    idempotencyKey,
+    expectedRevision,
+    nullOn404: true,
+  });
+}
+
+export async function deleteSession(sessionId: string): Promise<void> {
+  await rcRequest<void>(`/sessions/${encodeURIComponent(sessionId)}`, {
+    method: "DELETE",
+  });
+}
+
+export async function listMessages(
+  sessionId: string,
+  signal?: AbortSignal,
+): Promise<CollaborationMessage[]> {
+  const data = await rcGet<{ messages: CollaborationMessage[] }>(
+    `/sessions/${encodeURIComponent(sessionId)}/messages`,
+    signal,
+  );
+  return data.messages ?? [];
+}
+
+export async function sendMessage(
+  sessionId: string,
+  payload: SendMessagePayload,
+  idempotencyKey = newIdempotencyKey(),
+): Promise<CollaborationMessage> {
+  return rcRequest<CollaborationMessage>(
+    `/sessions/${encodeURIComponent(sessionId)}/messages`,
+    { method: "POST", body: payload, idempotencyKey },
+  ).then((res) => res as CollaborationMessage);
+}
@@ -0,0 +1,709 @@
+/**
+ * 报告协作工作台（AgentScope 多智能体）—— 前后端共享领域类型。
+ *
+ * 契约来源：`docs/agentscope-多智能体报告协作工作台-后端实施计划.md` §5/§7。
+ * 字段与后端 Pydantic 合同保持 snake_case 一一对应；前端只在 selector/adapter
+ * 层做投影，不再二次推断状态。
+ *
+ * 后端尚未实现时本层即为冻结契约（RC-FE-004 前置条件），修改字段需同步两份计划文档。
+ */
+
+// ── 会话 ─────────────────────────────────────────────────────────────────────
+
+/** 会话状态机（后端 §6 sessions.status）。 */
+export type ReportSessionStatus =
+  | "empty"
+  | "clarifying"
+  | "planning"
+  | "proposal_ready"
+  | "running"
+  | "awaiting_input"
+  | "reviewing"
+  | "completed"
+  | "failed"
+  | "cancelled";
+
+export interface ReportSession {
+  id: string;
+  title: string;
+  status: ReportSessionStatus;
+  requirement_revision: number;
+  selected_plan_id: string | null;
+  active_run_id: string | null;
+  current_report_version_id: string | null;
+  created_at: string;
+  updated_at: string;
+}
+
+/** 会话列表条目（轻量，无 messages）。 */
+export type ReportSessionSummary = ReportSession;
+
+// ── 需求快照 ─────────────────────────────────────────────────────────────────
+
+export interface ReportRequirementSnapshot {
+  topic: string;
+  objective?: string | null;
+  audience?: string | null;
+  language?: string | null;
+  time_range?: string | null;
+  geography?: string | null;
+  required_angles: string[];
+  excluded_angles: string[];
+  source_constraints?: string | null;
+  report_structure_id?: string | null;
+  length_target?: string | null;
+  tone?: string | null;
+  deadline_hint?: string | null;
+  quality_priority?: string | null;
+  revision: number;
+}
+
+// ── 消息镜像（ConversationReplica）──────────────────────────────────────────
+
+export type CollaborationMessageRole = "human" | "ai" | "tool";
+
+/** ai 消息上的工具调用（args 流式期间为部分 JSON 字符串，完成后为对象）。 */
+export interface CollaborationToolCall {
+  id: string;
+  name: string;
+  args: string | Record<string, unknown>;
+}
+
+/**
+ * 后端 `report_collaboration_messages` 行的镜像：用户可见的 assistant 文本、
+ * TeamSay、`tool_calls` 与 `tool` 返回都落在这同一张时间线上。
+ */
+export interface CollaborationMessage {
+  message_id: string;
+  role: CollaborationMessageRole;
+  content: string;
+  /** 成员显示名（TeamSay / 成员回复 / tool 名）。 */
+  name?: string | null;
+  tool_calls?: CollaborationToolCall[];
+  tool_call_id?: string | null;
+  /** 并行阶段稳定归属；协调者广播可为 null（共享上下文）。 */
+  agent_run_id?: string | null;
+  node_run_id?: string | null;
+  phase_id?: string | null;
+  visibility: "visible" | "internal";
+  metadata?: Record<string, unknown> | null;
+  command_id?: string | null;
+  created_at: string;
+  /** null = 仍在流式输出。 */
+  completed_at?: string | null;
+}
+
+// ── 候选计划 ─────────────────────────────────────────────────────────────────
+
+export type ReportPlanStatus =
+  | "proposed"
+  | "selected"
+  | "superseded"
+  | "rejected"
+  | "executing"
+  | "completed";
+
+export type ReportCostLevel = "low" | "medium" | "high";
+
+export interface PlanRole {
+  key: string;
+  display_name: string;
+  responsibility: string;
+  angle?: string | null;
+}
+
+export interface QualityGate {
+  id: string;
+  label: string;
+  description?: string | null;
+}
+
+export interface PlanValidation {
+  ok: boolean;
+  errors: string[];
+}
+
+/** 计划图节点：节点合同的用户可见摘要（不含执行结果）。 */
+export interface PlanNode {
+  id: string;
+  label: string;
+  role_key?: string | null;
+  role_display_name?: string | null;
+  angle?: string | null;
+  depends_on: string[];
+  /** 合同摘要；完整合同走 `GET /runs/{run_id}/nodes/{node_id}/contract`。 */
+  mission?: string | null;
+  output_artifact_type?: string | null;
+  input_artifact_types?: string[];
+  allowed_tools?: string[];
+  acceptance_criteria?: string[];
+}
+
+export interface PlanEdge {
+  source: string;
+  target: string;
+  label?: string | null;
+}
+
+export interface ReportPlanCandidate {
+  id: string;
+  proposal_group_id: string;
+  title: string;
+  strategy: string;
+  summary: string;
+  rationale: string;
+  recommended?: boolean;
+  estimated_duration_seconds: number;
+  estimated_cost_level: ReportCostLevel;
+  requirement_revision: number;
+  roles: PlanRole[];
+  nodes: PlanNode[];
+  edges: PlanEdge[];
+  quality_gates: QualityGate[];
+  report_structure_id: string | null;
+  validation: PlanValidation;
+  revision: number;
+  status: ReportPlanStatus;
+}
+
+// ── 节点运行状态 ─────────────────────────────────────────────────────────────
+
+/** 后端 §5.5 状态机：completed 只能经 reopened 重新入队。 */
+export type CollaborationNodeStatus =
+  | "planned"
+  | "queued"
+  | "running"
+  | "validating"
+  | "completed"
+  | "failed"
+  | "awaiting_input"
+  | "cancel_requested"
+  | "cancelled"
+  | "superseded"
+  | "reopened"
+  | "interrupted";
+
+export interface NodeAwaitingInput {
+  reason: string;
+  question: string;
+  impact?: string[];
+}
+
+export interface NodeAttemptState {
+  attempt: number;
+  status: CollaborationNodeStatus;
+  started_at?: string | null;
+  ended_at?: string | null;
+  error?: string | null;
+}
+
+export interface CollaborationNodeState {
+  node_id: string;
+  label: string;
+  role_display_name?: string | null;
+  angle?: string | null;
+  status: CollaborationNodeStatus;
+  attempt: number;
+  progress?: string | null;
+  awaiting_input?: NodeAwaitingInput | null;
+  error?: string | null;
+  attempts: NodeAttemptState[];
+}
+
+// ── 智能体成员（并行阶段稳定身份）────────────────────────────────────────────
+
+export type AgentRunStatus =
+  | "pending"
+  | "running"
+  | "waiting_input"
+  | "completed"
+  | "failed"
+  | "cancelled";
+
+export interface AgentRun {
+  agent_run_id: string;
+  node_run_id?: string | null;
+  phase_id?: string | null;
+  role: string;
+  display_name: string;
+  avatar_key?: string | null;
+  status: AgentRunStatus;
+  started_at?: string | null;
+  ended_at?: string | null;
+}
+
+// ── Run ──────────────────────────────────────────────────────────────────────
+
+export type ReportRunStatus =
+  | "queued"
+  | "planning"
+  | "running"
+  | "awaiting_input"
+  | "reviewing"
+  | "completed"
+  | "failed"
+  | "cancelled"
+  | "recovering";
+
+export interface ReportRun {
+  id: string;
+  session_id: string;
+  plan_id: string;
+  status: ReportRunStatus;
+  cancel_requested: boolean;
+  next_event_seq: number;
+  current_phase?: string | null;
+  usage?: Record<string, unknown>;
+  budget_exhausted_reason?: string | null;
+  created_at: string;
+  updated_at: string;
+}
+
+// ── 用户命令（全过程干预）────────────────────────────────────────────────────
+
+export type CommandIntent =
+  | "answer_question"
+  | "update_requirements"
+  | "add_angle"
+  | "research_again"
+  | "reanalyze"
+  | "rerun_node"
+  | "rewrite_section"
+  | "polish_report"
+  | "ask_report"
+  | "replan"
+  | "cancel";
+
+export type CommandStatus =
+  | "pending"
+  | "classified"
+  | "confirmation_required"
+  | "accepted"
+  | "accepted_waiting_boundary"
+  | "executing"
+  | "completed"
+  | "failed"
+  | "cancelled"
+  | "rejected";
+
+export interface CollaborationCommand {
+  command_id: string;
+  idempotency_key: string;
+  text: string;
+  intent?: CommandIntent | null;
+  confidence?: number | null;
+  target_type?: string | null;
+  target_ids: string[];
+  normalized_instruction?: string | null;
+  requires_confirmation: boolean;
+  cost_level?: ReportCostLevel | null;
+  reason?: string | null;
+  impact_nodes?: string[];
+  status: CommandStatus;
+  expected_revision?: number | null;
+  error?: string | null;
+  created_at: string;
+  updated_at?: string | null;
+}
+
+// ── 成果物 / 来源 / 报告版本 ────────────────────────────────────────────────
+
+export type ArtifactValidationStatus =
+  | "pending"
+  | "validated"
+  | "rejected"
+  | "superseded";
+
+export interface CollaborationArtifact {
+  id: string;
+  run_id: string;
+  node_id: string;
+  attempt: number;
+  artifact_type: string;
+  schema_version: number;
+  validation_status: ArtifactValidationStatus;
+  /** 用户可见摘要（如「12 条来源，8 条近 90 天」）；不含正文。 */
+  summary?: string | null;
+  created_at: string;
+}
+
+export interface ReportSource {
+  id: string;
+  url?: string | null;
+  title: string;
+  published_at?: string | null;
+  added_at: string;
+  agent_run_id?: string | null;
+}
+
+export type ReportChangeType =
+  | "initial"
+  | "section_rewrite"
+  | "polish"
+  | "restore"
+  | "revision";
+
+export interface ReportVersion {
+  id: string;
+  session_id: string;
+  version: number;
+  parent_version_id: string | null;
+  change_type: ReportChangeType;
+  change_summary?: string | null;
+  markdown: string;
+  source_index?: ReportSource[];
+  created_at: string;
+  is_head?: boolean;
+}
+
+export interface ReportRewriteProposal {
+  id: string;
+  session_id: string;
+  section?: string | null;
+  instruction: string;
+  status: "proposed" | "applied" | "dismissed";
+  markdown?: string | null;
+  created_at: string;
+}
+
+// ── 澄清 ─────────────────────────────────────────────────────────────────────
+
+export interface ClarificationRecord {
+  id: string;
+  questions: string[];
+  impact?: string[];
+  resolved: boolean;
+  created_at: string;
+}
+
+// ── SSE 事件协议 ─────────────────────────────────────────────────────────────
+
+export type CollaborationEventType =
+  // 会话与消息镜像
+  | "session.snapshot"
+  | "message.created"
+  | "message.delta"
+  | "message.completed"
+  | "tool_call.created"
+  | "tool_call.delta"
+  | "tool_call.completed"
+  | "tool_result.created"
+  | "tool_result.delta"
+  | "tool_result.completed"
+  | "team_message.created"
+  | "team_message.delta"
+  | "team_message.completed"
+  // 需求与澄清
+  | "requirement.updated"
+  | "clarification.requested"
+  | "clarification.resolved"
+  // 计划
+  | "plan.progress"
+  | "plan.proposed"
+  | "plan.selected"
+  // Run / 节点
+  | "run.status.changed"
+  | "node.created"
+  | "node.status.changed"
+  | "node.progress"
+  | "node.attempt.created"
+  // 成果与来源
+  | "artifact.created"
+  | "artifact.validated"
+  | "artifact.rejected"
+  | "source.added"
+  // 命令
+  | "command.classified"
+  | "command.confirmation.required"
+  | "command.accepted"
+  | "command.completed"
+  | "command.failed"
+  | "command.cancelled"
+  // 报告与评审
+  | "report.delta"
+  | "report.version.created"
+  | "review.created"
+  // 其他
+  | "error"
+  | "heartbeat";
+
+export interface CollaborationEvent<T = unknown> {
+  eventId: string;
+  sessionId: string;
+  runId?: string | null;
+  seq: number;
+  type: CollaborationEventType;
+  timestamp: string;
+  data: T;
+}
+
+// ── 事件 payload ─────────────────────────────────────────────────────────────
+
+export interface MessageEventPayload {
+  message: CollaborationMessage;
+}
+
+export interface MessageDeltaPayload {
+  message_id: string;
+  agent_run_id?: string | null;
+  node_run_id?: string | null;
+  delta: string;
+  /** 思考过程增量，写入消息 `metadata.reasoning_content`，由适配器映射到问答 CoT。 */
+  reasoning_delta?: string;
+}
+
+export interface MessageCompletedPayload {
+  message_id: string;
+  agent_run_id?: string | null;
+  content?: string;
+  completed_at?: string;
+}
+
+export interface ToolCallCreatedPayload {
+  message_id: string;
+  agent_run_id?: string | null;
+  tool_call: CollaborationToolCall;
+}
+
+export interface ToolCallDeltaPayload {
+  message_id: string;
+  tool_call_id: string;
+  args_delta: string;
+}
+
+export interface ToolCallCompletedPayload {
+  message_id: string;
+  tool_call: CollaborationToolCall;
+}
+
+export interface ToolResultCreatedPayload {
+  /** 工具返回作为独立 tool 消息的稳定 id（缺省时前端以 `tool:{tool_call_id}` 派生）。 */
+  message_id?: string;
+  tool_call_id: string;
+  name: string;
+  agent_run_id?: string | null;
+  node_run_id?: string | null;
+  phase_id?: string | null;
+  content?: string;
+}
+
+export interface ToolResultDeltaPayload {
+  message_id?: string;
+  tool_call_id: string;
+  delta: string;
+}
+
+export interface ToolResultCompletedPayload {
+  message_id?: string;
+  tool_call_id: string;
+  content?: string;
+}
+
+export interface RequirementUpdatedPayload {
+  requirement: ReportRequirementSnapshot;
+}
+
+export interface ClarificationRequestedPayload {
+  clarification: ClarificationRecord;
+  /** 同时镜像为 ask_clarification tool 消息（由后端 ConversationReplica 发出）。 */
+  message?: CollaborationMessage;
+}
+
+export interface ClarificationResolvedPayload {
+  clarification_id: string;
+}
+
+export interface PlanProgressPayload {
+  stage: string;
+  detail?: string | null;
+}
+
+export interface PlanProposedPayload {
+  plans: ReportPlanCandidate[];
+}
+
+export interface PlanSelectedPayload {
+  plan_id: string;
+}
+
+export interface RunStatusChangedPayload {
+  status: ReportRunStatus;
+  phase?: string | null;
+  reason?: string | null;
+}
+
+export interface NodeCreatedPayload {
+  node: CollaborationNodeState;
+}
+
+export interface NodeStatusChangedPayload {
+  node_id: string;
+  status: CollaborationNodeStatus;
+  attempt: number;
+  awaiting_input?: NodeAwaitingInput | null;
+  error?: string | null;
+}
+
+export interface NodeProgressPayload {
+  node_id: string;
+  progress: string;
+}
+
+export interface NodeAttemptCreatedPayload {
+  node_id: string;
+  attempt: number;
+  reason?: string | null;
+}
+
+export interface ArtifactCreatedPayload {
+  artifact: CollaborationArtifact;
+}
+
+export interface ArtifactValidatedPayload {
+  artifact_id: string;
+}
+
+export interface ArtifactRejectedPayload {
+  artifact_id: string;
+  reasons: string[];
+}
+
+export interface SourceAddedPayload {
+  source: ReportSource;
+}
+
+export interface CommandClassifiedPayload {
+  command: CollaborationCommand;
+}
+
+export interface CommandConfirmationRequiredPayload {
+  command: CollaborationCommand;
+}
+
+export interface CommandAcceptedPayload {
+  command_id: string;
+  waiting_boundary: boolean;
+  impact_nodes?: string[];
+}
+
+export interface CommandCompletedPayload {
+  command_id: string;
+  result_summary?: string | null;
+  report_version_id?: string | null;
+}
+
+export interface CommandFailedPayload {
+  command_id: string;
+  error: string;
+}
+
+export interface CommandCancelledPayload {
+  command_id: string;
+  command?: CollaborationCommand;
+}
+
+export interface ReportDeltaPayload {
+  draft_id?: string | null;
+  delta: string;
+}
+
+export interface ReportVersionCreatedPayload {
+  version: ReportVersion;
+}
+
+export interface ReviewCreatedPayload {
+  review: {
+    reviewer: string;
+    verdict: "pass" | "revise";
+    issues: { severity: string; target: string; requirement: string }[];
+  };
+}
+
+export interface ErrorEventPayload {
+  message: string;
+  recover_hint?: string | null;
+  node_id?: string | null;
+}
+
+export interface HeartbeatPayload {
+  ts?: string;
+}
+
+// ── 快照 / 请求体 ────────────────────────────────────────────────────────────
+
+/** `GET /sessions/{id}` 返回的完整快照：前端唯一事实源投影。 */
+export interface SessionSnapshot {
+  session: ReportSession;
+  messages: CollaborationMessage[];
+  plans: ReportPlanCandidate[];
+  run: ReportRun | null;
+  nodes: CollaborationNodeState[];
+  agent_runs: AgentRun[];
+  commands: CollaborationCommand[];
+  report_versions: ReportVersion[];
+  /** 已持久化事件的最大 seq；SSE 以 after_seq=last_seq 续接。 */
+  last_seq: number;
+}
+
+export interface CreateSessionPayload {
+  title?: string;
+}
+
+export interface UpdateSessionPayload {
+  title?: string;
+}
+
+export interface SendMessagePayload {
+  text: string;
+  /** 从节点抽屉 / 并行选择器带出的目标上下文。 */
+  target_node_id?: string | null;
+  agent_run_id?: string | null;
+}
+
+export interface StartRunPayload {
+  plan_id: string;
+}
+
+export interface CreateCommandPayload {
+  text: string;
+  target_node_id?: string | null;
+  agent_run_id?: string | null;
+}
+
+export interface CreateRewritePayload {
+  instruction: string;
+  section?: string | null;
+}
+
+/** 统一错误模型（client 层抛出的 ApiError 携带这些字段）。 */
+export interface ApiErrorDetail {
+  code?: string;
+  message: string;
+  detail?: unknown;
+}
+
+/**
+ * `GET /runs/{run_id}/nodes/{node_id}/contract` 返回的节点合同详情。
+ * 只含职责与输入输出合同，绝不含执行结果正文（后端 §7.1）。
+ */
+export interface NodeContractDetail {
+  node_id: string;
+  label: string;
+  role: string | null;
+  angle: string | null;
+  status: CollaborationNodeStatus;
+  attempt: number;
+  mission: string;
+  input_artifact_types: string[];
+  source_policy?: string | null;
+  output_artifact_type: string;
+  output_structure?: string | null;
+  acceptance_criteria: string[];
+  allowed_tools: string[];
+  forbidden?: string[];
+  time_budget_seconds?: number | null;
+  token_budget?: number | null;
+  max_attempts: number;
+  upstream: string[];
+  downstream: string[];
+}
@@ -0,0 +1,133 @@
+"use client";
+
+import { memo } from "react";
+import { Check, Loader2, X } from "lucide-react";
+
+import type { AgentRun } from "@/report-collaboration/api/types";
+import { roleIcon } from "@/report-collaboration/components/ReportFlowNode";
+
+interface AgentStageSelectorProps {
+  /** 当前正在执行的成员；空数组且无 pinned 时不渲染。 */
+  tabs: AgentRun[];
+  /** 点击画布节点后钉住的历史成员（波次结束后回看步骤条）。 */
+  pinnedAgent?: AgentRun | null;
+  phaseLabel?: string | null;
+  focusedAgentRunId: string | null;
+  onFocus: (agentRunId: string) => void;
+  /** 取消钉住，回到全量时间线。 */
+  onShowAll?: () => void;
+  /** 正在流式输出的成员。 */
+  streamingAgentRunIds: Set<string>;
+  /** 请求用户协助（待回复）的成员。 */
+  awaitingAgentRunIds: Set<string>;
+}
+
+function avatarStatus(
+  agentRun: AgentRun,
+  streaming: boolean,
+  awaiting: boolean,
+): "running" | "awaiting" | "done" | "error" | "queued" {
+  if (awaiting) return "awaiting";
+  if (agentRun.status === "failed" || agentRun.status === "cancelled") return "error";
+  if (agentRun.status === "completed") return "done";
+  if (agentRun.status === "running" || streaming) return "running";
+  return "queued";
+}
+
+function statusLabel(status: ReturnType<typeof avatarStatus>, displayName: string): string {
+  const suffix =
+    status === "running"
+      ? "进行中"
+      : status === "awaiting"
+        ? "待回复"
+        : status === "done"
+          ? "已完成"
+          : status === "error"
+            ? "失败"
+            : "排队中";
+  return `${displayName}（${suffix}）`;
+}
+
+/**
+ * 执行中头像条（对齐会商第二步 sandbox）：
+ * 单个模型节点与并行波次都展示；点头像切换到该成员的步骤条 / 模型输出。
+ * 未选中成员的事件继续接收并持久更新。
+ */
+export const AgentStageSelector = memo(function AgentStageSelector({
+  tabs,
+  pinnedAgent = null,
+  phaseLabel,
+  focusedAgentRunId,
+  onFocus,
+  onShowAll,
+  streamingAgentRunIds,
+  awaitingAgentRunIds,
+}: AgentStageSelectorProps) {
+  const visibleTabs =
+    tabs.length > 0
+      ? tabs
+      : pinnedAgent
+        ? [pinnedAgent]
+        : [];
+  if (visibleTabs.length === 0) return null;
+  const focused = focusedAgentRunId ?? visibleTabs[0]?.agent_run_id;
+  const runningCount = visibleTabs.filter((tab) => {
+    const status = avatarStatus(
+      tab,
+      streamingAgentRunIds.has(tab.agent_run_id),
+      awaitingAgentRunIds.has(tab.agent_run_id),
+    );
+    return status === "running" || status === "awaiting";
+  }).length;
+  const stripLabel =
+    phaseLabel ??
+    (visibleTabs.length > 1 ? `并行 ${visibleTabs.length} 席` : visibleTabs[0]?.display_name ?? "当前节点");
+
+  return (
+    <div className="rc-agent-tabs" role="tablist" aria-label="执行成员">
+      <div className="rc-agent-strip-meta">
+        <span>{stripLabel}</span>
+        {runningCount > 0 && <span className="rc-agent-strip-running">{runningCount} 进行中</span>}
+      </div>
+      <div className="rc-agent-avatars">
+        {visibleTabs.map((tab) => {
+          const streaming = streamingAgentRunIds.has(tab.agent_run_id);
+          const awaiting = awaitingAgentRunIds.has(tab.agent_run_id);
+          const status = avatarStatus(tab, streaming, awaiting);
+          const active = focused === tab.agent_run_id;
+          return (
+            <button
+              key={tab.agent_run_id}
+              type="button"
+              role="tab"
+              aria-selected={active}
+              data-active={active}
+              data-status={status}
+              data-role={tab.role}
+              className="rc-agent-avatar"
+              title={statusLabel(status, tab.display_name)}
+              aria-label={statusLabel(status, tab.display_name)}
+              onClick={() => onFocus(tab.agent_run_id)}
+            >
+              {status === "running" && <span className="rc-agent-avatar-ping" aria-hidden />}
+              <span className="rc-agent-avatar-face" aria-hidden>
+                {roleIcon(tab.role)}
+              </span>
+              <span className="rc-agent-avatar-badge" data-status={status} aria-hidden>
+                {status === "running" && <Loader2 className="rc-spin size-2.5" />}
+                {status === "awaiting" && <span className="rc-agent-avatar-dot" />}
+                {status === "done" && <Check className="size-2.5" strokeWidth={3} />}
+                {status === "error" && <X className="size-2.5" strokeWidth={3} />}
+              </span>
+            </button>
+          );
+        })}
+      </div>
+      {onShowAll && (tabs.length <= 1 || Boolean(pinnedAgent)) ? (
+        <button type="button" className="rc-btn rc-agent-show-all" onClick={onShowAll}>
+          全部对话
+        </button>
+      ) : null}
+    </div>
+  );
+});
@@ -0,0 +1,41 @@
+"use client";
+
+import { useI18n } from "@/core/i18n/hooks";
+
+import type { RcConnectionStatus } from "@/report-collaboration/hooks/useReportCollaborationStream";
+
+const STATUS_TEXT: Record<RcConnectionStatus, string> = {
+  idle: "未连接",
+  connecting: "连接中…",
+  live: "实时",
+  reconnecting: "重连中…",
+  closed: "已关闭",
+  error: "连接异常",
+};
+
+/** 底部连接状态栏：连接态 + run + 事件游标（aria-live 播报）。 */
+export function ConnectionStatusBar({
+  status,
+  runId,
+  lastSeq,
+  message,
+}: {
+  status: RcConnectionStatus;
+  runId: string | null;
+  lastSeq: number;
+  message?: string;
+}) {
+  const { t } = useI18n();
+  void t;
+  return (
+    <footer className="rc-status-bar" aria-live="polite">
+      <span>
+        <span className="rc-status-dot" data-status={status} />
+        SSE:{STATUS_TEXT[status]}
+        {status === "reconnecting" && message ? `（${message.slice(0, 80)}）` : ""}
+      </span>
+      <span>run:{runId ? runId.slice(0, 18) : "—"}</span>
+      <span>事件 seq:{lastSeq}</span>
+    </footer>
+  );
+}
@@ -0,0 +1,73 @@
+"use client";
+
+import { AlertTriangle, Check, Loader2, X } from "lucide-react";
+
+import type { CollaborationCommand } from "@/report-collaboration/api/types";
+
+const INTENT_LABELS: Record<string, string> = {
+  answer_question: "只读问答",
+  update_requirements: "更新需求",
+  add_angle: "新增分析角度",
+  research_again: "重新检索",
+  reanalyze: "重新分析",
+  rerun_node: "重跑节点",
+  rewrite_section: "重写章节",
+  polish_report: "全文润色",
+  ask_report: "报告问答",
+  replan: "重新规划",
+  cancel: "取消",
+};
+
+interface InterventionCardProps {
+  command: CollaborationCommand;
+  busy: boolean;
+  onConfirm: (commandId: string) => void;
+  onCancel: (commandId: string) => void;
+}
+
+/**
+ * 命令确认卡：高成本 / 低置信度命令需要用户显式确认。
+ * 确认/取消都只是提交命令，不改变节点完成状态（状态只由后端状态机驱动）。
+ */
+export function InterventionCard({ command, busy, onConfirm, onCancel }: InterventionCardProps) {
+  return (
+    <div className="rc-intervention-card">
+      <div className="flex items-start gap-2">
+        <AlertTriangle className="mt-0.5 size-4 shrink-0" style={{ color: "var(--rc-waiting)" }} aria-hidden />
+        <div className="min-w-0">
+          <div className="text-[13px] font-semibold">需要确认：{INTENT_LABELS[command.intent ?? ""] ?? "修改操作"}</div>
+          <p className="mt-0.5 text-[12px] leading-5 text-[var(--rc-text-secondary)]">
+            「{command.text}」
+          </p>
+        </div>
+      </div>
+      <ul className="list-disc pl-8 text-[11px] leading-4 text-[var(--rc-text-secondary)]">
+        <li>
+          影响范围：
+          {command.impact_nodes && command.impact_nodes.length > 0
+            ? command.impact_nodes.join("、") + " 及其下游"
+            : "由协调者判定"}
+        </li>
+        <li>
+          成本：{command.cost_level === "high" ? "高（触发重新检索/重写）" : command.cost_level === "low" ? "低" : "中"}
+        </li>
+        {command.reason ? <li>理由：{command.reason}</li> : null}
+      </ul>
+      <div className="flex justify-end gap-2">
+        <button type="button" className="rc-btn" disabled={busy} onClick={() => onCancel(command.command_id)}>
+          <X className="size-3.5" aria-hidden />
+          取消
+        </button>
+        <button
+          type="button"
+          className="rc-btn rc-btn-primary"
+          disabled={busy}
+          onClick={() => onConfirm(command.command_id)}
+        >
+          {busy ? <Loader2 className="rc-spin size-3.5" /> : <Check className="size-3.5" aria-hidden />}
+          确认执行
+        </button>
+      </div>
+    </div>
+  );
+}
@@ -0,0 +1,280 @@
+"use client";
+
+import { useEffect, useMemo, useState, type ReactNode } from "react";
+import { Ban, ChevronDown, Target, X } from "lucide-react";
+
+import { getReportCollaborationDriver } from "@/report-collaboration/api/driver";
+import type { NodeContractDetail } from "@/report-collaboration/api/types";
+import { roleIcon, type ReportFlowNodeKind } from "@/report-collaboration/components/ReportFlowNode";
+
+export interface NodeInspectorFallback {
+  label: string;
+  status: string;
+  role?: string | null;
+  angle?: string | null;
+  kind?: ReportFlowNodeKind;
+  mission?: string | null;
+  input_artifact_types?: string[];
+  output_artifact_type?: string | null;
+  allowed_tools?: string[];
+  acceptance_criteria?: string[];
+  upstream?: string[];
+  downstream?: string[];
+}
+
+interface NodeInspectorDrawerProps {
+  open: boolean;
+  nodeId: string | null;
+  runId: string | null;
+  /** 节点基础信息（画布侧已有，预览方案时也能填抽屉，不发起结果请求）。 */
+  fallback?: NodeInspectorFallback | null;
+  onClose: () => void;
+  /** 「在对话中对此节点提出意见」：关闭抽屉 + 聚焦 Composer + 绑定目标。 */
+  onComment: (nodeId: string, nodeName: string) => void;
+}
+
+const SECTION_KEYS = ["mission", "input", "output", "tools", "graph"] as const;
+type SectionKey = (typeof SECTION_KEYS)[number];
+
+/**
+ * 只读节点说明抽屉：覆盖在画布右侧，不占第三栏。
+ * 只读取节点合同（职责/输入/产出/工具/验收），不请求节点执行结果；
+ * 执行过程统一在左侧 MessageList 查看。
+ */
+export function NodeInspectorDrawer({
+  open,
+  nodeId,
+  runId,
+  fallback,
+  onClose,
+  onComment,
+}: NodeInspectorDrawerProps) {
+  const [contract, setContract] = useState<NodeContractDetail | null>(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const [openSections, setOpenSections] = useState<Record<SectionKey, boolean>>({
+    mission: true,
+    input: true,
+    output: true,
+    tools: true,
+    graph: true,
+  });
+
+  useEffect(() => {
+    if (!open || !nodeId || !runId) {
+      setContract(null);
+      setError(null);
+      return;
+    }
+    let cancelled = false;
+    setLoading(true);
+    setError(null);
+    getReportCollaborationDriver()
+      .getNodeContract(runId, nodeId)
+      .then((detail) => {
+        if (!cancelled) setContract(detail);
+      })
+      .catch((err: unknown) => {
+        if (!cancelled) setError(err instanceof Error ? err.message : String(err));
+      })
+      .finally(() => {
+        if (!cancelled) setLoading(false);
+      });
+    return () => {
+      cancelled = true;
+    };
+  }, [open, nodeId, runId]);
+
+  const view = useMemo(() => {
+    return {
+      label: contract?.label ?? fallback?.label ?? nodeId ?? "",
+      status: contract?.status ?? fallback?.status ?? "planned",
+      role: contract?.role ?? fallback?.role ?? null,
+      angle: contract?.angle ?? fallback?.angle ?? null,
+      kind: fallback?.kind ?? "agent",
+      mission: contract?.mission ?? fallback?.mission ?? null,
+      input_artifact_types: contract?.input_artifact_types ?? fallback?.input_artifact_types ?? [],
+      output_artifact_type: contract?.output_artifact_type ?? fallback?.output_artifact_type ?? null,
+      allowed_tools: contract?.allowed_tools ?? fallback?.allowed_tools ?? [],
+      acceptance_criteria: contract?.acceptance_criteria ?? fallback?.acceptance_criteria ?? [],
+      upstream: contract?.upstream ?? fallback?.upstream ?? [],
+      downstream: contract?.downstream ?? fallback?.downstream ?? [],
+      forbidden: contract?.forbidden ?? [],
+      max_attempts: contract?.max_attempts ?? null,
+      time_budget_seconds: contract?.time_budget_seconds ?? null,
+      token_budget: contract?.token_budget ?? null,
+      source_policy: contract?.source_policy ?? null,
+    };
+  }, [contract, fallback, nodeId]);
+
+  if (!open || !nodeId) return null;
+
+  const hasBody = Boolean(contract) || Boolean(fallback?.mission) || Boolean(fallback?.label);
+  const showLoading = loading && !hasBody;
+
+  const toggle = (key: SectionKey) => {
+    setOpenSections((current) => ({ ...current, [key]: !current[key] }));
+  };
+
+  return (
+    <aside className="rc-drawer" role="dialog" aria-label={`节点说明：${view.label}`}>
+      <header className="rc-drawer-header">
+        <span className="rc-flow-node-icon" aria-hidden>
+          {roleIcon(view.role, view.kind)}
+        </span>
+        <div className="min-w-0 flex-1">
+          <div className="rc-drawer-title">{view.label}</div>
+          <div className="rc-drawer-subtitle">
+            {view.role ? <span>{view.role}</span> : null}
+            {view.angle ? <span>· {view.angle}</span> : null}
+            <span>· {statusText(view.status)}</span>
+          </div>
+        </div>
+        <button type="button" className="rc-drawer-icon-btn" onClick={onClose} aria-label="关闭节点说明">
+          <X className="size-4" />
+        </button>
+      </header>
+
+      <div className="rc-drawer-body">
+        {showLoading ? (
+          <div className="rc-empty py-10 text-[12px]">正在读取节点合同…</div>
+        ) : error && !hasBody ? (
+          <div className="rc-empty py-10 text-[12px]" style={{ color: "var(--rc-danger)" }}>
+            读取节点合同失败：{error}
+          </div>
+        ) : (
+          <>
+            <DrawerSection title="节点职责" open={openSections.mission} onToggle={() => toggle("mission")}>
+              <p className="rc-drawer-text">{view.mission || "暂无职责说明"}</p>
+            </DrawerSection>
+            <DrawerSection title="输入" open={openSections.input} onToggle={() => toggle("input")}>
+              <ul className="rc-drawer-list">
+                {view.input_artifact_types.length > 0 ? (
+                  view.input_artifact_types.map((type) => (
+                    <li key={type}>
+                      <span className="rc-flow-pill rc-flow-pill-input">{shortArtifact(type)}</span>
+                    </li>
+                  ))
+                ) : (
+                  <li className="text-[var(--rc-text-secondary)]">无上游成果要求</li>
+                )}
+                {view.upstream.length > 0 ? <li>上游节点：{view.upstream.join("、")}</li> : null}
+                {view.source_policy ? <li>资料策略：{view.source_policy}</li> : null}
+              </ul>
+            </DrawerSection>
+            <DrawerSection title="输出" open={openSections.output} onToggle={() => toggle("output")}>
+              <ul className="rc-drawer-list">
+                <li>
+                  成果类型：
+                  {view.output_artifact_type ? (
+                    <span className="rc-flow-pill rc-flow-pill-output">{shortArtifact(view.output_artifact_type)}</span>
+                  ) : (
+                    "未指定"
+                  )}
+                </li>
+                {view.acceptance_criteria.map((criterion) => (
+                  <li key={criterion}>验收：{criterion}</li>
+                ))}
+              </ul>
+            </DrawerSection>
+            <DrawerSection title="技能" open={openSections.tools} onToggle={() => toggle("tools")}>
+              <div className="flex flex-wrap gap-1">
+                {view.allowed_tools.length > 0 ? (
+                  view.allowed_tools.map((tool) => (
+                    <span key={tool} className="rc-flow-pill rc-flow-pill-neutral">
+                      {tool}
+                    </span>
+                  ))
+                ) : (
+                  <span className="text-[12px] text-[var(--rc-text-secondary)]">未配置技能</span>
+                )}
+              </div>
+              {view.forbidden.length > 0 ? (
+                <ul className="rc-drawer-list mt-2">
+                  {view.forbidden.map((rule) => (
+                    <li key={rule}>
+                      <Ban className="mr-1 inline size-3" aria-hidden />
+                      {rule}
+                    </li>
+                  ))}
+                </ul>
+              ) : null}
+              {view.max_attempts != null ? (
+                <p className="mt-2 text-[12px] text-[var(--rc-text-secondary)]">
+                  预算：至多 {view.max_attempts} 次尝试
+                  {view.time_budget_seconds ? ` · ${view.time_budget_seconds}s` : ""}
+                  {view.token_budget ? ` · ${view.token_budget} tokens` : ""}
+                </p>
+              ) : null}
+            </DrawerSection>
+            <DrawerSection title="上下游" open={openSections.graph} onToggle={() => toggle("graph")}>
+              <p className="rc-drawer-text">
+                {view.downstream.length > 0 ? `下游：${view.downstream.join("、")}` : "终端节点（无下游）"}
+              </p>
+            </DrawerSection>
+          </>
+        )}
+      </div>
+
+      <footer className="rc-drawer-footer">
+        <button
+          type="button"
+          className="rc-btn rc-btn-primary w-full justify-center"
+          onClick={() => onComment(nodeId, view.label)}
+        >
+          <Target className="size-3.5" aria-hidden />
+          在对话中对此节点提出意见
+        </button>
+        <p className="mt-2 text-[11px] leading-4 text-[var(--rc-text-secondary)]">
+          重跑、补充或纠偏通过对话完成（例如「重新检索」「重新分析」）；抽屉不直接发起变更。
+        </p>
+      </footer>
+    </aside>
+  );
+}
+
+function DrawerSection({
+  title,
+  open,
+  onToggle,
+  children,
+}: {
+  title: string;
+  open: boolean;
+  onToggle: () => void;
+  children: ReactNode;
+}) {
+  return (
+    <section className="rc-drawer-section" data-open={open}>
+      <button type="button" className="rc-drawer-section-toggle" onClick={onToggle} aria-expanded={open}>
+        <ChevronDown className="rc-drawer-chevron" aria-hidden />
+        <span>{title}</span>
+      </button>
+      {open ? <div className="rc-drawer-section-body">{children}</div> : null}
+    </section>
+  );
+}
+
+function shortArtifact(value: string): string {
+  const trimmed = value.trim();
+  if (!trimmed) return value;
+  return trimmed.includes(":") ? trimmed.slice(trimmed.lastIndexOf(":") + 1) : trimmed;
+}
+
+function statusText(status: string): string {
+  const map: Record<string, string> = {
+    planned: "规划中",
+    queued: "排队中",
+    running: "运行中",
+    validating: "校验中",
+    completed: "已完成",
+    failed: "失败",
+    awaiting_input: "等待用户",
+    cancel_requested: "取消中",
+    cancelled: "已取消",
+    superseded: "已被替代",
+    reopened: "已重开",
+    interrupted: "已中断",
+  };
+  return map[status] ?? status;
+}
@@ -0,0 +1,77 @@
+"use client";
+
+import { ArrowLeft, FileText, MessageSquarePlus, Square } from "lucide-react";
+
+import type { PagePhase } from "@/report-collaboration/state/selectors";
+
+const PHASE_BADGES: Record<PagePhase, { label: string; color: string; bg: string }> = {
+  empty: { label: "新会话", color: "var(--rc-text-secondary)", bg: "transparent" },
+  clarifying: { label: "澄清需求", color: "var(--rc-waiting)", bg: "rgba(217, 119, 6, 0.1)" },
+  planning: { label: "生成方案", color: "var(--rc-running)", bg: "rgba(37, 99, 235, 0.1)" },
+  proposal_ready: { label: "待确认方案", color: "var(--rc-accent)", bg: "rgb(var(--rc-accent-rgb) / 10%)" },
+  running: { label: "协作中", color: "var(--rc-running)", bg: "rgba(37, 99, 235, 0.1)" },
+  awaiting_input: { label: "等待输入", color: "var(--rc-waiting)", bg: "rgba(217, 119, 6, 0.1)" },
+  reviewing: { label: "审稿中", color: "var(--rc-running)", bg: "rgba(37, 99, 235, 0.1)" },
+  completed: { label: "已完成", color: "var(--rc-success)", bg: "rgba(22, 163, 74, 0.1)" },
+  failed: { label: "失败", color: "var(--rc-danger)", bg: "rgba(220, 38, 38, 0.1)" },
+  cancelled: { label: "已取消", color: "var(--rc-text-secondary)", bg: "transparent" },
+};
+
+interface ReportCollaborationHeaderProps {
+  title: string;
+  phase: PagePhase;
+  onBack: () => void;
+  onNewSession: () => void;
+  onOpenReport: () => void;
+  hasReport: boolean;
+  running: boolean;
+  onCancelRun: () => void;
+  extra?: React.ReactNode;
+}
+
+/** 顶栏：返回 / 标题+状态 / 报告 / 停止 / 新建（右侧由布局注入窄屏切换等）。 */
+export function ReportCollaborationHeader({
+  title,
+  phase,
+  onBack,
+  onNewSession,
+  onOpenReport,
+  hasReport,
+  running,
+  onCancelRun,
+  extra,
+}: ReportCollaborationHeaderProps) {
+  const badge = PHASE_BADGES[phase] ?? PHASE_BADGES.empty;
+  return (
+    <header className="rc-header">
+      <div className="flex min-w-0 items-center gap-2">
+        <button type="button" className="rc-btn !min-h-8 !px-2" onClick={onBack} aria-label="返回工作台">
+          <ArrowLeft className="size-4" />
+        </button>
+        <span className="rc-header-title" title={title}>
+          报告协作 / {title}
+        </span>
+        <span className="rc-chip" style={{ background: badge.bg, color: badge.color }}>
+          {badge.label}
+        </span>
+      </div>
+      <div className="flex shrink-0 items-center gap-2">
+        {extra}
+        <button type="button" className="rc-btn" onClick={onOpenReport} disabled={!hasReport}>
+          <FileText className="size-3.5" aria-hidden />
+          报告
+        </button>
+        {running ? (
+          <button type="button" className="rc-btn rc-btn-danger" onClick={onCancelRun}>
+            <Square className="size-3.5" aria-hidden />
+            停止
+          </button>
+        ) : null}
+        <button type="button" className="rc-btn" onClick={onNewSession}>
+          <MessageSquarePlus className="size-3.5" aria-hidden />
+          新建
+        </button>
+      </div>
+    </header>
+  );
+}
@@ -0,0 +1,166 @@
+"use client";
+
+import { useCallback, useRef } from "react";
+import { MessageSquare, Workflow } from "lucide-react";
+
+import {
+  CANVAS_MIN_WIDTH,
+  PANEL_MIN_WIDTH,
+  RESIZE_KEYBOARD_STEP,
+  type FocusMode,
+  type NarrowView,
+  type UseReportPanelLayoutResult,
+} from "@/report-collaboration/hooks/useReportPanelLayout";
+
+interface ReportCollaborationLayoutProps {
+  layout: UseReportPanelLayoutResult;
+  header: React.ReactNode;
+  conversation: React.ReactNode;
+  canvas: React.ReactNode;
+  statusBar: React.ReactNode;
+}
+
+/**
+ * 固定两栏骨架：左对话 / 右画布 + 可拖拽分隔条（pointer + 方向键 + Home/End）
+ * + 窄屏单面板切换 + 「专注」模式。节点抽屉与预览 Dialog 由画布侧覆盖渲染。
+ */
+export function ReportCollaborationLayout({
+  layout,
+  header,
+  conversation,
+  canvas,
+  statusBar,
+}: ReportCollaborationLayoutProps) {
+  const { conversationWidth, setConversationWidth, nudgeConversationWidth, isNarrow, narrowView, setNarrowView, focusMode, bodyRef } =
+    layout;
+
+  const dragStart = useRef<{ x: number; width: number } | null>(null);
+
+  const onPointerDown = useCallback(
+    (event: React.PointerEvent<HTMLDivElement>) => {
+      event.currentTarget.setPointerCapture(event.pointerId);
+      dragStart.current = { x: event.clientX, width: conversationWidth };
+    },
+    [conversationWidth],
+  );
+
+  const onPointerMove = useCallback(
+    (event: React.PointerEvent<HTMLDivElement>) => {
+      if (!dragStart.current || event.buttons !== 1) return;
+      setConversationWidth(dragStart.current.width + (event.clientX - dragStart.current.x));
+    },
+    [setConversationWidth],
+  );
+
+  const onPointerUp = useCallback((event: React.PointerEvent<HTMLDivElement>) => {
+    if (event.currentTarget.hasPointerCapture(event.pointerId)) {
+      event.currentTarget.releasePointerCapture(event.pointerId);
+    }
+    dragStart.current = null;
+  }, []);
+
+  const onKeyDown = useCallback(
+    (event: React.KeyboardEvent<HTMLDivElement>) => {
+      const max = Math.max(
+        PANEL_MIN_WIDTH,
+        Math.min(720, (bodyRef.current?.clientWidth ?? 720) - CANVAS_MIN_WIDTH),
+      );
+      if (event.key === "ArrowLeft") {
+        event.preventDefault();
+        nudgeConversationWidth(-RESIZE_KEYBOARD_STEP);
+      } else if (event.key === "ArrowRight") {
+        event.preventDefault();
+        nudgeConversationWidth(RESIZE_KEYBOARD_STEP);
+      } else if (event.key === "Home") {
+        event.preventDefault();
+        setConversationWidth(PANEL_MIN_WIDTH);
+      } else if (event.key === "End") {
+        event.preventDefault();
+        setConversationWidth(max);
+      }
+    },
+    [bodyRef, nudgeConversationWidth, setConversationWidth],
+  );
+
+  const showConversation = isNarrow ? narrowView === "conversation" : focusMode !== "canvas";
+  const showCanvas = isNarrow ? narrowView === "canvas" : focusMode !== "conversation";
+
+  return (
+    <div className="rc-root">
+      {header}
+      <div className="rc-body" ref={bodyRef}>
+        {showConversation ? (
+          <section
+            className="rc-conversation-panel"
+            style={{ width: isNarrow ? "100%" : conversationWidth, flexShrink: isNarrow ? 1 : 0 }}
+            aria-label="对话面板"
+          >
+            {conversation}
+          </section>
+        ) : null}
+        {!isNarrow && showConversation && showCanvas ? (
+          <div
+            role="separator"
+            aria-orientation="vertical"
+            aria-label="调整对话与画布宽度"
+            aria-valuenow={conversationWidth}
+            aria-valuemin={PANEL_MIN_WIDTH}
+            aria-valuemax={720}
+            tabIndex={0}
+            className="rc-resizer"
+            onPointerDown={onPointerDown}
+            onPointerMove={onPointerMove}
+            onPointerUp={onPointerUp}
+            onKeyDown={onKeyDown}
+          />
+        ) : null}
+        {showCanvas ? (
+          <section className="rc-canvas-panel" aria-label="协作流程画布">
+            {isNarrow ? (
+              <div className="absolute left-2 top-2 z-10">
+                <NarrowSwitch narrowView={narrowView} setNarrowView={setNarrowView} />
+              </div>
+            ) : null}
+            {canvas}
+          </section>
+        ) : null}
+      </div>
+      {statusBar}
+    </div>
+  );
+}
+
+export function NarrowSwitch({
+  narrowView,
+  setNarrowView,
+}: {
+  narrowView: NarrowView;
+  setNarrowView: (view: NarrowView) => void;
+}) {
+  return (
+    <div className="rc-narrow-switch" role="tablist" aria-label="视图切换">
+      <button
+        type="button"
+        role="tab"
+        aria-selected={narrowView === "conversation"}
+        data-active={narrowView === "conversation"}
+        onClick={() => setNarrowView("conversation")}
+      >
+        <MessageSquare className="mr-1 inline size-3" aria-hidden />
+        对话
+      </button>
+      <button
+        type="button"
+        role="tab"
+        aria-selected={narrowView === "canvas"}
+        data-active={narrowView === "canvas"}
+        onClick={() => setNarrowView("canvas")}
+      >
+        <Workflow className="mr-1 inline size-3" aria-hidden />
+        流程
+      </button>
+    </div>
+  );
+}
+
+export type { FocusMode };
@@ -0,0 +1,154 @@
+"use client";
+
+import { useEffect, useRef, useState } from "react";
+import { CornerDownLeft, Loader2, Send, Target, X } from "lucide-react";
+
+import type { PagePhase } from "@/report-collaboration/state/selectors";
+
+export interface ComposerTarget {
+  nodeId: string;
+  nodeName: string;
+  agentRunId?: string | null;
+}
+
+interface ReportComposerProps {
+  phase: PagePhase;
+  busy: boolean;
+  disabled?: boolean;
+  target: ComposerTarget | null;
+  onClearTarget: () => void;
+  onSend: (text: string) => void;
+  /** 递增以请求聚焦（节点抽屉「在对话中提出意见」）。 */
+  focusSignal: number;
+}
+
+const PHASE_HINTS: Record<PagePhase, { placeholder: string; hint: string; tone?: "warning" | "danger" }> = {
+  empty: {
+    placeholder: "描述你的报告需求，例如：撰写一份新能源汽车主要品牌市场趋势分析报告…",
+    hint: "输入需求后回车发送",
+  },
+  clarifying: {
+    placeholder: "回答澄清问题，或补充你的要求…",
+    hint: "优先回答上方的澄清问题",
+    tone: "warning",
+  },
+  planning: {
+    placeholder: "补充要求（将在规划安全点生效）…",
+    hint: "正在生成候选方案，补充要求会在安全点应用",
+  },
+  proposal_ready: {
+    placeholder: "可以先预览方案；确认后点「开始协作」…",
+    hint: "点击方案卡可在右侧预览对应协作流程",
+  },
+  running: {
+    placeholder: "运行中可补充要求：增加角度 / 重新检索 / 重写章节…",
+    hint: "协调者正在跟踪运行，你的输入会被分类并在安全点生效",
+  },
+  awaiting_input: {
+    placeholder: "回答等待中的问题…",
+    hint: "有节点正在等待你的输入，优先处理等待卡",
+    tone: "warning",
+  },
+  reviewing: {
+    placeholder: "审稿进行中，可补充要求…",
+    hint: "审稿意见会出现在时间线中",
+  },
+  completed: {
+    placeholder: "报告已完成：继续问答、重写章节、全文润色…",
+    hint: "修改会生成新版本，不直接覆盖正式报告",
+  },
+  failed: {
+    placeholder: "通过对话重试，或取消后从已有成果继续…",
+    hint: "运行失败，可在对话中要求重试",
+    tone: "danger",
+  },
+  cancelled: {
+    placeholder: "可从已有成果继续，或生成新方案…",
+    hint: "运行已取消，已完成的成果仍然可用",
+  },
+};
+
+/** 统一输入框：按页面状态提示；Enter 发送 / Shift+Enter 换行。 */
+export function ReportComposer({
+  phase,
+  busy,
+  disabled = false,
+  target,
+  onClearTarget,
+  onSend,
+  focusSignal,
+}: ReportComposerProps) {
+  const [value, setValue] = useState("");
+  const textareaRef = useRef<HTMLTextAreaElement | null>(null);
+  const hint = PHASE_HINTS[phase] ?? PHASE_HINTS.empty;
+
+  useEffect(() => {
+    if (focusSignal > 0) {
+      textareaRef.current?.focus();
+    }
+  }, [focusSignal]);
+
+  const submit = () => {
+    const trimmed = value.trim();
+    if (!trimmed || busy || disabled) return;
+    onSend(trimmed);
+    setValue("");
+  };
+
+  return (
+    <div className="rc-composer">
+      <div className="rc-composer-hint" data-tone={hint.tone} aria-live="polite">
+        {busy ? <Loader2 className="rc-spin size-3.5" aria-hidden /> : null}
+        <span>{busy ? "正在识别修改范围…" : hint.hint}</span>
+      </div>
+      {target ? (
+        <div className="mb-1 flex items-center gap-2 px-1">
+          <span className="rc-composer-target">
+            <Target className="size-3" aria-hidden />
+            对节点「{target.nodeName}」提出意见
+          </span>
+          <button
+            type="button"
+            className="text-[11px] text-[var(--rc-text-secondary)] hover:text-[var(--rc-danger)]"
+            onClick={onClearTarget}
+            aria-label="清除节点目标"
+          >
+            <X className="size-3.5" />
+          </button>
+        </div>
+      ) : null}
+      <div className="relative">
+        <textarea
+          ref={textareaRef}
+          className="min-h-24 w-full resize-none rounded-lg border border-[var(--rc-border)] bg-[var(--rc-bg-panel)] px-3 py-2.5 pr-14 text-[13px] leading-6 outline-none transition-colors focus:border-[var(--rc-accent)] disabled:opacity-60"
+          rows={4}
+          value={value}
+          disabled={disabled}
+          placeholder={hint.placeholder}
+          aria-label="报告协作输入框"
+          onChange={(event) => setValue(event.target.value)}
+          onKeyDown={(event) => {
+            if (event.key === "Enter" && !event.shiftKey && !event.nativeEvent.isComposing) {
+              event.preventDefault();
+              submit();
+            }
+          }}
+        />
+        <button
+          type="button"
+          className="absolute bottom-2.5 right-2.5 inline-flex size-9 items-center justify-center rounded-lg text-white shadow disabled:opacity-50"
+          style={{ background: "var(--rc-accent)" }}
+          disabled={!value.trim() || busy || disabled}
+          onClick={submit}
+          aria-label="发送"
+        >
+          {busy ? <Loader2 className="rc-spin size-4" /> : <Send className="size-4" />}
+        </button>
+      </div>
+      <div className="mt-1 flex items-center justify-end gap-1 pr-1 text-[10px] text-[var(--rc-text-secondary)]">
+        <CornerDownLeft className="size-3" aria-hidden />
+        <span>Enter 发送 · Shift+Enter 换行</span>
+      </div>
+    </div>
+  );
+}
@@ -0,0 +1,82 @@
+"use client";
+
+import { useMemo } from "react";
+import { MessagesSquare } from "lucide-react";
+import type { Message } from "@langchain/langgraph-sdk";
+
+import { MessageList } from "@/components/workspace/messages/message-list";
+import { ThreadContext } from "@/components/workspace/messages/context";
+import { SubtasksProvider } from "@/core/tasks/context";
+import type { AgentThreadState } from "@/core/threads";
+import type { BaseStream } from "@langchain/langgraph-sdk/react";
+
+interface ReportConversationPanelProps {
+  sessionId: string;
+  thread: BaseStream<AgentThreadState>;
+  businessCardSlot: (message: Message) => React.ReactNode;
+  /** 会商第二步式说话人壳；不传则只渲染原生 MessageList。 */
+  speakerShell?: (messages: Message[], children: React.ReactNode) => React.ReactNode;
+  stageSelector?: React.ReactNode;
+  composer: React.ReactNode;
+  loading: boolean;
+  emptyHint?: React.ReactNode;
+  /** 并行切换成员时重挂消息列表，避免沿用上一成员的滚动位置。 */
+  listKey?: string;
+}
+
+/**
+ * 左侧对话面板：外层结构参考 Coze，内部严格复用 DeerFlow `MessageList`
+ * （原生 assistant / tool_calls / tool 消息、引用与协助卡渲染）。
+ */
+export function ReportConversationPanel({
+  sessionId,
+  thread,
+  businessCardSlot,
+  speakerShell,
+  stageSelector,
+  composer,
+  loading,
+  emptyHint,
+  listKey,
+}: ReportConversationPanelProps) {
+  const hasMessages = thread.messages.length > 0;
+
+  const content = useMemo(() => {
+    if (loading && !hasMessages) {
+      return (
+        <div className="rc-empty" aria-busy="true">
+          <MessagesSquare className="size-8 opacity-30" aria-hidden />
+          <p>正在恢复会话…</p>
+        </div>
+      );
+    }
+    if (!hasMessages) {
+      return <div className="rc-empty">{emptyHint ?? "输入报告需求开始协作"}</div>;
+    }
+    return (
+      <ThreadContext.Provider value={{ thread, isMock: true }}>
+        <MessageList
+          key={listKey ?? sessionId}
+          className="min-h-0 flex-1"
+          threadId={sessionId}
+          thread={thread}
+          paddingBottom={24}
+          scrollButtonClassName="bottom-2"
+          contentClassName={speakerShell ? "gap-6 pt-6" : undefined}
+          businessCardSlot={businessCardSlot}
+          speakerShell={speakerShell}
+        />
+      </ThreadContext.Provider>
+    );
+  }, [businessCardSlot, emptyHint, hasMessages, listKey, loading, sessionId, speakerShell, thread]);
+
+  return (
+    <SubtasksProvider>
+      <div className="flex min-h-0 flex-1 flex-col">
+        {stageSelector}
+        {content}
+        {composer}
+      </div>
+    </SubtasksProvider>
+  );
+}
@@ -0,0 +1,229 @@
+"use client";
+
+import { useEffect, useMemo, useRef, useState } from "react";
+import {
+  Controls,
+  MiniMap,
+  Position,
+  ReactFlow,
+  ReactFlowProvider,
+  type DefaultEdgeOptions,
+  type Edge,
+  type Node,
+  type NodeTypes,
+  useReactFlow,
+} from "@xyflow/react";
+import "@xyflow/react/dist/style.css";
+import { Workflow } from "lucide-react";
+
+import type {
+  CollaborationNodeState,
+  ReportPlanCandidate,
+} from "@/report-collaboration/api/types";
+import {
+  CollaborationFlowNode,
+  type ReportFlowNodeDatum,
+  type ReportFlowNodeKind,
+} from "@/report-collaboration/components/ReportFlowNode";
+
+const NODE_TYPES: NodeTypes = { collaboration: CollaborationFlowNode };
+/** 左到右 rank 间距（节点左缘到下一列左缘），对齐 Coze 整理布局的横向留白。 */
+const COLUMN_GAP = 360;
+/** 并行节点高度估算（去掉输入/输出后的卡片高度），用于重心对齐。 */
+const NODE_HEIGHT = 128;
+/** 同层并行节点之间的垂直间隙，对齐 Coze Dagre nodesep 观感。 */
+const NODE_GAP = 52;
+
+const DEFAULT_EDGE_OPTIONS: DefaultEdgeOptions = {
+  type: "default",
+  style: { stroke: "var(--rc-flow-edge)", strokeWidth: 2 },
+};
+
+interface ReportFlowCanvasProps {
+  plan: ReportPlanCandidate | null;
+  nodeStates: Record<string, CollaborationNodeState>;
+  selectedNodeId: string | null;
+  onSelectNode: (nodeId: string | null) => void;
+  /** 空态文案（无方案时）。 */
+  emptyHint?: string;
+}
+
+/** 分层 + 重心对齐：同层并行节点绕父节点垂直中心对称，对齐 Coze「整理节点」Dagre LR。 */
+function layoutPlan(plan: ReportPlanCandidate): Map<string, { x: number; y: number }> {
+  const depthById = new Map<string, number>();
+  const nodeById = new Map(plan.nodes.map((node) => [node.id, node]));
+  const nodeIds = new Set(nodeById.keys());
+  const visit = (nodeId: string, seen: Set<string>): number => {
+    if (depthById.has(nodeId)) return depthById.get(nodeId)!;
+    if (seen.has(nodeId)) return 0;
+    seen.add(nodeId);
+    const node = nodeById.get(nodeId);
+    const depth =
+      node && node.depends_on.length > 0
+        ? Math.max(...node.depends_on.filter((dep) => nodeIds.has(dep)).map((dep) => visit(dep, seen))) + 1
+        : 0;
+    depthById.set(nodeId, depth);
+    return depth;
+  };
+  for (const node of plan.nodes) visit(node.id, new Set());
+
+  const layers = new Map<number, string[]>();
+  for (const node of plan.nodes) {
+    const depth = depthById.get(node.id) ?? 0;
+    layers.set(depth, [...(layers.get(depth) ?? []), node.id]);
+  }
+
+  const yById = new Map<string, number>();
+  const spacing = NODE_HEIGHT + NODE_GAP;
+  const depths = [...layers.keys()].sort((a, b) => a - b);
+  for (const depth of depths) {
+    const ids = layers.get(depth) ?? [];
+    const desired = ids.map((id) => {
+      const node = nodeById.get(id);
+      const parents = (node?.depends_on ?? []).filter((dep) => yById.has(dep));
+      if (parents.length === 0) return 0;
+      return parents.reduce((sum, parentId) => sum + (yById.get(parentId) ?? 0), 0) / parents.length;
+    });
+    const packed = ids.map((_, index) => index * spacing);
+    const packedMean = packed.reduce((sum, value) => sum + value, 0) / Math.max(packed.length, 1);
+    const desiredMean = desired.reduce((sum, value) => sum + value, 0) / Math.max(desired.length, 1);
+    const shift = desiredMean - packedMean;
+    ids.forEach((id, index) => {
+      yById.set(id, packed[index] + shift);
+    });
+  }
+
+  const positions = new Map<string, { x: number; y: number }>();
+  for (const node of plan.nodes) {
+    const depth = depthById.get(node.id) ?? 0;
+    positions.set(node.id, { x: depth * COLUMN_GAP, y: yById.get(node.id) ?? 0 });
+  }
+  return positions;
+}
+
+function CanvasInner({ plan, nodeStates, selectedNodeId, onSelectNode, emptyHint }: ReportFlowCanvasProps) {
+  const rf = useReactFlow();
+  const autoPositions = useMemo(() => (plan ? layoutPlan(plan) : new Map<string, { x: number; y: number }>()), [plan]);
+  // 拖动位置是纯浏览器展示状态：per-plan 保存，方案切换即清理。
+  const draggedRef = useRef<Map<string, { x: number; y: number }>>(new Map());
+  const [draggedVersion, setDraggedVersion] = useState(0);
+  const planKey = plan?.id ?? "none";
+
+  useEffect(() => {
+    draggedRef.current = new Map();
+    setDraggedVersion((v) => v + 1);
+  }, [planKey]);
+
+  useEffect(() => {
+    // 方案切换后适配视图（下一帧节点已挂载）。
+    const timer = window.setTimeout(() => rf.fitView({ padding: 0.18, duration: 240 }), 60);
+    return () => window.clearTimeout(timer);
+  }, [planKey, rf]);
+
+  const nodes: Node[] = useMemo(() => {
+    if (!plan) return [];
+    void draggedVersion;
+    const outgoing = new Set(plan.edges.map((edge) => edge.source));
+    return plan.nodes.map((node) => {
+      const state = nodeStates[node.id];
+      const kind: ReportFlowNodeKind =
+        node.depends_on.length === 0 ? "start" : outgoing.has(node.id) ? "agent" : "end";
+      const datum: ReportFlowNodeDatum = {
+        nodeId: node.id,
+        label: node.label,
+        roleName: state?.role_display_name ?? node.role_display_name ?? null,
+        angle: state?.angle ?? node.angle ?? null,
+        status: state?.status ?? "planned",
+        attempt: state?.attempt ?? 0,
+        selected: selectedNodeId === node.id,
+        kind,
+        tools: node.allowed_tools ?? [],
+      };
+      const dragged = draggedRef.current.get(node.id);
+      const position = dragged ?? autoPositions.get(node.id) ?? { x: 0, y: 0 };
+      return {
+        id: node.id,
+        type: "collaboration",
+        position,
+        data: datum,
+        draggable: true,
+        sourcePosition: Position.Right,
+        targetPosition: Position.Left,
+      };
+    });
+  }, [plan, nodeStates, selectedNodeId, autoPositions, draggedVersion]);
+
+  const edges: Edge[] = useMemo(() => {
+    if (!plan) return [];
+    return plan.edges.map((edge, index) => {
+      const targetState = nodeStates[edge.target];
+      const active = targetState?.status === "running" || targetState?.status === "validating";
+      return {
+        id: `${edge.source}->${edge.target}-${index}`,
+        source: edge.source,
+        target: edge.target,
+        label: edge.label ?? undefined,
+        type: "default",
+        animated: false,
+        className: active ? "rc-edge-active" : "rc-edge",
+        style: {
+          stroke: active ? "var(--rc-running)" : "var(--rc-flow-edge)",
+          strokeWidth: 2,
+        },
+      };
+    });
+  }, [plan, nodeStates]);
+
+  if (!plan) {
+    return (
+      <div className="rc-empty">
+        <Workflow className="size-10 opacity-30" aria-hidden />
+        <p>{emptyHint ?? "确认候选方案后，这里会展示协作流程图"}</p>
+      </div>
+    );
+  }
+
+  return (
+    <ReactFlow
+      className="rc-flow"
+      nodes={nodes}
+      edges={edges}
+      nodeTypes={NODE_TYPES}
+      defaultEdgeOptions={DEFAULT_EDGE_OPTIONS}
+      onNodeClick={(_, node) => onSelectNode(node.id)}
+      onPaneClick={() => onSelectNode(null)}
+      onNodeDragStop={(_, node) => {
+        draggedRef.current.set(node.id, { x: node.position.x, y: node.position.y });
+        setDraggedVersion((v) => v + 1);
+      }}
+      onNodeDoubleClick={(_, node) => onSelectNode(node.id)}
+      fitView
+      fitViewOptions={{ padding: 0.18 }}
+      minZoom={0.55}
+      maxZoom={1.75}
+      nodesConnectable={false}
+      elementsSelectable
+      proOptions={{ hideAttribution: true }}
+      aria-label="协作流程画布"
+    >
+      <Controls position="bottom-left" orientation="horizontal" showInteractive={false} />
+      <MiniMap
+        position="bottom-right"
+        pannable
+        zoomable
+        className="rc-flow-minimap"
+        nodeColor={() => "var(--rc-flow-edge)"}
+        maskColor="var(--rc-flow-minimap-mask)"
+      />
+    </ReactFlow>
+  );
+}
+
+/** 协作流程画布：只读展示 + 本地拖动；重跑/纠偏一律通过左侧对话完成。 */
+export function ReportFlowCanvas(props: ReportFlowCanvasProps) {
+  return (
+    <ReactFlowProvider>
+      <CanvasInner {...props} />
+    </ReactFlowProvider>
+  );
+}
@@ -0,0 +1,150 @@
+"use client";
+
+import { memo, type ReactNode } from "react";
+import { Handle, Position, type NodeProps } from "@xyflow/react";
+import {
+  AlertTriangle,
+  Bot,
+  Check,
+  CircleArrowRight,
+  CircleDashed,
+  FileCheck,
+  Flag,
+  LineChart,
+  Loader2,
+  PenLine,
+  RefreshCw,
+  Search,
+  ShieldCheck,
+  ShieldQuestion,
+  Users,
+  X,
+} from "lucide-react";
+
+import type { CollaborationNodeStatus } from "@/report-collaboration/api/types";
+
+export type ReportFlowNodeKind = "start" | "end" | "agent";
+
+/** 画布自定义节点数据（由 ReportFlowCanvas 组装）。 */
+export interface ReportFlowNodeDatum {
+  nodeId: string;
+  label: string;
+  roleName?: string | null;
+  angle?: string | null;
+  status: CollaborationNodeStatus;
+  attempt: number;
+  selected: boolean;
+  kind: ReportFlowNodeKind;
+  tools: string[];
+  /** xyflow Node.data 需要 Record 兼容的索引签名。 */
+  [key: string]: unknown;
+}
+
+export type ReportFlowNodeType = "collaboration";
+
+const STATUS_META: Record<
+  CollaborationNodeStatus,
+  { text: string; color: string; icon: ReactNode }
+> = {
+  planned: { text: "规划中", color: "var(--rc-text-secondary)", icon: <CircleDashed className="size-3.5" /> },
+  queued: { text: "排队中", color: "var(--rc-text-secondary)", icon: <CircleDashed className="size-3.5" /> },
+  running: { text: "运行中", color: "var(--rc-running)", icon: <Loader2 className="rc-spin size-3.5" /> },
+  validating: { text: "校验中", color: "var(--rc-running)", icon: <ShieldQuestion className="size-3.5" /> },
+  completed: { text: "已完成", color: "var(--rc-success)", icon: <Check className="size-3.5" /> },
+  failed: { text: "失败", color: "var(--rc-danger)", icon: <X className="size-3.5" /> },
+  awaiting_input: { text: "等待用户", color: "var(--rc-waiting)", icon: <AlertTriangle className="size-3.5" /> },
+  cancel_requested: { text: "取消中", color: "var(--rc-waiting)", icon: <X className="size-3.5" /> },
+  cancelled: { text: "已取消", color: "var(--rc-text-secondary)", icon: <X className="size-3.5" /> },
+  superseded: { text: "已被替代", color: "var(--rc-text-secondary)", icon: <RefreshCw className="size-3.5" /> },
+  reopened: { text: "已重开", color: "var(--rc-waiting)", icon: <RefreshCw className="size-3.5" /> },
+  interrupted: { text: "已中断", color: "var(--rc-waiting)", icon: <AlertTriangle className="size-3.5" /> },
+};
+
+export function roleIcon(roleName: string | null | undefined, kind: ReportFlowNodeKind = "agent"): ReactNode {
+  if (kind === "start") return <CircleArrowRight />;
+  if (kind === "end") return <Flag />;
+  switch (roleName) {
+    case "协调者":
+      return <Users />;
+    case "研究员":
+      return <Search />;
+    case "核验员":
+      return <ShieldCheck />;
+    case "分析员":
+      return <LineChart />;
+    case "撰写员":
+      return <PenLine />;
+    case "审稿员":
+      return <FileCheck />;
+    default:
+      return <Bot />;
+  }
+}
+
+function FlowPill({ children }: { children: ReactNode }) {
+  return <span className="rc-flow-pill rc-flow-pill-neutral">{children}</span>;
+}
+
+function FieldRow({ label, children }: { label: string; children: ReactNode }) {
+  return (
+    <>
+      <div className="rc-flow-node-field-label">{label}</div>
+      <div className="rc-flow-node-field-value">{children}</div>
+    </>
+  );
+}
+
+function CollaborationFlowNodeComponent({ data }: NodeProps) {
+  const node = data as unknown as ReportFlowNodeDatum;
+  const meta = STATUS_META[node.status] ?? STATUS_META.planned;
+  const statusText = node.attempt > 1 ? `${meta.text} · 第 ${node.attempt} 次` : meta.text;
+
+  return (
+    <div
+      className="rc-flow-node"
+      data-status={node.status}
+      data-selected={node.selected}
+      data-kind={node.kind}
+      data-role={node.roleName ?? ""}
+      tabIndex={0}
+      role="button"
+      aria-label={`节点 ${node.label}，${statusText}`}
+    >
+      <Handle type="target" position={Position.Left} className="rc-flow-handle" isConnectable={false} />
+      <div className="rc-flow-node-header">
+        <span className="rc-flow-node-icon" aria-hidden>
+          {roleIcon(node.roleName, node.kind)}
+        </span>
+        <span className="rc-flow-node-title">{node.label}</span>
+      </div>
+      <div className="rc-flow-node-body">
+        {node.roleName ? (
+          <FieldRow label="角色">
+            <FlowPill>{node.roleName}</FlowPill>
+          </FieldRow>
+        ) : null}
+        {node.angle ? (
+          <FieldRow label="角度">
+            <FlowPill>{node.angle}</FlowPill>
+          </FieldRow>
+        ) : null}
+        {node.tools.length > 0 ? (
+          <FieldRow label="技能">
+            {node.tools.map((tool) => (
+              <FlowPill key={`tool-${tool}`}>{tool}</FlowPill>
+            ))}
+          </FieldRow>
+        ) : null}
+        <FieldRow label="状态">
+          <span className="rc-flow-node-status" style={{ color: meta.color }}>
+            {meta.icon}
+            <span>{statusText}</span>
+          </span>
+        </FieldRow>
+      </div>
+      <Handle type="source" position={Position.Right} className="rc-flow-handle" isConnectable={false} />
+    </div>
+  );
+}
+
+export const CollaborationFlowNode = memo(CollaborationFlowNodeComponent);
@@ -0,0 +1,188 @@
+"use client";
+
+import { Clock, Gauge, Play, RefreshCw, ShieldCheck, Star, Users } from "lucide-react";
+
+import type { ReportPlanCandidate } from "@/report-collaboration/api/types";
+import { cn } from "@/lib/utils";
+
+interface ReportPlanCardsProps {
+  plans: ReportPlanCandidate[];
+  selectedPlanId: string | null;
+  previewPlanId: string | null;
+  onPreview: (planId: string) => void;
+  onSelect: (planId: string) => void;
+  onStart: (planId: string) => void;
+  onRegenerate: () => void;
+  selectBusy: boolean;
+  startBusy: boolean;
+  regenerateBusy: boolean;
+}
+
+const STRATEGY_LABELS: Record<string, string> = {
+  balanced_review: "均衡审阅",
+  parallel_depth: "深度并行",
+  focused_fast: "快速聚焦",
+};
+
+function costLabel(level: string | null | undefined): string {
+  if (level === "low") return "成本 低";
+  if (level === "high") return "成本 高";
+  return "成本 中";
+}
+
+function durationLabel(seconds: number): string {
+  if (seconds >= 3600) return `约 ${Math.round(seconds / 3600)} 小时`;
+  if (seconds >= 60) return `约 ${Math.round(seconds / 60)} 分钟`;
+  return `约 ${seconds} 秒`;
+}
+
+/**
+ * 候选方案卡组：点击卡片只切换右侧画布预览（纯展示状态），
+ * 「采用此方案」才写服务器 selectedPlanId，「开始协作」创建 run。
+ */
+export function ReportPlanCards({
+  plans,
+  selectedPlanId,
+  previewPlanId,
+  onPreview,
+  onSelect,
+  onStart,
+  onRegenerate,
+  selectBusy,
+  startBusy,
+  regenerateBusy,
+}: ReportPlanCardsProps) {
+  if (plans.length === 0) return null;
+  return (
+    <div className="flex w-full flex-col gap-2">
+      <div className="flex items-center justify-between px-1">
+        <span className="text-[13px] font-semibold">我整理了 {plans.length} 条候选协作方案</span>
+        <button
+          type="button"
+          className="rc-btn"
+          onClick={onRegenerate}
+          disabled={regenerateBusy}
+        >
+          <RefreshCw className={cn("size-3.5", regenerateBusy && "rc-spin")} aria-hidden />
+          重新生成
+        </button>
+      </div>
+      <p className="px-1 text-[12px] text-[var(--rc-text-secondary)]">
+        点击卡片在右侧预览协作流程；采用后才会按该方案执行。
+      </p>
+      {plans.map((plan, index) => {
+        const isSelected = plan.id === selectedPlanId;
+        const isPreviewed = plan.id === (previewPlanId ?? selectedPlanId ?? plans[0]?.id);
+        const invalid = plan.validation && plan.validation.ok === false;
+        return (
+          <article
+            key={plan.id}
+            className={cn(
+              "rc-plan-card",
+              isPreviewed && "rc-plan-card-selected",
+              invalid && "rc-plan-card-disabled",
+            )}
+            onClick={() => onPreview(plan.id)}
+            role="button"
+            tabIndex={0}
+            aria-pressed={isPreviewed}
+            onKeyDown={(event) => {
+              if (event.key === "Enter" || event.key === " ") {
+                event.preventDefault();
+                onPreview(plan.id);
+              }
+            }}
+          >
+            <div className="flex items-center gap-2">
+              <span className="rc-chip">
+                {plan.recommended || index === 0 ? (
+                  <>
+                    <Star className="size-3" aria-hidden /> 推荐
+                  </>
+                ) : (
+                  `方案 ${index + 1}`
+                )}
+              </span>
+              <span className="rc-chip" style={{ background: "var(--rc-bg-secondary)", color: "var(--rc-text-secondary)" }}>
+                {STRATEGY_LABELS[plan.strategy] ?? plan.strategy}
+              </span>
+              {isSelected ? (
+                <span className="rc-chip" style={{ background: "rgba(22, 163, 74, 0.1)", color: "var(--rc-success)" }}>
+                  已采用
+                </span>
+              ) : null}
+            </div>
+            <h3 className="text-[13px] font-semibold leading-5">{plan.title}</h3>
+            <p className="text-[12px] leading-5 text-[var(--rc-text-secondary)]">{plan.summary}</p>
+            <p className="text-[11px] leading-4 text-[var(--rc-text-secondary)] opacity-80">{plan.rationale}</p>
+
+            <div className="flex flex-wrap items-center gap-1">
+              <Users className="size-3 text-[var(--rc-text-secondary)]" aria-hidden />
+              {plan.roles.slice(0, 6).map((role) => (
+                <span key={role.key} className="rc-chip">
+                  {role.display_name}
+                </span>
+              ))}
+              {plan.roles.length > 6 ? (
+                <span className="text-[11px] text-[var(--rc-text-secondary)]">+{plan.roles.length - 6}</span>
+              ) : null}
+            </div>
+
+            <div className="flex flex-wrap gap-x-4 gap-y-1 text-[11px] text-[var(--rc-text-secondary)]">
+              <span className="inline-flex items-center gap-1">
+                <Clock className="size-3" aria-hidden />
+                {durationLabel(plan.estimated_duration_seconds)}
+              </span>
+              <span className="inline-flex items-center gap-1">
+                <Gauge className="size-3" aria-hidden />
+                {costLabel(plan.estimated_cost_level)}
+              </span>
+              <span className="inline-flex items-center gap-1">
+                <ShieldCheck className="size-3" aria-hidden />
+                {plan.nodes.length} 节点 · {plan.quality_gates.length} 质量门
+              </span>
+            </div>
+
+            {invalid ? (
+              <div
+                className="rounded-md px-2 py-1 text-[11px]"
+                style={{
+                  background: "rgba(220, 38, 38, 0.08)",
+                  color: "var(--rc-danger)",
+                }}
+              >
+                方案校验未通过：{plan.validation.errors.join("；")}
+              </div>
+            ) : null}
+
+            <div className="mt-1 grid grid-cols-2 gap-2">
+              <button
+                type="button"
+                className="rc-btn"
+                disabled={isSelected || selectBusy || invalid}
+                onClick={(event) => {
+                  event.stopPropagation();
+                  onSelect(plan.id);
+                }}
+              >
+                {isSelected ? "已采用" : "采用此方案"}
+              </button>
+              <button
+                type="button"
+                className="rc-btn rc-btn-primary"
+                disabled={!isSelected || startBusy || invalid}
+                onClick={(event) => {
+                  event.stopPropagation();
+                  onStart(plan.id);
+                }}
+              >
+                <Play className="size-3.5" aria-hidden />
+                开始协作
+              </button>
+            </div>
+          </article>
+        );
+      })}
+    </div>
+  );
+}
@@ -0,0 +1,184 @@
+"use client";
+
+import { useState } from "react";
+import { FileText, History, Loader2, RotateCcw } from "lucide-react";
+
+import { MarkdownContent } from "@/components/workspace/messages/markdown-content";
+import { downloadMarkdownDocxFromBackend } from "@/core/api/markdown-docx-export";
+import type { ReportVersion } from "@/report-collaboration/api/types";
+
+interface ReportPreviewDialogProps {
+  open: boolean;
+  onClose: () => void;
+  versions: ReportVersion[];
+  activeVersionId: string | null;
+  onSelectVersion: (versionId: string) => void;
+  onRestore: (versionId: string) => void;
+  restoreBusy: boolean;
+}
+
+function downloadMarkdownFile(title: string, markdown: string): void {
+  const blob = new Blob([markdown], { type: "text/markdown;charset=utf-8" });
+  const url = URL.createObjectURL(blob);
+  const link = document.createElement("a");
+  link.href = url;
+  link.download = `${title || "报告"}.md`;
+  link.click();
+  URL.revokeObjectURL(url);
+}
+
+/** 大尺寸报告预览 Dialog：Markdown 渲染 + 版本切换 + 下载/恢复。 */
+export function ReportPreviewDialog({
+  open,
+  onClose,
+  versions,
+  activeVersionId,
+  onSelectVersion,
+  onRestore,
+  restoreBusy,
+}: ReportPreviewDialogProps) {
+  const [downloading, setDownloading] = useState<"md" | "docx" | null>(null);
+  if (!open) return null;
+  const active =
+    versions.find((version) => version.id === activeVersionId) ?? versions.at(-1) ?? null;
+  if (!active) return null;
+
+  const sorted = [...versions].sort((a, b) => b.version - a.version);
+  const isHead = active.is_head || active.id === versions.at(-1)?.id;
+
+  const handleDocx = async () => {
+    if (!active) return;
+    setDownloading("docx");
+    try {
+      await downloadMarkdownDocxFromBackend({
+        title: `报告 v${active.version}`,
+        markdown: active.markdown,
+      });
+    } finally {
+      setDownloading(null);
+    }
+  };
+
+  return (
+    <div
+      className="fixed inset-0 z-[80] flex items-center justify-center bg-black/40 p-6"
+      role="dialog"
+      aria-modal="true"
+      aria-label="报告预览"
+      onClick={onClose}
+    >
+      <div
+        className="flex h-full max-h-[88vh] w-full max-w-5xl flex-col overflow-hidden rounded-xl border border-[var(--rc-border)] bg-[var(--rc-bg-panel)] shadow-2xl"
+        onClick={(event) => event.stopPropagation()}
+      >
+        <header className="flex items-center justify-between gap-3 border-b border-[var(--rc-border)] px-4 py-3">
+          <div className="flex min-w-0 items-center gap-2">
+            <FileText className="size-4 shrink-0" style={{ color: "var(--rc-accent)" }} aria-hidden />
+            <span className="truncate text-[14px] font-semibold">报告预览 · v{active.version}</span>
+            {active.change_summary ? (
+              <span className="truncate text-[12px] text-[var(--rc-text-secondary)]">
+                {active.change_summary}
+              </span>
+            ) : null}
+          </div>
+          <div className="flex shrink-0 items-center gap-2">
+            <button type="button" className="rc-btn" onClick={() => downloadMarkdownFile(`报告_v${active.version}`, active.markdown)}>
+              下载 Markdown
+            </button>
+            <button type="button" className="rc-btn" onClick={() => void handleDocx()} disabled={downloading === "docx"}>
+              {downloading === "docx" ? <Loader2 className="rc-spin size-3.5" /> : null}
+              下载 Word
+            </button>
+            {!isHead ? (
+              <button
+                type="button"
+                className="rc-btn"
+                disabled={restoreBusy}
+                onClick={() => onRestore(active.id)}
+                title="恢复此版本（创建新的头版本，不删除历史）"
+              >
+                {restoreBusy ? <Loader2 className="rc-spin size-3.5" /> : <RotateCcw className="size-3.5" />}
+                恢复此版本
+              </button>
+            ) : null}
+            <button type="button" className="rc-btn" onClick={onClose} aria-label="关闭预览">
+              关闭
+            </button>
+          </div>
+        </header>
+        <div className="flex min-h-0 flex-1">
+          {sorted.length > 1 ? (
+            <nav className="w-44 shrink-0 overflow-y-auto border-r border-[var(--rc-border)] p-2" aria-label="版本历史">
+              <div className="mb-1 flex items-center gap-1 px-1 text-[11px] font-semibold text-[var(--rc-text-secondary)]">
+                <History className="size-3" aria-hidden /> 版本
+              </div>
+              {sorted.map((version) => (
+                <button
+                  key={version.id}
+                  type="button"
+                  className="rc-tab block w-full text-left"
+                  data-active={version.id === active.id}
+                  onClick={() => onSelectVersion(version.id)}
+                >
+                  v{version.version}
+                  {version.is_head ? "（当前）" : ""}
+                  <span className="block text-[10px] font-normal opacity-70">
+                    {version.change_type}
+                  </span>
+                </button>
+              ))}
+            </nav>
+          ) : null}
+          <div className="min-w-0 flex-1 overflow-y-auto px-6 py-4">
+            <MarkdownContent
+              content={active.markdown}
+              className="rc-report-preview"
+              rehypePlugins={[]}
+              isLoading={false}
+            />
+          </div>
+        </div>
+      </div>
+    </div>
+  );
+}
+
+/** MessageList 业务卡：报告入口卡（点击打开大尺寸预览 Dialog）。 */
+export function ReportAvailableCard({
+  version,
+  versionCount,
+  onOpen,
+}: {
+  version: ReportVersion;
+  versionCount: number;
+  onOpen: (versionId: string) => void;
+}) {
+  return (
+    <div className="rc-report-card">
+      <div className="flex items-center gap-2">
+        <FileText className="size-4" style={{ color: "var(--rc-success)" }} aria-hidden />
+        <span className="text-[13px] font-semibold">报告 v{version.version} 已生成</span>
+        {versionCount > 1 ? (
+          <span className="rc-chip" style={{ background: "var(--rc-bg-secondary)", color: "var(--rc-text-secondary)" }}>
+            共 {versionCount} 个版本
+          </span>
+        ) : null}
+      </div>
+      {version.change_summary ? (
+        <p className="text-[12px] text-[var(--rc-text-secondary)]">{version.change_summary}</p>
+      ) : null}
+      <div className="flex gap-2">
+        <button type="button" className="rc-btn rc-btn-primary" onClick={() => onOpen(version.id)}>
+          预览报告
+        </button>
+        <button
+          type="button"
+          className="rc-btn"
+          onClick={() => downloadMarkdownFile(`报告_v${version.version}`, version.markdown)}
+        >
+          下载 Markdown
+        </button>
+      </div>
+    </div>
+  );
+}
@@ -0,0 +1,51 @@
+"use client";
+
+import { FilesIcon, XIcon } from "lucide-react";
+
+import { ConversationEmptyState } from "@/components/ai-elements/conversation";
+import { Button } from "@/components/ui/button";
+import { ArtifactFileDetail, useArtifacts } from "@/components/workspace/artifacts";
+
+/**
+ * 画布上的沙箱覆盖层：write_file 步骤条自动打开后，在右侧预览报告，
+ * 不另开第三栏。关闭后归还流程图。
+ */
+export function ReportSandboxOverlay({ threadId }: { threadId: string }) {
+  const { open, selectedArtifact, setOpen, deselect } = useArtifacts();
+  if (!open) return null;
+
+  const handleClose = () => {
+    deselect();
+    setOpen(false);
+  };
+
+  return (
+    <div className="rc-sandbox-overlay" role="dialog" aria-label="沙箱预览">
+      {selectedArtifact ? (
+        <ArtifactFileDetail
+          className="size-full"
+          filepath={selectedArtifact}
+          threadId={threadId}
+          onClose={handleClose}
+        />
+      ) : (
+        <div className="relative flex size-full items-center justify-center bg-[var(--rc-bg-panel)]">
+          <Button
+            size="icon-sm"
+            variant="ghost"
+            className="absolute top-2 right-2"
+            onClick={handleClose}
+            aria-label="关闭沙箱"
+          >
+            <XIcon />
+          </Button>
+          <ConversationEmptyState
+            icon={<FilesIcon />}
+            title="沙箱预览"
+            description="智能体写入文件后将在此预览"
+          />
+        </div>
+      )}
+    </div>
+  );
+}
@@ -0,0 +1,60 @@
+"use client";
+
+import type { ReactNode } from "react";
+
+import { desensitize } from "@/lib/desensitize";
+import { cn } from "@/lib/utils";
+import { getAvatar } from "@/roundtable-planning/components/Avatars";
+import { MessageBubble } from "@/roundtable-planning/components/MessageBubble";
+import type { ReportSpeaker } from "@/report-collaboration/state/speaker";
+
+interface ReportSpeakerShellProps {
+  speaker: ReportSpeaker;
+  onAvatarClick?: (agentRunId: string) => void;
+  avatarSelected?: boolean;
+  children: ReactNode;
+}
+
+/**
+ * 会商第二步气泡壳：头像 + 席位名 + 正文（步骤条 / 思考 / 输出仍走 MessageList）。
+ */
+export function ReportSpeakerShell({
+  speaker,
+  onAvatarClick,
+  avatarSelected = false,
+  children,
+}: ReportSpeakerShellProps) {
+  const avatarInner = getAvatar(speaker.avatarType, "h-9 w-9 shrink-0");
+  const canFilter = Boolean(speaker.agentRunId && onAvatarClick);
+  const avatar = canFilter ? (
+    <button
+      type="button"
+      onClick={() => onAvatarClick?.(speaker.agentRunId!)}
+      aria-pressed={avatarSelected}
+      title={
+        avatarSelected
+          ? "取消筛选，显示全部发言"
+          : `只看 ${desensitize(speaker.name)} 的发言`
+      }
+      className={cn(
+        "shrink-0 cursor-pointer rounded-full transition hover:opacity-80 focus:outline-none focus-visible:ring-2 focus-visible:ring-primary/60",
+        avatarSelected && "ring-2 ring-primary ring-offset-1 ring-offset-white",
+      )}
+    >
+      {avatarInner}
+    </button>
+  ) : (
+    avatarInner
+  );
+
+  return (
+    <MessageBubble
+      avatar={avatar}
+      senderName={speaker.name}
+      badge={speaker.role && speaker.role !== speaker.name ? speaker.role : undefined}
+      time={speaker.time}
+    >
+      {children}
+    </MessageBubble>
+  );
+}
@@ -0,0 +1,254 @@
+"use client";
+
+import { useCallback, useEffect, useState } from "react";
+import { useNavigate } from "react-router-dom";
+import { Check, Loader2, MessageSquarePlus, Pencil, Trash2, X } from "lucide-react";
+
+import { getReportCollaborationDriver } from "@/report-collaboration/api/driver";
+import type { ReportSessionSummary } from "@/report-collaboration/api/types";
+import { cn } from "@/lib/utils";
+
+const STATUS_LABELS: Record<string, string> = {
+  empty: "空会话",
+  clarifying: "澄清需求",
+  planning: "生成方案中",
+  proposal_ready: "待确认方案",
+  running: "协作中",
+  awaiting_input: "等待输入",
+  reviewing: "审稿中",
+  completed: "已完成",
+  failed: "失败",
+  cancelled: "已取消",
+};
+
+/** 历史会话面板：切换 / 重命名 / 删除 / 新建。 */
+export function SessionHistoryPanel({ activeSessionId }: { activeSessionId: string | null }) {
+  const navigate = useNavigate();
+  const [sessions, setSessions] = useState<ReportSessionSummary[] | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+  const [renamingId, setRenamingId] = useState<string | null>(null);
+  const [renameValue, setRenameValue] = useState("");
+  const [busyId, setBusyId] = useState<string | null>(null);
+  const [clearing, setClearing] = useState(false);
+
+  const reload = useCallback(async (quiet = false) => {
+    if (!quiet) setLoading(true);
+    try {
+      const list = await getReportCollaborationDriver().listSessions();
+      setSessions(list);
+      setError(null);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : String(err));
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  useEffect(() => {
+    void reload();
+  }, [reload]);
+
+  const commitRename = async (sessionId: string) => {
+    const title = renameValue.trim();
+    setRenamingId(null);
+    if (!title) return;
+    setBusyId(sessionId);
+    try {
+      await getReportCollaborationDriver().updateSession(sessionId, { title });
+      await reload(true);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : String(err));
+    } finally {
+      setBusyId(null);
+    }
+  };
+
+  const removeSession = async (sessionId: string) => {
+    if (!window.confirm("删除该会话将同时删除其消息、方案与报告版本，且不可恢复。确定删除？")) {
+      return;
+    }
+    setBusyId(sessionId);
+    try {
+      await getReportCollaborationDriver().deleteSession(sessionId);
+      if (activeSessionId === sessionId) {
+        navigate("/page/workspace/report-collaboration");
+      } else {
+        await reload(true);
+      }
+    } catch (err) {
+      setError(err instanceof Error ? err.message : String(err));
+    } finally {
+      setBusyId(null);
+    }
+  };
+
+  const clearAllSessions = async () => {
+    const list = sessions ?? [];
+    if (list.length === 0 || clearing) return;
+    if (
+      !window.confirm(
+        `将删除全部 ${list.length} 个历史会话（含消息、方案与报告版本），且不可恢复。确定清空？`,
+      )
+    ) {
+      return;
+    }
+    setClearing(true);
+    try {
+      // 个别会话可能因运行中的协作删除失败（409 等），用 allSettled 尽量多删。
+      const results = await Promise.allSettled(
+        list.map((session) => getReportCollaborationDriver().deleteSession(session.id)),
+      );
+      const failedCount = results.filter((result) => result.status === "rejected").length;
+      const activeDeleted = list.some(
+        (session, index) => results[index].status === "fulfilled" && session.id === activeSessionId,
+      );
+      await reload(true);
+      if (failedCount > 0) {
+        setError(`已删除 ${list.length - failedCount} 个会话，${failedCount} 个删除失败（可能存在运行中的协作），可稍后重试。`);
+      } else {
+        setError(null);
+      }
+      if (activeDeleted) {
+        navigate("/page/workspace/report-collaboration");
+      }
+    } finally {
+      setClearing(false);
+    }
+  };
+
+  return (
+    <div className="flex min-h-0 flex-1 flex-col">
+      <div className="flex items-center justify-between gap-2 px-3 py-2">
+        <span className="shrink-0 text-[12px] text-[var(--rc-text-secondary)]">
+          {loading ? "加载中…" : `${sessions?.length ?? 0} 个会话`}
+        </span>
+        <div className="flex min-w-0 items-center gap-1.5">
+          <button
+            type="button"
+            className="rc-btn"
+            disabled={clearing || !sessions?.length}
+            title={sessions?.length ? "删除全部历史会话" : "暂无历史会话"}
+            onClick={() => void clearAllSessions()}
+          >
+            {clearing ? (
+              <Loader2 className="rc-spin size-3.5" aria-hidden />
+            ) : (
+              <Trash2 className="size-3.5" aria-hidden />
+            )}
+            清空历史
+          </button>
+          <button
+            type="button"
+            className="rc-btn"
+            onClick={() => navigate("/page/workspace/report-collaboration")}
+          >
+            <MessageSquarePlus className="size-3.5" aria-hidden />
+            新建会话
+          </button>
+        </div>
+      </div>
+      {error ? (
+        <p className="px-3 pb-1 text-[11px]" style={{ color: "var(--rc-danger)" }}>
+          {error}
+        </p>
+      ) : null}
+      <div className="min-h-0 flex-1 overflow-y-auto px-2 pb-2">
+        {(sessions ?? []).map((session) => {
+          const active = session.id === activeSessionId;
+          return (
+            <div
+              key={session.id}
+              className={cn(
+                "group flex items-center gap-2 rounded-lg px-2.5 py-2 transition-colors",
+                active ? "bg-[var(--rc-accent-soft)]" : "hover:bg-[var(--rc-bg-secondary)]",
+              )}
+            >
+              {renamingId === session.id ? (
+                <>
+                  <input
+                    autoFocus
+                    className="min-w-0 flex-1 rounded-md border border-[var(--rc-accent)] bg-[var(--rc-bg-panel)] px-2 py-1 text-[12px] outline-none"
+                    value={renameValue}
+                    onChange={(event) => setRenameValue(event.target.value)}
+                    onKeyDown={(event) => {
+                      if (event.key === "Enter") void commitRename(session.id);
+                      if (event.key === "Escape") setRenamingId(null);
+                    }}
+                    aria-label="会话标题"
+                  />
+                  <button type="button" className="rc-btn !min-h-7 !px-1.5" onClick={() => void commitRename(session.id)} aria-label="保存标题">
+                    <Check className="size-3.5" />
+                  </button>
+                  <button type="button" className="rc-btn !min-h-7 !px-1.5" onClick={() => setRenamingId(null)} aria-label="取消重命名">
+                    <X className="size-3.5" />
+                  </button>
+                </>
+              ) : (
+                <>
+                  <button
+                    type="button"
+                    className="min-w-0 flex-1 text-left"
+                    onClick={() => navigate(`/page/workspace/report-collaboration/${session.id}`)}
+                  >
+                    <div className="truncate text-[12px] font-medium">{session.title}</div>
+                    <div className="mt-0.5 flex items-center gap-2 text-[10px] text-[var(--rc-text-secondary)]">
+                      <span>{STATUS_LABELS[session.status] ?? session.status}</span>
+                      <span>·</span>
+                      <span>{formatTime(session.updated_at)}</span>
+                    </div>
+                  </button>
+                  <span className="hidden shrink-0 items-center gap-1 group-hover:flex">
+                    {busyId === session.id ? (
+                      <Loader2 className="rc-spin size-3.5" aria-hidden />
+                    ) : (
+                      <>
+                        <button
+                          type="button"
+                          className="rounded p-1 hover:bg-[var(--rc-bg-secondary)]"
+                          aria-label="重命名会话"
+                          onClick={() => {
+                            setRenamingId(session.id);
+                            setRenameValue(session.title);
+                          }}
+                        >
+                          <Pencil className="size-3.5" />
+                        </button>
+                        <button
+                          type="button"
+                          className="rounded p-1 hover:bg-[var(--rc-bg-secondary)]"
+                          aria-label="删除会话"
+                          onClick={() => void removeSession(session.id)}
+                        >
+                          <Trash2 className="size-3.5" style={{ color: "var(--rc-danger)" }} />
+                        </button>
+                      </>
+                    )}
+                  </span>
+                </>
+              )}
+            </div>
+          );
+        })}
+        {!loading && (sessions?.length ?? 0) === 0 ? (
+          <p className="px-3 py-6 text-center text-[12px] text-[var(--rc-text-secondary)]">
+            暂无历史会话
+          </p>
+        ) : null}
+      </div>
+    </div>
+  );
+}
+
+function formatTime(iso: string): string {
+  try {
+    const date = new Date(iso);
+    const now = new Date();
+    const sameDay = date.toDateString() === now.toDateString();
+    return sameDay
+      ? date.toLocaleTimeString("zh-CN", { hour: "2-digit", minute: "2-digit" })
+      : date.toLocaleDateString("zh-CN", { month: "2-digit", day: "2-digit" });
+  } catch {
+    return "";
+  }
+}
@@ -0,0 +1,70 @@
+/**
+ * 消息组装 hook：状态 → 聚焦过滤 → LangGraph Message[] → BaseStream 外观。
+ *
+ * - 并行执行中只显示当前成员；结束后把各成员收成普通聊天记录，不重拉不改写。
+ * - 虚拟业务卡（方案组 / 命令确认 / 报告入口）由页面以 extraCards 传入，
+ *   经 MessageList 的 businessCardSlot 渲染。
+ */
+
+import { useMemo } from "react";
+import type { Message } from "@langchain/langgraph-sdk";
+import type { BaseStream } from "@langchain/langgraph-sdk/react";
+
+import type { AgentThreadState } from "@/core/threads";
+
+import type { CollaborationMessage } from "@/report-collaboration/api/types";
+import type { CollaborationState } from "@/report-collaboration/state/event-reducer";
+import {
+  buildBaseStreamFacade,
+  buildReportWriteFileMessages,
+  reportWriteFileBelongsToFocus,
+  toLangGraphMessages,
+} from "@/report-collaboration/state/message-adapter";
+import {
+  selectConversationMessages,
+  selectHeadReportVersion,
+  selectOrderedVisibleMessages,
+  selectWriterAgentRun,
+} from "@/report-collaboration/state/selectors";
+
+export interface UseReportCollaborationMessagesResult {
+  visibleMessages: CollaborationMessage[];
+  focusedMessages: CollaborationMessage[];
+  displayMessages: Message[];
+  displayThread: BaseStream<AgentThreadState>;
+  /** 存在未完成消息（流式中）。 */
+  streaming: boolean;
+}
+
+export function useReportCollaborationMessages(
+  state: CollaborationState,
+  focusedAgentRunId: string | null,
+  extraCards: Message[],
+  extraLoading: boolean,
+): UseReportCollaborationMessagesResult {
+  return useMemo(() => {
+    const visibleMessages = selectOrderedVisibleMessages(state);
+    const focusedMessages = selectConversationMessages(state, focusedAgentRunId);
+    const base = toLangGraphMessages(focusedMessages);
+    const writeFiles = reportWriteFileBelongsToFocus(
+      buildReportWriteFileMessages({
+        sessionId: state.sessionId,
+        markdown: state.reportDraft?.markdown || selectHeadReportVersion(state)?.markdown || "",
+        writing: Boolean(state.reportDraft),
+        writer: selectWriterAgentRun(state),
+      }),
+      focusedAgentRunId,
+    );
+    const displayMessages =
+      extraCards.length > 0 || writeFiles.length > 0
+        ? [...base, ...writeFiles, ...extraCards]
+        : base;
+    const streamSource = focusedAgentRunId ? focusedMessages : visibleMessages;
+    const streaming =
+      streamSource.some((message) => !message.completed_at && message.role !== "human") ||
+      Boolean(state.reportDraft) ||
+      extraLoading;
+    const displayThread = buildBaseStreamFacade(displayMessages, streaming);
+    return { visibleMessages, focusedMessages, displayMessages, displayThread, streaming };
+  }, [extraCards, extraLoading, focusedAgentRunId, state]);
+}
@@ -0,0 +1,403 @@
+/**
+ * 会话编排 hook：快照加载 → SSE 续接 → 合帧 reducer → 动作派发。
+ *
+ * 页面唯一的数据入口；纯展示状态（预览方案、聚焦成员、面板宽度）不在此层。
+ */
+
+import { useCallback, useEffect, useMemo, useReducer, useRef, useState } from "react";
+
+import { newIdempotencyKey } from "@/report-collaboration/api/client";
+import { getReportCollaborationDriver } from "@/report-collaboration/api/driver";
+import type {
+  CollaborationEvent,
+  CollaborationMessage,
+  SessionSnapshot,
+} from "@/report-collaboration/api/types";
+import {
+  applyCollaborationEvents,
+  applySessionSnapshot,
+  createInitialCollaborationState,
+  hasSeqGap,
+  insertOptimisticUserMessage,
+  type CollaborationState,
+} from "@/report-collaboration/state/event-reducer";
+import { normalizeCollaborationEvent } from "@/report-collaboration/state/event-normalizer";
+import {
+  useReportCollaborationStream,
+  type RcStreamStatus,
+} from "@/report-collaboration/hooks/useReportCollaborationStream";
+
+const EVENT_FLUSH_MS = 50;
+const PRE_RUN_POLL_MS = 2500;
+
+type RcAction =
+  | { type: "snapshot"; snapshot: SessionSnapshot }
+  | { type: "events"; events: CollaborationEvent[] }
+  | { type: "optimistic"; message: CollaborationMessage };
+
+function rcReducer(state: CollaborationState, action: RcAction): CollaborationState {
+  switch (action.type) {
+    case "snapshot":
+      return applySessionSnapshot(state, action.snapshot);
+    case "events":
+      return applyCollaborationEvents(state, action.events);
+    case "optimistic":
+      return insertOptimisticUserMessage(state, action.message);
+  }
+}
+
+export interface RcInterventionTarget {
+  nodeId?: string | null;
+  agentRunId?: string | null;
+}
+
+export interface UseReportCollaborationSessionResult {
+  state: CollaborationState;
+  streamStatus: RcStreamStatus;
+  snapshotLoading: boolean;
+  snapshotError: string | null;
+  /** 最近一次动作错误（422/409/429/网络），供页面 toast 展示。 */
+  actionError: string | null;
+  clearActionError: () => void;
+  sendBusy: boolean;
+
+  /** 全过程发送：run 活动中走 commands，其余走 session messages。 */
+  send: (text: string, target?: RcInterventionTarget) => Promise<void>;
+  requestPlans: () => Promise<void>;
+  selectPlan: (planId: string) => Promise<void>;
+  startRun: (planId: string) => Promise<void>;
+  cancelRun: () => Promise<void>;
+  confirmCommand: (commandId: string) => Promise<void>;
+  cancelCommand: (commandId: string) => Promise<void>;
+  refreshSnapshot: () => void;
+}
+
+function optimisticUserMessage(text: string, idempotencyKey: string): CollaborationMessage {
+  return {
+    message_id: `pending:${idempotencyKey}`,
+    role: "human",
+    content: text,
+    visibility: "visible",
+    metadata: { optimistic: true, idempotency_key: idempotencyKey },
+    created_at: new Date().toISOString(),
+    completed_at: new Date().toISOString(),
+  };
+}
+
+export function isRunActive(status: string | undefined | null): boolean {
+  return (
+    status === "queued" ||
+    status === "planning" ||
+    status === "running" ||
+    status === "awaiting_input" ||
+    status === "reviewing" ||
+    status === "recovering"
+  );
+}
+
+export function useReportCollaborationSession(sessionId: string): UseReportCollaborationSessionResult {
+  const driver = useMemo(() => getReportCollaborationDriver(), []);
+  const [state, dispatch] = useReducer(rcReducer, sessionId, createInitialCollaborationState);
+  const [streamStatus, setStreamStatus] = useState<RcStreamStatus>({ status: "idle", attempts: 0 });
+  const [snapshotLoading, setSnapshotLoading] = useState(true);
+  const [snapshotError, setSnapshotError] = useState<string | null>(null);
+  const [actionError, setActionError] = useState<string | null>(null);
+  const [sendBusy, setSendBusy] = useState(false);
+
+  const lastSeqRef = useRef(0);
+  lastSeqRef.current = state.lastSeq;
+  const runId = state.run?.id ?? state.session?.active_run_id ?? null;
+
+  // ── 事件合帧：高频 delta 先缓冲，统一一帧进 reducer ─────────────────────
+  const pendingEventsRef = useRef<CollaborationEvent[]>([]);
+  const flushTimerRef = useRef<number | undefined>(undefined);
+  const flushEvents = useCallback(() => {
+    flushTimerRef.current = undefined;
+    if (pendingEventsRef.current.length === 0) return;
+    const batch = pendingEventsRef.current;
+    pendingEventsRef.current = [];
+    dispatch({ type: "events", events: batch });
+  }, []);
+
+  const handleRawEvent = useCallback(
+    (raw: unknown) => {
+      const event = normalizeCollaborationEvent(raw);
+      if (!event) return;
+      pendingEventsRef.current.push(event);
+      if (flushTimerRef.current === undefined) {
+        flushTimerRef.current = window.setTimeout(flushEvents, EVENT_FLUSH_MS);
+      }
+    },
+    [flushEvents],
+  );
+
+  useEffect(() => {
+    return () => {
+      if (flushTimerRef.current !== undefined) window.clearTimeout(flushTimerRef.current);
+    };
+  }, []);
+
+  // ── 快照加载 ─────────────────────────────────────────────────────────────
+  const [snapshotTick, setSnapshotTick] = useState(0);
+  const loadSnapshot = useCallback(
+    async (quiet: boolean) => {
+      if (!quiet) setSnapshotLoading(true);
+      try {
+        const snapshot = await driver.getSnapshot(sessionId);
+        if (!snapshot) {
+          setSnapshotError("会话不存在或已删除");
+          return;
+        }
+        dispatch({ type: "snapshot", snapshot });
+        setSnapshotError(null);
+      } catch (err) {
+        setSnapshotError(err instanceof Error ? err.message : String(err));
+      } finally {
+        if (!quiet) setSnapshotLoading(false);
+      }
+    },
+    [driver, sessionId],
+  );
+
+  useEffect(() => {
+    let cancelled = false;
+    setSnapshotLoading(true);
+    void driver
+      .getSnapshot(sessionId)
+      .then((snapshot) => {
+        if (cancelled) return;
+        if (!snapshot) {
+          setSnapshotError("会话不存在或已删除");
+          return;
+        }
+        dispatch({ type: "snapshot", snapshot });
+        setSnapshotError(null);
+      })
+      .catch((err: unknown) => {
+        if (!cancelled) setSnapshotError(err instanceof Error ? err.message : String(err));
+      })
+      .finally(() => {
+        if (!cancelled) setSnapshotLoading(false);
+      });
+    return () => {
+      cancelled = true;
+    };
+  }, [driver, sessionId, snapshotTick]);
+
+  // ── SSE：run 存在且未终态时连接 ────────────────────────────────────────
+  const runTerminal =
+    state.run?.status === "completed" ||
+    state.run?.status === "failed" ||
+    state.run?.status === "cancelled";
+  const streamEnabled = Boolean(state.snapshotLoaded && runId && !runTerminal);
+  useReportCollaborationStream({
+    sessionId,
+    runId,
+    enabled: streamEnabled,
+    afterSeqRef: lastSeqRef,
+    onEvent: handleRawEvent,
+    onStatusChange: setStreamStatus,
+  });
+
+  // 终态：最后一次 REST 补拉，确保正式版本/收尾消息完整后再停流。
+  const finalizeRef = useRef<string | null>(null);
+  useEffect(() => {
+    if (!runTerminal || !state.run) return;
+    const activeRunId = state.run.id;
+    if (finalizeRef.current === activeRunId) return;
+    finalizeRef.current = activeRunId;
+    void driver
+      .listRunEvents(activeRunId, lastSeqRef.current)
+      .then((events) => {
+        if (events.length > 0) dispatch({ type: "events", events });
+      })
+      .catch(() => undefined);
+    setStreamStatus({ status: "closed", attempts: 0 });
+  }, [driver, runTerminal, state.run]);
+
+  // 序号缺口：暂停 live 应用，REST 补拉后由 reducer drain 缓冲。
+  const gap = hasSeqGap(state);
+  const backfillingRef = useRef(false);
+  useEffect(() => {
+    if (!gap || !runId || backfillingRef.current) return;
+    backfillingRef.current = true;
+    void driver
+      .listRunEvents(runId, lastSeqRef.current)
+      .then((events) => {
+        if (events.length > 0) dispatch({ type: "events", events });
+      })
+      .catch(() => undefined)
+      .finally(() => {
+        backfillingRef.current = false;
+      });
+  }, [driver, gap, runId]);
+
+  // 无 run 的前置阶段（澄清/规划）：后端事件只在 run 流上，轮询快照兜底。
+  const preRunPolling =
+    state.snapshotLoaded &&
+    !state.run &&
+    (state.session?.status === "clarifying" ||
+      state.session?.status === "planning" ||
+      state.session?.status === "proposal_ready");
+  useEffect(() => {
+    if (!preRunPolling) return;
+    const timer = window.setInterval(() => {
+      void loadSnapshot(true);
+    }, PRE_RUN_POLL_MS);
+    return () => window.clearInterval(timer);
+  }, [loadSnapshot, preRunPolling]);
+
+  // ── 动作 ────────────────────────────────────────────────────────────────
+
+  const send = useCallback(
+    async (text: string, target?: RcInterventionTarget) => {
+      const trimmed = text.trim();
+      if (!trimmed) return;
+      setSendBusy(true);
+      setActionError(null);
+      const idempotencyKey = newIdempotencyKey();
+      // 乐观用户消息：服务器镜像携带同 idempotency_key 时原地替换。
+      dispatch({ type: "optimistic", message: optimisticUserMessage(trimmed, idempotencyKey) });
+      try {
+        // 命令只存在于 run 执行阶段（running / awaiting_input / reviewing）；
+        // 澄清、规划、完成后的问答走 session messages。
+        const sessionStatus = state.session?.status;
+        const commandPhase =
+          sessionStatus === "running" ||
+          sessionStatus === "awaiting_input" ||
+          sessionStatus === "reviewing";
+        const activeRun = commandPhase ? state.run : null;
+        if (activeRun && isRunActive(activeRun.status)) {
+          await driver.createCommand(
+            activeRun.id,
+            {
+              text: trimmed,
+              target_node_id: target?.nodeId ?? null,
+              agent_run_id: target?.agentRunId ?? null,
+            },
+            idempotencyKey,
+          );
+        } else {
+          await driver.sendMessage(
+            sessionId,
+            {
+              text: trimmed,
+              target_node_id: target?.nodeId ?? null,
+              agent_run_id: target?.agentRunId ?? null,
+            },
+            idempotencyKey,
+          );
+        }
+        // POST /messages 只回用户消息；协调者澄清/就绪回复写在同一次请求里，
+        // 必须立刻拉快照，否则本地 status 仍是 empty，轮询不会启动、AI 气泡不出现。
+        await loadSnapshot(true);
+      } catch (err) {
+        // 失败保留乐观消息与输入，提供重试入口（不回滚 UI）。
+        setActionError(err instanceof Error ? err.message : String(err));
+      } finally {
+        setSendBusy(false);
+      }
+    },
+    [driver, loadSnapshot, sessionId, state.run, state.session?.status],
+  );
+
+  const requestPlans = useCallback(async () => {
+    setActionError(null);
+    try {
+      await driver.requestPlans(sessionId, state.session?.requirement_revision ?? null);
+      await loadSnapshot(true);
+    } catch (err) {
+      setActionError(err instanceof Error ? err.message : String(err));
+    }
+  }, [driver, loadSnapshot, sessionId, state.session]);
+
+  const selectPlan = useCallback(
+    async (planId: string) => {
+      setActionError(null);
+      try {
+        await driver.selectPlan(sessionId, planId, state.session?.requirement_revision ?? null);
+      } catch (err) {
+        setActionError(err instanceof Error ? err.message : String(err));
+        // 409：方案 revision 过期，刷新快照让用户基于最新方案重选。
+        setSnapshotTick((tick) => tick + 1);
+      }
+    },
+    [driver, sessionId, state.session],
+  );
+
+  const startRun = useCallback(
+    async (planId: string) => {
+      setActionError(null);
+      try {
+        await driver.startRun(
+          sessionId,
+          { plan_id: planId },
+          state.session?.requirement_revision ?? null,
+        );
+        // 立即刷新快照拿到 active_run_id，尽早接上 SSE。
+        setSnapshotTick((tick) => tick + 1);
+      } catch (err) {
+        setActionError(err instanceof Error ? err.message : String(err));
+        setSnapshotTick((tick) => tick + 1);
+      }
+    },
+    [driver, sessionId, state.session],
+  );
+
+  const cancelRun = useCallback(async () => {
+    const activeRunId = state.run?.id;
+    if (!activeRunId) return;
+    setActionError(null);
+    try {
+      await driver.cancelRun(activeRunId);
+    } catch (err) {
+      setActionError(err instanceof Error ? err.message : String(err));
+    }
+  }, [driver, state.run]);
+
+  const confirmCommand = useCallback(
+    async (commandId: string) => {
+      const activeRunId = state.run?.id;
+      if (!activeRunId) return;
+      setActionError(null);
+      try {
+        await driver.confirmCommand(activeRunId, commandId);
+      } catch (err) {
+        setActionError(err instanceof Error ? err.message : String(err));
+      }
+    },
+    [driver, state.run],
+  );
+
+  const cancelCommand = useCallback(
+    async (commandId: string) => {
+      const activeRunId = state.run?.id;
+      if (!activeRunId) return;
+      setActionError(null);
+      try {
+        await driver.cancelCommand(activeRunId, commandId);
+      } catch (err) {
+        setActionError(err instanceof Error ? err.message : String(err));
+      }
+    },
+    [driver, state.run],
+  );
+
+  return {
+    state,
+    streamStatus,
+    snapshotLoading,
+    snapshotError,
+    actionError,
+    clearActionError: () => setActionError(null),
+    sendBusy,
+    send,
+    requestPlans,
+    selectPlan,
+    startRun,
+    cancelRun,
+    confirmCommand,
+    cancelCommand,
+    refreshSnapshot: () => setSnapshotTick((tick) => tick + 1),
+  };
+}
@@ -0,0 +1,110 @@
+/**
+ * Run SSE 连接管理：断线指数退避重连、Last-Event-ID/after_seq 续接。
+ *
+ * 连接生命周期由 [sessionId, runId, enabled] 驱动；lastSeq 通过 ref 传入，
+ * 避免每次事件应用都重建连接。事件以回调上抛，由会话 hook 合帧后进 reducer。
+ */
+
+import { useEffect, useRef } from "react";
+
+import { getReportCollaborationDriver } from "@/report-collaboration/api/driver";
+import type { CollaborationEvent } from "@/report-collaboration/api/types";
+
+export type RcConnectionStatus =
+  | "idle"
+  | "connecting"
+  | "live"
+  | "reconnecting"
+  | "closed"
+  | "error";
+
+export interface RcStreamStatus {
+  status: RcConnectionStatus;
+  attempts: number;
+  message?: string;
+}
+
+export interface UseReportCollaborationStreamOptions {
+  sessionId: string | null;
+  runId: string | null;
+  enabled: boolean;
+  /** 最新已应用 seq 的 ref（重连时作为 after_seq）。 */
+  afterSeqRef: React.MutableRefObject<number>;
+  onEvent: (event: CollaborationEvent) => void;
+  onStatusChange?: (status: RcStreamStatus) => void;
+}
+
+const BACKOFF_BASE_MS = 1000;
+const BACKOFF_MAX_MS = 30_000;
+
+export function useReportCollaborationStream({
+  sessionId,
+  runId,
+  enabled,
+  afterSeqRef,
+  onEvent,
+  onStatusChange,
+}: UseReportCollaborationStreamOptions): void {
+  const onEventRef = useRef(onEvent);
+  const onStatusRef = useRef(onStatusChange);
+  onEventRef.current = onEvent;
+  onStatusRef.current = onStatusChange;
+
+  useEffect(() => {
+    if (!sessionId || !runId || !enabled) {
+      onStatusRef.current?.({ status: "idle", attempts: 0 });
+      return;
+    }
+
+    const driver = getReportCollaborationDriver();
+    let disposed = false;
+    let closeStream: (() => void) | null = null;
+    let attempts = 0;
+    let reconnectTimer: number | undefined;
+
+    const setStatus = (status: RcConnectionStatus, message?: string) => {
+      if (!disposed) {
+        onStatusRef.current?.({ status, attempts, message });
+      }
+    };
+
+    const connect = () => {
+      if (disposed) return;
+      setStatus(attempts === 0 ? "connecting" : "reconnecting");
+      closeStream = driver.openRunStream(runId, afterSeqRef.current, {
+        onEvent: (event) => {
+          if (!disposed) onEventRef.current(event);
+        },
+        onOpen: () => {
+          attempts = 0;
+          setStatus("live");
+        },
+        onError: (message) => {
+          if (disposed) return;
+          setStatus("reconnecting", message);
+          scheduleReconnect();
+        },
+        onClose: () => {
+          // 服务端正常关流（终态）。终态判定与最终补拉由会话 hook 负责，
+          // 这里标记 closed、不再自动重连，避免终态重连风暴。
+          if (!disposed) setStatus("closed");
+        },
+      });
+    };
+
+    const scheduleReconnect = () => {
+      if (disposed) return;
+      attempts += 1;
+      const delay = Math.min(BACKOFF_BASE_MS * 2 ** (attempts - 1), BACKOFF_MAX_MS);
+      reconnectTimer = window.setTimeout(connect, delay);
+    };
+
+    connect();
+
+    return () => {
+      disposed = true;
+      if (reconnectTimer !== undefined) window.clearTimeout(reconnectTimer);
+      closeStream?.();
+    };
+  }, [sessionId, runId, enabled, afterSeqRef]);
+}
@@ -0,0 +1,119 @@
+/**
+ * 两栏布局状态：左对话宽度（持久化到 localStorage，仅浏览器展示偏好）、
+ * 窄屏单面板切换、「专注对话/专注画布」模式。
+ */
+
+import { useCallback, useEffect, useRef, useState } from "react";
+
+const WIDTH_STORAGE_KEY = "deerflow.rc-conversation-width";
+
+export const PANEL_MIN_WIDTH = 360;
+export const PANEL_MAX_WIDTH = 720;
+export const PANEL_DEFAULT_WIDTH = 480;
+export const CANVAS_MIN_WIDTH = 480;
+/** 低于该宽度切换为单面板（顶部按钮切换对话/画布）。 */
+export const NARROW_BREAKPOINT = 960;
+export const RESIZE_KEYBOARD_STEP = 16;
+
+export type NarrowView = "conversation" | "canvas";
+export type FocusMode = "both" | "conversation" | "canvas";
+
+function loadStoredWidth(): number | null {
+  try {
+    const raw = window.localStorage.getItem(WIDTH_STORAGE_KEY);
+    const value = raw === null ? Number.NaN : Number(raw);
+    return Number.isFinite(value) ? value : null;
+  } catch {
+    return null;
+  }
+}
+
+export interface UseReportPanelLayoutResult {
+  conversationWidth: number;
+  setConversationWidth: (width: number) => void;
+  nudgeConversationWidth: (delta: number) => void;
+  clampConversationWidth: (width: number) => number;
+  isNarrow: boolean;
+  narrowView: NarrowView;
+  setNarrowView: (view: NarrowView) => void;
+  focusMode: FocusMode;
+  setFocusMode: (mode: FocusMode) => void;
+  /** 布局主体容器 ref（用于按容器实际宽度计算拖拽上限）。 */
+  bodyRef: React.RefObject<HTMLDivElement | null>;
+}
+
+export function useReportPanelLayout(): UseReportPanelLayoutResult {
+  const [conversationWidth, setWidth] = useState<number>(() => {
+    const stored = typeof window === "undefined" ? null : loadStoredWidth();
+    return stored !== null
+      ? Math.min(PANEL_MAX_WIDTH, Math.max(PANEL_MIN_WIDTH, stored))
+      : PANEL_DEFAULT_WIDTH;
+  });
+  const [isNarrow, setIsNarrow] = useState(
+    () => typeof window !== "undefined" && window.innerWidth < NARROW_BREAKPOINT,
+  );
+  const [narrowView, setNarrowView] = useState<NarrowView>("conversation");
+  const [focusMode, setFocusMode] = useState<FocusMode>("both");
+  const bodyRef = useRef<HTMLDivElement | null>(null);
+
+  // 窄屏判定 + 宽度上限随容器收缩（画布保底 480px）。
+  useEffect(() => {
+    const evaluate = () => {
+      setIsNarrow(window.innerWidth < NARROW_BREAKPOINT);
+      const bodyWidth = bodyRef.current?.clientWidth ?? 0;
+      if (bodyWidth > 0) {
+        setWidth((current) => clampWidth(current, bodyWidth));
+      }
+    };
+    evaluate();
+    window.addEventListener("resize", evaluate);
+    return () => window.removeEventListener("resize", evaluate);
+  }, []);
+
+  const clampConversationWidth = useCallback((width: number) => {
+    const bodyWidth = bodyRef.current?.clientWidth ?? 0;
+    return clampWidth(width, bodyWidth);
+  }, []);
+
+  const setConversationWidth = useCallback(
+    (width: number) => {
+      setWidth(clampConversationWidth(width));
+    },
+    [clampConversationWidth],
+  );
+
+  const nudgeConversationWidth = useCallback(
+    (delta: number) => {
+      setWidth((current) => clampConversationWidth(current + delta));
+    },
+    [clampConversationWidth],
+  );
+
+  useEffect(() => {
+    try {
+      window.localStorage.setItem(WIDTH_STORAGE_KEY, String(conversationWidth));
+    } catch {
+      // 忽略存储失败（隐私模式等）。
+    }
+  }, [conversationWidth]);
+
+  return {
+    conversationWidth,
+    setConversationWidth,
+    nudgeConversationWidth,
+    clampConversationWidth,
+    isNarrow,
+    narrowView,
+    setNarrowView,
+    focusMode,
+    setFocusMode,
+    bodyRef,
+  };
+}
+
+function clampWidth(width: number, bodyWidth: number): number {
+  const dynamicMax =
+    bodyWidth > 0 ? Math.min(PANEL_MAX_WIDTH, bodyWidth - CANVAS_MIN_WIDTH) : PANEL_MAX_WIDTH;
+  const max = Math.max(PANEL_MIN_WIDTH, dynamicMax);
+  return Math.round(Math.min(max, Math.max(PANEL_MIN_WIDTH, width)));
+}
@@ -0,0 +1,42 @@
+/**
+ * 方案选择展示状态：预览（纯前端）与已选定（服务器事实）分离。
+ * 点击卡片只改 previewPlanId；「采用此方案」才触发 select API。
+ */
+
+import { useCallback, useEffect, useState } from "react";
+
+import type { ReportPlanCandidate } from "@/report-collaboration/api/types";
+
+export interface UseReportPlanSelectionResult {
+  previewPlanId: string | null;
+  /** 点击卡片/查看流程：仅切换预览，不触发任何服务器变更。 */
+  previewPlan: (planId: string) => void;
+  /** 当前画布应渲染的方案（预览 > 已选定 > 最新提案）。 */
+  effectivePlanId: string | null;
+}
+
+export function useReportPlanSelection(
+  plans: ReportPlanCandidate[],
+  selectedPlanId: string | null,
+): UseReportPlanSelectionResult {
+  const [previewPlanId, setPreviewPlanId] = useState<string | null>(null);
+
+  // 方案组更新（重新生成 / 新 revision）后清理失效预览。
+  useEffect(() => {
+    if (previewPlanId && plans.length > 0 && !plans.some((plan) => plan.id === previewPlanId)) {
+      setPreviewPlanId(null);
+    }
+  }, [plans, previewPlanId]);
+
+  const previewPlan = useCallback((planId: string) => {
+    setPreviewPlanId(planId);
+  }, []);
+
+  const effectivePlanId =
+    (previewPlanId && plans.some((plan) => plan.id === previewPlanId) ? previewPlanId : null) ??
+    selectedPlanId ??
+    plans[0]?.id ??
+    null;
+
+  return { previewPlanId, previewPlan, effectivePlanId };
+}
@@ -0,0 +1,652 @@
+"use client";
+
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { useLocation, useNavigate } from "react-router-dom";
+import type { Message } from "@langchain/langgraph-sdk";
+import { toast } from "sonner";
+import { FileText, Loader2, Sparkles } from "lucide-react";
+
+import { ArtifactsProvider } from "@/components/workspace/artifacts";
+import { ThreadContext } from "@/components/workspace/messages/context";
+import { SubtasksProvider } from "@/core/tasks/context";
+import { getReportCollaborationDriver } from "@/report-collaboration/api/driver";
+import { AgentStageSelector } from "@/report-collaboration/components/AgentStageSelector";
+import { ConnectionStatusBar } from "@/report-collaboration/components/ConnectionStatusBar";
+import { InterventionCard } from "@/report-collaboration/components/InterventionCard";
+import { NodeInspectorDrawer } from "@/report-collaboration/components/NodeInspectorDrawer";
+import { ReportCollaborationHeader } from "@/report-collaboration/components/ReportCollaborationHeader";
+import { ReportCollaborationLayout, NarrowSwitch } from "@/report-collaboration/components/ReportCollaborationLayout";
+import { ReportComposer, type ComposerTarget } from "@/report-collaboration/components/ReportComposer";
+import { ReportConversationPanel } from "@/report-collaboration/components/ReportConversationPanel";
+import { ReportFlowCanvas } from "@/report-collaboration/components/ReportFlowCanvas";
+import { ReportPlanCards } from "@/report-collaboration/components/ReportPlanCards";
+import {
+  ReportAvailableCard,
+  ReportPreviewDialog,
+} from "@/report-collaboration/components/ReportPreviewDialog";
+import { ReportSandboxOverlay } from "@/report-collaboration/components/ReportSandboxOverlay";
+import { ReportSpeakerShell } from "@/report-collaboration/components/ReportSpeakerShell";
+import { SessionHistoryPanel } from "@/report-collaboration/components/SessionHistoryPanel";
+import { useReportPanelLayout } from "@/report-collaboration/hooks/useReportPanelLayout";
+import { useReportCollaborationMessages } from "@/report-collaboration/hooks/useReportCollaborationMessages";
+import { useReportCollaborationSession, isRunActive } from "@/report-collaboration/hooks/useReportCollaborationSession";
+import { useReportPlanSelection } from "@/report-collaboration/hooks/useReportPlanSelection";
+import {
+  buildCommandConfirmCard,
+  buildPlanGroupCard,
+  buildReportAvailableCard,
+  readReportCollaborationCard,
+} from "@/report-collaboration/state/message-adapter";
+import { resolveReportSpeaker } from "@/report-collaboration/state/speaker";
+import {
+  derivePagePhase,
+  selectAgentRunForNode,
+  selectAgentTabs,
+  selectAwaitingInputNodes,
+  selectHeadReportVersion,
+  selectNodeStatusMap,
+  selectPendingConfirmationCommands,
+  selectPlanForCanvas,
+  selectPreferredParallelFocus,
+  selectStreamingAgentRunIds,
+} from "@/report-collaboration/state/selectors";
+import { buildBaseStreamFacade } from "@/report-collaboration/state/message-adapter";
+
+const NEW_SESSION_THREAD = buildBaseStreamFacade([], false);
+
+/** 左侧 Tab：对话 / 历史。 */
+function ConversationSidebarTabs({
+  conversation,
+  history,
+}: {
+  conversation: React.ReactNode;
+  history: React.ReactNode;
+}) {
+  const [tab, setTab] = useState<"conversation" | "history">("conversation");
+  return (
+    <div className="flex min-h-0 flex-1 flex-col">
+      <div className="rc-tabs" role="tablist" aria-label="左侧面板">
+        <button type="button" role="tab" className="rc-tab" data-active={tab === "conversation"} onClick={() => setTab("conversation")}>
+          对话
+        </button>
+        <button type="button" role="tab" className="rc-tab" data-active={tab === "history"} onClick={() => setTab("history")}>
+          历史
+        </button>
+      </div>
+      {tab === "conversation" ? conversation : history}
+    </div>
+  );
+}
+
+/**
+ * 新会话入口页（无 sessionId）：空态 + 输入需求后创建会话并跳转，
+ * 首条消息通过 location.state 传递，由会话页发送（避免竞态）。
+ */
+export default function ReportCollaborationPage() {
+  const navigate = useNavigate();
+  const layout = useReportPanelLayout();
+  const [starting, setStarting] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  const start = useCallback(
+    async (text: string) => {
+      setStarting(true);
+      setError(null);
+      try {
+        const created = await getReportCollaborationDriver().createSession();
+        navigate(`/page/workspace/report-collaboration/${created.id}`, {
+          state: { rcInitialMessage: text },
+        });
+      } catch (err) {
+        setError(err instanceof Error ? err.message : String(err));
+      } finally {
+        setStarting(false);
+      }
+    },
+    [navigate],
+  );
+
+  return (
+    <ArtifactsProvider>
+    <ReportCollaborationLayout
+      layout={layout}
+      header={
+        <ReportCollaborationHeader
+          title="新会话"
+          phase="empty"
+          onBack={() => navigate("/page/workspace/chats/new")}
+          onNewSession={() => navigate("/page/workspace/report-collaboration")}
+          onOpenReport={() => undefined}
+          hasReport={false}
+          running={false}
+          onCancelRun={() => undefined}
+        />
+      }
+      conversation={
+        <ReportConversationPanel
+          sessionId="rc-new"
+          thread={NEW_SESSION_THREAD}
+          businessCardSlot={() => null}
+          loading={false}
+          emptyHint={
+            <div className="flex flex-col items-center gap-3">
+              <Sparkles className="size-10 opacity-40" style={{ color: "var(--rc-accent)" }} aria-hidden />
+              <p className="text-[14px] font-semibold">描述你的报告需求</p>
+              <p className="max-w-72 text-[12px] leading-5">
+                系统会先澄清关键信息，然后给出 2～3 个候选协作方案；
+                确认方案后多智能体团队开始检索、核验、分析与写作，全过程可在对话中干预。
+              </p>
+              {error ? (
+                <p className="text-[12px]" style={{ color: "var(--rc-danger)" }}>
+                  {error}
+                </p>
+              ) : null}
+            </div>
+          }
+          composer={
+            <ReportComposer
+              phase="empty"
+              busy={starting}
+              target={null}
+              onClearTarget={() => undefined}
+              onSend={(text) => void start(text)}
+              focusSignal={0}
+            />
+          }
+        />
+      }
+      canvas={<ReportFlowCanvas plan={null} nodeStates={{}} selectedNodeId={null} onSelectNode={() => undefined} />}
+      statusBar={<ConnectionStatusBar status="idle" runId={null} lastSeq={0} />}
+    />
+    </ArtifactsProvider>
+  );
+}
+
+/** 会话页：左对话（复用 MessageList）/ 右画布 / 节点抽屉 / 报告预览。 */
+export function ReportCollaborationSessionPage({ sessionId }: { sessionId: string }) {
+  const navigate = useNavigate();
+  const location = useLocation();
+  const session = useReportCollaborationSession(sessionId);
+  const { state } = session;
+  const layout = useReportPanelLayout();
+
+  const phase = useMemo(() => derivePagePhase(state), [state]);
+  const agentTabs = useMemo(() => selectAgentTabs(state), [state]);
+  const [focusedAgentRunId, setFocusedAgentRunId] = useState<string | null>(null);
+  const [focusPinned, setFocusPinned] = useState(false);
+  const tabIds = useMemo(() => new Set(agentTabs.map((tab) => tab.agent_run_id)), [agentTabs]);
+  const pinnedAgent =
+    focusPinned && focusedAgentRunId && !tabIds.has(focusedAgentRunId)
+      ? (state.agentRuns[focusedAgentRunId] ?? null)
+      : null;
+  const effectiveFocus =
+    focusPinned && focusedAgentRunId && state.agentRuns[focusedAgentRunId]
+      ? focusedAgentRunId
+      : agentTabs.length === 0
+        ? null
+        : focusedAgentRunId && tabIds.has(focusedAgentRunId)
+          ? focusedAgentRunId
+          : agentTabs[0].agent_run_id;
+  const focusedTab =
+    agentTabs.find((tab) => tab.agent_run_id === effectiveFocus) ??
+    (effectiveFocus ? state.agentRuns[effectiveFocus] ?? null : null);
+
+  const { previewPlanId, previewPlan, effectivePlanId } = useReportPlanSelection(
+    state.plans,
+    state.selectedPlanId,
+  );
+  const canvasPlan = useMemo(
+    () => selectPlanForCanvas(state, previewPlanId),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [state.plans, state.planMap, state.selectedPlanId, previewPlanId],
+  );
+  void effectivePlanId;
+
+  const [selectedNodeId, setSelectedNodeId] = useState<string | null>(null);
+  const [drawerOpen, setDrawerOpen] = useState(false);
+  const [composerTarget, setComposerTarget] = useState<ComposerTarget | null>(null);
+  const [focusSignal, setFocusSignal] = useState(0);
+
+  const [previewOpen, setPreviewOpen] = useState(false);
+  const [previewVersionId, setPreviewVersionId] = useState<string | null>(null);
+  const [restoreBusy, setRestoreBusy] = useState(false);
+
+  // 新会话首条消息（location.state.rcInitialMessage），快照就绪且时间线为空时发送一次。
+  const initialSentRef = useRef(false);
+  useEffect(() => {
+    if (initialSentRef.current || !state.snapshotLoaded) return;
+    initialSentRef.current = true;
+    const initial = (location.state as { rcInitialMessage?: unknown } | null)?.rcInitialMessage;
+    if (typeof initial === "string" && initial.trim() && state.messageOrder.length === 0) {
+      void session.send(initial);
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [state.snapshotLoaded]);
+
+  // 动作错误 → toast。
+  useEffect(() => {
+    if (session.actionError) {
+      toast.error(session.actionError, { description: "操作未生效，可重试或刷新快照" });
+      session.clearActionError();
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [session.actionError]);
+
+  // 执行波次：默认落到正在输出的成员；点头像/画布后保持该成员直到该波次结束。
+  // 全部结束后若用户钉住某个节点，保留回看，不强制清回全量时间线。
+  useEffect(() => {
+    if (agentTabs.length === 0) {
+      if (!focusPinned && focusedAgentRunId) setFocusedAgentRunId(null);
+      return;
+    }
+    if (focusPinned && focusedAgentRunId && tabIds.has(focusedAgentRunId)) return;
+    if (focusPinned && focusedAgentRunId && !tabIds.has(focusedAgentRunId)) {
+      setFocusPinned(false);
+    }
+    const next = selectPreferredParallelFocus(agentTabs);
+    if (next) setFocusedAgentRunId(next);
+  }, [agentTabs, focusPinned, focusedAgentRunId, tabIds]);
+
+  // 虚拟业务卡：方案组（已出方案且 run 未开始）/ 命令确认 / 报告入口。
+  // 采用方案后卡片保留，「开始协作」按钮随选定态启用；run 开始后消失。
+  const runStarted = Boolean(state.run && state.run.plan_id);
+  const extraCards = useMemo<Message[]>(() => {
+    const cards: Message[] = [];
+    if (
+      state.plans.length > 0 &&
+      !runStarted &&
+      phase === "proposal_ready"
+    ) {
+      cards.push(
+        buildPlanGroupCard(state.plans, state.selectedPlanId, state.session?.requirement_revision ?? 1),
+      );
+    }
+    for (const command of selectPendingConfirmationCommands(state)) {
+      cards.push(buildCommandConfirmCard(command));
+    }
+    const head = selectHeadReportVersion(state);
+    if (head && (phase === "completed" || phase === "reviewing" || phase === "cancelled")) {
+      cards.push(buildReportAvailableCard(head, state.reportVersions.length));
+    }
+    return cards;
+  }, [phase, runStarted, state]);
+
+  const { displayThread } = useReportCollaborationMessages(
+    state,
+    effectiveFocus,
+    extraCards,
+    session.sendBusy,
+  );
+
+  const streamingIds = useMemo(() => selectStreamingAgentRunIds(state), [state]);
+  const awaitingIds = useMemo(() => {
+    const ids = new Set<string>();
+    for (const node of selectAwaitingInputNodes(state)) {
+      for (const agentRun of Object.values(state.agentRuns)) {
+        if (agentRun.node_run_id?.startsWith(`${node.node_id}-`)) {
+          ids.add(agentRun.agent_run_id);
+        }
+      }
+    }
+    return ids;
+  }, [state]);
+
+  const findMemberOfNode = useCallback(
+    (nodeId: string) => selectAgentRunForNode(state, nodeId),
+    [state],
+  );
+
+  const handleSelectNode = useCallback(
+    (nodeId: string | null) => {
+      setSelectedNodeId(nodeId);
+      setDrawerOpen(Boolean(nodeId));
+      if (nodeId) {
+        const member = findMemberOfNode(nodeId);
+        if (member) {
+          setFocusedAgentRunId(member.agent_run_id);
+          setFocusPinned(true);
+        }
+      }
+    },
+    [findMemberOfNode],
+  );
+
+  const handleNodeComment = useCallback(
+    (nodeId: string, nodeName: string) => {
+      const member = findMemberOfNode(nodeId);
+      setComposerTarget({ nodeId, nodeName, agentRunId: member?.agent_run_id ?? null });
+      if (member) {
+        setFocusedAgentRunId(member.agent_run_id);
+        setFocusPinned(true);
+      }
+      setDrawerOpen(false);
+      setFocusSignal((signal) => signal + 1);
+    },
+    [findMemberOfNode],
+  );
+
+  const handleRestore = useCallback(
+    async (versionId: string) => {
+      setRestoreBusy(true);
+      try {
+        await getReportCollaborationDriver().restoreReportVersion(sessionId, versionId);
+        session.refreshSnapshot();
+        toast.success("已恢复为新的头版本");
+      } catch (err) {
+        toast.error(err instanceof Error ? err.message : String(err));
+      } finally {
+        setRestoreBusy(false);
+      }
+    },
+    [sessionId, session],
+  );
+
+  // 澄清完成（协调者已写入需求版本）但还没生成过方案：给出显式「发起规划」入口。
+  const requirementReady = useMemo(
+    () =>
+      Object.values(state.messagesById).some(
+        (message) =>
+          message.role === "ai" &&
+          (message.metadata as Record<string, unknown> | null | undefined)?.ready_to_plan === true,
+      ),
+    [state.messagesById],
+  );
+  const showPlanRequestEntry =
+    state.session?.status === "clarifying" && state.plans.length === 0 && requirementReady;
+  const [planRequestBusy, setPlanRequestBusy] = useState(false);
+  const handleRequestPlans = useCallback(async () => {
+    setPlanRequestBusy(true);
+    try {
+      await getReportCollaborationDriver().requestPlans(
+        sessionId,
+        state.session?.requirement_revision ?? null,
+      );
+      await session.refreshSnapshot();
+      toast.success("已生成候选方案，可在对话中选择");
+    } catch (err) {
+      toast.error(err instanceof Error ? err.message : String(err));
+    } finally {
+      setPlanRequestBusy(false);
+    }
+  }, [sessionId, session, state.session?.requirement_revision]);
+
+  const businessCardSlot = useCallback(
+    (message: Message) => {
+      const card = readReportCollaborationCard(message);
+      if (!card) return null;
+      if (card.kind === "plan_group") {
+        return (
+          <ReportPlanCards
+            plans={card.plans}
+            selectedPlanId={card.selectedPlanId}
+            previewPlanId={previewPlanId}
+            onPreview={previewPlan}
+            onSelect={(planId) => void session.selectPlan(planId)}
+            onStart={(planId) => void session.startRun(planId)}
+            onRegenerate={() => void session.requestPlans()}
+            selectBusy={session.sendBusy}
+            startBusy={session.sendBusy}
+            regenerateBusy={false}
+          />
+        );
+      }
+      if (card.kind === "command_confirm") {
+        return (
+          <InterventionCard
+            command={card.command}
+            busy={session.sendBusy}
+            onConfirm={(commandId) => void session.confirmCommand(commandId)}
+            onCancel={(commandId) => void session.cancelCommand(commandId)}
+          />
+        );
+      }
+      if (card.kind === "report_available") {
+        return (
+          <ReportAvailableCard
+            version={card.version}
+            versionCount={card.versionCount}
+            onOpen={(versionId) => {
+              setPreviewVersionId(versionId);
+              setPreviewOpen(true);
+            }}
+          />
+        );
+      }
+      return null;
+    },
+    [previewPlan, previewPlanId, session],
+  );
+
+  const speakerShell = useCallback(
+    (messages: Message[], children: React.ReactNode) => {
+      const speaker = resolveReportSpeaker(messages, state.agentRuns);
+      if (!speaker) return children;
+      return (
+        <ReportSpeakerShell
+          speaker={speaker}
+          avatarSelected={Boolean(speaker.agentRunId) && effectiveFocus === speaker.agentRunId}
+          onAvatarClick={(agentRunId) => {
+            if (focusPinned && effectiveFocus === agentRunId) {
+              setFocusedAgentRunId(null);
+              setFocusPinned(false);
+              return;
+            }
+            setFocusedAgentRunId(agentRunId);
+            setFocusPinned(true);
+          }}
+        >
+          {children}
+        </ReportSpeakerShell>
+      );
+    },
+    [effectiveFocus, focusPinned, state.agentRuns],
+  );
+
+  const runActive = isRunActive(state.run?.status);
+  const headVersion = selectHeadReportVersion(state);
+  const nodeStates = selectNodeStatusMap(state);
+  const selectedPlanNode = canvasPlan?.nodes.find((node) => node.id === selectedNodeId) ?? null;
+  const outgoingIds = new Set(canvasPlan?.edges.filter((edge) => edge.source === selectedNodeId).map((edge) => edge.target) ?? []);
+  const drawerFallback = selectedNodeId
+    ? {
+        label: state.nodes[selectedNodeId]?.label ?? selectedPlanNode?.label ?? selectedNodeId,
+        status: state.nodes[selectedNodeId]?.status ?? "planned",
+        role: state.nodes[selectedNodeId]?.role_display_name ?? selectedPlanNode?.role_display_name ?? null,
+        angle: state.nodes[selectedNodeId]?.angle ?? selectedPlanNode?.angle ?? null,
+        kind: (selectedPlanNode && selectedPlanNode.depends_on.length === 0
+          ? "start"
+          : outgoingIds.size > 0
+            ? "agent"
+            : "end") as "start" | "agent" | "end",
+        mission: selectedPlanNode?.mission ?? null,
+        input_artifact_types: selectedPlanNode?.input_artifact_types ?? [],
+        output_artifact_type: selectedPlanNode?.output_artifact_type ?? null,
+        allowed_tools: selectedPlanNode?.allowed_tools ?? [],
+        acceptance_criteria: selectedPlanNode?.acceptance_criteria ?? [],
+        upstream: selectedPlanNode?.depends_on ?? [],
+        downstream: canvasPlan?.edges.filter((edge) => edge.source === selectedNodeId).map((edge) => edge.target) ?? [],
+      }
+    : null;
+
+  if (session.snapshotError && !state.snapshotLoaded) {
+    return (
+      <ReportCollaborationLayout
+        layout={layout}
+        header={
+          <ReportCollaborationHeader
+            title="会话不可用"
+            phase="empty"
+            onBack={() => navigate("/page/workspace/report-collaboration")}
+            onNewSession={() => navigate("/page/workspace/report-collaboration")}
+            onOpenReport={() => undefined}
+            hasReport={false}
+            running={false}
+            onCancelRun={() => undefined}
+          />
+        }
+        conversation={
+          <div className="rc-empty">
+            <FileText className="size-8 opacity-30" aria-hidden />
+            <p>{session.snapshotError}</p>
+            <button type="button" className="rc-btn" onClick={() => navigate("/page/workspace/report-collaboration")}>
+              返回新建会话
+            </button>
+          </div>
+        }
+        canvas={<ReportFlowCanvas plan={null} nodeStates={{}} selectedNodeId={null} onSelectNode={() => undefined} />}
+        statusBar={<ConnectionStatusBar status="idle" runId={null} lastSeq={0} />}
+      />
+    );
+  }
+
+  return (
+    <SubtasksProvider>
+      <ArtifactsProvider>
+        <ThreadContext.Provider value={{ thread: displayThread, isMock: true }}>
+          <ReportCollaborationLayout
+            layout={layout}
+            header={
+              <ReportCollaborationHeader
+                title={state.session?.title ?? "报告协作"}
+                phase={phase}
+                onBack={() => navigate("/page/workspace/chats/new")}
+                onNewSession={() => navigate("/page/workspace/report-collaboration")}
+                onOpenReport={() => {
+                  if (headVersion) {
+                    setPreviewVersionId(headVersion.id);
+                    setPreviewOpen(true);
+                  }
+                }}
+                hasReport={Boolean(headVersion)}
+                running={runActive}
+                onCancelRun={() => void session.cancelRun()}
+                extra={
+                  layout.isNarrow ? (
+                    <NarrowSwitch narrowView={layout.narrowView} setNarrowView={layout.setNarrowView} />
+                  ) : null
+                }
+              />
+            }
+            conversation={
+              <ConversationSidebarTabs
+                conversation={
+                  <ReportConversationPanel
+                    sessionId={sessionId}
+                    thread={displayThread}
+                    businessCardSlot={businessCardSlot}
+                    speakerShell={speakerShell}
+                    listKey={effectiveFocus ?? "timeline"}
+                    loading={session.snapshotLoading}
+                    stageSelector={
+                      <AgentStageSelector
+                        tabs={agentTabs}
+                        pinnedAgent={pinnedAgent}
+                        phaseLabel={
+                          agentTabs.length > 1
+                            ? `并行 ${agentTabs.length} 席`
+                            : focusedTab?.display_name ?? (agentTabs[0]?.display_name ?? null)
+                        }
+                        focusedAgentRunId={effectiveFocus}
+                        onFocus={(agentRunId) => {
+                          setFocusedAgentRunId(agentRunId);
+                          setFocusPinned(true);
+                        }}
+                        onShowAll={() => {
+                          setFocusedAgentRunId(null);
+                          setFocusPinned(false);
+                        }}
+                        streamingAgentRunIds={streamingIds}
+                        awaitingAgentRunIds={awaitingIds}
+                      />
+                    }
+                    emptyHint={
+                      effectiveFocus
+                        ? `${focusedTab?.display_name ?? "智能体"}正在执行，输出会出现在这里`
+                        : undefined
+                    }
+                    composer={
+                      <div className="flex flex-col">
+                        {showPlanRequestEntry ? (
+                          <div className="mb-1.5 flex justify-center">
+                            <button
+                              type="button"
+                              className="rc-btn"
+                              style={{
+                                background: "var(--rc-accent)",
+                                color: "#fff",
+                                borderColor: "var(--rc-accent)",
+                              }}
+                              disabled={planRequestBusy}
+                              onClick={() => void handleRequestPlans()}
+                            >
+                              {planRequestBusy ? (
+                                <Loader2 className="rc-spin size-3.5" aria-hidden />
+                              ) : (
+                                <Sparkles className="size-3.5" aria-hidden />
+                              )}
+                              {planRequestBusy ? "正在生成候选方案…" : "需求已就绪，生成候选方案"}
+                            </button>
+                          </div>
+                        ) : null}
+                        <ReportComposer
+                          phase={phase}
+                          busy={session.sendBusy}
+                          target={composerTarget}
+                          onClearTarget={() => setComposerTarget(null)}
+                          onSend={(text) =>
+                            void session.send(text, {
+                              nodeId: composerTarget?.nodeId ?? null,
+                              agentRunId: composerTarget?.agentRunId ?? null,
+                            })
+                          }
+                          focusSignal={focusSignal}
+                        />
+                      </div>
+                    }
+                  />
+                }
+                history={<SessionHistoryPanel activeSessionId={sessionId} />}
+              />
+            }
+            canvas={
+              <>
+                <ReportFlowCanvas
+                  plan={canvasPlan}
+                  nodeStates={nodeStates}
+                  selectedNodeId={selectedNodeId}
+                  onSelectNode={handleSelectNode}
+                />
+                <NodeInspectorDrawer
+                  open={drawerOpen}
+                  nodeId={selectedNodeId}
+                  runId={state.run?.id ?? state.session?.active_run_id ?? null}
+                  fallback={drawerFallback}
+                  onClose={() => setDrawerOpen(false)}
+                  onComment={handleNodeComment}
+                />
+                <ReportSandboxOverlay threadId={sessionId} />
+              </>
+            }
+            statusBar={
+              <ConnectionStatusBar
+                status={session.streamStatus.status}
+                runId={state.run?.id ?? null}
+                lastSeq={state.lastSeq}
+                message={session.streamStatus.message}
+              />
+            }
+          />
+          <ReportPreviewDialog
+            open={previewOpen}
+            onClose={() => setPreviewOpen(false)}
+            versions={state.reportVersions}
+            activeVersionId={previewVersionId}
+            onSelectVersion={setPreviewVersionId}
+            onRestore={(versionId) => void handleRestore(versionId)}
+            restoreBusy={restoreBusy}
+          />
+        </ThreadContext.Provider>
+      </ArtifactsProvider>
+    </SubtasksProvider>
+  );
+}
@@ -0,0 +1,85 @@
+/**
+ * SSE / REST 事件包的防御性归一化： malformed 帧静默丢弃，不进入 reducer。
+ */
+
+import type { CollaborationEvent, CollaborationEventType } from "@/report-collaboration/api/types";
+
+const KNOWN_EVENT_TYPES = new Set<string>([
+  "session.snapshot",
+  "message.created",
+  "message.delta",
+  "message.completed",
+  "tool_call.created",
+  "tool_call.delta",
+  "tool_call.completed",
+  "tool_result.created",
+  "tool_result.delta",
+  "tool_result.completed",
+  "team_message.created",
+  "team_message.delta",
+  "team_message.completed",
+  "requirement.updated",
+  "clarification.requested",
+  "clarification.resolved",
+  "plan.progress",
+  "plan.proposed",
+  "plan.selected",
+  "run.status.changed",
+  "node.created",
+  "node.status.changed",
+  "node.progress",
+  "node.attempt.created",
+  "artifact.created",
+  "artifact.validated",
+  "artifact.rejected",
+  "source.added",
+  "command.classified",
+  "command.confirmation.required",
+  "command.accepted",
+  "command.completed",
+  "command.failed",
+  "command.cancelled",
+  "report.delta",
+  "report.version.created",
+  "review.created",
+  "error",
+  "heartbeat",
+]);
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+/**
+ * 校验并归一化一个事件包。返回 null 表示丢弃（结构非法）。
+ * 未知 `type` 保留透传（前向兼容：新事件类型不应导致旧前端崩溃），
+ * 但 seq/sessionId 必须合法。
+ */
+export function normalizeCollaborationEvent(raw: unknown): CollaborationEvent | null {
+  if (!isRecord(raw)) return null;
+  const eventId = raw.eventId ?? raw.event_id;
+  const sessionId = raw.sessionId ?? raw.session_id;
+  const runId = raw.runId ?? raw.run_id;
+  const seq = raw.seq;
+  const type = raw.type;
+  const timestamp = raw.timestamp;
+  if (typeof eventId !== "string" || eventId === "") return null;
+  if (typeof sessionId !== "string" || sessionId === "") return null;
+  if (typeof seq !== "number" || !Number.isFinite(seq) || seq < 0) return null;
+  if (typeof type !== "string" || type === "") return null;
+
+  return {
+    eventId,
+    sessionId,
+    runId: typeof runId === "string" ? runId : null,
+    seq,
+    type: (KNOWN_EVENT_TYPES.has(type) ? type : type) as CollaborationEventType,
+    timestamp: typeof timestamp === "string" ? timestamp : new Date().toISOString(),
+    data: raw.data ?? {},
+  };
+}
+
+/** 是否为已知业务事件类型（用于状态栏与测试）。 */
+export function isKnownEventType(type: string): boolean {
+  return KNOWN_EVENT_TYPES.has(type);
+}
@@ -0,0 +1,273 @@
+/**
+ * 无损协议适配：CollaborationMessage → LangGraph SDK Message + BaseStream 外观。
+ *
+ * 规则（FE-5）：
+ * - 一对一映射，不概括文本、不吞工具结果。
+ * - 工具调用挂在所属 ai 消息的 `tool_calls`；返回为 `tool` 消息，`tool_call_id`
+ *   严格配对（现有 MessageGroup 直接渲染）。
+ * - AgentScope 归属写入 `additional_kwargs.report_collaboration`。
+ * - 业务卡（方案组 / 命令确认 / 报告入口）为**前端派生的虚拟 ai 消息**，经
+ *   MessageList 的通用业务卡插槽（`additional_kwargs.report_collaboration_card`）
+ *   渲染；未传插槽的页面零渲染。
+ */
+
+import type { Message } from "@langchain/langgraph-sdk";
+import type { BaseStream } from "@langchain/langgraph-sdk/react";
+
+import type { AgentThreadState } from "@/core/threads";
+
+import type {
+  AgentRun,
+  CollaborationCommand,
+  CollaborationMessage,
+  ReportPlanCandidate,
+  ReportVersion,
+} from "@/report-collaboration/api/types";
+
+/** 报告在沙箱中的虚拟路径，对齐问答页 write_file / 深度研究 stub。 */
+export const REPORT_OUTPUT_PATH = "/mnt/user-data/outputs/report.md";
+
+// ── 归属标记 ─────────────────────────────────────────────────────────────────
+
+export interface ReportCollaborationKwargs {
+  agentRunId?: string;
+  nodeRunId?: string;
+  phaseId?: string;
+  /** 消息创建时间，供会商式说话人行展示。 */
+  createdAt?: string;
+  /** 前端乐观消息（尚未被服务器确认）。 */
+  optimistic?: boolean;
+}
+
+export function collaborationKwargs(message: CollaborationMessage): ReportCollaborationKwargs {
+  const kwargs: ReportCollaborationKwargs = {};
+  if (message.agent_run_id) kwargs.agentRunId = message.agent_run_id;
+  if (message.node_run_id) kwargs.nodeRunId = message.node_run_id;
+  if (message.phase_id) kwargs.phaseId = message.phase_id;
+  if (message.created_at) kwargs.createdAt = message.created_at;
+  return kwargs;
+}
+
+// ── 一对一映射 ───────────────────────────────────────────────────────────────
+
+export function toLangGraphMessage(message: CollaborationMessage): Message {
+  const additional_kwargs: Record<string, unknown> = {};
+  const rc = collaborationKwargs(message);
+  if (Object.keys(rc).length > 0) {
+    additional_kwargs.report_collaboration = rc;
+  }
+
+  if (message.role === "human") {
+    return {
+      id: message.message_id,
+      type: "human",
+      content: message.content,
+      additional_kwargs,
+    } as unknown as Message;
+  }
+
+  if (message.role === "tool") {
+    return {
+      id: message.message_id,
+      type: "tool",
+      content: message.content,
+      name: message.name ?? undefined,
+      tool_call_id: message.tool_call_id ?? "",
+      additional_kwargs,
+    } as unknown as Message;
+  }
+
+  // 思考过程：与问答页 additional_kwargs.reasoning_content 对齐，供 MessageGroup CoT 渲染。
+  const reasoning = message.metadata?.reasoning_content;
+  if (typeof reasoning === "string" && reasoning.length > 0) {
+    additional_kwargs.reasoning_content = reasoning;
+  }
+
+  // ai：tool_calls 原样透传（args 流式期间为部分 JSON 字符串）。
+  return {
+    id: message.message_id,
+    type: "ai",
+    content: message.content,
+    name: message.name ?? undefined,
+    tool_calls: message.tool_calls?.length
+      ? message.tool_calls.map((call) => ({
+          id: call.id,
+          name: call.name,
+          args: call.args,
+        }))
+      : undefined,
+    additional_kwargs,
+  } as unknown as Message;
+}
+
+export function toLangGraphMessages(messages: CollaborationMessage[]): Message[] {
+  return messages.map(toLangGraphMessage);
+}
+
+// ── 虚拟业务卡 ───────────────────────────────────────────────────────────────
+
+export type ReportCollaborationCardPayload =
+  | {
+      kind: "plan_group";
+      plans: ReportPlanCandidate[];
+      selectedPlanId: string | null;
+      requirementRevision: number;
+    }
+  | {
+      kind: "command_confirm";
+      command: CollaborationCommand;
+    }
+  | {
+      kind: "report_available";
+      version: ReportVersion;
+      versionCount: number;
+    };
+
+export function hasReportCollaborationCard(message: Message): boolean {
+  return (
+    message.type === "ai" &&
+    typeof (message.additional_kwargs as Record<string, unknown> | undefined)
+      ?.report_collaboration_card === "object"
+  );
+}
+
+export function readReportCollaborationCard(
+  message: Message,
+): ReportCollaborationCardPayload | null {
+  const payload = (message.additional_kwargs as Record<string, unknown> | undefined)
+    ?.report_collaboration_card;
+  return (payload as ReportCollaborationCardPayload) ?? null;
+}
+
+function buildCardMessage(id: string, payload: ReportCollaborationCardPayload): Message {
+  return {
+    id,
+    type: "ai",
+    content: "",
+    additional_kwargs: { report_collaboration_card: payload },
+  } as unknown as Message;
+}
+
+/** 方案组卡（proposal_ready 时注入时间线，点击预览 / 确认后执行）。 */
+export function buildPlanGroupCard(
+  plans: ReportPlanCandidate[],
+  selectedPlanId: string | null,
+  requirementRevision: number,
+): Message {
+  const groupId = plans[0]?.proposal_group_id ?? "plans";
+  return buildCardMessage(`rc-card-plans-${groupId}-r${requirementRevision}`, {
+    kind: "plan_group",
+    plans,
+    selectedPlanId,
+    requirementRevision,
+  });
+}
+
+/** 命令确认卡（command.confirmation.required 之后）。 */
+export function buildCommandConfirmCard(command: CollaborationCommand): Message {
+  return buildCardMessage(`rc-card-confirm-${command.command_id}`, {
+    kind: "command_confirm",
+    command,
+  });
+}
+
+/** 报告入口卡（正式版本落库后）。 */
+export function buildReportAvailableCard(version: ReportVersion, versionCount: number): Message {
+  return buildCardMessage(`rc-card-report-${version.id}`, {
+    kind: "report_available",
+    version,
+    versionCount,
+  });
+}
+
+export interface ReportWriteFileSource {
+  sessionId: string;
+  markdown: string;
+  writing: boolean;
+  writer?: AgentRun | null;
+}
+
+/**
+ * 把 report.delta / 正式版本投影成原生 write_file 消息，让 MessageList
+ * 步骤条和 ArtifactFileDetail 沙箱走与问答页相同的渲染路径。
+ */
+export function buildReportWriteFileMessages(source: ReportWriteFileSource): Message[] {
+  const { markdown, writing, writer } = source;
+  if (!writing && !markdown) return [];
+
+  const sessionId = source.sessionId || "session";
+  const messageId = `rc-write-${sessionId}-report`;
+  const toolCallId = `${messageId}-file`;
+  const additional_kwargs: Record<string, unknown> = {};
+  if (writer) {
+    additional_kwargs.report_collaboration = {
+      agentRunId: writer.agent_run_id,
+      nodeRunId: writer.node_run_id ?? undefined,
+      phaseId: writer.phase_id ?? undefined,
+      createdAt: writer.started_at ?? undefined,
+    };
+  }
+
+  const aiMessage = {
+    id: messageId,
+    type: "ai" as const,
+    content: "",
+    name: writer?.display_name ?? "撰写员",
+    tool_calls: [
+      {
+        id: toolCallId,
+        name: "write_file",
+        args: { path: REPORT_OUTPUT_PATH, content: markdown },
+      },
+    ],
+    additional_kwargs,
+  } as unknown as Message;
+
+  if (writing) return [aiMessage];
+
+  const toolResult = {
+    id: `${toolCallId}-result`,
+    type: "tool" as const,
+    name: "write_file",
+    tool_call_id: toolCallId,
+    content: "ok",
+    additional_kwargs,
+  } as unknown as Message;
+  return [aiMessage, toolResult];
+}
+
+/** 注入的 write_file 行在聚焦某成员时只保留撰写员自己的。 */
+export function reportWriteFileBelongsToFocus(
+  messages: Message[],
+  focusedAgentRunId: string | null,
+): Message[] {
+  if (!focusedAgentRunId) return messages;
+  return messages.filter((message) => {
+    const kwargs = (message.additional_kwargs as Record<string, unknown> | undefined)
+      ?.report_collaboration as { agentRunId?: string } | undefined;
+    return kwargs?.agentRunId === focusedAgentRunId;
+  });
+}
+
+// ── BaseStream 外观 ─────────────────────────────────────────────────────────
+
+/**
+ * 构造 MessageList 需要的最小 `BaseStream<AgentThreadState>`：
+ * MessageList 只读 `messages` / `isLoading` / `isThreadLoading`。
+ */
+export function buildBaseStreamFacade(
+  messages: Message[],
+  isLoading: boolean,
+): BaseStream<AgentThreadState> {
+  return {
+    messages,
+    values: { title: "", messages, artifacts: [], todos: [] },
+    isLoading,
+    isThreadLoading: false,
+    error: undefined,
+    interrupt: undefined,
+    stop: async () => undefined,
+    submit: async () => undefined,
+    joinStream: async () => undefined,
+  } as unknown as BaseStream<AgentThreadState>;
+}
@@ -0,0 +1,279 @@
+/**
+ * 状态投影 selector：从 CollaborationState 派生页面所需的视图数据。
+ * 纯函数、无副作用；并行聚焦只过滤本地消息，不改写事实。
+ */
+
+import type {
+  AgentRun,
+  CollaborationCommand,
+  CollaborationMessage,
+  CollaborationNodeState,
+  ReportPlanCandidate,
+} from "@/report-collaboration/api/types";
+import type { CollaborationState } from "@/report-collaboration/state/event-reducer";
+
+/** 用户可见消息，按时间线顺序。 */
+export function selectOrderedVisibleMessages(state: CollaborationState): CollaborationMessage[] {
+  return state.messageOrder
+    .map((id) => state.messagesById[id])
+    .filter(
+      (message): message is CollaborationMessage =>
+        Boolean(message) && message.visibility === "visible",
+    );
+}
+
+/**
+ * 并行成员聚焦：null = 全量时间线（非并行 / 单成员阶段）。
+ * 指定 agentRunId 时只保留该成员自己的消息（含指向该成员的 human），
+ * 不混入协调者、其它并行成员或更早的共享对话。
+ */
+export function selectMessagesForAgentRun(
+  messages: CollaborationMessage[],
+  focusedAgentRunId: string | null,
+): CollaborationMessage[] {
+  if (!focusedAgentRunId) return messages;
+  return messages.filter((message) => message.agent_run_id === focusedAgentRunId);
+}
+
+function isCoordinator(agentRun: AgentRun): boolean {
+  return /coord/i.test(agentRun.role) || /协调/.test(agentRun.display_name);
+}
+
+const IN_FLIGHT_AGENT_STATUS = new Set(["pending", "running", "waiting_input"]);
+const IN_FLIGHT_NODE_STATUS = new Set([
+  "queued",
+  "running",
+  "validating",
+  "awaiting_input",
+  "cancel_requested",
+  "reopened",
+]);
+const TERMINAL_NODE_STATUS = new Set(["completed", "failed", "cancelled", "superseded", "interrupted"]);
+const TERMINAL_AGENT_STATUS = new Set(["completed", "failed", "cancelled"]);
+
+function nodeForAgent(state: CollaborationState, agentRun: AgentRun): CollaborationNodeState | null {
+  const nodeRunId = agentRun.node_run_id;
+  if (!nodeRunId) return null;
+  for (const node of Object.values(state.nodes)) {
+    if (nodeRunId === node.node_id || nodeRunId.startsWith(`${node.node_id}-`)) {
+      return node;
+    }
+  }
+  return null;
+}
+
+/** 该成员是否仍在执行：节点终态优先于 agentRun.status（画布完成即结束）。 */
+export function isAgentStillExecuting(state: CollaborationState, agentRun: AgentRun): boolean {
+  const node = nodeForAgent(state, agentRun);
+  if (node) {
+    if (TERMINAL_NODE_STATUS.has(node.status)) return false;
+    if (IN_FLIGHT_NODE_STATUS.has(node.status)) return true;
+  }
+  if (TERMINAL_AGENT_STATUS.has(agentRun.status)) return false;
+  return IN_FLIGHT_AGENT_STATUS.has(agentRun.status);
+}
+
+function membersByPhase(state: CollaborationState): Map<string, AgentRun[]> {
+  const byPhase = new Map<string, AgentRun[]>();
+  for (const member of Object.values(state.agentRuns)) {
+    if (isCoordinator(member)) continue;
+    const key = member.phase_id ?? "";
+    const list = byPhase.get(key);
+    if (list) list.push(member);
+    else byPhase.set(key, [member]);
+  }
+  return byPhase;
+}
+
+function latestStartedAt(members: AgentRun[]): string {
+  return [...members].map((run) => run.started_at ?? "").sort().at(-1) ?? "";
+}
+
+/**
+ * 当前正在执行的那一波成员（不含协调者）。
+ * 同一 phase 下只要有人仍在执行就返回——单个模型节点也要露出过程；
+ * 波次结束后回到空数组，消息列表收成普通聊天记录。
+ * ≥2 人时即为并行波次；1 人时为业务链上的当前节点。
+ */
+export function selectParallelMembers(state: CollaborationState): AgentRun[] {
+  const waves = [...membersByPhase(state).entries()]
+    .map(([phaseId, list]) => ({ phaseId, list }))
+    .filter(({ list }) => list.length >= 1 && list.some((member) => isAgentStillExecuting(state, member)));
+  if (waves.length === 0) return [];
+  const currentPhase = state.run?.current_phase ?? null;
+  const chosen =
+    waves.find((wave) => wave.phaseId === currentPhase) ??
+    [...waves].sort((a, b) => latestStartedAt(b.list).localeCompare(latestStartedAt(a.list)))[0];
+  return [...chosen.list].sort((a, b) => (a.started_at ?? "").localeCompare(b.started_at ?? ""));
+}
+
+/** 头像条：当前正在执行的成员（单个模型节点或并行波次，不含协调者）。 */
+export function selectAgentTabs(state: CollaborationState): AgentRun[] {
+  return selectParallelMembers(state);
+}
+
+/** 画布节点 → 对应成员（含已完成的顺序节点，供点击后回看该节点的步骤条）。 */
+export function selectAgentRunForNode(
+  state: CollaborationState,
+  nodeId: string | null,
+): AgentRun | null {
+  if (!nodeId) return null;
+  const members = Object.values(state.agentRuns).filter((agentRun) => {
+    const nodeRunId = agentRun.node_run_id;
+    return typeof nodeRunId === "string" && (nodeRunId === nodeId || nodeRunId.startsWith(`${nodeId}-`));
+  });
+  if (members.length === 0) return null;
+  return (
+    members.find((member) => isAgentStillExecuting(state, member)) ??
+    [...members].sort((a, b) => (b.started_at ?? "").localeCompare(a.started_at ?? ""))[0]
+  );
+}
+
+/** 撰写节点对应的成员（report.delta 注入 write_file 时挂到该归属）。 */
+export function selectWriterAgentRun(state: CollaborationState): AgentRun | null {
+  const byRole = Object.values(state.agentRuns).find(
+    (agentRun) => /撰写|writer/i.test(agentRun.role) || /撰写/.test(agentRun.display_name),
+  );
+  if (byRole) return byRole;
+  return selectAgentRunForNode(state, "n-write");
+}
+
+/** 波次刚出现或当前聚焦已失效时，优先落到正在输出的成员。 */
+export function selectPreferredParallelFocus(
+  members: AgentRun[],
+  streamingIds: Set<string> = new Set(),
+): string | null {
+  if (members.length === 0) return null;
+  const preferred =
+    members.find((member) => member.status === "running" || streamingIds.has(member.agent_run_id)) ??
+    members.find((member) => member.status === "waiting_input") ??
+    members[0];
+  return preferred.agent_run_id;
+}
+
+/**
+ * 并行结束后把同一波次各成员的消息收成连续块，好让 MessageList
+ * 把每个智能体当成一条普通聊天记录（对齐会商第二步收起并行后的列表）。
+ */
+export function stitchParallelAgentBlocks(
+  messages: CollaborationMessage[],
+  state: CollaborationState,
+): CollaborationMessage[] {
+  const phases = [...membersByPhase(state).entries()].filter(([, list]) => list.length >= 2);
+  if (phases.length === 0) return messages;
+
+  const phaseOfAgent = new Map<string, string>();
+  const agentsOfPhase = new Map<string, AgentRun[]>();
+  for (const [phaseId, list] of phases) {
+    const ordered = [...list].sort((a, b) => (a.started_at ?? "").localeCompare(b.started_at ?? ""));
+    agentsOfPhase.set(phaseId, ordered);
+    for (const member of ordered) {
+      phaseOfAgent.set(member.agent_run_id, phaseId);
+    }
+  }
+
+  const flushed = new Set<string>();
+  const result: CollaborationMessage[] = [];
+  for (const message of messages) {
+    const phaseId = message.agent_run_id ? phaseOfAgent.get(message.agent_run_id) : undefined;
+    if (!phaseId) {
+      result.push(message);
+      continue;
+    }
+    if (flushed.has(phaseId)) continue;
+    flushed.add(phaseId);
+    for (const member of agentsOfPhase.get(phaseId) ?? []) {
+      for (const item of messages) {
+        if (item.agent_run_id === member.agent_run_id) result.push(item);
+      }
+    }
+  }
+  return result;
+}
+
+/** 会话时间线：并行执行中按成员过滤；结束后拼成普通聊天记录。 */
+export function selectConversationMessages(
+  state: CollaborationState,
+  focusedAgentRunId: string | null,
+): CollaborationMessage[] {
+  const visible = selectOrderedVisibleMessages(state);
+  if (focusedAgentRunId) return selectMessagesForAgentRun(visible, focusedAgentRunId);
+  return stitchParallelAgentBlocks(visible, state);
+}
+
+/** 画布用计划：预览 > 已选定 > 最新提案组第一张。 */
+export function selectPlanForCanvas(
+  state: CollaborationState,
+  previewPlanId: string | null,
+): ReportPlanCandidate | null {
+  if (previewPlanId && state.planMap[previewPlanId]) {
+    return state.planMap[previewPlanId];
+  }
+  if (state.selectedPlanId && state.planMap[state.selectedPlanId]) {
+    return state.planMap[state.selectedPlanId];
+  }
+  return state.plans.find((plan) => plan.validation?.ok !== false) ?? state.plans[0] ?? null;
+}
+
+/** 运行态节点状态映射（plan 节点 id -> run 节点状态）。 */
+export function selectNodeStatusMap(state: CollaborationState): Record<string, CollaborationNodeState> {
+  return state.nodes;
+}
+
+export type PagePhase =
+  | "empty"
+  | "clarifying"
+  | "planning"
+  | "proposal_ready"
+  | "running"
+  | "awaiting_input"
+  | "reviewing"
+  | "completed"
+  | "failed"
+  | "cancelled";
+
+/** 页面主状态：服务器 session 状态为事实源；awaiting_input 节点细化 running。 */
+export function derivePagePhase(state: CollaborationState): PagePhase {
+  const status = state.session?.status;
+  if (!status) return "empty";
+  if (status === "running" && Object.values(state.nodes).some((n) => n.status === "awaiting_input")) {
+    return "awaiting_input";
+  }
+  return status;
+}
+
+/** 待用户确认的命令（高成本 / 低置信度）。 */
+export function selectPendingConfirmationCommands(state: CollaborationState): CollaborationCommand[] {
+  return state.commandOrder
+    .map((id) => state.commands[id])
+    .filter(
+      (command): command is CollaborationCommand =>
+        Boolean(command) && command.status === "confirmation_required",
+    );
+}
+
+export function selectAwaitingInputNodes(state: CollaborationState): CollaborationNodeState[] {
+  return Object.values(state.nodes).filter((node) => node.status === "awaiting_input");
+}
+
+export function selectHeadReportVersion(state: CollaborationState) {
+  const marked = state.reportVersions.find((version) => version.is_head);
+  return marked ?? state.reportVersions.at(-1) ?? null;
+}
+
+/** 正在流式输出（未完成）的成员消息计数，用于标签上的「回复中」状态。 */
+export function selectStreamingAgentRunIds(state: CollaborationState): Set<string> {
+  const ids = new Set<string>();
+  for (const id of state.messageOrder) {
+    const message = state.messagesById[id];
+    if (
+      message &&
+      message.role !== "human" &&
+      message.agent_run_id &&
+      !message.completed_at
+    ) {
+      ids.add(message.agent_run_id);
+    }
+  }
+  return ids;
+}
@@ -0,0 +1,65 @@
+/**
+ * 把协作消息投影成会商第二步气泡的说话人身份（头像色 + 席位名）。
+ * MessageList 本身不展示 `message.name`，报告协作页用这一层补上。
+ */
+
+import type { Message } from "@langchain/langgraph-sdk";
+
+import type { AgentRun } from "@/report-collaboration/api/types";
+import type { ReportCollaborationKwargs } from "@/report-collaboration/state/message-adapter";
+import { FALLBACK_AVATAR_TYPES } from "@/roundtable-planning/lib/roundtable-constants";
+
+export interface ReportSpeaker {
+  name: string;
+  role?: string;
+  avatarType: string;
+  agentRunId?: string;
+  time: string;
+}
+
+function readKwargs(message: Message): ReportCollaborationKwargs | undefined {
+  const raw = (message.additional_kwargs as Record<string, unknown> | undefined)
+    ?.report_collaboration;
+  if (!raw || typeof raw !== "object") return undefined;
+  return raw as ReportCollaborationKwargs;
+}
+
+function hashAvatarType(seed: string): string {
+  let hash = 0;
+  for (let i = 0; i < seed.length; i += 1) {
+    hash = (hash * 31 + seed.charCodeAt(i)) >>> 0;
+  }
+  return FALLBACK_AVATAR_TYPES[hash % FALLBACK_AVATAR_TYPES.length];
+}
+
+function formatSpeakerTime(iso?: string): string {
+  if (!iso) return "";
+  const date = new Date(iso);
+  if (Number.isNaN(date.getTime())) return "";
+  return date.toLocaleTimeString("zh-CN", { hour12: false });
+}
+
+export function resolveReportSpeaker(
+  messages: Message[],
+  agentRuns: Record<string, AgentRun>,
+): ReportSpeaker | null {
+  const owner = messages.find((message) => message.type === "ai");
+  if (!owner) return null;
+  const kwargs = readKwargs(owner);
+  const agentRunId = kwargs?.agentRunId;
+  const run = agentRunId ? agentRuns[agentRunId] : undefined;
+  const named = typeof owner.name === "string" ? owner.name.trim() : "";
+  const name = named || run?.display_name || run?.role || "";
+  if (!name) return null;
+  const role = run?.role;
+  const seed = agentRunId || name;
+  const avatarType =
+    role === "协调者" || seed.includes("coordinator") ? "blue" : hashAvatarType(seed);
+  return {
+    name,
+    role,
+    avatarType,
+    agentRunId,
+    time: formatSpeakerTime(kwargs?.createdAt),
+  };
+}
@@ -0,0 +1,375 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import type { CollaborationEvent, SessionSnapshot } from "../api/types";
+import {
+  applyCollaborationEvents,
+  applySessionSnapshot,
+  createInitialCollaborationState,
+  hasSeqGap,
+} from "../state/event-reducer";
+
+const SESSION = "session_test";
+const RUN = "run_test";
+
+function ev(seq: number, type: CollaborationEvent["type"], data: unknown): CollaborationEvent {
+  return {
+    eventId: `evt_${seq}`,
+    sessionId: SESSION,
+    runId: RUN,
+    seq,
+    type,
+    timestamp: "2026-09-02T10:00:00Z",
+    data,
+  };
+}
+
+function snapshot(overrides: Partial<SessionSnapshot> = {}): SessionSnapshot {
+  return {
+    session: {
+      id: SESSION,
+      title: "测试会话",
+      status: "empty",
+      requirement_revision: 1,
+      selected_plan_id: null,
+      active_run_id: RUN,
+      current_report_version_id: null,
+      created_at: "2026-09-02T10:00:00Z",
+      updated_at: "2026-09-02T10:00:00Z",
+    },
+    messages: [],
+    plans: [],
+    run: {
+      id: RUN,
+      session_id: SESSION,
+      plan_id: "",
+      status: "running",
+      cancel_requested: false,
+      next_event_seq: 1,
+      created_at: "2026-09-02T10:00:00Z",
+      updated_at: "2026-09-02T10:00:00Z",
+    },
+    nodes: [],
+    agent_runs: [],
+    commands: [],
+    report_versions: [],
+    last_seq: 0,
+    ...overrides,
+  };
+}
+
+test("重复事件按 seq 去重，不产生重复消息", () => {
+  let state = applySessionSnapshot(createInitialCollaborationState(SESSION), snapshot());
+  const created = ev(1, "message.created", {
+    message: {
+      message_id: "m1",
+      role: "ai",
+      content: "",
+      agent_run_id: "a1",
+      visibility: "visible",
+      created_at: "2026-09-02T10:00:01Z",
+      completed_at: null,
+    },
+  });
+  state = applyCollaborationEvents(state, [created, created]);
+  assert.equal(state.messageOrder.length, 1);
+  assert.equal(state.messagesById.m1.content, "");
+});
+
+test("message.delta 多次更新同一 messageId，completed 收尾", () => {
+  let state = applySessionSnapshot(createInitialCollaborationState(SESSION), snapshot());
+  state = applyCollaborationEvents(state, [
+    ev(1, "message.created", {
+      message: {
+        message_id: "m1",
+        role: "ai",
+        content: "",
+        agent_run_id: "a1",
+        visibility: "visible",
+        created_at: "2026-09-02T10:00:01Z",
+        completed_at: null,
+      },
+    }),
+    ev(2, "message.delta", { message_id: "m1", agent_run_id: "a1", delta: "你" }),
+    ev(3, "message.delta", { message_id: "m1", agent_run_id: "a1", delta: "好" }),
+    ev(4, "message.completed", { message_id: "m1" }),
+  ]);
+  assert.equal(state.messagesById.m1.content, "你好");
+  assert.ok(state.messagesById.m1.completed_at);
+  assert.equal(state.lastSeq, 4);
+});
+
+test("message.delta 的 reasoning_delta 累加到 metadata.reasoning_content", () => {
+  let state = applySessionSnapshot(createInitialCollaborationState(SESSION), snapshot());
+  state = applyCollaborationEvents(state, [
+    ev(1, "message.created", {
+      message: {
+        message_id: "m_think",
+        role: "ai",
+        content: "",
+        agent_run_id: "coord",
+        visibility: "visible",
+        metadata: { reasoning_content: "先" },
+        created_at: "2026-09-02T10:00:01Z",
+        completed_at: null,
+      },
+    }),
+    ev(2, "message.delta", {
+      message_id: "m_think",
+      agent_run_id: "coord",
+      delta: "",
+      reasoning_delta: "拆需求",
+    }),
+  ]);
+  assert.equal(state.messagesById.m_think.content, "");
+  assert.equal(state.messagesById.m_think.metadata?.reasoning_content, "先拆需求");
+});
+
+test("乱序事件先缓冲，缺口补齐后按序 drain", () => {
+  let state = applySessionSnapshot(createInitialCollaborationState(SESSION), snapshot());
+  // seq=2 先到 → 缓冲并出现缺口
+  state = applyCollaborationEvents(state, [
+    ev(2, "message.delta", { message_id: "m1", delta: "B" }),
+  ]);
+  assert.equal(state.messagesById.m1, undefined);
+  assert.equal(hasSeqGap(state), true);
+  // seq=1 到达 → 1、2 依序应用
+  state = applyCollaborationEvents(state, [
+    ev(1, "message.created", {
+      message: {
+        message_id: "m1",
+        role: "ai",
+        content: "A",
+        visibility: "visible",
+        created_at: "2026-09-02T10:00:01Z",
+        completed_at: null,
+      },
+    }),
+  ]);
+  assert.equal(state.messagesById.m1.content, "AB");
+  assert.equal(hasSeqGap(state), false);
+});
+
+test("工具调用挂在所属 ai 消息，返回以 tool 消息配对 tool_call_id", () => {
+  let state = applySessionSnapshot(createInitialCollaborationState(SESSION), snapshot());
+  state = applyCollaborationEvents(state, [
+    ev(1, "tool_call.created", {
+      message_id: "ai_owner",
+      agent_run_id: "a1",
+      tool_call: { id: "tc1", name: "web_search", args: "" },
+    }),
+    ev(2, "tool_call.delta", { message_id: "ai_owner", tool_call_id: "tc1", args_delta: '{"q":"' }),
+    ev(3, "tool_call.delta", { message_id: "ai_owner", tool_call_id: "tc1", args_delta: '市场"}' }),
+    ev(4, "tool_result.created", {
+      message_id: "tr1",
+      tool_call_id: "tc1",
+      name: "web_search",
+      agent_run_id: "a1",
+      content: '{"count":8}',
+    }),
+  ]);
+  const owner = state.messagesById.ai_owner;
+  assert.equal(owner.role, "ai");
+  assert.equal(owner.tool_calls?.[0].id, "tc1");
+  assert.equal(owner.tool_calls?.[0].args, '{"q":"市场"}');
+  const toolMessage = state.messagesById.tr1;
+  assert.equal(toolMessage.role, "tool");
+  assert.equal(toolMessage.tool_call_id, "tc1");
+  assert.equal(state.messageOrder[0], "ai_owner");
+  assert.equal(state.messageOrder[1], "tr1");
+  assert.ok(owner.completed_at, "工具-only 的 ai 行在 tool 返回后应收尾，避免步骤条一直转圈");
+});
+
+test("节点状态机守卫：cancelled 后晚到 completed 被忽略", () => {
+  let state = applySessionSnapshot(createInitialCollaborationState(SESSION), snapshot());
+  state = applyCollaborationEvents(state, [
+    ev(1, "node.created", {
+      node: {
+        node_id: "n1",
+        label: "研究",
+        status: "planned",
+        attempt: 0,
+        attempts: [],
+      },
+    }),
+    ev(2, "node.status.changed", { node_id: "n1", status: "running", attempt: 1 }),
+    // §5.5：running 经 cancel_requested 再到 cancelled
+    ev(3, "node.status.changed", { node_id: "n1", status: "cancel_requested", attempt: 1 }),
+    ev(4, "node.status.changed", { node_id: "n1", status: "cancelled", attempt: 1 }),
+    // 取消后的晚到输出不得改写终态
+    ev(5, "node.status.changed", { node_id: "n1", status: "validating", attempt: 1 }),
+    ev(6, "node.status.changed", { node_id: "n1", status: "completed", attempt: 1 }),
+  ]);
+  assert.equal(state.nodes.n1.status, "cancelled");
+  // completed -> reopened -> queued 合法
+  state = applyCollaborationEvents(state, [
+    ev(7, "node.status.changed", { node_id: "n2", status: "completed", attempt: 1 }),
+    ev(8, "node.status.changed", { node_id: "n2", status: "reopened", attempt: 1 }),
+    ev(9, "node.status.changed", { node_id: "n2", status: "queued", attempt: 2 }),
+  ]);
+  assert.equal(state.nodes.n2.status, "queued");
+});
+
+test("协助卡出现（awaiting_input）不等于完成；回到 queued 由状态事件驱动", () => {
+  let state = applySessionSnapshot(createInitialCollaborationState(SESSION), snapshot());
+  state = applyCollaborationEvents(state, [
+    ev(1, "node.created", {
+      node: { node_id: "n1", label: "研究", status: "running", attempt: 1, attempts: [] },
+    }),
+    ev(2, "node.status.changed", {
+      node_id: "n1",
+      status: "awaiting_input",
+      attempt: 1,
+      awaiting_input: { reason: "需要补充范围", question: "覆盖哪些品牌？" },
+    }),
+  ]);
+  assert.equal(state.nodes.n1.status, "awaiting_input");
+  assert.equal(state.nodes.n1.awaiting_input?.question, "覆盖哪些品牌？");
+  state = applyCollaborationEvents(state, [
+    ev(3, "node.status.changed", { node_id: "n1", status: "queued", attempt: 1 }),
+  ]);
+  assert.equal(state.nodes.n1.status, "queued");
+  assert.equal(state.nodes.n1.awaiting_input, null);
+});
+
+test("并行成员事件按 agentRunId 各自更新，互不影响", () => {
+  let state = applySessionSnapshot(createInitialCollaborationState(SESSION), snapshot());
+  state = applyCollaborationEvents(state, [
+    ev(1, "message.created", {
+      message: {
+        message_id: "m_market",
+        role: "ai",
+        content: "",
+        agent_run_id: "a_market",
+        visibility: "visible",
+        created_at: "t",
+        completed_at: null,
+      },
+    }),
+    ev(2, "message.created", {
+      message: {
+        message_id: "m_brand",
+        role: "ai",
+        content: "",
+        agent_run_id: "a_brand",
+        visibility: "visible",
+        created_at: "t",
+        completed_at: null,
+      },
+    }),
+    ev(3, "message.delta", { message_id: "m_market", agent_run_id: "a_market", delta: "市场" }),
+    ev(4, "message.delta", { message_id: "m_brand", agent_run_id: "a_brand", delta: "品牌" }),
+    ev(5, "message.completed", { message_id: "m_market" }),
+  ]);
+  assert.equal(state.messagesById.m_market.content, "市场");
+  assert.equal(state.messagesById.m_brand.content, "品牌");
+  assert.ok(state.messagesById.m_market.completed_at);
+  assert.equal(state.messagesById.m_brand.completed_at, null);
+});
+
+test("乐观用户消息由同 idempotency_key 的服务器镜像原地替换", () => {
+  let state = applySessionSnapshot(createInitialCollaborationState(SESSION), snapshot());
+  state = applyCollaborationEvents(state, [
+    ev(1, "message.created", {
+      message: {
+        message_id: "pending:key-1",
+        role: "human",
+        content: "写报告",
+        visibility: "visible",
+        metadata: { optimistic: true, idempotency_key: "key-1" },
+        created_at: "t",
+        completed_at: "t",
+      },
+    }),
+    ev(2, "message.created", {
+      message: {
+        message_id: "srv-1",
+        role: "human",
+        content: "写报告",
+        visibility: "visible",
+        metadata: { idempotency_key: "key-1" },
+        created_at: "t",
+        completed_at: "t",
+      },
+    }),
+  ]);
+  assert.equal(state.messageOrder.length, 1);
+  assert.equal(state.messageOrder[0], "srv-1");
+  assert.equal(state.messagesById["pending:key-1"], undefined);
+});
+
+test("其他 session / 旧 run 的晚到事件被丢弃", () => {
+  let state = applySessionSnapshot(createInitialCollaborationState(SESSION), snapshot());
+  const foreignSession = { ...ev(1, "message.created", { message: { message_id: "x" } }) };
+  foreignSession.sessionId = "session_other";
+  const foreignRun = ev(2, "message.created", {
+    message: {
+      message_id: "y",
+      role: "ai",
+      content: "",
+      visibility: "visible",
+      created_at: "t",
+      completed_at: null,
+    },
+  });
+  foreignRun.runId = "run_old";
+  state = applyCollaborationEvents(state, [foreignSession, foreignRun]);
+  assert.equal(state.messageOrder.length, 0);
+  assert.equal(state.lastSeq, 0);
+});
+
+test("plan.proposed 替换方案组；plan.selected 记录选定且不改执行", () => {
+  let state = applySessionSnapshot(createInitialCollaborationState(SESSION), snapshot());
+  const plan = {
+    id: "plan-1",
+    proposal_group_id: "g1",
+    title: "方案一",
+    strategy: "balanced_review",
+    summary: "",
+    rationale: "",
+    estimated_duration_seconds: 60,
+    estimated_cost_level: "medium" as const,
+    requirement_revision: 1,
+    roles: [],
+    nodes: [],
+    edges: [],
+    quality_gates: [],
+    report_structure_id: null,
+    validation: { ok: true, errors: [] },
+    revision: 1,
+    status: "proposed" as const,
+  };
+  state = applyCollaborationEvents(state, [ev(1, "plan.proposed", { plans: [plan] })]);
+  assert.equal(state.plans.length, 1);
+  assert.equal(state.selectedPlanId, null);
+  state = applyCollaborationEvents(state, [ev(2, "plan.selected", { plan_id: "plan-1" })]);
+  assert.equal(state.selectedPlanId, "plan-1");
+  assert.equal(state.plans[0].status, "selected");
+  assert.equal(state.run?.status, "running"); // 选择不触发执行
+});
+
+test("report.delta 累积草稿，version.created 后草稿清空", () => {
+  let state = applySessionSnapshot(createInitialCollaborationState(SESSION), snapshot());
+  state = applyCollaborationEvents(state, [
+    ev(1, "report.delta", { draft_id: "d1", delta: "# 报" }),
+    ev(2, "report.delta", { draft_id: "d1", delta: "告" }),
+  ]);
+  assert.equal(state.reportDraft?.markdown, "# 报告");
+  state = applyCollaborationEvents(state, [
+    ev(3, "report.version.created", {
+      version: {
+        id: "v1",
+        session_id: SESSION,
+        version: 1,
+        parent_version_id: null,
+        change_type: "initial",
+        markdown: "# 报告",
+        created_at: "t",
+        is_head: true,
+      },
+    }),
+  ]);
+  assert.equal(state.reportDraft, null);
+  assert.equal(state.reportVersions.length, 1);
+  assert.equal(state.session?.current_report_version_id, "v1");
+});
@@ -0,0 +1,399 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import { groupMessages } from "../../core/messages/utils";
+import {
+  buildCommandConfirmCard,
+  buildPlanGroupCard,
+  buildBaseStreamFacade,
+  buildReportWriteFileMessages,
+  REPORT_OUTPUT_PATH,
+  toLangGraphMessages,
+} from "../state/message-adapter";
+import { selectMessagesForAgentRun, selectAgentTabs, selectParallelMembers, selectConversationMessages, stitchParallelAgentBlocks } from "../state/selectors";
+import { resolveReportSpeaker } from "../state/speaker";
+import { createInitialCollaborationState } from "../state/event-reducer";
+import type { AgentRun, CollaborationMessage } from "../api/types";
+
+function human(id: string, content: string): CollaborationMessage {
+  return { message_id: id, role: "human", content, visibility: "visible", created_at: "t", completed_at: "t" };
+}
+
+function ai(id: string, agentRunId: string | null, content: string): CollaborationMessage {
+  return {
+    message_id: id,
+    role: "ai",
+    content,
+    agent_run_id: agentRunId,
+    name: agentRunId === "a_brand" ? "品牌竞争分析师" : "协调者",
+    visibility: "visible",
+    created_at: "t",
+    completed_at: null,
+  };
+}
+
+test("一对一映射：human/ai/tool 保持原文与归属标记", () => {
+  const toolMessage: CollaborationMessage = {
+    message_id: "t1",
+    role: "tool",
+    content: '{"count":8}',
+    name: "web_search",
+    tool_call_id: "tc1",
+    agent_run_id: "a_brand",
+    visibility: "visible",
+    created_at: "t",
+    completed_at: "t",
+  };
+  const messages = toLangGraphMessages([
+    human("h1", "写报告"),
+    { ...ai("a1", "a_brand", ""), tool_calls: [{ id: "tc1", name: "web_search", args: { q: "市场" } }] },
+    toolMessage,
+  ]);
+  assert.equal(messages[0].type, "human");
+  assert.equal(messages[0].content, "写报告");
+  assert.equal(messages[1].type, "ai");
+  const aiMessage = messages[1] as { tool_calls?: { id: string; name: string }[] };
+  assert.equal(aiMessage.tool_calls?.[0].name, "web_search");
+  assert.equal(messages[2].type, "tool");
+  assert.equal((messages[2] as { tool_call_id?: string }).tool_call_id, "tc1");
+  const kwargs = (messages[1] as { additional_kwargs?: Record<string, unknown> }).additional_kwargs
+    ?.report_collaboration as { agentRunId?: string } | undefined;
+  assert.equal(kwargs?.agentRunId, "a_brand");
+});
+
+test("说话人身份：优先 message.name，缺省时用 agentRun.display_name", () => {
+  const named = toLangGraphMessages([ai("a1", "a_brand", "品牌结论")])[0];
+  const fromName = resolveReportSpeaker([named], {
+    a_brand: agentRun({ agent_run_id: "a_brand", display_name: "品牌竞争分析师" }),
+  });
+  assert.equal(fromName?.name, "品牌竞争分析师");
+  assert.equal(fromName?.agentRunId, "a_brand");
+
+  const unnamed: CollaborationMessage = {
+    message_id: "a2",
+    role: "ai",
+    content: "",
+    agent_run_id: "a_verify",
+    visibility: "visible",
+    created_at: "2026-09-05T03:00:00.000Z",
+    completed_at: null,
+    tool_calls: [{ id: "tc1", name: "read_file", args: {} }],
+  };
+  const fromRun = resolveReportSpeaker(toLangGraphMessages([unnamed]), {
+    a_verify: agentRun({
+      agent_run_id: "a_verify",
+      display_name: "交叉核验",
+      role: "核验员",
+    }),
+  });
+  assert.equal(fromRun?.name, "交叉核验");
+  assert.equal(fromRun?.role, "核验员");
+});
+
+test("并行聚焦：只保留目标成员自己的消息，不混入 human / 协调者 / 其它成员", () => {
+  const messages = [
+    human("h1", "开始"),
+    ai("c1", null, "我先分派任务"),
+    ai("m1", "a_market", "市场规模结论……"),
+    ai("b1", "a_brand", "品牌竞争结论……"),
+  ];
+  const focusedBrand = selectMessagesForAgentRun(messages, "a_brand");
+  assert.deepEqual(
+    focusedBrand.map((message) => message.message_id),
+    ["b1"],
+  );
+  // null = 全量视图（单成员 / 协调者阶段）
+  assert.equal(selectMessagesForAgentRun(messages, null).length, 4);
+});
+
+function agentRun(partial: Partial<AgentRun> & Pick<AgentRun, "agent_run_id" | "display_name">): AgentRun {
+  return {
+    role: "研究员",
+    status: "running",
+    phase_id: "phase_parallel_research",
+    started_at: "2026-09-03T00:00:00Z",
+    ...partial,
+  };
+}
+
+test("头像条：同一 phase 有人仍在执行即出现，单个模型节点也会露出，不含协调者", () => {
+  const state = createInitialCollaborationState("s1");
+  state.agentRuns = {
+    coord: agentRun({
+      agent_run_id: "coord",
+      display_name: "协调者",
+      role: "协调者",
+      phase_id: "phase_coordinator",
+      status: "running",
+    }),
+    market: agentRun({ agent_run_id: "a_market", display_name: "市场分析师", started_at: "t1" }),
+    brand: agentRun({ agent_run_id: "a_brand", display_name: "品牌竞争分析师", started_at: "t2" }),
+  };
+  const tabs = selectAgentTabs(state);
+  assert.deepEqual(
+    tabs.map((tab) => tab.agent_run_id),
+    ["a_market", "a_brand"],
+  );
+  assert.equal(selectParallelMembers(state).length, 2);
+});
+
+test("头像条：业务链上的单个执行节点也会出现", () => {
+  const state = createInitialCollaborationState("s1");
+  state.agentRuns = {
+    writer: agentRun({
+      agent_run_id: "agent_run_n-write",
+      display_name: "报告撰写",
+      role: "撰写员",
+      phase_id: "phase_n-write",
+      node_run_id: "n-write-attempt1",
+      status: "running",
+    }),
+  };
+  state.nodes = {
+    "n-write": { node_id: "n-write", label: "报告撰写", status: "running", attempt: 1, attempts: [] },
+  };
+  const tabs = selectAgentTabs(state);
+  assert.equal(tabs.length, 1);
+  assert.equal(tabs[0].agent_run_id, "agent_run_n-write");
+});
+
+test("并行波次全部结束后头像条消失，消息列表恢复全量", () => {
+  const state = createInitialCollaborationState("s1");
+  state.agentRuns = {
+    market: agentRun({
+      agent_run_id: "a_market",
+      display_name: "市场分析师",
+      status: "completed",
+    }),
+    brand: agentRun({
+      agent_run_id: "a_brand",
+      display_name: "品牌竞争分析师",
+      status: "completed",
+    }),
+  };
+  assert.deepEqual(selectAgentTabs(state), []);
+});
+
+test("画布节点完成后即使 agentRun 仍为 running，也收起并行头像条", () => {
+  const state = createInitialCollaborationState("s1");
+  state.agentRuns = {
+    market: agentRun({
+      agent_run_id: "a_market",
+      display_name: "市场分析师",
+      node_run_id: "n-market-attempt1",
+    }),
+    brand: agentRun({
+      agent_run_id: "a_brand",
+      display_name: "品牌竞争分析师",
+      node_run_id: "n-brand-attempt1",
+    }),
+  };
+  state.nodes = {
+    "n-market": {
+      node_id: "n-market",
+      label: "市场",
+      status: "completed",
+      attempt: 1,
+      attempts: [],
+    },
+    "n-brand": {
+      node_id: "n-brand",
+      label: "品牌",
+      status: "completed",
+      attempt: 1,
+      attempts: [],
+    },
+  };
+  assert.deepEqual(selectAgentTabs(state), []);
+});
+
+test("并行结束后各成员消息收成连续聊天记录，不交叉穿插", () => {
+  const state = createInitialCollaborationState("s1");
+  state.agentRuns = {
+    market: agentRun({ agent_run_id: "a_market", display_name: "市场分析师", started_at: "t1", status: "completed" }),
+    brand: agentRun({ agent_run_id: "a_brand", display_name: "品牌竞争分析师", started_at: "t2", status: "completed" }),
+  };
+  const messages = [
+    human("h1", "开始"),
+    ai("c1", null, "我先分派任务"),
+    ai("m1", "a_market", "市场检索中"),
+    ai("b1", "a_brand", "品牌检索中"),
+    ai("m2", "a_market", "市场规模结论"),
+    ai("b2", "a_brand", "品牌竞争结论"),
+    ai("c2", null, "开始核验"),
+  ];
+  assert.deepEqual(
+    stitchParallelAgentBlocks(messages, state).map((message) => message.message_id),
+    ["h1", "c1", "m1", "m2", "b1", "b2", "c2"],
+  );
+  state.messageOrder = messages.map((message) => message.message_id);
+  state.messagesById = Object.fromEntries(messages.map((message) => [message.message_id, message]));
+  assert.deepEqual(
+    selectConversationMessages(state, null).map((message) => message.message_id),
+    ["h1", "c1", "m1", "m2", "b1", "b2", "c2"],
+  );
+});
+
+test("业务卡虚拟消息经 groupMessages 识别为 assistant:business-card（集中式扩展）", () => {
+  const card = buildCommandConfirmCard({
+    command_id: "cmd1",
+    idempotency_key: "k",
+    text: "重新检索",
+    intent: "research_again",
+    target_ids: [],
+    requires_confirmation: true,
+    status: "confirmation_required",
+    created_at: "t",
+  });
+  const types = groupMessages([card], (group) => group.type);
+  assert.deepEqual(types, ["assistant:business-card"]);
+});
+
+test("方案组卡可被 groupMessages 识别且不产生正文气泡", () => {
+  const card = buildPlanGroupCard(
+    [
+      {
+        id: "p1",
+        proposal_group_id: "g1",
+        title: "方案",
+        strategy: "balanced_review",
+        summary: "",
+        rationale: "",
+        estimated_duration_seconds: 1,
+        estimated_cost_level: "low",
+        requirement_revision: 1,
+        roles: [],
+        nodes: [],
+        edges: [],
+        quality_gates: [],
+        report_structure_id: null,
+        validation: { ok: true, errors: [] },
+        revision: 1,
+        status: "proposed",
+      },
+    ],
+    null,
+    1,
+  );
+  const types = groupMessages([card], (group) => group.type);
+  assert.deepEqual(types, ["assistant:business-card"]);
+});
+
+test("规划过程：思考+步骤条映射后排在方案卡之前，不是一句总结", () => {
+  const process: CollaborationMessage = {
+    message_id: "plan_process",
+    role: "ai",
+    content: "",
+    name: "协调者",
+    agent_run_id: "agent_run_coordinator",
+    visibility: "visible",
+    created_at: "t",
+    completed_at: "t",
+    tool_calls: [{ id: "tc_parse", name: "write_todos", args: { description: "解析需求要点" } }],
+  };
+  const toolResult: CollaborationMessage = {
+    message_id: "tr_parse",
+    role: "tool",
+    content: "已提取读者与角度",
+    name: "write_todos",
+    tool_call_id: "tc_parse",
+    agent_run_id: "agent_run_coordinator",
+    visibility: "visible",
+    created_at: "t",
+    completed_at: "t",
+  };
+  const thinking: CollaborationMessage = {
+    message_id: "plan_think",
+    role: "ai",
+    content: "",
+    name: "协调者",
+    agent_run_id: "agent_run_coordinator",
+    visibility: "visible",
+    created_at: "t",
+    completed_at: "t",
+    metadata: { reasoning_content: "先拆读者与覆盖范围，再装配三种策略。" },
+  };
+  const output = ai(
+    "plan_out",
+    "agent_run_coordinator",
+    "已装配均衡、深度、快速三种协作策略，下面给出方案卡。",
+  );
+  output.completed_at = "t";
+  const mapped = toLangGraphMessages([process, toolResult, thinking, output]);
+  const kwargs = (mapped[2] as { additional_kwargs?: Record<string, unknown> }).additional_kwargs;
+  assert.equal(kwargs?.reasoning_content, "先拆读者与覆盖范围，再装配三种策略。");
+  const card = buildPlanGroupCard(
+    [
+      {
+        id: "p1",
+        proposal_group_id: "g1",
+        title: "方案",
+        strategy: "balanced_review",
+        summary: "",
+        rationale: "",
+        estimated_duration_seconds: 1,
+        estimated_cost_level: "low",
+        requirement_revision: 1,
+        roles: [],
+        nodes: [],
+        edges: [],
+        quality_gates: [],
+        report_structure_id: null,
+        validation: { ok: true, errors: [] },
+        revision: 1,
+        status: "proposed",
+      },
+    ],
+    null,
+    1,
+  );
+  assert.deepEqual(groupMessages([...mapped, card], (group) => group.type), [
+    "assistant:processing",
+    "assistant",
+    "assistant:business-card",
+  ]);
+});
+
+test("BaseStream 外观提供 MessageList 所需字段", () => {
+  const thread = buildBaseStreamFacade([], true);
+  assert.deepEqual(thread.messages, []);
+  assert.equal(thread.isLoading, true);
+  assert.equal(thread.isThreadLoading, false);
+  assert.equal(typeof thread.stop, "function");
+});
+
+test("report.delta 投影为 write_file：流式中无 tool 返回，完成后补 tool 结果", () => {
+  const writing = buildReportWriteFileMessages({
+    sessionId: "s1",
+    markdown: "# 草稿",
+    writing: true,
+    writer: agentRun({
+      agent_run_id: "agent_run_n-write",
+      display_name: "报告撰写",
+      role: "撰写员",
+    }),
+  });
+  assert.equal(writing.length, 1);
+  const aiMessage = writing[0] as { type: string; tool_calls?: { name: string; args: { path: string; content: string } }[] };
+  assert.equal(aiMessage.type, "ai");
+  assert.equal(aiMessage.tool_calls?.[0].name, "write_file");
+  assert.equal(aiMessage.tool_calls?.[0].args.path, REPORT_OUTPUT_PATH);
+  assert.equal(aiMessage.tool_calls?.[0].args.content, "# 草稿");
+
+  const done = buildReportWriteFileMessages({
+    sessionId: "s1",
+    markdown: "# 正式稿",
+    writing: false,
+    writer: null,
+  });
+  assert.equal(done.length, 2);
+  assert.equal(done[1].type, "tool");
+  assert.equal((done[1] as { tool_call_id?: string }).tool_call_id, `${writing[0].id}-file`);
+});
+
+test("空草稿且未在写入时不注入 write_file", () => {
+  assert.deepEqual(
+    buildReportWriteFileMessages({ sessionId: "s1", markdown: "", writing: false }),
+    [],
+  );
+});
@@ -12,6 +12,9 @@ export type { ClarificationPayload };
 export const INTENT_AGENT_ID = "roundtable-intent";
 /** Dedicated Step 1 agent for the position-roundtable workspace. */
 export const POSITION_INTENT_AGENT_ID = "position-roundtable-intent";
+/** Dedicated Step 1 agent for the 8BF roundtable workspace (same prompt family
+ *  as `roundtable-intent`, independently tunable via the agent config UI). */
+export const EIGHTBF_INTENT_AGENT_ID = "eightbf-roundtable-intent";

 /**
 * Task-intent agent (Step 1) API. Mirror of multi-agent.ts but with a single
@@ -81,7 +81,8 @@ export interface Step1InputAreaProps {
  isSending: boolean;
  canSend: boolean;
  pendingClarification: boolean;
-  onSend: () => void;
+  /** 发送当前输入框内容；传 `overrideText` 时直接发送该文本（常用问题一键发送）。 */
+  onSend: (overrideText?: string) => void;
  onStop: () => void;
  onFollowUp: () => void;
  onSkip: () => void;
@@ -236,9 +237,12 @@ export function Step1Panel(props: Step1PanelProps) {
    setAttachedFiles((prev) => prev.filter((_, i) => i !== idx));
  };

-  const handleSend = () => {
-    if (!inputText.trim() && attachedFiles.length === 0) return;
-    onSendMessage(inputText, attachedFiles.length > 0 ? attachedFiles : undefined);
+  const handleSend = (overrideText?: string) => {
+    // overrideText：常用问题 chip 一键发送——绕过异步的输入框 state，
+    // 直接以问题全文作为本回合消息（仍共享附件与发送后的清空逻辑）。
+    const textToSend = overrideText ?? inputText;
+    if (!textToSend.trim() && attachedFiles.length === 0) return;
+    onSendMessage(textToSend, attachedFiles.length > 0 ? attachedFiles : undefined);
    handleInputTextChange("");
    setAttachedFiles([]);
  };
@@ -411,7 +415,7 @@ export function Step1Panel(props: Step1PanelProps) {
          <div className="flex items-center gap-2">
            <button
              id="send-message-btn"
-              onClick={handleSend}
+              onClick={() => handleSend()}
              disabled={isIntentSending || !intentThreadId}
              className="bg-primary text-white hover:bg-[var(--brand-900)] disabled:bg-slate-300 disabled:cursor-not-allowed text-xs font-bold px-4 py-2.5 rounded-xl flex items-center gap-1.5 transition-all shadow-[0_2px_8px_rgba(245,34,45,0.15)] active:scale-95"
            >
@@ -422,6 +422,12 @@ export interface UseStep2OrchestrationOptions {
  seatSkillDirectives?: Record<string, boolean>;
  /** Per-seat human-validation checkpoints inherited from the selected chain. */
  humanValidations?: Record<string, boolean>;
+  /**
+   * 全局「人工干预」开关（8BF 页头）：开启后第二步每走一步（链条每席位 / DAG 每 stage
+   * 完成）就暂停等待用户输入或恢复；关闭则全自动推进，与既有行为一致。与 per-seat
+   * `humanValidations` 取 OR——任一生效即在最近一步边界暂停。
+   */
+  manualIntervention?: boolean;
  /**
   * 每席位「推理深度覆盖」映射 {agentId: SeatMode | null}（沿用所选业务链条里每个席位的配置）。
   * 派活该 special 席位时按 agentId 查表，**席位覆盖优先、否则跟随链条级 `selectedMode`**：
@@ -593,6 +599,7 @@ export function useStep2Orchestration(
    selectedMode,
    seatSkillDirectives = {},
    humanValidations = {},
+    manualIntervention = false,
    seatModes = {},
    gatherFirst = false,
    orchestrationMode,
@@ -746,6 +753,9 @@ export function useStep2Orchestration(
  // 每席位技能识别强化映射（所选业务链条各席位开关）同样打到 ref，席位调用按 agentId 读最新值。
  const seatSkillDirectivesRef = useRef<Record<string, boolean>>(seatSkillDirectives);
  const humanValidationsRef = useRef<Record<string, boolean>>(humanValidations);
+  // 全局「人工干预」开关（8BF 页头）：编排循环在每个一步边界读最新值，
+  // 中途切换只影响下一次边界，不打断在途 run。
+  const manualInterventionRef = useRef<boolean>(manualIntervention);
  // 每席位推理深度覆盖映射（所选业务链条各席位 seatMode）打到 ref，席位调用按 agentId 读最新值；
  // 覆盖优先、否则跟随 selectedModeRef。
  const seatModesRef = useRef<Record<string, SeatMode | null>>(seatModes);
@@ -800,6 +810,9 @@ export function useStep2Orchestration(
  useEffect(() => {
    humanValidationsRef.current = humanValidations;
  }, [humanValidations]);
+  useEffect(() => {
+    manualInterventionRef.current = manualIntervention;
+  }, [manualIntervention]);
  useEffect(() => {
    seatModesRef.current = seatModes;
  }, [seatModes]);
@@ -1681,12 +1694,16 @@ export function useStep2Orchestration(
  );

  const pauseForHumanValidation = useCallback(
-    (continuation: HumanValidationContinuation, seatNames: string[]) => {
+    (
+      continuation: HumanValidationContinuation,
+      seatNames: string[],
+      source = "业务链条配置",
+    ) => {
      humanValidationContinuationRef.current = continuation;
      appendDialogue({
        sender: "系统",
        avatarType: "blue",
-        content: `已完成 ${seatNames.join("、")} 的输出，按业务链条配置暂停，等待人工校验。可直接点击“恢复会商”继续，或在下方输入修改意见后提交。`,
+        content: `已完成 ${seatNames.join("、")} 的输出，按${source}暂停，等待人工校验。可直接点击“恢复会商”继续，或在下方输入修改意见后提交。`,
        confidence: "等待人工校验",
      });
      setIsRoundTableRunning(false);
@@ -2793,18 +2810,27 @@ export function useStep2Orchestration(
            }
            if (!chainInvalidNames.includes(seatName)) chainInvalidNames.push(seatName);
            finishedAllSeats = false;
-            if (humanValidationsRef.current[seat.agent_id]) {
-              pauseForHumanValidation({ mode: "chain", nextSeatIndex: i }, [seatName]);
+            if (manualInterventionRef.current || humanValidationsRef.current[seat.agent_id]) {
+              pauseForHumanValidation(
+                { mode: "chain", nextSeatIndex: i },
+                [seatName],
+                manualInterventionRef.current && !humanValidationsRef.current[seat.agent_id]
+                  ? "人工干预开关"
+                  : undefined,
+              );
              break;
            }
            continue;
          }

          setConsensusPercentage(Math.min(95, Math.round(((i + 1) / total) * 90)));
-          if (humanValidationsRef.current[seat.agent_id]) {
+          if (manualInterventionRef.current || humanValidationsRef.current[seat.agent_id]) {
            pauseForHumanValidation(
              { mode: "chain", nextSeatIndex: i + 1 },
              [seatName],
+              manualInterventionRef.current && !humanValidationsRef.current[seat.agent_id]
+                ? "人工干预开关"
+                : undefined,
            );
            finishedAllSeats = false;
            break;
@@ -3237,8 +3263,11 @@ export function useStep2Orchestration(
          setConsensusPercentage(
            Math.min(95, Math.round(((s + 1) / plan.stages.length) * 90)),
          );
+          const manualInterventionOn = manualInterventionRef.current;
          const validationSeatNames = stageSeats
-            .filter(({ agentId }) => humanValidationsRef.current[agentId])
+            .filter(
+              ({ agentId }) => manualInterventionOn || humanValidationsRef.current[agentId],
+            )
            .map(({ name }) => name);
          if (validationSeatNames.length > 0) {
            pauseForHumanValidation(
@@ -3248,6 +3277,7 @@ export function useStep2Orchestration(
                priorDeliveries: [...priorDeliveries],
              },
              validationSeatNames,
+              manualInterventionOn ? "人工干预开关" : undefined,
            );
            finishedAllStages = false;
            break;