sync: 鍚屾灞€鍩熺綉鏈€鏂颁唬鐮?(source master @ b69568e4)

fix(buttons): 行动分析宿主路由支持切换任务id/行动id

See merge request knowledge-base-bj/deerflow-code!39

.gitignore

@@ -91,6 +91,7 @@ offline-backend-20260512/backend/tests/*
 # Keep the openGauss URL/dialect/schema compatibility regression coverage versioned.
 !offline-backend-20260512/backend/tests/test_gauss_database.py
 !offline-backend-20260512/backend/tests/test_llmwiki_weknora.py
+!offline-backend-20260512/backend/tests/test_llmwiki_knowledge_management.py
 !offline-backend-20260512/backend/tests/test_health_auth_bypass.py
 # Keep formal Word OOXML and embedded-font regression coverage versioned.
 !offline-backend-20260512/backend/tests/test_word_export.py
@@ -122,25 +123,28 @@ offline-backend-20260512/backend/tests/*
 # Independent enterprise-research persistence, HTTP and race regressions.
 !offline-backend-20260512/backend/tests/test_enterprise_research_tasks.py
 # Position-roundtable per-turn write/present cap (weak-model duplicate artifacts).
-!offline-backend-20260512/backend/tests/test_position_artifact_cap.py
+!offline-backend-20260512/backend/tests/test_position_artifact_cap.py
-# Roundtable coordinator/seat capability isolation regressions.
+# Roundtable coordinator/seat capability isolation regressions.
-!offline-backend-20260512/backend/tests/test_roundtable_role_boundary.py
+!offline-backend-20260512/backend/tests/test_roundtable_role_boundary.py
-# Workflow Studio: schemas / definitions / engine / run-lifecycle regressions
+# Workflow Studio: schemas / definitions / engine / run-lifecycle regressions
 # plus the concurrency remediation suite (atomic resume, draft CAS, publish
 # counter, event seq) — required in CI per docs/WORKFLOW_STUDIO_BACKEND_REMEDIATION_ZH.md P1-06.
 !offline-backend-20260512/backend/tests/test_workflow_schemas.py
 !offline-backend-20260512/backend/tests/test_workflow_definitions.py
-!offline-backend-20260512/backend/tests/test_workflow_engine.py
+!offline-backend-20260512/backend/tests/test_workflow_engine.py
-!offline-backend-20260512/backend/tests/test_workflow_runs.py
+!offline-backend-20260512/backend/tests/test_workflow_runs.py
-!offline-backend-20260512/backend/tests/test_workflow_concurrency.py
+!offline-backend-20260512/backend/tests/test_workflow_concurrency.py
-!offline-backend-20260512/backend/tests/test_workflow_schema_rebuild.py
+!offline-backend-20260512/backend/tests/test_workflow_schema_rebuild.py
-# Writing-mode first-report pipeline enforcement regressions.
+# Writing-mode first-report pipeline enforcement regressions.
 !offline-backend-20260512/backend/tests/test_writing_mode_report_middleware.py
 !offline-backend-20260512/backend/tests/test_writing_rewrite_prompt.py
 # LLM call timeout retry classification regression coverage.
 !offline-backend-20260512/backend/tests/test_llm_error_handling_middleware.py
 # Writing-mode pipeline conversation-material regressions.
 !offline-backend-20260512/backend/tests/test_deep_research_report_tool.py
+# Report collaboration (RC-BE-000–018) regression coverage.
+!offline-backend-20260512/backend/tests/test_report_collaboration_*.py
+!offline-backend-20260512/backend/tests/test_ensure_orm_columns_sync.py
 deploy
 .history
 
@@ -172,8 +176,10 @@ docs/backups
 # Frontend skills components must be tracked (excluded from the broad skills/ ignore above)
 !frontend-web/src/components/workspace/skills/
 
-# uv lockfile (not tracked per project preference)
+# uv lockfile (not tracked per project preference)
-offline-backend-20260512/backend/uv.lock
+offline-backend-20260512/backend/uv.lock
+
+!offline-backend-20260512/backend/tests/test_wiki_package_roundtrip.py
 
 # Local-only scratch directory (not committed)
 0622/

AGENTS.md

@@ -96,13 +96,13 @@ The frontend (`frontend-web/`) is a React 19 + Vite SPA:
 - **智能体使用引导 (Agent onboarding tour, 三段式)**: 智能体「浏览管理 → 创建与配置 → 发起问答」全流程分步引导，组件 `components/workspace/agents/agent-guide.tsx`（同一 TDesign `Guide` 封装模式，与简洁模式引导共享记忆语义：**仅显式点「完成/跳过」才写 localStorage** `deerflow.agent-guide.<stage>.finished`，中途刷新/离开不记忆）。**自动演示仅 create / chat 两段**（进智能体列表页不弹引导，点「创建智能体」进入新建页时才自动演示；list 段的 `AgentGuide` 传 `autoStart={false}`，只能由头部「使用引导」按钮手动触发）。三段各自挂载、各自记忆：① `list`（`agent-gallery.tsx`，/page/workspace/agents）——分区 Tabs、搜索排序、智能体卡片操作、右上「创建智能体」按钮；**完成/跳过就地结束（不跳转创建页，与 create 段无联动）**，最后一步仅提示进入创建页后会有配置引导；② `create`（`NewAgentPage.tsx`，/page/workspace/agents/new）——左侧对话式创建输入区、基本信息、运行模型+入库模板名、知识空间、SOUL.md、技能穿梭框、保存按钮（9 步）；③ `chat`（`AgentChatPage.tsx`，agents/:id/chats）——左栏切换与历史、常用问题 chips、输入框（落地态/会话态两个挂点同一 `chat-input` 标记）、右侧详情面板；`eligible` 限定普通智能体对话页（`showAgentList && !isEmbedded && !taskCtxOn`，即排除通用问答原地嵌入与任务深链工作区），三段共用 `isAgentGuideEnvironment()` 排除 embed/hideChrome/无界环境。高亮锚点 `data-agent-guide`：列表页 `tabs`/`search`/`agent-card`（卡片+列表两种布局的根元素）/`new-agent-btn`，创建页 `create-chat-input`/`create-basic`/`create-model`/`create-knowledge`/`create-soul`/`create-skills`/`create-save-btn`，对话页 `chat-sidebar`/`chat-questions`/`chat-input`/`chat-detail`；同样**启动时按目标存在性过滤步骤**（新用户无卡片/无预设问题时自动剔除）。手动重放：三个页面头部各有「使用引导」按钮（列表页创建按钮左侧、创建页 header 右侧、对话页 header），广播 `agent-guide:start:<stage>` 窗口事件强制重放（忽略已看过记忆）。
 - **敏感词管理 (Sensitive Word Management)**: configures the **展示层脱敏映射** (原始词 → 替换词). **Gated on the username `lqq`** (not the admin role) — `getAccountDisplayName().toLowerCase() === "lqq"` (username = email `@` prefix, else `user_id`, same as the profile page); the dropdown entry, the route guard, and the page-level guard all use this check. `src/lib/desensitize.ts` ships a frozen seed map `SEED_DESENSITIZE_MAP` (the deployment seed) plus a live mutable `DESENSITIZE_MAP` (initialized from the seed so `desensitize()` works before any fetch). `DesensitizeWordsLoader` (mounted in `App.tsx` `AppProviders`) fetches `/api/sensitive-words` on startup and, if non-empty, calls `replaceDesensitizeMap(...)` to make the backend config the source of truth (empty/failed → keep seed). Page `SensitiveWordsPage.tsx` (route `/page/strategy/admin/sensitive-words`, opened from the 「敏感词管理」 item in the **bottom-left settings dropdown** of `components/page-sidebar.tsx`, present in **both** full + collapsed sidebar modes) lists/adds/edits/启停/deletes words and saves the **whole set atomically** (replace-all); a 「导入种子词」 button merges any missing `SEED_DESENSITIZE_MAP` entries into the editor. Client + hooks in `strategy-components/api/sensitive-words.ts` (`wordsToMap` folds enabled rows into the runtime map). Backend: `/api/sensitive-words` (global/shared; open read, write allowed for admin **or** the `lqq` account), mirroring 菜单管理's store shape. **侧边栏 + 导航栏 menu labels are desensitized** at the data source: `useSidebarMenuItems`/`useActiveThirdLevel` (`core/page-layout/use-sidebar-menu.ts`) map every node's `label` through a desensitizer built **directly from the `/api/sensitive-words` query** (`makeDesensitizer(wordsToMap(words))`, falling back to the global seed `desensitize` while empty) — this sidesteps the `replaceDesensitizeMap` effect-timing race. Only `label` is rewritten; `path`/`id`/`icon` are untouched so routing/highlight are unaffected. All nav surfaces (`page-sidebar.tsx`, `page-sidebar-dark.tsx`, `page-sidebar-v1.tsx`, `strategy-components/Header.tsx`, `PageRoutes.tsx`) consume this hook and are covered; `MenuManagementPage` uses the raw tree so admins still edit real labels.
 - **技能地址管理 (Skill Address Management, admin-only)**: 扫描运行中的技能（`skills/{public,custom}` 下所有 `.md`/`.py`）里的 **http(s) URL 与 IP/IP:端口**，按唯一地址聚合全部出现位置（跨 .md/.py），支持**批量替换**（如把 UAT 地址一次性改成生产）。主体抽成可复用组件 `SkillAddressesPanel`（`pages/SkillAddressesPage.tsx` 导出，默认导出 `SkillAddressesPage` 仍保留旧路由 `/page/strategy/admin/skill-addresses` 作直链回退），**作为「技能地址管理」标签页嵌入管理员「技能管理」页 `pages/AdminSkillsPage.tsx`**（该页加 Tabs：「技能列表」+「技能地址管理」；入口在「设置和更多」下拉的「技能管理」`workspace-nav-menu.tsx` → `/page/workspace/admin/skills`，不再单列于 `components/page-sidebar.tsx` 左下角设置下拉）：打开自动扫描并带**进度条**（扫描逐技能 / 应用逐文件 X/N，应对 150+ 技能），URL/IP 类型过滤 + 搜索 + 「片段批量套用」（如所有 `uat.4.cn` → `prod.4.cn`）、每地址「替换为」输入框（可展开看 `file:line` 片段）、内联**预览**、**应用**、**多关键词检索**（空格分隔全部命中），以及**修改记录**面板——每次应用生成一条记录（显示时间/改了哪些地址 from→to/文件数/处数），可**针对单次记录回退**（二次确认）。client + NDJSON 流式解析在 `strategy-components/api/skill-addresses.ts`。后端 `/api/skill-addresses`（**仅管理员**）：所有文件 IO 走 `asyncio.to_thread` 不阻塞事件循环；`GET /scan`(+`/scan/stream`)、`POST /preview`、`POST /apply`(+`/apply/stream`)、`GET /backups`、`POST /rollback/{id}`；**子串安全替换**（基于 token span，不会误伤子串）、`expected_total` 乐观锁（409）、写前自动磁盘备份到 `{skills_root}/.address-edits/`（同时写一份 `{id}.manifest.json` 记录本次替换明细，供修改记录展示）、应用后刷新技能系统提示缓存。纯引擎 `deerflow/skills/address_scan.py`，router `app/gateway/routers/skill_addresses.py`，tests `tests/test_skill_addresses.py`。范围仅运行中技能，不动 `deploy/minimal/skills/`。
-- **按钮管理 (Task Button Management, admin-only)**: configures the **可配置跳转按钮** rendered in the left task panel of the task deep-link workspaces (rwfx / 3qfx / xdfx, see `TaskFxWorkspace`). Each button = `{business, label, linkType, target, appendTaskId, idParam, idKind, enabled, sortOrder}`; `linkType` is `url` (外链 `window.open`, optional append of `?{idParam}={id}` — **`idParam` is the editable query-param name**, e.g. `id`/`task_id`), `business` (内部切换到另一业务, reuses `resolveTaskDeeplinkTarget`, always task id), or `purpose` (弹出当前任务的「任务目的」表格 via the shared `TaskPurposeDialog`, no target — configurable for any page incl. xdfx). **`host`（宿主路由）** asks the embedding parent to navigate: `runTaskButton` sends `window.parent.postMessage({ type:'HOST_NAVIGATE', path, queryParams:{ [idParam]: Number(taskId) } }, hostOrigin)` — `target` is the host route, `appendTaskId`/`idParam` become numeric `queryParams` (task id only), origin from `runtime-config.js` `VITE_HOST_NAVIGATE_ORIGIN` (else ancestorOrigins/referrer; never `*`). **`idKind` (`task`/`action`) only matters for xdfx**: its deep-link `?taskId=` is an 行动id and the 任务id is resolved at login (`fetchTaskIdFromAction`) — `TaskContext` now also stashes the raw `actionId`, so a url button can append either (default `task`). Page `TaskButtonsPage.tsx` (route `/page/strategy/admin/task-buttons`, **admin-gated**, entry「按钮管理」in the bottom-left settings dropdown of `components/page-sidebar.tsx`, both full + collapsed modes) has per-business tabs, edits name/type/target/启停/排序/增删, saves the **whole set atomically** (replace-all), plus 「导入默认」 to merge code-seed defaults. **Seed/fallback** (like 敏感词管理): only when the whole table is empty (fresh deploy, never saved) do the workspace + page fall back to `defaultTaskButtons(cfg)` — rwfx's url buttons (编辑/下一步/3q详情) built from the **live** `/api/public/config/task-deeplink` plus cross-business switch buttons for **all three** businesses (each switches to the other two — rwfx→三情/行动, 3qfx→任务/行动, xdfx→任务/三情). Once saved, the store is the sole source of truth. The old hardcoded jump buttons were migrated out: `TaskFxWorkspace` no longer hardcodes 切换到三情分析, `TaskActionsPanel` keeps only the non-jump 清除记录, and `TaskPurposePanel` dropped its 3q详情 button (now configurable) **and defaults the 目的树 table to collapsed** (chevron toggle). Helpers `core/auth/task-buttons.ts` (`TaskButton`, `defaultTaskButtons`, `resolveTaskButtons`, `buttonsForBusiness`, `runTaskButton`), client+hooks `strategy-components/api/task-buttons.ts`. Backend: `/api/task-buttons` (global/shared; open read, admin replace-all), store `deerflow.persistence.task_buttons` (table `task_buttons`, auto-created by `create_all`), wired `app.state.task_button_store`. Tests: `tests/test_task_buttons.py`.
+- **按钮管理 (Task Button Management, admin-only)**: configures the **可配置跳转按钮** rendered in the left task panel of the task deep-link workspaces (rwfx / 3qfx / xdfx, see `TaskFxWorkspace`). Each button = `{business, label, linkType, target, appendTaskId, idParam, idKind, enabled, sortOrder}`; `linkType` is `url` (外链 `window.open`, optional append of `?{idParam}={id}` — **`idParam` is the editable query-param name**, e.g. `id`/`task_id`), `business` (内部切换到另一业务, reuses `resolveTaskDeeplinkTarget`, always task id), or `purpose` (弹出当前任务的「任务目的」表格 via the shared `TaskPurposeDialog`, no target — configurable for any page incl. xdfx). **`host`（宿主路由）** asks the embedding parent to navigate: `runTaskButton` sends `window.parent.postMessage({ type:'HOST_NAVIGATE', path, queryParams:{ [idParam]: Number(taskId) } }, hostOrigin)` — `target` is the host route, `appendTaskId`/`idParam` become numeric `queryParams` (task id, or action id when `idKind:"action"` — same selector as url buttons, xdfx only), origin from `runtime-config.js` `VITE_HOST_NAVIGATE_ORIGIN` (else ancestorOrigins/referrer; never `*`). **`idKind` (`task`/`action`) only matters for xdfx**: its deep-link `?taskId=` is an 行动id and the 任务id is resolved at login (`fetchTaskIdFromAction`) — `TaskContext` now also stashes the raw `actionId`, so a url **or host** button can append either (default `task`). Page `TaskButtonsPage.tsx` (route `/page/strategy/admin/task-buttons`, **admin-gated**, entry「按钮管理」in the bottom-left settings dropdown of `components/page-sidebar.tsx`, both full + collapsed modes) has per-business tabs, edits name/type/target/启停/排序/增删, saves the **whole set atomically** (replace-all), plus 「导入默认」 to merge code-seed defaults. **Seed/fallback** (like 敏感词管理): only when the whole table is empty (fresh deploy, never saved) do the workspace + page fall back to `defaultTaskButtons(cfg)` — rwfx's url buttons (编辑/下一步/3q详情) built from the **live** `/api/public/config/task-deeplink` plus cross-business switch buttons for **all three** businesses (each switches to the other two — rwfx→三情/行动, 3qfx→任务/行动, xdfx→任务/三情). Once saved, the store is the sole source of truth. The old hardcoded jump buttons were migrated out: `TaskFxWorkspace` no longer hardcodes 切换到三情分析, `TaskActionsPanel` keeps only the non-jump 清除记录, and `TaskPurposePanel` dropped its 3q详情 button (now configurable) **and defaults the 目的树 table to collapsed** (chevron toggle). Helpers `core/auth/task-buttons.ts` (`TaskButton`, `defaultTaskButtons`, `resolveTaskButtons`, `buttonsForBusiness`, `runTaskButton`), client+hooks `strategy-components/api/task-buttons.ts`. Backend: `/api/task-buttons` (global/shared; open read, admin replace-all), store `deerflow.persistence.task_buttons` (table `task_buttons`, auto-created by `create_all`), wired `app.state.task_button_store`. Tests: `tests/test_task_buttons.py`.
 - **State**: TanStack Query for server state, context providers (`SubtasksProvider`, `ArtifactsProvider`, `PromptInputProvider`) scoped to `WorkspaceRoutes`
 - **LLM streaming**: `@langchain/langgraph-sdk` streams messages from the backend via SSE
 - **UI**: Radix UI primitives + TailwindCSS v4 + shadcn-style components in `src/components/ui/`
 - **Shims**: `src/shims/` provides `next/link` and `next/navigation` polyfills (original code was Next.js)
 - **Login URL params** (`LoginPage.tsx`, frontend-only — the backend never sees these): besides the auth params (`ticket`/`userId`/`env`/`theme`/`yUserId`/`token`/`access_token`/`authToken`/`password`), the page supports a **task deep-link** via `?taskId=&goPath=`. After login it calls the consumer API `GET {VITE_AIPI_CONSUMER_URL}/taskAnalyseSearch/cop-task-detail?taskId=` (header `Authorization: Bearer admin`, auto-injected by `utils/request.ts`), stashes the full `data` (`id/overview/taskDirection/taskName/taskContent`) into `sessionStorage["login.copTaskDetail"]`, then routes by `goPath`: base codes `3qfx`/`rwfx`/`xdfx` → that business's configured **single agent** Q&A inside a **任务工作区** (resolved via `/api/business-mapping`; `resolveTaskDeeplinkTarget` calls `persistTaskContext({taskId, agentId, openingText})` and navigates to the `…/chats` **index**, which opens the latest task conversation or 新建 — a 1:N task↔对话 workspace, NOT `pendingAgentMessage`); the `-A` suffix (`3qfx-A`/…) → **multi-agent roundtable** with `roundtablePrefill.businessCode` so the page auto-selects the configured 业务链条. **xdfx's deep-link `?taskId=` is actually an 行动id, not a 任务id** — `resolveDeeplinkTaskId(goPath, rawId)` (called in `LoginPage` before everything) detects `xdfx`/`xdfx-A` and resolves it via `GET {action_detail_url}/{actionId}` → `data.taskId` (`fetchTaskIdFromAction`; `action_test`+`mock.action_detail` for offline testing); the resolved 任务id then drives `cop-task-detail`, the purpose tree, and the 1:N binding (other businesses pass the id through unchanged). **xdfx additionally partitions its chat records by 行动id (action_id), NOT by task_id**: `resolveTaskDeeplinkTarget` sets `partitionByAction:true` + keeps the raw action_id as `TaskContext.actionId`, so new threads are tagged `metadata.{taskId,actionId}` (taskId kept only to preserve the backend「任务深链对话全局共享」semantics, which keys off `metadata.taskId`) and the conversation list filters by `actionId` (+`agent_id`) — different actions of the same task get separate lists. xdfx's first-question opening text also appends `行动id（action_id）为…` (see `buildOpeningText` / `taskThreadMetadata`). goPath→businessCode: `3qfx`→`3Q`, `rwfx`→`6BF`, `xdfx`→`7BF`. The roundtable target also threads the URL `taskId` into `roundtablePrefill.taskId` (`resolveTaskDeeplinkTarget(goPath, detail, taskId)`), which turns on two taskId-scoped behaviors: (1) **separate, unpartitioned per-task storage** — taskId 会商聊天记录 live in their **own** store/table (`roundtable_task_drafts`), keyed **only by `task_id`** (one taskId = many records, shared across users, **no user 分权** at all; `created_by` is audit-only), kept entirely out of the per-user personal store (`roundtable_drafts`, now strictly per-user) so the two never mix. Backend router `/api/roundtable-task-drafts` (`GET /by-task/{id}` + `/by-task/{id}/latest`, `POST`, `GET/PUT/DELETE /{id}` — all user-agnostic); frontend client `roundtable-planning/api/task-drafts.ts`, and `useDraftPersistence`/`useRoundtableDrafts` route **all** CRUD to it when a `taskId` is present (else the personal `drafts.ts`). The matching **background jobs** are shared by task too: `roundtable_jobs.task_id` marks a task job; reads/dedup/stream/resume/cancel pass `?task_id=` so any user opening the task sees the same running 研讨 (progress/flowchart), and the executor writes the final report back to the task-draft store. Existing rows are moved over by `scripts/migrate_roundtable_task_drafts.py` (migration `20260618_01`). The history dropdown filters to the task and 新建 keeps the binding; (2) **Step-3 auto structured output** — after the `roundtable-summary` agent writes the Markdown report it automatically runs a second round emitting a `flow-json` flowchart (`useStep3Summary` `autoFlow`+`chainLevels`), whose hierarchy follows the business chain's stage goals (任务 → 目的 → 行为体 → …; coordinatorPrompt-specified hierarchy wins) and whose nodes never carry 阶段编号/阶段名 (the prior bug). **Both targets render embedded under the 任务管理 layout** — nested routes under `task-management/<business-path>/{roundtable,agent/:agent_id/chats}` in `StrategyRoutes.tsx` (`<business-path>` = `plan-task-sentiment` / `plan-task/plan-task-fx` / `plan-task/plan-task-action`, matching the COH中任务 menu paths in `sidebar-menu.ts`) so the global sidebar keeps 任务管理 → COH中任务 → the matching business highlighted. **All three single-agent businesses share `TaskFxWorkspace`** (`task-components/TaskFxWorkspace.tsx`): left = a「当前任务」card (`readCopTaskDetail()` 任务名称 + 简介, desensitized, 留存 above 新建对话) + per-task 1:N conversation list (`useTaskThreads(taskId, agentId, actionId?)` — filtered by **both** `metadata.taskId` AND `metadata.agent_id` so the three businesses' conversations staLine truncated
-- **agentfx 任务深链（新系统 iframe 嵌入的智能体问答，3qfx 单智能体 lite 模式的独立复制）**: goPath=`agentfx`（`${loginBase}?password=…&taskId=…&goPath=agentfx&embed=1&hideJump=1&theme=dark-blue`）。与 3qfx 的差异：①任务详情不走外部 consumer，改调**本系统 Gateway** `GET {backend}/taskAnalyseSearch/cop-task-detail?taskId=`（`apiFetch` 带刚登录的 DeerFlow 态；任务数据来自 TaskCOP 任务表，与任务列表/报告导入同一份）；②**固定使用内置智能体** `agentfx-analyst`（不走业务映射）；③路由 `task-management/plan-task-agentfx/agent/:agent_id/chats`，页面为独立复制的 `AgentFxWorkspace.tsx`（`AgentFxWorkspace`/`AgentFxIndexResolver`/`AgentFxChat` —— 左「当前任务」卡 + 1:N 对话列表 + 新建对话，`AgentChatPage taskBind` 自动发开场白；无 TaskJumpBar/清除记录/闸门/xdfx 行动卡）。模块 `core/auth/agentfx-deeplink.ts`（`isAgentfxGoPath`/`fetchAgentfxTaskDetail`/`resolveAgentfxDeeplinkTarget`）；任务详情整包仍存共享键 `login.copTaskDetail`（按标签页隔离），`AgentChatPage` 的 taskBind 自恢复对 agentfx 生效。`LoginPage` 在既有深链分支前用 `isAgentfxGoPath` 分流。**内置「任务研判报告助手」**：后端 seeder `app/gateway/routers/_agentfx_seed.py` + `_agentfx_seed_assets/`（config.yaml + SOUL.md，目录存在不覆盖；app.py lifespan 在 `_sync_legacy_agents` 之前调用，自动进 agents 表 user_id IS NULL）——SOUL 规定工作流「搜集信息（`web_search`，**首步不可跳过**）→ `write_file` 生成 `/mnt/user-data/outputs/report.md` + `task-reports.json`（14 个 categoryType 的 `{contentJson, categoryType}` 数组，contentJson 为 JSON 字符串）→ 聊天总结 → 引导入库」，硬性约束：categoryType 逐字用 14 个全称（禁缩写自造如「DQ关键事件」）、JSON 直接写汉字禁 `\uXXXX` 转义、每类必须有实质内容不许空数组/纯占位、文件一律用 `/mnt/user-data/...` 虚拟路径（防宿主路径泄漏进 tool args）。**检索依赖 `config.yaml tools.web_search`（DDG，enabled 已开；内网需换 configurable_search 时改回并填 endpoint）**。任务工作区输入框在 `taskCtxOn` 时隐藏「写作/记忆/参考文献」（InputBox `hideContextTools` prop）与「知识空间」（不传 knowledgeSelector）；消息流里 write_file 文件卡片只显示文件名（`artifactDisplayName` 收敛宿主/虚拟路径）。**入库两条路径**：(a) **前端协助卡** —— `AgentChatPage`（taskBind 且非 taskGate）检测线程 artifacts 出现 `task-reports.json`（按文件名后缀匹配，兼容本地沙箱记录的宿主路径）且流式结束时，向 displayThread 尾部注入 `additional_kwargs.task_report_import_approval` 虚拟 ai 消息（`core/messages/utils.ts` 分组 `assistant:task-report-import` + `MessageList` 的 `taskReportImportSlot` 插槽渲染 `TaskReportImportCard`），点「开始入库」前端校验（`strategy-components/lib/agentfx-report-schema.ts`，14 类 + contentJson 合法 JSON + **\u 转义归一化还原为汉字**，与技能脚本同规则）后 `importTaskReport`（`strategy-components/api/task-reports.ts`）POST 导入接口整体替换；任务已有详情**不抑制**卡片（入库即整体替换，卡片文案说明覆盖语义），导入成功按 thread 记 sessionStorage（刷新不重复询问）、「暂不入库」为会话内记忆；(b) **入库技能** `task-report-import`（seeder 一并复制到 `skills/public/`，public 类技能 extensions_config 缺省即启用）—— 用户聊天里说「入库」时智能体按 SKILL.md 用 bash 跑 `scripts/task_report_import.py`（纯标准库：同样的校验规则 + 转义归一化；**默认关闭 SSL 证书校验** `ssl._create_unverified_context` + 忽略代理，适配内网自签证书；鉴权 `--token`/env `AGENTFX_IMPORT_TOKEN`→`DEERFLOW_AUTH_TOKEN`→`TOOLS_TOKEN` 优先，缺省经公共端点 `POST /api/parallel-agents/auth/token` 以 `agentfx-import` 用户现签 token——内网既有鉴权旁路；gateway 地址 env `AGENTFX_GATEWAY_URL` 或 `http://127.0.0.1:{DEER_FLOW_GATEWAY_PORT}`）；`--strict` 可要求 14 类齐全，默认允许部分导入并在 stdout JSON 的 `missing_categories` 里列缺。入库成功后任务 TaskCOP 状态自动置 25（已完成分析）。**入库成功通知宿主**（iframe 嵌入场景）：两条路径成功后都会 `window.top.postMessage({source: "magent-web", type: "task-report:saved", taskId: String(taskId)}, "*")`（`notifyTaskReportSaved`，`agentfx-report-schema.ts`）——卡片路径在 `TaskReportImportCard` 导入成功回调里直发；技能路径由 `AgentChatPage` 从消息流检测 `task_report_import.py` 的成功 stdout（`"success": true` + `task_id`）代发——**仅在回合结束后检测**（`!thread.isLoading` 才扫描；流式过程中 messages Line truncated
+- **agentfx 任务深链（新系统 iframe 嵌入的智能体问答，3qfx 单智能体 lite 模式的独立复制）**: goPath=`agentfx`（`${loginBase}?password=…&taskId=…&goPath=agentfx&embed=1&hideJump=1&theme=dark-blue`）。与 3qfx 的差异：①任务详情不走外部 consumer，改调**本系统 Gateway** `GET {backend}/taskAnalyseSearch/cop-task-detail?taskId=`（`apiFetch` 带刚登录的 DeerFlow 态；任务数据来自 TaskCOP 任务表，与任务列表/报告导入同一份）；②**固定使用内置智能体** `agentfx-analyst`（不走业务映射）；③路由 `task-management/plan-task-agentfx/agent/:agent_id/chats`，页面为独立复制的 `AgentFxWorkspace.tsx`（`AgentFxWorkspace`/`AgentFxIndexResolver`/`AgentFxChat` —— 左「当前任务」卡 + 1:N 对话列表 + 新建对话，`AgentChatPage taskBind` 自动发开场白；无 TaskJumpBar/清除记录/闸门/xdfx 行动卡）。模块 `core/auth/agentfx-deeplink.ts`（`isAgentfxGoPath`/`fetchAgentfxTaskDetail`/`resolveAgentfxDeeplinkTarget`）；任务详情整包仍存共享键 `login.copTaskDetail`（按标签页隔离），`AgentChatPage` 的 taskBind 自恢复对 agentfx 生效。`LoginPage` 在既有深链分支前用 `isAgentfxGoPath` 分流。**内置「任务研判报告助手」**：后端 seeder `app/gateway/routers/_agentfx_seed.py` + `_agentfx_seed_assets/`（config.yaml + SOUL.md，目录存在不覆盖；app.py lifespan 在 `_sync_legacy_agents` 之前调用，自动进 agents 表 user_id IS NULL）——SOUL 规定工作流「搜集信息（`web_search`，**首步不可跳过**）→ 每次检索 JSON 原样落盘 `/mnt/user-data/workspace/hits/qN.json` → **一条命令** `task-report-build`（group `all`）技能函数转换成 14 类 `task-reports.json`（模型禁止手写该 JSON；分页技能 `task-report-{enemy,our,env,judge}` 仅用于事后补跑单页；五者都是共享引擎 `task-report-lib/convert_lib.py` 的瘦 CLI，`resolve_hit_files` 对虚拟绝对路径读空的情况自动回退到相对写法并在 `warnings` 里列出尝试过的路径，免得智能体自己写脚本排查）→ `write_file` 生成 `/mnt/user-data/outputs/report.md` → 聊天总结 → 引导入库」，硬性约束：categoryType 逐字用 14 个全称（禁缩写自造如「DQ关键事件」）、JSON 直接写汉字禁 `\uXXXX` 转义、每类必须有实质内容不许空数组/纯占位、文件一律用 `/mnt/user-data/...` 虚拟路径（防宿主路径泄漏进 tool args）。**检索依赖 `config.yaml tools.web_search`（DDG，enabled 已开；内网需换 configurable_search 时改回并填 endpoint）**。任务工作区输入框在 `taskCtxOn` 时隐藏「写作/记忆/参考文献」（InputBox `hideContextTools` prop）与「知识空间」（不传 knowledgeSelector）；消息流里 write_file 文件卡片只显示文件名（`artifactDisplayName` 收敛宿主/虚拟路径）。**入库两条路径**：(a) **前端协助卡** —— `AgentChatPage`（taskBind 且非 taskGate）检测线程 artifacts 出现 `task-reports.json`（按文件名后缀匹配，兼容本地沙箱记录的宿主路径）且流式结束时，向 displayThread 尾部注入 `additional_kwargs.task_report_import_approval` 虚拟 ai 消息（`core/messages/utils.ts` 分组 `assistant:task-report-import` + `MessageList` 的 `taskReportImportSlot` 插槽渲染 `TaskReportImportCard`），点「开始入库」前端校验（`strategy-components/lib/agentfx-report-schema.ts`，14 类 + contentJson 合法 JSON + **\u 转义归一化还原为汉字**，与技能脚本同规则）后 `importTaskReport`（`strategy-components/api/task-reports.ts`）POST 导入接口整体替换；任务已有详情**不抑制**卡片（入库即整体替换，卡片文案说明覆盖语义），导入成功按 thread 记 sessionStorage（刷新不重复询问）、「暂不入库」为会话内记忆；(b) **入库技能** `task-report-import`（seeder 一并复制到 `skills/public/`，public 类技能 extensions_config 缺省即启用）—— 用户聊天里说「入库」时智能体按 SKILL.md 用 bash 跑 `scripts/task_report_import.py`（纯标准库：同样的校验规则 + 转义归一化；**默认关闭 SSL 证书校验** `ssl._create_unverified_context` + 忽略代理，适配内网自签证书；鉴权 `--token`/env `AGENTFX_IMPORT_TOKEN`→`DEERFLOW_AUTH_TOKEN`→`TOOLS_TOKEN` 优先，缺省经公共端点 `POST /api/parallel-agents/auth/token` 以 `agentfx-import` 用户现签 token——内网既有鉴权旁路；gateway 地址 env `AGENTFX_GATEWAY_URL` 或 `http://127.0.0.1:{DEER_FLOW_GATEWAY_PORT}`）；`--strict` 可要求 14 类齐全，默认允许部分导入并在 stdout JSON 的 `missing_categories` 里列缺。入库成功后任务 TaskCOP 状态自动置 25（已完成分析）。**入库成功通知宿主**（iframe 嵌入场景）：两条路径成功后都会 `window.top.postMessage({source: "magent-web", type: "Line truncated
 - **iframe 嵌入模式 (外部系统用 iframe 套用深链问答/会商)** — 三个**按标签页**开关，全部由深链 URL 参数开启、存进同一份 `sessionStorage` 会话（`embed.session`，键名常量在 `core/embed/embed-session.ts`），跨登录跳转/刷新/页内导航存活，**绝不跨标签污染**同浏览器另开的正常系统页。核心隔离手法：用 `sessionStorage`（按标签页/浏览上下文隔离，iframe 即便同源也有独立一份）而非 `localStorage`（跨标签共享）。开关：(1) **`?embed=1`（可带 `&theme=`）** — 去全局 chrome（`PageLayout` 的 `pageSidebarAllowed && !isEmbedActive()` → 隐藏 Header + PageSidebar）+ 按外部主题色**强制**明/暗：走 next-themes 的 `forcedTheme`（`App.tsx` `AppProviders` 调 `resolveForcedEmbedTheme`，**不写** localStorage `strategy-theme`），离散映射 `dark-blue`/`dark`→深、其余→浅；嵌入侧**绝不**调 `setTheme`/`persistSidebarEnabled`（那俩落 localStorage 跨标签污染，`LoginPage` 据 `readEmbedParam` 跳过）。(2) **`?hideJump=1`** — 隐藏深链底部「快捷跳转」栏 `TaskJumpBar` 的两部分（底部「下一步」等按钮 + 右侧垂直居中悬浮菜单），单智能体问答 + 会商共用该栏，`isJumpBarHidden()` 为真时整条 `return null`。(3) **登录用户隔离** — 嵌入态下鉴权/身份键（`deerflow.auth` token、`userInfo`、`login.*`、`tools_token`、maxkey/userDetail token）全部经 `core/auth/scoped-storage.ts` 的 `authStorage()`（嵌入→sessionStorage / 正常→localStorage）读写，使 iframe 里登录的用户与正常登录用户**完全隔离**、互不覆盖；所有 token 读取都过 `getStoredAuth()`/`getAuthorizationHeaderValue()`（API 客户端 `core/api/*` 全走这俩），改中心函数即让全体调用方自动隔离；跨标签账号变更监听 `AuthSyncWatcher`（`core/auth/sync.tsx`）在嵌入态禁用。嵌入会话在 `main.tsx` 渲染前 `syncEmbedSessionFromCurrentUrl()` 同步启用（早于任何鉴权写入，避免首帧 effect 顺序漏写 localStorage）；`AppProviders` 的 effect 再按 SPA 导航同步。`embed=0`/`hideJump=0` 可显式关闭。正常（非嵌入）标签页所有 `isXxx()` 恒 false，行为**零变化**。第三个开关 `?isolate=1`（**独立登录会话**）把同一套**登录用户隔离**单独提供给**普通（带 chrome）标签页**——只切换鉴权存储、不去 chrome / 不强制主题 / 不动跳转栏：`authStorage()` 的条件从「仅嵌入」放宽为 `isEmbedActive() || isIsolatedSession()`，`AuthSyncWatcher` 的跨标签监听对嵌入态**或**独立态都即时忽略（handler 内实时判，运行时开关也即刻生效）。除 URL 参数外，**设置 → 外观 →「登录会话」** 有一个 Switch「独立登录会话（本标签页）」运行时切换（`setIsolatedSession`，`appearance-settings-page.tsx`）：**开启时先 `migrateAuthToSession()`**（`scoped-storage.ts`，把 localStorage 的受保护键 `deerflow.auth`/`userInfo`/`userId`/`tools_token` + `login.*` 前缀快照搬进 sessionStorage）再翻标志，故无感不登出；此后本标签页登录态独立——别处登录/换号影响不到它，它换号也影响不到别人，但关掉该标签即结束（需重登）。开启给 toast 提示。
 
 ### Configuration

docs/WIKI_ROUNDTRIP_ACCEPTANCE_20260903.md

@@ -0,0 +1,117 @@
+# Wiki 数据流转与本地编码验收（2026-09-03）
+
+## 结论
+
+本地 BGE-M3 小批量编码已安装、配置并实际运行。已有 Wiki 的向量化、自动沉淀、
+普通库文件导出、助手库异步导入、助手库文件导出、空普通库回流及两端向量检索已实测通过。
+**技能自动生成 Wiki 尚未完成验收**：WeKnora 的两个生成模型都返回 HTTP 402
+`Insufficient Balance`。不能把后半段通过等同于全链路通过。
+
+本次修改运行在本地 DeerFlow 开发服务（前端 5175、后端 8001），连接用户提供的远端
+WeKnora；没有把业务代码发布到服务器，没有提交 Git，也没有直接写 WeKnora 图数据库。
+
+## 本地编码配置
+
+- 实现：FastEmbed / ONNX Runtime CPU，官方 `BAAI/bge-m3` 权重。
+- 配置名：`bge-embedding-m3`，1024 维，每批 2 条，2 个 CPU 推理线程。
+- 运行依赖：FastEmbed 随标准后端依赖安装；模型必须提前放在离线目录中，仍按需加载，不影响主服务启动。
+- 权重：约 2.3 GB，持久缓存 `C:\Users\ji\.cache\deerflow\embeddings`，不进入业务仓库。
+- 配置：`llmwiki.local_wiki_index.embedding.provider: local`；可用
+  `local_model_path` 指定离线权重目录，详见后端 README。
+- 查询向量在本地实时编码。已有 Wiki 在内容哈希、模型指纹匹配且向量非空时直接复用。
+  不同模型或维度不能混用；导入不静默重新编码。
+- 原始文档分段向量与模型生成后的 Wiki 文本不同，不能相互冒用。本次新建的是 Wiki
+  正文的 BGE-M3 索引，不是把既有 512 维文档向量改名为 1024 维。
+
+## 实际数据验收
+
+来源是已有普通知识库“图片测试111”，没有改写其 Wiki 内容。
+
+| 阶段 | Wiki | Wiki 向量 | 实体 | 引用关系 |
+| --- | ---: | ---: | ---: | ---: |
+| 普通知识库导出 | 19 | 101 | 19 | 108 |
+| 助手知识库导入后导出 | 19 | 101 | 19 | 108 |
+| 新建普通知识库回流后导出 | 19 | 101 | 19 | 108 |
+| 知识梳理总库导出（7 个来源记录） | 19 | 101 | 19 | 108 |
+
+逐项断言通过：
+
+1. 三份包的 Wiki slug、标题、正文、摘要、页面类型、别名、分类路径、出链一致。
+2. 101 条向量的原始 float32 字节、分段编号、维度和模型指纹完全一致。
+3. 将导入前后实体 ID 映射回原 Wiki slug 后，108 条关系的端点及谓词集合完全一致。
+4. 总库导出没有因多个来源重复同步而重复导出同一当前页面的分段向量。
+5. 元数据回归测试另覆盖 tags、目录恢复、原始文档片段不计入 Wiki 数量、原生技能无
+   ownership 记录时可被选中、短 Wiki 不漏向量、模型指纹不兼容时不假装向量检索。
+
+普通包约 1.01 MB，助手包约 0.79 MB，回流包约 0.83 MB。普通包还带 2 个原始文档及
+108 个原始片段；助手导出提供 Wiki、Wiki 向量和关系，不重新上传原始文档触发二次生成。
+
+### 检索
+
+实际查询：“军方用什么工具评估极端天气带来的风险？”
+
+- 回流普通库 `/api/llmwiki/search` 返回 `mode=vector`，首条“国防气候评估工具”。
+- 助手库 `/api/assistant-knowledge/search` 返回 `retrieval_mode=vector`，首条同上；
+  首个命中分段余弦相似度约 0.6343。
+- 浏览器实际提交总库检索，显示“向量检索 · 余弦相似度”和相同命中；不是只检查返回字段。
+- 普通库采用已有页面级聚合评分，因此页面最终分数与单分段余弦值不必相等。
+- 回流的向量写入 **DeerFlow 管理的本地 Wiki 索引**。未写入 WeKnora 原生向量数据库，
+  本次结论适用于本系统问答检索，不能声称原生 WeKnora 自身的检索也已完成该向量导入。
+
+### 页面
+
+普通与助手库复用同一 Wiki 阅读组件：目录树、类型/标签筛选、分类面包屑、别名标签、
+正文内链、出链、反向链接及邻接关系视图。窄窗口可收起目录。
+
+浏览器验证了“索引 → 国防气候评估工具”、展开关系视图、助手 Wiki 跳回普通库来源，
+以及普通 Wiki 的“在知识梳理中查看”反向跳转。
+
+### 验收数据位置
+
+- 原有普通库：`48f669dc-433e-4aab-b5ea-897b6f7a3d2f`
+- 知识梳理总库：`c3fd9841-0718-44dc-860e-aae3020fd485`
+- 最终助手测试库：`489be905-08c8-40fe-8d60-42ac21dd945a`
+- 最终普通回流测试库：`428162aa-03f6-4c61-8994-360f2f39e0c9`
+
+新建测试库名称均以“Wiki链路验收-0903-1826”开头，保留用于复核；未删除用户已有库。
+本地 `.runtime/wiki-live-result.json` 保存验收结果，`.runtime/wiki_live_acceptance.py`
+保存本次验收流程，均为忽略的运行产物，不包含认证口令。
+
+## 这次实际修复的问题
+
+- 内置技能只有磁盘目录、没有归属记录时，被错误判定为不存在。
+- 技能应上传去代码后的知识正文，让 WeKnora 生成 Wiki，而不是伪造一个 `skill` 类型页面。
+- Wiki 生成等待使用实际 stats 接口；零页结果明确失败，不无期限等待。
+- 向量化完成后自动导出沉淀到总库，并阻断导出回调重复触发全量同步。
+- 短摘要和短正文同时存在时，旧分段阈值会将整页过滤为零向量。
+- 分类路径必须先创建 WeKnora folder 并绑定 folder_id；只传 category_path 会被服务端清空。
+- Wiki 的标签/分类/别名/原始引用保留；图节点绑定真实 Wiki，避免生成重复的空实体页面。
+- 保留归一化 float32 原始字节；导入中不能用 `section_index or index`，因为合法编号 0 会被改写。
+- 总库多个来源保留审计，但检索与导出只使用当前 Wiki 版本对应的向量，避免旧贡献污染检索。
+- 包解析改为同盘临时 SQLite，上传先落盘再异步导入，导出完成后才提供文件下载。
+
+## 阻塞与未通过的范围
+
+1. 技能 `knowledge-base-ingest` 已送入专门创建的普通测试库，但远端
+   `deepseek-v4-flash` 和 `qwen3.6-flash` 均因余额不足失败。WeKnora 即使失败也可能把
+   文档 parse_status 标为 completed。需恢复可用生成模型后重新运行技能全链路验收。
+2. 已采用磁盘暂存和有界批处理，但本次只有约 1 MB 实测，**未做数 GB 压测、断点续传、
+   进程中断恢复验收**。大包部署仍需磁盘容量、代理 body size 和超时配置。
+3. 当前实体去重主要按类型及规范化名称；这次没有完成跨别名、歧义实体的模型对齐及
+   多来源事实冲突合并验收，不能视为这一历史需求已全面完成。
+4. 重复上传仍会保留独立来源记录。向量导出已消除旧版本重复，但上传身份幂等、部分远端
+   写入失败后的无损重试、跨实例图片资源打包仍需独立验证。
+5. 当前版本已补充自动增量链路：服务启动立即补扫，之后默认每 30 秒扫描全部普通
+   知识库；Wiki 抽取完成后无需手工点击向量化，并自动以来源快照覆盖同步到知识梳理总库。
+6. 回流当前只允许新建空 Wiki 普通库，避免覆盖已有页面。普通库现有页面列表的超大规模
+   分页与助手问答的最终生成回答不属于这轮通过结论。
+
+## 自动化检查
+
+- 后端相关测试：118 passed（assistant repository、Wiki sync、package roundtrip、
+  WeKnora 接口、向量检索与知识库管理）。
+- 修改的 Python 功能文件 Ruff 检查通过；app.py 既有启动顺序导致的 E402 不在此次改动中处理。
+- `git diff --check` 通过（只有仓库换行提示）。
+- 前端完整 `pnpm typecheck` 未通过：57 个既有/本轮范围外错误，涉及 nextra 缺失、Markdown
+  插件类型及其他模块；本轮新建/修改的 Wiki 组件、助手 API、技能面板没有出现在错误清单中。
+  浏览器实际页面与跳转已验证，但不能声称全项目构建通过。

docs/agentscope-多智能体报告协作工作台-前端实施计划.md

@@ -1,13 +1,25 @@
 # AgentScope 2.0 多智能体报告协作工作台——前端实施计划
 
-> 文档状态：待评审、尚未开始编码
+> 文档状态：前端代码已落地、契约冻结；联调等待后端运行中干预与报告改写
-> 编写日期：2026-09-02
+> 编写日期：2026-09-02；进度更新日期：2026-09-06
 > 目标项目：`F:\react01\deeflow-code\deerflow-server\frontend-web`
 > 视觉与交互参考：`F:\react01\coze-frontend\frontend\apps\coze-studio`
 > 参考页面：`http://localhost:3000/work_flow?space_id=1&workflow_id=wf_88cb9f4c6642`
 > 配套后端计划：`docs/agentscope-多智能体报告协作工作台-后端实施计划.md`
 > 本文只规划新增页面，不修改现有多智能体会商页面，不复用旧 Workflow Studio 执行状态。
 
+## 0. 当前进度
+
+`frontend-web/src/report-collaboration/` 已实现两栏工作台、会话/方案/run API 客户端、mock driver、SSE reducer、`MessageList` 适配、方案卡、画布、节点抽屉、Composer、报告预览与历史。`RC-FE-001`～`013` 的页面骨架与契约层视为完成。
+
+后端已通规划前路径（澄清 → 出方案 → 选定 → `queued` run），见后端计划 §0。前端真实执行体验仍受阻：
+
+- `GET /runs/{id}/stream` 已挂载（`RC-BE-011`）；dispatcher/租约已落地（`RC-BE-012`），默认 `worker_enabled=false` 仍不自动领取 queued run。
+- 报告改写 / 恢复接口已由后端 `RC-BE-015` 挂载。
+- 质量角色已由 `QualityRoleKernel` 跑通（`RC-BE-013`）；真实 AgentScope 模型/`web_search` 仍待后续票。
+
+联调顺序：先打开 `report_collaboration.enabled` 验证规划前 REST 与 `GET /runs/{id}/stream` 重放；画布自动执行需同时打开 `worker_enabled`（默认关）。
+
 ## 1. 前端目标
 
 新增独立的「报告协作」工作台。用户可以通过对话提出任意报告需求，查看系统生成的多个协作方案，点击方案卡片在流程图中预览协作结构，确认后观察多智能体执行，并在全过程通过统一对话框提出修改意见。
@@ -662,6 +674,8 @@ POST   /api/report-collaboration/sessions/{session_id}/report-rewrites/{id}/appl
 
 ## 9. 前端开发顺序
 
+页面与契约层已完成（代码在 `frontend-web/src/report-collaboration/`）：
+
 1. `RC-FE-001`：视觉截图与行为基线。
 2. `RC-FE-002`：路由、菜单和左对话/右画布两栏空壳。
 3. `RC-FE-003`：页面 token、弹窗、抽屉和响应式。
@@ -678,15 +692,17 @@ POST   /api/report-collaboration/sessions/{session_id}/report-rewrites/{id}/appl
 
 依赖规则：
 
-- `RC-FE-004` 必须等待前后端契约冻结。
+- 契约已冻结为 `src/report-collaboration/api/types.ts`；后端 `RC-BE-001` 已对齐。
-- 页面骨架和视觉可与后端 BE-0～BE-3 并行。
+- 真实 SSE 联调：后端 `RC-BE-011` 已挂载 `GET /runs/{id}/stream`；默认无后台循环时流只会重放已入库事件。
-- 真实 SSE 联调必须等待后端 durable event store。
+- 报告版本操作已接后端 `RC-BE-015`（改写候选 / apply / restore）。
-- 报告版本操作必须等待后端候选应用语义完成。
+- 执行画布实时状态依赖打开 `worker_enabled`；质量角色内核已在 `RC-BE-013` 落地，真实成员见 `RC-BE-017`。
 
 ---
 
 ## 10. 前端完成定义
 
+页面与 mock 联调路径已落地。真实后端可联调 `GET /runs/{id}/stream`、领取/恢复（`RC-BE-012`，默认不挂 worker）、质量角色（`RC-BE-013`）以及报告改写/恢复（`RC-BE-015`）。此前以 mock driver 覆盖交互，不以「前端未编码」计未完成。
+
 前端只有同时满足以下条件才算完成：
 
 1. 页面结构与 Coze 参考页面逐状态验收通过。

docs/agentscope-多智能体报告协作工作台-前端对接指南.md

@@ -0,0 +1,481 @@
+# 报告协作工作台 — 前端对接指南
+
+> **适用版本：** RC-BE-000～018 已落地（2026-09-06）  
+> **配套文档：**  
+> - [前端实施计划](./agentscope-多智能体报告协作工作台-前端实施计划.md)  
+> - [后端实施计划](./agentscope-多智能体报告协作工作台-后端实施计划.md)  
+> - 模块 README：`frontend-web/src/report-collaboration/README.md`
+
+本文说明**前端如何对接真实后端**：环境配置、API 契约、用户流程、状态机、错误处理与联调验收。前端 API 客户端与页面已实现，通常**无需再写一套 HTTP 层**。
+
+---
+
+## 1. 结论速览
+
+| 问题 | 答案 |
+|------|------|
+| 前端还要写接口吗？ | **不用**。`src/report-collaboration/api/` 已封装 REST + SSE，页面通过 `getReportCollaborationDriver()` 调用。 |
+| 为什么调不通？ | 最常见：`config.yaml` 里 `report_collaboration.enabled: false` → 全部 **503**；或 `worker_enabled: false` → run 不入队执行。 |
+| Mock 和真后端怎么切？ | **Mock 已移除**。前端永远请求真实后端（`deerflow.rc-mock` / `VITE_RC_MOCK` 开关已删除）；联调需 `enabled: true`。 |
+| 字段会和 MySQL 对不上吗？ | 前端只认 JSON 契约（`api/types.ts`），不直连表。缺列表现为后端 500/SQL 错误，部署后需**重启 Gateway** 跑 `create_all` + 列同步。 |
+| 从哪进页面？ | `/page/workspace/report-collaboration`（新会话）或 `/page/workspace/report-collaboration/:sessionId`。侧边栏入口默认注释，可直接 URL 访问。 |
+
+---
+
+## 2. 架构：前端已有什么
+
+```
+ReportCollaborationPage
+  └─ useReportCollaborationSession（唯一数据入口）
+       ├─ driver.getSnapshot()           ← REST 冷启动
+       ├─ driver.openRunStream()          ← SSE 实时事件
+       ├─ driver.sendMessage / createCommand / startRun …
+       └─ event-reducer                   ← 事件 → UI 状态
+
+ReportConversationPanel
+  └─ MessageList（message-adapter 映射 CollaborationMessage → LangGraph Message）
+```
+
+### 2.1 目录结构
+
+```text
+frontend-web/src/report-collaboration/
+  api/
+    types.ts          # 冻结契约（snake_case，与后端 Pydantic 一致）
+    client.ts         # rcFetch：鉴权、幂等键、乐观锁、错误映射
+    sessions.ts       # 会话 CRUD、消息
+    plans.ts          # 方案请求 / 列表 / 选定
+    runs.ts           # Run、SSE、命令、节点合同
+    reports.ts        # 报告版本、改写、恢复
+    driver.ts         # 真实后端统一门面（Mock 驱动已移除）
+  state/
+    event-normalizer.ts
+    event-reducer.ts
+    selectors.ts
+    message-adapter.ts
+  hooks/
+    useReportCollaborationSession.ts   # 快照 → SSE → reducer → 动作
+    useReportCollaborationStream.ts    # 断线重连、after_seq 续接
+    useReportCollaborationMessages.ts
+  components/ …
+  pages/ReportCollaborationPage.tsx
+```
+
+### 2.2 事实源原则
+
+- **冷启动：** `GET /sessions/{id}` 返回 `SessionSnapshot`（session、messages、plans、run、nodes、agent_runs、commands、report_versions、last_seq）。
+- **运行中：** `GET /runs/{id}/stream?after_seq=N` 订阅 durable SSE。
+- **断线 / 序号缺口：** `GET /runs/{id}/events?after_seq=N` REST 补拉。
+- **澄清 / 规划阶段（尚无 run）：** 每 2.5s 轮询快照（后端事件主要在 run 流上）。
+
+纯展示状态（预览方案、聚焦成员、面板宽度）**不**写入服务器，仅存前端。
+
+---
+
+## 3. 后端启用与部署
+
+### 3.1 必改配置
+
+文件：`offline-backend-20260512/backend/config.yaml`
+
+```yaml
+report_collaboration:
+  enabled: false          # 联调必须改为 true
+  worker_enabled: false   # 要看成员执行必须 true
+  planner_model: null     # 建议填可用模型名
+  coordinator_model: null
+  research_model: null
+  writer_model: null
+  reviewer_model: null
+  # … token_budget、max_concurrent_runs_per_user 等见同文件
+```
+
+| 配置 | 现象 |
+|------|------|
+| `enabled: false` | 所有路由 **503**，`code: REPORT_COLLABORATION_DISABLED` |
+| `enabled: true`，`worker_enabled: false` | REST/SSE 可用，run 入队但不自动执行（测 API 可用，无成员流式输出） |
+| 两者 `true` + 模型配置完整 | 完整联调 |
+
+### 3.2 MySQL / 表结构
+
+生产环境 Alembic 自动升级默认关闭，启动时走 `create_all` + `_ensure_orm_columns_sync`。
+
+- 迁移脚本（可选手动跑）：`20260905_01`、`20260906_01`、`20260907_01`
+- ORM：`packages/harness/deerflow/persistence/report_collaboration/model.py`（13 张表）
+- **部署后务必重启 Gateway**，观察日志是否有 `Failed to auto-add column report_collaboration_*`
+
+已有 RC-003 时代旧表会通过列同步补上 `template_snapshot_json`、`budget_snapshot_json`、`usage_json`、`budget_exhausted_reason` 等可空列，并创建 `rewrite_proposals`、`audits`。
+
+### 3.3 前端环境变量
+
+| 变量 | 说明 |
+|------|------|
+| `VITE_BACKEND_BASE_URL` | Gateway 地址，默认 `http://127.0.0.1:8001` |
+
+请求经 `apiFetch`，自动携带登录 JWT（`credentials: "include"`）。**必须先登录 DeerFlow**。
+
+---
+
+## 4. API 基址与请求约定
+
+### 4.1 Base URL
+
+```text
+{VITE_BACKEND_BASE_URL}/api/report-collaboration
+```
+
+代码常量：`REPORT_COLLABORATION_BASE()`（`api/client.ts`）。
+
+### 4.2 请求头
+
+| Header | 何时携带 | 说明 |
+|--------|----------|------|
+| `Authorization` | 全部 | 由 `apiFetch` 注入 |
+| `X-Idempotency-Key` | 写操作 | 格式 `rc-{uuid}`；重复提交返回首次结果 |
+| `X-Expected-Revision` | 选方案、开 run、改会话等 | 会话 `requirement_revision` 或方案 `revision` |
+| `Accept: text/event-stream` | SSE | `openRunStream` |
+
+### 4.3 错误响应格式
+
+```json
+{
+  "code": "REPORT_COLLABORATION_DISABLED",
+  "message": "报告协作工作台未启用",
+  "detail": { }
+}
+```
+
+前端映射（`api/client.ts`）：
+
+| HTTP | 异常类 | 典型场景 |
+|------|--------|----------|
+| 409 | `ConflictError` | revision 过期、active run 冲突 |
+| 422 | `ValidationError` | 参数/语义错误、缺幂等键 |
+| 429 | `RateLimitError` | 预算耗尽、每用户并发 run 上限 |
+| 5xx | `ServerError` | 可带同一幂等键重试 |
+| 0 | `NetworkError` | fetch 失败 |
+
+### 4.4 完整路由清单（与前端 client 对齐）
+
+| 方法 | 路径 | 前端模块 |
+|------|------|----------|
+| POST | `/sessions` | `sessions.createSession` |
+| GET | `/sessions` | `sessions.listSessions` |
+| GET | `/sessions/{id}` | `sessions.getSessionSnapshot` |
+| PATCH | `/sessions/{id}` | `sessions.updateSession` |
+| DELETE | `/sessions/{id}` | `sessions.deleteSession` |
+| GET | `/sessions/{id}/messages` | `sessions.listMessages` |
+| POST | `/sessions/{id}/messages` | `sessions.sendMessage` |
+| POST | `/sessions/{id}/plan-requests` | `plans.requestPlans` |
+| GET | `/sessions/{id}/plans` | `plans.listPlans` |
+| POST | `/sessions/{id}/plans/{planId}/select` | `plans.selectPlan` |
+| POST | `/sessions/{id}/runs` | `runs.startRun` |
+| GET | `/sessions/{id}/reports` | `reports.listReportVersions` |
+| POST | `/sessions/{id}/report-rewrites` | `reports.createRewrite` |
+| POST | `/sessions/{id}/report-rewrites/{id}/apply` | `reports.applyRewrite` |
+| POST | `/sessions/{id}/report-versions/{id}/restore` | `reports.restoreReportVersion` |
+| GET | `/runs/{id}` | `runs.getRun` |
+| GET | `/runs/{id}/events` | `runs.listRunEvents` |
+| GET | `/runs/{id}/stream` | `runs.openRunStream` |
+| POST | `/runs/{id}/cancel` | `runs.cancelRun` |
+| POST | `/runs/{id}/commands` | `runs.createCommand` |
+| POST | `/runs/{id}/commands/{id}/confirm` | `runs.confirmCommand` |
+| POST | `/runs/{id}/commands/{id}/cancel` | `runs.cancelCommand` |
+| GET | `/runs/{id}/nodes/{nodeId}/contract` | `runs.getNodeContract` |
+| GET | `/runs/{id}/artifacts` | （后端已暴露，前端按需接） |
+| GET | `/runs/{id}/sources` | （后端已暴露，前端按需接） |
+
+---
+
+## 5. 用户流程与 API 时序
+
+```mermaid
+sequenceDiagram
+  participant U as 用户
+  participant FE as 前端 RC
+  participant API as Gateway
+  participant W as Worker
+
+  U->>FE: 输入需求
+  FE->>API: POST /sessions
+  FE->>API: POST /sessions/{id}/messages
+  API-->>FE: 澄清（快照 messages）
+  U->>FE: 回答澄清
+  FE->>API: POST /messages
+  FE->>API: POST /plan-requests
+  API-->>FE: 候选方案（快照 plans）
+  U->>FE: 采用方案
+  FE->>API: POST /plans/{id}/select
+  U->>FE: 开始协作
+  FE->>API: POST /runs
+  FE->>API: GET /runs/{id}/stream
+  W-->>API: 持久化事件
+  API-->>FE: SSE
+  U->>FE: 运行中干预
+  FE->>API: POST /commands → confirm
+```
+
+### 5.1 阶段 0：进入页面
+
+| 路由 | 行为 |
+|------|------|
+| `/page/workspace/report-collaboration` | 空态；`POST /sessions` 后跳转带 `sessionId` |
+| `/page/workspace/report-collaboration/:sessionId` | 加载快照；有 `location.state.rcInitialMessage` 时自动发首条消息 |
+
+路由注册：`frontend-web/src/pages/WorkspaceRoutes.tsx`。  
+侧边栏入口已在 `workspace-nav-chat-list.tsx` 中放开（「报告协作」项），也可直接访问 URL。
+
+### 5.2 阶段 1：需求澄清（无 run）
+
+```http
+POST /api/report-collaboration/sessions
+POST /api/report-collaboration/sessions/{sessionId}/messages
+Content-Type: application/json
+
+{ "text": "请写一份…", "target_node_id": null, "agent_run_id": null }
+```
+
+- `useReportCollaborationSession.send()`：当 `session.status` 不是 `running` / `awaiting_input` / `reviewing` 时走 `sendMessage`。
+- 会话状态：`empty` → `clarifying` → `planning` → `proposal_ready`。
+- 澄清问题以 `CollaborationMessage` 进入时间线；业务卡通过 `MessageList` 的 `businessCardSlot` 渲染（`additional_kwargs.report_collaboration_card`）。
+
+### 5.3 阶段 2：候选方案
+
+```http
+POST /api/report-collaboration/sessions/{sessionId}/plan-requests
+POST /api/report-collaboration/sessions/{sessionId}/plans/{planId}/select
+```
+
+- **预览方案**（`previewPlanId`）：纯前端，不调 API。
+- **采用方案**：`select` 写 `selected_plan_id`，**不**创建 run。
+- 409：方案 revision 过期 → 前端 `refreshSnapshot`，提示用户重选。
+- 右栏 `ReportFlowCanvas` 使用 `PlanNode` / `PlanEdge` 渲染 DAG。
+
+### 5.4 阶段 3：开始执行与 SSE
+
+```http
+POST /api/report-collaboration/sessions/{sessionId}/runs
+{ "plan_id": "plan-xxx" }
+
+GET /api/report-collaboration/runs/{runId}/stream?after_seq=0
+Accept: text/event-stream
+```
+
+SSE 每条 `data:` 为 JSON：
+
+```typescript
+interface CollaborationEvent {
+  eventId: string;
+  sessionId: string;
+  runId?: string | null;
+  seq: number;
+  type: CollaborationEventType;
+  timestamp: string;
+  data: unknown;
+}
+```
+
+常用 `type`（完整列表见 `api/types.ts`）：
+
+| 类型 | 含义 |
+|------|------|
+| `message.created` / `message.delta` / `message.completed` | 对话镜像流式 |
+| `tool_call.*` / `tool_result.*` | 工具调用与返回 |
+| `team_message.*` | 成员 / 协调者广播 |
+| `plan.proposed` / `plan.selected` | 方案生命周期 |
+| `run.status.changed` | Run 状态 |
+| `node.status.changed` / `node.progress` | 节点执行 |
+| `command.confirmation.required` | 需用户确认的干预 |
+| `report.version.created` | 报告版本落盘 |
+| `heartbeat` | 保活 |
+
+### 5.5 阶段 4：运行中干预
+
+```http
+POST /api/report-collaboration/runs/{runId}/commands
+POST /api/report-collaboration/runs/{runId}/commands/{commandId}/confirm
+POST /api/report-collaboration/runs/{runId}/commands/{commandId}/cancel
+POST /api/report-collaboration/runs/{runId}/cancel
+```
+
+- Run 活跃时 `send()` 自动走 `createCommand`（而非 `sendMessage`）。
+- 可从节点抽屉 / `AgentStageSelector` 传入 `target_node_id`、`agent_run_id`。
+- `InterventionCard` 展示 `confirmation_required` 命令；确认后调 `confirmCommand`。
+
+`CommandIntent` 枚举（后端分类，前端展示 reason/impact）：`answer_question`、`update_requirements`、`research_again`、`rewrite_section`、`rerun_node`、`replan`、`cancel` 等。
+
+### 5.6 阶段 5：报告版本与改写
+
+```http
+GET  /api/report-collaboration/sessions/{sessionId}/reports
+POST /api/report-collaboration/sessions/{sessionId}/report-rewrites
+POST /api/report-collaboration/sessions/{sessionId}/report-rewrites/{rewriteId}/apply
+POST /api/report-collaboration/sessions/{sessionId}/report-versions/{versionId}/restore
+```
+
+- `createRewrite` 只生成候选，不直接覆盖正式版本。
+- `applyRewrite` / `restoreReportVersion` 产生新的 head 版本，历史保留。
+- `ReportPreviewDialog` 展示 `ReportVersion.markdown`。
+
+---
+
+## 6. 前端状态机（接入方须知）
+
+**不要**在页面里用零散 REST 字段拼 UI 状态。统一路径：
+
+```text
+SessionSnapshot → applySessionSnapshot()
+CollaborationEvent[] → normalizeCollaborationEvent() → applyCollaborationEvents()
+→ selectors（derivePagePhase、selectPlanForCanvas、…）
+```
+
+### 6.1 核心 Selector
+
+| Selector | 用途 |
+|----------|------|
+| `derivePagePhase` | Composer 占位、方案卡、空态 |
+| `selectPlanForCanvas` | 画布 DAG（含预览方案） |
+| `selectAgentTabs` | 并行成员 Tab |
+| `selectNodeStatusMap` | 节点颜色 / 状态 |
+| `selectPendingConfirmationCommands` | 干预确认卡 |
+| `selectHeadReportVersion` | 报告预览入口 |
+| `selectStreamingAgentRunIds` | 流式成员指示 |
+
+### 6.2 SSE 连接策略（`useReportCollaborationStream`）
+
+- Run 非终态时连接；`completed` / `failed` / `cancelled` 后关流并 REST 最终补拉。
+- 断线：指数退避重连（1s～30s），`after_seq` 取 reducer 内 `lastSeq`。
+- `hasSeqGap`：暂停 live 应用，先 `listRunEvents` 回填。
+
+### 6.3 乐观消息
+
+用户发送时插入 `metadata.optimistic: true` 的 pending 消息；服务端镜像带相同 `idempotency_key` 时 reducer 原地替换。
+
+---
+
+## 7. 消息与 MessageList 复用
+
+`useReportCollaborationMessages` 将 `CollaborationMessage[]` 转为 `@langchain/langgraph-sdk` 的 `Message[]`，并构造合成 `BaseStream` 供 `MessageList` 消费。
+
+| 来源 | 渲染 |
+|------|------|
+| `human` / `ai` 文本 | 普通气泡 |
+| `tool_calls` + `tool` | 现有工具卡 |
+| `team_message` 事件 | 带 `name` 的成员发言 |
+| 业务卡 | `businessCardSlot`（方案组、命令确认、报告可用） |
+
+分组键：`core/messages/utils.ts` 中 `assistant:task-report-import` 同级扩展 `assistant:business-card`，判据 `additional_kwargs.report_collaboration_card`。
+
+### 7.1 在其他页面嵌入 RC（最小集）
+
+1. `useReportCollaborationSession(sessionId)`
+2. `ThreadContext.Provider` + `MessageList` + `businessCardSlot`
+3. 引入 `report-collaboration/styles/report-collaboration.css`
+
+---
+
+## 8. 单测
+
+Mock 驱动（原 `api/mock.ts`）与 `deerflow.rc-mock` / `VITE_RC_MOCK` 开关已移除，前端只请求真实后端；本地演示请直接联调后端。
+
+单测：
+
+```bash
+cd frontend-web
+pnpm test:report-collaboration
+```
+
+---
+
+## 9. 联调验收清单
+
+### 9.1 准备
+
+- [ ] `report_collaboration.enabled: true`
+- [ ] `report_collaboration.worker_enabled: true`
+- [ ] 五个 `*_model` 已配置且可用
+- [ ] Gateway 已重启（MySQL 表/列就绪）
+- [ ] 前端已登录（JWT 有效）
+
+### 9.2 探活
+
+```bash
+curl -s -H "Authorization: Bearer <token>" \
+  http://127.0.0.1:8001/api/report-collaboration/sessions
+```
+
+期望：**200** + `{ "sessions": [...] }`，而非 503。
+
+### 9.3 页面流程（浏览器 Network）
+
+1. 打开 `/#/page/workspace/report-collaboration`
+2. 输入需求 → `POST .../sessions` **200**
+3. 跳转 → `GET .../sessions/{id}` **200**，响应含 `SessionSnapshot`
+4. 首条消息 → `POST .../messages` **200**
+5. 请求方案 → `POST .../plan-requests` **200**
+6. 采用方案 → `POST .../plans/{id}/select` **200**
+7. 开始协作 → `POST .../runs` **200**
+8. `GET .../runs/{id}/stream` 持续收到 SSE（`message.delta`、`node.status.changed` 等）
+9. 刷新页面 → 消息与 `last_seq` 续接正确
+10. 运行中输入「重新检索」→ `POST .../commands` → 确认卡 → `confirm` **200**
+
+### 9.4 常见失败
+
+| 现象 | 原因 | 处理 |
+|------|------|------|
+| 全部 503 | `enabled: false` | 改配置并重启 |
+| run 一直 queued | `worker_enabled: false` | 改为 true |
+| 409 选方案 | revision 过期 | 刷新后重选（前端已自动 refresh） |
+| 429 | 预算/并发上限 | 调大配置或取消其他 run |
+| 500 + SQL | 表缺列 | 重启 Gateway，查列同步日志 |
+
+---
+
+## 10. 契约与类型维护
+
+- **单一事实源：** `frontend-web/src/report-collaboration/api/types.ts`
+- **后端镜像：** `offline-backend-20260512/backend/app/report_collaboration/contracts/`
+- 修改字段须同步两份实施计划与本指南，并跑前后端相关测试。
+
+`SessionSnapshot` 形状（摘要）：
+
+```typescript
+interface SessionSnapshot {
+  session: ReportSession;
+  messages: CollaborationMessage[];
+  plans: ReportPlanCandidate[];
+  run: ReportRun | null;
+  nodes: CollaborationNodeState[];
+  agent_runs: AgentRun[];
+  commands: CollaborationCommand[];
+  report_versions: ReportVersion[];
+  last_seq: number;
+}
+```
+
+`ReportRun` 可选字段（RC-BE-016）：`usage`、`budget_exhausted_reason`。
+
+---
+
+## 11. 后续工作（非对接阻塞）
+
+| 项 | 说明 |
+|----|------|
+| RC-BE-019 | 灰度发布与离线部署文档 |
+| 侧边栏入口 | 已放开（`workspace-nav-chat-list.tsx` 的「报告协作」项） |
+| iframe 嵌入 | RC 页尚未专门适配 `embed=1`，可参考现有深链模式扩展 |
+| 真人盲评 | RC-BE-018 为确定性评测集，上线前仍需计划 §11.4 人工评审 |
+
+---
+
+## 12. 相关代码索引
+
+| 用途 | 路径 |
+|------|------|
+| API 客户端 | `frontend-web/src/report-collaboration/api/` |
+| 会话 Hook | `frontend-web/src/report-collaboration/hooks/useReportCollaborationSession.ts` |
+| 页面 | `frontend-web/src/report-collaboration/pages/ReportCollaborationPage.tsx` |
+| 路由 | `frontend-web/src/pages/WorkspaceRoutes.tsx` |
+| 后端路由 | `offline-backend-20260512/backend/app/gateway/routers/report_collaboration.py` |
+| 配置 | `offline-backend-20260512/backend/config.yaml` → `report_collaboration` |
+| 持久化 | `offline-backend-20260512/backend/packages/harness/deerflow/persistence/report_collaboration/` |

docs/agentscope-多智能体报告协作工作台-后端实施计划.md

@@ -1,11 +1,44 @@
 # AgentScope 2.0 多智能体报告协作工作台——后端实施计划
 
-> 文档状态：待评审、尚未开始编码
+> 文档状态：实施中（`RC-BE-000`～`018` 已完成；下一票 `RC-BE-019`）
-> 编写日期：2026-09-02
+> 编写日期：2026-09-05；进度更新日期：2026-09-06
 > 目标项目：`F:\react01\deeflow-code\deerflow-server\offline-backend-20260512\backend`
 > 协作框架：[AgentScope 2.0](https://github.com/agentscope-ai/agentscope)
-> 配套前端计划：`docs/agentscope-多智能体报告协作工作台-前端实施计划.md`
+> 前端契约来源：`frontend-web/src/report-collaboration/api/types.ts`、`api/mock.ts`、`state/event-reducer.ts`（前端已完成，契约冻结）
+> 尖峰基线：`offline-backend-20260512/backend/docs/AGENTSCOPE_BASELINE.md`
 > 本文只规划新增的报告协作后端，不修改现有多智能体会商，不使用旧 Workflow Studio DAG 调度器。
+> 下文 §8 的 `BE-n` 与 §10 的 `RC-BE-00n` 是同一批工单的两种编号；进度以 `RC-BE-*` 为准。
+
+## 0. 当前进度
+
+已打通 **建会话 → 澄清需求 → 生成 2～3 套候选方案 → 选定 → 创建 `queued` run（冻结模型 + 模板 + 预算）**，以及 **TaskLedger 波次调度 + 受控成员 / 真实 AgentScope 内核 + 主张级 QualityGate + 正式报告版本/改写 + 产品 durable SSE + 租约 dispatcher/恢复 + 运行期自然语言干预 + owner/预算/审计**。主开关默认关闭：`config.yaml → report_collaboration.enabled` / `worker_enabled` 均为 `false`。
+
+运行期 IntentRouter 的歧义兜底已可调用冻结的 coordinator 模型，但明确命令走高精度规则；该智能体无工具且不能调度。`POST /runs` 仍只入队。`worker_enabled` 为 false 时 lifespan **不**挂载后台循环；测试用 `dispatch_once()` / `WaveExecutor` 驱动。`GET /runs/{id}/stream` 可重放/尾随已持久化事件。生产 worker 在双开时注入 `AgentScopeMemberKernel`。20 项质量评测已在 `RC-BE-018` 落地（确定性打分，不跑真实模型）。
+
+| 工单 | 状态 | 代码落点 / 缺口 |
+|---|---|---|
+| `RC-BE-000` | 条件完成 | `agentscope_runtime/event_adapter.py`。`agentscope==2.0.5` 仅为 optional extra，**未写入 `uv.lock`**（等纵向 POC）。 |
+| `RC-BE-001` | 完成 | `app/report_collaboration/contracts/` + `execution/completion.py`。 |
+| `RC-BE-002` | 完成 | `deerflow.config.report_collaboration_config`；默认双关。 |
+| `RC-BE-003` | 完成 | `deerflow.persistence.report_collaboration/`，迁移 `20260905_01`。 |
+| `RC-BE-004` | 完成 | `/api/report-collaboration`。改写 / apply / restore 见 `015`。SSE 见 `011`。 |
+| `RC-BE-005` | 完成 | `requirement/`：规划前澄清；「直接开始」记默认假设；澄清完成 ≠ 出方案。 |
+| `RC-BE-006` | 完成 | `planning/`：目录投影（无 SOUL/密钥）+ 三策略方案；select 与 start-run 独立。 |
+| `RC-BE-007` | 完成 | `DeerFlowChatModelAdapter` + `freeze_plan_models`；缺模型/能力不匹配在 `POST /runs` 前 422。 |
+| `RC-BE-008` | 完成 | `permission_adapter.py` + `tool_adapter.py`：角色 × 工具矩阵、注入扫描。 |
+| `RC-BE-009` | 完成 | `execution/ledger.py` + `member_runner.py`：TaskLedger 按依赖波次分派；AgentScope/协调者建议不能选下一节点；空输出/非法 JSON 进入新 attempt；超限失败不完成整个 run。内核目前为 `ScriptedMemberKernel`（单测），真实模型/web_search 仍待接。 |
+| `RC-BE-010` | 完成 | `execution/quality_gate.py` + `ArtifactBoard.supersede_previous`：冲突数字/缺口径拒绝；未核验或争议主张不能进分析/章节；审稿必须映射到节点或章节；覆盖矩阵缺口拒绝。Ledger 先 schema 再质检，通过才 `validated`。 |
+| `RC-BE-011` | 完成 | `execution/live_hub.py`：run-scoped Live Hub、`PublishingReportCollaborationStore`（先入库再发布）、`after_seq`/`Last-Event-ID` 重放、心跳、token delta 合帧、SSE 断开不取消 run。`GET /runs/{id}/stream` 已挂载。报告正式版本见 `015`。 |
+| `RC-BE-012` | 完成 | store `list_claimable` / `renew_lease` / `finalize_cancel`；`execution/{dispatcher,executor,recovery}.py`：原子 claim、心跳续租、两阶段取消、过期租约接管。恢复保留已完成节点，遗留 in-flight 标 `interrupted`/`superseded` 并开新 `planned` attempt。晚到成果 `validation_status=superseded`，不改终态。`start()` 仅在 `worker_enabled` 时挂循环；默认双关。 |
+| `RC-BE-013` | 完成 | `execution/quality_roles.py`：Verifier/Analyst/Writer/Reviewer/Reviser 作为受控成员（确定性内核，非 AgentScope Team）。核验标记过期/跨包冲突；缺失角度只重开检索链；审稿 `revise` 只重开目标写作节点 + 审稿自身。`TaskResult.additional_drafts` 允许多条 VerificationResult。脚本内核仍供单测；生产 worker 见 `017`。 |
+| `RC-BE-014` | 完成 | `interventions/`：运行期 IntentRouterAgent（规则优先、模型兜底且无工具）+ 确定性 ImpactAnalyzer + command CAS/safe-point。支持节点/agent 归属校验、角度定向、确认闸门、等待边界、overlay、新 attempt、成果失效及晚到结果隔离。 |
+| `RC-BE-015` | 完成 | `reporting/`：run 开始冻结模板；`ReportFinalizer` 在审稿通过且 lint 后落正式版本并发 `report.version.created`；改写候选 / apply / restore 已挂路由，不再 503。 |
+| `RC-BE-016` | 完成 | owner 隔离、跨会话幂等拒绝、`sanitize_for_user` + 审计落库、每用户 active run 上限、每 run 预算 fail-closed。 |
+| `RC-BE-017` | 完成 | `AgentScopeMemberKernel` 真实 `reply_stream` + 工具 + 结构化成果；生产 worker 注入该内核；冒烟可跳过未安装的 `agentscope`。并发交错/租约恢复仍由 `012` 测试覆盖。 |
+| `RC-BE-018` | 完成 | `app/report_collaboration/eval/`：20 项标注任务（政策/市场/企业/事件/对比各 4）、确定性指标、金标/失败实例、会商盲评对照、20 次固定任务可靠性计数。`cite_required` 与当前默认 knobs 为通过评测的推荐画像。真实模型盲评仍属上线决策，不阻塞本票。 |
+| `RC-BE-019` | 未开始 | 灰度与离线发版。 |
+
+当前可联调路径：打开 `report_collaboration.enabled` 后，规划前轮询 `GET /sessions/{id}` 即可看到澄清消息和方案卡；`POST /runs` 只入队；`GET /runs/{id}/stream` 重放已入库事件。默认 **不**自动领取 queued run（`worker_enabled=false`）。测试可调 `dispatch_once()`。
 
 ## 1. 后端目标
 
@@ -14,7 +47,7 @@
 1. 理解任意报告需求并在必要时澄清。
 2. 从当前用户可见的智能体、技能、模型和资料源中筛选能力。
 3. 生成 2～3 个真实有差异的候选协作计划。
-4. 将选定计划实例化为 AgentScope leader-worker 团队。
+4. 将选定计划实例化为受 `TaskLedger` 约束的 AgentScope 任务成员，而非让自由会商自行决定流程。
 5. 通过结构化成果物完成检索、核验、分析、综合、写作、审稿和返工。
 6. 接受全过程自然语言干预，并只重开受影响的任务和下游成果。
 7. 使用数据库租约、durable events、幂等命令和版本化报告保证恢复与一致性。
@@ -23,11 +56,27 @@
 
 框架能提供协作机制，不能单独保证报告质量。质量由证据合同、来源核验、独立审稿、定向返工、模板约束和真实评测集共同保证。
 
+### 1.1 前端冻结契约：后端必须适配，不要求前端回退
+
+已完成的双栏前端以 `SessionSnapshot` 和 run-scoped durable SSE 为唯一事实来源；后端实现不得另造一套摘要卡或节点结果接口来补足过程。
+
+| 前端已实现行为 | 后端适配要求 |
+|---|---|
+| run 创建前轮询 `GET /sessions/{id}` | 澄清、需求修订、候选方案与选择结果必须同步写入完整快照；不能只存在于内存任务。 |
+| run 后以 `seq` 重放/订阅 SSE | 每个 run 的事件先持久化、再发布，`seq` 严格单调且可用 `after_seq` 补拉。 |
+| 并行成员横向阶段卡 | 同一并行波次使用相同 `phase_id`；`node_run_id` 固定为 `${node_id}-attempt{attempt}`，不可使用前端无法反查节点的随机值。 |
+| 复用 `MessageList` 展示过程 | assistant、TeamSay、工具调用、工具结果与流式增量均写入 `report_collaboration_messages` 并按原消息协议推送。 |
+| 成员状态来自局部快照合并 | 前端没有 `agent_run.*` 事件；成员开始、等待输入、完成、失败、取消时必须发 `session.snapshot: {agent_runs:[...], run?:...}`。 |
+| 报告在对话流中渐显 | 写作阶段发 `report.delta`；质量门和版本落库完成后才发 `report.version.created`。 |
+| 节点抽屉只读 | `GET /runs/{id}/nodes/{node_id}/contract` 只返回职责合同，永不返回执行结果正文。 |
+
+每个写操作读取前端发送的 `X-Idempotency-Key` 与 `X-Expected-Revision`；用户消息的服务端镜像必须将同一幂等键放入 `metadata.idempotency_key`，以替换前端乐观消息而不重复显示。
+
 ---
 
 ## 2. 关键架构决策
 
-### 2.1 使用 AgentScope Core，不采用演示服务作为事实源
+### 2.1 AgentScope 用作任务执行内核，不把 Agent Team 自主会商当作调度器
 
 AgentScope 官方提供 Event System、Agent Team、任务规划和 Agent Service 示例，但团队可靠性与多进程/分布式服务仍在持续完善：
 
@@ -36,13 +85,16 @@ AgentScope 官方提供 Event System、Agent Team、任务规划和 Agent Servic
 - [Agent Team 可靠性跟踪](https://github.com/agentscope-ai/agentscope/issues/1802)
 - [多进程与分布式能力跟踪](https://github.com/agentscope-ai/agentscope/issues/1722)
 
-因此采用：
+因此采用下列职责分界：
 
-- AgentScope Core：Agent、Team、Tool、Event、Permission。
+- AgentScope Core：单个受控任务成员的模型调用、流式事件、工具调用、权限封装与结构化输出修复。
+- DeerFlow `TaskLedger`：计划实例化、依赖拓扑、并发波次、输入成果选择、状态迁移、重试、租约、取消、命令安全点与业务终态。
+- DeerFlow `ArtifactBoard` / `QualityGate`：成果物事实源、验收、失效传播、引用约束和报告版本准入。
+- `Coordinator`：受限的规划/协调智能体，只能提出 `PlanProposal`、`TaskAssignment`、`RepairRequest` 和 `ClarificationRequest`；它不能自行创建任意图、改变数据库或宣告节点完成。
+- AgentScope TeamSay：允许作为可见的协作交接文本，但不是任务分派、完成判定或数据依赖的事实来源。
 - DeerFlow：身份、权限、配置、数据库、消息、命令、作业、租约、SSE、成果、文件、报告版本和审计。
-- AgentScope Event 既驱动运行状态，也通过无损 adapter 转为 DeerFlow 领域事件和 LangChain 兼容消息；其用户可见内容不能在 adapter 中被压缩为进度摘要。
+- AgentScope Event 通过无损 adapter 转为 DeerFlow 领域事件和 LangChain 兼容消息；用户可见内容不能在 adapter 中压缩为进度摘要。
-- 不运行 AgentScope `examples/web_ui`。
+- 不运行 AgentScope `examples/web_ui`，不使用 AgentScope Session、MessageBus 或内存对象作为恢复/重放依据，也不使用其 session SSE 作为产品 SSE。
-- 不把 AgentScope Session、MessageBus 或内存对象作为恢复依据。
 - 节点公开接口只返回职责合同、图关系和状态，不返回节点实际输出；实际阶段消息、工具过程和成果仍从会话消息流以原生消息、工具步骤、引用和报告文件卡的形式呈现。
 
 ### 2.2 新功能独立，不进入旧运行内核
@@ -63,7 +115,7 @@ AgentScope 官方提供 Event System、Agent Team、任务规划和 Agent Servic
 - 展示当前状态和返工范围。
 - 供用户理解和选择方案。
 
-真正调度由 `Coordinator + TaskLedger + ArtifactBoard + QualityGate` 完成。协调者只能从服务端允许的动作中选择，不能返回任意 Python、任意图或数据库操作。
+真正调度由 `TaskLedger + ArtifactBoard + QualityGate` 完成。协调者只能提出服务端可验证的建议；`TaskLedger` 才能执行分派、依赖解锁、重试和终态迁移，不能返回任意 Python、任意图或数据库操作。
 
 ### 2.4 数据库是唯一事实源
 
@@ -89,12 +141,12 @@ flowchart LR
     API --> DISP[Lease Dispatcher]
 
     DISP --> EXEC[Report Collaboration Executor]
-    EXEC --> AS[AgentScope Core]
-    AS --> LEAD[Coordinator]
-    AS --> TEAM[Research/Verify/Analyze/Write/Review Team]
-
     EXEC --> LEDGER[Task Ledger]
     EXEC --> BOARD[Typed Artifact Board]
+    LEDGER --> COORD[Constrained Coordinator]
+    LEDGER --> AS[AgentScope Core Task Workers]
+    COORD --> LEDGER
+    AS --> TEAM[Research / Verify / Analyze / Write / Review]
     EXEC --> MODEL[DeerFlow Model Adapter]
     EXEC --> TOOL[Allowlisted Tool Adapter]
 
@@ -290,6 +342,59 @@ completed -> reopened -> queued
 - 期望成果物落库、Schema 通过、验收器通过后才能完成。
 - 返工创建新 attempt，保留旧 attempt 和旧成果。
 
+### 5.6 `TaskLedger`：智能体协作的确定性边界
+
+每个计划节点被实例化为一条可审计的 ledger task；并行只是多个 ready task 位于同一波次，不是让多个智能体在群聊中自行决定谁做什么。
+
+```text
+TaskAssignment
+  node_id / node_run_id / phase_id / attempt
+  requirement_revision
+  allowed_input_artifact_ids[]
+  expected_artifact_type + acceptance_criteria
+  agent_profile_snapshot + allowed_tools + budgets
+  command_overlay_revision
+
+TaskResult
+  artifact_draft | clarification_request | repair_request | failure
+  cited_artifact_ids[]
+  source_ids[]
+```
+
+调度规则：
+
+1. `PlanAssembler` 将角色建议转为固定节点、边、成果合同和质量门；只允许无环主图。
+2. `TaskLedger` 仅在依赖的成果物均为 `validated`、未 supersede 且预算可用时使节点 ready。
+3. 每个成员只读 requirement revision、自己的 `TaskAssignment` 与允许的已验证上游成果；不能把其他成员的原始上下文、工具返回或内部 prompt 当作输入。
+4. 并行节点共享 `phase_id`，但各自有独立 `agent_run_id`；串行节点用独立 `phase_id`。成员的 `node_run_id` 一律为 `${node_id}-attempt{attempt}`。
+5. 只有 `TaskResult` 转为成果物并通过 `QualityGate` 后，ledger 才解锁下游；TeamSay 与普通文本没有解锁能力。
+6. 修复/返工创建新 attempt；旧 attempt 及其消息留存但被标为 `superseded`，不得重新进入下游。
+
+### 5.7 用户命令的约束化协议
+
+每句话先持久化为用户消息和 `CollaborationCommand`，再由独立的**意图理解智能体（`IntentRouterAgent`）**进行两段式判定：规则/上下文高精度路由优先，必要时调用模型并输出受 Pydantic 约束的 `IntentDecision`。它负责理解，不负责调度或执行。
+
+同一能力有两种受控入口：
+
+| 时机 | `IntentRouterAgent` 的工作 | 后续处理 |
+|---|---|---|
+| 尚未开始 run | 提取主题、目标、受众、范围、时间、角度、模板和来源约束；判断真正缺失的信息 | `RequirementResolver` 写 requirement revision；`PlanController` 生成候选计划。 |
+| run 正在执行或已有报告 | 结合当前选中的 node/agent、等待澄清、成果血缘和报告章节，识别用户是在回答、补角度、重检索、重分析、重跑、改章节、润色、查询还是改规划 | `ImpactAnalyzer` 计算实际影响；`TaskLedger` 在确认和安全点后执行。 |
+
+输入包含用户文本、session/run 状态、最新 requirement、当前 `target_node_id` / `agent_run_id`、awaiting clarification、当前报告版本和可见成果摘要；不得输入其他成员的内部 prompt、隐藏推理或无权访问的资料。
+
+```text
+IntentDecision
+  intent / confidence / normalized_instruction
+  scope: conversation | node | artifact_lineage | section | plan
+  requested_target_ids[] / requirement_patch?
+  requires_confirmation / cost_level / reason
+```
+
+服务端必须验证 `target_node_id`、`agent_run_id` 属于当前 session/run，再解析到 node 和成果物血缘；不可相信客户端传入的任意 ID。`ImpactAnalyzer` 产出实际 `impact_nodes`、失效成果和新 attempt 计划，用户所见的命令状态由它和 `TaskLedger` 写入，而非由协调者文本决定。
+
+`IntentRouterAgent` 的置信度不足、目标不唯一、涉及 requirement/plan revision、预计成本为 high 或影响多个并行分支时，必须返回 `requires_confirmation=true`；只有用户确认后 `TaskLedger` 才可执行。对于处于 `awaiting_input` 的节点，明确回答优先分类为 `answer_question`，只解锁该节点的依赖链。
+
 ---
 
 ## 6. 数据库设计
@@ -300,9 +405,9 @@ completed -> reopened -> queued
 | `report_collaboration_messages` | 对话原文镜像 | message_id、role、content、tool_calls_json、tool_call_id、agent_run_id、node_run_id、phase_id、visibility、metadata、command_id、created_at、completed_at |
 | `report_collaboration_plans` | 候选及修订 | proposal_group_id、revision、status、graph_json、validation_json |
 | `report_collaboration_runs` | 正式执行 | plan_id、status、lease_owner、lease_until、cancel_requested、next_event_seq |
-| `report_collaboration_node_runs` | 节点尝试 | node_id、attempt、status、contract_json、agent_snapshot、error、started_at、ended_at |
+| `report_collaboration_node_runs` | 节点尝试/ledger task | node_id、attempt、`node_run_id=${node_id}-attempt{attempt}`、status、contract_json、input_artifact_ids、command_overlay_revision、agent_snapshot、error、started_at、ended_at |
 | `report_collaboration_agent_runs` | 实际团队成员实例 | agent_run_id、node_run_id、phase_id、role、display_name、avatar_key、status、agent_snapshot、started_at、ended_at |
-| `report_collaboration_artifacts` | 成果物 | artifact_type、producer_node_run_id、schema_version、content_json、validation_status |
+| `report_collaboration_artifacts` | 成果物及血缘 | artifact_type、producer_node_run_id、requirement_revision、schema_version、content_json、validation_status、superseded_by |
 | `report_collaboration_events` | durable SSE | run_id、seq、event_type、payload、created_at |
 | `report_collaboration_commands` | 用户命令 | command_id、idempotency_key、intent、scope、status、expected_revision |
 | `report_collaboration_report_versions` | 报告版本 | version、parent_version_id、markdown、source_index、change_summary |
@@ -316,6 +421,7 @@ completed -> reopened -> queued
 - 事件 seq 在 run 行内原子分配。
 - 用户消息、协调者消息、成员 TeamSay、流式回复、工具调用和工具返回使用稳定 `message_id` 与 timeline/event seq；同一 `agentRunId` 内严格保持因果顺序，保证 `MessageList` 能以原生消息重建全过程。
 - 并行成员的消息分别归属 `agent_run_id`，同一事件流仍全量持久化；前端选择标签只能过滤/聚焦，不能影响事件写入或消息顺序。
+- 成员状态的 event 投影使用 `session.snapshot` 中的增量 `agent_runs[]` 合并；不可自定义未被前端处理的 `agent_run.*` 事件。
 - 删除 session 显式删除子资源，不依赖 SQLite cascade pragma。
 - 写事务在 commit 前完成必要序列化。
 - 不使用跨连接 post-commit refresh。
@@ -346,6 +452,7 @@ GET    /api/report-collaboration/runs/{run_id}/events?after_seq={seq}
 GET    /api/report-collaboration/runs/{run_id}/stream?after_seq={seq}
 POST   /api/report-collaboration/runs/{run_id}/commands
 POST   /api/report-collaboration/runs/{run_id}/commands/{command_id}/confirm
+POST   /api/report-collaboration/runs/{run_id}/commands/{command_id}/cancel
 POST   /api/report-collaboration/runs/{run_id}/cancel
 GET    /api/report-collaboration/runs/{run_id}/nodes/{node_id}/contract
 
@@ -357,10 +464,17 @@ POST   /api/report-collaboration/sessions/{session_id}/report-rewrites/{id}/appl
 POST   /api/report-collaboration/sessions/{session_id}/report-versions/{id}/restore
 ```
 
-写请求必须支持：
+`GET /sessions/{session_id}` 必须返回完整 `SessionSnapshot`：
 
-- `idempotencyKey`
+```text
-- `expectedRevision`
+session / messages / plans / run / nodes / agent_runs / commands /
+report_versions / last_seq
+```
+
+写请求必须读取并回显：
+
+- `X-Idempotency-Key`（服务端唯一去重键；用户消息镜像写入 `metadata.idempotency_key`）
+- `X-Expected-Revision`（陈旧修改返回 409，不静默覆盖）
 
 计划请求和 run 请求只创建 durable command/job，不在请求生命周期中等待完整模型输出。
 
@@ -437,10 +551,11 @@ heartbeat
 
 - 历史与实时使用相同 envelope。
 - 支持 `Last-Event-ID` 和 `after_seq`。
-- token delta 可 live-only 合帧，但需周期性保存可恢复 checkpoint。
+- 高频 token/tool 参数增量按 50～250ms 或大小阈值合帧为**已持久化** `message.delta` / `tool_call.delta` / `tool_result.delta`；不能每 token 写数据库，也不能仅 live-only 后丢失重放。
-- 不能每 token 写数据库。
+- 每一批增量与消息最新正文同事务写入，再向 Live Hub 发布；断线时能通过 `after_seq` 重放，快照也能读到最新 checkpoint。
 - 状态、成果、命令和报告版本必须 durable。
 - 读取事件暂时失败时保持连接并发送可恢复 warning。
+- `session.snapshot` 可以携带完整快照，也可以携带 `run`、`nodes`、`agent_runs` 的增量集合；成员状态变化必须用此事件投影。
 
 `message.*` / `team_message.*` 的 `data` 必须携带 LangChain 兼容的消息字段和归属，而非仅有摘要：
 
@@ -466,26 +581,33 @@ heartbeat
 
 工具调用先在同一条 `ai` 消息的 `tool_calls` 上创建/追加参数 delta；返回值随后以 `type: "tool"`、相同 `tool_call_id` 的独立消息传输。允许用户查看的正文、参数和返回必须保持原文以及原始增量边界；只有统一脱敏器标记的字段可替换，替换理由写入 metadata。每个成员在开始生成时先发送 `message.created`，因此即使首 token 尚未到达，前端也能立即显示该成员正在回复，而非静默等待。
 
+`reasoning_delta` 仅可承载经策略批准的、面向用户的工作说明（如“正在比对统计口径”），不允许桥接模型隐藏推理链、系统 prompt 或内部审稿思路；如模型未提供安全的公开工作说明，省略字段，过程可见性由 TeamSay、工具步骤、来源与普通 assistant 文本承担。
+
 ---
 
 ## 8. 分步实施计划
 
+工单状态见 §0。本节正文仍是验收标准，不因部分完成而删减。
+
 ### BE-0：AgentScope 兼容性尖峰
 
+**状态：条件完成（`RC-BE-000`）。** 事件适配与 dict/真实事件单测已有；真实双模型流式与 `uv.lock` 仍属后续 POC。20 项标注评测与 20 次固定任务统计已在 `RC-BE-018` 落地。
+
 先写实验和测试，不接前端，不建正式业务表。
 
 验证：
 
-1. 当前 Python 3.12 与稳定 AgentScope 2.x 兼容。
+1. 当前 Python 3.12 与候选 `agentscope==2.0.5` 兼容；POC 通过后才将精确版本写入 lock，不能使用浮动 `main`。
-2. 固定精确版本和 commit，不使用浮动 `main`。
+2. 验证单任务 worker 所需的 Agent、Tool、Event、Permission API；Agent Team 的自主调度与 Session SSE 不属于本功能的正确性依赖。
 3. `uv lock` 后检查 Pydantic、SQLAlchemy、FastAPI、OpenAI SDK 冲突。
 4. 使用当前至少两个模型完成流式回复。
-5. leader + 2 workers 完成任务分配、TeamSay、并发和结构化输出。
+5. `TaskLedger` 分派 2 个并行 worker，完成可见 TeamSay、并发和结构化输出。
 6. 主动取消、超时、工具异常和成员异常行为可控。
 7. AgentScope Event 可稳定关联 agent、task、message、tool call，并能一对一写出 LangChain 兼容的 assistant/tool 消息。
 8. 内存状态丢失后可由 DeerFlow task ledger/artifact 重建。
 9. 连续运行 20 次固定任务，统计早停、空输出、非法 JSON、事件缺失。
-10. 从首个 `REPLY_START`、TeamSay、tool-call start、tool result 到 token delta 的首个可见事件均在指定时限内到达 adapter；并行两个成员交错输出时不串 message ID 或 tool call ID。
+10. 从首个 `REPLY_START`、TeamSay、tool-call start、tool result 到 token delta 的首个可见事件均在指定时限内到达 adapter；并行两个成员交错输出时不串 message ID 或 tool call ID，并能按前端既定 `phase_id` / `node_run_id` 聚焦。
+11. 人为注入流式中断、未闭合 tool call、等待用户输入与恢复场景；adapter 必须补发终态 tool result，不能留下永久 loading 的工具步骤。
 
 交付：
 
@@ -502,6 +624,8 @@ Go 条件：
 
 ### BE-1：配置、依赖和总开关
 
+**状态：完成（`RC-BE-002`）。** `enabled` / `worker_enabled` 默认 `false`。
+
 新增 `config.yaml -> report_collaboration`：
 
 ```text
@@ -538,6 +662,8 @@ cost_budget
 
 ### BE-2：领域合同和状态机
 
+**状态：完成（`RC-BE-001`）。**
+
 完成 Pydantic 合同：
 
 - requirement。
@@ -560,6 +686,8 @@ cost_budget
 
 ### BE-3：迁移和持久化 Store
 
+**状态：完成（`RC-BE-003`）。** 表前缀 `report_collaboration_*`，迁移 `20260905_01`。
+
 任务：
 
 1. 创建数据库迁移。
@@ -579,15 +707,19 @@ cost_budget
 
 ### BE-4：会话、消息和计划 API 骨架
 
+**状态：骨架完成（`RC-BE-004`）+ SSE 已挂载（`RC-BE-011`）+ 改写/恢复已挂载（`RC-BE-015`）。** REST 会话/消息/方案/run 已挂载；`GET /runs/{id}/stream` 为 durable SSE。
+
 任务：
 
 - session CRUD 和用户隔离。
+- `GET /sessions/{id}` 一次返回前端 `SessionSnapshot` 的全部字段；run 前的澄清/规划阶段由该快照在 2.5 秒轮询内可见。
 - message 持久化：完整保存用户可见的 assistant、TeamSay、`tool_calls` 与 `tool` 返回，并保留 `agent_run_id`/`node_run_id`/`phase_id`；不只保存阶段摘要。
 - plan request 入队。
 - plan list/select。
 - run create/query。
 - OpenAPI 响应模型。
 - 路由注册顺序和统一错误模型。
+- 按 `frontend-web/src/report-collaboration/api/types.ts` 建立契约测试：字段名保持 snake_case，枚举、事件类型、命令确认/取消端点和 revision 头不可漂移。
 
 安全：
 
@@ -597,14 +729,17 @@ cost_budget
 
 ### BE-5：需求解析和澄清
 
-`RequirementResolver`：
+**状态：完成（`RC-BE-005`）。** 规则路径；尚未接规划用 LLM。澄清完成不会自动 `plan-requests`。
+
+`IntentRouterAgent`（规划前模式）与 `RequirementResolver`：
 
 1. 读取会话消息和最新 requirement snapshot。
-2. 提取主题、目标、受众、范围、角度、模板和来源限制。
+2. `IntentRouterAgent` 输出结构化需求提取、澄清判定或“可直接规划”判定；不得自行建图或启动任务。
-3. 判断是否缺少影响方案选择的必要信息。
+3. `RequirementResolver` 校验并写入主题、目标、受众、范围、角度、模板和来源限制。
-4. 必要时产生一个或多个独立 clarification。
+4. 判断是否缺少真正影响方案选择的必要信息。
-5. 用户回答后创建新 requirement revision。
+5. 必要时产生一个或多个独立 clarification。
-6. 达到澄清上限后使用明确假设继续，不能无限追问。
+6. 用户回答后创建新 requirement revision。
+7. 达到澄清上限后使用明确假设继续，不能无限追问。
 
 验收：
 
@@ -614,6 +749,8 @@ cost_budget
 
 ### BE-6：智能体目录、筛选和候选计划
 
+**状态：完成（`RC-BE-006`）。** 选择器为规则重排，未接规划模型。`POST /plan-requests` 在 `worker_enabled=false` 时于请求内同步生成方案（非 LLM）。
+
 五阶段：
 
 1. `AgentCatalogProjection`：读取用户可见且启用的 agent、技能和工具元数据。
@@ -638,6 +775,8 @@ cost_budget
 
 ### BE-7：AgentScope 模型适配
 
+**状态：完成（`RC-BE-007`）。** 适配器鸭子类型对齐 `ChatModelBase.__call__`；运行前冻结快照。真实 Provider 冒烟仍属 `RC-BE-009` / `017`。
+
 目标：让 AgentScope 使用 DeerFlow 配置的模型，不再建立第二套 Provider 配置。
 
 任务：
@@ -657,13 +796,15 @@ cost_budget
 
 ### BE-8：工具与权限适配
 
+**状态：完成（`RC-BE-008`）。**
+
 第一版允许：
 
 - Web 检索和正文获取。
 - 用户有权限的知识库/Wiki 检索。
 - 明确批准的只读技能/MCP。
 - 成果物板读写工具。
-- AgentScope 团队通信与任务工具。
+- 用户可见交接（TeamSay）与受控成果物/澄清工具。
 
 第一版默认禁止：
 
@@ -678,7 +819,7 @@ cost_budget
 - Researcher 不能发布报告。
 - Writer 不能把未核验证据改成已核验。
 - Reviewer 只能输出 ReviewDecision，不能覆盖报告。
-- Coordinator 只能通过受控工具创建任务、分派、等待、返工和建议完成。
+- Coordinator 只能提出受控的计划、澄清与修复建议；实际创建任务、分派、等待、返工和完成由 `TaskLedger` 服务执行。
 - 所有成员获得本次 run 的最小权限快照。
 
 验收：
@@ -688,7 +829,9 @@ cost_budget
 - 网页 prompt injection 不能提升权限。
 - AgentScope 工具异常被转换为 node/tool event，不泄露内部堆栈给用户。
 
-### BE-9：AgentScope Team 运行器
+### BE-9：受控任务成员运行器（不采用自治 Team 调度）
+
+**状态：完成（`RC-BE-009` 脚本内核 + `RC-BE-013` 质量角色内核）。** `TaskLedger` + `WaveExecutor` + `QualityRoleKernel`。真实 AgentScope `reply_stream` / web_search 仍待接。
 
 基础角色：
 
@@ -706,18 +849,21 @@ cost_budget
 - 计划决定 Researcher/Analyst 数量和角度。
 - 服务器限制团队人数、并发、attempt、返工和预算。
 - 每个成员上下文只包含当前任务、需求快照和必要上游成果。
-- Coordinator 不直接操作数据库，只调用 TaskLedger/ArtifactBoard 工具。
+- `Coordinator` 只接收结构化成果摘要、质量失败与用户命令影响，输出候选计划/修复建议；它不拥有自由消息总线或数据库权限。
+- `TaskLedger` 依据已验证成果、预算与并发限额逐波创建 AgentScope worker；AgentScope 不选择下一节点，也不决定任务完成。
+- 每个 worker 只能调用 `submit_artifact`、`request_clarification`、`request_repair`、允许的资料工具和可见 TeamSay；所有改变运行状态的调用都由服务端重新校验。
 - 任务完成由 QualityGate 判定，不接受文本声明。
 
 事件映射：
 
 - AgentScope `REPLY_*` → 以原始文本 chunk 创建/更新协调者或成员的稳定 assistant 消息，保留 `agentRunId`；不得等待 reply 完成后再合成为进度摘要。
-- AgentScope TeamSay → 以成员身份创建/更新普通 assistant 消息，保留完整用户可见交接内容与因果顺序。
+- AgentScope TeamSay → 以成员身份创建/更新普通 assistant 消息，保留完整用户可见交接内容与因果顺序；它不会改变 ledger 状态。
 - `MODEL_CALL_*` → 内部遥测，默认不下发原始 prompt。
 - `TOOL_CALL_*` → 原生 `ai.tool_calls` 参数事件；对应工具返回 → 原生 `tool` 消息和相同 `tool_call_id`。两者在 SSE 和持久化中一一对应，供现有 `MessageGroup` 直接渲染。
-- team task/update → node/task ledger 状态。
+- `TaskLedger` 的分派/校验/重试/取消结果 → node/task ledger 状态；AgentScope 仅上报可验证的 TaskResult。
 - 成果工具 → artifact created/validated/rejected。
 - 每个用户可见阶段开始、进展、完成、等待、返工和失败都必须同步产生稳定的消息或状态事件，供左侧 DeerFlow `MessageList` 按原始消息顺序展示；不能要求前端读取节点结果后自行拼装过程，也不能用聚合卡替换 AgentScope 的实时可见消息。
+- agent run 的开始、等待输入、完成、失败和取消，紧邻节点状态事件发 `session.snapshot` 增量，至少包括相应的 `agent_runs[]` 和当前 `run.current_phase`。
 
 验收：
 
@@ -727,6 +873,8 @@ cost_budget
 
 ### BE-10：成果物板与质量门
 
+**状态：完成（`RC-BE-010`）。** `QualityGate` 为确定性规则（无二次模型调用）。模板冻结快照与正式 `ReportVersion` 落库已在 `RC-BE-015` 落地。
+
 `ArtifactBoard`：
 
 - 按 run/node/attempt/type 保存成果。
@@ -736,21 +884,26 @@ cost_budget
 
 `QualityGate`：
 
-- EvidenceBundle：来源数量、日期、URL/文档 ID、摘录和去重。
+- `CoverageMatrix`：把需求中的每个必选角度/关键问题映射到证据目标、分析节点和模板章节；计划和最终版本均不可漏项。
-- VerificationResult：支持与反对证据、冲突、时效。
+- `EvidenceBundle`：按**主张级**保存 `claim_id`、来源 URL/文档 ID、发布/获取时间、原文摘录、事实或推断标签、适用范围、数值单位/口径、可信度与去重结果。
-- AngleAnalysis：结论必须引用验证过的 evidence ID。
+- `VerificationResult`：对关键主张给出支持与反对证据、冲突、时效、来源独立性和可用结论；数字及重要事实必须经此门。
-- ReportSectionDraft：关键事实和数字必须有引用。
+- `AngleAnalysis`：结论只能引用验证过的 evidence ID，必须分别标示事实、推断、假设、局限和资料缺口。
-- ReviewDecision：问题必须有目标、严重度和修复要求。
+- `ReportSectionDraft`：关键事实和数字必须有 evidence ID；章节的主张与引用一一可追溯。
-- ReportVersion：模板覆盖、引用完整、章节一致、正式版本已持久化。
+- `CitationTemplateLinter`：校验模板章节、必答问题、来源格式、数字/日期/实体一致性、不可用或过期来源和未引用的关键事实。
+- `ReviewDecision`：独立于 Writer 上下文运行，问题必须有目标、严重度、证据和修复要求；不能笼统地要求“整体再优化”。
+- `ReportVersion`：覆盖矩阵、引用、模板、章节衔接、结论一致性和正式版本持久化全部通过才可创建。
 
 验收：
 
 - 无成果、空成果和不合 Schema 的成果不能完成节点。
 - 未验证来源不能直接进入最终事实陈述。
 - Reviewer 的返工目标可映射到具体节点和章节。
+- 同一事实出现冲突或同一数字缺少口径时，QualityGate 必须拒绝或要求定向补证，不能由 Writer 擅自选择一个答案。
 
 ### BE-11：后台 Dispatcher、租约和恢复
 
+**状态：完成（`RC-BE-012`）。** `worker_enabled` 默认仍为 false：Gateway lifespan 只有 `enabled` **且** `worker_enabled` 同时为真才 `dispatcher.start()`。测试走 `dispatch_once()` / `executor.execute()`，不要依赖后台循环。
+
 复用现有成熟模式：
 
 - active-dedupe key。
@@ -780,6 +933,8 @@ cost_budget
 
 ### BE-12：SSE 和 Live Hub
 
+**状态：完成（`RC-BE-011`）。** `ConversationReplica` 已实现协议镜像；产品 SSE 经 `execution/live_hub.py` 挂载。报告正式版本写入已在 `RC-BE-015` 落地。
+
 任务：
 
 - 实现 event repository。
@@ -790,6 +945,7 @@ cost_budget
 - 将高频 token delta 合帧。
 - 建立 `ConversationReplica`：将 AgentScope 用户可见消息、TeamSay、assistant delta、`tool_calls`、`tool` 返回、协助请求、报告文件和领域状态写成可重放的统一消息事件。它是协议镜像而不是摘要生成器。
 - 对话镜像完整保留用户有权查看的 TeamSay、原始工具参数和返回；不包含 chain-of-thought、系统/内部 prompt、密钥、权限不可见内容和异常堆栈。脱敏在入库/下发前一次执行，不能由前端自行推断。
+- 对前端已支持的 `reasoning_delta`，仅推送由本系统生成或模型明确允许公开的短工作说明；它不等同于原始思维链，也不得用作质量门、调度或审计的唯一依据。
 - `agentRunId` 是并行消息流的稳定归属。Live Hub 始终发布所有成员事件；前端标签切换只在本地选择消息，不启动第二条运行流，也不取消未聚焦成员的 delta。
 
 验收：
@@ -799,10 +955,15 @@ cost_budget
 - 终态前报告正式版本已写入并可读。
 - SSE 断开不取消后台 run。
 - 仅依靠会话快照和事件重放即可重建每个成员的完整原生消息、工具过程和左侧聚焦视图，不需要调用节点结果接口。
+- 在模型/工具中断、取消和接管时，所有已开始的 tool call 都有对应的 completed tool result（成功、失败或 interrupted），不会让复用的 `MessageList` 永久显示执行中。
 
 ### BE-13：全过程命令与影响分析
 
-`IntentRouter` 输入：
+**状态：完成（`RC-BE-014`）。** `app/report_collaboration/interventions/` 已实现运行期 IntentRouterAgent、ImpactAnalyzer 和 RuntimeCommandService；SQL/memory store 通过 `patch_command(..., expected_statuses=...)` 对命令执行权做 CAS。置信度阈值由 `report_collaboration.intent_confirmation_threshold` 配置（默认 `0.8`）。
+
+实现边界：本票负责识别、授权、影响计算、确认、定向失效、overlay 和安全重排队。`rewrite_section` / `polish_report` 已能严格保留研究链并只返工写作/审校链；replacement candidate、正式版本 apply/restore 已在 `RC-BE-015` 落地。`add_angle` 优先使用用户定向的研究分支，否则按冻结计划顺序确定性选择一个研究分支，只接入其必要下游；无研究支路立即 `rejected`。`rerun_node` 没有合法目标时不得扩成整图。需求补丁只在返工成功后写入。卡住的 `executing` 可在接管或租约超时后收回。`command.cancelled` 进入 SSE。运行中 `POST /sessions/{id}/messages` 返回 409。
+
+`IntentRouterAgent`（运行中干预模式）输入：
 
 - 用户文本。
 - session/run 状态。
@@ -810,7 +971,7 @@ cost_budget
 - 当前选中节点或章节上下文。
 - 后端动作白名单。
 
-输出：
+先由规则层处理明确的回答、取消和节点/章节显式指令；其余由 `IntentRouterAgent` 输出：
 
 ```text
 intent
@@ -823,6 +984,8 @@ cost_level
 reason
 ```
 
+模型输出必须通过 Pydantic 校验，并经服务端 target 授权与置信度/成本闸门后才创建可执行 command；`IntentRouterAgent` 不可调用分派、取消、成果写入或报告版本工具。
+
 命令类型：
 
 - `answer_question`
@@ -839,11 +1002,15 @@ reason
 
 `ImpactAnalyzer`：
 
-- 重新检索：失效指定 EvidenceBundle 和引用它的下游。
+- `answer_question`：只解析相应的 clarification；仅解锁依赖该答案的节点，其他并行节点继续。
-- 重新分析：保留 evidence，失效分析和对应章节。
+- `research_again`：为指定节点/角度追加或替换 EvidenceBundle，失效其验证、分析、综合和受影响章节，不误伤无关角度。
-- 章节重写：保留研究/分析，只生成 replacement candidate。
+- `reanalyze`：保留 validated evidence，只失效指定分析、综合、写作和审校分支。
-- 语气润色：创建新报告版本，不失效事实成果。
+- `add_angle`：在当前冻结计划中选择一个明确目标或确定性的研究支路承接新角度，再只失效其必要下游；无可用支路时拒绝执行。运行中不暗改前端已选择的 DAG，真正新增画布节点只发生在后续重新规划产生的新 plan revision 中。
-- 全局改向：新建 plan revision，确认后创建 run branch。
+- `rerun_node`：以新 attempt 重跑指定节点及必要下游，旧结果保留为 superseded。
+- `rewrite_section`：保留研究/分析，只生成 replacement candidate 和该章节审校；用户 apply 后才产生新版本。
+- `polish_report`：不重检索；在当前正式版本上创建新版本，并再次执行模板/引用 lint。
+- `update_requirements` / `replan`：均先展示整图影响与高成本确认；前者写入新的 requirement revision 后重开冻结计划，后者重开当前计划全部节点。生成新候选 plan/run branch 的交互留在后续规划版本能力，不能在旧 run 的 SSE 内偷偷切换 run。
+- `ask_report`：只读取当前已验证成果或报告版本，不改变任务图。
 
 Safe-point：
 
@@ -851,15 +1018,19 @@ Safe-point：
 - 不可立即取消的 attempt 继续到边界，command 状态为 `accepted_waiting_boundary`。
 - 晚到输出可保存但标记 superseded，不能进入下游。
 - 每条 command 有分类、影响范围、状态和结果。
+- command overlay 仅在模型调用之间、工具返回后或节点提交成果前生效；在不可中断工具期间不能伪称已经完成修改。
 
 验收：
 
 - 低置信度“改一下”必须追问。
 - 相同幂等键不重复创建返工任务。
 - 运行中命令不能造成 completed/cancelled 状态竞争。
+- 用户针对画布/成员卡的定向修改只影响解析出的节点和成果血缘，不能被协调者扩大为整场重跑。
 
 ### BE-14：报告模板、写作、审稿和版本
 
+**状态：完成（`RC-BE-015`）。** 改写 / apply / restore 已挂载；正式版本在质量门通过后落库。
+
 复用 `/api/report-structures`，run 开始时冻结模板快照：
 
 - 章节层级。
@@ -871,25 +1042,25 @@ Safe-point：
 
 写作规则：
 
-- Writer 只能使用 validated artifacts。
+- Writer 只能使用冻结模板、`CoverageMatrix` 和 validated artifacts，禁止携带 Web/知识库工具或原始检索上下文进入写作提示词。
-- 关键判断绑定 evidence ID。
+- 关键判断绑定 evidence ID；无法证实的内容明确标为分析、假设或局限。
-- 无法证实的内容明确标为分析、假设或局限。
+- 每章获得确定 evidence set、字数目标和必答问题，输出章节草稿及主张—引用映射。
-- 每章获得确定 evidence set。
+- 完整报告先执行 CitationTemplateLinter，再由独立 Reviewer 进行事实、逻辑、受众适配和结论审校。
-- 完整报告执行引用、模板、衔接和结论一致性检查。
+- Reviewer 输出结构化 ReviewDecision；Reviser 只修改指定问题，并由同一质量门复验。
-- Reviewer 输出结构化 ReviewDecision。
-- Reviser 只修改指定问题。
 - 达到返工上限后报告未解决问题，不无限循环。
 
 版本规则：
 
 - 流式 Markdown 是临时草稿，不覆盖当前正式版本。
-- 正式版本落库并确认后 run 才能 completed。
+- 正式版本须在所有质量门通过后落库，随后才发 `report.version.created` 并令 run completed。
 - 章节改写生成 replacement candidate。
 - 用户 apply 后创建新版本。
 - restore 也创建新头版本，不破坏历史。
 
 ### BE-15：安全、审计和预算
 
+**状态：完成（`RC-BE-016`）。** 快照与 SSE 走统一脱敏；资源 owner、跨会话幂等、预算上限与审计已落地。
+
 - 所有资源校验 owner 或明确授权。
 - agent snapshot 移除密钥和不可见 prompt。
 - 工具参数/结果完整镜像到用户消息流；只有密钥、令牌、隐私字段、越权内容和明确的异常堆栈由统一脱敏器替换并记录原因。不能以大小截断或摘要替代用户有权查看的返回；超大返回以可重放 chunk 传输和按需折叠展示，正文仍可完整读取。
@@ -897,10 +1068,12 @@ Safe-point：
 - 每用户 active run 上限。
 - 每 run 团队、并发、检索、来源正文、模型调用、token、费用和总时长上限。
 - 审计 agent 选择、工具调用、来源、用户命令、人工确认和报告版本。
-- 不持久化、不下发原始 chain-of-thought、系统/内部 prompt 或模型推理 token；这不影响用户可见 assistant 文本、TeamSay、工具调用与工具返回的完整镜像。
+- 不持久化、不下发原始 chain-of-thought、系统/内部 prompt 或模型隐藏推理 token；前端可显示的 `reasoning_delta` 必须是经过独立策略筛选的公开工作说明。这不影响用户可见 assistant 文本、TeamSay、工具调用与工具返回的完整镜像。
 
 ### BE-16：测试与质量评测
 
+**状态：完成（`RC-BE-018`）。** 合同 / 适配器 / 规划 / 需求 / SSE / lease / 20 项标注评测集已有。打分器不调用模型；金标必须过门，会商风失败实例必须可复现。
+
 单元测试：
 
 - Pydantic 合同。
@@ -912,6 +1085,8 @@ Safe-point：
 - AgentScope event adapter。
 - 同一 `message_id` 的 token delta、同一 `tool_call_id` 的参数/结果 delta 以及脱敏字段替换；断线重放后消息正文不得被摘要化或重复。
 - 两个 `agentRunId` 并行交错输出、其中一员等待用户协助时，消息归属、工具配对、状态和命令目标均正确。
+- `session.snapshot` 增量 `agent_runs[]` 能驱动前端阶段卡从 pending → running → waiting_input → terminal；`node_run_id` 与画布节点前缀匹配。
+- 流式中断后每个已创建 tool call 都有终态 tool result，`MessageList` 不留下旋转步骤。
 
 集成测试：
 
@@ -925,7 +1100,7 @@ Safe-point：
 真实 AgentScope 冒烟：
 
 - 至少两个已配置模型。
-- leader + 多 worker。
+- ledger 驱动的多 worker（不依赖 AgentScope Team 自动分派）。
 - 并发工具和 TeamSay。
 - 取消、超时、异常成员和结果修复。
 
@@ -934,19 +1109,24 @@ Safe-point：
 - 不少于 20 个真实任务。
 - 覆盖政策影响、市场趋势、企业研究、事件研判、对比分析。
 - 每个任务记录必选角度、关键事实、禁止编造项、模板和评审规则。
-- 与现有多智能体会商进行盲评。
+- 与现有多智能体会商进行盲评，并保留每项失败的可复现实例。
-- 指标：事实准确、来源质量、角度覆盖、逻辑一致、格式遵循、可修改性、耗时和成本。
+- 指标：事实准确、来源质量、关键主张引用覆盖、角度覆盖、逻辑一致、模板遵循、定向修改正确率、耗时和成本。
+- 上线前为每个任务标注关键主张/数字、可接受来源、必选角度和模板约束；不能只以主观“文章更像报告”判定成功。
 
 ---
 
 ## 9. 首个纵向 POC
 
+POC-1 的规则路径已通（三策略差异方案、select ≠ start）。**POC-2 脚本闭环已通**（研究员 → 撰写员，协调者建议不调度）。**POC-3 质量角色已通**（核验 / 分析 / 审稿定向返工，确定性内核）。真实检索与 AgentScope 成员仍待接。**POC-4 未开始**。
+
 固定任务：
 
 > 撰写一份新能源汽车主要品牌市场趋势分析报告，覆盖 2024 年至今的市场份额、价格策略、技术路线、海外进展、政策环境和未来 12～24 个月风险与机会，面向企业战略决策人员，要求所有关键数字给出来源。
 
 ### POC-1：候选计划
 
+**状态：规则路径已通（`RC-BE-006`）。** 三策略差异方案、select ≠ start；尚未接规划 LLM。
+
 - 生成 3 种真实有差异的方案。
 - 每个方案只引用有效 agent/tool/template。
 - 每个节点有职责、输入、输出和验收条件。
@@ -954,6 +1134,8 @@ Safe-point：
 
 ### POC-2：三角色闭环
 
+**状态：脚本路径已通（`RC-BE-009`），SSE 重放已挂载（`RC-BE-011`）。** 真实 Web 检索仍待工具实装接入运行器。
+
 角色：Coordinator、Researcher、Writer。
 
 - 完成真实 Web 检索。
@@ -964,6 +1146,8 @@ Safe-point：
 
 ### POC-3：质量角色
 
+**状态：完成（`RC-BE-010` 质检 + `RC-BE-013` 受控成员 + `RC-BE-017` 真实内核）。** `QualityRoleKernel` 跑通 Verifier / Analyst / Writer / Reviewer / Reviser；过期与跨包冲突写入 `VerificationResult`；缺失角度只重开检索链；审稿失败只重开目标写作节点。生产 worker 使用 `AgentScopeMemberKernel`。
+
 加入 Verifier、Analyst、Reviewer、Reviser。
 
 - 过期资料被识别。
@@ -973,6 +1157,8 @@ Safe-point：
 
 ### POC-4：全过程干预
 
+**状态：命令与 safe-point 路径完成（`RC-BE-014`）。** 增加角度、指定角度重检索、章节重写/润色的定向影响已覆盖；运行中旧 attempt 在边界后 supersede，晚到成果不能进入下游。正式报告 replacement/version 展示已在 `RC-BE-015` 落地。
+
 必须演示：
 
 1. “增加供应链与原材料风险角度”。
@@ -986,28 +1172,36 @@ Safe-point：
 
 ## 10. 后端开发顺序
 
-1. `RC-BE-000`：AgentScope 版本与兼容性尖峰。
+已完成：
+
+1. `RC-BE-000`：AgentScope 版本与兼容性尖峰（条件 Go；未写入 `uv.lock`）。
 2. `RC-BE-001`：领域合同和状态机。
 3. `RC-BE-002`：配置、依赖和 feature flag。
 4. `RC-BE-003`：数据库迁移和 stores。
-5. `RC-BE-004`：session/message/plan API。
+5. `RC-BE-004`：session/message/plan API（改写 / 恢复见 `015`）。
 6. `RC-BE-005`：需求解析与澄清。
 7. `RC-BE-006`：agent catalog、selector、plan assembler/validator。
 8. `RC-BE-007`：AgentScope model adapter。
 9. `RC-BE-008`：tool/permission adapter。
-10. `RC-BE-009`：三角色 team POC。
+10. `RC-BE-009`：三角色 team POC（脚本内核 + TaskLedger 波次）。
-11. `RC-BE-010`：task ledger、artifact board、quality gate。
+11. `RC-BE-010`：artifact board 主张级质量门（Coverage / 核验 / 审稿）。
 12. `RC-BE-011`：durable event、原生消息镜像、SSE 和 live hub。
 13. `RC-BE-012`：dispatcher、executor、lease、cancel、recovery。
 14. `RC-BE-013`：Verifier/Analyst/Reviewer/Reviser。
-15. `RC-BE-014`：intent router、impact analyzer、safe-point commands。
+
-16. `RC-BE-015`：report structures、report versions、rewrite candidates。
+15. `RC-BE-014`：intent router、impact analyzer、safe-point commands（已完成）。
-17. `RC-BE-016`：安全、审计、预算、监控。
+16. `RC-BE-015`：report structures、report versions、rewrite candidates（已完成）。
-18. `RC-BE-017`：并发、故障恢复和真实 AgentScope 测试。
+17. `RC-BE-016`：安全、审计、预算、监控（已完成）。
-19. `RC-BE-018`：20 项质量评测和参数调优。
+18. `RC-BE-017`：并发、故障恢复和真实 AgentScope 测试（已完成）。
+19. `RC-BE-018`：20 项质量评测和参数调优（已完成）。
+
+下一票起：
+
 20. `RC-BE-019`：灰度与离线发布接入。
 
-前后端共同依赖：在 `RC-BE-001` 后冻结 OpenAPI、event envelope 和共享枚举，前端再开始真实 API 层开发。
+编号说明：§8 的 `BE-n` 与上表 `RC-BE-00n` 在 **008 之后不完全一一对应**（例如 §8 `BE-11` dispatcher ≈ `RC-BE-012`，`BE-12` SSE ≈ `RC-BE-011`）。排期与代码以 `RC-BE-*` 为准。
+
+前后端共同依赖：OpenAPI / event envelope / 共享枚举已按 `frontend-web/src/report-collaboration/api/types.ts` 冻结；前端页面与 mock 已完成。真实 SSE 可联调 `GET /runs/{id}/stream`（`RC-BE-011`）；领取/恢复见 `RC-BE-012`；质量角色见 `RC-BE-013`；运行中自然语言命令见 `RC-BE-014`。正式报告改写候选与版本 apply/restore 已在 `RC-BE-015` 挂载。生产默认仍不挂后台循环（`worker_enabled=false`）。
 
 ---
 
@@ -1082,7 +1276,7 @@ TeamSay 不作为事实来源；报告事实只能引用 validated EvidenceBundl
 
 后端只有同时满足以下条件才算完成：
 
-1. 使用 AgentScope 2.0 Core 组织真实 leader-worker 团队。
+1. 使用 AgentScope 2.0 Core 执行真实的受控任务成员，且由 DeerFlow `TaskLedger` 而非自治 Team 调度协作。
 2. 不调用旧 Workflow Studio DAG scheduler。
 3. 不改变现有多智能体会商行为。
 4. DeerFlow 数据库是状态唯一事实源。

frontend-web/.env.development

@@ -17,6 +17,9 @@ VITE_MOCK_COP_TASK_DETAIL=true
 VITE_BACKEND_BASE_URL=http://127.0.0.1:8001
 VITE_LANGGRAPH_BASE_URL=http://127.0.0.1:8001/api
 
+# 开发环境普通登录后进入 Vite 内隔离的官方风格页面；/page/* 仍访问当前定制版。
+VITE_USE_OFFICIAL_DEERFLOW_ENTRY=true
+
 # 轻应用「新建笔记」系列接口
 VITE_NOTE_API_BASE_URL=http://47.88.25.99:8000
 # CMZS后端接口

frontend-web/.env.example

@@ -60,3 +60,9 @@
 # 不填或留空时按类型 A，继续使用原来的简介菜单数据。
 # VITE_COMPACT_MENU_TYPE=A
 # VITE_GITHUB_OAUTH_TOKEN=
+
+# --- 官方 DeerFlow 风格页面入口（仅 Vite，不引入 Next.js）---
+# true 时，普通登录后进入同一 Vite 应用中隔离的 /official/*。
+# 已指定 redirect 或 taskId/goPath 的登录仍保持原来的优先级。
+# 仅 .env.development 默认 true；其余环境保持 false。
+# VITE_USE_OFFICIAL_DEERFLOW_ENTRY=false

frontend-web/.env.network

@@ -17,6 +17,9 @@ VITE_MOCK_COP_TASK_DETAIL=false
 VITE_BACKEND_BASE_URL=http://10.19.200.5:2026
 VITE_LANGGRAPH_BASE_URL=http://10.19.200.5:2026/api
 
+# 内网环境保持当前定制版默认入口。
+VITE_USE_OFFICIAL_DEERFLOW_ENTRY=false
+
 # 轻应用「新建笔记」系列接口
 VITE_NOTE_API_BASE_URL=http://47.88.25.99:8000
 # CMZS后端接口

frontend-web/.env.production

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

frontend-web/.env.sit

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

frontend-web/package.json

@@ -11,6 +11,7 @@
     "build:network": "node --max-old-space-size=8192 ./node_modules/vite/bin/vite.js build --mode network",
     "preview": "vite preview",
     "typecheck": "tsc --noEmit",
+    "test:report-collaboration": "npx esbuild src/report-collaboration/tests/event-reducer.test.ts --bundle --platform=node --format=esm --outfile=.runtime/unit-tests/event-reducer.test.mjs && npx esbuild src/report-collaboration/tests/message-adapter.test.ts --bundle --platform=node --format=esm --outfile=.runtime/unit-tests/message-adapter.test.mjs && node --test .runtime/unit-tests/event-reducer.test.mjs .runtime/unit-tests/message-adapter.test.mjs",
     "check:chrome109-css": "node scripts/check-chrome109-css.mjs",
     "check:legacy-chrome-css": "node scripts/check-chrome109-css.mjs"
   },

frontend-web/src/App.tsx

@@ -45,6 +45,7 @@ import {
 } from "@/position-roundtable/demo/position-roundtable-demo-config";
 import { ChatRuntime } from "./pages/WorkspaceRoutes";
 import { NotFoundPage } from "./pages/NotFoundPage";
+import OfficialDeerFlowEntry from "./pages/OfficialDeerFlowEntry";
 
 const PUBLIC_EMBED_PREFIXES = [
   "/share/",
@@ -203,6 +204,7 @@ export function App() {
             path="/roundtable-dashboard"
             element={<DashboardStandalonePage />}
           />
+          <Route path="/official/*" element={<OfficialDeerFlowEntry />} />
           <Route path="/page/*" element={pageElement} />
           <Route path="*" element={<NotFoundPage />} />
         </Routes>

frontend-web/src/assets/agents-plaza/type-ball-bg.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="188" height="241" viewBox="0 0 188 241"><defs><style>.a{fill:url(#a);}.b{fill:#fff;opacity:0.47;}</style><pattern id="a" preserveAspectRatio="xMidYMid slice" width="100%" height="100%" viewBox="0 0 376 482"><image width="376" height="482" xlink:href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAXgAAAHiCAYAAADiYNeDAAAgAElEQVR4nOy993csOZYmdoFIw6R73pav6qrqrvY9flatmdldrWa1+nv1m46OjrSr7ZnZdtW2ulxX1Xt8ho+eTBcB6CACQFzcQEQaMskkeb938iUzvP3w4cPFhdDpGK41hGg+ez3jxZm0veg69r85Vj0zzHqe/thnOmgJAIn9xh8zrQsAqwBwAwA2ybf7rNqPWbaH1nG/V+zfCZRX02y/BQBtO90gAwDz4KcAoOw0bacPAWAAAH3794n9xr/NZx99DiD8dutkdvv4k6F9Toae88Zc+LOk53umZj3fSec57/W7Imhd67NnnCc6loAdETsy7iKiXgOADQBYtyTvvjft9B4i9hW7Tfy7a6dhghcNNKBR0eYIfoRI3hH7iPw2n0NL7OZzhL7N9GNE8kO0PVdwDOw2GYyFggmesWiYZ+wmADwEgHsAcB8AbgPAHft9Cyl2R9DtyHfbbqtlCRx/5JznQMk/sftdt7+d4saf1H7G9jOKfA+Rot8FgB0AeGW/XwDASwB4BgB7dlsMxkLABM84K6zZzyr53LREPongO0t4J5yN1J5j3dEUBL9jSf6EfI7th8E4FdiDZw++wPwefMcS9+sA8BoAPAaABwDwyJL4LUT4MYsmmWIvlxlZjUXjSH3Xkv8WADwHgKcA8AQAvskLAq3ns3LYg59ve1cMrOAZs2DN2hfryCu/awk9RvC3llSZnycSVMDFMLIkHyN483sbeftH9sPqnjEVWMGzgi/QfJ7SEvYbAPCW/X7TEvl9a7GsEZume34HfyXgInSO0efAWjqG6L8CgK8B4M/2e6sxGocV/Hzbu2JggmeCLxCe5xoJVbxrSR0T/BuW4Ncu7qCvBY4twX9NCP5rq+5xiGap7Jng59veFQMTPBN8Ae2P5JFV5+8BwLcA4B077S6yZ9xn3ugVxmxQyJ5xn1fWzvkCAD4FgM+syt/K7yYT/Hzbu2JggmeCv5V/dB7tctcq9LcIwd+5kCNjTMIrQvB/tp9tEHl0zq79nC+Y4JcGTPDXl+DbVpl/GwC+CwAf2obSB6hz0Q0b9cJYXvSRRXNg7RzTQPtHAPgtAPzBqvrze9GZ4JcGTPDXi+BvothzZ8Vggn/AkVWXHqkleUzwzrrZRbH3iwMT/NKACf56ELywZP4hIvN3bPz6Lfu5sbC9My4C+8iieWmtHEf6f7Skvxj2Y4JfGjDBX12C71jv/I5V5h8AwHcswX9gY9YvsimOcX7QNrb+E0vwv7d/P7c+/qszzY3DBL80YIK/mgTfsw2kP7Af02D6trVnbrNav7bYtxaN+XxpG2Z/bT+fWj//9GCCXxowwV8dgu/ZKJh71o75DiL4tzhenUFwbCNuHMH/3to2L218/fxkzwS/NGCCvxoEv2oJ/ScA8GOr3h8ji2aeZFmMq48xsmieWhX/CwD4uW2cnS8lAhP80oAJ/vISfBcpdmO//NAS/I9suCN3QmLMAmXDK39pCf7XtmHWKfrh1Ntigl8aMMFfToJfsQ2lP7GfD23qgHuW9BmMebFtSf1rG23zc6vqP5natmGCXxowwV8egpcoIuZt6607S+ataNrd6/1sM6ZF/LnLrEf/C/txit5F3tQnOmOCXxowwV8OgheW1I398jcA8D0bx37XfkI7RgOzO2NGRJ8/ZRX9tiX33wDAz6yN82XtQ8YEvzTgXovLjRWr2E1UzPcB4C8swX9rqnS8zPGMaVBPktKmg76PQm3v2V7QH1sb55kdwISxhGAFv7wKftX67H8PAH9pOyi5wTTCqBiq2JnYGfMgeP6iin6MBiUxHab+DQD+P+vVn/ilWMEvDVjBLx82LIl/aP31v7fWzKPokeo5XyQGo/IsRX6EgqVtI7Ret436D2270GuW5J/ZkacYSwJW8Mul4Dcsmf8tAPydTQT2wPY+Jcely+Njz51x5rAK3j3O8ed6xyp6EzP/362a/xVok9WSFfwygBX8cmAzt190Tuh/Z332H+fT6QOMiR34AWYsCo6g3QMYVfS3Qefi4zXUqe6u7RW7ZVMjMC4QrOAvXsHfsSGPPwWRe+3fRjnZ64+HiZ1xnnDPdf3jfWgtmj+Chn8FgP/XhlZuz3SUrODPFKzgLw43rPL5nlXsPwUNH03MGcPEzrgI+OeullE37McFAty0ETcf20yWrOYvAKzgL0bB37Ahj39vPx/YRtTV6v6Z0BlLjPjzfuLVPMB/s5//MRXJs4I/U7CCP1/0rMIxqv1/tuT+gyixMxiXF+Z5ftdG2bgBZTZtR6knZ5aWmDERrODPT8EbcjcWzD9aYv++Jfu4JcPKnXGZUP/cH9sG199YJf9/2b/jnaNYwZ8pWMEvHm3bE/A7ltj/yWZ+vHXVT5zBsALmW2h4yFXrz5tImxfnOhj4NQQr+MUq+Jbt4m3i2v+97ZH6ejxChhU74yoh+l4d2vQGxo//P21em0/tQOEFWMGfKVjBLw63rQ9pyP0frHp/fFVPlsGYAhvWprxlLctNO+0z22mKccZgBb8YBX/bhj6ahtR/Z9MO3A+36zqOzLh9BuMywUdXVh70FzbH/H8FgP8bAP4lT0PMCv5MwQr+bNG2se0m3cB/sOT+0VSZHxmM64X7Nlx43fr0Kzbv/BP25c8OTPBnB5E3Jmn9H6wl82NryYTk7hUHSTnAYFwHhM971/bc3rD9QF6z3vwf+M04GzDBnw3MA/q+tWT+2XZiah46j6T4YDCuJCZbkCs2EMGp+Zb15//EmSlPDyb402PNhj3+bzYE8sNoCKSoYXL24BnXAqTNSVcefCOI/toSvbFv/g9r2Rzz8zE/mOBPh7vIb/9fbeclck01p/NlMCg0SpNd4pYNJe7aGSt2eMDZEpYxPJjg54fx1/8KAP5LniisGM6suJ5epWjQ+YAcPCgHgxGiYPg8uMZF2BTvSMt2CuzZTKumhvyvdhQpxoxggp8dLlLGhEH+R9uB6d18K1iMeGLX1z5Ui8GYCCFwu9SKbXztICX/M46wmR1M8LOhZcn8761y/+to56VAuTO5MxhRmPfETi/cmoov/5a1Pl2Kg/9mO0WlfEGnAxP89FixNoyJlPlfAOB/snmvS/jRlpjcGYypEH1HPNEnduzXjjVw2nbml7XJyhgBmOCnQ9fmbP+pVe4/CcjdKRGtUXw7kzuDMRWC90f44WCRon9g3701S/L/j42VH/EFbgYT/GSs2Tjdf7Ke+18FMe4Vtc7EzmDMDCyIzN9+iMCA5I0lmiHe+ozDKJvBBN+Mnm3R/0fbgemHlNwDr51j2hmMU0KXkcVVb/6OTd7Xs9xlrJvf8gAi9WCCr8ea7Z36T9Zz/4s8j7UAFNfOXjuDsRBUkvFZ30bnAsu8iwoApFX0n7CSj4MJPo5VG6b1TyDyHqo/tIMUWCDlDqzcGYwzBcrX5HnedYoq5t20HaI6dkHTGPs7OxYsA4EJvooVOwLNP1rl/qOA3B2xK0XqkWy/MxhnAvw+5danBpCymFbaNbfsuzm0S46skufoGgQm+BBda8uYbJD/2WaEDMndELvSIJxRKJjYGYwzBX6f3N+ZApCiIPqS5G/YoIcEEf0n9u9rD2CCD2Cqe++gOPcf2YE7CuTkbj9Bi/8FHzWDcdXh2ryU/ZZRJX9ifXnT0/VzDqEswARfoG3J/ac2K+Rf2Rb7Aki5c4Mqg3FBcO8hVJS8i65JLLFrS/LXPq0BE3xhsjy2oy/9J9tCf8/P9cpdlR0xGAzGxUAboSUsyQdK/p59d09sZI3x4r+67nVsJniAh1ax/2er4MuxU51iMP4fcKw7g3HhcDXoLCuiJEMlf9++wwYHVs1vXeebdt0J/o4l9/9ke8kV6Qe854eVO1szDMZSwJG8t2vAhVAK1ON11xL8f80H876muM4Ev5E3zmj9v9tG1df8HPP8qKwgeCDkzh48g7EEsFFsRsmb0aFkgg/pNftOg+0A9S/Xdfi/60rwa7bl3WWFfNvPCTx3YOXOYCwrvJK3bWMmjLKwaxL7Tpt3e8cq+Z9fx96u15HgE9tL9b/YiJl3/RyOlmEwLhmsko9H17xr33Gwja+/tA2w1wbXjeDbNjPkP9gcM98JrkHeS1UxuTMYlw35eyuKT0nwXfuOm2RkL62C/+w6hU9eN4J/3Q6Q/c8BueOqHm1QrY4yw2AwlgW006GyqQ3Kd9eN8frPtoer+XxxXe5f60p6zP6UfHIiYSNmfmzHUP2RbWQtkVfx1AUdMIPBOBsom2fS5q4psGHf+UMbNnloI2t00M52BbVc68q2IebtLi5fjLhtwyEdud8LlnPWjELqnZU7g7H8cO+pH5fBkLu1a0Bg0r5r3/0ta9n8DLQuwievcE6pq6vg89PKb/CKbWwx2SH/znZsssshYqfZIbnTKoNxORAMpqZRVI0uOkOFo0IZDjjynryGQTX3/NXBVffguzbHzN/aVAQf2lzvtvXd9lJVqmyNd+AskQzG5YEm728eHy+LmDkhHXuvWg4wETXfWKL//Cpnn7zqBH8HtOnVpv+xGDRbrBWTrcTPQyKzOJGzgmcwLgfo++uVfFa8w17BO5LXH+Q1ep178SalwZOreqevLsELWAWtv1tEzYh/VzSy2ichL+1tT1WqLine truncated

frontend-web/src/assets/agents-plaza/type-cbw.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="68" height="68" viewBox="0 0 68 68"><defs><style>.a{fill:#fff;stroke:#707070;stroke-width:3.75px;opacity:0;}.b{fill:url(#a);}.c{stroke:none;}.d{fill:none;}</style><linearGradient id="a" x1="0.431" x2="1" y2="1" gradientUnits="objectBoundingBox"><stop offset="0" stop-color="#f3212c"/><stop offset="1" stop-color="#aa071a"/></linearGradient></defs><g transform="translate(-71.077 -67.746)"><g class="a" transform="translate(71.077 67.746)"><rect class="c" width="68" height="68"/><rect class="d" x="1.875" y="1.875" width="64.25" height="64.25"/></g><path class="b" d="M114.406,106.791a7.707,7.707,0,0,0-4.354,1.353L98.7,99.937a13.3,13.3,0,0,0,1.742-6.583c0-.421-.03-.842-.06-1.263L112,85.207a4.687,4.687,0,1,0-1.952-2.345L99.691,88.995a13.678,13.678,0,0,0-6.1-7.365l2.072-10.341c.15,0,.3.03.451.03a4.66,4.66,0,1,0-4.655-4.659,4.727,4.727,0,0,0,1.412,3.367l-2.1,10.462A13.479,13.479,0,0,0,80.05,81.87l-6.4-5.712A6.129,6.129,0,1,0,71.7,78.443L77.677,83.7a13.456,13.456,0,0,0,.691,19.991l-5.316,5.622a5.948,5.948,0,0,0-3.394-1.022,6.163,6.163,0,1,0,6.156,6.162,6.343,6.343,0,0,0-.721-2.916l5.826-6.193a13.464,13.464,0,0,0,16.1-2.946l11.022,7.966a7.77,7.77,0,0,0-1.2,4.118,7.658,7.658,0,1,0,15.316,0A7.817,7.817,0,0,0,114.406,106.791Zm0,0" transform="translate(13 9.671)"/></g></svg>

frontend-web/src/assets/agents-plaza/type-idea.svg

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="68" height="68" viewBox="0 0 68 68">
+  <defs>
+    <linearGradient id="ap-idea" x1="0.405" x2="1" y2="1" gradientUnits="objectBoundingBox">
+      <stop offset="0" stop-color="#f3212c"/>
+      <stop offset="1" stop-color="#aa071a"/>
+    </linearGradient>
+  </defs>
+  <g fill="url(#ap-idea)" transform="translate(12 10)">
+    <path d="M22 2.2A12.8 12.8 0 0 0 9.2 15c0 5.1 2.9 9.5 7.1 11.6v3.8a2.4 2.4 0 0 0 2.4 2.4h6.6a2.4 2.4 0 0 0 2.4-2.4v-3.8A12.8 12.8 0 0 0 34.8 15 12.8 12.8 0 0 0 22 2.2Zm3.3 26.8h-6.6v-2.1h6.6Zm-3.3-26.8A10.4 10.4 0 0 1 32.4 15a10.4 10.4 0 0 1-6.3 9.5 2.4 2.4 0 0 0-1.3 2.1v.3h-5.6v-.3a2.4 2.4 0 0 0-1.3-2.1A10.4 10.4 0 0 1 11.6 15 10.4 10.4 0 0 1 22 2.2Z"/>
+    <path d="M17.6 39.2a2 2 0 0 0 2 2h4.8a2 2 0 0 0 2-2v-1.4h-8.8Zm-1.8-3.8h12.4a1.6 1.6 0 1 0 0-3.2H15.8a1.6 1.6 0 1 0 0 3.2Z"/>
+    <path d="M8.4 22.6a1.6 1.6 0 0 0 0-3.2H3.8a1.6 1.6 0 1 0 0 3.2Zm31.8 0a1.6 1.6 0 0 0 0-3.2h-4.6a1.6 1.6 0 1 0 0 3.2ZM7.2 10.8a1.6 1.6 0 0 0 2.3-2.3L6.2 5.3A1.6 1.6 0 0 0 4 7.6Zm29.3-2.3a1.6 1.6 0 0 0 2.3 2.3l3.2-3.2A1.6 1.6 0 1 0 39.7 5.3Z"/>
+  </g>
+</svg>

frontend-web/src/assets/agents-plaza/type-mine.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="68" height="68" viewBox="0 0 68 68"><defs><style>.a{fill:#fff;opacity:0;}.b{fill:url(#a);}</style><linearGradient id="a" x1="0.405" x2="1" y2="1" gradientUnits="objectBoundingBox"><stop offset="0" stop-color="#f3212c"/><stop offset="1" stop-color="#aa071a"/></linearGradient></defs><g transform="translate(14482.893 -23044.904)"><rect class="a" width="68" height="68" transform="translate(-14482.893 23044.904)"/><path class="b" d="M43.013,57.336h-.255l-.074,0a14.064,14.064,0,0,1-8.911-3.467,6.216,6.216,0,0,1,6.1-5.029h6.278a6.218,6.218,0,0,1,6.1,5.03A14.073,14.073,0,0,1,43.6,57.324h-.009l-.067,0H43.5l-.063,0h-.424ZM30.159,54.9H8.5a1.717,1.717,0,0,1-1.715-1.716v-10.1A1.717,1.717,0,0,1,8.5,41.363H20.6a1.717,1.717,0,0,0,1.716-1.715V37.73H11.824a1.717,1.717,0,0,1-1.716-1.715V8.8a1.718,1.718,0,0,1,1.716-1.716h8.768V3.437A3.44,3.44,0,0,1,24.029,0h6.93A3.441,3.441,0,0,1,34.4,3.437V7.089H42.87A1.718,1.718,0,0,1,44.586,8.8V26.022c-.515-.046-1.044-.07-1.574-.07A17.327,17.327,0,0,0,30.157,54.9Zm4.219-36.07a3.437,3.437,0,1,0,3.438,3.437A3.441,3.441,0,0,0,34.378,18.828Zm-13.619,0A3.437,3.437,0,1,0,24.2,22.265,3.441,3.441,0,0,0,20.758,18.828ZM24.029,3.437V7.083h6.924V3.437Zm7.256,47.59v0a14.059,14.059,0,1,1,23.456,0,9.508,9.508,0,0,0-8.589-5.455H44.686a7.193,7.193,0,1,0-3.347,0H39.873a9.5,9.5,0,0,0-8.587,5.457ZM43.013,42.5a3.923,3.923,0,1,1,3.923-3.924A3.928,3.928,0,0,1,43.013,42.5ZM6.844,31.07a1.717,1.717,0,0,1-1.716-1.715V15.176a1.715,1.715,0,1,1,3.431,0V29.355A1.717,1.717,0,0,1,6.844,31.07ZM49.8,27.327h0a17.187,17.187,0,0,0-3.429-1.051v-11.1a1.715,1.715,0,1,1,3.431,0v12.15Zm3.406-.007a1.717,1.717,0,0,1-1.715-1.715V18.724a1.715,1.715,0,0,1,3.431,0v6.881A1.717,1.717,0,0,1,53.206,27.32Zm-51.491,0A1.717,1.717,0,0,1,0,25.605V18.724a1.715,1.715,0,0,1,3.431,0v6.881A1.717,1.717,0,0,1,1.715,27.32Z" transform="translate(-14477.664 23050.15)"/></g></svg>

frontend-web/src/assets/agents-plaza/type-task.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="68" height="68" viewBox="0 0 68 68">
+  <defs>
+    <linearGradient id="ap-task" x1="0.405" x2="1" y2="1" gradientUnits="objectBoundingBox">
+      <stop offset="0" stop-color="#f3212c"/>
+      <stop offset="1" stop-color="#aa071a"/>
+    </linearGradient>
+  </defs>
+  <g fill="url(#ap-task)" transform="translate(14 12)">
+    <path d="M28.4 2.2H15.6A3.4 3.4 0 0 0 12.2 5.6v2.8H8.6A3.4 3.4 0 0 0 5.2 11.8v28.8A3.4 3.4 0 0 0 8.6 44h22.8a3.4 3.4 0 0 0 3.4-3.4V11.8a3.4 3.4 0 0 0-3.4-3.4h-3.6V5.6A3.4 3.4 0 0 0 28.4 2.2Zm-12.8 3.4h12.8v2.8H15.6Zm19.2 35.8H8.6V11.8h3.6v2.2a1.6 1.6 0 0 0 1.6 1.6h12.8a1.6 1.6 0 0 0 1.6-1.6v-2.2h3.6Z"/>
+    <rect x="11.4" y="24.2" width="3.6" height="11.6" rx="1.2"/>
+    <rect x="18.2" y="20.4" width="3.6" height="15.4" rx="1.2"/>
+    <rect x="25" y="27.2" width="3.6" height="8.6" rx="1.2"/>
+  </g>
+</svg>

frontend-web/src/assets/deer.svg

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

frontend-web/src/components/ai-elements/message.tsx

@@ -18,7 +18,9 @@ import {
 } from "lucide-react";
 import type { ComponentProps, HTMLAttributes, ReactElement } from "react";
 import { createContext, memo, useContext, useEffect, useState } from "react";
-import { Streamdown } from "streamdown";
+import type { StreamdownProps } from "streamdown";
+
+import { SafeStreamdown } from "@/core/streamdown";
 
 export type MessageProps = HTMLAttributes<HTMLDivElement> & {
   from: UIMessage["role"];
@@ -302,11 +304,11 @@ export const MessageBranchPage = ({
   );
 };
 
-export type MessageResponseProps = ComponentProps<typeof Streamdown>;
+export type MessageResponseProps = StreamdownProps;
 
 export const MessageResponse = memo(
   ({ className, ...props }: MessageResponseProps) => (
-    <Streamdown
+    <SafeStreamdown
       className={cn(
         "size-full [&>*:first-child]:mt-0 [&>*:last-child]:mb-0",
         className,

frontend-web/src/components/ai-elements/prompt-input.tsx

@@ -34,9 +34,14 @@ import {
   SelectTrigger,
   SelectValue,
 } from "@/components/ui/select";
-import type { PromptInputFilePart } from "@/core/uploads";
+import type { PromptInputFilePart, UploadPolicy } from "@/core/uploads";
-import { splitUnsupportedUploadFiles } from "@/core/uploads";
+import {
-import { isIMEComposing } from "@/lib/ime";
+  DEFAULT_UPLOAD_POLICY,
+  splitUnsupportedUploadFiles,
+  useUploadPolicy,
+  validateChatUploadFiles,
+} from "@/core/uploads";
+import { imeEnterAction } from "@/lib/ime";
 import { cn } from "@/lib/utils";
 import type { ChatStatus } from "ai";
 import {
@@ -56,11 +61,12 @@ import {
   type ChangeEventHandler,
   Children,
   type ClipboardEventHandler,
-  type ComponentProps,
+  type ComponentProps,
-  createContext,
+  type CompositionEventHandler,
-  type FormEvent,
+  createContext,
-  type FormEventHandler,
+  type FormEvent,
-  type HTMLAttributes,
+  type FormEventHandler,
+  type HTMLAttributes,
   type KeyboardEventHandler,
   type PropsWithChildren,
   type ReactNode,
@@ -123,11 +129,11 @@ export const usePromptInputController = () => {
   return ctx;
 };
 
-// Optional variants (do NOT throw). Useful for dual-mode components and for
+// Optional variants (do NOT throw). Useful for dual-mode components and for
-// Fast Refresh transitions where a page can briefly retain the previous
+// Fast Refresh transitions where a page can briefly retain the previous
-// provider context instance.
+// provider context instance.
-export const useOptionalPromptInputController = () =>
+export const useOptionalPromptInputController = () =>
-  useContext(PromptInputController);
+  useContext(PromptInputController);
 
 export const useProviderAttachments = () => {
   const ctx = useContext(ProviderAttachmentsContext);
@@ -145,6 +151,7 @@ const usePromptInputValidation = () => useContext(PromptInputValidationContext);
 
 export type PromptInputProviderProps = PropsWithChildren<{
   initialInput?: string;
+  uploadPolicy?: UploadPolicy;
 }>;
 
 /**
@@ -153,8 +160,12 @@ export type PromptInputProviderProps = PropsWithChildren<{
  */
 export function PromptInputProvider({
   initialInput: initialTextInput = "",
+  uploadPolicy,
   children,
 }: PromptInputProviderProps) {
+  const { data: fetchedUploadPolicy } = useUploadPolicy();
+  const effectiveUploadPolicy =
+    uploadPolicy ?? fetchedUploadPolicy ?? DEFAULT_UPLOAD_POLICY;
   // ----- textInput state
   const [textInput, setTextInput] = useState(initialTextInput);
   const clearInput = useCallback(() => setTextInput(""), []);
@@ -163,6 +174,7 @@ export function PromptInputProvider({
   const [attachmentFiles, setAttachmentFiles] = useState<
     (PromptInputFilePart & { id: string })[]
   >([]);
+  const attachmentsRef = useRef(attachmentFiles);
   const fileInputRef = useRef<HTMLInputElement | null>(null);
   const openRef = useRef<() => void>(() => {});
 
@@ -172,9 +184,26 @@ export function PromptInputProvider({
       return;
     }
 
-    setAttachmentFiles((prev) =>
+    const current = attachmentsRef.current;
-      prev.concat(
+    const existing = current.map((item) => ({
-        incoming.map((file) => ({
+      name: item.filename ?? "attachment",
+      size: item.file?.size ?? 0,
+      type: item.mediaType ?? "",
+    }));
+    const validation = validateChatUploadFiles(
+      incoming,
+      existing,
+      effectiveUploadPolicy,
+    );
+    for (const message of new Set(
+      validation.issues.map((issue) => issue.message),
+    )) {
+      toast.error(message);
+    }
+    if (validation.accepted.length === 0) return;
+
+    const next = current.concat(
+      validation.accepted.map((file) => ({
           id: nanoid(),
           type: "file" as const,
           url: URL.createObjectURL(file),
@@ -182,33 +211,31 @@ export function PromptInputProvider({
           filename: file.name,
           file,
         })),
-      ),
     );
-  }, []);
+    attachmentsRef.current = next;
+    setAttachmentFiles(next);
+  }, [effectiveUploadPolicy]);
 
   const remove = useCallback((id: string) => {
-    setAttachmentFiles((prev) => {
+    const current = attachmentsRef.current;
-      const found = prev.find((f) => f.id === id);
+    const found = current.find((f) => f.id === id);
-      if (found?.url) {
+    if (found?.url) URL.revokeObjectURL(found.url);
-        URL.revokeObjectURL(found.url);
+    const next = current.filter((f) => f.id !== id);
-      }
+    attachmentsRef.current = next;
-      return prev.filter((f) => f.id !== id);
+    setAttachmentFiles(next);
-    });
   }, []);
 
   const clear = useCallback(() => {
-    setAttachmentFiles((prev) => {
+    for (const f of attachmentsRef.current) {
-      for (const f of prev) {
+      if (f.url) {
-        if (f.url) {
+        URL.revokeObjectURL(f.url);
-          URL.revokeObjectURL(f.url);
-        }
       }
-      return [];
+    }
-    });
+    attachmentsRef.current = [];
+    setAttachmentFiles([]);
   }, []);
 
   // Keep a ref to attachments for cleanup on unmount (avoids stale closure)
-  const attachmentsRef = useRef(attachmentFiles);
   attachmentsRef.current = attachmentFiles;
 
   // Cleanup blob URLs on unmount to prevent memory leaks
@@ -404,14 +431,14 @@ export function PromptInputAttachments({
   return (
     <div
       className={cn("flex w-full flex-wrap items-center gap-2 p-3", className)}
-      {...props}
+      {...props}
-    >
+    >
-      {attachments.files.map((file) => (
+      {attachments.files.map((file) => (
-        <div key={file.id} className="max-w-60">
+        <div key={file.id} className="max-w-60">
-          {children(file)}
+          {children(file)}
-        </div>
+        </div>
-      ))}
+      ))}
-    </div>
+    </div>
   );
 }
 
@@ -459,8 +486,15 @@ export type PromptInputProps = Omit<
   // Minimal constraints
   maxFiles?: number;
   maxFileSize?: number; // bytes
+  uploadPolicy?: UploadPolicy;
   onError?: (err: {
-    code: "max_files" | "max_file_size" | "accept" | "unsupported_package";
+    code:
+      | "max_files"
+      | "max_file_size"
+      | "max_total_size"
+      | "unsupported_type"
+      | "accept"
+      | "unsupported_package";
     message: string;
   }) => void;
   onSubmit: (
@@ -478,11 +512,22 @@ export const PromptInput = ({
   syncHiddenInput,
   maxFiles,
   maxFileSize,
+  uploadPolicy,
   onError,
   onSubmit,
   children,
   ...props
 }: PromptInputProps) => {
+  const { data: fetchedUploadPolicy } = useUploadPolicy();
+  const effectiveUploadPolicy =
+    uploadPolicy ?? fetchedUploadPolicy ?? DEFAULT_UPLOAD_POLICY;
+  const policyAccept = useMemo(
+    () =>
+      Object.values(effectiveUploadPolicy.groups)
+        .flatMap((group) => group.extensions)
+        .join(","),
+    [effectiveUploadPolicy],
+  );
   // Try to use a provider controller if present
   const controller = useOptionalPromptInputController();
   const usingProvider = !!controller;
@@ -517,6 +562,9 @@ export const PromptInput = ({
         .filter(Boolean);
 
       return patterns.some((pattern) => {
+        if (pattern.startsWith(".")) {
+          return f.name.toLowerCase().endsWith(pattern.toLowerCase());
+        }
         if (pattern.endsWith("/*")) {
           const prefix = pattern.slice(0, -1); // e.g: image/* -> image/
           return f.type.startsWith(prefix);
@@ -531,52 +579,67 @@ export const PromptInput = ({
     (fileList: File[] | FileList) => {
       const incoming = Array.from(fileList);
       const accepted = incoming.filter((f) => matchesAccept(f));
-      if (incoming.length && accepted.length === 0) {
+      if (accepted.length < incoming.length) {
-        onError?.({
+        const error = {
           code: "accept",
-          message: "No files match the accepted types.",
+          message: "部分文件不符合当前输入框允许的格式。",
-        });
+        } as const;
-        return;
+        onError?.(error);
+        if (!onError) toast.error(error.message);
       }
-      const withinSize = (f: File) =>
+      const localPolicy: UploadPolicy = {
-        maxFileSize ? f.size <= maxFileSize : true;
+        ...effectiveUploadPolicy,
-      const sized = accepted.filter(withinSize);
+        max_files_per_message:
-      if (accepted.length > 0 && sized.length === 0) {
-        onError?.({
-          code: "max_file_size",
-          message: "All files exceed the maximum size.",
-        });
-        return;
-      }
-
-      setItems((prev) => {
-        const capacity =
           typeof maxFiles === "number"
-            ? Math.max(0, maxFiles - prev.length)
+            ? Math.min(effectiveUploadPolicy.max_files_per_message, maxFiles)
-            : undefined;
+            : effectiveUploadPolicy.max_files_per_message,
-        const capped =
+        groups: Object.fromEntries(
-          typeof capacity === "number" ? sized.slice(0, capacity) : sized;
+          Object.entries(effectiveUploadPolicy.groups).map(([key, group]) => [
-        if (typeof capacity === "number" && sized.length > capacity) {
+            key,
-          onError?.({
+            {
-            code: "max_files",
+              ...group,
-            message: "Too many files. Some were not added.",
+              max_bytes:
-          });
+                typeof maxFileSize === "number"
-        }
+                  ? Math.min(group.max_bytes, maxFileSize)
-        const next: (PromptInputFilePart & { id: string })[] = [];
+                  : group.max_bytes,
-        for (const file of capped) {
+            },
-          next.push({
+          ]),
+        ) as UploadPolicy["groups"],
+      };
+      const existing = items.map((item) => ({
+        name: item.filename ?? "attachment",
+        size: item.file?.size ?? 0,
+        type: item.mediaType ?? "",
+      }));
+      const validation = validateChatUploadFiles(
+        accepted,
+        existing,
+        localPolicy,
+      );
+      for (const issue of Array.from(
+        new Map(
+          validation.issues.map((item) => [item.message, item]),
+        ).values(),
+      )) {
+        onError?.({ code: issue.code, message: issue.message });
+        if (!onError) toast.error(issue.message);
+      }
+      if (validation.accepted.length === 0) return;
+
+      setItems((prev) =>
+        prev.concat(
+          validation.accepted.map((file) => ({
             id: nanoid(),
-            type: "file",
+            type: "file" as const,
             url: URL.createObjectURL(file),
             mediaType: file.type,
             filename: file.name,
             file,
-          });
+          })),
-        }
+        ),
-        return prev.concat(next);
+      );
-      });
     },
-    [matchesAccept, maxFiles, maxFileSize, onError],
+    [effectiveUploadPolicy, items, matchesAccept, maxFiles, maxFileSize, onError],
   );
 
   const removeLocal = useCallback(
@@ -765,11 +828,17 @@ export const PromptInput = ({
     event.preventDefault();
 
     const form = event.currentTarget;
+    // Prefer the live textarea. Firefox 102 applies the chosen candidate to
+    // the DOM before React state catches up, and a send click in that gap
+    // would otherwise submit the previous pinyin-less value.
+    const liveText = form.querySelector<HTMLTextAreaElement>(
+      "textarea[name='message']",
+    )?.value;
     const text = usingProvider
-      ? controller.textInput.value
+      ? (liveText ?? controller.textInput.value)
       : (() => {
           const formData = new FormData(form);
-          return (formData.get("message") as string) || "";
+          return (formData.get("message") as string) || liveText || "";
         })();
 
     // Reset form immediately after capturing text to avoid race condition
@@ -832,7 +901,7 @@ export const PromptInput = ({
   const inner = (
     <PromptInputValidationContext.Provider value={sanitizeIncomingFiles}>
       <input
-        accept={accept}
+        accept={accept ?? policyAccept}
         aria-label="Upload files"
         className="hidden"
         multiple={multiple}
@@ -847,10 +916,12 @@ export const PromptInput = ({
         ref={formRef}
         {...props}
       >
-        {/* Do not rely on InputGroup's :has(textarea) selector here: Chrome
+        {/* Do not rely on InputGroup's :has() selectors here: Chrome versions
-            versions before 105 ignore :has(), retain h-9, and clip the whole
+            before 105 ignore them, keep the horizontal flex layout, and
-            multi-line composer to a single row. */}
+            squeeze the textarea beside the footer controls. */}
-        <InputGroup className="h-auto min-h-16">{children}</InputGroup>
+        <InputGroup className="h-auto min-h-16 flex-col items-stretch">
+          {children}
+        </InputGroup>
       </form>
     </PromptInputValidationContext.Provider>
   );
@@ -877,58 +948,100 @@ export type PromptInputTextareaProps = ComponentProps<
   typeof InputGroupTextarea
 >;
 
-export const PromptInputTextarea = ({
+export const PromptInputTextarea = ({
-  onChange,
+  onChange,
-  onInput,
+  onInput,
-  className,
+  onKeyDown,
-  placeholder = "What would you like to know?",
+  onCompositionStart,
-  ...props
+  onCompositionEnd,
-}: PromptInputTextareaProps) => {
+  className,
-  const controller = useOptionalPromptInputController();
+  placeholder = "What would you like to know?",
-  const attachments = usePromptInputAttachments();
+  defaultValue,
-  const sanitizeIncomingFiles = usePromptInputValidation();
+  ...props
-  const [isComposing, setIsComposing] = useState(false);
+}: PromptInputTextareaProps) => {
-  const textareaRef = useRef<HTMLTextAreaElement | null>(null);
+  const controller = useOptionalPromptInputController();
-
+  const attachments = usePromptInputAttachments();
-  const resizeForLegacyChrome = useCallback((textarea: HTMLTextAreaElement) => {
+  const sanitizeIncomingFiles = usePromptInputValidation();
-    if (
+  const textareaRef = useRef<HTMLTextAreaElement | null>(null);
-      typeof CSS !== "undefined" &&
+  const composingRef = useRef(false);
-      typeof CSS.supports === "function" &&
+  const compositionEndedAtRef = useRef(0);
-      CSS.supports("field-sizing", "content")
+  const onChangeRef = useRef(onChange);
-    ) {
+  const onInputRef = useRef(onInput);
-      return;
+  const onKeyDownRef = useRef(onKeyDown);
-    }
+  const onCompositionStartRef = useRef(onCompositionStart);
-
+  const onCompositionEndRef = useRef(onCompositionEnd);
-    // Chrome 109 ignores field-sizing: content. Preserve the same 4rem–12rem
+  const setInputRef = useRef(controller?.textInput.setInput);
-    // autosize range used by min-h-16/max-h-48 instead of leaving the prompt
+  const attachmentsRef = useRef(attachments);
-    // stuck at its minimum height.
+  onChangeRef.current = onChange;
-    textarea.style.height = "auto";
+  onInputRef.current = onInput;
-    const height = Math.max(64, Math.min(textarea.scrollHeight, 192));
+  onKeyDownRef.current = onKeyDown;
-    textarea.style.height = `${height}px`;
+  onCompositionStartRef.current = onCompositionStart;
-    textarea.style.overflowY = textarea.scrollHeight > 192 ? "auto" : "hidden";
+  onCompositionEndRef.current = onCompositionEnd;
-  }, []);
+  setInputRef.current = controller?.textInput.setInput;
-
+  attachmentsRef.current = attachments;
-  // onInput does not run for a controlled value filled by a suggested question
+
-  // or restored draft. Resize once after every render in legacy Chrome too.
+  const publishValue = useCallback((value: string) => {
-  useEffect(() => {
+    setInputRef.current?.(value);
-    const textarea = textareaRef.current;
+  }, []);
-    if (!textarea) return;
+
-
+  const resizeForLegacyChrome = useCallback((textarea: HTMLTextAreaElement) => {
-    const frame = window.requestAnimationFrame(() => {
+    // Firefox 102 commits an open IME composition as raw pinyin when the
-      resizeForLegacyChrome(textarea);
+    // textarea's height or overflow changes mid-composition.
-    });
+    if (composingRef.current) return;
-    return () => window.cancelAnimationFrame(frame);
+    if (
-  }, [controller?.textInput.value, resizeForLegacyChrome]);
+      typeof CSS !== "undefined" &&
+      typeof CSS.supports === "function" &&
+      CSS.supports("field-sizing", "content")
+    ) {
+      return;
+    }
+
+    // Chrome 109 ignores field-sizing: content. Preserve the same 4rem–12rem
+    // autosize range used by min-h-16/max-h-48 instead of leaving the prompt
+    // stuck at its minimum height.
+    textarea.style.height = "auto";
+    const height = Math.max(64, Math.min(textarea.scrollHeight, 192));
+    textarea.style.height = `${height}px`;
+    textarea.style.overflowY = textarea.scrollHeight > 192 ? "auto" : "hidden";
+  }, []);
+
+  // onInput does not run for a controlled value filled by a suggested question
+  // or restored draft. Resize once after every render in legacy Chrome too.
+  useEffect(() => {
+    if (composingRef.current) return;
+    const textarea = textareaRef.current;
+    if (!textarea) return;
+
+    const frame = window.requestAnimationFrame(() => {
+      resizeForLegacyChrome(textarea);
+    });
+    return () => window.cancelAnimationFrame(frame);
+  }, [controller?.textInput.value, resizeForLegacyChrome]);
 
   const handleKeyDown: KeyboardEventHandler<HTMLTextAreaElement> = (e) => {
     if (e.key === "Enter") {
-      if (isIMEComposing(e, isComposing)) {
+      const action = imeEnterAction({
+        isComposing: composingRef.current,
+        nativeIsComposing: e.nativeEvent.isComposing || e.key === "Process",
+        keyCode: e.keyCode,
+        compositionEndedAt: compositionEndedAtRef.current,
+        now: performance.now(),
+      });
+      // Firefox 102 confirms the candidate on this key. preventDefault here
+      // cancels that confirmation and leaves the pinyin in the box.
+      if (action === "ignore") {
         return;
       }
-      if (e.shiftKey) {
+      onKeyDownRef.current?.(e);
+      if (e.defaultPrevented || e.shiftKey) {
         return;
       }
+      // The confirming Enter already finished the candidate. Swallow it so
+      // Firefox does not also insert a newline or send the message.
       e.preventDefault();
+      if (action === "swallow") {
+        return;
+      }
 
       // Check if the submit button is disabled before submitting
       const form = e.currentTarget.form;
@@ -940,22 +1053,59 @@ export const PromptInputTextarea = ({
       }
 
       form?.requestSubmit();
+      return;
     }
 
+    onKeyDownRef.current?.(e);
+    if (e.defaultPrevented) return;
+
+    if (composingRef.current) return;
+
     // Remove last attachment when Backspace is pressed and textarea is empty
     if (
       e.key === "Backspace" &&
       e.currentTarget.value === "" &&
-      attachments.files.length > 0
+      attachmentsRef.current.files.length > 0
     ) {
       e.preventDefault();
-      const lastAttachment = attachments.files.at(-1);
+      const lastAttachment = attachmentsRef.current.files.at(-1);
       if (lastAttachment) {
-        attachments.remove(lastAttachment.id);
+        attachmentsRef.current.remove(lastAttachment.id);
       }
     }
   };
 
+  const handleCompositionStart: CompositionEventHandler<HTMLTextAreaElement> = (
+    event,
+  ) => {
+    composingRef.current = true;
+    compositionEndedAtRef.current = 0;
+    onCompositionStartRef.current?.(event);
+  };
+
+  const handleCompositionEnd: CompositionEventHandler<HTMLTextAreaElement> = (
+    event,
+  ) => {
+    onCompositionEndRef.current?.(event);
+    composingRef.current = false;
+    compositionEndedAtRef.current = performance.now();
+    const el = event.currentTarget;
+    // Firefox 102 dispatches compositionend before the committed candidate is
+    // visible, and before the input event that carries it. Syncing the
+    // compositionend value here would write the raw pinyin back over 汉字.
+    window.setTimeout(() => {
+      if (el.isConnected) publishValue(el.value);
+    }, 0);
+  };
+
+  const handleChange: ChangeEventHandler<HTMLTextAreaElement> = (event) => {
+    // Keep the controlled value identical to the DOM, including the pinyin
+    // still being composed. Otherwise React restores the previous value at
+    // the end of the input event and Firefox 102 cannot replace it.
+    publishValue(event.currentTarget.value);
+    onChangeRef.current?.(event);
+  };
+
   const handlePaste: ClipboardEventHandler<HTMLTextAreaElement> = (event) => {
     const items = event.clipboardData?.items;
 
@@ -985,35 +1135,28 @@ export const PromptInputTextarea = ({
     }
   };
 
-  const controlledProps = controller
-    ? {
-        value: controller.textInput.value,
-        onChange: (e: ChangeEvent<HTMLTextAreaElement>) => {
-          controller.textInput.setInput(e.currentTarget.value);
-          onChange?.(e);
-        },
-      }
-    : {
-        onChange,
-      };
-
   return (
-    <InputGroupTextarea
+    <InputGroupTextarea
-      className={cn("field-sizing-content max-h-48 min-h-16", className)}
+      {...props}
-      name="message"
+      className={cn("field-sizing-content max-h-48 min-h-16", className)}
-      ref={textareaRef}
+      name="message"
-      rows={3}
+      ref={textareaRef}
-      onCompositionEnd={() => setIsComposing(false)}
+      rows={3}
-      onCompositionStart={() => setIsComposing(true)}
+      onChange={handleChange}
-      onKeyDown={handleKeyDown}
+      onCompositionEnd={handleCompositionEnd}
-      onInput={(event) => {
+      onCompositionStart={handleCompositionStart}
-        resizeForLegacyChrome(event.currentTarget);
+      onKeyDown={handleKeyDown}
-        onInput?.(event);
+      onInput={(event) => {
-      }}
+        if (!composingRef.current) {
+          resizeForLegacyChrome(event.currentTarget);
+        }
+        onInputRef.current?.(event);
+      }}
       onPaste={handlePaste}
       placeholder={placeholder}
-      {...props}
+      {...(controller
-      {...controlledProps}
+        ? { value: controller.textInput.value }
+        : { defaultValue })}
     />
   );
 };
@@ -1131,20 +1274,24 @@ export const PromptInputSubmit = ({
   status,
   children,
   ...props
-}: PromptInputSubmitProps) => {
+}: PromptInputSubmitProps) => {
-  let Icon = <ArrowUpIcon className="size-4" />;
+  let Icon = <ArrowUpIcon className="size-4" />;
-
+  let ariaLabel = "发送消息";
-  if (status === "submitted") {
+
-    Icon = <Loader2Icon className="size-4 animate-spin" />;
+  if (status === "submitted") {
-  } else if (status === "streaming") {
+    Icon = <Loader2Icon className="size-4 animate-spin" />;
-    Icon = <SquareIcon className="size-4" />;
+    ariaLabel = "正在发送";
-  } else if (status === "error") {
+  } else if (status === "streaming") {
-    Icon = <XIcon className="size-4" />;
+    Icon = <SquareIcon className="size-4" />;
-  }
+    ariaLabel = "停止生成";
-
+  } else if (status === "error") {
-  return (
+    Icon = <XIcon className="size-4" />;
-    <InputGroupButton
+    ariaLabel = "重新发送";
-      aria-label="Submit"
+  }
+
+  return (
+    <InputGroupButton
+      aria-label={ariaLabel}
       className={cn(
         "transition-all duration-300",
         status === "streaming" &&

frontend-web/src/components/ai-elements/reasoning.tsx

@@ -10,7 +10,7 @@ import { cn } from "@/lib/utils";
 import { BrainIcon, ChevronDownIcon } from "lucide-react";
 import type { ComponentProps, ReactNode } from "react";
 import { createContext, memo, useContext, useEffect, useState } from "react";
-import { Streamdown } from "streamdown";
+import { SafeStreamdown } from "@/core/streamdown";
 import { reasoningPlugins } from "@/core/streamdown/plugins";
 import { Shimmer } from "./shimmer";
 
@@ -179,7 +179,7 @@ export const ReasoningContent = memo(
       {...props}
     >
       {typeof children === "string" ? (
-        <Streamdown {...reasoningPlugins}>{children}</Streamdown>
+        <SafeStreamdown {...reasoningPlugins}>{children}</SafeStreamdown>
       ) : (
         children
       )}

frontend-web/src/components/assistant-ui/document-upload-popup.tsx

@@ -31,6 +31,11 @@ import { queryClient } from "@/components/query-client-provider";
 import { Checkbox } from "@/components/ui/checkbox";
 import Empty from "./empty";
 import { NetworkActor } from "./network-actor";
+import {
+  normalizeV2UploadSources,
+  type StudioUploadSource,
+  type V2UploadResponse,
+} from "@/core/studio/document-upload";
 
 // ── 适配层 ─────────────────────────────────────────────────
 
@@ -86,22 +91,7 @@ interface DocumentUploadDialogContextType {
     data?: { query: string; mode: string }
   ) => Promise<void>;
   // 上传成功回调，返回上传的来源信息
-  onUploadComplete?: (sources: Array<{ id?: number; title: string; task_id?: string; status: string }>) => void;
+  onUploadComplete?: (sources: StudioUploadSource[]) => void;
-}
-
-// ── 任务轮询类型 ─────────────────────────────────────────────
-interface TaskSource {
-  task_id: string;
-  title: string;
-  status: 'processing' | 'success' | 'error';
-  source_type: string;
-}
-
-interface UploadResponse {
-  status: string;
-  uploaded: number;
-  skipped: number;
-  sources: TaskSource[];
 }
 
 interface listDataItem {
@@ -224,7 +214,7 @@ export const DocumentUploadDialogProvider: FC<{
   ) => void | Promise<void>;
   searchSpace: { id: number | string;[key: string]: unknown };
   onUploadSuccess?: () => void;
-  onUploadComplete?: (sources: Array<{ id?: number; title: string; task_id?: string; status: string }>) => void;
+  onUploadComplete?: (sources: StudioUploadSource[]) => void;
 }> = ({ children, onClose, searchSpace, onUploadSuccess, onUploadComplete }) => {
   const [isOpen, setIsOpen] = useState(false);
   const [initialSearchText, setInitialSearchText] = useState("");
@@ -353,27 +343,23 @@ const DocumentUploadPopupContent: FC<{
       for (const file of files) {
         formData.append("files", file);
       }
-      const res = await fetch(`${backendUrl}/api/v1/documents/fileupload`, {
+      const res = await fetch(`${backendUrl}/api/v1/documents/fileupload-v2`, {
         method: "POST",
         headers: { Authorization: `Bearer ${token}` },
         body: formData,
       });
       if (res.ok) {
-        const data = await res.json() as UploadResponse;
+        const data = await res.json() as V2UploadResponse;
         // 调用上传完成回调，传递来源信息
         if (data.sources && data.sources.length > 0) {
-          onUploadComplete?.(data.sources.map(s => ({
+          onUploadComplete?.(normalizeV2UploadSources(data));
-            id: undefined, // 后端返回的数据中暂时没有 id
-            title: s.title,
-            task_id: s.task_id,
-            status: s.status,
-          })));
         }
         toast.success(`上传成功 ${data.uploaded || files.length} 个文件`);
         // 只关闭上传弹窗
         onOpenChange(false);
       } else {
-        toast.error("上传失败，请重试");
+        const payload = await res.json().catch(() => null) as { detail?: string } | null;
+        toast.error(payload?.detail || `上传失败（HTTP ${res.status}）`);
       }
     } catch {
       toast.error("上传失败，请重试");
@@ -410,7 +396,6 @@ const DocumentUploadPopupContent: FC<{
           selectedSearchSources.map((s) => ({
             id: undefined,
             title: s.title,
-            task_id: undefined,
             status: "success" as const,
           }))
         );

frontend-web/src/components/font-scale.tsx

@@ -1,14 +1,19 @@
 "use client";
 
-import { useEffect } from "react";
+import { useLayoutEffect } from "react";
 
 import { useLocalSettings } from "@/core/settings";
+import {
+  applyFontScaleToDocument,
+  normalizeFontScale,
+  normalizeFontScaleMode,
+} from "@/core/ui/page-zoom";
 
 /**
  * 基准字号 = 16px，对应《深蓝色 UI 规范》§2.1.2 后台系统正文字号（16px Regular）。
- * 用户在「外观 → 字号」里选择的倍数通过 CSS 变量 `--ui-font-scale` 生效：globals.css
+ * 「仅文字」把倍数写到 `--ui-font-scale`，只放大 Tailwind 字号 token 和正文继承字号。
- * 只把 Tailwind 的 `--text-*` 字号 token 乘以该倍数，**不动间距 token**，所以放大 / 缩小
+ * 「整页缩放」改在 `<html>` 上设置 CSS zoom，写死的 px 字号、间距和图标一起变；
- * 的只有文字本身，padding / margin / 宽高等布局尺寸保持不变，不会把页面挤错位。
+ * 此时 `--ui-font-scale` 固定为 1，避免和 zoom 叠乘。
  * `fontScale === 1` 即默认 16px。
  */
 export const BASE_FONT_PX = 16;
@@ -21,25 +26,36 @@ export const FONT_SCALE_OPTIONS: { value: number; label: string; px: number }[]
     { value: 1.25, label: "特大", px: 20 },
   ];
 
+export const FONT_SCALE_MODE_OPTIONS: {
+  value: "text" | "page";
+  label: string;
+  description: string;
+}[] = [
+  {
+    value: "text",
+    label: "仅文字",
+    description: "只放大文字，间距和布局保持原样。",
+  },
+  {
+    value: "page",
+    label: "整页缩放",
+    description: "文字、间距、图标和写死的像素一起放大。",
+  },
+];
+
 /**
- * 把用户选择的字号倍数写到 <html> 的 `--ui-font-scale` CSS 变量。挂在应用根部，
+ * 把字号设置写到文档根节点。挂在应用根部，刷新后、绘制前生效。不渲染任何 DOM。
- * 保证刷新后即时生效、全局统一。只设变量、不直接改 font-size，因此布局不受影响。
- * 不渲染任何 DOM。
  */
 export function FontScaleApplier() {
   const [settings] = useLocalSettings();
-  const { fontScale } = settings.display;
+  const { fontScale, fontScaleMode } = settings.display;
 
-  useEffect(() => {
+  useLayoutEffect(() => {
-    const scale =
+    applyFontScaleToDocument(
-      typeof fontScale === "number" && Number.isFinite(fontScale) && fontScale > 0
+      normalizeFontScaleMode(fontScaleMode),
-        ? fontScale
+      normalizeFontScale(fontScale),
-        : 1;
+    );
-    const root = document.documentElement;
+  }, [fontScale, fontScaleMode]);
-    root.style.setProperty("--ui-font-scale", String(scale));
-    // 清掉旧实现可能残留的根级 font-size 内联样式（旧版用它做整页缩放）。
-    root.style.removeProperty("font-size");
-  }, [fontScale]);
 
   return null;
 }

frontend-web/src/components/html-preview-frame.tsx

@@ -9,8 +9,8 @@ import { prepareGeneratedHtml } from "@/core/utils/legacy-html-preview";
  * is `about:srcdoc`, so clicking an in-page anchor (`<a href="#section">`)
  * navigates the frame to `about:blank#section` and BLANKS it. A `blob:` URL is
  * a real document URL, so fragment links scroll within the frame as expected —
- * all without enabling scripts (the sandbox stays script-free for security; the
+ * The sandbox permits scripts so the preview can use the app-bundled HTML
- * server already sanitizes script vectors and this is defense-in-depth).
+ * visualization runtimes, while still withholding same-origin privileges.
  *
  * The `charset=utf-8` on the blob type is required: a blob: URL whose
  * Content-Type omits the charset is decoded with the OS default (GBK/Latin-1 on
@@ -26,7 +26,9 @@ export function HtmlPreviewFrame({
   const [url, setUrl] = useState<string>();
 
   useEffect(() => {
-    const blob = new Blob([prepareGeneratedHtml(html ?? "")], {
+    const blob = new Blob([
+      prepareGeneratedHtml(html ?? ""),
+    ], {
       type: "text/html;charset=utf-8",
     });
     const objectUrl = URL.createObjectURL(blob);

frontend-web/src/components/knowledge-graph/GraphTooltip.tsx

@@ -1,3 +1,5 @@
+import { toCssPx } from "@/core/ui/page-zoom";
+
 import type { TooltipState } from "./graphTypes";
 import { getNodeTitle, NODE_KIND_META } from "./graphUtils";
 
@@ -9,8 +11,8 @@ export function GraphTooltip({ tooltip }: GraphTooltipProps) {
   if (!tooltip) return null;
   const meta = NODE_KIND_META[tooltip.kind];
   // Keep the tooltip inside the viewport.
-  const left = Math.min(tooltip.x + 14, window.innerWidth - 336);
+  const left = Math.min(toCssPx(tooltip.x) + 14, window.innerWidth - 336);
-  const top = Math.min(tooltip.y + 14, window.innerHeight - 120);
+  const top = Math.min(toCssPx(tooltip.y) + 14, window.innerHeight - 120);
 
   return (
     <div className="kg-tooltip" style={{ left, top }}>

frontend-web/src/components/landing/hero.tsx

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

frontend-web/src/components/page-sdebar.css

@@ -4,19 +4,19 @@
     top: 4rem;
     z-index: 40;
     width: 98px;
-    height: calc(100vh - 4rem);
+    height: calc(100vh / var(--df-page-zoom, 1) - 4rem);
     flex-shrink: 0;
 }
 
 /* `?hideHeader=1`: keep the menu rail, but let it occupy the Header's space. */
 .sidebar-contnet--header-hidden {
     top: 0;
-    height: 100vh;
+    height: calc(100vh / var(--df-page-zoom, 1));
 }
 
 .sidebar-contnet--header-hidden .item-nav-content {
-    height: calc(100vh - 20px);
+    height: calc(100vh / var(--df-page-zoom, 1) - 20px);
-    min-height: calc(100vh - 20px);
+    min-height: calc(100vh / var(--df-page-zoom, 1) - 20px);
 }
 
 .sidebar-contents {
@@ -160,8 +160,8 @@
 
 .item-nav-content {
     width: 155px;
-    height: calc(100vh - 4rem - 20px);
+    height: calc(100vh / var(--df-page-zoom, 1) - 4rem - 20px);
-    min-height: calc(100vh - 4rem - 20px);
+    min-height: calc(100vh / var(--df-page-zoom, 1) - 4rem - 20px);
     background: rgba(3, 38, 80, 0.8);
     border: 1px solid;
     border-color: rgba(43, 143, 254, 0.6);
@@ -634,7 +634,7 @@ html[data-custom-theme="true"] .light-topnav-item--active::after {
     top: 4rem;
     z-index: 40;
     width: 96px;
-    height: calc(100vh - 4rem);
+    height: calc(100vh / var(--df-page-zoom, 1) - 4rem);
     display: flex;
     flex-direction: row;
     background: #ffffff;
@@ -653,7 +653,7 @@ html[data-custom-theme="true"] .light-topnav-item--active::after {
 /* `?hideHeader=1`: preserve the light sidebar while removing only Header. */
 .light-sidebar--header-hidden {
     top: 0;
-    height: 100vh;
+    height: calc(100vh / var(--df-page-zoom, 1));
 }
 
 /* 二级列：固定 96px，竖排图标卡片 + 底部设置 */

frontend-web/src/components/page-sidebar-v1.tsx

@@ -194,7 +194,7 @@ export function PageSidebar({
         onOpenChange={setNotificationOpen}
       />
       <aside
-        className={`fixed left-0 top-16 z-40 flex h-[calc(100vh-4rem)] flex-col overflow-hidden shadow-sm theme-transition transition-all duration-300 ${
+        className={`fixed left-0 top-16 z-40 flex h-[calc(100vh/var(--df-page-zoom,1)-4rem)] flex-col overflow-hidden shadow-sm theme-transition transition-all duration-300 ${
           isDark
             ? "border-r border-blue-800/30 bg-slate-900"
             : "border-r border-red-100 bg-white"

frontend-web/src/components/page-sidebar.tsx

@@ -16,6 +16,8 @@ import {
   Settings,
   ShieldAlert,
   ShieldCheck,
+  ScrollText,
+  Timer,
   User,
   Wrench,
 } from "lucide-react";
@@ -56,7 +58,7 @@ type PageSidebarProps = {
   headerHidden?: boolean;
 };
 
-type SettingsSection = "account" | "appearance" | "memory" | "tools" | "about";
+type SettingsSection = "account" | "appearance" | "memory" | "tools" | "encoder" | "about";
 
 const hasActiveChild = (item: MenuItem, pathname: string): boolean =>
   menuItemContainsPath(item, pathname);
@@ -222,14 +224,12 @@ function SecondaryNavSidebar({ headerHidden }: { headerHidden: boolean }) {
                     <User className="size-4" />
                     个人信息
                   </DropdownMenuItem>
-                  {isAdmin && (
+                  <DropdownMenuItem
-                    <DropdownMenuItem
+                    onClick={() => navigate("/page/strategy/admin/menu-management")}
-                      onClick={() => navigate("/page/strategy/admin/menu-management")}
+                  >
-                    >
+                    <ListTree className="size-4" />
-                      <ListTree className="size-4" />
+                    {isAdmin ? "默认菜单管理" : "我的菜单"}
-                      菜单管理
+                  </DropdownMenuItem>
-                    </DropdownMenuItem>
-                  )}
                   {isAdmin && (
                     <DropdownMenuItem
                       onClick={() => navigate("/page/strategy/admin/task-buttons")}
@@ -270,6 +270,28 @@ function SecondaryNavSidebar({ headerHidden }: { headerHidden: boolean }) {
                       模型配置
                     </DropdownMenuItem>
                   )}
+                  {isAdmin && (
+                    <DropdownMenuItem
+                      onClick={() => navigate("/page/workspace/admin/skill-timing")}
+                    >
+                      <Timer className="size-4" />
+                      技能耗时排查
+                    </DropdownMenuItem>
+                  )}
+                  {isAdmin && (
+                    <DropdownMenuItem
+                      onClick={() => navigate("/page/workspace/admin/model-exchanges")}
+                    >
+                      <ScrollText className="size-4" />
+                      模型收发记录
+                    </DropdownMenuItem>
+                  )}
+                  {isAdmin && (
+                    <DropdownMenuItem onClick={() => openSettings("encoder")}>
+                      <Cpu className="size-4" />
+                      本地编码器
+                    </DropdownMenuItem>
+                  )}
                   {isAdmin && (
                     <DropdownMenuItem
                       onClick={() => navigate("/page/strategy/settings/model-concurrency")}
@@ -478,7 +500,9 @@ function LegacyAccordionSidebar({
       />
       <aside
         className={`fixed left-0 z-40 flex flex-col overflow-hidden shadow-sm theme-transition transition-all duration-300 ${
-          headerHidden ? "top-0 h-screen" : "top-16 h-[calc(100vh-4rem)]"
+          headerHidden
+            ? "top-0 h-[calc(100vh/var(--df-page-zoom,1))]"
+            : "top-16 h-[calc(100vh/var(--df-page-zoom,1)-4rem)]"
         } ${
           isDark
             ? "border-r border-blue-800/30 bg-slate-900"
@@ -555,12 +579,10 @@ function LegacyAccordionSidebar({
                 <User className="size-4" />
                 个人信息
               </DropdownMenuItem>
-              {isAdmin && (
+              <DropdownMenuItem onClick={() => navigate("/page/strategy/admin/menu-management")}>
-                <DropdownMenuItem onClick={() => navigate("/page/strategy/admin/menu-management")}>
+                <ListTree className="size-4" />
-                  <ListTree className="size-4" />
+                {isAdmin ? "默认菜单管理" : "我的菜单"}
-                  菜单管理
+              </DropdownMenuItem>
-                </DropdownMenuItem>
-              )}
               {isAdmin && (
                 <DropdownMenuItem onClick={() => navigate("/page/strategy/admin/task-buttons")}>
                   <MousePointerClick className="size-4" />
@@ -585,6 +607,28 @@ function LegacyAccordionSidebar({
                   模型配置
                 </DropdownMenuItem>
               )}
+              {isAdmin && (
+                <DropdownMenuItem
+                  onClick={() => navigate("/page/workspace/admin/skill-timing")}
+                >
+                  <Timer className="size-4" />
+                  技能耗时排查
+                </DropdownMenuItem>
+              )}
+              {isAdmin && (
+                <DropdownMenuItem
+                  onClick={() => navigate("/page/workspace/admin/model-exchanges")}
+                >
+                  <ScrollText className="size-4" />
+                  模型收发记录
+                </DropdownMenuItem>
+              )}
+              {isAdmin && (
+                <DropdownMenuItem onClick={() => openSettings("encoder")}>
+                  <Cpu className="size-4" />
+                  本地编码器
+                </DropdownMenuItem>
+              )}
               {isAdmin && (
                 <DropdownMenuItem onClick={() => navigate("/page/strategy/admin/login-whitelist")}>
                   <ShieldCheck className="size-4" />

frontend-web/src/components/react-ui-error-boundary.browser-check.tsx

@@ -0,0 +1,54 @@
+import { useLayoutEffect, useState } from "react";
+import { createRoot } from "react-dom/client";
+
+import { ReactUiErrorBoundary } from "./react-ui-error-boundary";
+
+// Offline browser QA: real React production render/commit recursion, not a
+// fabricated #185 thrown by a unit-test stub. A manual button click reloads
+// this same page without submitting any conversation or model request.
+const key = "deerflow.boundary-browser-check";
+let mounts = 0;
+function InfiniteCommitLoop() {
+  const [, update] = useState(0);
+  useState(() => { mounts += 1; return 0; });
+  useLayoutEffect(() => { update((value) => value + 1); });
+  return <div>Loop fixture</div>;
+}
+
+function result(passed: boolean, details: Record<string, unknown>) {
+  const output = document.createElement("pre");
+  output.id = "boundary-check-result";
+  output.textContent = JSON.stringify({ passed, ...details });
+  document.body.append(output);
+}
+
+const resumed = sessionStorage.getItem(key) === "manual-reload";
+createRoot(document.getElementById("root")!).render(
+  <ReactUiErrorBoundary>
+    {resumed ? <div id="healthy">Existing page restored</div> : <InfiniteCommitLoop />}
+  </ReactUiErrorBoundary>,
+);
+
+if (resumed) {
+  sessionStorage.removeItem(key);
+  window.setTimeout(() => result(Boolean(document.getElementById("healthy")), {
+    phase: "manual-reload-restored", renderLoopCaught: true, noAutomaticRemount: true,
+  }), 100);
+} else {
+  window.setTimeout(() => {
+    const alert = document.querySelector('[role="alert"]');
+    const before = mounts;
+    if (!alert || /#185|react\.dev|Maximum update depth/.test(alert.textContent ?? "")) {
+      result(false, { phase: "friendly-fallback", hasAlert: Boolean(alert) });
+      return;
+    }
+    window.setTimeout(() => {
+      if (mounts !== before || before !== 1) {
+        result(false, { phase: "unexpected-automatic-remount", mounts, before });
+        return;
+      }
+      sessionStorage.setItem(key, "manual-reload");
+      (alert.querySelector("button") as HTMLButtonElement).click();
+    }, 250);
+  }, 100);
+}

frontend-web/src/components/react-ui-error-boundary.tsx

@@ -0,0 +1,45 @@
+import { Component, type ErrorInfo, type ReactNode } from "react";
+
+import { isReactMaximumUpdateDepthError } from "@/core/threads/stream-error-classification";
+import { REACT_UI_ERROR_MESSAGE } from "@/core/threads/react-ui-error";
+
+/** Last-resort render/commit guard. It deliberately never auto-remounts a broken
+ * tree, which could otherwise repeatedly resume the same run and crash again. */
+export class ReactUiErrorBoundary extends Component<
+  { children: ReactNode },
+  { failed: boolean }
+> {
+  state = { failed: false };
+
+  static getDerivedStateFromError(error: unknown) {
+    if (!isReactMaximumUpdateDepthError(error)) throw error;
+    return { failed: true };
+  }
+
+  componentDidCatch(_error: unknown, info: ErrorInfo) {
+    console.warn("[deer-flow] react_ui_render_error", {
+      errorType: "react_maximum_update_depth",
+      componentStack: info.componentStack,
+      recovery: "manual_reload",
+    });
+  }
+
+  render() {
+    if (!this.state.failed) return this.props.children;
+    return (
+      <main className="flex min-h-screen items-center justify-center p-6">
+        <section role="alert" className="max-w-lg rounded-lg border p-6 text-center">
+          <h1 className="mb-3 text-lg font-medium">页面暂时无法显示</h1>
+          <p className="mb-5 text-sm text-muted-foreground">{REACT_UI_ERROR_MESSAGE}</p>
+          <button
+            className="rounded-md bg-primary px-4 py-2 text-primary-foreground"
+            onClick={() => window.location.reload()}
+            type="button"
+          >
+            重新载入页面
+          </button>
+        </section>
+      </main>
+    );
+  }
+}

frontend-web/src/components/route-loading.tsx

@@ -0,0 +1,16 @@
+/** Lightweight, dependency-free fallback used while a route chunk loads. */
+export function RouteLoadingFallback() {
+  return (
+    <div
+      className="text-muted-foreground flex size-full min-h-32 items-center justify-center gap-2 bg-background"
+      role="status"
+      aria-live="polite"
+    >
+      <span
+        className="border-muted-foreground/30 border-t-foreground size-4 animate-spin rounded-full border-2"
+        aria-hidden="true"
+      />
+      <span className="text-sm">正在加载页面…</span>
+    </div>
+  );
+}

frontend-web/src/components/ui/dialog.tsx

@@ -61,7 +61,7 @@ const DialogOverlay = React.forwardRef<
       ref={ref}
       data-slot="dialog-overlay"
       className={cn(
-        "data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 fixed inset-0 z-50 bg-black/50",
+        "legacy-dialog-overlay data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 fixed inset-0 z-[200] bg-black/50",
         className,
       )}
       {...props}
@@ -71,37 +71,42 @@ const DialogOverlay = React.forwardRef<
 
 DialogOverlay.displayName = DialogPrimitive.Overlay.displayName;
 
-const DialogContent = React.forwardRef<
+const DialogContent = React.forwardRef<
-  React.ElementRef<typeof DialogPrimitive.Content>,
+  React.ElementRef<typeof DialogPrimitive.Content>,
-  React.ComponentPropsWithoutRef<typeof DialogPrimitive.Content> & {
+  React.ComponentPropsWithoutRef<typeof DialogPrimitive.Content> & {
-    showCloseButton?: boolean;
+    showCloseButton?: boolean;
-    /** Use when this dialog is opened from a higher-layer surface such as a Drawer. */
+    /** Use when this dialog is opened from a higher-layer surface such as a Drawer. */
-    overlayClassName?: string;
+    overlayClassName?: string;
-  }
+  }
->(({ className, children, showCloseButton = true, overlayClassName, ...props }, ref) => {
+>(({ className, children, showCloseButton = true, overlayClassName, ...props }, ref) => {
-  return (
+  return (
-    <DialogPortal data-slot="dialog-portal">
+    <DialogPortal data-slot="dialog-portal">
-      <DialogOverlay className={overlayClassName} />
+      <DialogOverlay className={overlayClassName} />
-      <DialogPrimitive.Content
+      <div
-        ref={ref}
+        data-slot="dialog-viewport"
-        data-slot="dialog-content"
+        className={cn("legacy-dialog-viewport", overlayClassName)}
-        className={cn(
-          "bg-background data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 fixed top-[50%] left-[50%] z-50 grid w-full max-w-[calc(100%-2rem)] translate-x-[-50%] translate-y-[-50%] gap-4 rounded-lg border p-6 shadow-lg duration-200 outline-none sm:max-w-lg",
-          className,
-        )}
-        {...props}
       >
-        {children}
+        <DialogPrimitive.Content
-        {showCloseButton && (
+          ref={ref}
-          <DialogPrimitive.Close
+          data-slot="dialog-content"
-            data-slot="dialog-close"
+          className={cn(
-            className="ring-offset-background focus:ring-ring data-[state=open]:bg-accent data-[state=open]:text-muted-foreground absolute top-4 right-4 rounded-xs opacity-70 transition-opacity hover:opacity-100 focus:ring-2 focus:ring-offset-2 focus:outline-hidden disabled:pointer-events-none [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4"
+            "bg-background data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 relative z-[200] grid min-h-0 max-h-full w-full max-w-[calc(100%-2rem)] pointer-events-auto gap-4 rounded-lg border p-6 shadow-lg duration-200 outline-none sm:max-w-lg",
-          >
+            className,
-            <XIcon />
+          )}
-            <span className="sr-only">Close</span>
+          {...props}
-          </DialogPrimitive.Close>
+        >
-        )}
+          {children}
-      </DialogPrimitive.Content>
+          {showCloseButton && (
+            <DialogPrimitive.Close
+              data-slot="dialog-close"
+              className="ring-offset-background focus:ring-ring data-[state=open]:bg-accent data-[state=open]:text-muted-foreground absolute top-4 right-4 rounded-xs opacity-70 transition-opacity hover:opacity-100 focus:ring-2 focus:ring-offset-2 focus:outline-hidden disabled:pointer-events-none [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4"
+            >
+              <XIcon />
+              <span className="sr-only">Close</span>
+            </DialogPrimitive.Close>
+          )}
+        </DialogPrimitive.Content>
+      </div>
     </DialogPortal>
   );
 });

frontend-web/src/components/ui/dropdown-menu.tsx

@@ -20,42 +20,42 @@ function DropdownMenuPortal({
   );
 }
 
-const DropdownMenuTrigger = React.forwardRef<
+const DropdownMenuTrigger = React.forwardRef<
-  React.ElementRef<typeof DropdownMenuPrimitive.Trigger>,
+  React.ElementRef<typeof DropdownMenuPrimitive.Trigger>,
-  React.ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Trigger>
+  React.ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Trigger>
->(({ ...props }, ref) => {
+>(({ ...props }, ref) => {
-  return (
+  return (
-    <DropdownMenuPrimitive.Trigger
+    <DropdownMenuPrimitive.Trigger
-      ref={ref}
+      ref={ref}
-      data-slot="dropdown-menu-trigger"
+      data-slot="dropdown-menu-trigger"
-      {...props}
+      {...props}
-    />
+    />
-  );
+  );
-});
+});
-
-DropdownMenuTrigger.displayName = DropdownMenuPrimitive.Trigger.displayName;
 
-const DropdownMenuContent = React.forwardRef<
+DropdownMenuTrigger.displayName = DropdownMenuPrimitive.Trigger.displayName;
-  React.ElementRef<typeof DropdownMenuPrimitive.Content>,
+
-  React.ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Content>
+const DropdownMenuContent = React.forwardRef<
->(({ className, sideOffset = 4, ...props }, ref) => {
+  React.ElementRef<typeof DropdownMenuPrimitive.Content>,
-  return (
+  React.ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Content>
-    <DropdownMenuPrimitive.Portal>
+>(({ className, sideOffset = 4, ...props }, ref) => {
-      <DropdownMenuPrimitive.Content
+  return (
-        ref={ref}
+    <DropdownMenuPrimitive.Portal>
-        data-slot="dropdown-menu-content"
+      <DropdownMenuPrimitive.Content
-        sideOffset={sideOffset}
+        ref={ref}
-        className={cn(
+        data-slot="dropdown-menu-content"
-          "bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 max-h-(--radix-dropdown-menu-content-available-height) min-w-[8rem] origin-(--radix-dropdown-menu-content-transform-origin) overflow-x-hidden overflow-y-auto rounded-md border p-1 shadow-md",
+        sideOffset={sideOffset}
-          className,
+        className={cn(
-        )}
+          "legacy-floating-layer bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 max-h-(--radix-dropdown-menu-content-available-height) min-w-[8rem] origin-(--radix-dropdown-menu-content-transform-origin) overflow-x-hidden overflow-y-auto rounded-md border p-1 shadow-md",
-        {...props}
+          className,
-      />
+        )}
-    </DropdownMenuPrimitive.Portal>
+        {...props}
-  );
+      />
-});
+    </DropdownMenuPrimitive.Portal>
-
+  );
-DropdownMenuContent.displayName = DropdownMenuPrimitive.Content.displayName;
+});
+
+DropdownMenuContent.displayName = DropdownMenuPrimitive.Content.displayName;
 
 function DropdownMenuGroup({
   ...props
@@ -65,29 +65,29 @@ function DropdownMenuGroup({
   );
 }
 
-const DropdownMenuItem = React.forwardRef<
+const DropdownMenuItem = React.forwardRef<
-  React.ElementRef<typeof DropdownMenuPrimitive.Item>,
+  React.ElementRef<typeof DropdownMenuPrimitive.Item>,
-  React.ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Item> & {
+  React.ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Item> & {
-    inset?: boolean;
+    inset?: boolean;
-    variant?: "default" | "destructive";
+    variant?: "default" | "destructive";
-  }
+  }
->(({ className, inset, variant = "default", ...props }, ref) => {
+>(({ className, inset, variant = "default", ...props }, ref) => {
-  return (
+  return (
-    <DropdownMenuPrimitive.Item
+    <DropdownMenuPrimitive.Item
-      ref={ref}
+      ref={ref}
-      data-slot="dropdown-menu-item"
+      data-slot="dropdown-menu-item"
-      data-inset={inset}
+      data-inset={inset}
-      data-variant={variant}
+      data-variant={variant}
-      className={cn(
+      className={cn(
-        "focus:bg-accent focus:text-accent-foreground data-[variant=destructive]:text-destructive data-[variant=destructive]:focus:bg-destructive/10 dark:data-[variant=destructive]:focus:bg-destructive/20 data-[variant=destructive]:focus:text-destructive data-[variant=destructive]:*:[svg]:!text-destructive [&_svg:not([class*='text-'])]:text-muted-foreground relative flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-hidden select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50 data-[inset]:pl-8 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        "focus:bg-accent focus:text-accent-foreground data-[variant=destructive]:text-destructive data-[variant=destructive]:focus:bg-destructive/10 dark:data-[variant=destructive]:focus:bg-destructive/20 data-[variant=destructive]:focus:text-destructive data-[variant=destructive]:*:[svg]:!text-destructive [&_svg:not([class*='text-'])]:text-muted-foreground relative flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-hidden select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50 data-[inset]:pl-8 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
-        className,
+        className,
-      )}
+      )}
-      {...props}
+      {...props}
-    />
+    />
-  );
+  );
-});
+});
-
+
-DropdownMenuItem.displayName = DropdownMenuPrimitive.Item.displayName;
+DropdownMenuItem.displayName = DropdownMenuPrimitive.Item.displayName;
 
 function DropdownMenuCheckboxItem({
   className,
@@ -205,51 +205,51 @@ function DropdownMenuSub({
   return <DropdownMenuPrimitive.Sub data-slot="dropdown-menu-sub" {...props} />;
 }
 
-const DropdownMenuSubTrigger = React.forwardRef<
+const DropdownMenuSubTrigger = React.forwardRef<
-  React.ElementRef<typeof DropdownMenuPrimitive.SubTrigger>,
+  React.ElementRef<typeof DropdownMenuPrimitive.SubTrigger>,
-  React.ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.SubTrigger> & {
+  React.ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.SubTrigger> & {
-    inset?: boolean;
+    inset?: boolean;
-  }
+  }
->(({ className, inset, children, ...props }, ref) => {
+>(({ className, inset, children, ...props }, ref) => {
-  return (
+  return (
-    <DropdownMenuPrimitive.SubTrigger
+    <DropdownMenuPrimitive.SubTrigger
-      ref={ref}
+      ref={ref}
-      data-slot="dropdown-menu-sub-trigger"
+      data-slot="dropdown-menu-sub-trigger"
-      data-inset={inset}
+      data-inset={inset}
-      className={cn(
+      className={cn(
-        "focus:bg-accent focus:text-accent-foreground data-[state=open]:bg-accent data-[state=open]:text-accent-foreground [&_svg:not([class*='text-'])]:text-muted-foreground flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-hidden select-none data-[inset]:pl-8 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        "focus:bg-accent focus:text-accent-foreground data-[state=open]:bg-accent data-[state=open]:text-accent-foreground [&_svg:not([class*='text-'])]:text-muted-foreground flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-hidden select-none data-[inset]:pl-8 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
-        className,
+        className,
-      )}
+      )}
-      {...props}
+      {...props}
-    >
+    >
-      {children}
+      {children}
-      <ChevronRightIcon className="ml-auto size-4" />
+      <ChevronRightIcon className="ml-auto size-4" />
-    </DropdownMenuPrimitive.SubTrigger>
+    </DropdownMenuPrimitive.SubTrigger>
-  );
+  );
-});
+});
-
-DropdownMenuSubTrigger.displayName =
-  DropdownMenuPrimitive.SubTrigger.displayName;
 
-const DropdownMenuSubContent = React.forwardRef<
+DropdownMenuSubTrigger.displayName =
-  React.ElementRef<typeof DropdownMenuPrimitive.SubContent>,
+  DropdownMenuPrimitive.SubTrigger.displayName;
-  React.ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.SubContent>
+
->(({ className, ...props }, ref) => {
+const DropdownMenuSubContent = React.forwardRef<
-  return (
+  React.ElementRef<typeof DropdownMenuPrimitive.SubContent>,
-    <DropdownMenuPrimitive.SubContent
+  React.ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.SubContent>
-      ref={ref}
+>(({ className, ...props }, ref) => {
-      data-slot="dropdown-menu-sub-content"
+  return (
-      className={cn(
+    <DropdownMenuPrimitive.SubContent
-        "bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 min-w-[8rem] origin-(--radix-dropdown-menu-content-transform-origin) overflow-hidden rounded-md border p-1 shadow-lg",
+      ref={ref}
-        className,
+      data-slot="dropdown-menu-sub-content"
-      )}
+      className={cn(
-      {...props}
+        "legacy-floating-layer bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 min-w-[8rem] origin-(--radix-dropdown-menu-content-transform-origin) overflow-hidden rounded-md border p-1 shadow-lg",
-    />
+        className,
-  );
+      )}
-});
+      {...props}
-
+    />
-DropdownMenuSubContent.displayName =
+  );
-  DropdownMenuPrimitive.SubContent.displayName;
+});
+
+DropdownMenuSubContent.displayName =
+  DropdownMenuPrimitive.SubContent.displayName;
 
 export {
   DropdownMenu,

frontend-web/src/components/ui/select.tsx

@@ -62,7 +62,7 @@ const SelectContent = React.forwardRef<
         ref={ref}
         data-slot="select-content"
         className={cn(
-          "bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 relative z-50 max-h-(--radix-select-content-available-height) min-w-[8rem] origin-(--radix-select-content-transform-origin) overflow-x-hidden overflow-y-auto rounded-md border shadow-md dark:border-[#1B477E] dark:bg-[#022248] dark:text-[#AACEFF]",
+          "legacy-floating-layer bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 relative z-50 max-h-(--radix-select-content-available-height) min-w-[8rem] origin-(--radix-select-content-transform-origin) overflow-x-hidden overflow-y-auto rounded-md border shadow-md dark:border-[#1B477E] dark:bg-[#022248] dark:text-[#AACEFF]",
           position === "popper" &&
             "data-[side=bottom]:translate-y-1 data-[side=left]:-translate-x-1 data-[side=right]:translate-x-1 data-[side=top]:-translate-y-1",
           className,

frontend-web/src/components/wiki/Breadcrumb.tsx

@@ -1,5 +1,4 @@
 import { ChevronRight } from "lucide-react";
-import { Fragment } from "react";
 
 import { cn } from "@/lib/utils";
 
@@ -21,12 +20,12 @@ export function Breadcrumb({
       )}
     >
       {segments.map((segment, i) => (
-        <Fragment key={`${segment}-${i}`}>
+        <div className="contents" key={`${segment}-${i}`}>
           <span className="hidden shrink-0 whitespace-nowrap sm:inline">
             {segment}
           </span>
           <ChevronRight className="hidden size-3 shrink-0 text-slate-300 sm:inline dark:text-slate-600" />
-        </Fragment>
+        </div>
       ))}
       <span
         className="truncate text-[13px] font-medium text-slate-600 dark:text-slate-300"

frontend-web/src/components/workspace/admin/user-management-page.tsx

@@ -1,8 +1,10 @@
 "use client";
 
 import { Loader2 } from "lucide-react";
+import { Link } from "react-router-dom";
 
 import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
 import { SettingsSection } from "@/components/workspace/settings/settings-section";
 import { useAllUsers } from "@/core/auth/hooks";
 import { useI18n } from "@/core/i18n/hooks";
@@ -17,6 +19,11 @@ export function UserManagementPage() {
         title={t.adminUsers.title}
         description={t.adminUsers.description}
       >
+        <div className="mb-4 flex justify-end">
+          <Button variant="outline" asChild>
+            <Link to="/page/strategy/admin/login-whitelist">管理密码与登录口令</Link>
+          </Button>
+        </div>
         {isLoading && (
           <div className="flex items-center gap-2 text-muted-foreground py-8 justify-center">
             <Loader2 className="h-4 w-4 animate-spin" />

frontend-web/src/components/workspace/agents/agent-card.tsx

@@ -534,11 +534,6 @@ export function AgentCard({ agent, layout = "card", onPublisherClick }: AgentCar
     }
   }
 
-  const enabledSkills = useMemo(
-    () => skills.filter((skill) => skill.enabled),
-    [skills],
-  );
-
   // Status badges (内置 / 我的 / 来自他人 / 已发布 / 私密 / 首页推荐) — shared by
   // both the card header and the compact list row.
   const statusBadges = (
@@ -965,9 +960,9 @@ export function AgentCard({ agent, layout = "card", onPublisherClick }: AgentCar
                   已选 {selectedSkills.length} 个
                 </span>
               </div>
-              <SkillTransferSelector
+              <SkillTransferSelector
-                skills={enabledSkills}
+                skills={skills}
-                selected={selectedSkills}
+                selected={selectedSkills}
                 onChange={setSelectedSkills}
                 isLoading={isSkillsLoading}
                 onViewDetail={setDetailSkillName}

frontend-web/src/components/workspace/agents/agent-chat-sidebar.tsx

@@ -51,6 +51,10 @@ import {
   SelectValue,
 } from "@/components/ui/select";
 import { ShareConversationDialog } from "@/components/workspace/thread-share-dialogs";
+import {
+  MyProjectThreadBadge,
+  MyProjectThreadIcon,
+} from "@/components/workspace/my-project-thread-indicator";
 import { useTheme } from "@/contexts/ThemeContext";
 import { useAgentsPaginated } from "@/core/agents";
 import { getAPIClient } from "@/core/api";
@@ -69,6 +73,8 @@ import {
   useToggleThreadPin,
 } from "@/core/threads/hooks";
 import type { AgentThread, AgentThreadState } from "@/core/threads/types";
+import { myProjectConversationInfoOfThread } from "@/core/threads/project-metadata";
+import { useProjectThreadNames } from "@/core/threads/use-project-thread-names";
 import {
   bootstrapResumePath,
   isBootstrapThread,
@@ -379,6 +385,7 @@ function RecentChatsPane({ activeAgentId }: { activeAgentId?: string }) {
     () => sortThreadsPinnedFirst(threads.filter((thread) => !isHiddenFromRecentChats(thread))),
     [threads],
   );
+  const projectThreadNames = useProjectThreadNames(visibleThreads);
 
   const filteredThreads = useMemo(() => {
     const q = query.trim().toLowerCase();
@@ -479,6 +486,10 @@ function RecentChatsPane({ activeAgentId }: { activeAgentId?: string }) {
         ) : (
           filteredThreads.map((thread) => {
             const isBoot = isBootstrapThread(thread);
+            const projectInfo = myProjectConversationInfoOfThread(
+              thread,
+              projectThreadNames,
+            );
             const href = isBoot ? bootstrapResumePath(thread.thread_id) : pathOf(thread);
             const isActive = href === pathname;
             const pinned = isThreadPinned(thread);
@@ -492,6 +503,7 @@ function RecentChatsPane({ activeAgentId }: { activeAgentId?: string }) {
                   href={href}
                   className={cn(
                     "relative flex h-9 min-w-0 flex-1 items-center gap-2 rounded-lg px-2.5 text-[13px] transition-colors",
+                    projectInfo && "h-auto min-h-12 py-1.5",
                     isActive
                       ? "border border-primary/40 bg-primary/5 font-medium text-primary"
                       : "text-muted-foreground hover:bg-accent/60 hover:text-foreground",
@@ -505,6 +517,8 @@ function RecentChatsPane({ activeAgentId }: { activeAgentId?: string }) {
                       )}
                       aria-label="智能体创建会话"
                     />
+                  ) : projectInfo ? (
+                    <MyProjectThreadIcon type={projectInfo.type} />
                   ) : (
                     <MessageSquare
                       className={cn(
@@ -516,8 +530,22 @@ function RecentChatsPane({ activeAgentId }: { activeAgentId?: string }) {
                   {pinned && (
                     <Pin className="text-muted-foreground/70 size-3 shrink-0" />
                   )}
-                  <span className="truncate">
+                  <span
-                    {desensitize(titleOfThread(thread, t.pages.newChat))}
+                    className={cn(
+                      "min-w-0 flex-1",
+                      projectInfo && "flex flex-col items-start gap-0.5",
+                    )}
+                  >
+                    <span className="w-full truncate">
+                      {desensitize(titleOfThread(thread, t.pages.newChat))}
+                    </span>
+                    {projectInfo && (
+                      <MyProjectThreadBadge
+                        className="mr-4 max-w-[calc(100%_-_1rem)]"
+                        projectName={projectInfo.projectName}
+                        type={projectInfo.type}
+                      />
+                    )}
                   </span>
                   {isActive && (
                     <span className="absolute top-1/2 right-1 h-5 w-1 -translate-y-1/2 rounded-full bg-primary" />

frontend-web/src/components/workspace/agents/agent-detail-panel.tsx

@@ -152,6 +152,8 @@ export function AgentDetailPanel({
   positionName,
   skillsIcon,
   skillsTitle,
+  belowSkillsSlot,
+  feedbackScoreSlot,
   showCommonQuestions = false,
   jobResponsibilities,
   panelTitle,
@@ -181,6 +183,10 @@ export function AgentDetailPanel({
   positionName?: string;
   skillsIcon?: ReactNode;
   skillsTitle?: string;
+  /** 渲染在技能列表区块下方的自定义内容（8BF 用它放「产物提交 position」配置）。 */
+  belowSkillsSlot?: ReactNode;
+  /** Optional answer-feedback summary rendered near the agent identity. */
+  feedbackScoreSlot?: ReactNode;
   showCommonQuestions?: boolean;
   /**
    * 业务链席位上配置的岗位职责。传入（含空字符串）时在常用问题上方展示；
@@ -744,6 +750,8 @@ export function AgentDetailPanel({
         )}
       </section>
 
+      {!editing && feedbackScoreSlot}
+
 
       {/* ── 岗位职责（业务链席位配置，只读）────────────────────────────── */}
       {jobResponsibilities !== undefined && (
@@ -905,7 +913,7 @@ export function AgentDetailPanel({
       {/* ── 技能管理 ───────────────────────────────────────────────────── */}
       <Section
         icon={skillsIcon ?? <SparklesIcon className="size-3.5" />}
-        title={skillsTitle ?? `已启用技能 ${skillNamesShown.length} 个`}
+        title={skillsTitle ?? `已配置技能 ${skillNamesShown.length} 个`}
         className="position-roundtable-skills-section"
         extra={
           editing ? (
@@ -940,6 +948,9 @@ export function AgentDetailPanel({
         />
       </Section>
 
+      {/* ── 技能列表下方插槽（8BF 产物提交 position 等）────────────────── */}
+      {belowSkillsSlot}
+
       {/* ── 最近对话（右下角，仅智能体问答页展示，编辑态隐藏）──────────── */}
       {showRecentChats && !editing && <AgentRecentChats agentId={agent.id} />}
     </div>

frontend-web/src/components/workspace/agents/agent-feedback-score-card.tsx

@@ -0,0 +1,213 @@
+"use client";
+
+import { BarChart3Icon, MessageSquareTextIcon } from "lucide-react";
+
+import { cn } from "@/lib/utils";
+import {
+  useAgentFeedbackScore,
+  type AnswerFeedbackReason,
+  type FeedbackDimensionKey,
+} from "@/strategy-components/api/answer-feedback";
+
+const DIMENSIONS: Array<{
+  key: FeedbackDimensionKey;
+  label: string;
+  fallbackWeight: number;
+}> = [
+  { key: "correctness", label: "正确性", fallbackWeight: 30 },
+  { key: "completeness", label: "完整性", fallbackWeight: 20 },
+  { key: "evidence_grounding", label: "证据与依据", fallbackWeight: 20 },
+  { key: "relevance", label: "相关性", fallbackWeight: 15 },
+  { key: "actionability", label: "可操作性", fallbackWeight: 15 },
+];
+
+const REASON_LABELS: Record<AnswerFeedbackReason, string> = {
+  incorrect_or_incomplete: "不正确或不完整",
+  unmet_expectations: "与期望不符",
+  slow_or_problematic: "速度慢或存在问题",
+  style_or_tone: "风格或语气",
+  safety_or_legal: "安全或法律疑虑",
+  other: "其他",
+};
+
+const CONFIDENCE_LABELS = {
+  none: "暂无置信度",
+  low: "低置信度",
+  medium: "中等置信度",
+  high: "高置信度",
+} as const;
+
+function scoreText(value: number | null | undefined) {
+  return typeof value === "number" && Number.isFinite(value)
+    ? value.toFixed(1)
+    : "—";
+}
+
+function percent(value: number | null | undefined) {
+  if (typeof value !== "number" || !Number.isFinite(value)) return null;
+  const normalized = value <= 1 ? value * 100 : value;
+  return Math.max(0, Math.min(100, normalized));
+}
+
+function weightPercent(value: number | undefined, fallback: number) {
+  if (typeof value !== "number" || !Number.isFinite(value)) return fallback;
+  return value <= 1 ? Math.round(value * 100) : Math.round(value);
+}
+
+export function AgentFeedbackScoreCard({ agentId }: { agentId: string }) {
+  const { data, isLoading, isError } = useAgentFeedbackScore(agentId);
+
+  if (isLoading) {
+    return (
+      <section className="bg-card/60 rounded-xl border p-4" aria-label="回答评价加载中">
+        <div className="bg-muted h-4 w-24 animate-pulse rounded" />
+        <div className="bg-muted mt-4 h-12 w-28 animate-pulse rounded-lg" />
+        <div className="mt-4 space-y-2">
+          {DIMENSIONS.map((item) => (
+            <div key={item.key} className="bg-muted h-3 animate-pulse rounded" />
+          ))}
+        </div>
+      </section>
+    );
+  }
+
+  if (isError || !data) {
+    return (
+      <section className="bg-card/60 rounded-xl border p-4">
+        <div className="flex items-center gap-1.5 text-sm font-semibold">
+          <BarChart3Icon className="size-3.5" />
+          回答评价
+        </div>
+        <p className="text-muted-foreground mt-2 text-xs">评价数据暂不可用</p>
+      </section>
+    );
+  }
+
+  const positiveRate = data.sample_count
+    ? (data.positive_count / data.sample_count) * 100
+    : null;
+  const taskSuccessRate = percent(data.task_success_rate);
+  const topReasons = Object.entries(data.reason_breakdown ?? {})
+    .filter((entry): entry is [AnswerFeedbackReason, { count: number; rate: number }] =>
+      Boolean(entry[1]?.count),
+    )
+    .sort((left, right) => right[1].count - left[1].count)
+    .slice(0, 3);
+
+  return (
+    <section className="bg-card/60 rounded-xl border p-4">
+      <div className="flex items-start justify-between gap-3">
+        <div>
+          <h4 className="text-foreground flex items-center gap-1.5 text-sm font-semibold">
+            <BarChart3Icon className="size-3.5" />
+            回答评价
+          </h4>
+          <p className="text-muted-foreground mt-1 text-xs">用户评价分</p>
+        </div>
+        {data.score_band && data.score !== null && (
+          <span className="border-primary/20 bg-primary/5 text-primary rounded-full border px-2 py-1 text-[11px] font-medium">
+            {data.score_band.label}
+          </span>
+        )}
+      </div>
+
+      <div className="mt-3 flex items-end gap-2">
+        {data.score === null ? (
+          <span className="text-muted-foreground text-xl font-semibold">暂无评价</span>
+        ) : (
+          <>
+            <span className="text-3xl font-bold tracking-tight tabular-nums">
+              {scoreText(data.score)}
+            </span>
+            <span className="text-muted-foreground mb-1 text-xs">/ 100</span>
+          </>
+        )}
+      </div>
+
+      <div className="text-muted-foreground mt-2 flex flex-wrap gap-x-3 gap-y-1 text-[11px]">
+        <span>{data.sample_count} 条评价</span>
+        <span>
+          {CONFIDENCE_LABELS[data.confidence_level]}
+          {` ${Math.round(data.confidence * 100)}%`}
+        </span>
+        <span>
+          好评率 {positiveRate === null ? "—" : `${positiveRate.toFixed(0)}%`}
+        </span>
+      </div>
+
+      {data.sample_count > 0 && (
+        <div className="mt-4 space-y-3" aria-label="回答评价维度">
+          {DIMENSIONS.map((item) => {
+            const dimension = data.dimensions[item.key];
+            const value = percent(dimension?.score);
+            return (
+              <div key={item.key}>
+                <div className="mb-1 flex items-center justify-between gap-2 text-xs">
+                  <span className="text-foreground">
+                    {item.label}
+                    <span className="text-muted-foreground ml-1">
+                      {weightPercent(dimension?.weight, item.fallbackWeight)}%
+                    </span>
+                  </span>
+                  <span className="text-muted-foreground tabular-nums">
+                    {value === null ? "—" : value.toFixed(1)}
+                    {dimension?.evidence_count
+                      ? ` · ${dimension.evidence_count} 条依据`
+                      : ""}
+                  </span>
+                </div>
+                <div className="bg-muted h-1.5 overflow-hidden rounded-full">
+                  <div
+                    className={cn(
+                      "h-full rounded-full transition-[width]",
+                      value !== null && value >= 80
+                        ? "bg-emerald-500"
+                        : value !== null && value >= 60
+                          ? "bg-amber-500"
+                          : "bg-rose-500",
+                    )}
+                    style={{ width: `${value ?? 0}%` }}
+                  />
+                </div>
+              </div>
+            );
+          })}
+        </div>
+      )}
+
+      {(data.task_score !== null || taskSuccessRate !== null) && (
+        <div className="bg-muted/50 mt-4 flex items-center justify-between rounded-lg px-3 py-2 text-xs">
+          <span className="flex items-center gap-1.5 font-medium">
+            <MessageSquareTextIcon className="size-3.5" />
+            任务成功与稳定性
+          </span>
+          <span className="text-muted-foreground tabular-nums">
+            {data.task_score !== null && `评分 ${scoreText(data.task_score)}`}
+            {data.task_score !== null && taskSuccessRate !== null && " · "}
+            {taskSuccessRate !== null && `成功率 ${taskSuccessRate.toFixed(0)}%`}
+          </span>
+        </div>
+      )}
+
+      {topReasons.length > 0 && (
+        <div className="mt-4 border-t pt-3">
+          <p className="text-muted-foreground mb-2 text-[11px] font-medium">主要改进反馈</p>
+          <div className="flex flex-wrap gap-1.5">
+            {topReasons.map(([reason, breakdown]) => (
+              <span
+                key={reason}
+                className="bg-muted text-muted-foreground rounded-full px-2 py-1 text-[11px]"
+              >
+                {REASON_LABELS[reason]} · {breakdown.count}
+              </span>
+            ))}
+          </div>
+        </div>
+      )}
+
+      <p className="text-muted-foreground/80 mt-4 border-t pt-3 text-[10px] leading-relaxed">
+        该分数仅反映用户对回答结果的评价，不代表完整任务轨迹、工具调用或技能能力。
+      </p>
+    </section>
+  );
+}

frontend-web/src/components/workspace/agents/agent-feedback-visibility.test.ts

@@ -0,0 +1,18 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+// Node's type-stripping test runner requires the explicit TypeScript suffix.
+// @ts-expect-error The application compiler intentionally uses extensionless imports.
+import { canViewAgentFeedbackScore } from "./agent-feedback-visibility.ts";
+
+test("allows only the canonical admin role to view agent feedback scores", () => {
+  assert.equal(canViewAgentFeedbackScore({ system_role: "admin" }), true);
+  assert.equal(canViewAgentFeedbackScore({ system_role: "user" }), false);
+  assert.equal(canViewAgentFeedbackScore({ system_role: "Admin" }), false);
+});
+
+test("fails closed when authentication or its role is unavailable", () => {
+  assert.equal(canViewAgentFeedbackScore(null), false);
+  assert.equal(canViewAgentFeedbackScore(undefined), false);
+  assert.equal(canViewAgentFeedbackScore({ system_role: "" }), false);
+});

frontend-web/src/components/workspace/agents/agent-feedback-visibility.ts

@@ -0,0 +1,12 @@
+import type { LoginByUsernameResponse } from "@/core/auth";
+
+/**
+ * Agent-level answer scores are an administrative quality-control view.
+ * Keep the role check strict so missing, stale or unknown auth roles fail
+ * closed instead of exposing aggregate evaluation data.
+ */
+export function canViewAgentFeedbackScore(
+  auth: Pick<LoginByUsernameResponse, "system_role"> | null | undefined,
+): boolean {
+  return auth?.system_role === "admin";
+}

frontend-web/src/components/workspace/agents/agent-gallery.tsx

@@ -16,8 +16,16 @@ import { getStoredAuth } from "@/core/auth";
 import { useAgentsPaginated, usePrivateAgentsPaginated } from "@/core/agents";
 import type { Agent, AgentSort } from "@/core/agents";
 import { useI18n } from "@/core/i18n/hooks";
+import { useRouteBase } from "@/core/route-base";
 import { isSentimentAgentVisible } from "@/core/sentiment-agent/config";
 import { usePrivateSquareStatus, usePublishSquares, useViewMode } from "@/core/system-settings/hooks";
+import {
+  WX_RESTRICTED_TAB_DEFAULT_SQUARE,
+  WX_RESTRICTED_TAB_NANJING_DB,
+  isWxRestrictedPlaceholderTab,
+  wxRestrictedDefaultSquareTabValue,
+  wxRestrictedNanjingTabValue,
+} from "@/core/system-settings/wx-type-filter";
 
 import { AgentCard } from "./agent-card";
 import { SentimentAgentCard } from "./sentiment-agent-card";
@@ -34,9 +42,15 @@ const PAGE_SIZE = 12;
 // password never persists beyond the browsing session.
 const PRIVATE_SQUARE_PASSWORD_KEY = "deer-flow.private-square-password";
 
-export function AgentGallery() {
+export function AgentGallery({
+  restrictWxTypes = false,
+}: {
+  /** wx 侧栏入口：类型 Tab 只保留 我的 / 默认广场 / 南京-db。 */
+  restrictWxTypes?: boolean;
+} = {}) {
   const { t } = useI18n();
   const router = useRouter();
+  const routeBase = useRouteBase();
   const sentimentAgentVisible = isSentimentAgentVisible();
   // 「内置智能体」筛选仅管理员可见（后端 scope=builtin 也做了 admin 闸门兜底）。
   const isAdmin = getStoredAuth()?.system_role === "admin";
@@ -52,6 +66,12 @@ export function AgentGallery() {
   // 默认广场固定排在「我的」之后；舆情分析是依附在默认广场后的前端虚拟类型，
   // 其余自定义广场继续保持后端给出的顺序。
   const [defaultSquare, ...additionalSquares] = squareTabs;
+  const defaultSquareTabValue = wxRestrictedDefaultSquareTabValue(
+    publishSquares?.default_square_id,
+  );
+  const nanjingTabValue = wxRestrictedNanjingTabValue(squareTabs);
+  const wxPlaceholderTab =
+    restrictWxTypes && isWxRestrictedPlaceholderTab(activeTab);
   // Publisher filter: click a card's 发布者 to keep only that user's agents.
   // {id} is the owner user_id (server filter), {label} the desensitized name.
   const [publisher, setPublisher] = useState<{ id: string; label: string } | null>(
@@ -72,6 +92,30 @@ export function AgentGallery() {
   // If the active square tab disappears (admin removed that square), fall back
   // to "我的" so the gallery never points at a dead tab.
   useEffect(() => {
+    if (restrictWxTypes) {
+      if (
+        activeTab === WX_RESTRICTED_TAB_NANJING_DB &&
+        nanjingTabValue !== WX_RESTRICTED_TAB_NANJING_DB
+      ) {
+        setActiveTab(nanjingTabValue);
+        return;
+      }
+      if (
+        activeTab === WX_RESTRICTED_TAB_DEFAULT_SQUARE &&
+        defaultSquareTabValue !== WX_RESTRICTED_TAB_DEFAULT_SQUARE
+      ) {
+        setActiveTab(defaultSquareTabValue);
+        return;
+      }
+      if (
+        activeTab !== "mine" &&
+        activeTab !== defaultSquareTabValue &&
+        activeTab !== nanjingTabValue
+      ) {
+        setActiveTab("mine");
+      }
+      return;
+    }
     // 非管理员落到「内置」标签（理论上点不到，兜底）→ 回到「我的」。
     if (activeTab === "builtin" && !isAdmin) {
       setActiveTab("mine");
@@ -87,7 +131,14 @@ export function AgentGallery() {
     ) {
       setActiveTab("mine");
     }
-  }, [activeTab, squareTabs, isAdmin]);
+  }, [
+    activeTab,
+    squareTabs,
+    isAdmin,
+    restrictWxTypes,
+    defaultSquareTabValue,
+    nanjingTabValue,
+  ]);
 
   const { data: privateStatus } = usePrivateSquareStatus();
   const privateFeatureAvailable = !!privateStatus?.enabled;
@@ -128,10 +179,13 @@ export function AgentGallery() {
     sort,
     page: mainPage,
     pageSize: PAGE_SIZE,
-    enabled: activeTab !== "private" && activeTab !== "sentiment",
+    enabled:
+      activeTab !== "private" &&
+      activeTab !== "sentiment" &&
+      !wxPlaceholderTab,
     owner: publisher?.id,
     // Each square tab fetches only that square's agents.
-    square: isSquareTab ? activeTab : undefined,
+    square: isSquareTab && !wxPlaceholderTab ? activeTab : undefined,
   });
 
   const {
@@ -169,11 +223,13 @@ export function AgentGallery() {
     (activeTab !== "private" || privateUnlocked);
 
   const activeTotal =
-    activeTab === "sentiment"
+    wxPlaceholderTab
-      ? 1
+      ? 0
-      : activeTab === "private"
+      : activeTab === "sentiment"
-        ? privateTotal
+        ? 1
-        : mainTotal;
+        : activeTab === "private"
+          ? privateTotal
+          : mainTotal;
   const setTabPage = (tab: string, page: number) =>
     setPages((prev) => ({ ...prev, [tab]: page }));
 
@@ -404,6 +460,14 @@ export function AgentGallery() {
           </p>
         </div>
         <div className="flex items-center gap-2">
+          <Button
+            variant="outline"
+            size="sm"
+            title="打开智能体广场视图"
+            onClick={() => router.push(`${routeBase}/agents/plaza`)}
+          >
+            广场视图
+          </Button>
           <Button
             variant="ghost"
             size="sm"
@@ -442,6 +506,14 @@ export function AgentGallery() {
               className="w-auto max-w-full flex-wrap justify-start self-start"
               data-agent-guide="tabs"
             >
+            {restrictWxTypes ? (
+              <>
+                <TabsTrigger value="mine">我的</TabsTrigger>
+                <TabsTrigger value={defaultSquareTabValue}>默认广场</TabsTrigger>
+                <TabsTrigger value={nanjingTabValue}>南京-db</TabsTrigger>
+              </>
+            ) : (
+              <>
               <TabsTrigger value="mine">我的</TabsTrigger>
               {defaultSquare && (
                 <TabsTrigger
@@ -475,6 +547,8 @@ export function AgentGallery() {
                   内置智能体
                 </TabsTrigger>
               )}
+              </>
+            )}
             </TabsList>
             <div className="flex items-center gap-3">
               <span className="text-muted-foreground text-sm whitespace-nowrap">
@@ -545,7 +619,41 @@ export function AgentGallery() {
           )}
         </div>
 
-        {squareTabs.map((sq) => (
+        {restrictWxTypes ? (
+          <>
+            <TabsContent
+              value={defaultSquareTabValue}
+              className="flex-1 overflow-y-auto p-6 mt-0"
+            >
+              {wxPlaceholderTab && activeTab === defaultSquareTabValue
+                ? renderEmpty("该广场暂无智能体")
+                : renderListBody({
+                    list: mainAgents,
+                    total: mainTotal,
+                    isLoading: mainLoading,
+                    isFetching: mainFetching,
+                    tab: defaultSquareTabValue,
+                    emptyDescription: "该广场暂无智能体",
+                  })}
+            </TabsContent>
+            <TabsContent
+              value={nanjingTabValue}
+              className="flex-1 overflow-y-auto p-6 mt-0"
+            >
+              {wxPlaceholderTab && activeTab === nanjingTabValue
+                ? renderEmpty("该类型暂无智能体")
+                : renderListBody({
+                    list: mainAgents,
+                    total: mainTotal,
+                    isLoading: mainLoading,
+                    isFetching: mainFetching,
+                    tab: nanjingTabValue,
+                    emptyDescription: "该类型暂无智能体",
+                  })}
+            </TabsContent>
+          </>
+        ) : (
+          squareTabs.map((sq) => (
           <TabsContent
             key={sq.id}
             value={sq.id}
@@ -560,7 +668,8 @@ export function AgentGallery() {
               emptyDescription: `「${sq.name}」广场暂时还没有智能体。`,
             })}
           </TabsContent>
-        ))}
+          ))
+        )}
 
         <TabsContent value="mine" className="flex-1 overflow-y-auto p-6 mt-0">
           {renderListBody({
@@ -576,7 +685,7 @@ export function AgentGallery() {
 
         {/* 舆情分析类型：固定一张虚拟智能体卡片（名称/简介可编辑），
             接口地址与鉴权在 runtime-config.js 配置。 */}
-        {sentimentAgentVisible && (
+        {!restrictWxTypes && sentimentAgentVisible && (
           <TabsContent
             value="sentiment"
             className="flex-1 overflow-y-auto p-6 mt-0"
@@ -593,7 +702,7 @@ export function AgentGallery() {
           </TabsContent>
         )}
 
-        {isAdmin && (
+        {!restrictWxTypes && isAdmin && (
           <TabsContent value="builtin" className="flex-1 overflow-y-auto p-6 mt-0">
             {renderListBody({
               list: mainAgents,
@@ -606,7 +715,7 @@ export function AgentGallery() {
           </TabsContent>
         )}
 
-        {privateFeatureAvailable && (
+        {!restrictWxTypes && privateFeatureAvailable && (
           <TabsContent
             value="private"
             className="flex-1 overflow-y-auto p-6 mt-0"

frontend-web/src/components/workspace/agents/agent-guide.tsx

@@ -278,6 +278,7 @@ export function AgentGuide({
   autoStart?: boolean;
 }) {
   const [current, setCurrent] = useState(-1);
+  const [appDialogOpen, setAppDialogOpen] = useState(false);
   const stepsRef = useRef<GuideStep[]>([]);
 
   const start = useCallback(() => {
@@ -317,7 +318,32 @@ export function AgentGuide({
     setCurrent(-1);
   }, [stage]);
 
-  if (!eligible) return null;
+  // TDesign Guide 遮罩是 z-index 999997+。编辑智能体等业务弹窗只有 z-200，
+  // 引导若继续高亮页头按钮，会把弹窗连同关闭按钮一起盖住。业务 Dialog 打开时
+  // 先卸掉引导层，关掉后再从当前步恢复。
+  useEffect(() => {
+    if (!eligible) return;
+    const sync = () => {
+      setAppDialogOpen(
+        Boolean(document.querySelector('[data-slot="dialog-content"]')),
+      );
+    };
+    sync();
+    const observer = new MutationObserver(sync);
+    observer.observe(document.body, { childList: true, subtree: true });
+    return () => observer.disconnect();
+  }, [eligible]);
+
+  // TDesign 1.18 still handles resize when current=-1 and dereferences an
+  // undefined step. Keep its listener mounted only during an active guide.
+  if (
+    !eligible ||
+    appDialogOpen ||
+    current < 0 ||
+    current >= stepsRef.current.length
+  ) {
+    return null;
+  }
 
   return (
     <Guide

frontend-web/src/components/workspace/agents/agent-recent-chats.tsx

@@ -4,7 +4,13 @@ import { MessageSquareIcon } from "lucide-react";
 import Link from "next/link";
 import { usePathname } from "next/navigation";
 
+import {
+  MyProjectThreadBadge,
+  MyProjectThreadIcon,
+} from "@/components/workspace/my-project-thread-indicator";
 import { useThreadsPage } from "@/core/threads/hooks";
+import { myProjectConversationInfoOfThread } from "@/core/threads/project-metadata";
+import { useProjectThreadNames } from "@/core/threads/use-project-thread-names";
 import { pathOfThread, titleOfThread, isHiddenFromRecentChats, isBootstrapThread } from "@/core/threads/utils";
 import { desensitize } from "@/lib/desensitize";
 import { cn } from "@/lib/utils";
@@ -26,6 +32,7 @@ export function AgentRecentChats({ agentId }: { agentId: string }) {
   const threads = (data?.threads ?? []).filter(
     (th) => !isBootstrapThread(th) && !isHiddenFromRecentChats(th),
   );
+  const projectThreadNames = useProjectThreadNames(threads);
 
   return (
     <section className="bg-card/60 rounded-xl border p-4">
@@ -45,6 +52,10 @@ export function AgentRecentChats({ agentId }: { agentId: string }) {
           {threads.map((thread) => {
             const href = pathOfThread(thread);
             const isActive = href === pathname;
+            const projectInfo = myProjectConversationInfoOfThread(
+              thread,
+              projectThreadNames,
+            );
             return (
               <Link
                 key={thread.thread_id}
@@ -52,19 +63,37 @@ export function AgentRecentChats({ agentId }: { agentId: string }) {
                 title={desensitize(titleOfThread(thread, "新对话"))}
                 className={cn(
                   "flex min-w-0 items-center gap-2 rounded-lg px-2 py-1.5 text-sm transition-colors",
+                  projectInfo && "min-h-12",
                   isActive
                     ? "bg-primary/5 text-primary font-medium"
                     : "text-muted-foreground hover:bg-accent hover:text-foreground",
                 )}
               >
-                <MessageSquareIcon
+                {projectInfo ? (
+                  <MyProjectThreadIcon type={projectInfo.type} />
+                ) : (
+                  <MessageSquareIcon
+                    className={cn(
+                      "size-3.5 shrink-0",
+                      isActive ? "text-primary" : "text-muted-foreground/70",
+                    )}
+                  />
+                )}
+                <span
                   className={cn(
-                    "size-3.5 shrink-0",
+                    "min-w-0 flex-1",
-                    isActive ? "text-primary" : "text-muted-foreground/70",
+                    projectInfo && "flex flex-col items-start gap-0.5",
+                  )}
+                >
+                  <span className="w-full truncate">
+                    {desensitize(titleOfThread(thread, "新对话"))}
+                  </span>
+                  {projectInfo && (
+                    <MyProjectThreadBadge
+                      projectName={projectInfo.projectName}
+                      type={projectInfo.type}
+                    />
                   )}
-                />
-                <span className="truncate">
-                  {desensitize(titleOfThread(thread, "新对话"))}
                 </span>
               </Link>
             );

frontend-web/src/components/workspace/agents/enabled-skill-list.tsx

@@ -6,6 +6,8 @@ import { useMemo } from "react";
 import { Badge } from "@/components/ui/badge";
 import { Button } from "@/components/ui/button";
 import type { Skill } from "@/core/skills";
+import { useI18n } from "@/core/i18n/hooks";
+import { isSkillOffline } from "@/core/skill-availability";
 import { desensitize } from "@/lib/desensitize";
 import { cn } from "@/lib/utils";
 
@@ -53,6 +55,7 @@ export function EnabledSkillList({
   onViewDetail?: (name: string) => void;
   isLoading?: boolean;
 }) {
+  const { t } = useI18n();
   const byName = useMemo(
     () => new Map(skills.map((s) => [s.name, s])),
     [skills],
@@ -79,12 +82,14 @@ export function EnabledSkillList({
     <div className="space-y-2">
       {skillNames.map((name) => {
         const skill = byName.get(name);
+        const offline = isSkillOffline(skill);
         return (
           <div
             key={name}
             className={cn(
               "group/skill bg-background/60 flex items-start gap-2.5 rounded-xl border p-2.5 transition-colors",
               onViewDetail && "hover:border-primary/40 hover:bg-accent/40",
+              offline && "bg-muted/60 border-dashed dark:bg-[#071D36]",
             )}
           >
             <div className="bg-primary/10 text-primary flex size-8 shrink-0 items-center justify-center rounded-lg text-sm font-semibold">
@@ -108,6 +113,15 @@ export function EnabledSkillList({
                     {skillSourceLabel(skill)}
                   </Badge>
                 )}
+                {offline && (
+                  <Badge
+                    variant="outline"
+                    className="shrink-0 border-red-500/35 bg-red-500/5 text-[10px] text-red-700 dark:text-red-300"
+                    title={t.settings.skills.badgeOfflineTitle}
+                  >
+                    {t.settings.skills.badgeOffline}
+                  </Badge>
+                )}
               </div>
               <p className="text-muted-foreground mt-0.5 line-clamp-2 text-xs leading-relaxed">
                 {skill

frontend-web/src/components/workspace/agents/skill-transfer-selector.tsx

@@ -21,6 +21,7 @@ import {
   SelectValue,
 } from "@/components/ui/select";
 import type { Skill } from "@/core/skills";
+import { isSkillOffline } from "@/core/skill-availability";
 import { desensitize } from "@/lib/desensitize";
 import { cn } from "@/lib/utils";
 
@@ -28,7 +29,11 @@ const PAGE_SIZE = 5;
 const ALL_CATEGORIES = "__all__";
 
 interface SkillTransferSelectorProps {
-  /** Full pool of selectable skills (caller pre-filters by `enabled`). */
+  /**
+   * Full visible skill pool. Offline skills are never offered on the left,
+   * but an already-selected offline skill stays visible on the right so it
+   * can be removed without silently changing the persisted whitelist.
+   */
   skills: Skill[];
   /** Currently selected skill names — the persisted `skills: string[]`. */
   selected: string[];
@@ -91,7 +96,9 @@ export function SkillTransferSelector({
   const categories = useMemo(() => {
     const set = new Set<string>();
     for (const skill of skills) {
-      if (skill.category?.trim()) set.add(skill.category.trim());
+      if (!isSkillOffline(skill) && skill.category?.trim()) {
+        set.add(skill.category.trim());
+      }
     }
     return Array.from(set).sort((a, b) => a.localeCompare(b));
   }, [skills]);
@@ -102,6 +109,7 @@ export function SkillTransferSelector({
   const availableSkills = useMemo(() => {
     return skills.filter(
       (skill) =>
+        !isSkillOffline(skill) &&
         !selectedSet.has(skill.name) &&
         matchesQuery(skill, query) &&
         (category === ALL_CATEGORIES || skill.category?.trim() === category),
@@ -384,6 +392,7 @@ function SkillItemCard({
   onPick,
   onViewDetail,
 }: SkillItemCardProps) {
+  const isOffline = isSkillOffline(skill);
   return (
     <div
       role="button"
@@ -398,6 +407,7 @@ function SkillItemCard({
       title={isSelected ? "点击移除" : "点击添加"}
       className={cn(
         "group/item relative cursor-pointer rounded-md border px-2.5 py-1.5 pr-7 transition-colors",
+        isOffline && "border-dashed bg-muted/50",
         isSelected
           ? "border-primary/60 bg-primary/5 hover:border-primary dark:border-[#3B82F6] dark:bg-[#0a3568]"
           : "hover:border-primary/40 hover:bg-accent/40 dark:border-[#213D5E] dark:bg-[#02244C] dark:hover:border-[#3B82F6]/60",
@@ -425,6 +435,11 @@ function SkillItemCard({
           >
             {skillLabel(skill)}
           </div>
+          {isOffline && (
+            <div className="text-destructive truncate text-[10px]">
+              已下线，仅可移除
+            </div>
+          )}
           {skill.description?.trim() && (
             <div className="text-muted-foreground truncate text-[11px]">
               {desensitize(skill.description)}

frontend-web/src/components/workspace/appearance-controls.tsx

@@ -223,22 +223,19 @@ const LAYOUT_OPTIONS = [
  * 界面模式（全量 / 简洁）下拉切换。换肤旁并排，图标 + 下拉：
  *   - 简洁模式 ChatPage 顶栏（全局顶栏被隐藏）。
  *   - 全量模式 Header 右上角。
- * 用户未显式设置过界面模式时（mode === undefined），当前态按调用方所在的实际界面
+ * 当前态为有效界面模式（用户自选 > 管理员系统默认 > 内置简洁默认）——
- * 兜底——`fallback` 指明这一回退值（Header 传 "full"，ChatPage 传 "compact"）。
+ * useLayoutMode 总会返回具体值，不再有 undefined 兜底。
  */
 export function LayoutModeSwitcher({
   tone,
-  fallback = "compact",
   navigateTo = "/page/workspace/chats/new",
 }: {
   tone: AppearanceControlTone;
-  fallback?: "full" | "compact";
   navigateTo?: string | null;
 }) {
   const [mode, setLayoutMode] = useLayoutMode();
   const navigate = useNavigate();
-  const current = mode ?? fallback;
+  const TriggerIcon = mode === "full" ? PanelLeftIcon : LayoutIcon;
-  const TriggerIcon = current === "full" ? PanelLeftIcon : LayoutIcon;
 
   if (env.FORCE_COLLAPSED_SIDEBAR || isHideChromeActive()) return null;
 
@@ -262,7 +259,7 @@ export function LayoutModeSwitcher({
         <DropdownMenuSeparator />
         {LAYOUT_OPTIONS.map((option) => {
           const Icon = option.icon;
-          const active = current === option.id;
+          const active = mode === option.id;
           return (
             <DropdownMenuItem
               key={option.id}

frontend-web/src/components/workspace/artifacts/artifact-file-detail.tsx

@@ -8,6 +8,7 @@ import {
   ExternalLinkIcon,
   EyeIcon,
   FileType2Icon,
+  GlobeIcon,
   LoaderIcon,
   PackageIcon,
   SaveIcon,
@@ -17,11 +18,11 @@ import {
 } from "lucide-react";
 import { useQueryClient } from "@tanstack/react-query";
 import { useParams } from "next/navigation";
-import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { useNavigate } from "react-router-dom";
+import { useCallback, useEffect, useId, useLayoutEffect, useMemo, useRef, useState } from "react";
 import type { AnchorHTMLAttributes, HTMLAttributes, ReactNode } from "react";
 import { toast } from "sonner";
 import { defaultUrlTransform } from "react-markdown";
-import { Streamdown } from "streamdown";
 
 import {
   Artifact,
@@ -58,17 +59,13 @@ import { publishArtifactToKnowledge } from "@/core/agents/api";
 import { useAgent } from "@/core/agents/hooks";
 import { apiFetch } from "@/core/api";
 import { copyTextToClipboard } from "@/core/clipboard";
+import { siteStudioRoute, useWebAppCapability } from "@/core/sites/api";
 import {
   DOCUMENT_REWRITE_LOCAL_UNDO_GUARD_EVENT,
   DOCUMENT_REWRITE_STARTED_EVENT,
   DOCUMENT_REWRITE_UNDONE_EVENT,
   useDocumentRewritePresentation,
 } from "@/core/document-rewrite/context";
-import {
-  clearArtifactRewriteFallback,
-  completeArtifactRewriteFallback,
-  primeArtifactRewriteFallback,
-} from "@/core/document-rewrite/local-fallback";
 import {
   downloadArtifactFile,
 } from "@/core/artifacts/download";
@@ -85,7 +82,11 @@ import {
 import { isArtifactApiPath } from "@/core/artifacts/streaming-write-preview";
 import { useI18n } from "@/core/i18n/hooks";
 import { downloadMarkdownAsDocx } from "@/core/scheduled-tasks/markdown-docx";
-import { streamdownPlugins } from "@/core/streamdown";
+import {
+  SafeStreamdown,
+  streamdownPlugins,
+  useStreamdownMermaidPngDownload,
+} from "@/core/streamdown";
 import {
   checkCodeFile,
   getFileName,
@@ -93,6 +94,7 @@ import {
 } from "@/core/utils/files";
 import {
   downloadMermaidSvgFile,
+  downloadSvgElementAsPng,
   isMermaidFile,
   openMermaidSvgInNewTab,
   renderMermaidToSvg,
@@ -208,6 +210,22 @@ function findScrollableArtifactElement(root: HTMLElement | null) {
   );
 }
 
+/**
+ * 识别 Web App 站点清单：`outputs/<site>/site.json`（兼容 `write-file:` 虚拟 URL
+ * 与查询串）→ 返回站点目录名；其它文件返回 null（按钮不渲染，零行为变化）。
+ */
+function extractSiteStudioTarget(filepath: string): string | null {
+  const normalized = filepath.replace(/^write-file:/, "").split("?")[0];
+  if (!/(^|\/)site\.json$/.test(normalized)) return null;
+  const parts = normalized.split("/").filter(Boolean);
+  const idx = parts.lastIndexOf("site.json");
+  if (idx <= 0) return null;
+  const siteName = parts[idx - 1];
+  if (!siteName || siteName === "outputs") return null;
+  if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(siteName)) return null;
+  return siteName;
+}
+
 export function ArtifactFileDetail({
   className,
   filepath: filepathFromProps,
@@ -265,8 +283,16 @@ export function ArtifactFileDetail({
   headerLeadingActionBare?: boolean;
 }) {
   const { t } = useI18n();
-  const { artifacts, setOpen, select } = useArtifacts();
+  const { artifacts, setOpen, select, setGeneratingArtifact } = useArtifacts();
   const { isMock, thread, publicShareCode } = useThread();
+  const navigate = useNavigate();
+  // Web App 站点清单（outputs/<site>/site.json）→「站点预览」入口。
+  // capability 不可用（未启用/未部署）时按钮不渲染，原 UI 一字不变。
+  const siteStudioTarget = useMemo(
+    () => extractSiteStudioTarget(filepathFromProps),
+    [filepathFromProps],
+  );
+  const webAppCapabilityQuery = useWebAppCapability(!!siteStudioTarget);
   const isWriteFileVirtual = useMemo(() => {
     return filepathFromProps.startsWith("write-file:");
   }, [filepathFromProps]);
@@ -412,31 +438,38 @@ export function ArtifactFileDetail({
     presentationId: null,
     thinking: "",
   });
-  const documentRewriteActive = documentRewrite.isActive;
+  const documentRewriteActive = documentRewrite.isActive;
-  const imageGenerationAvailable = imageCapabilities.data?.imageGeneration?.available === true;
+  const generationLockId = useId();
-  const maxGeneratedImages = imageCapabilities.data?.imageGeneration?.maxImages ?? 4;
+  useLayoutEffect(() => {
-  const displayContent = documentRewriteActive
+    const owner = `preview:${generationLockId}`;
-    ? documentRewrite.run.draft
+    const generating = (writeFileInFlight && thread.isLoading) || documentRewriteActive;
-    : (canEditArtifact || (canUseAiEditor && hasLocalEdits)
+    setGeneratingArtifact(owner, generating ? filepathFromProps : null);
-        ? draftContent
+    return () => setGeneratingArtifact(owner, null);
-        : (content ?? ""));
+  }, [documentRewriteActive, filepathFromProps, generationLockId, setGeneratingArtifact, thread.isLoading, writeFileInFlight]);
-  const streamPerfEnabled = isSandboxStreamPerfEnabled();
+  const imageGenerationAvailable = imageCapabilities.data?.imageGeneration?.available === true;
-  const isLiveStreaming = writeFileInFlight || documentRewriteActive;
+  const maxGeneratedImages = imageCapabilities.data?.imageGeneration?.maxImages ?? 4;
+  const displayContent = documentRewriteActive
+    ? documentRewrite.run.draft
+    : (canEditArtifact || (canUseAiEditor && hasLocalEdits)
+        ? draftContent
+        : (content ?? ""));
+  const streamPerfEnabled = isSandboxStreamPerfEnabled();
+  const isLiveStreaming = writeFileInFlight || documentRewriteActive;
   const sandboxDisplayText = useMemo(() => {
     const raw = displayContent ?? "";
     if (disableDesensitize) return raw;
     if (streamPerfEnabled && isLiveStreaming) return raw;
     return desensitize(raw);
   }, [disableDesensitize, displayContent, isLiveStreaming, streamPerfEnabled]);
-  const artifactContentPending =
+  const artifactContentPending =
-    isCodeFile &&
+    isCodeFile &&
-    !useWriteFileStreaming &&
+    !useWriteFileStreaming &&
-    content === undefined &&
+    content === undefined &&
-    isArtifactContentLoading;
+    isArtifactContentLoading;
-  // `write_file` 的 path 会先于正文抵达。它仍是正常的流式过程，不能显示成一块
+  // `write_file` 的 path 会先于正文抵达。它仍是正常的流式过程，不能显示成一块
-  // 空白编辑器，更不能误导用户去点击重试真实文件；下一帧内容到达后会自然切换为代码视图。
+  // 空白编辑器，更不能误导用户去点击重试真实文件；下一帧内容到达后会自然切换为代码视图。
-  const streamingWriteContentPending =
+  const streamingWriteContentPending =
-    useWriteFileStreaming && writeFileInFlight && !content;
+    useWriteFileStreaming && writeFileInFlight && !content;
   const artifactContentUnavailable =
     isCodeFile &&
     !useWriteFileStreaming &&
@@ -444,8 +477,8 @@ export function ArtifactFileDetail({
     !isArtifactContentLoading;
   const isAutoPreviewLanguage =
     language === "html" || language === "markdown" || language === "mermaid";
-  const isPreviewStreaming =
+  const isPreviewStreaming =
-    isAutoPreviewLanguage && (writeFileInFlight || documentRewriteActive);
+    isAutoPreviewLanguage && (writeFileInFlight || documentRewriteActive);
   const hasMultipleArtifacts = (artifacts?.length ?? 0) > 1;
   const fileTypeLabel = useMemo(() => {
     if (isImageFile(filepath)) return "IMG";
@@ -470,16 +503,16 @@ export function ArtifactFileDetail({
   const [spreadsheetData, setSpreadsheetData] = useState<ArrayBuffer | null>(
     null,
   );
-  const artifactContentRef = useRef<HTMLDivElement | null>(null);
+  const artifactContentRef = useRef<HTMLDivElement | null>(null);
-  const resumeButtonTimeoutRef = useRef<number | null>(null);
+  const resumeButtonTimeoutRef = useRef<number | null>(null);
-
+
-  useEffect(() => {
+  useEffect(() => {
-    if (!documentRewriteActive) return;
+    if (!documentRewriteActive) return;
-    setAllowAutoViewSwitch(false);
+    setAllowAutoViewSwitch(false);
-    setAutoScrollEnabled(true);
+    setAutoScrollEnabled(true);
-    setShowResumeAutoScroll(false);
+    setShowResumeAutoScroll(false);
-    setViewMode("code");
+    setViewMode("code");
-  }, [documentRewriteActive]);
+  }, [documentRewriteActive]);
 
   useEffect(() => {
     if (viewMode !== "edit" || canUseAiEditor) return;
@@ -524,13 +557,20 @@ export function ArtifactFileDetail({
       presentationId: string,
       event: DocumentRewriteStreamEvent,
     ) => {
-      if (!rewritePresentation) return;
+      if (!rewritePresentation) return;
-      switch (event.type) {
+      switch (event.type) {
-        case "snapshot_fixed":
+        case "job_started":
-          rewritePresentation.update(presentationId, {
+          rewritePresentation.update(presentationId, {
-            stage: "requirements",
+            jobId: event.jobId,
-            fileName: event.fileName || getFileName(filepath),
+            ...(event.outputPath ? { outputPath: event.outputPath } : {}),
-            originalCharCount: event.originalCharCount,
+          });
+          break;
+        case "snapshot_fixed":
+          rewritePresentation.update(presentationId, {
+            stage: "requirements",
+            fileName: event.fileName || getFileName(filepath),
+            ...(event.outputPath ? { outputPath: event.outputPath } : {}),
+            originalCharCount: event.originalCharCount,
             requirementsPlan: "",
           });
           break;
@@ -591,10 +631,11 @@ export function ArtifactFileDetail({
         case "commit_started":
           rewritePresentation.update(presentationId, { stage: "committing" });
           break;
-        case "committed":
+        case "committed":
-          rewritePresentation.update(presentationId, {
+          rewritePresentation.update(presentationId, {
-            rewrittenContent: event.content,
+            rewrittenContent: event.content,
-            versionId: event.versionId ?? null,
+            ...(event.outputPath ? { outputPath: event.outputPath } : {}),
+            versionId: event.versionId ?? null,
             committedHash: event.committedHash,
           });
           break;
@@ -610,9 +651,13 @@ export function ArtifactFileDetail({
         case "cancelled":
           rewritePresentation.update(presentationId, { stage: "cancelled", error: event.message });
           break;
-        case "error":
+        case "error":
-          console.error("AI 全文改写历史恢复失败：", event.message);
+          rewritePresentation.update(presentationId, {
-          break;
+            stage: "error",
+            error: event.message,
+            diagnostic: event.diagnostic ?? null,
+          });
+          break;
         default:
           break;
       }
@@ -634,10 +679,18 @@ export function ArtifactFileDetail({
           const historicalSummary = historicalResult.summary && typeof historicalResult.summary === "object"
             ? historicalResult.summary as DocumentRewriteSummary
             : null;
-          const historicalPresentationId = rewritePresentation?.create({
+          const historicalPresentationId = rewritePresentation?.create({
-            threadId,
+            threadId,
-            source: { kind: "artifact", id: threadId, path: filepath },
+            source: { kind: "artifact", id: threadId, path: filepath },
-            fileName: getFileName(filepath),
+            jobId: historical.id,
+            outputPath: typeof historicalResult.outputPath === "string"
+              ? historicalResult.outputPath
+              : historical.outputPath,
+            fileName: getFileName(
+              typeof historicalResult.outputPath === "string"
+                ? historicalResult.outputPath
+                : historical.outputPath ?? filepath,
+            ),
             instruction: historical.request.instruction,
             style: historical.request.style,
             modelName: historical.request.modelName,
@@ -658,11 +711,14 @@ export function ArtifactFileDetail({
             summary: historicalSummary,
             warnings: historicalSummary?.validationWarnings ?? [],
             versionId: typeof historicalResult.versionId === "string" ? historicalResult.versionId : null,
-            error: historicalResult.status === "conflict"
+            error: historicalResult.status === "conflict"
-              ? "文件在改写期间已变化，未覆盖原文件。"
+              ? "文件在改写期间已变化，未覆盖原文件。"
-              : historical.status === "cancelled"
+              : historical.status === "cancelled"
-                ? "已停止全文改写，原文件未被修改。"
+                ? "已停止全文改写，原文件未被修改。"
-                : historical.status === "failed" ? "全文改写未完成，原文件未被修改。" : null,
+                : historical.status === "failed"
+                  ? historical.errorMessage ?? "全文改写未完成，原文件未被修改。"
+                  : null,
+            diagnostic: historical.diagnostic ?? null,
           });
         }
         const result = latest.result;
@@ -671,36 +727,25 @@ export function ArtifactFileDetail({
           : null;
         const originalContent = latest.request.originalContent || draftContent;
         const rewrittenContent = typeof result.content === "string" ? result.content : null;
-        const versionSnapshotFailed = result.versionSnapshotFailed === true;
+        const committedHash = typeof result.committedHash === "string" ? result.committedHash : null;
-        const committedHash = typeof result.committedHash === "string" ? result.committedHash : null;
+        const outputPath = typeof result.outputPath === "string"
-        if (!versionSnapshotFailed) {
+          ? result.outputPath
-          clearArtifactRewriteFallback(threadId, filepath);
+          : latest.outputPath;
-        }
+        const presentationId = rewritePresentation?.create({
-        const localFallbackAvailable =
+          threadId,
-          versionSnapshotFailed &&
+          source: { kind: "artifact", id: threadId, path: filepath },
-          latest.status === "completed" &&
+          jobId: latest.id,
-          result.status !== "conflict" &&
+          outputPath,
-          committedHash !== null &&
+          fileName: getFileName(outputPath ?? filepath),
-          completeArtifactRewriteFallback({
-            threadId,
-            path: filepath,
-            originalContent,
-            committedHash,
-          });
-        const presentationId = rewritePresentation?.create({
-          threadId,
-          source: { kind: "artifact", id: threadId, path: filepath },
-          fileName: getFileName(filepath),
           instruction: latest.request.instruction,
           style: latest.request.style,
           modelName: latest.request.modelName,
           generateImages: latest.request.generateImages,
           maxGeneratedImages: latest.request.maxGeneratedImages,
           originalContent,
-          rewrittenContent,
+          rewrittenContent,
-          committedHash,
+          committedHash,
-          localFallbackAvailable,
+          requirementsPlan: typeof result.requirementsPlan === "string" ? result.requirementsPlan : "",
-          requirementsPlan: typeof result.requirementsPlan === "string" ? result.requirementsPlan : "",
         });
         if (!presentationId || !rewritePresentation) return;
         setDocumentRewritePresentationId(presentationId);
@@ -709,32 +754,22 @@ export function ArtifactFileDetail({
           rewritePresentation.update(presentationId, {
             stage: result.status === "conflict" ? "conflict" : "completed",
             summary,
-            warnings: summary?.validationWarnings ?? [],
+            warnings: summary?.validationWarnings ?? [],
-            versionId: typeof result.versionId === "string" ? result.versionId : null,
+            versionId: typeof result.versionId === "string" ? result.versionId : null,
-            committedHash,
+            committedHash,
-            localFallbackAvailable,
+            error: result.status === "conflict" ? "改写版文件未生成。" : null,
-            error: result.status === "conflict" ? "文件在改写期间已变化，未覆盖原文件。" : null,
+          });
-          });
+          return;
-          if (rewrittenContent && result.status !== "conflict") {
-            setDraftContent(rewrittenContent);
-            setHasLocalEdits(versionSnapshotFailed);
-            if (versionSnapshotFailed) {
-              console.error(
-                "AI 全文改写已写入文件，但撤销版本快照保存失败；已启用手动保存。",
-              );
-            }
-            queryClient.setQueriesData(
-              { queryKey: ["artifact", filepath, threadId, isMock] },
-              { content: rewrittenContent, url: undefined },
-            );
-          }
-          return;
         }
-        if (latest.status === "failed" || latest.status === "cancelled") {
+        if (latest.status === "failed" || latest.status === "cancelled") {
-          rewritePresentation.update(presentationId, {
+          rewritePresentation.update(presentationId, {
-            stage: latest.status === "cancelled" ? "cancelled" : "error",
+            stage: latest.status === "cancelled" ? "cancelled" : "error",
-            summary,
+            summary,
-          });
+            error: latest.status === "cancelled"
+              ? "已停止全文改写，原文件未被修改。"
+              : latest.errorMessage ?? "全文改写未完成，原文件未被修改。",
+            diagnostic: latest.status === "failed" ? latest.diagnostic ?? null : null,
+          });
           return;
         }
 
@@ -756,35 +791,22 @@ export function ArtifactFileDetail({
               signal,
             ),
             onEvent: (event) => updatePresentation(presentationId, event),
-            onCommitted: (rewritten, { versionSnapshotFailed, committedHash }) => {
+            onCommitted: (rewritten, { committedHash, outputPath }) => {
-              setDraftContent(rewritten);
+              rewritePresentation.update(presentationId, {
-              setHasLocalEdits(versionSnapshotFailed);
+                rewrittenContent: rewritten,
-              const localFallbackAvailable = versionSnapshotFailed && completeArtifactRewriteFallback({
+                committedHash,
-                threadId,
+                ...(outputPath ? { outputPath } : {}),
-                path: filepath,
+              });
-                originalContent,
+            },
-                committedHash,
+            onFailure: ({ error, diagnostic }) => {
-              });
+              rewritePresentation.update(presentationId, {
-              if (!versionSnapshotFailed) {
+                stage: "error",
-                clearArtifactRewriteFallback(threadId, filepath);
+                error,
-              }
+                diagnostic: diagnostic ?? null,
-              if (versionSnapshotFailed) {
+              });
-                console.error(
+            },
-                  "AI 全文改写已写入文件，但撤销版本快照保存失败；已启用手动保存。",
+          },
-                );
+        );
-              }
-              rewritePresentation.update(presentationId, {
-                rewrittenContent: rewritten,
-                committedHash,
-                localFallbackAvailable,
-              });
-              queryClient.setQueriesData(
-                { queryKey: ["artifact", filepath, threadId, isMock] },
-                { content: rewritten, url: undefined },
-              );
-            },
-          },
-        );
       } catch {
         // Existing artifacts remain available even if history hydration fails.
       }
@@ -907,8 +929,8 @@ export function ArtifactFileDetail({
       return;
     }
 
-    if (language === "html") {
+    if (language === "html") {
-      setViewMode(writeFileInFlight || documentRewriteActive ? "code" : "preview");
+      setViewMode(writeFileInFlight || documentRewriteActive ? "code" : "preview");
       return;
     }
 
@@ -918,9 +940,9 @@ export function ArtifactFileDetail({
     }
 
     setViewMode("code");
-  }, [
+  }, [
-    documentRewriteActive,
+    documentRewriteActive,
-    isPreviewStreaming,
+    isPreviewStreaming,
     isSupportPreview,
     language,
     writeFileInFlight,
@@ -931,7 +953,7 @@ export function ArtifactFileDetail({
       return;
     }
 
-    if (writeFileInFlight || documentRewriteActive) {
+    if (writeFileInFlight || documentRewriteActive) {
       setViewMode("code");
       return;
     }
@@ -943,10 +965,10 @@ export function ArtifactFileDetail({
     }, 1400);
 
     return () => window.clearTimeout(timeoutId);
-  }, [
+  }, [
-    allowAutoViewSwitch,
+    allowAutoViewSwitch,
-    documentRewriteActive,
+    documentRewriteActive,
-    isAutoPreviewLanguage,
+    isAutoPreviewLanguage,
     isSupportPreview,
     writeFileInFlight,
   ]);
@@ -1107,16 +1129,17 @@ export function ArtifactFileDetail({
       generateImages: boolean;
       maxGeneratedImages: number;
     }) => {
-      if (!canEditArtifact) {
+      if (!canEditArtifact) {
-        toast.error("当前文件暂不支持全文改写。");
+        toast.error("当前文件暂不支持全文改写。");
-        return;
+        return;
-      }
+      }
-      setDocumentRewriteDialogOpen(false);
+      setDocumentRewriteDialogOpen(false);
-      setAllowAutoViewSwitch(false);
+      setAllowAutoViewSwitch(false);
-      setAutoScrollEnabled(true);
+      setAutoScrollEnabled(true);
-      setViewMode("code");
+      setShowResumeAutoScroll(false);
-
+      setViewMode("code");
-      // Do not make users manually save before using AI rewrite. Persist their
+
+      // Do not make users manually save before using AI rewrite. Persist their
       // current draft first so the rewrite starts from exactly what they see,
       // and the optimistic hash remains valid on the server.
       if (hasLocalEdits) {
@@ -1135,12 +1158,7 @@ export function ArtifactFileDetail({
         }
       }
 
-      primeArtifactRewriteFallback({
+      const expectedHash = await sha256Content(draftContent);
-        threadId,
-        path: filepath,
-        originalContent: draftContent,
-      });
-      const expectedHash = await sha256Content(draftContent);
       const presentationId = rewritePresentation?.create({
         threadId,
         source: { kind: "artifact", id: threadId, path: filepath },
@@ -1172,14 +1190,21 @@ export function ArtifactFileDetail({
           expectedHash,
         },
         {
-          onEvent: (event) => {
+          onEvent: (event) => {
-            if (!presentationId || !rewritePresentation) return;
+            if (!presentationId || !rewritePresentation) return;
-            switch (event.type) {
+            switch (event.type) {
-              case "snapshot_fixed":
+              case "job_started":
-                rewritePresentation.update(presentationId, {
+                rewritePresentation.update(presentationId, {
-                  stage: "requirements",
+                  jobId: event.jobId,
-                  fileName: event.fileName || getFileName(filepath),
+                  ...(event.outputPath ? { outputPath: event.outputPath } : {}),
-                  originalCharCount: event.originalCharCount,
+                });
+                break;
+              case "snapshot_fixed":
+                rewritePresentation.update(presentationId, {
+                  stage: "requirements",
+                  fileName: event.fileName || getFileName(filepath),
+                  ...(event.outputPath ? { outputPath: event.outputPath } : {}),
+                  originalCharCount: event.originalCharCount,
                   requirementsPlan: "",
                 });
                 break;
@@ -1243,9 +1268,11 @@ export function ArtifactFileDetail({
               case "commit_started":
                 rewritePresentation.update(presentationId, { stage: "committing" });
                 break;
-              case "committed":
+              case "committed":
-                rewritePresentation.update(presentationId, {
+                rewritePresentation.update(presentationId, {
-                  versionId: event.versionId ?? null,
+                  rewrittenContent: event.content,
+                  ...(event.outputPath ? { outputPath: event.outputPath } : {}),
+                  versionId: event.versionId ?? null,
                   committedHash: event.committedHash,
                 });
                 break;
@@ -1255,77 +1282,48 @@ export function ArtifactFileDetail({
                   versionId: event.versionId ?? null,
                 });
                 break;
-              case "conflict":
+              case "conflict":
-                rewritePresentation.update(presentationId, {
+                rewritePresentation.update(presentationId, {
-                  stage: "conflict",
+                  stage: "conflict",
-                  error: event.message,
+                  error: event.message,
-                });
+                });
-                break;
+                break;
-              case "error":
+              case "cancelled":
-                // The sandbox retains the visible draft and exposes manual
+                rewritePresentation.update(presentationId, {
-                // save instead of showing an error state to the user.
+                  stage: "cancelled",
-                console.error("AI 全文改写接口失败：", event.message);
+                  error: event.message,
-                break;
+                });
+                break;
+              case "error":
+                rewritePresentation.update(presentationId, {
+                  stage: "error",
+                  error: event.message,
+                  diagnostic: event.diagnostic ?? null,
+                });
+                break;
               default:
                 break;
             }
           },
-          onCommitted: (rewritten, { versionSnapshotFailed, committedHash }) => {
+          onCommitted: (rewritten, { committedHash, outputPath }) => {
-            setDraftContent(rewritten);
+            if (presentationId && rewritePresentation) {
-            setHasLocalEdits(versionSnapshotFailed);
+              rewritePresentation.update(presentationId, {
-            const localFallbackAvailable = versionSnapshotFailed && completeArtifactRewriteFallback({
+                rewrittenContent: rewritten,
-              threadId,
+                committedHash,
-              path: filepath,
+                ...(outputPath ? { outputPath } : {}),
-              originalContent: draftContent,
+              });
-              committedHash,
+            }
-            });
+            toast.success("AI 改写完成，已生成独立的改写版文件。原文件保持不变。");
-            if (!versionSnapshotFailed) {
+          },
-              clearArtifactRewriteFallback(threadId, filepath);
+          onFailure: ({ error, diagnostic }) => {
-            }
+            if (presentationId && rewritePresentation) {
-            if (presentationId && rewritePresentation) {
+              rewritePresentation.update(presentationId, {
-              rewritePresentation.update(presentationId, {
+                stage: "error",
-                rewrittenContent: rewritten,
+                error,
-                committedHash,
+                diagnostic: diagnostic ?? null,
-                localFallbackAvailable,
+              });
-              });
+            }
-            }
+          },
-            queryClient.setQueriesData(
-              {
-                queryKey: ["artifact", filepath, threadId, isMock],
-              },
-              { content: rewritten, url: undefined },
-            );
-            if (versionSnapshotFailed) {
-              console.error(
-                "AI 全文改写已写入文件，但撤销版本快照保存失败；已启用手动保存。",
-              );
-            } else {
-              toast.success("Markdown 全文改写完成，已安全替换原文件。");
-            }
-          },
-          onFailure: ({ content, error }) => {
-            // The rewrite transport can fail after the server has already
-            // streamed text (or before the first token on a 404). Keep that
-            // visible content in the sandbox, make Save actionable, and leave
-            // diagnostics to the developer console only.
-            const retainedContent = content || draftContent;
-            setDraftContent(retainedContent);
-            setHasLocalEdits(true);
-            queryClient.setQueriesData(
-              {
-                queryKey: ["artifact", filepath, threadId, isMock],
-              },
-              { content: retainedContent, url: undefined },
-            );
-            if (presentationId && rewritePresentation) {
-              rewritePresentation.update(presentationId, {
-                stage: "completed",
-                rewrittenContent: retainedContent,
-                error: null,
-              });
-            }
-            console.error("AI 全文改写接口失败，已保留沙箱内容供手动保存：", error);
-          },
         },
       );
     },
@@ -1343,15 +1341,37 @@ export function ArtifactFileDetail({
     ],
   );
 
-  const handleCancelDocumentRewrite = useCallback(() => {
+  const handleCancelDocumentRewrite = useCallback(() => {
-    documentRewrite.cancel();
+    documentRewrite.cancel();
     if (documentRewritePresentationId && rewritePresentation) {
       rewritePresentation.update(documentRewritePresentationId, {
         stage: "cancelled",
         error: "已停止全文改写，原文件未被修改。",
       });
     }
-  }, [documentRewrite, documentRewritePresentationId, rewritePresentation]);
+  }, [documentRewrite, documentRewritePresentationId, rewritePresentation]);
+
+  // The docked conversation composer is outside this artifact pane.  Register
+  // the same cancellation path so its standard square stop button can abort
+  // both the local SSE reader and the durable rewrite job.
+  useEffect(() => {
+    if (
+      !documentRewriteActive ||
+      !documentRewritePresentationId ||
+      !rewritePresentation
+    ) {
+      return;
+    }
+    return rewritePresentation.registerCancellation(
+      documentRewritePresentationId,
+      handleCancelDocumentRewrite,
+    );
+  }, [
+    documentRewriteActive,
+    documentRewritePresentationId,
+    handleCancelDocumentRewrite,
+    rewritePresentation,
+  ]);
 
   // 发布入库：仅当当前路由是智能体会话（agents/:agent_id/chats/…）且该智能体
   // 配置了入库模板名（template_name）时，md 产物右上角才出现发布按钮。
@@ -1426,7 +1446,9 @@ export function ArtifactFileDetail({
       toast.error("文件内容为空，暂时无法在新窗口打开");
       return;
     }
-    const blob = new Blob([prepareGeneratedHtml(source)], {
+    const blob = new Blob([
+      prepareGeneratedHtml(source),
+    ], {
       type: "text/html;charset=utf-8",
     });
     const url = URL.createObjectURL(blob);
@@ -1453,7 +1475,11 @@ export function ArtifactFileDetail({
         : language === "markdown"
           ? "text/markdown;charset=utf-8"
           : "text/plain;charset=utf-8";
-    const blob = new Blob([source], { type: blobType });
+    const downloadSource =
+      language === "html"
+        ? prepareGeneratedHtml(source)
+        : source;
+    const blob = new Blob([downloadSource], { type: blobType });
     const url = URL.createObjectURL(blob);
     const a = document.createElement("a");
     a.href = url;
@@ -1584,19 +1610,25 @@ export function ArtifactFileDetail({
             {canEditArtifact && (
               <ArtifactAction
                 icon={documentRewriteActive ? LoaderIcon : SparklesIcon}
-                label={documentRewriteActive ? "正在全文改写" : "AI 全文改写"}
+                label={documentRewriteActive ? "正在全文改写" : "AI 全文改写"}
-                tooltip={
+                tooltip={
-                  documentRewriteActive
+                  documentRewriteActive
-                    ? "正在生成临时草稿，原文件尚未被覆盖"
+                    ? "正在生成独立改写版文件，原文件保持不变；点击停止"
-                    : hasLocalEdits
+                    : hasLocalEdits
-                      ? "将先保存当前 Markdown 修改，再开始改写"
+                      ? "将先保存当前 Markdown 修改，再开始改写"
-                      : "使用 AI 重写当前完整 Markdown"
+                      : "使用 AI 重写当前完整 Markdown"
-                }
+                }
-                // Keep the entry available after a completed rewrite and when
+                // Keep the entry available after a completed rewrite and when
-                // the user has local edits. Starting with local edits saves
+                // the user has local edits. Starting with local edits saves
-                // them automatically in handleStartDocumentRewrite.
+                // them automatically in handleStartDocumentRewrite.
-                onClick={() => setDocumentRewriteDialogOpen(true)}
+                onClick={() => {
-              />
+                  if (documentRewriteActive) {
+                    handleCancelDocumentRewrite();
+                    return;
+                  }
+                  setDocumentRewriteDialogOpen(true);
+                }}
+              />
             )}
             {!useWriteFileStreaming && filepath.endsWith(".skill") && (
               <Tooltip content={t.toolCalls.skillInstallTooltip}>
@@ -1646,6 +1678,16 @@ export function ArtifactFileDetail({
                 onClick={handleOpenInNewWindow}
               />
             )}
+            {siteStudioTarget && webAppCapabilityQuery.data?.available && (
+              <ArtifactAction
+                icon={GlobeIcon}
+                label="站点预览"
+                tooltip="打开站点预览工作室（多页面站点 / 流程图 / 地图）"
+                onClick={() =>
+                  navigate(siteStudioRoute(threadId, siteStudioTarget))
+                }
+              />
+            )}
             <ArtifactAction
               icon={DownloadIcon}
               label={t.common.download}
@@ -1712,27 +1754,6 @@ export function ArtifactFileDetail({
             正在改写 Markdown
           </div>
         )}
-        {documentRewriteActive && (
-          <div className="absolute right-4 bottom-4 z-20 inline-flex items-center gap-2 rounded-full border border-[#d8b878] bg-[#fff3cf]/95 px-3 py-1.5 text-xs text-[#6d5625] shadow-sm">
-            <LoaderIcon className="size-3.5 animate-spin" />
-            {documentRewrite.run.stage === "requirements"
-              ? "正在理解改写需求，原文件未被修改"
-              : documentRewrite.run.stage === "validation"
-              ? "正在校验 Markdown"
-              : documentRewrite.run.stage === "committing"
-                ? "正在安全替换原文件"
-                : "正在写入临时草稿 · " +
-                  documentRewrite.run.writtenCharCount.toLocaleString() +
-                  " 字"}
-            <button
-              type="button"
-              className="ml-1 rounded px-1.5 py-0.5 font-medium hover:bg-[#ead9a6]"
-              onClick={handleCancelDocumentRewrite}
-            >
-              停止
-            </button>
-          </div>
-        )}
         {showResumeAutoScroll && (
           <button
             type="button"
@@ -1743,7 +1764,7 @@ export function ArtifactFileDetail({
             滑动到底部并继续自动下滑
           </button>
         )}
-        {viewMode === "edit" && canUseAiEditor && !documentRewriteActive && (
+        {viewMode === "edit" && canUseAiEditor && !documentRewriteActive && (
           <MarkdownAiEditor
             // 编辑用原始内容（与源码模式一致，不脱敏）；有 artifacts 保存能力时走头部「保存 Markdown」。
             // write-file 虚拟预览（如深度研究）仅本地 draft，切换预览/源码仍可见本次改动。
@@ -1770,10 +1791,10 @@ export function ArtifactFileDetail({
                 activeCursor={isApplyingEdit}
               />
             )}
-        {(artifactContentPending || streamingWriteContentPending) && viewMode === "code" && (
+        {(artifactContentPending || streamingWriteContentPending) && viewMode === "code" && (
-          <div className="text-muted-foreground flex size-full flex-col items-center justify-center gap-3 text-sm">
+          <div className="text-muted-foreground flex size-full flex-col items-center justify-center gap-3 text-sm">
-            <LoaderIcon aria-hidden="true" className="size-5 animate-spin" />
+            <LoaderIcon aria-hidden="true" className="size-5 animate-spin" />
-            {streamingWriteContentPending ? "正在接收文件内容…" : "正在加载文档内容…"}
+            {streamingWriteContentPending ? "正在接收文件内容…" : "正在加载文档内容…"}
           </div>
         )}
         {artifactContentUnavailable && viewMode === "code" && (
@@ -1791,7 +1812,7 @@ export function ArtifactFileDetail({
             </button>
           </div>
         )}
-        {isCodeFile && viewMode === "code" && !artifactContentPending && !streamingWriteContentPending && !artifactContentUnavailable && (
+        {isCodeFile && viewMode === "code" && !artifactContentPending && !streamingWriteContentPending && !artifactContentUnavailable && (
           <div className="size-full">
             <CodeEditor
               className="size-full resize-none rounded-none border-none bg-transparent"
@@ -1800,16 +1821,16 @@ export function ArtifactFileDetail({
                   ? (displayContent ?? "")
                   : sandboxDisplayText
               }
-              readonly={!canEditArtifact || documentRewriteActive}
+              readonly={!canEditArtifact || documentRewriteActive}
-              onChange={
+              onChange={
-                canEditArtifact && !documentRewriteActive
+                canEditArtifact && !documentRewriteActive
                   ? (value) => {
                       setDraftContent(value);
                       setHasLocalEdits(true);
                     }
                   : undefined
               }
-              isStreaming={writeFileInFlight || documentRewriteActive}
+              isStreaming={writeFileInFlight || documentRewriteActive}
               streamingReadonlyFallback={!canEditArtifact}
             />
           </div>
@@ -2011,6 +2032,9 @@ export function ArtifactFilePreview({
   const [htmlPreviewUrl, setHtmlPreviewUrl] = useState<string>();
   const [mermaidSvg, setMermaidSvg] = useState<string | null>(null);
   const [mermaidError, setMermaidError] = useState<string | null>(null);
+  const markdownPreviewRef = useRef<HTMLDivElement>(null);
+  const mermaidChartRef = useRef<HTMLDivElement>(null);
+  useStreamdownMermaidPngDownload(markdownPreviewRef);
   const researchSourcesQuery = useResearchSources(
     language === "markdown" ? (researchSessionId ?? null) : null,
   );
@@ -2090,7 +2114,9 @@ export function ArtifactFilePreview({
     // <meta charset> 就会中文乱码。与下方下载/新窗口打开的 blobType 保持一致。
     // Intercept in-page anchor clicks so they scroll within the iframe instead
     // of navigating the sandboxed blob: document (which blanks the frame).
-    const blob = new Blob([prepareGeneratedHtml(content ?? "")], {
+    const blob = new Blob([
+      prepareGeneratedHtml(content ?? ""),
+    ], {
       type: "text/html;charset=utf-8",
     });
     const url = URL.createObjectURL(blob);
@@ -2135,6 +2161,7 @@ export function ArtifactFilePreview({
   if (language === "markdown") {
     return (
       <div
+        ref={markdownPreviewRef}
         data-artifact-preview-scroll
         data-markdown-anchor-root
         className={cn(
@@ -2142,7 +2169,7 @@ export function ArtifactFilePreview({
           animated && "animate-[sandbox-preview-enter_320ms_ease-out]",
         )}
       >
-          <Streamdown
+          <SafeStreamdown
             className="size-full"
             {...streamdownPlugins}
             // react-markdown's safe default strips unknown protocols before the
@@ -2167,7 +2194,7 @@ export function ArtifactFilePreview({
           }}
         >
           {previewContent}
-        </Streamdown>
+        </SafeStreamdown>
         {activeCursor && (
           <span className="mt-2 inline-block h-5 w-0.5 animate-pulse rounded-full bg-[#9b7a2f]" />
         )}
@@ -2199,10 +2226,42 @@ export function ArtifactFilePreview({
         )}
       >
         {mermaidSvg ? (
-          <div
+          <div className="relative mx-auto flex min-h-full items-start justify-center rounded-2xl border border-slate-200 bg-white p-4 pt-12 shadow-sm">
-            className="mx-auto flex min-h-full items-start justify-center rounded-2xl border border-slate-200 bg-white p-4 shadow-sm"
+            <div className="absolute right-3 top-3 flex items-center gap-1">
-            dangerouslySetInnerHTML={{ __html: mermaidSvg }}
+              <button
-          />
+                type="button"
+                className="text-muted-foreground hover:text-foreground rounded-md p-1"
+                title="下载图片"
+                onClick={() => {
+                  const svg = mermaidChartRef.current?.querySelector("svg");
+                  if (!(svg instanceof SVGSVGElement)) {
+                    toast.error("流程图尚未渲染完成，请稍后再下载");
+                    return;
+                  }
+                  void downloadSvgElementAsPng(svg, "flowchart.png").catch((error) => {
+                    console.error("Failed to download mermaid image:", error);
+                    toast.error(error instanceof Error ? error.message : "下载流程图失败");
+                  });
+                }}
+              >
+                <DownloadIcon className="size-3.5" />
+              </button>
+              <button
+                type="button"
+                className="text-muted-foreground hover:text-foreground rounded-md p-1"
+                title="新窗口打开"
+                onClick={() => {
+                  void openMermaidSvgInNewTab(content ?? "").catch((error) => {
+                    console.error("Failed to open mermaid preview:", error);
+                    toast.error(error instanceof Error ? error.message : "打开流程图失败");
+                  });
+                }}
+              >
+                <ExternalLinkIcon className="size-3.5" />
+              </button>
+            </div>
+            <div ref={mermaidChartRef} dangerouslySetInnerHTML={{ __html: mermaidSvg }} />
+          </div>
         ) : mermaidError ? (
           <div className="space-y-3">
             <div className="rounded-xl border border-rose-200 bg-rose-50 px-4 py-3 text-sm text-rose-700">

frontend-web/src/components/workspace/artifacts/artifact-file-list.tsx

@@ -16,6 +16,7 @@ import {
   getFileExtensionDisplayName,
   getFileIcon,
   getFileName,
+  isWordDocumentFile,
 } from "@/core/utils/files";
 import { cn } from "@/lib/utils";
 
@@ -93,12 +94,12 @@ export function ArtifactFileList({
 
   return (
     <ul className={cn("flex w-full flex-col gap-4", className)}>
-      {files.map((file) => (
+      {files.map((file) => (
-        <Card
+        <Card
-          key={file}
+          key={file}
-          className="relative cursor-pointer p-3"
+          className={cn("relative p-3", !isWordDocumentFile(file) && "cursor-pointer")}
-          onClick={() => handleClick(file)}
+          onClick={isWordDocumentFile(file) ? undefined : () => handleClick(file)}
-        >
+        >
           <CardHeader className="grid-cols-[minmax(0,1fr)_auto] items-center gap-x-3 gap-y-1 pr-2 pl-1">
             <CardTitle className="relative min-w-0 pl-8 leading-tight [overflow-wrap:anywhere] break-words">
               <div className="min-w-0">{getFileName(file)}</div>
@@ -133,7 +134,7 @@ export function ArtifactFileList({
               </Button>
             </CardAction>
           </CardHeader>
-        </Card>
+        </Card>
       ))}
       <SkillInstallDialog
         open={!!installFile}

frontend-web/src/components/workspace/artifacts/context.tsx

@@ -7,9 +7,11 @@ import {
   useState,
   type ReactNode,
 } from "react";
+import { toast } from "sonner";
 
 import { useSidebarSafe } from "@/components/ui/sidebar";
 import { env } from "@/env";
+import { resolveWriteFilePath } from "@/core/artifacts/write-file-in-flight";
 
 export function artifactPreviewKey(artifact: string): string {
   if (!artifact.startsWith("write-file:")) {
@@ -38,6 +40,8 @@ export interface ArtifactsContextType {
   select: (artifact: string, autoSelect?: boolean) => void;
   /** Open/update a streamed write without overriding a manual close of that call. */
   openStreamedArtifact: (artifact: string, previewKey: string) => boolean;
+  /** Register the file being generated; remove this owner's lock on completion. */
+  setGeneratingArtifact: (owner: string, artifact: string | null) => void;
   deselect: () => void;
 
   open: boolean;
@@ -86,6 +90,26 @@ export function ArtifactsProvider({ children }: ArtifactsProviderProps) {
   const [preOpen, setPreOpen] = useState(false);
   const [autoOpen, setAutoOpen] = useState(true);
   const suppressedAutoOpenKeyRef = useRef<string | null>(null);
+  const generatingArtifactsRef = useRef(new Map<string, string>());
+  const setGeneratingArtifact = useCallback((owner: string, artifact: string | null) => {
+    if (artifact) generatingArtifactsRef.current.set(owner, artifact);
+    else generatingArtifactsRef.current.delete(owner);
+  }, []);
+  const canSwitchArtifact = useCallback((artifact: string, notify: boolean) => {
+    for (const generating of generatingArtifactsRef.current.values()) {
+      if (
+        artifactPreviewKey(generating) === artifactPreviewKey(artifact) ||
+        resolveWriteFilePath(generating) === resolveWriteFilePath(artifact)
+      ) continue;
+      if (notify) {
+        toast.info("当前文件正在生成，请稍等片刻，完成后就可以切换查看其他文件。", {
+          id: "artifact-generation-switch-locked",
+        });
+      }
+      return false;
+    }
+    return true;
+  }, []);
   // 供稳定的 setOpen 回调同步读取。写文件流会高频调用 select/setOpen，避免每次
   // Context 状态变化都重建 setter 并触发依赖它的布局 effect。
   const selectedArtifactKeyRef = useRef<string | null>(selectedArtifactKey);
@@ -129,6 +153,7 @@ export function ArtifactsProvider({ children }: ArtifactsProviderProps) {
 
   const select = useCallback(
     (artifact: string, autoSelect = false) => {
+      if (!canSwitchArtifact(artifact, !autoSelect)) return;
       const previewKey = artifactPreviewKey(artifact);
       selectedArtifactKeyRef.current = previewKey;
       setSelectedArtifact((previous) => (previous === artifact ? previous : artifact));
@@ -140,11 +165,12 @@ export function ArtifactsProvider({ children }: ArtifactsProviderProps) {
         setAutoSelect((previous) => (previous ? false : previous));
       }
     },
-    [sidebar],
+    [canSwitchArtifact, sidebar],
   );
 
   const openStreamedArtifact = useCallback(
     (artifact: string, previewKey: string) => {
+      if (!canSwitchArtifact(artifact, false)) return false;
       if (suppressedAutoOpenKeyRef.current === previewKey) {
         return false;
       }
@@ -180,10 +206,11 @@ export function ArtifactsProvider({ children }: ArtifactsProviderProps) {
       }
       return true;
     },
-    [applyOpen, cancelPendingStreamedOpen, sidebar],
+    [applyOpen, canSwitchArtifact, cancelPendingStreamedOpen, sidebar],
   );
 
   const deselect = useCallback(() => {
+    generatingArtifactsRef.current.clear();
     selectedArtifactKeyRef.current = null;
     setSelectedArtifact((previous) => (previous === null ? previous : null));
     setSelectedArtifactKey((previous) => (previous === null ? previous : null));
@@ -224,6 +251,7 @@ export function ArtifactsProvider({ children }: ArtifactsProviderProps) {
     selectedArtifactKey,
     select,
     openStreamedArtifact,
+    setGeneratingArtifact,
     deselect,
   };
 

frontend-web/src/components/workspace/chat-runtime.tsx

@@ -0,0 +1,28 @@
+import type { ReactNode } from "react";
+
+import { PromptInputProvider } from "@/components/ai-elements/prompt-input";
+import { ArtifactsProvider } from "@/components/workspace/artifacts";
+import { DocumentRewritePresentationProvider } from "@/core/document-rewrite/context";
+import { SubtasksProvider } from "@/core/tasks/context";
+import { useUploadPolicy } from "@/core/uploads";
+
+/**
+ * Shared providers required by every full chat surface.
+ *
+ * Keep this in a small standalone module: importing it from a route must not
+ * eagerly evaluate the complete WorkspaceRoutes tree and all of its pages.
+ */
+export function ChatRuntime({ children }: { children: ReactNode }) {
+  const { data: uploadPolicy } = useUploadPolicy();
+  return (
+    <SubtasksProvider>
+      <DocumentRewritePresentationProvider>
+        <ArtifactsProvider>
+          <PromptInputProvider uploadPolicy={uploadPolicy}>
+            {children}
+          </PromptInputProvider>
+        </ArtifactsProvider>
+      </DocumentRewritePresentationProvider>
+    </SubtasksProvider>
+  );
+}

frontend-web/src/components/workspace/chats/chat-box.tsx

@@ -1,8 +1,8 @@
 import type { Message } from "@langchain/langgraph-sdk";
-import { useQuery } from "@tanstack/react-query";
+import { useQuery, useQueryClient } from "@tanstack/react-query";
 import { FilesIcon, XIcon } from "lucide-react";
 import { usePathname, useSearchParams } from "next/navigation";
-import { useEffect, useMemo, useRef, useState } from "react";
+import { useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
 import type { GroupImperativeHandle } from "react-resizable-panels";
 
 import { ConversationEmptyState } from "@/components/ai-elements/conversation";
@@ -19,13 +19,23 @@ import {
   listThreadArtifacts,
   mergeArtifactPaths,
 } from "@/core/artifacts/listing";
-import { latestInFlightWriteFilePreview } from "@/core/artifacts/write-file-in-flight";
+import {
+  latestCompletedArtifactMutationKey,
+  latestInFlightWriteFilePreview,
+  latestPreparedHtmlArtifact,
+  isWriteFileInFlight,
+} from "@/core/artifacts/write-file-in-flight";
+import {
+  isAutoPreviewableArtifactPath,
+  languageOfStreamingArtifact,
+} from "@/core/artifacts/streaming-write-preview";
 import { shouldAutoOpenWritingArtifact } from "@/core/threads/writing-mode";
 import { getBackendBaseURL } from "@/core/config";
 import { isThreadRagModeLocked, useLocalSettings } from "@/core/settings";
 import { useCitationDisplaySettings } from "@/core/system-settings/hooks";
+import { useIsMobile } from "@/hooks/use-mobile";
+import { filterKnowledgeWikiSources } from "@/core/llmwiki/knowledge-reference";
 import { isSingleRoundRagMessage } from "@/core/threads/use-single-round-rag";
-import { isMultiRoundRagMessage } from "@/core/threads/use-multi-round-rag";
 import { useSkills } from "@/core/skills/hooks";
 import type { SkillDisplayConfig } from "@/core/skills/type";
 import {
@@ -36,6 +46,7 @@ import {
   buildSkillDisplayMap,
   collectRuntimeDisplaySources,
 } from "@/core/skill-display/runtime";
+import { isWordDocumentFile } from "@/core/utils/files";
 import { env } from "@/env";
 import { cn } from "@/lib/utils";
 
@@ -46,6 +57,7 @@ import {
   useArtifacts,
 } from "../artifacts";
 import { ReferenceBatchesContext, useThread } from "../messages/context";
+import { KnowledgeWikiPanel } from "../knowledge-wiki-panel";
 import { SkillDisplaySources } from "../skill-display-sources";
 
 const CLOSE_MODE = { chat: 100, artifacts: 0 };
@@ -84,15 +96,30 @@ const ChatBox: React.FC<{
   children: React.ReactNode;
   threadId: string;
   disableArtifacts?: boolean;
+  writingMode?: boolean;
+  /** Prefer and automatically reveal a specific artifact once it is available. */
+  preferredArtifact?: string | null;
+  /** Keep scanning until the preferred artifact appears (for delayed file persistence). */
+  pollForPreferredArtifact?: boolean;
+  /** Report the real artifact discovered on disk back to the page state. */
+  onPreferredArtifactAvailabilityChange?: (artifact: string | null) => void;
+  /** Stack the artifact below chat on small screens. */
+  responsiveArtifactLayout?: boolean;
 }> = ({
   children,
   threadId,
   disableArtifacts = false,
+  writingMode,
+  preferredArtifact = null,
+  pollForPreferredArtifact = false,
+  onPreferredArtifactAvailabilityChange,
+  responsiveArtifactLayout = false,
 }) => {
   const {
     isMock,
     thread,
     knowledgeReferencesEnabled = false,
+    knowledgeReferences,
   } = useThread();
   const pathname = usePathname();
   const searchParams = useSearchParams();
@@ -102,6 +129,8 @@ const ChatBox: React.FC<{
   }, [searchParams]);
   const threadIdRef = useRef(threadId);
   const openedRequestedArtifactRef = useRef<string | null>(null);
+  const openedPreferredArtifactRef = useRef<string | null>(null);
+  const preferredRunWasLoadingRef = useRef(false);
   const artifactsCountRef = useRef(0);
   const layoutRef = useRef<GroupImperativeHandle>(null);
   const latestReferenceBatchIdRef = useRef<string | null>(null);
@@ -113,9 +142,12 @@ const ChatBox: React.FC<{
   const [pinnedReferenceId, setPinnedReferenceId] = useState<string | null>(null);
   const [backendReferenceBatches, setBackendReferenceBatches] = useState<BackendReferenceBatch[]>([]);
   const [settings] = useLocalSettings();
+  const queryClient = useQueryClient();
+  const isMobile = useIsMobile();
+  const stackArtifactPanel = responsiveArtifactLayout && isMobile;
   // 写作模式专属的产物拦截 / 沙箱打开策略只在开关开启时生效，普通模式保持
   // 原有行为（新产物自动打开 + in-flight 预览不过滤）。
-  const writingModeEnabled = !!settings.context.writing_mode;
+  const writingModeEnabled = writingMode ?? !!settings.context.writing_mode;
   const artifactDirectoryModeEnabled =
     settings.display.artifactDirectoryModeEnabled ?? false;
   const { data: citationDisplay } = useCitationDisplaySettings();
@@ -124,15 +156,15 @@ const ChatBox: React.FC<{
   const ragModeEnabled =
     (referenceModeEntryEnabled && settings.display.ragModeEnabled) ||
     isThreadRagModeLocked(threadId) ||
-    knowledgeReferencesEnabled;
+    knowledgeReferencesEnabled ||
+    !!knowledgeReferences;
   // Frontend RAG modes write their own hidden source tool messages. They use
   // the existing reference panel, but must not request or write reference
   // batches through DeerFlow's backend APIs.
   const hasFrontendRag = useMemo(
     () =>
-      (thread.values.messages ?? []).some(
+      (thread.values.messages ?? []).some((message) =>
-        (message) =>
+        isSingleRoundRagMessage(message),
-          isSingleRoundRagMessage(message) || isMultiRoundRagMessage(message),
       ),
     [thread.values.messages],
   );
@@ -142,7 +174,7 @@ const ChatBox: React.FC<{
   const { skills } = useSkills();
 
   const canScanArtifactDirectory =
-    (artifactDirectoryModeEnabled || !!requestedArtifact) &&
+    (artifactDirectoryModeEnabled || !!requestedArtifact || !!preferredArtifact) &&
     !disableArtifacts &&
     !isMock &&
     !!threadId &&
@@ -151,7 +183,8 @@ const ChatBox: React.FC<{
     queryKey: ["artifact-directory", threadId],
     queryFn: ({ signal }) => listThreadArtifacts(threadId, signal),
     enabled: canScanArtifactDirectory,
-    refetchInterval: thread.isLoading ? 1_500 : false,
+    refetchInterval:
+      thread.isLoading || pollForPreferredArtifact ? 1_500 : false,
     retry: false,
   });
   const checkpointArtifacts = useMemo(
@@ -161,7 +194,7 @@ const ChatBox: React.FC<{
   const checkpointArtifactSignature = checkpointArtifacts.join("\n");
   const availableArtifacts = useMemo(
     () => {
-      if (!artifactDirectoryModeEnabled && !requestedArtifact) {
+      if (!artifactDirectoryModeEnabled && !requestedArtifact && !preferredArtifact) {
         return checkpointArtifacts;
       }
       const discoveredArtifacts = (artifactListingQuery.data?.files ?? []).map(
@@ -174,9 +207,28 @@ const ChatBox: React.FC<{
       artifactDirectoryModeEnabled,
       artifactListingQuery.data?.files,
       checkpointArtifacts,
+      preferredArtifact,
       requestedArtifact,
     ],
   );
+  const availablePreferredArtifact = useMemo(() => {
+    if (!preferredArtifact) return null;
+    const preferredPath = artifactPathname(preferredArtifact);
+    return (
+      [...availableArtifacts]
+        .reverse()
+        .find((artifact) => artifactPathname(artifact) === preferredPath) ?? null
+    );
+  }, [availableArtifacts, preferredArtifact]);
+
+  useEffect(() => {
+    if (!preferredArtifact) return;
+    onPreferredArtifactAvailabilityChange?.(availablePreferredArtifact);
+  }, [
+    availablePreferredArtifact,
+    onPreferredArtifactAvailabilityChange,
+    preferredArtifact,
+  ]);
 
   useEffect(() => {
     if (!canScanArtifactDirectory || thread.isLoading) return;
@@ -201,8 +253,20 @@ const ChatBox: React.FC<{
     selectedArtifact,
     selectedArtifactKey,
     openStreamedArtifact,
+    setGeneratingArtifact,
   } = useArtifacts();
 
+  // Keep the lock even when the user closes the preview while writing.
+  const selectedFileGenerating = Boolean(
+    selectedArtifact && thread.isLoading &&
+    isWriteFileInFlight({ messages: thread.messages ?? [] }, selectedArtifact),
+  );
+  useLayoutEffect(() => {
+    const owner = `chat:${threadId}`;
+    setGeneratingArtifact(owner, selectedFileGenerating ? selectedArtifact : null);
+    return () => setGeneratingArtifact(owner, null);
+  }, [selectedArtifact, selectedFileGenerating, setGeneratingArtifact, threadId]);
+
   const [autoSelectFirstArtifact, setAutoSelectFirstArtifact] = useState(true);
   const skillDisplayMap = useMemo(
     () => (referencesEnabled ? buildSkillDisplayMap(skills) : new Map()),
@@ -241,6 +305,41 @@ const ChatBox: React.FC<{
     threadId,
   ]);
 
+  useEffect(() => {
+    const completedNow =
+      preferredRunWasLoadingRef.current && !thread.isLoading;
+    preferredRunWasLoadingRef.current = thread.isLoading;
+    if (disableArtifacts || !preferredArtifact) {
+      openedPreferredArtifactRef.current = null;
+      return;
+    }
+    if (!availablePreferredArtifact) return;
+    const preferredKey = `${threadId}:${artifactPathname(availablePreferredArtifact)}`;
+    if (openedPreferredArtifactRef.current === preferredKey && !completedNow) {
+      return;
+    }
+    openedPreferredArtifactRef.current = preferredKey;
+    selectArtifact(availablePreferredArtifact, true);
+    setArtifactsOpen(true);
+    setSideTab("document");
+    // The same canonical report path may be overwritten by a later run while
+    // its content query is still inside the five-minute cache window. Invalidate
+    // the real selected path before the detail panel mounts/reopens so it never
+    // shows the previous report after the assistant announces completion.
+    void queryClient.invalidateQueries({
+      queryKey: ["artifact", availablePreferredArtifact, threadId],
+    });
+  }, [
+    availablePreferredArtifact,
+    disableArtifacts,
+    preferredArtifact,
+    queryClient,
+    selectArtifact,
+    setArtifactsOpen,
+    thread.isLoading,
+    threadId,
+  ]);
+
   useEffect(() => {
     if (!shouldFetchBackendReferenceBatches) {
       setBackendReferenceBatches([]);
@@ -292,7 +391,7 @@ const ChatBox: React.FC<{
       ),
     [backendReferenceBatches, skillDisplayMap],
   );
-  const referenceBatches = useMemo(
+  const resolvedReferenceBatches = useMemo(
     () => {
       if (
         shouldFetchBackendReferenceBatches &&
@@ -308,6 +407,18 @@ const ChatBox: React.FC<{
       shouldFetchBackendReferenceBatches,
     ],
   );
+  const referenceBatches = useMemo(() => {
+    if (!knowledgeReferences) return resolvedReferenceBatches;
+    return resolvedReferenceBatches
+      .map((batch) => ({
+        ...batch,
+        sources: filterKnowledgeWikiSources(
+          batch.sources,
+          knowledgeReferences,
+        ),
+      }))
+      .filter((batch) => batch.sources.length > 0);
+  }, [knowledgeReferences, resolvedReferenceBatches]);
   useEffect(() => {
     if (!shouldFetchBackendReferenceBatches) {
       return;
@@ -436,13 +547,50 @@ const ChatBox: React.FC<{
       !disableArtifacts &&
       nextArtifacts.length > 0 &&
       ((artifactDirectoryModeEnabled && threadChanged) ||
-        ((hasNewArtifact || !hadArtifacts) && !selectedArtifact))
+        (hasNewArtifact || !hadArtifacts))
     ) {
-      const newest = nextArtifacts[nextArtifacts.length - 1]!;
+      // The preferred deliverable wins over the generic "newest artifact"
-      if (shouldAutoOpenWritingArtifact(newest, thread.messages, writingModeEnabled)) {
+      // heuristic. Both effects can run in the same commit with a stale null
-        selectArtifact(newest);
+      // selectedArtifact; choosing the preferred path here prevents a sibling
-        setArtifactsOpen(true);
+      // file such as research-plan.json from overwriting report.md.
-        setSideTab("document");
+      const automaticTarget =
+        availablePreferredArtifact ?? nextArtifacts[nextArtifacts.length - 1]!;
+      const isGeneratedHtml =
+        languageOfStreamingArtifact(automaticTarget) === "html" &&
+        isAutoPreviewableArtifactPath(automaticTarget);
+      if (
+        shouldAutoOpenWritingArtifact(
+          automaticTarget,
+          thread.messages,
+          writingModeEnabled,
+        ) &&
+        (isGeneratedHtml || !selectedArtifact)
+      ) {
+        if (isGeneratedHtml) {
+          // HTML is the requested end product, so a later webpage should
+          // replace a previously selected document automatically. Preserve a
+          // matching in-flight write key so a user-closed live preview stays
+          // closed after the tool call completes; otherwise a completed
+          // tool-call id makes a later write to the same path a new preview.
+          const revision = latestCompletedArtifactMutationKey(
+            { messages: thread.messages ?? [] },
+            automaticTarget,
+          );
+          const previewKey =
+            selectedArtifact?.startsWith("write-file:") &&
+            artifactPathname(selectedArtifact) === artifactPathname(automaticTarget) &&
+            selectedArtifactKey
+              ? selectedArtifactKey
+              : revision ?? `artifact:${threadId}:${artifactPathname(automaticTarget)}`;
+          openStreamedArtifact(
+            automaticTarget,
+            previewKey,
+          );
+        } else {
+          selectArtifact(automaticTarget, true);
+          setArtifactsOpen(true);
+          setSideTab("document");
+        }
       }
     }
 
@@ -461,7 +609,12 @@ const ChatBox: React.FC<{
     ) {
       if (thread?.values?.artifacts?.length > 0) {
         setAutoSelectFirstArtifact(false);
-        selectArtifact(thread.values.artifacts[0]!);
+        const firstPreviewableArtifact = thread.values.artifacts.find(
+          (artifact) => !isWordDocumentFile(artifact),
+        );
+        if (firstPreviewableArtifact) {
+          selectArtifact(firstPreviewableArtifact, true);
+        }
       }
     }
   }, [
@@ -470,17 +623,21 @@ const ChatBox: React.FC<{
     autoSelectFirstArtifact,
     deselect,
     selectArtifact,
+    openStreamedArtifact,
     selectedArtifact,
+    selectedArtifactKey,
     artifacts,
     setArtifacts,
+    setArtifactsOpen,
     availableArtifacts,
+    availablePreferredArtifact,
     disableArtifacts,
     thread.messages,
     writingModeEnabled,
   ]);
 
-  // Live sandbox: open as soon as any in-flight write_file has a path or
+  // Live sandbox: open when an in-flight write_file has a usable output path.
-  // the first content bytes — not only when that tool is the last CoT step.
+  // Pathless content stays inline in the CoT, including content-first streams.
   // Agentfx (and other agents) often emit write_file + present_files/bash in
   // the same turn; the collapsed earlier write would otherwise never auto-open.
   const streamingWritePreview = useMemo(
@@ -499,6 +656,25 @@ const ChatBox: React.FC<{
     setSideTab("document");
   }, [openStreamedArtifact, streamingWritePreview]);
 
+  // page_report_template(prepare) creates the output HTML before content
+  // editing starts. Open that real artifact immediately; this also covers
+  // models that use str_replace or whose write_file arguments arrive at once.
+  const preparedHtmlPreview = useMemo(
+    () =>
+      disableArtifacts || !thread.isLoading
+        ? null
+        : latestPreparedHtmlArtifact(thread.messages ?? []),
+    [disableArtifacts, thread.isLoading, thread.messages],
+  );
+  useEffect(() => {
+    if (!preparedHtmlPreview) return;
+    openStreamedArtifact(
+      preparedHtmlPreview.artifactPath,
+      preparedHtmlPreview.previewKey,
+    );
+    setSideTab("document");
+  }, [openStreamedArtifact, preparedHtmlPreview]);
+
   const directoryModeWasEnabledRef = useRef(artifactDirectoryModeEnabled);
   useEffect(() => {
     const wasEnabled = directoryModeWasEnabledRef.current;
@@ -506,12 +682,13 @@ const ChatBox: React.FC<{
     if (
       wasEnabled ||
       !artifactDirectoryModeEnabled ||
-      availableArtifacts.length === 0
+      availableArtifacts.length === 0 ||
+      isWordDocumentFile(availableArtifacts[availableArtifacts.length - 1]!)
     ) {
       return;
     }
     if (!selectedArtifact) {
-      selectArtifact(availableArtifacts[availableArtifacts.length - 1]!);
+      selectArtifact(availableArtifacts[availableArtifacts.length - 1]!, true);
     }
     setArtifactsOpen(true);
     setSideTab("document");
@@ -666,7 +843,7 @@ const ChatBox: React.FC<{
     <ReferenceBatchesContext.Provider value={referenceBatches}>
     <ResizablePanelGroup
       id={`${resizableIdBase}-panels`}
-      orientation="horizontal"
+      orientation={stackArtifactPanel ? "vertical" : "horizontal"}
       defaultLayout={{ chat: 100, artifacts: 0 }}
       groupRef={layoutRef}
     >
@@ -677,6 +854,8 @@ const ChatBox: React.FC<{
         id={`${resizableIdBase}-separator`}
         className={cn(
           "opacity-33 hover:opacity-100",
+          stackArtifactPanel &&
+            "h-px w-full after:inset-x-0 after:inset-y-auto after:top-1/2 after:h-4 after:w-full after:-translate-x-0 after:-translate-y-1/2 after:cursor-row-resize",
           !sidePanelOpen && "pointer-events-none opacity-0",
         )}
       />
@@ -698,7 +877,9 @@ const ChatBox: React.FC<{
               <div className="mb-3 flex shrink-0 items-center justify-between gap-2">
                 <TabsList variant="line">
                   <TabsTrigger value="document">文档</TabsTrigger>
-                  <TabsTrigger value="references">参考文献</TabsTrigger>
+                  <TabsTrigger value="references">
+                    {knowledgeReferences ? "Wiki" : "参考文献"}
+                  </TabsTrigger>
                 </TabsList>
                 <Button
                   size="icon-sm"
@@ -714,11 +895,19 @@ const ChatBox: React.FC<{
               <TabsContent value="document" className="min-h-0 flex-1 overflow-hidden p-0">
                 {artifactDocumentPanel}
               </TabsContent>
-              <TabsContent value="references" className="min-h-0 flex-1 overflow-y-auto p-0">
+              <TabsContent value="references" className="min-h-0 flex-1 overflow-hidden p-0">
-                <ReferencePanel
+                {knowledgeReferences ? (
-                  highlightedReferenceId={pinnedReferenceId}
+                  <KnowledgeWikiPanel
-                  sources={referenceSources}
+                    highlightedReferenceId={pinnedReferenceId}
-                />
+                    selection={knowledgeReferences}
+                    sources={referenceSources}
+                  />
+                ) : (
+                  <ReferencePanel
+                    highlightedReferenceId={pinnedReferenceId}
+                    sources={referenceSources}
+                  />
+                )}
               </TabsContent>
             </Tabs>
           ) : artifactPanelOpen ? (
@@ -737,10 +926,18 @@ const ChatBox: React.FC<{
                   <XIcon />
                 </Button>
               </div>
-              <ReferencePanel
+              {knowledgeReferences ? (
-                highlightedReferenceId={pinnedReferenceId}
+                <KnowledgeWikiPanel
-                sources={referenceSources}
+                  highlightedReferenceId={pinnedReferenceId}
-              />
+                  selection={knowledgeReferences}
+                  sources={referenceSources}
+                />
+              ) : (
+                <ReferencePanel
+                  highlightedReferenceId={pinnedReferenceId}
+                  sources={referenceSources}
+                />
+              )}
             </div>
           ) : null}
         </div>
@@ -1007,8 +1204,7 @@ function buildTurnReferenceBatches(
     // GeneralQA's single-RAG stream sends `docs` before the answer.  Make
     // those cards available immediately, while keeping normal streaming turns
     // on their existing "wait for an answer" behavior.
-    const isFrontendRagTurn =
+    const isFrontendRagTurn = isSingleRoundRagMessage(assistant);
-      isSingleRoundRagMessage(assistant) || isMultiRoundRagMessage(assistant);
     if (nextHumanIndex === -1 && isLoading && !isFrontendRagTurn) {
       continue;
     }
@@ -1059,7 +1255,7 @@ function findFrontendRagAssistant(
     const message = messages[index];
     if (
       message?.type === "ai" &&
-      (isSingleRoundRagMessage(message) || isMultiRoundRagMessage(message))
+      isSingleRoundRagMessage(message)
     ) {
       return message;
     }

frontend-web/src/components/workspace/compact-mode-guide.tsx

@@ -304,7 +304,9 @@ export function CompactModeGuide({
     setCurrent(-1);
   }, [clearPollTimer, releasePromptDialog]);
 
-  if (!eligible) return null;
+  // TDesign 1.18 still handles resize when current=-1 and dereferences an
+  // undefined step. Keep its listener mounted only during an active guide.
+  if (!eligible || current < 0 || current >= stepsRef.current.length) return null;
 
   return (
     <Guide

frontend-web/src/components/workspace/general-qa-sidebar.tsx

@@ -22,6 +22,7 @@ import {
   Download,
   FileJson,
   FileText,
+  Loader2,
   MessageSquare,
   MoreHorizontal,
   Pencil,
@@ -32,14 +33,17 @@ import {
   Share2,
   Star,
   Trash2,
+  X,
 } from "lucide-react";
 import Link from "next/link";
 import { useParams, usePathname, useRouter, useSearchParams } from "next/navigation";
-import { useCallback, useMemo, useState } from "react";
+import { useCallback, useEffect, useMemo, useState } from "react";
 import { useNavigate } from "react-router-dom";
 import { toast } from "sonner";
+import { Select } from "tdesign-react";
 
 import { useTheme } from "@/contexts/ThemeContext";
+import { findNanjingDbSquareId } from "@/core/system-settings/wx-type-filter";
 import { Button } from "@/components/ui/button";
 import {
   Dialog,
@@ -60,6 +64,10 @@ import {
 } from "@/components/ui/dropdown-menu";
 import { Input } from "@/components/ui/input";
 import { ShareConversationDialog } from "@/components/workspace/thread-share-dialogs";
+import {
+  MyProjectThreadBadge,
+  MyProjectThreadIcon,
+} from "@/components/workspace/my-project-thread-indicator";
 import { useAgentsPaginated, type Agent } from "@/core/agents";
 import { getAPIClient } from "@/core/api";
 import { useI18n } from "@/core/i18n/hooks";
@@ -75,6 +83,8 @@ import {
   useToggleThreadPin,
 } from "@/core/threads/hooks";
 import type { AgentThread, AgentThreadState } from "@/core/threads/types";
+import { myProjectConversationInfoOfThread } from "@/core/threads/project-metadata";
+import { useProjectThreadNames } from "@/core/threads/use-project-thread-names";
 import {
   isBootstrapThread,
   isHiddenFromRecentChats,
@@ -87,10 +97,17 @@ import {
 } from "@/core/threads/utils";
 import { buildFullChatNavigationPath } from "@/core/page-layout/chats-iframe-route";
 import { useRouteBase } from "@/core/route-base";
+import { usePublishSquares } from "@/core/system-settings/hooks";
+import { SENTIMENT_AGENT_ID } from "@/core/sentiment-agent/config";
 import { env } from "@/env";
 import { desensitize } from "@/lib/desensitize";
 import { isIMEComposing } from "@/lib/ime";
 import { cn } from "@/lib/utils";
+import { strategyProjectWorkbenchPath } from "@/strategy-selection/project-routes";
+import {
+  mergeRecentWorkspaceItems,
+  useRecentStrategyProjects,
+} from "@/strategy-selection/recent-projects";
 
 import { agentColor } from "./agent-icon-color";
 import { SidebarCollapseButton } from "./workspace-header";
@@ -114,30 +131,74 @@ function SectionLabel({
   onToggle: () => void;
 }) {
   return (
-    <button
+    <div className="flex w-full items-center px-3 py-1 text-[11px] font-semibold tracking-[0.04em] text-muted-foreground/80">
-      type="button"
+      <button
-      onClick={onToggle}
+        type="button"
-      className="flex w-full items-center justify-between px-3 py-1 text-[11px] font-semibold tracking-[0.04em] text-muted-foreground/80 transition-colors hover:text-muted-foreground select-none"
+        onClick={onToggle}
-    >
+        className="flex min-w-0 flex-1 items-center justify-between transition-colors hover:text-muted-foreground select-none"
-      <span className="flex items-center gap-1.5">
+      >
-        <span>{label}</span>
+        <span className="flex min-w-0 items-center gap-1.5">
-        {count != null && (
+          <span className="truncate">{label}</span>
-          <span className="rounded-full bg-muted px-1.5 py-0.5 text-[10px] font-normal text-muted-foreground tabular-nums">
+          {count != null && (
-            {count}
+            <span className="rounded-full bg-muted px-1.5 py-0.5 text-[10px] font-normal text-muted-foreground tabular-nums">
-          </span>
+              {count}
-        )}
+            </span>
-      </span>
+          )}
-      <ChevronDown
+        </span>
-        className={cn(
+        <ChevronDown
-          "size-3.5 shrink-0 transition-transform duration-200",
+          className={cn(
-          collapsed && "-rotate-90",
+            "size-3.5 shrink-0 transition-transform duration-200",
-        )}
+            collapsed && "-rotate-90",
-      />
+          )}
-    </button>
+        />
+      </button>
+    </div>
   );
 }
 
-export function GeneralQaSidebar() {
+type CommonAgent = Pick<Agent, "id" | "name" | "description">;
+
+/** wx 左栏固定的智能体类型；南京-db 广场尚未创建时筛空列表。 */
+const WX_AGENT_TYPE_MINE = "mine";
+const WX_AGENT_TYPE_DEFAULT_SQUARE = "default_square";
+const WX_AGENT_TYPE_NANJING_DB = "nanjing-db";
+const WX_AGENT_TYPE_STORAGE_KEY = "gqa-sidebar:wx-agent-type";
+const WX_AGENT_LIST_PAGE_SIZE = 50;
+
+const WX_AGENT_TYPE_OPTIONS = [
+  { value: WX_AGENT_TYPE_MINE, label: "我的" },
+  { value: WX_AGENT_TYPE_DEFAULT_SQUARE, label: "默认广场" },
+  { value: WX_AGENT_TYPE_NANJING_DB, label: "南京-db" },
+] as const;
+
+type WxAgentType = (typeof WX_AGENT_TYPE_OPTIONS)[number]["value"];
+
+function isWxAgentType(value: string | null | undefined): value is WxAgentType {
+  return WX_AGENT_TYPE_OPTIONS.some((option) => option.value === value);
+}
+
+function readStoredWxAgentType(): WxAgentType {
+  if (typeof window === "undefined") return WX_AGENT_TYPE_MINE;
+  const stored = window.localStorage.getItem(WX_AGENT_TYPE_STORAGE_KEY);
+  return isWxAgentType(stored) ? stored : WX_AGENT_TYPE_MINE;
+}
+
+function resolveWxSquareId(
+  agentType: WxAgentType,
+  squares: Array<{ id: string; name: string }> | undefined,
+  defaultSquareId: string | undefined,
+): string | undefined {
+  if (agentType === WX_AGENT_TYPE_MINE) return undefined;
+  if (agentType === WX_AGENT_TYPE_DEFAULT_SQUARE) return defaultSquareId;
+  return findNanjingDbSquareId(squares);
+}
+
+export function GeneralQaSidebar({
+  wxCommonAgents,
+}: {
+  /** Enables wx's shared Agent Gallery category selection. */
+  wxCommonAgents?: boolean;
+} = {}) {
   const { t } = useI18n();
   const routeBase = useRouteBase();
   // 智能体图标配色分主题：深蓝主题用规范蓝-青系，其它（浅色）保持原高彩度色，互不影响。
@@ -158,17 +219,70 @@ export function GeneralQaSidebar() {
     setAgentsCollapsed((v) => {
       localStorage.setItem("gqa-sidebar:agents-collapsed", String(!v));
       return !v;
-    });
+  });
+
+  const { data: publishSquares, isLoading: wxSquaresLoading } = usePublishSquares({
+    enabled: !!wxCommonAgents,
+  });
+  const [wxAgentType, setWxAgentTypeState] = useState<WxAgentType>(
+    readStoredWxAgentType,
+  );
+  const setWxAgentType = useCallback((next: WxAgentType) => {
+    setWxAgentTypeState(next);
+    window.localStorage.setItem(WX_AGENT_TYPE_STORAGE_KEY, next);
+  }, []);
+  const [wxSearchInput, setWxSearchInput] = useState("");
+  const [wxSearch, setWxSearch] = useState("");
+  useEffect(() => {
+    const timer = window.setTimeout(() => setWxSearch(wxSearchInput.trim()), 300);
+    return () => window.clearTimeout(timer);
+  }, [wxSearchInput]);
+  const wxSquareId = wxCommonAgents
+    ? resolveWxSquareId(
+        wxAgentType,
+        publishSquares?.squares,
+        publishSquares?.default_square_id,
+      )
+    : undefined;
+  const wxFetchEnabled =
+    !!wxCommonAgents &&
+    (wxAgentType === WX_AGENT_TYPE_MINE || Boolean(wxSquareId));
   const toggleChats = () =>
     setChatsCollapsed((v) => {
       localStorage.setItem("gqa-sidebar:chats-collapsed", String(!v));
       return !v;
     });
 
-  // ── 常用智能体取数：置顶 → 我的 → 广场，去重补足到 MAX_FREQUENT（沿用旧逻辑）──
+  // ── 常用智能体取数：wx 走类型筛选；其它页面仍是置顶 → 我的 → 广场 ──
-  const { agents: mine } = useAgentsPaginated({ scope: "mine", page: 1, pageSize: 20 });
+  const { agents: mine } = useAgentsPaginated({
-  const { agents: square } = useAgentsPaginated({ scope: "square", page: 1, pageSize: 20 });
+    scope: "mine",
-  const frequent = useMemo<Agent[]>(() => {
+    page: 1,
+    pageSize: 20,
+    enabled: !wxCommonAgents,
+  });
+  const { agents: square } = useAgentsPaginated({
+    scope: "square",
+    page: 1,
+    pageSize: 20,
+    enabled: !wxCommonAgents,
+  });
+  const {
+    agents: wxAgents,
+    total: wxTotal,
+    isLoading: wxAgentsLoading,
+    isFetching: wxAgentsFetching,
+  } = useAgentsPaginated({
+    scope: wxAgentType === WX_AGENT_TYPE_MINE ? "mine" : "square",
+    page: 1,
+    pageSize: WX_AGENT_LIST_PAGE_SIZE,
+    square: wxSquareId,
+    search: wxSearch || undefined,
+    enabled: wxFetchEnabled,
+  });
+  const frequent = useMemo<CommonAgent[]>(() => {
+    if (wxCommonAgents) {
+      return wxFetchEnabled ? wxAgents : [];
+    }
     const out: Agent[] = [];
     const seen = new Set<string>();
     const add = (agent: Agent | undefined) => {
@@ -180,7 +294,15 @@ export function GeneralQaSidebar() {
     mine.forEach(add);
     square.forEach(add);
     return out;
-  }, [mine, square]);
+  }, [mine, square, wxAgents, wxCommonAgents, wxFetchEnabled]);
+  const wxEmptyHint =
+    wxAgentType === WX_AGENT_TYPE_NANJING_DB && !wxSquareId
+      ? "该类型暂无智能体"
+      : wxSearch
+        ? "未找到匹配的智能体"
+        : wxAgentType === WX_AGENT_TYPE_MINE
+          ? "暂无智能体"
+          : "该广场暂无智能体";
 
   // 当前嵌入的智能体（URL 上的 ?agent=）：用于高亮对应卡片。
   const searchParams = useSearchParams();
@@ -193,6 +315,12 @@ export function GeneralQaSidebar() {
     `${routeBase}/agents`,
     currentSearch,
   );
+  const moreSkillsHref = buildFullChatNavigationPath(
+    `${routeBase}/skills`,
+    currentSearch,
+  );
+  const wxAgentsPageActive = pathname === `${routeBase}/agents`;
+  const wxSkillsPageActive = pathname === `${routeBase}/skills`;
   const moreChatsHref = buildFullChatNavigationPath(chatsBasePath, currentSearch);
 
   // 点击常用智能体 = 在通用问答右侧**原地嵌入**该智能体的对话页：停留在 /chats/new，
@@ -200,21 +328,31 @@ export function GeneralQaSidebar() {
   // 不跳转独立页面、左侧栏不变。每次点击都重开一个干净会话（NewChatContent 的 key）。
   const handleSelectAgent = useCallback(
     (agentId: string) => {
+      if (agentId === SENTIMENT_AGENT_ID) {
+        navigate(
+          buildFullChatNavigationPath(
+            `${routeBase}/agents/${SENTIMENT_AGENT_ID}/chats/new`,
+            currentSearch,
+          ),
+        );
+        return;
+      }
       navigate(
         buildFullChatNavigationPath(
-          routeBase === "/page/workspace"
+          routeBase === "/page/workspace" || wxCommonAgents
             ? `${newChatPath}?agent=${encodeURIComponent(agentId)}`
             : `${routeBase}/agents/${encodeURIComponent(agentId)}/chats/new`,
           currentSearch,
         ),
       );
     },
-    [currentSearch, navigate, newChatPath, routeBase],
+    [currentSearch, navigate, newChatPath, routeBase, wxCommonAgents],
   );
 
   // ── 最近的对话取数 + 搜索 ──
   const { thread_id: threadIdFromPath } = useParams<{ thread_id: string }>();
   const { data: threads = [] } = useThreads();
+  const { data: recentStrategyProjects = [] } = useRecentStrategyProjects();
   const { mutate: deleteThread } = useDeleteThread();
   const { mutate: renameThread } = useRenameThread();
   const { toggle: togglePin } = useToggleThreadPin();
@@ -241,17 +379,28 @@ export function GeneralQaSidebar() {
       sortThreadsPinnedFirst(threads.filter((thread) => !isHiddenFromRecentChats(thread))),
     [threads],
   );
+  const projectThreadNames = useProjectThreadNames(visibleThreads);
+  const recentItems = useMemo(
+    () =>
+      mergeRecentWorkspaceItems(visibleThreads, recentStrategyProjects),
+    [recentStrategyProjects, visibleThreads],
+  );
 
-  const filteredThreads = useMemo(() => {
+  const filteredRecentItems = useMemo(() => {
     const q = query.trim().toLowerCase();
     const list = q
-      ? visibleThreads.filter((thread) =>
+      ? recentItems.filter((item) =>
-          titleOfThread(thread, t.pages.newChat).toLowerCase().includes(q),
+          (item.kind === "thread"
+            ? titleOfThread(item.thread, t.pages.newChat)
+            : item.project.title
+          )
+            .toLowerCase()
+            .includes(q),
         )
-      : visibleThreads;
+      : recentItems;
     // 未搜索时与旧版一致：最多展示 10 条
     return q ? list : list.slice(0, 10);
-  }, [visibleThreads, query, t.pages.newChat]);
+  }, [query, recentItems, t.pages.newChat]);
 
   const handleNewChatClick = (event: React.MouseEvent<HTMLAnchorElement>) => {
     if (event.metaKey || event.ctrlKey || event.shiftKey || event.button === 1) return;
@@ -354,17 +503,88 @@ export function GeneralQaSidebar() {
 
       <div className="min-h-0 flex-1 overflow-y-auto px-2 pb-2">
         {/* ── 常用智能体 ── */}
-        {frequent.length > 0 && (
+        {(wxCommonAgents || frequent.length > 0) && (
           <div className="pt-2">
             <SectionLabel
               label="常用智能体"
+              count={wxCommonAgents ? frequent.length : undefined}
               collapsed={agentsCollapsed}
               onToggle={toggleAgents}
             />
             {!agentsCollapsed && (
               <div className="mt-1 flex flex-col gap-1">
+                {wxCommonAgents && (
+                  <div className="space-y-2 px-1 pb-1">
+                    <Select
+                      size="medium"
+                      value={wxAgentType}
+                      placeholder="智能体类型"
+                      onChange={(value) => {
+                        if (isWxAgentType(String(value))) {
+                          setWxAgentType(String(value) as WxAgentType);
+                        }
+                      }}
+                      className="w-full [&_.t-input]:!h-9 [&_.t-input]:!rounded-lg [&_.t-input]:!border-border [&_.t-input]:!bg-card [&_.t-input]:!px-2.5 [&_.t-input]:!text-[13px]"
+                      popupProps={{
+                        overlayClassName: "z-[80]",
+                        attach: () => document.body,
+                      }}
+                    >
+                      {WX_AGENT_TYPE_OPTIONS.map((option) => (
+                        <Select.Option key={option.value} value={option.value}>
+                          {option.label}
+                        </Select.Option>
+                      ))}
+                    </Select>
+                    <div className="relative">
+                      <Search className="pointer-events-none absolute top-1/2 left-2.5 size-3.5 -translate-y-1/2 text-muted-foreground/60" />
+                      <Input
+                        value={wxSearchInput}
+                        onChange={(e) => setWxSearchInput(e.target.value)}
+                        placeholder="搜索智能体"
+                        className="h-8 rounded-lg border-border bg-card pl-8 pr-8 text-[12px]"
+                        aria-label="搜索智能体"
+                      />
+                      {wxSearchInput && (
+                        <button
+                          type="button"
+                          onClick={() => setWxSearchInput("")}
+                          className="absolute top-1/2 right-2 -translate-y-1/2 text-muted-foreground hover:text-foreground"
+                          title="清除"
+                          aria-label="清除搜索"
+                        >
+                          <X className="size-3.5" />
+                        </button>
+                      )}
+                    </div>
+                  </div>
+                )}
+                {wxCommonAgents &&
+                (wxAgentsLoading ||
+                  (wxAgentType !== WX_AGENT_TYPE_MINE && wxSquaresLoading)) &&
+                frequent.length === 0 ? (
+                  <div className="flex h-20 items-center justify-center gap-2 text-xs text-muted-foreground">
+                    <Loader2 className="size-3.5 animate-spin" />
+                    加载中…
+                  </div>
+                ) : frequent.length === 0 ? (
+                  <p className="px-3 py-2 text-xs text-muted-foreground/70">
+                    {wxCommonAgents ? wxEmptyHint : null}
+                  </p>
+                ) : (
+                <div
+                  className={cn(
+                    "flex max-h-[240px] flex-col gap-1 overflow-y-auto overscroll-contain pr-0.5",
+                    wxCommonAgents && wxAgentsFetching && "opacity-60",
+                  )}
+                >
                 {frequent.map((agent) => {
-                  const isActive = activeAgentId === agent.id;
+                  const isActive =
+                    activeAgentId === agent.id ||
+                    (agent.id === SENTIMENT_AGENT_ID &&
+                      pathname.startsWith(
+                        `${routeBase}/agents/${SENTIMENT_AGENT_ID}/chats`,
+                      ));
                   const { from, to, foreground } = agentColor(agent.id, theme);
                   return (
                     <button
@@ -437,13 +657,50 @@ export function GeneralQaSidebar() {
                     </button>
                   );
                 })}
-                <Link
+                </div>
-                  href={moreAgentsHref}
+                )}
-                  className="flex items-center justify-between rounded-lg px-3 py-1.5 text-[12px] text-muted-foreground/70 transition-colors hover:bg-accent/50 hover:text-foreground"
+                {wxCommonAgents ? (
-                >
+                  <div className="grid grid-cols-2 gap-1.5 px-1 pt-0.5">
-                  <span>{t.common.more}</span>
+                    <Link
-                  <ChevronRight className="size-3.5 shrink-0" />
+                      href={moreAgentsHref}
-                </Link>
+                      className={cn(
+                        "flex h-8 items-center justify-center rounded-lg text-[12px] font-medium transition-colors",
+                        wxAgentsPageActive
+                          ? isDark
+                            ? "bg-[#1a5dad] text-white"
+                            : "bg-primary text-primary-foreground"
+                          : isDark
+                            ? "bg-[#0c3a6e] text-[#d6eaff] hover:bg-[#124a86]"
+                            : "bg-accent text-foreground hover:bg-accent/80",
+                      )}
+                    >
+                      智能体
+                    </Link>
+                    <Link
+                      href={moreSkillsHref}
+                      className={cn(
+                        "flex h-8 items-center justify-center rounded-lg text-[12px] font-medium transition-colors",
+                        wxSkillsPageActive
+                          ? isDark
+                            ? "bg-[#1a5dad] text-white"
+                            : "bg-primary text-primary-foreground"
+                          : isDark
+                            ? "bg-[#0c3a6e] text-[#d6eaff] hover:bg-[#124a86]"
+                            : "bg-accent text-foreground hover:bg-accent/80",
+                      )}
+                    >
+                      技能
+                    </Link>
+                  </div>
+                ) : (
+                  <Link
+                    href={moreAgentsHref}
+                    className="flex items-center justify-between rounded-lg px-3 py-1.5 text-[12px] text-muted-foreground/70 transition-colors hover:bg-accent/50 hover:text-foreground"
+                  >
+                    <span>{t.common.more}</span>
+                    <ChevronRight className="size-3.5 shrink-0" />
+                  </Link>
+                )}
               </div>
             )}
           </div>
@@ -453,7 +710,7 @@ export function GeneralQaSidebar() {
         <div className="mt-3 border-t border-sidebar-border/60 pt-3">
           <SectionLabel
             label={t.sidebar.recentChats}
-            count={visibleThreads.length}
+            count={recentItems.length}
             collapsed={chatsCollapsed}
             onToggle={toggleChats}
           />
@@ -471,29 +728,75 @@ export function GeneralQaSidebar() {
               </div>
 
               <div className="flex flex-col gap-0.5">
-                {filteredThreads.length === 0 ? (
+                {filteredRecentItems.length === 0 ? (
                   <div className="px-3 py-4 text-center text-[12px] text-muted-foreground/70">
                     {query ? "没有匹配的会话" : t.chats.noChats}
                   </div>
                 ) : (
-                  filteredThreads.map((thread) => {
+                  filteredRecentItems.map((item) => {
+                    if (item.kind === "strategy-project") {
+                      const { project } = item;
+                      const href = strategyProjectWorkbenchPath(
+                        "/page/strategy/qa/projects",
+                        project.id,
+                      );
+                      const isActive = href === pathname;
+                      return (
+                        <div
+                          key={`strategy-project:${project.id}`}
+                          className="group/item relative flex items-center"
+                        >
+                          <Link
+                            href={href}
+                            className={cn(
+                              "gq-history-item relative flex min-h-12 min-w-0 flex-1 items-center gap-2 rounded-lg px-2.5 py-1.5 text-[13px] transition-colors",
+                              isActive
+                                ? "gq-history-item--active border border-primary/40 bg-primary/5 font-medium text-primary"
+                                : "text-muted-foreground hover:bg-accent/60 hover:text-foreground",
+                            )}
+                          >
+                            <MyProjectThreadIcon type="strategy" />
+                            <span className="min-w-0 flex-1 flex flex-col items-start gap-0.5">
+                              <span className="w-full truncate">
+                                {desensitize(project.title)}
+                              </span>
+                              <MyProjectThreadBadge
+                                className="mr-4 max-w-[calc(100%_-_1rem)]"
+                                projectName={project.title}
+                                type="strategy"
+                              />
+                            </span>
+                            {isActive && (
+                              <span className="absolute top-1/2 right-1 h-5 w-1 -translate-y-1/2 rounded-full bg-primary" />
+                            )}
+                          </Link>
+                        </div>
+                      );
+                    }
+
+                    const { thread } = item;
                     const href = buildFullChatNavigationPath(
                       pathForThread(thread),
                       currentSearch,
                     );
                     const isActive = href === pathname;
                     const isBoot = isBootstrapThread(thread);
+                    const projectInfo = myProjectConversationInfoOfThread(
+                      thread,
+                      projectThreadNames,
+                    );
                     const pinned = isThreadPinned(thread);
                     const favorited = isThreadFavorite(thread);
                     return (
                       <div
-                        key={thread.thread_id}
+                        key={`thread:${thread.thread_id}`}
                         className="group/item relative flex items-center"
                       >
                         <Link
                           href={href}
                           className={cn(
                             "gq-history-item relative flex h-9 min-w-0 flex-1 items-center gap-2 rounded-lg px-2.5 text-[13px] transition-colors",
+                            projectInfo && "h-auto min-h-12 py-1.5",
                             isActive
                               ? "gq-history-item--active border border-primary/40 bg-primary/5 font-medium text-primary"
                               : "text-muted-foreground hover:bg-accent/60 hover:text-foreground",
@@ -507,6 +810,8 @@ export function GeneralQaSidebar() {
                               )}
                               aria-label="智能体创建会话"
                             />
+                          ) : projectInfo ? (
+                            <MyProjectThreadIcon type={projectInfo.type} />
                           ) : (
                             <MessageSquare
                               className={cn(
@@ -518,8 +823,22 @@ export function GeneralQaSidebar() {
                           {pinned && (
                             <Pin className="size-3 shrink-0 text-muted-foreground/70" />
                           )}
-                          <span className="truncate">
+                          <span
-                            {desensitize(titleOfThread(thread, t.pages.newChat))}
+                            className={cn(
+                              "min-w-0 flex-1",
+                              projectInfo && "flex flex-col items-start gap-0.5",
+                            )}
+                          >
+                            <span className="w-full truncate">
+                              {desensitize(titleOfThread(thread, t.pages.newChat))}
+                            </span>
+                            {projectInfo && (
+                              <MyProjectThreadBadge
+                                className="mr-4 max-w-[calc(100%_-_1rem)]"
+                                projectName={projectInfo.projectName}
+                                type={projectInfo.type}
+                              />
+                            )}
                           </span>
                           {isActive && (
                             <span className="absolute top-1/2 right-1 h-5 w-1 -translate-y-1/2 rounded-full bg-primary" />

frontend-web/src/components/workspace/input-box-submit.test.ts

@@ -0,0 +1,19 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+// Node's type-stripping test runner requires the explicit TypeScript suffix.
+// @ts-expect-error The application compiler intentionally uses extensionless imports.
+import { hasPromptInputPayload } from "./input-box-submit.ts";
+
+test("allows attachment-only prompt submissions", () => {
+  assert.equal(hasPromptInputPayload({ text: "", files: [{}] }), true);
+});
+
+test("rejects submissions with neither text nor attachments", () => {
+  assert.equal(hasPromptInputPayload({ text: "", files: [] }), false);
+  assert.equal(hasPromptInputPayload({ text: "   \n", files: [] }), false);
+});
+
+test("allows text-only prompt submissions", () => {
+  assert.equal(hasPromptInputPayload({ text: "总结一下", files: [] }), true);
+});

frontend-web/src/components/workspace/input-box-submit.ts

@@ -0,0 +1,9 @@
+export type PromptInputPayload = {
+  text: string;
+  files: readonly unknown[];
+};
+
+/** A prompt may contain text, attachments, or both. */
+export function hasPromptInputPayload(message: PromptInputPayload): boolean {
+  return message.text.trim().length > 0 || message.files.length > 0;
+}

frontend-web/src/components/workspace/input-box.tsx

@@ -1,9 +1,10 @@
 "use client";
 
-import type { ChatStatus } from "ai";
+import type { ChatStatus } from "ai";
-import {
+import { toast } from "sonner";
-  BrainCircuitIcon,
+import {
   BookMarkedIcon,
+  BrainCircuitIcon,
   CheckIcon,
   FileTextIcon,
   FolderTreeIcon,
@@ -62,12 +63,23 @@ import {
   DropdownMenuSeparator,
 } from "@/components/ui/dropdown-menu";
 import { apiFetch } from "@/core/api";
-import { getBackendBaseURL } from "@/core/config";
+import { getBackendBaseURL } from "@/core/config";
-import { useI18n } from "@/core/i18n/hooks";
+import {
+  isDocumentRewriteActiveStage,
+  useDocumentRewritePresentation,
+} from "@/core/document-rewrite/context";
+import { useI18n } from "@/core/i18n/hooks";
 import { isHiddenFromUIMessage } from "@/core/messages/utils";
 import { useModels } from "@/core/models/hooks";
+import {
+  REASONING_EFFORTS,
+  resolveModelReasoningEffort,
+  type ReasoningEffort,
+  type StoredReasoningEffort,
+} from "@/core/models/reasoning-effort";
 import type { Model } from "@/core/models/types";
 import type { AgentThreadContext } from "@/core/threads";
+import type { KnowledgeRetrievalMode } from "@/core/threads/knowledge-retrieval-mode";
 import { textOfMessage } from "@/core/threads/utils";
 import { desensitize } from "@/lib/desensitize";
 import { cn } from "@/lib/utils";
@@ -101,25 +113,11 @@ import {
 import { useCitationDisplaySettings } from "@/core/system-settings/hooks";
 
 import { CustomPromptBar } from "./custom-prompt-menu";
-import { useThread } from "./messages/context";
+import { resolveInputMode, type InputMode } from "./input-mode";
-import { ModeHoverGuide } from "./mode-hover-guide";
+import { hasPromptInputPayload } from "./input-box-submit";
-import { Tooltip } from "./tooltip";
+import { useThread } from "./messages/context";
-
+import { ModeHoverGuide } from "./mode-hover-guide";
-type InputMode = "flash" | "thinking" | "pro" | "ultra";
+import { Tooltip } from "./tooltip";
-
-
-function getResolvedMode(
-  mode: InputMode | undefined,
-  supportsThinking: boolean,
-): InputMode {
-  if (!supportsThinking && mode !== "flash") {
-    return "flash";
-  }
-  if (mode) {
-    return mode;
-  }
-  return supportsThinking ? "pro" : "flash";
-}
 
 export function InputBox({
   className,
@@ -130,20 +128,22 @@ export function InputBox({
   extraHeader,
   isNewThread,
   threadId,
-  initialValue,
+  initialValue,
-  onContextChange,
+  onContextChange,
-  onFollowupsVisibilityChange,
+  onFollowupsPresenceChange,
-  onSubmit,
+  followupsDisplayAllowed = true,
+  onSubmit,
   onStop,
   promptPrefix,
   agentSelector,
-  knowledgeSelector,
+  knowledgeSelector,
+  knowledgeRetrieval,
+  knowledgeSuggestedQuestions = [],
   extraModels = [],
   assistantId,
   hideAdminRecommendedQuestions,
   compact,
   hideContextTools,
-  hideMemoryTool = true,
   ...props
 }: Omit<ComponentProps<typeof PromptInput>, "onSubmit"> & {
   assistantId?: string | null;
@@ -151,23 +151,17 @@ export function InputBox({
   /** 紧凑模式（正常 App）新对话落地态：去掉旋转彩边、用 CM 参考图的白卡输入框，
    *  并在推荐问题上方加「试试这些高频业务场景」标题。仅落地态生效，默认 false。 */
   compact?: boolean;
-  /** 隐藏输入框工具条上的「写作 / 记忆 / 参考文献」上下文开关按钮（任务深链工作区等
+  /** 隐藏输入框工具条上的「写作 / 参考文献」上下文开关按钮（任务深链工作区等
    *  受控场景用；文件/模型等其他按钮不受影响）。 */
   hideContextTools?: boolean;
-  /**
-   * 仅控制「记忆」开关的可见性。产品当前全局隐藏，传入 false 即可无损恢复。
-   * 写作和参考文献开关不受影响。
-   */
-  hideMemoryTool?: boolean;
   disabled?: boolean;
   context: Omit<
     AgentThreadContext,
     "thread_id" | "is_plan_mode" | "thinking_enabled" | "subagent_enabled"
   > & {
     mode: "flash" | "thinking" | "pro" | "ultra" | undefined;
-    reasoning_effort?: "minimal" | "low" | "medium" | "high";
+    reasoning_effort?: StoredReasoningEffort;
     writing_mode?: boolean;
-    memory_injection_enabled?: boolean;
   };
   extraHeader?: React.ReactNode;
   isNewThread?: boolean;
@@ -182,12 +176,18 @@ export function InputBox({
       "thread_id" | "is_plan_mode" | "thinking_enabled" | "subagent_enabled"
     > & {
       mode: "flash" | "thinking" | "pro" | "ultra" | undefined;
-      reasoning_effort?: "minimal" | "low" | "medium" | "high";
+      reasoning_effort?: StoredReasoningEffort;
       writing_mode?: boolean;
-      memory_injection_enabled?: boolean;
     },
-  ) => void;
+  ) => void;
-  onFollowupsVisibilityChange?: (visible: boolean) => void;
+  /**
+   * Whether generated follow-up questions may be rendered. Hosts with a
+   * scrollable transcript disable this while the user is reviewing history;
+   * the generated questions are retained and reappear on returning to bottom.
+   */
+  followupsDisplayAllowed?: boolean;
+  /** Reports whether follow-ups need layout space, even while scroll-hidden. */
+  onFollowupsPresenceChange?: (present: boolean) => void;
   onSubmit?: (message: PromptInputMessage) => void;
   onStop?: () => void;
   /**
@@ -209,8 +209,19 @@ export function InputBox({
     selectedAgentId: string | null;
     onAgentChange: (agentId: string | null) => void;
   };
-  /** WeKnora-style knowledge-space picker rendered inside the composer toolbar. */
+  /** WeKnora-style knowledge-space picker rendered inside the composer toolbar. */
-  knowledgeSelector?: ReactNode;
+  knowledgeSelector?: ReactNode;
+  /** Per-thread ordinary-knowledge retrieval mode. Omit when unavailable. */
+  knowledgeRetrieval?: {
+    mode: KnowledgeRetrievalMode;
+    smartAvailable: boolean;
+    smartAvailabilityReason: string;
+    /** The administrator policy used only when a new conversation is created. */
+    smartIsDefault: boolean;
+    onModeChange: (mode: KnowledgeRetrievalMode) => void;
+  };
+  /** High-value starter questions derived from the currently selected spaces. */
+  knowledgeSuggestedQuestions?: string[];
   /** Page-scoped model choices implemented outside the DeerFlow model API. */
   extraModels?: Model[];
 }) {
@@ -228,11 +239,25 @@ export function InputBox({
     return singleRoundRagActive ? extraModels : models;
   }, [extraModels, models, singleRoundRagActive]);
   const { thread, isMock } = useThread();
+  const rewritePresentation = useDocumentRewritePresentation();
   const { textInput } = usePromptInputController();
   const promptRootRef = useRef<HTMLDivElement | null>(null);
   const { data: citationDisplay } = useCitationDisplaySettings();
   const referenceModeEntryEnabled =
     citationDisplay?.reference_mode_enabled ?? false;
+  const documentRewriteActive = useMemo(
+    () =>
+      rewritePresentation?.forThread(threadId).some((item) =>
+        isDocumentRewriteActiveStage(item.stage),
+      ) ?? false,
+    [rewritePresentation, threadId],
+  );
+  // Keep normal chat generation authoritative when both states overlap.  In
+  // the usual rewrite-only case this gives the composer the same square stop
+  // affordance as a normal streamed reply.
+  const composerStatus: ChatStatus = documentRewriteActive
+    ? "streaming"
+    : status;
 
   const [followups, setFollowups] = useState<string[]>([]);
   const [followupsHidden, setFollowupsHidden] = useState(false);
@@ -247,8 +272,10 @@ export function InputBox({
 
   const { questions: recommendedQuestions } = useRecommendedQuestions();
   const userPreferences = useUserPreferences();
-  const showAdminRecommendedQuestions =
+  const followupsEnabled = userPreferences.followup_suggestions_enabled;
-    !hideAdminRecommendedQuestions &&
+  const showAdminRecommendedQuestions =
+    !hideAdminRecommendedQuestions &&
+    knowledgeSuggestedQuestions.length === 0 &&
     !userPreferences.hide_admin_prompt_prefix &&
     recommendedQuestions.length > 0;
 
@@ -264,12 +291,20 @@ export function InputBox({
     const currentModel = modelOptions.find((m) => m.name === context.model_name);
     const fallbackModel = currentModel ?? modelOptions[0]!;
     const supportsThinking = fallbackModel.supports_thinking ?? false;
+    const supportsReasoningEffort =
+      fallbackModel.supports_reasoning_effort ?? false;
     const nextModelName = fallbackModel.name;
-    const nextMode = getResolvedMode(context.mode, supportsThinking);
+    const nextMode = resolveInputMode(context.mode, supportsThinking);
+    const nextReasoningEffort = resolveModelReasoningEffort(
+      supportsReasoningEffort,
+      context.reasoning_effort,
+      context.model_name !== nextModelName,
+    );
 
     if (
       context.model_name === nextModelName &&
       context.mode === nextMode &&
+      context.reasoning_effort === nextReasoningEffort &&
       context.execution_profile === fallbackModel.execution_profile
     ) {
       return;
@@ -279,6 +314,7 @@ export function InputBox({
       ...context,
       model_name: nextModelName,
       mode: nextMode,
+      reasoning_effort: nextReasoningEffort,
       execution_profile: fallbackModel.execution_profile,
     });
   }, [context, modelOptions, multiRoundRagActive, onContextChange]);
@@ -303,6 +339,31 @@ export function InputBox({
     [selectedModel],
   );
 
+  const selectedReasoningEffort = useMemo(
+    () =>
+      resolveModelReasoningEffort(
+        supportReasoningEffort,
+        context.reasoning_effort,
+      ),
+    [context.reasoning_effort, supportReasoningEffort],
+  );
+
+  const reasoningEffortIndex = Math.max(
+    0,
+    REASONING_EFFORTS.indexOf(selectedReasoningEffort ?? "xhigh"),
+  );
+  const reasoningEffortThumbLeft =
+    reasoningEffortIndex === 0
+      ? "0.5rem"
+      : reasoningEffortIndex === 1
+        ? "50%"
+        : "calc(100% - 0.5rem)";
+  const reasoningEffortLabel =
+    selectedReasoningEffort === "low"
+      ? t.inputBox.reasoningEffortLow
+      : selectedReasoningEffort === "medium"
+        ? t.inputBox.reasoningEffortMedium
+        : t.inputBox.reasoningEffortXHigh;
   const handleModelSelect = useCallback(
     (model_name: string) => {
       const model = modelOptions.find((m) => m.name === model_name);
@@ -312,8 +373,12 @@ export function InputBox({
       onContextChange?.({
         ...context,
         model_name,
-        mode: getResolvedMode(context.mode, model.supports_thinking ?? false),
+        mode: resolveInputMode(context.mode, model.supports_thinking ?? false),
-        reasoning_effort: context.reasoning_effort,
+        reasoning_effort: resolveModelReasoningEffort(
+          model.supports_reasoning_effort ?? false,
+          context.reasoning_effort,
+          model_name !== context.model_name,
+        ),
         execution_profile: model.execution_profile,
       });
       setModelDialogOpen(false);
@@ -328,22 +393,24 @@ export function InputBox({
       onContextChange?.({
         ...context,
         model_name: ordinaryModel?.name ?? context.model_name,
-        mode: getResolvedMode(
+        mode: resolveInputMode(
           mode,
           ordinaryModel?.supports_thinking ?? supportThinking,
         ),
-        reasoning_effort:
+        reasoning_effort: resolveModelReasoningEffort(
-          mode === "ultra"
+          ordinaryModel?.supports_reasoning_effort ?? supportReasoningEffort,
-            ? "high"
+          context.reasoning_effort,
-            : mode === "pro"
+        ),
-              ? "medium"
-              : mode === "thinking"
-                ? "low"
-                : "minimal",
         execution_profile: undefined,
       });
     },
-    [onContextChange, context, models, supportThinking],
+    [
+      onContextChange,
+      context,
+      models,
+      supportThinking,
+      supportReasoningEffort,
+    ],
   );
 
   const handleSingleRoundRagSelect = useCallback(() => {
@@ -357,7 +424,7 @@ export function InputBox({
     onContextChange?.({
       ...context,
       model_name: ragModel.name,
-      mode: getResolvedMode(
+      mode: resolveInputMode(
         context.mode,
         ragModel.supports_thinking ?? false,
       ),
@@ -373,7 +440,7 @@ export function InputBox({
   }, [context, onContextChange]);
 
   const handleReasoningEffortSelect = useCallback(
-    (effort: "minimal" | "low" | "medium" | "high") => {
+    (effort: ReasoningEffort) => {
       onContextChange?.({
         ...context,
         reasoning_effort: effort,
@@ -397,16 +464,13 @@ export function InputBox({
     });
   }, [artifactDirectoryModeEnabled, setLocalSettings]);
 
-  const memoryInjectionEnabled = context.memory_injection_enabled ?? true;
+  const smartKnowledgeRetrievalActive =
-  const handleMemoryInjectionToggle = useCallback(() => {
+    knowledgeRetrieval?.mode === "smart_reasoning";
-    onContextChange?.({
+  const ragModeLocked =
-      ...context,
+    !smartKnowledgeRetrievalActive && isThreadRagModeLocked(threadId);
-      memory_injection_enabled: !memoryInjectionEnabled,
+  const ragModeEnabled =
-    });
+    !smartKnowledgeRetrievalActive &&
-  }, [context, memoryInjectionEnabled, onContextChange]);
+    (localSettings.display.ragModeEnabled || ragModeLocked);
-
-  const ragModeLocked = isThreadRagModeLocked(threadId);
-  const ragModeEnabled = localSettings.display.ragModeEnabled || ragModeLocked;
   const handleRagModeToggle = useCallback(() => {
     if (ragModeLocked) {
       return;
@@ -422,15 +486,19 @@ export function InputBox({
     });
   }, [contextCompressionEnabled, setLocalSettings]);
 
-  const handleSubmit = useCallback(
+  const handleSubmit = useCallback(
-    async (message: PromptInputMessage) => {
+    async (message: PromptInputMessage) => {
-      if (status === "streaming") {
+      if (composerStatus === "streaming") {
-        onStop?.();
+        toast.info("正在生成中，请等待当前回复完成后再发送。", {
-        return;
+          description: "已保留您输入的内容。",
-      }
+        });
-      if (!message.text) {
+        // Reject rather than resolve: PromptInput treats a resolved submit as
-        return;
+        // accepted and clears its draft. The current message has not been sent.
-      }
+        throw new Error("Cannot submit while a response is streaming.");
+      }
+      if (!hasPromptInputPayload(message)) {
+        return;
+      }
       setFollowups([]);
       setFollowupsHidden(false);
       setFollowupsLoading(false);
@@ -440,14 +508,19 @@ export function InputBox({
 
       // Guard against submitting before the initial model auto-selection
       // effect has flushed thread settings to storage/state.
-      if (resolvedModelName && context.model_name !== resolvedModelName) {
+      if (
+        resolvedModelName &&
+        (context.model_name !== resolvedModelName ||
+          context.reasoning_effort !== selectedReasoningEffort)
+      ) {
         onContextChange?.({
           ...context,
           model_name: resolvedModelName,
-          mode: getResolvedMode(
+          mode: resolveInputMode(
             context.mode,
             selectedModel?.supports_thinking ?? false,
           ),
+          reasoning_effort: selectedReasoningEffort,
           execution_profile: selectedModel?.execution_profile,
         });
         setTimeout(() => onSubmit?.(message), 0);
@@ -458,26 +531,40 @@ export function InputBox({
     },
     [
       context,
-      onContextChange,
+      onContextChange,
-      onSubmit,
+      onSubmit,
-      onStop,
+      composerStatus,
-      resolvedModelName,
+      resolvedModelName,
       ragModeEnabled,
       selectedModel?.supports_thinking,
       selectedModel?.execution_profile,
+      selectedReasoningEffort,
       status,
       threadId,
     ],
   );
 
+  const handleStopCurrentGeneration = useCallback(() => {
+    if (status === "streaming") {
+      onStop?.();
+      return;
+    }
+    if (!documentRewriteActive || !rewritePresentation) return;
+    void rewritePresentation.cancelActiveForThread(threadId).then((result) => {
+      if (!result.cancelled) {
+        toast.error(result.error ?? "停止全文改写失败，请稍后重试。");
+      }
+    });
+  }, [documentRewriteActive, onStop, rewritePresentation, status, threadId]);
+
   const requestFormSubmit = useCallback(() => {
     const form = promptRootRef.current?.querySelector("form");
     form?.requestSubmit();
   }, []);
 
-  const handleFollowupClick = useCallback(
+  const handleFollowupClick = useCallback(
-    (suggestion: string) => {
+    (suggestion: string) => {
-      if (status === "streaming") {
+      if (composerStatus === "streaming") {
         return;
       }
       const current = (textInput.value ?? "").trim();
@@ -490,7 +577,7 @@ export function InputBox({
       setFollowupsHidden(true);
       setTimeout(() => requestFormSubmit(), 0);
     },
-    [requestFormSubmit, status, textInput],
+    [composerStatus, requestFormSubmit, textInput],
   );
 
   const confirmReplaceAndSend = useCallback(() => {
@@ -521,32 +608,43 @@ export function InputBox({
     setTimeout(() => requestFormSubmit(), 0);
   }, [pendingSuggestion, requestFormSubmit, textInput]);
 
-  const showFollowups =
+  const followupsPresent =
-    !disabled &&
+    followupsEnabled &&
-    !isNewThread &&
+    !disabled &&
-    !selectedSingleRoundRag &&
+    !isNewThread &&
-    !followupsHidden &&
+    !selectedSingleRoundRag &&
-    (followupsLoading || followups.length > 0);
+    !followupsHidden &&
-
+    (followupsLoading || followups.length > 0);
-  const followupsVisibilityChangeRef = useRef(onFollowupsVisibilityChange);
+  const showFollowups = followupsDisplayAllowed && followupsPresent;
+
+  const followupsPresenceChangeRef = useRef(onFollowupsPresenceChange);
+
+  useEffect(() => {
+    followupsPresenceChangeRef.current = onFollowupsPresenceChange;
+  }, [onFollowupsPresenceChange]);
+
+  useEffect(() => {
+    followupsPresenceChangeRef.current?.(followupsPresent);
+  }, [followupsPresent]);
+
+  useEffect(() => {
+    return () => followupsPresenceChangeRef.current?.(false);
+  }, []);
 
   useEffect(() => {
-    followupsVisibilityChangeRef.current = onFollowupsVisibilityChange;
+    if (followupsEnabled) return;
-  }, [onFollowupsVisibilityChange]);
+    setFollowups([]);
-
+    setFollowupsLoading(false);
-  useEffect(() => {
+    setFollowupsHidden(true);
-    followupsVisibilityChangeRef.current?.(showFollowups);
+    setConfirmOpen(false);
-  }, [showFollowups]);
+    setPendingSuggestion(null);
-
+  }, [followupsEnabled]);
-  useEffect(() => {
-    return () => followupsVisibilityChangeRef.current?.(false);
-  }, []);
 
   useEffect(() => {
     const streaming = status === "streaming";
     const wasStreaming = wasStreamingRef.current;
     wasStreamingRef.current = streaming;
-    if (!wasStreaming || streaming) {
+    if (!followupsEnabled || !wasStreaming || streaming) {
       return;
     }
 
@@ -598,6 +696,7 @@ export function InputBox({
         return (await res.json()) as { suggestions?: string[] };
       })
       .then((data) => {
+        if (controller.signal.aborted) return;
         const suggestions = (data.suggestions ?? [])
           .map((s) => (typeof s === "string" ? s.trim() : ""))
           .filter((s) => s.length > 0)
@@ -605,24 +704,51 @@ export function InputBox({
         setFollowups(suggestions);
       })
       .catch(() => {
+        if (controller.signal.aborted) return;
         setFollowups([]);
       })
       .finally(() => {
+        if (controller.signal.aborted) return;
         setFollowupsLoading(false);
       });
 
-    return () => controller.abort();
+    return () => {
-  }, [context.model_name, disabled, isMock, selectedSingleRoundRag, status, thread.messages, threadId]);
+      controller.abort();
+      setFollowupsLoading(false);
+    };
+  }, [context.model_name, disabled, followupsEnabled, isMock, selectedSingleRoundRag, status, thread.messages, threadId]);
 
   return (
     <div ref={promptRootRef} className="relative flex flex-col gap-6">
-      {extraHeader && (
+      {extraHeader && (
         <div className="flex items-center justify-center">
           {extraHeader}
         </div>
-      )}
+      )}
-
+
-      {isNewThread && searchParams.get("mode") !== "skill" && showAdminRecommendedQuestions && (
+      {isNewThread && searchParams.get("mode") !== "skill" && knowledgeSuggestedQuestions.length > 0 && (
+        <div className="px-4 mb-[10px]">
+          <div className="mb-2 text-center text-xs text-muted-foreground">基于已选知识空间，试试这样问</div>
+          <div className="flex flex-wrap justify-center gap-2.5">
+            {knowledgeSuggestedQuestions.slice(0, 4).map((question) => (
+              <button
+                key={question}
+                type="button"
+                className="max-w-full rounded-full border border-primary/20 bg-primary/5 px-4 py-2 text-left text-sm text-foreground transition-colors hover:bg-primary/10"
+                onClick={() => {
+                  textInput.setInput(question);
+                  setFollowupsHidden(true);
+                  setTimeout(() => requestFormSubmit(), 0);
+                }}
+              >
+                {question}
+              </button>
+            ))}
+          </div>
+        </div>
+      )}
+
+      {isNewThread && searchParams.get("mode") !== "skill" && showAdminRecommendedQuestions && (
         <div className="flex flex-wrap justify-center gap-2.5 px-4 mb-[10px]">
           {recommendedQuestions.map((q) => (
             <button
@@ -733,12 +859,12 @@ export function InputBox({
         </PromptInputBody>
         <PromptInputFooter
           className={cn(
-            "flex items-center border-t-0 px-2 pt-1 pb-1.5",
+            "flex flex-wrap items-center gap-y-2 border-t-0 px-2 pt-1 pb-1.5",
             compact && "gap-2 px-3 pt-1.5 pb-3",
           )}
         >
           <PromptInputTools
-            className={cn("gap-1.5", compact && "flex-1 flex-wrap gap-2")}
+            className={cn("min-w-0 flex-1 flex-wrap gap-1.5", compact && "gap-2")}
           >
             {/* TODO: Add more connectors here
           <PromptInputActionMenu>
@@ -813,62 +939,42 @@ export function InputBox({
                 <span className="text-xs font-normal">文件</span>
               </PromptInputButton>
             </Tooltip>}
-            {!frontendRagActive && !hideContextTools && !hideMemoryTool && <Tooltip
+            {referenceModeEntryEnabled &&
-              content={
+              !frontendRagActive &&
-                memoryInjectionEnabled
+              !smartKnowledgeRetrievalActive &&
-                  ? "记忆注入已开启：对话前会注入历史记忆"
+              !hideContextTools && (
-                  : "记忆注入已关闭：本次对话不注入记忆"
+                <Tooltip
-              }
+                  content={
-            >
+                    ragModeEnabled
-              <PromptInputButton
+                      ? "参考文献模式已开启：检索类结果会按编号引用展示"
-                className={cn(
+                      : "参考文献模式已关闭：点击开启"
-                  "gap-1.5! rounded-full px-3! shadow-none",
+                  }
-                  compact && "rounded-lg px-2.5! py-1! text-[11px] font-medium",
+                >
-                  memoryInjectionEnabled
+                  <PromptInputButton
-                    ? "border border-blue-300 bg-blue-50 text-blue-700 ring-1 ring-blue-300/35 hover:bg-blue-100 dark:border-cyan-300/70 dark:bg-cyan-400/20 dark:text-cyan-50 dark:ring-cyan-300/35 dark:shadow-[0_0_0_1px_rgba(34,211,238,0.18),0_0_18px_rgba(34,211,238,0.18)] dark:hover:bg-cyan-400/25"
+                    type="button"
-                    : compact
+                    aria-pressed={ragModeEnabled}
-                      ? "border border-transparent bg-muted/40 text-muted-foreground hover:bg-muted hover:text-foreground"
+                    disabled={ragModeLocked || disabled}
-                      : "border-0 bg-transparent text-muted-foreground hover:bg-muted/70 hover:text-foreground dark:text-slate-400 dark:hover:bg-slate-700/70 dark:hover:text-slate-100",
+                    className={cn(
-                )}
+                      "gap-1.5! rounded-full px-3! shadow-none",
-                onClick={handleMemoryInjectionToggle}
+                      compact &&
-              >
+                        "rounded-lg px-2.5! py-1! text-[11px] font-medium",
-                {memoryInjectionEnabled && (
+                      ragModeLocked && "cursor-not-allowed opacity-80",
-                  <CheckIcon className="size-3 text-blue-700 dark:text-cyan-50" />
+                      ragModeEnabled
-                )}
+                        ? "border border-emerald-300 bg-emerald-50 text-emerald-700 hover:bg-emerald-100 dark:border-emerald-700 dark:bg-emerald-950/40 dark:text-emerald-200"
-                <BrainCircuitIcon className="size-3" />
+                        : compact
-                <span className="text-xs font-normal">记忆</span>
+                          ? "border border-transparent bg-muted/40 text-muted-foreground hover:bg-muted hover:text-foreground"
-              </PromptInputButton>
+                          : "border-0 bg-transparent text-muted-foreground hover:bg-muted/70 hover:text-foreground dark:text-slate-400 dark:hover:bg-slate-700/70 dark:hover:text-slate-100",
-            </Tooltip>}
+                    )}
-            {referenceModeEntryEnabled && !frontendRagActive && !hideContextTools && <Tooltip
+                    onClick={handleRagModeToggle}
-              content={
+                  >
-                ragModeEnabled
+                    {ragModeEnabled && (
-                  ? "参考文献模式已开启：检索类结果会按编号引用展示"
+                      <CheckIcon className="size-3 text-emerald-700 dark:text-emerald-200" />
-                  : "参考文献模式已关闭：点击开启"
+                    )}
-              }
+                    <BookMarkedIcon className="size-3" />
-            >
+                    <span className="text-xs font-normal">参考文献</span>
-              <PromptInputButton
+                  </PromptInputButton>
-                type="button"
+                </Tooltip>
-                aria-pressed={ragModeEnabled}
+              )}
-                disabled={ragModeLocked || disabled}
-                className={cn(
-                  "gap-1.5! rounded-full px-3! shadow-none",
-                  compact && "rounded-lg px-2.5! py-1! text-[11px] font-medium",
-                  ragModeLocked && "cursor-not-allowed opacity-80",
-                  ragModeEnabled
-                    ? "border border-emerald-300 bg-emerald-50 text-emerald-700 hover:bg-emerald-100 dark:border-emerald-700 dark:bg-emerald-950/40 dark:text-emerald-200"
-                    : compact
-                      ? "border border-transparent bg-muted/40 text-muted-foreground hover:bg-muted hover:text-foreground"
-                      : "border-0 bg-transparent text-muted-foreground hover:bg-muted/70 hover:text-foreground dark:text-slate-400 dark:hover:bg-slate-700/70 dark:hover:text-slate-100",
-                )}
-                onClick={handleRagModeToggle}
-              >
-                {ragModeEnabled && (
-                  <CheckIcon className="size-3 text-emerald-700 dark:text-emerald-200" />
-                )}
-                <BookMarkedIcon className="size-3" />
-                <span className="text-xs font-normal">参考文献</span>
-              </PromptInputButton>
-            </Tooltip>}
             {!frontendRagActive && <Tooltip
               content={
                 contextCompressionEnabled
@@ -1161,124 +1267,63 @@ export function InputBox({
                 </DropdownMenuGroup>
               </PromptInputActionMenuContent>
             </PromptInputActionMenu>
-            {!frontendRagActive && supportReasoningEffort && context.mode !== "flash" && (
+            {!frontendRagActive &&
-              <PromptInputActionMenu>
+              supportReasoningEffort &&
-                <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 border-border px-2.5! py-1! text-[13px]")}>
+              context.mode !== "flash" && (
-                  <div className="text-xs font-normal">
+                <PromptInputActionMenu>
-                    {t.inputBox.reasoningEffort}:
+                  <PromptInputActionMenuTrigger
-                    {context.reasoning_effort === "minimal" &&
+                    aria-label={`${t.inputBox.reasoningEffortSelect}: ${reasoningEffortLabel}`}
-                      " " + t.inputBox.reasoningEffortMinimal}
+                    className={cn(
-                    {context.reasoning_effort === "low" &&
+                      "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",
-                      " " + t.inputBox.reasoningEffortLow}
+                      compact &&
-                    {context.reasoning_effort === "medium" &&
+                        "rounded-lg border border-border px-2.5! py-1! text-[13px]",
-                      " " + t.inputBox.reasoningEffortMedium}
+                    )}
-                    {context.reasoning_effort === "high" &&
+                  >
-                      " " + t.inputBox.reasoningEffortHigh}
+                    <div className="flex items-center gap-1.5 text-xs font-medium">
-                  </div>
+                      <SparklesIcon className="size-3" />
-                </PromptInputActionMenuTrigger>
+                      <span className="text-foreground">
-                <PromptInputActionMenuContent className="w-70">
+                        {reasoningEffortLabel}
-                  <DropdownMenuGroup>
+                      </span>
-                    <DropdownMenuLabel className="text-muted-foreground text-xs">
+                    </div>
-                      {t.inputBox.reasoningEffort}
+                  </PromptInputActionMenuTrigger>
-                    </DropdownMenuLabel>
+                  <PromptInputActionMenuContent className="w-56 p-3">
-                    <PromptInputActionMenu>
+                    <div className="flex items-center justify-between gap-3 px-1">
-                      <PromptInputActionMenuItem
+                      <span className="text-xs text-muted-foreground">
-                        className={cn(
+                        {t.inputBox.reasoningEffortSelect}
-                          context.reasoning_effort === "minimal"
+                      </span>
-                            ? "text-accent-foreground"
+                      <span className="text-sm font-semibold text-violet-600 dark:text-violet-300">
-                            : "text-muted-foreground/65",
+                        {reasoningEffortLabel}
-                        )}
+                      </span>
-                        onSelect={() => handleReasoningEffortSelect("minimal")}
+                    </div>
-                      >
+                    <div className="mt-2 px-1">
-                        <div className="flex flex-col gap-2">
+                      <div className="relative h-9 w-full">
-                          <div className="flex items-center gap-1 font-bold">
+                        <input
-                            {t.inputBox.reasoningEffortMinimal}
+                          type="range"
-                          </div>
+                          aria-label={`${t.inputBox.reasoningEffortSelect}: ${selectedModel?.display_name || selectedModel?.name || ""}`}
-                          <div className="pl-2 text-xs">
+                          aria-valuetext={reasoningEffortLabel}
-                            {t.inputBox.reasoningEffortMinimalDescription}
+                          className="peer absolute inset-x-0 -inset-y-1 z-10 h-auto w-full cursor-grab touch-none opacity-0 active:cursor-grabbing"
-                          </div>
+                          value={reasoningEffortIndex}
-                        </div>
+                          min={0}
-                        {context.reasoning_effort === "minimal" ? (
+                          max={2}
-                          <CheckIcon className="ml-auto size-4" />
+                          step={1}
-                        ) : (
+                          onChange={(event) => {
-                          <div className="ml-auto size-4" />
+                            const effort =
-                        )}
+                              REASONING_EFFORTS[Number(event.currentTarget.value)];
-                      </PromptInputActionMenuItem>
+                            if (effort) handleReasoningEffortSelect(effort);
-                      <PromptInputActionMenuItem
+                          }}
-                        className={cn(
+                        />
-                          context.reasoning_effort === "low"
+                        <div className="pointer-events-none absolute inset-x-2 top-1/2 h-1.5 -translate-y-1/2 rounded-full bg-gradient-to-r from-sky-400 via-violet-500 to-fuchsia-500 peer-focus-visible:ring-2 peer-focus-visible:ring-violet-500/70 peer-focus-visible:ring-offset-2" />
-                            ? "text-accent-foreground"
+                        <div
-                            : "text-muted-foreground/65",
+                          className="pointer-events-none absolute top-1/2 size-5 -translate-x-1/2 -translate-y-1/2 rounded-full border-2 border-white bg-violet-600 shadow-md peer-active:scale-110 dark:border-slate-800"
-                        )}
+                          style={{ left: reasoningEffortThumbLeft }}
-                        onSelect={() => handleReasoningEffortSelect("low")}
+                        />
-                      >
+                      </div>
-                        <div className="flex flex-col gap-2">
+                    </div>
-                          <div className="flex items-center gap-1 font-bold">
+                  </PromptInputActionMenuContent>
-                            {t.inputBox.reasoningEffortLow}
+                </PromptInputActionMenu>
-                          </div>
+              )}
-                          <div className="pl-2 text-xs">
-                            {t.inputBox.reasoningEffortLowDescription}
-                          </div>
-                        </div>
-                        {context.reasoning_effort === "low" ? (
-                          <CheckIcon className="ml-auto size-4" />
-                        ) : (
-                          <div className="ml-auto size-4" />
-                        )}
-                      </PromptInputActionMenuItem>
-                      <PromptInputActionMenuItem
-                        className={cn(
-                          context.reasoning_effort === "medium" ||
-                            !context.reasoning_effort
-                            ? "text-accent-foreground"
-                            : "text-muted-foreground/65",
-                        )}
-                        onSelect={() => handleReasoningEffortSelect("medium")}
-                      >
-                        <div className="flex flex-col gap-2">
-                          <div className="flex items-center gap-1 font-bold">
-                            {t.inputBox.reasoningEffortMedium}
-                          </div>
-                          <div className="pl-2 text-xs">
-                            {t.inputBox.reasoningEffortMediumDescription}
-                          </div>
-                        </div>
-                        {context.reasoning_effort === "medium" ||
-                        !context.reasoning_effort ? (
-                          <CheckIcon className="ml-auto size-4" />
-                        ) : (
-                          <div className="ml-auto size-4" />
-                        )}
-                      </PromptInputActionMenuItem>
-                      <PromptInputActionMenuItem
-                        className={cn(
-                          context.reasoning_effort === "high"
-                            ? "text-accent-foreground"
-                            : "text-muted-foreground/65",
-                        )}
-                        onSelect={() => handleReasoningEffortSelect("high")}
-                      >
-                        <div className="flex flex-col gap-2">
-                          <div className="flex items-center gap-1 font-bold">
-                            {t.inputBox.reasoningEffortHigh}
-                          </div>
-                          <div className="pl-2 text-xs">
-                            {t.inputBox.reasoningEffortHighDescription}
-                          </div>
-                        </div>
-                        {context.reasoning_effort === "high" ? (
-                          <CheckIcon className="ml-auto size-4" />
-                        ) : (
-                          <div className="ml-auto size-4" />
-                        )}
-                      </PromptInputActionMenuItem>
-                    </PromptInputActionMenu>
-                  </DropdownMenuGroup>
-                </PromptInputActionMenuContent>
-              </PromptInputActionMenu>
-            )}
           </PromptInputTools>
-          <PromptInputTools className={cn("gap-1.5", compact && "gap-2")}>
+          <PromptInputTools className={cn("ml-auto shrink-0 gap-1.5", compact && "gap-2")}>
             {!frontendRagActive && agentSelector && (
               <AgentSelector
                 selectedAgentId={agentSelector.selectedAgentId}
@@ -1288,6 +1333,100 @@ export function InputBox({
               />
             )}
             {!frontendRagActive && knowledgeSelector}
+            {!frontendRagActive && knowledgeRetrieval && (
+              <DropdownMenu>
+                <Tooltip
+                  content={
+                    knowledgeRetrieval.mode === "smart_reasoning"
+                      ? "智能检索已开启：直接提问即可，系统会检索原文分片并沿 Wiki 线索扩展背景资料"
+                      : knowledgeRetrieval.smartAvailabilityReason
+                  }
+                >
+                  <DropdownMenuTrigger asChild>
+                    <PromptInputButton
+                      type="button"
+                      disabled={disabled}
+                      aria-label={`普通知识库检索模式：${
+                        knowledgeRetrieval.mode === "smart_reasoning"
+                          ? "智能检索"
+                          : "经典检索"
+                      }`}
+                      aria-haspopup="menu"
+                      className={cn(
+                        "rounded-full px-3 shadow-none transition-colors",
+                        knowledgeRetrieval.mode === "smart_reasoning"
+                          ? "border border-emerald-300 bg-emerald-50 text-emerald-700 hover:bg-emerald-100 dark:border-emerald-700 dark:bg-emerald-950/40 dark:text-emerald-200"
+                          : "border border-transparent bg-transparent text-muted-foreground hover:bg-muted/70 hover:text-foreground",
+                      )}
+                    >
+                      <BrainCircuitIcon className="size-3.5" />
+                      <span className="max-w-[160px] truncate text-xs font-normal">
+                        {knowledgeRetrieval.mode === "smart_reasoning" ? "智能检索" : "经典检索"}
+                      </span>
+                    </PromptInputButton>
+                  </DropdownMenuTrigger>
+                </Tooltip>
+                <DropdownMenuContent
+                  align="end"
+                  sideOffset={8}
+                  className="w-80 rounded-xl p-1.5"
+                >
+                  <DropdownMenuLabel className="px-2 pb-1 text-xs text-muted-foreground">
+                    普通知识库检索模式
+                  </DropdownMenuLabel>
+                  <DropdownMenuItem
+                    className="min-h-16 items-start rounded-lg py-2"
+                    disabled={!knowledgeRetrieval.smartAvailable}
+                    onSelect={() =>
+                      knowledgeRetrieval.onModeChange("smart_reasoning")
+                    }
+                  >
+                    <BrainCircuitIcon className="mt-0.5 size-4" />
+                    <div className="min-w-0 flex-1">
+                      <div className="text-sm font-medium">
+                        智能检索
+                        {knowledgeRetrieval.smartIsDefault ? "（新对话默认）" : ""}
+                      </div>
+                      <div className="mt-0.5 text-xs text-muted-foreground">
+                        先检索原文分片，再按命中线索查阅并扩展 Wiki；资料仅作为回答背景
+                      </div>
+                    </div>
+                    {knowledgeRetrieval.mode === "smart_reasoning" && (
+                      <CheckIcon className="mt-0.5 size-4 text-emerald-600" />
+                    )}
+                  </DropdownMenuItem>
+                  <DropdownMenuItem
+                    className="min-h-14 items-start rounded-lg py-2"
+                    onSelect={() => knowledgeRetrieval.onModeChange("classic")}
+                  >
+                    <BookMarkedIcon className="mt-0.5 size-4" />
+                    <div className="min-w-0 flex-1">
+                      <div className="text-sm font-medium">
+                        经典检索
+                        {knowledgeRetrieval.smartIsDefault ? "（候选）" : "（新对话默认）"}
+                      </div>
+                      <div className="mt-0.5 text-xs text-muted-foreground">
+                        沿用原有知识库检索与回答方式
+                      </div>
+                    </div>
+                    {knowledgeRetrieval.mode === "classic" && (
+                      <CheckIcon className="mt-0.5 size-4 text-primary" />
+                    )}
+                  </DropdownMenuItem>
+                  <DropdownMenuSeparator />
+                  <p
+                    className={cn(
+                      "px-2 py-1 text-xs leading-5",
+                      knowledgeRetrieval.smartAvailable
+                        ? "text-muted-foreground"
+                        : "text-amber-600 dark:text-amber-300",
+                    )}
+                  >
+                    {knowledgeRetrieval.smartAvailabilityReason}
+                  </p>
+                </DropdownMenuContent>
+              </DropdownMenu>
+            )}
             {!frontendRagActive && promptPrefix && (
               <Tooltip
                 content={
@@ -1372,11 +1511,21 @@ export function InputBox({
                 "rounded-full border-border bg-background shadow-sm hover:bg-muted dark:bg-blue-500 dark:border-blue-500 dark:text-white dark:hover:bg-blue-400 dark:shadow-none",
                 compact &&
                   "size-7 rounded-lg border-0 bg-[var(--primary)] text-[var(--button-foreground,var(--primary-foreground))] hover:opacity-90 disabled:bg-muted disabled:text-muted-foreground/40 dark:bg-[var(--primary)] dark:border-0 dark:text-[var(--button-foreground,var(--primary-foreground))] dark:hover:opacity-90 dark:disabled:bg-muted",
-              )}
+              )}
-              disabled={disabled}
+              disabled={disabled}
-              variant="outline"
+              onClick={(event) => {
-              status={status}
+                if (composerStatus !== "streaming") return;
-            />
+                // A deliberate press of the square button stops the stream.
+                // Prevent the enclosing form from treating it as a new submit.
+                event.preventDefault();
+                handleStopCurrentGeneration();
+              }}
+              variant="outline"
+              status={composerStatus}
+              {...(documentRewriteActive
+                ? { "aria-label": "停止 AI 全文改写" }
+                : {})}
+            />
           </PromptInputTools>
         </PromptInputFooter>
         {!isNewThread && (

frontend-web/src/components/workspace/input-mode.test.ts

@@ -0,0 +1,21 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+// Node's type-stripping test runner requires the explicit TypeScript suffix.
+// @ts-expect-error The application compiler intentionally uses extensionless imports.
+import { resolveInputMode } from "./input-mode.ts";
+
+test("keeps plan and subagent modes for models without native thinking", () => {
+  assert.equal(resolveInputMode("pro", false), "pro");
+  assert.equal(resolveInputMode("ultra", false), "ultra");
+});
+
+test("falls back only when native thinking mode is unsupported", () => {
+  assert.equal(resolveInputMode("thinking", false), "flash");
+  assert.equal(resolveInputMode("thinking", true), "thinking");
+});
+
+test("keeps the existing defaults when no mode has been chosen", () => {
+  assert.equal(resolveInputMode(undefined, false), "flash");
+  assert.equal(resolveInputMode(undefined, true), "pro");
+});

frontend-web/src/components/workspace/input-mode.ts

@@ -0,0 +1,20 @@
+export type InputMode = "flash" | "thinking" | "pro" | "ultra";
+
+/**
+ * Keep plan/subagent modes available even when the selected model has no
+ * native thinking switch. The backend already falls back to non-thinking for
+ * that model, while `pro` and `ultra` still control planning and subagents.
+ * Only the model-specific `thinking` mode requires `supports_thinking`.
+ */
+export function resolveInputMode(
+  mode: InputMode | undefined,
+  supportsThinking: boolean,
+): InputMode {
+  if (mode === "thinking" && !supportsThinking) {
+    return "flash";
+  }
+  if (mode) {
+    return mode;
+  }
+  return supportsThinking ? "pro" : "flash";
+}

frontend-web/src/components/workspace/knowledge-product-nav.tsx

@@ -1,55 +1,100 @@
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
-import { BookOpen, Database } from "lucide-react";
+import { BookOpen /* , Database, SearchCheck */ } from "lucide-react";
 import { useLocation, useNavigate } from "react-router-dom";
 import { toast } from "sonner";
 
 import { Button } from "@/components/ui/button";
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select";
 import { getStoredAuth } from "@/core/auth";
+// import { canAccessAssistantKnowledge } from "@/core/llmwiki/assistant-knowledge-access-policy";
+// import {
+//   useAssistantKnowledgeVisibility,
+//   useUpdateAssistantKnowledgeVisibility,
+// } from "@/core/system-settings/hooks";
+import { useLlmWikiRuntime } from "@/strategy-components/api/llmwiki";
 import {
-  loadKnowledgeBaseProductVersion,
+  loadOrdinaryKnowledgeLanding,
-  type KnowledgeBaseProductVersion,
+  saveOrdinaryKnowledgeLanding,
-  updateKnowledgeBaseProductVersion,
+  type OrdinaryKnowledgeLanding,
 } from "@/core/system-settings/api";
 
-export const KNOWLEDGE_PRODUCT_KEY = ["system-settings", "knowledge-base-product-version"] as const;
+const LANDING_KEY = ["system-settings", "ordinary-knowledge-landing"] as const;
+
+export function useOrdinaryKnowledgeLanding(enabled = true) {
+  return useQuery({
+    queryKey: LANDING_KEY,
+    queryFn: ({ signal }) => loadOrdinaryKnowledgeLanding(signal),
+    enabled,
+    staleTime: 30_000,
+    retry: false,
+  });
+}
 export const KNOWLEDGE_NORMAL_VIEW_VALUE = "normal";
 export const KNOWLEDGE_NORMAL_VIEW_SEARCH = `?view=${KNOWLEDGE_NORMAL_VIEW_VALUE}`;
 
-export function useKnowledgeBaseProductVersion() {
-  return useQuery({ queryKey: KNOWLEDGE_PRODUCT_KEY, queryFn: loadKnowledgeBaseProductVersion, staleTime: 60_000 });
-}
-
 export function KnowledgeProductNav() {
   const location = useLocation();
   const navigate = useNavigate();
   const client = useQueryClient();
-  const version = useKnowledgeBaseProductVersion();
+  // const assistantVisibility = useAssistantKnowledgeVisibility();
   const isAdmin = getStoredAuth()?.system_role === "admin";
-  const save = useMutation({
+  const landing = useOrdinaryKnowledgeLanding(isAdmin);
-    mutationFn: updateKnowledgeBaseProductVersion,
+  const saveLanding = useMutation({
-    onSuccess: (value) => {
+    mutationFn: saveOrdinaryKnowledgeLanding,
-      client.setQueryData(KNOWLEDGE_PRODUCT_KEY, value);
+    onSuccess: (mode) => { client.setQueryData(LANDING_KEY, mode); toast.success("普通知识库默认页面已更新"); },
-      toast.success(`默认知识库体验已切换为 ${value}`);
+    onError: (error) => toast.error(error.message),
-    },
   });
+  const runtime = useLlmWikiRuntime();
+  const normalAvailable = runtime.data?.provider === "weknora" && Boolean(runtime.data.api_base_url?.trim());
+  // const assistantAllowed = canAccessAssistantKnowledge(
+  //   isAdmin,
+  //   assistantVisibility.isError ? undefined : assistantVisibility.data,
+  // );
+  // const saveAssistantVisibility = useUpdateAssistantKnowledgeVisibility();
+  const retrievalDebug = location.pathname.includes("/knowledge/retrieval-debug");
   const assistant = location.pathname.includes("/knowledge/assistant");
+  const ordinary = !assistant && !retrievalDebug;
 
   return (
-    <div className="flex items-center gap-2 border-b bg-card px-6 py-2">
+    <div className="flex flex-wrap items-center gap-2 border-b bg-card px-6 py-2">
-      <Button size="sm" variant={assistant ? "ghost" : "secondary"} onClick={() => navigate(`/page/workspace/knowledge${KNOWLEDGE_NORMAL_VIEW_SEARCH}`)}>
+      <Button size="sm" disabled={!normalAvailable} title={normalAvailable ? "普通知识库" : "管理员配置知识服务地址后可用"} variant={ordinary ? "secondary" : "ghost"} onClick={() => navigate(`/page/workspace/knowledge${KNOWLEDGE_NORMAL_VIEW_SEARCH}`)}>
         <BookOpen />普通知识库
       </Button>
-      <Button size="sm" variant={assistant ? "secondary" : "ghost"} onClick={() => navigate("/page/workspace/knowledge/assistant")}>
+      {/* 助手知识库、检索调试暂时隐藏，后续放开时去掉这段注释。
-        <Database />助手知识库
+      {assistantAllowed && (
-      </Button>
+        <Button size="sm" variant={assistant ? "secondary" : "ghost"} onClick={() => navigate("/page/workspace/knowledge/assistant")}>
+          <Database />助手知识库
+        </Button>
+      )}
       {isAdmin && (
-        <div className="ml-auto flex items-center gap-2 text-xs text-muted-foreground">
+        <Button size="sm" variant={retrievalDebug ? "secondary" : "ghost"} onClick={() => navigate("/page/workspace/knowledge/retrieval-debug")}>
-          默认产品版本
+          <SearchCheck />检索调试
-          <Select value={version.data ?? "v1"} onValueChange={(value) => save.mutate(value as KnowledgeBaseProductVersion)}>
+        </Button>
-            <SelectTrigger className="h-8 w-40"><SelectValue /></SelectTrigger>
+      )}
-            <SelectContent><SelectItem value="v1">v1 普通知识库</SelectItem><SelectItem value="v2">v2 助手知识库</SelectItem></SelectContent>
+      */}
+      {isAdmin && (
+        <div className="ml-auto flex flex-wrap items-center gap-2 text-xs text-muted-foreground">
+          普通知识库默认页面
+          <Select disabled={landing.isLoading || saveLanding.isPending} value={landing.data ?? "wiki"} onValueChange={(value) => saveLanding.mutate(value as OrdinaryKnowledgeLanding)}>
+            <SelectTrigger className="h-8 w-40" aria-label="普通知识库默认页面"><SelectValue /></SelectTrigger>
+            <SelectContent><SelectItem value="wiki">本系统 Wiki 索引</SelectItem><SelectItem value="weknora">知识库管理页面</SelectItem></SelectContent>
           </Select>
+          {/* 助手知识库日常展示暂时隐藏，和上面两个入口一起放开。
+          助手知识库日常展示
+          <Select
+            disabled={assistantVisibility.isLoading || saveAssistantVisibility.isPending}
+            value={assistantVisibility.data === true ? "visible" : "hidden"}
+            onValueChange={(value) =>
+              saveAssistantVisibility.mutate(value === "visible", {
+                onSuccess: (visible) => toast.success(visible ? "已向普通用户开放助手知识库" : "已隐藏普通用户的助手知识库"),
+                onError: (error) => toast.error(error.message),
+              })
+            }
+          >
+            <SelectTrigger className="h-8 w-52" aria-label="助手知识库日常展示"><SelectValue /></SelectTrigger>
+            <SelectContent><SelectItem value="hidden">隐藏（仅管理员可用）</SelectItem><SelectItem value="visible">开放给普通用户</SelectItem></SelectContent>
+          </Select>
+          */}
         </div>
       )}
     </div>

frontend-web/src/components/workspace/knowledge-wiki-panel.tsx

@@ -0,0 +1,418 @@
+import { BookOpenText, ChevronRight, FileText } from "lucide-react";
+import { useMemo, useState } from "react";
+
+import { Badge } from "@/components/ui/badge";
+import {
+  Sheet,
+  SheetContent,
+  SheetDescription,
+  SheetHeader,
+  SheetTitle,
+} from "@/components/ui/sheet";
+import type { KnowledgeWikiReferenceSelection } from "@/core/llmwiki/knowledge-reference";
+import {
+  classifyKnowledgeWikiSource,
+  filterKnowledgeWikiSources,
+} from "@/core/llmwiki/knowledge-reference";
+import { resolveDisplaySourceChunk } from "@/core/llmwiki/source-excerpt";
+import {
+  formatRetrievalScore,
+  retrievalModeLabel,
+  retrievalRankScoreLabel,
+} from "@/core/llmwiki/retrieval-debug";
+import { resolveWeKnoraSourceTarget } from "@/core/llmwiki/source-links";
+import type { RuntimeDisplaySource } from "@/core/skill-display/runtime";
+import { reasoningPlugins } from "@/core/streamdown";
+import { cn } from "@/lib/utils";
+import { WeKnoraSourceDrawer } from "@/strategy-components/components/resource-management/llmwiki/WeKnoraSourceDrawer";
+
+import { MarkdownContent } from "./messages/markdown-content";
+
+type KnowledgeWikiPanelProps = {
+  highlightedReferenceId?: string | null;
+  selection: KnowledgeWikiReferenceSelection;
+  sources: RuntimeDisplaySource[];
+};
+
+function sourceKey(source: RuntimeDisplaySource) {
+  return `${source.skillName}:${source.index}:${source.id ?? source.url ?? source.title}`;
+}
+
+function stringValue(value: unknown): string {
+  return typeof value === "string" ? value.trim() : "";
+}
+
+function sourceContent(source: RuntimeDisplaySource) {
+  return (source.content || source.snippet || "").trim();
+}
+
+function sourceMode(source: RuntimeDisplaySource) {
+  return stringValue(
+    source.raw?.retrieval_mode ??
+      (source as RuntimeDisplaySource & { retrieval_mode?: unknown })
+        .retrieval_mode,
+  ).toLowerCase();
+}
+
+function matchedHeading(source: RuntimeDisplaySource) {
+  const sections = Array.isArray(source.raw?.matched_sections)
+    ? source.raw.matched_sections
+    : [];
+  const firstSectionWithHeading = sections.find(
+    (section): section is Record<string, unknown> =>
+      !!section &&
+      typeof section === "object" &&
+      !Array.isArray(section) &&
+      Boolean(stringValue((section as Record<string, unknown>).heading)),
+  );
+  const matchedSection =
+    source.raw?.matched_section &&
+    typeof source.raw.matched_section === "object" &&
+    !Array.isArray(source.raw.matched_section)
+      ? (source.raw.matched_section as Record<string, unknown>)
+      : null;
+  return stringValue(
+    source.raw?.matched_heading ??
+      source.raw?.heading ??
+      firstSectionWithHeading?.heading ??
+      matchedSection?.heading,
+  );
+}
+
+function knowledgeSpaceName(source: RuntimeDisplaySource) {
+  return (
+    stringValue(source.raw?.knowledge_base_name) ||
+    stringValue(source.raw?.base_name) ||
+    stringValue(source.raw?.source) ||
+    source.source ||
+    "知识空间"
+  );
+}
+
+function wikiPageTypeLabel(value: unknown) {
+  const normalized = stringValue(value).toLowerCase();
+  if (normalized === "directory") return "目录页";
+  if (normalized === "overview") return "概览页";
+  if (normalized === "article") return "文章页";
+  return normalized ? stringValue(value) : "";
+}
+
+function plainTextPreview(value: string) {
+  return value
+    .replace(/^---[\s\S]*?---\s*/m, "")
+    .replace(/```[\s\S]*?```/g, " ")
+    .replace(/!\[([^\]]*)\]\([^)]*\)/g, "$1")
+    .replace(/\[([^\]]+)\]\([^)]*\)/g, "$1")
+    .replace(/\[\[[^\]\s|]+[|\s]+([^\]]+)\]\]/g, "$1")
+    .replace(/\[\[([^\]]+)\]\]/g, "$1")
+    .replace(/^#{1,6}\s+/gm, "")
+    .replace(/^\s*[-*+]\s+/gm, "")
+    .replace(/^\s*\d+[.)]\s+/gm, "")
+    .replace(/[>*_`~|]/g, " ")
+    .replace(/\s+/g, " ")
+    .trim();
+}
+
+function cardPreview(source: RuntimeDisplaySource) {
+  const summary = stringValue(source.raw?.summary);
+  return plainTextPreview(sourceContent(source) || summary).slice(0, 420);
+}
+
+function updatedAtLabel(source: RuntimeDisplaySource) {
+  const value =
+    source.time ||
+    stringValue(source.raw?.updated_at) ||
+    stringValue(source.raw?.remote_updated_at);
+  if (!value) return "";
+  const date = new Date(value);
+  return Number.isNaN(date.getTime())
+    ? value
+    : date.toLocaleString("zh-CN", { hour12: false });
+}
+
+function scoreLabel(source: RuntimeDisplaySource) {
+  const score = formatRetrievalScore(source.score);
+  if (!score) return "";
+  const label = retrievalRankScoreLabel(
+    source.raw?.rank_score_semantics,
+    Boolean(source.raw?.channel_score || source.raw?.vector_score),
+  );
+  return label ? `${label} ${score}` : "";
+}
+
+/**
+ * Knowledge-space references keep both evidence layers visible: formatted Wiki
+ * pages and their original document chunks. They deliberately use dedicated
+ * Wiki cards instead of the generic numbered reference-card presentation.
+ */
+export function KnowledgeWikiPanel({
+  highlightedReferenceId,
+  selection,
+  sources,
+}: KnowledgeWikiPanelProps) {
+  const wikiSources = useMemo(
+    () => filterKnowledgeWikiSources(sources, selection),
+    [selection, sources],
+  );
+  const orderedSources = useMemo(() => {
+    const formattedWiki = wikiSources.filter(
+      (source) => classifyKnowledgeWikiSource(source) === "wiki",
+    );
+    const rawDocuments = wikiSources.filter(
+      (source) => classifyKnowledgeWikiSource(source) === "raw",
+    );
+    return [...formattedWiki, ...rawDocuments];
+  }, [wikiSources]);
+  const [openSourceKey, setOpenSourceKey] = useState<string | null>(null);
+  const openSource =
+    wikiSources.find((source) => sourceKey(source) === openSourceKey) ?? null;
+  const previewTarget = openSource
+    ? resolveWeKnoraSourceTarget({
+        ...(openSource.raw ?? {}),
+        url: openSource.url,
+      })
+    : null;
+  const openContent = openSource ? sourceContent(openSource) : "";
+  const openChunk = openSource ? resolveDisplaySourceChunk(openSource) : "";
+  const selectedSpaceCount =
+    selection.knowledgeBaseIds.length +
+    selection.assistantKnowledgeBaseIds.length;
+  const formattedWikiCount = wikiSources.filter(
+    (source) => classifyKnowledgeWikiSource(source) === "wiki",
+  ).length;
+  const rawDocumentCount = wikiSources.length - formattedWikiCount;
+
+  return (
+    <div className="flex size-full min-h-0 flex-col overflow-hidden">
+      <header className="shrink-0 border-b border-emerald-200/60 px-1 pb-3 dark:border-emerald-900/50">
+        <div className="flex flex-wrap items-center gap-2">
+          <div className="flex size-8 items-center justify-center rounded-lg bg-emerald-600 text-white shadow-sm shadow-emerald-600/20">
+            <BookOpenText className="size-4" />
+          </div>
+          <div className="min-w-0 flex-1">
+            <div className="flex flex-wrap items-baseline gap-2">
+              <h2 className="text-foreground text-base font-semibold tracking-tight">
+                Wiki 资料
+              </h2>
+              <span className="text-muted-foreground text-xs tabular-nums">
+                {wikiSources.length} 条
+              </span>
+            </div>
+            <p className="text-muted-foreground mt-0.5 text-xs leading-relaxed">
+              来自已选 {selectedSpaceCount} 个知识空间，点击卡片查看完整内容。
+            </p>
+          </div>
+        </div>
+        {wikiSources.length > 0 && (
+          <div className="mt-2.5 flex flex-wrap gap-1.5">
+            <Badge className="border-emerald-200 bg-emerald-100 text-emerald-800 hover:bg-emerald-100 dark:border-emerald-800 dark:bg-emerald-950 dark:text-emerald-200">
+              Wiki 页面 {formattedWikiCount}
+            </Badge>
+            <Badge variant="outline" className="bg-background/80">
+              原始资料 {rawDocumentCount}
+            </Badge>
+          </div>
+        )}
+      </header>
+
+      <main className="min-h-0 flex-1 overflow-y-auto px-1 pt-3 pb-6">
+        {orderedSources.length > 0 ? (
+          <div className="grid gap-3">
+            {orderedSources.map((source) => (
+              <KnowledgeWikiCard
+                key={sourceKey(source)}
+                highlighted={highlightedReferenceId === String(source.index)}
+                source={source}
+                onOpen={() => setOpenSourceKey(sourceKey(source))}
+              />
+            ))}
+          </div>
+        ) : (
+          <div className="text-muted-foreground flex min-h-48 flex-col items-center justify-center rounded-xl border border-dashed bg-muted/20 px-6 text-center text-sm">
+            <BookOpenText className="mb-3 size-8 opacity-50" />
+            <span>本轮未检索到所选知识空间内的 Wiki 资料。</span>
+          </div>
+        )}
+      </main>
+
+      {openSource && previewTarget && (
+        <WeKnoraSourceDrawer
+          open
+          target={previewTarget}
+          title={openSource.title}
+          quote={openChunk}
+          collapseRetrievedExcerptByDefault={
+            classifyKnowledgeWikiSource(openSource) === "wiki"
+          }
+          onOpenChange={(open) => {
+            if (!open) setOpenSourceKey(null);
+          }}
+        />
+      )}
+
+      <Sheet
+        open={Boolean(openSource && !previewTarget)}
+        onOpenChange={(open) => {
+          if (!open) setOpenSourceKey(null);
+        }}
+      >
+        <SheetContent
+          side="right"
+          className="w-[min(92vw,760px)] gap-0 overflow-hidden p-0 sm:max-w-none"
+        >
+          <SheetHeader className="shrink-0 border-b border-emerald-200/60 bg-emerald-50/60 px-5 py-4 pr-12 text-left dark:border-emerald-900/50 dark:bg-emerald-950/20">
+            <div className="flex items-start gap-3 pr-8">
+              <div className="flex size-9 shrink-0 items-center justify-center rounded-lg bg-emerald-600 text-white">
+                <BookOpenText className="size-4.5" />
+              </div>
+              <div className="min-w-0">
+                <SheetTitle className="text-base leading-relaxed">
+                  {openSource?.title || "Wiki 内容"}
+                </SheetTitle>
+                <SheetDescription className="mt-1">
+                  {openSource ? knowledgeSpaceName(openSource) : "知识空间"}
+                </SheetDescription>
+              </div>
+            </div>
+          </SheetHeader>
+          <div className="min-h-0 flex-1 overflow-y-auto bg-slate-50/70 p-4 dark:bg-slate-950/40 sm:p-6">
+            {openContent ? (
+              <article className="mx-auto max-w-3xl rounded-xl bg-background px-4 py-5 shadow-sm ring-1 ring-border/70 sm:px-7">
+                <MarkdownContent
+                  className="max-w-none"
+                  content={openContent}
+                  isLoading={false}
+                  remarkPlugins={reasoningPlugins.remarkPlugins}
+                  rehypePlugins={reasoningPlugins.rehypePlugins}
+                />
+              </article>
+            ) : (
+              <div className="text-muted-foreground flex min-h-64 items-center justify-center rounded-xl border border-dashed bg-background text-sm">
+                当前 Wiki 暂无可展示内容。
+              </div>
+            )}
+          </div>
+        </SheetContent>
+      </Sheet>
+    </div>
+  );
+}
+
+function KnowledgeWikiCard({
+  highlighted,
+  source,
+  onOpen,
+}: {
+  highlighted: boolean;
+  source: RuntimeDisplaySource;
+  onOpen: () => void;
+}) {
+  const formattedWiki = classifyKnowledgeWikiSource(source) === "wiki";
+  const heading = matchedHeading(source);
+  const pageType = wikiPageTypeLabel(source.raw?.page_type);
+  const mode = sourceMode(source);
+  const modeLabel = mode ? retrievalModeLabel(mode) : "";
+  const preview = cardPreview(source);
+  const score = scoreLabel(source);
+  const updatedAt = updatedAtLabel(source);
+  const target = resolveWeKnoraSourceTarget({
+    ...(source.raw ?? {}),
+    url: source.url,
+  });
+  const canOpen = Boolean(target || sourceContent(source));
+
+  return (
+    <button
+      id={`reference-${source.index}`}
+      type="button"
+      disabled={!canOpen}
+      className={cn(
+        "group w-full scroll-mt-12 rounded-xl border bg-background/90 p-4 text-left shadow-sm transition",
+        "focus-visible:ring-2 focus-visible:outline-none disabled:cursor-default disabled:opacity-70",
+        formattedWiki
+          ? "border-emerald-200/80 hover:-translate-y-0.5 hover:border-emerald-400 hover:shadow-md focus-visible:ring-emerald-500/40 dark:border-emerald-900/70"
+          : "border-sky-200/80 hover:-translate-y-0.5 hover:border-sky-400 hover:shadow-md focus-visible:ring-sky-500/40 dark:border-sky-900/70",
+        highlighted &&
+          (formattedWiki
+            ? "border-emerald-500 bg-emerald-50/80 ring-2 ring-emerald-500/20 dark:bg-emerald-950/25"
+            : "border-sky-500 bg-sky-50/80 ring-2 ring-sky-500/20 dark:bg-sky-950/25"),
+      )}
+      onClick={onOpen}
+    >
+      <div className="flex items-start gap-3">
+        <div
+          className={cn(
+            "mt-0.5 flex size-9 shrink-0 items-center justify-center rounded-lg",
+            formattedWiki
+              ? "bg-emerald-100 text-emerald-700 dark:bg-emerald-950 dark:text-emerald-300"
+              : "bg-sky-100 text-sky-700 dark:bg-sky-950 dark:text-sky-300",
+          )}
+        >
+          {formattedWiki ? (
+            <BookOpenText className="size-4.5" />
+          ) : (
+            <FileText className="size-4.5" />
+          )}
+        </div>
+        <div className="min-w-0 flex-1">
+          <div className="flex flex-wrap items-center gap-1.5">
+            <Badge
+              variant="secondary"
+              className={cn(
+                formattedWiki
+                  ? "bg-emerald-50 text-emerald-700 dark:bg-emerald-950 dark:text-emerald-300"
+                  : "bg-sky-50 text-sky-700 dark:bg-sky-950 dark:text-sky-300",
+              )}
+            >
+              {formattedWiki ? "Wiki 页面" : "原始资料"}
+            </Badge>
+            {formattedWiki && pageType && (
+              <Badge variant="outline">{pageType}</Badge>
+            )}
+            {modeLabel && <Badge variant="outline">{modeLabel}</Badge>}
+            <span className="text-muted-foreground min-w-0 truncate text-xs">
+              {knowledgeSpaceName(source)}
+            </span>
+          </div>
+          <h3 className="text-foreground mt-2 line-clamp-2 text-[15px] leading-6 font-semibold">
+            {source.title ||
+              (formattedWiki ? "未命名 Wiki 页面" : "未命名原始资料")}
+          </h3>
+          {heading && (
+            <div className="mt-1 text-xs font-medium text-emerald-700 dark:text-emerald-300">
+              命中章节：{heading}
+            </div>
+          )}
+          {preview && (
+            <p className="text-muted-foreground mt-2 line-clamp-3 whitespace-pre-wrap text-sm leading-6">
+              {preview}
+            </p>
+          )}
+          <div className="text-muted-foreground mt-3 flex flex-wrap items-center justify-between gap-2 border-t pt-3 text-xs">
+            <div className="flex flex-wrap items-center gap-x-3 gap-y-1">
+              {score && <span>{score}</span>}
+              {updatedAt && <span>更新于 {updatedAt}</span>}
+            </div>
+            {canOpen && (
+              <span
+                className={cn(
+                  "inline-flex items-center font-medium transition group-hover:translate-x-0.5",
+                  formattedWiki
+                    ? "text-emerald-700 dark:text-emerald-300"
+                    : "text-sky-700 dark:text-sky-300",
+                )}
+              >
+                {target
+                  ? formattedWiki
+                    ? "查看完整 Wiki"
+                    : "查看原始资料"
+                  : "查看命中内容"}
+                <ChevronRight className="ml-1 size-3.5" />
+              </span>
+            )}
+          </div>
+        </div>
+      </div>
+    </button>
+  );
+}

frontend-web/src/components/workspace/llmwiki-knowledge-selector.tsx

@@ -21,6 +21,9 @@ import {
   DropdownMenuTrigger,
 } from "@/components/ui/dropdown-menu";
 import { Input } from "@/components/ui/input";
+import { useAssistantKnowledgeAccess } from "@/core/llmwiki/assistant-knowledge-access";
+import { ASSISTANT_KNOWLEDGE_UI_VISIBLE } from "@/core/llmwiki/assistant-knowledge-ui";
+import { userFacingKnowledgeSuggestedQuestions } from "@/core/llmwiki/knowledge-suggested-questions";
 import { cn } from "@/lib/utils";
 import {
   type AssistantKnowledgeBase,
@@ -35,6 +38,28 @@ import {
 
 type SelectorSource = "all" | "agent";
 type SelectorVariant = "popover" | "panel";
+const EMPTY_IDS: string[] = [];
+const IGNORE_ASSISTANT_CHANGE = () => undefined;
+
+export function buildKnowledgeSpaceQuestions(names: string[]): string[] {
+  const cleanNames = names.map((name) => name.trim()).filter(Boolean);
+  if (cleanNames.length === 0) return [];
+  if (cleanNames.length === 1) {
+    const name = cleanNames[0]!;
+    return [
+      `请概括「${name}」知识空间的主要内容、适用场景和资料边界。`,
+      `「${name}」包含哪些核心主题？请按重要性说明。`,
+      `请梳理「${name}」中的关键实体、概念及它们之间的关系。`,
+      `根据「${name}」，有哪些值得关注的问题、风险或行动建议？`,
+    ];
+  }
+  return [
+    `请综合所选 ${cleanNames.length} 个知识空间，总结共同主题、差异和互补信息。`,
+    `请对比「${cleanNames.slice(0, 3).join("」「")}」中的关键观点。`,
+    "请梳理所选知识空间中的关键实体、概念及跨库关系。",
+    "所选知识空间中有哪些相互冲突或证据不足的结论？",
+  ];
+}
 
 function groupRows(rows: LlmWikiKnowledgeBase[]) {
   return [
@@ -323,9 +348,14 @@ function SelectionContent({
       </div>
 
       <div className="flex items-center justify-between gap-2 border-t bg-muted/20 px-2.5 py-2">
-        <span className="text-[11px] text-muted-foreground">
+        <div>
-          {readOnly ? `本对话已选 ${selectedCount} 个` : `已选择 ${selectedCount} 个`}
+          <div className="text-[11px] text-muted-foreground">
-        </span>
+            {readOnly ? `本对话已选 ${selectedCount} 个` : `已选择 ${selectedCount} 个`}
+          </div>
+          {selectedCount > 0 && (
+            <div className="mt-0.5 text-[10px] text-primary">仅检索已选知识空间，不联网</div>
+          )}
+        </div>
         {readOnly ? (
           <span className="text-[11px] text-muted-foreground">对话开始后不可更改</span>
         ) : (
@@ -363,9 +393,10 @@ function SelectionContent({
 
 export function LlmWikiKnowledgeSelector({
   value,
-  assistantValue = [],
+  assistantValue = EMPTY_IDS,
   onChange,
-  onAssistantChange = () => undefined,
+  onAssistantChange,
+  onSuggestedQuestionsChange,
   source = "all",
   agentId,
   autoSelectAll = false,
@@ -373,12 +404,15 @@ export function LlmWikiKnowledgeSelector({
   readOnly = false,
   className,
   label = "知识空间",
+  panelTitle = "绑定知识空间",
+  panelDescription = "新建该智能体对话时，只能从已绑定空间中选择本次检索范围。",
   variant = "popover",
 }: {
   value: string[];
   assistantValue?: string[];
   onChange: (value: string[]) => void;
   onAssistantChange?: (value: string[]) => void;
+  onSuggestedQuestionsChange?: (questions: string[]) => void;
   source?: SelectorSource;
   agentId?: string | null;
   autoSelectAll?: boolean;
@@ -387,31 +421,59 @@ export function LlmWikiKnowledgeSelector({
   readOnly?: boolean;
   className?: string;
   label?: string;
+  panelTitle?: string;
+  panelDescription?: string;
   variant?: SelectorVariant;
 }) {
   const [open, setOpen] = useState(false);
   const [search, setSearch] = useState("");
+  const assistantAccess = useAssistantKnowledgeAccess({
+    enabled:
+      ASSISTANT_KNOWLEDGE_UI_VISIBLE && onAssistantChange !== undefined,
+  });
+  const assistantAllowed =
+    ASSISTANT_KNOWLEDGE_UI_VISIBLE &&
+    onAssistantChange !== undefined &&
+    assistantAccess.canAccess;
   const runtime = useLlmWikiRuntime();
   const weknoraEnabled = runtime.data?.provider === "weknora";
+  const shouldLoadOptions =
+    variant === "panel" ||
+    open ||
+    autoSelectAll ||
+    value.length > 0 ||
+    assistantValue.length > 0;
   const all = useLlmWikiKnowledgeBases(
     "all",
-    weknoraEnabled,
+    weknoraEnabled && shouldLoadOptions,
   );
   const agent = useAgentLlmWikiKnowledgeBases(
     agentId,
-    weknoraEnabled && source === "agent" && !!agentId,
+    weknoraEnabled && shouldLoadOptions && source === "agent" && !!agentId,
   );
-  const assistantBases = useAssistantKnowledgeBases();
+  const assistantBases = useAssistantKnowledgeBases(
-  const rows = weknoraEnabled ? (all.data ?? []) : [];
+    assistantAllowed &&
-  const assistantRows = assistantBases.data ?? [];
+      (shouldLoadOptions ||
+        runtime.isError ||
+        (!runtime.isLoading && !weknoraEnabled)),
+  );
+  // Stable empty results are essential: suggested questions are reported to
+  // the parent, so a fresh [] on every render creates an effect/update loop
+  // before lazy knowledge queries have loaded (or when they are disabled).
+  const rows = useMemo(() => weknoraEnabled ? (all.data ?? []) : [], [all.data, weknoraEnabled]);
+  const assistantRows = useMemo(
+    () => assistantAllowed ? (assistantBases.data ?? []) : [],
+    [assistantAllowed, assistantBases.data],
+  );
+  const effectiveAssistantValue = assistantAllowed ? assistantValue : EMPTY_IDS;
   const defaultIds = useMemo(() => {
     if (source !== "agent") {
       return rows.map((item) => item.id);
     }
     return (agent.data ?? []).map((item) => item.id);
   }, [agent.data, rows, source]);
-  const loading = runtime.isLoading || (weknoraEnabled && all.isLoading) || assistantBases.isLoading || (source === "agent" && !!agentId && agent.isLoading);
+  const loading = runtime.isLoading || (weknoraEnabled && all.isLoading) || (assistantAllowed && assistantBases.isLoading) || (source === "agent" && !!agentId && agent.isLoading);
-  const error = (weknoraEnabled ? all.error ?? (source === "agent" ? agent.error : null) : null) ?? assistantBases.error;
+  const error = (weknoraEnabled ? all.error ?? (source === "agent" ? agent.error : null) : null) ?? (assistantAllowed ? assistantBases.error : null);
   const availableIds = useMemo(() => new Set(rows.map((item) => item.id)), [rows]);
   const assistantAvailableIds = useMemo(
     () => new Set(assistantRows.map((item) => item.id)),
@@ -419,6 +481,41 @@ export function LlmWikiKnowledgeSelector({
   );
   const initializationKey = `${source}:${agentId ?? "all"}:${defaultIds.join(",")}`;
   const initialized = useRef<string | null>(null);
+  const selectedNames = useMemo(
+    () => value.map((id) => rows.find((item) => item.id === id)?.name).filter((name): name is string => !!name),
+    [rows, value],
+  );
+  const selectedAssistantNames = useMemo(
+    () => effectiveAssistantValue.map((id) => assistantRows.find((item) => item.id === id)?.name).filter((name): name is string => !!name),
+    [assistantRows, effectiveAssistantValue],
+  );
+  const allSelectedNames = useMemo(
+    () => [...selectedNames, ...selectedAssistantNames],
+    [selectedAssistantNames, selectedNames],
+  );
+  const selectedConfiguredQuestions = useMemo(
+    () =>
+      userFacingKnowledgeSuggestedQuestions(
+        value.flatMap(
+          (id) => rows.find((item) => item.id === id)?.test_questions ?? [],
+        ),
+      ),
+    [rows, value],
+  );
+  const suggestedQuestions = useMemo(
+    () => {
+      if (value.length === 1 && effectiveAssistantValue.length === 0 && selectedConfiguredQuestions.length > 0) {
+        return selectedConfiguredQuestions.slice(0, 12);
+      }
+      const general = buildKnowledgeSpaceQuestions(allSelectedNames);
+      return Array.from(new Set([...selectedConfiguredQuestions, ...general])).slice(0, 12);
+    },
+    [allSelectedNames, effectiveAssistantValue.length, selectedConfiguredQuestions, value.length],
+  );
+
+  useEffect(() => {
+    onSuggestedQuestionsChange?.(suggestedQuestions);
+  }, [onSuggestedQuestionsChange, suggestedQuestions]);
 
   useEffect(() => {
     if (!runtime.isLoading && !weknoraEnabled) {
@@ -437,27 +534,36 @@ export function LlmWikiKnowledgeSelector({
   }, [agent.data, agentId, all.data, autoSelectAll, availableIds, defaultIds, initializationKey, onChange, runtime.isLoading, source, value, weknoraEnabled]);
 
   useEffect(() => {
-    if (!assistantBases.data) return;
+    if (!assistantAllowed || !assistantBases.data || !onAssistantChange) return;
-    const valid = assistantValue.filter((id) => assistantAvailableIds.has(id));
+    const valid = effectiveAssistantValue.filter((id) => assistantAvailableIds.has(id));
-    if (valid.length !== assistantValue.length || valid.some((id, index) => id !== assistantValue[index])) {
+    if (valid.length !== effectiveAssistantValue.length || valid.some((id, index) => id !== effectiveAssistantValue[index])) {
       onAssistantChange(valid);
     }
-  }, [assistantAvailableIds, assistantBases.data, assistantValue, onAssistantChange]);
+  }, [assistantAllowed, assistantAvailableIds, assistantBases.data, effectiveAssistantValue, onAssistantChange]);
 
   useEffect(() => {
     if (!open) setSearch("");
   }, [open]);
 
-  if ((runtime.isError || !weknoraEnabled) && !assistantBases.isLoading && assistantRows.length === 0) return null;
+  if (
+    !runtime.isLoading &&
+    (runtime.isError || !weknoraEnabled) &&
+    (!assistantAllowed || !assistantBases.isLoading) &&
+    assistantRows.length === 0
+  ) return null;
 
   const content = (
     <SelectionContent
       rows={rows}
       assistantRows={assistantRows}
       value={value}
-      assistantValue={assistantValue}
+      assistantValue={effectiveAssistantValue}
       onChange={onChange}
-      onAssistantChange={onAssistantChange}
+      onAssistantChange={
+        assistantAllowed
+          ? (onAssistantChange ?? IGNORE_ASSISTANT_CHANGE)
+          : IGNORE_ASSISTANT_CHANGE
+      }
       search={search}
       onSearchChange={setSearch}
       loading={loading}
@@ -474,27 +580,20 @@ export function LlmWikiKnowledgeSelector({
         <div className="flex items-start justify-between gap-4 border-b px-4 py-3">
           <div>
             <div className="flex items-center gap-2 text-sm font-semibold">
-              <Database className="size-4 text-primary" />绑定知识空间
+              <Database className="size-4 text-primary" />{panelTitle}
             </div>
             <p className="mt-1 text-xs text-muted-foreground">
-              新建该智能体对话时，只能从已绑定空间中选择本次检索范围。
+              {panelDescription}
             </p>
           </div>
-          <Badge variant="secondary" className="shrink-0">{value.length + assistantValue.length} 个</Badge>
+          <Badge variant="secondary" className="shrink-0">{value.length + effectiveAssistantValue.length} 个</Badge>
         </div>
         {content}
       </div>
     );
   }
 
-  const selectedNames = value
+  const selectedCount = value.length + effectiveAssistantValue.length;
-    .map((id) => rows.find((item) => item.id === id)?.name)
-    .filter((name): name is string => !!name);
-  const selectedAssistantNames = assistantValue
-    .map((id) => assistantRows.find((item) => item.id === id)?.name)
-    .filter((name): name is string => !!name);
-  const allSelectedNames = [...selectedNames, ...selectedAssistantNames];
-  const selectedCount = value.length + assistantValue.length;
   const selectedLabel = allSelectedNames.length > 0
     ? allSelectedNames.join("、")
     : selectedCount > 0

frontend-web/src/components/workspace/messages/answer-feedback-control.tsx

@@ -0,0 +1,248 @@
+"use client";
+
+import {
+  CheckIcon,
+  Loader2Icon,
+  ThumbsDownIcon,
+  ThumbsUpIcon,
+} from "lucide-react";
+import { useEffect, useState } from "react";
+import { toast } from "sonner";
+
+import { Button } from "@/components/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/components/ui/dialog";
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuTrigger,
+} from "@/components/ui/dropdown-menu";
+import { Textarea } from "@/components/ui/textarea";
+import { cn } from "@/lib/utils";
+import {
+  useUpsertAnswerFeedback,
+  type AnswerFeedbackContext,
+  type AnswerFeedbackReason,
+} from "@/strategy-components/api/answer-feedback";
+
+import { Tooltip } from "../tooltip";
+
+const REASON_OPTIONS: Array<{
+  value: AnswerFeedbackReason;
+  label: string;
+}> = [
+  { value: "incorrect_or_incomplete", label: "不正确或不完整" },
+  { value: "unmet_expectations", label: "与期望不符" },
+  { value: "slow_or_problematic", label: "速度慢或存在问题" },
+  { value: "style_or_tone", label: "风格或语气" },
+  { value: "safety_or_legal", label: "安全或法律疑虑" },
+  { value: "other", label: "其他" },
+];
+
+export function AnswerFeedbackControl({
+  threadId,
+  messageId,
+  context,
+}: {
+  threadId: string;
+  messageId: string;
+  context: AnswerFeedbackContext;
+}) {
+  const saveFeedback = useUpsertAnswerFeedback();
+  const feedback = context?.feedback ?? null;
+  const [poorDialogOpen, setPoorDialogOpen] = useState(false);
+  const [reasons, setReasons] = useState<AnswerFeedbackReason[]>([]);
+  const [detail, setDetail] = useState("");
+
+  useEffect(() => {
+    if (!poorDialogOpen) return;
+    setReasons(feedback?.rating === -1 ? feedback.reasons : []);
+    setDetail(
+      feedback?.rating === -1
+        ? (feedback.detail ?? feedback.comment ?? "")
+        : "",
+    );
+  }, [feedback, poorDialogOpen]);
+
+  const submitPositive = async () => {
+    try {
+      await saveFeedback.mutateAsync({
+        threadId,
+        messageId,
+        input: { rating: 1, reasons: [], detail: null },
+      });
+      toast.success("感谢你的评价");
+    } catch (error) {
+      toast.error(error instanceof Error ? error.message : "评价提交失败");
+    }
+  };
+
+  const submitNegative = async () => {
+    if (reasons.length === 0) return;
+    try {
+      await saveFeedback.mutateAsync({
+        threadId,
+        messageId,
+        input: {
+          rating: -1,
+          reasons,
+          detail: detail.trim() || null,
+        },
+      });
+      setPoorDialogOpen(false);
+      toast.success("反馈已提交，感谢你的帮助");
+    } catch (error) {
+      toast.error(error instanceof Error ? error.message : "反馈提交失败");
+    }
+  };
+
+  const toggleReason = (reason: AnswerFeedbackReason) => {
+    setReasons((current) =>
+      current.includes(reason)
+        ? current.filter((item) => item !== reason)
+        : [...current, reason],
+    );
+  };
+
+  const triggerIcon =
+    feedback?.rating === 1 ? (
+      <ThumbsUpIcon
+        size={12}
+        className="fill-emerald-500/15 text-emerald-600 dark:text-emerald-400"
+      />
+    ) : feedback?.rating === -1 ? (
+      <ThumbsDownIcon
+        size={12}
+        className="fill-amber-500/15 text-amber-600 dark:text-amber-400"
+      />
+    ) : (
+      <span className="flex items-center gap-px" aria-hidden="true">
+        <ThumbsUpIcon className="size-3" />
+        <ThumbsDownIcon className="size-3" />
+      </span>
+    );
+
+  return (
+    <>
+      <DropdownMenu>
+        <Tooltip content="评价回复">
+          <DropdownMenuTrigger asChild>
+            <Button
+              type="button"
+              size="icon-sm"
+              variant="ghost"
+              className={cn(
+                "size-6",
+                feedback?.rating === 1 &&
+                  "bg-emerald-500/10 hover:bg-emerald-500/15",
+                feedback?.rating === -1 &&
+                  "bg-amber-500/10 hover:bg-amber-500/15",
+              )}
+              disabled={saveFeedback.isPending}
+              aria-label={
+                feedback?.rating === 1
+                  ? "已评价为回答优秀"
+                  : feedback?.rating === -1
+                    ? "已评价为回答不佳"
+                    : "评价回复"
+              }
+            >
+              {saveFeedback.isPending ? (
+                <Loader2Icon className="size-3 animate-spin" />
+              ) : (
+                triggerIcon
+              )}
+            </Button>
+          </DropdownMenuTrigger>
+        </Tooltip>
+        <DropdownMenuContent align="start" sideOffset={6} className="min-w-44 p-1.5">
+          <DropdownMenuItem
+            className="gap-2.5 py-2"
+            onSelect={() => void submitPositive()}
+          >
+            <ThumbsUpIcon className="size-4" />
+            <span>回答优秀</span>
+            {feedback?.rating === 1 && (
+              <CheckIcon className="text-primary ml-auto size-4" />
+            )}
+          </DropdownMenuItem>
+          <DropdownMenuItem
+            className="gap-2.5 py-2"
+            onSelect={() => setPoorDialogOpen(true)}
+          >
+            <ThumbsDownIcon className="size-4" />
+            <span>回答不佳</span>
+            {feedback?.rating === -1 && (
+              <CheckIcon className="text-primary ml-auto size-4" />
+            )}
+          </DropdownMenuItem>
+        </DropdownMenuContent>
+      </DropdownMenu>
+
+      <Dialog open={poorDialogOpen} onOpenChange={setPoorDialogOpen}>
+        <DialogContent className="gap-5 sm:max-w-[min(48rem,calc(100vw-2rem))]">
+          <DialogHeader className="pr-8">
+            <DialogTitle className="text-xl font-medium">分享反馈</DialogTitle>
+            <DialogDescription>
+              可多选这条回答需要改进的方面。
+            </DialogDescription>
+          </DialogHeader>
+
+          <div className="flex flex-wrap gap-2.5">
+            {REASON_OPTIONS.map((option) => {
+              const selected = reasons.includes(option.value);
+              return (
+                <button
+                  key={option.value}
+                  type="button"
+                  aria-pressed={selected}
+                  onClick={() => toggleReason(option.value)}
+                  className={cn(
+                    "rounded-full border px-4 py-2 text-sm transition-colors",
+                    selected
+                      ? "border-primary bg-primary/10 text-primary"
+                      : "border-border bg-background hover:bg-accent",
+                  )}
+                >
+                  {option.label}
+                </button>
+              );
+            })}
+          </div>
+
+          <Textarea
+            value={detail}
+            onChange={(event) => setDetail(event.currentTarget.value)}
+            maxLength={2000}
+            placeholder="分享详细信息（可选）"
+            className="min-h-28 resize-y"
+          />
+
+          <div className="bg-muted/60 text-muted-foreground rounded-lg px-4 py-3 text-sm">
+            你的反馈将用于改进智能体的回答质量和稳定性。
+          </div>
+
+          <DialogFooter>
+            <Button
+              type="button"
+              onClick={() => void submitNegative()}
+              disabled={reasons.length === 0 || saveFeedback.isPending}
+            >
+              {saveFeedback.isPending && (
+                <Loader2Icon className="size-4 animate-spin" />
+              )}
+              提交
+            </Button>
+          </DialogFooter>
+        </DialogContent>
+      </Dialog>
+    </>
+  );
+}

frontend-web/src/components/workspace/messages/answer-feedback-eligibility.test.ts

@@ -0,0 +1,63 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import type { Message } from "@langchain/langgraph-sdk";
+
+// Node's type-stripping test runner requires the explicit TypeScript suffix.
+// @ts-expect-error The application compiler intentionally uses extensionless imports.
+import { isEligibleAnswerFeedbackMessage } from "./answer-feedback-eligibility.ts";
+
+function message(overrides: Partial<Message> = {}): Message {
+  return {
+    id: "answer-1",
+    type: "ai",
+    content: "A persisted answer",
+    additional_kwargs: {},
+    ...overrides,
+  } as Message;
+}
+
+test("accepts a completed persisted assistant answer", () => {
+  assert.equal(isEligibleAnswerFeedbackMessage(message()), true);
+});
+test("rejects loading, user, optimistic and empty messages", () => {
+  assert.equal(isEligibleAnswerFeedbackMessage(message(), true), false);
+  assert.equal(
+    isEligibleAnswerFeedbackMessage(message({ type: "human" })),
+    false,
+  );
+  assert.equal(
+    isEligibleAnswerFeedbackMessage(message({ id: "opt-ai-1" })),
+    false,
+  );
+  assert.equal(
+    isEligibleAnswerFeedbackMessage(message({ content: "  " })),
+    false,
+  );
+});
+
+test("rejects tool-call shells and virtual business cards", () => {
+  assert.equal(
+    isEligibleAnswerFeedbackMessage(
+      message({
+        tool_calls: [{ id: "tool-1", name: "search", args: {} }],
+      }),
+    ),
+    false,
+  );
+  assert.equal(
+    isEligibleAnswerFeedbackMessage(
+      message({
+        additional_kwargs: { setup_research_approval: { stage: "plan" } },
+      }),
+    ),
+    false,
+  );
+});
+
+test("rejects ids outside the message-scoped API contract", () => {
+  assert.equal(
+    isEligibleAnswerFeedbackMessage(message({ id: "x".repeat(65) })),
+    false,
+  );
+});

frontend-web/src/components/workspace/messages/answer-feedback-eligibility.ts

@@ -0,0 +1,52 @@
+import type { Message } from "@langchain/langgraph-sdk";
+
+function hasTextContent(content: Message["content"]): boolean {
+  if (typeof content === "string") return content.trim().length > 0;
+  if (!Array.isArray(content)) return false;
+  return content.some((part) => {
+    if (!part || typeof part !== "object") return false;
+    const text = "text" in part ? part.text : undefined;
+    return typeof text === "string" && text.trim().length > 0;
+  });
+}
+
+/**
+ * Only completed, persisted, user-visible assistant answers can be rated.
+ * Tool-call shells, optimistic/transient rows and special virtual cards are
+ * deliberately excluded because they are not standalone answers.
+ */
+export function isEligibleAnswerFeedbackMessage(
+  message: Message,
+  isLoading = false,
+): boolean {
+  if (
+    isLoading ||
+    message.type !== "ai" ||
+    !message.id ||
+    message.id.length > 64
+  ) {
+    return false;
+  }
+  if (message.id.startsWith("opt-")) return false;
+  if (!hasTextContent(message.content)) return false;
+
+  const directToolCalls = "tool_calls" in message ? message.tool_calls : null;
+  const additional = message.additional_kwargs ?? {};
+  const additionalToolCalls = additional.tool_calls;
+  if (
+    (Array.isArray(directToolCalls) && directToolCalls.length > 0) ||
+    (Array.isArray(additionalToolCalls) && additionalToolCalls.length > 0)
+  ) {
+    return false;
+  }
+
+  const virtualCardKeys = [
+    "setup_agent_approval",
+    "setup_writing_approval",
+    "setup_report_structure_approval",
+    "setup_research_approval",
+    "task_report_import_approval",
+    "report_collaboration_card",
+  ];
+  return !virtualCardKeys.some((key) => additional[key] !== undefined);
+}

frontend-web/src/components/workspace/messages/context.ts

@@ -1,7 +1,8 @@
 import type { BaseStream } from "@langchain/langgraph-sdk/react";
-import { createContext, useContext } from "react";
+import { createContext, useContext } from "react";
-
+
-import type { RuntimeDisplaySource } from "@/core/skill-display/runtime";
+import type { KnowledgeWikiReferenceSelection } from "@/core/llmwiki/knowledge-reference";
+import type { RuntimeDisplaySource } from "@/core/skill-display/runtime";
 import type { AgentThreadState } from "@/core/threads";
 
 export interface ThreadContextType {
@@ -13,6 +14,11 @@ export interface ThreadContextType {
    * from the admin-controlled manual reference-mode button.
    */
   knowledgeReferencesEnabled?: boolean;
+  /**
+   * Server-scoped knowledge selection for the dedicated Wiki reference view.
+   * Sources outside these ids are never displayed as knowledge evidence.
+   */
+  knowledgeReferences?: KnowledgeWikiReferenceSelection;
   /**
    * When set, the conversation is rendered from a public read-only share.
    * Artifact/image URLs then resolve to the unauthenticated

frontend-web/src/components/workspace/messages/document-rewrite-timeline.tsx

@@ -4,6 +4,7 @@ import {
   CheckCircle2Icon,
   ChevronDownIcon,
   ChevronsDownIcon,
+  CopyIcon,
   FilePenLineIcon,
   LightbulbIcon,
   Loader2Icon,
@@ -14,6 +15,7 @@ import { useCallback, useEffect, useLayoutEffect, useRef, useState } from "react
 import { toast } from "sonner";
 
 import { Button } from "@/components/ui/button";
+import { ArtifactFileList } from "@/components/workspace/artifacts/artifact-file-list";
 import {
   Collapsible,
   CollapsibleContent,
@@ -22,6 +24,7 @@ import {
 import { apiFetch } from "@/core/api/fetch-client";
 import { updateArtifactContent } from "@/core/artifacts/api";
 import { urlOfArtifact } from "@/core/artifacts/utils";
+import { copyTextToClipboard } from "@/core/clipboard";
 import {
   DEEP_RESEARCH_REPORT_REWRITE_REQUESTED_EVENT,
   DOCUMENT_REWRITE_LOCAL_UNDO_GUARD_EVENT,
@@ -42,7 +45,7 @@ import { DocumentRewriteDiffDialog } from "./document-rewrite-diff-dialog";
 const REWRITE_STEPS = [
   { key: "snapshot", label: "固定原文版本" },
   { key: "requirements", label: "理解改写要求" },
-  { key: "writing", label: "流式重写 Markdown" },
+  { key: "writing", label: "生成改写版 Markdown" },
   { key: "illustrations", label: "生成文档配图" },
   { key: "validation", label: "校验文档" },
   { key: "comparison", label: "对比原文并生成说明" },
@@ -221,6 +224,9 @@ export function DocumentRewriteTimeline({
   const presentation = useDocumentRewritePresentation();
   const [undoing, setUndoing] = useState(false);
   const [diffOpen, setDiffOpen] = useState(false);
+  const diagnosticText = item.diagnostic
+    ? JSON.stringify(item.diagnostic, null, 2)
+    : "";
 
   const reapplying = Boolean(item.revertedAt);
   const activeVersionId = reapplying ? item.redoVersionId : item.versionId;
@@ -370,7 +376,7 @@ export function DocumentRewriteTimeline({
                     : "bg-primary/10 text-primary",
               )}
             >
-              {completed ? "已完成" : failed ? (isNewReportGeneration ? "未生成新报告" : "未覆盖原文件") : "进行中"}
+              {completed ? "已完成" : failed ? (isNewReportGeneration ? "未生成新报告" : "未生成改写版") : "进行中"}
             </span>
           </div>
           <p className="text-muted-foreground mt-1 text-sm">
@@ -440,13 +446,13 @@ export function DocumentRewriteTimeline({
                 {step.key === "writing" && (
                   item.writtenCharCount > 0 ? (
                     <p className="text-muted-foreground mt-0.5 text-xs">
-                      正在写入右侧沙箱，已{isNewReportGeneration ? "生成" : "改写"} {item.writtenCharCount.toLocaleString()} 字。
+                      正在{isNewReportGeneration ? "生成新报告" : "生成改写版"}，已输出 {item.writtenCharCount.toLocaleString()} 字。
                     </p>
                   ) : active ? (
                     <p aria-live="polite" className="text-muted-foreground mt-0.5 text-xs" role="status">
                       {isNewReportGeneration
                         ? "正在等待模型开始输出；右侧将在首个字符到达后显示新报告。"
-                        : "正在等待模型开始输出；右侧将在首个字符到达后显示草稿。"}
+                        : "正在等待模型开始输出；完成后将生成一份独立的改写版文件。"}
                     </p>
                   ) : null
                 )}
@@ -583,9 +589,42 @@ export function DocumentRewriteTimeline({
       )}
 
       {item.error && (
-        <div className="flex items-center gap-2 border-t px-5 py-3 text-sm text-destructive">
+        <div className="border-t px-5 py-3 text-sm text-destructive">
-          <XCircleIcon className="size-4 shrink-0" />
+          <div className="flex items-start gap-2">
-          {item.error}
+            <XCircleIcon className="mt-0.5 size-4 shrink-0" />
+            <span>{item.error}</span>
+          </div>
+          {item.diagnostic && (
+            <Collapsible className="mt-3">
+              <div className="flex flex-wrap items-center gap-2">
+                <CollapsibleTrigger asChild>
+                  <Button className="h-8 gap-1.5 px-2.5 text-xs" size="sm" type="button" variant="outline">
+                    <ChevronDownIcon className="size-3.5" />
+                    查看后台诊断
+                  </Button>
+                </CollapsibleTrigger>
+                <Button
+                  className="h-8 gap-1.5 px-2.5 text-xs"
+                  onClick={() => {
+                    void copyTextToClipboard(diagnosticText)
+                      .then(() => toast.success("诊断信息已复制"))
+                      .catch(() => toast.error("复制诊断信息失败"));
+                  }}
+                  size="sm"
+                  type="button"
+                  variant="outline"
+                >
+                  <CopyIcon className="size-3.5" />
+                  复制诊断
+                </Button>
+              </div>
+              <CollapsibleContent>
+                <pre className="bg-muted/55 text-foreground mt-2 max-h-72 overflow-auto rounded-lg border p-3 font-mono text-xs leading-5 whitespace-pre-wrap break-words">
+                  {diagnosticText}
+                </pre>
+              </CollapsibleContent>
+            </Collapsible>
+          )}
         </div>
       )}
       <DocumentRewriteDiffDialog
@@ -598,3 +637,36 @@ export function DocumentRewriteTimeline({
     </article>
   );
 }
+
+/** A standalone chat row for a sandbox document-rewrite task. */
+export function DocumentRewriteMessage({
+  item,
+  threadId,
+  onOpenArtifact,
+  onDownloadArtifact,
+}: {
+  item: DocumentRewritePresentation;
+  threadId: string;
+  onOpenArtifact?: (filepath: string) => void;
+  onDownloadArtifact?: (filepath: string) => void | Promise<void>;
+}) {
+  const artifactPath = item.source.kind === "artifact" ? item.outputPath : undefined;
+  const completed = item.stage === "completed";
+
+  return (
+    <section aria-label={`AI 全文改写：${item.fileName}`} className="w-full space-y-3">
+      <DocumentRewriteTimeline item={item} />
+      {completed && artifactPath && (
+        <ArtifactFileList
+          fileDescriptions={{
+            [artifactPath]: "AI 改写版 Markdown 文件",
+          }}
+          files={[artifactPath]}
+          onDownloadArtifact={onDownloadArtifact}
+          onOpenArtifact={onOpenArtifact}
+          threadId={threadId}
+        />
+      )}
+    </section>
+  );
+}

frontend-web/src/components/workspace/messages/markdown-content.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { useMemo } from "react";
+import { useMemo, useRef } from "react";
 import type {
   AnchorHTMLAttributes,
   HTMLAttributes,
@@ -12,7 +12,13 @@ import {
   MessageResponse,
   type MessageResponseProps,
 } from "@/components/ai-elements/message";
-import { streamdownPlugins } from "@/core/streamdown";
+import {
+  looksLikeHtmlDocument,
+  MarkdownFallback,
+  MarkdownRenderBoundary,
+  streamdownPlugins,
+  useStreamdownMermaidPngDownload,
+} from "@/core/streamdown";
 import {
   createMarkdownAnchorResolver,
   isInPageAnchor,
@@ -20,6 +26,9 @@ import {
 } from "@/core/utils/markdown";
 import { cn } from "@/lib/utils";
 
+import { VisualizationBlock } from "../visualizations/visualization-block";
+import { splitVisualizationContent } from "../visualizations/visualization-spec";
+
 import { CitationLink } from "../citations/citation-link";
 
 function isExternalUrl(href: string | undefined): boolean {
@@ -50,6 +59,7 @@ export type MarkdownContentProps = {
 /** Renders markdown content. */
 export function MarkdownContent({
   content,
+  isLoading,
   rehypePlugins,
   className,
   remarkPlugins = streamdownPlugins.remarkPlugins,
@@ -57,7 +67,10 @@ export function MarkdownContent({
   linkClassName,
   onLinkClick,
 }: MarkdownContentProps) {
+  const rootRef = useRef<HTMLDivElement>(null);
   const anchorResolver = useMemo(() => createMarkdownAnchorResolver(content), [content]);
+  const visualizationSegments = useMemo(() => splitVisualizationContent(content), [content]);
+  useStreamdownMermaidPngDownload(rootRef);
   const components = useMemo(() => {
     const heading = (level: 1 | 2 | 3 | 4 | 5 | 6) => {
       const Tag = `h${level}` as const;
@@ -137,17 +150,72 @@ export function MarkdownContent({
 
   if (!content) return null;
 
+  // Full HTML pages belong in the artifact iframe. Feeding them to Streamdown
+  // mid-stream can recurse forever in marked and white-screen the chat.
+  if (looksLikeHtmlDocument(content)) {
+    return (
+      <MarkdownFallback message="正在生成 HTML 页面，请查看右侧预览。" />
+    );
+  }
+
+  // Preserve the exact legacy rendering path for ordinary Markdown. Heavy
+  // visualization renderers are lazy-loaded only when a dedicated fence exists.
+  if (
+    visualizationSegments.length === 1 &&
+    visualizationSegments[0]?.type === "markdown"
+  ) {
+    return (
+      <div ref={rootRef} data-markdown-anchor-root className="contents">
+        <MarkdownRenderBoundary resetKey={`${content.length}:${content.slice(-32)}`}>
+          <MessageResponse
+            className={className}
+            remarkPlugins={remarkPlugins}
+            rehypePlugins={rehypePlugins}
+            mermaidConfig={streamdownPlugins.mermaidConfig}
+            components={components}
+          >
+            {content}
+          </MessageResponse>
+        </MarkdownRenderBoundary>
+      </div>
+    );
+  }
+
   return (
-    <div data-markdown-anchor-root className="contents">
+    <div ref={rootRef} data-markdown-anchor-root className="contents">
-      <MessageResponse
+      {visualizationSegments.map((segment, index) =>
-        className={className}
+        segment.type === "visualization" ? (
-        remarkPlugins={remarkPlugins}
+          <VisualizationBlock
-        rehypePlugins={rehypePlugins}
+            key={`visualization-${index}`}
-        mermaidConfig={streamdownPlugins.mermaidConfig}
+            language={segment.language}
-        components={components}
+            source={segment.source}
-      >
+            complete={segment.complete}
-        {content}
+            isLoading={isLoading}
-      </MessageResponse>
+          />
+        ) : segment.content ? (
+          looksLikeHtmlDocument(segment.content) ? (
+            <MarkdownFallback
+              key={`markdown-${index}`}
+              message="正在生成 HTML 页面，请查看右侧预览。"
+            />
+          ) : (
+            <MarkdownRenderBoundary
+              key={`markdown-${index}`}
+              resetKey={`${segment.content.length}:${segment.content.slice(-32)}`}
+            >
+              <MessageResponse
+                className={className}
+                remarkPlugins={remarkPlugins}
+                rehypePlugins={rehypePlugins}
+                mermaidConfig={streamdownPlugins.mermaidConfig}
+                components={components}
+              >
+                {segment.content}
+              </MessageResponse>
+            </MarkdownRenderBoundary>
+          )
+        ) : null,
+      )}
     </div>
   );
 }

frontend-web/src/components/workspace/messages/message-group.tsx

@@ -32,21 +32,21 @@ import {
   CollapsibleContent,
   CollapsibleTrigger,
 } from "@/components/ui/collapsible";
-import {
+import {
-  Dialog,
+  Sheet,
-  DialogContent,
+  SheetContent,
-  DialogDescription,
+  SheetDescription,
-  DialogHeader,
+  SheetHeader,
-  DialogTitle,
+  SheetTitle,
-} from "@/components/ui/dialog";
+} from "@/components/ui/sheet";
 import {
   buildWriteFileVirtualUrl,
-  hasCompleteArtifactExtension,
   isAutoPreviewableArtifactPath,
   languageOfStreamingArtifact,
   normalizeStreamingArtifactPath,
-  provisionalWriteFilePath,
+  namedStreamingWriteFilePath,
-} from "@/core/artifacts/streaming-write-preview";
+} from "@/core/artifacts/streaming-write-preview";
+import { listStreamingWriteFileCalls } from "@/core/artifacts/parse-partial-json";
 import { useI18n } from "@/core/i18n/hooks";
 import {
   normalizeSearchResults,
@@ -57,9 +57,12 @@ import {
   extractReasoningContentFromMessage,
   findToolCallResult,
 } from "@/core/messages/utils";
+import { collectRetrievedFiles } from "@/core/messages/retrieved-files";
 import { useRehypeSplitWordsIntoSpans } from "@/core/rehype";
 import { useLocalSettings } from "@/core/settings";
-import { useSkills } from "@/core/skills/hooks";
+import { useSkills } from "@/core/skills/hooks";
+import { useCitationDisplaySettings } from "@/core/system-settings/hooks";
+import { isInternalToolCallName } from "@/core/tools/visibility";
 import {
   applyInlineCitations,
   buildSkillDisplayMap,
@@ -82,7 +85,8 @@ import { Tooltip } from "../tooltip";
 import { SourceCard } from "../skill-display-sources";
 
 import { MarkdownContent } from "./markdown-content";
-import { SingleRoundRagCitationDialog } from "./message-list-item";
+import { SingleRoundRagCitationDrawer } from "./message-list-item";
+import { RetrievedFileList } from "./retrieved-file-list";
 
 export function MessageGroup({
   className,
@@ -90,14 +94,17 @@ export function MessageGroup({
   isLoading = false,
   displaySources = [],
   ragModeEnabled = false,
+  threadId,
 }: {
   className?: string;
   messages: Message[];
   isLoading?: boolean;
   displaySources?: RuntimeDisplaySource[];
   ragModeEnabled?: boolean;
+  threadId?: string;
 }) {
   const { t } = useI18n();
+  const { data: citationDisplay } = useCitationDisplaySettings();
   const [showAbove, setShowAbove] = useState(
     env.NEXT_PUBLIC_STATIC_WEBSITE_ONLY === "true",
   );
@@ -112,7 +119,13 @@ export function MessageGroup({
     () => convertToSteps(messages, writingModeEnabled),
     [messages, writingModeEnabled],
   );
-  const { skills } = useSkills();
+  const { skills } = useSkills();
+  const retrievedFiles = useMemo(
+    () => citationDisplay?.retrieved_files_enabled === true
+      ? collectRetrievedFiles(messages, new Set(skills.map((skill) => skill.name)))
+      : [],
+    [messages, skills, citationDisplay?.retrieved_files_enabled],
+  );
   const skillDisplayMap = useMemo(
     () => (ragModeEnabled ? buildSkillDisplayMap(skills) : new Map()),
     [ragModeEnabled, skills],
@@ -210,6 +223,7 @@ export function MessageGroup({
                   {...step}
                   isLoading={isLoading}
                   skillDisplayMap={skillDisplayMap}
+                  displaySources={displaySources}
                   ragModeEnabled={ragModeEnabled}
                 />
               ),
@@ -222,6 +236,7 @@ export function MessageGroup({
                 isLast={true}
                 isLoading={isLoading}
                 skillDisplayMap={skillDisplayMap}
+                displaySources={displaySources}
                 ragModeEnabled={ragModeEnabled}
               />
             </FlipDisplay>
@@ -271,7 +286,8 @@ export function MessageGroup({
         </>
       )}
       </ChainOfThought>
-      <SingleRoundRagCitationDialog
+      {threadId && <RetrievedFileList files={retrievedFiles} threadId={threadId} />}
+      <SingleRoundRagCitationDrawer
         source={selectedCitation}
         onOpenChange={(open) => {
           if (!open) setSelectedCitation(null);
@@ -336,6 +352,7 @@ function ToolCall({
   isLast = false,
   isLoading = false,
   skillDisplayMap = new Map(),
+  displaySources = [],
   ragModeEnabled = false,
 }: {
   id?: string;
@@ -346,6 +363,7 @@ function ToolCall({
   isLast?: boolean;
   isLoading?: boolean;
   skillDisplayMap?: ReturnType<typeof buildSkillDisplayMap>;
+  displaySources?: RuntimeDisplaySource[];
   ragModeEnabled?: boolean;
 }) {
   const { t } = useI18n();
@@ -356,19 +374,42 @@ function ToolCall({
         null);
   const displayItems =
     displayMatch && result !== undefined
-      ? normalizeDisplaySources(result, displayMatch.display).map((item, index) => ({
+      ? syncDisplaySourceIndexes(
-          ...item,
+          rankDisplaySources(
-          index: index + 1,
+            normalizeDisplaySources(result, displayMatch.display).map(
-          skillName: displayMatch.skillName,
+              (item, index) => ({
-          mode: item.displayMode ?? displayMatch.display.mode,
+                ...item,
-        }))
+                index: index + 1,
+                skillName: displayMatch.skillName,
+                mode: item.displayMode ?? displayMatch.display.mode,
+              }),
+            ),
+          ),
+          displaySources,
+        )
       : [];
-  const wikiQuery = name === "llmwiki_search" ? resolveSearchQuery(args, result) : "";
+  const isLlmWikiTool =
+    name === "llmwiki_search" ||
+    name === "llmwiki_read_wiki_page" ||
+    name === "llmwiki_browse_wiki_index";
+  const wikiQuery = isLlmWikiTool
+    ? resolveSearchQuery(args, result) ||
+      (name === "llmwiki_read_wiki_page"
+        ? normalizeSearchResults(result)[0]?.title ||
+          (typeof args.wiki_slug === "string" ? args.wiki_slug : "")
+        : "")
+    : "";
   const wikiSearchLabel = name === "llmwiki_search"
     ? wikiQuery
       ? `Wiki 文档检索 "${wikiQuery}"`
       : "Wiki 文档检索"
-    : null;
+    : name === "llmwiki_read_wiki_page"
+      ? wikiQuery
+        ? `读取 Wiki 页面「${wikiQuery}」`
+        : "读取 Wiki 页面"
+      : name === "llmwiki_browse_wiki_index"
+        ? "读取 Wiki 索引与知识库摘要"
+        : null;
   if (displayItems.length > 0) {
     return (
       <ChainOfThoughtStep
@@ -394,12 +435,17 @@ function ToolCall({
 
   const searchItems = normalizeSearchResults(result);
   if (ragModeEnabled && shouldUseDefaultCitationMode(name, result, args) && searchItems.length > 0) {
-    const defaultItems = normalizeDefaultDisplaySources(result).map((item, index) => ({
+    const defaultItems = syncDisplaySourceIndexes(
-      ...item,
+      rankDisplaySources(
-      index: index + 1,
+        normalizeDefaultDisplaySources(result).map((item, index) => ({
-      skillName: name,
+          ...item,
-      mode: "citation" as const,
+          index: index + 1,
-    }));
+          skillName: name,
+          mode: "citation" as const,
+        })),
+      ),
+      displaySources,
+    );
     return (
       <ChainOfThoughtStep key={id} label={wikiSearchLabel || "检索参考来源"} icon={SearchIcon}>
         <DisplayResultsList results={defaultItems} />
@@ -781,17 +827,10 @@ function ArtifactWriteToolCall({
   const rawPath = typeof args.path === "string" ? args.path : "";
   const content = typeof args.content === "string" ? args.content : "";
   const normalizedPath = normalizeStreamingArtifactPath(rawPath);
-  const hasUsablePath =
+  const sourcePath = namedStreamingWriteFilePath(rawPath);
-    Boolean(normalizedPath) && hasCompleteArtifactExtension(normalizedPath);
+  const showInlineContent = name === "write_file" && !sourcePath;
-  const sourcePath = hasUsablePath
-    ? normalizedPath
-    : name === "write_file" && content.trim()
-      ? provisionalWriteFilePath(content)
-      : null;
   const previewKey = messageId && id ? `${messageId}:${id}` : null;
-  // Never select a bare provisional name like `未命名文件.md` — the artifacts
+  // Until a real path arrives, both auto-open and manual clicks stay inline.
-  // API only serves `/mnt/user-data/...` paths and would 400. Wait until the
-  // tool call has ids so we can open a write-file: memory preview instead.
   const artifactPath =
     sourcePath && name === "write_file" && messageId && id
       ? buildWriteFileVirtualUrl({ path: sourcePath, messageId, toolCallId: id })
@@ -832,7 +871,9 @@ function ArtifactWriteToolCall({
         artifacts.setOpen(true);
       }}
     >
-      {(normalizedPath || sourcePath) && (
+      {showInlineContent ? (
+        content && <InlineWritePreview content={content} />
+      ) : (normalizedPath || sourcePath) && (
         <ChainOfThoughtSearchResult className="cursor-pointer">
           {artifactDisplayName(normalizedPath || (sourcePath ?? ""))}
         </ChainOfThoughtSearchResult>
@@ -841,7 +882,29 @@ function ArtifactWriteToolCall({
   );
 }
 
-interface GenericCoTStep<T extends string = string> {
+function InlineWritePreview({ content }: { content: string }) {
+  const ref = useRef<HTMLPreElement>(null);
+  const follow = useRef(true);
+  useLayoutEffect(() => {
+    if (follow.current && ref.current) {
+      ref.current.scrollTop = ref.current.scrollHeight;
+    }
+  }, [content]);
+  return (
+    <pre
+      ref={ref}
+      onScroll={(event) => {
+        const node = event.currentTarget;
+        follow.current = node.scrollHeight - node.scrollTop - node.clientHeight < 24;
+      }}
+      className="border-border m-0 max-h-64 overflow-auto border-l pl-3 font-mono text-xs leading-6 whitespace-pre-wrap break-words text-emerald-600 dark:text-emerald-400"
+    >
+      <code>{content}</code>
+    </pre>
+  );
+}
+
+interface GenericCoTStep<T extends string = string> {
   id?: string;
   messageId?: string;
   type: T;
@@ -861,6 +924,10 @@ type CoTStep = CoTReasoningStep | CoTToolCallStep;
 
 function convertToSteps(messages: Message[], writingMode: boolean): CoTStep[] {
   const steps: CoTStep[] = [];
+  // Some streaming providers omit tool_call_id on ToolMessages. Keep a
+  // per-name cursor so parallel searches consume distinct unbound results in
+  // order instead of every step reusing the first page.
+  const toolCallNameFallbackIndexes = new Map<string, number>();
   for (const message of messages) {
     if (message.type === "ai") {
       const reasoning = extractReasoningContentFromMessage(message);
@@ -873,14 +940,37 @@ function convertToSteps(messages: Message[], writingMode: boolean): CoTStep[] {
         };
         steps.push(step);
       }
-      for (const tool_call of message.tool_calls ?? []) {
+      const writes = new Map(
-        if (tool_call.name === "task") {
+        listStreamingWriteFileCalls(message).map((write) => [write.id, write]),
+      );
+      const chunks = (message as Parameters<typeof listStreamingWriteFileCalls>[0])
+        .tool_call_chunks;
+      const toolCalls = [...(message.tool_calls ?? [])];
+      for (const write of writes.values()) {
+        if (
+          !toolCalls.some((call) => call.id === write.id) &&
+          chunks?.some(
+            (chunk) => chunk.id === write.id && chunk.name === "write_file",
+          )
+        ) {
+          toolCalls.push({
+            id: write.id,
+            name: "write_file",
+            args: { path: write.path, content: write.content },
+          });
+        }
+      }
+      for (const tool_call of toolCalls) {
+        if (tool_call.name === "task" || isInternalToolCallName(tool_call.name)) {
           continue;
         }
-        const writePath =
+        const write = tool_call.name === "write_file" && tool_call.id
-          typeof (tool_call.args as { path?: unknown } | undefined)?.path === "string"
+          ? writes.get(tool_call.id)
-            ? (tool_call.args as { path: string }).path
+          : undefined;
-            : "";
+        const args = write
+          ? { ...tool_call.args, path: write.path, content: write.content }
+          : tool_call.args;
+        const writePath = typeof args?.path === "string" ? args.path : "";
         if (
           (
             tool_call.name === "write_file" ||
@@ -898,15 +988,27 @@ function convertToSteps(messages: Message[], writingMode: boolean): CoTStep[] {
           messageId: message.id,
           type: "toolCall",
           name: tool_call.name,
-          args: tool_call.args,
+          args,
         };
         const toolCallId = tool_call.id;
         if (toolCallId) {
-          const toolCallResult = findToolCallResult(
+          let toolCallResult = findToolCallResult(
             toolCallId,
             messages,
             tool_call.name,
+            { allowNameFallback: false },
           );
+          if (toolCallResult === undefined) {
+            const nameKey = tool_call.name.toLowerCase();
+            const fallbackIndex = toolCallNameFallbackIndexes.get(nameKey) ?? 0;
+            toolCallResult = findToolCallResult(
+              toolCallId,
+              messages,
+              tool_call.name,
+              { allowNameFallback: true, nameFallbackIndex: fallbackIndex },
+            );
+            toolCallNameFallbackIndexes.set(nameKey, fallbackIndex + 1);
+          }
           if (toolCallResult !== undefined) {
             if (typeof toolCallResult === "string") {
               try {
@@ -973,6 +1075,48 @@ function DisplayResultsList({ results }: { results: RuntimeDisplaySource[] }) {
   );
 }
 
+function rankDisplaySources(
+  sources: RuntimeDisplaySource[],
+): RuntimeDisplaySource[] {
+  return sources
+    .map((source, originalOrder) => ({ source, originalOrder }))
+    .sort((left, right) => {
+      const leftScore =
+        typeof left.source.score === "number" && Number.isFinite(left.source.score)
+          ? left.source.score
+          : Number.NEGATIVE_INFINITY;
+      const rightScore =
+        typeof right.source.score === "number" && Number.isFinite(right.source.score)
+          ? right.source.score
+          : Number.NEGATIVE_INFINITY;
+      return rightScore - leftScore || left.originalOrder - right.originalOrder;
+    })
+    .map(({ source }, index) => ({ ...source, index: index + 1 }));
+}
+
+function syncDisplaySourceIndexes(
+  sources: RuntimeDisplaySource[],
+  globalSources: RuntimeDisplaySource[],
+): RuntimeDisplaySource[] {
+  const indexByCitationId = new Map(
+    globalSources.flatMap((source) => {
+      const citationId =
+        typeof source.raw?.citation_id === "string"
+          ? source.raw.citation_id.trim()
+          : "";
+      return citationId ? [[citationId, source.index] as const] : [];
+    }),
+  );
+  return sources.map((source) => {
+    const citationId =
+      typeof source.raw?.citation_id === "string"
+        ? source.raw.citation_id.trim()
+        : "";
+    const index = citationId ? indexByCitationId.get(citationId) : undefined;
+    return index ? { ...source, index } : source;
+  });
+}
+
 function SearchResultCard({ item }: { item: SearchResultItem }) {
   const [open, setOpen] = useState(false);
   const content = item.snippet ?? item.content;
@@ -1010,32 +1154,46 @@ function SearchResultCard({ item }: { item: SearchResultItem }) {
           </div>
         )}
       </button>
-      <Dialog open={open} onOpenChange={setOpen}>
+      <Sheet open={open} onOpenChange={setOpen}>
-        <DialogContent className="max-w-2xl">
+        <SheetContent
-          <DialogHeader>
+          side="right"
-            <DialogTitle className="pr-6 text-base leading-relaxed">
+          className="w-[min(92vw,760px)] gap-0 overflow-hidden p-0 sm:max-w-none"
-              {item.title ?? "检索结果"}
+        >
-            </DialogTitle>
+          <SheetHeader className="shrink-0 border-b px-5 py-4 pr-12 text-left">
-            {(sourceLabel || date) && (
+            <SheetTitle className="text-base leading-relaxed">
-              <DialogDescription className="flex items-center gap-2 text-xs">
+              {item.title ?? "检索结果"}
-                {sourceLabel && <span>{sourceLabel}</span>}
+            </SheetTitle>
-                {sourceLabel && date && <span>·</span>}
+            {(sourceLabel || date) && (
-                {date && <span>{date}</span>}
+              <SheetDescription className="flex items-center gap-2 text-xs">
-              </DialogDescription>
+                {sourceLabel && <span>{sourceLabel}</span>}
-            )}
+                {sourceLabel && date && <span>·</span>}
-          </DialogHeader>
+                {date && <span>{date}</span>}
-          {content && (
+              </SheetDescription>
-            <div className="text-foreground max-h-[60vh] overflow-y-auto whitespace-pre-wrap text-sm leading-relaxed">
+            )}
-              {content}
+            {!sourceLabel && !date && (
-            </div>
+              <SheetDescription className="sr-only">检索结果详情</SheetDescription>
-          )}
+            )}
-          {item.url && (
+          </SheetHeader>
-            <div className="text-muted-foreground border-t pt-3 text-xs break-all">
+          <div className="min-h-0 flex-1 overflow-y-auto bg-muted/20 p-4 sm:p-6">
-              {item.url}
+            <div className="mx-auto max-w-3xl space-y-4">
-            </div>
+              {content ? (
-          )}
+                <article className="text-foreground rounded-xl border bg-background px-4 py-5 text-sm leading-7 whitespace-pre-wrap shadow-sm sm:px-6">
-        </DialogContent>
+                  {content}
-      </Dialog>
+                </article>
+              ) : (
+                <div className="flex min-h-64 items-center justify-center rounded-xl border border-dashed bg-background text-sm text-muted-foreground">
+                  暂无可展示的检索内容
+                </div>
+              )}
+              {item.url && (
+                <div className="text-muted-foreground border-t pt-3 text-xs break-all">
+                  {item.url}
+                </div>
+              )}
+            </div>
+          </div>
+        </SheetContent>
+      </Sheet>
     </>
   );
 }

frontend-web/src/components/workspace/messages/message-list.tsx

@@ -1,7 +1,7 @@
 import type { Message } from "@langchain/langgraph-sdk";
 import type { BaseStream } from "@langchain/langgraph-sdk/react";
 import { CheckIcon, PenLineIcon, SendIcon, XIcon } from "lucide-react";
-import { useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
+import { useCallback, useContext, useEffect, useMemo, useRef, useState, type ReactNode } from "react";
 import { useStickToBottomContext } from "use-stick-to-bottom";
 
 import {
@@ -28,32 +28,48 @@ import {
   hasToolCalls,
   isHiddenFromUIMessage,
 } from "@/core/messages/utils";
-import { useRehypeSplitWordsIntoSpans } from "@/core/rehype";
+import { useRehypeSplitWordsIntoSpans } from "@/core/rehype";
-import { isThreadRagModeLocked, useLocalSettings } from "@/core/settings";
+import { isThreadRagModeLocked, useLocalSettings } from "@/core/settings";
-import { useSkills } from "@/core/skills/hooks";
+import { useSkills } from "@/core/skills/hooks";
-import { useCitationDisplaySettings } from "@/core/system-settings/hooks";
+import { useCitationDisplaySettings } from "@/core/system-settings/hooks";
-import {
+import type { WeKnoraSourceTarget } from "@/core/llmwiki/source-links";
-  buildSkillDisplayMap,
+import {
+  buildSkillDisplayMap,
   collectRuntimeDisplaySources,
   type RuntimeDisplaySource,
 } from "@/core/skill-display/runtime";
 import type { Subtask } from "@/core/tasks";
 import { useUpdateSubtask } from "@/core/tasks/context";
 import type { AgentThreadState } from "@/core/threads";
+import {
+  shouldRenderUnattachedKnowledgeRetrievalProgress,
+  useKnowledgeRetrievalProgress,
+} from "@/core/threads/knowledge-retrieval-progress";
+import {
+  buildSmartKnowledgeRetrievalDisplaySegments,
+  collectSmartKnowledgeRetrievalTurnAssistantMessageIds,
+  hasSmartKnowledgeRetrievalCalls,
+  latestSmartKnowledgeRetrievalMessageId,
+  type SmartKnowledgeRetrievalResultItem,
+} from "@/core/threads/smart-knowledge-retrieval";
 import { isSingleRoundRagMessage } from "@/core/threads/use-single-round-rag";
 import { isMultiRoundRagMessage } from "@/core/threads/use-multi-round-rag";
-import { cn } from "@/lib/utils";
+import { cn } from "@/lib/utils";
-import { resolveAllowMultiple } from "@/roundtable-planning/lib/clarification";
+import { resolveAllowMultiple } from "@/roundtable-planning/lib/clarification";
+import { useAnswerFeedbackContexts } from "@/strategy-components/api/answer-feedback";
+import { WeKnoraSourceDrawer } from "@/strategy-components/components/resource-management/llmwiki/WeKnoraSourceDrawer";
 
 import { ArtifactFileList } from "../artifacts/artifact-file-list";
 import { getQuestionAnchorId } from "../question-navigator";
 import { StreamingIndicator } from "../streaming-indicator";
 
-import { ReferenceBatchesContext, ThreadContext } from "./context";
+import { ReferenceBatchesContext, ThreadContext } from "./context";
+import { isEligibleAnswerFeedbackMessage } from "./answer-feedback-eligibility";
 import { MarkdownContent } from "./markdown-content";
-import { DocumentRewriteTimeline } from "./document-rewrite-timeline";
+import { DocumentRewriteMessage, DocumentRewriteTimeline } from "./document-rewrite-timeline";
 import { MessageGroup } from "./message-group";
 import { MessageListItem } from "./message-list-item";
+import { SmartKnowledgeRetrievalTrace } from "./smart-knowledge-retrieval-trace";
 import {
   MessageMetricsProvider,
   MessageTokenUsageList,
@@ -65,7 +81,7 @@ export const MESSAGE_LIST_DEFAULT_PADDING_BOTTOM = 160;
 export const MESSAGE_LIST_FOLLOWUPS_EXTRA_PADDING_BOTTOM = 80;
 
 /** 用户发送新问题时强制滚到底部（即使用户此前上滑看过历史）。 */
-function ScrollToBottomOnUserMessage({
+function ScrollToBottomOnUserMessage({
   threadId,
   messages,
 }: {
@@ -109,10 +125,54 @@ function ScrollToBottomOnUserMessage({
     return () => window.removeEventListener(DOCUMENT_REWRITE_STARTED_EVENT, handleDocumentRewriteStarted);
   }, [scrollToBottom, threadId]);
 
-  return null;
+  return null;
-}
+}
-
+
-export function MessageList({
+/**
+ * Exposes the conversation's scroll position to hosts that render controls
+ * outside the scroll container (for example the docked follow-up questions).
+ */
+function ConversationBottomObserver({
+  onAtBottomChange,
+}: {
+  onAtBottomChange?: (isAtBottom: boolean) => void;
+}) {
+  const { scrollRef, contentRef, escapedFromLock } = useStickToBottomContext();
+  const [isExactlyAtBottom, setIsExactlyAtBottom] = useState(true);
+
+  useEffect(() => {
+    const scrollElement = scrollRef.current;
+    if (!scrollElement) return;
+
+    const update = () => {
+      const distance =
+        scrollElement.scrollHeight -
+        scrollElement.scrollTop -
+        scrollElement.clientHeight;
+      setIsExactlyAtBottom(distance <= 2);
+    };
+    update();
+    scrollElement.addEventListener("scroll", update, { passive: true });
+    const resizeObserver =
+      typeof ResizeObserver === "undefined" ? null : new ResizeObserver(update);
+    resizeObserver?.observe(scrollElement);
+    if (contentRef.current) resizeObserver?.observe(contentRef.current);
+    return () => {
+      scrollElement.removeEventListener("scroll", update);
+      resizeObserver?.disconnect();
+    };
+  }, [contentRef, scrollRef]);
+
+  const displayControlsAtBottom = isExactlyAtBottom && !escapedFromLock;
+
+  useEffect(() => {
+    onAtBottomChange?.(displayControlsAtBottom);
+  }, [displayControlsAtBottom, onAtBottomChange]);
+
+  return null;
+}
+
+export function MessageList({
   className,
   contentClassName,
   fitMessageRowsToContent = false,
@@ -120,9 +180,10 @@ export function MessageList({
   thread,
   paddingBottom = MESSAGE_LIST_DEFAULT_PADDING_BOTTOM,
   tokenUsageEnabled = false,
-  extraRehypePlugins,
+  extraRehypePlugins,
-  scrollButtonClassName,
+  scrollButtonClassName,
-  onClarificationSubmit,
+  onAtBottomChange,
+  onClarificationSubmit,
   onEditResubmit,
   onEditSave,
   messageContentOverrides,
@@ -136,10 +197,13 @@ export function MessageList({
   onSetupReportStructureReject,
   researchApprovalSlot,
   taskReportImportSlot,
+  businessCardSlot,
+  speakerShell,
   onOpenArtifact,
-  onDownloadArtifact,
+  onDownloadArtifact,
-  afterDocumentRewriteItems,
+  afterDocumentRewriteItems,
-}: {
+  answerFeedbackEnabled = false,
+}: {
   className?: string;
   contentClassName?: string;
   fitMessageRowsToContent?: boolean;
@@ -147,8 +211,10 @@ export function MessageList({
   thread: BaseStream<AgentThreadState>;
   paddingBottom?: number;
   tokenUsageEnabled?: boolean;
-  /** 额外定位「回到最新」悬浮按钮——不同页面输入框高度不同，需上移让位。 */
+  /** 额外定位「回到最新」悬浮按钮——不同页面输入框高度不同，需上移让位。 */
-  scrollButtonClassName?: string;
+  scrollButtonClassName?: string;
+  /** Reports whether the message viewport is currently at its bottom edge. */
+  onAtBottomChange?: (isAtBottom: boolean) => void;
   extraRehypePlugins?: ReturnType<typeof useRehypeSplitWordsIntoSpans>;
   onClarificationSubmit?: (answer: string) => void | Promise<void>;
   onEditResubmit?: (text: string) => void;
@@ -176,12 +242,31 @@ export function MessageList({
    * 「是否入库」卡片。不传该 slot 时（普通对话等）该分组不渲染，零行为变化。
    */
   taskReportImportSlot?: (message: Message) => React.ReactNode;
+  /**
+   * 通用业务卡插槽（报告协作工作台等）：宿主向 displayThread 注入带
+   * `additional_kwargs.report_collaboration_card` 的虚拟 ai 消息（方案组 /
+   * 命令确认 / 报告入口），由本插槽渲染。不传该 slot 时（普通对话等）该
+   * 分组不渲染，零行为变化；卡 payload 结构由各页面在 message-adapter
+   * 层定义，MessageList 不感知具体业务字段。
+   */
+  businessCardSlot?: (message: Message) => React.ReactNode;
+  /**
+   * 可选说话人壳（报告协作对齐会商第二步）：包住 assistant / processing 分组。
+   * 不传则问答页零变化。
+   */
+  speakerShell?: (messages: Message[], children: ReactNode) => ReactNode;
   onOpenArtifact?: (filepath: string) => void;
   /** Host override for downloading virtual/session-owned files in a present-files card. */
   onDownloadArtifact?: (filepath: string) => void | Promise<void>;
-  /** Optional host content placed immediately after document-rewrite timelines. */
+  /** Optional host content placed immediately after document-rewrite timelines. */
-  afterDocumentRewriteItems?: React.ReactNode;
+  afterDocumentRewriteItems?: React.ReactNode;
-}) {
+  /**
+   * Enables per-answer user feedback for persisted assistant replies. Kept
+   * opt-in because MessageList is also reused by read-only previews, setup
+   * flows and virtual business-card feeds.
+   */
+  answerFeedbackEnabled?: boolean;
+}) {
   const baseRehypePlugins = useRehypeSplitWordsIntoSpans(thread.isLoading);
   const rehypePlugins = useMemo(
     () => (extraRehypePlugins?.length ? [...baseRehypePlugins, ...extraRehypePlugins] : baseRehypePlugins),
@@ -202,33 +287,65 @@ export function MessageList({
   const [hiddenMessageIds, setHiddenMessageIds] = useState<Set<string>>(
     () => new Set(),
   );
+  const [selectedRetrievalResult, setSelectedRetrievalResult] = useState<{
+    item: SmartKnowledgeRetrievalResultItem;
+    target: WeKnoraSourceTarget;
+  } | null>(null);
   useEffect(() => {
     setHiddenMessageIds(new Set());
+    setSelectedRetrievalResult(null);
   }, [threadId]);
-  const handleMessageDeleted = useCallback((deletedIds: string[]) => {
+  const handleMessageDeleted = useCallback((deletedIds: string[]) => {
     if (deletedIds.length === 0) return;
     setHiddenMessageIds((prev) => {
       const next = new Set(prev);
       for (const id of deletedIds) next.add(id);
       return next;
-    });
+    });
-  }, []);
+  }, []);
-
+
-  const allMessages = useMemo(() => {
+  const documentRewriteItems = useMemo(
-    const hasOverrides = messageContentOverrides && Object.keys(messageContentOverrides).length > 0;
+    () => documentRewritePresentation?.forThread(threadId) ?? [],
-    return thread.messages
+    [documentRewritePresentation, threadId],
-      .filter((m) => !isHiddenFromUIMessage(m))
+  );
+  const artifactRewriteItems = useMemo(
+    () => documentRewriteItems.filter(
+      (item) => item.source.kind === "artifact" && item.operation === "rewrite",
+    ),
+    [documentRewriteItems],
+  );
+
+  const allMessages = useMemo(() => {
+    const hasOverrides = messageContentOverrides && Object.keys(messageContentOverrides).length > 0;
+    const persistedMessages = thread.messages
+      .filter((m) => !isHiddenFromUIMessage(m))
       .map((message) => {
         const override =
           hasOverrides && message.id
             ? messageContentOverrides?.[message.id]
             : undefined;
-        return override === undefined
+        return override === undefined
-          ? message
+          ? message
-          : ({ ...message, content: override } as Message);
+          : ({ ...message, content: override } as Message);
-      });
+      });
-  }, [messageContentOverrides, thread.messages]);
+    const rewriteMessages = artifactRewriteItems.flatMap((item) => [
-  const messages = useMemo(
+      {
+        id: `document-rewrite-input-${item.id}`,
+        type: "human",
+        content: "AI改写",
+      } as unknown as Message,
+      {
+        id: `document-rewrite-${item.id}`,
+        type: "ai",
+        content: "",
+        additional_kwargs: {
+          document_rewrite_presentation_id: item.id,
+        },
+      } as unknown as Message,
+    ]);
+    return [...persistedMessages, ...rewriteMessages];
+  }, [artifactRewriteItems, messageContentOverrides, thread.messages]);
+  const messages = useMemo(
     () => {
       const externalHidden = externallyHiddenMessageIds ?? new Set<string>();
       return hiddenMessageIds.size === 0 && externalHidden.size === 0
@@ -240,10 +357,58 @@ export function MessageList({
           );
     },
     [allMessages, externallyHiddenMessageIds, hiddenMessageIds],
-  );
+  );
-  const documentRewriteItems = documentRewritePresentation?.forThread(threadId) ?? [];
+  const knowledgeRetrievalProgress = useKnowledgeRetrievalProgress(threadId);
-
+  const hasHumanMessage = messages.some((message) => message.type === "human");
-  const askTimes = useChatAskTimes();
+  const currentTurnMessages = useMemo(() => {
+    let lastHumanIndex = -1;
+    for (let index = messages.length - 1; index >= 0; index -= 1) {
+      if (messages[index]?.type === "human") {
+        lastHumanIndex = index;
+        break;
+      }
+    }
+    return messages.slice(lastHumanIndex + 1);
+  }, [messages]);
+  const latestCurrentSmartMessageId = useMemo(
+    () => latestSmartKnowledgeRetrievalMessageId(currentTurnMessages),
+    [currentTurnMessages],
+  );
+  const lastCurrentTurnMessageId = currentTurnMessages.at(-1)?.id;
+  const feedbackAvailable = answerFeedbackEnabled && allowDelete;
+  const answerFeedbackMessageIds = useMemo(() => {
+    if (!feedbackAvailable) return [];
+    const streamingAssistantId = thread.isLoading
+      ? [...messages].reverse().find((message) => message.type === "ai")?.id
+      : undefined;
+    return messages.flatMap((message) => {
+      const kwargs = message.additional_kwargs ?? {};
+      const explicitlyStreaming =
+        kwargs.deep_research_summary_streaming === true ||
+        kwargs.deep_research_follow_up_streaming === true;
+      const loading =
+        explicitlyStreaming ||
+        (Boolean(streamingAssistantId) && message.id === streamingAssistantId);
+      return isEligibleAnswerFeedbackMessage(message, loading) && message.id
+        ? [message.id]
+        : [];
+    });
+  }, [feedbackAvailable, messages, thread.isLoading]);
+  const { data: answerFeedbackContexts } = useAnswerFeedbackContexts(
+    threadId,
+    answerFeedbackMessageIds,
+    feedbackAvailable,
+  );
+  const ratableAnswerMessageIds = useMemo(() => {
+    const lastMessageByRun = new Map<string, string>();
+    for (const message of messages) {
+      if (!message.id) continue;
+      const context = answerFeedbackContexts?.[message.id];
+      if (context) lastMessageByRun.set(context.run_id, message.id);
+    }
+    return new Set(lastMessageByRun.values());
+  }, [answerFeedbackContexts, messages]);
+  const askTimes = useChatAskTimes();
 
   // Stamp a wall-clock time onto every *question* the first time it is seen, in
   // a single batched commit. Questions sent this session already carry an
@@ -300,23 +465,20 @@ export function MessageList({
     }
     return map;
   }, [messages]);
-
+
-  const [settings] = useLocalSettings();
+  const [settings] = useLocalSettings();
-  const { data: citationDisplay } = useCitationDisplaySettings();
+  const { data: citationDisplay } = useCitationDisplaySettings();
-  const referenceModeEntryEnabled =
+  const referenceModeEntryEnabled =
-    citationDisplay?.reference_mode_enabled ?? false;
+    citationDisplay?.reference_mode_enabled ?? false;
   const knowledgeReferencesEnabled =
-    threadContext?.knowledgeReferencesEnabled === true;
+    threadContext?.knowledgeReferencesEnabled === true ||
-  const ragModeEnabled =
+    !!threadContext?.knowledgeReferences;
-    (referenceModeEntryEnabled && settings.display.ragModeEnabled) ||
+  const ragModeEnabled =
-    isThreadRagModeLocked(threadId) ||
+    (referenceModeEntryEnabled && settings.display.ragModeEnabled) ||
-    knowledgeReferencesEnabled;
+    isThreadRagModeLocked(threadId) ||
+    knowledgeReferencesEnabled;
   const hasSingleRoundRag = useMemo(
-    () =>
+    () => messages.some((message) => isSingleRoundRagMessage(message)),
-      messages.some(
-        (message) =>
-          isSingleRoundRagMessage(message) || isMultiRoundRagMessage(message),
-      ),
     [messages],
   );
   const referencesEnabled = ragModeEnabled || hasSingleRoundRag;
@@ -331,7 +493,7 @@ export function MessageList({
   // frontend tool-message scan below comes up empty (e.g. after a reload).
   const referenceBatches = useContext(ReferenceBatchesContext);
 
-  // 单轮/多轮 RAG 的参考资料存放在一条 hide_from_ui 的 tool 消息里（紧挨在
+  // 单轮 RAG 的参考资料存放在一条 hide_from_ui 的 tool 消息里（紧挨在
   // assistant 消息之前）。allMessages 会把 hide_from_ui 消息过滤掉，导致通用
   // 的 collectRuntimeDisplaySources 扫描不到它们。这里直接在原始消息流里按
   // assistant 消息提取其对应的参考资料，保证 `[1]` 等编号能解析成可点击引用。
@@ -342,7 +504,7 @@ export function MessageList({
       const msg = raw[i];
       if (!msg || msg.type !== "ai" || !msg.id) continue;
       const kwargs = msg.additional_kwargs;
-      if (!kwargs || (kwargs.single_round_rag !== true && kwargs.multi_round_rag !== true)) {
+      if (!kwargs || kwargs.single_round_rag !== true) {
         continue;
       }
       let sources: RuntimeDisplaySource[] = [];
@@ -353,19 +515,13 @@ export function MessageList({
         if (prev.type === "human" || prev.type === "ai") break;
         if (prev.type !== "tool") continue;
         const prevKwargs = prev.additional_kwargs;
-        if (
+        if (!prevKwargs || prevKwargs.single_round_rag !== true) {
-          !prevKwargs ||
-          (prevKwargs.single_round_rag !== true && prevKwargs.multi_round_rag !== true)
-        ) {
           continue;
         }
         const results = extractFrontendRagResults(prev.content);
         if (results && results.length > 0) {
           const toolName = String(
-            (prev as { name?: unknown }).name ??
+            (prev as { name?: unknown }).name ?? "knowledge_base_search",
-              (prevKwargs.multi_round_rag === true
-                ? "multi_round_rag_references"
-                : "knowledge_base_search"),
           );
           sources = results.map((item, index) =>
             toRuntimeDisplaySource(item, index + 1, toolName),
@@ -378,9 +534,29 @@ export function MessageList({
     return map;
   }, [thread.messages]);
 
+  const smartRetrievalAssistantMessageIds = useMemo(() => {
+    return collectSmartKnowledgeRetrievalTurnAssistantMessageIds(messages);
+  }, [messages]);
+
   const resolveDisplaySources = useCallback(
     (msg: Message | undefined): RuntimeDisplaySource[] => {
       if (!referencesEnabled || !msg || msg.type !== "ai") return [];
+      if (isMultiRoundRagMessage(msg)) return [];
+      const previousHumanId = findPreviousHumanMessageId(messages, msg.id);
+      // Smart retrieval has its own clickable evidence trace and explicitly
+      // does not require numbered references. Do not feed the same transport
+      // results into the legacy citation layer, which would append [1][2] to
+      // an otherwise complete answer.
+      const isSmartRetrievalTurn = msg.id
+        ? smartRetrievalAssistantMessageIds.has(msg.id)
+        : hasSmartKnowledgeRetrievalCalls(
+            messages.slice(
+              previousHumanId
+                ? messages.findIndex((message) => message.id === previousHumanId) + 1
+                : 0,
+            ),
+          );
+      if (isSmartRetrievalTurn) return [];
       const batchSources =
         referenceBatches.find((batch) => batch.assistant_message_id === msg.id)
           ?.sources ?? [];
@@ -390,7 +566,7 @@ export function MessageList({
       if (batchSources.length > 0) return batchSources;
       if (frontendRagSources.length > 0) return frontendRagSources;
       return collectRuntimeDisplaySources(messages, skillDisplayMap, {
-        afterMessageId: findPreviousHumanMessageId(messages, msg.id),
+        afterMessageId: previousHumanId,
         beforeMessageId: msg.id,
         includeBeforeMessage: true,
       });
@@ -401,6 +577,7 @@ export function MessageList({
       referenceBatches,
       referencesEnabled,
       skillDisplayMap,
+      smartRetrievalAssistantMessageIds,
     ],
   );
 
@@ -516,27 +693,22 @@ export function MessageList({
   return (
     <Conversation
       className={cn("flex size-full flex-col justify-center", className)}
-    >
+    >
-      <ScrollToBottomOnUserMessage threadId={threadId} messages={messages} />
+      <ScrollToBottomOnUserMessage threadId={threadId} messages={messages} />
-      <ConversationContent
+      <ConversationBottomObserver onAtBottomChange={onAtBottomChange} />
+      <ConversationContent
         className={cn(
           "mx-auto w-full max-w-(--container-width-lg)",
           hasSingleRoundRag ? "gap-4 pt-4" : "gap-8 pt-12",
           contentClassName,
         )}
       >
-        <MessageMetricsProvider messages={messages} isLoading={thread.isLoading}>
+        <MessageMetricsProvider messages={messages} isLoading={thread.isLoading}>
-        {(() => {
+        {(() => {
-          const rewriteItemsAboveFile = documentRewriteItems.filter(
+          let didRenderLiveKnowledgeRetrieval = false;
-            (item) => item.operation !== "generate",
-          );
-          const rewriteItemsBelowFile = documentRewriteItems.filter(
-            (item) => item.operation === "generate",
-          );
-          let didRenderRewriteAboveFile = false;
           const grouped = groupMessages(messages, (group) => {
           if (group.type === "human" || group.type === "assistant") {
-            return group.messages.map((msg) => {
+            const items = group.messages.map((msg) => {
               // 深度研究的报告摘要由独立 SSE 作业驱动；把它接入既有 assistant 流式状态，
               // 便于 Streamdown 在每次 summary_delta 到达时立即更新该普通消息行。
               const messageIsLoading =
@@ -563,7 +735,12 @@ export function MessageList({
                   questionMarkdown={
                     msg.id ? questionMarkdownByAssistantId.get(msg.id) : undefined
                   }
-                  isLoading={messageIsLoading}
+                  isLoading={
+                    isMultiRoundRagMessage(msg)
+                      ? thread.isLoading &&
+                        msg.id === messages[messages.length - 1]?.id
+                      : messageIsLoading
+                  }
                   threadId={threadId}
                   tokenUsageEnabled={tokenUsageEnabled}
                   displaySources={displaySources}
@@ -573,10 +750,24 @@ export function MessageList({
                   onMessageDeleted={
                     allowDelete ? handleMessageDeleted : undefined
                   }
-                  turnTime={msg.id ? turnTimes.get(msg.id) : undefined}
+                  turnTime={msg.id ? turnTimes.get(msg.id) : undefined}
-                />
+                  answerFeedbackEnabled={answerFeedbackEnabled}
+                  answerFeedbackContext={
+                    msg.id && ratableAnswerMessageIds.has(msg.id)
+                      ? answerFeedbackContexts?.[msg.id]
+                      : undefined
+                  }
+                />
               );
             });
+            if (speakerShell && group.type === "assistant") {
+              return (
+                <div key={group.id} className="w-full">
+                  {speakerShell(group.messages, items)}
+                </div>
+              );
+            }
+            return items;
           } else if (group.type === "assistant:clarification") {
             const message = group.messages[0];
             if (message && hasContent(message)) {
@@ -692,7 +883,30 @@ export function MessageList({
                 {taskReportImportSlot(message)}
               </div>
             ) : null;
-          } else if (group.type === "assistant:present-files") {
+          } else if (group.type === "assistant:business-card") {
+            // 通用业务卡（报告协作）：宿主不传渲染函数时该分组不渲染。
+            const message = group.messages[0];
+            return businessCardSlot && message ? (
+              <div key={group.id} className="w-full pb-2">
+                {businessCardSlot(message)}
+              </div>
+            ) : null;
+          } else if (group.type === "assistant:document-rewrite") {
+            const presentationId = group.messages[0]?.additional_kwargs?.document_rewrite_presentation_id;
+            const item = typeof presentationId === "string"
+              ? artifactRewriteItems.find((candidate) => candidate.id === presentationId)
+              : undefined;
+            return item ? (
+              <div className="w-full" key={group.id}>
+                <DocumentRewriteMessage
+                  item={item}
+                  onDownloadArtifact={onDownloadArtifact}
+                  onOpenArtifact={onOpenArtifact}
+                  threadId={threadId}
+                />
+              </div>
+            ) : null;
+          } else if (group.type === "assistant:present-files") {
             const files: string[] = [];
             for (const message of group.messages) {
               if (hasPresentFiles(message)) {
@@ -700,16 +914,9 @@ export function MessageList({
                 files.push(...presentFiles);
               }
             }
-            const rewriteAbove = !didRenderRewriteAboveFile
+            return (
-              ? rewriteItemsAboveFile
+              <div className="w-full" key={group.id}>
-              : [];
+                {group.messages[0] && hasContent(group.messages[0]) && (
-            didRenderRewriteAboveFile = true;
-            return (
-              <div className="w-full" key={group.id}>
-                {rewriteAbove.map((item) => (
-                  <DocumentRewriteTimeline key={`rewrite-above-${item.id}`} item={item} />
-                ))}
-                {group.messages[0] && hasContent(group.messages[0]) && (
                   <MarkdownContent
                     content={extractContentFromMessage(group.messages[0])}
                     isLoading={thread.isLoading}
@@ -786,13 +993,14 @@ export function MessageList({
             )) {
               if (hasReasoning(message)) {
                 results.push(
-                  <MessageGroup
+                  <MessageGroup
-                    key={"thinking-group-" + message.id}
+                    key={"thinking-group-" + message.id}
-                    messages={[message]}
+                    threadId={threadId}
-                    isLoading={thread.isLoading}
+                    messages={[message]}
-                    displaySources={resolveDisplaySources(message)}
+                    isLoading={thread.isLoading}
-                    ragModeEnabled={ragModeEnabled}
+                    displaySources={resolveDisplaySources(message)}
-                  />,
+                    ragModeEnabled={ragModeEnabled}
+                  />,
                 );
               }
               results.push(
@@ -838,14 +1046,95 @@ export function MessageList({
           const processingAi = [...group.messages]
             .reverse()
             .find((message) => message.type === "ai");
-          return (
+          const hasSmartRetrievalCalls = hasSmartKnowledgeRetrievalCalls(
-            <div key={"group-" + group.id} className="w-full">
+            group.messages,
-              <MessageGroup
+          );
-                messages={group.messages}
+          const isCurrentTurnRetrievalGroup = group.messages.some(
-                isLoading={thread.isLoading}
+            (message) =>
-                displaySources={resolveDisplaySources(processingAi)}
+              message.id ===
-                ragModeEnabled={ragModeEnabled}
+              (latestCurrentSmartMessageId ?? lastCurrentTurnMessageId),
-              />
+          );
+          const receivesLiveRetrievalProgress =
+            knowledgeRetrievalProgress.length > 0 &&
+            isCurrentTurnRetrievalGroup;
+          const retrievalDisplaySegments =
+            hasSmartRetrievalCalls || receivesLiveRetrievalProgress
+              ? buildSmartKnowledgeRetrievalDisplaySegments(
+                  group.messages,
+                  receivesLiveRetrievalProgress
+                    ? knowledgeRetrievalProgress
+                    : [],
+                )
+              : [
+                  {
+                    kind: "processing" as const,
+                    id: `processing-${group.id ?? "group"}`,
+                    messages: group.messages,
+                  },
+                ];
+          if (
+            retrievalDisplaySegments.some(
+              (segment) =>
+                segment.kind === "retrieval" &&
+                segment.progressFrames.length > 0,
+            )
+          ) {
+            didRenderLiveKnowledgeRetrieval = true;
+          }
+          const processingBody = (
+            <div className="w-full space-y-2">
+              {retrievalDisplaySegments.map((segment) => {
+                if (segment.kind === "retrieval") {
+                  return (
+                    <SmartKnowledgeRetrievalTrace
+                      key={segment.id}
+                      messages={segment.messages}
+                      progressFrames={segment.progressFrames}
+                      dedupeScopeMessages={group.messages}
+                      dedupeScopeProgressFrames={
+                        receivesLiveRetrievalProgress
+                          ? knowledgeRetrievalProgress
+                          : []
+                      }
+                      roundOffset={segment.roundOffset}
+                      // The AI tool-call message can arrive before its custom
+                      // `started` frame. Keep the current turn active through
+                      // that short gap instead of misclassifying the pending
+                      // call as an interrupted historical action.
+                      isLoading={
+                        isCurrentTurnRetrievalGroup && thread.isLoading
+                      }
+                      onOpenResult={(item, target) =>
+                        setSelectedRetrievalResult({ item, target })
+                      }
+                    />
+                  );
+                }
+                const segmentHasVisibleProcessing = segment.messages.some(
+                  (message) =>
+                    message.type === "tool" ||
+                    (message.type === "ai" &&
+                      (hasReasoning(message) ||
+                        hasContent(message) ||
+                        hasToolCalls(message))),
+                );
+                if (!segmentHasVisibleProcessing) return null;
+                const segmentAi = [...segment.messages]
+                  .reverse()
+                  .find((message) => message.type === "ai");
+                return (
+                  <MessageGroup
+                    key={segment.id}
+                    threadId={threadId}
+                    messages={segment.messages}
+                    isLoading={thread.isLoading}
+                    displaySources={resolveDisplaySources(
+                      segmentAi ?? processingAi,
+                    )}
+                    ragModeEnabled={ragModeEnabled}
+                  />
+                );
+              })}
               <MessageTokenUsageList
                 enabled={tokenUsageEnabled}
                 isLoading={thread.isLoading}
@@ -853,13 +1142,33 @@ export function MessageList({
               />
             </div>
           );
+          return (
+            <div key={"group-" + group.id} className="w-full">
+              {speakerShell ? speakerShell(group.messages, processingBody) : processingBody}
+            </div>
+          );
         });
-          const leftoverRewriteItems = didRenderRewriteAboveFile
+          const leftoverRewriteItems = documentRewriteItems.filter(
-            ? rewriteItemsBelowFile
+            (item) => item.source.kind !== "artifact" || item.operation !== "rewrite",
-            : documentRewriteItems;
+          );
           return (
             <>
               {grouped}
+              {shouldRenderUnattachedKnowledgeRetrievalProgress({
+                frameCount: knowledgeRetrievalProgress.length,
+                isLoading: thread.isLoading,
+                hasHumanMessage,
+              }) &&
+                !didRenderLiveKnowledgeRetrieval && (
+                  <SmartKnowledgeRetrievalTrace
+                    messages={[]}
+                    progressFrames={knowledgeRetrievalProgress}
+                    isLoading={thread.isLoading}
+                    onOpenResult={(item, target) =>
+                      setSelectedRetrievalResult({ item, target })
+                    }
+                  />
+                )}
               {leftoverRewriteItems.map((item) => (
                 <DocumentRewriteTimeline key={item.id} item={item} />
               ))}
@@ -881,6 +1190,16 @@ export function MessageList({
         aria-label="回到最新"
         title="回到最新"
       />
+      <WeKnoraSourceDrawer
+        open={selectedRetrievalResult !== null}
+        target={selectedRetrievalResult?.target ?? null}
+        title={selectedRetrievalResult?.item.title}
+        quote={selectedRetrievalResult?.item.preview ?? ""}
+        collapseRetrievedExcerptByDefault
+        onOpenChange={(open) => {
+          if (!open) setSelectedRetrievalResult(null);
+        }}
+      />
     </Conversation>
   );
 }
@@ -924,8 +1243,9 @@ export type SetupWritingApprovalPayload = {
   outline?: string;
 };
 
-export type SetupReportStructureApprovalPayload = {
+export type SetupReportStructureApprovalPayload = {
-  title?: string;
+  kind?: "report_structure" | "gongwen_template";
+  title?: string;
   name?: string;
   content?: string;
   structure_mode?: string;
@@ -1028,8 +1348,8 @@ function SetupAgentApprovalCard({
     return null;
   }
 
-  const approvalPayload = payload;
+  const approvalPayload = payload;
-  const busy = disabled || submitting !== null;
+  const busy = disabled || submitting !== null;
   const skills = approvalPayload.skills ?? [];
 
   async function run(action: "approve" | "reject") {
@@ -1325,7 +1645,7 @@ const STRUCTURE_MODE_LABELS: Record<string, string> = {
   adaptive: "弹性大纲",
 };
 
-function SetupReportStructureApprovalCard({
+function SetupReportStructureApprovalCard({
   disabled,
   message,
   onApprove,
@@ -1343,7 +1663,8 @@ function SetupReportStructureApprovalCard({
     return null;
   }
 
-  const approvalPayload = payload;
+  const approvalPayload = payload;
+  const isGongwenTemplate = approvalPayload.kind === "gongwen_template";
   const busy = disabled || submitting !== null;
   const directions = approvalPayload.retrieval_directions ?? [];
   const skills = approvalPayload.retrieval_skills ?? [];
@@ -1368,8 +1689,8 @@ function SetupReportStructureApprovalCard({
     <div className="border-border bg-card text-card-foreground w-full rounded-lg border p-4 shadow-sm">
       <div className="space-y-3">
         <div>
-          <div className="text-muted-foreground text-xs font-medium">报告结构建议</div>
+          <div className="text-muted-foreground text-xs font-medium">{isGongwenTemplate ? "公文模板结构建议" : "报告结构建议"}</div>
-          <div className="text-sm font-medium">确认后将应用到右侧表单，再点保存入库。</div>
+          <div className="text-sm font-medium">{isGongwenTemplate ? "确认后将应用到右侧模板表单，再保存到模板中心。" : "确认后将应用到右侧表单，再点保存入库。"}</div>
         </div>
 
         {approvalPayload.title ? (
@@ -1411,7 +1732,7 @@ function SetupReportStructureApprovalCard({
 
         {approvalPayload.content ? (
           <div className="space-y-1">
-            <div className="text-muted-foreground text-xs">报告大纲</div>
+            <div className="text-muted-foreground text-xs">{isGongwenTemplate ? "模板正文结构" : "报告大纲"}</div>
             <pre className="bg-muted max-h-52 overflow-auto rounded-md p-3 text-xs whitespace-pre-wrap">
               {approvalPayload.content}
             </pre>

frontend-web/src/components/workspace/messages/message-token-usage.tsx

@@ -74,6 +74,18 @@ export function SpeedLegend({
 }
 
 export function SpeedPill({ metric }: { metric: MessageMetric }) {
+  if (metric.isPaused) {
+    return (
+      <span
+        className="inline-flex items-center gap-1.5"
+        title="本段生成停顿，窗口内无新 token"
+      >
+        <GaugeIcon className="text-muted-foreground size-3" />
+        <span className="text-muted-foreground">暂停</span>
+      </span>
+    );
+  }
+
   const fill = Math.max(0, Math.min(1, metric.tokensPerSec / FULL_SCALE_TOKENS_PER_SEC));
   const { color, label } = classifySpeed(metric.tokensPerSec);
   const display =
@@ -85,7 +97,7 @@ export function SpeedPill({ metric }: { metric: MessageMetric }) {
   return (
     <span
       className="inline-flex items-center gap-1.5"
-      title={`${label} · ${metric.fromUsage ? "按 output_tokens 计算" : "字符估算 ≈ 2 字符 / token"}`}
+      title={`${label} · ${metric.fromUsage ? "按本段 output_tokens / 本段生成时长" : "字符估算 ≈ 2 字符 / token"}`}
     >
       <GaugeIcon className="size-3" style={{ color }} />
       <span className="font-mono tabular-nums" style={{ color }}>

frontend-web/src/components/workspace/messages/multi-round-rag-message-list.tsx

@@ -0,0 +1,472 @@
+import {
+  BookOpenIcon,
+  ChevronDownIcon,
+  FileTextIcon,
+  Loader2Icon,
+  SearchIcon,
+  SparklesIcon,
+} from "lucide-react";
+import { useState } from "react";
+
+import {
+  Conversation,
+  ConversationContent,
+  ConversationScrollButton,
+} from "@/components/ai-elements/conversation";
+import {
+  Message as AIElementMessage,
+  MessageContent as AIElementMessageContent,
+} from "@/components/ai-elements/message";
+import {
+  Collapsible,
+  CollapsibleContent,
+  CollapsibleTrigger,
+} from "@/components/ui/collapsible";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogHeader,
+  DialogTitle,
+} from "@/components/ui/dialog";
+import { useRehypeSplitWordsIntoSpans } from "@/core/rehype";
+import type { MessageResponseProps } from "@/components/ai-elements/message";
+import type {
+  MultiRoundRagChatMessage,
+  MultiRoundRagRetrieval,
+  MultiRoundRagRound,
+  MultiRoundRagTrace,
+} from "@/core/threads/use-multi-round-rag";
+import { cn } from "@/lib/utils";
+
+import { MarkdownContent } from "./markdown-content";
+
+export function MultiRoundRagMessageList({
+  className,
+  messages,
+  isLoading,
+  paddingBottom = 160,
+}: {
+  className?: string;
+  messages: MultiRoundRagChatMessage[];
+  isLoading: boolean;
+  paddingBottom?: number;
+}) {
+  const rehypePlugins = useRehypeSplitWordsIntoSpans(isLoading);
+
+  return (
+    <Conversation className={cn("flex size-full flex-col justify-center", className)}>
+      <ConversationContent
+        className="mx-auto w-full max-w-(--container-width-lg) gap-8 pt-10"
+      >
+        {messages.map((message, index) => {
+          const isLastAssistant =
+            message.role === "assistant" && index === messages.length - 1;
+          return (
+            <AIElementMessage
+              key={message.id}
+              className="group/conversation-message relative w-full"
+              from={message.role === "user" ? "user" : "assistant"}
+            >
+              {message.role === "user" ? (
+                <AIElementMessageContent className="w-fit">
+                  <p className="whitespace-pre-wrap text-[15px] leading-7">
+                    {message.content}
+                  </p>
+                </AIElementMessageContent>
+              ) : (
+                <AIElementMessageContent className="w-full">
+                  <MultiRoundRagAssistantBody
+                    content={
+                      typeof message.content === "string" ? message.content : ""
+                    }
+                    thinkingTrace={message.thinkingTrace}
+                    isLoading={isLastAssistant && isLoading}
+                    rehypePlugins={rehypePlugins}
+                  />
+                </AIElementMessageContent>
+              )}
+            </AIElementMessage>
+          );
+        })}
+        <div style={{ height: `${paddingBottom}px` }} />
+      </ConversationContent>
+      <ConversationScrollButton
+        className="pointer-events-auto z-20 size-9 shadow-md bottom-40"
+        aria-label="回到最新"
+        title="回到最新"
+      />
+    </Conversation>
+  );
+}
+
+export function MultiRoundRagAssistantBody({
+  content,
+  thinkingTrace,
+  isLoading,
+  rehypePlugins,
+}: {
+  content: string;
+  thinkingTrace?: MultiRoundRagTrace | null;
+  isLoading: boolean;
+  rehypePlugins: MessageResponseProps["rehypePlugins"];
+}) {
+  const [selected, setSelected] = useState<MultiRoundRagRetrieval | null>(
+    null,
+  );
+  const trace = thinkingTrace;
+  const answer = trace?.finalAnswerMarkdown || content;
+
+  return (
+    <>
+      {trace && (
+        <MultiRoundRagTraceView
+          trace={trace}
+          isLoading={isLoading}
+          rehypePlugins={rehypePlugins}
+          onSelectRetrieval={setSelected}
+        />
+      )}
+      <section className="mt-4">
+        <div className="text-foreground mb-2 text-sm font-medium">最终回答</div>
+        {answer ? (
+          <MarkdownContent
+            content={answer}
+            isLoading={isLoading}
+            rehypePlugins={rehypePlugins}
+            className="my-0 text-[15px] leading-7"
+          />
+        ) : (
+          <div className="text-muted-foreground flex items-center gap-2 text-sm">
+            <Loader2Icon className="size-4 animate-spin" />
+            正在生成思考过程与检索内容...
+          </div>
+        )}
+      </section>
+      <RetrievalDetailDialog
+        item={selected}
+        onOpenChange={(open) => {
+          if (!open) setSelected(null);
+        }}
+      />
+    </>
+  );
+}
+
+function MultiRoundRagTraceView({
+  trace,
+  isLoading,
+  rehypePlugins,
+  onSelectRetrieval,
+}: {
+  trace: MultiRoundRagTrace;
+  isLoading: boolean;
+  rehypePlugins: MessageResponseProps["rehypePlugins"];
+  onSelectRetrieval: (item: MultiRoundRagRetrieval) => void;
+}) {
+  const [open, setOpen] = useState(!trace.thinkingComplete);
+
+  return (
+    <Collapsible
+      open={open}
+      onOpenChange={setOpen}
+      className="not-prose w-full min-w-0 max-w-5xl"
+    >
+      <CollapsibleTrigger asChild>
+        <button
+          type="button"
+          className="text-muted-foreground hover:text-foreground flex w-full items-center gap-2 text-sm transition-colors"
+        >
+          {trace.thinkingComplete ? (
+            <SparklesIcon className="text-primary size-4 shrink-0" />
+          ) : (
+            <Loader2Icon className="text-primary size-4 shrink-0 animate-spin" />
+          )}
+          <span>{trace.title || "思考过程"}</span>
+          <span className="text-muted-foreground/70 text-xs">
+            共 {trace.rounds.length} 轮推理与检索
+          </span>
+          <ChevronDownIcon
+            className={cn("ml-auto size-4 transition-transform", !open && "-rotate-90")}
+          />
+        </button>
+      </CollapsibleTrigger>
+      <CollapsibleContent className="mt-3 space-y-3">
+        {trace.rounds.map((round, index) => (
+          <div
+            key={round.id}
+            className={cn("relative pl-5", index < trace.rounds.length - 1 && "pb-1")}
+          >
+            {index < trace.rounds.length - 1 && (
+              <span className="bg-primary/25 absolute bottom-0 left-[7px] top-8 w-px" />
+            )}
+            <span className="border-primary bg-background absolute left-0 top-4 size-3.5 rounded-full border-2" />
+            <MultiRoundRagRoundCard
+              index={index + 1}
+              round={round}
+              isLoading={isLoading}
+              isActiveRound={isLoading && index === trace.rounds.length - 1}
+              rehypePlugins={rehypePlugins}
+              onSelectRetrieval={onSelectRetrieval}
+            />
+          </div>
+        ))}
+      </CollapsibleContent>
+    </Collapsible>
+  );
+}
+
+function MultiRoundRagRoundCard({
+  index,
+  round,
+  isLoading,
+  isActiveRound,
+  rehypePlugins,
+  onSelectRetrieval,
+}: {
+  index: number;
+  round: MultiRoundRagRound;
+  isLoading: boolean;
+  isActiveRound: boolean;
+  rehypePlugins: MessageResponseProps["rehypePlugins"];
+  onSelectRetrieval: (item: MultiRoundRagRetrieval) => void;
+}) {
+  const query = round.query.trim();
+  const searching = Boolean(query && round.queryLoading);
+  const showQuery = Boolean(query);
+  const showRetrievals = showQuery || round.retrievals.length > 0;
+  const [open, setOpen] = useState(true);
+
+  return (
+    <Collapsible open={open} onOpenChange={setOpen}>
+      <article className="overflow-hidden rounded-lg border border-border/70 bg-background">
+        <CollapsibleTrigger asChild>
+          <button
+            type="button"
+            className="hover:bg-muted/40 flex min-h-11 w-full items-center gap-2 px-3 py-2.5 text-left text-sm transition-colors"
+          >
+            <span className="bg-primary/10 text-primary flex size-6 shrink-0 items-center justify-center rounded-full text-xs font-medium">
+              {index}
+            </span>
+            <span className="min-w-0 flex-1 truncate font-medium">{round.title}</span>
+            {searching ? (
+              <span className="text-primary inline-flex items-center gap-1 text-[11px]">
+                <Loader2Icon className="size-3 animate-spin" />
+                检索中
+              </span>
+            ) : isActiveRound ? null : (
+              <span className="text-muted-foreground text-[11px]">已完成</span>
+            )}
+            <ChevronDownIcon
+              className={cn("text-muted-foreground size-4 shrink-0 transition-transform", !open && "-rotate-90")}
+            />
+          </button>
+        </CollapsibleTrigger>
+        <CollapsibleContent className="border-border/60 space-y-3 border-t px-3 pb-3 pt-3">
+        {round.thoughtMarkdown && (
+          <section>
+            <div className="text-muted-foreground mb-1.5 flex items-center gap-2 text-sm font-medium">
+              <SparklesIcon className="size-4" />
+              思考内容
+            </div>
+            <MarkdownContent
+              content={round.thoughtMarkdown}
+              isLoading={isLoading}
+              rehypePlugins={rehypePlugins}
+              className="text-muted-foreground my-0 text-sm leading-6"
+            />
+          </section>
+        )}
+        {showQuery && (
+          <div
+            className="border-primary/20 bg-primary/5 text-primary inline-flex max-w-full items-center gap-2 rounded-full border px-3 py-1.5"
+            aria-live={searching ? "polite" : undefined}
+          >
+            {searching ? (
+              <Loader2Icon className="size-3.5 shrink-0 animate-spin" />
+            ) : (
+              <SearchIcon className="size-3.5 shrink-0" />
+            )}
+            <span className="text-primary/80 shrink-0 text-xs">
+              {round.queryTitle || "检索词"}
+            </span>
+            <span className="min-w-0 truncate text-xs font-medium">
+              {query}
+            </span>
+          </div>
+        )}
+        {showRetrievals && (
+          <section>
+            <div className="mb-2 flex items-center gap-2 text-sm font-medium">
+              <FileTextIcon className="text-muted-foreground size-4" />
+              检索内容
+              <span className="text-muted-foreground text-xs font-normal">
+                {round.retrievals.length} 条
+              </span>
+            </div>
+            {searching ? (
+              <div className="text-muted-foreground flex items-center gap-2 rounded-lg border border-border/70 px-3 py-3 text-sm">
+                <Loader2Icon className="text-primary size-4 animate-spin" />
+                正在召回相关内容...
+              </div>
+            ) : (
+              <RetrievalCardList
+                items={round.retrievals}
+                onSelect={onSelectRetrieval}
+              />
+            )}
+          </section>
+        )}
+        {(round.extractInfo || round.extractContent || round.extractLoading) && (
+          <section className="rounded-lg border border-border/70 px-3 py-3">
+            <div className="mb-2 flex items-center gap-2 text-sm font-medium">
+              <BookOpenIcon className="text-muted-foreground size-4" />
+              阅读内容
+              {round.extractLoading && <Loader2Icon className="text-primary size-3.5 animate-spin" />}
+            </div>
+            {round.extractInfo && (
+              <p className="text-muted-foreground text-sm leading-6">{round.extractInfo}</p>
+            )}
+            {round.extractContent && (
+              <p className="mt-2 text-sm leading-6 whitespace-pre-wrap">{round.extractContent}</p>
+            )}
+          </section>
+        )}
+        {round.textidContent && (
+          <section className="rounded-lg border border-border/70 px-3 py-3 text-sm leading-6 whitespace-pre-wrap">
+            {round.textidContent}
+          </section>
+        )}
+      </CollapsibleContent>
+      </article>
+    </Collapsible>
+  );
+}
+
+function RetrievalCardList({
+  items,
+  onSelect,
+}: {
+  items: MultiRoundRagRetrieval[];
+  onSelect: (item: MultiRoundRagRetrieval) => void;
+}) {
+  if (items.length === 0) {
+    return <p className="text-muted-foreground py-1 text-sm">本轮未召回相关资料。</p>;
+  }
+  return (
+    <div className="space-y-2">
+      {items.map((item, index) => (
+        <RetrievalCard
+          key={`${item.id ?? item.title}-${index}`}
+          item={item}
+          index={index + 1}
+          defaultOpen={index === 0}
+          onSelect={onSelect}
+        />
+      ))}
+    </div>
+  );
+}
+
+function RetrievalCard({
+  item,
+  index,
+  defaultOpen,
+  onSelect,
+}: {
+  item: MultiRoundRagRetrieval;
+  index: number;
+  defaultOpen: boolean;
+  onSelect: (item: MultiRoundRagRetrieval) => void;
+}) {
+  const [open, setOpen] = useState(defaultOpen);
+  const meta = retrievalMeta(item);
+
+  if (item.type === "user_behavior") {
+    return (
+      <div className="rounded-xl border border-border/70 px-3 py-2 text-sm">
+        <span className="text-muted-foreground mr-2 font-medium">{index}.</span>
+        {item.title}
+      </div>
+    );
+  }
+
+  return (
+    <Collapsible open={open} onOpenChange={setOpen}>
+      <div className="overflow-hidden rounded-xl border border-border/70 bg-background">
+        <CollapsibleTrigger asChild>
+          <button
+            type="button"
+            className="hover:bg-muted/40 flex min-h-11 w-full items-center gap-2 px-3 py-2.5 text-left transition-colors"
+          >
+            <span className="bg-muted text-muted-foreground flex size-5 shrink-0 items-center justify-center rounded-md text-[11px] font-medium">
+              {index}
+            </span>
+            <div className="min-w-0 flex-1">
+              <div className="truncate text-sm font-medium" title={item.title}>
+                {item.title}
+              </div>
+              {meta && (
+                <div className="text-muted-foreground truncate text-xs">{meta}</div>
+              )}
+            </div>
+            <ChevronDownIcon
+              className={cn("text-muted-foreground size-4 shrink-0 transition-transform", !open && "-rotate-90")}
+            />
+          </button>
+        </CollapsibleTrigger>
+        <CollapsibleContent className="border-border/60 border-t px-3 pb-3 pt-2.5">
+          <button
+            type="button"
+            className="text-muted-foreground hover:text-foreground line-clamp-3 w-full text-left text-sm leading-6 whitespace-pre-wrap"
+            onClick={() => onSelect(item)}
+          >
+            {item.content || "暂无资料摘要"}
+          </button>
+        </CollapsibleContent>
+      </div>
+    </Collapsible>
+  );
+}
+
+function retrievalMeta(item: MultiRoundRagRetrieval): string {
+  if (item.type === "more") return `时间：${item.time || "-"}`;
+  if (item.type === "task") return `关键词：${item.keywords || "-"}`;
+  if (item.type === "hx") return `平台：${item.platform || "-"}  粉丝数:${item.fans ?? "-"}`;
+  if (
+    item.type === "taiwan_news" ||
+    item.type === "world_news" ||
+    item.type === "messaage_comment" ||
+    item.type === "america_news"
+  ) {
+    return `平台：${item.platform || "-"}${item.comment_count ? `  评论数:${item.comment_count}` : ""}`;
+  }
+  if (item.type === "get_time_data") return `时间：${item.time || "-"}  热度:${item.hot_num ?? "-"}`;
+  return [item.source, item.time].filter(Boolean).join(" · ");
+}
+
+function RetrievalDetailDialog({
+  item,
+  onOpenChange,
+}: {
+  item: MultiRoundRagRetrieval | null;
+  onOpenChange: (open: boolean) => void;
+}) {
+  const content = item?.content;
+  return (
+    <Dialog open={!!item} onOpenChange={onOpenChange}>
+      <DialogContent className="max-h-[min(42rem,calc(100vh-2rem))] max-w-2xl overflow-hidden p-5 sm:max-w-2xl">
+        <DialogHeader className="pr-8">
+          <DialogTitle className="leading-relaxed">{item?.title || "引用资料"}</DialogTitle>
+          <DialogDescription className="space-y-1 text-xs">
+            {item?.time && <span className="block">时间：{item.time}</span>}
+            {item?.source && <span className="block">来源：{item.source}</span>}
+          </DialogDescription>
+        </DialogHeader>
+        <div className="bg-muted/50 max-h-[min(26rem,calc(100vh-16rem))] overflow-auto rounded-xl p-3 text-sm leading-7 whitespace-pre-wrap">
+          {content || "暂无引用内容"}
+        </div>
+      </DialogContent>
+    </Dialog>
+  );
+}

frontend-web/src/components/workspace/messages/retrieved-file-list.tsx

@@ -0,0 +1,207 @@
+import { ChevronDownIcon, DownloadIcon, EyeIcon, Loader2Icon } from "lucide-react";
+import { useContext, useState } from "react";
+import { toast } from "sonner";
+
+import { Button } from "@/components/ui/button";
+import {
+  Collapsible,
+  CollapsibleContent,
+  CollapsibleTrigger,
+} from "@/components/ui/collapsible";
+import { downloadArtifactFile } from "@/core/artifacts/download";
+import { urlOfArtifact } from "@/core/artifacts/utils";
+import type { WeKnoraSourceTarget } from "@/core/llmwiki/source-links";
+import type { RetrievedFile } from "@/core/messages/retrieved-files";
+import { getFileIcon } from "@/core/utils/files";
+import {
+  getLlmWikiDocument,
+  getLlmWikiDocumentPreview,
+  getLlmWikiSourceContext,
+  resolveLlmWikiSourceKnowledgeBase,
+} from "@/strategy-components/api/llmwiki";
+import { WeKnoraSourceDrawer } from "@/strategy-components/components/resource-management/llmwiki/WeKnoraSourceDrawer";
+
+import { ThreadContext } from "./context";
+import { UploadedFilePreviewDialog } from "./uploaded-file-preview-dialog";
+
+// File links belong to the upstream service. Never attach DeerFlow auth headers.
+const fetchExternalFile: typeof fetch = (input, init) =>
+  fetch(input, { ...init, credentials: "omit" });
+
+export function RetrievedFileList({ files, threadId }: { files: RetrievedFile[]; threadId: string }) {
+  const { isMock, publicShareCode } = useContext(ThreadContext) ?? {};
+  const [expanded, setExpanded] = useState(false);
+  const visible = files.filter((file) => !(publicShareCode && file.kind === "knowledge"));
+  // Results arrive in retrieval order; keep the newest file outside the fold.
+  const latest = visible.at(-1);
+  if (!latest) return null;
+  const older = visible.slice(0, -1).reverse();
+  return (
+    <Collapsible asChild open={expanded} onOpenChange={setExpanded}>
+      <section aria-label="检索到的文件" className="not-prose mt-3 space-y-2">
+        <div className="flex items-center justify-between gap-2">
+          <div className="text-muted-foreground text-xs">检索到的文件 · {visible.length} 个</div>
+          {older.length > 0 && (
+            <CollapsibleTrigger asChild>
+              <Button type="button" size="sm" variant="ghost" className="h-7 gap-1 px-2 text-xs">
+                {expanded ? "收起" : "展开"}
+                <ChevronDownIcon className={`size-3.5 transition-transform ${expanded ? "rotate-180" : ""}`} />
+              </Button>
+            </CollapsibleTrigger>
+          )}
+        </div>
+        <ul className="grid gap-2">
+          <RetrievedFileCard
+            key={latest.key}
+            file={latest}
+            threadId={threadId}
+            isMock={isMock}
+            publicShareCode={publicShareCode}
+          />
+        </ul>
+        <CollapsibleContent>
+          <ul className="grid gap-2">
+            {older.map((file) => (
+              <RetrievedFileCard
+                key={file.key}
+                file={file}
+                threadId={threadId}
+                isMock={isMock}
+                publicShareCode={publicShareCode}
+              />
+            ))}
+          </ul>
+        </CollapsibleContent>
+      </section>
+    </Collapsible>
+  );
+}
+
+function RetrievedFileCard({ file, threadId, isMock, publicShareCode }: {
+  file: RetrievedFile;
+  threadId: string;
+  isMock?: boolean;
+  publicShareCode?: string;
+}) {
+  const [previewOpen, setPreviewOpen] = useState(false);
+  const [preparingPreview, setPreparingPreview] = useState(false);
+  const [downloading, setDownloading] = useState(false);
+  const [knowledgeTarget, setKnowledgeTarget] = useState<WeKnoraSourceTarget | null>(null);
+  const fileUrl = file.kind === "artifact"
+    ? urlOfArtifact({ filepath: file.path.split("/").map(encodeURIComponent).join("/"), threadId, isMock, publicShareCode })
+    : file.kind === "external" ? file.url : "";
+
+  const resolveKnowledgeTarget = async () => {
+    if (file.kind !== "knowledge") throw new Error("当前文件不是知识库文档");
+    if (knowledgeTarget) return knowledgeTarget;
+    const knowledgeBaseId = await resolveLlmWikiSourceKnowledgeBase(file.target.knowledgeBaseId);
+    const target = { ...file.target, knowledgeBaseId };
+    setKnowledgeTarget(target);
+    return target;
+  };
+
+  const preview = async () => {
+    if (preparingPreview) return;
+    setPreparingPreview(true);
+    try {
+      if (file.kind === "knowledge") await resolveKnowledgeTarget();
+      setPreviewOpen(true);
+    } catch (error) {
+      toast.error(error instanceof Error ? error.message : "文件预览失败");
+    } finally {
+      setPreparingPreview(false);
+    }
+  };
+
+  const download = async () => {
+    if (downloading || file.kind === "external") return;
+    setDownloading(true);
+    try {
+      if (file.kind === "artifact") {
+        await downloadArtifactFile({
+          filepath: file.path.split("/").map(encodeURIComponent).join("/"), threadId, isMock, publicShareCode,
+        });
+      } else {
+        const target = await resolveKnowledgeTarget();
+        let documentId = target.documentId;
+        if (!documentId && target.chunkId) {
+          const context = await getLlmWikiSourceContext(target.knowledgeBaseId, target.chunkId);
+          documentId = context.document_id || undefined;
+        }
+        if (!documentId) throw new Error("当前检索结果没有可下载的文件原件，请先查看预览");
+        const [blob, document] = await Promise.all([
+          getLlmWikiDocumentPreview(target.knowledgeBaseId, documentId),
+          getLlmWikiDocument(target.knowledgeBaseId, documentId).catch(() => null),
+        ]);
+        const objectUrl = URL.createObjectURL(blob);
+        const anchor = window.document.createElement("a");
+        anchor.href = objectUrl;
+        anchor.download = document?.file_name || file.name;
+        anchor.rel = "noopener";
+        window.document.body.appendChild(anchor);
+        anchor.click();
+        anchor.remove();
+        window.setTimeout(() => URL.revokeObjectURL(objectUrl), 30_000);
+      }
+    } catch (error) {
+      toast.error(error instanceof Error ? error.message : "文件下载失败");
+    } finally {
+      setDownloading(false);
+    }
+  };
+
+  return (
+    <li className="bg-card flex flex-wrap items-center gap-3 rounded-lg border p-3">
+      {getFileIcon(file.name, "text-muted-foreground size-5 shrink-0")}
+      <div className="min-w-0 flex-1 basis-40">
+        <div className="text-sm font-medium break-words">{file.name}</div>
+        {file.source && <div className="text-muted-foreground mt-0.5 truncate text-xs">{file.source}</div>}
+      </div>
+      <div className="flex shrink-0 items-center gap-1">
+        {file.kind === "external" && file.previewUrl ? (
+          <Button asChild size="sm" variant="ghost">
+            <a href={file.previewUrl} target="_blank" rel="noopener noreferrer">
+              <EyeIcon className="size-4" />预览
+            </a>
+          </Button>
+        ) : (
+          <Button type="button" size="sm" variant="ghost" disabled={preparingPreview} onClick={() => void preview()}>
+            {preparingPreview ? <Loader2Icon className="size-4 animate-spin" /> : <EyeIcon className="size-4" />}预览
+          </Button>
+        )}
+        {file.kind === "external" ? (
+          <Button asChild size="sm" variant="ghost">
+            <a href={file.url} download={file.name} target="_blank" rel="noopener noreferrer">
+              <DownloadIcon className="size-4" />下载
+            </a>
+          </Button>
+        ) : (
+          <Button type="button" size="sm" variant="ghost" disabled={downloading} onClick={() => void download()}>
+            {downloading ? <Loader2Icon className="size-4 animate-spin" /> : <DownloadIcon className="size-4" />}下载
+          </Button>
+        )}
+      </div>
+      {previewOpen && (file.kind === "knowledge" ? (
+        <WeKnoraSourceDrawer
+          open
+          target={knowledgeTarget || file.target}
+          title={file.name}
+          quote={file.quote || ""}
+          onOpenChange={setPreviewOpen}
+        />
+      ) : (
+        <UploadedFilePreviewDialog
+          filename={file.name}
+          fileUrl={fileUrl}
+          open
+          onOpenChange={setPreviewOpen}
+          threadId={file.kind === "artifact" && !publicShareCode ? threadId : undefined}
+          virtualPath={file.kind === "artifact" ? file.path : undefined}
+          requestFile={file.kind === "external" ? fetchExternalFile : undefined}
+          onDownload={file.kind === "artifact" ? download : undefined}
+          downloading={downloading}
+        />
+      ))}
+    </li>
+  );
+}

frontend-web/src/components/workspace/messages/smart-knowledge-retrieval-trace.test.tsx

@@ -0,0 +1,406 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import { renderToStaticMarkup } from "react-dom/server";
+import type { Message } from "@langchain/langgraph-sdk";
+
+import type { KnowledgeRetrievalProgressFrame } from "@/core/threads/smart-knowledge-retrieval";
+import { SmartKnowledgeRetrievalTrace } from "./smart-knowledge-retrieval-trace";
+
+const completedFrames: KnowledgeRetrievalProgressFrame[] = [
+  {
+    type: "knowledge_retrieval_progress",
+    version: 1,
+    mode: "smart_reasoning",
+    operation: "knowledge_search",
+    status: "started",
+    queries: ["成都世运会"],
+  },
+  {
+    type: "knowledge_retrieval_progress",
+    version: 1,
+    mode: "smart_reasoning",
+    operation: "knowledge_search",
+    status: "completed",
+    result_count: 3,
+    elapsed_ms: 420,
+  },
+  {
+    type: "knowledge_retrieval_progress",
+    version: 1,
+    mode: "smart_reasoning",
+    operation: "wiki_search",
+    status: "started",
+    pattern: "火炬|开幕|闭幕",
+  },
+  {
+    type: "knowledge_retrieval_progress",
+    version: 1,
+    mode: "smart_reasoning",
+    operation: "wiki_search",
+    status: "completed",
+    result_count: 4,
+    elapsed_ms: 1380,
+  },
+];
+
+test("completed and replayed retrieval traces start collapsed with their hit summary visible", () => {
+  const html = renderToStaticMarkup(
+    <SmartKnowledgeRetrievalTrace
+      messages={[]}
+      progressFrames={completedFrames}
+      isLoading={false}
+    />,
+  );
+
+  assert.match(html, /aria-label="展开智能检索过程"/);
+  assert.match(html, /aria-expanded="false"/);
+  assert.match(html, /调用知识库 2 次 · 原始文档命中 3 条 · Wiki 命中 4 条/);
+  assert.match(html, /累计耗时 1\.8 秒/);
+  assert.doesNotMatch(html, /共\s*\d+\s*轮|第\s*\d+\s*轮检索/);
+});
+
+test("keeps a current pending tool call in loading state before its started frame arrives", () => {
+  const messages = [
+    {
+      type: "ai",
+      id: "ai-pending-wiki",
+      content: "",
+      tool_calls: [
+        {
+          id: "wiki-pending",
+          name: "ordinary_wiki_search",
+          args: { pattern: "数字中国|数据要素" },
+        },
+      ],
+    },
+  ] as unknown as Message[];
+  const html = renderToStaticMarkup(
+    <SmartKnowledgeRetrievalTrace
+      messages={messages}
+      progressFrames={[]}
+      isLoading
+    />,
+  );
+
+  assert.match(html, /检索中/);
+  assert.match(html, /正在查 Wiki/);
+  assert.doesNotMatch(html, /部分步骤失败|部分步骤未完成|已中止/);
+});
+
+test("labels and normalizes a visible model-authored regex", () => {
+  const html = renderToStaticMarkup(
+    <SmartKnowledgeRetrievalTrace
+      messages={[
+        {
+          type: "ai",
+          id: "ai-regex",
+          content: "",
+          tool_calls: [
+            {
+              id: "wiki-regex",
+              name: "ordinary_wiki_search",
+              args: { pattern: "^# [一-龥]{2,10}篇�" },
+            },
+          ],
+        },
+      ] as unknown as Message[]}
+      progressFrames={[]}
+      isLoading
+    />,
+  );
+
+  assert.match(html, /正则：\^# \\p\{Han\}\{2,10\}篇/);
+  assert.doesNotMatch(html, /一-龥|�/);
+});
+
+test("presents an interrupted historical action as neutral instead of failed", () => {
+  const messages = [
+    {
+      type: "ai",
+      id: "ai-interrupted-wiki",
+      content: "",
+      tool_calls: [
+        {
+          id: "wiki-interrupted",
+          name: "ordinary_wiki_search",
+          args: { pattern: "数字中国" },
+        },
+      ],
+    },
+  ] as unknown as Message[];
+  const html = renderToStaticMarkup(
+    <SmartKnowledgeRetrievalTrace
+      messages={messages}
+      progressFrames={[]}
+      isLoading={false}
+    />,
+  );
+
+  assert.match(html, /检索已结束（部分步骤未完成）/);
+  assert.doesNotMatch(html, /部分步骤失败|部分步骤异常/);
+});
+
+test("an in-flight retrieval stays expanded and does not expose a collapse control", () => {
+  const html = renderToStaticMarkup(
+    <SmartKnowledgeRetrievalTrace
+      messages={[]}
+      progressFrames={[completedFrames[0]!]}
+      isLoading
+    />,
+  );
+
+  assert.match(html, /data-state="open"/);
+  assert.match(html, /检索中/);
+  assert.match(html, /成都世运会/);
+  assert.doesNotMatch(html, /收起智能检索过程|展开智能检索过程/);
+});
+
+test("completed retrieval can be collapsed while the final answer is still streaming", () => {
+  const html = renderToStaticMarkup(
+    <SmartKnowledgeRetrievalTrace
+      messages={[]}
+      progressFrames={completedFrames}
+      isLoading
+    />,
+  );
+
+  assert.match(html, /data-state="open"/);
+  assert.match(html, /检索完成/);
+  assert.match(html, /aria-label="收起智能检索过程"/);
+  assert.match(html, /检索 Wiki/);
+  assert.doesNotMatch(html, /第\s*\d+\s*轮检索/);
+  assert.doesNotMatch(html, /检索中/);
+});
+
+test("does not expose internal round numbering when retrieval cards are interleaved with skills", () => {
+  const html = renderToStaticMarkup(
+    <SmartKnowledgeRetrievalTrace
+      messages={[]}
+      progressFrames={[completedFrames[0]!]}
+      isLoading
+      roundOffset={2}
+    />,
+  );
+
+  assert.match(html, /检索原始文档/);
+  assert.doesNotMatch(html, /第\s*\d+\s*轮检索/);
+});
+
+test("renders stable retrieval results as right-drawer controls", () => {
+  const html = renderToStaticMarkup(
+    <SmartKnowledgeRetrievalTrace
+      messages={[]}
+      progressFrames={[
+        {
+          type: "knowledge_retrieval_progress",
+          version: 1,
+          mode: "smart_reasoning",
+          operation: "wiki_search",
+          status: "completed",
+          result_count: 1,
+          result_items: [
+            {
+              kind: "wiki",
+              knowledge_base_id: "kb-news",
+              slug: "news/opening",
+              title: "开幕新闻 Wiki",
+              preview: "页面摘要",
+            },
+          ],
+        },
+      ]}
+      isLoading
+      onOpenResult={() => undefined}
+    />,
+  );
+
+  assert.match(html, /data-retrieval-result-detail="true"/);
+  assert.match(html, /在右侧查看：开幕新闻 Wiki/);
+  assert.doesNotMatch(html, /data-retrieval-result-summary="true"/);
+});
+
+test("renders a Wiki read as a preview card with elapsed time and right-drawer entry", () => {
+  const html = renderToStaticMarkup(
+    <SmartKnowledgeRetrievalTrace
+      messages={[]}
+      progressFrames={[
+        {
+          type: "knowledge_retrieval_progress",
+          version: 1,
+          mode: "smart_reasoning",
+          operation: "wiki_read_page",
+          status: "completed",
+          result_count: 1,
+          knowledge_base_count: 1,
+          coverage: [
+            { knowledge_base: "数字中国政策目录智能检索远端验收" },
+          ],
+          elapsed_ms: 1260,
+          result_items: [
+            {
+              kind: "wiki",
+              knowledge_base_id: "kb-digital-china",
+              knowledge_base: "数字中国政策目录智能检索远端验收",
+              slug: "digital-china/timeline",
+              page_ref: "wiki-page:v1:digital-china-timeline",
+              title: "数字中国建设时间线",
+              content_markdown:
+                "页面正文概览，包含建设目标、关键年份、量化指标和制度保障。",
+            },
+          ],
+        },
+      ]}
+      isLoading
+      onOpenResult={() => undefined}
+    />,
+  );
+
+  assert.match(html, /读取结果/);
+  assert.match(html, /数字中国建设时间线/);
+  assert.match(html, /页面正文概览，包含建设目标/);
+  assert.match(html, /右侧查看/);
+  assert.match(html, /耗时 1\.3 秒/);
+  assert.match(html, /覆盖 1 个知识库：数字中国政策目录智能检索远端验收/);
+  assert.doesNotMatch(html, /知识库知识库/);
+  assert.match(html, /data-retrieval-result-detail="true"/);
+});
+
+test("shows all usable document-read results without a generic partial warning", () => {
+  const html = renderToStaticMarkup(
+    <SmartKnowledgeRetrievalTrace
+      messages={[]}
+      progressFrames={[
+        {
+          type: "knowledge_retrieval_progress",
+          version: 1,
+          mode: "smart_reasoning",
+          operation: "document_chunk_read",
+          status: "completed",
+          result_count: 20,
+          partial: true,
+          warning_codes: ["PROVIDER_CONTEXT_PARTIAL"],
+          message: "原文上下文读取完成，找到 20 条结果",
+          result_items: Array.from({ length: 20 }, (_, index) => ({
+            kind: "raw",
+            knowledge_base_id: "kb-news",
+            knowledge_base: "国内新闻",
+            knowledge_id: "document-long-news",
+            chunk_id: `chunk-${index + 1}`,
+            title: `长篇新闻第 ${index + 1} 段`,
+            content: `原文上下文第 ${index + 1} 段`,
+          })),
+        },
+      ]}
+      isLoading
+      onOpenResult={() => undefined}
+    />,
+  );
+
+  assert.equal(
+    (html.match(/data-retrieval-result-detail="true"/g) ?? []).length,
+    20,
+  );
+  assert.match(html, /长篇新闻第 1 段/);
+  assert.match(html, /长篇新闻第 20 段/);
+  assert.doesNotMatch(html, /部分数据源返回警告/);
+  assert.doesNotMatch(html, /部分完成/);
+});
+
+test("keeps historical results without stable ids as non-clickable summaries", () => {
+  const html = renderToStaticMarkup(
+    <SmartKnowledgeRetrievalTrace
+      messages={[]}
+      progressFrames={[
+        {
+          type: "knowledge_retrieval_progress",
+          version: 1,
+          mode: "smart_reasoning",
+          operation: "knowledge_search",
+          status: "completed",
+          result_count: 1,
+          result_items: [
+            {
+              kind: "raw",
+              knowledge_base: "旧知识库",
+              title: "旧检索结果",
+            },
+          ],
+        },
+      ]}
+      isLoading
+    />,
+  );
+
+  assert.match(html, /data-retrieval-result-summary="true"/);
+  assert.match(html, /该历史检索结果缺少稳定详情标识/);
+  assert.doesNotMatch(html, /data-retrieval-result-detail="true"/);
+});
+
+test("uses the whole turn as the dedupe scope for interleaved retrieval cards", () => {
+  const firstFrame: KnowledgeRetrievalProgressFrame = {
+    type: "knowledge_retrieval_progress",
+    version: 1,
+    mode: "smart_reasoning",
+    operation: "knowledge_search",
+    retrieval_id: "raw-first",
+    status: "completed",
+    result_count: 1,
+    result_items: [
+      {
+        kind: "raw",
+        knowledge_base_id: "kb-news",
+        knowledge_id: "document-trump",
+        chunk_id: "chunk-1",
+        title: "特朗普生平.txt",
+        content: "唐纳德·特朗普于1946年出生，曾任美国总统并从事商业活动。",
+      },
+    ],
+  };
+  const repeatedFrame: KnowledgeRetrievalProgressFrame = {
+    ...firstFrame,
+    retrieval_id: "raw-second",
+    result_items: [
+      {
+        kind: "raw",
+        knowledge_base_id: "kb-news",
+        knowledge_id: "document-trump",
+        chunk_id: "chunk-provider-remapped",
+        title: "特朗普生平.txt",
+        content: "唐纳德·特朗普于1946年出生，曾任美国总统并从事商业活动。",
+      },
+    ],
+  };
+
+  const firstHtml = renderToStaticMarkup(
+    <SmartKnowledgeRetrievalTrace
+      messages={[]}
+      progressFrames={[firstFrame]}
+      dedupeScopeMessages={[]}
+      dedupeScopeProgressFrames={[firstFrame, repeatedFrame]}
+      isLoading
+      onOpenResult={() => undefined}
+    />,
+  );
+  const repeatedHtml = renderToStaticMarkup(
+    <SmartKnowledgeRetrievalTrace
+      messages={[]}
+      progressFrames={[repeatedFrame]}
+      dedupeScopeMessages={[]}
+      dedupeScopeProgressFrames={[firstFrame, repeatedFrame]}
+      isLoading
+      onOpenResult={() => undefined}
+    />,
+  );
+
+  assert.equal(
+    (firstHtml.match(/data-retrieval-result-detail="true"/g) ?? []).length,
+    1,
+  );
+  assert.equal(
+    (repeatedHtml.match(/data-retrieval-result-detail="true"/g) ?? []).length,
+    0,
+  );
+  assert.match(repeatedHtml, /本次查询结果均已在前面展示/);
+  assert.doesNotMatch(repeatedHtml, /命中 1 条/);
+});

frontend-web/src/components/workspace/messages/smart-knowledge-retrieval-trace.tsx

@@ -0,0 +1,525 @@
+import type { Message } from "@langchain/langgraph-sdk";
+import {
+  AlertCircleIcon,
+  BookOpenTextIcon,
+  CheckCircle2Icon,
+  ChevronDownIcon,
+  CirclePauseIcon,
+  DatabaseIcon,
+  Loader2Icon,
+  PanelRightOpenIcon,
+  SearchCheckIcon,
+} from "lucide-react";
+import { useEffect, useMemo, useRef, useState } from "react";
+
+import {
+  Collapsible,
+  CollapsibleContent,
+  CollapsibleTrigger,
+} from "@/components/ui/collapsible";
+
+import {
+  buildSmartKnowledgeRetrievalRounds,
+  type KnowledgeRetrievalProgressFrame,
+  type SmartKnowledgeRetrievalAction,
+  type SmartKnowledgeRetrievalResultItem,
+} from "@/core/threads/smart-knowledge-retrieval";
+import type { WeKnoraSourceTarget } from "@/core/llmwiki/source-links";
+import { cn } from "@/lib/utils";
+
+function actionStatusText(action: SmartKnowledgeRetrievalAction): string {
+  if (action.status === "failed") return "检索失败";
+  if (action.status === "interrupted") return "已中止";
+  if (action.status === "running") {
+    return action.surface === "wiki" ? "正在查 Wiki" : "正在查知识库";
+  }
+  if (action.allResultsAlreadyShown) return "均为已展示结果";
+  const hasUsableResults =
+    action.resultItems.length > 0 || (action.resultCount ?? 0) > 0;
+  const partialPrefix = action.partial && !hasUsableResults ? "部分完成 · " : "";
+  if (action.kind === "search") {
+    return `${partialPrefix}命中 ${action.resultCount ?? 0} 条`;
+  }
+  return typeof action.resultCount === "number"
+    ? `${partialPrefix}读取完成 · ${action.resultCount} 条`
+    : `${partialPrefix}读取完成`;
+}
+
+function formatElapsedTime(elapsedMs: number): string {
+  const normalized = Math.max(0, elapsedMs);
+  if (normalized < 1_000) return `${Math.round(normalized)} 毫秒`;
+  if (normalized < 60_000) {
+    const seconds = (normalized / 1_000).toFixed(1).replace(/\.0$/, "");
+    return `${seconds} 秒`;
+  }
+  const roundedSeconds = Math.round(normalized / 1_000);
+  const minutes = Math.floor(roundedSeconds / 60);
+  const seconds = roundedSeconds % 60;
+  return seconds > 0 ? `${minutes} 分 ${seconds} 秒` : `${minutes} 分钟`;
+}
+
+function channelText(channel: string | undefined): string | null {
+  if (!channel) return null;
+  if (channel === "local_wiki_mirror") return "本地 Wiki 镜像";
+  if (channel === "provider") return "知识库 Wiki";
+  if (channel === "mixed") return "本地镜像 + 知识库 Wiki";
+  return channel;
+}
+
+function ActionStatusIcon({ action }: { action: SmartKnowledgeRetrievalAction }) {
+  if (action.status === "running") {
+    return <Loader2Icon className="size-4 animate-spin text-primary" />;
+  }
+  if (action.status === "completed") {
+    return <CheckCircle2Icon className="size-4 text-emerald-600 dark:text-emerald-400" />;
+  }
+  if (action.status === "failed") {
+    return <AlertCircleIcon className="size-4 text-amber-600 dark:text-amber-400" />;
+  }
+  return <CirclePauseIcon className="size-4 text-muted-foreground" />;
+}
+
+function resultDetailTarget(
+  item: SmartKnowledgeRetrievalResultItem,
+): WeKnoraSourceTarget | null {
+  if (!item.knowledgeBaseId) return null;
+  if (item.kind === "wiki" && item.wikiSlug) {
+    return {
+      knowledgeBaseId: item.knowledgeBaseId,
+      wikiSlug: item.wikiSlug,
+      tab: "wiki",
+    };
+  }
+  if (item.kind === "raw" && (item.chunkId || item.documentId)) {
+    return {
+      knowledgeBaseId: item.knowledgeBaseId,
+      chunkId: item.chunkId,
+      documentId: item.documentId,
+      tab: "documents",
+    };
+  }
+  return null;
+}
+
+function RetrievalAction({
+  action,
+  onOpenResult,
+}: {
+  action: SmartKnowledgeRetrievalAction;
+  onOpenResult?: (
+    item: SmartKnowledgeRetrievalResultItem,
+    target: WeKnoraSourceTarget,
+  ) => void;
+}) {
+  const SurfaceIcon = action.surface === "wiki" ? BookOpenTextIcon : DatabaseIcon;
+  const channel = channelText(action.channel);
+  return (
+    <div
+      className="rounded-lg border border-border/70 bg-background/75 px-3 py-2.5"
+      data-retrieval-operation={action.operation}
+    >
+      <div className="flex min-w-0 items-start gap-2.5">
+        <SurfaceIcon className="mt-0.5 size-4 shrink-0 text-muted-foreground" />
+        <div className="min-w-0 flex-1">
+          <div className="flex flex-wrap items-center justify-between gap-x-3 gap-y-1">
+            <span className="text-sm font-medium text-foreground">{action.label}</span>
+            <span
+              className={cn(
+                "inline-flex items-center gap-1 text-xs",
+                action.status === "running"
+                  ? "text-primary"
+                  : action.status === "completed"
+                    ? "text-emerald-700 dark:text-emerald-300"
+                    : action.status === "failed"
+                      ? "text-amber-700 dark:text-amber-300"
+                      : "text-muted-foreground",
+              )}
+            >
+              <ActionStatusIcon action={action} />
+              {actionStatusText(action)}
+            </span>
+          </div>
+
+          {action.queries.length > 0 && (
+            <div className="mt-2 flex flex-wrap items-center gap-1.5 text-xs">
+              <span className="text-muted-foreground">查询</span>
+              {action.queries.map((query) => (
+                <span
+                  key={query}
+                  className="max-w-full rounded-md bg-muted px-2 py-0.5 text-foreground/85 break-all"
+                >
+                  {query}
+                </span>
+              ))}
+            </div>
+          )}
+
+          <div className="mt-1.5 flex flex-wrap gap-x-3 gap-y-1 text-xs text-muted-foreground">
+            {typeof action.knowledgeBaseCount === "number" ? (
+              <span>
+                覆盖 {action.knowledgeBaseCount} 个知识库
+                {action.knowledgeBases.length > 0
+                  ? `：${action.knowledgeBases.join("、")}`
+                  : ""}
+              </span>
+            ) : action.knowledgeBases.length > 0 ? (
+              <span>知识库：{action.knowledgeBases.join("、")}</span>
+            ) : null}
+            {typeof action.scannedPages === "number" && (
+              <span>扫描 {action.scannedPages} 个 Wiki 页面</span>
+            )}
+            {typeof action.scannedChunks === "number" && (
+              <span>扫描 {action.scannedChunks} 个原文片段</span>
+            )}
+            {action.kind === "read" && typeof action.total === "number" && (
+              <span>共 {action.total} 个片段</span>
+            )}
+            {channel && <span>通道：{channel}</span>}
+            {typeof action.elapsedMs === "number" && (
+              <span>耗时 {formatElapsedTime(action.elapsedMs)}</span>
+            )}
+          </div>
+
+          {action.allResultsAlreadyShown ? (
+            <p className="mt-1.5 text-xs leading-5 text-muted-foreground">
+              本次查询结果均已在前面展示
+            </p>
+          ) : action.resultItems.length > 0 ? (
+            <div className="mt-2">
+              <div className="mb-1.5 text-xs text-muted-foreground">
+                {action.kind === "read" ? "读取结果" : "查询结果"}
+              </div>
+              {action.kind === "read" ? (
+                <div className="space-y-2">
+                  {action.resultItems.map((item) => {
+                    const target = onOpenResult
+                      ? resultDetailTarget(item)
+                      : null;
+                    const preview = item.preview?.trim().slice(0, 600);
+                    const content = (
+                      <>
+                        <div className="flex min-w-0 items-center justify-between gap-3">
+                          <span className="truncate text-sm font-medium text-foreground">
+                            {item.title}
+                          </span>
+                          {target && (
+                            <span className="inline-flex shrink-0 items-center gap-1 text-xs font-medium text-primary">
+                              右侧查看
+                              <PanelRightOpenIcon className="size-3.5" />
+                            </span>
+                          )}
+                        </div>
+                        {preview && (
+                          <p className="mt-1 line-clamp-3 whitespace-pre-wrap text-xs leading-5 text-muted-foreground">
+                            {preview}
+                          </p>
+                        )}
+                      </>
+                    );
+                    return target ? (
+                      <button
+                        key={item.id}
+                        type="button"
+                        data-retrieval-result-detail
+                        className="block w-full rounded-lg border border-primary/20 bg-primary/[0.045] px-3 py-2.5 text-left transition-colors hover:border-primary/40 hover:bg-primary/[0.075] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary/40"
+                        title={`在右侧查看：${item.title}`}
+                        onClick={() => onOpenResult?.(item, target)}
+                      >
+                        {content}
+                      </button>
+                    ) : (
+                      <div
+                        key={item.id}
+                        aria-disabled="true"
+                        data-retrieval-result-summary
+                        className="rounded-lg border border-border/70 bg-muted/45 px-3 py-2.5"
+                        title="该历史检索结果缺少稳定详情标识"
+                      >
+                        {content}
+                      </div>
+                    );
+                  })}
+                </div>
+              ) : (
+                <div className="flex flex-wrap gap-1.5">
+                  {action.resultItems.map((item) => {
+                    const target = onOpenResult
+                      ? resultDetailTarget(item)
+                      : null;
+                    return target ? (
+                      <button
+                        key={item.id}
+                        type="button"
+                        data-retrieval-result-detail
+                        className="inline-flex max-w-full items-center gap-1.5 rounded-md border border-primary/20 bg-primary/[0.055] px-2 py-1 text-left text-xs leading-5 text-foreground transition-colors hover:border-primary/40 hover:bg-primary/10 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary/40"
+                        title={`在右侧查看：${item.title}`}
+                        onClick={() => onOpenResult?.(item, target)}
+                      >
+                        <span className="truncate">{item.title}</span>
+                        <PanelRightOpenIcon className="size-3.5 shrink-0 text-primary" />
+                      </button>
+                    ) : (
+                      <span
+                        key={item.id}
+                        aria-disabled="true"
+                        data-retrieval-result-summary
+                        className="inline-flex max-w-full rounded-md bg-muted px-2 py-1 text-xs leading-5 text-muted-foreground"
+                        title="该历史检索结果缺少稳定详情标识"
+                      >
+                        <span className="truncate">{item.title}</span>
+                      </span>
+                    );
+                  })}
+                  {(action.resultCount ?? 0) > action.resultItems.length && (
+                    <span className="inline-flex items-center px-1 text-xs text-muted-foreground">
+                      另有 {(action.resultCount ?? 0) - action.resultItems.length} 条结果
+                    </span>
+                  )}
+                </div>
+              )}
+            </div>
+          ) : action.resultTitles.length > 0 ? (
+            <p className="mt-1.5 text-xs leading-5 text-muted-foreground">
+              结果摘要：{action.resultTitles.join("；")}
+              {(action.resultCount ?? 0) > action.resultTitles.length ? "；…" : ""}
+            </p>
+          ) : null}
+          {action.message && (
+            <p className="mt-1.5 text-xs leading-5 text-muted-foreground">
+              {action.message}
+            </p>
+          )}
+          {action.error && (
+            <p className="mt-1.5 text-xs leading-5 text-amber-700 dark:text-amber-300">
+              {action.error}
+            </p>
+          )}
+          {/* Provider warning codes stay in the structured trace for
+              diagnostics.  The old generic warning was misleading both when
+              useful evidence existed and when the result set was empty. */}
+        </div>
+      </div>
+    </div>
+  );
+}
+
+export function SmartKnowledgeRetrievalTrace({
+  messages,
+  progressFrames = [],
+  dedupeScopeMessages,
+  dedupeScopeProgressFrames,
+  isLoading,
+  onOpenResult,
+}: {
+  messages: Message[];
+  progressFrames?: KnowledgeRetrievalProgressFrame[];
+  /**
+   * The whole current user-turn group.  Interleaved rendering splits one
+   * retrieval invocation into one component, but result dedupe must still see
+   * every invocation in the turn.
+   */
+  dedupeScopeMessages?: Message[];
+  dedupeScopeProgressFrames?: KnowledgeRetrievalProgressFrame[];
+  isLoading: boolean;
+  /** @deprecated 仅为兼容历史分段调用，展示层不再暴露检索轮次。 */
+  roundOffset?: number;
+  onOpenResult?: (
+    item: SmartKnowledgeRetrievalResultItem,
+    target: WeKnoraSourceTarget,
+  ) => void;
+}) {
+  const rounds = useMemo(
+    () => {
+      const localRounds = buildSmartKnowledgeRetrievalRounds(
+        messages,
+        progressFrames,
+        isLoading,
+      );
+      if (!dedupeScopeMessages) return localRounds;
+
+      const globallyDedupedActions = new Map(
+        buildSmartKnowledgeRetrievalRounds(
+          dedupeScopeMessages,
+          dedupeScopeProgressFrames ?? [],
+          isLoading,
+        )
+          .flatMap((round) => round.actions)
+          .map((action) => [action.id, action] as const),
+      );
+      return localRounds.map((round) => ({
+        ...round,
+        actions: round.actions.map((action) => {
+          const globalAction = globallyDedupedActions.get(action.id);
+          return globalAction ? { ...globalAction, round: action.round } : action;
+        }),
+      }));
+    },
+    [
+      dedupeScopeMessages,
+      dedupeScopeProgressFrames,
+      isLoading,
+      messages,
+      progressFrames,
+    ],
+  );
+  const actions = rounds.flatMap((round) => round.actions);
+  // The chat can keep streaming its final answer after retrieval has already
+  // finished. Only an unfinished retrieval action owns the "检索中" state;
+  // the broader thread loading flag must not keep the spinner alive or block
+  // the collapse control during answer generation.
+  const isActive = actions.some((action) => action.status === "running");
+  const hasFailure = actions.some((action) => action.status === "failed");
+  const hasInterrupted = actions.some(
+    (action) => action.status === "interrupted",
+  );
+  const rawHits = actions
+    .filter((action) => action.surface === "raw" && action.kind === "search")
+    .reduce(
+      (total, action) =>
+        total + (action.allResultsAlreadyShown ? 0 : (action.resultCount ?? 0)),
+      0,
+    );
+  const wikiHits = actions
+    .filter((action) => action.surface === "wiki" && action.kind === "search")
+    .reduce(
+      (total, action) =>
+        total + (action.allResultsAlreadyShown ? 0 : (action.resultCount ?? 0)),
+      0,
+    );
+  const elapsedActions = actions.filter(
+    (action) => typeof action.elapsedMs === "number",
+  );
+  const cumulativeElapsedMs =
+    elapsedActions.length > 0
+      ? elapsedActions.reduce(
+          (total, action) => total + (action.elapsedMs ?? 0),
+          0,
+        )
+      : undefined;
+  // A live trace opens so newly completed result cards remain visible while
+  // the final answer starts streaming. Replayed history starts collapsed.
+  const [isExpanded, setIsExpanded] = useState(
+    isLoading && actions.length > 0,
+  );
+  const wasActive = useRef(isActive);
+  const wasLoading = useRef(isLoading);
+
+  useEffect(() => {
+    if (!wasActive.current && isActive) {
+      setIsExpanded(true);
+    }
+    if (wasLoading.current && !isLoading) {
+      setIsExpanded(false);
+    }
+    wasActive.current = isActive;
+    wasLoading.current = isLoading;
+  }, [isActive, isLoading]);
+
+  // An in-flight retrieval always stays visible. A just-completed live trace
+  // remains open and user-collapsible while the answer streams; replayed
+  // history starts collapsed and can be reopened for inspection.
+  const isOpen = isActive || isExpanded;
+
+  if (actions.length === 0) return null;
+
+  return (
+    <Collapsible
+      open={isOpen}
+      onOpenChange={(open) => {
+        if (!isActive) setIsExpanded(open);
+      }}
+    >
+      <section
+        aria-label="智能检索过程"
+        aria-live={isActive ? "polite" : undefined}
+        className="w-full rounded-xl border border-primary/20 bg-primary/[0.035] p-3.5 shadow-sm"
+        data-smart-knowledge-retrieval-trace
+      >
+        <div className="flex items-start gap-2.5">
+          <div className="mt-0.5 flex size-7 shrink-0 items-center justify-center rounded-lg bg-primary/10 text-primary">
+            {isActive ? (
+              <Loader2Icon className="size-4 animate-spin" />
+            ) : (
+              <SearchCheckIcon className="size-4" />
+            )}
+          </div>
+          <div className="min-w-0 flex-1">
+            <div className="flex flex-wrap items-center justify-between gap-2">
+              <h3 className="text-sm font-semibold text-foreground">智能检索过程</h3>
+              <div className="flex items-center gap-1.5">
+                <span
+                  className={cn(
+                    "rounded-full px-2 py-0.5 text-xs font-medium",
+                    isActive
+                      ? "bg-primary/10 text-primary"
+                      : hasFailure
+                        ? "bg-amber-500/10 text-amber-700 dark:text-amber-300"
+                        : hasInterrupted
+                          ? "bg-muted text-muted-foreground"
+                          : "bg-emerald-500/10 text-emerald-700 dark:text-emerald-300",
+                  )}
+                >
+                  {isActive
+                    ? "检索中"
+                    : hasFailure
+                      ? "已完成（部分步骤失败）"
+                      : hasInterrupted
+                        ? "检索已结束（部分步骤未完成）"
+                        : "检索完成"}
+                </span>
+                {!isActive && (
+                  <CollapsibleTrigger asChild>
+                    <button
+                      type="button"
+                      className="inline-flex h-7 items-center gap-1 rounded-md px-2 text-xs font-medium text-muted-foreground transition-colors hover:bg-primary/10 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary/40"
+                      aria-label={isOpen ? "收起智能检索过程" : "展开智能检索过程"}
+                    >
+                      <span>{isOpen ? "收起" : "展开"}</span>
+                      <ChevronDownIcon
+                        className={cn(
+                          "size-3.5 transition-transform duration-200",
+                          isOpen && "rotate-180",
+                        )}
+                      />
+                    </button>
+                  </CollapsibleTrigger>
+                )}
+              </div>
+            </div>
+            {!isActive && (
+              <p className="mt-1 text-xs text-muted-foreground">
+                调用知识库 {actions.length} 次 · 原始文档命中 {rawHits} 条 · Wiki 命中 {wikiHits} 条
+                {typeof cumulativeElapsedMs === "number"
+                  ? ` · 累计耗时 ${formatElapsedTime(cumulativeElapsedMs)}`
+                  : ""}
+              </p>
+            )}
+            {isActive && (
+              <p className="mt-0.5 text-xs leading-5 text-muted-foreground">
+                展示实际查询、检索范围与命中摘要，不包含模型内部思考。
+              </p>
+            )}
+          </div>
+        </div>
+
+        <CollapsibleContent className="data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:slide-out-to-top-1 data-[state=open]:animate-in data-[state=open]:fade-in-0 data-[state=open]:slide-in-from-top-1">
+          {!isActive && (
+            <p className="mt-1 text-xs text-muted-foreground">
+              展示实际查询、检索范围与命中摘要，不包含模型内部思考。
+            </p>
+          )}
+
+          <div className="mt-3 space-y-3">
+            {actions.map((action) => (
+              <RetrievalAction
+                key={action.id}
+                action={action}
+                onOpenResult={onOpenResult}
+              />
+            ))}
+          </div>
+        </CollapsibleContent>
+      </section>
+    </Collapsible>
+  );
+}

frontend-web/src/components/workspace/messages/speed-metrics.test.ts

@@ -0,0 +1,119 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+// Node's type-stripping test runner requires the explicit TypeScript suffix.
+// @ts-expect-error The application compiler intentionally uses extensionless imports.
+import {
+  GENERATION_IDLE_MS,
+  ROLLING_WINDOW_MS,
+  charsToTokensPerSec,
+  messageHasToolCalls,
+  rollingTokensPerSec,
+  shouldFreezeGeneration,
+  usageTokensPerSec,
+} from "./speed-metrics.ts";
+
+test("rolling window reports the recent rate while characters grow", () => {
+  const samples = [
+    { at: 0, chars: 0 },
+    { at: 500, chars: 100 },
+    { at: 1000, chars: 200 },
+  ];
+  const rate = rollingTokensPerSec(samples, 200, 1000, 1000);
+  // 200 chars / 1000ms / 2 chars-per-token = 100 tok/s
+  assert.equal(rate, 100);
+});
+
+test("rolling window drops to 0 when every sample is older than the window", () => {
+  const samples = [
+    { at: 0, chars: 0 },
+    { at: 200, chars: 80 },
+    { at: 400, chars: 160 },
+  ];
+  const now = 400 + ROLLING_WINDOW_MS + 50;
+  assert.equal(rollingTokensPerSec(samples, 160, now), 0);
+});
+
+test("rolling window decays toward 0 after a mid-stream pause", () => {
+  const samples = [
+    { at: 0, chars: 0 },
+    { at: 400, chars: 80 },
+  ];
+  const live = rollingTokensPerSec(samples, 80, 500, 1000);
+  const paused = rollingTokensPerSec(samples, 80, 900, 1000);
+  assert.ok(live > paused);
+  assert.ok(paused > 0);
+  assert.equal(rollingTokensPerSec(samples, 80, 400 + 1000 + 1, 1000), 0);
+});
+
+test("usageTokensPerSec is output tokens over the segment duration", () => {
+  assert.equal(usageTokensPerSec(278, 6200), (278 / 6200) * 1000);
+  assert.equal(usageTokensPerSec(0, 1000), 0);
+  assert.equal(usageTokensPerSec(10, 0), 0);
+});
+
+test("charsToTokensPerSec uses the 2-chars-per-token heuristic", () => {
+  assert.equal(charsToTokensPerSec(100, 1000), 50);
+});
+
+test("shouldFreezeGeneration ends the segment on the next call, tools, idle usage, or run stop", () => {
+  const base = {
+    endedAt: null,
+    isLoading: true,
+    isLatestGenerating: true,
+    hasToolCalls: false,
+    grewThisTick: false,
+    lastGrewAt: 1000,
+    now: 1100,
+    outputTokens: 0,
+  };
+
+  assert.equal(shouldFreezeGeneration(base), false);
+  assert.equal(
+    shouldFreezeGeneration({ ...base, isLatestGenerating: false }),
+    true,
+  );
+  assert.equal(shouldFreezeGeneration({ ...base, hasToolCalls: true }), true);
+  assert.equal(
+    shouldFreezeGeneration({
+      ...base,
+      hasToolCalls: true,
+      grewThisTick: true,
+    }),
+    false,
+  );
+  assert.equal(
+    shouldFreezeGeneration({
+      ...base,
+      outputTokens: 40,
+      now: 1000 + GENERATION_IDLE_MS,
+    }),
+    true,
+  );
+  assert.equal(
+    shouldFreezeGeneration({
+      ...base,
+      outputTokens: 40,
+      now: 1000 + GENERATION_IDLE_MS - 1,
+    }),
+    false,
+  );
+  assert.equal(shouldFreezeGeneration({ ...base, isLoading: false }), true);
+  assert.equal(shouldFreezeGeneration({ ...base, endedAt: 1000 }), false);
+});
+
+test("messageHasToolCalls reads both top-level and additional_kwargs", () => {
+  assert.equal(messageHasToolCalls({}), false);
+  assert.equal(
+    messageHasToolCalls({
+      tool_calls: [{ id: "1", name: "search" }],
+    }),
+    true,
+  );
+  assert.equal(
+    messageHasToolCalls({
+      additional_kwargs: { tool_calls: [{ id: "1" }] },
+    }),
+    true,
+  );
+});

frontend-web/src/components/workspace/messages/speed-metrics.ts

@@ -0,0 +1,108 @@
+/**
+ * Shared tok/s helpers for the chat / roundtable speed pills.
+ *
+ * Live rate uses a rolling window with a virtual tail at "now" so a pause
+ * (no new characters) decays toward 0 instead of freezing on the last two
+ * samples. Final rate prefers provider `output_tokens` over the segment
+ * duration, and only after that model-call segment has ended.
+ */
+
+export const CHARS_PER_TOKEN = 2;
+export const SAMPLE_THROTTLE_MS = 60;
+export const ROLLING_WINDOW_MS = 1000;
+export const MAX_SPEED_SAMPLES = 256;
+/** Idle after last visible growth before we treat this model call as finished. */
+export const GENERATION_IDLE_MS = 400;
+
+export type SpeedSample = { at: number; chars: number };
+
+export function estimateTokensFromChars(chars: number): number {
+  return Math.max(0, chars) / CHARS_PER_TOKEN;
+}
+
+export function charsToTokensPerSec(chars: number, elapsedMs: number): number {
+  if (elapsedMs <= 0) return 0;
+  return (estimateTokensFromChars(chars) / elapsedMs) * 1000;
+}
+
+export function usageTokensPerSec(
+  outputTokens: number,
+  durationMs: number,
+): number {
+  if (outputTokens <= 0 || durationMs <= 0) return 0;
+  return (outputTokens / durationMs) * 1000;
+}
+
+/**
+ * Instantaneous tok/s over the last `windowMs`.
+ *
+ * The tail is always `(now, lastChars)`. If every sample is older than the
+ * window, the result is 0 — a generation pause must not keep the last
+ * observed rate pinned on screen.
+ */
+export function rollingTokensPerSec(
+  samples: SpeedSample[],
+  lastChars: number,
+  now: number,
+  windowMs: number = ROLLING_WINDOW_MS,
+): number {
+  if (samples.length === 0 || windowMs <= 0) return 0;
+
+  const windowStart = now - windowMs;
+  let headIdx = samples.findIndex((sample) => sample.at >= windowStart);
+  if (headIdx === -1) {
+    return 0;
+  }
+  if (headIdx > 0) {
+    headIdx -= 1;
+  }
+
+  const head = samples[headIdx];
+  if (!head) return 0;
+  const elapsedMs = now - head.at;
+  if (elapsedMs <= 0) return 0;
+  return charsToTokensPerSec(Math.max(0, lastChars - head.chars), elapsedMs);
+}
+
+export function pushSpeedSample(
+  samples: SpeedSample[],
+  at: number,
+  chars: number,
+): void {
+  samples.push({ at, chars });
+  if (samples.length > MAX_SPEED_SAMPLES) {
+    samples.splice(0, samples.length - MAX_SPEED_SAMPLES);
+  }
+}
+
+export function shouldFreezeGeneration(args: {
+  endedAt: number | null;
+  isLoading: boolean;
+  isLatestGenerating: boolean;
+  hasToolCalls: boolean;
+  grewThisTick: boolean;
+  lastGrewAt: number;
+  now: number;
+  outputTokens: number;
+}): boolean {
+  if (args.endedAt != null) return false;
+  if (!args.isLatestGenerating) return true;
+  if (args.hasToolCalls && !args.grewThisTick) return true;
+  if (
+    args.outputTokens > 0 &&
+    args.now - args.lastGrewAt >= GENERATION_IDLE_MS
+  ) {
+    return true;
+  }
+  return !args.isLoading;
+}
+
+export function messageHasToolCalls(message: {
+  tool_calls?: unknown[] | null;
+  additional_kwargs?: { tool_calls?: unknown[] } | null;
+}): boolean {
+  const direct = message.tool_calls;
+  if (Array.isArray(direct) && direct.length > 0) return true;
+  const extra = message.additional_kwargs?.tool_calls;
+  return Array.isArray(extra) && extra.length > 0;
+}

frontend-web/src/components/workspace/messages/subtask-card.tsx

@@ -6,8 +6,6 @@ import {
   XCircleIcon,
 } from "lucide-react";
 import { useMemo, useState } from "react";
-import { Streamdown } from "streamdown";
-
 import {
   ChainOfThought,
   ChainOfThoughtContent,
@@ -19,7 +17,10 @@ import { ShineBorder } from "@/components/ui/shine-border";
 import { useI18n } from "@/core/i18n/hooks";
 import { hasToolCalls } from "@/core/messages/utils";
 import { useRehypeSplitWordsIntoSpans } from "@/core/rehype";
-import { streamdownPluginsWithWordAnimation } from "@/core/streamdown";
+import {
+  SafeStreamdown,
+  streamdownPluginsWithWordAnimation,
+} from "@/core/streamdown";
 import { useSubtask } from "@/core/tasks/context";
 import { explainLastToolCall } from "@/core/tools/utils";
 import { cn } from "@/lib/utils";
@@ -126,12 +127,12 @@ export function SubtaskCard({
           {task.prompt && (
             <ChainOfThoughtStep
               label={
-                <Streamdown
+                <SafeStreamdown
                   {...streamdownPluginsWithWordAnimation}
                   components={{ a: CitationLink }}
                 >
                   {task.prompt}
-                </Streamdown>
+                </SafeStreamdown>
               }
             ></ChainOfThoughtStep>
           )}

frontend-web/src/components/workspace/messages/uploaded-file-preview-dialog.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { DownloadIcon, Loader2 } from "lucide-react";
+import { DownloadIcon, InfoIcon, Loader2 } from "lucide-react";
 import { useEffect, useMemo, useState } from "react";
 
 import { Button } from "@/components/ui/button";
@@ -13,8 +13,10 @@ import {
 } from "@/components/ui/dialog";
 import { MarkdownContent } from "@/components/workspace/messages/markdown-content";
 import { apiFetch } from "@/core/api/fetch-client";
+import { getBackendBaseURL } from "@/core/config";
 import { useI18n } from "@/core/i18n/hooks";
 import { reasoningPlugins } from "@/core/streamdown";
+import { DEFAULT_UPLOAD_POLICY, useUploadPolicy } from "@/core/uploads";
 
 const markdownClassName =
   "!h-auto !w-full max-w-none min-w-0 text-sm leading-7 " +
@@ -56,20 +58,111 @@ function kindOf(filename: string): PreviewKind {
   return "binary";
 }
 
-function withReplacedExtension(url: string): string {
+function withAppendedMarkdownExtension(url: string): string {
-  // Replace the path extension with .md, keeping any query string intact.
+  const [base, query] = url.split("?");
+  const appended = `${base}.md`;
+  return query ? `${appended}?${query}` : appended;
+}
+
+function withLegacyReplacedExtension(url: string): string {
+  // Compatibility with uploads converted before sidecars switched from
+  // `report.md` to the collision-safe `report.docx.md` naming scheme.
   const [base, query] = url.split("?");
   const i = base.lastIndexOf(".");
   const swapped = (i >= 0 ? base.slice(0, i) : base) + ".md";
   return query ? `${swapped}?${query}` : swapped;
 }
 
+type ArtifactPreviewResponse = {
+  path: string;
+  name: string;
+  total_bytes: number;
+  content: string;
+  truncated: boolean;
+  strategy: string;
+  stats?: Record<string, unknown> | null;
+  warnings?: string[];
+};
+
+type PreviewMeta = Pick<
+  ArtifactPreviewResponse,
+  "total_bytes" | "truncated" | "strategy" | "warnings"
+>;
+
+function parseTotalBytes(response: Response): number | undefined {
+  const contentRange = response.headers.get("Content-Range");
+  const rangeTotal = contentRange?.match(/\/(\d+)$/)?.[1];
+  if (rangeTotal) return Number(rangeTotal);
+  const contentLengthHeader = response.headers.get("Content-Length");
+  if (!contentLengthHeader) return undefined;
+  const contentLength = Number(contentLengthHeader);
+  return Number.isFinite(contentLength) ? contentLength : undefined;
+}
+
+/** Read a streamed response up to maxBytes and cancel the rest. */
+async function readBoundedTextResponse(
+  response: Response,
+  maxBytes: number,
+): Promise<{ content: string; totalBytes: number; truncated: boolean }> {
+  if (!response.body) throw new Error("浏览器不支持流式预览");
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder();
+  const declaredTotal = parseTotalBytes(response);
+  let received = 0;
+  let content = "";
+  let completed = false;
+
+  while (received < maxBytes) {
+    const { done, value } = await reader.read();
+    if (done) {
+      completed = true;
+      break;
+    }
+    if (!value) continue;
+    const remaining = maxBytes - received;
+    const slice = value.byteLength > remaining ? value.subarray(0, remaining) : value;
+    received += slice.byteLength;
+    content += decoder.decode(slice, { stream: received < maxBytes });
+    if (value.byteLength > remaining || received >= maxBytes) {
+      await reader.cancel();
+      break;
+    }
+  }
+  content += decoder.decode();
+  const totalBytes = declaredTotal ?? received;
+  return {
+    content,
+    totalBytes,
+    truncated: !completed || totalBytes > received,
+  };
+}
+
+function strategyLabel(strategy: string): string {
+  if (strategy.includes("sampling") || strategy.includes("sample")) {
+    return "流式统计 + 开头/中段/结尾分块采样";
+  }
+  if (strategy === "complete-text") return "完整文本";
+  if (strategy === "bounded-prefix") return "有界前缀";
+  if (strategy === "client-bounded-prefix") return "兼容模式有界前缀";
+  return strategy;
+}
+
+function formatBytes(bytes: number): string {
+  if (bytes >= 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(2)} MiB`;
+  if (bytes >= 1024) return `${(bytes / 1024).toFixed(2)} KiB`;
+  return `${bytes} B`;
+}
+
 /**
  * Fetch an auth-gated artifact (the artifact route requires an
  * `Authorization: Bearer` header, which a plain <img>/<iframe> cannot send —
  * hence the 401s) and expose it as an object URL for inline display.
  */
-export function useAuthedObjectUrl(url: string | null, enabled: boolean) {
+export function useAuthedObjectUrl(
+  url: string | null,
+  enabled: boolean,
+  requestFile: typeof apiFetch = apiFetch,
+) {
   const [objectUrl, setObjectUrl] = useState<string | null>(null);
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState<string | null>(null);
@@ -81,9 +174,10 @@ export function useAuthedObjectUrl(url: string | null, enabled: boolean) {
     }
     let cancelled = false;
     let created: string | null = null;
+    const controller = new AbortController();
     setLoading(true);
     setError(null);
-    apiFetch(url)
+    requestFile(url, { signal: controller.signal })
       .then(async (res) => {
         if (!res.ok) throw new Error(`HTTP ${res.status}`);
         return res.blob();
@@ -102,9 +196,10 @@ export function useAuthedObjectUrl(url: string | null, enabled: boolean) {
       });
     return () => {
       cancelled = true;
+      controller.abort();
       if (created) URL.revokeObjectURL(created);
     };
-  }, [url, enabled]);
+  }, [url, enabled, requestFile]);
 
   return { objectUrl, loading, error };
 }
@@ -122,47 +217,152 @@ export function useAuthedObjectUrl(url: string | null, enabled: boolean) {
 export function UploadedFilePreviewDialog({
   filename,
   fileUrl,
+  threadId,
+  virtualPath,
+  requestFile = apiFetch,
+  onDownload,
+  downloading = false,
   open,
   onOpenChange,
 }: {
   filename: string;
   /** Absolute artifact URL for the original uploaded file. */
   fileUrl: string;
+  /** Used by the bounded preview endpoint; optional for old/public messages. */
+  threadId?: string;
+  virtualPath?: string;
+  /** External skill links supply an unauthenticated fetch, avoiding token leakage. */
+  requestFile?: typeof apiFetch;
+  /** Authenticated original-file download used by retrieved-file cards. */
+  onDownload?: () => void | Promise<void>;
+  downloading?: boolean;
   open: boolean;
   onOpenChange: (open: boolean) => void;
 }) {
   const { t } = useI18n();
+  const { data: uploadPolicy } = useUploadPolicy();
+  const effectivePolicy = uploadPolicy ?? DEFAULT_UPLOAD_POLICY;
+  const maxPreviewChars = Math.max(
+    256,
+    Math.min(
+      32_000,
+      effectivePolicy.large_file.max_result_chars,
+      effectivePolicy.large_file.hard_max_result_chars,
+    ),
+  );
   const kind = useMemo(() => kindOf(filename), [filename]);
   const ext = useMemo(() => extOf(filename), [filename]);
 
   // image / pdf → fetch as authed blob and display via object URL.
   const blobEnabled = open && (kind === "image" || kind === "pdf");
   const { objectUrl, loading: blobLoading, error: blobError } =
-    useAuthedObjectUrl(fileUrl, blobEnabled);
+    useAuthedObjectUrl(fileUrl, blobEnabled, requestFile);
 
   // text / office → fetch text (office reads the converted sibling .md).
-  const textUrl = useMemo(
+  const textUrls = useMemo(
-    () => (kind === "office" ? withReplacedExtension(fileUrl) : fileUrl),
+    () =>
+      kind === "office"
+        ? Array.from(
+            new Set([
+              withAppendedMarkdownExtension(fileUrl),
+              withLegacyReplacedExtension(fileUrl),
+            ]),
+          )
+        : [fileUrl],
     [kind, fileUrl],
   );
+  const previewPaths = useMemo(
+    () =>
+      virtualPath
+        ? kind === "office"
+          ? Array.from(
+              new Set([
+                withAppendedMarkdownExtension(virtualPath),
+                withLegacyReplacedExtension(virtualPath),
+              ]),
+            )
+          : [virtualPath]
+        : [],
+    [kind, virtualPath],
+  );
   const [text, setText] = useState<string | null>(null);
+  const [previewMeta, setPreviewMeta] = useState<PreviewMeta | null>(null);
   const [textLoading, setTextLoading] = useState(false);
   const [textError, setTextError] = useState<string | null>(null);
 
   useEffect(() => {
     if (!open || (kind !== "text" && kind !== "office")) return;
     let cancelled = false;
+    const controller = new AbortController();
     setTextLoading(true);
     setTextError(null);
     setText(null);
-    apiFetch(textUrl)
+    setPreviewMeta(null);
-      .then(async (res) => {
+
-        if (!res.ok) throw new Error(`HTTP ${res.status}`);
+    const load = async () => {
-        return res.text();
+      if (threadId && previewPaths.length > 0) {
-      })
+        for (const previewPath of previewPaths) {
-      .then((body) => {
+          try {
-        if (!cancelled) setText(body);
+            const endpoint = `${getBackendBaseURL()}/api/threads/${encodeURIComponent(
-      })
+              threadId,
+            )}/artifact-preview?path=${encodeURIComponent(
+              previewPath,
+            )}&max_chars=${maxPreviewChars}`;
+            const response = await apiFetch(endpoint, { signal: controller.signal });
+            if (!response.ok) throw new Error(`HTTP ${response.status}`);
+            const body = (await response.json()) as ArtifactPreviewResponse;
+            const rawContent = String(body.content ?? "");
+            const content = rawContent.slice(0, maxPreviewChars);
+            if (!cancelled) {
+              setText(content);
+              setPreviewMeta({
+                total_bytes: Number(body.total_bytes) || 0,
+                truncated:
+                  Boolean(body.truncated) || rawContent.length > content.length,
+                strategy: String(body.strategy || "bounded-prefix"),
+                warnings: Array.isArray(body.warnings) ? body.warnings : [],
+              });
+            }
+            return;
+          } catch {
+            // Try a legacy Office sidecar, then fall through to the bounded
+            // Range fallback during a rolling upgrade or public share.
+          }
+        }
+      }
+
+      const maxBytes = Math.max(4_096, maxPreviewChars * 4);
+      let lastError: Error | null = null;
+      for (const textUrl of textUrls) {
+        try {
+          const response = await requestFile(textUrl, {
+            signal: controller.signal,
+            headers: { Range: `bytes=0-${maxBytes - 1}` },
+          });
+          if (!response.ok) throw new Error(`HTTP ${response.status}`);
+          const bounded = await readBoundedTextResponse(response, maxBytes);
+          if (!cancelled) {
+            const content = bounded.content.slice(0, maxPreviewChars);
+            setText(content);
+            setPreviewMeta({
+              total_bytes: bounded.totalBytes,
+              truncated:
+                bounded.truncated || bounded.content.length > content.length,
+              strategy: "client-bounded-prefix",
+              warnings: [
+                "采样预览接口暂不可用，当前仅显示受限的文件开头，未读取剩余内容。",
+              ],
+            });
+          }
+          return;
+        } catch (error) {
+          lastError = error instanceof Error ? error : new Error(String(error));
+        }
+      }
+      throw lastError ?? new Error("无法读取文件预览");
+    };
+
+    void load()
       .catch((err: unknown) => {
         if (!cancelled)
           setTextError(err instanceof Error ? err.message : String(err));
@@ -172,8 +372,9 @@ export function UploadedFilePreviewDialog({
       });
     return () => {
       cancelled = true;
+      controller.abort();
     };
-  }, [open, kind, textUrl]);
+  }, [open, kind, maxPreviewChars, previewPaths, textUrls, threadId, requestFile]);
 
   const renderAsMarkdown =
     kind === "office" || ext === "md" || ext === "markdown";
@@ -192,21 +393,36 @@ export function UploadedFilePreviewDialog({
         style={{
           width: "min(56rem, calc(100vw - 2rem))",
           maxWidth: "none",
-          height: "min(720px, calc(100dvh - 2rem))",
+          minHeight: "min(420px, calc(100vh - 2rem))",
+          height: "min(720px, calc(100vh - 2rem))",
+          maxHeight: "min(720px, calc(100vh - 2rem))",
         }}
       >
         <DialogHeader className="shrink-0 border-b px-5 py-3 pr-12">
           <DialogTitle className="truncate text-sm">{filename}</DialogTitle>
           <DialogDescription className="mt-0.5 truncate text-xs">
-            <a
+            {onDownload ? (
-              href={fileUrl}
+              <Button
-              target="_blank"
+                type="button"
-              rel="noopener noreferrer"
+                size="sm"
-              className="hover:text-foreground inline-flex items-center gap-1 underline-offset-2 hover:underline"
+                variant="ghost"
-            >
+                disabled={downloading}
-              <DownloadIcon className="size-3" />
+                onClick={() => void onDownload()}
-              {t.common.download}
+              >
-            </a>
+                <DownloadIcon className="size-3" />
+                {t.common.download}
+              </Button>
+            ) : (
+              <a
+                href={fileUrl}
+                target="_blank"
+                rel="noopener noreferrer"
+                className="hover:text-foreground inline-flex items-center gap-1 underline-offset-2 hover:underline"
+              >
+                <DownloadIcon className="size-3" />
+                {t.common.download}
+              </a>
+            )}
           </DialogDescription>
         </DialogHeader>
 
@@ -215,7 +431,7 @@ export function UploadedFilePreviewDialog({
             blobLoading ? (
               loadingView
             ) : blobError || !objectUrl ? (
-              <BinaryFallback fileUrl={fileUrl} label={t.common.download} />
+              <BinaryFallback fileUrl={fileUrl} label={t.common.download} onDownload={onDownload} downloading={downloading} />
             ) : (
               <div className="flex items-center justify-center">
                 <img
@@ -229,7 +445,7 @@ export function UploadedFilePreviewDialog({
             blobLoading ? (
               loadingView
             ) : blobError || !objectUrl ? (
-              <BinaryFallback fileUrl={fileUrl} label={t.common.download} />
+              <BinaryFallback fileUrl={fileUrl} label={t.common.download} onDownload={onDownload} downloading={downloading} />
             ) : (
               <iframe
                 src={objectUrl}
@@ -241,22 +457,45 @@ export function UploadedFilePreviewDialog({
             textLoading ? (
               loadingView
             ) : textError ? (
-              <BinaryFallback fileUrl={fileUrl} label={t.common.download} />
+              <BinaryFallback fileUrl={fileUrl} label={t.common.download} onDownload={onDownload} downloading={downloading} />
-            ) : renderAsMarkdown ? (
-              <MarkdownContent
-                className={markdownClassName}
-                content={text ?? ""}
-                isLoading={false}
-                remarkPlugins={reasoningPlugins.remarkPlugins}
-                rehypePlugins={reasoningPlugins.rehypePlugins}
-              />
             ) : (
-              <pre className="text-foreground/80 bg-muted/40 max-w-full overflow-x-auto rounded-lg border p-4 font-mono text-xs leading-relaxed whitespace-pre-wrap">
+              <div className="space-y-3">
-                {text ?? ""}
+                {previewMeta &&
-              </pre>
+                  (previewMeta.truncated ||
+                    previewMeta.strategy !== "complete-text" ||
+                    (previewMeta.warnings?.length ?? 0) > 0) && (
+                    <div className="border-amber-300/70 bg-amber-50/70 text-amber-950 dark:border-amber-800 dark:bg-amber-950/30 dark:text-amber-100 rounded-lg border px-3 py-2 text-xs">
+                      <div className="flex items-start gap-2 font-medium">
+                        <InfoIcon className="mt-0.5 size-3.5 shrink-0" />
+                        <span>
+                          {previewMeta.truncated ? "当前为截断/采样预览" : "预览读取方式"}
+                          ：{strategyLabel(previewMeta.strategy)}；文件大小 {formatBytes(previewMeta.total_bytes)}，本次最多展示 {maxPreviewChars.toLocaleString()} 个字符。
+                        </span>
+                      </div>
+                      {previewMeta.warnings?.map((warning) => (
+                        <p key={warning} className="mt-1 pl-5 opacity-80">
+                          {warning}
+                        </p>
+                      ))}
+                    </div>
+                  )}
+                {renderAsMarkdown ? (
+                  <MarkdownContent
+                    className={markdownClassName}
+                    content={text ?? ""}
+                    isLoading={false}
+                    remarkPlugins={reasoningPlugins.remarkPlugins}
+                    rehypePlugins={reasoningPlugins.rehypePlugins}
+                  />
+                ) : (
+                  <pre className="text-foreground/80 bg-muted/40 max-w-full overflow-x-auto rounded-lg border p-4 font-mono text-xs leading-relaxed whitespace-pre-wrap">
+                    {text ?? ""}
+                  </pre>
+                )}
+              </div>
             )
           ) : (
-            <BinaryFallback fileUrl={fileUrl} label={t.common.download} />
+            <BinaryFallback fileUrl={fileUrl} label={t.common.download} onDownload={onDownload} downloading={downloading} />
           )}
         </div>
       </DialogContent>
@@ -264,15 +503,34 @@ export function UploadedFilePreviewDialog({
   );
 }
 
-function BinaryFallback({ fileUrl, label }: { fileUrl: string; label: string }) {
+function BinaryFallback({ fileUrl, label, onDownload, downloading }: {
+  fileUrl: string;
+  label: string;
+  onDownload?: () => void | Promise<void>;
+  downloading?: boolean;
+}) {
   return (
     <div className="text-muted-foreground flex flex-col items-center gap-3 rounded-lg border border-dashed px-4 py-12 text-center text-sm">
-      <Button asChild size="sm" variant="outline">
+      <p>暂不支持在线预览，请下载原文件查看。</p>
-        <a href={fileUrl} target="_blank" rel="noopener noreferrer" download>
+      {onDownload ? (
+        <Button
+          type="button"
+          size="sm"
+          variant="outline"
+          disabled={downloading}
+          onClick={() => void onDownload()}
+        >
           <DownloadIcon className="size-3.5" />
           {label}
-        </a>
+        </Button>
-      </Button>
+      ) : (
+        <Button asChild size="sm" variant="outline">
+          <a href={fileUrl} target="_blank" rel="noopener noreferrer" download>
+            <DownloadIcon className="size-3.5" />
+            {label}
+          </a>
+        </Button>
+      )}
     </div>
   );
 }

frontend-web/src/components/workspace/messages/use-message-metrics.ts

@@ -7,29 +7,37 @@ import { extractReasoningContentFromMessage } from "@/core/messages/utils";
 import { getUsageMetadata } from "@/core/messages/usage";
 import { textOfMessage } from "@/core/threads/utils";
 
-/**
+import {
- * Two characters ≈ one token. Same heuristic we use elsewhere; gives a stable
+  GENERATION_IDLE_MS,
- * speed indicator for mixed Chinese/English replies without dragging in a
+  SAMPLE_THROTTLE_MS,
- * real tokeniser.
+  charsToTokensPerSec,
- */
+  messageHasToolCalls,
-const CHARS_PER_TOKEN = 2;
+  pushSpeedSample,
-
+  rollingTokensPerSec,
-/** Sample throttle while a message is streaming. */
+  shouldFreezeGeneration,
-const SAMPLE_THROTTLE_MS = 60;
+  usageTokensPerSec,
+  type SpeedSample,
+} from "./speed-metrics";
 
 /**
- * Per-AI-message metric: real-time during streaming, frozen once the run ends.
+ * Per-AI-message metric: live rolling rate during that model-call segment,
+ * frozen once the segment ends (not when the whole agent turn ends).
  */
 export interface MessageMetric {
   /** Rolling tokens/sec, or 0 when we cannot estimate yet. */
   tokensPerSec: number;
   /**
-   * Wall-clock duration from when the message first appeared with text to
+   * Wall-clock duration of this model-call segment: first visible character
-   * either *now* (active) or to when the stream ended (frozen).
+   * → last visible character (tool-wait after the call is excluded).
    */
   durationMs: number;
-  /** True while this is the currently streaming message. */
+  /** True while this message is still generating visible tokens. */
   isActive: boolean;
+  /**
+   * True while this message is the live generator but the rolling window
+   * has seen no new characters — the pill should not keep a stale tok/s.
+   */
+  isPaused: boolean;
   /**
    * Whether the speed value was computed from real usage_metadata output
    * tokens (``true``) vs. a char-count fallback (``false``). UI uses this
@@ -45,15 +53,12 @@ export interface MessageMetric {
   isTurnFinal: boolean;
 }
 
-type Sample = { at: number; chars: number };
-
 type TimingEntry = {
   firstSeenAt: number;
   endedAt: number | null;
-  samples: Sample[];
+  lastGrewAt: number;
+  samples: SpeedSample[];
   lastChars: number;
-  /** True iff we *have already* observed `usage_metadata.output_tokens`. */
-  hadUsage: boolean;
 };
 
 function isAiMessage(message: Message): boolean {
@@ -82,11 +87,12 @@ function messageText(message: Message): string {
  *
  * Recording strategy:
  *   - Whenever a message renders with text, we anchor `firstSeenAt`.
- *   - On every text-length change we push a sample and recompute the rate.
+ *   - On every text-length change we push a sample.
- *   - When `isLoading` flips to false we mark *all* still-active messages as
+ *   - The segment freezes when this model call ends (next AI message, tool
- *     ended so subsequent renders return a frozen duration.
+ *     calls, usage + idle, or the run stops) so tool-wait is not in the
- *   - Token totals come from usage_metadata when present (most accurate);
+ *     denominator.
- *     otherwise we fall back to char-count / 2.
+ *   - Live rate is a rolling window that decays to 0 on pause.
+ *   - `usage_metadata.output_tokens` only corrects the frozen final value.
  */
 export function useMessageMetrics(
   messages: Message[],
@@ -104,7 +110,8 @@ export function useMessageMetrics(
   // synchronously inside an effect so React isn't tracking the map identity.
   useEffect(() => {
     const now = performance.now();
-    let activeId: string | null = null;
+    const grewIds = new Set<string>();
+    let latestId: string | null = null;
 
     for (let i = 0; i < messages.length; i++) {
       const message = messages[i];
@@ -118,50 +125,62 @@ export function useMessageMetrics(
         entry = {
           firstSeenAt: now,
           endedAt: null,
+          lastGrewAt: now,
           samples: [{ at: now, chars: text.length }],
           lastChars: text.length,
-          hadUsage: false,
         };
         timingRef.current.set(id, entry);
       }
 
-      // Track the most recent AI message as the active one (while streaming).
+      latestId = id;
-      activeId = id;
 
-      // Sample only when actively streaming OR when content actually grew —
-      // throttle to keep arrays bounded.
       const grew = text.length !== entry.lastChars;
-      if (grew && now - lastSampleAtRef.current >= SAMPLE_THROTTLE_MS) {
+      if (grew) {
-        entry.samples.push({ at: now, chars: text.length });
+        grewIds.add(id);
-        entry.lastChars = text.length;
+        entry.lastGrewAt = now;
-        if (entry.samples.length > 256) {
+        if (now - lastSampleAtRef.current >= SAMPLE_THROTTLE_MS) {
-          entry.samples.splice(0, entry.samples.length - 256);
+          pushSpeedSample(entry.samples, now, text.length);
+          lastSampleAtRef.current = now;
         }
-        lastSampleAtRef.current = now;
-      } else if (grew) {
-        // Still update lastChars so the next render captures it eventually.
         entry.lastChars = text.length;
       }
-
-      if (getUsageMetadata(message)) {
-        entry.hadUsage = true;
-      }
     }
 
-    // When streaming stops, freeze any non-ended entry to the current time.
+    for (let i = 0; i < messages.length; i++) {
-    if (!isLoading) {
+      const message = messages[i];
-      for (const entry of timingRef.current.values()) {
+      if (!message || !isAiMessage(message)) continue;
-        if (entry.endedAt === null) {
+      const id = getMessageId(message, i);
-          entry.endedAt = now;
+      const entry = timingRef.current.get(id);
-        }
+      if (!entry) continue;
+
+      const grewThisTick = grewIds.has(id);
+      if (grewThisTick && entry.endedAt != null && isLoading) {
+        entry.endedAt = null;
+        continue;
+      }
+
+      const usage = getUsageMetadata(message);
+      if (
+        shouldFreezeGeneration({
+          endedAt: entry.endedAt,
+          isLoading,
+          isLatestGenerating: id === latestId,
+          hasToolCalls: messageHasToolCalls(message),
+          grewThisTick,
+          lastGrewAt: entry.lastGrewAt,
+          now,
+          outputTokens: usage?.outputTokens ?? 0,
+        })
+      ) {
+        entry.endedAt = entry.lastGrewAt;
       }
     }
 
-    lastActiveIdRef.current = activeId;
+    lastActiveIdRef.current = latestId;
     setTick((v) => v + 1);
   }, [messages, isLoading]);
 
-  // Drive a slow tick while streaming so live durations refresh smoothly.
+  // Drive a slow tick while streaming so live durations / pause decay refresh.
   useEffect(() => {
     if (!isLoading) return;
     const interval = window.setInterval(() => setTick((v) => v + 1), 300);
@@ -198,45 +217,36 @@ export function useMessageMetrics(
     const entry = timingRef.current.get(id);
     if (!entry) continue;
 
+    const isActive =
+      isLoading && id === lastActiveIdRef.current && entry.endedAt === null;
     const endedAt = entry.endedAt ?? now;
     const durationMs = Math.max(0, endedAt - entry.firstSeenAt);
-    const isActive = isLoading && id === lastActiveIdRef.current;
 
     let tokensPerSec = 0;
     let fromUsage = false;
+    let isPaused = false;
     const usage = getUsageMetadata(message);
-    if (usage && usage.outputTokens > 0 && durationMs > 0) {
+
-      tokensPerSec = (usage.outputTokens / durationMs) * 1000;
+    if (entry.endedAt != null) {
-      fromUsage = true;
+      if (usage && usage.outputTokens > 0 && durationMs > 0) {
-    } else {
+        tokensPerSec = usageTokensPerSec(usage.outputTokens, durationMs);
-      // Char-count fallback. Uses the rolling window during streaming so a
+        fromUsage = true;
-      // mid-stream snapshot reflects current speed rather than average since
-      // the start.
-      if (isActive && entry.samples.length >= 2) {
-        const samples = entry.samples;
-        let start = samples.findIndex((s) => s.at >= now - 1500);
-        if (start === -1) start = samples.length - 2;
-        if (start < 0) start = 0;
-        const head = samples[start];
-        const tail = samples[samples.length - 1];
-        if (head && tail) {
-          const elapsedMs = tail.at - head.at;
-          const chars = Math.max(0, tail.chars - head.chars);
-          if (elapsedMs > 0) {
-            tokensPerSec = (chars / elapsedMs) * 1000 / CHARS_PER_TOKEN;
-          }
-        }
       } else if (durationMs > 0) {
-        // Finished message without usage data: average over full duration.
+        tokensPerSec = charsToTokensPerSec(entry.lastChars, durationMs);
-        const chars = entry.lastChars;
-        tokensPerSec = (chars / durationMs) * 1000 / CHARS_PER_TOKEN;
       }
+    } else {
+      tokensPerSec = rollingTokensPerSec(entry.samples, entry.lastChars, now);
+      isPaused =
+        isActive &&
+        tokensPerSec <= 0 &&
+        now - entry.lastGrewAt >= GENERATION_IDLE_MS;
     }
 
     out.set(id, {
       tokensPerSec,
       durationMs,
       isActive,
+      isPaused,
       fromUsage,
       isTurnFinal: turnFinalIds.has(id),
     });

frontend-web/src/components/workspace/model-name-select.tsx

@@ -25,6 +25,7 @@ export function ModelNameSelect({
   className,
   triggerClassName,
   defaultLabel = "默认模型",
+  title = "选择用于本次操作的大模型(默认使用系统配置的模型)",
 }: {
   value: string | null;
   onChange: (modelName: string | null) => void;
@@ -32,6 +33,7 @@ export function ModelNameSelect({
   className?: string;
   triggerClassName?: string;
   defaultLabel?: string;
+  title?: string;
 }) {
   const { models } = useModels();
   return (
@@ -42,7 +44,7 @@ export function ModelNameSelect({
     >
       <SelectTrigger
         className={cn("h-8 gap-1.5 text-xs", triggerClassName, className)}
-        title="选择用于本次操作的大模型(默认使用系统配置的模型)"
+        title={title}
       >
         <SelectValue placeholder={defaultLabel} />
       </SelectTrigger>

frontend-web/src/components/workspace/my-project-thread-indicator.tsx

@@ -0,0 +1,86 @@
+import {
+  FileText,
+  MessageSquareText,
+  Sparkles,
+  type LucideIcon,
+} from "lucide-react";
+
+import {
+  MY_PROJECT_CONVERSATION_LABELS,
+  type MyProjectConversationType,
+} from "@/core/threads/project-metadata";
+import { cn } from "@/lib/utils";
+
+const BADGE_STYLES: Record<MyProjectConversationType, string> = {
+  qa: "border-sky-200 bg-sky-50 text-sky-700 dark:border-sky-700/70 dark:bg-sky-950/55 dark:text-sky-300",
+  strategy:
+    "border-violet-200 bg-violet-50 text-violet-700 dark:border-violet-700/70 dark:bg-violet-950/55 dark:text-violet-300",
+  solution:
+    "border-emerald-200 bg-emerald-50 text-emerald-700 dark:border-emerald-700/70 dark:bg-emerald-950/55 dark:text-emerald-300",
+};
+
+const ICONS: Record<MyProjectConversationType, LucideIcon> = {
+  qa: MessageSquareText,
+  strategy: Sparkles,
+  solution: FileText,
+};
+
+const ICON_STYLES: Record<MyProjectConversationType, string> = {
+  qa: "bg-sky-50 text-sky-600 dark:bg-sky-950/70 dark:text-sky-300",
+  strategy:
+    "bg-violet-50 text-violet-600 dark:bg-violet-950/70 dark:text-violet-300",
+  solution:
+    "bg-emerald-50 text-emerald-600 dark:bg-emerald-950/70 dark:text-emerald-300",
+};
+
+export function MyProjectThreadIcon({
+  type,
+  className,
+}: {
+  type: MyProjectConversationType;
+  className?: string;
+}) {
+  const Icon = ICONS[type];
+  const label = `我的项目 · ${MY_PROJECT_CONVERSATION_LABELS[type]}`;
+  return (
+    <span
+      aria-label={label}
+      className={cn(
+        "inline-flex size-5 shrink-0 items-center justify-center rounded-md",
+        ICON_STYLES[type],
+        className,
+      )}
+      role="img"
+      title={label}
+    >
+      <Icon aria-hidden="true" className="size-3.5" />
+    </span>
+  );
+}
+
+export function MyProjectThreadBadge({
+  type,
+  projectName,
+  className,
+}: {
+  type: MyProjectConversationType;
+  projectName?: string | null;
+  className?: string;
+}) {
+  const typeLabel = `${MY_PROJECT_CONVERSATION_LABELS[type]}项目`;
+  const ownerLabel = projectName?.trim() || "我的项目";
+  return (
+    <span
+      className={cn(
+        "inline-flex min-w-0 max-w-full items-center gap-1 self-start rounded border px-1.5 py-0.5 text-[9px] font-medium leading-none",
+        BADGE_STYLES[type],
+        className,
+      )}
+      title={`来自我的项目 · ${typeLabel} · ${ownerLabel}`}
+    >
+      <span className="shrink-0">{typeLabel}</span>
+      <span aria-hidden="true" className="opacity-55">·</span>
+      <span className="min-w-0 truncate">{ownerLabel}</span>
+    </span>
+  );
+}

frontend-web/src/components/workspace/question-navigator-data.ts

@@ -0,0 +1,49 @@
+import type { Message } from "@langchain/langgraph-sdk";
+
+import {
+  extractContentFromMessage,
+  isHiddenFromUIMessage,
+  stripArtifactTag,
+  stripUploadedFilesTag,
+} from "@/core/messages/utils";
+
+const SUMMARY_MAX_LENGTH = 80;
+
+export type QuestionItem = {
+  anchorId: string;
+  summary: string;
+};
+
+/** Preserve the raw message index for historical messages without an id. */
+export function getQuestionAnchorId(message: Pick<Message, "id">, index: number): string {
+  return `message-${message.id ?? index}`;
+}
+
+function summarizeQuestion(raw: string): string {
+  let text = stripArtifactTag(stripUploadedFilesTag(raw));
+  text = text
+    .replace(/<page_context>[\s\S]*?<\/page_context>/gi, " ")
+    .replace(/```[\s\S]*?(```|$)/g, " ")
+    .replace(/!\[[^\]]*\]\([^)]*\)/g, " ")
+    .replace(/\[([^\]]*)\]\([^)]*\)/g, "$1")
+    .replace(/`([^`]*)`/g, "$1")
+    .replace(/^#{1,6}\s+/gm, "")
+    .replace(/^\s*>\s?/gm, "")
+    .replace(/^\s*[-*+]\s+/gm, "")
+    .replace(/^\s*\d+\.\s+/gm, "")
+    .replace(/(\*\*|__|~~)/g, "")
+    .replace(/\s+/g, " ")
+    .trim();
+  return text.length > SUMMARY_MAX_LENGTH ? `${text.slice(0, SUMMARY_MAX_LENGTH)}…` : text;
+}
+
+/** Index only real, visible questions, using the same visibility policy as chat. */
+export function buildQuestionItems(messages: Message[]): QuestionItem[] {
+  const items: QuestionItem[] = [];
+  messages.forEach((message, index) => {
+    if (message.type !== "human" || isHiddenFromUIMessage(message)) return;
+    const summary = summarizeQuestion(extractContentFromMessage(message));
+    if (summary) items.push({ anchorId: getQuestionAnchorId(message, index), summary });
+  });
+  return items;
+}

frontend-web/src/components/workspace/question-navigator.tsx

@@ -11,68 +11,21 @@ import {
   SheetHeader,
   SheetTitle,
 } from "@/components/ui/sheet";
-import {
-  extractContentFromMessage,
-  stripArtifactTag,
-  stripUploadedFilesTag,
-} from "@/core/messages/utils";
 import { cn } from "@/lib/utils";
 
+import { buildQuestionItems, type QuestionItem } from "./question-navigator-data";
 import { Tooltip } from "./tooltip";
 
+export { getQuestionAnchorId } from "./question-navigator-data";
+
 /** Width of the expanded floating panel, in px. */
 const PANEL_WIDTH = 300;
 /** Minimum side gutter (beyond the panel itself) required to float the panel. */
 const PANEL_GUTTER_MARGIN = 24;
-/** Max characters kept in a question summary card. */
-const SUMMARY_MAX_LENGTH = 80;
 /** Questions needed before the navigator shows up at all. */
 const MIN_QUESTIONS = 2;
 const COLLAPSE_STORAGE_KEY = "deerflow.question-navigator.collapsed";
 
-/**
- * Stable DOM anchor id for a message. Prefers the server-side message id and
- * falls back to the render index so messages without ids still get a target
- * (requirement: `message-${index}` style fallback).
- */
-export function getQuestionAnchorId(
-  message: Pick<Message, "id">,
-  index: number,
-): string {
-  return `message-${message.id ?? index}`;
-}
-
-/**
- * Turn the raw markdown of a user question into a short plain-text summary:
- * strips upload/artifact/page-context envelopes and common Markdown syntax,
- * collapses whitespace, and truncates with an ellipsis.
- */
-function summarizeQuestion(raw: string): string {
-  let text = stripArtifactTag(stripUploadedFilesTag(raw));
-  text = text
-    .replace(/<page_context>[\s\S]*?<\/page_context>/gi, " ")
-    .replace(/```[\s\S]*?(```|$)/g, " ")
-    .replace(/!\[[^\]]*\]\([^)]*\)/g, " ")
-    .replace(/\[([^\]]*)\]\([^)]*\)/g, "$1")
-    .replace(/`([^`]*)`/g, "$1")
-    .replace(/^#{1,6}\s+/gm, "")
-    .replace(/^\s*>\s?/gm, "")
-    .replace(/^\s*[-*+]\s+/gm, "")
-    .replace(/^\s*\d+\.\s+/gm, "")
-    .replace(/(\*\*|__|~~)/g, "")
-    .replace(/\s+/g, " ")
-    .trim();
-  if (text.length > SUMMARY_MAX_LENGTH) {
-    return `${text.slice(0, SUMMARY_MAX_LENGTH)}…`;
-  }
-  return text;
-}
-
-type QuestionItem = {
-  anchorId: string;
-  summary: string;
-};
-
 /** Walk up from a message anchor to the element that actually scrolls. */
 function findScrollParent(el: HTMLElement | null): HTMLElement | null {
   let node = el?.parentElement ?? null;
@@ -128,16 +81,7 @@ export function QuestionNavigator({
   const [sheetOpen, setSheetOpen] = useState(false);
   const [activeId, setActiveId] = useState<string | null>(null);
 
-  const questions = useMemo(() => {
+  const questions = useMemo(() => buildQuestionItems(messages), [messages]);
-    const items: QuestionItem[] = [];
-    messages.forEach((message, index) => {
-      if (message.type !== "human") return;
-      const summary = summarizeQuestion(extractContentFromMessage(message));
-      if (!summary) return;
-      items.push({ anchorId: getQuestionAnchorId(message, index), summary });
-    });
-    return items;
-  }, [messages]);
 
   const visible = questions.length >= MIN_QUESTIONS;
 

frontend-web/src/components/workspace/recent-chat-list.tsx

@@ -47,9 +47,14 @@ import {
   SidebarMenu,
   SidebarMenuAction,
   SidebarMenuButton,
-  SidebarMenuItem,
+  SidebarMenuItem,
+  useSidebar,
 } from "@/components/ui/sidebar";
-import { ShareConversationDialog } from "@/components/workspace/thread-share-dialogs";
+import { ShareConversationDialog } from "@/components/workspace/thread-share-dialogs";
+import {
+  MyProjectThreadBadge,
+  MyProjectThreadIcon,
+} from "@/components/workspace/my-project-thread-indicator";
 import { getAPIClient } from "@/core/api";
 import { useI18n } from "@/core/i18n/hooks";
 import {
@@ -63,7 +68,9 @@ import {
   useToggleThreadFavorite,
   useToggleThreadPin,
 } from "@/core/threads/hooks";
-import type { AgentThread, AgentThreadState } from "@/core/threads/types";
+import type { AgentThread, AgentThreadState } from "@/core/threads/types";
+import { myProjectConversationInfoOfThread } from "@/core/threads/project-metadata";
+import { useProjectThreadNames } from "@/core/threads/use-project-thread-names";
 import {
   isBootstrapThread,
   isHiddenFromRecentChats,
@@ -75,9 +82,14 @@ import {
   titleOfThread,
 } from "@/core/threads/utils";
 import { env } from "@/env";
-import { desensitize } from "@/lib/desensitize";
+import { desensitize } from "@/lib/desensitize";
-import { isIMEComposing } from "@/lib/ime";
+import { isIMEComposing } from "@/lib/ime";
-import { cn } from "@/lib/utils";
+import { cn } from "@/lib/utils";
+import { strategyProjectWorkbenchPath } from "@/strategy-selection/project-routes";
+import {
+  mergeRecentWorkspaceItems,
+  useRecentStrategyProjects,
+} from "@/strategy-selection/recent-projects";
 
 export function RecentChatList({
   compact = false,
@@ -92,7 +104,8 @@ export function RecentChatList({
 }) {
   const { t } = useI18n();
   const router = useRouter();
-  const pathname = usePathname();
+  const pathname = usePathname();
+  const { isMobile, setOpenMobile } = useSidebar();
   const [internalCollapsed, setInternalCollapsed] = useState(
     () => localStorage.getItem("sidebar:recent-chats-collapsed") === "true",
   );
@@ -109,9 +122,10 @@ export function RecentChatList({
     useParams<{
       thread_id: string;
       agent_id?: string;
-    }>();
+  }>();
-  const { data: threads = [] } = useThreads();
+  const { data: threads = [] } = useThreads();
-  const { mutate: deleteThread } = useDeleteThread();
+  const { data: recentStrategyProjects = [] } = useRecentStrategyProjects();
+  const { mutate: deleteThread } = useDeleteThread();
   const { mutate: renameThread } = useRenameThread();
   const { toggle: togglePin } = useToggleThreadPin();
   const { toggle: toggleFavorite } = useToggleThreadFavorite();
@@ -134,15 +148,15 @@ export function RecentChatList({
         });
         if (threadIndex > -1) {
           if (threads[threadIndex + 1]) {
-            nextThreadPath = listPathOfThread(threads[threadIndex + 1]!);
+            nextThreadPath = listPathOfThread(threads[threadIndex + 1]!, pathname);
           } else if (threads[threadIndex - 1]) {
-            nextThreadPath = listPathOfThread(threads[threadIndex - 1]!);
+            nextThreadPath = listPathOfThread(threads[threadIndex - 1]!, pathname);
           }
         }
         void router.push(nextThreadPath);
       }
     },
-    [agentIdFromPath, deleteThread, router, threadIdFromPath, threads],
+    [agentIdFromPath, deleteThread, pathname, router, threadIdFromPath, threads],
   );
 
   const handleRenameClick = useCallback(
@@ -195,15 +209,19 @@ export function RecentChatList({
 
   // 智能体创建（bootstrap）会话也展示在常用对话里（带机器人图标、点击回创建页）；
   // 排除调度 / 会商 / 报告结构&写作配置向导等系统会话。
-  const visibleThreads = sortThreadsPinnedFirst(
+  const visibleThreads = sortThreadsPinnedFirst(
-    threads.filter((thread) => !isHiddenFromRecentChats(thread)),
+    threads.filter((thread) => !isHiddenFromRecentChats(thread)),
-  );
+  );
-
+  const projectThreadNames = useProjectThreadNames(visibleThreads);
-  if (visibleThreads.length === 0) {
+  const recentItems = mergeRecentWorkspaceItems(
-    return null;
+    visibleThreads,
-  }
+    recentStrategyProjects,
-  const shownThreads =
+  );
-    limit != null ? visibleThreads.slice(0, limit) : visibleThreads;
+
+  if (recentItems.length === 0) {
+    return null;
+  }
+  const shownItems = limit != null ? recentItems.slice(0, limit) : recentItems;
   return (
     <>
       <SidebarGroup
@@ -224,9 +242,9 @@ export function RecentChatList({
                 : t.sidebar.demoChats}
             </span>
             {compact && (
-              <span className="text-muted-foreground bg-muted rounded-full px-1.5 py-0.5 text-[10px] font-normal tracking-normal tabular-nums">
+              <span className="text-muted-foreground bg-muted rounded-full px-1.5 py-0.5 text-[10px] font-normal tracking-normal tabular-nums">
-                {visibleThreads.length}
+                {recentItems.length}
-              </span>
+              </span>
             )}
           </span>
           {!compact && (
@@ -242,32 +260,84 @@ export function RecentChatList({
         >
           <SidebarMenu>
             <div className="flex w-full flex-col gap-0.5">
-              {shownThreads.map((thread) => {
+              {shownItems.map((item) => {
-                const href = listPathOfThread(thread);
+                if (item.kind === "strategy-project") {
+                  const { project } = item;
+                  const href = strategyProjectWorkbenchPath(
+                    "/page/strategy/qa/projects",
+                    project.id,
+                  );
+                  return (
+                    <SidebarMenuItem
+                      key={`strategy-project:${project.id}`}
+                      className="group/side-menu-item"
+                    >
+                      <SidebarMenuButton
+                        isActive={href === pathname}
+                        asChild
+                        className={cn(
+                          "h-auto min-h-11 rounded-lg px-3 py-1.5 text-[13px] text-muted-foreground hover:bg-sidebar-accent/60 hover:text-foreground",
+                          "data-[active=true]:bg-white data-[active=true]:text-foreground data-[active=true]:shadow-[0_1px_2px_rgba(15,23,42,0.05)]",
+                          "dark:data-[active=true]:bg-slate-700/80 dark:data-[active=true]:text-slate-100 dark:data-[active=true]:shadow-none",
+                          compact &&
+                            "min-h-11 gap-2 rounded-md px-2.5 data-[active=true]:border data-[active=true]:border-border",
+                        )}
+                      >
+                        <Link
+                          className="flex w-full items-center gap-1 whitespace-nowrap group-hover/side-menu-item:overflow-hidden"
+                          href={href}
+                          onClick={() => {
+                            if (isMobile) setOpenMobile(false);
+                          }}
+                        >
+                          <MyProjectThreadIcon type="strategy" />
+                          <span className="min-w-0 flex-1 flex flex-col items-start gap-0.5">
+                            <span className="w-full truncate">
+                              {desensitize(project.title)}
+                            </span>
+                            <MyProjectThreadBadge
+                              className="mr-3 max-w-[calc(100%_-_0.75rem)]"
+                              projectName={project.title}
+                              type="strategy"
+                            />
+                          </span>
+                        </Link>
+                      </SidebarMenuButton>
+                    </SidebarMenuItem>
+                  );
+                }
+
+                const { thread } = item;
+                const href = listPathOfThread(thread, pathname);
                 const isActive = href === pathname;
-                const isBoot = isBootstrapThread(thread);
+                const isBoot = isBootstrapThread(thread);
+                const projectInfo = myProjectConversationInfoOfThread(
+                  thread,
+                  projectThreadNames,
+                );
                 const pinned = isThreadPinned(thread);
                 const favorited = isThreadFavorite(thread);
                 return (
-                  <SidebarMenuItem
+                  <SidebarMenuItem
-                    key={thread.thread_id}
+                    key={`thread:${thread.thread_id}`}
                     className="group/side-menu-item"
                   >
                     <SidebarMenuButton
                       isActive={isActive}
                       asChild
-                      className={
+                      className={cn(
-                        "rounded-lg h-7 px-3 text-[13px] text-muted-foreground hover:text-foreground hover:bg-sidebar-accent/60 " +
+                        "h-7 rounded-lg px-3 text-[13px] text-muted-foreground hover:bg-sidebar-accent/60 hover:text-foreground",
-                        "data-[active=true]:bg-white data-[active=true]:text-foreground data-[active=true]:shadow-[0_1px_2px_rgba(15,23,42,0.05)] " +
+                        "data-[active=true]:bg-white data-[active=true]:text-foreground data-[active=true]:shadow-[0_1px_2px_rgba(15,23,42,0.05)]",
-                        "dark:data-[active=true]:bg-slate-700/80 dark:data-[active=true]:text-slate-100 dark:data-[active=true]:shadow-none" +
+                        "dark:data-[active=true]:bg-slate-700/80 dark:data-[active=true]:text-slate-100 dark:data-[active=true]:shadow-none",
-                        (compact
+                        compact &&
-                          ? " h-9 gap-2 rounded-md px-2.5 data-[active=true]:border data-[active=true]:border-border"
+                          "h-9 gap-2 rounded-md px-2.5 data-[active=true]:border data-[active=true]:border-border",
-                          : "")
+                        projectInfo && "h-auto min-h-11 py-1.5",
-                      }
+                      )}
                     >
                       <Link
                         className="flex w-full items-center gap-1 whitespace-nowrap group-hover/side-menu-item:overflow-hidden"
-                        href={href}
+                        href={href}
+                        onClick={() => { if (isMobile) setOpenMobile(false); }}
                       >
                         {isBoot ? (
                           <Bot
@@ -279,8 +349,10 @@ export function RecentChatList({
                             }
                             aria-label="智能体创建会话"
                           />
-                        ) : (
+                        ) : projectInfo ? (
-                          compact && (
+                          <MyProjectThreadIcon type={projectInfo.type} />
+                        ) : (
+                          compact && (
                             <MessageSquare
                               className={
                                 "size-3.5 shrink-0 " +
@@ -294,9 +366,23 @@ export function RecentChatList({
                         {pinned && (
                           <Pin className="size-3 shrink-0 text-muted-foreground/70" />
                         )}
-                        <span className="truncate">
+                        <span
-                          {desensitize(titleOfThread(thread, t.pages.newChat))}
+                          className={cn(
-                        </span>
+                            "min-w-0 flex-1",
+                            projectInfo && "flex flex-col items-start gap-0.5",
+                          )}
+                        >
+                          <span className="w-full truncate">
+                            {desensitize(titleOfThread(thread, t.pages.newChat))}
+                          </span>
+                          {projectInfo && (
+                            <MyProjectThreadBadge
+                              className="mr-3 max-w-[calc(100%_-_0.75rem)]"
+                              projectName={projectInfo.projectName}
+                              type={projectInfo.type}
+                            />
+                          )}
+                        </span>
                       </Link>
                     </SidebarMenuButton>
                     {env.NEXT_PUBLIC_STATIC_WEBSITE_ONLY !== "true" && (

frontend-web/src/components/workspace/settings/account-settings-page.tsx

@@ -5,12 +5,15 @@ import { toast } from "sonner";
 
 import { Badge } from "@/components/ui/badge";
 import { Button } from "@/components/ui/button";
+import { apiFetch } from "@/core/api/fetch-client";
 import { clearStoredAuth, getAccountDisplayName, getStoredAuth } from "@/core/auth";
 import { useLiveAccount } from "@/core/auth/use-live-account";
+import { getBackendBaseURL } from "@/core/config";
 import { OptType, writeYLog } from "@/core/log/y-log";
 import { clearYLogToken } from "@/core/log/y-log-token";
 
 import { SettingsSection } from "./settings-section";
+import { PasswordSettings } from "./password-settings";
 
 function roleLabel(role?: string) {
   if (role === "admin") return "管理员";
@@ -57,14 +60,15 @@ export function AccountSettingsPage() {
     // Match the rest of the app's logout flow: blow away the cookie session
     // by hitting the gateway logout endpoint and then forcing a full reload
     // so any cached query state goes too.
-    void fetch("/api/v1/auth/logout", { method: "POST", credentials: "include" })
+    void apiFetch(`${getBackendBaseURL()}/api/v1/auth/logout`, { method: "POST" })
       .catch(() => undefined)
       .finally(() => {
-        window.location.assign("/");
+        window.location.assign(`${window.location.pathname}#/login`);
       });
   };
 
   return (
+    <div className="space-y-8">
     <SettingsSection title="个人信息" description="当前登录账号的基本信息。">
       <div className="flex flex-col gap-4 rounded-xl border bg-white p-5">
         <div className="flex items-center gap-3">
@@ -106,6 +110,8 @@ export function AccountSettingsPage() {
         </div>
       </div>
     </SettingsSection>
+    <PasswordSettings key={auth.user_id} userId={auth.user_id} />
+    </div>
   );
 }
 

frontend-web/src/components/workspace/settings/authentication-settings-page.tsx

@@ -0,0 +1,102 @@
+"use client";
+
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { useState } from "react";
+import { useNavigate } from "react-router-dom";
+import { toast } from "sonner";
+
+import { Button } from "@/components/ui/button";
+import { Switch } from "@/components/ui/switch";
+import { AUTH_STATE_CHANGED_EVENT, getStoredAuth } from "@/core/auth";
+import {
+  getAuthenticationSettings,
+  saveAuthenticationSettings,
+  type AuthenticationSettings,
+} from "@/core/auth/account-settings-api";
+import { useLiveAccount } from "@/core/auth/use-live-account";
+
+import { SettingsSection } from "./settings-section";
+
+export function AuthenticationSettingsPage({ onClose }: { onClose?: () => void }) {
+  const navigate = useNavigate();
+  const live = useLiveAccount();
+  const isAdmin = getStoredAuth()?.system_role === "admin";
+  const queryClient = useQueryClient();
+  const queryKey = ["authentication-settings", live.userId];
+  const query = useQuery({ queryKey, queryFn: getAuthenticationSettings, enabled: isAdmin });
+  const [draft, setDraft] = useState<AuthenticationSettings | null>(null);
+  const mutation = useMutation({ mutationFn: saveAuthenticationSettings });
+  const settings = draft ?? query.data;
+
+  if (!isAdmin) return null;
+
+  const update = (key: keyof AuthenticationSettings, value: boolean) => {
+    if (!settings) return;
+    const next = { ...settings, [key]: value };
+    if (key === "password_login_enabled" && !value) next.registration_enabled = false;
+    setDraft(next);
+  };
+
+  const save = async () => {
+    if (!settings || mutation.isPending) return;
+    try {
+      const saved = await mutation.mutateAsync(settings);
+      queryClient.setQueryData(queryKey, saved);
+      setDraft(null);
+      void queryClient.invalidateQueries({ queryKey: ["auth-options"] });
+      window.dispatchEvent(new Event(AUTH_STATE_CHANGED_EVENT));
+      toast.success("登录与注册设置已保存，即时生效");
+    } catch (error) {
+      toast.error(error instanceof Error ? error.message : "保存失败");
+    }
+  };
+
+  const invalid = settings && !settings.password_login_enabled && !settings.sso_enabled;
+
+  return (
+    <SettingsSection title="登录与注册" description="管理登录页面、自主注册与账号在线限制，保存后即时生效。">
+      {query.isPending ? (
+        <p className="text-muted-foreground text-sm">正在加载设置…</p>
+      ) : query.isError ? (
+        <div role="alert" className="space-y-3 text-sm">
+          <p className="text-destructive">{query.error.message}</p>
+          <Button variant="outline" onClick={() => void query.refetch()}>重新加载</Button>
+        </div>
+      ) : settings && (
+        <div className="space-y-5">
+          <div className="divide-y rounded-xl border px-5">
+            <SettingSwitch id="password-login-enabled" title="账号密码登录" description="默认关闭。开启后须登录才能进入系统。未设置个人密码的账号使用现有系统口令。" checked={settings.password_login_enabled} disabled={mutation.isPending} onChange={(value) => update("password_login_enabled", value)} />
+            <SettingSwitch id="registration-enabled" title="用户自主注册" description="允许用户在注册页创建自己的普通账号。需先开启账号密码登录。" checked={settings.registration_enabled} disabled={mutation.isPending || !settings.password_login_enabled} onChange={(value) => update("registration_enabled", value)} />
+            <SettingSwitch id="single-session-enabled" title="单点登录" description="默认关闭。开启后同一账号只允许一处在线，新登录会使其他登录会话自动退出。" checked={settings.single_session_enabled ?? false} disabled={mutation.isPending} onChange={(value) => update("single_session_enabled", value)} />
+            <SettingSwitch id="sso-enabled" title="外部系统免登" description="允许外部系统通过票据、令牌或口令链接登录，与单点登录的在线限制独立。" checked={settings.sso_enabled} disabled={mutation.isPending} onChange={(value) => update("sso_enabled", value)} />
+          </div>
+          <p className="text-muted-foreground text-sm">密码与登录口令共用。至少保留账号密码登录或外部系统免登中的一种；关闭自主注册不影响已有账号。</p>
+          <Button variant="outline" onClick={() => { onClose?.(); navigate("/page/strategy/admin/login-whitelist"); }}>管理用户密码与登录口令</Button>
+          {invalid && <p role="alert" className="text-destructive text-sm">请至少开启账号密码登录或外部系统免登。</p>}
+          <div className="flex justify-end">
+            <Button disabled={!draft || Boolean(invalid) || mutation.isPending} onClick={() => void save()}>{mutation.isPending ? "保存中…" : "保存设置"}</Button>
+          </div>
+        </div>
+      )}
+    </SettingsSection>
+  );
+}
+
+function SettingSwitch({ id, title, description, checked, disabled, onChange }: {
+  id: string;
+  title: string;
+  description: string;
+  checked: boolean;
+  disabled: boolean;
+  onChange: (checked: boolean) => void;
+}) {
+  return (
+    <div className="flex items-center justify-between gap-5 py-5">
+      <div className="space-y-1">
+        <label htmlFor={id} className="cursor-pointer text-sm font-medium">{title}</label>
+        <p id={`${id}-description`} className="text-muted-foreground text-sm">{description}</p>
+      </div>
+      <Switch id={id} aria-describedby={`${id}-description`} checked={checked} disabled={disabled} onCheckedChange={onChange} />
+    </div>
+  );
+}

frontend-web/src/components/workspace/settings/context-window-settings-page.tsx

@@ -0,0 +1,86 @@
+"use client";
+
+import { Loader2Icon, ShrinkIcon } from "lucide-react";
+import { toast } from "sonner";
+
+import { Button } from "@/components/ui/button";
+import { Switch } from "@/components/ui/switch";
+import {
+  useConversationContextSettings,
+  useUpdateConversationContextSettings,
+} from "@/core/system-settings/hooks";
+
+export function ContextWindowSettingsPage() {
+  const { data, isLoading, isError, isFetching, refetch } =
+    useConversationContextSettings();
+  const update = useUpdateConversationContextSettings();
+  const enabled = data?.recent_turn_window_enabled ?? false;
+  const recentTurns = data?.recent_turns ?? 3;
+
+  const handleChange = async (checked: boolean) => {
+    try {
+      await update.mutateAsync({ recent_turn_window_enabled: checked });
+      toast.success(
+        checked
+          ? `近 ${recentTurns} 轮上下文模式已开启`
+          : `近 ${recentTurns} 轮上下文模式已关闭`,
+      );
+    } catch (error) {
+      toast.error(error instanceof Error ? error.message : "保存失败");
+    }
+  };
+
+  return (
+    <section className="space-y-6">
+      <div className="space-y-1">
+        <h3 className="flex items-center gap-2 text-lg font-semibold">
+          <ShrinkIcon className="size-5" />
+          上下文管理
+        </h3>
+        <p className="text-muted-foreground text-sm">
+          控制长对话发给模型的历史范围。该模式默认关闭，只有管理员显式开启后才会生效。
+        </p>
+      </div>
+
+      <div className="flex items-center justify-between gap-6 rounded-lg border p-4">
+        <div className="space-y-1">
+          <div className="font-medium">仅保留最近 {recentTurns} 轮对话</div>
+          <p className="text-muted-foreground text-sm">
+            开启后，主问答引擎的模型请求只携带最近 {recentTurns}
+            个真实用户回合（含当前轮）及其回复和工具结果，不再调用摘要模型。完整聊天记录仍会保存并显示；若这三轮本身仍超过模型上限，最终安全限制会继续裁剪超长内容。
+          </p>
+        </div>
+        {isLoading ? (
+          <Loader2Icon className="text-muted-foreground size-5 animate-spin" />
+        ) : (
+          <Switch
+            checked={enabled}
+            disabled={isError || update.isPending}
+            onCheckedChange={handleChange}
+            aria-label={`仅保留最近 ${recentTurns} 轮对话`}
+          />
+        )}
+      </div>
+
+      {isError && (
+        <div className="flex items-center justify-between gap-3">
+          <p className="text-destructive text-sm">
+            无法读取当前上下文模式，本页暂不能修改；服务端会继续保持原设置。
+          </p>
+          <Button
+            type="button"
+            variant="outline"
+            size="sm"
+            disabled={isFetching}
+            onClick={() => void refetch()}
+          >
+            {isFetching ? "重新加载中…" : "重新加载"}
+          </Button>
+        </div>
+      )}
+      <p className="text-muted-foreground text-xs">
+        开启后优先于聊天框中的“上下文压缩”选项，并从下一次新问答或运行开始生效，无需重启服务。
+      </p>
+    </section>
+  );
+}

frontend-web/src/components/workspace/settings/knowledge-retrieval-settings-page.tsx

@@ -0,0 +1,120 @@
+"use client";
+
+import { Loader2Icon, SearchIcon } from "lucide-react";
+import { toast } from "sonner";
+
+import { Button } from "@/components/ui/button";
+import { Switch } from "@/components/ui/switch";
+import {
+  useOrdinaryKnowledgeRetrievalSettings,
+  useUpdateOrdinaryKnowledgeRetrievalSettings,
+} from "@/core/system-settings/hooks";
+
+export function KnowledgeRetrievalSettingsPage() {
+  const { data, isLoading, isError, isFetching, refetch } =
+    useOrdinaryKnowledgeRetrievalSettings();
+  const update = useUpdateOrdinaryKnowledgeRetrievalSettings();
+  const enabled = data?.smart_reasoning_enabled ?? false;
+  const advancedManagementEnabled =
+    data?.advanced_management_enabled ?? false;
+
+  const handleChange = async (checked: boolean) => {
+    try {
+      await update.mutateAsync({ smart_reasoning_enabled: checked });
+      toast.success(
+        checked ? "普通知识库智能检索已开启" : "普通知识库智能检索已关闭",
+      );
+    } catch (error) {
+      toast.error(error instanceof Error ? error.message : "保存失败");
+    }
+  };
+
+  const handleAdvancedManagementChange = async (checked: boolean) => {
+    try {
+      await update.mutateAsync({ advanced_management_enabled: checked });
+      toast.success(
+        checked ? "知识库高级管理入口已开放" : "知识库高级管理入口已隐藏",
+      );
+    } catch (error) {
+      toast.error(error instanceof Error ? error.message : "保存失败");
+    }
+  };
+
+  return (
+    <section className="space-y-6">
+      <div className="space-y-1">
+        <h3 className="flex items-center gap-2 text-lg font-semibold">
+          <SearchIcon className="size-5" />
+          知识检索
+        </h3>
+        <p className="text-muted-foreground text-sm">
+          控制普通知识库问答是否默认使用智能检索。该能力默认关闭，经典检索模式始终保留为候选。
+        </p>
+      </div>
+
+      <div className="flex items-center justify-between gap-6 rounded-lg border p-4">
+        <div className="space-y-1">
+          <div className="font-medium">普通知识库智能推理检索</div>
+          <p className="text-muted-foreground text-sm">
+            开启后，新对话默认使用智能检索：先召回原文分片，再根据命中线索查阅并扩展
+            Wiki，把知识库资料作为回答背景。已有对话继续使用各自保存的模式，用户仍可在
+            输入框的检索模式菜单中切换到经典检索。
+          </p>
+        </div>
+        {isLoading ? (
+          <Loader2Icon className="text-muted-foreground size-5 animate-spin" />
+        ) : (
+          <Switch
+            checked={enabled}
+            disabled={isError || update.isPending}
+            onCheckedChange={handleChange}
+            aria-label="普通知识库智能推理检索"
+          />
+        )}
+      </div>
+
+      <div className="flex items-center justify-between gap-6 rounded-lg border p-4">
+        <div className="space-y-1">
+          <div className="font-medium">知识库高级管理入口</div>
+          <p className="text-muted-foreground text-sm">
+            默认隐藏检索测试、增量同步和知识库数据包导入导出。开启后按原有账号权限显示；
+            基础知识库管理和查看 Wiki 索引始终可用。
+          </p>
+        </div>
+        {isLoading ? (
+          <Loader2Icon className="text-muted-foreground size-5 animate-spin" />
+        ) : (
+          <Switch
+            checked={advancedManagementEnabled}
+            disabled={isError || update.isPending}
+            onCheckedChange={handleAdvancedManagementChange}
+            aria-label="知识库高级管理入口"
+          />
+        )}
+      </div>
+
+      {isError && (
+        <div className="flex items-center justify-between gap-3">
+          <p className="text-destructive text-sm">
+            无法读取当前知识检索设置，客户端按关闭处理，本页暂不能修改。
+          </p>
+          <Button
+            type="button"
+            variant="outline"
+            size="sm"
+            disabled={isFetching}
+            onClick={() => void refetch()}
+          >
+            {isFetching ? "重新加载中…" : "重新加载"}
+          </Button>
+        </div>
+      )}
+
+      <p className="text-muted-foreground text-xs">
+        用户只需直接提问，无需填写“先检索什么、再检索什么”的固定模板；系统不会向输入框
+        注入检索提示词。智能检索将检索资料与模型原有能力结合后回答，不强制生成参考文献编号。
+        关闭后不会删除历史对话；已保存为智能检索的线程需要切回经典模式后才能继续发送。
+      </p>
+    </section>
+  );
+}

frontend-web/src/components/workspace/settings/memory-runtime-settings-page.tsx

@@ -0,0 +1,67 @@
+"use client";
+
+import { BrainIcon, Loader2Icon } from "lucide-react";
+import { toast } from "sonner";
+
+import { Switch } from "@/components/ui/switch";
+import {
+  useMemoryRuntimeSettings,
+  useUpdateMemoryRuntimeSettings,
+} from "@/core/system-settings/hooks";
+
+export function MemoryRuntimeSettingsPage() {
+  const { data, isLoading, isError } = useMemoryRuntimeSettings();
+  const update = useUpdateMemoryRuntimeSettings();
+  const enabled = data?.enabled ?? false;
+
+  const handleChange = async (checked: boolean) => {
+    try {
+      await update.mutateAsync({ enabled: checked });
+      toast.success(checked ? "问答记忆已开启" : "问答记忆已关闭");
+    } catch (error) {
+      toast.error(error instanceof Error ? error.message : "保存失败");
+    }
+  };
+
+  return (
+    <section className="space-y-6">
+      <div className="space-y-1">
+        <h3 className="flex items-center gap-2 text-lg font-semibold">
+          <BrainIcon className="size-5" />
+          问答记忆
+        </h3>
+        <p className="text-muted-foreground text-sm">
+          全局控制问答是否读取和写入长期记忆。系统默认永久关闭，只有管理员在这里显式开启后才会生效。
+        </p>
+      </div>
+
+      <div className="flex items-center justify-between gap-6 rounded-lg border p-4">
+        <div className="space-y-1">
+          <div className="font-medium">启用问答记忆</div>
+          <p className="text-muted-foreground text-sm">
+            关闭时不会加载记忆中间件、不会向提示词注入记忆，也不会在回答结束后调用模型提取记忆。
+          </p>
+        </div>
+        {isLoading ? (
+          <Loader2Icon className="text-muted-foreground size-5 animate-spin" />
+        ) : (
+          <Switch
+            checked={enabled}
+            disabled={isError || update.isPending}
+            onCheckedChange={handleChange}
+            aria-label="启用问答记忆"
+          />
+        )}
+      </div>
+
+      {isError && (
+        <p className="text-destructive text-sm">
+          无法读取记忆开关，系统将按关闭处理。
+        </p>
+      )}
+      <p className="text-muted-foreground text-xs">
+        修改对下一次发起的问答生效；已生成的历史记忆文件不会被自动删除。
+      </p>
+    </section>
+  );
+}

frontend-web/src/components/workspace/settings/password-settings.tsx

@@ -0,0 +1,102 @@
+"use client";
+
+import { useQuery, useQueryClient } from "@tanstack/react-query";
+import { useState, type FormEvent } from "react";
+import { toast } from "sonner";
+
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import { getStoredAuth, setStoredAuth } from "@/core/auth";
+import { changeAccountPassword, getAccountPasswordStatus } from "@/core/auth/account-settings-api";
+
+import { SettingsSection } from "./settings-section";
+
+export function PasswordSettings({ userId }: { userId: string }) {
+  const queryClient = useQueryClient();
+  const status = useQuery({
+    queryKey: ["account-password", userId],
+    queryFn: getAccountPasswordStatus,
+  });
+  const [currentPassword, setCurrentPassword] = useState("");
+  const [newPassword, setNewPassword] = useState("");
+  const [confirmPassword, setConfirmPassword] = useState("");
+  const [pending, setPending] = useState(false);
+  const [error, setError] = useState("");
+  const hasPassword = status.data?.has_password ?? true;
+  const requiresCurrentPassword = status.data?.requires_current_password ?? true;
+
+  const submit = async (event: FormEvent<HTMLFormElement>) => {
+    event.preventDefault();
+    if (pending || !status.data) return;
+    setError("");
+    if (newPassword !== confirmPassword) {
+      setError("两次输入的新密码不一致");
+      return;
+    }
+    if (newPassword.length < 8) {
+      setError("新密码至少需要 8 位，请避免常见弱密码");
+      return;
+    }
+    const auth = getStoredAuth();
+    if (!auth || auth.user_id !== userId) {
+      setError("登录账号已变化，请重新打开个人信息");
+      return;
+    }
+    setPending(true);
+    try {
+      const session = await changeAccountPassword(requiresCurrentPassword ? currentPassword : "", newPassword);
+      // Another tab may have changed the active account while the request was pending.
+      if (getStoredAuth()?.access_token !== auth.access_token) return;
+      if (session.access_token) {
+        setStoredAuth({
+          ...auth,
+          access_token: session.access_token,
+          token_type: session.token_type ?? auth.token_type,
+          expires_in: session.expires_in ?? auth.expires_in,
+          needs_setup: false,
+        });
+      }
+      setCurrentPassword("");
+      setNewPassword("");
+      setConfirmPassword("");
+      queryClient.setQueryData(["account-password", userId], { ...status.data, has_password: true, requires_current_password: true, uses_default_password: false });
+      void queryClient.invalidateQueries({ queryKey: ["admin", "users"] });
+      toast.success("密码与登录口令已同步更新，其他登录会话已失效");
+    } catch (cause) {
+      setError(cause instanceof Error ? cause.message : "密码修改失败");
+    } finally {
+      setPending(false);
+    }
+  };
+
+  return (
+    <SettingsSection title={hasPassword ? "修改密码" : "设置密码"} description="密码与登录口令共用，修改后原密码和原口令链接失效。">
+      {status.isPending ? <p className="text-muted-foreground text-sm">正在读取密码状态…</p> : status.isError ? (
+        <div role="alert" className="space-y-3 text-sm">
+          <p className="text-destructive">{status.error.message}</p>
+          <Button variant="outline" onClick={() => void status.refetch()}>重新加载</Button>
+        </div>
+      ) : (
+        <form onSubmit={(event) => void submit(event)} className="space-y-4 rounded-xl border p-5">
+          {!hasPassword && <p className="text-muted-foreground text-sm">此账号尚未设置个人密码，当前使用系统口令。请先输入现有口令，再设置个人密码。</p>}
+          {requiresCurrentPassword && (
+            <div className="space-y-2">
+              <label className="text-sm font-medium" htmlFor="account-current-password">当前密码 / 口令</label>
+              <Input id="account-current-password" type="password" autoComplete="current-password" required value={currentPassword} onChange={(event) => setCurrentPassword(event.target.value)} disabled={pending} />
+            </div>
+          )}
+          <div className="space-y-2">
+            <label className="text-sm font-medium" htmlFor="account-new-password">新密码</label>
+            <Input id="account-new-password" type="password" autoComplete="new-password" required minLength={8} maxLength={255} placeholder="至少 8 位，避免常见弱密码" value={newPassword} onChange={(event) => setNewPassword(event.target.value)} disabled={pending} />
+          </div>
+          <div className="space-y-2">
+            <label className="text-sm font-medium" htmlFor="account-confirm-password">确认新密码</label>
+            <Input id="account-confirm-password" type="password" autoComplete="new-password" required minLength={8} maxLength={255} value={confirmPassword} onChange={(event) => setConfirmPassword(event.target.value)} disabled={pending} />
+          </div>
+          {error && <p role="alert" className="text-destructive text-sm">{error}</p>}
+          <div className="flex justify-end"><Button type="submit" disabled={pending}>{pending ? "保存中…" : "保存密码"}</Button></div>
+        </form>
+      )}
+    </SettingsSection>
+  );
+}

frontend-web/src/components/workspace/settings/settings-dialog.tsx

@@ -1,6 +1,19 @@
 "use client";
 
-import { BellIcon, PaletteIcon, SparklesIcon, UserIcon, WrenchIcon } from "lucide-react";
+import {
+  BellIcon,
+  BrainIcon,
+  CpuIcon,
+  FileOutputIcon,
+  PaletteIcon,
+  SearchIcon,
+  ShieldCheckIcon,
+  ShrinkIcon,
+  SparklesIcon,
+  UploadCloudIcon,
+  UserIcon,
+  WrenchIcon,
+} from "lucide-react";
 import { useEffect, useMemo, useState } from "react";
 
 import {
@@ -12,18 +25,32 @@ import {
 import { ScrollArea } from "@/components/ui/scroll-area";
 import { AboutSettingsPage } from "@/components/workspace/settings/about-settings-page";
 import { AccountSettingsPage } from "@/components/workspace/settings/account-settings-page";
+import { AuthenticationSettingsPage } from "@/components/workspace/settings/authentication-settings-page";
 import { AppearanceSettingsPage } from "@/components/workspace/settings/appearance-settings-page";
-import { MemorySettingsPage } from "@/components/workspace/settings/memory-settings-page";
+import { ContextWindowSettingsPage } from "@/components/workspace/settings/context-window-settings-page";
-import { ToolSettingsPage } from "@/components/workspace/settings/tool-settings-page";
+import { KnowledgeRetrievalSettingsPage } from "@/components/workspace/settings/knowledge-retrieval-settings-page";
-import { useI18n } from "@/core/i18n/hooks";
+import { MemoryRuntimeSettingsPage } from "@/components/workspace/settings/memory-runtime-settings-page";
-import { cn } from "@/lib/utils";
+import { ToolSettingsPage } from "@/components/workspace/settings/tool-settings-page";
+import { UploadSettingsPage } from "@/components/workspace/settings/upload-settings-page";
+import { WriteFileCompatibilitySettingsPage } from "@/components/workspace/settings/write-file-compatibility-settings-page";
+import { getStoredAuth } from "@/core/auth";
+import { useLiveAccount } from "@/core/auth/use-live-account";
+import { useI18n } from "@/core/i18n/hooks";
+import { cn } from "@/lib/utils";
+import { LocalEncoderSettingsCard } from "@/strategy-components/components/resource-management/llmwiki/WeKnoraKnowledgeWorkspace";
 
 type SettingsSection =
   | "account"
+  | "authentication"
   | "appearance"
-  | "memory"
+  | "conversation-context"
-  | "tools"
+  | "knowledge-retrieval"
-  | "about";
+  | "memory"
+  | "fileWriting"
+  | "uploads"
+  | "tools"
+  | "encoder"
+  | "about";
 
 type SettingsDialogProps = React.ComponentProps<typeof Dialog> & {
   defaultSection?: SettingsSection;
@@ -31,7 +58,9 @@ type SettingsDialogProps = React.ComponentProps<typeof Dialog> & {
 
 export function SettingsDialog(props: SettingsDialogProps) {
   const { defaultSection = "appearance", ...dialogProps } = props;
-  const { t } = useI18n();
+  const { t } = useI18n();
+  const live = useLiveAccount();
+  const isAdmin = getStoredAuth()?.system_role === "admin";
   const [activeSection, setActiveSection] =
     useState<SettingsSection>(defaultSection);
 
@@ -57,13 +86,20 @@ export function SettingsDialog(props: SettingsDialogProps) {
       // },
       // { id: "tools", label: t.settings.sections.tools, icon: WrenchIcon },
       // { id: "skills", label: t.settings.sections.skills, icon: SparklesIcon },
-      // 记忆已移至侧边栏入口 (/page/workspace/memory)
+      ...(isAdmin
-      // {
+        ? [
-      //   id: "memory",
+            { id: "conversation-context", label: "上下文管理", icon: ShrinkIcon },
-      //   label: t.settings.sections.memory,
+            { id: "knowledge-retrieval", label: "知识检索", icon: SearchIcon },
-      //   icon: BrainIcon,
+            { id: "memory", label: "问答记忆", icon: BrainIcon },
-      // },
+            { id: "fileWriting", label: "文件流式兼容", icon: FileOutputIcon },
-      { id: "tools", label: t.settings.sections.tools, icon: WrenchIcon },
+            { id: "uploads", label: "上传设置", icon: UploadCloudIcon },
+            { id: "authentication", label: "登录与注册", icon: ShieldCheckIcon },
+          ]
+        : []),
+      { id: "tools", label: t.settings.sections.tools, icon: WrenchIcon },
+      ...(isAdmin
+        ? [{ id: "encoder", label: "Wiki 镜像编码器", icon: CpuIcon }]
+        : []),
       {
         id: "account",
         label: "个人信息",
@@ -75,7 +111,8 @@ export function SettingsDialog(props: SettingsDialogProps) {
       t.settings.sections.appearance,
       t.settings.sections.memory,
       t.settings.sections.tools,
-      t.settings.sections.about,
+      t.settings.sections.about,
+      isAdmin,
     ],
   );
   return (
@@ -121,11 +158,36 @@ export function SettingsDialog(props: SettingsDialogProps) {
           <ScrollArea className="h-full min-h-0 min-w-0 rounded-lg border">
             <div className="min-w-0 space-y-8 p-6">
               {activeSection === "account" && <AccountSettingsPage />}
-              {activeSection === "appearance" && (
+              {activeSection === "authentication" && isAdmin && (
-                <AppearanceSettingsPage onClose={() => props.onOpenChange?.(false)} />
+                <AuthenticationSettingsPage
+                  key={live.userId}
+                  onClose={() => props.onOpenChange?.(false)}
+                />
               )}
-              {activeSection === "memory" && <MemorySettingsPage />}
+              {activeSection === "appearance" && (
-              {activeSection === "tools" && <ToolSettingsPage />}
+                <AppearanceSettingsPage
+                  onClose={() => props.onOpenChange?.(false)}
+                />
+              )}
+              {activeSection === "conversation-context" && isAdmin && (
+                <ContextWindowSettingsPage />
+              )}
+              {activeSection === "knowledge-retrieval" && isAdmin && (
+                <KnowledgeRetrievalSettingsPage />
+              )}
+              {activeSection === "memory" && isAdmin && (
+                <MemoryRuntimeSettingsPage />
+              )}
+              {activeSection === "fileWriting" && isAdmin && (
+                <WriteFileCompatibilitySettingsPage />
+              )}
+              {activeSection === "uploads" && isAdmin && (
+                <UploadSettingsPage />
+              )}
+              {activeSection === "tools" && <ToolSettingsPage />}
+              {activeSection === "encoder" && isAdmin && (
+                <LocalEncoderSettingsCard />
+              )}
               {activeSection === "about" && <AboutSettingsPage />}
             </div>
           </ScrollArea>

frontend-web/src/components/workspace/settings/skill-settings-page.tsx

@@ -19,6 +19,8 @@ import {
   LockIcon,
   PinIcon,
   PlusIcon,
+  Power,
+  PowerOff,
   RefreshCwIcon,
   SparklesIcon,
   TagsIcon,
@@ -70,11 +72,13 @@ import { ViewModeToggle } from "@/components/workspace/view-mode-toggle";
 import { useTheme } from "@/contexts/ThemeContext";
 import { getStoredAuth } from "@/core/auth";
 import { useI18n } from "@/core/i18n/hooks";
+import { MINIMAL_SKILL_MD_EXAMPLE } from "@/core/skill-example";
 import type { ValidateSkillUploadResponse } from "@/core/skills/api";
-import {
+import {
-  useDeleteBuiltinSkill,
+  useDeleteBuiltinSkill,
-  useDeleteCustomSkill,
+  useDeleteCustomSkill,
   useDuplicateSkill,
+  useEnableSkill,
   useGenerateMissingSkillNameZh,
   useGenerateSkillNameZh,
   useInstallSkillUpload,
@@ -87,13 +91,25 @@ import {
   useSkills,
   useValidateSkillUpload,
 } from "@/core/skills/hooks";
+import {
+  canToggleSkillAvailability,
+  isSkillOffline,
+  type SkillAvailabilityControl,
+} from "@/core/skill-availability";
 import {
   usePublishSquares,
   useSkillCompressionSettings,
   useViewMode,
 } from "@/core/system-settings/hooks";
+import {
+  WX_RESTRICTED_TAB_DEFAULT_SQUARE,
+  WX_RESTRICTED_TAB_NANJING_DB,
+  isWxRestrictedPlaceholderTab,
+  wxRestrictedDefaultSquareTabValue,
+  wxRestrictedNanjingTabValue,
+} from "@/core/system-settings/wx-type-filter";
 import type { Skill } from "@/core/skills/type";
-import type { SkillKnowledgeBinding } from "@/strategy-components/api/skill-knowledge";
+import type { SkillKnowledgeBinding } from "@/strategy-components/api/skill-knowledge";
 import { formatDateTime } from "@/core/utils/datetime";
 import { env } from "@/env";
 import { desensitize } from "@/lib/desensitize";
@@ -102,14 +118,28 @@ import { cn } from "@/lib/utils";
 import { SettingsSection } from "./settings-section";
 import { SkillStateSheet } from "./skill-state-sheet";
 
-export function SkillSettingsPage({ onClose }: { onClose?: () => void } = {}) {
+export function SkillSettingsPage({
+  onClose,
+  embedded = false,
+  restrictWxTypes = false,
+}: {
+  onClose?: () => void;
+  embedded?: boolean;
+  /** wx 侧栏入口：类型 Tab 只保留 我的 / 默认广场 / 南京-db。 */
+  restrictWxTypes?: boolean;
+} = {}) {
   const { t } = useI18n();
+  if (embedded) {
+    return (
+      <SkillSettingsList onClose={onClose} restrictWxTypes={restrictWxTypes} />
+    );
+  }
   return (
     <SettingsSection
       title={t.settings.skills.title}
       description={t.settings.skills.description}
     >
-      <SkillSettingsList onClose={onClose} />
+      <SkillSettingsList onClose={onClose} restrictWxTypes={restrictWxTypes} />
     </SettingsSection>
   );
 }
@@ -158,7 +188,13 @@ const rescanErrorToastDarkOptions = {
   icon: <AlertCircle className="size-4 shrink-0 text-[#F5222D]" />,
 } as const;
 
-function SkillSettingsList({ onClose }: { onClose?: () => void }) {
+function SkillSettingsList({
+  onClose,
+  restrictWxTypes = false,
+}: {
+  onClose?: () => void;
+  restrictWxTypes?: boolean;
+}) {
   const { t } = useI18n();
   const { theme } = useTheme();
   const router = useRouter();
@@ -180,6 +216,10 @@ function SkillSettingsList({ onClose }: { onClose?: () => void }) {
   // Each configured publish square (发布广场) becomes its own browse tab; the
   // backend always returns at least one (the built-in default).
   const squareTabs = publishSquares?.squares ?? [];
+  const defaultSquareTabValue = wxRestrictedDefaultSquareTabValue(
+    publishSquares?.default_square_id,
+  );
+  const nanjingTabValue = wxRestrictedNanjingTabValue(squareTabs);
   const reconcileMutation = useReconcileCustomSkills();
   const fillNamesMutation = useGenerateMissingSkillNameZh();
   // Optional model override for the admin "一键补充中文名" action (null = default).
@@ -246,6 +286,9 @@ function SkillSettingsList({ onClose }: { onClose?: () => void }) {
   const isSquareTab = filter !== "mine";
   const scopedSkills = filter === "mine" ? activeMine : activeAll;
   const filteredSkills = useMemo(() => {
+    if (restrictWxTypes && isWxRestrictedPlaceholderTab(filter)) {
+      return [];
+    }
     let list = publisher
       ? scopedSkills.filter((s) => s.owner_user_id === publisher.id)
       : scopedSkills;
@@ -259,7 +302,14 @@ function SkillSettingsList({ onClose }: { onClose?: () => void }) {
       });
     }
     return list;
-  }, [scopedSkills, publisher, filter, isSquareTab, publishSquares?.default_square_id]);
+  }, [
+    scopedSkills,
+    publisher,
+    filter,
+    isSquareTab,
+    publishSquares?.default_square_id,
+    restrictWxTypes,
+  ]);
   const orderedSkills = useMemo(
     () =>
       filteredSkills
@@ -289,6 +339,30 @@ function SkillSettingsList({ onClose }: { onClose?: () => void }) {
   // If the active square tab disappears (admin removed that square), fall back
   // to "我的" so the page never points at a dead tab.
   useEffect(() => {
+    if (restrictWxTypes) {
+      if (
+        filter === WX_RESTRICTED_TAB_NANJING_DB &&
+        nanjingTabValue !== WX_RESTRICTED_TAB_NANJING_DB
+      ) {
+        setFilter(nanjingTabValue);
+        return;
+      }
+      if (
+        filter === WX_RESTRICTED_TAB_DEFAULT_SQUARE &&
+        defaultSquareTabValue !== WX_RESTRICTED_TAB_DEFAULT_SQUARE
+      ) {
+        setFilter(defaultSquareTabValue);
+        return;
+      }
+      if (
+        filter !== "mine" &&
+        filter !== defaultSquareTabValue &&
+        filter !== nanjingTabValue
+      ) {
+        setFilter("mine");
+      }
+      return;
+    }
     if (
       filter !== "mine" &&
       squareTabs.length > 0 &&
@@ -296,7 +370,7 @@ function SkillSettingsList({ onClose }: { onClose?: () => void }) {
     ) {
       setFilter("mine");
     }
-  }, [filter, squareTabs]);
+  }, [filter, squareTabs, restrictWxTypes, defaultSquareTabValue, nanjingTabValue]);
   const pagedSkills = useMemo(
     () => orderedSkills.slice((page - 1) * PAGE_SIZE, page * PAGE_SIZE),
     [orderedSkills, page],
@@ -347,7 +421,6 @@ function SkillSettingsList({ onClose }: { onClose?: () => void }) {
         theme === "dark" ? rescanErrorToastDarkOptions : undefined,
       );
     }
-      
   };
   return (
     <div className="flex w-full flex-col gap-4">
@@ -355,12 +428,22 @@ function SkillSettingsList({ onClose }: { onClose?: () => void }) {
         <div className="flex flex-wrap items-center gap-2">
           <Tabs value={filter} onValueChange={setFilter}>
             <TabsList variant="line" className="flex-wrap">
-              <TabsTrigger value="mine">{t.settings.skills.tabMine}</TabsTrigger>
+              {restrictWxTypes ? (
-              {squareTabs.map((sq) => (
+                <>
-                <TabsTrigger key={sq.id} value={sq.id} title={sq.description || sq.name}>
+                  <TabsTrigger value="mine">{t.settings.skills.tabMine}</TabsTrigger>
-                  {sq.name}
+                  <TabsTrigger value={defaultSquareTabValue}>默认广场</TabsTrigger>
-                </TabsTrigger>
+                  <TabsTrigger value={nanjingTabValue}>南京-db</TabsTrigger>
-              ))}
+                </>
+              ) : (
+                <>
+                  <TabsTrigger value="mine">{t.settings.skills.tabMine}</TabsTrigger>
+                  {squareTabs.map((sq) => (
+                    <TabsTrigger key={sq.id} value={sq.id} title={sq.description || sq.name}>
+                      {sq.name}
+                    </TabsTrigger>
+                  ))}
+                </>
+              )}
             </TabsList>
           </Tabs>
           <Button
@@ -472,11 +555,11 @@ function SkillSettingsList({ onClose }: { onClose?: () => void }) {
           </Button>
         </div>
       </header>
-      <TagSearchBar
+      <TagSearchBar
-        targetType="skill"
+        targetType="skill"
-        onSearchChange={setSearch}
+        onSearchChange={setSearch}
-        tagIds={tagIds}
+        tagIds={tagIds}
-        onTagIdsChange={setTagIds}
+        onTagIdsChange={setTagIds}
         actions={
           <div className="flex items-center gap-2">
             <ViewModeToggle value={viewMode} onChange={setViewMode} />
@@ -499,16 +582,16 @@ function SkillSettingsList({ onClose }: { onClose?: () => void }) {
                 <SelectItem value="name_desc">名称 Z-A</SelectItem>
               </SelectContent>
             </Select>
-          </div>
+          </div>
-        }
+        }
-      />
+      />
-      {!isLoading && !error && (
+      {!isLoading && !error && (
-        <div className="text-muted-foreground flex justify-end text-sm tabular-nums">
+        <div className="text-muted-foreground flex justify-end text-sm tabular-nums">
-          共 {orderedSkills.length} 个技能
+          共 {orderedSkills.length} 个技能
-        </div>
+        </div>
-      )}
+      )}
-      {publisher && (
+      {publisher && (
-        <div className="flex items-center gap-2">
+        <div className="flex items-center gap-2">
           <span className="text-muted-foreground text-xs">筛选发布者：</span>
           <button
             type="button"
@@ -540,9 +623,10 @@ function SkillSettingsList({ onClose }: { onClose?: () => void }) {
             <SkillRow
               key={skill.name}
               skill={skill}
-              currentUserId={currentUserId}
+              currentUserId={currentUserId}
-              isAdmin={isAdmin}
+              isAdmin={isAdmin}
-              layout={viewMode === "card" ? "card" : "row"}
+              availabilityControl="owner"
+              layout={viewMode === "card" ? "card" : "row"}
               onPublisherClick={setPublisher}
             />
           ))}
@@ -597,23 +681,26 @@ function SkillSettingsList({ onClose }: { onClose?: () => void }) {
 }
 
 export function SkillRow({
-  skill,
+  skill,
-  currentUserId,
+  currentUserId,
-  isAdmin,
+  isAdmin,
+  availabilityControl,
   layout = "row",
   onPublisherClick,
-  knowledgeBindings = [],
+  knowledgeBindings = [],
 }: {
   skill: Skill;
-  currentUserId: string | null;
+  currentUserId: string | null;
-  isAdmin: boolean;
+  isAdmin: boolean;
+  /** Which permission boundary exposes the global online/offline control. */
+  availabilityControl?: SkillAvailabilityControl;
   /** "row" = full-width horizontal item (default); "card" = grid card cell. */
   layout?: "row" | "card";
   /** Click the 发布者 line to filter the list to that publisher. Receives the
    * owner_user_id + its desensitized display label. */
   onPublisherClick?: (publisher: { id: string; label: string }) => void;
-  /** Admin list can inject its single batched binding query here (never N+1). */
+  /** Admin list can inject its single batched binding query here (never N+1). */
-  knowledgeBindings?: SkillKnowledgeBinding[];
+  knowledgeBindings?: SkillKnowledgeBinding[];
 }) {
   const isCard = layout === "card";
   const { t } = useI18n();
@@ -622,6 +709,7 @@ export function SkillRow({
   const setPinned = useSetSkillPinned();
   const setFeatured = useSetSkillFeatured();
   const setAlwaysOn = useSetSkillAlwaysOn();
+  const setEnabled = useEnableSkill();
   const { data: compression } = useSkillCompressionSettings();
   const deleteCustom = useDeleteCustomSkill();
   const deleteBuiltin = useDeleteBuiltinSkill();
@@ -632,6 +720,7 @@ export function SkillRow({
   const [duplicateOpen, setDuplicateOpen] = useState(false);
   const [duplicateName, setDuplicateName] = useState("");
   const [publishPickerOpen, setPublishPickerOpen] = useState(false);
+  const [confirmOfflineOpen, setConfirmOfflineOpen] = useState(false);
 
   const isCustom = skill.category === "custom";
   // Built-in flag falls back to "no DB owner" so legacy responses without
@@ -640,12 +729,33 @@ export function SkillRow({
   const isOwned =
     isCustom && !isBuiltin && !!skill.owner_user_id && skill.owner_user_id === currentUserId;
   const isFromOthers = isCustom && !isBuiltin && !isOwned;
-  // Admin can manage custom skills from any owner; non-admin only their own.
+  // Admin can manage custom skills from any owner; non-admin only their own.
-  const canManage = isCustom && (isOwned || isAdmin);
+  const canManage = isCustom && (isOwned || isAdmin);
-  const canDelete = isAdmin || isOwned;
+  const canDelete = isAdmin || isOwned;
   const canTogglePublish = canManage && !isBuiltin;
   // 常驻(免压缩):内置技能仅管理员可设;自定义技能其所有者或管理员可设(与后端一致)。
   const canSetAlwaysOn = isAdmin || isOwned;
+  const canToggleAvailability = canToggleSkillAvailability({
+    skill,
+    currentUserId,
+    isAdmin,
+    control: availabilityControl,
+  });
+  const isOffline = isSkillOffline(skill);
+
+  async function handleSetEnabled(enabled: boolean) {
+    try {
+      await setEnabled.mutateAsync({ skillName: skill.name, enabled });
+      toast.success(
+        enabled
+          ? t.settings.skills.onlineSuccess
+          : t.settings.skills.offlineSuccess,
+      );
+      setConfirmOfflineOpen(false);
+    } catch (err) {
+      toast.error(err instanceof Error ? err.message : String(err));
+    }
+  }
 
   async function handleToggleAlwaysOn(next: boolean) {
     try {
@@ -693,15 +803,15 @@ export function SkillRow({
     }
   }
 
-  async function handleDelete() {
+  async function handleDelete() {
-    try {
+    try {
-      if (isBuiltin) {
+      if (isBuiltin) {
-        await deleteBuiltin.mutateAsync(skill.name);
+        await deleteBuiltin.mutateAsync(skill.name);
-      } else {
+      } else {
-        await deleteCustom.mutateAsync(skill.name);
+        await deleteCustom.mutateAsync(skill.name);
-      }
+      }
-      toast.success(t.settings.skills.deleteSuccess);
+      toast.success(t.settings.skills.deleteSuccess);
-      setConfirmDeleteOpen(false);
+      setConfirmDeleteOpen(false);
     } catch (err) {
       toast.error(err instanceof Error ? err.message : String(err));
     }
@@ -876,6 +986,16 @@ export function SkillRow({
       {knowledgeBindings.length > 3 && (
         <Badge variant="secondary" className="text-xs">+{knowledgeBindings.length - 3}</Badge>
       )}
+      {isOffline && (
+        <Badge
+          variant="outline"
+          className="border-red-500/35 bg-red-500/5 text-red-700 dark:text-red-300 text-xs"
+          title={t.settings.skills.badgeOfflineTitle}
+        >
+          <PowerOff className="size-3" />
+          {t.settings.skills.badgeOffline}
+        </Badge>
+      )}
     </div>
   );
 
@@ -934,6 +1054,43 @@ export function SkillRow({
 
   const actionButtons = (
     <>
+      {canToggleAvailability && (
+        <Button
+          size="sm"
+          variant={isOffline ? "default" : "outline"}
+          className={cn(
+            "h-8 shrink-0 gap-1.5 px-2.5",
+            !isOffline && "text-destructive hover:text-destructive",
+          )}
+          disabled={
+            setEnabled.isPending ||
+            env.NEXT_PUBLIC_STATIC_WEBSITE_ONLY === "true"
+          }
+          onClick={() => {
+            if (isOffline) {
+              void handleSetEnabled(true);
+            } else {
+              setConfirmOfflineOpen(true);
+            }
+          }}
+          title={
+            isOffline
+              ? t.settings.skills.onlineAction
+              : t.settings.skills.offlineAction
+          }
+        >
+          {setEnabled.isPending ? (
+            <Loader2 className="size-3.5 animate-spin" />
+          ) : isOffline ? (
+            <Power className="size-3.5" />
+          ) : (
+            <PowerOff className="size-3.5" />
+          )}
+          {isOffline
+            ? t.settings.skills.onlineAction
+            : t.settings.skills.offlineAction}
+        </Button>
+      )}
       <Button
         size="icon"
         variant="ghost"
@@ -943,7 +1100,7 @@ export function SkillRow({
       >
         <TagsIcon className="size-3.5" />
       </Button>
-      {canManage && (
+      {canManage && (
         <Button
           size="icon"
           variant="ghost"
@@ -964,12 +1121,12 @@ export function SkillRow({
           />
         </Button>
       )}
-      {canManage && (
+      {canManage && (
-        <Button
+        <Button
-          size="icon"
+          size="icon"
-          variant="ghost"
+          variant="ghost"
-          className={cn(
+          className={cn(
-            "h-8 w-8 shrink-0",
+            "h-8 w-8 shrink-0",
             skill.pinned && "text-emerald-600 hover:text-emerald-700",
           )}
           disabled={setPinned.isPending}
@@ -1036,11 +1193,11 @@ export function SkillRow({
       >
         <CopyIcon className="size-3.5" />
       </Button>
-      {canDelete && (
+      {canDelete && (
-        <Button
+        <Button
-          size="icon"
+          size="icon"
-          variant="ghost"
+          variant="ghost"
-          className="text-destructive hover:text-destructive h-8 w-8 shrink-0"
+          className="text-destructive hover:text-destructive h-8 w-8 shrink-0"
           onClick={() => setConfirmDeleteOpen(true)}
           title={t.settings.skills.deleteAction}
         >
@@ -1053,7 +1210,12 @@ export function SkillRow({
   return (
     <>
       {isCard ? (
-        <div className="flex h-full min-w-0 flex-col rounded-lg border p-3 transition-shadow hover:shadow-sm dark:border-[#213D5E] dark:bg-[#02244C] dark:text-white">
+        <div
+          className={cn(
+            "flex h-full min-w-0 flex-col rounded-lg border p-3 transition-shadow hover:shadow-sm dark:border-[#213D5E] dark:bg-[#02244C] dark:text-white",
+            isOffline && "bg-muted/60 border-dashed dark:bg-[#071D36]",
+          )}
+        >
           <div
             className="min-w-0 flex-1 cursor-pointer"
             onClick={() => setDetailOpen(true)}
@@ -1069,7 +1231,13 @@ export function SkillRow({
           </div>
         </div>
       ) : (
-        <Item className="w-full dark:border-[#213D5E] dark:bg-[#02244C] dark:text-white" variant="outline">
+        <Item
+          className={cn(
+            "w-full dark:border-[#213D5E] dark:bg-[#02244C] dark:text-white",
+            isOffline && "bg-muted/60 border-dashed dark:bg-[#071D36]",
+          )}
+          variant="outline"
+        >
           <ItemContent
             className="cursor-pointer"
             onClick={() => setDetailOpen(true)}
@@ -1134,7 +1302,7 @@ export function SkillRow({
             <Button
               variant="outline"
               onClick={() => setConfirmDeleteOpen(false)}
-              disabled={deleteCustom.isPending || deleteBuiltin.isPending}
+              disabled={deleteCustom.isPending || deleteBuiltin.isPending}
             >
               {t.common.cancel}
             </Button>
@@ -1146,6 +1314,37 @@ export function SkillRow({
               {deleteCustom.isPending || deleteBuiltin.isPending
                 ? t.common.loading
                 : t.common.delete}
+            </Button>
+          </DialogFooter>
+        </DialogContent>
+      </Dialog>
+      <Dialog open={confirmOfflineOpen} onOpenChange={setConfirmOfflineOpen}>
+        <DialogContent>
+          <DialogHeader>
+            <DialogTitle>{t.settings.skills.offlineConfirmTitle}</DialogTitle>
+            <DialogDescription>
+              {t.settings.skills.offlineConfirmDescription.replace(
+                "{name}",
+                desensitize(skill.name),
+              )}
+            </DialogDescription>
+          </DialogHeader>
+          <DialogFooter>
+            <Button
+              variant="outline"
+              onClick={() => setConfirmOfflineOpen(false)}
+              disabled={setEnabled.isPending}
+            >
+              {t.common.cancel}
+            </Button>
+            <Button
+              variant="destructive"
+              onClick={() => void handleSetEnabled(false)}
+              disabled={setEnabled.isPending}
+            >
+              {setEnabled.isPending
+                ? t.common.loading
+                : t.settings.skills.offlineAction}
             </Button>
           </DialogFooter>
         </DialogContent>
@@ -1219,24 +1418,24 @@ function InstallSkillDialog({
   const validateMutation = useValidateSkillUpload();
   const installMutation = useInstallSkillUpload();
   const setNameZhMutation = useSetSkillNameZh();
-  const generateNameZhMutation = useGenerateSkillNameZh();
+  const generateNameZhMutation = useGenerateSkillNameZh();
-
+
-  const validateFile = useCallback(
+  const validateFile = useCallback(
-    async (selected: File, category: "custom" | "public") => {
+    async (selected: File, category: "custom" | "public") => {
-      setValidation(null);
+      setValidation(null);
-      setValidationError(null);
+      setValidationError(null);
-      try {
+      try {
-        const result = await validateMutation.mutateAsync({
+        const result = await validateMutation.mutateAsync({
-          file: selected,
+          file: selected,
-          targetCategory: category,
+          targetCategory: category,
-        });
+        });
-        setValidation(result);
+        setValidation(result);
-      } catch (err) {
+      } catch (err) {
-        setValidationError(err instanceof Error ? err.message : String(err));
+        setValidationError(err instanceof Error ? err.message : String(err));
-      }
+      }
-    },
+    },
-    [validateMutation],
+    [validateMutation],
-  );
+  );
 
   const reset = useCallback(() => {
     setFile(null);
@@ -1275,12 +1474,12 @@ function InstallSkillDialog({
       if (!lower.endsWith(".zip") && !lower.endsWith(".skill")) {
         toast.error(dialog.rejectInvalidExt);
         return;
-      }
+      }
-      setFile(selected);
+      setFile(selected);
-      await validateFile(selected, targetCategory);
+      await validateFile(selected, targetCategory);
-    },
+    },
-    [dialog.rejectInvalidExt, targetCategory, validateFile],
+    [dialog.rejectInvalidExt, targetCategory, validateFile],
-  );
+  );
 
   const onDrop = useCallback(
     (e: React.DragEvent<HTMLDivElement>) => {
@@ -1357,29 +1556,34 @@ function InstallSkillDialog({
     }
   }, [dialog.nameZhSaved, installedName, nameZhDraft, onClose, reset, setNameZhMutation]);
 
-  const isPublicConflict = validation?.conflict && validation.conflict_kind === "public";
+  const isPublicConflict = validation?.conflict && validation.conflict_kind === "public";
-  const isCustomConflict = validation?.conflict && validation.conflict_kind === "custom";
+  const isCustomConflict = validation?.conflict && validation.conflict_kind === "custom";
-  // Admin targeting public directory can overwrite an existing public skill.
+  // Admin targeting public directory can overwrite an existing public skill.
-  const adminCanOverwritePublic = isAdmin && targetCategory === "public" && !!isPublicConflict;
+  const adminCanOverwritePublic = isAdmin && targetCategory === "public" && !!isPublicConflict;
-  const canInstall = !!validation && !validationError && validation.can_install_as_is;
+  const canInstall = !!validation && !validationError && validation.can_install_as_is;
-  const canOverwrite = !!validation && !validationError && validation.can_overwrite;
+  const canOverwrite = !!validation && !validationError && validation.can_overwrite;
-  const ownCustomCanOverwrite = !!isCustomConflict && !!validation?.owned_by_me && canOverwrite;
+  const ownCustomCanOverwrite = !!isCustomConflict && !!validation?.owned_by_me && canOverwrite;
-  const otherCustomConflict = !!isCustomConflict && !!validation?.owned_by_other;
+  const otherCustomConflict = !!isCustomConflict && !!validation?.owned_by_other;
-  const customConflictMessage = !validation
+  // On-disk leftover with no ownership record: replaceable by whoever uploads it.
-    ? ""
+  const unclaimedCustomConflict =
-    : otherCustomConflict
+    !!isCustomConflict && !validation?.owned_by_me && !validation?.owned_by_other && canOverwrite;
-      ? dialog.conflictOwnedByOther
+  const customConflictMessage = !validation
-          .replace("{name}", validation.skill_name)
+    ? ""
-          .replace(
+    : otherCustomConflict
-            "{owner}",
+      ? dialog.conflictOwnedByOther
-            validation.owner_username ?? validation.owner_user_id ?? "—",
+          .replace("{name}", validation.skill_name)
-          )
+          .replace(
-      : validation.owned_by_me
+            "{owner}",
-        ? (ownCustomCanOverwrite
+            validation.owner_username ?? validation.owner_user_id ?? "—",
-            ? dialog.conflictOwnedByMe
+          )
-            : dialog.conflictOwnedByMeWrongTarget
+      : validation.owned_by_me
-          ).replace("{name}", validation.skill_name)
+        ? (ownCustomCanOverwrite
-        : dialog.conflictCustom.replace("{name}", validation.skill_name);
+            ? dialog.conflictOwnedByMe
+            : dialog.conflictOwnedByMeWrongTarget
+          ).replace("{name}", validation.skill_name)
+        : unclaimedCustomConflict
+          ? dialog.conflictUnclaimed.replace("{name}", validation.skill_name)
+        : dialog.conflictCustom.replace("{name}", validation.skill_name);
 
   return (
     <Dialog open={open} onOpenChange={(o) => !o && handleClose()}>
@@ -1489,6 +1693,16 @@ function InstallSkillDialog({
             />
           </div>
 
+          <div className="rounded-md border bg-muted/30 p-3">
+            <div className="text-sm font-medium">{dialog.exampleTitle}</div>
+            <p className="text-muted-foreground mt-1 text-xs">
+              {dialog.exampleHint}
+            </p>
+            <pre className="mt-2 overflow-x-auto rounded bg-background px-3 py-2 text-xs leading-5">
+              <code>{MINIMAL_SKILL_MD_EXAMPLE}</code>
+            </pre>
+          </div>
+
           {isAdmin && (
             <div className="flex items-center gap-3 text-sm">
               <span className="text-muted-foreground shrink-0">{dialog.targetCategoryLabel}</span>
@@ -1498,12 +1712,12 @@ function InstallSkillDialog({
                     <input
                       type="radio"
                       name="targetCategory"
-                      value={cat}
+                      value={cat}
-                      checked={targetCategory === cat}
+                      checked={targetCategory === cat}
-                      onChange={() => {
+                      onChange={() => {
-                        setTargetCategory(cat);
+                        setTargetCategory(cat);
-                        if (file) void validateFile(file, cat);
+                        if (file) void validateFile(file, cat);
-                      }}
+                      }}
                       className="accent-primary"
                     />
                     <span>{cat === "custom" ? dialog.categoryCustom : dialog.categoryPublic}</span>
@@ -1561,18 +1775,18 @@ function InstallSkillDialog({
                   </ul>
                 </Field>
               )}
-              {isCustomConflict && (
+              {isCustomConflict && (
-                <div
+                <div
-                  className={cn(
+                  className={cn(
-                    "mt-1 flex items-start gap-2 text-xs",
+                    "mt-1 flex items-start gap-2 text-xs",
-                    ownCustomCanOverwrite ? "text-amber-600" : "text-destructive",
+                    ownCustomCanOverwrite || unclaimedCustomConflict ? "text-amber-600" : "text-destructive",
-                  )}
+                  )}
-                >
+                >
-                  <AlertCircle className="mt-0.5 size-3.5 shrink-0" />
+                  <AlertCircle className="mt-0.5 size-3.5 shrink-0" />
-                  <span>
+                  <span>
-                    {desensitize(customConflictMessage)}
+                    {desensitize(customConflictMessage)}
-                  </span>
+                  </span>
-                </div>
+                </div>
               )}
               {isPublicConflict && (
                 <div className={cn("mt-1 flex items-start gap-2 text-xs", adminCanOverwritePublic ? "text-amber-600" : "text-destructive")}>

frontend-web/src/components/workspace/settings/upload-settings-page.tsx

@@ -0,0 +1,346 @@
+"use client";
+
+import {
+  Loader2Icon,
+  RotateCcwIcon,
+  SaveIcon,
+  UploadCloudIcon,
+} from "lucide-react";
+import { useEffect, useState } from "react";
+import { toast } from "sonner";
+
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import {
+  DEFAULT_UPLOAD_POLICY,
+  MEBIBYTE,
+  normalizeUploadExtension,
+  type UploadPolicy,
+  type UploadPolicyGroupKey,
+  useResetUploadPolicy,
+  useUpdateUploadPolicy,
+  useUploadPolicy,
+} from "@/core/uploads";
+
+type UploadPolicyDraft = {
+  maxFiles: string;
+  maxTotalMiB: string;
+  groups: Record<
+    UploadPolicyGroupKey,
+    { maxMiB: string; extensions: string }
+  >;
+  thresholdMiB: string;
+  maxResultChars: string;
+  hardMaxResultChars: string;
+};
+
+const GROUP_META: Array<{
+  key: UploadPolicyGroupKey;
+  label: string;
+  description: string;
+}> = [
+  { key: "document", label: "文档", description: "Word、PPT、TXT、PDF 等" },
+  { key: "image", label: "图片", description: "JPG、PNG 等" },
+  { key: "spreadsheet", label: "表格", description: "Excel 等" },
+];
+
+function toDraft(policy: UploadPolicy): UploadPolicyDraft {
+  return {
+    maxFiles: String(policy.max_files_per_message),
+    maxTotalMiB: String(policy.max_total_bytes / MEBIBYTE),
+    groups: {
+      document: {
+        maxMiB: String(policy.groups.document.max_bytes / MEBIBYTE),
+        extensions: policy.groups.document.extensions.join(", "),
+      },
+      image: {
+        maxMiB: String(policy.groups.image.max_bytes / MEBIBYTE),
+        extensions: policy.groups.image.extensions.join(", "),
+      },
+      spreadsheet: {
+        maxMiB: String(policy.groups.spreadsheet.max_bytes / MEBIBYTE),
+        extensions: policy.groups.spreadsheet.extensions.join(", "),
+      },
+    },
+    thresholdMiB: String(policy.large_file.threshold_bytes / MEBIBYTE),
+    maxResultChars: String(policy.large_file.max_result_chars),
+    hardMaxResultChars: String(policy.large_file.hard_max_result_chars),
+  };
+}
+
+function positiveNumber(value: string, label: string): number {
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed) || parsed <= 0) {
+    throw new Error(`${label}必须大于 0`);
+  }
+  return parsed;
+}
+
+function extensionsOf(value: string, label: string): string[] {
+  const extensions = Array.from(
+    new Set(
+      value
+        .split(/[，,\s]+/)
+        .map(normalizeUploadExtension)
+        .filter(Boolean),
+    ),
+  );
+  if (extensions.length === 0) throw new Error(`${label}至少填写一个扩展名`);
+  return extensions;
+}
+
+function fromDraft(draft: UploadPolicyDraft): UploadPolicy {
+  const maxResultChars = Math.floor(
+    positiveNumber(draft.maxResultChars, "常规输出上限"),
+  );
+  const hardMaxResultChars = Math.floor(
+    positiveNumber(draft.hardMaxResultChars, "硬输出上限"),
+  );
+  if (maxResultChars > hardMaxResultChars) {
+    throw new Error("常规输出上限不能大于硬输出上限");
+  }
+
+  const groups = {} as UploadPolicy["groups"];
+  for (const { key, label } of GROUP_META) {
+    groups[key] = {
+      max_bytes: Math.floor(
+        positiveNumber(draft.groups[key].maxMiB, `${label}单文件上限`) *
+          MEBIBYTE,
+      ),
+      extensions: extensionsOf(draft.groups[key].extensions, label),
+    };
+  }
+
+  return {
+    max_files_per_message: Math.floor(
+      positiveNumber(draft.maxFiles, "单条消息文件数"),
+    ),
+    max_total_bytes: Math.floor(
+      positiveNumber(draft.maxTotalMiB, "附件总大小") * MEBIBYTE,
+    ),
+    groups,
+    large_file: {
+      threshold_bytes: Math.floor(
+        positiveNumber(draft.thresholdMiB, "大文件阈值") * MEBIBYTE,
+      ),
+      max_result_chars: maxResultChars,
+      hard_max_result_chars: hardMaxResultChars,
+    },
+  };
+}
+
+export function UploadSettingsPage() {
+  const { data, isLoading } = useUploadPolicy();
+  const update = useUpdateUploadPolicy();
+  const reset = useResetUploadPolicy();
+  const [draft, setDraft] = useState<UploadPolicyDraft>(() =>
+    toDraft(DEFAULT_UPLOAD_POLICY),
+  );
+
+  useEffect(() => {
+    if (data) setDraft(toDraft(data));
+  }, [data]);
+
+  const setGroup = (
+    key: UploadPolicyGroupKey,
+    patch: Partial<UploadPolicyDraft["groups"][UploadPolicyGroupKey]>,
+  ) => {
+    setDraft((current) => ({
+      ...current,
+      groups: {
+        ...current.groups,
+        [key]: { ...current.groups[key], ...patch },
+      },
+    }));
+  };
+
+  const save = async () => {
+    try {
+      const saved = await update.mutateAsync(fromDraft(draft));
+      setDraft(toDraft(saved));
+      toast.success("上传设置已保存");
+    } catch (error) {
+      toast.error(error instanceof Error ? error.message : "保存上传设置失败");
+    }
+  };
+
+  const restoreDefaults = async () => {
+    if (!window.confirm("确定恢复系统默认上传策略吗？当前自定义设置会被覆盖。")) {
+      return;
+    }
+    try {
+      const saved = await reset.mutateAsync();
+      setDraft(toDraft(saved));
+      toast.success("已恢复默认上传设置");
+    } catch (error) {
+      toast.error(error instanceof Error ? error.message : "恢复默认上传设置失败");
+    }
+  };
+
+  return (
+    <section className="space-y-6">
+      <div className="space-y-1">
+        <h3 className="flex items-center gap-2 text-lg font-semibold">
+          <UploadCloudIcon className="size-5" />
+          上传设置
+        </h3>
+        <p className="text-muted-foreground text-sm">
+          控制聊天附件的数量、格式和大小，并限制大文件读取结果，防止文件内容一次性占满模型上下文。
+        </p>
+      </div>
+
+      <div className="grid gap-4 rounded-lg border p-4 sm:grid-cols-2">
+        <NumberField
+          id="upload-max-files"
+          label="单条消息最多文件数"
+          value={draft.maxFiles}
+          onChange={(maxFiles) => setDraft((value) => ({ ...value, maxFiles }))}
+          step="1"
+        />
+        <NumberField
+          id="upload-max-total"
+          label="单条消息附件总上限（MiB）"
+          value={draft.maxTotalMiB}
+          onChange={(maxTotalMiB) =>
+            setDraft((value) => ({ ...value, maxTotalMiB }))
+          }
+        />
+      </div>
+
+      <div className="space-y-3">
+        <h4 className="text-sm font-semibold">文件分组</h4>
+        {GROUP_META.map(({ key, label, description }) => (
+          <div
+            key={key}
+            className="grid gap-4 rounded-lg border p-4 sm:grid-cols-[180px_minmax(0,1fr)]"
+          >
+            <NumberField
+              id={`upload-${key}-size`}
+              label={`${label}单文件上限（MiB）`}
+              value={draft.groups[key].maxMiB}
+              onChange={(maxMiB) => setGroup(key, { maxMiB })}
+            />
+            <div className="space-y-2">
+              <label
+                className="text-sm font-medium"
+                htmlFor={`upload-${key}-extensions`}
+              >
+                {label}扩展名
+              </label>
+              <Input
+                id={`upload-${key}-extensions`}
+                value={draft.groups[key].extensions}
+                onChange={(event) =>
+                  setGroup(key, { extensions: event.currentTarget.value })
+                }
+                placeholder=".doc, .docx"
+              />
+              <p className="text-muted-foreground text-xs">
+                {description}；用逗号或空格分隔，保存时自动补全小数点。
+              </p>
+            </div>
+          </div>
+        ))}
+      </div>
+
+      <div className="space-y-3 rounded-lg border p-4">
+        <div>
+          <h4 className="text-sm font-semibold">大文件读取保护</h4>
+          <p className="text-muted-foreground mt-1 text-xs">
+            达到阈值后使用头部、中部、尾部采样；输出始终受字符预算约束，并在界面中标明截断或采样。
+          </p>
+        </div>
+        <div className="grid gap-4 sm:grid-cols-3">
+          <NumberField
+            id="upload-large-threshold"
+            label="大文件阈值（MiB）"
+            value={draft.thresholdMiB}
+            onChange={(thresholdMiB) =>
+              setDraft((value) => ({ ...value, thresholdMiB }))
+            }
+          />
+          <NumberField
+            id="upload-result-chars"
+            label="常规输出上限（字符）"
+            value={draft.maxResultChars}
+            onChange={(maxResultChars) =>
+              setDraft((value) => ({ ...value, maxResultChars }))
+            }
+            step="100"
+          />
+          <NumberField
+            id="upload-hard-result-chars"
+            label="硬输出上限（字符）"
+            value={draft.hardMaxResultChars}
+            onChange={(hardMaxResultChars) =>
+              setDraft((value) => ({ ...value, hardMaxResultChars }))
+            }
+            step="100"
+          />
+        </div>
+      </div>
+
+      <div className="flex items-center justify-end gap-2">
+        {isLoading && (
+          <span className="text-muted-foreground flex items-center gap-1 text-xs">
+            <Loader2Icon className="size-3.5 animate-spin" /> 正在读取配置
+          </span>
+        )}
+        <Button
+          type="button"
+          variant="outline"
+          onClick={() => void restoreDefaults()}
+          disabled={update.isPending || reset.isPending}
+        >
+          {reset.isPending ? (
+            <Loader2Icon className="size-4 animate-spin" />
+          ) : (
+            <RotateCcwIcon className="size-4" />
+          )}
+          恢复默认
+        </Button>
+        <Button
+          onClick={() => void save()}
+          disabled={update.isPending || reset.isPending}
+        >
+          {update.isPending ? (
+            <Loader2Icon className="size-4 animate-spin" />
+          ) : (
+            <SaveIcon className="size-4" />
+          )}
+          保存
+        </Button>
+      </div>
+    </section>
+  );
+}
+
+function NumberField({
+  id,
+  label,
+  value,
+  onChange,
+  step = "0.1",
+}: {
+  id: string;
+  label: string;
+  value: string;
+  onChange: (value: string) => void;
+  step?: string;
+}) {
+  return (
+    <div className="space-y-2">
+      <label className="text-sm font-medium" htmlFor={id}>
+        {label}
+      </label>
+      <Input
+        id={id}
+        type="number"
+        min="0.01"
+        step={step}
+        value={value}
+        onChange={(event) => onChange(event.currentTarget.value)}
+      />
+    </div>
+  );
+}

frontend-web/src/components/workspace/settings/write-file-compatibility-settings-page.tsx

@@ -0,0 +1,70 @@
+"use client";
+
+import { FileOutputIcon, Loader2Icon } from "lucide-react";
+import { toast } from "sonner";
+
+import { Switch } from "@/components/ui/switch";
+import {
+  useUpdateWriteFileCompatibilitySettings,
+  useWriteFileCompatibilitySettings,
+} from "@/core/system-settings/hooks";
+
+export function WriteFileCompatibilitySettingsPage() {
+  const { data, isLoading, isError } = useWriteFileCompatibilitySettings();
+  const update = useUpdateWriteFileCompatibilitySettings();
+  const enabled = data?.enabled ?? false;
+
+  const handleChange = async (checked: boolean) => {
+    try {
+      await update.mutateAsync({ enabled: checked });
+      toast.success(checked ? "文件流式兼容已开启" : "文件流式兼容已关闭");
+    } catch (error) {
+      toast.error(error instanceof Error ? error.message : "保存失败");
+    }
+  };
+
+  return (
+    <section className="space-y-6">
+      <div className="space-y-1">
+        <h3 className="flex items-center gap-2 text-lg font-semibold">
+          <FileOutputIcon className="size-5" />
+          文件流式兼容
+        </h3>
+        <p className="text-muted-foreground text-sm">
+          临时兼容会缓存长工具参数的内网模型网关。开启后，所有兼容模型仍调用原有
+          write_file 工具，但文件正文改由普通文本流生成，再投影为标准 write_file
+          流式事件。
+        </p>
+      </div>
+
+      <div className="flex items-center justify-between gap-6 rounded-lg border p-4">
+        <div className="space-y-1">
+          <div className="font-medium">所有模型启用兼容写入</div>
+          <p className="text-muted-foreground text-sm">
+            适用于当前配置的 OpenAI-compatible Chat Completions
+            模型。关闭后恢复各模型原有写入方式。
+          </p>
+        </div>
+        {isLoading ? (
+          <Loader2Icon className="text-muted-foreground size-5 animate-spin" />
+        ) : (
+          <Switch
+            checked={enabled}
+            disabled={isError || update.isPending}
+            onCheckedChange={handleChange}
+            aria-label="所有模型启用文件流式兼容"
+          />
+        )}
+      </div>
+
+      {isError && (
+        <p className="text-destructive text-sm">
+          无法读取文件流式兼容开关，系统将按关闭处理。
+        </p>
+      )}
+      <p className="text-muted-foreground text-xs">
+        保存后无需重启后台，从下一次发起的问答开始生效；正在生成中的回答不会中途切换。
+      </p>
+    </section>
+  );
+}