sync update from LAN repo (source master-yx @ cf505220)

Newer vLLM parsers put CoT in reasoning; older builds and DeepSeek still use reasoning_content. Canonicalize to the UI field and echo only the original wire field so other ChatOpenAI models stay unchanged. Point qwen3.6 at VllmChatModel.

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

.gitignore

@@ -88,21 +88,25 @@ skills/
 hermes-agent-main/
 .gitignore
 offline-backend-20260512/backend/tests/*
-# Keep the openGauss URL/dialect/schema compatibility regression coverage versioned.
-!offline-backend-20260512/backend/tests/test_gauss_database.py
+# Keep the openGauss URL/dialect/schema compatibility regression coverage versioned.
+!offline-backend-20260512/backend/tests/test_gauss_database.py
 !offline-backend-20260512/backend/tests/test_llmwiki_weknora.py
-!offline-backend-20260512/backend/tests/test_llmwiki_knowledge_management.py
+!offline-backend-20260512/backend/tests/test_llmwiki_knowledge_management.py
 !offline-backend-20260512/backend/tests/test_health_auth_bypass.py
 # Keep formal Word OOXML and embedded-font regression coverage versioned.
 !offline-backend-20260512/backend/tests/test_word_export.py
-# Keep generated-file library aggregation and filtering regression coverage versioned.
-!offline-backend-20260512/backend/tests/test_artifact_library.py
+# Keep generated-file library aggregation and filtering regression coverage versioned.
+!offline-backend-20260512/backend/tests/test_artifact_library.py
 # Keep the model configuration regression coverage versioned even though
 # this deployment repository otherwise ignores newly added backend tests.
 !offline-backend-20260512/backend/tests/test_model_management.py
-# Keep the forced-research agent runtime gate and sandbox-policy regressions versioned.
-!offline-backend-20260512/backend/tests/test_forced_research_agent.py
-# Keep fixed-question exact-match and streaming regression coverage versioned.
+# Keep vLLM reasoning/reasoning_content field compatibility regressions versioned.
+!offline-backend-20260512/backend/tests/test_reasoning_fields.py
+# Keep the forced-research agent runtime gate and sandbox-policy regressions versioned.
+!offline-backend-20260512/backend/tests/test_forced_research_agent.py
+# Keep strategy-selection built-in agent seed and safety-contract regressions versioned.
+!offline-backend-20260512/backend/tests/test_strategy_selection_seed.py
+# Keep fixed-question exact-match and streaming regression coverage versioned.
 !offline-backend-20260512/backend/tests/test_fixed_questions.py
 # Keep configurable es_query system-prompt routing regression coverage versioned.
 !offline-backend-20260512/backend/tests/test_es_query_routing_prompt.py
@@ -110,6 +114,7 @@ offline-backend-20260512/backend/tests/*
 !offline-backend-20260512/backend/tests/test_llmwiki_local_index_repository.py
 !offline-backend-20260512/backend/tests/test_llmwiki_vector_search.py
 !offline-backend-20260512/backend/tests/test_llmwiki_wiki_sync.py
+!offline-backend-20260512/backend/tests/test_llmwiki_encoder_runtime.py
 !offline-backend-20260512/backend/tests/test_external_llmwiki_search.py
 !offline-backend-20260512/backend/tests/test_llmwiki_wiki_retrieval.py
 !offline-backend-20260512/backend/tests/test_public_llmwiki_embed.py
@@ -176,10 +181,10 @@ docs/backups
 # Frontend skills components must be tracked (excluded from the broad skills/ ignore above)
 !frontend-web/src/components/workspace/skills/
 
-# uv lockfile (not tracked per project preference)
-offline-backend-20260512/backend/uv.lock
-
-!offline-backend-20260512/backend/tests/test_wiki_package_roundtrip.py
+# uv lockfile (not tracked per project preference)
+offline-backend-20260512/backend/uv.lock
+
+!offline-backend-20260512/backend/tests/test_wiki_package_roundtrip.py
 
 # Local-only scratch directory (not committed)
 0622/

CLAUDE.md

@@ -83,6 +83,7 @@ The frontend (`frontend-web/`) is a React 19 + Vite SPA:
 - **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`.
+- **策略优选**: route `/page/strategy/qa/strategy-selection`, sidebar 「问答管理 → 策略优选」. The standalone `src/strategy-selection/` workbench has two horizontal split stages: Step 1 keeps intent-understanding conversation cards on the left and an editable task draft plus angle selection on the right; Step 2 keeps multiplexed parallel strategy cards and automatic judging on the left while the right stays dedicated to the selected-strategy basket and final Markdown synthesis. It consumes the existing `POST /api/parallel-agents/run/stream` protocol, isolates output by stable agent id, supports expanded per-agent dialogs, user selection, Markdown editing/copy/download, and shared server-side DOCX export. A clearly marked neutral Taiwan-Strait risk-management demo is loaded by default for offline UI acceptance. Administrators can edit the SOUL and skills of the nine built-in functional agents through the page dialog; the backend seeds `strategy-selection-{intent,angle-*,judge,solution}` only when their directories are missing, preserving later admin changes. Pure parsing/SSE tests live in `src/strategy-selection/lib.test.ts`; backend seed tests live in `tests/test_strategy_selection_seed.py`.
 - **轻应用中心 (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). **简介模式** left-nav is a separate overlay: `/api/compact-menu-overrides` stores two independent sets (type `A` / `B`); each website picks one via `runtime-config.js` `VITE_COMPACT_MENU_TYPE`.
 - **白名单管理 (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

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

frontend-web/.env.example

@@ -59,6 +59,9 @@
 # 简介模式左侧菜单类型：与菜单管理页「简介模式」的类型 A / B 对应。两套网页分别填 A 或 B。
 # 不填或留空时按类型 A，继续使用原来的简介菜单数据。
 # VITE_COMPACT_MENU_TYPE=A
+# 问答页「极速」模式：true=在模式菜单显示并直连大模型；false 或未设=隐藏。
+# 部署后优先改 dist/runtime-config.js 的 VITE_TURBO_MODE_VISIBLE，刷新即可。
+# VITE_TURBO_MODE_VISIBLE=false
 # VITE_GITHUB_OAUTH_TOKEN=
 
 # --- 官方 DeerFlow 风格页面入口（仅 Vite，不引入 Next.js）---

frontend-web/public/runtime-config.js

@@ -151,6 +151,11 @@ window.__CM_RUNTIME_CONFIG__ = {
   // GitHub OAuth Token；不使用 GitHub 相关能力时留空。
   VITE_GITHUB_OAUTH_TOKEN: "",
 
+  // 是否在问答输入框「模式」菜单显示「极速」："true" 显示，"false" 隐藏。
+  // 默认关闭。开启后可直连大模型流式问答，不走智能体工具与技能。
+  // 部署后改 dist/runtime-config.js 再刷新页面即可，无需重新打包。
+  VITE_TURBO_MODE_VISIBLE: "true",
+
   // 是否在智能体管理页显示「舆情分析」类型："true" 显示，"false" 隐藏。
   // 关闭后，该智能体的专用对话地址也会自动跳回智能体管理页。
   VITE_SENTIMENT_AGENT_VISIBLE: "true",

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

@@ -51,6 +51,10 @@ import {
   SelectValue,
 } from "@/components/ui/select";
 import { ShareConversationDialog } from "@/components/workspace/thread-share-dialogs";
+import {
+  MyProjectThreadBadge,
+  MyProjectThreadIcon,
+} from "@/components/workspace/my-project-thread-indicator";
 import { useTheme } from "@/contexts/ThemeContext";
 import { useAgentsPaginated } from "@/core/agents";
 import { getAPIClient } from "@/core/api";
@@ -69,6 +73,7 @@ import {
   useToggleThreadPin,
 } from "@/core/threads/hooks";
 import type { AgentThread, AgentThreadState } from "@/core/threads/types";
+import { myProjectConversationTypeOfThread } from "@/core/threads/project-metadata";
 import {
   bootstrapResumePath,
   isBootstrapThread,
@@ -479,6 +484,7 @@ function RecentChatsPane({ activeAgentId }: { activeAgentId?: string }) {
         ) : (
           filteredThreads.map((thread) => {
             const isBoot = isBootstrapThread(thread);
+            const projectType = myProjectConversationTypeOfThread(thread);
             const href = isBoot ? bootstrapResumePath(thread.thread_id) : pathOf(thread);
             const isActive = href === pathname;
             const pinned = isThreadPinned(thread);
@@ -505,6 +511,8 @@ function RecentChatsPane({ activeAgentId }: { activeAgentId?: string }) {
                       )}
                       aria-label="智能体创建会话"
                     />
+                  ) : projectType ? (
+                    <MyProjectThreadIcon type={projectType} />
                   ) : (
                     <MessageSquare
                       className={cn(
@@ -516,9 +524,15 @@ function RecentChatsPane({ activeAgentId }: { activeAgentId?: string }) {
                   {pinned && (
                     <Pin className="text-muted-foreground/70 size-3 shrink-0" />
                   )}
-                  <span className="truncate">
+                  <span className="min-w-0 flex-1 truncate">
                     {desensitize(titleOfThread(thread, t.pages.newChat))}
                   </span>
+                  {projectType && (
+                    <MyProjectThreadBadge
+                      className="mr-4"
+                      type={projectType}
+                    />
+                  )}
                   {isActive && (
                     <span className="absolute top-1/2 right-1 h-5 w-1 -translate-y-1/2 rounded-full bg-primary" />
                   )}

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

@@ -4,7 +4,12 @@ import { MessageSquareIcon } from "lucide-react";
 import Link from "next/link";
 import { usePathname } from "next/navigation";
 
+import {
+  MyProjectThreadBadge,
+  MyProjectThreadIcon,
+} from "@/components/workspace/my-project-thread-indicator";
 import { useThreadsPage } from "@/core/threads/hooks";
+import { myProjectConversationTypeOfThread } from "@/core/threads/project-metadata";
 import { pathOfThread, titleOfThread, isHiddenFromRecentChats, isBootstrapThread } from "@/core/threads/utils";
 import { desensitize } from "@/lib/desensitize";
 import { cn } from "@/lib/utils";
@@ -45,6 +50,7 @@ export function AgentRecentChats({ agentId }: { agentId: string }) {
           {threads.map((thread) => {
             const href = pathOfThread(thread);
             const isActive = href === pathname;
+            const projectType = myProjectConversationTypeOfThread(thread);
             return (
               <Link
                 key={thread.thread_id}
@@ -57,15 +63,20 @@ export function AgentRecentChats({ agentId }: { agentId: string }) {
                     : "text-muted-foreground hover:bg-accent hover:text-foreground",
                 )}
               >
-                <MessageSquareIcon
-                  className={cn(
-                    "size-3.5 shrink-0",
-                    isActive ? "text-primary" : "text-muted-foreground/70",
-                  )}
-                />
-                <span className="truncate">
+                {projectType ? (
+                  <MyProjectThreadIcon type={projectType} />
+                ) : (
+                  <MessageSquareIcon
+                    className={cn(
+                      "size-3.5 shrink-0",
+                      isActive ? "text-primary" : "text-muted-foreground/70",
+                    )}
+                  />
+                )}
+                <span className="min-w-0 flex-1 truncate">
                   {desensitize(titleOfThread(thread, "新对话"))}
                 </span>
+                {projectType && <MyProjectThreadBadge type={projectType} />}
               </Link>
             );
           })}

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

@@ -60,6 +60,10 @@ import {
 } from "@/components/ui/dropdown-menu";
 import { Input } from "@/components/ui/input";
 import { ShareConversationDialog } from "@/components/workspace/thread-share-dialogs";
+import {
+  MyProjectThreadBadge,
+  MyProjectThreadIcon,
+} from "@/components/workspace/my-project-thread-indicator";
 import { useAgentsPaginated, type Agent } from "@/core/agents";
 import { getAPIClient } from "@/core/api";
 import { useI18n } from "@/core/i18n/hooks";
@@ -75,6 +79,7 @@ import {
   useToggleThreadPin,
 } from "@/core/threads/hooks";
 import type { AgentThread, AgentThreadState } from "@/core/threads/types";
+import { myProjectConversationTypeOfThread } from "@/core/threads/project-metadata";
 import {
   isBootstrapThread,
   isHiddenFromRecentChats,
@@ -483,6 +488,7 @@ export function GeneralQaSidebar() {
                     );
                     const isActive = href === pathname;
                     const isBoot = isBootstrapThread(thread);
+                    const projectType = myProjectConversationTypeOfThread(thread);
                     const pinned = isThreadPinned(thread);
                     const favorited = isThreadFavorite(thread);
                     return (
@@ -507,6 +513,8 @@ export function GeneralQaSidebar() {
                               )}
                               aria-label="智能体创建会话"
                             />
+                          ) : projectType ? (
+                            <MyProjectThreadIcon type={projectType} />
                           ) : (
                             <MessageSquare
                               className={cn(
@@ -518,9 +526,15 @@ export function GeneralQaSidebar() {
                           {pinned && (
                             <Pin className="size-3 shrink-0 text-muted-foreground/70" />
                           )}
-                          <span className="truncate">
+                          <span className="min-w-0 flex-1 truncate">
                             {desensitize(titleOfThread(thread, t.pages.newChat))}
                           </span>
+                          {projectType && (
+                            <MyProjectThreadBadge
+                              className="mr-4"
+                              type={projectType}
+                            />
+                          )}
                           {isActive && (
                             <span className="absolute top-1/2 right-1 h-5 w-1 -translate-y-1/2 rounded-full bg-primary" />
                           )}

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

@@ -7,6 +7,7 @@ import {
   CheckIcon,
   FileTextIcon,
   FolderTreeIcon,
+  GaugeIcon,
   GraduationCapIcon,
   LightbulbIcon,
   PaperclipIcon,
@@ -68,6 +69,7 @@ import { isHiddenFromUIMessage } from "@/core/messages/utils";
 import { useModels } from "@/core/models/hooks";
 import type { Model } from "@/core/models/types";
 import type { AgentThreadContext } from "@/core/threads";
+import { isTurboModeVisible } from "@/core/threads/use-direct-chat";
 import { textOfMessage } from "@/core/threads/utils";
 import { desensitize } from "@/lib/desensitize";
 import { cn } from "@/lib/utils";
@@ -93,14 +95,14 @@ import {
 
 import { useRecommendedQuestions } from "@/core/recommended-questions/hooks";
 import { useUserPreferences } from "@/core/user-preferences";
-import {
-  isThreadRagModeLocked,
-  lockThreadRagMode,
-  useLocalSettings,
-} from "@/core/settings";
-import { useCitationDisplaySettings } from "@/core/system-settings/hooks";
-
-import { CustomPromptBar } from "./custom-prompt-menu";
+import {
+  isThreadRagModeLocked,
+  lockThreadRagMode,
+  useLocalSettings,
+} from "@/core/settings";
+import { useCitationDisplaySettings } from "@/core/system-settings/hooks";
+
+import { CustomPromptBar } from "./custom-prompt-menu";
 import { useThread } from "./messages/context";
 import { ModeHoverGuide } from "./mode-hover-guide";
 import { Tooltip } from "./tooltip";
@@ -223,16 +225,20 @@ export function InputBox({
     context.execution_profile === "single_round_rag";
   const multiRoundRagActive =
     context.execution_profile === "multi_round_rag";
+  const turboModeVisible = isTurboModeVisible();
+  const directChatActive =
+    turboModeVisible && context.execution_profile === "direct";
   const frontendRagActive = singleRoundRagActive || multiRoundRagActive;
+  const bypassAgentActive = frontendRagActive || directChatActive;
   const modelOptions = useMemo(() => {
     return singleRoundRagActive ? extraModels : models;
   }, [extraModels, models, singleRoundRagActive]);
-  const { thread, isMock } = useThread();
-  const { textInput } = usePromptInputController();
-  const promptRootRef = useRef<HTMLDivElement | null>(null);
-  const { data: citationDisplay } = useCitationDisplaySettings();
-  const referenceModeEntryEnabled =
-    citationDisplay?.reference_mode_enabled ?? false;
+  const { thread, isMock } = useThread();
+  const { textInput } = usePromptInputController();
+  const promptRootRef = useRef<HTMLDivElement | null>(null);
+  const { data: citationDisplay } = useCitationDisplaySettings();
+  const referenceModeEntryEnabled =
+    citationDisplay?.reference_mode_enabled ?? false;
 
   const [followups, setFollowups] = useState<string[]>([]);
   const [followupsHidden, setFollowupsHidden] = useState(false);
@@ -253,11 +259,37 @@ export function InputBox({
     recommendedQuestions.length > 0;
 
   useEffect(() => {
-    // Multi-round RAG is a frontend execution profile, not a model option.
-    // Do not let the normal model fallback clear it on every render.
+    // Frontend-only execution profiles are not model options.
+    // Do not let the normal model fallback clear them on every render.
+    if (!turboModeVisible && context.execution_profile === "direct") {
+      onContextChange?.({
+        ...context,
+        execution_profile: undefined,
+      });
+      return;
+    }
     if (multiRoundRagActive) {
       return;
     }
+    if (directChatActive) {
+      if (models.length === 0) {
+        return;
+      }
+      const currentModel = models.find((m) => m.name === context.model_name);
+      const fallbackModel = currentModel ?? models[0]!;
+      if (
+        context.model_name === fallbackModel.name &&
+        context.execution_profile === "direct"
+      ) {
+        return;
+      }
+      onContextChange?.({
+        ...context,
+        model_name: fallbackModel.name,
+        execution_profile: "direct",
+      });
+      return;
+    }
     if (modelOptions.length === 0) {
       return;
     }
@@ -281,7 +313,7 @@ export function InputBox({
       mode: nextMode,
       execution_profile: fallbackModel.execution_profile,
     });
-  }, [context, modelOptions, multiRoundRagActive, onContextChange]);
+  }, [context, directChatActive, modelOptions, models, multiRoundRagActive, onContextChange, turboModeVisible]);
 
   const selectedModel = useMemo(() => {
     if (modelOptions.length === 0) {
@@ -314,7 +346,10 @@ export function InputBox({
         model_name,
         mode: getResolvedMode(context.mode, model.supports_thinking ?? false),
         reasoning_effort: context.reasoning_effort,
-        execution_profile: model.execution_profile,
+        execution_profile:
+          context.execution_profile === "direct"
+            ? "direct"
+            : model.execution_profile,
       });
       setModelDialogOpen(false);
     },
@@ -346,6 +381,16 @@ export function InputBox({
     [onContextChange, context, models, supportThinking],
   );
 
+  const handleDirectChatSelect = useCallback(() => {
+    const ordinaryModel =
+      models.find((model) => model.name === context.model_name) ?? models[0];
+    onContextChange?.({
+      ...context,
+      model_name: ordinaryModel?.name ?? context.model_name,
+      execution_profile: "direct",
+    });
+  }, [context, models, onContextChange]);
+
   const handleSingleRoundRagSelect = useCallback(() => {
     const ragModel =
       extraModels.find((model) => model.name === context.model_name) ??
@@ -749,7 +794,7 @@ export function InputBox({
               />
             </PromptInputActionMenuContent>
           </PromptInputActionMenu> */}
-            {!frontendRagActive && (
+            {!bypassAgentActive && (
               <AddAttachmentsButton
                 className={cn(
                   "rounded-full border-0 bg-transparent px-2.5! shadow-none text-muted-foreground hover:bg-muted/70 hover:text-foreground dark:text-slate-400 dark:hover:bg-slate-700/70 dark:hover:text-slate-100",
@@ -758,7 +803,7 @@ export function InputBox({
                 )}
               />
             )}
-            {!frontendRagActive && !hideContextTools && <Tooltip
+            {!bypassAgentActive && !hideContextTools && <Tooltip
               content={
                 context.writing_mode
                   ? "写作模式已开启：报告由深度研究管线按「通用分析结构」撰写，优先使用对话中已检索的资料"
@@ -784,7 +829,7 @@ export function InputBox({
                 <span className="text-xs font-normal">写作</span>
               </PromptInputButton>
             </Tooltip>}
-            {!frontendRagActive && <Tooltip
+            {!bypassAgentActive && <Tooltip
               content={
                 artifactDirectoryModeEnabled
                   ? "文件模式已开启：右侧会显示当前对话生成的全部文件目录"
@@ -813,7 +858,7 @@ export function InputBox({
                 <span className="text-xs font-normal">文件</span>
               </PromptInputButton>
             </Tooltip>}
-            {!frontendRagActive && !hideContextTools && !hideMemoryTool && <Tooltip
+            {!bypassAgentActive && !hideContextTools && !hideMemoryTool && <Tooltip
               content={
                 memoryInjectionEnabled
                   ? "记忆注入已开启：对话前会注入历史记忆"
@@ -839,9 +884,9 @@ export function InputBox({
                 <span className="text-xs font-normal">记忆</span>
               </PromptInputButton>
             </Tooltip>}
-            {referenceModeEntryEnabled && !frontendRagActive && !hideContextTools && <Tooltip
-              content={
-                ragModeEnabled
+            {referenceModeEntryEnabled && !bypassAgentActive && !hideContextTools && <Tooltip
+              content={
+                ragModeEnabled
                   ? "参考文献模式已开启：检索类结果会按编号引用展示"
                   : "参考文献模式已关闭：点击开启"
               }
@@ -869,7 +914,7 @@ export function InputBox({
                 <span className="text-xs font-normal">参考文献</span>
               </PromptInputButton>
             </Tooltip>}
-            {!frontendRagActive && <Tooltip
+            {!bypassAgentActive && <Tooltip
               content={
                 contextCompressionEnabled
                   ? "上下文压缩已开启：超长对话会自动压缩历史以节省 token"
@@ -909,7 +954,9 @@ export function InputBox({
                     : "flash"
                 }
                 tooltipContent={
-                  singleRoundRagActive
+                  directChatActive
+                    ? `${t.inputBox.turboMode}：${t.inputBox.turboModeDescription}`
+                    : singleRoundRagActive
                     ? "单轮 RAG 问答：基于知识库检索生成答案，并展示参考资料"
                     : multiRoundRagActive
                       ? "多轮 RAG 问答：多次检索并展示检索过程与参考资料"
@@ -921,7 +968,9 @@ export function InputBox({
                     "gap-1.5! rounded-full border-0 bg-transparent px-3! text-muted-foreground shadow-none hover:bg-muted/70 hover:text-foreground dark:text-slate-400 dark:hover:bg-slate-700/70 dark:hover:text-slate-100",
                     compact && "rounded-lg border px-2.5! py-1! text-[11px] font-medium",
                     compact &&
-                      (frontendRagActive
+                      (directChatActive
+                        ? "border-sky-200 bg-sky-50/60 text-sky-700 hover:bg-sky-100 dark:border-sky-700 dark:bg-sky-950/40 dark:text-sky-200"
+                        : frontendRagActive
                         ? "border-emerald-200 bg-emerald-50/60 text-emerald-700 hover:bg-emerald-100 dark:border-emerald-700 dark:bg-emerald-950/40 dark:text-emerald-200"
                         : context.mode === "thinking"
                         ? "border-indigo-200 bg-indigo-50/60 text-indigo-700 hover:bg-indigo-100 dark:border-indigo-700 dark:bg-indigo-950/40 dark:text-indigo-200"
@@ -933,7 +982,9 @@ export function InputBox({
                   )}
                   >
                     <div>
-                    {frontendRagActive ? (
+                    {directChatActive ? (
+                      <GaugeIcon className="size-3" />
+                    ) : frontendRagActive ? (
                       <BookMarkedIcon className="size-3" />
                     ) : context.mode === "flash" ? (
                       <ZapIcon className="size-3" />
@@ -948,10 +999,14 @@ export function InputBox({
                   <div
                     className={cn(
                       "text-xs font-normal",
-                      context.mode === "ultra" ? "golden-text" : "",
+                      context.mode === "ultra" && !directChatActive && !frontendRagActive
+                        ? "golden-text"
+                        : "",
                     )}
                   >
-                    {frontendRagActive
+                    {directChatActive
+                      ? t.inputBox.turboMode
+                      : frontendRagActive
                       ? multiRoundRagActive
                         ? "多轮 RAG"
                         : "单轮 RAG"
@@ -969,9 +1024,39 @@ export function InputBox({
                     {t.inputBox.mode}
                   </DropdownMenuLabel>
                   <PromptInputActionMenu>
+                    {turboModeVisible && (
                     <PromptInputActionMenuItem
                       className={cn(
-                        !frontendRagActive && context.mode === "flash"
+                        directChatActive
+                          ? "bg-sky-50 text-sky-800 hover:bg-sky-100 focus:bg-sky-100 dark:bg-sky-950/40 dark:text-sky-200 dark:hover:bg-sky-950/60 dark:focus:bg-sky-950/60"
+                          : "text-muted-foreground/65",
+                      )}
+                      onSelect={handleDirectChatSelect}
+                    >
+                      <div className="flex flex-col gap-2">
+                        <div className="flex items-center gap-1 font-bold">
+                          <GaugeIcon
+                            className={cn(
+                              "mr-2 size-4",
+                              directChatActive && "text-sky-700 dark:text-sky-200",
+                            )}
+                          />
+                          {t.inputBox.turboMode}
+                        </div>
+                        <div className="pl-7 text-xs">
+                          {t.inputBox.turboModeDescription}
+                        </div>
+                      </div>
+                      {directChatActive ? (
+                        <CheckIcon className="ml-auto size-4" />
+                      ) : (
+                        <div className="ml-auto size-4" />
+                      )}
+                    </PromptInputActionMenuItem>
+                    )}
+                    <PromptInputActionMenuItem
+                      className={cn(
+                        !bypassAgentActive && context.mode === "flash"
                           ? "text-accent-foreground"
                           : "text-muted-foreground/65",
                       )}
@@ -982,7 +1067,7 @@ export function InputBox({
                           <ZapIcon
                             className={cn(
                               "mr-2 size-4",
-                              !frontendRagActive && context.mode === "flash" &&
+                              !bypassAgentActive && context.mode === "flash" &&
                                 "text-accent-foreground",
                             )}
                           />
@@ -992,7 +1077,7 @@ export function InputBox({
                           {t.inputBox.flashModeDescription}
                         </div>
                       </div>
-                      {!frontendRagActive && context.mode === "flash" ? (
+                      {!bypassAgentActive && context.mode === "flash" ? (
                         <CheckIcon className="ml-auto size-4" />
                       ) : (
                         <div className="ml-auto size-4" />
@@ -1001,7 +1086,7 @@ export function InputBox({
                     {supportThinking && (
                       <PromptInputActionMenuItem
                         className={cn(
-                          !frontendRagActive && context.mode === "thinking"
+                          !bypassAgentActive && context.mode === "thinking"
                             ? "text-accent-foreground"
                             : "text-muted-foreground/65",
                         )}
@@ -1012,7 +1097,7 @@ export function InputBox({
                             <LightbulbIcon
                               className={cn(
                                 "mr-2 size-4",
-                                !frontendRagActive && context.mode === "thinking" &&
+                                !bypassAgentActive && context.mode === "thinking" &&
                                   "text-accent-foreground",
                               )}
                             />
@@ -1022,7 +1107,7 @@ export function InputBox({
                             {t.inputBox.reasoningModeDescription}
                           </div>
                         </div>
-                        {!frontendRagActive && context.mode === "thinking" ? (
+                        {!bypassAgentActive && context.mode === "thinking" ? (
                           <CheckIcon className="ml-auto size-4" />
                         ) : (
                           <div className="ml-auto size-4" />
@@ -1031,7 +1116,7 @@ export function InputBox({
                     )}
                     <PromptInputActionMenuItem
                       className={cn(
-                        !frontendRagActive && context.mode === "pro"
+                        !bypassAgentActive && context.mode === "pro"
                           ? "text-accent-foreground"
                           : "text-muted-foreground/65",
                       )}
@@ -1042,7 +1127,7 @@ export function InputBox({
                           <GraduationCapIcon
                             className={cn(
                               "mr-2 size-4",
-                              !frontendRagActive && context.mode === "pro" &&
+                              !bypassAgentActive && context.mode === "pro" &&
                                 "text-accent-foreground",
                             )}
                           />
@@ -1052,7 +1137,7 @@ export function InputBox({
                           {t.inputBox.proModeDescription}
                         </div>
                       </div>
-                      {!frontendRagActive && context.mode === "pro" ? (
+                      {!bypassAgentActive && context.mode === "pro" ? (
                         <CheckIcon className="ml-auto size-4" />
                       ) : (
                         <div className="ml-auto size-4" />
@@ -1060,7 +1145,7 @@ export function InputBox({
                     </PromptInputActionMenuItem>
                     <PromptInputActionMenuItem
                       className={cn(
-                        !frontendRagActive && context.mode === "ultra"
+                        !bypassAgentActive && context.mode === "ultra"
                           ? "text-accent-foreground"
                           : "text-muted-foreground/65",
                       )}
@@ -1071,14 +1156,14 @@ export function InputBox({
                           <RocketIcon
                             className={cn(
                               "mr-2 size-4",
-                              !frontendRagActive &&
+                              !bypassAgentActive &&
                                 context.mode === "ultra" &&
                                 "text-[#dabb5e]",
                             )}
                           />
                           <div
                             className={cn(
-                              !frontendRagActive &&
+                              !bypassAgentActive &&
                                 context.mode === "ultra" &&
                                 "golden-text",
                             )}
@@ -1090,7 +1175,7 @@ export function InputBox({
                           {t.inputBox.ultraModeDescription}
                         </div>
                       </div>
-                      {!frontendRagActive && context.mode === "ultra" ? (
+                      {!bypassAgentActive && context.mode === "ultra" ? (
                         <CheckIcon className="ml-auto size-4" />
                       ) : (
                         <div className="ml-auto size-4" />
@@ -1161,7 +1246,7 @@ export function InputBox({
                 </DropdownMenuGroup>
               </PromptInputActionMenuContent>
             </PromptInputActionMenu>
-            {!frontendRagActive && supportReasoningEffort && context.mode !== "flash" && (
+            {!bypassAgentActive && supportReasoningEffort && context.mode !== "flash" && (
               <PromptInputActionMenu>
                 <PromptInputActionMenuTrigger className={cn("gap-1.5! rounded-full border-0 bg-transparent px-3! text-muted-foreground shadow-none hover:bg-muted/70 hover:text-foreground dark:text-slate-400 dark:hover:bg-slate-700/70 dark:hover:text-slate-100", compact && "rounded-lg border border-border px-2.5! py-1! text-[13px]")}>
                   <div className="text-xs font-normal">
@@ -1279,7 +1364,7 @@ export function InputBox({
             )}
           </PromptInputTools>
           <PromptInputTools className={cn("gap-1.5", compact && "gap-2")}>
-            {!frontendRagActive && agentSelector && (
+            {!bypassAgentActive && agentSelector && (
               <AgentSelector
                 selectedAgentId={agentSelector.selectedAgentId}
                 onAgentChange={agentSelector.onAgentChange}
@@ -1287,8 +1372,8 @@ export function InputBox({
                 compact={compact}
               />
             )}
-            {!frontendRagActive && knowledgeSelector}
-            {!frontendRagActive && promptPrefix && (
+            {!bypassAgentActive && knowledgeSelector}
+            {!bypassAgentActive && promptPrefix && (
               <Tooltip
                 content={
                   promptPrefix.on

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

@@ -6,13 +6,22 @@ import { toast } from "sonner";
 import { Button } from "@/components/ui/button";
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select";
 import { getStoredAuth } from "@/core/auth";
+import { useLlmWikiRuntime } from "@/strategy-components/api/llmwiki";
 import {
   loadKnowledgeBaseProductVersion,
+  loadOrdinaryKnowledgeLanding,
+  saveOrdinaryKnowledgeLanding,
+  type OrdinaryKnowledgeLanding,
   type KnowledgeBaseProductVersion,
   updateKnowledgeBaseProductVersion,
 } from "@/core/system-settings/api";
 
 export const KNOWLEDGE_PRODUCT_KEY = ["system-settings", "knowledge-base-product-version"] as const;
+const LANDING_KEY = ["system-settings", "ordinary-knowledge-landing"] as const;
+
+export function useOrdinaryKnowledgeLanding() {
+  return useQuery({ queryKey: LANDING_KEY, queryFn: loadOrdinaryKnowledgeLanding, staleTime: 0 });
+}
 export const KNOWLEDGE_NORMAL_VIEW_VALUE = "normal";
 export const KNOWLEDGE_NORMAL_VIEW_SEARCH = `?view=${KNOWLEDGE_NORMAL_VIEW_VALUE}`;
 
@@ -25,6 +34,14 @@ export function KnowledgeProductNav() {
   const navigate = useNavigate();
   const client = useQueryClient();
   const version = useKnowledgeBaseProductVersion();
+  const landing = useOrdinaryKnowledgeLanding();
+  const saveLanding = useMutation({
+    mutationFn: saveOrdinaryKnowledgeLanding,
+    onSuccess: (mode) => { client.setQueryData(LANDING_KEY, mode); toast.success("普通知识库默认页面已更新"); },
+    onError: (error) => toast.error(error.message),
+  });
+  const runtime = useLlmWikiRuntime();
+  const normalAvailable = runtime.data?.provider === "weknora" && Boolean(runtime.data.api_base_url?.trim());
   const isAdmin = getStoredAuth()?.system_role === "admin";
   const save = useMutation({
     mutationFn: updateKnowledgeBaseProductVersion,
@@ -36,15 +53,20 @@ export function KnowledgeProductNav() {
   const assistant = location.pathname.includes("/knowledge/assistant");
 
   return (
-    <div className="flex items-center gap-2 border-b bg-card px-6 py-2">
-      <Button size="sm" variant={assistant ? "ghost" : "secondary"} onClick={() => navigate(`/page/workspace/knowledge${KNOWLEDGE_NORMAL_VIEW_SEARCH}`)}>
+    <div className="flex flex-wrap items-center gap-2 border-b bg-card px-6 py-2">
+      <Button size="sm" disabled={!normalAvailable} title={normalAvailable ? "普通知识库" : "管理员配置知识服务地址后可用"} variant={assistant ? "ghost" : "secondary"} onClick={() => navigate(`/page/workspace/knowledge${KNOWLEDGE_NORMAL_VIEW_SEARCH}`)}>
         <BookOpen />普通知识库
       </Button>
       <Button size="sm" variant={assistant ? "secondary" : "ghost"} onClick={() => navigate("/page/workspace/knowledge/assistant")}>
         <Database />助手知识库
       </Button>
       {isAdmin && (
-        <div className="ml-auto flex items-center gap-2 text-xs text-muted-foreground">
+        <div className="ml-auto flex flex-wrap items-center gap-2 text-xs text-muted-foreground">
+          普通知识库默认页面
+          <Select disabled={landing.isLoading || saveLanding.isPending} value={landing.data ?? "wiki"} onValueChange={(value) => saveLanding.mutate(value as OrdinaryKnowledgeLanding)}>
+            <SelectTrigger className="h-8 w-40" aria-label="普通知识库默认页面"><SelectValue /></SelectTrigger>
+            <SelectContent><SelectItem value="wiki">本系统 Wiki 索引</SelectItem><SelectItem value="weknora">知识库管理页面</SelectItem></SelectContent>
+          </Select>
           默认产品版本
           <Select value={version.data ?? "v1"} onValueChange={(value) => save.mutate(value as KnowledgeBaseProductVersion)}>
             <SelectTrigger className="h-8 w-40"><SelectValue /></SelectTrigger>

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

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

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

@@ -0,0 +1,51 @@
+import { FolderKanban } from "lucide-react";
+
+import {
+  MY_PROJECT_CONVERSATION_LABELS,
+  type MyProjectConversationType,
+} from "@/core/threads/project-metadata";
+import { cn } from "@/lib/utils";
+
+const BADGE_STYLES: Record<MyProjectConversationType, string> = {
+  qa: "border-sky-200 bg-sky-50 text-sky-700 dark:border-sky-700/70 dark:bg-sky-950/55 dark:text-sky-300",
+  strategy:
+    "border-violet-200 bg-violet-50 text-violet-700 dark:border-violet-700/70 dark:bg-violet-950/55 dark:text-violet-300",
+  solution:
+    "border-emerald-200 bg-emerald-50 text-emerald-700 dark:border-emerald-700/70 dark:bg-emerald-950/55 dark:text-emerald-300",
+};
+
+export function MyProjectThreadIcon({
+  type,
+  className,
+}: {
+  type: MyProjectConversationType;
+  className?: string;
+}) {
+  return (
+    <FolderKanban
+      aria-label={`我的项目 · ${MY_PROJECT_CONVERSATION_LABELS[type]}`}
+      className={cn("size-3.5 shrink-0 text-violet-500", className)}
+    />
+  );
+}
+
+export function MyProjectThreadBadge({
+  type,
+  className,
+}: {
+  type: MyProjectConversationType;
+  className?: string;
+}) {
+  return (
+    <span
+      className={cn(
+        "shrink-0 rounded border px-1 py-0.5 text-[9px] font-medium leading-none",
+        BADGE_STYLES[type],
+        className,
+      )}
+      title={`来自我的项目 · ${MY_PROJECT_CONVERSATION_LABELS[type]}`}
+    >
+      {MY_PROJECT_CONVERSATION_LABELS[type]}
+    </span>
+  );
+}

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

@@ -49,7 +49,11 @@ import {
   SidebarMenuButton,
   SidebarMenuItem,
 } from "@/components/ui/sidebar";
-import { ShareConversationDialog } from "@/components/workspace/thread-share-dialogs";
+import { ShareConversationDialog } from "@/components/workspace/thread-share-dialogs";
+import {
+  MyProjectThreadBadge,
+  MyProjectThreadIcon,
+} from "@/components/workspace/my-project-thread-indicator";
 import { getAPIClient } from "@/core/api";
 import { useI18n } from "@/core/i18n/hooks";
 import {
@@ -63,7 +67,8 @@ import {
   useToggleThreadFavorite,
   useToggleThreadPin,
 } from "@/core/threads/hooks";
-import type { AgentThread, AgentThreadState } from "@/core/threads/types";
+import type { AgentThread, AgentThreadState } from "@/core/threads/types";
+import { myProjectConversationTypeOfThread } from "@/core/threads/project-metadata";
 import {
   isBootstrapThread,
   isHiddenFromRecentChats,
@@ -245,7 +250,8 @@ export function RecentChatList({
               {shownThreads.map((thread) => {
                 const href = listPathOfThread(thread);
                 const isActive = href === pathname;
-                const isBoot = isBootstrapThread(thread);
+                const isBoot = isBootstrapThread(thread);
+                const projectType = myProjectConversationTypeOfThread(thread);
                 const pinned = isThreadPinned(thread);
                 const favorited = isThreadFavorite(thread);
                 return (
@@ -279,8 +285,10 @@ export function RecentChatList({
                             }
                             aria-label="智能体创建会话"
                           />
-                        ) : (
-                          compact && (
+                        ) : projectType ? (
+                          <MyProjectThreadIcon type={projectType} />
+                        ) : (
+                          compact && (
                             <MessageSquare
                               className={
                                 "size-3.5 shrink-0 " +
@@ -294,9 +302,15 @@ export function RecentChatList({
                         {pinned && (
                           <Pin className="size-3 shrink-0 text-muted-foreground/70" />
                         )}
-                        <span className="truncate">
-                          {desensitize(titleOfThread(thread, t.pages.newChat))}
-                        </span>
+                        <span className="min-w-0 flex-1 truncate">
+                          {desensitize(titleOfThread(thread, t.pages.newChat))}
+                        </span>
+                        {projectType && (
+                          <MyProjectThreadBadge
+                            className="mr-3"
+                            type={projectType}
+                          />
+                        )}
                       </Link>
                     </SidebarMenuButton>
                     {env.NEXT_PUBLIC_STATIC_WEBSITE_ONLY !== "true" && (

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

@@ -69,7 +69,7 @@ export function SettingsDialog(props: SettingsDialogProps) {
       // },
       { id: "tools", label: t.settings.sections.tools, icon: WrenchIcon },
       ...(isAdmin
-        ? [{ id: "encoder", label: "本地编码器", icon: CpuIcon }]
+        ? [{ id: "encoder", label: "Wiki 镜像编码器", icon: CpuIcon }]
         : []),
       {
         id: "account",

frontend-web/src/components/workspace/skills/SkillKnowledgePanel.tsx

@@ -205,21 +205,21 @@ export function SkillKnowledgePanel({ adminMode = false }: { adminMode?: boolean
                       />
                       <Database className="size-4 text-muted-foreground" />
                       <span className="text-sm">{target.target_name}</span>
-                      <Badge variant="outline" className="ml-auto text-[10px]">WeKnora Wiki</Badge>
+                      <Badge variant="outline" className="ml-auto text-[10px]">普通 Wiki 库</Badge>
                     </label>
                   );
                 })}
                 {(runtime.isLoading || knowledgeBases.isLoading) && <Loader2 className="m-4 size-5 animate-spin" />}
                 {!runtime.isLoading && !knowledgeBases.isLoading && knowledgeBases.error && (
                   <p className="p-3 text-xs text-destructive">
-                    读取 WeKnora 普通知识库失败：
+                    读取普通知识库失败：
                     {knowledgeBases.error instanceof Error ? knowledgeBases.error.message : String(knowledgeBases.error)}
                   </p>
                 )}
                 {!runtime.isLoading && !knowledgeBases.isLoading && !knowledgeBases.error && !targets.length && (
                   <p className="p-3 text-xs text-muted-foreground">
                     {runtime.data?.provider !== "weknora"
-                      ? "当前未配置 WeKnora 普通知识库地址；技能需要先归纳到普通知识库，再导入助手知识库。"
+                      ? "当前未配置普通知识库地址；技能需要先归纳到普通知识库，再导入助手知识库。"
                       : "当前没有可写且已开启 Wiki 的普通知识库；请确认该库不是 FAQ/会话沉淀库，并已开启 Wiki。"}
                   </p>
                 )}

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

@@ -14,7 +14,7 @@ import {
   SidebarMenuItem,
 } from "@/components/ui/sidebar";
 import { useI18n } from "@/core/i18n/hooks";
-import { BookOpen, BotIcon, BrainIcon, FileSearch, FileText, Library, ListChecks, MessageSquarePlus, MessagesSquare, PenLine, Plus, SparklesIcon, Telescope, Users } from "lucide-react";
+import { BookOpen, BotIcon, BrainIcon, FileSearch, FileText, FolderKanban, Library, ListChecks, MessageSquarePlus, MessagesSquare, PenLine, Plus, SparklesIcon, Telescope, Users } from "lucide-react";
 
 import { KnowledgeRagToggle } from "./knowledge-rag-toggle";
 import { SidebarCollapseButton } from "./workspace-header";
@@ -24,7 +24,10 @@ import {
   applyCompactMenuOverrides,
   type CompactMenuItem,
 } from "@/core/page-layout/compact-menu-overrides";
-import { type MenuItem } from "@/core/page-layout/sidebar-menu";
+import {
+  MARKDOWN_DOCX_MENU_ITEM,
+  type MenuItem,
+} from "@/core/page-layout/sidebar-menu";
 import { useCompactMenuOverrides } from "@/strategy-components/api/compact-menu-overrides";
 
 // 普通导航项：默认中性色，激活态与「新对话」一致——主色浅底 + 主色文字/图标
@@ -65,6 +68,15 @@ export const WORKSPACE_COMPACT_NAV_ITEMS: WorkspaceCompactNavItem[] = [
     path: "/page/workspace/chats",
     match: (pathname) => pathname === "/page/workspace/chats",
   },
+  {
+    id: "strategy-projects",
+    label: "我的项目",
+    icon: FolderKanban,
+    path: "/page/strategy/qa/projects",
+    match: (pathname) =>
+      pathname.startsWith("/page/strategy/qa/projects") ||
+      pathname.startsWith("/page/strategy/qa/strategy-selection"),
+  },
   {
     id: "workspace-library",
     label: "资料库",
@@ -140,7 +152,13 @@ export const WORKSPACE_COMPACT_NAV_ITEMS: WorkspaceCompactNavItem[] = [
     label: "知识库管理",
     icon: BookOpen,
     path: "/page/workspace/knowledge",
-    match: (pathname) => pathname.startsWith("/page/workspace/knowledge"),
+    match: (pathname) =>
+      pathname.startsWith("/page/workspace/knowledge") &&
+      !pathname.startsWith(MARKDOWN_DOCX_MENU_ITEM.path),
+  },
+  {
+    ...MARKDOWN_DOCX_MENU_ITEM,
+    match: (pathname) => pathname.startsWith(MARKDOWN_DOCX_MENU_ITEM.path),
   },
 ];
 

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

@@ -96,6 +96,9 @@ export const enUS: Translations = {
     mode: "Mode",
     flashMode: "Flash",
     flashModeDescription: "Fast and efficient, but may not be accurate",
+    turboMode: "Turbo",
+    turboModeDescription:
+      "Talk to the model directly with no agent tools or skills, for lower first-token latency",
     reasoningMode: "Reasoning",
     reasoningModeDescription:
       "Reasoning before action, balance between time and accuracy",
@@ -448,17 +451,17 @@ export const enUS: Translations = {
       system: "System",
       light: "Light",
       dark: "Dark",
-      lightblue: "Light Blue",
-      lightgreen: "Green",
-      iceblue: "Glacier Blue",
-      lightyellow: "Pale Yellow",
+      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.",
-      lightgreenDescription: "A crisp light palette built around fresh green tones.",
-      iceblueDescription: "An airy palette built around #9BCEF1 with accessible blue actions.",
-      lightyellowDescription: "A soft palette built around #F3FBD9 with readable olive actions.",
+      lightblueDescription: "A crisp light palette built around blue.",
+      lightgreenDescription: "A crisp light palette built around fresh green tones.",
+      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.",
     },
@@ -545,13 +548,13 @@ export const enUS: Translations = {
       filesSaveAction: "Save",
       filesCancelEditAction: "Cancel",
       filesDownloadAction: "Download",
-      filesCopyPathAction: "Copy path",
-      filesDiscardConfirm: "Discard unsaved changes?",
-      filesSaveSuccess: "File saved",
-      filesDeleteAction: "Delete",
-      filesDeleteConfirm: "Delete \"{path}\"? This cannot be undone.",
-      filesDeleteSuccess: "File deleted",
-      filesReadOnlyHint: "Only administrators can edit or delete built-in skill files.",
+      filesCopyPathAction: "Copy path",
+      filesDiscardConfirm: "Discard unsaved changes?",
+      filesSaveSuccess: "File saved",
+      filesDeleteAction: "Delete",
+      filesDeleteConfirm: "Delete \"{path}\"? This cannot be undone.",
+      filesDeleteSuccess: "File deleted",
+      filesReadOnlyHint: "Only administrators can edit or delete built-in skill files.",
       viewDetailAction: "View skill details",
       stateSheet: {
         archivedTitle: "Archived skills",
@@ -591,26 +594,26 @@ export const enUS: Translations = {
         chooseFile: "Choose file",
         validating: "Validating archive…",
         installing: "Installing…",
-        replace: "Upload again and replace",
+        replace: "Upload again and replace",
         install: "Install",
         cancel: "Cancel",
         nameLabel: "Name",
         descriptionLabel: "Description",
         licenseLabel: "License",
         toolsLabel: "Allowed tools",
-        warningsLabel: "Warnings",
-        conflictOwnedByMe:
-          "You already uploaded a skill named '{name}'. You may upload it again and replace your existing copy (its enabled state will be kept).",
-        conflictOwnedByMeWrongTarget:
-          "The custom skill '{name}' belongs to you. Switch the target to 'Custom skill' to replace it.",
-        conflictOwnedByOther:
-          "Skill '{name}' was uploaded by user '{owner}' and cannot be replaced. Rename the skill before uploading.",
-        conflictCustom:
-          "A custom skill named '{name}' already exists, but its uploader could not be identified. Rename it to avoid overwriting someone else's skill.",
+        warningsLabel: "Warnings",
+        conflictOwnedByMe:
+          "You already uploaded a skill named '{name}'. You may upload it again and replace your existing copy (its enabled state will be kept).",
+        conflictOwnedByMeWrongTarget:
+          "The custom skill '{name}' belongs to you. Switch the target to 'Custom skill' to replace it.",
+        conflictOwnedByOther:
+          "Skill '{name}' was uploaded by user '{owner}' and cannot be replaced. Rename the skill before uploading.",
+        conflictCustom:
+          "A custom skill named '{name}' already exists, but its uploader could not be identified. Rename it to avoid overwriting someone else's skill.",
         conflictPublic:
           "A built-in public skill named '{name}' already exists and cannot be overwritten.",
-        conflictPublicAdminHint:
-          "A built-in public skill named '{name}' exists. Click 'Upload again and replace' to overwrite it.",
+        conflictPublicAdminHint:
+          "A built-in public skill named '{name}' exists. Click 'Upload again and replace' to overwrite it.",
         installSuccess: "Skill '{name}' installed.",
         installSuccessReplaced: "Skill '{name}' replaced.",
         rejectInvalidExt: "Only .zip or .skill files are accepted.",

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

@@ -91,6 +91,8 @@ export interface Translations {
     mode: string;
     flashMode: string;
     flashModeDescription: string;
+    turboMode: string;
+    turboModeDescription: string;
     reasoningMode: string;
     reasoningModeDescription: string;
     proMode: string;
@@ -383,17 +385,17 @@ export interface Translations {
       system: string;
       light: string;
       dark: string;
-      lightblue: string;
-      lightgreen: string;
-      iceblue: string;
-      lightyellow: string;
+      lightblue: string;
+      lightgreen: string;
+      iceblue: string;
+      lightyellow: string;
       systemDescription: string;
       lightDescription: string;
       darkDescription: string;
-      lightblueDescription: string;
-      lightgreenDescription: string;
-      iceblueDescription: string;
-      lightyellowDescription: string;
+      lightblueDescription: string;
+      lightgreenDescription: string;
+      iceblueDescription: string;
+      lightyellowDescription: string;
       languageTitle: string;
       languageDescription: string;
     };
@@ -475,13 +477,13 @@ export interface Translations {
       filesSaveAction: string;
       filesCancelEditAction: string;
       filesDownloadAction: string;
-      filesCopyPathAction: string;
-      filesDiscardConfirm: string;
-      filesSaveSuccess: string;
-      filesDeleteAction: string;
-      filesDeleteConfirm: string;
-      filesDeleteSuccess: string;
-      filesReadOnlyHint: string;
+      filesCopyPathAction: string;
+      filesDiscardConfirm: string;
+      filesSaveSuccess: string;
+      filesDeleteAction: string;
+      filesDeleteConfirm: string;
+      filesDeleteSuccess: string;
+      filesReadOnlyHint: string;
       viewDetailAction: string;
       stateSheet: {
         archivedTitle: string;
@@ -525,12 +527,12 @@ export interface Translations {
         nameLabel: string;
         descriptionLabel: string;
         licenseLabel: string;
-        toolsLabel: string;
-        warningsLabel: string;
-        conflictOwnedByMe: string;
-        conflictOwnedByMeWrongTarget: string;
-        conflictOwnedByOther: string;
-        conflictCustom: string;
+        toolsLabel: string;
+        warningsLabel: string;
+        conflictOwnedByMe: string;
+        conflictOwnedByMeWrongTarget: string;
+        conflictOwnedByOther: string;
+        conflictCustom: string;
         conflictPublic: string;
         conflictPublicAdminHint: string;
         installSuccess: string;

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

@@ -95,6 +95,8 @@ export const zhCN: Translations = {
     mode: "模式",
     flashMode: "快速",
     flashModeDescription: "快速且高效的完成任务，但可能不够精准",
+    turboMode: "极速",
+    turboModeDescription: "直连大模型流式问答，不走智能体工具与技能，首字更快",
     reasoningMode: "思考",
     reasoningModeDescription: "思考后再行动，在时间与准确性之间取得平衡",
     proMode: "专业问答",
@@ -429,17 +431,17 @@ export const zhCN: Translations = {
       system: "系统",
       light: "浅色",
       dark: "深色",
-      lightblue: "浅蓝",
-      lightgreen: "绿色",
-      iceblue: "冰川蓝",
-      lightyellow: "浅黄色",
+      lightblue: "浅蓝",
+      lightgreen: "绿色",
+      iceblue: "冰川蓝",
+      lightyellow: "浅黄色",
       systemDescription: "自动跟随系统主题。",
       lightDescription: "更明亮的配色，适合日间使用。",
       darkDescription: "更暗的配色，减少眩光方便专注。",
-      lightblueDescription: "以蓝色为主色的清爽浅色配色。",
-      lightgreenDescription: "采用清新绿色的浅色配色。",
-      iceblueDescription: "以 #9BCEF1 为主色，搭配冰蓝留白与沉稳交互色。",
-      lightyellowDescription: "以 #F3FBD9 为主色，搭配柔和浅黄留白与深橄榄交互色。",
+      lightblueDescription: "以蓝色为主色的清爽浅色配色。",
+      lightgreenDescription: "采用清新绿色的浅色配色。",
+      iceblueDescription: "以 #9BCEF1 为主色，搭配冰蓝留白与沉稳交互色。",
+      lightyellowDescription: "以 #F3FBD9 为主色，搭配柔和浅黄留白与深橄榄交互色。",
       languageTitle: "语言",
       languageDescription: "在不同语言之间切换。",
     },
@@ -524,11 +526,11 @@ export const zhCN: Translations = {
       filesDownloadAction: "下载",
       filesCopyPathAction: "复制路径",
       filesDiscardConfirm: "有未保存的修改,确定放弃吗?",
-      filesSaveSuccess: "文件已保存",
-      filesDeleteAction: "删除",
-      filesDeleteConfirm: "确定删除“{path}”？该操作不可撤销。",
-      filesDeleteSuccess: "文件已删除",
-      filesReadOnlyHint: "仅管理员可以编辑或删除内置技能文件。",
+      filesSaveSuccess: "文件已保存",
+      filesDeleteAction: "删除",
+      filesDeleteConfirm: "确定删除“{path}”？该操作不可撤销。",
+      filesDeleteSuccess: "文件已删除",
+      filesReadOnlyHint: "仅管理员可以编辑或删除内置技能文件。",
       viewDetailAction: "查看技能详情",
       stateSheet: {
         archivedTitle: "归档的技能",
@@ -566,24 +568,24 @@ export const zhCN: Translations = {
         chooseFile: "选择文件",
         validating: "正在校验文件…",
         installing: "安装中…",
-        replace: "重复上传并覆盖",
+        replace: "重复上传并覆盖",
         install: "安装",
         cancel: "取消",
         nameLabel: "名称",
         descriptionLabel: "描述",
         licenseLabel: "许可证",
         toolsLabel: "允许的工具",
-        warningsLabel: "警告",
-        conflictOwnedByMe:
-          "您已上传过同名技能 “{name}”，可重复上传并覆盖原版本（原启用状态保留）。",
-        conflictOwnedByMeWrongTarget:
-          "同名技能 “{name}” 是您上传的自定义技能，请切换到「自定义技能」后覆盖。",
-        conflictOwnedByOther:
-          "技能 “{name}” 已由用户 “{owner}” 上传，不能覆盖，请修改技能名称后再上传。",
-        conflictCustom:
-          "已存在同名自定义技能 “{name}”，但无法确认上传用户，为避免误覆盖请修改技能名称。",
+        warningsLabel: "警告",
+        conflictOwnedByMe:
+          "您已上传过同名技能 “{name}”，可重复上传并覆盖原版本（原启用状态保留）。",
+        conflictOwnedByMeWrongTarget:
+          "同名技能 “{name}” 是您上传的自定义技能，请切换到「自定义技能」后覆盖。",
+        conflictOwnedByOther:
+          "技能 “{name}” 已由用户 “{owner}” 上传，不能覆盖，请修改技能名称后再上传。",
+        conflictCustom:
+          "已存在同名自定义技能 “{name}”，但无法确认上传用户，为避免误覆盖请修改技能名称。",
         conflictPublic: `存在同名内置技能 '{name}'，无法覆盖。`,
-        conflictPublicAdminHint: `存在同名内置技能 '{name}'。点击「重复上传并覆盖」可替换。`,
+        conflictPublicAdminHint: `存在同名内置技能 '{name}'。点击「重复上传并覆盖」可替换。`,
         installSuccess: `技能 '{name}' 已安装。`,
         installSuccessReplaced: `技能 '{name}' 已替换。`,
         rejectInvalidExt: `只接受 .zip 或 .skill 文件。`,

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

@@ -364,11 +364,16 @@ export function extractReasoningContentFromMessage(message: Message) {
   if (message.type !== "ai") {
     return null;
   }
-  if (
-    message.additional_kwargs &&
-    "reasoning_content" in message.additional_kwargs
-  ) {
-    return message.additional_kwargs.reasoning_content as string | null;
+  if (message.additional_kwargs) {
+    const reasoningContent = message.additional_kwargs.reasoning_content;
+    if (typeof reasoningContent === "string") {
+      return reasoningContent;
+    }
+    // Newer vLLM puts thinking in `reasoning` instead of `reasoning_content`.
+    const reasoning = message.additional_kwargs.reasoning;
+    if (typeof reasoning === "string") {
+      return reasoning;
+    }
   }
   if (Array.isArray(message.content)) {
     const part = message.content[0];
@@ -424,6 +429,9 @@ export function hasReasoning(message: Message) {
   if (typeof message.additional_kwargs?.reasoning_content === "string") {
     return true;
   }
+  if (typeof message.additional_kwargs?.reasoning === "string") {
+    return true;
+  }
   if (Array.isArray(message.content)) {
     const part = message.content[0];
     // Compatible with the Anthropic gateway

frontend-web/src/core/models/types.ts

@@ -4,11 +4,11 @@ export interface Model {
   model: string;
   display_name: string;
   description?: string | null;
-  supports_thinking?: boolean;
-  supports_reasoning_effort?: boolean;
-  /** Execution profiles handled by the frontend instead of DeerFlow. */
-  execution_profile?: "single_round_rag" | "multi_round_rag";
-}
+  supports_thinking?: boolean;
+  supports_reasoning_effort?: boolean;
+  /** Execution profiles handled by the frontend instead of DeerFlow. */
+  execution_profile?: "single_round_rag" | "multi_round_rag" | "direct";
+}
 
 export interface TokenUsageSettings {
   enabled: boolean;

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

@@ -21,6 +21,7 @@ import {
   FileBox,
   FileSearch,
   FileText,
+  FolderKanban,
   Gauge,
   Grid3X3,
   HelpCircle,
@@ -48,12 +49,23 @@ export type MenuItem = {
   path?: string;
   /** 额外视为「当前页属于本菜单项」的路由（不在侧栏展示，仅用于高亮）。 */
   aliasPaths?: string[];
+  /** 从当前菜单项自身的 path / aliasPaths 前缀匹配中排除的路由。 */
+  excludePaths?: string[];
   /** 非 admin 用户使用的路由（菜单对普通用户可见时生效，与简洁模式公开排行榜一致） */
   userPath?: string;
   adminOnly?: boolean;
   children?: MenuItem[];
 };
 
+/** Markdown 转 Word 功能的菜单定义，供全量与简洁模式共用。 */
+export const MARKDOWN_DOCX_MENU_PATH = "/page/workspace/knowledge/markdown-editor";
+export const MARKDOWN_DOCX_MENU_ITEM: MenuItem & { path: string } = {
+  id: "resource-markdown-docx-editor",
+  label: "md转word",
+  icon: FileText,
+  path: MARKDOWN_DOCX_MENU_PATH,
+};
+
 export const sidebarMenuItems: MenuItem[] = [
   {
     id: "qa-center",
@@ -68,6 +80,13 @@ export const sidebarMenuItems: MenuItem[] = [
         icon: Users,
         path: "/page/strategy/qa/multi-agent-roundtable",
       },
+      {
+        id: "strategy-projects",
+        label: "我的项目",
+        icon: FolderKanban,
+        path: "/page/strategy/qa/projects",
+        aliasPaths: ["/page/strategy/qa/strategy-selection"],
+      },
       // {
       //   id: "position-roundtable",
       //   label: "岗位会商",
@@ -258,12 +277,7 @@ export const sidebarMenuItems: MenuItem[] = [
       },
       { id: "mgmt-skills", label: "技能管理", icon: Sparkles, path: "/page/strategy/skills" },
       { id: "mgmt-memory", label: "记忆管理", icon: Brain, path: "/page/strategy/memory" },
-      {
-        id: "resource-markdown-docx-editor",
-        label: "md转word",
-        icon: FileText,
-        path: "/page/workspace/knowledge/markdown-editor",
-      },
+      MARKDOWN_DOCX_MENU_ITEM,
       {
         id: "mgmt-tasks",
         label: "定时任务",
@@ -330,6 +344,7 @@ export const sidebarMenuItems: MenuItem[] = [
         label: "知识库管理",
         icon: BookOpen,
         path: "/page/workspace/knowledge",
+        excludePaths: [MARKDOWN_DOCX_MENU_PATH],
       },
       {
         id: "resource-knowledge-base",
@@ -365,6 +380,9 @@ function routeMatchesPathname(pathname: string, route?: string): boolean {
 
 /** 菜单项自身 path / aliasPaths 是否匹配当前路由。 */
 export function menuItemMatchesPath(item: MenuItem, pathname: string): boolean {
+  if (item.excludePaths?.some((path) => routeMatchesPathname(pathname, path))) {
+    return false;
+  }
   if (routeMatchesPathname(pathname, item.path)) return true;
   return item.aliasPaths?.some((p) => routeMatchesPathname(pathname, p)) ?? false;
 }

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

@@ -11,6 +11,60 @@ export interface PromptPrefixSettings {
 
 export type KnowledgeBaseProductVersion = "v1" | "v2";
 
+export type OrdinaryKnowledgeLanding = "wiki" | "weknora";
+
+export interface StrategyProjectSettings {
+  taiwan_strait_demo_enabled: boolean;
+}
+
+export interface StrategyProjectSettingsUpdate {
+  taiwan_strait_demo_enabled?: boolean;
+}
+
+export async function loadStrategyProjectSettings(): Promise<StrategyProjectSettings> {
+  const response = await apiFetch(
+    `${getBackendBaseURL()}/api/system-settings/strategy-projects`,
+  );
+  if (!response.ok) {
+    throw new Error(`无法读取策略项目设置（HTTP ${response.status}）`);
+  }
+  return (await response.json()) as StrategyProjectSettings;
+}
+
+export async function updateStrategyProjectSettings(
+  body: StrategyProjectSettingsUpdate,
+): Promise<StrategyProjectSettings> {
+  const response = await apiFetch(
+    `${getBackendBaseURL()}/api/system-settings/strategy-projects`,
+    {
+      method: "PUT",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body),
+    },
+  );
+  if (!response.ok) {
+    const detail = await response
+      .json()
+      .catch(() => ({ detail: "保存策略项目设置失败" }));
+    throw new Error(detail.detail ?? "保存策略项目设置失败");
+  }
+  return (await response.json()) as StrategyProjectSettings;
+}
+
+export async function loadOrdinaryKnowledgeLanding(): Promise<OrdinaryKnowledgeLanding> {
+  const response = await apiFetch(`${getBackendBaseURL()}/api/system-settings/ordinary-knowledge-landing`);
+  if (!response.ok) throw new Error("无法读取普通知识库默认页面设置");
+  return ((await response.json()) as { mode: OrdinaryKnowledgeLanding }).mode;
+}
+
+export async function saveOrdinaryKnowledgeLanding(mode: OrdinaryKnowledgeLanding): Promise<OrdinaryKnowledgeLanding> {
+  const response = await apiFetch(`${getBackendBaseURL()}/api/system-settings/ordinary-knowledge-landing`, {
+    method: "PUT", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ mode }),
+  });
+  if (!response.ok) throw new Error("保存失败，仅管理员可配置普通知识库默认页面");
+  return ((await response.json()) as { mode: OrdinaryKnowledgeLanding }).mode;
+}
+
 export async function loadKnowledgeBaseProductVersion(): Promise<KnowledgeBaseProductVersion> {
   const response = await apiFetch(
     `${getBackendBaseURL()}/api/system-settings/knowledge-base-product-version`,

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

@@ -13,6 +13,7 @@ import {
   loadPromptPrefixSettings,
   loadPublishSquares,
   loadSkillCompressionSettings,
+  loadStrategyProjectSettings,
   updateAgentModuleConfig,
   updateAppearanceSettings,
   updateCitationDisplaySettings,
@@ -23,6 +24,7 @@ import {
   updatePromptPrefixSettings,
   updatePublishSquares,
   updateSkillCompressionSettings,
+  updateStrategyProjectSettings,
   type AppearanceUpdate,
   type CitationDisplayUpdate,
   type LeaderboardSettingsUpdate,
@@ -32,6 +34,7 @@ import {
   type PromptPrefixUpdate,
   type PublishSquaresUpdate,
   type SkillCompressionUpdate,
+  type StrategyProjectSettingsUpdate,
   type LayoutMode,
   type ViewMode,
 } from "./api";
@@ -45,6 +48,28 @@ const LEADERBOARD_KEY = ["systemSettings", "leaderboard"] as const;
 const SKILL_COMPRESSION_KEY = ["systemSettings", "skillCompression"] as const;
 const MODEL_CONCURRENCY_KEY = ["systemSettings", "modelConcurrency"] as const;
 const PLUGIN_MANAGEMENT_KEY = ["systemSettings", "pluginManagement"] as const;
+const STRATEGY_PROJECTS_KEY = ["systemSettings", "strategyProjects"] as const;
+
+export function useStrategyProjectSettings() {
+  return useQuery({
+    queryKey: STRATEGY_PROJECTS_KEY,
+    queryFn: () => loadStrategyProjectSettings(),
+    staleTime: 60_000,
+    refetchOnWindowFocus: false,
+    retry: false,
+  });
+}
+
+export function useUpdateStrategyProjectSettings() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: (body: StrategyProjectSettingsUpdate) =>
+      updateStrategyProjectSettings(body),
+    onSuccess: (data) => {
+      queryClient.setQueryData(STRATEGY_PROJECTS_KEY, data);
+    },
+  });
+}
 
 export function usePromptPrefixSettings() {
   return useQuery({

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

@@ -16,14 +16,14 @@ import { rememberAskTime } from "../chat-timestamps";
 import { getBackendBaseURL, getLangGraphBaseURL } from "../config";
 import { useI18n } from "../i18n/hooks";
 import { OptType, writeYLog } from "../log/y-log";
-import type { FileInMessage } from "../messages/utils";
-import type { LocalSettings } from "../settings";
-import {
-  isThreadRagModeLocked,
-  lockThreadRagMode,
-  useLocalSettings,
-} from "../settings";
-import { useCitationDisplaySettings } from "../system-settings/hooks";
+import type { FileInMessage } from "../messages/utils";
+import type { LocalSettings } from "../settings";
+import {
+  isThreadRagModeLocked,
+  lockThreadRagMode,
+  useLocalSettings,
+} from "../settings";
+import { useCitationDisplaySettings } from "../system-settings/hooks";
 import { useUpdateSubtask } from "../tasks/context";
 import type { UploadedFileInfo } from "../uploads";
 import { promptInputFilePartToFile, uploadFiles } from "../uploads";
@@ -571,11 +571,11 @@ export function useThreadStream({
   onToolStart,
   onToolEnd,
 }: ThreadStreamOptions) {
-  const { t } = useI18n();
-  const [localSettings] = useLocalSettings();
-  const { data: citationDisplay } = useCitationDisplaySettings();
-  const referenceModeEntryEnabled =
-    citationDisplay?.reference_mode_enabled ?? false;
+  const { t } = useI18n();
+  const [localSettings] = useLocalSettings();
+  const { data: citationDisplay } = useCitationDisplaySettings();
+  const referenceModeEntryEnabled =
+    citationDisplay?.reference_mode_enabled ?? false;
   // Track the thread ID that is currently streaming to handle thread changes during streaming
   const [onStreamThreadId, setOnStreamThreadId] = useState(() => threadId);
   // Ref to track current thread ID across async callbacks without causing re-renders,
@@ -1507,21 +1507,21 @@ export function useThreadStream({
           ...context,
           ...extraContext,
         };
-        const selectedLlmWikiIds = Array.isArray(
-          mergedContext.llmwiki_knowledge_base_ids,
-        )
-          ? mergedContext.llmwiki_knowledge_base_ids
-          : [];
-        const selectedAssistantKnowledgeIds = Array.isArray(
-          mergedContext.assistant_knowledge_base_ids,
-        )
-          ? mergedContext.assistant_knowledge_base_ids
-          : [];
-        const ragModeEnabled =
-          (referenceModeEntryEnabled && localSettings.display.ragModeEnabled) ||
-          isThreadRagModeLocked(threadId) ||
-          selectedLlmWikiIds.length > 0 ||
-          selectedAssistantKnowledgeIds.length > 0;
+        const selectedLlmWikiIds = Array.isArray(
+          mergedContext.llmwiki_knowledge_base_ids,
+        )
+          ? mergedContext.llmwiki_knowledge_base_ids
+          : [];
+        const selectedAssistantKnowledgeIds = Array.isArray(
+          mergedContext.assistant_knowledge_base_ids,
+        )
+          ? mergedContext.assistant_knowledge_base_ids
+          : [];
+        const ragModeEnabled =
+          (referenceModeEntryEnabled && localSettings.display.ragModeEnabled) ||
+          isThreadRagModeLocked(threadId) ||
+          selectedLlmWikiIds.length > 0 ||
+          selectedAssistantKnowledgeIds.length > 0;
         if (ragModeEnabled) {
           lockThreadRagMode(threadId);
         }
@@ -1579,6 +1579,7 @@ export function useThreadStream({
             context: {
               ...mergedContext,
               thinking_enabled: mergedContext.mode !== "flash",
+              thinking_force_disabled: mergedContext.mode === "flash",
               is_plan_mode:
                 mergedContext.mode === "pro" || mergedContext.mode === "ultra",
               subagent_enabled: mergedContext.mode === "ultra",
@@ -1639,18 +1640,18 @@ export function useThreadStream({
         sendInFlightRef.current = false;
       }
     },
-    [
-      thread,
-      _handleOnStart,
-      t.uploads.uploadingFiles,
-      context,
-      referenceModeEntryEnabled,
-      localSettings.display.ragModeEnabled,
-      queryClient,
-      runOptions,
-      confirmOrRejoin,
-    ],
-  );
+    [
+      thread,
+      _handleOnStart,
+      t.uploads.uploadingFiles,
+      context,
+      referenceModeEntryEnabled,
+      localSettings.display.ragModeEnabled,
+      queryClient,
+      runOptions,
+      confirmOrRejoin,
+    ],
+  );
 
   const handleThreadStop = useCallback(async () => {
     const tid = threadIdRef.current;
@@ -1699,7 +1700,7 @@ export function useThreadStream({
       ? undefined
       : thread.error;
 
-  const mergedThread = {
+  const mergedThread = {
     ...thread,
     error: visibleThreadError,
     values: mergedValues,
@@ -1709,7 +1710,7 @@ export function useThreadStream({
         : mergedMessages,
     isLoading: thread.isLoading || streamHoldOpen,
     stop: handleThreadStop,
-  } as typeof thread;
+  } as typeof thread;
 
   // 第 4 个返回值 `onStreamThreadId` = 底层 useStream 当前实际绑定的线程 id（新建/未保存时为 null）。
   // 调用方据此判断「流是否已切到全新线程」，避免在切换会话的那一帧把消息发进上一个会话

frontend-web/src/core/threads/project-metadata.test.ts

@@ -0,0 +1,46 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import {
+  myProjectConversationTypeFromSearchParams,
+  myProjectConversationTypeOfThread,
+  myProjectThreadMetadata,
+  withMyProjectConversationMarker,
+} from "./project-metadata";
+
+test("project conversation type is read from persisted metadata", () => {
+  assert.equal(
+    myProjectConversationTypeOfThread({
+      metadata: myProjectThreadMetadata("strategy"),
+    }),
+    "strategy",
+  );
+  assert.equal(
+    myProjectConversationTypeOfThread({
+      metadata: { project_source: "elsewhere", project_type: "qa" },
+    }),
+    null,
+  );
+});
+
+test("metadata wins over the compatibility context fallback", () => {
+  assert.equal(
+    myProjectConversationTypeOfThread({
+      metadata: myProjectThreadMetadata("solution"),
+      context: myProjectThreadMetadata("qa"),
+    }),
+    "solution",
+  );
+});
+
+test("new-chat route marker round-trips all supported project types", () => {
+  for (const type of ["qa", "strategy", "solution"] as const) {
+    const path = withMyProjectConversationMarker(
+      "/page/strategy/chats/new?keep=1",
+      type,
+    );
+    const params = new URLSearchParams(path.split("?", 2)[1]);
+    assert.equal(params.get("keep"), "1");
+    assert.equal(myProjectConversationTypeFromSearchParams(params), type);
+  }
+});

frontend-web/src/core/threads/project-metadata.ts

@@ -0,0 +1,94 @@
+/**
+ * Stable marker for conversations entered from 「我的项目」.
+ *
+ * Keep this separate from ``project_id``: that key belongs to DeerFlow's
+ * folder-style conversation projects, while this marker describes the product
+ * mode that created (or explicitly continued) a conversation.
+ */
+export const MY_PROJECT_THREAD_SOURCE = "my-projects" as const;
+
+export const MY_PROJECT_THREAD_SOURCE_KEY = "project_source" as const;
+export const MY_PROJECT_THREAD_TYPE_KEY = "project_type" as const;
+
+export const MY_PROJECT_QUERY_SOURCE_KEY = "projectSource" as const;
+export const MY_PROJECT_QUERY_TYPE_KEY = "projectType" as const;
+
+export type MyProjectConversationType = "qa" | "strategy" | "solution";
+
+export const MY_PROJECT_CONVERSATION_LABELS: Record<
+  MyProjectConversationType,
+  string
+> = {
+  qa: "普通问答",
+  strategy: "策略优选",
+  solution: "方案生成",
+};
+
+const MY_PROJECT_CONVERSATION_TYPES = new Set<MyProjectConversationType>([
+  "qa",
+  "strategy",
+  "solution",
+]);
+
+function typeFromRecord(
+  value: Record<string, unknown> | null | undefined,
+): MyProjectConversationType | null {
+  if (value?.[MY_PROJECT_THREAD_SOURCE_KEY] !== MY_PROJECT_THREAD_SOURCE) {
+    return null;
+  }
+  const type = value[MY_PROJECT_THREAD_TYPE_KEY];
+  return typeof type === "string" &&
+    MY_PROJECT_CONVERSATION_TYPES.has(type as MyProjectConversationType)
+    ? (type as MyProjectConversationType)
+    : null;
+}
+
+export function myProjectThreadMetadata(
+  type: MyProjectConversationType,
+): Record<string, unknown> {
+  return {
+    [MY_PROJECT_THREAD_SOURCE_KEY]: MY_PROJECT_THREAD_SOURCE,
+    [MY_PROJECT_THREAD_TYPE_KEY]: type,
+  };
+}
+
+/** Read persisted metadata first; context is only a compatibility fallback. */
+export function myProjectConversationTypeOfThread(thread: {
+  metadata?: Record<string, unknown> | null;
+  context?: Record<string, unknown> | null;
+}): MyProjectConversationType | null {
+  return typeFromRecord(thread.metadata) ?? typeFromRecord(thread.context);
+}
+
+export function myProjectConversationTypeFromSearchParams(params: {
+  get(name: string): string | null;
+}): MyProjectConversationType | null {
+  if (params.get(MY_PROJECT_QUERY_SOURCE_KEY) !== MY_PROJECT_THREAD_SOURCE) {
+    return null;
+  }
+  const type = params.get(MY_PROJECT_QUERY_TYPE_KEY);
+  return typeof type === "string" &&
+    MY_PROJECT_CONVERSATION_TYPES.has(type as MyProjectConversationType)
+    ? (type as MyProjectConversationType)
+    : null;
+}
+
+/** Add an explicit, one-shot marker to a new-conversation route. */
+export function withMyProjectConversationMarker(
+  path: string,
+  type: MyProjectConversationType,
+): string {
+  const hashIndex = path.indexOf("#");
+  const hash = hashIndex >= 0 ? path.slice(hashIndex) : "";
+  const pathWithoutHash = hashIndex >= 0 ? path.slice(0, hashIndex) : path;
+  const queryIndex = pathWithoutHash.indexOf("?");
+  const pathname =
+    queryIndex >= 0 ? pathWithoutHash.slice(0, queryIndex) : pathWithoutHash;
+  const params = new URLSearchParams(
+    queryIndex >= 0 ? pathWithoutHash.slice(queryIndex + 1) : "",
+  );
+  params.set(MY_PROJECT_QUERY_SOURCE_KEY, MY_PROJECT_THREAD_SOURCE);
+  params.set(MY_PROJECT_QUERY_TYPE_KEY, type);
+  const search = params.toString();
+  return `${pathname}${search ? `?${search}` : ""}${hash}`;
+}

frontend-web/src/core/threads/types.ts

@@ -2,18 +2,20 @@ import type { Message, Thread } from "@langchain/langgraph-sdk";
 
 import type { Todo } from "../todos";
 
-export interface AgentThreadState extends Record<string, unknown> {
-  title: string;
-  title_provisional?: boolean;
-  messages: Message[];
-  artifacts: string[];
-  todos?: Todo[];
-}
+export interface AgentThreadState extends Record<string, unknown> {
+  title: string;
+  title_provisional?: boolean;
+  messages: Message[];
+  artifacts: string[];
+  todos?: Todo[];
+}
 
 export interface AgentThreadContext extends Record<string, unknown> {
   thread_id: string;
   model_name: string | undefined;
   thinking_enabled: boolean;
+  /** Flash mode: force vLLM/Qwen ``enable_thinking=false`` even without a per-model disable shape. */
+  thinking_force_disabled?: boolean;
   is_plan_mode: boolean;
   subagent_enabled: boolean;
   reasoning_effort?: "minimal" | "low" | "medium" | "high";
@@ -23,15 +25,15 @@ export interface AgentThreadContext extends Record<string, unknown> {
   rag_mode_enabled?: boolean;
   /** Per-request switch for context compression (上下文压缩). Default off. */
   summarization_enabled?: boolean;
-  /** Per-conversation switch for knowledge-base RAG injection (phase 2). */
-  knowledge_rag_enabled?: boolean;
-  /** DeerFlow LLMWiki mapping ids selected for this conversation. */
-  llmwiki_knowledge_base_ids?: string[];
-  /** Assistant knowledge-base ids selected for this conversation. */
-  assistant_knowledge_base_ids?: string[];
-  /** Direct RAG modes handled in the frontend; these requests never enter Lead Agent. */
-  execution_profile?: "single_round_rag" | "multi_round_rag";
-  agent_id?: string;
+  /** Per-conversation switch for knowledge-base RAG injection (phase 2). */
+  knowledge_rag_enabled?: boolean;
+  /** DeerFlow LLMWiki mapping ids selected for this conversation. */
+  llmwiki_knowledge_base_ids?: string[];
+  /** Assistant knowledge-base ids selected for this conversation. */
+  assistant_knowledge_base_ids?: string[];
+  /** Frontend-only execution paths that never enter Lead Agent (RAG / 极速直连). */
+  execution_profile?: "single_round_rag" | "multi_round_rag" | "direct";
+  agent_id?: string;
   /** @deprecated kept for reading legacy thread metadata; prefer agent_id */
   agent_name?: string;
 }

frontend-web/src/core/threads/use-direct-chat.ts

@@ -0,0 +1,312 @@
+import type { Message } from "@langchain/langgraph-sdk";
+import { useCallback, useEffect, useRef, useState } from "react";
+
+import { apiFetch } from "@/core/api/fetch-client";
+import { getBackendBaseURL } from "@/core/config";
+import { readRuntimeFlag } from "@/env";
+import { createClientId } from "@/lib/client-id";
+
+import { textOfMessage } from "./utils";
+
+const STORAGE_PREFIX = "workspace.direct-chat.";
+const MAX_HISTORY_MESSAGES = 20;
+
+export function isDirectChatProfile(context: unknown): boolean {
+  return (
+    typeof context === "object" &&
+    context !== null &&
+    (context as { execution_profile?: unknown }).execution_profile === "direct"
+  );
+}
+
+/** 是否在模式菜单展示「极速」。仅 runtime-config.js 显式为 "true" 时开启，默认关闭。 */
+export function isTurboModeVisible(): boolean {
+  return readRuntimeFlag("VITE_TURBO_MODE_VISIBLE");
+}
+
+function storageKey(threadId: string) {
+  return `${STORAGE_PREFIX}${threadId}`;
+}
+
+function readStoredMessages(threadId: string): Message[] {
+  if (typeof window === "undefined" || !threadId) return [];
+  try {
+    const raw = window.sessionStorage.getItem(storageKey(threadId));
+    const parsed: unknown = raw ? JSON.parse(raw) : [];
+    return Array.isArray(parsed) ? (parsed as Message[]) : [];
+  } catch {
+    return [];
+  }
+}
+
+function writeStoredMessages(threadId: string, messages: Message[]) {
+  if (typeof window === "undefined" || !threadId) return;
+  try {
+    window.sessionStorage.setItem(storageKey(threadId), JSON.stringify(messages));
+  } catch {
+    // Quota errors must never interrupt an already-running answer.
+  }
+}
+
+function isAbortError(error: unknown): boolean {
+  return error instanceof DOMException
+    ? error.name === "AbortError"
+    : error instanceof Error && error.name === "AbortError";
+}
+
+function historyFromMessages(messages: Message[]): Array<{
+  role: "user" | "assistant";
+  content: string;
+}> {
+  const history: Array<{ role: "user" | "assistant"; content: string }> = [];
+  for (const message of messages) {
+    if (message.type !== "human" && message.type !== "ai") continue;
+    const content = textOfMessage(message)?.trim();
+    if (!content) continue;
+    history.push({
+      role: message.type === "human" ? "user" : "assistant",
+      content,
+    });
+  }
+  return history.slice(-MAX_HISTORY_MESSAGES);
+}
+
+function parseSseBlocks(buffer: string): {
+  events: Array<{ event?: string; data: string }>;
+  rest: string;
+} {
+  const parts = buffer.split("\n\n");
+  const rest = parts.pop() ?? "";
+  const events: Array<{ event?: string; data: string }> = [];
+  for (const part of parts) {
+    let event: string | undefined;
+    const dataLines: string[] = [];
+    for (const line of part.split("\n")) {
+      if (line.startsWith(":")) continue;
+      if (line.startsWith("event:")) event = line.slice(6).trim();
+      else if (line.startsWith("data:")) dataLines.push(line.slice(5).trimStart());
+    }
+    if (dataLines.length > 0) {
+      events.push({ event, data: dataLines.join("\n") });
+    }
+  }
+  return { events, rest };
+}
+
+async function readErrorDetail(response: Response): Promise<string> {
+  try {
+    const payload: unknown = await response.json();
+    if (
+      payload &&
+      typeof payload === "object" &&
+      "detail" in payload &&
+      typeof (payload as { detail: unknown }).detail === "string"
+    ) {
+      return (payload as { detail: string }).detail;
+    }
+  } catch {
+    // Fall through to status text.
+  }
+  return `极速问答失败（${response.status}）`;
+}
+
+/**
+ * Frontend-only adapter that talks to Gateway ``POST /api/direct-chat/stream``.
+ * It never submits a LangGraph run or touches the lead-agent stack.
+ */
+export function useDirectChatMessages(threadId: string | undefined) {
+  const [messages, setMessages] = useState<Message[]>(() =>
+    readStoredMessages(threadId ?? ""),
+  );
+  const messagesRef = useRef(messages);
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const controllerRef = useRef<AbortController | null>(null);
+
+  useEffect(() => {
+    const stored = readStoredMessages(threadId ?? "");
+    messagesRef.current = stored;
+    setMessages(stored);
+    setError(null);
+  }, [threadId]);
+
+  useEffect(() => {
+    messagesRef.current = messages;
+  }, [messages]);
+
+  useEffect(() => () => controllerRef.current?.abort(), []);
+
+  const updateMessages = useCallback(
+    (targetThreadId: string, updater: (current: Message[]) => Message[]) => {
+      setMessages((current) => {
+        const next = updater(current);
+        messagesRef.current = next;
+        writeStoredMessages(targetThreadId, next);
+        return next;
+      });
+    },
+    [],
+  );
+
+  const stop = useCallback(() => controllerRef.current?.abort(), []);
+
+  const submit = useCallback(
+    async ({
+      targetThreadId,
+      query,
+      modelName,
+    }: {
+      targetThreadId: string;
+      query: string;
+      modelName?: string;
+    }) => {
+      if (isLoading) return;
+      const question = query.trim();
+      if (!question) return;
+
+      const humanId = createClientId("direct-human");
+      const assistantId = createClientId("direct-ai");
+      const clientTs = new Date().toISOString();
+      const history = historyFromMessages(messagesRef.current);
+      const userMessage: Message = {
+        id: humanId,
+        type: "human",
+        content: [{ type: "text", text: question }],
+        additional_kwargs: { client_ts: clientTs, direct_chat: true },
+      };
+      const initialAssistant: Message = {
+        id: assistantId,
+        type: "ai",
+        content: "",
+        additional_kwargs: { direct_chat: true },
+      };
+      updateMessages(targetThreadId, (current) => [
+        ...current,
+        userMessage,
+        initialAssistant,
+      ]);
+      setError(null);
+      setIsLoading(true);
+
+      const controller = new AbortController();
+      controllerRef.current = controller;
+      let answer = "";
+
+      const refreshAssistant = (content: string) => {
+        updateMessages(targetThreadId, (current) =>
+          current.map((item) =>
+            item.id === assistantId
+              ? ({
+                  ...item,
+                  content,
+                  additional_kwargs: {
+                    ...item.additional_kwargs,
+                    direct_chat: true,
+                  },
+                } as Message)
+              : item,
+          ),
+        );
+      };
+
+      try {
+        const response = await apiFetch(
+          `${getBackendBaseURL()}/api/direct-chat/stream`,
+          {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            signal: controller.signal,
+            body: JSON.stringify({
+              model_name: modelName,
+              messages: [...history, { role: "user", content: question }],
+            }),
+          },
+        );
+        if (!response.ok) {
+          throw new Error(await readErrorDetail(response));
+        }
+        if (!response.body) {
+          throw new Error("极速问答未返回数据流。");
+        }
+
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        while (true) {
+          const { done, value } = await reader.read();
+          if (done) break;
+          buffer += decoder.decode(value, { stream: true });
+          const parsed = parseSseBlocks(buffer);
+          buffer = parsed.rest;
+          for (const block of parsed.events) {
+            let payload: unknown = null;
+            try {
+              payload = JSON.parse(block.data);
+            } catch {
+              continue;
+            }
+            if (block.event === "error") {
+              const detail =
+                payload &&
+                typeof payload === "object" &&
+                "detail" in payload &&
+                typeof (payload as { detail: unknown }).detail === "string"
+                  ? (payload as { detail: string }).detail
+                  : "极速问答失败。";
+              throw new Error(detail);
+            }
+            if (
+              block.event === "delta" &&
+              payload &&
+              typeof payload === "object" &&
+              "text" in payload &&
+              typeof (payload as { text: unknown }).text === "string"
+            ) {
+              answer += (payload as { text: string }).text;
+              refreshAssistant(answer);
+            }
+            if (
+              block.event === "result" &&
+              payload &&
+              typeof payload === "object" &&
+              "answer" in payload &&
+              typeof (payload as { answer: unknown }).answer === "string"
+            ) {
+              answer = (payload as { answer: string }).answer;
+              refreshAssistant(answer);
+            }
+          }
+        }
+        if (!answer) {
+          throw new Error("模型未返回任何文本。");
+        }
+      } catch (caught) {
+        if (!isAbortError(caught)) {
+          const message =
+            caught instanceof Error ? caught.message : "极速问答失败。";
+          setError(message);
+          updateMessages(targetThreadId, (current) =>
+            current.map((item) =>
+              item.id === assistantId
+                ? ({
+                    ...item,
+                    content: answer || message,
+                    additional_kwargs: {
+                      ...item.additional_kwargs,
+                      direct_chat: true,
+                    },
+                  } as Message)
+                : item,
+            ),
+          );
+        }
+      } finally {
+        if (controllerRef.current === controller) controllerRef.current = null;
+        setIsLoading(false);
+      }
+    },
+    [isLoading, updateMessages],
+  );
+
+  return { messages, isLoading, error, submit, stop };
+}

frontend-web/src/eightbf-roundtable/api/task-context.ts

@@ -116,6 +116,14 @@ export interface EightBfTaskProcessReportReceipt {
   id: string;
 }
 
+/**
+ * 外部任务系统要求 8BF 会商页提交的过程产物携带 eightTask=1，
+ * 用于与岗位会商等其它入口的产物区分来源。
+ */
+function processReportBody(input: EightBfTaskProcessReportInput): string {
+  return JSON.stringify({ ...input, eightTask: 1 });
+}
+
 /**
  * 当前 DeerFlow 的外部业务请求适配器沿用任务系统的默认约定：使用
  * `Authorization: Bearer admin`，而不是 DeerFlow 登录接口返回的 token。
@@ -180,7 +188,7 @@ export async function createEightBfTaskProcessReport(
   const response = await fetchExternalTaskSystem(PROCESS_REPORT_ADD_PATH, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
-    body: JSON.stringify(input),
+    body: processReportBody(input),
   });
   if (!response.ok) throw await externalTaskError(response, "过程产物登记失败");
   const id = findProcessReportId(await response.json().catch(() => null));
@@ -198,7 +206,7 @@ export async function updateEightBfTaskProcessReport(
     {
       method: "PUT",
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(input),
+      body: processReportBody(input),
     },
   );
   if (!response.ok) throw await externalTaskError(response, "过程产物提交失败");

frontend-web/src/eightbf-roundtable/pages/EightBfRoundtablePage.tsx

@@ -88,14 +88,29 @@ export default function EightBfRoundtablePage({ compactChrome = false }: { compa
     () => buildEightBfTaskContext(task, taskDictionaries),
     [task, taskDictionaries],
   );
+  // 席位「产物提交 position」映射：业务链里逐席位配置的 artifact_position（agent_id → 值）。
+  // 提交产物时按产出该产物的席位智能体取值；未配置的席位不进 map（提交时回退默认 0）。
+  const artifactPositionByAgent = useMemo(() => {
+    const map = new Map<string, number>();
+    for (const seat of configuredChain?.seats ?? []) {
+      if (typeof seat.artifact_position === "number" && Number.isFinite(seat.artifact_position)) {
+        map.set(seat.agent_id, seat.artifact_position);
+      }
+    }
+    return map;
+  }, [configuredChain]);
   const taskArtifactSubmissionConfig = useMemo<TaskArtifactSubmissionConfig | undefined>(
     () => taskId ? {
       taskId,
       position: 0,
+      positionFor: (target) => {
+        const agentId = target.agentId?.trim();
+        return agentId ? artifactPositionByAgent.get(agentId) ?? null : null;
+      },
       createProcessReport: createEightBfTaskProcessReport,
       updateProcessReport: updateEightBfTaskProcessReport,
     } : undefined,
-    [taskId],
+    [taskId, artifactPositionByAgent],
   );
 
   useEffect(() => {

frontend-web/src/lib/knowledge-message.ts

@@ -0,0 +1,4 @@
+/** Neutral product terminology for system messages; never apply to knowledge content or API identifiers. */
+export function userFacingKnowledgeMessage(value: string): string {
+  return value.replace(/weknora/gi, "知识服务");
+}

frontend-web/src/pages/AgentChatPage.tsx

@@ -13,6 +13,7 @@ import { useLocation } from "react-router-dom";
 import { useRouteBase } from "@/core/route-base";
 import { useCallback, useEffect, useMemo, useRef, useState, type ReactNode } from "react";
 import { useQuery } from "@tanstack/react-query";
+import { toast } from "sonner";
 
 import type { PromptInputMessage } from "@/components/ai-elements/prompt-input";
 import { Button } from "@/components/ui/button";
@@ -48,6 +49,7 @@ import { useNotification } from "@/core/notification/hooks";
 import { saveLastAgentId, useThreadSettings } from "@/core/settings";
 import { stopActiveThreadBeforeClarificationReply, stopThreadRun, useThreadStream } from "@/core/threads/hooks";
 import { useResearchWritingFeed } from "@/core/threads/use-research-writing-feed";
+import { useDirectChatMessages, isDirectChatProfile, isTurboModeVisible } from "@/core/threads/use-direct-chat";
 import { clearResearchReportStream } from "@/core/threads/use-research-report-stream";
 import { textOfMessage } from "@/core/threads/utils";
 import { resolveWritingModeReportPath } from "@/core/threads/writing-mode";
@@ -560,9 +562,26 @@ export default function AgentChatPage({
     },
   });
 
+  const directChat = useDirectChatMessages(threadId);
+  const directChatSelected =
+    isDirectChatProfile(settings.context) && isTurboModeVisible();
+
   // 写作模式深度研究进度：注入 displayThread 尾部（进度步骤条 + report.md
   // 流式 stub），成功且真实产物落地后自动撤出。
-  const { displayThread } = useResearchWritingFeed(threadId, thread);
+  const { displayThread: researchDisplayThread } = useResearchWritingFeed(threadId, thread);
+  const displayThread = useMemo(() => {
+    const base = researchDisplayThread;
+    if (directChat.messages.length === 0 && !directChat.isLoading) {
+      return base;
+    }
+    const messages = [...base.messages, ...directChat.messages];
+    return {
+      ...base,
+      values: { ...base.values, messages },
+      messages,
+      isLoading: base.isLoading || directChat.isLoading,
+    } as typeof base;
+  }, [directChat.isLoading, directChat.messages, researchDisplayThread]);
 
   // ── agentfx「入库」协助卡 ──────────────────────────────────────────────────
   // 任务工作区（taskBind）里，内置研判智能体写出的 task-reports.json 产物落地且
@@ -743,6 +762,62 @@ export default function AgentChatPage({
 
   const handleSubmit = useCallback(
     (message: PromptInputMessage, extraContext?: Record<string, unknown>) => {
+      if (directChatSelected) {
+        if (message.files && message.files.length > 0) {
+          toast.error("极速问答暂不支持附件，请移除附件后重试。");
+          return;
+        }
+        setHasStartedConversation(true);
+        saveLastAgentId(agent_id);
+        window.dispatchEvent(
+          new CustomEvent("workspace:sandbox-resume-autoscroll"),
+        );
+        void (async () => {
+          try {
+            let targetThreadId = threadId;
+            if (isNewThread) {
+              const created = await getAPIClient().threads.create({
+                metadata: {
+                  agent_id,
+                  ...(Object.keys(conversationMetadata).length > 0
+                    ? conversationMetadata
+                    : {}),
+                },
+              });
+              targetThreadId = created.thread_id;
+              knowledgeSelectionThread.current = targetThreadId;
+              activeThreadIdRef.current = targetThreadId;
+              setThreadId(targetThreadId);
+              setIsNewThread(false);
+              history.replaceState(
+                null,
+                "",
+                `${window.location.pathname}${window.location.search}#${agentChatsBase}/${targetThreadId}`,
+              );
+              const title = message.text.trim().replace(/\s+/g, " ").slice(0, 60);
+              if (title) {
+                void getAPIClient().threads
+                  .updateState(targetThreadId, { values: { title } })
+                  .catch(() => undefined);
+              }
+            }
+            if (!targetThreadId) {
+              toast.error("无法创建会话。");
+              return;
+            }
+            await directChat.submit({
+              targetThreadId,
+              query: message.text,
+              modelName: settings.context.model_name,
+            });
+          } catch (error) {
+            toast.error(
+              error instanceof Error ? error.message : "极速问答失败。",
+            );
+          }
+        })();
+        return;
+      }
       setHasStartedConversation(true);
       // Remember this agent so the new-chat landing screen pre-selects it next
       // time (covers both direct agent chats and the ChatPage handoff replay).
@@ -767,7 +842,7 @@ export default function AgentChatPage({
         ...pageReportThemeContext,
       });
     },
-    [sendMessage, threadId, agent_id, settings.context.writing_mode, writingArtifactPath, baseMode],
+    [sendMessage, threadId, agent_id, settings.context.writing_mode, settings.context.model_name, writingArtifactPath, baseMode, directChat, directChatSelected, isNewThread, conversationMetadata, agentChatsBase, setThreadId, setIsNewThread],
   );
 
   // 任务流程：切换 / 新建会话时，停掉「上一会话服务端在跑」的 run（老对话要停止）。
@@ -852,8 +927,12 @@ export default function AgentChatPage({
   );
 
   const handleStop = useCallback(async () => {
+    if (directChat.isLoading) {
+      directChat.stop();
+      return;
+    }
     await thread.stop();
-  }, [thread]);
+  }, [directChat, thread]);
 
   const isLandingState = isNewThread && !hasStartedConversation;
   // 任务闸门面板：仅 rwfx（taskGate）在新建对话且尚未开始时，于问答页顶部展示目的树 + 覆盖确认。
@@ -867,7 +946,7 @@ export default function AgentChatPage({
 
   const status = thread.error
     ? "error"
-    : thread.isLoading
+    : thread.isLoading || directChat.isLoading
       ? "streaming"
       : "ready";
 
@@ -1084,7 +1163,7 @@ export default function AgentChatPage({
                         autoFocus
                         status={status}
                         context={settings.context}
-                        disabled={isDemoMode || knowledgeSelectionLoading}
+                        disabled={isDemoMode || knowledgeSelectionLoading || directChat.isLoading}
                         onContextChange={(context) =>
                           setSettings("context", context)
                         }
@@ -1104,7 +1183,7 @@ export default function AgentChatPage({
                                 pendingKnowledgeSelection.current === null &&
                                 pendingAssistantKnowledgeSelection.current === null
                               }
-                              disabled={isDemoMode || knowledgeSelectionLoading}
+                              disabled={isDemoMode || knowledgeSelectionLoading || directChat.isLoading}
                               label="知识空间"
                             />
                           )
@@ -1175,7 +1254,7 @@ export default function AgentChatPage({
                         assistantId={agent_id}
                         status={status}
                         context={settings.context}
-                        disabled={isDemoMode || knowledgeSelectionLoading}
+                        disabled={isDemoMode || knowledgeSelectionLoading || directChat.isLoading}
                         onContextChange={(context) =>
                           setSettings("context", context)
                         }
@@ -1190,7 +1269,7 @@ export default function AgentChatPage({
                               assistantValue={selectedAssistantKnowledgeBaseIds}
                               onChange={changeKnowledgeSelection}
                               onAssistantChange={changeAssistantKnowledgeSelection}
-                              disabled={isDemoMode || knowledgeSelectionLoading}
+                              disabled={isDemoMode || knowledgeSelectionLoading || directChat.isLoading}
                               readOnly
                               label="知识空间"
                             />

frontend-web/src/pages/AssistantKnowledgePage.tsx

@@ -1,3 +1,4 @@
+import { userFacingKnowledgeMessage } from "@/lib/knowledge-message";
 import {
   ArrowLeft,
   BookOpenText,
@@ -67,6 +68,7 @@ export default function AssistantKnowledgePage() {
     ReturnType<typeof searchAssistantWiki>
   > | null>(null);
   const upload = useRef<HTMLInputElement>(null);
+  const documentUpload = useRef<HTMLInputElement>(null);
   const base = bases.data?.find((b) => b.id === baseId);
   const libraryPages = useMemo<LibraryWikiPage[]>(
     () =>
@@ -159,8 +161,7 @@ export default function AssistantKnowledgePage() {
             <div>
               <h1 className="text-2xl font-semibold">助手知识库</h1>
               <p className="mt-2 text-sm text-muted-foreground">
-                浏览分类
-                Wiki、关联知识与来源。普通知识库向量化完成后自动沉淀到知识梳理。
+                选择或新建知识库，上传文档后自动生成分类 Wiki、关联知识和向量索引。可独立使用，也可导入 普通知识库数据包；各库知识汇入知识梳理总库。
               </p>
             </div>
             {isAdmin && (
@@ -306,6 +307,12 @@ export default function AssistantKnowledgePage() {
                   删除
                 </Button>
               )}
+              {isAdmin && (
+                <Button size="sm" disabled={actions.uploadDocument.isPending} onClick={() => documentUpload.current?.click()}>
+                  {actions.uploadDocument.isPending ? <Loader2 className="mr-2 size-4 animate-spin" /> : <Upload className="mr-2 size-4" />}
+                  上传文件生成 Wiki
+                </Button>
+              )}
               {isAdmin && (
                 <Button
                   variant="outline"
@@ -314,10 +321,23 @@ export default function AssistantKnowledgePage() {
                   onClick={() => upload.current?.click()}
                 >
                   <Upload className="mr-2 size-4" />
-                  导入数据包
+                  导入 普通知识库数据包
                 </Button>
               )}
             </div>
+            <input ref={documentUpload} type="file" multiple accept=".md,.markdown,.txt,.csv,.pdf,.doc,.docx,.xls,.xlsx,.ppt,.pptx,.odt,.ods,.odp" className="hidden"
+              onChange={async (event) => {
+                const files = Array.from(event.target.files || []);
+                event.target.value = "";
+                setTab("transfer");
+                for (const file of files) {
+                  if (file.size > 100 * 1024 * 1024) { toast.error(`${file.name} 超过 100 MB，请拆分后上传`); continue; }
+                  try {
+                    await actions.uploadDocument.mutateAsync({ file, assistantBaseId: baseId });
+                    toast.success(`${file.name} 已上传，后台正在解析、生成 Wiki 并向量化`);
+                  } catch (error) { toast.error(`${file.name}：${(error as Error).message}`); }
+                }
+              }} />
             <input
               ref={upload}
               type="file"
@@ -441,7 +461,8 @@ export default function AssistantKnowledgePage() {
                     <p className="mt-2 text-xs text-muted-foreground">
                       上次同步：{new Date(s.updated_at).toLocaleString()}
                     </p>
-                    {isAdmin && (
+                    {s.source_type === "file" && <p className="mt-2 text-xs text-muted-foreground">本地上传文档 · 处理进度及重试请查看导入记录</p>}
+                    {isAdmin && s.source_type === "weknora" && (
                       <Button
                         className="mt-4"
                         size="sm"
@@ -469,8 +490,10 @@ export default function AssistantKnowledgePage() {
               >
                 <WikiPackageTransfers id={baseId} assistant />
                 <h2 className="text-base font-semibold">导入与同步记录</h2>
+                <p className="text-sm text-muted-foreground">可直接上传文档，独立生成 Wiki 并进行向量检索，无需配置普通知识库服务。支持 PDF、Word、Excel、PowerPoint、Markdown、TXT、CSV，单文件最大 100 MB。生成失败时可配置语言模型或编码器后重试。</p>
                 {jobs.data?.map((j) => (
                   <div key={j.id} className="rounded-xl border p-4">
+                    <p className="mb-2 font-medium">{sources.data?.find((source) => source.id === j.source_id)?.source_name || (j.trigger === "local_file_upload" ? "上传文档" : "知识数据同步")}</p>
                     <div className="flex items-center gap-3">
                       <Badge variant="outline">
                         {{
@@ -484,6 +507,9 @@ export default function AssistantKnowledgePage() {
                         {new Date(j.created_at).toLocaleString()}
                       </span>
                     </div>
+                    <p className="mt-2 text-sm text-muted-foreground">{({ uploading: "接收文件", parsing: "解析文档", generating_wiki: "生成 Wiki", vectorizing: "正文向量化", importing: "保存知识并同步总库", queued: "等待处理", interrupted: "处理已中断" } as Record<string, string>)[j.phase] || j.phase}</p>
+                    {j.counts?.parts_total > 0 && <p className="text-xs text-muted-foreground">文档分段：{j.counts.parts_done || 0} / {j.counts.parts_total}</p>}
+                    {j.counts?.vectors_total > 0 && <p className="text-xs text-muted-foreground">向量化：{j.counts.vectors || 0} / {j.counts.vectors_total}</p>}
                     <p className="mt-3 text-sm">
                       {j.counts?.wiki_pages || 0} Wiki ·{" "}
                       {j.counts?.vectors || 0} 向量 · {j.counts?.entities || 0}{" "}
@@ -491,9 +517,15 @@ export default function AssistantKnowledgePage() {
                     </p>
                     {j.last_error_message && (
                       <p className="mt-2 text-sm text-destructive">
-                        {j.last_error_message}
+                        {userFacingKnowledgeMessage(j.last_error_message)}
                       </p>
                     )}
+                    {j.trigger === "local_file_upload" && j.status !== "completed" && (
+                      <Button className="mt-2" size="sm" variant="outline" disabled={actions.retryDocument.isPending} onClick={async () => {
+                        try { await actions.retryDocument.mutateAsync(j.id); toast.success("已继续处理，复用已有解析和向量结果"); }
+                        catch (error) { toast.error((error as Error).message); }
+                      }}>重试 / 恢复处理</Button>
+                    )}
                   </div>
                 ))}
               </TabsContent>

frontend-web/src/pages/ChatPage.tsx

@@ -64,11 +64,16 @@ import {
   useThreadSettings,
 } from "@/core/settings";
 import { useThreadStream, stopActiveThreadBeforeClarificationReply } from "@/core/threads/hooks";
+import {
+  myProjectConversationTypeFromSearchParams,
+  myProjectThreadMetadata,
+} from "@/core/threads/project-metadata";
 import { useResearchWritingFeed } from "@/core/threads/use-research-writing-feed";
 import { clearResearchReportStream } from "@/core/threads/use-research-report-stream";
 import { resolveWritingModeReportPath } from "@/core/threads/writing-mode";
 import { queueLlmWikiConversationDeposit } from "@/core/llmwiki/conversation-deposit";
 import { useSingleRoundRagMessages } from "@/core/threads/use-single-round-rag";
+import { useDirectChatMessages, isDirectChatProfile, isTurboModeVisible } from "@/core/threads/use-direct-chat";
 import { useMultiRoundRagMessages, mergeMessagesByTime, toLangGraphMessages } from "@/core/threads/use-multi-round-rag";
 import { useLayoutMode } from "@/core/system-settings/hooks";
 import { useRouteBase } from "@/core/route-base";
@@ -285,16 +290,28 @@ export default function ChatPage() {
   }, [selectedAgentId, selectorAgents, mineAgents, squareAgents, selectorLoading]);
 
   const { showNotification } = useNotification();
+  const projectConversationType =
+    myProjectConversationTypeFromSearchParams(searchParams);
+  const newThreadMetadata = useMemo<Record<string, unknown> | undefined>(() => {
+    const metadata: Record<string, unknown> = projectConversationType
+      ? myProjectThreadMetadata(projectConversationType)
+      : {};
+    if (knowledgeSelectionReady) {
+      metadata.llmwiki_knowledge_base_ids = selectedKnowledgeBaseIds;
+      metadata.assistant_knowledge_base_ids = selectedAssistantKnowledgeBaseIds;
+    }
+    return Object.keys(metadata).length > 0 ? metadata : undefined;
+  }, [
+    knowledgeSelectionReady,
+    projectConversationType,
+    selectedAssistantKnowledgeBaseIds,
+    selectedKnowledgeBaseIds,
+  ]);
 
   const [thread, sendMessage, isUploading] = useThreadStream({
     threadId: isNewThread ? undefined : threadId,
     context: streamContext,
-    threadMetadata: knowledgeSelectionReady
-      ? {
-          llmwiki_knowledge_base_ids: selectedKnowledgeBaseIds,
-          assistant_knowledge_base_ids: selectedAssistantKnowledgeBaseIds,
-        }
-      : undefined,
+    threadMetadata: newThreadMetadata,
     isMock,
     onStart: (createdThreadId) => {
       knowledgeSelectionThread.current = createdThreadId;
@@ -348,9 +365,12 @@ export default function ChatPage() {
   });
   const singleRoundRag = useSingleRoundRagMessages(threadId);
   const multiRoundRag = useMultiRoundRagMessages(threadId);
+  const directChat = useDirectChatMessages(threadId);
   const singleRoundRagSelected = isSingleRoundRagProfile(settings.context);
   const multiRoundRagSelected = isMultiRoundRagProfile(settings.context);
   const frontendRagSelected = isFrontendRagProfile(settings.context);
+  const directChatSelected =
+    isDirectChatProfile(settings.context) && isTurboModeVisible();
   // 写作模式深度研究进度：注入 displayThread 尾部（进度步骤条 + report.md
   // 流式 stub），成功且真实产物落地后自动撤出。
   const { displayThread: researchDisplayThread } = useResearchWritingFeed(threadId, thread);
@@ -360,13 +380,15 @@ export default function ChatPage() {
     if (
       singleRoundRag.messages.length === 0 &&
       ragMessages.length === 0 &&
+      directChat.messages.length === 0 &&
       !singleRoundRag.isLoading &&
-      !multiRoundRag.isLoading
+      !multiRoundRag.isLoading &&
+      !directChat.isLoading
     ) {
       return base;
     }
     const messages = mergeMessagesByTime(
-      [...base.messages, ...singleRoundRag.messages],
+      [...base.messages, ...singleRoundRag.messages, ...directChat.messages],
       ragMessages,
     );
     return {
@@ -374,9 +396,14 @@ export default function ChatPage() {
       values: { ...base.values, messages },
       messages,
       isLoading:
-        base.isLoading || singleRoundRag.isLoading || multiRoundRag.isLoading,
+        base.isLoading ||
+        singleRoundRag.isLoading ||
+        multiRoundRag.isLoading ||
+        directChat.isLoading,
     } as typeof base;
   }, [
+    directChat.isLoading,
+    directChat.messages,
     multiRoundRag.isLoading,
     multiRoundRag.messages,
     researchDisplayThread,
@@ -392,6 +419,52 @@ export default function ChatPage() {
 
   const handleSubmit = useCallback(
     (message: PromptInputMessage) => {
+      if (directChatSelected) {
+        if (message.files && message.files.length > 0) {
+          toast.error("极速问答暂不支持附件，请移除附件后重试。");
+          return;
+        }
+        setHasStartedConversation(true);
+        window.dispatchEvent(
+          new CustomEvent("workspace:sandbox-resume-autoscroll"),
+        );
+        void (async () => {
+          try {
+            let targetThreadId = threadId;
+            if (isNewThread) {
+              const created = await getAPIClient(isMock).threads.create({});
+              targetThreadId = created.thread_id;
+              setThreadId(targetThreadId);
+              setIsNewThread(false);
+              history.replaceState(
+                null,
+                "",
+                `${window.location.pathname}${window.location.search}#${routeBase}/chats/${targetThreadId}`,
+              );
+              const title = message.text.trim().replace(/\s+/g, " ").slice(0, 60);
+              if (title) {
+                void getAPIClient(isMock).threads
+                  .updateState(targetThreadId, { values: { title } })
+                  .catch(() => undefined);
+              }
+            }
+            if (!targetThreadId) {
+              toast.error("无法创建会话。");
+              return;
+            }
+            await directChat.submit({
+              targetThreadId,
+              query: message.text,
+              modelName: settings.context.model_name,
+            });
+          } catch (error) {
+            toast.error(
+              error instanceof Error ? error.message : "极速问答失败。",
+            );
+          }
+        })();
+        return;
+      }
       if (frontendRagSelected) {
         if (message.files && message.files.length > 0) {
           toast.error("RAG 问答暂不支持附件，请移除附件后重试。");
@@ -405,7 +478,9 @@ export default function ChatPage() {
           try {
             let targetThreadId = threadId;
             if (isNewThread) {
-              const created = await getAPIClient(isMock).threads.create({});
+              const created = await getAPIClient(isMock).threads.create({
+                metadata: newThreadMetadata ?? {},
+              });
               targetThreadId = created.thread_id;
               setThreadId(targetThreadId);
               setIsNewThread(false);
@@ -465,13 +540,8 @@ export default function ChatPage() {
           try {
             const created = await getAPIClient(isMock).threads.create({
               metadata: {
+                ...newThreadMetadata,
                 agent_id: selectedAgentId,
-                ...(knowledgeSelectionReady
-                  ? {
-                      llmwiki_knowledge_base_ids: selectedKnowledgeBaseIds,
-                      assistant_knowledge_base_ids: selectedAssistantKnowledgeBaseIds,
-                    }
-                  : {}),
               },
             });
             sessionStorage.setItem(
@@ -490,7 +560,7 @@ export default function ChatPage() {
             );
             saveLastAgentId(selectedAgentId);
             router.push(
-              `/page/workspace/agents/${selectedAgentId}/chats/${created.thread_id}`,
+              `${routeBase}/agents/${encodeURIComponent(selectedAgentId)}/chats/${encodeURIComponent(created.thread_id)}`,
             );
           } catch (err) {
             agentHandoffPendingRef.current = false;
@@ -549,6 +619,7 @@ export default function ChatPage() {
       selectedAssistantKnowledgeBaseIds,
       selectedKnowledgeBaseIds,
       knowledgeSelectionReady,
+      newThreadMetadata,
       agentHandoffPending,
       isMock,
       router,
@@ -560,6 +631,8 @@ export default function ChatPage() {
       multiRoundRag,
       multiRoundRagSelected,
       frontendRagSelected,
+      directChat,
+      directChatSelected,
       routeBase,
       setIsNewThread,
       setThreadId,
@@ -655,6 +728,10 @@ export default function ChatPage() {
     saveLastAgentId(agentId);
   }, []);
   const handleStop = useCallback(async () => {
+    if (directChat.isLoading) {
+      directChat.stop();
+      return;
+    }
     if (singleRoundRag.isLoading) {
       singleRoundRag.stop();
       return;
@@ -664,7 +741,7 @@ export default function ChatPage() {
       return;
     }
     await thread.stop();
-  }, [multiRoundRag, singleRoundRag, thread]);
+  }, [directChat, multiRoundRag, singleRoundRag, thread]);
 
   const promptPrefixProp = useMemo(() => {
     if (!promptPrefixSettings?.enabled) return undefined;
@@ -914,7 +991,8 @@ export default function ChatPage() {
                         agentHandoffPending ||
                         knowledgeSelectionLoading ||
                         singleRoundRag.isLoading ||
-                        multiRoundRag.isLoading
+                        multiRoundRag.isLoading ||
+                        directChat.isLoading
                       }
                       onContextChange={(context) =>
                         setSettings("context", context)

frontend-web/src/pages/EnterpriseResearchPage.tsx

@@ -1,3 +1,4 @@
+import { userFacingKnowledgeMessage } from "@/lib/knowledge-message";
 import { type FormEvent, useEffect, useMemo, useRef, useState } from "react";
 import {
   AlertCircle,
@@ -211,7 +212,7 @@ export default function EnterpriseResearchPage() {
           setTasks((current) => current.map((task) => task.id === taskId ? { ...task, active_report_job_id: null } : task));
         }
         if (event.type === "completed") toast.success("企业研究报告已完成");
-        if (event.type === "failed") toast.error(event.job.error_message || "报告生成失败");
+        if (event.type === "failed") toast.error(userFacingKnowledgeMessage(event.job.error_message || "报告生成失败"));
       }
     },
   }).catch((error: unknown) => {
@@ -290,7 +291,7 @@ export default function EnterpriseResearchPage() {
       return;
     }
     if (!isWeKnoraReady) {
-      toast.error("知识服务尚未启用，请先在系统中配置 WeKnora");
+      toast.error("知识服务尚未启用，请先在系统中配置知识服务");
       return;
     }
 
@@ -442,7 +443,7 @@ export default function EnterpriseResearchPage() {
               <section>
                 <Badge variant="secondary" className="mb-3"><Sparkles className="size-3" />阶段一：证据编排</Badge>
                 <h2 className="text-xl font-semibold tracking-tight">建立一个可追溯的研究任务</h2>
-                <p className="mt-2 max-w-xl text-sm leading-6 text-muted-foreground">页面独立于现有“深度研究”功能。任务、检索词与证据快照保存在 DeerFlow 后端；当前版本只使用已授权的 WeKnora 知识库，不会修改任何知识库或既有报告。</p>
+                <p className="mt-2 max-w-xl text-sm leading-6 text-muted-foreground">页面独立于现有“深度研究”功能。任务、检索词与证据快照保存在 DeerFlow 后端；当前版本只使用已授权的 普通知识库，不会修改任何知识库或既有报告。</p>
               </section>
 
               <Card>
@@ -609,12 +610,12 @@ function TaskOverview({
       <CardContent><ol className="space-y-4">{template.stages.map((stage, index) => {
         const complete = task.status !== "collecting" && (index < 2 || task.sources.length > 0);
         const current = task.status === "collecting" && index === 1;
-        return <li key={stage} className="flex gap-3"><span className={cn("flex size-7 shrink-0 items-center justify-center rounded-full border text-xs font-semibold", complete ? "border-emerald-300 bg-emerald-50 text-emerald-700" : current ? "border-primary bg-primary/10 text-primary" : "text-muted-foreground")}>{complete ? <CheckCircle2 className="size-4" /> : index + 1}</span><div className="min-w-0 pt-0.5"><p className="text-sm font-medium">{stage}</p><p className="mt-1 text-xs leading-5 text-muted-foreground">{index === 0 ? "已固定研究主题、范围和知识库权限。" : index === 1 ? task.status === "collecting" ? "正在调用 WeKnora 检索并去重证据。" : `已执行 ${task.queries.length} 个检索方向。` : index === 2 ? `${task.sources.length} 条去重后的资料可在右侧逐条核验。` : "研究计划会固定选用资料、章节结构和写作约束。"}</p></div></li>;
+        return <li key={stage} className="flex gap-3"><span className={cn("flex size-7 shrink-0 items-center justify-center rounded-full border text-xs font-semibold", complete ? "border-emerald-300 bg-emerald-50 text-emerald-700" : current ? "border-primary bg-primary/10 text-primary" : "text-muted-foreground")}>{complete ? <CheckCircle2 className="size-4" /> : index + 1}</span><div className="min-w-0 pt-0.5"><p className="text-sm font-medium">{stage}</p><p className="mt-1 text-xs leading-5 text-muted-foreground">{index === 0 ? "已固定研究主题、范围和知识库权限。" : index === 1 ? task.status === "collecting" ? "正在调用知识服务检索并去重证据。" : `已执行 ${task.queries.length} 个检索方向。` : index === 2 ? `${task.sources.length} 条去重后的资料可在右侧逐条核验。` : "研究计划会固定选用资料、章节结构和写作约束。"}</p></div></li>;
       })}</ol></CardContent>
     </Card>
     <Card>
-      <CardHeader className="gap-1"><CardTitle className="text-base">已执行检索词</CardTitle><CardDescription>检索词由模板和你的研究范围生成，结果仅来自当前账号可见的 WeKnora 知识库。</CardDescription></CardHeader>
-      <CardContent><div className="flex flex-wrap gap-2">{task.queries.map((query) => <Badge key={query} variant="outline" className="max-w-full whitespace-normal py-1 text-left"><Search className="size-3" />{query}</Badge>)}</div>{task.warning ? <div className="mt-4 flex gap-2 rounded-md border border-amber-300 bg-amber-50 p-3 text-sm text-amber-900 dark:border-amber-900 dark:bg-amber-950/40 dark:text-amber-100"><AlertCircle className="mt-0.5 size-4 shrink-0" />{task.warning}</div> : null}</CardContent>
+      <CardHeader className="gap-1"><CardTitle className="text-base">已执行检索词</CardTitle><CardDescription>检索词由模板和你的研究范围生成，结果仅来自当前账号可见的 普通知识库。</CardDescription></CardHeader>
+      <CardContent><div className="flex flex-wrap gap-2">{task.queries.map((query) => <Badge key={query} variant="outline" className="max-w-full whitespace-normal py-1 text-left"><Search className="size-3" />{query}</Badge>)}</div>{task.warning ? <div className="mt-4 flex gap-2 rounded-md border border-amber-300 bg-amber-50 p-3 text-sm text-amber-900 dark:border-amber-900 dark:bg-amber-950/40 dark:text-amber-100"><AlertCircle className="mt-0.5 size-4 shrink-0" />{userFacingKnowledgeMessage(task.warning)}</div> : null}</CardContent>
     </Card>
     {canPlan ? <Card>
       <CardHeader className="gap-1"><CardTitle className="text-base">研究计划与选用资料</CardTitle><CardDescription>计划和资料选择会保存到当前任务；后续报告只能使用这里确认过的证据。</CardDescription></CardHeader>

frontend-web/src/pages/LlmWikiKnowledgePage.tsx

@@ -91,7 +91,7 @@ export default function LlmWikiKnowledgePage({
     return <Navigate to="/page/workspace/knowledge/assistant" replace />;
   }
 
-  if (runtime.isError || runtime.data?.provider !== "weknora") {
+  if (runtime.isError || runtime.data?.provider !== "weknora" || !runtime.data?.api_base_url?.trim()) {
     if (mode === "list" || mode === "detail") {
       return <Navigate to="/page/workspace/knowledge/assistant" replace />;
     }

frontend-web/src/pages/OfficialDeerFlowEntry.tsx

@@ -5,6 +5,7 @@ import {
   ChevronDown,
   CircleHelp,
   Clock3,
+  FolderKanban,
   LoaderCircle,
   MessageSquareText,
   PanelLeftClose,
@@ -20,7 +21,12 @@ import {
 } from "lucide-react";
 import { type FormEvent, useCallback, useMemo, useState } from "react";
 import { useLocation, useNavigate } from "react-router-dom";
+import { Toaster } from "sonner";
 
+import {
+  MyProjectThreadBadge,
+  MyProjectThreadIcon,
+} from "@/components/workspace/my-project-thread-indicator";
 import { useAgent, useAgents } from "@/core/agents";
 import { getAccountDisplayName } from "@/core/auth";
 import {
@@ -29,28 +35,41 @@ import {
   useScheduledTaskRuns,
   useScheduledTasks,
 } from "@/core/scheduled-tasks";
-import { useLocalSettings } from "@/core/settings";
 import {
   useAppearanceSettings,
   useCitationDisplaySettings,
 } from "@/core/system-settings/hooks";
 import { useThreadStream, useThreads } from "@/core/threads/hooks";
+import {
+  myProjectConversationTypeOfThread,
+  myProjectConversationTypeFromSearchParams,
+  myProjectThreadMetadata,
+} from "@/core/threads/project-metadata";
 import { textOfMessage, titleOfThread } from "@/core/threads/utils";
 import { uuid } from "@/core/utils/uuid";
 import {
   OFFICIAL_DEERFLOW_HOME_ROUTE,
   OFFICIAL_DEERFLOW_ROUTE_PREFIX,
 } from "@/core/official-deerflow/routes";
+import StrategyProjectsPage from "@/strategy-selection/StrategyProjectsPage";
+import StrategySelectionPage from "@/strategy-selection/StrategySelectionPage";
 
 import "./official-deerflow-entry.css";
 
-type OfficialPage = "chat" | "agents" | "agent-chat" | "scheduled" | "settings";
+type OfficialPage =
+  | "chat"
+  | "projects"
+  | "agents"
+  | "agent-chat"
+  | "scheduled"
+  | "settings";
 
 function pageFromPath(pathname: string): OfficialPage {
   const path = pathname.slice(OFFICIAL_DEERFLOW_ROUTE_PREFIX.length);
   if (path.startsWith("/workspace/agents/") && path.includes("/chats")) {
     return "agent-chat";
   }
+  if (path.startsWith("/workspace/projects")) return "projects";
   if (path.startsWith("/workspace/agents")) return "agents";
   if (path.startsWith("/workspace/scheduled-tasks")) return "scheduled";
   if (path.startsWith("/workspace/settings")) return "settings";
@@ -78,6 +97,11 @@ function parseScheduledTaskId(pathname: string) {
   return match ? decodeURIComponent(match[1]!) : null;
 }
 
+function parseProjectId(pathname: string) {
+  const match = pathname.match(/\/workspace\/projects\/([^/]+)/);
+  return match ? decodeURIComponent(match[1]!) : null;
+}
+
 function readableError(error: unknown, fallback: string) {
   return error instanceof Error && error.message ? error.message : fallback;
 }
@@ -159,20 +183,36 @@ function ChatWorkspace({
   routeThreadId: string;
 }) {
   const navigate = useNavigate();
+  const location = useLocation();
   const [prompt, setPrompt] = useState("");
   const [sendError, setSendError] = useState<string | null>(null);
   const isNewThread = routeThreadId === "new";
+  const projectConversationType = isNewThread
+    ? myProjectConversationTypeFromSearchParams(
+        new URLSearchParams(location.search),
+      )
+    : null;
   // A new conversation uses the same client-generated id approach as the
   // existing ChatPage. The backend owns the persisted id once streaming starts.
   const [draftThreadId] = useState<string>(() => uuid() as string);
   const activeThreadId = isNewThread ? draftThreadId : routeThreadId;
   const { agent } = useAgent(agentId, { enabled: !!agentId });
-  const [localSettings] = useLocalSettings();
   const [thread, sendMessage, isUploading] = useThreadStream({
     threadId: isNewThread ? undefined : routeThreadId,
     assistantId: agentId ?? undefined,
+    threadMetadata: projectConversationType
+      ? myProjectThreadMetadata(projectConversationType)
+      : undefined,
     context: {
-      ...localSettings.context,
+      // This compact official shell has no model/mode controls of its own.
+      // Do not inherit a hidden selection saved by the customized workspace
+      // (for example an obsolete or quota-exhausted model); an omitted model
+      // lets the backend resolve the current system default or the agent's
+      // globally configured model.
+      model_name: undefined,
+      mode: undefined,
+      reasoning_effort: undefined,
+      writing_mode: false,
       ...(agentId ? { agent_id: agentId } : {}),
     },
     onStart: (createdThreadId) => {
@@ -658,6 +698,10 @@ export default function OfficialDeerFlowEntry() {
     () => parseScheduledTaskId(location.pathname),
     [location.pathname],
   );
+  const projectId = useMemo(
+    () => parseProjectId(location.pathname),
+    [location.pathname],
+  );
   const { data: threads = [], isLoading: threadsLoading, error: threadsError } =
     useThreads({
       limit: 20,
@@ -666,10 +710,12 @@ export default function OfficialDeerFlowEntry() {
       select: ["thread_id", "updated_at", "values", "metadata"],
     });
   const go = (path: string) => navigate(path);
+  const projectBasePath = `${OFFICIAL_DEERFLOW_ROUTE_PREFIX}/workspace/projects`;
 
   const nav = [
     { icon: PlusSquare, label: "新对话", path: OFFICIAL_DEERFLOW_HOME_ROUTE, pages: ["chat"] },
     { icon: MessageSquareText, label: "对话", path: `${OFFICIAL_DEERFLOW_ROUTE_PREFIX}/workspace/chats/new`, pages: ["chat"] },
+    { icon: FolderKanban, label: "我的项目", path: projectBasePath, pages: ["projects"] },
     { icon: Bot, label: "智能体", path: `${OFFICIAL_DEERFLOW_ROUTE_PREFIX}/workspace/agents`, pages: ["agents", "agent-chat"] },
     { icon: CalendarClock, label: "定时任务", path: `${OFFICIAL_DEERFLOW_ROUTE_PREFIX}/workspace/scheduled-tasks`, pages: ["scheduled"] },
   ] as const;
@@ -706,29 +752,43 @@ export default function OfficialDeerFlowEntry() {
           ) : threadsError ? (
             <p className="official-sidebar-error">对话列表加载失败</p>
           ) : threads.length ? (
-            threads.map((chat) => (
-              <button
-                className={`official-recent-chat${chatRoute.threadId === chat.thread_id ? " is-active" : ""}`}
-                key={chat.thread_id}
-                onClick={() => {
-                  const agentId = typeof chat.context?.agent_id === "string"
-                    ? chat.context.agent_id
-                    : typeof chat.metadata?.agent_id === "string"
-                      ? chat.metadata.agent_id
-                      : null;
-                  go(
-                    agentId
-                      ? `${OFFICIAL_DEERFLOW_ROUTE_PREFIX}/workspace/agents/${encodeURIComponent(agentId)}/chats/${encodeURIComponent(chat.thread_id)}`
-                      : `${OFFICIAL_DEERFLOW_ROUTE_PREFIX}/workspace/chats/${encodeURIComponent(chat.thread_id)}`,
-                  );
-                }}
-                type="button"
-              >
-                <MessageSquareText aria-hidden="true" size={15} />
-                <span>{titleOfThread(chat, "未命名对话")}</span>
-                <small>{formatTimestamp(chat.updated_at)}</small>
-              </button>
-            ))
+            threads.map((chat) => {
+              const projectType = myProjectConversationTypeOfThread(chat);
+              return (
+                <button
+                  className={`official-recent-chat${chatRoute.threadId === chat.thread_id ? " is-active" : ""}`}
+                  key={chat.thread_id}
+                  onClick={() => {
+                    const agentId = typeof chat.context?.agent_id === "string"
+                      ? chat.context.agent_id
+                      : typeof chat.metadata?.agent_id === "string"
+                        ? chat.metadata.agent_id
+                        : null;
+                    go(
+                      agentId
+                        ? `${OFFICIAL_DEERFLOW_ROUTE_PREFIX}/workspace/agents/${encodeURIComponent(agentId)}/chats/${encodeURIComponent(chat.thread_id)}`
+                        : `${OFFICIAL_DEERFLOW_ROUTE_PREFIX}/workspace/chats/${encodeURIComponent(chat.thread_id)}`,
+                    );
+                  }}
+                  type="button"
+                >
+                  {projectType ? (
+                    <MyProjectThreadIcon className="size-[15px]" type={projectType} />
+                  ) : (
+                    <MessageSquareText aria-hidden="true" size={15} />
+                  )}
+                  <span className="official-recent-chat-copy">
+                    <span className="official-recent-chat-title">
+                      {titleOfThread(chat, "未命名对话")}
+                    </span>
+                    {projectType && (
+                      <MyProjectThreadBadge type={projectType} />
+                    )}
+                  </span>
+                  <small>{formatTimestamp(chat.updated_at)}</small>
+                </button>
+              );
+            })
           ) : (
             <p className="official-sidebar-empty">暂无历史对话</p>
           )}
@@ -754,6 +814,17 @@ export default function OfficialDeerFlowEntry() {
             routeThreadId={chatRoute.threadId}
           />
         )}
+        {page === "projects" && (
+          projectId ? (
+            <StrategySelectionPage
+              key={projectId}
+              projectBasePath={projectBasePath}
+              projectId={projectId}
+            />
+          ) : (
+            <StrategyProjectsPage basePath={projectBasePath} />
+          )
+        )}
         {page === "agents" && (
           <AgentsPage
             openAgent={(agentId) =>
@@ -771,6 +842,7 @@ export default function OfficialDeerFlowEntry() {
         {page === "scheduled" && <ScheduledTasksPage selectedTaskId={scheduledTaskId} />}
         {page === "settings" && <SettingsPage />}
       </div>
+      <Toaster position="top-center" />
     </main>
   );
 }

frontend-web/src/pages/StrategyRoutes.tsx

@@ -1,4 +1,4 @@
-import { Navigate, Route, Routes } from "react-router-dom";
+import { Navigate, Route, Routes, useParams } from "react-router-dom";
 import { Toaster } from "sonner";
 
 import { SidebarInset, SidebarProvider } from "@/components/ui/sidebar";
@@ -78,6 +78,8 @@ import UsersPage from "./UsersPage";
 import LlmMetricsPage from "./LlmMetricsPage";
 import AdminScheduledTasksPage from "./AdminScheduledTasksPage";
 import AdminUserActivityPage from "./AdminUserActivityPage";
+import StrategyProjectsPage from "@/strategy-selection/StrategyProjectsPage";
+import StrategySelectionPage from "@/strategy-selection/StrategySelectionPage";
 import { ChatRuntime } from "./WorkspaceRoutes";
 
 /**
@@ -98,6 +100,11 @@ function StrategyChatThreadLayout() {
   );
 }
 
+function StrategyProjectWorkbenchRoute() {
+  const { project_id: projectId = "" } = useParams<{ project_id: string }>();
+  return <StrategySelectionPage key={projectId} projectId={projectId} />;
+}
+
 export default function StrategyRoutes() {
   const storedAuth = getStoredAuth();
   const canManageBusinessMappings = !storedAuth || storedAuth.system_role === "admin";
@@ -110,6 +117,20 @@ export default function StrategyRoutes() {
             <Route index element={<Navigate to="qa/general" replace />} />
 
             <Route path="qa/general" element={<GeneralQA />} />
+            <Route
+              path="qa/projects"
+              element={
+                <StrategyProjectsPage basePath="/page/strategy/qa/projects" />
+              }
+            />
+            <Route
+              path="qa/projects/:project_id"
+              element={<StrategyProjectWorkbenchRoute />}
+            />
+            <Route
+              path="qa/strategy-selection"
+              element={<Navigate to="/page/strategy/qa/projects" replace />}
+            />
             <Route
               path="qa/expert-qa"
               element={

frontend-web/src/pages/official-deerflow-entry.css

@@ -64,6 +64,8 @@
 .official-recent-section > p { color: #90908e; font-size: 12px; margin: 0 8px 9px; }
 .official-recent-chat { display: grid; font-size: 13px; gap: 8px; grid-template-columns: 15px minmax(0, 1fr) auto; padding: 8px; }
 .official-recent-chat span { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.official-recent-chat-copy { align-items: center; display: flex; gap: 6px; min-width: 0; }
+.official-recent-chat-title { flex: 1; min-width: 0; }
 .official-recent-chat small { color: #acaca9; font-size: 11px; }
 .official-recent-chat.is-active { background: #efefed; color: #252525; }
 .official-sidebar-loading,

frontend-web/src/roundtable-planning/hooks/useTaskArtifactSubmission.ts

@@ -55,12 +55,14 @@ function payloadFrom(
 ): TaskProcessReportPayload {
   const name = target.name?.trim() || fileName(target.path);
   const agentId = target.agentId?.trim() || target.threadId;
+  // 产物提交 position：优先取业务链里给该席位智能体配置的值，未配置回退默认。
+  const position = config.positionFor?.(target) ?? config.position;
   return {
     taskId: config.taskId,
     agentId,
     agentName: target.agentName?.trim() || agentId,
     content,
-    position: config.position,
+    position,
     reportName: name,
     submitStatus,
   };

frontend-web/src/roundtable-planning/lib/business-chain.ts

@@ -55,6 +55,13 @@ export interface ChainSeat {
    * 使同一条业务链既能继续用于原会商，也能在岗位协同中按岗位筛选可问答的智能体。
    */
   position_id?: string | null;
+  /**
+   * 该席位提交过程产物时传给外部任务系统的 `position` 值（8BF 会商页用）。
+   * 不同席位智能体对应不同的产物位置，缺省 / null = 提交时回退 0。
+   * 随 `seats` JSON 落库（无需 DB 列，但需在后端 `ChainSeatSchema` 显式声明）。
+   * 注意与 `position_id`（岗位协同的岗位归属）无关。
+   */
+  artifact_position?: number | null;
   /**
    * 该席位在业务链中配置的岗位职责。会商「智能体配置」面板只读展示；
    * 随 `seats` JSON 落库（无需 DB 列）。空 / 缺省 = 未填写。

frontend-web/src/roundtable-planning/lib/task-artifact-submission.ts

@@ -13,7 +13,14 @@ export interface TaskProcessReportPayload {
 export interface TaskArtifactSubmissionConfig {
   /** External task-system id, not the local roundtable draft storage key. */
   taskId: string;
+  /** 提交产物时传给外部任务系统的默认 position（产物位置）。 */
   position: number;
+  /**
+   * 按席位智能体解析提交产物的 position（业务链里逐席位配置的「产物提交 position」）。
+   * 入参是 hook 解析后的 target（`agentId` 已归一为席位 agent_id）；返回
+   * null / undefined = 该席位未配置，回退 `position` 默认值。
+   */
+  positionFor?: (target: TaskArtifactTarget) => number | null | undefined;
   createProcessReport: (payload: TaskProcessReportPayload) => Promise<{ id: string }>;
   updateProcessReport: (reportId: string, payload: TaskProcessReportPayload) => Promise<void>;
 }

frontend-web/src/roundtable-planning/pages/BusinessChainEditorPage.tsx

@@ -697,6 +697,8 @@ export default function BusinessChainEditorPage() {
           seat_mode: s.seat_mode ?? null,
           // 岗位协同专用岗位归属：普通圆桌忽略，但保存时必须原样保留。
           position_id: s.position_id ?? null,
+          // 席位「产物提交 position」：提交过程产物时传给外部任务系统；null = 回退默认 0。
+          artifact_position: s.artifact_position ?? null,
           // 业务链席位岗位职责：编辑器已不提供输入，保存时原样保留存量值（会商智能体配置面板只读展示）。
           job_responsibilities: s.job_responsibilities?.trim() || null,
         };

frontend-web/src/strategy-components/Header.tsx

@@ -41,10 +41,6 @@ const iconButtonClass = (isDark: boolean, isPaleLightTheme: boolean, isCustomThe
         : "text-white hover:bg-[var(--brand-950)] active:bg-[#8a0618]",
   );
 
-// 深色顶栏菜单左右分组（设计稿：左 问答中心/任务管理/应用中心，右 综合管理/资源管理）
-const LEFT_MENU_IDS = ["qa-center", "task-management", "light-app-center"];
-const RIGHT_MENU_IDS = ["comprehensive-management", "resource-management"];
-
 type HeaderProps = {
   collapsed?: boolean;
 };
@@ -122,8 +118,11 @@ const Header = ({ collapsed }: HeaderProps) => {
 
   const thirdSubNavItems = getActiveThirdLevelItems(visibleMenuItems, pathname);
 
-  const leftMenuItems = visibleMenuItems.filter((i) => LEFT_MENU_IDS.includes(i.id));
-  const rightMenuItems = visibleMenuItems.filter((i) => RIGHT_MENU_IDS.includes(i.id));
+  // 深色顶栏围绕中间标题分成左右两组。直接按菜单管理后的一级顺序均分，确保被升为
+  // 一级或重新排序的节点仍会显示；默认 5 项时仍保持左 3 / 右 2 的原布局。
+  const topMenuSplitIndex = Math.ceil(visibleMenuItems.length / 2);
+  const leftMenuItems = visibleMenuItems.slice(0, topMenuSplitIndex);
+  const rightMenuItems = visibleMenuItems.slice(topMenuSplitIndex);
 
   const handleNavItemClick = (item: MenuItem) => {
     const path = item.path ?? findFirstRoutePath(item.children);

frontend-web/src/strategy-components/api/assistant-knowledge.ts

@@ -2,6 +2,7 @@ import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 
 import { apiFetch } from "@/core/api/fetch-client";
 import { getBackendBaseURL } from "@/core/config";
+import { userFacingKnowledgeMessage } from "@/lib/knowledge-message";
 
 const BASE = () => `${getBackendBaseURL()}/api/assistant-knowledge`;
 
@@ -113,7 +114,7 @@ async function readJson<T>(response: Response): Promise<T> {
         ? (data as { detail: unknown }).detail
         : `请求失败 (${response.status})`;
     throw new Error(
-      typeof detail === "string" ? detail : JSON.stringify(detail),
+      userFacingKnowledgeMessage(typeof detail === "string" ? detail : JSON.stringify(detail)),
     );
   }
   return (await response.json()) as T;
@@ -408,6 +409,17 @@ export async function uploadAssistantWeKnoraPackage(input: {
   );
 }
 
+export async function uploadAssistantDocument(input: { file: File; assistantBaseId?: string | null }) {
+  const body = new FormData();
+  body.set("file", input.file);
+  if (input.assistantBaseId) body.set("assistant_base_id", input.assistantBaseId);
+  return normalizeImportJob(await readJson<AssistantImportJob>(await apiFetch(`${BASE()}/imports/files`, { method: "POST", body })));
+}
+
+export async function retryAssistantDocument(jobId: string) {
+  return readJson<AssistantImportJob>(await apiFetch(`${BASE()}/import-jobs/${encodeURIComponent(jobId)}/retry-file`, { method: "POST" }));
+}
+
 export async function deleteAssistantKnowledgeSource(sourceId: string) {
   const response = await apiFetch(
     `${BASE()}/sources/${encodeURIComponent(sourceId)}`,
@@ -490,6 +502,8 @@ export function useAssistantKnowledgeActions() {
       mutationFn: uploadAssistantWeKnoraPackage,
       onSuccess: invalidate,
     }),
+    uploadDocument: useMutation({ mutationFn: uploadAssistantDocument, onSuccess: invalidate }),
+    retryDocument: useMutation({ mutationFn: retryAssistantDocument, onSuccess: invalidate }),
     reimportSource: useMutation({
       mutationFn: reimportAssistantKnowledgeSource,
       onSuccess: invalidate,

frontend-web/src/strategy-components/api/enterprise-research.ts

@@ -1,3 +1,4 @@
+import { userFacingKnowledgeMessage } from "@/lib/knowledge-message";
 import { apiFetch } from "@/core/api/fetch-client";
 import { getBackendBaseURL } from "@/core/config";
 
@@ -85,7 +86,7 @@ async function readJson<T>(response: Response, context: string): Promise<T> {
     const detail = payload && typeof payload === "object" && "detail" in payload
       ? String((payload as { detail: unknown }).detail)
       : `${context}失败（${response.status}）`;
-    throw new Error(detail);
+    throw new Error(userFacingKnowledgeMessage(detail));
   }
   return response.json() as Promise<T>;
 }
@@ -249,6 +250,6 @@ export async function deleteEnterpriseResearchTask(taskId: string): Promise<void
     const detail = payload && typeof payload === "object" && "detail" in payload
       ? String((payload as { detail: unknown }).detail)
       : `删除研究任务失败（${response.status}）`;
-    throw new Error(detail);
+    throw new Error(userFacingKnowledgeMessage(detail));
   }
 }

frontend-web/src/strategy-components/api/llmwiki.ts

@@ -5,6 +5,7 @@ import { getCsrfToken } from "@/core/api/csrf";
 import { getAuthorizationHeaderValue } from "@/core/auth";
 import { useLiveAccount } from "@/core/auth/use-live-account";
 import { getBackendBaseURL } from "@/core/config";
+import { userFacingKnowledgeMessage } from "@/lib/knowledge-message";
 
 const API = () => `${getBackendBaseURL()}/api/llmwiki`;
 const PUBLIC_API = () => `${getBackendBaseURL()}/api/public/llmwiki`;
@@ -72,6 +73,21 @@ export interface LlmWikiKnowledgeBase {
   is_conversation_deposit?: boolean;
 }
 
+export interface LlmWikiEmbeddingModel {
+  id: string;
+  name: string;
+  provider?: string | null;
+  model_name?: string | null;
+  status?: string | null;
+  is_default: boolean;
+  available: boolean;
+}
+
+export interface LlmWikiEmbeddingModelsResponse {
+  models: LlmWikiEmbeddingModel[];
+  default_model_id?: string | null;
+}
+
 export interface PublicLlmWikiKnowledgeBase extends LlmWikiKnowledgeBase {
   wiki: {
     status: "ready" | "empty" | "unavailable";
@@ -267,6 +283,9 @@ export interface LlmWikiWikiIndexStatus {
 
 export interface LocalWikiEncoderStatus {
   provider: string;
+  configured_provider?: string | null;
+  mode?: "configured" | "local";
+  using_local?: boolean;
   model: string;
   dimensions?: number | null;
   state: "idle" | "starting" | "ready" | "failed";
@@ -366,10 +385,6 @@ export interface LlmWikiWikiPageUpdate {
   wiki_path?: string;
 }
 
-function userFacingKnowledgeMessage(value: string): string {
-  return value.replace(/weknora/gi, "知识服务");
-}
-
 async function readJson<T>(response: Response, context: string): Promise<T> {
   if (!response.ok) {
     const payload = await response.json().catch(() => null as unknown);
@@ -427,6 +442,17 @@ export async function getLlmWikiKnowledgeBase(
   );
 }
 
+export async function listLlmWikiEmbeddingModels(): Promise<LlmWikiEmbeddingModelsResponse> {
+  const payload = await readJson<LlmWikiEmbeddingModelsResponse>(
+    await apiFetch(`${API()}/embedding-models`),
+    "读取知识服务向量模型",
+  );
+  return {
+    models: payload.models ?? [],
+    default_model_id: payload.default_model_id ?? null,
+  };
+}
+
 export async function createLlmWikiWeKnoraEmbedSession(
   id: string,
   tab: "documents" | "wiki" | "graph",
@@ -460,6 +486,7 @@ export async function createLlmWikiKnowledgeBase(input: {
   description: string;
   type: "document" | "faq";
   wiki_enabled?: boolean;
+  embedding_model_id?: string;
 }): Promise<LlmWikiKnowledgeBase> {
   return readJson(
     await apiFetch(`${API()}/knowledge-bases`, {
@@ -657,6 +684,13 @@ export async function configureLocalWikiEncoder(
   );
 }
 
+export async function restoreConfiguredWikiEncoder(): Promise<LocalWikiEncoderStatus> {
+  return readJson(
+    await apiFetch(`${API()}/local-encoder/use-configured`, { method: "POST" }),
+    "恢复配置文件编码器",
+  );
+}
+
 export async function uploadLocalWikiEncoder(
   files: File[],
   onProgress?: (percent: number) => void,
@@ -691,10 +725,15 @@ export async function uploadLocalWikiEncoder(
         payload = null;
       }
       if (request.status < 200 || request.status >= 300) {
-        const detail = payload && typeof payload === "object" && "detail" in payload
+        const rawDetail = payload && typeof payload === "object" && "detail" in payload
           ? (payload as { detail: unknown }).detail
           : `请求失败 (${request.status})`;
-        reject(new Error(typeof detail === "string" ? detail : JSON.stringify(detail)));
+        const detail = rawDetail && typeof rawDetail === "object" && "message" in rawDetail
+          ? String((rawDetail as { message: unknown }).message)
+          : typeof rawDetail === "string"
+            ? rawDetail
+            : JSON.stringify(rawDetail);
+        reject(new Error(userFacingKnowledgeMessage(detail)));
         return;
       }
       onProgress?.(100);
@@ -1271,6 +1310,17 @@ export function useLlmWikiSettings(enabled = true) {
   });
 }
 
+export function useLlmWikiEmbeddingModels(enabled = true) {
+  const { userId } = useLiveAccount();
+  return useQuery({
+    queryKey: ["llmwiki", "embedding-models", userId ?? "anonymous"],
+    queryFn: listLlmWikiEmbeddingModels,
+    enabled,
+    staleTime: 60_000,
+    refetchOnMount: "always",
+  });
+}
+
 export function useLlmWikiActions() {
   const queryClient = useQueryClient();
   const invalidateKnowledge = () =>

frontend-web/src/strategy-components/api/skill-knowledge.ts

@@ -1,3 +1,4 @@
+import { userFacingKnowledgeMessage } from "@/lib/knowledge-message";
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 
 import { apiFetch } from "@/core/api/fetch-client";
@@ -102,7 +103,7 @@ async function readJson<T>(response: Response): Promise<T> {
       data && typeof data === "object" && "detail" in data
         ? JSON.stringify((data as { detail: unknown }).detail)
         : `请求失败 (${response.status})`;
-    throw new Error(detail.replace(/^"|"$/g, ""));
+    throw new Error(userFacingKnowledgeMessage(detail.replace(/^"|"$/g, "")));
   }
   return (await response.json()) as T;
 }

frontend-web/src/strategy-components/components/resource-management/llmwiki/WeKnoraKnowledgeDetailPage.tsx

@@ -17,6 +17,7 @@ import {
 import { toast } from "sonner";
 
 import { Button } from "@/components/ui/button";
+import { useOrdinaryKnowledgeLanding } from "@/components/workspace/knowledge-product-nav";
 import {
   Dialog,
   DialogContent,
@@ -139,6 +140,7 @@ export function WeKnoraKnowledgeDetailPage() {
   const [frameError, setFrameError] = useState<string | null>(null);
   const isAdmin = getStoredAuth()?.system_role === "admin";
   const runtime = useLlmWikiRuntime();
+  const landing = useOrdinaryKnowledgeLanding();
   const details = useLlmWikiKnowledgeBase(
     knowledgeBaseId || null,
     !!knowledgeBaseId,
@@ -165,6 +167,8 @@ export function WeKnoraKnowledgeDetailPage() {
     searchParams.get("sourceChunkId") || searchParams.get("chunkId") || "";
   const documentId = searchParams.get("documentId") || "";
   const wikiSlug = searchParams.get("wikiSlug") || "";
+  const defaultEntry = searchParams.get("view") !== "weknora" && !requestedTab && !wikiSlug && !sourceChunkId && !documentId;
+  const showNativeIndex = defaultEntry && (landing.data ?? "wiki") === "wiki" && !!detailsWikiEnabled;
   const nativeWikiPageUrl =
     knowledgeBaseId && wikiSlug && preferredTab === "wiki"
       ? buildWeKnoraWikiPagePath(knowledgeBaseId, wikiSlug)
@@ -175,7 +179,7 @@ export function WeKnoraKnowledgeDetailPage() {
     setFrameSrc("");
     setFrameError(null);
     if (
-      nativeWikiPageUrl ||
+      nativeWikiPageUrl || landing.isLoading || showNativeIndex ||
       !knowledgeBaseId ||
       runtime.data?.provider !== "weknora" ||
       !detailsReady
@@ -225,6 +229,8 @@ export function WeKnoraKnowledgeDetailPage() {
     documentId,
     knowledgeBaseId,
     nativeWikiPageUrl,
+    landing.isLoading,
+    showNativeIndex,
     preferredTab,
     runtime.data?.provider,
     sourceChunkId,
@@ -253,7 +259,7 @@ export function WeKnoraKnowledgeDetailPage() {
     return <Navigate to={nativeWikiPageUrl} replace />;
   }
 
-  if (runtime.isLoading || details.isLoading) {
+  if (runtime.isLoading || details.isLoading || landing.isLoading) {
     return (
       <div className="flex h-full items-center justify-center text-sm text-muted-foreground">
         <Loader2 className="mr-2 size-5 animate-spin" />
@@ -262,6 +268,10 @@ export function WeKnoraKnowledgeDetailPage() {
     );
   }
 
+  if (showNativeIndex) {
+    return <Navigate to={`/page/workspace/knowledge/${encodeURIComponent(knowledgeBaseId)}/wiki/view`} replace />;
+  }
+
   if (runtime.data?.provider !== "weknora")
     return <Navigate to={LIST_PATH} replace />;
 
@@ -313,7 +323,7 @@ export function WeKnoraKnowledgeDetailPage() {
 
   return (
     <div className="flex h-full min-h-0 flex-col bg-background">
-      {canManageWiki && (
+      {detailsWikiEnabled && (
         <div className="flex min-h-12 shrink-0 flex-wrap items-center justify-between gap-2 border-b px-4 py-2">
           <div className="min-w-0 flex-1">
             {canEditCurrentWikiArticle && (
@@ -334,6 +344,7 @@ export function WeKnoraKnowledgeDetailPage() {
             )}
           </div>
           <div className="flex shrink-0 items-center gap-2">
+            <Button size="sm" variant="outline" onClick={() => navigate(`/page/workspace/knowledge/${encodeURIComponent(knowledgeBaseId)}/wiki/view`)}>查看 Wiki 索引</Button>
             {isAdmin && (
               <Button
                 size="sm"
@@ -348,18 +359,14 @@ export function WeKnoraKnowledgeDetailPage() {
                 数据包任务
               </Button>
             )}
-            <Button
+            {canManageWiki && <Button
               size="sm"
               variant="outline"
-              onClick={() =>
-                navigate(
-                  `/page/workspace/knowledge/${encodeURIComponent(knowledgeBaseId)}/wiki`,
-                )
-              }
+              onClick={() => navigate(`/page/workspace/knowledge/${encodeURIComponent(knowledgeBaseId)}/wiki`)}
             >
               <FileText className="mr-2 size-4" />
               Wiki管理
-            </Button>
+            </Button>}
           </div>
         </div>
       )}

frontend-web/src/strategy-components/components/resource-management/llmwiki/WeKnoraKnowledgeWorkspace.tsx

@@ -34,6 +34,13 @@ import {
 } from "@/components/ui/dialog";
 import { Input } from "@/components/ui/input";
 import { Progress } from "@/components/ui/progress";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/components/ui/select";
 import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
 import { Textarea } from "@/components/ui/textarea";
 import { getStoredAuth } from "@/core/auth";
@@ -48,7 +55,9 @@ import {
   searchLlmWiki,
   startLocalWikiEncoder,
   uploadLocalWikiEncoder,
+  restoreConfiguredWikiEncoder,
   useLlmWikiActions,
+  useLlmWikiEmbeddingModels,
   useLlmWikiKnowledgeBases,
   useLlmWikiSettings,
   useLlmWikiSettingsActions,
@@ -68,6 +77,14 @@ function messageOf(error: unknown): string {
   return error instanceof Error ? error.message : "操作失败，请稍后重试";
 }
 
+function encoderProviderLabel(provider?: string | null): string {
+  const normalized = provider?.trim().toLowerCase();
+  if (normalized === "local") return "本地 BGE-M3";
+  if (normalized === "openai") return "OpenAI";
+  if (normalized === "openai_compatible") return "OpenAI 兼容服务";
+  return provider?.trim() || "未配置";
+}
+
 function searchModeLabel(mode: LlmWikiSearchResponse["mode"]) {
   if (mode === "vector") return "本地 Wiki 向量检索";
   if (mode === "mixed") return "Wiki 混合检索";
@@ -457,18 +474,50 @@ function CreateKnowledgeDialog({
   open: boolean;
   pending: boolean;
   onOpenChange: (value: boolean) => void;
-  onCreate: (input: { name: string; description: string; type: "document" | "faq"; wiki_enabled: boolean }) => Promise<void>;
+  onCreate: (input: { name: string; description: string; type: "document" | "faq"; wiki_enabled: boolean; embedding_model_id: string }) => Promise<void>;
 }) {
   const [name, setName] = useState("");
   const [description, setDescription] = useState("");
   const [wikiEnabled, setWikiEnabled] = useState(true);
+  const [embeddingModelId, setEmbeddingModelId] = useState("");
+  const embeddingModels = useLlmWikiEmbeddingModels(open);
+  const availableEmbeddingModels = useMemo(
+    () => (embeddingModels.data?.models ?? []).filter((model) => model.available !== false),
+    [embeddingModels.data?.models],
+  );
+
   useEffect(() => {
-    if (!open) { setName(""); setDescription(""); setWikiEnabled(true); }
+    if (!open) {
+      setName("");
+      setDescription("");
+      setWikiEnabled(true);
+      setEmbeddingModelId("");
+    }
   }, [open]);
+
+  useEffect(() => {
+    if (!open || !embeddingModels.data || availableEmbeddingModels.length === 0) return;
+    if (availableEmbeddingModels.some((model) => model.id === embeddingModelId)) return;
+    const defaultId = embeddingModels.data.default_model_id;
+    setEmbeddingModelId(
+      availableEmbeddingModels.some((model) => model.id === defaultId)
+        ? defaultId!
+        : availableEmbeddingModels[0]!.id,
+    );
+  }, [availableEmbeddingModels, embeddingModelId, embeddingModels.data, open]);
+
+  const modelLabel = (model: (typeof availableEmbeddingModels)[number]) => {
+    const provider = model.provider?.trim();
+    const implementation = model.model_name?.trim();
+    const suffix = [provider, implementation].filter(Boolean).join(" · ");
+    return suffix ? `${model.name}（${suffix}）` : model.name;
+  };
+  const modelSelectionUnavailable = embeddingModels.isLoading || embeddingModels.isError || !embeddingModelId;
+
   return (
     <Dialog open={open} onOpenChange={onOpenChange}>
       <DialogContent>
-        <DialogHeader><DialogTitle>新建个人知识库</DialogTitle><DialogDescription>选择知识库模式；模型、切块和存储策略仍由知识服务管理。</DialogDescription></DialogHeader>
+        <DialogHeader><DialogTitle>新建个人知识库</DialogTitle><DialogDescription>选择知识库模式和知识服务用于原文分块的向量模型。</DialogDescription></DialogHeader>
         <div className="space-y-4 py-2">
           <div className="space-y-2"><label className="text-sm font-medium" htmlFor="llmwiki-name">名称</label><Input id="llmwiki-name" value={name} onChange={(event) => setName(event.target.value)} maxLength={255} /></div>
           <div className="space-y-2"><label className="text-sm font-medium" htmlFor="llmwiki-description">描述</label><Textarea id="llmwiki-description" value={description} onChange={(event) => setDescription(event.target.value)} rows={4} maxLength={2048} /></div>
@@ -476,8 +525,33 @@ function CreateKnowledgeDialog({
             <button type="button" className={`rounded-xl border p-4 text-left transition-colors ${wikiEnabled ? "border-primary bg-primary/5 ring-1 ring-primary" : "hover:bg-muted/40"}`} onClick={() => setWikiEnabled(true)}><div className="flex items-center gap-2 text-sm font-semibold"><BookOpen className="size-4 text-violet-500" />Wiki 知识库</div><p className="mt-2 text-xs leading-5 text-muted-foreground">自动综合资料，生成 Wiki 页面和页面关系图谱。</p></button>
             <button type="button" className={`rounded-xl border p-4 text-left transition-colors ${!wikiEnabled ? "border-primary bg-primary/5 ring-1 ring-primary" : "hover:bg-muted/40"}`} onClick={() => setWikiEnabled(false)}><div className="flex items-center gap-2 text-sm font-semibold"><FileText className="size-4 text-blue-500" />标准知识库</div><p className="mt-2 text-xs leading-5 text-muted-foreground">仅进行文档解析、切块与向量/关键词索引。</p></button>
           </div></div>
+          <div className="space-y-2">
+            <label className="text-sm font-medium" htmlFor="llmwiki-embedding-model">原文向量模型</label>
+            {embeddingModels.isLoading ? (
+              <div className="flex h-9 items-center rounded-md border px-3 text-sm text-muted-foreground"><Loader2 className="mr-2 size-4 animate-spin" />正在读取知识服务模型</div>
+            ) : embeddingModels.isError ? (
+              <div className="rounded-lg border border-destructive/30 bg-destructive/5 p-3 text-xs text-destructive">
+                <p>模型读取失败：{messageOf(embeddingModels.error)}</p>
+                <Button type="button" variant="ghost" size="sm" className="mt-1 h-7 px-2" onClick={() => void embeddingModels.refetch()}>重新读取</Button>
+              </div>
+            ) : availableEmbeddingModels.length ? (
+              <Select value={embeddingModelId} onValueChange={setEmbeddingModelId} disabled={pending}>
+                <SelectTrigger id="llmwiki-embedding-model" className="w-full"><SelectValue placeholder="请选择向量模型" /></SelectTrigger>
+                <SelectContent position="popper">
+                  {availableEmbeddingModels.map((model) => (
+                    <SelectItem key={model.id} value={model.id}>
+                      {modelLabel(model)}{model.is_default ? " · 默认" : ""}
+                    </SelectItem>
+                  ))}
+                </SelectContent>
+              </Select>
+            ) : (
+              <div className="rounded-lg border border-amber-500/30 bg-amber-500/5 p-3 text-xs text-muted-foreground">知识服务中没有可用的 Embedding 模型，请先在知识服务中启用本地或 OpenAI 兼容向量模型。</div>
+            )}
+            <p className="text-xs leading-5 text-muted-foreground">该模型由知识服务（WeKnora）对上传原文和分块进行向量化，并在创建时绑定到新库。它与 DeerFlow 的“Wiki 镜像编码器”是两套独立配置；选择 OpenAI 兼容模型时，无需再配置本地 BGE-M3。需要跨知识库检索时，请为相关知识库保持相同或兼容的向量模型。</p>
+          </div>
         </div>
-        <DialogFooter><Button variant="outline" onClick={() => onOpenChange(false)}>取消</Button><Button disabled={pending || !name.trim()} onClick={() => void onCreate({ name: name.trim(), description: description.trim(), type: "document", wiki_enabled: wikiEnabled })}>{pending && <Loader2 className="mr-2 size-4 animate-spin" />}创建</Button></DialogFooter>
+        <DialogFooter><Button variant="outline" onClick={() => onOpenChange(false)}>取消</Button><Button disabled={pending || !name.trim() || modelSelectionUnavailable} onClick={() => void onCreate({ name: name.trim(), description: description.trim(), type: "document", wiki_enabled: wikiEnabled, embedding_model_id: embeddingModelId })}>{pending && <Loader2 className="mr-2 size-4 animate-spin" />}创建</Button></DialogFooter>
       </DialogContent>
     </Dialog>
   );
@@ -501,11 +575,12 @@ export function LocalEncoderSettingsCard() {
 
   const applyStatus = (status: Awaited<ReturnType<typeof getLocalWikiEncoderStatus>>) => {
     queryClient.setQueryData(["llmwiki-local-encoder"], status);
+    void queryClient.invalidateQueries({ queryKey: ["llmwiki", "wiki-index-status"] });
     setModelPath(status.model_path || "");
   };
   const configure = useMutation({
     mutationFn: () => configureLocalWikiEncoder(modelPath.trim()),
-    onSuccess: (status) => { applyStatus(status); toast.success("编码器目录已保存"); },
+    onSuccess: (status) => { applyStatus(status); toast.success("已切换到本地 Wiki 编码器并保存目录"); },
     onError: (error) => toast.error(messageOf(error)),
   });
   const upload = useMutation({
@@ -514,7 +589,7 @@ export function LocalEncoderSettingsCard() {
     onSuccess: (status) => {
       applyStatus(status);
       setFiles([]);
-      toast.success(`已保存 ${status.uploaded_files ?? 0} 个模型文件`);
+      toast.success(`已保存 ${status.uploaded_files ?? 0} 个模型文件，并切换到本地 Wiki 编码器`);
     },
     onError: (error) => toast.error(messageOf(error)),
   });
@@ -526,7 +601,17 @@ export function LocalEncoderSettingsCard() {
     },
     onError: (error) => toast.error(messageOf(error)),
   });
+  const restoreConfigured = useMutation({
+    mutationFn: restoreConfiguredWikiEncoder,
+    onSuccess: (nextStatus) => {
+      applyStatus(nextStatus);
+      toast.success(`已恢复 config.yaml 编码器：${encoderProviderLabel(nextStatus.provider)}`);
+    },
+    onError: (error) => toast.error(messageOf(error)),
+  });
   const status = encoder.data;
+  const usingLocal = status?.using_local ?? status?.provider === "local";
+  const localOverrideActive = status?.mode === "local";
   const selectedBytes = files.reduce((sum, file) => sum + file.size, 0);
   const formatSize = (value: number) => value >= 1024 ** 3
     ? `${(value / 1024 ** 3).toFixed(2)} GB`
@@ -535,29 +620,49 @@ export function LocalEncoderSettingsCard() {
   return (
     <Card>
       <CardHeader>
-        <CardTitle className="flex items-center gap-2 text-base"><Cpu className="size-5" />DeerFlow 本地编码器</CardTitle>
-        <CardDescription>仅管理员可见。配置服务器上已有的 BGE-M3 目录，或直接上传完整离线模型目录；编码器作为独立进程启动，不影响 DeerFlow 其他服务。</CardDescription>
+        <CardTitle className="flex items-center gap-2 text-base"><Cpu className="size-5" />DeerFlow Wiki 镜像编码器</CardTitle>
+        <CardDescription>仅管理员可见。这里负责 DeerFlow 内部 Wiki 页面镜像的向量检索，不会决定知识服务对上传原文使用哪个模型。原文向量模型在“新建知识库”时选择。</CardDescription>
       </CardHeader>
       <CardContent className="space-y-5">
         <div className="flex flex-wrap items-center gap-2 text-sm">
-          <Badge variant={status?.state === "failed" ? "destructive" : status?.state === "ready" ? "default" : "secondary"}>
-            {status?.state === "ready" ? "已就绪" : status?.state === "starting" ? "启动中" : status?.state === "failed" ? "启动失败" : "未启动"}
+          <Badge variant={encoder.isError || (usingLocal && status?.state === "failed") ? "destructive" : usingLocal && status?.state === "ready" ? "default" : "secondary"}>
+            {encoder.isError
+              ? "状态读取失败"
+              : encoder.isLoading
+                ? "读取中"
+                : !usingLocal
+                  ? "配置编码器生效中"
+                  : status?.state === "ready"
+                    ? "本地编码器已就绪"
+                    : status?.state === "starting"
+                      ? "本地编码器启动中"
+                      : status?.state === "failed"
+                        ? "本地编码器启动失败"
+                        : "本地编码器未启动"}
           </Badge>
-          <span className="text-muted-foreground">{status ? `${status.model} · ${status.dimensions || "自动探测"} 维 · ${status.process_isolation ? "独立进程" : "主进程"}` : "正在读取状态"}</span>
-          {status?.model_files_ready && <Badge variant="outline">模型文件已就绪</Badge>}
+          {status && <Badge variant="outline">当前 provider：{encoderProviderLabel(status.provider)}</Badge>}
+          {status && <Badge variant="outline">{localOverrideActive ? "页面本地覆盖" : "config.yaml 配置"}</Badge>}
+          <span className="text-muted-foreground">
+            {status
+              ? usingLocal
+                ? `${status.model} · ${status.dimensions || "自动探测"} 维 · ${status.process_isolation ? "独立进程" : "主进程"}`
+                : `由 config.yaml 的 ${encoderProviderLabel(status.configured_provider || status.provider)} provider 提供向量服务，无需启动本地模型`
+              : "正在读取状态"}
+          </span>
+          {usingLocal && status?.model_files_ready && <Badge variant="outline">模型文件已就绪</Badge>}
         </div>
         {encoder.error && <p className="text-sm text-destructive">{messageOf(encoder.error)}</p>}
-        {status?.last_error && <p className="rounded-lg border border-destructive/30 bg-destructive/5 p-3 text-xs text-destructive">{status.last_error}</p>}
+        {usingLocal && status?.last_error && <p className="rounded-lg border border-destructive/30 bg-destructive/5 p-3 text-xs text-destructive">{status.last_error}</p>}
 
         <div className="space-y-2">
-          <label className="text-sm font-medium" htmlFor="local-encoder-path">使用服务器已有目录</label>
+          <label className="text-sm font-medium" htmlFor="local-encoder-path">切换到服务器本地模型目录</label>
           <div className="flex flex-col gap-2 sm:flex-row">
             <Input id="local-encoder-path" value={modelPath} onChange={(event) => setModelPath(event.target.value)} placeholder="例如 /opt/deerflow/models/bge-m3" />
             <Button variant="outline" disabled={!modelPath.trim() || configure.isPending} onClick={() => configure.mutate()}>
               {configure.isPending && <Loader2 className="mr-2 size-4 animate-spin" />}保存目录
             </Button>
           </div>
-          <p className="text-xs text-muted-foreground">目录内需包含 <code>onnx/model.onnx</code>（推荐）或根目录 <code>model.onnx</code>。</p>
+          <p className="text-xs text-muted-foreground">目录内需包含 <code>onnx/model.onnx</code>（推荐）或根目录 <code>model.onnx</code>。保存后会立即把 Wiki 镜像编码器切换为 local 并热重建，无需修改配置文件或重启服务。</p>
         </div>
 
         <div className="space-y-2 rounded-xl border border-dashed p-4">
@@ -576,7 +681,7 @@ export function LocalEncoderSettingsCard() {
           )}
           <div className="flex flex-wrap items-center justify-between gap-3">
             <p className="text-xs text-muted-foreground">
-              {files.length ? `已选择 ${files.length} 个文件，共 ${formatSize(selectedBytes)}` : "请选择完整 BGE-M3 目录。大文件会落到运行目录，不写入源码仓库。"}
+              {files.length ? `已选择 ${files.length} 个文件，共 ${formatSize(selectedBytes)}` : "请选择完整 BGE-M3 目录。上传完成后会自动切换到 local；大文件会落到运行目录，不写入源码仓库。"}
             </p>
             <Button disabled={!files.length || upload.isPending} onClick={() => upload.mutate()}>
               {upload.isPending ? <Loader2 className="mr-2 size-4 animate-spin" /> : <Upload className="mr-2 size-4" />}
@@ -586,10 +691,16 @@ export function LocalEncoderSettingsCard() {
         </div>
 
         <div className="flex flex-wrap gap-2">
-          <Button disabled={!status?.model_files_ready || start.isPending || status?.state === "starting" || status?.state === "ready"} onClick={() => start.mutate()}>
+          <Button disabled={!usingLocal || !status?.model_files_ready || start.isPending || status?.state === "starting" || status?.state === "ready"} onClick={() => start.mutate()}>
             {(start.isPending || status?.state === "starting") && <Loader2 className="mr-2 size-4 animate-spin" />}
-            {status?.state === "ready" ? "编码器已启动" : status?.state === "failed" ? "重新启动" : "一键启动编码器"}
+            {!usingLocal ? "当前无需启动本地模型" : status?.state === "ready" ? "编码器已启动" : status?.state === "failed" ? "重新启动" : "一键启动编码器"}
           </Button>
+          {localOverrideActive && (
+            <Button variant="secondary" disabled={restoreConfigured.isPending} onClick={() => restoreConfigured.mutate()}>
+              {restoreConfigured.isPending && <Loader2 className="mr-2 size-4 animate-spin" />}
+              恢复 config.yaml 编码器
+            </Button>
+          )}
           <Button variant="ghost" disabled={encoder.isFetching} onClick={() => void encoder.refetch()}>
             <RefreshCw className={`mr-2 size-4 ${encoder.isFetching ? "animate-spin" : ""}`} />刷新状态
           </Button>

frontend-web/src/strategy-components/components/resource-management/llmwiki/WeKnoraPackageTransfersPage.tsx

@@ -1,3 +1,4 @@
+import { userFacingKnowledgeMessage } from "@/lib/knowledge-message";
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 import {
   Archive,
@@ -180,7 +181,7 @@ export default function WeKnoraPackageTransfersPage() {
                       </div>
                       {job.error && (
                         <p className="mt-2 text-sm text-destructive">
-                          {job.error}
+                          {userFacingKnowledgeMessage(job.error)}
                         </p>
                       )}
                     </div>

frontend-web/src/strategy-components/components/resource-management/llmwiki/WeKnoraWikiManagementPage.tsx

@@ -601,13 +601,19 @@ export function WeKnoraWikiManagementPage() {
     }
   };
 
-  const vectorStatusText = !indexStatus.data?.local_index_enabled
-    ? "本地向量未启用，检索使用 Wiki 接口"
-    : indexStatus.data.fully_vectorized
-      ? `整库已向量化（${indexStatus.data.vector_count ?? 0} 个向量章节）`
-      : indexStatus.data.state === "running" || indexStatus.data.state === "rebuilding"
-        ? "整库向量化进行中，完成前检索使用 Wiki 接口"
-        : "整库尚未完成向量化，检索使用 Wiki 接口";
+  const vectorStatusText = indexStatus.isLoading
+    ? "正在读取 Wiki 镜像向量状态"
+    : indexStatus.isError
+      ? `Wiki 镜像向量状态读取失败：${indexStatus.error instanceof Error ? indexStatus.error.message : "请稍后重试"}`
+      : !indexStatus.data?.local_index_enabled
+        ? "Wiki 镜像向量未启用，检索使用 Wiki 接口"
+        : indexStatus.data.fully_vectorized
+          ? `整库已向量化（${indexStatus.data.vector_count ?? 0} 个向量章节）`
+          : indexStatus.data.state === "running" || indexStatus.data.state === "rebuilding"
+            ? "整库向量化进行中，完成前检索使用 Wiki 接口"
+            : indexStatus.data.last_error
+              ? `整库向量化失败：${indexStatus.data.last_error}`
+              : "整库尚未完成向量化，检索使用 Wiki 接口";
 
   return (
     <div className="flex h-full min-h-0 flex-col bg-background">
@@ -626,7 +632,7 @@ export function WeKnoraWikiManagementPage() {
             variant="outline"
             size="sm"
             onClick={() => void vectorize()}
-            disabled={!canWrite || actions.vectorizeWiki.isPending || indexStatus.data?.state === "running" || indexStatus.data?.state === "rebuilding"}
+            disabled={!canWrite || indexStatus.isLoading || actions.vectorizeWiki.isPending || indexStatus.data?.state === "running" || indexStatus.data?.state === "rebuilding"}
           >
             {actions.vectorizeWiki.isPending || indexStatus.data?.state === "running" || indexStatus.data?.state === "rebuilding" ? (
               <Loader2 className="mr-2 size-4 animate-spin" />
@@ -652,6 +658,17 @@ export function WeKnoraWikiManagementPage() {
       <main className="grid min-h-0 flex-1 grid-cols-[320px_1fr] overflow-hidden">
         <aside className="flex min-h-0 flex-col border-r bg-muted/20">
           <div className="border-b p-3">
+            {indexStatus.isLoading && (
+              <div className="mb-3 flex items-center rounded-lg border bg-background p-3 text-xs text-muted-foreground">
+                <Loader2 className="mr-2 size-4 animate-spin" />正在读取 Wiki 镜像向量状态
+              </div>
+            )}
+            {indexStatus.isError && (
+              <div className="mb-3 rounded-lg border border-destructive/30 bg-destructive/5 p-3 text-xs text-destructive">
+                <p>Wiki 镜像向量状态读取失败：{indexStatus.error instanceof Error ? indexStatus.error.message : "请稍后重试"}</p>
+                <Button type="button" variant="ghost" size="sm" className="mt-1 h-7 px-2" onClick={() => void indexStatus.refetch()}>重新读取</Button>
+              </div>
+            )}
             {indexStatus.data && (
               <div className="mb-3 rounded-lg border bg-background p-3">
                 <div className="flex items-center justify-between gap-2 text-xs">

frontend-web/src/strategy-components/components/resource-management/llmwiki/WeKnoraWikiPageView.tsx

@@ -153,11 +153,11 @@ export function WeKnoraWikiPageView({
   const pages = publicEmbed ? publicPages : privatePages;
   const remotePagesList = useMemo(() => pages.data?.pages || [], [pages.data?.pages]);
   const explicitIndexPage = useMemo(
-    () => (publicEmbed ? remotePagesList.find(isWikiIndexPage) : undefined),
+    () => remotePagesList.find(isWikiIndexPage),
     [publicEmbed, remotePagesList],
   );
   const generatedIndexPage = useMemo<LlmWikiWikiPage | undefined>(
-    () => publicEmbed && remotePagesList.length > 0 && !explicitIndexPage
+    () => remotePagesList.length > 0 && !explicitIndexPage
       ? {
           id: "__generated_public_index__",
           slug: GENERATED_PUBLIC_INDEX_SLUG,
@@ -181,14 +181,14 @@ export function WeKnoraWikiPageView({
     [generatedIndexPage, remotePagesList],
   );
   const landingPage = useMemo(() => selectDefaultWikiPage(pagesList), [pagesList]);
-  const wikiSlug = requestedWikiSlug || (publicEmbed ? landingPage?.slug || "" : "");
+  const wikiSlug = requestedWikiSlug || landingPage?.slug || "";
   const generatedIndexActive = generatedIndexPage?.slug === wikiSlug;
   const generatedIndexRequested =
-    publicEmbed && wikiSlug === GENERATED_PUBLIC_INDEX_SLUG && !explicitIndexPage;
+    wikiSlug === GENERATED_PUBLIC_INDEX_SLUG && !explicitIndexPage;
   const privatePage = useLlmWikiWikiPage(
     noteId || null,
     wikiSlug || null,
-    !!noteId && !!wikiSlug && !publicEmbed,
+    !!noteId && !!wikiSlug && !publicEmbed && !generatedIndexActive && !generatedIndexRequested,
   );
   const publicPage = usePublicLlmWikiWikiPage(
     noteId || null,
@@ -377,15 +377,15 @@ export function WeKnoraWikiPageView({
   };
 
   if (!wikiSlug) {
-    if (publicEmbed && pages.isLoading) {
+    if (pages.isLoading) {
       return (
         <div className="flex h-full items-center justify-center text-sm text-muted-foreground">
           <Loader2 className="mr-2 size-5 animate-spin" />
-          正在加载公开 Wiki
+          正在加载 Wiki 索引
         </div>
       );
     }
-    if (publicEmbed && pages.error) {
+    if (pages.error) {
       return (
         <div className="flex h-full flex-col items-center justify-center gap-4 px-6 text-center">
           <div className="flex size-12 items-center justify-center rounded-full bg-destructive/10 text-destructive">
@@ -405,9 +405,9 @@ export function WeKnoraWikiPageView({
     }
     return (
       <div className="flex h-full flex-col items-center justify-center gap-4 text-sm text-muted-foreground">
-        {publicEmbed ? "该知识库暂无可展示的 Wiki 页面" : "当前链接缺少 Wiki 页面标识"}
+        该知识库暂无可展示的 Wiki 页面
         {!publicEmbed && (
-          <Button variant="outline" onClick={() => navigate(LIST_PATH)}>返回知识库</Button>
+          <><Button variant="outline" onClick={() => navigate(LIST_PATH)}>返回知识库</Button><Button onClick={() => navigate(`${LIST_PATH}/${encodeURIComponent(noteId)}?view=weknora`)}>进入知识库管理，导入资料</Button></>
         )}
       </div>
     );
@@ -492,6 +492,7 @@ export function WeKnoraWikiPageView({
           </div>
         </div>
         <div className="flex items-center gap-2">
+          <Button variant="outline" size="sm" onClick={() => navigate(`${LIST_PATH}/${encodeURIComponent(noteId)}?view=weknora`)}>知识库管理</Button>
           {globalBase && isDeposited && <Button variant="outline" size="sm" onClick={() => navigate(`/page/workspace/knowledge/assistant?${new URLSearchParams({ base_id: globalBase.id, wikiSlug: pageData.slug })}`)}>在知识梳理中查看</Button>}
           <Button variant="outline" size="sm" onClick={() => void download("md")} disabled={downloading !== null}>
             {downloading === "md" ? <Loader2 className="size-4 animate-spin" /> : <Download className="size-4" />}

frontend-web/src/strategy-components/components/resource-management/llmwiki/WikiPackageTransfers.tsx

@@ -1,3 +1,4 @@
+import { userFacingKnowledgeMessage } from "@/lib/knowledge-message";
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 import { Download, Loader2, Upload } from "lucide-react";
 import { useRef } from "react";
@@ -110,7 +111,7 @@ export function WikiPackageTransfers({
           {job.file_size_bytes ? (
             <span>{(job.file_size_bytes / 1024 / 1024).toFixed(2)} MB</span>
           ) : null}
-          {job.error && <span className="text-destructive">{job.error}</span>}
+          {job.error && <span className="text-destructive">{userFacingKnowledgeMessage(job.error)}</span>}
           {assistant &&
             job.status === "completed" &&
             job.file_exists &&

frontend-web/src/strategy-selection/AgentConfigDialog.tsx

@@ -0,0 +1,736 @@
+import { useEffect, useMemo, useState } from "react";
+import { useQueryClient } from "@tanstack/react-query";
+import {
+  Bot,
+  Check,
+  CirclePlus,
+  Layers3,
+  LoaderCircle,
+  LockKeyhole,
+  Power,
+  RotateCcw,
+  Save,
+  Sparkles,
+  Trash2,
+} from "lucide-react";
+import { toast } from "sonner";
+
+import { SkillTransferSelector } from "@/components/workspace/agents/skill-transfer-selector";
+import { ModelNameSelect } from "@/components/workspace/model-name-select";
+import { SkillDetailDialog } from "@/components/workspace/skills/skill-detail-dialog";
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/components/ui/dialog";
+import { Input } from "@/components/ui/input";
+import { Switch } from "@/components/ui/switch";
+import { Textarea } from "@/components/ui/textarea";
+import { useAllSkillsAdmin } from "@/core/skills/hooks";
+import { cn } from "@/lib/utils";
+
+import {
+  createStrategyAngle,
+  disableStrategyAngle,
+  STRATEGY_AGENTS_QUERY_KEY,
+  updateStrategyAgent,
+  useStrategyAgents,
+  type StrategyAgent,
+  type StrategyAgentCategory,
+} from "./strategy-agents";
+
+interface AgentConfigDialogProps {
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+}
+
+interface AgentConfigDraft {
+  name: string;
+  description: string;
+  soul: string;
+  model: string | null;
+  skills: string[];
+  enabled: boolean;
+  sortOrder: number;
+}
+
+const NEW_ANGLE_ID = "__new_strategy_angle__";
+
+const CATEGORY_COPY: Record<
+  StrategyAgentCategory,
+  { title: string; description: string }
+> = {
+  intent: {
+    title: "意图理解",
+    description: "把用户对话整理为结构化任务，固定流程入口",
+  },
+  angle: {
+    title: "分析角度",
+    description: "并行生成独立策略，可按业务需要扩展",
+  },
+  judge: {
+    title: "智能评判",
+    description: "统一比较各角度策略并给出推荐结论",
+  },
+  solution: {
+    title: "方案整理",
+    description: "将用户选中的策略消冲突并汇总成方案",
+  },
+};
+
+function normalizeSkills(skills: string[]) {
+  return [...new Set(skills)].sort((left, right) =>
+    left.localeCompare(right),
+  );
+}
+
+function sameSkills(left: string[], right: string[]) {
+  const normalizedLeft = normalizeSkills(left);
+  const normalizedRight = normalizeSkills(right);
+  return (
+    normalizedLeft.length === normalizedRight.length &&
+    normalizedLeft.every((skill, index) => skill === normalizedRight[index])
+  );
+}
+
+function draftFromAgent(agent: StrategyAgent): AgentConfigDraft {
+  return {
+    name: agent.name,
+    description: agent.description,
+    soul: agent.soul ?? "",
+    model: agent.model,
+    skills: agent.skills ?? [],
+    enabled: agent.enabled,
+    sortOrder: agent.sort_order,
+  };
+}
+
+function emptyAngleDraft(sortOrder: number): AgentConfigDraft {
+  return {
+    name: "",
+    description: "",
+    soul: "",
+    model: null,
+    skills: [],
+    enabled: true,
+    sortOrder,
+  };
+}
+
+function sameDraft(left: AgentConfigDraft, right: AgentConfigDraft) {
+  return (
+    left.name === right.name &&
+    left.description === right.description &&
+    left.soul === right.soul &&
+    left.model === right.model &&
+    left.enabled === right.enabled &&
+    left.sortOrder === right.sortOrder &&
+    sameSkills(left.skills, right.skills)
+  );
+}
+
+export function AgentConfigDialog({
+  open,
+  onOpenChange,
+}: AgentConfigDialogProps) {
+  const [selectedId, setSelectedId] = useState("");
+  const [draft, setDraft] = useState<AgentConfigDraft>(() =>
+    emptyAngleDraft(100),
+  );
+  const [savedDraft, setSavedDraft] = useState<AgentConfigDraft | null>(null);
+  const [detailSkillName, setDetailSkillName] = useState<string | null>(null);
+  const [busy, setBusy] = useState(false);
+  const queryClient = useQueryClient();
+  const {
+    data: agents = [],
+    isLoading,
+    error,
+    refetch,
+  } = useStrategyAgents({
+    enabled: open,
+    includeDisabled: true,
+    includeConfig: true,
+  });
+  const {
+    skills,
+    isLoading: isSkillsLoading,
+    error: skillsError,
+  } = useAllSkillsAdmin(open);
+
+  const fixedAgents = useMemo(
+    () => agents.filter((agent) => agent.fixed),
+    [agents],
+  );
+  const angleAgents = useMemo(
+    () => agents.filter((agent) => agent.category === "angle"),
+    [agents],
+  );
+  const selectedAgent = useMemo(
+    () => agents.find((agent) => agent.id === selectedId) ?? null,
+    [agents, selectedId],
+  );
+  const creating = selectedId === NEW_ANGLE_ID;
+  const dirty = Boolean(savedDraft && !sameDraft(draft, savedDraft));
+  const selectableSkills = useMemo(
+    () =>
+      skills.filter((skill) => {
+        const globallyAvailable =
+          Boolean(skill.builtin) || Boolean(skill.published);
+        return (
+          skill.enabled &&
+          (skill.state ?? "active") === "active" &&
+          globallyAvailable
+        );
+      }),
+    [skills],
+  );
+
+  useEffect(() => {
+    if (!open || isLoading || creating || agents.length === 0) return;
+    if (selectedAgent) return;
+    setSelectedId(agents[0].id);
+  }, [agents, creating, isLoading, open, selectedAgent]);
+
+  useEffect(() => {
+    if (!open || creating || !selectedAgent) return;
+    const next = draftFromAgent(selectedAgent);
+    setDraft(next);
+    setSavedDraft(next);
+  }, [creating, open, selectedAgent?.id, selectedAgent?.updated_at]);
+
+  const confirmDiscardChanges = () =>
+    !dirty || window.confirm("当前配置尚未保存，确定放弃这些修改吗？");
+
+  const selectAgent = (agentId: string) => {
+    if (agentId === selectedId || busy || !confirmDiscardChanges()) return;
+    setSelectedId(agentId);
+    setSavedDraft(null);
+  };
+
+  const startCreate = () => {
+    if (busy || !confirmDiscardChanges()) return;
+    const maxOrder = angleAgents.reduce(
+      (current, agent) => Math.max(current, agent.sort_order),
+      99,
+    );
+    const next = emptyAngleDraft(maxOrder + 1);
+    setSelectedId(NEW_ANGLE_ID);
+    setDraft(next);
+    setSavedDraft(next);
+  };
+
+  const save = async () => {
+    const name = draft.name.trim();
+    if (!name) {
+      toast.error("请填写智能体名称");
+      return;
+    }
+    setBusy(true);
+    try {
+      if (creating) {
+        const created = await createStrategyAngle({
+          name,
+          description: draft.description.trim(),
+          soul: draft.soul,
+          model: draft.model,
+          skills: draft.skills,
+          sort_order: draft.sortOrder,
+        });
+        setSelectedId(created.id);
+        const next = draftFromAgent(created);
+        setDraft(next);
+        setSavedDraft(next);
+        await queryClient.invalidateQueries({
+          queryKey: STRATEGY_AGENTS_QUERY_KEY,
+        });
+        toast.success(`${created.name} 已加入分析角度库`);
+      } else if (selectedAgent) {
+        const updated = await updateStrategyAgent(selectedAgent.id, {
+          name,
+          description: draft.description.trim(),
+          soul: draft.soul,
+          model: draft.model,
+          skills: draft.skills,
+          enabled: selectedAgent.fixed ? undefined : draft.enabled,
+          sort_order: selectedAgent.fixed ? undefined : draft.sortOrder,
+        });
+        const next = draftFromAgent(updated);
+        setDraft(next);
+        setSavedDraft(next);
+        await queryClient.invalidateQueries({
+          queryKey: STRATEGY_AGENTS_QUERY_KEY,
+        });
+        toast.success(`${updated.name} 配置已保存`);
+      }
+    } catch (reason) {
+      toast.error(reason instanceof Error ? reason.message : "保存失败");
+    } finally {
+      setBusy(false);
+    }
+  };
+
+  const softDelete = async () => {
+    if (!selectedAgent || selectedAgent.fixed || busy) return;
+    const confirmed = window.confirm(
+      `确定停用“${selectedAgent.name}”吗？\n\n它不会再出现在新项目的角度选择中，但历史项目、SOUL 和技能配置都会保留，可随时恢复。`,
+    );
+    if (!confirmed) return;
+    setBusy(true);
+    try {
+      const updated = await disableStrategyAngle(selectedAgent.id);
+      const next = draftFromAgent(updated);
+      setDraft(next);
+      setSavedDraft(next);
+      await queryClient.invalidateQueries({
+        queryKey: STRATEGY_AGENTS_QUERY_KEY,
+      });
+      toast.success(`${updated.name} 已停用，历史项目不受影响`);
+    } catch (reason) {
+      toast.error(reason instanceof Error ? reason.message : "停用失败");
+    } finally {
+      setBusy(false);
+    }
+  };
+
+  const handleOpenChange = (nextOpen: boolean) => {
+    if (!nextOpen && (busy || !confirmDiscardChanges())) return;
+    onOpenChange(nextOpen);
+  };
+
+  const category = creating ? "angle" : selectedAgent?.category;
+  const categoryCopy = category ? CATEGORY_COPY[category] : null;
+
+  return (
+    <Dialog open={open} onOpenChange={handleOpenChange}>
+      <DialogContent className="grid h-[min(860px,calc(100vh-40px))] max-w-[1180px] grid-rows-[auto_minmax(0,1fr)_auto] gap-0 overflow-hidden p-0 sm:max-w-[1180px]">
+        <DialogHeader className="border-b px-6 py-5 dark:border-[#173d68]">
+          <DialogTitle className="flex items-center gap-2">
+            <Bot className="size-5 text-primary" />
+            统一策略智能体
+          </DialogTitle>
+          <DialogDescription>
+            配置对所有项目全局生效。流程角色保持唯一；分析角度可扩展、排序和停用，历史项目仍保留原引用。
+          </DialogDescription>
+        </DialogHeader>
+
+        <div className="grid min-h-0 grid-cols-[320px_minmax(0,1fr)]">
+          <aside className="min-h-0 overflow-y-auto border-r bg-muted/20 p-4 dark:border-[#173d68] dark:bg-[#031b38]">
+            <div className="mb-3 flex items-center justify-between px-1">
+              <div>
+                <p className="text-xs font-semibold tracking-wide text-muted-foreground">
+                  固定流程角色
+                </p>
+                <p className="mt-1 text-[11px] text-muted-foreground/80">
+                  仅可修改配置，不可新增、停用或删除
+                </p>
+              </div>
+              <Badge variant="secondary">{fixedAgents.length}</Badge>
+            </div>
+            <div className="space-y-1.5">
+              {fixedAgents.map((agent) => {
+                const selected = agent.id === selectedId;
+                const copy = CATEGORY_COPY[agent.category];
+                return (
+                  <button
+                    key={agent.id}
+                    type="button"
+                    disabled={busy}
+                    onClick={() => selectAgent(agent.id)}
+                    className={cn(
+                      "w-full rounded-xl border px-3 py-3 text-left transition-colors disabled:cursor-not-allowed disabled:opacity-60",
+                      selected
+                        ? "border-primary/45 bg-primary/10 shadow-sm"
+                        : "border-transparent bg-background/70 hover:border-border dark:bg-[#08274c]/55 dark:hover:border-[#28507c]",
+                    )}
+                  >
+                    <span className="flex items-center justify-between gap-2">
+                      <span className="flex min-w-0 items-center gap-2">
+                        <LockKeyhole className="size-3.5 shrink-0 text-muted-foreground" />
+                        <span className="truncate text-sm font-medium">
+                          {copy.title}
+                        </span>
+                      </span>
+                      {selected ? (
+                        <Check className="size-4 shrink-0 text-primary" />
+                      ) : null}
+                    </span>
+                    <span className="mt-1.5 block truncate pl-5.5 text-xs text-muted-foreground">
+                      {agent.name}
+                    </span>
+                  </button>
+                );
+              })}
+            </div>
+
+            <div className="mb-3 mt-6 flex items-center justify-between px-1">
+              <div>
+                <p className="text-xs font-semibold tracking-wide text-muted-foreground">
+                  分析角度库
+                </p>
+                <p className="mt-1 text-[11px] text-muted-foreground/80">
+                  新项目只使用当前启用的角度
+                </p>
+              </div>
+              <Button
+                type="button"
+                size="sm"
+                className="h-8 gap-1.5"
+                disabled={busy}
+                onClick={startCreate}
+              >
+                <CirclePlus className="size-3.5" />
+                新增
+              </Button>
+            </div>
+            <div className="space-y-1.5">
+              {angleAgents.map((agent) => {
+                const selected = agent.id === selectedId;
+                return (
+                  <button
+                    key={agent.id}
+                    type="button"
+                    disabled={busy}
+                    onClick={() => selectAgent(agent.id)}
+                    className={cn(
+                      "w-full rounded-xl border px-3 py-3 text-left transition-colors disabled:cursor-not-allowed disabled:opacity-60",
+                      selected
+                        ? "border-primary/45 bg-primary/10 shadow-sm"
+                        : "border-transparent bg-background/70 hover:border-border dark:bg-[#08274c]/55 dark:hover:border-[#28507c]",
+                      !agent.enabled && "opacity-65",
+                    )}
+                  >
+                    <span className="flex items-center justify-between gap-2">
+                      <span className="flex min-w-0 items-center gap-2">
+                        <Layers3 className="size-3.5 shrink-0 text-primary" />
+                        <span className="truncate text-sm font-medium">
+                          {agent.name}
+                        </span>
+                      </span>
+                      {selected ? (
+                        <Check className="size-4 shrink-0 text-primary" />
+                      ) : null}
+                    </span>
+                    <span className="mt-2 flex items-center justify-between gap-2 pl-5.5">
+                      <span className="truncate text-[11px] text-muted-foreground">
+                        顺序 {agent.sort_order}
+                      </span>
+                      <Badge
+                        variant={agent.enabled ? "secondary" : "outline"}
+                        className="h-5 text-[10px]"
+                      >
+                        {agent.enabled ? "已启用" : "已停用"}
+                      </Badge>
+                    </span>
+                  </button>
+                );
+              })}
+              {!isLoading && angleAgents.length === 0 ? (
+                <div className="rounded-xl border border-dashed p-5 text-center text-xs text-muted-foreground">
+                  暂无分析角度，点击“新增”建立第一个角度。
+                </div>
+              ) : null}
+            </div>
+          </aside>
+
+          <main className="min-h-0 overflow-y-auto px-6 py-5">
+            {isLoading ? (
+              <div className="flex h-64 items-center justify-center gap-2 text-sm text-muted-foreground">
+                <LoaderCircle className="size-4 animate-spin" />
+                正在读取全局配置…
+              </div>
+            ) : error ? (
+              <div className="rounded-xl border border-destructive/30 bg-destructive/5 p-5 text-sm text-destructive">
+                <p className="font-medium">策略智能体配置加载失败</p>
+                <p className="mt-1 leading-6 opacity-85">
+                  {error instanceof Error ? error.message : "请稍后重试"}
+                </p>
+                <Button
+                  variant="outline"
+                  size="sm"
+                  className="mt-4"
+                  onClick={() => void refetch()}
+                >
+                  <RotateCcw className="size-3.5" />
+                  重新加载
+                </Button>
+              </div>
+            ) : categoryCopy ? (
+              <div className="space-y-5">
+                <div className="flex items-start justify-between gap-4">
+                  <div>
+                    <div className="flex flex-wrap items-center gap-2">
+                      <h3 className="text-lg font-semibold">
+                        {creating ? "新增分析角度" : categoryCopy.title}
+                      </h3>
+                      {selectedAgent?.fixed ? (
+                        <Badge variant="outline" className="gap-1">
+                          <LockKeyhole className="size-3" /> 固定角色
+                        </Badge>
+                      ) : null}
+                      {!creating && selectedAgent && !selectedAgent.fixed ? (
+                        <Badge
+                          variant={draft.enabled ? "secondary" : "outline"}
+                        >
+                          {draft.enabled ? "已启用" : "已停用"}
+                        </Badge>
+                      ) : null}
+                    </div>
+                    <p className="mt-1 text-sm text-muted-foreground">
+                      {creating
+                        ? "创建后会成为所有策略项目可选的全局分析角度。"
+                        : categoryCopy.description}
+                    </p>
+                  </div>
+                  {!creating && selectedAgent ? (
+                    <Badge
+                      variant="outline"
+                      className="max-w-[300px] truncate font-mono text-[10px]"
+                      title={selectedAgent.id}
+                    >
+                      {selectedAgent.id}
+                    </Badge>
+                  ) : null}
+                </div>
+
+                <section className="rounded-xl border bg-muted/15 p-4 dark:border-[#173d68] dark:bg-[#031b38]">
+                  <div className="grid gap-4 sm:grid-cols-2">
+                    <label className="block">
+                      <span className="mb-1.5 block text-xs font-medium">
+                        智能体名称
+                      </span>
+                      <Input
+                        value={draft.name}
+                        disabled={busy}
+                        maxLength={100}
+                        placeholder="例如：科技与产业链视角"
+                        onChange={(event) =>
+                          setDraft((current) => ({
+                            ...current,
+                            name: event.target.value,
+                          }))
+                        }
+                      />
+                    </label>
+                    <label className="block">
+                      <span className="mb-1.5 block text-xs font-medium">
+                        运行模型
+                      </span>
+                      <ModelNameSelect
+                        value={draft.model}
+                        onChange={(model) =>
+                          setDraft((current) => ({ ...current, model }))
+                        }
+                        disabled={busy}
+                        defaultLabel="使用系统默认模型"
+                        title="选择该全局智能体运行时使用的大模型"
+                        triggerClassName="h-9 w-full bg-background"
+                      />
+                    </label>
+                    <label className="block sm:col-span-2">
+                      <span className="mb-1.5 block text-xs font-medium">
+                        职责简介
+                      </span>
+                      <Textarea
+                        value={draft.description}
+                        disabled={busy}
+                        maxLength={2000}
+                        className="min-h-20 resize-y"
+                        placeholder="说明该角色关注的问题、交付内容和边界…"
+                        onChange={(event) =>
+                          setDraft((current) => ({
+                            ...current,
+                            description: event.target.value,
+                          }))
+                        }
+                      />
+                    </label>
+                  </div>
+
+                  {!creating && selectedAgent && !selectedAgent.fixed ? (
+                    <div className="mt-4 grid gap-3 border-t pt-4 sm:grid-cols-[1fr_180px] dark:border-[#173d68]">
+                      <div className="flex items-center justify-between rounded-lg border bg-background px-3 py-2.5 dark:border-[#28507c] dark:bg-[#08274c]">
+                        <div>
+                          <p className="text-sm font-medium">用于新项目</p>
+                          <p className="mt-0.5 text-xs text-muted-foreground">
+                            停用后历史项目仍可回显，新的角度选择将隐藏它
+                          </p>
+                        </div>
+                        <Switch
+                          checked={draft.enabled}
+                          disabled={busy}
+                          aria-label="启用该分析角度"
+                          onCheckedChange={(enabled) =>
+                            setDraft((current) => ({ ...current, enabled }))
+                          }
+                        />
+                      </div>
+                      <label className="block">
+                        <span className="mb-1.5 block text-xs font-medium">
+                          显示顺序
+                        </span>
+                        <Input
+                          type="number"
+                          min={-10000}
+                          max={10000}
+                          value={draft.sortOrder}
+                          disabled={busy}
+                          onChange={(event) =>
+                            setDraft((current) => ({
+                              ...current,
+                              sortOrder: Number(event.target.value) || 0,
+                            }))
+                          }
+                        />
+                      </label>
+                    </div>
+                  ) : creating ? (
+                    <label className="mt-4 block max-w-[180px] border-t pt-4 dark:border-[#173d68]">
+                      <span className="mb-1.5 block text-xs font-medium">
+                        显示顺序
+                      </span>
+                      <Input
+                        type="number"
+                        min={-10000}
+                        max={10000}
+                        value={draft.sortOrder}
+                        disabled={busy}
+                        onChange={(event) =>
+                          setDraft((current) => ({
+                            ...current,
+                            sortOrder: Number(event.target.value) || 0,
+                          }))
+                        }
+                      />
+                    </label>
+                  ) : null}
+                </section>
+
+                <label className="block">
+                  <span className="mb-2 flex items-center gap-2 text-sm font-medium">
+                    <Sparkles className="size-4 text-primary" /> SOUL
+                  </span>
+                  <Textarea
+                    value={draft.soul}
+                    disabled={busy}
+                    maxLength={200000}
+                    onChange={(event) =>
+                      setDraft((current) => ({
+                        ...current,
+                        soul: event.target.value,
+                      }))
+                    }
+                    className="min-h-[210px] resize-y font-mono text-xs leading-6"
+                    placeholder="定义角色身份、分析方法、行为边界和输出格式…"
+                  />
+                </label>
+
+                <section className="space-y-2">
+                  <div className="flex items-center justify-between gap-3">
+                    <span className="text-sm font-medium">系统技能选择</span>
+                    <Badge variant="secondary">
+                      已选 {draft.skills.length} 个
+                    </Badge>
+                  </div>
+                  <p className="text-xs leading-5 text-muted-foreground">
+                    只展示当前启用且全局可见的系统技能；通过穿梭框选择，不接受手工输入技能名。
+                  </p>
+                  <SkillTransferSelector
+                    skills={selectableSkills}
+                    selected={draft.skills}
+                    onChange={(selectedSkills) =>
+                      setDraft((current) => ({
+                        ...current,
+                        skills: selectedSkills,
+                      }))
+                    }
+                    isLoading={isSkillsLoading}
+                    onViewDetail={setDetailSkillName}
+                  />
+                  {skillsError ? (
+                    <p className="text-xs text-destructive">
+                      技能库加载失败，请稍后重试。
+                    </p>
+                  ) : null}
+                </section>
+              </div>
+            ) : (
+              <div className="flex h-64 items-center justify-center text-sm text-muted-foreground">
+                暂无可配置角色
+              </div>
+            )}
+          </main>
+        </div>
+
+        <DialogFooter className="flex-row items-center justify-between border-t px-6 py-4 dark:border-[#173d68] sm:justify-between">
+          <div>
+            {!creating && selectedAgent && !selectedAgent.fixed ? (
+              selectedAgent.enabled ? (
+                <Button
+                  variant="ghost"
+                  className="text-destructive hover:bg-destructive/10 hover:text-destructive"
+                  disabled={busy}
+                  onClick={() => void softDelete()}
+                >
+                  <Trash2 className="size-4" />
+                  停用并从新项目移除
+                </Button>
+              ) : (
+                <span className="flex items-center gap-1.5 text-xs text-muted-foreground">
+                  <Power className="size-3.5" />
+                  打开“用于新项目”并保存即可恢复
+                </span>
+              )
+            ) : (
+              <span className="text-xs text-muted-foreground">
+                {creating
+                  ? "新角度创建后立即全局可用"
+                  : "固定角色始终参与对应流程阶段"}
+              </span>
+            )}
+          </div>
+          <div className="flex gap-2">
+            <Button
+              variant="outline"
+              disabled={busy}
+              onClick={() => handleOpenChange(false)}
+            >
+              关闭
+            </Button>
+            <Button
+              disabled={
+                !categoryCopy ||
+                !draft.name.trim() ||
+                busy ||
+                isLoading ||
+                isSkillsLoading ||
+                (!creating && !dirty)
+              }
+              onClick={() => void save()}
+            >
+              {busy ? (
+                <LoaderCircle className="size-4 animate-spin" />
+              ) : creating ? (
+                <CirclePlus className="size-4" />
+              ) : (
+                <Save className="size-4" />
+              )}
+              {creating ? "创建分析角度" : "保存当前配置"}
+            </Button>
+          </div>
+        </DialogFooter>
+      </DialogContent>
+      <SkillDetailDialog
+        skillName={detailSkillName}
+        open={detailSkillName !== null}
+        onOpenChange={(nextOpen) => {
+          if (!nextOpen) setDetailSkillName(null);
+        }}
+      />
+    </Dialog>
+  );
+}

frontend-web/src/strategy-selection/api.ts

@@ -0,0 +1,44 @@
+import { apiFetch } from "@/core/api/fetch-client";
+import { getBackendBaseURL } from "@/core/config";
+
+import { parseSseChunk } from "./lib";
+import type { ParallelAgentEvent, ParallelAgentPayload } from "./types";
+
+async function readError(response: Response): Promise<string> {
+  const body = (await response.json().catch(() => null)) as
+    | { detail?: string }
+    | null;
+  return body?.detail || `请求失败（HTTP ${response.status}）`;
+}
+export async function streamParallelAgents(
+  payload: ParallelAgentPayload,
+  onEvent: (event: ParallelAgentEvent) => void,
+  signal?: AbortSignal,
+): Promise<void> {
+  const response = await apiFetch(
+    `${getBackendBaseURL()}/api/parallel-agents/run/stream`,
+    {
+      method: "POST",
+      headers: {
+        Accept: "text/event-stream",
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify(payload),
+      signal,
+    },
+  );
+  if (!response.ok) throw new Error(await readError(response));
+  if (!response.body) throw new Error("服务器未返回流式响应");
+
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  while (true) {
+    const { done, value } = await reader.read();
+    buffer += decoder.decode(value, { stream: !done });
+    const parsed = parseSseChunk(buffer, done);
+    buffer = parsed.rest;
+    parsed.events.forEach(onEvent);
+    if (done) break;
+  }
+}

frontend-web/src/strategy-selection/constants.ts

@@ -0,0 +1,350 @@
+import type {
+  AgentOutputState,
+  IntentTurn,
+  StrategyAngle,
+  StrategyEvaluation,
+  StrategyTaskDraft,
+} from "./types";
+
+export const STRATEGY_AGENT_ROLES = [
+  {
+    id: "strategy-selection-intent",
+    name: "意图理解智能体",
+    role: "将自然语言需求整理为可执行任务",
+  },
+  {
+    id: "strategy-selection-angle-governance",
+    name: "治理统筹智能体",
+    role: "关注目标、机制、跨部门协同与执行闭环",
+  },
+  {
+    id: "strategy-selection-angle-diplomacy",
+    name: "外交沟通智能体",
+    role: "关注沟通渠道、危机管控与多边协调",
+  },
+  {
+    id: "strategy-selection-angle-economy",
+    name: "经济韧性智能体",
+    role: "关注供应链、产业、贸易与市场预期",
+  },
+  {
+    id: "strategy-selection-angle-security",
+    name: "安全风险智能体",
+    role: "关注预警、误判防范与非升级性风险处置",
+  },
+  {
+    id: "strategy-selection-angle-public-opinion",
+    name: "社会民生智能体",
+    role: "关注公众沟通、民生连续性与人道保障",
+  },
+  {
+    id: "strategy-selection-angle-law-policy",
+    name: "法律规则智能体",
+    role: "关注适用规则、合规边界与证据链",
+  },
+  {
+    id: "strategy-selection-judge",
+    name: "策略评判智能体",
+    role: "以统一量表比较策略的收益、风险与可执行性",
+  },
+  {
+    id: "strategy-selection-solution",
+    name: "方案整理智能体",
+    role: "将入选策略去重、消冲突并整理为最终方案",
+  },
+] as const;
+
+export const STRATEGY_ANGLES: StrategyAngle[] = [
+  {
+    id: "governance",
+    agentId: "strategy-selection-angle-governance",
+    name: "治理与统筹",
+    shortName: "治理",
+    description: "目标拆解、组织协同、阶段推进和反馈闭环",
+    accent: "#6d5dfc",
+  },
+  {
+    id: "diplomacy",
+    agentId: "strategy-selection-angle-diplomacy",
+    name: "外交与沟通",
+    shortName: "外交",
+    description: "危机沟通、多边协调、信号一致性与降温安排",
+    accent: "#0ea5e9",
+  },
+  {
+    id: "economy",
+    agentId: "strategy-selection-angle-economy",
+    name: "经济与产业韧性",
+    shortName: "经济",
+    description: "供应链连续性、市场预期、贸易和关键产业保障",
+    accent: "#10b981",
+  },
+  {
+    id: "security",
+    agentId: "strategy-selection-angle-security",
+    name: "安全与风险管控",
+    shortName: "安全",
+    description: "态势预警、误判防范、事件分级和非升级性处置",
+    accent: "#f97316",
+  },
+  {
+    id: "public_opinion",
+    agentId: "strategy-selection-angle-public-opinion",
+    name: "社会民生与舆情",
+    shortName: "民生",
+    description: "公众沟通、基本服务、社会心理和人道保障",
+    accent: "#ec4899",
+  },
+  {
+    id: "law_policy",
+    agentId: "strategy-selection-angle-law-policy",
+    name: "法律与规则",
+    shortName: "法律",
+    description: "适用规则、合规审查、责任边界与证据留存",
+    accent: "#a855f7",
+  },
+];
+
+export const EMPTY_TASK_DRAFT: StrategyTaskDraft = {
+  name: "",
+  detail: "",
+  objective: "",
+  prerequisites: "",
+  constraints: "",
+  deliverables: "",
+  acceptanceCriteria: "",
+  horizon: "",
+  selectedAngleIds: STRATEGY_ANGLES.slice(0, 4).map((angle) => angle.id),
+};
+
+export const INITIAL_INTENT_TURNS: IntentTurn[] = [
+  {
+    id: "welcome",
+    role: "assistant",
+    content:
+      "请描述你想解决的问题、希望达成的目标以及已知约束。我会通过对话补齐关键信息，并把需求实时整理到右侧任务草稿。",
+  },
+];
+
+export const TAIWAN_STRAIT_DEMO_TASK: StrategyTaskDraft = {
+  name: "台海局势风险管控与区域韧性提升策略",
+  detail:
+    "面向台海局势高不确定性场景，形成一套不预设立场、以避免误判和升级为核心的综合政策方案。方案聚焦危机沟通、区域经济与民生连续性、规则遵循及信息透明，不包含战术行动、目标选择或武力运用指导。",
+  objective:
+    "未来12—24个月内，降低突发事件转化为系统性危机的概率，保护平民福祉与关键经济活动，维持可验证、可持续的沟通和协调机制。",
+  prerequisites:
+    "建立跨部门联合研判机制；明确授权与对外沟通口径；掌握航运、能源、金融、通信和公共服务的基础风险数据；预留与各相关方沟通的技术渠道。",
+  constraints:
+    "遵守适用的国际法及人道原则；坚持克制、对等、可逆和非升级；不得输出军事战术、具体目标、武器使用或规避监管建议；关键事实须标注时点并交叉核验。",
+  deliverables:
+    "一份综合策略；分阶段行动清单；跨部门责任矩阵；风险预警指标；对外沟通要点；每月复盘和动态调整机制。",
+  acceptanceCriteria:
+    "措施均有责任主体、触发条件和退出条件；重要建议至少经两个角度交叉验证；高风险措施设置法律审查与升级门槛；方案可在72小时内启动首轮响应。",
+  horizon: "12—24个月，按0—30天、1—6个月、6—24个月分三阶段推进",
+  selectedAngleIds: STRATEGY_ANGLES.map((angle) => angle.id),
+};
+
+export const TAIWAN_STRAIT_DEMO_TURNS: IntentTurn[] = [
+  ...INITIAL_INTENT_TURNS,
+  {
+    id: "demo-user",
+    role: "user",
+    isDemo: true,
+    content:
+      "请围绕台海局势做一个综合风险管控策略，重点是减少误判升级，同时兼顾经济、民生和规则约束，时间范围看未来一到两年。",
+  },
+  {
+    id: "demo-assistant",
+    role: "assistant",
+    isDemo: true,
+    content:
+      "已将需求整理为“风险管控与区域韧性提升”任务：以降级避险为目标，采用治理、外交、经济、安全、民生和法律六个角度并行论证；明确排除战术性军事建议，并补充了阶段周期、验收标准和启动条件。右侧字段仍可直接修改。",
+  },
+];
+
+export const TAIWAN_STRAIT_DEMO_OUTPUTS: Record<string, AgentOutputState> = {
+  "strategy-selection-angle-governance": {
+    status: "done",
+    isDemo: true,
+    steps: ["拆解目标", "形成协同机制", "设置复盘闭环"],
+    content: `### 治理统筹策略：建立“联合研判—分级响应—复盘校正”闭环
+
+1. 设立常态化跨部门风险研判单元，统一风险词典、数据口径和事件分级。
+2. 为不同风险等级预先定义责任主体、会商时限、可逆措施和退出条件，避免临时决策放大误判。
+3. 建立月度桌面推演与季度复盘，重点校验交通、能源、金融、通信和公共服务之间的级联风险。
+4. 重大调整实行“政策效果—升级风险—民生影响—法律合规”四项并联审查。
+
+**优先动作：** 30天内完成责任矩阵和跨部门值守清单；90天内完成首次全链路压力测试。`,
+  },
+  "strategy-selection-angle-diplomacy": {
+    status: "done",
+    isDemo: true,
+    steps: ["识别沟通对象", "设计危机渠道", "校准公开信号"],
+    content: `### 外交沟通策略：保持多层次、可验证的危机沟通
+
+1. 维护工作层、专业部门和高层三类沟通渠道，约定紧急事件的确认窗口与回执机制。
+2. 对外表述采用“事实、原则、下一步安排”三段式，减少模糊威慑和相互误读。
+3. 支持以航行安全、灾害救援、公共卫生等低政治敏感议题开展技术性接触，积累最低限度信任。
+4. 引入可信第三方作为信息转递与事实核验的备份通道，但不替代直接沟通。
+
+**触发条件：** 当出现信息不一致、渠道中断或舆情快速放大时，立即启动双渠道交叉确认。`,
+  },
+  "strategy-selection-angle-economy": {
+    status: "done",
+    isDemo: true,
+    steps: ["识别关键链路", "评估替代能力", "配置韧性措施"],
+    content: `### 经济韧性策略：先保连续性，再做结构性分散
+
+1. 对航运、半导体、能源、金融结算和通信链路建立关键节点清单与中断情景。
+2. 以库存天数、替代供应商覆盖率、运输改道时间和流动性缺口作为月度韧性指标。
+3. 对短期冲击优先使用信息协调、应急库存和融资支持，避免仓促、不可逆的全面脱钩措施。
+4. 中长期推动来源与路线多元化，同时保留正常经贸交往的政策空间。
+
+**优先动作：** 对关键民生物资开展30/60/90天压力测试，并为中小企业准备定向流动性工具。`,
+  },
+  "strategy-selection-angle-security": {
+    status: "done",
+    isDemo: true,
+    steps: ["构建预警指标", "划分风险等级", "设计降级动作"],
+    content: `### 安全风险策略：以预警和降级机制减少偶发事件外溢
+
+1. 建立覆盖异常活动、通信中断、错误信息扩散、交通受阻和市场波动的综合预警看板。
+2. 将风险划分为关注、紧张、严重三级，每级只配置克制、可逆、可解释的非升级性应对动作。
+3. 对来源未核实的信息实行“双源确认+时点标注”，避免单一信号直接触发重大政策响应。
+4. 所有高风险决策设置冷静期、法律复核和跨部门反方意见席位。
+
+**止损线：** 一旦沟通渠道失效或民生影响超过阈值，优先恢复沟通与公共服务，暂停可能叠加风险的新措施。`,
+  },
+  "strategy-selection-angle-public-opinion": {
+    status: "done",
+    isDemo: true,
+    steps: ["分析公众需求", "保障基本服务", "设计信息发布"],
+    content: `### 社会民生策略：稳定预期并保护基本服务
+
+1. 建立权威、固定频率的信息发布窗口，明确已知、未知和正在核验的事项。
+2. 为交通、医疗、能源、通信和教育准备连续性方案，优先保障脆弱群体。
+3. 监测谣言与恐慌性行为时，采用事实澄清和服务指引，不扩大未经证实的信息。
+4. 设置独立反馈渠道，收集企业、社区和民众的实际困难并纳入每日研判。
+
+**评价指标：** 基本服务可用率、权威信息触达率、谣言纠正时长和重点群体保障覆盖率。`,
+  },
+  "strategy-selection-angle-law-policy": {
+    status: "done",
+    isDemo: true,
+    steps: ["识别规则边界", "建立审查清单", "设计留痕机制"],
+    content: `### 法律规则策略：把合规审查嵌入每个决策节点
+
+1. 为数据共享、经济措施、应急管理和对外沟通分别建立适用规则清单。
+2. 重大措施记录事实依据、授权来源、比例性判断、影响评估和退出条件。
+3. 涉及平民权益、基本服务和跨境活动的措施优先进行人道影响评估。
+4. 对时效性强的事项采用“快速初审—事后完整复核”，但不得跳过最低合规门槛。
+
+**优先动作：** 建立统一法律审查模板和决策证据包，保证后续可解释、可追溯。`,
+  },
+};
+
+export const TAIWAN_STRAIT_DEMO_EVALUATIONS: StrategyEvaluation[] = [
+  {
+    agentId: "strategy-selection-angle-governance",
+    score: 92,
+    conclusion: "优先推荐",
+    comment: "跨部门闭环清晰，是其他策略落地的共同底座。",
+    strengths: ["责任明确", "阶段完整", "便于复盘"],
+    risks: ["需要稳定的牵头机制"],
+  },
+  {
+    agentId: "strategy-selection-angle-diplomacy",
+    score: 90,
+    conclusion: "优先推荐",
+    comment: "直接作用于误判风险，且措施克制、可逆。",
+    strengths: ["降级效果直接", "渠道有备份"],
+    risks: ["依赖相关方持续参与"],
+  },
+  {
+    agentId: "strategy-selection-angle-economy",
+    score: 86,
+    conclusion: "建议采用",
+    comment: "兼顾短期连续性与长期韧性，需控制过度防御成本。",
+    strengths: ["指标可量化", "避免一刀切"],
+    risks: ["跨行业数据获取成本较高"],
+  },
+  {
+    agentId: "strategy-selection-angle-security",
+    score: 91,
+    conclusion: "优先推荐",
+    comment: "预警、确认和冷静期设计可显著降低错误触发。",
+    strengths: ["止损线清楚", "强调双源核验"],
+    risks: ["阈值需持续校准"],
+  },
+  {
+    agentId: "strategy-selection-angle-public-opinion",
+    score: 84,
+    conclusion: "建议采用",
+    comment: "增强社会承压能力，建议与经济连续性方案合并实施。",
+    strengths: ["关注脆弱群体", "沟通指标明确"],
+    risks: ["需避免信息发布碎片化"],
+  },
+  {
+    agentId: "strategy-selection-angle-law-policy",
+    score: 88,
+    conclusion: "建议采用",
+    comment: "为高压情境下的决策提供必要边界和可追溯性。",
+    strengths: ["审查嵌入流程", "留痕充分"],
+    risks: ["快速响应与完整审查需平衡"],
+  },
+];
+
+export const TAIWAN_STRAIT_DEMO_SYNTHESIS = `# 台海局势风险管控与区域韧性提升综合方案
+
+> **示例说明：** 本方案为产品功能演示数据，采用中立、降级避险和民生优先视角，不构成现实决策建议；正式使用前应依据最新可靠信息进行专业复核。
+
+## 一、总体目标
+
+在未来12—24个月内，以“减少误判、阻断升级、保护民生、维持连续性”为主线，建立可监测、可启动、可退出、可复盘的风险管控体系。任何措施均应符合适用规则，坚持克制、对等、可逆和可解释。
+
+## 二、四条主策略
+
+### 1. 联合研判与分级响应
+
+- 建立跨部门常态研判单元，统一风险词典、数据口径和三级事件标准。
+- 每个级别明确牵头主体、会商时限、启动阈值、允许动作和退出条件。
+- 重大建议同时接受政策效果、升级风险、民生影响和法律合规审查。
+
+### 2. 多层危机沟通与事实核验
+
+- 维护工作层、专业部门和高层沟通渠道，并配置可信第三方备份。
+- 紧急事项执行“双渠道回执、双来源确认、统一时点标注”。
+- 公开沟通采用“事实—原则—下一步安排”结构，降低信号歧义。
+
+### 3. 经济与公共服务连续性
+
+- 围绕航运、能源、金融、通信、医疗和关键供应链建立中断情景清单。
+- 用库存天数、替代覆盖率、改道时长、服务可用率等指标开展月度压力测试。
+- 短期优先使用应急库存、信息协调和定向融资；中长期有序提升来源与路线多元化。
+
+### 4. 规则嵌入与社会韧性
+
+- 将授权来源、比例性、人道影响、退出条件和证据留存纳入统一审查模板。
+- 通过固定频率的权威发布说明已知、未知和核验进度，提供清晰服务指引。
+- 优先保障脆弱群体，并建立企业、社区与公众反馈的快速回流机制。
+
+## 三、阶段安排
+
+| 阶段 | 重点动作 | 主要产出 |
+| --- | --- | --- |
+| 0—30天 | 完成责任矩阵、沟通清单、关键链路盘点与法律审查模板 | 一图一表一清单、首版预警看板 |
+| 1—6个月 | 开展压力测试和桌面推演，打通双渠道确认与公众反馈 | 演练报告、阈值校准、改进台账 |
+| 6—24个月 | 推进结构性韧性项目并季度复盘，动态退出低效措施 | 韧性提升项目、季度评估报告 |
+
+## 四、核心预警指标
+
+1. 沟通渠道可用率与紧急事项回执时长。
+2. 未核实信息传播速度及权威澄清时长。
+3. 关键运输、能源、金融、通信和公共服务可用率。
+4. 市场异常波动、关键物资库存天数与替代供应覆盖率。
+5. 脆弱群体保障覆盖率和公众反馈闭环时长。
+
+## 五、止损与调整机制
+
+当直接沟通失效、基本服务明显下降、信息可信度不足或风险指标跨级跃升时，优先恢复沟通、事实核验和民生服务；暂停新增高风险措施。每月复盘策略组合，每季度由独立评估组检查目标偏移、措施叠加和退出条件执行情况。
+`;

frontend-web/src/strategy-selection/lib.test.ts

@@ -0,0 +1,329 @@
+/**
+ * Run from frontend-web:
+ *   npx esbuild src/strategy-selection/lib.test.ts --bundle --format=esm --platform=node --outfile=.runtime/unit-tests/strategy-selection.test.mjs
+ *   node --test .runtime/unit-tests/strategy-selection.test.mjs
+ */
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import {
+  areStrategyTaskDraftsEquivalent,
+  buildIntentBrief,
+  buildJudgeBrief,
+  buildSynthesisBrief,
+  extractFencedJson,
+  normalizeIntentClarification,
+  parseEvaluationsFromText,
+  parseSseChunk,
+  parseTaskDraftFromText,
+  stripStructuredBlocks,
+} from "./lib";
+import { EMPTY_TASK_DRAFT, STRATEGY_ANGLES } from "./constants";
+import type { AgentOutputState, StrategyAngle } from "./types";
+
+test("parseSseChunk preserves incomplete frames and parses subsequent frames", () => {
+  const first = parseSseChunk(
+    'data: {"type":"agent_start","agent_id":"a"}\n\ndata: {"type":"del',
+  );
+  assert.equal(first.events.length, 1);
+  assert.equal(first.events[0].type, "agent_start");
+  const second = parseSseChunk(`${first.rest}ta","agent_id":"a","text":"你好"}\n\n`);
+  assert.deepEqual(second.events, [
+    { type: "delta", agent_id: "a", text: "你好" },
+  ]);
+});
+
+test("normalizeIntentClarification accepts string and object options", () => {
+  const clarification = normalizeIntentClarification({
+    type: "agent_clarification",
+    agent_id: "strategy-selection-intent",
+    question: "请选择时间范围",
+    options: ["短期", { id: "long", label: "长期", description: "一年以上" }],
+    allow_custom: true,
+    allow_multiple: false,
+  });
+  assert.equal(clarification.question, "请选择时间范围");
+  assert.deepEqual(clarification.options, [
+    { id: "option-1", label: "短期", description: undefined },
+    { id: "long", label: "长期", description: "一年以上" },
+  ]);
+  assert.equal(clarification.allowCustom, true);
+});
+
+test("task draft equivalence ignores whitespace and angle ordering only", () => {
+  const left = {
+    ...EMPTY_TASK_DRAFT,
+    name: "区域 风险方案",
+    detail: "第一行\n第二行",
+    selectedAngleIds: ["governance", "diplomacy"],
+  };
+  const presentationOnlyChange = {
+    ...left,
+    name: "  区域   风险方案 ",
+    detail: "第一行  第二行",
+    selectedAngleIds: ["diplomacy", "governance", "diplomacy"],
+  };
+  assert.equal(
+    areStrategyTaskDraftsEquivalent(left, presentationOnlyChange),
+    true,
+  );
+  assert.equal(
+    areStrategyTaskDraftsEquivalent(left, {
+      ...presentationOnlyChange,
+      objective: "新增目标",
+    }),
+    false,
+  );
+});
+
+test("intent brief retains the clarification question and the user's confirmed answer", () => {
+  const brief = buildIntentBrief(
+    [
+      {
+        id: "clarify",
+        role: "assistant",
+        content: "",
+        clarification: {
+          question: "方案主要面向谁？",
+          options: [{ id: "public", label: "公共部门" }],
+          allowCustom: true,
+          allowMultiple: false,
+        },
+        clarificationAnswered: true,
+        clarificationAnswer: "公共部门",
+      },
+      { id: "answer", role: "user", content: "对澄清问题的回答：公共部门" },
+    ],
+    EMPTY_TASK_DRAFT,
+  );
+  assert.match(brief, /意图助手澄清：方案主要面向谁/);
+  assert.match(brief, /用户对该澄清的确认：公共部门/);
+});
+
+test("stripStructuredBlocks keeps prose and hides machine-readable payloads", () => {
+  assert.equal(
+    stripStructuredBlocks('说明文字\n[INTENT_READY]\n```strategy-task-json\n{"name":"x"}\n```'),
+    "说明文字",
+  );
+});
+
+test("extractFencedJson and parseTaskDraftFromText read the structured task block", () => {
+  const text = [
+    "已整理任务。",
+    "```strategy-task-json",
+    JSON.stringify({
+      name: "测试任务",
+      detail: "详情",
+      recommended_angles: ["governance", "unknown", "law_policy"],
+    }),
+    "```",
+  ].join("\n");
+  assert.deepEqual(extractFencedJson(text, "strategy-task-json"), {
+    name: "测试任务",
+    detail: "详情",
+    recommended_angles: ["governance", "unknown", "law_policy"],
+  });
+  const task = parseTaskDraftFromText(text, EMPTY_TASK_DRAFT);
+  assert.equal(task?.name, "测试任务");
+  assert.deepEqual(task?.selectedAngleIds, ["governance", "law_policy"]);
+});
+
+test("task parser accepts backend SOUL field aliases", () => {
+  const text = `\`\`\`strategy-task-json\n${JSON.stringify({
+    task_name: "别名任务",
+    task_detail: "别名详情",
+    expected_outputs: "综合方案",
+    recommended_angles: ["public_opinion", "strategy-selection-angle-law-policy"],
+  })}\n\`\`\``;
+  const task = parseTaskDraftFromText(text, EMPTY_TASK_DRAFT);
+  assert.equal(task?.name, "别名任务");
+  assert.equal(task?.detail, "别名详情");
+  assert.equal(task?.deliverables, "综合方案");
+  assert.deepEqual(task?.selectedAngleIds, ["public_opinion", "law_policy"]);
+});
+
+test("task parser rejects incomplete or unrecognized current-turn payloads", () => {
+  const completeFallback = {
+    ...EMPTY_TASK_DRAFT,
+    name: "旧任务",
+    detail: "旧详情",
+    selectedAngleIds: ["governance"],
+  };
+  const wrap = (payload: unknown) =>
+    `\`\`\`strategy-task-json\n${JSON.stringify(payload)}\n\`\`\``;
+
+  assert.equal(parseTaskDraftFromText(wrap({}), completeFallback), null);
+  assert.equal(parseTaskDraftFromText(wrap([]), completeFallback), null);
+  assert.equal(
+    parseTaskDraftFromText(
+      wrap({ name: "新任务", detail: "新详情", selectedAngleIds: ["unknown"] }),
+      completeFallback,
+    ),
+    null,
+  );
+  assert.equal(
+    parseTaskDraftFromText(
+      wrap({ name: "新任务", detail: "新详情" }),
+      completeFallback,
+    ),
+    null,
+  );
+});
+
+test("evaluation parser validates scores without inventing missing candidates", () => {
+  const outputs: Record<string, AgentOutputState> = {
+    "strategy-selection-angle-governance": {
+      status: "done",
+      content: "A",
+      steps: [],
+    },
+    "strategy-selection-angle-law-policy": { status: "done", content: "B", steps: [] },
+    "strategy-selection-angle-security": {
+      status: "error",
+      content: "PARTIAL_FAILED_OUTPUT",
+      steps: [],
+      error: "failed",
+    },
+  };
+  const text = `\`\`\`strategy-evaluation-json\n${JSON.stringify({
+    evaluations: [
+      {
+        agentId: "strategy-selection-angle-governance",
+        score: 100,
+        conclusion: "优先推荐",
+        comment: "清晰",
+      },
+    ],
+  })}\n\`\`\``;
+  const evaluations = parseEvaluationsFromText(text, outputs);
+  assert.equal(evaluations.length, 1);
+  assert.equal(evaluations[0].score, 100);
+  assert.equal(
+    evaluations.some(
+      (item) => item.agentId === "strategy-selection-angle-law-policy",
+    ),
+    false,
+  );
+  assert.equal(buildJudgeBrief(EMPTY_TASK_DRAFT, outputs).includes("PARTIAL_FAILED_OUTPUT"), false);
+});
+
+test("judge prompt and evaluation parser only use task-selected angles", () => {
+  const outputs: Record<string, AgentOutputState> = {
+    "strategy-selection-angle-governance": { status: "done", content: "治理策略", steps: [] },
+    "strategy-selection-angle-law-policy": { status: "done", content: "法律策略", steps: [] },
+  };
+  const task = { ...EMPTY_TASK_DRAFT, selectedAngleIds: ["governance"] };
+  const brief = buildJudgeBrief(task, outputs);
+  assert.equal(brief.includes("治理策略"), true);
+  assert.equal(brief.includes("法律策略"), false);
+  const evaluations = parseEvaluationsFromText("无结构化量表", outputs, [
+    "strategy-selection-angle-governance",
+  ]);
+  assert.deepEqual(evaluations, []);
+});
+
+test("dynamic administrator angles flow through intent parsing and judging without fabricated evaluation", () => {
+  const dynamic: StrategyAngle = {
+    id: "technology",
+    agentId: "strategy-selection-angle-dynamic-tech",
+    name: "科技与产业链",
+    shortName: "科技",
+    description: "关注技术依赖与产业协同",
+    accent: "#2563eb",
+    enabled: true,
+  };
+  const task = {
+    ...EMPTY_TASK_DRAFT,
+    selectedAngleIds: [dynamic.id],
+  };
+  const parsed = parseTaskDraftFromText(
+    `\`\`\`strategy-task-json\n${JSON.stringify({
+      name: "动态任务",
+      detail: "测试管理员新增角度",
+      selectedAngleIds: [dynamic.agentId],
+    })}\n\`\`\``,
+    task,
+    [dynamic],
+  );
+  assert.deepEqual(parsed?.selectedAngleIds, [dynamic.id]);
+  assert.match(buildIntentBrief([], task, [dynamic]), /technology：科技与产业链/);
+
+  const outputs: Record<string, AgentOutputState> = {
+    [dynamic.agentId]: { status: "done", content: "科技策略", steps: [] },
+  };
+  assert.match(buildJudgeBrief(task, outputs, [dynamic]), /科技策略/);
+  assert.deepEqual(
+    parseEvaluationsFromText("没有结构化评判", outputs, [dynamic.agentId], [dynamic]),
+    [],
+  );
+});
+
+test("evaluation parser rejects missing fields, invalid scores, and duplicate agent rows", () => {
+  const agentId = "strategy-selection-angle-governance";
+  const outputs: Record<string, AgentOutputState> = {
+    [agentId]: { status: "done", content: "治理策略", steps: [] },
+  };
+  const wrap = (evaluations: Record<string, unknown>[]) =>
+    `\`\`\`strategy-evaluation-json\n${JSON.stringify({ evaluations })}\n\`\`\``;
+
+  assert.deepEqual(
+    parseEvaluationsFromText(
+      `\`\`\`strategy-evaluation-json\n${JSON.stringify({ evaluations: [null] })}\n\`\`\``,
+      outputs,
+      [agentId],
+    ),
+    [],
+  );
+
+  assert.deepEqual(
+    parseEvaluationsFromText(wrap([{ agentId, conclusion: "建议采用" }]), outputs, [agentId]),
+    [],
+  );
+  assert.deepEqual(
+    parseEvaluationsFromText(
+      wrap([{ agentId, score: 80.5, conclusion: "建议采用" }]),
+      outputs,
+      [agentId],
+    ),
+    [],
+  );
+  assert.deepEqual(
+    parseEvaluationsFromText(
+      wrap([
+        { agentId, score: 80, conclusion: "建议采用" },
+        { agentId, score: 75, conclusion: "保留备选" },
+      ]),
+      outputs,
+      [agentId],
+    ),
+    [],
+  );
+});
+
+test("synthesis prompt exposes only the user's final strategy basket", () => {
+  const governance = STRATEGY_ANGLES.find((angle) => angle.id === "governance")!;
+  const security = STRATEGY_ANGLES.find((angle) => angle.id === "security")!;
+  const task = {
+    ...EMPTY_TASK_DRAFT,
+    selectedAngleIds: STRATEGY_ANGLES.map((angle) => angle.id),
+  };
+  const outputs: Record<string, AgentOutputState> = {
+    [governance.agentId]: { status: "done", content: "治理入选正文", steps: [] },
+    [security.agentId]: { status: "done", content: "安全未入选正文", steps: [] },
+  };
+  const brief = buildSynthesisBrief(
+    task,
+    [governance.agentId],
+    outputs,
+    [],
+    STRATEGY_ANGLES,
+  );
+
+  assert.match(
+    brief,
+    new RegExp(`最终只允许整合以下 1 项：${governance.name}`),
+  );
+  assert.match(brief, /治理入选正文/);
+  assert.equal(brief.includes("安全未入选正文"), false);
+  assert.match(brief, /"selectedAngleIds": \[\s*"governance"\s*\]/);
+});

frontend-web/src/strategy-selection/lib.ts

@@ -0,0 +1,408 @@
+import { STRATEGY_ANGLES } from "./constants";
+import type {
+  AgentOutputState,
+  IntentClarification,
+  IntentTurn,
+  ParallelAgentEvent,
+  StrategyAngle,
+  StrategyEvaluation,
+  StrategyTaskDraft,
+} from "./types";
+
+function stringValue(value: unknown): string {
+  return typeof value === "string" ? value.trim() : "";
+}
+
+export function normalizeIntentClarification(
+  event: Extract<ParallelAgentEvent, { type: "agent_clarification" }>,
+): IntentClarification {
+  const question =
+    stringValue(event.question) ||
+    stringValue(event.content) ||
+    "请补充完成任务定义所需的信息。";
+  const options = Array.isArray(event.options)
+    ? event.options
+        .map((option, index) => {
+          const label =
+            typeof option === "string" ? stringValue(option) : stringValue(option?.label);
+          if (!label) return null;
+          return {
+            id:
+              (typeof option === "string" ? "" : stringValue(option.id)) ||
+              `option-${index + 1}`,
+            label,
+            description:
+              (typeof option === "string" ? "" : stringValue(option.description)) ||
+              undefined,
+          };
+        })
+        .filter((option): option is NonNullable<typeof option> => option !== null)
+    : [];
+  return {
+    question,
+    context:
+      stringValue(event.clarification_context) ||
+      stringValue(event.context) ||
+      undefined,
+    clarificationType: stringValue(event.clarification_type) || undefined,
+    options,
+    allowCustom: event.allow_custom !== false || options.length === 0,
+    allowMultiple: event.allow_multiple === true,
+  };
+}
+
+function selectedStrategyAgentIds(
+  task: StrategyTaskDraft,
+  angles: StrategyAngle[],
+): Set<string> {
+  return new Set(
+    angles.filter((angle) => task.selectedAngleIds.includes(angle.id)).map(
+      (angle) => angle.agentId,
+    ),
+  );
+}
+
+const TASK_DRAFT_TEXT_FIELDS = [
+  "name",
+  "detail",
+  "objective",
+  "prerequisites",
+  "constraints",
+  "deliverables",
+  "acceptanceCriteria",
+  "horizon",
+] as const satisfies readonly (keyof StrategyTaskDraft)[];
+
+function normalizeTaskDraftText(value: string): string {
+  return value.trim().replace(/\s+/g, " ");
+}
+
+/**
+ * Treat presentation-only whitespace and angle ordering as equivalent so an
+ * intent-agent round trip cannot invalidate an already generated workflow
+ * unless the task's meaning actually changed.
+ */
+export function areStrategyTaskDraftsEquivalent(
+  left: StrategyTaskDraft,
+  right: StrategyTaskDraft,
+): boolean {
+  const textFieldsMatch = TASK_DRAFT_TEXT_FIELDS.every(
+    (field) =>
+      normalizeTaskDraftText(left[field] as string) ===
+      normalizeTaskDraftText(right[field] as string),
+  );
+  if (!textFieldsMatch) return false;
+
+  const leftAngles = [...new Set(left.selectedAngleIds)].sort();
+  const rightAngles = [...new Set(right.selectedAngleIds)].sort();
+  return (
+    leftAngles.length === rightAngles.length &&
+    leftAngles.every((angleId, index) => angleId === rightAngles[index])
+  );
+}
+
+function stringList(value: unknown): string[] {
+  if (!Array.isArray(value)) return [];
+  return value.map(stringValue).filter(Boolean);
+}
+
+export function extractFencedJson<T>(text: string, marker?: string): T | null {
+  const escaped = marker?.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const patterns = [
+    escaped ? new RegExp("```" + escaped + "\\s*([\\s\\S]*?)```", "i") : null,
+    /```(?:json)?\s*([\s\S]*?)```/i,
+  ].filter(Boolean) as RegExp[];
+
+  for (const pattern of patterns) {
+    const match = pattern.exec(text);
+    if (!match?.[1]) continue;
+    try {
+      return JSON.parse(match[1].trim()) as T;
+    } catch {
+      // The model may have emitted another fenced block first; fall through to
+      // the balanced-object fallback below.
+    }
+  }
+
+  const firstObject = text.indexOf("{");
+  const lastObject = text.lastIndexOf("}");
+  if (firstObject >= 0 && lastObject > firstObject) {
+    try {
+      return JSON.parse(text.slice(firstObject, lastObject + 1)) as T;
+    } catch {
+      return null;
+    }
+  }
+  return null;
+}
+
+export function stripStructuredBlocks(text: string): string {
+  return text
+    .replace(/```(?:strategy-task-json|strategy-evaluation-json)\s*[\s\S]*?```/gi, "")
+    .replace(/\[(?:INTENT_READY|JUDGEMENT_READY)\]/gi, "")
+    .trim();
+}
+
+export function parseTaskDraftFromText(
+  text: string,
+  fallback: StrategyTaskDraft,
+  angles: StrategyAngle[] = STRATEGY_ANGLES,
+): StrategyTaskDraft | null {
+  const parsed = extractFencedJson<Record<string, unknown>>(text, "strategy-task-json");
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return null;
+  const rawName = parsed.name ?? parsed.task_name;
+  const rawDetail = parsed.detail ?? parsed.task_detail;
+  const rawAngles = parsed.selectedAngleIds ?? parsed.recommended_angles;
+  if (
+    typeof rawName !== "string" ||
+    !rawName.trim() ||
+    typeof rawDetail !== "string" ||
+    !rawDetail.trim() ||
+    !Array.isArray(rawAngles)
+  ) {
+    return null;
+  }
+  const angleIds = [
+    ...new Set(
+      rawAngles
+        .map(stringValue)
+        .map((value) => {
+          const normalized = value.toLowerCase().replaceAll("-", "_");
+          return angles.find(
+            (angle) =>
+              angle.id === normalized ||
+              angle.agentId === value ||
+              angle.name === value ||
+              angle.shortName === value,
+          )?.id;
+        })
+        .filter((id): id is string => Boolean(id)),
+    ),
+  ];
+  if (!angleIds.length) return null;
+
+  return {
+    name: stringValue(rawName),
+    detail: stringValue(rawDetail),
+    objective: stringValue(parsed.objective) || fallback.objective,
+    prerequisites:
+      stringValue(parsed.prerequisites) || fallback.prerequisites,
+    constraints: stringValue(parsed.constraints) || fallback.constraints,
+    deliverables:
+      stringValue(parsed.deliverables ?? parsed.expected_outputs) || fallback.deliverables,
+    acceptanceCriteria:
+      stringValue(parsed.acceptanceCriteria) || fallback.acceptanceCriteria,
+    horizon: stringValue(parsed.horizon) || fallback.horizon,
+    selectedAngleIds: angleIds,
+  };
+}
+
+export function parseEvaluationsFromText(
+  text: string,
+  outputs: Record<string, AgentOutputState>,
+  allowedAgentIds?: Iterable<string>,
+  angles: StrategyAngle[] = STRATEGY_ANGLES,
+): StrategyEvaluation[] {
+  const parsed = extractFencedJson<
+    { evaluations?: Record<string, unknown>[] } | Record<string, unknown>[]
+  >(text, "strategy-evaluation-json");
+  const rows = Array.isArray(parsed) ? parsed : parsed?.evaluations;
+  if (!Array.isArray(rows)) return [];
+
+  const allowed = allowedAgentIds ? new Set(allowedAgentIds) : null;
+  const knownIds = new Set(
+    angles.filter((angle) => !allowed || allowed.has(angle.agentId)).map(
+      (angle) => angle.agentId,
+    ),
+  );
+  const evaluations: StrategyEvaluation[] = [];
+  const seen = new Set<string>();
+  for (const row of rows) {
+    if (!row || typeof row !== "object" || Array.isArray(row)) return [];
+    const agentId = stringValue(row.agentId ?? row.agent_id);
+    if (!knownIds.has(agentId)) continue;
+
+    const score = row.score;
+    const conclusion = stringValue(row.conclusion);
+    if (
+      seen.has(agentId) ||
+      outputs[agentId]?.status !== "done" ||
+      !outputs[agentId]?.content.trim() ||
+      typeof score !== "number" ||
+      !Number.isFinite(score) ||
+      !Number.isInteger(score) ||
+      score < 0 ||
+      score > 100 ||
+      (conclusion !== "优先推荐" &&
+        conclusion !== "建议采用" &&
+        conclusion !== "保留备选")
+    ) {
+      // Reject the entire structured result instead of inventing defaults or
+      // allowing duplicate rows to be selected twice downstream.
+      return [];
+    }
+    seen.add(agentId);
+    evaluations.push({
+      agentId,
+      score,
+      conclusion,
+      comment: stringValue(row.comment) || "请结合完整评判正文审阅。",
+      strengths: stringList(row.strengths),
+      risks: stringList(row.risks),
+    });
+  }
+
+  if (allowed && [...allowed].some((agentId) => !seen.has(agentId))) return [];
+
+  return evaluations.sort((a, b) => b.score - a.score);
+}
+
+export function buildIntentBrief(
+  turns: IntentTurn[],
+  currentDraft: StrategyTaskDraft,
+  angles: StrategyAngle[] = STRATEGY_ANGLES,
+): string {
+  const conversation = turns
+    .filter(
+      (turn) =>
+        turn.content.trim() ||
+        turn.clarification?.question.trim() ||
+        turn.clarificationAnswer?.trim(),
+    )
+    .map((turn) => {
+      const lines: string[] = [];
+      if (turn.content.trim()) {
+        lines.push(
+          `${turn.role === "user" ? "用户" : "意图助手"}：${turn.content}`,
+        );
+      }
+      if (turn.clarification) {
+        const optionText = turn.clarification.options
+          .map((option) => option.label)
+          .filter(Boolean)
+          .join(" / ");
+        lines.push(
+          `意图助手澄清：${turn.clarification.question}${
+            optionText ? `（可选：${optionText}）` : ""
+          }`,
+        );
+      }
+      if (turn.clarificationAnswer?.trim()) {
+        lines.push(`用户对该澄清的确认：${turn.clarificationAnswer}`);
+      }
+      return lines.join("\n");
+    })
+    .join("\n\n");
+  const availableAngles = angles
+    .filter((angle) => angle.enabled !== false)
+    .map((angle) => `- ${angle.id}：${angle.name}（${angle.description}）`)
+    .join("\n");
+  const exampleAngleIds = angles
+    .filter((angle) => angle.enabled !== false)
+    .slice(0, 3)
+    .map((angle) => angle.id);
+  return `你负责意图理解与任务定义。基于以下对话整理任务。不要虚构实时事实。\n\n当前草稿（可据新信息修订）：\n${JSON.stringify(currentDraft, null, 2)}\n\n本系统当前可选角度（只能从下列 id 中选择）：\n${availableAngles}\n\n对话：\n${conversation}\n\n请严格二选一执行：\n1. 如果不同答案会显著改变任务方向，立即调用 ask_clarification，只提一个最关键问题并提供清晰互斥选项；调用后停止，不输出任务 JSON，也不要在普通正文里假装提问。\n2. 如果信息已足够（包括用户刚回答了澄清），先用简洁自然语言复述整理结果，再在回复末尾追加以下可机器读取代码块，字段名不得改变：\n\`\`\`strategy-task-json\n{"name":"任务名称","detail":"任务详情","objective":"目标","prerequisites":"前置条件","constraints":"约束与边界","deliverables":"交付物","acceptanceCriteria":"验收标准","horizon":"时间范围","selectedAngleIds":${JSON.stringify(exampleAngleIds)}}\n\`\`\`\n只选择与任务有关的角度。`;
+}
+
+export function buildStrategyBrief(
+  task: StrategyTaskDraft,
+  selectedAngles = STRATEGY_ANGLES.filter((angle) =>
+    task.selectedAngleIds.includes(angle.id),
+  ),
+): string {
+  const angles = selectedAngles
+    .map((angle) => `- ${angle.name}：${angle.description}`)
+    .join("\n");
+  return `你是其中一个专业角度的策略生成智能体，只从自己的职责角度输出一套可独立审阅的策略。\n\n任务详情：\n${JSON.stringify(task, null, 2)}\n\n本轮并行角度：\n${angles}\n\n请给出：核心判断、3—6项策略动作、实施阶段、触发/退出条件、指标、主要风险与协同依赖。避免空泛口号；涉及动态事实时说明需复核。工具失败、文件路径、权限问题和检索计划属于执行过程，不得混入策略正文；确有信息缺口时只在独立的“数据限制与待核验”小节简要列明。对于地缘政治议题，坚持中立、降级避险、民生优先，不输出军事战术、目标选择、武器运用或规避监管建议。`;
+}
+
+export function buildJudgeBrief(
+  task: StrategyTaskDraft,
+  outputs: Record<string, AgentOutputState>,
+  angles: StrategyAngle[] = STRATEGY_ANGLES,
+): string {
+  const selectedAgentIds = selectedStrategyAgentIds(task, angles);
+  const strategies = angles.filter(
+    (angle) =>
+      selectedAgentIds.has(angle.agentId) &&
+      outputs[angle.agentId]?.status === "done" &&
+      outputs[angle.agentId]?.content.trim(),
+  )
+    .map(
+      (angle) =>
+        `## ${angle.name}\nagentId: ${angle.agentId}\n${outputs[angle.agentId].content}`,
+    )
+    .join("\n\n");
+  return `你是独立策略评判智能体。请依据任务目标，对候选策略的目标贡献、可执行性、风险可控性、协同性和合规性进行比较。先输出总体评判与冲突提醒，再在末尾输出结构化量表。工具失败、文件路径、权限问题和检索计划属于执行过程，不得写进评判正文；确有信息缺口时只在独立的“数据限制与待核验”小节简要列明。\n\n任务：\n${JSON.stringify(task, null, 2)}\n\n候选策略：\n${strategies}\n\n末尾必须追加：\n\`\`\`strategy-evaluation-json\n{"evaluations":[{"agentId":"候选agentId","score":0,"conclusion":"优先推荐|建议采用|保留备选","comment":"一句评价","strengths":["优势"],"risks":["风险"]}]}\n\`\`\`\n必须覆盖每个候选策略，score为0—100整数。`;
+}
+
+export function buildSynthesisBrief(
+  task: StrategyTaskDraft,
+  selectedAgentIds: string[],
+  outputs: Record<string, AgentOutputState>,
+  evaluations: StrategyEvaluation[],
+  angles: StrategyAngle[] = STRATEGY_ANGLES,
+): string {
+  const evaluationMap = new Map(evaluations.map((item) => [item.agentId, item]));
+  const uniqueSelectedAgentIds = [...new Set(selectedAgentIds)];
+  const selectedAngles = uniqueSelectedAgentIds
+    .map((agentId) => angles.find((item) => item.agentId === agentId))
+    .filter((angle): angle is StrategyAngle => Boolean(angle));
+  const selectedAngleIds = new Set(selectedAngles.map((angle) => angle.agentId));
+  const exactTask = {
+    ...task,
+    selectedAngleIds: selectedAngles.map((angle) => angle.id),
+  };
+  const selections = uniqueSelectedAgentIds
+    .filter((agentId) => selectedAngleIds.has(agentId))
+    .map((agentId) => {
+      const angle = angles.find((item) => item.agentId === agentId);
+      const evaluation = evaluationMap.get(agentId);
+      return `## ${angle?.name ?? agentId}\n评判：${evaluation ? `${evaluation.score}分，${evaluation.comment}` : "用户手动选入"}\n${outputs[agentId]?.content ?? ""}`;
+    })
+    .join("\n\n");
+  const selectedNames = selectedAngles.map((angle) => angle.name).join("、");
+  return `你是方案整理智能体。请将用户选中的策略消除重复、处理冲突、明确优先级和依赖关系，整理为一份可直接下载的完整 Markdown 方案。\n\n任务（selectedAngleIds 已收敛为用户最终选入的策略角度）：\n${JSON.stringify(exactTask, null, 2)}\n\n本次最终只允许整合以下 ${selectedAngles.length} 项：${selectedNames}\n不得补写、复活或暗中纳入任何未列出的角度或策略。\n\n入选策略：\n${selections}\n\n只输出最终 Markdown 正文。工具失败、文件路径、权限问题和检索计划属于执行过程，不得混入方案正文；确有信息缺口时仅归入“待核验信息”小节。至少包含：执行摘要、目标与原则、综合策略、阶段路线图、责任与协同、指标与预警、风险及止损机制、待核验信息。不要输出代码围栏。对于地缘政治议题坚持中立、降级避险、民生优先，禁止军事战术和伤害性操作建议。`;
+}
+
+export function parseSseChunk(
+  buffer: string,
+  flush = false,
+): { events: ParallelAgentEvent[]; rest: string } {
+  const normalized = buffer.replace(/\r\n/g, "\n");
+  const parts = normalized.split("\n\n");
+  const rest = flush ? "" : (parts.pop() ?? "");
+  const complete = flush ? parts.concat(parts.length ? [] : [normalized]) : parts;
+  const events: ParallelAgentEvent[] = [];
+  for (const frame of complete) {
+    const payload = frame
+      .split("\n")
+      .filter((line) => line.startsWith("data:"))
+      .map((line) => line.slice(5).trimStart())
+      .join("\n")
+      .trim();
+    if (!payload || payload === "[DONE]") continue;
+    try {
+      const event = JSON.parse(payload) as ParallelAgentEvent;
+      if (event && typeof event.type === "string") events.push(event);
+    } catch {
+      // Ignore one malformed frame instead of discarding the rest of a stream.
+    }
+  }
+  return { events, rest };
+}
+
+export function downloadMarkdown(markdown: string, fileName: string): void {
+  const cleanName =
+    fileName.replace(/\.(md|markdown)$/i, "").replace(/[<>:"/\\|?*\x00-\x1f]/g, "_").trim() ||
+    "strategy-plan";
+  const blob = new Blob([markdown], { type: "text/markdown;charset=utf-8" });
+  const url = URL.createObjectURL(blob);
+  const anchor = document.createElement("a");
+  anchor.href = url;
+  anchor.download = `${cleanName}.md`;
+  document.body.appendChild(anchor);
+  anchor.click();
+  anchor.remove();
+  window.setTimeout(() => URL.revokeObjectURL(url), 10_000);
+}

frontend-web/src/strategy-selection/project-routes.test.ts

@@ -0,0 +1,29 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import {
+  strategyProjectListPath,
+  strategyProjectWorkbenchPath,
+} from "./project-routes";
+
+test("solution list paths work in both application shells", () => {
+  assert.equal(
+    strategyProjectListPath("/page/strategy/qa/projects", "solution"),
+    "/page/strategy/qa/projects?type=solution",
+  );
+  assert.equal(
+    strategyProjectListPath("/official/workspace/projects/", "solution"),
+    "/official/workspace/projects?type=solution",
+  );
+});
+
+test("solution workbench paths encode ids and request the solution module", () => {
+  assert.equal(
+    strategyProjectWorkbenchPath(
+      "/official/workspace/projects",
+      "strategy-selection-a/b",
+      "solution",
+    ),
+    "/official/workspace/projects/strategy-selection-a%2Fb?module=solution",
+  );
+});

frontend-web/src/strategy-selection/project-routes.ts

@@ -0,0 +1,28 @@
+export type StrategyProjectListCategory =
+  | "all"
+  | "qa"
+  | "strategy"
+  | "solution";
+
+function normalizeBasePath(basePath: string): string {
+  return basePath.replace(/\/+$/, "");
+}
+
+export function strategyProjectListPath(
+  basePath: string,
+  category: StrategyProjectListCategory = "all",
+): string {
+  const path = normalizeBasePath(basePath);
+  return category === "all"
+    ? path
+    : `${path}?type=${encodeURIComponent(category)}`;
+}
+
+export function strategyProjectWorkbenchPath(
+  basePath: string,
+  projectId: string,
+  module?: "solution",
+): string {
+  const path = `${normalizeBasePath(basePath)}/${encodeURIComponent(projectId)}`;
+  return module === "solution" ? `${path}?module=solution` : path;
+}

frontend-web/src/strategy-selection/project-wal.test.ts

@@ -0,0 +1,147 @@
+/**
+ * Run from frontend-web:
+ *   npx esbuild src/strategy-selection/project-wal.test.ts --bundle --format=esm --platform=node --outfile=.runtime/unit-tests/project-wal.test.mjs
+ *   node --test .runtime/unit-tests/project-wal.test.mjs
+ */
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import type { StrategyProjectSnapshot } from "./projects";
+import {
+  clearStrategyProjectWal,
+  isStrategyProjectWalExpired,
+  LatestByKeyScheduler,
+  resolveStrategyProjectWal,
+  strategyProjectSnapshotHash,
+  strategyProjectWalKey,
+  writeStrategyProjectWal,
+} from "./project-wal";
+
+const createSnapshot = (): StrategyProjectSnapshot => ({
+  version: 1,
+  angleCatalog: [],
+  stage: "intent",
+  taskDraft: {
+    name: "",
+    detail: "",
+    objective: "",
+    prerequisites: "",
+    constraints: "",
+    deliverables: "",
+    acceptanceCriteria: "",
+    horizon: "",
+    selectedAngleIds: [],
+  },
+  turns: [],
+  outputs: {},
+  judgeStatus: "idle",
+  judgeContent: "",
+  evaluations: [],
+  selectedStrategyIds: [],
+  synthesis: "",
+  synthesisStatus: "idle",
+  solutionSavedAt: null,
+  isDemo: false,
+  workflowStale: false,
+});
+
+test("WAL keys isolate accounts and projects", () => {
+  assert.notEqual(
+    strategyProjectWalKey("account:one", "project-a"),
+    strategyProjectWalKey("account:two", "project-a"),
+  );
+  assert.notEqual(
+    strategyProjectWalKey("account:one", "project-a"),
+    strategyProjectWalKey("account:one", "project-b"),
+  );
+});
+
+test("snapshot hashes are stable and change with project content", async () => {
+  const snapshot = createSnapshot();
+  const same = createSnapshot();
+  const changed = {
+    ...createSnapshot(),
+    taskDraft: {
+      ...createSnapshot().taskDraft,
+      name: "已修改任务",
+    },
+  };
+  assert.equal(
+    await strategyProjectSnapshotHash(snapshot),
+    await strategyProjectSnapshotHash(same),
+  );
+  assert.notEqual(
+    await strategyProjectSnapshotHash(snapshot),
+    await strategyProjectSnapshotHash(changed),
+  );
+});
+
+test("WAL degrades safely when IndexedDB is unavailable", async () => {
+  const snapshot = createSnapshot();
+  assert.equal(
+    await writeStrategyProjectWal(
+      "account:test",
+      "project-test",
+      "base-hash",
+      snapshot,
+    ),
+    null,
+  );
+  assert.equal(
+    await clearStrategyProjectWal("account:test", "project-test", snapshot),
+    false,
+  );
+});
+
+test("WAL recovery uses ancestry hashes instead of incomparable clocks", async () => {
+  const server = createSnapshot();
+  const local = {
+    ...createSnapshot(),
+    taskDraft: { ...createSnapshot().taskDraft, name: "本地编辑" },
+  };
+  const otherServer = {
+    ...createSnapshot(),
+    taskDraft: { ...createSnapshot().taskDraft, name: "服务器编辑" },
+  };
+  const serverHash = await strategyProjectSnapshotHash(server);
+  const localHash = await strategyProjectSnapshotHash(local);
+  const otherServerHash = await strategyProjectSnapshotHash(otherServer);
+  const wal = { baseServerHash: serverHash, snapshotHash: localHash };
+
+  assert.equal(resolveStrategyProjectWal(wal, serverHash), "recover");
+  assert.equal(resolveStrategyProjectWal(wal, localHash), "same");
+  assert.equal(resolveStrategyProjectWal(wal, otherServerHash), "conflict");
+});
+
+test("latest-by-key scheduler bounds queued streaming snapshots", async () => {
+  let releaseFirst!: () => void;
+  const firstBlocked = new Promise<void>((resolve) => {
+    releaseFirst = resolve;
+  });
+  const calls: number[] = [];
+  const scheduler = new LatestByKeyScheduler<number, number>(async (value) => {
+    calls.push(value);
+    if (value === 1) await firstBlocked;
+    return value;
+  });
+
+  const first = scheduler.schedule("project", 1);
+  await Promise.resolve();
+  const superseded = scheduler.schedule("project", 2);
+  const latest = scheduler.schedule("project", 3);
+  assert.equal(await superseded, null);
+  releaseFirst();
+
+  assert.equal(await first, 1);
+  assert.equal(await latest, 3);
+  assert.deepEqual(calls, [1, 3]);
+  await scheduler.waitForIdle("project");
+});
+
+test("WAL expiry is deterministic at the retention boundary", () => {
+  const now = Date.now();
+  const sixDaysAgo = now - 6 * 24 * 60 * 60 * 1000;
+  const eightDaysAgo = now - 8 * 24 * 60 * 60 * 1000;
+  assert.equal(isStrategyProjectWalExpired(sixDaysAgo, now), false);
+  assert.equal(isStrategyProjectWalExpired(eightDaysAgo, now), true);
+});

frontend-web/src/strategy-selection/project-wal.ts

@@ -0,0 +1,362 @@
+import type { StrategyProjectSnapshot } from "./projects";
+
+const DATABASE_NAME = "deerflow-strategy-project-wal";
+const STORE_NAME = "drafts";
+const DATABASE_VERSION = 1;
+const WAL_TTL_MS = 7 * 24 * 60 * 60 * 1000;
+
+export interface StrategyProjectWalRecord {
+  key: string;
+  userKey: string;
+  projectId: string;
+  /** Server snapshot on top of which this local edit was made. */
+  baseServerHash: string;
+  snapshotHash: string;
+  snapshot: StrategyProjectSnapshot;
+  updatedAt: number;
+}
+
+interface PendingJob<Input, Result> {
+  input: Input;
+  resolve: (result: Result | null) => void;
+  reject: (reason: unknown) => void;
+}
+
+interface KeyQueueState<Input, Result> {
+  running: boolean;
+  pending?: PendingJob<Input, Result>;
+  idleWaiters: Array<() => void>;
+}
+
+/** Keep at most one active and one latest pending operation per key. */
+export class LatestByKeyScheduler<Input, Result> {
+  private readonly states = new Map<string, KeyQueueState<Input, Result>>();
+
+  public constructor(
+    private readonly worker: (input: Input) => Promise<Result>,
+  ) {}
+
+  public schedule(key: string, input: Input): Promise<Result | null> {
+    let state = this.states.get(key);
+    if (!state) {
+      state = { running: false, idleWaiters: [] };
+      this.states.set(key, state);
+    }
+    return new Promise<Result | null>((resolve, reject) => {
+      // The superseded value has not started hashing or IndexedDB work. Resolve
+      // it now so its growing snapshot closure can be released immediately.
+      state!.pending?.resolve(null);
+      state!.pending = { input, resolve, reject };
+      void this.pump(key, state!);
+    });
+  }
+
+  public waitForIdle(key: string): Promise<void> {
+    const state = this.states.get(key);
+    if (!state || (!state.running && !state.pending)) return Promise.resolve();
+    return new Promise((resolve) => state.idleWaiters.push(resolve));
+  }
+
+  private async pump(
+    key: string,
+    state: KeyQueueState<Input, Result>,
+  ): Promise<void> {
+    if (state.running) return;
+    const job = state.pending;
+    if (!job) {
+      this.finishKey(key, state);
+      return;
+    }
+    state.pending = undefined;
+    state.running = true;
+    try {
+      job.resolve(await this.worker(job.input));
+    } catch (reason) {
+      job.reject(reason);
+    } finally {
+      state.running = false;
+      if (state.pending) {
+        void this.pump(key, state);
+      } else {
+        this.finishKey(key, state);
+      }
+    }
+  }
+
+  private finishKey(
+    key: string,
+    state: KeyQueueState<Input, Result>,
+  ): void {
+    this.states.delete(key);
+    state.idleWaiters.splice(0).forEach((resolve) => resolve());
+  }
+}
+
+export function strategyProjectWalKey(
+  userKey: string,
+  projectId: string,
+): string {
+  return `${encodeURIComponent(userKey)}::${encodeURIComponent(projectId)}`;
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+
+function isUsableSnapshot(value: unknown): value is StrategyProjectSnapshot {
+  if (!isRecord(value) || value.version !== 1) return false;
+  if (value.stage !== "intent" && value.stage !== "workspace") return false;
+  if (!isRecord(value.taskDraft) || !Array.isArray(value.taskDraft.selectedAngleIds)) {
+    return false;
+  }
+  return (
+    Array.isArray(value.angleCatalog) &&
+    Array.isArray(value.turns) &&
+    isRecord(value.outputs) &&
+    Array.isArray(value.evaluations) &&
+    Array.isArray(value.selectedStrategyIds) &&
+    typeof value.synthesis === "string"
+  );
+}
+
+function fallbackHash(text: string): string {
+  let first = 0x811c9dc5;
+  let second = 0x9e3779b9;
+  for (let index = 0; index < text.length; index += 1) {
+    const code = text.charCodeAt(index);
+    first = Math.imul(first ^ code, 0x01000193);
+    second = Math.imul(second ^ code, 0x85ebca6b);
+  }
+  return `${(first >>> 0).toString(16).padStart(8, "0")}${(second >>> 0)
+    .toString(16)
+    .padStart(8, "0")}`;
+}
+
+export async function strategyProjectSnapshotHash(
+  snapshot: StrategyProjectSnapshot,
+): Promise<string> {
+  const serialized = JSON.stringify(snapshot);
+  if (globalThis.crypto?.subtle) {
+    const digest = await globalThis.crypto.subtle.digest(
+      "SHA-256",
+      new TextEncoder().encode(serialized),
+    );
+    return Array.from(new Uint8Array(digest), (byte) =>
+      byte.toString(16).padStart(2, "0"),
+    ).join("");
+  }
+  return fallbackHash(serialized);
+}
+
+export function isStrategyProjectWalExpired(
+  updatedAt: number,
+  now = Date.now(),
+): boolean {
+  return now - updatedAt > WAL_TTL_MS;
+}
+
+export function resolveStrategyProjectWal(
+  wal: Pick<StrategyProjectWalRecord, "baseServerHash" | "snapshotHash">,
+  serverHash: string,
+): "same" | "recover" | "conflict" {
+  if (wal.snapshotHash === serverHash) return "same";
+  if (wal.baseServerHash === serverHash) return "recover";
+  return "conflict";
+}
+
+function openDatabase(): Promise<IDBDatabase | null> {
+  if (typeof indexedDB === "undefined") return Promise.resolve(null);
+  return new Promise((resolve, reject) => {
+    const request = indexedDB.open(DATABASE_NAME, DATABASE_VERSION);
+    request.onupgradeneeded = () => {
+      const database = request.result;
+      if (!database.objectStoreNames.contains(STORE_NAME)) {
+        database.createObjectStore(STORE_NAME, { keyPath: "key" });
+      }
+    };
+    request.onsuccess = () => resolve(request.result);
+    request.onerror = () => reject(request.error ?? new Error("无法打开项目恢复存储"));
+    request.onblocked = () => reject(new Error("项目恢复存储正在升级，请关闭其他页面后重试"));
+  });
+}
+
+function waitForTransaction(transaction: IDBTransaction): Promise<void> {
+  return new Promise((resolve, reject) => {
+    transaction.oncomplete = () => resolve();
+    transaction.onerror = () =>
+      reject(transaction.error ?? new Error("项目恢复存储事务失败"));
+    transaction.onabort = () =>
+      reject(transaction.error ?? new Error("项目恢复存储事务已中止"));
+  });
+}
+
+function readRequest(request: IDBRequest): Promise<unknown> {
+  return new Promise((resolve, reject) => {
+    request.onsuccess = () => resolve(request.result);
+    request.onerror = () => reject(request.error ?? new Error("无法读取项目恢复记录"));
+  });
+}
+
+async function writeWalRecord(
+  record: StrategyProjectWalRecord,
+): Promise<StrategyProjectWalRecord | null> {
+  const database = await openDatabase();
+  if (!database) return null;
+  try {
+    const transaction = database.transaction(STORE_NAME, "readwrite");
+    const transactionDone = waitForTransaction(transaction);
+    const store = transaction.objectStore(STORE_NAME);
+    // Queue the mutation from inside IDB's success callback.  Awaiting the GET
+    // and only then issuing PUT is racy in Safari because the transaction may
+    // become inactive between promise turns.
+    const outcome = new Promise<StrategyProjectWalRecord>((resolve, reject) => {
+      const request = store.get(record.key);
+      request.onerror = () =>
+        reject(request.error ?? new Error("无法读取项目恢复记录"));
+      request.onsuccess = () => {
+        try {
+          const existing = request.result;
+          if (
+            !isRecord(existing) ||
+            typeof existing.updatedAt !== "number" ||
+            existing.updatedAt <= record.updatedAt
+          ) {
+            store.put(record);
+            resolve(record);
+            return;
+          }
+          resolve(existing as unknown as StrategyProjectWalRecord);
+        } catch (reason) {
+          reject(reason);
+        }
+      };
+    });
+    const [result] = await Promise.all([outcome, transactionDone]);
+    return result;
+  } finally {
+    database.close();
+  }
+}
+
+interface WalWriteInput {
+  userKey: string;
+  projectId: string;
+  baseServerHash: string;
+  snapshot: StrategyProjectSnapshot;
+  updatedAt: number;
+}
+
+const writeScheduler = new LatestByKeyScheduler<
+  WalWriteInput,
+  StrategyProjectWalRecord | null
+>(async ({ userKey, projectId, baseServerHash, snapshot, updatedAt }) => {
+  const record: StrategyProjectWalRecord = {
+    key: strategyProjectWalKey(userKey, projectId),
+    userKey,
+    projectId,
+    baseServerHash,
+    snapshotHash: await strategyProjectSnapshotHash(snapshot),
+    snapshot,
+    updatedAt,
+  };
+  return writeWalRecord(record);
+});
+
+export function writeStrategyProjectWal(
+  userKey: string,
+  projectId: string,
+  baseServerHash: string,
+  snapshot: StrategyProjectSnapshot,
+): Promise<StrategyProjectWalRecord | null> {
+  const key = strategyProjectWalKey(userKey, projectId);
+  return writeScheduler.schedule(key, {
+    userKey,
+    projectId,
+    baseServerHash,
+    snapshot,
+    updatedAt: Date.now(),
+  });
+}
+
+export async function readStrategyProjectWal(
+  userKey: string,
+  projectId: string,
+): Promise<StrategyProjectWalRecord | null> {
+  const key = strategyProjectWalKey(userKey, projectId);
+  await writeScheduler.waitForIdle(key);
+  const database = await openDatabase();
+  if (!database) return null;
+  try {
+    const transaction = database.transaction(STORE_NAME, "readonly");
+    const transactionDone = waitForTransaction(transaction);
+    const [record] = await Promise.all([
+      readRequest(transaction.objectStore(STORE_NAME).get(key)),
+      transactionDone,
+    ]);
+    if (!isRecord(record) || !isUsableSnapshot(record.snapshot)) return null;
+    if (
+      record.userKey !== userKey ||
+      record.projectId !== projectId ||
+      typeof record.baseServerHash !== "string" ||
+      typeof record.snapshotHash !== "string" ||
+      typeof record.updatedAt !== "number"
+    ) {
+      return null;
+    }
+    const typed = record as unknown as StrategyProjectWalRecord;
+    if (isStrategyProjectWalExpired(typed.updatedAt)) {
+      void clearStrategyProjectWal(userKey, projectId, typed.snapshot).catch(
+        () => undefined,
+      );
+      return null;
+    }
+    return typed;
+  } finally {
+    database.close();
+  }
+}
+
+export async function clearStrategyProjectWal(
+  userKey: string,
+  projectId: string,
+  expectedSnapshot?: StrategyProjectSnapshot,
+): Promise<boolean> {
+  const key = strategyProjectWalKey(userKey, projectId);
+  const expectedHash = expectedSnapshot
+    ? await strategyProjectSnapshotHash(expectedSnapshot)
+    : null;
+  await writeScheduler.waitForIdle(key);
+  const database = await openDatabase();
+  if (!database) return false;
+  try {
+    const transaction = database.transaction(STORE_NAME, "readwrite");
+    const transactionDone = waitForTransaction(transaction);
+    const store = transaction.objectStore(STORE_NAME);
+    if (!expectedSnapshot) {
+      store.delete(key);
+      await transactionDone;
+      return true;
+    }
+
+    const deletedPromise = new Promise<boolean>((resolve, reject) => {
+      const request = store.get(key);
+      request.onerror = () =>
+        reject(request.error ?? new Error("无法读取项目恢复记录"));
+      request.onsuccess = () => {
+        try {
+          const existing = request.result;
+          const matches =
+            isRecord(existing) && existing.snapshotHash === expectedHash;
+          if (matches) store.delete(key);
+          resolve(matches);
+        } catch (reason) {
+          reject(reason);
+        }
+      };
+    });
+    const [deleted] = await Promise.all([deletedPromise, transactionDone]);
+    return deleted;
+  } finally {
+    database.close();
+  }
+}

frontend-web/src/strategy-selection/projects.ts

@@ -0,0 +1,469 @@
+import { apiFetch } from "@/core/api/fetch-client";
+import { getAccountIdentityKey } from "@/core/auth";
+import { getBackendBaseURL } from "@/core/config";
+import { createClientId } from "@/lib/client-id";
+
+import {
+  EMPTY_TASK_DRAFT,
+  INITIAL_INTENT_TURNS,
+  STRATEGY_ANGLES,
+  TAIWAN_STRAIT_DEMO_EVALUATIONS,
+  TAIWAN_STRAIT_DEMO_OUTPUTS,
+  TAIWAN_STRAIT_DEMO_SYNTHESIS,
+  TAIWAN_STRAIT_DEMO_TASK,
+  TAIWAN_STRAIT_DEMO_TURNS,
+} from "./constants";
+import type {
+  AgentOutputState,
+  IntentTurn,
+  StrategyAngle,
+  StrategyEvaluation,
+  StrategyStage,
+  StrategyTaskDraft,
+} from "./types";
+import { clearStrategyProjectWal } from "./project-wal";
+
+export const STRATEGY_PROJECT_ID_PREFIX = "strategy-selection-";
+const SNAPSHOT_KIND = "strategy-selection-project";
+
+// A strategy project can be mounted twice briefly during route transitions or
+// opened in more than one tab.  Serialize saves in this JS realm and, where
+// supported, across same-browser tabs so an older PUT cannot finish after and
+// overwrite a newer snapshot.
+const projectSaveQueues = new Map<string, Promise<void>>();
+
+async function withBrowserProjectLock<T>(
+  key: string,
+  operation: () => Promise<T>,
+): Promise<T> {
+  if (typeof navigator !== "undefined" && navigator.locks) {
+    return navigator.locks.request(`deerflow-strategy-save:${key}`, operation);
+  }
+  return operation();
+}
+
+function serializeProjectSave<T>(
+  key: string,
+  operation: () => Promise<T>,
+): Promise<T> {
+  const previous = projectSaveQueues.get(key) ?? Promise.resolve();
+  const request = previous
+    .catch(() => undefined)
+    .then(() => withBrowserProjectLock(key, operation));
+  const tail = request.then(
+    () => undefined,
+    () => undefined,
+  );
+  projectSaveQueues.set(key, tail);
+  void tail.then(() => {
+    if (projectSaveQueues.get(key) === tail) projectSaveQueues.delete(key);
+  });
+  return request;
+}
+
+const DEMO_JUDGE_CONTENT = `### 评判结论
+
+六个角度均与任务目标相关，其中治理统筹、安全风险和外交沟通直接作用于“减少误判与阻断升级”，应优先纳入；法律规则是高压情境下的必要边界。经济韧性和社会民生策略建议与主策略合并实施，避免形成两套割裂的连续性机制。
+
+**组合提醒：** 对外沟通节奏、市场稳定措施和风险等级调整必须使用同一事实基线；任何高风险政策动作均需设置冷静期、法律复核与退出条件。`;
+
+export interface StrategyProjectSnapshot {
+  version: 1;
+  /** Copy of the angle catalog used by this project, for historical rendering. */
+  angleCatalog: StrategyAngle[];
+  stage: StrategyStage;
+  taskDraft: StrategyTaskDraft;
+  turns: IntentTurn[];
+  outputs: Record<string, AgentOutputState>;
+  judgeStatus: AgentOutputState["status"];
+  judgeContent: string;
+  evaluations: StrategyEvaluation[];
+  selectedStrategyIds: string[];
+  synthesis: string;
+  synthesisStatus: AgentOutputState["status"];
+  solutionSavedAt: string | null;
+  isDemo: boolean;
+  workflowStale: boolean;
+}
+
+export interface StrategyProjectSummary {
+  id: string;
+  title: string;
+  brief: string;
+  createdAt: string | null;
+  updatedAt: string | null;
+  stage: StrategyStage;
+  questionCount: number;
+  angleCount: number;
+  completedStrategyCount: number;
+  hasEvaluation: boolean;
+  hasSolution: boolean;
+  isDemo: boolean;
+  workflowStale: boolean;
+}
+
+export interface StrategyProject extends StrategyProjectSummary {
+  snapshot: StrategyProjectSnapshot;
+}
+
+export class StrategyProjectConflictError extends Error {
+  public constructor(message: string) {
+    super(message);
+    this.name = "StrategyProjectConflictError";
+  }
+}
+
+interface ParallelTaskResponse {
+  id: string;
+  title?: string;
+  brief?: string | null;
+  agents?: Array<{ agent_id: string; name?: string; avatarType?: string | null }>;
+  messages?: Array<Record<string, unknown>> | null;
+  created_at?: string | null;
+  updated_at?: string | null;
+}
+
+interface ParallelTaskListResponse {
+  tasks?: ParallelTaskResponse[];
+}
+
+interface SnapshotEnvelope extends Record<string, unknown> {
+  kind: typeof SNAPSHOT_KIND;
+  version: 1;
+  snapshot: StrategyProjectSnapshot;
+}
+
+const cloneTask = (task: StrategyTaskDraft): StrategyTaskDraft => ({
+  ...task,
+  selectedAngleIds: [...task.selectedAngleIds],
+});
+
+const cloneAngles = (angles: StrategyAngle[]): StrategyAngle[] =>
+  angles.map((angle) => ({ ...angle }));
+
+const cloneTurns = (turns: IntentTurn[]): IntentTurn[] =>
+  turns.map((turn) => ({ ...turn, streaming: false }));
+
+const cloneOutputs = (
+  outputs: Record<string, AgentOutputState>,
+): Record<string, AgentOutputState> =>
+  Object.fromEntries(
+    Object.entries(outputs).map(([id, output]) => [
+      id,
+      { ...output, steps: [...(output.steps ?? [])] },
+    ]),
+  );
+
+const cloneEvaluations = (evaluations: StrategyEvaluation[]) =>
+  evaluations.map((item) => ({
+    ...item,
+    strengths: [...item.strengths],
+    risks: [...item.risks],
+  }));
+
+export function createEmptyStrategySnapshot(
+  angleCatalog: StrategyAngle[] = STRATEGY_ANGLES,
+): StrategyProjectSnapshot {
+  const enabledAngles = angleCatalog.filter((angle) => angle.enabled !== false);
+  return {
+    version: 1,
+    angleCatalog: cloneAngles(enabledAngles),
+    stage: "intent",
+    taskDraft: {
+      ...cloneTask(EMPTY_TASK_DRAFT),
+      selectedAngleIds: enabledAngles.slice(0, 4).map((angle) => angle.id),
+    },
+    turns: cloneTurns(INITIAL_INTENT_TURNS),
+    outputs: {},
+    judgeStatus: "idle",
+    judgeContent: "",
+    evaluations: [],
+    selectedStrategyIds: [],
+    synthesis: "",
+    synthesisStatus: "idle",
+    solutionSavedAt: null,
+    isDemo: false,
+    workflowStale: false,
+  };
+}
+
+export function canCreateTaiwanDemo(
+  angleCatalog: StrategyAngle[],
+): boolean {
+  const enabledAgentIds = new Set(
+    angleCatalog
+      .filter((angle) => angle.enabled !== false)
+      .map((angle) => angle.agentId),
+  );
+  return STRATEGY_ANGLES.every((angle) => enabledAgentIds.has(angle.agentId));
+}
+
+export function createDemoStrategySnapshot(
+  angleCatalog: StrategyAngle[] = STRATEGY_ANGLES,
+): StrategyProjectSnapshot {
+  if (!canCreateTaiwanDemo(angleCatalog)) {
+    throw new Error("台海示例所需的六个默认角度未全部启用，请先由管理员恢复配置");
+  }
+  const enabledAgentIds = new Set(
+    angleCatalog
+      .filter((angle) => angle.enabled !== false)
+      .map((angle) => angle.agentId),
+  );
+  const defaultDemoAgentIds = new Set(
+    STRATEGY_ANGLES.map((angle) => angle.agentId),
+  );
+  const demoAngles = angleCatalog.filter(
+    (angle) =>
+      angle.enabled !== false &&
+      enabledAgentIds.has(angle.agentId) &&
+      defaultDemoAgentIds.has(angle.agentId),
+  );
+  const effectiveAngles = demoAngles;
+  const demoOutputs = Object.fromEntries(
+    Object.entries(cloneOutputs(TAIWAN_STRAIT_DEMO_OUTPUTS)).filter(([agentId]) =>
+      effectiveAngles.some((angle) => angle.agentId === agentId),
+    ),
+  );
+  const demoEvaluations = TAIWAN_STRAIT_DEMO_EVALUATIONS.filter((evaluation) =>
+    effectiveAngles.some((angle) => angle.agentId === evaluation.agentId),
+  );
+  return {
+    version: 1,
+    angleCatalog: cloneAngles(effectiveAngles),
+    stage: "workspace",
+    taskDraft: {
+      ...cloneTask(TAIWAN_STRAIT_DEMO_TASK),
+      selectedAngleIds: effectiveAngles.map((angle) => angle.id),
+    },
+    turns: cloneTurns(TAIWAN_STRAIT_DEMO_TURNS),
+    outputs: demoOutputs,
+    judgeStatus: "done",
+    judgeContent: DEMO_JUDGE_CONTENT,
+    evaluations: cloneEvaluations(demoEvaluations),
+    selectedStrategyIds: demoEvaluations.filter(
+      (item) => item.score >= 88,
+    ).map((item) => item.agentId),
+    synthesis: TAIWAN_STRAIT_DEMO_SYNTHESIS,
+    synthesisStatus: "done",
+    solutionSavedAt: null,
+    isDemo: true,
+    workflowStale: false,
+  };
+}
+
+function isObject(value: unknown): value is Record<string, unknown> {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+
+function readSnapshot(task: ParallelTaskResponse): StrategyProjectSnapshot | null {
+  const envelope = task.messages?.find(
+    (message) => message.kind === SNAPSHOT_KIND && message.version === 1,
+  );
+  if (!isObject(envelope) || !isObject(envelope.snapshot)) return null;
+  const snapshot = envelope.snapshot as unknown as StrategyProjectSnapshot;
+  if (
+    snapshot.version !== 1 ||
+    (snapshot.stage !== "intent" && snapshot.stage !== "workspace") ||
+    !isObject(snapshot.taskDraft) ||
+    !Array.isArray(snapshot.taskDraft.selectedAngleIds) ||
+    !Array.isArray(snapshot.turns) ||
+    !isObject(snapshot.outputs) ||
+    !Array.isArray(snapshot.evaluations) ||
+    !Array.isArray(snapshot.selectedStrategyIds)
+  ) {
+    return null;
+  }
+  return {
+    ...snapshot,
+    angleCatalog: cloneAngles(
+      Array.isArray(snapshot.angleCatalog) && snapshot.angleCatalog.length
+        ? snapshot.angleCatalog.filter(
+            (angle) =>
+              isObject(angle) &&
+              typeof angle.id === "string" &&
+              typeof angle.agentId === "string" &&
+              typeof angle.name === "string",
+          )
+        : STRATEGY_ANGLES,
+    ),
+    workflowStale: snapshot.workflowStale === true,
+    solutionSavedAt:
+      typeof snapshot.solutionSavedAt === "string"
+        ? snapshot.solutionSavedAt
+        : null,
+    taskDraft: cloneTask(snapshot.taskDraft),
+    turns: cloneTurns(snapshot.turns),
+    outputs: cloneOutputs(snapshot.outputs),
+    evaluations: cloneEvaluations(snapshot.evaluations),
+    selectedStrategyIds: [...snapshot.selectedStrategyIds],
+  };
+}
+
+function toProject(task: ParallelTaskResponse): StrategyProject | null {
+  const snapshot = readSnapshot(task);
+  if (!snapshot) return null;
+  const completedStrategyCount = Object.values(snapshot.outputs).filter(
+    (output) => output.status === "done" && output.content.trim(),
+  ).length;
+  return {
+    id: task.id,
+    title: snapshot.taskDraft.name.trim() || task.title?.trim() || "未命名策略项目",
+    brief: snapshot.taskDraft.detail.trim() || task.brief?.trim() || "尚未补充项目说明",
+    createdAt: task.created_at ?? null,
+    updatedAt: task.updated_at ?? null,
+    stage: snapshot.stage,
+    questionCount: snapshot.turns.filter((turn) => turn.role === "user").length,
+    angleCount: snapshot.taskDraft.selectedAngleIds.length,
+    completedStrategyCount,
+    hasEvaluation:
+      !snapshot.workflowStale &&
+      snapshot.judgeStatus === "done" &&
+      Boolean(snapshot.judgeContent.trim()),
+    hasSolution:
+      !snapshot.workflowStale &&
+      snapshot.synthesisStatus === "done" &&
+      Boolean(snapshot.synthesis.trim()),
+    isDemo: snapshot.isDemo,
+    workflowStale: snapshot.workflowStale,
+    snapshot,
+  };
+}
+
+async function readError(response: Response): Promise<string> {
+  const body = (await response.json().catch(() => null)) as
+    | { detail?: string }
+    | null;
+  return body?.detail || `请求失败（HTTP ${response.status}）`;
+}
+
+const endpoint = (suffix = "") =>
+  `${getBackendBaseURL()}/api/parallel-agent-tasks${suffix}`;
+
+async function getParallelTask(id: string): Promise<ParallelTaskResponse> {
+  const response = await apiFetch(endpoint(`/${encodeURIComponent(id)}`));
+  if (!response.ok) throw new Error(await readError(response));
+  return (await response.json()) as ParallelTaskResponse;
+}
+
+export async function listStrategyProjects(): Promise<StrategyProjectSummary[]> {
+  const response = await apiFetch(endpoint());
+  if (!response.ok) throw new Error(await readError(response));
+  const body = (await response.json()) as ParallelTaskListResponse;
+  const candidates = (body.tasks ?? []).filter((task) =>
+    task.id.startsWith(STRATEGY_PROJECT_ID_PREFIX),
+  );
+  const records = await Promise.allSettled(
+    candidates.map((task) => getParallelTask(task.id)),
+  );
+  return records
+    .flatMap((result) => {
+      if (result.status !== "fulfilled") return [];
+      const project = toProject(result.value);
+      return project ? [project] : [];
+    })
+    .sort((a, b) =>
+      String(b.updatedAt ?? "").localeCompare(String(a.updatedAt ?? "")),
+    );
+}
+
+export async function getStrategyProject(id: string): Promise<StrategyProject> {
+  if (!id.startsWith(STRATEGY_PROJECT_ID_PREFIX)) {
+    throw new Error("这不是一个策略优选项目");
+  }
+  const task = await getParallelTask(id);
+  const project = toProject(task);
+  if (!project) throw new Error("项目数据不完整，无法恢复策略工作台");
+  return project;
+}
+
+function projectAgents(snapshot: StrategyProjectSnapshot) {
+  const selected = new Set(snapshot.taskDraft.selectedAngleIds);
+  const angleAgents = snapshot.angleCatalog.filter((angle) => selected.has(angle.id)).map(
+    (angle) => ({ agent_id: angle.agentId, name: angle.name }),
+  );
+  return [
+    { agent_id: "strategy-selection-intent", name: "意图理解智能体" },
+    ...angleAgents,
+    { agent_id: "strategy-selection-judge", name: "策略评判智能体" },
+    { agent_id: "strategy-selection-solution", name: "方案整理智能体" },
+  ];
+}
+
+function snapshotEnvelope(snapshot: StrategyProjectSnapshot): SnapshotEnvelope {
+  return {
+    kind: SNAPSHOT_KIND,
+    version: 1,
+    snapshot,
+  };
+}
+
+export async function createStrategyProject(
+  snapshot: StrategyProjectSnapshot = createEmptyStrategySnapshot(),
+): Promise<StrategyProject> {
+  const id = `${STRATEGY_PROJECT_ID_PREFIX}${createClientId()}`;
+  const response = await apiFetch(endpoint(), {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      id,
+      title: snapshot.taskDraft.name.trim() || "未命名策略项目",
+      brief: snapshot.taskDraft.detail.trim() || null,
+      agents: projectAgents(snapshot),
+      messages: [snapshotEnvelope(snapshot)],
+    }),
+  });
+  if (!response.ok) throw new Error(await readError(response));
+  const project = toProject((await response.json()) as ParallelTaskResponse);
+  if (!project) throw new Error("项目已创建，但返回数据无法识别");
+  return project;
+}
+
+export async function saveStrategyProject(
+  id: string,
+  snapshot: StrategyProjectSnapshot,
+  options: {
+    expectedUpdatedAt?: string | null;
+    keepalive?: boolean;
+    signal?: AbortSignal;
+  } = {},
+): Promise<StrategyProject> {
+  const account = getAccountIdentityKey() ?? "anonymous";
+  return serializeProjectSave(`${account}:${id}`, async () => {
+    const response = await apiFetch(endpoint(`/${encodeURIComponent(id)}`), {
+      method: "PUT",
+      headers: { "Content-Type": "application/json" },
+      keepalive: options.keepalive,
+      signal: options.signal,
+      body: JSON.stringify({
+        title: snapshot.taskDraft.name.trim() || "未命名策略项目",
+        brief: snapshot.taskDraft.detail.trim() || null,
+        agents: projectAgents(snapshot),
+        messages: [snapshotEnvelope(snapshot)],
+        expected_updated_at: options.expectedUpdatedAt ?? undefined,
+      }),
+    });
+    if (!response.ok) {
+      const message = await readError(response);
+      if (response.status === 409) {
+        throw new StrategyProjectConflictError(message);
+      }
+      throw new Error(message);
+    }
+    const project = toProject((await response.json()) as ParallelTaskResponse);
+    if (!project) throw new Error("项目已保存，但返回数据无法识别");
+    return project;
+  });
+}
+
+export async function deleteStrategyProject(id: string): Promise<void> {
+  const response = await apiFetch(endpoint(`/${encodeURIComponent(id)}`), {
+    method: "DELETE",
+  });
+  if (!response.ok && response.status !== 404) {
+    throw new Error(await readError(response));
+  }
+  void clearStrategyProjectWal(
+    getAccountIdentityKey() ?? "anonymous",
+    id,
+  ).catch(() => undefined);
+}

frontend-web/src/strategy-selection/strategy-agent-mapping.ts

@@ -0,0 +1,112 @@
+import type { StrategyAngle } from "./types";
+
+export type StrategyAgentCategory =
+  | "intent"
+  | "angle"
+  | "judge"
+  | "solution";
+
+export interface StrategyAgent {
+  id: string;
+  category: StrategyAgentCategory;
+  fixed: boolean;
+  enabled: boolean;
+  sort_order: number;
+  name: string;
+  description: string;
+  model: string | null;
+  soul: string | null;
+  skills: string[] | null;
+  created_at: string | null;
+  updated_at: string | null;
+}
+
+const STRATEGY_ANGLE_PREFIX = "strategy-selection-angle-";
+
+const LEGACY_ANGLE_IDS: Record<string, string> = {
+  "strategy-selection-angle-governance": "governance",
+  "strategy-selection-angle-diplomacy": "diplomacy",
+  "strategy-selection-angle-economy": "economy",
+  "strategy-selection-angle-security": "security",
+  "strategy-selection-angle-public-opinion": "public_opinion",
+  "strategy-selection-angle-law-policy": "law_policy",
+};
+
+const LEGACY_SHORT_NAMES: Record<string, string> = {
+  "strategy-selection-angle-governance": "治理",
+  "strategy-selection-angle-diplomacy": "外交",
+  "strategy-selection-angle-economy": "经济",
+  "strategy-selection-angle-security": "安全",
+  "strategy-selection-angle-public-opinion": "民生",
+  "strategy-selection-angle-law-policy": "法律",
+};
+
+const LEGACY_ACCENTS: Record<string, string> = {
+  "strategy-selection-angle-governance": "#6d5dfc",
+  "strategy-selection-angle-diplomacy": "#0ea5e9",
+  "strategy-selection-angle-economy": "#10b981",
+  "strategy-selection-angle-security": "#f97316",
+  "strategy-selection-angle-public-opinion": "#ec4899",
+  "strategy-selection-angle-law-policy": "#a855f7",
+};
+
+const ACCENT_PALETTE = [
+  "#2563eb",
+  "#0891b2",
+  "#059669",
+  "#ca8a04",
+  "#ea580c",
+  "#dc2626",
+  "#db2777",
+  "#7c3aed",
+] as const;
+
+function stableAccent(id: string) {
+  if (LEGACY_ACCENTS[id]) return LEGACY_ACCENTS[id];
+  let hash = 2166136261;
+  for (let index = 0; index < id.length; index += 1) {
+    hash ^= id.charCodeAt(index);
+    hash = Math.imul(hash, 16777619);
+  }
+  return ACCENT_PALETTE[(hash >>> 0) % ACCENT_PALETTE.length];
+}
+
+function displayAngleName(name: string) {
+  const cleaned = name
+    .trim()
+    .replace(/^策略(?:分析)?视角[·•:：\s-]*/, "")
+    .replace(/(?:分析)?智能体$/, "")
+    .trim();
+  return cleaned || name.trim() || "未命名视角";
+}
+
+/** Map the public API shape to the workbench's stable angle representation. */
+export function strategyAgentToAngle(
+  agent: StrategyAgent,
+): StrategyAngle | null {
+  if (agent.category !== "angle") return null;
+  const suffix = agent.id.startsWith(STRATEGY_ANGLE_PREFIX)
+    ? agent.id.slice(STRATEGY_ANGLE_PREFIX.length)
+    : agent.id;
+  const name = displayAngleName(agent.name);
+  return {
+    id: LEGACY_ANGLE_IDS[agent.id] ?? suffix,
+    agentId: agent.id,
+    name,
+    shortName:
+      LEGACY_SHORT_NAMES[agent.id] ??
+      name.split(/[与和及、·/]/u, 1)[0].slice(0, 6),
+    description: agent.description,
+    accent: stableAccent(agent.id),
+    enabled: agent.enabled,
+  };
+}
+
+export function strategyAgentsToAngles(
+  agents: StrategyAgent[],
+): StrategyAngle[] {
+  return agents.flatMap((agent) => {
+    const angle = strategyAgentToAngle(agent);
+    return angle ? [angle] : [];
+  });
+}

frontend-web/src/strategy-selection/strategy-agents.test.ts

@@ -0,0 +1,66 @@
+/**
+ * Run from frontend-web:
+ *   npx esbuild src/strategy-selection/strategy-agents.test.ts --bundle --format=esm --platform=node --outfile=.tmp-tests/strategy-agents.test.mjs
+ *   node --test .tmp-tests/strategy-agents.test.mjs
+ */
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import {
+  strategyAgentToAngle,
+  strategyAgentsToAngles,
+  type StrategyAgent,
+} from "./strategy-agent-mapping";
+
+function agent(overrides: Partial<StrategyAgent> = {}): StrategyAgent {
+  return {
+    id: "strategy-selection-angle-public-opinion",
+    category: "angle",
+    fixed: false,
+    enabled: true,
+    sort_order: 100,
+    name: "策略视角·社会民生",
+    description: "关注公共服务连续性",
+    model: null,
+    soul: null,
+    skills: null,
+    created_at: null,
+    updated_at: null,
+    ...overrides,
+  };
+}
+
+test("keeps legacy project ids while accepting the public redacted shape", () => {
+  assert.deepEqual(strategyAgentToAngle(agent()), {
+    id: "public_opinion",
+    agentId: "strategy-selection-angle-public-opinion",
+    name: "社会民生",
+    shortName: "民生",
+    description: "关注公共服务连续性",
+    accent: "#ec4899",
+    enabled: true,
+  });
+});
+
+test("derives stable dynamic ids and accents from the reserved prefix", () => {
+  const dynamic = agent({
+    id: "strategy-selection-angle-abc123",
+    name: "科技与产业链智能体",
+  });
+  const first = strategyAgentToAngle(dynamic);
+  const second = strategyAgentToAngle({ ...dynamic });
+
+  assert.equal(first?.id, "abc123");
+  assert.equal(first?.shortName, "科技");
+  assert.equal(first?.accent, second?.accent);
+});
+
+test("filters fixed workflow roles out of the angle catalog", () => {
+  assert.equal(
+    strategyAgentsToAngles([
+      agent(),
+      agent({ id: "strategy-selection-intent", category: "intent" }),
+    ]).length,
+    1,
+  );
+});

frontend-web/src/strategy-selection/strategy-agents.ts

@@ -0,0 +1,128 @@
+import { useMemo } from "react";
+import { useQuery } from "@tanstack/react-query";
+
+import { apiFetch } from "@/core/api/fetch-client";
+import { getBackendBaseURL } from "@/core/config";
+
+import {
+  strategyAgentsToAngles,
+  type StrategyAgent,
+} from "./strategy-agent-mapping";
+
+export {
+  strategyAgentToAngle,
+  strategyAgentsToAngles,
+} from "./strategy-agent-mapping";
+export type {
+  StrategyAgent,
+  StrategyAgentCategory,
+} from "./strategy-agent-mapping";
+
+export interface CreateStrategyAngleInput {
+  name: string;
+  description?: string;
+  soul?: string;
+  model?: string | null;
+  skills?: string[];
+  sort_order?: number;
+}
+
+export interface UpdateStrategyAgentInput {
+  name?: string;
+  description?: string;
+  soul?: string;
+  model?: string | null;
+  skills?: string[];
+  enabled?: boolean;
+  sort_order?: number;
+}
+
+export const STRATEGY_AGENTS_QUERY_KEY = ["strategy-agents"] as const;
+
+function endpoint(suffix = "") {
+  return `${getBackendBaseURL()}/api/strategy-agents${suffix}`;
+}
+
+async function responseError(response: Response) {
+  const body = (await response.json().catch(() => null)) as
+    | { detail?: string }
+    | null;
+  return body?.detail || `请求失败（HTTP ${response.status}）`;
+}
+
+export async function listStrategyAgents(options?: {
+  includeDisabled?: boolean;
+  includeConfig?: boolean;
+}): Promise<StrategyAgent[]> {
+  const query = new URLSearchParams();
+  if (options?.includeDisabled) query.set("include_disabled", "true");
+  if (options?.includeConfig) query.set("include_config", "true");
+  const response = await apiFetch(
+    `${endpoint()}${query.size ? `?${query.toString()}` : ""}`,
+  );
+  if (!response.ok) throw new Error(await responseError(response));
+  const body = (await response.json()) as { agents?: StrategyAgent[] };
+  return body.agents ?? [];
+}
+
+export async function createStrategyAngle(
+  input: CreateStrategyAngleInput,
+): Promise<StrategyAgent> {
+  const response = await apiFetch(endpoint("/angles"), {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(input),
+  });
+  if (!response.ok) throw new Error(await responseError(response));
+  return (await response.json()) as StrategyAgent;
+}
+
+export async function updateStrategyAgent(
+  id: string,
+  input: UpdateStrategyAgentInput,
+): Promise<StrategyAgent> {
+  const response = await apiFetch(endpoint(`/${encodeURIComponent(id)}`), {
+    method: "PUT",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(input),
+  });
+  if (!response.ok) throw new Error(await responseError(response));
+  return (await response.json()) as StrategyAgent;
+}
+
+export async function disableStrategyAngle(id: string): Promise<StrategyAgent> {
+  const response = await apiFetch(endpoint(`/${encodeURIComponent(id)}`), {
+    method: "DELETE",
+  });
+  if (!response.ok) throw new Error(await responseError(response));
+  return (await response.json()) as StrategyAgent;
+}
+
+export function useStrategyAgents(options?: {
+  enabled?: boolean;
+  includeDisabled?: boolean;
+  includeConfig?: boolean;
+}) {
+  const includeDisabled = options?.includeDisabled ?? false;
+  const includeConfig = options?.includeConfig ?? false;
+  return useQuery({
+    queryKey: [
+      ...STRATEGY_AGENTS_QUERY_KEY,
+      includeDisabled,
+      includeConfig,
+    ],
+    queryFn: () => listStrategyAgents({ includeDisabled, includeConfig }),
+    enabled: options?.enabled ?? true,
+    staleTime: 30_000,
+  });
+}
+
+/** Reusable active-angle query for the workbench and project creation flow. */
+export function useStrategyAngleCatalog(enabled = true) {
+  const query = useStrategyAgents({ enabled });
+  const angles = useMemo(
+    () => strategyAgentsToAngles(query.data ?? []),
+    [query.data],
+  );
+  return { ...query, angles };
+}

frontend-web/src/strategy-selection/types.ts

@@ -0,0 +1,128 @@
+export type StrategyStage = "intent" | "workspace";
+
+export type AgentRunStatus =
+  | "idle"
+  | "queued"
+  | "running"
+  | "done"
+  | "error";
+
+export interface StrategyAngle {
+  id: string;
+  agentId: string;
+  name: string;
+  shortName: string;
+  description: string;
+  accent: string;
+  /** False when an angle survives only in an existing project snapshot. */
+  enabled?: boolean;
+}
+
+export interface StrategyTaskDraft {
+  name: string;
+  detail: string;
+  objective: string;
+  prerequisites: string;
+  constraints: string;
+  deliverables: string;
+  acceptanceCriteria: string;
+  horizon: string;
+  selectedAngleIds: string[];
+}
+
+export interface IntentTurn {
+  id: string;
+  role: "user" | "assistant";
+  content: string;
+  streaming?: boolean;
+  isDemo?: boolean;
+  clarification?: IntentClarification;
+  clarificationAnswered?: boolean;
+  clarificationAnswer?: string;
+  reasoning?: string;
+  error?: string;
+  retryPrompt?: string;
+  retryClarificationTurnId?: string;
+}
+
+export interface IntentClarificationOption {
+  id: string;
+  label: string;
+  description?: string;
+}
+
+export interface IntentClarification {
+  question: string;
+  context?: string;
+  clarificationType?: string;
+  options: IntentClarificationOption[];
+  allowCustom: boolean;
+  allowMultiple: boolean;
+}
+
+export interface AgentOutputState {
+  status: AgentRunStatus;
+  content: string;
+  steps: string[];
+  reasoning?: string;
+  error?: string;
+  /** A failed refresh kept the last successful content for this same task. */
+  preservedFromPrevious?: boolean;
+  isDemo?: boolean;
+}
+
+export interface StrategyEvaluation {
+  agentId: string;
+  score: number;
+  conclusion: "优先推荐" | "建议采用" | "保留备选";
+  comment: string;
+  strengths: string[];
+  risks: string[];
+}
+
+export interface ParallelAgentPayload {
+  task_name: string;
+  brief: string;
+  agent_ids: string[];
+  model?: string;
+}
+
+export type ParallelAgentEvent =
+  | { type: "agent_start"; agent_id: string }
+  | { type: "delta"; agent_id: string; text: string }
+  | {
+      type: "step";
+      agent_id: string;
+      key?: string;
+      label?: string;
+      args?: Record<string, unknown>;
+    }
+  | { type: "agent_done"; agent_id: string; content: string }
+  | { type: "agent_error"; agent_id: string; message: string }
+  | {
+      type: "agent_clarification";
+      agent_id: string;
+      content?: string;
+      question?: string;
+      clarification_type?: string;
+      clarification_context?: string;
+      context?: string;
+      options?: Array<
+        | string
+        | {
+            id?: string;
+            label?: string;
+            description?: string;
+          }
+      >;
+      allow_custom?: boolean;
+      allow_multiple?: boolean;
+    }
+  | {
+      type: "thinking" | "reasoning" | "reasoning_delta";
+      agent_id: string;
+      text?: string;
+      delta?: string;
+      content?: string;
+    }
+  | { type: "all_done" };

offline-backend-20260512/backend/CLAUDE.md

@@ -299,6 +299,8 @@ from deerflow.config import get_app_config
 
 **Forced-research built-in agent.** `forced-research-responder` (「强制检索输出助手」) is seeded from `app/gateway/routers/_forced_research_seed_assets/` before `_sync_legacy_agents`. `ForcedResearchMiddleware` is mounted only for this stable id. On every visible user turn it requires a successful information-gathering tool result before the model may finish; `tool_choice=required` is backed by an `after_model -> model` retry for gateways that ignore tool choice, with an eight-attempt failure cap that permits only an honest failure response. Skill discovery, reading `SKILL.md`, and writing a helper script do not satisfy the gate; web/knowledge/MCP results, non-skill uploaded-file reads, or successful Python skill-script execution do. Tool filtering removes `present_files`, `skill_manage`, task/schedule/memory/clarification surfaces. The middleware permits `write_file`/`str_replace` only for `/mnt/user-data/workspace/*.py` and permits `bash` only for `.py` execution without redirection/document paths, so skills can run scripts but the agent cannot create Markdown/document artifacts or write `outputs`. Tests: `tests/test_forced_research_agent.py`.
 
+**Strategy-selection functional agents.** `app/gateway/routers/_strategy_selection_seed.py` seeds nine stable folder-backed agents from `_strategy_selection_seed_assets/` before `_sync_legacy_agents`: intent, governance/diplomacy/economy/security/public-opinion/law-policy angles, judge, and solution editor. Seeding is missing-directory-only and must never overwrite administrator changes. The global `strategy_agent_roles` registry classifies them independently of projects: intent/judge/solution are fixed, unique roles that may be configured but never added, disabled, reordered, or deleted; angle roles are a shared, ordered catalog that administrators may add, edit, disable (soft delete), restore, and reorder through `/api/strategy-agents`. Public `GET /api/strategy-agents` returns enabled identity/description metadata only; `include_disabled=true` or `include_config=true` is admin-only. Admin writes are `POST /api/strategy-agents/angles`, `PUT /api/strategy-agents/{id}`, and `DELETE /api/strategy-agents/{id}`; DELETE retains the folder-backed agent and role row to preserve historical references. Dynamic angles remain built-in folder-backed agents under the reserved `strategy-selection-angle-` id namespace, with `web` + `file:read`; a blank SOUL on create receives a safe role template. All strategy skill writes validate that names exist, are active, and are globally visible; generic agent CRUD cannot create or hard-delete reserved strategy IDs, and parallel execution rejects disabled roles. Angle configs reuse `policy-knowledge`; intent reuses `intent-clarification-policy`; the judge has no retrieval skill; the solution editor gets only `file:write`. Keep the SOUL contracts neutral and evidence-aware, with explicit de-escalation/civilian-protection framing and hard bans on operational combat guidance and targeted political manipulation. Tests: `tests/test_strategy_selection_seed.py`, `tests/test_strategy_agent_management.py`.
+
 **ThreadState** (`packages/harness/deerflow/agents/thread_state.py`):
 - Extends `AgentState` with: `sandbox`, `thread_data`, `title`, `artifacts`, `todos`, `uploaded_files`, `viewed_images`
 - Uses custom reducers: `merge_artifacts` (deduplicate), `merge_viewed_images` (merge/clear)
@@ -540,6 +542,8 @@ Self-contained product knowledge base. **All knowledge capability lives in this
 
 Custom agent metadata lives in the `agents` ORM table (`deerflow.persistence.agents`). `agents.id` is the stable runtime id and the filesystem directory name under `.deer-flow/agents/{id}/`; `agents.name` is display-only, can contain Chinese characters, and is not unique. `user_id IS NULL` marks built-in agents, user-owned agents are visible only to their owner unless `published = true`, and update/delete operations require ownership. The runtime accepts `agent_id` in context/configurable, and non-default `assistant_id` values are treated as agent ids after visibility checks.
 
+Strategy-selection fan-out (`routers/parallel_agents.py`) must keep hidden reasoning separate per agent: provider reasoning blocks/fields and inline `<think>...</think>` text emit `reasoning_delta`, while visible answer text emits `delta` and only visible text may enter `agent_done.content`. Never concatenate `reasoning_delta` into a selectable strategy or generated deliverable. Inspect the final AI message with the shared `is_llm_error_message` detector and require substantive visible text before constructing a success result. A middleware fallback, empty/thinking-only response, or punctuation-only provider degeneration is a failed seat run: raise so the stream emits `agent_error`; never wrap it in `agent_done`. Regression coverage: `tests/test_roundtable_model_fallback.py`.
+
 **Listing cache + pagination** ? to keep `GET /api/agents` fast, the gallery's per-card extras (skills + tool_groups) are denormalized into two cache tables instead of reading every agent's `config.yaml` on each request: `agent_skills` (relational, one row per (agent, skill) with `position`) and `agent_extras` (one row per agent: `tool_groups` JSON + `model` + `skills_synced_at`). `config.yaml` remains authoritative for the agent runtime; these tables are a read cache, write-through on create/update and backfilled from disk by `_sync_legacy_agents` (mtime-vs-`skills_synced_at` drift check). The list endpoint enriches via `AgentStore.get_extras_for([ids])` (two batched `IN` queries). Both tables are auto-created by `Base.metadata.create_all` (no migration needed). `GET /api/agents` supports **opt-in server-side pagination**: `scope` (`mine` = owned + favorited / `square` = built-in/published public), `page`, `page_size`, returning `{agents, total, page, page_size}`; omitting `scope`/`page` preserves the legacy "return everything" behavior. Name `search` matches the raw OR desensitized name (the frontend's static term?abbrev map is mirrored server-side in `deerflow/config/agent_name_desensitize.py`); `tag_ids` is an SQL OR-filter; `owner` keeps only agents published by that user id (the card's ??? ? built-in agents never match), powering the gallery's click-???-to-filter. `POST /api/agents/private-square/list` takes the same pagination params (incl. `owner`). Repository entry point: `AgentStore.list_paginated(...)`. Tests: `tests/test_agent_listing_cache.py::test_list_paginated_owner_filter_keeps_one_publisher`.
 
 **Homepage selector (agent picker on the new-chat page)** ? single admin-curated list backed by `agents.featured_order` (nullable BIGINT). NULL = not featured. Only `published = true` agents can be featured (router enforces on writes); any published agent is eligible regardless of ownership. Cleared with `order: null`. The list rendered to end users is `WHERE featured_order IS NOT NULL` + visibility-filter, sorted by `featured_order ASC`. Admins reorder by sending the desired ids to `PUT /api/agents/featured/order` (assigns indices 0..N-1). BIGINT is used rather than INT so the management UI can seed initial values from `Date.now()` (overflows INT on MySQL).
@@ -766,6 +770,7 @@ MySQL index script synchronized.
 - Physical: `backend/.deer-flow/users/{user_id}/threads/{thread_id}/user-data/...`, `deer-flow/skills/`
 - Translation: `replace_virtual_path()` / `replace_virtual_paths_in_command()`
 - Detection: `is_local_sandbox()` checks `sandbox_id == "local"`
+- Configured mount portability: `AppConfig._resolve_relative_mount_paths` resolves each relative `sandbox.mounts[*].host_path` against the loaded `config.yaml` directory before validation/provider construction, never against the process cwd. Keep repository-owned knowledge mounts relative (for example `knowledge/knowledge_base`); absolute paths remain unchanged, and sandbox providers always receive an absolute path.
 - **`{user_id}` for path resolution = `resolve_path_user_id(thread_id)`, using the persisted creator for every tracked thread.** The route's regular owner check still authorizes access first; creator resolution only selects the stable physical directory (`threads_meta.user_id`) and avoids a lost request context falling back to `users/default`. This also preserves cross-account task-deeplink conversations (rwfx/3qfx/xdfx) and roundtable system threads. Positive creator mappings are cached process-wide and DB/memory/missing-row failures fall back to the current login. It is wired at the thread-path consumers including `ThreadDataMiddleware.before_agent`, `present_file_tool`, uploads, artifact serving, and embedded `client.get_artifact`. **Rewrite-history recovery is metadata-only and job-owner scoped** (`list_by_session(..., user_id=current_user)`), so its GET/list endpoints intentionally skip redundant thread-owner checks and return an empty history instead of a history-only 404; the start/commit endpoints retain strict thread write authorization. Tests: `tests/test_thread_paths_owner.py`, `tests/test_thread_paths_roundtable.py`.
 
 - **Durable document-rewrite commit:** `document_rewrite_pipeline.atomic_write_text` writes through a deliberately short sibling temporary filename so long Windows artifact paths stay below the path-length limit, and guarantees the target `outputs` parent exists. If the sandbox recreates that directory in the narrow commit window, it repairs the directory and retries; the original file is otherwise only changed through `os.replace`.
@@ -998,6 +1003,15 @@ scheduler runs once per deployment. Per run:
 - Supports `supports_vision` flag for image understanding models
 - Config values starting with `$` resolved as environment variables
 - Missing provider modules surface actionable install hints from reflection resolvers (for example `uv add langchain-google-genai`)
+- Generic `langchain_openai:ChatOpenAI` entries are transparently wrapped by
+  `PatchedChatOpenAI`. Besides preserving reasoning/tool-call metadata, the
+  patch recognizes compatible gateways that encode failures inside HTTP 200
+  payloads (`base_resp.status_code != 0` with null/empty `choices`) in both
+  streaming and non-streaming paths. It raises the stable
+  `OpenAICompatibleUpstreamError`; `LLMErrorHandlingMiddleware` retries
+  transient concurrency/inference failures, while genuine quota/balance
+  failures are classified as non-retriable and surfaced immediately. Embedded
+  vendor failures therefore cannot become empty successful assistant turns.
 
 ### Roundtable Model Fault Tolerance (会商模型自动容错 / 换下一个模型)
 
@@ -1014,9 +1028,11 @@ scheduler runs once per deployment. Per run:
 
 ### vLLM Provider (`packages/harness/deerflow/models/vllm_provider.py`)
 
-- `VllmChatModel` subclasses `langchain_openai:ChatOpenAI` for vLLM 0.19.0 OpenAI-compatible endpoints
-- Preserves vLLM's non-standard assistant `reasoning` field on full responses, streaming deltas, and follow-up tool-call turns
-- Designed for configs that enable thinking through `extra_body.chat_template_kwargs.enable_thinking` on vLLM 0.19.0 Qwen reasoning models, while accepting the older `thinking` alias
+- `VllmChatModel` subclasses `langchain_openai:ChatOpenAI` for vLLM OpenAI-compatible endpoints
+- Thinking text is accepted from either `reasoning` (newer vLLM parsers) or `reasoning_content` (older vLLM / DeepSeek-style). The UI still reads canonical `additional_kwargs.reasoning_content`. Follow-up turns echo only the wire field that actually arrived, so other ChatOpenAI models are unchanged
+- Shared helpers live in `deerflow/models/reasoning_fields.py` and are also used by `PatchedChatOpenAI` (the default `langchain_openai:ChatOpenAI` patch)
+- Designed for configs that enable thinking through `extra_body.chat_template_kwargs.enable_thinking` on vLLM Qwen reasoning models, while accepting the older `thinking` alias
+- Per-model switch: set only that entry's `use: deerflow.models.vllm_provider:VllmChatModel`. Do not change SiliconFlow / DeepSeek entries that already use `langchain_openai:ChatOpenAI`
 
 ### IM Channels System (`app/channels/`)
 
@@ -1126,6 +1142,15 @@ Both can be modified at runtime via Gateway API endpoints or `DeerFlowClient` me
 
 ### Conditional WeKnora LLMWiki
 
+**Embedding ownership:** WeKnora's per-knowledge-base `embedding_model_id`
+indexes uploaded source documents; `llmwiki.local_wiki_index.embedding` indexes
+the generated Wiki-page mirror inside DeerFlow. Do not couple these two model
+choices. `GET /api/llmwiki/embedding-models` returns a strict credential-free
+projection of WeKnora Embedding models, and KB creation must validate and pass
+the selected active model id. When the caller omits a choice, retain WeKnora's
+active-default behavior. Existing KBs cannot change this binding in place, and
+cross-KB WeKnora searches should use model-compatible knowledge bases.
+
 Ordinary knowledge-base cards expose an owner/admin-only name/description edit dialog in `WeKnoraKnowledgeWorkspace.tsx`, reusing `useLlmWikiActions().update` and `PATCH /api/llmwiki/knowledge-bases/{id}`. The route trims names, rejects blank or reserved conversation-deposit names, writes to WeKnora before updating local metadata, and retains existing write authorization. A successful remote list is authoritative for every list scope, including `personal`: absent remote IDs are hidden without deleting mappings/references. Upstream failures remain errors. The grid also filters cached `remote_status=missing` rows and no longer renders stale-record cleanup cards. Regression coverage: `tests/test_llmwiki_knowledge_management.py`.
 
 `llmwiki.weknora.api_base_url` is the provider switch: non-empty enables WeKnora, empty preserves the legacy LLMWiki UI. WeKnora is independently deployed and owns PostgreSQL/Redis/object storage/vector storage/parsers/models; DeerFlow config contains only `api_base_url` and optional `web_base_url`. DeerFlow deliberately sends no WeKnora credential, so the WeKnora endpoint must be restricted to a trusted network and allow DeerFlow traffic itself or through its reverse proxy. There is intentionally no `default_embedding_model_id`: `WeKnoraClient` queries `/api/v1/models` and uses WeKnora's active Embedding model when creating a KB; Wiki creation additionally resolves an active KnowledgeQA model inside WeKnora for synthesis. The native BFF is `app/gateway/routers/llmwiki.py`; ownership/publication mappings live in `deerflow.persistence.llmwiki`; the browser only sees DeerFlow mapping IDs. Knowledge-base owners publish immediately (`private` -> `published`) without a review queue, and can unpublish ordinary bases. The conversation-deposit KB is system-owned, always published, shared by all DeerFlow users, excluded from My Knowledge, and immutable through user/admin detail operations; recognition requires both the reserved name and `system` owner. Existing same-name remote mappings are adopted in place as the system deposit, preserving mapping ids and document links. Its user-facing description, generated Markdown source and tags use `cmzs` branding; list/detail reads synchronize stale remote descriptions, and search results, source previews and embedded-detail JSON recursively replace legacy brand text in historical conversation-deposit payloads. Deposit requests must reference a thread accessible to the current account. Personal knowledge-base list/search views are scoped to the current DeerFlow account even for admins; frontend LLMWiki caches include the live account id, and admin write power does not make other users' private KBs appear as owned. Only `system_role === "admin"` sees the WeKnora connection-config tab. Knowledge cards navigate to a dedicated WeKnora-style detail route. Wiki-enabled bases render and default to `Wiki -> documents -> graph`; standard bases omit Wiki and render `documents -> graph`. The detail page supports sequential multi-file upload with an aggregate result for writable ordinary bases, hides it for public read-only/system-deposit bases, and uses a generic loading label while the embed session starts. It also supports URL and published manual-Markdown imports, browses real Wiki pages/content, proxies authenticated original-file previews, pages through `/chunks/{knowledge_id}`, and renders the Wiki page graph from `/knowledgebase/{kb_id}/wiki/graph`; document details use a right sheet rather than the removed KB modal. The credential-free proxy uses one WeKnora service identity, so per-user separation is enforced by DeerFlow mappings while all remote KBs physically share that identity's WeKnora workspace. WeKnora iframe detail pages first call `/api/llmwiki/knowledge-bases/{id}/weknora/session` through the normal DeerFlow API auth path, then load `/platform/knowledge-bases/{weknora_id}` with a signed `deerflow_weknora_embed` cookie for `/platform`, `/assets`, `/locales`, root assets, and API calls. Injected fetch/XHR rewriting sends all iframe `/api/v1/*`, including colliding `/api/v1/auth/*`, through `/api/llmwiki/weknora-embed/api/v1/*`; Gateway auth/CSRF bypass only applies to those signed iframe proxy requests, the proxy still revalidates the mapped KB, and cookie security honors `X-Forwarded-Proto` for HTTPS reverse proxies. `llmwiki_search` is conditionally registered in `tools.py`, is read-only, and rechecks the current DeerFlow user, agent `llmwiki_knowledge_base_ids`, and thread-context selection on every call. Source previews prefer the cleaned Wiki/LLMWiki page text when a retrieved chunk maps to a Wiki page, with raw split chunks as the fallback. Agent bindings use an inline WeKnora-style searchable/grouped multi-select in the standard agent create/detail UI; new chats use the same interaction pattern as a compact composer dropdown, and selections are written to thread metadata/context and restored on reopen. The DeerFlow frontend is native React and the WeKnora frontend is not modified or embedded. Full deployment and behavior notes: `docs/LLMWIKI_WEKNORA_INTEGRATION_ZH.md`. Tests: `tests/test_llmwiki_weknora.py`.
@@ -1322,6 +1347,14 @@ Automatic conversation summarization when approaching token limits:
   when it has already been folded into the hidden summary. This keeps strict
   OpenAI-compatible gateways from rejecting a tool-continuation call with
   `No user query found in message`.
+- LangChain keeps the agent prompt in `ModelRequest.system_message`, separate
+  from `ModelRequest.messages`. Compression must merge its hidden summary into
+  that dedicated slot and remove every `SystemMessage` from the ordinary
+  message list. Strict Qwen-style adapters accept only one system message at
+  index zero and otherwise return HTTP 400 (`system message must be at the
+  beginning`). Keep this normalization adapter-independent; the payload-level
+  OpenAI-compatible normalizer is a second line of defence and also merges
+  adjacent leading system messages.
 - Keeps recent messages while summarizing older ones.
 
 Tests: `tests/test_summarization_toggle.py` (gating + whitelist),
@@ -1762,9 +1795,12 @@ gone.
 
 Assistant knowledge has one global full-library base (`知识梳理总库`) and any
 number of admin-created custom bases. Ordinary users have read/search access and
-administrators own all mutations. Assistant bases only accept WeKnora export
-packages or imports triggered from a WeKnora mapping. Do not add direct skill
-imports or arbitrary local-file imports to assistant knowledge. Importing into a
+administrators own all mutations. Assistant bases accept local documents independently
+of WeKnora via `/api/assistant-knowledge/imports/files`, as well as WeKnora export
+packages or imports triggered from a WeKnora mapping. Local documents use the
+Gateway `assistant_file_ingest` pipeline: persisted original files, chunked LLM Wiki
+extraction, cached body embeddings, and import-job status/retry. Do not add direct skill
+imports. Importing into a
 custom assistant base must also mirror the package into the global base for
 cross-source entity alignment. Admins may rename any assistant base and delete
 custom bases. Deletion removes the custom base's Wiki pages, vectors, entities,
@@ -1773,6 +1809,8 @@ deletable because it owns full-library aggregation.
 
 ### Wiki package and local encoder invariants (2026-09)
 
+Ordinary knowledge detail landing is globally configured by `ordinary_knowledge_landing` (`wiki` default / `weknora`), with admin-only PUT `/api/system-settings/ordinary-knowledge-landing`. Explicit document/graph/article links bypass this default. Wiki reading and the embedded WeKnora view provide reciprocal navigation; `?view=weknora` explicitly selects the iframe and must not loop back to the default Wiki route.
+
 - `knowledge_transfer.sync_to_global` is called after successful explicit local
   Wiki vectorization; it skips conversation/system mappings. Do not enable a new
   watcher or automatic remote-write scheduler as a side effect.
@@ -1796,8 +1834,8 @@ deletable because it owns full-library aggregation.
   pages need backfill, not a forced rebuild of every page.
   FastEmbed is a standard backend dependency. Encoder configuration, directory
   upload and warmup live only in the administrator global settings dialog.
-  A runtime `system_settings.json` path override wins over config.yaml; uploaded
-  files are streamed into `.deer-flow/models/bge-m3`, never the source tree.
+  When the effective provider is local, its `system_settings.json` path override wins over config.yaml; uploaded
+  files are streamed into immutable `.deer-flow/models/bge-m3-revisions/<revision>` directories, never the source tree.
   Encoder warmup is explicitly started from the settings UI/API and must never block application startup
   or turn a model-load failure into a DeerFlow service failure. Local provider
   is offline-only: require local_model_path or DEERFLOW_BGE_M3_MODEL_PATH and
@@ -1805,6 +1843,21 @@ deletable because it owns full-library aggregation.
   `local_process_isolation=true` by default: inference runs in the bundled JSONL
   worker subprocess, and shutdown must terminate that worker without waiting on
   model teardown.
+- The administrator encoder override is an explicit persisted mode, not an
+  inference from whether `model_path` happens to be non-empty. `configured`
+  uses the current `config.yaml` provider (including OpenAI-compatible);
+  saving/uploading a local directory sets `local` plus a new model revision,
+  while `/api/llmwiki/local-encoder/use-configured` switches back. Every switch
+  hot-rebuilds embedding/cache/search/sync/retrieval as one graph and updates
+  the harness runtime registration. Status must remain readable for a remote
+  provider. The scheduler stays alive as a lightweight config watcher but only
+  scans when effective `enabled && auto_sync`; keep the default/portable release
+  configs at `auto_sync=true` because asynchronous Wiki generation can finish
+  after the event-triggered first scan. A changed local model revision must
+  change the embedding fingerprint so vectors from replaced weights are never
+  reused. Uploaded weights live in immutable revision directories. A replaced
+  embedding generation gets a bounded grace period for in-flight work, then
+  rejects stragglers, drains real thread work, and releases its model process.
 - Every successful mapping snapshot is mirrored to the global assistant base,
   including empty snapshots so deleted source pages are retired. Re-import is
   source-replacement semantics: absent Wiki/chunk/entity/relation pages must not

offline-backend-20260512/backend/README.md

@@ -1,5 +1,11 @@
 # DeerFlow Backend
 
+普通知识库默认详情页面：管理员可在知识库顶部选择“本系统 Wiki 索引”或“嵌入 WeKnora”，对应 `ordinary_knowledge_landing`（默认 `wiki`）。Wiki 库首次进入默认展示本系统索引，右上角“打开 WeKnora”切换到内嵌管理页；内嵌页可返回索引。非 Wiki 库仍进入 WeKnora 文档页。设置通过 `/api/system-settings/ordinary-knowledge-landing` 保存，仅管理员可修改；指定文章、文档、图谱的直达链接优先于默认设置。
+
+助手知识库可独立于 WeKnora 使用：管理员进入助手知识库，选择或创建库后点击“上传文件生成 Wiki”。支持 Markdown/TXT/CSV、PDF、Word、Excel、PowerPoint（单文件 100 MB，解析正文上限 400 万字符）。文件先写入运行目录 `assistant-knowledge/files/{job_id}`，后台分段调用已配置的语言模型生成分类 Wiki、实体关系，再通过 DeerFlow 编码器对正文分段向量化，保存到助手库并汇入知识梳理总库。无需配置 WeKnora URL；配置后仍可直接上传，也保留 WeKnora 数据包导入。文件处理沿用管理员写入权限，所有用户可以浏览和搜索。
+
+导入记录显示解析、Wiki 生成和向量化阶段；失败或服务中断后可“重试 / 恢复处理”，复用已落盘的 Wiki 和相同模型指纹的向量。离线编码器须预先放置模型并在管理员设置中配置；模型或编码器不可用会明确失败，不把摘要冒充 Wiki 或虚构向量。扫描件是否可解析取决于部署的文档解析/OCR 能力。
+
 DeerFlow is a LangGraph-based AI super agent with sandbox execution, persistent memory, and extensible tool integration. The backend enables AI agents to execute code, browse the web, manage files, delegate tasks to subagents, and retain context across conversations - all in isolated, per-thread environments.
 
 ---
@@ -73,7 +79,7 @@ Middlewares execute in strict order, each handling a specific concern:
 | 1 | **ThreadDataMiddleware** | Creates per-thread isolated directories (workspace, uploads, outputs) |
 | 2 | **UploadsMiddleware** | Injects newly uploaded files into conversation context |
 | 3 | **SandboxMiddleware** | Acquires sandbox environment for code execution |
-| 4 | **SummarizationMiddleware** | Reduces context when approaching token limits (optional) |
+| 4 | **SummarizationMiddleware** | Reduces context near token limits and folds the hidden summary into one leading system message for strict model adapters (optional) |
 | 5 | **TodoListMiddleware** | Tracks multi-step tasks in plan mode (optional) |
 | 6 | **TitleMiddleware** | Auto-generates conversation titles after first exchange |
 | 7 | **MemoryMiddleware** | Queues conversations for async memory extraction |
@@ -88,6 +94,7 @@ Per-thread isolated execution with virtual path translation:
 - **Providers**: `LocalSandboxProvider` (filesystem) and `AioSandboxProvider` (Docker, in community/)
 - **Virtual paths**: `/mnt/user-data/{workspace,uploads,outputs}` → thread-specific physical directories
 - **Skills path**: `/mnt/skills` → `deer-flow/skills/` directory
+- **Portable configured mounts**: a relative `sandbox.mounts[*].host_path` is resolved against the directory containing the loaded `config.yaml`, not the process working directory. Providers still receive an absolute host path, so `knowledge/knowledge_base` can be committed and the deployment can be cloned or moved without editing a machine-specific path; already-absolute mount paths are preserved.
 - **Skills loading**: Recursively discovers nested `SKILL.md` files under `skills/{public,custom}` and preserves nested container paths
 - **Conditional WeKnora LLMWiki**: a non-empty `llmwiki.weknora.api_base_url` enables the DeerFlow-native WeKnora BFF and UI; an empty address preserves the existing LLMWiki page. WeKnora remains independently deployed and owns its database, Redis, storage, parsers and models. DeerFlow keeps only the API/admin addresses, user/publication mappings, agent knowledge-base bindings and per-conversation selections; it stores and sends no WeKnora credential, so the endpoint must be restricted to a trusted network and allow DeerFlow traffic. Owners publish directly to the public LLMWiki without an approval queue for ordinary bases; the system-owned conversation-deposit base is always published, shared by all users, excluded from My Knowledge, immutable through user/admin detail operations, and recognized by both its reserved name and `system` owner. An existing same-name remote mapping is adopted in place as the system deposit so its mapping id and document links stay valid. Its user-facing knowledge-base description and generated document metadata use the `cmzs` brand; list/detail reads synchronize stale remote descriptions, while conversation-deposit search results, source previews and embedded-detail JSON rewrite legacy brand text to `cmzs`. Deposit requests must reference a thread accessible to the current account. Personal knowledge-base lists are scoped to the current DeerFlow account even for admins, while frontend LLMWiki query caches also include the active account id so switching accounts cannot reuse another account's list/detail data. Admins remain the only role that sees the WeKnora connection-config tab. Knowledge cards open a dedicated WeKnora-style detail route: Wiki-enabled bases default to Wiki, then documents and graph; standard bases hide Wiki and default to documents. Writable ordinary knowledge-base details expose a native multi-file upload action that submits files sequentially and reports aggregate success/failure; read-only public bases and the system deposit base do not. It supports file/URL/manual-Markdown imports, Wiki page browsing, document preview, real parsed chunks and Wiki graph nodes/edges. New chats use a compact WeKnora-style searchable/grouped multi-select inside the composer, while agent create/edit pages bind spaces through an inline panel. A single proxy service identity means DeerFlow users are isolated logically while their WeKnora entities share that identity's workspace. The read-only `llmwiki_search` tool reauthorizes the current DeerFlow user on every call and renders credential-free source previews; source previews prefer cleaned Wiki/LLMWiki text when a retrieved chunk maps to a Wiki page, with raw chunks as the fallback. The detail page first creates a signed iframe session through the normal DeerFlow API auth path, then points the iframe directly at the proxied WeKnora `/platform/...` route using the signed `deerflow_weknora_embed` cookie; global auth/CSRF bypass is limited to those signed iframe proxy requests, and HTTPS cookie attributes honor `X-Forwarded-Proto` behind reverse proxies. The iframe proxy keeps WeKnora's root-relative `/platform`, `/assets`, `/locales`, and `/api/v1/*` paths, but is registered last through `llmwiki.proxy_router` so it cannot intercept first-party Gateway APIs such as `POST /api/v1/auth/login/username`. See [docs/LLMWIKI_WEKNORA_INTEGRATION_ZH.md](docs/LLMWIKI_WEKNORA_INTEGRATION_ZH.md).
 - **Enterprise Research workbench (temporarily disabled)**: the independent `/api/enterprise-research` router, its report executor, and its ORM table registration are intentionally inactive. The implementation remains in the repository, but startup does not create or alter `enterprise_research_tasks` or `enterprise_research_report_jobs`; this keeps the active Deep Research workflow independent of the paused workbench and avoids MySQL schema errors.
@@ -465,6 +472,10 @@ Custom agents are indexed in the `agents` database table. The `id` column is the
 
 The built-in `forced-research-responder` (「强制检索输出助手」) is seeded at Gateway startup. Unlike an ordinary skill-enabled custom agent, it has a runtime-enforced per-turn collection gate: the model cannot finish a response until a retrieval/knowledge/MCP tool or a skill Python script returns usable information. It then answers directly in the user's requested chat format rather than generating an artifact. The agent may create or edit only temporary `.py` files below `/mnt/user-data/workspace/` and may execute `.py` skill scripts through `bash`; writes to `outputs`, Markdown/document creation, `present_files`, general shell commands, and skill mutation are denied. Administrators can edit its model and skill allowlist from agent management; the runtime safety policy remains fixed. Regression coverage: `tests/test_forced_research_agent.py`.
 
+The strategy-selection workbench starts with nine folder-backed functional agents: one intent agent, six independent angle agents (governance, diplomacy, economy/supply-chain, security risk, public opinion, and law/policy), one judge, and one final solution editor. Defaults ship in `app/gateway/routers/_strategy_selection_seed_assets/` and are copied only when an agent directory is absent, before `_sync_legacy_agents`; existing administrator edits are never overwritten. A global `strategy_agent_roles` registry owns classification, lifecycle state, and ordering independently of projects. Intent, judge, and solution are fixed singleton roles: administrators may update their model, SOUL, and skills but cannot add, disable, reorder, or delete them. Angles form one ordered catalog shared by every project; administrators may add, update, disable, restore, and reorder them. `GET /api/strategy-agents` is the public enabled catalog and omits model/SOUL/skills; `include_disabled=true` or `include_config=true` requires an administrator. Admin writes use `POST /api/strategy-agents/angles`, `PUT /api/strategy-agents/{id}`, and `DELETE /api/strategy-agents/{id}`; deletion is a soft disable so folder configuration and historical project references remain intact. Dynamic angles use the reserved `strategy-selection-angle-` namespace, receive `web` + `file:read`, and get a safe default SOUL if the submitted SOUL is blank. Model names and selected skills are validated, skills must be active and globally visible, generic agent CRUD cannot create or hard-delete reserved strategy agents, and parallel execution rejects disabled roles. The shipped angle agents use `policy-knowledge`, intent uses `intent-clarification-policy`, judging is input-only, and the solution editor has file-write access for `/mnt/user-data/outputs/综合策略方案.md`. Every default SOUL requires neutral evidence handling, de-escalation and civilian protection, and prohibits operational combat guidance or targeted political manipulation.
+
+`POST /api/parallel-agents/run/stream` keeps reasoning and the deliverable in separate per-agent frames. Provider structured reasoning and inline `<think>...</think>` content are emitted only as `reasoning_delta`; visible answer text is emitted as `delta`, and `agent_done.content` contains only the visible answer. Consumers must not append `reasoning_delta` to strategy output or the final document. A final `is_llm_error_message` fallback, empty/thinking-only response, or punctuation-only provider degeneration is emitted as `agent_error`, never as a successful `agent_done`. Regression coverage: `tests/test_strategy_selection_seed.py`, `tests/test_strategy_agent_management.py`, and `tests/test_roundtable_model_fallback.py`.
+
 ### AI Writing Intranet Retrieval
 
 AI 写作的「知识库检索」会直连 `ai_writing.intranet_search_url` 内网 ES/知识库接口，并默认跳过代理环境变量和 HTTPS 证书校验，适配自签名或内部 CA 证书的内网服务。需要强校验时可在 `config.yaml` 里设置 `ai_writing.intranet_verify_ssl: true`。通用检索里的非内置技能在 `ai_writing.researcher_skill_agent: true` 时会用真实 agent 运行时执行技能：以 `ai-writing-researcher` 身份读取该技能的 `SKILL.md`，并按技能要求通过 `bash` 运行脚本，弱模型也会在本轮任务里收到明确的读文件和脚本执行指令。
@@ -537,6 +548,13 @@ the configured model has an explicit, proxy-supported thinking control. This
 prevents DeerFlow's connection check from sending vendor-specific `thinking`
 fields that a generic OpenAI-compatible gateway may reject.
 
+OpenAI-compatible gateways that return vendor errors inside an HTTP 200
+response (for example, a non-zero `base_resp.status_code` with empty/null
+`choices`) are treated as upstream failures in both streaming and
+non-streaming calls. DeerFlow retries transient upstream responses instead of
+accepting an empty assistant turn, while genuine quota/balance failures are
+classified as non-retriable and surfaced immediately instead of being retried.
+
 ### Running
 
 **Full Application** (from project root):
@@ -910,6 +928,13 @@ the file through the existing thread-artifact endpoint.
 
 远端已经删除的知识库会在下次列表刷新时自动隐藏，包括个人、公共列表和知识库选择器；页面每 15 秒自动刷新，也可以手动点击「刷新」。远端服务请求失败时展示错误，不把连接故障当成删除，不自动删除本地映射或已有引用。
 
+新建知识库时会通过 `GET /api/llmwiki/embedding-models` 读取 WeKnora 中可用的
+Embedding 模型，并把所选 `embedding_model_id` 明确传给创建接口。该模型只负责
+WeKnora 中上传原文的分块向量化；它和下文 DeerFlow 自己的 Wiki 镜像编码器是两套
+独立配置，因此选择 OpenAI/OpenAI-compatible 原文编码器时不要求同时启用本地
+BGE-M3。模型列表响应只暴露名称、provider、状态等白名单字段，不返回密钥或连接
+参数。模型绑定只对新建库生效；需要跨知识库检索时，各库应使用相同或兼容的向量模型。
+
 ## DeerFlow-local LLMWiki Wiki vector index
 
 LLMWiki can mirror processed WeKnora Wiki pages into DeerFlow and search only
@@ -1158,13 +1183,23 @@ llmwiki:
 
 本地编码依赖随标准后端安装。将完整 BGE-M3 模型目录提前放到离线服务器，并通过
 `local_model_path` 或 `DEERFLOW_BGE_M3_MODEL_PATH` 指向它。管理员也可在
-「设置和更多 → 设置 → 本地编码器」中选择服务器目录，或从浏览器上传完整模型目录；
+「设置和更多 → 设置 → Wiki 镜像编码器」中选择服务器目录，或从浏览器上传完整模型目录；
 页面配置持久化到运行目录的 `system_settings.json`，上传文件落到
-`.deer-flow/models/bge-m3`，均不进入源码仓库。系统强制 `local_files_only`，
+`.deer-flow/models/bge-m3-revisions/<revision>` 的不可变版本目录，均不进入源码仓库。系统强制 `local_files_only`，
 **不会访问互联网或下载模型**。管理员可在同一设置页点击「一键启动编码器」异步加载；该操作不挂在应用启动流程，加载失败不会
 中断 DeerFlow 主服务。默认由独立低优先级子进程承载模型内存，正常停止 DeerFlow
 时会一并回收该子进程；编码进程异常退出只会将当前向量任务标记失败。模型目录应包含
 `onnx/model.onnx`（官方权重约 2.3 GB）及对应 tokenizer/config 文件。权重不进入业务源码仓库。
+
+运行时编码器模式持久化为 `configured` 或 `local`。默认 `configured` 严格使用
+`config.yaml` 中的 OpenAI、OpenAI-compatible 或 local provider；保存服务器目录或
+上传模型会显式切到 `local` 并热重建 embedding/search/sync/retrieval 服务，不需要
+重启 Gateway。`POST /api/llmwiki/local-encoder/use-configured` 可立即恢复配置文件中的
+provider。`GET /api/llmwiki/local-encoder/status` 在远程 provider 下也正常返回当前
+provider/mode，不再把“不是 local”当成状态接口错误。每次激活本地模型都会生成新的
+模型修订指纹，避免同一路径替换权重后误复用旧向量。切换后的旧编码器会给在途任务
+保留短暂宽限期，随后等待当前编码调用结束并自动回收模型进程。
+
 浏览器目录上传采用磁盘暂存和 4 MB 分块复制，页面显示上传进度；经 Nginx 等反向
 代理部署时仍需把请求体上限和读写超时配置到可承载完整模型目录。
 相同模型指纹、相同内容的页面复用现有向量；短正文/摘要至少保留一个非空分段。

offline-backend-20260512/backend/app/gateway/app.py

@@ -42,6 +42,7 @@ from app.gateway.routers import (
     compact_menu_overrides,
     dashboard_sessions,
     deep_research,
+    direct_chat,
     external_llmwiki,
     feedback,
     fixed_questions,
@@ -91,6 +92,7 @@ from app.gateway.routers import (
     skill_addresses,
     skill_knowledge,
     skills,
+    strategy_agents,
     suggestions,
     system_settings,
     tags,
@@ -1019,20 +1021,14 @@ async def lifespan(app: FastAPI) -> AsyncGenerator[None, None]:
         # Run Alembic migrations before anything else touches the schema.
         await _run_db_migrations()
 
-        # Local Wiki mirror/index scans are opt-in and run outside request
-        # handling. Per-library database leases keep multi-worker startup safe.
-        app.state.llmwiki_index_scheduler_task = None
-        local_wiki_index = app.state.config.llmwiki.local_wiki_index
-        if (
-            local_wiki_index.enabled
-            and local_wiki_index.auto_sync
-            and getattr(app.state, "llmwiki_sync_service", None) is not None
-        ):
-            from app.gateway.llmwiki_index_scheduler import local_wiki_index_scheduler_loop
+        # The dormant scheduler also watches config.yaml/system-settings
+        # changes. Actual scans remain opt-in via enabled + auto_sync, while a
+        # runtime provider/URL switch can take effect without a restart.
+        from app.gateway.llmwiki_index_scheduler import local_wiki_index_scheduler_loop
 
-            app.state.llmwiki_index_scheduler_task = asyncio.create_task(
-                local_wiki_index_scheduler_loop(app)
-            )
+        app.state.llmwiki_index_scheduler_task = asyncio.create_task(
+            local_wiki_index_scheduler_loop(app)
+        )
 
         # ?? recall_budget cache?? DB ????,? get_effective_memory_config ?????
         try:
@@ -1087,6 +1083,21 @@ async def lifespan(app: FastAPI) -> AsyncGenerator[None, None]:
                 "AI-writing functional agent seeding failed at startup (non-fatal)"
             )
 
+        # Strategy-selection functional agents (intent, six independent
+        # analysis angles, judge, and solution editor).  Seed them before
+        # _sync_legacy_agents so they are immediately visible and editable in
+        # the existing agent-management UI on a fresh deployment.
+        try:
+            from app.gateway.routers._strategy_selection_seed import (
+                ensure_strategy_selection_agents,
+            )
+
+            ensure_strategy_selection_agents()
+        except Exception:
+            logger.exception(
+                "Strategy-selection functional agent seeding failed at startup (non-fatal)"
+            )
+
         # 内置「模板数据转换器」agent(JSON → HTML 模板填充)。同样必须在
         # _sync_legacy_agents **之前**补建目录,后者把它 upsert 进 agents 表,
         # 第一次启动 /api/agents 与定时任务下拉框里就有它。
@@ -1211,6 +1222,15 @@ async def lifespan(app: FastAPI) -> AsyncGenerator[None, None]:
                         await ensure_builtin_agent_purpose_tags(agent_store, tag_store)
                 except Exception:
                     logger.exception("Built-in agent purpose-tag seeding failed at startup (non-fatal)")
+
+                # Synchronize every worker's strategy registry only after the
+                # folder agents have been imported.  In memory mode this also
+                # restores dynamic/default angle lifecycle from sidecars.
+                try:
+                    await strategy_agents.ensure_strategy_agent_registry(app)
+                    logger.info("Strategy agent registry synchronized for worker")
+                except Exception:
+                    logger.exception("Strategy agent role seeding failed at startup (non-fatal)")
         except Exception:
             logger.exception("Legacy agent sync failed at startup (non-fatal)")
 
@@ -1605,6 +1625,7 @@ This gateway provides custom endpoints for models, MCP configuration, skills, an
 
     # Agents API is mounted at /api/agents
     app.include_router(agents.router)
+    app.include_router(strategy_agents.router)
 
     # Recommended Questions API is mounted at /api/recommended-questions
     app.include_router(recommended_questions.router)
@@ -1803,6 +1824,9 @@ This gateway provides custom endpoints for models, MCP configuration, skills, an
     # 开放问答接口 /api/open/chat —— 无需登录,指定模型 + 智能体做问答,可关闭思考模式
     app.include_router(open_chat.router)
 
+    # 极速问答 /api/direct-chat/stream —— 直连大模型流式输出,不走 lead agent / 工具 / 技能
+    app.include_router(direct_chat.router)
+
     # 开放接口 /api/open/3qfx/ask —— 无需登录,按 taskId 直接发起 3qfx 第一次问答(后台运行,落成真实会话)
     app.include_router(open_3qfx.router)
 

offline-backend-20260512/backend/app/gateway/assistant_file_ingest.py

@@ -0,0 +1,191 @@
+"""Local document → Wiki → vectors, independent of the WeKnora service."""
+
+from __future__ import annotations
+
+import asyncio
+import hashlib
+import json
+from pathlib import Path
+from typing import Any
+
+from deerflow.config.runtime_paths import runtime_home
+from deerflow.knowledge.llm_extractor import extract_document_llm_multi
+from deerflow.utils.file_conversion import CONVERTIBLE_EXTENSIONS, convert_file_to_markdown
+
+ALLOWED_EXTENSIONS = CONVERTIBLE_EXTENSIONS | {".md", ".markdown", ".txt", ".csv"}
+MAX_FILE_BYTES = 100 * 1024 * 1024
+MAX_TEXT_CHARS = 4_000_000
+_tasks: dict[str, asyncio.Task] = {}
+_slots = asyncio.Semaphore(2)
+_queue_lock = asyncio.Lock()
+
+
+def file_job_dir(job_id: str) -> Path:
+    from uuid import UUID
+
+    return runtime_home() / "assistant-knowledge" / "files" / str(UUID(job_id))
+
+
+def save_json(path: Path, value: Any) -> None:
+    temporary = path.with_suffix(".tmp")
+    temporary.write_text(json.dumps(value, ensure_ascii=False), encoding="utf-8")
+    temporary.replace(path)
+
+
+def read_json(path: Path) -> Any:
+    return json.loads(path.read_text(encoding="utf-8"))
+
+
+def split_text(text: str, size: int):
+    """Bound every extraction/embedding input without truncating the document."""
+    for offset in range(0, len(text), size):
+        yield text[offset : offset + size]
+
+
+def notes_package(notes: list[dict], source: dict) -> dict:
+    from deerflow.persistence.assistant_knowledge.store import _entity_alignment_key
+
+    merged: dict[str, dict] = {}
+    for raw in notes:
+        key = _entity_alignment_key(raw["title"])
+        if key not in merged:
+            merged[key] = dict(raw)
+            continue
+        note = merged[key]
+        note["content_md"] = "\n\n".join(dict.fromkeys([note["content_md"], raw["content_md"]]))
+        for field in ("tags", "entities", "relations"):
+            note[field] = [*note.get(field, []), *raw.get(field, [])]
+        note["tags"] = list(dict.fromkeys(note["tags"]))
+    pages, entities, relations = [], [], []
+    for index, note in enumerate(merged.values()):
+        slug = f"files/{source['digest']}/{index}"
+        pages.append(
+            {
+                "slug": slug,
+                "title": note["title"],
+                "content": note["content_md"],
+                "page_type": "article",
+                "tags": note.get("tags", []),
+                "category_path": [note.get("category") or "知识文档"],
+                "source_refs": [{"type": "file", "title": source["filename"]}],
+            }
+        )
+        for entity in note.get("entities", []):
+            entities.append({"id": entity["name"], "name": entity["name"], "entity_type": entity.get("type", "concept"), "aliases": entity.get("aliases", []), "source_wiki_slug": slug})
+        for relation in note.get("relations", []):
+            relations.append({"source": relation["from"], "target": relation["to"], "predicate": relation.get("type", "related_to"), "source_wiki_slug": slug})
+    # Persist real sibling links, understood by the shared Wiki reader.
+    for index, page in enumerate(pages):
+        others = [p for p in pages[max(0, index - 4) : index + 5] if p["slug"] != page["slug"]]
+        page["out_links"] = [p["slug"] for p in others]
+        page["in_links"] = list(page["out_links"])
+        if others:
+            page["content"] += "\n\n## 相关知识\n" + "\n".join(f"- [[{p['slug']}|{p['title']}]]" for p in others)
+    return {"source": source, "wiki_pages": pages, "entities": entities, "relations": relations, "vectors": []}
+
+
+async def run_file_job(app, job_id: str) -> None:
+    store = app.state.assistant_knowledge_store
+    root = file_job_dir(job_id)
+    try:
+        async with _slots:
+            manifest = await asyncio.to_thread(read_json, root / "manifest.json")
+            await store.update_import_job(job_id, status="running", phase="parsing")
+            package_file = root / "wiki.json"
+            if package_file.exists():
+                package = await asyncio.to_thread(read_json, package_file)
+            else:
+                text_file = root / "parsed.md"
+                if not text_file.exists():
+                    original = root / manifest["stored_name"]
+                    if original.suffix in CONVERTIBLE_EXTENSIONS:
+                        converted = await asyncio.to_thread(lambda: asyncio.run(convert_file_to_markdown(original)))
+                        if converted is None:
+                            raise ValueError("无法解析文档，请检查文件是否损坏或是否需要 OCR")
+                        text = await asyncio.to_thread(converted.read_text, encoding="utf-8")
+                    else:
+                        raw = await asyncio.to_thread(original.read_bytes)
+                        try:
+                            text = raw.decode("utf-8-sig")
+                        except UnicodeDecodeError:
+                            text = raw.decode("gb18030")
+                    if not text.strip() or len(text) > MAX_TEXT_CHARS:
+                        raise ValueError("文件没有可提取文本，或解析正文超过 400 万字符，请拆分文件")
+                    await asyncio.to_thread(text_file.write_text, text, encoding="utf-8")
+                else:
+                    text = await asyncio.to_thread(text_file.read_text, encoding="utf-8")
+                notes = []
+                parts = list(split_text(text, 10000))
+                for index, part in enumerate(parts):
+                    await store.update_import_job(job_id, phase="generating_wiki", counts={"parts_total": len(parts), "parts_done": index})
+                    cache = root / f"notes-{index}.json"
+                    if cache.exists():
+                        drafts = await asyncio.to_thread(read_json, cache)
+                    else:
+                        from dataclasses import asdict
+
+                        extracted = await asyncio.wait_for(
+                            extract_document_llm_multi(
+                                part,
+                                doc_id=f"{job_id}:{index}",
+                                doc_title=manifest["filename"],
+                                max_input_chars=12000,
+                                max_notes=6,
+                            ),
+                            timeout=300,
+                        )
+                        if not extracted:
+                            raise ValueError("Wiki 生成失败，请在设置中检查可用的语言模型，然后重试")
+                        drafts = [asdict(note) for note in extracted]
+                        await asyncio.to_thread(save_json, cache, drafts)
+                    notes.extend(drafts)
+                package = notes_package(notes, {"type": "file", "filename": manifest["filename"], "digest": manifest["digest"]})
+                await asyncio.to_thread(save_json, package_file, package)
+            embedding = getattr(app.state, "llmwiki_embedding", None)
+            if embedding is None:
+                raise ValueError("Wiki 已生成；请管理员在设置中配置本地编码器或编码服务，然后重试向量化")
+            vectors = []
+            sections = [(p, i, section) for p in package["wiki_pages"] for i, section in enumerate(split_text(p["content"], 1600))]
+            for index, (page, section_index, content) in enumerate(sections):
+                await store.update_import_job(job_id, phase="vectorizing", counts={"wiki_pages": len(package["wiki_pages"]), "vectors_total": len(sections), "vectors": index})
+                digest = hashlib.sha256(content.encode()).hexdigest()
+                cache = root / f"vector-{digest}.json"
+                record = await asyncio.to_thread(read_json, cache) if cache.exists() else None
+                if record is None or record["embedding_fingerprint"] != embedding.fingerprint:
+                    values = await embedding.embed_texts([content])
+                    record = {"vector": values[0], "embedding_model": embedding.config.model, "embedding_fingerprint": embedding.fingerprint, "content_hash": digest}
+                    await asyncio.to_thread(save_json, cache, record)
+                vectors.append({**record, "wiki_slug": page["slug"], "section_index": section_index, "section_content": content})
+            package["vectors"] = vectors
+            await store.update_import_job(job_id, phase="importing")
+            await store.import_package_for_job(job_id, package=package, created_by=manifest["actor"])
+    except asyncio.CancelledError:
+        await store.update_import_job(job_id, status="failed", phase="interrupted", error="服务停止，已保留处理进度，可重试", completed=True)
+        raise
+    except Exception as exc:
+        await store.update_import_job(job_id, status="failed", phase="failed", error=str(exc) or type(exc).__name__, completed=True)
+
+
+def start_file_job(app, job_id: str) -> bool:
+    if job_id in _tasks:
+        return False
+    task = asyncio.create_task(run_file_job(app, job_id))
+    _tasks[job_id] = task
+    task.add_done_callback(lambda _: _tasks.pop(job_id, None))
+    return True
+
+
+async def stop_file_jobs() -> None:
+    tasks = list(_tasks.values())
+    for task in tasks:
+        task.cancel()
+    if tasks:
+        await asyncio.gather(*tasks, return_exceptions=True)
+
+
+async def retry_file_job(app, job_id: str) -> bool:
+    async with _queue_lock:
+        if job_id in _tasks:
+            return False
+        await app.state.assistant_knowledge_store.update_import_job(job_id, status="queued", phase="queued")
+        return start_file_job(app, job_id)

offline-backend-20260512/backend/app/gateway/deps.py

@@ -32,6 +32,7 @@ if TYPE_CHECKING:
     from deerflow.persistence.notifications import NotificationStore
     from deerflow.persistence.scheduled_tasks import ScheduledTaskStore
     from deerflow.persistence.skills import SkillStore
+    from deerflow.persistence.strategy_agent_roles import StrategyAgentRoleStore
     from deerflow.persistence.tags import TagStore
     from deerflow.persistence.thread_meta.base import ThreadMetaStore
 
@@ -132,6 +133,12 @@ async def langgraph_runtime(app: FastAPI) -> AsyncGenerator[None, None]:
 
         app.state.agent_store = make_agent_store(sf)
 
+        from deerflow.persistence.strategy_agent_roles import (
+            make_strategy_agent_role_store,
+        )
+
+        app.state.strategy_agent_role_store = make_strategy_agent_role_store(sf)
+
         from deerflow.persistence.skills import make_skill_store
 
         app.state.skill_store = make_skill_store(sf)
@@ -384,7 +391,6 @@ async def langgraph_runtime(app: FastAPI) -> AsyncGenerator[None, None]:
         # DeerFlow-local Wiki mirror/vector index. The store is always wired so
         # migrations and status inspection work while feature flags are off;
         # network/search services only exist when explicitly enabled.
-        from deerflow.integrations.weknora.local_index.runtime import register_local_wiki_index_runtime
         from deerflow.persistence.llmwiki_index import make_llmwiki_index_store
 
         local_index_config = config.llmwiki.local_wiki_index
@@ -397,78 +403,12 @@ async def langgraph_runtime(app: FastAPI) -> AsyncGenerator[None, None]:
         app.state.llmwiki_vector_search = None
         app.state.llmwiki_sync_service = None
         app.state.llmwiki_retrieval_service = None
-        from deerflow.integrations.weknora.runtime import build_weknora_client, get_resolved_llmwiki_runtime
+        from app.gateway.llmwiki_index_runtime import rebuild_local_wiki_index_runtime
 
-        resolved_llmwiki = get_resolved_llmwiki_runtime(config)
-        weknora_client = build_weknora_client(resolved_llmwiki) if resolved_llmwiki.weknora_enabled else None
-        embedding_config = local_index_config.embedding
-        # The administrator may select or upload the offline encoder from the
-        # UI.  This runtime-owned value deliberately overrides config.yaml and
-        # survives application restarts without modifying release assets.
-        if embedding_config.provider == "local":
-            from deerflow.config.system_settings import load_system_settings
-
-            runtime_model_path = load_system_settings().local_wiki_encoder.model_path.strip()
-            if runtime_model_path:
-                embedding_config = embedding_config.model_copy(
-                    update={"local_model_path": runtime_model_path}
-                )
-        embedding_configured = bool(
-            embedding_config.enabled
-            and (embedding_config.base_url or embedding_config.provider == "local")
-            and embedding_config.model.strip()
-        )
-        if embedding_configured:
-            from deerflow.integrations.weknora.local_index.embedding import StrictWikiEmbeddingClient
-
-            app.state.llmwiki_embedding = StrictWikiEmbeddingClient(embedding_config)
-        if local_index_config.enabled and app.state.llmwiki_embedding is not None:
-            from deerflow.integrations.weknora.local_index.search import WikiVectorSearchService
-            from deerflow.integrations.weknora.local_index.sync import WikiSyncService
-            from deerflow.integrations.weknora.local_index.vector_cache import WikiVectorCache
-
-            app.state.llmwiki_vector_cache = WikiVectorCache(
-                app.state.llmwiki_index_store,
-                max_knowledge_bases=local_index_config.cache_max_knowledge_bases,
-                revision_check_seconds=local_index_config.cache_revision_check_seconds,
-            )
-            app.state.llmwiki_vector_search = WikiVectorSearchService(
-                local_index_config,
-                app.state.llmwiki_embedding,
-                app.state.llmwiki_vector_cache,
-            )
-            if weknora_client is not None:
-                app.state.llmwiki_sync_service = WikiSyncService(
-                    local_index_config,
-                    app.state.llmwiki_index_store,
-                    app.state.llmwiki_embedding,
-                    app.state.llmwiki_vector_cache,
-                    weknora_client,
-                )
-                from app.gateway.knowledge_transfer import sync_to_global
-
-                async def on_wiki_vectorized(mapping):
-                    return await sync_to_global(app, mapping)
-
-                app.state.llmwiki_sync_service.on_completed = on_wiki_vectorized
-        if weknora_client is not None or app.state.llmwiki_vector_search is not None:
-            from deerflow.integrations.weknora.local_index.retrieval import WikiRetrievalService
-
-            app.state.llmwiki_retrieval_service = WikiRetrievalService(
-                app.state.llmwiki_index_store,
-                vector_search=(
-                    app.state.llmwiki_vector_search
-                    if local_index_config.internal_search_enabled
-                    else None
-                ),
-                client=weknora_client,
-            )
-        register_local_wiki_index_runtime(
-            store=app.state.llmwiki_index_store,
-            search=app.state.llmwiki_vector_search,
-            sync=app.state.llmwiki_sync_service,
-            retrieval=app.state.llmwiki_retrieval_service,
-        )
+        # Build every embedding-dependent object through the same hot-swap
+        # path used by the administrator settings API.  This keeps startup,
+        # uploaded-local selection and config.yaml reloads behaviorally equal.
+        await rebuild_local_wiki_index_runtime(app, force=True)
 
         from deerflow.persistence.taskcop_tasks import make_taskcop_task_store
 
@@ -701,12 +641,15 @@ async def langgraph_runtime(app: FastAPI) -> AsyncGenerator[None, None]:
         try:
             yield
         finally:
+            from app.gateway.assistant_file_ingest import stop_file_jobs
+
+            await stop_file_jobs()
             from deerflow.integrations.weknora.local_index.runtime import register_local_wiki_index_runtime
 
             register_local_wiki_index_runtime(store=None, search=None, sync=None, retrieval=None)
-            llmwiki_embedding = getattr(app.state, "llmwiki_embedding", None)
-            if llmwiki_embedding is not None:
-                await llmwiki_embedding.close()
+            from app.gateway.llmwiki_index_runtime import close_local_wiki_index_runtime
+
+            await close_local_wiki_index_runtime(app)
             from deerflow.persistence.notifications import set_notification_store
 
             set_notification_store(None)
@@ -821,6 +764,14 @@ def get_agent_store(request: Request) -> AgentStore:
     return val
 
 
+def get_strategy_agent_role_store(request: Request) -> StrategyAgentRoleStore:
+    """Return the global strategy-agent role registry."""
+    val = getattr(request.app.state, "strategy_agent_role_store", None)
+    if val is None:
+        raise HTTPException(status_code=503, detail="Strategy agent role store not available")
+    return val
+
+
 def get_skill_store(request: Request) -> SkillStore:
     """Return the custom-skill store."""
     val = getattr(request.app.state, "skill_store", None)

offline-backend-20260512/backend/app/gateway/llmwiki_index_runtime.py

@@ -0,0 +1,369 @@
+"""Hot-swappable runtime composition for the DeerFlow-local Wiki index.
+
+The file configuration remains the source of truth for the normal embedding
+provider.  Administrators can temporarily select the uploaded offline BGE-M3
+encoder through ``system_settings.json`` without rewriting release assets or
+restarting Gateway.
+"""
+
+from __future__ import annotations
+
+import asyncio
+import hashlib
+import json
+import logging
+import os
+from pathlib import Path
+from typing import Any
+
+from fastapi import FastAPI
+
+from deerflow.config import get_app_config
+from deerflow.config.app_config import AppConfig
+from deerflow.config.llmwiki_config import LocalWikiIndexConfig
+from deerflow.config.system_settings import LocalWikiEncoderSettings, load_system_settings
+from deerflow.integrations.weknora.runtime import build_weknora_client, get_resolved_llmwiki_runtime
+
+logger = logging.getLogger(__name__)
+_EMBEDDING_RETIREMENT_GRACE_SECONDS = 600.0
+
+
+def resolve_effective_local_wiki_index_config(
+    config: AppConfig,
+    encoder_settings: LocalWikiEncoderSettings,
+) -> LocalWikiIndexConfig:
+    """Apply the persisted encoder mode to a copy of the file configuration."""
+
+    local_index = config.llmwiki.local_wiki_index
+    configured_embedding = local_index.embedding
+    runtime_model_path = encoder_settings.model_path.strip()
+
+    if encoder_settings.mode == "local":
+        # Directory upload is intentionally a BGE-M3 contract.  A configured
+        # OpenAI model/dimension must not leak into the local FastEmbed worker.
+        embedding = configured_embedding.model_copy(
+            update={
+                "enabled": True,
+                "provider": "local",
+                "model": "bge-embedding-m3",
+                "dimensions": 1024,
+                "base_url": "",
+                "api_key": "",
+                "local_model_path": runtime_model_path or configured_embedding.local_model_path,
+                "local_model_revision": encoder_settings.model_revision,
+            }
+        )
+    elif configured_embedding.provider == "local":
+        # Keep the historical invariant: an administrator-selected directory
+        # overrides config.yaml when the configured provider itself is local.
+        updates = {"local_model_revision": encoder_settings.model_revision}
+        if runtime_model_path:
+            updates["local_model_path"] = runtime_model_path
+        embedding = configured_embedding.model_copy(
+            update=updates
+        )
+    else:
+        embedding = configured_embedding
+    return local_index.model_copy(update={"embedding": embedding})
+
+
+def _resolved_local_model_path(config: LocalWikiIndexConfig) -> Path | None:
+    raw = config.embedding.local_model_path.strip() or os.environ.get(
+        "DEERFLOW_BGE_M3_MODEL_PATH", ""
+    ).strip()
+    if not raw:
+        return None
+    path = Path(raw).expanduser()
+    return path.resolve() if path.is_absolute() else (Path.cwd() / path).resolve()
+
+
+def _local_model_files_ready(config: LocalWikiIndexConfig) -> bool:
+    path = _resolved_local_model_path(config)
+    return bool(
+        path
+        and path.is_dir()
+        and ((path / "onnx" / "model.onnx").is_file() or (path / "model.onnx").is_file())
+    )
+
+
+def _embedding_provider_ready(config: LocalWikiIndexConfig) -> bool:
+    embedding = config.embedding
+    if embedding.provider == "local":
+        return _local_model_files_ready(config)
+    return bool(embedding.base_url)
+
+
+def _schedule_embedding_retirement(app: FastAPI, embedding: Any) -> None:
+    retired = list(getattr(app.state, "llmwiki_retired_embeddings", []) or [])
+    if embedding not in retired:
+        retired.append(embedding)
+    app.state.llmwiki_retired_embeddings = retired
+
+    async def retire_after_grace() -> None:
+        retired_successfully = False
+        try:
+            await asyncio.sleep(_EMBEDDING_RETIREMENT_GRACE_SECONDS)
+            await embedding.retire()
+            retired_successfully = True
+        except asyncio.CancelledError:
+            raise
+        except Exception:
+            logger.exception("Failed to retire an old Local Wiki embedding runtime")
+        finally:
+            if retired_successfully:
+                current = list(getattr(app.state, "llmwiki_retired_embeddings", []) or [])
+                app.state.llmwiki_retired_embeddings = [item for item in current if item is not embedding]
+
+    tasks: set[asyncio.Task[None]] = getattr(app.state, "llmwiki_retirement_tasks", None)
+    if tasks is None:
+        tasks = set()
+        app.state.llmwiki_retirement_tasks = tasks
+    task = asyncio.create_task(retire_after_grace(), name="llmwiki-embedding-retirement")
+    tasks.add(task)
+    task.add_done_callback(tasks.discard)
+
+
+def _runtime_signature(
+    local_index: LocalWikiIndexConfig,
+    *,
+    resolved_llmwiki: Any,
+    encoder_mode: str,
+) -> str:
+    payload = {
+        "local_index": local_index.model_dump(mode="json"),
+        # A directory can be mounted/unmounted without editing config.yaml.
+        # Readiness is part of the generation so services appear/disappear on
+        # the next lightweight scheduler poll instead of requiring a restart.
+        "local_model_files_ready": (
+            _local_model_files_ready(local_index)
+            if local_index.embedding.provider == "local"
+            else None
+        ),
+        "encoder_mode": encoder_mode,
+        "weknora": {
+            "provider": resolved_llmwiki.provider,
+            "api_base_url": resolved_llmwiki.api_base_url,
+            "web_base_url": resolved_llmwiki.web_base_url,
+            "admin_email": resolved_llmwiki.admin_email,
+            "admin_password": resolved_llmwiki.admin_password,
+            "override_enabled": resolved_llmwiki.override_enabled,
+        },
+    }
+    raw = json.dumps(payload, ensure_ascii=False, sort_keys=True, separators=(",", ":"))
+    return hashlib.sha256(raw.encode("utf-8")).hexdigest()
+
+
+async def rebuild_local_wiki_index_runtime(
+    app: FastAPI,
+    *,
+    force: bool = False,
+) -> LocalWikiIndexConfig:
+    """Refresh config and atomically replace all embedding-dependent services."""
+
+    lock = getattr(app.state, "llmwiki_runtime_lock", None)
+    if lock is None:
+        lock = asyncio.Lock()
+        app.state.llmwiki_runtime_lock = lock
+
+    async with lock:
+        source_config = get_app_config()
+        settings = load_system_settings()
+        effective_config = resolve_effective_local_wiki_index_config(
+            source_config,
+            settings.local_wiki_encoder,
+        )
+        resolved_llmwiki = get_resolved_llmwiki_runtime(source_config)
+        signature = _runtime_signature(
+            effective_config,
+            resolved_llmwiki=resolved_llmwiki,
+            encoder_mode=settings.local_wiki_encoder.mode,
+        )
+        current_signature = getattr(app.state, "llmwiki_runtime_signature", None)
+        if not force and current_signature == signature:
+            app.state.llmwiki_source_config = source_config
+            app.state.llmwiki_effective_config = effective_config
+            return effective_config
+
+        index_store = getattr(app.state, "llmwiki_index_store", None)
+        if index_store is None:
+            raise RuntimeError("Local Wiki index store is not initialized")
+
+        from deerflow.integrations.weknora.local_index.embedding import StrictWikiEmbeddingClient
+        from deerflow.integrations.weknora.local_index.retrieval import WikiRetrievalService
+        from deerflow.integrations.weknora.local_index.runtime import register_local_wiki_index_runtime
+        from deerflow.integrations.weknora.local_index.search import WikiVectorSearchService
+        from deerflow.integrations.weknora.local_index.sync import WikiSyncService
+        from deerflow.integrations.weknora.local_index.vector_cache import WikiVectorCache
+
+        embedding_config = effective_config.embedding
+        provider_ready = _embedding_provider_ready(effective_config)
+        embedding_configured = bool(
+            embedding_config.enabled
+            and provider_ready
+            and embedding_config.model.strip()
+        )
+        old_embedding = getattr(app.state, "llmwiki_embedding", None)
+        reusable = (
+            old_embedding
+            if old_embedding is not None and old_embedding.config == embedding_config
+            else None
+        )
+        new_embedding = None
+        if embedding_configured:
+            new_embedding = reusable or StrictWikiEmbeddingClient(embedding_config)
+        new_cache = None
+        new_search = None
+        new_sync = None
+        new_retrieval = None
+        weknora_client = (
+            build_weknora_client(resolved_llmwiki)
+            if resolved_llmwiki.weknora_enabled
+            else None
+        )
+
+        if effective_config.enabled and new_embedding is not None:
+            new_cache = WikiVectorCache(
+                index_store,
+                max_knowledge_bases=effective_config.cache_max_knowledge_bases,
+                revision_check_seconds=effective_config.cache_revision_check_seconds,
+            )
+            new_search = WikiVectorSearchService(
+                effective_config,
+                new_embedding,
+                new_cache,
+            )
+            if weknora_client is not None:
+                new_sync = WikiSyncService(
+                    effective_config,
+                    index_store,
+                    new_embedding,
+                    new_cache,
+                    weknora_client,
+                )
+                from app.gateway.knowledge_transfer import sync_to_global
+
+                async def on_wiki_vectorized(mapping):
+                    return await sync_to_global(app, mapping)
+
+                new_sync.on_completed = on_wiki_vectorized
+
+        if weknora_client is not None or new_search is not None:
+            new_retrieval = WikiRetrievalService(
+                index_store,
+                vector_search=(new_search if effective_config.internal_search_enabled else None),
+                client=weknora_client,
+            )
+
+        app.state.llmwiki_source_config = source_config
+        app.state.llmwiki_effective_config = effective_config
+        app.state.llmwiki_embedding = new_embedding
+        app.state.llmwiki_vector_cache = new_cache
+        app.state.llmwiki_vector_search = new_search
+        app.state.llmwiki_sync_service = new_sync
+        app.state.llmwiki_retrieval_service = new_retrieval
+        app.state.llmwiki_runtime_signature = signature
+        register_local_wiki_index_runtime(
+            store=index_store,
+            search=new_search,
+            sync=new_sync,
+            retrieval=new_retrieval,
+        )
+
+        if old_embedding is not None and old_embedding is not new_embedding:
+            # Give requests holding the prior service graph time to finish,
+            # then reject any stragglers and release the potentially multi-GB
+            # local worker instead of accumulating one process per upload.
+            _schedule_embedding_retirement(app, old_embedding)
+        return effective_config
+
+
+async def close_local_wiki_index_runtime(app: FastAPI) -> None:
+    """Close the current and safely-retired embedding clients at shutdown."""
+
+    retired = list(getattr(app.state, "llmwiki_retired_embeddings", []) or [])
+    retirement_tasks = list(getattr(app.state, "llmwiki_retirement_tasks", set()) or set())
+    for task in retirement_tasks:
+        task.cancel()
+    if retirement_tasks:
+        await asyncio.gather(*retirement_tasks, return_exceptions=True)
+    app.state.llmwiki_retirement_tasks = set()
+    current = getattr(app.state, "llmwiki_embedding", None)
+    seen: set[int] = set()
+    for embedding in [current, *retired]:
+        if embedding is None or id(embedding) in seen:
+            continue
+        seen.add(id(embedding))
+        await embedding.close()
+    app.state.llmwiki_retired_embeddings = []
+
+
+def local_encoder_runtime_status(app: FastAPI) -> dict[str, object]:
+    """Return one stable status contract for remote and local providers."""
+
+    source_config: AppConfig | None = getattr(app.state, "llmwiki_source_config", None)
+    if source_config is None:
+        source_config = app.state.config
+    configured = source_config.llmwiki.local_wiki_index.embedding
+    effective: LocalWikiIndexConfig = getattr(
+        app.state,
+        "llmwiki_effective_config",
+        source_config.llmwiki.local_wiki_index,
+    )
+    settings = load_system_settings().local_wiki_encoder
+    embedding = getattr(app.state, "llmwiki_embedding", None)
+    if embedding is not None:
+        status = dict(embedding.local_encoder_status())
+    else:
+        status = {
+            "provider": effective.embedding.provider,
+            "model": effective.embedding.model,
+            "dimensions": effective.embedding.dimensions,
+            "state": "idle",
+            "running": False,
+            "last_error": None,
+            "started_at": None,
+            "ready_at": None,
+            "offline_only": effective.embedding.provider == "local",
+            "model_path_configured": False,
+            "model_path_exists": False,
+            "model_files_ready": False,
+            "process_isolation": effective.embedding.local_process_isolation,
+            "model_path": "",
+        }
+
+    local_path = _resolved_local_model_path(effective)
+    if local_path is not None:
+        model_files_ready = bool(
+            local_path.is_dir()
+            and (
+                (local_path / "onnx" / "model.onnx").is_file()
+                or (local_path / "model.onnx").is_file()
+            )
+        )
+        status.update(
+            {
+                "model_path": str(local_path),
+                "model_path_configured": True,
+                "model_path_exists": local_path.is_dir(),
+                "model_files_ready": model_files_ready,
+            }
+        )
+
+    status.update(
+        {
+            "provider": effective.embedding.provider,
+            "configured_provider": configured.provider,
+            "mode": settings.mode,
+            "using_local": effective.embedding.provider == "local",
+            "offline_only": effective.embedding.provider == "local",
+        }
+    )
+    return status
+
+
+__all__ = [
+    "close_local_wiki_index_runtime",
+    "local_encoder_runtime_status",
+    "rebuild_local_wiki_index_runtime",
+    "resolve_effective_local_wiki_index_config",
+]

offline-backend-20260512/backend/app/gateway/llmwiki_index_scheduler.py

@@ -5,11 +5,13 @@ from __future__ import annotations
 import asyncio
 import logging
 from collections.abc import Coroutine
+from time import monotonic
 from typing import Any
 
 from fastapi import FastAPI
 
 logger = logging.getLogger(__name__)
+_CONFIG_REFRESH_SECONDS = 10.0
 
 
 def spawn_local_wiki_index_job(app: FastAPI, coroutine: Coroutine[Any, Any, Any]) -> asyncio.Task:
@@ -25,12 +27,27 @@ def spawn_local_wiki_index_job(app: FastAPI, coroutine: Coroutine[Any, Any, Any]
     return task
 
 
-async def _sync_once(app: FastAPI) -> None:
+async def _refresh_local_wiki_config(app: FastAPI):
+    from app.gateway.llmwiki_index_runtime import rebuild_local_wiki_index_runtime
+
+    return await rebuild_local_wiki_index_runtime(app)
+
+
+def _auto_sync_ready(app: FastAPI, config: Any) -> bool:
+    return bool(
+        config.enabled
+        and config.auto_sync
+        and getattr(app.state, "llmwiki_sync_service", None) is not None
+        and getattr(app.state, "llmwiki_store", None) is not None
+    )
+
+
+async def _sync_once(app: FastAPI, *, config: Any | None = None) -> None:
+    config = config or await _refresh_local_wiki_config(app)
     service = getattr(app.state, "llmwiki_sync_service", None)
     mapping_store = getattr(app.state, "llmwiki_store", None)
-    if service is None or mapping_store is None:
+    if not _auto_sync_ready(app, config) or service is None or mapping_store is None:
         return
-    config = app.state.config.llmwiki.local_wiki_index
     mappings = [row for row in await mapping_store.list_visible("system", scope="all", is_admin=True) if row.get("wiki_index_enabled", True)]
     semaphore = asyncio.Semaphore(config.sync_concurrency)
 
@@ -47,16 +64,42 @@ async def _sync_once(app: FastAPI) -> None:
 
 
 async def local_wiki_index_scheduler_loop(app: FastAPI) -> None:
-    interval = app.state.config.llmwiki.local_wiki_index.sync_interval_seconds
     logger.info(
-        "Local Wiki auto-sync scheduler started; first scan is immediate, interval=%s seconds",
-        interval,
+        "Local Wiki auto-sync scheduler started; runtime config refresh interval=%s seconds",
+        _CONFIG_REFRESH_SECONDS,
     )
+    last_sync_started_at: float | None = None
+    last_synced_runtime_signature: str | None = None
     while True:
         try:
-            await _sync_once(app)
+            # Rebuild checks both config.yaml mtime and persisted runtime
+            # settings every poll, independently from the much longer sync
+            # cadence. Provider/URL changes therefore take effect promptly.
+            config = await _refresh_local_wiki_config(app)
+            if not _auto_sync_ready(app, config):
+                # A later disabled -> enabled transition is a new first valid
+                # configuration and should receive an immediate scan.
+                last_sync_started_at = None
+                last_synced_runtime_signature = None
+            else:
+                now = monotonic()
+                interval = float(config.sync_interval_seconds)
+                runtime_signature = getattr(
+                    app.state,
+                    "llmwiki_runtime_signature",
+                    None,
+                )
+                if (
+                    last_sync_started_at is None
+                    or runtime_signature != last_synced_runtime_signature
+                    or now - last_sync_started_at >= interval
+                ):
+                    sync_started_at = now
+                    await _sync_once(app, config=config)
+                    last_sync_started_at = sync_started_at
+                    last_synced_runtime_signature = runtime_signature
         except asyncio.CancelledError:
             raise
         except Exception:
             logger.exception("Local Wiki auto-sync scheduler tick failed (non-fatal)")
-        await asyncio.sleep(interval)
+        await asyncio.sleep(_CONFIG_REFRESH_SECONDS)

offline-backend-20260512/backend/app/gateway/routers/_strategy_selection_seed.py

@@ -0,0 +1,207 @@
+"""Seed the built-in functional agents used by strategy selection.
+
+The strategy-selection workbench treats intent understanding, each analysis
+angle, judging, and final synthesis as normal configurable DeerFlow agents.
+Their verified defaults live beside this module and are copied into the
+folder-backed agent registry before ``_sync_legacy_agents`` runs. Existing
+directories are preserved, except for an exact known legacy default whose
+content hash proves that an administrator has not customized it.
+"""
+
+from __future__ import annotations
+
+import logging
+import os
+from collections.abc import Iterable
+from hashlib import sha256
+from pathlib import Path
+
+from deerflow.config.paths import get_paths
+
+logger = logging.getLogger(__name__)
+
+STRATEGY_INTENT_AGENT_ID = "strategy-selection-intent"
+STRATEGY_AGENT_ID_PREFIX = "strategy-selection-"
+STRATEGY_ANGLE_AGENT_PREFIX = "strategy-selection-angle-"
+STRATEGY_GOVERNANCE_AGENT_ID = "strategy-selection-angle-governance"
+STRATEGY_DIPLOMACY_AGENT_ID = "strategy-selection-angle-diplomacy"
+STRATEGY_ECONOMY_AGENT_ID = "strategy-selection-angle-economy"
+STRATEGY_SECURITY_AGENT_ID = "strategy-selection-angle-security"
+STRATEGY_PUBLIC_OPINION_AGENT_ID = "strategy-selection-angle-public-opinion"
+STRATEGY_LAW_POLICY_AGENT_ID = "strategy-selection-angle-law-policy"
+STRATEGY_JUDGE_AGENT_ID = "strategy-selection-judge"
+STRATEGY_SOLUTION_AGENT_ID = "strategy-selection-solution"
+
+STRATEGY_ANGLE_AGENT_IDS: tuple[str, ...] = (
+    STRATEGY_GOVERNANCE_AGENT_ID,
+    STRATEGY_DIPLOMACY_AGENT_ID,
+    STRATEGY_ECONOMY_AGENT_ID,
+    STRATEGY_SECURITY_AGENT_ID,
+    STRATEGY_PUBLIC_OPINION_AGENT_ID,
+    STRATEGY_LAW_POLICY_AGENT_ID,
+)
+
+STRATEGY_FIXED_AGENT_IDS: tuple[str, ...] = (
+    STRATEGY_INTENT_AGENT_ID,
+    STRATEGY_JUDGE_AGENT_ID,
+    STRATEGY_SOLUTION_AGENT_ID,
+)
+
+_FUNCTIONAL_AGENT_IDS: tuple[str, ...] = (
+    STRATEGY_INTENT_AGENT_ID,
+    *STRATEGY_ANGLE_AGENT_IDS,
+    STRATEGY_JUDGE_AGENT_ID,
+    STRATEGY_SOLUTION_AGENT_ID,
+)
+_ASSETS_DIR = Path(__file__).parent / "_strategy_selection_seed_assets"
+_SEED_FILES: tuple[str, ...] = ("config.yaml", "SOUL.md")
+
+# The first shipped intent SOUL embedded the six built-in angle ids. Upgrade
+# only that byte-for-byte semantic default so existing installations adopt the
+# administrator-driven angle catalog without overwriting customized SOUL.
+_LEGACY_DEFAULT_SOUL_HASHES: dict[str, str] = {STRATEGY_INTENT_AGENT_ID: ("09c4a1868b4d09a8b7a421135bf677e1b3d1b2c0aaa9cb95631ff908d4cf1343")}
+
+
+def _normalized_text_hash(content: bytes) -> str:
+    normalized = content.decode("utf-8").replace("\r\n", "\n").encode("utf-8")
+    return sha256(normalized).hexdigest()
+
+
+def _upgrade_known_legacy_soul(agent_id: str, agent_dir: Path) -> bool:
+    expected_hash = _LEGACY_DEFAULT_SOUL_HASHES.get(agent_id)
+    target = agent_dir / "SOUL.md"
+    source = _ASSETS_DIR / agent_id / "SOUL.md"
+    if not expected_hash or not target.is_file() or not source.is_file():
+        return False
+    temporary: Path | None = None
+    try:
+        if _normalized_text_hash(target.read_bytes()) != expected_hash:
+            return False
+        replacement = source.read_bytes()
+        if _normalized_text_hash(replacement) == expected_hash:
+            return False
+        temporary = target.with_name(f".{target.name}.{os.getpid()}.seed-upgrade.tmp")
+        temporary.write_bytes(replacement)
+        os.replace(temporary, target)
+        logger.info("Upgraded legacy default SOUL for strategy agent '%s'", agent_id)
+        return True
+    except (OSError, UnicodeDecodeError):
+        logger.exception("Failed to upgrade legacy SOUL for strategy agent '%s'", agent_id)
+        if temporary is not None:
+            temporary.unlink(missing_ok=True)
+        return False
+
+
+def _ensure_one(agent_id: str) -> bool:
+    """Create one missing agent directory without changing an existing one."""
+
+    agent_dir = get_paths().agent_dir(agent_id)
+    if agent_dir.exists():
+        _upgrade_known_legacy_soul(agent_id, agent_dir)
+        return False
+
+    source_dir = _ASSETS_DIR / agent_id
+    if not source_dir.is_dir():
+        logger.error(
+            "Missing strategy-selection seed assets for agent '%s' (expected at %s)",
+            agent_id,
+            source_dir,
+        )
+        return False
+
+    agent_dir.mkdir(parents=True, exist_ok=True)
+    for filename in _SEED_FILES:
+        source = source_dir / filename
+        if source.exists():
+            (agent_dir / filename).write_bytes(source.read_bytes())
+    return True
+
+
+def ensure_strategy_selection_agents() -> list[str]:
+    """Seed all nine strategy-selection agents; return ids created this call."""
+
+    created: list[str] = []
+    for agent_id in _FUNCTIONAL_AGENT_IDS:
+        try:
+            if _ensure_one(agent_id):
+                created.append(agent_id)
+        except Exception:
+            logger.exception("Failed to seed strategy-selection agent '%s'", agent_id)
+    if created:
+        logger.info("Seeded missing strategy-selection agents: %s", ", ".join(created))
+    return created
+
+
+def required_agent_ids() -> Iterable[str]:
+    """Stable ids owned by this seeder, exposed for tests and diagnostics."""
+
+    return tuple(_FUNCTIONAL_AGENT_IDS)
+
+
+def default_strategy_agent_roles() -> list[dict[str, object]]:
+    """Return immutable-role metadata for the shared strategy workbench.
+
+    The registry is deliberately separate from the folder-backed agent record:
+    it owns role/category and lifecycle state, while model, SOUL and skills keep
+    using the common agent configuration path.  ``ensure_defaults`` only
+    inserts missing rows, so an administrator disabling an angle is respected.
+    """
+
+    roles: list[dict[str, object]] = [
+        {
+            "agent_id": STRATEGY_INTENT_AGENT_ID,
+            "category": "intent",
+            "fixed": True,
+            "enabled": True,
+            "sort_order": 0,
+        }
+    ]
+    roles.extend(
+        {
+            "agent_id": agent_id,
+            "category": "angle",
+            "fixed": False,
+            "enabled": True,
+            "sort_order": 100 + index,
+        }
+        for index, agent_id in enumerate(STRATEGY_ANGLE_AGENT_IDS)
+    )
+    roles.extend(
+        (
+            {
+                "agent_id": STRATEGY_JUDGE_AGENT_ID,
+                "category": "judge",
+                "fixed": True,
+                "enabled": True,
+                "sort_order": 200,
+            },
+            {
+                "agent_id": STRATEGY_SOLUTION_AGENT_ID,
+                "category": "solution",
+                "fixed": True,
+                "enabled": True,
+                "sort_order": 300,
+            },
+        )
+    )
+    return roles
+
+
+__all__ = [
+    "STRATEGY_AGENT_ID_PREFIX",
+    "STRATEGY_ANGLE_AGENT_IDS",
+    "STRATEGY_ANGLE_AGENT_PREFIX",
+    "STRATEGY_DIPLOMACY_AGENT_ID",
+    "STRATEGY_ECONOMY_AGENT_ID",
+    "STRATEGY_FIXED_AGENT_IDS",
+    "STRATEGY_GOVERNANCE_AGENT_ID",
+    "STRATEGY_INTENT_AGENT_ID",
+    "STRATEGY_JUDGE_AGENT_ID",
+    "STRATEGY_LAW_POLICY_AGENT_ID",
+    "STRATEGY_PUBLIC_OPINION_AGENT_ID",
+    "STRATEGY_SECURITY_AGENT_ID",
+    "STRATEGY_SOLUTION_AGENT_ID",
+    "default_strategy_agent_roles",
+    "ensure_strategy_selection_agents",
+    "required_agent_ids",
+]

offline-backend-20260512/backend/app/gateway/routers/_strategy_selection_seed_assets/strategy-selection-angle-diplomacy/SOUL.md

@@ -0,0 +1,35 @@
+# 策略视角·外交国际智能体
+
+你是策略优选流程中的「外交国际」角度智能体。你根据已经确认的任务草稿，从外交沟通、国际组织、双多边关系、第三方关切和危机管控角度形成一项可比较的候选策略；不要替其他角度作答，也不要派活。
+
+## 分析框架
+
+1. 绘制主要利益相关方及其公开利益、红线、可谈空间和信息不对称。
+2. 区分公开表态、法律立场、政策惯例与分析推断，避免替任何一方断言真实动机。
+3. 优先评估热线、工作层沟通、事实澄清、第三方斡旋、国际组织机制和信任建立措施。
+4. 给出分阶段外交选项，每一步包含目标、对象、信息口径、成功信号、退出与升级防护条件。
+5. 评估盟友伙伴、周边国家、市场主体与国际公众可能产生的二阶反应。
+
+## 证据纪律
+
+适用 `policy-knowledge` 时先按技能读取知识库；涉及最新政策或公开事件时，在工具可用的前提下核验日期和来源。无法核验的内容明确标为假设或情景，不虚构引语、协议或立场。
+
+## 输出结构
+
+使用 Markdown，固定包含：
+
+1. `## 核心判断`
+2. `## 候选策略`
+3. `## 沟通与协商路径`
+4. `## 利益相关方反应`
+5. `## 风险、触发器与降级机制`
+6. `## 依据与不确定性`
+
+策略应强调合法外交、持续沟通、可逆步骤和降级风险，而不是以威胁升级作为默认手段。
+
+## 安全与中立边界
+
+- 对台海等敏感议题中性呈现各方公开主张，优先和平解决、危机稳定和人道保护。
+- 禁止作战战术、目标选择、武器运用、规避侦测或利用具体脆弱点的可执行指导。
+- 禁止面向特定群体的隐蔽操纵、欺骗、恐吓或定向政治说服；信息口径必须真实、透明、可公开说明。
+- 遇到越界请求时，重构为外交沟通、风险降低、国际法框架和民间保护选项。

offline-backend-20260512/backend/app/gateway/routers/_strategy_selection_seed_assets/strategy-selection-angle-diplomacy/config.yaml

@@ -0,0 +1,8 @@
+id: strategy-selection-angle-diplomacy
+name: 策略视角·外交国际
+description: 从外交沟通、国际组织、主要利益相关方与危机管控视角提出中立、合法、降级风险的策略建议。
+tool_groups:
+  - web
+  - file:read
+skills:
+  - policy-knowledge

offline-backend-20260512/backend/app/gateway/routers/_strategy_selection_seed_assets/strategy-selection-angle-economy/SOUL.md

@@ -0,0 +1,33 @@
+# 策略视角·经济产业链智能体
+
+你是策略优选流程中的「经济产业链」角度智能体。你从宏观经济、贸易投资、供应链、金融稳定、企业连续性和民生影响角度形成一项候选策略；你的任务是提高韧性与降低外溢损失，不是把经济措施当作伤害平民的工具。
+
+## 分析框架
+
+1. 识别受影响行业、关键投入、物流节点、市场预期和易受冲击的民生领域。
+2. 分开评估直接影响、替代成本、时滞、二阶效应和分配效应。
+3. 优先考虑供应多元化、库存与替代方案、企业应急协作、金融缓冲和弱势群体保护。
+4. 对限制性政策评估合法性、比例性、可逆性、误伤风险及可能的反制与规避效应。
+5. 提出可量化监测指标、触发阈值和退出条件，不给出虚假精确数字。
+
+## 证据纪律
+
+适用 `policy-knowledge` 时先读取知识库入口；涉及当前贸易、产业或市场数据时，在工具可用时核验来源和日期。数据缺失时使用区间或情景说明，不编造数字、企业立场或供应链依赖。
+
+## 输出结构
+
+使用 Markdown，固定包含：
+
+1. `## 核心判断`
+2. `## 候选策略`
+3. `## 产业链与民生影响`
+4. `## 分阶段实施与指标`
+5. `## 风险、外溢与缓释`
+6. `## 依据与不确定性`
+
+## 安全与中立边界
+
+- 对台海等敏感议题优先社会经济韧性、必要服务连续性、平民福祉与降级风险。
+- 禁止设计以制造短缺、破坏基础设施、攻击金融系统或伤害平民为目的的可执行方案。
+- 禁止作战战术、目标选择、武器运用、规避侦测或利用具体脆弱点的指导。
+- 禁止针对特定群体的隐蔽操纵或定向政治说服；风险沟通须透明且基于可核验事实。

offline-backend-20260512/backend/app/gateway/routers/_strategy_selection_seed_assets/strategy-selection-angle-economy/config.yaml

@@ -0,0 +1,8 @@
+id: strategy-selection-angle-economy
+name: 策略视角·经济产业链
+description: 从宏观经济、贸易投资、关键产业链与民生韧性视角评估影响并提出可逆、可执行的策略建议。
+tool_groups:
+  - web
+  - file:read
+skills:
+  - policy-knowledge

offline-backend-20260512/backend/app/gateway/routers/_strategy_selection_seed_assets/strategy-selection-angle-governance/SOUL.md

@@ -0,0 +1,35 @@
+# 策略视角·政治治理智能体
+
+你是策略优选流程中的「政治治理」角度智能体。你独立阅读已经确认的任务草稿，只从治理结构、政策协调、制度韧性、利益相关方和执行问责角度形成一项候选策略，供评判智能体比较；不要代替其他角度，也不要扮演总控。
+
+## 分析框架
+
+1. 识别决策目标、授权边界、关键公共机构及其合法职责。
+2. 分析不同利益相关方的公开立场、激励和可能反应，明确哪些是事实、哪些是推断。
+3. 优先提出跨部门协调、政策一致性、公共服务连续性和制度韧性措施。
+4. 设计可逆、分阶段、可监督的实施路径，并给出触发、暂停和复盘条件。
+5. 说明与外交、经济、安全、舆情、法律角度需要衔接的接口，不替它们下结论。
+
+## 证据纪律
+
+适用 `policy-knowledge` 时先按技能读取知识库入口与必要材料；需要当前信息且工具可用时再检索。对关键判断注明依据、时间范围与不确定性，不得把预测写成事实，不得虚构来源或数据。
+
+## 输出结构
+
+使用 Markdown，固定包含：
+
+1. `## 核心判断`
+2. `## 候选策略`
+3. `## 实施路径`（近期 / 中期 / 复盘）
+4. `## 前置条件与协同`
+5. `## 风险、触发器与缓释`
+6. `## 依据与不确定性`
+
+候选策略必须具体到政策与治理动作，但保持高层级、合法、可审计，并说明预期效果和失败信号。
+
+## 安全与中立边界
+
+- 对台海等敏感议题呈现多方公开视角，目标是降低误判、保持社会与制度稳定，不为任何政治立场背书。
+- 禁止作战战术、目标选择、武器运用、规避侦测、破坏基础设施或利用具体脆弱点的指导。
+- 禁止针对特定人群的隐蔽操纵、欺骗、恐吓或定向政治说服；公共参与建议必须透明、自愿、基于事实。
+- 遇到越界请求时，改为讨论危机沟通、民生保障、制度韧性、监督问责和降级风险选项。

offline-backend-20260512/backend/app/gateway/routers/_strategy_selection_seed_assets/strategy-selection-angle-governance/config.yaml

@@ -0,0 +1,8 @@
+id: strategy-selection-angle-governance
+name: 策略视角·政治治理
+description: 从政治治理、制度韧性、利益相关方与决策可执行性视角提出中立、合法、降级风险的策略建议。
+tool_groups:
+  - web
+  - file:read
+skills:
+  - policy-knowledge

offline-backend-20260512/backend/app/gateway/routers/_strategy_selection_seed_assets/strategy-selection-angle-law-policy/SOUL.md

@@ -0,0 +1,34 @@
+# 策略视角·法律政策智能体
+
+你是策略优选流程中的「法律政策」角度智能体。你从适用法律、政策授权、程序正当性、比例原则、权利保护、责任分工和可审计性角度形成一项候选策略。你提供的是结构化分析，不冒充具有执业资格的最终法律意见。
+
+## 分析框架
+
+1. 列明可能适用的国内法、国际法、行政规则、合同或组织内部政策，并区分其层级和适用条件。
+2. 区分有约束力的规则、公开政策立场、惯例和分析观点；存在争议时呈现主要解释路径。
+3. 检查权限来源、决策程序、必要性、比例性、期限、复核、救济、隐私和人权影响。
+4. 给出“允许 / 有条件允许 / 需进一步授权或法律核验 / 不建议”的分级意见。
+5. 设计记录、审批、监督、复盘和退出机制，使策略可审计、可纠错。
+
+## 证据纪律
+
+适用 `policy-knowledge` 时先读取知识库；法律政策具有时效性，工具可用时应核验官方文本、发布日期和生效状态。无法核验时明确写出法域、版本与解释不确定性，不编造法条或权威结论。
+
+## 输出结构
+
+使用 Markdown，固定包含：
+
+1. `## 核心判断`
+2. `## 候选策略`
+3. `## 适用规则与授权边界`
+4. `## 程序、监督与救济`
+5. `## 合规风险与缓释`
+6. `## 依据与待核验事项`
+
+## 安全与中立边界
+
+- 对台海等敏感议题中立呈现存在争议的法律主张，不把单方主张描述为无争议事实。
+- 禁止提供规避法律、制裁、监督、问责或平台规则的操作方法。
+- 禁止作战战术、目标选择、武器运用、规避侦测或利用具体脆弱点的指导。
+- 禁止针对特定人群的隐蔽操纵、欺骗、恐吓或定向政治说服。
+- 遇到越界请求时，改为合规替代方案、合法授权路径、监督机制、人道保护和降级风险建议。

offline-backend-20260512/backend/app/gateway/routers/_strategy_selection_seed_assets/strategy-selection-angle-law-policy/config.yaml

@@ -0,0 +1,8 @@
+id: strategy-selection-angle-law-policy
+name: 策略视角·法律政策
+description: 从适用法律、政策授权、程序正当性与合规风险视角评估策略边界并提出合法可审计的建议。
+tool_groups:
+  - web
+  - file:read
+skills:
+  - policy-knowledge

offline-backend-20260512/backend/app/gateway/routers/_strategy_selection_seed_assets/strategy-selection-angle-public-opinion/SOUL.md

@@ -0,0 +1,34 @@
+# 策略视角·社会舆情智能体
+
+你是策略优选流程中的「社会舆情」角度智能体。你从公众信息需求、媒体生态、谣言与误传、风险感知、社会信任和社区韧性角度形成一项候选策略。你的工作是透明公共沟通和信息完整性，不是宣传操纵或定向说服。
+
+## 分析框架
+
+1. 区分公众、媒体、企业、社区组织等利益相关方的信息需求，不做心理弱点画像。
+2. 识别信息真空、相互矛盾的公开信息、谣言传播条件与可能造成的公共风险。
+3. 设计透明、可核验、可纠错的沟通机制：事实更新、来源说明、问答、纠错记录和反馈渠道。
+4. 优先保护受影响群体的知情权、隐私、安全与自主判断，避免污名化和群体对立。
+5. 评估效果时使用公开、聚合、非侵入性指标，不以政治服从或观点改变作为唯一目标。
+
+## 证据纪律
+
+适用 `policy-knowledge` 时先读取知识库入口；涉及最新舆情时，在工具可用时核验公开来源、采样范围和时间。区分代表性数据与个案，不虚构“民意”、传播规模或群体态度。
+
+## 输出结构
+
+使用 Markdown，固定包含：
+
+1. `## 核心判断`
+2. `## 候选策略`
+3. `## 公众信息需求与风险`
+4. `## 透明沟通与纠错机制`
+5. `## 指标、风险与缓释`
+6. `## 依据与不确定性`
+
+## 不可越过的边界
+
+- 禁止针对特定个人或群体进行隐蔽操纵、欺骗、恐吓、微定向政治广告、心理脆弱点利用或定向政治说服。
+- 禁止伪造身份、来源、草根支持、媒体内容、证据或共识。
+- 禁止作战战术、目标选择、武器运用、规避侦测或利用具体脆弱点的指导。
+- 对台海等敏感议题中立呈现公开视角，以事实核查、危机信息可达性、社会韧性和降级风险为目标。
+- 对越界诉求，改为透明公共信息、媒体素养、独立核验、谣言纠正和社区支持方案。

offline-backend-20260512/backend/app/gateway/routers/_strategy_selection_seed_assets/strategy-selection-angle-public-opinion/config.yaml

@@ -0,0 +1,8 @@
+id: strategy-selection-angle-public-opinion
+name: 策略视角·社会舆情
+description: 从公众信息需求、谣言治理、透明沟通与社会韧性视角提出非操纵性的公共沟通建议。
+tool_groups:
+  - web
+  - file:read
+skills:
+  - policy-knowledge

offline-backend-20260512/backend/app/gateway/routers/_strategy_selection_seed_assets/strategy-selection-angle-security/SOUL.md

@@ -0,0 +1,34 @@
+# 策略视角·安全风险智能体
+
+你是策略优选流程中的「安全风险」角度智能体。你只做高层级危机预警、误判与升级路径分析、公共安全、关键民生服务保护和应急协同，形成一项防御性、降级导向的候选策略。你不是军事行动规划者。
+
+## 分析框架
+
+1. 建立风险登记：风险事件、可能诱因、早期信号、影响、可控性与置信度。
+2. 区分最可能情景、最危险情景和低概率高影响情景，避免把假设写成预报。
+3. 识别误判、沟通中断、连锁反应、事故和非预期升级的路径。
+4. 优先提出热线与通报、行为克制、民生保障、应急协作、人员疏散准备和人道保护等高层措施。
+5. 为每项建议设置触发、暂停、升级审批、复盘和退出条件。
+
+## 证据纪律
+
+适用 `policy-knowledge` 时先按技能读取知识库；涉及当前事件时，在工具可用时核验公开来源和时间。不得推断或披露非公开部署、实时位置、具体防护漏洞等敏感操作信息。
+
+## 输出结构
+
+使用 Markdown，固定包含：
+
+1. `## 核心判断`
+2. `## 候选策略`
+3. `## 风险情景与早期信号`
+4. `## 保护与降级措施`
+5. `## 触发、暂停与退出条件`
+6. `## 依据与不确定性`
+
+## 不可越过的边界
+
+- 禁止作战战术、兵力部署、目标选择、打击时序、武器运用、规避侦测、漏洞利用或提升伤害效果的指导。
+- 禁止提供可用于定位人员、设施或实时行动的敏感细节。
+- 禁止针对特定人群的隐蔽操纵、恐吓、欺骗或定向政治说服。
+- 对台海等敏感议题保持中立，始终把减少误判、避免升级、保护平民和维持基本服务作为评价基线。
+- 遇到越界请求时，明确缩小到非操作性的风险评估、危机沟通、人道保护和韧性建设。

offline-backend-20260512/backend/app/gateway/routers/_strategy_selection_seed_assets/strategy-selection-angle-security/config.yaml

@@ -0,0 +1,8 @@
+id: strategy-selection-angle-security
+name: 策略视角·安全风险
+description: 从危机预警、误判升级、公共安全与人道保护视角识别风险并提出非战术、降级导向的防护建议。
+tool_groups:
+  - web
+  - file:read
+skills:
+  - policy-knowledge

offline-backend-20260512/backend/app/gateway/routers/_strategy_selection_seed_assets/strategy-selection-intent/SOUL.md

@@ -0,0 +1,52 @@
+# 策略优选·意图理解智能体
+
+你是「策略优选」流程的第一位功能型智能体。你的唯一职责是与用户进行简短对话，把模糊诉求整理为右侧可编辑的任务草稿；你不分析局势、不推荐策略、不替后续角度智能体作答。
+
+## 工作原则
+
+1. 先复述已知信息，再判断是否真的存在阻塞性缺口。
+2. 能依据原话形成任务草稿时直接收敛，不为了“问得完整”而连续追问。
+3. 必须澄清时，一轮只问一个最影响任务边界的问题，并优先调用 `ask_clarification` 提供 2–4 个容易选择的选项。
+4. 用户没有明确说明的内容只能在任务详情中标成“暂定假设”，不得伪装成事实或硬约束。
+5. 任务草稿是可编辑建议，不替用户作政治立场判断，也不把争议性主张写成已证实事实。
+
+## 可推荐分析角度
+
+每次请求都会提供管理员当前启用的角度 ID、名称和说明。只能从该次请求给出的 ID 中选择与任务相关的子集，不得依赖内置清单、补写已停用角度或自造 ID；最终选择权属于用户。安全风险类角度只做高层级风险识别、预警、人道保护和降级建议，不展开作战战术。
+
+## 收敛协议
+
+可以形成任务草稿时，先用一句话说明理解，然后在回复末尾输出且只输出一个严格合法的 JSON 块：
+
+````markdown
+[INTENT_READY]
+```strategy-task-json
+{
+  "name": "简洁任务名称",
+  "detail": "要解决的问题、背景和范围",
+  "objective": "一句话核心目标",
+  "prerequisites": "开展分析前应满足或确认的条件，多项用分号分隔",
+  "constraints": "用户明确提出的边界，多项用分号分隔",
+  "deliverables": "希望得到的产物，多项用分号分隔",
+  "acceptanceCriteria": "用户可核验的完成标准，多项用分号分隔",
+  "horizon": "任务的时间范围或阶段",
+  "selectedAngleIds": ["请求中提供的角度ID"]
+}
+```
+````
+
+字段名必须逐字一致；`selectedAngleIds` 是字符串数组，其余字段都是字符串；代码块闭合后停止输出。无法确认但需要保留的假设，应在 `detail` 中以“暂定假设”小节明确写出，不得增加与前端不一致的自定义 JSON 字段。不得在任务草稿阶段直接给出候选策略。
+
+## 安全与中立边界
+
+- 对台海及其他敏感地缘议题，使用中性、可核验、降级风险的语言，区分事实、各方主张和分析推断。
+- 禁止提供作战战术、目标选择、武器运用、规避侦测或利用具体脆弱点的可执行指导。
+- 禁止设计针对特定人群的隐蔽操纵、欺骗、恐吓或定向政治说服；可将相关诉求重构为透明公共沟通、事实核查和社会韧性任务。
+- 若原始诉求越过上述边界，保留其合法的高层目标，并把输出边界写入 `constraints`，例如“仅讨论外交、经济、法律、公共安全和危机降级选项”。
+
+## 禁止事项
+
+- 不生成完整策略或方案。
+- 不替评判智能体给候选项打分。
+- 不编造时间、预算、授权、数据或利益相关方立场。
+- 不输出除 `[INTENT_READY]` 契约以外的自定义结构化字段名。

offline-backend-20260512/backend/app/gateway/routers/_strategy_selection_seed_assets/strategy-selection-intent/config.yaml

@@ -0,0 +1,6 @@
+id: strategy-selection-intent
+name: 策略优选·意图理解
+description: 将用户的策略议题通过必要的简短澄清整理为任务名称、任务详情、前置条件、目标、约束、预期产物和建议分析角度；不直接生成策略。
+tool_groups: []
+skills:
+  - intent-clarification-policy

offline-backend-20260512/backend/app/gateway/routers/_strategy_selection_seed_assets/strategy-selection-judge/SOUL.md

@@ -0,0 +1,65 @@
+# 策略优选·智能评判智能体
+
+你是策略优选流程的独立评判智能体。输入包含已确认的任务草稿，以及若干带稳定 `agentId`、角度名称和正文的候选策略。你只做比较、校验、评分和排序，不另造候选策略，不因为文风华丽而抬高得分。
+
+## 评判流程
+
+1. 先检查每个候选项是否真正回应任务目标、前置条件和硬约束。
+2. 区分候选项中的事实、推断和建议；无法追溯的关键事实降低证据分。
+3. 检查候选策略之间的重复、互补、冲突和前后依赖。
+4. 按统一量表独立评分，再给出横向比较和推荐组合。
+5. 只使用输入中的 `agentId`，不得改名或虚构不存在的候选项。
+
+## 百分制量表
+
+- 任务匹配度：25
+- 可执行性与前置条件：20
+- 合法合规与权利保护：15
+- 危机降级与平民保护：15
+- 证据质量与不确定性管理：10
+- 风险韧性与可逆性：10
+- 跨角度协同性：5
+
+若候选项包含作战战术、目标选择、武器运用、规避侦测、具体漏洞利用，或针对特定人群的隐蔽操纵、欺骗、恐吓、定向政治说服，应标记 `disqualified: true`，不得以“效果可能更强”为由给出推荐。
+
+## 输出要求
+
+先用简洁 Markdown 给出总体评价、主要差异、推荐组合和需要人工确认的冲突。随后在回复末尾输出：
+
+````markdown
+[JUDGEMENT_READY]
+```strategy-evaluation-json
+{
+  "evaluations": [
+    {
+      "agentId": "原始智能体ID",
+      "score": 82,
+      "conclusion": "优先推荐",
+      "comment": "该候选项与任务目标高度一致，但需要补齐实施授权",
+      "strengths": ["优势"],
+      "risks": ["风险"],
+      "dimensionScores": {
+        "task_fit": 22,
+        "feasibility": 16,
+        "legality": 13,
+        "deescalation": 12,
+        "evidence": 8,
+        "resilience": 7,
+        "coordination": 4
+      }
+    }
+  ],
+  "recommendedAgentIds": ["智能体ID"],
+  "combinationNotes": ["组合时需要消除的冲突或依赖"],
+  "overallComment": "总体结论"
+}
+```
+````
+
+`score` 为 0–100 的整数，并且必须等于 `dimensionScores` 各维度分之和。`conclusion` 只能是“优先推荐”、“建议采用”或“保留备选”。若候选项触发取消资格条件，使用“保留备选”，在 `comment` 开头明确写“取消资格：”，`score` 不高于 40，且不得进入 `recommendedAgentIds`。JSON 必须严格合法，代码块后不再输出内容。
+
+## 中立与风险边界
+
+- 对台海等敏感议题不预设任何政治立场优越，比较标准是用户合法目标、证据、可执行性、权利保护与降级风险。
+- 不用新的未经核验事实替候选项补洞；只指出缺口和所需验证。
+- 不评判或奖励作战效率、伤害规模、操纵成功率等越界指标。

offline-backend-20260512/backend/app/gateway/routers/_strategy_selection_seed_assets/strategy-selection-judge/config.yaml

@@ -0,0 +1,5 @@
+id: strategy-selection-judge
+name: 策略优选·智能评判
+description: 对多个角度智能体给出的候选策略按一致标准进行可追溯评判、排序与风险提示，不生成新的行动策略。
+tool_groups: []
+skills: []

offline-backend-20260512/backend/app/gateway/routers/_strategy_selection_seed_assets/strategy-selection-solution/SOUL.md

@@ -0,0 +1,42 @@
+# 策略优选·方案整理智能体
+
+你是策略优选流程的最终方案整理智能体。输入包含任务草稿、评判结果，以及用户明确勾选并移入右侧的候选策略。你只基于这些已选材料做去重、消歧、排序和整合，不偷偷加入未选候选项，也不重新调研。
+
+## 整理流程
+
+1. 对齐任务名称、目标、前置条件、约束和预期产物。
+2. 为每项已选策略保留其核心价值，合并重复内容，显式处理相互冲突的前提与节奏。
+3. 把策略组织为近期、中期、持续性动作，并明确责任接口、输入、产物、指标、风险和退出条件。
+4. 对证据不足或取舍仍冲突的地方，使用“需人工确认”清单，不自行编造事实或替用户作重大选择。
+5. 确保方案以合法、透明、可逆、降级风险和保护平民为基线。
+
+## Markdown 结构
+
+最终文档默认使用：
+
+1. `# <任务名称>综合策略方案`
+2. `## 一、执行摘要`
+3. `## 二、任务目标与边界`
+4. `## 三、综合策略框架`
+5. `## 四、分阶段实施路线`
+6. `## 五、协同与资源条件`
+7. `## 六、风险、触发器与缓释`
+8. `## 七、评估指标与复盘机制`
+9. `## 八、需人工确认事项`
+
+用户指定结构时优先遵循用户结构。正文应可直接阅读和下载，不包含模型思考过程、内部提示、候选策略原始评分 JSON 或空占位。
+
+## 文件交付
+
+当 `write_file` 可用时，用一次调用把完整正文写入：
+
+`/mnt/user-data/outputs/综合策略方案.md`
+
+不得用脚本生成文件，不得拆成多个文件。写入后在聊天正文中同步输出完整 Markdown，方便前端即时展示；若运行环境禁止写文件，仍须完整输出正文，由策略会话服务持久化和导出。
+
+## 不可越过的边界
+
+- 禁止补写作战战术、兵力部署、目标选择、打击时序、武器运用、规避侦测或具体漏洞利用。
+- 禁止设计针对特定个人或群体的隐蔽操纵、欺骗、恐吓、微定向政治广告或定向政治说服。
+- 对台海等敏感议题保持中立，区分事实、各方主张与分析推断，优先危机沟通、和平解决、人道保护和社会经济韧性。
+- 若已选材料含越界内容，剔除可操作细节并在“风险与边界”中说明改为合法、非暴力、降级导向的替代方案。

offline-backend-20260512/backend/app/gateway/routers/_strategy_selection_seed_assets/strategy-selection-solution/config.yaml

@@ -0,0 +1,6 @@
+id: strategy-selection-solution
+name: 策略优选·方案整理
+description: 将用户勾选的候选策略和评判意见去重、消歧并整理为一份完整的 Markdown 综合策略方案。
+tool_groups:
+  - file:write
+skills: []

offline-backend-20260512/backend/app/gateway/routers/agents.py

@@ -4,7 +4,9 @@ from __future__ import annotations
 
 import asyncio
 import logging
+import os
 import shutil
+import tempfile
 import time
 from datetime import datetime
 from typing import Any
@@ -15,7 +17,10 @@ from fastapi import APIRouter, Depends, HTTPException, Query, Request
 from pydantic import BaseModel, Field
 
 from app.gateway.auth.password import verify_password_async
-from app.gateway.deps import get_agent_store, get_config, get_tag_store
+from app.gateway.deps import get_agent_store, get_config, get_skill_store, get_tag_store
+from app.gateway.routers._strategy_selection_seed import (
+    STRATEGY_AGENT_ID_PREFIX,
+)
 from deerflow.agents.lead_agent.prompt import refresh_skills_system_prompt_cache_async
 from deerflow.config.agents_api_config import get_agents_api_config
 from deerflow.config.agents_config import CommonQuestion, list_custom_agents, load_agent_config, load_agent_soul, validate_agent_id
@@ -23,15 +28,39 @@ from deerflow.config.app_config import AppConfig
 from deerflow.config.paths import get_paths
 from deerflow.config.system_settings import load_system_settings, normalize_square_id, resolve_default_square_id
 from deerflow.persistence.agents import AgentStore
+from deerflow.persistence.skills import SkillStore
 from deerflow.persistence.tags import TagStore
 from deerflow.runtime.user_context import get_effective_user_id
 from deerflow.skills.cascade import sync_agent_skills_to_available
 from deerflow.skills.storage import get_or_new_skill_storage
+from deerflow.skills.types import SkillCategory
+from deerflow.skills.usage import all_entries as get_skill_usage_entries
 
 logger = logging.getLogger(__name__)
 router = APIRouter(prefix="/api", tags=["agents"])
 
 
+def _is_strategy_agent_id(agent_id: str) -> bool:
+    return agent_id.casefold().startswith(STRATEGY_AGENT_ID_PREFIX.casefold())
+
+
+def _require_canonical_record_id(requested_id: str, record: dict[str, Any]) -> str:
+    """Reject case-insensitive database aliases before touching agent files.
+
+    MySQL deployments may use a case-insensitive collation while Windows agent
+    directories are also case-insensitive.  A lookup for a differently-cased
+    id must never be allowed to select one row and mutate another path.
+    """
+
+    canonical_id = str(record.get("id") or "")
+    if canonical_id != requested_id:
+        raise HTTPException(
+            status_code=409,
+            detail=f"Agent id casing mismatch; use canonical id '{canonical_id}'",
+        )
+    return canonical_id
+
+
 class AgentResponse(BaseModel):
     """Response model for an agent."""
 
@@ -276,6 +305,108 @@ def _validate_storage_id(agent_id: str) -> str:
         raise HTTPException(status_code=422, detail=str(exc)) from exc
 
 
+def _validate_strategy_agent_model(
+    raw_model: str | None,
+    *,
+    app_config: AppConfig,
+) -> str | None:
+    """Normalize a shared strategy role's model and reject stale names."""
+
+    model = (raw_model or "").strip() or None
+    if model is None:
+        return None
+    if model not in {entry.name for entry in app_config.models}:
+        raise HTTPException(
+            status_code=422,
+            detail=f"Unknown strategy agent model: {model}",
+        )
+    return model
+
+
+async def _validate_strategy_agent_skills(
+    requested_skills: list[str] | None,
+    *,
+    app_config: AppConfig,
+    skill_store: SkillStore,
+) -> list[str] | None:
+    """Validate a global strategy role's skill allowlist.
+
+    Strategy-selection agents are built-in roles shared by every project and
+    every user.  Their allowlists may therefore reference only canonical skill
+    names that exist on disk, are enabled/active, and are globally visible:
+    deployment-owned public skills, explicit built-in rows, or custom skills
+    currently published by their owner.  In particular, an administrator must
+    not be able to attach a different user's unpublished skill merely because
+    ``?admin=true`` exposes it in the management catalog.
+    """
+
+    if requested_skills is None:
+        return None
+
+    normalized: list[str] = []
+    for raw_name in requested_skills:
+        name = raw_name.strip()
+        if not name:
+            raise HTTPException(
+                status_code=422,
+                detail="Strategy agent skill names cannot be blank",
+            )
+        if name not in normalized:
+            normalized.append(name)
+
+    try:
+        skills = get_or_new_skill_storage(app_config=app_config).load_skills(enabled_only=False)
+        ownership = {str(record.get("name") or ""): record for record in await skill_store.list_all() if record.get("name")}
+        usage_entries = get_skill_usage_entries()
+    except HTTPException:
+        raise
+    except Exception as exc:  # noqa: BLE001 - stable API response
+        logger.exception("Failed to validate strategy-agent skill allowlist")
+        raise HTTPException(status_code=503, detail="Skill catalog is unavailable") from exc
+
+    by_name = {skill.name: skill for skill in skills}
+    unknown = [name for name in normalized if name not in by_name]
+    if unknown:
+        raise HTTPException(
+            status_code=422,
+            detail=f"Unknown strategy agent skills: {', '.join(unknown)}",
+        )
+
+    unavailable = [name for name in normalized if not by_name[name].enabled or str((usage_entries.get(name) or {}).get("state") or "active") != "active"]
+    if unavailable:
+        raise HTTPException(
+            status_code=422,
+            detail=f"Disabled or archived strategy agent skills: {', '.join(unavailable)}",
+        )
+
+    not_global: list[str] = []
+    for name in normalized:
+        skill = by_name[name]
+        if skill.category != SkillCategory.CUSTOM:
+            continue
+        record = ownership.get(name)
+        if record is not None and (record.get("owner_user_id") is None or bool(record.get("published"))):
+            continue
+        not_global.append(name)
+    if not_global:
+        raise HTTPException(
+            status_code=422,
+            detail=(f"Strategy agent skills must be globally available; unpublished or unregistered custom skills: {', '.join(not_global)}"),
+        )
+
+    return normalized
+
+
+def _ensure_strategy_agent_deletable(agent_id: str) -> None:
+    """Keep fixed strategy role ids alive; their SOUL/skills remain editable."""
+
+    if _is_strategy_agent_id(agent_id):
+        raise HTTPException(
+            status_code=409,
+            detail=(f"Strategy role agent '{agent_id}' cannot be deleted; edit its SOUL and skills instead"),
+        )
+
+
 def _write_agent_config(
     agent_id: str,
     *,
@@ -307,24 +438,19 @@ def _write_agent_config(
         # Persist as plain dicts (dropping blank rows) so config.yaml stays a
         # clean mapping rather than a pydantic repr. Accepts already-coerced
         # CommonQuestion models or raw dicts/strings.
-        normalized = [
-            q if isinstance(q, CommonQuestion) else CommonQuestion.model_validate(q)
-            for q in common_questions
-        ]
-        config_data["common_questions"] = [
-            q.model_dump() for q in normalized if q.prompt.strip()
-        ]
+        normalized = [q if isinstance(q, CommonQuestion) else CommonQuestion.model_validate(q) for q in common_questions]
+        config_data["common_questions"] = [q.model_dump() for q in normalized if q.prompt.strip()]
     if template_name is not None and template_name.strip():
         config_data["template_name"] = template_name.strip()
     # 会商席位技能识别强化开关：仅当显式设置时写入（None = 不写, 由 AgentConfig 默认为关）。
     if seat_skill_directive is not None:
         config_data["seat_skill_directive"] = bool(seat_skill_directive)
     if llmwiki_knowledge_base_ids is not None:
-        config_data["llmwiki_knowledge_base_ids"] = list(
-            dict.fromkeys(item.strip() for item in llmwiki_knowledge_base_ids if item.strip())
-        )
-    with open(config_file, "w", encoding="utf-8") as f:
-        yaml.dump(config_data, f, default_flow_style=False, allow_unicode=True)
+        config_data["llmwiki_knowledge_base_ids"] = list(dict.fromkeys(item.strip() for item in llmwiki_knowledge_base_ids if item.strip()))
+    _atomic_write_text(
+        config_file,
+        yaml.safe_dump(config_data, default_flow_style=False, allow_unicode=True),
+    )
 
 
 def _load_config_extras(agent_id: str) -> dict[str, Any]:
@@ -358,7 +484,35 @@ def _load_config_extras(agent_id: str) -> dict[str, Any]:
 def _write_agent_soul(agent_id: str, soul: str) -> None:
     agent_dir = get_paths().agent_dir(agent_id)
     agent_dir.mkdir(parents=True, exist_ok=True)
-    (agent_dir / "SOUL.md").write_text(soul, encoding="utf-8")
+    _atomic_write_text(agent_dir / "SOUL.md", soul)
+
+
+def _atomic_write_text(path, content: str) -> None:
+    """Durably replace one small agent config file on the same filesystem."""
+
+    path.parent.mkdir(parents=True, exist_ok=True)
+    temp_name: str | None = None
+    try:
+        with tempfile.NamedTemporaryFile(
+            mode="w",
+            encoding="utf-8",
+            dir=path.parent,
+            prefix=f".{path.name}.",
+            suffix=".tmp",
+            delete=False,
+        ) as handle:
+            temp_name = handle.name
+            handle.write(content)
+            handle.flush()
+            os.fsync(handle.fileno())
+        os.replace(temp_name, path)
+        temp_name = None
+    finally:
+        if temp_name is not None:
+            try:
+                os.unlink(temp_name)
+            except FileNotFoundError:
+                pass
 
 
 async def _sync_legacy_agents(store: AgentStore) -> None:
@@ -413,11 +567,7 @@ async def _backfill_listing_cache(store: AgentStore, pairs: list[tuple[str, Any]
         existing = cached.get(agent_id)
         if existing is None or existing.get("skills") != want_skills:
             await store.replace_skills(agent_id, want_skills)
-        if (
-            existing is None
-            or existing.get("tool_groups") != want_tool_groups
-            or existing.get("model") != want_model
-        ):
+        if existing is None or existing.get("tool_groups") != want_tool_groups or existing.get("model") != want_model:
             await store.set_extras(agent_id, tool_groups=want_tool_groups, model=want_model)
 
 
@@ -631,9 +781,7 @@ async def _build_list_responses(
     SOUL.md is skipped (only the edit dialog reads it). An agent absent from
     the cache (never mirrored) keeps its ``None`` extras until the next sync.
     """
-    responses = [
-        _record_to_response(a, include_soul=False, include_extras=False) for a in records
-    ]
+    responses = [_record_to_response(a, include_soul=False, include_extras=False) for a in records]
     ids = [r.id for r in responses]
     extras = await store.get_extras_for(ids)
     assignments = await tag_store.list_assignments("agent", ids)
@@ -686,11 +834,7 @@ async def list_agents(
     ),
     admin: bool = Query(
         default=False,
-        description=(
-            "Admin-only override. When ``true`` and the caller is a system admin, "
-            "every agent is returned (built-in + every user's agents + private-square "
-            "entries) regardless of the usual ownership/visibility filter."
-        ),
+        description=("Admin-only override. When ``true`` and the caller is a system admin, every agent is returned (built-in + every user's agents + private-square entries) regardless of the usual ownership/visibility filter."),
     ),
 ) -> AgentsListResponse:
     _require_agents_api_enabled()
@@ -744,11 +888,7 @@ async def list_agents(
         if owner and owner.strip():
             responses = [r for r in responses if r.user_id == owner.strip()]
         if square_id:
-            responses = [
-                r
-                for r in responses
-                if (r.square_id or "") == square_id or (square_is_default and not (r.square_id or ""))
-            ]
+            responses = [r for r in responses if (r.square_id or "") == square_id or (square_is_default and not (r.square_id or ""))]
         responses = _sort_agent_responses(responses, sort)
         return AgentsListResponse(agents=responses, total=len(responses), page=1, page_size=len(responses))
     except HTTPException:
@@ -773,11 +913,7 @@ async def check_agent_name(name: str) -> dict[str, Any]:
     "/agents/selector",
     response_model=AgentSelectorResponse,
     summary="Agent Homepage Selector",
-    description=(
-        "Return the admin-curated agent list shown on the new-chat homepage. "
-        "Sorted by ``featured_order`` ascending. Visibility-filtered, so an "
-        "agent the caller can't see (author un-published) is silently omitted."
-    ),
+    description=("Return the admin-curated agent list shown on the new-chat homepage. Sorted by ``featured_order`` ascending. Visibility-filtered, so an agent the caller can't see (author un-published) is silently omitted."),
 )
 async def get_agent_selector(request: Request) -> AgentSelectorResponse:
     _require_agents_api_enabled()
@@ -789,12 +925,7 @@ async def get_agent_selector(request: Request) -> AgentSelectorResponse:
         records = await store.list_featured(user_id)
         # Selector dropdown only renders name/description/featured_order — same
         # rationale as list_agents: skip soul + extras + self-heal.
-        return AgentSelectorResponse(
-            agents=[
-                _record_to_response(r, include_soul=False, include_extras=False)
-                for r in records
-            ]
-        )
+        return AgentSelectorResponse(agents=[_record_to_response(r, include_soul=False, include_extras=False) for r in records])
     except HTTPException:
         raise
     except Exception as e:
@@ -853,6 +984,11 @@ async def create_agent_endpoint(request: AgentCreateRequest, http_request: Reque
 
     if request.id:
         agent_id = _validate_storage_id(request.id)
+        if _is_strategy_agent_id(agent_id):
+            raise HTTPException(
+                status_code=409,
+                detail=("The 'strategy-selection-' id namespace is reserved; create strategy angle agents through /api/strategy-agents/angles"),
+            )
         if await store.get_any(agent_id) is not None:
             raise HTTPException(status_code=409, detail=f"Agent id '{agent_id}' already exists")
     else:
@@ -918,14 +1054,18 @@ async def create_agent_endpoint(request: AgentCreateRequest, http_request: Reque
 async def update_agent(agent_id: str, request: AgentUpdateRequest, http_request: Request) -> AgentResponse:
     _require_agents_api_enabled()
     agent_id = _validate_storage_id(agent_id)
+    if _is_strategy_agent_id(agent_id):
+        raise HTTPException(
+            status_code=409,
+            detail=("Strategy agent configuration must be changed through /api/strategy-agents/{agent_id}"),
+        )
 
     try:
         store = get_agent_store(http_request)
         user_id = _current_user_id(http_request)
         is_admin = _is_admin_user(http_request)
-        current, edit_mode = await _get_editable_or_raise(
-            store, agent_id, user_id, is_admin=is_admin
-        )
+        current, edit_mode = await _get_editable_or_raise(store, agent_id, user_id, is_admin=is_admin)
+        _require_canonical_record_id(agent_id, current)
 
         fields_set = request.model_fields_set
         update_data: dict[str, Any] = {}
@@ -953,17 +1093,26 @@ async def update_agent(agent_id: str, request: AgentUpdateRequest, http_request:
         next_description = update_data.get("description", current.get("description") or "")
 
         existing_extras = _load_config_extras(agent_id)
-        next_skills = request.skills if "skills" in fields_set else existing_extras["skills"]
-        next_model = request.model if "model" in fields_set else existing_extras["model"]
+        if "skills" in fields_set and _is_strategy_agent_id(agent_id):
+            next_skills = await _validate_strategy_agent_skills(
+                request.skills,
+                app_config=get_config(http_request),
+                skill_store=get_skill_store(http_request),
+            )
+        else:
+            next_skills = request.skills if "skills" in fields_set else existing_extras["skills"]
+        if "model" in fields_set and _is_strategy_agent_id(agent_id):
+            next_model = _validate_strategy_agent_model(
+                request.model,
+                app_config=get_config(http_request),
+            )
+        else:
+            next_model = request.model if "model" in fields_set else existing_extras["model"]
         next_tool_groups = request.tool_groups if "tool_groups" in fields_set else existing_extras["tool_groups"]
         next_common_questions = request.common_questions if "common_questions" in fields_set else existing_extras["common_questions"]
         next_template_name = request.template_name if "template_name" in fields_set else existing_extras["template_name"]
         next_seat_skill_directive = request.seat_skill_directive if "seat_skill_directive" in fields_set else existing_extras["seat_skill_directive"]
-        next_llmwiki_ids = (
-            await _validate_llmwiki_bindings(http_request, request.llmwiki_knowledge_base_ids)
-            if "llmwiki_knowledge_base_ids" in fields_set
-            else existing_extras["llmwiki_knowledge_base_ids"]
-        )
+        next_llmwiki_ids = await _validate_llmwiki_bindings(http_request, request.llmwiki_knowledge_base_ids) if "llmwiki_knowledge_base_ids" in fields_set else existing_extras["llmwiki_knowledge_base_ids"]
 
         config_dirty = bool(update_data) or any(key in fields_set for key in ("skills", "model", "tool_groups", "common_questions", "template_name", "seat_skill_directive", "llmwiki_knowledge_base_ids"))
         if config_dirty:
@@ -1071,14 +1220,19 @@ async def update_user_profile(request: UserProfileUpdateRequest) -> UserProfileR
 async def delete_agent(agent_id: str, request: Request) -> None:
     _require_agents_api_enabled()
     agent_id = _validate_storage_id(agent_id)
+    if _is_strategy_agent_id(agent_id):
+        raise HTTPException(
+            status_code=409,
+            detail=("Strategy agents cannot be deleted through the generic API; use /api/strategy-agents/{agent_id} to disable an angle"),
+        )
 
     try:
         store = get_agent_store(request)
         user_id = _current_user_id(request)
         is_admin = _is_admin_user(request)
-        _, edit_mode = await _get_editable_or_raise(
-            store, agent_id, user_id, is_admin=is_admin
-        )
+        record, edit_mode = await _get_editable_or_raise(store, agent_id, user_id, is_admin=is_admin)
+        _require_canonical_record_id(agent_id, record)
+        _ensure_strategy_agent_deletable(agent_id)
 
         if edit_mode == "admin":
             deleted = await store.delete_any(agent_id)
@@ -1382,11 +1536,7 @@ class AgentFeaturedReorderRequest(BaseModel):
 
     agent_ids: list[str] = Field(
         default_factory=list,
-        description=(
-            "Featured agent ids in the desired top→bottom display order. Ids not "
-            "currently featured are silently skipped, so the client can send the "
-            "current visible order without first reconciling with the server."
-        ),
+        description=("Featured agent ids in the desired top→bottom display order. Ids not currently featured are silently skipped, so the client can send the current visible order without first reconciling with the server."),
     )
 
 
@@ -1394,11 +1544,7 @@ class AgentFeaturedReorderRequest(BaseModel):
     "/agents/featured/order",
     status_code=204,
     summary="Reorder Featured Agents (admin)",
-    description=(
-        "Admin-only. Bulk-assign ``featured_order`` to each id in the order received "
-        "(``0`` is topmost). After this, the homepage selector renders agents in "
-        "exactly the supplied order. Ids not already featured are ignored."
-    ),
+    description=("Admin-only. Bulk-assign ``featured_order`` to each id in the order received (``0`` is topmost). After this, the homepage selector renders agents in exactly the supplied order. Ids not already featured are ignored."),
 )
 async def reorder_featured_agents(
     body: AgentFeaturedReorderRequest,

offline-backend-20260512/backend/app/gateway/routers/assistant_knowledge.py

@@ -152,6 +152,18 @@ def _list_export_manifests(mapping_id: str, *, limit: int) -> list[dict[str, Any
 
 def _delete_base_package_files(base_id: str, import_job_ids: list[str]) -> None:
     """Delete package artifacts owned by one assistant base only."""
+    import shutil
+
+    from app.gateway.assistant_file_ingest import file_job_dir
+
+    for job_id in import_job_ids:
+        # UUID validation confines cleanup to exactly one job directory.
+        try:
+            directory = file_job_dir(job_id)
+        except ValueError:
+            continue
+        if directory.is_dir() and not directory.is_symlink():
+            shutil.rmtree(directory)
     root = _package_root()
     if not root.is_dir():
         return
@@ -448,10 +460,71 @@ async def import_skills(request: Request, _body: SkillImportRequest) -> dict[str
     raise HTTPException(status_code=410, detail="不支持技能直接归纳到助手知识库，请先归纳到 WeKnora 普通知识库后再导入助手知识库")
 
 
-@router.post("/imports/files", status_code=410)
-async def import_files(request: Request) -> dict[str, Any]:
+@router.post("/imports/files", status_code=202)
+async def import_files(
+    request: Request,
+    file: UploadFile = File(...),
+    assistant_base_id: str | None = Form(default=None),
+) -> dict[str, Any]:
+    import hashlib
+
+    from app.gateway.assistant_file_ingest import ALLOWED_EXTENSIONS, MAX_FILE_BYTES, file_job_dir, save_json, start_file_job
+
+    actor = await _actor(request, admin=True)
+    filename = (file.filename or "document").replace("\\", "/").rsplit("/", 1)[-1][:240]
+    extension = Path(filename).suffix.lower()
+    if extension not in ALLOWED_EXTENSIONS:
+        await file.close()
+        raise HTTPException(status_code=415, detail="支持 Markdown、TXT、CSV、PDF、Word、Excel、PowerPoint 文件")
+    job = await _store(request).create_queued_import_job(
+        source_type="file", source_key=f"file-upload:{uuid4()}", source_name=filename,
+        trigger="local_file_upload", created_by=actor, base_id=assistant_base_id,
+        metadata={"type": "file", "filename": filename}, phase="uploading",
+    )
+    root = file_job_dir(job["id"])
+    await asyncio.to_thread(root.mkdir, parents=True, exist_ok=True)
+    path = root / f"original{extension}"
+    size, digest = 0, hashlib.sha256()
+    try:
+        with path.open("wb") as handle:
+            while chunk := await file.read(1024 * 1024):
+                size += len(chunk)
+                if size > MAX_FILE_BYTES:
+                    raise HTTPException(status_code=413, detail="单个文件最大 100 MB，请拆分后上传")
+                digest.update(chunk)
+                await asyncio.to_thread(handle.write, chunk)
+        if not size:
+            raise HTTPException(status_code=422, detail="上传文件为空")
+        await asyncio.to_thread(save_json, root / "manifest.json", {
+            "filename": filename, "stored_name": path.name, "digest": digest.hexdigest(), "actor": actor,
+        })
+        job = await _store(request).update_import_job(job["id"], phase="queued", counts={"uploaded_bytes": size})
+        start_file_job(request.app, job["id"])
+        return job
+    except Exception as exc:
+        await _store(request).update_import_job(job["id"], status="failed", phase="upload_failed", error=str(getattr(exc, "detail", exc)), completed=True)
+        await asyncio.to_thread(path.unlink, missing_ok=True)
+        raise
+    finally:
+        await file.close()
+
+
+@router.post("/import-jobs/{job_id}/retry-file", status_code=202)
+async def retry_file_import(request: Request, job_id: str) -> dict[str, Any]:
+    from app.gateway.assistant_file_ingest import file_job_dir, retry_file_job
+
     await _actor(request, admin=True)
-    raise HTTPException(status_code=410, detail="助手知识库不支持导入任意本地文件，请从 WeKnora 普通知识库导出后导入")
+    store = _store(request)
+    job = await store.get_job(job_id)
+    if not job or job.get("trigger") != "local_file_upload":
+        raise HTTPException(status_code=404, detail="文件处理任务不存在")
+    if job["status"] == "completed":
+        raise HTTPException(status_code=409, detail="文件已处理完成")
+    if not (file_job_dir(job_id) / "manifest.json").exists():
+        raise HTTPException(status_code=409, detail="文件上传未完成，请重新上传")
+    if not await retry_file_job(request.app, job_id):
+        raise HTTPException(status_code=409, detail="文件仍在处理中")
+    return await store.get_job(job_id)
 
 
 @router.post("/imports/weknora-package", status_code=202)

offline-backend-20260512/backend/app/gateway/routers/direct_chat.py

@@ -0,0 +1,149 @@
+"""Direct LLM chat — no lead agent, tools, skills, or memory.
+
+Used by the frontend 「极速」mode: stream tokens from ``create_chat_model``
+with thinking forced off so first-token latency matches a bare chat client.
+"""
+
+from __future__ import annotations
+
+import asyncio
+import json
+import logging
+from collections.abc import AsyncIterator
+from typing import Any, Literal
+
+from fastapi import APIRouter, HTTPException
+from fastapi.responses import StreamingResponse
+from langchain_core.messages import AIMessage, BaseMessage, HumanMessage, SystemMessage
+from pydantic import BaseModel, Field
+
+from deerflow.config import get_app_config
+from deerflow.models import create_chat_model
+
+logger = logging.getLogger(__name__)
+
+router = APIRouter(prefix="/api/direct-chat", tags=["direct-chat"])
+
+_HEARTBEAT_SECONDS = 15.0
+_MAX_MESSAGES = 40
+
+
+class DirectChatMessage(BaseModel):
+    role: Literal["user", "assistant", "system"]
+    content: str = ""
+
+
+class DirectChatRequest(BaseModel):
+    messages: list[DirectChatMessage] = Field(..., min_length=1)
+    model_name: str | None = None
+
+
+def _chunk_text(chunk: Any) -> str:
+    content = getattr(chunk, "content", None)
+    if isinstance(content, str):
+        return content
+    if isinstance(content, list):
+        parts: list[str] = []
+        for block in content:
+            if isinstance(block, str):
+                parts.append(block)
+            elif isinstance(block, dict) and isinstance(block.get("text"), str):
+                parts.append(block["text"])
+        return "".join(parts)
+    return ""
+
+
+def _build_lc_messages(body: DirectChatRequest) -> list[BaseMessage]:
+    built: list[BaseMessage] = []
+    for item in body.messages[-_MAX_MESSAGES:]:
+        text = (item.content or "").strip()
+        if not text:
+            continue
+        if item.role == "user":
+            built.append(HumanMessage(content=text))
+        elif item.role == "assistant":
+            built.append(AIMessage(content=text))
+        else:
+            built.append(SystemMessage(content=text))
+    if not any(isinstance(msg, HumanMessage) for msg in built):
+        raise HTTPException(status_code=400, detail="至少需要一条 user 消息")
+    return built
+
+
+def _sse(event: str, data: Any) -> str:
+    return f"event: {event}\ndata: {json.dumps(data, ensure_ascii=False)}\n\n"
+
+
+def _resolve_model_name(name: str | None) -> str:
+    config = get_app_config()
+    if not name:
+        if not config.models:
+            raise HTTPException(status_code=400, detail="未配置可用模型")
+        return config.models[0].name
+    if config.get_model_config(name) is None:
+        raise HTTPException(status_code=400, detail=f"模型不存在: {name}")
+    return name
+
+
+async def _direct_chat_event_stream(body: DirectChatRequest, model_name: str) -> AsyncIterator[str]:
+    lc_messages = _build_lc_messages(body)
+    queue: asyncio.Queue[tuple[str, Any]] = asyncio.Queue()
+    pieces: list[str] = []
+
+    async def produce() -> None:
+        try:
+            model = create_chat_model(
+                name=model_name,
+                thinking_enabled=False,
+                force_disable_thinking=True,
+            )
+            async for chunk in model.astream(lc_messages):
+                text = _chunk_text(chunk)
+                if text:
+                    pieces.append(text)
+                    await queue.put(("delta", {"text": text}))
+        except Exception as exc:  # noqa: BLE001 — stream errors become SSE error events
+            logger.exception("direct_chat 调用模型失败 (model=%s)", model_name)
+            await queue.put(("error", {"detail": f"模型调用失败:{exc}"}))
+        finally:
+            await queue.put(("__end__", None))
+
+    task = asyncio.create_task(produce())
+    try:
+        while True:
+            try:
+                event, data = await asyncio.wait_for(queue.get(), timeout=_HEARTBEAT_SECONDS)
+            except asyncio.TimeoutError:
+                yield ": keepalive\n\n"
+                continue
+            if event == "__end__":
+                break
+            if event == "error":
+                yield _sse("error", data)
+                return
+            yield _sse(event, data)
+
+        answer = "".join(pieces)
+        if not answer:
+            yield _sse("error", {"detail": "模型未返回任何文本。"})
+            return
+        yield _sse("result", {"answer": answer, "model_name": model_name})
+    finally:
+        if not task.done():
+            task.cancel()
+
+
+@router.post("/stream")
+async def direct_chat_stream(body: DirectChatRequest) -> StreamingResponse:
+    """Stream a plain chat completion. No agent graph, tools, or skills."""
+    model_name = _resolve_model_name(body.model_name)
+    _build_lc_messages(body)
+    return StreamingResponse(
+        _direct_chat_event_stream(body, model_name),
+        media_type="text/event-stream",
+        headers={
+            "Cache-Control": "no-cache",
+            "Connection": "keep-alive",
+            "X-Accel-Buffering": "no",
+        },
+    )