代码提交

Make ensure_participants concurrent-safe, restore clarification checkpoints without re-planning, and only create threads for validated seats.

Co-authored-by: Cursor <cursoragent@cursor.com>

.codex/skills/deerflow-ui-guard/SKILL.md

@@ -1,32 +0,0 @@
----
-name: deerflow-ui-guard
-description: Improve or review UI in the DeerFlow Vite/React frontend while preserving its light, dark-blue, and light-blue themes, Radix/shadcn-style primitives, Chinese enterprise density, embedded routes, and Chrome 109 compatibility. Use for visual refinements, new frontend pages/components, UI reviews, token cleanup, or design-system work under frontend-web/.
----
-
-# DeerFlow UI Guard
-
-Use this skill only in this repository. Preserve the product's existing visual system; do not replace it with a generic SaaS template or a new component library.
-
-## Read the relevant sources first
-
-1. Read `references/project-sources.md`, then the relevant theme specification.
-2. Inspect the page and the nearest existing components before proposing or changing UI.
-3. Read `frontend-web/src/styles/globals.css` and the affected primitives under `frontend-web/src/components/ui/` before changing tokens, shared styles, or variants.
-
-## Design and implementation rules
-
-- Reuse the existing Radix/shadcn-style primitives, `lucide-react`, Tailwind v4, and established CSS variables. Do not add Ant Design, another component system, or a visual-effects package unless the user explicitly asks.
-- Keep all three themes correct: light/red, dark/blue, and light-blue. Prefer semantic classes and existing variables over raw color values. When a new token is necessary, define matching values for every theme.
-- Preserve Chinese enterprise-product density and task completion speed. Make hierarchy, primary action, status, empty states, error recovery, and keyboard focus clearer before adding decoration.
-- Keep the shell, deep links, authentication, embed/isolation behavior, sidebar menu semantics, and responsive layout unchanged unless the request explicitly targets them.
-- Avoid unscoped global overrides and `!important`; place page-specific styling beside the feature and make selectors local.
-- Support the Chrome 109 constraint. Do not introduce unguarded `oklch()`, `oklab()`, `lab()`, `lch()`, or `color-mix()` values.
-- Preserve accessible names, keyboard interaction, visible `:focus-visible` states, sufficient contrast, and reduced-motion behavior for new or changed controls.
-
-## Delivery workflow
-
-1. State which existing theme and UI primitives the work will reuse.
-2. Make the smallest coherent change; do not perform an unrelated visual sweep.
-3. Validate with `pnpm typecheck`; when CSS or built UI changes, also run `pnpm build` and `pnpm check:chrome109-css` from `frontend-web/` when practical.
-4. If a browser is available, inspect screenshots in light, dark, and light-blue modes. Otherwise say that visual verification remains outstanding.
-5. For a review-only request, use `web-design-guidelines` as an additional quality gate when it is available, then distinguish confirmed issues from visual checks that still need a browser.

.codex/skills/deerflow-ui-guard/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "DeerFlow UI Guard"
-  short_description: "Apply DeerFlow themes and UI safety checks."
-  default_prompt: "Use $deerflow-ui-guard to improve this DeerFlow UI without breaking its themes or legacy-browser support."

.codex/skills/deerflow-ui-guard/references/project-sources.md

@@ -1,23 +0,0 @@
-# DeerFlow UI sources
-
-Read only the files relevant to the requested surface.
-
-## Canonical themes
-
-- Light/red: `frontend-web/docs/浅红色UI规范/README.md` and its focused section files.
-- Dark/blue: `frontend-web/docs/ui规范-深蓝/README.md` and its focused section files.
-- Light-blue: `frontend-web/docs/ui规范-浅蓝/浅蓝色ui规范.md`.
-- Runtime tokens and browser fallbacks: `frontend-web/src/styles/globals.css`.
-
-## Shared implementation
-
-- UI primitives: `frontend-web/src/components/ui/`.
-- Theme selection: `frontend-web/src/contexts/ThemeContext.tsx` and `frontend-web/src/App.tsx`.
-- Application shell and embed behavior: `frontend-web/src/pages/PageRoutes.tsx`.
-- Dynamic navigation: `frontend-web/src/core/page-layout/use-sidebar-menu.ts`.
-
-## Required constraints
-
-- Use `pnpm` in `frontend-web/`.
-- Retain Chrome 109 compatibility; validate CSS with `pnpm check:chrome109-css` after a build.
-- Do not move or replace public assets, route behavior, or authentication as part of a visual-only change.

.dockerignore

@@ -0,0 +1,35 @@
+# Never send source-control history, local dependencies, runtime state, or
+# credentials to the Docker daemon.  The offline images are built from the
+# repository root by deploy/1panel-offline/Dockerfile.*.
+.git
+.runtime
+.history
+tmp
+dist
+
+# Credentials and environment-specific configuration are supplied at runtime
+# through the offline delivery package, never copied into an image layer.
+**/.env
+**/.env.*
+offline-backend-20260512/backend/.deer-flow
+offline-backend-20260512/backend/logs
+offline-backend-20260512/backend/docker-data
+offline-backend-20260512/backend/dist
+offline-backend-20260512/backend/wheelhouse
+offline-backend-20260512/backend/offline-wheels
+offline-backend-20260512/backend/.venv
+offline-backend-20260512/backend/.pytest_cache
+offline-backend-20260512/backend/.ruff_cache
+
+# Reproducibly install frontend dependencies inside the image instead.
+frontend-web/node_modules
+frontend-web/dist
+frontend-web/.vite
+frontend-web/.offline-pack-build
+frontend-web/.offline-extract-test
+frontend-web/node_modules-offline-*.tar.gz
+
+# Editor and operating-system metadata.
+**/__pycache__
+**/*.py[cod]
+**/.DS_Store

.gitignore

@@ -77,16 +77,13 @@ offline-backend-20260512/backend/.deer-flow/*
 
 # Per-user skill_evolution overrides — runtime data written by the API
 offline-backend-20260512/backend/skill_evolution.json
-skills/
-# Keep the project-local Codex UI guard under version control. The broad
-# skills/ rule above still excludes runtime skill directories elsewhere.
-!.codex/
-!.codex/skills/
-!.codex/skills/deerflow-ui-guard/
-!.codex/skills/deerflow-ui-guard/**
-hermes-agent-main/
+skills/
+hermes-agent-main/
 .gitignore
 offline-backend-20260512/backend/tests/*
+# MAF roundtable tests must be tracked (excepted from the broad tests/* ignore above)
+!offline-backend-20260512/backend/tests/test_maf_*.py
+!offline-backend-20260512/backend/tests/maf_test_helpers.py
 deploy
 .history
 
@@ -96,12 +93,13 @@ git-clone/
 # Repo-root offline dependency pack (local only)
 /dist/
 
-# Frontend offline pack working directories
-frontend-web/.offline-pack-build/
-frontend-web/.offline-extract-test/
-
-.codegraph
-codegraph.mdc
+# Frontend offline pack working directories
+frontend-web/.offline-pack-build/
+frontend-web/.offline-extract-test/
+frontend-web-node_modules-offline-*.tar.gz
+
+.codegraph
+codegraph.mdc
 
 docs/aidev-docs
 docs/backups

.zcode/plans/plan-sess_dfc63a2a-7431-46c2-a4ba-63080d16e529.md

@@ -0,0 +1,122 @@
+# MAF 多智能体会商 Phase-4 前端实施计划
+
+## 决策回顾（已与用户确认）
+- **入口**：独立顶级菜单 `/page/maf/*`，新增侧边栏一级项「MAF 会商」
+- **实时更新**：纯前端轮询，`GET /runs/{id}/events?after_seq=N&limit=1000`，间隔 1.8s，复用现有后端，零 SSE、零后端改动
+- **流程图**：要。基于 `confirmed_facts`（来自 `run.maf_checkpoint.fact_ledger`）+ 末轮 `final_result.content` 解析的 `flow-json`，复用 `@xyflow/react` + `flow-graph.ts` + `FlowGraphPanel`
+- **审批**：卡片式，仿 `IntentClarificationCard` 的视觉/交互模式（参数摘要 + 批准/拒绝按钮 + 备注 textarea），落到 `POST /approvals/{id}/decision`
+
+## 关键数据契约（已核实后端源码）
+- **后端只读**：16 个端点全部命中，无改动。`GET /health` 返回 `enabled` 决定页面内容（入口仍可见，未启用时显示空态）。
+- **事件流**：单调 `(run_id, seq)`，`GET /events?after_seq=N` 返回 `{events:[...], latest_seq}`；前端推进 `after_seq=latest_seq`。payload 已在后端**写入时脱敏**（`sanitize_payload`），前端直接渲染。
+- **事件分类**（`event_normalizer.py`）：`run.started/completed/failed/cancelled`、`agent.turn_started/message.delta/message.completed`、`tool.requested/started/completed/failed`、`skill.started/completed/failed/selected`、`artifact.created`、`action.waiting_approval/approved/rejected`、`workflow.checkpointed`。
+- **事实账本**（`fact_ledger.empty_ledger`）：`candidate_facts`/`confirmed_facts`/`evidence`/`tool_results`/`executed_actions`/`pending_actions`/`failed_or_unknown_actions`/`conflicts`。`confirmed_facts` 条目含 `{candidate_id, text, agent_id, confirmed_by, evidence_refs[]}`。
+- **Run 字段**（`run_to_dict`）：`id, session_id, status, maf_checkpoint(含 fact_ledger + final_result + seat_outcomes), last_event_seq, started_at, finished_at, error_code, error_message_safe, token_usage, latency_ms`。
+- **终态判定**：`runIsLive(status) = ["pending","running","waiting_approval","cancelling","cancel_failed"].includes(status)`，非 live 即停轮询。
+- **Action/Approval**：`GET /runs/{id}/actions`、`GET /runs/{id}/approvals`；`POST /approvals/{id}/decision` `{decision:"approved"|"rejected"}`。
+
+## 复用清单（已定位到文件:行）
+- `apiFetch`（`core/api/fetch-client.ts`）：内部自动注入 `Authorization`（`getAuthorizationHeaderValue()`）+ `credentials:"include"`，**返回 Response 不解析、不拼 URL**。调用方拼 `${getBackendBaseURL()}/api/maf-roundtable/...`，自行 `res.ok` 检查 + `res.json()`。
+- `getBackendBaseURL`（`core/config/index.ts`）：未设时返回 `""`，相对路径同源可用。
+- TanStack Query 模式（`strategy-components/api/task-buttons.ts`）：`useQuery`+`refetchOnWindowFocus:false`；`useMutation`+`onSuccess invalidate`；queryKey 用嵌套数组 `["maf-roundtable", runId, "events"]`。
+- 轮询模式（`core/scheduled-tasks/hooks.ts:105-115`）：函数式 `refetchInterval: (query) => runIsLive(query.state.data?.status) ? ms : false`。
+- `FlowGraphPanel`（`roundtable-planning/components/FlowGraphPanel.tsx`）：props `{data: FlowGraphData, streaming, onClose, ...}`，自动 `useTheme()` 取明暗。`FlowGraphData = {title, nodes:[{id,label,type,detail?,group?}], edges:[{from,to,label?}]}`。`extractFlowGraph(text)`（`flow-graph.ts:263`）容错解析 ```flow-json``` 代码块（含半截 JSON）。
+- `IntentClarificationCard`（`roundtable-planning/components/IntentClarificationCard.tsx`）：卡片视觉模板（`rounded-xl border-red-100` + 「需要确认」徽标 + 选项按钮 + textarea + 提交）。
+- 时间线 feed（`roundtable-planning/components/Step1Panel.tsx` + `MessageBubble` + `useAutoScroll` + `ScrollToBottomButton`）：数组入、按 seq 序渲染。
+- `useDesensitizeSubtree`（`roundtable-planning/lib/use-desensitize-subtree.ts`）：仅挂 header/面板框架；时间线 body 不挂（payload 已脱敏 + hook 自身警告勿用于消息列表）。
+- 路由（`pages/PageRoutes.tsx:143-169`）：`<Route path="maf/*" element={<MafRoutes/>}/>`（仿 `RoundtableRoutes.tsx`）。
+- 菜单（`core/page-layout/sidebar-menu.ts`）：在 `sidebarMenuItems` 数组加一级项，`icon` 用 lucide 组件（非字符串 key）。新节点经 `use-sidebar-menu.ts` 自动走 static→inject→override→role→desensitize 流水线，无需额外注册。
+
+## 文件夹结构（镜像 `roundtable-planning/`，全新 `src/maf-roundtable/`）
+```
+frontend-web/src/maf-roundtable/
+├── api/
+│   ├── types.ts            # TS 类型（snake_case 直传，后端即 snake_case）
+│   ├── client.ts           # BASE()=getBackendBaseURL()+"/api/maf-roundtable"；apiFetch 封装 + readJson<T>/parseDetail
+│   ├── sessions.ts         # 会话 CRUD hooks（list/get/create/update/delete）
+│   ├── runs.ts             # run hooks（get/list/create/cancel/resume/recover）+ useMafHealth
+│   ├── events.ts           # listEvents(runId, afterSeq) 原始 fetch（供轮询 hook 用）
+│   └── approvals.ts        # 审批 hooks（list + decide mutation）
+├── hooks/
+│   ├── use-maf-run-status.ts   # GET /runs/{id} useQuery，函数式 refetchInterval 停终态
+│   └── use-maf-events.ts       # ★ cursor 轮询 hook（核心）
+├── lib/
+│   ├── event-timeline.ts       # 纯函数：events[] → TimelineEntry[]（delta 聚合、tool 生命周期折叠、approval 锚点）
+│   └── fact-flow-graph.ts      # 纯函数：confirmed_facts+evidence → FlowGraphData
+├── components/
+│   ├── MafRunHeader.tsx        # 状态徽标 + token/延迟 + 取消/恢复/重试
+│   ├── MafEventTimeline.tsx    # 时间线 feed（MessageBubble + useAutoScroll）
+│   ├── MafSeatStatusPanel.tsx  # 席位状态矩阵 + execution_stage 徽标
+│   ├── MafFactFlowPanel.tsx    # 包一层 FlowGraphPanel，数据来自 fact-flow-graph
+│   ├── MafApprovalCard.tsx     # 卡片式审批（批准/拒绝 + 备注）
+│   └── MafHealthGate.tsx       # health.enabled=false → 空态
+├── pages/
+│   ├── MafSessionsPage.tsx     # 会话列表 + 新建
+│   └── MafRunDetailPage.tsx    # 单 run 工作区（三栏）
+└── index.ts
+```
+
+## 核心：cursor 轮询 hook（`hooks/use-maf-events.ts`）
+不用纯 `useQuery+refetchInterval`：cursor `after_seq` 需每次推进，queryFn 不持有「上次 latest_seq」，塞 queryKey 会抖动。**用自定义 hook**（结合 scheduled-tasks 的 refetchInterval 思路 + roundtable-planning 的 reader-loop 家族）：
+```ts
+export function useMafEvents(runId?: string, active=false) {
+  const [events, setEvents] = useState<MafEvent[]>([]);
+  const afterSeqRef = useRef(0);                  // 避免 setInterval 闭包旧值
+  useEffect(() => {
+    if (!runId || !active) return;
+    let cancelled = false;
+    const poll = async () => {
+      const res = await listEvents(runId, afterSeqRef.current);
+      if (cancelled || !res.events.length) return;
+      setEvents(prev => mergeBySeq(prev, res.events));  // seq 去重
+      afterSeqRef.current = res.latest_seq;
+    };
+    poll();                                        // 进入即补拉（after_seq=0 全量历史）
+    const id = setInterval(poll, 1800);
+    return () => { cancelled = true; clearInterval(id); };
+  }, [runId, active]);
+  return events;
+}
+```
+- **补拉历史**：进入页面 `after_seq=0` 立即拉全部已落库事件 → 天然支持断线补拉/刷新恢复。
+- **终态停止**：`active` 由 `useMafRunStatus` 的 `runIsLive(status)` 传入，终态时 effect 清理 interval。
+- **去重**：后端 `(run_id,seq)` + `source_event_id` 双重去重，前端再按 `seq` 做 `mergeBySeq`，幂等。
+- **切换 run**：`runId` 变 → effect 重置（events 清空、afterSeq 归零）。
+
+## 流程图数据流（`lib/fact-flow-graph.ts`）
+两源按优先级合并 → `FlowGraphData`：
+1. **`confirmed_facts`（主）**：每条已确认事实 → `task` 节点（label=text 截断、detail=全文、group=confirmed_by）；`evidence_refs` 连到 `evidence`（→ `role`）或 `tool_results`（`tool:{name}:{turn}` → `deliverable`）节点；证据根用 `start`。
+2. **`final_result.content` 的 ```flow-json```（次）**：用现成 `extractFlowGraph(text)` 解析叠加为「结论流程图」。
+
+输出喂 `<FlowGraphPanel data={...} streaming={!terminal}/>`（非终态蚂蚁线动）。两源皆空 → 空态「尚无可绘制事实」。
+
+## 页面布局（`MafRunDetailPage`，三栏 / 窄屏堆叠）
+- **左：时间线**（`MafEventTimeline`）—— `event-timeline.ts` 折叠成可读条目（delta 聚合气泡、tool 折叠「调用 X→完成」、action.waiting_approval 插锚点），复用 MessageBubble + useAutoScroll + ScrollToBottomButton。
+- **中上：席位状态**（`MafSeatStatusPanel`）—— `maf_checkpoint.seat_outcomes` 的 agent × status 矩阵 + `execution_stage` 徽标。
+- **中下：事实/结论流程图**（`MafFactFlowPanel`）—— 折叠面板，默认展开。
+- **右：审批卡片**（`MafApprovalCard` 列表）—— 仅 pending 时显示；含工具名、参数摘要（脱敏）、批准/拒绝按钮 + 备注 textarea → `POST /approvals/{id}/decision`，成功后 invalidate `["maf-roundtable","approvals",runId]`，事件轮询自然看到 `action.approved/rejected`。
+
+## 路由 + 菜单接入（3 处）
+1. **新建** `pages/MafRoutes.tsx`（仿 `RoundtableRoutes.tsx`）：`index→MafSessionsPage`、`runs/:runId→MafRunDetailPage`、`*→重定向`。
+2. **改** `pages/PageRoutes.tsx`：加 `import MafRoutes` + `<Route path="maf/*" element={<MafRoutes/>}/>`（插 `notebook` 后）。
+3. **改** `core/page-layout/sidebar-menu.ts`：数组末尾加 `{ id:"maf-center", label:"MAF 会商", icon:Network, children:[{id:"maf-roundtable", label:"会商列表", icon:MessageSquareText, path:"/page/maf"}] }`。**不加 `adminOnly`**（全员可见；`/health.enabled=false` 由 `MafHealthGate` 客户端控制页面空态）。
+
+## 实施顺序
+1. `api/types.ts` + `api/client.ts`（地基）
+2. `api/{sessions,runs,events,approvals}.ts`（端点 hook）
+3. `hooks/{use-maf-run-status,use-maf-events}.ts`（轮询核心）
+4. `lib/{event-timeline,fact-flow-graph}.ts`（纯函数）
+5. `components/*`（6 个组件）
+6. `pages/*`（2 个页面）+ `index.ts`
+7. `pages/MafRoutes.tsx` + 接入 `PageRoutes.tsx` + `sidebar-menu.ts`
+8. `pnpm typecheck` + 手动核对路由/菜单显隐
+
+## 文件清单
+- **新建**（14）：`maf-roundtable/api/{types,client,sessions,runs,events,approvals}.ts`、`maf-roundtable/hooks/{use-maf-run-status,use-maf-events}.ts`、`maf-roundtable/lib/{event-timeline,fact-flow-graph}.ts`、`maf-roundtable/components/{MafRunHeader,MafEventTimeline,MafSeatStatusPanel,MafFactFlowPanel,MafApprovalCard,MafHealthGate}.tsx`、`maf-roundtable/pages/{MafSessionsPage,MafRunDetailPage}.tsx`、`maf-roundtable/index.ts`、`pages/MafRoutes.tsx`
+- **改动**（2）：`pages/PageRoutes.tsx`、`core/page-layout/sidebar-menu.ts`
+- **后端**：无改动
+
+## 验证
+- `pnpm typecheck`（tsc --noEmit）通过
+- 手动：菜单「MAF 会商」→ 列表 → 新建会话 → 启动 run → 时间线滚动 → 席位状态更新 → 流程图随 confirmed_facts 增长 → 审批可批准 → 终态停轮询
+- 退路：`/health.enabled=false` → 入口可见但页面显示未启用提示；旧 `roundtable-planning` 零改动

design-qa.md

@@ -1,48 +0,0 @@
-# Design QA — skills card list
-
-## Scope
-
-Only the skill-card list presentation was changed. The page header, summary cards, filters, top actions, sidebar, and existing interactions were left intact.
-
-## Visual evidence
-
-- Source visual truth: `C:\Users\admin\AppData\Local\Temp\codex-clipboard-8ca03817-ebd4-43e1-9d7c-2119e87d331c.png`
-- Implementation URL: `http://localhost:5173/#/page/workspace/skills`
-- Implementation capture: `F:\react01\deeflow-code\deerflow-server\skills-card-list-implementation.png`
-- Focused source/implementation comparison: `F:\react01\deeflow-code\deerflow-server\skills-card-list-comparison.png`
-- Viewport and state: Edge, desktop light theme, default list mode. The supplied reference contains three sample skills; the live implementation currently exposes one skill, so the comparison focuses on the first card row rather than fabricated data.
-
-## Findings
-
-No actionable P0, P1, or P2 visual issue remains within the requested list-card scope.
-
-- **Hierarchy and layout:** the card now begins with a large semantic skill icon, then groups name, existing status badges, description, and publisher before the existing tag, use-count, state, activity, and action areas. The five-column grid keeps the important skill identity visible while preserving the original live fields.
-- **Typography and spacing:** the title, description, metadata, and tags use the existing product type scale with a compact 12px card radius and consistent horizontal rhythm. The row remains responsive and collapses cleanly on narrower widths.
-- **Color and surfaces:** category icons use restrained solid blue/green/violet/amber surfaces, tags remain subdued, and enabled status uses a quiet green pill. Borders and hover surfaces follow the existing neutral card treatment; no gradients were introduced.
-- **Image and icon fidelity:** the source uses symbolic skill artwork. The implementation uses the closest existing Lucide workflow, globe, file, and upload icons in colored circular surfaces rather than adding screenshot-derived artwork or a new custom asset.
-- **Feature fidelity:** all pre-existing action controls, view modes, and list metadata stay visible. The reference's toggle was not copied as a fake interactive control because this page had no enable/disable mutation; its existing `enabled` data is shown as a read-only status pill instead.
-
-## Comparison history
-
-1. **[P1, fixed] The original live skill row had little identity or information hierarchy.**
-   - Earlier state: title, description, metadata, and the action cluster were visually detached, with no category icon or clear scanning order.
-   - Fix: rebuilt only the list/card row layout around existing data and handlers, added semantic colored icon surfaces, compact state/use/activity columns, and a unified action cluster.
-   - Evidence: `skills-card-list-comparison.png` contains the reference card row and the live implementation card row in one focused comparison.
-
-## Interaction and engineering checks
-
-- Edge interaction check: passed. The live row retains 7 existing action buttons; opening the details action displays its dialog.
-- View-mode behavior: passed. The existing list/card view control still switches to card mode (`aria-pressed=true`); the card view uses the same restyled visual language.
-- Browser runtime: two guest-bootstrap resource requests returned `401 Unauthorized` after reload. They are unrelated to the skill-card styling and did not prevent the list, details dialog, or view-mode control from working.
-- `pnpm build`: passed. The project still emits the pre-existing `/images/deer.svg` runtime-resolution warning.
-- `git diff --check`: passed; only existing line-ending notices were emitted for unrelated files.
-
-## Implementation checklist
-
-- [x] Skill-card list restyled without changing page chrome or filtering controls
-- [x] Existing skill actions, metadata, and view modes retained
-- [x] Live `enabled` data displayed without inventing a new mutation control
-- [x] Source and implementation reviewed in a single focused comparison image
-- [x] Edge interaction and production build verified
-
-final result: passed

frontend-web/.env.example

@@ -37,6 +37,10 @@
 # 默认真实接口（未设/false）；改成 true 时该接口走本地假数据（consumer 外网不可达时调试用）。
 # 与 VITE_USE_REAL_DATA 独立。改后需重启 dev / 重新打包生效。
 # VITE_MOCK_COP_TASK_DETAIL=false
+# VITE_POSITION_ROUNDTABLE_DEMO_MODE=false
+# true=免登录直达岗位分析，完全使用前端 JSON，不请求任何后台接口。
+# 仅限离线演示环境；生产环境请保持 false。
+# VITE_POSITION_ROUNDTABLE_STANDALONE_MODE=false
 
 # MaxKey 鉴权根地址（无界 onlineTicket 换 token）
 # VITE_AUTH_BASE_URL=https://auth.y.sit.4.cn
@@ -50,4 +54,6 @@
 # 可选
 # VITE_CANVAS_LANGGRAPH_BASE_URL=
 # VITE_STATIC_WEBSITE_ONLY=
+# 部署级紧凑导航：true 时固定收起工作台左侧栏，并隐藏换肤与全量/简洁模式切换。
+# VITE_FORCE_COLLAPSED_SIDEBAR=false
 # VITE_GITHUB_OAUTH_TOKEN=

frontend-web/design-qa.md

@@ -0,0 +1,46 @@
+**Comparison target**
+
+- Source visual truth (dark intelligent-agent list): `C:/Users/董宏凯/AppData/Local/Temp/codex-clipboard-75f6ce1c-cd70-4b8c-a80a-a3d100105c69.png`
+- Additional source references: `C:/Users/董宏凯/AppData/Local/Temp/codex-clipboard-00567484-ba8a-4595-b386-52e1467ae9cf.png` (segmented switch), `C:/Users/董宏凯/AppData/Local/Temp/codex-clipboard-02808803-05ba-4f2c-be50-c72b484a9f06.png` (business-chain node card), `C:/Users/董宏凯/AppData/Local/Temp/codex-clipboard-adf38fec-7baf-4d01-9c73-bdbae94b774e.png` (business-chain selector)
+- Implementation screenshots: `C:/Users/董宏凯/AppData/Local/Temp/position-roundtable-revised-light.png`, `C:/Users/董宏凯/AppData/Local/Temp/position-roundtable-revised-dark.png`
+- Full-view comparison evidence: `C:/Users/董宏凯/AppData/Local/Temp/position-roundtable-revised-comparison.png`
+- Viewport: 1280 × 720. Light route: `#/page/strategy/qa/position-roundtable`; dark embedded route: `#/page/strategy/qa/position-roundtable?embed=1&theme=dark`.
+- State: local browser has no authenticated API session. The original intent API is invoked and reports `Authentication required`; business-chain and agent endpoints return no usable data.
+
+**Findings**
+
+- [P1] Populated agent and business-chain states cannot be compared yet.
+  Location: right agent list and non-planning-role chain diagram.
+  Evidence: reference images show populated cards and nodes; the implementation has `0 个` agents and no available business chain in the unauthenticated preview.
+  Impact: card density, selected-card indicator, chain node flow, and agent-detail transition cannot be truthfully verified against live data.
+  Fix: verify the route in an authenticated session with at least one public chain and tagged agents.
+
+**Open Questions**
+
+- The final business-chain stage arrangement is still pending product confirmation. The compact graph maps whatever stage configuration is returned, while intentionally omitting dependency-label text as requested.
+
+**Implementation Checklist**
+
+1. Left task panel is now display-only and retains its independent position-roundtable task adapter.
+2. Business-chain selection uses the original roundtable card/radio/relationship-entry pattern.
+3. Every position uses the original `useStep1Intent` interface and `Step1Panel` message list/input panel; only the position header changes.
+4. The right switch now uses the exact `课题研究 / ai写作` segmented-control treatment (light gray track, white active state; dark blue glass equivalent).
+5. The embedded layout widens the left panel to 360px and applies the deep-blue right-panel tokens used by the reference.
+6. Other roles render a taller top-to-bottom card-node flow without dependency labels. The canvas supports mouse-drag panning, and each node retains only a name plus a single-line description.
+
+**Follow-up Polish**
+
+- [P3] If live content is unusually long, tune the compact flow node width or horizontal scrolling after seeing the production chain data.
+
+**Comparison history**
+
+- Iteration 1: task fields were editable and the right TDesign card tabs looked unlike the reference. Replaced the task form with display-only information and replaced the tabs with the existing `课题研究 / ai写作` segmented switch.
+- Iteration 2: business-chain selection was a dropdown and the flow was vertical avatar chips. Replaced it with original-roundtable selection cards and compact business-chain configuration-style node cards with link lines but no dependency labels.
+- Iteration 3: dark right-panel background differed from the supplied deep-blue reference. Applied the `#032650` / `#042b59` / `#2b8ffe` token family and captured the revised embedded dark state in the full-view comparison.
+- Iteration 4: removed the custom disabled input from non-planning positions and reused the original roundtable input panel. Enlarged the left flow viewport, retained its connection lines, and removed node level/seat/status metadata.
+- Iteration 5: converted the compact flow from left-to-right to top-to-bottom. Added mouse-drag panning and single-line description truncation; populated-chain visual QA remains blocked by the unauthenticated preview.
+- Iteration 6: constrained the flow canvas to its card viewport, narrowed nodes from 190px to 158px, and realigned branch gaps plus connector anchors to prevent clipping and offset lines.
+
+**Final result**
+
+blocked

frontend-web/docs/maf-r0-旧会商交互基线与组件映射.md

@@ -0,0 +1,198 @@
+# MAF-R0 阶段 0 交付文档：旧会商交互基线与组件映射
+
+> 状态：已完成
+> 更新时间：2026-08-03
+
+---
+
+## 1. 实验原型隐藏说明
+
+### 已完成的操作
+
+- `/page/maf/*` 路由（`MafSessionsPage` + `MafRunDetailPage`）已从正式菜单移除。
+- `workspace-nav-chat-list.tsx:199` 保留了墓碑注释：`{/* [MAF-R0] 实验原型已从正式菜单隐藏，仅保留路由供开发诊断：/page/maf */}`
+- `MafRoutes.tsx` 文件头部标注为 `[MAF-R0 实验原型 — 仅供开发诊断，已从正式菜单移除]`。
+- 该原型仅可通过手动输入 URL `/page/maf` 访问，不在任何侧边栏、导航菜单或工作区入口中出现。
+- 停止在该原型上新增业务功能。
+
+### 原型文件位置
+
+| 文件 | 用途 |
+|------|------|
+| `src/pages/MafRoutes.tsx` | 路由定义（index → MafSessionsPage, runs/:runId → MafRunDetailPage） |
+| `src/maf-roundtable/pages/MafSessionsPage.tsx` | 会话列表页（642 行） |
+| `src/maf-roundtable/pages/MafRunDetailPage.tsx` | 单 run 工作区（195 行） |
+| `src/maf-roundtable/` | 完整模块（33 文件：api/hooks/components/lib/tests） |
+| `vitest.maf.config.ts` | MAF 专用测试配置 |
+| `package.json` → `test:maf` | MAF 测试脚本 |
+
+---
+
+## 2. 旧会商 8 类页面状态交互地图
+
+旧会商入口：`src/roundtable-planning/pages/RoundtablePlanningPage.tsx`（4376 行，三步合一）。
+
+### 状态 1：空白 / 新建
+
+- 触发：点击「新建会商」或首次进入。
+- 表现：中心区域显示欢迎语 + 业务链选择入口 + 底部输入框。左侧历史列表为空或显示已有草稿。
+- 关键组件：`RoundtablePlanningPage`（currentStep=1 初始态）、`Step1Panel`（空消息列表 + 输入栏）。
+- 数据：`useDraftPersistence` 创建新草稿记录。
+
+### 状态 2：历史切换
+
+- 触发：点击左侧草稿列表中的某一条。
+- 表现：加载该草稿的 Step1/Step2/Step3 快照，恢复到对应步骤。
+- 关键组件：`useRoundtableDrafts`（列表）、`useDraftPersistence`（加载 + hydrate）。
+- 数据：`GET /api/roundtable-drafts/{id}` 或 `GET /api/roundtable-task-drafts/{id}`。
+
+### 状态 3：用户提问
+
+- 触发：用户在 Step1 输入框输入任务文本并点击发送。
+- 表现：用户气泡立即插入，随后出现 `MessageLoadingPlaceholder`（spinner + 跳动点），等待 SSE 首帧。
+- 关键组件：`Step1Panel`（输入栏 → 发送）、`MessageBubble`（用户气泡）、`MessageLoadingPlaceholder`。
+- 数据：`POST /api/intent/init` → `POST /api/intent/stream`（SSE）。
+
+### 状态 4：意图澄清
+
+- 触发：总控/意图智能体判断信息不足，返回 `ask_clarification` 帧。
+- 表现：对话流中嵌入 `IntentClarificationCard`（单选/多选 + 自定义输入），用户选择后提交。
+- 关键组件：`IntentClarificationCard`（选项卡）、`Step1Panel`（澄清提交逻辑）。
+- 数据：SSE 帧 `phase=clarification`，用户回答后继续 `POST /api/intent/stream`。
+
+### 状态 5：总控派活
+
+- 触发：Step1 完成（INTENT_READY）→ 进入 Step2 → 总控输出派活计划。
+- 表现：总控气泡显示派活计划（谁做什么），`ParallelSeatStrip` 显示参与席位头像条（running/done/error 徽章）。
+- 关键组件：`Step2Panel`（派活叙事）、`ParallelSeatStrip`（席位条）、`MessageBubble`（总控气泡）。
+- 数据：`POST /api/multi-agent/init`（SSE，建立 thread map）→ `POST /api/multi-agent/run/stream`。
+
+### 状态 6：席位发言
+
+- 触发：总控派活后，各席位按序/并行执行。
+- 表现：每个席位的气泡流式出现（`StreamingCursor` 闪烁尾标），工具调用显示为 `MessageStepsCard`（ChainOfThought 折叠卡）。
+- 关键组件：`MessageBubble`（席位气泡 + avatar）、`StreamingCursor`、`MessageStepsCard`（工具步骤）、`DialogueSpeedMeter`（tok/s）。
+- 数据：SSE delta 帧按 message id 合并。
+
+### 状态 7：审批
+
+- 触发：席位执行外部写操作，WriteGuard 拦截并请求审批。
+- 表现：对话流中嵌入审批卡（工具名 + 风险等级 + 摘要），用户点击批准/拒绝。
+- 关键组件：MAF 原型中为 `MafApprovalCard`；旧会商中审批通过 `roundtable-jobs` 的 clarify-resume 机制。
+- 数据：`POST /api/maf-roundtable/approvals/{id}/decision`（MAF）或 `POST /api/roundtable-jobs/{id}/clarify-resume`（旧）。
+
+### 状态 8：完成 / 失败恢复
+
+- 触发：所有席位完成 + 总控收束 → Step3；或 SSE 错误帧 / 网络断开。
+- 表现（完成）：Step3 显示最终报告（Markdown 总结 / HTML 看板 / 大屏），可追问。
+- 表现（失败）：错误提示 + 恢复按钮；后台任务可挂起/恢复。
+- 关键组件：`Step3Panel` → `HighFidelityReport`（Report/Dashboard/Summary/FileBrowse 模式）；失败时 `RoundtableJobNotifier`。
+- 数据：`useStep3Summary` / `useStep3Report` / `useStep3Dashboard`；失败恢复 via `POST /api/roundtable-jobs/{id}/resume`。
+
+---
+
+## 3. 旧组件 → 新 MAF view-model 映射表
+
+| 旧组件 / hook | 新 MAF 对应 | 映射说明 |
+|---|---|---|
+| `RoundtablePlanningPage`（三步壳） | `MafRoundtableConversationPage` | 不再有步骤切换；单一连续时间线。 |
+| `Step1Panel`（意图问答） | `ConversationTimeline` + `ClarificationCard` | 意图理解变为 `manager.intent` 事件卡。 |
+| `Step2Panel`（研讨对话流） | `ConversationTimeline` + `SeatMessageBubble` | 席位发言由 SSE `agent.message.*` 驱动。 |
+| `Step3Panel` / `HighFidelityReport` | `FinalResultCard` | 结论作为时间线中的结果卡。 |
+| `MessageBubble` | `SeatMessageBubble` / 总控气泡 | 重写为 MAF view model；不复用旧 props。 |
+| `MessageStepsCard` | `ToolProgressCard` | 工具过程由 `tool.started/progress/completed` 事件驱动。 |
+| `IntentClarificationCard` | `ClarificationCard` | 由 `clarification.required` 事件触发。 |
+| `ParallelSeatStrip` | `ParticipantStrip` | 状态改由 `manager.dispatch` + `seat.delivery.submitted` + `manager.review.decision` 驱动。 |
+| `useStep1Intent` | 删除 | 意图理解完全服务端化。 |
+| `useStep2Orchestration` | 删除 | 编排完全服务端化；前端只消费 SSE。 |
+| `useDraftPersistence` | `use-maf-conversations` | 历史改为 conversation 列表。 |
+| `useRoundtableDrafts` | `use-maf-conversations` | 同上。 |
+| `useStep3Summary/Report/Dashboard` | 删除 | 结论由服务端生成，前端只渲染结果卡。 |
+| `useAutoScroll` | 可复用（无业务依赖） | 纯 UI 滚动逻辑。 |
+| `useDialogueSpeedMetrics` | 可复用（无业务依赖） | 纯 UI 速度指标。 |
+| `MafApprovalCard`（原型） | `ApprovalMessageCard` | 重写为 conversation 时间线内卡片。 |
+| `MafEventTimeline`（原型） | 删除 | 不再暴露 run/event 管理后台。 |
+| `MafSeatStatusPanel`（原型） | `ParticipantStrip` | 合并到右侧席位条。 |
+
+---
+
+## 4. 禁止复用的旧业务 hook / API / 状态清单
+
+以下模块 **严禁** 被新 MAF conversation 页面直接 import 或调用：
+
+### 4.1 旧会商 API 客户端（`src/roundtable-planning/api/`）
+
+| 文件 | 禁止原因 |
+|------|----------|
+| `multi-agent.ts` | 调用 `/api/multi-agent/*`，包含前端 thread map 和编排逻辑 |
+| `intent.ts` | 调用 `/api/intent/*`，前端驱动意图流 |
+| `drafts.ts` | 调用 `/api/roundtable-drafts`，旧草稿状态 |
+| `task-drafts.ts` | 调用 `/api/roundtable-task-drafts`，旧任务草稿 |
+| `roundtable-jobs.ts` | 调用 `/api/roundtable-jobs`，旧后台任务 |
+| `chains.ts` | 调用 `/api/roundtable-chains`，旧业务链 CRUD |
+| `recommend.ts` | 调用 `/api/recommend/stream`，旧推荐流 |
+| `flow-extract.ts` | 调用 `/api/flow-extract/*`，旧流程图提取 |
+| `ingest.ts` | 调用 `/api/flow-extract/ingest-eligibility` |
+| `dashboard-sessions.ts` | 调用 `/api/dashboard-sessions` |
+| `diagnostics-report.ts` | 调用 `/api/roundtable-diagnostics/report` |
+
+### 4.2 旧会商业务 Hook（`src/roundtable-planning/hooks/`）
+
+| 文件 | 禁止原因 |
+|------|----------|
+| `useStep1Intent.ts` | 前端驱动意图状态机 |
+| `useStep2Orchestration.ts` | 前端编排循环（thread map、派活、轮次控制） |
+| `useDraftPersistence.ts` | 旧草稿持久化逻辑 |
+| `useRoundtableDrafts.ts` | 旧草稿列表 |
+| `useStep3Summary.ts` | 前端驱动总结生成 |
+| `useStep3Report.ts` | 前端驱动看板生成 |
+| `useStep3Dashboard.ts` | 前端驱动大屏生成 |
+
+### 4.3 旧会商业务状态类型
+
+- `Step1Snapshot`、`Step2Snapshot`、`Step2Dialogue`、`StubAiMessage`、`ParallelSeatView`
+- `ThreadIdMap`、`ClarificationPayload`、`LeaderDispatch`、`StreamPhase`
+- `DraftRecord`、`DraftMeta`、`DraftStep1Snapshot`、`DraftStep2Snapshot`、`DraftStep3Snapshot`
+- `RoundtableJob`、`JobStatus`、`DispatchChainNode`、`StartJobPayload`
+- `IntentSummary`、`IntentFileRef`、`IntentStreamPhase`
+
+### 4.4 MAF 原型中禁止继续扩展的模块
+
+| 文件 | 禁止原因 |
+|------|----------|
+| `src/maf-roundtable/pages/MafSessionsPage.tsx` | 实验原型，不作为产品主界面 |
+| `src/maf-roundtable/pages/MafRunDetailPage.tsx` | 实验原型，暴露 run/session 管理 |
+| `src/maf-roundtable/hooks/use-maf-events.ts` | 原型轮询 hook |
+| `src/maf-roundtable/api/sessions.ts` | 原型 session CRUD |
+| `src/maf-roundtable/api/runs.ts` | 原型 run 管理 |
+| `src/maf-roundtable/api/events.ts` | 原型事件轮询 |
+| `src/maf-roundtable/lib/session-form.ts` | 原型表单逻辑 |
+
+### 4.5 允许参考但必须重写的视觉组件
+
+以下组件的 **交互模式和信息架构** 可作为参考，但新 MAF 页面必须使用独立实现（MAF view model + tdesign-react），不得直接 import：
+
+- `MessageBubble.tsx`（气泡布局）
+- `MessageStepsCard.tsx`（工具步骤折叠）
+- `IntentClarificationCard.tsx`（澄清选项卡）
+- `ParallelSeatStrip.tsx`（席位头像条）
+- `ScrollToBottomButton.tsx`（回到底部按钮）
+- `Avatars.tsx`（头像 SVG）
+
+### 4.6 可安全复用的无业务依赖工具
+
+- `useAutoScroll.ts`（纯滚动逻辑）
+- `useDialogueSpeedMetrics.ts`（纯速度指标）
+- `src/lib/use-desensitize-subtree.ts`（DOM 脱敏，已标注多模块共享）
+- `markdown-components.tsx`（markdown 渲染配置，需确认无旧状态依赖）
+
+---
+
+## 5. 验收确认
+
+- [x] 旧会商 `RoundtablePlanningPage` 无代码行为变化（未修改任何 `src/roundtable-planning/` 文件）。
+- [x] `/page/maf/*` 原型已从菜单隐藏，仅保留路由供开发诊断。
+- [x] 8 类页面状态已记录，含触发条件、表现、关键组件和数据流。
+- [x] 旧组件到新 MAF view-model 的映射表已完成。
+- [x] 禁止复用的 hook/API/状态清单已明确。
+- [x] 任何人可根据本文档判断新版是否「像原页面」。

frontend-web/docs/microsoft-agent-framework-多智能体会商-实施计划.md

@@ -0,0 +1,645 @@
+# MAF 多智能体会商升级版实施计划（V2：保留原会商体验，替换底层编排）
+
+> 文档状态：**V2 重写，待按本计划重新实施**
+> 更新时间：2026-08-02
+> 本轮决策：原 `/page/maf/*` 的「会话列表 + run 详情 + 前端轮询」原型不再作为目标产品继续扩展。
+> 产品目标：新 MAF 会商是**原多智能体会商页面的底层升级版**，不是另造一套会商产品。
+
+---
+
+## 1. 本次重新确认的产品目标
+
+用户认可的是现有多智能体会商的视觉语言和交互链路：左侧历史会话、中心对话流、输入框发问、意图理解、总控派活、席位发言、过程卡片、澄清与审批、最终结论。
+
+本次升级只替换以下“看不见的发动机”：
+
+- 旧的前端驱动编排、多个前端可见线程和旧会商作业，替换为 MAF Workflow + DeerFlow Agent Adapter；
+- 浏览器定时轮询，替换为一条可恢复的 SSE 对话事件流；
+- 用户手动创建/管理多个智能体线程，收敛为服务端按需创建和持久化的内部执行线程；
+- 保留现有工具、技能、MCP、沙箱、WriteGuard、审批和审计能力，并让它们在原有会商体验中自然出现。
+
+**不能接受的结果：** 新页面没有对话列表、没有输入框、让用户先创建 session/run、需要用户选择或理解多个内部线程、靠多个定时 GET 拼出实时效果，或把审批/流程图做成脱离聊天主链路的独立后台页。
+
+### 1.1 必须保留的用户体验
+
+| 原会商能力 | 升级版要求 |
+|---|---|
+| 左侧会商历史、新建会商 | 保留。一个条目就是一个用户可见会商，不暴露 MAF session/run/thread。 |
+| 中央连续对话流 | 保留。用户消息、总控消息、席位发言、工具进度、澄清、审批、最终报告按时间顺序呈现。 |
+| 底部对话输入框 | 保留。用户可在首轮发起任务、在澄清时回答、在会商结束后追问/继续会商。 |
+| 意图理解 | 保留并服务端化。先识别“可直接会商 / 需要澄清 / 只回答问题 / 需要工具或写入”。 |
+| 总控智能体派活 | 保留。总控是唯一能选择席位、分派任务、收束轮次和生成结论的主体。 |
+| 业务链、席位与过程可视化 | 保留其信息架构和交互，不复用旧业务状态；数据改由 MAF 事件驱动。 |
+| 澄清、取消、恢复、审批 | 保留，并成为对话流中的卡片，而不是跳转到 run 管理页。 |
+
+### 1.2 明确不保留的实现方式
+
+- 不在浏览器端 `setInterval` 轮询 run、events、actions、approvals；
+- 不让浏览器创建或维护 seat thread、manager thread、thread map；
+- 不让用户先填写“经理、席位、模式、最大轮数”才能开始一次正常会商；
+- 不把 `MafSessionsPage` / `MafRunDetailPage` 当作新产品主界面继续堆功能；
+- 不调用旧的 `/api/roundtable-*`、`/api/multi-agent/*`、`roundtable_jobs`、旧草稿或旧会商状态；
+- 不修改旧 `RoundtablePlanningPage` 的业务状态机、历史数据和对外行为。
+
+---
+
+## 2. 总体架构与边界
+
+```mermaid
+flowchart LR
+  U[用户：会商对话页] -->|POST 新建/发送消息| API[MAF Conversation API]
+  API --> C[(MAF Conversation / Message)]
+  API --> D[MAF Dispatcher]
+  D --> W[MAF Workflow]
+  W --> M[总控：意图、派活、收束]
+  M --> S[服务端按需创建席位执行线程]
+  S --> A[DeerFlow Agent Adapter]
+  A --> T[工具 / 技能 / MCP / 沙箱]
+  T --> G[WriteGuard + 审批]
+  W --> E[(持久化会商事件)]
+  E --> H[SSE Hub：重放 + 实时推送]
+  H -->|一条 SSE 流| U
+```
+
+### 2.1 前后端职责
+
+| 层 | 职责 | 禁止事项 |
+|---|---|---|
+| 前端 | 呈现会商、发送用户消息、消费 SSE、执行用户明确点击的取消/审批/重试 | 编排席位、决定下一位发言者、创建内部线程、轮询事件。 |
+| MAF Conversation Service | 会话聚合、消息持久化、运行创建、SSE 重放、所有权校验 | 让浏览器传入 user_id、工具能力快照、目标键或内部幂等键。 |
+| MAF Workflow | 意图判断、总控派活、席位协作、交叉审查、结论、恢复 | 把模型输出直接当作可写外部系统的授权。 |
+| DeerFlow Adapter | 为总控/席位提供既有模型、工具、技能、MCP、沙箱和用户上下文 | 从 `packages/harness/deerflow/**` 导入 `app.*`。 |
+| WriteGuard | 风险识别、审批、目标租约、一次执行、审计 | 将密钥、target_key、idempotency_key 回传给浏览器或模型。 |
+
+### 2.2 新旧隔离规则
+
+1. 旧会商继续运行，旧路由、旧 API、旧数据表、旧任务深链全部不变。
+2. 新页面独立使用 `/api/maf-roundtable/*` 和 `maf_roundtable_*` 表；只允许参考旧页面的布局、文案、交互和通用视觉规范。
+3. 旧 `roundtable-planning/**` 中的业务 hook、草稿、Job、SSE 消费器和状态类型不能被新页面直接 import。
+4. 若需要复用旧组件的视觉效果，必须复制/迁移为 `maf-roundtable/legacy-compatible/**` 中的新组件，替换为 MAF view model；或抽到无业务依赖的公共展示组件。旧页面不得因此改变行为。
+5. 新旧页面都只能使用仓库本地依赖；UI 基础组件统一采用 **`tdesign-react`**，不接远程 UI、CDN 或外部运行时。
+
+---
+
+## 3. 用户可见的新版会商流程
+
+### 3.1 首次进入
+
+1. 用户点击独立菜单“MAF 会商（升级版）”，进入与旧会商相同层级的页面壳。
+2. 左侧显示自己的 MAF 会商历史和“新建会商”。新建只创建一个**用户可见会商**，不显示 session/run/thread 表单。
+3. 中心区域显示欢迎语、业务链/任务上下文入口和对话输入框。
+4. 用户输入任务后，前端立即插入本地的用户气泡，调用一次 `POST /messages`，然后消费同一会商的 SSE 流。
+
+### 3.2 一次会商轮次
+
+1. SSE 推送“正在理解任务”事件；页面以旧会商的过程卡/总控气泡表现。
+2. 若信息不足，推送 `clarification.required`，页面显示可回复的澄清卡；用户回答后仍通过输入框或卡片提交。
+3. 若可以执行，总控输出“派活计划”；页面以旧的席位条、派活卡和消息气泡展示。
+4. 每个席位的可见发言、工具进度、技能过程、交叉审查和总控收束都写入同一条时间线。
+5. 出现外部写操作时，SSE 推送审批卡。用户批准/拒绝后，后端恢复工作流，SSE 继续推送；前端不手工轮询 run 状态。
+6. 最终结论、事实账本、执行动作和报告作为对话流中的结果卡呈现；用户可以继续在同一会商输入追问。
+
+### 3.3 “一个会商”与内部线程的关系
+
+- 用户只认识 `conversation_id`；左侧历史、URL 和前端状态都以它为主键。
+- 一个 conversation 可以有多轮用户消息，每轮消息产生一个内部 `maf_run`。
+- `maf_session`、manager/seat thread、seat run 都是服务端内部执行身份。服务端使用既有 `ExecutionPrincipal` 绑定当前用户，并在真正需要某席位执行时懒创建/复用线程。
+- 浏览器只收到经过脱敏的消息和事件，不会收到内部 thread id、能力快照、目标键、幂等键、密钥或原始工具结果。
+
+### 3.4 总控质量闸门：派活不是“发出即完成”
+
+当前旧会商的问题不是没有派活，而是席位只说一两句话、格式和证据都不合格时，总控仍把它当作完成并直接进入下一步。新版 MAF 必须把总控从“消息转发者”升级为**每项席位交付的验收责任人**。
+
+每一个由总控发布的席位任务都必须有服务端持久化的 `task_contract`：
+
+| 字段 | 含义 |
+|---|---|
+| `objective` | 本席位要回答的具体问题，不能只写泛泛角色描述。 |
+| `expected_deliverable` | 交付类型和结构，例如“风险清单 + 依据 + 优先级 + 建议”。 |
+| `acceptance_criteria` | 由总控给出的可验收标准：覆盖范围、最少关键点、证据/工具依据、格式与约束。 |
+| `required` | 是否为本阶段必需交付；必需项不能被静默跳过。 |
+| `max_rework_attempts` | 同一席位最多返工次数，默认 **2**（初稿之外最多两次返工），服务端配置且写入快照。 |
+| `fallback_policy` | 到达返工上限后的策略：改派、请求用户澄清，或带缺口受控推进。 |
+
+#### 3.4.1 席位交付与总控验收状态机
+
+```mermaid
+stateDiagram-v2
+  [*] --> assigned
+  assigned --> delivering
+  delivering --> submitted
+  submitted --> manager_review
+  manager_review --> accepted: 达到合同标准
+  manager_review --> rework: 不合格且未到返工上限
+  rework --> delivering: 带明确退回意见
+  manager_review --> reassigned: 达到上限且可改派
+  reassigned --> delivering
+  manager_review --> exhausted: 达到上限且无合适改派
+  exhausted --> controlled_gap: 记录缺口、风险与原因
+  accepted --> [*]
+  controlled_gap --> [*]
+```
+
+验收规则如下：
+
+1. 席位先提交结构化 `delivery`，至少包含结论、依据/证据、未解决项、自检结果；不能只输出“已完成”或一两句空泛结论。
+2. 进入 `manager_review` 前先执行确定性检查：空内容、最小有效长度、必须章节、必填字段、所需证据/工具引用、重复文本、错误 schema。确定性不通过时不允许直接 accepted。
+3. 总控随后根据 `task_contract` 做结构化审查，决策只能是 `accept`、`return_for_rework`、`reassign`、`ask_user`、`controlled_gap`，并必须写明 `reason` 和针对性修改要求。
+4. **总控的模型自评不是验收证据。** 席位自评分只作为参考；验收由确定性规则 + 总控审查 + 必要时交叉审查共同决定。
+5. 对同一席位，默认最多两次返工。每次打回都必须把“缺什么、怎样补、哪些原结论不可用”带入下一次任务上下文。
+6. 到达上限后绝不把不合格结果伪装成合格：总控应优先改派给一个合适备用席位（默认最多一次改派）；仍无法满足时生成 `controlled_gap`，明确标记未覆盖问题、风险和对最终结论的影响，再受控进入下一阶段。
+7. 一个阶段的所有 `required` 任务必须处于 `accepted` 或 `controlled_gap` 等明确终态，阶段闸门才可通过。总控不能因为“轮数到了”或“已有部分回答”跳过未决必需项。
+8. 最终报告不得将 `controlled_gap` 的内容写成已验证事实；它必须在结论中的风险/待补信息部分可追溯显示。
+
+这既满足“打回几次后不要死循环”的要求，也避免“超过次数就把垃圾答案强行推进”的错误行为。
+
+#### 3.4.2 对话页必须可见的质量反馈
+
+- 总控派活卡展示任务目标、交付要求和当前第几次尝试；
+- 席位提交后显示“总控审核中”，而不是立即标为完成；
+- 打回时以总控消息卡显示具体退回理由和补充要求；
+- 改派时显示原席位未通过和新席位承接范围，但不羞辱性展示内部评分；
+- 受控降级时显示“存在未解决缺口”，并在最终结果卡中保留风险提示；
+- 右侧席位条区分“执行中、待返工、已验收、已改派、存在缺口”，不能只显示“发过言”。
+
+---
+
+## 4. API 与 SSE 契约（必须先定，前端不得猜测）
+
+### 4.1 Conversation API
+
+以下接口全部位于 `/api/maf-roundtable`，身份只从服务端鉴权上下文读取。
+
+| 接口 | 用途 | 前端调用时机 |
+|---|---|---|
+| `GET /conversations` | 左侧历史列表（分页） | 首次进入、用户显式刷新、创建/删除后失效刷新；**无定时轮询**。 |
+| `POST /conversations` | 创建空白用户会商 | 点击“新建会商”。只接收 title、任务上下文等安全字段。 |
+| `GET /conversations/{id}` | 获取会商快照、权限和当前状态 | 进入会商或浏览器刷新时。 |
+| `GET /conversations/{id}/messages` | 获取历史消息分页 | 进入会商、向上滚动加载历史。 |
+| `POST /conversations/{id}/messages` | 原子写入用户消息并启动 MAF run | 用户点击发送或提交澄清。返回 `message_id`、`run_id`、`conversation_id`。 |
+| `POST /conversations/{id}/cancel` | 取消当前活跃 run | 用户显式点击取消。 |
+| `POST /approvals/{id}/decision` | 批准/拒绝写入动作 | 审批卡点击；成功后由后端恢复 workflow。 |
+| `POST /conversations/{id}/recover` | 显式恢复异常中断的活跃会商 | 仅在后端判定可恢复时展示。 |
+
+不再让页面以“创建 session → 创建 run → GET events 循环”的方式驱动会商。原有低层 session/run 接口可以作为内部诊断 API 暂时保留，但从用户页面和导航移除。
+
+### 4.2 SSE：唯一的实时通道
+
+```text
+GET /api/maf-roundtable/conversations/{conversation_id}/stream?after_seq={last_seen_seq}
+Accept: text/event-stream
+Authorization: 与现有 fetch 客户端一致
+```
+
+- 前端在进入一个 conversation 后只建立**一条** fetch-reader SSE 连接；切换会商、卸载页面、权限失效时 Abort。
+- 浏览器不能用定时 GET 代替 SSE。连接断开后采用指数退避重连，并携带最后已确认的 `after_seq`；不产生全量重复气泡。
+- `after_seq` 是 conversation 维度、服务端单调递增的序号，不能复用每个 run 独立的 `seq`。
+- 首次连接先由 `GET messages` 加载历史，再从该历史的最大 `seq` 订阅 SSE；服务端也必须支持重放，避免“历史请求和订阅之间”丢事件。
+- SSE 使用 `fetch` + `ReadableStream` 解析，以复用项目鉴权头；响应必须带 `Content-Type: text/event-stream`、`Cache-Control: no-cache`、`X-Accel-Buffering: no`，并每 15 秒发送心跳。
+- 服务端负责等待和推送。单 worker 可用进程内 conversation event hub；生产多 worker 部署前必须接入 Redis Pub/Sub 或等价分布式广播，不能退回浏览器轮询。
+
+### 4.3 SSE 事件信封
+
+所有事件统一为：
+
+```json
+{
+  "seq": 42,
+  "event_id": "evt_...",
+  "conversation_id": "conv_...",
+  "run_id": "run_...",
+  "type": "agent.message.delta",
+  "occurred_at": "2026-08-02T12:00:00Z",
+  "data": {}
+}
+```
+
+允许的首批 `type`：
+
+| 类型 | 对话页表现 |
+|---|---|
+| `conversation.snapshot` | 首帧状态同步，不重复插入消息。 |
+| `user.message.created` | 刷新/多标签同步时补齐用户气泡。 |
+| `manager.intent` | 总控“正在理解/已理解”的过程卡。 |
+| `clarification.required` / `clarification.resolved` | 澄清卡及其回答状态。 |
+| `manager.dispatch` | 总控派活卡、席位条状态更新。 |
+| `seat.delivery.submitted` | 席位提交交付，进入总控审核而非直接完成。 |
+| `manager.review.decision` | 展示验收、打回、改派或受控降级及其安全摘要。 |
+| `seat.rework.assigned` / `seat.reassigned` | 更新第几次返工、原/新席位和新的任务要求。 |
+| `stage.quality_gate` | 阶段质量闸门通过、阻塞或带缺口推进。 |
+| `agent.message.start` / `delta` / `complete` | 席位或总控流式气泡。 |
+| `tool.started` / `tool.progress` / `tool.completed` | 现有步骤卡/工具过程，不显示敏感参数。 |
+| `approval.required` / `approval.decided` | 嵌入对话流的审批卡。 |
+| `fact.confirmed` / `review.completed` | 事实/交叉审查摘要卡。 |
+| `run.status` / `run.error` / `run.completed` | 顶部状态、失败重试与最终结果。 |
+
+事件 `data` 必须先经过现有 MAF 安全规范化和二次展示脱敏；前端不负责猜测工具风险或修复敏感数据。
+
+---
+
+## 5. 后端改造计划
+
+### MAF-R0：冻结错误原型并建立旧会商基线
+
+**难度：D2（中低）｜负责人：前端/测试各 1 人｜前置：无**
+
+- 将现有 `/page/maf/*` 标记为“实验原型”，从正式菜单移除；不得在其上继续新增业务功能。
+- 记录旧会商的页面状态：空会商、发送后、意图澄清、总控派活、席位流式发言、审批、完成、失败恢复、历史切换。
+- 为每种状态保存可复现的测试数据与截图基线；截图只作为视觉验收参考，不作为数据契约。
+- 输出旧组件到新 MAF view-model 的映射清单，禁止直接搬旧 hook。
+
+**验收：** 旧会商无行为回归；团队对“复制体验、替换编排”有书面映射表。
+
+### MAF-R1：Conversation 聚合与消息持久化
+
+**难度：D5（高）｜负责人：后端资深 1 人｜前置：R0**
+
+新增/迁移 MAF 专用持久化模型：
+
+- `maf_roundtable_conversations`：用户可见会商，至少包含 id、owner_user_id、title、task_context、安全状态、active_run_id、created_at、updated_at；
+- `maf_roundtable_messages`：用户消息、总控/席位消息、澄清/审批/结果卡的稳定历史表示；
+- `maf_roundtable_conversation_events`：conversation 维度严格递增的 `seq`、event_id、run_id、type、安全 data、created_at；
+- 现有 `maf_roundtable_sessions/runs/events/seat_runs/actions/approvals` 保留为底层执行与审计记录；conversation 与内部 session/run 显式关联。
+
+要求：
+
+1. 发送用户消息、创建/占用 run、写入首个用户消息事件必须在清晰的事务边界内完成；失败不留“消息已显示但未运行”的孤儿状态。
+2. 消息历史必须可在刷新后重建对话；不能只依赖内存或 SSE 临时帧。
+3. 所有读写继续 owner-only；管理员诊断只读不扩大写权限。
+4. 新迁移必须 SQLite/PostgreSQL/MySQL 可重复执行；旧 MAF 原型数据可保留，不强制伪造为新对话历史。
+
+**验收：** 会话创建、连续发消息、刷新恢复、并发发送冲突、跨用户隔离、迁移幂等都有 API 和存储测试。
+
+### MAF-R2：服务端 SSE Hub 与断线续传
+
+**难度：D5（高）｜负责人：后端流式/并发经验者 1 人｜前置：R1**
+
+- 新增 conversation stream 路由和 `ConversationEventHub`；Workflow/Dispatcher 的规范化事件落库后再发布，顺序是“先持久化、后通知”。
+- SSE 连接先按 `after_seq` 重放，再订阅实时事件；重放和订阅切换期间必须有序、不丢帧、不重复。
+- workflow 终态、审批等待、审批恢复、取消、失败重试都必须通过同一流通知。
+- 不允许每个 SSE 客户端创建数据库轮询循环。服务端可以阻塞等待 hub 通知，事件重放只在连接/重连时发生。
+- 写出单 worker 与多 worker 的实现边界；若部署配置多 worker，未接入分布式广播时健康检查必须明确告警并禁止该模式上线。
+
+**验收：** 测试覆盖慢客户端、断线重连、`after_seq` 重放、同时打开两个标签、切换会商、取消、审批后恢复、进程内 hub 异常和终态自动关流。
+
+### MAF-R3：总控意图理解与派活语义对齐
+
+**难度：D5（高）｜负责人：MAF/Agent 负责人 1 人｜前置：R1，可与 R2 并行**
+
+在现有 MAF Workflow 上增加用户对话入口状态，而不是让前端预先填 manager/seat/run：
+
+1. 总控首先进行意图判断：普通问答、需要澄清、单席位任务、并行专家会商、链式业务会商、需要工具/写入。
+2. 总控产出受 schema 校验的派活计划；只有服务端可将计划转成实际席位执行。
+3. 每个计划项必须生成并冻结 `task_contract`（目标、交付结构、验收标准、必需性、返工上限和降级策略），席位的发言不等于交付完成。
+4. 席位完成后先做确定性完整性检查，再由总控做结构化验收；总控可接受、打回同一席位、改派、请求用户补充或记录受控缺口。所有决策、次数和理由持久化到 checkpoint 与审计事件。
+5. 默认初稿后最多两次同席位返工；到达上限优先改派一次，仍失败才以带风险标记的 `controlled_gap` 结束。严禁自动把不合格交付推进为合格事实。
+6. 阶段迁移需经过质量闸门：所有必需任务均有 `accepted` 或受控缺口终态；最终总结只能消费已验收事实，缺口必须显式传入风险章节。
+7. 席位集合来自业务链、可信能力快照和上下文；前端可呈现“建议/已参与席位”，但不能提交任意工具权限或 thread id。
+8. 总控每轮应吸收已确认事实、验收结果、退回原因和用户追问；弱模型无效派活、重复派活、无收敛时走确定性纠偏/终止策略。
+9. 已有 structured/group_chat、事实账本、交叉审查、审批 checkpoint、执行阶段身份均继续复用；只重构其输入输出为 conversation event。
+
+**验收：** 用同一任务对照旧会商的意图澄清、总控派活、席位协作、打回/改派和收束结论；弱模型的短答、空答、错误 schema、缺证据、重复派活、非法席位、超轮次、返工上限和受控降级都有确定性保护测试。
+
+#### R3 当前实施记录（2026-08-03）
+
+后端已先完成 R3 的服务端核心骨架，作为 R1/R2 Conversation API/SSE 的后续：
+
+- `app/maf_roundtable/dispatch_contracts.py` 提供确定性意图分类、服务端业务路线解析、schema 校验的 `MafDispatchPlan` 和弱模型防护；请求、模型输出都不能提供 agent id、thread id、tool metadata 或能力快照。
+- `MafRoundtableConfig` 增加 `default_manager_agent_id`、`default_seat_agent_ids`、`business_routes` 和 `max_seats_per_run`。仓库配置保持空路线；上线前必须由部署配置填入实际 agent catalog 中的精确 id，未知业务路线失败关闭。
+- 首条消息在同一事务内创建内部 session、服务端选定的 manager/seat participants 和冻结能力快照；澄清意图进入 `waiting_input`，不创建 run，用户补充信息后才允许重新 claim。
+- Conversation service 已接入现有 `MafRunDispatcher`/`WorkflowRunner`，持久化 `manager.intent`、`manager.dispatch` 和 run 状态桥接事件；现有结构化工作流的席位集合仍只来自服务端 participants，manager 文本不能扩席或改派非法席位。
+- V2 `POST /conversations/{id}/messages` 只返回 `message_id`、`conversation_id`、`seq`；`run_id` 仍是持久层/服务端内部关联字段，不返回给浏览器。
+- 新增 `tests/test_maf_phase3_conversation_dispatch.py`，覆盖未知业务路线、默认路线、澄清、完成状态桥接、重复/越权派发计划等确定性用例。R3 尚未整体验收完成：仍需完成新页面、完整真实 MAF Workflow E2E、质量门禁和与旧会商体验的浏览器对照验收。
+
+### MAF-R4：将审批和外部写入嵌回对话主链路
+
+**难度：D4（较高）｜负责人：后端安全 + 前端各 1 人｜前置：R2、R3**
+
+- 保留 Phase 5 的 WriteGuard、能力快照、HMAC 目标键、租约、加密参数、一次执行和审计；不得为了 SSE 改弱任何安全边界。
+- `approval.required` 只携带白名单展示字段和安全摘要。审批决定后由后端自动续跑，前端只等待同一 SSE 流中的新事件。
+- 拒绝、过期、执行失败、unknown 均形成清晰对话卡和可恢复状态；不得把“未知结果”伪装成成功。
+- 行为审计可在最终结果区展开查看，但不能替代对话中的关键用户反馈。
+
+**验收：** HTTP → MAF → ToolNode/outbox → 审批 → SSE → 前端卡片 的端到端测试；确保 target_key、idempotency_key、internal_canary、密钥和原始工具结果从不进入消息/API/SSE。
+
+---
+
+## 6. 前端改造计划：复刻体验，替换状态源
+
+### MAF-R5：新会商页面壳与历史列表
+
+**难度：D4（较高）｜负责人：熟悉旧会商的前端 1 人｜前置：R0、R1**
+
+新建 `src/maf-roundtable/conversation/**`，建议结构：
+
+```text
+maf-roundtable/conversation/
+  pages/MafRoundtableConversationPage.tsx
+  components/
+    ConversationSidebar.tsx
+    ConversationTimeline.tsx
+    ConversationComposer.tsx
+    ManagerDispatchCard.tsx
+    SeatMessageBubble.tsx
+    ToolProgressCard.tsx
+    ClarificationCard.tsx
+    ApprovalMessageCard.tsx
+    FinalResultCard.tsx
+    ParticipantStrip.tsx
+  hooks/
+    use-maf-conversations.ts
+    use-maf-conversation-stream.ts
+    use-maf-conversation-reducer.ts
+  api/conversations.ts
+  lib/event-reducer.ts
+  styles/maf-roundtable-legacy-compatible.css
+```
+
+页面要求：
+
+- 左侧 `ConversationSidebar` 的层级、历史列表、新建、激活态、删除/重命名交互对齐旧会商；
+- 中间 `ConversationTimeline` 使用连续消息流，保留旧会商的用户气泡、总控气泡、席位气泡和时间锚点；
+- `ConversationComposer` 常驻底部；发送、停止、澄清回答、追问都在该入口完成；
+- 右侧仅保留旧体验中真正有用的参与席位、当前阶段和业务链摘要，不再摆放 run/session 管理后台；
+- 使用本地 `tdesign-react` 组件实现按钮、输入、Dialog、Tag、Tabs 等基础交互，同时通过 scoped CSS 对齐旧视觉；
+- 视觉相似不等于 import 旧业务组件。旧组件仅作参考，数据类型、hook 和 API 必须是 MAF 专用实现。
+
+**验收：** 不连接后端时，使用固定 MAF 事件样本可完整演示旧会商同等的 8 种关键状态；没有 session/run/thread 表单。
+
+### MAF-R6：SSE 客户端、事件 reducer 与刷新恢复
+
+**难度：D5（高）｜负责人：前端流式经验者 1 人｜前置：R2、R5**
+
+- `use-maf-conversation-stream` 只维护一个连接、一个 cursor、一个 AbortController；不得含 `setInterval`、`refetchInterval` 或轮询 fallback。
+- reducer 以 `(conversation_id, seq)` 去重并排序，将原始事件转为稳定 view model；流式 delta 必须按 `message_id` 合并，不能用数组下标。
+- 切换会商时先 abort 旧流并增加 generation；旧 SSE 帧永远不能污染新会商。
+- 刷新时先加载消息历史，再以最后 seq 订阅；网络断开显示“正在重连”，重连成功不重复气泡。
+- 只有历史列表等非实时资源可在用户主动操作后调用 GET；不能靠后台刷新伪装实时性。
+
+**验收：** 模拟 1 万条历史、跨页加载、慢旧流切换、新流先到、断线重连、重复帧、乱序帧、终态关流和多标签同步；所有案例必须组件级测试。
+
+### MAF-R7：意图/派活/审批卡的旧体验兼容
+
+**难度：D4（较高）｜负责人：前端业务负责人 1 人｜前置：R3、R4、R6**
+
+- 用旧 `IntentClarificationCard`、`MessageStepsCard`、`ParallelSeatStrip`、`MessageBubble` 的交互作为视觉和信息架构参照，重新实现 MAF 版本。
+- 总控派活计划必须先显示“将由谁做什么”，席位开始/结束、工具过程和交叉审查要回到原有对话叙事中。
+- 席位“发言结束”只能显示为“已提交，待总控审核”；只有收到 `manager.review.decision=accept` 才能显示“已验收”。打回次数、改派和缺口必须清楚可见。
+- 审批卡需要同步防双击锁、二次脱敏、拒绝/通过后的“等待工作流继续”状态；不可另外跳转到 action 审计页。
+- 最终结论卡要区分“建议动作”“审批中动作”“已执行动作”“失败/未知动作”。
+- 继续追问时，页面不新建多个用户可见线程；后端根据 conversation 上下文决定是否创建新 run 或继续恢复。
+
+**验收：** 产品人员可在不看技术术语的情况下完成“发起会商 → 澄清 → 观察派活 → 审批 → 查看结论 → 追问”全链路。
+
+---
+
+## 7. 测试、上线与回滚
+
+### 7.1 必须新增的自动化测试
+
+| 类别 | 核心用例 |
+|---|---|
+| 后端事务 | 发消息/创建 run 原子性、并发发送、跨用户隔离、迁移幂等。 |
+| SSE 服务端 | 重放、顺序、心跳、取消、断线、审批恢复、多订阅者、终态关流。 |
+| Workflow | 意图澄清、总控派活、弱模型格式错误、重复派活、最大轮次、恢复。 |
+| 质量闸门 | 短答/空答、缺少必填章节、无证据、总控打回、两次返工上限、一次改派、受控缺口、阶段阻塞和最终报告不把缺口伪装成事实。 |
+| 安全 | SSE/API/历史消息不泄露敏感键和值；审批和一次写入仍保持现有 Phase 5 保证。 |
+| 前端 reducer | delta 合并、去重、乱序、切换代次隔离、重连 cursor。 |
+| 前端组件 | 输入发送、澄清、派活、审批锁、取消、失败恢复、历史切换、无轮询断言。 |
+| E2E | 从用户输入到真实 MAF Workflow、ToolNode/outbox、审批、最终结果的 SSE 全链路。 |
+| 回归 | 旧 `roundtable-planning`、旧 DeerFlow、AI 写作以及既有 MAF Phase 1–5 用例全部通过。 |
+
+### 7.2 人工视觉验收
+
+在同一浏览器尺寸下对照旧会商，至少核对：
+
+1. 空白页和新建会商；
+2. 左侧历史/当前会商切换；
+3. 用户输入、流式总控消息、席位消息；
+4. 意图澄清和总控派活；
+5. 工具过程、审批、取消、失败恢复；
+6. 最终结论和连续追问；
+7. 窄屏滚动、长内容、断线重连和页面刷新。
+
+### 7.3 灰度与回滚
+
+- 新入口使用独立 feature flag，例如 `maf_roundtable.conversation_ui_enabled`；旧会商不受该开关影响。
+- 先仅向内部账号开放，记录连接数、重连率、事件延迟、工作流失败率、审批耗时和前端异常。
+- 出现问题时关闭新入口即可；不迁移或删除旧会商数据，也不需要回滚旧页面。
+- 当前错误原型可保留为仅开发者诊断路由，或在新版稳定后删除；它不应继续出现在用户菜单。
+
+---
+
+## 8. 分阶段任务分配、难度与交付顺序
+
+本节是分工的唯一依据。难度定义：D1=很低（局部文案/样式），D2=低（明确边界的小模块），D3=中（跨 2–3 个模块），D4=较高（跨前后端或需回归），D5=高（并发、状态机、安全或 Agent 行为，必须由有经验者负责）。
+
+### 阶段 0：冻结错误原型，提取旧会商交互基线（R0）
+
+**难度：D2｜建议人员：1 名熟悉旧会商的前端 + 1 名测试｜依赖：无**
+
+具体要做：
+
+1. 将现有 `/page/maf/*` 的 session/run 详情原型从正式菜单隐藏，标注为开发诊断原型，停止继续加功能。
+2. 逐一记录旧会商的 8 类页面状态：空白/新建、历史切换、用户提问、意图澄清、总控派活、席位发言、审批、完成/失败恢复。
+3. 给每种状态保留可复现 mock 数据、页面截图和操作步骤；梳理旧组件到新 MAF view-model 的映射。
+4. 明确哪些只能参考视觉和交互，哪些旧业务 hook/API/状态禁止复用。
+
+交付物：旧会商交互地图、截图基线、组件映射表、被隐藏的原型入口说明。
+
+验收：旧会商没有代码行为变化；任何人可以根据基线判断新版是否“像原页面”。
+
+### 阶段 1：建立用户可见 Conversation 与消息历史（R1）
+
+**难度：D5｜建议人员：1 名资深后端｜依赖：阶段 0**
+
+具体要做：
+
+1. 新增 `maf_roundtable_conversations`、`maf_roundtable_messages`、`maf_roundtable_conversation_events`，设计 owner、标题、消息、conversation 全局序号、活跃 run 和安全状态字段。
+2. 建立 conversation 与现有 MAF session/run/seat-run 的内部关联；用户只得到 conversation id，不能看到内部 thread id。
+3. 实现会商历史列表、创建空白会商、读取会商快照、读取消息分页、发送用户消息五类 API。
+4. 发送消息时，用户消息持久化、run 创建/占用和首个事件必须有明确事务边界；并发发送、重复请求、失败回滚都要处理。
+5. 完成 SQLite/PostgreSQL/MySQL 迁移与 owner-only 权限测试。
+
+交付物：迁移脚本、repository/service/router、API schema、后端事务与隔离测试。
+
+验收：刷新后能从消息历史恢复完整会商；跨用户不可读写；失败不会留下“已显示但没有实际运行”的孤儿消息。
+
+### 阶段 2：服务端 SSE 对话流、事件 Hub 与断线续传（R2）
+
+**难度：D5｜建议人员：1 名熟悉 FastAPI 异步流与并发的后端｜依赖：阶段 1**
+
+具体要做：
+
+1. 实现 `GET /conversations/{id}/stream?after_seq=`，按 conversation 全局 seq 先重放、后订阅实时事件。
+2. 新建 `ConversationEventHub`；所有 workflow 事件先安全落库，再按顺序广播。禁止 SSE 客户端通过定时查库等待更新。
+3. SSE 实现心跳、连接取消、权限校验、终态关流、异常帧和断线后的 cursor 续传。
+4. 明确多 worker 部署方案：单 worker 可进程内广播；多 worker 必须 Redis Pub/Sub 或等价方案，未满足时不能灰度上线。
+5. 把 run 状态、总控派活、席位消息 delta、工具过程、审批、质量审核、最终结论全部映射为统一事件信封。
+
+交付物：SSE router/hub、事件发布适配器、集成测试、部署说明。
+
+验收：慢连接、断线重连、乱序/重复防护、多标签订阅、审批后续跑、取消和终态均不丢事件；前端不需要轮询任何实时资源。
+
+### 阶段 3：总控意图理解、业务链选择与服务端派活（R3）
+
+**难度：D5｜建议人员：1 名 MAF/Agent 工程师｜依赖：阶段 1；可与阶段 2 并行**
+
+具体要做：
+
+1. 将旧会商的意图理解能力迁到 MAF 总控入口：识别直接问答、需澄清、单席位、并行会商、链式业务会商、工具/写入请求。
+2. 总控根据业务链、用户上下文、可信能力快照选择席位，生成 schema 校验的派活计划；前端只展示，不参与编排。
+3. Dispatcher 在服务端按需创建/复用 manager 和 seat 的内部执行线程，并由 `ExecutionPrincipal` 绑定当前用户。
+4. 对弱模型增加确定性保护：非法席位、空派活、重复派活、无效 schema、超轮次、无法收束必须被拒绝、纠偏或终止。
+5. 保持既有工具、技能、MCP、沙箱、事实账本、交叉审查和 checkpoint 恢复可用。
+
+交付物：总控状态 schema、workflow executor、派活事件、弱模型测试矩阵。
+
+验收：用户只输入任务，就能看到“意图理解 → 总控派活 → 席位执行”；浏览器没有 thread map 和派活决策代码。
+
+### 阶段 4：席位任务合同、总控验收、打回与强制收束（R3-Q）
+
+**难度：D5｜建议人员：1 名 Agent/MAF 工程师 + 1 名后端状态机工程师｜依赖：阶段 3**
+
+具体要做：
+
+1. 总控发布任务时冻结 `task_contract`：具体目标、交付格式、验收标准、必需性、返工次数、改派与降级策略。
+2. 为每项席位任务持久化状态机：`assigned → delivering → submitted → manager_review → accepted/rework/reassigned/controlled_gap`。
+3. 席位提交后先做确定性质量检查：空答、过短、必填章节缺失、格式错、无证据、重复内容等均不能自动完成。
+4. 总控必须生成结构化验收决定和原因；不合格时打回并带精确补充要求。默认最多两次同席位返工，之后最多一次改派。
+5. 改派仍失败时只能产生 `controlled_gap`，标记风险、缺失项和最终报告影响；严禁伪装为成功。
+6. 增加阶段质量闸门：所有必需任务处于 `accepted` 或 `controlled_gap`，才允许进入交叉审查/下一阶段/最终总结。
+7. 将尝试次数、退回理由、验收结果和缺口写入 checkpoint、审计和 SSE。
+
+交付物：任务合同模型、持久化表/迁移、质量状态机、总控审查 prompt/schema、事件和测试。
+
+验收：席位只说一两句话、无依据或内容垃圾时会被明确打回；达到上限不会死循环，也不会被当作合格产出；最终报告可追溯所有缺口。
+
+### 阶段 5：审批、WriteGuard 与外部动作嵌入对话流（R4）
+
+**难度：D4｜建议人员：1 名安全后端 + 1 名前端｜依赖：阶段 2、3、4**
+
+具体要做：
+
+1. 保留现有 Phase 5 的可信能力快照、WriteGuard、目标租约、HMAC、加密参数、一次执行与审计，不允许为新页面降低安全性。
+2. 将工具开始、审批请求、批准/拒绝、执行成功/失败/unknown 变成安全 SSE 事件和对话卡。
+3. 审批点击只调用明确决策 API；后端负责恢复 checkpoint/workflow，浏览器只等待 SSE。
+4. 安全展示统一二次脱敏，禁止 target_key、idempotency_key、internal_canary、密钥、凭据和原始工具结果进入 API、消息、SSE 或 DOM。
+
+交付物：事件映射、审批消息卡契约、端到端 ToolNode/outbox 测试。
+
+验收：一次真实测试写入能在对话里经历“申请 → 审批 → 继续 → 结果”；重复点击或断线都不会重复外部写入。
+
+### 阶段 6：复刻旧会商页面壳、历史列表和输入框（R5）
+
+**难度：D4｜建议人员：1 名熟悉旧会商代码的前端｜依赖：阶段 0、1**
+
+具体要做：
+
+1. 新建 MAF 专用 conversation 页面、路由和独立 feature flag；不修改旧 `RoundtablePlanningPage`。
+2. 依据阶段 0 的映射，复刻左侧历史会话、新建会商、中心时间线、常驻输入框、参与席位区和业务链摘要的视觉与交互层级。
+3. 基础组件使用本地 `tdesign-react`，旧页面仅参考；需要的视觉组件在 MAF 目录重写或抽无业务依赖公共组件。
+4. 接上 Conversation API：创建、历史、切换、消息分页。此阶段不允许先做任何轮询实时逻辑。
+5. 删除新页面中暴露给用户的 manager/seat/max round/session/run 创建表单。
+
+交付物：新页面壳、MAF 专用 view model、静态/接口 mock 组件测试、视觉对照截图。
+
+验收：即使 SSE 未接通，用户也能看到与旧会商同类的历史、对话与输入体验；新旧业务状态零耦合。
+
+### 阶段 7：前端 SSE 消费、对话 reducer 与过程交互（R6 + R7）
+
+**难度：D5｜建议人员：1 名前端流式工程师 + 1 名前端业务工程师｜依赖：阶段 2、4、5、6**
+
+具体要做：
+
+1. 实现单连接 `use-maf-conversation-stream`：fetch-reader SSE、cursor、AbortController、指数退避重连和会商切换 generation 隔离。
+2. 实现 event reducer：按 `conversation_id + seq` 去重排序；按 message_id 合并 delta；刷新后历史与 SSE 无缝衔接。
+3. 重写旧会商对应的 MAF 版组件：总控意图卡、派活卡、席位条、席位气泡、工具步骤、澄清卡、审批卡、质量审核/打回卡、结果卡。
+4. 所有卡片在时间线内叙事，不另开 run/session 管理后台；继续追问仍使用同一输入框。
+5. 页面必须显示待审核、已验收、返工次数、改派、受控缺口和恢复状态，不能把“发过言”显示为“已完成”。
+6. 代码审查和测试中检查不存在 `setInterval`、`refetchInterval` 或事件轮询 fallback。
+
+交付物：SSE hook、reducer、对话组件、组件/API mock 测试、无轮询静态检查。
+
+验收：切换会商、断线重连、审批续跑、慢旧流回包、长会话翻页均不污染、不丢消息、不重复；整个会商过程只依赖 SSE 实时更新。
+
+### 阶段 8：端到端验收、灰度和回滚演练（R8）
+
+**难度：D4｜建议人员：1 名测试/集成人 + 各阶段负责人配合｜依赖：阶段 1–7**
+
+具体要做：
+
+1. 跑完后端事务/SSE/Workflow/质量闸门/WriteGuard 测试、前端 reducer/组件测试、旧会商与 DeerFlow 回归。
+2. 在真实浏览器按阶段 0 截图基线逐项对照，并完成用户任务：发起、澄清、派活、短答打回、两次返工、改派、审批、受控缺口、结论和追问。
+3. 内部账号灰度，观测 SSE 建连/重连、事件时延、派活/验收/返工次数、workflow 失败率、审批耗时和前端错误。
+4. 验证关闭 feature flag 后立即回到旧会商入口，旧数据和旧任务不受影响。
+5. 若需生产外部写入，补齐 UAT 系统、最小权限凭据、核验 API、补偿联系人和生产 `MAF_ACTION_SECRET_KEY`。
+
+交付物：自动化结果、人工验收记录、灰度指标面板、回滚演练记录、上线清单。
+
+验收：满足第 9 节全部条件后才允许标记开发完成。
+
+### 8.1 可并行边界
+
+- 阶段 2 与阶段 3 可在阶段 1 的 schema/API 定稿后并行，但二者必须共用同一事件信封。
+- 阶段 6 可在阶段 1 的 API mock 契约定稿后提前开始；不得自行发明事件字段。
+- 阶段 5 必须等待阶段 2、3、4 的安全事件与状态机定稿。
+- 阶段 7 必须等待阶段 2、4、6，不能以轮询临时替代 SSE。
+- 阶段 8 只做集成、验收和上线准备，不补写前面阶段缺失的核心设计。
+
+建议主顺序：`阶段 0 → 阶段 1 → (阶段 2 + 阶段 3 + 阶段 6) → 阶段 4 → 阶段 5 → 阶段 7 → 阶段 8`。
+
+---
+
+## 9. 最终验收定义
+
+只有同时满足以下条件，才可以说“本次 MAF 会商升级开发完成”：
+
+- 新页面在视觉和主交互上可被用户认作原多智能体会商的升级版；
+- 页面具备历史会话、连续对话流、输入框、意图理解、总控派活、席位协作、澄清、审批、结果和追问；
+- 每个必需席位任务都有任务合同、总控验收、有限返工和改派/受控缺口处理；席位短答或垃圾产出不能自动被当作完成；
+- 浏览器没有会商事件/run/approval 的定时轮询；实时交互通过可重连 SSE 完成；
+- 用户不需要创建或管理多个智能体线程，内部线程由服务端按用户身份安全创建和恢复；
+- 新页面未调用旧会商业务 API/状态，旧会商零回归；
+- 工具、技能、MCP、沙箱、审批、WriteGuard、一次写入和审计都仍可用；
+- 自动化测试、SSE 故障测试、真实浏览器人工验收和旧功能回归全部通过；
+- 真实 UAT 写入系统、最小权限凭据、外部核验 API、补偿协议及生产 `MAF_ACTION_SECRET_KEY` 已按 Phase 5 前置条件完成。
+
+在这之前，任何“会话/run 原型页面通过构建或轮询测试”的结果，都只能算技术验证，不算产品升级验收。
+
+---
+
+## 阶段 3 实施记录（当前代码基线）
+
+本轮已补齐阶段 3 的服务端安全路由与真实 MAF Workflow 入口，范围仅针对新 MAF 会商；旧 DeerFlow、旧 roundtable 和 AI 写作行为不变。
+
+### 配置与入口闸门
+
+- 仓库默认 `maf_roundtable.enabled: false`。部署环境必须注入真实的 `default_manager_agent_id`、席位 ID 和业务路由后再开启，避免出现“入口显示正常但首条消息必然 503”的空配置。
+- 健康接口返回非敏感的 `conversation_dispatch_ready` 与 `conversation_dispatch_status`；新会商入口只有在配置路由可用且服务已启用时才开放。
+- 首条消息使用服务端可信能力快照校验 manager/seat 的可访问性；浏览器、会话请求和模型输出都不能提供或扩大 agent、thread、tool、capability 范围。
+- 配置模型会清理并校验 manager/seat ID，拒绝 manager 出现在 seat 列表、重复席位、超过 `max_seats_per_run` 的路由和非法业务 code。
+
+### 受约束的总控派活
+
+服务端先由业务链与可信 capability snapshot 生成候选席位集合。总控模型只能返回严格 JSON：`intent_type`、`selected_seat_agent_ids`、每席 `task_goal`/`delivery_requirements`、`execution_mode`、`convergence_path` 和 `reason`。Pydantic schema、服务端 allowlist 和顺序校验全部通过后，最终计划才会写入 checkpoint，并产生 `manager.dispatch` 审计/SSE 投影。
+
+非法席位、重复席位、空任务、错误 schema、席位超限、缺少收敛路径或链式顺序错误，统一回退到服务端安全计划，不会扩大权限或启动越权席位。
+
+四种结构化拓扑已固定为：
+
+- `direct_answer`：manager-only Workflow，不创建专家席位任务；
+- `single_seat` / `tool_write`：一个可信席位；
+- `parallel_consultation`：至少两个可信席位并行；
+- `chain_consultation`：按服务端业务链顺序串行。
+
+### 阶段 3 验证状态
+
+已覆盖配置校验、候选路由、非法总控计划回退、manager-only 真实 `WorkflowBuilder` 拓扑、线程/执行阶段回归、旧 DeerFlow 回归和会话 API 回归。当前仍不能据此标记整个 MAF 项目或阶段 5 为“验收完成”；真实 UAT 写入系统、最小权限凭据、外部核验 API、补偿协议和生产 `MAF_ACTION_SECRET_KEY` 仍按阶段 5/8 前置条件保持阻塞。
+
+### Stage 3 P0 dispatch correction
+
+- New MAF conversations no longer classify user text with server keyword rules. The server first freezes only the business-route candidate set and trusted, redacted capability summary; `ManagerDispatchExecutor` then returns the strict intent-and-dispatch JSON contract.
+- The final plan is Pydantic-validated and allowlisted before it is checkpointed. Invalid JSON, illegal intent or seat, missing convergence, manager failure, and timeout all finish on the clarification branch; they do not create expert threads or start expert/tool work.
+- A conversation initially persists and binds the manager only. After a valid decision, only `selected_seat_agent_ids` are added to the participant store and receive internal threads.
+- Every non-clarification route, including `group_chat`, starts at the same manager dispatch node. Group speakers are limited to the verified selected seats; static candidate configuration cannot bypass the plan.

frontend-web/docs/position-roundtable-delivery-workflow-plan.md

@@ -0,0 +1,362 @@
+# 岗位会商交付闭环与内置智能体实现计划
+
+> 页面：`/page/strategy/qa/position-roundtable`
+>
+> 目标：在现有岗位会商基础上补齐“产物交付、查看、驳回、方案总结、行动规划”的完整闭环，同时继续保持原多智能体会商页面不受影响。
+
+## 实施核对（2026-07-21）
+
+本计划已按“岗位会商独立路由、无总控、各席位直接问答”的边界完成第一轮闭环。实际流程调整为：
+
+```text
+任务信息 → 情报分析岗识别并确认意图 → 启动校验并冻结业务链
+→ 分阶段席位直接问答/交付 Markdown → 全部有效交付
+→ 方案总结智能体（roundtable-summary）→ 行动规划智能体（position-action-planner）
+→ 可随时返回交付产物驳回 → 后续阶段及内置产物级联失效 → 重做后重新收口
+```
+
+- [x] 情报意图、业务链选择、席位岗位归属和席位智能体配置均在启动前校验；启动后保存业务链快照。
+- [x] 普通席位直接调用各自分配的智能体，并注入任务、意图及已完成上游席位的问答/产物；不经过总控智能体。
+- [x] 普通席位必须在 `outputs` 中交付 Markdown 才会完成；情报分析岗以确认的结构化意图完成为准。
+- [x] 节点、交付卡片、流程图和大图弹窗均展示 `locked / ready / running / done / rejected / stale / error` 状态，并可回看节点会话和产物。
+- [x] 驳回要求标题和理由；当前节点转为 `rejected`，后续阶段按依赖转为 `stale/locked`，总结和行动规划同时失效，历史内容保留可查看。
+- [x] 被驳回或失效的普通席位必须写入一份**新的或已改写** Markdown 才能再次完成；单纯继续问答且没有新交付不会误使下游产物失效。
+- [x] 方案总结复用 `roundtable-summary` 的真实流式线程；行动规划新增 `position-action-planner`，强制输出 Markdown 报告和 `action-plan-subtasks.json`。
+- [x] 两个内置智能体的线程、产物快照和来源节点版本栅栏均持久化；流式期间若上游版本变化，旧运行不能覆盖最新状态。
+- [x] 右侧“交付产物”可查看内置节点结果、继续同一线程问答/修改交付，并在打开 Markdown 沙箱时自动收起右栏。
+
+设计收敛：当前版本以节点的 `artifact_manifest`、`latest_answer`、版本、驳回记录及 Session 内置快照作为唯一事实来源，已能覆盖统一产物卡片和级联逻辑，因此不新增重复的 `position_roundtable_deliverables` 表。若后续需要“单个文件独立驳回、跨会话检索或完整版本对比”，再将清单归一化为独立产物表，避免现在的双写一致性风险。
+
+## 数据持久化与灾难恢复（2026-07-23）
+
+岗位会商现在使用“两层持久化”，两层职责不同：
+
+1. LangGraph checkpoint/thread 是智能体继续推理与流式问答的执行源。
+2. `position_roundtable_sessions` / `position_roundtable_nodes` 是页面历史的数据库恢复源。
+
+数据库恢复源会保存：
+
+- 情报分析岗完整消息、步骤时间线和未发送输入草稿；
+- 每个业务链岗位的完整消息和未发送输入草稿；
+- 方案总结、行动规划两个收口智能体的完整消息和未发送输入草稿；
+- 已确认意图、冻结任务与业务链快照、节点状态、版本、驳回记录；
+- Markdown / JSON 等文本产物正文（单文件最多 400 万字符）和文件元数据。
+
+因此即使线上重启后 checkpoint 或沙箱 outputs 卷丢失，历史页仍能从数据库展示对话与产物正文，后续收口智能体也能继续读取数据库中的有效上游交付。新任务在意图识别开始前就会创建 Session，用户不必等到“启动业务链”才获得持久化保护。历史下拉支持删除，删除会显式清理 Session 与全部节点恢复快照，不依赖 SQLite 外键开关。
+
+对应迁移：`20260723_05_position_roundtable_conversations.py`。部署时必须执行到 Alembic head。
+
+## 0. 核心结论
+
+- 方案总结智能体建议复用现有会商里的 `roundtable-summary` 能力，但不要直接搬整套 Step 3 页面流程。
+  - 可复用：内置智能体 ID、总结报告 prompt 组织方式、Markdown 报告产物、流式对话、报告续问与文件预览能力。
+  - 需要改造：输入材料从“总控共识 + 各席位交付”改成“任务信息 + 意图结果 + 已通过的岗位产物 + 业务链快照”，并把结果存到岗位会商 Session 下。
+- 行动规划智能体建议作为新的内置智能体新增。
+  - 输入：方案总结报告、各岗位最终有效产物、业务链阶段信息、任务意图。
+  - 输出：行动规划报告、结构化子任务清单。
+- 这个模式仍然不需要总控智能体。情报分析岗负责意图识别，业务链节点直接调用各自配置的智能体，最终再由内置总结/规划智能体收口。
+- 驳回不删除历史内容，只改变“当前有效版本”的状态；被驳回节点和后续节点需要重新交付，既保留可追溯性，也方便后续返回查看。
+
+## 1. 目标业务流程
+
+1. 情报分析岗进入页面，查看任务信息并完成意图识别。
+2. 用户点击“确认意图并启动业务链”。
+3. 启动前做校验：
+   - 未选择业务链：提示“请先选择业务链”。
+   - 业务链存在未配置岗位的席位：提示并引导去业务链配置页。
+   - 业务链席位缺少智能体：提示具体席位名称。
+   - 意图尚未完成：提示先完成任务意图识别。
+4. 校验通过后冻结业务链快照，初始化岗位会商节点。
+5. 各岗位只对分配给本岗位的智能体进行问答。
+6. 节点问答完成后形成交付产物，右侧产物卡片显示“已完成 / 未完成 / 进行中 / 已驳回 / 已失效”。
+7. 左侧流程图显示各节点状态，节点可点击查看该节点对话与产物。
+8. 流程图右上角提供“查看”按钮，打开弹窗展示更完整的业务链流程图。
+9. 当业务链中所有岗位产物都处于有效已交付状态后，开放“方案总结”。
+10. 方案总结完成后开放“行动规划”。
+11. 即使进入方案总结或行动规划，用户仍可返回产物列表执行驳回。
+12. 若驳回早期阶段产物，后续阶段产物、方案总结、行动规划都一起失效并回到待重新完成状态。
+
+## 2. 状态设计
+
+### 2.1 节点状态
+
+现有节点状态需要扩展或映射为更贴近页面的展示状态：
+
+| 展示状态 | 建议内部状态 | 含义 |
+| --- | --- | --- |
+| 未完成 | `ready` / `locked` / `rejected` | 尚未有效交付，或被驳回后等待重做 |
+| 进行中 | `running` | 当前智能体正在回答或产物正在生成 |
+| 已完成 | `done` | 当前节点已有有效交付 |
+| 已失效 | `stale` | 上游被更新或驳回，当前结果不可作为最终材料 |
+| 异常 | `error` | 生成或保存失败 |
+
+建议新增 `rejected` 状态，便于区分“从未完成”和“被驳回后待重做”。如果第一轮想少改后端，也可以先用 `ready + rejection_record` 表示被驳回。
+
+### 2.2 产物状态
+
+产物状态建议独立于节点状态保存，因为一个节点可能同时有回答文本和多个文件产物。
+
+| 状态 | 含义 |
+| --- | --- |
+| `pending` | 还没有交付 |
+| `running` | 正在生成 |
+| `delivered` | 已交付且当前有效 |
+| `rejected` | 被用户驳回 |
+| `stale` | 受上游驳回或重做影响，已经失效 |
+
+### 2.3 内置收口节点
+
+在流程图中把两个内置节点追加到业务链末尾：
+
+1. `builtin:summary`：方案总结智能体。
+2. `builtin:action-plan`：行动规划智能体。
+
+这两个节点不属于普通业务链席位，但要和普通节点一样显示状态、支持点击查看结果。
+
+## 3. 数据模型调整
+
+### 3.1 Session 扩展
+
+`position_roundtable_sessions` 已使用下列持久化字段：
+
+| 字段 | 含义 |
+| --- | --- |
+| `status` | `intent_pending / active / completed / archived`；总结/规划运行态由前端瞬时状态与对应快照的 `status` 表示，避免一次运行中断后留下伪运行态 |
+| `summary_thread_id` | 方案总结智能体线程 |
+| `summary_snapshot` | 最新有效总结报告快照 |
+| `action_plan_thread_id` | 行动规划智能体线程 |
+| `action_plan_snapshot` | 最新有效行动规划快照 |
+| `invalidated_at` | 记录在 `summary_snapshot` / `action_plan_snapshot` 内，包含 `invalidated_by`，无需重复写 Session 字段 |
+
+### 3.2 Node 扩展
+
+`position_roundtable_nodes` 已使用下列字段（展示状态由前端按状态映射）：
+
+| 字段 | 含义 |
+| --- | --- |
+| `status` | `locked / ready / running / done / stale / rejected / error`，前端直接映射为展示状态 |
+| `rejection_count` | 当前节点累计驳回次数 |
+| `last_rejection` | 最新驳回标题、理由、操作者、时间 |
+| `revision` | 当前有效交付版本 |
+| `invalidated_by` | 导致当前节点失效的上游节点 key |
+
+### 3.3 Deliverable 新表（后续可选）
+
+当需要“单个文件独立驳回、跨会话检索或完整版本对比”时，再新增 `position_roundtable_deliverables`，不要只依赖 `artifact_manifest`。
+
+| 字段 | 含义 |
+| --- | --- |
+| `id` | 产物 ID |
+| `session_id` | 会话 ID |
+| `node_key` | 来源节点 |
+| `agent_id` | 来源智能体 |
+| `position_id` | 来源岗位 |
+| `title` | 产物名称 |
+| `kind` | `answer / file / summary / action_plan` |
+| `content` | 文本产物内容摘要或正文 |
+| `artifact_path` | 文件产物虚拟路径 |
+| `thread_id` | 所属线程 |
+| `status` | `pending / running / delivered / rejected / stale` |
+| `revision` | 来源节点版本 |
+| `rejection_title` | 驳回标题 |
+| `rejection_reason` | 驳回理由 |
+| `created_at` | 创建时间 |
+| `updated_at` | 更新时间 |
+
+当前第一轮不新增这张表：右侧产物卡片、驳回记录、总结输入材料从节点 `artifact_manifest`、节点版本/驳回记录和 Session 快照聚合，避免节点表与产物表双写。后续引入该表时，应把它提升为唯一事实来源，而不是并行维护两套状态。
+
+## 4. 驳回与级联失效规则
+
+### 4.1 基本驳回
+
+用户点击产物卡片的“驳回”后弹窗填写：
+
+- 驳回标题。
+- 驳回理由。
+
+提交后：
+
+- 当前产物状态改为 `rejected`。
+- 当前节点状态改为 `rejected` 或 `ready`。
+- 当前节点的 `latest_answer` 和历史文件不删除，但不再作为有效交付输入。
+- 记录 `last_rejection`，用于页面展示和后续追踪。
+
+### 4.2 级联失效
+
+如果驳回的节点位于第 N 阶段：
+
+- 同阶段其他节点不自动驳回，除非业务链未来明确配置了依赖关系。
+- 第 N+1 阶段及之后所有节点的有效产物全部标记为 `stale`。
+- 后续节点状态回到未完成展示态。
+- `builtin:summary` 和 `builtin:action-plan` 如果已经生成，也标记为 `stale`。
+- 页面允许用户继续查看旧报告和旧行动规划，但必须提示“上游产物已变更，需要重新生成”。
+
+### 4.3 重新交付
+
+被驳回节点重新问答并完成后：
+
+- 当前节点产生新的 `revision`。
+- 当前节点产物状态变为 `delivered`。
+- 只有当该阶段所有必要节点都重新有效交付后，下一阶段才重新解锁。
+- 方案总结和行动规划必须基于最新有效产物重新生成。
+
+## 5. 接口规划
+
+### 5.1 启动与校验
+
+| 方法 | 路径 | 用途 |
+| --- | --- | --- |
+| `POST` | `/api/position-roundtable/sessions/{id}/validate-activation` | 校验业务链、岗位、智能体、意图状态 |
+| `POST` | `/api/position-roundtable/sessions/{id}/activate` | 校验通过后冻结链条并初始化节点 |
+
+第一轮也可以先把校验合并在 `activate` 内，前端根据后端返回的错误码提示。
+
+### 5.2 产物
+
+| 方法 | 路径 | 用途 |
+| --- | --- | --- |
+| `GET` | `/api/position-roundtable/sessions/{id}/results` | 获取右侧统一产物来源节点（前端聚合文件与内置快照） |
+| `GET` | `/api/position-roundtable/sessions/{id}/nodes/{node_key}` | 获取节点详情；文件正文由既有线程产物预览接口读取 |
+| `POST` | `/api/position-roundtable/sessions/{id}/nodes/{node_key}/reject` | 驳回当前节点交付并触发级联失效 |
+| `POST` | `/api/position-roundtable/sessions/{id}/nodes/{node_key}/complete-turn` | 节点回答结束后同步回答与产物 |
+
+### 5.3 方案总结与行动规划
+
+| 方法 | 路径 | 用途 |
+| --- | --- | --- |
+| `POST` | `/api/position-roundtable/sessions/{id}/summary/prepare` | 服务端准备版本锁定的总结材料和线程信息 |
+| `POST` | `/api/position-roundtable/sessions/{id}/summary/ask` | 服务端准备总结的同线程续问材料 |
+| `POST` | `/api/position-roundtable/sessions/{id}/summary/complete` | 校验 Markdown 交付与来源版本后持久化总结快照 |
+| `POST` | `/api/position-roundtable/sessions/{id}/action-plan/prepare` | 服务端准备行动规划材料和线程信息 |
+| `POST` | `/api/position-roundtable/sessions/{id}/action-plan/ask` | 服务端准备行动规划同线程续问材料 |
+| `POST` | `/api/position-roundtable/sessions/{id}/action-plan/complete` | 校验 Markdown + JSON 交付与来源版本后持久化行动规划快照 |
+
+可以复用现有 `streamMultiAgent` 流式协议，但建议在岗位会商下包一层 API，由后端负责拼装岗位会商材料，前端不直接拼长 prompt。
+
+## 6. 前端实施步骤
+
+### 阶段 1：状态与启动校验（已完成）
+
+- 扩展 `PositionNodeStatus` 和状态显示映射。
+- “确认意图并启动业务链”前补齐校验提示。
+- 后端 `activate` 返回未配置岗位、缺智能体、未选择链条等具体错误。
+- 左侧流程图节点右上角添加状态小图标。
+- 节点样式调整为上方智能体名称、下方岗位名称，移除左侧 logo。
+
+验收标准：未选择业务链、岗位未配齐、意图未完成时都能准确阻止启动；启动后流程图能显示各节点状态。
+
+### 阶段 2：流程图弹窗（已完成）
+
+- 左侧保留小型从上到下流程图。
+- 流程图右上角增加“查看”按钮。
+- 点击后打开弹窗，展示更大的流程图。
+- 弹窗内支持点击节点查看对话与产物，保持和主页面选中节点同步。
+
+验收标准：小图不挤占左侧空间，大图能完整展示业务链和两个内置收口节点。
+
+### 阶段 3：产物卡片与预览（已完成）
+
+- 右侧新增或改造“分析结果”Tab 为“交付产物”列表。
+- 卡片展示智能体名称、产物名称、岗位名称、时间、状态。
+- 点击卡片打开详情弹窗。
+- 文本产物直接展示正文，文件产物复用现有 `ArtifactPreviewModal`。
+- 每个有效产物提供“驳回”入口。
+
+验收标准：节点回答和文件产物能进入统一产物列表；点击可查看详情。
+
+### 阶段 4：驳回弹窗与级联失效（已完成）
+
+- 新增 `RejectDeliverableDialog`。
+- 驳回表单包含标题和理由，均必填。
+- 后端事务内完成当前产物驳回、当前节点状态更新、后续阶段级联失效、总结和行动规划失效。
+- 前端刷新 Session、Node、Deliverable 和流程图状态。
+- 被驳回节点在对话区显示驳回信息，提示用户重新交付。
+
+验收标准：驳回第一阶段任意节点后，第二阶段及之后产物都显示未完成或已失效；旧内容可查看但不能作为总结输入。
+
+### 阶段 5：方案总结智能体（已完成）
+
+- 封装 `usePositionSummary`，内部复用 `roundtable-summary` 的线程初始化、流式输出和 Markdown 产物预览能力。
+- 输入材料改为岗位会商材料：
+  - 任务信息。
+  - 情报分析岗意图结果。
+  - 业务链快照。
+  - 所有状态为 `delivered` 的岗位产物。
+  - 已驳回或失效产物只作为历史参考，不进入默认总结材料。
+- 方案总结节点追加到流程图末尾。
+- 所有产物有效交付后才允许点击“生成方案总结”。
+- 总结结果写入 `summary_snapshot`，同时进入产物列表。
+
+验收标准：总结报告使用现有方案总结能力生成 Markdown；刷新页面后可恢复；上游驳回后总结标记失效。
+
+### 阶段 6：行动规划智能体（已完成）
+
+- 新增内置智能体 ID，建议先命名为 `position-action-planner`。
+- 新增行动规划 prompt：
+  - 读取方案总结报告。
+  - 读取各岗位最终有效产物。
+  - 拆解为若干子任务。
+  - 每个子任务包含名称、目标、输入依据、责任岗位建议、前置依赖、交付物、验收标准。
+- 输出两类产物：
+  - `行动规划报告.md`。
+  - `action-plan-subtasks.json`。
+- 行动规划节点追加到方案总结之后。
+- 方案总结有效完成后才允许启动行动规划。
+
+验收标准：行动规划能生成可读报告和结构化子任务；刷新可恢复；上游驳回后自动失效。
+
+### 阶段 7：返回修改与重新生成（已完成）
+
+- 用户在方案总结或行动规划视图中仍可切回“交付产物”。
+- 驳回后自动显示需要重做的节点。
+- 重做节点完成后，允许重新生成方案总结和行动规划。
+- 旧总结、旧行动规划保留历史查看，但状态显示“已失效”。
+
+验收标准：不会因为进入总结/规划阶段而锁死前序产物；前序重做后能形成新版本闭环。
+
+### 阶段 8：测试与回归（已完成）
+
+- 后端测试：
+  - activate 校验。
+  - 节点完成后产物入库。
+  - 驳回当前节点。
+  - 驳回第一阶段时后续阶段级联失效。
+  - 总结和行动规划失效。
+- 前端测试：
+  - 启动校验提示。
+  - 状态图标显示。
+  - 产物卡片筛选和预览。
+  - 驳回弹窗必填校验。
+- 回归验证：
+  - 原多智能体会商页面不受影响。
+  - 业务链普通配置入口不显示岗位配置。
+  - 岗位会商页面刷新恢复正常。
+  - 深色模式和嵌入模式布局不溢出。
+
+## 7. 推荐提交拆分
+
+1. `feat(position-roundtable): add delivery status model`
+2. `feat(position-roundtable): validate chain activation`
+3. `feat(position-roundtable): add workflow status graph`
+4. `feat(position-roundtable): add deliverable cards and preview`
+5. `feat(position-roundtable): support rejection cascade`
+6. `feat(position-roundtable): add summary builtin node`
+7. `feat(position-roundtable): add action planning builtin node`
+8. `test(position-roundtable): cover delivery workflow`
+
+## 8. 第一轮建议范围
+
+第一轮优先做最小可闭环：
+
+```text
+意图识别
+→ 启动校验
+→ 业务链节点状态
+→ 节点产物列表
+→ 产物详情查看
+→ 驳回与级联失效
+→ 全部交付后生成方案总结
+→ 基于总结生成行动规划
+```
+
+如果时间紧，行动规划可以先生成 Markdown 报告，结构化 `subtasks.json` 放到第二轮；但数据模型和 UI 入口第一轮就要预留，否则后面会返工。

frontend-web/index.html

@@ -16,7 +16,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
     <title>CM 助手</title>
-    <script src="/runtime-config.js"></script>
+    <script src="/runtime-config.js" data-runtime-config></script>
   </head>
   <body>
     <div id="root"></div>

frontend-web/package-lock.json

@@ -70,6 +70,7 @@
         "hast": "^1.0.0",
         "katex": "^0.16.28",
         "lucide-react": "^0.562.0",
+        "mermaid": "^11.15.0",
         "motion": "^12.26.2",
         "nanoid": "^5.1.6",
         "next-themes": "^0.4.6",
@@ -104,6 +105,7 @@
         "@types/react": "^19.0.0",
         "@types/react-dom": "^19.0.0",
         "@vitejs/plugin-react": "^5.0.4",
+        "lightningcss": "^1.30.2",
         "postcss": "^8.5.3",
         "tailwindcss": "^4.0.15",
         "tw-animate-css": "^1.4.0",
@@ -460,37 +462,11 @@
       "resolved": "https://registry.npmjs.org/@cfworker/json-schema/-/json-schema-4.1.1.tgz",
       "integrity": "sha512-gAmrUZSGtKc3AiBL71iNWxDsyUC5uMaKKGdvzYsBoTW/xi42JQHl7eKV2OYzCUqvc+D2RCcf7EXY2iCyFIk6og=="
     },
-    "node_modules/@chevrotain/cst-dts-gen": {
-      "version": "12.0.0",
-      "resolved": "https://registry.npmjs.org/@chevrotain/cst-dts-gen/-/cst-dts-gen-12.0.0.tgz",
-      "integrity": "sha512-fSL4KXjTl7cDgf0B5Rip9Q05BOrYvkJV/RrBTE/bKDN096E4hN/ySpcBK5B24T76dlQ2i32Zc3PAE27jFnFrKg==",
-      "dependencies": {
-        "@chevrotain/gast": "12.0.0",
-        "@chevrotain/types": "12.0.0"
-      }
-    },
-    "node_modules/@chevrotain/gast": {
-      "version": "12.0.0",
-      "resolved": "https://registry.npmjs.org/@chevrotain/gast/-/gast-12.0.0.tgz",
-      "integrity": "sha512-1ne/m3XsIT8aEdrvT33so0GUC+wkctpUPK6zU9IlOyJLUbR0rg4G7ZiApiJbggpgPir9ERy3FRjT6T7lpgetnQ==",
-      "dependencies": {
-        "@chevrotain/types": "12.0.0"
-      }
-    },
-    "node_modules/@chevrotain/regexp-to-ast": {
-      "version": "12.0.0",
-      "resolved": "https://registry.npmjs.org/@chevrotain/regexp-to-ast/-/regexp-to-ast-12.0.0.tgz",
-      "integrity": "sha512-p+EW9MaJwgaHguhoqwOtx/FwuGr+DnNn857sXWOi/mClXIkPGl3rn7hGNWvo31HA3vyeQxjqe+H36yZJwYU8cA=="
-    },
     "node_modules/@chevrotain/types": {
-      "version": "12.0.0",
-      "resolved": "https://registry.npmjs.org/@chevrotain/types/-/types-12.0.0.tgz",
-      "integrity": "sha512-S+04vjFQKeuYw0/eW3U52LkAHQsB1ASxsPGsLPUyQgrZ2iNNibQrsidruDzjEX2JYfespXMG0eZmXlhA6z7nWA=="
-    },
-    "node_modules/@chevrotain/utils": {
-      "version": "12.0.0",
-      "resolved": "https://registry.npmjs.org/@chevrotain/utils/-/utils-12.0.0.tgz",
-      "integrity": "sha512-lB59uJoaGIfOOL9knQqQRfhl9g7x8/wqFkp13zTdkRu1huG9kg6IJs1O8hqj9rs6h7orGxHJUKb+mX3rPbWGhA=="
+      "version": "11.1.2",
+      "resolved": "https://registry.npmmirror.com/@chevrotain/types/-/types-11.1.2.tgz",
+      "integrity": "sha512-U+HFai5+zmJCkK86QsaJtoITlboZHBqrVketcO2ROv865xfCMSFpELQoz1GkX5GzME8pTa+3kbKrZHQtI0gdbw==",
+      "license": "Apache-2.0"
     },
     "node_modules/@codemirror/autocomplete": {
       "version": "6.20.1",
@@ -1732,11 +1708,12 @@
       "integrity": "sha512-l0h88YhZFyKdXIFNfSWpyjStDjGHwZ/U7iobcK1cQQD8sejsONdQtTVU+1wVN1PBw40PiiHB1vA5S7VTfQiP9g=="
     },
     "node_modules/@mermaid-js/parser": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/@mermaid-js/parser/-/parser-1.1.0.tgz",
-      "integrity": "sha512-gxK9ZX2+Fex5zu8LhRQoMeMPEHbc73UKZ0FQ54YrQtUxE1VVhMwzeNtKRPAu5aXks4FasbMe4xB4bWrmq6Jlxw==",
+      "version": "1.2.0",
+      "resolved": "https://registry.npmmirror.com/@mermaid-js/parser/-/parser-1.2.0.tgz",
+      "integrity": "sha512-oYPyv8A4As1yH5Bx+04iQEQxXuIQDe0GKCNSRgao6z8AM9jixXIfP0vsppRLvGf+nKIOb9/LdpWA4YuJiVvESA==",
+      "license": "MIT",
       "dependencies": {
-        "langium": "^4.0.0"
+        "@chevrotain/types": "~11.1.2"
       }
     },
     "node_modules/@opentelemetry/api": {
@@ -4274,6 +4251,66 @@
         "node": ">=14.0.0"
       }
     },
+    "node_modules/@tailwindcss/oxide-wasm32-wasi/node_modules/@emnapi/core": {
+      "version": "1.7.1",
+      "dev": true,
+      "inBundle": true,
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "@emnapi/wasi-threads": "1.1.0",
+        "tslib": "^2.4.0"
+      }
+    },
+    "node_modules/@tailwindcss/oxide-wasm32-wasi/node_modules/@emnapi/runtime": {
+      "version": "1.7.1",
+      "dev": true,
+      "inBundle": true,
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "tslib": "^2.4.0"
+      }
+    },
+    "node_modules/@tailwindcss/oxide-wasm32-wasi/node_modules/@emnapi/wasi-threads": {
+      "version": "1.1.0",
+      "dev": true,
+      "inBundle": true,
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "tslib": "^2.4.0"
+      }
+    },
+    "node_modules/@tailwindcss/oxide-wasm32-wasi/node_modules/@napi-rs/wasm-runtime": {
+      "version": "1.1.0",
+      "dev": true,
+      "inBundle": true,
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "@emnapi/core": "^1.7.1",
+        "@emnapi/runtime": "^1.7.1",
+        "@tybys/wasm-util": "^0.10.1"
+      }
+    },
+    "node_modules/@tailwindcss/oxide-wasm32-wasi/node_modules/@tybys/wasm-util": {
+      "version": "0.10.1",
+      "dev": true,
+      "inBundle": true,
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "tslib": "^2.4.0"
+      }
+    },
+    "node_modules/@tailwindcss/oxide-wasm32-wasi/node_modules/tslib": {
+      "version": "2.8.1",
+      "dev": true,
+      "inBundle": true,
+      "license": "0BSD",
+      "optional": true
+    },
     "node_modules/@tailwindcss/oxide-win32-arm64-msvc": {
       "version": "4.1.18",
       "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-win32-arm64-msvc/-/oxide-win32-arm64-msvc-4.1.18.tgz",
@@ -5650,32 +5687,6 @@
         "url": "https://github.com/sponsors/wooorm"
       }
     },
-    "node_modules/chevrotain": {
-      "version": "12.0.0",
-      "resolved": "https://registry.npmjs.org/chevrotain/-/chevrotain-12.0.0.tgz",
-      "integrity": "sha512-csJvb+6kEiQaqo1woTdSAuOWdN0WTLIydkKrBnS+V5gZz0oqBrp4kQ35519QgK6TpBThiG3V1vNSHlIkv4AglQ==",
-      "dependencies": {
-        "@chevrotain/cst-dts-gen": "12.0.0",
-        "@chevrotain/gast": "12.0.0",
-        "@chevrotain/regexp-to-ast": "12.0.0",
-        "@chevrotain/types": "12.0.0",
-        "@chevrotain/utils": "12.0.0"
-      },
-      "engines": {
-        "node": ">=22.0.0"
-      }
-    },
-    "node_modules/chevrotain-allstar": {
-      "version": "0.4.3",
-      "resolved": "https://registry.npmjs.org/chevrotain-allstar/-/chevrotain-allstar-0.4.3.tgz",
-      "integrity": "sha512-2X4mkroolSMKqW+H22pyPMUVDqYZzPhephTmg/NODKb1IGYPHfxfhcW0EjS7wcPJNbze2i4vBWT7zT5FKF2lrQ==",
-      "dependencies": {
-        "lodash-es": "^4.18.1"
-      },
-      "peerDependencies": {
-        "chevrotain": "^12.0.0"
-      }
-    },
     "node_modules/class-variance-authority": {
       "version": "0.7.1",
       "license": "Apache-2.0",
@@ -6547,6 +6558,16 @@
         "node": ">= 0.4"
       }
     },
+    "node_modules/es-toolkit": {
+      "version": "1.49.0",
+      "resolved": "https://registry.npmmirror.com/es-toolkit/-/es-toolkit-1.49.0.tgz",
+      "integrity": "sha512-G5iZ6Pc/FNRY/soKZHC+TxGDD83rHUDXxzaWhGCX44vAv/tMs56WMusnm/KMNK+luUPsgA9U28cGr4RDlSzL2g==",
+      "license": "MIT",
+      "workspaces": [
+        "docs",
+        "benchmarks"
+      ]
+    },
     "node_modules/esbuild": {
       "version": "0.25.12",
       "resolved": "https://registry.npmmirror.com/esbuild/-/esbuild-0.25.12.tgz",
@@ -7354,7 +7375,9 @@
       }
     },
     "node_modules/katex": {
-      "version": "0.16.28",
+      "version": "0.16.47",
+      "resolved": "https://registry.npmmirror.com/katex/-/katex-0.16.47.tgz",
+      "integrity": "sha512-Eeo8Ys1doU1z+x8AZsPpQu+p/QcZBI5PeOo7QGQdy2x2m0MU/hYagBbGOmXwr5KVbEfVuWv9LpnQWeehogurjg==",
       "funding": [
         "https://opencollective.com/katex",
         "https://github.com/sponsors/katex"
@@ -7372,23 +7395,6 @@
       "resolved": "https://registry.npmjs.org/khroma/-/khroma-2.1.0.tgz",
       "integrity": "sha512-Ls993zuzfayK269Svk9hzpeGUKob/sIgZzyHYdjQoAdQetRKpOLj+k/QQQ/6Qi0Yz65mlROrfd+Ev+1+7dz9Kw=="
     },
-    "node_modules/langium": {
-      "version": "4.2.3",
-      "resolved": "https://registry.npmjs.org/langium/-/langium-4.2.3.tgz",
-      "integrity": "sha512-sOPIi4hISFnY7twwV97ca1TsxpBtXq0URu/LL1AvxwccPG/RIBBlKS7a/f/EL6w8lTNaS0EFs/F+IdSOaqYpng==",
-      "dependencies": {
-        "@chevrotain/regexp-to-ast": "~12.0.0",
-        "chevrotain": "~12.0.0",
-        "chevrotain-allstar": "~0.4.3",
-        "vscode-languageserver": "~9.0.1",
-        "vscode-languageserver-textdocument": "~1.0.11",
-        "vscode-uri": "~3.1.0"
-      },
-      "engines": {
-        "node": ">=20.10.0",
-        "npm": ">=10.2.3"
-      }
-    },
     "node_modules/langsmith": {
       "version": "0.6.0",
       "resolved": "https://registry.npmjs.org/langsmith/-/langsmith-0.6.0.tgz",
@@ -8100,43 +8106,32 @@
       "integrity": "sha512-Lf+9+2r+Tdp5wXDXC4PcIBjTDtq4UKjCPMQhKIuzpJNW0b96kVqSwW0bT7FhRSfmAiFYgP+SCRvdrDozfh0U5w=="
     },
     "node_modules/mermaid": {
-      "version": "11.14.0",
-      "resolved": "https://registry.npmjs.org/mermaid/-/mermaid-11.14.0.tgz",
-      "integrity": "sha512-GSGloRsBs+JINmmhl0JDwjpuezCsHB4WGI4NASHxL3fHo3o/BRXTxhDLKnln8/Q0lRFRyDdEjmk1/d5Sn1Xz8g==",
+      "version": "11.16.0",
+      "resolved": "https://registry.npmmirror.com/mermaid/-/mermaid-11.16.0.tgz",
+      "integrity": "sha512-Zvm3kbstgdpvIJPPItlL7fppIZ3kibvc1oZIGxdvk9t6UFz6flv+Jw7FtRGKwfcI8OckmH04LqG6LlS6X4B1pA==",
+      "license": "MIT",
       "dependencies": {
-        "@braintree/sanitize-url": "^7.1.1",
+        "@braintree/sanitize-url": "^7.1.2",
         "@iconify/utils": "^3.0.2",
-        "@mermaid-js/parser": "^1.1.0",
+        "@mermaid-js/parser": "^1.2.0",
         "@types/d3": "^7.4.3",
         "@upsetjs/venn.js": "^2.0.0",
-        "cytoscape": "^3.33.1",
+        "cytoscape": "^3.33.3",
         "cytoscape-cose-bilkent": "^4.1.0",
         "cytoscape-fcose": "^2.2.0",
         "d3": "^7.9.0",
         "d3-sankey": "^0.12.3",
         "dagre-d3-es": "7.0.14",
-        "dayjs": "^1.11.19",
-        "dompurify": "^3.3.1",
-        "katex": "^0.16.25",
+        "dayjs": "^1.11.20",
+        "dompurify": "^3.3.3",
+        "es-toolkit": "^1.45.1",
+        "katex": "^0.16.45",
         "khroma": "^2.1.0",
-        "lodash-es": "^4.17.23",
         "marked": "^16.3.0",
         "roughjs": "^4.6.6",
         "stylis": "^4.3.6",
         "ts-dedent": "^2.2.0",
-        "uuid": "^11.1.0"
-      }
-    },
-    "node_modules/mermaid/node_modules/uuid": {
-      "version": "11.1.1",
-      "resolved": "https://registry.npmjs.org/uuid/-/uuid-11.1.1.tgz",
-      "integrity": "sha512-vIYxrBCC/N/K+Js3qSN88go7kIfNPssr/hHCesKCQNAjmgvYS2oqr69kIufEG+O4+PfezOH4EbIeHCfFov8ZgQ==",
-      "funding": [
-        "https://github.com/sponsors/broofa",
-        "https://github.com/sponsors/ctavan"
-      ],
-      "bin": {
-        "uuid": "dist/esm/bin/uuid"
+        "uuid": "^11.1.0 || ^12 || ^13 || ^14.0.0"
       }
     },
     "node_modules/micromark": {
@@ -10414,49 +10409,6 @@
         "vite": ">=5.0.0"
       }
     },
-    "node_modules/vscode-jsonrpc": {
-      "version": "8.2.0",
-      "resolved": "https://registry.npmjs.org/vscode-jsonrpc/-/vscode-jsonrpc-8.2.0.tgz",
-      "integrity": "sha512-C+r0eKJUIfiDIfwJhria30+TYWPtuHJXHtI7J0YlOmKAo7ogxP20T0zxB7HZQIFhIyvoBPwWskjxrvAtfjyZfA==",
-      "engines": {
-        "node": ">=14.0.0"
-      }
-    },
-    "node_modules/vscode-languageserver": {
-      "version": "9.0.1",
-      "resolved": "https://registry.npmjs.org/vscode-languageserver/-/vscode-languageserver-9.0.1.tgz",
-      "integrity": "sha512-woByF3PDpkHFUreUa7Hos7+pUWdeWMXRd26+ZX2A8cFx6v/JPTtd4/uN0/jB6XQHYaOlHbio03NTHCqrgG5n7g==",
-      "dependencies": {
-        "vscode-languageserver-protocol": "3.17.5"
-      },
-      "bin": {
-        "installServerIntoExtension": "bin/installServerIntoExtension"
-      }
-    },
-    "node_modules/vscode-languageserver-protocol": {
-      "version": "3.17.5",
-      "resolved": "https://registry.npmjs.org/vscode-languageserver-protocol/-/vscode-languageserver-protocol-3.17.5.tgz",
-      "integrity": "sha512-mb1bvRJN8SVznADSGWM9u/b07H7Ecg0I3OgXDuLdn307rl/J3A9YD6/eYOssqhecL27hK1IPZAsaqh00i/Jljg==",
-      "dependencies": {
-        "vscode-jsonrpc": "8.2.0",
-        "vscode-languageserver-types": "3.17.5"
-      }
-    },
-    "node_modules/vscode-languageserver-textdocument": {
-      "version": "1.0.12",
-      "resolved": "https://registry.npmjs.org/vscode-languageserver-textdocument/-/vscode-languageserver-textdocument-1.0.12.tgz",
-      "integrity": "sha512-cxWNPesCnQCcMPeenjKKsOCKQZ/L6Tv19DTRIGuLWe32lyzWhihGVJ/rcckZXJxfdKCFvRLS3fpBIsV/ZGX4zA=="
-    },
-    "node_modules/vscode-languageserver-types": {
-      "version": "3.17.5",
-      "resolved": "https://registry.npmjs.org/vscode-languageserver-types/-/vscode-languageserver-types-3.17.5.tgz",
-      "integrity": "sha512-Ld1VelNuX9pdF39h2Hgaeb5hEZM2Z3jUrrMgWQAu82jMtZp7p3vJT3BzToKtZI7NgQssZje5o0zryOrhQvzQAg=="
-    },
-    "node_modules/vscode-uri": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/vscode-uri/-/vscode-uri-3.1.0.tgz",
-      "integrity": "sha512-/BpdSx+yCQGnCvecbyXdxHDkuk55/G3xwnC0GqY4gmQ3j+A+g8kzzgB4Nk/SINjqn6+waqw3EgbVF2QKExkRxQ=="
-    },
     "node_modules/w3c-keyname": {
       "version": "2.2.8",
       "resolved": "https://registry.npmjs.org/w3c-keyname/-/w3c-keyname-2.2.8.tgz",

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:maf": "vitest run --config vitest.maf.config.ts",
     "check:chrome109-css": "node scripts/check-chrome109-css.mjs",
     "check:legacy-chrome-css": "node scripts/check-chrome109-css.mjs"
   },
@@ -106,19 +107,23 @@
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.0.15",
+    "@testing-library/react": "^16.3.2",
+    "@testing-library/user-event": "^14.6.1",
     "@types/file-saver": "^2.0.7",
     "@types/gsap": "^3.0.0",
     "@types/node": "^20.14.10",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "@vitejs/plugin-react": "^5.0.4",
+    "jsdom": "^30.0.1",
     "lightningcss": "^1.30.2",
     "postcss": "^8.5.3",
     "tailwindcss": "^4.0.15",
     "tw-animate-css": "^1.4.0",
     "typescript": "^5.8.2",
     "vite": "^6.0.0",
-    "vite-plugin-source-identifier": "^1.1.2"
+    "vite-plugin-source-identifier": "^1.1.2",
+    "vitest": "^4.1.10"
   },
   "packageManager": "pnpm@10.26.2"
 }

frontend-web/public/cm-assistant-logo.svg

@@ -1,28 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48" role="img" aria-labelledby="title">
-  <title id="title">CM 助手</title>
-  <defs>
-    <linearGradient id="logoTopLeft" x1="7" y1="7" x2="25" y2="20" gradientUnits="userSpaceOnUse">
-      <stop stop-color="#5DB5FF"/>
-      <stop offset="1" stop-color="#328AF2"/>
-    </linearGradient>
-    <linearGradient id="logoTopRight" x1="24" y1="3" x2="43" y2="19" gradientUnits="userSpaceOnUse">
-      <stop stop-color="#62B2FF"/>
-      <stop offset="1" stop-color="#4B98F4"/>
-    </linearGradient>
-    <linearGradient id="logoLeft" x1="5" y1="14" x2="24" y2="45" gradientUnits="userSpaceOnUse">
-      <stop stop-color="#2C7CF0"/>
-      <stop offset="1" stop-color="#1F5EDA"/>
-    </linearGradient>
-    <linearGradient id="logoBottom" x1="9" y1="31" x2="43" y2="40" gradientUnits="userSpaceOnUse">
-      <stop stop-color="#276DE3"/>
-      <stop offset="1" stop-color="#4E9DF5"/>
-    </linearGradient>
-  </defs>
-
-  <!-- The mark is drawn as four independent folded faces. Together they form
-       the open C-shaped cube used in the product reference. -->
-  <path d="M5 13.5 24 3v10L14 18.5 5 13.5Z" fill="url(#logoTopLeft)"/>
-  <path d="M24 3 43 13.5 34 18.5 24 13V3Z" fill="url(#logoTopRight)"/>
-  <path d="M5 13.5 14 18.5v11L24 35v10L5 34.5v-21Z" fill="url(#logoLeft)"/>
-  <path d="M14 29.5 24 35l10-5.5 9 5L24 45 5 34.5l9-5Z" fill="url(#logoBottom)"/>
-</svg>

frontend-web/public/runtime-config.js

@@ -7,6 +7,30 @@
 // 4. 这里的默认值来自 .env.network；如某个环境不用某项，可以留空字符串。
 // 5. 布尔开关也用字符串形式填写："true" / "false"。
 window.__CM_RUNTIME_CONFIG__ = {
+  // 品牌图片相对路径会以 runtime-config.js 所在目录为基准解析。
+  // Nginx 以子路径部署时不需要修改前端图片路径。
+  // 打包后可直接替换 dist/brand-assets/ 内的同名 PNG。
+  // 也可以把下方图片地址改为其他 PNG 地址，无需重新打包。
+  // 是否显示整块欢迎页图标区域："true" 显示，"false" 隐藏，默认隐藏。
+  VITE_WELCOME_LOGO_VISIBLE: "false",
+  // 深色主题顶栏 Logo 位置："center" 显示在中间，"left" 显示在左上角，默认中间。
+  VITE_DARK_LOGO_POSITION: "center",
+  // 红白主题的顶栏系统 Logo 图片地址。
+  VITE_BRAND_LOGO_LIGHT_URL: "brand-assets/brand-logo-light.png",
+  // 浅蓝主题的顶栏系统 Logo 图片地址。
+  VITE_BRAND_LOGO_LIGHTBLUE_URL: "brand-assets/brand-logo-lightblue.png",
+  // 绿色主题可单独替换 Logo；默认复用浅色 Logo。
+  VITE_BRAND_LOGO_LIGHTGREEN_URL: "brand-assets/brand-logo-light.png",
+  // 深色主题的顶栏系统 Logo 图片地址。
+  VITE_BRAND_LOGO_DARK_URL: "brand-assets/brand-logo-dark.png",
+  // 红白主题的欢迎页 Logo 图片地址：为空时显示原有 CM 文字和渐变背景。
+  VITE_BRAND_WELCOME_LIGHT_URL: "",
+  // 浅蓝主题的欢迎页 Logo 图片地址：为空时显示原有 CM 文字和渐变背景。
+  VITE_BRAND_WELCOME_LIGHTBLUE_URL: "",
+  VITE_BRAND_WELCOME_LIGHTGREEN_URL: "",
+  // 深色主题的欢迎页 Logo 图片地址：为空时显示原有 CM 文字和渐变背景。
+  VITE_BRAND_WELCOME_DARK_URL: "",
+
   // DeerFlow Gateway 地址：前端自有后端接口，例如 /api/agents、/api/auth、/api/threads 等。
   // VITE_BACKEND_BASE_URL: "http://10.19.200.5:2026",
 
@@ -16,6 +40,10 @@ window.__CM_RUNTIME_CONFIG__ = {
   // Canvas/AI 写作独立 LangGraph 地址：为空时前端会回退使用 VITE_LANGGRAPH_BASE_URL。
   VITE_CANVAS_LANGGRAPH_BASE_URL: "",
 
+  // routeKey 短路由的用户名直登口令：例如 #/login/admin?routeKey=a。
+  // 填值时优先使用这里的 password；留空时使用 URL 中的 ?password=。
+  VITE_ROUTE_LOGIN_PASSWORD: "",
+
   // 轻应用「新建笔记」系列接口地址。
   VITE_NOTE_API_BASE_URL: "http://47.88.25.99:8000",
 
@@ -71,7 +99,7 @@ window.__CM_RUNTIME_CONFIG__ = {
   VITE_AIPI_KNOWES_URL: "http://ch1.b.uat.4.cn/knowes",
 
   // MaxKey 鉴权地址：onlineTicket 换 token 使用。
-  VITE_AUTH_BASE_URL: "https://auth.y.sit.4.cn",
+  VITE_AUTH_BASE_URL: "https://auth.y.uat.4.cn",
 
   // PG 中任务 iframe 地址。
   VITE_AIPI_PGLINKTO_URL: "https://pg.b.uat.4.cn",
@@ -85,12 +113,23 @@ window.__CM_RUNTIME_CONFIG__ = {
   // 登录深链任务详情是否使用本地 mock：false=真实接口；true=本地 mock。
   VITE_MOCK_COP_TASK_DETAIL: "false",
 
+  // 岗位会商完整演示数据：true=启动时幂等写入后端；后端不可用时直接使用前端 JSON 兜底。
+  // 默认关闭，避免演示历史记录出现在正常生产账号中。
+  VITE_POSITION_ROUNDTABLE_DEMO_MODE: "false",
+  // 纯前端岗位分析演示：跳过登录，直接进入岗位分析页，并禁止所有后台请求。
+  // 仅用于离线展台/演示环境，生产环境必须保持 false。
+  VITE_POSITION_ROUNDTABLE_STANDALONE_MODE: "false",
+
   // 大屏绘制 selectSqReport 是否使用本地 mock：不在运行时强制覆盖，
   // 由各环境的 .env 文件决定（开发环境为 true，生产环境为 false）。
 
   // 静态站点模式开关；一般部署业务系统时保持 false。
   VITE_STATIC_WEBSITE_ONLY: "false",
 
+  // 紧凑导航开关：true 时固定使用简洁布局，工作台左侧栏收起为菜单图标，
+  // 隐藏系统 Logo、换肤按钮以及“全量/简洁模式”切换。修改后刷新页面即可生效。
+  VITE_FORCE_COLLAPSED_SIDEBAR: "false",
+
   // GitHub OAuth Token；不使用 GitHub 相关能力时留空。
   VITE_GITHUB_OAUTH_TOKEN: "",
 };

frontend-web/src/App.tsx

@@ -37,6 +37,11 @@ import PublicRoundtableSharePage from "./pages/PublicRoundtableSharePage";
 import EmbedChatPage from "./pages/EmbedChatPage";
 import EmbedRoundtablePage from "./pages/EmbedRoundtablePage";
 import DashboardStandalonePage from "@/roundtable-planning/pages/DashboardStandalonePage";
+import PositionRoundtablePage from "@/position-roundtable/pages/PositionRoundtablePage";
+import {
+  isPositionRoundtableStandaloneMode,
+  POSITION_ROUNDTABLE_ROUTE,
+} from "@/position-roundtable/demo/position-roundtable-demo-config";
 import { ChatRuntime } from "./pages/WorkspaceRoutes";
 import { NotFoundPage } from "./pages/NotFoundPage";
 
@@ -46,6 +51,7 @@ function AppProviders({ children }: { children: React.ReactNode }) {
   const locale = useMemo(() => detectLocale(), []);
   const location = useLocation();
   const publicEmbedTheme = usePublicEmbedTheme();
+  const positionStandaloneMode = isPositionRoundtableStandaloneMode();
   // iframe 嵌入会话（按标签页 sessionStorage）集中在此同步：任何带 `&embed=1` 的入口（深链登录页
   // 或直接深链路由）一进来就启用、`embed=0` 关闭，后续干净路由靠会话维持去 chrome + 强制主题。
   useEffect(() => {
@@ -54,14 +60,18 @@ function AppProviders({ children }: { children: React.ReactNode }) {
   // 操作日志(Y-Log)：启动早期预热上报配置，使 writeYLog 同步读缓存即可工作
   // （刷新后 module 缓存清空，token 登录用户也能继续上报）。失败静默。
   useEffect(() => {
+    if (positionStandaloneMode) return;
     void fetchYLogConfig();
-  }, []);
+  }, [positionStandaloneMode]);
   const forcedTheme = useMemo(() => {
     // iframe 嵌入模式（外部系统 `&embed=1`）最高优先：按本标签页的嵌入主题强制明/暗。
     // 走 next-themes forcedTheme（不写 localStorage）→ 同浏览器另开的正常系统页不受影响。
     const embedTheme = resolveForcedEmbedTheme(location.search);
     if (embedTheme) return embedTheme;
-    const routeTheme = resolveForcedThemeForPath(location.pathname);
+    const routeTheme = resolveForcedThemeForPath(
+      location.pathname,
+      location.search,
+    );
     if (routeTheme) return routeTheme;
     if (location.pathname === "/embed/roundtable") {
       const wp = readWujieProps();
@@ -86,7 +96,7 @@ function AppProviders({ children }: { children: React.ReactNode }) {
       attribute="class"
       storageKey="strategy-theme"
       defaultTheme="light"
-      themes={["light", "dark", "lightblue"]}
+      themes={["light", "dark", "lightblue", "lightgreen", "iceblue", "lightyellow"]}
       enableSystem={false}
       disableTransitionOnChange
       forcedTheme={forcedTheme}
@@ -95,8 +105,8 @@ function AppProviders({ children }: { children: React.ReactNode }) {
         <I18nProvider initialLocale={locale}>
           <ThemeProvider>
             <ChatProvider>
-              <AuthSyncWatcher />
-              <DesensitizeWordsLoader />
+              {!positionStandaloneMode && <AuthSyncWatcher />}
+              {!positionStandaloneMode && <DesensitizeWordsLoader />}
               <FontScaleApplier />
               {children}
             </ChatProvider>
@@ -114,17 +124,38 @@ function AppProviders({ children }: { children: React.ReactNode }) {
  */
 function RootRedirect() {
   const { search } = useLocation();
+  if (isPositionRoundtableStandaloneMode()) {
+    return <Navigate to={POSITION_ROUNDTABLE_ROUTE} replace />;
+  }
   return <Navigate to={`/login${search}`} replace />;
 }
 
 export function App() {
+  const positionStandaloneMode = isPositionRoundtableStandaloneMode();
+  const standaloneLoginRedirect = (
+    <Navigate to={POSITION_ROUNDTABLE_ROUTE} replace />
+  );
+  const pageElement = positionStandaloneMode ? (
+    <ChatRuntime>
+      <PositionRoundtablePage compactChrome />
+    </ChatRuntime>
+  ) : (
+    <PageRoutes />
+  );
+
   return (
     <HashRouter>
       <AppProviders>
         <Routes>
           <Route path="/" element={<RootRedirect />} />
-          <Route path="/login" element={<LoginPage />} />
-          <Route path="/login/:username" element={<LoginPage />} />
+          <Route
+            path="/login"
+            element={positionStandaloneMode ? standaloneLoginRedirect : <LoginPage />}
+          />
+          <Route
+            path="/login/:username"
+            element={positionStandaloneMode ? standaloneLoginRedirect : <LoginPage />}
+          />
           <Route path="/landing" element={<LandingPage />} />
           <Route path="/share/:shareCode" element={<PublicSharePage />} />
           <Route path="/public/leaderboard" element={<PublicLeaderboardPage />} />
@@ -161,7 +192,7 @@ export function App() {
             path="/roundtable-dashboard"
             element={<DashboardStandalonePage />}
           />
-          <Route path="/page/*" element={<PageRoutes />} />
+          <Route path="/page/*" element={pageElement} />
           <Route path="*" element={<NotFoundPage />} />
         </Routes>
       </AppProviders>

frontend-web/src/assets/position-roundtable/add-task.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16"><defs><style>.a{fill:#fff;opacity:0;}.b{fill:none;stroke:#fff;stroke-linecap:round;stroke-linejoin:round;}</style></defs><rect class="a" width="16" height="16"/><path class="b" d="M24.036,10l-.012,9.333" transform="translate(-16.016 -6.667)"/><path class="b" d="M10,24h9.333" transform="translate(-6.667 -16)"/></svg>

frontend-web/src/assets/position-roundtable/agent-config-logo.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="36" height="36" viewBox="0 0 36 36"><defs><style>.a,.d{fill:#fff;}.a{opacity:0;}.b{fill:#da2331;}.c{fill:#0a54cf;}.e{fill:#1677ff;}.f{fill:#1e2433;}.g{fill:#10d6ff;}.h{fill:#ff8181;}.i{fill:none;stroke:#10d6ff;stroke-linecap:round;stroke-linejoin:round;}.j{filter:url(#d);}.k{filter:url(#a);}</style><filter id="a"><feOffset dx="4" input="SourceAlpha"/><feGaussianBlur stdDeviation="1" result="b"/><feFlood flood-opacity="0.161" result="c"/><feComposite operator="out" in="SourceGraphic" in2="b"/><feComposite operator="in" in="c"/><feComposite operator="in" in2="SourceGraphic"/></filter><filter id="d"><feOffset dx="-4" input="SourceAlpha"/><feGaussianBlur stdDeviation="1" result="e"/><feFlood flood-opacity="0.161" result="f"/><feComposite operator="out" in="SourceGraphic" in2="e"/><feComposite operator="in" in="f"/><feComposite operator="in" in2="SourceGraphic"/></filter></defs><g transform="translate(0 -1)"><rect class="a" width="36" height="36" transform="translate(0 1)"/><path class="b" d="M23.5,14.75a1.5,1.5,0,0,1-1.5-1.5V9.5a1.5,1.5,0,1,1,3,0v3.75A1.5,1.5,0,0,1,23.5,14.75Z" transform="translate(-5.5 -1)"/><g data-type="innerShadowGroup"><path class="c" d="M-2-2H1C3.206-2,5-.532,5,1.273V3.727C5,5.532,3.206,7,1,7H-2Z" transform="translate(28.66 19.541)"/><g class="k" transform="matrix(1, 0, 0, 1, 0, 1)"><path class="d" d="M-2-2H1C3.206-2,5-.532,5,1.273V3.727C5,5.532,3.206,7,1,7H-2Z" transform="translate(28.66 18.54)"/></g></g><g data-type="innerShadowGroup"><path class="c" d="M5-2H2C-.206-2-2-.532-2,1.273V3.727C-2,5.532-.206,7,2,7H5Z" transform="translate(4.34 19.541)"/><g class="j" transform="matrix(1, 0, 0, 1, 0, 1)"><path class="d" d="M5-2H2C-.206-2-2-.532-2,1.273V3.727C-2,5.532-.206,7,2,7H5Z" transform="translate(4.34 18.54)"/></g></g><path class="e" d="M5.5-2H16a7.508,7.508,0,0,1,7.5,7.5V13A7.508,7.508,0,0,1,16,20.5H5.5A7.508,7.508,0,0,1-2,13V5.5A7.508,7.508,0,0,1,5.5-2Z" transform="translate(7.25 13.5)"/><path class="f" d="M5.25,0h9A5.25,5.25,0,0,1,19.5,5.25V7.5a5.25,5.25,0,0,1-5.25,5.25h-9A5.25,5.25,0,0,1,0,7.5V5.25A5.25,5.25,0,0,1,5.25,0Z" transform="translate(8.25 15.25)"/><circle class="g" cx="1.5" cy="1.5" r="1.5" transform="translate(21 19)"/><circle class="g" cx="1.5" cy="1.5" r="1.5" transform="translate(12 19)"/><path class="d" d="M24,10v3.75" transform="translate(-6 -1.5)"/><circle class="h" cx="3" cy="3" r="3" transform="translate(15 4)"/><path class="i" d="M44,28.667a3.367,3.367,0,0,0,1.922.412,2.841,2.841,0,0,0,1.828-.412" transform="translate(-27.875 -5.017)"/></g></svg>

frontend-web/src/assets/position-roundtable/ask-question.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="96" height="96" viewBox="0 0 96 96"><defs><style>.a{fill:#fff;opacity:0;}.b,.c{fill:none;stroke:#006efe;stroke-width:6px;}.b{stroke-linecap:round;stroke-linejoin:round;}</style></defs><g transform="translate(0 1)"><rect class="a" width="96" height="96" transform="translate(0 -1)"/><path class="b" d="M47,67H38L18,77V67H4V7H84V29" transform="translate(4 8)"/><circle class="c" cx="12" cy="12" r="12" transform="translate(56 45)"/><path class="b" d="M39,32l10,8" transform="translate(39 33)"/><path class="b" d="M12,15H24" transform="translate(12 16)"/><path class="b" d="M12,21H36" transform="translate(12 22)"/></g></svg>

frontend-web/src/assets/position-roundtable/collapse-panel.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="13" height="11" viewBox="0 0 13 11"><defs><style>.a{stroke:rgba(0,0,0,0);stroke-miterlimit:10;fill:url(#a);}</style><linearGradient id="a" x1="0.277" y1="0.03" x2="0.725" y2="1.083" gradientUnits="objectBoundingBox"><stop offset="0" stop-color="#92eeff"/><stop offset="1" stop-color="#00c7ff"/></linearGradient></defs><path class="a" d="M1,10A1,1,0,1,1,1,8H6a1,1,0,0,1,0,2Zm9.8-.482L7.848,7.361A.445.445,0,0,1,7.661,7a.46.46,0,0,1,.187-.366L10.8,4.481a.45.45,0,0,1,.716.365V9.152a.44.44,0,0,1-.131.317.445.445,0,0,1-.322.136A.454.454,0,0,1,10.8,9.518ZM1,6A1,1,0,1,1,1,4H6A1,1,0,0,1,6,6ZM1,2A1,1,0,1,1,1,0H11a1,1,0,1,1,0,2Z" transform="translate(0.5 0.5)"/></svg>

frontend-web/src/assets/position-roundtable/double-arrow-decoration.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="13" height="11" viewBox="0 0 13 11"><defs><style>.a{fill:url(#a);}.b{fill:url(#b);}</style><linearGradient id="a" x1="0.023" x2="1" y2="1" gradientUnits="objectBoundingBox"><stop offset="0" stop-color="#92eeff" stop-opacity="0.302"/><stop offset="1" stop-color="#00c7ff" stop-opacity="0.302"/></linearGradient><linearGradient id="b" x1="0.023" x2="1" y2="1" gradientUnits="objectBoundingBox"><stop offset="0" stop-color="#92eeff"/><stop offset="1" stop-color="#00c7ff"/></linearGradient></defs><path class="a" d="M5.5,0,11,8H0Z" transform="translate(13) rotate(90)"/><path class="b" d="M5.5,0,11,8H0Z" transform="translate(8) rotate(90)"/></svg>

frontend-web/src/assets/position-roundtable/down-logo.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 12 12">
+  <defs>
+    <style>
+      .hit { fill: rgba(255, 255, 255, 0.8); opacity: 0; }
+      .mark { fill: #fff; }
+    </style>
+  </defs>
+  <g transform="translate(-2434.135 -67.941)">
+    <rect class="hit" width="12" height="12" transform="translate(2434.135 67.941)"/>
+    <path class="mark" d="M.885,0,0,.885,3.692,4.577,4.135,5l.442-.423L8.269.885,7.385,0,4.135,3.25Z" transform="translate(2436 71.942)"/>
+  </g>
+</svg>

frontend-web/src/assets/position-roundtable/edit-task.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16"><defs><style>.a{fill:#fff;opacity:0;}.b,.c{fill:none;stroke:#fff;stroke-linejoin:round;}.b{stroke-linecap:round;}</style></defs><g transform="translate(-1)"><rect class="a" width="16" height="16" transform="translate(1)"/><path class="b" d="M7,42H19" transform="translate(-4 -28)"/><path class="b" d="M0,0H3" transform="translate(9.848 3.848) rotate(45)"/><path class="c" d="M11,12.907v2.427h2.439l6.894-6.9L17.9,6Z" transform="translate(-6.667 -4)"/></g></svg>

frontend-web/src/assets/position-roundtable/expand-logo.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16">
+  <defs>
+    <style>
+      .background { fill: none; }
+      .mark { stroke: rgba(0, 0, 0, 0); stroke-miterlimit: 10; fill: url(#gradient); }
+    </style>
+    <linearGradient id="gradient" x1="0.277" y1="0.03" x2="0.725" y2="1.083" gradientUnits="objectBoundingBox">
+      <stop offset="0" stop-color="#a2e1f9"/>
+      <stop offset="1" stop-color="#45c3f3"/>
+    </linearGradient>
+  </defs>
+  <rect class="background" width="16" height="16"/>
+  <path class="mark" d="M14554.5,10202.5a1,1,0,1,1,0-2h5a1,1,0,0,1,0,2Zm9.8-.482-2.95-2.157a.445.445,0,0,1-.187-.361.46.46,0,0,1,.187-.366l2.95-2.152a.45.45,0,0,1,.716.365v4.307a.44.44,0,0,1-.131.317.445.445,0,0,1-.322.136A.454.454,0,0,1,14564.3,10202.019Zm-9.8-3.521a1,1,0,1,1,0-2h5a1,1,0,1,1,0,2Zm0-4a1,1,0,1,1,0-2h10a1,1,0,1,1,0,2Z" transform="translate(-14551.5 -10189.5)"/>
+</svg>

frontend-web/src/assets/position-roundtable/more-task.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16"><defs><style>.a{fill:#fff;opacity:0;}.b{fill:rgba(255,255,255,0.8);}</style></defs><rect class="a" width="16" height="16"/><path class="b" d="M10,1.5A1.5,1.5,0,1,1,11.5,3,1.5,1.5,0,0,1,10,1.5Zm-5,0A1.5,1.5,0,1,1,6.5,3,1.5,1.5,0,0,1,5,1.5Zm-5,0A1.5,1.5,0,1,1,1.5,3,1.5,1.5,0,0,1,0,1.5Z" transform="translate(1.498 6.5)"/></svg>

frontend-web/src/assets/position-roundtable/search-task.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16"><defs><style>.a{fill:#fff;opacity:0;}.b{fill:rgba(85,166,254,0.6);}</style></defs><rect class="a" width="16" height="16"/><path class="b" d="M12.715,13.421,9.588,10.294a5.841,5.841,0,1,1,.707-.707l3.128,3.128a.5.5,0,0,1-.708.706ZM1,5.833A4.833,4.833,0,1,0,5.834,1,4.838,4.838,0,0,0,1,5.833Z" transform="translate(1.334 1.216)"/></svg>

frontend-web/src/assets/position-roundtable/send-message.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16"><defs><style>.a{fill:#fff;}</style></defs><path class="a" d="M14.488.053.824,4.256a1.167,1.167,0,0,0-.285,2.1L4.576,8.936a1.167,1.167,0,0,0,1.382-.092L11,4.593A.292.292,0,0,1,11.408,5L7.156,10.043a1.167,1.167,0,0,0-.091,1.382l2.58,4.036a1.168,1.168,0,0,0,2.1-.286l4.2-13.663A1.167,1.167,0,0,0,14.488.053Z" transform="translate(0)"/></svg>

frontend-web/src/assets/position-roundtable/upload-file.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16.131" height="16" viewBox="0 0 16.131 16"><defs><style>.a{fill:#fff;opacity:0;}.b{fill:none;stroke:#97edff;stroke-linecap:round;stroke-linejoin:round;}</style></defs><rect class="a" width="16" height="16"/><path class="b" d="M6,30V34.12H18.361V30" transform="translate(-2.73 -19.994)"/><path class="b" d="M21.181,9.09,18.09,6,15,9.09" transform="translate(-8.64 -4.235)"/><path class="b" d="M23.992,14.241V6" transform="translate(-14.544 -4.235)"/></svg>

frontend-web/src/assets/position-roundtable/时间.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16"><defs><style>.a{fill:#fff;opacity:0;}.b,.c{fill:none;stroke:#346fb1;stroke-linejoin:round;}.c{stroke-linecap:round;}</style></defs><rect class="a" width="16" height="16"/><path class="b" d="M10.667,17.333A6.667,6.667,0,1,0,4,10.667,6.667,6.667,0,0,0,10.667,17.333Z" transform="translate(-2.667 -2.667)"/><path class="c" d="M24.008,12v4l2.826,2.826" transform="translate(-16.005 -8)"/></svg>

frontend-web/src/assets/position-roundtable/标签1.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="95.001" height="26" viewBox="0 0 95.001 26"><defs><style>.a{fill:rgba(212,120,0,0.5);}</style></defs><path class="a" d="M250.146,407.92h91l-11.4,18.235c-2.679,4.26-5.243,7.5-11.211,7.765H246.146v-22A4,4,0,0,1,250.146,407.92Z" transform="translate(-246.146 -407.92)"/></svg>

frontend-web/src/assets/position-roundtable/标签2.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="95.001" height="26" viewBox="0 0 95.001 26"><defs><style>.a{fill:rgba(207,19,34,0.5);}</style></defs><path class="a" d="M250.146,407.92h91l-11.4,18.235c-2.679,4.26-5.243,7.5-11.211,7.765H246.146v-22A4,4,0,0,1,250.146,407.92Z" transform="translate(-246.146 -407.92)"/></svg>

frontend-web/src/assets/position-roundtable/标签3.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="95.001" height="26" viewBox="0 0 95.001 26"><defs><style>.a{fill:rgba(29,171,123,0.5);}</style></defs><path class="a" d="M250.146,407.92h91l-11.4,18.235c-2.679,4.26-5.243,7.5-11.211,7.765H246.146v-22A4,4,0,0,1,250.146,407.92Z" transform="translate(-246.146 -407.92)"/></svg>

frontend-web/src/assets/position-roundtable/标签4.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="95.001" height="26" viewBox="0 0 95.001 26"><defs><style>.a{fill:rgba(132,85,230,0.5);}</style></defs><path class="a" d="M250.146,407.92h91l-11.4,18.235c-2.679,4.26-5.243,7.5-11.211,7.765H246.146v-22A4,4,0,0,1,250.146,407.92Z" transform="translate(-246.146 -407.92)"/></svg>

frontend-web/src/assets/position-roundtable/标签5.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="95.001" height="26" viewBox="0 0 95.001 26"><defs><style>.a{fill:rgba(201,181,0,0.5);}</style></defs><path class="a" d="M250.146,407.92h91l-11.4,18.235c-2.679,4.26-5.243,7.5-11.211,7.765H246.146v-22A4,4,0,0,1,250.146,407.92Z" transform="translate(-246.146 -407.92)"/></svg>

frontend-web/src/assets/position-roundtable/标签6.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="95.001" height="26" viewBox="0 0 95.001 26"><defs><style>.a{fill:rgba(69,195,243,0.5);}</style></defs><path class="a" d="M250.146,407.92h91l-11.4,18.235c-2.679,4.26-5.243,7.5-11.211,7.765H246.146v-22A4,4,0,0,1,250.146,407.92Z" transform="translate(-246.146 -407.92)"/></svg>

frontend-web/src/assets/position-roundtable/责任岗位.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16"><defs><style>.a{fill:#fff;opacity:0;}.b{fill:none;stroke:#346fb1;stroke-linecap:round;stroke-linejoin:round;}</style></defs><g transform="translate(0 -2)"><rect class="a" width="16" height="16" transform="translate(0 2)"/><path class="b" d="M17.333,8H4V18H9l1.667,1.667L12.333,18h5Z" transform="translate(-2.667 -3.667)"/><circle class="b" cx="1.667" cy="1.667" r="1.667" transform="translate(6.333 6.333)"/><path class="b" d="M21,26.667A2.848,2.848,0,0,0,18,24a2.848,2.848,0,0,0-3,2.667" transform="translate(-10 -14.333)"/></g></svg>

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

@@ -8,6 +8,17 @@
     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;
+}
+
+.sidebar-contnet--header-hidden .item-nav-content {
+    height: calc(100vh - 20px);
+    min-height: calc(100vh - 20px);
+}
+
 .sidebar-contents {
     width: 98px;
     min-height: calc(100% - 20px);
@@ -564,7 +575,59 @@
     background: #ffffff;
 }
 
+/* Ice blue has a deliberately light banner. Keep top-level navigation and
+   its active marker dark enough to remain readable against #9BCEF1. */
+html.iceblue .light-topnav-item {
+    color: rgba(24, 50, 74, 0.78);
+}
+
+html.iceblue .light-topnav-item:hover,
+html.iceblue .light-topnav-item--active,
+html.iceblue .light-topnav-item--active:hover {
+    color: #18324a;
+}
+
+html.iceblue .light-topnav-item--active::after {
+    background: #3d6e96;
+}
+
+/* Pale yellow has the same light-banner contrast requirement as ice blue. */
+html.lightyellow .light-topnav-item {
+    color: rgba(48, 61, 35, 0.78);
+}
+
+html.lightyellow .light-topnav-item:hover,
+html.lightyellow .light-topnav-item--active,
+html.lightyellow .light-topnav-item--active:hover {
+    color: #303d23;
+}
+
+html.lightyellow .light-topnav-item--active::after {
+    background: #4c6330;
+}
+
 /* ── 侧边栏：二级图标卡片列（96px）+ 右侧三级列（展开时整体变宽，带过渡）──────── */
+/* Runtime themes use their configurable header gradient rather than the
+   red/blue banner artwork. Navigation copy follows an automatically chosen
+   contrasting foreground so both pale and deep brand colours remain legible. */
+html[data-custom-theme="true"] .light-topnav-item,
+html[data-custom-theme="true"] .top-submenu-item {
+    color: var(--navigation-foreground);
+}
+
+html[data-custom-theme="true"] .light-topnav-item:hover,
+html[data-custom-theme="true"] .light-topnav-item--active,
+html[data-custom-theme="true"] .light-topnav-item--active:hover,
+html[data-custom-theme="true"] .top-submenu-item:hover,
+html[data-custom-theme="true"] .top-submenu-item--active {
+    color: var(--navigation-foreground);
+    text-shadow: none;
+}
+
+html[data-custom-theme="true"] .light-topnav-item--active::after {
+    background: var(--navigation-foreground);
+}
+
 .light-sidebar {
     position: fixed;
     left: 0;
@@ -587,6 +650,12 @@
     width: 236px;
 }
 
+/* `?hideHeader=1`: preserve the light sidebar while removing only Header. */
+.light-sidebar--header-hidden {
+    top: 0;
+    height: 100vh;
+}
+
 /* 二级列：固定 96px，竖排图标卡片 + 底部设置 */
 .light-sidebar__primary {
     flex: 0 0 96px;

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

@@ -17,9 +17,15 @@ type PageSidebarDarkProps = {
   /** 是否收起（true 时只渲染左下角浮动入口，sidebar 主体隐藏） */
   collapsed: boolean;
   onToggleCollapsed: () => void;
+  /** 全局 Header 隐藏时，侧边栏从视口顶部开始占满高度。 */
+  headerHidden?: boolean;
 };
 
-export function PageSidebarDark({ collapsed, onToggleCollapsed }: PageSidebarDarkProps) {
+export function PageSidebarDark({
+  collapsed,
+  onToggleCollapsed,
+  headerHidden = false,
+}: PageSidebarDarkProps) {
   const isAdmin = getStoredAuth()?.system_role === "admin";
   const visibleMenuItems = useSidebarMenuItems(!!isAdmin);
   const inWujieEnv = isWujieEnv();
@@ -196,7 +202,7 @@ export function PageSidebarDark({ collapsed, onToggleCollapsed }: PageSidebarDar
     </div>
   );
 
-  // collapsed 状态：sidebar 主体完全消失（包括占据的宽度），只渲染左下角浮动入口
+  // 收起时主侧栏不占宽度，保留左下角入口以便随时恢复。
   if (collapsed) {
     return (
       <button
@@ -207,13 +213,17 @@ export function PageSidebarDark({ collapsed, onToggleCollapsed }: PageSidebarDar
         onClick={onToggleCollapsed}
       >
         <PanelLeftOpen className="sidebar-collapse-btn__icon" aria-hidden="true" />
-        <span className="sidebar-collapse-btn__label">收起面板</span>
+        <span className="sidebar-collapse-btn__label">展开面板</span>
       </button>
     );
   }
 
   return (
-    <aside className={`sidebar-contnet ${inWujieEnv ? "" : "sidebar-contnet--top-submenu"}`}>
+    <aside
+      className={`sidebar-contnet ${inWujieEnv ? "" : "sidebar-contnet--top-submenu"} ${
+        headerHidden ? "sidebar-contnet--header-hidden" : ""
+      }`}
+    >
       <div className="sidebar-contents">
         {sidebarMenuItemsToRender.map((item) => (
           <div
@@ -244,7 +254,6 @@ export function PageSidebarDark({ collapsed, onToggleCollapsed }: PageSidebarDar
           </div>
         ))}
 
-        {/* 底部"收起面板"按钮：独立样式，mt-auto 推到底 */}
         <button
           type="button"
           title="收起侧边栏"

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

@@ -10,6 +10,7 @@ import {
   Gauge,
   ListTree,
   MousePointerClick,
+  BriefcaseBusiness,
   Settings,
   ShieldAlert,
   ShieldCheck,
@@ -49,6 +50,8 @@ import "@/components/page-sdebar.css";
 type PageSidebarProps = {
   collapsed: boolean;
   onToggleCollapsed: () => void;
+  /** Global Header is hidden but this sidebar remains available. */
+  headerHidden?: boolean;
 };
 
 type SettingsSection = "account" | "appearance" | "memory" | "tools" | "about";
@@ -79,23 +82,28 @@ const findFirstRoutePath = (items?: MenuItem[]): string | null => {
  * - wujie 嵌入环境：顶栏被宿主隐藏，一级导航无处安放，故回落到原手风琴整树菜单
  *   （保证嵌入模式下所有层级仍可达，零回归）。
  */
-export function PageSidebar({ collapsed, onToggleCollapsed }: PageSidebarProps) {
+export function PageSidebar({
+  collapsed,
+  onToggleCollapsed,
+  headerHidden = false,
+}: PageSidebarProps) {
   if (isWujieEnv()) {
     return (
       <LegacyAccordionSidebar
         collapsed={collapsed}
         onToggleCollapsed={onToggleCollapsed}
+        headerHidden={headerHidden}
       />
     );
   }
-  return <SecondaryNavSidebar />;
+  return <SecondaryNavSidebar headerHidden={headerHidden} />;
 }
 
 /**
  * 浅色二级导航侧边栏（图标卡片，红/蓝主题色经 --brand-* 变量自动切换）。
  * 浅色模式不支持侧边栏收起，故无收起按钮、不接收 collapsed 相关 props。
  */
-function SecondaryNavSidebar() {
+function SecondaryNavSidebar({ headerHidden }: { headerHidden: boolean }) {
   const isAdmin = getStoredAuth()?.system_role === "admin";
   const visibleMenuItems = useSidebarMenuItems(!!isAdmin);
   const { t } = useI18n();
@@ -150,7 +158,11 @@ function SecondaryNavSidebar() {
         open={notificationOpen}
         onOpenChange={setNotificationOpen}
       />
-      <aside className={`light-sidebar ${expanded ? "light-sidebar--expanded" : ""}`}>
+      <aside
+        className={`light-sidebar ${expanded ? "light-sidebar--expanded" : ""} ${
+          headerHidden ? "light-sidebar--header-hidden" : ""
+        }`}
+      >
         {/* 一级列：二级图标卡片 + 底部设置 */}
         <div className="light-sidebar__primary">
           <nav className="light-sidebar__list" aria-label="二级菜单">
@@ -224,6 +236,14 @@ function SecondaryNavSidebar() {
                       按钮管理
                     </DropdownMenuItem>
                   )}
+                  {isAdmin && (
+                    <DropdownMenuItem
+                      onClick={() => navigate("/page/strategy/admin/position-roles")}
+                    >
+                      <BriefcaseBusiness className="size-4" />
+                      岗位角色配置
+                    </DropdownMenuItem>
+                  )}
                   {isAdmin && (
                     <DropdownMenuItem
                       onClick={() => navigate("/page/strategy/admin/login-whitelist")}
@@ -287,6 +307,7 @@ function SecondaryNavSidebar() {
 function LegacyAccordionSidebar({
   collapsed,
   onToggleCollapsed,
+  headerHidden,
 }: PageSidebarProps) {
   const { theme } = useTheme();
   const isDark = theme === "dark";
@@ -438,7 +459,9 @@ function LegacyAccordionSidebar({
         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 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)]"
+        } ${
           isDark
             ? "border-r border-blue-800/30 bg-slate-900"
             : "border-r border-red-100 bg-white"
@@ -526,6 +549,12 @@ function LegacyAccordionSidebar({
                   按钮管理
                 </DropdownMenuItem>
               )}
+              {isAdmin && (
+                <DropdownMenuItem onClick={() => navigate("/page/strategy/admin/position-roles")}>
+                  <BriefcaseBusiness className="size-4" />
+                  岗位角色配置
+                </DropdownMenuItem>
+              )}
               {isAdmin && (
                 <DropdownMenuItem onClick={() => navigate("/page/strategy/admin/login-whitelist")}>
                   <ShieldCheck className="size-4" />

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

@@ -10,7 +10,7 @@ const buttonVariants = cva(
     variants: {
       variant: {
         default:
-          "cursor-pointer bg-primary text-primary-foreground hover:bg-primary/90",
+            "cursor-pointer bg-primary text-[var(--button-foreground,var(--primary-foreground))] hover:bg-primary/90",
         destructive:
           "cursor-pointer bg-destructive text-white hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:focus-visible:ring-destructive/40 dark:bg-destructive/60",
         outline:

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

@@ -71,15 +71,17 @@ const DialogOverlay = React.forwardRef<
 
 DialogOverlay.displayName = DialogPrimitive.Overlay.displayName;
 
-const DialogContent = React.forwardRef<
-  React.ElementRef<typeof DialogPrimitive.Content>,
-  React.ComponentPropsWithoutRef<typeof DialogPrimitive.Content> & {
-    showCloseButton?: boolean;
-  }
->(({ className, children, showCloseButton = true, ...props }, ref) => {
-  return (
-    <DialogPortal data-slot="dialog-portal">
-      <DialogOverlay />
+const DialogContent = React.forwardRef<
+  React.ElementRef<typeof DialogPrimitive.Content>,
+  React.ComponentPropsWithoutRef<typeof DialogPrimitive.Content> & {
+    showCloseButton?: boolean;
+    /** Use when this dialog is opened from a higher-layer surface such as a Drawer. */
+    overlayClassName?: string;
+  }
+>(({ className, children, showCloseButton = true, overlayClassName, ...props }, ref) => {
+  return (
+    <DialogPortal data-slot="dialog-portal">
+      <DialogOverlay className={overlayClassName} />
       <DialogPrimitive.Content
         ref={ref}
         data-slot="dialog-content"

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

@@ -57,18 +57,21 @@ function useSidebarSafe() {
   return React.useContext(SidebarContext);
 }
 
-function SidebarProvider({
-  defaultOpen = true,
-  open: openProp,
-  onOpenChange: setOpenProp,
-  className,
+function SidebarProvider({
+  defaultOpen = true,
+  open: openProp,
+  onOpenChange: setOpenProp,
+  disableToggle = false,
+  className,
   style,
   children,
   ...props
-}: React.ComponentProps<"div"> & {
-  defaultOpen?: boolean;
-  open?: boolean;
-  onOpenChange?: (open: boolean) => void;
+}: React.ComponentProps<"div"> & {
+  defaultOpen?: boolean;
+  open?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  /** Keep a controlled deployment-level rail from being reopened by hotkeys. */
+  disableToggle?: boolean;
 }) {
   const isMobile = useIsMobile();
   const [openMobile, setOpenMobile] = React.useState(false);
@@ -92,10 +95,11 @@ function SidebarProvider({
     [setOpenProp, open],
   );
 
-  // Helper to toggle the sidebar.
-  const toggleSidebar = React.useCallback(() => {
-    return isMobile ? setOpenMobile((open) => !open) : setOpen((open) => !open);
-  }, [isMobile, setOpen, setOpenMobile]);
+  // Helper to toggle the sidebar.
+  const toggleSidebar = React.useCallback(() => {
+    if (disableToggle) return;
+    return isMobile ? setOpenMobile((open) => !open) : setOpen((open) => !open);
+  }, [disableToggle, isMobile, setOpen, setOpenMobile]);
 
   // Adds a keyboard shortcut to toggle the sidebar.
   React.useEffect(() => {

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

@@ -0,0 +1,189 @@
+"use client";
+
+import { BookOpen, ListTree } from "lucide-react";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+
+import { MarkdownContent } from "@/components/workspace/messages/markdown-content";
+import { Badge } from "@/components/ui/badge";
+import { reasoningPlugins } from "@/core/streamdown";
+import { createMarkdownAnchorResolver } from "@/core/utils/markdown";
+import { cn } from "@/lib/utils";
+
+import "./wiki.css";
+
+function stripMarkdownToText(markdown: string): string {
+  return markdown
+    .replace(/```[\s\S]*?```/g, " ")
+    .replace(/~~~[\s\S]*?~~~/g, " ")
+    .replace(/!\[[^\]]*\]\([^)]+\)/g, " ")
+    .replace(/\[([^\]]+)\]\([^)]+\)/g, "$1")
+    .replace(/^#{1,6}\s+/gm, "")
+    .replace(/^[>\-*+\d.)\s]+/gm, "")
+    .replace(/[`*_~|]/g, "")
+    .replace(/<[^>]+>/g, " ")
+    .replace(/\s+/g, " ")
+    .trim();
+}
+
+function getMarkdownExcerpt(markdown: string): string {
+  const text = stripMarkdownToText(markdown);
+  if (!text) return "";
+  return text.length > 150 ? `${text.slice(0, 150)}...` : text;
+}
+
+function countReadableWords(markdown: string): number {
+  const text = stripMarkdownToText(markdown);
+  if (!text) return 0;
+  const cjk = text.match(/[\u4e00-\u9fff]/g)?.length ?? 0;
+  const words = text.replace(/[\u4e00-\u9fff]/g, " ").match(/[A-Za-z0-9]+/g)?.length ?? 0;
+  return cjk + words;
+}
+
+function selectorForId(id: string): string {
+  const css = window.CSS;
+  if (css?.escape) return `#${css.escape(id)}`;
+  return `[id="${id.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"]`;
+}
+
+export function ReportMarkdownView({
+  content,
+  title,
+  subtitle,
+  badgeLabel = "报告阅读",
+  className,
+  compactHeader = false,
+}: {
+  content: string;
+  title?: string;
+  subtitle?: string;
+  badgeLabel?: string;
+  className?: string;
+  compactHeader?: boolean;
+}) {
+  const rootRef = useRef<HTMLDivElement>(null);
+  const anchorResolver = useMemo(() => createMarkdownAnchorResolver(content), [content]);
+  const headings = useMemo(
+    () => anchorResolver.headings.filter((item) => item.level >= 1 && item.level <= 3),
+    [anchorResolver],
+  );
+  const [activeHeadingId, setActiveHeadingId] = useState<string | null>(null);
+  const excerpt = useMemo(() => getMarkdownExcerpt(content), [content]);
+  const sectionCount = headings.length;
+  const wordCount = useMemo(() => countReadableWords(content), [content]);
+
+  useEffect(() => {
+    setActiveHeadingId(headings[0]?.id ?? null);
+  }, [headings]);
+
+  useEffect(() => {
+    const root = rootRef.current;
+    if (!root || headings.length === 0) return;
+
+    const targets = headings
+      .map((item) => root.querySelector<HTMLElement>(selectorForId(item.id)))
+      .filter((item): item is HTMLElement => !!item);
+    if (targets.length === 0) return;
+
+    const observer = new IntersectionObserver(
+      (entries) => {
+        const visible = entries
+          .filter((entry) => entry.isIntersecting)
+          .sort((a, b) => a.boundingClientRect.top - b.boundingClientRect.top)[0];
+        if (visible?.target.id) setActiveHeadingId(visible.target.id);
+      },
+      {
+        root: root.closest("[data-radix-scroll-area-viewport]") ?? null,
+        rootMargin: "-96px 0px -65% 0px",
+        threshold: [0, 1],
+      },
+    );
+
+    targets.forEach((target) => observer.observe(target));
+    return () => observer.disconnect();
+  }, [headings, content]);
+
+  const scrollToHeading = useCallback((id: string) => {
+    const root = rootRef.current;
+    const target =
+      root?.querySelector<HTMLElement>(selectorForId(id)) ?? document.getElementById(id);
+    setActiveHeadingId(id);
+    target?.scrollIntoView({ behavior: "smooth", block: "start" });
+  }, []);
+
+  return (
+    <div
+      ref={rootRef}
+      className={cn("report-markdown-shell grid min-h-0 gap-5 lg:grid-cols-[minmax(0,1fr)_300px]", className)}
+    >
+      <article className="report-markdown-paper min-w-0 overflow-hidden">
+        <header className={cn("report-markdown-header", compactHeader && "report-markdown-header-compact")}>
+          <div className="flex flex-wrap items-center gap-2">
+            <Badge variant="secondary" className="report-markdown-badge">
+              <BookOpen className="size-3.5" />
+              {badgeLabel}
+            </Badge>
+            {subtitle && (
+              <span className="max-w-full truncate text-xs text-slate-500 dark:text-slate-400">
+                {subtitle}
+              </span>
+            )}
+          </div>
+          {title && <h1 className="report-markdown-title">{title}</h1>}
+          {!compactHeader && excerpt && <p className="report-markdown-excerpt">{excerpt}</p>}
+          <div className="report-markdown-metrics">
+            <span>{sectionCount || 1} 个章节</span>
+            <span>约 {wordCount} 字</span>
+          </div>
+        </header>
+
+        <div className="wiki-markdown report-markdown-body">
+          <MarkdownContent
+            className="max-w-none"
+            content={content}
+            isLoading={false}
+            remarkPlugins={reasoningPlugins.remarkPlugins}
+            rehypePlugins={reasoningPlugins.rehypePlugins}
+          />
+        </div>
+      </article>
+
+      <aside className="hidden min-w-0 lg:block">
+        <div className="report-markdown-toc">
+          <div className="mb-3 flex items-center justify-between gap-2">
+            <div className="flex items-center gap-2 text-sm font-semibold text-slate-900 dark:text-slate-100">
+              <ListTree className="size-4" />
+              内容目录
+            </div>
+            <span className="rounded-md bg-slate-100 px-1.5 py-0.5 text-xs text-slate-500 dark:bg-slate-800 dark:text-slate-400">
+              {sectionCount || 0}
+            </span>
+          </div>
+          {headings.length > 0 ? (
+            <nav className="report-markdown-toc-list">
+              {headings.map((item) => (
+                <button
+                  key={item.id}
+                  type="button"
+                  className={cn(
+                    "report-markdown-toc-item",
+                    activeHeadingId === item.id && "report-markdown-toc-item-active",
+                    item.level === 2 && "report-markdown-toc-level-2",
+                    item.level === 3 && "report-markdown-toc-level-3",
+                  )}
+                  title={item.text}
+                  onClick={() => scrollToHeading(item.id)}
+                >
+                  {item.text}
+                </button>
+              ))}
+            </nav>
+          ) : (
+            <div className="rounded-md border border-dashed p-3 text-xs text-slate-500 dark:border-slate-800 dark:text-slate-400">
+              暂无标题目录
+            </div>
+          )}
+        </div>
+      </aside>
+    </div>
+  );
+}

frontend-web/src/components/wiki/wiki.css

@@ -111,6 +111,340 @@
   border-color: #eef1f5;
 }
 
+.public-report-markdown {
+  color: #334155;
+  font-feature-settings: "kern";
+  text-rendering: optimizeLegibility;
+}
+
+.public-report-markdown h1 {
+  font-size: 30px;
+  letter-spacing: 0;
+  margin-bottom: 24px;
+}
+
+.public-report-markdown h2 {
+  font-size: 22px;
+  margin-top: 42px;
+  margin-bottom: 16px;
+  padding-bottom: 10px;
+}
+
+.public-report-markdown h3 {
+  font-size: 18px;
+  margin-top: 30px;
+  margin-bottom: 12px;
+}
+
+.public-report-markdown p,
+.public-report-markdown li {
+  font-size: 16px;
+  line-height: 1.9;
+}
+
+.public-report-markdown p {
+  margin-bottom: 16px;
+}
+
+.public-report-markdown ul,
+.public-report-markdown ol {
+  margin: 14px 0 18px;
+  padding-left: 26px;
+}
+
+.public-report-markdown ul {
+  list-style-type: disc;
+}
+
+.public-report-markdown ol {
+  list-style-type: decimal;
+}
+
+.public-report-markdown li {
+  padding-left: 2px;
+}
+
+.public-report-markdown code {
+  border-radius: 6px;
+  background: #f1f5f9;
+  padding: 2px 6px;
+  color: #be123c;
+  font-size: 0.92em;
+}
+
+.public-report-markdown pre {
+  margin: 20px 0;
+  border-radius: 8px;
+  background: #0f172a;
+  padding: 16px;
+  overflow-x: auto;
+}
+
+.public-report-markdown pre code {
+  background: transparent;
+  padding: 0;
+  color: inherit;
+}
+
+.public-report-markdown table {
+  display: block;
+  overflow-x: auto;
+  border-radius: 8px;
+  border: 1px solid #e8ecf1;
+}
+
+.public-report-markdown th,
+.public-report-markdown td {
+  min-width: 120px;
+  vertical-align: top;
+}
+
+.public-report-markdown blockquote {
+  margin: 20px 0;
+}
+
+.dark .public-report-markdown {
+  color: #cbd5e1;
+}
+
+.dark .public-report-markdown code {
+  background: #1e293b;
+  color: #f9a8d4;
+}
+
+.dark .public-report-markdown pre {
+  background: #020617;
+}
+
+.dark .public-report-markdown table {
+  border-color: #334155;
+}
+
+.report-markdown-shell {
+  align-items: start;
+  padding: 2px;
+}
+
+.report-markdown-paper {
+  border: 1px solid rgba(203, 213, 225, 0.85);
+  border-radius: 8px;
+  background:
+    linear-gradient(180deg, rgba(248, 250, 252, 0.92), rgba(255, 255, 255, 0) 220px),
+    #ffffff;
+  box-shadow:
+    0 1px 2px rgba(15, 23, 42, 0.04),
+    0 18px 44px rgba(15, 23, 42, 0.07);
+}
+
+.report-markdown-header {
+  border-bottom: 1px solid #e8edf4;
+  padding: 26px 34px 22px;
+}
+
+.report-markdown-header-compact {
+  padding-bottom: 18px;
+}
+
+.report-markdown-badge {
+  gap: 6px;
+  border: 1px solid #dbe3ef;
+  background: #ffffff;
+  color: #475569;
+}
+
+.report-markdown-title {
+  margin: 14px 0 0;
+  color: #0f172a;
+  font-size: 26px;
+  font-weight: 700;
+  line-height: 1.35;
+  letter-spacing: 0;
+}
+
+.report-markdown-excerpt {
+  margin: 14px 0 0;
+  max-width: 840px;
+  color: #64748b;
+  font-size: 14px;
+  line-height: 1.8;
+}
+
+.report-markdown-metrics {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  margin-top: 16px;
+  color: #64748b;
+  font-size: 12px;
+}
+
+.report-markdown-metrics span {
+  border: 1px solid #e2e8f0;
+  border-radius: 6px;
+  background: rgba(255, 255, 255, 0.78);
+  padding: 4px 8px;
+}
+
+.report-markdown-body {
+  max-width: 920px;
+  margin: 0 auto;
+  padding: 32px 42px 44px;
+}
+
+.report-markdown-body h1 {
+  font-size: 28px;
+}
+
+.report-markdown-body h2 {
+  position: relative;
+  margin-top: 44px;
+  border-bottom-color: #e5edf7;
+  font-size: 22px;
+}
+
+.report-markdown-body h2::before {
+  content: "";
+  position: absolute;
+  left: -16px;
+  top: 0.34em;
+  width: 4px;
+  height: 1.05em;
+  border-radius: 999px;
+  background: #2563eb;
+}
+
+.report-markdown-body h3 {
+  color: #1e293b;
+  font-size: 18px;
+}
+
+.report-markdown-body p,
+.report-markdown-body li {
+  font-size: 16px;
+  line-height: 1.92;
+}
+
+.report-markdown-body blockquote {
+  border-left-color: #2563eb;
+  background: #f8fbff;
+}
+
+.report-markdown-body table {
+  box-shadow: 0 1px 0 rgba(15, 23, 42, 0.04);
+}
+
+.report-markdown-toc {
+  position: sticky;
+  top: 16px;
+  max-height: calc(100vh - 32px);
+  overflow: hidden;
+  border: 1px solid rgba(203, 213, 225, 0.82);
+  border-radius: 8px;
+  background: rgba(255, 255, 255, 0.92);
+  padding: 14px;
+  box-shadow: 0 12px 34px rgba(15, 23, 42, 0.06);
+  backdrop-filter: blur(10px);
+}
+
+.report-markdown-toc-list {
+  max-height: calc(100vh - 128px);
+  overflow: auto;
+  padding-right: 4px;
+}
+
+.report-markdown-toc-item {
+  display: block;
+  width: 100%;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  border-left: 2px solid transparent;
+  border-radius: 6px;
+  padding: 7px 8px;
+  color: #64748b;
+  font-size: 12px;
+  line-height: 1.4;
+  text-align: left;
+  transition: background 160ms ease, border-color 160ms ease, color 160ms ease;
+}
+
+.report-markdown-toc-item:hover {
+  background: #f1f5f9;
+  color: #0f172a;
+}
+
+.report-markdown-toc-item-active {
+  border-left-color: #2563eb;
+  background: #eff6ff;
+  color: #1d4ed8;
+  font-weight: 600;
+}
+
+.report-markdown-toc-level-2 {
+  padding-left: 18px;
+}
+
+.report-markdown-toc-level-3 {
+  padding-left: 30px;
+  color: #94a3b8;
+}
+
+.dark .report-markdown-paper {
+  border-color: #1f2937;
+  background:
+    linear-gradient(180deg, rgba(15, 23, 42, 0.9), rgba(2, 6, 23, 0) 220px),
+    #020617;
+  box-shadow: 0 18px 44px rgba(0, 0, 0, 0.24);
+}
+
+.dark .report-markdown-header {
+  border-bottom-color: #1e293b;
+}
+
+.dark .report-markdown-badge,
+.dark .report-markdown-metrics span {
+  border-color: #334155;
+  background: #0f172a;
+  color: #cbd5e1;
+}
+
+.dark .report-markdown-title {
+  color: #f8fafc;
+}
+
+.dark .report-markdown-excerpt,
+.dark .report-markdown-metrics {
+  color: #94a3b8;
+}
+
+.dark .report-markdown-body h3 {
+  color: #e2e8f0;
+}
+
+.dark .report-markdown-body h2::before {
+  background: #60a5fa;
+}
+
+.dark .report-markdown-body blockquote {
+  background: #0f172a;
+  border-left-color: #60a5fa;
+}
+
+.dark .report-markdown-toc {
+  border-color: #1f2937;
+  background: rgba(2, 6, 23, 0.88);
+}
+
+.dark .report-markdown-toc-item:hover {
+  background: #0f172a;
+  color: #f8fafc;
+}
+
+.dark .report-markdown-toc-item-active {
+  background: rgba(37, 99, 235, 0.16);
+  color: #93c5fd;
+}
+
 /* Anchor target offset so headings clear the floating "目录" pill. */
 .wiki-markdown h1,
 .wiki-markdown h2,

frontend-web/src/components/workspace/agent-icon-color.ts

@@ -24,12 +24,60 @@ const AGENT_COLORS_DARK = [
   { from: "#69B1FF", to: "#003EB3" }, // 浅蓝 → 主色按下
 ] as const;
 
-/** 按 agent id 稳定散列出一对渐变色（from → to）。`isDark` 切换深蓝/浅色调色板。 */
-export function agentColor(id: string, isDark: boolean) {
+/** 按 agent id 稳定散列出一对渐变色，并根据当前主题返回可读的图标前景色。 */
+const AGENT_COLORS_ICEBLUE = [
+  { from: "#eff8fd", to: "#b7dcf5" },
+  { from: "#e3f2fb", to: "#9bcef1" },
+  { from: "#ebf6fb", to: "#add8e9" },
+  { from: "#edf2fc", to: "#b7cdef" },
+  { from: "#e9f7f5", to: "#afe0dc" },
+] as const;
+
+const AGENT_COLORS_LIGHTYELLOW = [
+  { from: "#fbfdef", to: "#e4efbf" },
+  { from: "#f7fae9", to: "#F3FBD9" },
+  { from: "#f9fbe8", to: "#dcebad" },
+  { from: "#faf8e9", to: "#e7dfb9" },
+  { from: "#f1f8e5", to: "#cce0af" },
+] as const;
+
+type AgentAvatarTheme =
+  | "dark"
+  | "iceblue"
+  | "lightyellow"
+  | "light"
+  | "lightblue"
+  | "lightgreen"
+  | `custom-theme-${string}`;
+
+/** Returns a stable avatar gradient and readable icon color for each theme. */
+export function agentColor(id: string, theme: AgentAvatarTheme) {
+  if (theme.startsWith("custom-theme-")) {
+    return {
+      from: "var(--accent)",
+      to: "var(--brand-200)",
+      foreground: "var(--accent-foreground)",
+    };
+  }
   let hash = 0;
   for (let i = 0; i < id.length; i++) {
     hash = (hash * 31 + id.charCodeAt(i)) >>> 0;
   }
-  const palette = isDark ? AGENT_COLORS_DARK : AGENT_COLORS_LIGHT;
-  return palette[hash % palette.length]!;
+  const palette =
+    theme === "dark"
+      ? AGENT_COLORS_DARK
+      : theme === "iceblue"
+        ? AGENT_COLORS_ICEBLUE
+        : theme === "lightyellow"
+          ? AGENT_COLORS_LIGHTYELLOW
+        : AGENT_COLORS_LIGHT;
+  return {
+    ...palette[hash % palette.length]!,
+    foreground:
+      theme === "iceblue"
+        ? "#2d587a"
+        : theme === "lightyellow"
+          ? "#4c6330"
+          : "#ffffff",
+  };
 }

frontend-web/src/components/workspace/agents/agent-brand-icon.tsx

@@ -1,90 +0,0 @@
-"use client";
-
-import { BotIcon, SparklesIcon } from "lucide-react";
-
-import { cn } from "@/lib/utils";
-
-type AgentBrandIconProps = {
-  className?: string;
-  size?: "nav" | "sm" | "md" | "lg";
-};
-
-const SIZE_STYLES = {
-  nav: {
-    frame: "size-[22px] rounded-md",
-    bot: "size-3.5",
-    badge: "-right-1 -top-1 size-2.5",
-    sparkle: "size-1.5",
-  },
-  sm: {
-    frame: "size-10 rounded-full",
-    bot: "size-[18px]",
-    badge: "-right-1 -top-1 size-3.5",
-    sparkle: "size-2",
-  },
-  md: {
-    frame: "size-12 rounded-full",
-    bot: "size-6",
-    badge: "-right-1 -top-1 size-4",
-    sparkle: "size-2.5",
-  },
-  lg: {
-    frame: "size-16 rounded-full",
-    bot: "size-7",
-    badge: "-right-1 -top-1 size-[18px]",
-    sparkle: "size-3",
-  },
-} as const;
-
-export function AgentBrandIcon({
-  className,
-  size = "md",
-}: AgentBrandIconProps) {
-  const styles = SIZE_STYLES[size];
-  const showBadge = size === "nav";
-
-  if (size !== "nav") {
-    return (
-      <span
-        aria-hidden="true"
-        data-agent-brand-icon={size}
-        className={cn(
-          "relative inline-flex shrink-0 overflow-hidden rounded-full",
-          styles.frame,
-          className,
-        )}
-      >
-        <img
-          src="/agent-avatar.png"
-          alt=""
-          className="size-full object-contain"
-          draggable={false}
-        />
-      </span>
-    );
-  }
-
-  return (
-    <span
-      aria-hidden="true"
-      data-agent-brand-icon={size}
-      className={cn(
-        "relative inline-flex shrink-0 items-center justify-center border border-blue-100 bg-[radial-gradient(circle_at_35%_30%,#ffffff_0%,#edf4ff_46%,#dce9ff_100%)] text-[#1f5fdb] shadow-[0_8px_22px_rgba(37,99,235,0.13),inset_0_1px_0_rgba(255,255,255,0.9)] dark:border-blue-400/30 dark:bg-blue-500/20 dark:text-blue-300",
-        styles.frame,
-        className,
-      )}
-    >
-      <BotIcon className={styles.bot} strokeWidth={1.9} />
-      {showBadge && (
-        <span
-          className={cn(
-            "absolute flex items-center justify-center rounded-full bg-gradient-to-br from-[#4b91ff] to-[#1858db] text-white shadow-sm ring-2 ring-white dark:ring-slate-950",
-            styles.badge,
-          )}
-        >
-          <SparklesIcon className={styles.sparkle} strokeWidth={2.4} />
-        </span>
-      )}
-    </span>
-  );
-}

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

@@ -1,13 +1,13 @@
 "use client";
 
-import {
+import {
+  BotIcon,
   ClockIcon,
   CopyIcon,
   EyeOffIcon,
   GlobeIcon,
   LockIcon,
-  MessageSquareIcon,
-  MoreHorizontalIcon,
+  MessageSquareIcon,
   PinIcon,
   ShieldIcon,
   SparklesIcon,
@@ -28,7 +28,7 @@ import {
 } from "react";
 import { toast } from "sonner";
 
-import { Badge } from "@/components/ui/badge";
+import { Badge } from "@/components/ui/badge";
 import { Button } from "@/components/ui/button";
 import {
   Card,
@@ -38,21 +38,14 @@ import {
   CardHeader,
   CardTitle,
 } from "@/components/ui/card";
-import {
-  Dialog,
+import {
+  Dialog,
   DialogContent,
   DialogDescription,
   DialogFooter,
   DialogHeader,
   DialogTitle,
-} from "@/components/ui/dialog";
-import {
-  DropdownMenu,
-  DropdownMenuContent,
-  DropdownMenuItem,
-  DropdownMenuSeparator,
-  DropdownMenuTrigger,
-} from "@/components/ui/dropdown-menu";
+} from "@/components/ui/dialog";
 import { Input } from "@/components/ui/input";
 import {
   Select,
@@ -66,8 +59,7 @@ import { Textarea } from "@/components/ui/textarea";
 import { usePublishSquares } from "@/core/system-settings/hooks";
 import { PublishSquarePickerDialog } from "@/components/workspace/publish-square-picker-dialog";
 import { SkillDetailDialog } from "@/components/workspace/skills/skill-detail-dialog";
-import { AgentQuestionEditor } from "@/components/workspace/agents/agent-question-editor";
-import { AgentBrandIcon } from "@/components/workspace/agents/agent-brand-icon";
+import { AgentQuestionEditor } from "@/components/workspace/agents/agent-question-editor";
 import { SkillTransferSelector } from "@/components/workspace/agents/skill-transfer-selector";
 import { TagChipList } from "@/components/workspace/tags/tag-chip";
 import { TagPickerDialog } from "@/components/workspace/tags/tag-picker-dialog";
@@ -556,10 +548,10 @@ export function AgentCard({ agent, layout = "card", onPublisherClick }: AgentCar
           内置
         </Badge>
       )}
-      {isOwned && (
-        <Badge
-          variant="default"
-          className="border border-emerald-200 bg-emerald-50 text-xs text-emerald-700 hover:bg-emerald-50 dark:border-emerald-800 dark:bg-emerald-500/15 dark:text-emerald-300"
+      {isOwned && (
+        <Badge
+          variant="default"
+          className="bg-emerald-500/15 text-emerald-700 hover:bg-emerald-500/15 dark:text-emerald-300 text-xs"
         >
           我的
         </Badge>
@@ -567,7 +559,7 @@ export function AgentCard({ agent, layout = "card", onPublisherClick }: AgentCar
       {isFromOthers && (
         <Badge
           variant="outline"
-          className="border-blue-200 bg-blue-50/60 text-xs text-blue-700 dark:border-blue-800 dark:bg-blue-500/10 dark:text-blue-300"
+          className="border-blue-500/30 text-blue-700 dark:text-blue-300 text-xs"
           title={agent.user_id ? `来自用户 ${agent.user_id}` : "已发布"}
         >
           来自他人
@@ -576,7 +568,7 @@ export function AgentCard({ agent, layout = "card", onPublisherClick }: AgentCar
       {(isOwned || isAdmin) && !isBuiltin && agent.published && !agent.is_private && (
         <Badge
           variant="outline"
-          className="border-sky-200 bg-sky-50/60 text-xs text-sky-700 dark:border-sky-800 dark:bg-sky-500/10 dark:text-sky-300"
+          className="border-sky-500/30 text-sky-700 dark:text-sky-300 text-xs"
           title="该智能体已对所有用户可见"
         >
           <GlobeIcon className="size-3" />
@@ -671,12 +663,8 @@ export function AgentCard({ agent, layout = "card", onPublisherClick }: AgentCar
   const skillBadgeItems = [
     ...(agent.tool_groups ?? []).map((group) => ({
       key: `tg:${group}`,
-      node: (
-        <Badge
-          key={`tg:${group}`}
-          variant="outline"
-          className="border-0 bg-[#f1f5ff] px-2.5 py-1 text-xs font-normal text-[#2166e8] hover:bg-[#e9f0ff]"
-        >
+      node: (
+        <Badge key={`tg:${group}`} variant="outline" className="text-xs">
           {desensitize(group)}
         </Badge>
       ),
@@ -686,8 +674,8 @@ export function AgentCard({ agent, layout = "card", onPublisherClick }: AgentCar
       node: (
         <Badge
           key={`sk:${skill}`}
-          variant="secondary"
-          className="cursor-pointer border-0 bg-[#f1f5ff] px-2.5 py-1 text-xs font-normal text-[#2166e8] hover:bg-[#e9f0ff]"
+          variant="secondary"
+          className="hover:bg-secondary/70 cursor-pointer text-xs"
           title={t.settings.skills.viewDetailAction}
           onClick={(e) => {
             e.stopPropagation();
@@ -835,181 +823,80 @@ export function AgentCard({ agent, layout = "card", onPublisherClick }: AgentCar
     </>
   );
 
-  const chatButton = (
-    <Button
-      variant={isList ? "default" : "outline"}
-      size="sm"
-      className={cn(
-        isList
-          ? "shrink-0 rounded-xl bg-[#1f63e9] px-4 font-medium text-white hover:bg-[#1857d4]"
-          : "h-11 w-full rounded-lg border-[#b9d1ff] bg-white font-medium text-[#135ee8] shadow-none hover:border-[#79a8ff] hover:bg-[#f7faff] hover:text-[#135ee8] dark:border-blue-700 dark:bg-slate-900 dark:text-blue-300",
-      )}
-      onClick={handleChat}
+  const chatButton = (
+    <Button
+      size="sm"
+      className={cn(isList ? "shrink-0" : "w-full")}
+      onClick={handleChat}
     >
       <MessageSquareIcon className="mr-1.5 h-3.5 w-3.5" />
-      开始对话
+      {t.agents.chat}
     </Button>
-  );
-
-  const cardStatusBadge = agent.is_private ? (
-    <Badge className="border-0 bg-purple-50 px-2.5 py-1 text-xs font-normal text-purple-600 hover:bg-purple-50 dark:bg-purple-500/15 dark:text-purple-300">
-      <span className="mr-1.5 size-1.5 rounded-full bg-purple-500" />
-      私密
-    </Badge>
-  ) : agent.published || isBuiltin ? (
-    <Badge className="border-0 bg-blue-50 px-2.5 py-1 text-xs font-normal text-blue-600 hover:bg-blue-50 dark:bg-blue-500/15 dark:text-blue-300">
-      <span className="mr-1.5 size-1.5 rounded-full bg-blue-500" />
-      已发布
-    </Badge>
-  ) : (
-    <Badge className="border-0 bg-emerald-50 px-2.5 py-1 text-xs font-normal text-emerald-600 hover:bg-emerald-50 dark:bg-emerald-500/15 dark:text-emerald-300">
-      <span className="mr-1.5 size-1.5 rounded-full bg-emerald-500" />
-      运行中
-    </Badge>
-  );
-
-  const updatedAtText = formatDateTime(agent.updated_at ?? agent.created_at);
-  const cardActionsMenu = (
-    <DropdownMenu>
-      <DropdownMenuTrigger asChild>
-        <Button
-          size="icon"
-          variant="ghost"
-          className="size-8 rounded-lg text-slate-500 hover:bg-slate-100 hover:text-slate-900 dark:hover:bg-slate-800 dark:hover:text-white"
-          title="更多操作"
-        >
-          <MoreHorizontalIcon className="size-5" />
-        </Button>
-      </DropdownMenuTrigger>
-      <DropdownMenuContent align="end" className="w-44">
-        {canFavorite && (
-          <DropdownMenuItem onSelect={() => void handleToggleFavorite()}>
-            <StarIcon className={cn("size-4", isFavorite && "fill-current text-amber-500")} />
-            {isFavorite ? "取消收藏" : "收藏到我的"}
-          </DropdownMenuItem>
-        )}
-        <DropdownMenuItem onSelect={() => void handleTogglePin()}>
-          <PinIcon className={cn("size-4", isPinned && "fill-current text-emerald-600")} />
-          {isPinned ? "取消置顶" : "置顶"}
-        </DropdownMenuItem>
-        {isAdmin && (
-          <DropdownMenuItem onSelect={() => void handleToggleFeatured()}>
-            <SparklesIcon className="size-4" />
-            {agent.featured_order != null ? "取消推荐" : "设为推荐"}
-          </DropdownMenuItem>
-        )}
-        <DropdownMenuItem onSelect={() => setTagPickerOpen(true)}>
-          <TagsIcon className="size-4" />
-          {t.adminTags.manageTags}
-        </DropdownMenuItem>
-        {isOwned && (
-          <DropdownMenuItem onSelect={() => void handleTogglePublished()}>
-            {agent.published ? <LockIcon className="size-4" /> : <GlobeIcon className="size-4" />}
-            {agent.published ? "取消发布" : "发布"}
-          </DropdownMenuItem>
-        )}
-        {(isOwned || isAdmin) && (
-          <DropdownMenuItem onSelect={() => void handleTogglePrivate()}>
-            <ShieldIcon className="size-4" />
-            {agent.is_private ? "移出私密广场" : "放入私密广场"}
-          </DropdownMenuItem>
-        )}
-        <DropdownMenuSeparator />
-        <DropdownMenuItem onSelect={() => void handleDuplicate()}>
-          <CopyIcon className="size-4" />
-          复制智能体
-        </DropdownMenuItem>
-        {canEdit && (
-          <DropdownMenuItem onSelect={() => setEditOpen(true)}>
-            <SquarePenIcon className="size-4" />
-            编辑智能体
-          </DropdownMenuItem>
-        )}
-        {canDelete && (
-          <>
-            <DropdownMenuSeparator />
-            <DropdownMenuItem
-              className="text-destructive focus:text-destructive"
-              onSelect={() => setDeleteOpen(true)}
-            >
-              <Trash2Icon className="size-4" />
-              {t.agents.delete}
-            </DropdownMenuItem>
-          </>
-        )}
-      </DropdownMenuContent>
-    </DropdownMenu>
-  );
+  );
 
-  const cardLayout = (
-    <Card
-      className={cn(
-        "group flex min-h-[366px] min-w-0 flex-col gap-0 overflow-hidden rounded-2xl border-slate-200/90 bg-white py-0 shadow-[0_5px_18px_rgba(15,23,42,0.035)] transition-[background-color,border-color,box-shadow] duration-200 hover:!border-[#b8d1ff] hover:!bg-[linear-gradient(135deg,rgba(239,246,255,0.92)_0%,rgba(255,255,255,0.98)_48%,#fff_100%)] hover:!ring-1 hover:!ring-[#e2edff] hover:shadow-[0_8px_24px_rgba(37,99,235,0.07)] dark:border-slate-800 dark:bg-slate-900",
-        agent.featured_order != null && "border-blue-300 ring-1 ring-blue-100 dark:border-blue-700 dark:ring-blue-900/40",
-      )}
-    >
-      <CardHeader className="min-w-0 gap-0 px-5 pt-5 pb-2">
-        {agent.featured_order != null ? (
-          <>
-            <div className="mb-1 flex h-7 items-center justify-between">
-              <Badge className="border border-blue-200 bg-blue-50 px-2.5 py-1 text-xs font-medium text-blue-600 hover:bg-blue-50 dark:border-blue-800 dark:bg-blue-500/15 dark:text-blue-300">
-                <SparklesIcon className="mr-1 size-3.5 fill-current" />
-                推荐
-              </Badge>
-              {cardActionsMenu}
-            </div>
-            <AgentBrandIcon size="lg" />
-          </>
-        ) : (
-          <div className="flex items-start justify-between">
-            <AgentBrandIcon size="lg" />
-            {cardActionsMenu}
-          </div>
-        )}
-        <CardTitle
-          className="mt-3 block w-full min-w-0 overflow-hidden text-[18px] leading-6 font-semibold tracking-[-0.015em] text-ellipsis whitespace-nowrap text-slate-950 dark:text-white"
-          title={desensitize(agent.name)}
-        >
-          {desensitize(agent.name)}
-        </CardTitle>
-        {agent.description && (
-          <CardDescription className="mt-1.5 min-h-11 line-clamp-2 text-[14px] leading-[22px] text-slate-600 dark:text-slate-400">
-            {desensitize(agent.description)}
-          </CardDescription>
-        )}
-      </CardHeader>
-
-      {(agent.tags?.length ?? 0) > 0 && (
-        <CardContent className="px-5 pt-0 pb-1.5">
-          <TagChipList tags={agent.tags!} />
+  const cardLayout = (
+    <Card className="group flex min-w-0 flex-col transition-shadow hover:shadow-md">
+      <CardHeader className="min-w-0 pb-2">
+        <div className="flex min-w-0 items-start justify-between gap-2">
+          <div className="flex min-w-0 flex-1 items-center gap-2 overflow-hidden">
+            <div className="agent-avatar bg-primary/10 text-primary flex h-9 w-9 shrink-0 items-center justify-center rounded-lg">
+              <BotIcon className="h-5 w-5" />
+            </div>
+            <div className="min-w-0 flex-1 overflow-hidden">
+              <CardTitle
+                className="block w-full min-w-0 overflow-hidden text-base text-ellipsis whitespace-nowrap"
+                title={desensitize(agent.name)}
+              >
+                {desensitize(agent.name)}
+              </CardTitle>
+              {agent.model && (
+                <Badge variant="secondary" className="mt-0.5 text-xs">
+                  {desensitize(agent.model)}
+                </Badge>
+              )}
+            </div>
+          </div>
+          <div className="flex shrink-0 flex-wrap items-center justify-end gap-1">
+            {statusBadges}
+          </div>
+        </div>
+        {agent.description && (
+          <CardDescription className="mt-2 line-clamp-2 text-sm">
+            {desensitize(agent.description)}
+          </CardDescription>
+        )}
+        {publisherNode && <div className="mt-2">{publisherNode}</div>}
+        {createdAtNode && <div className="mt-1">{createdAtNode}</div>}
+      </CardHeader>
+
+      {(agent.tags?.length ?? 0) > 0 && (
+        <CardContent className="pt-0 pb-2">
+          <TagChipList tags={agent.tags!} />
         </CardContent>
       )}
 
       {hasSkillsOrTools && (
-        <CardContent className="px-5 pt-0 pb-2">
-          <ClampedBadgeRow items={skillBadgeItems} />
-        </CardContent>
-      )}
-
-      <CardFooter className="mt-auto flex flex-col items-stretch gap-10 px-5 pt-2 pb-4">
-        <div className="flex min-w-0 items-center gap-3">
-          {cardStatusBadge}
-          <span
-            className="min-w-0 truncate text-xs text-slate-400"
-            title={updatedAtText ? `更新于 ${updatedAtText}` : undefined}
-          >
-            {updatedAtText ? `更新于 ${updatedAtText}` : "最近更新"}
-            {publisherLabel ? ` · 由 ${publisherLabel} 更新` : isBuiltin ? " · 由系统更新" : ""}
-          </span>
-        </div>
-        {chatButton}
-      </CardFooter>
+        <CardContent className="pt-0 pb-2">
+          <ClampedBadgeRow items={skillBadgeItems} />
+        </CardContent>
+      )}
+
+      <CardFooter className="mt-auto flex flex-col items-stretch gap-2 pt-2">
+        {showActionRow && (
+          <div className="flex flex-wrap items-center justify-end gap-1">
+            {actionButtons}
+          </div>
+        )}
+        {chatButton}
+      </CardFooter>
     </Card>
   );
 
   const listLayout = (
-    <div className="group flex min-w-0 items-center gap-4 rounded-2xl border border-slate-200/90 bg-white p-4 shadow-[0_8px_24px_rgba(15,23,42,0.04)] transition-all hover:border-blue-200 hover:shadow-[0_12px_32px_rgba(37,99,235,0.09)] dark:border-slate-800 dark:bg-slate-900">
-      <AgentBrandIcon className="agent-avatar" size="md" />
+    <div className="group flex min-w-0 items-center gap-3 rounded-lg border p-2.5 transition-shadow hover:shadow-sm dark:border-[#213D5E] dark:bg-[#02244C]">
+      <div className="agent-avatar bg-primary/10 text-primary flex h-9 w-9 shrink-0 items-center justify-center rounded-lg">
+        <BotIcon className="h-5 w-5" />
+      </div>
       <div className="min-w-0 flex-1 overflow-hidden">
         <div className="flex min-w-0 items-center gap-2">
           <span

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

@@ -254,7 +254,7 @@ export function AgentChatSidebar({ activeAgentId }: { activeAgentId?: string })
                   {agents.map((agent) => {
                     const href = `${routeBase}/agents/${agent.id}/chats/new`;
                     const isActive = agent.id === activeAgentId;
-                    const { from, to } = agentColor(agent.id, isDark);
+                    const { from, to, foreground } = agentColor(agent.id, theme);
                     return (
                       <Link
                         key={agent.id}
@@ -279,6 +279,7 @@ export function AgentChatSidebar({ activeAgentId }: { activeAgentId?: string })
                           )}
                           style={{
                             backgroundImage: `linear-gradient(135deg, ${from}, ${to})`,
+                            color: foreground,
                           }}
                         >
                           <Bot className="size-[19px]" />

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

@@ -1,6 +1,7 @@
 "use client";
 
 import {
+  BotIcon,
   CheckIcon,
   GlobeIcon,
   InfoIcon,
@@ -42,7 +43,6 @@ import {
 import { Switch } from "@/components/ui/switch";
 import { Textarea } from "@/components/ui/textarea";
 import { AgentQuestionEditor } from "@/components/workspace/agents/agent-question-editor";
-import { AgentBrandIcon } from "@/components/workspace/agents/agent-brand-icon";
 import { AgentRecentChats } from "@/components/workspace/agents/agent-recent-chats";
 import { useArtifactsOptional } from "@/components/workspace/artifacts";
 import { EnabledSkillList } from "@/components/workspace/agents/enabled-skill-list";
@@ -100,15 +100,17 @@ function Section({
   icon,
   title,
   extra,
+  className,
   children,
 }: {
   icon?: ReactNode;
   title: string;
   extra?: ReactNode;
+  className?: string;
   children: ReactNode;
 }) {
   return (
-    <section className="bg-card/60 rounded-xl border p-4">
+    <section className={cn("bg-card/60 rounded-xl border p-4", className)}>
       <div className="mb-3 flex items-center justify-between gap-2">
         <h4 className="text-foreground flex items-center gap-1.5 text-sm font-semibold">
           {icon}
@@ -139,6 +141,15 @@ export function AgentDetailPanel({
   defaultCollapsed,
   showRecentChats,
   compactAppearanceActions,
+  avatarSrc,
+  positionName,
+  skillsIcon,
+  skillsTitle,
+  showCommonQuestions = false,
+  panelTitle,
+  embedded,
+  hideStatusBadges = false,
+  editIcon,
 }: {
   agent: Agent | null | undefined;
   agentName: string;
@@ -150,6 +161,19 @@ export function AgentDetailPanel({
   showRecentChats?: boolean;
   /** 简洁模式下挂在右上角收起/展开按钮左侧的外观控件。 */
   compactAppearanceActions?: ReactNode;
+  avatarSrc?: string;
+  positionName?: string;
+  skillsIcon?: ReactNode;
+  skillsTitle?: string;
+  showCommonQuestions?: boolean;
+  /** Overrides the standard panel heading for an embedded consumer. */
+  panelTitle?: string;
+  /** Renders one fixed panel instead of the responsive collapsible rail. */
+  embedded?: boolean;
+  /** Keeps deployment/status badges out of an embedded product surface. */
+  hideStatusBadges?: boolean;
+  /** Optional icon used by the compact embedded edit action. */
+  editIcon?: ReactNode;
 }) {
   const router = useRouter();
   const [collapsed, setCollapsed] = useState(defaultCollapsed ?? false);
@@ -472,11 +496,25 @@ export function AgentDetailPanel({
       </div>
     ) : (
       <div className="flex items-center gap-1">
-        <Button size="sm" variant="outline" onClick={beginEdit}>
-          <SquarePenIcon className="size-3.5" />
-          编辑
-        </Button>
-        {canTogglePublish && (
+        {embedded ? (
+          <Tooltip content="编辑智能体">
+            <Button
+              type="button"
+              size="icon-sm"
+              variant="ghost"
+              onClick={beginEdit}
+              aria-label="编辑智能体"
+            >
+              {editIcon ?? <SquarePenIcon className="size-3.5" />}
+            </Button>
+          </Tooltip>
+        ) : (
+          <Button size="sm" variant="outline" onClick={beginEdit}>
+            <SquarePenIcon className="size-3.5" />
+            编辑
+          </Button>
+        )}
+        {!embedded && canTogglePublish && (
           <Tooltip content={agent?.published ? "下架" : "发布"}>
             <Button
               size="icon-sm"
@@ -493,17 +531,19 @@ export function AgentDetailPanel({
             </Button>
           </Tooltip>
         )}
-        <Tooltip content="删除智能体">
-          <Button
-            size="icon-sm"
-            variant="ghost"
-            className="text-destructive hover:text-destructive"
-            onClick={() => setDeleteOpen(true)}
-            aria-label="删除智能体"
-          >
-            <Trash2Icon className="size-3.5" />
-          </Button>
-        </Tooltip>
+        {!embedded && (
+          <Tooltip content="删除智能体">
+            <Button
+              size="icon-sm"
+              variant="ghost"
+              className="text-destructive hover:text-destructive"
+              onClick={() => setDeleteOpen(true)}
+              aria-label="删除智能体"
+            >
+              <Trash2Icon className="size-3.5" />
+            </Button>
+          </Tooltip>
+        )}
       </div>
     )
   ) : null;
@@ -520,7 +560,13 @@ export function AgentDetailPanel({
       {/* ── Identity / 基础信息 ─────────────────────────────────────────── */}
       <section className="bg-card/60 rounded-xl border p-4">
         <div className="flex items-start gap-3">
-          <AgentBrandIcon className="agent-avatar" size="lg" />
+          <div className="agent-avatar bg-primary/10 ring-primary/15 flex size-12 shrink-0 items-center justify-center rounded-2xl ring-1">
+            {avatarSrc ? (
+              <img src={avatarSrc} alt="" aria-hidden="true" className="size-9" />
+            ) : (
+              <BotIcon className="text-primary size-6" />
+            )}
+          </div>
           <div className="min-w-0 flex-1 space-y-1.5">
             {editing && draft ? (
               <Input
@@ -539,9 +585,16 @@ export function AgentDetailPanel({
                 {displayName}
               </div>
             )}
-            <div className="flex flex-wrap items-center gap-1">
-              {statusBadges}
-            </div>
+            {!editing && positionName && (
+              <div className="position-agent-role text-sm">
+                岗位：{desensitize(positionName)}
+              </div>
+            )}
+            {!hideStatusBadges && (
+              <div className="flex flex-wrap items-center gap-1">
+                {statusBadges}
+              </div>
+            )}
             {!editing && agent.owner_username && !agent.builtin && (
               <div className="text-muted-foreground flex items-center gap-1 text-xs">
                 <UserRoundIcon className="size-3 shrink-0" />
@@ -644,7 +697,7 @@ export function AgentDetailPanel({
 
 
       {/* ── 常用问题 ───────────────────────────────────────────────────── */}
-      {(editing || questions.length > 0 || canEdit) && (
+      {(showCommonQuestions || editing || questions.length > 0 || canEdit) && (
         <Section
           icon={<MessageCircleQuestionIcon className="size-3.5" />}
           title="常用问题"
@@ -785,8 +838,9 @@ export function AgentDetailPanel({
 
       {/* ── 技能管理 ───────────────────────────────────────────────────── */}
       <Section
-        icon={<SparklesIcon className="size-3.5" />}
-        title={`已启用技能 ${skillNamesShown.length} 个`}
+        icon={skillsIcon ?? <SparklesIcon className="size-3.5" />}
+        title={skillsTitle ?? `已启用技能 ${skillNamesShown.length} 个`}
+        className="position-roundtable-skills-section"
         extra={
           editing ? (
             <Button
@@ -828,7 +882,9 @@ export function AgentDetailPanel({
   const panelChrome = (collapseButton: ReactNode) => (
     <>
       <div className="flex h-12 shrink-0 items-center justify-between border-b px-4">
-        <span className="shrink-0 whitespace-nowrap text-sm font-semibold">智能体信息</span>
+        <span className="shrink-0 whitespace-nowrap text-sm font-semibold">
+          {panelTitle ?? "智能体信息"}
+        </span>
         <div className="flex min-w-0 items-center gap-1">
           {headerActions}
           {compactAppearanceActions}
@@ -842,7 +898,11 @@ export function AgentDetailPanel({
   return (
     <>
       {/* ── Desktop (lg+): inline aside, collapsible to a rail ───────────── */}
-      {collapsed ? (
+      {embedded ? (
+        <aside className="bg-card/40 flex h-full w-full min-w-0 shrink-0 flex-col border-l">
+          {panelChrome(null)}
+        </aside>
+      ) : collapsed ? (
         <div className="hidden shrink-0 items-start border-l px-2 pt-3 lg:flex">
           <div className="flex items-center gap-1">
             {compactAppearanceActions}
@@ -875,30 +935,34 @@ export function AgentDetailPanel({
         </aside>
       )}
 
-      {/* ── Narrow screens (<lg): rail trigger + drawer with the same body ── */}
-      <div className="flex shrink-0 flex-col items-center border-l pt-3 lg:hidden">
-        <Tooltip content="智能体信息">
-          <Button
-            variant="ghost"
-            size="icon-sm"
-            onClick={() => setMobileOpen(true)}
-            aria-label="打开智能体信息"
-          >
-            <InfoIcon className="size-4" />
-          </Button>
-        </Tooltip>
-      </div>
-      <Sheet open={mobileOpen} onOpenChange={setMobileOpen}>
-        <SheetContent side="right" className="flex w-full flex-col gap-0 p-0 sm:max-w-md">
-          <SheetHeader className="border-b px-4 pb-3 pt-4">
-            <SheetTitle className="flex items-center justify-between text-sm">
-              智能体信息
-              <span className="mr-6">{headerActions}</span>
-            </SheetTitle>
-          </SheetHeader>
-          <div className="min-h-0 flex-1 overflow-y-auto">{body}</div>
-        </SheetContent>
-      </Sheet>
+      {!embedded && (
+        <>
+          {/* ── Narrow screens (<lg): rail trigger + drawer with the same body ── */}
+          <div className="flex shrink-0 flex-col items-center border-l pt-3 lg:hidden">
+            <Tooltip content="智能体信息">
+              <Button
+                variant="ghost"
+                size="icon-sm"
+                onClick={() => setMobileOpen(true)}
+                aria-label="打开智能体信息"
+              >
+                <InfoIcon className="size-4" />
+              </Button>
+            </Tooltip>
+          </div>
+          <Sheet open={mobileOpen} onOpenChange={setMobileOpen}>
+            <SheetContent side="right" className="flex w-full flex-col gap-0 p-0 sm:max-w-md">
+              <SheetHeader className="border-b px-4 pb-3 pt-4">
+                <SheetTitle className="flex items-center justify-between text-sm">
+                  智能体信息
+                  <span className="mr-6">{headerActions}</span>
+                </SheetTitle>
+              </SheetHeader>
+              <div className="min-h-0 flex-1 overflow-y-auto">{body}</div>
+            </SheetContent>
+          </Sheet>
+        </>
+      )}
 
       {/* ── Secondary surfaces ───────────────────────────────────────────── */}
       <SkillPickerSheet

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

@@ -1,15 +1,6 @@
 "use client";
 
-import {
-  ArrowDownUpIcon,
-  BotIcon,
-  Loader2,
-  LockIcon,
-  PlusIcon,
-  SearchIcon,
-  ShieldIcon,
-  XIcon,
-} from "lucide-react";
+import { ArrowDownUpIcon, BotIcon, Loader2, LockIcon, PlusIcon, ShieldIcon, XIcon } from "lucide-react";
 import { useRouter } from "next/navigation";
 import { useEffect, useState } from "react";
 import { toast } from "sonner";
@@ -19,17 +10,17 @@ import { Input } from "@/components/ui/input";
 import { Pagination } from "@/components/ui/pagination";
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select";
 import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
-import { AgentBrandIcon } from "@/components/workspace/agents/agent-brand-icon";
+import { TagSearchBar } from "@/components/workspace/tags/tag-search-bar";
+import { ViewModeToggle } from "@/components/workspace/view-mode-toggle";
 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 { usePrivateSquareStatus, usePublishSquares } from "@/core/system-settings/hooks";
+import { usePrivateSquareStatus, usePublishSquares, useViewMode } from "@/core/system-settings/hooks";
 
 import { AgentCard } from "./agent-card";
 
 const PAGE_SIZE = 12;
-type AgentStatusFilter = "all" | "published" | "draft" | "private" | "builtin";
 
 // Within a single tab the verified password is kept in sessionStorage so a
 // refresh / route navigation does not re-prompt. Cleared on tab close, so the
@@ -41,10 +32,11 @@ export function AgentGallery() {
   const router = useRouter();
   // 「内置智能体」筛选仅管理员可见（后端 scope=builtin 也做了 admin 闸门兜底）。
   const isAdmin = getStoredAuth()?.system_role === "admin";
+  const [viewMode, setViewMode] = useViewMode("agent");
   const [activeTab, setActiveTab] = useState<string>("mine");
   const [search, setSearch] = useState("");
+  const [tagIds, setTagIds] = useState<string[]>([]);
   const [sort, setSort] = useState<AgentSort>("time_desc");
-  const [statusFilter, setStatusFilter] = useState<AgentStatusFilter>("all");
   const { data: publishSquares } = usePublishSquares();
   // Each configured publish square (发布广场) becomes its own browse tab; the
   // backend always returns at least one (the built-in default).
@@ -61,9 +53,10 @@ export function AgentGallery() {
   // frontend's desensitize map, so typing the displayed abbreviation (e.g.
   // "TS") still matches the stored raw name (e.g. "态势分析"). Whenever the
   // filters change, every tab returns to its first page.
+  const tagKey = tagIds.join(",");
   useEffect(() => {
     setPages({});
-  }, [search, sort, publisher?.id, statusFilter]);
+  }, [search, tagKey, sort, publisher?.id]);
 
   // If the active square tab disappears (admin removed that square), fall back
   // to "我的" so the gallery never points at a dead tab.
@@ -115,6 +108,7 @@ export function AgentGallery() {
   } = useAgentsPaginated({
     scope: mainScope,
     search,
+    tagIds,
     sort,
     page: mainPage,
     pageSize: PAGE_SIZE,
@@ -132,6 +126,7 @@ export function AgentGallery() {
     error: privateError,
   } = usePrivateAgentsPaginated(privatePassword, {
     search,
+    tagIds,
     sort,
     page: pages.private ?? 1,
     pageSize: PAGE_SIZE,
@@ -182,22 +177,21 @@ export function AgentGallery() {
   const handlePublisherClick = (p: { id: string; label: string }) =>
     setPublisher(p);
 
-  const filterByStatus = (agent: Agent) => {
-    if (statusFilter === "published") return agent.published && !agent.is_private;
-    if (statusFilter === "draft") return !agent.published && !agent.is_private && !agent.builtin;
-    if (statusFilter === "private") return agent.is_private;
-    if (statusFilter === "builtin") return agent.builtin;
-    return true;
-  };
-
-  const renderGrid = (list: Agent[]) => {
-    const visibleAgents = list.filter(filterByStatus);
-    if (visibleAgents.length === 0 && list.length > 0) {
-      return renderEmpty("当前状态筛选下没有智能体。");
-    }
-    return (
-      <div className="grid grid-cols-1 gap-4 md:grid-cols-2 xl:grid-cols-3">
-        {visibleAgents.map((agent) => (
+  const renderGrid = (list: Agent[]) =>
+    viewMode === "list" ? (
+      <div className="flex flex-col gap-2">
+        {list.map((agent) => (
+          <AgentCard
+            key={agent.id}
+            agent={agent}
+            layout="list"
+            onPublisherClick={handlePublisherClick}
+          />
+        ))}
+      </div>
+    ) : (
+      <div className="grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4">
+        {list.map((agent) => (
           <AgentCard
             key={agent.id}
             agent={agent}
@@ -206,7 +200,6 @@ export function AgentGallery() {
         ))}
       </div>
     );
-  };
 
   /** Loading / empty / (grid + pagination) for one paginated tab. */
   const renderListBody = (opts: {
@@ -271,8 +264,10 @@ export function AgentGallery() {
   };
 
   const renderEmpty = (description: string, showNewButton = false) => (
-    <div className="flex h-72 flex-col items-center justify-center gap-3 rounded-2xl border border-dashed border-blue-200 bg-white/70 text-center shadow-[0_12px_36px_rgba(37,99,235,0.05)] dark:border-blue-900 dark:bg-slate-900/70">
-      <AgentBrandIcon size="lg" />
+    <div className="flex h-64 flex-col items-center justify-center gap-3 text-center">
+      <div className="bg-muted flex h-14 w-14 items-center justify-center rounded-full dark:bg-[#022248]">
+        <BotIcon className="text-muted-foreground h-7 w-7 dark:text-[#AACEFF]" />
+      </div>
       <div>
         <p className="font-medium dark:text-[#AACEFF]">{t.agents.emptyTitle}</p>
         <p className="text-muted-foreground mt-1 text-sm dark:text-[#55A6FE]">
@@ -281,7 +276,8 @@ export function AgentGallery() {
       </div>
       {showNewButton && (
         <Button
-          className="mt-2 rounded-xl bg-[#1f63e9] px-5 shadow-[0_8px_20px_rgba(31,99,233,0.22)] hover:bg-[#1857d4] dark:border-[#2580FF] dark:bg-[#2580FF] dark:text-white dark:hover:border-[#2580FF] dark:hover:bg-[#2580FF]/90 dark:hover:text-white"
+          variant="outline"
+          className="mt-2 dark:border-[#2580FF] dark:bg-[#2580FF] dark:text-white dark:hover:border-[#2580FF] dark:hover:bg-[#2580FF]/90 dark:hover:text-white"
           onClick={handleNewAgent}
         >
           <PlusIcon className="mr-1.5 h-4 w-4" />
@@ -368,22 +364,17 @@ export function AgentGallery() {
   };
 
   return (
-    <div className="flex size-full min-h-0 flex-col overflow-hidden border-y border-r border-slate-200/80 bg-white dark:border-slate-800 dark:bg-slate-950">
+    <div className="flex size-full min-h-0 flex-col">
       {/* Page header */}
-      <div className="flex shrink-0 items-start justify-between px-[38px] pt-[45px] pb-[38px]">
+      <div className="flex items-center justify-between border-b px-6 py-4">
         <div>
-          <h1 className="text-[28px] leading-none font-semibold tracking-[-0.03em] text-slate-950 dark:text-white">
-            {t.agents.title}
-          </h1>
-          <p className="mt-4 text-[15px] text-slate-500 dark:text-slate-400">
-            创建并管理专属的 AI 智能体，助力更高效的工作与决策。
+          <h1 className="text-xl font-semibold">{t.agents.title}</h1>
+          <p className="text-muted-foreground mt-0.5 text-sm">
+            {t.agents.description}
           </p>
         </div>
-        <Button
-          onClick={handleNewAgent}
-          className="h-12 w-[154px] rounded-lg bg-gradient-to-r from-[#2467ea] to-[#0f54ed] px-0 text-[15px] font-medium shadow-[0_9px_22px_rgba(31,99,233,0.22)] hover:brightness-105"
-        >
-          <PlusIcon className="mr-2 h-[18px] w-[18px]" />
+        <Button onClick={handleNewAgent}>
+          <PlusIcon className="mr-1.5 h-4 w-4" />
           {t.agents.newAgent}
         </Button>
       </div>
@@ -393,99 +384,43 @@ export function AgentGallery() {
         value={activeTab}
         onValueChange={(v) => {
           setActiveTab(v);
-          // Each tab starts from a clean slate instead of carrying filters over.
+          // Each tab starts from a clean slate: switching tabs clears the
+          // keyword / tag / sort / publisher filters instead of carrying them
+          // over. The TagSearchBar's own input box is reset via its key below.
           setSearch("");
+          setTagIds([]);
           setSort("time_desc");
-          setStatusFilter("all");
           setPublisher(null);
         }}
         className="flex min-h-0 flex-1 flex-col overflow-hidden"
       >
-        <div className="shrink-0 px-[38px]">
-          <div className="flex min-h-14 flex-col gap-3 border-b border-slate-200/90 lg:flex-row lg:items-end lg:justify-between dark:border-slate-800">
-            <TabsList variant="line" className="h-auto w-auto max-w-full flex-wrap justify-start self-start rounded-none border-0 bg-transparent p-0">
-              <TabsTrigger
-                value="mine"
-                className="h-14 rounded-none border-x-0 border-t-0 border-b-2 border-transparent bg-transparent px-3 text-[15px] shadow-none after:hidden data-[state=active]:border-x-0 data-[state=active]:border-t-0 data-[state=active]:!border-b-[#2166e8] data-[state=active]:bg-transparent data-[state=active]:text-[#2166e8] data-[state=active]:!shadow-none"
-              >
-                我的
-              </TabsTrigger>
+        <div className="mx-6 mt-4 flex flex-col gap-3">
+          <div className="flex items-center justify-between gap-3">
+            <TabsList className="w-auto max-w-full flex-wrap justify-start self-start">
+              <TabsTrigger value="mine">我的</TabsTrigger>
               {squareTabs.map((sq) => (
-                <TabsTrigger
-                  key={sq.id}
-                  value={sq.id}
-                  title={sq.description || sq.name}
-                  className="h-14 rounded-none border-x-0 border-t-0 border-b-2 border-transparent bg-transparent px-5 text-[15px] shadow-none after:hidden data-[state=active]:border-x-0 data-[state=active]:border-t-0 data-[state=active]:!border-b-[#2166e8] data-[state=active]:bg-transparent data-[state=active]:text-[#2166e8] data-[state=active]:!shadow-none"
-                >
+                <TabsTrigger key={sq.id} value={sq.id} title={sq.description || sq.name}>
                   {sq.name}
                 </TabsTrigger>
               ))}
               {privateFeatureAvailable && (
-                <TabsTrigger
-                  value="private"
-                  className="h-14 rounded-none border-x-0 border-t-0 border-b-2 border-transparent bg-transparent px-5 text-[15px] shadow-none after:hidden data-[state=active]:border-x-0 data-[state=active]:border-t-0 data-[state=active]:!border-b-[#2166e8] data-[state=active]:bg-transparent data-[state=active]:text-[#2166e8] data-[state=active]:!shadow-none"
-                >
+                <TabsTrigger value="private">
                   <LockIcon className="mr-1 h-3.5 w-3.5" />
                   私密广场
                 </TabsTrigger>
               )}
               {isAdmin && (
-                <TabsTrigger
-                  value="builtin"
-                  title="内置/功能型智能体（仅管理员可见）"
-                  className="h-14 rounded-none border-x-0 border-t-0 border-b-2 border-transparent bg-transparent px-5 text-[15px] shadow-none after:hidden data-[state=active]:border-x-0 data-[state=active]:border-t-0 data-[state=active]:!border-b-[#2166e8] data-[state=active]:bg-transparent data-[state=active]:text-[#2166e8] data-[state=active]:!shadow-none"
-                >
+                <TabsTrigger value="builtin" title="内置/功能型智能体（仅管理员可见）">
                   <BotIcon className="mr-1 h-3.5 w-3.5" />
                   内置智能体
                 </TabsTrigger>
               )}
             </TabsList>
-            {showSearchBar && (
-              <div className="flex flex-wrap items-center justify-end gap-5 pb-2.5">
-                <div className="relative w-[350px] max-w-full">
-                  <SearchIcon className="pointer-events-none absolute top-1/2 left-3.5 size-[18px] -translate-y-1/2 text-slate-500" />
-                  <Input
-                    value={search}
-                    onChange={(event) => setSearch(event.target.value)}
-                    placeholder="搜索智能体名称或描述"
-                    className="h-12 rounded-xl border-slate-200 bg-white pl-11 text-sm shadow-none placeholder:text-slate-400 focus-visible:border-blue-400 focus-visible:ring-blue-100 dark:border-slate-700 dark:bg-slate-900"
-                  />
-                  {(activeTab === "private" ? isPrivateFetching : mainFetching) && (
-                    <Loader2 className="absolute top-1/2 right-3.5 size-4 -translate-y-1/2 animate-spin text-blue-500" />
-                  )}
-                </div>
-                <Select
-                  value={statusFilter}
-                  onValueChange={(value) => setStatusFilter(value as AgentStatusFilter)}
-                >
-                  <SelectTrigger className="h-12 w-[156px] rounded-xl border-slate-200 px-4 text-sm shadow-none dark:border-slate-700">
-                    <SelectValue />
-                  </SelectTrigger>
-                  <SelectContent position="popper" side="bottom" sideOffset={4}>
-                    <SelectItem value="all">全部状态</SelectItem>
-                    <SelectItem value="published">已发布</SelectItem>
-                    <SelectItem value="draft">未发布</SelectItem>
-                    <SelectItem value="private">私密</SelectItem>
-                    <SelectItem value="builtin">内置</SelectItem>
-                  </SelectContent>
-                </Select>
-                <Select value={sort} onValueChange={(v) => setSort(v as AgentSort)}>
-                  <SelectTrigger
-                    className="h-12 w-[156px] rounded-xl border-slate-200 px-4 text-sm shadow-none dark:border-slate-700"
-                    title="排序"
-                  >
-                    <ArrowDownUpIcon className="mr-1 size-4 text-slate-500" />
-                    <SelectValue />
-                  </SelectTrigger>
-                  <SelectContent position="popper" side="bottom" sideOffset={4}>
-                    <SelectItem value="time_desc">更新时间</SelectItem>
-                    <SelectItem value="time_asc">最早创建</SelectItem>
-                    <SelectItem value="updated_desc">最近更新</SelectItem>
-                    <SelectItem value="updated_asc">最早更新</SelectItem>
-                    <SelectItem value="name_asc">名称 A-Z</SelectItem>
-                    <SelectItem value="name_desc">名称 Z-A</SelectItem>
-                  </SelectContent>
-                </Select>
+            <div className="flex items-center gap-3">
+              <span className="text-muted-foreground text-sm whitespace-nowrap">
+                共 {activeTotal} 个
+              </span>
+              <ViewModeToggle value={viewMode} onChange={setViewMode} />
               {activeTab === "private" && privatePassword && (
                 <Button
                   variant="outline"
@@ -497,16 +432,48 @@ export function AgentGallery() {
                   锁定
                 </Button>
               )}
-              </div>
-            )}
+            </div>
           </div>
+          {showSearchBar && (
+            <TagSearchBar
+              // Remount per tab so the internal keyword input / 展开 state also
+              // resets when the parent-owned filters are cleared on tab switch.
+              key={activeTab}
+              targetType="agent"
+              searching={
+                activeTab === "private" ? isPrivateFetching : mainFetching
+              }
+              onSearchChange={setSearch}
+              tagIds={tagIds}
+              onTagIdsChange={setTagIds}
+              actions={
+                <Select value={sort} onValueChange={(v) => setSort(v as AgentSort)}>
+                  <SelectTrigger
+                    className="h-9 w-full gap-2 px-3 text-xs sm:w-[148px]"
+                    title="排序"
+                  >
+                    <ArrowDownUpIcon className="text-muted-foreground size-3.5" />
+                    <SelectValue />
+                  </SelectTrigger>
+                  <SelectContent position="popper" side="bottom" sideOffset={4}>
+                    <SelectItem value="time_desc">最新创建</SelectItem>
+                    <SelectItem value="time_asc">最早创建</SelectItem>
+                    <SelectItem value="updated_desc">最近更新</SelectItem>
+                    <SelectItem value="updated_asc">最早更新</SelectItem>
+                    <SelectItem value="name_asc">名称 A-Z</SelectItem>
+                    <SelectItem value="name_desc">名称 Z-A</SelectItem>
+                  </SelectContent>
+                </Select>
+              }
+            />
+          )}
           {publisher && (
-            <div className="mt-3 flex items-center gap-2">
+            <div className="flex items-center gap-2">
               <span className="text-muted-foreground text-xs">筛选发布者：</span>
               <button
                 type="button"
                 onClick={() => setPublisher(null)}
-              className="inline-flex items-center gap-1 rounded-full bg-blue-50 px-3 py-1 text-xs font-medium text-blue-700 transition-colors hover:bg-blue-100 dark:bg-blue-500/15 dark:text-blue-300"
+                className="bg-primary/10 text-primary hover:bg-primary/20 inline-flex items-center gap-1 rounded-full px-3 py-1 text-xs font-medium transition-colors"
                 title="点击清除发布者筛选"
               >
                 {publisher.label}
@@ -514,16 +481,13 @@ export function AgentGallery() {
               </button>
             </div>
           )}
-          <div className="py-5 text-[15px] text-slate-600 dark:text-slate-300">
-            共 {activeTotal} 个智能体
-          </div>
         </div>
 
         {squareTabs.map((sq) => (
           <TabsContent
             key={sq.id}
             value={sq.id}
-            className="mt-0 flex-1 overflow-y-auto px-[38px] pb-8"
+            className="flex-1 overflow-y-auto p-6 mt-0"
           >
             {renderListBody({
               list: mainAgents,
@@ -536,7 +500,7 @@ export function AgentGallery() {
           </TabsContent>
         ))}
 
-        <TabsContent value="mine" className="mt-0 flex-1 overflow-y-auto px-[38px] pb-8">
+        <TabsContent value="mine" className="flex-1 overflow-y-auto p-6 mt-0">
           {renderListBody({
             list: mainAgents,
             total: mainTotal,
@@ -549,7 +513,7 @@ export function AgentGallery() {
         </TabsContent>
 
         {isAdmin && (
-          <TabsContent value="builtin" className="mt-0 flex-1 overflow-y-auto px-[38px] pb-8">
+          <TabsContent value="builtin" className="flex-1 overflow-y-auto p-6 mt-0">
             {renderListBody({
               list: mainAgents,
               total: mainTotal,
@@ -564,7 +528,7 @@ export function AgentGallery() {
         {privateFeatureAvailable && (
           <TabsContent
             value="private"
-            className="mt-0 flex-1 overflow-y-auto px-[38px] pb-8"
+            className="flex-1 overflow-y-auto p-6 mt-0"
           >
             {renderPrivateTab()}
           </TabsContent>

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

@@ -206,7 +206,7 @@ export function AgentModuleSidebar({
   const renderAgentCard = (agent: Agent, keyPrefix: string) => {
     const href = `${routeBase}/agents/${agent.id}/chats/new`;
     const isActive = agent.id === activeAgentId;
-    const { from, to } = agentColor(agent.id, isDark);
+    const { from, to, foreground } = agentColor(agent.id, theme);
     return (
       <Link
         key={`${keyPrefix}:${agent.id}`}
@@ -236,7 +236,10 @@ export function AgentModuleSidebar({
               isActive &&
               "ring-2 ring-[#83c1ff]/35 shadow-[0_0_18px_rgba(43,143,254,0.45)]",
           )}
-          style={{ backgroundImage: `linear-gradient(135deg, ${from}, ${to})` }}
+          style={{
+            backgroundImage: `linear-gradient(135deg, ${from}, ${to})`,
+            color: foreground,
+          }}
         >
           <Bot className="size-[19px]" />
         </span>

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

@@ -93,43 +93,47 @@ export function AgentSelector({
   return (
     <>
       <Dialog open={open} onOpenChange={setOpen}>
-        <DialogTrigger asChild>
-          {iconMode ? (
-            <Tooltip content={iconTooltipLabel}>
-              <Button
-                type="button"
-                variant="ghost"
-                size="icon"
-                disabled={disabled}
-                aria-label={selectedAgent ? `已选择智能体：${triggerLabel}` : "选择智能体"}
-                className={cn(
-                  "relative size-9 rounded-full text-muted-foreground shadow-none hover:bg-muted/60 hover:text-foreground",
-                  selectedAgent && "text-amber-600 hover:text-amber-700",
-                  selectedAgent && iconActiveClassName,
-                  iconButtonClassName,
-                )}
-              >
-                <BotIcon className="size-4" />
-                {selectedAgent && (
-                  <span
-                    role="button"
-                    tabIndex={0}
-                    aria-label="清除已选 agent"
-                    className="absolute -right-1 -top-1 inline-flex size-4 items-center justify-center rounded-full border bg-background text-foreground shadow-sm hover:bg-muted"
-                    onClick={handleClear}
-                    onKeyDown={(e) => {
-                      if (e.key === "Enter" || e.key === " ") {
-                        e.preventDefault();
-                        onAgentChange(null);
-                      }
-                    }}
-                  >
-                    <XIcon className="size-2.5" />
-                  </span>
-                )}
-              </Button>
-            </Tooltip>
-          ) : (
+        {iconMode ? (
+          <Tooltip content={iconTooltipLabel}>
+            <div>
+              <DialogTrigger asChild>
+                <Button
+                  type="button"
+                  variant="ghost"
+                  size="icon"
+                  disabled={disabled}
+                  aria-label={selectedAgent ? `已选择智能体：${triggerLabel}` : "选择智能体"}
+                  className={cn(
+                    "relative size-9 rounded-full text-muted-foreground shadow-none hover:bg-muted/60 hover:text-foreground",
+                    selectedAgent && "text-amber-600 hover:text-amber-700",
+                    selectedAgent && iconActiveClassName,
+                    iconButtonClassName,
+                  )}
+                >
+                  <BotIcon className="size-4" />
+                  {selectedAgent && (
+                    <span
+                      role="button"
+                      tabIndex={0}
+                      aria-label="清除已选 agent"
+                      className="absolute -right-1 -top-1 inline-flex size-4 items-center justify-center rounded-full border bg-background text-foreground shadow-sm hover:bg-muted"
+                      onClick={handleClear}
+                      onKeyDown={(e) => {
+                        if (e.key === "Enter" || e.key === " ") {
+                          e.preventDefault();
+                          onAgentChange(null);
+                        }
+                      }}
+                    >
+                      <XIcon className="size-2.5" />
+                    </span>
+                  )}
+                </Button>
+              </DialogTrigger>
+            </div>
+          </Tooltip>
+        ) : (
+          <DialogTrigger asChild>
             <PromptInputButton
               type="button"
               disabled={disabled}
@@ -167,8 +171,8 @@ export function AgentSelector({
                 </span>
               )}
             </PromptInputButton>
-          )}
-        </DialogTrigger>
+          </DialogTrigger>
+        )}
         <DialogContent className="overflow-hidden p-0 sm:max-w-md">
           <DialogTitle className="sr-only">选择 Agent</DialogTitle>
           <Command className="**:data-[slot=command-input-wrapper]:h-auto">

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

@@ -45,11 +45,32 @@ function skillLabel(skill: Skill) {
 
 function matchesQuery(skill: Skill, q: string) {
   if (!q) return true;
-  return (
-    skill.name.toLowerCase().includes(q) ||
-    (skill.name_zh ?? "").toLowerCase().includes(q) ||
-    (skill.description ?? "").toLowerCase().includes(q)
-  );
+  const haystack = [
+    skill.name,
+    skill.name_zh,
+    skill.description,
+    skill.detail,
+    skill.category,
+    skill.license,
+    skill.source,
+    skill.state,
+    skill.owner_username,
+    skill.created_at,
+    skill.last_activity_at,
+    skill.use_count != null ? `使用 ${skill.use_count}` : null,
+    skill.view_count != null ? `查看 ${skill.view_count}` : null,
+    skill.patch_count != null ? `变迁 ${skill.patch_count}` : null,
+    ...(skill.tags ?? []).flatMap((tag) => [
+      tag.name,
+      tag.description,
+      tag.color,
+      tag.usage_count != null ? `标签使用 ${tag.usage_count}` : null,
+    ]),
+  ]
+    .filter((value): value is string => typeof value === "string" && value.length > 0)
+    .join(" ")
+    .toLowerCase();
+  return haystack.includes(q);
 }
 
 export function SkillTransferSelector({
@@ -159,7 +180,7 @@ export function SkillTransferSelector({
         <div className="relative flex-1">
           <SearchIcon className="text-muted-foreground absolute left-2 top-1/2 size-3.5 -translate-y-1/2" />
           <Input
-            placeholder="搜索全部技能(中英文名称、描述)…"
+            placeholder="搜索技能名称、描述、分类、标签、变迁..."
             value={search}
             onChange={(e) => {
               setSearch(e.currentTarget.value);
@@ -239,7 +260,7 @@ export function SkillTransferSelector({
       {/* Two-column transfer panes */}
       <div className="grid grid-cols-2 gap-3">
         <SkillPane
-          title="可用技能"
+          title="未勾选技能"
           count={availableSkills.length}
           items={availableView}
           variant="available"
@@ -248,10 +269,10 @@ export function SkillTransferSelector({
           onPageChange={setAvailablePage}
           onPick={add}
           onViewDetail={onViewDetail}
-          emptyHint={query || category !== ALL_CATEGORIES ? "没有匹配的技能" : "已全部启用"}
+          emptyHint={query || category !== ALL_CATEGORIES ? "没有匹配的技能" : "已全部勾选"}
         />
         <SkillPane
-          title="已启用技能"
+          title="已勾选技能"
           count={selectedSkills.length}
           items={selectedView}
           variant="selected"
@@ -260,7 +281,7 @@ export function SkillTransferSelector({
           onPageChange={setSelectedPage}
           onPick={remove}
           onViewDetail={onViewDetail}
-          emptyHint={query ? "没有匹配的已选技能" : "尚未启用任何技能"}
+          emptyHint={query ? "没有匹配的已选技能" : "尚未勾选任何技能"}
         />
       </div>
     </div>

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

@@ -1,7 +1,7 @@
 "use client";
 
 import { Check, ExternalLink, LayoutIcon, PanelLeftIcon, Shirt } from "lucide-react";
-import { useEffect, useRef, useState } from "react";
+import { useEffect, useMemo, useRef, useState } from "react";
 import { useNavigate } from "react-router-dom";
 
 import { Button } from "@/components/ui/button";
@@ -15,6 +15,8 @@ import {
 } from "@/components/ui/dropdown-menu";
 import { useTheme, type ThemeType } from "@/contexts/ThemeContext";
 import { useAppearanceSettings, useLayoutMode } from "@/core/system-settings/hooks";
+import { isHideChromeActive } from "@/core/embed/embed-session";
+import { env } from "@/env";
 import { cn } from "@/lib/utils";
 import { buildLightAppUrl } from "@/strategy-components/lib/light-app";
 
@@ -24,12 +26,15 @@ import { buildLightAppUrl } from "@/strategy-components/lib/light-app";
  *   - "banner-dark" / "banner-light"：Header 落在主题 banner 上（白字 / 浅色 hover）。
  *   - "content"：简洁模式聊天页浅底顶栏，走 foreground / muted-foreground。
  */
-export type AppearanceControlTone = "banner-dark" | "banner-light" | "content";
+export type AppearanceControlTone = "banner-dark" | "banner-light" | "banner-custom" | "content";
 
-// 换肤色板：红色=红白主题(light)，蓝色=浅蓝主题(lightblue)，深蓝色=深色主题(dark)
+// 换肤色板：红色=红白主题(light)，蓝色=浅蓝主题(lightblue)，冰川蓝=柔和浅蓝主题(iceblue)，浅黄色=柔和黄主题(lightyellow)，深蓝色=深色主题(dark)
 export const THEME_SWATCHES: { id: ThemeType; label: string; color: string }[] = [
   { id: "light", label: "红色", color: "#cf1322" },
+  { id: "lightgreen", label: "绿色", color: "#07c05f" },
   { id: "lightblue", label: "蓝色", color: "#0062d9" },
+  { id: "iceblue", label: "冰川蓝", color: "#9BCEF1" },
+  { id: "lightyellow", label: "浅黄色", color: "#F3FBD9" },
   { id: "dark", label: "深蓝色", color: "#002466" },
 ];
 
@@ -38,6 +43,8 @@ const triggerToneClass = (tone: AppearanceControlTone) =>
     ? "text-slate-400 hover:bg-slate-800/50 hover:text-slate-400"
     : tone === "banner-light"
       ? "text-white hover:bg-[var(--brand-950)] hover:text-white active:bg-[#8a0618]"
+      : tone === "banner-custom"
+        ? "text-[var(--navigation-foreground)] hover:bg-white/20 hover:text-[var(--navigation-foreground)] active:bg-white/30"
       : "text-muted-foreground hover:bg-muted hover:text-foreground";
 
 export function CompactShortcutButtons({ tone }: { tone: AppearanceControlTone }) {
@@ -79,8 +86,23 @@ export function CompactShortcutButtons({ tone }: { tone: AppearanceControlTone }
 
 export function ThemeSwitcher({ tone }: { tone: AppearanceControlTone }) {
   const { theme, setTheme } = useTheme();
+  const { data: appearance } = useAppearanceSettings();
   const [open, setOpen] = useState(false);
   const closeTimer = useRef<ReturnType<typeof setTimeout> | null>(null);
+  const swatches = useMemo(
+    () => [
+      ...THEME_SWATCHES,
+      ...(appearance?.custom_themes ?? [])
+        .filter((preset) => preset.enabled)
+        .sort((a, b) => a.sort_order - b.sort_order)
+        .map((preset) => ({
+          id: preset.id as ThemeType,
+          label: preset.name,
+          color: preset.primary,
+        })),
+    ],
+    [appearance?.custom_themes],
+  );
 
   const cancelClose = () => {
     if (closeTimer.current) {
@@ -95,6 +117,8 @@ export function ThemeSwitcher({ tone }: { tone: AppearanceControlTone }) {
 
   useEffect(() => () => cancelClose(), []);
 
+  if (env.FORCE_COLLAPSED_SIDEBAR || isHideChromeActive()) return null;
+
   return (
     <div
       className="relative"
@@ -117,9 +141,9 @@ export function ThemeSwitcher({ tone }: { tone: AppearanceControlTone }) {
       </Button>
       {open ? (
         <div className="absolute top-full left-1/2 z-50 -translate-x-1/2 pt-2">
-          <div className="relative flex items-center gap-2 rounded-lg border border-black/5 bg-white px-2.5 py-1.5 shadow-lg">
-            <div className="absolute -top-1 left-1/2 size-2 -translate-x-1/2 rotate-45 rounded-[1px] border-t border-l border-black/5 bg-white" />
-            {THEME_SWATCHES.map((swatch) => {
+          <div className="relative flex max-w-64 flex-wrap items-center justify-center gap-2 rounded-lg border border-border bg-popover px-2.5 py-1.5 shadow-lg">
+            <div className="absolute -top-1 left-1/2 size-2 -translate-x-1/2 rotate-45 rounded-[1px] border-t border-l border-border bg-popover" />
+            {swatches.map((swatch) => {
               const active = theme === swatch.id;
               return (
                 <button
@@ -185,6 +209,8 @@ export function LayoutModeSwitcher({
   const current = mode ?? fallback;
   const TriggerIcon = current === "full" ? PanelLeftIcon : LayoutIcon;
 
+  if (env.FORCE_COLLAPSED_SIDEBAR || isHideChromeActive()) return null;
+
   return (
     <DropdownMenu>
       <DropdownMenuTrigger asChild>

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

@@ -123,13 +123,14 @@ export function ArtifactFileDetail({
   className,
   filepath: filepathFromProps,
   threadId,
-  onClose,
-  allowVirtualMarkdownEdit = false,
-  disableDesensitize = false,
-}: {
-  className?: string;
-  filepath: string;
-  threadId: string;
+  onClose,
+  allowVirtualMarkdownEdit = false,
+  disableDesensitize = false,
+  hideFileName = false,
+}: {
+  className?: string;
+  filepath: string;
+  threadId: string;
   /** 覆盖默认关闭行为（仅 setOpen(false)）；圆桌 Step3 文件预览用于退出沙箱模式。 */
   onClose?: () => void;
   /**
@@ -142,9 +143,10 @@ export function ArtifactFileDetail({
    * 关闭对预览内容的脱敏。多智能体会商页的「消息列表沙箱」按需求**不脱敏**沙箱内的
    * 产物内容（用户要拿原始文件），故 Step2SandboxLayout 传 true；主聊天等其它调用方
    * 默认 false，沿用全局脱敏。
-   */
-  disableDesensitize?: boolean;
-}) {
+   */
+  disableDesensitize?: boolean;
+  hideFileName?: boolean;
+}) {
   const { t } = useI18n();
   const { artifacts, setOpen, select } = useArtifacts();
   const { isMock, thread, publicShareCode } = useThread();
@@ -222,10 +224,11 @@ export function ArtifactFileDetail({
   const canUseAiEditor = canEditArtifact;
   const [draftContent, setDraftContent] = useState("");
   const [hasLocalEdits, setHasLocalEdits] = useState(false);
-  const updateArtifact = useUpdateArtifactContent();
-  const displayContent = canEditArtifact ? draftContent : (content ?? "");
-  const isHtmlStreaming = language === "html" && thread.isLoading;
-  const hasMultipleArtifacts = (artifacts?.length ?? 0) > 1;
+  const updateArtifact = useUpdateArtifactContent();
+  const displayContent = canEditArtifact ? draftContent : (content ?? "");
+  const isAutoPreviewLanguage = language === "html" || language === "markdown";
+  const isPreviewStreaming = isAutoPreviewLanguage && thread.isLoading;
+  const hasMultipleArtifacts = (artifacts?.length ?? 0) > 1;
   const fileTypeLabel = useMemo(() => {
     if (isImageFile(filepath)) return "IMG";
     if (isSpreadsheetFile) return "XLSX";
@@ -264,29 +267,36 @@ export function ArtifactFileDetail({
     setDraftContent(content ?? "");
   }, [canEditArtifact, content, hasLocalEdits]);
 
-  useEffect(() => {
-    setAllowAutoViewSwitch(true);
-    setAutoScrollEnabled(true);
-    setShowResumeAutoScroll(false);
-
-    if (language === "html") {
-      setViewMode(thread.isLoading ? "code" : "preview");
-      return;
-    }
-
-    // md/mermaid 默认预览（AI 写作视图作为可选切换项，由用户手动进入）。
-    if (isSupportPreview) {
-      setViewMode("preview");
-      return;
-    }
-
-    setViewMode("code");
-  }, [filepathFromProps, isSupportPreview, language, thread.isLoading]);
-
-  useEffect(() => {
-    if (!allowAutoViewSwitch || language !== "html") {
-      return;
-    }
+  useEffect(() => {
+    setAllowAutoViewSwitch(true);
+    setAutoScrollEnabled(true);
+    setShowResumeAutoScroll(false);
+    setShowPreviewSwitchPulse(false);
+  }, [filepathFromProps]);
+
+  useEffect(() => {
+    if (isPreviewStreaming) {
+      setViewMode("code");
+      return;
+    }
+
+    if (language === "html") {
+      setViewMode(thread.isLoading ? "code" : "preview");
+      return;
+    }
+
+    if (isSupportPreview) {
+      setViewMode("preview");
+      return;
+    }
+
+    setViewMode("code");
+  }, [isPreviewStreaming, isSupportPreview, language, thread.isLoading]);
+
+  useEffect(() => {
+    if (!allowAutoViewSwitch || !isAutoPreviewLanguage) {
+      return;
+    }
 
     if (thread.isLoading) {
       setViewMode("code");
@@ -298,9 +308,9 @@ export function ArtifactFileDetail({
     const timeoutId = window.setTimeout(() => {
       setShowPreviewSwitchPulse(false);
     }, 1400);
-
-    return () => window.clearTimeout(timeoutId);
-  }, [allowAutoViewSwitch, language, thread.isLoading]);
+
+    return () => window.clearTimeout(timeoutId);
+  }, [allowAutoViewSwitch, isAutoPreviewLanguage, isSupportPreview, thread.isLoading]);
 
   const scrollArtifactToBottom = useCallback(
     (behavior: ScrollBehavior = "auto") => {
@@ -583,7 +593,8 @@ export function ArtifactFileDetail({
             <span className="bg-background text-muted-foreground inline-flex h-7 shrink-0 items-center rounded-full border border-black/6 px-2.5 text-[10px] font-semibold tracking-[0.16em] dark:border-white/8">
               {fileTypeLabel}
             </span>
-            <ArtifactTitle className="min-w-0">
+            {!hideFileName && (
+            <ArtifactTitle className="min-w-0">
               {/* markdown：隐藏文件名（仅留 MD 徽标），把横向空间让给工具栏，避免窄面板下
                   工具栏换行错位；多文件仍保留切换下拉（靠它切文件）。文件名仍可在下载/另存为时取到。 */}
               {language === "markdown" && !hasMultipleArtifacts ? null : useWriteFileStreaming ? (
@@ -606,7 +617,8 @@ export function ArtifactFileDetail({
               ) : (
                 <div className="truncate px-3">{getFileName(filepath)}</div>
               )}
-            </ArtifactTitle>
+            </ArtifactTitle>
+            )}
           </div>
         </div>
         <div className="flex w-full items-center justify-center md:w-auto md:flex-1">
@@ -652,10 +664,10 @@ export function ArtifactFileDetail({
                   <EyeIcon />
                 </ToggleGroupItem>
               </ToggleGroup>
-              {isHtmlStreaming && (
-                <div className="animate-[sandbox-preview-badge_1.4s_ease-in-out_infinite] text-muted-foreground bg-muted/80 inline-flex items-center rounded-full border px-2.5 py-1 text-[11px]">
-                  <span className="bg-primary mr-2 size-1.5 animate-pulse rounded-full" />
-                  正在生成，完成后自动预览
+              {isPreviewStreaming && (
+                <div className="animate-[sandbox-preview-badge_1.4s_ease-in-out_infinite] text-muted-foreground bg-muted/80 inline-flex items-center rounded-full border px-2.5 py-1 text-[11px]">
+                  <span className="bg-primary mr-2 size-1.5 animate-pulse rounded-full" />
+                  正在生成，完成后自动预览
                 </div>
               )}
             </div>

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

@@ -23,28 +23,34 @@ import { useThread } from "../messages/context";
 import { useArtifacts } from "./context";
 import { SkillInstallDialog } from "./skill-install-dialog";
 
-export function ArtifactFileList({
-  className,
-  files,
-  threadId,
-}: {
-  className?: string;
-  files: string[];
-  threadId: string;
-}) {
+export function ArtifactFileList({
+  className,
+  files,
+  threadId,
+  onOpenArtifact,
+}: {
+  className?: string;
+  files: string[];
+  threadId: string;
+  onOpenArtifact?: (filepath: string) => void;
+}) {
   const { t } = useI18n();
   const { isMock, publicShareCode } = useThread();
   const { select: selectArtifact, setOpen } = useArtifacts();
   const [installFile, setInstallFile] = useState<string | null>(null);
   const [downloadingFile, setDownloadingFile] = useState<string | null>(null);
 
-  const handleClick = useCallback(
-    (filepath: string) => {
-      selectArtifact(filepath);
-      setOpen(true);
-    },
-    [selectArtifact, setOpen],
-  );
+  const handleClick = useCallback(
+    (filepath: string) => {
+      if (onOpenArtifact) {
+        onOpenArtifact(filepath);
+        return;
+      }
+      selectArtifact(filepath);
+      setOpen(true);
+    },
+    [onOpenArtifact, selectArtifact, setOpen],
+  );
 
   const handleInstallSkill = useCallback(
     (e: React.MouseEvent, filepath: string) => {

frontend-web/src/components/workspace/cm-chat-sidebar.tsx

@@ -1,204 +0,0 @@
-"use client";
-
-import {
-  BookOpenCheck,
-  Brain,
-  CalendarClock,
-  MessageSquare,
-  MessageSquarePlus,
-  PanelLeftClose,
-  PenLine,
-  Settings,
-  Sparkles,
-  UsersRound,
-} from "lucide-react";
-import Link from "next/link";
-import { usePathname } from "next/navigation";
-import type { MouseEvent } from "react";
-import { useNavigate } from "react-router-dom";
-
-import { cn } from "@/lib/utils";
-
-import { AgentBrandIcon } from "./agents/agent-brand-icon";
-import { RecentChatList } from "./recent-chat-list";
-import { WorkspaceNavMenu } from "./workspace-nav-menu";
-
-const NEW_CHAT_PATH = "/page/workspace/chats/new";
-
-type NavItem = {
-  label: string;
-  href: string;
-  icon: typeof MessageSquare;
-  match: string;
-};
-
-const NAV_ITEMS: NavItem[] = [
-  { label: "新建对话", href: NEW_CHAT_PATH, icon: MessageSquarePlus, match: NEW_CHAT_PATH },
-  { label: "对话", href: "/page/workspace/chats", icon: MessageSquare, match: "/page/workspace/chats" },
-  { label: "智能体", href: "/page/workspace/agents", icon: Sparkles, match: "/page/workspace/agents" },
-  { label: "技能", href: "/page/workspace/skills", icon: Sparkles, match: "/page/workspace/skills" },
-  { label: "记忆", href: "/page/workspace/memory", icon: Brain, match: "/page/workspace/memory" },
-  { label: "AI 写作", href: "/page/workspace/ai-writing", icon: PenLine, match: "/page/workspace/ai-writing" },
-  {
-    label: "多智能体规划",
-    href: "/page/workspace/roundtable/planning",
-    icon: UsersRound,
-    match: "/page/workspace/roundtable",
-  },
-  {
-    label: "定时任务",
-    href: "/page/workspace/scheduled/tasks",
-    icon: CalendarClock,
-    match: "/page/workspace/scheduled",
-  },
-  { label: "问答梳理", href: "/page/workspace/knowledge", icon: BookOpenCheck, match: "/page/workspace/knowledge" },
-] as const;
-
-export function CmChatSidebar({
-  onCollapse,
-  collapsed = false,
-}: {
-  onCollapse?: () => void;
-  collapsed?: boolean;
-}) {
-  const pathname = usePathname();
-  const navigate = useNavigate();
-
-  const handleNewChat = (event: MouseEvent<HTMLAnchorElement>) => {
-    if (event.metaKey || event.ctrlKey || event.shiftKey || event.button === 1) return;
-    event.preventDefault();
-    navigate(NEW_CHAT_PATH, { replace: true, state: { resetAt: Date.now() } });
-  };
-
-  if (collapsed) {
-    return (
-      <aside className="flex h-full min-h-0 w-14 flex-col border-r border-slate-200/80 bg-white text-slate-700 dark:border-slate-800 dark:bg-slate-950 dark:text-slate-200">
-        <button
-          type="button"
-          onClick={onCollapse}
-          aria-label="展开侧边栏"
-          title="展开侧边栏"
-          className="mx-auto mt-2 flex size-11 shrink-0 items-center justify-center rounded-xl transition-colors hover:bg-slate-100 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500/40 dark:hover:bg-slate-900"
-        >
-          <img
-            src="/cm-assistant-logo.png"
-            alt="CM 助手"
-            className="size-10 object-contain"
-          />
-        </button>
-        <div className="mx-2 mt-2 h-px shrink-0 bg-slate-200/80 dark:bg-slate-800" />
-
-        <nav className="flex shrink-0 flex-col items-center gap-1 px-2 py-3" aria-label="工作台导航">
-          {NAV_ITEMS.map((item) => {
-            const active = item.href === NEW_CHAT_PATH
-              ? pathname === NEW_CHAT_PATH
-              : item.href === "/page/workspace/chats"
-                ? pathname.startsWith(item.match) && pathname !== NEW_CHAT_PATH
-                : pathname.startsWith(item.match);
-            const Icon = item.icon;
-            return (
-              <Link
-                key={item.href}
-                href={item.href}
-                onClick={item.href === NEW_CHAT_PATH ? handleNewChat : undefined}
-                aria-current={active ? "page" : undefined}
-                aria-label={item.label}
-                title={item.label}
-                className={cn(
-                  "flex size-10 items-center justify-center rounded-xl transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500/40",
-                  active
-                    ? "bg-[#edf4ff] text-[#165ee8] dark:bg-blue-500/15 dark:text-blue-300"
-                    : "text-slate-600 hover:bg-slate-100 hover:text-slate-950 dark:text-slate-300 dark:hover:bg-slate-900 dark:hover:text-white",
-                )}
-              >
-                {item.href === "/page/workspace/agents" ? (
-                  <AgentBrandIcon size="nav" />
-                ) : (
-                  <Icon className="size-[19px]" strokeWidth={1.8} />
-                )}
-                <span className="sr-only">{item.label}</span>
-              </Link>
-            );
-          })}
-        </nav>
-
-        <div className="mt-auto flex shrink-0 justify-center border-t border-slate-200/80 py-3 dark:border-slate-800">
-          <Link
-            href="/page/workspace/settings"
-            aria-label="设置和更多"
-            title="设置和更多"
-            className="flex size-10 items-center justify-center rounded-xl text-slate-600 transition-colors hover:bg-slate-100 hover:text-slate-950 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500/40 dark:text-slate-300 dark:hover:bg-slate-900 dark:hover:text-white"
-          >
-            <Settings className="size-[19px]" strokeWidth={1.8} />
-          </Link>
-        </div>
-      </aside>
-    );
-  }
-
-  return (
-    <div className="flex h-full min-h-0 flex-col overflow-hidden border-r border-slate-200/80 bg-white text-slate-900 dark:border-slate-800 dark:bg-slate-950 dark:text-slate-100">
-      <div className="flex shrink-0 items-center gap-2 px-6 pt-4 pb-3">
-        <Link href={NEW_CHAT_PATH} className="flex min-w-0 flex-1 items-center gap-3.5 outline-none focus-visible:ring-2 focus-visible:ring-blue-500/40">
-          <img
-            src="/cm-assistant-logo.png"
-            alt="CM 助手"
-            className="size-10 shrink-0 object-contain"
-          />
-          <span className="truncate text-[20px] font-semibold tracking-[-0.025em]">CM 助手</span>
-        </Link>
-        <button
-          type="button"
-          onClick={onCollapse}
-          aria-label="收起侧边栏"
-          title="收起侧边栏"
-          className="flex size-8 shrink-0 items-center justify-center rounded-md text-slate-500 transition-colors hover:bg-slate-100 hover:text-slate-900 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500/40 dark:hover:bg-slate-900 dark:hover:text-white"
-        >
-          <PanelLeftClose className="size-[18px]" strokeWidth={1.8} />
-        </button>
-      </div>
-
-      <nav className="shrink-0 px-4 pt-1" aria-label="工作台导航">
-        <div className="space-y-1">
-          {NAV_ITEMS.map((item) => {
-            const active = item.href === NEW_CHAT_PATH
-              ? pathname === NEW_CHAT_PATH
-              : item.href === "/page/workspace/chats"
-                ? pathname.startsWith(item.match) && pathname !== NEW_CHAT_PATH
-                : pathname.startsWith(item.match);
-            const Icon = item.icon;
-            return (
-              <Link
-                key={item.href}
-                href={item.href}
-                onClick={item.href === NEW_CHAT_PATH ? handleNewChat : undefined}
-                aria-current={active ? "page" : undefined}
-                className={cn(
-                  "flex h-11 items-center gap-3 rounded-xl px-4 text-[14px] font-medium transition-colors",
-                  active
-                    ? "bg-[#edf4ff] text-[#165ee8] dark:bg-blue-500/15 dark:text-blue-300"
-                    : "text-slate-600 hover:bg-slate-100 hover:text-slate-950 dark:text-slate-300 dark:hover:bg-slate-900 dark:hover:text-white",
-                )}
-              >
-                {item.href === "/page/workspace/agents" ? (
-                  <AgentBrandIcon size="nav" />
-                ) : (
-                  <Icon className="size-[18px] shrink-0" strokeWidth={1.8} />
-                )}
-                <span>{item.label}</span>
-              </Link>
-            );
-          })}
-        </div>
-      </nav>
-
-      <div className="min-h-0 flex-1 overflow-y-auto px-1">
-        <RecentChatList compact limit={5} moreHref="/page/workspace/chats" />
-      </div>
-
-      <div className="shrink-0 border-t border-slate-200/80 px-3 py-3 dark:border-slate-800">
-        <WorkspaceNavMenu />
-      </div>
-    </div>
-  );
-}

frontend-web/src/components/workspace/compact-welcome.tsx

@@ -1,6 +1,12 @@
 "use client";
 
+import { useState } from "react";
+
+import { useTheme } from "@/contexts/ThemeContext";
+import { getWelcomeBrandAsset } from "@/core/branding/brand-assets";
+import { readRuntimeFlag } from "@/env";
 import { cn } from "@/lib/utils";
+import { useDisplayDesensitizer } from "@/core/sensitive-words/use-display-desensitizer";
 
 /**
  * 紧凑模式（正常 App）新对话落地页的品牌欢迎块 —— 按 CM-assistant 参考图重画。
@@ -8,18 +14,63 @@ import { cn } from "@/lib/utils";
  * 非紧凑模式仍用 <Welcome/>，本组件不参与。
  */
 export function CompactWelcome({ className }: { className?: string }) {
+  const desensitizeText = useDisplayDesensitizer();
+  const { theme } = useTheme();
+  const brandTheme = theme;
+  const welcomeLogo = getWelcomeBrandAsset(brandTheme);
+  const [failedWelcomeLogo, setFailedWelcomeLogo] = useState<string | null>(null);
+  const shouldShowWelcomeLogo =
+    Boolean(welcomeLogo) && failedWelcomeLogo !== welcomeLogo;
+  const isWelcomeLogoVisible = readRuntimeFlag("VITE_WELCOME_LOGO_VISIBLE");
+
   return (
     <div
       className={cn(
-        "mx-auto flex w-full flex-col items-center justify-center text-center",
+        "mx-auto flex w-full flex-col items-center justify-center text-center select-none",
         className,
       )}
     >
-      <h1 className="flex items-center justify-center text-[34px] font-semibold tracking-[-0.035em] text-slate-950 dark:text-slate-50">
-        你好，欢迎使用 CM 助手
+      {/* CM logo：浅底圆环 + 主色渐变圆角方块 */}
+      {/* Controlled by VITE_WELCOME_LOGO_VISIBLE in runtime-config.js. */}
+      {isWelcomeLogoVisible && (
+      <div
+        className="mb-3.5 inline-flex items-center justify-center rounded-full p-3"
+        style={{
+          backgroundColor:
+            "rgb(var(--legacy-workspace-brand-rgb) / 5%)",
+          border:
+            "1px solid rgb(var(--legacy-workspace-brand-rgb) / 12%)",
+        }}
+      >
+        {shouldShowWelcomeLogo && welcomeLogo ? (
+          <img
+            src={welcomeLogo}
+            alt=""
+            aria-hidden="true"
+            className="size-16 object-contain"
+            onError={() => setFailedWelcomeLogo(welcomeLogo)}
+          />
+        ) : (
+          <div
+            className="flex size-14 items-center justify-center rounded-2xl shadow-md"
+            style={{
+              backgroundImage:
+                "linear-gradient(to top right, var(--workspace-brand), var(--brand-200))",
+            }}
+          >
+            <span className="text-2xl font-black tracking-wide text-white italic">
+              {desensitizeText("CM")}
+            </span>
+          </div>
+        )}
+      </div>
+      )}
+
+      <h1 className="flex items-center justify-center text-2xl font-bold tracking-tight text-foreground/90">
+        {desensitizeText("欢迎使用CM助手")}
       </h1>
-      <p className="mx-auto mt-2.5 max-w-xl text-[15px] leading-6 text-slate-500 dark:text-slate-400">
-        我可以帮你写作、问答、分析和规划各类内容，让工作更高效
+      <p className="text-muted-foreground mx-auto mt-2 max-w-sm text-xs leading-relaxed">
+        基于先进深度推理模型，为您提供高效的市场分析、专业报告撰写、调研设计与协同脑暴支持。
       </p>
     </div>
   );

frontend-web/src/components/workspace/custom-prompt-menu.tsx

@@ -46,12 +46,10 @@ export function CustomPromptBar({
   onInsert,
   className,
   currentAgentId,
-  compact = false,
 }: {
   onInsert: (content: string) => void;
   className?: string;
   currentAgentId?: string | null;
-  compact?: boolean;
 }) {
   const allPrompts = useCustomPrompts();
   const prompts = allPrompts.filter(
@@ -83,13 +81,7 @@ export function CustomPromptBar({
 
   return (
     <>
-      <div
-        className={cn(
-          "flex min-w-0 items-center gap-1",
-          compact && "min-h-9 justify-end",
-          className,
-        )}
-      >
+      <div className={cn("flex min-w-0 items-center gap-1", className)}>
         {prompts.length > 0 && (
           <>
             {overflowing && (
@@ -119,7 +111,6 @@ export function CustomPromptBar({
                     title={prompt.content}
                     className={cn(
                       "border-border/60 bg-muted/40 text-foreground/80 hover:bg-muted hover:text-foreground hover:border-border max-w-[200px] shrink-0 truncate rounded-full border px-3 py-1 text-xs font-medium shadow-sm transition-colors",
-                      compact && "border-slate-200 bg-white px-3.5 py-1.5 text-[12px] text-slate-600 shadow-none hover:border-blue-200 hover:bg-blue-50/60 hover:text-blue-700",
                       "dark:border-slate-600/70 dark:bg-slate-700/40 dark:text-slate-200 dark:hover:bg-slate-700",
                     )}
                   >
@@ -148,11 +139,7 @@ export function CustomPromptBar({
           type="button"
           variant="ghost"
           size="icon"
-          className={cn(
-            "text-muted-foreground hover:text-foreground hover:bg-muted/70 h-7 w-7 shrink-0 rounded-full",
-            compact &&
-              "h-9 w-9 rounded-xl border border-slate-200 bg-white text-slate-600 shadow-[0_6px_18px_-14px_rgba(15,23,42,0.4)] hover:border-blue-200 hover:bg-blue-50 hover:text-blue-700 dark:border-slate-700 dark:bg-slate-900",
-          )}
+          className="text-muted-foreground hover:text-foreground hover:bg-muted/70 h-7 w-7 shrink-0 rounded-full"
           title="管理常用提示词"
           aria-label="管理常用提示词"
           onClick={() => setManageOpen(true)}

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

@@ -83,6 +83,7 @@ import {
   sortThreadsPinnedFirst,
   titleOfThread,
 } from "@/core/threads/utils";
+import { buildFullChatNavigationPath } from "@/core/page-layout/chats-iframe-route";
 import { env } from "@/env";
 import { desensitize } from "@/lib/desensitize";
 import { isIMEComposing } from "@/lib/ime";
@@ -185,15 +186,24 @@ export function GeneralQaSidebar() {
   // 当前嵌入的智能体（URL 上的 ?agent=）：用于高亮对应卡片。
   const searchParams = useSearchParams();
   const activeAgentId = searchParams.get("agent");
+  const currentSearch = searchParams.toString();
+  const newChatHref = buildFullChatNavigationPath(NEW_CHAT_PATH, currentSearch);
+  const moreAgentsHref = buildFullChatNavigationPath(MORE_AGENTS_HREF, currentSearch);
+  const moreChatsHref = buildFullChatNavigationPath(MORE_CHATS_HREF, currentSearch);
 
   // 点击常用智能体 = 在通用问答右侧**原地嵌入**该智能体的对话页：停留在 /chats/new，
   // 仅给 URL 加 ?agent=<id>，由 NewChatContent 把右侧问答区换成 AgentChatPage。
   // 不跳转独立页面、左侧栏不变。每次点击都重开一个干净会话（NewChatContent 的 key）。
   const handleSelectAgent = useCallback(
     (agentId: string) => {
-      navigate(`/page/workspace/chats/new?agent=${encodeURIComponent(agentId)}`);
+      navigate(
+        buildFullChatNavigationPath(
+          `${NEW_CHAT_PATH}?agent=${encodeURIComponent(agentId)}`,
+          currentSearch,
+        ),
+      );
     },
-    [navigate],
+    [currentSearch, navigate],
   );
 
   // ── 最近的对话取数 + 搜索 ──
@@ -241,7 +251,7 @@ export function GeneralQaSidebar() {
   const handleNewChatClick = (event: React.MouseEvent<HTMLAnchorElement>) => {
     if (event.metaKey || event.ctrlKey || event.shiftKey || event.button === 1) return;
     event.preventDefault();
-    navigate(NEW_CHAT_PATH, { replace: true, state: { resetAt: Date.now() } });
+    navigate(newChatHref, { replace: true, state: { resetAt: Date.now() } });
   };
 
   const handleDelete = useCallback(
@@ -257,10 +267,17 @@ export function GeneralQaSidebar() {
             nextThreadPath = listPathOfThread(threads[threadIndex - 1]!);
           }
         }
-        void router.push(nextThreadPath);
+        void router.push(buildFullChatNavigationPath(nextThreadPath, currentSearch));
       }
     },
-    [agentIdFromPath, deleteThread, router, threadIdFromPath, threads],
+    [
+      agentIdFromPath,
+      currentSearch,
+      deleteThread,
+      router,
+      threadIdFromPath,
+      threads,
+    ],
   );
 
   const handleRenameClick = useCallback((threadId: string, currentTitle: string) => {
@@ -314,11 +331,11 @@ export function GeneralQaSidebar() {
             底色用「主色混入透明」=主色低透明度叠在当前侧栏底色上，浅/红/蓝/深蓝主题都自适应
             （不要混 white，否则深蓝主题下会变成浅色块）。 */}
         <Link
-          href={NEW_CHAT_PATH}
+          href={newChatHref}
           onClick={handleNewChatClick}
           style={{ borderColor: "var(--primary)", color: "var(--primary)" }}
           className={cn(
-            "flex h-10 min-w-0 flex-1 items-center justify-center gap-1.5 rounded-[5px] text-[14px] font-semibold transition-colors",
+            "gq-new-chat-button flex h-10 min-w-0 flex-1 items-center justify-center gap-1.5 rounded-[5px] text-[14px] font-semibold transition-colors",
             "border border-solid",
             "bg-[rgb(var(--legacy-primary-rgb)/14%)] hover:bg-[rgb(var(--legacy-primary-rgb)/24%)]",
           )}
@@ -342,7 +359,7 @@ export function GeneralQaSidebar() {
               <div className="mt-1 flex flex-col gap-1">
                 {frequent.map((agent) => {
                   const isActive = activeAgentId === agent.id;
-                  const { from, to } = agentColor(agent.id, isDark);
+                  const { from, to, foreground } = agentColor(agent.id, theme);
                   return (
                     <button
                       key={agent.id}
@@ -366,7 +383,10 @@ export function GeneralQaSidebar() {
                             isActive &&
                             "ring-2 ring-[#83c1ff]/35 shadow-[0_0_18px_rgba(43,143,254,0.45)]",
                         )}
-                        style={{ backgroundImage: `linear-gradient(135deg, ${from}, ${to})` }}
+                        style={{
+                          backgroundImage: `linear-gradient(135deg, ${from}, ${to})`,
+                          color: foreground,
+                        }}
                       >
                         <Bot className="size-[19px]" />
                       </span>
@@ -412,7 +432,7 @@ export function GeneralQaSidebar() {
                   );
                 })}
                 <Link
-                  href={MORE_AGENTS_HREF}
+                  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>
@@ -451,7 +471,10 @@ export function GeneralQaSidebar() {
                   </div>
                 ) : (
                   filteredThreads.map((thread) => {
-                    const href = listPathOfThread(thread);
+                    const href = buildFullChatNavigationPath(
+                      listPathOfThread(thread),
+                      currentSearch,
+                    );
                     const isActive = href === pathname;
                     const isBoot = isBootstrapThread(thread);
                     const pinned = isThreadPinned(thread);
@@ -464,9 +487,9 @@ export function GeneralQaSidebar() {
                         <Link
                           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",
+                            "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",
                             isActive
-                              ? "border border-primary/40 bg-primary/5 font-medium text-primary"
+                              ? "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",
                           )}
                         >
@@ -573,7 +596,7 @@ export function GeneralQaSidebar() {
                 )}
                 {!query && (
                   <Link
-                    href={MORE_CHATS_HREF}
+                    href={moreChatsHref}
                     className="mt-0.5 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>更多最近对话</span>

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

@@ -1,20 +1,16 @@
 "use client";
 
 import type { ChatStatus } from "ai";
-import {
-  BarChart3Icon,
-  BrainCircuitIcon,
-  BookMarkedIcon,
-  CheckIcon,
-  ClipboardCheckIcon,
-  FileTextIcon,
-  GraduationCapIcon,
-  LightbulbIcon,
-  MessageCircleQuestionIcon,
-  PaperclipIcon,
-  PlusIcon,
-  RefreshCwIcon,
-  ShrinkIcon,
+import {
+  BrainCircuitIcon,
+  BookMarkedIcon,
+  CheckIcon,
+  FileTextIcon,
+  GraduationCapIcon,
+  LightbulbIcon,
+  PaperclipIcon,
+  PlusIcon,
+  ShrinkIcon,
   SparklesIcon,
   RocketIcon,
   XIcon,
@@ -106,58 +102,7 @@ import { useThread } from "./messages/context";
 import { ModeHoverGuide } from "./mode-hover-guide";
 import { Tooltip } from "./tooltip";
 
-type InputMode = "flash" | "thinking" | "pro" | "ultra";
-
-const COMPACT_QUICK_STARTS = [
-  {
-    id: "report",
-    title: "撰写报告",
-    content: "请帮我撰写一份结构清晰的专业报告，先向我确认主题、受众和篇幅要求。",
-    icon: FileTextIcon,
-  },
-  {
-    id: "knowledge",
-    title: "知识问答",
-    content: "请基于已有资料回答我的问题，并明确区分已知事实、推断和需要补充的信息。",
-    icon: MessageCircleQuestionIcon,
-  },
-  {
-    id: "planning",
-    title: "任务规划",
-    content: "请把我的目标拆解为可执行的任务计划，列出优先级、里程碑和风险。",
-    icon: ClipboardCheckIcon,
-  },
-  {
-    id: "analysis",
-    title: "数据分析",
-    content: "请帮我分析数据中的关键趋势、异常和可能原因，并给出下一步验证建议。",
-    icon: BarChart3Icon,
-  },
-  {
-    id: "solution",
-    title: "方案策划",
-    content: "请围绕我的目标设计一套完整方案，包含背景、目标、实施步骤、资源需求和风险预案。",
-    icon: LightbulbIcon,
-  },
-  {
-    id: "summary",
-    title: "内容总结",
-    content: "请提炼我提供内容的核心观点、关键结论和待办事项，并按重要程度整理。",
-    icon: BookMarkedIcon,
-  },
-  {
-    id: "research",
-    title: "调研提纲",
-    content: "请根据我的调研主题生成一份结构完整的调研提纲，覆盖对象、问题、方法和输出形式。",
-    icon: GraduationCapIcon,
-  },
-  {
-    id: "polish",
-    title: "文案润色",
-    content: "请在不改变原意的前提下润色我提供的内容，使表达更清晰、专业、简洁。",
-    icon: SparklesIcon,
-  },
-] as const;
+type InputMode = "flash" | "thinking" | "pro" | "ultra";
 
 
 function getResolvedMode(
@@ -265,41 +210,17 @@ export function InputBox({
   const lastGeneratedForAiIdRef = useRef<string | null>(null);
   const wasStreamingRef = useRef(false);
 
-  const [confirmOpen, setConfirmOpen] = useState(false);
-  const [compactPromptOrder, setCompactPromptOrder] = useState(0);
+  const [confirmOpen, setConfirmOpen] = useState(false);
   const [pendingSuggestion, setPendingSuggestion] = useState<string | null>(
     null,
   );
 
   const { questions: recommendedQuestions } = useRecommendedQuestions();
   const userPreferences = useUserPreferences();
-  const showAdminRecommendedQuestions =
+  const showAdminRecommendedQuestions =
     !hideAdminRecommendedQuestions &&
     !userPreferences.hide_admin_prompt_prefix &&
-    recommendedQuestions.length > 0;
-  const compactQuickStarts = useMemo(() => {
-    if (!hideAdminRecommendedQuestions && recommendedQuestions.length > 0) {
-      return recommendedQuestions.map((configured, index) => {
-        const fallback =
-          COMPACT_QUICK_STARTS[index % COMPACT_QUICK_STARTS.length]!;
-        return {
-          ...fallback,
-          id: configured.id,
-          title: desensitize(configured.title) || `提示词 ${index + 1}`,
-          content: configured.content || fallback.content,
-        };
-      });
-    }
-    return [...COMPACT_QUICK_STARTS];
-  }, [hideAdminRecommendedQuestions, recommendedQuestions]);
-  const orderedCompactQuickStarts = useMemo(() => {
-    if (compactQuickStarts.length < 2) return compactQuickStarts;
-    const offset = compactPromptOrder % compactQuickStarts.length;
-    return [
-      ...compactQuickStarts.slice(offset),
-      ...compactQuickStarts.slice(0, offset),
-    ];
-  }, [compactPromptOrder, compactQuickStarts]);
+    recommendedQuestions.length > 0;
 
   useEffect(() => {
     if (models.length === 0) {
@@ -331,11 +252,10 @@ export function InputBox({
 
   const resolvedModelName = selectedModel?.name;
 
-  const supportThinking = useMemo(
-    () => selectedModel?.supports_thinking ?? false,
-    [selectedModel],
-  );
-  const effectiveMode = getResolvedMode(context.mode, supportThinking);
+  const supportThinking = useMemo(
+    () => selectedModel?.supports_thinking ?? false,
+    [selectedModel],
+  );
 
   const supportReasoningEffort = useMemo(
     () => selectedModel?.supports_reasoning_effort ?? false,
@@ -609,68 +529,14 @@ export function InputBox({
   }, [context.model_name, disabled, isMock, status, thread.messages, threadId]);
 
   return (
-    <div
-      ref={promptRootRef}
-      className={cn(
-        "relative flex flex-col",
-        compact ? "gap-[clamp(32px,6vh,58px)]" : "gap-6",
-      )}
-    >
+    <div ref={promptRootRef} className="relative flex flex-col gap-6">
       {extraHeader && (
         <div className="flex items-center justify-center">
           {extraHeader}
         </div>
       )}
 
-      {isNewThread && searchParams.get("mode") !== "skill" && compact && (
-        <section className="px-2" aria-labelledby="recommended-prompts-title">
-          <div className="mb-3 flex items-center justify-center gap-1.5">
-            <h2
-              id="recommended-prompts-title"
-              className="text-[14px] font-normal text-slate-400 dark:text-slate-500"
-            >
-              你可以这样问我
-            </h2>
-            <button
-              type="button"
-              data-prompt-order-refresh="true"
-              title="调整提示词顺序"
-              aria-label="调整提示词顺序"
-              onClick={() => setCompactPromptOrder((current) => current + 1)}
-              className="flex size-7 items-center justify-center rounded-full text-slate-400 transition-colors hover:bg-slate-100 hover:text-blue-600 focus-visible:outline-none focus-visible:ring-4 focus-visible:ring-blue-500/15 dark:hover:bg-slate-800 dark:hover:text-blue-300"
-            >
-              <RefreshCwIcon className="size-3.5" strokeWidth={1.8} />
-            </button>
-          </div>
-          <div className="mx-auto flex max-w-[900px] flex-wrap justify-center gap-x-3 gap-y-3">
-            {orderedCompactQuickStarts.map((item) => {
-              return (
-                <button
-                  key={item.id}
-                  type="button"
-                  data-quick-prompt={item.id}
-                  title={item.content}
-                  className="inline-flex min-h-11 max-w-full items-center justify-center rounded-xl border border-[#e5e7eb] bg-white px-4 py-2 text-center text-[14px] font-normal leading-5 text-slate-700 shadow-[0_2px_6px_rgba(15,23,42,0.025)] transition-[background-color,border-color,box-shadow] hover:border-slate-300 hover:bg-slate-50 hover:text-slate-900 hover:shadow-[0_4px_10px_rgba(15,23,42,0.04)] focus-visible:outline-none focus-visible:ring-4 focus-visible:ring-blue-500/15 dark:border-slate-700 dark:bg-slate-900 dark:text-slate-200 dark:hover:border-slate-600 dark:hover:bg-slate-800"
-                  onClick={() => {
-                    textInput.setInput(item.content);
-                    requestAnimationFrame(() =>
-                      document
-                        .querySelector<HTMLTextAreaElement>(
-                          "textarea[name='message']",
-                        )
-                        ?.focus(),
-                    );
-                  }}
-                >
-                  <span className="max-w-full whitespace-normal">{item.title}</span>
-                </button>
-              );
-            })}
-          </div>
-        </section>
-      )}
-
-      {isNewThread && searchParams.get("mode") !== "skill" && !compact && showAdminRecommendedQuestions && (
+      {isNewThread && searchParams.get("mode") !== "skill" && showAdminRecommendedQuestions && (
         <div className="flex flex-wrap justify-center gap-2.5 px-4 mb-[10px]">
           {recommendedQuestions.map((q) => (
             <button
@@ -721,10 +587,9 @@ export function InputBox({
         </div>
       )}
       <div className="flex flex-col gap-1.5">
-      {isNewThread && (
-        <CustomPromptBar
-          compact={compact}
-          className={cn(compact ? "px-2" : "px-1")}
+      {isNewThread && (
+        <CustomPromptBar
+          className="px-1"
           currentAgentId={agentSelector?.selectedAgentId ?? assistantId ?? null}
           onInsert={(content) => {
             const current = textInput.value?.trim() ?? "";
@@ -747,8 +612,8 @@ export function InputBox({
             ? "*:data-[slot='input-group']:rounded-2xl *:data-[slot='input-group']:border-0 *:data-[slot='input-group']:bg-transparent *:data-[slot='input-group']:shadow-none"
             : "*:data-[slot='input-group']:rounded-3xl",
           // 紧凑落地态（CM 参考图）：白卡 + 细边 + 轻阴影 + 主色聚焦环（无旋转彩边）
-          compact && isNewThread
-            ? "overflow-hidden rounded-[24px] border border-slate-200/90 bg-white shadow-[0_18px_50px_-32px_rgba(37,99,235,0.6),0_8px_24px_-20px_rgba(15,23,42,0.35)] transition-all duration-300 focus-within:border-blue-300 focus-within:ring-4 focus-within:ring-blue-500/10 dark:border-slate-700 dark:bg-slate-800"
+          compact && isNewThread
+            ? "rounded-2xl border border-gray-200/70 bg-white overflow-hidden shadow-[0_4.5px_22px_rgba(0,0,0,0.025)] transition-all duration-300 focus-within:border-[rgb(var(--legacy-primary-rgb)/35%)] focus-within:ring-4 focus-within:ring-[rgb(var(--legacy-primary-rgb)/5%)] focus-within:shadow-[0_10px_35px_rgb(var(--legacy-primary-rgb)/4%)] dark:border-slate-700 dark:bg-slate-800"
             : // landing 态：透明，让外层 gemini-gradient-border 提供白卡 + 旋转描边
               // 对话态：常规白卡 + 中性边框 + 轻阴影
               isNewThread
@@ -772,8 +637,7 @@ export function InputBox({
             className={cn(
               "size-full px-2 py-1 text-[15px] leading-7 placeholder:text-muted-foreground/60",
               isNewThread && "min-h-[110px]!",
-              compact &&
-                "min-h-[clamp(150px,18vh,176px)]! px-7 pt-7 pb-2 text-[15px]",
+              compact && "min-h-[84px]! px-3 pt-3 pb-1 text-[14px]",
             )}
             disabled={disabled}
             placeholder={t.inputBox.placeholder}
@@ -784,7 +648,7 @@ export function InputBox({
         <PromptInputFooter
           className={cn(
             "flex items-center border-t-0 px-2 pt-1 pb-1.5",
-            compact && "gap-2 px-6 pt-2 pb-5",
+            compact && "gap-2 px-3 pt-1.5 pb-3",
           )}
         >
           <PromptInputTools
@@ -919,47 +783,52 @@ export function InputBox({
             </Tooltip>
             <PromptInputActionMenu>
               <ModeHoverGuide
-                mode={
-                  effectiveMode
-                }
+                mode={
+                  context.mode === "flash" ||
+                  context.mode === "thinking" ||
+                  context.mode === "pro" ||
+                  context.mode === "ultra"
+                    ? context.mode
+                    : "flash"
+                }
               >
                 <PromptInputActionMenuTrigger
                   className={cn(
                     "gap-1.5! rounded-full border-0 bg-transparent px-3! text-muted-foreground shadow-none hover:bg-muted/70 hover:text-foreground dark:text-slate-400 dark:hover:bg-slate-700/70 dark:hover:text-slate-100",
                     compact && "rounded-lg border px-2.5! py-1! text-[11px] font-medium",
                     compact &&
-                      (effectiveMode === "thinking"
-                        ? "border-indigo-200 bg-indigo-50/60 text-indigo-700 hover:bg-indigo-100 dark:border-indigo-700 dark:bg-indigo-950/40 dark:text-indigo-200"
-                        : effectiveMode === "pro"
-                          ? "border-violet-200 bg-violet-50/60 text-violet-700 hover:bg-violet-100 dark:border-violet-700 dark:bg-violet-950/40 dark:text-violet-200"
-                          : effectiveMode === "ultra"
-                            ? "border-amber-200 bg-amber-50/60 text-amber-700 hover:bg-amber-100 dark:border-amber-700 dark:bg-amber-950/40 dark:text-amber-200"
+                      (context.mode === "thinking"
+                        ? "border-indigo-200 bg-indigo-50/60 text-indigo-700 hover:bg-indigo-100 dark:border-indigo-700 dark:bg-indigo-950/40 dark:text-indigo-200"
+                        : context.mode === "pro"
+                          ? "border-violet-200 bg-violet-50/60 text-violet-700 hover:bg-violet-100 dark:border-violet-700 dark:bg-violet-950/40 dark:text-violet-200"
+                          : context.mode === "ultra"
+                            ? "border-amber-200 bg-amber-50/60 text-amber-700 hover:bg-amber-100 dark:border-amber-700 dark:bg-amber-950/40 dark:text-amber-200"
                             : "border-transparent bg-muted/40 hover:bg-muted hover:text-foreground"),
                   )}
                 >
                   <div>
-                    {effectiveMode === "flash" && <ZapIcon className="size-3" />}
-                    {effectiveMode === "thinking" && (
-                      <LightbulbIcon className="size-3" />
-                    )}
-                    {effectiveMode === "pro" && (
-                      <GraduationCapIcon className="size-3" />
-                    )}
-                    {effectiveMode === "ultra" && (
-                      <RocketIcon className="size-3 text-[#dabb5e]" />
-                    )}
+                    {context.mode === "flash" && <ZapIcon className="size-3" />}
+                    {context.mode === "thinking" && (
+                      <LightbulbIcon className="size-3" />
+                    )}
+                    {context.mode === "pro" && (
+                      <GraduationCapIcon className="size-3" />
+                    )}
+                    {context.mode === "ultra" && (
+                      <RocketIcon className="size-3 text-[#dabb5e]" />
+                    )}
                   </div>
                   <div
                     className={cn(
                       "text-xs font-normal",
-                      effectiveMode === "ultra" ? "golden-text" : "",
+                      context.mode === "ultra" ? "golden-text" : "",
                     )}
                   >
-                    {(effectiveMode === "flash" && t.inputBox.flashMode) ||
-                      (effectiveMode === "thinking" &&
-                        t.inputBox.reasoningMode) ||
-                      (effectiveMode === "pro" && t.inputBox.proMode) ||
-                      (effectiveMode === "ultra" && t.inputBox.ultraMode)}
+                    {(context.mode === "flash" && t.inputBox.flashMode) ||
+                      (context.mode === "thinking" &&
+                        t.inputBox.reasoningMode) ||
+                      (context.mode === "pro" && t.inputBox.proMode) ||
+                      (context.mode === "ultra" && t.inputBox.ultraMode)}
                   </div>
                 </PromptInputActionMenuTrigger>
               </ModeHoverGuide>
@@ -1255,10 +1124,8 @@ export function InputBox({
               onOpenChange={setModelDialogOpen}
             >
               <ModelSelectorTrigger asChild>
-                <PromptInputButton
-                  disabled={models.length === 0}
-                  aria-label="模型选择"
-                  className={cn(
+                <PromptInputButton
+                  className={cn(
                     "rounded-full border-0 bg-transparent px-3 shadow-none 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",
                     compact &&
                       "rounded-lg border border-transparent bg-gray-50/60 px-2.5! py-1! font-mono text-gray-600 hover:bg-gray-100/80 hover:text-gray-800 dark:bg-slate-700/50 dark:text-slate-300 dark:hover:bg-slate-700",
@@ -1271,7 +1138,7 @@ export function InputBox({
                         compact && "text-[11px]",
                       )}
                     >
-                      {selectedModel?.display_name || "默认模型"}
+                      {selectedModel?.display_name}
                     </ModelSelectorName>
                   </div>
                 </PromptInputButton>
@@ -1304,8 +1171,8 @@ export function InputBox({
             <PromptInputSubmit
               className={cn(
                 "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-10 rounded-full border-0 bg-blue-600 text-white shadow-[0_8px_18px_-10px_rgba(37,99,235,0.9)] hover:bg-blue-700 disabled:bg-muted disabled:text-muted-foreground/40 dark:border-0 dark:bg-blue-500 dark:text-white dark:hover:bg-blue-400 dark:disabled:bg-muted",
+                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}
               variant="outline"

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

@@ -65,10 +65,7 @@ import { cn } from "@/lib/utils";
 import { useArtifactsOptional } from "../artifacts";
 import { FlipDisplay } from "../flip-display";
 import { Tooltip } from "../tooltip";
-import {
-  isWeKnoraSourcePreviewUrl,
-  SourceCard,
-} from "../skill-display-sources";
+import { SourceCard } from "../skill-display-sources";
 
 import { MarkdownContent } from "./markdown-content";
 
@@ -642,43 +639,19 @@ function DisplayResultsList({ results }: { results: RuntimeDisplaySource[] }) {
   );
 }
 
-function SearchResultCard({ item }: { item: SearchResultItem }) {
-  const [open, setOpen] = useState(false);
-  const content = item.snippet ?? item.content;
-  const date = item.published_date ?? item.publishedDate ?? item.date;
+function SearchResultCard({ item }: { item: SearchResultItem }) {
+  const [open, setOpen] = useState(false);
+  const content = item.snippet ?? item.content;
+  const date = item.published_date ?? item.publishedDate ?? item.date;
   let sourceLabel: string | undefined = item.source;
   if (item.url) {
     try {
       sourceLabel = new URL(item.url).hostname.replace(/^www\./, "");
-    } catch {
-      sourceLabel = sourceLabel ?? item.url;
-    }
-  }
-
-  // MCP retrieval tools without a configured display adapter fall back to this
-  // generic result card. Preserve the normal web-search UI, but route our
-  // credential-free WeKnora pointer through SourceCard so its dialog exposes a
-  // deliberate “查看原文” action rather than rendering the internal route text.
-  if (isWeKnoraSourcePreviewUrl(item.url)) {
-    const weknoraSource: RuntimeDisplaySource = {
-      id: item.id ?? item.uuid ?? item.docId,
-      title: item.title ?? "检索结果",
-      type: item.source ?? "document",
-      snippet: item.snippet ?? item.content ?? "",
-      content,
-      source: item.source,
-      author: item.author,
-      time: date,
-      url: item.url,
-      index: 0,
-      skillName: "weknora-knowledge-search",
-      mode: "list",
-      raw: { ...item },
-    };
-    return <SourceCard source={weknoraSource} />;
-  }
-
-  return (
+    } catch {
+      sourceLabel = sourceLabel ?? item.url;
+    }
+  }
+  return (
     <>
       <button
         type="button"

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

@@ -135,11 +135,12 @@ export function MessageListItem({
   threadId,
   tokenUsageEnabled = false,
   displaySources = [],
-  extraRehypePlugins,
-  onEditResubmit,
-  onMessageDeleted,
-  turnTime,
-}: {
+  extraRehypePlugins,
+  onEditResubmit,
+  onEditSave,
+  onMessageDeleted,
+  turnTime,
+}: {
   className?: string;
   fitRowToContent?: boolean;
   /**
@@ -151,10 +152,11 @@ export function MessageListItem({
   isLoading?: boolean;
   threadId: string;
   tokenUsageEnabled?: boolean;
-  displaySources?: RuntimeDisplaySource[];
-  extraRehypePlugins?: ReturnType<typeof useRehypeSplitWordsIntoSpans>;
-  onEditResubmit?: (text: string) => void;
-  onMessageDeleted?: (deletedIds: string[]) => void;
+  displaySources?: RuntimeDisplaySource[];
+  extraRehypePlugins?: ReturnType<typeof useRehypeSplitWordsIntoSpans>;
+  onEditResubmit?: (text: string) => void;
+  onEditSave?: (messageId: string, text: string) => void | Promise<void>;
+  onMessageDeleted?: (deletedIds: string[]) => void;
   /**
    * Durable ask time of the turn this message belongs to (the preceding
    * question's `client_ts`). Used to time-stamp the AI answer, which carries no
@@ -162,14 +164,102 @@ export function MessageListItem({
    * wall clock at render time and appear to "drift" to now on every reload.
    */
   turnTime?: string;
-}) {
-  const isHuman = message.type === 'human';
-  const messageMarkdown =
-    extractContentFromMessage(message) ??
-    extractReasoningContentFromMessage(message) ??
-    '';
-  return (
-    <AIElementMessage
+}) {
+  const { t } = useI18n();
+  const isHuman = message.type === 'human';
+  const messageMarkdown =
+    extractContentFromMessage(message) ??
+    extractReasoningContentFromMessage(message) ??
+    '';
+  const [assistantEditing, setAssistantEditing] = useState(false);
+  const [assistantDraft, setAssistantDraft] = useState(messageMarkdown);
+  const [assistantSaving, setAssistantSaving] = useState(false);
+
+  useEffect(() => {
+    if (!assistantEditing) {
+      setAssistantDraft(messageMarkdown);
+    }
+  }, [assistantEditing, messageMarkdown]);
+
+  const canSaveAssistantEdit =
+    !isLoading &&
+    !isHuman &&
+    !!onEditSave &&
+    !!message.id &&
+    !message.id.startsWith('opt-') &&
+    !!messageMarkdown;
+  const confirmAssistantEdit = useCallback(async () => {
+    const value = assistantDraft.trim();
+    if (!value || !message.id || !onEditSave || assistantSaving) {
+      return;
+    }
+    setAssistantSaving(true);
+    try {
+      await onEditSave(message.id, value);
+      setAssistantEditing(false);
+    } catch {
+      // The page-level save callback owns user-facing error toasts. Keep the
+      // editor open so the user can adjust and retry.
+    } finally {
+      setAssistantSaving(false);
+    }
+  }, [assistantDraft, assistantSaving, message.id, onEditSave]);
+
+  if (!isHuman && assistantEditing) {
+    return (
+      <AIElementMessage
+        id={anchorId}
+        className={cn(
+          'group/conversation-message relative',
+          fitRowToContent ? 'max-w-full w-fit' : 'w-full',
+          anchorId && 'scroll-mt-20',
+          className,
+        )}
+        from="assistant"
+      >
+        <AIElementMessageContent className="w-full">
+          <div className="flex w-full flex-col gap-2 rounded-2xl border border-primary/20 bg-primary/5 p-3">
+            <Textarea
+              value={assistantDraft}
+              autoFocus
+              onChange={(event) => setAssistantDraft(event.currentTarget.value)}
+              onKeyDown={(event) => {
+                if (event.key === "Enter" && (event.metaKey || event.ctrlKey)) {
+                  event.preventDefault();
+                  void confirmAssistantEdit();
+                }
+                if (event.key === "Escape") {
+                  event.preventDefault();
+                  setAssistantEditing(false);
+                }
+              }}
+              className="min-h-32 resize-y text-[15px] leading-7"
+            />
+            <div className="flex items-center justify-end gap-2">
+              <Button
+                size="sm"
+                variant="ghost"
+                disabled={assistantSaving}
+                onClick={() => setAssistantEditing(false)}
+              >
+                {t.common.cancel}
+              </Button>
+              <Button
+                size="sm"
+                disabled={!assistantDraft.trim() || assistantSaving}
+                onClick={() => void confirmAssistantEdit()}
+              >
+                {assistantSaving ? "保存中..." : t.common.save}
+              </Button>
+            </div>
+          </div>
+        </AIElementMessageContent>
+      </AIElementMessage>
+    );
+  }
+
+  return (
+    <AIElementMessage
       id={anchorId}
       className={cn(
         'group/conversation-message relative',
@@ -187,11 +277,12 @@ export function MessageListItem({
         threadId={threadId}
         tokenUsageEnabled={tokenUsageEnabled}
         displaySources={displaySources}
-        extraRehypePlugins={extraRehypePlugins}
-        onEditResubmit={onEditResubmit}
-        onMessageDeleted={onMessageDeleted}
-        turnTime={turnTime}
-      />
+        extraRehypePlugins={extraRehypePlugins}
+        onEditResubmit={onEditResubmit}
+        onEditSave={isLoading ? undefined : onEditSave}
+        onMessageDeleted={onMessageDeleted}
+        turnTime={turnTime}
+      />
       {/*
         Human messages carry their own inline copy/edit toolbar inside
         MessageContent (above the timestamp). Only assistant answers use the
@@ -206,15 +297,28 @@ export function MessageListItem({
         >
           <div className="flex gap-1">
             <CopyButton clipboardData={messageMarkdown} />
-            {messageMarkdown && (
-              <DownloadWordButton
-                markdown={messageMarkdown}
-                fileName="message"
-              />
-            )}
-          </div>
-        </MessageToolbar>
-      )}
+            {messageMarkdown && (
+              <DownloadWordButton
+                markdown={messageMarkdown}
+                fileName="message"
+              />
+            )}
+            {canSaveAssistantEdit && (
+              <Tooltip content="编辑消息">
+                <Button
+                  size="icon-sm"
+                  type="button"
+                  variant="ghost"
+                  className="size-6"
+                  onClick={() => setAssistantEditing(true)}
+                >
+                  <PencilIcon size={11} />
+                </Button>
+              </Tooltip>
+            )}
+          </div>
+        </MessageToolbar>
+      )}
     </AIElementMessage>
   );
 }
@@ -228,26 +332,31 @@ export function MessageListItem({
  * the question; confirming sends the edited text as a brand-new turn (the
  * original question stays in the thread).
  */
-function HumanMessageBlock({
-  text,
-  pageContext,
-  filesList,
-  messageTime,
-  components,
-  onEditResubmit,
-  deleteButton,
-}: {
-  text: string;
-  pageContext?: EmbeddedPageContext | null;
-  filesList: React.ReactNode;
-  messageTime: { label: string; full: string } | null;
-  components: MarkdownContentProps["components"];
-  onEditResubmit?: (text: string) => void;
-  deleteButton?: React.ReactNode;
-}) {
-  const { t } = useI18n();
-  const [editing, setEditing] = useState(false);
-  const [draft, setDraft] = useState(text);
+function HumanMessageBlock({
+  messageId,
+  text,
+  pageContext,
+  filesList,
+  messageTime,
+  components,
+  onEditResubmit,
+  onEditSave,
+  deleteButton,
+}: {
+  messageId?: string;
+  text: string;
+  pageContext?: EmbeddedPageContext | null;
+  filesList: React.ReactNode;
+  messageTime: { label: string; full: string } | null;
+  components: MarkdownContentProps["components"];
+  onEditResubmit?: (text: string) => void;
+  onEditSave?: (messageId: string, text: string) => void | Promise<void>;
+  deleteButton?: React.ReactNode;
+}) {
+  const { t } = useI18n();
+  const [editing, setEditing] = useState(false);
+  const [draft, setDraft] = useState(text);
+  const [saving, setSaving] = useState(false);
 
   useEffect(() => {
     if (!editing) {
@@ -255,14 +364,27 @@ function HumanMessageBlock({
     }
   }, [text, editing]);
 
-  const confirmEdit = useCallback(() => {
-    const value = draft.trim();
-    if (!value) {
-      return;
-    }
-    onEditResubmit?.(value);
-    setEditing(false);
-  }, [draft, onEditResubmit]);
+  const confirmEdit = useCallback(async () => {
+    const value = draft.trim();
+    if (!value || saving) {
+      return;
+    }
+    if (onEditSave && messageId && !messageId.startsWith("opt-")) {
+      setSaving(true);
+      try {
+        await onEditSave(messageId, value);
+        setEditing(false);
+      } catch {
+        // The page-level save callback owns user-facing error toasts. Keep the
+        // editor open so the user can adjust and retry.
+      } finally {
+        setSaving(false);
+      }
+      return;
+    }
+    onEditResubmit?.(value);
+    setEditing(false);
+  }, [draft, messageId, onEditResubmit, onEditSave, saving]);
 
   if (editing) {
     return (
@@ -275,10 +397,10 @@ function HumanMessageBlock({
           onKeyDown={(event) => {
             if (event.key === "Enter" && (event.metaKey || event.ctrlKey)) {
               event.preventDefault();
-              confirmEdit();
-            }
-            if (event.key === "Escape") {
-              event.preventDefault();
+              void confirmEdit();
+            }
+            if (event.key === "Escape") {
+              event.preventDefault();
               setEditing(false);
             }
           }}
@@ -286,17 +408,22 @@ function HumanMessageBlock({
         />
         <div className="flex items-center justify-end gap-2">
           <Button
-            size="sm"
-            variant="ghost"
-            onClick={() => setEditing(false)}
-          >
-            {t.common.cancel}
-          </Button>
-          <Button size="sm" onClick={confirmEdit} disabled={!draft.trim()}>
-            {t.common.confirm}
-          </Button>
-        </div>
-      </div>
+            size="sm"
+            variant="ghost"
+            disabled={saving}
+            onClick={() => setEditing(false)}
+          >
+            {t.common.cancel}
+          </Button>
+          <Button
+            size="sm"
+            onClick={() => void confirmEdit()}
+            disabled={!draft.trim() || saving}
+          >
+            {saving ? "保存中..." : onEditSave ? t.common.save : t.common.confirm}
+          </Button>
+        </div>
+      </div>
     );
   }
 
@@ -324,11 +451,11 @@ function HumanMessageBlock({
       {(text || deleteButton) && (
         <div className="flex items-center gap-0.5 opacity-0 transition-opacity duration-200 group-hover/conversation-message:opacity-100">
           {text && <CopyButton clipboardData={text} className="size-6" />}
-          {text && onEditResubmit && (
-            <Tooltip content={t.inputBox.editQuestion}>
-              <Button
-                size="icon-sm"
-                type="button"
+          {text && (onEditResubmit || onEditSave) && (
+            <Tooltip content={onEditSave ? "编辑消息" : t.inputBox.editQuestion}>
+              <Button
+                size="icon-sm"
+                type="button"
                 variant="ghost"
                 className="size-6"
                 onClick={() => setEditing(true)}
@@ -396,22 +523,24 @@ function MessageContent_({
   threadId,
   tokenUsageEnabled = false,
   displaySources = [],
-  extraRehypePlugins,
-  onEditResubmit,
-  onMessageDeleted,
-  turnTime,
-}: {
+  extraRehypePlugins,
+  onEditResubmit,
+  onEditSave,
+  onMessageDeleted,
+  turnTime,
+}: {
   className?: string;
   message: Message;
   isLoading?: boolean;
   threadId: string;
   tokenUsageEnabled?: boolean;
-  displaySources?: RuntimeDisplaySource[];
-  extraRehypePlugins?: ReturnType<typeof useRehypeSplitWordsIntoSpans>;
-  onEditResubmit?: (text: string) => void;
-  onMessageDeleted?: (deletedIds: string[]) => void;
-  turnTime?: string;
-}) {
+  displaySources?: RuntimeDisplaySource[];
+  extraRehypePlugins?: ReturnType<typeof useRehypeSplitWordsIntoSpans>;
+  onEditResubmit?: (text: string) => void;
+  onEditSave?: (messageId: string, text: string) => void | Promise<void>;
+  onMessageDeleted?: (deletedIds: string[]) => void;
+  turnTime?: string;
+}) {
   const baseRehypePlugins = useRehypeSplitWordsIntoSpans(isLoading);
 
   // Streamdown splits content into per-block processors; calling the factory
@@ -555,14 +684,16 @@ function MessageContent_({
     const canDelete =
       !!onMessageDeleted && !!message.id && !message.id.startsWith('opt-');
     return (
-      <HumanMessageBlock
-        text={parsedHumanContent.content}
-        pageContext={parsedHumanContent.pageContext}
-        filesList={filesList}
-        messageTime={messageTime}
-        components={components}
-        onEditResubmit={onEditResubmit}
-        deleteButton={
+      <HumanMessageBlock
+        messageId={message.id}
+        text={parsedHumanContent.content}
+        pageContext={parsedHumanContent.pageContext}
+        filesList={filesList}
+        messageTime={messageTime}
+        components={components}
+        onEditResubmit={onEditResubmit}
+        onEditSave={onEditSave}
+        deleteButton={
           canDelete ? (
             <DeleteMessageButton
               threadId={threadId}

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

@@ -97,14 +97,18 @@ export function MessageList({
   tokenUsageEnabled = false,
   extraRehypePlugins,
   scrollButtonClassName,
-  onClarificationSubmit,
-  onEditResubmit,
-  onSetupAgentApprove,
-  onSetupAgentReject,
-  onSetupWritingApprove,
-  onSetupWritingReject,
-  onSetupWritingStart,
-}: {
+  onClarificationSubmit,
+  onEditResubmit,
+  onEditSave,
+  messageContentOverrides,
+  externallyHiddenMessageIds,
+  onSetupAgentApprove,
+  onSetupAgentReject,
+  onSetupWritingApprove,
+  onSetupWritingReject,
+  onSetupWritingStart,
+  onOpenArtifact,
+}: {
   className?: string;
   contentClassName?: string;
   fitMessageRowsToContent?: boolean;
@@ -115,15 +119,19 @@ export function MessageList({
   /** 额外定位「回到最新」悬浮按钮——不同页面输入框高度不同，需上移让位。 */
   scrollButtonClassName?: string;
   extraRehypePlugins?: ReturnType<typeof useRehypeSplitWordsIntoSpans>;
-  onClarificationSubmit?: (answer: string) => void | Promise<void>;
-  onEditResubmit?: (text: string) => void;
-  onSetupAgentApprove?: (payload: SetupAgentApprovalPayload) => void | Promise<void>;
+  onClarificationSubmit?: (answer: string) => void | Promise<void>;
+  onEditResubmit?: (text: string) => void;
+  onEditSave?: (messageId: string, text: string) => void | Promise<void>;
+  messageContentOverrides?: Record<string, string>;
+  externallyHiddenMessageIds?: Set<string>;
+  onSetupAgentApprove?: (payload: SetupAgentApprovalPayload) => void | Promise<void>;
   onSetupAgentReject?: (payload: SetupAgentApprovalPayload) => void | Promise<void>;
-  onSetupWritingApprove?: (payload: SetupWritingApprovalPayload) => void | Promise<void>;
-  onSetupWritingReject?: (payload: SetupWritingApprovalPayload) => void | Promise<void>;
+  onSetupWritingApprove?: (payload: SetupWritingApprovalPayload) => void | Promise<void>;
+  onSetupWritingReject?: (payload: SetupWritingApprovalPayload) => void | Promise<void>;
   /** 审批卡「直接开始写作」回调：应用配置（含已确认大纲）并立即启动写作流程（仅写作页提供，模板编辑等场景缺省隐藏该按钮）。 */
-  onSetupWritingStart?: (payload: SetupWritingApprovalPayload) => void | Promise<void>;
-}) {
+  onSetupWritingStart?: (payload: SetupWritingApprovalPayload) => void | Promise<void>;
+  onOpenArtifact?: (filepath: string) => void;
+}) {
   const baseRehypePlugins = useRehypeSplitWordsIntoSpans(thread.isLoading);
   const rehypePlugins = useMemo(
     () => (extraRehypePlugins?.length ? [...baseRehypePlugins, ...extraRehypePlugins] : baseRehypePlugins),
@@ -155,17 +163,33 @@ export function MessageList({
     });
   }, []);
 
-  const allMessages = useMemo(
-    () => thread.messages.filter((m) => !isHiddenFromUIMessage(m)),
-    [thread.messages],
-  );
-  const messages = useMemo(
-    () =>
-      hiddenMessageIds.size === 0
-        ? allMessages
-        : allMessages.filter((m) => !m.id || !hiddenMessageIds.has(m.id)),
-    [allMessages, hiddenMessageIds],
-  );
+  const allMessages = useMemo(() => {
+    const hasOverrides = messageContentOverrides && Object.keys(messageContentOverrides).length > 0;
+    return thread.messages
+      .filter((m) => !isHiddenFromUIMessage(m))
+      .map((message) => {
+        const override =
+          hasOverrides && message.id
+            ? messageContentOverrides?.[message.id]
+            : undefined;
+        return override === undefined
+          ? message
+          : ({ ...message, content: override } as Message);
+      });
+  }, [messageContentOverrides, thread.messages]);
+  const messages = useMemo(
+    () => {
+      const externalHidden = externallyHiddenMessageIds ?? new Set<string>();
+      return hiddenMessageIds.size === 0 && externalHidden.size === 0
+        ? allMessages
+        : allMessages.filter(
+            (m) =>
+              !m.id ||
+              (!hiddenMessageIds.has(m.id) && !externalHidden.has(m.id)),
+          );
+    },
+    [allMessages, externallyHiddenMessageIds, hiddenMessageIds],
+  );
 
   const askTimes = useChatAskTimes();
 
@@ -380,10 +404,11 @@ export function MessageList({
                   threadId={threadId}
                   tokenUsageEnabled={tokenUsageEnabled}
                   displaySources={displaySources}
-                  extraRehypePlugins={extraRehypePlugins}
-                  onEditResubmit={onEditResubmit}
-                  onMessageDeleted={
-                    allowDelete ? handleMessageDeleted : undefined
+                  extraRehypePlugins={extraRehypePlugins}
+                  onEditResubmit={onEditResubmit}
+                  onEditSave={onEditSave}
+                  onMessageDeleted={
+                    allowDelete ? handleMessageDeleted : undefined
                   }
                   turnTime={msg.id ? turnTimes.get(msg.id) : undefined}
                 />
@@ -488,7 +513,11 @@ export function MessageList({
                     className="mb-4"
                   />
                 )}
-                <ArtifactFileList files={files} threadId={threadId} />
+                <ArtifactFileList
+                  files={files}
+                  threadId={threadId}
+                  onOpenArtifact={onOpenArtifact}
+                />
                 <MessageTokenUsageList
                   enabled={tokenUsageEnabled}
                   isLoading={thread.isLoading}

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

@@ -7,10 +7,13 @@ import {
   ExternalLink,
   LayoutGridIcon,
   LayoutIcon,
+  LeafIcon,
   ListIcon,
   MoonIcon,
   PanelLeftIcon,
+  PaletteIcon,
   Plus,
+  SnowflakeIcon,
   SunIcon,
   Trash2,
 } from "lucide-react";
@@ -18,7 +21,7 @@ import { useEffect, useMemo, useState, type ComponentType, type SVGProps } from
 import { useNavigate } from "react-router-dom";
 import { toast } from "sonner";
 
-import { useTheme } from "@/contexts/ThemeContext";
+import { useTheme, type ThemeType } from "@/contexts/ThemeContext";
 
 import { FONT_SCALE_OPTIONS } from "@/components/font-scale";
 import { Button } from "@/components/ui/button";
@@ -61,16 +64,17 @@ import {
 import PrivateSquareSettingsPage from "@/pages/PrivateSquareSettingsPage";
 import PublishSquaresSettingsPage from "@/pages/PublishSquaresSettingsPage";
 import PromptPrefixSettingsPage from "@/pages/PromptPrefixSettingsPage";
-import SkillCompressionSettingsPage from "@/pages/SkillCompressionSettingsPage";
-
-import { SettingsSection } from "./settings-section";
+import SkillCompressionSettingsPage from "@/pages/SkillCompressionSettingsPage";
+
+import { CustomThemeLibrarySettings } from "./custom-theme-library-settings";
+import { SettingsSection } from "./settings-section";
 
 const languageOptions: { value: Locale; label: string }[] = [
   { value: "en-US", label: enUS.locale.localName },
   { value: "zh-CN", label: zhCN.locale.localName },
 ];
 
-const DEFAULT_SHORTCUT_THEME_MAP = "red=red;blue=blue;dark-blue=dark-blue";
+const DEFAULT_SHORTCUT_THEME_MAP = "red=red;green=green;blue=blue;dark-blue=dark-blue";
 
 function makeShortcutId() {
   if (typeof crypto !== "undefined" && "randomUUID" in crypto) {
@@ -174,9 +178,21 @@ export function AppearanceSettingsPage({ onClose }: { onClose?: () => void }) {
   const { data: citationDisplay } = useCitationDisplaySettings();
   const updateCitationDisplay = useUpdateCitationDisplaySettings();
   const globalDefault = appearance?.default_theme ?? "light";
-  const globalSkillView = appearance?.default_skill_view ?? "list";
-  const globalAgentView = appearance?.default_agent_view ?? "card";
-  const globalLayoutMode = appearance?.default_layout_mode ?? "full";
+  const globalSkillView = appearance?.default_skill_view ?? "list";
+  const globalAgentView = appearance?.default_agent_view ?? "card";
+  const globalLayoutMode = appearance?.default_layout_mode ?? "full";
+  const globalDefaultLabel = useMemo(() => {
+    const customTheme = (appearance?.custom_themes ?? []).find(
+      (preset) => preset.id === globalDefault,
+    );
+    if (customTheme) return customTheme.name;
+    if (globalDefault === "light") return "浅色";
+    if (globalDefault === "dark") return "深色";
+    if (globalDefault === "lightgreen") return "绿色";
+    if (globalDefault === "iceblue") return "冰川蓝";
+    if (globalDefault === "lightyellow") return "浅黄色";
+    return "浅蓝";
+  }, [appearance?.custom_themes, globalDefault]);
   // 有效界面模式：用户自己选过则以其为准，否则跟随管理员系统默认（再否则会话级回退）。
   const [effectiveLayoutMode, setLayoutMode] = useLayoutMode();
   const cleanupWords =
@@ -211,14 +227,24 @@ export function AppearanceSettingsPage({ onClose }: { onClose?: () => void }) {
     }
   };
 
-  const handleSetGlobalDefault = async (
-    value: "light" | "dark" | "lightblue",
+  const handleSetGlobalDefault = async (
+    value: "light" | "dark" | "lightblue" | "lightgreen" | "iceblue" | "lightyellow",
   ) => {
     if (value === globalDefault) return;
     try {
       await updateAppearance.mutateAsync({ default_theme: value });
-      const label =
-        value === "light" ? "浅色" : value === "dark" ? "深色" : "浅蓝";
+      const label =
+        value === "light"
+          ? "浅色"
+          : value === "dark"
+            ? "深色"
+            : value === "lightgreen"
+              ? "绿色"
+              : value === "iceblue"
+                ? "冰川蓝"
+                : value === "lightyellow"
+                  ? "浅黄色"
+                  : "浅蓝";
       toast.success(`已将系统默认主题设置为${label}`);
     } catch (e) {
       toast.error(e instanceof Error ? e.message : "保存失败");
@@ -368,20 +394,44 @@ export function AppearanceSettingsPage({ onClose }: { onClose?: () => void }) {
         description: t.settings.appearance.darkDescription,
         icon: MoonIcon,
       },
-      {
-        id: "lightblue",
-        label: t.settings.appearance.lightblue,
-        description: t.settings.appearance.lightblueDescription,
-        icon: DropletIcon,
-      },
+      {
+        id: "lightblue",
+        label: t.settings.appearance.lightblue,
+        description: t.settings.appearance.lightblueDescription,
+        icon: DropletIcon,
+      },
+      {
+        id: "lightgreen",
+        label: t.settings.appearance.lightgreen,
+        description: t.settings.appearance.lightgreenDescription,
+        icon: LeafIcon,
+      },
+      {
+        id: "iceblue",
+        label: t.settings.appearance.iceblue,
+        description: t.settings.appearance.iceblueDescription,
+        icon: SnowflakeIcon,
+      },
+      {
+        id: "lightyellow",
+        label: t.settings.appearance.lightyellow,
+        description: t.settings.appearance.lightyellowDescription,
+        icon: SunIcon,
+      },
     ],
     [
       t.settings.appearance.dark,
       t.settings.appearance.darkDescription,
       t.settings.appearance.light,
       t.settings.appearance.lightDescription,
-      t.settings.appearance.lightblue,
-      t.settings.appearance.lightblueDescription,
+      t.settings.appearance.lightblue,
+      t.settings.appearance.lightblueDescription,
+      t.settings.appearance.lightgreen,
+      t.settings.appearance.lightgreenDescription,
+      t.settings.appearance.iceblue,
+      t.settings.appearance.iceblueDescription,
+      t.settings.appearance.lightyellow,
+      t.settings.appearance.lightyellowDescription,
     ],
   );
 
@@ -392,18 +442,34 @@ export function AppearanceSettingsPage({ onClose }: { onClose?: () => void }) {
         description={t.settings.appearance.themeDescription}
       >
         <div className="grid gap-3 lg:grid-cols-2">
-          {themeOptions.map((option) => (
-            <ThemePreviewCard
+          {themeOptions.map((option) => (
+            <ThemePreviewCard
               key={option.id}
               icon={option.icon}
               label={option.label}
               description={option.description}
               active={currentTheme === option.id}
-              mode={option.id as "light" | "dark" | "lightblue"}
-              onSelect={(value) => setTheme(value)}
-            />
-          ))}
-        </div>
+              mode={option.id as "light" | "dark" | "lightblue" | "lightgreen" | "iceblue" | "lightyellow"}
+              onSelect={(value) => setTheme(value)}
+            />
+          ))}
+          {(appearance?.custom_themes ?? [])
+            .filter((preset) => preset.enabled)
+            .sort((a, b) => a.sort_order - b.sort_order)
+            .map((preset) => (
+              <ThemePreviewCard
+                key={preset.id}
+                icon={PaletteIcon}
+                label={preset.name}
+                description={`自定义主题 · 主色 ${preset.primary}`}
+                active={currentTheme === preset.id}
+                mode={preset.id}
+                previewDark={preset.mode === "dark"}
+                accentColor={preset.primary}
+                onSelect={(value) => setTheme(value)}
+              />
+            ))}
+        </div>
       </SettingsSection>
 
       <Separator />
@@ -541,30 +607,80 @@ export function AppearanceSettingsPage({ onClose }: { onClose?: () => void }) {
                 <MoonIcon className="mr-1.5 size-4" />
                 深色
               </Button>
-              <Button
-                type="button"
-                variant={globalDefault === "lightblue" ? "default" : "outline"}
+              <Button
+                type="button"
+                variant={globalDefault === "lightblue" ? "default" : "outline"}
                 size="sm"
                 onClick={() => void handleSetGlobalDefault("lightblue")}
                 disabled={updateAppearance.isPending}
               >
                 <DropletIcon className="mr-1.5 size-4" />
-                浅蓝
-              </Button>
-              <p className="text-muted-foreground ml-2 text-xs">
-                当前系统默认：
-                {globalDefault === "light"
-                  ? "浅色"
-                  : globalDefault === "dark"
-                    ? "深色"
-                    : "浅蓝"}
-              </p>
+                浅蓝
+              </Button>
+              <Button
+                type="button"
+                variant={globalDefault === "lightgreen" ? "default" : "outline"}
+                size="sm"
+                onClick={() => void handleSetGlobalDefault("lightgreen")}
+                disabled={updateAppearance.isPending}
+              >
+                <LeafIcon className="mr-1.5 size-4" />
+                绿色
+              </Button>
+              <Button
+                type="button"
+                variant={globalDefault === "iceblue" ? "default" : "outline"}
+                size="sm"
+                onClick={() => void handleSetGlobalDefault("iceblue")}
+                disabled={updateAppearance.isPending}
+              >
+                <SnowflakeIcon className="mr-1.5 size-4" />
+                冰川蓝
+              </Button>
+              <Button
+                type="button"
+                variant={globalDefault === "lightyellow" ? "default" : "outline"}
+                size="sm"
+                onClick={() => void handleSetGlobalDefault("lightyellow")}
+                disabled={updateAppearance.isPending}
+              >
+                <SunIcon className="mr-1.5 size-4" />
+                浅黄色
+              </Button>
+              <Button
+                type="button"
+                variant="outline"
+                size="sm"
+                onClick={() =>
+                  document
+                    .getElementById("custom-theme-library")
+                    ?.scrollIntoView({ behavior: "smooth", block: "start" })
+                }
+              >
+                <PaletteIcon className="mr-1.5 size-4" />
+                管理自定义主题
+              </Button>
+              <p className="text-muted-foreground ml-2 text-xs">
+                当前系统默认：{globalDefaultLabel}
+              </p>
             </div>
           </SettingsSection>
-        </>
-      )}
-
-      {isAdmin && (
+        </>
+      )}
+
+      {isAdmin && (
+        <div id="custom-theme-library" className="scroll-mt-4">
+          <Separator />
+          <SettingsSection
+            title="自定义主题库（管理员）"
+            description="管理员可按品牌主色创建主题，并设置为系统默认；用户只会看到已启用的主题并可自行切换。"
+          >
+            <CustomThemeLibrarySettings />
+          </SettingsSection>
+        </div>
+      )}
+
+      {isAdmin && (
         <>
           <Separator />
           <SettingsSection
@@ -1065,19 +1181,24 @@ function CompactShortcutSettings({
 function ThemePreviewCard({
   icon: Icon,
   label,
-  description,
-  active,
-  mode,
-  onSelect,
-}: {
-  icon: ComponentType<SVGProps<SVGSVGElement>>;
-  label: string;
-  description: string;
-  active: boolean;
-  mode: "light" | "dark" | "lightblue";
-  onSelect: (mode: "light" | "dark" | "lightblue") => void;
-}) {
-  const previewMode = mode;
+  description,
+  active,
+  mode,
+  previewDark,
+  accentColor,
+  onSelect,
+}: {
+  icon: ComponentType<SVGProps<SVGSVGElement>>;
+  label: string;
+  description: string;
+  active: boolean;
+  mode: ThemeType;
+  previewDark?: boolean;
+  accentColor?: string;
+  onSelect: (mode: ThemeType) => void;
+}) {
+  const previewMode = mode;
+  const isDarkPreview = previewDark ?? previewMode === "dark";
   return (
     <button
       type="button"
@@ -1103,23 +1224,38 @@ function ThemePreviewCard({
       <div
         className={cn(
           "relative overflow-hidden rounded-md border text-xs transition-colors",
-          previewMode === "dark"
-            ? "border-neutral-800 bg-neutral-900 text-neutral-200"
-            : previewMode === "lightblue"
-              ? "border-blue-200 bg-white text-slate-900"
-              : "border-slate-200 bg-white text-slate-900",
+          isDarkPreview
+            ? "border-neutral-800 bg-neutral-900 text-neutral-200"
+            : previewMode === "lightblue"
+              ? "border-blue-200 bg-white text-slate-900"
+            : previewMode === "lightgreen"
+              ? "border-emerald-200 bg-white text-emerald-950"
+              : previewMode === "iceblue"
+                ? "border-sky-200 bg-[#F7FBFE] text-[#18324A]"
+                : previewMode === "lightyellow"
+                  ? "border-lime-200 bg-[#FCFDF5] text-[#303D23]"
+                  : "border-slate-200 bg-white text-slate-900",
         )}
       >
         <div className="border-border/50 flex items-center gap-2 border-b px-3 py-2">
           <div
             className={cn(
               "h-2 w-2 rounded-full",
-              previewMode === "dark"
-                ? "bg-emerald-400"
-                : previewMode === "lightblue"
-                  ? "bg-blue-500"
-                  : "bg-emerald-500",
-            )}
+              accentColor
+                ? ""
+                : isDarkPreview
+                  ? "bg-emerald-400"
+                  : previewMode === "lightblue"
+                    ? "bg-blue-500"
+                    : previewMode === "lightgreen"
+                      ? "bg-[#07c05f]"
+                      : previewMode === "iceblue"
+                        ? "bg-[#9BCEF1]"
+                        : previewMode === "lightyellow"
+                          ? "bg-[#F3FBD9]"
+                          : "bg-[#cf1322]",
+            )}
+            style={accentColor ? { backgroundColor: accentColor } : undefined}
           />
           <div className="h-2 w-10 rounded-full bg-current/20" />
           <div className="h-2 w-6 rounded-full bg-current/15" />

frontend-web/src/components/workspace/settings/custom-theme-library-settings.tsx

@@ -0,0 +1,771 @@
+"use client";
+
+import {
+  ChevronDownIcon,
+  ChevronUpIcon,
+  CheckIcon,
+  MoonIcon,
+  PaletteIcon,
+  PlusIcon,
+  RotateCcwIcon,
+  SaveIcon,
+  SlidersHorizontalIcon,
+  SunIcon,
+  Trash2Icon,
+} from "lucide-react";
+import { useEffect, useId, useMemo, useState, type CSSProperties } from "react";
+import { ColorPickerPanel } from "tdesign-react";
+import { toast } from "sonner";
+
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/components/ui/select";
+import { Switch } from "@/components/ui/switch";
+import type {
+  CustomThemeColorOverrides,
+  CustomThemePreset,
+} from "@/core/system-settings/api";
+import {
+  useAppearanceSettings,
+  useUpdateAppearanceSettings,
+} from "@/core/system-settings/hooks";
+import {
+  CUSTOM_THEME_ADVANCED_KEYS,
+  getCustomThemeAutomaticTokens,
+  getCustomThemeTokens,
+  normalizeHexColor,
+  customThemeTextContrast,
+  type CustomThemeAdvancedKey,
+} from "@/core/theme/custom-theme";
+import { cn } from "@/lib/utils";
+
+const MAX_CUSTOM_THEMES = 12;
+const SUGGESTED_COLORS = [
+  "#9BCEF1",
+  "#F3FBD9",
+  "#7AB8F5",
+  "#8ED1B2",
+  "#C6B4F6",
+  "#F3C5A6",
+  "#F3B1B7",
+  "#63C4C8",
+];
+const TEXT_COLORS = ["#202A3A", "#172033", "#2D587A", "#4C6330", "#F4F7FB", "#FFFFFF"];
+
+const ADVANCED_COLOR_FIELDS: Array<{
+  key: CustomThemeAdvancedKey;
+  label: string;
+  description: string;
+  token: string;
+}> = [
+  {
+    key: "button_hover",
+    label: "按钮悬停色",
+    description: "主按钮悬停时的背景色",
+    token: "--theme-button-hover",
+  },
+  {
+    key: "navigation_gradient_start",
+    label: "导航渐变起点",
+    description: "全量模式顶部导航栏左侧的渐变色",
+    token: "--navigation-gradient-start",
+  },
+  {
+    key: "navigation_gradient_end",
+    label: "导航渐变终点",
+    description: "全量模式顶部导航栏右侧的渐变色",
+    token: "--navigation-gradient-end",
+  },
+  {
+    key: "selected_background",
+    label: "选中背景",
+    description: "左侧菜单、卡片选中时的浅背景",
+    token: "--theme-selected-background",
+  },
+  {
+    key: "border",
+    label: "边框色",
+    description: "卡片、输入框和分隔线",
+    token: "--border",
+  },
+  {
+    key: "muted",
+    label: "弱化背景",
+    description: "次级区域与弱化容器",
+    token: "--muted",
+  },
+  {
+    key: "muted_text",
+    label: "辅助文字",
+    description: "说明、占位和次要信息文字",
+    token: "--muted-foreground",
+  },
+  {
+    key: "destructive",
+    label: "删除/危险色",
+    description: "删除按钮、错误与危险操作的颜色",
+    token: "--destructive",
+  },
+  {
+    key: "brand_title",
+    label: "栏目标题文字",
+    description: "业务链、分析记录等带图标栏目标题",
+    token: "--brand-title-foreground",
+  },
+  {
+    key: "primary_foreground",
+    label: "主色块文字（Logo/状态标签）",
+    description: "Logo 的 C、启用状态和默认标签；不影响主按钮文字",
+    token: "--primary-foreground",
+  },
+];
+
+function makeThemeId(): `custom-theme-${string}` {
+  const suffix =
+    typeof crypto !== "undefined" && "randomUUID" in crypto
+      ? crypto.randomUUID().replace(/[^a-z0-9-]/gi, "").toLowerCase()
+      : `${Date.now().toString(36)}${Math.random().toString(36).slice(2, 10)}`;
+  return `custom-theme-${suffix}`;
+}
+
+function newCustomTheme(order: number): CustomThemePreset {
+  return {
+    id: makeThemeId(),
+    name: `自定义主题 ${order + 1}`,
+    primary: "#9BCEF1",
+    text_color: null,
+    mode: "light",
+    overrides: {},
+    enabled: true,
+    sort_order: order,
+  };
+}
+
+function normalizeColorOverrides(
+  overrides: CustomThemeColorOverrides | undefined,
+): CustomThemeColorOverrides {
+  const normalized: CustomThemeColorOverrides = {};
+  for (const key of CUSTOM_THEME_ADVANCED_KEYS) {
+    const value = overrides?.[key];
+    if (typeof value === "string" && value.trim()) {
+      normalized[key] = normalizeHexColor(value);
+    }
+  }
+  return normalized;
+}
+
+function normalizeThemeDrafts(
+  themes: CustomThemePreset[] | undefined,
+): CustomThemePreset[] {
+  return [...(themes ?? [])]
+    .sort((a, b) => a.sort_order - b.sort_order)
+    .map((theme, index) => ({
+      ...theme,
+      id: theme.id || makeThemeId(),
+      name: theme.name || `自定义主题 ${index + 1}`,
+      primary: normalizeHexColor(theme.primary),
+      text_color:
+        typeof theme.text_color === "string" && theme.text_color.trim()
+          ? normalizeHexColor(theme.text_color)
+          : null,
+      mode: theme.mode === "dark" ? "dark" : "light",
+      overrides: normalizeColorOverrides(theme.overrides),
+      enabled: theme.enabled !== false,
+      sort_order: index,
+    }));
+}
+
+/**
+ * Render the TDesign panel inside the settings dialog instead of its default
+ * body-level popup. The dialog otherwise treats clicks inside that portal as
+ * outside interactions and closes the picker while a colour is being chosen.
+ */
+function InlineThemeColorPicker({
+  value,
+  fallback,
+  swatchColors,
+  onCommit,
+  ariaLabel = "选择颜色",
+}: {
+  value: string;
+  fallback?: string;
+  swatchColors: string[];
+  onCommit: (value: string) => void;
+  ariaLabel?: string;
+}) {
+  const normalizedValue = normalizeHexColor(value, fallback);
+  const [pendingValue, setPendingValue] = useState(normalizedValue);
+  const [open, setOpen] = useState(false);
+  const panelId = useId();
+
+  useEffect(() => {
+    if (!open) setPendingValue(normalizedValue);
+  }, [normalizedValue, open]);
+
+  return (
+    <div className="w-fit">
+      <button
+        type="button"
+        className="flex h-10 min-w-32 items-center gap-2 rounded-md border bg-background px-2 font-mono text-sm shadow-xs transition-colors hover:bg-muted/40 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
+        aria-label={ariaLabel}
+        aria-expanded={open}
+        aria-controls={panelId}
+        onClick={() => setOpen((visible) => !visible)}
+      >
+        <span
+          className="size-7 rounded border"
+          style={{ backgroundColor: pendingValue }}
+          aria-hidden
+        />
+        {pendingValue}
+      </button>
+      {open && (
+        <div
+          id={panelId}
+          className="mt-2 w-fit rounded-lg border bg-background p-2 shadow-lg"
+          onPointerDown={(event) => event.stopPropagation()}
+          onClick={(event) => event.stopPropagation()}
+        >
+          <ColorPickerPanel
+            value={pendingValue}
+            format="HEX"
+            colorModes={["monochrome"]}
+            enableAlpha={false}
+            swatchColors={swatchColors}
+            onChange={(color) => setPendingValue(normalizeHexColor(String(color), fallback))}
+          />
+          <div className="mt-2 flex justify-end gap-2 border-t pt-2">
+            <Button
+              type="button"
+              size="sm"
+              variant="outline"
+              onClick={() => {
+                setPendingValue(normalizedValue);
+                setOpen(false);
+              }}
+            >
+              取消
+            </Button>
+            <Button
+              type="button"
+              size="sm"
+              onClick={() => {
+                setOpen(false);
+                onCommit(pendingValue);
+              }}
+            >
+              应用颜色
+            </Button>
+          </div>
+        </div>
+      )}
+    </div>
+  );
+}
+
+function CustomThemePreview({ theme }: { theme: CustomThemePreset }) {
+  const tokens = getCustomThemeTokens(theme) as CSSProperties;
+  const buttonContrast = customThemeTextContrast(theme);
+  const isButtonContrastLow = buttonContrast < 4.5;
+
+  return (
+    <div
+      className="overflow-hidden rounded-lg border"
+      style={tokens}
+      aria-label={`${theme.name} 的颜色预览`}
+    >
+      <div
+        className="flex items-center gap-2 border-b border-[var(--border)] px-3 py-2"
+        style={{
+          backgroundImage:
+            "linear-gradient(105deg, var(--navigation-gradient-start) 0%, var(--primary) 52%, var(--navigation-gradient-end) 100%)",
+        }}
+      >
+        <span
+          className="flex size-5 items-center justify-center rounded-md bg-white/25 text-[10px] font-bold text-[var(--navigation-foreground)] ring-2 ring-white/35"
+          aria-hidden
+        >
+          C
+        </span>
+        <span className="text-xs font-semibold text-[var(--navigation-foreground)]">
+          实时预览
+        </span>
+        <span
+          className={cn(
+            "ml-auto text-[11px]",
+            isButtonContrastLow
+              ? "text-amber-700 dark:text-amber-300"
+              : "text-[var(--muted-foreground)]",
+          )}
+        >
+          主按钮对比度 {buttonContrast.toFixed(1)}:1
+        </span>
+      </div>
+      <div className="grid gap-2 bg-[var(--background)] p-3 sm:grid-cols-[1fr_auto]">
+        <div className="rounded-md border border-[var(--border)] bg-[var(--card)] p-2.5">
+          <div className="text-xs font-semibold text-[var(--brand-title-foreground)]">
+            {theme.name || "未命名主题"}
+          </div>
+          <div className="mt-1 text-[11px] text-[var(--muted-foreground)]">
+            页面正文自动生成；主按钮文字可单独指定。
+          </div>
+        </div>
+        <button
+          type="button"
+          className="rounded-md bg-[var(--primary)] px-3 py-2 text-xs font-semibold text-[var(--button-foreground,var(--primary-foreground))] shadow-sm"
+          tabIndex={-1}
+        >
+          主按钮
+        </button>
+        {isButtonContrastLow && (
+          <p className="sm:col-span-2 text-[11px] text-amber-700 dark:text-amber-300">
+            当前按钮文字会按您的颜色设置展示，但对比度低于 4.5:1，建议改用更深的主色或恢复自动。
+          </p>
+        )}
+      </div>
+    </div>
+  );
+}
+
+function AdvancedThemeColorControls({
+  theme,
+  onPatch,
+}: {
+  theme: CustomThemePreset;
+  onPatch: (patch: Partial<CustomThemePreset>) => void;
+}) {
+  const automaticTokens = getCustomThemeAutomaticTokens({
+    primary: theme.primary,
+    mode: theme.mode,
+  });
+
+  const setOverride = (key: CustomThemeAdvancedKey, value: string) => {
+    const overrides = { ...(theme.overrides ?? {}) };
+    if (!value.trim()) {
+      delete overrides[key];
+    } else {
+      overrides[key] = value;
+    }
+    onPatch({ overrides });
+  };
+
+  return (
+    <div className="space-y-3 rounded-lg border border-dashed bg-muted/15 p-3">
+      <div className="flex flex-wrap items-start justify-between gap-2">
+        <div>
+          <div className="text-sm font-medium">更多配色</div>
+          <p className="mt-0.5 text-xs leading-relaxed text-muted-foreground">
+            默认由主色自动推导。仅在品牌规范有明确要求时，选择单项覆盖；“恢复自动”会重新跟随主色。
+          </p>
+        </div>
+        <span className="rounded-full bg-muted px-2 py-0.5 text-xs text-muted-foreground">
+          已覆盖 {Object.keys(theme.overrides ?? {}).length} 项
+        </span>
+      </div>
+      <div className="grid gap-3 lg:grid-cols-2">
+        {ADVANCED_COLOR_FIELDS.map((field) => {
+          const explicit = theme.overrides?.[field.key];
+          const automatic = automaticTokens[field.token] ?? "#0062D9";
+          const value = explicit ?? automatic;
+          return (
+            <div key={field.key} className="rounded-md border bg-background p-3">
+              <div className="mb-2 flex items-start justify-between gap-2">
+                <div>
+                  <div className="text-xs font-semibold">{field.label}</div>
+                  <div className="mt-0.5 text-[11px] text-muted-foreground">
+                    {field.description}
+                  </div>
+                </div>
+                {explicit ? (
+                  <Button
+                    type="button"
+                    variant="ghost"
+                    size="sm"
+                    className="h-7 px-2 text-xs"
+                    onClick={() => setOverride(field.key, "")}
+                  >
+                    <RotateCcwIcon className="mr-1 size-3.5" />
+                    恢复自动
+                  </Button>
+                ) : (
+                  <span className="rounded bg-muted px-1.5 py-0.5 text-[11px] text-muted-foreground">
+                    自动
+                  </span>
+                )}
+              </div>
+              <div className="flex flex-wrap items-end gap-2">
+                <InlineThemeColorPicker
+                  value={value}
+                  swatchColors={SUGGESTED_COLORS}
+                  onCommit={(color) => setOverride(field.key, color)}
+                  ariaLabel={`${theme.name || "自定义主题"}${field.label}选色器`}
+                />
+                <Input
+                  value={value}
+                  maxLength={7}
+                  className="h-8 w-28 font-mono text-xs uppercase"
+                  onChange={(event) => setOverride(field.key, event.target.value)}
+                  onBlur={(event) =>
+                    setOverride(
+                      field.key,
+                      event.target.value.trim()
+                        ? normalizeHexColor(event.target.value)
+                        : "",
+                    )
+                  }
+                  aria-label={`${theme.name || "自定义主题"}${field.label}十六进制值`}
+                />
+              </div>
+              {!explicit && (
+                <p className="mt-2 text-[11px] text-muted-foreground">
+                  当前自动值：{automatic}
+                </p>
+              )}
+            </div>
+          );
+        })}
+      </div>
+    </div>
+  );
+}
+
+export function CustomThemeLibrarySettings() {
+  const { data: appearance } = useAppearanceSettings();
+  const updateAppearance = useUpdateAppearanceSettings();
+  const [drafts, setDrafts] = useState<CustomThemePreset[]>([]);
+  const [advancedThemeIds, setAdvancedThemeIds] = useState<Set<string>>(
+    () => new Set(),
+  );
+
+  useEffect(() => {
+    setDrafts(normalizeThemeDrafts(appearance?.custom_themes));
+  }, [appearance?.custom_themes]);
+
+  const hasChanges = useMemo(
+    () =>
+      JSON.stringify(normalizeThemeDrafts(appearance?.custom_themes)) !==
+      JSON.stringify(normalizeThemeDrafts(drafts)),
+    [appearance?.custom_themes, drafts],
+  );
+
+  const patchTheme = (id: string, patch: Partial<CustomThemePreset>) => {
+    setDrafts((items) =>
+      items.map((item) => (item.id === id ? { ...item, ...patch } : item)),
+    );
+  };
+
+  const toggleAdvancedTheme = (id: string) => {
+    setAdvancedThemeIds((ids) => {
+      const next = new Set(ids);
+      if (next.has(id)) next.delete(id);
+      else next.add(id);
+      return next;
+    });
+  };
+
+  const handleSave = async () => {
+    const cleaned = normalizeThemeDrafts(drafts).map((theme) => ({
+      ...theme,
+      name: theme.name.trim(),
+      primary: normalizeHexColor(theme.primary),
+    }));
+    if (cleaned.some((theme) => !theme.name)) {
+      toast.error("请为每个主题填写名称");
+      return;
+    }
+    const names = cleaned.map((theme) => theme.name.toLocaleLowerCase());
+    if (new Set(names).size !== names.length) {
+      toast.error("主题名称不能重复");
+      return;
+    }
+
+    try {
+      await updateAppearance.mutateAsync({ custom_themes: cleaned });
+      toast.success("自定义主题库已保存，所有用户可在主题切换器中选择已启用主题");
+    } catch (error) {
+      toast.error(error instanceof Error ? error.message : "保存主题库失败");
+    }
+  };
+
+  const handleSetDefault = async (theme: CustomThemePreset) => {
+    if (!theme.enabled || appearance?.default_theme === theme.id) return;
+    if (!(appearance?.custom_themes ?? []).some((preset) => preset.id === theme.id)) {
+      toast.info("请先保存主题库，再将新主题设为系统默认");
+      return;
+    }
+    try {
+      await updateAppearance.mutateAsync({ default_theme: theme.id });
+      toast.success(`已将“${theme.name || "自定义主题"}”设为系统默认主题`);
+    } catch (error) {
+      toast.error(error instanceof Error ? error.message : "设置系统默认主题失败");
+    }
+  };
+
+  return (
+    <div className="space-y-4">
+      <div className="flex flex-wrap items-center justify-between gap-3">
+        <p className="max-w-2xl text-xs leading-relaxed text-muted-foreground">
+          默认只需设置主色、主按钮文字与明暗模式；系统会自动生成页面正文、背景、边框、弱化、选中和悬停色。点击“更多”后才按需覆盖个别交互色，停用后不再向用户展示，最多可保存 {MAX_CUSTOM_THEMES} 个。
+        </p>
+        <div className="flex items-center gap-2">
+          <Button
+            type="button"
+            size="sm"
+            variant="outline"
+            onClick={() =>
+              setDrafts((items) =>
+                items.length >= MAX_CUSTOM_THEMES
+                  ? items
+                  : [...items, newCustomTheme(items.length)],
+              )
+            }
+            disabled={drafts.length >= MAX_CUSTOM_THEMES || updateAppearance.isPending}
+          >
+            <PlusIcon className="mr-1.5 size-4" />
+            添加主题
+          </Button>
+          <Button
+            type="button"
+            size="sm"
+            onClick={() => void handleSave()}
+            disabled={!hasChanges || updateAppearance.isPending}
+          >
+            <SaveIcon className="mr-1.5 size-4" />
+            保存主题库
+          </Button>
+        </div>
+      </div>
+
+      {drafts.length === 0 ? (
+        <div className="rounded-lg border border-dashed bg-muted/20 px-5 py-8 text-center">
+          <PaletteIcon className="mx-auto mb-2 size-5 text-muted-foreground" />
+          <div className="text-sm font-medium">还没有自定义主题</div>
+          <p className="mt-1 text-xs text-muted-foreground">
+            添加后，用户可以从右上角主题切换器中自行选择。
+          </p>
+        </div>
+      ) : (
+        <div className="space-y-4">
+          {drafts.map((theme, index) => {
+            const isDefault = appearance?.default_theme === theme.id;
+            const advancedOpen = advancedThemeIds.has(theme.id);
+            const automaticTokens = getCustomThemeAutomaticTokens({
+              primary: theme.primary,
+              mode: theme.mode,
+            });
+            const textColor = theme.text_color ?? automaticTokens["--foreground"] ?? "#202A3A";
+            return (
+              <div key={theme.id} className="space-y-4 rounded-xl border bg-card p-4">
+                <div className="flex flex-wrap items-center justify-between gap-3">
+                  <div className="flex items-center gap-2">
+                    <PaletteIcon className="size-4 text-primary" />
+                    <span className="text-sm font-semibold">主题 {index + 1}</span>
+                    {isDefault && (
+                      <span className="inline-flex items-center gap-1 rounded-full bg-primary/10 px-2 py-0.5 text-xs font-medium text-primary">
+                        <CheckIcon className="size-3" />
+                        系统默认
+                      </span>
+                    )}
+                  </div>
+                  <div className="flex items-center gap-2">
+                    <label className="flex items-center gap-2 text-xs text-muted-foreground">
+                      <Switch
+                        checked={theme.enabled}
+                        onCheckedChange={(enabled) => patchTheme(theme.id, { enabled })}
+                        aria-label={`启用${theme.name || "自定义主题"}`}
+                      />
+                      {theme.enabled ? "启用" : "停用"}
+                    </label>
+                    <Button
+                      type="button"
+                      size="sm"
+                      variant={isDefault ? "default" : "outline"}
+                      onClick={() => void handleSetDefault(theme)}
+                      disabled={!theme.enabled || isDefault || hasChanges || updateAppearance.isPending}
+                    >
+                      设为默认
+                    </Button>
+                    <Button
+                      type="button"
+                      size="sm"
+                      variant="outline"
+                      onClick={() => toggleAdvancedTheme(theme.id)}
+                      aria-expanded={advancedOpen}
+                      aria-controls={`${theme.id}-advanced-colors`}
+                    >
+                      <SlidersHorizontalIcon className="mr-1.5 size-4" />
+                      更多
+                      {advancedOpen ? (
+                        <ChevronUpIcon className="ml-1 size-3.5" />
+                      ) : (
+                        <ChevronDownIcon className="ml-1 size-3.5" />
+                      )}
+                    </Button>
+                    <Button
+                      type="button"
+                      size="icon-sm"
+                      variant="ghost"
+                      className="text-destructive hover:text-destructive"
+                      onClick={() =>
+                        setDrafts((items) =>
+                          items
+                            .filter((item) => item.id !== theme.id)
+                            .map((item, order) => ({ ...item, sort_order: order })),
+                        )
+                      }
+                      title="删除主题"
+                      aria-label={`删除${theme.name || "自定义主题"}`}
+                    >
+                      <Trash2Icon className="size-4" />
+                    </Button>
+                  </div>
+                </div>
+
+                <div className="grid gap-3 md:grid-cols-[minmax(0,1fr)_minmax(180px,0.55fr)_150px_150px]">
+                  <label className="space-y-1.5">
+                    <span className="text-xs font-medium">主题名称</span>
+                    <Input
+                      value={theme.name}
+                      maxLength={32}
+                      onChange={(event) => patchTheme(theme.id, { name: event.target.value })}
+                      placeholder="例如：品牌浅蓝"
+                    />
+                  </label>
+                  <label className="space-y-1.5">
+                    <span className="text-xs font-medium">基础模式</span>
+                    <Select
+                      value={theme.mode}
+                      onValueChange={(value) =>
+                        patchTheme(theme.id, {
+                          mode: value === "dark" ? "dark" : "light",
+                        })
+                      }
+                    >
+                      <SelectTrigger>
+                        <SelectValue />
+                      </SelectTrigger>
+                      <SelectContent>
+                        <SelectItem value="light">
+                          <span className="inline-flex items-center gap-1.5"><SunIcon className="size-3.5" />浅色</span>
+                        </SelectItem>
+                        <SelectItem value="dark">
+                          <span className="inline-flex items-center gap-1.5"><MoonIcon className="size-3.5" />深色</span>
+                        </SelectItem>
+                      </SelectContent>
+                    </Select>
+                  </label>
+                  <label className="space-y-1.5">
+                    <span className="text-xs font-medium">主色值</span>
+                    <Input
+                      value={theme.primary}
+                      maxLength={7}
+                      className="font-mono uppercase"
+                      onChange={(event) => patchTheme(theme.id, { primary: event.target.value })}
+                      onBlur={() =>
+                        patchTheme(theme.id, {
+                          primary: normalizeHexColor(theme.primary),
+                        })
+                      }
+                      aria-label={`${theme.name || "自定义主题"}主色十六进制值`}
+                    />
+                  </label>
+                  <div className="space-y-1.5">
+                      <div className="flex items-center justify-between gap-2">
+                        <span className="text-xs font-medium">主按钮文字</span>
+                      {theme.text_color ? (
+                        <Button
+                          type="button"
+                          variant="ghost"
+                          size="sm"
+                          className="h-6 px-1.5 text-[11px]"
+                          onClick={() => patchTheme(theme.id, { text_color: null })}
+                        >
+                          自动
+                        </Button>
+                      ) : (
+                        <span className="text-[11px] text-muted-foreground">自动</span>
+                      )}
+                    </div>
+                    <Input
+                      value={textColor}
+                      maxLength={7}
+                      className="font-mono uppercase"
+                      onChange={(event) =>
+                        patchTheme(theme.id, { text_color: event.target.value })
+                      }
+                      onBlur={(event) =>
+                        patchTheme(theme.id, {
+                          text_color: event.target.value.trim()
+                            ? normalizeHexColor(event.target.value)
+                            : null,
+                        })
+                      }
+                        aria-label={`${theme.name || "自定义主题"}主按钮文字十六进制值`}
+                    />
+                  </div>
+                </div>
+
+                <div className="flex flex-wrap items-end gap-3 rounded-lg border bg-muted/15 p-3">
+                  <div className="space-y-1.5">
+                    <span className="text-xs font-medium">选择主色</span>
+                    <InlineThemeColorPicker
+                      value={theme.primary}
+                      swatchColors={SUGGESTED_COLORS}
+                      onCommit={(primary) => patchTheme(theme.id, { primary })}
+                      ariaLabel={`${theme.name || "自定义主题"}主色选色器`}
+                    />
+                  </div>
+                  <div className="space-y-1.5">
+                    <span className="text-xs font-medium">选择主按钮文字</span>
+                    <InlineThemeColorPicker
+                      value={textColor}
+                      fallback="#202A3A"
+                      swatchColors={TEXT_COLORS}
+                      onCommit={(text_color) => patchTheme(theme.id, { text_color })}
+                      ariaLabel={`${theme.name || "自定义主题"}主按钮文字选色器`}
+                    />
+                  </div>
+                  <div className="flex flex-wrap gap-1.5 pb-0.5">
+                    {SUGGESTED_COLORS.map((color) => (
+                      <button
+                        key={color}
+                        type="button"
+                        className={cn(
+                          "size-7 rounded-md border shadow-sm transition-transform hover:scale-105 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+                          normalizeHexColor(theme.primary) === color
+                            ? "ring-2 ring-primary ring-offset-2"
+                            : "border-border",
+                        )}
+                        style={{ backgroundColor: color }}
+                        onClick={() => patchTheme(theme.id, { primary: color })}
+                        title={`使用 ${color}`}
+                        aria-label={`使用主色 ${color}`}
+                      />
+                    ))}
+                  </div>
+                </div>
+
+                {advancedOpen && (
+                  <div id={`${theme.id}-advanced-colors`}>
+                    <AdvancedThemeColorControls
+                      theme={theme}
+                      onPatch={(patch) => patchTheme(theme.id, patch)}
+                    />
+                  </div>
+                )}
+
+                <CustomThemePreview theme={{ ...theme, primary: normalizeHexColor(theme.primary) }} />
+              </div>
+            );
+          })}
+        </div>
+      )}
+    </div>
+  );
+}

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

@@ -23,11 +23,10 @@ import {
   SparklesIcon,
   TagsIcon,
   Trash2Icon,
-  TrendingUpIcon,
-  Upload,
-  UserIcon,
-  WorkflowIcon,
-  XIcon,
+  TrendingUpIcon,
+  Upload,
+  UserIcon,
+  XIcon,
 } from "lucide-react";
 import { useRouter } from "next/navigation";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
@@ -51,6 +50,13 @@ import {
   EmptyTitle,
 } from "@/components/ui/empty";
 
+import {
+  Item,
+  ItemActions,
+  ItemTitle,
+  ItemContent,
+  ItemDescription,
+} from "@/components/ui/item";
 import { Input } from "@/components/ui/input";
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select";
 import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs";
@@ -464,11 +470,11 @@ function SkillSettingsList({ onClose }: { onClose?: () => void }) {
           </Button>
         </div>
       </header>
-      <TagSearchBar
-        targetType="skill"
-        onSearchChange={setSearch}
-        tagIds={tagIds}
-        onTagIdsChange={setTagIds}
+      <TagSearchBar
+        targetType="skill"
+        onSearchChange={setSearch}
+        tagIds={tagIds}
+        onTagIdsChange={setTagIds}
         actions={
           <div className="flex items-center gap-2">
             <ViewModeToggle value={viewMode} onChange={setViewMode} />
@@ -491,11 +497,16 @@ function SkillSettingsList({ onClose }: { onClose?: () => void }) {
                 <SelectItem value="name_desc">名称 Z-A</SelectItem>
               </SelectContent>
             </Select>
-          </div>
-        }
-      />
-      {publisher && (
-        <div className="flex items-center gap-2">
+          </div>
+        }
+      />
+      {!isLoading && !error && (
+        <div className="text-muted-foreground flex justify-end text-sm tabular-nums">
+          共 {orderedSkills.length} 个技能
+        </div>
+      )}
+      {publisher && (
+        <div className="flex items-center gap-2">
           <span className="text-muted-foreground text-xs">筛选发布者：</span>
           <button
             type="button"
@@ -736,9 +747,9 @@ export function SkillRow({
     }
   }
 
-  const badgeGroup = (
-    <div className="flex flex-wrap items-center gap-2">
-      <span className="min-w-0 truncate text-[15px] font-semibold tracking-[-0.01em] text-slate-900 dark:text-slate-100">
+  const badgeGroup = (
+    <div className="flex flex-wrap items-center gap-2">
+      <span className={cn(isCard && "truncate font-medium")}>
         {skill.name_zh?.trim() ? skill.name_zh : desensitize(skill.name)}
       </span>
       {skill.name_zh?.trim() && (
@@ -896,12 +907,12 @@ export function SkillRow({
     </>
   );
 
-  const actionButtons = (
+  const actionButtons = (
     <>
-      <Button
-        size="icon"
-        variant="ghost"
-        className="h-8 w-8 shrink-0 rounded-lg text-slate-500 hover:bg-slate-100 hover:text-slate-950 dark:text-slate-400 dark:hover:bg-slate-800 dark:hover:text-white"
+      <Button
+        size="icon"
+        variant="ghost"
+        className="h-8 w-8 shrink-0"
         onClick={() => setTagPickerOpen(true)}
         title={t.adminTags.manageTags}
       >
@@ -911,8 +922,8 @@ export function SkillRow({
         <Button
           size="icon"
           variant="ghost"
-          className={cn(
-            "h-8 w-8 shrink-0 rounded-lg text-slate-500 hover:bg-slate-100 hover:text-slate-950 dark:text-slate-400 dark:hover:bg-slate-800 dark:hover:text-white",
+          className={cn(
+            "h-8 w-8 shrink-0",
             skill.featured && "text-amber-600 hover:text-amber-700",
           )}
           disabled={setFeatured.isPending}
@@ -932,8 +943,8 @@ export function SkillRow({
         <Button
           size="icon"
           variant="ghost"
-          className={cn(
-            "h-8 w-8 shrink-0 rounded-lg text-slate-500 hover:bg-slate-100 hover:text-slate-950 dark:text-slate-400 dark:hover:bg-slate-800 dark:hover:text-white",
+          className={cn(
+            "h-8 w-8 shrink-0",
             skill.pinned && "text-emerald-600 hover:text-emerald-700",
           )}
           disabled={setPinned.isPending}
@@ -953,8 +964,8 @@ export function SkillRow({
         <Button
           size="icon"
           variant="ghost"
-          className={cn(
-            "h-8 w-8 shrink-0 rounded-lg text-slate-500 hover:bg-slate-100 hover:text-slate-950 dark:text-slate-400 dark:hover:bg-slate-800 dark:hover:text-white",
+          className={cn(
+            "h-8 w-8 shrink-0",
             skill.always_on && "text-amber-600 hover:text-amber-700",
           )}
           disabled={setAlwaysOn.isPending}
@@ -991,9 +1002,9 @@ export function SkillRow({
         </Button>
       )}
       <Button
-        size="icon"
-        variant="ghost"
-        className="h-8 w-8 shrink-0 rounded-lg text-slate-500 hover:bg-slate-100 hover:text-slate-950 dark:text-slate-400 dark:hover:bg-slate-800 dark:hover:text-white"
+        size="icon"
+        variant="ghost"
+        className="h-8 w-8 shrink-0"
         disabled={duplicateSkillMutation.isPending}
         onClick={handleOpenDuplicate}
         title="复制为新技能"
@@ -1002,9 +1013,9 @@ export function SkillRow({
       </Button>
       {canManage && (
         <Button
-        size="icon"
-        variant="ghost"
-        className="text-destructive hover:text-destructive h-8 w-8 shrink-0 rounded-lg hover:bg-red-50 dark:hover:bg-red-950/30"
+          size="icon"
+          variant="ghost"
+          className="text-destructive hover:text-destructive h-8 w-8 shrink-0"
           onClick={() => setConfirmDeleteOpen(true)}
           title={t.settings.skills.deleteAction}
         >
@@ -1012,124 +1023,41 @@ export function SkillRow({
         </Button>
       )}
     </>
-  );
-
-  const iconStyle = skill.name.includes("web") || skill.name.includes("search")
-    ? {
-        Icon: GlobeIcon,
-        className: "bg-emerald-600 text-white shadow-[0_6px_16px_rgba(22,163,74,0.22)]",
-      }
-    : skill.name.includes("doc") || skill.name.includes("file")
-      ? {
-          Icon: FileArchive,
-          className: "bg-violet-600 text-white shadow-[0_6px_16px_rgba(124,58,237,0.22)]",
-        }
-      : skill.source === "agent"
-        ? {
-            Icon: WorkflowIcon,
-            className: "bg-[#2166e8] text-white shadow-[0_6px_16px_rgba(37,99,235,0.22)]",
-          }
-        : {
-            Icon: Upload,
-            className: "bg-amber-500 text-white shadow-[0_6px_16px_rgba(245,158,11,0.22)]",
-          };
-  const SkillIcon = iconStyle.Icon;
-  const activityAt = formatDateTime(skill.last_activity_at ?? skill.created_at);
-  const actionArea = (
-    <div className="flex flex-wrap items-center justify-end gap-1" onClick={(event) => event.stopPropagation()}>
-      {actionButtons}
-    </div>
-  );
+  );
 
   return (
     <>
-      {isCard ? (
-        <div className="flex h-full min-w-0 flex-col rounded-xl border border-slate-200 bg-white p-5 shadow-[0_5px_18px_rgba(15,23,42,0.035)] transition-[border-color,box-shadow] hover:border-blue-200 hover:shadow-[0_10px_28px_rgba(37,99,235,0.07)] dark:border-slate-800 dark:bg-slate-900 dark:text-white">
-          <div
-            className="min-w-0 flex-1 cursor-pointer"
-            onClick={() => setDetailOpen(true)}
-          >
-            <div className="flex items-start gap-3.5">
-              <div className={cn("flex size-12 shrink-0 items-center justify-center rounded-full", iconStyle.className)}>
-                <SkillIcon className="size-6" />
-              </div>
-              <div className="min-w-0 flex-1">
-                {badgeGroup}
-                <p className="mt-1.5 line-clamp-3 text-sm leading-6 text-slate-600 dark:text-slate-400">
-                  {desensitize(skill.description ?? "")}
-                </p>
-              </div>
-            </div>
-            <div className="mt-4 flex flex-wrap items-center gap-2">
-              <Badge className={cn("border-0 px-2.5 py-1 text-xs font-normal", skill.enabled ? "bg-emerald-50 text-emerald-600 hover:bg-emerald-50 dark:bg-emerald-500/15 dark:text-emerald-300" : "bg-slate-100 text-slate-500 hover:bg-slate-100 dark:bg-slate-800 dark:text-slate-400")}>
-                <span className={cn("mr-1.5 size-1.5 rounded-full", skill.enabled ? "bg-emerald-500" : "bg-slate-400")} />
-                {skill.enabled ? "已启用" : "未启用"}
-              </Badge>
-              <span className="text-xs text-slate-400">{skill.use_count ? `调用 ${skill.use_count} 次` : "暂无调用"}</span>
-              {activityAt && <span className="text-xs text-slate-400">更新于 {activityAt}</span>}
-            </div>
-            {(skill.tags?.length ?? 0) > 0 && <TagChipList tags={skill.tags!} className="mt-3" />}
-          </div>
-          <div className="mt-4 border-t border-slate-100 pt-3 dark:border-slate-800">
-            {actionArea}
-          </div>
-        </div>
-      ) : (
-        <div className="group/skill-card w-full rounded-xl border border-slate-200 bg-white px-5 py-4 shadow-[0_5px_18px_rgba(15,23,42,0.03)] transition-[border-color,box-shadow] hover:border-blue-200 hover:shadow-[0_10px_28px_rgba(37,99,235,0.07)] dark:border-slate-800 dark:bg-slate-900 dark:text-white">
-          <div className="grid min-w-0 grid-cols-1 gap-4 xl:grid-cols-[minmax(0,1.65fr)_minmax(150px,0.72fr)_minmax(100px,0.42fr)_minmax(132px,0.58fr)_auto] xl:items-center xl:gap-x-6">
-            <div className="flex min-w-0 cursor-pointer items-start gap-4" onClick={() => setDetailOpen(true)}>
-              <div className={cn("flex size-[60px] shrink-0 items-center justify-center rounded-full", iconStyle.className)}>
-                <SkillIcon className="size-7" />
-              </div>
-              <div className="min-w-0 flex-1 pt-0.5">
-                {badgeGroup}
-                <p className="mt-1.5 line-clamp-2 text-sm leading-5 text-slate-600 dark:text-slate-400">
-                  {desensitize(skill.description ?? "")}
-                </p>
-                {!isBuiltin && skill.owner_username && (
-                  <button
-                    type="button"
-                    disabled={!skill.owner_user_id || !onPublisherClick}
-                    onClick={(event) => {
-                      event.stopPropagation();
-                      if (!skill.owner_user_id || !onPublisherClick) return;
-                      onPublisherClick({ id: skill.owner_user_id, label: desensitize(skill.owner_username!) });
-                    }}
-                    className={cn(
-                      "mt-2 flex max-w-full items-center gap-1 text-xs text-slate-400",
-                      skill.owner_user_id && onPublisherClick && "cursor-pointer hover:text-blue-600 hover:underline",
-                    )}
-                  >
-                    <UserIcon className="size-3.5 shrink-0" />
-                    <span className="truncate">发布者：{desensitize(skill.owner_username)}</span>
-                  </button>
-                )}
-              </div>
-            </div>
-            <div className="min-w-0 xl:border-l xl:border-slate-100 xl:pl-5 xl:dark:border-slate-800">
-              {(skill.tags?.length ?? 0) > 0 ? (
-                <TagChipList tags={skill.tags!} />
-              ) : (
-                <span className="text-xs text-slate-400">未设置标签</span>
-              )}
-            </div>
-            <div className="min-w-0 text-sm text-slate-600 dark:text-slate-300">
-              <span className="block text-xs text-slate-400 xl:hidden">使用次数</span>
-              {skill.use_count ? `${skill.use_count} 次` : "暂无调用"}
-            </div>
-            <div className="min-w-0">
-              <Badge className={cn("border-0 px-2.5 py-1 text-xs font-normal", skill.enabled ? "bg-emerald-50 text-emerald-600 hover:bg-emerald-50 dark:bg-emerald-500/15 dark:text-emerald-300" : "bg-slate-100 text-slate-500 hover:bg-slate-100 dark:bg-slate-800 dark:text-slate-400")}>
-                <span className={cn("mr-1.5 size-1.5 rounded-full", skill.enabled ? "bg-emerald-500" : "bg-slate-400")} />
-                {skill.enabled ? "已启用" : "未启用"}
-              </Badge>
-              {activityAt && <p className="mt-2 truncate text-xs text-slate-400" title={activityAt}>更新于 {activityAt}</p>}
-            </div>
-            <div className="min-w-0 border-t border-slate-100 pt-3 xl:border-t-0 xl:pt-0 dark:border-slate-800">
-              {actionArea}
-            </div>
-          </div>
-        </div>
-      )}
+      {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="min-w-0 flex-1 cursor-pointer"
+            onClick={() => setDetailOpen(true)}
+          >
+            {badgeGroup}
+            <p className="text-muted-foreground mt-1 line-clamp-3 text-sm">
+              {desensitize(skill.description ?? "")}
+            </p>
+            {metaNodes}
+          </div>
+          <div className="mt-2 flex flex-wrap items-center justify-end gap-1 border-t pt-2 dark:border-[#213D5E]">
+            {actionButtons}
+          </div>
+        </div>
+      ) : (
+        <Item className="w-full dark:border-[#213D5E] dark:bg-[#02244C] dark:text-white" variant="outline">
+          <ItemContent
+            className="cursor-pointer"
+            onClick={() => setDetailOpen(true)}
+          >
+            <ItemTitle>{badgeGroup}</ItemTitle>
+            <ItemDescription className="line-clamp-4">
+              {desensitize(skill.description ?? "")}
+            </ItemDescription>
+            {metaNodes}
+          </ItemContent>
+          <ItemActions>{actionButtons}</ItemActions>
+        </Item>
+      )}
       <Dialog open={duplicateOpen} onOpenChange={setDuplicateOpen}>
         <DialogContent>
           <DialogHeader>

frontend-web/src/components/workspace/skill-display-sources.tsx

@@ -53,7 +53,6 @@ export function SourceCard({
   referenceTarget?: boolean;
 }) {
   const [open, setOpen] = useState(false);
-  const [showOriginal, setShowOriginal] = useState(false);
   const [context, setContext] = useState<WeKnoraSourceContext | null>(null);
   const [contextLoading, setContextLoading] = useState(false);
   const [contextError, setContextError] = useState<string | null>(null);
@@ -82,7 +81,7 @@ export function SourceCard({
   const previewTarget = parseWeKnoraPreviewUrl(source.url);
 
   useEffect(() => {
-    if (!open || !showOriginal || !previewTarget) {
+    if (!open || !previewTarget) {
       return;
     }
     let cancelled = false;
@@ -116,7 +115,7 @@ export function SourceCard({
     return () => {
       cancelled = true;
     };
-  }, [open, showOriginal, previewTarget?.chunkId, previewTarget?.knowledgeBaseId]);
+  }, [open, previewTarget?.chunkId, previewTarget?.knowledgeBaseId]);
 
   return (
     <>
@@ -129,10 +128,7 @@ export function SourceCard({
           highlighted &&
             "border-amber-300 bg-amber-50/80 shadow-[0_0_0_2px_rgba(251,191,36,0.14)]",
         )}
-        onClick={() => {
-          setShowOriginal(false);
-          setOpen(true);
-        }}
+        onClick={() => setOpen(true)}
       >
         <div className="flex items-start gap-3">
           {showReferenceNumber && (
@@ -172,15 +168,7 @@ export function SourceCard({
           )}
         </div>
       </button>
-      <Dialog
-        open={open}
-        onOpenChange={(nextOpen) => {
-          setOpen(nextOpen);
-          if (!nextOpen) {
-            setShowOriginal(false);
-          }
-        }}
-      >
+      <Dialog open={open} onOpenChange={setOpen}>
         <DialogContent className="max-w-2xl">
           <DialogHeader>
             <div className="flex items-start justify-between gap-3 pr-8">
@@ -217,27 +205,7 @@ export function SourceCard({
               )}
             </div>
           </DialogHeader>
-          {previewTarget && (
-            <div className="border-b pb-3">
-              <div className="flex flex-wrap items-center justify-between gap-2">
-                <span className="text-muted-foreground text-xs">
-                  {showOriginal
-                    ? "正在查看命中文段及其前后上下文"
-                    : "当前为检索命中的片段，可继续查看原文上下文"}
-                </span>
-                <Button
-                  type="button"
-                  size="sm"
-                  variant={showOriginal ? "outline" : "default"}
-                  onClick={() => setShowOriginal((current) => !current)}
-                >
-                  <FileTextIcon className="size-3.5" />
-                  {showOriginal ? "返回检索片段" : "查看原文"}
-                </Button>
-              </div>
-            </div>
-          )}
-          {previewTarget && showOriginal ? (
+          {previewTarget ? (
             <WeKnoraSourceContextPanel
               context={context}
               loading={contextLoading}
@@ -281,27 +249,12 @@ type WeKnoraSourceContext = {
   }>;
 };
 
-export function isWeKnoraSourcePreviewUrl(url?: string): boolean {
-  return parseWeKnoraPreviewUrl(url) !== null;
-}
-
 function parseWeKnoraPreviewUrl(url?: string): WeKnoraPreviewTarget | null {
-  const normalizedUrl = url
-    ?.trim()
-    .replace(/^[\u200B-\u200D\uFEFF]+/, "");
-  const marker = "/weknora-source-preview?";
-  const start = normalizedUrl?.indexOf(marker) ?? -1;
-  if (start < 0) {
+  if (!url?.startsWith("/weknora-source-preview?")) {
     return null;
   }
-  // Some MCP tool results wrap the relative pointer in formatting characters
-  // or append a newline. Keep accepting that safe internal path, but never
-  // treat a normal external URL as an original-document preview.
-  const previewUrl = normalizedUrl!
-    .slice(start)
-    .split(/[\r\n\s]/, 1)[0];
-  const queryIndex = previewUrl.indexOf("?");
-  const params = new URLSearchParams(previewUrl.slice(queryIndex + 1));
+  const queryIndex = url.indexOf("?");
+  const params = new URLSearchParams(url.slice(queryIndex + 1));
   const knowledgeBaseId = params.get("knowledge_base_id")?.trim();
   const chunkId = params.get("chunk_id")?.trim();
   return knowledgeBaseId && chunkId ? { knowledgeBaseId, chunkId } : null;

frontend-web/src/components/workspace/user-identity-badge.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { UserRound } from "lucide-react";
+import { User } from "lucide-react";
 
 import { useLiveAccount } from "@/core/auth/use-live-account";
 import { useMyPosition } from "@/core/positions";
@@ -15,13 +15,7 @@ import { cn } from "@/lib/utils";
  * 配色按当前内容区前景色（foreground / muted-foreground），适配聊天页浅底顶栏，
  * 而非 Header 的白字贴 banner 方案。
  */
-export function UserIdentityBadge({
-  className,
-  variant = "plain",
-}: {
-  className?: string;
-  variant?: "plain" | "topbar";
-}) {
+export function UserIdentityBadge({ className }: { className?: string }) {
   // userInfo belongs to external-app route parameters and can legitimately
   // outlive a login switch. The visible account name must instead match the
   // settings page's current auth identity.
@@ -32,33 +26,13 @@ export function UserIdentityBadge({
 
   return (
     <div
-      data-workspace-user={variant}
-      className={cn(
-        "flex shrink-0 items-center gap-2",
-        variant === "topbar" &&
-          "h-10 max-w-[240px] rounded-lg px-1.5 py-1 text-slate-700 dark:text-slate-200",
-        className,
-      )}
+      className={cn("flex shrink-0 items-center gap-2", className)}
       title={positionName ? `${displayName}·${positionName}` : displayName}
     >
-      <div
-        className={cn(
-          "bg-muted text-muted-foreground relative flex size-7 shrink-0 items-center justify-center rounded-full",
-          variant === "topbar" &&
-            "size-8 bg-gradient-to-br from-blue-500 to-indigo-600 text-white shadow-[0_4px_12px_-6px_rgba(37,99,235,0.8)] ring-1 ring-blue-500/10 dark:from-blue-400 dark:to-indigo-500",
-        )}
-      >
-        <UserRound className={cn("size-3.5", variant === "topbar" && "size-4")} />
-        {variant === "topbar" && (
-          <span className="absolute right-0 bottom-0 size-2.5 rounded-full border-2 border-white bg-emerald-500 dark:border-slate-950" />
-        )}
+      <div className="bg-muted text-muted-foreground flex size-7 shrink-0 items-center justify-center rounded-full">
+        <User className="size-3.5" />
       </div>
-      <div
-        className={cn(
-          "hidden min-w-0 text-left sm:block",
-          variant === "topbar" && "max-w-[165px]",
-        )}
-      >
+      <div className="hidden min-w-0 text-left sm:block">
         <p className="text-foreground truncate text-sm font-medium leading-tight">
           {displayName}
         </p>

frontend-web/src/components/workspace/welcome.tsx

@@ -3,7 +3,8 @@
 import { useSearchParams } from "next/navigation";
 import { useMemo } from "react";
 
-import { useI18n } from "@/core/i18n/hooks";
+import { useI18n } from "@/core/i18n/hooks";
+import { useDisplayDesensitizer } from "@/core/sensitive-words/use-display-desensitizer";
 import { cn } from "@/lib/utils";
 
 import { AuroraText } from "../ui/aurora-text";
@@ -15,7 +16,8 @@ export function Welcome({
   className?: string;
   mode?: "ultra" | "pro" | "thinking" | "flash";
 }) {
-  const { t } = useI18n();
+  const { t } = useI18n();
+  const desensitizeText = useDisplayDesensitizer();
   const searchParams = useSearchParams();
   const isUltra = useMemo(() => mode === "ultra", [mode]);
   const colors = useMemo(() => {
@@ -36,7 +38,7 @@ export function Welcome({
           t.welcome.createYourOwnSkill
         ) : (
           <div className="flex items-center">
-            <AuroraText colors={colors}>{t.welcome.greeting}</AuroraText>
+            <AuroraText colors={colors}>{desensitizeText(t.welcome.greeting)}</AuroraText>
           </div>
         )}
       </div>

frontend-web/src/components/workspace/workspace-container.tsx

@@ -12,10 +12,8 @@ import {
   BreadcrumbPage,
   BreadcrumbSeparator,
 } from "@/components/ui/breadcrumb";
-import { useI18n } from "@/core/i18n/hooks";
-import { cn } from "@/lib/utils";
-import { ThemeSwitcher } from "@/components/workspace/appearance-controls";
-import { UserIdentityBadge } from "@/components/workspace/user-identity-badge";
+import { useI18n } from "@/core/i18n/hooks";
+import { cn } from "@/lib/utils";
 
 export function WorkspaceContainer({
   className,
@@ -95,15 +93,9 @@ export function WorkspaceHeader({
           </BreadcrumbList>
         </Breadcrumb>
       </div>
-      <div className="flex items-center gap-2 px-4">
-        {rightActions}
-        <ThemeSwitcher tone="content" />
-        <div
-          aria-hidden="true"
-          className="mx-1 h-6 w-px bg-slate-200 dark:bg-slate-700"
-        />
-        <UserIdentityBadge variant="topbar" />
-      </div>
+      {rightActions ? (
+        <div className="flex items-center gap-2 px-4">{rightActions}</div>
+      ) : null}
     </header>
   );
 }
@@ -131,8 +123,7 @@ function nameOfSegment(
   t: ReturnType<typeof useI18n>["t"],
 ) {
   if (!segment) return t.common.home;
-  if (segment === "workspace") return t.breadcrumb.workspace;
-  if (segment === "chats") return t.breadcrumb.chats;
-  if (segment === "agents") return t.agents.title;
-  return segment[0]?.toUpperCase() + segment.slice(1);
-}
+  if (segment === "workspace") return t.breadcrumb.workspace;
+  if (segment === "chats") return t.breadcrumb.chats;
+  return segment[0]?.toUpperCase() + segment.slice(1);
+}

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

@@ -14,7 +14,7 @@ import {
 } from "@/components/ui/sidebar";
 import { useI18n } from "@/core/i18n/hooks";
 // import { BotIcon, BrainIcon, ListChecks, MessageSquarePlus, MessagesSquare, SparklesIcon, UsersIcon } from "lucide-react";
-import { BookOpen, BotIcon, BrainIcon, ListChecks, MessageSquarePlus, MessagesSquare, PenLine, Plus, SparklesIcon, Users } from "lucide-react";
+import { BookOpen, BotIcon, BrainIcon, BriefcaseBusiness, ListChecks, MessageSquarePlus, MessagesSquare, PenLine, Plus, SparklesIcon, Users } from "lucide-react";
 
 import { KnowledgeRagToggle } from "./knowledge-rag-toggle";
 import { SidebarCollapseButton } from "./workspace-header";
@@ -23,19 +23,19 @@ import { cn } from "@/lib/utils";
 
 // 普通导航项：默认中性色，激活态与「新对话」一致——主色浅底 + 主色文字/图标
 const NAV_ITEM_CLASS =
-  "text-sidebar-foreground/80 hover:text-primary rounded-xl h-9 px-3 transition-colors hover:bg-primary/10 " +
+  "workspace-nav-item text-sidebar-foreground/80 hover:text-primary rounded-xl h-9 px-3 transition-colors hover:bg-primary/10 " +
   "data-[active=true]:bg-primary/15 data-[active=true]:text-primary data-[active=true]:shadow-none " +
   "dark:hover:bg-primary/15 dark:data-[active=true]:bg-primary/25 dark:data-[active=true]:text-primary-foreground";
 
 // 「新对话」专属：默认仅主色文字/图标（显眼但不是选中态），命中 /chats/new 时才上主色底
 const NEW_CHAT_CLASS =
-  "rounded-xl h-9 px-3 text-primary transition-colors hover:bg-primary/10 hover:text-primary " +
+  "workspace-nav-new-chat rounded-xl h-9 px-3 text-primary transition-colors hover:bg-primary/10 hover:text-primary " +
   "data-[active=true]:bg-primary/15 data-[active=true]:text-primary data-[active=true]:shadow-none " +
   "dark:text-primary-foreground dark:hover:bg-primary/15 dark:data-[active=true]:bg-primary/25";
 
 // 紧凑模式（CM 参考图）：白卡描边、居中、主色 + 图标
 const NEW_CHAT_COMPACT_CLASS =
-  "h-9 justify-center gap-2 rounded-xl bg-card text-[13px] font-semibold text-foreground transition-colors " +
+  "workspace-compact-new-chat h-9 justify-center gap-2 rounded-xl bg-card text-[13px] font-semibold text-foreground transition-colors " +
   "border border-[rgb(var(--legacy-primary-rgb)/18%)] " +
   "hover:bg-[rgb(var(--legacy-primary-rgb)/4%)] hover:text-[var(--primary)] hover:border-[rgb(var(--legacy-primary-rgb)/32%)] " +
   "data-[active=true]:bg-card data-[active=true]:text-[var(--primary)] data-[active=true]:shadow-none";
@@ -184,6 +184,19 @@ export function WorkspaceNavChatList({
                 </Link>
               </SidebarMenuButton>
             </SidebarMenuItem>
+            <SidebarMenuItem>
+              <SidebarMenuButton
+                isActive={pathname.startsWith("/page/workspace/roundtable/position")}
+                asChild
+                className={NAV_ITEM_CLASS}
+              >
+                <Link href="/page/workspace/roundtable/position">
+                  <BriefcaseBusiness />
+                  <span>岗位会商</span>
+                </Link>
+              </SidebarMenuButton>
+            </SidebarMenuItem>
+            {/* [MAF-R0] 实验原型已从正式菜单隐藏，仅保留路由供开发诊断：/page/maf */}
             <SidebarMenuItem>
               <SidebarMenuButton
                 isActive={pathname === "/page/workspace/scheduled/tasks"}

frontend-web/src/components/workspace/workspace-nav-menu.tsx

@@ -11,7 +11,6 @@ import {
   GaugeIcon,
   HistoryIcon,
   MessageCircleQuestionIcon,
-  PlugIcon,
   ScrollTextIcon,
   Settings2Icon,
   SettingsIcon,
@@ -219,14 +218,14 @@ export function WorkspaceNavMenu() {
                     <TagsIcon />
                     {t.adminTags.title}
                   </DropdownMenuItem>
-                  {isAdmin && (
+                  {/* {isAdmin && (
                     <DropdownMenuItem
                       onClick={() => navigate("/page/workspace/admin/plugins")}
                     >
                       <PlugIcon />
                       插件管理
                     </DropdownMenuItem>
-                  )}
+                  )} */}
                   {isAdmin && (
                     <DropdownMenuItem
                       onClick={() => navigate("/page/workspace/admin/positions")}
@@ -235,6 +234,14 @@ export function WorkspaceNavMenu() {
                       岗位管理
                     </DropdownMenuItem>
                   )}
+                  {isAdmin && (
+                    <DropdownMenuItem
+                      onClick={() => navigate("/page/workspace/admin/position-roles")}
+                    >
+                      <BriefcaseIcon />
+                      岗位角色配置
+                    </DropdownMenuItem>
+                  )}
                   {isAdmin && (
                     <DropdownMenuItem
                       onClick={() =>

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

@@ -1,44 +1,140 @@
-"use client";
-
-import {
-  Sidebar,
-  SidebarContent,
-  useSidebar,
-} from "@/components/ui/sidebar";
-import { cn } from "@/lib/utils";
-
-import { CmChatSidebar } from "./cm-chat-sidebar";
-
+"use client";
+
+import {
+  Sidebar,
+  SidebarHeader,
+  SidebarContent,
+  SidebarFooter,
+  SidebarRail,
+  useSidebar,
+} from "@/components/ui/sidebar";
+import { useTheme } from "@/contexts/ThemeContext";
+import { cn } from "@/lib/utils";
+import { usePathname } from "next/navigation";
+
+import { GeneralQaSidebar } from "./general-qa-sidebar";
+import { RecentChatList } from "./recent-chat-list";
+import { RecentRoundtableList } from "./recent-roundtable-list";
+import { RecentWritingList } from "./recent-writing-list";
+import { WorkspaceHeader } from "./workspace-header";
+import { WorkspaceNavChatList } from "./workspace-nav-chat-list";
+import { WorkspaceNavMenu } from "./workspace-nav-menu";
+
 export function WorkspaceSidebar({
+  compactChrome = false,
+  forceCollapsed = false,
   className,
-  compactChrome: _compactChrome,
   ...props
-}: React.ComponentProps<typeof Sidebar> & { compactChrome?: boolean }) {
-  const { open: isSidebarOpen, toggleSidebar } = useSidebar();
+}: React.ComponentProps<typeof Sidebar> & {
+  compactChrome?: boolean;
+  forceCollapsed?: boolean;
+}) {
+  const { open: isSidebarOpen } = useSidebar();
+  const { theme } = useTheme();
+  const pathname = usePathname();
+  const useWhiteSidebar = compactChrome && theme === "light";
+  // 通用问答（全量模式）左栏：新建回答 → 常用智能体 → 聊天记录（需求 0616 #1）。
+  // 仅在通用问答（/page/workspace/chats*）下启用三块式布局；点击常用智能体后是
+  // 「原地嵌入」（停留在 /chats/new?agent=...，仅右侧问答区换成智能体对话），左侧栏不变。
+  const isGeneralQa = pathname.startsWith("/page/workspace/chats");
 
-  return (
-    <div
-        aria-hidden={false}
+  if (forceCollapsed) {
+    return (
+      <Sidebar
+        variant="sidebar"
+        collapsible="icon"
         className={cn(
-          "h-full shrink-0 overflow-hidden transition-[width] duration-200 ease-out",
-          isSidebarOpen ? "w-(--sidebar-width)" : "w-14",
+          "bg-sidebar [&_[data-slot=sidebar-inner]]:bg-sidebar",
+          className,
         )}
+        {...props}
       >
-        <Sidebar
-          variant="sidebar"
-          collapsible="none"
-          className={cn(
-            "h-full border-r border-border",
-            isSidebarOpen ? "w-(--sidebar-width)" : "w-14",
-            "[&_[data-slot=sidebar-container]]:bg-white [&_[data-slot=sidebar-inner]]:bg-white",
-            className,
-          )}
-          {...props}
-        >
-          <SidebarContent>
-            <CmChatSidebar onCollapse={toggleSidebar} collapsed={!isSidebarOpen} />
-          </SidebarContent>
-        </Sidebar>
-      </div>
-  );
-}
+        <SidebarContent>
+          <WorkspaceNavChatList />
+        </SidebarContent>
+      </Sidebar>
+    );
+  }
+
+  // 紧凑模式：用「外层定宽容器 + transition-[width]」做展开/收起过渡动画。
+  // collapsible="none" 的 Sidebar 是普通 in-flow 定宽块（非 absolute，故不受本布局对
+  // sidebar-container 的 absolute/left-0 覆盖影响），外层 overflow-hidden 把它从
+  // --sidebar-width 裁到 0、聊天区随宽度平滑回流；收起后整列不接收指针。
+  if (compactChrome) {
+    return (
+      <div
+        aria-hidden={!isSidebarOpen}
+        className={cn(
+          "h-full shrink-0 overflow-hidden transition-[width] duration-200 ease-out",
+          isSidebarOpen ? "w-(--sidebar-width)" : "w-0 pointer-events-none",
+        )}
+      >
+        <Sidebar
+          variant="sidebar"
+          collapsible="none"
+          className={cn(
+            "h-full w-(--sidebar-width) border-r border-border",
+            useWhiteSidebar &&
+              "[&_[data-slot=sidebar-inner]]:bg-white [&_[data-slot=sidebar-container]]:bg-white",
+            className,
+          )}
+          {...props}
+        >
+          <SidebarContent>
+            {isGeneralQa ? (
+              // 全量版通用问答（/page/workspace/chats*）：新建对话侧栏独立成
+              // GeneralQaSidebar（按 0616 样式参考图重画），与其余 workspace 页解耦。
+              <GeneralQaSidebar />
+            ) : (
+              <>
+                <WorkspaceNavChatList showCollapseTrigger compact />
+                <RecentChatList compact />
+              </>
+            )}
+          </SidebarContent>
+          <SidebarRail />
+        </Sidebar>
+      </div>
+    );
+  }
+
+  return (
+    <>
+      <Sidebar
+        variant="sidebar"
+        // 紧凑模式：展开时为固定宽度整列（none，无内置折叠），收起由上面的条件渲染处理；
+        // 非紧凑沿用 icon。
+        collapsible={compactChrome ? "none" : "icon"}
+        className={cn(
+          useWhiteSidebar &&
+            "[&_[data-slot=sidebar-inner]]:bg-white [&_[data-slot=sidebar-container]]:bg-white",
+          className,
+        )}
+        {...props}
+      >
+        {!compactChrome && (
+          <SidebarHeader className="py-0">
+            <WorkspaceHeader />
+          </SidebarHeader>
+        )}
+        <SidebarContent>
+          <WorkspaceNavChatList
+            showCollapseTrigger={compactChrome}
+            compact={compactChrome}
+          />
+          {isSidebarOpen && <RecentChatList compact={compactChrome} />}
+          {/* 「多智能体会商」「最近写作」与「智能体/技能」等菜单项保持一致的显隐：
+              仅在非紧凑模式(!compactChrome)下展示，紧凑模式（有外层页面侧栏时）一并隐藏。 */}
+          {isSidebarOpen && !compactChrome && <RecentRoundtableList />}
+          {isSidebarOpen && !compactChrome && <RecentWritingList />}
+        </SidebarContent>
+        {!compactChrome && (
+          <SidebarFooter>
+            <WorkspaceNavMenu />
+          </SidebarFooter>
+        )}
+        <SidebarRail />
+      </Sidebar>
+    </>
+  );
+}

frontend-web/src/contexts/ThemeContext.tsx

@@ -8,13 +8,20 @@ import React, {
 import { useTheme as useNextTheme } from 'next-themes';
 
 import { useAppearanceSettings } from '@/core/system-settings/hooks';
+import {
+  BUILTIN_THEME_IDS,
+  type BuiltinThemeId,
+  type CustomThemePreset,
+} from '@/core/system-settings/api';
+import { getCustomThemeTokens, isCustomThemeId } from '@/core/theme/custom-theme';
+import { isPositionRoundtableStandaloneMode } from '@/position-roundtable/demo/position-roundtable-demo-config';
 
 // 主题类型
-export type ThemeType = 'dark' | 'light' | 'lightblue';
+export type ThemeType = BuiltinThemeId | `custom-theme-${string}`;
 
 // 主题配置
 export interface ThemeConfig {
-  type: ThemeType;
+  type: BuiltinThemeId;
   name: string;
   colors: {
     background: string;
@@ -37,7 +44,7 @@ export interface ThemeConfig {
 }
 
 // 主题配置
-const themes: Record<ThemeType, ThemeConfig> = {
+const themes: Record<BuiltinThemeId, ThemeConfig> = {
   dark: {
     type: 'dark',
     name: '深色主题',
@@ -104,6 +111,74 @@ const themes: Record<ThemeType, ThemeConfig> = {
       overlay: 'black/30',
     },
   },
+  lightgreen: {
+    type: 'lightgreen',
+    name: '绿色主题',
+    colors: {
+      background: 'white',
+      backgroundSecondary: 'emerald-50',
+      text: 'emerald-950',
+      textSecondary: 'emerald-800',
+      primary: 'emerald-600',
+      primaryHover: 'emerald-500',
+      border: 'emerald-200',
+      accent: 'emerald-700',
+      success: 'emerald-600',
+      warning: 'amber-500',
+      error: 'red-600',
+      card: 'white',
+      cardHover: 'emerald-50',
+      input: 'white',
+      inputBorder: 'emerald-200',
+      overlay: 'black/30',
+    },
+  },
+  iceblue: {
+    type: 'iceblue',
+    name: '冰川蓝主题',
+    colors: {
+      background: 'sky-50',
+      backgroundSecondary: 'sky-100',
+      text: 'slate-800',
+      textSecondary: 'slate-600',
+      // The CSS --primary token is exactly #9BCEF1. Darker blues are used
+      // only for readable text, hover and focus states.
+      primary: 'sky-200',
+      primaryHover: 'sky-300',
+      border: 'sky-200',
+      accent: 'sky-200',
+      success: 'emerald-600',
+      warning: 'amber-600',
+      error: 'red-600',
+      card: 'white',
+      cardHover: 'sky-50',
+      input: 'white',
+      inputBorder: 'sky-200',
+      overlay: 'slate-900/30',
+    },
+  },
+  lightyellow: {
+    type: 'lightyellow',
+    name: '浅黄色主题',
+    colors: {
+      background: 'lime-50',
+      backgroundSecondary: 'lime-100',
+      text: 'lime-950',
+      textSecondary: 'lime-800',
+      primary: 'lime-100',
+      primaryHover: 'lime-200',
+      border: 'lime-200',
+      accent: 'lime-100',
+      success: 'emerald-600',
+      warning: 'amber-600',
+      error: 'red-600',
+      card: 'white',
+      cardHover: 'lime-50',
+      input: 'white',
+      inputBorder: 'lime-200',
+      overlay: 'slate-900/30',
+    },
+  },
 };
 
 const STORAGE_KEY = 'strategy-theme';
@@ -114,13 +189,30 @@ const STORAGE_KEY = 'strategy-theme';
 // admin changes. When the flag is present we never override the user.
 const EXPLICIT_FLAG_KEY = 'strategy-theme-user-set';
 
+const CUSTOM_THEME_TOKEN_NAMES = Object.keys(
+  getCustomThemeTokens({ primary: '#0062D9', mode: 'light' }),
+);
+
+function isBuiltinTheme(value: string | null | undefined): value is BuiltinThemeId {
+  return typeof value === 'string' && (BUILTIN_THEME_IDS as readonly string[]).includes(value);
+}
+
+function getEnabledCustomTheme(
+  id: string | null | undefined,
+  presets: CustomThemePreset[] | undefined,
+): CustomThemePreset | undefined {
+  return isCustomThemeId(id)
+    ? presets?.find((preset) => preset.id === id && preset.enabled)
+    : undefined;
+}
+
 function readPersistedTheme(): ThemeType {
   if (typeof window === 'undefined') {
     return 'light';
   }
   const saved = localStorage.getItem(STORAGE_KEY);
-  if (saved === 'dark') return 'dark';
-  if (saved === 'lightblue') return 'lightblue';
+  if (isBuiltinTheme(saved)) return saved;
+  if (isCustomThemeId(saved)) return saved;
   return 'light';
 }
 
@@ -137,6 +229,8 @@ function markExplicitChoice(): void {
 // 主题上下文
 interface ThemeContextType {
   theme: ThemeType;
+  /** Resolved visual mode; custom themes keep their own light/dark setting. */
+  baseMode: 'light' | 'dark';
   themeConfig: ThemeConfig;
   toggleTheme: () => void;
   setTheme: (theme: ThemeType) => void;
@@ -161,7 +255,9 @@ export const ThemeProvider: React.FC<ThemeProviderProps> = ({ children }) => {
   // a theme yet, this value drives the rendered theme — and re-syncs on
   // every mount so an admin change propagates without users clearing
   // localStorage by hand.
-  const { data: appearance } = useAppearanceSettings();
+  const { data: appearance } = useAppearanceSettings({
+    enabled: !isPositionRoundtableStandaloneMode(),
+  });
 
   useEffect(() => {
     setMounted(true);
@@ -175,12 +271,7 @@ export const ThemeProvider: React.FC<ThemeProviderProps> = ({ children }) => {
     const current = localStorage.getItem(STORAGE_KEY);
     const legacy = localStorage.getItem('theme');
 
-    if (
-      current &&
-      current !== 'light' &&
-      current !== 'dark' &&
-      current !== 'lightblue'
-    ) {
+    if (current && !isBuiltinTheme(current) && !isCustomThemeId(current)) {
       // Garbage value — wipe it so the boot-sync below can take over.
       localStorage.removeItem(STORAGE_KEY);
     }
@@ -211,19 +302,48 @@ export const ThemeProvider: React.FC<ThemeProviderProps> = ({ children }) => {
   }, [mounted, forcedTheme, appearance?.default_theme, resolvedTheme, setNextTheme]);
 
   const effectiveTheme = forcedTheme ?? resolvedTheme;
-  const theme: ThemeType = mounted
-    ? effectiveTheme === 'dark'
-      ? 'dark'
-      : effectiveTheme === 'lightblue'
-        ? 'lightblue'
-        : 'light'
-    : readPersistedTheme();
+  const persistedTheme = readPersistedTheme();
+  const requestedTheme = (mounted ? effectiveTheme : persistedTheme) ?? 'light';
+  const customTheme = getEnabledCustomTheme(
+    requestedTheme,
+    appearance?.custom_themes,
+  );
+  const theme: ThemeType = isBuiltinTheme(requestedTheme)
+    ? requestedTheme
+    : customTheme?.id ?? 'light';
+  const baseMode: 'light' | 'dark' = customTheme?.mode ?? (theme === 'dark' ? 'dark' : 'light');
 
   useEffect(() => {
     if (typeof document === 'undefined') return;
 
     const root = document.documentElement;
 
+    // next-themes adds a class for every value passed to setTheme(). Custom
+    // themes use data attributes and CSS variables instead, so remove its
+    // transient class before applying the generated token set.
+    for (const className of [...root.classList]) {
+      if (isCustomThemeId(className)) {
+        root.classList.remove(className);
+      }
+    }
+    for (const tokenName of CUSTOM_THEME_TOKEN_NAMES) {
+      root.style.removeProperty(tokenName);
+    }
+    root.removeAttribute('data-custom-theme');
+
+    if (customTheme) {
+      for (const [tokenName, tokenValue] of Object.entries(
+        getCustomThemeTokens(customTheme),
+      )) {
+        root.style.setProperty(tokenName, tokenValue);
+      }
+      root.setAttribute('data-theme', customTheme.id);
+      root.setAttribute('data-custom-theme', 'true');
+      root.setAttribute('theme-mode', customTheme.mode);
+      root.classList.toggle('dark', customTheme.mode === 'dark');
+      return;
+    }
+
     if (theme === 'dark') {
       root.setAttribute('theme-mode', 'dark');
       root.classList.add('dark');
@@ -234,12 +354,17 @@ export const ThemeProvider: React.FC<ThemeProviderProps> = ({ children }) => {
     root.removeAttribute('theme-mode');
     root.classList.remove('dark');
 
-    if (theme === 'lightblue') {
-      root.setAttribute('data-theme', 'lightblue');
+    if (
+      theme === 'lightblue' ||
+      theme === 'lightgreen' ||
+      theme === 'iceblue' ||
+      theme === 'lightyellow'
+    ) {
+      root.setAttribute('data-theme', theme);
     } else {
       root.removeAttribute('data-theme');
     }
-  }, [theme]);
+  }, [customTheme, theme]);
 
   const toggleTheme = () => {
     setNextTheme(theme === 'dark' ? 'light' : 'dark');
@@ -251,11 +376,11 @@ export const ThemeProvider: React.FC<ThemeProviderProps> = ({ children }) => {
     markExplicitChoice();
   };
 
-  const themeConfig = themes[theme];
+  const themeConfig = themes[isBuiltinTheme(theme) ? theme : 'light'];
 
   return (
     <ThemeContext.Provider
-      value={{ theme, themeConfig, toggleTheme, setTheme, mounted }}
+      value={{ theme, baseMode, themeConfig, toggleTheme, setTheme, mounted }}
     >
       {children}
     </ThemeContext.Provider>
@@ -277,6 +402,20 @@ export const getThemeClasses = (colorKey: keyof ThemeConfig['colors']): string =
   return themeConfig.colors[colorKey];
 };
 
+/** Resolve custom runtime themes to the two visual modes expected by older
+ * integrations (reports, canvases and exported artifacts). */
+export function themeToBaseMode(theme: ThemeType): 'light' | 'dark' {
+  if (theme === 'dark') return 'dark';
+  if (
+    isCustomThemeId(theme) &&
+    typeof document !== 'undefined' &&
+    document.documentElement.getAttribute('theme-mode') === 'dark'
+  ) {
+    return 'dark';
+  }
+  return 'light';
+}
+
 // 组合类名工具函数
 export const cn = (...classes: (string | undefined | null | false)[]): string => {
   return classes.filter(Boolean).join(' ');

frontend-web/src/core/agents/hooks.ts

@@ -150,12 +150,15 @@ export function useAllAgentsAdmin(enabled: boolean) {
   return { agents: data ?? [], isLoading, error };
 }
 
-export function useAgent(id: string | null | undefined) {
-  const { data, isLoading, error } = useQuery({
-    queryKey: ["agents", id],
-    queryFn: () => getAgent(id!),
-    enabled: !!id,
-  });
+export function useAgent(
+  id: string | null | undefined,
+  { enabled = true }: { enabled?: boolean } = {},
+) {
+  const { data, isLoading, error } = useQuery({
+    queryKey: ["agents", id],
+    queryFn: () => getAgent(id!),
+    enabled: enabled && !!id,
+  });
   return { agent: data ?? null, isLoading, error };
 }
 

frontend-web/src/core/artifacts/loader.ts

@@ -19,12 +19,32 @@ export async function loadArtifactContent({
   let enhancedFilepath = filepath;
   if (filepath.endsWith(".skill")) {
     enhancedFilepath = filepath + "/SKILL.md";
-  }
-  const url = urlOfArtifact({ filepath: enhancedFilepath, threadId, isMock, publicShareCode });
-  const response = await apiFetch(url);
-  const text = await response.text();
-  return { content: text, url };
-}
+  }
+  const url = urlOfArtifact({ filepath: enhancedFilepath, threadId, isMock, publicShareCode });
+  const response = await apiFetch(url);
+  const text = await response.text();
+  if (!response.ok) {
+    let detail = text.trim();
+    try {
+      const parsed = JSON.parse(text) as { detail?: unknown; message?: unknown };
+      const parsedDetail =
+        typeof parsed.detail === "string"
+          ? parsed.detail
+          : typeof parsed.message === "string"
+            ? parsed.message
+            : "";
+      if (parsedDetail) {
+        detail = parsedDetail;
+      }
+    } catch {
+      // Keep the raw response text as the diagnostic detail.
+    }
+    throw new Error(
+      `Failed to load artifact (${response.status})${detail ? `: ${detail}` : ""}`,
+    );
+  }
+  return { content: text, url };
+}
 
 export function loadArtifactContentFromToolCall({
   url: urlString,

frontend-web/src/core/artifacts/utils.ts

@@ -1,12 +1,12 @@
 import { getBackendBaseURL } from "../config";
 import type { AgentThread } from "../threads";
 
-export function urlOfArtifact({
-  filepath,
-  threadId,
-  download = false,
-  isMock = false,
-  publicShareCode,
+export function urlOfArtifact({
+  filepath,
+  threadId,
+  download = false,
+  isMock = false,
+  publicShareCode,
 }: {
   filepath: string;
   threadId: string;
@@ -16,22 +16,24 @@ export function urlOfArtifact({
 }) {
   // A public read-only share has no auth-gated thread route — its referenced
   // files are served by the unauthenticated public-share endpoint instead.
-  if (publicShareCode) {
-    const normalized = filepath.startsWith("/") ? filepath : `/${filepath}`;
-    return `${getBackendBaseURL()}/api/public/shares/${encodeURIComponent(
-      publicShareCode,
-    )}/files${normalized}`;
-  }
-  if (isMock) {
-    return `${getBackendBaseURL()}/mock/api/threads/${threadId}/artifacts${filepath}${download ? "?download=true" : ""}`;
-  }
-  return `${getBackendBaseURL()}/api/threads/${threadId}/artifacts${filepath}${download ? "?download=true" : ""}`;
-}
+  if (publicShareCode) {
+    const normalized = filepath.startsWith("/") ? filepath : `/${filepath}`;
+    return `${getBackendBaseURL()}/api/public/shares/${encodeURIComponent(
+      publicShareCode,
+    )}/files${normalized}`;
+  }
+  const normalized = filepath.startsWith("/") ? filepath : `/${filepath}`;
+  if (isMock) {
+    return `${getBackendBaseURL()}/mock/api/threads/${threadId}/artifacts${normalized}${download ? "?download=true" : ""}`;
+  }
+  return `${getBackendBaseURL()}/api/threads/${threadId}/artifacts${normalized}${download ? "?download=true" : ""}`;
+}
 
 export function extractArtifactsFromThread(thread: AgentThread) {
   return thread.values.artifacts ?? [];
 }
 
-export function resolveArtifactURL(absolutePath: string, threadId: string) {
-  return `${getBackendBaseURL()}/api/threads/${threadId}/artifacts${absolutePath}`;
-}
+export function resolveArtifactURL(absolutePath: string, threadId: string) {
+  const normalized = absolutePath.startsWith("/") ? absolutePath : `/${absolutePath}`;
+  return `${getBackendBaseURL()}/api/threads/${threadId}/artifacts${normalized}`;
+}

frontend-web/src/core/auth/route-key-login.ts

@@ -0,0 +1,62 @@
+import { readRuntimeEnv } from "@/env";
+
+/**
+ * Short-link route map maintained by the frontend.
+ *
+ * Add a new entry here when an external system needs a short ``routeKey``.
+ * Targets must remain internal SPA routes; LoginPage validates them again
+ * before navigating. The optional display settings are converted into the
+ * existing route parameters on the destination URL.
+ */
+export interface RouteKeyMapping {
+  /** Internal SPA route to open after sign-in. */
+  path: string;
+  /** Add `hideChrome=1` to hide the global header and page sidebar. */
+  hideChrome?: boolean;
+  /** Add the existing `theme` route parameter and apply it during sign-in. */
+  theme?: string;
+}
+
+export const ROUTE_KEY_MAPPINGS: Readonly<Record<string, RouteKeyMapping>> = {
+  a: { path: "/page/canvas/ai-writing" },
+  "8bf": {
+    path: "/page/strategy/qa/8bf-roundtable",
+    hideChrome: true,
+    theme: "dark-blue",
+  },
+};
+
+/** Login URL parameter that selects a route from ``ROUTE_KEY_MAPPINGS``. */
+export const ROUTE_KEY_PARAM = "routeKey";
+
+/**
+ * Optional frontend-configured username-login password.
+ *
+ * This is intentionally an environment/runtime value rather than a literal in
+ * source code. It is used only with a mapped ``routeKey`` link. When it is
+ * empty, LoginPage falls back to the URL's existing ``password`` parameter.
+ */
+export function getRouteKeyLoginPassword(): string {
+  return readRuntimeEnv("VITE_ROUTE_LOGIN_PASSWORD") ?? "";
+}
+
+export function resolveRouteKeyMapping(
+  routeKey: string | null | undefined,
+): RouteKeyMapping | undefined {
+  const key = routeKey?.trim();
+  if (!key) return undefined;
+  return ROUTE_KEY_MAPPINGS[key];
+}
+
+export function resolveRouteKey(routeKey: string | null | undefined): string {
+  const mapping = resolveRouteKeyMapping(routeKey);
+  if (!mapping) return "";
+
+  const [path, ownQuery = ""] = mapping.path.split("?");
+  const query = new URLSearchParams(ownQuery);
+  if (mapping.hideChrome) query.set("hideChrome", "1");
+  if (mapping.theme) query.set("theme", mapping.theme);
+
+  const serializedQuery = query.toString();
+  return serializedQuery ? `${path}?${serializedQuery}` : path;
+}

frontend-web/src/core/branding/brand-assets.ts

@@ -0,0 +1,87 @@
+import fallbackLogoDark from "@/assets/img/brand-logo-dark.png";
+import fallbackLogoLight from "@/assets/img/brand-logo-light.png";
+import fallbackLogoLightblue from "@/assets/img/brand-logo-lightblue.png";
+import { readRuntimeEnv } from "@/env";
+
+export type BrandTheme = "light" | "lightblue" | "lightgreen" | "iceblue" | "lightyellow" | "dark";
+type BrandAssetTheme = BrandTheme | `custom-theme-${string}`;
+
+const headerFallbackAssets: Record<BrandTheme, string> = {
+  light: fallbackLogoLight,
+  lightblue: fallbackLogoLightblue,
+  lightgreen: fallbackLogoLight,
+  iceblue: fallbackLogoLightblue,
+  lightyellow: fallbackLogoLight,
+  dark: fallbackLogoDark,
+};
+
+const headerRuntimeKeys: Record<BrandTheme, string> = {
+  light: "VITE_BRAND_LOGO_LIGHT_URL",
+  lightblue: "VITE_BRAND_LOGO_LIGHTBLUE_URL",
+  lightgreen: "VITE_BRAND_LOGO_LIGHTGREEN_URL",
+  iceblue: "VITE_BRAND_LOGO_ICEBLUE_URL",
+  lightyellow: "VITE_BRAND_LOGO_LIGHTYELLOW_URL",
+  dark: "VITE_BRAND_LOGO_DARK_URL",
+};
+
+const welcomeRuntimeKeys: Record<BrandTheme, string> = {
+  light: "VITE_BRAND_WELCOME_LIGHT_URL",
+  lightblue: "VITE_BRAND_WELCOME_LIGHTBLUE_URL",
+  lightgreen: "VITE_BRAND_WELCOME_LIGHTGREEN_URL",
+  iceblue: "VITE_BRAND_WELCOME_ICEBLUE_URL",
+  lightyellow: "VITE_BRAND_WELCOME_LIGHTYELLOW_URL",
+  dark: "VITE_BRAND_WELCOME_DARK_URL",
+};
+
+function runtimeConfigBaseUrl(): string | undefined {
+  if (typeof document === "undefined") {
+    return undefined;
+  }
+
+  return document.querySelector<HTMLScriptElement>("script[data-runtime-config]")?.src;
+}
+
+/**
+ * Resolves an optional post-build brand override from runtime-config.js.
+ * Relative paths are anchored to runtime-config.js, which keeps the URL valid
+ * when the whole SPA is mounted below an Nginx location prefix.
+ */
+function readRuntimeBrandAsset(key: string): string | undefined {
+  const configuredUrl = readRuntimeEnv(key);
+  if (!configuredUrl) {
+    return undefined;
+  }
+
+  try {
+    const baseUrl =
+      runtimeConfigBaseUrl() ??
+      (typeof window !== "undefined" ? window.location.href : undefined);
+    return baseUrl ? new URL(configuredUrl, baseUrl).href : configuredUrl;
+  } catch {
+    return configuredUrl;
+  }
+}
+
+function resolveBrandTheme(theme: BrandAssetTheme): BrandTheme {
+  if (!theme.startsWith("custom-theme-")) return theme as BrandTheme;
+  return typeof document !== "undefined" && document.documentElement.getAttribute("theme-mode") === "dark"
+    ? "dark"
+    : "light";
+}
+
+export function getHeaderBrandAsset(theme: BrandAssetTheme): string {
+  const resolved = resolveBrandTheme(theme);
+  return readRuntimeBrandAsset(headerRuntimeKeys[resolved]) ?? headerFallbackAssets[resolved];
+}
+
+export function getHeaderBrandFallback(theme: BrandAssetTheme): string {
+  return headerFallbackAssets[resolveBrandTheme(theme)];
+}
+
+/**
+ * Welcome content deliberately has no bundled image fallback. An empty
+ * runtime URL keeps the original CM text + gradient treatment.
+ */
+export function getWelcomeBrandAsset(theme: BrandAssetTheme): string | undefined {
+  return readRuntimeBrandAsset(welcomeRuntimeKeys[resolveBrandTheme(theme)]);
+}

frontend-web/src/core/embed/embed-session.ts

@@ -1,3 +1,7 @@
+import { resolveEmbedThemeMode } from "./theme-mode.mjs";
+
+export { resolveEmbedThemeMode } from "./theme-mode.mjs";
+
 /**
  * 「外部系统 iframe 套用深链」相关的**按标签页**会话开关。承载三个相互独立的能力，多由 URL
  * 路由参数开启（独立会话 `isolate` 另可由「外观」设置里的开关在运行时切换，见 `setIsolatedSession`），
@@ -39,6 +43,8 @@ export interface EmbedSession {
   theme: EmbedTheme;
   /** 隐藏深链底部「快捷跳转」栏（TaskJumpBar：底部按钮 + 右侧悬浮菜单）。 */
   hideJump: boolean;
+  /** Only hide the global Header while retaining PageSidebar and normal app behavior. */
+  hideHeader: boolean;
   /**
    * 仅去全局 chrome（Header 导航栏 + PageSidebar 侧边栏），**不**强制主题、**不**隔离鉴权。
    * 区别于 `embed`：嵌入态会额外强制主题 + 走 sessionStorage 隔离登录身份；`hideChrome` 只想要
@@ -75,6 +81,11 @@ export function readHideJumpParam(search: string): FlagParam {
   return readFlagParam(search, "hideJump");
 }
 
+/** Read the URL's `hideHeader` three-state flag (hide only the global Header). */
+export function readHideHeaderParam(search: string): FlagParam {
+  return readFlagParam(search, "hideHeader");
+}
+
 /** 读 URL 里的 `hideChrome` 三态（仅去全局导航栏 + 侧边栏）。 */
 export function readHideChromeParam(search: string): FlagParam {
   return readFlagParam(search, "hideChrome");
@@ -85,16 +96,6 @@ export function readIsolateParam(search: string): FlagParam {
   return readFlagParam(search, "isolate");
 }
 
-/**
- * 把外部传入的主题色映射成离散明/暗。与 `resolveThemeFromQuery` 同源约定（dark-blue → 深色），
- * 另外宽松接受 `dark` / 中文「深色/深蓝」直传；其余（含空）一律浅色。
- */
-export function resolveEmbedThemeMode(raw: string | null | undefined): EmbedTheme {
-  const v = (raw ?? "").trim().toLowerCase();
-  if (v === "dark" || v === "dark-blue" || v === "深色" || v === "深蓝") return "dark";
-  return "light";
-}
-
 /** 取 URL query 里的 `theme` 值（embed 主题来源）。 */
 export function readEmbedThemeParam(search: string): string {
   return (toSearchParams(search).get("theme") ?? "").trim();
@@ -110,6 +111,7 @@ export function readEmbedSession(): EmbedSession | null {
       embed: p.embed === true,
       theme: p.theme === "dark" ? "dark" : "light",
       hideJump: p.hideJump === true,
+      hideHeader: p.hideHeader === true,
       hideChrome: p.hideChrome === true,
       isolate: p.isolate === true,
     };
@@ -121,7 +123,7 @@ export function readEmbedSession(): EmbedSession | null {
 /** 写会话；无任何开关置位时直接清除（保持 sessionStorage 干净）。隐私模式/quota 异常静默失败。 */
 function writeEmbedSession(next: EmbedSession): void {
   try {
-    if (!next.embed && !next.hideJump && !next.hideChrome && !next.isolate) {
+    if (!next.embed && !next.hideJump && !next.hideHeader && !next.hideChrome && !next.isolate) {
       sessionStorage.removeItem(EMBED_SESSION_KEY);
       return;
     }
@@ -141,6 +143,16 @@ export function isJumpBarHidden(): boolean {
   return readEmbedSession()?.hideJump === true;
 }
 
+/**
+ * Whether this tab should hide its global Header.
+ * `embed` and `hideChrome` also hide the Header, while `hideHeader` alone
+ * deliberately leaves PageSidebar visible.
+ */
+export function isHeaderHidden(): boolean {
+  const session = readEmbedSession();
+  return session?.embed === true || session?.hideChrome === true || session?.hideHeader === true;
+}
+
 /**
  * 本标签页是否要去全局 chrome（Header 导航栏 + PageSidebar 侧边栏）。
  * `embed` 已隐含去 chrome，故这里取「embed || hideChrome」之并——任一置位都隐藏。
@@ -151,6 +163,10 @@ export function isChromeHidden(): boolean {
   return s?.embed === true || s?.hideChrome === true;
 }
 
+export function isHideChromeActive(): boolean {
+  return readEmbedSession()?.hideChrome === true;
+}
+
 /**
  * 本标签页是否处于独立会话态：鉴权身份按标签页隔离（走 sessionStorage）。
  * `embed` 已隐含同样的隔离，故 `authStorage()` 取「embed || isolate」之并；这里只判 `isolate`，
@@ -168,7 +184,14 @@ export function isIsolatedSession(): boolean {
 export function syncEmbedSessionFromSearch(search: string): void {
   const cur =
     readEmbedSession() ??
-    { embed: false, theme: "light" as EmbedTheme, hideJump: false, hideChrome: false, isolate: false };
+    {
+      embed: false,
+      theme: "light" as EmbedTheme,
+      hideJump: false,
+      hideHeader: false,
+      hideChrome: false,
+      isolate: false,
+    };
   const next: EmbedSession = { ...cur };
 
   const embedParam = readEmbedParam(search);
@@ -183,6 +206,10 @@ export function syncEmbedSessionFromSearch(search: string): void {
   if (hideJumpParam === "on") next.hideJump = true;
   else if (hideJumpParam === "off") next.hideJump = false;
 
+  const hideHeaderParam = readHideHeaderParam(search);
+  if (hideHeaderParam === "on") next.hideHeader = true;
+  else if (hideHeaderParam === "off") next.hideHeader = false;
+
   const hideChromeParam = readHideChromeParam(search);
   if (hideChromeParam === "on") next.hideChrome = true;
   else if (hideChromeParam === "off") next.hideChrome = false;
@@ -234,6 +261,13 @@ export function resolveForcedEmbedTheme(search: string): EmbedTheme | undefined
 export function setIsolatedSession(on: boolean): void {
   const cur =
     readEmbedSession() ??
-    { embed: false, theme: "light" as EmbedTheme, hideJump: false, hideChrome: false, isolate: false };
+    {
+      embed: false,
+      theme: "light" as EmbedTheme,
+      hideJump: false,
+      hideHeader: false,
+      hideChrome: false,
+      isolate: false,
+    };
   writeEmbedSession({ ...cur, isolate: on });
 }