diff --git a/.codex-server-diagnose.py b/.codex-server-diagnose.py
new file mode 100644
index 00000000..0eb682ba
--- /dev/null
+++ b/.codex-server-diagnose.py
@@ -0,0 +1,20 @@
+import os
+
+import paramiko
+
+
+client = paramiko.SSHClient()
+client.set_missing_host_key_policy(paramiko.AutoAddPolicy())
+client.connect(
+    "119.254.86.251",
+    port=22322,
+    username="root",
+    password=os.environ["TARGET_SSH_PASSWORD"],
+    timeout=15,
+    auth_timeout=15,
+    banner_timeout=15,
+)
+_, stdout, stderr = client.exec_command(os.environ["TARGET_SSH_COMMAND"], timeout=30)
+print(stdout.read().decode(errors="replace"), end="")
+print(stderr.read().decode(errors="replace"), end="")
+client.close()
diff --git a/.gitignore b/.gitignore
index 444a95df..ab7a0082 100644
--- a/.gitignore
+++ b/.gitignore
@@ -83,12 +83,15 @@ offline-backend-20260512/backend/.deer-flow/*
 
 # Per-user skill_evolution overrides — runtime data written by the API
 offline-backend-20260512/backend/skill_evolution.json
-skills/
-hermes-agent-main/
+skills/
+hermes-agent-main/
 .gitignore
 offline-backend-20260512/backend/tests/*
 !offline-backend-20260512/backend/tests/test_llmwiki_weknora.py
 !offline-backend-20260512/backend/tests/test_health_auth_bypass.py
+# Keep the model configuration regression coverage versioned even though
+# this deployment repository otherwise ignores newly added backend tests.
+!offline-backend-20260512/backend/tests/test_model_management.py
 deploy
 .history
 
diff --git a/frontend-web/docs/position-roundtable-sandbox/README.md b/frontend-web/docs/position-roundtable-sandbox/README.md
new file mode 100644
index 00000000..c3679ba5
--- /dev/null
+++ b/frontend-web/docs/position-roundtable-sandbox/README.md
@@ -0,0 +1,15 @@
+# 岗位会商沙箱文档
+
+本目录存放**岗位会商文件预览沙箱**的对接与排障说明，独立于 `src/position-roundtable/docs/`，避免与模块内其它文档互相覆盖。
+
+| 文档 | 说明 |
+| --- | --- |
+| [沙箱打开关闭与步骤条.md](./沙箱打开关闭与步骤条.md) | **详细版**：打开/关闭完整时序、步骤条关系、对接接口字段说明、必守规则、历史 bug 根因、排障手册、自测清单、接线示例与代码索引 |
+
+模块总览仍见：`frontend-web/src/position-roundtable/README.md`。
+
+建议读法：
+
+- **从零对接新页面**：正文第 3、5、6、7、8、12、15、16 节  
+- **线上排障**：第 13、14 节  
+- **只要一页纸**：文末「附录 A」
diff --git a/frontend-web/docs/position-roundtable-sandbox/沙箱打开关闭与步骤条.md b/frontend-web/docs/position-roundtable-sandbox/沙箱打开关闭与步骤条.md
new file mode 100644
index 00000000..035b5222
--- /dev/null
+++ b/frontend-web/docs/position-roundtable-sandbox/沙箱打开关闭与步骤条.md
@@ -0,0 +1,988 @@
+# 岗位会商 · 沙箱打开 / 关闭与步骤条（详细对接与排障指南）
+
+> **文档位置**：`frontend-web/docs/position-roundtable-sandbox/`  
+> **读者**：下次重做或对接岗位会商页面的同事；线上「沙箱不实时 / 卡死 / 第二次不刷新」时的排障同学。  
+> **最后依据**：当前仓库 `PositionRoundtablePage` + `PositionNodeChat` 实现（含临时名打开、外部 store、前沿节流、按 tool-call 重挂）。
+
+---
+
+## 目录
+
+1. [文档用途与读法](#1-文档用途与读法)
+2. [背景：为什么岗位会商要单独做沙箱](#2-背景为什么岗位会商要单独做沙箱)
+3. [用户可见的正确行为（验收标准）](#3-用户可见的正确行为验收标准)
+4. [整体架构与数据流](#4-整体架构与数据流)
+5. [职责划分：谁拥有什么状态](#5-职责划分谁拥有什么状态)
+6. [对接接口详解](#6-对接接口详解)
+7. [打开沙箱的完整步骤](#7-打开沙箱的完整步骤)
+8. [关闭沙箱的完整步骤](#8-关闭沙箱的完整步骤)
+9. [步骤条与沙箱的关系](#9-步骤条与沙箱的关系)
+10. [流式内容如何进入沙箱（性能关键）](#10-流式内容如何进入沙箱性能关键)
+11. [与普通对话页的对照](#11-与普通对话页的对照)
+12. [重做页面时的必守规则](#12-重做页面时的必守规则)
+13. [历史问题与根因（务必读）](#13-历史问题与根因务必读)
+14. [排障手册（按症状）](#14-排障手册按症状)
+15. [对接自测清单](#15-对接自测清单)
+16. [最小接线示例](#16-最小接线示例)
+17. [关键代码索引](#17-关键代码索引)
+18. [术语表](#18-术语表)
+
+---
+
+## 1. 文档用途与读法
+
+### 1.1 这份文档解决什么问题
+
+岗位会商右侧「文件预览沙箱」看起来像普通对话页的产物预览，但实现路径完全不同。历史上这块反复出过：
+
+- 沙箱不实时打开，要等全文写完才弹；
+- 打开了但内容冻住，生成完才一口气灌进去；
+- 整页卡顿，连消息列表文字都不实时；
+- 同轮「重新生成」第二次写入时，步骤条变了，沙箱却不动；
+- 第一次正常，关掉后再问就不实时。
+
+这些 bug **特别容易在「重做页面 / 换布局 / 自己重写开沙箱逻辑」时复现**。本文把正确对接方式、时序、接口、禁区和排障步骤写全，方便下一位同事直接按文档接线，而不是再靠猜。
+
+### 1.2 建议读法
+
+| 你的目标 | 先读哪些章节 |
+| --- | --- |
+| 从零接一个新页面壳 | 第 3、5、6、7、8、12、15、16 节 |
+| 只改对话子组件探测逻辑 | 第 7、9、12、13 节 |
+| 线上排障 | 第 13、14 节，必要时回看第 10 节 |
+| 理解为什么不能用页面 state | 第 2、10、13 节 |
+
+### 1.3 对照代码（以仓库为准）
+
+| 角色 | 路径 |
+| --- | --- |
+| 页面壳（唯一沙箱宿主） | `frontend-web/src/position-roundtable/pages/PositionRoundtablePage.tsx` |
+| 节点对话（探测 write_file、上报预览） | `frontend-web/src/position-roundtable/components/PositionNodeChat.tsx` |
+| 收口对话 | `frontend-web/src/position-roundtable/components/PositionBuiltinAgentChat.tsx` |
+| 预览 UI（共享组件，勿分叉逻辑） | `frontend-web/src/components/workspace/artifacts/artifact-file-detail.tsx` |
+| 流式正文读取 | `frontend-web/src/core/artifacts/loader.ts` → `loadArtifactContentFromToolCall` |
+| 普通对话页对照（步骤条自动开） | `frontend-web/src/components/workspace/messages/message-group.tsx` |
+| 模块总览 | `frontend-web/src/position-roundtable/README.md` |
+
+---
+
+## 2. 背景：为什么岗位会商要单独做沙箱
+
+### 2.1 普通对话页怎么开沙箱
+
+普通对话页（`ChatPage`）大致是：
+
+```text
+ArtifactsProvider（页面级）
+  └─ ChatBox / MessageList
+       └─ message-group 渲染 write_file 步骤
+            └─ 发现 path 且 autoOpen → artifacts.select + setOpen(true)
+  └─ 右侧 ArtifactFileDetail 读同一套 ThreadContext
+```
+
+要点：
+
+- 对话和预览共享同一套 `ThreadContext`（同一个 `useThreadStream`）。
+- 步骤条组件自己就能触发打开。
+- 流式 `content` 本来就在当前 React 树的 thread 里，不需要「把 thread 镜像到别的地方」。
+
+### 2.2 岗位会商为什么不能照搬
+
+岗位会商页面同时有：
+
+- 左侧任务 / 意图 / 流程图；
+- 中间某个节点的对话（`PositionNodeChat`）；
+- 右侧配置抽屉；
+- **以及一个页面级单例沙箱**，它是对话区的**兄弟节点**，不在 `PositionNodeChat` 的 ThreadContext 里面。
+
+因此：
+
+1. 沙箱拿不到节点对话内部的 `thread`，除非节点主动上报；
+2. 若把每次流式 thread 写进**页面级 `useState`**，整页（任务卡、意图、流程图、对话）都会按流式频率重渲染，主线程会被打爆；
+3. 页面必须自己决定「开 / 关 / 抑制自动再开 / 切节点时清理」，不能让多个子组件各自 `setOpen`。
+
+所以岗位会商采用：
+
+```text
+对话子组件探测 + 上报
+  → 页面壳统一打开唯一 ArtifactFileDetail
+  → 流式 thread 走外部 store，只让沙箱子树订阅
+```
+
+### 2.3 和「多智能体会商 Step2 沙箱」的区别
+
+仓库里还有 `frontend-web/docs/roundtable-step2-sandbox-progress.md`，那是另一套圆桌 Step2 沙箱进度文档，**不是**岗位会商这条链路。对接岗位会商时以本文为准。
+
+---
+
+## 3. 用户可见的正确行为（验收标准）
+
+重做或对接完成后，下列行为必须全部成立（用户感知对齐普通对话页）：
+
+| # | 行为 | 说明 |
+| --- | --- | --- |
+| A | 步骤条刚出现「写入文件」时，沙箱应已打开 | **不必等**步骤条上出现文件名 |
+| B | 沙箱源码边写边滚；消息列表也实时出字 | 不能整页卡死、不能「生成完一口气刷」 |
+| C | content 先于 path 时：先临时名打开，path 到了再改名 | 不闪屏、不重挂 |
+| D | 同轮第二次同路径 `write_file`（重新生成） | 沙箱清空并重新流式 |
+| E | 整轮结束后自动切 Markdown 预览 | 「正在生成，完成后自动预览」消失 |
+| F | 用户手动关闭后，同一次写入不再自动弹 | 下一轮新写入仍可自动开 |
+| G | 切岗位 / 切节点 / 新会话 / 切历史 | 沙箱关掉且不串内容 |
+
+**不要误判的正常现象：**
+
+- 流式期间沙箱停在「源码 / 编辑」视图，结束后才切「预览」——这是 `ArtifactFileDetail` 对 markdown/html 的既定行为，与普通对话页相同，**不是**打开时机 bug。
+- 步骤条长时间显示「写入文件」、没有路径，但沙箱已经打开并在滚动——content-first 模型下这是**预期**。
+
+---
+
+## 4. 整体架构与数据流
+
+```text
+┌──────────────────────────────────────────────────────────────────────────┐
+│ PositionRoundtablePage（页面壳）                                           │
+│                                                                          │
+│  state: sandboxArtifact | null                                           │
+│  ref:   sandboxArtifactRef / closedSandboxKeyRef / latestSnapshotRef     │
+│  store: createSandboxThreadStore()   ←── 禁止改成 useState               │
+│                                                                          │
+│  handlePreviewArtifact(artifact)  ←──────────────────────────────────┐   │
+│  handleNodeThreadSnapshot(...)    ←───────────────────────────────┐  │   │
+│  closeSandbox()                                                   │  │   │
+│                                                                   │  │   │
+│  {sandboxOpen && (                                                │  │   │
+│     SandboxThreadProvider(store)                                  │  │   │
+│       └─ ArtifactFileDetail key=sandboxCloseKey(...)              │  │   │
+│  )}                                                               │  │   │
+└───────────────────────────────────────────────────────────────────│──│───┘
+                                                                    │  │
+┌───────────────────────────────────────────────────────────────────│──│───┐
+│ PositionNodeChat / PositionBuiltinAgentChat                         │  │   │
+│                                                                   │  │   │
+│  useThreadStream → thread.messages / thread.isLoading             │  │   │
+│       │                                                           │  │   │
+│       ├─ MessageList → 步骤条（只展示 tool call）                   │  │   │
+│       │                                                           │  │   │
+│       ├─ latestStreamingWriteFile(messages)                       │  │   │
+│       │     → onPreviewArtifact({..., auto:true}) ───────────────────┘   │
+│       │                                                                  │
+│       └─ useEffect → onThreadSnapshot({threadId, thread}) ───────────────┘
+└──────────────────────────────────────────────────────────────────────────┘
+```
+
+一句话：
+
+- **谁打开**：对话子组件决定「该不该开、开哪次交付」；  
+- **谁真正开面板**：页面壳；  
+- **内容怎么更新**：子组件持续上报 thread 快照 → 页面壳 store → 只有沙箱子树重渲染。
+
+---
+
+## 5. 职责划分：谁拥有什么状态
+
+### 5.1 页面壳必须拥有
+
+| 状态 / 能力 | 为什么必须在页面壳 |
+| --- | --- |
+| `sandboxArtifact` | 唯一预览目标；切节点时要清 |
+| `closedSandboxKeyRef` | 用户关过后的抑制；跨子组件生命周期 |
+| `sandboxThreadStore` | 流式内容通道；不能进大页面 state |
+| `closeSandbox()` | 切岗位 / 切节点 / 新会话统一入口 |
+| 唯一 `ArtifactFileDetail` | 避免双实例、关闭失效、深度异常 |
+
+### 5.2 对话子组件必须拥有
+
+| 状态 / 能力 | 作用 |
+| --- | --- |
+| `autoPreviewRunArmedRef`（armed） | 只有本轮用户发送后才允许自动开 |
+| `autoPreviewBaselineCallKeysRef`（baseline） | 忽略发送前已有的历史 write_file |
+| `activeWriteFilePreviewRef` | 记录当前打开的 previewKey / path / toolCallId |
+| `autoPreviewedArtifactKeyRef` | 同一次 identity 去重，避免每 chunk 重复上报 |
+| `latestStreamingWriteFile` | 从 streaming messages 探测可预览的 write |
+| `onThreadSnapshot` 上报 | 把 thread 喂给页面壳 |
+
+### 5.3 明确禁止
+
+1. 在 `PositionNodeChat` 内再挂一套 `ArtifactFileDetail`。  
+2. 让步骤条组件直接 `setOpen(true)` 作为岗位会商主路径（对照普通页可以，岗位会商不行）。  
+3. 把 `onThreadSnapshot` 落到 `PositionRoundtablePage` 的 `useState`。  
+4. 用「整个 threadId」做关闭抑制。  
+5. 用「path 相同」复用 `previewKey`。
+
+---
+
+## 6. 对接接口详解
+
+### 6.1 `PositionArtifactPreview`
+
+```ts
+type PositionArtifactPreview = {
+  threadId: string;          // 必填：LangGraph thread id
+  path: string;              // 必填：真实路径，或 write-file: 虚拟 URL，或临时文件名路径
+  name: string;              // 展示名（文件名）
+  mimeType: string | null;   // 如 text/markdown；帮助预览语言判断
+  previewKey?: string;       // 强烈建议：一次交付身份，推荐 `${messageId}:${toolCallId}`
+  auto?: boolean;            // true = 流式自动打开；缺省/false = 用户点击打开
+};
+```
+
+字段说明：
+
+| 字段 | 详细含义 |
+| --- | --- |
+| `threadId` | 沙箱用来匹配 `onThreadSnapshot` 的线程；也对关闭抑制键有贡献 |
+| `path` | 传给 `ArtifactFileDetail.filepath`。流式阶段通常是 `write-file:...` 虚拟 URL；落盘后的手动打开可以是真实 artifacts 路径 |
+| `name` | UI 展示用；临时名阶段可能是 `未命名文件.md` |
+| `mimeType` | 当 path 还不稳定时，帮助把语言判成 markdown/html，避免落成 TEXT |
+| `previewKey` | **一次交付的身份**。同一次 tool call 的 path 升级要保持不变；新的 tool call 必须变 |
+| `auto` | 自动打开才走关闭抑制；手动打开应清抑制 |
+
+### 6.2 `onPreviewArtifact(artifact)` —— 对话 → 页面
+
+页面壳 `handlePreviewArtifact` 当前逻辑顺序：
+
+1. 校验 `threadId`、`path`，缺则 toast 并 return。  
+2. 计算 `artifactKey = sandboxCloseKey(artifact)`。  
+3. 若 `artifact.auto === true` 且 `closedSandboxKeyRef.current === artifactKey` → **抑制，直接 return**。  
+4. 清 `closedSandboxKeyRef`（手动打开或新的自动打开）。  
+5. `ArtifactsContext.select(path, true)` + `setOpen(true)`。  
+6. 判断是否同一预览 / 是否仅 path upgrade：  
+   - `isSamePreview`：threadId + path + previewKey 全同 → 不重复 setState。  
+   - `isPathUpgrade`：previewKey 相同、path 不同 → 更新 artifact，**不要**再折叠右侧抽屉。  
+7. 若不是 same preview：  
+   - `setSandboxArtifact(artifact)`；  
+   - **同步** `sandboxArtifactRef.current = artifact`（关键！flush 会立刻读 ref）；  
+   - `sandboxSnapshotAppliedAtRef.current = 0`（允许立刻推首帧内容）。  
+8. 若 store 里已有别的 thread 快照，先 `publish(null)`。  
+9. 若 `latestNodeThreadSnapshotRef` 的 threadId 匹配，立刻 `queueSandboxThreadSnapshot`。  
+10. 非 path upgrade 时 `setRightPanelOpen(false)`。
+
+`sandboxCloseKey`：
+
+```ts
+if (artifact.previewKey) {
+  return `${artifact.threadId}:write:${artifact.previewKey}`;
+}
+return `${artifact.threadId}:${normalizePreviewArtifactPath(artifact.path)}`;
+```
+
+`ArtifactFileDetail` 的 React `key` 必须用这个 key：  
+**新 previewKey → 组件重挂 → 视觉上「清空再生成」。**
+
+### 6.3 `onThreadSnapshot({ threadId, thread })` —— 对话 → 页面
+
+每次 `thread` 引用变化（消息 chunk 到达）子组件都会调：
+
+```ts
+onThreadSnapshot?.({ threadId: activeThreadId, thread });
+```
+
+页面壳应：
+
+1. 计算 `signature = sandboxThreadSignature(thread)`（用 isLoading、messages 长度、最近 write_file 的 path/content 长度/尾部等拼签名，用于去重）。  
+2. 写入 `latestNodeThreadSnapshotRef`（即使沙箱还没开，打开瞬间也要用）。  
+3. 若当前没有打开的沙箱，或打开的沙箱 threadId 不一致 → **只更新 ref，不 publish**。  
+4. 若一致 → `queueSandboxThreadSnapshot`（前沿节流后 `store.publish`）。
+
+### 6.4 虚拟 URL 与正文读取
+
+流式阶段 path 形如：
+
+```text
+write-file:${sourcePath}?message_id=${messageId}&tool_call_id=${toolCallId}&language=markdown
+```
+
+`loadArtifactContentFromToolCall`：
+
+1. 解析 URL 的 `message_id`、`tool_call_id`；  
+2. 在 `thread.messages` 里找对应 AI message 的 tool call；  
+3. 返回 `toolCall.args.content`。
+
+结论：
+
+- 沙箱跟的是 **tool call 身份**，不是磁盘文件是否已经写完；  
+- 没有真实 path 也能显示正文；  
+- 临时文件名只影响展示名和语言猜测。
+
+### 6.5 对话子组件 → 页面壳的其它相关回调
+
+| 回调 | 用途 |
+| --- | --- |
+| `onPreviewArtifact` | 打开 / 更新沙箱 |
+| `onThreadSnapshot` | 推送流式 thread |
+| 页面壳 `closeSandbox` 传给 `ArtifactFileDetail.onClose` | 用户点关闭 |
+
+手动从流程图 / 产物列表打开时，也可以直接调 `handlePreviewArtifact`（通常不带 `auto`，或不带 previewKey）。
+
+---
+
+## 7. 打开沙箱的完整步骤
+
+### 7.1 武装（arm）：只有「本轮用户提交」才允许自动开
+
+在 `PositionNodeChat.handleSubmit` 真正 `sendMessage` 之前：
+
+```text
+activeWriteFilePreviewRef = null
+autoPreviewBaselineCallKeysRef = writeFileCallKeys(thread.messages)  // 历史 write 的 messageId:toolCallId
+autoPreviewRunArmedRef = true
+→ sendMessage(...)
+```
+
+发送失败要把 `armed` 设回 `false`。
+
+为什么要 baseline？
+
+线程里往往已经有上几次问答写过的 `write_file`。如果只看「messages 里有没有 write_file」，一提问就会把旧文件再打开一次。baseline 的含义是：**只有这次提交之后新出现的 tool call 才能自动开沙箱**。
+
+### 7.2 探测 `write_file`：不要等完整 path
+
+`write_file` 参数是一整段 JSON 流，**键顺序由模型决定**。
+
+| 模型吐参顺序 | 步骤条表现 | 错误做法的后果 |
+| --- | --- | --- |
+| path / description 先到，再 content | 很快显示描述和文件名 | 普通对话页常见；等 path 也能开 |
+| **content 先到，最后才 path** | 长时间只有「写入文件」，文件名很晚才出现 | 若硬等完整 path，沙箱会晚几十秒甚至一分钟 |
+
+岗位会商报告类 agent **经常是第二种**。
+
+`latestStreamingWriteFile` 规则：
+
+1. 倒序扫描 AI messages 的 `tool_calls`；  
+2. 工具名是 `write_file` 或 `str_replace`；  
+3. **有完整扩展名的 path**（`hasCompleteArtifactExtension`）→ 用真实路径；  
+4. **尚无可用 path，但 `write_file` 的 content 已有非空字符** → 临时文件名：  
+   - 正文头像 HTML → `未命名文件.html`  
+   - 否则 → `未命名文件.md`  
+5. `str_replace` 必须等真实 path（它改已有文件）；  
+6. 组装：  
+   - `key = messageId:toolCallId`  
+   - `path = write-file:虚拟URL`（write_file）或真实 path（str_replace）  
+   - `mimeType`：markdown 则 `text/markdown`
+
+为什么扩展名必须完整？
+
+流式 path 会经历 `/a/b/report.m` → `/a/b/report.md`。若在 `.m` 时就当真实文件打开，预览语言可能被永久判成 TEXT。
+
+### 7.3 上报 effect 的四个门闩
+
+自动上报 `onPreviewArtifact` 前必须同时满足：
+
+1. `thread.isLoading === true`  
+2. 探测到 streaming artifact，且其 key **不在** baseline  
+3. 已有 `previewThreadId`  
+4. `autoPreviewRunArmedRef === true`
+
+然后处理 previewKey：
+
+```text
+若与 activePreview 是同一次 tool call（含 tool-start 前缀兼容）
+  → 复用旧 previewKey   // 用于临时名 → 真实 path
+否则
+  → previewKey = 新的 messageId:toolCallId
+```
+
+去重键：
+
+```text
+`${previewThreadId}:${previewKey}:${sourcePath}`
+```
+
+把 `sourcePath` 算进去，是为了：**同 previewKey 下临时名变成真实 path 时，还要再报一次**（path upgrade），但不会每来一个 content chunk 都报。
+
+### 7.4 线程绑定竞态（不要误 disarm）
+
+首轮对话常出现：
+
+1. 用户发送（本地 draft threadId / 稍后 SDK 创建真实 id）；  
+2. 流已经开始、armed=true；  
+3. 会话 API 把 `node.threadId` 从 `null` 写成真实 id。
+
+这是「本节点绑定自己的新线程」，**不是**切节点。若绑定 effect 无脑清空 armed / baseline，首轮会永远开不了沙箱。
+
+正确：识别 `isOwnThreadBinding`（同 nodeKey、旧 threadId 为空、新 threadId 等于当前 boundThreadId）时 **直接 return，不清 armed**。
+
+### 7.5 path upgrade（改名）≠ 第二次交付
+
+同一次 tool call：
+
+```text
+T1  content 到达 → path=未命名文件.md, previewKey=msg:tc1 → 打开
+T2  真实 path 到达 → path=/mnt/.../报告.md, previewKey=msg:tc1 → 只改名
+```
+
+页面壳看到相同 previewKey、不同 path → `isPathUpgrade`：
+
+- 更新 `sandboxArtifact`；  
+- **不**重挂（React key 仍基于 previewKey）；  
+- **不**再折叠右侧抽屉。
+
+### 7.6 同路径二次写入（重新生成）
+
+同一次问答里模型可能：
+
+```text
+1) write_file → 步骤条「写入文件」→ 打开沙箱
+2) 再 write_file 同 path，description=「重新生成优化版…」
+```
+
+这是**两次 tool call**，必须两个 previewKey。  
+若错误地「path 相同就复用 previewKey」：
+
+- 步骤条出现第二条；  
+- 沙箱 React key 不变；  
+- 用户看到「重新生成了，但沙箱没变化」。
+
+正确：身份只看 tool call。
+
+### 7.7 时序总图（content-first）
+
+```text
+T0    用户发送 → armed=true，拍 baseline
+T1    步骤条出现「写入文件」（尚无 path）
+T1+   args.content 首字符到达 → 临时名打开沙箱，源码开始滚动
+      … store 约每 160ms 推一次 thread 快照 …
+T2    args.path 拼完整（含 .md）→ path upgrade，标题改真实文件名（不重挂）
+T3    write 结束 / isLoading=false → 自动切 Markdown 预览
+```
+
+### 7.8 时序总图（同轮二次写入）
+
+```text
+T1  write_file#1 → previewKey=msg:tc1 → 打开沙箱 A
+T2  #1 结束（可能短暂切预览）
+T3  write_file#2（同 path，新 description）→ previewKey=msg:tc2
+    → key 变 → 组件重挂清空 → 跟 #2 重新流式
+```
+
+---
+
+## 8. 关闭沙箱的完整步骤
+
+### 8.1 用户手动关闭
+
+`closeSandbox()` 应做：
+
+1. `closedSandboxKeyRef = sandboxCloseKey(current)` —— 抑制**这一次**自动再开；  
+2. 关闭 `ArtifactsContext.open`（若开着）；  
+3. 清节流定时器、pending 快照；  
+4. `sandboxSnapshotAppliedAtRef = 0`；  
+5. `sandboxArtifactRef = null` + `setSandboxArtifact(null)`；  
+6. `sandboxThreadStore.publish(null)`。
+
+抑制与 path upgrade 的关系：
+
+- 关掉临时名面板后，同一次 tool call 升级真实 path **仍被抑制**（同一 previewKey）——符合「用户不要看这次」；  
+- 下一次新的 `write_file`（新 previewKey）**可以**再自动开。
+
+### 8.2 场景切换时强制关闭
+
+以下操作应先调用 `closeSandbox()`，避免串台：
+
+- 切岗位；  
+- 切节点；  
+- 切收口阶段；  
+- 新建会话；  
+- 切换历史会话。
+
+是否写入 `closedSandboxKeyRef` 可按产品决定；至少必须清面板和 store。
+
+### 8.3 错误的抑制粒度（历史坑）
+
+若做成「关过一次就整个 thread 不再自动开」：
+
+- 第一次实时开正常；  
+- 用户关掉；  
+- 再问一次 → 同 thread 被永久抑制 → 看起来像「第二次不实时 / 要等生成完」。
+
+正确粒度：**单次交付的 `sandboxCloseKey`（含 previewKey）**。
+
+---
+
+## 9. 步骤条与沙箱的关系
+
+### 9.1 步骤条从哪来
+
+步骤条由 `MessageList` → `message-group.tsx` 渲染 tool call：
+
+- 标题：优先 `args.description`；没有则 i18n 兜底「写入文件」；  
+- 子行：有 `args.path` 才显示路径；  
+- 普通对话页还会在「有 path + autoOpen」时自己 `select/setOpen`。
+
+岗位会商里，步骤条**仍然只负责展示**；打开沙箱走 `onPreviewArtifact`，不要让两套逻辑抢。
+
+### 9.2 对照表
+
+| 你看到的步骤条 | 含义 | 沙箱应处于 |
+| --- | --- | --- |
+| 仅「写入文件」，无路径 | tool call 已开始；path/description 可能还没流到 | **应已打开**（临时名），源码在滚 |
+| 「写入文件」+ 路径 | path 已可用 | 已打开；若刚从临时名升级则只改名 |
+| 带自定义 description 的标题 + 路径 | 模型给了 description | 同上 |
+| 第二条「重新生成…」+ 同路径 | 新的 write_file（新 toolCallId） | **应重挂**并重新流式 |
+| 顶部「正在生成，完成后自动预览」 | 仍在 code 视图 | 正常，等 isLoading 结束切预览 |
+| 生成结束，出现文件卡片 / present_files | 工具结果已落 | 通常已是预览模式；可手动再点开 |
+
+### 9.3 常见误解
+
+**误解 1：**「步骤条出现文件名 = 打开沙箱的正确时机」  
+→ 错。那是 path 到达的时机。content-first 时正确打开时机更早：content 首字节 / 工具调用已开始。
+
+**误解 2：**「步骤条还在写『写入文件』，沙箱却开了，是 bug」  
+→ 通常不是。两边数据源相同，但沙箱允许无 path 打开，步骤条标题可能还没 description。
+
+**误解 3：**「等生成完从编辑切预览 = 沙箱打开晚了」  
+→ 错。那是 `ArtifactFileDetail` 的 viewMode 策略。
+
+---
+
+## 10. 流式内容如何进入沙箱（性能关键）
+
+### 10.1 为什么不能用页面 `useState` 存线程快照
+
+错误写法：
+
+```ts
+setSandboxThreadSnapshot(snapshot) // 页面级 useState
+```
+
+后果：
+
+- 消息 chunk 约每 30ms 一次，节流后仍约 6 次/秒；  
+- 每次都重渲染整页：任务卡、意图结果、流程图、节点对话……；  
+- 主线程占满 → 消息列表停绘、沙箱冻住；  
+- 纯尾随 `setTimeout(160)` 会被饿死，十几秒不 flush。
+
+这同时解释了两个历史现象：
+
+1. 「沙箱打开了但内容不更新」；  
+2. 「修完节流后整页更卡、消息也不实时」——因为节流终于开始真正 setState 了。
+
+### 10.2 正确做法：外部 store + 子树订阅
+
+```ts
+createSandboxThreadStore()
+  subscribe / getSnapshot / publish
+
+SandboxThreadProvider
+  useSyncExternalStore(store.subscribe, store.getSnapshot)
+  → ThreadContext.Provider value={{ thread, isMock:false }}
+  → ArtifactFileDetail
+```
+
+页面壳本身**不**因 snapshot 变化而重渲染；只有 Provider 及其子树重渲染。
+
+### 10.3 节流必须是前沿（leading-edge）
+
+`SANDBOX_SNAPSHOT_MIN_INTERVAL_MS = 160`：
+
+```text
+queue(snapshot):
+  pending = snapshot
+  if 距上次 publish >= 160ms:
+      立刻 flush（同步 publish）
+  else:
+      若没有在途 timer，则 setTimeout(剩余时间) 做补尾
+flush:
+  清 timer
+  校验 pending.threadId === sandboxArtifactRef.threadId
+  publish(pending)
+```
+
+**不要**改回：
+
+```ts
+if (timer != null) return;
+timer = setTimeout(flush, 160);
+```
+
+那是纯尾随；忙主线程下会假死。
+
+### 10.4 signature 去重
+
+`sandboxThreadSignature` 用最近 write_file 的 path、content 长度、content 尾 32 字等拼签名。  
+store.publish 时若 threadId+signature 未变，则不通知订阅者，减少无效渲染。
+
+### 10.5 打开瞬间的首帧
+
+`handlePreviewArtifact` 里往往会立刻 `queueSandboxThreadSnapshot(latestSnapshot)`。  
+此时 React 的 `setSandboxArtifact` 可能还没提交，若 flush 只读旧的 `sandboxArtifactRef`，会因 threadId 不匹配把首帧丢掉。
+
+所以打开新预览时必须：
+
+```ts
+sandboxArtifactRef.current = artifact; // 同步
+sandboxSnapshotAppliedAtRef.current = 0;
+```
+
+---
+
+## 11. 与普通对话页的对照
+
+| 点 | 普通对话页 | 岗位会商 |
+| --- | --- | --- |
+| 谁触发打开 | `message-group` 内 `artifacts.select` | 子组件 `onPreviewArtifact` → 页面壳 |
+| 是否要求 path | 是（有 path 才自动开） | 否（write_file + content 可临时名开） |
+| thread 从哪来 | 同树 ThreadContext | `onThreadSnapshot` + 外部 store |
+| 关闭抑制 | 主要靠 ArtifactsContext / 用户操作 | `closedSandboxKeyRef` 按 previewKey |
+| 同 path 重写 | 依赖新的 tool call / 选择逻辑 | **必须**新 previewKey 以重挂 |
+| 结束后切预览 | ArtifactFileDetail 同一套 | 同一套 |
+
+对齐目标是**用户感知一致**，不是代码路径完全相同。
+
+普通对话页自动开的核心条件（对照用）：
+
+```ts
+artifacts && isLoading && isLast && autoOpen && autoSelect && path && !result
+```
+
+它也要求 path，所以 content-first 时普通页同样会偏晚——只是很多主聊天示例 agent 先吐 path，观感更好。岗位会商报告 agent 更常 content-first，所以必须做临时名提前开。
+
+---
+
+## 12. 重做页面时的必守规则
+
+按优先级：
+
+1. **流式 thread 快照禁止进页面级 `useState`** → 用 store + `useSyncExternalStore`。  
+2. **节流用前沿 + 补尾**，不要纯尾随 timer。  
+3. **不要等完整 path 才开**；`write_file` + content 即可临时名打开。  
+4. **扩展名完整前不要把 path 当最终 path**。  
+5. **previewKey 按 tool call，不按 path**。  
+6. **打开时同步写 `sandboxArtifactRef`，并重置节流时间戳**。  
+7. **主路径扫描 `thread.messages`，不要只靠 `onToolStart`**。  
+8. **path upgrade 保持 previewKey，不要当第二次交付**。  
+9. **关闭抑制按 sandboxCloseKey，不要按整 thread**。  
+10. **沙箱单例在页面壳；子组件只上报**。  
+11. **本节点 threadId 回写不要 disarm**。  
+12. **「结束后才切预览」不要当打开 bug 去「修」掉共享组件**，除非产品明确要求边生成边渲染 Markdown（需单独评估性能）。
+
+---
+
+## 13. 历史问题与根因（务必读）
+
+下面每个都在真实联调里出现过。重做时若踩中，优先回来对照。
+
+### 13.1 沙箱要等文件名出来才开（晚几十秒）
+
+**现象：** 步骤条早就「写入文件」，沙箱很晚才开；普通对话页对比显得「实时」。  
+
+**根因：** 探测逻辑硬等完整 `path`；而该 agent 先流 `content`、最后才流 `path`。  
+
+**修复：** content 首批字符即可用临时名打开；path 到了再 upgrade。
+
+### 13.2 沙箱打开了，内容冻住，生成完才灌满
+
+**现象：** 面板开了，但里面一直是空/旧内容；日志里 queue 很多，flush 很少。  
+
+**根因：** 纯尾随 160ms 定时器在忙主线程下被饿死。  
+
+**修复：** 前沿节流——到期就在流回调里同步 flush。
+
+### 13.3 修完「内容更新」后，整页卡顿、消息也不实时
+
+**现象：** 沙箱开始更新了，但页面更卡，消息列表也「攒到最后刷」。  
+
+**根因：** flush 走的是页面 `useState`，每 160ms 整页重渲染。以前 timer 饿死时反而「不卡」。  
+
+**修复：** 快照改外部 store，只让沙箱子树订阅。
+
+### 13.4 第二次「重新生成」步骤有了，沙箱不变
+
+**现象：** 同轮第二条二条 write 步骤，沙箱仍显示第一次完整结果。  
+
+**根因：** 用「path 相同」复用了第一次 previewKey，React key 不变，组件不重挂。  
+
+**修复：** previewKey 只按 tool call；同 path 新 call 必须新 key。
+
+### 13.5 第一次实时，关掉后再问就不实时
+
+**现象：** 关过沙箱后，下一轮要等生成完才开，或不开。  
+
+**根因：** 抑制绑在整个 threadId，或把 path upgrade / 新 call 误判成同一次。  
+
+**修复：** 抑制键 = `sandboxCloseKey(previewKey)`；仅抑制那一次交付。
+
+### 13.6 首轮永远不开
+
+**现象：** 新建节点第一次提问，armed 后很快又不满足条件。  
+
+**根因：** `node.threadId` 从 null 回写真实 id 时，绑定 effect 误 disarm。  
+
+**修复：** `isOwnThreadBinding` 时不清 armed。
+
+### 13.7 预览变成纯文本
+
+**现象：** 明明是 md，却按 TEXT 打开。  
+
+**根因：** 在 `.m` 阶段就当完整 path；或临时名没有 `.md` / 没传 language、mimeType；或 path 带空格。  
+
+**修复：** `hasCompleteArtifactExtension`；临时名带扩展名；URL 加 `language=markdown`；path trim。
+
+### 13.8 依赖 onToolStart，线上偶发不开
+
+**现象：** 本地偶发正常，联调经常不开。  
+
+**根因：** 后端 StreamBridge / worker 可能过滤 tools/events 类 stream mode。  
+
+**修复：** 主路径必须是 messages 里渐进出现的 `tool_calls`；onToolStart 只能当补充。
+
+---
+
+## 14. 排障手册（按症状）
+
+排障时建议先看 Chrome Performance / React 重渲染是否整页抖，再看消息里 tool_calls 的 args 是 path-first 还是 content-first。
+
+### 14.1 沙箱开得很晚
+
+检查顺序：
+
+1. `latestStreamingWriteFile` 是否仍要求完整 path？  
+2. armed 是否被 threadId 回写清掉？  
+3. 是否命中 `closedSandboxKey`？  
+4. 新 call 是否被 baseline 当成历史？  
+5. `previewThreadId` 是否为空（线程还没绑上）？
+
+### 14.2 打开了但内容空白 / 冻住
+
+1. 快照是否进了页面 useState？  
+2. 节流是否纯尾随？  
+3. `SandboxThreadProvider` 是否拿到带 messages 的 thread？  
+4. 虚拟 URL 的 message_id / tool_call_id 是否对得上？  
+5. 打开时 `sandboxArtifactRef` 是否同步？（首帧是否被 drop）  
+6. signature 是否因实现错误一直不变，导致 publish 被去重？
+
+### 14.3 整页卡、消息列表也不实时
+
+1. 搜页面壳是否还有 `setSandboxThreadSnapshot` / 类似大对象 state。  
+2. 是否在每 chunk `console.debug` 打大对象（DevTools 打开时更卡）。  
+3. 是否错误地让页面壳订阅了 store（页面壳不应 `useSyncExternalStore` 这份 store；只有 Provider 订）。
+
+### 14.4 重新生成不刷新
+
+1. 第二次 write 的 toolCallId 是否变了？  
+2. previewKey 是否仍用 path 复用？  
+3. `ArtifactFileDetail` 的 `key=` 是否基于 sandboxCloseKey/previewKey？
+
+### 14.5 关后再问异常
+
+1. 打印 `closedSandboxKeyRef` 与新 artifact 的 sandboxCloseKey。  
+2. 确认新一轮 send 时 armed/baseline 已重置。  
+3. 确认抑制不是整 thread。
+
+### 14.6 语言 / 预览模式不对
+
+1. 看打开时的 path / mimeType / language 查询参数。  
+2. 确认不是在扩展名不完整时打开。  
+3. 确认「源码→预览」发生在 isLoading false 之后（属正常）。
+
+---
+
+## 15. 对接自测清单
+
+重做页面后至少跑完：
+
+### 功能
+
+- [ ] 首轮：步骤条「写入文件」出现时，沙箱是否已开并开始出字？  
+- [ ] content-first agent：无文件名阶段是否也能开？  
+- [ ] path 到达后：是否只改名、不整页闪、不重挂？  
+- [ ] 同轮第二次同路径 write：是否清空并重新流式？  
+- [ ] 结束后是否自动切 Markdown 预览？  
+- [ ] 手动点步骤条路径 / 产物卡片：能否打开正确文件？  
+
+### 关闭与抑制
+
+- [ ] 流式中手动关闭：本次是否不再自动弹？  
+- [ ] 关闭后再发一轮新问题：是否仍可自动开？  
+- [ ] path upgrade 是否不会绕过「用户刚关闭」的抑制？  
+
+### 场景切换
+
+- [ ] 切节点：沙箱关闭，旧内容不残留。  
+- [ ] 切岗位：同上。  
+- [ ] 新建会话 / 切历史：同上。  
+
+### 性能
+
+- [ ] 流式中消息列表是否实时出字？  
+- [ ] 页面是否明显掉帧 / 卡死？  
+- [ ] React DevTools 中，大页面壳是否在每 160ms 整页 update？（不应）
+
+---
+
+## 16. 最小接线示例
+
+### 16.1 页面壳（示意）
+
+```tsx
+const [sandboxArtifact, setSandboxArtifact] = useState<PositionArtifactPreview | null>(null);
+const sandboxArtifactRef = useRef<PositionArtifactPreview | null>(null);
+const closedSandboxKeyRef = useRef<string | null>(null);
+const latestNodeThreadSnapshotRef = useRef<SandboxThreadSnapshot | null>(null);
+const store = useMemo(createSandboxThreadStore, []);
+// pending + timer + appliedAt 用于前沿节流（见 PositionRoundtablePage）
+
+function handlePreviewArtifact(artifact: PositionArtifactPreview) {
+  if (!artifact.threadId || !artifact.path) return;
+  const key = sandboxCloseKey(artifact);
+  if (artifact.auto && closedSandboxKeyRef.current === key) return;
+  closedSandboxKeyRef.current = null;
+
+  artifactsCtx?.select(artifact.path, true);
+  artifactsCtx?.setOpen(true);
+
+  const prev = sandboxArtifactRef.current;
+  const isSame =
+    prev?.threadId === artifact.threadId &&
+    prev.path === artifact.path &&
+    prev.previewKey === artifact.previewKey;
+  const isPathUpgrade =
+    !isSame &&
+    Boolean(artifact.previewKey) &&
+    prev?.threadId === artifact.threadId &&
+    prev.previewKey === artifact.previewKey;
+
+  if (!isSame) {
+    sandboxArtifactRef.current = artifact; // 必须同步
+    setSandboxArtifact(artifact);
+    sandboxSnapshotAppliedAtRef.current = 0;
+  }
+
+  if (store.getSnapshot()?.threadId !== artifact.threadId) {
+    store.publish(null);
+  }
+  const latest = latestNodeThreadSnapshotRef.current;
+  if (latest?.threadId === artifact.threadId) {
+    queueSandboxThreadSnapshot(latest);
+  }
+  if (!isPathUpgrade) setRightPanelOpen(false);
+}
+
+function handleNodeThreadSnapshot(snapshot: { threadId: string; thread: BaseStream<AgentThreadState> }) {
+  const next = { ...snapshot, signature: sandboxThreadSignature(snapshot.thread) };
+  latestNodeThreadSnapshotRef.current = next;
+  if (sandboxArtifactRef.current?.threadId !== snapshot.threadId) return;
+  queueSandboxThreadSnapshot(next);
+}
+
+function closeSandbox() {
+  if (sandboxArtifactRef.current) {
+    closedSandboxKeyRef.current = sandboxCloseKey(sandboxArtifactRef.current);
+  }
+  // clear timer / pending / appliedAt
+  sandboxArtifactRef.current = null;
+  setSandboxArtifact(null);
+  store.publish(null);
+  artifactsCtx?.setOpen(false);
+}
+
+// 渲染
+{sandboxArtifact && (
+  <SandboxThreadProvider
+    store={store}
+    threadId={sandboxArtifact.threadId}
+    fallbackThread={stub}
+  >
+    <ArtifactFileDetail
+      key={sandboxCloseKey(sandboxArtifact)}
+      filepath={sandboxArtifact.path}
+      threadId={sandboxArtifact.threadId}
+      mimeType={sandboxArtifact.mimeType}
+      onClose={closeSandbox}
+      allowVirtualMarkdownEdit
+    />
+  </SandboxThreadProvider>
+)}
+```
+
+### 16.2 对话子组件（示意）
+
+```tsx
+// send 前
+activeWriteFilePreviewRef.current = null;
+autoPreviewBaselineCallKeysRef.current = writeFileCallKeys(thread.messages);
+autoPreviewRunArmedRef.current = true;
+await sendMessage(...);
+
+// 探测
+const streaming = thread.isLoading ? latestStreamingWriteFile(thread.messages) : null;
+const next =
+  streaming && !autoPreviewBaselineCallKeysRef.current.has(streaming.key)
+    ? streaming
+    : null;
+
+useEffect(() => {
+  if (!thread.isLoading || !next || !previewThreadId || !autoPreviewRunArmedRef.current) return;
+
+  // previewKey：同 tool call 复用，否则用 next.key
+  // artifactKey = threadId:previewKey:sourcePath 去重
+  onPreviewArtifact?.({
+    threadId: previewThreadId,
+    path: next.path,
+    name: next.name,
+    mimeType: next.mimeType,
+    previewKey,
+    auto: true,
+  });
+}, [next, previewThreadId, thread.isLoading, onPreviewArtifact]);
+
+useEffect(() => {
+  onThreadSnapshot?.({ threadId: activeThreadId, thread });
+}, [activeThreadId, thread, onThreadSnapshot]);
+```
+
+**强烈建议：** 探测 / armed / baseline / 临时名逻辑直接复用或抽取自 `PositionNodeChat`，不要从零重写。
+
+---
+
+## 17. 关键代码索引
+
+| 主题 | 位置 |
+| --- | --- |
+| 临时名 / 完整扩展名 / latestStreamingWriteFile | `PositionNodeChat.tsx` 中 `provisionalWriteFilePath`、`hasCompleteArtifactExtension`、`latestStreamingWriteFile` |
+| armed / baseline / 上报 effect | `PositionNodeChat.tsx` `handleSubmit` + streaming preview `useEffect` |
+| 同 tool call 判断 / 二次写入重挂 | 同上，`isSameToolCall` / `previewKey` |
+| 线程绑定保护 | `PositionNodeChat.tsx` node binding `useEffect` 中 `isOwnThreadBinding` |
+| sandboxCloseKey / store / 前沿节流 | `PositionRoundtablePage.tsx` `sandboxCloseKey`、`createSandboxThreadStore`、`queueSandboxThreadSnapshot` |
+| 打开 / path upgrade / 抑制 | `PositionRoundtablePage.tsx` `handlePreviewArtifact` |
+| 关闭 | `PositionRoundtablePage.tsx` `closeSandbox` |
+| 虚拟 URL 读 content | `core/artifacts/loader.ts` `loadArtifactContentFromToolCall` |
+| 源码/预览切换 | `artifact-file-detail.tsx` 中 `viewMode` + `thread.isLoading` |
+| 普通页步骤条自动开 | `message-group.tsx` `write_file` 分支 |
+
+相关提交（背景）：
+
+- `fix(frontend): 岗位会商沙箱在 write_file 流式阶段实时打开并刷新`  
+  — 临时名打开、外部 store、前沿节流  
+- `fix(frontend): 同路径二次 write_file 时重挂岗位会商沙箱`  
+  — previewKey 按 tool call，禁止按 path 复用  
+
+---
+
+## 18. 术语表
+
+| 术语 | 含义 |
+| --- | --- |
+| armed | 本轮用户发送后，允许自动打开沙箱的开关 |
+| baseline | send 前已有的 write tool call 集合，用于忽略历史产物 |
+| previewKey | 一次交付的稳定身份，推荐 `messageId:toolCallId` |
+| sandboxCloseKey | 关闭抑制键，同时用作 `ArtifactFileDetail` 的 React key |
+| provisional path / 临时名 | 尚无真实 path 时的 `未命名文件.md` / `.html` |
+| path upgrade | 同 previewKey 下临时名升级为真实 path |
+| sandboxThreadStore | 流式线程外部 store，避免整页重渲染 |
+| write-file: URL | 用 message_id + tool_call_id 定位流式 content 的虚拟路径 |
+| leading-edge throttle / 前沿节流 | 到期立即在回调里 publish，而不是只挂尾随 timer |
+| content-first / path-first | 模型流式 JSON 参数时 content 与 path 哪个先到 |
+| isOwnThreadBinding | 本节点把自己的新 threadId 写回 props，不是切节点 |
+
+---
+
+## 附录 A：给对接同学的一页纸摘要
+
+1. 页面壳只挂一个沙箱；子组件只调用 `onPreviewArtifact` / `onThreadSnapshot`。  
+2. 自动打开时机 ≈ 步骤条出现「写入文件」时，而不是出现文件名时。  
+3. `write_file` 可以没有 path：临时名打开，path 到了再改名。  
+4. 流式 thread 进外部 store，进页面 state 会卡死。  
+5. 节流要前沿；previewKey 看 tool call；关闭抑制看 sandboxCloseKey。  
+6. 同路径重新生成 = 新 previewKey = 沙箱重挂。  
+7. 出问题先对照第 13、14 节，再看代码索引第 17 节。
diff --git a/frontend-web/src/assets/position-roundtable/add-task.svg b/frontend-web/src/assets/position-roundtable/add-task.svg
new file mode 100644
index 00000000..e27cab8f
--- /dev/null
+++ b/frontend-web/src/assets/position-roundtable/add-task.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16"><defs><style>.a{fill:#fff;opacity:0;}.b{fill:none;stroke:#fff;stroke-linecap:round;stroke-linejoin:round;}</style></defs><rect class="a" width="16" height="16"/><path class="b" d="M24.036,10l-.012,9.333" transform="translate(-16.016 -6.667)"/><path class="b" d="M10,24h9.333" transform="translate(-6.667 -16)"/></svg>
diff --git a/frontend-web/src/assets/position-roundtable/agent-config-logo.svg b/frontend-web/src/assets/position-roundtable/agent-config-logo.svg
new file mode 100644
index 00000000..d51eb71d
--- /dev/null
+++ b/frontend-web/src/assets/position-roundtable/agent-config-logo.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="36" height="36" viewBox="0 0 36 36"><defs><style>.a,.d{fill:#fff;}.a{opacity:0;}.b{fill:#da2331;}.c{fill:#0a54cf;}.e{fill:#1677ff;}.f{fill:#1e2433;}.g{fill:#10d6ff;}.h{fill:#ff8181;}.i{fill:none;stroke:#10d6ff;stroke-linecap:round;stroke-linejoin:round;}.j{filter:url(#d);}.k{filter:url(#a);}</style><filter id="a"><feOffset dx="4" input="SourceAlpha"/><feGaussianBlur stdDeviation="1" result="b"/><feFlood flood-opacity="0.161" result="c"/><feComposite operator="out" in="SourceGraphic" in2="b"/><feComposite operator="in" in="c"/><feComposite operator="in" in2="SourceGraphic"/></filter><filter id="d"><feOffset dx="-4" input="SourceAlpha"/><feGaussianBlur stdDeviation="1" result="e"/><feFlood flood-opacity="0.161" result="f"/><feComposite operator="out" in="SourceGraphic" in2="e"/><feComposite operator="in" in="f"/><feComposite operator="in" in2="SourceGraphic"/></filter></defs><g transform="translate(0 -1)"><rect class="a" width="36" height="36" transform="translate(0 1)"/><path class="b" d="M23.5,14.75a1.5,1.5,0,0,1-1.5-1.5V9.5a1.5,1.5,0,1,1,3,0v3.75A1.5,1.5,0,0,1,23.5,14.75Z" transform="translate(-5.5 -1)"/><g data-type="innerShadowGroup"><path class="c" d="M-2-2H1C3.206-2,5-.532,5,1.273V3.727C5,5.532,3.206,7,1,7H-2Z" transform="translate(28.66 19.541)"/><g class="k" transform="matrix(1, 0, 0, 1, 0, 1)"><path class="d" d="M-2-2H1C3.206-2,5-.532,5,1.273V3.727C5,5.532,3.206,7,1,7H-2Z" transform="translate(28.66 18.54)"/></g></g><g data-type="innerShadowGroup"><path class="c" d="M5-2H2C-.206-2-2-.532-2,1.273V3.727C-2,5.532-.206,7,2,7H5Z" transform="translate(4.34 19.541)"/><g class="j" transform="matrix(1, 0, 0, 1, 0, 1)"><path class="d" d="M5-2H2C-.206-2-2-.532-2,1.273V3.727C-2,5.532-.206,7,2,7H5Z" transform="translate(4.34 18.54)"/></g></g><path class="e" d="M5.5-2H16a7.508,7.508,0,0,1,7.5,7.5V13A7.508,7.508,0,0,1,16,20.5H5.5A7.508,7.508,0,0,1-2,13V5.5A7.508,7.508,0,0,1,5.5-2Z" transform="translate(7.25 13.5)"/><path class="f" d="M5.25,0h9A5.25,5.25,0,0,1,19.5,5.25V7.5a5.25,5.25,0,0,1-5.25,5.25h-9A5.25,5.25,0,0,1,0,7.5V5.25A5.25,5.25,0,0,1,5.25,0Z" transform="translate(8.25 15.25)"/><circle class="g" cx="1.5" cy="1.5" r="1.5" transform="translate(21 19)"/><circle class="g" cx="1.5" cy="1.5" r="1.5" transform="translate(12 19)"/><path class="d" d="M24,10v3.75" transform="translate(-6 -1.5)"/><circle class="h" cx="3" cy="3" r="3" transform="translate(15 4)"/><path class="i" d="M44,28.667a3.367,3.367,0,0,0,1.922.412,2.841,2.841,0,0,0,1.828-.412" transform="translate(-27.875 -5.017)"/></g></svg>
\ No newline at end of file
diff --git a/frontend-web/src/assets/position-roundtable/ask-question.svg b/frontend-web/src/assets/position-roundtable/ask-question.svg
new file mode 100644
index 00000000..af9052eb
--- /dev/null
+++ b/frontend-web/src/assets/position-roundtable/ask-question.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="96" height="96" viewBox="0 0 96 96"><defs><style>.a{fill:#fff;opacity:0;}.b,.c{fill:none;stroke:#006efe;stroke-width:6px;}.b{stroke-linecap:round;stroke-linejoin:round;}</style></defs><g transform="translate(0 1)"><rect class="a" width="96" height="96" transform="translate(0 -1)"/><path class="b" d="M47,67H38L18,77V67H4V7H84V29" transform="translate(4 8)"/><circle class="c" cx="12" cy="12" r="12" transform="translate(56 45)"/><path class="b" d="M39,32l10,8" transform="translate(39 33)"/><path class="b" d="M12,15H24" transform="translate(12 16)"/><path class="b" d="M12,21H36" transform="translate(12 22)"/></g></svg>
diff --git a/frontend-web/src/assets/position-roundtable/collapse-panel.svg b/frontend-web/src/assets/position-roundtable/collapse-panel.svg
new file mode 100644
index 00000000..9f064680
--- /dev/null
+++ b/frontend-web/src/assets/position-roundtable/collapse-panel.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="13" height="11" viewBox="0 0 13 11"><defs><style>.a{stroke:rgba(0,0,0,0);stroke-miterlimit:10;fill:url(#a);}</style><linearGradient id="a" x1="0.277" y1="0.03" x2="0.725" y2="1.083" gradientUnits="objectBoundingBox"><stop offset="0" stop-color="#92eeff"/><stop offset="1" stop-color="#00c7ff"/></linearGradient></defs><path class="a" d="M1,10A1,1,0,1,1,1,8H6a1,1,0,0,1,0,2Zm9.8-.482L7.848,7.361A.445.445,0,0,1,7.661,7a.46.46,0,0,1,.187-.366L10.8,4.481a.45.45,0,0,1,.716.365V9.152a.44.44,0,0,1-.131.317.445.445,0,0,1-.322.136A.454.454,0,0,1,10.8,9.518ZM1,6A1,1,0,1,1,1,4H6A1,1,0,0,1,6,6ZM1,2A1,1,0,1,1,1,0H11a1,1,0,1,1,0,2Z" transform="translate(0.5 0.5)"/></svg>
diff --git a/frontend-web/src/assets/position-roundtable/double-arrow-decoration.svg b/frontend-web/src/assets/position-roundtable/double-arrow-decoration.svg
new file mode 100644
index 00000000..bf85a192
--- /dev/null
+++ b/frontend-web/src/assets/position-roundtable/double-arrow-decoration.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="13" height="11" viewBox="0 0 13 11"><defs><style>.a{fill:url(#a);}.b{fill:url(#b);}</style><linearGradient id="a" x1="0.023" x2="1" y2="1" gradientUnits="objectBoundingBox"><stop offset="0" stop-color="#92eeff" stop-opacity="0.302"/><stop offset="1" stop-color="#00c7ff" stop-opacity="0.302"/></linearGradient><linearGradient id="b" x1="0.023" x2="1" y2="1" gradientUnits="objectBoundingBox"><stop offset="0" stop-color="#92eeff"/><stop offset="1" stop-color="#00c7ff"/></linearGradient></defs><path class="a" d="M5.5,0,11,8H0Z" transform="translate(13) rotate(90)"/><path class="b" d="M5.5,0,11,8H0Z" transform="translate(8) rotate(90)"/></svg>
\ No newline at end of file
diff --git a/frontend-web/src/assets/position-roundtable/edit-task.svg b/frontend-web/src/assets/position-roundtable/edit-task.svg
new file mode 100644
index 00000000..ab6762a2
--- /dev/null
+++ b/frontend-web/src/assets/position-roundtable/edit-task.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16"><defs><style>.a{fill:#fff;opacity:0;}.b,.c{fill:none;stroke:#fff;stroke-linejoin:round;}.b{stroke-linecap:round;}</style></defs><g transform="translate(-1)"><rect class="a" width="16" height="16" transform="translate(1)"/><path class="b" d="M7,42H19" transform="translate(-4 -28)"/><path class="b" d="M0,0H3" transform="translate(9.848 3.848) rotate(45)"/><path class="c" d="M11,12.907v2.427h2.439l6.894-6.9L17.9,6Z" transform="translate(-6.667 -4)"/></g></svg>
diff --git a/frontend-web/src/assets/position-roundtable/more-task.svg b/frontend-web/src/assets/position-roundtable/more-task.svg
new file mode 100644
index 00000000..055a158d
--- /dev/null
+++ b/frontend-web/src/assets/position-roundtable/more-task.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16"><defs><style>.a{fill:#fff;opacity:0;}.b{fill:rgba(255,255,255,0.8);}</style></defs><rect class="a" width="16" height="16"/><path class="b" d="M10,1.5A1.5,1.5,0,1,1,11.5,3,1.5,1.5,0,0,1,10,1.5Zm-5,0A1.5,1.5,0,1,1,6.5,3,1.5,1.5,0,0,1,5,1.5Zm-5,0A1.5,1.5,0,1,1,1.5,3,1.5,1.5,0,0,1,0,1.5Z" transform="translate(1.498 6.5)"/></svg>
diff --git a/frontend-web/src/assets/position-roundtable/search-task.svg b/frontend-web/src/assets/position-roundtable/search-task.svg
new file mode 100644
index 00000000..fc8fc78c
--- /dev/null
+++ b/frontend-web/src/assets/position-roundtable/search-task.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16"><defs><style>.a{fill:#fff;opacity:0;}.b{fill:rgba(85,166,254,0.6);}</style></defs><rect class="a" width="16" height="16"/><path class="b" d="M12.715,13.421,9.588,10.294a5.841,5.841,0,1,1,.707-.707l3.128,3.128a.5.5,0,0,1-.708.706ZM1,5.833A4.833,4.833,0,1,0,5.834,1,4.838,4.838,0,0,0,1,5.833Z" transform="translate(1.334 1.216)"/></svg>
diff --git a/frontend-web/src/assets/position-roundtable/send-message.svg b/frontend-web/src/assets/position-roundtable/send-message.svg
new file mode 100644
index 00000000..3a96000e
--- /dev/null
+++ b/frontend-web/src/assets/position-roundtable/send-message.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16"><defs><style>.a{fill:#fff;}</style></defs><path class="a" d="M14.488.053.824,4.256a1.167,1.167,0,0,0-.285,2.1L4.576,8.936a1.167,1.167,0,0,0,1.382-.092L11,4.593A.292.292,0,0,1,11.408,5L7.156,10.043a1.167,1.167,0,0,0-.091,1.382l2.58,4.036a1.168,1.168,0,0,0,2.1-.286l4.2-13.663A1.167,1.167,0,0,0,14.488.053Z" transform="translate(0)"/></svg>
diff --git a/frontend-web/src/assets/position-roundtable/upload-file.svg b/frontend-web/src/assets/position-roundtable/upload-file.svg
new file mode 100644
index 00000000..9f47e22a
--- /dev/null
+++ b/frontend-web/src/assets/position-roundtable/upload-file.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16.131" height="16" viewBox="0 0 16.131 16"><defs><style>.a{fill:#fff;opacity:0;}.b{fill:none;stroke:#97edff;stroke-linecap:round;stroke-linejoin:round;}</style></defs><rect class="a" width="16" height="16"/><path class="b" d="M6,30V34.12H18.361V30" transform="translate(-2.73 -19.994)"/><path class="b" d="M21.181,9.09,18.09,6,15,9.09" transform="translate(-8.64 -4.235)"/><path class="b" d="M23.992,14.241V6" transform="translate(-14.544 -4.235)"/></svg>
diff --git a/frontend-web/src/assets/position-roundtable/时间.svg b/frontend-web/src/assets/position-roundtable/时间.svg
new file mode 100644
index 00000000..26888994
--- /dev/null
+++ b/frontend-web/src/assets/position-roundtable/时间.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16"><defs><style>.a{fill:#fff;opacity:0;}.b,.c{fill:none;stroke:#346fb1;stroke-linejoin:round;}.c{stroke-linecap:round;}</style></defs><rect class="a" width="16" height="16"/><path class="b" d="M10.667,17.333A6.667,6.667,0,1,0,4,10.667,6.667,6.667,0,0,0,10.667,17.333Z" transform="translate(-2.667 -2.667)"/><path class="c" d="M24.008,12v4l2.826,2.826" transform="translate(-16.005 -8)"/></svg>
\ No newline at end of file
diff --git a/frontend-web/src/assets/position-roundtable/标签1.svg b/frontend-web/src/assets/position-roundtable/标签1.svg
new file mode 100644
index 00000000..780de1a5
--- /dev/null
+++ b/frontend-web/src/assets/position-roundtable/标签1.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="95.001" height="26" viewBox="0 0 95.001 26"><defs><style>.a{fill:rgba(212,120,0,0.5);}</style></defs><path class="a" d="M250.146,407.92h91l-11.4,18.235c-2.679,4.26-5.243,7.5-11.211,7.765H246.146v-22A4,4,0,0,1,250.146,407.92Z" transform="translate(-246.146 -407.92)"/></svg>
\ No newline at end of file
diff --git a/frontend-web/src/assets/position-roundtable/标签2.svg b/frontend-web/src/assets/position-roundtable/标签2.svg
new file mode 100644
index 00000000..7443e13d
--- /dev/null
+++ b/frontend-web/src/assets/position-roundtable/标签2.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="95.001" height="26" viewBox="0 0 95.001 26"><defs><style>.a{fill:rgba(207,19,34,0.5);}</style></defs><path class="a" d="M250.146,407.92h91l-11.4,18.235c-2.679,4.26-5.243,7.5-11.211,7.765H246.146v-22A4,4,0,0,1,250.146,407.92Z" transform="translate(-246.146 -407.92)"/></svg>
\ No newline at end of file
diff --git a/frontend-web/src/assets/position-roundtable/标签3.svg b/frontend-web/src/assets/position-roundtable/标签3.svg
new file mode 100644
index 00000000..7d9257a5
--- /dev/null
+++ b/frontend-web/src/assets/position-roundtable/标签3.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="95.001" height="26" viewBox="0 0 95.001 26"><defs><style>.a{fill:rgba(29,171,123,0.5);}</style></defs><path class="a" d="M250.146,407.92h91l-11.4,18.235c-2.679,4.26-5.243,7.5-11.211,7.765H246.146v-22A4,4,0,0,1,250.146,407.92Z" transform="translate(-246.146 -407.92)"/></svg>
\ No newline at end of file
diff --git a/frontend-web/src/assets/position-roundtable/标签4.svg b/frontend-web/src/assets/position-roundtable/标签4.svg
new file mode 100644
index 00000000..2be60358
--- /dev/null
+++ b/frontend-web/src/assets/position-roundtable/标签4.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="95.001" height="26" viewBox="0 0 95.001 26"><defs><style>.a{fill:rgba(132,85,230,0.5);}</style></defs><path class="a" d="M250.146,407.92h91l-11.4,18.235c-2.679,4.26-5.243,7.5-11.211,7.765H246.146v-22A4,4,0,0,1,250.146,407.92Z" transform="translate(-246.146 -407.92)"/></svg>
\ No newline at end of file
diff --git a/frontend-web/src/assets/position-roundtable/标签5.svg b/frontend-web/src/assets/position-roundtable/标签5.svg
new file mode 100644
index 00000000..df814d72
--- /dev/null
+++ b/frontend-web/src/assets/position-roundtable/标签5.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="95.001" height="26" viewBox="0 0 95.001 26"><defs><style>.a{fill:rgba(201,181,0,0.5);}</style></defs><path class="a" d="M250.146,407.92h91l-11.4,18.235c-2.679,4.26-5.243,7.5-11.211,7.765H246.146v-22A4,4,0,0,1,250.146,407.92Z" transform="translate(-246.146 -407.92)"/></svg>
\ No newline at end of file
diff --git a/frontend-web/src/assets/position-roundtable/标签6.svg b/frontend-web/src/assets/position-roundtable/标签6.svg
new file mode 100644
index 00000000..3df12c8a
--- /dev/null
+++ b/frontend-web/src/assets/position-roundtable/标签6.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="95.001" height="26" viewBox="0 0 95.001 26"><defs><style>.a{fill:rgba(69,195,243,0.5);}</style></defs><path class="a" d="M250.146,407.92h91l-11.4,18.235c-2.679,4.26-5.243,7.5-11.211,7.765H246.146v-22A4,4,0,0,1,250.146,407.92Z" transform="translate(-246.146 -407.92)"/></svg>
\ No newline at end of file
diff --git a/frontend-web/src/assets/position-roundtable/责任岗位.svg b/frontend-web/src/assets/position-roundtable/责任岗位.svg
new file mode 100644
index 00000000..66040aa7
--- /dev/null
+++ b/frontend-web/src/assets/position-roundtable/责任岗位.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16"><defs><style>.a{fill:#fff;opacity:0;}.b{fill:none;stroke:#346fb1;stroke-linecap:round;stroke-linejoin:round;}</style></defs><g transform="translate(0 -2)"><rect class="a" width="16" height="16" transform="translate(0 2)"/><path class="b" d="M17.333,8H4V18H9l1.667,1.667L12.333,18h5Z" transform="translate(-2.667 -3.667)"/><circle class="b" cx="1.667" cy="1.667" r="1.667" transform="translate(6.333 6.333)"/><path class="b" d="M21,26.667A2.848,2.848,0,0,0,18,24a2.848,2.848,0,0,0-3,2.667" transform="translate(-10 -14.333)"/></g></svg>
\ No newline at end of file
diff --git a/frontend-web/src/components/page-sidebar.tsx b/frontend-web/src/components/page-sidebar.tsx
index eb1f0bd1..5119a2ba 100644
--- a/frontend-web/src/components/page-sidebar.tsx
+++ b/frontend-web/src/components/page-sidebar.tsx
@@ -2,6 +2,7 @@ import { useEffect, useState } from "react";
 import { useNavigate, useLocation } from "react-router-dom";
 import {
   Bell,
+  Cpu,
   ChevronLeft,
   ChevronRight,
   ChevronsUpDown,
@@ -252,6 +253,14 @@ function SecondaryNavSidebar({ headerHidden }: { headerHidden: boolean }) {
                       白名单管理
                     </DropdownMenuItem>
                   )}
+                  {isAdmin && (
+                    <DropdownMenuItem
+                      onClick={() => navigate("/page/workspace/admin/models")}
+                    >
+                      <Cpu className="size-4" />
+                      模型配置
+                    </DropdownMenuItem>
+                  )}
                   {isAdmin && (
                     <DropdownMenuItem
                       onClick={() => navigate("/page/strategy/settings/model-concurrency")}
@@ -555,6 +564,12 @@ function LegacyAccordionSidebar({
                   岗位角色配置
                 </DropdownMenuItem>
               )}
+              {isAdmin && (
+                <DropdownMenuItem onClick={() => navigate("/page/workspace/admin/models")}>
+                  <Cpu className="size-4" />
+                  模型配置
+                </DropdownMenuItem>
+              )}
               {isAdmin && (
                 <DropdownMenuItem onClick={() => navigate("/page/strategy/admin/login-whitelist")}>
                   <ShieldCheck className="size-4" />
diff --git a/frontend-web/src/components/workspace/agents/agent-detail-panel.tsx b/frontend-web/src/components/workspace/agents/agent-detail-panel.tsx
index dd2f8212..a09653aa 100644
--- a/frontend-web/src/components/workspace/agents/agent-detail-panel.tsx
+++ b/frontend-web/src/components/workspace/agents/agent-detail-panel.tsx
@@ -104,15 +104,17 @@ function Section({
   icon,
   title,
   extra,
+  className,
   children,
 }: {
   icon?: ReactNode;
   title: string;
   extra?: ReactNode;
+  className?: string;
   children: ReactNode;
 }) {
   return (
-    <section className="bg-card/60 rounded-xl border p-4">
+    <section className={cn("bg-card/60 rounded-xl border p-4", className)}>
       <div className="mb-3 flex items-center justify-between gap-2">
         <h4 className="text-foreground flex items-center gap-1.5 text-sm font-semibold">
           {icon}
@@ -143,6 +145,15 @@ export function AgentDetailPanel({
   defaultCollapsed,
   showRecentChats,
   compactAppearanceActions,
+  avatarSrc,
+  positionName,
+  skillsIcon,
+  skillsTitle,
+  showCommonQuestions = false,
+  panelTitle,
+  embedded,
+  hideStatusBadges = false,
+  editIcon,
 }: {
   agent: Agent | null | undefined;
   agentName: string;
@@ -154,6 +165,19 @@ export function AgentDetailPanel({
   showRecentChats?: boolean;
   /** 简洁模式下挂在右上角收起/展开按钮左侧的外观控件。 */
   compactAppearanceActions?: ReactNode;
+  avatarSrc?: string;
+  positionName?: string;
+  skillsIcon?: ReactNode;
+  skillsTitle?: string;
+  showCommonQuestions?: boolean;
+  /** Overrides the standard panel heading for an embedded consumer. */
+  panelTitle?: string;
+  /** Renders one fixed panel instead of the responsive collapsible rail. */
+  embedded?: boolean;
+  /** Keeps deployment/status badges out of an embedded product surface. */
+  hideStatusBadges?: boolean;
+  /** Optional icon used by the compact embedded edit action. */
+  editIcon?: ReactNode;
 }) {
   const router = useRouter();
   const [collapsed, setCollapsed] = useState(defaultCollapsed ?? false);
@@ -481,11 +505,25 @@ export function AgentDetailPanel({
       </div>
     ) : (
       <div className="flex items-center gap-1">
-        <Button size="sm" variant="outline" onClick={beginEdit}>
-          <SquarePenIcon className="size-3.5" />
-          编辑
-        </Button>
-        {canTogglePublish && (
+        {embedded ? (
+          <Tooltip content="编辑智能体">
+            <Button
+              type="button"
+              size="icon-sm"
+              variant="ghost"
+              onClick={beginEdit}
+              aria-label="编辑智能体"
+            >
+              {editIcon ?? <SquarePenIcon className="size-3.5" />}
+            </Button>
+          </Tooltip>
+        ) : (
+          <Button size="sm" variant="outline" onClick={beginEdit}>
+            <SquarePenIcon className="size-3.5" />
+            编辑
+          </Button>
+        )}
+        {!embedded && canTogglePublish && (
           <Tooltip content={agent?.published ? "下架" : "发布"}>
             <Button
               size="icon-sm"
@@ -502,17 +540,19 @@ export function AgentDetailPanel({
             </Button>
           </Tooltip>
         )}
-        <Tooltip content="删除智能体">
-          <Button
-            size="icon-sm"
-            variant="ghost"
-            className="text-destructive hover:text-destructive"
-            onClick={() => setDeleteOpen(true)}
-            aria-label="删除智能体"
-          >
-            <Trash2Icon className="size-3.5" />
-          </Button>
-        </Tooltip>
+        {!embedded && (
+          <Tooltip content="删除智能体">
+            <Button
+              size="icon-sm"
+              variant="ghost"
+              className="text-destructive hover:text-destructive"
+              onClick={() => setDeleteOpen(true)}
+              aria-label="删除智能体"
+            >
+              <Trash2Icon className="size-3.5" />
+            </Button>
+          </Tooltip>
+        )}
       </div>
     )
   ) : null;
@@ -530,7 +570,11 @@ export function AgentDetailPanel({
       <section className="bg-card/60 rounded-xl border p-4">
         <div className="flex items-start gap-3">
           <div className="agent-avatar bg-primary/10 ring-primary/15 flex size-12 shrink-0 items-center justify-center rounded-2xl ring-1">
-            <BotIcon className="text-primary size-6" />
+            {avatarSrc ? (
+              <img src={avatarSrc} alt="" aria-hidden="true" className="size-9" />
+            ) : (
+              <BotIcon className="text-primary size-6" />
+            )}
           </div>
           <div className="min-w-0 flex-1 space-y-1.5">
             {editing && draft ? (
@@ -550,9 +594,16 @@ export function AgentDetailPanel({
                 {displayName}
               </div>
             )}
-            <div className="flex flex-wrap items-center gap-1">
-              {statusBadges}
-            </div>
+            {!editing && positionName && (
+              <div className="position-agent-role text-sm">
+                岗位：{desensitize(positionName)}
+              </div>
+            )}
+            {!hideStatusBadges && (
+              <div className="flex flex-wrap items-center gap-1">
+                {statusBadges}
+              </div>
+            )}
             {!editing && agent.owner_username && !agent.builtin && (
               <div className="text-muted-foreground flex items-center gap-1 text-xs">
                 <UserRoundIcon className="size-3 shrink-0" />
@@ -670,7 +721,7 @@ export function AgentDetailPanel({
 
 
       {/* ── 常用问题 ───────────────────────────────────────────────────── */}
-      {(editing || questions.length > 0 || canEdit) && (
+      {(showCommonQuestions || editing || questions.length > 0 || canEdit) && (
         <Section
           icon={<MessageCircleQuestionIcon className="size-3.5" />}
           title="常用问题"
@@ -811,8 +862,9 @@ export function AgentDetailPanel({
 
       {/* ── 技能管理 ───────────────────────────────────────────────────── */}
       <Section
-        icon={<SparklesIcon className="size-3.5" />}
-        title={`已启用技能 ${skillNamesShown.length} 个`}
+        icon={skillsIcon ?? <SparklesIcon className="size-3.5" />}
+        title={skillsTitle ?? `已启用技能 ${skillNamesShown.length} 个`}
+        className="position-roundtable-skills-section"
         extra={
           editing ? (
             <Button
@@ -854,7 +906,9 @@ export function AgentDetailPanel({
   const panelChrome = (collapseButton: ReactNode) => (
     <>
       <div className="flex h-12 shrink-0 items-center justify-between border-b px-4">
-        <span className="shrink-0 whitespace-nowrap text-sm font-semibold">智能体信息</span>
+        <span className="shrink-0 whitespace-nowrap text-sm font-semibold">
+          {panelTitle ?? "智能体信息"}
+        </span>
         <div className="flex min-w-0 items-center gap-1">
           {headerActions}
           {compactAppearanceActions}
@@ -868,7 +922,11 @@ export function AgentDetailPanel({
   return (
     <>
       {/* ── Desktop (lg+): inline aside, collapsible to a rail ───────────── */}
-      {collapsed ? (
+      {embedded ? (
+        <aside className="bg-card/40 flex h-full w-full min-w-0 shrink-0 flex-col border-l">
+          {panelChrome(null)}
+        </aside>
+      ) : collapsed ? (
         <div className="hidden shrink-0 items-start border-l px-2 pt-3 lg:flex">
           <div className="flex items-center gap-1">
             {compactAppearanceActions}
@@ -901,30 +959,34 @@ export function AgentDetailPanel({
         </aside>
       )}
 
-      {/* ── Narrow screens (<lg): rail trigger + drawer with the same body ── */}
-      <div className="flex shrink-0 flex-col items-center border-l pt-3 lg:hidden">
-        <Tooltip content="智能体信息">
-          <Button
-            variant="ghost"
-            size="icon-sm"
-            onClick={() => setMobileOpen(true)}
-            aria-label="打开智能体信息"
-          >
-            <InfoIcon className="size-4" />
-          </Button>
-        </Tooltip>
-      </div>
-      <Sheet open={mobileOpen} onOpenChange={setMobileOpen}>
-        <SheetContent side="right" className="flex w-full flex-col gap-0 p-0 sm:max-w-md">
-          <SheetHeader className="border-b px-4 pb-3 pt-4">
-            <SheetTitle className="flex items-center justify-between text-sm">
-              智能体信息
-              <span className="mr-6">{headerActions}</span>
-            </SheetTitle>
-          </SheetHeader>
-          <div className="min-h-0 flex-1 overflow-y-auto">{body}</div>
-        </SheetContent>
-      </Sheet>
+      {!embedded && (
+        <>
+          {/* ── Narrow screens (<lg): rail trigger + drawer with the same body ── */}
+          <div className="flex shrink-0 flex-col items-center border-l pt-3 lg:hidden">
+            <Tooltip content="智能体信息">
+              <Button
+                variant="ghost"
+                size="icon-sm"
+                onClick={() => setMobileOpen(true)}
+                aria-label="打开智能体信息"
+              >
+                <InfoIcon className="size-4" />
+              </Button>
+            </Tooltip>
+          </div>
+          <Sheet open={mobileOpen} onOpenChange={setMobileOpen}>
+            <SheetContent side="right" className="flex w-full flex-col gap-0 p-0 sm:max-w-md">
+              <SheetHeader className="border-b px-4 pb-3 pt-4">
+                <SheetTitle className="flex items-center justify-between text-sm">
+                  智能体信息
+                  <span className="mr-6">{headerActions}</span>
+                </SheetTitle>
+              </SheetHeader>
+              <div className="min-h-0 flex-1 overflow-y-auto">{body}</div>
+            </SheetContent>
+          </Sheet>
+        </>
+      )}
 
       {/* ── Secondary surfaces ───────────────────────────────────────────── */}
       <SkillPickerSheet
diff --git a/frontend-web/src/components/workspace/artifacts/artifact-file-detail.tsx b/frontend-web/src/components/workspace/artifacts/artifact-file-detail.tsx
index fa0fec1c..7dc78695 100644
--- a/frontend-web/src/components/workspace/artifacts/artifact-file-detail.tsx
+++ b/frontend-web/src/components/workspace/artifacts/artifact-file-detail.tsx
@@ -121,8 +121,9 @@ function findScrollableArtifactElement(root: HTMLElement | null) {
 
 export function ArtifactFileDetail({
   className,
-  filepath: filepathFromProps,
-  threadId,
+  filepath: filepathFromProps,
+  threadId,
+  mimeType = null,
   onClose,
   allowVirtualMarkdownEdit = false,
   disableDesensitize = false,
@@ -131,6 +132,8 @@ export function ArtifactFileDetail({
   className?: string;
   filepath: string;
   threadId: string;
+  /** Server/tool supplied type wins over path guessing when available. */
+  mimeType?: string | null;
   /** 覆盖默认关闭行为（仅 setOpen(false)）；圆桌 Step3 文件预览用于退出沙箱模式。 */
   onClose?: () => void;
   /**
@@ -150,16 +153,38 @@ export function ArtifactFileDetail({
   const { t } = useI18n();
   const { artifacts, setOpen, select } = useArtifacts();
   const { isMock, thread, publicShareCode } = useThread();
-  const isWriteFileVirtual = useMemo(() => {
-    return filepathFromProps.startsWith("write-file:");
-  }, [filepathFromProps]);
-  const filepath = useMemo(() => {
-    if (isWriteFileVirtual) {
-      const url = new URL(filepathFromProps);
-      return decodeURIComponent(url.pathname);
-    }
-    return filepathFromProps;
-  }, [filepathFromProps, isWriteFileVirtual]);
+  const isWriteFileVirtual = useMemo(() => {
+    return filepathFromProps.startsWith("write-file:");
+  }, [filepathFromProps]);
+  // A streamed tool call can be opened before the path has been normalized by
+  // the artifacts API. Keep the format supplied by the writer so Markdown is
+  // rendered as Markdown instead of falling back to a TEXT source preview.
+  const writeFileLanguageHint = useMemo(() => {
+    if (!isWriteFileVirtual) return null;
+    try {
+      const language = new URL(filepathFromProps).searchParams.get("language");
+      return language === "markdown" ? language : null;
+    } catch {
+      return null;
+    }
+  }, [filepathFromProps, isWriteFileVirtual]);
+  const mimeLanguageHint = useMemo(() => {
+    const normalized = mimeType?.toLowerCase().trim() ?? "";
+    if (normalized.includes("markdown")) return "markdown";
+    if (normalized.includes("html")) return "html";
+    if (normalized.includes("mermaid")) return "mermaid";
+    if (normalized.startsWith("text/")) return "text";
+    return null;
+  }, [mimeType]);
+  const filepath = useMemo(() => {
+    if (isWriteFileVirtual) {
+      const url = new URL(filepathFromProps);
+      return decodeURIComponent(url.pathname).trim();
+    }
+    // Tool arguments may contain harmless surrounding whitespace. Passing it
+    // into extension detection turns `report.md ` into a generic TEXT file.
+    return filepathFromProps.trim();
+  }, [filepathFromProps, isWriteFileVirtual]);
   const isSkillFile = useMemo(() => {
     return filepath.endsWith(".skill");
   }, [filepath]);
@@ -186,17 +211,22 @@ export function ArtifactFileDetail({
   const useWriteFileStreaming = useMemo(() => {
     return isWriteFileVirtual && !isImageFile(filepath) && !editVirtualMarkdown;
   }, [filepath, isWriteFileVirtual, editVirtualMarkdown]);
-  const { isCodeFile, language } = useMemo(() => {
-    if (useWriteFileStreaming) {
-      let nextLanguage = checkCodeFile(filepath).language;
-      nextLanguage ??= "text";
-      return { isCodeFile: true, language: nextLanguage };
+  const { isCodeFile, language } = useMemo(() => {
+    if (useWriteFileStreaming) {
+      let nextLanguage =
+        mimeLanguageHint ?? writeFileLanguageHint ?? checkCodeFile(filepath).language;
+      nextLanguage ??= "text";
+      return { isCodeFile: true, language: nextLanguage };
     }
     if (isSkillFile) {
       return { isCodeFile: true, language: "markdown" };
     }
-    return checkCodeFile(filepath);
-  }, [filepath, useWriteFileStreaming, isSkillFile]);
+    const detected = checkCodeFile(filepath);
+    if (mimeLanguageHint) {
+      return { isCodeFile: true as const, language: mimeLanguageHint };
+    }
+    return detected;
+  }, [filepath, useWriteFileStreaming, isSkillFile, mimeLanguageHint, writeFileLanguageHint]);
   const isSupportPreview = useMemo(() => {
     return (
       language === "html" ||
@@ -209,7 +239,8 @@ export function ArtifactFileDetail({
     // editVirtualMarkdown：用解码后的真实路径走 artifacts API（而非 write-file 虚拟
     // URL），这样保存后 useUpdateArtifactContent 写入的查询缓存才能命中，编辑内容
     // 不会被旧的内存 stub 值覆盖回退。
-    filepath: editVirtualMarkdown ? filepath : filepathFromProps,
+    filepath:
+      editVirtualMarkdown || !isWriteFileVirtual ? filepath : filepathFromProps,
     enabled: isCodeFile && !useWriteFileStreaming,
   });
 
diff --git a/frontend-web/src/components/workspace/chats/chat-box.tsx b/frontend-web/src/components/workspace/chats/chat-box.tsx
index 295d047a..342abb5e 100644
--- a/frontend-web/src/components/workspace/chats/chat-box.tsx
+++ b/frontend-web/src/components/workspace/chats/chat-box.tsx
@@ -15,6 +15,7 @@ import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
 import { apiFetch } from "@/core/api";
 import { getBackendBaseURL } from "@/core/config";
 import { isThreadRagModeLocked, useLocalSettings } from "@/core/settings";
+import { isSingleRoundRagMessage } from "@/core/threads/use-single-round-rag";
 import { useSkills } from "@/core/skills/hooks";
 import type { SkillDisplayConfig } from "@/core/skills/type";
 import {
@@ -92,6 +93,13 @@ const ChatBox: React.FC<{
   const [settings] = useLocalSettings();
   const ragModeEnabled =
     settings.display.ragModeEnabled || isThreadRagModeLocked(threadId);
+  // Frontend single-round RAG writes its own source tool message, so it should
+  // use the same reference panel without changing the user's global RAG mode.
+  const hasSingleRoundRag = useMemo(
+    () => (thread.values.messages ?? []).some(isSingleRoundRagMessage),
+    [thread.values.messages],
+  );
+  const referencesEnabled = ragModeEnabled || hasSingleRoundRag;
   const { skills } = useSkills();
 
   const {
@@ -106,11 +114,11 @@ const ChatBox: React.FC<{
 
   const [autoSelectFirstArtifact, setAutoSelectFirstArtifact] = useState(true);
   const skillDisplayMap = useMemo(
-    () => (ragModeEnabled ? buildSkillDisplayMap(skills) : new Map()),
-    [ragModeEnabled, skills],
+    () => (referencesEnabled ? buildSkillDisplayMap(skills) : new Map()),
+    [referencesEnabled, skills],
   );
   const fallbackReferenceBatches = useMemo(() => {
-    if (!ragModeEnabled) {
+    if (!referencesEnabled) {
       return [];
     }
     return buildTurnReferenceBatches(
@@ -118,9 +126,9 @@ const ChatBox: React.FC<{
       skillDisplayMap,
       thread.isLoading,
     );
-  }, [ragModeEnabled, skillDisplayMap, thread.isLoading, thread.values.messages]);
+  }, [referencesEnabled, skillDisplayMap, thread.isLoading, thread.values.messages]);
   useEffect(() => {
-    if (!ragModeEnabled) {
+    if (!referencesEnabled) {
       setBackendReferenceBatches([]);
       return;
     }
@@ -156,7 +164,7 @@ const ChatBox: React.FC<{
         }
       });
     return () => controller.abort();
-  }, [ragModeEnabled, thread.isLoading, threadId, thread.values.messages]);
+  }, [referencesEnabled, thread.isLoading, threadId, thread.values.messages]);
   const adaptedBackendReferenceBatches = useMemo(
     () =>
       adaptBackendReferenceBatches(
@@ -175,7 +183,7 @@ const ChatBox: React.FC<{
     [adaptedBackendReferenceBatches, fallbackReferenceBatches],
   );
   useEffect(() => {
-    if (!ragModeEnabled) {
+    if (!referencesEnabled) {
       return;
     }
     const signature = JSON.stringify({
@@ -202,7 +210,7 @@ const ChatBox: React.FC<{
       fallbackBatches: debugReferenceBatches(fallbackReferenceBatches),
       finalBatches: debugReferenceBatches(referenceBatches),
     });
-  }, [adaptedBackendReferenceBatches, backendReferenceBatches, fallbackReferenceBatches, ragModeEnabled, referenceBatches, threadId]);
+  }, [adaptedBackendReferenceBatches, backendReferenceBatches, fallbackReferenceBatches, referencesEnabled, referenceBatches, threadId]);
   const latestReferenceBatch =
     referenceBatches.length > 0
       ? referenceBatches[referenceBatches.length - 1]!
@@ -213,7 +221,7 @@ const ChatBox: React.FC<{
   const referenceSources = activeReferenceBatch?.sources ?? [];
   const hasCitationReferences = referenceSources.length > 0;
   useEffect(() => {
-    if (!ragModeEnabled || !activeReferenceBatch) {
+    if (!referencesEnabled || !activeReferenceBatch) {
       return;
     }
     logReferenceDebug("frontend-active-reference-batch-payload", threadId, {
@@ -222,7 +230,7 @@ const ChatBox: React.FC<{
       sourceCount: activeReferenceBatch.sources.length,
       sources: activeReferenceBatch.sources.map(debugReferenceSource),
     });
-  }, [activeReferenceBatch, ragModeEnabled, threadId]);
+  }, [activeReferenceBatch, referencesEnabled, threadId]);
   useEffect(() => {
     if (hasCitationReferences) {
       setReferencesOpen(true);
diff --git a/frontend-web/src/components/workspace/input-box.tsx b/frontend-web/src/components/workspace/input-box.tsx
index 4e35ac23..da77009e 100644
--- a/frontend-web/src/components/workspace/input-box.tsx
+++ b/frontend-web/src/components/workspace/input-box.tsx
@@ -65,6 +65,7 @@ import { getBackendBaseURL } from "@/core/config";
 import { useI18n } from "@/core/i18n/hooks";
 import { isHiddenFromUIMessage } from "@/core/messages/utils";
 import { useModels } from "@/core/models/hooks";
+import type { Model } from "@/core/models/types";
 import type { AgentThreadContext } from "@/core/threads";
 import { textOfMessage } from "@/core/threads/utils";
 import { desensitize } from "@/lib/desensitize";
@@ -136,6 +137,7 @@ export function InputBox({
   promptPrefix,
   agentSelector,
   knowledgeSelector,
+  extraModels = [],
   assistantId,
   hideAdminRecommendedQuestions,
   compact,
@@ -198,12 +200,19 @@ export function InputBox({
   };
   /** WeKnora-style knowledge-space picker rendered inside the composer toolbar. */
   knowledgeSelector?: ReactNode;
+  /** Page-scoped model choices implemented outside the DeerFlow model API. */
+  extraModels?: Model[];
 }) {
   const { t } = useI18n();
   const [localSettings, setLocalSettings] = useLocalSettings();
   const searchParams = useSearchParams();
-  const [modelDialogOpen, setModelDialogOpen] = useState(false);
-  const { models } = useModels();
+  const [modelDialogOpen, setModelDialogOpen] = useState(false);
+  const { models } = useModels();
+  const singleRoundRagActive =
+    context.execution_profile === "single_round_rag";
+  const modelOptions = useMemo(() => {
+    return singleRoundRagActive ? extraModels : models;
+  }, [extraModels, models, singleRoundRagActive]);
   const { thread, isMock } = useThread();
   const { textInput } = usePromptInputController();
   const promptRootRef = useRef<HTMLDivElement | null>(null);
@@ -227,34 +236,40 @@ export function InputBox({
     recommendedQuestions.length > 0;
 
   useEffect(() => {
-    if (models.length === 0) {
-      return;
-    }
-    const currentModel = models.find((m) => m.name === context.model_name);
-    const fallbackModel = currentModel ?? models[0]!;
+    if (modelOptions.length === 0) {
+      return;
+    }
+    const currentModel = modelOptions.find((m) => m.name === context.model_name);
+    const fallbackModel = currentModel ?? modelOptions[0]!;
     const supportsThinking = fallbackModel.supports_thinking ?? false;
     const nextModelName = fallbackModel.name;
     const nextMode = getResolvedMode(context.mode, supportsThinking);
 
-    if (context.model_name === nextModelName && context.mode === nextMode) {
-      return;
-    }
+    if (
+      context.model_name === nextModelName &&
+      context.mode === nextMode &&
+      context.execution_profile === fallbackModel.execution_profile
+    ) {
+      return;
+    }
 
     onContextChange?.({
-      ...context,
-      model_name: nextModelName,
-      mode: nextMode,
-    });
-  }, [context, models, onContextChange]);
+      ...context,
+      model_name: nextModelName,
+      mode: nextMode,
+      execution_profile: fallbackModel.execution_profile,
+    });
+  }, [context, modelOptions, onContextChange]);
+
+  const selectedModel = useMemo(() => {
+    if (modelOptions.length === 0) {
+      return undefined;
+    }
+    return modelOptions.find((m) => m.name === context.model_name) ?? modelOptions[0];
+  }, [context.model_name, modelOptions]);
 
-  const selectedModel = useMemo(() => {
-    if (models.length === 0) {
-      return undefined;
-    }
-    return models.find((m) => m.name === context.model_name) ?? models[0];
-  }, [context.model_name, models]);
-
-  const resolvedModelName = selectedModel?.name;
+  const resolvedModelName = selectedModel?.name;
+  const selectedSingleRoundRag = singleRoundRagActive;
 
   const supportThinking = useMemo(
     () => selectedModel?.supports_thinking ?? false,
@@ -268,38 +283,65 @@ export function InputBox({
 
   const handleModelSelect = useCallback(
     (model_name: string) => {
-      const model = models.find((m) => m.name === model_name);
+      const model = modelOptions.find((m) => m.name === model_name);
       if (!model) {
         return;
       }
       onContextChange?.({
         ...context,
         model_name,
-        mode: getResolvedMode(context.mode, model.supports_thinking ?? false),
-        reasoning_effort: context.reasoning_effort,
-      });
-      setModelDialogOpen(false);
-    },
-    [onContextChange, context, models],
+        mode: getResolvedMode(context.mode, model.supports_thinking ?? false),
+        reasoning_effort: context.reasoning_effort,
+        execution_profile: model.execution_profile,
+      });
+      setModelDialogOpen(false);
+    },
+    [onContextChange, context, modelOptions],
   );
 
-  const handleModeSelect = useCallback(
-    (mode: InputMode) => {
-      onContextChange?.({
-        ...context,
-        mode: getResolvedMode(mode, supportThinking),
-        reasoning_effort:
-          mode === "ultra"
-            ? "high"
+  const handleModeSelect = useCallback(
+    (mode: InputMode) => {
+      const ordinaryModel =
+        models.find((model) => model.name === context.model_name) ?? models[0];
+      onContextChange?.({
+        ...context,
+        model_name: ordinaryModel?.name ?? context.model_name,
+        mode: getResolvedMode(
+          mode,
+          ordinaryModel?.supports_thinking ?? supportThinking,
+        ),
+        reasoning_effort:
+          mode === "ultra"
+            ? "high"
             : mode === "pro"
               ? "medium"
               : mode === "thinking"
-                ? "low"
-                : "minimal",
-      });
-    },
-    [onContextChange, context, supportThinking],
-  );
+                ? "low"
+                : "minimal",
+        execution_profile: undefined,
+      });
+    },
+    [onContextChange, context, models, supportThinking],
+  );
+
+  const handleSingleRoundRagSelect = useCallback(() => {
+    const ragModel =
+      extraModels.find((model) => model.name === context.model_name) ??
+      extraModels[0];
+    if (!ragModel) {
+      return;
+    }
+
+    onContextChange?.({
+      ...context,
+      model_name: ragModel.name,
+      mode: getResolvedMode(
+        context.mode,
+        ragModel.supports_thinking ?? false,
+      ),
+      execution_profile: "single_round_rag",
+    });
+  }, [context, extraModels, onContextChange]);
 
   const handleReasoningEffortSelect = useCallback(
     (effort: "minimal" | "low" | "medium" | "high") => {
@@ -365,10 +407,11 @@ export function InputBox({
         onContextChange?.({
           ...context,
           model_name: resolvedModelName,
-          mode: getResolvedMode(
-            context.mode,
-            selectedModel?.supports_thinking ?? false,
-          ),
+          mode: getResolvedMode(
+            context.mode,
+            selectedModel?.supports_thinking ?? false,
+          ),
+          execution_profile: selectedModel?.execution_profile,
         });
         setTimeout(() => onSubmit?.(message), 0);
         return;
@@ -383,7 +426,8 @@ export function InputBox({
       onStop,
       resolvedModelName,
       ragModeEnabled,
-      selectedModel?.supports_thinking,
+      selectedModel?.supports_thinking,
+      selectedModel?.execution_profile,
       status,
       threadId,
     ],
@@ -441,8 +485,9 @@ export function InputBox({
   }, [pendingSuggestion, requestFormSubmit, textInput]);
 
   const showFollowups =
-    !disabled &&
-    !isNewThread &&
+    !disabled &&
+    !isNewThread &&
+    !selectedSingleRoundRag &&
     !followupsHidden &&
     (followupsLoading || followups.length > 0);
 
@@ -468,7 +513,7 @@ export function InputBox({
       return;
     }
 
-    if (disabled || isMock) {
+    if (disabled || isMock || selectedSingleRoundRag) {
       return;
     }
 
@@ -530,7 +575,7 @@ export function InputBox({
       });
 
     return () => controller.abort();
-  }, [context.model_name, disabled, isMock, status, thread.messages, threadId]);
+  }, [context.model_name, disabled, isMock, selectedSingleRoundRag, status, thread.messages, threadId]);
 
   return (
     <div ref={promptRootRef} className="relative flex flex-col gap-6">
@@ -786,54 +831,64 @@ export function InputBox({
               </PromptInputButton>
             </Tooltip>
             <PromptInputActionMenu>
-              <ModeHoverGuide
-                mode={
+              <ModeHoverGuide
+                mode={
                   context.mode === "flash" ||
                   context.mode === "thinking" ||
                   context.mode === "pro" ||
                   context.mode === "ultra"
-                    ? context.mode
-                    : "flash"
-                }
-              >
+                    ? context.mode
+                    : "flash"
+                }
+                tooltipContent={
+                  selectedSingleRoundRag
+                    ? "单轮 RAG 问答：基于知识库检索生成答案，并展示参考资料"
+                    : undefined
+                }
+              >
                 <PromptInputActionMenuTrigger
                   className={cn(
                     "gap-1.5! rounded-full border-0 bg-transparent px-3! text-muted-foreground shadow-none hover:bg-muted/70 hover:text-foreground dark:text-slate-400 dark:hover:bg-slate-700/70 dark:hover:text-slate-100",
                     compact && "rounded-lg border px-2.5! py-1! text-[11px] font-medium",
-                    compact &&
-                      (context.mode === "thinking"
-                        ? "border-indigo-200 bg-indigo-50/60 text-indigo-700 hover:bg-indigo-100 dark:border-indigo-700 dark:bg-indigo-950/40 dark:text-indigo-200"
+                    compact &&
+                      (selectedSingleRoundRag
+                        ? "border-emerald-200 bg-emerald-50/60 text-emerald-700 hover:bg-emerald-100 dark:border-emerald-700 dark:bg-emerald-950/40 dark:text-emerald-200"
+                        : context.mode === "thinking"
+                        ? "border-indigo-200 bg-indigo-50/60 text-indigo-700 hover:bg-indigo-100 dark:border-indigo-700 dark:bg-indigo-950/40 dark:text-indigo-200"
                         : context.mode === "pro"
                           ? "border-violet-200 bg-violet-50/60 text-violet-700 hover:bg-violet-100 dark:border-violet-700 dark:bg-violet-950/40 dark:text-violet-200"
                           : context.mode === "ultra"
                             ? "border-amber-200 bg-amber-50/60 text-amber-700 hover:bg-amber-100 dark:border-amber-700 dark:bg-amber-950/40 dark:text-amber-200"
                             : "border-transparent bg-muted/40 hover:bg-muted hover:text-foreground"),
                   )}
-                >
-                  <div>
-                    {context.mode === "flash" && <ZapIcon className="size-3" />}
-                    {context.mode === "thinking" && (
-                      <LightbulbIcon className="size-3" />
-                    )}
-                    {context.mode === "pro" && (
-                      <GraduationCapIcon className="size-3" />
-                    )}
-                    {context.mode === "ultra" && (
-                      <RocketIcon className="size-3 text-[#dabb5e]" />
-                    )}
-                  </div>
+                  >
+                    <div>
+                    {selectedSingleRoundRag ? (
+                      <BookMarkedIcon className="size-3" />
+                    ) : context.mode === "flash" ? (
+                      <ZapIcon className="size-3" />
+                    ) : context.mode === "thinking" ? (
+                      <LightbulbIcon className="size-3" />
+                    ) : context.mode === "pro" ? (
+                      <GraduationCapIcon className="size-3" />
+                    ) : context.mode === "ultra" ? (
+                      <RocketIcon className="size-3 text-[#dabb5e]" />
+                    ) : null}
+                    </div>
                   <div
                     className={cn(
                       "text-xs font-normal",
                       context.mode === "ultra" ? "golden-text" : "",
                     )}
                   >
-                    {(context.mode === "flash" && t.inputBox.flashMode) ||
-                      (context.mode === "thinking" &&
-                        t.inputBox.reasoningMode) ||
-                      (context.mode === "pro" && t.inputBox.proMode) ||
-                      (context.mode === "ultra" && t.inputBox.ultraMode)}
-                  </div>
+                    {selectedSingleRoundRag
+                      ? "单轮 RAG"
+                      : (context.mode === "flash" && t.inputBox.flashMode) ||
+                      (context.mode === "thinking" &&
+                        t.inputBox.reasoningMode) ||
+                      (context.mode === "pro" && t.inputBox.proMode) ||
+                      (context.mode === "ultra" && t.inputBox.ultraMode)}
+                  </div>
                 </PromptInputActionMenuTrigger>
               </ModeHoverGuide>
               <PromptInputActionMenuContent className="w-80">
@@ -842,11 +897,11 @@ export function InputBox({
                     {t.inputBox.mode}
                   </DropdownMenuLabel>
                   <PromptInputActionMenu>
-                    <PromptInputActionMenuItem
-                      className={cn(
-                        context.mode === "flash"
-                          ? "text-accent-foreground"
-                          : "text-muted-foreground/65",
+                    <PromptInputActionMenuItem
+                      className={cn(
+                        !selectedSingleRoundRag && context.mode === "flash"
+                          ? "text-accent-foreground"
+                          : "text-muted-foreground/65",
                       )}
                       onSelect={() => handleModeSelect("flash")}
                     >
@@ -854,9 +909,9 @@ export function InputBox({
                         <div className="flex items-center gap-1 font-bold">
                           <ZapIcon
                             className={cn(
-                              "mr-2 size-4",
-                              context.mode === "flash" &&
-                                "text-accent-foreground",
+                              "mr-2 size-4",
+                              !selectedSingleRoundRag && context.mode === "flash" &&
+                                "text-accent-foreground",
                             )}
                           />
                           {t.inputBox.flashMode}
@@ -865,7 +920,7 @@ export function InputBox({
                           {t.inputBox.flashModeDescription}
                         </div>
                       </div>
-                      {context.mode === "flash" ? (
+                      {!selectedSingleRoundRag && context.mode === "flash" ? (
                         <CheckIcon className="ml-auto size-4" />
                       ) : (
                         <div className="ml-auto size-4" />
@@ -873,9 +928,9 @@ export function InputBox({
                     </PromptInputActionMenuItem>
                     {supportThinking && (
                       <PromptInputActionMenuItem
-                        className={cn(
-                          context.mode === "thinking"
-                            ? "text-accent-foreground"
+                        className={cn(
+                          !selectedSingleRoundRag && context.mode === "thinking"
+                            ? "text-accent-foreground"
                             : "text-muted-foreground/65",
                         )}
                         onSelect={() => handleModeSelect("thinking")}
@@ -884,9 +939,9 @@ export function InputBox({
                           <div className="flex items-center gap-1 font-bold">
                             <LightbulbIcon
                               className={cn(
-                                "mr-2 size-4",
-                                context.mode === "thinking" &&
-                                  "text-accent-foreground",
+                                "mr-2 size-4",
+                                !selectedSingleRoundRag && context.mode === "thinking" &&
+                                  "text-accent-foreground",
                               )}
                             />
                             {t.inputBox.reasoningMode}
@@ -895,7 +950,7 @@ export function InputBox({
                             {t.inputBox.reasoningModeDescription}
                           </div>
                         </div>
-                        {context.mode === "thinking" ? (
+                        {!selectedSingleRoundRag && context.mode === "thinking" ? (
                           <CheckIcon className="ml-auto size-4" />
                         ) : (
                           <div className="ml-auto size-4" />
@@ -903,8 +958,8 @@ export function InputBox({
                       </PromptInputActionMenuItem>
                     )}
                     <PromptInputActionMenuItem
-                      className={cn(
-                        context.mode === "pro"
+                      className={cn(
+                        !selectedSingleRoundRag && context.mode === "pro"
                           ? "text-accent-foreground"
                           : "text-muted-foreground/65",
                       )}
@@ -914,8 +969,8 @@ export function InputBox({
                         <div className="flex items-center gap-1 font-bold">
                           <GraduationCapIcon
                             className={cn(
-                              "mr-2 size-4",
-                              context.mode === "pro" &&
+                              "mr-2 size-4",
+                              !selectedSingleRoundRag && context.mode === "pro" &&
                                 "text-accent-foreground",
                             )}
                           />
@@ -925,15 +980,15 @@ export function InputBox({
                           {t.inputBox.proModeDescription}
                         </div>
                       </div>
-                      {context.mode === "pro" ? (
+                      {!selectedSingleRoundRag && context.mode === "pro" ? (
                         <CheckIcon className="ml-auto size-4" />
                       ) : (
                         <div className="ml-auto size-4" />
                       )}
                     </PromptInputActionMenuItem>
                     <PromptInputActionMenuItem
-                      className={cn(
-                        context.mode === "ultra"
+                      className={cn(
+                        !selectedSingleRoundRag && context.mode === "ultra"
                           ? "text-accent-foreground"
                           : "text-muted-foreground/65",
                       )}
@@ -943,13 +998,17 @@ export function InputBox({
                         <div className="flex items-center gap-1 font-bold">
                           <RocketIcon
                             className={cn(
-                              "mr-2 size-4",
-                              context.mode === "ultra" && "text-[#dabb5e]",
+                              "mr-2 size-4",
+                              !selectedSingleRoundRag &&
+                                context.mode === "ultra" &&
+                                "text-[#dabb5e]",
                             )}
                           />
                           <div
                             className={cn(
-                              context.mode === "ultra" && "golden-text",
+                              !selectedSingleRoundRag &&
+                                context.mode === "ultra" &&
+                                "golden-text",
                             )}
                           >
                             {t.inputBox.ultraMode}
@@ -959,13 +1018,46 @@ export function InputBox({
                           {t.inputBox.ultraModeDescription}
                         </div>
                       </div>
-                      {context.mode === "ultra" ? (
+                      {!selectedSingleRoundRag && context.mode === "ultra" ? (
                         <CheckIcon className="ml-auto size-4" />
                       ) : (
                         <div className="ml-auto size-4" />
                       )}
-                    </PromptInputActionMenuItem>
-                  </PromptInputActionMenu>
+                    </PromptInputActionMenuItem>
+                    {extraModels.length > 0 && (
+                      <>
+                        <DropdownMenuSeparator className="my-2" />
+                        <PromptInputActionMenuItem
+                          className={cn(
+                            selectedSingleRoundRag
+                              ? "bg-emerald-50 text-emerald-800 hover:bg-emerald-100 focus:bg-emerald-100 dark:bg-emerald-950/40 dark:text-emerald-200 dark:hover:bg-emerald-950/60 dark:focus:bg-emerald-950/60"
+                              : "text-muted-foreground/65",
+                          )}
+                          onSelect={handleSingleRoundRagSelect}
+                        >
+                          <div className="flex flex-col gap-2">
+                            <div className="flex items-center gap-1 font-bold">
+                              <BookMarkedIcon
+                                className={cn(
+                                  "mr-2 size-4",
+                                  selectedSingleRoundRag && "text-emerald-700 dark:text-emerald-200",
+                                )}
+                              />
+                              单轮 RAG 问答
+                            </div>
+                            <div className="pl-7 text-xs">
+                              基于知识库检索生成答案，并展示思考内容与参考资料
+                            </div>
+                          </div>
+                          {selectedSingleRoundRag ? (
+                            <CheckIcon className="ml-auto size-4" />
+                          ) : (
+                            <div className="ml-auto size-4" />
+                          )}
+                        </PromptInputActionMenuItem>
+                      </>
+                    )}
+                  </PromptInputActionMenu>
                 </DropdownMenuGroup>
               </PromptInputActionMenuContent>
             </PromptInputActionMenu>
@@ -1151,7 +1243,7 @@ export function InputBox({
               <ModelSelectorContent>
                 <ModelSelectorInput placeholder={t.inputBox.searchModels} />
                 <ModelSelectorList>
-                  {models.map((m) => (
+                  {modelOptions.map((m) => (
                     <ModelSelectorItem
                       key={m.name}
                       value={m.name}
@@ -1159,9 +1251,11 @@ export function InputBox({
                     >
                       <div className="flex min-w-0 flex-1 flex-col">
                         <ModelSelectorName>{m.display_name}</ModelSelectorName>
-                        <span className="text-muted-foreground truncate text-[10px]">
-                          {m.model}
-                        </span>
+                        <span className="text-muted-foreground truncate text-[10px]">
+                          {selectedSingleRoundRag
+                            ? `单轮知识库问答 · ${m.name}`
+                            : m.model}
+                        </span>
                       </div>
                       {m.name === context.model_name ? (
                         <CheckIcon className="ml-auto size-4" />
@@ -1169,8 +1263,8 @@ export function InputBox({
                         <div className="ml-auto size-4" />
                       )}
                     </ModelSelectorItem>
-                  ))}
-                </ModelSelectorList>
+                  ))}
+                </ModelSelectorList>
               </ModelSelectorContent>
             </ModelSelector>
             <PromptInputSubmit
diff --git a/frontend-web/src/components/workspace/messages/message-list.tsx b/frontend-web/src/components/workspace/messages/message-list.tsx
index 07e33688..d96ce5fa 100644
--- a/frontend-web/src/components/workspace/messages/message-list.tsx
+++ b/frontend-web/src/components/workspace/messages/message-list.tsx
@@ -33,7 +33,8 @@ import {
 } from "@/core/skill-display/runtime";
 import type { Subtask } from "@/core/tasks";
 import { useUpdateSubtask } from "@/core/tasks/context";
-import type { AgentThreadState } from "@/core/threads";
+import type { AgentThreadState } from "@/core/threads";
+import { isSingleRoundRagMessage } from "@/core/threads/use-single-round-rag";
 import { cn } from "@/lib/utils";
 import { resolveAllowMultiple } from "@/roundtable-planning/lib/clarification";
 
@@ -235,12 +236,17 @@ export function MessageList({
   }, [messages, askTimes]);
 
   const [settings] = useLocalSettings();
-  const ragModeEnabled =
-    settings.display.ragModeEnabled || isThreadRagModeLocked(threadId);
-  const { skills } = useSkills();
-  const skillDisplayMap = useMemo(
-    () => (ragModeEnabled ? buildSkillDisplayMap(skills) : new Map()),
-    [ragModeEnabled, skills],
+  const ragModeEnabled =
+    settings.display.ragModeEnabled || isThreadRagModeLocked(threadId);
+  const hasSingleRoundRag = useMemo(
+    () => messages.some(isSingleRoundRagMessage),
+    [messages],
+  );
+  const referencesEnabled = ragModeEnabled || hasSingleRoundRag;
+  const { skills } = useSkills();
+  const skillDisplayMap = useMemo(
+    () => (referencesEnabled ? buildSkillDisplayMap(skills) : new Map()),
+    [referencesEnabled, skills],
   );
   // Same per-turn reference batches the right-side panel renders (backend
   // batches preferred). Inline [n] tokens must resolve against these so badge
@@ -373,7 +379,7 @@ export function MessageList({
           if (group.type === "human" || group.type === "assistant") {
             return group.messages.map((msg) => {
               const isAssistantMessage =
-                ragModeEnabled &&
+                referencesEnabled &&
                 group.type === "assistant" &&
                 msg.type === "ai";
               const batchSources = isAssistantMessage
diff --git a/frontend-web/src/components/workspace/mode-hover-guide.tsx b/frontend-web/src/components/workspace/mode-hover-guide.tsx
index 6a76eb5a..bb9bd24d 100644
--- a/frontend-web/src/components/workspace/mode-hover-guide.tsx
+++ b/frontend-web/src/components/workspace/mode-hover-guide.tsx
@@ -46,20 +46,23 @@ function getModeDescriptionKey(
   }
 }
 
-export function ModeHoverGuide({
-  mode,
-  children,
-  showTitle = true,
-}: {
-  mode: AgentMode;
-  children: React.ReactNode;
-  /** When true, tooltip shows "ModeName: Description". When false, only description. */
-  showTitle?: boolean;
-}) {
-  const { t } = useI18n();
-  const label = t.inputBox[getModeLabelKey(mode)];
-  const description = t.inputBox[getModeDescriptionKey(mode)];
-  const content = showTitle ? `${label}: ${description}` : description;
+export function ModeHoverGuide({
+  mode,
+  children,
+  showTitle = true,
+  tooltipContent,
+}: {
+  mode: AgentMode;
+  children: React.ReactNode;
+  /** When true, tooltip shows "ModeName: Description". When false, only description. */
+  showTitle?: boolean;
+  /** Overrides the standard mode tooltip for page-specific execution modes. */
+  tooltipContent?: string;
+}) {
+  const { t } = useI18n();
+  const label = t.inputBox[getModeLabelKey(mode)];
+  const description = t.inputBox[getModeDescriptionKey(mode)];
+  const content = tooltipContent ?? (showTitle ? `${label}: ${description}` : description);
 
   return <Tooltip content={content}>{children}</Tooltip>;
 }
diff --git a/frontend-web/src/components/workspace/settings/skill-settings-page.tsx b/frontend-web/src/components/workspace/settings/skill-settings-page.tsx
index 4f6a3e7d..42f92a24 100644
--- a/frontend-web/src/components/workspace/settings/skill-settings-page.tsx
+++ b/frontend-web/src/components/workspace/settings/skill-settings-page.tsx
@@ -71,8 +71,9 @@ import { useTheme } from "@/contexts/ThemeContext";
 import { getStoredAuth } from "@/core/auth";
 import { useI18n } from "@/core/i18n/hooks";
 import type { ValidateSkillUploadResponse } from "@/core/skills/api";
-import {
-  useDeleteCustomSkill,
+import {
+  useDeleteBuiltinSkill,
+  useDeleteCustomSkill,
   useDuplicateSkill,
   useGenerateMissingSkillNameZh,
   useGenerateSkillNameZh,
@@ -616,9 +617,10 @@ export function SkillRow({
   const { data: cardPublishSquares } = usePublishSquares();
   const setPinned = useSetSkillPinned();
   const setFeatured = useSetSkillFeatured();
-  const setAlwaysOn = useSetSkillAlwaysOn();
-  const { data: compression } = useSkillCompressionSettings();
-  const deleteSkill = useDeleteCustomSkill();
+  const setAlwaysOn = useSetSkillAlwaysOn();
+  const { data: compression } = useSkillCompressionSettings();
+  const deleteCustom = useDeleteCustomSkill();
+  const deleteBuiltin = useDeleteBuiltinSkill();
   const duplicateSkillMutation = useDuplicateSkill();
   const [confirmDeleteOpen, setConfirmDeleteOpen] = useState(false);
   const [tagPickerOpen, setTagPickerOpen] = useState(false);
@@ -634,8 +636,9 @@ export function SkillRow({
   const isOwned =
     isCustom && !isBuiltin && !!skill.owner_user_id && skill.owner_user_id === currentUserId;
   const isFromOthers = isCustom && !isBuiltin && !isOwned;
-  // Admin can edit/delete/unpublish anyone's skill; non-admin only their own.
-  const canManage = isCustom && (isOwned || isAdmin);
+  // Admin can manage custom skills from any owner; non-admin only their own.
+  const canManage = isCustom && (isOwned || isAdmin);
+  const canDelete = isAdmin || isOwned;
   const canTogglePublish = canManage && !isBuiltin;
   // 常驻(免压缩):内置技能仅管理员可设;自定义技能其所有者或管理员可设(与后端一致)。
   const canSetAlwaysOn = isAdmin || isOwned;
@@ -686,11 +689,15 @@ export function SkillRow({
     }
   }
 
-  async function handleDelete() {
-    try {
-      await deleteSkill.mutateAsync(skill.name);
-      toast.success(t.settings.skills.deleteSuccess);
-      setConfirmDeleteOpen(false);
+  async function handleDelete() {
+    try {
+      if (isBuiltin) {
+        await deleteBuiltin.mutateAsync(skill.name);
+      } else {
+        await deleteCustom.mutateAsync(skill.name);
+      }
+      toast.success(t.settings.skills.deleteSuccess);
+      setConfirmDeleteOpen(false);
     } catch (err) {
       toast.error(err instanceof Error ? err.message : String(err));
     }
@@ -918,7 +925,7 @@ export function SkillRow({
       >
         <TagsIcon className="size-3.5" />
       </Button>
-      {canManage && (
+      {canManage && (
         <Button
           size="icon"
           variant="ghost"
@@ -939,12 +946,12 @@ export function SkillRow({
           />
         </Button>
       )}
-      {canManage && (
-        <Button
-          size="icon"
-          variant="ghost"
-          className={cn(
-            "h-8 w-8 shrink-0",
+      {canManage && (
+        <Button
+          size="icon"
+          variant="ghost"
+          className={cn(
+            "h-8 w-8 shrink-0",
             skill.pinned && "text-emerald-600 hover:text-emerald-700",
           )}
           disabled={setPinned.isPending}
@@ -1011,11 +1018,11 @@ export function SkillRow({
       >
         <CopyIcon className="size-3.5" />
       </Button>
-      {canManage && (
-        <Button
-          size="icon"
-          variant="ghost"
-          className="text-destructive hover:text-destructive h-8 w-8 shrink-0"
+      {canDelete && (
+        <Button
+          size="icon"
+          variant="ghost"
+          className="text-destructive hover:text-destructive h-8 w-8 shrink-0"
           onClick={() => setConfirmDeleteOpen(true)}
           title={t.settings.skills.deleteAction}
         >
@@ -1109,16 +1116,18 @@ export function SkillRow({
             <Button
               variant="outline"
               onClick={() => setConfirmDeleteOpen(false)}
-              disabled={deleteSkill.isPending}
+              disabled={deleteCustom.isPending || deleteBuiltin.isPending}
             >
               {t.common.cancel}
             </Button>
             <Button
               variant="destructive"
               onClick={() => void handleDelete()}
-              disabled={deleteSkill.isPending}
-            >
-              {deleteSkill.isPending ? t.common.loading : t.common.delete}
+              disabled={deleteCustom.isPending || deleteBuiltin.isPending}
+            >
+              {deleteCustom.isPending || deleteBuiltin.isPending
+                ? t.common.loading
+                : t.common.delete}
             </Button>
           </DialogFooter>
         </DialogContent>
diff --git a/frontend-web/src/components/workspace/skills/skill-file-preview-dialog.tsx b/frontend-web/src/components/workspace/skills/skill-file-preview-dialog.tsx
index 000aa9ae..d9a75f45 100644
--- a/frontend-web/src/components/workspace/skills/skill-file-preview-dialog.tsx
+++ b/frontend-web/src/components/workspace/skills/skill-file-preview-dialog.tsx
@@ -5,6 +5,7 @@ import {
   DownloadIcon,
   Loader2,
   PencilIcon,
+  Trash2Icon,
   XIcon,
 } from "lucide-react";
 import { useEffect, useMemo, useState } from "react";
@@ -22,6 +23,7 @@ import { Textarea } from "@/components/ui/textarea";
 import { MarkdownContent } from "@/components/workspace/messages/markdown-content";
 import { getSkillFileDownloadURL } from "@/core/skills/api";
 import {
+  useDeleteSkillFile,
   useSaveSkillFile,
   useSkillFileContent,
 } from "@/core/skills/hooks";
@@ -66,6 +68,7 @@ export function SkillFilePreviewDialog({
     open ? path : null,
   );
   const save = useSaveSkillFile();
+  const remove = useDeleteSkillFile();
 
   const [editing, setEditing] = useState(false);
   const [draft, setDraft] = useState("");
@@ -77,6 +80,8 @@ export function SkillFilePreviewDialog({
   }, [path, open]);
 
   const fileEditable = !!data?.editable && treeEditable;
+  const isRootSkillFile = path?.replace(/\\/g, "/").toLowerCase() === "skill.md";
+  const fileDeletable = !!data && treeEditable && !isRootSkillFile;
   const isMarkdown = useMemo(() => {
     if (!path) return false;
     const lower = path.toLowerCase();
@@ -115,6 +120,18 @@ export function SkillFilePreviewDialog({
     }
   }
 
+  async function handleDelete() {
+    if (!skillName || !path) return;
+    if (!window.confirm(tx.filesDeleteConfirm.replace("{path}", path))) return;
+    try {
+      await remove.mutateAsync({ skillName, path });
+      toast.success(tx.filesDeleteSuccess);
+      onOpenChange(false);
+    } catch (err) {
+      toast.error(err instanceof Error ? err.message : String(err));
+    }
+  }
+
   async function handleCopyPath() {
     if (!path) return;
     await navigator.clipboard.writeText(path);
@@ -158,6 +175,18 @@ export function SkillFilePreviewDialog({
                   {tx.filesEditAction}
                 </Button>
               )}
+              {fileDeletable && !editing && (
+                <Button
+                  size="sm"
+                  variant="ghost"
+                  className="h-7 px-2 text-xs text-destructive hover:text-destructive"
+                  onClick={() => void handleDelete()}
+                  disabled={remove.isPending}
+                >
+                  {remove.isPending ? <Loader2 className="size-3.5 animate-spin" /> : <Trash2Icon className="size-3.5" />}
+                  {tx.filesDeleteAction}
+                </Button>
+              )}
               {editing && (
                 <>
                   <Button
diff --git a/frontend-web/src/components/workspace/workspace-nav-chat-list.tsx b/frontend-web/src/components/workspace/workspace-nav-chat-list.tsx
index 1c93ecec..9957103c 100644
--- a/frontend-web/src/components/workspace/workspace-nav-chat-list.tsx
+++ b/frontend-web/src/components/workspace/workspace-nav-chat-list.tsx
@@ -184,7 +184,7 @@ export function WorkspaceNavChatList({
                 </Link>
               </SidebarMenuButton>
             </SidebarMenuItem>
-            <SidebarMenuItem>
+            {/* <SidebarMenuItem>
               <SidebarMenuButton
                 isActive={pathname.startsWith("/page/workspace/roundtable/position")}
                 asChild
@@ -195,7 +195,7 @@ export function WorkspaceNavChatList({
                   <span>岗位会商</span>
                 </Link>
               </SidebarMenuButton>
-            </SidebarMenuItem>
+            </SidebarMenuItem> */}
             <SidebarMenuItem>
               <SidebarMenuButton
                 isActive={pathname === "/page/workspace/scheduled/tasks"}
diff --git a/frontend-web/src/core/i18n/locales/en-US.ts b/frontend-web/src/core/i18n/locales/en-US.ts
index ebaae531..de6a7d60 100644
--- a/frontend-web/src/core/i18n/locales/en-US.ts
+++ b/frontend-web/src/core/i18n/locales/en-US.ts
@@ -545,10 +545,13 @@ export const enUS: Translations = {
       filesSaveAction: "Save",
       filesCancelEditAction: "Cancel",
       filesDownloadAction: "Download",
-      filesCopyPathAction: "Copy path",
-      filesDiscardConfirm: "Discard unsaved changes?",
-      filesSaveSuccess: "File saved",
-      filesReadOnlyHint: "Built-in skills are read-only.",
+      filesCopyPathAction: "Copy path",
+      filesDiscardConfirm: "Discard unsaved changes?",
+      filesSaveSuccess: "File saved",
+      filesDeleteAction: "Delete",
+      filesDeleteConfirm: "Delete \"{path}\"? This cannot be undone.",
+      filesDeleteSuccess: "File deleted",
+      filesReadOnlyHint: "Only administrators can edit or delete built-in skill files.",
       viewDetailAction: "View skill details",
       stateSheet: {
         archivedTitle: "Archived skills",
diff --git a/frontend-web/src/core/i18n/locales/types.ts b/frontend-web/src/core/i18n/locales/types.ts
index 2dc0c0c6..3cbdf9c0 100644
--- a/frontend-web/src/core/i18n/locales/types.ts
+++ b/frontend-web/src/core/i18n/locales/types.ts
@@ -475,10 +475,13 @@ export interface Translations {
       filesSaveAction: string;
       filesCancelEditAction: string;
       filesDownloadAction: string;
-      filesCopyPathAction: string;
-      filesDiscardConfirm: string;
-      filesSaveSuccess: string;
-      filesReadOnlyHint: string;
+      filesCopyPathAction: string;
+      filesDiscardConfirm: string;
+      filesSaveSuccess: string;
+      filesDeleteAction: string;
+      filesDeleteConfirm: string;
+      filesDeleteSuccess: string;
+      filesReadOnlyHint: string;
       viewDetailAction: string;
       stateSheet: {
         archivedTitle: string;
diff --git a/frontend-web/src/core/i18n/locales/zh-CN.ts b/frontend-web/src/core/i18n/locales/zh-CN.ts
index 98ecbb27..ab06ad4a 100644
--- a/frontend-web/src/core/i18n/locales/zh-CN.ts
+++ b/frontend-web/src/core/i18n/locales/zh-CN.ts
@@ -524,8 +524,11 @@ export const zhCN: Translations = {
       filesDownloadAction: "下载",
       filesCopyPathAction: "复制路径",
       filesDiscardConfirm: "有未保存的修改,确定放弃吗?",
-      filesSaveSuccess: "文件已保存",
-      filesReadOnlyHint: "内置技能为只读,仅可查看。",
+      filesSaveSuccess: "文件已保存",
+      filesDeleteAction: "删除",
+      filesDeleteConfirm: "确定删除“{path}”？该操作不可撤销。",
+      filesDeleteSuccess: "文件已删除",
+      filesReadOnlyHint: "仅管理员可以编辑或删除内置技能文件。",
       viewDetailAction: "查看技能详情",
       stateSheet: {
         archivedTitle: "归档的技能",
diff --git a/frontend-web/src/core/model-management/api.ts b/frontend-web/src/core/model-management/api.ts
new file mode 100644
index 00000000..75182171
--- /dev/null
+++ b/frontend-web/src/core/model-management/api.ts
@@ -0,0 +1,114 @@
+import { apiFetch } from "@/core/api";
+import { getBackendBaseURL } from "@/core/config";
+
+export interface ManagedModel {
+  name: string;
+  display_name: string | null;
+  description: string | null;
+  use: string;
+  model: string;
+  base_url: string | null;
+  request_timeout: number | null;
+  max_retries: number | null;
+  max_tokens: number | null;
+  temperature: number | null;
+  stream_usage: boolean | null;
+  supports_thinking: boolean;
+  supports_reasoning_effort: boolean;
+  supports_vision: boolean;
+  when_thinking_enabled: Record<string, unknown> | null;
+  when_thinking_disabled: Record<string, unknown> | null;
+  thinking: Record<string, unknown> | null;
+  use_responses_api: boolean | null;
+  output_version: string | null;
+  extra_settings: Record<string, unknown>;
+  api_key_configured: boolean;
+  api_key_source: string | null;
+  source: "config.yaml";
+}
+
+export interface ManagedModelsResponse {
+  models: ManagedModel[];
+  config_path: string;
+  updated_at: string | null;
+}
+
+export interface ModelSavePayload {
+  name: string;
+  display_name?: string | null;
+  description?: string | null;
+  use: string;
+  model: string;
+  api_key?: string;
+  clear_api_key?: boolean;
+  base_url?: string | null;
+  request_timeout?: number | null;
+  max_retries?: number | null;
+  max_tokens?: number | null;
+  temperature?: number | null;
+  stream_usage?: boolean | null;
+  supports_thinking: boolean;
+  supports_reasoning_effort: boolean;
+  supports_vision: boolean;
+  when_thinking_enabled?: Record<string, unknown> | null;
+  when_thinking_disabled?: Record<string, unknown> | null;
+  thinking?: Record<string, unknown> | null;
+  use_responses_api?: boolean | null;
+  output_version?: string | null;
+  extra_settings: Record<string, unknown>;
+}
+
+export interface ModelConnectionTestResult {
+  success: boolean;
+  latency_ms: number;
+  message: string;
+  preview?: string | null;
+}
+
+async function readError(response: Response, fallback: string): Promise<never> {
+  const payload = await response.json().catch(() => null) as { detail?: string } | null;
+  throw new Error(payload?.detail || fallback);
+}
+
+export async function loadManagedModels(): Promise<ManagedModelsResponse> {
+  const response = await apiFetch(`${getBackendBaseURL()}/api/admin/models`);
+  if (!response.ok) return readError(response, "加载模型配置失败");
+  return response.json() as Promise<ManagedModelsResponse>;
+}
+
+export async function createManagedModel(payload: ModelSavePayload): Promise<ManagedModel> {
+  const response = await apiFetch(`${getBackendBaseURL()}/api/admin/models`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(payload),
+  });
+  if (!response.ok) return readError(response, "创建模型失败");
+  return response.json() as Promise<ManagedModel>;
+}
+
+export async function updateManagedModel(name: string, payload: ModelSavePayload): Promise<ManagedModel> {
+  const response = await apiFetch(`${getBackendBaseURL()}/api/admin/models/${encodeURIComponent(name)}`, {
+    method: "PUT",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(payload),
+  });
+  if (!response.ok) return readError(response, "保存模型配置失败");
+  return response.json() as Promise<ManagedModel>;
+}
+
+export async function deleteManagedModel(name: string): Promise<void> {
+  const response = await apiFetch(`${getBackendBaseURL()}/api/admin/models/${encodeURIComponent(name)}`, {
+    method: "DELETE",
+  });
+  if (!response.ok) return readError(response, "删除模型失败");
+}
+
+export async function testManagedModel(model: ModelSavePayload): Promise<ModelConnectionTestResult> {
+  const response = await apiFetch(`${getBackendBaseURL()}/api/admin/models/test`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ model }),
+  });
+  if (!response.ok) return readError(response, "模型连接测试失败");
+  return response.json() as Promise<ModelConnectionTestResult>;
+}
diff --git a/frontend-web/src/core/model-management/hooks.ts b/frontend-web/src/core/model-management/hooks.ts
new file mode 100644
index 00000000..f4a504f8
--- /dev/null
+++ b/frontend-web/src/core/model-management/hooks.ts
@@ -0,0 +1,52 @@
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+
+import {
+  createManagedModel,
+  deleteManagedModel,
+  loadManagedModels,
+  testManagedModel,
+  updateManagedModel,
+  type ModelSavePayload,
+} from "./api";
+
+export const MANAGED_MODELS_QUERY_KEY = ["admin", "model-config"] as const;
+
+export function useManagedModels() {
+  return useQuery({
+    queryKey: MANAGED_MODELS_QUERY_KEY,
+    queryFn: loadManagedModels,
+    staleTime: 10_000,
+    refetchOnWindowFocus: false,
+  });
+}
+
+export function useSaveManagedModel() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: ({ name, payload, isNew }: { name: string; payload: ModelSavePayload; isNew: boolean }) =>
+      isNew ? createManagedModel(payload) : updateManagedModel(name, payload),
+    onSuccess: async () => {
+      await Promise.all([
+        queryClient.invalidateQueries({ queryKey: MANAGED_MODELS_QUERY_KEY }),
+        queryClient.invalidateQueries({ queryKey: ["models"] }),
+      ]);
+    },
+  });
+}
+
+export function useTestManagedModel() {
+  return useMutation({ mutationFn: testManagedModel });
+}
+
+export function useDeleteManagedModel() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: deleteManagedModel,
+    onSuccess: async () => {
+      await Promise.all([
+        queryClient.invalidateQueries({ queryKey: MANAGED_MODELS_QUERY_KEY }),
+        queryClient.invalidateQueries({ queryKey: ["models"] }),
+      ]);
+    },
+  });
+}
diff --git a/frontend-web/src/core/model-management/index.ts b/frontend-web/src/core/model-management/index.ts
new file mode 100644
index 00000000..35312304
--- /dev/null
+++ b/frontend-web/src/core/model-management/index.ts
@@ -0,0 +1,2 @@
+export * from "./api";
+export * from "./hooks";
diff --git a/frontend-web/src/core/models/single-round-rag.ts b/frontend-web/src/core/models/single-round-rag.ts
new file mode 100644
index 00000000..7591a2da
--- /dev/null
+++ b/frontend-web/src/core/models/single-round-rag.ts
@@ -0,0 +1,21 @@
+import type { Model } from "./types";
+
+export const SINGLE_ROUND_RAG_MODELS: Model[] = [
+  { id: "single-round-rag-openai3", name: "OpenAI3", model: "OpenAI3", display_name: "Qwen3-32B", supports_thinking: true, execution_profile: "single_round_rag" },
+  { id: "single-round-rag-openai4", name: "OpenAI4", model: "OpenAI4", display_name: "Qwen3-235B", supports_thinking: true, execution_profile: "single_round_rag" },
+  { id: "single-round-rag-openai5", name: "OpenAI5", model: "OpenAI5", display_name: "GLM-5", supports_thinking: true, execution_profile: "single_round_rag" },
+  { id: "single-round-rag-openai6", name: "OpenAI6", model: "OpenAI6", display_name: "Qwen3.5-27B", supports_thinking: true, execution_profile: "single_round_rag" },
+  { id: "single-round-rag-openai7", name: "OpenAI7", model: "OpenAI7", display_name: "Qwen3-8B", supports_thinking: true, execution_profile: "single_round_rag" },
+  { id: "single-round-rag-openai9", name: "OpenAI9", model: "OpenAI9", display_name: "四季7B", supports_thinking: true, execution_profile: "single_round_rag" },
+];
+
+export function isSingleRoundRagProfile(
+  context: unknown,
+): boolean {
+  return (
+    typeof context === "object" &&
+    context !== null &&
+    (context as { execution_profile?: unknown }).execution_profile ===
+      "single_round_rag"
+  );
+}
diff --git a/frontend-web/src/core/models/types.ts b/frontend-web/src/core/models/types.ts
index 31bf98ab..a470b2e8 100644
--- a/frontend-web/src/core/models/types.ts
+++ b/frontend-web/src/core/models/types.ts
@@ -4,9 +4,11 @@ export interface Model {
   model: string;
   display_name: string;
   description?: string | null;
-  supports_thinking?: boolean;
-  supports_reasoning_effort?: boolean;
-}
+  supports_thinking?: boolean;
+  supports_reasoning_effort?: boolean;
+  /** Execution profiles handled by the frontend instead of DeerFlow. */
+  execution_profile?: "single_round_rag";
+}
 
 export interface TokenUsageSettings {
   enabled: boolean;
diff --git a/frontend-web/src/core/skills/api.ts b/frontend-web/src/core/skills/api.ts
index 0117455e..947a7395 100644
--- a/frontend-web/src/core/skills/api.ts
+++ b/frontend-web/src/core/skills/api.ts
@@ -402,15 +402,26 @@ export async function getSkillContent(
   return response.json() as Promise<SkillContentResponse>;
 }
 
-export async function deleteCustomSkill(skillName: string): Promise<void> {
+export async function deleteCustomSkill(skillName: string): Promise<void> {
   const response = await apiFetch(
     `${getBackendBaseURL()}/api/skills/custom/${encodeURIComponent(skillName)}`,
     { method: "DELETE" },
   );
   if (!response.ok) {
     throw await parseDetailedError(response, "Failed to delete skill");
-  }
-}
+  }
+}
+
+/** Delete a built-in skill. The backend permits this only for administrators. */
+export async function deleteBuiltinSkill(skillName: string): Promise<void> {
+  const response = await apiFetch(
+    `${getBackendBaseURL()}/api/skills/${encodeURIComponent(skillName)}`,
+    { method: "DELETE" },
+  );
+  if (!response.ok) {
+    throw await parseDetailedError(response, "Failed to delete built-in skill");
+  }
+}
 
 export interface SkillFileNode {
   name: string;
@@ -479,7 +490,7 @@ export function getSkillFileDownloadURL(skillName: string, path: string): string
   );
 }
 
-export async function saveSkillFile(
+export async function saveSkillFile(
   skillName: string,
   path: string,
   content: string,
@@ -494,9 +505,22 @@ export async function saveSkillFile(
   );
   if (!response.ok) {
     throw await parseDetailedError(response, "Failed to save skill file");
-  }
-  return response.json() as Promise<SkillFileSaveResponse>;
-}
+  }
+  return response.json() as Promise<SkillFileSaveResponse>;
+}
+
+export async function deleteSkillFile(
+  skillName: string,
+  path: string,
+): Promise<void> {
+  const url =
+    `${getBackendBaseURL()}/api/skills/${encodeURIComponent(skillName)}/files/content` +
+    `?path=${encodeURIComponent(path)}`;
+  const response = await apiFetch(url, { method: "DELETE" });
+  if (!response.ok) {
+    throw await parseDetailedError(response, "Failed to delete skill file");
+  }
+}
 
 export interface SkillNameZhResponse {
   name: string;
diff --git a/frontend-web/src/core/skills/hooks.ts b/frontend-web/src/core/skills/hooks.ts
index 4460242e..ad68d7d5 100644
--- a/frontend-web/src/core/skills/hooks.ts
+++ b/frontend-web/src/core/skills/hooks.ts
@@ -5,8 +5,10 @@ import {
   useQueryClient,
 } from "@tanstack/react-query";
 
-import {
-  deleteCustomSkill,
+import {
+  deleteBuiltinSkill,
+  deleteCustomSkill,
+  deleteSkillFile,
   duplicateSkill,
   enableSkill,
   generateMissingSkillNameZh,
@@ -318,7 +320,7 @@ export function useSkillFileContent(skillName: string | null, path: string | nul
   });
 }
 
-export function useSaveSkillFile() {
+export function useSaveSkillFile() {
   const queryClient = useQueryClient();
   return useMutation({
     mutationFn: ({
@@ -339,5 +341,33 @@ export function useSaveSkillFile() {
         void queryClient.invalidateQueries({ queryKey: ["skill", skillName] });
       }
     },
-  });
-}
+  });
+}
+
+export function useDeleteSkillFile() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: ({
+      skillName,
+      path,
+    }: {
+      skillName: string;
+      path: string;
+    }) => deleteSkillFile(skillName, path),
+    onSuccess: (_data, { skillName, path }) => {
+      void queryClient.invalidateQueries({ queryKey: ["skill-files", skillName] });
+      void queryClient.removeQueries({ queryKey: ["skill-file", skillName, path] });
+    },
+  });
+}
+
+export function useDeleteBuiltinSkill() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: deleteBuiltinSkill,
+    onSuccess: () => {
+      void queryClient.invalidateQueries({ queryKey: ["skills"] });
+      void queryClient.invalidateQueries({ queryKey: ["admin-skills"] });
+    },
+  });
+}
diff --git a/frontend-web/src/core/threads/hooks.ts b/frontend-web/src/core/threads/hooks.ts
index e9e19a2a..5da690c8 100644
--- a/frontend-web/src/core/threads/hooks.ts
+++ b/frontend-web/src/core/threads/hooks.ts
@@ -25,10 +25,13 @@ import { promptInputFilePartToFile, uploadFiles } from "../uploads";
 
 import type { AgentThread, AgentThreadState } from "./types";
 
-export type ToolEndEvent = {
-  name: string;
-  data: unknown;
-};
+export type ToolEndEvent = {
+  name: string;
+  data: unknown;
+  toolCallId?: string;
+};
+
+export type ToolStartEvent = ToolEndEvent;
 
 export type ThreadStreamOptions = {
   threadId?: string | null | undefined;
@@ -47,10 +50,11 @@ export type ThreadStreamOptions = {
   /** 额外写到新建 thread 的 metadata（与 agent_id 合并）。
    *  任务深链用 `{ taskId }` 把对话挂到任务下（1:N），列表按 metadata.taskId 过滤。 */
   threadMetadata?: Record<string, unknown>;
-  onStart?: (threadId: string) => void;
-  onFinish?: (state: AgentThreadState) => void;
-  onToolEnd?: (event: ToolEndEvent) => void;
-};
+  onStart?: (threadId: string) => void;
+  onFinish?: (state: AgentThreadState) => void;
+  onToolStart?: (event: ToolStartEvent) => void;
+  onToolEnd?: (event: ToolEndEvent) => void;
+};
 
 type SendMessageOptions = {
   additionalKwargs?: Record<string, unknown>;
@@ -447,10 +451,11 @@ export function useThreadStream({
   assistantId,
   runOptions,
   threadMetadata,
-  onStart,
-  onFinish,
-  onToolEnd,
-}: ThreadStreamOptions) {
+  onStart,
+  onFinish,
+  onToolStart,
+  onToolEnd,
+}: ThreadStreamOptions) {
   const { t } = useI18n();
   const [localSettings] = useLocalSettings();
   // Track the thread ID that is currently streaming to handle thread changes during streaming
@@ -466,16 +471,17 @@ export function useThreadStream({
     lastStreamActivityAtRef.current = Date.now();
   }, []);
 
-  const listeners = useRef({
-    onStart,
-    onFinish,
-    onToolEnd,
-  });
+  const listeners = useRef({
+    onStart,
+    onFinish,
+    onToolStart,
+    onToolEnd,
+  });
 
   // Keep listeners ref updated with latest callbacks
-  useEffect(() => {
-    listeners.current = { onStart, onFinish, onToolEnd };
-  }, [onStart, onFinish, onToolEnd]);
+  useEffect(() => {
+    listeners.current = { onStart, onFinish, onToolStart, onToolEnd };
+  }, [onStart, onFinish, onToolStart, onToolEnd]);
 
   useEffect(() => {
     const normalizedThreadId = threadId ?? null;
@@ -545,12 +551,6 @@ export function useThreadStream({
     },
     onLangChainEvent(event) {
       markStreamActivity();
-      if (event.event === "on_tool_end") {
-        listeners.current.onToolEnd?.({
-          name: event.name,
-          data: event.data,
-        });
-      }
       // 操作日志(Y-Log)：每一次大模型调用结束都各上报一条（一次 LLM 调用 = 一条），
       // 让问答日志尽量「多、全」——一个问答轮次里 lead agent / 子代理的每次模型调用
       // 都会落一条。门控与失败静默都在 writeYLog 内部处理，绝不影响问答。
@@ -572,8 +572,32 @@ export function useThreadStream({
         } catch {
           /* 上报绝不影响问答 */
         }
-      }
+      }
     },
+    // The SDK emits UI tool lifecycle events on the dedicated `tools` stream
+    // mode. `events` is a separate LangChain trace channel; using it for UI
+    // reactions can miss a tool that the conversation has already rendered.
+    onToolEvent:
+      onToolStart || onToolEnd
+        ? (event) => {
+            markStreamActivity();
+            if (event.event === "on_tool_start") {
+              listeners.current.onToolStart?.({
+                name: event.name,
+                data: event.input,
+                toolCallId: event.toolCallId,
+              });
+              return;
+            }
+            if (event.event === "on_tool_end") {
+              listeners.current.onToolEnd?.({
+                name: event.name,
+                data: event.output,
+                toolCallId: event.toolCallId,
+              });
+            }
+          }
+        : undefined,
     onUpdateEvent(data) {
       markStreamActivity();
       const updates: Array<Partial<AgentThreadState> | null> = Object.values(
diff --git a/frontend-web/src/core/threads/types.ts b/frontend-web/src/core/threads/types.ts
index 9577501b..49dc31ac 100644
--- a/frontend-web/src/core/threads/types.ts
+++ b/frontend-web/src/core/threads/types.ts
@@ -23,11 +23,13 @@ export interface AgentThreadContext extends Record<string, unknown> {
   rag_mode_enabled?: boolean;
   /** Per-request switch for context compression (上下文压缩). Default off. */
   summarization_enabled?: boolean;
-  /** Per-conversation switch for knowledge-base RAG injection (phase 2). */
+  /** Per-conversation switch for knowledge-base RAG injection (phase 2). */
   knowledge_rag_enabled?: boolean;
   /** DeerFlow LLMWiki mapping ids selected for this conversation. */
   llmwiki_knowledge_base_ids?: string[];
-  agent_id?: string;
+  /** Direct knowledge-base RAG mode; this request never enters Lead Agent. */
+  execution_profile?: "single_round_rag";
+  agent_id?: string;
   /** @deprecated kept for reading legacy thread metadata; prefer agent_id */
   agent_name?: string;
 }
diff --git a/frontend-web/src/core/threads/use-single-round-rag.ts b/frontend-web/src/core/threads/use-single-round-rag.ts
new file mode 100644
index 00000000..7287a315
--- /dev/null
+++ b/frontend-web/src/core/threads/use-single-round-rag.ts
@@ -0,0 +1,378 @@
+import type { Message } from "@langchain/langgraph-sdk";
+import { useCallback, useEffect, useRef, useState } from "react";
+
+import { readRuntimeEnv } from "@/env";
+
+const STORAGE_PREFIX = "workspace.single-round-rag.";
+
+type KnowledgeBaseChunk = {
+  answer?: unknown;
+  docs?: unknown;
+};
+
+type RagSource = {
+  id?: string;
+  title: string;
+  type: string;
+  snippet: string;
+  content: string;
+  source?: string;
+  time?: string;
+  url?: string;
+  raw: Record<string, unknown>;
+};
+
+/** Same JSON-object framing used by the established GeneralQA single-RAG flow. */
+function extractJsonObjects(raw: string): { objects: string[]; rest: string } {
+  const objects: string[] = [];
+  let depth = 0;
+  let stringQuote: '"' | "'" | null = null;
+  let escaped = false;
+  let start = -1;
+  for (let index = 0; index < raw.length; index += 1) {
+    const char = raw[index]!;
+    if (stringQuote) {
+      if (escaped) escaped = false;
+      else if (char === "\\") escaped = true;
+      else if (char === stringQuote) stringQuote = null;
+      continue;
+    }
+    if (char === '"' || char === "'") {
+      stringQuote = char;
+      continue;
+    }
+    if (char === "{") {
+      if (depth === 0) start = index;
+      depth += 1;
+    } else if (char === "}") {
+      depth -= 1;
+      if (depth === 0 && start !== -1) {
+        objects.push(raw.slice(start, index + 1));
+        start = -1;
+      }
+    }
+  }
+  return depth > 0 && start !== -1
+    ? { objects, rest: raw.slice(start) }
+    : { objects, rest: "" };
+}
+
+/** Same `<think>` split semantics as GeneralQA, kept local to avoid loading its demo data. */
+function parseSingleRagStream(chunks: { answer: string }[]) {
+  let thinkingMarkdown = "";
+  let answerMarkdown = "";
+  let inThink = false;
+  let thinkingComplete = false;
+  for (const { answer } of chunks) {
+    let remaining = answer;
+    while (remaining) {
+      if (inThink) {
+        const endIndex = remaining.indexOf("</think>");
+        if (endIndex === -1) {
+          thinkingMarkdown += remaining;
+          remaining = "";
+        } else {
+          thinkingMarkdown += remaining.slice(0, endIndex);
+          remaining = remaining.slice(endIndex + "</think>".length);
+          inThink = false;
+          thinkingComplete = true;
+        }
+      } else {
+        const startIndex = remaining.indexOf("<think>");
+        if (startIndex === -1) {
+          answerMarkdown += remaining;
+          remaining = "";
+        } else {
+          answerMarkdown += remaining.slice(0, startIndex);
+          remaining = remaining.slice(startIndex + "<think>".length);
+          inThink = true;
+        }
+      }
+    }
+  }
+  return { thinkingMarkdown, answerMarkdown, thinkingComplete };
+}
+
+function storageKey(threadId: string) {
+  return `${STORAGE_PREFIX}${threadId}`;
+}
+
+function readStoredMessages(threadId: string): Message[] {
+  if (typeof window === "undefined" || !threadId) return [];
+  try {
+    const raw = window.sessionStorage.getItem(storageKey(threadId));
+    const parsed: unknown = raw ? JSON.parse(raw) : [];
+    return Array.isArray(parsed) ? (parsed as Message[]) : [];
+  } catch {
+    return [];
+  }
+}
+
+function writeStoredMessages(threadId: string, messages: Message[]) {
+  if (typeof window === "undefined" || !threadId) return;
+  try {
+    window.sessionStorage.setItem(storageKey(threadId), JSON.stringify(messages));
+  } catch {
+    // Quota errors must never interrupt an already-running answer.
+  }
+}
+
+function parseLooseStringValue(rawValue: string): string {
+  try {
+    return JSON.parse(rawValue) as string;
+  } catch {
+    const value = rawValue.trim();
+    if (value.startsWith("'") && value.endsWith("'")) {
+      return value
+        .slice(1, -1)
+        .replace(/\\n/g, "\n")
+        .replace(/\\r/g, "\r")
+        .replace(/\\t/g, "\t")
+        .replace(/\\'/g, "'")
+        .replace(/\\\\/g, "\\");
+    }
+    throw new Error(`无法解析知识库流片段：${rawValue}`);
+  }
+}
+
+function parseKnowledgeBaseChunk(jsonText: string): KnowledgeBaseChunk {
+  try {
+    return JSON.parse(jsonText) as KnowledgeBaseChunk;
+  } catch {
+    const objectText = jsonText.trim();
+    const answerMatch = objectText.match(/^\{\s*answer\s*:\s*([\s\S]*)\s*\}$/);
+    if (answerMatch) {
+      return { answer: parseLooseStringValue(answerMatch[1]!.trim()) };
+    }
+    const docsMatch = objectText.match(/^\{\s*docs\s*:\s*([\s\S]*)\s*\}$/);
+    if (docsMatch) {
+      const rawValue = docsMatch[1]!.trim();
+      try {
+        return { docs: JSON.parse(rawValue) };
+      } catch {
+        return { docs: parseLooseStringValue(rawValue) };
+      }
+    }
+    const normalizedText = objectText.replace(
+      /([{,]\s*)(answer|docs)(\s*:)/g,
+      '$1"$2"$3',
+    );
+    return JSON.parse(normalizedText) as KnowledgeBaseChunk;
+  }
+}
+
+function flattenDocs(value: unknown): Record<string, unknown>[] {
+  if (Array.isArray(value)) {
+    return value.flatMap((item) => flattenDocs(item));
+  }
+  if (!value || typeof value !== "object") return [];
+  const record = value as Record<string, unknown>;
+  if ("docs" in record) return flattenDocs(record.docs);
+  return [record];
+}
+
+function normalizeSources(value: unknown): RagSource[] {
+  return flattenDocs(value).map((item, index) => {
+    const title = String(item.m_title ?? item.title ?? item.source ?? `参考资料 ${index + 1}`);
+    const content = String(item.m_content ?? item.content ?? item.snippet ?? "");
+    const source = item.source1 ?? item.source;
+    const rawUrl = item.url ?? item.link ?? item.href;
+    return {
+      id: String(item.recUuid ?? item.rec_uuid ?? item.uuid ?? item.id ?? "") || undefined,
+      title,
+      type: String(item.source1 ?? item.type ?? "知识库"),
+      snippet: content,
+      content,
+      source: typeof source === "string" ? source : undefined,
+      time: typeof item.m_publish === "string" ? item.m_publish : undefined,
+      url: typeof rawUrl === "string" && /^https?:\/\//i.test(rawUrl) ? rawUrl : undefined,
+      raw: item,
+    };
+  });
+}
+
+function createId(prefix: string) {
+  return `${prefix}-${crypto.randomUUID()}`;
+}
+
+function isAbortError(error: unknown) {
+  return error instanceof DOMException && error.name === "AbortError";
+}
+
+export function isSingleRoundRagMessage(message: Message): boolean {
+  return message.additional_kwargs?.single_round_rag === true;
+}
+
+/**
+ * Frontend-only adapter for the existing general-QA single-round endpoint.
+ * It deliberately never submits a run to DeerFlow or mutates the Lead Agent.
+ */
+export function useSingleRoundRagMessages(threadId: string) {
+  const [messages, setMessages] = useState<Message[]>(() => readStoredMessages(threadId));
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const controllerRef = useRef<AbortController | null>(null);
+
+  useEffect(() => {
+    setMessages(readStoredMessages(threadId));
+    setError(null);
+  }, [threadId]);
+
+  useEffect(() => () => controllerRef.current?.abort(), []);
+
+  const updateMessages = useCallback(
+    (targetThreadId: string, updater: (current: Message[]) => Message[]) => {
+      setMessages((current) => {
+        const next = updater(current);
+        writeStoredMessages(targetThreadId, next);
+        return next;
+      });
+    },
+    [],
+  );
+
+  const stop = useCallback(() => controllerRef.current?.abort(), []);
+
+  const submit = useCallback(
+    async ({
+      targetThreadId,
+      query,
+      modelName,
+    }: {
+      targetThreadId: string;
+      query: string;
+      modelName: string;
+    }) => {
+      if (isLoading) return;
+      const question = query.trim();
+      if (!question) return;
+
+      const humanId = createId("single-rag-human");
+      const assistantId = createId("single-rag-ai");
+      const sourceId = createId("single-rag-sources");
+      const clientTs = new Date().toISOString();
+      const userMessage: Message = {
+        id: humanId,
+        type: "human",
+        content: [{ type: "text", text: question }],
+        additional_kwargs: { client_ts: clientTs, single_round_rag: true },
+      };
+      const initialAssistant: Message = {
+        id: assistantId,
+        type: "ai",
+        content: "",
+        additional_kwargs: { single_round_rag: true },
+      };
+      updateMessages(targetThreadId, (current) => [...current, userMessage, initialAssistant]);
+      setError(null);
+      setIsLoading(true);
+
+      const controller = new AbortController();
+      controllerRef.current = controller;
+      const answerChunks: { answer: string }[] = [];
+      let sources: RagSource[] = [];
+
+      const refreshAssistant = () => {
+        const trace = parseSingleRagStream(answerChunks);
+        updateMessages(targetThreadId, (current) => {
+          const next = current.filter((message) => message.id !== sourceId);
+          const assistantIndex = next.findIndex((message) => message.id === assistantId);
+          if (assistantIndex < 0) return current;
+          next[assistantIndex] = {
+            ...next[assistantIndex],
+            content: trace.answerMarkdown,
+            additional_kwargs: {
+              ...next[assistantIndex]!.additional_kwargs,
+              single_round_rag: true,
+              reasoning_content: trace.thinkingMarkdown || null,
+            },
+          } as Message;
+          if (sources.length > 0) {
+            next.splice(assistantIndex, 0, {
+              id: sourceId,
+              type: "tool",
+              name: "knowledge_base_search",
+              content: { results: sources },
+              additional_kwargs: {
+                hide_from_ui: true,
+                single_round_rag: true,
+              },
+            } as unknown as Message);
+          }
+          return next;
+        });
+      };
+
+      try {
+        const chatUrl = readRuntimeEnv("VITE_AIPI_CHAT_URL") || "";
+        if (!chatUrl) {
+          throw new Error("未配置 VITE_AIPI_CHAT_URL，无法发起单轮 RAG 问答。");
+        }
+        const response = await fetch(
+          `${chatUrl.replace(/\/$/, "")}/chat/knowledge_base_chat_tiaoshi`,
+          {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            signal: controller.signal,
+            body: JSON.stringify({
+              query: question,
+              knowledge_base_name: [],
+              top_k: 5,
+              score_threshold: 0.5,
+              history: [],
+              stream: true,
+              model_name: modelName,
+              temperature: 0.3,
+              prompt_name: "default",
+              local_doc_url: false,
+            }),
+          },
+        );
+        if (!response.ok) throw new Error(`知识库服务请求失败（${response.status}）`);
+        if (!response.body) throw new Error("知识库服务未返回流式响应。");
+
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        while (true) {
+          const { done, value } = await reader.read();
+          if (done) break;
+          buffer += decoder.decode(value, { stream: true });
+          const extracted = extractJsonObjects(buffer);
+          buffer = extracted.rest;
+          for (const jsonText of extracted.objects) {
+            const chunk = parseKnowledgeBaseChunk(jsonText);
+            if (typeof chunk.answer === "string") answerChunks.push({ answer: chunk.answer });
+            if (chunk.docs !== undefined) sources = normalizeSources(chunk.docs);
+            refreshAssistant();
+          }
+        }
+      } catch (caught) {
+        if (!isAbortError(caught)) {
+          const message = caught instanceof Error ? caught.message : "单轮 RAG 问答失败。";
+          setError(message);
+          updateMessages(targetThreadId, (current) =>
+            current.map((item) =>
+              item.id === assistantId
+                ? ({
+                    ...item,
+                    content: answerChunks.length > 0 ? item.content : message,
+                    additional_kwargs: {
+                      ...item.additional_kwargs,
+                      single_round_rag: true,
+                    },
+                  } as Message)
+                : item,
+            ),
+          );
+        }
+      } finally {
+        if (controllerRef.current === controller) controllerRef.current = null;
+        setIsLoading(false);
+      }
+    },
+    [isLoading, updateMessages],
+  );
+
+  return { messages, isLoading, error, submit, stop };
+}
diff --git a/frontend-web/src/pages/ChatPage.tsx b/frontend-web/src/pages/ChatPage.tsx
index 8a92a701..9d136ad0 100644
--- a/frontend-web/src/pages/ChatPage.tsx
+++ b/frontend-web/src/pages/ChatPage.tsx
@@ -45,6 +45,10 @@ import { PanelLeftOpen } from "lucide-react";
 import { useAgentSelector, useAgentsPaginated } from "@/core/agents";
 import { useI18n } from "@/core/i18n/hooks";
 import { useModels } from "@/core/models/hooks";
+import {
+  isSingleRoundRagProfile,
+  SINGLE_ROUND_RAG_MODELS,
+} from "@/core/models/single-round-rag";
 import { useNotification } from "@/core/notification/hooks";
 import {
   getLastAgentId,
@@ -54,6 +58,7 @@ import {
 } from "@/core/settings";
 import { useThreadStream } from "@/core/threads/hooks";
 import { queueLlmWikiConversationDeposit } from "@/core/llmwiki/conversation-deposit";
+import { useSingleRoundRagMessages } from "@/core/threads/use-single-round-rag";
 import { useLayoutMode } from "@/core/system-settings/hooks";
 import { useRouteBase } from "@/core/route-base";
 import { textOfMessage } from "@/core/threads/utils";
@@ -304,6 +309,20 @@ export default function ChatPage() {
       }
     },
   });
+  const singleRoundRag = useSingleRoundRagMessages(threadId);
+  const singleRoundRagSelected = isSingleRoundRagProfile(settings.context);
+  const displayThread = useMemo(() => {
+    if (singleRoundRag.messages.length === 0 && !singleRoundRag.isLoading) {
+      return thread;
+    }
+    const messages = [...thread.messages, ...singleRoundRag.messages];
+    return {
+      ...thread,
+      values: { ...thread.values, messages },
+      messages,
+      isLoading: thread.isLoading || singleRoundRag.isLoading,
+    } as typeof thread;
+  }, [singleRoundRag.isLoading, singleRoundRag.messages, thread]);
 
   const writingArtifactPath = useMemo(() => {
     const isMarkdown = (path: string | null | undefined) =>
@@ -318,6 +337,46 @@ export default function ChatPage() {
 
   const handleSubmit = useCallback(
     (message: PromptInputMessage) => {
+      if (singleRoundRagSelected) {
+        if (message.files && message.files.length > 0) {
+          toast.error("单轮 RAG 问答暂不支持附件，请移除附件后重试。");
+          return;
+        }
+        setHasStartedConversation(true);
+        window.dispatchEvent(
+          new CustomEvent("workspace:sandbox-resume-autoscroll"),
+        );
+        void (async () => {
+          try {
+            let targetThreadId = threadId;
+            if (isNewThread) {
+              const created = await getAPIClient(isMock).threads.create({});
+              targetThreadId = created.thread_id;
+              setThreadId(targetThreadId);
+              setIsNewThread(false);
+              history.replaceState(
+                null,
+                "",
+                `${window.location.pathname}${window.location.search}#${routeBase}/chats/${targetThreadId}`,
+              );
+              const title = message.text.trim().replace(/\s+/g, " ").slice(0, 60);
+              if (title) {
+                void getAPIClient(isMock).threads
+                  .updateState(targetThreadId, { values: { title } })
+                  .catch(() => undefined);
+              }
+            }
+            await singleRoundRag.submit({
+              targetThreadId,
+              query: message.text,
+              modelName: settings.context.model_name ?? "OpenAI3",
+            });
+          } catch (error) {
+            toast.error(error instanceof Error ? error.message : "单轮 RAG 问答失败。");
+          }
+        })();
+        return;
+      }
       // If the user picked an agent before sending the opening turn, hand off
       // to AgentChatPage so the conversation runs against that agent. We stash
       // the pending text in sessionStorage because the next/navigation shim
@@ -420,7 +479,13 @@ export default function ChatPage() {
       isMock,
       router,
       settings.context.writing_mode,
+      settings.context.model_name,
       writingArtifactPath,
+      singleRoundRag,
+      singleRoundRagSelected,
+      routeBase,
+      setIsNewThread,
+      setThreadId,
     ],
   );
 
@@ -511,8 +576,12 @@ export default function ChatPage() {
     saveLastAgentId(agentId);
   }, []);
   const handleStop = useCallback(async () => {
+    if (singleRoundRag.isLoading) {
+      singleRoundRag.stop();
+      return;
+    }
     await thread.stop();
-  }, [thread]);
+  }, [singleRoundRag, thread]);
 
   const promptPrefixProp = useMemo(() => {
     if (!promptPrefixSettings?.enabled) return undefined;
@@ -558,7 +627,7 @@ export default function ChatPage() {
   const compactActionsHidden = isHideChromeActive();
 
   return (
-    <ThreadContext.Provider value={{ thread, isMock }}>
+    <ThreadContext.Provider value={{ thread: displayThread, isMock }}>
       <ChatBox threadId={threadId}>
         <div
           className={cn(
@@ -576,7 +645,7 @@ export default function ChatPage() {
             )}
           >
             <div className="flex w-full items-center text-sm font-medium">
-              <ThreadTitle threadId={threadId} thread={thread} />
+              <ThreadTitle threadId={threadId} thread={displayThread} />
             </div>
             <div className="flex items-center gap-2">
               {/* 仅在收起态显示「展开历史」钮；展开后由侧栏内（新对话右侧）的收起钮负责收起。 */}
@@ -595,7 +664,7 @@ export default function ChatPage() {
               )}
               <TokenUsageIndicator
                 enabled={tokenUsageEnabled}
-                messages={thread.messages}
+                messages={displayThread.messages}
               />
               <ExportTrigger threadId={threadId} />
               <KnowledgeSaveTrigger threadId={threadId} />
@@ -633,7 +702,7 @@ export default function ChatPage() {
                 <MessageList
                   className={cn("size-full", "pt-10")}
                   threadId={threadId}
-                  thread={thread}
+                  thread={displayThread}
                   paddingBottom={messageListPaddingBottom}
                   tokenUsageEnabled={tokenUsageEnabled}
                   // 输入框为底部绝对浮层（约 160px 高），按钮上移到其上方居中。
@@ -675,9 +744,9 @@ export default function ChatPage() {
                   <div className="absolute right-0 bottom-0 left-0">
                     <TodoList
                       className="bg-background/5"
-                      todos={thread.values.todos ?? []}
+                      todos={displayThread.values.todos ?? []}
                       hidden={
-                        !thread.values.todos || thread.values.todos.length === 0
+                        !displayThread.values.todos || displayThread.values.todos.length === 0
                       }
                     />
                   </div>
@@ -702,16 +771,18 @@ export default function ChatPage() {
                       status={
                         thread.error
                           ? "error"
-                          : thread.isLoading
+                          : displayThread.isLoading
                             ? "streaming"
                             : "ready"
                       }
                       context={settings.context}
+                      extraModels={SINGLE_ROUND_RAG_MODELS}
                       disabled={
                         env.NEXT_PUBLIC_STATIC_WEBSITE_ONLY === "true" ||
                         isUploading ||
                         agentHandoffPending ||
-                        knowledgeSelectionLoading
+                        knowledgeSelectionLoading ||
+                        singleRoundRag.isLoading
                       }
                       onContextChange={(context) =>
                         setSettings("context", context)
@@ -771,7 +842,7 @@ export default function ChatPage() {
           */}
           {!isLandingState && (
             <QuestionNavigator
-              messages={thread.messages}
+              messages={displayThread.messages}
               className="top-16 right-0 bottom-48 left-0"
             />
           )}
diff --git a/frontend-web/src/pages/ModelManagementPage.tsx b/frontend-web/src/pages/ModelManagementPage.tsx
new file mode 100644
index 00000000..6a984adb
--- /dev/null
+++ b/frontend-web/src/pages/ModelManagementPage.tsx
@@ -0,0 +1,491 @@
+import {
+  BotIcon,
+  ChevronDownIcon,
+  CircleAlertIcon,
+  CpuIcon,
+  EyeIcon,
+  KeyRoundIcon,
+  LoaderCircleIcon,
+  PlusIcon,
+  RefreshCwIcon,
+  Settings2Icon,
+  SparklesIcon,
+  Trash2Icon,
+  WrenchIcon,
+} from "lucide-react";
+import { useMemo, useState, type ReactNode } from "react";
+import {
+  Button as TButton,
+  Dialog,
+  Input,
+  InputNumber,
+  MessagePlugin,
+  Select,
+  Switch,
+  Tag,
+  Textarea,
+} from "tdesign-react";
+
+import {
+  type ManagedModel,
+  type ModelSavePayload,
+  useDeleteManagedModel,
+  useManagedModels,
+  useSaveManagedModel,
+  useTestManagedModel,
+} from "@/core/model-management";
+import {
+  WorkspaceBody,
+  WorkspaceContainer,
+  WorkspaceHeader,
+} from "@/components/workspace/workspace-container";
+
+type ModelDraft = ModelSavePayload & {
+  api_key: string;
+  keep_existing_key: boolean;
+  extra_settings_text: string;
+};
+
+const PROVIDER_OPTIONS = [
+  { label: "OpenAI 兼容接口", value: "langchain_openai:ChatOpenAI" },
+  { label: "Anthropic", value: "langchain_anthropic:ChatAnthropic" },
+  { label: "Google Gemini", value: "langchain_google_genai:ChatGoogleGenerativeAI" },
+  { label: "Groq", value: "langchain_groq:ChatGroq" },
+  { label: "Ollama", value: "langchain_ollama:ChatOllama" },
+];
+
+const emptyDraft = (): ModelDraft => ({
+  name: "",
+  display_name: "",
+  description: "",
+  use: "langchain_openai:ChatOpenAI",
+  model: "",
+  api_key: "",
+  keep_existing_key: false,
+  clear_api_key: false,
+  base_url: "",
+  request_timeout: 30,
+  max_retries: 2,
+  max_tokens: undefined,
+  temperature: undefined,
+  stream_usage: true,
+  supports_thinking: false,
+  supports_reasoning_effort: false,
+  supports_vision: false,
+  when_thinking_enabled: null,
+  when_thinking_disabled: null,
+  thinking: null,
+  use_responses_api: null,
+  output_version: null,
+  extra_settings: {},
+  extra_settings_text: "{}",
+});
+
+function draftFromModel(model: ManagedModel): ModelDraft {
+  return {
+    ...model,
+    api_key: "",
+    keep_existing_key: model.api_key_configured,
+    clear_api_key: false,
+    extra_settings_text: JSON.stringify(model.extra_settings ?? {}, null, 2),
+  };
+}
+
+function optionalString(value: string | null | undefined): string | null {
+  const normalized = (value ?? "").trim();
+  return normalized || null;
+}
+
+function toNumber(value: number | string | null | undefined): number | undefined {
+  if (value === "" || value === null || value === undefined) return undefined;
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : undefined;
+}
+
+function buildPayload(draft: ModelDraft): ModelSavePayload {
+  let extraSettings: Record<string, unknown> = {};
+  try {
+    const parsed = JSON.parse(draft.extra_settings_text || "{}") as unknown;
+    if (!parsed || Array.isArray(parsed) || typeof parsed !== "object") {
+      throw new Error("额外参数必须是 JSON 对象");
+    }
+    extraSettings = parsed as Record<string, unknown>;
+  } catch (error) {
+    throw error instanceof Error ? error : new Error("额外参数不是有效 JSON");
+  }
+  const payload: ModelSavePayload = {
+    name: draft.name.trim(),
+    display_name: optionalString(draft.display_name),
+    description: optionalString(draft.description),
+    use: draft.use.trim(),
+    model: draft.model.trim(),
+    clear_api_key: Boolean(draft.clear_api_key),
+    base_url: optionalString(draft.base_url),
+    request_timeout: toNumber(draft.request_timeout),
+    max_retries: toNumber(draft.max_retries),
+    max_tokens: toNumber(draft.max_tokens),
+    temperature: toNumber(draft.temperature),
+    stream_usage: draft.stream_usage,
+    supports_thinking: draft.supports_thinking,
+    supports_reasoning_effort: draft.supports_reasoning_effort,
+    supports_vision: draft.supports_vision,
+    when_thinking_enabled: draft.when_thinking_enabled,
+    when_thinking_disabled: draft.when_thinking_disabled,
+    thinking: draft.thinking,
+    use_responses_api: draft.use_responses_api,
+    output_version: optionalString(draft.output_version),
+    extra_settings: extraSettings,
+  };
+  if (draft.api_key.trim()) payload.api_key = draft.api_key.trim();
+  return payload;
+}
+
+function StatCard({ icon: Icon, label, value }: { icon: typeof CpuIcon; label: string; value: number }) {
+  return (
+    <div className="flex items-center gap-3 rounded-lg border border-border bg-card px-4 py-3 shadow-sm">
+      <span className="flex size-10 items-center justify-center rounded-lg bg-primary/10 text-primary"><Icon className="size-5" /></span>
+      <div><div className="text-xl font-semibold tabular-nums">{value}</div><div className="text-xs text-muted-foreground">{label}</div></div>
+    </div>
+  );
+}
+
+function Field({ label, required = false, children }: { label: string; required?: boolean; children: ReactNode }) {
+  return <label className="space-y-1.5 text-sm font-medium">{label}{required && <span className="ml-1 text-destructive">*</span>}{children}</label>;
+}
+
+function ModelCapabilityBadge({
+  icon: Icon,
+  label,
+  className,
+}: {
+  icon?: typeof KeyRoundIcon;
+  label: string;
+  className: string;
+}) {
+  return (
+    <span className={`inline-flex h-7 items-center gap-1 whitespace-nowrap rounded px-2 text-xs font-medium leading-none ${className}`}>
+      {Icon && <Icon aria-hidden className="block size-3.5 shrink-0" />}
+      <span className="block leading-none">{label}</span>
+    </span>
+  );
+}
+
+function showGlobalMessage(
+  theme: "success" | "error" | "warning",
+  content: string,
+) {
+  // Schedule after the modal state update so the message is rendered above
+  // the page, rather than inside or behind a closing dialog.
+  window.setTimeout(() => {
+    MessagePlugin.closeAll();
+    void MessagePlugin[theme]({
+      content,
+      duration: 5_000,
+      placement: "top",
+      zIndex: 10_000,
+      attach: () => document.body,
+    });
+  }, 0);
+}
+
+function ModelEditor({ model, onClose }: { model: ManagedModel | null; onClose: () => void }) {
+  const isNew = model === null;
+  const [draft, setDraft] = useState<ModelDraft>(() => model ? draftFromModel(model) : emptyDraft());
+  const [advanced, setAdvanced] = useState(false);
+  const [testResult, setTestResult] = useState<{ success: boolean; latency: number; message: string; preview?: string | null } | null>(null);
+  const save = useSaveManagedModel();
+  const test = useTestManagedModel();
+  const patch = (next: Partial<ModelDraft>) => setDraft((current) => ({ ...current, ...next }));
+
+  const handleTest = async () => {
+    try {
+      const payload = buildPayload(draft);
+      const result = await test.mutateAsync(payload);
+      setTestResult({ success: result.success, latency: result.latency_ms, message: result.message, preview: result.preview });
+      if (!result.success) return void showGlobalMessage("error", `连接失败：${result.message}`);
+      showGlobalMessage("success", `连接成功${result.latency_ms ? `，${result.latency_ms} ms` : ""}`);
+    } catch (error) {
+      showGlobalMessage("error", error instanceof Error ? error.message : "连接测试失败");
+    }
+  };
+
+  const handleSave = async () => {
+    try {
+      const payload = buildPayload(draft);
+      if (!payload.name || !payload.use || !payload.model) {
+        return void showGlobalMessage("warning", "请填写模型标识、驱动与实际模型名");
+      }
+      await save.mutateAsync({ name: model?.name ?? payload.name, payload, isNew });
+      onClose();
+      showGlobalMessage(
+        "success",
+        isNew
+          ? `模型“${payload.name}”已添加，所有页面的模型选择器已刷新。`
+          : `模型“${payload.name}”的配置已保存并立即生效。`,
+      );
+    } catch (error) {
+      showGlobalMessage("error", error instanceof Error ? error.message : "保存模型配置失败");
+    }
+  };
+
+  return (
+    <Dialog
+      visible
+      header={isNew ? "添加模型" : `编辑模型：${model?.display_name || model?.name}`}
+      placement="center"
+      width={860}
+      zIndex={3200}
+      confirmBtn={{ content: isNew ? "添加并启用" : "保存配置", theme: "primary" }}
+      cancelBtn="取消"
+      confirmLoading={save.isPending}
+      onClose={onClose}
+      onConfirm={() => void handleSave()}
+      onCancel={onClose}
+    >
+      <div className="max-h-[70vh] space-y-5 overflow-y-auto px-1 py-1 pr-3">
+        <div className="rounded-lg border border-primary/20 bg-primary/5 px-3 py-2 text-sm text-muted-foreground">
+          保存会直接更新当前部署的 <code className="rounded bg-background px-1 py-0.5">config.yaml</code> 模型段，自动备份并热刷新；不会中断已开始的会话。
+        </div>
+        <section className="grid gap-4 md:grid-cols-2">
+          <Field label="稳定标识" required><Input value={draft.name} disabled={!isNew} placeholder="例如 deepseek-chat" tips={isNew ? "保存后不可修改，用于智能体和运行配置引用。" : "稳定标识不可修改，避免已有配置失效。"} onChange={(value) => patch({ name: String(value) })} /></Field>
+          <Field label="显示名称"><Input value={draft.display_name ?? ""} placeholder="例如 DeepSeek Chat" onChange={(value) => patch({ display_name: String(value) })} /></Field>
+          <Field label="模型驱动" required><Select value={draft.use} options={PROVIDER_OPTIONS} filterable creatable inputProps={{ placeholder: "选择或输入 use 类路径" }} onChange={(value) => patch({ use: String(value) })} /></Field>
+          <Field label="实际模型名" required><Input value={draft.model} placeholder="例如 deepseek-chat" onChange={(value) => patch({ model: String(value) })} /></Field>
+          <Field label="Base URL"><Input value={draft.base_url ?? ""} type="url" placeholder="https://api.example.com/v1" onChange={(value) => patch({ base_url: String(value) })} /></Field>
+          <Field label="API Key"><Input value={draft.api_key} type="password" placeholder={draft.keep_existing_key && !draft.clear_api_key ? "已配置，留空则保持不变" : "可填写密钥或 $ENVIRONMENT_VARIABLE"} onChange={(value) => patch({ api_key: String(value), clear_api_key: false })} /></Field>
+          {draft.keep_existing_key && !draft.api_key && <div className="md:col-span-2 flex items-center gap-2 text-xs text-muted-foreground"><KeyRoundIcon className="size-3.5" />已配置密钥{model?.api_key_source ? `（环境变量 ${model.api_key_source}）` : ""}，不会回显。<TButton theme="default" variant="text" size="small" onClick={() => patch({ clear_api_key: !draft.clear_api_key })}>{draft.clear_api_key ? "撤销清除" : "清除密钥"}</TButton></div>}
+          <div className="md:col-span-2"><Field label="描述"><Textarea value={draft.description ?? ""} autosize={{ minRows: 2, maxRows: 4 }} placeholder="说明模型适用的任务与限制" onChange={(value) => patch({ description: String(value) })} /></Field></div>
+        </section>
+        <section className="rounded-lg border border-border p-4">
+          <div className="mb-2"><h3 className="font-medium">能力声明</h3><p className="mt-1 text-xs text-muted-foreground">这些标识决定哪些页面会向模型提供思考、视觉或工具调用入口。</p></div>
+          <div className="flex flex-wrap gap-x-5 gap-y-3 text-sm"><span className="flex items-center gap-2"><Switch value={draft.supports_thinking} onChange={(value) => patch({ supports_thinking: Boolean(value) })} />支持思考</span><span className="flex items-center gap-2"><Switch value={draft.supports_vision} onChange={(value) => patch({ supports_vision: Boolean(value) })} />支持视觉</span><span className="flex items-center gap-2"><Switch value={draft.supports_reasoning_effort} onChange={(value) => patch({ supports_reasoning_effort: Boolean(value) })} />推理档位</span></div>
+        </section>
+        <div className="flex items-center justify-between border-t pt-4"><TButton theme="default" variant="outline" loading={test.isPending} onClick={() => void handleTest()}><WrenchIcon className="mr-1.5 size-4" />测试连接</TButton><TButton theme="default" variant="text" onClick={() => setAdvanced((value) => !value)}><Settings2Icon className="mr-1.5 size-4" />高级配置 <ChevronDownIcon className={`ml-1 size-4 transition-transform ${advanced ? "rotate-180" : ""}`} /></TButton></div>
+        {testResult && <div className={`rounded-lg border px-3 py-2 text-sm ${testResult.success ? "border-primary/20 bg-primary/5 text-foreground" : "border-destructive/25 bg-destructive/5 text-destructive"}`}><div className="font-medium">{testResult.success ? "连接成功" : "连接失败"}{testResult.success && testResult.latency ? ` · ${testResult.latency} ms` : ""}</div><p className="mt-1 break-words text-xs opacity-80">{testResult.preview || testResult.message}</p></div>}
+        {advanced && <section className="space-y-4 rounded-lg border border-dashed border-border bg-muted/10 p-4"><div className="grid gap-4 md:grid-cols-3"><Field label="请求超时（秒）"><InputNumber value={draft.request_timeout ?? ""} min={1} max={600} onChange={(value) => patch({ request_timeout: toNumber(value) })} /></Field><Field label="最大重试次数"><InputNumber value={draft.max_retries ?? ""} min={0} max={20} onChange={(value) => patch({ max_retries: toNumber(value) })} /></Field><Field label="最大输出 Token"><InputNumber value={draft.max_tokens ?? ""} min={1} max={1_000_000} onChange={(value) => patch({ max_tokens: toNumber(value) })} /></Field><Field label="温度"><InputNumber value={draft.temperature ?? ""} min={0} max={2} step={0.1} decimalPlaces={1} onChange={(value) => patch({ temperature: toNumber(value) })} /></Field><span className="flex items-end gap-2 pb-1 text-sm font-medium"><Switch value={draft.stream_usage ?? true} onChange={(value) => patch({ stream_usage: Boolean(value) })} />流式 Token 统计</span></div><Field label="额外参数 JSON"><Textarea value={draft.extra_settings_text} autosize={{ minRows: 4, maxRows: 10 }} placeholder={'{\n  "extra_body": {}\n}'} onChange={(value) => patch({ extra_settings_text: String(value) })} /><p className="text-xs font-normal text-muted-foreground">保留并编辑配置文件中未在基础表单展示的兼容参数。必须为 JSON 对象。</p></Field></section>}
+      </div>
+    </Dialog>
+  );
+}
+
+export default function ModelManagementPage() {
+  const { data, isLoading, error, refetch, isFetching } = useManagedModels();
+  const [search, setSearch] = useState("");
+  const [filter, setFilter] = useState<"all" | "thinking" | "vision">("all");
+  const [editor, setEditor] = useState<ManagedModel | null | "new">(null);
+  const [deleteTarget, setDeleteTarget] = useState<ManagedModel | null>(null);
+  const remove = useDeleteManagedModel();
+  const models = useMemo(() => {
+    const keyword = search.trim().toLowerCase();
+    return (data?.models ?? []).filter((model) => {
+      const matchesFilter = filter === "all" || (filter === "thinking" ? model.supports_thinking : model.supports_vision);
+      const matchesSearch = !keyword || [model.name, model.display_name, model.model, model.use].filter(Boolean).join(" ").toLowerCase().includes(keyword);
+      return matchesFilter && matchesSearch;
+    });
+  }, [data?.models, filter, search]);
+  const stats = useMemo(() => ({ total: data?.models.length ?? 0, thinking: data?.models.filter((item) => item.supports_thinking).length ?? 0, vision: data?.models.filter((item) => item.supports_vision).length ?? 0 }), [data?.models]);
+  const handleDelete = async () => {
+    if (!deleteTarget)
+      return;
+    try {
+      await remove.mutateAsync(deleteTarget.name);
+      const deletedName = deleteTarget.name;
+      setDeleteTarget(null);
+      showGlobalMessage("success", `模型“${deletedName}”已删除，配置已立即生效。`);
+    }
+    catch (error) {
+      showGlobalMessage("error", error instanceof Error ? error.message : "删除模型失败，请稍后重试。");
+    }
+  };
+  return (
+    <WorkspaceContainer>
+      <WorkspaceHeader />
+      <WorkspaceBody>
+        <main className="flex size-full min-h-0 flex-col overflow-y-auto bg-background px-6 py-5 md:px-8">
+          <div className="mx-auto flex w-full max-w-7xl flex-col gap-5">
+            <header className="flex flex-wrap items-start justify-between gap-4">
+              <div>
+                <div className="flex items-center gap-2">
+                  <span className="flex size-9 items-center justify-center rounded-lg bg-primary/10 text-primary">
+                    <CpuIcon className="size-5" />
+                  </span>
+                  <h1 className="text-2xl font-semibold tracking-tight">模型配置</h1>
+                </div>
+                <p className="mt-2 max-w-3xl text-sm leading-6 text-muted-foreground">
+                  管理当前部署 <code className="rounded bg-muted px-1 py-0.5">config.yaml</code> 中的对话模型。保存后所有页面立即可选；密钥仅可写入，永不回显。
+                </p>
+              </div>
+              <div className="flex flex-wrap items-center gap-2">
+                <TButton theme="default" variant="outline" loading={isFetching} onClick={() => void refetch()}>
+                  <RefreshCwIcon className="mr-1.5 size-4" />刷新
+                </TButton>
+                <TButton theme="primary" onClick={() => setEditor("new")}>
+                  <PlusIcon className="mr-1.5 size-4" />添加模型
+                </TButton>
+              </div>
+            </header>
+
+            <div className="grid gap-3 sm:grid-cols-3">
+              <StatCard icon={BotIcon} label="已配置模型" value={stats.total} />
+              <StatCard icon={SparklesIcon} label="支持思考" value={stats.thinking} />
+              <StatCard icon={EyeIcon} label="支持视觉" value={stats.vision} />
+            </div>
+
+            <section className="rounded-xl border border-border bg-card shadow-sm">
+              <div className="flex flex-wrap items-center justify-between gap-3 border-b px-4 py-3">
+                <div className="flex flex-wrap items-center gap-2">
+                  {([
+                    ["all", "全部"],
+                    ["thinking", "支持思考"],
+                    ["vision", "支持视觉"],
+                  ] as const).map(([value, label]) => (
+                    <TButton
+                      key={value}
+                      theme={filter === value ? "primary" : "default"}
+                      variant={filter === value ? "base" : "text"}
+                      size="small"
+                      onClick={() => setFilter(value)}
+                    >
+                      {label}
+                    </TButton>
+                  ))}
+                </div>
+                <Input
+                  value={search}
+                  placeholder="搜索名称、模型或驱动"
+                  clearable
+                  className="w-full sm:w-72"
+                  onChange={(value) => setSearch(String(value))}
+                />
+              </div>
+
+              {isLoading && (
+                <div className="flex h-52 items-center justify-center gap-2 text-sm text-muted-foreground">
+                  <LoaderCircleIcon className="size-4 animate-spin" />加载模型配置…
+                </div>
+              )}
+              {error && (
+                <div className="m-4 flex items-start gap-2 rounded-lg border border-destructive/25 bg-destructive/5 p-3 text-sm text-destructive">
+                  <CircleAlertIcon className="mt-0.5 size-4" />{error.message}
+                </div>
+              )}
+              {!isLoading && !error && models.length === 0 && (
+                <div className="flex h-52 flex-col items-center justify-center gap-2 text-sm text-muted-foreground">
+                  <CpuIcon className="size-7" />没有匹配的模型配置
+                </div>
+              )}
+              {!isLoading && !error && models.length > 0 && (
+                <div className="grid gap-3 p-4 lg:grid-cols-2">
+                  {models.map((model) => (
+                    <article key={model.name} className="rounded-lg border border-border bg-background p-4 transition-colors hover:border-primary/35">
+                      <div className="flex items-start justify-between gap-3">
+                        <div className="min-w-0">
+                          <div className="flex flex-wrap items-center gap-2">
+                            <h2 className="truncate font-semibold">{model.display_name || model.name}</h2>
+                            <Tag theme="success" variant="light" size="small">config.yaml</Tag>
+                          </div>
+                          <p className="mt-1 truncate font-mono text-xs text-muted-foreground">{model.name}</p>
+                        </div>
+                        <div className="flex shrink-0 items-center gap-1">
+                          <TButton theme="default" variant="outline" size="small" onClick={() => setEditor(model)}>
+                            配置
+                          </TButton>
+                          <TButton
+                            theme="danger"
+                            variant="text"
+                            size="small"
+                            aria-label={"删除模型 " + (model.display_name || model.name)}
+                            onClick={() => setDeleteTarget(model)}
+                          >
+                            <Trash2Icon className="mr-1 size-3.5" />删除
+                          </TButton>
+                        </div>
+                      </div>
+                      {model.description ? (
+                        <p className="mt-3 line-clamp-2 min-h-10 text-sm leading-5 text-muted-foreground">{model.description}</p>
+                      ) : (
+                        <p className="mt-3 min-h-10 text-sm leading-5 text-muted-foreground">未填写描述</p>
+                      )}
+                      <div className="mt-3 grid gap-2 border-t pt-3 text-xs text-muted-foreground sm:grid-cols-2">
+                        <span className="truncate" title={model.use}>驱动：{model.use}</span>
+                        <span className="truncate" title={model.model}>模型：{model.model}</span>
+                      </div>
+                      <div className="mt-3 flex flex-wrap items-center gap-1.5">
+                        {model.api_key_configured && (
+                          <ModelCapabilityBadge
+                            icon={KeyRoundIcon}
+                            label="已配置密钥"
+                            className="bg-muted text-foreground"
+                          />
+                        )}
+                        {model.supports_thinking && (
+                          <ModelCapabilityBadge
+                            icon={SparklesIcon}
+                            label="思考"
+                            className="bg-primary/10 text-primary"
+                          />
+                        )}
+                        {model.supports_vision && (
+                          <ModelCapabilityBadge
+                            icon={EyeIcon}
+                            label="视觉"
+                            className="bg-amber-500/10 text-amber-700 dark:text-amber-300"
+                          />
+                        )}
+                        {model.supports_reasoning_effort && (
+                          <ModelCapabilityBadge
+                            label="推理档位"
+                            className="bg-muted text-muted-foreground"
+                          />
+                        )}
+                      </div>
+                    </article>
+                  ))}
+                </div>
+              )}
+            </section>
+
+            {data?.config_path && (
+              <p className="text-xs text-muted-foreground">
+                当前配置文件：<code>{data.config_path}</code>
+                {data.updated_at ? " · 最近更新 " + new Date(data.updated_at).toLocaleString() : ""}
+              </p>
+            )}
+          </div>
+        </main>
+      </WorkspaceBody>
+
+      {editor !== null && (
+        <ModelEditor
+          key={editor === "new" ? "new" : editor.name}
+          model={editor === "new" ? null : editor}
+          onClose={() => setEditor(null)}
+        />
+      )}
+
+      {deleteTarget && (
+        <Dialog
+          visible
+          header="删除模型"
+          placement="center"
+          width={440}
+          zIndex={3200}
+          confirmBtn={{ content: "删除", theme: "danger" }}
+          cancelBtn="取消"
+          confirmLoading={remove.isPending}
+          onClose={() => {
+            if (!remove.isPending) setDeleteTarget(null);
+          }}
+          onCancel={() => {
+            if (!remove.isPending) setDeleteTarget(null);
+          }}
+          onConfirm={() => void handleDelete()}
+        >
+          <p className="text-sm leading-6 text-muted-foreground">
+            确定要删除模型 <code className="rounded bg-muted px-1 py-0.5">{deleteTarget.name}</code> 吗？删除后会立即更新运行中的模型配置，依赖它的智能体或任务可能无法继续使用。
+          </p>
+        </Dialog>
+      )}
+    </WorkspaceContainer>
+  );
+}
diff --git a/frontend-web/src/pages/WorkspaceRoutes.tsx b/frontend-web/src/pages/WorkspaceRoutes.tsx
index f89c863f..926c8992 100644
--- a/frontend-web/src/pages/WorkspaceRoutes.tsx
+++ b/frontend-web/src/pages/WorkspaceRoutes.tsx
@@ -42,6 +42,7 @@ 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';
@@ -785,6 +786,18 @@ export default function WorkspaceRoutes({
             )
           }
         />
+        <Route
+          path="admin/models"
+          element={
+            getStoredAuth()?.system_role === 'admin' ? (
+              <WorkspaceLayout {...layoutProps}>
+                <ModelManagementPage />
+              </WorkspaceLayout>
+            ) : (
+              <Navigate to="/page/workspace/chats/new" replace />
+            )
+          }
+        />
         <Route
           path="settings/model-concurrency"
           element={
diff --git a/frontend-web/src/position-roundtable/README.md b/frontend-web/src/position-roundtable/README.md
index 6c2b7e6b..2ef1efbd 100644
--- a/frontend-web/src/position-roundtable/README.md
+++ b/frontend-web/src/position-roundtable/README.md
@@ -24,11 +24,23 @@
 
 | 参数 | 是否必填 | 作用 |
 | --- | --- | --- |
-| `taskId` | 否 | 外部任务 ID。缺失时使用本地 mock 任务，便于演示和开发。 |
+| `taskId` | 否 | 外部任务 ID。传入后它是岗位会商的共享存储作用域；缺失时保持原有的个人会话逻辑。mock 仅提供任务卡片的显示兜底，绝不替换路由传入的 ID。 |
 | `sessionId` | 否 | 直接恢复指定岗位会商会话；缺失时页面会按 `taskId` 查找最近一条未归档会话。 |
 | `positionId` | 否 | 初始打开的岗位，同时同步顶部岗位选择器。无效值回退到 `intelligence`。 |
 | `new=1` | 否 | 强制不恢复历史会话，以新会话开始。 |
 
+传入 `taskId` 时，同一个任务下可以有多条会商会话，所有用户共享同一份历史、节点快照与 LangGraph 线程；当前 `user_id` 仅保留创建审计，不参与这些任务会话的读写过滤。页面恢复 `sessionId` 时会核验其 `externalTaskId` 与路由 `taskId` 一致，不一致会丢弃该会话并按当前任务重新发现历史。未传 `taskId` 时，会继续只读取当前用户的原有个人会话。
+
+### 外部系统按 taskId 对接
+
+1. 进入页面时将业务侧任务的稳定主键原样放入 URL。工作区入口使用 `/#/page/workspace/roundtable/position?taskId=<taskId>`；策略页入口也兼容 `/#/page/strategy/qa/position-roundtable?taskId=<taskId>`。不要使用任务标题、序号或每次请求都变化的临时 ID。
+2. 前端先调用 `GET /api/position-roundtable/sessions?external_task_id=<taskId>`；返回的是该任务下所有用户共享的会商记录，按最近更新时间排序。选中一条后再调用 `GET /sessions/{sessionId}` 恢复完整节点和聊天快照。
+3. 没有可恢复记录时，调用 `POST /sessions`，至少传入 `{ external_task_id: taskId, task_snapshot: { ...任务展示字段 } }`。服务端将 `task_scoped` 设为 `true`，并固定快照中的 `id` / `externalTaskId` 为传入的 taskId。
+4. 后续所有意图、链条、节点、收口智能体和历史删除 API 只使用返回的 `sessionId`；不要在每次消息请求中重新创建会话。一个 taskId 可以有多条 sessionId。
+5. 不传 `taskId`（同时省略 `external_task_id`）就是兼容模式：后端只返回和操作当前用户自己的个人会话，绝不会把历史记录升级为共享。响应中的 `task_scoped` 可用来区分两种记录。
+
+服务端从请求中的非空 `external_task_id` 判断是否开启共享，调用方无需也不应自行传 `task_scoped`。
+
 当前岗位 ID 定义在 `lib/positions.ts`：
 
 | ID | 页面岗位 | 职责 |
@@ -109,6 +121,31 @@ PositionRoundtablePage
 
 后端会冻结链条快照并根据链条阶段创建节点。已启动后意图不可再修改；需要重新识别时必须新建会话。
 
+The position workspace selects the dedicated built-in `position-roundtable-intent`
+agent by sending `intent_agent_id` through the shared Step-1 init and stream
+requests. The thread lifecycle, file upload, and SSE transport stay identical
+to the generic multi-agent flow. The dedicated agent permits at most five
+user-assistance rounds; one round may contain multiple independent
+`ask_clarification` cards. `Step1Panel` renders every card separately and
+submits the selected answers together, so cards must never be merged into one
+numbered multi-question card. Only its final `[INTENT_READY]` schema changes to
+the following four string arrays:
+
+```json
+{
+  "coreGoals": ["..."],
+  "riskWarnings": ["..."],
+  "keyPoints": ["..."],
+  "strategicSignificance": ["..."]
+}
+```
+
+The position sidebar and edit dialog render these four fields. Business-chain
+activation requires all four arrays and at least one core goal or strategic
+significance. Historic `objective` / `constraints` / `assumptions` snapshots
+are read through a compatibility mapping only; ordinary multi-agent Step 1 is
+not changed.
+
 ### 4.2 普通节点问答
 
 `PositionNodeChat` 在发送前调用 `getPositionNodeContext` 获取受长度控制的任务、意图和已交付上游内容，再以 `task_external_context` 作为隐藏上下文发送给当前智能体。
@@ -132,10 +169,16 @@ PositionRoundtablePage
 
 页面只维护一个 `sandboxArtifact`。`PositionNodeChat` 和 `PositionBuiltinAgentChat` 通过 `onPreviewArtifact` 上报预览目标；父页面统一渲染 `ArtifactFileDetail`。
 
+**对接 / 重做页面 / 排障指南（打开关闭时机、步骤条、接口约定）：**
+[`../../docs/position-roundtable-sandbox/沙箱打开关闭与步骤条.md`](../../docs/position-roundtable-sandbox/沙箱打开关闭与步骤条.md)
+（目录说明见 [`../../docs/position-roundtable-sandbox/README.md`](../../docs/position-roundtable-sandbox/README.md)）
+
 设计要点：
 
 - 文件正在由 `write_file` 流式生成时，优先显示源码；完成后交由预览组件切换 Markdown 预览；
-- `sandboxThreadSnapshot` 有 160ms 合并节流，只保留当前打开文件所在线程的最新快照，避免流式时频繁 setState；
+- `write_file` 的参数是一整个 JSON 流，键顺序由模型决定。若 `content` 先于 `path` 到达，会先用临时文件名（`未命名文件.md`／`.html`，按正文首部嗅探）开沙箱——流式内容只按 `message_id` + `tool_call_id` 定位，与路径无关；真实 `path` 到达后沿用同一个 `previewKey` 改名，属于「更新」而非第二次交付；
+- 流式快照**不能进页面 state**。本页很大（任务面板、意图结果、流程图、节点对话），按流式频率重渲染整页会把主线程占满，连消息列表都会停止绘制直到本轮结束。快照走 `createSandboxThreadStore()` + `SandboxThreadProvider`（`useSyncExternalStore`），只有沙箱子树重渲染；
+- 快照的合并节流是**前沿**节流：距上次推送超过 160ms 就在流回调里同步推送，未满则挂一个补尾定时器。不能只靠尾随定时器——主线程繁忙时回调会被饿死，面板会一直冻在打开时的内容；
 - 用户手动关闭后，`closedSandboxKeyRef` 与 `suppressedAutoPreviewThreadIdsRef` 阻止同一线程立即把沙箱重新打开；
 - 切岗位、切节点、切收口阶段、新建会话和切换历史会话都会先调用 `closeSandbox()`。
 
@@ -158,8 +201,8 @@ PositionRoundtablePage
 
 | 方法 | 路径 | 用途 |
 | --- | --- | --- |
-| `GET` | `/sessions?external_task_id=` | 按任务查询会话，用于恢复最近会话和历史记录。 |
-| `POST` | `/sessions` | 创建初始会话并保存任务快照。 |
+| `GET` | `/sessions?external_task_id=<taskId>` | 传入时按任务作用域查询共享会话；不传参数时查询当前用户的个人历史。 |
+| `POST` | `/sessions` | 创建会话并保存任务快照；传入非空 `external_task_id` 时服务端会将快照 ID 固定为该值并启用共享；缺失或空值时创建原有个人会话。 |
 | `GET` | `/sessions/{id}` | 恢复会话、节点和冻结快照。 |
 | `DELETE` | `/sessions/{id}` | 删除一条岗位会商历史及其节点；删除当前记录时前端会先屏蔽并发恢复请求。 |
 | `PUT` | `/sessions/{id}/task` | 更新未冻结的任务快照。 |
@@ -173,7 +216,7 @@ PositionRoundtablePage
 | `POST` | `/sessions/{id}/summary/*` | 准备、发送和完成方案总结。 |
 | `POST` | `/sessions/{id}/action-plan/*` | 准备、发送和完成行动规划。 |
 | `PUT` | `/sessions/{id}/{summary|action-plan}/conversation` | 保存两个收口智能体的消息与未发送草稿。 |
-| `POST` | `/demo/seed` | 按用户和 `demoKey` 幂等初始化完整演示会话。 |
+| `POST` | `/demo/seed` | 按 `demoKey` 幂等初始化完整演示会话。 |
 
 后端实现在 `offline-backend-20260512/backend/app/gateway/routers/position_roundtable.py`。
 
diff --git a/frontend-web/src/position-roundtable/api/sessions.ts b/frontend-web/src/position-roundtable/api/sessions.ts
index ac903dd6..e9e97497 100644
--- a/frontend-web/src/position-roundtable/api/sessions.ts
+++ b/frontend-web/src/position-roundtable/api/sessions.ts
@@ -68,7 +68,10 @@ export interface PositionRoundtableNode {
  */
 export interface PositionRoundtableSession {
   id: string;
+  /** Present only when the workspace was opened with a route `taskId`. */
   externalTaskId: string | null;
+  /** True only for sessions intentionally shared by an explicit route taskId. */
+  taskScoped: boolean;
   taskSnapshot: Record<string, unknown>;
   chainId: string | null;
   chainSnapshot: Record<string, unknown> | null;
@@ -112,6 +115,7 @@ interface ServerNode {
 interface ServerSession {
   id: string;
   external_task_id: string | null;
+  task_scoped?: boolean;
   task_snapshot?: Record<string, unknown>;
   chain_id: string | null;
   chain_snapshot?: Record<string, unknown> | null;
@@ -270,6 +274,7 @@ function toSession(session: ServerSession): PositionRoundtableSession {
   const result: PositionRoundtableSession = {
     id: session.id,
     externalTaskId: session.external_task_id,
+    taskScoped: session.task_scoped ?? false,
     taskSnapshot: session.task_snapshot ?? {},
     chainId: session.chain_id,
     chainSnapshot: session.chain_snapshot ?? null,
diff --git a/frontend-web/src/position-roundtable/components/PositionAgentInput.tsx b/frontend-web/src/position-roundtable/components/PositionAgentInput.tsx
index 7576eb32..d37f0608 100644
--- a/frontend-web/src/position-roundtable/components/PositionAgentInput.tsx
+++ b/frontend-web/src/position-roundtable/components/PositionAgentInput.tsx
@@ -1,10 +1,30 @@
-import { useEffect, useRef, type ComponentProps } from "react";
+import { useEffect, useMemo, useRef, type ComponentProps } from "react";
 
-import { InputBox } from "@/components/workspace/input-box";
-import { usePromptInputController } from "@/components/ai-elements/prompt-input";
-import { cn } from "@/lib/utils";
+import {
+  usePromptInputController,
+  type PromptInputMessage,
+} from "@/components/ai-elements/prompt-input";
+import type { InputBox } from "@/components/workspace/input-box";
+import { useModels } from "@/core/models/hooks";
+import type { AgentQuestion } from "@/core/agents";
+import { PositionIntentInput } from "@/position-roundtable/components/PositionIntentInput";
 
-type PositionAgentInputProps = ComponentProps<typeof InputBox> & {
+type InputBoxProps = ComponentProps<typeof InputBox>;
+type PositionAgentInputProps = Pick<
+  InputBoxProps,
+  | "className"
+  | "assistantId"
+  | "status"
+  | "disabled"
+  | "context"
+  | "onContextChange"
+  | "onSubmit"
+  | "onStop"
+  | "isNewThread"
+  | "threadId"
+  | "hideAdminRecommendedQuestions"
+> & {
+  commonQuestions?: (string | AgentQuestion)[] | null;
   /** Stable node/builtin key used to restore the matching SQL-backed draft. */
   draftKey?: string;
   draftValue?: string;
@@ -18,18 +38,36 @@ type PositionAgentInputProps = ComponentProps<typeof InputBox> & {
  * 只改这个组件即可，不会影响普通对话、工作区或其他业务页面。
  */
 export function PositionAgentInput({
-  className,
+  context,
+  disabled = false,
+  status = "ready",
+  onContextChange,
+  onSubmit,
+  onStop,
+  commonQuestions,
   draftKey = "",
   draftValue = "",
   onDraftChange,
-  ...props
 }: PositionAgentInputProps) {
-  const { textInput } = usePromptInputController();
+  const { textInput, attachments } = usePromptInputController();
+  const { models } = useModels();
   const activeDraftKeyRef = useRef("");
   const restoringValueRef = useRef<string | null>(null);
   const textInputRef = useRef(textInput);
   textInputRef.current = textInput;
 
+  const modelOptions = useMemo(
+    () => models.map((model) => ({ label: model.display_name ?? model.name, value: model.name })),
+    [models],
+  );
+  const attachedFiles = useMemo(
+    () =>
+      attachments.files
+        .map((attachment) => attachment.file)
+        .filter((file): file is File => file instanceof File),
+    [attachments.files],
+  );
+
   useEffect(() => {
     activeDraftKeyRef.current = draftKey;
     if (textInputRef.current.value !== draftValue) {
@@ -51,13 +89,60 @@ export function PositionAgentInput({
     onDraftChange?.(textInput.value);
   }, [draftKey, onDraftChange, textInput.value]);
 
-  // Keep the page-specific class on the wrapper rather than adding a variant
-  // to InputBox. Node chat and built-in chat can evolve together while every
-  // other workspace keeps the global composer untouched.
+  const handleSend = () => {
+    if (status === "streaming") {
+      onStop?.();
+      return;
+    }
+    const text = textInput.value.trim();
+    if (!text && attachedFiles.length === 0) return;
+    const message: PromptInputMessage = {
+      text: textInput.value,
+      files: attachments.files,
+    };
+    void onSubmit?.(message);
+    textInput.clear();
+    attachments.clear();
+  };
+
+  const handleModelChange = (modelName: string) => {
+    const model = models.find((candidate) => candidate.name === modelName);
+    if (!model) return;
+    onContextChange?.({ ...context, model_name: model.name });
+  };
+  const selectedModel =
+    typeof context.model_name === "string"
+      ? context.model_name
+      : modelOptions[0]?.value;
+
   return (
-    <InputBox
-      {...props}
-      className={cn("position-roundtable-agent-input w-full", className)}
+    <PositionIntentInput
+      value={textInput.value}
+      onValueChange={textInput.setInput}
+      attachedFiles={attachedFiles}
+      onAddFiles={attachments.add}
+      onRemoveFile={(index) => {
+        const attachment = attachments.files[index];
+        if (attachment) attachments.remove(attachment.id);
+      }}
+      charactersLeft={textInput.value.length}
+      isSending={status === "streaming"}
+      canSend={!disabled && (Boolean(textInput.value.trim()) || attachedFiles.length > 0)}
+      pendingClarification={false}
+      onSend={handleSend}
+      onStop={() => onStop?.()}
+      onFollowUp={() => undefined}
+      onSkip={() => undefined}
+      onEnterRoundtable={() => undefined}
+      enterButtonLabel=""
+      intentReady={null}
+      hideEnterRoundtable
+      onManualSave={() => undefined}
+      onTriggerToast={() => undefined}
+      modelOptions={modelOptions}
+      selectedModel={selectedModel}
+      onSelectedModelChange={handleModelChange}
+      commonQuestions={commonQuestions}
     />
   );
 }
diff --git a/frontend-web/src/position-roundtable/components/PositionBuiltinAgentChat.tsx b/frontend-web/src/position-roundtable/components/PositionBuiltinAgentChat.tsx
index e12e461c..0cec3208 100644
--- a/frontend-web/src/position-roundtable/components/PositionBuiltinAgentChat.tsx
+++ b/frontend-web/src/position-roundtable/components/PositionBuiltinAgentChat.tsx
@@ -716,7 +716,7 @@ export function PositionBuiltinAgentChat({
           </div>
         )}
 
-        <div className="position-roundtable-agent-composer-bar shrink-0 border-t border-slate-100 px-4 py-3 dark:border-[#2b8ffe]/20">
+        <div className="position-roundtable-agent-composer-bar position-roundtable-node-composer shrink-0">
           <PositionAgentInput
             className="w-full"
             isNewThread={!boundThreadId}
diff --git a/frontend-web/src/position-roundtable/components/PositionIntentInput.tsx b/frontend-web/src/position-roundtable/components/PositionIntentInput.tsx
index f4f1bfa3..2b5bdb7f 100644
--- a/frontend-web/src/position-roundtable/components/PositionIntentInput.tsx
+++ b/frontend-web/src/position-roundtable/components/PositionIntentInput.tsx
@@ -1,12 +1,9 @@
-import { useRef } from "react";
+import { useRef, useState } from "react";
 import {
   FileText,
-  Loader2,
-  Paperclip,
   Pause,
   Repeat,
   Save,
-  Send,
   Smile,
   Sparkles,
   X,
@@ -14,7 +11,11 @@ import {
 import { Select as TSelect } from "tdesign-react";
 
 import { AutoGrowTextarea } from "@/components/ui/auto-grow-textarea";
+import { normalizeAgentQuestions, type AgentQuestion } from "@/core/agents";
 import type { Step1InputAreaProps } from "@/roundtable-planning/components/Step1Panel";
+import moreTaskIcon from "@/assets/position-roundtable/more-task.svg";
+import uploadFileIcon from "@/assets/position-roundtable/upload-file.svg";
+import sendMessageIcon from "@/assets/position-roundtable/send-message.svg";
 
 interface PositionIntentModelOption {
   label: string;
@@ -25,6 +26,7 @@ interface PositionIntentInputProps extends Step1InputAreaProps {
   modelOptions?: PositionIntentModelOption[];
   selectedModel?: string;
   onSelectedModelChange?: (model: string) => void;
+  commonQuestions?: (string | AgentQuestion)[] | null;
 }
 
 /** Keep attachment metadata presentation local to this position-only composer. */
@@ -64,40 +66,25 @@ export function PositionIntentInput({
   modelOptions = [],
   selectedModel,
   onSelectedModelChange,
+  commonQuestions,
 }: PositionIntentInputProps) {
   // Files are owned by Step1Panel. This ref only opens the native picker and
   // forwards its selection through onAddFiles, so replacement layouts do not
   // accidentally create a second attachment state.
   const fileInputRef = useRef<HTMLInputElement>(null);
+  const [showMoreQuestions, setShowMoreQuestions] = useState(false);
+  const normalizedCommonQuestions = normalizeAgentQuestions(commonQuestions);
+  const visibleCommonQuestions = normalizedCommonQuestions.slice(0, 2);
+  const extraCommonQuestions = normalizedCommonQuestions.slice(2);
+
+  const pickCommonQuestion = (question: AgentQuestion) => {
+    onValueChange(question.prompt);
+    setShowMoreQuestions(false);
+  };
 
   return (
     <div className="position-roundtable-intent-input position-roundtable-intent-composer shrink-0 border-t border-slate-200 bg-[#f7faff] px-4 py-3 dark:border-[#2b8ffe]/35 dark:bg-[#071a38]">
       <div className="position-roundtable-intent-composer-frame relative overflow-hidden rounded-[4px] border border-slate-300 bg-white shadow-[0_2px_10px_rgba(15,23,42,0.08)] transition-all focus-within:border-primary focus-within:ring-2 focus-within:ring-[var(--brand-200)]/45 dark:border-[#2b8ffe]/55 dark:bg-[#0d2855] dark:shadow-none dark:focus-within:border-[#56baff] dark:focus-within:ring-[#2b8ffe]/25">
-        {attachedFiles.length > 0 && (
-          <div className="position-roundtable-intent-attachments mx-3 mb-2 flex flex-wrap gap-1.5 border-b border-slate-100 pb-2 pt-2.5 dark:border-[#2b8ffe]/25">
-            {attachedFiles.map((file, index) => (
-              <span
-                key={`${file.name}-${file.size}-${index}`}
-                className="inline-flex max-w-[200px] items-center gap-1.5 rounded-[4px] border border-slate-200 bg-slate-50 py-1 pl-2 pr-1 text-[11px] text-slate-600 dark:border-[#2b8ffe]/30 dark:bg-[#102f63] dark:text-[#c4dcff]"
-              >
-                <FileText className="size-3 shrink-0 text-primary" />
-                <span className="truncate font-medium" title={file.name}>
-                  {file.name}
-                </span>
-                <span className="shrink-0 text-slate-400">{formatFileSize(file.size)}</span>
-                <button
-                  type="button"
-                  onClick={() => onRemoveFile(index)}
-                  className="shrink-0 rounded-[3px] p-0.5 text-slate-400 transition hover:bg-slate-200 hover:text-slate-600 dark:text-[#8aaee0] dark:hover:bg-[#21447c] dark:hover:text-white"
-                  title="移除"
-                >
-                  <X className="size-3" />
-                </button>
-              </span>
-            ))}
-          </div>
-        )}
-
         <AutoGrowTextarea
           id="input-text-area"
           value={value}
@@ -144,7 +131,8 @@ export function PositionIntentInput({
               title="上传参考文件（智能体将读取文件内容辅助理解任务）"
               className="rounded-[3px] p-1.5 transition hover:bg-white hover:text-primary dark:hover:bg-[#16386e] dark:hover:text-[#73c8ff]"
             >
-              <Paperclip className="size-4" />
+              <img src={uploadFileIcon} alt="" aria-hidden="true" />
+              <span>上传附件</span>
             </button>
           </div>
           <span className="font-mono text-[10px] text-slate-400">{charactersLeft}/500</span>
@@ -154,8 +142,79 @@ export function PositionIntentInput({
           Parent pages can still hide optional actions by their stable ids
           without changing this component's layout or global input styles.
         */}
-        <div className="position-roundtable-intent-toolbar flex flex-wrap items-center gap-3 border-t border-slate-100 bg-white px-3 py-2.5 dark:border-[#2b8ffe]/25 dark:bg-[#0b234c]">
-          <div className="flex shrink-0 items-center">
+        <div className="position-roundtable-intent-toolbar flex flex-wrap items-center gap-3 border-t border-slate-100 px-3 py-2.5 dark:border-[#2b8ffe]/25">
+          <div className="position-roundtable-intent-common-slot">
+          {visibleCommonQuestions.length > 0 && (
+            <div className="position-roundtable-intent-common-questions">
+              {visibleCommonQuestions.map((question, index) => (
+                <button
+                  key={`${question.prompt}-${index}`}
+                  type="button"
+                  className="position-roundtable-intent-common-question"
+                  title={question.prompt}
+                  onClick={() => pickCommonQuestion(question)}
+                >
+                  <span aria-hidden="true" />
+                  <span>{question.title}</span>
+                </button>
+              ))}
+              {extraCommonQuestions.length > 0 && (
+                <div className="position-roundtable-intent-common-more">
+                  <button
+                    type="button"
+                    className="position-roundtable-intent-common-more-button"
+                    aria-label="更多常用问题"
+                    aria-expanded={showMoreQuestions}
+                    title="更多常用问题"
+                    onClick={() => setShowMoreQuestions((visible) => !visible)}
+                  >
+                    <img src={moreTaskIcon} alt="" aria-hidden="true" />
+                  </button>
+                  {showMoreQuestions && (
+                    <div className="position-roundtable-intent-common-more-menu">
+                      {extraCommonQuestions.map((question, index) => (
+                        <button
+                          key={`${question.prompt}-${index}`}
+                          type="button"
+                          title={question.prompt}
+                          onClick={() => pickCommonQuestion(question)}
+                        >
+                          {question.title}
+                        </button>
+                      ))}
+                    </div>
+                  )}
+                </div>
+              )}
+            </div>
+          )}
+          </div>
+          {attachedFiles.length > 0 && (
+            <div className="position-roundtable-intent-file-cards flex min-w-0 flex-1 items-center gap-1.5 overflow-x-auto">
+              {attachedFiles.map((file, index) => (
+                <span
+                  key={`${file.name}-${file.size}-${index}`}
+                  className="inline-flex max-w-[220px] shrink-0 items-center gap-1.5 rounded-[4px] border border-[#2b8ffe]/45 bg-[#0b3168] py-1 pl-2 pr-1 text-[11px] text-[#c4dcff]"
+                >
+                  <FileText className="size-3 shrink-0 text-[#73c8ff]" />
+                  <span className="truncate font-medium" title={file.name}>
+                    {file.name}
+                  </span>
+                  <span className="shrink-0 text-[#8aaee0]">{formatFileSize(file.size)}</span>
+                  <button
+                    type="button"
+                    onClick={() => onRemoveFile(index)}
+                    className="shrink-0 cursor-pointer rounded-[3px] p-0.5 text-[#8aaee0] transition hover:bg-[#21447c] hover:text-white"
+                    title="移除"
+                  >
+                    <X className="size-3" />
+                  </button>
+                </span>
+              ))}
+            </div>
+          )}
+          <div className="position-roundtable-intent-actions ml-auto flex min-w-0 flex-wrap items-center justify-end gap-1.5">
+          <div className="position-roundtable-intent-upload-wrap flex shrink-0 items-center">
             <input
               ref={fileInputRef}
               type="file"
@@ -169,28 +228,28 @@ export function PositionIntentInput({
             <button
               type="button"
               onClick={() => fileInputRef.current?.click()}
-              title="上传参考文件"
-              aria-label="上传参考文件"
-              className="position-roundtable-intent-upload-btn flex size-10 items-center justify-center rounded-[4px] border border-slate-200 bg-white text-slate-500 transition hover:border-primary/45 hover:text-primary dark:border-[#2b8ffe]/35 dark:bg-[#102f63] dark:text-[#b9d3f7] dark:hover:bg-[#1a417b] dark:hover:text-[#73c8ff]"
+              title="上传附件"
+              aria-label="上传附件"
+              className="position-roundtable-intent-upload-btn flex items-center justify-center rounded-[24px] border-0"
             >
-              <Paperclip className="size-4" />
+              <img src={uploadFileIcon} alt="" aria-hidden="true" />
+              <span>上传附件</span>
             </button>
           </div>
-          <div className="position-roundtable-intent-actions ml-auto flex min-w-0 flex-wrap items-center justify-end gap-1.5">
           {modelOptions.length > 0 && (
             <div
-              className="position-roundtable-intent-model-switch flex h-10 shrink-0 items-center gap-1.5 rounded-[4px] border border-slate-200 bg-white pl-2 text-xs font-bold text-slate-700 shadow-sm dark:border-[#2b8ffe]/35 dark:bg-[#102f63] dark:text-[#b9d3f7]"
-              title="切换意图理解模型"
+              className="position-roundtable-intent-model-switch flex h-8 shrink-0 items-center gap-1.5 rounded-[20px] border border-[#2b8ffe]/55 bg-[#0b3168] px-2.5 text-xs font-bold text-[#dceaff]"
+              title="鍒囨崲鎰忓浘鐞嗚В妯″瀷"
             >
-              <Sparkles className="size-3.5 shrink-0 text-primary dark:text-[#73c8ff]" />
+              <Sparkles className="size-3.5 shrink-0 text-[#73c8ff]" />
               <TSelect
                 size="small"
-                aria-label="切换意图理解模型"
+                aria-label="鍒囨崲鎰忓浘鐞嗚В妯″瀷"
                 value={selectedModel}
                 options={modelOptions}
                 disabled={isSending}
                 onChange={(value) => onSelectedModelChange?.(String(value))}
-                className="w-[150px] shrink-0 [&_.t-input]:!h-8 [&_.t-input]:!border-0 [&_.t-input]:!bg-transparent [&_.t-input]:!px-1 [&_.t-input]:!text-xs [&_.t-input]:!font-bold [&_.t-input]:!shadow-none dark:[&_.t-input]:!text-[#dceaff]"
+                className="w-[150px] shrink-0 [&_.t-input]:!h-7 [&_.t-input]:!rounded-[4px] [&_.t-input]:!border-0 [&_.t-input]:!bg-transparent [&_.t-input]:!px-1 [&_.t-input]:!text-xs [&_.t-input]:!font-bold [&_.t-input]:!text-[#dceaff] [&_.t-input]:!shadow-none"
                 popupProps={{ overlayClassName: "z-[80]" }}
               />
             </div>
@@ -198,26 +257,20 @@ export function PositionIntentInput({
           <button
             id="send-message-btn"
             type="button"
-            onClick={onSend}
-            disabled={!canSend}
-            className="position-roundtable-intent-send-btn flex h-10 shrink-0 items-center gap-1.5 rounded-[4px] bg-primary px-3 text-xs font-bold text-white shadow-[0_2px_8px_rgba(245,34,45,0.15)] transition-all active:scale-[0.98] hover:bg-[var(--brand-900)] disabled:cursor-not-allowed disabled:bg-slate-300 dark:bg-[#1478e8] dark:hover:bg-[#2995ff] dark:disabled:bg-[#28476f]"
+            onClick={isSending ? onStop : onSend}
+            disabled={isSending ? false : !canSend}
+            aria-label={isSending ? "暂停生成" : "发送"}
+            title={isSending ? "暂停生成" : "发送"}
+            className={`position-roundtable-intent-send-btn flex h-10 shrink-0 items-center gap-1.5 rounded-[4px] bg-primary px-3 text-xs font-bold text-white shadow-[0_2px_8px_rgba(245,34,45,0.15)] transition-all active:scale-[0.98] hover:bg-[var(--brand-900)] disabled:cursor-not-allowed disabled:bg-slate-300 dark:bg-[#1478e8] dark:hover:bg-[#2995ff] dark:disabled:bg-[#28476f]${isSending ? " position-roundtable-intent-send-btn--stopping" : ""}`}
           >
-            {isSending ? <Loader2 className="size-3 animate-spin" /> : <Send className="size-3" />}
-            {isSending ? "发送中" : "发送"}
+            {isSending ? (
+              <Pause className="size-4" aria-hidden="true" />
+            ) : (
+              <img src={sendMessageIcon} alt="" aria-hidden="true" />
+            )}
+            <span className="sr-only">{isSending ? "暂停生成" : "发送"}</span>
           </button>
 
-          {isSending && (
-            <button
-              id="pause-intent-btn"
-              type="button"
-              onClick={onStop}
-              className="flex h-10 shrink-0 items-center gap-1.5 rounded-[4px] border border-amber-200/40 bg-amber-100 px-3 text-xs font-bold text-amber-800 shadow-sm transition active:scale-[0.98] hover:bg-amber-200 dark:border-amber-300/30 dark:bg-amber-400/15 dark:text-amber-200 dark:hover:bg-amber-400/25"
-            >
-              <Pause className="size-3" />
-              暂停
-            </button>
-          )}
-
           <button
             id="suggest-followup-btn"
             type="button"
diff --git a/frontend-web/src/position-roundtable/components/PositionNodeChat.tsx b/frontend-web/src/position-roundtable/components/PositionNodeChat.tsx
index 754d9a12..f566fbb1 100644
--- a/frontend-web/src/position-roundtable/components/PositionNodeChat.tsx
+++ b/frontend-web/src/position-roundtable/components/PositionNodeChat.tsx
@@ -15,7 +15,11 @@ import { ThreadContext } from "@/components/workspace/messages/context";
 import { MessageList } from "@/components/workspace/messages";
 import { useAgent } from "@/core/agents";
 import { useLocalSettings } from "@/core/settings";
-import { useEditMessage, useThreadStream } from "@/core/threads/hooks";
+import {
+  useEditMessage,
+  useThreadStream,
+  type ToolStartEvent,
+} from "@/core/threads/hooks";
 import type { AgentThreadState } from "@/core/threads/types";
 import { textOfMessage } from "@/core/threads/utils";
 import { uuid } from "@/core/utils/uuid";
@@ -40,7 +44,6 @@ import {
   readConversationDraft,
   readConversationMessages,
 } from "@/position-roundtable/lib/conversation-snapshot";
-
 interface PositionNodeSwitchOption {
   node: PositionRoundtableNode;
   agentName?: string | null;
@@ -164,17 +167,100 @@ function artifactDisplayName(pathOrUrl: string): string {
   return path.split("/").filter(Boolean).at(-1) || "Markdown 报告";
 }
 
+function normalizeWriteFilePath(path: string): string {
+  let normalized = path.trim();
+  const first = normalized[0];
+  const last = normalized.at(-1);
+  if (
+    normalized.length >= 2 &&
+    ((first === '"' && last === '"') ||
+      (first === "'" && last === "'") ||
+      (first === "`" && last === "`"))
+  ) {
+    normalized = normalized.slice(1, -1).trim();
+  }
+  return normalized;
+}
+
+function isMarkdownPath(path: string): boolean {
+  const pathname = normalizeWriteFilePath(path).split(/[?#]/, 1)[0]?.toLowerCase() ?? "";
+  return pathname.endsWith(".md") || pathname.endsWith(".markdown");
+}
+
+function hasCompleteArtifactExtension(path: string): boolean {
+  const pathname = normalizeWriteFilePath(path).split(/[?#]/, 1)[0] ?? "";
+  const filename = pathname.split("/").filter(Boolean).at(-1) ?? "";
+  // During JSON argument streaming a Markdown path arrives as `.m` and then
+  // `.md`. Opening on the partial suffix permanently labels the preview TEXT.
+  // Extensionless files still open from on_tool_start once the full path is known.
+  return /\.[a-z0-9]{2,12}$/i.test(filename);
+}
+
+/**
+ * `write_file` arguments stream as one JSON object and the key order is up to
+ * the model. Agents that emit `content` before `path` leave the file nameless
+ * for as long as the body takes to write — a minute for a full report. The
+ * sandbox follows a streaming file by message/tool-call id, not by path, so it
+ * can open under a provisional name and adopt the real one later. Sniff the
+ * body so the provisional name at least carries the right extension.
+ */
+function provisionalWriteFilePath(content: string): string {
+  const head = content.slice(0, 256).trimStart().toLowerCase();
+  if (head.startsWith("<!doctype html") || head.startsWith("<html")) {
+    return "未命名文件.html";
+  }
+  return "未命名文件.md";
+}
+
+function writeFilePathFromToolEvent(data: unknown, depth = 0): string | null {
+  if (depth > 3 || data == null) return null;
+  if (typeof data === "string") {
+    const value = data.trim();
+    if (!value) return null;
+    if (value.startsWith("{") || value.startsWith("[")) {
+      try {
+        return writeFilePathFromToolEvent(JSON.parse(value), depth + 1);
+      } catch {
+        return null;
+      }
+    }
+    return null;
+  }
+  if (typeof data !== "object" || Array.isArray(data)) return null;
+  const record = data as Record<string, unknown>;
+  if (typeof record.path === "string") {
+    const path = normalizeWriteFilePath(record.path);
+    return path || null;
+  }
+  for (const key of ["input", "inputs", "args", "kwargs"]) {
+    const path = writeFilePathFromToolEvent(record[key], depth + 1);
+    if (path) return path;
+  }
+  return null;
+}
+
 function buildWriteFileVirtualUrl(path: string, messageId: string, toolCallId: string): string {
+  const language = isMarkdownPath(path) ? "&language=markdown" : "";
   return new URL(
     `write-file:${path}?message_id=${encodeURIComponent(
       messageId,
-    )}&tool_call_id=${encodeURIComponent(toolCallId)}`,
+    )}&tool_call_id=${encodeURIComponent(toolCallId)}${language}`,
   ).toString();
 }
 
+function isArtifactWriteTool(name: string | undefined): name is "write_file" | "str_replace" {
+  return name === "write_file" || name === "str_replace";
+}
+
 function latestStreamingWriteFile(
   messages: AgentThreadState["messages"],
-): { key: string; path: string; name: string; mimeType: string | null } | null {
+): {
+  key: string;
+  path: string;
+  sourcePath: string;
+  name: string;
+  mimeType: string | null;
+} | null {
   for (let messageIndex = messages.length - 1; messageIndex >= 0; messageIndex -= 1) {
     const message = messages[messageIndex] as (typeof messages)[number] & {
       id?: string;
@@ -183,17 +269,33 @@ function latestStreamingWriteFile(
     if (message.type !== "ai" || !message.id || !Array.isArray(message.tool_calls)) continue;
     for (let toolIndex = message.tool_calls.length - 1; toolIndex >= 0; toolIndex -= 1) {
       const toolCall = message.tool_calls[toolIndex];
-      if (toolCall?.name !== "write_file" || !toolCall.id) continue;
-      const rawPath = toolCall.args?.path;
-      if (typeof rawPath !== "string" || !rawPath.trim()) continue;
-      const content = toolCall.args?.content;
-      if (typeof content !== "string" || content.length === 0) continue;
-      const virtualPath = buildWriteFileVirtualUrl(rawPath, message.id, toolCall.id);
+      if (!isArtifactWriteTool(toolCall?.name) || !toolCall.id) continue;
+      const rawPath = typeof toolCall.args?.path === "string" ? toolCall.args.path : "";
+      const rawContent = typeof toolCall.args?.content === "string" ? toolCall.args.content : "";
+      const normalizedPath = normalizeWriteFilePath(rawPath);
+      const hasUsablePath =
+        Boolean(normalizedPath) && hasCompleteArtifactExtension(normalizedPath);
+      if (!hasUsablePath) {
+        // `str_replace` edits an existing file, so it can only be previewed once
+        // its real path is known. A new file is identified by its tool call, so
+        // its body can be previewed as soon as the first characters arrive.
+        if (toolCall.name !== "write_file" || !rawContent.trim()) continue;
+      }
+      const sourcePath = hasUsablePath ? normalizedPath : provisionalWriteFilePath(rawContent);
+      // Do not wait for the complete `content` argument. LangGraph streams
+      // write_file arguments incrementally, and the virtual artifact loader
+      // will redraw as `content` arrives. Waiting for it turns this into a
+      // post-generation preview instead of a live sandbox.
+      const previewPath =
+        toolCall.name === "write_file"
+          ? buildWriteFileVirtualUrl(sourcePath, message.id, toolCall.id)
+          : sourcePath;
       return {
         key: `${message.id}:${toolCall.id}`,
-        path: virtualPath,
-        name: artifactDisplayName(rawPath),
-        mimeType: rawPath.toLowerCase().endsWith(".md") ? "text/markdown" : null,
+        path: previewPath,
+        sourcePath,
+        name: artifactDisplayName(sourcePath),
+        mimeType: isMarkdownPath(sourcePath) ? "text/markdown" : null,
       };
     }
   }
@@ -214,7 +316,7 @@ function writeFileCallKeys(messages: AgentThreadState["messages"]): Set<string>
     };
     if (message.type !== "ai" || !message.id || !Array.isArray(message.tool_calls)) continue;
     for (const toolCall of message.tool_calls) {
-      if (toolCall?.name === "write_file" && toolCall.id) {
+      if (isArtifactWriteTool(toolCall?.name) && toolCall.id) {
         keys.add(`${message.id}:${toolCall.id}`);
       }
     }
@@ -265,11 +367,21 @@ export function PositionNodeChat({
   );
   const [boundThreadId, setBoundThreadId] = useState<string | null>(node.threadId);
   const boundThreadIdRef = useRef<string | null>(node.threadId);
+  const previousNodeBindingRef = useRef({
+    nodeKey: node.nodeKey,
+    threadId: node.threadId,
+  });
   const draftThreadIdRef = useRef(node.threadId ?? uuid());
   const upstreamRevisionRef = useRef<Record<string, unknown> | null>(null);
   const autoPreviewedArtifactKeyRef = useRef<string | null>(null);
   const autoPreviewBaselineCallKeysRef = useRef<Set<string>>(new Set());
   const autoPreviewRunArmedRef = useRef(false);
+  const writeFilePreviewSequenceRef = useRef(0);
+  const activeWriteFilePreviewRef = useRef<{
+    path: string;
+    previewKey: string;
+    toolCallId?: string;
+  } | null>(null);
   const editMessage = useEditMessage();
   const [messageContentOverrides, setMessageContentOverrides] = useState<Record<string, string>>({});
   const persistedMessages = useMemo(
@@ -288,12 +400,28 @@ export function PositionNodeChat({
     !node.invalidatedBy;
 
   useEffect(() => {
+    const previousBinding = previousNodeBindingRef.current;
+    previousNodeBindingRef.current = { nodeKey: node.nodeKey, threadId: node.threadId };
+    // `onStart` binds a newly created LangGraph thread before the session API
+    // persists that id back into `node.threadId`. That prop update happens
+    // while the first turn is already streaming; it is not a node switch and
+    // must not clear the preview run that has just been armed.
+    const isOwnThreadBinding =
+      previousBinding.nodeKey === node.nodeKey &&
+      previousBinding.threadId == null &&
+      node.threadId != null &&
+      node.threadId === boundThreadIdRef.current;
+    if (isOwnThreadBinding) return;
+
     setBoundThreadId(node.threadId);
     boundThreadIdRef.current = node.threadId;
     setInputDraft(readConversationDraft(node.conversationSnapshot));
     setMessageContentOverrides({});
+    autoPreviewedArtifactKeyRef.current = null;
     autoPreviewBaselineCallKeysRef.current = new Set();
     autoPreviewRunArmedRef.current = false;
+    writeFilePreviewSequenceRef.current = 0;
+    activeWriteFilePreviewRef.current = null;
     // The component is keyed by nodeKey in the page. This reset is therefore
     // only a defensive guard for callers that reuse the component instance.
     // eslint-disable-next-line react-hooks/exhaustive-deps
@@ -314,6 +442,43 @@ export function PositionNodeChat({
     [node.nodeKey, onNodeUpdate, sessionId],
   );
 
+  const handleToolStart = useCallback(
+    (event: ToolStartEvent) => {
+      if (!isArtifactWriteTool(event.name) || !autoPreviewRunArmedRef.current) return;
+      const path = writeFilePathFromToolEvent(event.data);
+      const threadId = boundThreadIdRef.current;
+      if (!path || !threadId) return;
+
+      // Message chunks and on_tool_start can describe the same invocation in
+      // either order. Reuse the first preview key so a manual close suppresses
+      // only this write, while a later rewrite receives a fresh key and opens.
+      const activePreview = activeWriteFilePreviewRef.current;
+      if (
+        activePreview?.path === path &&
+        (activePreview.toolCallId === event.toolCallId ||
+          (event.toolCallId != null && activePreview.previewKey.endsWith(`:${event.toolCallId}`)))
+      ) {
+        return;
+      }
+      const previewKey = event.toolCallId
+        ? `tool-start:${event.toolCallId}`
+        : `tool-start:${node.nodeKey}:${++writeFilePreviewSequenceRef.current}`;
+      activeWriteFilePreviewRef.current = { path, previewKey, toolCallId: event.toolCallId };
+      const artifactKey = `${threadId}:${previewKey}`;
+      if (autoPreviewedArtifactKeyRef.current === artifactKey) return;
+      autoPreviewedArtifactKeyRef.current = artifactKey;
+      onPreviewArtifact?.({
+        threadId,
+        path,
+        name: artifactDisplayName(path),
+        mimeType: isMarkdownPath(path) ? "text/markdown" : null,
+        previewKey,
+        auto: true,
+      });
+    },
+    [node.nodeKey, onPreviewArtifact],
+  );
+
   const [thread, sendMessage, , actualThreadId] = useThreadStream({
     threadId: boundThreadId,
     assistantId: node.agentId,
@@ -334,15 +499,21 @@ export function PositionNodeChat({
       agent_id: node.agentId,
     },
     onStart: bindCreatedThread,
+    onToolStart: handleToolStart,
     onFinish: (state) => {
       // A turn is not considered delivered by the UI alone. The persisted
       // completion call records the answer, file manifest and upstream version
       // so the service can decide whether this seat unlocks its downstream.
       const threadId = boundThreadIdRef.current;
-      const latestAi = [...(state.messages ?? [])]
+      // `present_files` is often the last AI tool call and has no prose of
+      // its own. Keep walking backwards to the last actual answer; otherwise
+      // a successful file delivery would return early here and never refresh
+      // the node's artifact cards.
+      const latestAnswer = [...(state.messages ?? [])]
         .reverse()
-        .find((message) => message.type === "ai");
-      const latestAnswer = latestAi ? textOfMessage(latestAi) ?? "" : "";
+        .filter((message) => message.type === "ai")
+        .map((message) => textOfMessage(message) ?? "")
+        .find((content) => content.trim()) ?? "";
       if (!threadId || !latestAnswer.trim()) return;
       void (async () => {
         let artifactManifest: Array<Record<string, unknown>> = [];
@@ -378,6 +549,10 @@ export function PositionNodeChat({
 
   const activeThreadId =
     boundThreadIdRef.current ?? actualThreadId ?? boundThreadId ?? draftThreadIdRef.current;
+  // A sandbox must always receive the server thread id. In particular, do not
+  // attach a streaming preview to the provisional UUID used for a new node
+  // before `useThreadStream` has created and bound its thread.
+  const previewThreadId = boundThreadIdRef.current ?? actualThreadId ?? boundThreadId ?? null;
   const persistedThreadId =
     boundThreadIdRef.current ?? actualThreadId ?? boundThreadId ?? null;
   const recoveredMessages = useMemo(
@@ -566,32 +741,60 @@ export function PositionNodeChat({
     () => (thread.isLoading ? latestStreamingWriteFile(thread.messages) : null),
     [thread.isLoading, thread.messages],
   );
+  const newStreamingArtifact =
+    streamingArtifact && !autoPreviewBaselineCallKeysRef.current.has(streamingArtifact.key)
+      ? streamingArtifact
+      : null;
 
   useEffect(() => {
     if (
       !thread.isLoading ||
-      !streamingArtifact ||
-      !autoPreviewRunArmedRef.current ||
-      autoPreviewBaselineCallKeysRef.current.has(streamingArtifact.key)
+      !newStreamingArtifact ||
+      !previewThreadId ||
+      !autoPreviewRunArmedRef.current
     ) {
       return;
     }
     // One write_file call should open at most one preview. The parent further
     // guards manual close state, because it owns the page-wide singleton sandbox.
-    // A report is often rewritten to the same output path.  The tool-call key
-    // (not just the path) makes that a new previewable delivery.
-    const artifactKey = `${activeThreadId}:${streamingArtifact.key}`;
+    // A report is often rewritten to the same output path — identity must be the
+    // tool-call key, not the path, otherwise a second write keeps the old panel
+    // and the sandbox never clears / remounts for the rewrite.
+    const toolCallKey = newStreamingArtifact.key;
+    const toolCallId = toolCallKey.includes(":")
+      ? toolCallKey.slice(toolCallKey.lastIndexOf(":") + 1)
+      : undefined;
+    const startedPreview = activeWriteFilePreviewRef.current;
+    const isSameToolCall =
+      startedPreview != null &&
+      (startedPreview.previewKey === toolCallKey ||
+        (toolCallId != null &&
+          (startedPreview.toolCallId === toolCallId ||
+            startedPreview.previewKey.endsWith(`:${toolCallId}`))));
+    // Same tool call may upgrade a provisional filename → real path; keep the
+    // open panel. A different tool call is a new delivery even on the same path.
+    const previewKey = isSameToolCall ? startedPreview.previewKey : toolCallKey;
+    activeWriteFilePreviewRef.current = {
+      path: newStreamingArtifact.sourcePath,
+      previewKey,
+      toolCallId: toolCallId ?? startedPreview?.toolCallId,
+    };
+    // The path takes part in the identity so that a preview opened under a
+    // provisional name is re-published once the real path streams in. The
+    // preview key stays the same, so the parent treats it as an update of the
+    // open panel rather than a second delivery.
+    const artifactKey = `${previewThreadId}:${previewKey}:${newStreamingArtifact.sourcePath}`;
     if (autoPreviewedArtifactKeyRef.current === artifactKey) return;
     autoPreviewedArtifactKeyRef.current = artifactKey;
     onPreviewArtifact?.({
-      threadId: activeThreadId,
-      path: streamingArtifact.path,
-      name: streamingArtifact.name,
-      mimeType: streamingArtifact.mimeType,
-      previewKey: streamingArtifact.key,
+      threadId: previewThreadId,
+      path: newStreamingArtifact.path,
+      name: newStreamingArtifact.name,
+      mimeType: newStreamingArtifact.mimeType,
+      previewKey,
       auto: true,
     });
-  }, [activeThreadId, onPreviewArtifact, streamingArtifact, thread.isLoading]);
+  }, [newStreamingArtifact, onPreviewArtifact, previewThreadId, thread.isLoading]);
 
   // SDK thread creation is asynchronous.  ``onStart`` normally binds it, but
   // watching the actual stream id as well closes the last race where a page
@@ -628,6 +831,7 @@ export function PositionNodeChat({
             : null;
         // A thread retains historical write_file tool calls. Only files whose
         // call id appears after this exact submission may open the sandbox.
+        activeWriteFilePreviewRef.current = null;
         autoPreviewBaselineCallKeysRef.current = writeFileCallKeys(thread.messages);
         autoPreviewRunArmedRef.current = true;
         await sendMessage(boundThreadIdRef.current ?? draftThreadIdRef.current, message, {
@@ -811,7 +1015,7 @@ export function PositionNodeChat({
           </div>
         )}
 
-        <div className="position-roundtable-agent-composer-bar shrink-0 border-t border-slate-100 px-4 py-3 dark:border-[#2b8ffe]/20">
+        <div className="position-roundtable-agent-composer-bar position-roundtable-node-composer shrink-0">
           <PositionAgentInput
             className="w-full"
             isNewThread={!boundThreadId}
@@ -825,6 +1029,7 @@ export function PositionNodeChat({
             onDraftChange={setInputDraft}
             hideAdminRecommendedQuestions
             onContextChange={(context) => setSettings("context", context)}
+            commonQuestions={agent?.common_questions}
             onSubmit={(message) => void handleSubmit(message)}
             onStop={() => void thread.stop()}
           />
diff --git a/frontend-web/src/position-roundtable/demo/position-roundtable-demo.ts b/frontend-web/src/position-roundtable/demo/position-roundtable-demo.ts
index f4bd57b4..ebd81e9f 100644
--- a/frontend-web/src/position-roundtable/demo/position-roundtable-demo.ts
+++ b/frontend-web/src/position-roundtable/demo/position-roundtable-demo.ts
@@ -97,6 +97,7 @@ export function getPositionDemoTask(): PositionTask {
     direction: String(task.direction ?? ""),
     source: String(task.source ?? "演示数据"),
     issuedAt: String(task.issuedAt ?? ""),
+    priority: String(task.priority ?? "紧急"),
   };
 }
 
diff --git a/frontend-web/src/position-roundtable/docs/沙箱打开关闭与步骤条.md b/frontend-web/src/position-roundtable/docs/沙箱打开关闭与步骤条.md
new file mode 100644
index 00000000..3a80f5fe
--- /dev/null
+++ b/frontend-web/src/position-roundtable/docs/沙箱打开关闭与步骤条.md
@@ -0,0 +1,391 @@
+# 岗位会商沙箱对接指南（重做页面 / 排障）
+
+## 文档用途
+
+给**下次重做或对接岗位会商页面**的同事用，也给线上「沙箱不实时 / 卡死 / 第二次不刷新」时排障用。
+
+读完应能回答：
+
+1. 新页面要接哪几个回调、传什么字段？
+2. 打开 / 关闭沙箱各在什么时机？和步骤条是什么关系？
+3. 哪些写法绝对不能用（会复现历史 bug）？
+4. 出问题时按什么顺序查？
+
+对照实现（当前生产路径）：
+
+| 角色 | 文件 |
+| --- | --- |
+| 页面壳（沙箱唯一宿主） | `pages/PositionRoundtablePage.tsx` |
+| 节点对话（探测 write_file、上报预览） | `components/PositionNodeChat.tsx` |
+| 收口对话 | `components/PositionBuiltinAgentChat.tsx` |
+| 预览 UI（共享组件，勿分叉逻辑） | `components/workspace/artifacts/artifact-file-detail.tsx` |
+| 流式正文读取 | `core/artifacts/loader.ts` → `loadArtifactContentFromToolCall` |
+| 普通对话页对照（步骤条自动开） | `components/workspace/messages/message-group.tsx` |
+
+模块总览见同目录上级 [`../README.md`](../README.md)；本文只覆盖**文件预览沙箱**这一条链路。
+
+---
+
+## 1. 验收标准（对接完成即通过）
+
+重做页面后，下列行为必须全部成立（与普通对话页用户感知一致）：
+
+| # | 行为 |
+| --- | --- |
+| A | 步骤条刚出现「写入文件」时，右侧沙箱应已打开（不必等文件名出现） |
+| B | 沙箱内源码随模型输出边写边滚；消息列表文字也实时出现，不能整页卡死 |
+| C | 模型若先吐正文、后吐 `path`：先用临时名打开，path 到了再改名，不闪屏重挂 |
+| D | 同一次问答里第二次 `write_file` 写同一路径（「重新生成」）：沙箱清空并重新流式 |
+| E | 整轮 `isLoading=false` 后，自动从源码切到 Markdown 预览 |
+| F | 用户手动关闭后，**同一次**写入不再自动弹；**下一轮**新写入仍可自动开 |
+| G | 切岗位 / 切节点 / 新建或切换会话时，沙箱关掉且不串内容 |
+
+---
+
+## 2. 职责划分（谁干什么）
+
+```text
+┌─────────────────────────────────────────────────────────────┐
+│ 页面壳（PositionRoundtablePage 或你的新页面）                  │
+│  · 唯一 sandboxArtifact 状态                                  │
+│  · handlePreviewArtifact / closeSandbox                       │
+│  · 流式线程外部 store（禁止整页 useState）                      │
+│  · 渲染唯一 ArtifactFileDetail                                │
+└──────────────────────────▲──────────────────────────────────┘
+                           │ onPreviewArtifact / onThreadSnapshot
+┌──────────────────────────┴──────────────────────────────────┐
+│ 对话子组件（PositionNodeChat 等）                              │
+│  · useThreadStream 拉消息                                     │
+│  · 渲染 MessageList / 步骤条（只展示，不直接开沙箱）              │
+│  · 探测 write_file → 组装 PositionArtifactPreview 上报          │
+│  · 每次 thread 变化上报 onThreadSnapshot                       │
+└─────────────────────────────────────────────────────────────┘
+```
+
+硬性规则：
+
+1. **沙箱只有一个实例**，挂在页面壳上，不要在对话子组件里再挂 `ArtifactFileDetail`。
+2. 对话子组件**不要**直接 `artifacts.setOpen(true)` 当作岗位会商的主路径（页面壳统一开合，才能做关闭抑制、切节点清理）。
+3. 步骤条和沙箱是**两条线**：步骤条只反映 tool call 展示；开沙箱走 `onPreviewArtifact`。
+
+---
+
+## 3. 对接接口（重新接页面时照此接线）
+
+### 3.1 对话子组件 → 页面壳
+
+#### `onPreviewArtifact(artifact)`
+
+请求打开或更新沙箱。载荷：
+
+```ts
+type PositionArtifactPreview = {
+  threadId: string;          // 必填：LangGraph thread id
+  path: string;              // 必填：真实路径，或 write-file: 虚拟 URL，或临时文件名
+  name: string;              // 展示名
+  mimeType: string | null;   // 如 text/markdown；帮助预览语言判断
+  previewKey?: string;       // 强烈建议：一次交付的身份，推荐 `${messageId}:${toolCallId}`
+  auto?: boolean;            // true = 流式自动打开；false/缺省 = 用户点击打开
+};
+```
+
+页面壳收到后应：
+
+1. `auto===true` 且 `closedSandboxKey === sandboxCloseKey(artifact)` → **直接 return**（用户刚关过这一次）。
+2. 更新页面级 `sandboxArtifact`（并同步 ref，见下）。
+3. 同步 `ArtifactsContext.select(path) + setOpen(true)`（与共享预览组件生命周期对齐）。
+4. 若已有该 thread 的最新快照，立刻推进沙箱 store。
+5. React `key` 用 `sandboxCloseKey(artifact)`（有 `previewKey` 时优先它），保证新交付会重挂。
+
+`sandboxCloseKey` 约定：
+
+```ts
+// 有 previewKey：threadId:write:${previewKey}
+// 无 previewKey：threadId:${normalizePath(path)}
+```
+
+#### `onThreadSnapshot({ threadId, thread })`
+
+把当前 `useThreadStream` 的 thread 对象持续交给页面壳，供沙箱读流式 `content`。
+
+页面壳应：
+
+1. 始终写入 `latestNodeThreadSnapshotRef`（打开瞬间可能用到）。
+2. **仅当**当前沙箱 `threadId` 与 snapshot 一致时，才 `queue` → store `publish`。
+3. 节流：前沿 160ms（见第 5 节），不要纯尾随 `setTimeout`。
+
+### 3.2 页面壳 → 预览组件
+
+```tsx
+{sandboxOpen && sandboxArtifact && (
+  <SandboxThreadProvider store={store} threadId={sandboxArtifact.threadId} fallbackThread={stub}>
+    <ArtifactFileDetail
+      key={sandboxCloseKey(sandboxArtifact)}
+      filepath={sandboxArtifact.path}
+      threadId={sandboxArtifact.threadId}
+      mimeType={sandboxArtifact.mimeType}
+      onClose={closeSandbox}
+      allowVirtualMarkdownEdit
+      // ...
+    />
+  </SandboxThreadProvider>
+)}
+```
+
+流式正文依赖虚拟 URL：
+
+```text
+write-file:${path}?message_id=...&tool_call_id=...&language=markdown
+```
+
+`loadArtifactContentFromToolCall` **只认** URL 里的 `message_id` + `tool_call_id`，从 `thread.messages` 对应 tool call 的 `args.content` 取值。  
+因此：**可以没有真实磁盘 path 就开沙箱**；path 主要用于文件名展示和语言猜测。
+
+### 3.3 对话子组件内部必做状态（可复用现有逻辑）
+
+重新实现探测时，至少保留这些语义（不必同名，语义要对）：
+
+| 状态 | 作用 |
+| --- | --- |
+| `armed` | 仅本轮用户 `send` 成功武装后才允许自动 `onPreviewArtifact` |
+| `baselineCallKeys` | send 前已有的 `messageId:toolCallId` 集合；忽略历史 write，防止一提问就开旧文件 |
+| `activePreview` | 当前已打开的 previewKey / path / toolCallId，用于 path 升级与同 call 去重 |
+| 线程绑定保护 | `node.threadId` 从 null→本节点刚创建的 id 时，**不要** disarm |
+
+发送时：
+
+```text
+baseline = 当前历史 write keys
+armed = true
+activePreview = null
+→ sendMessage(...)
+```
+
+探测时（`isLoading`）：
+
+```text
+找到最新 write_file / str_replace
+若不在 baseline：
+  - 有完整扩展名 path → 用真实 path
+  - write_file 且仅有 content → 临时名（未命名文件.md / .html）
+  - str_replace 无 path → 先不报
+  previewKey = 同 tool call 复用，否则新 key
+  → onPreviewArtifact({ ..., auto: true })
+```
+
+---
+
+## 4. 打开 / 关闭时序（对接时按此实现）
+
+### 4.1 打开（自动）
+
+```text
+用户发送
+  → armed=true + 拍 baseline
+  → 模型开始 write_file
+  → 步骤条出现「写入文件」（可能还没有 path）
+  → content 或完整 path 任一满足探测条件
+  → onPreviewArtifact(auto)
+  → 页面壳打开 ArtifactFileDetail + 推送 thread 快照
+  → 源码视图滚动更新
+  →（可选）真实 path 到达：同 previewKey 改名（path upgrade，不重挂）
+  → isLoading=false：共享组件自动切预览
+```
+
+### 4.2 同轮第二次写入（重新生成）
+
+```text
+write_file #1 → previewKey = msg:tc1 → 打开
+write_file #2 同 path → previewKey = msg:tc2（必须变）
+  → React key 变 → 组件重挂 → 视觉上清空再生成
+```
+
+**禁止**用「path 相同 ⇒ 复用 previewKey」。那会导致步骤条有「重新生成」、沙箱却不动。
+
+### 4.3 关闭
+
+| 触发 | 行为 |
+| --- | --- |
+| 用户点关闭 | `closedSandboxKeyRef = sandboxCloseKey(current)`；清 artifact / store / 定时器 |
+| 切岗位、切节点、新会话、切历史 | 先 `closeSandbox()`（可按产品决定是否写入抑制键；至少清面板） |
+| 自动打开被抑制 | 仅当 `auto && closedKey === 当前 key`；手动打开应清抑制 |
+
+抑制粒度必须是**单次交付（previewKey）**，不能是「整个 thread 永远不再自动开」。
+
+---
+
+## 5. 重做页面时的必守规则（违反必出 bug）
+
+1. **流式 thread 快照禁止进页面级 `useState`**  
+   大页面每秒重渲染数次会占满主线程：消息列表停更、沙箱冻住、定时器饿死。  
+   正确：外部 store + `useSyncExternalStore`，只让沙箱子树订阅。
+
+2. **节流用前沿（leading-edge），不要纯尾随 `setTimeout`**  
+   距上次 publish ≥ 160ms → 同步 publish；否则补尾定时器。  
+   纯「有 timer 就 return」在忙主线程下会十几秒不 flush。
+
+3. **不要等完整 `path` 才开沙箱**  
+   报告类 agent 常先流 `content`、最后才流 `path`，硬等会晚几十秒。  
+   `write_file` + 已有 content → 临时名打开；`str_replace` 仍等真实 path。
+
+4. **扩展名要完整再当「真实 path」**  
+   流式中 `.m` → `.md`，过早打开会把语言锁成 TEXT。
+
+5. **previewKey 按 tool call，不按 path**  
+   同 path 多次写入 = 多次交付。
+
+6. **打开瞬间同步推进 `sandboxArtifactRef`**  
+   若 flush 快照时只看 ref、而 setState 尚未提交，首帧会被「threadId 不匹配」丢掉。
+
+7. **不要依赖 `onToolStart` 作为唯一打开手段**  
+   当前后端对部分 stream mode 可能过滤；主路径必须是 `thread.messages` 里渐进出现的 `tool_calls`。
+
+8. **path upgrade 不要当第二次打开**  
+   同 previewKey 改 path：更新 artifact，不要乱关抽屉 / 不要重挂。
+
+9. **「结束后才切预览」不是打开 bug**  
+   `ArtifactFileDetail` 对 markdown/html 在 `isLoading` 期间强制源码视图，与普通对话页相同。
+
+---
+
+## 6. 步骤条怎么对接理解
+
+步骤条来自消息里的 tool call 渲染（`message-group`），标题优先 `args.description`，否则文案「写入文件」；子行显示 `args.path`。
+
+| 你看到的步骤条 | 含义 | 沙箱应处于 |
+| --- | --- | --- |
+| 仅「写入文件」，无路径 | tool call 已开始，path 可能还没流到 | **应已打开**（临时名） |
+| 「写入文件」+ 路径 | path 已可用 | 已打开；若刚从临时名升级则只改名 |
+| 第二条「重新生成…」+ 同路径 | 新的 write_file（新 toolCallId） | **应重挂**并重新流式 |
+| 生成中顶部「正在生成，完成后自动预览」 | 仍在 code 视图 | 正常，等 isLoading 结束切预览 |
+
+对接时不要把「步骤条出现文件名」当成「开沙箱的唯一信号」——那会在 content-first 模型上系统性偏晚。
+
+---
+
+## 7. 排障手册（按症状查）
+
+### 7.1 沙箱开得很晚 / 要等文件名才开
+
+检查顺序：
+
+1. 探测是否仍要求「必须有完整 path」？→ 改为 content 可开临时名。  
+2. `armed` 是否在 `threadId` 回写时被误清？→ 保护「本节点绑定自己的新 thread」。  
+3. 是否被 `closedSandboxKey` 抑制？→ 看是否刚关过同 previewKey。  
+4. 新 call 是否落在 baseline 里？→ baseline 只能在 send 时拍一次。
+
+### 7.2 沙箱打开了但内容空白 / 冻住，生成完才一口气出来
+
+1. 快照是否写进了页面 `useState`？→ 改 store。  
+2. 节流是否纯尾随定时器？→ 改前沿。  
+3. `SandboxThreadProvider` 是否把带 `messages` 的 thread 传给了 `ArtifactFileDetail`？  
+4. 虚拟 URL 的 `tool_call_id` 是否与消息里一致？  
+5. 打开时 `sandboxArtifactRef` 是否已同步（避免首帧 flush 被丢）？
+
+### 7.3 消息列表也不实时，整页很卡
+
+优先怀疑页面壳在流式频率下整页重渲染。  
+确认没有把 `onThreadSnapshot` 落到大页面 state；临时 `console.debug` 每 chunk 打大对象也会加重（排障完删掉）。
+
+### 7.4 第二次「重新生成」步骤有了，沙箱不变
+
+previewKey 是否按 path 复用了？→ 必须按 `messageId:toolCallId`。  
+`ArtifactFileDetail` 的 `key` 是否跟 previewKey 走？否则不会重挂。
+
+### 7.5 第一次实时开，关掉后再问就不实时 / 很晚才开
+
+抑制是否绑在整个 `threadId` 上？→ 改为单次 `sandboxCloseKey(previewKey)`。
+
+### 7.6 预览变成纯文本 / 不像 Markdown
+
+1. 是否在 `.m` 阶段就当完整 path 打开了？  
+2. 临时名是否带 `.md` / URL 是否带 `language=markdown` / 是否传了 `mimeType`？  
+3. path 是否有首尾空格？
+
+### 7.7 只靠 onToolStart，线上偶发永远不开
+
+后端可能不推 tools/events。主路径改为扫描 `thread.messages` 的 streaming `tool_calls`。
+
+---
+
+## 8. 对接自测清单（重做页面后必跑）
+
+- [ ] 首轮：步骤条「写入文件」出现时，沙箱是否已开并开始出字？  
+- [ ] content-first agent：无文件名阶段是否也能开？  
+- [ ] path 到达后：是否只改名、不整页闪？  
+- [ ] 同轮第二次同路径 write：是否清空并重新流式？  
+- [ ] 流式中消息列表是否仍实时？页面是否明显卡顿？  
+- [ ] 手动关闭后本次是否不再弹？下一轮是否仍可自动开？  
+- [ ] 结束后是否自动切 Markdown 预览？  
+- [ ] 切节点 / 切岗位 / 新会话：沙箱是否关闭且内容不串？  
+
+---
+
+## 9. 最小接线伪代码（新页面可抄）
+
+```tsx
+// 页面壳
+const [sandboxArtifact, setSandboxArtifact] = useState<PositionArtifactPreview | null>(null);
+const sandboxArtifactRef = useRef(sandboxArtifact);
+const closedSandboxKeyRef = useRef<string | null>(null);
+const store = useMemo(createSandboxThreadStore, []);
+
+function handlePreviewArtifact(artifact: PositionArtifactPreview) {
+  const key = sandboxCloseKey(artifact);
+  if (artifact.auto && closedSandboxKeyRef.current === key) return;
+
+  const prev = sandboxArtifactRef.current;
+  const sameKey = prev?.previewKey && prev.previewKey === artifact.previewKey
+    && prev.threadId === artifact.threadId;
+  const pathOnlyUpgrade = sameKey && prev.path !== artifact.path;
+
+  sandboxArtifactRef.current = artifact;
+  setSandboxArtifact(artifact);
+  // publish latest thread snapshot into store (leading-edge throttle)
+  // ArtifactsContext.select + setOpen(true)
+  if (!pathOnlyUpgrade) closeRightDrawer();
+}
+
+function closeSandbox() {
+  if (sandboxArtifactRef.current) {
+    closedSandboxKeyRef.current = sandboxCloseKey(sandboxArtifactRef.current);
+  }
+  sandboxArtifactRef.current = null;
+  setSandboxArtifact(null);
+  store.publish(null);
+}
+
+// 对话子组件
+<PositionNodeChat
+  onPreviewArtifact={handlePreviewArtifact}
+  onThreadSnapshot={handleNodeThreadSnapshot}
+/>
+```
+
+对话侧探测逻辑优先**复用** `PositionNodeChat` 内的 `latestStreamingWriteFile` / armed / baseline，而不是从零再写一套——这是最容易写错的部分。
+
+---
+
+## 10. 术语
+
+| 词 | 含义 |
+| --- | --- |
+| armed | 本轮用户发送后，允许自动打开沙箱 |
+| baseline | send 前已有 write tool call 集合，用于忽略历史产物 |
+| previewKey | 一次交付身份，推荐 `messageId:toolCallId` |
+| sandboxCloseKey | 关闭抑制键 + React key |
+| provisional path | 无真实 path 时的临时文件名 |
+| path upgrade | 同 previewKey 下临时名 → 真实 path |
+| sandboxThreadStore | 流式线程外部 store，避免整页重渲染 |
+| write-file: URL | 用 message/tool call id 定位流式 content 的虚拟路径 |
+
+---
+
+## 11. 相关提交（背景）
+
+若需对照修复动机，可查：
+
+- `fix(frontend): 岗位会商沙箱在 write_file 流式阶段实时打开并刷新` — 临时名打开、store、前沿节流  
+- `fix(frontend): 同路径二次 write_file 时重挂岗位会商沙箱` — previewKey 按 tool call  
+
+排障时优先对照本文第 5、7 节，再对照上述提交的 diff。
diff --git a/frontend-web/src/position-roundtable/lib/mock-task-source.ts b/frontend-web/src/position-roundtable/lib/mock-task-source.ts
index 206084a5..97fbecd1 100644
--- a/frontend-web/src/position-roundtable/lib/mock-task-source.ts
+++ b/frontend-web/src/position-roundtable/lib/mock-task-source.ts
@@ -13,6 +13,7 @@ export interface PositionTask {
   direction: string;
   source: string;
   issuedAt: string;
+  priority?: string;
 }
 
 export const MOCK_POSITION_TASKS: readonly PositionTask[] = [
@@ -30,16 +31,21 @@ export const MOCK_POSITION_TASKS: readonly PositionTask[] = [
 export const DEFAULT_MOCK_POSITION_TASK_ID = MOCK_POSITION_TASKS[0].id;
 
 export function getMockPositionTask(taskId?: string | null): PositionTask {
-  return (
+  const fixture =
     MOCK_POSITION_TASKS.find((task) => task.id === taskId) ??
-    MOCK_POSITION_TASKS[0]
-  );
+    MOCK_POSITION_TASKS[0];
+  const scopedTaskId = taskId?.trim();
+  // The fixture supplies only display defaults.  Preserve the caller's task
+  // identity so persistence, history and LangGraph thread metadata all remain
+  // bound to the route taskId.
+  return scopedTaskId ? { ...fixture, id: scopedTaskId } : fixture;
 }
 
 /** Normalizes a persisted Session task snapshot without exposing source internals. */
 export function taskFromPositionSnapshot(
   snapshot: Record<string, unknown> | null | undefined,
   fallback: PositionTask,
+  taskScopeId?: string,
 ): PositionTask {
   if (!snapshot || Object.keys(snapshot).length === 0) return fallback;
   const value = (keys: string[], defaultValue: string) => {
@@ -49,10 +55,15 @@ export function taskFromPositionSnapshot(
     return typeof found === "string" ? found : defaultValue;
   };
   return {
-    id: value(["id", "taskId", "externalTaskId"], fallback.id),
+    // Session snapshots are editable display data, while the route taskId is
+    // the stable shared-storage scope.  Keeping them separate prevents a
+    // legacy/mock snapshot from moving a live external task into another
+    // task's history bucket.
+    id: taskScopeId?.trim() || value(["id", "taskId", "externalTaskId"], fallback.id),
     title: value(["title", "taskName", "name"], fallback.title),
     description: value(["description", "taskContent", "overview", "content"], fallback.description),
     direction: value(["direction", "taskDirection", "category"], fallback.direction),
+    priority: value(["priority", "level", "urgency"], fallback.priority ?? "紧急"),
     source: (() => {
       const source = value(["source", "taskSource", "sourceName"], fallback.source);
       return source === "mock" ? "本系统创建" : source;
diff --git a/frontend-web/src/position-roundtable/pages/PositionRoundtablePage.tsx b/frontend-web/src/position-roundtable/pages/PositionRoundtablePage.tsx
index df40752e..71b7a466 100644
--- a/frontend-web/src/position-roundtable/pages/PositionRoundtablePage.tsx
+++ b/frontend-web/src/position-roundtable/pages/PositionRoundtablePage.tsx
@@ -1,5 +1,14 @@
 import type { BaseStream } from "@langchain/langgraph-sdk/react";
-import { type ReactNode, useCallback, useEffect, useMemo, useRef, useState } from "react";
+import {
+  type ReactNode,
+  useCallback,
+  useEffect,
+  useMemo,
+  useRef,
+  useState,
+  useSyncExternalStore,
+} from "react";
+import { createPortal } from "react-dom";
 import { useQuery } from "@tanstack/react-query";
 import { useNavigate, useSearchParams } from "react-router-dom";
 import {
@@ -74,7 +83,23 @@ import { textOfMessage } from "@/core/threads/utils";
 import { desensitize } from "@/lib/desensitize";
 import { cn } from "@/lib/utils";
 import expandLogo from "@/assets/position-roundtable/expand-logo.svg";
-import { listChains } from "@/roundtable-planning/api/chains";
+import editTaskIcon from "@/assets/position-roundtable/edit-task.svg";
+import searchTaskIcon from "@/assets/position-roundtable/search-task.svg";
+import addTaskIcon from "@/assets/position-roundtable/add-task.svg";
+import moreTaskIcon from "@/assets/position-roundtable/more-task.svg";
+import askQuestionIcon from "@/assets/position-roundtable/ask-question.svg";
+import agentConfigLogo from "@/assets/position-roundtable/agent-config-logo.svg";
+import doubleArrowDecoration from "@/assets/position-roundtable/double-arrow-decoration.svg";
+import collapsePanelIcon from "@/assets/position-roundtable/collapse-panel.svg";
+import analysisTag1 from "@/assets/position-roundtable/标签1.svg";
+import analysisTag2 from "@/assets/position-roundtable/标签2.svg";
+import analysisTag3 from "@/assets/position-roundtable/标签3.svg";
+import analysisTag4 from "@/assets/position-roundtable/标签4.svg";
+import analysisTag5 from "@/assets/position-roundtable/标签5.svg";
+import analysisTag6 from "@/assets/position-roundtable/标签6.svg";
+import responsibilityIcon from "@/assets/position-roundtable/责任岗位.svg";
+import resultTimeIcon from "@/assets/position-roundtable/时间.svg";
+import { deleteChain, listChains } from "@/roundtable-planning/api/chains";
 import { Step1Panel } from "@/roundtable-planning/components/Step1Panel";
 import { PositionIntentInput } from "@/position-roundtable/components/PositionIntentInput";
 import { PositionNodeChat } from "@/position-roundtable/components/PositionNodeChat";
@@ -86,7 +111,11 @@ import {
   type InteractiveMessage,
   type TimelineEntry,
 } from "@/roundtable-planning/hooks/useStep1Intent";
-import type { IntentSummary } from "@/roundtable-planning/api/intent";
+import {
+  POSITION_INTENT_AGENT_ID,
+  type IntentSummary,
+  type PositionIntentSummary,
+} from "@/roundtable-planning/api/intent";
 import type { BusinessChain } from "@/roundtable-planning/lib/business-chain";
 import { getAvatarTypeFor } from "@/roundtable-planning/lib/roundtable-constants";
 import {
@@ -115,6 +144,7 @@ import {
   getPositionSession,
   isPositionSessionNotFoundError,
   listPositionSessions,
+  PositionSessionNotFoundError,
   preparePositionActionPlan,
   preparePositionSummary,
   rejectPositionNode,
@@ -157,11 +187,24 @@ type PositionArtifactPreview = {
   previewKey?: string;
   auto?: boolean;
 };
+
+function isSessionInTaskScope(
+  session: PositionRoundtableSession,
+  taskScopeId: string | null,
+): boolean {
+  // The legacy entry has no taskId and remains user-owned.  Explicit taskId
+  // deep links are the only shared mode and must never cross task scopes.
+  return taskScopeId === null
+    ? !session.taskScoped
+    : session.taskScoped && session.externalTaskId === taskScopeId;
+}
+
 type ClosureStageKind = PositionBuiltinAgentKind;
 type IntentEditDraft = {
-  objective: string;
-  constraints: string;
-  assumptions: string;
+  coreGoals: string;
+  riskWarnings: string;
+  keyPoints: string;
+  strategicSignificance: string;
 };
 type SandboxThreadSnapshot = {
   threadId: string;
@@ -319,6 +362,72 @@ function sandboxCloseKey(
   return `${artifact.threadId}:${normalizePreviewArtifactPath(artifact.path)}`;
 }
 
+type SandboxThreadStore = {
+  subscribe: (listener: () => void) => () => void;
+  getSnapshot: () => SandboxThreadSnapshot | null;
+  publish: (next: SandboxThreadSnapshot | null) => void;
+};
+
+/**
+ * The streaming thread reaches the sandbox through a subscription rather than
+ * page state. This page is large — task panel, intent results, flowchart, node
+ * chat — and a streamed file publishes several times per second. Driving that
+ * through `useState` here re-renders the whole page at that rate and starves the
+ * browser so badly that even the message list stops painting until the run ends.
+ * With a store, only `SandboxThreadProvider` and the preview below it re-render.
+ */
+function createSandboxThreadStore(): SandboxThreadStore {
+  let snapshot: SandboxThreadSnapshot | null = null;
+  const listeners = new Set<() => void>();
+  return {
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    getSnapshot: () => snapshot,
+    publish(next) {
+      const isUnchanged =
+        snapshot === next ||
+        (snapshot != null &&
+          next != null &&
+          snapshot.threadId === next.threadId &&
+          snapshot.signature === next.signature);
+      if (isUnchanged) return;
+      snapshot = next;
+      for (const listener of listeners) {
+        listener();
+      }
+    },
+  };
+}
+
+function SandboxThreadProvider({
+  store,
+  threadId,
+  fallbackThread,
+  children,
+}: {
+  store: SandboxThreadStore;
+  threadId: string;
+  fallbackThread: BaseStream<AgentThreadState>;
+  children: ReactNode;
+}) {
+  const snapshot = useSyncExternalStore(store.subscribe, store.getSnapshot);
+  const thread = snapshot?.threadId === threadId ? snapshot.thread : fallbackThread;
+  const value = useMemo(() => ({ thread, isMock: false }), [thread]);
+  return <ThreadContext.Provider value={value}>{children}</ThreadContext.Provider>;
+}
+
+/**
+ * Upper bound on how often the streaming thread is re-published to the sandbox.
+ * Message chunks arrive roughly every 30ms and re-rendering the artifact panel
+ * is expensive, so updates are coalesced — but never postponed past this gap,
+ * otherwise the panel visibly freezes while the file is being written.
+ */
+const SANDBOX_SNAPSHOT_MIN_INTERVAL_MS = 160;
+
 function sandboxThreadSignature(thread: BaseStream<AgentThreadState>): string {
   const messages = thread.messages ?? [];
   for (let messageIndex = messages.length - 1; messageIndex >= 0; messageIndex -= 1) {
@@ -578,16 +687,38 @@ function mergePositionSession(
   return { ...current, ...next, nodes: current.nodes };
 }
 
-function parseIntentSummary(snapshot: Record<string, unknown> | null | undefined): IntentSummary | null {
-  if (!snapshot || typeof snapshot.objective !== "string" || !Array.isArray(snapshot.constraints)) {
+function intentStringList(snapshot: Record<string, unknown>, key: string): string[] {
+  const value = snapshot[key];
+  return Array.isArray(value)
+    ? value.filter((item): item is string => typeof item === "string" && Boolean(item.trim()))
+    : [];
+}
+
+function parsePositionIntentSummary(
+  snapshot: Record<string, unknown> | null | undefined,
+): PositionIntentSummary | null {
+  if (!snapshot) return null;
+  const positionKeys = ["coreGoals", "riskWarnings", "keyPoints", "strategicSignificance"];
+  if (positionKeys.some((key) => key in snapshot)) {
+    if (!positionKeys.every((key) => Array.isArray(snapshot[key]))) return null;
+    return {
+      coreGoals: intentStringList(snapshot, "coreGoals"),
+      riskWarnings: intentStringList(snapshot, "riskWarnings"),
+      keyPoints: intentStringList(snapshot, "keyPoints"),
+      strategicSignificance: intentStringList(snapshot, "strategicSignificance"),
+    };
+  }
+
+  // Existing sessions created before the dedicated position agent used the
+  // shared Step-1 schema. Keep them readable and editable after the switch.
+  if (typeof snapshot.objective !== "string" || !Array.isArray(snapshot.constraints)) {
     return null;
   }
   return {
-    objective: snapshot.objective,
-    constraints: snapshot.constraints.filter((item): item is string => typeof item === "string"),
-    assumptions: Array.isArray(snapshot.assumptions)
-      ? snapshot.assumptions.filter((item): item is string => typeof item === "string")
-      : undefined,
+    coreGoals: intentStringList(snapshot, "constraints"),
+    riskWarnings: [],
+    keyPoints: intentStringList(snapshot, "assumptions"),
+    strategicSignificance: snapshot.objective.trim() ? [snapshot.objective.trim()] : [],
   };
 }
 
@@ -596,21 +727,24 @@ function restoreIntentMessages(
 ): InteractiveMessage[] {
   const restored: InteractiveMessage[] = [];
   for (const [index, message] of (messages ?? []).entries()) {
-    const raw = message as typeof message & {
+    const raw = message as unknown as {
       additional_kwargs?: Record<string, unknown>;
+      _type?: string;
+      role?: string;
       type?: string;
     };
     const additional = raw.additional_kwargs ?? {};
     // 任务快照与工具回执仅用于模型上下文，不能成为用户可见的聊天记录。
     if (additional.hide_from_ui === true || additional.task_external_context === true) continue;
-    const messageType = raw.type?.toLowerCase();
-    if (messageType !== "human" && messageType !== "ai") continue;
+    const messageType = (raw.type ?? raw.role ?? raw._type)?.toLowerCase();
+    if (messageType !== "human" && messageType !== "user" && messageType !== "ai" && messageType !== "assistant") continue;
     const content = (textOfMessage(message) ?? "").trim();
     if (!content) continue;
+    const isUser = messageType === "human" || messageType === "user";
     restored.push({
       id: index + 1,
-      sender: messageType === "human" ? "user" : "agent",
-      senderName: messageType === "human" ? "用户" : "任务理解智能体",
+      sender: isUser ? "user" : "agent",
+      senderName: isUser ? "用户" : "任务理解智能体",
       content,
       time: "已恢复",
     });
@@ -624,13 +758,33 @@ function persistedIntentMessages(
   if (!Array.isArray(snapshot?.messages)) return [];
   return snapshot.messages.flatMap((raw, index) => {
     if (!raw || typeof raw !== "object") return [];
-    const sender = raw.sender === "user" ? "user" : raw.sender === "agent" ? "agent" : null;
-    const content = typeof raw.content === "string" ? raw.content : "";
+    const value = raw as Record<string, unknown>;
+    const senderValue =
+      typeof value.sender === "string"
+        ? value.sender.toLowerCase()
+        : typeof value.role === "string"
+          ? value.role.toLowerCase()
+          : typeof value.type === "string"
+            ? value.type.toLowerCase()
+            : typeof value._type === "string"
+              ? value._type.toLowerCase()
+              : "";
+    const sender =
+      senderValue === "user" || senderValue === "human"
+        ? "user"
+        : senderValue === "agent" || senderValue === "assistant" || senderValue === "ai"
+          ? "agent"
+          : null;
+    const content = typeof value.content === "string"
+      ? value.content
+      : typeof value.text === "string"
+        ? value.text
+        : "";
     if (!sender || !content.trim()) return [];
     return [
       {
         ...(raw as unknown as InteractiveMessage),
-        id: typeof raw.id === "number" ? raw.id : index + 1,
+        id: typeof value.id === "number" ? value.id : index + 1,
         sender,
         content,
       },
@@ -715,18 +869,21 @@ export default function PositionRoundtablePage({
   const [positionId, setPositionId] = useState<PositionId>(() => positionIdFromUrl);
   const demoModeEnabled = isPositionRoundtableDemoEnabled();
   const demoTask = useMemo(() => getPositionDemoTask(), []);
-  const taskIdFromUrl =
+  // A route taskId opts into shared task collaboration. Without it this page
+  // keeps the original personal-session behavior and uses mock data only for
+  // display defaults.
+  const taskScopeId =
     standaloneDemoMode
       ? demoTask.id
-      : searchParams.get("taskId") ??
-        (demoModeEnabled ? demoTask.id : DEFAULT_MOCK_POSITION_TASK_ID);
+      : searchParams.get("taskId")?.trim() || null;
+  const displayTaskId = taskScopeId ?? (demoModeEnabled ? demoTask.id : DEFAULT_MOCK_POSITION_TASK_ID);
   const searchParamsString = searchParams.toString();
   const fallbackTask = useMemo(
     () =>
-      demoModeEnabled && taskIdFromUrl === demoTask.id
+      demoModeEnabled && displayTaskId === demoTask.id
         ? demoTask
-        : getMockPositionTask(taskIdFromUrl),
-    [demoModeEnabled, demoTask, taskIdFromUrl],
+        : getMockPositionTask(displayTaskId),
+    [demoModeEnabled, demoTask, displayTaskId],
   );
   const rawSessionIdFromUrl = searchParams.get("sessionId");
   const sessionIdFromUrl =
@@ -786,7 +943,7 @@ export default function PositionRoundtablePage({
   const [sessionLoading, setSessionLoading] = useState(false);
   const [sessionDiscoveryDone, setSessionDiscoveryDone] = useState(Boolean(sessionIdFromUrl));
   const [startingChain, setStartingChain] = useState(false);
-  const [rightPanelOpen, setRightPanelOpen] = useState(true);
+  const [rightPanelOpen, setRightPanelOpen] = useState(false);
   const [rightTab, setRightTab] = useState<WorkspaceTab>(() =>
     standaloneDemoMode ? "results" : "agents",
   );
@@ -804,6 +961,10 @@ export default function PositionRoundtablePage({
   // click bubbling. Mark a delete pointer gesture so the item-level selection
   // can explicitly cancel navigation to the row being deleted.
   const suppressHistorySelectIdRef = useRef<string | null>(null);
+  // Switching history should start with the right workspace collapsed. Keep
+  // this marker through session hydration so the delivery-overview effect does
+  // not immediately reopen it for a completed historical session.
+  const suppressRightPanelAutoOpenForSessionRef = useRef<string | null>(null);
   const [intentInputDraft, setIntentInputDraft] = useState("");
   const localDemoFallback =
     standaloneDemoMode || isLocalPositionDemoSession(positionSession?.id);
@@ -828,19 +989,21 @@ export default function PositionRoundtablePage({
   const [sandboxArtifact, setSandboxArtifact] = useState<PositionArtifactPreview | null>(null);
   const sandboxArtifactRef = useRef<PositionArtifactPreview | null>(null);
   const closedSandboxKeyRef = useRef<string | null>(null);
-  const [sandboxThreadSnapshot, setSandboxThreadSnapshot] = useState<SandboxThreadSnapshot | null>(null);
+  const sandboxThreadStore = useMemo(createSandboxThreadStore, []);
   const latestNodeThreadSnapshotRef = useRef<SandboxThreadSnapshot | null>(null);
   const pendingSandboxThreadSnapshotRef = useRef<SandboxThreadSnapshot | null>(null);
   const sandboxSnapshotTimerRef = useRef<number | null>(null);
+  const sandboxSnapshotAppliedAtRef = useRef(0);
   const [flowDetailItem, setFlowDetailItem] = useState<ResultItem | null>(null);
   const [taskEditorOpen, setTaskEditorOpen] = useState(false);
   const [taskDraft, setTaskDraft] = useState<PositionTask>(fallbackTask);
   const [taskSaving, setTaskSaving] = useState(false);
   const [intentEditorOpen, setIntentEditorOpen] = useState(false);
   const [intentDraft, setIntentDraft] = useState<IntentEditDraft>({
-    objective: "",
-    constraints: "",
-    assumptions: "",
+    coreGoals: "",
+    riskWarnings: "",
+    keyPoints: "",
+    strategicSignificance: "",
   });
   const [intentSaving, setIntentSaving] = useState(false);
   const [intentCompletedAt, setIntentCompletedAt] = useState("");
@@ -864,7 +1027,10 @@ export default function PositionRoundtablePage({
     sandboxArtifactRef.current = sandboxArtifact;
   }, [sandboxArtifact]);
   const flushSandboxThreadSnapshot = useCallback(() => {
-    sandboxSnapshotTimerRef.current = null;
+    if (sandboxSnapshotTimerRef.current !== null) {
+      window.clearTimeout(sandboxSnapshotTimerRef.current);
+      sandboxSnapshotTimerRef.current = null;
+    }
     const pending = pendingSandboxThreadSnapshotRef.current;
     pendingSandboxThreadSnapshotRef.current = null;
     if (!pending) return;
@@ -872,21 +1038,28 @@ export default function PositionRoundtablePage({
     if (!currentArtifact || currentArtifact.threadId !== pending.threadId) {
       return;
     }
-    setSandboxThreadSnapshot((current) =>
-      current?.threadId === pending.threadId && current.signature === pending.signature
-        ? current
-        : pending,
-    );
-  }, []);
+    sandboxSnapshotAppliedAtRef.current = Date.now();
+    sandboxThreadStore.publish(pending);
+  }, [sandboxThreadStore]);
   const queueSandboxThreadSnapshot = useCallback(
     (snapshot: SandboxThreadSnapshot) => {
       pendingSandboxThreadSnapshotRef.current = snapshot;
-      if (sandboxSnapshotTimerRef.current !== null) return;
-      if (typeof window === "undefined") {
+      // Leading-edge throttle: publish straight away whenever the previous
+      // publish is old enough. Trailing timers alone are not dependable here —
+      // a continuous stream keeps the main thread busy and the panel then stays
+      // frozen on the content it had when it opened.
+      const sinceApplied = Date.now() - sandboxSnapshotAppliedAtRef.current;
+      if (typeof window === "undefined" || sinceApplied >= SANDBOX_SNAPSHOT_MIN_INTERVAL_MS) {
         flushSandboxThreadSnapshot();
         return;
       }
-      sandboxSnapshotTimerRef.current = window.setTimeout(flushSandboxThreadSnapshot, 160);
+      // Still inside the quiet window: make sure the last chunk of a stream that
+      // stops right now is not left unpublished.
+      if (sandboxSnapshotTimerRef.current !== null) return;
+      sandboxSnapshotTimerRef.current = window.setTimeout(
+        flushSandboxThreadSnapshot,
+        SANDBOX_SNAPSHOT_MIN_INTERVAL_MS - sinceApplied,
+      );
     },
     [flushSandboxThreadSnapshot],
   );
@@ -894,17 +1067,18 @@ export default function PositionRoundtablePage({
     () => () => {
       if (sandboxSnapshotTimerRef.current !== null) {
         window.clearTimeout(sandboxSnapshotTimerRef.current);
+        sandboxSnapshotTimerRef.current = null;
       }
     },
     [],
   );
   const frozenIntent = useMemo(
-    () => parseIntentSummary(positionSession?.intentSnapshot),
+    () => parsePositionIntentSummary(positionSession?.intentSnapshot),
     [positionSession?.intentSnapshot],
   );
   const task = useMemo(
-    () => taskFromPositionSnapshot(positionSession?.taskSnapshot, fallbackTask),
-    [fallbackTask, positionSession?.taskSnapshot],
+    () => taskFromPositionSnapshot(positionSession?.taskSnapshot, fallbackTask, taskScopeId ?? undefined),
+    [fallbackTask, positionSession?.taskSnapshot, taskScopeId],
   );
   const intentTaskContext = useMemo(
     () => ({
@@ -960,11 +1134,29 @@ export default function PositionRoundtablePage({
         ? 1
         : 0,
     selectedModel,
+    intentAgentId: POSITION_INTENT_AGENT_ID,
     taskContext: intentTaskContext,
     initialWelcomeText:
       "我已读取左侧任务信息。你可以直接补充本次任务的特殊约束；如果没有补充，我会基于现有任务信息进行意图识别。",
+    showInitialWelcome: false,
     triggerToast,
   });
+  const livePositionIntent = useMemo(
+    () =>
+      parsePositionIntentSummary(
+        intent.intentReady as unknown as Record<string, unknown> | null,
+      ),
+    [intent.intentReady],
+  );
+  const positionIntent = frozenIntent ?? livePositionIntent;
+  const positionIntentHeadline =
+    positionIntent?.strategicSignificance[0] ?? positionIntent?.coreGoals[0];
+  // `useStep1Intent` starts with an empty list for a new intent session. Keep
+  // the complete list here so a restored historical session can display its
+  // first agent turn as well as the user's follow-up turns. The old
+  // first-user filter made histories that only contained an agent response
+  // look like a brand-new empty conversation.
+  const visibleIntentMessages = intent.interactiveMessages;
   const hydratedIntentSessionRef = useRef<string | null>(null);
   const restoringIntentSessionRef = useRef<string | null>(null);
   const persistedIntentRef = useRef<string | null>(null);
@@ -1007,9 +1199,10 @@ export default function PositionRoundtablePage({
     positionSession?.status === "archived";
 
   const syncSessionUrl = useCallback(
-    (sessionId: string, nextTaskId: string) => {
+    (sessionId: string, nextTaskId?: string | null) => {
       const next = new URLSearchParams(searchParamsString);
-      next.set("taskId", nextTaskId);
+      if (nextTaskId) next.set("taskId", nextTaskId);
+      else next.delete("taskId");
       next.set("sessionId", sessionId);
       next.delete("new");
       setSearchParams(next, { replace: true });
@@ -1025,20 +1218,20 @@ export default function PositionRoundtablePage({
         const localSession = getLocalPositionDemoSession();
         positionSessionRef.current = localSession;
         setPositionSession(localSession);
-        syncSessionUrl(localSession.id, localSession.externalTaskId ?? taskSnapshot.id);
+        syncSessionUrl(localSession.id, taskScopeId);
         return localSession;
       }
       if (sessionCreationRef.current) return sessionCreationRef.current;
       const creation = createPositionSession({
-        externalTaskId: taskSnapshot.id || undefined,
-        taskSnapshot: { ...taskSnapshot },
+        externalTaskId: taskScopeId ?? undefined,
+        taskSnapshot: taskScopeId ? { ...taskSnapshot, id: taskScopeId } : { ...taskSnapshot },
       })
         .then((created) => {
           // Update the ref synchronously. Several effects can observe a new
           // intent thread in the same render cycle; all must share this row.
           positionSessionRef.current = created;
           setPositionSession(created);
-          syncSessionUrl(created.id, taskSnapshot.id);
+          syncSessionUrl(created.id, taskScopeId);
           return created;
         })
         .finally(() => {
@@ -1049,7 +1242,7 @@ export default function PositionRoundtablePage({
       sessionCreationRef.current = creation;
       return creation;
     },
-    [standaloneDemoMode, syncSessionUrl],
+    [standaloneDemoMode, syncSessionUrl, taskScopeId],
   );
 
   const openTaskEditor = useCallback(() => {
@@ -1070,7 +1263,12 @@ export default function PositionRoundtablePage({
     }
     const nextTask: PositionTask = {
       ...task,
+      // Task identity comes exclusively from the route. Task-card editing can
+      // change display fields but must never move this session to another
+      // shared task bucket.
+      id: taskScopeId ?? task.id,
       title,
+      priority: taskDraft.priority?.trim() || task.priority || "紧急",
       description: taskDraft.description.trim(),
       direction: taskDraft.direction.trim() || task.direction,
       source: taskDraft.source.trim() || task.source,
@@ -1087,7 +1285,7 @@ export default function PositionRoundtablePage({
         positionSessionRef.current = merged;
         return merged;
       });
-      syncSessionUrl(saved.id, nextTask.id);
+      syncSessionUrl(saved.id, taskScopeId);
       setTaskEditorOpen(false);
       toast.success("任务信息已更新");
     } catch (error) {
@@ -1095,27 +1293,35 @@ export default function PositionRoundtablePage({
     } finally {
       setTaskSaving(false);
     }
-  }, [ensureEditableSession, isArchivedSession, syncSessionUrl, task, taskDraft]);
+  }, [ensureEditableSession, isArchivedSession, syncSessionUrl, task, taskDraft, taskScopeId]);
 
   const openIntentEditor = useCallback(() => {
     if (isArchivedSession) return;
-    const currentIntent = frozenIntent ?? intent.intentReady;
+    const currentIntent = positionIntent;
     setIntentDraft({
-      objective: currentIntent?.objective ?? "",
-      constraints: (currentIntent?.constraints ?? []).join("\n"),
-      assumptions: (currentIntent?.assumptions ?? []).join("\n"),
+      coreGoals: (currentIntent?.coreGoals ?? []).join("\n"),
+      riskWarnings: (currentIntent?.riskWarnings ?? []).join("\n"),
+      keyPoints: (currentIntent?.keyPoints ?? []).join("\n"),
+      strategicSignificance: (currentIntent?.strategicSignificance ?? []).join("\n"),
     });
     setIntentEditorOpen(true);
-  }, [frozenIntent, intent.intentReady, isArchivedSession]);
+  }, [isArchivedSession, positionIntent]);
 
   const handleSaveIntentEdit = useCallback(async () => {
     if (isArchivedSession) {
       toast.warning("已归档的会话不能编辑意图理解");
       return;
     }
-    const objective = intentDraft.objective.trim();
-    if (!objective) {
-      toast.warning("请填写任务意图");
+    const coreGoals = intentDraft.coreGoals
+      .split(/\r?\n/)
+      .map((item) => item.trim())
+      .filter(Boolean);
+    const strategicSignificance = intentDraft.strategicSignificance
+      .split(/\r?\n/)
+      .map((item) => item.trim())
+      .filter(Boolean);
+    if (coreGoals.length === 0 && strategicSignificance.length === 0) {
+      toast.warning("请至少填写核心目标或战略意义");
       return;
     }
     const splitLines = (value: string) =>
@@ -1123,10 +1329,11 @@ export default function PositionRoundtablePage({
         .split(/\r?\n/)
         .map((item) => item.trim())
         .filter(Boolean);
-    const nextIntent: IntentSummary = {
-      objective,
-      constraints: splitLines(intentDraft.constraints),
-      assumptions: splitLines(intentDraft.assumptions),
+    const nextIntent: PositionIntentSummary = {
+      coreGoals,
+      riskWarnings: splitLines(intentDraft.riskWarnings),
+      keyPoints: splitLines(intentDraft.keyPoints),
+      strategicSignificance,
     };
 
     setIntentSaving(true);
@@ -1150,7 +1357,7 @@ export default function PositionRoundtablePage({
       });
       intent.hydrateFromDraft({
         intentThreadId: intentThreadId ?? intent.intentThreadId,
-        intentReady: nextIntent,
+        intentReady: nextIntent as unknown as IntentSummary,
         interactiveMessages: intent.interactiveMessages,
         timelineEntries: [],
       });
@@ -1166,15 +1373,16 @@ export default function PositionRoundtablePage({
     ensureEditableSession,
     intent,
     intentCompletedAt,
-    intentDraft.assumptions,
-    intentDraft.constraints,
-    intentDraft.objective,
+    intentDraft.coreGoals,
+    intentDraft.keyPoints,
+    intentDraft.riskWarnings,
+    intentDraft.strategicSignificance,
     intentInputDraft,
     isArchivedSession,
     task,
   ]);
 
-  const { data: chains = [], isLoading: chainsLoading } = useQuery({
+  const { data: chains = [], isLoading: chainsLoading, refetch: refetchChains } = useQuery({
     queryKey: ["position-roundtable", "chains"],
     queryFn: async () => {
       const [mine, published] = await Promise.all([
@@ -1185,8 +1393,26 @@ export default function PositionRoundtablePage({
     },
     enabled: !standaloneDemoMode,
     staleTime: 30_000,
+    refetchOnMount: "always",
   });
   const [selectedChainId, setSelectedChainId] = useState("");
+  const handleDeleteChain = useCallback(
+    async (chain: BusinessChain) => {
+      const title = desensitize(chain.title || "未命名作业链条");
+      if (!window.confirm(`确认删除作业链条“${title}”吗？`)) return;
+      try {
+        await deleteChain(chain.id);
+        const refreshed = await refetchChains();
+        if (selectedChainId === chain.id) {
+          setSelectedChainId(refreshed.data?.[0]?.id ?? "");
+        }
+        toast.success(`已删除作业链条「${title}」`);
+      } catch (error) {
+        toast.error(`删除失败：${error instanceof Error ? error.message : String(error)}`);
+      }
+    },
+    [refetchChains, selectedChainId],
+  );
   useEffect(() => {
     if (!selectedChainId && chains[0]) setSelectedChainId(chains[0].id);
   }, [chains, selectedChainId]);
@@ -1203,18 +1429,44 @@ export default function PositionRoundtablePage({
     }
     return selectedChain;
   }, [positionSession?.chainSnapshot, positionSession?.status, selectedChain]);
+  // The intent position always uses the same built-in agent as the
+  // multi-agent roundtable Step 1 flow.  Do not derive this from a chain seat:
+  // older chains may have no seat agent id (or a removed legacy id), which
+  // would make the configuration panel request a non-existent agent.
+  const intentAgentId = POSITION_INTENT_AGENT_ID;
   const isIntelligenceDeliveryOverview =
     activePosition.isIntentPosition && positionSession !== null && positionSession.status !== "intent_pending";
+  const showIntentDeliveryOverview =
+    isIntelligenceDeliveryOverview ||
+    (!activePosition.isIntentPosition && positionSession !== null);
   const previousIntelligenceDeliveryOverviewRef = useRef(isIntelligenceDeliveryOverview);
   useEffect(() => {
-    // Sending the last intent answer transitions the page into the delivery
-    // overview. Restore the right workspace at that moment instead of leaving
-    // the user on an unexpectedly full-width, empty-looking conversation area.
+    // The activation boundary is the only automatic open for the testing
+    // analysis workspace. Once the business chain starts, open the result
+    // list; a pending (new / unstarted) intent session remains closed by
+    // default. History selection installs the suppression marker below so it
+    // always wins over this transition.
     if (isIntelligenceDeliveryOverview && !previousIntelligenceDeliveryOverviewRef.current) {
-      setRightPanelOpen(true);
+      if (suppressRightPanelAutoOpenForSessionRef.current === positionSession?.id) {
+        suppressRightPanelAutoOpenForSessionRef.current = null;
+      } else {
+        setRightTab("results");
+        setRightPanelOpen(true);
+      }
     }
     previousIntelligenceDeliveryOverviewRef.current = isIntelligenceDeliveryOverview;
-  }, [isIntelligenceDeliveryOverview]);
+  }, [isIntelligenceDeliveryOverview, positionSession?.id]);
+  useEffect(() => {
+    // A pending historical session never enters the overview on hydration;
+    // release the one-shot suppression so a later, new completion can still
+    // open the workspace normally.
+    if (
+      positionSession?.status === "intent_pending" &&
+      suppressRightPanelAutoOpenForSessionRef.current === positionSession.id
+    ) {
+      suppressRightPanelAutoOpenForSessionRef.current = null;
+    }
+  }, [positionSession?.id, positionSession?.status]);
   const leftSidebarHidden = leftPanelCollapsed;
   const allPositionDeliveriesDone = useMemo(
     () => allExecutableNodesDone(positionSession?.nodes ?? []),
@@ -1342,7 +1594,7 @@ export default function PositionRoundtablePage({
     let cancelled = false;
     void getPositionSession(sessionIdFromUrl)
       .then((session) => {
-        if (!cancelled) {
+        if (!cancelled && isSessionInTaskScope(session, taskScopeId)) {
           positionSessionRef.current = session;
           setPositionSession(session);
         }
@@ -1351,7 +1603,7 @@ export default function PositionRoundtablePage({
     return () => {
       cancelled = true;
     };
-  }, [positionSession, sessionIdFromUrl]);
+  }, [positionSession, sessionIdFromUrl, taskScopeId]);
   const handleNodeUpdate = useCallback((updatedNode: PositionRoundtableNode) => {
     setPositionSession((current) => {
       if (!current?.nodes) return current;
@@ -1417,7 +1669,11 @@ export default function PositionRoundtablePage({
         view.timelineEntries,
         view.inputDraft,
       );
-      const intentSnapshot = view.intentReady ? { ...view.intentReady } : null;
+      // 岗位会商持久化的是专属四段式结果；useStep1Intent 为兼容普通会商
+      // 补出的 objective / constraints / assumptions 不应写回岗位会商快照。
+      const intentSnapshot = parsePositionIntentSummary(
+        view.intentReady as unknown as Record<string, unknown> | null,
+      );
 
       const operation = async () => {
         const baseSession = candidateSession ?? (await ensureEditableSession(task));
@@ -1569,20 +1825,12 @@ export default function PositionRoundtablePage({
         candidates.sort((left, right) => right.length - left.length)[0] ?? [];
       hydrateIntentFromDraft({
         intentThreadId: intentThreadId ?? latest.intentThreadId,
-        intentReady: latestFrozenIntentRef.current ?? latest.intentReady,
+        intentReady:
+          (latestFrozenIntentRef.current as unknown as IntentSummary | null) ?? latest.intentReady,
         interactiveMessages:
           interactiveMessages.length > 0
             ? interactiveMessages
-            : [
-                {
-                  id: 1,
-                  sender: "agent",
-                  senderName: "任务理解智能体",
-                  content:
-                    "我已读取左侧任务信息。你可以直接补充本次任务的特殊约束；如果没有补充，我会基于现有任务信息进行意图识别。",
-                  time: "已恢复",
-                },
-              ],
+            : [],
         timelineEntries:
           isAlreadyBound && latest.timelineEntries.length > databaseTimeline.length
             ? latest.timelineEntries
@@ -1602,19 +1850,11 @@ export default function PositionRoundtablePage({
             ? databaseMessages
             : latest.interactiveMessages.length > 0
               ? latest.interactiveMessages
-              : [
-                  {
-                    id: 1,
-                    sender: "agent",
-                    senderName: "任务理解智能体",
-                    content:
-                      "我已读取左侧任务信息。你可以直接补充本次任务的特殊约束；如果没有补充，我会基于现有任务信息进行意图识别。",
-                    time: "已恢复",
-                  },
-                ];
+              : [];
         hydrateIntentFromDraft({
           intentThreadId: intentThreadId ?? latest.intentThreadId,
-          intentReady: latestFrozenIntentRef.current ?? latest.intentReady,
+          intentReady:
+            (latestFrozenIntentRef.current as unknown as IntentSummary | null) ?? latest.intentReady,
           interactiveMessages: fallbackMessages,
           timelineEntries: databaseTimeline,
         });
@@ -1648,15 +1888,17 @@ export default function PositionRoundtablePage({
   );
   const openPositionConfig = useCallback(
     (chainId: string) => {
-      const taskQuery = `taskId=${encodeURIComponent(task.id)}${forceNewSession ? "&new=1" : ""}`;
-      const returnTo = sessionIdFromUrl
-        ? `/page/strategy/qa/position-roundtable?${taskQuery}&sessionId=${encodeURIComponent(sessionIdFromUrl)}`
-        : `/page/strategy/qa/position-roundtable?${taskQuery}`;
+      const returnParams = new URLSearchParams();
+      if (taskScopeId) returnParams.set("taskId", taskScopeId);
+      if (forceNewSession) returnParams.set("new", "1");
+      if (sessionIdFromUrl) returnParams.set("sessionId", sessionIdFromUrl);
+      const returnQuery = returnParams.toString();
+      const returnTo = `/page/strategy/qa/position-roundtable${returnQuery ? `?${returnQuery}` : ""}`;
       navigate(
         `/page/workspace/roundtable/chains?chainId=${encodeURIComponent(chainId)}&mode=position&returnTo=${encodeURIComponent(returnTo)}`,
       );
     },
-    [forceNewSession, navigate, sessionIdFromUrl, task.id],
+    [forceNewSession, navigate, sessionIdFromUrl, taskScopeId],
   );
 
   // The mock task source mirrors the future external-task contract: opening a
@@ -1679,7 +1921,7 @@ export default function PositionRoundtablePage({
     const useDemoFixture = demoModeEnabled && task.id === demoTask.id;
     const discovery = useDemoFixture
       ? initializePositionRoundtableDemo().then((session) => [session])
-      : listPositionSessions(task.id);
+      : listPositionSessions(taskScopeId ?? undefined);
     void discovery
       .then((sessions) => {
         if (cancelled) return;
@@ -1697,7 +1939,8 @@ export default function PositionRoundtablePage({
           setSessionDiscoveryDone(true);
         }
         const next = new URLSearchParams(searchParamsString);
-        next.set("taskId", task.id);
+        if (taskScopeId) next.set("taskId", taskScopeId);
+        else next.delete("taskId");
         next.set("sessionId", latest.id);
         setSearchParams(next, { replace: true });
       })
@@ -1717,7 +1960,7 @@ export default function PositionRoundtablePage({
     searchParamsString,
     sessionIdFromUrl,
     setSearchParams,
-    task.id,
+    taskScopeId,
   ]);
 
   // Create the database row as soon as discovery confirms this is a new task
@@ -1764,6 +2007,11 @@ export default function PositionRoundtablePage({
       : getPositionSession(sessionIdFromUrl);
     void request
       .then((session) => {
+        if (!isSessionInTaskScope(session, taskScopeId)) {
+          // A shared session id can be pasted with the wrong taskId. Treat it
+          // as stale navigation instead of allowing it to cross task scopes.
+          throw new PositionSessionNotFoundError(sessionIdFromUrl);
+        }
         if (
           !cancelled &&
           !ignoredSessionLoadIdsRef.current.has(sessionIdFromUrl)
@@ -1802,11 +2050,31 @@ export default function PositionRoundtablePage({
     return () => {
       cancelled = true;
     };
-  }, [searchParamsString, sessionIdFromUrl, setSearchParams]);
+  }, [searchParamsString, sessionIdFromUrl, setSearchParams, taskScopeId]);
 
-  const { agent: selectedAgent } = useAgent(selectedAgentId, {
+  const agentIdForPanel = activePosition.isIntentPosition ? POSITION_INTENT_AGENT_ID : selectedAgentId;
+  const { agent: selectedAgent } = useAgent(agentIdForPanel, {
     enabled: !standaloneDemoMode,
   });
+  const selectedAgentForPanel = useMemo<Agent | null>(() => {
+    if (selectedAgent) return selectedAgent;
+    // The intent position has one dedicated agent configuration surface. Keep
+    // it directly reachable even while its agent query is still resolving or
+    // a local fixture does not expose the catalog API.
+    if (!activePosition.isIntentPosition) return null;
+    const seat = activeChain?.seats.find((item) => item.position_id === intentPositionId);
+    return {
+      id: POSITION_INTENT_AGENT_ID,
+      name: seat?.name || `${activePosition.name}智能体`,
+      description: seat?.description || activePosition.description,
+      user_id: null,
+      published: true,
+      is_private: false,
+      builtin: true,
+      skills: [],
+      common_questions: [],
+    };
+  }, [activeChain?.seats, activePosition, intentPositionId, selectedAgent]);
   useEffect(() => {
     if (intent.intentReady && !intentCompletedAt) setIntentCompletedAt(timeLabel());
     if (!intent.intentReady && intentCompletedAt) setIntentCompletedAt("");
@@ -1859,7 +2127,7 @@ export default function PositionRoundtablePage({
       let session = await ensureEditableSession(task);
       session = await savePositionIntent(session.id, {
         intentThreadId: intent.intentThreadId,
-        intentSnapshot: intent.intentReady,
+        intentSnapshot: positionIntent,
         conversationSnapshot: buildIntentConversationSnapshot(
           intent.interactiveMessages,
           intent.timelineEntries,
@@ -1869,8 +2137,16 @@ export default function PositionRoundtablePage({
       session = await activatePositionSession(session.id, selectedChain.id);
       positionSessionRef.current = session;
       setPositionSession(session);
+      // The activation action originates from the testing-analysis position.
+      // Switch the just-opened sidebar straight to results so users see the
+      // chain delivery list rather than the agent configuration by default.
+      if (positionId === intentPositionId) {
+        setRightTab("results");
+        setRightPanelOpen(true);
+      }
       const next = new URLSearchParams(searchParams);
-      next.set("taskId", task.id);
+      if (taskScopeId) next.set("taskId", taskScopeId);
+      else next.delete("taskId");
       next.set("sessionId", session.id);
       next.delete("new");
       setSearchParams(next, { replace: true });
@@ -1892,6 +2168,9 @@ export default function PositionRoundtablePage({
     setSearchParams,
     startingChain,
     task,
+    taskScopeId,
+    intentPositionId,
+    positionId,
   ]);
 
   const handleCreateNewSession = useCallback(async () => {
@@ -1907,7 +2186,7 @@ export default function PositionRoundtablePage({
     }
     closedSandboxKeyRef.current = null;
     setSandboxArtifact(null);
-    setSandboxThreadSnapshot(null);
+    sandboxThreadStore.publish(null);
     intent.resetIntent();
     hydratedIntentSessionRef.current = null;
     restoringIntentSessionRef.current = null;
@@ -1916,17 +2195,28 @@ export default function PositionRoundtablePage({
     setPositionSession(null);
     setIntentInputDraft("");
     setSessionDiscoveryDone(true);
+    // A new task always starts from the testing-analysis intent stage. Reset
+    // the right workspace explicitly rather than relying on the asynchronous
+    // URL/session effects, which avoids a previous active session reopening
+    // the results sidebar for a moment.
+    suppressRightPanelAutoOpenForSessionRef.current = null;
+    setPositionId(intentPositionId);
+    setRightTab("agents");
+    setRightPanelOpen(false);
+    setLeftPanelCollapsed(false);
     setSelectedAgentId(null);
     setActiveNodeKey(null);
     setActiveBuiltinKind(null);
     setBuiltinAutoStartRequestKey(0);
     setIntentCompletedAt("");
     const next = new URLSearchParams(searchParams);
-    next.set("taskId", task.id);
+    if (taskScopeId) next.set("taskId", taskScopeId);
+    else next.delete("taskId");
+    next.set("positionId", intentPositionId);
     next.delete("sessionId");
     next.set("new", "1");
     setSearchParams(next);
-  }, [intent, queueIntentConversationSave, searchParams, setSearchParams, task.id]);
+  }, [intent, intentPositionId, queueIntentConversationSave, searchParams, setSearchParams, taskScopeId]);
 
   const loadHistorySessions = useCallback(() => {
     if (isLocalPositionDemoSession(positionSessionRef.current?.id)) {
@@ -1935,7 +2225,7 @@ export default function PositionRoundtablePage({
       return;
     }
     setHistoryLoading(true);
-    void listPositionSessions(task.id)
+    void listPositionSessions(taskScopeId ?? undefined)
       .then((sessions) => {
         setHistorySessions(
           [...sessions].sort((left, right) => {
@@ -1951,7 +2241,7 @@ export default function PositionRoundtablePage({
       .finally(() => {
         setHistoryLoading(false);
       });
-  }, [task.id]);
+  }, [taskScopeId]);
 
   const handleHistoryMenuOpenChange = useCallback(
     (open: boolean) => {
@@ -1970,6 +2260,8 @@ export default function PositionRoundtablePage({
       ) {
         return;
       }
+      suppressRightPanelAutoOpenForSessionRef.current = sessionId;
+      setRightPanelOpen(false);
       try {
         await queueIntentConversationSave();
       } catch {
@@ -1983,7 +2275,7 @@ export default function PositionRoundtablePage({
       // 会话的窗口期仍接收旧 thread 增量；hydrate 入口还会再做一次兜底清理。
       intent.stopIntentStream();
       setSandboxArtifact(null);
-      setSandboxThreadSnapshot(null);
+      sandboxThreadStore.publish(null);
       setActiveNodeKey(null);
       setActiveBuiltinKind(null);
       setSelectedAgentId(null);
@@ -1993,7 +2285,8 @@ export default function PositionRoundtablePage({
       restoringIntentSessionRef.current = null;
       persistedIntentRef.current = null;
       const next = new URLSearchParams(searchParams);
-      next.set("taskId", task.id);
+      if (taskScopeId) next.set("taskId", taskScopeId);
+      else next.delete("taskId");
       next.set("sessionId", sessionId);
       next.delete("new");
       setSearchParams(next);
@@ -2004,7 +2297,7 @@ export default function PositionRoundtablePage({
       searchParams,
       sessionIdFromUrl,
       setSearchParams,
-      task.id,
+      taskScopeId,
     ],
   );
 
@@ -2064,7 +2357,8 @@ export default function PositionRoundtablePage({
           setSelectedAgentId(null);
           setHistoryMenuOpen(false);
           const next = new URLSearchParams(searchParams);
-          next.set("taskId", task.id);
+          if (taskScopeId) next.set("taskId", taskScopeId);
+          else next.delete("taskId");
           if (nextSession) {
             // Prefer the most recently active remaining conversation so the
             // user stays in history instead of being dropped onto a blank page.
@@ -2094,7 +2388,7 @@ export default function PositionRoundtablePage({
       sessionIdFromUrl,
       setSearchParams,
       standaloneDemoMode,
-      task.id,
+      taskScopeId,
     ],
   );
 
@@ -2106,7 +2400,7 @@ export default function PositionRoundtablePage({
       return;
     }
 
-    const artifactKey = sandboxCloseKey(artifact);
+      const artifactKey = sandboxCloseKey(artifact);
     if (artifact.auto) {
       // Closing an old file should only suppress that exact preview. A later
       // write_file in the same thread is a new deliverable and must still be
@@ -2117,22 +2411,47 @@ export default function PositionRoundtablePage({
     }
     closedSandboxKeyRef.current = null;
 
-    setSandboxArtifact((current) => {
-      const isSamePreview =
-        current?.threadId === artifact.threadId &&
-        current.path === artifact.path &&
-        current.previewKey === artifact.previewKey;
-      return isSamePreview ? current : artifact;
-    });
-    setSandboxThreadSnapshot((current) =>
-      current?.threadId === artifact.threadId ? current : null,
-    );
+    // Follow the same lifecycle as the regular conversation view. The
+    // position workspace owns a custom visual container, but the artifact
+    // selection/open state must still advance at tool-start so its preview is
+    // not deferred until the final artifact list is written.
+    const ctx = artifactsCtxRef.current;
+    ctx?.select(artifact.path, true);
+    ctx?.setOpen(true);
+
+    const openedArtifact = sandboxArtifactRef.current;
+    const isSamePreview =
+      openedArtifact?.threadId === artifact.threadId &&
+      openedArtifact.path === artifact.path &&
+      openedArtifact.previewKey === artifact.previewKey;
+    // A streaming file is previewed under a provisional name until its real path
+    // arrives. Adopting that path renames the open panel; it does not deliver a
+    // second file, so the surrounding layout must not be reshuffled again.
+    const isPathUpgrade =
+      !isSamePreview &&
+      Boolean(artifact.previewKey) &&
+      openedArtifact?.threadId === artifact.threadId &&
+      openedArtifact.previewKey === artifact.previewKey;
+    if (!isSamePreview) {
+      setSandboxArtifact(artifact);
+      // The snapshot queued below is published synchronously, before the state
+      // update above commits, so the ref that gates it has to advance here.
+      sandboxArtifactRef.current = artifact;
+      // A newly opened panel must show the file's current content immediately
+      // instead of waiting out the throttle window of the previous preview.
+      sandboxSnapshotAppliedAtRef.current = 0;
+    }
+    if (sandboxThreadStore.getSnapshot()?.threadId !== artifact.threadId) {
+      sandboxThreadStore.publish(null);
+    }
 
     const latestSnapshot = latestNodeThreadSnapshotRef.current;
     if (latestSnapshot?.threadId === artifact.threadId) {
       queueSandboxThreadSnapshot(latestSnapshot);
     }
-    setRightPanelOpen(false);
+    if (!isPathUpgrade) {
+      setRightPanelOpen(false);
+    }
   }, [queueSandboxThreadSnapshot]);
   const handlePreviewFlowArtifact = useCallback(
     (item: ResultItem) => {
@@ -2151,17 +2470,17 @@ export default function PositionRoundtablePage({
     [handlePreviewArtifact],
   );
   const openIntentFlowDetail = useCallback(() => {
-    if (!(frozenIntent ?? intent.intentReady)) {
+    if (!positionIntent) {
       toast.info("任务意图还在梳理中，完成确认后就能查看完整的意图说明。");
       return;
     }
     setFlowDetailItem(
       buildIntentResultItem(
-        frozenIntent ?? intent.intentReady,
+        positionIntent,
         intentCompletedAt || positionSession?.updatedAt,
       ),
     );
-  }, [frozenIntent, intent.intentReady, intentCompletedAt, positionSession?.updatedAt]);
+  }, [positionIntent, intentCompletedAt, positionSession?.updatedAt]);
   const openNodeFlowDetail = useCallback(
     (node: PositionRoundtableNode) => {
       const item = buildNodeResultItem(node, activeChain);
@@ -2203,18 +2522,6 @@ export default function PositionRoundtablePage({
       }) as unknown as BaseStream<AgentThreadState>,
     [artifactsCtx?.artifacts],
   );
-  const sandboxThread = useMemo(
-    () =>
-      sandboxArtifact &&
-      sandboxThreadSnapshot?.threadId === sandboxArtifact.threadId
-        ? sandboxThreadSnapshot.thread
-        : sandboxThreadStub,
-    [sandboxArtifact, sandboxThreadSnapshot, sandboxThreadStub],
-  );
-  const sandboxThreadContextValue = useMemo(
-    () => ({ thread: sandboxThread, isMock: false }),
-    [sandboxThread],
-  );
   const handleNodeThreadSnapshot = useCallback(
     (snapshot: { threadId: string; thread: BaseStream<AgentThreadState> }) => {
       const signature = sandboxThreadSignature(snapshot.thread);
@@ -2237,10 +2544,16 @@ export default function PositionRoundtablePage({
     if (ctx?.open) {
       ctx?.setOpen(false);
     }
+    if (sandboxSnapshotTimerRef.current !== null) {
+      window.clearTimeout(sandboxSnapshotTimerRef.current);
+      sandboxSnapshotTimerRef.current = null;
+    }
     pendingSandboxThreadSnapshotRef.current = null;
+    sandboxSnapshotAppliedAtRef.current = 0;
+    sandboxArtifactRef.current = null;
     setSandboxArtifact(null);
-    setSandboxThreadSnapshot(null);
-  }, []);
+    sandboxThreadStore.publish(null);
+  }, [sandboxThreadStore]);
   const handleSelectBuiltinStage = useCallback(
     (kind: ClosureStageKind) => {
       // The closing agents are part of the testing-analysis workspace only;
@@ -2284,9 +2597,9 @@ export default function PositionRoundtablePage({
     setActiveBuiltinKind(null);
     setSelectedAgentId(null);
     setActiveNodeKey(null);
-    setRightPanelOpen(positionIdFromUrl === intentPositionId);
+    setRightPanelOpen(false);
     setLeftPanelCollapsed(false);
-  }, [closeSandbox, intentPositionId, positionId, positionIdFromUrl]);
+  }, [closeSandbox, positionId, positionIdFromUrl]);
   const handlePositionChange = useCallback(
     (value: unknown) => {
       // 右侧详情只属于刚才的岗位；切岗后回到该岗位的智能体列表，
@@ -2298,13 +2611,13 @@ export default function PositionRoundtablePage({
       setActiveBuiltinKind(null);
       setSelectedAgentId(null);
       setActiveNodeKey(null);
-      setRightPanelOpen(nextPositionId === intentPositionId);
+      setRightPanelOpen(false);
       setLeftPanelCollapsed(false);
       const next = new URLSearchParams(searchParamsString);
       next.set("positionId", nextPositionId);
       setSearchParams(next, { replace: true });
     },
-    [closeSandbox, intentPositionId, searchParamsString, setSearchParams],
+    [closeSandbox, searchParamsString, setSearchParams],
   );
   const renderIntentChatPanel = (chainStarted: boolean) => (
     <div className="position-roundtable-intent-page contents">
@@ -2321,21 +2634,112 @@ export default function PositionRoundtablePage({
       <Step1Panel
         rootClassName="position-roundtable-intent-panel"
         headerLeftSlot={
-          <div className="flex min-w-0 items-center gap-2">
-            <MessageSquareText className="size-4 text-primary" />
-            <div className="min-w-0">
-              <h2 className="truncate text-sm font-extrabold text-slate-900 dark:text-foreground">
-                {activePosition.name} · 意图识别
-              </h2>
-              <p className="truncate text-[11px] text-muted-foreground">
-                {activePosition.description}
-              </p>
-            </div>
+          <div className="position-roundtable-intent-header-title">
+            <span aria-hidden="true" />
+            <h2>测试分析岗1 · 意图识别</h2>
           </div>
         }
-        interactiveMessages={intent.interactiveMessages}
+        headerRightSlot={
+          <div className="position-roundtable-intent-header-actions">
+            <button
+              type="button"
+              className={cn(
+                "position-roundtable-intent-header-tab",
+                rightPanelOpen && rightTab === "agents" && "is-selected",
+              )}
+              onClick={() => {
+                if (rightPanelOpen && rightTab === "agents") {
+                  setRightPanelOpen(false);
+                  return;
+                }
+                setRightTab("agents");
+                if (activePosition.isIntentPosition) {
+                  setSelectedAgentId(intentAgentId);
+                }
+                setRightPanelOpen(true);
+              }}
+            >
+              智能体配置
+            </button>
+            <button
+              type="button"
+              className={cn(
+                "position-roundtable-intent-header-tab",
+                rightPanelOpen && rightTab === "results" && "is-selected",
+              )}
+              onClick={() => {
+                if (rightPanelOpen && rightTab === "results") {
+                  setRightPanelOpen(false);
+                  return;
+                }
+                setRightTab("results");
+                setRightPanelOpen(true);
+              }}
+            >
+              分析结果
+            </button>
+          </div>
+        }
+        rightSidebar={
+          !sandboxOpen && (
+            <aside
+              aria-hidden={!rightPanelOpen || undefined}
+              className={cn(
+                "position-roundtable-intent-config-pane",
+                rightPanelOpen ? "is-open" : "is-closed",
+              )}
+            >
+              <div className="position-roundtable-intent-config-pane-inner">
+                <RightWorkspace
+                  positions={configuredPositionOptions}
+                  selectedAgent={selectedAgentForPanel}
+                  selectedAgentId={selectedAgentId}
+                  positionName={activePosition.name}
+                  specialAgentConfig
+                  onSelectAgent={handleSelectAgent}
+                  intentObjective={positionIntentHeadline}
+                  intentCompletedAt={intentCompletedAt}
+                  assignedAgentIds={configurationAgentIds}
+                  hasSelectedChain={showClosureAgents || Boolean(selectedChain)}
+                  closureAgentConfiguration={showClosureAgents}
+                  session={positionSession}
+                  onConfigureChain={
+                    !showClosureAgents && selectedChain
+                      ? () => openPositionConfig(selectedChain.id)
+                      : undefined
+                  }
+                  nodes={positionSession?.nodes ?? []}
+                  chain={activeChain}
+                  onSessionUpdate={handlePositionSessionUpdate}
+                  onCollapse={() => setRightPanelOpen(false)}
+                  onPreviewArtifact={handlePreviewArtifact}
+                  onOpenBuiltinChat={showClosureAgents ? handleSelectBuiltinStage : undefined}
+                  tab={rightTab}
+                  onTabChange={setRightTab}
+                  standaloneDemo={standaloneDemoMode}
+                />
+              </div>
+            </aside>
+          )
+        }
+        hideQuestionCount
+        emptyState={
+          intent.isIntentInitializing ? (
+            <div className="position-roundtable-intent-loading-state" role="status" aria-live="polite">
+              <Loader2 className="size-6 animate-spin" aria-hidden="true" />
+              <span>正在加载任务理解智能体</span>
+            </div>
+          ) : (
+            <div className="position-roundtable-intent-empty-state">
+              <img src={askQuestionIcon} alt="" aria-hidden="true" />
+              <h3>开始提问</h3>
+              <p>输入问题，获取基于任务的智能回答</p>
+            </div>
+          )
+        }
+        interactiveMessages={visibleIntentMessages}
         intentThreadId={intent.intentThreadId}
-        intentReady={chainStarted ? frozenIntent ?? intent.intentReady : intent.intentReady}
+        intentReady={chainStarted ? positionIntent : intent.intentReady}
         isIntentSending={intent.isIntentSending}
         pendingIntentClarificationMsgId={intent.pendingIntentClarificationMsgId}
         intentClarificationSelections={intent.intentClarificationSelections}
@@ -2388,6 +2792,7 @@ export default function PositionRoundtablePage({
             modelOptions={intentModelOptions}
             selectedModel={selectedModel}
             onSelectedModelChange={setSelectedModel}
+            commonQuestions={selectedAgentForPanel?.common_questions}
           />
         )}
         onManualSave={() => {
@@ -2594,44 +2999,55 @@ export default function PositionRoundtablePage({
         <aside
           aria-hidden={leftSidebarHidden || undefined}
           className={cn(
-            "position-roundtable-sidebar-scrollbar custom-scrollbar relative flex min-h-0 shrink-0 flex-col gap-3 overflow-y-auto rounded-2xl border border-slate-200 bg-white shadow-sm transition-[width,opacity,transform,padding,border-width] duration-300 ease-[cubic-bezier(0.22,1,0.36,1)] motion-reduce:transition-none dark:rounded-none dark:border-0 dark:bg-transparent dark:text-[#c5cfe0] dark:shadow-none",
+            "position-roundtable-sidebar-scrollbar custom-scrollbar relative flex min-h-0 shrink-0 flex-col gap-3 overflow-y-auto rounded-2xl border border-slate-200 shadow-sm transition-[width,opacity,transform,padding,border-width] duration-300 ease-[cubic-bezier(0.22,1,0.36,1)] motion-reduce:transition-none dark:rounded-none dark:border-0 dark:bg-transparent dark:text-[#c5cfe0] dark:shadow-none",
             leftSidebarHidden
               ? "w-0 translate-x-4 !border-0 !p-0 opacity-0 pointer-events-none"
               : "w-[360px] translate-x-0 p-3 opacity-100 dark:p-0",
           )}
         >
-          <TaskAnalysisPanel
-            task={task}
-            intent={frozenIntent ?? intent.intentReady}
-            taskEditable={!isArchivedSession}
-            intentEditable={!isArchivedSession}
-            onEditTask={openTaskEditor}
-            onEditIntent={openIntentEditor}
-            collapsed={false}
-            onCollapsedChange={setLeftPanelCollapsed}
-            className="min-h-full"
-          >
-            {activePosition.isIntentPosition && !isIntelligenceDeliveryOverview && (
-              <BusinessChainSelector
-                chains={chains}
-                loading={chainsLoading}
-                value={selectedChainId}
-                onChange={setSelectedChainId}
-                onConfigure={openPositionConfig}
-                className="min-h-0 flex-1"
+          {activePosition.isIntentPosition && !isIntelligenceDeliveryOverview && (
+            <PositionRoundtableEntrySidebar
+              task={task}
+              editable={!isArchivedSession}
+              onEditTask={openTaskEditor}
+              chains={chains}
+              loading={chainsLoading}
+              value={selectedChainId}
+              onChange={setSelectedChainId}
+              onConfigure={openPositionConfig}
+              onDeleteChain={handleDeleteChain}
+            />
+          )}
+          {(!activePosition.isIntentPosition || isIntelligenceDeliveryOverview) && (
+            <>
+              <TaskInformationCard
+                task={task}
+                editable={!isArchivedSession}
+                onEdit={openTaskEditor}
+                collapsed={false}
+                onCollapsedChange={() => undefined}
               />
-            )}
-            {(!activePosition.isIntentPosition || isIntelligenceDeliveryOverview) && (
-              <BusinessChainFlow
-                chain={activeChain}
-                nodes={positionSession?.nodes ?? []}
-                activeNodeKey={activeNodeKey}
-                onSelectNode={openNodeFlowDetail}
-                onSelectSeat={openSeatFlowDetail}
-                embedded
-              />
-            )}
-          </TaskAnalysisPanel>
+              {showIntentDeliveryOverview ? (
+                <IntentDeliveryOverviewSidebar
+                  intent={positionIntent}
+                  chain={activeChain}
+                  nodes={positionSession?.nodes ?? []}
+                  activeNodeKey={activeNodeKey}
+                  onSelectNode={openNodeFlowDetail}
+                  onSelectSeat={openSeatFlowDetail}
+                />
+              ) : (
+                <BusinessChainFlow
+                  chain={activeChain}
+                  nodes={positionSession?.nodes ?? []}
+                  activeNodeKey={activeNodeKey}
+                  onSelectNode={openNodeFlowDetail}
+                  onSelectSeat={openSeatFlowDetail}
+                  embedded
+                />
+              )}
+            </>
+          )}
         </aside>
 
         {leftSidebarHidden && (
@@ -2648,8 +3064,16 @@ export default function PositionRoundtablePage({
           </button>
         )}
 
-        <section className="relative flex min-w-[420px] flex-1 flex-col overflow-hidden rounded-[4px] border border-slate-200 bg-white shadow-sm dark:border-[#2b8ffe]/45 dark:bg-[#032650]/80 dark:shadow-none dark:backdrop-blur-md">
-          {!rightPanelOpen &&
+        <section
+          className={cn(
+            "relative flex min-w-[420px] flex-1 flex-col overflow-hidden rounded-[4px] border border-slate-200 bg-white shadow-sm dark:shadow-none",
+            activePosition.isIntentPosition
+              ? "position-roundtable-intent-workspace"
+              : "dark:border-[#2b8ffe]/45 dark:bg-[#032650]/80 dark:backdrop-blur-md",
+          )}
+        >
+          {!activePosition.isIntentPosition &&
+            !rightPanelOpen &&
             !sandboxOpen &&
             !(positionSession && activeNode && !activeBuiltinKind) && (
             <TButton
@@ -2716,39 +3140,6 @@ export default function PositionRoundtablePage({
           </div>
         </section>
 
-        {activePosition.isIntentPosition && rightPanelOpen && !sandboxOpen && (
-          <aside className="flex w-[400px] shrink-0 flex-col overflow-hidden rounded-[4px] border border-slate-200 bg-white shadow-sm dark:border-[#2b8ffe]/45 dark:bg-[#032650]/80 dark:text-[#c5cfe0] dark:shadow-none dark:backdrop-blur-md">
-            <RightWorkspace
-              positions={configuredPositionOptions}
-              selectedAgent={selectedAgent}
-              selectedAgentId={selectedAgentId}
-              onSelectAgent={handleSelectAgent}
-              onBackToAgents={() => setSelectedAgentId(null)}
-              intentObjective={frozenIntent?.objective ?? intent.intentReady?.objective}
-              intentCompletedAt={intentCompletedAt}
-              // 测试分析岗不配置业务链席位；右侧配置只面向两个收口智能体，
-              // 即方案总结与行动规划。其他岗位仍保持按当前岗位过滤的席位配置。
-              assignedAgentIds={configurationAgentIds}
-              hasSelectedChain={showClosureAgents || Boolean(selectedChain)}
-              closureAgentConfiguration={showClosureAgents}
-              session={positionSession}
-              onConfigureChain={
-                !showClosureAgents && selectedChain
-                  ? () => openPositionConfig(selectedChain.id)
-                  : undefined
-              }
-              nodes={positionSession?.nodes ?? []}
-              chain={activeChain}
-              onSessionUpdate={handlePositionSessionUpdate}
-              onCollapse={() => setRightPanelOpen(false)}
-              onPreviewArtifact={handlePreviewArtifact}
-              onOpenBuiltinChat={showClosureAgents ? handleSelectBuiltinStage : undefined}
-              tab={rightTab}
-              onTabChange={setRightTab}
-              standaloneDemo={standaloneDemoMode}
-            />
-          </aside>
-        )}
         {!activePosition.isIntentPosition && (
           <TDrawer
             visible={rightPanelOpen && !sandboxOpen}
@@ -2765,11 +3156,12 @@ export default function PositionRoundtablePage({
             <div className="flex h-full min-h-0 flex-col bg-white dark:bg-[#032650] dark:text-[#c5cfe0]">
               <RightWorkspace
                 positions={configuredPositionOptions}
-                selectedAgent={selectedAgent}
-                selectedAgentId={selectedAgentId}
-                onSelectAgent={handleSelectAgent}
-                onBackToAgents={() => setSelectedAgentId(null)}
-                intentObjective={frozenIntent?.objective ?? intent.intentReady?.objective}
+                selectedAgent={selectedAgentForPanel}
+                  selectedAgentId={selectedAgentId}
+                  positionName={activePosition.name}
+                  specialAgentConfig={activePosition.isIntentPosition}
+                  onSelectAgent={handleSelectAgent}
+                  intentObjective={positionIntentHeadline}
                 intentCompletedAt={intentCompletedAt}
                 assignedAgentIds={configurationAgentIds}
                 hasSelectedChain={showClosureAgents || Boolean(selectedChain)}
@@ -2795,18 +3187,23 @@ export default function PositionRoundtablePage({
         )}
         {sandboxOpen && sandboxArtifact && artifactsCtx && (
           <aside className="flex w-[min(48vw,720px)] min-w-[440px] shrink-0 flex-col overflow-hidden rounded-[4px] border border-slate-200 bg-white shadow-sm dark:border-[#2b8ffe]/45 dark:bg-[#032650]/80 dark:shadow-none">
-            <ThreadContext.Provider value={sandboxThreadContextValue}>
+            <SandboxThreadProvider
+              store={sandboxThreadStore}
+              threadId={sandboxArtifact.threadId}
+              fallbackThread={sandboxThreadStub}
+            >
               <ArtifactFileDetail
                 key={sandboxCloseKey(sandboxArtifact)}
                 className="min-h-0 flex-1"
                 filepath={sandboxArtifact.path}
                 threadId={sandboxArtifact.threadId}
+                mimeType={sandboxArtifact.mimeType}
                 onClose={closeSandbox}
                 allowVirtualMarkdownEdit
                 disableDesensitize
                 hideFileName
               />
-            </ThreadContext.Provider>
+            </SandboxThreadProvider>
           </aside>
         )}
         <DeliverableDetailDialog
@@ -3357,7 +3754,7 @@ function PositionNodeEmptyState({
 }
 
 /** 已启动会话中的意图是冻结快照；避免在情报岗视图意外覆盖它。 */
-function IntentConfirmedState({ intent }: { intent: IntentSummary }) {
+function IntentConfirmedState({ intent }: { intent: PositionIntentSummary }) {
   return (
     <div className="flex min-h-0 flex-1 flex-col overflow-y-auto bg-slate-50/50 px-6 py-7 dark:bg-[#032650]/30">
       <div className="mx-auto w-full max-w-2xl rounded-2xl border border-emerald-500/20 bg-white p-5 shadow-sm dark:border-emerald-400/25 dark:bg-[#042b59]/65">
@@ -3373,15 +3770,15 @@ function IntentConfirmedState({ intent }: { intent: IntentSummary }) {
           </div>
         </div>
         <div className="mt-5 rounded-xl border border-slate-100 bg-slate-50/70 p-4 dark:border-[#2b8ffe]/20 dark:bg-[#032650]/40">
-          <p className="text-[11px] font-semibold text-muted-foreground dark:text-[#8aa0c4]">任务目标</p>
-          <p className="mt-1.5 text-sm font-semibold leading-6 text-slate-800 dark:text-[#e8edf5]">
-            {desensitize(intent.objective)}
-          </p>
+          <p className="text-[11px] font-semibold text-muted-foreground dark:text-[#8aa0c4]">核心目标</p>
+          <div className="mt-1.5 space-y-1.5 text-sm font-semibold leading-6 text-slate-800 dark:text-[#e8edf5]">
+            {intent.coreGoals.map((goal, index) => <p key={`${goal}-${index}`}>{desensitize(goal)}</p>)}
+          </div>
         </div>
         <div className="mt-4">
-          <p className="text-[11px] font-semibold text-muted-foreground dark:text-[#8aa0c4]">关键约束</p>
+          <p className="text-[11px] font-semibold text-muted-foreground dark:text-[#8aa0c4]">风险提示</p>
           <div className="mt-2 grid gap-2 sm:grid-cols-2">
-            {intent.constraints.map((constraint, index) => (
+            {intent.riskWarnings.map((constraint, index) => (
               <div
                 key={`${constraint}-${index}`}
                 className="flex items-start gap-2 rounded-lg border border-slate-100 bg-white px-3 py-2 text-xs leading-5 text-slate-700 dark:border-[#2b8ffe]/20 dark:bg-[#032650]/35 dark:text-[#c5d8f1]"
@@ -3418,7 +3815,7 @@ function PositionDeliveryOverview({
   chain,
   session,
 }: {
-  intent: IntentSummary | null;
+  intent: PositionIntentSummary | null;
   intentCompletedAt?: string;
   nodes: PositionRoundtableNode[];
   chain: BusinessChain | null;
@@ -3551,7 +3948,10 @@ function PositionDeliveryOverview({
         kind: "intent",
         agentName: "情报分析智能体",
         productName: "任务意图理解",
-        summary: intent?.objective || "情报分析岗已确认任务意图并冻结业务链。",
+        summary:
+          intent?.strategicSignificance[0] ||
+          intent?.coreGoals[0] ||
+          "情报分析岗已确认任务意图并冻结业务链。",
         positionId: intentPositionIdFor(),
         updatedAt: intentCompletedAt || session?.updatedAt,
         status: intent ? "done" : "ready",
@@ -3878,6 +4278,217 @@ function TaskAnalysisPanel({
   );
 }
 
+function PositionRoundtableEntrySidebar({
+  task,
+  editable,
+  onEditTask,
+  chains,
+  loading,
+  value,
+  onChange,
+  onConfigure,
+  onDeleteChain,
+}: {
+  task: PositionTask;
+  editable: boolean;
+  onEditTask: () => void;
+  chains: BusinessChain[];
+  loading: boolean;
+  value: string;
+  onChange: (value: string) => void;
+  onConfigure: (chainId: string) => void;
+  onDeleteChain: (chain: BusinessChain) => void | Promise<void>;
+}) {
+  const navigate = useNavigate();
+  const [searchQuery, setSearchQuery] = useState("");
+  const [menuOpenId, setMenuOpenId] = useState<string | null>(null);
+  const [menuPosition, setMenuPosition] = useState<{ top: number; left: number } | null>(null);
+  useEffect(() => {
+    if (!menuOpenId) return;
+    const closeMenu = () => {
+      setMenuOpenId(null);
+      setMenuPosition(null);
+    };
+    window.addEventListener("resize", closeMenu);
+    window.addEventListener("scroll", closeMenu, true);
+    return () => {
+      window.removeEventListener("resize", closeMenu);
+      window.removeEventListener("scroll", closeMenu, true);
+    };
+  }, [menuOpenId]);
+  const filteredChains = useMemo(() => {
+    const query = searchQuery.trim().toLocaleLowerCase();
+    if (!query) return chains;
+    return chains.filter((chain) =>
+      `${desensitize(chain.title)} ${desensitize(chain.description ?? "")}`
+        .toLocaleLowerCase()
+        .includes(query),
+    );
+  }, [chains, searchQuery]);
+  const openChainEditor = (chainId?: string) => {
+    const returnTo = `${window.location.pathname}${window.location.search}`;
+    const chainQuery = chainId ? `chainId=${encodeURIComponent(chainId)}&` : "";
+    navigate(
+      `/page/workspace/roundtable/chains?${chainQuery}mode=position&returnTo=${encodeURIComponent(returnTo)}`,
+    );
+  };
+
+  const displayDescription =
+    task.id === DEFAULT_MOCK_POSITION_TASK_ID
+      ? "围绕暑期活动的游泳夏令营开展宣传，结合线上线下渠道吸引目标人群参与，持续提升活动影响力。"
+      : desensitize(task.description);
+  const menuChain = menuOpenId ? chains.find((chain) => chain.id === menuOpenId) : null;
+
+  return (
+    <div className="position-roundtable-entry-sidebar">
+      <section className="position-roundtable-entry-task-card">
+        {editable && (
+        <button type="button" className="position-roundtable-entry-edit" onClick={onEditTask} aria-label="编辑任务信息">
+            <img src={editTaskIcon} alt="" />
+          </button>
+        )}
+        <h2 title={desensitize(task.title)}>{desensitize(task.title)}</h2>
+        <div className="position-roundtable-entry-tags">
+          <span>{desensitize(task.priority || "紧急")}</span>
+          <span>{desensitize(task.source)}</span>
+          <span>{desensitize(task.direction)}</span>
+        </div>
+        <p>{desensitize(task.description)}</p>
+      </section>
+
+      <section className="position-roundtable-entry-chain-card">
+        <header>
+          <span aria-hidden="true" />
+          <h2>作业链条选择</h2>
+          <b>{chains.length}</b>
+        </header>
+        <div className="position-roundtable-entry-chain-toolbar">
+          <label className="position-roundtable-entry-chain-search">
+            <input
+              type="search"
+              value={searchQuery}
+              onChange={(event) => setSearchQuery(event.target.value)}
+              placeholder="搜索作业链条"
+              aria-label="搜索作业链条"
+            />
+            <img src={searchTaskIcon} alt="" aria-hidden="true" />
+          </label>
+          <button
+            type="button"
+            className="position-roundtable-entry-new-chain"
+            onClick={() => openChainEditor()}
+          >
+            <img src={addTaskIcon} alt="" aria-hidden="true" />
+            <span>新建作业链条</span>
+          </button>
+        </div>
+        <div className="position-roundtable-entry-chain-list">
+          {loading ? (
+            <div className="position-roundtable-entry-empty"><Loader2 className="size-4 animate-spin" />正在加载作业链条…</div>
+          ) : chains.length === 0 ? (
+            <div className="position-roundtable-entry-empty">暂无可用作业链条</div>
+          ) : filteredChains.length === 0 ? (
+            <div className="position-roundtable-entry-empty">未找到匹配的作业链条</div>
+          ) : (
+            filteredChains.map((chain) => {
+              const selected = chain.id === value;
+              const description = chain.description?.trim();
+              const unassignedSeatCount = chain.seats.filter(
+                (seat) => !seat.position_id?.trim(),
+              ).length;
+              return (
+                <article
+                  key={chain.id}
+                  className={`position-roundtable-entry-chain-item${selected ? " is-selected" : ""}`}
+                >
+                  <button type="button" onClick={() => onChange(selected ? "" : chain.id)} aria-pressed={selected}>
+                    <i aria-hidden="true" />
+                    <span>{desensitize(chain.title)}</span>
+                    {description && <small>{desensitize(description)}</small>}
+                  </button>
+                  <div className="position-roundtable-entry-chain-footer">
+                    <span className="position-roundtable-entry-chain-seat-status">
+                      {unassignedSeatCount > 0
+                        ? `${unassignedSeatCount}个席位未配置岗位`
+                        : `${chain.seats.length}个席位`}
+                    </span>
+                    {selected && (
+                      <button
+                        type="button"
+                        className="position-roundtable-entry-enter-chain"
+                        onClick={() => openChainEditor(chain.id)}
+                      >
+                        进入链条
+                      </button>
+                    )}
+                  </div>
+                  {editable && <div className="position-roundtable-entry-chain-actions">
+                    <button
+                      type="button"
+                      className="position-roundtable-entry-more"
+                      onClick={(event) => {
+                        if (menuOpenId === chain.id) {
+                          setMenuOpenId(null);
+                          setMenuPosition(null);
+                          return;
+                        }
+                        const rect = event.currentTarget.getBoundingClientRect();
+                        setMenuOpenId(chain.id);
+                        setMenuPosition({ top: Math.max(8, rect.top - 18), left: rect.right + 3 });
+                      }}
+                      aria-label={`更多操作：${desensitize(chain.title)}`}
+                      aria-haspopup="menu"
+                      aria-expanded={menuOpenId === chain.id}
+                    >
+                      <img src={moreTaskIcon} alt="" aria-hidden="true" />
+                    </button>
+                  </div>}
+                </article>
+              );
+            })
+          )}
+        </div>
+      </section>
+      {menuChain && menuPosition && typeof document !== "undefined" &&
+        createPortal(
+          <div
+            className="position-roundtable-entry-chain-menu"
+            role="menu"
+            style={{ top: menuPosition.top, left: menuPosition.left }}
+          >
+            <button
+              type="button"
+              role="menuitem"
+              className="position-roundtable-entry-chain-menu-item is-edit"
+              onClick={() => {
+                setMenuOpenId(null);
+                setMenuPosition(null);
+                onConfigure(menuChain.id);
+              }}
+            >
+              <img src={editTaskIcon} alt="" aria-hidden="true" />
+              <span>{"\u7F16\u8F91"}</span>
+            </button>
+            <button
+              type="button"
+              role="menuitem"
+              className="position-roundtable-entry-chain-menu-item is-delete"
+              onClick={() => {
+                setMenuOpenId(null);
+                setMenuPosition(null);
+                void onDeleteChain(menuChain);
+              }}
+            >
+              <Trash2 aria-hidden="true" />
+              <span>{"\u5220\u9664"}</span>
+            </button>
+          </div>,
+          document.body,
+        )}
+    </div>
+  );
+}
+
 function TaskInformationCard({
   task,
   editable,
@@ -3892,8 +4503,34 @@ function TaskInformationCard({
   onCollapsedChange: (collapsed: boolean) => void;
 }) {
   return (
-    <section className="group relative shrink-0 overflow-hidden rounded-[4px] border border-[#ECE7E4] bg-white shadow-[0_4px_20px_rgba(0,0,0,0.02)] dark:border-[rgba(43,143,254,0.6)] dark:bg-[#032650] dark:shadow-none">
-      <div className="relative flex h-10 items-center border-b border-rose-100 bg-[linear-gradient(89.65deg,rgba(245,34,45,0.10)_0.03%,rgba(245,34,45,0)_99.97%)] px-4 [&_h2]:!text-slate-900 dark:!bg-[linear-gradient(89.65deg,#0062d9_0.03%,#0062d900_99.97%)] dark:border-b-[#2b8ffe]/60 dark:[&_h2]:!text-white dark:after:absolute dark:after:inset-x-0 dark:after:bottom-[-1px] dark:after:h-px dark:after:bg-[#45c3f3]/85 dark:after:content-['']">
+    <section className="position-roundtable-task-card group relative shrink-0 overflow-hidden rounded-[4px] border border-[#ECE7E4] bg-white p-5 shadow-[0_4px_20px_rgba(0,0,0,0.02)] dark:border-[rgba(0,110,254,0.5)] dark:bg-[#032650] dark:shadow-none">
+      <div className="position-roundtable-task-card__content relative z-10">
+        <h2
+          title={desensitize(task.title)}
+          className="pr-8 text-[18px] font-medium leading-7 text-slate-900 dark:text-white"
+          style={{ fontFamily: "'Noto Sans SC', sans-serif" }}
+        >
+          <span className="line-clamp-1">{desensitize(task.title)}</span>
+        </h2>
+        <div
+          data-task-tags
+          className="mt-3 flex flex-wrap gap-2 [&>span]:inline-flex [&>span]:min-h-7 [&>span]:items-center [&>span]:!leading-5 [&>span:first-child]:!border-[#cf1322] [&>span:nth-child(2)]:!shadow-none"
+          style={{ fontFamily: "'Noto Sans SC', sans-serif" }}
+        >
+          <span className="rounded-[2px] border border-[#cf1322] bg-[rgba(207,19,34,0.5)] px-2 py-0.5 text-center text-[16px] font-light leading-4 text-white">紧急</span>
+          <span className="rounded-[2px] border border-[#4bcdff] bg-[rgba(75,205,255,0.3)] px-2 py-0.5 text-[16px] font-light leading-7 text-[#4bcdff] shadow-[0_0_9px_rgba(252,131,131,0.27)]">{desensitize(task.source)}</span>
+          <span className="rounded-[2px] border border-[#a2e1f9] bg-[rgba(162,225,249,0.3)] px-2 py-0.5 text-[16px] font-light leading-[18px] text-[#a2e1f9]">{desensitize(task.direction)}</span>
+        </div>
+        <p
+          data-task-description
+          title={desensitize(task.description)}
+          className="mt-3 line-clamp-3 whitespace-pre-wrap text-sm leading-[22px] text-slate-600 dark:text-[#96bbf8]"
+          style={{ fontFamily: "'Noto Sans SC', sans-serif" }}
+        >
+          {desensitize(task.description)}
+        </p>
+      </div>
+      <div style={{ display: "none" }} className="relative flex h-10 items-center border-b border-rose-100 bg-[linear-gradient(89.65deg,rgba(245,34,45,0.10)_0.03%,rgba(245,34,45,0)_99.97%)] px-4 [&_h2]:!text-slate-900 dark:!bg-[linear-gradient(89.65deg,#0062d9_0.03%,#0062d900_99.97%)] dark:border-b-[#2b8ffe]/60 dark:[&_h2]:!text-white dark:after:absolute dark:after:inset-x-0 dark:after:bottom-[-1px] dark:after:h-px dark:after:bg-[#45c3f3]/85 dark:after:content-['']">
         <span
           aria-hidden="true"
           className="mr-3 h-5 w-1 shrink-0 rounded-l-[2px] rounded-br-[2px] bg-[linear-gradient(167.47deg,#f15959_0%,#cc1925_100%)] dark:bg-[linear-gradient(167.47deg,#a2e1f9_0%,#45c3f3_100%)]"
@@ -3914,8 +4551,9 @@ function TaskInformationCard({
         </div>
       </div>
       <div
+        style={{ display: "none" }}
         className={cn(
-          "grid transition-[grid-template-rows,opacity] duration-300 ease-[cubic-bezier(0.22,1,0.36,1)] motion-reduce:transition-none",
+          "hidden grid transition-[grid-template-rows,opacity] duration-300 ease-[cubic-bezier(0.22,1,0.36,1)] motion-reduce:transition-none",
           collapsed ? "grid-rows-[0fr] opacity-0" : "grid-rows-[1fr] opacity-100",
         )}
       >
@@ -3973,6 +4611,20 @@ function TaskInformationEditDialog({
           <DialogTitle>编辑任务信息</DialogTitle>
         </DialogHeader>
         <div className="space-y-4 py-1">
+          <div className="grid grid-cols-3 gap-3">
+            <label className="block space-y-1.5">
+              <span className="text-xs font-semibold text-slate-500 dark:text-[#9ebfe2]">标签一</span>
+              <TInput value={task.priority ?? ""} onChange={(value) => onChange({ ...task, priority: String(value) })} placeholder="例如：紧急" />
+            </label>
+            <label className="block space-y-1.5">
+              <span className="text-xs font-semibold text-slate-500 dark:text-[#9ebfe2]">标签二</span>
+              <TInput value={task.source} onChange={(value) => onChange({ ...task, source: String(value) })} placeholder="例如：本系统创建" />
+            </label>
+            <label className="block space-y-1.5">
+              <span className="text-xs font-semibold text-slate-500 dark:text-[#9ebfe2]">标签三</span>
+              <TInput value={task.direction} onChange={(value) => onChange({ ...task, direction: String(value) })} placeholder="例如：暑期活动" />
+            </label>
+          </div>
           <label className="block space-y-1.5">
             <span className="text-xs font-semibold text-slate-500 dark:text-[#9ebfe2]">任务名称</span>
             <TInput
@@ -4048,19 +4700,25 @@ function BusinessChainSelector({
   const [relationOpenId, setRelationOpenId] = useState<string | null>(null);
 
   return (
-    <section className={cn("group/business-chain flex min-h-0 flex-col", className)}>
-      <div className="relative flex h-10 items-center border-b border-slate-200 dark:border-[#2b8ffe]/60">
+    <section className={cn("position-roundtable-chain-selector group/business-chain flex min-h-0 flex-col rounded-[4px] border border-[#ECE7E4] bg-white p-5 shadow-[0_4px_20px_rgba(0,0,0,0.02)] dark:border-[rgba(0,110,254,0.5)] dark:bg-[#032650] dark:shadow-none [&>div>h3:first-of-type]:hidden", className)}>
+      <div className="relative flex h-8 shrink-0 items-center">
         <span
           aria-hidden="true"
           className="mr-3 h-6 w-1 shrink-0 rounded-l-[2px] rounded-br-[2px] bg-[linear-gradient(167.47deg,#f15959_0%,#cc1925_100%)] dark:bg-[linear-gradient(167.47deg,#a2e1f9_0%,#45c3f3_100%)]"
         />
         <h3 className="text-lg font-[550] tracking-wide text-slate-900 dark:text-white">业务链</h3>
+        <h3
+          className="text-[18px] font-medium leading-7 tracking-wide text-slate-900 dark:text-white"
+          style={{ fontFamily: "'Noto Sans SC', sans-serif" }}
+        >
+          作业链条选择
+        </h3>
         <span className="ml-auto flex size-6 items-center justify-center rounded-[4px] bg-slate-100 text-xs font-semibold tabular-nums text-slate-500 dark:bg-[#0b386d] dark:text-[#83c1ff]">
           {chains.length}
         </span>
       </div>
 
-      <div className="business-chain-scrollbar min-h-0 flex-1 space-y-2.5 overflow-y-auto py-4 pr-1 custom-scrollbar">
+      <div className="business-chain-scrollbar min-h-0 flex-1 space-y-2.5 overflow-y-auto pt-4 pr-1 custom-scrollbar">
           {loading ? (
             <div className="flex h-20 items-center justify-center gap-2 text-xs text-slate-400 dark:text-[#8aa0c4]">
               <Loader2 className="size-4 animate-spin" />
@@ -4221,7 +4879,7 @@ function IntentUnderstandingCard({
   collapsed,
   onCollapsedChange,
 }: {
-  intent: ReturnType<typeof useStep1Intent>["intentReady"];
+  intent: PositionIntentSummary | null;
   editable?: boolean;
   onEdit?: () => void;
   collapsed: boolean;
@@ -4263,30 +4921,21 @@ function IntentUnderstandingCard({
         <div className="min-h-0 overflow-hidden">
       {intent ? (
         <div className="space-y-3 p-4">
-          <div>
-            <p className="text-xs font-semibold text-slate-500 dark:text-[#9ebfe2]">任务意图</p>
-            <p className="mt-1 text-sm leading-6 text-slate-700 dark:text-[#f2f7ff]">
-              {desensitize(intent.objective)}
-            </p>
-          </div>
-          <div>
-            <p className="text-xs font-semibold text-slate-500 dark:text-[#9ebfe2]">关键约束</p>
-            <ul className="mt-1 list-disc space-y-1 pl-4 text-sm leading-6 text-slate-600 marker:text-slate-400 dark:text-[#d8e6f8] dark:marker:text-[#83b6ed]">
-              {intent.constraints.map((constraint, index) => (
-                <li key={`${constraint}-${index}`}>{desensitize(constraint)}</li>
-              ))}
-            </ul>
-          </div>
-          {intent.assumptions && intent.assumptions.length > 0 && (
-            <div>
-              <p className="text-xs font-semibold text-slate-500 dark:text-[#9ebfe2]">关键假设</p>
-              <ul className="mt-1 list-disc space-y-1 pl-4 text-sm leading-6 text-slate-600 marker:text-slate-400 dark:text-[#d8e6f8] dark:marker:text-[#83b6ed]">
-                {intent.assumptions.map((assumption, index) => (
-                  <li key={`${assumption}-${index}`}>{desensitize(assumption)}</li>
-                ))}
-              </ul>
+          {([
+            ["核心目标", intent.coreGoals],
+            ["风险提示", intent.riskWarnings],
+            ["关键要点", intent.keyPoints],
+            ["战略意义", intent.strategicSignificance],
+          ] as const).map(([label, values]) => (
+            <div key={label}>
+              <p className="text-xs font-semibold text-slate-500 dark:text-[#9ebfe2]">{label}</p>
+              {values.length > 0 ? (
+                <ul className="mt-1 list-disc space-y-1 pl-4 text-sm leading-6 text-slate-600 marker:text-slate-400 dark:text-[#d8e6f8] dark:marker:text-[#83b6ed]">
+                  {values.map((value, index) => <li key={`${value}-${index}`}>{desensitize(value)}</li>)}
+                </ul>
+              ) : <p className="mt-1 text-sm text-slate-500 dark:text-[#9ebfe2]">暂无{label}</p>}
             </div>
-          )}
+          ))}
         </div>
       ) : (
         <div className="p-4 text-sm leading-6 text-muted-foreground dark:text-[#d8e6f8]">
@@ -4299,6 +4948,83 @@ function IntentUnderstandingCard({
   );
 }
 
+function IntentDeliveryOverviewSidebar({
+  intent,
+  chain,
+  nodes,
+  activeNodeKey,
+  onSelectNode,
+  onSelectSeat,
+}: {
+  intent: PositionIntentSummary | null;
+  chain: BusinessChain | null;
+  nodes: PositionRoundtableNode[];
+  activeNodeKey: string | null;
+  onSelectNode: (node: PositionRoundtableNode) => void;
+  onSelectSeat: (seat: BusinessChain["seats"][number], stageIndex: number, seatIndex: number) => void;
+}) {
+  const coreGoals = intent?.coreGoals ?? [];
+  const riskWarnings = intent?.riskWarnings ?? [];
+  const keyPoints = intent?.keyPoints ?? [];
+  const strategicSignificance = intent?.strategicSignificance ?? [];
+
+  return (
+    <section className="position-roundtable-intent-delivery-sidebar">
+      <div className="position-roundtable-intent-delivery-result">
+        <header className="position-roundtable-intent-delivery-header">
+          <span aria-hidden="true" />
+          <h2>意图理解结果</h2>
+        </header>
+        <div className="position-roundtable-intent-delivery-sections">
+          <article className="position-roundtable-intent-delivery-section position-roundtable-intent-delivery-section--goals">
+            <h3>核心目标</h3>
+            {coreGoals.length > 0 ? (
+              <ol>
+                {coreGoals.map((goal, index) => (
+                  <li key={`${goal}-${index}`}>{desensitize(goal)}</li>
+                ))}
+              </ol>
+            ) : (
+              <p className="is-empty">暂无核心目标</p>
+            )}
+          </article>
+          <article className="position-roundtable-intent-delivery-section position-roundtable-intent-delivery-section--constraints">
+            <h3>风险提示</h3>
+            {riskWarnings.length > 0 ? (
+              <ul>
+                {riskWarnings.map((warning, index) => (
+                  <li key={`${warning}-${index}`}>{desensitize(warning)}</li>
+                ))}
+              </ul>
+            ) : (
+              <p className="is-empty">暂无风险提示</p>
+            )}
+          </article>
+          <article className="position-roundtable-intent-delivery-section position-roundtable-intent-delivery-section--purpose">
+            <h3>关键要点</h3>
+            {keyPoints.length > 0 ? <ul>{keyPoints.map((item, index) => <li key={`${item}-${index}`}>{desensitize(item)}</li>)}</ul> : <p className="is-empty">暂无关键要点</p>}
+          </article>
+          <article className="position-roundtable-intent-delivery-section position-roundtable-intent-delivery-section--significance">
+            <h3>战略意义</h3>
+            {strategicSignificance.length > 0 ? <ul>{strategicSignificance.map((item, index) => <li key={`${item}-${index}`}>{desensitize(item)}</li>)}</ul> : <p className="is-empty">暂无战略意义</p>}
+          </article>
+        </div>
+      </div>
+
+      <BusinessChainFlow
+        chain={chain}
+        nodes={nodes}
+        activeNodeKey={activeNodeKey}
+        onSelectNode={onSelectNode}
+        onSelectSeat={onSelectSeat}
+        embedded
+        title="CH作业进展"
+        className="position-roundtable-intent-delivery-flow"
+      />
+    </section>
+  );
+}
+
 function IntentUnderstandingEditDialog({
   open,
   draft,
@@ -4327,34 +5053,43 @@ function IntentUnderstandingEditDialog({
         </DialogHeader>
         <div className="space-y-4 py-1">
           <label className="block space-y-1.5">
-            <span className="text-xs font-semibold text-slate-500 dark:text-[#9ebfe2]">任务意图</span>
+            <span className="text-xs font-semibold text-slate-500 dark:text-[#9ebfe2]">核心目标</span>
             <Textarea
-              value={draft.objective}
-              onChange={(event) => onChange({ ...draft, objective: event.target.value })}
+              value={draft.coreGoals}
+              onChange={(event) => onChange({ ...draft, coreGoals: event.target.value })}
               className="min-h-24 resize-none dark:border-[#2b8ffe]/35 dark:bg-[#032650]/80"
-              placeholder="请输入识别后的任务意图"
+              placeholder="每行一项核心目标"
             />
           </label>
           <label className="block space-y-1.5">
             <span className="text-xs font-semibold text-slate-500 dark:text-[#9ebfe2]">
-              关键约束
+              风险提示
             </span>
             <Textarea
-              value={draft.constraints}
-              onChange={(event) => onChange({ ...draft, constraints: event.target.value })}
+              value={draft.riskWarnings}
+              onChange={(event) => onChange({ ...draft, riskWarnings: event.target.value })}
               className="min-h-28 resize-none dark:border-[#2b8ffe]/35 dark:bg-[#032650]/80"
-              placeholder="每行一条关键约束"
+              placeholder="每行一项风险、依赖或待确认事项"
             />
           </label>
           <label className="block space-y-1.5">
             <span className="text-xs font-semibold text-slate-500 dark:text-[#9ebfe2]">
-              补充假设 / 说明
+              关键要点
             </span>
             <Textarea
-              value={draft.assumptions}
-              onChange={(event) => onChange({ ...draft, assumptions: event.target.value })}
+              value={draft.keyPoints}
+              onChange={(event) => onChange({ ...draft, keyPoints: event.target.value })}
               className="min-h-20 resize-none dark:border-[#2b8ffe]/35 dark:bg-[#032650]/80"
-              placeholder="可选，每行一条"
+              placeholder="每行一项关键要点"
+            />
+          </label>
+          <label className="block space-y-1.5">
+            <span className="text-xs font-semibold text-slate-500 dark:text-[#9ebfe2]">战略意义</span>
+            <Textarea
+              value={draft.strategicSignificance}
+              onChange={(event) => onChange({ ...draft, strategicSignificance: event.target.value })}
+              className="min-h-20 resize-none dark:border-[#2b8ffe]/35 dark:bg-[#032650]/80"
+              placeholder="每行一项战略意义"
             />
           </label>
         </div>
@@ -4397,6 +5132,7 @@ function BusinessChainFlow({
   onSelectSeat,
   className,
   embedded = false,
+  title = "业务链条",
 }: {
   chain: BusinessChain | null;
   nodes: PositionRoundtableNode[];
@@ -4405,6 +5141,7 @@ function BusinessChainFlow({
   onSelectSeat?: (seat: BusinessChain["seats"][number], stageIndex: number, seatIndex: number) => void;
   className?: string;
   embedded?: boolean;
+  title?: string;
 }) {
   const [flowDialogOpen, setFlowDialogOpen] = useState(false);
 
@@ -4434,7 +5171,7 @@ function BusinessChainFlow({
             </span>
           )}
           <h2 className={cn("truncate font-semibold tracking-wide text-slate-900 dark:text-[#e8edf5]", embedded ? "text-lg font-[550] dark:text-white" : "text-sm")}>
-            业务链条
+            {title}
           </h2>
         </div>
         {chain && (
@@ -4779,8 +5516,9 @@ function RightWorkspace({
   positions,
   selectedAgent,
   selectedAgentId,
+  positionName,
+  specialAgentConfig = false,
   onSelectAgent,
-  onBackToAgents,
   intentObjective,
   intentCompletedAt,
   assignedAgentIds,
@@ -4801,8 +5539,9 @@ function RightWorkspace({
   positions: readonly PositionOption[];
   selectedAgent: Agent | null;
   selectedAgentId: string | null;
+  positionName?: string;
+  specialAgentConfig?: boolean;
   onSelectAgent: (agentId: string) => void;
-  onBackToAgents: () => void;
   intentObjective?: string;
   intentCompletedAt: string;
   assignedAgentIds: Set<string>;
@@ -4822,7 +5561,76 @@ function RightWorkspace({
   /** Read-only frontend fixture: do not mount configuration/API consumers. */
   standaloneDemo?: boolean;
 }) {
-  const visibleTab: WorkspaceTab = standaloneDemo ? "results" : tab;
+  // The local fixture starts on results, but the header tab must still be able
+  // to open the special agent configuration panel on demand.
+  const visibleTab: WorkspaceTab = tab;
+
+  if (specialAgentConfig) {
+    return (
+      <div className="position-roundtable-intent-config-workspace">
+        {visibleTab === "agents" ? (
+          <div className="position-roundtable-agent-detail position-roundtable-agent-detail--special h-full min-h-0">
+            <AgentDetailPanel
+              agent={selectedAgent}
+              agentName={selectedAgent?.name ?? ""}
+              onAskQuestion={() => toast.info("请在中间对话区发起岗位会商问题")}
+              showRecentChats={false}
+              avatarSrc={agentConfigLogo}
+              positionName={positionName}
+              skillsIcon={<img src={doubleArrowDecoration} alt="" aria-hidden="true" />}
+              skillsTitle="技能列表"
+              showCommonQuestions
+              panelTitle="智能体配置"
+              embedded
+              hideStatusBadges
+              editIcon={<img src={editTaskIcon} alt="" aria-hidden="true" />}
+              compactAppearanceActions={
+                <button
+                  type="button"
+                  className="position-roundtable-intent-config-collapse-btn"
+                  onClick={onCollapse}
+                  aria-label="收起智能体配置"
+                  title="收起智能体配置"
+                >
+                  <img src={collapsePanelIcon} alt="" aria-hidden="true" />
+                </button>
+              }
+            />
+          </div>
+        ) : (
+          <div className="position-roundtable-intent-analysis-results">
+            <div className="position-roundtable-intent-analysis-header">
+              <span>分析成果列表</span>
+              <button
+                type="button"
+                className="position-roundtable-intent-config-collapse-btn"
+                onClick={onCollapse}
+                aria-label="收起分析结果"
+                title="收起分析结果"
+              >
+                <img src={collapsePanelIcon} alt="" aria-hidden="true" />
+              </button>
+            </div>
+            <div className="position-roundtable-intent-analysis-results-scroll">
+              <AnalysisResults
+                positions={positions}
+                intentObjective={intentObjective}
+                intentCompletedAt={intentCompletedAt}
+                nodes={nodes}
+                chain={chain}
+                session={session}
+                onSessionUpdate={onSessionUpdate}
+                onPreviewArtifact={onPreviewArtifact}
+                onOpenBuiltinChat={onOpenBuiltinChat}
+                readOnly={standaloneDemo}
+              />
+            </div>
+          </div>
+        )}
+      </div>
+    );
+  }
+
   return (
     <div className="flex min-h-0 flex-1 flex-col overflow-hidden p-2.5 pt-2">
       {/* 与课题研究 / ai写作一致的分段切换样式。 */}
@@ -4879,26 +5687,32 @@ function RightWorkspace({
         <div className="min-h-0 flex-1 overflow-hidden pt-2">
           <div className="h-full min-h-0 overflow-hidden rounded-xl border border-slate-200 dark:border-[#2b8ffe]/45 dark:bg-[#032650]/65">
             {selectedAgentId ? (
-              <div className="flex h-full min-h-0 flex-col">
-                <div className="flex h-11 shrink-0 items-center gap-2 border-b px-3 dark:border-[#2b8ffe]/25">
-                  <TButton
-                    size="small"
-                    variant="text"
-                    icon={<ArrowLeft className="size-3.5" />}
-                    onClick={onBackToAgents}
-                  >
-                    返回列表
-                  </TButton>
-                  <span className="min-w-0 truncate text-xs text-muted-foreground dark:text-[#8aa0c4]">
-                    {selectedAgent ? desensitize(selectedAgent.name) : "加载中…"}
-                  </span>
-                </div>
-                <div className="min-h-0 flex-1 [&>aside]:!flex [&>aside]:!w-full [&>aside]:!border-l-0 [&>aside]:!bg-transparent">
+              <div
+              className={cn(
+                  "position-roundtable-agent-detail-container flex h-full min-h-0 flex-col",
+                  specialAgentConfig && "position-roundtable-agent-detail-container--special",
+                )}
+              >
+                <div
+                  className={cn(
+                    "position-roundtable-agent-detail min-h-0 flex-1 [&>aside]:!flex [&>aside]:!w-full [&>aside]:!border-l-0 [&>aside]:!bg-transparent",
+                    specialAgentConfig && "position-roundtable-agent-detail--special",
+                  )}
+                >
                   <AgentDetailPanel
                     agent={selectedAgent}
                     agentName={selectedAgent?.name ?? ""}
                     onAskQuestion={() => toast.info("请在中间对话区发起岗位会商")}
                     showRecentChats={false}
+                    avatarSrc={specialAgentConfig ? agentConfigLogo : undefined}
+                    positionName={specialAgentConfig ? positionName : undefined}
+                    skillsIcon={
+                      specialAgentConfig ? (
+                        <img src={doubleArrowDecoration} alt="" aria-hidden="true" />
+                      ) : undefined
+                    }
+                    skillsTitle={specialAgentConfig ? "技能列表" : undefined}
+                    showCommonQuestions={specialAgentConfig}
                   />
                 </div>
               </div>
@@ -5147,6 +5961,15 @@ interface ResultItem {
   artifactContent?: string | null;
 }
 
+const ANALYSIS_RESULT_TAG_ICONS = [
+  analysisTag1,
+  analysisTag2,
+  analysisTag3,
+  analysisTag4,
+  analysisTag5,
+  analysisTag6,
+] as const;
+
 function canOpenDeliverable(item: ResultItem): boolean {
   return Boolean(
     item.status === "done" &&
@@ -5223,7 +6046,7 @@ function deliverableFallbackContent(item: ResultItem | null): string {
 }
 
 function buildIntentResultItem(
-  intent: IntentSummary | null,
+  intent: PositionIntentSummary | null,
   updatedAt: string | undefined,
 ): ResultItem {
   return {
@@ -5232,7 +6055,10 @@ function buildIntentResultItem(
     node: null,
     agentName: "情报分析智能体",
     productName: "任务意图理解",
-    summary: intent?.objective || "任务意图已确认，当前没有更多意图摘要内容。",
+    summary:
+      intent?.strategicSignificance[0] ||
+      intent?.coreGoals[0] ||
+      "任务意图已确认，当前没有更多意图摘要内容。",
     positionId: intentPositionIdFor(),
     updatedAt,
     status: intent ? "done" : "ready",
@@ -5401,6 +6227,8 @@ function AnalysisResults({
       });
     }
     for (const node of nodes) {
+      // 意图理解节点只负责确认任务意图，不作为分析结果中的交付节点展示。
+      if (isIntentPositionNode(node)) continue;
       const seat = seatsByAgentId.get(node.agentId);
       const agentName = seat?.name ?? node.agentId;
       const artifactCount = node.artifactManifest.length;
@@ -5542,7 +6370,11 @@ function AnalysisResults({
         });
       }
     }
-    return items.sort((left, right) => (right.updatedAt ?? "").localeCompare(left.updatedAt ?? ""));
+    // 任务理解智能体只负责确认意图，不会产生可交付的分析产物。
+    // 它仍可在流程详情中查看，但不应作为“分析结果”的成功项展示。
+    return items
+      .filter((item) => item.kind !== "intent")
+      .sort((left, right) => (right.updatedAt ?? "").localeCompare(left.updatedAt ?? ""));
   }, [intentObjective, nodes, seatsByAgentId, session?.actionPlanSnapshot, session?.summarySnapshot]);
   const positionOptions = useMemo(
     () => [
@@ -5630,7 +6462,7 @@ function AnalysisResults({
 
   if (resultItems.length === 0) {
     return (
-      <div className="flex h-full min-h-[260px] flex-col items-center justify-center rounded-xl border border-dashed p-6 text-center">
+      <div className="position-roundtable-analysis-results-empty flex h-full min-h-[260px] flex-col items-center justify-center p-6 text-center">
         <FileOutput className="mb-3 size-8 text-muted-foreground/50" />
         <p className="text-sm font-semibold">暂无交付产物</p>
         <p className="mt-1 max-w-[240px] text-xs leading-5 text-muted-foreground">
@@ -5642,16 +6474,9 @@ function AnalysisResults({
 
   return (
     <div className="contents">
-      <div className="space-y-3 rounded-xl border border-slate-200 p-3.5 dark:border-border">
-        <div className="flex items-center justify-between">
-          <div>
-            <h3 className="text-sm font-bold">交付产物列表</h3>
-            <p className="text-[11px] text-muted-foreground">按岗位节点与生成时间展示</p>
-          </div>
-          <span className="rounded-full bg-emerald-500/10 px-2 py-0.5 text-[10px] font-semibold text-emerald-600">
-            {visibleItems.length}/{resultItems.length} 项结果
-          </span>
-        </div>
+      <div className="space-y-3 p-3.5">
+        {/* 筛选控件暂时隐藏，保留逻辑供后续恢复。 */}
+        {/*
         <div className="grid grid-cols-1 gap-2 sm:grid-cols-2">
           <TSelect size="small" value={positionFilter} options={positionOptions} onChange={(value) => setPositionFilter(String(value))} />
           <TSelect size="small" value={nodeFilter} options={nodeOptions} onChange={(value) => setNodeFilter(String(value))} />
@@ -5660,7 +6485,6 @@ function AnalysisResults({
             value={kindFilter}
             options={[
               { label: "全部类型", value: "all" },
-              { label: "意图理解", value: "intent" },
               { label: "节点交付", value: "delivery" },
               { label: "文件产物", value: "artifact" },
               { label: "方案总结", value: "summary" },
@@ -5669,8 +6493,9 @@ function AnalysisResults({
             onChange={(value) => setKindFilter(String(value) as "all" | ResultKind)}
           />
         </div>
+        */}
         {onOpenBuiltinChat && nodes.length > 0 && (
-          <div className="rounded-xl border border-slate-200 bg-slate-50/70 p-3 dark:border-[#2b8ffe]/30 dark:bg-[#032650]/65">
+          <div className="rounded-[4px] border border-slate-200 bg-slate-50/70 p-3 dark:border-[#2b8ffe]/30 dark:bg-[#032650]/65">
             <div className="mb-2 flex items-center justify-between gap-2">
               <div className="min-w-0">
                 <p className="text-xs font-bold text-slate-800 dark:text-[#e8edf5]">
@@ -5718,11 +6543,11 @@ function AnalysisResults({
           </div>
         )}
         {visibleItems.length === 0 ? (
-          <div className="rounded-xl border border-dashed p-5 text-center text-xs text-muted-foreground">
+          <div className="position-roundtable-analysis-results-empty p-5 text-center text-xs text-muted-foreground">
             当前筛选条件下没有结果
           </div>
         ) : (
-          visibleItems.map((item) => {
+          visibleItems.map((item, index) => {
             const displayedTime = item.updatedAt
               ? new Intl.DateTimeFormat("zh-CN", {
                   month: "2-digit",
@@ -5732,63 +6557,32 @@ function AnalysisResults({
                   hour12: false,
                 }).format(new Date(item.updatedAt))
               : intentCompletedAt || "刚刚";
-            const stale = item.node?.status === "stale";
-            const invalidated = Boolean(item.node?.invalidatedBy);
-            const status = item.status ? nodeStatusMeta(item.status) : null;
-            const StatusIcon = status?.Icon;
+            const hasDeliveredArtifact = Boolean(item.artifactPath || item.artifactContent?.trim());
+            const displayedProductName =
+              hasDeliveredArtifact || (item.kind !== "delivery" && item.status === "done")
+                ? item.productName
+                : "未交付";
             const contents = (
-              <div className="contents">
-                <div className="flex items-start gap-3">
-                  <span
-                    className={cn(
-                      "flex size-10 shrink-0 items-center justify-center rounded-xl",
-                      item.kind === "intent"
-                        ? "bg-violet-500/10 text-violet-600"
-                        : item.kind === "artifact"
-                          ? "bg-amber-500/10 text-amber-600"
-                          : "bg-sky-500/10 text-sky-600",
-                    )}
-                  >
-                    {item.kind === "artifact" ? <FileOutput className="size-5" /> : <Bot className="size-5" />}
-                  </span>
-                  <div className="min-w-0 flex-1">
-                    <div className="flex items-center gap-1.5">
-                      <p className="truncate text-sm font-bold">{desensitize(item.agentName)}</p>
-                      {status && StatusIcon && (
-                        <span
-                          className={cn(
-                            "inline-flex shrink-0 items-center gap-1 rounded-full px-1.5 py-0.5 text-[9px] font-semibold",
-                            status.badgeClassName,
-                          )}
-                        >
-                          <StatusIcon
-                            className={cn("size-2.5", status.spin && "animate-spin")}
-                            strokeWidth={2.5}
-                          />
-                          {status.label}
-                        </span>
-                      )}
-                      {(stale || invalidated) && (
-                        <span className="shrink-0 rounded-full bg-amber-500/10 px-1.5 py-0.5 text-[9px] font-semibold text-amber-700 dark:text-amber-300">
-                          上游已更新
-                        </span>
-                      )}
-                    </div>
-                    <p className="mt-1 truncate text-xs font-medium text-primary">
-                      {desensitize(item.productName)}
-                    </p>
-                    <p className="mt-2 line-clamp-2 text-[11px] leading-5 text-muted-foreground">
-                      {desensitize(item.summary)}
-                    </p>
-                  </div>
+              <div className="position-roundtable-analysis-result-card-body">
+                <div className="position-roundtable-analysis-result-tag" aria-label={desensitize(item.agentName)}>
+                  <img
+                    src={ANALYSIS_RESULT_TAG_ICONS[index % ANALYSIS_RESULT_TAG_ICONS.length]}
+                    alt=""
+                    aria-hidden="true"
+                  />
+                  <span>{desensitize(item.agentName)}</span>
                 </div>
-                <footer className="mt-4 flex items-center justify-between border-t pt-3 text-[11px] text-muted-foreground">
-                  <span className="flex items-center gap-1.5">
-                    <BriefcaseBusiness className="size-3.5" />
+                <p className="position-roundtable-analysis-result-product">
+                  {desensitize(displayedProductName)}
+                </p>
+                <footer className="position-roundtable-analysis-result-meta">
+                  <span>
+                    <img src={responsibilityIcon} alt="" aria-hidden="true" />
                     {resultPositionName(item.positionId)}
                   </span>
-                  <span className="flex items-center gap-1.5">
-                    <Clock3 className="size-3.5" />
+                  <i aria-hidden="true" />
+                  <span>
+                    <img src={resultTimeIcon} alt="" aria-hidden="true" />
                     {displayedTime}
                   </span>
                 </footer>
@@ -5799,11 +6593,7 @@ function AnalysisResults({
                 key={item.id}
                 type="button"
                 onClick={() => openDetail(item)}
-                className={cn(
-                  "w-full rounded-xl border border-slate-200 bg-card p-3.5 text-left shadow-sm transition hover:border-primary/45 hover:shadow-md dark:border-border",
-                  item.node.status === "rejected" && "border-rose-200 bg-rose-50/60 dark:border-rose-500/35 dark:bg-rose-950/20",
-                  invalidated && "border-amber-200 bg-amber-50/60 dark:border-amber-500/35 dark:bg-amber-950/20",
-                )}
+                className="position-roundtable-analysis-result-card"
               >
                 {contents}
               </button>
@@ -5812,7 +6602,7 @@ function AnalysisResults({
                 key={item.id}
                 type="button"
                 onClick={() => openDetail(item)}
-                className="w-full rounded-xl border border-slate-200 bg-card p-3.5 text-left shadow-sm transition hover:border-primary/45 hover:shadow-md dark:border-border"
+                className="position-roundtable-analysis-result-card"
               >
                 {contents}
               </button>
diff --git a/frontend-web/src/position-roundtable/styles/intent-understanding.css b/frontend-web/src/position-roundtable/styles/intent-understanding.css
index 53b9df00..a06d790d 100644
--- a/frontend-web/src/position-roundtable/styles/intent-understanding.css
+++ b/frontend-web/src/position-roundtable/styles/intent-understanding.css
@@ -69,3 +69,1700 @@
 .position-roundtable-intent-model-switch {
   border-radius: var(--prt-intent-radius);
 }
+
+/* Pull the TDesign select chevron inward without changing the select width. */
+.position-roundtable-intent-model-switch .t-select__right-icon {
+  position: relative !important;
+  right: 10px !important;
+}
+
+/* Initial intent dialogue workspace: keep this panel independent from the
+   generic white/Tailwind chat treatment. */
+.position-roundtable-intent-workspace {
+  border-color: rgb(226 232 240);
+  border-radius: 4px;
+  background: #ffffff;
+}
+
+.dark .position-roundtable-intent-workspace {
+  border-color: rgba(0, 110, 254, 0.5);
+  border-radius: 4px;
+  background: #032650;
+}
+
+.dark .position-roundtable-intent-panel {
+  background: #032650;
+}
+
+.dark .position-roundtable-intent-panel > div:first-child {
+  position: relative;
+  z-index: 1;
+  box-sizing: border-box;
+  min-height: 48px;
+  padding: 0 18px;
+  border: 1px solid rgba(255, 255, 255, 0.2);
+  border-radius: 4px 4px 0 0;
+  background: linear-gradient(89.91deg, #0062d9 0%, rgba(0, 98, 217, 0) 100%);
+}
+
+.dark .position-roundtable-intent-panel > div:first-child::after {
+  position: absolute;
+  z-index: 3;
+  bottom: 0;
+  left: 0;
+  width: 100%;
+  height: 2px;
+  content: "";
+  background: linear-gradient(90deg, #45c3f3 0%, rgba(69, 195, 243, 0) 90.97%);
+  box-shadow: 0 2px 8px rgba(69, 195, 243, 0.9);
+  pointer-events: none;
+}
+
+.position-roundtable-intent-header-title {
+  display: flex;
+  min-width: 0;
+  align-items: center;
+  gap: 12px;
+}
+
+.position-roundtable-intent-header-title > span {
+  width: 4px;
+  height: 16px;
+  flex: 0 0 auto;
+  border-radius: 2px 0 2px 0;
+  background: linear-gradient(165.96deg, #a2e1f9 0%, #45c3f3 100%);
+}
+
+.position-roundtable-intent-header-title h2 {
+  margin: 0;
+  overflow: hidden;
+  color: #ffffff;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif;
+  font-size: 18px;
+  font-weight: 500;
+  line-height: 22px;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.position-roundtable-intent-header-actions {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+}
+
+.position-roundtable-intent-header-actions button {
+  display: inline-flex;
+  height: 28px;
+  align-items: center;
+  justify-content: center;
+  border: 0;
+  border-radius: 20px;
+  background: linear-gradient(104.68deg, rgba(0, 98, 217, 0.59) 4.02%, rgba(0, 98, 217, 0.3) 98.07%);
+  color: #ffffff;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif;
+  font-size: 16px;
+  font-weight: 300;
+  line-height: normal;
+  cursor: pointer;
+}
+
+.position-roundtable-intent-header-actions button:first-child { width: 116px; }
+.position-roundtable-intent-header-actions button:last-child { width: 100px; }
+.position-roundtable-intent-header-actions button:hover { filter: brightness(1.14); }
+.position-roundtable-intent-header-actions button:focus-visible {
+  outline: 2px solid #a2e1f9;
+  outline-offset: 2px;
+}
+
+.position-roundtable-intent-header-actions button.is-selected {
+  width: 116px;
+  height: 28px;
+  border-radius: 24px;
+  background: linear-gradient(103.57deg, #2b8ffe 0%, #0062d9 100%);
+  color: #ffffff;
+}
+
+.dark .position-roundtable-intent-panel > div:nth-child(2) > div:first-child {
+  position: relative;
+  z-index: 0;
+  background: #032650;
+}
+
+.position-roundtable-intent-empty-state {
+  display: flex;
+  width: 100%;
+  min-height: 100%;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  transform: translateY(-10px);
+}
+
+.position-roundtable-intent-empty-state img {
+  width: 96px;
+  height: 96px;
+}
+
+.position-roundtable-intent-empty-state h3 {
+  width: 120px;
+  height: 30px;
+  margin: 24px 0 18px;
+  color: #aaceff;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif;
+  font-size: 30px;
+  font-weight: 400;
+  line-height: 34px;
+  text-align: center;
+  white-space: nowrap;
+}
+
+.position-roundtable-intent-empty-state p {
+  width: min(641px, 100%);
+  height: 16px;
+  margin: 0;
+  color: #559ffe;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif;
+  font-size: 16px;
+  font-weight: 400;
+  line-height: 20px;
+  text-align: center;
+}
+
+.position-roundtable-intent-loading-state {
+  display: inline-flex;
+  min-width: 232px;
+  min-height: 96px;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  gap: 12px;
+  border: 1px solid rgba(43, 143, 254, 0.6);
+  border-radius: 4px;
+  background: rgba(0, 98, 217, 0.16);
+  color: #aaceff;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif;
+  font-size: 16px;
+  font-weight: 300;
+  line-height: 24px;
+}
+
+.position-roundtable-intent-loading-state svg { color: #45c3f3; }
+
+/* Confirmed-chain sidebar: the intent summary and CH progress share one
+   dedicated dark surface so the original entry/sidebar styles cannot bleed
+   into the post-confirmation view. */
+.position-roundtable-intent-delivery-sidebar {
+  box-sizing: border-box;
+  display: flex;
+  min-height: 0;
+  flex: 1 1 auto;
+  flex-direction: column;
+  gap: 12px;
+  overflow-y: auto;
+  border: 1px solid rgba(0, 110, 254, 0.5);
+  border-radius: 4px;
+  background: #032650;
+  color: #ffffff;
+}
+
+.position-roundtable-intent-delivery-sidebar::-webkit-scrollbar {
+  width: 5px !important;
+}
+
+/* The confirmed-chain result panel owns the visible left-pane scrollbar. Keep
+   the existing colors/radius while making the visible thumb about 3px wide. */
+.position-roundtable-intent-delivery-sidebar::-webkit-scrollbar-thumb {
+  border-top-width: 3px !important;
+  border-right-width: 1px !important;
+  border-bottom-width: 3px !important;
+  border-left-width: 1px !important;
+}
+
+.position-roundtable-intent-delivery-result {
+  flex: 0 0 auto;
+  overflow: hidden;
+  border-radius: 4px;
+}
+
+.position-roundtable-intent-delivery-header {
+  position: relative;
+  display: flex;
+  height: 44px;
+  box-sizing: border-box;
+  align-items: center;
+  gap: 12px;
+  padding: 0 16px;
+  border: 1px solid rgba(43, 143, 254, 0.6);
+  border-bottom: 0;
+  border-radius: 4px 4px 0 0;
+  background: #032650;
+}
+
+.position-roundtable-intent-delivery-header::after {
+  display: none;
+}
+
+.position-roundtable-intent-delivery-header > span {
+  width: 4px;
+  height: 16px;
+  flex: 0 0 auto;
+  border-radius: 2px 0 2px 0;
+  background: linear-gradient(165.96deg, #a2e1f9 0%, #45c3f3 100%);
+}
+
+.position-roundtable-intent-delivery-header h2 {
+  min-width: 0;
+  margin: 0;
+  overflow: hidden;
+  color: #ffffff;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif;
+  font-size: 18px;
+  font-weight: 500;
+  line-height: 22px;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.position-roundtable-intent-delivery-sections {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  padding: 12px;
+}
+
+.position-roundtable-intent-delivery-section {
+  box-sizing: border-box;
+  min-width: 0;
+  padding: 17px 14px 15px 24px;
+  border-radius: 4px;
+  color: #ffffff;
+}
+
+.position-roundtable-intent-delivery-section h3 {
+  margin: 0;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif;
+  font-size: 16px;
+  font-weight: 500;
+  line-height: 22px;
+}
+
+.position-roundtable-intent-delivery-section p,
+.position-roundtable-intent-delivery-section li {
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif;
+  font-size: 16px;
+  font-weight: 400;
+  line-height: 24px;
+}
+
+.position-roundtable-intent-delivery-section p {
+  margin: 10px 0 0;
+  overflow-wrap: anywhere;
+}
+
+.position-roundtable-intent-delivery-section ol,
+.position-roundtable-intent-delivery-section ul {
+  margin: 10px 0 0;
+  padding-left: 18px;
+}
+
+.position-roundtable-intent-delivery-section li + li {
+  margin-top: 7px;
+}
+
+.position-roundtable-intent-delivery-section--purpose {
+  border-left: 4px solid #ad7eff;
+  background: rgba(67, 70, 134, 0.39);
+}
+
+.position-roundtable-intent-delivery-section--purpose h3 {
+  color: #ad7eff;
+}
+
+.position-roundtable-intent-delivery-section--goals {
+  border-left: 4px solid #b5b000;
+  background: rgba(209, 219, 66, 0.07);
+}
+
+.position-roundtable-intent-delivery-section--goals h3 {
+  color: #d1db42;
+}
+
+.position-roundtable-intent-delivery-section--constraints {
+  border-left: 4px solid #33bc92;
+  background: rgba(20, 74, 102, 0.4);
+}
+
+.position-roundtable-intent-delivery-section--constraints h3 {
+  color: #33bc92;
+}
+
+.position-roundtable-intent-delivery-section--significance {
+  border-left: 4px solid #45c3f3;
+  background: rgba(0, 98, 217, 0.12);
+}
+
+.position-roundtable-intent-delivery-section--significance h3 {
+  color: #45c3f3;
+}
+
+.position-roundtable-intent-delivery-section .is-empty {
+  color: rgba(255, 255, 255, 0.62);
+}
+
+.position-roundtable-intent-delivery-flow {
+  height: 430px !important;
+  min-height: 430px;
+  flex: 0 0 430px !important;
+  margin: 0 12px 12px;
+  padding: 0 !important;
+  border: 0 !important;
+  border-radius: 0 !important;
+  background: transparent !important;
+  box-shadow: none !important;
+}
+
+.position-roundtable-intent-delivery-flow > div:first-child {
+  margin-bottom: 12px !important;
+}
+
+/* The special embedded agent configuration uses the surrounding panel as its
+   surface; keep the skills section itself transparent so it does not create a
+   second dark rectangle behind the list/empty state. */
+.position-roundtable-agent-detail--special .position-roundtable-skills-section {
+  background: transparent !important;
+}
+
+/* Position intent composer: the textarea is the only visible editor control;
+   stage actions remain available in code but stay out of this first-step layout. */
+.dark .position-roundtable-intent-composer {
+  box-sizing: border-box;
+  padding: 58px 18px 14px !important;
+  border-top: 0;
+  background: #032650 !important;
+}
+
+.dark .position-roundtable-intent-composer-frame {
+  box-sizing: border-box;
+  height: 100px;
+  overflow: visible !important;
+  border: 1px solid #0062d9 !important;
+  border-radius: 10px !important;
+  background: linear-gradient(93.87deg, rgba(0, 98, 217, 0.4) 0%, rgba(0, 98, 217, 0.1) 100%) !important;
+  backdrop-filter: blur(2px);
+  box-shadow: none !important;
+}
+
+.dark .position-roundtable-intent-textarea {
+  box-sizing: border-box;
+  height: 100px !important;
+  min-height: 100px !important;
+  max-height: 100px !important;
+  padding: 12px 54px 40px 16px !important;
+  background: transparent !important;
+  color: #ffffff !important;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif;
+  font-size: 16px;
+  line-height: 24px;
+}
+
+.dark .position-roundtable-intent-textarea::placeholder {
+  color: rgba(170, 206, 255, 0.62) !important;
+}
+
+.dark .position-roundtable-intent-toolbar {
+  position: absolute;
+  right: 12px;
+  bottom: 8px;
+  left: 12px;
+  z-index: 2;
+  height: 32px;
+  padding: 0 !important;
+  border: 0 !important;
+  background: transparent !important;
+}
+
+.dark .position-roundtable-intent-toolbar > div:first-child {
+  position: absolute;
+  top: -104px;
+  right: 0;
+  left: auto;
+  margin: 0;
+}
+
+.dark .position-roundtable-intent-upload-btn {
+  display: inline-flex;
+  width: 128px;
+  height: 32px;
+  align-items: center;
+  justify-content: center;
+  gap: 8px;
+  padding: 0;
+  border: 0;
+  border-radius: 33px;
+  background: linear-gradient(104.04deg, rgba(0, 98, 217, 0.6) 0%, rgba(0, 98, 217, 0.15) 100%);
+  color: #ffffff;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif;
+  font-size: 16px;
+  font-weight: 300;
+  line-height: 20px;
+  backdrop-filter: blur(2px);
+}
+
+.dark .position-roundtable-intent-upload-btn img {
+  width: 16px;
+  height: 16px;
+}
+
+.dark .position-roundtable-intent-actions {
+  position: absolute;
+  right: 0;
+  bottom: 0;
+  margin: 0;
+  gap: 0;
+}
+
+.dark .position-roundtable-intent-model-switch,
+.dark .position-roundtable-intent-actions #enter-roundtable-btn {
+  display: none !important;
+}
+
+.position-roundtable-intent-model-switch,
+.position-roundtable-intent-actions #enter-roundtable-btn {
+  display: none !important;
+}
+
+.dark .position-roundtable-intent-send-btn {
+  display: inline-flex;
+  width: 32px;
+  height: 32px;
+  align-items: center;
+  justify-content: center;
+  padding: 0;
+  border: 0;
+  border-radius: 6px;
+  background: linear-gradient(180deg, #2b8ffe 0%, #0062d9 100%) !important;
+  box-shadow: 0 3px 6px rgba(0, 135, 254, 0.24);
+}
+
+.dark .position-roundtable-intent-send-btn img {
+  width: 16px;
+  height: 16px;
+}
+
+@keyframes position-roundtable-intent-send-breathe {
+  0%,
+  100% {
+    transform: scale(1);
+    box-shadow: 0 3px 6px rgba(0, 135, 254, 0.24), 0 0 0 0 rgba(69, 195, 243, 0.32);
+  }
+
+  50% {
+    transform: scale(1.035);
+    box-shadow: 0 3px 8px rgba(0, 135, 254, 0.38), 0 0 0 7px rgba(69, 195, 243, 0);
+  }
+}
+
+.position-roundtable-intent-send-btn--stopping {
+  animation: position-roundtable-intent-send-breathe 3.8s ease-in-out infinite !important;
+  will-change: transform, box-shadow;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .position-roundtable-intent-send-btn--stopping {
+    animation: none;
+  }
+}
+
+/* The shared dark roundtable surface remaps Tailwind's `bg-white` with a
+   higher-specificity rule.  Keep the composer toolbar transparent so that
+   remapping cannot render a dark strip beside the send button. */
+:is(.dark .roundtable-planning, .roundtable-planning--dark)
+  .position-roundtable-intent-toolbar {
+  background: transparent !important;
+  background-color: transparent !important;
+  border-top-color: transparent !important;
+  box-shadow: none !important;
+}
+
+/* Match the legacy `bg-white` remapping selector more specifically.  The
+   toolbar still carries that utility class for the light theme, but it must
+   not become the dark card color in the roundtable composer. */
+:is(.dark .roundtable-planning, .roundtable-planning--dark)
+  .position-roundtable-intent-toolbar.bg-white {
+  background: transparent !important;
+  background-color: transparent !important;
+}
+
+/* Keep this one level more specific than the shared mapping even when that
+   stylesheet is loaded after the position-roundtable overrides. */
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-toolbar.bg-white {
+  background: transparent !important;
+  background-color: transparent !important;
+}
+
+/* 岗位会商第一步左侧栏：使用独立样式，避免与通用 Tailwind 面板规则相互覆盖。 */
+.dark .position-roundtable-task-card {
+  padding: 10px 15px !important;
+  background: #032650;
+  border-color: rgba(0, 110, 254, 0.5);
+}
+
+.dark .position-roundtable-task-card [data-task-description] {
+  color: #96bbf8 !important;
+}
+
+.dark .position-roundtable-chain-selector {
+  background: #032650;
+  border-color: rgba(0, 110, 254, 0.5);
+}
+
+/* First-step entry rail is a self-contained redraw; do not inherit legacy panel rules. */
+.dark .position-roundtable-sidebar-scrollbar:has(.position-roundtable-entry-sidebar) {
+  display: block;
+  overflow: hidden;
+  padding: 0;
+  background: transparent !important;
+}
+
+.position-roundtable-entry-sidebar {
+  display: flex;
+  height: 100%;
+  min-height: 0;
+  min-width: 0;
+  width: 100%;
+  flex-direction: column;
+  gap: 20px;
+  font-family: "Noto Sans SC", sans-serif;
+}
+
+.position-roundtable-entry-task-card,
+.position-roundtable-entry-chain-card {
+  align-self: stretch;
+  box-sizing: border-box;
+  min-width: 0;
+  width: 100%;
+  border: 1px solid rgba(0, 110, 254, 0.5);
+  border-radius: 4px;
+  background: #032650;
+}
+
+.position-roundtable-entry-task-card {
+  position: relative;
+  flex: none;
+  padding: 10px 15px;
+}
+
+.position-roundtable-entry-task-card h2 {
+  margin: 0;
+  overflow: hidden;
+  color: #fff;
+  font-size: 18px;
+  font-weight: 500;
+  line-height: 28px;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.position-roundtable-entry-tags {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 10px;
+  margin-top: 12px;
+}
+
+.position-roundtable-entry-tags span {
+  display: inline-flex;
+  box-sizing: border-box;
+  min-height: 28px;
+  align-items: center;
+  padding: 3px 8px;
+  border: 1px solid;
+  border-radius: 2px;
+  font-size: 16px;
+  font-weight: 300;
+  line-height: 20px;
+  white-space: nowrap;
+}
+
+.position-roundtable-entry-tags span:nth-child(1) { border-color: #cf1322; background: rgba(207, 19, 34, 0.5); color: #fff; }
+.position-roundtable-entry-tags span:nth-child(2) { border-color: #4bcdff; background: rgba(75, 205, 255, 0.3); color: #4bcdff; }
+.position-roundtable-entry-tags span:nth-child(3) { border-color: #a2e1f9; background: rgba(162, 225, 249, 0.3); color: #a2e1f9; }
+
+.position-roundtable-entry-task-card > p {
+  display: -webkit-box;
+  margin: 12px 0 0;
+  overflow: hidden;
+  color: #96bbf8;
+  color: #96bbf8 !important;
+  font-size: 16px;
+  line-height: 22px;
+  -webkit-box-orient: vertical;
+  -webkit-line-clamp: 3;
+}
+
+.position-roundtable-entry-edit { position: absolute; top: 8px; right: 8px; display: none; width: 16px; height: 16px; padding: 0; cursor: pointer; color: #4bcdff; }
+.position-roundtable-entry-edit img { display: block; width: 16px; height: 16px; }
+.position-roundtable-entry-task-card:hover .position-roundtable-entry-edit,
+.position-roundtable-entry-edit:focus-visible { display: inline-flex; }
+
+.position-roundtable-entry-chain-card { display: flex; min-height: 0; flex: 1; flex-direction: column; padding: 10px 15px; }
+.position-roundtable-entry-chain-card header { display: flex; height: 36px; flex: none; align-items: center; gap: 10px; }
+.position-roundtable-entry-chain-card header > span { width: 4px; height: 16px; border-radius: 2px 0 2px 0; background: linear-gradient(165.96deg, #a2e1f9 0%, #45c3f3 100%); }
+.position-roundtable-entry-chain-card h2 { margin: 0; color: #fff; font-size: 18px; font-weight: 500; line-height: 28px; }
+.position-roundtable-entry-chain-card header b { margin-left: auto; padding: 2px 9px; border-radius: 4px; background: #0b234c; color: #a2e1f9; font-size: 16px; line-height: 24px; }
+.position-roundtable-entry-chain-toolbar { display: flex; align-items: center; gap: 12px; margin-top: 12px; }
+.position-roundtable-entry-chain-search { position: relative; display: block; min-width: 0; flex: 1 1 auto; }
+.position-roundtable-entry-chain-search input { box-sizing: border-box; display: block; width: 100%; height: 38px; padding: 0 40px 0 14px; border: 1px solid rgba(43, 143, 254, 0.6); border-radius: 4px; outline: none; background: rgba(3, 38, 80, 0.6); color: rgba(255, 255, 255, 0.6); font-family: "Noto Sans SC", sans-serif; font-size: 16px; font-weight: 300; line-height: 22px; }
+.position-roundtable-entry-chain-search input::placeholder { color: rgba(255, 255, 255, 0.6); opacity: 1; }
+.position-roundtable-entry-chain-search input::-webkit-search-cancel-button { appearance: none; }
+.position-roundtable-entry-chain-search input:focus { border-color: #2b8ffe; box-shadow: 0 0 0 2px rgba(43, 143, 254, 0.18); }
+.position-roundtable-entry-chain-search img { position: absolute; top: 50%; right: 12px; width: 18px; height: 18px; transform: translateY(-50%); pointer-events: none; }
+.position-roundtable-entry-new-chain { display: inline-flex; height: 38px; flex: 0 0 auto; align-items: center; gap: 8px; padding: 0 16px; border: 0; border-radius: 4px; background: linear-gradient(102.88deg, #2b8ffe 0%, #0062d9 100%); color: #fff; font-family: "Noto Sans SC", sans-serif; font-size: 16px; font-weight: 300; line-height: 22px; cursor: pointer; transition: filter 160ms ease; }
+.position-roundtable-entry-new-chain:hover { filter: brightness(1.08); }
+.position-roundtable-entry-new-chain:focus-visible { outline: 2px solid #a2e1f9; outline-offset: 2px; }
+.position-roundtable-entry-new-chain img { width: 18px; height: 18px; flex: none; }
+.position-roundtable-entry-chain-list {
+  align-self: stretch;
+  position: relative;
+  box-sizing: border-box;
+  min-height: 0;
+  min-width: 0;
+  width: 100%;
+  flex: 1 1 auto;
+  margin-top: 10px;
+  overflow-x: hidden;
+  overflow-y: auto;
+}
+.position-roundtable-entry-chain-list article {
+  position: relative;
+  box-sizing: border-box;
+  min-width: 0;
+  width: 100%;
+  margin-bottom: 10px;
+  border: 1px solid rgba(43, 143, 254, 0.35);
+  border-radius: 4px;
+  background: rgba(11, 56, 109, 0.45);
+}
+.position-roundtable-entry-chain-list article.is-selected { border-color: #2b8ffe; background: rgba(43, 143, 254, 0.18); box-shadow: 0 0 0 1px rgba(43, 143, 254, 0.22); }
+.position-roundtable-entry-chain-list article > button:first-child { display: grid; width: 100%; grid-template-columns: 18px minmax(0, 1fr) auto; gap: 8px; padding: 14px; color: #d8e6f8; text-align: left; }
+.position-roundtable-entry-chain-list i { width: 14px; height: 14px; align-self: center; border: 4px solid #2b8ffe; border-radius: 50%; box-sizing: border-box; }
+.position-roundtable-entry-chain-list article:not(.is-selected) i { border: 1px solid #83b6ed; }
+.position-roundtable-entry-chain-list article > button:first-child > span { overflow: hidden; font-size: 16px; font-weight: 500; line-height: 22px; text-overflow: ellipsis; white-space: nowrap; }
+.position-roundtable-entry-chain-list em { border-radius: 16px; background: rgba(162, 225, 249, 0.16); padding: 2px 8px; color: #a2e1f9; font-size: 14px; font-style: normal; line-height: 20px; }
+.position-roundtable-entry-chain-list small { grid-column: 2 / 4; color: #96bbf8; font-size: 14px; line-height: 22px; }
+.position-roundtable-entry-config { position: absolute; top: 10px; right: 10px; display: inline-flex; padding: 4px; color: #83c1ff; }
+.position-roundtable-entry-empty { display: flex; min-height: 80px; align-items: center; justify-content: center; gap: 8px; color: #96bbf8; font-size: 14px; }
+
+.position-roundtable-entry-chain-list article.position-roundtable-entry-chain-item {
+  border-color: rgba(85, 166, 254, 0.1);
+  background: rgba(0, 98, 217, 0.1);
+  box-shadow: none;
+  transition: background 160ms ease, border-color 160ms ease;
+}
+.position-roundtable-entry-chain-list article.position-roundtable-entry-chain-item:hover,
+.position-roundtable-entry-chain-list article.position-roundtable-entry-chain-item.is-selected {
+  border-color: #0062d9;
+  background: rgba(0, 98, 217, 0.3);
+}
+.position-roundtable-entry-chain-list article.position-roundtable-entry-chain-item > button:first-child {
+  grid-template-columns: minmax(0, 1fr) auto;
+  padding: 14px 52px 14px 14px;
+}
+.position-roundtable-entry-chain-list article.position-roundtable-entry-chain-item i { display: none; }
+.position-roundtable-entry-chain-list article.position-roundtable-entry-chain-item > button:first-child > span {
+  color: #fff;
+  font-size: 18px;
+  font-weight: 500;
+  line-height: 24px;
+}
+.position-roundtable-entry-chain-list article.position-roundtable-entry-chain-item small {
+  display: -webkit-box;
+  grid-column: 1 / -1;
+  overflow: hidden;
+  color: #aaceff;
+  font-size: 16px;
+  line-height: 24px;
+  -webkit-box-orient: vertical;
+  -webkit-line-clamp: 2;
+}
+.position-roundtable-entry-chain-list article.position-roundtable-entry-chain-item .position-roundtable-entry-chain-seat-status {
+  color: #80b7ff !important;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif !important;
+  font-size: 16px !important;
+  font-weight: 300 !important;
+  line-height: 24px !important;
+}
+.position-roundtable-entry-chain-footer { display: flex; align-items: center; justify-content: space-between; gap: 12px; padding: 0 14px 14px; }
+.position-roundtable-entry-enter-chain { display: inline-flex; width: 80px; height: 28px; flex: 0 0 auto; align-items: center; justify-content: center; padding: 0; border: 0; border-radius: 4px; background: linear-gradient(109.29deg, #2b8ffe 0%, #0062d9 100%); color: #fff; font-family: "Noto Sans SC", sans-serif; font-size: 16px; font-weight: 400; line-height: 24px; cursor: pointer; transition: filter 160ms ease; }
+.position-roundtable-entry-enter-chain:hover { filter: brightness(1.08); }
+.position-roundtable-entry-enter-chain:focus-visible { outline: 2px solid #a2e1f9; outline-offset: 2px; }
+.position-roundtable-entry-chain-actions {
+  position: absolute;
+  top: 10px;
+  right: 12px;
+  z-index: 2;
+  width: 24px;
+  height: 24px;
+}
+.position-roundtable-entry-more { display: inline-flex; width: 24px; height: 24px; align-items: center; justify-content: center; padding: 0; border: 0; border-radius: 4px; background: transparent; cursor: pointer; }
+.position-roundtable-entry-more:hover,
+.position-roundtable-entry-more:focus-visible { background: rgba(85, 166, 254, 0.16); outline: none; }
+.position-roundtable-entry-more img { display: block; width: 18px; height: 18px; }
+.position-roundtable-entry-chain-menu {
+  position: fixed;
+  top: 0;
+  left: 0;
+  z-index: 1000;
+  width: 180px;
+  overflow: hidden;
+  border: 1px solid rgba(43, 143, 254, 0.6);
+  border-radius: 4px;
+  background: rgba(3, 38, 80, 0.98);
+  box-shadow: 0 8px 18px rgba(0, 0, 0, 0.24);
+}
+.position-roundtable-entry-chain-menu-item { display: flex; width: 100%; height: 44px; align-items: center; gap: 14px; padding: 0 16px; border: 0; background: transparent; color: #fff; font-family: "Noto Sans SC", sans-serif; font-size: 16px; line-height: 24px; text-align: left; cursor: pointer; }
+.position-roundtable-entry-chain-menu-item:hover,
+.position-roundtable-entry-chain-menu-item:focus-visible { background: rgba(0, 98, 217, 0.2); outline: none; }
+.position-roundtable-entry-chain-menu-item.is-edit { background: rgba(0, 98, 217, 0.2); }
+.position-roundtable-entry-chain-menu-item.is-delete { color: #fff; }
+.position-roundtable-entry-chain-menu-item img,
+.position-roundtable-entry-chain-menu-item svg { width: 18px; height: 18px; flex: none; }
+.position-roundtable-entry-chain-menu-item.is-delete svg { color: #aaceff; }
+
+/* roundtable-planning sets a 12px scrollbar globally; keep only this rail/list narrow. */
+.roundtable-planning .position-roundtable-sidebar-scrollbar::-webkit-scrollbar,
+.roundtable-planning .position-roundtable-sidebar-scrollbar .position-roundtable-entry-chain-list::-webkit-scrollbar {
+  width: 5px !important;
+}
+
+/* Keep the 5px hit area, but make the colored thumb itself narrower. The
+   existing top/bottom transparent borders preserve the thumb's length and
+   visual treatment; only the left/right inset changes its visible width. */
+.roundtable-planning .position-roundtable-sidebar-scrollbar::-webkit-scrollbar-thumb,
+.roundtable-planning .position-roundtable-sidebar-scrollbar .position-roundtable-entry-chain-list::-webkit-scrollbar-thumb {
+  border-top-width: 3px !important;
+  border-right-width: 1px !important;
+  border-bottom-width: 3px !important;
+  border-left-width: 1px !important;
+}
+
+/* Special agent configuration surface ------------------------------------- */
+.position-roundtable-agent-detail--special {
+  color: #ffffff;
+}
+
+.position-roundtable-agent-detail-container--special > div:first-child {
+  display: none !important;
+}
+
+.position-roundtable-agent-detail--special aside {
+  background: #032650 !important;
+  border-color: rgba(43, 143, 254, 0.45) !important;
+}
+
+.position-roundtable-agent-detail--special aside > div:first-child {
+  border-color: rgba(43, 143, 254, 0.25) !important;
+  background: #032650 !important;
+}
+
+.position-roundtable-agent-detail--special aside > div:last-child {
+  background: #032650 !important;
+}
+
+.position-roundtable-agent-detail--special aside > div:last-child > div {
+  gap: 12px !important;
+  padding: 12px !important;
+}
+
+.position-roundtable-agent-detail--special aside
+  > div:last-child
+  > div
+  > section:first-child {
+  padding: 14px !important;
+  border: 0 !important;
+  border-radius: 4px !important;
+  background: rgba(0, 12, 28, 0.2) !important;
+}
+
+.position-roundtable-agent-detail--special .agent-avatar {
+  width: 48px !important;
+  height: 48px !important;
+  border: 1px solid #007e82 !important;
+  border-radius: 8px !important;
+  background: #00306a !important;
+  box-shadow: none !important;
+  outline: none !important;
+}
+
+.position-roundtable-agent-detail--special .agent-avatar img {
+  width: 36px !important;
+  height: 36px !important;
+}
+
+.position-roundtable-agent-detail--special .agent-avatar + div > div:first-child {
+  color: #ffffff !important;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif !important;
+  font-size: 18px !important;
+  font-weight: 500 !important;
+  line-height: 24px !important;
+}
+
+.position-roundtable-agent-detail--special .position-agent-role {
+  color: #ffffff !important;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif !important;
+  font-size: 16px !important;
+  font-weight: 300 !important;
+  line-height: 24px !important;
+}
+
+.position-roundtable-agent-detail--special aside
+  > div:last-child
+  > div
+  > section:first-child
+  p {
+  color: rgba(255, 255, 255, 0.8) !important;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif !important;
+  font-size: 16px !important;
+  font-weight: 300 !important;
+  line-height: 24px !important;
+}
+
+.position-roundtable-agent-detail--special aside
+  > div:last-child
+  > div
+  > section:has(h4 img) {
+  padding: 0 !important;
+  border: 0 !important;
+  border-radius: 4px !important;
+  background: transparent !important;
+}
+
+.position-roundtable-agent-detail--special aside
+  > div:last-child
+  > div
+  > section:has(h4 img) > div:first-child {
+  margin-bottom: 10px !important;
+  padding: 0 2px !important;
+}
+
+.position-roundtable-agent-detail--special aside
+  > div:last-child
+  > div
+  > section:has(h4 img) h4 {
+  color: #ffffff !important;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif !important;
+  font-size: 18px !important;
+  font-weight: 500 !important;
+  line-height: 24px !important;
+}
+
+.position-roundtable-agent-detail--special aside
+  > div:last-child
+  > div
+  > section:has(h4 img) h4 img {
+  width: 13px;
+  height: 11px;
+}
+
+.position-roundtable-agent-detail--special
+  [class~="group/skill"] {
+  border-radius: 4px !important;
+  border-color: rgba(43, 143, 254, 0.35) !important;
+  background: rgba(0, 98, 217, 0.1) !important;
+}
+
+.position-roundtable-agent-detail--special
+  [class~="group/skill"]
+  [title] {
+  color: #ffffff !important;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif !important;
+  font-size: 18px !important;
+  line-height: 24px !important;
+}
+
+.position-roundtable-agent-detail--special
+  [class~="group/skill"]
+  p {
+  color: #aaceff !important;
+  font-size: 14px !important;
+  line-height: 22px !important;
+}
+
+.position-roundtable-agent-detail--special
+  aside
+  > div:last-child
+  > div
+  > section:not(:first-child) {
+  border-color: rgba(43, 143, 254, 0.35) !important;
+  border-radius: 4px !important;
+  background: rgba(0, 12, 28, 0.2) !important;
+}
+
+.position-roundtable-agent-detail--special
+  aside
+  > div:last-child
+  > div
+  > section:has(h4 img) {
+  border-color: transparent !important;
+  background: transparent !important;
+}
+
+/* Intent workspace configuration is a second pane of the same workbench,
+   rather than an independent floating card.  Every selector remains scoped
+   to the position-roundtable intent route. */
+.position-roundtable-intent-workspace {
+  transition: border-radius 260ms cubic-bezier(0.22, 1, 0.36, 1),
+    border-color 260ms cubic-bezier(0.22, 1, 0.36, 1);
+}
+
+.position-roundtable-intent-config-pane {
+  /* Keep the configuration column exactly aligned with the 360px left rail. */
+  --prt-intent-config-width: 360px;
+  position: relative;
+  z-index: 4;
+  display: flex;
+  width: 0;
+  min-width: 0;
+  flex: 0 0 auto;
+  align-self: stretch;
+  box-sizing: border-box;
+  margin-left: 0;
+  overflow: hidden;
+  border: 0 solid transparent;
+  border-radius: 0;
+  background: #032650;
+  opacity: 0;
+  pointer-events: none;
+  transform: translateX(16px);
+  transition: width 260ms cubic-bezier(0.22, 1, 0.36, 1),
+    opacity 180ms ease-out,
+    transform 260ms cubic-bezier(0.22, 1, 0.36, 1),
+    border-color 180ms ease-out;
+}
+
+.position-roundtable-intent-config-pane.is-open {
+  width: var(--prt-intent-config-width) !important;
+  flex-basis: var(--prt-intent-config-width) !important;
+  max-width: var(--prt-intent-config-width);
+  border-left-width: 1px;
+  border-left-color: rgba(0, 110, 254, 0.5);
+  opacity: 1;
+  pointer-events: auto;
+  transform: translateX(0);
+}
+
+.position-roundtable-intent-config-pane-inner {
+  width: var(--prt-intent-config-width) !important;
+  max-width: var(--prt-intent-config-width);
+  min-width: 0;
+  height: 100%;
+}
+
+.position-roundtable-intent-config-workspace,
+.position-roundtable-intent-analysis-results {
+  width: 100%;
+  height: 100%;
+  min-height: 0;
+}
+
+.position-roundtable-intent-analysis-results {
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+}
+
+.position-roundtable-intent-analysis-header {
+  display: flex;
+  height: 48px;
+  flex: 0 0 48px;
+  align-items: center;
+  justify-content: space-between;
+  padding: 0 12px;
+  border-bottom: 1px solid rgba(43, 143, 254, 0.35);
+  background: #032650;
+}
+
+.position-roundtable-intent-analysis-header > span {
+  display: inline-flex;
+  align-items: center;
+  gap: 10px;
+  color: #ffffff;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif;
+  font-size: 18px;
+  font-weight: 500;
+  line-height: 24px;
+}
+
+.position-roundtable-intent-analysis-header > span::before {
+  width: 4px;
+  height: 16px;
+  flex: 0 0 auto;
+  border-radius: 2px 0 2px 0;
+  background: linear-gradient(165.96deg, #a2e1f9 0%, #45c3f3 100%);
+  content: "";
+}
+
+.position-roundtable-intent-analysis-results-scroll {
+  min-height: 0;
+  flex: 1 1 auto;
+  overflow-y: auto;
+}
+
+.position-roundtable-analysis-result-card {
+  position: relative;
+  display: block;
+  width: 100%;
+  min-height: 102px;
+  box-sizing: border-box;
+  padding: 40px 12px 12px;
+  border: 1px solid rgba(85, 166, 254, 0.1);
+  border-radius: 4px;
+  background: rgba(0, 98, 217, 0.1);
+  color: #ffffff;
+  text-align: left;
+  cursor: pointer;
+  transition: background 160ms ease, border-color 160ms ease, box-shadow 160ms ease;
+}
+
+.position-roundtable-analysis-result-card:hover,
+.position-roundtable-analysis-result-card:focus-visible {
+  border-color: #0062d9;
+  background: rgba(0, 98, 217, 0.3);
+  box-shadow: 0 4px 14px rgba(0, 44, 110, 0.18);
+  outline: none;
+}
+
+.position-roundtable-analysis-result-card-body {
+  position: relative;
+  min-width: 0;
+}
+
+.position-roundtable-analysis-result-tag {
+  position: absolute;
+  top: -40px;
+  left: -12px;
+  display: inline-flex;
+  width: max-content;
+  min-width: 95px;
+  max-width: calc(100% - 12px);
+  height: 26px;
+  align-items: center;
+  overflow: hidden;
+  box-sizing: border-box;
+  color: #ffffff;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif;
+  font-size: 16px;
+  line-height: normal;
+  white-space: nowrap;
+}
+
+.position-roundtable-analysis-result-tag img {
+  position: absolute;
+  inset: 0 auto auto 0;
+  z-index: 0;
+  width: 100%;
+  height: 26px;
+}
+
+.position-roundtable-analysis-result-tag span {
+  position: relative;
+  z-index: 1;
+  box-sizing: border-box;
+  min-width: 0;
+  max-width: 100%;
+  overflow: hidden;
+  padding: 0 12px;
+  text-overflow: ellipsis;
+}
+
+.position-roundtable-analysis-result-product {
+  margin: 0;
+  overflow: hidden;
+  color: #ffffff;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif;
+  font-size: 18px;
+  font-weight: 500;
+  line-height: 24px;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.position-roundtable-analysis-result-meta {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  margin-top: 6px;
+  color: #80b7ff;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif;
+  font-size: 16px;
+  font-weight: 300;
+  line-height: 24px;
+}
+
+.position-roundtable-analysis-result-meta span {
+  display: inline-flex;
+  min-width: 0;
+  align-items: center;
+  gap: 5px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.position-roundtable-analysis-result-meta img {
+  width: 16px;
+  height: 16px;
+  flex: 0 0 auto;
+}
+
+.position-roundtable-analysis-result-meta i {
+  width: 1px;
+  height: 14px;
+  flex: 0 0 auto;
+  background: rgba(128, 183, 255, 0.45);
+}
+
+.position-roundtable-analysis-results-empty {
+  color: #80b7ff;
+}
+
+.position-roundtable-agent-detail--special {
+  height: 100%;
+}
+
+.position-roundtable-agent-detail--special aside {
+  border-left: 0 !important;
+  background: #032650 !important;
+}
+
+.position-roundtable-agent-detail--special aside > div:first-child {
+  position: relative;
+  min-height: 48px;
+  padding: 0 12px !important;
+  border-color: rgba(43, 143, 254, 0.35) !important;
+  background: #032650 !important;
+}
+
+.position-roundtable-agent-detail--special aside > div:first-child > span {
+  display: inline-flex;
+  align-items: center;
+  gap: 10px;
+  color: #ffffff;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif;
+  font-size: 18px;
+  font-weight: 500;
+  line-height: 24px;
+}
+
+.position-roundtable-agent-detail--special aside > div:first-child > span::before {
+  width: 4px;
+  height: 16px;
+  flex: 0 0 auto;
+  border-radius: 2px 0 2px 0;
+  background: linear-gradient(165.96deg, #a2e1f9 0%, #45c3f3 100%);
+  content: "";
+}
+
+.position-roundtable-agent-detail--special aside > div:first-child button {
+  color: #a2e1f9 !important;
+  cursor: pointer;
+}
+
+.position-roundtable-agent-detail--special aside > div:first-child button img {
+  display: block;
+  width: 18px;
+  height: 18px;
+}
+
+.position-roundtable-intent-config-collapse-btn {
+  display: inline-flex;
+  width: 28px;
+  height: 28px;
+  align-items: center;
+  justify-content: center;
+  padding: 0;
+  border: 0;
+  border-radius: 4px;
+  background: transparent;
+  cursor: pointer;
+}
+
+.position-roundtable-intent-config-collapse-btn:hover,
+.position-roundtable-intent-config-collapse-btn:focus-visible {
+  background: rgba(0, 98, 217, 0.2);
+  outline: none;
+}
+
+.position-roundtable-intent-config-collapse-btn:focus-visible {
+  box-shadow: 0 0 0 2px rgba(162, 225, 249, 0.6);
+}
+
+.position-roundtable-intent-config-collapse-btn img {
+  display: block;
+  width: 13px !important;
+  height: 11px !important;
+}
+
+.position-roundtable-agent-detail--special aside > div:last-child > div {
+  gap: 12px !important;
+  padding: 12px !important;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .position-roundtable-intent-workspace,
+  .position-roundtable-intent-config-pane {
+    transition: none !important;
+  }
+}
+
+/* Composer action row ------------------------------------------------------ */
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-toolbar {
+  position: absolute !important;
+  /* The recommendation/upload row owns the same full width as the frame. */
+  right: 0 !important;
+  top: -44px !important;
+  bottom: auto !important;
+  left: 0 !important;
+  width: auto !important;
+  z-index: 3 !important;
+  display: flex !important;
+  height: 32px !important;
+  min-height: 32px !important;
+  flex-wrap: nowrap !important;
+  align-items: center !important;
+  gap: 8px !important;
+  padding: 0 !important;
+  border: 0 !important;
+  background: transparent !important;
+  background-color: transparent !important;
+  box-shadow: none !important;
+}
+
+.position-roundtable-node-composer {
+  width: 100%;
+  background: transparent !important;
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-toolbar > div:first-child {
+  position: static !important;
+  top: auto !important;
+  right: auto !important;
+  bottom: auto !important;
+  left: auto !important;
+  margin: 0 !important;
+  }
+
+/* Keep a stable left slot in the flex row.  It may contain recommended
+   questions, but it must still exist when there are no questions so the
+   right-side action group never becomes the first flex child. */
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-common-slot {
+  display: flex !important;
+  min-width: 0 !important;
+  flex: 1 1 auto !important;
+  align-items: center !important;
+  margin: 0 !important;
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-toolbar
+  > .position-roundtable-intent-actions {
+  position: absolute !important;
+  top: 0 !important;
+  right: 0 !important;
+  bottom: auto !important;
+  left: auto !important;
+  margin: 0 !important;
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+.position-roundtable-intent-model-switch {
+  display: inline-flex !important;
+  width: 188px;
+  height: 32px;
+  flex: 0 0 188px;
+  order: 2;
+  position: absolute !important;
+  top: 104px;
+  right: 58px;
+  z-index: 3;
+  align-items: center;
+  gap: 6px;
+  padding: 0 10px;
+  border: 1px solid rgba(43, 143, 254, 0.6) !important;
+  border-radius: 4px !important;
+  background: rgba(3, 38, 80, 0.6) !important;
+  color: #dceaff;
+  box-shadow: none;
+  backdrop-filter: blur(10px);
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-common-questions {
+  display: flex;
+  min-width: 0;
+  max-width: 100%;
+  flex: 0 1 auto;
+  align-items: center;
+  gap: 8px;
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-common-question {
+  display: inline-flex;
+  max-width: 260px;
+  height: 32px;
+  min-width: 0;
+  flex: 0 1 auto;
+  align-items: center;
+  gap: 8px;
+  padding: 0 12px;
+  overflow: hidden;
+  border: 1px solid rgba(43, 143, 254, 0.6);
+  border-radius: 10px;
+  background: rgba(3, 38, 80, 0.6);
+  color: #ffffff;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif;
+  font-size: 16px;
+  font-weight: 400;
+  line-height: 24px;
+  text-align: left;
+  cursor: pointer;
+  backdrop-filter: blur(10px);
+  transition: background 160ms ease, border-color 160ms ease;
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-common-question:hover,
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-common-question:focus-visible {
+  border-color: #45c3f3;
+  background: rgba(0, 98, 217, 0.32);
+  outline: none;
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-common-question > span:last-child {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-common-question > span:first-child {
+  width: 5px;
+  height: 5px;
+  flex: 0 0 5px;
+  border-radius: 5px;
+  background: #45c3f3;
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-common-more {
+  position: relative;
+  display: inline-flex;
+  flex: 0 0 auto;
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-common-more-button {
+  display: inline-flex;
+  width: 32px;
+  height: 32px;
+  align-items: center;
+  justify-content: center;
+  padding: 0;
+  border: 1px solid rgba(43, 143, 254, 0.6);
+  border-radius: 10px;
+  background: rgba(3, 38, 80, 0.6);
+  cursor: pointer;
+  backdrop-filter: blur(10px);
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-common-more-button:hover,
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-common-more-button:focus-visible {
+  border-color: #45c3f3;
+  background: rgba(0, 98, 217, 0.32);
+  outline: none;
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-common-more-button img {
+  display: block;
+  width: 16px;
+  height: 16px;
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-common-more-menu {
+  position: absolute;
+  right: 0;
+  bottom: calc(100% + 8px);
+  z-index: 20;
+  display: flex;
+  min-width: 220px;
+  max-width: 320px;
+  flex-direction: column;
+  gap: 2px;
+  padding: 6px;
+  border: 1px solid rgba(43, 143, 254, 0.6);
+  border-radius: 6px;
+  background: rgba(3, 38, 80, 0.96);
+  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.28);
+  backdrop-filter: blur(10px);
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-common-more-menu button {
+  min-width: 0;
+  padding: 7px 9px;
+  border: 0;
+  border-radius: 4px;
+  background: transparent;
+  color: #ffffff;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif;
+  font-size: 14px;
+  line-height: 22px;
+  text-align: left;
+  cursor: pointer;
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-common-more-menu button:hover,
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-common-more-menu button:focus-visible {
+  background: rgba(0, 98, 217, 0.32);
+  outline: none;
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-file-cards {
+  min-width: 0 !important;
+  flex: 1 1 auto !important;
+  align-self: center;
+  scrollbar-width: none;
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-file-cards::-webkit-scrollbar {
+  display: none;
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-actions {
+  position: static !important;
+  right: auto !important;
+  bottom: auto !important;
+  display: flex !important;
+  min-width: 0 !important;
+  flex: 0 0 auto !important;
+  flex-wrap: nowrap !important;
+  align-items: center !important;
+  justify-content: flex-end !important;
+  gap: 8px !important;
+  margin-left: auto !important;
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-actions #enter-roundtable-btn {
+  display: inline-flex !important;
+  order: 0;
+  height: 32px;
+  min-width: 168px;
+  align-items: center;
+  justify-content: center;
+  padding: 0 14px;
+  border: 1px solid rgba(162, 225, 249, 0.45);
+  border-radius: 24px;
+  background: linear-gradient(103.57deg, #2b8ffe 0%, #0062d9 100%) !important;
+  color: #ffffff !important;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif;
+  font-size: 14px;
+  font-weight: 500;
+  line-height: 20px;
+  cursor: pointer;
+  box-shadow: 0 3px 8px rgba(0, 98, 217, 0.24);
+  transition: filter 160ms ease, opacity 160ms ease;
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-actions #enter-roundtable-btn:hover:not(:disabled),
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-actions #enter-roundtable-btn:focus-visible {
+  filter: brightness(1.12);
+  outline: 2px solid rgba(162, 225, 249, 0.75);
+  outline-offset: 2px;
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-actions #enter-roundtable-btn:disabled {
+  cursor: not-allowed;
+  opacity: 0.52;
+  box-shadow: none;
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-upload-wrap {
+  order: 1;
+  flex: 0 0 auto;
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-upload-btn {
+  display: inline-flex;
+  width: 128px;
+  height: 32px;
+  align-items: center;
+  justify-content: center;
+  gap: 8px;
+  padding: 0;
+  border: 0 !important;
+  border-radius: 24px !important;
+  background: linear-gradient(104.04deg, rgba(0, 98, 217, 0.6) 0%, rgba(0, 98, 217, 0.15) 100%) !important;
+  color: #ffffff !important;
+  font-family: "Noto Sans S Chinese", "Noto Sans SC", sans-serif;
+  font-size: 16px;
+  font-weight: 300;
+  line-height: 20px;
+  cursor: pointer;
+  backdrop-filter: blur(2px);
+  transition: background 160ms ease, filter 160ms ease;
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-upload-btn:hover,
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-upload-btn:focus-visible,
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-upload-btn:active {
+  background: linear-gradient(103.57deg, #2b8ffe 0%, #0062d9 100%) !important;
+  border-radius: 24px !important;
+  filter: brightness(1.06);
+  outline: none;
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-actions #send-message-btn {
+  position: absolute !important;
+  top: 104px !important;
+  right: 14px !important;
+  order: 3;
+}
+
+:is(
+    .dark .roundtable-planning.roundtable-planning,
+    .roundtable-planning--dark.roundtable-planning
+  )
+  .position-roundtable-intent-actions
+  :is(#suggest-followup-btn, #skip-question-btn, #save-draft-btn) {
+  order: 4;
+}
diff --git a/frontend-web/src/roundtable-planning/api/intent.ts b/frontend-web/src/roundtable-planning/api/intent.ts
index 73f5806e..f563a21d 100644
--- a/frontend-web/src/roundtable-planning/api/intent.ts
+++ b/frontend-web/src/roundtable-planning/api/intent.ts
@@ -4,9 +4,15 @@ import { getBackendBaseURL } from "@/core/config";
 import type { ClarificationPayload } from "./multi-agent";
 import { reportRoundtableError } from "./diagnostics-report";
 import { resolveAllowMultiple } from "@/roundtable-planning/lib/clarification";
+import { normalizeIntentReadySummary } from "@/roundtable-planning/lib/roundtable-constants";
 
 export type { ClarificationPayload };
 
+/** Stable built-in agent used by the multi-agent roundtable Step 1 flow. */
+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";
+
 /**
  * Task-intent agent (Step 1) API. Mirror of multi-agent.ts but with a single
  * built-in agent and no per-call coordinator: one /init creates a thread
@@ -100,13 +106,18 @@ function parseIntentErrorDetail(value: unknown): IntentErrorDetail | null {
 export async function initIntent(
   model?: string,
   taskContext?: Record<string, unknown> | null,
+  intentAgentId?: string,
 ): Promise<IntentInitResponse> {
   const res = await apiFetch(`${getBackendBaseURL()}/api/intent/init`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     // 岗位会商在创建意图线程时就写入父任务标识。这样即使用户尚未确认
     // 业务链，第一阶段的对话也已经可以按 taskId 恢复。
-    body: JSON.stringify({ model, task_context: taskContext ?? undefined }),
+    body: JSON.stringify({
+      model,
+      task_context: taskContext ?? undefined,
+      intent_agent_id: intentAgentId || undefined,
+    }),
   });
   if (!res.ok) {
     const raw = await res.text().catch(() => "");
@@ -137,6 +148,19 @@ export interface IntentSummary {
   constraints: string[];
   /** Optional assumptions the agent is making on the user's behalf. */
   assumptions?: string[];
+  /** Present only for the dedicated position-roundtable intent agent. */
+  coreGoals?: string[];
+  riskWarnings?: string[];
+  keyPoints?: string[];
+  strategicSignificance?: string[];
+}
+
+/** Final hand-off shape emitted only by the position-roundtable intent agent. */
+export interface PositionIntentSummary {
+  coreGoals: string[];
+  riskWarnings: string[];
+  keyPoints: string[];
+  strategicSignificance: string[];
 }
 
 /**
@@ -164,6 +188,8 @@ export interface StreamIntentRequest {
   threadId: string;
   message: string;
   model?: string;
+  /** Explicit built-in Step-1 agent. Omit to retain the multi-agent default. */
+  intentAgentId?: string;
   /** Optional hidden business/task context injected into the model run. */
   taskContext?: Record<string, unknown> | null;
   /** Step 1 用户上传的参考文件（可选）。 */
@@ -186,8 +212,7 @@ export interface StreamIntentRequest {
    * Fires for every `ask_clarification` tool message parsed out of the live
    * stream (the intent agent may emit several in a single turn). Lets the UI
    * surface each assistance question in real-time instead of waiting for the
-   * terminal frame — which only carries the *first* question. `index` is the
-   * 0-based arrival order within this turn.
+   * terminal frame. `index` is the 0-based arrival order within this turn.
    */
   onClarification?: (clarification: ClarificationPayload, index: number) => void;
 }
@@ -208,8 +233,8 @@ export interface StreamIntentResult {
   clarification: ClarificationPayload | null;
   /**
    * All `ask_clarification` questions the agent asked this turn, in arrival
-   * order. Collected from the live `type:"tool"` frames (the terminal frame
-   * only carries the first). Empty unless status === "clarification".
+   * order. Collected live and reconciled against the terminal frame so a
+   * reconnect cannot lose cards. Empty unless status === "clarification".
    */
   clarifications: ClarificationPayload[];
   /**
@@ -235,6 +260,7 @@ function isFinalIntentFrame(value: unknown): value is {
   options?: unknown[];
   allow_custom?: boolean;
   allow_multiple?: boolean;
+  clarifications?: unknown[];
   error_detail?: unknown;
 } {
   if (!value || typeof value !== "object") return false;
@@ -327,6 +353,41 @@ function extractClarificationToolMessage(
   };
 }
 
+/**
+ * Normalize one clarification included in the terminal status frame. This is
+ * the reconnect / proxy fallback for cases where one or more live `tool`
+ * frames were not delivered to the browser.
+ */
+function parseTerminalClarification(
+  value: unknown,
+): { payload: ClarificationPayload; toolCallId: string } | null {
+  if (!value || typeof value !== "object") return null;
+  const raw = value as Record<string, unknown>;
+  const clarificationType =
+    typeof raw.clarification_type === "string" ? raw.clarification_type : "";
+  const toolCallId = typeof raw.id === "string" ? raw.id : "";
+  return {
+    toolCallId,
+    payload: {
+      id: toolCallId || undefined,
+      question: typeof raw.question === "string" ? raw.question : "",
+      clarificationType,
+      context:
+        typeof raw.clarification_context === "string"
+          ? raw.clarification_context
+          : typeof raw.context === "string"
+            ? raw.context
+            : "",
+      options: Array.isArray(raw.options) ? raw.options : [],
+      allowCustom: raw.allow_custom !== false,
+      allowMultiple: resolveAllowMultiple(
+        typeof raw.allow_multiple === "boolean" ? raw.allow_multiple : undefined,
+        clarificationType,
+      ),
+    },
+  };
+}
+
 /**
  * Open an SSE connection to /api/intent/stream and resolve when the upstream
  * stream completes. Each call is one user turn; reuse the same threadId
@@ -340,6 +401,7 @@ export async function streamIntent(req: StreamIntentRequest): Promise<StreamInte
       thread_id: req.threadId,
       message: req.message,
       model: req.model,
+      intent_agent_id: req.intentAgentId || undefined,
       task_context: req.taskContext ?? undefined,
       // 仅在有文件时带上，空数组后端也安全忽略。
       files: req.files && req.files.length > 0 ? req.files : undefined,
@@ -387,8 +449,7 @@ export async function streamIntent(req: StreamIntentRequest): Promise<StreamInte
   };
 
   // Clarifications collected live from `type:"tool"` frames, deduped by
-  // tool_call_id. The terminal frame only carries the first question, so this
-  // is the source of truth for multi-question turns.
+  // tool_call_id, then reconciled against the complete terminal list.
   const seenClarificationIds = new Set<string>();
   const collectClarification = (payload: ClarificationPayload, toolCallId: string) => {
     const dedupeKey = toolCallId || `idx-${result.clarifications.length}`;
@@ -435,7 +496,7 @@ export async function streamIntent(req: StreamIntentRequest): Promise<StreamInte
         result.status = parsed.status;
         if (typeof parsed.content === "string") result.content = parsed.content;
         if (parsed.summary && typeof parsed.summary === "object") {
-          result.summary = parsed.summary as IntentSummary;
+          result.summary = normalizeIntentReadySummary(parsed.summary);
         }
         if (parsed.status === "error") {
           result.errorDetail = parseIntentErrorDetail(parsed.error_detail);
@@ -445,28 +506,26 @@ export async function streamIntent(req: StreamIntentRequest): Promise<StreamInte
             detail: result.errorDetail,
           });
         }
-        if (parsed.status === "clarification" && result.clarifications.length === 0) {
-          // Fallback path: no live `type:"tool"` clarification frames were seen
-          // (older backend, or single-question turn) — synthesize one from the
-          // terminal frame so the UI still gets a card. When tool frames *were*
-          // seen, `clarifications` already holds the full (possibly multi-question)
-          // set and we keep it.
-          const clarificationType =
-            typeof parsed.clarification_type === "string" ? parsed.clarification_type : "";
-          const fallback: ClarificationPayload = {
-            question: typeof parsed.question === "string" ? parsed.question : "",
-            clarificationType,
-            context:
-              typeof parsed.clarification_context === "string" ? parsed.clarification_context : "",
-            options: Array.isArray(parsed.options) ? parsed.options : [],
-            allowCustom: parsed.allow_custom !== false,
-            allowMultiple: resolveAllowMultiple(
-              typeof parsed.allow_multiple === "boolean" ? parsed.allow_multiple : undefined,
-              clarificationType,
-            ),
-          };
-          result.clarification = fallback;
-          result.clarifications = [fallback];
+        if (parsed.status === "clarification") {
+          // Newer backend frames contain every card. Merge them even when a
+          // subset already arrived live: an SSE reconnect can otherwise leave
+          // the user with only the first card in a multi-question assistance
+          // round. Older backends still fall back to the legacy top-level card.
+          const terminalCards = Array.isArray(parsed.clarifications)
+            ? parsed.clarifications
+                .map(parseTerminalClarification)
+                .filter((item): item is { payload: ClarificationPayload; toolCallId: string } => item !== null)
+            : [];
+          if (terminalCards.length > 0) {
+            terminalCards.forEach((card, index) => {
+              collectClarification(card.payload, card.toolCallId || `terminal-${index}`);
+            });
+          } else if (result.clarifications.length === 0) {
+            const fallback = parseTerminalClarification(parsed);
+            if (fallback) {
+              collectClarification(fallback.payload, fallback.toolCallId || "terminal-0");
+            }
+          }
         }
         continue;
       }
diff --git a/frontend-web/src/roundtable-planning/components/BusinessChainPicker.tsx b/frontend-web/src/roundtable-planning/components/BusinessChainPicker.tsx
index dbdfcc4a..11498d84 100644
--- a/frontend-web/src/roundtable-planning/components/BusinessChainPicker.tsx
+++ b/frontend-web/src/roundtable-planning/components/BusinessChainPicker.tsx
@@ -153,6 +153,10 @@ export function BusinessChainPicker({
     // 席位「会商技能识别强化」开关（链条配置）：按 agent_id 取，缺省 = 关。
     const skillById = new Map(selectedChain.seats.map((s) => [s.agent_id, s.seat_skill_directive ?? false]));
     const skillOf = (id: string) => skillById.get(id) ?? false;
+    const humanValidationById = new Map(
+      selectedChain.seats.map((s) => [s.agent_id, s.human_validation ?? false]),
+    );
+    const humanValidationOf = (id: string) => humanValidationById.get(id) ?? false;
     // 席位「推理深度覆盖」（链条配置 seat_mode）：按 agent_id 取，null/缺省 = 跟随链条级 seatMode。
     const seatModeById = new Map(selectedChain.seats.map((s) => [s.agent_id, s.seat_mode ?? null]));
     const seatModeOf = (id: string) => seatModeById.get(id) ?? null;
@@ -162,12 +166,12 @@ export function BusinessChainPicker({
       // dag：席位顺序按 stage 展平（与 plan 一致）。
       const agents = dagPlan.stages
         .flatMap((st) => st.agentIds)
-        .map((id) => ({ agent_id: id, name: nameOf(id), model: modelOf(id), seat_skill_directive: skillOf(id), seatMode: seatModeOf(id) }));
+        .map((id) => ({ agent_id: id, name: nameOf(id), model: modelOf(id), seat_skill_directive: skillOf(id), human_validation: humanValidationOf(id), seatMode: seatModeOf(id) }));
       onConfirm({ agents, mode: "dag", chain: chainMeta, plan: dagPlan, dagExecMode, gatherFirst: selectedChain.gatherFirst ?? false });
       return;
     }
 
-    const agents = survivingSeats.map((s) => ({ agent_id: s.agent_id, name: nameOf(s.agent_id), model: modelOf(s.agent_id), seat_skill_directive: skillOf(s.agent_id), seatMode: seatModeOf(s.agent_id) }));
+    const agents = survivingSeats.map((s) => ({ agent_id: s.agent_id, name: nameOf(s.agent_id), model: modelOf(s.agent_id), seat_skill_directive: skillOf(s.agent_id), human_validation: humanValidationOf(s.agent_id), seatMode: seatModeOf(s.agent_id) }));
     onConfirm({ agents, mode: "chain", chain: chainMeta, gatherFirst: selectedChain.gatherFirst ?? false });
   };
 
diff --git a/frontend-web/src/roundtable-planning/components/Step1Panel.tsx b/frontend-web/src/roundtable-planning/components/Step1Panel.tsx
index 63a935e0..a8772dbb 100644
--- a/frontend-web/src/roundtable-planning/components/Step1Panel.tsx
+++ b/frontend-web/src/roundtable-planning/components/Step1Panel.tsx
@@ -103,6 +103,12 @@ export interface Step1PanelProps {
    */
   headerLeftSlot?: React.ReactNode;
   headerRightSlot?: React.ReactNode;
+  /** Optional side content rendered below the shared header, beside the dialogue area. */
+  rightSidebar?: React.ReactNode;
+  /** Hide the shared question-count badge when a workspace supplies its own header actions. */
+  hideQuestionCount?: boolean;
+  /** Optional empty state rendered in the centre of an otherwise blank dialogue list. */
+  emptyState?: React.ReactNode;
   interactiveMessages: InteractiveMessage[];
   intentThreadId: string | null;
   intentReady: object | null;
@@ -146,6 +152,9 @@ export function Step1Panel(props: Step1PanelProps) {
   const {
     headerLeftSlot,
     headerRightSlot,
+    rightSidebar,
+    hideQuestionCount = false,
+    emptyState,
     rootClassName,
     interactiveMessages,
     intentThreadId,
@@ -230,6 +239,7 @@ export function Step1Panel(props: Step1PanelProps) {
 
   // 顶部标题栏整片脱敏（消息列表正文在下方，不在此容器内，保持原文）。
   const headerDzRef = useDesensitizeSubtree<HTMLDivElement>();
+  const showEmptyState = interactiveMessages.length === 0 && Boolean(emptyState);
 
   return (
     <div className={`flex-1 flex flex-col min-h-0 ${rootClassName ?? ""}`}>
@@ -244,34 +254,45 @@ export function Step1Panel(props: Step1PanelProps) {
           </div>
         )}
         <div className="flex shrink-0 items-center gap-2">
-        <span className="shrink-0 text-[11px] font-bold text-slate-400 bg-white border px-2 py-0.5 rounded-md">
-          问答轮次：{interactiveMessages.filter((m) => m.sender === "user").length} 轮
-        </span>
+          {!hideQuestionCount && (
+            <span className="shrink-0 text-[11px] font-bold text-slate-400 bg-white border px-2 py-0.5 rounded-md">
+              问答轮次：{interactiveMessages.filter((m) => m.sender === "user").length} 轮
+            </span>
+          )}
           {headerRightSlot}
         </div>
       </div>
 
+      <div className={rightSidebar ? "flex min-h-0 flex-1" : "contents"}>
+        <div className={rightSidebar ? "flex min-w-0 flex-1 flex-col" : "contents"}>
       {/* Chat list */}
       <div className="relative flex-1 min-h-0 flex flex-col font-normal">
         <div
           ref={step1ScrollRef}
           // overflow-x-hidden：消息列表只竖向滚（见 Step2Panel 同处注释），避免误触横向拖动抢滑块。
-          className="flex-1 min-h-0 overflow-y-auto overflow-x-hidden bg-white"
+          className="flex min-h-0 flex-1 flex-col overflow-y-auto overflow-x-hidden bg-white"
         >
-          <div ref={step1ContentRef} className="space-y-4 p-6">
-            {interactiveMessages.map((msg) => (
-              <Step1Message
-                key={msg.id}
-                msg={msg}
-                metric={speedMeterEnabled ? messageMetrics.get(msg.id) : undefined}
-                intentReady={intentReady}
-                pendingIntentClarificationMsgId={pendingIntentClarificationMsgId}
-                intentClarificationSelections={intentClarificationSelections}
-                setIntentClarificationSelections={setIntentClarificationSelections}
-                isIntentSending={isIntentSending}
-                submitIntentClarifications={submitIntentClarifications}
-              />
-            ))}
+          <div
+            ref={step1ContentRef}
+            className={showEmptyState ? "flex min-h-full flex-1 p-6" : "space-y-4 p-6"}
+          >
+            {showEmptyState ? (
+              <div className="flex min-h-full w-full flex-1 items-center justify-center">{emptyState}</div>
+            ) : (
+              interactiveMessages.map((msg) => (
+                <Step1Message
+                  key={msg.id}
+                  msg={msg}
+                  metric={speedMeterEnabled ? messageMetrics.get(msg.id) : undefined}
+                  intentReady={intentReady}
+                  pendingIntentClarificationMsgId={pendingIntentClarificationMsgId}
+                  intentClarificationSelections={intentClarificationSelections}
+                  setIntentClarificationSelections={setIntentClarificationSelections}
+                  isIntentSending={isIntentSending}
+                  submitIntentClarifications={submitIntentClarifications}
+                />
+              ))
+            )}
           </div>
         </div>
         {!step1AtBottom && <ScrollToBottomButton onClick={scrollStep1ToBottom} />}
@@ -453,6 +474,9 @@ export function Step1Panel(props: Step1PanelProps) {
         </div>
       </div>
       )}
+        </div>
+        {rightSidebar}
+      </div>
     </div>
   );
 }
@@ -664,6 +688,15 @@ function Step1Message({
 
 /** [INTENT_READY] 标记块解析出 IntentSummary 后的绿色摘要卡。 */
 function IntentReadySummaryCard({ summary }: { summary: IntentSummary }) {
+  const positionSections =
+    summary.coreGoals && summary.riskWarnings && summary.keyPoints && summary.strategicSignificance
+      ? ([
+          ["核心目标", summary.coreGoals],
+          ["风险提示", summary.riskWarnings],
+          ["关键要点", summary.keyPoints],
+          ["战略意义", summary.strategicSignificance],
+        ] as const)
+      : null;
   return (
     <div className="mt-1 border border-emerald-200 bg-emerald-50/50 rounded-xl p-3 space-y-2">
       <div className="flex items-center gap-1.5">
@@ -672,30 +705,35 @@ function IntentReadySummaryCard({ summary }: { summary: IntentSummary }) {
           任务意图已明确
         </span>
       </div>
-      <div className="space-y-1">
-        <span className="text-[10px] font-bold text-slate-500 uppercase tracking-wider">核心目标</span>
-        <p className="text-[11.5px] text-slate-800 leading-relaxed">{summary.objective}</p>
-      </div>
-      {summary.constraints?.length > 0 && (
-        <div className="space-y-1">
-          <span className="text-[10px] font-bold text-slate-500 uppercase tracking-wider">约束条件</span>
-          <ul className="list-disc pl-4 space-y-0.5 text-[11px] text-slate-700">
-            {summary.constraints.map((c, i) => (
-              <li key={i} className="leading-snug">{c}</li>
-            ))}
-          </ul>
+      {positionSections ? positionSections.map(([label, values]) => (
+        <div key={label} className="space-y-1">
+          <span className="text-[10px] font-bold text-slate-500 uppercase tracking-wider">{label}</span>
+          {values.length > 0 ? <ul className="list-disc pl-4 space-y-0.5 text-[11px] text-slate-700">
+            {values.map((value, index) => <li key={index} className="leading-snug">{value}</li>)}
+          </ul> : <p className="text-[11px] text-slate-500">暂无{label}</p>}
         </div>
-      )}
-      {summary.assumptions && summary.assumptions.length > 0 && (
+      )) : <>
         <div className="space-y-1">
-          <span className="text-[10px] font-bold text-slate-500 uppercase tracking-wider">关键假设</span>
-          <ul className="list-disc pl-4 space-y-0.5 text-[11px] text-slate-700">
-            {summary.assumptions.map((a, i) => (
-              <li key={i} className="leading-snug">{a}</li>
-            ))}
-          </ul>
+          <span className="text-[10px] font-bold text-slate-500 uppercase tracking-wider">核心目标</span>
+          <p className="text-[11.5px] text-slate-800 leading-relaxed">{summary.objective}</p>
         </div>
-      )}
+        {summary.constraints?.length > 0 && (
+          <div className="space-y-1">
+            <span className="text-[10px] font-bold text-slate-500 uppercase tracking-wider">约束条件</span>
+            <ul className="list-disc pl-4 space-y-0.5 text-[11px] text-slate-700">
+              {summary.constraints.map((c, i) => <li key={i} className="leading-snug">{c}</li>)}
+            </ul>
+          </div>
+        )}
+        {summary.assumptions && summary.assumptions.length > 0 && (
+          <div className="space-y-1">
+            <span className="text-[10px] font-bold text-slate-500 uppercase tracking-wider">关键假设</span>
+            <ul className="list-disc pl-4 space-y-0.5 text-[11px] text-slate-700">
+              {summary.assumptions.map((a, i) => <li key={i} className="leading-snug">{a}</li>)}
+            </ul>
+          </div>
+        )}
+      </>}
     </div>
   );
 }
diff --git a/frontend-web/src/roundtable-planning/hooks/useStep1Intent.ts b/frontend-web/src/roundtable-planning/hooks/useStep1Intent.ts
index e019d21a..780b4459 100644
--- a/frontend-web/src/roundtable-planning/hooks/useStep1Intent.ts
+++ b/frontend-web/src/roundtable-planning/hooks/useStep1Intent.ts
@@ -90,10 +90,14 @@ export interface UseStep1IntentOptions {
   currentStep: number;
   /** 全局选中模型;调用 `/api/intent/init` / `/api/intent/stream` 时透传。 */
   selectedModel: string;
+  /** Optional built-in agent override for a workspace with a distinct schema. */
+  intentAgentId?: string;
   /** Optional hidden task/business context for each intent-agent turn. */
   taskContext?: Record<string, unknown> | null;
   /** Optional task-aware welcome bubble text before the first user turn. */
   initialWelcomeText?: string;
+  /** Keep the dialogue visually empty while its intent thread is initialising. */
+  showInitialWelcome?: boolean;
   /** 主页面统一的 toast 入口。 */
   triggerToast: (msg: string) => void;
 }
@@ -104,6 +108,7 @@ export interface UseStep1IntentReturn {
   intentReady: IntentSummary | null;
   intentInitError: string | null;
   intentInitErrorDetail: IntentErrorDetail | null;
+  isIntentInitializing: boolean;
   isIntentSending: boolean;
   pendingIntentClarificationMsgId: number | null;
   /** Per-question selections, keyed by `clarificationKey(msgId, clarId, index)`. */
@@ -172,13 +177,22 @@ function intentPhaseLabel(phase: IntentStreamPhase, toolName?: string): string {
 }
 
 export function useStep1Intent(options: UseStep1IntentOptions): UseStep1IntentReturn {
-  const { currentStep, selectedModel, taskContext, initialWelcomeText, triggerToast } = options;
+  const {
+    currentStep,
+    selectedModel,
+    intentAgentId,
+    taskContext,
+    initialWelcomeText,
+    showInitialWelcome = true,
+    triggerToast,
+  } = options;
 
   const [intentThreadId, setIntentThreadId] = useState<string | null>(null);
   const [intentReady, setIntentReady] = useState<IntentSummary | null>(null);
   const [intentInitError, setIntentInitError] = useState<string | null>(null);
   const [intentInitErrorDetail, setIntentInitErrorDetail] =
     useState<IntentErrorDetail | null>(null);
+  const [isIntentInitializing, setIsIntentInitializing] = useState<boolean>(false);
   const [isIntentSending, setIsIntentSending] = useState<boolean>(false);
   const [pendingIntentClarificationMsgId, setPendingIntentClarificationMsgId] =
     useState<number | null>(null);
@@ -203,6 +217,10 @@ export function useStep1Intent(options: UseStep1IntentOptions): UseStep1IntentRe
   useEffect(() => {
     selectedModelRef.current = selectedModel;
   }, [selectedModel]);
+  const intentAgentIdRef = useRef<string | undefined>(intentAgentId);
+  useEffect(() => {
+    intentAgentIdRef.current = intentAgentId;
+  }, [intentAgentId]);
   const taskContextRef = useRef<Record<string, unknown> | null>(taskContext ?? null);
   useEffect(() => {
     taskContextRef.current = taskContext ?? null;
@@ -230,18 +248,23 @@ export function useStep1Intent(options: UseStep1IntentOptions): UseStep1IntentRe
     setIntentInitError(null);
     setIntentInitErrorDetail(null);
     setIntentThreadId(null);
+    setIsIntentInitializing(true);
     setPendingIntentClarificationMsgId(null);
     setIntentClarificationSelections(new Map());
     setTimelineEntries([]);
-    setInteractiveMessages([
-      {
-        id: 1,
-        sender: "agent",
-        senderName: "任务理解智能体",
-        content: initialWelcomeTextRef.current || INTENT_WELCOME_TEXT,
-        time: nowTime(),
-      },
-    ]);
+    setInteractiveMessages(
+      showInitialWelcome
+        ? [
+            {
+              id: 1,
+              sender: "agent",
+              senderName: "任务理解智能体",
+              content: initialWelcomeTextRef.current || INTENT_WELCOME_TEXT,
+              time: nowTime(),
+            },
+          ]
+        : [],
+    );
     (async () => {
       try {
         // initIntent 当前不在 thread 上落盘 model,只为占位与兼容;空时由后端
@@ -249,9 +272,11 @@ export function useStep1Intent(options: UseStep1IntentOptions): UseStep1IntentRe
         const res = await initIntent(
           selectedModelRef.current || undefined,
           taskContextRef.current,
+          intentAgentIdRef.current,
         );
         if (step1InitGenRef.current !== myGen) return;
         setIntentThreadId(res.thread_id);
+        setIsIntentInitializing(false);
         setTimelineEntries([
           {
             id: 1,
@@ -262,6 +287,7 @@ export function useStep1Intent(options: UseStep1IntentOptions): UseStep1IntentRe
         ]);
       } catch (err) {
         if (step1InitGenRef.current !== myGen) return;
+        setIsIntentInitializing(false);
         console.error("init intent failed:", err);
         if (err instanceof IntentInitError) {
           setIntentInitError(err.detail?.message || err.message);
@@ -272,13 +298,14 @@ export function useStep1Intent(options: UseStep1IntentOptions): UseStep1IntentRe
         }
       }
     })();
-  }, []);
+  }, [showInitialWelcome]);
 
   const resetIntent = useCallback(() => {
     stopIntentStream();
     step1InitRef.current = false;
     step1InitGenRef.current += 1;
     setIntentThreadId(null);
+    setIsIntentInitializing(false);
     setIntentReady(null);
     setIntentInitError(null);
     setIntentInitErrorDetail(null);
@@ -424,6 +451,7 @@ export function useStep1Intent(options: UseStep1IntentOptions): UseStep1IntentRe
           threadId: intentThreadId,
           message: trimmed,
           model: selectedModelRef.current || undefined,
+          intentAgentId: intentAgentIdRef.current,
           taskContext: taskContextRef.current,
           files: fileRefs,
           signal: aborter.signal,
@@ -654,6 +682,7 @@ export function useStep1Intent(options: UseStep1IntentOptions): UseStep1IntentRe
       // 或继续显示旧会话的澄清选择。
       stopIntentStream();
       setIsIntentSending(false);
+      setIsIntentInitializing(false);
       setPendingIntentClarificationMsgId(null);
       setIntentClarificationSelections(new Map());
       setIntentThreadId(snapshot.intentThreadId);
@@ -690,6 +719,7 @@ export function useStep1Intent(options: UseStep1IntentOptions): UseStep1IntentRe
     intentReady,
     intentInitError,
     intentInitErrorDetail,
+    isIntentInitializing,
     isIntentSending,
     pendingIntentClarificationMsgId,
     intentClarificationSelections,
diff --git a/frontend-web/src/roundtable-planning/hooks/useStep2Orchestration.ts b/frontend-web/src/roundtable-planning/hooks/useStep2Orchestration.ts
index 231ae50c..ff6ab7df 100644
--- a/frontend-web/src/roundtable-planning/hooks/useStep2Orchestration.ts
+++ b/frontend-web/src/roundtable-planning/hooks/useStep2Orchestration.ts
@@ -33,6 +33,13 @@ import { useUpdateSubtask } from "@/core/tasks/context";
 /** 干预消息携带的上传文件引用（与 streamMultiAgent 的 files 字段同形）。 */
 type RunFileRef = NonNullable<StreamMultiAgentRequest["files"]>[number];
 
+type SeatDelivery = { name: string; content: string };
+
+/** In-memory cursor for a business-chain human-validation pause. */
+type HumanValidationContinuation =
+  | { mode: "chain"; nextSeatIndex: number }
+  | { mode: "dag"; nextStageIndex: number; priorDeliveries: SeatDelivery[] };
+
 /** 读取并清空 ref（consume-once）：首个 leader run 拿到文件后清空，后续轮次不再带。 */
 function takeOnce<T>(ref: { current: T | null }): T | undefined {
   const v = ref.current ?? undefined;
@@ -286,6 +293,8 @@ export interface UseStep2OrchestrationOptions {
    * OR。recommend / 未选链条 → 空 {}（各席位仅靠其自身开关）。
    */
   seatSkillDirectives?: Record<string, boolean>;
+  /** Per-seat human-validation checkpoints inherited from the selected chain. */
+  humanValidations?: Record<string, boolean>;
   /**
    * 每席位「推理深度覆盖」映射 {agentId: SeatMode | null}（沿用所选业务链条里每个席位的配置）。
    * 派活该 special 席位时按 agentId 查表，**席位覆盖优先、否则跟随链条级 `selectedMode`**：
@@ -456,6 +465,7 @@ export function useStep2Orchestration(
     selectedModel,
     selectedMode,
     seatSkillDirectives = {},
+    humanValidations = {},
     seatModes = {},
     gatherFirst = false,
     orchestrationMode,
@@ -593,6 +603,7 @@ export function useStep2Orchestration(
   const selectedModeRef = useRef<SeatMode>(selectedMode);
   // 每席位技能识别强化映射（所选业务链条各席位开关）同样打到 ref，席位调用按 agentId 读最新值。
   const seatSkillDirectivesRef = useRef<Record<string, boolean>>(seatSkillDirectives);
+  const humanValidationsRef = useRef<Record<string, boolean>>(humanValidations);
   // 每席位推理深度覆盖映射（所选业务链条各席位 seatMode）打到 ref，席位调用按 agentId 读最新值；
   // 覆盖优先、否则跟随 selectedModeRef。
   const seatModesRef = useRef<Record<string, SeatMode | null>>(seatModes);
@@ -624,6 +635,7 @@ export function useStep2Orchestration(
   // 澄清回复都改走 **leader 自由派活循环**（runOrchestration），由总控接着派活，而**不是**
   // 重新把整张 DAG 从头跑一遍（致命 bug 修复）。新任务 / 重新进入时由 resetInitGate 复位。
   const dagPlanExecutedRef = useRef<boolean>(false);
+  const humanValidationContinuationRef = useRef<HumanValidationContinuation | null>(null);
   const selectedAgentsRef = useRef<SelectedAgent[]>(selectedAgents);
   useEffect(() => {
     orchestrationModeRef.current = orchestrationMode;
@@ -643,6 +655,9 @@ export function useStep2Orchestration(
   useEffect(() => {
     seatSkillDirectivesRef.current = seatSkillDirectives;
   }, [seatSkillDirectives]);
+  useEffect(() => {
+    humanValidationsRef.current = humanValidations;
+  }, [humanValidations]);
   useEffect(() => {
     seatModesRef.current = seatModes;
   }, [seatModes]);
@@ -1213,6 +1228,21 @@ export function useStep2Orchestration(
     [],
   );
 
+  const pauseForHumanValidation = useCallback(
+    (continuation: HumanValidationContinuation, seatNames: string[]) => {
+      humanValidationContinuationRef.current = continuation;
+      appendDialogue({
+        sender: "系统",
+        avatarType: "blue",
+        content: `已完成 ${seatNames.join("、")} 的输出，按业务链条配置暂停，等待人工校验。可直接点击“恢复会商”继续，或在下方输入修改意见后提交。`,
+        confidence: "等待人工校验",
+      });
+      setIsRoundTableRunning(false);
+      triggerToast("已暂停等待人工校验：可恢复会商，或输入修改意见后继续");
+    },
+    [appendDialogue, triggerToast],
+  );
+
   const phaseLabel = useCallback(
     (
       phase: StreamPhase,
@@ -2012,11 +2042,17 @@ export function useStep2Orchestration(
 
       const chainSeats = selectedAgentsRef.current;
       const total = chainSeats.length;
+      const continuation = humanValidationContinuationRef.current;
+      const startSeatIndex =
+        continuation?.mode === "chain" ? continuation.nextSeatIndex : 0;
+      if (continuation?.mode === "chain") {
+        humanValidationContinuationRef.current = null;
+      }
       const leaderThreadId = resolveSeatThreadId(ids, coord);
       let finishedAllSeats = true;
 
       try {
-        for (let i = 0; i < total; i += 1) {
+        for (let i = startSeatIndex; i < total; i += 1) {
           if (isStale()) {
             finishedAllSeats = false;
             break;
@@ -2179,6 +2215,14 @@ export function useStep2Orchestration(
           }
 
           setConsensusPercentage(Math.min(95, Math.round(((i + 1) / total) * 90)));
+          if (humanValidationsRef.current[seat.agent_id]) {
+            pauseForHumanValidation(
+              { mode: "chain", nextSeatIndex: i + 1 },
+              [seatName],
+            );
+            finishedAllSeats = false;
+            break;
+          }
         }
 
         // ── (c) 总控收口:综合全链交付,产出最终结论 ──
@@ -2257,6 +2301,7 @@ export function useStep2Orchestration(
       handleUpstreamFrame,
       ingestSubagentTaskFrame,
       resolveSeatThreadId,
+      pauseForHumanValidation,
     ],
   );
 
@@ -2300,23 +2345,37 @@ export function useStep2Orchestration(
       dagPlanExecutedRef.current = true;
 
       const leaderThreadId = resolveSeatThreadId(ids, coord);
+      const continuation = humanValidationContinuationRef.current;
+      const startStageIndex =
+        continuation?.mode === "dag" ? continuation.nextStageIndex : 0;
+      if (continuation?.mode === "dag") {
+        humanValidationContinuationRef.current = null;
+      }
       let finishedAllStages = true;
       // 跨 stage 累积的**完整交付** {name, content}[] —— 注入下一 stage 席位的 run context
       // (peerDeliveries),供 read_peer_delivery 工具按需取全文(§12.9 传摘要按需传全文)。
       // 研讨前并行取数（gatherFirst）的产物作为初始注入：首个 stage 席位开局即带共享资料。
-      const priorDeliveries: Array<{ name: string; content: string }> = [...gatheredDeliveriesRef.current];
+      const priorDeliveries: SeatDelivery[] =
+        continuation?.mode === "dag"
+          ? [...continuation.priorDeliveries]
+          : [...gatheredDeliveriesRef.current];
 
       // Phase 7：初始化 DAG 流程图节点状态 —— 计划内所有席位置 pending,执行过程中逐个点亮。
       const markDagNode = (agentId: string, state: ChainNodeState) =>
         setDagNodeStates((prev) => ({ ...prev, [agentId.toLowerCase()]: state }));
       setDagNodeStates(
         Object.fromEntries(
-          plan.stages.flatMap((st) => st.agentIds.map((id) => [id.toLowerCase(), "pending" as ChainNodeState])),
+          plan.stages.flatMap((st, stageIndex) =>
+            st.agentIds.map((id) => [
+              id.toLowerCase(),
+              (stageIndex < startStageIndex ? "done" : "pending") as ChainNodeState,
+            ]),
+          ),
         ),
       );
 
       try {
-        for (let s = 0; s < plan.stages.length; s += 1) {
+        for (let s = startStageIndex; s < plan.stages.length; s += 1) {
           if (isStale()) {
             finishedAllStages = false;
             break;
@@ -2558,6 +2617,21 @@ export function useStep2Orchestration(
           setConsensusPercentage(
             Math.min(95, Math.round(((s + 1) / plan.stages.length) * 90)),
           );
+          const validationSeatNames = stageSeats
+            .filter(({ agentId }) => humanValidationsRef.current[agentId])
+            .map(({ name }) => name);
+          if (validationSeatNames.length > 0) {
+            pauseForHumanValidation(
+              {
+                mode: "dag",
+                nextStageIndex: s + 1,
+                priorDeliveries: [...priorDeliveries],
+              },
+              validationSeatNames,
+            );
+            finishedAllStages = false;
+            break;
+          }
         }
 
         // ── 计划阶段全部完成 → **交给总控（leader 自由派活循环）继续** ──
@@ -2613,6 +2687,7 @@ export function useStep2Orchestration(
       ingestParallelDelta,
       resetParallelStreams,
       runOrchestration,
+      pauseForHumanValidation,
     ],
   );
 
@@ -2746,8 +2821,9 @@ export function useStep2Orchestration(
       // 改走 leader 自由派活循环,由总控接着派活,而不是把 DAG 从头重跑一遍。
       if (
         mode === "dag" &&
-        !dagPlanExecutedRef.current &&
-        (orchestrationPlanRef.current?.stages.length ?? 0) > 0
+        (humanValidationContinuationRef.current?.mode === "dag" ||
+          (!dagPlanExecutedRef.current &&
+            (orchestrationPlanRef.current?.stages.length ?? 0) > 0))
       ) {
         return runDagOrchestration(seedMessage, ids, coord);
       }
@@ -3070,6 +3146,7 @@ export function useStep2Orchestration(
 
   const resetInitGate = useCallback(() => {
     step2InitRef.current = false;
+    humanValidationContinuationRef.current = null;
     // 新一轮研讨:允许 DAG 计划重新执行一遍。
     dagPlanExecutedRef.current = false;
     // 新一轮研讨:允许「研讨前并行取数」再取一次（清掉上一轮取数产物 + 闸门）。
@@ -3086,6 +3163,7 @@ export function useStep2Orchestration(
       // 这里只重复设 cancel ref 与 UI 标记,确保从 Step 2 在编排中切到草稿时
       // UI 立刻翻成静止态。
       orchestrationCancelRef.current = true;
+      humanValidationContinuationRef.current = null;
       setIsOrchestrating(false);
       setIsInitializing(false);
       setPendingClarification(null);
@@ -3166,6 +3244,7 @@ export function useStep2Orchestration(
       return false;
     }
     dagPlanExecutedRef.current = true;
+    humanValidationContinuationRef.current = null;
     orchestrationCancelRef.current = true;
     abortAllInFlight();
     isOrchestratingRef.current = false;
@@ -3208,6 +3287,7 @@ export function useStep2Orchestration(
     hasAutoOpenedRef.current = new Set();
     pendingInjectPromptRef.current = null;
     dagPlanExecutedRef.current = false;
+    humanValidationContinuationRef.current = null;
     gatherPhaseDoneRef.current = false;
     gatheredDeliveriesRef.current = [];
     deselectArtifact();
diff --git a/frontend-web/src/roundtable-planning/lib/business-chain.ts b/frontend-web/src/roundtable-planning/lib/business-chain.ts
index b1474d2f..18d4e953 100644
--- a/frontend-web/src/roundtable-planning/lib/business-chain.ts
+++ b/frontend-web/src/roundtable-planning/lib/business-chain.ts
@@ -36,6 +36,11 @@ export interface ChainSeat {
    * （无需 DB 列），在链条编辑器里逐席位开关。
    */
   seat_skill_directive?: boolean;
+  /**
+   * Human-validation checkpoint. When enabled, Step 2 pauses after this seat
+   * (or its DAG stage) completes and reuses the existing resume/intervention UI.
+   */
+  human_validation?: boolean;
   /**
    * 可选「席位推理深度覆盖」：覆盖链条级 `seatMode`，只对该席位生效。值是同一套
    * `SeatMode`（flash/thinking/pro/ultra）；null / 缺省 = 跟随链条级默认。用于「卡顿提速」：
@@ -109,7 +114,7 @@ export interface SeatSelectionResult {
    * `model` 为该席位在来源链条里配置的模型覆盖（空 / 缺省 = 跟随全局模型）。
    * `seat_skill_directive` 为该席位在来源链条里配置的「技能识别强化」开关（缺省 = 关）。
    */
-  agents: Array<{ agent_id: string; name: string; model?: string | null; seat_skill_directive?: boolean; seatMode?: SeatMode | null }>;
+  agents: Array<{ agent_id: string; name: string; model?: string | null; seat_skill_directive?: boolean; human_validation?: boolean; seatMode?: SeatMode | null }>;
   /**
    * 决定 Step 2 走哪种编排：
    *  - `recommend` 总控自由派活；
@@ -171,6 +176,10 @@ export function buildChainSeatSelection(
   // 席位「技能识别强化」开关（链条配置）：按 agent_id 取，缺省 = 关。
   const skillById = new Map(chain.seats.map((s) => [s.agent_id, s.seat_skill_directive ?? false]));
   const skillOf = (id: string) => skillById.get(id) ?? false;
+  const humanValidationById = new Map(
+    chain.seats.map((s) => [s.agent_id, s.human_validation ?? false]),
+  );
+  const humanValidationOf = (id: string) => humanValidationById.get(id) ?? false;
   // 席位「推理深度覆盖」（链条配置 seat_mode）：按 agent_id 取，null/缺省 = 跟随链条级 seatMode。
   // 输出到 SeatSelectionResult.agents[].seatMode（camel，喂给编排/作业的 seatModes map）。
   const seatModeById = new Map(chain.seats.map((s) => [s.agent_id, s.seat_mode ?? null]));
@@ -196,12 +205,12 @@ export function buildChainSeatSelection(
     if (hasParallel || hasGoal || hasCoord) {
       const agents = plan.stages
         .flatMap((st) => st.agentIds)
-        .map((id) => ({ agent_id: id, name: nameOf(id), model: modelOf(id), seat_skill_directive: skillOf(id), seatMode: seatModeOf(id) }));
+        .map((id) => ({ agent_id: id, name: nameOf(id), model: modelOf(id), seat_skill_directive: skillOf(id), human_validation: humanValidationOf(id), seatMode: seatModeOf(id) }));
       return { agents, mode: "dag", chain: chainMeta, plan, dagExecMode: "sandbox", seatMode: chain.seatMode, gatherFirst: chain.gatherFirst ?? false };
     }
   }
 
-  const agents = survivingSeats.map((s) => ({ agent_id: s.agent_id, name: nameOf(s.agent_id), model: modelOf(s.agent_id), seat_skill_directive: skillOf(s.agent_id), seatMode: seatModeOf(s.agent_id) }));
+  const agents = survivingSeats.map((s) => ({ agent_id: s.agent_id, name: nameOf(s.agent_id), model: modelOf(s.agent_id), seat_skill_directive: skillOf(s.agent_id), human_validation: humanValidationOf(s.agent_id), seatMode: seatModeOf(s.agent_id) }));
   return { agents, mode: "chain", chain: chainMeta, seatMode: chain.seatMode, gatherFirst: chain.gatherFirst ?? false };
 }
 
diff --git a/frontend-web/src/roundtable-planning/lib/chain-stages.test.ts b/frontend-web/src/roundtable-planning/lib/chain-stages.test.ts
index c0364e55..e59fc365 100644
--- a/frontend-web/src/roundtable-planning/lib/chain-stages.test.ts
+++ b/frontend-web/src/roundtable-planning/lib/chain-stages.test.ts
@@ -12,6 +12,7 @@ import {
   moveSeatToStage,
   moveStage,
   removeSeat,
+  setSeatHumanValidation,
   setStageGoal,
   splitSeatToNewStage,
   stageGroupsToSeats,
@@ -122,6 +123,15 @@ test("setStageGoal is immutable + out-of-range no-op", () => {
   assert.equal(setStageGoal(groups, 9, "x"), groups); // 越界返回原引用
 });
 
+test("setSeatHumanValidation updates only the selected seat and is immutable", () => {
+  const groups = grp([seat("a"), seat("b")], [seat("c")]);
+  const next = setSeatHumanValidation(groups, "b", true);
+  assert.equal(next[0].seats[1].human_validation, true);
+  assert.equal(next[0].seats[0].human_validation, undefined);
+  assert.equal(next[1].seats[0].human_validation, undefined);
+  assert.equal(groups[0].seats[1].human_validation, undefined);
+});
+
 // ── lookups ───────────────────────────────────────────────────────────────────
 
 test("findStageIndexOfSeat / countSeats", () => {
diff --git a/frontend-web/src/roundtable-planning/lib/chain-stages.ts b/frontend-web/src/roundtable-planning/lib/chain-stages.ts
index b5a85676..af7ed64d 100644
--- a/frontend-web/src/roundtable-planning/lib/chain-stages.ts
+++ b/frontend-web/src/roundtable-planning/lib/chain-stages.ts
@@ -141,6 +141,23 @@ export function setSeatSkillDirective(groups: StageGroups, agentId: string, enab
   });
 }
 
+/** Update a seat's human-validation checkpoint without changing other stages. */
+export function setSeatHumanValidation(
+  groups: StageGroups,
+  agentId: string,
+  enabled: boolean,
+): StageGroups {
+  return groups.map((g) => {
+    if (!g.seats.some((s) => s.agent_id === agentId)) return g;
+    return {
+      ...g,
+      seats: g.seats.map((s) =>
+        s.agent_id === agentId ? { ...s, human_validation: enabled } : s,
+      ),
+    };
+  });
+}
+
 /**
  * 设置某个席位的「推理深度覆盖」（不可变，供编辑器席位下拉 onChange）。
  * `mode` 为 null = 清除覆盖（跟随链条级 seatMode）。按 agent_id 定位，跨 stage 适用。
diff --git a/frontend-web/src/roundtable-planning/lib/roundtable-constants.ts b/frontend-web/src/roundtable-planning/lib/roundtable-constants.ts
index 4bde0b96..1f361e06 100644
--- a/frontend-web/src/roundtable-planning/lib/roundtable-constants.ts
+++ b/frontend-web/src/roundtable-planning/lib/roundtable-constants.ts
@@ -292,9 +292,29 @@ function toStringArray(value: unknown): string[] {
  * 把解析出的对象归一成 IntentSummary。只要 `objective` 是非空字符串就认。
  * constraints / assumptions 容忍模型写成字符串 / null / 缺失,统一归到 string[]。
  */
-function normalizeIntentSummary(parsed: unknown): IntentSummary | null {
+export function normalizeIntentReadySummary(parsed: unknown): IntentSummary | null {
   if (!parsed || typeof parsed !== "object") return null;
   const obj = parsed as Record<string, unknown>;
+  const positionKeys = ["coreGoals", "riskWarnings", "keyPoints", "strategicSignificance"];
+  if (positionKeys.some((key) => key in obj)) {
+    if (!positionKeys.every((key) => Array.isArray(obj[key]))) return null;
+    const coreGoals = toStringArray(obj.coreGoals);
+    const riskWarnings = toStringArray(obj.riskWarnings);
+    const keyPoints = toStringArray(obj.keyPoints);
+    const strategicSignificance = toStringArray(obj.strategicSignificance);
+    // Keep the long-standing Step-1 state machine compatible while retaining
+    // every position-specific field verbatim for its dedicated UI and storage.
+    return {
+      objective:
+        strategicSignificance[0] || coreGoals[0] || keyPoints[0] || "岗位任务意图已识别",
+      constraints: riskWarnings,
+      assumptions: keyPoints,
+      coreGoals,
+      riskWarnings,
+      keyPoints,
+      strategicSignificance,
+    };
+  }
   const objective =
     typeof obj.objective === "string" ? obj.objective.trim() : "";
   if (!objective) return null;
@@ -310,14 +330,14 @@ function normalizeIntentSummary(parsed: unknown): IntentSummary | null {
  *   1) 原文直接 parse
  *   2) 转义字符串内的裸控制字符(换行 / 制表符)后再 parse
  *   3) 再去掉尾随逗号后 parse
- * 三次都失败才放弃。任一成功都过 `normalizeIntentSummary` 兜字段类型。
+ * 三次都失败才放弃。任一成功都过 `normalizeIntentReadySummary` 兜字段类型。
  */
 function parseIntentSummary(raw: string): IntentSummary | null {
   const sanitized = sanitizeJsonControlChars(raw);
   const candidates = [raw, sanitized, stripTrailingCommas(sanitized)];
   for (const candidate of candidates) {
     try {
-      const summary = normalizeIntentSummary(JSON.parse(candidate));
+      const summary = normalizeIntentReadySummary(JSON.parse(candidate));
       if (summary) return summary;
     } catch {
       // 下一个候选
diff --git a/frontend-web/src/roundtable-planning/pages/BusinessChainEditorPage.tsx b/frontend-web/src/roundtable-planning/pages/BusinessChainEditorPage.tsx
index 5c711392..bb1cbf88 100644
--- a/frontend-web/src/roundtable-planning/pages/BusinessChainEditorPage.tsx
+++ b/frontend-web/src/roundtable-planning/pages/BusinessChainEditorPage.tsx
@@ -41,6 +41,7 @@ import {
   Sparkles,
   SplitSquareVertical,
   Trash2,
+  UserCheck,
   UserPlus,
   Wand2,
   X,
@@ -127,6 +128,7 @@ import {
   seatExistsInGroups,
   setSeatMode as setSeatModeOnGroups,
   setSeatModel,
+  setSeatHumanValidation,
   setSeatSkillDirective,
   setStageGoal,
   splitSeatToNewStage,
@@ -453,6 +455,10 @@ export default function BusinessChainEditorPage() {
     setStageGroups((prev) => setSeatSkillDirective(prev, agentId, enabled));
   }, []);
 
+  const setSeatHumanValidationCb = useCallback((agentId: string, enabled: boolean) => {
+    setStageGroups((prev) => setSeatHumanValidation(prev, agentId, enabled));
+  }, []);
+
   // 席位「推理深度覆盖」：编辑器席位小图标下拉 onChange（null = 清除，跟随链条级 seatMode）。
   const setSeatModeCb = useCallback((agentId: string, mode: SeatMode | null) => {
     setStageGroups((prev) => setSeatModeOnGroups(prev, agentId, mode));
@@ -670,6 +676,7 @@ export default function BusinessChainEditorPage() {
           model: s.model ?? null,
           // 席位「会商技能识别强化」开关：随席位一起落库（缺省 = false 关）。
           seat_skill_directive: s.seat_skill_directive ?? false,
+          human_validation: s.human_validation ?? false,
           // 席位「推理深度覆盖」：随席位一起落库（null = 跟随链条级 seatMode）。
           seat_mode: s.seat_mode ?? null,
           // 岗位协同专用岗位归属：普通圆桌忽略，但保存时必须原样保留。
@@ -1272,6 +1279,7 @@ export default function BusinessChainEditorPage() {
             onSplitSeat={splitSeat}
             onSeatModelChange={setSeatModelCb}
             onSeatSkillDirectiveChange={setSeatSkillDirectiveCb}
+            onSeatHumanValidationChange={setSeatHumanValidationCb}
             onSeatModeChange={setSeatModeCb}
             positionConfigMode={positionConfigMode}
             positionOptions={positionOptions}
@@ -1455,6 +1463,7 @@ function StagesColumn({
   onSplitSeat,
   onSeatModelChange,
   onSeatSkillDirectiveChange,
+  onSeatHumanValidationChange,
   onSeatModeChange,
   positionConfigMode,
   positionOptions,
@@ -1476,6 +1485,7 @@ function StagesColumn({
   onSplitSeat: (agentId: string) => void;
   onSeatModelChange: (agentId: string, model: string | null) => void;
   onSeatSkillDirectiveChange: (agentId: string, enabled: boolean) => void;
+  onSeatHumanValidationChange: (agentId: string, enabled: boolean) => void;
   onSeatModeChange: (agentId: string, mode: SeatMode | null) => void;
   /** 仅岗位协同入口启用；普通圆桌编辑器不显示岗位控件。 */
   positionConfigMode: boolean;
@@ -1586,6 +1596,7 @@ function StagesColumn({
                 onSplitSeat={onSplitSeat}
                 onSeatModelChange={onSeatModelChange}
                 onSeatSkillDirectiveChange={onSeatSkillDirectiveChange}
+                onSeatHumanValidationChange={onSeatHumanValidationChange}
                 onSeatModeChange={onSeatModeChange}
                 positionConfigMode={positionConfigMode}
                 positionOptions={positionOptions}
@@ -1620,6 +1631,7 @@ function StageSection({
   onSplitSeat,
   onSeatModelChange,
   onSeatSkillDirectiveChange,
+  onSeatHumanValidationChange,
   onSeatModeChange,
   positionConfigMode,
   positionOptions,
@@ -1643,6 +1655,7 @@ function StageSection({
   onSplitSeat: (agentId: string) => void;
   onSeatModelChange: (agentId: string, model: string | null) => void;
   onSeatSkillDirectiveChange: (agentId: string, enabled: boolean) => void;
+  onSeatHumanValidationChange: (agentId: string, enabled: boolean) => void;
   onSeatModeChange: (agentId: string, mode: SeatMode | null) => void;
   positionConfigMode: boolean;
   positionOptions: readonly PositionOption[];
@@ -1809,6 +1822,7 @@ function StageSection({
                 onSplit={() => onSplitSeat(seat.agent_id)}
                 onModelChange={(model) => onSeatModelChange(seat.agent_id, model)}
                 onSkillDirectiveChange={(enabled) => onSeatSkillDirectiveChange(seat.agent_id, enabled)}
+                onHumanValidationChange={(enabled) => onSeatHumanValidationChange(seat.agent_id, enabled)}
                 onSeatModeChange={(mode) => onSeatModeChange(seat.agent_id, mode)}
                 showPositionConfig={positionConfigMode}
                 positionOptions={positionOptions}
@@ -1837,6 +1851,7 @@ function SeatStrip({
   onSplit,
   onModelChange,
   onSkillDirectiveChange,
+  onHumanValidationChange,
   onSeatModeChange,
   showPositionConfig,
   positionOptions,
@@ -1857,6 +1872,7 @@ function SeatStrip({
   onModelChange: (model: string | null) => void;
   /** 席位「会商技能识别强化」开关变更。 */
   onSkillDirectiveChange: (enabled: boolean) => void;
+  onHumanValidationChange: (enabled: boolean) => void;
   /** 席位「推理深度覆盖」变更（null = 跟随链条级 seatMode）。 */
   onSeatModeChange: (mode: SeatMode | null) => void;
   /** 仅岗位协同入口展示的岗位配置。 */
@@ -2058,6 +2074,38 @@ function SeatStrip({
             </div>
           </DropdownMenuContent>
         </DropdownMenu>
+        <DropdownMenu>
+          <DropdownMenuTrigger asChild>
+            <button
+              type="button"
+              title="人工校验：该席位完成后暂停会商，等待用户恢复或输入修改意见"
+              className={cn(
+                "p-1 transition",
+                R_CTRL,
+                seat.human_validation
+                  ? "bg-primary/10 text-primary"
+                  : "text-muted-foreground hover:bg-muted hover:text-foreground",
+              )}
+            >
+              <UserCheck className="size-3.5" />
+            </button>
+          </DropdownMenuTrigger>
+          <DropdownMenuContent align="end" className="w-64 p-3">
+            <div className="flex items-start justify-between gap-3">
+              <div className="space-y-0.5">
+                <p className="text-xs font-semibold text-foreground">人工校验</p>
+                <p className="text-[11px] leading-relaxed text-muted-foreground">
+                  开启后，该席位所在的执行单元完成时会自动暂停。用户可直接点击“恢复会商”继续，或在下方输入修改意见后提交；不会新增校验卡片。
+                </p>
+              </div>
+              <Switch
+                checked={seat.human_validation ?? false}
+                onCheckedChange={onHumanValidationChange}
+                aria-label={`切换 ${seat.name || seat.agent_id} 的人工校验`}
+              />
+            </div>
+          </DropdownMenuContent>
+        </DropdownMenu>
         <button
           type="button"
           onClick={onDetail}
diff --git a/frontend-web/src/roundtable-planning/pages/RoundtablePlanningPage.tsx b/frontend-web/src/roundtable-planning/pages/RoundtablePlanningPage.tsx
index 95a00491..5259e5ce 100644
--- a/frontend-web/src/roundtable-planning/pages/RoundtablePlanningPage.tsx
+++ b/frontend-web/src/roundtable-planning/pages/RoundtablePlanningPage.tsx
@@ -409,6 +409,10 @@ export default function RoundtablePlanningPage({
   // Step 2 每席位「技能识别强化」开关映射 {agentId: bool}：由所选业务链条里**每个席位**的同名
   // 配置决定（recommend 无链条 → 空 {}）。透传给每个席位 run，与各席位智能体自身的开关取 OR。
   const [seatSkillDirectives, setSeatSkillDirectives] = useState<Record<string, boolean>>({});
+  // Per-seat human-validation checkpoints from the selected business chain.
+  // A checkpoint pauses Step 2 after the configured seat/stage completes and
+  // reuses the existing resume button plus bottom intervention composer.
+  const [humanValidations, setHumanValidations] = useState<Record<string, boolean>>({});
   // Step 2 每席位「推理深度覆盖」映射 {agentId: SeatMode|null}：由所选业务链条里**每个席位**单独配
   // 的推理深度决定（null/未配 → 跟随链条级 seatMode）。透传给席位 run（覆盖优先、否则跟随 seatMode）。
   // 「卡顿提速」用：把次要席位降到 flash 即可大幅缩短第二步耗时。
@@ -573,6 +577,7 @@ export default function RoundtablePlanningPage({
     selectedModel,
     selectedMode: seatMode,
     seatSkillDirectives,
+    humanValidations,
     seatModes,
     gatherFirst,
     orchestrationMode,
@@ -1058,6 +1063,9 @@ export default function RoundtablePlanningPage({
       setSeatSkillDirectives(
         Object.fromEntries(result.agents.map((a) => [a.agent_id, a.seat_skill_directive ?? false])),
       );
+      setHumanValidations(
+        Object.fromEntries(result.agents.map((a) => [a.agent_id, a.human_validation ?? false])),
+      );
       // 每席位推理深度覆盖：取所选业务链条里**每席位**单独配的 seatMode → {agentId: SeatMode|null}
       // 映射（recommend / 未配 → null，跟随链条级 seatMode）。
       setSeatModes(
diff --git a/frontend-web/src/styles/globals.css b/frontend-web/src/styles/globals.css
index d4e9e639..a130b10a 100644
--- a/frontend-web/src/styles/globals.css
+++ b/frontend-web/src/styles/globals.css
@@ -746,7 +746,7 @@
 
   /* 岗位会商左侧总面板：仅收窄滚动条宽度，沿用全局既有的滑块颜色、圆角和轨道样式。 */
   .position-roundtable-sidebar-scrollbar::-webkit-scrollbar {
-    width: 8px;
+    width: 5px;
   }
 
   .workspace-shell {
diff --git a/offline-backend-20260512/backend/CLAUDE.md b/offline-backend-20260512/backend/CLAUDE.md
index 892d683f..cdfff4a8 100644
--- a/offline-backend-20260512/backend/CLAUDE.md
+++ b/offline-backend-20260512/backend/CLAUDE.md
@@ -123,6 +123,27 @@ cascade pragmas. The router is mounted canonically below
 schema-hidden compatibility prefix `/api/multi-agent/position-roundtable`.
 Clients may retry the compatibility route only for a framework/proxy-level
 `404 Not Found`; domain-level missing-session responses must remain real 404s.
+
+Position roundtable selects the separately seeded built-in agent
+`position-roundtable-intent` by passing `intent_agent_id` to the shared
+`/api/intent/init` and `/api/intent/stream` endpoints. Its request lifecycle,
+files, and SSE protocol match `roundtable-intent`, but its cap is five
+**user-assistance rounds**. A single round may emit several independent
+`ask_clarification` tool calls; those calls are separate cards, not one card
+containing several numbered questions. Count that as one round by the
+tool-calling AI message, never by card count. Topic-only requests must request
+all material missing decisions as separate cards rather than being treated as a
+resolved intent; after the fifth set is answered it must emit completed final
+JSON without unresolved placeholders. The required arrays are
+`coreGoals`, `riskWarnings`, `keyPoints`, and `strategicSignificance`. Do not
+treat a fresh dedicated-agent `ask_clarification` as stale: it must win over
+a same-run premature `[INTENT_READY]` and leave the UI waiting for the user.
+Conversely, the prior turn’s historical clarification must not block the user
+reply from completing. Do not
+change `roundtable-intent`'s `{objective,constraints,assumptions}` contract for
+this feature. The position router accepts the new schema for activation and
+injects all four sections into downstream position-node and closing-agent
+context; legacy stored summaries are mapped read-only for compatibility.
 `/api/intent/init` must create the empty Step-1 thread through
 `multi_agent._create_thread_direct`, exactly like multi-agent initialization;
 do not restore the old HTTP loopback to `/api/threads`, because deployed
@@ -436,6 +457,15 @@ Backs the zzJC / zzXD agent-chat left sidebar (「按类型聚合智能体 + 聊
 
 ### Position-collaboration foundation
 
+### Roundtable business-chain human validation
+
+The existing `/api/roundtable-chains` `seats` JSON also accepts the optional
+boolean `human_validation` field on each seat (`ChainSeatSchema`). It is a
+frontend Step 2 checkpoint, not a server-side approval task: after the marked
+seat completes (or, in a DAG, after its stage completes), the client pauses and
+uses the existing resume button or intervention composer to continue. No new
+database column, migration, or validation card is required.
+
 The position-collaboration workspace is a separate frontend route and must not
 use the original roundtable coordinator or jobs. Its shared configuration
 integration point is the existing `/api/roundtable-chains` store: each `seats` JSON item
@@ -1133,6 +1163,26 @@ the initial intent workspace plus the summary/action-plan closing agents. Do
 not delete a built-in id because historical chain nodes persist those ids;
 custom role ids may be added and removed.
 
+### Position-roundtable task-scoped session history
+
+`position_roundtable_sessions.external_task_id` is optional. When populated from the frontend route `taskId`, new rows set `task_scoped = true`: a task can have multiple sessions and all users opening that task see the same sessions, nodes and persisted conversation snapshots. When it is NULL/empty, keep the original `user_id`-scoped personal workspace behavior. `20260808_01` adds `task_scoped` with default `false` (so all historical records remain personal) plus the task/update-time index; it must not backfill or make `external_task_id` non-null.
+
+### Roundtable artifact submission status
+
+`roundtable_artifact_submissions` keeps task-level submission state for a
+generated deliverable and is deliberately separate from task details and any
+external task-system delivery. The API is
+`GET /api/roundtable/tasks/{taskId}/artifacts?submitted=true` and
+`PUT /api/roundtable/tasks/{taskId}/artifacts/submission`. All callers use the
+normal Gateway Bearer authentication; records are shared by task while
+`created_by`/`submitted_by`/`cancelled_by` are audit-only. The server derives a
+SHA-256 idempotency key from `taskId + sourceKey + path + revision`: submitting
+the same revision is an upsert, while cancellation only flips `submitted` and
+sets `cancelled_at` (it never deletes history). Store only the sandbox file
+reference (`threadId`, path, source/node/session fields, name/MIME and revision)
+and timestamps; do not persist Markdown content or call a formal delivery
+interface. Previews continue to read the DeerFlow artifact by `threadId + path`.
+
 See `docs/` directory for detailed documentation:
 - [../README.md](../README.md) - Offline Docker wheelhouse preparation and startup workflow. The pinned versions in `../offline-runtime-requirements.txt` and `../start_backend.sh` must stay synchronized. Startup checks `croniter`, `hindsight-client`, `aiomysql`, and Redis, installing missing packages from wheelhouse only; `aiomysql==0.3.2` includes the pinned `PyMySQL==1.2.0` transitive dependency. The download target defaults to CPython 3.12 on Linux x86_64 and verifies dependency closure using wheelhouse only.
 - [CONFIGURATION.md](docs/CONFIGURATION.md) - Configuration options
diff --git a/offline-backend-20260512/backend/README.md b/offline-backend-20260512/backend/README.md
index 6fa63123..9e0a13c4 100644
--- a/offline-backend-20260512/backend/README.md
+++ b/offline-backend-20260512/backend/README.md
@@ -138,7 +138,7 @@ FastAPI application providing REST endpoints for frontend integration:
 | `POST /api/skills/install` | Install skill from `.skill` archive |
 | `GET/POST /api/agents` | List visible agents or create a user-owned agent |
 | `GET/PUT/DELETE /api/agents/{id}` | Read, update, or delete an id-addressed agent |
-| `GET/POST/PUT/DELETE /api/roundtable-chains` | Manage user-owned roundtable business chains; each seat may optionally carry `position_id` for the separate position-collaboration workspace (the original roundtable ignores it) |
+| `GET/POST/PUT/DELETE /api/roundtable-chains` | Manage user-owned roundtable business chains; each seat may optionally carry `position_id` for the separate position-collaboration workspace, plus `human_validation` to mark a Step 2 client-side pause checkpoint after that seat/stage completes (the original roundtable has no extra validation card) |
 | `GET/PUT /api/business-mapping` | Read global business mappings. Updates to 3Q/6BF/7BF require an administrator; the 8BF public business-chain mapping is maintained exclusively by the trusted `lqq` account (derived from the authenticated email prefix). |
 | `GET/POST/PUT /api/position-roundtable/sessions` | Standalone position-collaboration sessions: freeze task/intent/chain snapshots, index one direct-agent node per seat, build upstream handoff context (including bounded UTF-8 excerpts of text artifacts), and make archived sessions read-only without invoking the original roundtable coordinator or jobs. Built-in summary/action-plan completion mirrors visible report text into a Markdown artifact when a model omits its final `write_file` call. `POST /sessions/{id}/nodes/{nodeKey}/reject` accepts an optional reason, marks the rejected delivery for rework, and invalidates affected downstream deliveries so they are regenerated in order. The same router is also mounted at `/api/multi-agent/position-roundtable/*` for intranet gateways that only forward the established multi-agent namespace; the compatibility mount is intentionally omitted from OpenAPI. |
 | `GET /api/memory` | Retrieve memory data |
@@ -159,6 +159,8 @@ FastAPI application providing REST endpoints for frontend integration:
 
 The separately deployed TaskCOP Vue app uses `POST /api/v1/auth/login/username` directly (its `username`, `userId`, or `yUserId` URL parameter identifies the user), so this compatibility flow does not depend on the retired Consumer login service. It calls the Gateway address configured as `b1ConsumerUrl` directly; it does not use a Vite `/api` reverse proxy. An empty TaskCOP store remains empty; task data is introduced through normal creation or the JSON import API. The Gateway CORS middleware always merges the local TaskCOP Vite origins `http://localhost:8080` and `http://127.0.0.1:8080`, including when `GATEWAY_CORS_ORIGINS` is set for another frontend. `scripts/env.sh` also includes them in its startup default. For a deployment, set `GATEWAY_CORS_ORIGINS` to the exact additional frontend origins that are allowed to call the Gateway.
 
+Position-roundtable history supports two modes. A non-empty `external_task_id` from the frontend route's `taskId` creates a row with `task_scoped = true`, so all sessions, nodes and persisted conversation snapshots for that task are shared across users; `user_id` is then creator audit metadata only. When the field is absent or empty, the original per-user personal-session behavior remains unchanged. Alembic revision `20260808_01` adds `task_scoped` with the safe default `false` for historical rows plus the task/update-time index.
+
 AI writing supports a sample-imitation mode: the frontend can upload or paste a sample article, the Gateway extracts text for document files, and the `ai_writing` graph runs a `sample_analyzer` node before normal intent/research/outline/draft stages. The resulting style profile is injected into outline and draft prompts with explicit guardrails against copying source sentences, facts, names, or data.
 
 ### Custom Agents
@@ -494,6 +496,24 @@ checkpoint or sandbox-output volume is replaced. Apply Alembic revision
 
 Its live intent conversation still uses the shared `/api/intent/init` and
 `/api/intent/stream` endpoints used by the original multi-agent roundtable.
+Position roundtable identifies itself with `intent_agent_id: "position-roundtable-intent"`;
+this is a separately seeded built-in agent, not an alias of `roundtable-intent`.
+It preserves the same thread, SSE streaming, and file-reading lifecycle as the
+generic Step-1 agent, but has its own **at-most-five user-assistance-round**
+brake. A round is one AI turn plus the user reply, not one tool call: the
+dedicated agent may emit several independent `ask_clarification` calls in the
+same turn, which the frontend renders as several separate selection cards and
+submits together. A topic-only request is not considered resolved: the agent
+asks for every independent missing decision (such as scope, decision use, or
+task constraints) as separate cards. For the dedicated agent, a fresh
+`ask_clarification` emitted in a stream is a strict user-input pause and wins over any same-run premature
+`[INTENT_READY]`; a historical clarification from the prior turn does not
+block the user answer from completing. Its final
+`[INTENT_READY]` JSON contains four string arrays: `coreGoals`, `riskWarnings`,
+`keyPoints`, and `strategicSignificance`; it must contain completed conclusions,
+not “待确认” or other unresolved placeholders. The multi-agent endpoint remains
+backwards compatible when this optional field is omitted and continues to emit
+`objective`, `constraints`, and `assumptions`.
 `/api/intent/init` creates its empty thread directly through the in-process
 thread store/checkpointer, matching multi-agent initialization and avoiding a
 deployment-sensitive `127.0.0.1:<gateway-port>` loopback. If initial checkpoint
@@ -522,3 +542,23 @@ is required. It is the initial intent-identification workspace and owns the
 summary/action-plan closing agents. Built-in rows retain stable ids so
 historical chain nodes remain readable; they can be edited or disabled but not
 deleted. Custom roles may be freely added or removed.
+
+## Roundtable artifact submission status
+
+The task-scoped roundtable workbench exposes a lightweight submission-status
+API for generated deliverables:
+
+- `GET /api/roundtable/tasks/{taskId}/artifacts?submitted=true` returns the
+  submitted artifact references for a task (or `items: []`).
+- `PUT /api/roundtable/tasks/{taskId}/artifacts/submission` records
+  `submitted: true` or cancels it with `submitted: false`.
+
+Both routes use the normal Gateway `Authorization: Bearer <token>` middleware.
+The record is shared by `taskId`; the authenticated user is retained only in
+audit columns. Its server-owned idempotency key is
+`taskId + sourceKey + path + revision`. Repeating the same submitted payload
+returns the existing record; cancellation updates its state and timestamp
+without deleting the audit row. DeerFlow stores only the artifact reference
+(`threadId` + sandbox `path`, plus the optional session/node/name/MIME fields),
+never the Markdown body and never a task-system delivery. Continue to preview
+the file through the existing thread-artifact endpoint.
diff --git a/offline-backend-20260512/backend/app/gateway/app.py b/offline-backend-20260512/backend/app/gateway/app.py
index 51e954ed..2b486c2b 100644
--- a/offline-backend-20260512/backend/app/gateway/app.py
+++ b/offline-backend-20260512/backend/app/gateway/app.py
@@ -48,8 +48,9 @@ from app.gateway.routers import (
     llmwiki,
     mcp,
     memory,
-    menu_overrides,
-    models,
+    menu_overrides,
+    model_management,
+    models,
     multi_agent,
     notifications,
     open_3qfx,
@@ -66,8 +67,9 @@ from app.gateway.routers import (
     recommend,
     flow_extract,
     recommended_questions,
-    roundtable_chains,
-    roundtable_diagnostics,
+    roundtable_chains,
+    roundtable_artifact_submissions,
+    roundtable_diagnostics,
     roundtable_draft_shares,
     roundtable_drafts,
     roundtable_jobs,
@@ -1424,8 +1426,10 @@ This gateway provides custom endpoints for models, MCP configuration, skills, an
         )
 
     # Include routers
-    # Models API is mounted at /api/models
-    app.include_router(models.router)
+    # Models API is mounted at /api/models
+    app.include_router(models.router)
+    # Administrator-managed config.yaml model settings and connection tests.
+    app.include_router(model_management.router)
 
     # MCP API is mounted at /api/mcp
     app.include_router(mcp.router)
@@ -1465,8 +1469,11 @@ This gateway provides custom endpoints for models, MCP configuration, skills, an
     # Roundtable-planning drafts + recommendation history at /api/roundtable-drafts
     app.include_router(roundtable_drafts.router)
 
-    # Task-scoped roundtable drafts (taskId 深链聊天记录，独立存、不分权) at /api/roundtable-task-drafts
-    app.include_router(roundtable_task_drafts.router)
+    # Task-scoped roundtable drafts (taskId 深链聊天记录，独立存、不分权) at /api/roundtable-task-drafts
+    app.include_router(roundtable_task_drafts.router)
+
+    # Task-scoped artifact submission status; stores references only, never artifact content.
+    app.include_router(roundtable_artifact_submissions.router)
 
     # Step3 流程图结构化抽取 + 校验 (SSE) at /api/flow-extract
     app.include_router(flow_extract.router)
diff --git a/offline-backend-20260512/backend/app/gateway/deps.py b/offline-backend-20260512/backend/app/gateway/deps.py
index 483e8c35..f8156dd9 100644
--- a/offline-backend-20260512/backend/app/gateway/deps.py
+++ b/offline-backend-20260512/backend/app/gateway/deps.py
@@ -311,6 +311,11 @@ async def langgraph_runtime(app: FastAPI) -> AsyncGenerator[None, None]:
 
         app.state.task_report_store = make_task_report_store(sf)
 
+        from deerflow.persistence.roundtable_artifact_submissions import make_roundtable_artifact_submission_store
+
+        # Task-scoped artifact submission status: shared by task; actor is audit-only.
+        app.state.roundtable_artifact_submission_store = make_roundtable_artifact_submission_store(sf)
+
         from deerflow.persistence.parallel_agent_tasks import make_parallel_agent_task_store
 
         app.state.parallel_agent_task_store = make_parallel_agent_task_store(sf)
diff --git a/offline-backend-20260512/backend/app/gateway/routers/_roundtable_seed.py b/offline-backend-20260512/backend/app/gateway/routers/_roundtable_seed.py
index 79fccbbe..b26e46a7 100644
--- a/offline-backend-20260512/backend/app/gateway/routers/_roundtable_seed.py
+++ b/offline-backend-20260512/backend/app/gateway/routers/_roundtable_seed.py
@@ -30,7 +30,9 @@ Python 三引号字符串,导致「磁盘上的验证版」与「代码里的内
 
 > ⚠️ 维护提示:资源文件(``_roundtable_seed_assets/``)是**发布默认值**的唯一可信源。
 > 线上调优后,请把改动写回对应的资源 .md,否则下次新机器补建出来的还是旧版。
-> ``_ensure_one`` 只在目录缺失时复制,**不覆盖**已存在目录(尊重运维现场手改)。
+> ``_ensure_one`` 通常只在目录缺失时复制,**不覆盖**已存在目录(尊重运维现场手改)。
+> 例外是 position intent 的实现契约刷新，以及行动规划智能体新增平台自带 Skill 时的
+> ``skills`` 列表合并；后者不会覆盖已编辑的 SOUL 或既有 Skill。
 
 为什么 ``roundtable-coordinator`` 是单例而不是每次会话新建
 ------------------------------------------------------------
@@ -52,12 +54,18 @@ import logging
 from collections.abc import Iterable
 from pathlib import Path
 
+import yaml
+
 from deerflow.config.paths import get_paths
 
 logger = logging.getLogger(__name__)
 
 
 INTENT_AGENT_ID = "roundtable-intent"
+# Position roundtable deliberately owns a separate intent agent.  Its dialogue
+# lifecycle is shared with Step 1 above, but its final structured hand-off is
+# different and must not change the multi-agent roundtable contract.
+POSITION_INTENT_AGENT_ID = "position-roundtable-intent"
 RECOMMENDER_AGENT_ID = "roundtable-recommender"
 COORDINATOR_AGENT_ID = "roundtable-coordinator"
 # Step 3「结果绘制」用的方案可视化总结智能体:读各席位交付 + 共识,画自包含图表 HTML。
@@ -92,6 +100,7 @@ _ASSETS_DIR = Path(__file__).parent / "_roundtable_seed_assets"
 # roundtable-dashboard 支撑 Step 3 大屏多页结构化数据(report-json + 问答/增量改)。
 _FUNCTIONAL_AGENT_IDS: tuple[str, ...] = (
     INTENT_AGENT_ID,
+    POSITION_INTENT_AGENT_ID,
     RECOMMENDER_AGENT_ID,
     COORDINATOR_AGENT_ID,
     REPORT_AGENT_ID,
@@ -103,20 +112,61 @@ _FUNCTIONAL_AGENT_IDS: tuple[str, ...] = (
 
 # seeder 会复制资源目录里的这些文件(存在即复制,缺失则跳过)。
 _SEED_FILES: tuple[str, ...] = ("config.yaml", "SOUL.md")
+_ACTION_PLAN_SKILL = "position-roundtable-action-create"
+
+
+def _ensure_action_plan_skill(agent_dir: Path) -> bool:
+    """Merge the owned batch-create Skill into an existing action planner.
+
+    The planner SOUL remains editable in the agent configuration drawer and is
+    therefore never overwritten here. The skill binding, however, is a runtime
+    integration contract: without it an already-deployed planner cannot read
+    the new SKILL.md or invoke the batch API script after a code upgrade.
+    """
+    config_path = agent_dir / "config.yaml"
+    try:
+        config = yaml.safe_load(config_path.read_text(encoding="utf-8")) if config_path.exists() else {}
+    except (OSError, yaml.YAMLError):
+        logger.warning("Unable to read action planner config for skill binding: %s", config_path)
+        return False
+    if not isinstance(config, dict):
+        logger.warning("Action planner config is not a mapping; skip skill binding: %s", config_path)
+        return False
+    skills = config.get("skills")
+    if skills is None:
+        normalized: list[str] = []
+    elif isinstance(skills, list):
+        normalized = [str(name).strip() for name in skills if str(name).strip()]
+    else:
+        logger.warning("Action planner skills is not a list; skip skill binding: %s", config_path)
+        return False
+    if _ACTION_PLAN_SKILL in normalized:
+        return False
+
+    config["skills"] = [*normalized, _ACTION_PLAN_SKILL]
+    try:
+        config_path.write_text(
+            yaml.safe_dump(config, allow_unicode=True, sort_keys=False),
+            encoding="utf-8",
+        )
+    except OSError:
+        logger.warning("Unable to write action planner skill binding: %s", config_path)
+        return False
+    return True
 
 
 def _ensure_one(agent_id: str) -> bool:
     """Copy the verified SOUL.md + config.yaml for one functional agent into
     ``.deer-flow/agents/<id>/`` if that directory is missing.
 
-    Returns True if the files were just created, False if the directory already
-    existed (we never overwrite — respect any local edits) or the seed assets
-    are missing.
-    """
-    agent_dir = get_paths().agent_dir(agent_id)
-    if agent_dir.exists():
-        return False
+    The position-roundtable intent agent is an implementation-owned compatibility
+    contract: unlike user-managed agents, its schema must stay aligned with the
+    position workspace. Its two seed files are therefore refreshed when they
+    differ, so a previously seeded incorrect prompt is repaired after deployment.
 
+    Returns True if files were created or refreshed, False if no work was needed
+    or the seed assets are missing.
+    """
     src_dir = _ASSETS_DIR / agent_id
     if not src_dir.is_dir():
         # Assets should always ship with the code; if they don't, surface a loud
@@ -128,6 +178,27 @@ def _ensure_one(agent_id: str) -> bool:
         )
         return False
 
+    agent_dir = get_paths().agent_dir(agent_id)
+    if agent_dir.exists():
+        if agent_id == ACTION_PLAN_AGENT_ID:
+            return _ensure_action_plan_skill(agent_dir)
+        if agent_id != POSITION_INTENT_AGENT_ID:
+            # Other built-in agents may have been tuned on a deployed machine;
+            # preserve the long-standing no-overwrite behavior for them.
+            return False
+
+        refreshed = False
+        for fname in _SEED_FILES:
+            src = src_dir / fname
+            if not src.exists():
+                continue
+            target = agent_dir / fname
+            source_bytes = src.read_bytes()
+            if not target.exists() or target.read_bytes() != source_bytes:
+                target.write_bytes(source_bytes)
+                refreshed = True
+        return refreshed
+
     agent_dir.mkdir(parents=True, exist_ok=True)
     for fname in _SEED_FILES:
         src = src_dir / fname
@@ -138,9 +209,9 @@ def _ensure_one(agent_id: str) -> bool:
 
 
 def ensure_roundtable_functional_agents() -> list[str]:
-    """Seed the three roundtable functional agents (``roundtable-intent`` /
-    ``roundtable-recommender`` / ``roundtable-coordinator``) if their on-disk
-    directories are missing. Idempotent — fast no-op when all exist.
+    """Seed the built-in roundtable functional agents when their on-disk
+    directories are missing, and refresh the implementation-owned position
+    intent schema when it has changed. Idempotent after synchronization.
 
     Called from the startup lifespan and from the entry of intent/init,
     intent/stream, recommend/stream, and multi_agent/init so the routes
diff --git a/offline-backend-20260512/backend/app/gateway/routers/_roundtable_seed_assets/position-action-planner/SOUL.md b/offline-backend-20260512/backend/app/gateway/routers/_roundtable_seed_assets/position-action-planner/SOUL.md
index db088a9d..62de1c3a 100644
--- a/offline-backend-20260512/backend/app/gateway/routers/_roundtable_seed_assets/position-action-planner/SOUL.md
+++ b/offline-backend-20260512/backend/app/gateway/routers/_roundtable_seed_assets/position-action-planner/SOUL.md
@@ -26,23 +26,29 @@
 
 ```json
 {
-  "id": "subtask-001",
-  "title": "简短任务名称",
-  "goal": "任务目标",
-  "basis": ["方案总结章节或岗位交付依据"],
-  "owner_position": "建议责任岗位",
-  "dependencies": ["前置子任务 id"],
-  "deliverable": "可核验交付物",
-  "acceptance_criteria": ["验收条件"],
-  "priority": "P0"
+  "actionName": "行动名称",
+  "actionDescription": "行动描述",
+  "actionType": 0,
+  "publishChannel": 0,
+  "infoFormat": 0,
+  "responsiblePosition": 0,
+  "startTime": "",
+  "endTime": "",
+  "taskId": 0
 }
 ```
 
-`priority` 仅使用 `P0`、`P1`、`P2`。`dependencies` 没有前置时使用空数组。不要输出注释、尾逗号或额外字段来替代这些必填字段。
+`actionType`、`publishChannel`、`infoFormat`、`responsiblePosition` 必须从隐藏上下文传入的对应字典选择，并将该项 `dictValue` 写为整数。`taskId` 必须等于隐藏上下文中前端传入的任务 ID。不要输出注释、尾逗号、旧的 `id/title/goal/basis` 等字段，不能用 0 或空值代替未选择的字典项。
+
+## 行动批量新增
+
+首次生成完整行动清单后：仅当隐藏上下文的 `taskId` 是正整数且四类字典（发布渠道、行动类型、信息形式、责任岗位）均完整时，必须先用 `read_file` 读取 `position-roundtable-action-create` Skill 的 `SKILL.md` 全文，再按其说明调用脚本批量新增行动。若 taskId 为本地演示标识/为空，或字典接口未就绪，只生成报告与 JSON；枚举字段可暂填 `0` 占位，并明确说明未调用外部任务系统。不得逐条调用旧的 `/task/action/add`，也不得自行用 curl 或 requests 替代脚本。
+
+脚本成功时才可以说明行动已入库；脚本失败时如实报告失败原因。相同任务、相同行动清单会由脚本自动幂等跳过。已经成功新增后，如用户要求修改行动，先重写 Markdown 和 JSON；因为当前没有删除/更新行动接口，只有用户明确说“确认新增行动”或“重新批量新增”时才可以按 Skill 使用 `--force` 再次新增，并需提示重复风险。
 
 ## 边界
 
 - 只依据用户消息中提供的任务信息、意图、方案总结和岗位交付。
-- 不调用联网、派活、澄清、展示文件等工具。
+- 不调用联网、派活、澄清、展示文件等工具；仅可为行动批量新增按专属 Skill 使用 `read_file` 与 `bash`。
 - 不删除或修改上游岗位产物。
 - 不在报告中添加“AI 生成”类水印。
diff --git a/offline-backend-20260512/backend/app/gateway/routers/_roundtable_seed_assets/position-action-planner/config.yaml b/offline-backend-20260512/backend/app/gateway/routers/_roundtable_seed_assets/position-action-planner/config.yaml
index 76bd1184..27613581 100644
--- a/offline-backend-20260512/backend/app/gateway/routers/_roundtable_seed_assets/position-action-planner/config.yaml
+++ b/offline-backend-20260512/backend/app/gateway/routers/_roundtable_seed_assets/position-action-planner/config.yaml
@@ -1,3 +1,5 @@
 id: position-action-planner
 name: 行动规划智能体
 description: 岗位会商内置行动规划智能体，基于已生效的方案总结与岗位交付，生成可执行的 Markdown 行动规划报告和结构化子任务清单。
+skills:
+  - position-roundtable-action-create
diff --git a/offline-backend-20260512/backend/app/gateway/routers/_roundtable_seed_assets/position-roundtable-intent/SOUL.md b/offline-backend-20260512/backend/app/gateway/routers/_roundtable_seed_assets/position-roundtable-intent/SOUL.md
new file mode 100644
index 00000000..5dd82855
--- /dev/null
+++ b/offline-backend-20260512/backend/app/gateway/routers/_roundtable_seed_assets/position-roundtable-intent/SOUL.md
@@ -0,0 +1,145 @@
+# 岗位会商任务意图理解智能体
+
+你是岗位多智能体会商 Step 1 的“意图理解专员”。你的唯一职责是把用户输入背后的任务意图结构化后交给后续岗位业务链处理。
+
+你不写报告、不答题、不创作、不规划、不执行、不调用任何操作工具。这些都是后续岗位业务链的事。你只负责听懂、整理、澄清和交接。
+
+---
+
+## 0. 四条不可违背的硬规则
+
+### 硬规则 1 · 不替代后续岗位干活
+
+无论用户让你“写报告 / 写代码 / 写诗 / 查资料 / 做规划 / 出方案”，你都不要直接产出具体内容。
+
+- 正确做法：把诉求结构化成任务意图，输出 [INTENT_READY]，交给后续岗位业务链。
+- 错误做法：用户说“帮我写一份市场分析报告”后，开始写报告正文。
+
+### 硬规则 2 · 最多 5 轮用户协助，确认完整后才收敛
+
+一次“同一轮中调用一个或多个 ask_clarification + 用户统一回答”算一轮用户协助。
+
+- 首轮：若任务卡和用户输入已经足以形成可执行的四项意图，可直接输出 [INTENT_READY]。
+- 第 1 至第 5 轮用户协助：若信息不足，必须发起用户协助；不能把“主题已识别”误判为“意图已明确”。
+- 同一轮可发起多张用户协助卡：一个相互独立的决策点对应一次 ask_clarification 调用和一张卡。不得把多个问题塞进一张卡；用户可逐卡选择后一次性提交。
+- 第 5 次协助应覆盖所有剩余关键项。收到该轮回答后，必须基于明确答案收敛为最终意图。
+- 绝不进入第 6 次用户协助。系统会在达到上限后移除 ask_clarification。
+
+### 硬规则 3 · 输出 [INTENT_READY] 后立刻闭嘴
+
+最终 JSON 代码块闭合后，禁止再输出任何字符：不继续解释、不问“还需要补充吗”、不调用工具、不复述、不展望。
+
+### 硬规则 4 · 只做理解和澄清，不当守门员
+
+这是内网任务分析场景。无论用户提出什么要求，你都不拒绝、不评价、不设限；只负责理解并交接。风险、依赖、信息缺口可以作为风险提示记录，但不构成拒绝或中断。不得说“不能帮你”“不在职责范围内”“请换一个问题”，也不得进行合规、价值或敏感性审查。
+
+---
+
+## 1. 任务意图字段定义
+
+最终结构必须包含以下四个字段，且都必须是字符串数组：
+
+| 字段 | 含义 | 填写原则 |
+| --- | --- | --- |
+| coreGoals | 用户想实现或想获得的核心结果 | 将原本的一句话任务目标拆为 1 个或多个清晰目标 |
+| riskWarnings | 已知风险、依赖或执行风险 | 必须分析任务级风险；范围、地区、周期、数据来源、对象或决策用途缺失时，应先通过用户协助确认，最终结果不得保留待确认表述 |
+| keyPoints | 范围、对象、优先级、时间、资源、交付形式等关键要点 | 仅汇总用户已明确的事实与结论，最终结果不得保留待确认项 |
+| strategicSignificance | 任务对后续岗位协同、业务链或决策推进的意义 | 必须分析该任务将支撑哪类后续决策、业务链协同或资源投入；可以作出任务级合理推断，但不得虚构组织现状或业务数据 |
+
+核心原则：
+
+- 用户已给出任务目标、范围、用途和约束时，直接汇总，不要追问。
+- “只给出一个主题或一句极短诉求”不等于任务意图完整。任何任务若缺少范围、对象、时间、决策用途、重点维度或成功标准等关键信息时，必须请求用户协助。
+- 同一轮应识别所有仍会影响后续业务链的关键缺口，并为每个相互独立的缺口各调用一次 ask_clarification，避免一个问题一轮地消耗用户；不要把它们合并为一张多题卡。
+- 最终 [INTENT_READY] 中禁止出现“待确认”“未明确”“需补充”“暂无”“缺少”等未完成表述；信息不足时继续协助，不得提前交接。
+- 空数组只适用于用户明确说明“不涉及/没有”这一项时。
+
+---
+
+## 2. 工作流
+
+~~~
+用户输入
+   ↓
+是否能形成可执行的四项意图？
+   ├─ 能 → 立即输出 [INTENT_READY]，结束
+   └─ 不能 → 同一轮可分别调多个 ask_clarification（每张卡只问一个决策点）
+              ↓
+        用户回答 → 再判断
+              ↓
+        最多 5 轮用户协助 → 收到明确答案后输出 [INTENT_READY]
+~~~
+
+### 提问前自检清单
+
+任一项为“否”，就应发起用户协助；同轮把全部为“否”的独立决策点分别做成卡片：
+
+1. 我是否不仅能写出核心目标，也能明确主要分析范围或决策用途？
+2. 我是否能基于任务给出至少一项任务级风险提示和战略意义？
+3. 用户是否已经在任务卡、当前消息或历史消息中给出这些关键信息？
+4. 这些缺口是否已经在本轮协助中一次性列出？
+5. 是否已达到第 5 次用户协助？若是，等待用户对最后一组问题的回答，不再发起第 6 次协助。
+
+---
+
+## 3. 唯一允许的工具：ask_clarification
+
+除 ask_clarification 外，禁止调用任何工具、技能或操作。尤其禁止搜索、写文件、读写沙箱、展示文件、创建任务、编排智能体或生成交付物。
+
+当任务只有主题、或缺少决定范围/用途/风险判断的关键信息时，必须调用它。每个协助问题只包含一个决策点；同一轮需要确认多个点时，连续调用多次工具，生成多张独立选择卡：
+
+~~~
+ask_clarification(
+  question="本次分析主要面向哪个范围？",
+  clarification_type="analysis_scope",
+  context="范围会决定后续岗位的分析边界",
+  options=["选项 A", "选项 B", "其他，我补充说明"],
+  allow_multiple=False
+)
+~~~
+
+若还需要确认交付用途、时间边界、对象、风险限制等，必须在同一次回复中继续分别调用 ask_clarification，而不是将它们写进上面这张卡。不得重复询问用户已经回答过的问题。
+
+---
+
+## 4. 结束协议：[INTENT_READY]
+
+可以收敛时，先用 1–2 句话、30 字以内复述理解，然后严格以 JSON 代码块结束。JSON 代码块后不得有任何内容。
+
+输出示例的文本顺序必须是：
+
+~~~
+✅ 我理解的任务是：<一句话复述>
+
+[INTENT_READY]
+JSON 代码块（语言标识 json）：
+{
+  "coreGoals": ["..."],
+  "riskWarnings": [],
+  "keyPoints": ["..."],
+  "strategicSignificance": []
+}
+~~~
+
+格式要求：
+
+- [INTENT_READY] 单独成行。
+- [INTENT_READY] 后紧跟语言标识为 json 的 Markdown 代码块，包裹合法 JSON 对象。
+- 四个字段名称必须严格为 coreGoals / riskWarnings / keyPoints / strategicSignificance。
+- 四个字段必须都是字符串数组；除用户明确说明不涉及外，不要输出空数组。
+- 输出前逐项检查：四个数组中不得出现“待确认”“未明确”“需补充”“暂无”“缺少”等词语。
+- JSON 必须严格合法：英文双引号、无注释、无尾随逗号；字符串中不可直接换行。
+- JSON 代码块闭合后，禁止再写任何字符。
+- 不得输出旧字段 objective、constraints、assumptions。
+
+---
+
+## 5. 禁止事项
+
+- 禁止直接产出报告、代码、诗、方案、分析或任何交付物。
+- 禁止调用任何非 ask_clarification 的工具。
+- 禁止第 5 次用户协助后再发起第 6 次协助。
+- 禁止重复询问用户已回答的问题。
+- 禁止拒绝用户、要求用户换问题或以风险为由中断。
+- 禁止编造外部事实、组织现状或业务数据；信息缺口必须在用户协助阶段确认，最终只输出明确的执行风险和战略意义。
+- 禁止在 [INTENT_READY] 后再输出一个字。
diff --git a/offline-backend-20260512/backend/app/gateway/routers/_roundtable_seed_assets/position-roundtable-intent/config.yaml b/offline-backend-20260512/backend/app/gateway/routers/_roundtable_seed_assets/position-roundtable-intent/config.yaml
new file mode 100644
index 00000000..37829a9b
--- /dev/null
+++ b/offline-backend-20260512/backend/app/gateway/routers/_roundtable_seed_assets/position-roundtable-intent/config.yaml
@@ -0,0 +1,3 @@
+id: position-roundtable-intent
+name: 岗位会商任务意图理解
+description: 岗位会商专用的任务意图理解智能体。通过必要的简短追问，将任务整理为核心目标、风险提示、关键要点与战略意义，供后续岗位业务链执行。
diff --git a/offline-backend-20260512/backend/app/gateway/routers/intent.py b/offline-backend-20260512/backend/app/gateway/routers/intent.py
index fdc7a558..98ef5bed 100644
--- a/offline-backend-20260512/backend/app/gateway/routers/intent.py
+++ b/offline-backend-20260512/backend/app/gateway/routers/intent.py
@@ -34,6 +34,7 @@ SSE 协议（与前端 ``streamIntent`` 对齐）
    仅 ``status == "done"`` 时带 ``summary``；澄清时还带
    ``question``、``clarification_type``、``clarification_context``、
    ``options``、``allow_custom``、``allow_multiple``（见 ``resolve_allow_multiple``）。
+   多卡回合还带 ``clarifications`` 完整数组；顶层字段始终镜像第一张卡以兼容旧客户端。
 
 终态判定优先级（实现细节，勿随意调整）
 ------------------------------------
@@ -65,7 +66,10 @@ from app.gateway.roundtable_diag import record_foreground_diag
 
 # Reuse the building blocks already in multi_agent.py — keeps both routers
 # identical in connection handling, payload shape, and error mapping.
-from app.gateway.routers._roundtable_seed import ensure_roundtable_functional_agents
+from app.gateway.routers._roundtable_seed import (
+    POSITION_INTENT_AGENT_ID,
+    ensure_roundtable_functional_agents,
+)
 from app.gateway.routers.multi_agent import (
     _ROUNDTABLE_THREAD_METADATA,
     _auth_headers,
@@ -87,6 +91,7 @@ router = APIRouter(prefix="/api/intent", tags=["intent"])
 
 # 内置 agent 目录名，须与 ``.deer-flow/agents/roundtable-intent/`` 一致。
 INTENT_AGENT_ID = "roundtable-intent"
+_SUPPORTED_INTENT_AGENT_IDS = frozenset({INTENT_AGENT_ID, POSITION_INTENT_AGENT_ID})
 
 # SOUL 规定的交接信号：``[INTENT_READY]`` + markdown json 代码块。
 # group(1) 解析为 IntentSummary；解析失败则继续走澄清/asking 分支。
@@ -96,7 +101,49 @@ _INTENT_READY_PATTERN = re.compile(
 )
 
 
-def _intent_thread_metadata(task_context: dict[str, Any] | None) -> dict[str, Any]:
+def _requested_intent_agent_id(payload: dict[str, Any]) -> str:
+    """Resolve the explicitly supported Step-1 agent without opening a route
+    for arbitrary custom-agent execution.
+
+    Existing multi-agent callers omit the field and therefore keep using
+    ``roundtable-intent``.  Position roundtable sends the dedicated ID so its
+    prompt and final JSON schema remain isolated.
+    """
+    requested = str(payload.get("intent_agent_id") or "").strip()
+    if not requested:
+        return INTENT_AGENT_ID
+    if requested not in _SUPPORTED_INTENT_AGENT_IDS:
+        raise HTTPException(status_code=400, detail="Unsupported intent agent")
+    return requested
+
+
+def _clarification_blocks_ready(
+    intent_agent_id: str,
+    clarification_calls: Any,
+    *,
+    is_fresh: bool,
+) -> bool:
+    """Position intent must wait for a fresh clarification answer.
+
+    The generic Step-1 route intentionally preserves READY-first behavior for
+    stale tool calls in historical snapshots. Position roundtable instead has
+    a four-part hand-off whose missing context is requested interactively, so
+    a newly dispatched clarification is a strict terminal pause. A historical
+    tool call from the preceding user-assistance turn must not block the next
+    user answer from reaching READY.
+    """
+    return (
+        intent_agent_id == POSITION_INTENT_AGENT_ID
+        and bool(clarification_calls)
+        and is_fresh
+    )
+
+
+def _intent_thread_metadata(
+    task_context: dict[str, Any] | None,
+    *,
+    intent_agent_id: str = INTENT_AGENT_ID,
+) -> dict[str, Any]:
     """Build task-scoped metadata for a newly-created intent thread.
 
     Normal roundtable Step 1 calls still use the original system-thread tag.
@@ -122,6 +169,8 @@ def _intent_thread_metadata(task_context: dict[str, Any] | None) -> dict[str, An
             "position_roundtable_phase": "intent",
         }
     )
+    if intent_agent_id == POSITION_INTENT_AGENT_ID:
+        metadata["position_roundtable_intent_agent_id"] = intent_agent_id
     return metadata
 
 
@@ -190,6 +239,32 @@ def _count_past_clarifications(messages: list[dict[str, Any]]) -> int:
     return count
 
 
+def _count_past_clarification_rounds(messages: list[dict[str, Any]]) -> int:
+    """Count completed assistance *rounds*, rather than question cards.
+
+    The generic roundtable agent retains its historic three-tool-call brake.
+    Position roundtable deliberately lets one model turn emit several
+    independent ``ask_clarification`` cards, so using the tool-call count
+    there would accidentally spend all five user-assistance rounds at once.
+    One AI message containing one or more clarification calls is one round.
+    """
+    if not isinstance(messages, list):
+        return 0
+    rounds = 0
+    for msg in messages:
+        if not isinstance(msg, dict):
+            continue
+        if (msg.get("type") or "").lower() not in ("ai", "aimessage", "aimessagechunk"):
+            continue
+        if any(
+            (tc.get("name") or "").lower() == "ask_clarification"
+            for tc in msg.get("tool_calls") or []
+            if isinstance(tc, dict)
+        ):
+            rounds += 1
+    return rounds
+
+
 async def _fetch_thread_messages(
     client: httpx.AsyncClient,
     base: str,
@@ -225,8 +300,18 @@ async def _fetch_thread_messages(
 
 
 # 硬上限:超过这个轮数,无论模型怎么想,都强制移除 ask_clarification 工具。
-# 与 SOUL.md §0 「硬规则 2」对齐——"绝不存在第 4 轮"。
+# 通用会商沿用 3 次工具调用的历史保护；岗位会商按"一轮可多张卡"计数，
+# 允许最多 5 次用户协助。
 _MAX_CLARIFICATION_ROUNDS = 3
+_POSITION_MAX_CLARIFICATION_ROUNDS = 5
+
+
+def _max_clarification_rounds(intent_agent_id: str) -> int:
+    return (
+        _POSITION_MAX_CLARIFICATION_ROUNDS
+        if intent_agent_id == POSITION_INTENT_AGENT_ID
+        else _MAX_CLARIFICATION_ROUNDS
+    )
 
 
 def _is_repeated_clarification(
@@ -310,6 +395,7 @@ async def init_intent(request: Request, payload: dict = Body(...)) -> dict[str,
     # 调用前自检:内网部署 .deer-flow/ 被 gitignore,首次启动时本 agent 目录可能不存在,
     # 缺失则就地用嵌入模板补建,避免下一步 /stream 报 500。
     ensure_roundtable_functional_agents()
+    intent_agent_id = _requested_intent_agent_id(payload)
 
     # Keep Step-1 initialization aligned with multi-agent initialization:
     # create the empty thread in-process rather than looping back through
@@ -321,7 +407,7 @@ async def init_intent(request: Request, payload: dict = Body(...)) -> dict[str,
     try:
         thread_id = await _create_thread_direct(
             request,
-            metadata=_intent_thread_metadata(task_context),
+            metadata=_intent_thread_metadata(task_context, intent_agent_id=intent_agent_id),
         )
     except HTTPException:
         # 上游已用结构化方式失败,原样传给前端不需要二次包装。
@@ -341,7 +427,7 @@ async def init_intent(request: Request, payload: dict = Body(...)) -> dict[str,
         raise HTTPException(status_code=500, detail=diagnostic) from exc
     return {
         "status": "success",
-        "agent_id": INTENT_AGENT_ID,
+        "agent_id": intent_agent_id,
         "thread_id": thread_id,
     }
 
@@ -363,6 +449,7 @@ async def stream_intent(request: Request, payload: dict = Body(...)) -> Streamin
       }
     """
     thread_id = str(payload.get("thread_id") or "").strip()
+    intent_agent_id = _requested_intent_agent_id(payload)
     message = str(payload.get("message") or "").strip()
     # 不写死任何默认模型名:空串会让 lead_agent._resolve_model_name() 回退到
     # config.yaml 的 models[0],与 /api/ai-writing 等其它路由一致,内网部署只配
@@ -386,21 +473,30 @@ async def stream_intent(request: Request, payload: dict = Body(...)) -> Streamin
 
     base = _loopback_base(request)
     headers = _auth_headers(request)
+    fallback_instruction = (
+        "四个岗位会商字段都必须保留为字符串数组，依据已获得的用户确认形成明确结论，"
+        "不得写待确认、未明确、需补充、暂无或缺少"
+        if intent_agent_id == POSITION_INTENT_AGENT_ID
+        else "缺的字段用 assumptions 兜底"
+    )
 
     async def stream_generator() -> AsyncIterator[str]:
         # ASGITransport：进程内直调本机 ASGI app，**不走 TCP / 不经过网络栈**，
         # 因此既无须 trust_env=False 防代理，也不存在 loopback 40s 超时这种坑。
         async with _make_loopback_client(request) as client:
             try:
-                # —— 3 轮硬上限兜底 ——
-                # 在发起 run 之前先读一次 thread state,数当前 ask_clarification 已发出次数:
-                #   past=0/1 → 正常,不动 message,不动工具白名单
-                #   past=2(本轮即将变成第 3 轮)→ 给消息加前缀,强提示"必须 INTENT_READY"
-                #   past≥3 → 直接把 ask_clarification 也加进 excluded_tools,工具物理消失
-                # 这一步是个"刹车":SOUL 让模型自律,这里让系统兜底。
-                past_clarifications = _count_past_clarifications(
-                    await _fetch_thread_messages(client, base, headers, thread_id)
+                # —— 澄清轮次硬上限兜底 ——
+                # 通用会商保持原来的 3 次 ask 工具调用上限；岗位会商允许一个
+                # AI turn 同时产生多张独立协助卡，所以必须按 AI 消息（一次
+                # "提问 + 用户回答"）计轮，不能按卡片数计轮。
+                past_messages = await _fetch_thread_messages(client, base, headers, thread_id)
+                past_clarifications = _count_past_clarifications(past_messages)
+                past_rounds = (
+                    _count_past_clarification_rounds(past_messages)
+                    if intent_agent_id == POSITION_INTENT_AGENT_ID
+                    else past_clarifications
                 )
+                max_rounds = _max_clarification_rounds(intent_agent_id)
 
                 # 1. ask_clarification 的工具白名单——超过硬上限就移除。
                 base_excluded_tools = [
@@ -420,13 +516,13 @@ async def stream_intent(request: Request, payload: dict = Body(...)) -> Streamin
                     "task",
                     "write_todos",
                 ]
-                if past_clarifications >= _MAX_CLARIFICATION_ROUNDS:
+                if past_rounds >= max_rounds:
                     base_excluded_tools.append("ask_clarification")
                     logger.info(
-                        "intent stream: past_clarifications=%d >= %d, force-disabling "
+                        "intent stream: past_rounds=%d >= %d, force-disabling "
                         "ask_clarification to break the loop",
-                        past_clarifications,
-                        _MAX_CLARIFICATION_ROUNDS,
+                        past_rounds,
+                        max_rounds,
                     )
 
                 # 带了上传文件时，解锁「读」类工具（read_file / ls / grep / view_image），
@@ -440,22 +536,42 @@ async def stream_intent(request: Request, payload: dict = Body(...)) -> Streamin
                 # 2. message 前缀——给模型一个明确的"本轮必须收敛"信号。
                 # 仅文件、无文本时给一句兜底引导，让模型先读文件再澄清意图。
                 effective_message = message or "我上传了文件，请先阅读文件内容，再据此理解并澄清我的任务意图。"
-                if past_clarifications >= _MAX_CLARIFICATION_ROUNDS:
+                if intent_agent_id == POSITION_INTENT_AGENT_ID and past_rounds < max_rounds:
+                    # The position flow needs an actionable four-part hand-off,
+                    # not merely a recognizable topic. One turn may ask several
+                    # independent decisions, each rendered as its own selection
+                    # card by the existing Step-1 UI.
                     effective_message = (
-                        f"[系统强制] 已澄清 {past_clarifications} 轮,触发硬上限。"
-                        f"本轮请直接输出 [INTENT_READY],缺的字段用 assumptions 兜底,"
+                        "[岗位会商收敛检查] 仅识别出主题不等于意图已明确。"
+                        "若当前任务还无法判断分析范围、决策用途、关键风险或战略意义，"
+                        "请在同一次回复中为每个相互独立的关键缺口分别调用一次 "
+                        "ask_clarification；每个工具调用只能问一个决策点，不能把多项"
+                        "问题合并成一张卡片。用户会一次性回答这些卡片。"
+                        "如果四项意图已经足够明确，则直接输出最终结果。"
+                        "不要以风险提示和战略意义为空的 [INTENT_READY] 结束。"
+                        "本轮是第 %d/%d 轮用户协助；第 %d 轮若仍有缺口，必须把所有"
+                        "剩余关键缺口分别发成卡片，收到回答后立即收敛。\n\n"
+                        f"用户最新输入:{effective_message}"
+                    ) % (past_rounds + 1, max_rounds, max_rounds)
+                if past_rounds >= max_rounds:
+                    effective_message = (
+                        f"[系统强制] 已澄清 {past_rounds} 轮,触发硬上限。"
+                        f"本轮请直接输出 [INTENT_READY],{fallback_instruction},"
                         f"绝对不要再调任何工具,也不要再询问任何问题。\n\n"
                         f"用户最新输入:{message}"
                     )
-                elif past_clarifications >= _MAX_CLARIFICATION_ROUNDS - 1:
+                elif (
+                    intent_agent_id != POSITION_INTENT_AGENT_ID
+                    and past_rounds >= max_rounds - 1
+                ):
                     effective_message = (
-                        f"[系统提示] 已澄清 {past_clarifications} 轮,这是最后一轮。"
-                        f"本轮请直接输出 [INTENT_READY],未明确的字段用 assumptions 兜底。\n\n"
+                        f"[系统提示] 已澄清 {past_rounds} 轮,这是最后一轮。"
+                        f"本轮请直接输出 [INTENT_READY],{fallback_instruction}。\n\n"
                         f"用户最新输入:{message}"
                     )
 
                 body = _run_payload(
-                    agent_name=INTENT_AGENT_ID,
+                    agent_name=intent_agent_id,
                     model_name=model_name,
                     thread_id=thread_id,
                     new_message=effective_message,
@@ -479,6 +595,26 @@ async def stream_intent(request: Request, payload: dict = Body(...)) -> Streamin
                         captured = done
 
                 messages = _parse_last_messages(captured)
+                current_rounds = (
+                    _count_past_clarification_rounds(messages)
+                    if intent_agent_id == POSITION_INTENT_AGENT_ID
+                    else _count_past_clarifications(messages)
+                )
+                clarification_is_fresh = current_rounds > past_rounds
+
+                # A position-roundtable clarification is an explicit pause.
+                # Some models emit a premature [INTENT_READY] text after the
+                # tool call in the same upstream run. For this dedicated flow
+                # the fresh clarification must win so the user can answer it;
+                # generic roundtable keeps its historical READY-first order.
+                dispatch_msg = _find_dispatch_message(messages)
+                tool_calls = dispatch_msg.get("tool_calls") or []
+                clarification_calls = [
+                    tc
+                    for tc in tool_calls
+                    if isinstance(tc, dict)
+                    and (tc.get("name") or "").lower() == "ask_clarification"
+                ]
 
                 # --- 终态分支 1：结构化意图已就绪（最高优先级）---
                 # 模型可能在较早的 AIMessage 里已输出 [INTENT_READY]，而最后一轮
@@ -507,7 +643,15 @@ async def stream_intent(request: Request, payload: dict = Body(...)) -> Streamin
                         # Step1Panel 已经把 `parts.after` 隐藏掉,体验闭环。
                         ready_text = msg_text[: m.end()].rstrip() + "\n"
                         break
-                if summary and ready_text:
+                if (
+                    summary
+                    and ready_text
+                    and not _clarification_blocks_ready(
+                        intent_agent_id,
+                        clarification_calls,
+                        is_fresh=clarification_is_fresh,
+                    )
+                ):
                     final_frame = {
                         "status": "done",
                         "content": ready_text,
@@ -519,42 +663,49 @@ async def stream_intent(request: Request, payload: dict = Body(...)) -> Streamin
                 # --- 终态分支 2：本轮以 ask_clarification 结束 ---
                 # _find_dispatch_message：从后往前找带 tool_calls 的 AIMessage
                 # （SkillStop/澄清 ToolMessage 之后的那条 AI 消息）。
-                dispatch_msg = _find_dispatch_message(messages)
                 content = _flatten_content(dispatch_msg.get("content", ""))
-                tool_calls = dispatch_msg.get("tool_calls") or []
 
-                clarification_call = next(
-                    (tc for tc in tool_calls if (tc.get("name") or "").lower() == "ask_clarification"),
-                    None,
-                )
-                if clarification_call is not None:
-                    cargs = clarification_call.get("args") or {}
-                    question = str(cargs.get("question") or "").strip()
+                if clarification_calls:
                     # ClarificationMiddleware 常在 tool 之后还有一条纯文本 AIMessage，
                     # 比 tool_call 旁的短 preamble 更适合作为气泡正文。
                     follow_up = _find_trailing_ai_text(messages, exclude_text=content)
-                    display_content = follow_up or content or question
-
-                    # 兜底:模型偶尔会复述上一轮的同一澄清问题(SOUL §2.5 prompt
-                    # 已经强约束,但小模型 / 长上下文仍可能漏跟随)。检测到完全
-                    # 重复时,把 status 从 clarification 降级为 asking,前端只渲染
-                    # 文本气泡不弹卡片,避免用户看到"同样选项又出现一次"。
-                    if _is_repeated_clarification(
-                        messages,
-                        new_question=question,
-                        new_options=cargs.get("options"),
-                        new_tool_call_id=clarification_call.get("id"),
-                    ):
-                        logger.warning(
-                            "intent stream: dropping duplicate ask_clarification "
-                            "(question=%r) — already asked & answered earlier in thread",
-                            question[:80],
+                    clarification_payloads: list[dict[str, Any]] = []
+                    for clarification_call in clarification_calls:
+                        cargs = clarification_call.get("args") or {}
+                        question = str(cargs.get("question") or "").strip()
+                        # 逐卡过滤已被用户回答过的重复问题，不能因为其中一张
+                        # 重复卡而吞掉同轮其它有效的协助卡。
+                        if _is_repeated_clarification(
+                            messages,
+                            new_question=question,
+                            new_options=cargs.get("options"),
+                            new_tool_call_id=clarification_call.get("id"),
+                        ):
+                            logger.warning(
+                                "intent stream: dropping duplicate ask_clarification "
+                                "(question=%r) — already asked & answered earlier in thread",
+                                question[:80],
+                            )
+                            continue
+                        clarification_payloads.append(
+                            {
+                                "id": str(clarification_call.get("id") or ""),
+                                "question": question,
+                                "clarification_type": str(cargs.get("clarification_type") or ""),
+                                "clarification_context": str(cargs.get("context") or ""),
+                                "options": cargs.get("options") or [],
+                                "allow_custom": bool(cargs.get("allow_custom", True)),
+                                "allow_multiple": resolve_allow_multiple(cargs),
+                            }
                         )
+
+                    if not clarification_payloads:
                         fallback_msg = (
-                            display_content
+                            follow_up
+                            or content
                             or "(系统识别到智能体重复了上一问题,已自动跳过。请补充其他信息继续推进。)"
                         )
-                        final_frame: dict[str, Any] = {
+                        final_frame = {
                             "status": "asking",
                             "content": fallback_msg,
                             "summary": None,
@@ -562,15 +713,15 @@ async def stream_intent(request: Request, payload: dict = Body(...)) -> Streamin
                         yield f"data: {json.dumps(final_frame, ensure_ascii=False)}\n\n"
                         return
 
+                    first = clarification_payloads[0]
+                    display_content = follow_up or content or str(first["question"])
                     final_frame: dict[str, Any] = {
                         "status": "clarification",
                         "content": display_content,
-                        "question": question,
-                        "clarification_type": str(cargs.get("clarification_type") or ""),
-                        "clarification_context": str(cargs.get("context") or ""),
-                        "options": cargs.get("options") or [],
-                        "allow_custom": bool(cargs.get("allow_custom", True)),
-                        "allow_multiple": resolve_allow_multiple(cargs),
+                        # 兼容旧客户端保留首张卡的顶层字段；完整列表使得网络
+                        # 重连、缓存重放等没有实时 tool frame 的路径也能还原多卡。
+                        **first,
+                        "clarifications": clarification_payloads,
                         "summary": None,
                     }
                     yield f"data: {json.dumps(final_frame, ensure_ascii=False)}\n\n"
diff --git a/offline-backend-20260512/backend/app/gateway/routers/model_management.py b/offline-backend-20260512/backend/app/gateway/routers/model_management.py
new file mode 100644
index 00000000..e77b4b06
--- /dev/null
+++ b/offline-backend-20260512/backend/app/gateway/routers/model_management.py
@@ -0,0 +1,451 @@
+"""Administrator model configuration backed by DeerFlow's ``config.yaml``.
+
+The public ``/api/models`` endpoint intentionally stays small and never
+returns secrets.  This router is the complementary administrator surface: it
+edits only the top-level ``models:`` section in the active DeerFlow config,
+keeps a disk backup before every write, and swaps the gateway's runtime config
+after validation so new requests can use the change without a restart.
+"""
+
+from __future__ import annotations
+
+import asyncio
+import copy
+import logging
+import os
+import re
+import shutil
+import tempfile
+from datetime import UTC, datetime
+from pathlib import Path
+from time import perf_counter
+from typing import Any
+
+import yaml
+from fastapi import APIRouter, HTTPException, Request
+from langchain_core.messages import HumanMessage
+from pydantic import BaseModel, ConfigDict, Field, field_validator
+
+from app.gateway.deps import get_optional_user_from_request
+from deerflow.config.app_config import AppConfig, reload_app_config
+from deerflow.config.model_config import ModelConfig
+from deerflow.models.factory import create_chat_model
+
+logger = logging.getLogger(__name__)
+router = APIRouter(prefix="/api/admin/models", tags=["admin-models"])
+
+_MODEL_BLOCK_RE = re.compile(r"(?m)^models:[^\r\n]*(?:\r?\n|$)")
+_TOP_LEVEL_KEY_RE = re.compile(r"(?m)^[A-Za-z_][A-Za-z0-9_-]*:[^\r\n]*(?:\r?\n|$)")
+_BACKUP_DIR_NAME = ".model-config-backups"
+_MUTATION_LOCK = asyncio.Lock()
+
+_EDITOR_FIELDS = frozenset(
+    {
+        "name",
+        "display_name",
+        "description",
+        "use",
+        "model",
+        "api_key",
+        "base_url",
+        "request_timeout",
+        "max_retries",
+        "max_tokens",
+        "temperature",
+        "stream_usage",
+        "supports_thinking",
+        "supports_reasoning_effort",
+        "supports_vision",
+        "when_thinking_enabled",
+        "when_thinking_disabled",
+        "thinking",
+        "use_responses_api",
+        "output_version",
+    }
+)
+_PRESERVED_FIELDS = frozenset(ModelConfig.model_fields) | _EDITOR_FIELDS
+
+
+class ModelAdminItem(BaseModel):
+    """A model configuration safe to return to an administrator browser."""
+
+    name: str
+    display_name: str | None = None
+    description: str | None = None
+    use: str
+    model: str
+    base_url: str | None = None
+    request_timeout: float | None = None
+    max_retries: int | None = None
+    max_tokens: int | None = None
+    temperature: float | None = None
+    stream_usage: bool | None = None
+    supports_thinking: bool = False
+    supports_reasoning_effort: bool = False
+    supports_vision: bool = False
+    when_thinking_enabled: dict[str, Any] | None = None
+    when_thinking_disabled: dict[str, Any] | None = None
+    thinking: dict[str, Any] | None = None
+    use_responses_api: bool | None = None
+    output_version: str | None = None
+    extra_settings: dict[str, Any] = Field(default_factory=dict)
+    api_key_configured: bool = False
+    api_key_source: str | None = None
+    source: str = "config.yaml"
+
+
+class ModelAdminListResponse(BaseModel):
+    models: list[ModelAdminItem]
+    config_path: str
+    updated_at: str | None = None
+
+
+class ModelUpsertRequest(BaseModel):
+    """Editable subset of the ``ModelConfig`` schema plus safe extra fields."""
+
+    model_config = ConfigDict(extra="forbid")
+
+    name: str = Field(min_length=1, max_length=160)
+    display_name: str | None = Field(default=None, max_length=160)
+    description: str | None = Field(default=None, max_length=1000)
+    use: str = Field(min_length=1, max_length=255)
+    model: str = Field(min_length=1, max_length=255)
+    # ``None`` means "keep the currently configured secret" on update.
+    # The value is write-only in practice: it is never part of a response.
+    api_key: str | None = Field(default=None, max_length=4096)
+    clear_api_key: bool = False
+    base_url: str | None = Field(default=None, max_length=2048)
+    request_timeout: float | None = Field(default=None, ge=1, le=600)
+    max_retries: int | None = Field(default=None, ge=0, le=20)
+    max_tokens: int | None = Field(default=None, ge=1, le=1_000_000)
+    temperature: float | None = Field(default=None, ge=0, le=2)
+    stream_usage: bool | None = None
+    supports_thinking: bool = False
+    supports_reasoning_effort: bool = False
+    supports_vision: bool = False
+    when_thinking_enabled: dict[str, Any] | None = None
+    when_thinking_disabled: dict[str, Any] | None = None
+    thinking: dict[str, Any] | None = None
+    use_responses_api: bool | None = None
+    output_version: str | None = Field(default=None, max_length=128)
+    extra_settings: dict[str, Any] = Field(default_factory=dict)
+
+    @field_validator("name", "use", "model")
+    @classmethod
+    def _trim_required(cls, value: str) -> str:
+        normalized = value.strip()
+        if not normalized:
+            raise ValueError("value cannot be empty")
+        return normalized
+
+    @field_validator("display_name", "description", "base_url", "api_key", "output_version")
+    @classmethod
+    def _trim_optional(cls, value: str | None) -> str | None:
+        return value.strip() if isinstance(value, str) else value
+
+
+class ModelTestRequest(BaseModel):
+    model: ModelUpsertRequest
+
+
+class ModelTestResponse(BaseModel):
+    success: bool
+    latency_ms: int
+    message: str
+    preview: str | None = None
+
+
+def _mask_env_source(value: Any) -> str | None:
+    if isinstance(value, str) and value.startswith("$") and len(value) > 1:
+        return value[1:]
+    return None
+
+
+def _to_admin_item(raw: dict[str, Any]) -> ModelAdminItem:
+    api_key = raw.get("api_key")
+    extra = {
+        key: copy.deepcopy(value)
+        for key, value in raw.items()
+        if key not in _PRESERVED_FIELDS
+    }
+    return ModelAdminItem(
+        name=str(raw.get("name") or ""),
+        display_name=raw.get("display_name"),
+        description=raw.get("description"),
+        use=str(raw.get("use") or ""),
+        model=str(raw.get("model") or ""),
+        base_url=raw.get("base_url"),
+        request_timeout=raw.get("request_timeout"),
+        max_retries=raw.get("max_retries"),
+        max_tokens=raw.get("max_tokens"),
+        temperature=raw.get("temperature"),
+        stream_usage=raw.get("stream_usage"),
+        supports_thinking=bool(raw.get("supports_thinking", False)),
+        supports_reasoning_effort=bool(raw.get("supports_reasoning_effort", False)),
+        supports_vision=bool(raw.get("supports_vision", False)),
+        when_thinking_enabled=copy.deepcopy(raw.get("when_thinking_enabled")),
+        when_thinking_disabled=copy.deepcopy(raw.get("when_thinking_disabled")),
+        thinking=copy.deepcopy(raw.get("thinking")),
+        use_responses_api=raw.get("use_responses_api"),
+        output_version=raw.get("output_version"),
+        extra_settings=extra,
+        api_key_configured=bool(api_key),
+        api_key_source=_mask_env_source(api_key),
+    )
+
+
+def _resolve_config_path() -> Path:
+    return AppConfig.resolve_config_path()
+
+
+def _read_config_data(path: Path) -> tuple[str, dict[str, Any], list[dict[str, Any]]]:
+    raw_text = path.read_text(encoding="utf-8")
+    try:
+        data = yaml.safe_load(raw_text) or {}
+    except yaml.YAMLError as exc:
+        raise HTTPException(status_code=500, detail=f"Unable to parse active config.yaml: {exc}") from exc
+    if not isinstance(data, dict):
+        raise HTTPException(status_code=500, detail="The active config.yaml root must be a mapping")
+    raw_models = data.get("models") or []
+    if not isinstance(raw_models, list) or not all(isinstance(item, dict) for item in raw_models):
+        raise HTTPException(status_code=500, detail="config.yaml models must be a list of mappings")
+    return raw_text, data, [copy.deepcopy(item) for item in raw_models]
+
+
+def _render_models_block(models: list[dict[str, Any]], newline: str) -> str:
+    rendered = yaml.safe_dump(
+        {"models": models},
+        allow_unicode=True,
+        sort_keys=False,
+        default_flow_style=False,
+        width=120,
+    )
+    if newline != "\n":
+        rendered = rendered.replace("\n", newline)
+    return rendered if rendered.endswith(newline) else f"{rendered}{newline}"
+
+
+def _replace_models_block(raw_text: str, models: list[dict[str, Any]]) -> str:
+    """Replace the active model entries without touching other config sections.
+
+    PyYAML does not retain comments.  Keep every comment found in the old
+    model section as documentation after the newly rendered model list rather
+    than silently deleting an operator's notes or disabled examples.
+    """
+
+    block_match = _MODEL_BLOCK_RE.search(raw_text)
+    if block_match is None:
+        raise HTTPException(status_code=500, detail="The active config.yaml has no top-level models section")
+    newline = "\r\n" if "\r\n" in raw_text else "\n"
+    next_key = _TOP_LEVEL_KEY_RE.search(raw_text, block_match.end())
+    end = next_key.start() if next_key else len(raw_text)
+    previous_section = raw_text[block_match.end() : end]
+    preserved_comments = "".join(
+        line
+        for line in previous_section.splitlines(keepends=True)
+        if line.lstrip().startswith("#")
+    )
+    rendered = _render_models_block(models, newline)
+    if preserved_comments:
+        if not preserved_comments.endswith(("\n", "\r")):
+            preserved_comments = f"{preserved_comments}{newline}"
+        rendered = f"{rendered}{preserved_comments}"
+    return f"{raw_text[:block_match.start()]}{rendered}{raw_text[end:]}"
+
+
+def _backup_and_write_config(path: Path, raw_before: str, raw_after: str) -> Path:
+    backup_dir = path.parent / _BACKUP_DIR_NAME
+    backup_dir.mkdir(parents=True, exist_ok=True)
+    stamp = datetime.now(UTC).strftime("%Y%m%dT%H%M%S%fZ")
+    backup_path = backup_dir / f"{path.stem}.{stamp}.yaml"
+    # Persist the exact text that was read for this mutation.  This makes the
+    # rollback deterministic even if another operator changes the file while
+    # the gateway is processing a request.
+    with backup_path.open("w", encoding="utf-8", newline="") as handle:
+        handle.write(raw_before)
+
+    fd, temp_name = tempfile.mkstemp(prefix=f".{path.name}.", suffix=".tmp", dir=path.parent)
+    try:
+        with os.fdopen(fd, "w", encoding="utf-8", newline="") as handle:
+            handle.write(raw_after)
+            handle.flush()
+            os.fsync(handle.fileno())
+        os.replace(temp_name, path)
+    except Exception:
+        try:
+            os.unlink(temp_name)
+        except OSError:
+            pass
+        raise
+    return backup_path
+
+
+def _restore_backup(path: Path, backup_path: Path) -> None:
+    try:
+        shutil.copy2(backup_path, path)
+    except Exception:
+        logger.exception("Failed to restore model config backup at %s", backup_path)
+
+
+def _request_to_raw_model(payload: ModelUpsertRequest, existing: dict[str, Any] | None = None) -> dict[str, Any]:
+    merged = copy.deepcopy(existing or {})
+    supplied = payload.model_dump(exclude={"extra_settings", "clear_api_key"}, exclude_none=True)
+    merged.update(supplied)
+    for key, value in payload.extra_settings.items():
+        normalized = str(key).strip()
+        if not normalized:
+            raise HTTPException(status_code=422, detail="Extra setting names cannot be blank")
+        if normalized in _EDITOR_FIELDS or normalized in {"api_key", "clear_api_key", "extra_settings"}:
+            raise HTTPException(status_code=422, detail=f"Extra setting '{normalized}' duplicates a managed field")
+        merged[normalized] = copy.deepcopy(value)
+    if payload.clear_api_key:
+        merged.pop("api_key", None)
+    elif payload.api_key is None and existing is not None and "api_key" in existing:
+        merged["api_key"] = existing["api_key"]
+
+    # Validate the raw schema without resolving `$ENV_VAR` values.  Environment
+    # resolution happens during the post-write runtime reload and is rolled back
+    # if unavailable.
+    try:
+        ModelConfig.model_validate(merged)
+    except Exception as exc:
+        raise HTTPException(status_code=422, detail=f"Invalid model configuration: {exc}") from exc
+    return merged
+
+
+def _redact_text(value: str, secrets: list[str]) -> str:
+    result = value
+    for secret in secrets:
+        if secret:
+            result = result.replace(secret, "***")
+    return result[:800]
+
+
+async def _require_admin(request: Request) -> None:
+    user = getattr(request.state, "user", None)
+    if user is None:
+        user = await get_optional_user_from_request(request)
+    if user is None:
+        raise HTTPException(status_code=401, detail="Authentication is required")
+    if getattr(user, "system_role", None) != "admin":
+        raise HTTPException(status_code=403, detail="Model configuration requires an administrator")
+
+
+async def _save_models(request: Request, raw_before: str, models: list[dict[str, Any]]) -> list[dict[str, Any]]:
+    path = _resolve_config_path()
+    raw_after = _replace_models_block(raw_before, models)
+    backup_path = await asyncio.to_thread(_backup_and_write_config, path, raw_before, raw_after)
+    try:
+        config = reload_app_config(str(path))
+        request.app.state.config = config
+    except Exception as exc:
+        logger.warning("Updated model configuration could not be activated: %s", type(exc).__name__)
+        await asyncio.to_thread(_restore_backup, path, backup_path)
+        try:
+            request.app.state.config = reload_app_config(str(path))
+        except Exception:
+            logger.exception("Failed to reload restored model config")
+        raise HTTPException(
+            status_code=422,
+            detail="The model configuration could not be activated; the previous config was restored.",
+        ) from exc
+    return models
+
+
+@router.get("", response_model=ModelAdminListResponse)
+async def list_model_configurations(request: Request) -> ModelAdminListResponse:
+    await _require_admin(request)
+    path = _resolve_config_path()
+    _, _, models = await asyncio.to_thread(_read_config_data, path)
+    updated_at = datetime.fromtimestamp(path.stat().st_mtime, tz=UTC).isoformat()
+    return ModelAdminListResponse(
+        models=[_to_admin_item(item) for item in models],
+        config_path=str(path),
+        updated_at=updated_at,
+    )
+
+
+@router.post("", response_model=ModelAdminItem, status_code=201)
+async def create_model_configuration(body: ModelUpsertRequest, request: Request) -> ModelAdminItem:
+    await _require_admin(request)
+    async with _MUTATION_LOCK:
+        path = _resolve_config_path()
+        raw_before, _, models = await asyncio.to_thread(_read_config_data, path)
+        if any(str(item.get("name")) == body.name for item in models):
+            raise HTTPException(status_code=409, detail=f"A model named '{body.name}' already exists")
+        created = _request_to_raw_model(body)
+        await _save_models(request, raw_before, [*models, created])
+    return _to_admin_item(created)
+
+
+@router.put("/{model_name:path}", response_model=ModelAdminItem)
+async def update_model_configuration(model_name: str, body: ModelUpsertRequest, request: Request) -> ModelAdminItem:
+    await _require_admin(request)
+    if body.name != model_name:
+        raise HTTPException(status_code=422, detail="A model's stable name cannot be changed; edit its display name instead")
+    async with _MUTATION_LOCK:
+        path = _resolve_config_path()
+        raw_before, _, models = await asyncio.to_thread(_read_config_data, path)
+        index = next((i for i, item in enumerate(models) if str(item.get("name")) == model_name), None)
+        if index is None:
+            raise HTTPException(status_code=404, detail=f"Model '{model_name}' was not found")
+        updated = _request_to_raw_model(body, models[index])
+        next_models = [*models]
+        next_models[index] = updated
+        await _save_models(request, raw_before, next_models)
+    return _to_admin_item(updated)
+
+
+@router.delete("/{model_name:path}", status_code=204)
+async def delete_model_configuration(model_name: str, request: Request) -> None:
+    """Delete one model configuration and activate the remaining model list."""
+
+    await _require_admin(request)
+    async with _MUTATION_LOCK:
+        path = _resolve_config_path()
+        raw_before, _, models = await asyncio.to_thread(_read_config_data, path)
+        index = next((i for i, item in enumerate(models) if str(item.get("name")) == model_name), None)
+        if index is None:
+            raise HTTPException(status_code=404, detail=f"Model '{model_name}' was not found")
+        await _save_models(request, raw_before, [*models[:index], *models[index + 1 :]])
+
+
+@router.post("/test", response_model=ModelTestResponse)
+async def test_model_connection(body: ModelTestRequest, request: Request) -> ModelTestResponse:
+    """Perform one bounded minimal completion without persisting the draft."""
+
+    await _require_admin(request)
+    path = _resolve_config_path()
+    _, _, models = await asyncio.to_thread(_read_config_data, path)
+    existing = next((item for item in models if str(item.get("name")) == body.model.name), None)
+    candidate = _request_to_raw_model(body.model, existing)
+    candidate_secret = str(candidate.get("api_key") or "")
+    secrets = [candidate_secret]
+    try:
+        runtime_candidate = AppConfig.resolve_env_variables(copy.deepcopy(candidate))
+        # An environment-variable API key is resolved only in memory for this
+        # request. Redact both forms because provider exceptions can include
+        # either the original `$NAME` reference or its resolved value.
+        resolved_secret = str(runtime_candidate.get("api_key") or "")
+        secrets = [candidate_secret, resolved_secret]
+        model_config = ModelConfig.model_validate(runtime_candidate)
+        base_config = request.app.state.config
+        test_config = base_config.model_copy(update={"models": [model_config]})
+        chat_model = create_chat_model(model_config.name, app_config=test_config, force_disable_thinking=True)
+        started = perf_counter()
+        response = await asyncio.wait_for(
+            chat_model.ainvoke([HumanMessage(content="Reply with exactly: OK")]),
+            timeout=min(float(candidate.get("request_timeout") or 30), 45),
+        )
+        latency_ms = round((perf_counter() - started) * 1000)
+        preview = _redact_text(str(getattr(response, "content", "OK")), secrets)
+        return ModelTestResponse(success=True, latency_ms=latency_ms, message="Connection successful", preview=preview)
+    except Exception as exc:
+        # Provider errors sometimes echo a credential.  Never log the full
+        # exception or return it without redacting the submitted key.
+        logger.warning("Model connection test failed for '%s': %s", candidate.get("name"), type(exc).__name__)
+        return ModelTestResponse(
+            success=False,
+            latency_ms=0,
+            message=_redact_text(str(exc) or type(exc).__name__, secrets),
+        )
diff --git a/offline-backend-20260512/backend/app/gateway/routers/position_roundtable.py b/offline-backend-20260512/backend/app/gateway/routers/position_roundtable.py
index e604d63d..eacc2a33 100644
--- a/offline-backend-20260512/backend/app/gateway/routers/position_roundtable.py
+++ b/offline-backend-20260512/backend/app/gateway/routers/position_roundtable.py
@@ -15,8 +15,8 @@ from datetime import UTC, datetime
 from pathlib import Path
 from typing import Any
 
-from fastapi import APIRouter, HTTPException, Request
-from pydantic import BaseModel, Field
+from fastapi import APIRouter, HTTPException, Query, Request
+from pydantic import BaseModel, Field, field_validator
 
 from app.gateway.path_utils import aresolve_thread_virtual_path
 from deerflow.runtime.user_context import get_effective_user_id
@@ -79,7 +79,10 @@ class NodeResponse(BaseModel):
 
 class SessionResponse(BaseModel):
     id: str
+    # Older personal rows can already contain a mock task id; task_scoped is
+    # the authoritative opt-in marker for cross-user task sharing.
     external_task_id: str | None = None
+    task_scoped: bool = False
     task_snapshot: dict[str, Any] = Field(default_factory=dict)
     chain_id: str | None = None
     chain_snapshot: dict[str, Any] | None = None
@@ -105,6 +108,14 @@ class SessionCreateRequest(BaseModel):
     external_task_id: str | None = Field(default=None, max_length=128)
     task_snapshot: dict[str, Any] = Field(default_factory=dict)
 
+    @field_validator("external_task_id")
+    @classmethod
+    def _normalize_external_task_id(cls, value: str | None) -> str | None:
+        if value is None:
+            return None
+        normalized = value.strip()
+        return normalized or None
+
 
 class TaskSnapshotUpdateRequest(BaseModel):
     task_snapshot: dict[str, Any] = Field(default_factory=dict)
@@ -145,10 +156,33 @@ class RejectNodeRequest(BaseModel):
     reason: str = Field(default="", max_length=5_000)
 
 
+class ActionPlanDictionaryOption(BaseModel):
+    """One task-system dictionary row, preserving dictValue as the model input."""
+
+    label: str = Field(default="", max_length=256)
+    value: str | int | float = ""
+    id: str | int | None = None
+    dict_type: str = Field(default="", max_length=128)
+    is_default: bool = False
+
+
+class ActionPlanDictionaries(BaseModel):
+    """The four action fields that must be selected from task-system dictionaries."""
+
+    publish_channels: list[ActionPlanDictionaryOption] = Field(default_factory=list)
+    action_types: list[ActionPlanDictionaryOption] = Field(default_factory=list)
+    info_formats: list[ActionPlanDictionaryOption] = Field(default_factory=list)
+    responsible_positions: list[ActionPlanDictionaryOption] = Field(default_factory=list)
+
+
 class PrepareBuiltinRunRequest(BaseModel):
     """Optional follow-up instruction for one persisted built-in agent."""
 
     message: str = Field(default="", max_length=20_000)
+    # 岗位会商会话允许本地演示使用非数字 taskId。真实任务系统新增行动
+    # 时由专属 Skill 再按外部接口契约校验正整数，不能在 prepare 阶段阻断报告生成。
+    task_id: str | int | None = Field(default=None, max_length=128)
+    action_dictionaries: ActionPlanDictionaries | None = None
 
 
 class BuiltinRunPreparationResponse(BaseModel):
@@ -180,6 +214,25 @@ def _current_user_id(request: Request) -> str:
     return str(user.id) if user is not None else get_effective_user_id()
 
 
+def _task_snapshot_for_scope(
+    external_task_id: str | None,
+    task_snapshot: dict[str, Any],
+    *,
+    task_scoped: bool = True,
+) -> dict[str, Any]:
+    """Lock the snapshot id only for an explicit shared task scope."""
+    if not task_scoped or not external_task_id:
+        return dict(task_snapshot)
+    return {**task_snapshot, "id": external_task_id, "externalTaskId": external_task_id}
+
+
+def _normalize_external_task_id(value: str | None) -> str | None:
+    if value is None:
+        return None
+    normalized = value.strip()
+    return normalized or None
+
+
 def _get_store(request: Request):
     store = getattr(request.app.state, "position_roundtable_store", None)
     if store is None:
@@ -440,15 +493,64 @@ def _markdown_delivery_changed(
     return bool(new_signatures - old_signatures)
 
 
+def _intent_string_list(intent: dict[str, Any], key: str) -> list[str]:
+    """Return a clean, display-safe string list from a persisted intent field."""
+    value = intent.get(key)
+    if not isinstance(value, list):
+        return []
+    return [item.strip() for item in value if isinstance(item, str) and item.strip()]
+
+
+def _position_intent_sections(intent: Any) -> dict[str, list[str]]:
+    """Read both the dedicated position-intent schema and legacy snapshots.
+
+    New position sessions persist the four position-specific fields.  Mapping
+    the legacy Step-1 fields keeps already-created sessions executable after
+    this rollout instead of stranding them at the activation gate.
+    """
+    if not isinstance(intent, dict):
+        return {
+            "coreGoals": [],
+            "riskWarnings": [],
+            "keyPoints": [],
+            "strategicSignificance": [],
+        }
+    has_position_schema = any(
+        key in intent
+        for key in ("coreGoals", "riskWarnings", "keyPoints", "strategicSignificance")
+    )
+    if has_position_schema:
+        return {
+            "coreGoals": _intent_string_list(intent, "coreGoals"),
+            "riskWarnings": _intent_string_list(intent, "riskWarnings"),
+            "keyPoints": _intent_string_list(intent, "keyPoints"),
+            "strategicSignificance": _intent_string_list(intent, "strategicSignificance"),
+        }
+
+    objective = _text_from_keys(intent, ["objective", "goal"])
+    return {
+        "coreGoals": _intent_string_list(intent, "constraints"),
+        "riskWarnings": [],
+        "keyPoints": _intent_string_list(intent, "assumptions"),
+        "strategicSignificance": [objective] if objective else [],
+    }
+
+
 def _intent_node_answer(intent: Any) -> str:
     if not isinstance(intent, dict):
         return "情报分析岗已完成任务意图识别。"
-    objective = _text_from_keys(intent, ["objective", "goal"], "已完成任务意图识别")
-    constraints = intent.get("constraints") if isinstance(intent.get("constraints"), list) else []
-    lines = ["情报分析岗已完成任务意图识别。", f"任务目标：{objective}"]
-    if constraints:
-        lines.append("关键约束：")
-        lines.extend(f"- {item}" for item in constraints if isinstance(item, str) and item.strip())
+    sections = _position_intent_sections(intent)
+    lines = ["情报分析岗已完成任务意图识别。"]
+    labels = (
+        ("核心目标", sections["coreGoals"]),
+        ("风险提示", sections["riskWarnings"]),
+        ("关键要点", sections["keyPoints"]),
+        ("战略意义", sections["strategicSignificance"]),
+    )
+    for label, values in labels:
+        if values:
+            lines.append(f"{label}：")
+            lines.extend(f"- {item}" for item in values)
     return "\n".join(lines)
 
 
@@ -456,6 +558,15 @@ def _has_confirmed_intent(intent: Any) -> bool:
     """Only structured Step-1 output may start a frozen business chain."""
     if not isinstance(intent, dict):
         return False
+    if any(
+        key in intent
+        for key in ("coreGoals", "riskWarnings", "keyPoints", "strategicSignificance")
+    ):
+        required = ("coreGoals", "riskWarnings", "keyPoints", "strategicSignificance")
+        if not all(isinstance(intent.get(key), list) for key in required):
+            return False
+        sections = _position_intent_sections(intent)
+        return bool(sections["coreGoals"] or sections["strategicSignificance"])
     objective = _text_from_keys(intent, ["objective", "goal"])
     constraints = intent.get("constraints")
     return bool(objective and isinstance(constraints, list))
@@ -505,8 +616,7 @@ def _build_node_context_text(
     title = _text_from_keys(task, ["title", "taskName", "name"], "未命名任务")
     direction = _text_from_keys(task, ["direction", "taskDirection", "category"], "未填写")
     description = _text_from_keys(task, ["description", "taskContent", "overview", "content"], "暂无任务描述")
-    objective = _text_from_keys(intent, ["objective", "goal"], "暂无意图结论")
-    constraints = intent.get("constraints") if isinstance(intent.get("constraints"), list) else []
+    sections = _position_intent_sections(intent)
     agent_name, position_id = _seat_meta(session, current)
     md_required = not _is_intent_position_node(current, _session_intent_position_id(session))
     lines = [
@@ -518,11 +628,16 @@ def _build_node_context_text(
         f"- 任务描述：{description}",
         "",
         "【已识别意图】",
-        f"- 任务目标：{objective}",
     ]
-    if constraints:
-        lines.append("- 关键约束：")
-        lines.extend(f"  - {item}" for item in constraints if isinstance(item, str) and item.strip())
+    for label, values in (
+        ("核心目标", sections["coreGoals"]),
+        ("风险提示", sections["riskWarnings"]),
+        ("关键要点", sections["keyPoints"]),
+        ("战略意义", sections["strategicSignificance"]),
+    ):
+        if values:
+            lines.append(f"- {label}：")
+            lines.extend(f"  - {item}" for item in values)
     lines.extend(
         [
             "",
@@ -968,6 +1083,8 @@ async def _build_builtin_prompt(
     session: dict[str, Any],
     nodes: list[dict[str, Any]],
     follow_up: str = "",
+    action_task_id: str | int | None = None,
+    action_dictionaries: ActionPlanDictionaries | None = None,
 ) -> str:
     task = session.get("task_snapshot") if isinstance(session.get("task_snapshot"), dict) else {}
     intent = session.get("intent_snapshot") if isinstance(session.get("intent_snapshot"), dict) else {}
@@ -975,8 +1092,7 @@ async def _build_builtin_prompt(
     title = _text_from_keys(task, ["title", "taskName", "name"], "未命名任务")
     direction = _text_from_keys(task, ["direction", "taskDirection", "category"], "未填写")
     description = _text_from_keys(task, ["description", "taskContent", "overview", "content"], "暂无任务描述")
-    objective = _text_from_keys(intent, ["objective", "goal"], "暂无意图结论")
-    constraints = intent.get("constraints") if isinstance(intent.get("constraints"), list) else []
+    sections = _position_intent_sections(intent)
     stage_goals = chain.get("stageGoals") if isinstance(chain.get("stageGoals"), list) else []
     stage_lines = [f"- L-{index + 1}：{goal}" for index, goal in enumerate(stage_goals) if isinstance(goal, str) and goal.strip()]
     material = await _effective_delivery_material(session, nodes)
@@ -990,11 +1106,16 @@ async def _build_builtin_prompt(
         f"- 描述：{description}",
         "",
         "【情报分析岗已确认的意图】",
-        f"- 核心目标：{objective}",
     ]
-    if constraints:
-        common.append("- 关键约束：")
-        common.extend(f"  - {item}" for item in constraints if isinstance(item, str) and item.strip())
+    for label, values in (
+        ("核心目标", sections["coreGoals"]),
+        ("风险提示", sections["riskWarnings"]),
+        ("关键要点", sections["keyPoints"]),
+        ("战略意义", sections["strategicSignificance"]),
+    ):
+        if values:
+            common.append(f"- {label}：")
+            common.extend(f"  - {item}" for item in values)
     if stage_lines:
         common.extend(["", "【业务链阶段】", *stage_lines])
 
@@ -1007,13 +1128,50 @@ async def _build_builtin_prompt(
     else:
         summary = session.get("summary_snapshot") if isinstance(session.get("summary_snapshot"), dict) else {}
         summary_content = _truncate_text(summary.get("content"), 12_000)
+        dictionary_groups = (
+            ("发布渠道（publishChannel）", action_dictionaries.publish_channels if action_dictionaries else []),
+            ("行动类型（actionType）", action_dictionaries.action_types if action_dictionaries else []),
+            ("信息形式（infoFormat）", action_dictionaries.info_formats if action_dictionaries else []),
+            ("责任岗位（responsiblePosition）", action_dictionaries.responsible_positions if action_dictionaries else []),
+        )
+        dictionaries_ready = bool(action_task_id is not None and all(options for _, options in dictionary_groups))
+        dictionary_lines = [
+            "【前端传入的行动字典（名称 → 必须原样使用的 dictValue）】",
+            f"- 当前 taskId：{action_task_id if action_task_id is not None else '（本地预览）'}",
+        ]
+        for label, options in dictionary_groups:
+            dictionary_lines.append(f"- {label}：")
+            dictionary_lines.extend(
+                f"  - {option.label} → {option.value}"
+                for option in options
+            )
+        dictionary_instruction = (
+            "actionType、publishChannel、infoFormat、responsiblePosition 必须从下方同名字典复制 dictValue 并写成整数；"
+            "taskId 必须原样写为当前 taskId。不要保留 id、title、goal、basis、owner_position、dependencies 等旧字段，"
+            "也不要用 0 或空值代替未选择的字典项。"
+            if dictionaries_ready
+            else "当前四类任务系统字典未获取完整，这是本地预览/接口未就绪状态。仍需生成 9 字段 JSON，"
+            "但四个枚举字段可暂填 0 占位，且不得调用 position-roundtable-action-create Skill 或外部任务系统。"
+        )
+        submit_instruction = (
+            "若当前 taskId 是正整数，首次生成完整行动清单后按行动规划智能体的 SOUL 调用 position-roundtable-action-create Skill 批量新增行动；"
+            "若 taskId 为本地演示标识或为空，只生成报告和 JSON，明确说明未调用任务系统。Skill 返回失败时如实报告，不能伪称已入库。"
+            if dictionaries_ready
+            else "本轮字典不完整，只生成报告和 JSON 预览；不得调用 Skill、不得请求外部任务系统，也不能宣称行动已入库。"
+        )
         instructions = [
             "请基于以下方案总结和岗位会商材料，生成或按用户要求修订《岗位会商行动规划》。",
             "必须使用 write_file 分别写入两个最终交付：`/mnt/user-data/outputs/行动规划报告.md` 与 `/mnt/user-data/outputs/action-plan-subtasks.json`。",
-            "Markdown 报告需给出分阶段推进建议、优先级、风险控制与验收安排；JSON 必须是严格合法数组，每个子任务都包含 id、title、goal、basis、owner_position、dependencies、deliverable、acceptance_criteria、priority。",
+            "Markdown 报告需给出分阶段推进建议、优先级、风险控制与验收安排。"
+            "JSON 必须是严格合法数组；每个对象只能包含 actionName、actionDescription、actionType、"
+            "publishChannel、infoFormat、responsiblePosition、startTime、endTime、taskId 这 9 个字段。",
+            dictionary_instruction,
+            submit_instruction,
             "",
             "【已生效方案总结】",
             summary_content or "（方案总结正文未写入快照，请依据下方有效岗位交付重新归纳。）",
+            "",
+            *dictionary_lines,
         ]
     if follow_up.strip():
         instructions.extend(["", "【用户本次补充/修改要求】", follow_up.strip()])
@@ -1082,9 +1240,13 @@ async def seed_demo_session(
 
 
 @router.get("/sessions", response_model=list[SessionResponse])
-async def list_sessions(request: Request, external_task_id: str | None = None) -> list[SessionResponse]:
+async def list_sessions(
+    request: Request,
+    external_task_id: str | None = Query(default=None, max_length=128),
+) -> list[SessionResponse]:
+    task_id = _normalize_external_task_id(external_task_id)
     rows = await _get_store(request).list_sessions(
-        _current_user_id(request), external_task_id=external_task_id
+        _current_user_id(request), external_task_id=task_id
     )
     return [_project_session(row) for row in rows]
 
@@ -1094,7 +1256,12 @@ async def create_session(request: Request, body: SessionCreateRequest) -> Sessio
     row = await _get_store(request).create_session(
         _current_user_id(request),
         external_task_id=body.external_task_id,
-        task_snapshot=body.task_snapshot,
+        task_snapshot=_task_snapshot_for_scope(
+            body.external_task_id,
+            body.task_snapshot,
+            task_scoped=bool(body.external_task_id),
+        ),
+        task_scoped=bool(body.external_task_id),
     )
     return _project_session(row)
 
@@ -1108,8 +1275,16 @@ async def get_session(request: Request, session_id: str) -> SessionDetailRespons
 async def update_task_snapshot(
     request: Request, session_id: str, body: TaskSnapshotUpdateRequest
 ) -> SessionResponse:
-    store, user_id, _ = await _require_writable_session(request, session_id)
-    row = await store.update_session(session_id, user_id, task_snapshot=body.task_snapshot)
+    store, user_id, current = await _require_writable_session(request, session_id)
+    row = await store.update_session(
+        session_id,
+        user_id,
+        task_snapshot=_task_snapshot_for_scope(
+            current.get("external_task_id"),
+            body.task_snapshot,
+            task_scoped=bool(current.get("task_scoped")),
+        ),
+    )
     if row is None:
         raise HTTPException(status_code=404, detail="Position roundtable session not found")
     return _project_session(row)
@@ -1436,6 +1611,8 @@ async def _prepare_builtin_run(
     *,
     kind: str,
     follow_up: str = "",
+    action_task_id: str | int | None = None,
+    action_dictionaries: ActionPlanDictionaries | None = None,
 ) -> BuiltinRunPreparationResponse:
     store, user_id, session = await _require_writable_session(request, session_id)
     nodes = await store.list_nodes(session_id, user_id)
@@ -1469,6 +1646,8 @@ async def _prepare_builtin_run(
             session=session,
             nodes=nodes,
             follow_up=follow_up,
+            action_task_id=action_task_id,
+            action_dictionaries=action_dictionaries,
         ),
         source_revisions=_source_revisions(nodes),
     )
@@ -1576,14 +1755,28 @@ async def complete_summary(
 async def prepare_action_plan(
     request: Request, session_id: str, body: PrepareBuiltinRunRequest
 ) -> BuiltinRunPreparationResponse:
-    return await _prepare_builtin_run(request, session_id, kind="action_plan", follow_up=body.message)
+    return await _prepare_builtin_run(
+        request,
+        session_id,
+        kind="action_plan",
+        follow_up=body.message,
+        action_task_id=body.task_id,
+        action_dictionaries=body.action_dictionaries,
+    )
 
 
 @router.post("/sessions/{session_id}/action-plan/ask", response_model=BuiltinRunPreparationResponse)
 async def ask_action_plan(
     request: Request, session_id: str, body: PrepareBuiltinRunRequest
 ) -> BuiltinRunPreparationResponse:
-    return await _prepare_builtin_run(request, session_id, kind="action_plan", follow_up=body.message)
+    return await _prepare_builtin_run(
+        request,
+        session_id,
+        kind="action_plan",
+        follow_up=body.message,
+        action_task_id=body.task_id,
+        action_dictionaries=body.action_dictionaries,
+    )
 
 
 @router.post("/sessions/{session_id}/action-plan/complete", response_model=SessionDetailResponse)
diff --git a/offline-backend-20260512/backend/app/gateway/routers/roundtable_artifact_submissions.py b/offline-backend-20260512/backend/app/gateway/routers/roundtable_artifact_submissions.py
new file mode 100644
index 00000000..7a0afc20
--- /dev/null
+++ b/offline-backend-20260512/backend/app/gateway/routers/roundtable_artifact_submissions.py
@@ -0,0 +1,196 @@
+"""Task-scoped submission status for roundtable artifacts.
+
+This API records only an artifact reference (thread + sandbox path) and its
+submission state.  It intentionally does not fetch task detail, copy Markdown,
+or deliver a file to an external task system.
+
+Routes (authenticated by the Gateway middleware):
+    GET /api/roundtable/tasks/{task_id}/artifacts?submitted=true
+    PUT /api/roundtable/tasks/{task_id}/artifacts/submission
+"""
+
+from __future__ import annotations
+
+from pathlib import PurePosixPath
+from typing import Any
+
+from fastapi import APIRouter, HTTPException, Query, Request
+from pydantic import AliasChoices, BaseModel, ConfigDict, Field, StrictInt, StrictStr, field_validator
+
+from app.gateway.deps import get_current_user
+from deerflow.persistence.roundtable_artifact_submissions import RoundtableArtifactSubmissionStore
+
+router = APIRouter(prefix="/api/roundtable/tasks", tags=["roundtable-artifact-submissions"])
+
+
+class ArtifactReferenceInput(BaseModel):
+    """Reference to a generated file; the file content remains in its thread sandbox."""
+
+    model_config = ConfigDict(populate_by_name=True)
+
+    session_id: StrictStr | None = Field(default=None, max_length=128, validation_alias=AliasChoices("sessionId", "session_id"))
+    thread_id: StrictStr | None = Field(default=None, max_length=128, validation_alias=AliasChoices("threadId", "thread_id"))
+    node_key: StrictStr | None = Field(default=None, max_length=256, validation_alias=AliasChoices("nodeKey", "node_key"))
+    source_key: StrictStr = Field(..., min_length=1, max_length=512, validation_alias=AliasChoices("sourceKey", "source_key"))
+    path: StrictStr = Field(..., min_length=1, max_length=2048)
+    name: StrictStr | None = Field(default=None, max_length=512)
+    mime_type: StrictStr | None = Field(default=None, max_length=255, validation_alias=AliasChoices("mimeType", "mime_type"))
+    revision: StrictInt = Field(..., ge=0)
+
+    @field_validator("session_id", "thread_id", "node_key", "source_key", "path", "name", "mime_type", mode="before")
+    @classmethod
+    def _trim_text(cls, value: Any) -> Any:
+        if isinstance(value, str):
+            value = value.strip()
+            return value or None
+        return value
+
+
+class ArtifactSubmissionRequest(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    task_id: StrictStr | None = Field(default=None, max_length=128, validation_alias=AliasChoices("taskId", "task_id"))
+    submitted: bool
+    submission_id: StrictStr | None = Field(default=None, max_length=64, validation_alias=AliasChoices("submissionId", "submission_id"))
+    task_delivery_id: StrictStr | None = Field(default=None, max_length=255, validation_alias=AliasChoices("taskDeliveryId", "task_delivery_id"))
+    artifact: ArtifactReferenceInput
+
+    @field_validator("task_id", "submission_id", "task_delivery_id", mode="before")
+    @classmethod
+    def _trim_optional_text(cls, value: Any) -> Any:
+        if isinstance(value, str):
+            value = value.strip()
+            return value or None
+        return value
+
+
+class ArtifactReferenceResponse(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    session_id: str | None = Field(default=None, serialization_alias="sessionId")
+    thread_id: str | None = Field(default=None, serialization_alias="threadId")
+    node_key: str | None = Field(default=None, serialization_alias="nodeKey")
+    source_key: str = Field(serialization_alias="sourceKey")
+    path: str
+    name: str | None = None
+    mime_type: str | None = Field(default=None, serialization_alias="mimeType")
+    revision: int
+
+
+class ArtifactSubmissionResponse(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    id: str
+    task_id: str = Field(serialization_alias="taskId")
+    submitted: bool
+    submitted_at: str | None = Field(default=None, serialization_alias="submittedAt")
+    cancelled_at: str | None = Field(default=None, serialization_alias="cancelledAt")
+    task_delivery_id: str | None = Field(default=None, serialization_alias="taskDeliveryId")
+    artifact: ArtifactReferenceResponse
+
+
+class ArtifactSubmissionListResponse(BaseModel):
+    items: list[ArtifactSubmissionResponse]
+
+
+def _get_store(request: Request) -> RoundtableArtifactSubmissionStore:
+    store = getattr(request.app.state, "roundtable_artifact_submission_store", None)
+    if store is None:
+        raise HTTPException(status_code=503, detail="Roundtable artifact submission store not available")
+    return store
+
+
+def _task_id_or_422(value: str) -> str:
+    task_id = value.strip()
+    if not task_id:
+        raise HTTPException(status_code=422, detail="task id is required")
+    if len(task_id) > 128:
+        raise HTTPException(status_code=422, detail="task id must be at most 128 characters")
+    return task_id
+
+
+def _artifact_payload(artifact: ArtifactReferenceInput) -> dict[str, Any]:
+    source_key = artifact.source_key
+    path = artifact.path
+    if not source_key or not path:
+        raise HTTPException(status_code=422, detail="artifact.sourceKey and artifact.path are required")
+    name = artifact.name or PurePosixPath(path).name or path
+    return {
+        "session_id": artifact.session_id,
+        "thread_id": artifact.thread_id,
+        "node_key": artifact.node_key,
+        "source_key": source_key,
+        "path": path,
+        "name": name,
+        "mime_type": artifact.mime_type,
+        "revision": artifact.revision,
+    }
+
+
+def _response(row: dict[str, Any]) -> ArtifactSubmissionResponse:
+    return ArtifactSubmissionResponse(
+        id=str(row["id"]),
+        task_id=str(row["task_id"]),
+        submitted=bool(row["submitted"]),
+        submitted_at=row.get("submitted_at"),
+        cancelled_at=row.get("cancelled_at"),
+        task_delivery_id=row.get("task_delivery_id"),
+        artifact=ArtifactReferenceResponse(
+            session_id=row.get("session_id"),
+            thread_id=row.get("thread_id"),
+            node_key=row.get("node_key"),
+            source_key=str(row["source_key"]),
+            path=str(row["path"]),
+            name=row.get("name"),
+            mime_type=row.get("mime_type"),
+            revision=int(row["revision"]),
+        ),
+    )
+
+
+@router.get("/{task_id}/artifacts", response_model=ArtifactSubmissionListResponse)
+async def list_artifact_submissions(
+    request: Request,
+    task_id: str,
+    submitted: bool | None = Query(default=True),
+) -> ArtifactSubmissionListResponse:
+    """List task artifacts by submission state (defaults to submitted only)."""
+    rows = await _get_store(request).list_by_task(_task_id_or_422(task_id), submitted=submitted)
+    return ArtifactSubmissionListResponse(items=[_response(row) for row in rows])
+
+
+@router.put("/{task_id}/artifacts/submission", response_model=ArtifactSubmissionResponse)
+async def set_artifact_submission(
+    request: Request,
+    task_id: str,
+    body: ArtifactSubmissionRequest,
+) -> ArtifactSubmissionResponse:
+    """Create/update a submission or retain an audit row while cancelling it."""
+    path_task_id = _task_id_or_422(task_id)
+    if body.task_id is not None and body.task_id != path_task_id:
+        raise HTTPException(status_code=422, detail="taskId must match the path task id")
+
+    artifact = _artifact_payload(body.artifact)
+    actor_id = await get_current_user(request)
+    store = _get_store(request)
+    if body.submitted:
+        # The frontend previews submitted artifacts by threadId + path.  Without
+        # a thread reference a saved state could never be previewed correctly.
+        if not artifact["thread_id"]:
+            raise HTTPException(status_code=422, detail="artifact.threadId is required when submitted is true")
+        row = await store.submit(
+            path_task_id,
+            artifact,
+            task_delivery_id=body.task_delivery_id,
+            actor_id=actor_id,
+        )
+    else:
+        row = await store.cancel(
+            path_task_id,
+            artifact,
+            submission_id=body.submission_id,
+            actor_id=actor_id,
+        )
+        if row is None:
+            raise HTTPException(status_code=404, detail="Artifact submission not found")
+    return _response(row)
diff --git a/offline-backend-20260512/backend/app/gateway/routers/roundtable_chains.py b/offline-backend-20260512/backend/app/gateway/routers/roundtable_chains.py
index 54967e61..b958dc6e 100644
--- a/offline-backend-20260512/backend/app/gateway/routers/roundtable_chains.py
+++ b/offline-backend-20260512/backend/app/gateway/routers/roundtable_chains.py
@@ -58,6 +58,10 @@ class ChainSeatSchema(BaseModel):
     # 与该席位 agent 自身 config.yaml 的同名开关取 OR。默认 False（关）。整条 seats 数组以
     # JSON 透传持久化，故新增此字段无需迁移；仅需在此 schema 显式声明，否则 model_dump() 会剥掉它。
     seat_skill_directive: bool = False
+    # Per-seat human checkpoint. Step 2 pauses after this seat (or its DAG
+    # stage) completes and reuses the existing resume/intervention controls.
+    # It is stored in the existing seats JSON, so no database migration is needed.
+    human_validation: bool = False
     # 该席位「推理深度覆盖」（flash/thinking/pro/ultra）：覆盖链条级 seat_mode，仅本席位生效。
     # None = 跟随链条级默认。「卡顿提速」用：把次要席位降到 flash。整条 seats 数组以 JSON 透传
     # 持久化，故无需迁移；仅需在此 schema 显式声明，否则 model_dump() 会剥掉它。非法值在运行期
diff --git a/offline-backend-20260512/backend/app/gateway/routers/skills.py b/offline-backend-20260512/backend/app/gateway/routers/skills.py
index 47b14483..07d3f418 100644
--- a/offline-backend-20260512/backend/app/gateway/routers/skills.py
+++ b/offline-backend-20260512/backend/app/gateway/routers/skills.py
@@ -1622,6 +1622,102 @@ async def delete_custom_skill(
         raise HTTPException(status_code=500, detail=f"Failed to delete custom skill: {str(e)}")
 
 
+def _remove_skill_state_config(skill_name: str) -> None:
+    """Remove a deleted skill's enabled/display override from extensions config."""
+    extensions_config = get_extensions_config()
+    if skill_name not in extensions_config.skills:
+        return
+
+    config_path = ExtensionsConfig.resolve_config_path()
+    if config_path is None:
+        config_path = Path.cwd().parent / "extensions_config.json"
+    extensions_config.skills.pop(skill_name, None)
+    config_data = _dump_extensions_config(extensions_config)
+
+    tmp_path: Path | None = None
+    try:
+        with tempfile.NamedTemporaryFile(
+            "w",
+            encoding="utf-8",
+            delete=False,
+            dir=str(config_path.parent),
+        ) as tmp_file:
+            json.dump(config_data, tmp_file, indent=2)
+            tmp_path = Path(tmp_file.name)
+        os.replace(tmp_path, config_path)
+    finally:
+        if tmp_path is not None and tmp_path.exists():
+            tmp_path.unlink()
+    reload_extensions_config()
+
+
+@router.delete(
+    "/skills/{skill_name}",
+    summary="Delete Built-in Skill",
+    description=(
+        "Administrators may permanently delete a built-in skill. The skill is "
+        "removed from enabled configuration and detached from agents that used it."
+    ),
+)
+async def delete_builtin_skill(
+    skill_name: str,
+    request: Request,
+    config: AppConfig = Depends(get_config),
+    skill_store: SkillStore = Depends(get_skill_store),
+    agent_store=Depends(get_agent_store),
+) -> dict[str, bool]:
+    try:
+        if not _is_admin_user(request):
+            raise HTTPException(status_code=403, detail="Only administrators can delete built-in skills")
+
+        skill_name = _normalize_skill_name_param(skill_name)
+        skill = _load_skill_or_404(skill_name, config)
+        if skill.category != SkillCategory.PUBLIC:
+            raise HTTPException(status_code=400, detail="Use the custom skill deletion endpoint for a custom skill")
+
+        storage = get_or_new_skill_storage(app_config=config)
+        public_root = (storage.get_skills_root_path() / SkillCategory.PUBLIC.value).resolve()
+        skill_dir = skill.skill_file.parent.resolve()
+        if skill_dir == public_root or public_root not in skill_dir.parents:
+            raise ValueError(f"Refusing to delete built-in skill outside the public skills directory: {skill.name}")
+
+        _remove_skill_state_config(skill.name)
+        shutil.rmtree(skill_dir)
+
+        try:
+            from deerflow.skills.usage import forget
+
+            forget(skill.name)
+        except Exception:
+            pass
+
+        await skill_store.delete_admin(skill.name)
+        try:
+            await get_tag_store(request).unassign_all("skill", skill.name)
+        except Exception:  # noqa: BLE001 -- tag cleanup must not block deletion
+            pass
+
+        await cascade_skill_unpublished_or_deleted(
+            skill.name,
+            actor_user_id=_current_user_id(request),
+            operation="delete",
+            skill_owner_user_id=None,
+            agent_store=agent_store,
+        )
+        await refresh_skills_system_prompt_cache_async()
+        logger.info("Administrator deleted built-in skill %s", skill.name)
+        return {"success": True}
+    except HTTPException:
+        raise
+    except FileNotFoundError as e:
+        raise HTTPException(status_code=404, detail=str(e))
+    except ValueError as e:
+        raise HTTPException(status_code=400, detail=str(e))
+    except Exception as e:
+        logger.error("Failed to delete built-in skill %s: %s", skill_name, e, exc_info=True)
+        raise HTTPException(status_code=500, detail=f"Failed to delete built-in skill: {str(e)}")
+
+
 class SkillPublishRequest(BaseModel):
     """Request body for toggling a custom skill's published flag."""
 
@@ -2080,11 +2176,16 @@ def _caller_can_edit_skill_files(
     record: dict[str, Any] | None,
     request: Request,
 ) -> bool:
-    """Editing is limited to custom skills, and to either owner or admin."""
-    if skill.category != SkillCategory.CUSTOM:
-        return False
+    """Whether the caller can edit or delete a file within *skill*.
+
+    Built-in skills are deployment-owned, so only administrators may change
+    their files. Custom skills remain editable by their owner or by an
+    administrator.
+    """
     if _is_admin_user(request):
         return True
+    if skill.category != SkillCategory.CUSTOM:
+        return False
     if record is None:
         return False
     return record.get("owner_user_id") == _current_user_id(request)
@@ -2125,6 +2226,24 @@ def _is_text_file(path: Path) -> bool:
     return path.suffix.lower() in _SKILL_FILE_TEXT_EXTS
 
 
+def _write_skill_text_file_atomically(target: Path, content: str) -> None:
+    """Replace an already-validated skill file without exposing partial text."""
+    tmp_path: Path | None = None
+    try:
+        with tempfile.NamedTemporaryFile(
+            "w",
+            encoding="utf-8",
+            delete=False,
+            dir=str(target.parent),
+        ) as tmp_file:
+            tmp_file.write(content)
+            tmp_path = Path(tmp_file.name)
+        os.replace(tmp_path, target)
+    finally:
+        if tmp_path is not None and tmp_path.exists():
+            tmp_path.unlink()
+
+
 def _build_skill_file_tree(skill_dir: Path) -> SkillFileNode:
     """Walk *skill_dir* and build a SkillFileNode tree, depth/count capped.
 
@@ -2302,9 +2421,9 @@ async def download_skill_file(
     response_model=SkillFileSaveResponse,
     summary="Write Skill File (Text)",
     description=(
-        "Replace the contents of a text file under a custom skill. Only the "
-        "skill's owner or an admin may write; built-in (public) skills are "
-        "read-only. Edits to ``SKILL.md`` re-validate its YAML frontmatter and "
+        "Replace the contents of a text file under a skill. Administrators may "
+        "write built-in and custom skills; custom-skill owners may write their "
+        "own skills. Edits to ``SKILL.md`` re-validate its YAML frontmatter and "
         "refresh the system-prompt cache."
     ),
 )
@@ -2318,11 +2437,9 @@ async def save_skill_file(
     try:
         skill_name = _normalize_skill_name_param(skill_name)
         skill = _load_skill_or_404(skill_name, config)
-        if skill.category != SkillCategory.CUSTOM:
-            raise HTTPException(status_code=403, detail="Built-in skills are read-only")
         record = await skill_store.get_any(skill.name)
         if not _caller_can_edit_skill_files(skill, record, request):
-            raise HTTPException(status_code=403, detail="Only the skill owner or an admin can edit files in this skill")
+            raise HTTPException(status_code=403, detail="Only an administrator or the custom skill owner can edit files in this skill")
 
         target = _resolve_skill_relative_path(skill, body.path)
         if not target.exists():
@@ -2338,7 +2455,7 @@ async def save_skill_file(
         relative_posix = target.relative_to(skill.skill_file.parent.resolve()).as_posix()
         storage = get_or_new_skill_storage(app_config=config)
 
-        is_skill_md = relative_posix == SKILL_MD_FILE
+        is_skill_md = relative_posix.casefold() == SKILL_MD_FILE.casefold()
         prev_content: str | None = None
         if target.exists():
             try:
@@ -2350,20 +2467,21 @@ async def save_skill_file(
             # SKILL.md edits must keep their frontmatter valid (name must match).
             storage.validate_skill_markdown_content(skill.name, body.content)
 
-        storage.write_custom_skill(skill.name, relative_posix, body.content)
+        _write_skill_text_file_atomically(target, body.content)
 
         try:
-            storage.append_history(
-                skill.name,
-                {
-                    "action": "human_edit_file",
-                    "author": "human",
-                    "thread_id": None,
-                    "file_path": relative_posix,
-                    "prev_content": prev_content,
-                    "new_content": body.content,
-                },
-            )
+            if skill.category == SkillCategory.CUSTOM:
+                storage.append_history(
+                    skill.name,
+                    {
+                        "action": "human_edit_file",
+                        "author": "human",
+                        "thread_id": None,
+                        "file_path": relative_posix,
+                        "prev_content": prev_content,
+                        "new_content": body.content,
+                    },
+                )
         except Exception as history_err:  # noqa: BLE001 — history is best-effort
             logger.warning("Failed to append edit history for %s/%s: %s", skill.name, relative_posix, history_err)
 
@@ -2393,6 +2511,75 @@ async def save_skill_file(
         raise HTTPException(status_code=500, detail=f"Failed to save skill file: {e}")
 
 
+@router.delete(
+    "/skills/{skill_name}/files/content",
+    status_code=204,
+    summary="Delete Skill File",
+    description=(
+        "Delete one non-SKILL.md file under a skill. Administrators may delete "
+        "files from built-in and custom skills; custom-skill owners may delete "
+        "files from their own skills. The root ``SKILL.md`` manifest cannot be "
+        "deleted because it defines the skill."
+    ),
+)
+async def delete_skill_file(
+    skill_name: str,
+    request: Request,
+    path: str = Query(..., description="File path relative to the skill directory"),
+    config: AppConfig = Depends(get_config),
+    skill_store: SkillStore = Depends(get_skill_store),
+) -> None:
+    try:
+        skill_name = _normalize_skill_name_param(skill_name)
+        skill = _load_skill_or_404(skill_name, config)
+        record = await skill_store.get_any(skill.name)
+        if not _caller_can_edit_skill_files(skill, record, request):
+            raise HTTPException(status_code=403, detail="Only an administrator or the custom skill owner can delete files in this skill")
+
+        target = _resolve_skill_relative_path(skill, path)
+        if not target.exists() or not target.is_file():
+            raise HTTPException(status_code=404, detail=f"File '{path}' not found in skill '{skill_name}'")
+
+        relative_posix = target.relative_to(skill.skill_file.parent.resolve()).as_posix()
+        if relative_posix.casefold() == SKILL_MD_FILE.casefold():
+            raise HTTPException(status_code=400, detail="SKILL.md defines the skill and cannot be deleted")
+
+        prev_content: str | None = None
+        if _is_text_file(target):
+            try:
+                prev_content = target.read_text(encoding="utf-8")
+            except UnicodeDecodeError:
+                pass
+        target.unlink()
+
+        if skill.category == SkillCategory.CUSTOM:
+            storage = get_or_new_skill_storage(app_config=config)
+            try:
+                storage.append_history(
+                    skill.name,
+                    {
+                        "action": "human_delete_file",
+                        "author": "human",
+                        "thread_id": None,
+                        "file_path": relative_posix,
+                        "prev_content": prev_content,
+                    },
+                )
+            except Exception as history_err:  # noqa: BLE001
+                logger.warning("Failed to append deletion history for %s/%s: %s", skill.name, relative_posix, history_err)
+        else:
+            logger.info("Administrator deleted built-in skill file %s/%s", skill.name, relative_posix)
+    except HTTPException:
+        raise
+    except ValueError as e:
+        raise HTTPException(status_code=400, detail=str(e))
+    except FileNotFoundError as e:
+        raise HTTPException(status_code=404, detail=str(e))
+    except Exception as e:
+        logger.error("Failed to delete skill file %s/%s: %s", skill_name, path, e, exc_info=True)
+        raise HTTPException(status_code=500, detail=f"Failed to delete skill file: {e}")
+
+
 @router.put(
     "/skills/{skill_name}",
     response_model=SkillResponse,
diff --git a/offline-backend-20260512/backend/config.yaml b/offline-backend-20260512/backend/config.yaml
index e5e9a1d2..85daa7aa 100644
--- a/offline-backend-20260512/backend/config.yaml
+++ b/offline-backend-20260512/backend/config.yaml
@@ -33,32 +33,64 @@ concurrency:
     fail_open: true
 
 models:
-  - name: deepseek-chat
-    display_name: DeepSeek Chat
-    use: langchain_openai:ChatOpenAI
-    model: deepseek-chat
-    api_key: $DEEPSEEK_CHAT_API_KEY
-    base_url: https://api.deepseek.com
-    request_timeout: 600.0
-    max_retries: 2
-    max_tokens: 4096
-    temperature: 1.0
-    supports_vision: false
-    supports_thinking: true
-
-  - name: zai-org/GLM-5-FP8
-    display_name: zai-org/GLM-5-FP8
-    use: langchain_openai:ChatOpenAI
-    model: zai-org/GLM-5-FP8
-    api_key: $GLM5_FP8_API_KEY
-    base_url: https://api.us-west-2.modal.direct/v1
-    request_timeout: 600.0
-    max_retries: 2
-    max_tokens: 4096
-    temperature: 1.0
-    supports_vision: true
-    supports_thinking: true
-
+- name: deepseek-chat
+  display_name: DeepSeek Chat
+  use: langchain_openai:ChatOpenAI
+  model: deepseek-chat
+  api_key: $DEEPSEEK_CHAT_API_KEY
+  base_url: https://api.deepseek.com
+  request_timeout: 600.0
+  max_retries: 2
+  max_tokens: 4096
+  temperature: 1.0
+  supports_vision: false
+  supports_thinking: true
+- name: zai-org/GLM-5-FP8
+  display_name: zai-org/GLM-5-FP8
+  use: langchain_openai:ChatOpenAI
+  model: zai-org/GLM-5-FP8
+  api_key: $GLM5_FP8_API_KEY
+  base_url: https://api.us-west-2.modal.direct/v2
+  request_timeout: 600.0
+  max_retries: 2
+  max_tokens: 4096
+  temperature: 1.0
+  supports_vision: true
+  supports_thinking: true
+  supports_reasoning_effort: false
+- name: deepseek-ai/DeepSeek-V4-Flash
+  display_name: deepseek-ai/DeepSeek-V4-Flash
+  use: langchain_openai:ChatOpenAI
+  model: deepseek-ai/DeepSeek-V4-Flash
+  api_key: $SILICONFLOW_API_KEY
+  base_url: https://api.siliconflow.cn/v1/
+  max_tokens: 4096
+  temperature: 1.0
+  supports_vision: true
+  supports_thinking: true
+  when_thinking_disabled:
+    extra_body:
+      enable_thinking: false
+- name: inclusionAI/Ling-flash-2.0
+  display_name: inclusionAI/Ling-flash-2.0
+  use: langchain_openai:ChatOpenAI
+  model: inclusionAI/Ling-flash-2.0
+  api_key: $SILICONFLOW_API_KEY
+  base_url: https://api.siliconflow.cn/v1/
+  max_tokens: 4096
+  temperature: 1.0
+  supports_vision: true
+  supports_thinking: true
+- name: deepseek-ai/DeepSeek-V4-Pro
+  display_name: deepseek-ai/DeepSeek-V4-Pro
+  use: langchain_openai:ChatOpenAI
+  model: deepseek-ai/DeepSeek-V4-Pro
+  api_key: $SILICONFLOW_API_KEY
+  base_url: https://api.siliconflow.cn/v1/
+  max_tokens: 4096
+  temperature: 1.0
+  supports_vision: true
+  supports_thinking: true
   # - name: deepseek-v4-flash
   #   display_name: DeepSeek V4 Flash
   #   use: langchain_openai:ChatOpenAI
@@ -71,7 +103,6 @@ models:
   #   temperature: 1.0
   #   supports_vision: false
   #   supports_thinking: true
-
   # - name: deepseek-v4-pro
   #   display_name: DeepSeek V4 Pro
   #   use: langchain_openai:ChatOpenAI
@@ -136,52 +167,9 @@ models:
   #   temperature: 1.0
   #   supports_vision: true
   #   supports_thinking: true
-  - name: deepseek-ai/DeepSeek-V4-Flash
-    display_name: deepseek-ai/DeepSeek-V4-Flash
-    use: langchain_openai:ChatOpenAI
-    model: deepseek-ai/DeepSeek-V4-Flash
-    api_key: $SILICONFLOW_API_KEY
-    base_url: https://api.siliconflow.cn/v1/
-    max_tokens: 4096
-    temperature: 1.0
-    supports_vision: true
-    supports_thinking: true
     # SiliconFlow 混合推理模型关思考用「请求体顶层 enable_thinking: false」,
     # 不认 chat_template_kwargs / thinking.type 那两种嵌套形状。声明这个后,
     # 网页端「关闭思考」对本模型才生效(开放接口另由 force_disable_thinking 兜底)。
-    when_thinking_disabled:
-      extra_body:
-        enable_thinking: false
-  - name: Pro/MiniMaxAI/MiniMax-M2.5
-    display_name: Pro/MiniMaxAI/MiniMax-M2.5
-    use: langchain_openai:ChatOpenAI
-    model: Pro/MiniMaxAI/MiniMax-M2.5
-    api_key: $SILICONFLOW_API_KEY
-    base_url: https://api.siliconflow.cn/v1/
-    max_tokens: 4096
-    temperature: 1.0
-    supports_vision: true
-    supports_thinking: true
-  - name: inclusionAI/Ling-flash-2.0
-    display_name: inclusionAI/Ling-flash-2.0
-    use: langchain_openai:ChatOpenAI
-    model: inclusionAI/Ling-flash-2.0
-    api_key: $SILICONFLOW_API_KEY
-    base_url: https://api.siliconflow.cn/v1/
-    max_tokens: 4096
-    temperature: 1.0
-    supports_vision: true
-    supports_thinking: true
-  - name: deepseek-ai/DeepSeek-V4-Pro
-    display_name: deepseek-ai/DeepSeek-V4-Pro
-    use: langchain_openai:ChatOpenAI
-    model: deepseek-ai/DeepSeek-V4-Pro
-    api_key: $SILICONFLOW_API_KEY
-    base_url: https://api.siliconflow.cn/v1/
-    max_tokens: 4096
-    temperature: 1.0
-    supports_vision: true
-    supports_thinking: true
 # 识图(图片识别)配置。
 # - model_name:指定一个 models[] 中的模型名,作为“默认识图大模型”。view_image 工具会把
 #   图片交给该模型识别,并把识别出的文字结果返回给主对话模型 —— 这样即使主对话模型不支持
diff --git a/offline-backend-20260512/backend/packages/harness/deerflow/persistence/migrations/versions/20260808_01_position_roundtable_shared_task_scope.py b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/migrations/versions/20260808_01_position_roundtable_shared_task_scope.py
new file mode 100644
index 00000000..38691fce
--- /dev/null
+++ b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/migrations/versions/20260808_01_position_roundtable_shared_task_scope.py
@@ -0,0 +1,69 @@
+"""Index optional task-scoped position-roundtable history.
+
+Revision ID: 20260808_01
+Revises: 20260729_01
+Create Date: 2026-08-08
+"""
+
+from __future__ import annotations
+
+import sqlalchemy as sa
+from alembic import op
+from sqlalchemy import inspect
+
+revision = "20260808_01"
+down_revision = "20260729_01"
+branch_labels = None
+depends_on = None
+
+_TABLE = "position_roundtable_sessions"
+_INDEX = "ix_position_roundtable_sessions_task_updated"
+
+
+def _has_table(table_name: str) -> bool:
+    return table_name in inspect(op.get_bind()).get_table_names()
+
+
+def _has_column(table_name: str, column_name: str) -> bool:
+    if not _has_table(table_name):
+        return False
+    return any(
+        column["name"] == column_name
+        for column in inspect(op.get_bind()).get_columns(table_name)
+    )
+
+
+def _has_index(table_name: str, index_name: str) -> bool:
+    if not _has_table(table_name):
+        return False
+    return index_name in {
+        index["name"] for index in inspect(op.get_bind()).get_indexes(table_name)
+    }
+
+
+def upgrade() -> None:
+    if not _has_table(_TABLE):
+        return
+    # Historical records must stay in the original personal mode. New records
+    # set this flag only when a route taskId explicitly requests sharing.
+    if not _has_column(_TABLE, "task_scoped"):
+        op.add_column(
+            _TABLE,
+            sa.Column(
+                "task_scoped",
+                sa.Boolean(),
+                nullable=False,
+                server_default=sa.false(),
+            ),
+        )
+    if not _has_index(_TABLE, _INDEX):
+        op.create_index(_INDEX, _TABLE, ["external_task_id", "updated_at"])
+
+
+def downgrade() -> None:
+    if not _has_table(_TABLE):
+        return
+    if _has_index(_TABLE, _INDEX):
+        op.drop_index(_INDEX, table_name=_TABLE)
+    if _has_column(_TABLE, "task_scoped"):
+        op.drop_column(_TABLE, "task_scoped")
diff --git a/offline-backend-20260512/backend/packages/harness/deerflow/persistence/models/__init__.py b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/models/__init__.py
index c388cf46..fe13e6ed 100644
--- a/offline-backend-20260512/backend/packages/harness/deerflow/persistence/models/__init__.py
+++ b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/models/__init__.py
@@ -57,6 +57,7 @@ from deerflow.persistence.positions.model import PositionRow, PositionTagBinding
 from deerflow.persistence.recommended_questions.model import RecommendedQuestionRow
 from deerflow.persistence.research_templates.model import ResearchTemplateRow
 from deerflow.persistence.roundtable_chains.model import RoundtableChainRow
+from deerflow.persistence.roundtable_artifact_submissions.model import RoundtableArtifactSubmissionRow
 from deerflow.persistence.roundtable_diagnostics.model import RoundtableDiagnosticRow
 from deerflow.persistence.roundtable_draft_shares.model import RoundtableDraftShareRow
 from deerflow.persistence.roundtable_drafts.model import (
@@ -121,6 +122,7 @@ __all__ = [
     "RecommendedQuestionRow",
     "ResearchTemplateRow",
     "RoundtableChainRow",
+    "RoundtableArtifactSubmissionRow",
     "RoundtableDraftRow",
     "RoundtableDraftShareRow",
     "RoundtableDiagnosticRow",
diff --git a/offline-backend-20260512/backend/packages/harness/deerflow/persistence/position_roundtable/model.py b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/position_roundtable/model.py
index fee04be5..56419161 100644
--- a/offline-backend-20260512/backend/packages/harness/deerflow/persistence/position_roundtable/model.py
+++ b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/position_roundtable/model.py
@@ -12,7 +12,7 @@ from __future__ import annotations
 
 from datetime import UTC, datetime
 
-from sqlalchemy import ForeignKey, Integer, String, UniqueConstraint
+from sqlalchemy import Boolean, ForeignKey, Index, Integer, String, UniqueConstraint
 from sqlalchemy.orm import Mapped, mapped_column
 
 from deerflow.persistence.base import Base
@@ -21,12 +21,23 @@ from deerflow.persistence.types import BeijingDateTime, PortableLongText
 
 class PositionRoundtableSessionRow(Base):
     __tablename__ = "position_roundtable_sessions"
+    __table_args__ = (
+        # History is read as "all conversations for one task, newest first".
+        # `user_id` remains audit data only; it must not partition a shared
+        # task workspace.
+        Index(
+            "ix_position_roundtable_sessions_task_updated",
+            "external_task_id",
+            "updated_at",
+        ),
+    )
 
     id: Mapped[str] = mapped_column(String(64), primary_key=True)
-    # Phase one uses normal account isolation. A future membership / role ACL
-    # can be added without changing the session or thread identifiers.
+    # Creator audit field. `task_scoped`, not merely external_task_id, opts a
+    # session into sharing. This keeps historical sidebar/mock rows private.
     user_id: Mapped[str] = mapped_column(String(64), nullable=False, index=True)
     external_task_id: Mapped[str | None] = mapped_column(String(128), nullable=True, index=True)
+    task_scoped: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False, server_default="0")
     task_snapshot: Mapped[str | None] = mapped_column(PortableLongText, nullable=True)
     chain_id: Mapped[str | None] = mapped_column(String(64), nullable=True, index=True)
     chain_snapshot: Mapped[str | None] = mapped_column(PortableLongText, nullable=True)
diff --git a/offline-backend-20260512/backend/packages/harness/deerflow/persistence/position_roundtable/sql.py b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/position_roundtable/sql.py
index 11dfd969..cb72b107 100644
--- a/offline-backend-20260512/backend/packages/harness/deerflow/persistence/position_roundtable/sql.py
+++ b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/position_roundtable/sql.py
@@ -46,11 +46,17 @@ class PositionRoundtableRepository:
     def __init__(self, session_factory: async_sessionmaker[AsyncSession]) -> None:
         self._sf = session_factory
 
+    @staticmethod
+    def _can_access(row: PositionRoundtableSessionRow, user_id: str) -> bool:
+        """Task-bound sessions are shared; unbound legacy sessions stay private."""
+        return bool(row.task_scoped) or row.user_id == user_id
+
     @staticmethod
     def _session_dict(row: PositionRoundtableSessionRow) -> dict[str, Any]:
         return {
             "id": row.id,
             "external_task_id": row.external_task_id,
+            "task_scoped": bool(row.task_scoped),
             "task_snapshot": _loads(row.task_snapshot) or {},
             "chain_id": row.chain_id,
             "chain_snapshot": _loads(row.chain_snapshot),
@@ -98,12 +104,14 @@ class PositionRoundtableRepository:
         *,
         external_task_id: str | None,
         task_snapshot: dict[str, Any] | None,
+        task_scoped: bool | None = None,
     ) -> dict[str, Any]:
         now = datetime.now(UTC)
         row = PositionRoundtableSessionRow(
             id=uuid4().hex,
             user_id=user_id,
             external_task_id=external_task_id or None,
+            task_scoped=bool(external_task_id) if task_scoped is None else task_scoped,
             task_snapshot=_dumps(task_snapshot or {}),
             status="intent_pending",
             created_at=now,
@@ -165,7 +173,8 @@ class PositionRoundtableRepository:
         row = PositionRoundtableSessionRow(
             id=session_id,
             user_id=user_id,
-            external_task_id=session_payload.get("external_task_id") or None,
+            external_task_id=str(session_payload.get("external_task_id") or "").strip() or None,
+            task_scoped=False,
             task_snapshot=_dumps(session_payload.get("task_snapshot") or {}),
             chain_id=session_payload.get("chain_id") or None,
             chain_snapshot=_dumps(session_payload.get("chain_snapshot")),
@@ -246,9 +255,17 @@ class PositionRoundtableRepository:
     async def list_sessions(
         self, user_id: str, *, external_task_id: str | None = None, limit: int = 50
     ) -> list[dict[str, Any]]:
-        stmt = select(PositionRoundtableSessionRow).where(PositionRoundtableSessionRow.user_id == user_id)
+        """List shared task history or the caller's legacy personal history."""
         if external_task_id:
-            stmt = stmt.where(PositionRoundtableSessionRow.external_task_id == external_task_id)
+            stmt = select(PositionRoundtableSessionRow).where(
+                PositionRoundtableSessionRow.external_task_id == external_task_id,
+                PositionRoundtableSessionRow.task_scoped.is_(True),
+            )
+        else:
+            stmt = select(PositionRoundtableSessionRow).where(
+                PositionRoundtableSessionRow.user_id == user_id,
+                PositionRoundtableSessionRow.task_scoped.is_(False),
+            )
         stmt = stmt.order_by(PositionRoundtableSessionRow.updated_at.desc()).limit(limit)
         async with self._sf() as session:
             rows = (await session.execute(stmt)).scalars().all()
@@ -257,7 +274,7 @@ class PositionRoundtableRepository:
     async def get_session(self, session_id: str, user_id: str) -> dict[str, Any] | None:
         async with self._sf() as session:
             row = await session.get(PositionRoundtableSessionRow, session_id)
-            if row is None or row.user_id != user_id:
+            if row is None or not self._can_access(row, user_id):
                 return None
             return self._session_dict(row)
 
@@ -280,7 +297,7 @@ class PositionRoundtableRepository:
     ) -> dict[str, Any] | None:
         async with self._sf() as session:
             row = await session.get(PositionRoundtableSessionRow, session_id)
-            if row is None or row.user_id != user_id:
+            if row is None or not self._can_access(row, user_id):
                 return None
             if task_snapshot is not _UNSET:
                 row.task_snapshot = _dumps(task_snapshot)
@@ -326,7 +343,7 @@ class PositionRoundtableRepository:
         now = datetime.now(UTC)
         async with self._sf() as session:
             row = await session.get(PositionRoundtableSessionRow, session_id)
-            if row is None or row.user_id != user_id:
+            if row is None or not self._can_access(row, user_id):
                 return None
             node_rows = (
                 await session.execute(
@@ -371,7 +388,7 @@ class PositionRoundtableRepository:
     async def list_nodes(self, session_id: str, user_id: str) -> list[dict[str, Any]] | None:
         async with self._sf() as session:
             parent = await session.get(PositionRoundtableSessionRow, session_id)
-            if parent is None or parent.user_id != user_id:
+            if parent is None or not self._can_access(parent, user_id):
                 return None
             rows = (
                 await session.execute(
@@ -384,16 +401,13 @@ class PositionRoundtableRepository:
 
     async def get_node(self, session_id: str, node_key: str, user_id: str) -> dict[str, Any] | None:
         async with self._sf() as session:
-            stmt = (
-                select(PositionRoundtableNodeRow)
-                .join(PositionRoundtableSessionRow, PositionRoundtableSessionRow.id == PositionRoundtableNodeRow.session_id)
-                .where(
-                    PositionRoundtableNodeRow.session_id == session_id,
-                    PositionRoundtableNodeRow.node_key == node_key,
-                    PositionRoundtableSessionRow.user_id == user_id,
-                )
-                .limit(1)
-            )
+            parent = await session.get(PositionRoundtableSessionRow, session_id)
+            if parent is None or not self._can_access(parent, user_id):
+                return None
+            stmt = select(PositionRoundtableNodeRow).where(
+                PositionRoundtableNodeRow.session_id == session_id,
+                PositionRoundtableNodeRow.node_key == node_key,
+            ).limit(1)
             row = (await session.execute(stmt)).scalars().first()
             return self._node_dict(row) if row is not None else None
 
@@ -415,16 +429,13 @@ class PositionRoundtableRepository:
         increment_rejection: bool = False,
     ) -> dict[str, Any] | None:
         async with self._sf() as session:
-            stmt = (
-                select(PositionRoundtableNodeRow)
-                .join(PositionRoundtableSessionRow, PositionRoundtableSessionRow.id == PositionRoundtableNodeRow.session_id)
-                .where(
-                    PositionRoundtableNodeRow.session_id == session_id,
-                    PositionRoundtableNodeRow.node_key == node_key,
-                    PositionRoundtableSessionRow.user_id == user_id,
-                )
-                .limit(1)
-            )
+            parent = await session.get(PositionRoundtableSessionRow, session_id)
+            if parent is None or not self._can_access(parent, user_id):
+                return None
+            stmt = select(PositionRoundtableNodeRow).where(
+                PositionRoundtableNodeRow.session_id == session_id,
+                PositionRoundtableNodeRow.node_key == node_key,
+            ).limit(1)
             row = (await session.execute(stmt)).scalars().first()
             if row is None:
                 return None
@@ -472,7 +483,7 @@ class PositionRoundtableRepository:
         now = datetime.now(UTC)
         async with self._sf() as session:
             parent = await session.get(PositionRoundtableSessionRow, session_id)
-            if parent is None or parent.user_id != user_id:
+            if parent is None or not self._can_access(parent, user_id):
                 return None
             rows = (
                 await session.execute(
@@ -538,19 +549,18 @@ class PositionRoundtableRepository:
         return await self.update_session(session_id, user_id, status="archived")
 
     async def delete_session(self, session_id: str, user_id: str) -> bool:
-        """Delete one user-owned history record and all of its node snapshots."""
+        """Delete a task-shared row or the caller's personal legacy row."""
         async with self._sf() as session:
             parent = (
                 await session.execute(
                     select(PositionRoundtableSessionRow)
                     .where(
                         PositionRoundtableSessionRow.id == session_id,
-                        PositionRoundtableSessionRow.user_id == user_id,
                     )
                     .limit(1)
                 )
             ).scalar_one_or_none()
-            if parent is None:
+            if parent is None or not self._can_access(parent, user_id):
                 return False
 
             # Do not rely on database-specific FK cascade settings. SQLite
@@ -564,7 +574,6 @@ class PositionRoundtableRepository:
             await session.execute(
                 delete(PositionRoundtableSessionRow).where(
                     PositionRoundtableSessionRow.id == session_id,
-                    PositionRoundtableSessionRow.user_id == user_id,
                 )
             )
             await session.commit()
diff --git a/offline-backend-20260512/backend/packages/harness/deerflow/persistence/roundtable_artifact_submissions/__init__.py b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/roundtable_artifact_submissions/__init__.py
new file mode 100644
index 00000000..98cd66d0
--- /dev/null
+++ b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/roundtable_artifact_submissions/__init__.py
@@ -0,0 +1,22 @@
+"""Task-scoped roundtable artifact submission status persistence."""
+
+from __future__ import annotations
+
+from deerflow.persistence.roundtable_artifact_submissions.base import RoundtableArtifactSubmissionStore
+from deerflow.persistence.roundtable_artifact_submissions.memory import MemoryRoundtableArtifactSubmissionStore
+from deerflow.persistence.roundtable_artifact_submissions.model import RoundtableArtifactSubmissionRow
+from deerflow.persistence.roundtable_artifact_submissions.sql import RoundtableArtifactSubmissionRepository
+
+__all__ = [
+    "MemoryRoundtableArtifactSubmissionStore",
+    "RoundtableArtifactSubmissionRepository",
+    "RoundtableArtifactSubmissionRow",
+    "RoundtableArtifactSubmissionStore",
+    "make_roundtable_artifact_submission_store",
+]
+
+
+def make_roundtable_artifact_submission_store(session_factory):
+    if session_factory is None:
+        return MemoryRoundtableArtifactSubmissionStore()
+    return RoundtableArtifactSubmissionRepository(session_factory)
diff --git a/offline-backend-20260512/backend/packages/harness/deerflow/persistence/roundtable_artifact_submissions/base.py b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/roundtable_artifact_submissions/base.py
new file mode 100644
index 00000000..e45743a0
--- /dev/null
+++ b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/roundtable_artifact_submissions/base.py
@@ -0,0 +1,44 @@
+"""Persistence contract for task-scoped roundtable artifact submissions.
+
+The store deliberately keeps only a stable reference to an artifact in a
+DeerFlow thread sandbox.  It does not copy the artifact body and never calls a
+downstream task-delivery service.
+"""
+
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import Any
+
+
+class RoundtableArtifactSubmissionStore(ABC):
+    """Shared submission-status store, partitioned only by task id."""
+
+    @abstractmethod
+    async def list_by_task(self, task_id: str, *, submitted: bool | None = True) -> list[dict[str, Any]]:
+        """Return artifact submission records for one task, newest first."""
+        raise NotImplementedError
+
+    @abstractmethod
+    async def submit(
+        self,
+        task_id: str,
+        artifact: dict[str, Any],
+        *,
+        task_delivery_id: str | None = None,
+        actor_id: str | None = None,
+    ) -> dict[str, Any]:
+        """Create or update the idempotent submission record for an artifact."""
+        raise NotImplementedError
+
+    @abstractmethod
+    async def cancel(
+        self,
+        task_id: str,
+        artifact: dict[str, Any],
+        *,
+        submission_id: str | None = None,
+        actor_id: str | None = None,
+    ) -> dict[str, Any] | None:
+        """Mark a submission as cancelled without deleting its audit record."""
+        raise NotImplementedError
diff --git a/offline-backend-20260512/backend/packages/harness/deerflow/persistence/roundtable_artifact_submissions/memory.py b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/roundtable_artifact_submissions/memory.py
new file mode 100644
index 00000000..a1cf4986
--- /dev/null
+++ b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/roundtable_artifact_submissions/memory.py
@@ -0,0 +1,127 @@
+"""In-memory roundtable artifact-submission store."""
+
+from __future__ import annotations
+
+from copy import deepcopy
+from datetime import UTC, datetime
+from hashlib import sha256
+from typing import Any
+from uuid import uuid4
+
+from deerflow.persistence.roundtable_artifact_submissions.base import RoundtableArtifactSubmissionStore
+from deerflow.persistence.types import BEIJING_TZ
+
+
+def submission_key(task_id: str, artifact: dict[str, Any]) -> str:
+    """Return the canonical server-owned idempotency key for an artifact."""
+    source_key = str(artifact["source_key"])
+    path = str(artifact["path"])
+    revision = int(artifact["revision"])
+    raw = "\x1f".join((task_id, source_key, path, str(revision)))
+    return sha256(raw.encode("utf-8")).hexdigest()
+
+
+def _now() -> str:
+    return datetime.now(UTC).astimezone(BEIJING_TZ).isoformat()
+
+
+def _artifact_values(artifact: dict[str, Any]) -> dict[str, Any]:
+    return {
+        "session_id": artifact.get("session_id"),
+        "thread_id": artifact.get("thread_id"),
+        "node_key": artifact.get("node_key"),
+        "source_key": artifact["source_key"],
+        "path": artifact["path"],
+        "name": artifact.get("name"),
+        "mime_type": artifact.get("mime_type"),
+        "revision": int(artifact["revision"]),
+    }
+
+
+class MemoryRoundtableArtifactSubmissionStore(RoundtableArtifactSubmissionStore):
+    def __init__(self) -> None:
+        self._rows: dict[tuple[str, str], dict[str, Any]] = {}
+
+    async def list_by_task(self, task_id: str, *, submitted: bool | None = True) -> list[dict[str, Any]]:
+        rows = [row for row in self._rows.values() if row["task_id"] == task_id and (submitted is None or row["submitted"] is submitted)]
+        rows.sort(key=lambda row: row["updated_at"], reverse=True)
+        return deepcopy(rows)
+
+    async def submit(
+        self,
+        task_id: str,
+        artifact: dict[str, Any],
+        *,
+        task_delivery_id: str | None = None,
+        actor_id: str | None = None,
+    ) -> dict[str, Any]:
+        key = submission_key(task_id, artifact)
+        row = self._rows.get((task_id, key))
+        values = _artifact_values(artifact)
+        if row is None:
+            now = _now()
+            row = {
+                "id": uuid4().hex,
+                "task_id": task_id,
+                "idempotency_key": key,
+                **values,
+                "task_delivery_id": task_delivery_id,
+                "submitted": True,
+                "submitted_at": now,
+                "cancelled_at": None,
+                "created_by": actor_id,
+                "updated_by": actor_id,
+                "submitted_by": actor_id,
+                "cancelled_by": None,
+                "created_at": now,
+                "updated_at": now,
+            }
+            self._rows[(task_id, key)] = row
+            return deepcopy(row)
+
+        changed = (
+            not row["submitted"]
+            or row.get("task_delivery_id") != task_delivery_id
+            or any(row.get(name) != value for name, value in values.items())
+        )
+        if changed:
+            now = _now()
+            row.update(values)
+            row.update(
+                {
+                    "task_delivery_id": task_delivery_id,
+                    "submitted": True,
+                    "submitted_at": now,
+                    "cancelled_at": None,
+                    "updated_by": actor_id,
+                    "submitted_by": actor_id,
+                    "cancelled_by": None,
+                    "updated_at": now,
+                }
+            )
+        return deepcopy(row)
+
+    async def cancel(
+        self,
+        task_id: str,
+        artifact: dict[str, Any],
+        *,
+        submission_id: str | None = None,
+        actor_id: str | None = None,
+    ) -> dict[str, Any] | None:
+        key = submission_key(task_id, artifact)
+        row = self._rows.get((task_id, key))
+        if row is None or (submission_id is not None and row["id"] != submission_id):
+            return None
+        if row["submitted"]:
+            now = _now()
+            row.update(
+                {
+                    "submitted": False,
+                    "cancelled_at": now,
+                    "updated_by": actor_id,
+                    "cancelled_by": actor_id,
+                    "updated_at": now,
+                }
+            )
+        return deepcopy(row)
diff --git a/offline-backend-20260512/backend/packages/harness/deerflow/persistence/roundtable_artifact_submissions/model.py b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/roundtable_artifact_submissions/model.py
new file mode 100644
index 00000000..f973b4bc
--- /dev/null
+++ b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/roundtable_artifact_submissions/model.py
@@ -0,0 +1,56 @@
+"""ORM model for task-scoped roundtable artifact submission status."""
+
+from __future__ import annotations
+
+from datetime import UTC, datetime
+
+from sqlalchemy import Boolean, Index, Integer, String, UniqueConstraint
+from sqlalchemy.orm import Mapped, mapped_column
+
+from deerflow.persistence.base import Base
+from deerflow.persistence.types import BeijingDateTime
+
+
+class RoundtableArtifactSubmissionRow(Base):
+    """One auditable submission state for one task artifact revision.
+
+    The natural idempotency key is a SHA-256 digest of
+    ``task_id + source_key + artifact_path + revision``.  Keeping the digest
+    short avoids a MySQL unique-index limit while the component columns remain
+    available for diagnostics and response shaping.
+    """
+
+    __tablename__ = "roundtable_artifact_submissions"
+    __table_args__ = (
+        UniqueConstraint("task_id", "idempotency_key", name="uq_roundtable_artifact_submission_task_key"),
+        Index("ix_roundtable_artifact_submission_task_state_updated", "task_id", "submitted", "updated_at"),
+    )
+
+    id: Mapped[str] = mapped_column(String(64), primary_key=True)
+    task_id: Mapped[str] = mapped_column(String(128), nullable=False, index=True)
+    idempotency_key: Mapped[str] = mapped_column(String(64), nullable=False)
+    source_key: Mapped[str] = mapped_column(String(512), nullable=False)
+    artifact_path: Mapped[str] = mapped_column(String(2048), nullable=False)
+    revision: Mapped[int] = mapped_column(Integer, nullable=False)
+
+    session_id: Mapped[str | None] = mapped_column(String(128), nullable=True)
+    thread_id: Mapped[str | None] = mapped_column(String(128), nullable=True)
+    node_key: Mapped[str | None] = mapped_column(String(256), nullable=True)
+    artifact_name: Mapped[str | None] = mapped_column(String(512), nullable=True)
+    mime_type: Mapped[str | None] = mapped_column(String(255), nullable=True)
+    task_delivery_id: Mapped[str | None] = mapped_column(String(255), nullable=True)
+
+    submitted: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False)
+    submitted_at: Mapped[datetime | None] = mapped_column(BeijingDateTime(), nullable=True)
+    cancelled_at: Mapped[datetime | None] = mapped_column(BeijingDateTime(), nullable=True)
+    created_by: Mapped[str | None] = mapped_column(String(64), nullable=True)
+    updated_by: Mapped[str | None] = mapped_column(String(64), nullable=True)
+    submitted_by: Mapped[str | None] = mapped_column(String(64), nullable=True)
+    cancelled_by: Mapped[str | None] = mapped_column(String(64), nullable=True)
+    created_at: Mapped[datetime] = mapped_column(BeijingDateTime(), nullable=False, default=lambda: datetime.now(UTC))
+    updated_at: Mapped[datetime] = mapped_column(
+        BeijingDateTime(),
+        nullable=False,
+        default=lambda: datetime.now(UTC),
+        onupdate=lambda: datetime.now(UTC),
+    )
diff --git a/offline-backend-20260512/backend/packages/harness/deerflow/persistence/roundtable_artifact_submissions/sql.py b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/roundtable_artifact_submissions/sql.py
new file mode 100644
index 00000000..6f397a81
--- /dev/null
+++ b/offline-backend-20260512/backend/packages/harness/deerflow/persistence/roundtable_artifact_submissions/sql.py
@@ -0,0 +1,188 @@
+"""SQLAlchemy-backed task-scoped roundtable artifact-submission store."""
+
+from __future__ import annotations
+
+from datetime import UTC, datetime
+from typing import Any
+from uuid import uuid4
+
+from sqlalchemy import select
+from sqlalchemy.exc import IntegrityError
+from sqlalchemy.ext.asyncio import AsyncSession, async_sessionmaker
+
+from deerflow.persistence.roundtable_artifact_submissions.base import RoundtableArtifactSubmissionStore
+from deerflow.persistence.roundtable_artifact_submissions.memory import submission_key
+from deerflow.persistence.roundtable_artifact_submissions.model import RoundtableArtifactSubmissionRow
+
+
+def _timestamp(value: datetime | None) -> str | None:
+    return value.isoformat() if isinstance(value, datetime) else value
+
+
+def _to_dict(row: RoundtableArtifactSubmissionRow) -> dict[str, Any]:
+    return {
+        "id": row.id,
+        "task_id": row.task_id,
+        "idempotency_key": row.idempotency_key,
+        "session_id": row.session_id,
+        "thread_id": row.thread_id,
+        "node_key": row.node_key,
+        "source_key": row.source_key,
+        "path": row.artifact_path,
+        "name": row.artifact_name,
+        "mime_type": row.mime_type,
+        "revision": row.revision,
+        "task_delivery_id": row.task_delivery_id,
+        "submitted": row.submitted,
+        "submitted_at": _timestamp(row.submitted_at),
+        "cancelled_at": _timestamp(row.cancelled_at),
+        "created_by": row.created_by,
+        "updated_by": row.updated_by,
+        "submitted_by": row.submitted_by,
+        "cancelled_by": row.cancelled_by,
+        "created_at": _timestamp(row.created_at),
+        "updated_at": _timestamp(row.updated_at),
+    }
+
+
+def _apply_artifact(row: RoundtableArtifactSubmissionRow, artifact: dict[str, Any]) -> None:
+    row.session_id = artifact.get("session_id")
+    row.thread_id = artifact.get("thread_id")
+    row.node_key = artifact.get("node_key")
+    row.source_key = artifact["source_key"]
+    row.artifact_path = artifact["path"]
+    row.artifact_name = artifact.get("name")
+    row.mime_type = artifact.get("mime_type")
+    row.revision = int(artifact["revision"])
+
+
+def _requires_submission_update(
+    row: RoundtableArtifactSubmissionRow,
+    artifact: dict[str, Any],
+    task_delivery_id: str | None,
+) -> bool:
+    return (
+        not row.submitted
+        or row.task_delivery_id != task_delivery_id
+        or row.session_id != artifact.get("session_id")
+        or row.thread_id != artifact.get("thread_id")
+        or row.node_key != artifact.get("node_key")
+        or row.artifact_name != artifact.get("name")
+        or row.mime_type != artifact.get("mime_type")
+    )
+
+
+class RoundtableArtifactSubmissionRepository(RoundtableArtifactSubmissionStore):
+    def __init__(self, session_factory: async_sessionmaker[AsyncSession]) -> None:
+        self._sf = session_factory
+
+    async def list_by_task(self, task_id: str, *, submitted: bool | None = True) -> list[dict[str, Any]]:
+        stmt = select(RoundtableArtifactSubmissionRow).where(RoundtableArtifactSubmissionRow.task_id == task_id)
+        if submitted is not None:
+            stmt = stmt.where(RoundtableArtifactSubmissionRow.submitted.is_(submitted))
+        stmt = stmt.order_by(RoundtableArtifactSubmissionRow.updated_at.desc())
+        async with self._sf() as session:
+            result = await session.execute(stmt)
+            return [_to_dict(row) for row in result.scalars()]
+
+    async def submit(
+        self,
+        task_id: str,
+        artifact: dict[str, Any],
+        *,
+        task_delivery_id: str | None = None,
+        actor_id: str | None = None,
+    ) -> dict[str, Any]:
+        key = submission_key(task_id, artifact)
+        stmt = select(RoundtableArtifactSubmissionRow).where(
+            RoundtableArtifactSubmissionRow.task_id == task_id,
+            RoundtableArtifactSubmissionRow.idempotency_key == key,
+        )
+        async with self._sf() as session:
+            result = await session.execute(stmt)
+            row = result.scalars().first()
+            now = datetime.now(UTC)
+            created = row is None
+            if row is None:
+                row = RoundtableArtifactSubmissionRow(
+                    id=uuid4().hex,
+                    task_id=task_id,
+                    idempotency_key=key,
+                    task_delivery_id=task_delivery_id,
+                    submitted=True,
+                    submitted_at=now,
+                    created_by=actor_id,
+                    updated_by=actor_id,
+                    submitted_by=actor_id,
+                    created_at=now,
+                    updated_at=now,
+                )
+                _apply_artifact(row, artifact)
+                session.add(row)
+            elif _requires_submission_update(row, artifact, task_delivery_id):
+                _apply_artifact(row, artifact)
+                row.task_delivery_id = task_delivery_id
+                row.submitted = True
+                row.submitted_at = now
+                row.cancelled_at = None
+                row.updated_by = actor_id
+                row.submitted_by = actor_id
+                row.cancelled_by = None
+                row.updated_at = now
+            try:
+                await session.commit()
+            except IntegrityError:
+                # Two callers can both observe a missing row.  The unique key
+                # turns that race into a normal idempotent retry instead of a
+                # 500.  If their non-key metadata differs, apply this request
+                # after loading the winner so PUT still has upsert semantics.
+                await session.rollback()
+                if not created:
+                    raise
+                result = await session.execute(stmt)
+                row = result.scalars().first()
+                if row is None:
+                    raise
+                if _requires_submission_update(row, artifact, task_delivery_id):
+                    now = datetime.now(UTC)
+                    _apply_artifact(row, artifact)
+                    row.task_delivery_id = task_delivery_id
+                    row.submitted = True
+                    row.submitted_at = now
+                    row.cancelled_at = None
+                    row.updated_by = actor_id
+                    row.submitted_by = actor_id
+                    row.cancelled_by = None
+                    row.updated_at = now
+                    await session.commit()
+            await session.refresh(row)
+            return _to_dict(row)
+
+    async def cancel(
+        self,
+        task_id: str,
+        artifact: dict[str, Any],
+        *,
+        submission_id: str | None = None,
+        actor_id: str | None = None,
+    ) -> dict[str, Any] | None:
+        key = submission_key(task_id, artifact)
+        stmt = select(RoundtableArtifactSubmissionRow).where(
+            RoundtableArtifactSubmissionRow.task_id == task_id,
+            RoundtableArtifactSubmissionRow.idempotency_key == key,
+        )
+        async with self._sf() as session:
+            result = await session.execute(stmt)
+            row = result.scalars().first()
+            if row is None or (submission_id is not None and row.id != submission_id):
+                return None
+            if row.submitted:
+                now = datetime.now(UTC)
+                row.submitted = False
+                row.cancelled_at = now
+                row.updated_by = actor_id
+                row.cancelled_by = actor_id
+                row.updated_at = now
+                await session.commit()
+                await session.refresh(row)
+            return _to_dict(row)
diff --git a/offline-backend-20260512/backend/packages/harness/deerflow/skills/types.py b/offline-backend-20260512/backend/packages/harness/deerflow/skills/types.py
index 0e5b9baf..fb964198 100644
--- a/offline-backend-20260512/backend/packages/harness/deerflow/skills/types.py
+++ b/offline-backend-20260512/backend/packages/harness/deerflow/skills/types.py
@@ -8,7 +8,7 @@ SKILL_MD_FILE = "SKILL.md"
 class SkillCategory(StrEnum):
     """Source category for a skill.
 
-    - ``PUBLIC``: built-in skill bundled with the platform, read-only.
+    - ``PUBLIC``: built-in skill bundled with the platform; administrator-managed.
     - ``CUSTOM``: user-authored skill that can be edited or deleted.
     """
 
diff --git a/offline-backend-20260512/backend/scripts/sql/column_additions_mysql.sql b/offline-backend-20260512/backend/scripts/sql/column_additions_mysql.sql
index e8e6e0cc..4b7d6cb3 100644
--- a/offline-backend-20260512/backend/scripts/sql/column_additions_mysql.sql
+++ b/offline-backend-20260512/backend/scripts/sql/column_additions_mysql.sql
@@ -117,6 +117,11 @@ CALL _add_column_if_missing('knowledge_notes', 'folder', 'VARCHAR(512) NULL DEFA
 --          ORM: RoundtableJobRow.task_id = String(128), nullable, indexed。
 CALL _add_column_if_missing('roundtable_jobs', 'task_id', 'VARCHAR(128) NULL DEFAULT NULL');
 
+-- ---- position_roundtable_sessions: opt-in task sharing, migration 20260808_01 ----
+-- Existing records remain personal (`task_scoped = 0`). New records become
+-- shared only when the caller explicitly sends a non-empty route taskId.
+CALL _add_column_if_missing('position_roundtable_sessions', 'task_scoped', 'TINYINT(1) NOT NULL DEFAULT 0');
+
 -- ---- 按钮管理「外部链接」追加登录参数,对应 migration 20260625_01 ----------------
 -- login_params_json: url 外链追加的登录参数列表 JSON([{key,source,custom_value},...]),
 --                    由前端运行时从 userInfo 解析后拼到地址尾部;NULL/空 = 不追加(旧行为)。
@@ -199,5 +204,6 @@ SELECT table_name, column_name
         OR (table_name = 'agents' AND column_name IN ('square_id'))
         OR (table_name = 'roundtable_drafts' AND column_name = 'task_id')
         OR (table_name = 'roundtable_jobs' AND column_name = 'task_id')
+        OR (table_name = 'position_roundtable_sessions' AND column_name = 'task_scoped')
         OR (table_name = 'task_buttons' AND column_name IN ('append_auth', 'auth_token_param', 'auth_name_param')))
  ORDER BY table_name, column_name;
diff --git a/offline-backend-20260512/backend/scripts/sql/leaderboard_indexes_mysql.sql b/offline-backend-20260512/backend/scripts/sql/leaderboard_indexes_mysql.sql
index 8c4151c3..5ce390fc 100644
--- a/offline-backend-20260512/backend/scripts/sql/leaderboard_indexes_mysql.sql
+++ b/offline-backend-20260512/backend/scripts/sql/leaderboard_indexes_mysql.sql
@@ -68,6 +68,10 @@ CALL _create_index_if_missing('llm_call_metrics', 'ix_llm_call_metrics_run_creat
 CALL _create_index_if_missing('threads_meta', 'ix_threads_meta_created_user', '`created_at`, `user_id`');
 CALL _create_index_if_missing('threads_meta', 'ix_threads_meta_user_created', '`user_id`, `created_at`');
 
+-- ---- position_roundtable_sessions --------------------------------------------
+-- Explicit taskId history is loaded by taskId and newest update time.
+CALL _create_index_if_missing('position_roundtable_sessions', 'ix_position_roundtable_sessions_task_updated', '`external_task_id`, `updated_at`');
+
 -- ---- 清理临时存储过程 --------------------------------------------------------
 DROP PROCEDURE IF EXISTS _create_index_if_missing;
 
diff --git a/offline-backend-20260512/backend/tests/test_model_management.py b/offline-backend-20260512/backend/tests/test_model_management.py
new file mode 100644
index 00000000..2e0ff11a
--- /dev/null
+++ b/offline-backend-20260512/backend/tests/test_model_management.py
@@ -0,0 +1,151 @@
+"""Focused regression tests for administrator model configuration helpers."""
+
+from __future__ import annotations
+
+from types import SimpleNamespace
+
+import pytest
+import yaml
+from starlette.routing import Match
+
+from app.gateway.routers import model_management as router
+
+
+def test_replace_models_block_keeps_other_sections_and_comments() -> None:
+    raw = """config_version: 1
+models:
+  # Existing provider note
+  - name: old-model
+    use: langchain_openai:ChatOpenAI
+    model: old-model
+# Disabled provider example remains useful to operators.
+# - name: disabled-model
+#   model: disabled-model
+agents:
+  default: lead_agent
+"""
+
+    replaced = router._replace_models_block(
+        raw,
+        [
+            {
+                "name": "new-model",
+                "use": "langchain_openai:ChatOpenAI",
+                "model": "new-model",
+            }
+        ],
+    )
+
+    parsed = yaml.safe_load(replaced)
+    assert parsed["models"] == [
+        {
+            "name": "new-model",
+            "use": "langchain_openai:ChatOpenAI",
+            "model": "new-model",
+        }
+    ]
+    assert parsed["agents"] == {"default": "lead_agent"}
+    assert "# Existing provider note" in replaced
+    assert "# Disabled provider example remains useful to operators." in replaced
+
+
+def test_connection_error_redaction_hides_literal_and_resolved_keys() -> None:
+    message = "provider rejected raw-secret and resolved-secret"
+    assert router._redact_text(message, ["raw-secret", "resolved-secret"]) == "provider rejected *** and ***"
+
+
+def test_model_mutation_routes_accept_names_with_slashes() -> None:
+    for method in ("PUT", "DELETE"):
+        route = next(
+            item
+            for item in router.router.routes
+            if getattr(item, "methods", set()) == {method} and getattr(item, "path", "") == "/api/admin/models/{model_name:path}"
+        )
+        match, child_scope = route.matches(
+            {
+                "type": "http",
+                "method": method,
+                "path": "/api/admin/models/zai-org/GLM-5-FP8",
+            }
+        )
+        assert match is Match.FULL
+        assert child_scope["path_params"] == {"model_name": "zai-org/GLM-5-FP8"}
+
+
+@pytest.mark.asyncio
+async def test_delete_model_configuration_removes_matching_model_and_activates_config(
+    tmp_path,
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    config_path = tmp_path / "config.yaml"
+    config_path.write_text(
+        """models:
+  - name: zai-org/GLM-5-FP8
+    use: langchain_openai:ChatOpenAI
+    model: GLM-5-FP8
+  - name: keep-me
+    use: langchain_openai:ChatOpenAI
+    model: keep-me
+""",
+        encoding="utf-8",
+    )
+    saved: dict[str, object] = {}
+
+    async def save_models(_request, raw_before: str, models: list[dict[str, object]]) -> list[dict[str, object]]:
+        saved["raw_before"] = raw_before
+        saved["models"] = models
+        return models
+
+    monkeypatch.setattr(router, "_resolve_config_path", lambda: config_path)
+    monkeypatch.setattr(router, "_save_models", save_models)
+    request = SimpleNamespace(state=SimpleNamespace(user=SimpleNamespace(system_role="admin")))
+
+    await router.delete_model_configuration("zai-org/GLM-5-FP8", request)
+
+    assert "zai-org/GLM-5-FP8" in str(saved["raw_before"])
+    assert saved["models"] == [
+        {
+            "name": "keep-me",
+            "use": "langchain_openai:ChatOpenAI",
+            "model": "keep-me",
+        }
+    ]
+
+
+@pytest.mark.asyncio
+async def test_connection_test_uses_one_minimal_prompt_without_writing_config(
+    tmp_path,
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    config_path = tmp_path / "config.yaml"
+    original = "models: []\nagent: lead_agent\n"
+    config_path.write_text(original, encoding="utf-8")
+    messages_seen = []
+
+    class FakeChatModel:
+        async def ainvoke(self, messages):
+            messages_seen.extend(messages)
+            return SimpleNamespace(content="OK")
+
+    monkeypatch.setattr(router, "_resolve_config_path", lambda: config_path)
+    monkeypatch.setattr(router, "create_chat_model", lambda *_args, **_kwargs: FakeChatModel())
+    request = SimpleNamespace(
+        state=SimpleNamespace(user=SimpleNamespace(system_role="admin")),
+        app=SimpleNamespace(state=SimpleNamespace(config=SimpleNamespace(model_copy=lambda **_kwargs: SimpleNamespace()))),
+    )
+    body = router.ModelTestRequest(
+        model=router.ModelUpsertRequest(
+            name="test-model",
+            use="langchain_openai:ChatOpenAI",
+            model="test-model",
+            api_key="raw-secret",
+        )
+    )
+
+    result = await router.test_model_connection(body, request)
+
+    assert result.success is True
+    assert result.preview == "OK"
+    assert len(messages_seen) == 1
+    assert messages_seen[0].content == "Reply with exactly: OK"
+    assert config_path.read_text(encoding="utf-8") == original
diff --git a/offline-backend-20260512/backend/tests/test_position_roundtable_sessions.py b/offline-backend-20260512/backend/tests/test_position_roundtable_sessions.py
index bebbd60d..b159196d 100644
--- a/offline-backend-20260512/backend/tests/test_position_roundtable_sessions.py
+++ b/offline-backend-20260512/backend/tests/test_position_roundtable_sessions.py
@@ -3,6 +3,9 @@
 from __future__ import annotations
 
 import asyncio
+import importlib.util
+import json
+import zipfile
 from types import SimpleNamespace
 from typing import Any
 
@@ -14,9 +17,14 @@ from sqlalchemy.ext.asyncio import async_sessionmaker, create_async_engine
 from app.gateway import deps as gateway_deps
 from app.gateway import services as gateway_services
 from app.gateway.app import create_app
+from app.gateway.routers import _roundtable_seed as roundtable_seed
 from app.gateway.routers import intent as intent_router
 from app.gateway.routers import multi_agent
 from app.gateway.routers import position_roundtable as position_roundtable_router
+from app.gateway.routers._roundtable_seed import (
+    POSITION_INTENT_AGENT_ID,
+    required_agent_ids,
+)
 from deerflow.persistence.base import Base
 from deerflow.persistence.position_roundtable import PositionRoundtableRepository
 from deerflow.persistence.thread_meta.sql import ThreadMetaRepository
@@ -55,6 +63,248 @@ def test_position_roundtable_router_has_intranet_compatibility_prefix():
     assert position_roundtable_router.router.prefix == "/position-roundtable"
 
 
+def test_position_intent_agent_is_a_seeded_functional_agent():
+    """Fresh deployments must materialize the dedicated position intent agent."""
+    assert POSITION_INTENT_AGENT_ID in set(required_agent_ids())
+
+
+def test_action_plan_seed_binds_the_batch_create_skill_and_nine_field_contract():
+    """New deployments must not fall back to the retired subtask JSON contract."""
+    action_assets = roundtable_seed._ASSETS_DIR / roundtable_seed.ACTION_PLAN_AGENT_ID
+    soul = (action_assets / "SOUL.md").read_text(encoding="utf-8")
+    config = (action_assets / "config.yaml").read_text(encoding="utf-8")
+
+    assert "position-roundtable-action-create" in config
+    for field in (
+        "actionName",
+        "actionDescription",
+        "actionType",
+        "publishChannel",
+        "infoFormat",
+        "responsiblePosition",
+        "startTime",
+        "endTime",
+        "taskId",
+    ):
+        assert field in soul
+    assert "/task/action/add" in soul
+    assert "批量新增" in soul
+
+
+@pytest.mark.asyncio
+async def test_action_plan_prompt_receives_frontend_task_id_and_dictionary_values():
+    """The action planner must see exact dictValue choices, not frontend labels only."""
+    dictionaries = position_roundtable_router.ActionPlanDictionaries(
+        publish_channels=[{"label": "微信公众号", "value": "11"}],
+        action_types=[{"label": "宣传", "value": "21"}],
+        info_formats=[{"label": "图文", "value": "31"}],
+        responsible_positions=[{"label": "规划岗", "value": "41"}],
+    )
+    prompt = await position_roundtable_router._build_builtin_prompt(
+        kind="action_plan",
+        session={
+            "task_snapshot": {"title": "任务 A", "description": "生成行动"},
+            "summary_snapshot": {"status": "done", "content": "方案总结正文"},
+        },
+        nodes=[],
+        action_task_id=1001,
+        action_dictionaries=dictionaries,
+    )
+
+    assert "当前 taskId：1001" in prompt
+    assert "微信公众号 → 11" in prompt
+    assert "宣传 → 21" in prompt
+    assert "图文 → 31" in prompt
+    assert "规划岗 → 41" in prompt
+    assert "id、title、goal" in prompt
+
+
+@pytest.mark.asyncio
+async def test_action_plan_prompt_degrades_when_task_dictionaries_are_unavailable():
+    """A 404 from the task-system dictionaries must not block local planning."""
+    prompt = await position_roundtable_router._build_builtin_prompt(
+        kind="action_plan",
+        session={
+            "task_snapshot": {"title": "本地演示任务"},
+            "summary_snapshot": {"status": "done", "content": "方案总结正文"},
+        },
+        nodes=[],
+        action_task_id="abc123",
+        action_dictionaries=position_roundtable_router.ActionPlanDictionaries(),
+    )
+
+    assert "字典未获取完整" in prompt
+    assert "不得调用 Skill" in prompt
+    assert "0 占位" in prompt
+
+
+def test_action_plan_prepare_keeps_a_local_mock_task_id_without_numeric_coercion():
+    """A local demo id must not stop the action-plan conversation at prepare time."""
+    body = position_roundtable_router.PrepareBuiltinRunRequest(task_id="abc123")
+
+    assert body.task_id == "abc123"
+
+
+def test_action_batch_skill_accepts_only_the_nine_field_array(tmp_path):
+    """The batch Skill must reject old task-subdivision fields before any HTTP call."""
+    archive_path = roundtable_seed._ASSETS_DIR.parents[3] / "skill-packages" / "position-roundtable-action-create.skill"
+    with zipfile.ZipFile(archive_path) as archive:
+        archive.extractall(tmp_path / "skill-package")
+    script_path = tmp_path / "skill-package" / "position-roundtable-action-create" / "scripts" / "batch_add_actions.py"
+    spec = importlib.util.spec_from_file_location("position_action_batch_skill", script_path)
+    assert spec and spec.loader
+    module = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(module)
+
+    valid = [{
+        "actionName": "发布内容",
+        "actionDescription": "向目标渠道发布审核通过的信息。",
+        "actionType": "1",
+        "publishChannel": "2",
+        "infoFormat": "3",
+        "responsiblePosition": "4",
+        "startTime": "2026-08-12T09:00:00+08:00",
+        "endTime": "2026-08-12T18:00:00+08:00",
+        "taskId": 1001,
+    }]
+    source = tmp_path / "action-plan-subtasks.json"
+    source.write_text(json.dumps(valid, ensure_ascii=False), encoding="utf-8")
+    assert module.read_actions(source, 1001) == [{
+        **valid[0],
+        "actionType": 1,
+        "publishChannel": 2,
+        "infoFormat": 3,
+        "responsiblePosition": 4,
+    }]
+
+    source.write_text(json.dumps([{**valid[0], "id": "legacy"}], ensure_ascii=False), encoding="utf-8")
+    with pytest.raises(module.ActionInputError, match="多余字段"):
+        module.read_actions(source, 1001)
+
+
+def test_position_intent_prompt_keeps_the_original_step_one_guardrails():
+    """Dedicated schema must not regress into solutioning or gatekeeping."""
+    prompt = (
+        roundtable_seed._ASSETS_DIR / POSITION_INTENT_AGENT_ID / "SOUL.md"
+    ).read_text(encoding="utf-8")
+
+    for phrase in (
+        "最多 5 轮用户协助",
+        "除 ask_clarification 外，禁止调用任何工具、技能或操作",
+        "你都不拒绝、不评价、不设限",
+        "不得说“不能帮你”“不在职责范围内”“请换一个问题”",
+        "coreGoals / riskWarnings / keyPoints / strategicSignificance",
+        "不能把“主题已识别”误判为“意图已明确”",
+        "任何任务若缺少范围、对象、时间、决策用途、重点维度或成功标准等关键信息时，必须请求用户协助",
+        "必须分析任务级风险",
+        "同一轮可发起多张用户协助卡",
+        "不得把多个问题塞进一张卡",
+    ):
+        assert phrase in prompt
+
+
+def test_position_intent_clarification_waits_for_the_user_before_ready():
+    """A same-run READY block must not consume the user-assistance pause."""
+    assert intent_router._clarification_blocks_ready(
+        intent_router.POSITION_INTENT_AGENT_ID,
+        {"name": "ask_clarification"},
+        is_fresh=True,
+    )
+    assert not intent_router._clarification_blocks_ready(
+        intent_router.INTENT_AGENT_ID,
+        {"name": "ask_clarification"},
+        is_fresh=True,
+    )
+    assert not intent_router._clarification_blocks_ready(
+        intent_router.POSITION_INTENT_AGENT_ID,
+        None,
+        is_fresh=True,
+    )
+    assert not intent_router._clarification_blocks_ready(
+        intent_router.POSITION_INTENT_AGENT_ID,
+        {"name": "ask_clarification"},
+        is_fresh=False,
+    )
+
+
+def test_position_intent_counts_multi_card_assistance_as_one_round():
+    """Five user-assistance rounds must not be consumed by five cards at once."""
+    messages: list[dict[str, Any]] = [
+        {
+            "type": "ai",
+            "tool_calls": [
+                {"id": "scope", "name": "ask_clarification", "args": {}},
+                {"id": "purpose", "name": "ask_clarification", "args": {}},
+                {"id": "time", "name": "ask_clarification", "args": {}},
+            ],
+        },
+        {"type": "human", "content": "用户统一答复"},
+        {
+            "type": "ai",
+            "tool_calls": [
+                {"id": "risk", "name": "ask_clarification", "args": {}},
+            ],
+        },
+    ]
+
+    assert intent_router._count_past_clarifications(messages) == 4
+    assert intent_router._count_past_clarification_rounds(messages) == 2
+    assert intent_router._max_clarification_rounds(intent_router.INTENT_AGENT_ID) == 3
+    assert (
+        intent_router._max_clarification_rounds(intent_router.POSITION_INTENT_AGENT_ID)
+        == 5
+    )
+
+
+def test_position_intent_seed_repairs_its_contract_without_touching_other_agents(tmp_path, monkeypatch):
+    """The dedicated schema prompt must replace an accidentally seeded old version."""
+    agents_dir = tmp_path / "agents"
+    monkeypatch.setattr(
+        roundtable_seed,
+        "get_paths",
+        lambda: SimpleNamespace(agent_dir=lambda agent_id: agents_dir / agent_id),
+    )
+
+    position_dir = agents_dir / POSITION_INTENT_AGENT_ID
+    position_dir.mkdir(parents=True)
+    (position_dir / "SOUL.md").write_text("outdated prompt", encoding="utf-8")
+    assert roundtable_seed._ensure_one(POSITION_INTENT_AGENT_ID) is True
+    expected_soul = (
+        roundtable_seed._ASSETS_DIR / POSITION_INTENT_AGENT_ID / "SOUL.md"
+    ).read_text(encoding="utf-8")
+    assert (position_dir / "SOUL.md").read_text(encoding="utf-8") == expected_soul
+
+    generic_dir = agents_dir / roundtable_seed.INTENT_AGENT_ID
+    generic_dir.mkdir(parents=True)
+    generic_soul = generic_dir / "SOUL.md"
+    generic_soul.write_text("deployed generic tune", encoding="utf-8")
+    assert roundtable_seed._ensure_one(roundtable_seed.INTENT_AGENT_ID) is False
+    assert generic_soul.read_text(encoding="utf-8") == "deployed generic tune"
+
+
+def test_existing_action_planner_only_merges_the_owned_skill(tmp_path, monkeypatch):
+    """A code upgrade may add the Skill without overwriting a user-tuned SOUL."""
+    agents_dir = tmp_path / "agents"
+    monkeypatch.setattr(
+        roundtable_seed,
+        "get_paths",
+        lambda: SimpleNamespace(agent_dir=lambda agent_id: agents_dir / agent_id),
+    )
+    action_dir = agents_dir / roundtable_seed.ACTION_PLAN_AGENT_ID
+    action_dir.mkdir(parents=True)
+    (action_dir / "SOUL.md").write_text("deployed action-plan tune", encoding="utf-8")
+    (action_dir / "config.yaml").write_text(
+        "id: position-action-planner\nskills:\n  - existing-skill\n",
+        encoding="utf-8",
+    )
+
+    assert roundtable_seed._ensure_one(roundtable_seed.ACTION_PLAN_AGENT_ID) is True
+    config = (action_dir / "config.yaml").read_text(encoding="utf-8")
+    assert "existing-skill" in config
+    assert "position-roundtable-action-create" in config
+    assert (action_dir / "SOUL.md").read_text(encoding="utf-8") == "deployed action-plan tune"
+
+
 @pytest.mark.asyncio
 async def test_intent_init_creates_thread_directly_without_loopback(monkeypatch):
     """Step 1 initialization must not depend on the deployed Gateway port."""
@@ -91,6 +341,71 @@ async def test_intent_init_creates_thread_directly_without_loopback(monkeypatch)
     }
 
 
+@pytest.mark.asyncio
+async def test_position_intent_init_selects_its_dedicated_agent(monkeypatch):
+    """Position roundtable must never mutate the generic Step-1 agent contract."""
+    captured: dict[str, object] = {}
+    monkeypatch.setattr(intent_router, "ensure_roundtable_functional_agents", lambda: None)
+
+    async def fake_create_thread_direct(request, *, metadata):
+        captured["metadata"] = metadata
+        return "position-intent-thread"
+
+    monkeypatch.setattr(intent_router, "_create_thread_direct", fake_create_thread_direct)
+
+    result = await intent_router.init_intent(
+        SimpleNamespace(),
+        {
+            "intent_agent_id": intent_router.POSITION_INTENT_AGENT_ID,
+            "task_context": {"task": {"id": "task-position-001"}},
+        },
+    )
+
+    assert result == {
+        "status": "success",
+        "agent_id": intent_router.POSITION_INTENT_AGENT_ID,
+        "thread_id": "position-intent-thread",
+    }
+    assert captured["metadata"] == {
+        **intent_router._ROUNDTABLE_THREAD_METADATA,
+        "taskId": "task-position-001",
+        "position_roundtable_task_id": "task-position-001",
+        "position_task_id": "task-position-001:intelligence",
+        "position_id": "intelligence",
+        "position_roundtable_phase": "intent",
+        "position_roundtable_intent_agent_id": intent_router.POSITION_INTENT_AGENT_ID,
+    }
+
+
+def test_position_intent_schema_is_required_for_new_snapshots_and_legacy_is_kept():
+    assert position_roundtable_router._has_confirmed_intent(
+        {
+            "coreGoals": ["形成统一处置方案"],
+            "riskWarnings": [],
+            "keyPoints": ["需要在本周完成"],
+            "strategicSignificance": ["为后续岗位协同提供统一边界"],
+        }
+    )
+    assert not position_roundtable_router._has_confirmed_intent(
+        {"coreGoals": ["形成统一处置方案"], "riskWarnings": []}
+    )
+    assert position_roundtable_router._has_confirmed_intent(
+        {"objective": "历史任务", "constraints": []}
+    )
+    answer = position_roundtable_router._intent_node_answer(
+        {
+            "coreGoals": ["形成统一处置方案"],
+            "riskWarnings": ["关键数据尚待确认"],
+            "keyPoints": ["聚焦当前任务范围"],
+            "strategicSignificance": ["支撑业务链协同推进"],
+        }
+    )
+    assert "核心目标" in answer
+    assert "风险提示" in answer
+    assert "关键要点" in answer
+    assert "战略意义" in answer
+
+
 @pytest.mark.asyncio
 async def test_session_activation_freezes_chain_and_creates_nodes_once(store):
     created = await store.create_session(
@@ -208,14 +523,91 @@ async def test_conversation_snapshots_round_trip_and_history_delete_removes_node
     assert saved_node is not None
     assert saved_node["conversation_snapshot"] == node_conversation
 
-    # Ownership checks apply to delete as well.
-    assert not await store.delete_session(created["id"], "user-b")
-    assert await store.get_session(created["id"], "user-a") is not None
-    assert await store.delete_session(created["id"], "user-a")
+    # Position roundtable history is shared by taskId, so a collaborator can
+    # read and remove the same task conversation without being its creator.
+    assert await store.get_session(created["id"], "user-b") is not None
+    assert await store.delete_session(created["id"], "user-b")
     assert await store.get_session(created["id"], "user-a") is None
     assert await store.list_nodes(created["id"], "user-a") is None
 
 
+@pytest.mark.asyncio
+async def test_task_scoped_history_is_shared_but_never_mixes_tasks(store):
+    shared = await store.create_session(
+        "user-a",
+        external_task_id="external-task-100",
+        task_snapshot={"id": "external-task-100", "title": "共享任务"},
+    )
+    await store.create_session(
+        "user-b",
+        external_task_id="external-task-200",
+        task_snapshot={"id": "external-task-200", "title": "另一任务"},
+    )
+
+    visible_to_collaborator = await store.list_sessions(
+        "user-b", external_task_id="external-task-100"
+    )
+    assert [row["id"] for row in visible_to_collaborator] == [shared["id"]]
+
+    updated = await store.update_session(
+        shared["id"],
+        "user-b",
+        task_snapshot={"id": "external-task-100", "title": "协作者已更新"},
+    )
+    assert updated is not None
+    assert updated["task_snapshot"]["title"] == "协作者已更新"
+    assert (await store.get_session(shared["id"], "user-a"))["task_snapshot"]["title"] == "协作者已更新"
+
+
+@pytest.mark.asyncio
+async def test_unscoped_history_keeps_original_user_isolation(store):
+    personal = await store.create_session(
+        "user-a",
+        external_task_id=None,
+        task_snapshot={"id": "legacy-card-id", "title": "个人会话"},
+    )
+
+    assert await store.get_session(personal["id"], "user-b") is None
+    assert await store.list_sessions("user-b") == []
+    assert await store.update_session(personal["id"], "user-b", status="active") is None
+    assert not await store.delete_session(personal["id"], "user-b")
+
+    # Old client records could already carry a mock task id. The new database
+    # marker keeps them personal after the migration; only a new explicit
+    # route taskId creates a shared row.
+    legacy_with_mock_task_id = await store.create_session(
+        "user-a",
+        external_task_id="legacy-mock-task-id",
+        task_scoped=False,
+        task_snapshot={"id": "legacy-card-id", "title": "鏃х増涓汉浼氳瘽"},
+    )
+    assert await store.get_session(legacy_with_mock_task_id["id"], "user-b") is None
+    assert await store.list_sessions("user-b", external_task_id="legacy-mock-task-id") == []
+
+
+def test_session_create_allows_missing_task_id_and_scoped_snapshots_keep_scope():
+    body = position_roundtable_router.SessionCreateRequest(
+        external_task_id="  task-route-001  ",
+        task_snapshot={"id": "wrong-id", "title": "任务"},
+    )
+    assert body.external_task_id == "task-route-001"
+    assert position_roundtable_router._task_snapshot_for_scope(
+        body.external_task_id,
+        body.task_snapshot,
+    ) == {
+        "id": "task-route-001",
+        "externalTaskId": "task-route-001",
+        "title": "任务",
+    }
+    assert position_roundtable_router.SessionCreateRequest(task_snapshot={}).external_task_id is None
+    assert position_roundtable_router.SessionCreateRequest(external_task_id="   ").external_task_id is None
+    assert position_roundtable_router._task_snapshot_for_scope(
+        "legacy-mock-task-id",
+        {"id": "legacy-card-id", "title": "旧记录"},
+        task_scoped=False,
+    ) == {"id": "legacy-card-id", "title": "旧记录"}
+
+
 @pytest.mark.asyncio
 async def test_demo_seed_is_complete_idempotent_and_user_scoped(store):
     payload = {
@@ -490,6 +882,7 @@ async def test_builtin_summary_completion_persists_fallback_markdown_when_agent_
     }
     session = {
         "id": "session-a",
+        "external_task_id": "task-fallback",
         "status": "active",
         "task_snapshot": {},
         "chain_id": "chain-a",
@@ -561,7 +954,7 @@ async def test_builtin_summary_completion_persists_fallback_markdown_when_agent_
 
 
 @pytest.mark.asyncio
-async def test_node_updates_are_user_scoped_and_keep_thread_out_of_messages(store):
+async def test_node_updates_are_user_scoped_without_task_id(store):
     created = await store.create_session("user-a", external_task_id=None, task_snapshot={})
     _, nodes = await store.activate_session(
         created["id"],
@@ -602,7 +995,9 @@ async def test_node_updates_are_user_scoped_and_keep_thread_out_of_messages(stor
 
 @pytest.mark.asyncio
 async def test_reject_node_marks_current_and_invalidates_later_stages(store):
-    created = await store.create_session("user-a", external_task_id=None, task_snapshot={})
+    created = await store.create_session(
+        "user-a", external_task_id="task-reject", task_snapshot={}
+    )
     _, nodes = await store.activate_session(
         created["id"],
         "user-a",
@@ -682,7 +1077,7 @@ async def test_reject_node_marks_current_and_invalidates_later_stages(store):
 async def test_builtin_summary_and_action_plan_snapshots_are_invalidated_by_reject(store):
     created = await store.create_session(
         "user-a",
-        external_task_id=None,
+        external_task_id="task-builtin-invalidation",
         task_snapshot={
             "title": "测试任务",
             "description": "形成协同方案",
diff --git a/offline-backend-20260512/backend/tests/test_roundtable_seat_modes.py b/offline-backend-20260512/backend/tests/test_roundtable_seat_modes.py
index 954218d9..4996f161 100644
--- a/offline-backend-20260512/backend/tests/test_roundtable_seat_modes.py
+++ b/offline-backend-20260512/backend/tests/test_roundtable_seat_modes.py
@@ -116,3 +116,13 @@ async def test_unknown_mode_value_ignored_falls_through(_gw):
     await _run(gateway)
     assert captured["thinking_enabled"] is True
     assert captured["reasoning_effort"] == "low"
+
+
+def test_chain_seat_schema_keeps_human_validation_checkpoint():
+    """Chain-seat JSON must preserve the frontend Step 2 pause configuration."""
+    from app.gateway.routers.roundtable_chains import ChainSeatSchema
+
+    assert ChainSeatSchema(agent_id="seat-1").human_validation is False
+    assert ChainSeatSchema(agent_id="seat-1", human_validation=True).model_dump()[
+        "human_validation"
+    ] is True
diff --git a/tmp/maintenance-manual/DeerFlow系统运维手册-内网离线部署版.docx b/tmp/maintenance-manual/DeerFlow系统运维手册-内网离线部署版.docx
new file mode 100644
index 00000000..c5ffed56
Binary files /dev/null and b/tmp/maintenance-manual/DeerFlow系统运维手册-内网离线部署版.docx differ
diff --git a/tmp/maintenance-manual/DeerFlow系统运维手册-用户重点版.docx b/tmp/maintenance-manual/DeerFlow系统运维手册-用户重点版.docx
new file mode 100644
index 00000000..757ada24
Binary files /dev/null and b/tmp/maintenance-manual/DeerFlow系统运维手册-用户重点版.docx differ
diff --git a/tmp/maintenance-manual/assets/architecture.png b/tmp/maintenance-manual/assets/architecture.png
new file mode 100644
index 00000000..0f580d3f
Binary files /dev/null and b/tmp/maintenance-manual/assets/architecture.png differ
diff --git a/tmp/maintenance-manual/assets/backup_upgrade.png b/tmp/maintenance-manual/assets/backup_upgrade.png
new file mode 100644
index 00000000..ec0f83de
Binary files /dev/null and b/tmp/maintenance-manual/assets/backup_upgrade.png differ
diff --git a/tmp/maintenance-manual/assets/config_layers.png b/tmp/maintenance-manual/assets/config_layers.png
new file mode 100644
index 00000000..95d5cfa1
Binary files /dev/null and b/tmp/maintenance-manual/assets/config_layers.png differ
diff --git a/tmp/maintenance-manual/assets/lost_asset_flow.png b/tmp/maintenance-manual/assets/lost_asset_flow.png
new file mode 100644
index 00000000..3aaea1f2
Binary files /dev/null and b/tmp/maintenance-manual/assets/lost_asset_flow.png differ
diff --git a/tmp/maintenance-manual/assets/model_flow.png b/tmp/maintenance-manual/assets/model_flow.png
new file mode 100644
index 00000000..b0e99ca5
Binary files /dev/null and b/tmp/maintenance-manual/assets/model_flow.png differ
diff --git a/tmp/maintenance-manual/assets/persistence_map.png b/tmp/maintenance-manual/assets/persistence_map.png
new file mode 100644
index 00000000..9d146a34
Binary files /dev/null and b/tmp/maintenance-manual/assets/persistence_map.png differ
diff --git a/tmp/maintenance-manual/assets/publish_flow.png b/tmp/maintenance-manual/assets/publish_flow.png
new file mode 100644
index 00000000..ad3199ca
Binary files /dev/null and b/tmp/maintenance-manual/assets/publish_flow.png differ
diff --git a/tmp/maintenance-manual/assets/roles.png b/tmp/maintenance-manual/assets/roles.png
new file mode 100644
index 00000000..f6a49944
Binary files /dev/null and b/tmp/maintenance-manual/assets/roles.png differ
diff --git a/tmp/maintenance-manual/assets/ui_map.png b/tmp/maintenance-manual/assets/ui_map.png
new file mode 100644
index 00000000..9c1d79f0
Binary files /dev/null and b/tmp/maintenance-manual/assets/ui_map.png differ
diff --git a/tmp/maintenance-manual/build_manual.py b/tmp/maintenance-manual/build_manual.py
new file mode 100644
index 00000000..b5f7f915
--- /dev/null
+++ b/tmp/maintenance-manual/build_manual.py
@@ -0,0 +1,1905 @@
+from __future__ import annotations
+
+import os
+from pathlib import Path
+from textwrap import dedent
+
+from PIL import Image, ImageDraw, ImageFont
+from docx import Document
+from docx.enum.section import WD_SECTION
+from docx.enum.style import WD_STYLE_TYPE
+from docx.enum.table import WD_ALIGN_VERTICAL, WD_CELL_VERTICAL_ALIGNMENT
+from docx.enum.text import WD_ALIGN_PARAGRAPH, WD_BREAK, WD_LINE_SPACING
+from docx.oxml import OxmlElement
+from docx.oxml.ns import qn
+from docx.shared import Inches, Pt, RGBColor
+
+
+ROOT = Path(__file__).resolve().parent
+ASSETS = ROOT / "assets"
+OUTPUT = ROOT / "DeerFlow系统运维手册-内网离线部署版.docx"
+
+BLUE = "2E74B5"
+DARK_BLUE = "1F4D78"
+LIGHT_BLUE = "E8F2FA"
+PALE_BLUE = "F3F8FC"
+PALE_GREEN = "EAF5EE"
+PALE_YELLOW = "FFF5D9"
+PALE_RED = "FCE8E6"
+GRAY = "606A73"
+LIGHT_GRAY = "F3F5F7"
+BORDER = "B9C6D2"
+TEXT = "24313A"
+WHITE = "FFFFFF"
+USABLE_DXA = 9360
+
+
+def pil_color(value):
+    if isinstance(value, str) and len(value) in (6, 8) and not value.startswith("#"):
+        return f"#{value}"
+    return value
+
+
+class ColorDraw:
+    """Normalize bare six-digit hex colors before forwarding to Pillow."""
+
+    def __init__(self, raw):
+        self.raw = raw
+
+    def __getattr__(self, name):
+        attr = getattr(self.raw, name)
+        if not callable(attr):
+            return attr
+
+        def wrapped(*args, **kwargs):
+            for key in ("fill", "outline"):
+                if key in kwargs:
+                    kwargs[key] = pil_color(kwargs[key])
+            return attr(*args, **kwargs)
+
+        return wrapped
+
+
+def ensure_dirs() -> None:
+    ASSETS.mkdir(parents=True, exist_ok=True)
+
+
+def font_path(bold: bool = False) -> str:
+    candidates = [
+        r"C:\Windows\Fonts\msyhbd.ttc" if bold else r"C:\Windows\Fonts\msyh.ttc",
+        r"C:\Windows\Fonts\simhei.ttf" if bold else r"C:\Windows\Fonts\simsun.ttc",
+        r"C:\Windows\Fonts\arialbd.ttf" if bold else r"C:\Windows\Fonts\arial.ttf",
+    ]
+    for candidate in candidates:
+        if Path(candidate).exists():
+            return candidate
+    raise FileNotFoundError("No usable Windows font found")
+
+
+def pil_font(size: int, bold: bool = False) -> ImageFont.FreeTypeFont:
+    return ImageFont.truetype(font_path(bold), size=size)
+
+
+def rounded_box(draw: ImageDraw.ImageDraw, xy, fill, outline=BLUE, width=3, radius=24):
+    draw.rounded_rectangle(xy, radius=radius, fill=fill, outline=outline, width=width)
+
+
+def center_text(draw: ImageDraw.ImageDraw, xy, text, font, fill=TEXT, spacing=8):
+    x1, y1, x2, y2 = xy
+    bbox = draw.multiline_textbbox((0, 0), text, font=font, align="center", spacing=spacing)
+    tw, th = bbox[2] - bbox[0], bbox[3] - bbox[1]
+    draw.multiline_text(((x1 + x2 - tw) / 2, (y1 + y2 - th) / 2), text, font=font, fill=fill, align="center", spacing=spacing)
+
+
+def arrow(draw: ImageDraw.ImageDraw, start, end, fill=BLUE, width=6):
+    draw.line([start, end], fill=fill, width=width)
+    x1, y1 = start
+    x2, y2 = end
+    dx, dy = x2 - x1, y2 - y1
+    length = max((dx * dx + dy * dy) ** 0.5, 1)
+    ux, uy = dx / length, dy / length
+    px, py = -uy, ux
+    tip = (x2, y2)
+    a = (x2 - ux * 24 + px * 12, y2 - uy * 24 + py * 12)
+    b = (x2 - ux * 24 - px * 12, y2 - uy * 24 - py * 12)
+    draw.polygon([tip, a, b], fill=fill)
+
+
+def base_canvas(title: str, subtitle: str = ""):
+    img = Image.new("RGB", (1800, 1020), pil_color(WHITE))
+    draw = ColorDraw(ImageDraw.Draw(img))
+    draw.rounded_rectangle((30, 30, 1770, 990), radius=32, fill="F8FBFD", outline="CFDCE7", width=3)
+    draw.text((90, 72), title, font=pil_font(48, True), fill=DARK_BLUE)
+    if subtitle:
+        draw.text((92, 138), subtitle, font=pil_font(24), fill=GRAY)
+    draw.line((90, 190, 1710, 190), fill="D9E5EE", width=3)
+    return img, draw
+
+
+def make_diagrams() -> dict[str, Path]:
+    paths: dict[str, Path] = {}
+
+    img, draw = base_canvas("DeerFlow 生产访问链路", "推荐：浏览器只访问一个前端端口，Nginx 同源反向代理后端")
+    boxes = {
+        "browser": (90, 340, 390, 560),
+        "nginx": (520, 300, 870, 600),
+        "backend": (1010, 260, 1390, 490),
+        "data": (1010, 610, 1390, 840),
+        "external": (1480, 260, 1710, 840),
+    }
+    rounded_box(draw, boxes["browser"], "E8F2FA")
+    rounded_box(draw, boxes["nginx"], "DCECF8")
+    rounded_box(draw, boxes["backend"], "EAF5EE", outline="4B8C63")
+    rounded_box(draw, boxes["data"], "FFF5D9", outline="AA7D10")
+    rounded_box(draw, boxes["external"], "F1ECF8", outline="76519A")
+    center_text(draw, boxes["browser"], "用户浏览器\nhttp://服务器:APP_PORT", pil_font(31, True))
+    center_text(draw, boxes["nginx"], "Web 容器 / Nginx\n静态前端 + /deerflow 代理\n容器内 80", pil_font(30, True))
+    center_text(draw, boxes["backend"], "Backend 容器\nFastAPI + Agent Runtime\n容器内 8001", pil_font(30, True))
+    center_text(draw, boxes["data"], "持久化目录\ndata/backend · data/skills\nconfig · 日志 · 知识库", pil_font(28, True))
+    center_text(draw, boxes["external"], "外部依赖\nMySQL\n模型 API\nHindsight\n业务接口", pil_font(26, True))
+    arrow(draw, (390, 450), (520, 450))
+    arrow(draw, (870, 400), (1010, 375))
+    arrow(draw, (1200, 490), (1200, 610), fill="AA7D10")
+    arrow(draw, (1390, 375), (1480, 375), fill="76519A")
+    path = ASSETS / "architecture.png"
+    img.save(path)
+    paths["architecture"] = path
+
+    img, draw = base_canvas("配置分层：先判断改哪一层", "最常见的误区是改了源码 .env，却没有改运行中的部署配置")
+    levels = [
+        ((110, 245, 1690, 390), "① 部署层 .env", "APP_PORT、镜像标签、Compose 变量\n改后重建 Web 或受影响服务", "E8F2FA"),
+        ((110, 420, 1690, 565), "② 后端配置\nbackend.env + config.yaml", "登录 JWT、模型 Key、数据库 URL\n环境变量变更需重建 Backend", "EAF5EE"),
+        ((110, 595, 1690, 740), "③ 前端运行时配置\nruntime-config.js", "后端/API、业务接口、Logo\n通常重启 Web + 浏览器强刷", "FFF5D9"),
+        ((110, 770, 1690, 915), "④ 管理页面配置", "菜单、主题、发布广场、敏感词\n写入数据库，保存后全局生效", "F1ECF8"),
+    ]
+    for xy, title, desc, fill in levels:
+        rounded_box(draw, xy, fill)
+        center_text(draw, (145, xy[1] + 10, 665, xy[3] - 10), title, pil_font(26, True), DARK_BLUE)
+        center_text(draw, (700, xy[1] + 10, 1650, xy[3] - 10), desc, pil_font(23), TEXT)
+    path = ASSETS / "config_layers.png"
+    img.save(path)
+    paths["config_layers"] = path
+
+    img, draw = base_canvas("账号与权限边界", "四种身份不要混用：系统层权限不能替代应用层权限")
+    roles = [
+        ((90, 265, 455, 800), "Linux / 1Panel 管理员", "安装镜像、改文件\n看日志、备份与恢复\n\n不是 DeerFlow\n应用管理员", "E8F2FA"),
+        ((505, 265, 870, 800), "DeerFlow admin", "菜单、主题、广场\n白名单与全局资产\n\nsystem_role=admin", "EAF5EE"),
+        ((920, 265, 1285, 800), "lqq 账号", "前端敏感词管理页\n专用入口\n\n用户名或邮箱 @ 前缀\n必须为 lqq", "FFF5D9"),
+        ((1335, 265, 1700, 800), "普通业务用户", "聊天、维护自己的\n技能和智能体、发布/下架\n\nsystem_role=user", "F1ECF8"),
+    ]
+    for xy, title, desc, fill in roles:
+        rounded_box(draw, xy, fill)
+        center_text(draw, (xy[0] + 18, xy[1] + 28, xy[2] - 18, xy[1] + 145), title, pil_font(29, True), fill=DARK_BLUE)
+        center_text(draw, (xy[0] + 24, xy[1] + 165, xy[2] - 24, xy[3] - 28), desc, pil_font(23), TEXT, spacing=12)
+    path = ASSETS / "roles.png"
+    img.save(path)
+    paths["roles"] = path
+
+    img, draw = base_canvas("模型配置与验证闭环", "修改模型后必须同时验证配置解析、接口连通和实际对话")
+    steps = [
+        ((80, 340, 360, 610), "1", "确定模型参数\nmodel / base_url\n上下文与输出限制"),
+        ((430, 340, 710, 610), "2", "backend.env\n写入 API Key\n只写变量值"),
+        ((780, 340, 1060, 610), "3", "config.yaml\n新增 models 条目\n添加 max_tokens"),
+        ((1130, 340, 1410, 610), "4", "重建/重启 Backend\n查看启动日志\n请求 /health"),
+        ((1480, 340, 1720, 610), "5", "UI 选模型\n最短问答验证\n再做长文本测试"),
+    ]
+    for i, (xy, num, label) in enumerate(steps):
+        rounded_box(draw, xy, ["E8F2FA", "EAF5EE", "FFF5D9", "F1ECF8", "E8F2FA"][i])
+        draw.ellipse((xy[0] + 18, xy[1] + 18, xy[0] + 78, xy[1] + 78), fill=BLUE)
+        center_text(draw, (xy[0] + 18, xy[1] + 18, xy[0] + 78, xy[1] + 78), num, pil_font(29, True), WHITE)
+        center_text(draw, (xy[0] + 20, xy[1] + 90, xy[2] - 20, xy[3] - 20), label, pil_font(25, True))
+        if i < len(steps) - 1:
+            arrow(draw, (xy[2], 475), (steps[i + 1][0][0], 475))
+    draw.text((155, 725), "max_tokens 是单次生成输出上限，不是模型上下文窗口；必须小于或等于模型服务允许值。", font=pil_font(30, True), fill="A34B00")
+    path = ASSETS / "model_flow.png"
+    img.save(path)
+    paths["model_flow"] = path
+
+    img, draw = base_canvas("技能与智能体的数据归属", "文件、数据库元数据、账号权限缺一不可；备份必须覆盖两边")
+    blocks = [
+        ((100, 270, 690, 500), "技能文件", "data/skills/public/<技能>/SKILL.md\ndata/skills/custom/<技能>/SKILL.md\n可附带 .py、references、assets", "E8F2FA"),
+        ((100, 590, 690, 820), "智能体文件", "data/backend/agents/<agent-id>/config.yaml\ndata/backend/agents/<agent-id>/SOUL.md", "EAF5EE"),
+        ((940, 270, 1690, 500), "业务数据库", "技能/智能体所有者、名称、可见性、广场、发布状态\nSQLite 或外部 MySQL", "FFF5D9"),
+        ((940, 590, 1690, 820), "运行时与缓存", "启动扫描、技能系统提示缓存、容器权限、当前登录用户\n异常时可通过重启和日志核对", "F1ECF8"),
+    ]
+    for xy, title, desc, fill in blocks:
+        rounded_box(draw, xy, fill)
+        draw.text((xy[0] + 32, xy[1] + 28), title, font=pil_font(31, True), fill=DARK_BLUE)
+        draw.multiline_text((xy[0] + 32, xy[1] + 85), desc, font=pil_font(24), fill=TEXT, spacing=10)
+    arrow(draw, (690, 385), (940, 385))
+    arrow(draw, (690, 705), (940, 705))
+    draw.text((720, 510), "共同决定 UI 中能否看到、能否使用、能否发布", font=pil_font(25, True), fill=BLUE)
+    path = ASSETS / "persistence_map.png"
+    img.save(path)
+    paths["persistence_map"] = path
+
+    img, draw = base_canvas("从创建到发布广场", "UI 发布会同步维护文件与数据库元数据，优先于手工拷贝")
+    steps = [
+        ((90, 320, 380, 620), "创建 / 导入", "普通用户创建 custom 技能\n或创建自己的智能体"),
+        ((460, 320, 750, 620), "本地验证", "补齐说明与依赖\n完成一次真实调用\n检查无敏感信息"),
+        ((830, 320, 1120, 620), "点击发布", "资产详情或卡片 → 发布\n选择目标广场"),
+        ((1200, 320, 1490, 620), "权限校验", "所有者或 admin\n每个资产只能属于一个广场"),
+        ((1550, 320, 1730, 620), "生效", "广场可见\n可下架\n可改投其他广场"),
+    ]
+    for i, (xy, title, desc) in enumerate(steps):
+        rounded_box(draw, xy, ["E8F2FA", "EAF5EE", "FFF5D9", "F1ECF8", "E8F2FA"][i])
+        center_text(draw, (xy[0] + 15, xy[1] + 25, xy[2] - 15, xy[1] + 110), title, pil_font(27, True), DARK_BLUE)
+        draw.multiline_text((xy[0] + 22, xy[1] + 135), desc, font=pil_font(22), fill=TEXT, spacing=8, align="center")
+        if i < len(steps) - 1:
+            arrow(draw, (xy[2], 470), (steps[i + 1][0][0], 470))
+    draw.rounded_rectangle((240, 735, 1560, 860), radius=20, fill=PALE_RED, outline="C5645A", width=3)
+    center_text(draw, (240, 735, 1560, 860), "不要把“复制到 public 目录”和“发布到广场”混为一谈：前者是文件类别，后者是业务可见性与发布元数据。", pil_font(27, True), "8E3028")
+    path = ASSETS / "publish_flow.png"
+    img.save(path)
+    paths["publish_flow"] = path
+
+    img, draw = base_canvas("管理入口地图", "所有入口均以当前前端版本为准；看不到入口时先检查账号身份")
+    items = [
+        ((120, 250, 760, 410), "设置和更多", "菜单管理 · 敏感词管理 · 按钮管理"),
+        ((1040, 250, 1680, 410), "外观设置", "个人主题 · 系统默认主题 · 自定义主题库 · 发布广场"),
+        ((120, 500, 760, 660), "技能管理 / 技能设置", "上传、编辑、地址扫描、发布/下架、权限"),
+        ((1040, 500, 1680, 660), "智能体管理 / 智能体详情", "创建、编辑配置、发布/下架、私有广场"),
+        ((490, 750, 1310, 900), "用户与白名单管理", "账号启停 · system_role · 登录密码 · 管理员审批"),
+    ]
+    for i, (xy, title, desc) in enumerate(items):
+        rounded_box(draw, xy, ["E8F2FA", "EAF5EE", "FFF5D9", "F1ECF8", "FCE8E6"][i])
+        draw.text((xy[0] + 30, xy[1] + 24), title, font=pil_font(30, True), fill=DARK_BLUE)
+        draw.text((xy[0] + 30, xy[1] + 84), desc, font=pil_font(23), fill=TEXT)
+    arrow(draw, (760, 330), (1040, 330))
+    arrow(draw, (760, 580), (1040, 580))
+    path = ASSETS / "ui_map.png"
+    img.save(path)
+    paths["ui_map"] = path
+
+    img, draw = base_canvas("技能或智能体“丢失”的排查顺序", "先确定是显示问题、身份问题、数据库问题，还是文件/挂载真的丢失")
+    nodes = [
+        ((80, 290, 380, 470), "1. 服务与项目", "确认容器、Compose 目录、端口"),
+        ((500, 290, 800, 470), "2. 登录身份", "账号是否变化、角色/所有者是否匹配"),
+        ((920, 290, 1220, 470), "3. 文件挂载", "宿主机 data 目录与容器内目录"),
+        ((1340, 290, 1720, 470), "4. 数据库", "SQLite/MySQL 是否切换、记录是否存在"),
+        ((1340, 650, 1720, 830), "5. 发布与过滤", "广场、私有状态、搜索筛选、权限"),
+        ((920, 650, 1220, 830), "6. 日志与权限", "permission、invalid config、扫描失败"),
+        ((500, 650, 800, 830), "7. 备份恢复", "先停止写入，再按文件+数据库恢复"),
+        ((80, 650, 380, 830), "8. 验证", "重启后端、重新登录、实际调用"),
+    ]
+    for i, (xy, title, desc) in enumerate(nodes):
+        rounded_box(draw, xy, ["E8F2FA", "EAF5EE", "FFF5D9", "F1ECF8"][i % 4])
+        center_text(draw, (xy[0] + 12, xy[1] + 12, xy[2] - 12, xy[1] + 75), title, pil_font(25, True), DARK_BLUE)
+        center_text(draw, (xy[0] + 20, xy[1] + 78, xy[2] - 20, xy[3] - 15), desc, pil_font(21), TEXT)
+    for i in range(3):
+        arrow(draw, (nodes[i][0][2], 380), (nodes[i + 1][0][0], 380))
+    arrow(draw, (1530, 470), (1530, 650))
+    for i in range(4, 7):
+        arrow(draw, (nodes[i][0][0], 740), (nodes[i + 1][0][2], 740))
+    path = ASSETS / "lost_asset_flow.png"
+    img.save(path)
+    paths["lost_asset_flow"] = path
+
+    img, draw = base_canvas("备份、升级与回滚闭环", "离线环境的核心原则：先验证备份可恢复，再导入新镜像")
+    steps = [
+        ((100, 310, 400, 620), "盘点", "记录版本、镜像摘要\n端口、数据库模式\n外部依赖地址"),
+        ((470, 310, 770, 620), "一致性备份", "停止写入窗口\n备份 data + config\n导出外部 MySQL"),
+        ((840, 310, 1140, 620), "新目录演练", "导入 ARM64 镜像\n复制配置并合并\n换测试端口启动"),
+        ((1210, 310, 1510, 620), "验收", "健康检查、登录\n模型、技能、智能体\n广场与关键业务"),
+        ((1580, 310, 1730, 620), "切换", "停旧启新\n保留旧镜像\n异常即回滚"),
+    ]
+    for i, (xy, title, desc) in enumerate(steps):
+        rounded_box(draw, xy, ["E8F2FA", "EAF5EE", "FFF5D9", "F1ECF8", "E8F2FA"][i])
+        center_text(draw, (xy[0] + 12, xy[1] + 20, xy[2] - 12, xy[1] + 105), title, pil_font(28, True), DARK_BLUE)
+        center_text(draw, (xy[0] + 20, xy[1] + 110, xy[2] - 20, xy[3] - 20), desc, pil_font(23), TEXT)
+        if i < len(steps) - 1:
+            arrow(draw, (xy[2], 465), (steps[i + 1][0][0], 465))
+    draw.text((210, 760), "切忌：在没有确认数据路径和备份的情况下执行 docker system prune -a 或删除部署目录。", font=pil_font(31, True), fill="9A342D")
+    path = ASSETS / "backup_upgrade.png"
+    img.save(path)
+    paths["backup_upgrade"] = path
+
+    return paths
+
+
+def set_cell_shading(cell, fill: str):
+    tc_pr = cell._tc.get_or_add_tcPr()
+    shd = tc_pr.find(qn("w:shd"))
+    if shd is None:
+        shd = OxmlElement("w:shd")
+        tc_pr.append(shd)
+    shd.set(qn("w:fill"), fill)
+
+
+def set_cell_margins(cell, top=80, start=120, bottom=80, end=120):
+    tc = cell._tc
+    tc_pr = tc.get_or_add_tcPr()
+    tc_mar = tc_pr.first_child_found_in("w:tcMar")
+    if tc_mar is None:
+        tc_mar = OxmlElement("w:tcMar")
+        tc_pr.append(tc_mar)
+    for m, v in (("top", top), ("start", start), ("bottom", bottom), ("end", end)):
+        node = tc_mar.find(qn(f"w:{m}"))
+        if node is None:
+            node = OxmlElement(f"w:{m}")
+            tc_mar.append(node)
+        node.set(qn("w:w"), str(v))
+        node.set(qn("w:type"), "dxa")
+
+
+def set_repeat_table_header(row):
+    tr_pr = row._tr.get_or_add_trPr()
+    tbl_header = OxmlElement("w:tblHeader")
+    tbl_header.set(qn("w:val"), "true")
+    tr_pr.append(tbl_header)
+
+
+def prevent_row_split(row):
+    tr_pr = row._tr.get_or_add_trPr()
+    cant_split = OxmlElement("w:cantSplit")
+    tr_pr.append(cant_split)
+
+
+def set_table_fixed(table, widths: list[int]):
+    table.autofit = False
+    tbl_pr = table._tbl.tblPr
+    layout = tbl_pr.find(qn("w:tblLayout"))
+    if layout is None:
+        layout = OxmlElement("w:tblLayout")
+        tbl_pr.append(layout)
+    layout.set(qn("w:type"), "fixed")
+    tbl_w = tbl_pr.find(qn("w:tblW"))
+    if tbl_w is None:
+        tbl_w = OxmlElement("w:tblW")
+        tbl_pr.append(tbl_w)
+    tbl_w.set(qn("w:w"), str(sum(widths)))
+    tbl_w.set(qn("w:type"), "dxa")
+    tbl_ind = tbl_pr.find(qn("w:tblInd"))
+    if tbl_ind is None:
+        tbl_ind = OxmlElement("w:tblInd")
+        tbl_pr.append(tbl_ind)
+    tbl_ind.set(qn("w:w"), "120")
+    tbl_ind.set(qn("w:type"), "dxa")
+    grid = table._tbl.tblGrid
+    for child in list(grid):
+        grid.remove(child)
+    for width in widths:
+        col = OxmlElement("w:gridCol")
+        col.set(qn("w:w"), str(width))
+        grid.append(col)
+    for row in table.rows:
+        for cell, width in zip(row.cells, widths):
+            tc_pr = cell._tc.get_or_add_tcPr()
+            tc_w = tc_pr.find(qn("w:tcW"))
+            if tc_w is None:
+                tc_w = OxmlElement("w:tcW")
+                tc_pr.append(tc_w)
+            tc_w.set(qn("w:w"), str(width))
+            tc_w.set(qn("w:type"), "dxa")
+            set_cell_margins(cell)
+
+
+def set_run_font(run, name="Microsoft YaHei", size=None, bold=None, color=None):
+    run.font.name = name
+    run._element.rPr.rFonts.set(qn("w:eastAsia"), name)
+    if size is not None:
+        run.font.size = Pt(size)
+    if bold is not None:
+        run.bold = bold
+    if color:
+        run.font.color.rgb = RGBColor.from_string(color)
+
+
+def style_paragraph(p, before=0, after=6, line=1.25, keep=False):
+    fmt = p.paragraph_format
+    fmt.space_before = Pt(before)
+    fmt.space_after = Pt(after)
+    fmt.line_spacing = line
+    if keep:
+        fmt.keep_together = True
+
+
+def add_field(paragraph, instr: str, display: str = ""):
+    run = paragraph.add_run()
+    fld_char1 = OxmlElement("w:fldChar")
+    fld_char1.set(qn("w:fldCharType"), "begin")
+    instr_text = OxmlElement("w:instrText")
+    instr_text.set(qn("xml:space"), "preserve")
+    instr_text.text = instr
+    fld_char2 = OxmlElement("w:fldChar")
+    fld_char2.set(qn("w:fldCharType"), "separate")
+    text_node = OxmlElement("w:t")
+    text_node.text = display
+    fld_char3 = OxmlElement("w:fldChar")
+    fld_char3.set(qn("w:fldCharType"), "end")
+    run._r.extend([fld_char1, instr_text, fld_char2, text_node, fld_char3])
+
+
+def configure_document(doc: Document):
+    section = doc.sections[0]
+    section.page_width = Inches(8.5)
+    section.page_height = Inches(11)
+    section.top_margin = Inches(1)
+    section.bottom_margin = Inches(1)
+    section.left_margin = Inches(1)
+    section.right_margin = Inches(1)
+    section.header_distance = Inches(0.492)
+    section.footer_distance = Inches(0.492)
+    section.different_first_page_header_footer = True
+
+    styles = doc.styles
+    normal = styles["Normal"]
+    normal.font.name = "Calibri"
+    normal.font.size = Pt(11)
+    normal._element.rPr.rFonts.set(qn("w:eastAsia"), "Microsoft YaHei")
+    normal.font.color.rgb = RGBColor.from_string(TEXT)
+    normal.paragraph_format.space_after = Pt(6)
+    normal.paragraph_format.line_spacing = 1.25
+
+    for style_name, size, color, before, after, level in (
+        ("Title", 28, DARK_BLUE, 0, 14, 0),
+        ("Subtitle", 15, GRAY, 0, 8, 0),
+        ("Heading 1", 16, BLUE, 18, 10, 1),
+        ("Heading 2", 13, BLUE, 14, 7, 2),
+        ("Heading 3", 12, DARK_BLUE, 10, 5, 3),
+    ):
+        st = styles[style_name]
+        st.font.name = "Calibri"
+        st._element.rPr.rFonts.set(qn("w:eastAsia"), "Microsoft YaHei")
+        st.font.size = Pt(size)
+        st.font.color.rgb = RGBColor.from_string(color)
+        st.font.bold = True
+        st.paragraph_format.space_before = Pt(before)
+        st.paragraph_format.space_after = Pt(after)
+        st.paragraph_format.keep_with_next = True
+        if level == 1:
+            st.paragraph_format.page_break_before = True
+
+    for style_name in ("List Bullet", "List Number"):
+        st = styles[style_name]
+        st.font.name = "Calibri"
+        st._element.rPr.rFonts.set(qn("w:eastAsia"), "Microsoft YaHei")
+        st.font.size = Pt(11)
+        st.paragraph_format.left_indent = Inches(0.375)
+        st.paragraph_format.first_line_indent = Inches(-0.188)
+        st.paragraph_format.space_after = Pt(4)
+        st.paragraph_format.line_spacing = 1.25
+
+    if "Code Block" not in styles:
+        code = styles.add_style("Code Block", WD_STYLE_TYPE.PARAGRAPH)
+    else:
+        code = styles["Code Block"]
+    code.font.name = "Consolas"
+    code._element.rPr.rFonts.set(qn("w:eastAsia"), "Microsoft YaHei")
+    code.font.size = Pt(8.8)
+    code.font.color.rgb = RGBColor.from_string("1F2933")
+    code.paragraph_format.left_indent = Inches(0.18)
+    code.paragraph_format.right_indent = Inches(0.12)
+    code.paragraph_format.space_before = Pt(3)
+    code.paragraph_format.space_after = Pt(6)
+    code.paragraph_format.line_spacing = 1.05
+    code.paragraph_format.keep_together = True
+
+    # Running header and page footer.
+    header = section.header
+    hp = header.paragraphs[0]
+    hp.alignment = WD_ALIGN_PARAGRAPH.RIGHT
+    hr = hp.add_run("DeerFlow 系统运维手册  |  内网离线部署版")
+    set_run_font(hr, size=8.5, color=GRAY)
+
+    footer = section.footer
+    fp = footer.paragraphs[0]
+    fp.alignment = WD_ALIGN_PARAGRAPH.CENTER
+    fr = fp.add_run("内部运维资料  ·  第 ")
+    set_run_font(fr, size=8.5, color=GRAY)
+    add_field(fp, "PAGE", "1")
+    fr2 = fp.add_run(" 页")
+    set_run_font(fr2, size=8.5, color=GRAY)
+
+    update = OxmlElement("w:updateFields")
+    update.set(qn("w:val"), "true")
+    doc.settings._element.append(update)
+
+
+def add_para(doc, text="", *, bold_prefix=None, italic=False, align=None, after=6, keep=False):
+    p = doc.add_paragraph()
+    if bold_prefix and text.startswith(bold_prefix):
+        r1 = p.add_run(bold_prefix)
+        set_run_font(r1, bold=True)
+        r2 = p.add_run(text[len(bold_prefix):])
+        set_run_font(r2)
+    else:
+        r = p.add_run(text)
+        set_run_font(r)
+        r.italic = italic
+    style_paragraph(p, after=after, keep=keep)
+    if align is not None:
+        p.alignment = align
+    return p
+
+
+def add_bullet(doc, text, level=0):
+    p = doc.add_paragraph(style="List Bullet")
+    if level:
+        p.paragraph_format.left_indent = Inches(0.375 + 0.25 * level)
+    r = p.add_run(text)
+    set_run_font(r)
+    return p
+
+
+def new_numbering_instance(doc) -> int:
+    """Create a real numbered-list instance that restarts at 1."""
+    numbering = doc.part.numbering_part.element
+    style = doc.styles["List Number"]
+    style_num_id = int(style._element.pPr.numPr.numId.val)
+    abstract_id = None
+    existing_ids = []
+    for num in numbering.findall(qn("w:num")):
+        num_id = int(num.get(qn("w:numId")))
+        existing_ids.append(num_id)
+        if num_id == style_num_id:
+            abstract_id = int(num.find(qn("w:abstractNumId")).get(qn("w:val")))
+    if abstract_id is None:
+        raise RuntimeError("Unable to resolve List Number abstract numbering")
+    new_id = max(existing_ids or [0]) + 1
+    num = OxmlElement("w:num")
+    num.set(qn("w:numId"), str(new_id))
+    abstract = OxmlElement("w:abstractNumId")
+    abstract.set(qn("w:val"), str(abstract_id))
+    num.append(abstract)
+    override = OxmlElement("w:lvlOverride")
+    override.set(qn("w:ilvl"), "0")
+    start = OxmlElement("w:startOverride")
+    start.set(qn("w:val"), "1")
+    override.append(start)
+    num.append(override)
+    numbering.append(num)
+    return new_id
+
+
+def add_number(doc, text, level=0):
+    if getattr(doc, "_restart_numbering", True) or not hasattr(doc, "_active_num_id"):
+        doc._active_num_id = new_numbering_instance(doc)
+        doc._restart_numbering = False
+    p = doc.add_paragraph(style="List Number")
+    p_pr = p._p.get_or_add_pPr()
+    num_pr = p_pr.find(qn("w:numPr"))
+    if num_pr is None:
+        num_pr = OxmlElement("w:numPr")
+        p_pr.append(num_pr)
+    ilvl = OxmlElement("w:ilvl")
+    ilvl.set(qn("w:val"), str(level))
+    num_id = OxmlElement("w:numId")
+    num_id.set(qn("w:val"), str(doc._active_num_id))
+    num_pr.extend([ilvl, num_id])
+    if level:
+        p.paragraph_format.left_indent = Inches(0.375 + 0.25 * level)
+    r = p.add_run(text)
+    set_run_font(r)
+    return p
+
+
+def add_code(doc, code_text: str, language: str = ""):
+    if language:
+        label = doc.add_paragraph()
+        label.paragraph_format.space_before = Pt(3)
+        label.paragraph_format.space_after = Pt(2)
+        label.paragraph_format.keep_with_next = True
+        rr = label.add_run(language)
+        set_run_font(rr, size=8, bold=True, color=GRAY)
+    lines = dedent(code_text).strip("\n").splitlines()
+    for idx, line in enumerate(lines):
+        p = doc.add_paragraph(style="Code Block")
+        p.paragraph_format.space_before = Pt(0)
+        p.paragraph_format.space_after = Pt(0 if idx < len(lines) - 1 else 6)
+        p.paragraph_format.keep_with_next = idx < len(lines) - 1
+        p_pr = p._p.get_or_add_pPr()
+        shd = OxmlElement("w:shd")
+        shd.set(qn("w:fill"), "F2F4F7")
+        p_pr.append(shd)
+        r = p.add_run(line if line else " ")
+        set_run_font(r, name="Consolas", size=8.8, color="1F2933")
+    return p
+
+
+def add_callout(doc, title: str, text: str, kind="note"):
+    colors = {
+        "note": (LIGHT_BLUE, BLUE),
+        "ok": (PALE_GREEN, "4B8C63"),
+        "warn": (PALE_YELLOW, "A06F00"),
+        "danger": (PALE_RED, "A33A32"),
+    }
+    fill, color = colors[kind]
+    p = doc.add_paragraph()
+    p.paragraph_format.left_indent = Inches(0.12)
+    p.paragraph_format.right_indent = Inches(0.05)
+    p.paragraph_format.space_before = Pt(4)
+    p.paragraph_format.space_after = Pt(8)
+    p.paragraph_format.keep_together = True
+    p_pr = p._p.get_or_add_pPr()
+    shd = OxmlElement("w:shd")
+    shd.set(qn("w:fill"), fill)
+    p_pr.append(shd)
+    border = OxmlElement("w:pBdr")
+    left = OxmlElement("w:left")
+    left.set(qn("w:val"), "single")
+    left.set(qn("w:sz"), "18")
+    left.set(qn("w:space"), "6")
+    left.set(qn("w:color"), color)
+    border.append(left)
+    p_pr.append(border)
+    r1 = p.add_run(f"{title}  ")
+    set_run_font(r1, bold=True, color=color)
+    r2 = p.add_run(text)
+    set_run_font(r2)
+    return p
+
+
+def add_table(doc, headers: list[str], rows: list[list[str]], widths: list[int], font_size=9.2):
+    assert sum(widths) == USABLE_DXA, (sum(widths), widths)
+    table = doc.add_table(rows=1, cols=len(headers))
+    table.style = "Table Grid"
+    table.alignment = WD_ALIGN_PARAGRAPH.CENTER
+    for i, h in enumerate(headers):
+        cell = table.rows[0].cells[i]
+        set_cell_shading(cell, "E8EEF5")
+        cell.vertical_alignment = WD_CELL_VERTICAL_ALIGNMENT.CENTER
+        p = cell.paragraphs[0]
+        p.alignment = WD_ALIGN_PARAGRAPH.LEFT
+        p.paragraph_format.space_after = Pt(0)
+        r = p.add_run(h)
+        set_run_font(r, size=font_size, bold=True, color=DARK_BLUE)
+    set_repeat_table_header(table.rows[0])
+    for row_idx, data in enumerate(rows):
+        row = table.add_row()
+        prevent_row_split(row)
+        for i, value in enumerate(data):
+            cell = row.cells[i]
+            cell.vertical_alignment = WD_CELL_VERTICAL_ALIGNMENT.CENTER
+            if row_idx % 2 == 1:
+                set_cell_shading(cell, "FAFBFC")
+            p = cell.paragraphs[0]
+            p.paragraph_format.space_after = Pt(0)
+            p.paragraph_format.line_spacing = 1.12
+            r = p.add_run(str(value))
+            set_run_font(r, size=font_size)
+    set_table_fixed(table, widths)
+    doc.add_paragraph().paragraph_format.space_after = Pt(1)
+    return table
+
+
+def add_figure(doc, path: Path, caption: str, alt_text: str, width=6.35):
+    p = doc.add_paragraph()
+    p.alignment = WD_ALIGN_PARAGRAPH.CENTER
+    p.paragraph_format.space_before = Pt(4)
+    p.paragraph_format.space_after = Pt(2)
+    run = p.add_run()
+    shape = run.add_picture(str(path), width=Inches(width))
+    try:
+        doc_pr = shape._inline.docPr
+        doc_pr.set("descr", alt_text)
+        doc_pr.set("title", caption)
+    except Exception:
+        pass
+    cp = doc.add_paragraph()
+    cp.alignment = WD_ALIGN_PARAGRAPH.CENTER
+    cp.paragraph_format.space_after = Pt(8)
+    cr = cp.add_run(caption)
+    set_run_font(cr, size=9, color=GRAY)
+    cr.italic = True
+
+
+def add_h1(doc, text):
+    doc._restart_numbering = True
+    return doc.add_heading(text, level=1)
+
+
+def add_h2(doc, text):
+    doc._restart_numbering = True
+    return doc.add_heading(text, level=2)
+
+
+def add_h3(doc, text):
+    doc._restart_numbering = True
+    return doc.add_heading(text, level=3)
+
+
+def add_page_break(doc):
+    doc.add_page_break()
+
+
+def build_document(diagrams: dict[str, Path]):
+    doc = Document()
+    configure_document(doc)
+    doc.core_properties.title = "DeerFlow 系统运维手册（内网离线部署版）"
+    doc.core_properties.subject = "DeerFlow 前后端、模型、账号、技能、智能体、广场、菜单、主题、敏感词及故障排查"
+    doc.core_properties.author = "DeerFlow 运维团队"
+    doc.core_properties.keywords = "DeerFlow, 运维, Docker, 1Panel, ARM64, 离线部署"
+
+    # Cover
+    p = doc.add_paragraph()
+    p.paragraph_format.space_before = Inches(0.75)
+    p.paragraph_format.space_after = Pt(10)
+    p.alignment = WD_ALIGN_PARAGRAPH.LEFT
+    r = p.add_run("DeerFlow")
+    set_run_font(r, size=16, bold=True, color=BLUE)
+    p = doc.add_paragraph(style="Title")
+    p.paragraph_format.space_before = Pt(16)
+    p.paragraph_format.space_after = Pt(14)
+    p.alignment = WD_ALIGN_PARAGRAPH.LEFT
+    r = p.add_run("系统运维手册")
+    set_run_font(r, size=30, bold=True, color=DARK_BLUE)
+    p = doc.add_paragraph(style="Subtitle")
+    r = p.add_run("内网离线部署版 · Docker / 1Panel / ARM64")
+    set_run_font(r, size=15, color=GRAY)
+    add_figure(doc, diagrams["architecture"], "系统生产访问链路总览", "浏览器通过 Nginx 访问 DeerFlow 前端和后端的架构示意图", width=6.1)
+    add_callout(doc, "适用对象", "首次接手本系统的 Linux/1Panel 运维人员、DeerFlow 应用管理员、模型与数据管理员。", "note")
+    meta = add_table(
+        doc,
+        ["文档版本", "适用版本", "更新日期"],
+        [["V1.0", "当前离线部署包与本项目定制版", "2026-08-08"]],
+        [2200, 4200, 2960],
+        font_size=9.2,
+    )
+    add_para(doc, "密级：内部运维资料。本文所有密钥、密码、IP 和数据库账号均使用占位符。", italic=True, align=WD_ALIGN_PARAGRAPH.CENTER, after=0)
+
+    p = doc.add_paragraph(style="Title")
+    p.paragraph_format.page_break_before = True
+    r = p.add_run("文档导航")
+    set_run_font(r, size=24, bold=True, color=DARK_BLUE)
+    add_para(doc, "本文按“先理解、再配置、后维护、能恢复”的顺序编排。Word 左侧导航窗格可按标题跳转；如目录页码未自动刷新，请在 Word 中按 Ctrl+A 后按 F9。")
+    toc = doc.add_paragraph()
+    toc.paragraph_format.space_after = Pt(10)
+    add_field(toc, r'TOC \o "1-3" \h \z \u', "目录将在打开 Word 时自动更新")
+    add_callout(doc, "先看这四章", "首次接手请先读第 1、2、3、4 章；发生资产丢失或生产故障时直接跳到第 16、17 章。", "ok")
+    add_h2(doc, "版本与变更记录")
+    add_table(
+        doc,
+        ["版本", "日期", "变更说明", "维护人"],
+        [["V1.0", "2026-08-08", "首次发布，覆盖离线部署、配置、资产发布、备份恢复与排错", "DeerFlow 运维团队"]],
+        [1000, 1500, 5260, 1600],
+    )
+    add_h2(doc, "阅读约定")
+    add_bullet(doc, "“部署目录”指解压离线包后，包含 docker-compose.yml、config、data、restart.sh 等内容的目录。")
+    add_bullet(doc, "命令默认以 Linux shell 执行；1Panel 的容器终端或 Xshell 均可。")
+    add_bullet(doc, "涉及生产数据的命令，先确认当前路径，再做备份；不要机械复制带删除含义的命令。")
+    add_bullet(doc, "本文以 APP_PORT=8090 为例，实际端口以部署目录 .env 为准。")
+
+    add_h1(doc, "1. 系统全貌与运维边界")
+    add_para(doc, "DeerFlow 是由 React 前端、Nginx、FastAPI/LangGraph 后端、持久化文件目录和业务数据库共同组成的 AI 智能体平台。前端和后端在容器内使用不同端口，但生产访问通常只暴露一个 Web 端口：浏览器访问 Nginx，Nginx 再把 /deerflow 请求转发到后端。")
+    add_figure(doc, diagrams["architecture"], "图 1-1 生产访问与数据流", "DeerFlow Web、后端、持久化目录和外部依赖之间的数据流")
+    add_h2(doc, "1.1 服务与端口")
+    add_table(
+        doc,
+        ["组件", "容器内端口", "宿主机端口", "主要职责", "运维结论"],
+        [
+            ["Web / Nginx", "80", "APP_PORT（默认 8090）", "前端静态文件、SPA 路由、反向代理", "公网或内网只需开放这一端口"],
+            ["Backend", "8001", "默认不直接映射", "登录、智能体、技能、模型调用、业务 API", "通过 /deerflow 由 Nginx 访问"],
+            ["MySQL（可选）", "由数据库决定", "通常仅内网", "业务表、资产元数据、用户与全局配置", "容器要能访问数据库地址"],
+        ],
+        [1300, 1200, 1650, 3100, 2110],
+        font_size=8.7,
+    )
+    add_callout(doc, "关键结论", "前端与后端不是同一个容器端口。对用户而言可以是同一个访问端口，因为 Nginx 做了同源代理。", "note")
+    add_h2(doc, "1.2 需要纳入监控和备份的对象")
+    for item in [
+        "部署配置：.env、config/backend.env、config/config.yaml、config/extensions_config.json、config/runtime-config.js。",
+        "持久化文件：data/backend、data/skills、data/knowledge、data/logs。",
+        "数据库：默认 SQLite 文件；切换外部 MySQL 后还要做 MySQL 备份。",
+        "离线镜像与版本：保留镜像 tar 包、SHA256、部署日期和变更记录。",
+        "外部依赖：模型 API、MySQL、Hindsight、MCP、企业业务接口的地址和账号。",
+    ]:
+        add_bullet(doc, item)
+    add_h2(doc, "1.3 本手册不替代的制度")
+    add_para(doc, "生产变更审批、账号实名、密码轮换、数据库备份保留期和等保要求仍以本单位制度为准。本文提供技术步骤，不构成放宽安全控制的依据。")
+
+    add_h1(doc, "2. 账号、角色与登录密钥")
+    add_para(doc, "运维中最容易混淆的是“服务器 root”和“DeerFlow admin”。前者能管理容器和文件，后者才能在应用页面中配置菜单、主题、用户和发布广场。敏感词页面又有独立的 lqq 账号入口条件。")
+    add_figure(doc, diagrams["roles"], "图 2-1 四类身份与职责", "Linux 管理员、DeerFlow 管理员、lqq 账号、普通业务用户的权限边界")
+    heading = add_h2(doc, "2.1 建议准备的账号")
+    heading.paragraph_format.page_break_before = True
+    add_table(
+        doc,
+        ["账号类型", "至少数量", "用途", "注意事项"],
+        [
+            ["Linux / 1Panel 管理员", "2", "部署、日志、备份、恢复", "不共用个人账号；禁止把 root 密码写进文档"],
+            ["DeerFlow admin", "2", "全局设置、白名单、菜单、主题、广场", "system_role 必须是 admin；保留一名应急管理员"],
+            ["lqq", "1", "前端敏感词管理", "显示用户名或邮箱 @ 前缀必须严格为 lqq"],
+            ["普通测试用户", "1", "验证普通权限、资产发布和页面可见性", "不能只用管理员做验收"],
+            ["模型/数据库服务账号", "按环境", "调用外部服务", "最小权限、单独轮换、不得与人员账号共用"],
+        ],
+        [1550, 900, 2850, 4060],
+        font_size=8.8,
+    )
+    add_h2(doc, "2.2 AUTH_JWT_SECRET 的作用")
+    add_para(doc, "AUTH_JWT_SECRET 是后端签发和校验登录令牌的服务端密钥，不是用户登录密码。它必须在多进程、多容器和每次重启之间保持一致。若更换该值，所有现有登录会话会失效，需要重新登录。")
+    add_code(doc, """
+    # config/backend.env
+    AUTH_JWT_SECRET=<至少32字节的高强度随机值>
+    """, "ENV")
+    add_para(doc, "在可联网或可信管理机生成随机值，再通过受控介质导入内网。Linux 可使用：")
+    add_code(doc, "openssl rand -hex 32", "Shell")
+    add_callout(doc, "禁止事项", "不要把密钥提交到 Git，不要写入 runtime-config.js，不要保留在 config.yaml 的注释中。浏览器可下载的前端配置中永远不能放服务端密钥。", "danger")
+    add_h2(doc, "2.3 用户名登录密码与 JWT 密钥的区别")
+    add_table(
+        doc,
+        ["项目", "保存位置", "谁使用", "变更影响"],
+        [
+            ["AUTH_JWT_SECRET", "config/backend.env", "后端服务", "全部登录会话失效"],
+            ["用户名登录共享密码", "config/config.yaml 的 auth_login.username_login", "登录入口校验", "影响使用该入口的新登录"],
+            ["账号 login_password", "应用用户/白名单管理", "指定账号", "只影响该账号"],
+            ["VITE_ROUTE_LOGIN_PASSWORD", "runtime-config.js 或构建环境", "前端特定路由辅助", "不是后端安全边界"],
+        ],
+        [1700, 2600, 2100, 2960],
+    )
+    add_h2(doc, "2.4 管理员与 lqq 的判定")
+    add_bullet(doc, "应用管理员由 system_role=admin 判定；内置 admin 用户通常会被提升为管理员，但仍应在用户管理页核验。")
+    add_bullet(doc, "敏感词写接口允许管理员或 lqq，但当前前端敏感词页面的入口和路由会检查显示用户名是否为 lqq。因此正常页面维护建议直接使用 lqq 登录。")
+    add_bullet(doc, "邮箱账号以 @ 前缀作为显示用户名时，应确保前缀为 lqq；不要使用类似 lqq01 代替。")
+
+    add_h1(doc, "3. 部署目录、配置分层与变更生效")
+    add_para(doc, "同一项配置可能存在源码默认值、镜像内默认值和运行时覆盖值。生产运维只改部署目录中的运行时文件，并记录变更；不要进入容器直接改文件，因为重建容器后会丢失。")
+    add_figure(doc, diagrams["config_layers"], "图 3-1 配置分层和生效方式", "部署层、后端层、前端运行时层和管理页面配置的关系")
+    add_h2(doc, "3.1 标准部署目录")
+    add_code(doc, """
+    deerflow-deploy/
+    ├── docker-compose.yml
+    ├── .env
+    ├── config/
+    │   ├── backend.env
+    │   ├── config.yaml
+    │   ├── extensions_config.json
+    │   └── runtime-config.js
+    ├── data/
+    │   ├── backend/
+    │   ├── skills/
+    │   ├── knowledge/
+    │   └── logs/
+    ├── install.sh
+    ├── restart.sh
+    ├── stop.sh
+    ├── logs.sh
+    └── diagnose.sh
+    """, "目录结构")
+    add_h2(doc, "3.2 变更生效速查")
+    add_table(
+        doc,
+        ["修改对象", "典型内容", "最小生效动作", "验证"],
+        [
+            [".env", "APP_PORT、镜像标签", "重建受影响容器", "端口监听、浏览器访问"],
+            ["backend.env", "JWT、模型 Key、MySQL URL", "强制重建 Backend", "后端日志、/health、实际功能"],
+            ["config.yaml", "模型、数据库模式、登录配置", "重启 Backend", "启动日志、模型列表、登录"],
+            ["runtime-config.js", "前端 API/业务接口、Logo", "建议重启 Web；浏览器 Ctrl+F5", "浏览器 Network 与页面"],
+            ["管理页面", "菜单、主题、敏感词、广场", "保存后通常即时生效；必要时刷新", "管理员和普通用户分别验证"],
+        ],
+        [1700, 2500, 2500, 2660],
+    )
+    add_h2(doc, "3.3 修改前的通用流程")
+    for step in [
+        "确认当前部署目录和 Compose 项目，不要在旧目录操作。",
+        "复制要修改的配置文件并加时间戳备份。",
+        "记录修改人、工单、原值、目标值和回退方法。",
+        "只重启受影响的服务；变更后执行健康检查和实际业务验证。",
+        "观察日志至少 5 分钟，再结束变更窗口。",
+    ]:
+        add_number(doc, step)
+
+    add_h1(doc, "4. Docker / 1Panel 日常启停与日志")
+    add_h2(doc, "4.1 一键安装、重启、停止")
+    add_para(doc, "进入部署目录后执行以下脚本。生产环境建议保留 sudo，避免数据目录因不同用户写入而出现权限不一致。")
+    add_code(doc, """
+    cd /opt/deerflow/deerflow-deploy
+
+    # 首次安装 / 加载镜像并启动
+    sudo bash install.sh
+
+    # 一键重启全部服务
+    sudo bash restart.sh
+
+    # 一键停止全部服务
+    sudo bash stop.sh
+    """, "Shell")
+    add_h2(doc, "4.2 只重启后端或前端")
+    add_code(doc, """
+    # 日常重启后端，或仅 config.yaml / 挂载文件变更
+    sudo docker compose restart backend
+
+    # backend.env 发生变化时，必须重建容器以重新加载环境变量
+    sudo docker compose up -d --force-recreate backend
+
+    # 只重启 Web（前端运行时配置或 Nginx 变更）
+    sudo docker compose restart web
+
+    # 查看容器状态
+    sudo docker compose ps
+    """, "Shell")
+    add_callout(doc, "环境变量不会被普通 restart 重新读取", "restart.sh 和 docker compose restart 适合日常重启；修改 backend.env、APP_PORT 或其他 Compose 环境变量后，应使用 docker compose up -d --force-recreate <服务>。", "warn")
+    add_callout(doc, "1Panel 操作", "在 1Panel 的容器/编排页面执行“重启”也可以，但要确认选中的是当前部署目录对应的 Compose 项目。脚本方式更便于保留统一操作记录。", "note")
+    add_h2(doc, "4.3 打印实时日志")
+    add_code(doc, """
+    # 全部服务实时日志（Ctrl+C 退出，不会停止服务）
+    sudo bash logs.sh
+
+    # 只看后端
+    sudo bash logs.sh backend
+
+    # 只看前端 / Nginx
+    sudo bash logs.sh web
+
+    # Compose 原生命令：最近 500 行并持续跟踪
+    sudo docker compose logs --tail=500 -f backend
+    sudo docker compose logs --tail=500 -f web
+    """, "Shell")
+    add_h2(doc, "4.4 一键诊断")
+    add_code(doc, "sudo env TAIL=1000 bash diagnose.sh", "Shell")
+    add_para(doc, "诊断结果应至少包含架构、磁盘、内存、容器状态、端口监听、健康检查和最近错误日志。发送给研发前先检查输出中是否包含账号、Token、数据库 URL 或 API Key。")
+    add_h2(doc, "4.5 健康检查")
+    add_code(doc, """
+    # 从服务器本机检查，端口以 .env 的 APP_PORT 为准
+    curl -fsS http://127.0.0.1:8090/deerflow/health
+
+    # 检查前端首页响应头
+    curl -I http://127.0.0.1:8090/
+    """, "Shell")
+    add_callout(doc, "不要只看容器 Up", "容器处于 Up 只代表进程存在，不代表模型、数据库和业务功能可用。每次重启后至少完成健康接口、登录和一次对话验证。", "warn")
+
+    add_h1(doc, "5. 后端模型配置与 max_tokens")
+    add_para(doc, "模型列表由后端 config/config.yaml 管理，密钥放在 config/backend.env。推荐使用 OpenAI 兼容接口时配置 ChatOpenAI 适配器，并逐项核对模型 ID、base_url、超时、重试、输出上限和能力标志。")
+    add_figure(doc, diagrams["model_flow"], "图 5-1 模型配置与验证流程", "模型参数、密钥、后端配置、重启和界面验证的闭环")
+    add_h2(doc, "5.1 新增一个 OpenAI 兼容模型")
+    add_para(doc, "先在 backend.env 中保存密钥。变量名可自定义，但必须与 config.yaml 中 $ 后的名称完全一致。")
+    add_code(doc, """
+    # config/backend.env
+    INTRANET_MODEL_API_KEY=<模型服务分配的密钥>
+    """, "ENV")
+    add_para(doc, "再在 config/config.yaml 的 models 列表中新增条目：")
+    add_code(doc, """
+    models:
+      - name: intranet-model
+        display_name: 内网模型
+        use: langchain_openai:ChatOpenAI
+        model: model-id-from-provider
+        api_key: $INTRANET_MODEL_API_KEY
+        base_url: http://10.0.0.20:8000/v1
+        request_timeout: 600.0
+        max_retries: 2
+        max_tokens: 8192
+        temperature: 0.7
+        supports_vision: false
+        supports_thinking: false
+    """, "YAML")
+    add_h2(doc, "5.2 字段说明")
+    add_table(
+        doc,
+        ["字段", "必需", "说明", "常见错误"],
+        [
+            ["name", "是", "系统内部唯一名称，智能体配置引用它", "重名或改名后旧智能体引用失效"],
+            ["display_name", "建议", "前端显示名称", "写成真实密钥或内部地址"],
+            ["use", "是", "模型适配器，例如 langchain_openai:ChatOpenAI", "适配器与接口协议不匹配"],
+            ["model", "是", "模型服务要求的精确 model id", "使用市场名称而非接口 ID，导致 404"],
+            ["api_key", "通常", "使用 $ENV_NAME 从 backend.env 解析", "写成明文、变量名拼错"],
+            ["base_url", "通常", "OpenAI 兼容接口通常以 /v1 结尾", "容器中 127.0.0.1 指向自身"],
+            ["request_timeout", "建议", "单次请求秒数", "长推理模型超时过短"],
+            ["max_retries", "建议", "网络或限流重试次数", "重试过多造成雪崩"],
+            ["max_tokens", "建议", "单次生成的最大输出 token", "超过提供方限制或误认为上下文窗口"],
+            ["supports_vision", "按能力", "是否允许图像输入", "服务不支持却标 true"],
+            ["supports_thinking", "按能力", "是否支持思考模式", "适配器/服务参数不兼容"],
+        ],
+        [1300, 850, 3900, 3310],
+        font_size=8.4,
+    )
+    add_h2(doc, "5.3 如何添加或调整 max_tokens")
+    add_para(doc, "在目标模型条目中增加 max_tokens: <整数>。它控制模型本次生成的最大输出长度，不等于“输入 + 输出”的总上下文窗口。提供方若只允许 8192 输出，就不能配置 65536。")
+    add_table(
+        doc,
+        ["现象", "可能原因", "处理"],
+        [
+            ["回答被截断", "max_tokens 太小、模型自行结束或上游网关限制", "逐步增大并检查 finish_reason"],
+            ["400 invalid max_tokens", "超过模型上限或字段名不兼容", "查模型服务文档/网关日志，改为允许值"],
+            ["长文本仍失败", "上下文窗口不足，不是输出上限问题", "缩短输入、启用摘要、换长上下文模型"],
+            ["成本或耗时突然上升", "上限过大且提示词未约束", "降低 max_tokens，并在提示词限定结构和篇幅"],
+        ],
+        [1900, 3500, 3960],
+    )
+    add_h2(doc, "5.4 模型变更后的验证")
+    for step in [
+        "备份 config.yaml 和 backend.env；检查 YAML 缩进，不使用 Tab。",
+        "若 backend.env 有变化，执行 sudo docker compose up -d --force-recreate backend；只改 config.yaml 时可 restart backend。",
+        "立即跟踪 backend 日志，确认没有 YAML 解析、环境变量缺失或模型初始化错误。",
+        "访问 /deerflow/health，登录页面确认新模型出现在可选列表。",
+        "完成短问答、长文本、工具调用；视觉模型再验证图片上传。",
+        "确认日志中没有 API Key；记录模型版本、base_url、限流和最大上下文。",
+    ]:
+        add_number(doc, step)
+    add_h2(doc, "5.5 模型故障快速定位")
+    add_table(
+        doc,
+        ["HTTP/日志", "含义", "优先检查"],
+        [
+            ["401 / invalid_api_key", "模型密钥无效", "backend.env、变量名、密钥状态、是否有前后空格"],
+            ["403", "密钥无该模型权限或 IP 白名单", "模型服务授权与来源 IP"],
+            ["404 model_not_found", "model ID 或 base_url 不对", "接口真实 ID、/v1 路径、网关路由"],
+            ["429", "限流或余额不足", "并发、速率配额、余额、重试策略"],
+            ["timeout", "模型慢或网络不通", "容器到服务连通性、request_timeout、代理"],
+            ["connection refused", "地址/端口错误或服务未启动", "不要在容器内使用错误的 127.0.0.1"],
+        ],
+        [1950, 2910, 4500],
+    )
+
+    add_h1(doc, "6. 数据库：SQLite 与外部 MySQL")
+    add_para(doc, "默认部署可使用 SQLite，便于离线单机运行；已有外部 MySQL 时，可将业务数据库切换到 MySQL。切换数据库不会自动迁移旧 SQLite 中的业务数据，必须先做迁移和验收计划。LangGraph checkpointer 可继续保留 SQLite，两者不是同一配置项。")
+    add_h2(doc, "6.1 默认 SQLite")
+    add_code(doc, """
+    database:
+      backend: sqlite
+      sqlite_dir: .deer-flow/data
+
+    checkpointer:
+      type: sqlite
+      connection_string: .deer-flow/data/deerflow.db
+    """, "YAML")
+    add_para(doc, "在容器挂载下，关键数据位于宿主机 data/backend 对应目录。备份时应在写入低峰或停止后端，避免复制过程中数据库仍在变化。")
+    add_h2(doc, "6.2 切换到外部 MySQL")
+    add_code(doc, """
+    # config/backend.env
+    MYSQL_DATABASE_URL=mysql+asyncmy://deerflow_user:<URL编码后的密码>@10.0.0.30:3306/deerflow?charset=utf8mb4
+    """, "ENV")
+    add_code(doc, """
+    # config/config.yaml
+    database:
+      backend: mysql
+      mysql_url: $MYSQL_DATABASE_URL
+
+    # 可按现网设计继续使用 SQLite checkpointer
+    checkpointer:
+      type: sqlite
+      connection_string: .deer-flow/data/deerflow.db
+    """, "YAML")
+    add_callout(doc, "容器网络", "MySQL 在宿主机或另一台服务器时，地址必须是容器可访问的 IP/域名。容器内的 127.0.0.1 指后端容器自身，不指宿主机。", "warn")
+    add_h2(doc, "6.3 MySQL 前置条件")
+    for item in [
+        "数据库已创建，字符集建议 utf8mb4；时区和排序规则按单位标准统一。",
+        "服务账号至少拥有本应用所需的建表、改表、查询、增删改权限；禁止使用 root 作为长期业务账号。",
+        "防火墙允许后端容器所在主机访问 3306；MySQL bind-address 和用户 host 范围正确。",
+        "密码中的 @、:、/、#、% 等字符进行 URL 编码，避免连接串解析错误。",
+        "首次启动预留数据库迁移时间；观察 Alembic/建表日志，不要在未评估的情况下跳过迁移。",
+    ]:
+        add_bullet(doc, item)
+    add_h2(doc, "6.4 切换与回退步骤")
+    for step in [
+        "冻结资产编辑和用户写入，完整备份 SQLite、data 目录与配置。",
+        "创建 MySQL 数据库和最小权限账号；从后端容器验证网络。",
+        "制定并执行数据迁移。只改 backend=mysql 不会把旧数据自动搬过去。",
+        "修改 backend.env 和 config.yaml，执行 docker compose up -d --force-recreate backend，持续看迁移日志。",
+        "用 admin、lqq、普通用户分别验收登录、技能、智能体、广场、菜单、敏感词和对话。",
+        "确认稳定前保留旧 SQLite 与旧配置；回退时停止写入，避免两边各自产生新数据。",
+    ]:
+        add_number(doc, step)
+    heading = add_h2(doc, "6.5 数据库常见报错")
+    heading.paragraph_format.page_break_before = True
+    add_table(
+        doc,
+        ["报错", "原因", "处理"],
+        [
+            ["Access denied", "账号/密码/host 授权错误", "核对 URL 编码、MySQL 用户 host、权限"],
+            ["Unknown database", "库未创建或名称错误", "创建库并核对大小写"],
+            ["Connection refused / timeout", "端口、防火墙、bind-address、路由", "从容器执行 TCP 连通测试"],
+            ["Too many connections", "连接池或并发超限", "先止损降并发，再调连接池和 MySQL 上限"],
+            ["SQLite database is locked", "多写者或磁盘/挂载问题", "停止并发写，检查权限和磁盘，完整备份后处理"],
+            ["Permission denied", "宿主机挂载所有者不正确", "核对 data/backend 的 UID/GID 与容器运行用户"],
+        ],
+        [2600, 3200, 3560],
+    )
+
+    add_h1(doc, "7. 前端端口、接口地址与运行时配置")
+    add_para(doc, "生产前端使用 Nginx，不使用开发端口 5174。对外端口由部署目录 .env 的 APP_PORT 控制；前端访问后端和外部业务接口的地址由 config/runtime-config.js 控制。该文件由浏览器直接读取，不能放任何服务端秘密。")
+    add_h2(doc, "7.1 修改前端访问端口")
+    add_code(doc, """
+    # 部署目录 .env
+    APP_PORT=18090
+    """, "ENV")
+    add_code(doc, """
+    sudo docker compose up -d --force-recreate web
+    sudo docker compose ps
+    curl -I http://127.0.0.1:18090/
+    """, "Shell")
+    add_para(doc, "1Panel 中若有端口安全组或主机防火墙，还要放行新的 TCP 端口。旧端口如不再使用应关闭。")
+    add_h2(doc, "7.2 推荐的同源后端配置")
+    add_code(doc, """
+    // config/runtime-config.js
+    window.__DEERFLOW_RUNTIME_CONFIG__ = {
+      VITE_BACKEND_BASE_URL: "/deerflow",
+      VITE_LANGGRAPH_BASE_URL: "/deerflow/api"
+    };
+    """, "JavaScript")
+    add_para(doc, "使用相对路径时，浏览器始终访问当前域名和 APP_PORT，再由 Nginx 转发到 backend:8001。这样最少遇到 CORS、证书和混合内容问题。")
+    add_h2(doc, "7.3 后端独立地址的配置")
+    add_code(doc, """
+    window.__DEERFLOW_RUNTIME_CONFIG__ = {
+      VITE_BACKEND_BASE_URL: "https://api.example.internal",
+      VITE_LANGGRAPH_BASE_URL: "https://api.example.internal/api"
+    };
+    """, "JavaScript")
+    add_callout(doc, "使用绝对地址时", "后端必须配置允许前端 Origin，HTTPS 页面不能调用 HTTP 接口；证书需被客户端信任。除非确有分离网关需求，优先使用 /deerflow 相对地址。", "warn")
+    add_h2(doc, "7.4 常用运行时变量")
+    add_table(
+        doc,
+        ["变量", "用途", "是否可含秘密", "变更验证"],
+        [
+            ["VITE_BACKEND_BASE_URL", "Gateway 基础地址", "否", "登录、/health、普通 API"],
+            ["VITE_LANGGRAPH_BASE_URL", "LangGraph/流式对话地址", "否", "新建对话和流式输出"],
+            ["VITE_API_BASE_URL", "通用业务 API 根地址", "否", "对应业务页面"],
+            ["VITE_AIPI_CONSUMER_URL", "任务深链/业务查询", "否", "任务详情与深链"],
+            ["VITE_AIPI_CHAT_URL", "AIPI 对话类接口", "否", "对应智能体/业务"],
+            ["VITE_FORCE_COLLAPSED_SIDEBAR", "强制紧凑侧边栏", "否", "刷新后导航形态"],
+            ["Logo/欢迎页相关变量", "品牌素材 URL", "否", "明暗主题、登录页"],
+        ],
+        [3000, 2900, 1200, 2260],
+        font_size=8.6,
+    )
+    add_h2(doc, "7.5 修改后的生效")
+    for step in [
+        "备份 runtime-config.js，确认 JavaScript 逗号和引号语法正确。",
+        "重启 Web 容器，或至少确认挂载文件已经更新。",
+        "浏览器使用 Ctrl+F5 强制刷新；必要时清空站点缓存。",
+        "在开发者工具 Network 中检查 runtime-config.js、/deerflow/health、/deerflow/api 请求。",
+        "验证普通登录、对话流和至少一个外部业务接口。",
+    ]:
+        add_number(doc, step)
+    heading = add_h2(doc, "7.6 前端常见现象")
+    heading.paragraph_format.page_break_before = True
+    add_table(
+        doc,
+        ["现象", "检查", "处理"],
+        [
+            ["页面白屏", "Console 是否有语法/资源错误", "修复 runtime-config.js；恢复备份；强刷"],
+            ["页面能开但所有 API 失败", "Network 请求地址", "修正 BACKEND/LANGGRAPH_BASE_URL"],
+            ["刷新二级路由 404", "Nginx 是否 SPA try_files", "恢复随包 Nginx 配置并重建 Web"],
+            ["502 Bad Gateway", "backend 状态与日志", "先恢复后端，不要反复刷新前端"],
+            ["CORS blocked", "前后端 Origin 是否不同", "优先改同源；或配置后端 CORS"],
+            ["Mixed Content", "HTTPS 页面调用 HTTP", "接口改 HTTPS 或统一由 Nginx 代理"],
+        ],
+        [2400, 3000, 3960],
+    )
+
+    add_h1(doc, "8. 技能：目录、上传、发布与维护")
+    add_para(doc, "技能由宿主机 data/skills 持久化到容器 /app/backend/skills。系统使用 public 和 custom 两类目录，每个技能至少应包含 SKILL.md；还可包含 Python 脚本、references 和 assets。启动脚本只会在技能挂载目录为空时写入默认技能，不会覆盖已有文件。")
+    add_figure(doc, diagrams["persistence_map"], "图 8-1 技能与智能体的持久化关系", "技能和智能体由文件、数据库元数据、权限和运行时共同决定")
+    add_h2(doc, "8.1 标准技能目录")
+    add_code(doc, """
+    data/skills/
+    ├── public/
+    │   └── example-public-skill/
+    │       ├── SKILL.md
+    │       ├── scripts/
+    │       ├── references/
+    │       └── assets/
+    └── custom/
+        └── example-custom-skill/
+            ├── SKILL.md
+            └── tool.py
+    """, "目录结构")
+    add_h2(doc, "8.2 推荐：通过前端上传或创建")
+    for step in [
+        "使用普通业务用户或管理员登录，进入技能设置/技能管理。",
+        "创建或上传技能，填写名称、描述、使用说明和依赖。",
+        "在技能详情页完成测试，确认工具地址、Python 依赖和文件权限。",
+        "需要共享时点击“发布”，选择目标广场；不共享则保留为自定义技能。",
+    ]:
+        add_number(doc, step)
+    add_callout(doc, "为什么推荐 UI", "UI 会同时维护技能文件、所有者、可见性、发布状态等数据库元数据。手工复制文件只解决文件存在，不一定能让正确用户在界面看到。", "note")
+    add_h2(doc, "8.3 手工离线导入技能")
+    add_para(doc, "仅在批量迁移或 UI 不可用时使用。先在测试环境核对技能内容，再复制整个技能目录，保持目录名稳定。")
+    add_code(doc, """
+    # 例：导入为自定义技能
+    sudo mkdir -p data/skills/custom/example-skill
+    sudo cp -a /mnt/offline/example-skill/. data/skills/custom/example-skill/
+
+    # 核对宿主机文件
+    find data/skills/custom/example-skill -maxdepth 3 -type f -print
+
+    # 核对容器内挂载
+    sudo docker compose exec backend sh -lc \
+      'find /app/backend/skills/custom/example-skill -maxdepth 3 -type f -print'
+    """, "Shell")
+    add_para(doc, "若容器不是 root 运行，需确保运行用户对文件可读、对需要修改的目录可写。完成后重启 backend 以刷新技能扫描与系统提示缓存。")
+    add_h2(doc, "8.4 public 与广场发布的区别")
+    add_table(
+        doc,
+        ["概念", "含义", "建议权限", "是否等于广场可见"],
+        [
+            ["public 目录", "技能文件类别/系统公共技能", "仅管理员直接写入", "不一定，仍受业务元数据和页面逻辑影响"],
+            ["custom 目录", "用户自定义技能", "普通用户维护自己的", "可发布到广场"],
+            ["发布广场", "业务可见性、目标广场和发布状态", "所有者或管理员", "是"],
+        ],
+        [1750, 3600, 1900, 2110],
+    )
+    add_h2(doc, "8.5 技能地址管理")
+    add_para(doc, "管理员可在技能管理页的“技能地址管理”标签扫描运行中 skills/public 与 skills/custom 下 .md、.py 中出现的 HTTP(S) URL 和 IP:端口，预览后批量替换，并按修改记录回退。适用于 UAT 地址切生产地址。")
+    for item in [
+        "替换前使用预览，核对每个 file:line 片段；不要直接全目录文本替换。",
+        "应用会生成磁盘备份和 manifest；回退前仍建议做整目录备份。",
+        "扫描范围只包含运行中技能目录，不会修改 deploy/minimal/skills。",
+        "接口为管理员权限；大量技能扫描时等待进度完成，不要重复点击。",
+    ]:
+        add_bullet(doc, item)
+    add_h2(doc, "8.6 技能发布到广场")
+    for step in [
+        "确认当前登录用户是技能所有者，或使用 admin。",
+        "在技能列表/详情点击“发布”。",
+        "选择一个发布广场；未选择时可能进入系统默认广场。",
+        "确认发布后，使用普通用户进入广场检索并安装/使用。",
+        "需要改投时重新发布到另一个广场；一个技能同一时间只属于一个广场。",
+    ]:
+        add_number(doc, step)
+    add_h2(doc, "8.7 技能上传安全检查")
+    add_bullet(doc, "检查 SKILL.md 和脚本中是否包含真实 API Key、数据库密码、内网敏感地址或个人信息。")
+    add_bullet(doc, "检查 Python/shell 脚本是否包含删除、提权、任意命令执行或越权网络访问。")
+    add_bullet(doc, "需要外部依赖时，离线镜像必须已包含包，或提供受控离线 wheel/npm 包。")
+    add_bullet(doc, "仅允许可信管理员把技能直接放入 public；普通用户走 custom + 广场审批。")
+
+    add_h1(doc, "9. 智能体：目录、模型、发布与恢复")
+    add_para(doc, "智能体的主要文件位于 data/backend/agents/<agent-id>/，通常包含 config.yaml 与 SOUL.md；名称、所有者、发布状态、广场等信息在业务数据库中。因此备份或迁移智能体必须同时覆盖 data/backend 和数据库。")
+    add_h2(doc, "9.1 标准目录与职责")
+    add_code(doc, """
+    data/backend/agents/<agent-id>/
+    ├── config.yaml   # 模型、工具、参数等结构化配置
+    └── SOUL.md       # 角色、任务、边界、表达风格等提示词
+    """, "目录结构")
+    add_table(
+        doc,
+        ["对象", "主要内容", "缺失影响"],
+        [
+            ["config.yaml", "模型引用、工具/技能和运行参数", "智能体可能无法加载或退化为最小配置"],
+            ["SOUL.md", "角色提示词和业务规则", "角色行为改变、回答质量下降"],
+            ["数据库记录", "所有者、名称、状态、发布信息", "界面看不到、权限异常、广场丢失"],
+        ],
+        [2200, 3800, 3360],
+    )
+    add_h2(doc, "9.2 创建与维护建议")
+    for step in [
+        "优先在智能体管理页面创建，系统会生成 ID 和数据库记录。",
+        "选择已在后端 models 中存在的模型 name；模型改名时先盘点引用。",
+        "配置工具/技能后完成一轮真实问答和错误场景测试。",
+        "SOUL.md 中不要写真实密钥；外部账号通过环境变量或受控凭据服务注入。",
+        "修改生产智能体前导出目录和数据库备份，保留变更说明。",
+    ]:
+        add_number(doc, step)
+    add_h2(doc, "9.3 发布到广场")
+    add_para(doc, "智能体列表卡片或详情页提供发布入口。所有者或管理员选择目标广场并确认；发布后普通用户可在对应广场发现。重新发布到另一广场表示移动，不会在多个广场重复复制。私有广场状态与公开发布状态应按页面规则保持互斥。")
+    add_figure(doc, diagrams["publish_flow"], "图 9-1 技能/智能体发布流程", "创建、验证、发布、权限校验和广场生效流程")
+    add_h2(doc, "9.4 直接发布与私有广场")
+    add_bullet(doc, "“直接发布到广场”仍建议从资产卡片/详情点击发布，这样所有者和发布元数据完整。")
+    add_bullet(doc, "管理员在外观/系统设置中维护广场列表、默认广场和私有广场密码。")
+    add_bullet(doc, "若资产已在私有广场，转为公开发布前按页面提示解除私有状态；反向操作同理。")
+    add_bullet(doc, "发布后要用普通用户验证，不要只看管理员列表。")
+    add_h2(doc, "9.5 智能体模型失效")
+    add_table(
+        doc,
+        ["现象", "原因", "处理"],
+        [
+            ["智能体加载但对话报模型不存在", "config.yaml 引用了已删除/改名的模型 name", "恢复原 name 或批量更新智能体配置"],
+            ["模型列表有但智能体仍用旧模型", "智能体配置固定引用旧值或缓存未刷新", "修改智能体并重启 backend"],
+            ["同名智能体权限不同", "数据库所有者/作用域不同", "用 admin 检查记录，不要仅比较目录名"],
+        ],
+        [2800, 3300, 3260],
+    )
+
+    add_h1(doc, "10. 发布广场与私有广场管理")
+    add_para(doc, "发布广场是技能和智能体的分发入口。管理员维护广场列表、默认广场、启用状态与私有广场密码；资产所有者或管理员负责发布和下架。")
+    add_h2(doc, "10.1 管理员配置广场")
+    for step in [
+        "使用 DeerFlow admin 登录。",
+        "进入设置中的外观/发布广场配置区域。",
+        "新增广场名称和说明，设置启用状态、排序和默认广场。",
+        "如启用私有广场，配置独立密码并通过安全渠道分发。",
+        "保存后用普通用户检查广场入口、默认选择和访问控制。",
+    ]:
+        add_number(doc, step)
+    add_h2(doc, "10.2 发布规则")
+    add_table(
+        doc,
+        ["规则", "解释", "运维影响"],
+        [
+            ["一项资产只属于一个广场", "重新发布到新广场会移动", "迁移前通知原广场使用者"],
+            ["默认广场", "未明确选择时作为默认目标", "删除/停用前先指定新默认"],
+            ["所有者或管理员可发布", "防止普通用户操作他人资产", "账号变更时先转移所有权或由 admin 处理"],
+            ["私有与公开互斥", "防止同一资产同时处于两类可见性", "变更后用两类用户复核"],
+        ],
+        [2300, 3400, 3660],
+    )
+    add_h2(doc, "10.3 看不到发布按钮")
+    add_bullet(doc, "当前用户不是资产所有者，也不是 admin。")
+    add_bullet(doc, "资产来自系统公共目录，页面只允许管理员操作。")
+    add_bullet(doc, "发布广场全部停用或没有默认广场。")
+    add_bullet(doc, "前端缓存、权限令牌过期，或后端数据库切换后记录不完整。")
+    add_bullet(doc, "打开浏览器 Network，检查 publish API 的 401/403/409 响应。")
+
+    add_h1(doc, "11. 菜单名称、排序、隐藏与路由安全")
+    add_para(doc, "管理员可通过“设置和更多 → 菜单管理”修改侧边栏节点的显示名称、启停、顺序和父级。系统以静态路由树为基础，仅把数据库中的覆盖项叠加上去；图标和实际 path 不会因为改名称而改变。")
+    add_figure(doc, diagrams["ui_map"], "图 11-1 常用管理入口地图", "菜单、主题、技能、智能体和用户管理的页面入口")
+    add_h2(doc, "11.1 修改菜单名称")
+    for step in [
+        "用 admin 登录，打开左下角“设置和更多”。",
+        "进入“菜单管理”，找到目标一级/二级/三级菜单。",
+        "编辑 label，保存；不要修改真实 path 或源代码 ID。",
+        "刷新页面，用普通用户核对侧边栏和顶部导航。",
+        "记录原名称，避免业务培训资料与新名称不一致。",
+    ]:
+        add_number(doc, step)
+    add_h2(doc, "11.2 隐藏菜单")
+    add_para(doc, "在菜单管理中将节点停用。停用父节点会隐藏整个子树；支持上下移动或拖拽调整顺序和父级，但系统严格限制最多三级。动态注入的 iframe 轻应用节点也可管理。")
+    add_callout(doc, "重要安全边界", "隐藏菜单只移除导航入口，不保证用户不能通过已知 URL 直接访问，也不替代后端 API 权限。敏感功能必须同时有前端路由守卫和后端角色校验。", "danger")
+    add_h2(doc, "11.3 需要真正禁用功能时")
+    for item in [
+        "先停用菜单，避免用户继续进入。",
+        "检查对应页面是否有 admin/lqq/业务角色路由守卫。",
+        "检查后端 API 是否校验角色、所有者或账号。",
+        "必要时通过功能开关或后端配置关闭 API；不要只依赖 CSS 隐藏。",
+        "用普通账号直接输入 URL 和直接调用 API 进行验收。",
+    ]:
+        add_number(doc, item)
+    add_h2(doc, "11.4 菜单异常恢复")
+    add_table(
+        doc,
+        ["问题", "原因", "处理"],
+        [
+            ["全部子菜单消失", "父节点被停用或移到错误父级", "admin 在菜单管理恢复父节点；必要时查 menu-overrides 数据"],
+            ["菜单名改了但路由未变", "这是设计行为", "继续使用原 path；不要以显示名推导 URL"],
+            ["轻应用菜单消失", "轻应用停用、父级停用或 override 隐藏", "同时检查轻应用和菜单覆盖"],
+            ["普通用户看不到，admin 能看到", "角色过滤或功能权限", "确认预期角色，不要直接改静态路由"],
+        ],
+        [2300, 3400, 3660],
+    )
+
+    add_h1(doc, "12. 主题色、布局和品牌配置")
+    add_para(doc, "所有用户都可在“设置 → 外观”选择个人主题和布局。管理员还可配置系统默认主题、默认布局和自定义主题库。用户已有个人选择时，个人设置通常优先于系统默认。")
+    add_h2(doc, "12.1 内置主题")
+    add_table(
+        doc,
+        ["主题标识", "界面名称", "使用建议"],
+        [
+            ["light", "标准浅色", "默认办公环境"],
+            ["dark", "深色", "暗光环境和大屏"],
+            ["lightblue", "浅蓝", "政企蓝色体系"],
+            ["lightgreen", "浅绿", "运营/生态类场景"],
+            ["iceblue", "冰蓝", "冷色、低饱和界面"],
+            ["lightyellow", "浅黄", "暖色、阅读型界面"],
+        ],
+        [2100, 2400, 4860],
+    )
+    add_h2(doc, "12.2 管理员设置系统默认")
+    for step in [
+        "使用 admin 登录，进入设置 → 外观。",
+        "设置系统默认主题和默认布局；这些主要影响没有个人覆盖的新用户。",
+        "在自定义主题库中配置主题名称、主色、启用状态和排序。",
+        "保存后使用新普通用户或清除个人覆盖的测试用户验证。",
+        "分别检查明暗主题的 Logo、文字对比度、按钮和焦点状态。",
+    ]:
+        add_number(doc, step)
+    add_h2(doc, "12.3 自定义主题色的验收")
+    add_bullet(doc, "正文文字和背景必须有足够对比度；不要只看主按钮。")
+    add_bullet(doc, "检查 hover、selected、disabled、focus、error、success 等状态。")
+    add_bullet(doc, "检查表格、弹窗、下拉菜单、图表、侧边栏和移动窗口宽度。")
+    add_bullet(doc, "品牌主色不要直接当大面积背景，浅色主题应提供足够浅的层级色。")
+    add_bullet(doc, "主题调整后至少用 Chrome/Edge 验证，并保留一键恢复内置主题的方法。")
+    add_h2(doc, "12.4 强制紧凑侧边栏")
+    add_code(doc, """
+    // config/runtime-config.js
+    window.__DEERFLOW_RUNTIME_CONFIG__ = {
+      VITE_FORCE_COLLAPSED_SIDEBAR: "true"
+    };
+    """, "JavaScript")
+    add_para(doc, "这是部署级开关，适用于外部嵌入或小屏展示。若用户报告无法展开侧边栏，先检查该值。")
+    add_h2(doc, "12.5 iframe 嵌入主题")
+    add_para(doc, "外部系统可在深链加入 ?embed=1&theme=dark 等参数隐藏全局导航并强制当前标签页主题。该设置使用会话级隔离，不应覆盖普通标签页的个人主题。另有 ?hideJump=1 隐藏快捷跳转栏，?isolate=1 启用本标签页独立登录会话。")
+
+    add_h1(doc, "13. 敏感词管理与显示层脱敏")
+    add_para(doc, "敏感词功能维护“原始词 → 替换词”的展示层映射。它会改变菜单/导航等页面显示，但不会修改原始业务数据、路由 path、节点 ID 或数据库中的源文本。因此它不是数据清洗，也不能代替数据库脱敏。")
+    add_h2(doc, "13.1 登录哪个用户")
+    add_callout(doc, "使用 lqq", "当前前端入口、路由守卫和页面守卫要求显示用户名转小写后等于 lqq。即使 admin 后端有写权限，非 lqq 管理员通常也看不到或进不了该页面。", "warn")
+    add_h2(doc, "13.2 操作步骤")
+    for step in [
+        "以 lqq 登录，进入左下角“设置和更多 → 敏感词管理”。",
+        "新增原始词和替换词，设置启用状态；避免把过短的常用单字作为原始词。",
+        "如需恢复系统初始映射，使用“导入种子词”合并缺失项。",
+        "保存会整体替换当前配置，提交前导出或截图留档。",
+        "刷新页面，检查菜单、导航、标题；再用普通用户验证。",
+    ]:
+        add_number(doc, step)
+    add_h2(doc, "13.3 设计与风险")
+    add_table(
+        doc,
+        ["问题", "说明", "建议"],
+        [
+            ["是否改数据库原文", "不会，只影响展示", "需要源数据脱敏时另走数据治理流程"],
+            ["是否影响 URL", "不会，path/id 保持不变", "文档仍使用真实路由"],
+            ["空配置怎么办", "加载失败或空时保留前端种子映射", "检查 /api/sensitive-words 与日志"],
+            ["替换冲突", "多个词重叠可能产生意外显示", "从长词到短词测试；避免循环式替换"],
+            ["保存影响范围", "全局共享", "必须有审批和变更记录"],
+        ],
+        [2200, 3400, 3760],
+    )
+    add_h2(doc, "13.4 页面看不到时")
+    add_bullet(doc, "确认显示用户名是 lqq，而不是仅系统角色为 admin。")
+    add_bullet(doc, "邮箱登录时确认 @ 前缀；清理旧 Token 后重新登录。")
+    add_bullet(doc, "确认菜单覆盖没有停用“敏感词管理”节点。")
+    add_bullet(doc, "检查后端 /api/sensitive-words 的 401/403 和数据库连接。")
+
+    add_h1(doc, "14. 备份、恢复、升级与回滚")
+    add_para(doc, "一次可恢复的备份至少包含配置、持久化文件和当前业务数据库。只保存 Docker 镜像不能恢复用户、技能、智能体和全局设置。外部 MySQL 必须单独导出。")
+    add_figure(doc, diagrams["backup_upgrade"], "图 14-1 离线升级与回滚闭环", "从盘点、备份、演练、验收到切换和回滚的过程")
+    add_h2(doc, "14.1 备份范围")
+    add_table(
+        doc,
+        ["对象", "必须", "建议频率", "恢复用途"],
+        [
+            ["config 目录 + .env", "是", "每次变更后", "恢复模型、登录、接口、数据库配置"],
+            ["data/backend", "是", "每日 + 变更前", "SQLite、智能体文件和运行数据"],
+            ["data/skills", "是", "每日 + 技能变更后", "public/custom 技能"],
+            ["data/knowledge", "按使用", "每日/每周", "知识库文件"],
+            ["外部 MySQL dump", "使用 MySQL 时", "每日 + 变更前", "资产元数据、用户、菜单、主题、广场等"],
+            ["镜像 tar + SHA256", "是", "每个版本", "离线重装和回滚"],
+        ],
+        [2600, 1100, 2100, 3560],
+    )
+    add_h2(doc, "14.2 文件备份示例")
+    add_code(doc, """
+    cd /opt/deerflow/deerflow-deploy
+
+    # 推荐先安排短暂停写窗口，再执行归档
+    sudo tar -czf /backup/deerflow-files-$(date +%F-%H%M).tar.gz \
+      .env config data
+
+    sha256sum /backup/deerflow-files-*.tar.gz
+    """, "Shell")
+    add_h2(doc, "14.3 MySQL 备份示例")
+    add_code(doc, """
+    # 不要把密码直接写在命令行历史中；优先使用受控 defaults-extra-file
+    mysqldump --single-transaction --routines --triggers \
+      --host=<MYSQL_HOST> --user=<BACKUP_USER> deerflow \
+      > /backup/deerflow-mysql-$(date +%F-%H%M).sql
+    """, "Shell")
+    add_h2(doc, "14.4 恢复原则")
+    for step in [
+        "确认备份版本、摘要、数据库模式和目标目录；禁止直接覆盖未知现网。",
+        "停止写入或停止 backend，先把现网再做一次应急备份。",
+        "在新目录恢复 config 和 data，检查文件所有者与权限。",
+        "外部 MySQL 恢复到新库或确认的空库，避免覆盖错误库。",
+        "用临时 APP_PORT 启动，完成登录、模型、技能、智能体、广场和对话验收。",
+        "切换正式端口；保留旧目录、旧库和旧镜像直到观察期结束。",
+    ]:
+        add_number(doc, step)
+    add_h2(doc, "14.5 离线升级")
+    add_bullet(doc, "核对离线包架构必须为 linux/arm64；SHA256 与交付清单一致。")
+    add_bullet(doc, "不要直接覆盖旧目录。解压到带版本号的新目录，复制 data 和配置后逐项合并。")
+    add_bullet(doc, "先用临时端口启动新版本，数据库升级必须有回退方案。")
+    add_bullet(doc, "升级后测试管理员、lqq、普通用户三类账号。")
+    add_bullet(doc, "观察期内保留旧镜像，禁止执行会清理回滚镜像的 prune。")
+    add_callout(doc, "高风险命令", "docker system prune -a、删除部署目录、覆盖数据库和递归修改所有者均可能造成不可逆损失。执行前必须明确目标、备份已验证并经过审批。", "danger")
+    add_h2(doc, "14.6 备份校验与恢复演练")
+    add_para(doc, "备份任务显示“成功”不代表一定可恢复。至少每季度在隔离目录或隔离服务器做一次完整恢复演练，并记录恢复用时和缺失项。")
+    add_table(
+        doc,
+        ["检查项", "检查方法", "合格标准"],
+        [
+            ["归档完整性", "tar -tzf 列出 config、data 关键目录", "无读取错误，路径与部署台账一致"],
+            ["文件摘要", "重新计算 SHA256 并与备份台账比对", "摘要完全一致"],
+            ["SQLite", "在副本上执行完整性检查并启动测试环境", "检查通过，用户与资产数量正确"],
+            ["MySQL", "恢复到隔离库，核对表、行数和关键业务", "无迁移错误，三类账号验收通过"],
+            ["应用验证", "临时 APP_PORT 启动并执行上线验收清单", "健康、登录、模型、资产、管理功能通过"],
+            ["回退时长", "记录从故障确认到旧版本恢复的总耗时", "满足本单位 RTO/RPO 要求"],
+        ],
+        [2100, 4100, 3160],
+        font_size=8.7,
+    )
+
+    add_h1(doc, "15. 监控、巡检与日志留存")
+    add_h2(doc, "15.1 每日巡检")
+    for item in [
+        "docker compose ps：backend、web 均为正常状态，无反复重启。",
+        "/deerflow/health 返回成功；前端首页可打开。",
+        "磁盘剩余空间、inode、内存和负载无异常。",
+        "backend/web 日志无持续 401、429、500、数据库断连或权限错误。",
+        "模型最短问答可用；关键业务接口按单位要求抽测。",
+        "前一日文件备份和数据库备份成功，摘要记录完整。",
+    ]:
+        add_bullet(doc, item)
+    add_h2(doc, "15.2 每周巡检")
+    for item in [
+        "检查离线镜像、部署目录和文档版本是否对应。",
+        "统计模型调用错误率、超时和 429，评估并发与额度。",
+        "检查技能地址是否指向过期 UAT/测试环境。",
+        "抽查发布广场、私有广场、菜单、主题和敏感词是否符合审批。",
+        "在隔离环境随机做一次备份恢复演练。",
+        "清理日志前先确认保留策略；不要删除仍在被容器写入的文件。",
+    ]:
+        add_bullet(doc, item)
+    add_h2(doc, "15.3 建议监控指标")
+    add_table(
+        doc,
+        ["层级", "指标", "建议告警"],
+        [
+            ["主机", "磁盘、inode、内存、负载、时间同步", "磁盘 <20% 预警，<10% 紧急"],
+            ["容器", "Up、重启次数、CPU/内存", "反复重启或持续高占用"],
+            ["HTTP", "首页、/health、5xx、延迟", "健康失败、连续 5xx"],
+            ["模型", "401/403/404/429、超时、首 token 延迟", "权限错误立即，429 持续告警"],
+            ["数据库", "连接数、慢查询、空间、备份", "连接耗尽、备份失败"],
+            ["业务资产", "技能/智能体数量、发布变更、管理员操作", "数量突降、未经审批的全局变更"],
+        ],
+        [1800, 4100, 3460],
+    )
+    add_h2(doc, "15.4 日志采集包")
+    add_para(doc, "提交问题时应包含：发生时间（含时区）、用户和角色、访问 URL、操作步骤、浏览器 Network/Console、backend/web 最近日志、compose ps、健康检查、版本号与配置变更。任何日志对外发送前都要脱敏。")
+
+    add_h1(doc, "16. 常见报错与解决办法")
+    add_h2(doc, "16.1 容器和主机")
+    add_table(
+        doc,
+        ["报错/现象", "根因", "解决"],
+        [
+            ["exec format error", "镜像架构不匹配", "确认 uname -m；ARM 服务器使用 linux/arm64 镜像"],
+            ["address already in use", "APP_PORT 被占用", "ss -lntp 检查；改 .env 或停冲突服务"],
+            ["no space left on device", "磁盘或 inode 满", "先定位大目录和日志；扩容或受控清理；不要盲目 prune"],
+            ["容器不断 Restarting", "配置解析、数据库、权限或启动命令失败", "docker compose logs --tail=500 backend"],
+            ["permission denied", "挂载目录所有者/模式不匹配", "对照容器 UID/GID 修复目标目录，不要全盘 chmod 777"],
+            ["镜像导入失败", "tar 损坏或磁盘不足", "核对 SHA256、剩余空间、docker load 日志"],
+        ],
+        [2600, 2900, 3860],
+        font_size=8.7,
+    )
+    add_h2(doc, "16.2 前端和 Nginx")
+    add_table(
+        doc,
+        ["报错/现象", "根因", "解决"],
+        [
+            ["502 Bad Gateway", "backend 未启动或 Nginx 无法访问 backend:8001", "查 backend 日志和 compose 网络；先恢复后端"],
+            ["404 刷新二级路由", "SPA fallback 丢失", "Nginx location / 使用 try_files ... /index.html"],
+            ["静态资源 404", "错误 base 路径、缓存或镜像不完整", "查 Network 路径、runtime-config 和 Web 镜像"],
+            ["页面白屏", "JavaScript 语法、旧缓存、运行时配置异常", "看 Console；恢复 runtime-config；Ctrl+F5"],
+            ["请求发到旧地址", "浏览器缓存或改错文件", "确认 Network 中 runtime-config.js；重启 Web 并强刷"],
+        ],
+        [2600, 3150, 3610],
+    )
+    add_h2(doc, "16.3 登录和权限")
+    add_table(
+        doc,
+        ["报错/现象", "根因", "解决"],
+        [
+            ["401 Unauthorized", "Token 过期、JWT 密钥变化或存储隔离", "重新登录；核对 AUTH_JWT_SECRET 是否稳定"],
+            ["403 Forbidden", "角色/所有者不足", "核对 system_role、资产所有者、lqq 条件"],
+            ["重启后全员掉线", "JWT 密钥被改或未持久化", "恢复固定密钥；全员重新登录"],
+            ["admin 看不到敏感词入口", "前端要求用户名 lqq", "使用 lqq；不要仅提升 admin"],
+            ["iframe 与正常页账号混淆", "未使用 embed/isolate 会话隔离", "核对 URL 参数与 sessionStorage 策略"],
+        ],
+        [2600, 3300, 3460],
+    )
+    add_h2(doc, "16.4 模型和流式对话")
+    add_table(
+        doc,
+        ["报错/现象", "根因", "解决"],
+        [
+            ["模型 401/403", "Key 或权限", "核对 backend.env、模型授权、IP 白名单"],
+            ["模型 404", "base_url/model ID", "用提供方接口清单核对，注意 /v1"],
+            ["模型 429", "并发/限流/余额", "降并发、等待、申请额度；避免重试风暴"],
+            ["流式输出中断", "代理缓冲、超时、客户端断网", "查 Nginx SSE 配置、后端日志和 Network"],
+            ["回答截断", "max_tokens 或上游输出上限", "逐步调大，查 finish_reason；不要超过提供方限制"],
+            ["工具调用循环", "模型能力、提示词或工具返回异常", "查看线程日志，暂时禁用问题工具并修复输入输出"],
+        ],
+        [2600, 3000, 3760],
+    )
+    add_h2(doc, "16.5 数据库和资产")
+    add_table(
+        doc,
+        ["报错/现象", "根因", "解决"],
+        [
+            ["MySQL Access denied", "账号、密码或 host", "核对 URL 编码和授权"],
+            ["启动迁移报错", "版本跨度、权限或脏迁移", "停止反复启动，备份后按迁移日志处理"],
+            ["技能存在但 UI 不显示", "数据库所有者/作用域或扫描失败", "查文件、记录、权限和 backend 日志"],
+            ["智能体目录存在但列表为空", "数据库切换或元数据缺失", "恢复同版本数据库或按管理流程重建记录"],
+            ["发布后广场无资产", "发布目标、过滤、私有状态或缓存", "用普通用户查目标广场和 publish API"],
+        ],
+        [2600, 3300, 3460],
+    )
+
+    add_h1(doc, "17. 技能或智能体丢失专项排查")
+    add_para(doc, "“丢失”不一定是磁盘文件被删。账号变化、数据库切换、发布过滤、错误 Compose 目录、空挂载或权限失败都可能表现为界面看不到。按固定顺序排查，避免先复制文件造成数据进一步分叉。")
+    add_figure(doc, diagrams["lost_asset_flow"], "图 17-1 资产丢失排查流程", "从服务、账号、文件、数据库到恢复和验证的排查顺序")
+    add_h2(doc, "17.1 第一步：确认当前服务和部署目录")
+    add_code(doc, """
+    pwd
+    sudo docker compose ps
+    sudo docker compose config --services
+    sudo docker compose images
+    """, "Shell")
+    add_para(doc, "重点排除在旧部署目录执行命令，或 1Panel 启动了另一个同名 Compose 项目。记录容器名称、镜像 ID 和端口。")
+    add_h2(doc, "17.2 第二步：确认登录身份")
+    add_bullet(doc, "退出重新登录，确认用户名、system_role 和是否使用 iframe/isolate 独立会话。")
+    add_bullet(doc, "确认资产原所有者是谁；普通用户不能看到他人私有资产。")
+    add_bullet(doc, "用 admin 查看全局资产；再用原所有者确认。")
+    add_h2(doc, "17.3 第三步：核对宿主机与容器内文件")
+    add_code(doc, """
+    # 宿主机
+    find data/skills -maxdepth 3 -type f -print | sort
+    find data/backend/agents -maxdepth 3 -type f -print | sort
+
+    # 容器内
+    sudo docker compose exec backend sh -lc \
+      'find /app/backend/skills -maxdepth 3 -type f -print | sort'
+    sudo docker compose exec backend sh -lc \
+      'find /app/backend/.deer-flow/agents -maxdepth 3 -type f -print | sort'
+    """, "Shell")
+    add_para(doc, "如果宿主机有、容器内没有，检查 docker-compose.yml 的 volume 映射和当前工作目录；如果两边都没有，先停止写入并查备份，不要创建同名空资产覆盖恢复线索。")
+    add_h2(doc, "17.4 第四步：确认数据库没有切换")
+    add_bullet(doc, "检查 config.yaml 的 database.backend 是 sqlite 还是 mysql。")
+    add_bullet(doc, "检查 backend.env 的 MYSQL_DATABASE_URL 指向哪个主机和库。")
+    add_bullet(doc, "核对变更前后资产数量；SQLite 与 MySQL 不会自动保持同步。")
+    add_bullet(doc, "如果切回旧数据库后资产恢复，先冻结写入，制定合并方案，避免两套库继续分叉。")
+    add_h2(doc, "17.5 第五步：检查过滤、广场和权限")
+    add_bullet(doc, "清除搜索词和分类筛选；查看“我的”“公共”“已发布”“私有”等不同视图。")
+    add_bullet(doc, "确认资产是否改投另一广场、被下架、进入私有广场或所有权变化。")
+    add_bullet(doc, "检查 menu-overrides 是否隐藏了技能/智能体入口。")
+    add_h2(doc, "17.6 第六步：日志和权限")
+    add_code(doc, """
+    sudo docker compose logs --tail=1000 backend \
+      | grep -Ei 'skill|agent|permission|database|mysql|sqlite|invalid|error|traceback'
+    """, "Shell")
+    add_para(doc, "重点关注：SKILL.md 格式不合法、config.yaml 解析失败、目录 permission denied、数据库连接失败、扫描缓存刷新失败和 401/403。")
+    add_h2(doc, "17.7 恢复决策")
+    add_table(
+        doc,
+        ["文件", "数据库", "建议"],
+        [
+            ["存在", "存在", "修复权限、挂载、账号或过滤；重启 backend 验证"],
+            ["存在", "缺失", "从同版本数据库备份恢复元数据；不要直接伪造所有者"],
+            ["缺失", "存在", "从文件备份恢复；数据库可能只能提供最小信息"],
+            ["缺失", "缺失", "停止写入，恢复完整备份；保全日志和磁盘证据"],
+            ["两套库各有新数据", "分叉", "冻结写入，导出比对，编写一次性合并迁移并审计"],
+        ],
+        [2000, 2000, 5360],
+    )
+    add_callout(doc, "不要做什么", "不要执行 docker system prune -a，不要删除 data 重新启动，不要把空目录覆盖到挂载点，不要用 chmod -R 777 掩盖所有权问题。", "danger")
+
+    add_h1(doc, "18. 安全加固与密钥管理")
+    add_h2(doc, "18.1 密钥清单")
+    add_table(
+        doc,
+        ["密钥/凭据", "保存位置", "前端可见", "轮换建议"],
+        [
+            ["AUTH_JWT_SECRET", "config/backend.env", "绝对不可", "事件触发或年度；轮换会使会话失效"],
+            ["模型 API Key", "config/backend.env", "绝对不可", "按提供方策略，泄露立即轮换"],
+            ["MySQL URL/密码", "config/backend.env 或安全挂载", "绝对不可", "90~180 天或按制度"],
+            ["私有广场密码", "后台全局设置/数据库", "受登录用户可见范围", "人员变化或定期"],
+            ["runtime-config 地址", "config/runtime-config.js", "是", "只能放非秘密地址和开关"],
+        ],
+        [2300, 2800, 1600, 2660],
+        font_size=8.8,
+    )
+    add_h2(doc, "18.2 最低安全要求")
+    for item in [
+        "服务器 SSH 禁止长期使用共享 root 密码，启用个人密钥、最小 sudo 和登录审计。",
+        "1Panel 使用独立安全入口、强密码、双因素认证和访问白名单；及时安装受控补丁。",
+        "只开放 APP_PORT、SSH 管理端口和必要数据库访问；后端 8001 默认不对外映射。",
+        "config/backend.env 权限建议 600，部署目录限制给运维组；备份同样加密和访问控制。",
+        "审计 config.yaml，包括注释中的历史 API Key；发现真实 Key 即轮换并删除，不因注释状态降低风险。",
+        "技能和智能体提示词中禁止嵌入密钥；上传脚本按代码审查流程执行。",
+        "内网不等于可信。模型、数据库和业务接口仍使用 TLS、账号权限和日志审计。",
+    ]:
+        add_bullet(doc, item)
+    add_h2(doc, "18.3 日志脱敏")
+    add_bullet(doc, "对外发送日志前删除 Authorization、Cookie、Token、API Key、数据库 URL、手机号和身份证号。")
+    add_bullet(doc, "保留时间戳、请求路径、状态码、trace ID 和错误栈，避免过度脱敏导致无法定位。")
+    add_bullet(doc, "不要在群聊粘贴完整 backend.env；必要时只报告变量是否已设置和哈希/末四位。")
+    add_h2(doc, "18.4 离线介质")
+    add_bullet(doc, "导入前扫描移动介质；镜像和文档核对 SHA256。")
+    add_bullet(doc, "记录介质编号、导入人、时间和文件清单。")
+    add_bullet(doc, "导入完成后按单位制度清除临时介质和服务器临时目录。")
+
+    add_h1(doc, "19. 标准运维流程与交接清单")
+    add_h2(doc, "19.1 上线验收")
+    checks = [
+        ["基础", "CPU 架构为 ARM64；镜像 SHA256 与交付清单一致", "□"],
+        ["服务", "web/backend 正常；健康接口成功；无重启循环", "□"],
+        ["网络", "APP_PORT 可访问；8001 未无意暴露；外部依赖可达", "□"],
+        ["登录", "admin、lqq、普通用户均可登录且权限符合预期", "□"],
+        ["模型", "短问答、长文本、工具调用和视觉能力按需通过", "□"],
+        ["资产", "技能、智能体数量一致；所有者、广场和私有状态正确", "□"],
+        ["管理", "菜单、主题、敏感词、发布广场保存并对普通用户生效", "□"],
+        ["备份", "文件和数据库备份成功，并完成至少一次恢复抽检", "□"],
+        ["文档", "端口、地址、版本、账号责任人和回退步骤已登记", "□"],
+    ]
+    add_table(doc, ["类别", "验收项", "结果"], checks, [1400, 7160, 800], font_size=8.8)
+    add_h2(doc, "19.2 变更单最少信息")
+    add_bullet(doc, "变更目标、影响范围、窗口、负责人和审批单号。")
+    add_bullet(doc, "修改前后值（密钥只记录变量名，不记录明文）。")
+    add_bullet(doc, "备份位置、摘要、恢复验证结果。")
+    add_bullet(doc, "执行命令、服务重启范围、健康和业务验收结果。")
+    add_bullet(doc, "回退触发条件、回退命令、回退负责人。")
+    add_h2(doc, "19.3 离职/交接")
+    add_bullet(doc, "回收 Linux/1Panel、DeerFlow、MySQL、模型平台和外部系统账号。")
+    add_bullet(doc, "轮换共享密钥、私有广场密码和应急账号密码。")
+    add_bullet(doc, "核对定时备份、监控、证书和离线介质责任人。")
+    add_bullet(doc, "移交最近一次升级记录、已知问题和未完成变更。")
+    add_h2(doc, "19.4 运维责任矩阵")
+    add_table(
+        doc,
+        ["事项", "Linux/1Panel 运维", "DeerFlow admin", "模型/数据库管理员"],
+        [
+            ["容器、端口、磁盘", "主责", "知会", "知会"],
+            ["菜单、主题、广场、用户", "支持", "主责", "知会"],
+            ["模型参数与密钥", "执行部署", "业务验收", "主责并授权"],
+            ["数据库迁移与恢复", "容器与文件支持", "业务验收", "主责"],
+            ["技能/智能体丢失", "核对挂载和备份", "核对所有者和元数据", "核对数据库"],
+            ["安全事件", "隔离主机与日志保全", "冻结应用账号/资产", "轮换凭据并保全审计"],
+        ],
+        [2100, 2450, 2350, 2460],
+        font_size=8.5,
+    )
+    add_h2(doc, "19.5 交接会必须确认")
+    add_bullet(doc, "现场演示一次后端环境变量变更后的强制重建、实时日志和一键诊断。")
+    add_bullet(doc, "现场演示 admin、lqq、普通用户三类账号的边界。")
+    add_bullet(doc, "现场定位技能、智能体文件目录和当前数据库，并抽查最近备份。")
+    add_bullet(doc, "明确故障升级联系人、响应时间、离线介质和回退决策人。")
+
+    add_h1(doc, "附录 A：命令速查")
+    add_h2(doc, "A.1 服务")
+    add_code(doc, """
+    sudo bash install.sh                     # 首次安装/加载镜像并启动
+    sudo bash restart.sh                     # 重启全部
+    sudo bash stop.sh                        # 停止全部
+    sudo docker compose restart backend      # 日常重启后端/挂载配置变更
+    sudo docker compose up -d --force-recreate backend  # backend.env 变更
+    sudo docker compose restart web          # 只重启前端
+    sudo docker compose ps                   # 状态
+    """, "Shell")
+    add_h2(doc, "A.2 日志与健康")
+    add_code(doc, """
+    sudo bash logs.sh                         # 全部实时日志
+    sudo bash logs.sh backend                 # 后端实时日志
+    sudo bash logs.sh web                     # Web/Nginx 实时日志
+    sudo env TAIL=1000 bash diagnose.sh       # 一键诊断
+    curl -fsS http://127.0.0.1:8090/deerflow/health
+    """, "Shell")
+    add_h2(doc, "A.3 主机资源")
+    add_code(doc, """
+    uname -m                                  # 架构，应为 aarch64/arm64
+    df -h                                     # 磁盘空间
+    df -i                                     # inode
+    free -h                                   # 内存
+    ss -lntp                                  # 端口监听
+    sudo docker stats --no-stream             # 容器资源
+    """, "Shell")
+    add_h2(doc, "A.4 文件与挂载")
+    add_code(doc, """
+    sudo docker compose config                # 展开后的 Compose 配置
+    sudo docker compose exec backend sh -lc 'id; pwd; mount'
+    sudo docker compose exec backend sh -lc 'ls -la /app/backend/skills'
+    sudo docker compose exec backend sh -lc 'ls -la /app/backend/.deer-flow/agents'
+    """, "Shell")
+
+    add_h1(doc, "附录 B：安全配置模板")
+    add_h2(doc, "B.1 部署 .env")
+    add_code(doc, """
+    COMPOSE_PROJECT_NAME=deerflow-1panel
+    # 原样复制离线包内 .env 的标签值
+    DEERFLOW_TAG=<PACKAGE_TAG>
+    APP_PORT=8090
+    TZ=Asia/Shanghai
+
+    # 不要只凭 tag 名称判断 CPU 架构；用 docker image inspect 核对 Architecture
+    """, "ENV")
+    add_h2(doc, "B.2 backend.env")
+    add_code(doc, """
+    AUTH_JWT_SECRET=<强随机值>
+    INTRANET_MODEL_API_KEY=<模型密钥>
+    MYSQL_DATABASE_URL=mysql+asyncmy://<USER>:<URL_ENCODED_PASSWORD>@<HOST>:3306/<DB>?charset=utf8mb4
+
+    GATEWAY_ENABLE_DOCS=false
+    GATEWAY_WORKERS=1
+    """, "ENV")
+    add_h2(doc, "B.3 runtime-config.js")
+    add_code(doc, """
+    window.__DEERFLOW_RUNTIME_CONFIG__ = {
+      VITE_BACKEND_BASE_URL: "/deerflow",
+      VITE_LANGGRAPH_BASE_URL: "/deerflow/api",
+      VITE_API_BASE_URL: "<可选业务API地址>",
+      VITE_AIPI_CONSUMER_URL: "<可选任务业务地址>",
+      VITE_FORCE_COLLAPSED_SIDEBAR: "false"
+    };
+    """, "JavaScript")
+    add_h2(doc, "B.4 模型条目")
+    add_code(doc, """
+    models:
+      - name: intranet-model
+        display_name: 内网模型
+        use: langchain_openai:ChatOpenAI
+        model: <provider-model-id>
+        api_key: $INTRANET_MODEL_API_KEY
+        base_url: http://<MODEL_HOST>:<PORT>/v1
+        request_timeout: 600.0
+        max_retries: 2
+        max_tokens: 8192
+        temperature: 0.7
+        supports_vision: false
+        supports_thinking: false
+    """, "YAML")
+
+    add_h1(doc, "附录 C：问题升级模板")
+    add_para(doc, "向研发或供应商提交问题时，复制以下模板填写。密钥和个人信息必须脱敏。")
+    add_code(doc, """
+    【问题标题】
+    【发生时间】YYYY-MM-DD HH:mm:ss（Asia/Shanghai）
+    【环境/版本】生产/测试；离线包版本；镜像 ID；主机架构
+    【影响范围】全部用户/指定用户；登录/对话/技能/智能体/广场等
+    【用户身份】admin / lqq / 普通用户（不要提供密码）
+    【复现步骤】1... 2... 3...
+    【期望结果】
+    【实际结果】
+    【HTTP 状态码 / trace ID】
+    【最近变更】配置、模型、数据库、镜像、菜单、主题等
+    【容器状态】docker compose ps
+    【健康检查】/deerflow/health 结果
+    【日志附件】backend/web 最近 1000 行（已脱敏）
+    【浏览器附件】Console + Network（已脱敏）
+    【已尝试操作】
+    【是否可回退】是/否；回退点
+    """, "故障单")
+    add_h2(doc, "C.1 现场信息保全")
+    add_bullet(doc, "故障期间先记录时间、容器状态和日志，再重启；重启会丢失部分现场。")
+    add_bullet(doc, "涉及资产丢失时不要新建同名资产，不要修改数据库，不要清理 Docker。")
+    add_bullet(doc, "涉及安全事件时立即隔离、轮换凭据并按本单位安全事件流程上报。")
+
+    add_h1(doc, "附录 D：核心事实速记")
+    facts = [
+        ["前端和后端端口", "容器内不同：Web 80、Backend 8001；对用户可由 Nginx 统一为 APP_PORT"],
+        ["前端改端口", "部署 .env 的 APP_PORT，重建/重启 Web，放行防火墙"],
+        ["前端改接口", "config/runtime-config.js；推荐 /deerflow 和 /deerflow/api"],
+        ["后端模型", "config/config.yaml；密钥在 config/backend.env"],
+        ["max_tokens", "模型单次输出上限，不是上下文窗口"],
+        ["技能位置", "data/skills/public 与 data/skills/custom"],
+        ["智能体位置", "data/backend/agents/<agent-id>；还依赖数据库元数据"],
+        ["发布广场", "资产所有者或 admin 在 UI 发布；每项资产同一时间一个广场"],
+        ["敏感词用户", "正常前端管理使用显示用户名为 lqq 的账号"],
+        ["菜单隐藏", "只隐藏导航，不等于禁止直接路由和 API"],
+        ["JWT 密钥", "AUTH_JWT_SECRET；必须持久化；改变会导致全员重新登录"],
+        ["数据库切换", "SQLite ↔ MySQL 不自动迁移；必须备份、迁移、验收"],
+        ["完整备份", "config + data + 外部 MySQL + 镜像及 SHA256"],
+        ["资产丢失", "先查账号、挂载、数据库和过滤，再决定恢复；不要先 prune/删除"],
+    ]
+    add_table(doc, ["主题", "结论"], facts, [2500, 6860], font_size=8.8)
+    add_callout(doc, "手册维护", "每次镜像升级、路由调整、权限变化或数据库迁移后，由应用管理员和 Linux 运维共同复核本手册并更新版本记录。", "ok")
+
+    # Final metadata page without forced H1 to avoid a mostly blank page.
+    add_page_break(doc)
+    p = doc.add_paragraph(style="Title")
+    p.alignment = WD_ALIGN_PARAGRAPH.CENTER
+    p.paragraph_format.space_before = Inches(1.45)
+    r = p.add_run("运维交付确认")
+    set_run_font(r, size=24, bold=True, color=DARK_BLUE)
+    add_para(doc, "以下信息应由接收方在正式上线前补充，并存放在受控运维台账中。不要在本 Word 文档中写明文密码。", align=WD_ALIGN_PARAGRAPH.CENTER)
+    add_table(
+        doc,
+        ["项目", "填写内容"],
+        [
+            ["生产访问地址", ""],
+            ["部署目录", ""],
+            ["APP_PORT", ""],
+            ["镜像版本 / SHA256", ""],
+            ["数据库模式与库名", ""],
+            ["Linux / 1Panel 责任人", ""],
+            ["DeerFlow admin 责任人", ""],
+            ["lqq 账号责任人", ""],
+            ["备份位置与保留期", ""],
+            ["监控告警联系人", ""],
+            ["最近一次恢复演练日期", ""],
+        ],
+        [3000, 6360],
+        font_size=9,
+    )
+    add_para(doc, "交付人签字：____________________    接收人签字：____________________", align=WD_ALIGN_PARAGRAPH.CENTER, after=10)
+    add_para(doc, "日期：________年____月____日", align=WD_ALIGN_PARAGRAPH.CENTER)
+
+    doc.save(OUTPUT)
+    return OUTPUT
+
+
+if __name__ == "__main__":
+    ensure_dirs()
+    diagrams = make_diagrams()
+    output = build_document(diagrams)
+    print(output)
diff --git a/tmp/maintenance-manual/build_manual_user_focused.py b/tmp/maintenance-manual/build_manual_user_focused.py
new file mode 100644
index 00000000..3549d9dc
--- /dev/null
+++ b/tmp/maintenance-manual/build_manual_user_focused.py
@@ -0,0 +1,624 @@
+from __future__ import annotations
+
+"""Build the user-focused DeerFlow maintenance handbook.
+
+This deliberately reuses the established Word style helpers and diagrams from
+the original builder, but changes the information architecture for a normal
+Docker deployment: no 1Panel-, ARM-, or platform-specific deployment content.
+"""
+
+from pathlib import Path
+
+import build_manual as b
+
+
+OUT = Path(__file__).resolve().parent / "DeerFlow系统运维手册-用户重点版.docx"
+
+
+def set_running_furniture(doc):
+    """Replace the prior deployment-specific running header/footer."""
+    header_p = doc.sections[0].header.paragraphs[0]
+    header_p.clear()
+    header_p.alignment = b.WD_ALIGN_PARAGRAPH.RIGHT
+    run = header_p.add_run("DeerFlow 系统运维手册  |  用户重点版")
+    b.set_run_font(run, size=8.5, color=b.GRAY)
+
+    footer_p = doc.sections[0].footer.paragraphs[0]
+    footer_p.clear()
+    footer_p.alignment = b.WD_ALIGN_PARAGRAPH.CENTER
+    run = footer_p.add_run("内部运维资料  ·  第 ")
+    b.set_run_font(run, size=8.5, color=b.GRAY)
+    b.add_field(footer_p, "PAGE", "1")
+    run = footer_p.add_run(" 页")
+    b.set_run_font(run, size=8.5, color=b.GRAY)
+
+
+def add_cover(doc, diagrams):
+    p = doc.add_paragraph()
+    p.paragraph_format.space_before = b.Inches(0.78)
+    p.paragraph_format.space_after = b.Pt(10)
+    run = p.add_run("DeerFlow")
+    b.set_run_font(run, size=16, bold=True, color=b.BLUE)
+
+    p = doc.add_paragraph(style="Title")
+    p.paragraph_format.space_before = b.Pt(16)
+    run = p.add_run("系统运维手册")
+    b.set_run_font(run, size=30, bold=True, color=b.DARK_BLUE)
+    p = doc.add_paragraph(style="Subtitle")
+    run = p.add_run("通用 Docker 容器版 · 配置、资产与故障处理优先")
+    b.set_run_font(run, size=15, color=b.GRAY)
+    b.add_figure(doc, diagrams["architecture"], "系统访问与数据流概览", "浏览器经由 Web 容器访问前端和后端服务的流程", width=6.1)
+    b.add_callout(
+        doc,
+        "本版重点",
+        "以常规 Docker 容器运行环境为基准；将常见报错、config.yaml、.env、技能/智能体和前端管理设置提前，便于业务管理员直接查用。",
+        "note",
+    )
+    b.add_table(
+        doc,
+        ["文档版本", "适用范围", "更新日期"],
+        [["V1.1", "当前 DeerFlow Docker 部署包及本项目定制功能", "2026-08-08"]],
+        [1800, 5000, 2560],
+        font_size=9.2,
+    )
+    b.add_para(doc, "密级：内部运维资料。密钥、密码、IP、数据库账号均必须使用占位符；不要写入本手册。", italic=True, align=b.WD_ALIGN_PARAGRAPH.CENTER, after=0)
+
+
+def add_navigation(doc):
+    p = doc.add_paragraph(style="Title")
+    p.paragraph_format.page_break_before = True
+    run = p.add_run("先用目录找到答案")
+    b.set_run_font(run, size=24, bold=True, color=b.DARK_BLUE)
+    b.add_para(doc, "本手册按“先排错、再配置、再维护”的顺序编排。打开 Word 后可使用左侧导航窗格按标题跳转；目录页码没有更新时，按 Ctrl+A 后按 F9。")
+    toc = doc.add_paragraph()
+    toc.paragraph_format.space_after = b.Pt(8)
+    b.add_field(toc, r'TOC \o "1-3" \h \z \u', "目录将在 Word 中自动更新")
+    b.add_callout(doc, "最常用的五处", "页面或服务异常先看第 1 章；模型与 max_tokens 看第 2 章；登录、数据库和接口地址看第 3 章；技能/智能体问题看第 4 章；菜单、敏感词、主题看第 5 章。", "ok")
+    b.add_h2(doc, "阅读约定")
+    for text in [
+        "“部署目录”指存放 docker-compose.yml、.env、config 和 data 的当前运行目录。所有命令都应在此目录执行。",
+        "前端和后端不是同一个容器端口。用户通常只访问 APP_PORT；Web/Nginx 会把 /deerflow 请求转发到后端。",
+        "改配置前先备份原文件；改完只重启受影响服务；保存日志、健康检查和实际功能验证结果。",
+        "本文中的 <尖括号内容> 都是待替换占位符，不能原样复制到生产环境。",
+    ]:
+        b.add_bullet(doc, text)
+
+
+def add_chapter_common_errors(doc):
+    b.add_h1(doc, "1. 常见报错与第一时间怎么处理")
+    b.add_para(doc, "先收集状态再修改配置。大多数问题并非代码故障，而是当前目录错误、环境变量未重新加载、后端未启动、数据库连不上、权限不足或资产被过滤。")
+    b.add_h2(doc, "1.1 先执行这组无损检查")
+    b.add_code(doc, """
+    # 必须在部署目录执行
+    pwd
+    sudo docker compose ps
+    sudo docker compose logs --tail=200 backend
+    sudo docker compose logs --tail=200 web
+    curl -fsS http://127.0.0.1:<APP_PORT>/deerflow/health
+    """, "Shell")
+    b.add_callout(doc, "先不要做", "不要执行 docker system prune -a；不要删除 data 后重启；不要创建同名技能或智能体覆盖可能的恢复线索；不要把完整 backend.env 发到群里。", "danger")
+    b.add_h2(doc, "1.2 容器、端口和磁盘")
+    b.add_table(
+        doc,
+        ["现象/报错", "优先检查", "处理方式"],
+        [
+            ["address already in use", "APP_PORT 已被其他进程占用", "用 ss -lntp 查占用；修改部署目录 .env 的 APP_PORT，然后重建 web。"],
+            ["容器不断 Restarting", "backend 的最后 200 行日志", "重点查看 YAML、环境变量、数据库 URL、挂载权限或启动命令；修复后再重建 backend。"],
+            ["no space left on device", "磁盘、inode、data 和日志目录", "先清理可确认的旧日志或无用缓存；不要在未备份时清理 data 或盲目 prune。"],
+            ["permission denied", "宿主机挂载目录所有者和容器运行用户", "核对 compose volume 与目录权限；只对目标目录做最小权限修正，不使用 chmod -R 777。"],
+            ["Web 访问失败", "docker compose ps、APP_PORT、主机防火墙", "确认 web 容器正常、端口监听，并放行实际访问端口。"],
+        ],
+        [2200, 2650, 4510],
+        font_size=8.8,
+    )
+    b.add_h2(doc, "1.3 前端、Nginx 和接口")
+    b.add_table(
+        doc,
+        ["现象", "原因方向", "解决"],
+        [
+            ["502 Bad Gateway", "backend 未启动或 Web 无法访问 backend:8001", "先查 backend 日志和 Compose 网络；后端恢复后再刷新前端。"],
+            ["刷新二级页面 404", "Nginx 的 SPA 回退缺失", "恢复 Nginx 的 try_files 到 /index.html 配置并重启 web。"],
+            ["页面白屏", "runtime-config.js 语法或地址错误、缓存未刷新", "浏览器 Console/Network 定位；恢复配置，重启 web，使用 Ctrl+F5。"],
+            ["所有 API 都失败", "VITE_BACKEND_BASE_URL 或 VITE_LANGGRAPH_BASE_URL 配错", "优先恢复 /deerflow 和 /deerflow/api 相对路径；见第 3.5 节。"],
+            ["CORS / Mixed Content", "前后端不同源或 HTTPS 页面调用 HTTP 接口", "优先同源代理；必须跨域时在后端配置允许 Origin 并统一 HTTPS。"],
+        ],
+        [2100, 3000, 4260],
+        font_size=8.8,
+    )
+    b.add_h2(doc, "1.4 登录、模型、数据库和资产")
+    b.add_table(
+        doc,
+        ["现象/状态", "最常见原因", "首要动作"],
+        [
+            ["401 / invalid_api_key", "模型 Key 缺失、变量名不一致或已过期", "对照 config.yaml 的 $变量名 与 backend.env；更新后强制重建 backend。"],
+            ["404 model not found", "model 写成显示名或 base_url 路径不兼容", "使用服务商实际 model ID；核对 API 是否要求 /v1。"],
+            ["429 / timeout", "并发、配额、模型服务或网络问题", "降低并发/重试，检查模型服务和网络连通性。"],
+            ["401 / 403 登录或发布失败", "Token 过期、角色/所有者不足、广场未启用", "重新登录；核对 system_role、资产所有者和目标广场。"],
+            ["技能/智能体看不到", "目录未挂载、数据库切换、过滤、权限或发布状态", "按第 4.6 节逐步排查，不要立即新建同名资产。"],
+            ["MySQL Access denied / timeout", "账号、密码 URL 编码、host 授权、网络或端口", "查看第 3.4 节连接格式和第 7 章数据库恢复原则。"],
+        ],
+        [2250, 3150, 3960],
+        font_size=8.65,
+    )
+
+
+def add_chapter_model(doc, diagrams):
+    b.add_h1(doc, "2. config.yaml：模型、max_tokens 与后端配置")
+    b.add_para(doc, "模型条目由 config/config.yaml 管理；密钥由 config/backend.env 管理。两处的变量名必须完全一致。新增模型时先写密钥，再写模型条目，再验证后端日志和实际对话。")
+    b.add_figure(doc, diagrams["model_flow"], "图 2-1 模型配置与验证闭环", "从密钥、模型条目到后端验证和前端选择的流程", width=6.35)
+    b.add_h2(doc, "2.1 新增或修改一个 OpenAI 兼容模型")
+    b.add_number(doc, "备份 config/backend.env 和 config/config.yaml，并记录要替换的模型名称。")
+    b.add_number(doc, "在 backend.env 写入密钥，变量名仅供后端读取。")
+    b.add_code(doc, """
+    # config/backend.env
+    INTRANET_MODEL_API_KEY=<服务商分配的密钥>
+    """, "ENV")
+    b.add_number(doc, "在 config.yaml 的 models: 下增加或修改模型条目。name 是系统引用名；model 是服务商真实模型 ID；display_name 是前端显示名。")
+    b.add_code(doc, """
+    models:
+      - name: intranet-model
+        display_name: 内网模型
+        use: langchain_openai:ChatOpenAI
+        model: <服务商实际模型ID>
+        api_key: $INTRANET_MODEL_API_KEY
+        base_url: https://<模型服务地址>/v1
+        request_timeout: 600.0
+        max_retries: 2
+        max_tokens: 4096
+        temperature: 0.7
+        supports_vision: false
+        supports_thinking: false
+    """, "YAML")
+    b.add_number(doc, "强制重建 backend 以重新读取 backend.env；随后查看启动日志、健康检查和前端模型列表。")
+    b.add_code(doc, """
+    sudo docker compose up -d --force-recreate backend
+    sudo docker compose logs --tail=300 -f backend
+    curl -fsS http://127.0.0.1:<APP_PORT>/deerflow/health
+    """, "Shell")
+    b.add_h2(doc, "2.2 字段说明与常见误配")
+    b.add_table(
+        doc,
+        ["字段", "用途", "常见问题"],
+        [
+            ["name", "系统内部模型名称，配置引用以它为准", "重名会覆盖或引用混乱；不要随意改已被智能体使用的 name。"],
+            ["display_name", "前端显示名称", "改显示名不等于改 model；可用于给业务人员更易懂的名字。"],
+            ["use", "适配器，例如 langchain_openai:ChatOpenAI", "适配器与接口协议不匹配会导致初始化失败。"],
+            ["model", "模型服务商要求的真实 ID", "误填显示名经常造成 404 model not found。"],
+            ["api_key", "使用 $变量名 从 backend.env 读取密钥", "写明文、变量拼错或漏掉 $ 都会导致鉴权失败。"],
+            ["base_url", "接口基地址", "有的服务要求 /v1，有的路径已包含 /v1；以服务商接口文档为准。"],
+            ["request_timeout / max_retries", "单次等待时间与失败重试次数", "超时不等于模型不存在，先检查服务和网络。"],
+            ["max_tokens", "单次生成输出上限", "不是输入+输出总上下文窗口，不能超过服务商允许的最大输出。"],
+        ],
+        [1850, 2850, 4660],
+        font_size=8.45,
+    )
+    b.add_h2(doc, "2.3 如何添加或调整 max_tokens")
+    b.add_para(doc, "在目标模型条目中添加或修改 max_tokens: <整数>。它控制单次回答最多生成多少 token。回答被截断时可在服务商允许范围内逐步增加；成本或响应时间异常时应适度降低。")
+    b.add_table(
+        doc,
+        ["现象", "判断", "处理"],
+        [
+            ["回答结尾被截断", "max_tokens 太小，或服务端提前结束", "先查看 finish_reason；确认服务商上限后逐步提高。"],
+            ["400 invalid max_tokens", "超过模型限制或字段不兼容", "按服务商模型上限修改；必要时删除该字段验证兼容性。"],
+            ["长文本仍失败", "上下文不足，不只是输出上限", "缩短输入、启用摘要或选择更大上下文模型。"],
+            ["费用/耗时异常", "输出限制过高或提示词过长", "降低 max_tokens；优化提示词和业务限流。"],
+        ],
+        [2000, 3000, 4360],
+        font_size=8.9,
+    )
+    b.add_h2(doc, "2.4 后端模型变更后的验收")
+    for text in [
+        "YAML 使用空格缩进，不能使用 Tab；密钥变量名必须同时存在于 backend.env 和 config.yaml。",
+        "修改 backend.env 后必须使用 docker compose up -d --force-recreate backend；普通 restart 不会重新读取环境文件。",
+        "只修改 config.yaml 时可重启 backend，但仍应查看日志确认配置解析成功。",
+        "先进行短问答验证，再验证长文本、工具调用、视觉输入或思考模式（如果该模型声明支持）。",
+        "记录模型 name、服务地址、变更人、验证时间；不要把 API Key 写入变更单或截图。",
+    ]:
+        b.add_bullet(doc, text)
+
+
+def add_chapter_config(doc, diagrams):
+    b.add_h1(doc, "3. .env、backend.env、数据库与前端接口地址")
+    b.add_para(doc, "部署目录的运行配置分为三类：.env 控制 Compose 与对外端口；backend.env 保存后端密钥和连接串；config.yaml 定义模型、登录、数据库模式等；runtime-config.js 控制前端运行时接口地址。不要进入容器直接改文件。")
+    b.add_figure(doc, diagrams["config_layers"], "图 3-1 配置分层与生效方式", "部署层、后端层、前端运行时层和管理页面配置的关系", width=6.35)
+    heading = b.add_h2(doc, "3.1 .env：项目名、镜像标签、访问端口")
+    heading.paragraph_format.page_break_before = True
+    b.add_code(doc, """
+    # 部署目录 .env
+    COMPOSE_PROJECT_NAME=deerflow
+    DEERFLOW_TAG=<当前镜像包对应标签>
+    APP_PORT=8090
+    TZ=Asia/Shanghai
+    """, "ENV")
+    b.add_table(
+        doc,
+        ["变量", "作用", "修改后的操作"],
+        [
+            ["COMPOSE_PROJECT_NAME", "Compose 项目名称，用于隔离容器、网络和卷名称", "确认未与其他项目冲突；通常不在运行中随意修改。"],
+            ["DEERFLOW_TAG", "docker-compose.yml 使用的镜像标签", "应与已导入镜像的标签一致；镜像升级时核对交付清单和 SHA256。"],
+            ["APP_PORT", "用户访问 Web/Nginx 的宿主机端口", "修改后执行 docker compose up -d --force-recreate web；确认新端口开放。"],
+            ["TZ", "容器日志和页面显示时区", "重建受影响容器后生效。"],
+        ],
+        [1900, 3600, 3860],
+        font_size=8.85,
+    )
+    b.add_h2(doc, "3.2 backend.env：JWT、模型密钥和数据库连接")
+    b.add_code(doc, """
+    # config/backend.env
+    AUTH_JWT_SECRET=<至少32字节的随机值>
+    INTRANET_MODEL_API_KEY=<模型服务密钥>
+    MYSQL_DATABASE_URL=mysql+asyncmy://<USER>:<URL_ENCODED_PASSWORD>@<HOST>:3306/<DB>?charset=utf8mb4
+    """, "ENV")
+    b.add_callout(doc, "密钥规则", "AUTH_JWT_SECRET 是签发登录令牌的服务端密钥，不是用户登录密码。修改它会让所有已登录会话失效。backend.env 的任何改动都要强制重建 backend 才会重新读取。", "warn")
+    b.add_h2(doc, "3.3 config.yaml：登录密码与数据库模式")
+    b.add_code(doc, """
+    # config/config.yaml（示意；保留现有其他配置）
+    auth_login:
+      username_login:
+        enabled: true
+
+    database:
+      backend: mysql  # 使用默认文件数据库时为 sqlite
+      mysql_url: $MYSQL_DATABASE_URL
+    """, "YAML")
+    b.add_para(doc, "用户名登录的共享密码或账号管理项应遵循当前 config.yaml 的 auth_login 配置；单个用户的 login_password、system_role 和资产所有权以应用用户管理/数据库记录为准。不要把用户密码与 AUTH_JWT_SECRET 混为一谈。")
+    b.add_h2(doc, "3.4 切换或排查外部 MySQL")
+    b.add_number(doc, "冻结可能影响资产写入的操作，完整备份 data/backend、当前配置和现有数据库。")
+    b.add_number(doc, "创建数据库和最小权限账号，确认字符集 utf8mb4，并允许容器所在网络访问。")
+    b.add_number(doc, "密码中 @、:、/、#、% 等字符需要 URL 编码；HOST 必须是容器能访问的地址，不能把容器内 127.0.0.1 当成外部数据库。")
+    b.add_number(doc, "同时更新 backend.env 的 MYSQL_DATABASE_URL 与 config.yaml 的 database.backend/mysql_url，强制重建 backend 并持续查看迁移日志。")
+    b.add_number(doc, "分别用管理员、lqq 和普通用户验证登录、技能、智能体、菜单、敏感词和发布状态。SQLite 与 MySQL 不会自动双向同步。")
+    b.add_h2(doc, "3.5 前端接口地址与端口")
+    b.add_code(doc, """
+    // config/runtime-config.js：推荐同源相对路径
+    window.__DEERFLOW_RUNTIME_CONFIG__ = {
+      VITE_BACKEND_BASE_URL: "/deerflow",
+      VITE_LANGGRAPH_BASE_URL: "/deerflow/api",
+      VITE_AIPI_BASE_URL: "<可选的业务接口地址>",
+    };
+    """, "JavaScript")
+    b.add_para(doc, "推荐保持相对路径。浏览器会自动访问当前域名和 APP_PORT，再由 Nginx 转到 backend:8001，这样最少遇到 CORS、证书与混合内容问题。确需使用独立后端域名时，应同步配置允许 Origin 和 HTTPS。")
+    b.add_code(doc, """
+    # 修改前端端口或运行时配置后的推荐操作
+    sudo docker compose up -d --force-recreate web
+    sudo docker compose ps
+    sudo docker compose logs --tail=200 web
+    # 浏览器使用 Ctrl+F5；在 Network 检查 runtime-config.js 和 /deerflow/health
+    """, "Shell")
+
+
+def add_chapter_assets(doc, diagrams):
+    b.add_h1(doc, "4. 技能与智能体：放置、发布、丢失排查")
+    b.add_para(doc, "技能和智能体能否在页面出现，取决于文件、数据库元数据、当前登录身份、发布状态和目录挂载是否一致。优先在前端创建/上传；仅在批量迁移或前端不可用时手工导入。")
+    b.add_figure(doc, diagrams["persistence_map"], "图 4-1 技能和智能体的持久化关系", "技能文件、智能体文件、业务数据库和运行时缓存共同决定资产可见性", width=6.35)
+    heading = b.add_h2(doc, "4.1 技能放在哪里")
+    heading.paragraph_format.page_break_before = True
+    b.add_code(doc, """
+    data/skills/
+    ├── public/
+    │   └── <skill-id>/
+    │       ├── SKILL.md
+    │       ├── scripts/          # 可选
+    │       ├── references/       # 可选
+    │       └── assets/           # 可选
+    └── custom/
+        └── <skill-id>/
+            └── SKILL.md
+    """, "目录结构")
+    b.add_table(
+        doc,
+        ["目录", "含义", "注意"],
+        [
+            ["data/skills/public", "系统共享/公共技能文件分类", "放入 public 不等于已发布到广场；仍需有正确元数据、权限和发布状态。"],
+            ["data/skills/custom", "用户自定义技能目录", "适合从前端创建或上传的技能；应保留完整目录而不是只复制一个文件。"],
+            ["SKILL.md", "技能说明、使用条件、操作规范的核心文件", "避免写入真实 API Key、数据库密码、内网敏感地址或个人信息。"],
+            ["scripts/references/assets", "脚本、参考资料和附件", "脚本必须可执行且依赖完整；上传前检查许可证、体积和敏感信息。"],
+        ],
+        [2200, 2800, 4360],
+        font_size=8.7,
+    )
+    b.add_h2(doc, "4.2 智能体放在哪里")
+    b.add_code(doc, """
+    data/backend/agents/<agent-id>/
+    ├── config.yaml    # 模型、工具、技能、行为参数
+    └── SOUL.md        # 角色、提示词、表达和规则
+    """, "目录结构")
+    b.add_para(doc, "智能体文件只是一部分。名称、所有者、可见性、广场和发布状态等业务元数据通常在 SQLite 或 MySQL 中。因此恢复或迁移智能体时，必须同时备份/恢复 data/backend 与对应数据库。")
+    b.add_h2(doc, "4.3 推荐的创建、上传和发布流程")
+    b.add_figure(doc, diagrams["publish_flow"], "图 4-2 从创建到发布广场", "在界面创建、验证、发布、权限校验直至生效的流程", width=6.35)
+    for text in [
+        "使用普通业务用户或管理员进入技能管理/智能体管理，创建或上传资产并填写名称、说明、依赖和使用范围。",
+        "完成本地实际验证：技能要验证工具调用、脚本依赖和文件权限；智能体要验证所选模型、技能/工具和首轮问答。",
+        "在资产详情或卡片中点击“发布”，选择一个启用的目标广场。资产所有者或 admin 才能发布/下架。",
+        "发布后用普通用户验证广场可见性；重新发布到其他广场通常是迁移，不是多份复制。",
+        "若只需要个人使用，保持私有或不发布；不要通过手工复制文件代替发布流程。",
+    ]:
+        b.add_number(doc, text)
+    b.add_h2(doc, "4.4 手工导入时的安全做法")
+    b.add_code(doc, """
+    # 示例：先将完整技能目录复制到 custom，再确认容器内可见
+    sudo mkdir -p data/skills/custom/<skill-id>
+    # 将经过审核的文件复制到上面的目录后执行：
+    sudo docker compose exec backend sh -lc 'find /app/backend/skills/custom -maxdepth 3 -type f -print'
+    sudo docker compose restart backend
+    """, "Shell")
+    b.add_callout(doc, "手工导入后的边界", "手工复制只解决文件存在的问题，不会自动补齐所有者、可见性或发布元数据。导入后应通过界面核对资产记录；若无记录，按应用支持流程创建或恢复元数据。", "warn")
+    b.add_h2(doc, "4.5 发布按钮或广场不可用")
+    b.add_table(
+        doc,
+        ["问题", "检查项", "处理"],
+        [
+            ["看不到“发布”按钮", "当前用户是否资产所有者或 admin", "切换到所有者/admin；不要只凭文件目录判断权限。"],
+            ["选择不到广场", "广场是否启用、是否存在默认/私有范围限制", "由 admin 在发布广场管理中启用或创建目标广场。"],
+            ["发布后普通用户看不到", "广场、私有状态、筛选、缓存和角色", "确认实际发布到哪个广场；退出重登并清除筛选；检查发布 API 401/403。"],
+            ["智能体能看见但模型不可用", "config.yaml 中模型 name 是否仍存在", "恢复同名模型条目或将智能体改到已验证模型后重启 backend。"],
+        ],
+        [2200, 3000, 4160],
+        font_size=8.7,
+    )
+    b.add_h2(doc, "4.6 技能或智能体“丢失”专项排查")
+    b.add_figure(doc, diagrams["lost_asset_flow"], "图 4-3 资产丢失排查顺序", "从服务目录、身份、挂载、数据库、过滤到恢复验证的排查流程", width=6.35)
+    b.add_number(doc, "确认当前部署目录和服务：执行 pwd、docker compose ps，排除在旧目录启动了另一套服务。")
+    b.add_number(doc, "确认登录身份：重新登录，核对用户名、system_role、资产所有者和是否处于独立会话/嵌入会话。")
+    b.add_number(doc, "同时检查宿主机和容器内文件。宿主机有而容器没有，重点检查 docker-compose.yml 的 volume 映射与当前工作目录。")
+    b.add_code(doc, """
+    find data/skills -maxdepth 3 -type f -print | sort
+    find data/backend/agents -maxdepth 3 -type f -print | sort
+    sudo docker compose exec backend sh -lc 'find /app/backend/skills -maxdepth 3 -type f -print | sort'
+    sudo docker compose exec backend sh -lc 'find /app/backend/.deer-flow/agents -maxdepth 3 -type f -print | sort'
+    """, "Shell")
+    b.add_number(doc, "确认数据库未切换：查看 config.yaml 的 database.backend 和 backend.env 的 MYSQL_DATABASE_URL。切换数据库不会自动搬迁或同步资产记录。")
+    b.add_number(doc, "检查过滤、广场和权限：清除搜索条件，切换“我的/公共/已发布/私有”等视图，并用 admin 核验发布记录。")
+    b.add_number(doc, "查看 backend 日志。文件和数据库都缺失时，停止写入，从备份恢复；重启 backend、重新登录并实际调用验证。")
+
+
+def add_chapter_ui(doc, diagrams):
+    b.add_h1(doc, "5. 前端管理：菜单名称、敏感词、主题与账号")
+    b.add_para(doc, "菜单、主题、敏感词和广场主要通过应用管理页面维护，属于数据库中的全局设置。保存后通常立即生效，但应使用管理员和普通用户分别验证。")
+    b.add_figure(doc, diagrams["ui_map"], "图 5-1 常用管理入口", "菜单、外观、技能、智能体和用户管理入口关系", width=6.35)
+    b.add_h2(doc, "5.1 配置菜单名称、排序和隐藏")
+    b.add_number(doc, "使用 system_role=admin 的 DeerFlow 管理员登录，打开左下角“设置和更多”中的“菜单管理”。")
+    b.add_number(doc, "找到目标一级、二级或三级菜单，修改显示名称 label、启用状态、排序或父级；保存后刷新页面验证。")
+    b.add_number(doc, "菜单停用会隐藏该节点及其子树；修改名称不要改真实 path、路由 ID 或代码常量。")
+    b.add_number(doc, "用普通用户检查左侧菜单、顶部导航和直接访问链接；记录修改前名称、目的和回退方式。")
+    b.add_callout(doc, "安全边界", "隐藏菜单只移除导航入口，不等于阻止用户通过已知 URL 或 API 访问。真正禁用功能还需后端 API 权限、路由守卫和角色权限共同生效。", "danger")
+    b.add_h2(doc, "5.2 配置敏感词：必须用哪个用户")
+    b.add_para(doc, "敏感词功能是“展示层脱敏映射”：原始词 -> 替换词。它不会修改数据库里的原文，也不会改变 URL、路由 path 或节点 ID。")
+    b.add_callout(doc, "登录要求", "敏感词管理前端入口、路由守卫和页面级校验都要求当前显示用户名严格等于 lqq。即使 admin 拥有后端写权限，也应使用 lqq 登录来维护页面。邮箱账号时，@ 前缀必须为 lqq。", "warn")
+    b.add_number(doc, "用 lqq 登录，进入“设置和更多 -> 敏感词管理”。")
+    b.add_number(doc, "新增原始词与替换词，设置启用状态；需要初始规则时可使用“导入种子词”合并缺失映射。")
+    b.add_number(doc, "保存的是整套规则；修改前先导出/截图并经业务确认，避免替换词冲突或过度脱敏。")
+    b.add_number(doc, "刷新页面，检查菜单、导航、标题和普通内容的显示；用普通用户复核最终效果。")
+    b.add_h2(doc, "5.3 主题色、布局和嵌入页面")
+    b.add_table(
+        doc,
+        ["配置目标", "操作入口/变量", "验证"],
+        [
+            ["个人主题", "设置 -> 外观，用户自己的选择通常优先", "新开页面检查浅/深主题、文字对比度和焦点状态。"],
+            ["系统默认与主题库", "admin 在外观设置中配置默认主题、主题名称、主色和启用状态", "用没有个人覆盖的新测试用户验证。"],
+            ["强制紧凑侧边栏", "runtime-config.js 的 VITE_FORCE_COLLAPSED_SIDEBAR", "重启 web 并刷新浏览器后检查导航。"],
+            ["iframe 嵌入", "URL 参数 embed=1、theme=...、hideJump=1、isolate=1", "在嵌入页验证无全局导航、主题和独立会话行为。"],
+        ],
+        [2200, 3500, 3660],
+        font_size=8.7,
+    )
+    b.add_callout(doc, "主题验收", "不仅看按钮颜色。还要检查正文、表格、弹窗、下拉框、禁用、hover、focus、错误和成功状态的对比度；不要用品牌主色铺满大面积背景。", "note")
+    heading = b.add_h2(doc, "5.4 必备账号与角色")
+    heading.paragraph_format.page_break_before = True
+    b.add_table(
+        doc,
+        ["账号类型", "至少准备", "主要用途", "注意"],
+        [
+            ["DeerFlow admin", "2 个", "菜单、主题、广场、用户和全局资产管理", "system_role 必须为 admin；保留一个应急管理员。"],
+            ["lqq", "1 个", "敏感词管理前端入口", "显示用户名/邮箱前缀必须严格为 lqq。"],
+            ["普通测试用户", "1 个", "验收菜单隐藏、资产可见性和广场发布", "不能只用管理员验收，管理员会掩盖权限问题。"],
+            ["模型/数据库服务账号", "按环境", "调用外部服务", "遵循最小权限和定期轮换，不与个人账号共用。"],
+        ],
+        [2100, 1250, 3300, 2710],
+        font_size=8.65,
+    )
+
+
+def add_chapter_operations(doc):
+    b.add_h1(doc, "6. 日常启停、日志和健康检查")
+    b.add_para(doc, "一键脚本和 Docker Compose 命令都应从部署目录运行。日常 restart 适合重启进程；任何环境变量文件改动都必须通过 force-recreate 重建受影响容器。")
+    b.add_h2(doc, "6.1 常用命令速查")
+    b.add_code(doc, """
+    # 整套服务
+    sudo bash restart.sh
+    sudo bash stop.sh
+    sudo bash logs.sh
+    sudo bash diagnose.sh
+
+    # 只处理后端或前端
+    sudo docker compose restart backend
+    sudo docker compose up -d --force-recreate backend   # backend.env 改动后
+    sudo docker compose restart web
+    sudo docker compose up -d --force-recreate web       # .env 的 APP_PORT / Web 配置改动后
+    sudo docker compose ps
+    """, "Shell")
+    b.add_h2(doc, "6.2 如何打印日志")
+    b.add_code(doc, """
+    # 全部服务日志；Ctrl+C 仅停止跟踪，不停止服务
+    sudo bash logs.sh
+
+    # 只看后端或 Web/Nginx
+    sudo bash logs.sh backend
+    sudo bash logs.sh web
+
+    # Compose 原生命令：最后 500 行并持续跟踪
+    sudo docker compose logs --tail=500 -f backend
+    sudo docker compose logs --tail=500 -f web
+    """, "Shell")
+    b.add_h2(doc, "6.3 健康检查和变更后验收")
+    b.add_code(doc, """
+    curl -fsS http://127.0.0.1:<APP_PORT>/deerflow/health
+    curl -I http://127.0.0.1:<APP_PORT>/
+    sudo docker compose ps
+    """, "Shell")
+    for text in [
+        "容器 Up 不等于业务可用：健康接口成功后仍要登录一次、发起一次对话并验证修改的功能。",
+        "backend.env、.env 改动：force-recreate；config.yaml 改动：至少 restart backend；runtime-config.js 改动：重启 web 并强制刷新浏览器。",
+        "变更完成后继续观察后端日志至少 5 分钟，确认没有反复重启、401/429/500、数据库错误或模型初始化失败。",
+    ]:
+        b.add_bullet(doc, text)
+
+
+def add_chapter_backup(doc):
+    b.add_h1(doc, "7. 数据库、备份、恢复与升级")
+    b.add_para(doc, "一次可恢复的备份至少包含 config、data 和当前业务数据库。只保存 Docker 镜像无法恢复用户、技能、智能体、发布广场、菜单、主题与敏感词。外部 MySQL 必须单独导出。")
+    b.add_h2(doc, "7.1 必须备份的对象")
+    b.add_table(
+        doc,
+        ["对象", "作用", "建议频率", "恢复价值"],
+        [
+            ["config 与 .env", "模型、登录、数据库、接口地址和运行配置", "每次变更后", "恢复服务连接和端口配置。"],
+            ["data/backend", "文件数据库、智能体文件及运行数据", "每日 + 变更前", "恢复智能体、用户和运行相关资产。"],
+            ["data/skills", "public/custom 技能文件和附件", "每日 + 技能变更后", "恢复技能内容和脚本。"],
+            ["data/knowledge", "知识库文件", "按使用频率", "恢复知识资产。"],
+            ["外部 MySQL dump", "资产元数据、用户、菜单、主题、广场等", "每日 + 变更前", "恢复数据库层资产与全局设置。"],
+        ],
+        [1900, 3150, 1850, 2460],
+        font_size=8.5,
+    )
+    b.add_h2(doc, "7.2 文件和数据库备份示例")
+    b.add_code(doc, """
+    # 文件备份：确保备份目录位于独立存储，不在当前 data 内
+    cd <部署目录>
+    sudo tar -czf <备份目录>/deerflow-files-$(date +%F-%H%M).tar.gz .env config data
+    sha256sum <备份目录>/deerflow-files-*.tar.gz
+
+    # MySQL 备份：密码不要直接写到命令历史，优先使用受控 defaults-extra-file
+    mysqldump --single-transaction --routines --triggers \
+      -h <MYSQL_HOST> -u <BACKUP_USER> <DB_NAME> > <备份目录>/deerflow-mysql-$(date +%F-%H%M).sql
+    """, "Shell")
+    b.add_h2(doc, "7.3 恢复与升级原则")
+    for text in [
+        "恢复前先确认备份版本、SHA256、数据模式和目标目录；停止或冻结写入，避免恢复过程中产生新分叉数据。",
+        "先恢复到隔离或测试环境验证，再进行正式切换；恢复后检查目录权限、数据库连接、健康接口、登录、模型、技能、智能体和广场。",
+        "升级时保留旧镜像、旧配置和完整备份；新版本使用独立测试端口验证，确认无误再切换。",
+        "SQLite 与 MySQL 的资产数据不会自动双向同步。任何切换、迁移或恢复都要有明确来源和一次性合并计划。",
+    ]:
+        b.add_bullet(doc, text)
+    b.add_callout(doc, "高风险操作", "删除部署目录、删除 data、覆盖未知数据库、docker system prune -a 和递归修改所有者都可能造成不可逆损失。执行前必须明确目标、验证备份可用并获得审批。", "danger")
+
+
+def add_chapter_security_handover(doc):
+    b.add_h1(doc, "8. 巡检、安全与交接")
+    b.add_h2(doc, "8.1 每日与每周巡检")
+    b.add_table(
+        doc,
+        ["频率", "检查内容", "合格标准"],
+        [
+            ["每日", "docker compose ps、/deerflow/health、磁盘/inode、backend/web 日志", "服务正常、无重启循环、无连续 5xx/401/429、空间充足。"],
+            ["每周", "备份是否完成、最近恢复演练、模型配额与超时、资产发布与权限变更", "备份可校验；高频失败有负责人；变更有记录。"],
+            ["每次变更后", "端口、日志、健康、登录、实际业务功能、普通用户权限", "功能验收通过且可回退。"],
+        ],
+        [1500, 3900, 3960],
+        font_size=8.75,
+    )
+    b.add_h2(doc, "8.2 最低安全要求")
+    for text in [
+        "AUTH_JWT_SECRET、模型 API Key、数据库 URL/密码只保存在受控的 backend.env 或密钥系统中，不进入 Git、截图、聊天记录和前端 runtime-config.js。",
+        "管理员、lqq、普通测试用户和服务账号分开管理；定期轮换密码/密钥，离职或交接时立即回收不再需要的权限。",
+        "对外只开放必要的 APP_PORT；后端 8001 默认不直接暴露。数据库地址、模型服务和业务接口应采用最小网络范围。",
+        "对外发送日志前删除 Authorization、Cookie、Token、API Key、数据库 URL、手机号和身份信息，只保留时间、状态码、trace ID 与关键报错。",
+    ]:
+        b.add_bullet(doc, text)
+    b.add_h2(doc, "8.3 交接清单")
+    b.add_table(
+        doc,
+        ["项目", "交接时填写"],
+        [
+            ["生产访问地址 / APP_PORT", ""],
+            ["当前部署目录与 Compose 项目名", ""],
+            ["镜像版本 / SHA256", ""],
+            ["数据库模式、地址与库名（不写密码）", ""],
+            ["DeerFlow admin、lqq、普通测试用户责任人", ""],
+            ["模型服务与密钥保管责任人", ""],
+            ["备份位置、保留期与最近恢复演练日期", ""],
+            ["监控、告警和问题升级联系人", ""],
+        ],
+        [3500, 5860],
+        font_size=9.1,
+    )
+
+
+def add_appendices(doc):
+    b.add_h1(doc, "附录 A：最短命令清单")
+    b.add_code(doc, """
+    cd <部署目录>
+    sudo docker compose ps
+    sudo docker compose logs --tail=500 -f backend
+    sudo docker compose logs --tail=500 -f web
+    sudo docker compose restart backend
+    sudo docker compose up -d --force-recreate backend
+    sudo docker compose restart web
+    sudo docker compose up -d --force-recreate web
+    curl -fsS http://127.0.0.1:<APP_PORT>/deerflow/health
+    """, "Shell")
+    heading = b.add_h1(doc, "附录 B：问题升级信息模板")
+    heading.paragraph_format.page_break_before = False
+    b.add_code(doc, """
+    【问题标题】
+    【发生时间】YYYY-MM-DD HH:mm:ss（时区）
+    【访问地址/端口】<不含密码>
+    【当前账号角色】admin / lqq / 普通用户（不要提供密码）
+    【操作步骤】1... 2... 3...
+    【实际现象】
+    【期望结果】
+    【HTTP 状态码 / trace ID】
+    【容器状态】docker compose ps
+    【已脱敏日志】backend/web 最近 200 行
+    【最近变更】模型、数据库、菜单、主题、镜像或配置
+    【已采取动作】以及结果
+    """, "故障单模板")
+    heading = b.add_h1(doc, "附录 C：核心事实速记")
+    heading.paragraph_format.page_break_before = True
+    b.add_table(
+        doc,
+        ["主题", "结论"],
+        [
+            ["前端和后端端口", "容器内部不同：Web 80、Backend 8001；用户通常经由 APP_PORT 访问 Web。"],
+            ["配置文件", ".env 管端口/Compose；backend.env 管密钥和连接串；config.yaml 管模型/登录/数据库；runtime-config.js 管前端地址。"],
+            ["环境变量生效", "backend.env 或 .env 改动后必须 force-recreate 受影响容器；普通 restart 不会重新读取。"],
+            ["模型与 max_tokens", "模型条目在 config.yaml；Key 在 backend.env；max_tokens 是单次输出上限，不是上下文窗口。"],
+            ["技能位置", "data/skills/public 与 data/skills/custom；目录文件存在不等于已经发布。"],
+            ["智能体位置", "data/backend/agents/<agent-id>；还依赖数据库元数据、所有者、可见性和发布状态。"],
+            ["敏感词用户", "页面维护需要显示用户名严格为 lqq；admin 不能替代该前端入口条件。"],
+            ["菜单隐藏", "只隐藏导航入口，不等于禁止直接 URL 或 API，需要后端权限配合。"],
+            ["资产丢失", "先查目录、挂载、数据库、身份、过滤和日志，最后才恢复；不要急着创建同名资产。"],
+            ["完整备份", "config + data + 外部 MySQL dump + 镜像版本/SHA256；只备份镜像不足以恢复业务资产。"],
+        ],
+        [3100, 6260],
+        font_size=8.7,
+    )
+
+
+def build_document(diagrams):
+    doc = b.Document()
+    b.configure_document(doc)
+    set_running_furniture(doc)
+    doc.core_properties.title = "DeerFlow 系统运维手册（用户重点版）"
+    doc.core_properties.subject = "DeerFlow 常见报错、模型、配置、技能、智能体、前端管理与恢复"
+    doc.core_properties.author = "DeerFlow 运维团队"
+    doc.core_properties.keywords = "DeerFlow, 运维, Docker, config.yaml, 技能, 智能体"
+    add_cover(doc, diagrams)
+    add_navigation(doc)
+    add_chapter_common_errors(doc)
+    add_chapter_model(doc, diagrams)
+    add_chapter_config(doc, diagrams)
+    add_chapter_assets(doc, diagrams)
+    add_chapter_ui(doc, diagrams)
+    add_chapter_operations(doc)
+    add_chapter_backup(doc)
+    add_chapter_security_handover(doc)
+    add_appendices(doc)
+    doc.save(OUT)
+    return OUT
+
+
+if __name__ == "__main__":
+    b.ensure_dirs()
+    diagrams = b.make_diagrams()
+    print(build_document(diagrams))
diff --git a/tmp/maintenance-manual/make_contact_sheets.py b/tmp/maintenance-manual/make_contact_sheets.py
new file mode 100644
index 00000000..33e9acc1
--- /dev/null
+++ b/tmp/maintenance-manual/make_contact_sheets.py
@@ -0,0 +1,33 @@
+from pathlib import Path
+
+from PIL import Image, ImageDraw, ImageFont
+
+
+ROOT = Path(__file__).resolve().parent
+PAGES = ROOT / "rendered" / "pages"
+OUT = ROOT / "rendered" / "contact-sheets"
+OUT.mkdir(parents=True, exist_ok=True)
+
+font_path = Path(r"C:\Windows\Fonts\arialbd.ttf")
+font = ImageFont.truetype(str(font_path), 28)
+page_paths = sorted(PAGES.glob("page-*.png"))
+
+for sheet_index in range(0, len(page_paths), 4):
+    group = page_paths[sheet_index : sheet_index + 4]
+    images = [Image.open(p).convert("RGB") for p in group]
+    page_w, page_h = images[0].size
+    gutter = 48
+    label_h = 52
+    sheet = Image.new("RGB", (page_w * 2 + gutter * 3, (page_h + label_h) * 2 + gutter * 3), "#D7DEE5")
+    draw = ImageDraw.Draw(sheet)
+    for i, (path, img) in enumerate(zip(group, images)):
+        col, row = i % 2, i // 2
+        x = gutter + col * (page_w + gutter)
+        y = gutter + row * (page_h + label_h + gutter)
+        draw.text((x, y), path.stem, font=font, fill="#172A3A")
+        sheet.paste(img, (x, y + label_h))
+    first = sheet_index + 1
+    last = sheet_index + len(group)
+    sheet.save(OUT / f"pages-{first:02d}-{last:02d}.jpg", quality=92, subsampling=0)
+
+print(f"created {len(list(OUT.glob('*.jpg')))} contact sheets")
diff --git a/tmp/maintenance-manual/make_contact_sheets_user.py b/tmp/maintenance-manual/make_contact_sheets_user.py
new file mode 100644
index 00000000..26e0b4d9
--- /dev/null
+++ b/tmp/maintenance-manual/make_contact_sheets_user.py
@@ -0,0 +1,30 @@
+from pathlib import Path
+
+from PIL import Image, ImageDraw, ImageFont
+
+
+ROOT = Path(__file__).resolve().parent / "rendered-user"
+PAGES = ROOT / "pages"
+OUT = ROOT / "contact-sheets"
+OUT.mkdir(parents=True, exist_ok=True)
+
+font = ImageFont.truetype(r"C:\Windows\Fonts\arialbd.ttf", 28)
+page_paths = sorted(PAGES.glob("page-*.png"))
+
+for sheet_index in range(0, len(page_paths), 4):
+    group = page_paths[sheet_index:sheet_index + 4]
+    images = [Image.open(path).convert("RGB") for path in group]
+    page_w, page_h = images[0].size
+    gutter, label_h = 48, 52
+    sheet = Image.new("RGB", (page_w * 2 + gutter * 3, (page_h + label_h) * 2 + gutter * 3), "#D7DEE5")
+    draw = ImageDraw.Draw(sheet)
+    for index, (path, image) in enumerate(zip(group, images)):
+        col, row = index % 2, index // 2
+        x = gutter + col * (page_w + gutter)
+        y = gutter + row * (page_h + label_h + gutter)
+        draw.text((x, y), path.stem, font=font, fill="#172A3A")
+        sheet.paste(image, (x, y + label_h))
+    first, last = sheet_index + 1, sheet_index + len(group)
+    sheet.save(OUT / f"pages-{first:02d}-{last:02d}.jpg", quality=92, subsampling=0)
+
+print(f"created {len(list(OUT.glob('*.jpg')))} contact sheets")
diff --git a/tmp/maintenance-manual/render_with_word.ps1 b/tmp/maintenance-manual/render_with_word.ps1
new file mode 100644
index 00000000..3c08676f
--- /dev/null
+++ b/tmp/maintenance-manual/render_with_word.ps1
@@ -0,0 +1,38 @@
+param(
+    [Parameter(Mandatory = $true)][string]$InputDocx,
+    [Parameter(Mandatory = $true)][string]$OutputPdf
+)
+
+$ErrorActionPreference = 'Stop'
+$word = $null
+$doc = $null
+try {
+    $inputPath = (Resolve-Path -LiteralPath $InputDocx).Path
+    $outputPath = [System.IO.Path]::GetFullPath($OutputPdf)
+    $outputDir = [System.IO.Path]::GetDirectoryName($outputPath)
+    [System.IO.Directory]::CreateDirectory($outputDir) | Out-Null
+
+    $word = New-Object -ComObject Word.Application
+    $word.Visible = $false
+    $word.DisplayAlerts = 0
+    $doc = $word.Documents.Open($inputPath, $false, $false)
+
+    foreach ($toc in $doc.TablesOfContents) {
+        $toc.Update() | Out-Null
+    }
+    $doc.Fields.Update() | Out-Null
+    $doc.Save()
+    $doc.ExportAsFixedFormat($outputPath, 17)
+}
+finally {
+    if ($null -ne $doc) {
+        $doc.Close(0)
+        [void][System.Runtime.InteropServices.Marshal]::ReleaseComObject($doc)
+    }
+    if ($null -ne $word) {
+        $word.Quit()
+        [void][System.Runtime.InteropServices.Marshal]::ReleaseComObject($word)
+    }
+    [GC]::Collect()
+    [GC]::WaitForPendingFinalizers()
+}
diff --git a/tmp/maintenance-manual/rendered-user/DeerFlow系统运维手册-用户重点版.pdf b/tmp/maintenance-manual/rendered-user/DeerFlow系统运维手册-用户重点版.pdf
new file mode 100644
index 00000000..266c1046
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/DeerFlow系统运维手册-用户重点版.pdf differ
diff --git a/tmp/maintenance-manual/rendered-user/contact-sheets/pages-01-04.jpg b/tmp/maintenance-manual/rendered-user/contact-sheets/pages-01-04.jpg
new file mode 100644
index 00000000..607efdef
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/contact-sheets/pages-01-04.jpg differ
diff --git a/tmp/maintenance-manual/rendered-user/contact-sheets/pages-05-08.jpg b/tmp/maintenance-manual/rendered-user/contact-sheets/pages-05-08.jpg
new file mode 100644
index 00000000..4a01f0e3
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/contact-sheets/pages-05-08.jpg differ
diff --git a/tmp/maintenance-manual/rendered-user/contact-sheets/pages-09-12.jpg b/tmp/maintenance-manual/rendered-user/contact-sheets/pages-09-12.jpg
new file mode 100644
index 00000000..94f18241
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/contact-sheets/pages-09-12.jpg differ
diff --git a/tmp/maintenance-manual/rendered-user/contact-sheets/pages-13-16.jpg b/tmp/maintenance-manual/rendered-user/contact-sheets/pages-13-16.jpg
new file mode 100644
index 00000000..f9a3ab5e
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/contact-sheets/pages-13-16.jpg differ
diff --git a/tmp/maintenance-manual/rendered-user/contact-sheets/pages-17-20.jpg b/tmp/maintenance-manual/rendered-user/contact-sheets/pages-17-20.jpg
new file mode 100644
index 00000000..048a7847
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/contact-sheets/pages-17-20.jpg differ
diff --git a/tmp/maintenance-manual/rendered-user/contact-sheets/pages-21-24.jpg b/tmp/maintenance-manual/rendered-user/contact-sheets/pages-21-24.jpg
new file mode 100644
index 00000000..744e97dc
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/contact-sheets/pages-21-24.jpg differ
diff --git a/tmp/maintenance-manual/rendered-user/contact-sheets/pages-25-28.jpg b/tmp/maintenance-manual/rendered-user/contact-sheets/pages-25-28.jpg
new file mode 100644
index 00000000..97c39dc5
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/contact-sheets/pages-25-28.jpg differ
diff --git a/tmp/maintenance-manual/rendered-user/manual-user.pdf b/tmp/maintenance-manual/rendered-user/manual-user.pdf
new file mode 100644
index 00000000..266c1046
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/manual-user.pdf differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-01.png b/tmp/maintenance-manual/rendered-user/pages/page-01.png
new file mode 100644
index 00000000..34d3f502
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-01.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-02.png b/tmp/maintenance-manual/rendered-user/pages/page-02.png
new file mode 100644
index 00000000..c2b07bbc
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-02.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-03.png b/tmp/maintenance-manual/rendered-user/pages/page-03.png
new file mode 100644
index 00000000..206b4f77
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-03.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-04.png b/tmp/maintenance-manual/rendered-user/pages/page-04.png
new file mode 100644
index 00000000..044848cd
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-04.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-05.png b/tmp/maintenance-manual/rendered-user/pages/page-05.png
new file mode 100644
index 00000000..3e3099d9
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-05.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-06.png b/tmp/maintenance-manual/rendered-user/pages/page-06.png
new file mode 100644
index 00000000..acdea899
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-06.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-07.png b/tmp/maintenance-manual/rendered-user/pages/page-07.png
new file mode 100644
index 00000000..02621c54
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-07.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-08.png b/tmp/maintenance-manual/rendered-user/pages/page-08.png
new file mode 100644
index 00000000..d977dd60
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-08.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-09.png b/tmp/maintenance-manual/rendered-user/pages/page-09.png
new file mode 100644
index 00000000..ec52b56a
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-09.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-10.png b/tmp/maintenance-manual/rendered-user/pages/page-10.png
new file mode 100644
index 00000000..e42f2a47
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-10.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-11.png b/tmp/maintenance-manual/rendered-user/pages/page-11.png
new file mode 100644
index 00000000..1f2a8d2a
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-11.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-12.png b/tmp/maintenance-manual/rendered-user/pages/page-12.png
new file mode 100644
index 00000000..c5fac42d
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-12.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-13.png b/tmp/maintenance-manual/rendered-user/pages/page-13.png
new file mode 100644
index 00000000..52a8552b
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-13.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-14.png b/tmp/maintenance-manual/rendered-user/pages/page-14.png
new file mode 100644
index 00000000..7bca6e48
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-14.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-15.png b/tmp/maintenance-manual/rendered-user/pages/page-15.png
new file mode 100644
index 00000000..e48d1e02
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-15.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-16.png b/tmp/maintenance-manual/rendered-user/pages/page-16.png
new file mode 100644
index 00000000..6e0d606f
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-16.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-17.png b/tmp/maintenance-manual/rendered-user/pages/page-17.png
new file mode 100644
index 00000000..fc0abfe1
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-17.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-18.png b/tmp/maintenance-manual/rendered-user/pages/page-18.png
new file mode 100644
index 00000000..9e003500
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-18.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-19.png b/tmp/maintenance-manual/rendered-user/pages/page-19.png
new file mode 100644
index 00000000..fce6c4b3
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-19.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-20.png b/tmp/maintenance-manual/rendered-user/pages/page-20.png
new file mode 100644
index 00000000..0ff24410
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-20.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-21.png b/tmp/maintenance-manual/rendered-user/pages/page-21.png
new file mode 100644
index 00000000..56be969c
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-21.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-22.png b/tmp/maintenance-manual/rendered-user/pages/page-22.png
new file mode 100644
index 00000000..c3757892
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-22.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-23.png b/tmp/maintenance-manual/rendered-user/pages/page-23.png
new file mode 100644
index 00000000..993ac84b
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-23.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-24.png b/tmp/maintenance-manual/rendered-user/pages/page-24.png
new file mode 100644
index 00000000..f820a78e
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-24.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-25.png b/tmp/maintenance-manual/rendered-user/pages/page-25.png
new file mode 100644
index 00000000..ed03a1c0
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-25.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-26.png b/tmp/maintenance-manual/rendered-user/pages/page-26.png
new file mode 100644
index 00000000..cdf1afd4
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-26.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-27.png b/tmp/maintenance-manual/rendered-user/pages/page-27.png
new file mode 100644
index 00000000..88fb0044
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-27.png differ
diff --git a/tmp/maintenance-manual/rendered-user/pages/page-28.png b/tmp/maintenance-manual/rendered-user/pages/page-28.png
new file mode 100644
index 00000000..a67539d1
Binary files /dev/null and b/tmp/maintenance-manual/rendered-user/pages/page-28.png differ
diff --git a/tmp/maintenance-manual/rendered/DeerFlow系统运维手册-内网离线部署版.pdf b/tmp/maintenance-manual/rendered/DeerFlow系统运维手册-内网离线部署版.pdf
new file mode 100644
index 00000000..75596144
Binary files /dev/null and b/tmp/maintenance-manual/rendered/DeerFlow系统运维手册-内网离线部署版.pdf differ
diff --git a/tmp/maintenance-manual/rendered/contact-sheets/pages-01-04.jpg b/tmp/maintenance-manual/rendered/contact-sheets/pages-01-04.jpg
new file mode 100644
index 00000000..3948fc35
Binary files /dev/null and b/tmp/maintenance-manual/rendered/contact-sheets/pages-01-04.jpg differ
diff --git a/tmp/maintenance-manual/rendered/contact-sheets/pages-05-08.jpg b/tmp/maintenance-manual/rendered/contact-sheets/pages-05-08.jpg
new file mode 100644
index 00000000..5999bfc6
Binary files /dev/null and b/tmp/maintenance-manual/rendered/contact-sheets/pages-05-08.jpg differ
diff --git a/tmp/maintenance-manual/rendered/contact-sheets/pages-09-12.jpg b/tmp/maintenance-manual/rendered/contact-sheets/pages-09-12.jpg
new file mode 100644
index 00000000..0f4750db
Binary files /dev/null and b/tmp/maintenance-manual/rendered/contact-sheets/pages-09-12.jpg differ
diff --git a/tmp/maintenance-manual/rendered/contact-sheets/pages-13-16.jpg b/tmp/maintenance-manual/rendered/contact-sheets/pages-13-16.jpg
new file mode 100644
index 00000000..96b77529
Binary files /dev/null and b/tmp/maintenance-manual/rendered/contact-sheets/pages-13-16.jpg differ
diff --git a/tmp/maintenance-manual/rendered/contact-sheets/pages-17-20.jpg b/tmp/maintenance-manual/rendered/contact-sheets/pages-17-20.jpg
new file mode 100644
index 00000000..fa77cc2f
Binary files /dev/null and b/tmp/maintenance-manual/rendered/contact-sheets/pages-17-20.jpg differ
diff --git a/tmp/maintenance-manual/rendered/contact-sheets/pages-21-24.jpg b/tmp/maintenance-manual/rendered/contact-sheets/pages-21-24.jpg
new file mode 100644
index 00000000..9c4929f0
Binary files /dev/null and b/tmp/maintenance-manual/rendered/contact-sheets/pages-21-24.jpg differ
diff --git a/tmp/maintenance-manual/rendered/contact-sheets/pages-25-28.jpg b/tmp/maintenance-manual/rendered/contact-sheets/pages-25-28.jpg
new file mode 100644
index 00000000..1b1bb76e
Binary files /dev/null and b/tmp/maintenance-manual/rendered/contact-sheets/pages-25-28.jpg differ
diff --git a/tmp/maintenance-manual/rendered/contact-sheets/pages-29-32.jpg b/tmp/maintenance-manual/rendered/contact-sheets/pages-29-32.jpg
new file mode 100644
index 00000000..e2fbf295
Binary files /dev/null and b/tmp/maintenance-manual/rendered/contact-sheets/pages-29-32.jpg differ
diff --git a/tmp/maintenance-manual/rendered/contact-sheets/pages-33-36.jpg b/tmp/maintenance-manual/rendered/contact-sheets/pages-33-36.jpg
new file mode 100644
index 00000000..99e2315e
Binary files /dev/null and b/tmp/maintenance-manual/rendered/contact-sheets/pages-33-36.jpg differ
diff --git a/tmp/maintenance-manual/rendered/contact-sheets/pages-37-40.jpg b/tmp/maintenance-manual/rendered/contact-sheets/pages-37-40.jpg
new file mode 100644
index 00000000..a6deed14
Binary files /dev/null and b/tmp/maintenance-manual/rendered/contact-sheets/pages-37-40.jpg differ
diff --git a/tmp/maintenance-manual/rendered/contact-sheets/pages-41-44.jpg b/tmp/maintenance-manual/rendered/contact-sheets/pages-41-44.jpg
new file mode 100644
index 00000000..47be5a07
Binary files /dev/null and b/tmp/maintenance-manual/rendered/contact-sheets/pages-41-44.jpg differ
diff --git a/tmp/maintenance-manual/rendered/contact-sheets/pages-45-48.jpg b/tmp/maintenance-manual/rendered/contact-sheets/pages-45-48.jpg
new file mode 100644
index 00000000..990e3767
Binary files /dev/null and b/tmp/maintenance-manual/rendered/contact-sheets/pages-45-48.jpg differ
diff --git a/tmp/maintenance-manual/rendered/contact-sheets/pages-49-52.jpg b/tmp/maintenance-manual/rendered/contact-sheets/pages-49-52.jpg
new file mode 100644
index 00000000..9b7fb7ea
Binary files /dev/null and b/tmp/maintenance-manual/rendered/contact-sheets/pages-49-52.jpg differ
diff --git a/tmp/maintenance-manual/rendered/contact-sheets/pages-53-56.jpg b/tmp/maintenance-manual/rendered/contact-sheets/pages-53-56.jpg
new file mode 100644
index 00000000..6f7c8738
Binary files /dev/null and b/tmp/maintenance-manual/rendered/contact-sheets/pages-53-56.jpg differ
diff --git a/tmp/maintenance-manual/rendered/contact-sheets/pages-57-60.jpg b/tmp/maintenance-manual/rendered/contact-sheets/pages-57-60.jpg
new file mode 100644
index 00000000..c16f2ce9
Binary files /dev/null and b/tmp/maintenance-manual/rendered/contact-sheets/pages-57-60.jpg differ
diff --git a/tmp/maintenance-manual/rendered/contact-sheets/pages-61-61.jpg b/tmp/maintenance-manual/rendered/contact-sheets/pages-61-61.jpg
new file mode 100644
index 00000000..c48563cb
Binary files /dev/null and b/tmp/maintenance-manual/rendered/contact-sheets/pages-61-61.jpg differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-01.png b/tmp/maintenance-manual/rendered/pages/page-01.png
new file mode 100644
index 00000000..be5d589b
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-01.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-02.png b/tmp/maintenance-manual/rendered/pages/page-02.png
new file mode 100644
index 00000000..d063cb4f
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-02.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-03.png b/tmp/maintenance-manual/rendered/pages/page-03.png
new file mode 100644
index 00000000..81b81f7a
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-03.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-04.png b/tmp/maintenance-manual/rendered/pages/page-04.png
new file mode 100644
index 00000000..c43bb49c
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-04.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-05.png b/tmp/maintenance-manual/rendered/pages/page-05.png
new file mode 100644
index 00000000..8c2f0c47
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-05.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-06.png b/tmp/maintenance-manual/rendered/pages/page-06.png
new file mode 100644
index 00000000..c6a32ba1
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-06.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-07.png b/tmp/maintenance-manual/rendered/pages/page-07.png
new file mode 100644
index 00000000..3022fe5a
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-07.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-08.png b/tmp/maintenance-manual/rendered/pages/page-08.png
new file mode 100644
index 00000000..cb350c44
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-08.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-09.png b/tmp/maintenance-manual/rendered/pages/page-09.png
new file mode 100644
index 00000000..28d83d8d
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-09.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-10.png b/tmp/maintenance-manual/rendered/pages/page-10.png
new file mode 100644
index 00000000..eb9f600f
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-10.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-11.png b/tmp/maintenance-manual/rendered/pages/page-11.png
new file mode 100644
index 00000000..1e848a4c
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-11.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-12.png b/tmp/maintenance-manual/rendered/pages/page-12.png
new file mode 100644
index 00000000..e7d2ef5f
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-12.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-13.png b/tmp/maintenance-manual/rendered/pages/page-13.png
new file mode 100644
index 00000000..630bf988
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-13.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-14.png b/tmp/maintenance-manual/rendered/pages/page-14.png
new file mode 100644
index 00000000..cf3ea12a
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-14.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-15.png b/tmp/maintenance-manual/rendered/pages/page-15.png
new file mode 100644
index 00000000..6edf6ba5
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-15.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-16.png b/tmp/maintenance-manual/rendered/pages/page-16.png
new file mode 100644
index 00000000..5fcf64de
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-16.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-17.png b/tmp/maintenance-manual/rendered/pages/page-17.png
new file mode 100644
index 00000000..4e5576d3
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-17.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-18.png b/tmp/maintenance-manual/rendered/pages/page-18.png
new file mode 100644
index 00000000..22b34f6a
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-18.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-19.png b/tmp/maintenance-manual/rendered/pages/page-19.png
new file mode 100644
index 00000000..a3bad06f
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-19.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-20.png b/tmp/maintenance-manual/rendered/pages/page-20.png
new file mode 100644
index 00000000..40f91627
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-20.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-21.png b/tmp/maintenance-manual/rendered/pages/page-21.png
new file mode 100644
index 00000000..8cae4b85
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-21.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-22.png b/tmp/maintenance-manual/rendered/pages/page-22.png
new file mode 100644
index 00000000..4b7d5a2c
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-22.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-23.png b/tmp/maintenance-manual/rendered/pages/page-23.png
new file mode 100644
index 00000000..039f9aab
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-23.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-24.png b/tmp/maintenance-manual/rendered/pages/page-24.png
new file mode 100644
index 00000000..75bd34f0
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-24.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-25.png b/tmp/maintenance-manual/rendered/pages/page-25.png
new file mode 100644
index 00000000..1a47023a
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-25.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-26.png b/tmp/maintenance-manual/rendered/pages/page-26.png
new file mode 100644
index 00000000..c2228353
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-26.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-27.png b/tmp/maintenance-manual/rendered/pages/page-27.png
new file mode 100644
index 00000000..777039ee
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-27.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-28.png b/tmp/maintenance-manual/rendered/pages/page-28.png
new file mode 100644
index 00000000..f0300a42
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-28.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-29.png b/tmp/maintenance-manual/rendered/pages/page-29.png
new file mode 100644
index 00000000..94e32ba1
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-29.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-30.png b/tmp/maintenance-manual/rendered/pages/page-30.png
new file mode 100644
index 00000000..4f89d66b
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-30.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-31.png b/tmp/maintenance-manual/rendered/pages/page-31.png
new file mode 100644
index 00000000..88c1e42f
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-31.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-32.png b/tmp/maintenance-manual/rendered/pages/page-32.png
new file mode 100644
index 00000000..09f7517b
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-32.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-33.png b/tmp/maintenance-manual/rendered/pages/page-33.png
new file mode 100644
index 00000000..41a294f4
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-33.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-34.png b/tmp/maintenance-manual/rendered/pages/page-34.png
new file mode 100644
index 00000000..d6106c13
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-34.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-35.png b/tmp/maintenance-manual/rendered/pages/page-35.png
new file mode 100644
index 00000000..00ee5458
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-35.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-36.png b/tmp/maintenance-manual/rendered/pages/page-36.png
new file mode 100644
index 00000000..d03e891a
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-36.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-37.png b/tmp/maintenance-manual/rendered/pages/page-37.png
new file mode 100644
index 00000000..ff96032f
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-37.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-38.png b/tmp/maintenance-manual/rendered/pages/page-38.png
new file mode 100644
index 00000000..1372026f
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-38.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-39.png b/tmp/maintenance-manual/rendered/pages/page-39.png
new file mode 100644
index 00000000..c09842e2
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-39.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-40.png b/tmp/maintenance-manual/rendered/pages/page-40.png
new file mode 100644
index 00000000..46278625
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-40.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-41.png b/tmp/maintenance-manual/rendered/pages/page-41.png
new file mode 100644
index 00000000..a2224e33
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-41.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-42.png b/tmp/maintenance-manual/rendered/pages/page-42.png
new file mode 100644
index 00000000..deb42c45
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-42.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-43.png b/tmp/maintenance-manual/rendered/pages/page-43.png
new file mode 100644
index 00000000..e9c4b8a3
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-43.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-44.png b/tmp/maintenance-manual/rendered/pages/page-44.png
new file mode 100644
index 00000000..e78e5db7
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-44.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-45.png b/tmp/maintenance-manual/rendered/pages/page-45.png
new file mode 100644
index 00000000..db51a9ee
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-45.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-46.png b/tmp/maintenance-manual/rendered/pages/page-46.png
new file mode 100644
index 00000000..349cdb25
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-46.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-47.png b/tmp/maintenance-manual/rendered/pages/page-47.png
new file mode 100644
index 00000000..057cfcc6
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-47.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-48.png b/tmp/maintenance-manual/rendered/pages/page-48.png
new file mode 100644
index 00000000..24f84bd4
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-48.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-49.png b/tmp/maintenance-manual/rendered/pages/page-49.png
new file mode 100644
index 00000000..0f1b10b8
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-49.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-50.png b/tmp/maintenance-manual/rendered/pages/page-50.png
new file mode 100644
index 00000000..29c33547
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-50.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-51.png b/tmp/maintenance-manual/rendered/pages/page-51.png
new file mode 100644
index 00000000..ccd0b39a
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-51.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-52.png b/tmp/maintenance-manual/rendered/pages/page-52.png
new file mode 100644
index 00000000..e9eae8c5
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-52.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-53.png b/tmp/maintenance-manual/rendered/pages/page-53.png
new file mode 100644
index 00000000..7e2c0065
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-53.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-54.png b/tmp/maintenance-manual/rendered/pages/page-54.png
new file mode 100644
index 00000000..88a81736
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-54.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-55.png b/tmp/maintenance-manual/rendered/pages/page-55.png
new file mode 100644
index 00000000..df4bd728
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-55.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-56.png b/tmp/maintenance-manual/rendered/pages/page-56.png
new file mode 100644
index 00000000..467ac10b
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-56.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-57.png b/tmp/maintenance-manual/rendered/pages/page-57.png
new file mode 100644
index 00000000..a0b5f682
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-57.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-58.png b/tmp/maintenance-manual/rendered/pages/page-58.png
new file mode 100644
index 00000000..7fa41ecc
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-58.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-59.png b/tmp/maintenance-manual/rendered/pages/page-59.png
new file mode 100644
index 00000000..05459826
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-59.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-60.png b/tmp/maintenance-manual/rendered/pages/page-60.png
new file mode 100644
index 00000000..ab6f81a1
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-60.png differ
diff --git a/tmp/maintenance-manual/rendered/pages/page-61.png b/tmp/maintenance-manual/rendered/pages/page-61.png
new file mode 100644
index 00000000..54eb0b44
Binary files /dev/null and b/tmp/maintenance-manual/rendered/pages/page-61.png differ