fix: fix iframe agent selector width

Dhk 1

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

.gitignore

@@ -90,12 +90,13 @@ git-clone/
 # Repo-root offline dependency pack (local only)
 /dist/
 
-# Frontend offline pack working directories
+# Frontend offline pack working directories
-frontend-web/.offline-pack-build/
+frontend-web/.offline-pack-build/
-frontend-web/.offline-extract-test/
+frontend-web/.offline-extract-test/
-
+frontend-web-node_modules-offline-*.tar.gz
-.codegraph
+
-codegraph.mdc
+.codegraph
+codegraph.mdc
 
 docs/aidev-docs
 docs/backups
@@ -112,4 +113,4 @@ offline-backend-20260512/backend/uv.lock
 __pycache__/
 
 # misc
-.DS_Store
+.DS_Store

AGENTS.md

@@ -79,6 +79,7 @@ The frontend (`frontend-web/`) is a React 19 + Vite SPA:
 
 - **Routing**: React Router v7; top-level routes in `src/pages/PageRoutes.tsx`, workspace sub-routes in `src/pages/WorkspaceRoutes.tsx`
 - **Pages**: `ChatPage` (thread chat), `AgentChatPage` (custom agent chat), `AgentsPage`/`NewAgentPage` (agent management), `ScheduledTasksPage`/`ScheduledTaskRunDetailPage` (scheduled tasks), `LightAppManagementPage`/`LightAppListPage`/`LightAppIframeView` (轻应用中心 — register/list/embed mini-apps)
+- **AI 写作·对话版（对话驱动写作台）**: a **parallel new entry** beside the classic AI-writing page (classic page/routes untouched) — route `/page/canvas/ai-writing-chat`, sidebar 「问答管理 → 课题研究(对话版)」. Page `open-canvas/pages/AIWritingChatPage.tsx` reuses the engine (`AIWritingContext` + `useStream` + `AIWritingDraftPanel`); **idle keeps the classic setup layout** (`WritingSetupChat` + collapsible form) and switches to the chat workbench once writing starts; left panel `components/ai-writing-chat/WritingChatPanel.tsx` = **unified chronological feed** (`ChatFlowTimeline.tsx`, chat bubbles anchor-interleaved into the progress timeline so triggered events render below the user's message) + button-only intervention cards (`ChatInterventionCards.tsx`, inline textareas removed) + bottom unified smart composer. Intent resolution: frontend fast path + `POST /api/ai-writing/sessions/{id}/intent` → `deerflow/agents/ai_writing/intent_router.py` (per-pause action whitelist, high-cost confidence gates, payload cleaning); supports QA bypass, clarify follow-ups, control intents, and material-stage auto re-search + pending-intent resume. Tests `tests/test_ai_writing_intent.py`; plan doc `frontend-web/docs/ai-writing-对话驱动写作台-实现方案.md`.
 - **轻应用中心 (Light App Center)**: a sibling of 任务管理 in the sidebar with two pages — 应用管理 (admin registers `window_open` or `iframe` mini-apps with a route-param builder: login params resolved from `localStorage.userInfo`, theme params literal) and 应用列表 (card grid of `window_open` apps, `window.open` launch). `iframe` apps are mounted under a chosen parent menu (XK/PG/TY/综合管理) and **dynamically injected into the sidebar** by `core/page-layout/use-sidebar-menu.ts` (`useSidebarMenuItems`), opening in the `LightAppIframeView` host. Client + React Query hooks in `strategy-components/api/light-apps.ts`; URL builder/constants in `strategy-components/lib/light-app.ts`. Backend: `/api/light-apps` (global/shared, admin-gated writes).
 - **菜单管理 (Menu Management, admin-only)**: an **overlay** over the static sidebar menu — `MenuManagementPage` (`pages/MenuManagementPage.tsx`, route `/page/strategy/admin/menu-management`, opened from the admin-only 「菜单管理」 item in the **bottom-left settings dropdown** of `components/page-sidebar.tsx`). Admins rename / 停用·启用 / reorder (↑↓ or @dnd-kit drag) / re-parent (horizontal drag **or** the edit dialog's 「移动到」parent selector) any node across 一级/二级/三级, **including injected iframe light-app nodes** (`light-app-<appId>`). The static tree (`core/page-layout/sidebar-menu.ts`) stays the source of icons/routes; only per-node deltas (`label`/`disabled`/`parentId`/`sortOrder`) persist to the backend. Merge logic in `core/page-layout/menu-overrides.ts` (`applyMenuOverrides`, applied in `use-sidebar-menu.ts` after light-app injection, before role filter; disabling a node hides its whole subtree) — strict **3-level cap** (`wouldExceedDepth`). Client `strategy-components/api/menu-overrides.ts`. Backend: `/api/menu-overrides` (global/shared; open read, admin atomic replace-all).
 - **敏感词管理 (Sensitive Word Management)**: configures the **展示层脱敏映射** (原始词 → 替换词). **Gated on the username `lqq`** (not the admin role) — `getAccountDisplayName().toLowerCase() === "lqq"` (username = email `@` prefix, else `user_id`, same as the profile page); the dropdown entry, the route guard, and the page-level guard all use this check. `src/lib/desensitize.ts` ships a frozen seed map `SEED_DESENSITIZE_MAP` (the deployment seed) plus a live mutable `DESENSITIZE_MAP` (initialized from the seed so `desensitize()` works before any fetch). `DesensitizeWordsLoader` (mounted in `App.tsx` `AppProviders`) fetches `/api/sensitive-words` on startup and, if non-empty, calls `replaceDesensitizeMap(...)` to make the backend config the source of truth (empty/failed → keep seed). Page `SensitiveWordsPage.tsx` (route `/page/strategy/admin/sensitive-words`, opened from the 「敏感词管理」 item in the **bottom-left settings dropdown** of `components/page-sidebar.tsx`, present in **both** full + collapsed sidebar modes) lists/adds/edits/启停/deletes words and saves the **whole set atomically** (replace-all); a 「导入种子词」 button merges any missing `SEED_DESENSITIZE_MAP` entries into the editor. Client + hooks in `strategy-components/api/sensitive-words.ts` (`wordsToMap` folds enabled rows into the runtime map). Backend: `/api/sensitive-words` (global/shared; open read, write allowed for admin **or** the `lqq` account), mirroring 菜单管理's store shape. **侧边栏 + 导航栏 menu labels are desensitized** at the data source: `useSidebarMenuItems`/`useActiveThirdLevel` (`core/page-layout/use-sidebar-menu.ts`) map every node's `label` through a desensitizer built **directly from the `/api/sensitive-words` query** (`makeDesensitizer(wordsToMap(words))`, falling back to the global seed `desensitize` while empty) — this sidesteps the `replaceDesensitizeMap` effect-timing race. Only `label` is rewritten; `path`/`id`/`icon` are untouched so routing/highlight are unaffected. All nav surfaces (`page-sidebar.tsx`, `page-sidebar-dark.tsx`, `page-sidebar-v1.tsx`, `strategy-components/Header.tsx`, `PageRoutes.tsx`) consume this hook and are covered; `MenuManagementPage` uses the raw tree so admins still edit real labels.

CLAUDE.md

@@ -80,6 +80,7 @@ The frontend (`frontend-web/`) is a React 19 + Vite SPA:
 - **Routing**: React Router v7; top-level routes in `src/pages/PageRoutes.tsx`, workspace sub-routes in `src/pages/WorkspaceRoutes.tsx`
 - **Pages**: `ChatPage` (thread chat), `AgentChatPage` (custom agent chat), `AgentsPage`/`NewAgentPage` (agent management), `ScheduledTasksPage`/`ScheduledTaskRunDetailPage` (scheduled tasks), `LightAppManagementPage`/`LightAppListPage`/`LightAppIframeView` (轻应用中心 — register/list/embed mini-apps)
 - **定时任务「JSON → HTML 模板填充」(模板数据转换器)**: a third scheduled-task execution mode. In the create/edit dialog (`ScheduledTasksPage.tsx`), selecting the built-in agent **「模板数据转换器」** (`execution_agent_name === "template-json-builder"`, `TEMPLATE_BUILDER_AGENT_ID`) reveals a 「HTML模板」 select (`useHtmlTemplates` → `GET /api/scheduled-tasks/html-templates`) + a **.json 上传** button (reads the file's text into the prompt box) and **hides** the 必须生成 HTML/Markdown switches (this mode always outputs HTML). The chosen template persists as `execution_context.template_config.template_id` (`TemplateFillConfig` in `core/scheduled-tasks/types.ts`). At run time the backend converts the source JSON (the task prompt) into that template's `DATA` structure, validates (retry-on-fail), fills the template, and stores an HTML page previewable via the existing run-detail HTML preview. The source can be **pure JSON, plain text, or text-with-embedded-JSON** — the backend pre-extracts any embedded JSON and the agent's `SOUL.md` maps it (or the plain text's semantics) to the template's schema skeleton. **Chat-page debug entry (only this agent's `AgentChatPage`)**: when `agent_id === "template-json-builder"`, the chat header shows a 「页面模板」 select + a 「渲染预览」 button — after a normal Q&A run, the button takes the **latest AI reply**, POSTs it to `POST /api/scheduled-tasks/template-fill/render` (`renderTemplateFill`), and pops a dialog rendering the filled HTML in a `sandbox="allow-scripts"` iframe plus the structure-validation status/errors/gaps — for debugging the agent's conversion effect without creating a scheduled task. Gated strictly on the agent id, so other agents' chat pages are untouched. See the backend CLAUDE.md「Template-fill mode」for the engine (`deerflow/runtime/scheduler/template_fill.py`), agent seed, dispatch, and the render API.
+- **AI 写作·对话版（对话驱动写作台）**: a **parallel new entry** beside the classic AI-writing page (classic page/routes untouched) — route `/page/canvas/ai-writing-chat` (`OpenCanvasRoutes.tsx`), sidebar 「问答管理 → 课题研究(对话版)」. Page `open-canvas/pages/AIWritingChatPage.tsx` fully **reuses the engine** (`AIWritingContext` state machine + LangGraph `useStream`, `AIWritingHistoryProvider`, right-side `AIWritingDraftPanel`) but replaces the presentation: left = `components/ai-writing-chat/WritingChatPanel.tsx` (timeline + **button-only intervention cards** `ChatInterventionCards.tsx` — the five pause cards copied from `InterventionCard.tsx` with all inline textareas removed, confirm/action buttons kept — plus a bottom **unified smart composer**). Free text goes through two-level intent resolution (`open-canvas/api/ai-writing-intent.ts`): deterministic short-phrase fast path (确认/继续/重新搜索/重写大纲…; high-cost actions never fast-pathed) then `POST /api/ai-writing/sessions/{id}/intent` — the backend reads the graph checkpoint (authoritative pause point from the pending interrupt) and routes via `deerflow/agents/ai_writing/intent_router.py` (LLM + strict per-pause action whitelist aligned to the graph's real resume actions, confidence gates: finalize/force_finalize/覆盖式 re_search need ≥0.85 else clarify, payload key-whitelist cleaning). Results map to `submitIntervention`/control (暂停/继续/后台挂起)/QA bypass (`answer` rendered as a chat bubble, never touches graph state)/clarify (amber follow-up bubble with multi-turn context). **Two-state layout**: idle (未开始写作) renders the **classic setup experience unchanged** — `WritingSetupChat` + collapsible `AIWritingPanel` form under `WritingFormProvider` (same as `AIWritingPage`'s idle branch); once writing starts (or history view opens) it switches to the chat workbench. **Unified chronological feed** (`ChatFlowTimeline.tsx`): intent-layer chat bubbles are interleaved INTO the progress-event timeline by anchor (= `progressEvents.length` at message creation), so events triggered by a user message render **below** it (Google-AI-Studio-style single stream, not timeline-above/chat-below); composer-driven interventions suppress the duplicate 「我的要求」card (`suppressedRequirementIndices`). **素材不足自动续跑** only at `material_confirm` (the only pause the graph supports re-search from): needResearch caches the payload as a pending intent, submits `re_search + userQuery`, and auto-submits the pending intent when the new material-confirm pause arrives (cancellable pill). Stage chips + per-stage placeholder + 「当前交互对象」status badge. Backend tests `tests/test_ai_writing_intent.py`. Plan doc: `frontend-web/docs/ai-writing-对话驱动写作台-实现方案.md`.
 - **轻应用中心 (Light App Center)**: a sibling of 任务管理 in the sidebar with two pages — 应用管理 (admin registers `window_open` or `iframe` mini-apps with a route-param builder: login params resolved from `localStorage.userInfo`, theme params literal) and 应用列表 (card grid of `window_open` apps, `window.open` launch). `iframe` apps are mounted under a chosen parent menu (XK/PG/TY/综合管理) and **dynamically injected into the sidebar** by `core/page-layout/use-sidebar-menu.ts` (`useSidebarMenuItems`), opening in the `LightAppIframeView` host. Client + React Query hooks in `strategy-components/api/light-apps.ts`; URL builder/constants in `strategy-components/lib/light-app.ts`. Backend: `/api/light-apps` (global/shared, admin-gated writes).
 - **菜单管理 (Menu Management, admin-only)**: an **overlay** over the static sidebar menu — `MenuManagementPage` (`pages/MenuManagementPage.tsx`, route `/page/strategy/admin/menu-management`, opened from the admin-only 「菜单管理」 item in the **bottom-left settings dropdown** of `components/page-sidebar.tsx`). Admins rename / 停用·启用 / reorder (↑↓ or @dnd-kit drag) / re-parent (horizontal drag **or** the edit dialog's 「移动到」parent selector) any node across 一级/二级/三级, **including injected iframe light-app nodes** (`light-app-<appId>`). The static tree (`core/page-layout/sidebar-menu.ts`) stays the source of icons/routes; only per-node deltas (`label`/`disabled`/`parentId`/`sortOrder`) persist to the backend. Merge logic in `core/page-layout/menu-overrides.ts` (`applyMenuOverrides`, applied in `use-sidebar-menu.ts` after light-app injection, before role filter; disabling a node hides its whole subtree) — strict **3-level cap** (`wouldExceedDepth`). Client `strategy-components/api/menu-overrides.ts`. Backend: `/api/menu-overrides` (global/shared; open read, admin atomic replace-all).
 - **白名单管理 (Login Whitelist, admin-only)**: gates **who may log in**, run as a **blocklist (黑名单模式)**. Two pieces: a global master switch (`system_settings.json → login_whitelist.enabled`, surfaced by **admin-only** `GET|PUT /api/system-settings/login-whitelist`) + a per-user **放行** flag (`users.approved` column, migration `20260625_02`). Users **self-register** as usual and **every new account defaults to `approved=True`** — so a user who has never logged into this system before is allowed straight through; the switch only blocks users an admin has explicitly **取消放行** (`approved=False`). (`create_user`/`User`/`UserRow` all default `approved=True`; admins are always approved; existing rows are backfilled `True`.) Login interception is the single helper `enforce_user_approved(user)` in `app/gateway/routers/auth.py`, called in all three login endpoints (`/login/{local,username,token}`) **after** the account is resolved/created and **before** the JWT is issued: switch off → everyone passes; `system_role=="admin"` → always passes (anti-lockout); else `approved=False` (admin-revoked) → 403 `{code:"PENDING_APPROVAL"}` (the frontend's `extractErrorMessage` surfaces the message and login throws before writing any auth state, so no half-login). Admin approves on `pages/LoginWhitelistPage.tsx` (route `/page/strategy/admin/login-whitelist`, entry「白名单管理」in the bottom-left settings dropdown of `components/page-sidebar.tsx`, both sidebar modes): a top master-switch + a list of all registered users (`GET /api/v1/auth/users`, now carrying `approved`) with a per-row 放行 Switch (`PUT /api/v1/auth/users/{id}/approval`, admin-only; revoking only blocks the **next** login — `token_version` is left untouched, existing sessions are not force-killed). Client/hooks: switch in `strategy-components/api/login-whitelist.ts`, user list + approval in `core/auth/{api,hooks}.ts` (`useSetUserApproval`). Backend tests: `tests/test_login_approval.py`. **账号级「登录口令」(per-account password — 临时开通)**: the same page also lets an admin assign one specific account an individual **plaintext** password (`users.login_password` column, migration `20260625_04`, nullable; auto-added on startup by `_ensure_orm_columns_sync`). Once set, **that account's** username login (`POST /api/v1/auth/login/username`) **requires** `?password=` to exactly match it and that personal password **takes precedence over** the global shared-password gate (`username_login.require_password`); accounts without one keep today's shared-gate / passwordless behavior. The user then logs in via the **existing** frontend URL `#/login/<用户名>?password=xxxx` (LoginPage already forwards `?password=`; `<用户名>` = the account's email `@`-prefix). **Plaintext is intentional** — the password rides in the URL query anyway, so storing it readably lets the admin re-copy the full login link from the page; it is exposed only on the **admin-only** `GET /api/v1/auth/users` (`UserListItem.login_password`) and the new admin-only `PUT /api/v1/auth/users/{id}/login-password` (set non-empty / clear with null·empty; doesn't touch `token_version`). The whitelist page renders a per-user 「登录口令」 column with a set/修改 editor + a live 「复制登录链接」 button (`useSetUserLoginPassword` in `core/auth/hooks.ts`, `setUserLoginPassword` in `core/auth/api.ts`). Backend gate helper `_lookup_user_by_username` (lookup-only, no auto-register) in `routers/auth.py`; tests `tests/test_login_personal_password.py`.

frontend-web/.env.development

@@ -5,7 +5,7 @@
 VITE_USE_REAL_DATA=true
 
 # 任务详情（登录深链 cop-task-detail）数据源：默认真实接口；改成 true 走本地假数据（consumer 外网不可达时调试用）。
-VITE_MOCK_COP_TASK_DETAIL=flase
+VITE_MOCK_COP_TASK_DETAIL=true
 
 # 研判情报报告（大屏绘制智能体深链 selectSqReport）数据源：true 走本地样例假数据（真实接口未就绪时调试用）；联调通过后置 false。
 VITE_MOCK_SQ_REPORT=true

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/.env.network

@@ -14,8 +14,8 @@ VITE_MOCK_SQ_REPORT=false
 VITE_MOCK_COP_TASK_DETAIL=false
 
 # Gateway / DeerFlow API
-VITE_BACKEND_BASE_URL=http://47.88.25.99:7001
+VITE_BACKEND_BASE_URL=http://10.19.200.5:2026
-VITE_LANGGRAPH_BASE_URL=http://47.88.25.99:7001/api
+VITE_LANGGRAPH_BASE_URL=http://10.19.200.5:2026/api
 
 # 轻应用「新建笔记」系列接口
 VITE_NOTE_API_BASE_URL=http://47.88.25.99:8000
@@ -42,7 +42,7 @@ VITE_AIPI_BACKENP_URL=http://47.88.25.99:8000
 # VITE_AIPI_FRONTEND_URL=https://knowledgetoolserver.b.uat.4.cn
 VITE_NOTEBOOK_API_BASE_URL=http://47.88.25.99:8000
 VITE_AIPI_FRONTEND_URL=http://47.88.25.99:3000
-VITE_AIPI_CONSUMER_URL=https://ch1.b.uat.4.cn/consumer
+VITE_AIPI_CONSUMER_URL=http://10.19.200.5:8002/consumer
 # A 系统跳转地址（人物/组织/事件等列表项打开链接）
 VITE_AIPI_PRESENT_URL=http://present.a.uat.4.cn/present/domain
 # B 系统知识库 iframe 根地址

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/ai-writing-对话驱动写作台-实现方案.md

@@ -0,0 +1,507 @@
+# AI 写作「对话驱动写作台」实现方案（可落地版）
+
+> 需求：**复制**现有 AI 写作代码，新增一个独立页面（**原页面/原路由零改动**）。在新页面里
+> **大改交互流程**——去掉「素材收集 / 大纲规划 / 作家写作 / 编辑审核」四个阶段干预卡里的**输入框**，
+> 只**保留原来的确认按钮**；在页面**底部新增一个统一的多行智能输入框**，具备**强意图理解**能力：
+> 重新搜索、新增检索词、添加检索素材、重新规划大纲、按要求改大纲、提修改意见、审核意见、
+> 素材不足继续搜集、对写作内容提问……**覆盖现有全部交互甚至更多**。
+>
+> 交互节奏不变：**一步一确认**——进行到某个专家阶段时，交互就针对该专家（阶段作用域）；
+> 用户可以**点原来的确认按钮**，也可以**在底部输入框里发「继续下一步」的意图**推进。
+> 意图**拿不准时**主动向用户**发起协助/澄清**，绝不盲目触发高代价动作（定稿 / 重搜等）。
+
+本文是**实现指引**，落地时按第 9 节路线图分阶段推进。文中所有文件路径、符号名均对齐当前代码。
+
+---
+
+## 1. 现状梳理（改造地基）
+
+现有 AI 写作是一套**独立 LangGraph 子系统**（不是 lead_agent），前后端都已成型、可复用。
+
+### 1.1 后端 `ai_writing` graph
+
+- 图工厂：`offline-backend-20260512/backend/packages/harness/deerflow/agents/ai_writing/graph.py`
+  （`make_ai_writing_graph`，registered as `assistant_id="ai_writing"`）
+- 状态：`.../ai_writing/state.py`（`AIWritingState`）
+- 四个「阶段大脑」节点：
+
+| 阶段 | 节点 | 文件 |
+|------|------|------|
+| 素材收集 | `researcher` | `nodes/researcher.py` |
+| 大纲规划 | `writer_outline` | `nodes/writer_outline.py` |
+| 作家写作 | `writer_draft` | `nodes/writer_draft.py` |
+| 编辑审核 | `editor` | `nodes/editor.py` |
+
+- **五个暂停点**（`interrupt()`，`Command(resume=payload)` 续跑）——这是对话改造的核心可复用资产：
+
+| pause_point | 语义 | 现有 action |
+|-------------|------|-------------|
+| `material_confirm` | 素材确认 | `confirm` / `re_search` / `enable_skill_search` |
+| `outline_confirm` | 大纲确认 | `confirm` / `re_outline` |
+| `draft_confirm` | 草稿确认 | `to_editor` / `finalize` / `user_revise` |
+| `review_confirm` | 编辑打回确认 | `accept_review` / `force_finalize` |
+| `section_help` | 素材不足求助 | `section_help`(+`sectionDecisions`) |
+
+- resume 载荷（`UserInterventionPayload`，`types/ai-writing.ts`）字段：`action`、`approvedMaterialIds`、
+  `userQuery`（自然语言补充检索）、`editedOutline`、`outlineFeedback`、`userRevisionNotes`、
+  `overrideVerdict`、`selectedIssueIndices`、`sectionDecisions`。
+  **协议已同时支持「自然语言 + 结构化 action」**——这是对话层能复用的关键。
+
+> 结论：**状态机 / 流式 / 暂停·续跑协议 / 持久化都可复用**，无需重写引擎。改造本质是
+> 「把分散在干预卡里的输入框，换成一个底部智能输入框 + 意图路由层」，再把意图翻译回**现有
+> `action + payload`**；仅少量新意图（对内容提问、素材不足自动回退重搜、追加审核意见）需新增能力。
+
+### 1.2 前端 `open-canvas` 子系统
+
+- 主页面：`frontend-web/src/open-canvas/pages/AIWritingPage.tsx`
+  - 路由注册：`open-canvas/routes/OpenCanvasRoutes.tsx`（`/page/canvas/ai-writing/*`）、
+    `pages/WorkspaceRoutes.tsx`（`/page/workspace/ai-writing/*`）、`pages/NotebookAIWritingPage.tsx`
+- 状态机 + 流式：`contexts/AIWritingContext.tsx`（`useReducer` + LangGraph `useStream`，`assistantId:'ai_writing'`）
+- 事件翻译 / reducer：`hooks/useAIWritingStream.ts`
+- 类型：`types/ai-writing.ts`
+- **左栏面板**：`components/ai-writing/AIWritingPanel.tsx`（时间线 + 干预卡 + 状态栏；idle 时挂启动表单）
+- **要改造的输入 UI**（本次重点）：
+  - 干预卡 `components/ai-writing/InterventionCard.tsx`：内含
+    `MaterialConfirmCard`（素材：有 `MaterialsToolbar` 输入框）、
+    `OutlineConfirmCard`（大纲：有 feedback textarea）、
+    `DraftConfirmCard`（草稿：有「修改意见」textarea）、
+    `ReviewConfirmCard`（审核：有「补充修改指令」textarea）、
+    `SectionHelpCard`（素材不足：按钮组）。
+    **每张卡里都既有输入框又有确认/动作按钮**——本次要**去掉输入框、保留按钮**。
+  - 启动表单 `components/ai-writing/AIWritingForm.tsx`（idle 阶段的配置表单）——本次由底部输入框接管启动。
+- **已存在的对话原型**（可借鉴）：`components/ai-writing/WritingSetupChat.tsx`
+  （`useThreadStream` 起 lead_agent 线程 + `setup_writing` 审批卡回填表单；仅管启动前配置，不直接复用）。
+- 底部输入框可直接复用 UI 组件：`@/components/ai-elements/prompt-input`
+  （`PromptInput` / `PromptInputTextarea` / `PromptInputSubmit` / `PromptInputFooter`，见 `WritingSetupChat`）。
+
+---
+
+## 2. 目标与范围
+
+### 2.1 必须满足
+
+1. **复制式新增**：新目录 / 新路由 / 新侧边栏入口，**旧页面、旧路由、旧组件零改动**（「初始的不用动」）。
+2. 页面**底部单一多行智能输入框**接管全流程交互；四个阶段干预卡里的**输入框全部移除**。
+3. **保留确认按钮**：每个阶段到达暂停点时，消息流里仍渲染**产物卡 + 原来的确认/动作按钮**
+   （素材「确认素材」、大纲「确认大纲」、草稿「让编辑审核 / 确认定稿」、审核「按编辑意见修改 / 强制定稿」、
+   素材不足的三选一按钮）。用户**点按钮**或**在底部输入框发自然语言意图**二选一均可推进。
+4. **强意图理解**：把用户自由文本准确路由到正确动作，**覆盖现有全部交互 + 更多**（见 3.2）。
+5. **阶段作用域**：意图解析必须知道「当前停在哪个专家阶段」，把同一句话按当前阶段翻译成对应 action。
+6. **素材不足自动回退重搜**：修改意见需要的信息现有素材没有时，先重搜补素材、补完自动继续原意图。
+7. **拿不准就协助**：低置信意图**不猜着执行**，走澄清追问（clarify）或用户协助。
+8. 保留右侧草稿实时预览（可编辑）与时间线 / 进度展示。
+
+### 2.2 明确不做（本期）
+
+- 不改旧 `AIWritingPage` 及其 `AIWritingForm` / `InterventionCard`（这两个是要在**副本**里改的）。
+- 不替换 `ai_writing` graph 四个阶段大脑逻辑，不动五个暂停点 / checkpoint / 持久化。
+- 不引新状态管理库（继续 `useReducer` + `useStream`）。
+
+### 2.3 复制策略（关键决策）
+
+「复制一份」= **复制会被大改的表现层组件**（页面 + 干预卡 + 面板），**复用不改的引擎层**：
+
+| 复制（新建副本，大改） | 复用（原样，不改；仅对 `types` 做**追加式**扩展） |
+|------------------------|--------------------------------------------------|
+| 新页面 `AIWritingChatPage.tsx` | `contexts/AIWritingContext.tsx`（状态机 + 流式） |
+| 新面板 `WritingChatPanel.tsx`（消息流 + 底部输入框） | `hooks/useAIWritingStream.ts`（事件 → state） |
+| 新消息卡 `chat-cards/*`（产物卡+确认按钮，**无输入框**） | `components/ai-writing/AIWritingDraftPanel.tsx`（右侧草稿预览） |
+| 新意图客户端 `api/ai-writing-intent.ts` | 各流式展示子组件（`MaterialsCard`/`OutlineCard`/`ReviewCard`/`SkillStepsCard`…） |
+| （可选）新 `contexts/WritingChatContext.tsx` 包一层「pending 意图 / 澄清态」 | `types/ai-writing.ts`（**只加字段不改旧字段**，保证旧页面不受影响） |
+
+> **不复用、也不改** 的三个「输入框组件」：`AIWritingForm` / `InterventionCard` / `WritingFormContext`——
+> 旧页面继续用它们，新页面完全不引用它们。这样「初始的不用动」得到硬保证。
+>
+> 为什么复用 `AIWritingContext` 而不复制它？它**不含任何输入框 UI**，只是「状态机 + 与后端 graph 的
+> 流式桥」，复用它**不会改动旧页面的任何呈现**（旧页面照常在自己的 Provider 实例里跑）。复用能显著
+> 降低维护成本、避免两套引擎漂移。若要绝对物理隔离，也可整目录复制 `AIWritingContext` +
+> `useAIWritingStream` 到新目录——**推荐先复用**，仅当后续需要给对话态加大量图内新协议时再分叉。
+
+---
+
+## 3. 核心设计
+
+### 3.1 三层结构
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│  对话 UI 层（新）  WritingChatPanel                             │
+│   - 消息流：用户消息 + AI 阶段产物卡（含【保留的确认按钮】）+ 进度   │
+│   - 底部：统一多行智能输入框（唯一自由输入入口）                    │
+│   - 右侧：草稿实时预览（复用 AIWritingDraftPanel）                │
+└───────────────┬──────────────────────────────────────────────┘
+                │ 用户自然语言（+ 当前 status/pausePoint 上下文）
+                ▼
+┌──────────────────────────────────────────────────────────────┐
+│  意图解析层（新，核心）  POST /api/ai-writing/sessions/{id}/intent │
+│   输出：{ intent, pausePoint, action, payload,                  │
+│          needResearch, researchQuery, answer, confidence, clarify }│
+└───────────────┬──────────────────────────────────────────────┘
+                │ 结构化 action + payload
+                ▼
+┌──────────────────────────────────────────────────────────────┐
+│  执行层（复用现有 AIWritingContext）                             │
+│   idle → startWriting(AIWritingRequest)                         │
+│   暂停 → submitIntervention(UserInterventionPayload)            │
+│   问答 → 旁路回答（不改写作状态）                                 │
+│   素材不足 → 先重搜、缓存 pending、补完自动续跑                     │
+└──────────────────────────────────────────────────────────────┘
+```
+
+**设计原则**：意图解析层是「翻译官」——把自由文本翻译成**执行层已经懂的指令**。能复用
+`action + payload` 的绝不新造协议；确认按钮点击**直接走执行层**（不经意图层，零延迟、零误判）。
+
+### 3.2 意图分类体系（覆盖全流程 + 更多）
+
+按「意图 → 触发时机（当前 status/pausePoint）→ 映射执行」组织，即意图解析引擎的目标 schema。
+**「甚至更多」** = G（问答）、H（控制）、以及 B/C/D/E 里的「素材不足自动回退重搜」。
+
+#### A. 启动类（status = `idle`）
+| 意图 | 用户说法示例 | 映射 |
+|------|-------------|------|
+| `start_writing` | 「写一篇关于新能源出口的深度分析，2000 字」 | 解析成 `AIWritingRequest` → `startWriting()` |
+| `start_with_outline` | 「按这个大纲写：…」 | `AIWritingRequest.userOutline` |
+| `start_imitate` | 「仿照这篇样文写…」 | `writingModeType='imitate'` + `sampleText` |
+
+#### B. 素材类（pausePoint = `material_confirm`）
+| 意图 | 示例 | 映射 |
+|------|------|------|
+| `confirm_materials` | 「素材可以，继续 / 下一步」 | `{action:'confirm', approvedMaterialIds}` |
+| `research_again` | 「重新搜索素材」 | `{action:'re_search'}`（无 userQuery=覆盖式重检） |
+| `add_material`/`add_keyword` | 「再补点关于 X 的素材」「加个关键词 Y」 | `{action:'re_search', userQuery:'X/Y'}`（追加） |
+| `select_materials` | 「只用第 1、3 条」 | `{action:'confirm', approvedMaterialIds:[…]}` |
+| `drop_materials` | 「去掉第 2 条」 | 同上（反选后的子集） |
+
+#### C. 大纲类（pausePoint = `outline_confirm`）
+| 意图 | 示例 | 映射 |
+|------|------|------|
+| `confirm_outline` | 「大纲 OK，开始写」 | `{action:'confirm'}` |
+| `reoutline` | 「重写大纲」 | `{action:'re_outline'}`（feedback 可空） |
+| `revise_outline` | 「第二章拆成两节」「调整顺序」 | `{action:'re_outline', outlineFeedback:自然语言}` |
+
+#### D. 写作 / 草稿类（pausePoint = `draft_confirm`）
+| 意图 | 示例 | 映射 |
+|------|------|------|
+| `to_editor` | 「交给编辑审核」 | `{action:'to_editor'}` |
+| `finalize` | 「就这样定稿」 | `{action:'finalize'}` **（高代价：低置信必澄清）** |
+| `revise_draft` | 「第三段太啰嗦，精简」「补个 2024 案例」 | `{action:'user_revise', userRevisionNotes:意见}` |
+| `rewrite_section` | 「重写第二章」 | `user_revise` + 章节定位写进 notes |
+| `change_tone/style` | 「更口语一点 / 更正式」 | `user_revise` + notes |
+| `apply_review`（若已有审核结果） | 「按编辑意见改」「只接受第 1、2 条」 | `{action:'user_revise', selectedIssueIndices:[…]}` |
+
+#### E. 编辑审核类（pausePoint = `review_confirm`）
+| 意图 | 示例 | 映射 |
+|------|------|------|
+| `accept_review` | 「按编辑意见改」 | `{action:'accept_review', selectedIssueIndices}` |
+| `partial_accept_review` | 「只接受第 1、2 条」 | `accept_review` + `selectedIssueIndices` 子集 |
+| `add_review_opinion` | 「再补一条：核查数据准确性」 | `accept_review` + `userRevisionNotes`（并入补充指令，现协议已支持） |
+| `force_finalize` | 「不改了，强制定稿」 | `{action:'force_finalize', overrideVerdict:true}` **（高代价：必澄清）** |
+
+#### F. 素材不足求助类（pausePoint = `section_help`）
+| 意图 | 映射 |
+|------|------|
+| `section_supplement` | `{action:'section_help', sectionDecisions:[…'supplement']}` |
+| `section_loose` | `sectionDecisions:[…'loose']` |
+| `section_delete` | `sectionDecisions:[…'delete']` |
+
+#### G. 问答类（**新**；任意 status；旁路，不改写作状态）
+| 意图 | 示例 | 映射 |
+|------|------|------|
+| `ask_about_content` | 「第二章讲了啥？」「为什么用这个论点？」 | 意图节点直接带回 `answer`，对话流渲染（见 5.4） |
+| `ask_meta` | 「现在到哪步了？」「用了哪些素材？」 | 读当前 state 直接回答，不走图 |
+
+#### H. 控制类（**新 / 半新**）
+| 意图 | 映射 |
+|------|------|
+| `next_step`（通用「继续/下一步」） | 按**当前 pausePoint** 映射到该阶段的默认确认（material/outline→`confirm`，draft→`to_editor`…；等价点确认按钮） |
+| `restart_stage` | 重跑当前阶段（复用 `resumeWriting()` 空 command 续跑） |
+| `run_background` | 转后台自动跑：`suspendAIWritingToBackground()` |
+| `cancel` | `pauseWriting()`（`stream.stop()`） |
+| `unknown/clarify` | 无法判定 → 反问澄清 / 用户协助（**防误触发硬指标**） |
+
+### 3.3 「素材不足自动重搜」判定与回退（用户强调点）
+
+触发：用户在**大纲/草稿/审核**阶段提出修改意见，但意见需要的信息现有素材里没有。
+
+判定来源（组合）：
+1. **意图节点直接判**：把「素材摘要（keywords + 每条 title/source）」喂给意图 prompt，让它判断
+   「这条意见能否用现有素材满足」；不能 → `needResearch=true` + `researchQuery`。
+2. **执行阶段兜底**：`writer_draft` 严格模式已有 `blocked_sections` → `section_help` 暂停点，
+   对话层把它翻译成「素材不足，是否重搜？」的追问。
+
+回退动作（**首期纯前端实现，不动后端协议**）：`needResearch=true` 时，前端把用户的修改
+`payload` 缓存为 `pendingIntent`，先 `submitIntervention({action:'re_search', userQuery:researchQuery})`
+补素材；监听到新一轮 `material_confirm`（素材追加完成）后，**自动提交** `pendingIntent`。
+需处理「重搜期间用户又改主意」→ 允许覆盖 pending。
+
+---
+
+## 4. 意图解析引擎：方案与契约
+
+**采用方案 A：后端 LLM 意图节点（独立 REST）**，叠加高频短句**规则快路径**优化。
+
+理由：`needResearch` 判定需要**完整写作上下文**（素材/大纲/草稿），后端天然持有 checkpoint state；
+与 `setup_writing` 一脉相承，离线模型选择策略统一；输出 schema 稳定、前端只消费。
+
+### 4.1 后端入口
+
+`app/gateway/routers/ai_writing.py` 新增：
+
+```
+POST /api/ai-writing/sessions/{session_id}/intent
+Body: { text: string, status: string, pausePoint?: string }
+Resp: IntentResult（见 4.3）
+```
+
+实现：读该 session 的 checkpoint state（素材摘要 / 大纲纲要 / 草稿字数·章节 / 审核意见）→
+用 `ai_writing` 配置模型（复用 `intent_parser.py` 同套 `create_chat_model` + `parse_json` +
+模型容错 `_model_fallback`）解析 → 返回结构化契约。**不改图拓扑**。
+
+新增 prompt：`agents/ai_writing/prompts/intent_router_prompts.py`
+- 输入：用户文本、`current_status`/`pause_point`、素材摘要、大纲纲要、草稿字数+章节标题、审核意见列表。
+- 输出：严格 JSON（4.3 契约）。硬要求：**只在证据充分时给高 confidence，否则给 `clarify`**；
+  `finalize`/`force_finalize`/`re_search` 等高代价意图**必须**高置信才不澄清。
+
+### 4.2 前端快路径（先跑规则，未命中再调后端）
+
+`api/ai-writing-intent.ts` 里对**当前 pausePoint** 做少量确定性短语命中，直接产出 payload，省一次往返：
+- 「继续/下一步/确认/可以/ok/好的」→ 当前阶段默认 `confirm`（draft 阶段=`to_editor`）。
+- 「重新搜索/重搜」（material）→ `re_search`。「重写大纲」（outline）→ `re_outline`。
+- 「定稿/强制定稿」→ **不进快路径**（高代价，一律走后端 + 可能澄清）。
+- 命中即执行；未命中 → 调后端 `intent` 接口。
+
+### 4.3 意图解析输出契约
+
+```jsonc
+{
+  "intent": "revise_draft",        // 见 3.2 分类
+  "pausePoint": "draft_confirm",   // 需要 resume 时；否则 null
+  "action": "user_revise",         // 映射到现有 action
+  "payload": {                     // 直接可喂 submitIntervention 的字段（camelCase）
+    "userRevisionNotes": "第三段精简，并补一个 2024 年的案例"
+  },
+  "needResearch": true,            // 素材是否不足
+  "researchQuery": "2024 行业案例", // needResearch 时的检索意图
+  "answer": null,                  // 问答类意图的直接回答（旁路）
+  "confidence": 0.86,
+  "clarify": null                  // 低置信时的反问话术（非空则不执行、只追问）
+}
+```
+
+前端消费顺序：
+1. `answer` 非空 → 对话流渲染回答（问答旁路，不动写作状态）。
+2. `clarify` 非空 **或** `confidence < 阈值(建议 0.6)` → 渲染反问气泡，等用户澄清（**防误触发**）。
+3. `needResearch=true` → 缓存 `pendingIntent=payload`，先重搜，收到新素材后自动提交。
+4. 否则 → `idle` 走 `startWriting(...)`；暂停态走 `submitIntervention({action, ...payload})`。
+
+---
+
+## 5. 前端改造方案
+
+### 5.1 新页面与路由（复制式）
+
+- 新页面：`open-canvas/pages/AIWritingChatPage.tsx`
+  （骨架照抄 `AIWritingPage.tsx` 的 Provider 包裹与左右分栏；左栏换成 `WritingChatPanel`，右栏仍
+  `AIWritingDraftPanel`；idle 不再挂 `AIWritingForm`，改由底部输入框启动）。
+- 路由注册（**新增，不动旧行**）：
+  - `open-canvas/routes/OpenCanvasRoutes.tsx` 加 `path="ai-writing-chat/*"`。
+  - 侧边栏 `core/page-layout/sidebar-menu.ts`：在 `qa-research` 旁新增
+    `{ id:"qa-research-chat", label:"AI写作(对话版)", icon:FileText, path:"/page/canvas/ai-writing-chat" }`。
+    （或先不加、内部灰度直链验证。）
+
+### 5.2 新面板 `WritingChatPanel.tsx`（左栏主体）
+
+职责 = 消息流容器 + 底部输入框，替代 `AIWritingPanel` 里的「时间线 + InterventionCard + 状态栏」。
+复用 `useAIWriting()` 读 state / 调 `startWriting` / `submitIntervention` / `pauseWriting` /
+`suspendAIWritingToBackground`。
+
+消息流渲染（把 `ProgressEvent` / 阶段产物适配成消息卡，复用现有展示子组件）：
+- 运行中：`research_progress`/`outline_chunk`/`draft_chunk`/`review_chunk` → 进度 / 流式卡
+  （复用 `SkillStepsCard`/`OutlineStreamingView`/`DraftGeneratingView`/`ReviewStreamingView` 的展示部分）。
+- 到达暂停点：渲染 **产物卡 + 保留的确认按钮**（见 5.3），不再有输入框。
+- 用户消息、AI 澄清追问、问答回答：普通气泡。
+
+底部输入框：直接复用 `@/components/ai-elements/prompt-input`（`PromptInput`+`PromptInputTextarea`+
+`PromptInputSubmit`），Enter 发送、Shift+Enter 换行；发送时读当前 `state.status`/`currentPause?.pausePoint`
+交给意图路由（见 5.5）。运行中（非暂停点）可禁用发送或转「排队/提示当前在生成」。
+
+### 5.3 新消息卡 `chat-cards/*`（**保留按钮、去掉输入框**）
+
+把 `InterventionCard.tsx` 的五张卡各复制一份到 `open-canvas/components/ai-writing-chat/chat-cards/`，
+**删掉其中的 textarea / MaterialsToolbar 输入部分，保留产物展示 + 确认/动作按钮**：
+
+| 新卡 | 展示（复用） | 保留的按钮 | 删除的输入 |
+|------|-------------|-----------|-----------|
+| `MaterialConfirmChatCard` | `MaterialsCard`（勾选保留）+ `SkillStepsCard` | 「确认素材，规划大纲」「重新搜索」 | `MaterialsToolbar` 的 userQuery 输入框 |
+| `OutlineConfirmChatCard` | `OutlineCard`（可点标题微调保留） | 「确认大纲，开始写作」 | feedback textarea + 发送 |
+| `DraftConfirmChatCard` | `ReviewCard`（若有审核，勾选保留） | 「按编辑审核意见修改」「让编辑继续审核」「确认定稿」 | 「修改意见」textarea |
+| `ReviewConfirmChatCard` | `ReviewCard`（勾选保留） | 「按编辑意见修改」「强制定稿」 | 「补充修改指令」textarea |
+| `SectionHelpChatCard` | 章节 + 三选一按钮组 | 三选一 + 「提交并继续」 | （本就无自由输入，原样保留） |
+
+> 勾选态（素材/审核意见）**保留**——它是「点按钮」路径的一部分，不算自由输入框。用户想用自然语言
+> 「只用第 1、3 条」也能走底部输入框（意图层产出 `approvedMaterialIds`/`selectedIssueIndices`）。
+> 按钮点击 **直接调 `submitIntervention`**，与旧卡完全一致，零改动风险。
+
+### 5.4 问答旁路（新能力）
+
+「对写作内容提问」不改写作 state。首期**轻量实现**：意图节点检出 `ask_*` 时读 state 直接带回 `answer`，
+前端在消息流渲染为普通 AI 气泡即可（一次调用出答案）。完整版（后续）可另起只读 lead_agent 线程注入
+草稿/大纲作背景，类似 `WritingSetupChat` 的 `useThreadStream`。
+
+### 5.5 交互流程（对话版）串起来
+
+1. **空闲**：底部输入「写一篇关于 X 的深度分析，2000 字」→ 意图 `start_writing` → 组 `AIWritingRequest`
+   → `startWriting()`。（缺关键字段时先 `clarify` 追问字数/读者/类型。）
+2. **运行中**：进度/流式卡渲染。
+3. **到暂停点**：渲染产物卡 + 按钮 + 一句提示「你可以点上面的按钮，或直接说：确认继续 / 补充素材 / 改大纲…」。
+   - **点按钮** → 直接 `submitIntervention`（旧逻辑）。
+   - **发文字** → `resolveIntent(text, status, pausePoint)`（先快路径、后后端）→ 按 4.3 消费。
+4. **问答**：任意时刻提问 → 旁路 `answer`，不打断写作。
+5. **素材不足**：`needResearch` 或 `section_help` → 追问/执行「重搜 → 自动续跑 pending 意图」。
+6. **拿不准**：`clarify`/低置信 → 反问气泡，不执行。
+
+### 5.6 pending 意图 & 澄清态（新增本地状态）
+
+在 `WritingChatPanel`（或新 `WritingChatContext`）维护：
+- `pendingIntent: UserInterventionPayload | null` —— 素材不足重搜完成后自动提交。
+- `awaitingClarify: { originalText: string } | null` —— 澄清态，用户下一句与上一句拼接再解析。
+- pending 生命周期：设置 → 提交 `re_search` → 监听 reducer 里新一轮 `awaiting_material_confirm`
+  （`state.status` 从 `researching` 回到 `awaiting_material_confirm`）→ 自动 `submitIntervention(pending)` → 清空。
+
+---
+
+## 6. 后端改造方案
+
+### 6.1 意图解析入口（新增，唯一后端改动主体）
+
+- `app/gateway/routers/ai_writing.py`：新增 `POST /sessions/{id}/intent`（见 4.1）。
+  读 checkpoint state 用 `app.state.checkpointer` + `make_ai_writing_graph().aget_state(...)`
+  （参照 `ai_writing_job_executor.py` 的读法）取素材/大纲/草稿/审核摘要。
+- `agents/ai_writing/prompts/intent_router_prompts.py`：新增意图 prompt（见 4.1）。
+- 复用 `nodes/intent_parser.py` 的模型创建 / `parse_json` / `_model_fallback` 容错。
+
+### 6.2 不需要改的部分
+
+- 四个阶段大脑节点、五个暂停点、checkpoint、StreamBridge、持久化、sessions/transcript REST——**全不动**。
+- 「素材不足自动续跑」「问答旁路」首期都在**前端 / 意图节点**实现，**不扩 resume 协议**。
+
+### 6.3 可选增强（阶段 3，按需）
+
+- `add_review_opinion` 完整版：`review_confirm` resume 增字段 `extra_review_notes`（首期已用现有
+  `userRevisionNotes` 降级承载，够用）。
+- `resume_intent` 后端化（把「重搜完自动续跑」搬到后端，减少前端状态机复杂度）。
+- undo / 回退到上一暂停点（依赖 checkpoint 回滚）。
+
+---
+
+## 7. 数据流时序（改稿 + 素材不足自动重搜）
+
+```
+用户（draft_confirm 暂停）: "第三段补个2024年的行业案例"
+  │ 底部输入框 → resolveIntent(text, status='awaiting_draft_confirm', pausePoint='draft_confirm')
+  ▼ POST /api/ai-writing/sessions/{id}/intent { text, status, pausePoint }
+后端: 读 state(素材摘要) + LLM 解析
+  │ 返回 { intent:revise_draft, action:user_revise,
+  │        payload:{userRevisionNotes:"第三段…补2024案例"},
+  │        needResearch:true, researchQuery:"2024 行业案例", confidence:0.9 }
+  ▼
+前端: needResearch=true → pendingIntent = payload
+  │ submitIntervention({action:'re_search', userQuery:"2024 行业案例"})
+  ▼ LangGraph resume → researcher 追加素材 → status 回到 awaiting_material_confirm
+前端: 监听到新一轮素材确认 → 自动提交 pendingIntent
+  │ submitIntervention({action:'user_revise', userRevisionNotes:"第三段…补2024案例"})
+  ▼ writer_draft 用新素材改稿 → draft_chunk… → draft_ready → draft_confirm
+前端: 消息流展示新草稿卡 + "已按你的意见改写并补充了 2024 案例"
+```
+
+---
+
+## 8. 关键实现细节与坑
+
+1. **阶段作用域**：`resolveIntent` 必须带 `state.currentPause?.pausePoint` + `state.status`——
+   同一句「重新来」在 material 是重搜、在 outline 是重写大纲。`AIWritingContext` 已有这两个字段，直接读。
+2. **确认按钮零改动**：新卡的按钮 `onClick` 原样调 `submitIntervention(payload)`，与旧卡逐字一致，
+   风险最低；**只删输入框**。
+3. **防误触发**：低置信（<0.6）或 `clarify` 非空一律追问；`finalize`/`force_finalize`/`re_search`
+   即使命中也要求高置信，否则澄清。绝不盲目定稿/覆盖重搜。
+4. **pending 意图队列**：素材不足是「先插重搜、再回原意图」，用 5.6 的小状态机；重搜完成前允许覆盖 pending。
+5. **问答不污染 transcript**：问答/澄清消息在前端标记 `kind:'qa'|'clarify'`，与写作进度事件区分（
+   `AIWritingContext` 的 transcript 只存 progressEvents/completedInterventions，问答气泡是纯前端消息，
+   默认不入 transcript，避免历史回看错乱）。
+6. **流式产物→消息卡**：复用 `OutlineStreamingView`/`DraftGeneratingView`/`ReviewStreamingView`/
+   `SkillStepsCard` 的**展示部分**，套进消息容器，不重写渲染。
+7. **右侧草稿预览**：`AIWritingDraftPanel` + `DraftSync` 原样复用（`DraftSync` 依据 status/markdown
+   同步右侧画布）。
+8. **离线内网**：意图模型走 `config.yaml → ai_writing` 配置模型；检索仍走技能/内网 ES，不联网。
+9. **模型选择透传**：`submitIntervention` 的 resume 已把 `state.request?.modelName` 一并回传（见
+   `AIWritingContext`），新页面沿用即可。
+10. **旧页面隔离验证**：改完后回归旧 `/page/canvas/ai-writing` 与 `/page/workspace/ai-writing`、
+    笔记本嵌入页，确认零变化（新代码不 import 旧的 `AIWritingForm`/`InterventionCard`/`WritingFormContext`）。
+
+---
+
+## 9. 分阶段实施路线图
+
+**阶段 0 — 骨架（不含意图）**
+- 复制 `AIWritingChatPage` + 注册新路由 + 侧边栏入口；复用 `AIWritingContext`/`useStream`/`DraftPanel`。
+- 复制五张 `chat-cards`（删输入框、留按钮）；底部输入框先只做 idle 直发 `start_writing`
+  （文本原样当 `userIntent`，其余字段取默认）+ 暂停点靠按钮推进。端到端跑通。
+
+**阶段 1 — 意图解析（核心）**
+- 后端 `POST /sessions/{id}/intent` + `intent_router_prompts.py`，返回 4.3 契约。
+- 前端 `api/ai-writing-intent.ts`（快路径 + 后端）接入 `WritingChatPanel`，覆盖 A~F 类意图。
+- 低置信 `clarify` 澄清态（5.6）。
+
+**阶段 2 — 问答旁路 + 素材不足自动重搜**
+- G 类问答（意图节点直接带 `answer`）。
+- `needResearch` + pending 意图机制（前端实现重搜后自动续跑，5.6）。
+
+**阶段 3 — 增强（按需）**
+- `add_review_opinion` 扩协议、`resume_intent` 后端化、undo/回退、完整问答只读线程。
+
+**阶段 4 — 打磨**
+- 消息卡视觉、历史回看（transcript）、后台挂起入口、灰度到侧边栏。
+
+---
+
+## 10. 关键文件清单（落地对照）
+
+### 新增（前端）
+- `open-canvas/pages/AIWritingChatPage.tsx` — 新页面（复制 `AIWritingPage` 骨架改造）
+- `open-canvas/components/ai-writing-chat/WritingChatPanel.tsx` — 消息流 + 底部输入框
+- `open-canvas/components/ai-writing-chat/chat-cards/{MaterialConfirmChatCard,OutlineConfirmChatCard,DraftConfirmChatCard,ReviewConfirmChatCard,SectionHelpChatCard}.tsx` — 保留按钮、去掉输入框
+- `open-canvas/components/ai-writing-chat/progressToMessage.ts` — `ProgressEvent` → 消息卡适配
+- `open-canvas/api/ai-writing-intent.ts` — 意图解析客户端（快路径 + `POST …/intent`）
+- （可选）`open-canvas/contexts/WritingChatContext.tsx` — pending 意图 / 澄清态
+
+### 修改（前端，仅追加，不动旧逻辑）
+- `open-canvas/routes/OpenCanvasRoutes.tsx` — 加一条 `ai-writing-chat/*` 路由
+- `core/page-layout/sidebar-menu.ts` — 加一个侧边栏入口（可选）
+- `open-canvas/types/ai-writing.ts` — **仅追加** `IntentResult` 等新类型，不改旧字段
+
+### 新增（后端）
+- `app/gateway/routers/ai_writing.py` — 加 `POST /sessions/{id}/intent`
+- `agents/ai_writing/prompts/intent_router_prompts.py` — 意图 prompt
+- `tests/test_ai_writing_intent.py` — 意图接口单测（TDD 强制）
+
+### 复用（不改）
+- `open-canvas/contexts/AIWritingContext.tsx`、`hooks/useAIWritingStream.ts`
+- `open-canvas/components/ai-writing/{AIWritingDraftPanel,DraftSync,MaterialsCard,OutlineCard,ReviewCard,SkillStepsCard,OutlineStreamingView,DraftGeneratingView,ReviewStreamingView}.tsx`
+- `agents/ai_writing/graph.py`、四个阶段节点、五个暂停点、`nodes/intent_parser.py`
+
+### 绝不动（保证「初始的不用动」）
+- `open-canvas/pages/AIWritingPage.tsx` 及其引用的
+  `components/ai-writing/{AIWritingForm,InterventionCard}.tsx`、`contexts/WritingFormContext.tsx`
+- 旧路由 `/page/canvas/ai-writing`、`/page/workspace/ai-writing`、笔记本嵌入页
+
+---
+
+## 11. 待确认（默认取值已给出，可直接推进）
+
+1. 意图引擎：**后端 LLM 节点（方案 A）+ 前端短句快路径** —— 默认采用。
+2. `AIWritingContext` / `useAIWritingStream`：**复用**（不物理复制）——默认采用；需绝对隔离可改为复制。
+3. 新页面入口：**侧边栏新增「AI写作(对话版)」** —— 默认加；若要先灰度可只留直链。
+4. 「素材不足自动重搜」：**首期前端 pending 续跑**（不动后端 resume 协议）——默认采用。
+5. 问答旁路：**首期意图节点直接带 `answer`** —— 默认采用。
+
+> 以上默认按「A + 复用引擎 + 侧边栏入口 + 前端 pending + 意图节点带答案」推进，如需调整请指出。

frontend-web/docs/ai-writing-对话驱动改造方案.md

@@ -0,0 +1,454 @@
+# AI 写作「对话驱动 + 意图解析」改造方案
+
+> 目标：在**不动现有 AI 写作页面**的前提下，新建一个「对话驱动」的写作工作台。
+> 去掉素材收集 / 大纲规划 / 作家写作 / 编辑审核各阶段**分散的输入框/表单**，
+> 用**底部一个统一的智能输入框**接管全流程交互；该输入框具备**强意图解析**能力，
+> 能准确识别用户意图（重新搜索、加素材、加关键词、重写大纲、按要求改大纲、改写作、
+> 改编辑、提编辑意见、对写作内容提问……），并在**素材不足**时自动回退去重新检索素材。
+
+本文只做**方案与实现指引**，不含代码改动。落地时按第 9 节的路线图分阶段推进。
+
+---
+
+## 1. 现状梳理（改造的地基）
+
+现有 AI 写作是一套**独立的 LangGraph 子系统**（不是 lead_agent），前后端都已成型。
+
+### 1.1 后端：`ai_writing` graph
+
+- 图工厂：`offline-backend-20260512/backend/packages/harness/deerflow/agents/ai_writing/graph.py`
+- 状态：`.../agents/ai_writing/state.py`（`AIWritingState` + `UserInterventionPayload`）
+- 注册：`offline-backend-20260512/backend/langgraph.json` → `assistant_id = "ai_writing"`
+- 执行：与 lead agent **共用** RunManager + StreamBridge + checkpointer（`app/gateway/services.py` 里 `assistant_id=="ai_writing"` 分发到 `make_ai_writing_graph`）
+
+节点拓扑（实际）：
+
+```
+sample_analyzer → intent_parser → researcher
+  → [cond] pause_material | writer_draft
+  → writer_outline → pause_outline
+  → writer_draft → [cond] pause_section_help | pause_draft | END
+  → editor → [cond] pause_draft | pause_review
+  → pause_review → END | writer_draft
+```
+
+四个「阶段大脑」节点：
+
+| 阶段 | 节点 | 文件 |
+|------|------|------|
+| 素材收集 | `researcher` | `nodes/researcher.py` |
+| 大纲规划 | `writer_outline` | `nodes/writer_outline.py` |
+| 作家写作 | `writer_draft` | `nodes/writer_draft.py` |
+| 编辑审核 | `editor` | `nodes/editor.py` |
+
+五个**暂停点**（`interrupt()`，靠 `Command(resume=payload)` 续跑）：
+
+| pause_point | 语义 | 可用 action（现有） |
+|-------------|------|---------------------|
+| `material_confirm` | 素材确认 | `confirm` / `re_search` / `supplement_search` / `enable_skill_search` |
+| `outline_confirm` | 大纲确认 | `confirm` / `re_outline` |
+| `draft_confirm` | 草稿确认 | `to_editor` / `finalize` / `user_revise` / `custom_revise` |
+| `review_confirm` | 编辑打回确认 | `accept_review` / `force_finalize` |
+| `section_help` | 素材不足求助 | `supplement` / `loose` / `delete` |
+
+> resume 载荷字段（`UserInterventionPayload`）：`action`、`approved_material_ids`、
+> `extra_keywords`、`user_query`(自然语言补充检索)、`edited_outline`、`outline_feedback`、
+> `user_revision_notes`、`override_verdict`、`selected_issue_indices`、`section_decisions`。
+> **关键点**：现有协议已经支持「自然语言 + 结构化 action」，这是对话改造的核心可复用资产。
+
+REST（业务元数据，非图执行）：`app/gateway/routers/ai_writing.py`，前缀 `/api/ai-writing`
+（sessions CRUD、transcript 保存、article-types、后台挂起 `/background` + `/progress` 等）。
+
+持久化：`ai_writing_sessions` 表（`transcript` 为 `PortableLongText`）
++ `ai_writing_article_types`（`deerflow/persistence/...`）。
+
+配置：`config.yaml → ai_writing`（`keyword_model`、`rank_model`、`max_materials`、
+`use_builtin_agents.{researcher,outliner,writer,editor}` 等）。
+
+### 1.2 前端：`open-canvas` 子系统
+
+- 主页面：`frontend-web/src/open-canvas/pages/AIWritingPage.tsx`
+- 路由：`/page/canvas/ai-writing`、`/page/workspace/ai-writing`
+- 状态机：`contexts/AIWritingContext.tsx`（`useReducer` + LangGraph `useStream`）
+- 事件翻译/reducer：`hooks/useAIWritingStream.ts`
+- 类型：`types/ai-writing.ts`（`WritingStatus`、`ProgressEvent`、`UserInterventionPayload`、`AIWritingRequest`…）
+- 流式：LangGraph `useStream`，`assistantId: 'ai_writing'`，`streamMode: ['values','updates','custom','messages-tuple']`
+- **要去掉的输入 UI**（改造重点）：
+  - 启动表单 `components/ai-writing/AIWritingForm.tsx` + `WritingFormContext`
+  - 阶段暂停输入 `components/ai-writing/InterventionCard.tsx`（素材/大纲/草稿/审核四套内嵌表单）
+- **已存在的对话原型**：`components/ai-writing/WritingSetupChat.tsx`
+  （用 `useThreadStream` 起一条 lead_agent 线程 + `setup_writing` 工具审批卡回填表单）——
+  这是「对话 → 结构化配置」的现成范式，可借鉴但**不直接复用**（它只管启动前配置）。
+
+### 1.3 结论
+
+- **状态机、流式、暂停/续跑协议、持久化都可复用**，无需重写引擎。
+- 改造本质 = **把「分散表单」换成「一个对话输入框 + 意图路由层」**，
+  再把意图映射回**现有的 `action + payload`**（大部分场景），
+  少量新意图（如「对内容提问」「素材不足自动重搜」）需要**新增协议/节点**。
+
+---
+
+## 2. 目标与范围
+
+### 2.1 必须满足
+
+1. 新页面/新路由，**旧页面零改动**（用户要求「初始的不用动」）。
+2. 底部**单一对话输入框**控制所有阶段交互，移除各阶段独立输入框。
+3. **强意图解析**：准确识别用户自然语言意图并路由到正确动作，覆盖全流程 + 更多。
+4. 用户给修改意见后，**若现有素材不足以满足要求 → 自动/建议重新检索素材**再继续。
+5. 保留右侧草稿实时预览（可编辑）与时间线/进度展示。
+
+### 2.2 明确不做（本期）
+
+- 不改旧 `AIWritingPage` 及其表单/干预卡组件。
+- 不替换底层 `ai_writing` graph 的四个阶段大脑逻辑（只加意图层与少量新协议）。
+- 不引入新的状态管理库（继续 `useReducer` + `useStream`）。
+
+---
+
+## 3. 核心设计
+
+### 3.1 总体思路：三层结构
+
+```
+┌─────────────────────────────────────────────────────────┐
+│  对话 UI 层（新）                                          │
+│  - 左：消息流（用户消息 + AI 阶段产物卡片 + 进度）          │
+│  - 底：统一智能输入框（唯一交互入口）                       │
+│  - 右：草稿实时预览（复用 AIWritingDraftPanel）            │
+└───────────────┬─────────────────────────────────────────┘
+                │ 用户自然语言
+                ▼
+┌─────────────────────────────────────────────────────────┐
+│  意图解析层（新，核心）                                    │
+│  - 输入：用户文本 + 当前 WritingStatus + 上下文快照        │
+│  - 输出：{ intent, action, payload, needResearch, ... }   │
+└───────────────┬─────────────────────────────────────────┘
+                │ 结构化 action + payload
+                ▼
+┌─────────────────────────────────────────────────────────┐
+│  执行层（复用现有）                                        │
+│  - 空闲态：startWriting(AIWritingRequest)                  │
+│  - 暂停态：submitIntervention(UserInterventionPayload)     │
+│  - 运行中：stream.stop() → 续跑 / 新命令                    │
+│  - 提问态：旁路问答（不改写作状态）                        │
+└─────────────────────────────────────────────────────────┘
+```
+
+**设计原则**：意图解析层是「翻译官」——把自由文本翻译成**现有执行层已经懂的指令**。
+能复用 `action + payload` 的绝不新造协议；只有现有协议表达不了的才扩展。
+
+### 3.2 意图分类体系（覆盖用户全流程 + 更多）
+
+按「意图类别 → 触发时机（当前 status）→ 映射到的执行」组织。这是**意图解析引擎的目标 schema**。
+
+#### A. 启动类（status = idle）
+
+| 意图 | 说明 | 映射 |
+|------|------|------|
+| `start_writing` | 用户描述要写什么 | 解析成 `AIWritingRequest` → `startWriting()` |
+| `start_with_outline` | 用户自带大纲 | `AIWritingRequest.userOutline` |
+| `start_imitate` | 样文仿写 | `writingModeType=imitate` + 样文 |
+
+#### B. 素材类（status ≈ awaiting_material_confirm / 运行中）
+
+| 意图 | 用户说法示例 | 映射 |
+|------|-------------|------|
+| `confirm_materials` | 「素材可以，继续」 | `material_confirm` + `confirm`（可带勾选 ids） |
+| `research_again` | 「重新搜索素材」 | `material_confirm` + `re_search` |
+| `add_material` / `add_keyword` | 「补充关于 X 的素材」「加个关键词 Y」 | `material_confirm` + `supplement_search`，`user_query`=X/Y |
+| `use_skill_search` | 「用 XX 技能查」 | `material_confirm` + `enable_skill_search`，`user_query`=技能/来源 |
+| `select_materials` | 「只用第 1、3 条」 | `confirm` + `approved_material_ids` 子集 |
+| `drop_materials` | 「去掉第 2 条」 | 同上，反选后 `approved_material_ids` |
+
+#### C. 大纲类（status ≈ awaiting_outline_confirm）
+
+| 意图 | 示例 | 映射 |
+|------|------|------|
+| `confirm_outline` | 「大纲 OK」 | `outline_confirm` + `confirm` |
+| `reoutline` | 「重写大纲」 | `outline_confirm` + `re_outline`（`outline_feedback` 可空） |
+| `revise_outline` | 「第二章拆成两节」「调整顺序」 | `re_outline` + `outline_feedback`=自然语言 |
+| `edit_outline_manually` | 用户直接给出新大纲文本 | 解析成 `edited_outline` |
+
+#### D. 写作/草稿类（status ≈ awaiting_draft_confirm / writing_draft）
+
+| 意图 | 示例 | 映射 |
+|------|------|------|
+| `to_editor` | 「交给编辑审核」 | `draft_confirm` + `to_editor` |
+| `finalize` | 「就这样定稿」 | `draft_confirm` + `finalize` |
+| `revise_draft` | 「第三段太啰嗦，精简」「补个案例」 | `draft_confirm` + `user_revise`，`user_revision_notes`=意见 |
+| `rewrite_section` | 「重写第二章」 | `user_revise` + 定位信息（章节）写进 notes |
+| `change_tone/style` | 「更口语一点」 | `user_revise` + notes |
+
+#### E. 编辑审核类（status ≈ awaiting_review_confirm）
+
+| 意图 | 示例 | 映射 |
+|------|------|------|
+| `accept_review` | 「按编辑意见改」 | `review_confirm` + `accept_review`（可带 `selected_issue_indices`） |
+| `partial_accept_review` | 「只接受第 1、2 条意见」 | `accept_review` + `selected_issue_indices` |
+| `force_finalize` | 「不改了，强制定稿」 | `review_confirm` + `force_finalize` |
+| `add_review_opinion` | 「你再补一条：检查数据准确性」 | 追加自定义审核意见（见 5.3 扩展） |
+
+#### F. 素材不足求助类（status = awaiting_section_help）
+
+| 意图 | 映射 |
+|------|------|
+| `section_supplement` | `section_help` + `supplement`（去重搜） |
+| `section_loose` | `section_help` + `loose`（放宽续写） |
+| `section_delete` | `section_help` + `delete` |
+
+#### G. 问答类（**新**，任意 status，旁路，不改写作状态）
+
+| 意图 | 示例 | 映射 |
+|------|------|------|
+| `ask_about_content` | 「第二章讲了啥？」「为什么用这个论点？」 | 旁路问答（见 5.4） |
+| `ask_meta` | 「现在进行到哪一步？」「用了哪些素材？」 | 读当前 state 直接回答，不走图 |
+
+#### H. 控制类（**新/半新**）
+
+| 意图 | 映射 |
+|------|------|
+| `undo/back` | 回退到上一暂停点（依赖 checkpoint 回滚，见 8.4） |
+| `restart_stage` | 重跑当前阶段 |
+| `run_background` | 挂起后台自动跑 → `POST /sessions/{id}/background` |
+| `cancel` | `stream.stop()` |
+| `unknown/clarify` | 无法判定 → 反问澄清（对话追问，不误触发） |
+
+> **覆盖「甚至更多」**：G（问答）、H（控制）、以及 D/E 里「素材不足自动回退重搜」都是超出原表单能力的新增。
+
+### 3.3 「素材不足自动重搜」的判定与回退（用户强调的重点）
+
+触发场景：用户在**大纲/草稿/审核**阶段提出修改意见，但意见需要的**信息现有素材里没有**。
+
+判定放在**意图解析层**输出一个 `needResearch: boolean` + `researchQuery`，判定来源二选一（推荐组合）：
+
+1. **意图解析 LLM 直接判断**：把「当前素材摘要（keywords + 每条 title/来源）」喂给意图解析
+   prompt，让它判断「用户这条意见能否用现有素材满足」。不能 → `needResearch=true` 并给出检索词。
+2. **执行阶段兜底**：`writer_draft` 严格模式本就有 `blocked_sections` → `pause_section_help`，
+   这是**已有的**素材不足闸门；对话层把它翻译成「素材不足，是否重新检索？」的对话追问。
+
+回退动作：`needResearch=true` 时，先走 `material_confirm + supplement_search`（或新的
+「带目标的重搜」协议，见 8.3）补素材，**补完自动继续**用户原本的修改意图（需要在对话层
+记住「pending 修改意图」，重搜结束后再提交）。
+
+---
+
+## 4. 意图解析引擎：方案对比与推荐
+
+| 方案 | 做法 | 优点 | 缺点 |
+|------|------|------|------|
+| **A. 后端 LLM 意图节点**（推荐） | 新增 `/api/ai-writing/intent/parse`（或图内新节点），后端用 LLM 把 `{text, status, contextSnapshot}` → 结构化意图 JSON | 能吃到完整 state（素材/大纲/草稿）；可判 `needResearch`；prompt/模型集中可控；离线内网可用配置模型 | 多一次网络往返（可接受，交互本就等待） |
+| B. 前端调模型接口分类 | 前端直接调现有 `/api/models` 聊天做分类 | 少一层后端改动 | 前端难拿全后端 state 快照；prompt 分散；鉴权/模型选择复杂 |
+| C. 规则 + LLM 混合 | 常见短句走关键词规则快路径，兜底 LLM | 快、省 token | 规则易漏、维护成本高；中文表达多样命中率低 |
+
+**推荐 A（后端 LLM 意图节点）**，并在其上**叠加 C 的快路径**做优化（如「确认/继续/定稿」等
+高频短句先走轻量规则，未命中再调 LLM）。理由：
+
+- 意图判定需要**当前写作上下文**（尤其 `needResearch` 判定），后端天然持有 state/checkpoint。
+- 与现有「配置助手 `setup_writing`」一脉相承，模型选择/离线部署策略统一。
+- 输出 schema 稳定，前端只消费结构化结果，UI 简单。
+
+### 4.1 意图解析输出契约（建议）
+
+```jsonc
+{
+  "intent": "revise_draft",          // 见第 3.2 分类
+  "pausePoint": "draft_confirm",     // 若需 resume；否则 null
+  "action": "user_revise",           // 映射到现有 action；新意图可为新值
+  "payload": {                        // 直接可喂 submitIntervention 的字段
+    "userRevisionNotes": "第三段精简，并补一个 2024 年的案例"
+  },
+  "needResearch": true,               // 素材是否不足
+  "researchQuery": "2024 行业案例",   // needResearch 时的检索意图
+  "answer": null,                     // 问答类意图的直接回答（旁路）
+  "confidence": 0.86,
+  "clarify": null                     // 低置信时的反问话术
+}
+```
+
+前端拿到后：
+- `answer` 非空 → 直接在对话流渲染回答（问答旁路，不动写作状态）。
+- `clarify` 非空或 `confidence` 低 → 渲染反问，等用户澄清（**防误触发**）。
+- `needResearch=true` → 先重搜，缓存 `payload` 为 pending，重搜完再提交。
+- 否则 → `submitIntervention({action, ...payload})` 或 `startWriting(...)`。
+
+---
+
+## 5. 前端改造方案
+
+### 5.1 新页面与路由
+
+- 新目录：`frontend-web/src/open-canvas/pages/AIWritingChatPage.tsx`（或 `conversational/` 子目录）。
+- 新路由：`/page/canvas/ai-writing-chat`（在 `OpenCanvasRoutes.tsx` 注册；旧路由保留）。
+- 侧边栏：`sidebar-menu.ts` 加一个入口（如「AI 写作（对话版）」），或先不加、内部灰度。
+
+### 5.2 复用 vs 新建
+
+| 复用（尽量不改） | 新建 |
+|------------------|------|
+| `AIWritingContext` / `useAIWritingStream`（状态机 + 流式） | 统一对话输入框组件 `WritingChatComposer` |
+| `AIWritingDraftPanel`（右侧草稿预览） | 消息流容器 `WritingChatThread`（渲染阶段产物为消息卡片） |
+| `types/ai-writing.ts`（按需扩展） | 意图解析客户端 `api/ai-writing-intent.ts` |
+| `ProgressEvent` 事件模型 | 阶段产物 → 消息卡片的适配器 `progressToMessage.ts` |
+| 会话持久化 REST | 「pending 意图」暂存逻辑（重搜后续跑） |
+
+**不复用**：`AIWritingForm` / `WritingFormContext` / `InterventionCard`（这三个就是要去掉的表单）。
+
+### 5.3 交互流程（对话版）
+
+1. 空闲：用户在底部输入「写一篇关于 X 的深度分析，2000 字」→ 意图解析 `start_writing`
+   → 组装 `AIWritingRequest` → `startWriting()`。
+2. 运行中：`ProgressEvent`（`research_progress`/`outline_chunk`/`draft_chunk`…）
+   → 适配成消息流里的**进度卡片/流式卡片**（复用现有流式视图组件的展示部分）。
+3. 到达暂停点：不再弹 `InterventionCard`，而是在消息流里展示**阶段产物卡片**
+   （素材列表 / 大纲 / 草稿 / 审核结果）+ 一句提示「你可以说：确认继续 / 补充素材 / 改大纲…」。
+   用户下一句自然语言 → 意图解析 → `submitIntervention`。
+4. 问答：任意时刻用户提问 → 旁路回答，不打断写作状态。
+5. 素材不足：意图解析 `needResearch` 或后端 `section_help` → 对话追问「素材不足，帮你重搜？」
+   → 确认后重搜 → 自动续跑 pending 意图。
+
+### 5.4 问答旁路（新能力）
+
+「对写作内容提问」不应改写作 state。两种实现：
+
+- **轻量（推荐先做）**：意图解析节点直接带回 `answer`（后端能读 state，一次调用出答案）。
+- **完整**：新起一条**只读**问答线程（lead_agent，context 注入当前草稿/大纲作为背景），
+  类似 `WritingSetupChat` 的 `useThreadStream` 模式，但只读不回填。
+
+---
+
+## 6. 后端改造方案
+
+### 6.1 意图解析入口（二选一）
+
+- **方案 A1（推荐，独立 REST）**：`app/gateway/routers/ai_writing.py` 新增
+  `POST /api/ai-writing/sessions/{id}/intent`，入参 `{text}`，后端读该 session 的
+  checkpoint state（素材/大纲/草稿摘要）+ 用 `ai_writing` 配置模型解析，返回第 4.1 的契约。
+  - 好处：不改图拓扑；前端拿到结果后再决定调 `startWriting`/`submitIntervention`。
+- 方案 A2（图内节点）：在图里加 `conversation_router` 节点。改动大、状态耦合高，**不推荐**首期。
+
+### 6.2 意图解析 prompt
+
+新增 `agents/ai_writing/prompts/intent_router_prompts.py`（或复用/扩展 `intent_parser.py`）：
+- 输入：用户文本、`current_status`、素材摘要（keywords + 每条 title/source）、大纲纲要、
+  草稿字数/章节标题、审核意见列表。
+- 输出：严格 JSON（第 4.1 契约）。要求模型**只在证据充分时给高 confidence**，
+  否则给 `clarify`（防误触发是硬指标）。
+
+### 6.3 「带目标的重搜」协议扩展（可选增强）
+
+现有 `supplement_search` 用 `user_query` 追加检索。为支持「改稿意见 → 缺素材 → 重搜 → 自动续跑」，
+建议在 `material_confirm` 的 resume 里新增可选字段 `resume_intent`（重搜完成后要自动执行的原始意图）。
+- 前端也可**纯前端**实现（重搜完成事件回来后再自动提交缓存的 pending payload），**首期优先前端实现**，避免动后端协议。
+
+### 6.4 追加自定义审核意见（`add_review_opinion`）
+
+`editor`/`pause_review` 目前只接受「接受/强制定稿」。要支持「你再补一条审核意见」，
+需在 `review_confirm` resume 里接受 `extra_review_notes`，`editor` 或 `writer_draft`
+修订时并入。首期可先降级为 `user_revise` + notes（把用户的审核诉求当作改稿意见），
+**完整版**再扩协议。
+
+### 6.5 不需要改的部分
+
+- 四个阶段大脑节点（researcher/writer_outline/writer_draft/editor）逻辑不动。
+- 五个暂停点、checkpoint、StreamBridge、持久化不动。
+
+---
+
+## 7. 数据流时序（改稿 + 素材不足自动重搜）
+
+```
+用户: "第三段补个2024年的行业案例"
+  │
+  ▼ POST /api/ai-writing/sessions/{id}/intent  { text }
+后端: 读 state(素材摘要) + LLM 解析
+  │  返回 { intent:revise_draft, action:user_revise,
+  │         payload:{userRevisionNotes:...},
+  │         needResearch:true, researchQuery:"2024 行业案例" }
+  ▼
+前端: needResearch=true → 缓存 pending=payload
+  │  对话追问/直接执行: submitIntervention(material_confirm, supplement_search, user_query="2024 行业案例")
+  ▼ LangGraph resume → researcher 补素材 → materials_ready
+前端: 收到新素材 → 自动提交 pending
+  │  submitIntervention(draft_confirm, user_revise, userRevisionNotes=...)
+  ▼ writer_draft 用新素材改稿 → draft_chunk... → draft_ready → pause_draft
+前端: 消息流展示新草稿 + "已按你的意见改写并补充了案例"
+```
+
+---
+
+## 8. 关键实现细节与坑
+
+1. **暂停态识别**：对话层必须知道「现在停在哪个 pause_point」才能正确映射 action。
+   `AIWritingContext` 已有 `currentPause`/`status`，直接读。
+2. **防误触发**：低置信意图一律走 `clarify` 反问，绝不猜着执行（尤其 `finalize`/`re_search` 这种代价大的）。
+3. **pending 意图队列**：素材不足重搜是「先插一段、再回原意图」，需要一个小状态机记住 pending，
+   并处理「重搜后用户又改主意」的情况（重搜完成前允许覆盖 pending）。
+4. **回退/undo（H 类）**：依赖 checkpoint 回滚，`runtime/runs/worker.py` 有 `rollback` 概念，
+   首期可**不做**或只做「重跑当前阶段」。
+5. **问答旁路不污染 transcript**：问答消息可标记 `kind:'qa'`，与写作进度事件区分持久化。
+6. **流式产物→消息卡片**：复用现有 `OutlineStreamingView`/`DraftStreamingPreview` 等的**展示部分**，
+   套进消息气泡即可，不必重写渲染。
+7. **离线内网**：意图解析模型走 `config.yaml → ai_writing` 里的配置模型；检索仍走技能/内网 ES，
+   不联网（与现有并行席位「禁 web_search」的离线策略一致）。
+
+---
+
+## 9. 分阶段实施路线图
+
+**阶段 0 — 骨架（不含意图）**
+- 新路由 + 新页面 `AIWritingChatPage`，复用 `AIWritingContext`/`useStream`/`DraftPanel`。
+- 底部对话框先只做「空闲 `start_writing` + 暂停点固定按钮」跑通端到端（相当于把干预卡换成消息）。
+
+**阶段 1 — 意图解析（核心）**
+- 后端 `POST /sessions/{id}/intent` + intent prompt，返回第 4.1 契约。
+- 前端接入：自然语言 → 意图 → `startWriting`/`submitIntervention`，覆盖 A~F 类意图。
+- 加高频短句规则快路径 + 低置信 `clarify` 反问。
+
+**阶段 2 — 问答旁路 + 素材不足自动重搜**
+- G 类问答（先用 intent 节点直接带 `answer`）。
+- `needResearch` + pending 意图机制（前端实现重搜后自动续跑）。
+
+**阶段 3 — 增强协议（按需）**
+- `add_review_opinion` 扩 `review_confirm` 协议、`resume_intent` 后端化、undo/回退。
+
+**阶段 4 — 打磨**
+- 消息卡片视觉、历史回看（复用 transcript）、后台挂起入口、灰度到侧边栏。
+
+---
+
+## 10. 关键文件清单（落地时对照）
+
+### 新增（前端）
+- `open-canvas/pages/AIWritingChatPage.tsx` — 新页面
+- `open-canvas/components/ai-writing-chat/WritingChatComposer.tsx` — 统一输入框
+- `open-canvas/components/ai-writing-chat/WritingChatThread.tsx` — 消息流
+- `open-canvas/components/ai-writing-chat/progressToMessage.ts` — 事件→消息适配
+- `open-canvas/api/ai-writing-intent.ts` — 意图解析客户端
+- 路由注册：`open-canvas/OpenCanvasRoutes.tsx`（+ 可选 `sidebar-menu.ts`）
+
+### 新增（后端）
+- `app/gateway/routers/ai_writing.py` — 加 `POST /sessions/{id}/intent`
+- `agents/ai_writing/prompts/intent_router_prompts.py` — 意图 prompt
+- （阶段 3）`state.py` / `nodes/*` — 扩 `review_confirm`、`resume_intent`
+
+### 复用（尽量不改）
+- `open-canvas/contexts/AIWritingContext.tsx`、`hooks/useAIWritingStream.ts`
+- `open-canvas/components/ai-writing/AIWritingDraftPanel.tsx` 及各流式展示组件
+- `open-canvas/types/ai-writing.ts`（按需扩字段）
+- `agents/ai_writing/graph.py`、四个阶段节点、五个暂停点
+
+### 不动
+- 旧 `open-canvas/pages/AIWritingPage.tsx` 及 `AIWritingForm`/`WritingFormContext`/`InterventionCard`
+
+---
+
+## 11. 待确认
+
+1. 意图解析引擎是否采用**推荐的方案 A（后端 LLM 节点）**？
+2. 新页面是**独立入口**（侧边栏新增）还是先**内部灰度**（仅直链）？
+3. 「素材不足自动重搜」首期是否接受**前端实现 pending 续跑**（不动后端 resume 协议）？
+4. 问答旁路首期是否接受**意图节点直接带答案**（不新起只读线程）？
+
+> 以上默认按「A / 内部灰度 / 前端 pending / 意图节点带答案」推进，如需调整请指出。

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

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

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",
+      "version": "11.1.2",
-      "resolved": "https://registry.npmjs.org/@chevrotain/types/-/types-12.0.0.tgz",
+      "resolved": "https://registry.npmmirror.com/@chevrotain/types/-/types-11.1.2.tgz",
-      "integrity": "sha512-S+04vjFQKeuYw0/eW3U52LkAHQsB1ASxsPGsLPUyQgrZ2iNNibQrsidruDzjEX2JYfespXMG0eZmXlhA6z7nWA=="
+      "integrity": "sha512-U+HFai5+zmJCkK86QsaJtoITlboZHBqrVketcO2ROv865xfCMSFpELQoz1GkX5GzME8pTa+3kbKrZHQtI0gdbw==",
-    },
+      "license": "Apache-2.0"
-    "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=="
     },
     "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",
+      "version": "1.2.0",
-      "resolved": "https://registry.npmjs.org/@mermaid-js/parser/-/parser-1.1.0.tgz",
+      "resolved": "https://registry.npmmirror.com/@mermaid-js/parser/-/parser-1.2.0.tgz",
-      "integrity": "sha512-gxK9ZX2+Fex5zu8LhRQoMeMPEHbc73UKZ0FQ54YrQtUxE1VVhMwzeNtKRPAu5aXks4FasbMe4xB4bWrmq6Jlxw==",
+      "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",
+      "version": "11.16.0",
-      "resolved": "https://registry.npmjs.org/mermaid/-/mermaid-11.14.0.tgz",
+      "resolved": "https://registry.npmmirror.com/mermaid/-/mermaid-11.16.0.tgz",
-      "integrity": "sha512-GSGloRsBs+JINmmhl0JDwjpuezCsHB4WGI4NASHxL3fHo3o/BRXTxhDLKnln8/Q0lRFRyDdEjmk1/d5Sn1Xz8g==",
+      "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",
+        "dayjs": "^1.11.20",
-        "dompurify": "^3.3.1",
+        "dompurify": "^3.3.3",
-        "katex": "^0.16.25",
+        "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"
+        "uuid": "^11.1.0 || ^12 || ^13 || ^14.0.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"
       }
     },
     "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

@@ -10,7 +10,9 @@
     "build:test": "node --max-old-space-size=8192 ./node_modules/vite/bin/vite.js build --mode test",
     "build:network": "node --max-old-space-size=8192 ./node_modules/vite/bin/vite.js build --mode network",
     "preview": "vite preview",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "check:chrome109-css": "node scripts/check-chrome109-css.mjs",
+    "check:legacy-chrome-css": "node scripts/check-chrome109-css.mjs"
   },
   "dependencies": {
     "@codemirror/lang-css": "^6.3.1",
@@ -110,6 +112,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",

frontend-web/postcss.config.js

@@ -1,5 +1,11 @@
-export default {
+import tailwindcss from "@tailwindcss/postcss";
-  plugins: {
+import legacyColorFallback from "./scripts/postcss-legacy-color-fallback.mjs";
-    "@tailwindcss/postcss": {},
+import lightningCssLegacyChrome from "./scripts/postcss-lightningcss-chrome109.mjs";
-  },
+
-};
+export default {
+  plugins: [
+    tailwindcss(),
+    legacyColorFallback(),
+    lightningCssLegacyChrome(),
+  ],
+};

frontend-web/public/runtime-config.js

@@ -0,0 +1,135 @@
+// 前端运行时配置文件
+//
+// 说明：
+// 1. 本文件会在打包时原样复制到 dist/runtime-config.js。
+// 2. 应用启动时会优先读取 window.__CM_RUNTIME_CONFIG__ 里的配置。
+// 3. 部署后如果需要切换接口地址，直接修改 dist/runtime-config.js 即可，不需要重新 pnpm build。
+// 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",
+
+  // LangGraph 流式对话接口地址：普通问答、智能体对话等流式能力使用。
+  // VITE_LANGGRAPH_BASE_URL: "http://10.19.200.5:2026/api",
+
+  // 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",
+
+  // CMZS 后端接口：任务管理、任务分析、三情分析、行动分析等业务接口。
+  VITE_API_BASE_URL: "https://ch1.b.uat.4.cn/zncm",
+
+  // 佳来模型对话接口。
+  VITE_AIPI_CHAT_URL: "https://ch1.b.uat.4.cn/gpt",
+
+  // 多轮检索/生成接口。
+  VITE_AIPI_GENERATE_CHAT_URL: "https://ch1.b.uat.4.cn/jialai_b1_chat",
+
+  // 任务问答接口。
+  VITE_AIPI_TASK_CHAT_URL: "https://ch1.b.uat.4.cn/qq_b1_chat",
+
+  // B 系统知识库前端地址：用于打开知识详情、原文详情等。
+  VITE_AIPI_KNOWLEDGE_URL: "https://chlib.b.uat.4.cn/knowlibrary",
+
+  // B1 COH 系统地址。
+  VITE_AIPI_B1COH_URL: "https://ch1.b.uat.4.cn/web",
+
+  // B2 行为体/网络资源系统地址。
+  VITE_AIPI_B2ACTOR_URL: "https://ty.b.uat.4.cn",
+
+  // B2 网络 XWT iframe 路径。
+  VITE_AIPI_B2ACTOR_XWT_PATH: "/fromB/toXWT?isFrame=1",
+
+  // 知识库 iframe 地址换取接口。
+  VITE_AIPI_KNOWLEDGE_IFRAME_API_URL: "https://ch1.b.uat.4.cn/knowes/api/iframeKnowledgeUrl",
+
+  // 知识库 iframe 皮肤参数。
+  VITE_AIPI_KNOWLEDGE_IFRAME_SKIN: "red",
+
+  // MopeChat 接口地址。
+  VITE_AIPI_MOPECHAT_URL: "https://ch1.b.uat.4.cn/likun_b1_mope",
+
+  // 工作室/空间后端接口：空间列表、空间详情、素材上传等使用。
+  VITE_AIPI_BACKENP_URL: "http://47.88.25.99:8000",
+
+  // 工作室/空间后端别名：兼容旧配置命名，通常与 VITE_AIPI_BACKENP_URL 保持一致。
+  VITE_NOTEBOOK_API_BASE_URL: "http://47.88.25.99:8000",
+
+  // 工作室/空间前端地址：用于 auth/callback、新建对话等跳转。
+  VITE_AIPI_FRONTEND_URL: "http://47.88.25.99:3000",
+
+  // Consumer 接口：深链任务详情 cop-task-detail、研判情报报告 selectSqReport 等使用。
+  VITE_AIPI_CONSUMER_URL: "http://10.19.200.5:8002/consumer",
+
+  // A 系统跳转地址：人物、组织、事件等列表项打开链接使用。
+  VITE_AIPI_PRESENT_URL: "http://present.a.uat.4.cn/present/domain",
+
+  // B 系统 knowes 根地址。
+  VITE_AIPI_KNOWES_URL: "http://ch1.b.uat.4.cn/knowes",
+
+  // MaxKey 鉴权地址：onlineTicket 换 token 使用。
+  VITE_AUTH_BASE_URL: "https://auth.y.sit.4.cn",
+
+  // PG 中任务 iframe 地址。
+  VITE_AIPI_PGLINKTO_URL: "https://pg.b.uat.4.cn",
+
+  // XK 中任务 iframe 地址。
+  VITE_AIPI_XKLINKTO_URL: "https://kz.b.uat.4.cn",
+
+  // 是否使用真实任务看板数据：true=真实接口；false=本地 mock。
+  VITE_USE_REAL_DATA: "true",
+
+  // 登录深链任务详情是否使用本地 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/scripts/check-chrome109-css.mjs

@@ -0,0 +1,109 @@
+import fs from "node:fs";
+import path from "node:path";
+import postcss from "postcss";
+
+const unsupportedColor = /(?:color-mix|oklch|oklab|lab|lch)\(/i;
+const assetsDir = path.resolve("dist/assets");
+
+if (!fs.existsSync(assetsDir)) {
+  throw new Error("dist/assets 不存在，请先运行 pnpm build");
+}
+
+const cssFiles = fs
+  .readdirSync(assetsDir)
+  .filter((file) => file.endsWith(".css"));
+
+if (cssFiles.length === 0) {
+  throw new Error("dist/assets 中没有 CSS 构建产物");
+}
+
+const failures = [];
+let modernDeclarations = 0;
+
+const requiredLegacyFallbacks = [
+  {
+    file: "src/components/ui/textarea.tsx",
+    pattern: /rows=\{rows\s*\?\?\s*3\}/,
+    description: "Textarea needs a native rows fallback",
+  },
+  {
+    file: "src/components/ai-elements/prompt-input.tsx",
+    pattern: /<InputGroup className="h-auto min-h-16">/,
+    description: "Prompt textarea must not rely on :has() for its parent height",
+  },
+];
+
+for (const file of cssFiles) {
+  const root = postcss.parse(
+    fs.readFileSync(path.join(assetsDir, file), "utf8"),
+    { from: file },
+  );
+
+  root.walkDecls((declaration) => {
+    if (!unsupportedColor.test(declaration.value)) return;
+    modernDeclarations += 1;
+
+    let ancestor = declaration.parent;
+    while (ancestor) {
+      if (
+        ancestor.type === "atrule" &&
+        ancestor.name === "supports" &&
+        unsupportedColor.test(ancestor.params)
+      ) {
+        return;
+      }
+      ancestor = ancestor.parent;
+    }
+
+    let previous = declaration.prev();
+    while (previous?.type === "comment") previous = previous.prev();
+    const hasSafeFallback =
+      !declaration.prop.startsWith("--") &&
+      previous?.type === "decl" &&
+      previous.prop === declaration.prop &&
+      !unsupportedColor.test(previous.value);
+
+    if (!hasSafeFallback) {
+      failures.push(
+        `${file}:${declaration.source?.start?.line ?? "?"} ${declaration.prop}: ${declaration.value}`,
+      );
+    }
+  });
+}
+
+function walk(directory) {
+  return fs.readdirSync(directory, { withFileTypes: true }).flatMap((entry) => {
+    const fullPath = path.join(directory, entry.name);
+    return entry.isDirectory() ? walk(fullPath) : [fullPath];
+  });
+}
+
+for (const file of walk(path.resolve("src"))) {
+  if (!/\.[jt]sx?$/.test(file)) continue;
+  const source = fs.readFileSync(file, "utf8");
+  if (unsupportedColor.test(source)) {
+    failures.push(
+      `${path.relative(process.cwd(), file)} contains a runtime-only modern color function`,
+    );
+  }
+}
+
+for (const fallback of requiredLegacyFallbacks) {
+  const source = fs.readFileSync(path.resolve(fallback.file), "utf8");
+  if (!fallback.pattern.test(source)) {
+    failures.push(`${fallback.file}: ${fallback.description}`);
+  }
+}
+
+if (failures.length > 0) {
+  console.error("Legacy Chrome CSS compatibility check failed:\n");
+  console.error(failures.slice(0, 50).join("\n"));
+  if (failures.length > 50) {
+    console.error(`... and ${failures.length - 50} more`);
+  }
+  process.exit(1);
+}
+
+console.log(
+  `Legacy Chrome (100+) CSS compatibility check passed (${modernDeclarations} guarded modern declarations).`,
+);

frontend-web/scripts/postcss-legacy-color-fallback.mjs

@@ -0,0 +1,70 @@
+/**
+ * Tailwind 4 gracefully falls back from color-mix() to the base semantic
+ * color, but that turns utilities such as bg-primary/5 into an opaque fill on
+ * Chrome 109. Replace that fallback with an sRGB-channel based alpha color.
+ * The modern color-mix() declaration remains in its @supports block.
+ */
+
+const LEGACY_RGB_TOKENS = new Set([
+  "accent",
+  "background",
+  "border",
+  "brand-200",
+  "card",
+  "destructive",
+  "foreground",
+  "input",
+  "muted",
+  "muted-foreground",
+  "primary",
+  "primary-foreground",
+  "ring",
+  "secondary",
+  "sidebar-accent",
+  "sidebar-border",
+  "sidebar-foreground",
+  "workspace-brand",
+]);
+
+const TRANSPARENT_MIX_RE =
+  /color-mix\(\s*in\s+[\w-]+\s*,\s*var\(--([\w-]+)\)\s+([\d.]+)%\s*,\s*transparent\s*\)/i;
+
+function legacyAlphaColor(value) {
+  const match = value.match(TRANSPARENT_MIX_RE);
+  if (!match || !LEGACY_RGB_TOKENS.has(match[1])) return null;
+
+  const [, token, percentage] = match;
+  return `rgb(var(--legacy-${token}-rgb) / ${percentage}%)`;
+}
+
+export default function legacyColorFallback() {
+  return {
+    postcssPlugin: "postcss-legacy-color-fallback",
+    OnceExit(root) {
+      root.walkAtRules("supports", (atRule) => {
+        if (!atRule.params.includes("color-mix")) return;
+
+        atRule.walkDecls((modernDeclaration) => {
+          const fallbackValue = legacyAlphaColor(modernDeclaration.value);
+          if (!fallbackValue) return;
+
+          // Tailwind emits the old-browser declaration immediately before
+          // the nested @supports block, in the same utility/variant rule.
+          let fallbackDeclaration = atRule.prev();
+          while (fallbackDeclaration?.type === "comment") {
+            fallbackDeclaration = fallbackDeclaration.prev();
+          }
+
+          if (
+            fallbackDeclaration?.type === "decl" &&
+            fallbackDeclaration.prop === modernDeclaration.prop
+          ) {
+            fallbackDeclaration.value = fallbackValue;
+          }
+        });
+      });
+    },
+  };
+}
+
+legacyColorFallback.postcss = true;

frontend-web/scripts/postcss-lightningcss-chrome109.mjs

@@ -0,0 +1,33 @@
+import postcss from "postcss";
+import { transform } from "lightningcss";
+
+const LEGACY_CHROME = 100 << 16;
+
+/**
+ * Keep Vite's PostCSS pipeline (required by Tailwind 4), then compile the
+ * resulting CSS to Chrome 100-compatible syntax for both dev and production.
+ */
+export default function lightningCssLegacyChrome() {
+  return {
+    postcssPlugin: "postcss-lightningcss-legacy-chrome",
+    OnceExit(root, { result }) {
+      const filename = root.source?.input.file ?? result.opts.from ?? "style.css";
+      const output = transform({
+        filename,
+        code: Buffer.from(root.toString()),
+        targets: { chrome: LEGACY_CHROME },
+        minify: false,
+      });
+      const compiled = postcss.parse(output.code.toString(), { from: filename });
+
+      root.removeAll();
+      root.append(compiled.nodes);
+
+      for (const warning of output.warnings) {
+        result.warn(warning.message, { plugin: "lightningcss" });
+      }
+    },
+  };
+}
+
+lightningCssLegacyChrome.postcss = true;

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 />
+              {!positionStandaloneMode && <AuthSyncWatcher />}
-              <DesensitizeWordsLoader />
+              {!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
-          <Route path="/login/:username" element={<LoginPage />} />
+            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/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/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/components/ai-elements/code-block.tsx

@@ -1,7 +1,8 @@
 "use client";
 
-import { Button } from "@/components/ui/button";
+import { Button } from "@/components/ui/button";
-import { cn } from "@/lib/utils";
+import { copyTextToClipboard } from "@/core/clipboard";
+import { cn } from "@/lib/utils";
 import { CheckIcon, CopyIcon } from "lucide-react";
 import {
   type ComponentProps,
@@ -144,18 +145,13 @@ export const CodeBlockCopyButton = ({
   ...props
 }: CodeBlockCopyButtonProps) => {
   const [isCopied, setIsCopied] = useState(false);
-  const { code } = useContext(CodeBlockContext);
+  const { code } = useContext(CodeBlockContext);
-
+
-  const copyToClipboard = async () => {
+  const copyToClipboard = async () => {
-    if (typeof window === "undefined" || !navigator?.clipboard?.writeText) {
+    try {
-      onError?.(new Error("Clipboard API not available"));
+      await copyTextToClipboard(code);
-      return;
+      setIsCopied(true);
-    }
+      onCopy?.();
-
-    try {
-      await navigator.clipboard.writeText(code);
-      setIsCopied(true);
-      onCopy?.();
       setTimeout(() => setIsCopied(false), timeout);
     } catch (error) {
       onError?.(error as Error);

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

@@ -846,7 +846,10 @@ export const PromptInput = ({
         ref={formRef}
         {...props}
       >
-        <InputGroup>{children}</InputGroup>
+        {/* Do not rely on InputGroup's :has(textarea) selector here: Chrome
+            versions before 105 ignore :has(), retain h-9, and clip the whole
+            multi-line composer to a single row. */}
+        <InputGroup className="h-auto min-h-16">{children}</InputGroup>
       </form>
     </PromptInputValidationContext.Provider>
   );
@@ -873,16 +876,48 @@ export type PromptInputTextareaProps = ComponentProps<
   typeof InputGroupTextarea
 >;
 
-export const PromptInputTextarea = ({
+export const PromptInputTextarea = ({
-  onChange,
+  onChange,
-  className,
+  onInput,
-  placeholder = "What would you like to know?",
+  className,
-  ...props
+  placeholder = "What would you like to know?",
-}: PromptInputTextareaProps) => {
+  ...props
-  const controller = useOptionalPromptInputController();
+}: PromptInputTextareaProps) => {
-  const attachments = usePromptInputAttachments();
+  const controller = useOptionalPromptInputController();
-  const sanitizeIncomingFiles = usePromptInputValidation();
+  const attachments = usePromptInputAttachments();
-  const [isComposing, setIsComposing] = useState(false);
+  const sanitizeIncomingFiles = usePromptInputValidation();
+  const [isComposing, setIsComposing] = useState(false);
+  const textareaRef = useRef<HTMLTextAreaElement | null>(null);
+
+  const resizeForLegacyChrome = useCallback((textarea: HTMLTextAreaElement) => {
+    if (
+      typeof CSS !== "undefined" &&
+      typeof CSS.supports === "function" &&
+      CSS.supports("field-sizing", "content")
+    ) {
+      return;
+    }
+
+    // Chrome 109 ignores field-sizing: content. Preserve the same 4rem–12rem
+    // autosize range used by min-h-16/max-h-48 instead of leaving the prompt
+    // stuck at its minimum height.
+    textarea.style.height = "auto";
+    const height = Math.max(64, Math.min(textarea.scrollHeight, 192));
+    textarea.style.height = `${height}px`;
+    textarea.style.overflowY = textarea.scrollHeight > 192 ? "auto" : "hidden";
+  }, []);
+
+  // onInput does not run for a controlled value filled by a suggested question
+  // or restored draft. Resize once after every render in legacy Chrome too.
+  useEffect(() => {
+    const textarea = textareaRef.current;
+    if (!textarea) return;
+
+    const frame = window.requestAnimationFrame(() => {
+      resizeForLegacyChrome(textarea);
+    });
+    return () => window.cancelAnimationFrame(frame);
+  }, [controller?.textInput.value, resizeForLegacyChrome]);
 
   const handleKeyDown: KeyboardEventHandler<HTMLTextAreaElement> = (e) => {
     if (e.key === "Enter") {
@@ -962,12 +997,18 @@ export const PromptInputTextarea = ({
       };
 
   return (
-    <InputGroupTextarea
+    <InputGroupTextarea
-      className={cn("field-sizing-content max-h-48 min-h-16", className)}
+      className={cn("field-sizing-content max-h-48 min-h-16", className)}
-      name="message"
+      name="message"
+      ref={textareaRef}
+      rows={3}
       onCompositionEnd={() => setIsComposing(false)}
       onCompositionStart={() => setIsComposing(true)}
-      onKeyDown={handleKeyDown}
+      onKeyDown={handleKeyDown}
+      onInput={(event) => {
+        resizeForLegacyChrome(event.currentTarget);
+        onInput?.(event);
+      }}
       onPaste={handlePaste}
       placeholder={placeholder}
       {...props}

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

@@ -26,6 +26,7 @@ import {
 import { Button } from "@/components/ui/button";
 import { toast } from "sonner";
 import { getStoredAuth } from "@/core/auth";
+import { readRuntimeEnv } from "@/env";
 import { queryClient } from "@/components/query-client-provider";
 import { Checkbox } from "@/components/ui/checkbox";
 import Empty from "./empty";
@@ -303,11 +304,11 @@ const DocumentUploadPopupContent: FC<{
   const searchSpaceId = String(searchSpace?.id);
 
   // 从环境变量获取配置
-  const backendUrl = import.meta.env.VITE_AIPI_BACKENP_URL || "http://localhost:8001";
+  const backendUrl = readRuntimeEnv("VITE_AIPI_BACKENP_URL") || "http://localhost:8001";
-  const consumerUrl = import.meta.env.VITE_AIPI_CONSUMER_URL || "http://ch1.b.uat.4.cn/consumer";
+  const consumerUrl = readRuntimeEnv("VITE_AIPI_CONSUMER_URL") || "http://ch1.b.uat.4.cn/consumer";
-  const presentUrl = import.meta.env.VITE_AIPI_PRESENT_URL || "http://present.a.uat.4.cn/present/domain";
+  const presentUrl = readRuntimeEnv("VITE_AIPI_PRESENT_URL") || "http://present.a.uat.4.cn/present/domain";
-  const knowesUrl = import.meta.env.VITE_AIPI_KNOWES_URL || "http://ch1.b.uat.4.cn/knowes";
+  const knowesUrl = readRuntimeEnv("VITE_AIPI_KNOWES_URL") || "http://ch1.b.uat.4.cn/knowes";
-  const knowledgeUrl = import.meta.env.VITE_AIPI_KNOWLEDGE_URL || "http://chlib.b.uat.4.cn/knowlibrary";
+  const knowledgeUrl = readRuntimeEnv("VITE_AIPI_KNOWLEDGE_URL") || "http://chlib.b.uat.4.cn/knowlibrary";
 
   const [searchText, setSearchText] = useState("");
   const [searchValue, setSearchValue] = useState("");

frontend-web/src/components/assistant-ui/network-actor.tsx

@@ -11,6 +11,7 @@ import { Button } from "@/components/ui/button";
 import { toast } from "sonner";
 import { getStoredAuth } from "@/core/auth";
 import { authenticatedFetch } from "@/components/assistant-ui/document-upload-popup";
+import { readRuntimeEnv } from "@/env";
 
 
 interface NetworkActorProps {
@@ -186,9 +187,9 @@ export function NetworkActor({ inputValue, searchSpaceId, onSuccess }: NetworkAc
   const [actorCount, setActorCount] = useState<number>(0);
   const [directionType, setDirectionType] = useState<string>('TW');
   const directionValue = useRef<string>('TW');
-  const consumerUrl = import.meta.env.VITE_AIPI_CONSUMER_URL || 'https://ch1.b.uat.4.cn/consumer';
+  const consumerUrl = readRuntimeEnv("VITE_AIPI_CONSUMER_URL") || 'https://ch1.b.uat.4.cn/consumer';
   const backendUrl = typeof window !== 'undefined'
-    ? (import.meta.env.VITE_BACKEND_BASE_URL || 'http://localhost:8001')
+    ? (readRuntimeEnv("VITE_BACKEND_BASE_URL") || 'http://localhost:8001')
     : 'http://localhost:8001';
   const [selectedSearchSources, setSelectedSearchSources] = useState<UserDataItem[]>([]);
   const [isImporting, setIsImporting] = useState(false);

frontend-web/src/components/landing/progressive-skills-animation.tsx

@@ -508,8 +508,9 @@ export default function ProgressiveSkillsAnimation() {
                     "deploying",
                     "done",
                   ].includes(phase) && (
-                    <div className="text-base text-zinc-300">
+                    <div className="flex items-center gap-2 text-base text-zinc-300">
-                      <span className="text-purple-400">✨</span> Found 3 skills
+                      <Sparkles size={16} className="text-purple-400" />
+                      <span>Found 3 skills</span>
                     </div>
                   )}
 
@@ -526,8 +527,9 @@ export default function ProgressiveSkillsAnimation() {
                   ].includes(phase) && (
                     <div className="mt-4">
                       <hr className="mb-3 border-zinc-700" />
-                      <div className="mb-3 text-zinc-300">
+                      <div className="mb-3 inline-flex items-center gap-2 text-zinc-300">
-                        🔬 Researching...
+                        <Search size={16} className="text-blue-400" />
+                        <span>Researching...</span>
                       </div>
                       <div className="mb-3 space-y-2">
                         {/* Loading SKILL.md */}
@@ -623,7 +625,10 @@ export default function ProgressiveSkillsAnimation() {
                       className="mt-4"
                     >
                       <hr className="mb-3 border-zinc-700" />
-                      <div className="mb-3 text-zinc-300">🔨 Building...</div>
+                      <div className="mb-3 inline-flex items-center gap-2 text-zinc-300">
+                        <FileText size={16} className="text-zinc-400" />
+                        <span>Building...</span>
+                      </div>
                       <div className="mb-3 flex items-center gap-2 pl-4 text-zinc-400">
                         <FileText size={16} />
                         <span>Loading frontend-design/SKILL.md...</span>
@@ -653,7 +658,10 @@ export default function ProgressiveSkillsAnimation() {
                       className="mt-4"
                     >
                       <hr className="mb-3 border-zinc-700" />
-                      <div className="mb-3 text-zinc-300">🚀 Deploying...</div>
+                      <div className="mb-3 inline-flex items-center gap-2 text-zinc-300">
+                        <Terminal size={16} className="text-zinc-400" />
+                        <span>Deploying...</span>
+                      </div>
                       <div className="mb-3 space-y-2">
                         <div className="flex items-center gap-2 pl-4 text-zinc-400">
                           <FileText size={16} />
@@ -676,8 +684,9 @@ export default function ProgressiveSkillsAnimation() {
                           animate={{ opacity: 1, scale: 1 }}
                           className="mt-4 rounded-xl border border-green-500/30 bg-green-500/10 p-4"
                         >
-                          <div className="text-lg font-medium text-green-500">
+                          <div className="inline-flex items-center gap-2 text-lg font-medium text-green-500">
-                            ✅ Live at biotech-startup.vercel.app
+                            <Check size={18} />
+                            <span>Live at biotech-startup.vercel.app</span>
                           </div>
                         </motion.div>
                       )}

frontend-web/src/components/landing/sections/sandbox-section.tsx

@@ -35,27 +35,27 @@ export function SandboxSection({ className }: { className?: string }) {
               $ pip install -r requirements.txt
             </TypingAnimation>
             <AnimatedSpan delay={2000} className="text-green-500">
-              ✔ Installed pygame
+              [ok] Installed pygame
             </AnimatedSpan>
 
             <TypingAnimation delay={2400}>
               $ write game.py --lines 156
             </TypingAnimation>
             <AnimatedSpan delay={3200} className="text-blue-500">
-              ✔ Written 156 lines
+              [ok] Written 156 lines
             </AnimatedSpan>
 
             <TypingAnimation delay={3600}>
               $ python game.py --test
             </TypingAnimation>
             <AnimatedSpan delay={4200} className="text-green-500">
-              ✔ All sprites loaded
+              [ok] All sprites loaded
             </AnimatedSpan>
             <AnimatedSpan delay={4500} className="text-green-500">
-              ✔ Physics engine OK
+              [ok] Physics engine OK
             </AnimatedSpan>
             <AnimatedSpan delay={4800} className="text-green-500">
-              ✔ 60 FPS stable
+              [ok] 60 FPS stable
             </AnimatedSpan>
 
             {/* Scene 2: Data Analysis */}

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,6 +575,37 @@
     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）+ 右侧三级列（展开时整体变宽，带过渡）──────── */
 .light-sidebar {
     position: fixed;
@@ -587,6 +629,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

@@ -49,6 +49,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 +81,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 +157,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="二级菜单">
@@ -287,6 +298,7 @@ function SecondaryNavSidebar() {
 function LegacyAccordionSidebar({
   collapsed,
   onToggleCollapsed,
+  headerHidden,
 }: PageSidebarProps) {
   const { theme } = useTheme();
   const isDark = theme === "dark";
@@ -438,7 +450,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"

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

frontend-web/src/components/ui/input-group.tsx

@@ -144,21 +144,24 @@ function InputGroupInput({
   );
 }
 
-function InputGroupTextarea({
+const InputGroupTextarea = React.forwardRef<
-  className,
+  HTMLTextAreaElement,
-  ...props
+  React.ComponentProps<"textarea">
-}: React.ComponentProps<"textarea">) {
+>(function InputGroupTextarea({ className, ...props }, ref) {
   return (
-    <Textarea
+    <Textarea
-      data-slot="input-group-control"
+      data-slot="input-group-control"
+      ref={ref}
       className={cn(
         "flex-1 resize-none rounded-none border-0 bg-transparent py-3 shadow-none focus-visible:ring-0 dark:bg-transparent",
         className,
       )}
-      {...props}
+      {...props}
-    />
+    />
-  );
+  );
-}
+});
+
+InputGroupTextarea.displayName = "InputGroupTextarea";
 
 export {
   InputGroup,

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

@@ -57,18 +57,21 @@ function useSidebarSafe() {
   return React.useContext(SidebarContext);
 }
 
-function SidebarProvider({
+function SidebarProvider({
-  defaultOpen = true,
+  defaultOpen = true,
-  open: openProp,
+  open: openProp,
-  onOpenChange: setOpenProp,
+  onOpenChange: setOpenProp,
-  className,
+  disableToggle = false,
+  className,
   style,
   children,
   ...props
-}: React.ComponentProps<"div"> & {
+}: React.ComponentProps<"div"> & {
-  defaultOpen?: boolean;
+  defaultOpen?: boolean;
-  open?: boolean;
+  open?: boolean;
-  onOpenChange?: (open: boolean) => void;
+  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.
+  // Helper to toggle the sidebar.
-  const toggleSidebar = React.useCallback(() => {
+  const toggleSidebar = React.useCallback(() => {
-    return isMobile ? setOpenMobile((open) => !open) : setOpen((open) => !open);
+    if (disableToggle) return;
-  }, [isMobile, setOpen, setOpenMobile]);
+    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/ui/textarea.tsx

@@ -2,19 +2,28 @@ import * as React from "react";
 
 import { cn } from "@/lib/utils";
 
-function Textarea({ className, ...props }: React.ComponentProps<"textarea">) {
+const Textarea = React.forwardRef<
-  return (
+  HTMLTextAreaElement,
-    <textarea
+  React.ComponentProps<"textarea">
-      data-slot="textarea"
+>(function Textarea({ className, rows, ...props }, ref) {
-      className={cn(
+  // `field-sizing` is not available in older Chrome. Keep a native rows
-        "border-input placeholder:text-muted-foreground/60 flex field-sizing-content min-h-16 w-full rounded-md border bg-transparent px-3 py-2 text-base shadow-xs transition-[color,box-shadow] outline-none disabled:cursor-not-allowed disabled:opacity-50 md:text-sm",
+  // fallback so a multi-line editor never collapses into a single line.
+  return (
+    <textarea
+      data-slot="textarea"
+      ref={ref}
+      rows={rows ?? 3}
+      className={cn(
+        "border-input placeholder:text-muted-foreground/60 flex min-h-16 w-full rounded-md border bg-transparent px-3 py-2 text-base shadow-xs transition-[color,box-shadow] outline-none disabled:cursor-not-allowed disabled:opacity-50 md:text-sm",
         "dark:border-[#1B477E] dark:bg-[#022248] dark:text-[#AACEFF] ",
         "focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive",
         className,
       )}
-      {...props}
+      {...props}
-    />
+    />
-  );
+  );
-}
+});
+
+Textarea.displayName = "Textarea";
 
 export { Textarea };

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

@@ -3,7 +3,7 @@ export function EmptyDocumentState() {
   return (
     <div className="flex h-full items-center justify-center bg-white px-6 text-center dark:bg-slate-900">
       <div className="rounded-2xl border border-dashed border-slate-300 bg-slate-50 px-10 py-12 sm:px-12 dark:border-slate-700 dark:bg-slate-800/50">
-        <div className="mb-4 text-[40px] leading-none">📚</div>
+        <div className="mb-4 text-[28px] font-semibold leading-none text-slate-500 dark:text-slate-300">文档</div>
         <div className="mb-2 text-lg font-bold text-slate-700 dark:text-slate-200">
           选择一篇文档开始阅读
         </div>

frontend-web/src/components/workspace/admin/tool-metrics-panel.tsx

@@ -213,7 +213,7 @@ const errorToastDarkOptions = {
         </div>
         <div className="flex flex-1 flex-wrap items-center gap-1.5">
           {summary && Object.keys(summary.by_category).length === 0 && (
-            <span className="text-muted-foreground text-sm">暂无失败记录 🎉</span>
+            <span className="text-muted-foreground text-sm">暂无失败记录</span>
           )}
           {summary &&
             Object.entries(summary.by_category)

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` 切换深蓝/浅色调色板。 */
+/** 按 agent id 稳定散列出一对渐变色，并根据当前主题返回可读的图标前景色。 */
-export function agentColor(id: string, isDark: boolean) {
+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;
+  const palette =
-  return palette[hash % palette.length]!;
+    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/agent-welcome.tsx

@@ -35,7 +35,7 @@ export function AgentWelcome({
         className,
       )}
     >
-      <div className="bg-primary/10 ring-primary/15 mb-2 flex h-[72px] w-[72px] items-center justify-center rounded-3xl ring-1">
+      <div className="agent-avatar bg-primary/10 ring-primary/15 mb-2 flex h-[72px] w-[72px] items-center justify-center rounded-3xl ring-1">
         <BotIcon className="text-primary h-9 w-9" />
       </div>
       <div className="text-3xl font-bold tracking-tight">

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

@@ -839,7 +839,7 @@ export function AgentCard({ agent, layout = "card", onPublisherClick }: AgentCar
       <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="bg-primary/10 text-primary flex h-9 w-9 shrink-0 items-center justify-center rounded-lg">
+            <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">
@@ -894,7 +894,7 @@ export function AgentCard({ agent, layout = "card", onPublisherClick }: AgentCar
 
   const listLayout = (
     <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="bg-primary/10 text-primary flex h-9 w-9 shrink-0 items-center justify-center rounded-lg">
+      <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">
@@ -980,7 +980,7 @@ export function AgentCard({ agent, layout = "card", onPublisherClick }: AgentCar
                     ? "正在加载 SOUL.md..."
                     : "输入 SOUL.md 内容"
                 }
-                className="max-h-[45vh] min-h-48 resize-y font-mono text-xs"
+                className="max-h-[45vh] min-h-48 resize-y text-xs"
               />
             </div>
             <div className="space-y-2">

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

@@ -254,43 +254,75 @@ 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}
                         href={href}
                         className={cn(
-                          "group relative flex w-full items-start gap-2.5 rounded-xl border px-2.5 py-2 transition-colors",
+                          "group relative flex w-full items-start gap-3 rounded-xl border px-3 py-2.5 transition-all duration-150",
                           isActive
-                            ? "border-primary/40 bg-primary/5"
+                            ? isDark
-                            : "border-transparent hover:border-border hover:bg-accent/50",
+                              ? "border-[#2b8ffe] bg-[#0b4fae]/65 shadow-[0_0_0_1px_rgba(43,143,254,0.5),0_12px_28px_rgba(37,128,255,0.25)]"
+                              : "agent-sidebar-card--active border-primary/50 bg-primary/10 shadow-sm"
+                            : isDark
+                              ? "border-[#2b8ffe]/20 bg-[#042b59]/35 hover:border-[#2b8ffe]/60 hover:bg-[#063b77]/60"
+                              : "border-transparent hover:border-border hover:bg-accent/50",
                         )}
                       >
                         <span
-                          className="mt-0.5 flex size-9 shrink-0 items-center justify-center rounded-lg text-white shadow-sm"
+                          className={cn(
+                            "mt-0.5 flex size-10 shrink-0 items-center justify-center rounded-lg text-white shadow-sm",
+                            isDark &&
+                              isActive &&
+                              "ring-2 ring-[#83c1ff]/35 shadow-[0_0_18px_rgba(43,143,254,0.45)]",
+                          )}
                           style={{
                             backgroundImage: `linear-gradient(135deg, ${from}, ${to})`,
+                            color: foreground,
                           }}
                         >
-                          <Bot className="size-[18px]" />
+                          <Bot className="size-[19px]" />
                         </span>
                         <span className="min-w-0 flex-1">
                           <span
                             className={cn(
-                              "block truncate text-[13px] font-semibold",
+                              "block truncate text-[16px] leading-5 font-bold",
-                              isActive ? "text-primary" : "text-foreground",
+                              isActive
+                                ? isDark
+                                  ? "text-white"
+                                  : "text-primary"
+                                : isDark
+                                  ? "text-white/95"
+                                  : "text-foreground",
                             )}
                           >
                             {desensitize(agent.name)}
                           </span>
-                          <span className="mt-0.5 block truncate text-[11px] leading-snug text-muted-foreground">
+                          <span
+                            className={cn(
+                              "mt-1 block truncate text-[13px] leading-[1.35]",
+                              isDark
+                                ? isActive
+                                  ? "text-[#d6eaff]"
+                                  : "text-[#9ebfe2]"
+                                : "text-muted-foreground",
+                            )}
+                          >
                             {agent.description
                               ? desensitize(agent.description)
                               : "智能体助手"}
                           </span>
                         </span>
                         {isActive && (
-                          <span className="absolute top-1/2 right-1 h-6 w-1 -translate-y-1/2 rounded-full bg-primary" />
+                          <span
+                            className={cn(
+                              "absolute top-1/2 right-1.5 h-8 w-1.5 -translate-y-1/2 rounded-full",
+                              isDark
+                                ? "bg-[#2b8ffe] shadow-[0_0_14px_rgba(43,143,254,0.85)]"
+                                : "bg-primary",
+                            )}
+                          />
                         )}
                       </Link>
                     );

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

@@ -138,6 +138,7 @@ export function AgentDetailPanel({
   disabled,
   defaultCollapsed,
   showRecentChats,
+  compactAppearanceActions,
 }: {
   agent: Agent | null | undefined;
   agentName: string;
@@ -147,6 +148,8 @@ export function AgentDetailPanel({
   defaultCollapsed?: boolean;
   /** 在面板底部展示「有关此智能体的最近对话」（仅智能体问答页开启，任务工作区不展示）。 */
   showRecentChats?: boolean;
+  /** 简洁模式下挂在右上角收起/展开按钮左侧的外观控件。 */
+  compactAppearanceActions?: ReactNode;
 }) {
   const router = useRouter();
   const [collapsed, setCollapsed] = useState(defaultCollapsed ?? false);
@@ -517,7 +520,7 @@ export function AgentDetailPanel({
       {/* ── Identity / 基础信息 ─────────────────────────────────────────── */}
       <section className="bg-card/60 rounded-xl border p-4">
         <div className="flex items-start gap-3">
-          <div className="bg-primary/10 ring-primary/15 flex size-12 shrink-0 items-center justify-center rounded-2xl ring-1">
+          <div className="agent-avatar bg-primary/10 ring-primary/15 flex size-12 shrink-0 items-center justify-center rounded-2xl ring-1">
             <BotIcon className="text-primary size-6" />
           </div>
           <div className="min-w-0 flex-1 space-y-1.5">
@@ -827,9 +830,10 @@ export function AgentDetailPanel({
   const panelChrome = (collapseButton: ReactNode) => (
     <>
       <div className="flex h-12 shrink-0 items-center justify-between border-b px-4">
-        <span className="text-sm font-semibold">智能体信息</span>
+        <span className="shrink-0 whitespace-nowrap text-sm font-semibold">智能体信息</span>
-        <div className="flex items-center gap-1">
+        <div className="flex min-w-0 items-center gap-1">
           {headerActions}
+          {compactAppearanceActions}
           {collapseButton}
         </div>
       </div>
@@ -841,17 +845,20 @@ export function AgentDetailPanel({
     <>
       {/* ── Desktop (lg+): inline aside, collapsible to a rail ───────────── */}
       {collapsed ? (
-        <div className="hidden shrink-0 flex-col items-center border-l pt-3 lg:flex">
+        <div className="hidden shrink-0 items-start border-l px-2 pt-3 lg:flex">
-          <Tooltip content="智能体信息">
+          <div className="flex items-center gap-1">
-            <Button
+            {compactAppearanceActions}
-              variant="ghost"
+            <Tooltip content="智能体信息">
-              size="icon-sm"
+              <Button
-              onClick={() => setCollapsed(false)}
+                variant="ghost"
-              aria-label="展开智能体信息"
+                size="icon-sm"
-            >
+                onClick={() => setCollapsed(false)}
-              <PanelRightOpenIcon className="size-4" />
+                aria-label="展开智能体信息"
-            </Button>
+              >
-          </Tooltip>
+                <PanelRightOpenIcon className="size-4" />
+              </Button>
+            </Tooltip>
+          </div>
         </div>
       ) : (
         <aside className="bg-card/40 hidden h-full w-[360px] shrink-0 flex-col border-l lg:flex">

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

@@ -138,7 +138,7 @@ export function AgentModuleSettingsDialog({
                       key={agent.id}
                       className="flex items-start gap-3 rounded-xl border border-border/60 bg-card p-3"
                     >
-                      <div className="bg-primary/10 text-primary mt-0.5 flex size-8 shrink-0 items-center justify-center rounded-lg">
+                      <div className="agent-avatar bg-primary/10 text-primary mt-0.5 flex size-8 shrink-0 items-center justify-center rounded-lg">
                         <Bot className="size-4" />
                       </div>
                       <div className="min-w-0 flex-1">

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

@@ -206,39 +206,80 @@ 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}`}
         href={href}
+        onClick={() => {
+          try {
+            sessionStorage.setItem(`agent-module:${moduleKey}:last-agent`, agent.id);
+          } catch {
+            // Ignore storage failures; route navigation is the source of truth.
+          }
+        }}
         className={cn(
-          "group relative flex w-full items-start gap-2.5 rounded-xl border px-2.5 py-2 transition-colors",
+          "group relative flex w-full items-start gap-3 rounded-xl border px-3 py-2.5 transition-all duration-150",
           isActive
-            ? "border-primary/40 bg-primary/5"
+            ? isDark
-            : "border-transparent hover:border-border hover:bg-accent/50",
+              ? "border-[#2b8ffe] bg-[#0b4fae]/65 shadow-[0_0_0_1px_rgba(43,143,254,0.5),0_12px_28px_rgba(37,128,255,0.25)]"
+              : "agent-sidebar-card--active border-primary/50 bg-primary/10 shadow-sm"
+            : isDark
+              ? "border-[#2b8ffe]/20 bg-[#042b59]/35 hover:border-[#2b8ffe]/60 hover:bg-[#063b77]/60"
+              : "border-transparent hover:border-border hover:bg-accent/50",
         )}
       >
         <span
-          className="mt-0.5 flex size-9 shrink-0 items-center justify-center rounded-lg text-white shadow-sm"
+          className={cn(
-          style={{ backgroundImage: `linear-gradient(135deg, ${from}, ${to})` }}
+            "mt-0.5 flex size-10 shrink-0 items-center justify-center rounded-lg text-white shadow-sm",
+            isDark &&
+              isActive &&
+              "ring-2 ring-[#83c1ff]/35 shadow-[0_0_18px_rgba(43,143,254,0.45)]",
+          )}
+          style={{
+            backgroundImage: `linear-gradient(135deg, ${from}, ${to})`,
+            color: foreground,
+          }}
         >
-          <Bot className="size-[18px]" />
+          <Bot className="size-[19px]" />
         </span>
         <span className="min-w-0 flex-1">
           <span
             className={cn(
-              "block truncate text-[13px] font-semibold",
+              "block truncate text-[16px] leading-5 font-bold",
-              isActive ? "text-primary" : "text-foreground",
+              isActive
+                ? isDark
+                  ? "text-white"
+                  : "text-primary"
+                : isDark
+                  ? "text-white/95"
+                  : "text-foreground",
             )}
           >
             {desensitize(agent.name)}
           </span>
-          <span className="mt-0.5 block truncate text-[11px] leading-snug text-muted-foreground">
+          <span
+            className={cn(
+              "mt-1 block truncate text-[13px] leading-[1.35]",
+              isDark
+                ? isActive
+                  ? "text-[#d6eaff]"
+                  : "text-[#9ebfe2]"
+                : "text-muted-foreground",
+            )}
+          >
             {agent.description ? desensitize(agent.description) : "智能体助手"}
           </span>
         </span>
         {isActive && (
-          <span className="absolute top-1/2 right-1 h-6 w-1 -translate-y-1/2 rounded-full bg-primary" />
+          <span
+            className={cn(
+              "absolute top-1/2 right-1.5 h-8 w-1.5 -translate-y-1/2 rounded-full",
+              isDark
+                ? "bg-[#2b8ffe] shadow-[0_0_14px_rgba(43,143,254,0.85)]"
+                : "bg-primary",
+            )}
+          />
         )}
       </Link>
     );

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

@@ -1,7 +1,7 @@
 "use client";
 
-import { Check, LayoutIcon, PanelLeftIcon, Shirt } from "lucide-react";
+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";
@@ -14,8 +14,11 @@ import {
   DropdownMenuTrigger,
 } from "@/components/ui/dropdown-menu";
 import { useTheme, type ThemeType } from "@/contexts/ThemeContext";
-import { useLayoutMode } from "@/core/system-settings/hooks";
+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";
 
 /**
  * 换肤 / 界面模式 顶栏控件。深色顶栏（Header）与简洁模式页面级顶栏（ChatPage 等）共用，
@@ -25,10 +28,13 @@ import { cn } from "@/lib/utils";
  */
 export type AppearanceControlTone = "banner-dark" | "banner-light" | "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" },
 ];
 
@@ -39,10 +45,62 @@ const triggerToneClass = (tone: AppearanceControlTone) =>
       ? "text-white hover:bg-[var(--brand-950)] hover:text-white active:bg-[#8a0618]"
       : "text-muted-foreground hover:bg-muted hover:text-foreground";
 
+export function CompactShortcutButtons({ tone }: { tone: AppearanceControlTone }) {
+  const { data: appearance } = useAppearanceSettings();
+  const buttons = (appearance?.compact_shortcut_buttons ?? [])
+    .filter((button) => button.enabled && button.label.trim() && button.url.trim())
+    .sort((a, b) => a.sort_order - b.sort_order);
+
+  if (buttons.length === 0) return null;
+
+  return (
+    <>
+      {buttons.map((button) => (
+        <Button
+          key={button.id}
+          type="button"
+          variant="ghost"
+          size="sm"
+          className={cn(
+            "h-8 max-w-[168px] shrink-0 gap-1.5 rounded-sm px-2 text-xs font-medium",
+            triggerToneClass(tone),
+          )}
+          title={button.label}
+          onClick={() => {
+            const url = buildLightAppUrl({
+              url: button.url,
+              routeParams: button.route_params.map((param) => ({ ...param })),
+            });
+            window.open(url, "_blank", "noopener,noreferrer");
+          }}
+        >
+          <ExternalLink className="size-4 shrink-0" />
+          <span className="truncate">{button.label}</span>
+        </Button>
+      ))}
+    </>
+  );
+}
+
 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) {
@@ -57,6 +115,8 @@ export function ThemeSwitcher({ tone }: { tone: AppearanceControlTone }) {
 
   useEffect(() => () => cancelClose(), []);
 
+  if (env.FORCE_COLLAPSED_SIDEBAR || isHideChromeActive()) return null;
+
   return (
     <div
       className="relative"
@@ -79,9 +139,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="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-black/5 bg-white" />
+            <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" />
-            {THEME_SWATCHES.map((swatch) => {
+            {swatches.map((swatch) => {
               const active = theme === swatch.id;
               return (
                 <button
@@ -136,15 +196,19 @@ const LAYOUT_OPTIONS = [
 export function LayoutModeSwitcher({
   tone,
   fallback = "compact",
+  navigateTo = "/page/workspace/chats/new",
 }: {
   tone: AppearanceControlTone;
   fallback?: "full" | "compact";
+  navigateTo?: string | null;
 }) {
   const [mode, setLayoutMode] = useLayoutMode();
   const navigate = useNavigate();
   const current = mode ?? fallback;
   const TriggerIcon = current === "full" ? PanelLeftIcon : LayoutIcon;
 
+  if (env.FORCE_COLLAPSED_SIDEBAR || isHideChromeActive()) return null;
+
   return (
     <DropdownMenu>
       <DropdownMenuTrigger asChild>
@@ -170,7 +234,9 @@ export function LayoutModeSwitcher({
               key={option.id}
               onClick={() => {
                 setLayoutMode(option.id);
-                navigate("/page/workspace/chats/new");
+                if (navigateTo) {
+                  navigate(navigateTo);
+                }
               }}
               className="gap-2"
             >

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

@@ -11,6 +11,7 @@ import {
   LoaderIcon,
   PackageIcon,
   SaveIcon,
+  SparklesIcon,
   UploadCloudIcon,
   XIcon,
 } from "lucide-react";
@@ -28,7 +29,7 @@ import {
   ArtifactHeader,
   ArtifactTitle,
 } from "@/components/ai-elements/artifact";
-import { Select, SelectItem } from "@/components/ui/select";
+import { Select, SelectItem } from "@/components/ui/select";
 import {
   SelectContent,
   SelectGroup,
@@ -37,9 +38,11 @@ import {
 } from "@/components/ui/select";
 import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group";
 import { CodeEditor } from "@/components/workspace/code-editor";
+import { MarkdownAiEditor } from "@/open-canvas/components/artifact/MarkdownAiEditor";
 import { publishArtifactToKnowledge } from "@/core/agents/api";
 import { useAgent } from "@/core/agents/hooks";
-import { apiFetch } from "@/core/api";
+import { apiFetch } from "@/core/api";
+import { copyTextToClipboard } from "@/core/clipboard";
 import {
   downloadArtifactFile,
 } from "@/core/artifacts/download";
@@ -120,13 +123,14 @@ export function ArtifactFileDetail({
   className,
   filepath: filepathFromProps,
   threadId,
-  onClose,
+  onClose,
-  allowVirtualMarkdownEdit = false,
+  allowVirtualMarkdownEdit = false,
-  disableDesensitize = false,
+  disableDesensitize = false,
-}: {
+  hideFileName = false,
-  className?: string;
+}: {
-  filepath: string;
+  className?: string;
-  threadId: string;
+  filepath: string;
+  threadId: string;
   /** 覆盖默认关闭行为（仅 setOpen(false)）；圆桌 Step3 文件预览用于退出沙箱模式。 */
   onClose?: () => void;
   /**
@@ -139,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();
@@ -213,12 +218,17 @@ export function ArtifactFileDetail({
     !useWriteFileStreaming &&
     !isSkillFile &&
     !isMock;
+  // 「AI 写作」md 展示开关：只要是可编辑的 markdown 就提供「AI 写作」视图（在 源码/预览 旁多一个
+  // 切换项），用户可随时切过去体验划词「AI 改写」。默认仍是「预览」，避免编辑器在内容加载期间
+  // 挂载导致白屏 + 避免复杂 md(表格/公式/HTML)误入有损编辑。
+  const canUseAiEditor = canEditArtifact;
   const [draftContent, setDraftContent] = useState("");
   const [hasLocalEdits, setHasLocalEdits] = useState(false);
-  const updateArtifact = useUpdateArtifactContent();
+  const updateArtifact = useUpdateArtifactContent();
-  const displayContent = canEditArtifact ? draftContent : (content ?? "");
+  const displayContent = canEditArtifact ? draftContent : (content ?? "");
-  const isHtmlStreaming = language === "html" && thread.isLoading;
+  const isAutoPreviewLanguage = language === "html" || language === "markdown";
-  const hasMultipleArtifacts = (artifacts?.length ?? 0) > 1;
+  const isPreviewStreaming = isAutoPreviewLanguage && thread.isLoading;
+  const hasMultipleArtifacts = (artifacts?.length ?? 0) > 1;
   const fileTypeLabel = useMemo(() => {
     if (isImageFile(filepath)) return "IMG";
     if (isSpreadsheetFile) return "XLSX";
@@ -230,7 +240,7 @@ export function ArtifactFileDetail({
     return "FILE";
   }, [filepath, isSkillFile, isSpreadsheetFile, language]);
 
-  const [viewMode, setViewMode] = useState<"code" | "preview">("code");
+  const [viewMode, setViewMode] = useState<"code" | "preview" | "edit">("code");
   const [allowAutoViewSwitch, setAllowAutoViewSwitch] = useState(true);
   const [installDialogOpen, setInstallDialogOpen] = useState(false);
   const [showPreviewSwitchPulse, setShowPreviewSwitchPulse] = useState(false);
@@ -257,28 +267,36 @@ export function ArtifactFileDetail({
     setDraftContent(content ?? "");
   }, [canEditArtifact, content, hasLocalEdits]);
 
-  useEffect(() => {
+  useEffect(() => {
-    setAllowAutoViewSwitch(true);
+    setAllowAutoViewSwitch(true);
-    setAutoScrollEnabled(true);
+    setAutoScrollEnabled(true);
-    setShowResumeAutoScroll(false);
+    setShowResumeAutoScroll(false);
-
+    setShowPreviewSwitchPulse(false);
-    if (language === "html") {
+  }, [filepathFromProps]);
-      setViewMode(thread.isLoading ? "code" : "preview");
+
-      return;
+  useEffect(() => {
-    }
+    if (isPreviewStreaming) {
-
+      setViewMode("code");
-    if (isSupportPreview) {
+      return;
-      setViewMode("preview");
+    }
-      return;
+
-    }
+    if (language === "html") {
-
+      setViewMode(thread.isLoading ? "code" : "preview");
-    setViewMode("code");
+      return;
-  }, [filepathFromProps, isSupportPreview, language, thread.isLoading]);
+    }
-
+
-  useEffect(() => {
+    if (isSupportPreview) {
-    if (!allowAutoViewSwitch || language !== "html") {
+      setViewMode("preview");
-      return;
+      return;
-    }
+    }
+
+    setViewMode("code");
+  }, [isPreviewStreaming, isSupportPreview, language, thread.isLoading]);
+
+  useEffect(() => {
+    if (!allowAutoViewSwitch || !isAutoPreviewLanguage) {
+      return;
+    }
 
     if (thread.isLoading) {
       setViewMode("code");
@@ -290,9 +308,9 @@ export function ArtifactFileDetail({
     const timeoutId = window.setTimeout(() => {
       setShowPreviewSwitchPulse(false);
     }, 1400);
-
+
-    return () => window.clearTimeout(timeoutId);
+    return () => window.clearTimeout(timeoutId);
-  }, [allowAutoViewSwitch, language, thread.isLoading]);
+  }, [allowAutoViewSwitch, isAutoPreviewLanguage, isSupportPreview, thread.isLoading]);
 
   const scrollArtifactToBottom = useCallback(
     (behavior: ScrollBehavior = "auto") => {
@@ -575,8 +593,11 @@ 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 && (
-              {useWriteFileStreaming ? (
+            <ArtifactTitle className="min-w-0">
+              {/* markdown：隐藏文件名（仅留 MD 徽标），把横向空间让给工具栏，避免窄面板下
+                  工具栏换行错位；多文件仍保留切换下拉（靠它切文件）。文件名仍可在下载/另存为时取到。 */}
+              {language === "markdown" && !hasMultipleArtifacts ? null : useWriteFileStreaming ? (
                 <div className="truncate px-3">{getFileName(filepath)}</div>
               ) : hasMultipleArtifacts ? (
                 <Select value={filepath} onValueChange={select}>
@@ -596,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">
@@ -616,10 +638,19 @@ export function ArtifactFileDetail({
                 onValueChange={(value) => {
                   if (value) {
                     setAllowAutoViewSwitch(false);
-                    setViewMode(value as "code" | "preview");
+                    setViewMode(value as "code" | "preview" | "edit");
                   }
                 }}
               >
+                {canUseAiEditor && (
+                  <ToggleGroupItem
+                    className="text-muted-foreground h-8 min-w-10 rounded-full border-0 bg-transparent px-3 shadow-none data-[state=on]:bg-background data-[state=on]:text-foreground data-[state=on]:shadow-[0_6px_14px_-10px_rgba(15,23,42,0.35)]"
+                    value="edit"
+                    aria-label="AI 写作编辑"
+                  >
+                    <SparklesIcon />
+                  </ToggleGroupItem>
+                )}
                 <ToggleGroupItem
                   className="text-muted-foreground h-8 min-w-10 rounded-full border-0 bg-transparent px-3 shadow-none data-[state=on]:bg-background data-[state=on]:text-foreground data-[state=on]:shadow-[0_6px_14px_-10px_rgba(15,23,42,0.35)]"
                   value="code"
@@ -633,10 +664,10 @@ export function ArtifactFileDetail({
                   <EyeIcon />
                 </ToggleGroupItem>
               </ToggleGroup>
-              {isHtmlStreaming && (
+              {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]">
+                <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" />
+                  <span className="bg-primary mr-2 size-1.5 animate-pulse rounded-full" />
-                  正在生成，完成后自动预览
+                  正在生成，完成后自动预览
                 </div>
               )}
             </div>
@@ -682,7 +713,7 @@ export function ArtifactFileDetail({
                 disabled={!content}
                 onClick={async () => {
                   try {
-                    await navigator.clipboard.writeText(displayContent ?? "");
+                    await copyTextToClipboard(displayContent ?? "");
                     toast.success(t.clipboard.copiedToClipboard);
                   } catch (error) {
                     toast.error("Failed to copy to clipboard");
@@ -692,7 +723,7 @@ export function ArtifactFileDetail({
                 tooltip={t.clipboard.copyToClipboard}
               />
             )}
-            {!useWriteFileStreaming && language === "markdown" && (
+            {language === "markdown" && (
               <ArtifactAction
                 icon={isExportingWord ? LoaderIcon : FileType2Icon}
                 label="另存为 Word"
@@ -780,6 +811,17 @@ export function ArtifactFileDetail({
             滑动到底部并继续自动下滑
           </button>
         )}
+        {viewMode === "edit" && canUseAiEditor && (
+          <MarkdownAiEditor
+            // 编辑用原始内容（与源码模式一致，不脱敏）；保存仍走头部「保存 Markdown」按钮。
+            markdown={displayContent ?? ""}
+            onChange={(value) => {
+              setDraftContent(value);
+              setHasLocalEdits(true);
+            }}
+            threadId={threadId}
+          />
+        )}
         {isSupportPreview &&
           viewMode === "preview" &&
           (language === "markdown" ||

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({
+export function ArtifactFileList({
-  className,
+  className,
-  files,
+  files,
-  threadId,
+  threadId,
-}: {
+  onOpenArtifact,
-  className?: string;
+}: {
-  files: string[];
+  className?: string;
-  threadId: 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(
+  const handleClick = useCallback(
-    (filepath: string) => {
+    (filepath: string) => {
-      selectArtifact(filepath);
+      if (onOpenArtifact) {
-      setOpen(true);
+        onOpenArtifact(filepath);
-    },
+        return;
-    [selectArtifact, setOpen],
+      }
-  );
+      selectArtifact(filepath);
+      setOpen(true);
+    },
+    [onOpenArtifact, selectArtifact, setOpen],
+  );
 
   const handleInstallSkill = useCallback(
     (e: React.MouseEvent, filepath: string) => {

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

@@ -423,6 +423,7 @@ const ChatBox: React.FC<{
                   className="size-full"
                   filepath={selectedArtifact}
                   threadId={threadId}
+                  allowVirtualMarkdownEdit
                 />
               </TabsContent>
               <TabsContent value="references" className="min-h-0 flex-1 overflow-y-auto p-0">
@@ -437,6 +438,7 @@ const ChatBox: React.FC<{
               className="size-full"
               filepath={selectedArtifact}
               threadId={threadId}
+              allowVirtualMarkdownEdit
             />
           ) : hasCitationReferences ? (
             <div className="relative size-full overflow-hidden">

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,6 +14,15 @@ 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(
@@ -16,30 +31,43 @@ export function CompactWelcome({ className }: { className?: string }) {
       )}
     >
       {/* 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:
-            "color-mix(in srgb, var(--workspace-brand) 5%, transparent)",
+            "rgb(var(--legacy-workspace-brand-rgb) / 5%)",
           border:
-            "1px solid color-mix(in srgb, var(--workspace-brand) 12%, transparent)",
+            "1px solid rgb(var(--legacy-workspace-brand-rgb) / 12%)",
         }}
       >
-        <div
+        {shouldShowWelcomeLogo && welcomeLogo ? (
-          className="flex size-14 items-center justify-center rounded-2xl shadow-md"
+          <img
-          style={{
+            src={welcomeLogo}
-            backgroundImage:
+            alt=""
-              "linear-gradient(to top right, var(--workspace-brand), color-mix(in srgb, var(--workspace-brand) 55%, white))",
+            aria-hidden="true"
-          }}
+            className="size-16 object-contain"
-        >
+            onError={() => setFailedWelcomeLogo(welcomeLogo)}
-          <span className="text-2xl font-black tracking-wide text-white italic">
+          />
-            CM
+        ) : (
-          </span>
+          <div
-        </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 gap-2 text-2xl font-bold tracking-tight text-foreground/90">
+      <h1 className="flex items-center justify-center text-2xl font-bold tracking-tight text-foreground/90">
-        <span className="text-2xl">👋</span> 欢迎使用CM助手
+        {desensitizeText("欢迎使用CM助手")}
       </h1>
       <p className="text-muted-foreground mx-auto mt-2 max-w-sm text-xs leading-relaxed">
         基于先进深度推理模型，为您提供高效的市场分析、专业报告撰写、调研设计与协同脑暴支持。

frontend-web/src/components/workspace/copy-button.tsx

@@ -1,8 +1,10 @@
-import { CheckIcon, CopyIcon } from "lucide-react";
+import { CheckIcon, CopyIcon } from "lucide-react";
-import { useCallback, useState, type ComponentProps } from "react";
+import { useCallback, useState, type ComponentProps } from "react";
-
+import { toast } from "sonner";
-import { Button } from "@/components/ui/button";
+
-import { useI18n } from "@/core/i18n/hooks";
+import { Button } from "@/components/ui/button";
+import { copyTextToClipboard } from "@/core/clipboard";
+import { useI18n } from "@/core/i18n/hooks";
 
 import { Tooltip } from "./tooltip";
 
@@ -12,14 +14,18 @@ export function CopyButton({
 }: ComponentProps<typeof Button> & {
   clipboardData: string;
 }) {
-  const { t } = useI18n();
+  const { t } = useI18n();
-  const [copied, setCopied] = useState(false);
+  const [copied, setCopied] = useState(false);
-  const handleCopy = useCallback(() => {
+  const handleCopy = useCallback(async () => {
-    void navigator.clipboard.writeText(clipboardData);
+    try {
-    setCopied(true);
+      await copyTextToClipboard(clipboardData);
-    setTimeout(() => setCopied(false), 2000);
+      setCopied(true);
-  }, [clipboardData]);
+      setTimeout(() => setCopied(false), 2000);
-  return (
+    } catch {
+      toast.error(t.clipboard.failedToCopyToClipboard);
+    }
+  }, [clipboardData, t.clipboard.failedToCopyToClipboard]);
+  return (
     <Tooltip content={t.clipboard.copyToClipboard}>
       <Button
         size="icon-sm"

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

@@ -318,9 +318,9 @@ export function GeneralQaSidebar() {
           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-[color-mix(in_srgb,var(--primary)_14%,transparent)] hover:bg-[color-mix(in_srgb,var(--primary)_24%,transparent)]",
+            "bg-[rgb(var(--legacy-primary-rgb)/14%)] hover:bg-[rgb(var(--legacy-primary-rgb)/24%)]",
           )}
         >
           <Plus className="size-4 stroke-[2.5]" />
@@ -342,40 +342,74 @@ 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}
                       type="button"
                       onClick={() => handleSelectAgent(agent.id)}
                       className={cn(
-                        "group relative flex w-full items-start gap-2.5 rounded-xl border px-2.5 py-2 text-left transition-colors",
+                        "group relative flex w-full items-start gap-3 rounded-xl border px-3 py-2.5 text-left transition-all duration-150",
                         isActive
-                          ? "border-primary/40 bg-primary/5"
+                          ? isDark
-                          : "border-transparent hover:border-border hover:bg-accent/50",
+                            ? "border-[#2b8ffe] bg-[#0b4fae]/65 shadow-[0_0_0_1px_rgba(43,143,254,0.5),0_12px_28px_rgba(37,128,255,0.25)]"
+                            : "agent-sidebar-card--active border-primary/50 bg-primary/10 shadow-sm"
+                          : isDark
+                            ? "border-[#2b8ffe]/20 bg-[#042b59]/35 hover:border-[#2b8ffe]/60 hover:bg-[#063b77]/60"
+                            : "border-transparent hover:border-border hover:bg-accent/50",
                       )}
                     >
                       <span
-                        className="mt-0.5 flex size-9 shrink-0 items-center justify-center rounded-lg text-white shadow-sm"
+                        className={cn(
-                        style={{ backgroundImage: `linear-gradient(135deg, ${from}, ${to})` }}
+                          "mt-0.5 flex size-10 shrink-0 items-center justify-center rounded-lg text-white shadow-sm",
+                          isDark &&
+                            isActive &&
+                            "ring-2 ring-[#83c1ff]/35 shadow-[0_0_18px_rgba(43,143,254,0.45)]",
+                        )}
+                        style={{
+                          backgroundImage: `linear-gradient(135deg, ${from}, ${to})`,
+                          color: foreground,
+                        }}
                       >
-                        <Bot className="size-[18px]" />
+                        <Bot className="size-[19px]" />
                       </span>
                       <span className="min-w-0 flex-1">
                         <span
                           className={cn(
-                            "block truncate text-[13px] font-semibold",
+                            "block truncate text-[16px] leading-5 font-bold",
-                            isActive ? "text-primary" : "text-foreground",
+                            isActive
+                              ? isDark
+                                ? "text-white"
+                                : "text-primary"
+                              : isDark
+                                ? "text-white/95"
+                                : "text-foreground",
                           )}
                         >
                           {desensitize(agent.name)}
                         </span>
-                        <span className="mt-0.5 block truncate text-[11px] leading-snug text-muted-foreground">
+                        <span
+                          className={cn(
+                            "mt-1 block truncate text-[13px] leading-[1.35]",
+                            isDark
+                              ? isActive
+                                ? "text-[#d6eaff]"
+                                : "text-[#9ebfe2]"
+                              : "text-muted-foreground",
+                          )}
+                        >
                           {agent.description ? desensitize(agent.description) : "智能体助手"}
                         </span>
                       </span>
                       {isActive && (
-                        <span className="absolute top-1/2 right-1 h-6 w-1 -translate-y-1/2 rounded-full bg-primary" />
+                        <span
+                          className={cn(
+                            "absolute top-1/2 right-1.5 h-8 w-1.5 -translate-y-1/2 rounded-full",
+                            isDark
+                              ? "bg-[#2b8ffe] shadow-[0_0_14px_rgba(43,143,254,0.85)]"
+                              : "bg-primary",
+                          )}
+                        />
                       )}
                     </button>
                   );
@@ -433,9 +467,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",
                           )}
                         >

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

@@ -613,7 +613,7 @@ export function InputBox({
             : "*:data-[slot='input-group']:rounded-3xl",
           // 紧凑落地态（CM 参考图）：白卡 + 细边 + 轻阴影 + 主色聚焦环（无旋转彩边）
           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-[color-mix(in_srgb,var(--primary)_35%,transparent)] focus-within:ring-4 focus-within:ring-[color-mix(in_srgb,var(--primary)_5%,transparent)] focus-within:shadow-[0_10px_35px_color-mix(in_srgb,var(--primary)_4%,transparent)] dark:border-slate-700 dark:bg-slate-800"
+            ? "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
@@ -680,18 +680,21 @@ export function InputBox({
               <PromptInputButton
                 className={cn(
                   "gap-1.5! rounded-full px-3! shadow-none",
-                  compact && "rounded-lg px-2.5! py-1! text-[11px] font-medium",
+                  compact && "rounded-lg px-2.5! py-1! text-[11px] font-medium",
-                  context.writing_mode
+                  context.writing_mode
-                    ? "border border-amber-300 bg-amber-50 text-amber-700 hover:bg-amber-100 dark:border-amber-700 dark:bg-amber-950/40 dark:text-amber-200"
+                    ? "border border-amber-300 bg-amber-50 text-amber-700 ring-1 ring-amber-300/35 hover:bg-amber-100 dark:border-amber-300/70 dark:bg-amber-400/20 dark:text-amber-100 dark:ring-amber-300/35 dark:shadow-[0_0_0_1px_rgba(251,191,36,0.18),0_0_18px_rgba(251,191,36,0.18)] dark:hover:bg-amber-400/25"
-                    : compact
+                    : compact
-                      ? "border border-transparent bg-muted/40 text-muted-foreground hover:bg-muted hover:text-foreground"
+                      ? "border border-transparent bg-muted/40 text-muted-foreground hover:bg-muted hover:text-foreground"
-                      : "border-0 bg-transparent text-muted-foreground hover:bg-muted/70 hover:text-foreground dark:text-slate-400 dark:hover:bg-slate-700/70 dark:hover:text-slate-100",
+                      : "border-0 bg-transparent text-muted-foreground hover:bg-muted/70 hover:text-foreground dark:text-slate-400 dark:hover:bg-slate-700/70 dark:hover:text-slate-100",
-                )}
+                )}
-                onClick={handleWritingModeToggle}
+                onClick={handleWritingModeToggle}
-              >
+              >
-                <FileTextIcon className="size-3" />
+                {context.writing_mode && (
-                <span className="text-xs font-normal">写作</span>
+                  <CheckIcon className="size-3 text-amber-700 dark:text-amber-100" />
-              </PromptInputButton>
+                )}
+                <FileTextIcon className="size-3" />
+                <span className="text-xs font-normal">写作</span>
+              </PromptInputButton>
             </Tooltip>
             <Tooltip
               content={
@@ -702,19 +705,22 @@ export function InputBox({
             >
               <PromptInputButton
                 className={cn(
-                  "gap-1.5! rounded-full px-3! shadow-none",
+                  "gap-1.5! rounded-full px-3! shadow-none",
-                  compact && "rounded-lg px-2.5! py-1! text-[11px] font-medium",
+                  compact && "rounded-lg px-2.5! py-1! text-[11px] font-medium",
-                  memoryInjectionEnabled
+                  memoryInjectionEnabled
-                    ? "border border-blue-300 bg-blue-50 text-blue-700 hover:bg-blue-100 dark:border-blue-700 dark:bg-blue-950/40 dark:text-blue-200"
+                    ? "border border-blue-300 bg-blue-50 text-blue-700 ring-1 ring-blue-300/35 hover:bg-blue-100 dark:border-cyan-300/70 dark:bg-cyan-400/20 dark:text-cyan-50 dark:ring-cyan-300/35 dark:shadow-[0_0_0_1px_rgba(34,211,238,0.18),0_0_18px_rgba(34,211,238,0.18)] dark:hover:bg-cyan-400/25"
-                    : compact
+                    : compact
-                      ? "border border-transparent bg-muted/40 text-muted-foreground hover:bg-muted hover:text-foreground"
+                      ? "border border-transparent bg-muted/40 text-muted-foreground hover:bg-muted hover:text-foreground"
-                      : "border-0 bg-transparent text-muted-foreground hover:bg-muted/70 hover:text-foreground dark:text-slate-400 dark:hover:bg-slate-700/70 dark:hover:text-slate-100",
+                      : "border-0 bg-transparent text-muted-foreground hover:bg-muted/70 hover:text-foreground dark:text-slate-400 dark:hover:bg-slate-700/70 dark:hover:text-slate-100",
-                )}
+                )}
-                onClick={handleMemoryInjectionToggle}
+                onClick={handleMemoryInjectionToggle}
-              >
+              >
-                <BrainCircuitIcon className="size-3" />
+                {memoryInjectionEnabled && (
-                <span className="text-xs font-normal">记忆</span>
+                  <CheckIcon className="size-3 text-blue-700 dark:text-cyan-50" />
-              </PromptInputButton>
+                )}
+                <BrainCircuitIcon className="size-3" />
+                <span className="text-xs font-normal">记忆</span>
+              </PromptInputButton>
             </Tooltip>
             <Tooltip
               content={
@@ -1166,7 +1172,7 @@ export function InputBox({
               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-7 rounded-lg border-0 bg-[var(--primary)] text-[var(--primary-foreground)] hover:bg-[color-mix(in_srgb,var(--primary)_88%,black)] disabled:bg-muted disabled:text-muted-foreground/40 dark:bg-[var(--primary)] dark:border-0 dark:text-[var(--primary-foreground)] dark:hover:bg-[color-mix(in_srgb,var(--primary)_88%,black)] dark:disabled:bg-muted",
+                  "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-list-item.tsx

@@ -135,11 +135,12 @@ export function MessageListItem({
   threadId,
   tokenUsageEnabled = false,
   displaySources = [],
-  extraRehypePlugins,
+  extraRehypePlugins,
-  onEditResubmit,
+  onEditResubmit,
-  onMessageDeleted,
+  onEditSave,
-  turnTime,
+  onMessageDeleted,
-}: {
+  turnTime,
+}: {
   className?: string;
   fitRowToContent?: boolean;
   /**
@@ -151,10 +152,11 @@ export function MessageListItem({
   isLoading?: boolean;
   threadId: string;
   tokenUsageEnabled?: boolean;
-  displaySources?: RuntimeDisplaySource[];
+  displaySources?: RuntimeDisplaySource[];
-  extraRehypePlugins?: ReturnType<typeof useRehypeSplitWordsIntoSpans>;
+  extraRehypePlugins?: ReturnType<typeof useRehypeSplitWordsIntoSpans>;
-  onEditResubmit?: (text: string) => void;
+  onEditResubmit?: (text: string) => void;
-  onMessageDeleted?: (deletedIds: 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 { t } = useI18n();
-  const messageMarkdown =
+  const isHuman = message.type === 'human';
-    extractContentFromMessage(message) ??
+  const messageMarkdown =
-    extractReasoningContentFromMessage(message) ??
+    extractContentFromMessage(message) ??
-    '';
+    extractReasoningContentFromMessage(message) ??
-  return (
+    '';
-    <AIElementMessage
+  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}
+        extraRehypePlugins={extraRehypePlugins}
-        onEditResubmit={onEditResubmit}
+        onEditResubmit={onEditResubmit}
-        onMessageDeleted={onMessageDeleted}
+        onEditSave={isLoading ? undefined : onEditSave}
-        turnTime={turnTime}
+        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 && (
+            {messageMarkdown && (
-              <DownloadWordButton
+              <DownloadWordButton
-                markdown={messageMarkdown}
+                markdown={messageMarkdown}
-                fileName="message"
+                fileName="message"
-              />
+              />
-            )}
+            )}
-          </div>
+            {canSaveAssistantEdit && (
-        </MessageToolbar>
+              <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({
+function HumanMessageBlock({
-  text,
+  messageId,
-  pageContext,
+  text,
-  filesList,
+  pageContext,
-  messageTime,
+  filesList,
-  components,
+  messageTime,
-  onEditResubmit,
+  components,
-  deleteButton,
+  onEditResubmit,
-}: {
+  onEditSave,
-  text: string;
+  deleteButton,
-  pageContext?: EmbeddedPageContext | null;
+}: {
-  filesList: React.ReactNode;
+  messageId?: string;
-  messageTime: { label: string; full: string } | null;
+  text: string;
-  components: MarkdownContentProps["components"];
+  pageContext?: EmbeddedPageContext | null;
-  onEditResubmit?: (text: string) => void;
+  filesList: React.ReactNode;
-  deleteButton?: React.ReactNode;
+  messageTime: { label: string; full: string } | null;
-}) {
+  components: MarkdownContentProps["components"];
-  const { t } = useI18n();
+  onEditResubmit?: (text: string) => void;
-  const [editing, setEditing] = useState(false);
+  onEditSave?: (messageId: string, text: string) => void | Promise<void>;
-  const [draft, setDraft] = useState(text);
+  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 confirmEdit = useCallback(async () => {
-    const value = draft.trim();
+    const value = draft.trim();
-    if (!value) {
+    if (!value || saving) {
-      return;
+      return;
-    }
+    }
-    onEditResubmit?.(value);
+    if (onEditSave && messageId && !messageId.startsWith("opt-")) {
-    setEditing(false);
+      setSaving(true);
-  }, [draft, onEditResubmit]);
+      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();
+              void confirmEdit();
-            }
+            }
-            if (event.key === "Escape") {
+            if (event.key === "Escape") {
-              event.preventDefault();
+              event.preventDefault();
               setEditing(false);
             }
           }}
@@ -286,17 +408,22 @@ function HumanMessageBlock({
         />
         <div className="flex items-center justify-end gap-2">
           <Button
-            size="sm"
+            size="sm"
-            variant="ghost"
+            variant="ghost"
-            onClick={() => setEditing(false)}
+            disabled={saving}
-          >
+            onClick={() => setEditing(false)}
-            {t.common.cancel}
+          >
-          </Button>
+            {t.common.cancel}
-          <Button size="sm" onClick={confirmEdit} disabled={!draft.trim()}>
+          </Button>
-            {t.common.confirm}
+          <Button
-          </Button>
+            size="sm"
-        </div>
+            onClick={() => void confirmEdit()}
-      </div>
+            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 && (
+          {text && (onEditResubmit || onEditSave) && (
-            <Tooltip content={t.inputBox.editQuestion}>
+            <Tooltip content={onEditSave ? "编辑消息" : t.inputBox.editQuestion}>
-              <Button
+              <Button
-                size="icon-sm"
+                size="icon-sm"
-                type="button"
+                type="button"
                 variant="ghost"
                 className="size-6"
                 onClick={() => setEditing(true)}
@@ -396,22 +523,24 @@ function MessageContent_({
   threadId,
   tokenUsageEnabled = false,
   displaySources = [],
-  extraRehypePlugins,
+  extraRehypePlugins,
-  onEditResubmit,
+  onEditResubmit,
-  onMessageDeleted,
+  onEditSave,
-  turnTime,
+  onMessageDeleted,
-}: {
+  turnTime,
+}: {
   className?: string;
   message: Message;
   isLoading?: boolean;
   threadId: string;
   tokenUsageEnabled?: boolean;
-  displaySources?: RuntimeDisplaySource[];
+  displaySources?: RuntimeDisplaySource[];
-  extraRehypePlugins?: ReturnType<typeof useRehypeSplitWordsIntoSpans>;
+  extraRehypePlugins?: ReturnType<typeof useRehypeSplitWordsIntoSpans>;
-  onEditResubmit?: (text: string) => void;
+  onEditResubmit?: (text: string) => void;
-  onMessageDeleted?: (deletedIds: string[]) => void;
+  onEditSave?: (messageId: string, text: string) => void | Promise<void>;
-  turnTime?: string;
+  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
+      <HumanMessageBlock
-        text={parsedHumanContent.content}
+        messageId={message.id}
-        pageContext={parsedHumanContent.pageContext}
+        text={parsedHumanContent.content}
-        filesList={filesList}
+        pageContext={parsedHumanContent.pageContext}
-        messageTime={messageTime}
+        filesList={filesList}
-        components={components}
+        messageTime={messageTime}
-        onEditResubmit={onEditResubmit}
+        components={components}
-        deleteButton={
+        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,
+  onClarificationSubmit,
-  onEditResubmit,
+  onEditResubmit,
-  onSetupAgentApprove,
+  onEditSave,
-  onSetupAgentReject,
+  messageContentOverrides,
-  onSetupWritingApprove,
+  externallyHiddenMessageIds,
-  onSetupWritingReject,
+  onSetupAgentApprove,
-  onSetupWritingStart,
+  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>;
+  onClarificationSubmit?: (answer: string) => void | Promise<void>;
-  onEditResubmit?: (text: string) => void;
+  onEditResubmit?: (text: string) => void;
-  onSetupAgentApprove?: (payload: SetupAgentApprovalPayload) => void | Promise<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>;
+  onSetupWritingApprove?: (payload: SetupWritingApprovalPayload) => void | Promise<void>;
-  onSetupWritingReject?: (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(
+  const allMessages = useMemo(() => {
-    () => thread.messages.filter((m) => !isHiddenFromUIMessage(m)),
+    const hasOverrides = messageContentOverrides && Object.keys(messageContentOverrides).length > 0;
-    [thread.messages],
+    return thread.messages
-  );
+      .filter((m) => !isHiddenFromUIMessage(m))
-  const messages = useMemo(
+      .map((message) => {
-    () =>
+        const override =
-      hiddenMessageIds.size === 0
+          hasOverrides && message.id
-        ? allMessages
+            ? messageContentOverrides?.[message.id]
-        : allMessages.filter((m) => !m.id || !hiddenMessageIds.has(m.id)),
+            : undefined;
-    [allMessages, hiddenMessageIds],
+        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}
+                  extraRehypePlugins={extraRehypePlugins}
-                  onEditResubmit={onEditResubmit}
+                  onEditResubmit={onEditResubmit}
-                  onMessageDeleted={
+                  onEditSave={onEditSave}
-                    allowDelete ? handleMessageDeleted : undefined
+                  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/recent-roundtable-list.tsx

@@ -112,7 +112,7 @@ export function RecentRoundtableList() {
     }
     try {
       await rename(id, title);
-      toast.success("✏️ 已重命名");
+      toast.success("已重命名");
     } catch {
       toast.error("重命名失败，请重试");
     } finally {
@@ -126,7 +126,7 @@ export function RecentRoundtableList() {
       if (!window.confirm("确定删除这条会商记录吗？此操作不可恢复。")) return;
       try {
         await remove(draft.id);
-        toast.success("🗑 已删除会商记录");
+        toast.success("已删除会商记录");
       } catch {
         toast.error("删除失败，请重试");
       }

frontend-web/src/components/workspace/settings/about-content.ts

@@ -8,7 +8,7 @@ CM Assistant is an internal super-agent platform that orchestrates sub-agents, m
 
 ---
 
-## 🚀 Core Features
+## Core Features
 
 * **Skills & Tools**: With built-in and extensible skills and tools, CM Assistant can do almost anything.
 * **Sub-Agents**: Sub-Agents help the main agent to do the tasks that are too complex to be done by the main agent.

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

@@ -1,12 +1,12 @@
 "use client";
 
-import { useMemo } from "react";
 import { CopyIcon, LogOutIcon, UserIcon } from "lucide-react";
 import { toast } from "sonner";
 
 import { Badge } from "@/components/ui/badge";
 import { Button } from "@/components/ui/button";
 import { clearStoredAuth, getAccountDisplayName, getStoredAuth } from "@/core/auth";
+import { useLiveAccount } from "@/core/auth/use-live-account";
 import { OptType, writeYLog } from "@/core/log/y-log";
 import { clearYLogToken } from "@/core/log/y-log-token";
 
@@ -27,7 +27,10 @@ function copy(text: string, hint = "已复制") {
 }
 
 export function AccountSettingsPage() {
-  const auth = useMemo(() => getStoredAuth(), []);
+  // Subscribe to same-tab and cross-tab auth changes. The dialog may stay open
+  // while the active account is switched elsewhere.
+  useLiveAccount();
+  const auth = getStoredAuth();
 
   if (!auth) {
     return (

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

@@ -0,0 +1,753 @@
+"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: "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)] bg-[var(--background)] px-3 py-2">
+        <span
+          className="flex size-5 items-center justify-center rounded-md bg-[var(--primary)] text-[10px] font-bold text-[var(--primary-foreground)] ring-2 ring-[var(--ring)]"
+          aria-hidden
+        >
+          C
+        </span>
+        <span className="text-xs font-semibold text-[var(--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/skill-display-sources.tsx

@@ -1,4 +1,4 @@
-import { ExternalLinkIcon } from "lucide-react";
+import { ExternalLinkIcon, FileTextIcon, LoaderCircle } from "lucide-react";
 
 import { Button } from "@/components/ui/button";
 import {
@@ -9,10 +9,12 @@ import {
   DialogTitle,
 } from "@/components/ui/dialog";
 import type { RuntimeDisplaySource } from "@/core/skill-display/runtime";
+import { apiFetch } from "@/core/api/fetch-client";
+import { getBackendBaseURL } from "@/core/config";
 import { useLocalSettings } from "@/core/settings";
 import { useCitationDisplaySettings } from "@/core/system-settings/hooks";
 import { cn } from "@/lib/utils";
-import { useState } from "react";
+import { useEffect, useState } from "react";
 
 export function SkillDisplaySources({
   highlightedReferenceId,
@@ -51,6 +53,9 @@ export function SourceCard({
   referenceTarget?: boolean;
 }) {
   const [open, setOpen] = useState(false);
+  const [context, setContext] = useState<WeKnoraSourceContext | null>(null);
+  const [contextLoading, setContextLoading] = useState(false);
+  const [contextError, setContextError] = useState<string | null>(null);
   const [settings] = useLocalSettings();
   const { data: citationDisplay } = useCitationDisplaySettings();
   const cleanupWords =
@@ -73,6 +78,44 @@ export function SourceCard({
   ].filter(Boolean);
   const isCitation = source.mode === "citation";
   const showReferenceNumber = isCitation;
+  const previewTarget = parseWeKnoraPreviewUrl(source.url);
+
+  useEffect(() => {
+    if (!open || !previewTarget) {
+      return;
+    }
+    let cancelled = false;
+    setContext(null);
+    setContextError(null);
+    setContextLoading(true);
+    const params = new URLSearchParams({
+      knowledge_base_id: previewTarget.knowledgeBaseId,
+      chunk_id: previewTarget.chunkId,
+    });
+    void apiFetch(`${getBackendBaseURL()}/api/weknora/source-context?${params}`)
+      .then(async (response) => {
+        const payload = (await response.json().catch(() => null)) as unknown;
+        if (!response.ok || !isWeKnoraSourceContextResponse(payload)) {
+          throw new Error(readPreviewError(payload, response.status));
+        }
+        if (!cancelled) {
+          setContext(payload.data);
+        }
+      })
+      .catch((error: unknown) => {
+        if (!cancelled) {
+          setContextError(error instanceof Error ? error.message : "无法加载原文上下文");
+        }
+      })
+      .finally(() => {
+        if (!cancelled) {
+          setContextLoading(false);
+        }
+      });
+    return () => {
+      cancelled = true;
+    };
+  }, [open, previewTarget?.chunkId, previewTarget?.knowledgeBaseId]);
 
   return (
     <>
@@ -114,7 +157,14 @@ export function SourceCard({
             )}
           </div>
           {source.url && (
-            <ExternalLinkIcon className="text-muted-foreground/60 group-hover:text-primary mt-1 size-3.5 shrink-0 transition-colors" />
+            previewTarget ? (
+              <span className="text-primary bg-primary/10 mt-0.5 inline-flex shrink-0 items-center gap-1 rounded-md px-1.5 py-1 text-[11px] font-medium">
+                <FileTextIcon className="size-3.5" />
+                查看原文
+              </span>
+            ) : (
+              <ExternalLinkIcon className="text-muted-foreground/60 group-hover:text-primary mt-1 size-3.5 shrink-0 transition-colors" />
+            )
           )}
         </div>
       </button>
@@ -141,7 +191,7 @@ export function SourceCard({
                   </DialogDescription>
                 )}
               </div>
-              {source.url && (
+              {source.url && !previewTarget && (
                 <Button size="icon-sm" variant="outline" asChild>
                   <a
                     href={source.url}
@@ -155,7 +205,13 @@ export function SourceCard({
               )}
             </div>
           </DialogHeader>
-          {paragraphs.length > 0 && (
+          {previewTarget ? (
+            <WeKnoraSourceContextPanel
+              context={context}
+              loading={contextLoading}
+              error={contextError}
+            />
+          ) : paragraphs.length > 0 ? (
             <div className="text-foreground max-h-[55vh] space-y-3 overflow-y-auto text-sm leading-relaxed">
               {paragraphs.map((paragraph, index) => (
                 <p key={index} className="whitespace-pre-wrap">
@@ -163,8 +219,8 @@ export function SourceCard({
                 </p>
               ))}
             </div>
-          )}
+          ) : null}
-          {source.url && (
+          {source.url && !previewTarget && (
             <div className="text-muted-foreground border-t pt-3 text-xs break-all">
               {source.url}
             </div>
@@ -175,6 +231,118 @@ export function SourceCard({
   );
 }
 
+type WeKnoraPreviewTarget = {
+  knowledgeBaseId: string;
+  chunkId: string;
+};
+
+type WeKnoraSourceContext = {
+  knowledge_base_name?: string;
+  document_title?: string;
+  document_file_name?: string;
+  focus_chunk_id: string;
+  chunks: Array<{
+    id: string;
+    chunk_index?: number;
+    content: string;
+    is_focus: boolean;
+  }>;
+};
+
+function parseWeKnoraPreviewUrl(url?: string): WeKnoraPreviewTarget | null {
+  if (!url?.startsWith("/weknora-source-preview?")) {
+    return null;
+  }
+  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;
+}
+
+function isWeKnoraSourceContextResponse(
+  value: unknown,
+): value is { success: true; data: WeKnoraSourceContext } {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  const data = (value as { data?: unknown }).data;
+  return (
+    (value as { success?: unknown }).success === true &&
+    !!data &&
+    typeof data === "object" &&
+    Array.isArray((data as WeKnoraSourceContext).chunks)
+  );
+}
+
+function readPreviewError(payload: unknown, status: number): string {
+  if (payload && typeof payload === "object") {
+    const detail = (payload as { detail?: unknown }).detail;
+    if (typeof detail === "string" && detail) {
+      return detail;
+    }
+  }
+  return status === 404 ? "原文已不可用" : "无法加载原文上下文";
+}
+
+function WeKnoraSourceContextPanel({
+  context,
+  loading,
+  error,
+}: {
+  context: WeKnoraSourceContext | null;
+  loading: boolean;
+  error: string | null;
+}) {
+  if (loading) {
+    return (
+      <div className="text-muted-foreground flex min-h-36 items-center justify-center gap-2 text-sm">
+        <LoaderCircle className="size-4 animate-spin" />
+        正在加载原文上下文…
+      </div>
+    );
+  }
+  if (error) {
+    return (
+      <div className="border-destructive/30 bg-destructive/5 text-destructive rounded-lg border p-3 text-sm">
+        {error}
+      </div>
+    );
+  }
+  if (!context) {
+    return null;
+  }
+  return (
+    <div className="max-h-[55vh] space-y-3 overflow-y-auto pr-1">
+      <div className="bg-muted/60 text-muted-foreground rounded-lg px-3 py-2 text-xs">
+        <span>{context.knowledge_base_name || "WeKnora 知识库"}</span>
+        {context.document_title && <span> · {context.document_title}</span>}
+      </div>
+      {context.chunks.map((chunk) => (
+        <section
+          key={chunk.id}
+          className={cn(
+            "rounded-lg border p-3 text-sm leading-relaxed",
+            chunk.is_focus
+              ? "border-primary/50 bg-primary/5 shadow-sm"
+              : "bg-muted/20",
+          )}
+        >
+          <div className="text-muted-foreground mb-2 flex items-center gap-2 text-xs">
+            <span>分段 {typeof chunk.chunk_index === "number" ? chunk.chunk_index + 1 : "-"}</span>
+            {chunk.is_focus && (
+              <span className="bg-primary text-primary-foreground rounded px-1.5 py-0.5 font-medium">
+                检索命中
+              </span>
+            )}
+          </div>
+          <p className="whitespace-pre-wrap">{chunk.content}</p>
+        </section>
+      ))}
+    </div>
+  );
+}
+
 function cleanReferenceText(
   raw: string | undefined,
   cleanupWords: string[],

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

@@ -1,35 +1,28 @@
 "use client";
 
 import { User } from "lucide-react";
-import { useMemo } from "react";
 
-import { getStoredAuth } from "@/core/auth";
+import { useLiveAccount } from "@/core/auth/use-live-account";
 import { useMyPosition } from "@/core/positions";
 import { cn } from "@/lib/utils";
-import { readUserInfo } from "@/strategy-components/lib/light-app";
 
 /**
  * 名称 + 岗位 用户标识。全量模式由 strategy-components/Header.tsx 顶栏右侧展示；
  * 紧凑模式（不带全局顶栏）无处承载，故抽成共享组件，复用同一套数据来源
- * （`readUserInfo().userName` 优先、回退 auth 邮箱前缀；岗位取 `useMyPosition`），
+ * （实时 auth 展示名；岗位取 `useMyPosition`），
  * 供页面级顶栏（如 ChatPage）右侧复用，保证两套布局一致。
  *
  * 配色按当前内容区前景色（foreground / muted-foreground），适配聊天页浅底顶栏，
  * 而非 Header 的白字贴 banner 方案。
  */
 export function UserIdentityBadge({ className }: { className?: string }) {
-  const auth = getStoredAuth();
+  // 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.
+  const liveAccount = useLiveAccount();
   const { data: myPosition } = useMyPosition();
   const positionName = myPosition?.name?.trim() || "";
-
+  const displayName = liveAccount.displayName;
-  // 与 Header.tsx 一致：外部登录写入的真实用户名优先，缺省回退邮箱前缀。
-  const displayName = useMemo(() => {
-    const info = readUserInfo();
-    const name = typeof info.userName === "string" ? info.userName.trim() : "";
-    if (name) return name;
-    const email = auth?.email?.trim();
-    return email ? email.split("@")[0] : "用户";
-  }, [auth?.email]);
 
   return (
     <div

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

@@ -1,23 +1,23 @@
 "use client";
 
 import { useSearchParams } from "next/navigation";
-import { useEffect, useMemo } from "react";
+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";
 
-let waved = false;
+export function Welcome({
-
-export function Welcome({
   className,
   mode,
 }: {
   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(() => {
@@ -26,10 +26,7 @@ export function Welcome({
     }
     return ["var(--color-foreground)"];
   }, [isUltra]);
-  useEffect(() => {
+  return (
-    waved = true;
-  }, []);
-  return (
     <div
       className={cn(
         "mx-auto flex w-full flex-col items-center justify-center gap-2 px-8 py-4 text-center",
@@ -37,15 +34,12 @@ export function Welcome({
       )}
     >
       <div className="text-[26px] font-medium tracking-tight text-foreground/85">
-        {searchParams.get("mode") === "skill" ? (
+        {searchParams.get("mode") === "skill" ? (
-          `✨ ${t.welcome.createYourOwnSkill} ✨`
+          t.welcome.createYourOwnSkill
-        ) : (
+        ) : (
-          <div className="flex items-center gap-2.5">
+          <div className="flex items-center">
-            <div className={cn("inline-block text-2xl", !waved ? "animate-wave" : "")}>
+            <AuroraText colors={colors}>{desensitizeText(t.welcome.greeting)}</AuroraText>
-              {isUltra ? "🚀" : "👋"}
+          </div>
-            </div>
-            <AuroraText colors={colors}>{t.welcome.greeting}</AuroraText>
-          </div>
         )}
       </div>
       {searchParams.get("mode") === "skill" ? (

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

@@ -1,8 +1,8 @@
 "use client";
 
-import Link from "next/link";
+import Link from "next/link";
-import { usePathname } from "next/navigation";
+import { usePathname } from "next/navigation";
-import { useMemo } from "react";
+import { type ReactNode, useMemo } from "react";
 
 import {
   Breadcrumb,
@@ -30,11 +30,14 @@ export function WorkspaceContainer({
   );
 }
 
-export function WorkspaceHeader({
+export function WorkspaceHeader({
-  className,
+  className,
-  children,
+  children,
-  ...props
+  rightActions,
-}: React.ComponentProps<"header">) {
+  ...props
+}: React.ComponentProps<"header"> & {
+  rightActions?: ReactNode;
+}) {
   const { t } = useI18n();
   const pathname = usePathname();
   const segments = useMemo(() => {
@@ -51,8 +54,8 @@ export function WorkspaceHeader({
       )}
       {...props}
     >
-      <div className="flex items-center gap-2 px-4">
+      <div className="flex items-center gap-2 px-4">
-        <Breadcrumb>
+        <Breadcrumb>
           <BreadcrumbList>
             {segments?.[0] && (
               <BreadcrumbItem className="hidden md:block">
@@ -88,11 +91,14 @@ export function WorkspaceHeader({
               </>
             )}
           </BreadcrumbList>
-        </Breadcrumb>
+        </Breadcrumb>
-      </div>
+      </div>
-    </header>
+      {rightActions ? (
-  );
+        <div className="flex items-center gap-2 px-4">{rightActions}</div>
-}
+      ) : null}
+    </header>
+  );
+}
 
 export function WorkspaceBody({
   className,

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,21 +23,21 @@ 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-[color-mix(in_srgb,var(--primary)_18%,transparent)] " +
+  "border border-[rgb(var(--legacy-primary-rgb)/18%)] " +
-  "hover:bg-[color-mix(in_srgb,var(--primary)_4%,transparent)] hover:text-[var(--primary)] hover:border-[color-mix(in_srgb,var(--primary)_32%,transparent)] " +
+  "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";
 
 export function WorkspaceNavChatList({
@@ -184,6 +184,18 @@ 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>
             <SidebarMenuItem>
               <SidebarMenuButton
                 isActive={pathname === "/page/workspace/scheduled/tasks"}

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

@@ -1,277 +1,276 @@
-"use client";
+"use client";
-
+
-import {
+import {
-  BellIcon,
+  BellIcon,
-  BotIcon,
+  BotIcon,
-  BrainIcon,
+  BrainIcon,
-  BriefcaseIcon,
+  BriefcaseIcon,
-  CalendarClockIcon,
+  CalendarClockIcon,
-  ChevronsUpDown,
+  ChevronsUpDown,
-  DatabaseZapIcon,
+  DatabaseZapIcon,
-  GaugeIcon,
+  GaugeIcon,
-  HistoryIcon,
+  HistoryIcon,
-  MessageCircleQuestionIcon,
+  MessageCircleQuestionIcon,
-  PlugIcon,
+  ScrollTextIcon,
-  ScrollTextIcon,
+  Settings2Icon,
-  Settings2Icon,
+  SettingsIcon,
-  SettingsIcon,
+  SparklesIcon,
-  SparklesIcon,
+  TagsIcon,
-  TagsIcon,
+  TrophyIcon,
-  TrophyIcon,
+} from "lucide-react";
-} from "lucide-react";
+import { useEffect, useState } from "react";
-import { useEffect, useState } from "react";
+
-
+import {
-import {
+  DropdownMenu,
-  DropdownMenu,
+  DropdownMenuContent,
-  DropdownMenuContent,
+  DropdownMenuGroup,
-  DropdownMenuGroup,
+  DropdownMenuItem,
-  DropdownMenuItem,
+  DropdownMenuSeparator,
-  DropdownMenuSeparator,
+  DropdownMenuTrigger,
-  DropdownMenuTrigger,
+} from "@/components/ui/dropdown-menu";
-} from "@/components/ui/dropdown-menu";
+import {
-import {
+  SidebarMenu,
-  SidebarMenu,
+  SidebarMenuButton,
-  SidebarMenuButton,
+  SidebarMenuItem,
-  SidebarMenuItem,
+  useSidebar,
-  useSidebar,
+} from "@/components/ui/sidebar";
-} from "@/components/ui/sidebar";
+import { getStoredAuth } from "@/core/auth";
-import { getStoredAuth } from "@/core/auth";
+import { useI18n } from "@/core/i18n/hooks";
-import { useI18n } from "@/core/i18n/hooks";
+import { useUnreadCount } from "@/core/notifications";
-import { useUnreadCount } from "@/core/notifications";
+import {
-import {
+  loadLogSystemSettings,
-  loadLogSystemSettings,
+  type LogSystemSettings,
-  type LogSystemSettings,
+} from "@/core/system-settings/api";
-} from "@/core/system-settings/api";
+
-
+import { NotificationDialog } from "./notification-dialog";
-import { NotificationDialog } from "./notification-dialog";
+import { useNavigate } from "react-router-dom";
-import { useNavigate } from "react-router-dom";
+
-
+import { SettingsDialog } from "./settings";
-import { SettingsDialog } from "./settings";
+
-
+function NavMenuButtonContent({
-function NavMenuButtonContent({
+  isSidebarOpen,
-  isSidebarOpen,
+  t,
-  t,
+}: {
-}: {
+  isSidebarOpen: boolean;
-  isSidebarOpen: boolean;
+  t: ReturnType<typeof useI18n>["t"];
-  t: ReturnType<typeof useI18n>["t"];
+}) {
-}) {
+  return isSidebarOpen ? (
-  return isSidebarOpen ? (
+    <div className="text-sidebar-foreground/85 flex w-full items-center gap-2 text-left text-sm">
-    <div className="text-sidebar-foreground/85 flex w-full items-center gap-2 text-left text-sm">
+      <SettingsIcon className="size-4" />
-      <SettingsIcon className="size-4" />
+      <span>{t.workspace.settingsAndMore}</span>
-      <span>{t.workspace.settingsAndMore}</span>
+      <ChevronsUpDown className="text-sidebar-foreground/55 ml-auto size-4" />
-      <ChevronsUpDown className="text-sidebar-foreground/55 ml-auto size-4" />
+    </div>
-    </div>
+  ) : (
-  ) : (
+    <div className="flex size-full items-center justify-center">
-    <div className="flex size-full items-center justify-center">
+      <SettingsIcon className="text-sidebar-foreground/80 size-4" />
-      <SettingsIcon className="text-sidebar-foreground/80 size-4" />
+    </div>
-    </div>
+  );
-  );
+}
-}
+
-
+export function WorkspaceNavMenu() {
-export function WorkspaceNavMenu() {
+  const navigate = useNavigate();
-  const navigate = useNavigate();
+  const isAdmin = getStoredAuth()?.system_role === "admin";
-  const isAdmin = getStoredAuth()?.system_role === "admin";
+  const [settingsOpen, setSettingsOpen] = useState(false);
-  const [settingsOpen, setSettingsOpen] = useState(false);
+  const [settingsDefaultSection, setSettingsDefaultSection] = useState<
-  const [settingsDefaultSection, setSettingsDefaultSection] = useState<
+    "appearance" | "memory" | "tools" | "about"
-    "appearance" | "memory" | "tools" | "about"
+  >("appearance");
-  >("appearance");
+  const [notificationOpen, setNotificationOpen] = useState(false);
-  const [notificationOpen, setNotificationOpen] = useState(false);
+  const [mounted, setMounted] = useState(false);
-  const [mounted, setMounted] = useState(false);
+  const [logSystem, setLogSystem] = useState<LogSystemSettings | null>(null);
-  const [logSystem, setLogSystem] = useState<LogSystemSettings | null>(null);
+  const { open: isSidebarOpen } = useSidebar();
-  const { open: isSidebarOpen } = useSidebar();
+  const { t } = useI18n();
-  const { t } = useI18n();
+  const { data: unreadCount = 0 } = useUnreadCount();
-  const { data: unreadCount = 0 } = useUnreadCount();
+
-
+  useEffect(() => {
-  useEffect(() => {
+    setMounted(true);
-    setMounted(true);
+  }, []);
-  }, []);
+
-
+  useEffect(() => {
-  useEffect(() => {
+    if (!isAdmin) return;
-    if (!isAdmin) return;
+    let cancelled = false;
-    let cancelled = false;
+    loadLogSystemSettings()
-    loadLogSystemSettings()
+      .then((settings) => {
-      .then((settings) => {
+        if (!cancelled) setLogSystem(settings);
-        if (!cancelled) setLogSystem(settings);
+      })
-      })
+      .catch(() => {
-      .catch(() => {
+        if (!cancelled) setLogSystem(null);
-        if (!cancelled) setLogSystem(null);
+      });
-      });
+    return () => {
-    return () => {
+      cancelled = true;
-      cancelled = true;
+    };
-    };
+  }, [isAdmin]);
-  }, [isAdmin]);
+
-
+  return (
-  return (
+    <>
-    <>
+      <SettingsDialog
-      <SettingsDialog
+        open={settingsOpen}
-        open={settingsOpen}
+        onOpenChange={setSettingsOpen}
-        onOpenChange={setSettingsOpen}
+        defaultSection={settingsDefaultSection}
-        defaultSection={settingsDefaultSection}
+      />
-      />
+      <NotificationDialog
-      <NotificationDialog
+        open={notificationOpen}
-        open={notificationOpen}
+        onOpenChange={setNotificationOpen}
-        onOpenChange={setNotificationOpen}
+      />
-      />
+      <SidebarMenu className="w-full">
-      <SidebarMenu className="w-full">
+        <SidebarMenuItem>
-        <SidebarMenuItem>
+          {mounted ? (
-          {mounted ? (
+            <DropdownMenu>
-            <DropdownMenu>
+              <DropdownMenuTrigger asChild>
-              <DropdownMenuTrigger asChild>
+                <SidebarMenuButton
-                <SidebarMenuButton
+                  size="lg"
-                  size="lg"
+                  className="data-[state=open]:bg-sidebar-accent data-[state=open]:text-sidebar-accent-foreground"
-                  className="data-[state=open]:bg-sidebar-accent data-[state=open]:text-sidebar-accent-foreground"
+                >
-                >
+                  <NavMenuButtonContent isSidebarOpen={isSidebarOpen} t={t} />
-                  <NavMenuButtonContent isSidebarOpen={isSidebarOpen} t={t} />
+                </SidebarMenuButton>
-                </SidebarMenuButton>
+              </DropdownMenuTrigger>
-              </DropdownMenuTrigger>
+              <DropdownMenuContent
-              <DropdownMenuContent
+                className="w-(--radix-dropdown-menu-trigger-width) min-w-56 rounded-lg"
-                className="w-(--radix-dropdown-menu-trigger-width) min-w-56 rounded-lg"
+                align="end"
-                align="end"
+                sideOffset={4}
-                sideOffset={4}
+              >
-              >
+                <DropdownMenuGroup>
-                <DropdownMenuGroup>
+                  <DropdownMenuItem onClick={() => setNotificationOpen(true)}>
-                  <DropdownMenuItem onClick={() => setNotificationOpen(true)}>
+                    <BellIcon />
-                    <BellIcon />
+                    {t.notifications.title}
-                    {t.notifications.title}
+                    {unreadCount > 0 && (
-                    {unreadCount > 0 && (
+                      <span className="ml-auto flex h-4 min-w-4 items-center justify-center rounded-full bg-red-500 px-1 text-[10px] font-medium leading-none text-white">
-                      <span className="ml-auto flex h-4 min-w-4 items-center justify-center rounded-full bg-red-500 px-1 text-[10px] font-medium leading-none text-white">
+                        {unreadCount > 99 ? "99+" : unreadCount}
-                        {unreadCount > 99 ? "99+" : unreadCount}
+                      </span>
-                      </span>
+                    )}
-                    )}
+                  </DropdownMenuItem>
-                  </DropdownMenuItem>
+                  <DropdownMenuItem
-                  <DropdownMenuItem
+                    onClick={() => {
-                    onClick={() => {
+                      setSettingsDefaultSection("appearance");
-                      setSettingsDefaultSection("appearance");
+                      setSettingsOpen(true);
-                      setSettingsOpen(true);
+                    }}
-                    }}
+                  >
-                  >
+                    <Settings2Icon />
-                    <Settings2Icon />
+                    {t.common.settings}
-                    {t.common.settings}
+                  </DropdownMenuItem>
-                  </DropdownMenuItem>
+                  {isAdmin && (
-                  {isAdmin && (
+                    <DropdownMenuItem
-                    <DropdownMenuItem
+                      onClick={() =>
-                      onClick={() =>
+                        navigate("/page/workspace/settings/llm-metrics")
-                        navigate("/page/workspace/settings/llm-metrics")
+                      }
-                      }
+                    >
-                    >
+                      <GaugeIcon />
-                      <GaugeIcon />
+                      大模型调用统计
-                      大模型调用统计
+                    </DropdownMenuItem>
-                    </DropdownMenuItem>
+                  )}
-                  )}
+                  {isAdmin && (
-                  {isAdmin && (
+                    <DropdownMenuItem
-                    <DropdownMenuItem
+                      onClick={() =>
-                      onClick={() =>
+                        navigate("/page/workspace/settings/checkpoint-migration")
-                        navigate("/page/workspace/settings/checkpoint-migration")
+                      }
-                      }
+                    >
-                    >
+                      <DatabaseZapIcon />
-                      <DatabaseZapIcon />
+                      Checkpoint 迁移
-                      Checkpoint 迁移
+                    </DropdownMenuItem>
-                    </DropdownMenuItem>
+                  )}
-                  )}
+                  {isAdmin ? (
-                  {isAdmin ? (
+                    <DropdownMenuItem
-                    <DropdownMenuItem
+                      onClick={() =>
-                      onClick={() =>
+                        navigate("/page/strategy/admin/user-leaderboard")
-                        navigate("/page/strategy/admin/user-leaderboard")
+                      }
-                      }
+                    >
-                    >
+                      <TrophyIcon />
-                      <TrophyIcon />
+                      用户排行榜
-                      用户排行榜
+                    </DropdownMenuItem>
-                    </DropdownMenuItem>
+                  ) : (
-                  ) : (
+                    <DropdownMenuItem
-                    <DropdownMenuItem
+                      onClick={() =>
-                      onClick={() =>
+                        navigate("/page/strategy/user-leaderboard")
-                        navigate("/page/strategy/user-leaderboard")
+                      }
-                      }
+                    >
-                    >
+                      <TrophyIcon />
-                      <TrophyIcon />
+                      用户排行榜
-                      用户排行榜
+                    </DropdownMenuItem>
-                    </DropdownMenuItem>
+                  )}
-                  )}
+                  {isAdmin && (
-                  {isAdmin && (
+                    <DropdownMenuItem
-                    <DropdownMenuItem
+                      onClick={() =>
-                      onClick={() =>
+                        navigate("/page/workspace/admin/scheduled-tasks")
-                        navigate("/page/workspace/admin/scheduled-tasks")
+                      }
-                      }
+                    >
-                    >
+                      <CalendarClockIcon />
-                      <CalendarClockIcon />
+                      定时任务管理
-                      定时任务管理
+                    </DropdownMenuItem>
-                    </DropdownMenuItem>
+                  )}
-                  )}
+                  {isAdmin && (
-                  {isAdmin && (
+                    <DropdownMenuItem
-                    <DropdownMenuItem
+                      onClick={() => navigate("/page/workspace/admin/agents")}
-                      onClick={() => navigate("/page/workspace/admin/agents")}
+                    >
-                    >
+                      <BotIcon />
-                      <BotIcon />
+                      智能体管理
-                      智能体管理
+                    </DropdownMenuItem>
-                    </DropdownMenuItem>
+                  )}
-                  )}
+                  {isAdmin && (
-                  {isAdmin && (
+                    <DropdownMenuItem
-                    <DropdownMenuItem
+                      onClick={() => navigate("/page/workspace/admin/skills")}
-                      onClick={() => navigate("/page/workspace/admin/skills")}
+                    >
-                    >
+                      <SparklesIcon />
-                      <SparklesIcon />
+                      技能管理
-                      技能管理
+                    </DropdownMenuItem>
-                    </DropdownMenuItem>
+                  )}
-                  )}
+                  <DropdownMenuItem
-                  <DropdownMenuItem
+                    onClick={() => navigate("/page/workspace/admin/tags")}
-                    onClick={() => navigate("/page/workspace/admin/tags")}
+                  >
-                  >
+                    <TagsIcon />
-                    <TagsIcon />
+                    {t.adminTags.title}
-                    {t.adminTags.title}
+                  </DropdownMenuItem>
-                  </DropdownMenuItem>
+                  {/* {isAdmin && (
-                  {isAdmin && (
+                    <DropdownMenuItem
-                    <DropdownMenuItem
+                      onClick={() => navigate("/page/workspace/admin/plugins")}
-                      onClick={() => navigate("/page/workspace/admin/plugins")}
+                    >
-                    >
+                      <PlugIcon />
-                      <PlugIcon />
+                      插件管理
-                      插件管理
+                    </DropdownMenuItem>
-                    </DropdownMenuItem>
+                  )} */}
-                  )}
+                  {isAdmin && (
-                  {isAdmin && (
+                    <DropdownMenuItem
-                    <DropdownMenuItem
+                      onClick={() => navigate("/page/workspace/admin/positions")}
-                      onClick={() => navigate("/page/workspace/admin/positions")}
+                    >
-                    >
+                      <BriefcaseIcon />
-                      <BriefcaseIcon />
+                      岗位管理
-                      岗位管理
+                    </DropdownMenuItem>
-                    </DropdownMenuItem>
+                  )}
-                  )}
+                  {isAdmin && (
-                  {isAdmin && (
+                    <DropdownMenuItem
-                    <DropdownMenuItem
+                      onClick={() =>
-                      onClick={() =>
+                        navigate(
-                        navigate(
+                          "/page/workspace/settings/recommended-questions",
-                          "/page/workspace/settings/recommended-questions",
+                        )
-                        )
+                      }
-                      }
+                    >
-                    >
+                      <MessageCircleQuestionIcon />
-                      <MessageCircleQuestionIcon />
+                      推荐问题配置
-                      推荐问题配置
+                    </DropdownMenuItem>
-                    </DropdownMenuItem>
+                  )}
-                  )}
+                  {isAdmin && logSystem?.enabled && logSystem.url && (
-                  {isAdmin && logSystem?.enabled && logSystem.url && (
+                    <DropdownMenuItem
-                    <DropdownMenuItem
+                      onClick={() =>
-                      onClick={() =>
+                        window.open(
-                        window.open(
+                          logSystem.url,
-                          logSystem.url,
+                          "_blank",
-                          "_blank",
+                          "noopener,noreferrer",
-                          "noopener,noreferrer",
+                        )
-                        )
+                      }
-                      }
+                    >
-                    >
+                      <ScrollTextIcon />
-                      <ScrollTextIcon />
+                      {logSystem.label || "日志系统"}
-                      {logSystem.label || "日志系统"}
+                    </DropdownMenuItem>
-                    </DropdownMenuItem>
+                  )}
-                  )}
+                </DropdownMenuGroup>
-                </DropdownMenuGroup>
+                <DropdownMenuSeparator />
-                <DropdownMenuSeparator />
+              </DropdownMenuContent>
-              </DropdownMenuContent>
+            </DropdownMenu>
-            </DropdownMenu>
+          ) : (
-          ) : (
+            <SidebarMenuButton size="lg" className="pointer-events-none">
-            <SidebarMenuButton size="lg" className="pointer-events-none">
+              <NavMenuButtonContent isSidebarOpen={isSidebarOpen} t={t} />
-              <NavMenuButtonContent isSidebarOpen={isSidebarOpen} t={t} />
+            </SidebarMenuButton>
-            </SidebarMenuButton>
+          )}
-          )}
+        </SidebarMenuItem>
-        </SidebarMenuItem>
+      </SidebarMenu>
-      </SidebarMenu>
+    </>
-    </>
+  );
-  );
+}
-}

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

@@ -20,11 +20,15 @@ import { WorkspaceHeader } from "./workspace-header";
 import { WorkspaceNavChatList } from "./workspace-nav-chat-list";
 import { WorkspaceNavMenu } from "./workspace-nav-menu";
 
-export function WorkspaceSidebar({
+export function WorkspaceSidebar({
-  compactChrome = false,
+  compactChrome = false,
-  className,
+  forceCollapsed = false,
-  ...props
+  className,
-}: React.ComponentProps<typeof Sidebar> & { compactChrome?: boolean }) {
+  ...props
+}: React.ComponentProps<typeof Sidebar> & {
+  compactChrome?: boolean;
+  forceCollapsed?: boolean;
+}) {
   const { open: isSidebarOpen } = useSidebar();
   const { theme } = useTheme();
   const pathname = usePathname();
@@ -32,8 +36,26 @@ export function WorkspaceSidebar({
   // 通用问答（全量模式）左栏：新建回答 → 常用智能体 → 聊天记录（需求 0616 #1）。
   // 仅在通用问答（/page/workspace/chats*）下启用三块式布局；点击常用智能体后是
   // 「原地嵌入」（停留在 /chats/new?agent=...，仅右侧问答区换成智能体对话），左侧栏不变。
-  const isGeneralQa = pathname.startsWith("/page/workspace/chats");
+  const isGeneralQa = pathname.startsWith("/page/workspace/chats");
-
+
+  if (forceCollapsed) {
+    return (
+      <Sidebar
+        variant="sidebar"
+        collapsible="icon"
+        className={cn(
+          "bg-sidebar [&_[data-slot=sidebar-inner]]:bg-sidebar",
+          className,
+        )}
+        {...props}
+      >
+        <SidebarContent>
+          <WorkspaceNavChatList />
+        </SidebarContent>
+      </Sidebar>
+    );
+  }
+
   // 紧凑模式：用「外层定宽容器 + transition-[width]」做展开/收起过渡动画。
   // collapsible="none" 的 Sidebar 是普通 in-flow 定宽块（非 absolute，故不受本布局对
   // sidebar-container 的 absolute/left-0 覆盖影响），外层 overflow-hidden 把它从

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 (isBuiltinTheme(saved)) return saved;
-  if (saved === 'lightblue') return 'lightblue';
+  if (isCustomThemeId(saved)) return saved;
   return 'light';
 }
 
@@ -161,7 +253,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 +269,7 @@ export const ThemeProvider: React.FC<ThemeProviderProps> = ({ children }) => {
     const current = localStorage.getItem(STORAGE_KEY);
     const legacy = localStorage.getItem('theme');
 
-    if (
+    if (current && !isBuiltinTheme(current) && !isCustomThemeId(current)) {
-      current &&
-      current !== 'light' &&
-      current !== 'dark' &&
-      current !== 'lightblue'
-    ) {
       // Garbage value — wipe it so the boot-sync below can take over.
       localStorage.removeItem(STORAGE_KEY);
     }
@@ -211,19 +300,47 @@ export const ThemeProvider: React.FC<ThemeProviderProps> = ({ children }) => {
   }, [mounted, forcedTheme, appearance?.default_theme, resolvedTheme, setNextTheme]);
 
   const effectiveTheme = forcedTheme ?? resolvedTheme;
-  const theme: ThemeType = mounted
+  const persistedTheme = readPersistedTheme();
-    ? effectiveTheme === 'dark'
+  const requestedTheme = (mounted ? effectiveTheme : persistedTheme) ?? 'light';
-      ? 'dark'
+  const customTheme = getEnabledCustomTheme(
-      : effectiveTheme === 'lightblue'
+    requestedTheme,
-        ? 'lightblue'
+    appearance?.custom_themes,
-        : 'light'
+  );
-    : readPersistedTheme();
+  const theme: ThemeType = isBuiltinTheme(requestedTheme)
+    ? requestedTheme
+    : customTheme?.id ?? '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 +351,17 @@ export const ThemeProvider: React.FC<ThemeProviderProps> = ({ children }) => {
     root.removeAttribute('theme-mode');
     root.classList.remove('dark');
 
-    if (theme === 'lightblue') {
+    if (
-      root.setAttribute('data-theme', 'lightblue');
+      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,7 +373,7 @@ export const ThemeProvider: React.FC<ThemeProviderProps> = ({ children }) => {
     markExplicitChoice();
   };
 
-  const themeConfig = themes[theme];
+  const themeConfig = themes[isBuiltinTheme(theme) ? theme : 'light'];
 
   return (
     <ThemeContext.Provider
@@ -277,6 +399,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) {
+export function useAgent(
-  const { data, isLoading, error } = useQuery({
+  id: string | null | undefined,
-    queryKey: ["agents", id],
+  { enabled = true }: { enabled?: boolean } = {},
-    queryFn: () => getAgent(id!),
+) {
-    enabled: !!id,
+  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 url = urlOfArtifact({ filepath: enhancedFilepath, threadId, isMock, publicShareCode });
-  const response = await apiFetch(url);
+  const response = await apiFetch(url);
-  const text = await response.text();
+  const text = await response.text();
-  return { content: text, url };
+  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({
+export function urlOfArtifact({
-  filepath,
+  filepath,
-  threadId,
+  threadId,
-  download = false,
+  download = false,
-  isMock = false,
+  isMock = false,
-  publicShareCode,
+  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) {
+  if (publicShareCode) {
-    const normalized = filepath.startsWith("/") ? filepath : `/${filepath}`;
+    const normalized = filepath.startsWith("/") ? filepath : `/${filepath}`;
-    return `${getBackendBaseURL()}/api/public/shares/${encodeURIComponent(
+    return `${getBackendBaseURL()}/api/public/shares/${encodeURIComponent(
-      publicShareCode,
+      publicShareCode,
-    )}/files${normalized}`;
+    )}/files${normalized}`;
-  }
+  }
-  if (isMock) {
+  const normalized = filepath.startsWith("/") ? filepath : `/${filepath}`;
-    return `${getBackendBaseURL()}/mock/api/threads/${threadId}/artifacts${filepath}${download ? "?download=true" : ""}`;
+  if (isMock) {
-  }
+    return `${getBackendBaseURL()}/mock/api/threads/${threadId}/artifacts${normalized}${download ? "?download=true" : ""}`;
-  return `${getBackendBaseURL()}/api/threads/${threadId}/artifacts${filepath}${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) {
+export function resolveArtifactURL(absolutePath: string, threadId: string) {
-  return `${getBackendBaseURL()}/api/threads/${threadId}/artifacts${absolutePath}`;
+  const normalized = absolutePath.startsWith("/") ? absolutePath : `/${absolutePath}`;
-}
+  return `${getBackendBaseURL()}/api/threads/${threadId}/artifacts${normalized}`;
+}

frontend-web/src/core/auth/dashboard-input.ts

@@ -1,100 +1,19 @@
 /**
- * 大屏绘制智能体「独立页面」的**输入 JSON** 适配 seam。
+ * 大屏绘制智能体的任务输入适配层。
  *
- * 设计意图：深链 `?taskId=` 模式下，后端提供「研判情报报告」接口
+ * 报告详情由 Gateway 的 `/api/task-reports/by-task/{taskId}` 提供，返回格式
- *   GET `{VITE_AIPI_CONSUMER_URL}/cop/selectSqReport?taskId=`
+ * 与原 `selectSqReport` 一致：`{state, msg, data}`。每条 `contentJson` 是
- * 返回该任务的多类情报内容；本页把它**提取成干净的结构化 JSON** 交给智能体分析
+ * JSON 字符串，本模块将其按 `categoryType` 解析为智能体和大屏页面可直接使用的
- * → 产出 report-json → 绘制大屏（react / html）。
+ * 结构化输入。
- *
- * 接口返回结构：`{ state, msg, data: [{ id, taskId, ..., contentJson, categoryType }] }`，
- * 其中 `contentJson` 是**被转义的 JSON 字符串**，`categoryType` 形如「敌情关键事件 JSON」。
- * 本模块 `extractSqReport` 把每条的 `contentJson` 反序列化、按 `categoryType` 归类，
- * 拼成 `{ taskId, categories: { 敌情关键事件: [...], 决心建议: {...}, ... } }` 喂给智能体。
- *
- * ⚠️ 真实接口现在还**请求不到**：通过 `VITE_MOCK_SQ_REPORT=true`（见 `utils/request.ts`）
- * 走后端给的样例假数据（`sq-report-mock.json`），机制与 cop-task-detail 假数据一致。
- * 联调通过后把该 env 置 false 即走真实接口；接口/数据若有变只需改 `extractSqReport`。
  */
 
-import { requestCrudService } from "@/service/request-axios-service";
+import { getTaskReport } from "@/strategy-components/api/task-reports";
-import { readCopTaskDetail } from "@/core/auth/task-deeplink";
+import { readRuntimeFlag } from "@/env";
-import { fetchTaskDeeplinkConfig } from "@/core/auth/task-deeplink-config";
+import { SQ_REPORT_MOCK_RESPONSE } from "@/strategy-components/components/task-components/sq-report-mock-data";
 
-/** 本页输入 JSON 暂存的 sessionStorage key（拉取一次后复用，避免重复请求）。 */
+/** 保留给既有调用方的 sessionStorage key；报告本身不再使用 mock 缓存。 */
 export const DASHBOARD_INPUT_STORAGE_KEY = "dashboard.inputJson";
 
-/**
- * 🧪 演示用模拟业务 JSON —— JSON 接口未就绪、也没有登录任务详情时的兜底输入。
- * 让大屏页可立即跑通：智能体分析这份数据 → report-json → 渲染大屏。
- * ⚠️ 接口就绪后删除本常量及其兜底引用。
- */
-export const DEMO_DASHBOARD_INPUT = {
-  taskId: "DEMO-涉台舆情",
-  taskName: "2026 第一季度涉台舆情态势研判",
-  taskContent:
-    "汇总境内外多平台涉台舆情数据，研判热点叙事走势、关键行为体立场与传播渠道分布，识别风险并给出处置建议。",
-  overview:
-    "本季涉台舆情整体平稳但局部波动，'两岸交流''和平发展'类正向叙事占比上升，少数账号借军事议题制造紧张；境外智库与媒体联动放大特定框架。",
-  period: "2026-01-01 ~ 2026-03-31",
-  kpis: {
-    总信息量: 1284000,
-    日均增速: "12%",
-    正向占比: "58%",
-    负向占比: "19%",
-    识别风险点: 7,
-    覆盖平台: 12,
-  },
-  channels: [
-    { platform: "微博", share: 34 },
-    { platform: "境外社媒(X/FB)", share: 27 },
-    { platform: "短视频", share: 18 },
-    { platform: "新闻门户", share: 13 },
-    { platform: "论坛/贴吧", share: 8 },
-  ],
-  narratives: [
-    { theme: "两岸交流与融合发展", sentiment: "正向", volume: 42, trend: "up" },
-    { theme: "和平稳定·避战", sentiment: "正向", volume: 26, trend: "up" },
-    { theme: "军事演训与安全", sentiment: "中性偏负", volume: 21, trend: "flat" },
-    { theme: "外部势力介入", sentiment: "负向", volume: 11, trend: "down" },
-  ],
-  actors: [
-    { name: "主流官媒", stance: "正面引导", influence: 88, note: "议程设置与权威发布" },
-    { name: "岛内民间团体", stance: "中性多元", influence: 64, note: "交流合作类内容活跃" },
-    { name: "境外智库", stance: "负面框架", influence: 57, note: "联动媒体放大紧张叙事" },
-    { name: "自媒体大V", stance: "立场分化", influence: 49, note: "情绪化传播、易被借势" },
-  ],
-  risks: [
-    { label: "军事议题被恶意剪辑放大", level: "high" },
-    { label: "境外智库联动制造紧张框架", level: "high" },
-    { label: "个别大V情绪化带节奏", level: "mid" },
-    { label: "短视频谣言二次传播", level: "mid" },
-    { label: "节假日期间信息量骤增", level: "low" },
-  ],
-  timeline: [
-    { phase: "数据汇聚", desc: "12 平台多源采集与清洗去重" },
-    { phase: "叙事识别", desc: "聚类提炼核心叙事与情感倾向" },
-    { phase: "行为体画像", desc: "关键账号立场与影响力建模" },
-    { phase: "风险研判", desc: "识别高危议题与传播链路" },
-    { phase: "处置建议", desc: "分级响应与正向引导预案" },
-  ],
-  weeklyVolume: [
-    { week: "W1", value: 86 },
-    { week: "W2", value: 92 },
-    { week: "W3", value: 110 },
-    { week: "W4", value: 134 },
-    { week: "W5", value: 121 },
-    { week: "W6", value: 158 },
-  ],
-};
-
-/** 「研判情报报告」接口完整地址：`{VITE_AIPI_CONSUMER_URL}/cop/selectSqReport`。 */
-function sqReportUrl(): string {
-  const value = (import.meta.env as Record<string, unknown>).VITE_AIPI_CONSUMER_URL;
-  const base = typeof value === "string" ? value.replace(/\/+$/, "") : "";
-  return base ? `${base}/cop/selectSqReport` : "";
-}
-
-/** 把单条 `contentJson` 反序列化为对象/数组/原值（已是对象则原样返回）。 */
 function parseContentJson(raw: unknown): unknown {
   if (typeof raw !== "string") return raw ?? null;
   const text = raw.trim();
@@ -102,11 +21,11 @@ function parseContentJson(raw: unknown): unknown {
   try {
     return JSON.parse(text);
   } catch {
-    return text; // 解析失败就把原始字符串透传给智能体，让它自行理解
+    // 非 JSON 字符串仍透传给智能体，避免因单条异常让整份报告不可用。
+    return text;
   }
 }
 
-/** 去掉 categoryType 末尾的「 JSON」后缀，作为归类键（如「敌情关键事件 JSON」→「敌情关键事件」）。 */
 function categoryKey(categoryType: unknown, index: number): string {
   const raw = typeof categoryType === "string" ? categoryType.trim() : "";
   const cleaned = raw.replace(/\s*JSON\s*$/i, "").trim();
@@ -114,151 +33,76 @@ function categoryKey(categoryType: unknown, index: number): string {
 }
 
 /**
- * 把 selectSqReport 的整包响应**提取**成喂给智能体的干净结构化输入：
+ * 将接口 envelope 提取为 `{ taskId, source, categories }`。
- *   `{ taskId, source, categories: { [类目]: 反序列化后的内容 } }`
+ * 返回 null 表示该任务尚未保存可用的报告内容。
- * 返回 null 表示无可用内容（调用方据此回退/不开跑）。
  */
 export function extractSqReport(body: unknown, taskId: string): unknown | null {
   const data = (body && typeof body === "object" ? (body as { data?: unknown }).data : null) as
     | Array<Record<string, unknown>>
     | undefined;
   if (!Array.isArray(data) || data.length === 0) return null;
+
   const categories: Record<string, unknown> = {};
   data.forEach((item, index) => {
     const content = parseContentJson(item?.contentJson);
     if (content == null) return;
     let key = categoryKey(item?.categoryType, index);
-    if (key in categories) key = `${key}（${index + 1}）`; // 同名类目去重保留
+    if (key in categories) key = `${key}（${index + 1}）`;
     categories[key] = content;
   });
   if (Object.keys(categories).length === 0) return null;
-  return { taskId, source: "cop/selectSqReport", categories };
+  return { taskId, source: "api/task-reports", categories };
 }
 
-/**
+/** 兼容旧调用方：报告由接口实时读取，不再在浏览器中缓存。 */
- * 输入 JSON 缓存**仅供开发(mock)使用**：`VITE_MOCK_SQ_REPORT==='true'` 时才读/写缓存，
- * 避免开发反复请求样例假数据。真实接口模式（false）下不读不写缓存，**始终拉取真实数据**。
- */
-function inputCacheEnabled(): boolean {
-  return (import.meta.env as Record<string, unknown>).VITE_MOCK_SQ_REPORT === "true";
-}
-
-/** 读取暂存的输入 JSON（仅 mock 开发模式生效，真实模式恒返回 null 以强制重新拉取）。 */
 export function readDashboardInputJson(): unknown | null {
-  if (!inputCacheEnabled()) return null;
+  return null;
-  try {
-    const raw = sessionStorage.getItem(DASHBOARD_INPUT_STORAGE_KEY);
-    return raw ? JSON.parse(raw) : null;
-  } catch {
-    return null;
-  }
 }
 
-/** 暂存输入 JSON（仅 mock 开发模式生效；隐私模式/quota 异常静默失败）。 */
+/** 兼容旧调用方：报告数据只由后端接口维护。 */
-export function persistDashboardInputJson(data: unknown): void {
+export function persistDashboardInputJson(_data: unknown): void {
-  if (!inputCacheEnabled()) return;
+  // noop
-  try {
-    sessionStorage.setItem(DASHBOARD_INPUT_STORAGE_KEY, JSON.stringify(data));
-  } catch {
-    /* noop */
-  }
 }
 
-/** 用登录暂存的任务详情拼一份占位输入（接口未就绪时的回退）。 */
+/** 查询并提取当前任务的报告详情；失败或空数据均返回 null。 */
-function placeholderFromCopTask(taskId: string): unknown | null {
-  const detail = readCopTaskDetail();
-  if (!detail) return taskId ? { taskId } : null;
-  return {
-    taskId,
-    taskName: detail.taskName,
-    taskContent: detail.taskContent,
-    overview: detail.overview,
-    taskDirection: detail.taskDirection,
-    _note: "占位输入（真实业务 JSON 接口未就绪）",
-  };
-}
-
-/**
- * 取本页的输入 JSON：**先请求 selectSqReport，待其返回后再交给模型抽取**。
- *
- * - 真实接口模式（`VITE_MOCK_SQ_REPORT=false`）：不读缓存、不兜底假数据——
- *   **只用接口真实返回的内容**；请求失败或返回空一律返回 `null`（页面据此提示「请求失败/无数据」，
- *   绝不拿占位/演示数据去喂模型，避免「没等接口就抽取假数据」）。
- * - mock 开发模式（true）：走本地样例假数据（见 utils/request.ts）并缓存避免反复请求；
- *   仅此模式在接口不可用时回退 copTaskDetail 占位 / DEMO 演示数据，保证开发能跑通。
- */
 export async function fetchDashboardInputJson(
   taskId: string,
-  opts?: { forceRefresh?: boolean },
+  _opts?: { forceRefresh?: boolean },
 ): Promise<unknown | null> {
-  const mock = inputCacheEnabled(); // true=mock/开发；false=真实接口
+  if (!taskId) return null;
-  // forceRefresh（重新分析/修改时）：跳过缓存，强制重新请求接口拿**最新数据**（数据可能已变化）。
+  // 开发演示模式使用与 Gateway 接口同形的本地样例；这样不依赖报告库是否已为
-  const cached = opts?.forceRefresh ? null : readDashboardInputJson(); // 真实模式恒 null（缓存仅开发用）
+  // 当前深链 taskId 写入数据，同时真实/生产环境仍始终从 Gateway 读取。
-  if (cached) return cached;
+  if (readRuntimeFlag("VITE_MOCK_SQ_REPORT")) {
-
+    return extractSqReport(
-  const url = sqReportUrl();
+      {
-  if (url && taskId) {
+        ...SQ_REPORT_MOCK_RESPONSE,
-    try {
+        data: SQ_REPORT_MOCK_RESPONSE.data.map((item) => ({ ...item, taskId })),
-      // service 拦截器统一注入鉴权并返回 response.data（整包 body）。
+      },
-      // await 在此：必须**等接口返回**后才有 body 可 extract → 再由上层启动模型抽取。
+      taskId,
-      const body = await requestCrudService.get(url, { taskId });
+    );
-      const extracted = extractSqReport(body, taskId);
-      if (extracted) {
-        persistDashboardInputJson(extracted); // 真实模式 no-op
-        return extracted;
-      }
-    } catch {
-      /* 请求失败：真实模式返回 null（见下），mock 模式落占位/DEMO */
-    }
   }
-
+  const body = await getTaskReport(taskId);
-  // 真实接口模式：**不兜底假数据**。失败/空 → null，让页面提示而不是拿假数据喂模型。
+  return extractSqReport(body, taskId);
-  if (!mock) return null;
-
-  // 以下兜底**仅 mock/开发模式**：copTaskDetail 占位 / DEMO 演示数据，保证开发能看效果。
-  const placeholder = placeholderFromCopTask(taskId);
-  const detail = readCopTaskDetail();
-  const resolved = detail ? placeholder : { ...DEMO_DASHBOARD_INPUT, taskId: taskId || DEMO_DASHBOARD_INPUT.taskId };
-  if (resolved) persistDashboardInputJson(resolved);
-  return resolved;
 }
 
-/* ---------------------- rwfx 进入预检：3q 是否完成 ---------------------- */
-
-/**
- * 「3q（研判情报报告）是否完成」状态：
- *   - ``complete``   = selectSqReport 数组里有有效内容；
- *   - ``incomplete`` = 数组为空 / 每条 contentJson 都是 null/空（3q 未完成）；
- *   - ``unknown``    = 缺 consumer 地址 / 请求异常（无法判定，调用方应静默放行）。
- */
 export type SqReportStatus = "complete" | "incomplete" | "unknown";
 
-/**
+export interface SqReportCheckResult {
- * rwfx（任务分析）进入时的「3q 是否完成」预检：调 selectSqReport，复用 ``extractSqReport``
+  status: SqReportStatus;
- * 判定该任务是否已有有效研判情报。判定口径与大屏绘制取数完全一致（空/全 null → 无内容）。
+  report?: unknown;
- *   - 有可用内容 → ``complete``（正常）；
+}
- *   - 空 / 全 null → ``incomplete``（rwfx 据此弹框引导去 3qfx）；
+
- *   - 缺地址 / 请求失败 → ``unknown``（不打扰用户）。
+/** rwfx 进入前检查：任务已有可解析报告则 complete，否则 incomplete。 */
- *
+export async function fetchSqReportCheck(taskId: string): Promise<SqReportCheckResult> {
- * **数据源由后端配置 ``task_deeplink.test`` 决定**（线上 selectSqReport 外部不可用时）：
+  if (!taskId) return { status: "unknown" };
- *   - ``test=true``  → 直接用 ``config.yaml`` 的 ``mock.sq_report`` 假数据判定，**不发请求**
- *     （与目的树查询/行动解析的 mock 同一套机制，见 [[task-deeplink-config]]）；
- *   - ``test=false`` → 调真实接口 ``GET {VITE_AIPI_CONSUMER_URL}/cop/selectSqReport?taskId=``。
- */
-export async function fetchSqReportStatus(taskId: string): Promise<SqReportStatus> {
-  if (!taskId) return "unknown";
-  const cfg = await fetchTaskDeeplinkConfig();
-  // test=true：外部接口不可用，直接用后端 config 的假数据判定（不打真实接口）。
-  if (cfg.test) {
-    return extractSqReport(cfg.mock.sqReport, taskId) ? "complete" : "incomplete";
-  }
-  // 真实模式：打真实接口。service 拦截器统一注入鉴权并返回整包 body；空/全 null → null。
-  const url = sqReportUrl();
-  if (!url) return "unknown";
   try {
-    const body = await requestCrudService.get(url, { taskId });
+    const report = await fetchDashboardInputJson(taskId);
-    return extractSqReport(body, taskId) ? "complete" : "incomplete";
+    return report ? { status: "complete", report } : { status: "incomplete" };
   } catch {
-    return "unknown";
+    return { status: "unknown" };
   }
 }
+
+export async function fetchSqReportStatus(taskId: string): Promise<SqReportStatus> {
+  return (await fetchSqReportCheck(taskId)).status;
+}

frontend-web/src/core/auth/external-access-token.ts

@@ -1,3 +1,7 @@
+import { authStorageGet, authStorageSet } from "@/core/auth/scoped-storage";
+
+export const EXTERNAL_ACCESS_TOKEN_STORAGE_KEY = "access_token";
+
 export function normalizeExternalAccessToken(value: unknown): string {
   if (value == null) return "";
   const token = String(value).trim();
@@ -5,3 +9,53 @@ export function normalizeExternalAccessToken(value: unknown): string {
   const lowered = token.toLowerCase();
   return lowered === "null" || lowered === "undefined" ? "" : token;
 }
+
+function readTokenFromStoredValue(raw: string | null): string {
+  const token = normalizeExternalAccessToken(raw);
+  if (!token) return "";
+  if (!token.startsWith("{")) return token;
+  try {
+    const parsed = JSON.parse(token);
+    if (!parsed || typeof parsed !== "object") return token;
+    const obj = parsed as Record<string, unknown>;
+    return (
+      normalizeExternalAccessToken(obj.access_token) ||
+      normalizeExternalAccessToken(obj.accessToken) ||
+      normalizeExternalAccessToken(obj.token)
+    );
+  } catch {
+    return token;
+  }
+}
+
+export function readStoredExternalAccessTokenValue(): string {
+  return readTokenFromStoredValue(authStorageGet(EXTERNAL_ACCESS_TOKEN_STORAGE_KEY));
+}
+
+export function readExternalAccessTokenValue(userInfo: Record<string, unknown>): string {
+  return normalizeExternalAccessToken(userInfo.access_token) || normalizeExternalAccessToken(userInfo.accessToken);
+}
+
+export function readCurrentExternalAccessTokenValue(userInfo: Record<string, unknown>): string {
+  return readStoredExternalAccessTokenValue() || readExternalAccessTokenValue(userInfo);
+}
+
+export function writeExternalAccessTokenFields(
+  userInfo: Record<string, unknown>,
+  token: string,
+): void {
+  userInfo.access_token = token;
+  userInfo.accessToken = token;
+}
+
+export function writeStoredExternalAccessToken(token: string): void {
+  const normalized = normalizeExternalAccessToken(token);
+  if (normalized) {
+    authStorageSet(EXTERNAL_ACCESS_TOKEN_STORAGE_KEY, normalized);
+  }
+}
+
+export function deleteExternalAccessTokenFields(userInfo: Record<string, unknown>): void {
+  delete userInfo.access_token;
+  delete userInfo.accessToken;
+}

frontend-web/src/core/auth/index.ts

@@ -22,6 +22,8 @@ import {
 } from "@/core/auth/scoped-storage";
 
 const AUTH_STORAGE_KEY = "deerflow.auth";
+/** Fired in the current tab because the browser `storage` event only reaches other tabs. */
+export const AUTH_STATE_CHANGED_EVENT = "deerflow:auth-state-changed";
 
 function isBrowser(): boolean {
   return typeof window !== "undefined";
@@ -48,6 +50,7 @@ export function setStoredAuth(auth: LoginByUsernameResponse) {
     return;
   }
   authStorageSet(AUTH_STORAGE_KEY, JSON.stringify(auth));
+  window.dispatchEvent(new Event(AUTH_STATE_CHANGED_EVENT));
 }
 
 export function clearStoredAuth() {
@@ -55,6 +58,7 @@ export function clearStoredAuth() {
     return;
   }
   authStorageRemove(AUTH_STORAGE_KEY);
+  window.dispatchEvent(new Event(AUTH_STATE_CHANGED_EVENT));
 }
 
 /** 与设置 → 个人信息页「用户名」一致：邮箱 @ 前缀，否则 user_id。 */

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

@@ -0,0 +1,33 @@
+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.
+ */
+export const ROUTE_KEY_MAPPINGS: Readonly<Record<string, string>> = {
+  a: "/page/canvas/ai-writing",
+  "8bf": "/page/strategy/qa/8bf-roundtable",
+};
+
+/** 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 resolveRouteKey(routeKey: string | null | undefined): string {
+  const key = routeKey?.trim();
+  if (!key) return "";
+  return ROUTE_KEY_MAPPINGS[key] ?? "";
+}

frontend-web/src/core/auth/scoped-storage.ts

@@ -62,7 +62,7 @@ export function authStorageRemove(key: string): void {
  * ticket/userId/env/maxkeyOnlineToken/userDetailToken）。用于「开启独立会话」时把当前登录态从
  * localStorage 快照搬进 sessionStorage，避免切换存储后被登出。
  */
-const PROTECTED_AUTH_EXACT_KEYS = ["deerflow.auth", "userInfo", "userId", "tools_token"];
+const PROTECTED_AUTH_EXACT_KEYS = ["deerflow.auth", "userInfo", "userId", "tools_token", "access_token"];
 const PROTECTED_AUTH_PREFIX = "login.";
 
 function isProtectedAuthKey(key: string): boolean {

frontend-web/src/core/auth/task-deeplink.ts

@@ -18,6 +18,7 @@
 import { requestCrudService } from "@/service/request-axios-service";
 import { clearTaskContext, persistTaskContext } from "@/core/auth/task-purpose";
 import { fetchTaskDeeplinkConfig } from "@/core/auth/task-deeplink-config";
+import { readRuntimeEnv, readRuntimeFlag } from "@/env";
 import { listBusinessMappings } from "@/strategy-components/api/business-mapping";
 
 /** xdfx 业务码：深链传入的是「行动id」，需先调 action 接口解析出真正的「任务id」。 */
@@ -73,13 +74,13 @@ export function parseGoPath(goPath: string): ParsedGoPath | null {
 }
 
 function consumerBaseUrl(): string {
-  const value = import.meta.env.VITE_AIPI_CONSUMER_URL;
+  const value = readRuntimeEnv("VITE_AIPI_CONSUMER_URL");
   return typeof value === "string" ? value.replace(/\/+$/, "") : "";
 }
 
 /** cop-task-detail 是否走本地假数据：开关 `VITE_MOCK_COP_TASK_DETAIL=true`（真实接口未就绪时调试用）。 */
 function copTaskDetailMockEnabled(): boolean {
-  return (import.meta.env as Record<string, unknown>).VITE_MOCK_COP_TASK_DETAIL === "true";
+  return readRuntimeFlag("VITE_MOCK_COP_TASK_DETAIL");
 }
 
 /** cop-task-detail 本地假数据（与真实 data 字段同构；mock 开关开启时返回）。 */
@@ -234,7 +235,7 @@ export interface TaskDeeplinkTarget {
 }
 
 /** xdfx（行动分析）开场信息里要追加的行动信息：行动标题 + 行动内容 + 行动id。 */
-interface ActionOpeningInfo {
+export interface ActionOpeningInfo {
   /** 行动id（action_id）。 */
   actionId?: string;
   /** 行动标题（行动名称 actionName）。 */
@@ -264,8 +265,12 @@ function buildOpeningText(detail: CopTaskDetail, taskId: string, action?: Action
  * 3qfx/rwfx 这类“按任务id 直接问答”的任务工作区，在 ``TaskContext`` 丢失但
  * ``login.copTaskDetail`` 仍存在时，可用它重新拼出开场词做前端自恢复。
  */
-export function buildTaskOpeningText(detail: CopTaskDetail, taskId: string): string {
+export function buildTaskOpeningText(
-  return buildOpeningText(detail, taskId);
+  detail: CopTaskDetail,
+  taskId: string,
+  action?: ActionOpeningInfo,
+): string {
+  return buildOpeningText(detail, taskId, action);
 }
 
 /**

frontend-web/src/core/auth/use-live-account.ts

@@ -2,7 +2,11 @@
 
 import { useEffect, useRef, useState } from "react";
 
-import { getAccountDisplayName, getStoredAuth } from "@/core/auth";
+import {
+  AUTH_STATE_CHANGED_EVENT,
+  getAccountDisplayName,
+  getStoredAuth,
+} from "@/core/auth";
 import { isEmbedActive } from "@/core/embed/embed-session";
 
 const AUTH_STORAGE_KEY = "deerflow.auth";
@@ -61,11 +65,13 @@ export function useLiveAccount(): LiveAccount {
     if (!isEmbedActive()) {
       window.addEventListener("storage", onStorage);
     }
+    window.addEventListener(AUTH_STATE_CHANGED_EVENT, refresh);
     window.addEventListener("focus", refresh);
     document.addEventListener("visibilitychange", refresh);
     refresh();
     return () => {
       window.removeEventListener("storage", onStorage);
+      window.removeEventListener(AUTH_STATE_CHANGED_EVENT, refresh);
       window.removeEventListener("focus", refresh);
       document.removeEventListener("visibilitychange", refresh);
     };

frontend-web/src/core/auth/wujie-ticket-login.ts

@@ -5,12 +5,13 @@ import {
   persistExternalLoginParams,
 } from "./external-login";
 import { authStorageSet } from "@/core/auth/scoped-storage";
+import { readRuntimeEnv } from "@/env";
 
-const AUTH_BASE_URL = (import.meta.env.VITE_AUTH_BASE_URL || "").replace(
+const AUTH_BASE_URL = (readRuntimeEnv("VITE_AUTH_BASE_URL") || "").replace(
   /\/$/,
   "",
 );
-const CONSUMER_URL = (import.meta.env.VITE_AIPI_CONSUMER_URL || "").replace(
+const CONSUMER_URL = (readRuntimeEnv("VITE_AIPI_CONSUMER_URL") || "").replace(
   /\/$/,
   "",
 );

frontend-web/src/core/auth/yuser-login.ts

@@ -1,8 +1,16 @@
 import { requestCrudService } from "@/service/request-axios-service";
 import { authStorageGet, authStorageSet } from "@/core/auth/scoped-storage";
-import { normalizeExternalAccessToken } from "@/core/auth/external-access-token";
+import { readRuntimeEnv } from "@/env";
+import {
+  deleteExternalAccessTokenFields,
+  normalizeExternalAccessToken,
+  readStoredExternalAccessTokenValue,
+  readExternalAccessTokenValue,
+  writeExternalAccessTokenFields,
+  writeStoredExternalAccessToken,
+} from "@/core/auth/external-access-token";
 
-const CONSUMER_URL = import.meta.env.VITE_AIPI_CONSUMER_URL || "";
+const CONSUMER_URL = readRuntimeEnv("VITE_AIPI_CONSUMER_URL") || "";
 
 export const TOOLS_TOKEN_STORAGE_KEY = "tools_token";
 export const EXTERNAL_USER_ID_STORAGE_KEY = "userId";
@@ -36,6 +44,38 @@ function readStoredYUserId(info: Record<string, unknown>): string {
   return value == null ? "" : String(value).trim();
 }
 
+function normalizeExternalUserId(value: unknown): string {
+  if (value == null) return "";
+  const text = String(value).trim();
+  if (!text) return "";
+  const lowered = text.toLowerCase();
+  return lowered === "null" || lowered === "undefined" ? "" : text;
+}
+
+function maskToken(token: string): string {
+  if (!token) return "";
+  if (token.length <= 10) return `${token.slice(0, 2)}***(${token.length})`;
+  return `${token.slice(0, 6)}...${token.slice(-4)}(${token.length})`;
+}
+
+function summarizeUserInfo(info: Record<string, unknown>): Record<string, unknown> {
+  return {
+    keys: Object.keys(info),
+    yUserId: info.yUserId,
+    userId: info.userId,
+    userName: info.userName,
+    gateDepartName: info.gateDepartName,
+    typeName: info.typeName,
+    access_token: maskToken(normalizeExternalAccessToken(info.access_token)),
+    accessToken: maskToken(normalizeExternalAccessToken(info.accessToken)),
+  };
+}
+
+function logYUserLogin(step: string, payload: Record<string, unknown>): void {
+  if (typeof console === "undefined") return;
+  console.info(`[yUserId-login] ${step}`, payload);
+}
+
 function isPlainObject(value: unknown): value is Record<string, unknown> {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
@@ -84,6 +124,7 @@ function writeCachedYUserInfo(yUserId: string, info: Record<string, unknown>): v
 function buildExternalUserInfo(
   yUserId: string,
   result: Record<string, unknown>,
+  access_token: string | null | undefined,
   previous: Record<string, unknown>,
   cached: Record<string, unknown>,
 ): Record<string, unknown> {
@@ -94,22 +135,34 @@ function buildExternalUserInfo(
     }
   }
   next.yUserId = yUserId;
+  const externalUserId =
+    normalizeExternalUserId(result.id) ||
+    normalizeExternalUserId(result.userId) ||
+    normalizeExternalUserId(result.user_id) ||
+    yUserId;
+  next.userId = externalUserId;
 
-  const incomingAccessToken = normalizeExternalAccessToken(result.accessToken);
+  const incomingAccessToken = readExternalAccessTokenValue(result);
   if (incomingAccessToken) {
-    next.accessToken = incomingAccessToken;
+    writeExternalAccessTokenFields(next, incomingAccessToken);
+    return next;
+  }
+
+  const queryAccessToken = normalizeExternalAccessToken(access_token);
+  if (queryAccessToken) {
+    writeExternalAccessTokenFields(next, queryAccessToken);
     return next;
   }
 
   const previousYUserId = readStoredYUserId(previous);
   const previousAccessToken =
-    previousYUserId === yUserId ? normalizeExternalAccessToken(previous.accessToken) : "";
+    previousYUserId === yUserId ? readExternalAccessTokenValue(previous) : "";
-  const cachedAccessToken = normalizeExternalAccessToken(cached.accessToken);
+  const cachedAccessToken = readExternalAccessTokenValue(cached);
   const fallbackAccessToken = previousAccessToken || cachedAccessToken;
   if (fallbackAccessToken) {
-    next.accessToken = fallbackAccessToken;
+    writeExternalAccessTokenFields(next, fallbackAccessToken);
   } else {
-    delete next.accessToken;
+    deleteExternalAccessTokenFields(next);
   }
   return next;
 }
@@ -121,27 +174,61 @@ function buildExternalUserInfo(
 export async function loginByYUserId(
   yUserId: string,
   token?: string | null,
+  access_token?: string | null,
 ): Promise<void> {
   if (token) {
     authStorageSet(TOOLS_TOKEN_STORAGE_KEY, token);
   }
 
+  const requestUrl = `${CONSUMER_URL}/cop/userDetailByYuserId`;
+  logYUserLogin("request", {
+    requestUrl,
+    yUserId,
+    hasToolsToken: Boolean(token),
+    queryAccessToken: maskToken(normalizeExternalAccessToken(access_token)),
+  });
+
   const res = (await requestCrudService.get(
-    `${CONSUMER_URL}/cop/userDetailByYuserId`,
+    requestUrl,
     { yuserId: yUserId },
   )) as UserDetailResponse;
 
   // consumer 返回 { accessToken, gateDepartName, typeName, userName }。
   // 一并存入路由参数 yUserId，使「应用管理」里 source=yUserId 的路由参数能取到（与
   // source=userName/gateDepartName/typeName 直接取接口值统一走 userInfo[source]）。
-  // 注意:接口也会返回 accessToken,但 XK/PG 及 source=accessToken 要用路由透传的
+  // 注意:接口返回的 accessToken 优先；登录 URL 的 access_token 只在接口值为空时兜底。
-  // access_token,故登录流程随后会用 persistAccessToken 覆盖 userInfo.accessToken。
+  // The consumer API may return accessToken. URL access_token is only used as
+  // a fallback when that API token is empty.
   const result = res.data ?? {};
+  logYUserLogin("response", {
+    keys: Object.keys(result),
+    id: result.id,
+    userId: result.userId,
+    user_id: result.user_id,
+    userName: result.userName,
+    gateDepartName: result.gateDepartName,
+    typeName: result.typeName,
+    access_token: maskToken(normalizeExternalAccessToken(result.access_token)),
+    accessToken: maskToken(normalizeExternalAccessToken(result.accessToken)),
+  });
   const previous = readExternalUserInfo();
   const cached = readCachedYUserInfo(yUserId);
-  const next = buildExternalUserInfo(yUserId, result, previous, cached);
+  const next = buildExternalUserInfo(yUserId, result, access_token, previous, cached);
+  const externalUserId = normalizeExternalUserId(next.userId);
+  if (externalUserId) {
+    authStorageSet(EXTERNAL_USER_ID_STORAGE_KEY, externalUserId);
+  }
+  const externalAccessToken = readExternalAccessTokenValue(next);
+  if (externalAccessToken) {
+    writeStoredExternalAccessToken(externalAccessToken);
+  }
   authStorageSet(EXTERNAL_USER_INFO_STORAGE_KEY, JSON.stringify(next));
   writeCachedYUserInfo(yUserId, next);
+  logYUserLogin("stored", {
+    userId: externalUserId,
+    topLevelAccessToken: maskToken(readStoredExternalAccessTokenValue()),
+    userInfo: summarizeUserInfo(next),
+  });
 }
 
 export function persistToolsToken(token: string): void {
@@ -149,17 +236,18 @@ export function persistToolsToken(token: string): void {
 }
 
 /**
- * 把内网登录路由参数 access_token 合并写入 userInfo.accessToken（覆盖接口返回的同名值）。
+ * 把内网登录路由参数 access_token 合并写入 userInfo.access_token / userInfo.accessToken。
  * 据此拼参的有：XK/PG 中任务 iframe（XK 用 accessToken、PG 用 access_token，二者均读
- * external-links.getAccessToken() = userInfo.accessToken）；以及「应用管理」里
+ * external-links.getAccessToken()）；以及「应用管理」里 source=access_token / accessToken
- * source=accessToken 的轻应用路由参数（resolveRouteParamValue 取 userInfo.accessToken）。
+ * 的轻应用路由参数（resolveRouteParamValue 统一读两种字段）。
  * 用合并而非覆盖整对象，避免抹掉 loginByYUserId 从 consumer 拿到的用户信息。
  */
 export function persistAccessToken(token: string): void {
   const trimmed = normalizeExternalAccessToken(token);
   if (!trimmed) return;
   const info = readExternalUserInfo();
-  info.accessToken = trimmed;
+  writeExternalAccessTokenFields(info, trimmed);
+  writeStoredExternalAccessToken(trimmed);
   authStorageSet(EXTERNAL_USER_INFO_STORAGE_KEY, JSON.stringify(info));
   const yUserId = readStoredYUserId(info);
   if (yUserId) {

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/clipboard.ts

@@ -0,0 +1,44 @@
+export async function copyTextToClipboard(text: string): Promise<void> {
+  let clipboardError: unknown;
+
+  if (typeof navigator !== "undefined" && navigator.clipboard?.writeText) {
+    try {
+      await navigator.clipboard.writeText(text);
+      return;
+    } catch (error) {
+      clipboardError = error;
+    }
+  }
+
+  if (typeof document === "undefined" || !document.body) {
+    throw clipboardError instanceof Error
+      ? clipboardError
+      : new Error("Clipboard is not available");
+  }
+
+  const textarea = document.createElement("textarea");
+  textarea.value = text;
+  textarea.setAttribute("readonly", "");
+  textarea.style.position = "fixed";
+  textarea.style.top = "0";
+  textarea.style.left = "0";
+  textarea.style.width = "1px";
+  textarea.style.height = "1px";
+  textarea.style.opacity = "0";
+
+  document.body.appendChild(textarea);
+  textarea.focus();
+  textarea.select();
+  textarea.setSelectionRange(0, textarea.value.length);
+
+  try {
+    const copied = document.execCommand("copy");
+    if (!copied) {
+      throw clipboardError instanceof Error
+        ? clipboardError
+        : new Error("Copy command failed");
+    }
+  } finally {
+    textarea.remove();
+  }
+}

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 });
 }

frontend-web/src/core/embed/theme-mode.mjs

@@ -0,0 +1,19 @@
+/**
+ * @typedef {"light" | "dark"} EmbedThemeMode
+ */
+
+/**
+ * Map external theme names to the two themes supported by iframe surfaces.
+ *
+ * @param {string | null | undefined} rawTheme
+ * @returns {EmbedThemeMode}
+ */
+export function resolveEmbedThemeMode(rawTheme) {
+  const theme = (rawTheme ?? "").trim().toLowerCase();
+  return theme === "dark" ||
+    theme === "dark-blue" ||
+    theme === "深色" ||
+    theme === "深蓝"
+    ? "dark"
+    : "light";
+}

frontend-web/src/core/i18n/locales/en-US.ts

@@ -448,11 +448,17 @@ export const enUS: Translations = {
       system: "System",
       light: "Light",
       dark: "Dark",
-      lightblue: "Light Blue",
+      lightblue: "Light Blue",
+      lightgreen: "Green",
+      iceblue: "Glacier Blue",
+      lightyellow: "Pale Yellow",
       systemDescription: "Match the operating system preference automatically.",
       lightDescription: "Bright palette with higher contrast for daytime.",
       darkDescription: "Dim palette that reduces glare for focus.",
-      lightblueDescription: "A crisp light palette built around blue.",
+      lightblueDescription: "A crisp light palette built around blue.",
+      lightgreenDescription: "A crisp light palette built around WeKnora green.",
+      iceblueDescription: "An airy palette built around #9BCEF1 with accessible blue actions.",
+      lightyellowDescription: "A soft palette built around #F3FBD9 with readable olive actions.",
       languageTitle: "Language",
       languageDescription: "Switch between languages.",
     },

frontend-web/src/core/i18n/locales/types.ts

@@ -383,11 +383,17 @@ export interface Translations {
       system: string;
       light: string;
       dark: string;
-      lightblue: string;
+      lightblue: string;
+      lightgreen: string;
+      iceblue: string;
+      lightyellow: string;
       systemDescription: string;
       lightDescription: string;
       darkDescription: string;
-      lightblueDescription: string;
+      lightblueDescription: string;
+      lightgreenDescription: string;
+      iceblueDescription: string;
+      lightyellowDescription: string;
       languageTitle: string;
       languageDescription: string;
     };

frontend-web/src/core/i18n/locales/zh-CN.ts

@@ -429,11 +429,17 @@ export const zhCN: Translations = {
       system: "系统",
       light: "浅色",
       dark: "深色",
-      lightblue: "浅蓝",
+      lightblue: "浅蓝",
+      lightgreen: "绿色",
+      iceblue: "冰川蓝",
+      lightyellow: "浅黄色",
       systemDescription: "自动跟随系统主题。",
       lightDescription: "更明亮的配色，适合日间使用。",
       darkDescription: "更暗的配色，减少眩光方便专注。",
-      lightblueDescription: "以蓝色为主色的清爽浅色配色。",
+      lightblueDescription: "以蓝色为主色的清爽浅色配色。",
+      lightgreenDescription: "采用 WeKnora 绿色的清爽浅色配色。",
+      iceblueDescription: "以 #9BCEF1 为主色，搭配冰蓝留白与沉稳交互色。",
+      lightyellowDescription: "以 #F3FBD9 为主色，搭配柔和浅黄留白与深橄榄交互色。",
       languageTitle: "语言",
       languageDescription: "在不同语言之间切换。",
     },

frontend-web/src/core/page-layout/chats-iframe-route.test.mjs

@@ -2,8 +2,13 @@ import assert from "node:assert/strict";
 import test from "node:test";
 
 import {
+  buildChatsIframeRedirectPath,
+  buildChatsIframeThreadPath,
+  isExplicitBrainyIframeMode,
   isChatsIframeWorkspacePath,
+  resolvePostLoginRedirectPath,
   resolveForcedThemeForPath,
+  resolveStandardChatFallback,
 } from "./chats-iframe-route.ts";
 
 test("matches only workspace chats_iframe routes", () => {
@@ -31,3 +36,164 @@ test("forces light theme for landing and chats_iframe routes only", () => {
   );
   assert.equal(resolveForcedThemeForPath("/page/workspace/chats/new"), undefined);
 });
+
+test("requires an explicit chatMode=iframe opt-in for the Brainy page", () => {
+  assert.equal(isExplicitBrainyIframeMode(""), false);
+  assert.equal(isExplicitBrainyIframeMode("?from=iframe"), false);
+  assert.equal(isExplicitBrainyIframeMode("?chatMode=full"), false);
+  assert.equal(isExplicitBrainyIframeMode("?chatMode=iframe"), true);
+  assert.equal(isExplicitBrainyIframeMode("chatMode=IFRAME"), true);
+});
+
+test("upgrades legacy iframe-source routes to the iframe protocol", () => {
+  assert.equal(
+    resolveStandardChatFallback(
+      "/page/workspace/chats_iframe/new",
+      "?from=iframe&hideChrome=1",
+    ),
+    "/page/workspace/chats_iframe/new?from=iframe&hideChrome=1&chatMode=iframe",
+  );
+});
+
+test("honors an explicit chat mode over the legacy iframe source", () => {
+  assert.equal(
+    resolveStandardChatFallback(
+      "/page/workspace/chats_iframe/new",
+      "?from=iframe&chatMode=full",
+    ),
+    "/page/workspace/chats/new?chatMode=full",
+  );
+});
+
+test("treats a blank chat mode as absent for the legacy iframe source", () => {
+  assert.equal(
+    resolveStandardChatFallback(
+      "/page/workspace/chats_iframe/new",
+      "?from=iframe&chatMode=%20%20",
+    ),
+    "/page/workspace/chats_iframe/new?from=iframe&chatMode=iframe",
+  );
+});
+
+test("redirects chats_iframe routes without the iframe source to standard full chat", () => {
+  assert.equal(
+    resolveStandardChatFallback(
+      "/page/workspace/chats_iframe/thread-123",
+      "?hideChrome=1",
+    ),
+    "/page/workspace/chats/thread-123?hideChrome=1&chatMode=full",
+  );
+  assert.equal(
+    resolveStandardChatFallback(
+      "/page/workspace/chats_iframe/new",
+      "?chatMode=iframe",
+    ),
+    null,
+  );
+  assert.equal(
+    resolveStandardChatFallback("/page/workspace/chats/new", ""),
+    null,
+  );
+});
+
+test("honors the dark-blue theme query on chats_iframe routes", () => {
+  assert.equal(
+    resolveForcedThemeForPath(
+      "/page/workspace/chats_iframe/new",
+      "?from=iframe&theme=dark-blue",
+    ),
+    "dark",
+  );
+  assert.equal(
+    resolveForcedThemeForPath(
+      "/page/workspace/chats_iframe/new",
+      "?from=iframe&theme=red",
+    ),
+    "light",
+  );
+});
+
+test("forces the iframe theme on the login route without changing normal login", () => {
+  assert.equal(
+    resolveForcedThemeForPath(
+      "/login",
+      "?from=iframe&theme=dark-blue",
+    ),
+    "dark",
+  );
+  assert.equal(
+    resolveForcedThemeForPath(
+      "/login/guest",
+      "?from=iframe&theme=dark-blue",
+    ),
+    "dark",
+  );
+  assert.equal(
+    resolveForcedThemeForPath("/login", "?theme=dark-blue"),
+    undefined,
+  );
+  assert.equal(
+    resolveForcedThemeForPath(
+      "/page/workspace/chats/new",
+      "?from=iframe&theme=dark-blue",
+    ),
+    undefined,
+  );
+});
+
+test("preserves the iframe theme in the post-login redirect", () => {
+  assert.equal(
+    buildChatsIframeRedirectPath("?from=iframe&theme=dark-blue"),
+    "/page/workspace/chats_iframe/new?from=iframe&chatMode=iframe&theme=dark-blue",
+  );
+  assert.equal(
+    buildChatsIframeRedirectPath("?from=iframe"),
+    "/page/workspace/chats_iframe/new?from=iframe&chatMode=iframe",
+  );
+  assert.equal(
+    buildChatsIframeRedirectPath(
+      "?from=iframe&theme=dark-blue&ticket=secret&authToken=secret",
+    ),
+    "/page/workspace/chats_iframe/new?from=iframe&chatMode=iframe&theme=dark-blue",
+  );
+});
+
+test("keeps the iframe redirect ahead of login-method fallbacks", () => {
+  assert.equal(
+    resolvePostLoginRedirectPath(
+      "?from=iframe&theme=dark-blue&yUserId=user-1",
+      "/page/workspace/chats/new",
+    ),
+    "/page/workspace/chats_iframe/new?from=iframe&chatMode=iframe&theme=dark-blue",
+  );
+  assert.equal(
+    resolvePostLoginRedirectPath("?yUserId=user-1", "/page/workspace/chats/new"),
+    "/page/workspace/chats/new",
+  );
+});
+
+test("preserves iframe theme when a new chat becomes a thread", () => {
+  assert.equal(
+    buildChatsIframeThreadPath(
+      "/page/workspace",
+      "thread-123",
+      "?from=iframe&theme=dark-blue&ticket=secret",
+    ),
+    "/page/workspace/chats_iframe/thread-123?from=iframe&chatMode=iframe&theme=dark-blue",
+  );
+});
+
+test("preserves explicit Brainy iframe mode and theme across redirects", () => {
+  assert.equal(
+    buildChatsIframeRedirectPath("?chatMode=iframe&theme=dark-blue&ticket=secret"),
+    "/page/workspace/chats_iframe/new?chatMode=iframe&theme=dark-blue",
+  );
+  assert.equal(
+    buildChatsIframeThreadPath(
+      "/page/workspace",
+      "thread-123",
+      "?chatMode=iframe&theme=dark-blue",
+    ),
+    "/page/workspace/chats_iframe/thread-123?chatMode=iframe&theme=dark-blue",
+  );
+});

frontend-web/src/core/page-layout/chats-iframe-route.ts

@@ -1,16 +1,141 @@
+import { resolveEmbedThemeMode } from "../embed/theme-mode.mjs";
+
+const CHATS_IFRAME_PATH = "/page/workspace/chats_iframe/new";
+const IFRAME_LOGIN_SOURCE = "iframe";
+
+function toSearchParams(search: string): URLSearchParams {
+  return new URLSearchParams(search.startsWith("?") ? search : `?${search}`);
+}
+
+export function isChatsIframeLogin(search: string): boolean {
+  return toSearchParams(search).get("from") === IFRAME_LOGIN_SOURCE;
+}
+
+/**
+ * Preserve only the presentation parameters consumed by the iframe workspace.
+ * Login credentials must never be copied into the post-login address bar.
+ */
+export function buildChatsIframeRedirectPath(search: string): string {
+  const source = toSearchParams(search);
+  const target = new URLSearchParams();
+
+  if (isChatsIframeLogin(search)) {
+    target.set("from", IFRAME_LOGIN_SOURCE);
+  }
+
+  const requestedMode = source.get("chatMode")?.trim();
+  if (requestedMode) {
+    target.set("chatMode", requestedMode);
+  } else if (isChatsIframeLogin(search)) {
+    // Plugin links historically identify this protocol with `from=iframe`.
+    // Normalize that legacy marker into the explicit mode before handing the
+    // URL to the workspace route, so it does not fall back to the full chat.
+    target.set("chatMode", "iframe");
+  }
+
+  const theme = source.get("theme")?.trim();
+  if (theme) {
+    target.set("theme", theme);
+  }
+
+  const query = target.toString();
+  return query ? `${CHATS_IFRAME_PATH}?${query}` : CHATS_IFRAME_PATH;
+}
+
+export function buildChatsIframeThreadPath(
+  routeBase: string,
+  threadId: string,
+  search: string,
+): string {
+  const base = routeBase.endsWith("/") ? routeBase.slice(0, -1) : routeBase;
+  const query = buildChatsIframeRedirectPath(search).split("?")[1];
+  const path = `${base}/chats_iframe/${encodeURIComponent(threadId)}`;
+  return query ? `${path}?${query}` : path;
+}
+
+export function resolvePostLoginRedirectPath(
+  search: string,
+  fallbackPath: string,
+): string {
+  return isChatsIframeLogin(search)
+    ? buildChatsIframeRedirectPath(search)
+    : fallbackPath;
+}
+
 export function isChatsIframeWorkspacePath(pathname: string): boolean {
   return (
-    pathname === "/page/workspace/chats_iframe/new" ||
+    pathname === CHATS_IFRAME_PATH ||
     pathname.startsWith("/page/workspace/chats_iframe/")
   );
 }
 
+/**
+ * The lightweight iframe page is a private transport for the Brainy
+ * postMessage protocol, not a general-purpose embedded chat page.
+ *
+ * Requiring an explicit mode prevents legacy `from=iframe` links, ordinary
+ * iframes and micro-frontend containers from accidentally landing on the
+ * protocol-only page.
+ */
+export function isExplicitBrainyIframeMode(search: string): boolean {
+  const normalizedSearch = search.startsWith("?") ? search.slice(1) : search;
+  return (
+    new URLSearchParams(normalizedSearch)
+      .get("chatMode")
+      ?.trim()
+      .toLowerCase() === "iframe"
+  );
+}
+
+/**
+ * Convert an accidental/legacy `chats_iframe` URL to the equivalent standard
+ * chat URL. Existing thread ids and unrelated query parameters are retained.
+ */
+export function resolveStandardChatFallback(
+  pathname: string,
+  search: string,
+): string | null {
+  if (!isChatsIframeWorkspacePath(pathname) || isExplicitBrainyIframeMode(search)) {
+    return null;
+  }
+
+  const normalizedSearch = search.startsWith("?") ? search.slice(1) : search;
+  const params = new URLSearchParams(normalizedSearch);
+  const requestedMode = params.get("chatMode")?.trim();
+  if (isChatsIframeLogin(search) && !requestedMode) {
+    params.set("chatMode", "iframe");
+    const targetSearch = params.toString();
+    return targetSearch ? `${pathname}?${targetSearch}` : pathname;
+  }
+
+  const routePrefix = "/page/workspace/chats_iframe/";
+  const routeSuffix = pathname.slice(routePrefix.length);
+  const targetPath =
+    routeSuffix && routeSuffix !== "new"
+      ? `/page/workspace/chats/${routeSuffix}`
+      : "/page/workspace/chats/new";
+  params.delete("from");
+  params.set("chatMode", "full");
+  const targetSearch = params.toString();
+  return targetSearch ? `${targetPath}?${targetSearch}` : targetPath;
+}
+
 export function resolveForcedThemeForPath(
   pathname: string,
-): "light" | undefined {
+  search = "",
-  if (pathname === "/landing" || isChatsIframeWorkspacePath(pathname)) {
+): "light" | "dark" | undefined {
+  if (pathname === "/landing") {
     return "light";
   }
 
+  const isLoginPath = pathname === "/login" || pathname.startsWith("/login/");
+  if (
+    isChatsIframeWorkspacePath(pathname) ||
+    (isLoginPath && isChatsIframeLogin(search))
+  ) {
+    const rawTheme = toSearchParams(search).get("theme")?.trim();
+    return rawTheme ? resolveEmbedThemeMode(rawTheme) : "light";
+  }
+
   return undefined;
 }

frontend-web/src/core/page-layout/sidebar-menu.ts

@@ -65,6 +65,12 @@ export const sidebarMenuItems: MenuItem[] = [
         icon: Users,
         path: "/page/strategy/qa/multi-agent-roundtable",
       },
+      // {
+      //   id: "position-roundtable",
+      //   label: "岗位会商",
+      //   icon: Briefcase,
+      //   path: "/page/strategy/qa/position-roundtable",
+      // },
       {
         id: "dashboard-agent",
         label: "大屏绘制",
@@ -80,6 +86,12 @@ export const sidebarMenuItems: MenuItem[] = [
       },
       { id: "qa-zzxd", label: "XD应用", icon: Layout, path: "/page/strategy/qa/zzxd" },
       { id: "qa-research", label: "课题研究", icon: FileText, path: "/page/canvas/ai-writing" },
+      {
+        id: "qa-research-chat",
+        label: "课题研究(对话版)",
+        icon: FileText,
+        path: "/page/canvas/ai-writing-chat",
+      },
     ],
   },
   {

frontend-web/src/core/sensitive-words/use-display-desensitizer.ts

@@ -0,0 +1,19 @@
+import { useMemo } from "react";
+
+import { desensitize, makeDesensitizer } from "@/lib/desensitize";
+import { useSensitiveWords, wordsToMap } from "@/strategy-components/api/sensitive-words";
+
+/**
+ * 返回用于界面静态文本的脱敏函数。
+ *
+ * 与导航菜单使用同一份敏感词查询：后台存在配置时以后台为准，未配置时回退到内置种子。
+ * Hook 订阅 React Query 缓存，管理员保存敏感词后，使用它的导航/欢迎区会自动重新渲染。
+ */
+export function useDisplayDesensitizer(): (text: string) => string {
+  const { data: words = [] } = useSensitiveWords();
+
+  return useMemo(
+    () => (words.length > 0 ? makeDesensitizer(wordsToMap(words)) : desensitize),
+    [words],
+  );
+}

frontend-web/src/core/strategy/external-links.ts

@@ -1,14 +1,15 @@
 /** Strategy 模块外部 iframe / 嵌入页链接（来自 Vite 环境变量） */
 
 import { authStorageGet } from "@/core/auth/scoped-storage";
-import { normalizeExternalAccessToken } from "@/core/auth/external-access-token";
+import { readCurrentExternalAccessTokenValue } from "@/core/auth/external-access-token";
+import { readRuntimeEnv } from "@/env";
 
 function trimTrailingSlash(url: string): string {
   return url.replace(/\/+$/, "");
 }
 
 function readEnv(key: string): string {
-  const value = import.meta.env[key];
+  const value = readRuntimeEnv(key);
   return typeof value === "string" ? value.trim() : "";
 }
 
@@ -44,7 +45,7 @@ function readUserInfo(): Record<string, unknown> {
 
 /** 当前登录态 accessToken（无则空串）。 */
 export function getAccessToken(): string {
-  return normalizeExternalAccessToken(readUserInfo().accessToken);
+  return readCurrentExternalAccessTokenValue(readUserInfo());
 }
 
 /**

frontend-web/src/core/system-settings/api.ts

@@ -276,15 +276,68 @@ export async function updatePublishSquares(
   return data;
 }
 
-export type ThemeMode = "light" | "dark" | "lightblue";
+export const BUILTIN_THEME_IDS = [
+  "light",
+  "dark",
+  "lightblue",
+  "lightgreen",
+  "iceblue",
+  "lightyellow",
+] as const;
+
+export type BuiltinThemeId = (typeof BUILTIN_THEME_IDS)[number];
+export type ThemeMode = BuiltinThemeId | `custom-theme-${string}`;
+export type CustomThemeBaseMode = "light" | "dark";
+
+export interface CustomThemeColorOverrides {
+  button_hover?: string | null;
+  selected_background?: string | null;
+  border?: string | null;
+  muted?: string | null;
+  muted_text?: string | null;
+  destructive?: string | null;
+  brand_title?: string | null;
+  primary_foreground?: string | null;
+}
+
+export interface CustomThemePreset {
+  id: `custom-theme-${string}`;
+  name: string;
+  primary: string;
+  text_color?: string | null;
+  mode: CustomThemeBaseMode;
+  overrides?: CustomThemeColorOverrides;
+  enabled: boolean;
+  sort_order: number;
+}
 export type ViewMode = "card" | "list";
 export type LayoutMode = "full" | "compact";
+export type CompactShortcutParamType = "login" | "theme";
+
+export interface CompactShortcutRouteParam {
+  key: string;
+  paramType: CompactShortcutParamType;
+  source?: string | null;
+  customValue?: string | null;
+  themeValue?: string | null;
+}
+
+export interface CompactShortcutButton {
+  id: string;
+  label: string;
+  url: string;
+  route_params: CompactShortcutRouteParam[];
+  enabled: boolean;
+  sort_order: number;
+}
 
 export interface AppearanceSettings {
   default_theme: ThemeMode;
   default_skill_view: ViewMode;
   default_agent_view: ViewMode;
   default_layout_mode: LayoutMode;
+  compact_shortcut_buttons: CompactShortcutButton[];
+  custom_themes: CustomThemePreset[];
 }
 
 export interface AppearanceUpdate {
@@ -292,6 +345,8 @@ export interface AppearanceUpdate {
   default_skill_view?: ViewMode;
   default_agent_view?: ViewMode;
   default_layout_mode?: LayoutMode;
+  compact_shortcut_buttons?: CompactShortcutButton[];
+  custom_themes?: CustomThemePreset[];
 }
 
 export async function loadAppearanceSettings(): Promise<AppearanceSettings> {

frontend-web/src/core/system-settings/hooks.ts

@@ -111,10 +111,13 @@ export function useUpdatePublishSquares() {
   });
 }
 
-export function useAppearanceSettings() {
+export function useAppearanceSettings(
+  { enabled = true }: { enabled?: boolean } = {},
+) {
   return useQuery({
     queryKey: APPEARANCE_KEY,
     queryFn: () => loadAppearanceSettings(),
+    enabled,
     staleTime: 60_000,
     refetchOnWindowFocus: false,
     // The provider runs even on the login page (where the user has no auth)

frontend-web/src/core/theme/custom-theme.ts

@@ -0,0 +1,284 @@
+import type {
+  CustomThemeColorOverrides,
+  CustomThemePreset,
+} from "@/core/system-settings/api";
+
+export const CUSTOM_THEME_PREFIX = "custom-theme-";
+
+type Rgb = { r: number; g: number; b: number };
+
+const HEX_COLOR = /^#[0-9a-f]{6}$/i;
+const WHITE: Rgb = { r: 255, g: 255, b: 255 };
+const BLACK: Rgb = { r: 0, g: 0, b: 0 };
+
+export const CUSTOM_THEME_ADVANCED_KEYS = [
+  "button_hover",
+  "selected_background",
+  "border",
+  "muted",
+  "muted_text",
+  "destructive",
+  "brand_title",
+  "primary_foreground",
+] as const;
+
+export type CustomThemeAdvancedKey = (typeof CUSTOM_THEME_ADVANCED_KEYS)[number];
+
+export type CustomThemeTokenInput = Pick<
+  CustomThemePreset,
+  "primary" | "mode"
+> &
+  Partial<Pick<CustomThemePreset, "text_color" | "overrides">>;
+
+export function isCustomThemeId(value: string | null | undefined): value is `custom-theme-${string}` {
+  return typeof value === "string" && value.startsWith(CUSTOM_THEME_PREFIX);
+}
+
+export function normalizeHexColor(value: string, fallback = "#0062D9"): string {
+  const normalized = value.trim().toUpperCase();
+  return HEX_COLOR.test(normalized) ? normalized : fallback;
+}
+
+function optionalHexColor(value: string | null | undefined): string | undefined {
+  if (!value?.trim() || !HEX_COLOR.test(value.trim())) return undefined;
+  return value.trim().toUpperCase();
+}
+
+function toRgb(value: string): Rgb {
+  const hex = normalizeHexColor(value).slice(1);
+  return {
+    r: Number.parseInt(hex.slice(0, 2), 16),
+    g: Number.parseInt(hex.slice(2, 4), 16),
+    b: Number.parseInt(hex.slice(4, 6), 16),
+  };
+}
+
+function toHex({ r, g, b }: Rgb): string {
+  const channel = (value: number) => Math.round(Math.min(255, Math.max(0, value))).toString(16).padStart(2, "0");
+  return `#${channel(r)}${channel(g)}${channel(b)}`.toUpperCase();
+}
+
+function mix(from: Rgb, to: Rgb, amount: number): Rgb {
+  const ratio = Math.min(1, Math.max(0, amount));
+  return {
+    r: from.r + (to.r - from.r) * ratio,
+    g: from.g + (to.g - from.g) * ratio,
+    b: from.b + (to.b - from.b) * ratio,
+  };
+}
+
+function relativeLuminance({ r, g, b }: Rgb): number {
+  const linear = [r, g, b].map((channel) => {
+    const value = channel / 255;
+    return value <= 0.03928 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;
+  });
+  return 0.2126 * linear[0]! + 0.7152 * linear[1]! + 0.0722 * linear[2]!;
+}
+
+function contrastRatio(a: Rgb, b: Rgb): number {
+  const [lighter, darker] = [relativeLuminance(a), relativeLuminance(b)].sort((x, y) => y - x);
+  return (lighter! + 0.05) / (darker! + 0.05);
+}
+
+function readableForeground(background: Rgb): string {
+  return contrastRatio(background, BLACK) >= contrastRatio(background, WHITE) ? "#172033" : "#FFFFFF";
+}
+
+function ensureContrast(color: Rgb, background: Rgb, toward: Rgb, minimum = 4.5): Rgb {
+  let candidate = color;
+  for (let step = 1; step <= 10 && contrastRatio(candidate, background) < minimum; step += 1) {
+    candidate = mix(candidate, toward, 0.18);
+  }
+  return candidate;
+}
+
+function rgbChannels(color: Rgb): string {
+  return `${Math.round(color.r)} ${Math.round(color.g)} ${Math.round(color.b)}`;
+}
+
+/**
+ * Produce the semantic CSS tokens consumed by Tailwind/shadcn and TDesign.
+ * Inputs are restricted to a safe six-digit primary colour, optional primary
+ * button text colour, a small set of interaction overrides and a light/dark surface
+ * family, so callers never interpolate arbitrary CSS values.
+ */
+export function getCustomThemeTokens(theme: CustomThemeTokenInput): Record<string, string> {
+  const primary = toRgb(theme.primary);
+  const isDark = theme.mode === "dark";
+  const overrides: CustomThemeColorOverrides = theme.overrides ?? {};
+  const background = isDark ? mix({ r: 13, g: 19, b: 32 }, primary, 0.12) : mix(WHITE, primary, 0.035);
+  const card = isDark ? mix({ r: 18, g: 27, b: 44 }, primary, 0.12) : WHITE;
+  // Normal page copy stays automatic so selecting white for a teal/blue
+  // action does not accidentally make a light-page's body text white.
+  const preferredForeground = toRgb(isDark ? "#F4F7FB" : "#202A3A");
+  const foregroundRgb = ensureContrast(
+    preferredForeground,
+    background,
+    toRgb(readableForeground(background)),
+  );
+  const foreground = toHex(foregroundRgb);
+  const defaultMutedForeground = toRgb(isDark ? "#AAB4C2" : "#667085");
+  const mutedForegroundRgb = optionalHexColor(overrides.muted_text)
+    ? ensureContrast(
+        toRgb(overrides.muted_text!),
+        background,
+        toRgb(readableForeground(background)),
+        3,
+      )
+    : defaultMutedForeground;
+  const mutedForeground = toHex(mutedForegroundRgb);
+  const defaultAccent = isDark ? mix(background, primary, 0.3) : mix(WHITE, primary, 0.14);
+  const accent = optionalHexColor(overrides.selected_background)
+    ? toRgb(overrides.selected_background!)
+    : defaultAccent;
+  const accentHover = isDark ? mix(accent, primary, 0.2) : mix(accent, primary, 0.14);
+  const defaultBorder = isDark ? mix(background, WHITE, 0.16) : mix(WHITE, primary, 0.28);
+  const border = optionalHexColor(overrides.border) ? toRgb(overrides.border!) : defaultBorder;
+  const input = isDark ? mix(background, WHITE, 0.22) : mix(WHITE, primary, 0.38);
+  const action = ensureContrast(
+    mix(primary, isDark ? WHITE : BLACK, isDark ? 0.2 : 0.3),
+    isDark ? background : WHITE,
+    isDark ? WHITE : BLACK,
+  );
+  const actionHover = isDark ? mix(action, WHITE, 0.12) : mix(action, BLACK, 0.12);
+  const actionActive = isDark ? mix(action, WHITE, 0.22) : mix(action, BLACK, 0.22);
+  const defaultPrimaryHover = isDark ? mix(primary, WHITE, 0.1) : mix(primary, BLACK, 0.1);
+  const primaryHover = optionalHexColor(overrides.button_hover)
+    ? toRgb(overrides.button_hover!)
+    : defaultPrimaryHover;
+  const primaryActive = isDark ? mix(primary, WHITE, 0.2) : mix(primary, BLACK, 0.2);
+  const primaryForeground = optionalHexColor(overrides.primary_foreground) ?? readableForeground(primary);
+  const buttonForeground = optionalHexColor(theme.text_color) ?? primaryForeground;
+  const brandTitle = optionalHexColor(overrides.brand_title) ?? foreground;
+  const defaultSecondary = isDark ? mix(background, WHITE, 0.08) : mix(WHITE, primary, 0.075);
+  const secondary = optionalHexColor(overrides.muted) ? toRgb(overrides.muted!) : defaultSecondary;
+  const sidebar = isDark ? mix(background, BLACK, 0.08) : mix(WHITE, primary, 0.018);
+  const ring = rgbChannels(primary);
+  const destructive = optionalHexColor(overrides.destructive) ?? (isDark ? "#FF777B" : "#CF4A4A");
+  const primaryHex = toHex(primary);
+  const actionHex = toHex(action);
+  const actionHoverHex = toHex(actionHover);
+  const actionActiveHex = toHex(actionActive);
+  const accentHex = toHex(accent);
+  const accentHoverHex = toHex(accentHover);
+  const backgroundHex = toHex(background);
+  const cardHex = toHex(card);
+  const borderHex = toHex(border);
+  const inputHex = toHex(input);
+  const secondaryHex = toHex(secondary);
+  const primaryHoverHex = toHex(primaryHover);
+  const primaryActiveHex = toHex(primaryActive);
+  const sidebarHex = toHex(sidebar);
+
+  return {
+    "--workspace-brand": primaryHex,
+    "--workspace-brand-foreground": primaryForeground,
+    "--brand-200": accentHex,
+    "--brand-900": actionHex,
+    "--brand-950": actionActiveHex,
+    "--theme-button-hover": primaryHoverHex,
+    "--theme-selected-background": accentHex,
+    "--background": backgroundHex,
+    "--foreground": foreground,
+    "--card": cardHex,
+    "--card-foreground": foreground,
+    "--popover": cardHex,
+    "--popover-foreground": foreground,
+    "--primary": primaryHex,
+    "--primary-foreground": primaryForeground,
+    "--button-foreground": buttonForeground,
+    "--brand-title-foreground": brandTitle,
+    "--secondary": secondaryHex,
+    "--secondary-foreground": actionHex,
+    "--muted": secondaryHex,
+    "--muted-foreground": mutedForeground,
+    "--accent": accentHex,
+    "--accent-foreground": actionHex,
+    "--destructive": destructive,
+    "--border": borderHex,
+    "--input": inputHex,
+    "--ring": `rgb(${ring} / 0.48)`,
+    "--chart-1": actionHex,
+    "--chart-2": toHex(mix(primary, { r: 20, g: 145, b: 150 }, 0.45)),
+    "--chart-3": toHex(mix(primary, { r: 108, g: 96, b: 175 }, 0.45)),
+    "--chart-4": toHex(mix(primary, { r: 220, g: 137, b: 54 }, 0.45)),
+    "--chart-5": toHex(mix(primary, { r: 57, g: 139, b: 110 }, 0.45)),
+    "--sidebar": sidebarHex,
+    "--sidebar-foreground": foreground,
+    "--sidebar-primary": primaryHex,
+    "--sidebar-primary-foreground": primaryForeground,
+    "--sidebar-accent": accentHex,
+    "--sidebar-accent-foreground": actionHex,
+    "--sidebar-border": borderHex,
+    "--sidebar-ring": `rgb(${ring} / 0.48)`,
+    "--legacy-accent-rgb": rgbChannels(accent),
+    "--legacy-background-rgb": rgbChannels(background),
+    "--legacy-border-rgb": rgbChannels(border),
+    "--legacy-brand-200-rgb": rgbChannels(accent),
+    "--legacy-card-rgb": rgbChannels(card),
+    "--legacy-destructive-rgb": rgbChannels(toRgb(destructive)),
+    "--legacy-foreground-rgb": rgbChannels(foregroundRgb),
+    "--legacy-input-rgb": rgbChannels(input),
+    "--legacy-muted-rgb": rgbChannels(secondary),
+    "--legacy-muted-foreground-rgb": rgbChannels(mutedForegroundRgb),
+    "--legacy-primary-rgb": rgbChannels(primary),
+    "--legacy-primary-foreground-rgb": rgbChannels(toRgb(primaryForeground)),
+    "--legacy-ring-rgb": ring,
+    "--legacy-secondary-rgb": rgbChannels(secondary),
+    "--legacy-sidebar-accent-rgb": rgbChannels(accent),
+    "--legacy-sidebar-border-rgb": rgbChannels(border),
+    "--legacy-sidebar-foreground-rgb": rgbChannels(foregroundRgb),
+    "--legacy-workspace-brand-rgb": rgbChannels(primary),
+    "--td-brand-color-1": backgroundHex,
+    "--td-brand-color-2": secondaryHex,
+    "--td-brand-color-3": accentHex,
+    "--td-brand-color-4": accentHoverHex,
+    "--td-brand-color-5": primaryHex,
+    "--td-brand-color-6": primaryHex,
+    "--td-brand-color-7": actionHex,
+    "--td-brand-color-8": actionHoverHex,
+    "--td-brand-color-9": actionActiveHex,
+    "--td-brand-color-10": actionActiveHex,
+    "--td-brand-color": primaryHex,
+    "--td-brand-color-hover": primaryHoverHex,
+    "--td-brand-color-focus": accentHex,
+    "--td-brand-color-active": primaryActiveHex,
+    "--td-brand-color-disabled": accentHoverHex,
+    "--td-brand-color-light": accentHex,
+    "--td-brand-color-light-hover": accentHoverHex,
+    "--td-text-color-primary": foreground,
+    "--td-text-color-secondary": mutedForeground,
+    "--td-text-color-brand": actionHex,
+    "--td-text-color-link": actionHex,
+    "--td-text-color-anti": buttonForeground,
+    "--td-bg-color-page": backgroundHex,
+    "--td-bg-color-container": cardHex,
+    "--td-bg-color-container-hover": secondaryHex,
+    "--td-bg-color-container-active": accentHex,
+    "--td-bg-color-secondarycontainer": secondaryHex,
+    "--td-bg-color-secondarycontainer-hover": accentHex,
+    "--td-bg-color-secondarycontainer-active": accentHoverHex,
+    "--td-border-level-1-color": borderHex,
+    "--td-component-stroke": borderHex,
+    "--td-border-level-2-color": inputHex,
+    "--td-component-border": inputHex,
+  };
+}
+
+/** Tokens produced from the automatic palette only, used by the editor to
+ * show which advanced values are currently inheriting from the system. */
+export function getCustomThemeAutomaticTokens(
+  theme: Pick<CustomThemePreset, "primary" | "mode">,
+): Record<string, string> {
+  return getCustomThemeTokens(theme);
+}
+
+export function customThemeContrast(primary: string): number {
+  const color = toRgb(primary);
+  return Math.max(contrastRatio(color, BLACK), contrastRatio(color, WHITE));
+}
+
+export function customThemeTextContrast(theme: CustomThemeTokenInput): number {
+  const tokens = getCustomThemeTokens(theme);
+  return contrastRatio(toRgb(tokens["--button-foreground"]!), toRgb(tokens["--primary"]!));
+}