Compare commits
1
Commits
master-dev
..
dhk
| Author | SHA1 | Date | |
|---|---|---|---|
 fengxiangdebaozi
|
9eb1dc2f34 |
No files matched your search
@@ -1,12 +0,0 @@
|
|||||||
{
|
|
||||||
"version": "0.0.1",
|
|
||||||
"configurations": [
|
|
||||||
{
|
|
||||||
"name": "md-viewer-frontend",
|
|
||||||
"runtimeExecutable": "npx",
|
|
||||||
"runtimeArgs": ["ng", "serve", "--port", "4200"],
|
|
||||||
"port": 4200,
|
|
||||||
"cwd": "F:\\angular\\md-viewer\\frontend"
|
|
||||||
}
|
|
||||||
]
|
|
||||||
}
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
{
|
|
||||||
"permissions": {
|
|
||||||
"allow": [
|
|
||||||
"PowerShell(uv --version)",
|
|
||||||
"PowerShell(netstat -ano)",
|
|
||||||
"PowerShell(Get-NetTCPConnection -LocalPort 8001 -ErrorAction SilentlyContinue)",
|
|
||||||
"PowerShell(Get-Process -Id 20560 -ErrorAction SilentlyContinue | Select-Object Id,ProcessName,Path,StartTime; try { \\(Invoke-WebRequest -Uri \"http://127.0.0.1:8001/health\" -UseBasicParsing -TimeoutSec 5\\).Content } catch { \"health check failed: $_\" })",
|
|
||||||
"Bash(curl -s -X POST -H \"Content-Type: application/json\" -d '{\"username\":\"demo\"}' http://localhost:8001/api/v1/auth/login/username)"
|
|
||||||
]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,35 +0,0 @@
|
|||||||
# Never send source-control history, local dependencies, runtime state, or
|
|
||||||
# credentials to the Docker daemon. The offline images are built from the
|
|
||||||
# repository root by deploy/1panel-offline/Dockerfile.*.
|
|
||||||
.git
|
|
||||||
.runtime
|
|
||||||
.history
|
|
||||||
tmp
|
|
||||||
dist
|
|
||||||
|
|
||||||
# Credentials and environment-specific configuration are supplied at runtime
|
|
||||||
# through the offline delivery package, never copied into an image layer.
|
|
||||||
**/.env
|
|
||||||
**/.env.*
|
|
||||||
offline-backend-20260512/backend/.deer-flow
|
|
||||||
offline-backend-20260512/backend/logs
|
|
||||||
offline-backend-20260512/backend/docker-data
|
|
||||||
offline-backend-20260512/backend/dist
|
|
||||||
offline-backend-20260512/backend/wheelhouse
|
|
||||||
offline-backend-20260512/backend/offline-wheels
|
|
||||||
offline-backend-20260512/backend/.venv
|
|
||||||
offline-backend-20260512/backend/.pytest_cache
|
|
||||||
offline-backend-20260512/backend/.ruff_cache
|
|
||||||
|
|
||||||
# Reproducibly install frontend dependencies inside the image instead.
|
|
||||||
frontend-web/node_modules
|
|
||||||
frontend-web/dist
|
|
||||||
frontend-web/.vite
|
|
||||||
frontend-web/.offline-pack-build
|
|
||||||
frontend-web/.offline-extract-test
|
|
||||||
frontend-web/node_modules-offline-*.tar.gz
|
|
||||||
|
|
||||||
# Editor and operating-system metadata.
|
|
||||||
**/__pycache__
|
|
||||||
**/*.py[cod]
|
|
||||||
**/.DS_Store
|
|
||||||
@@ -1 +0,0 @@
|
|||||||
remote connectivity test - 2026-05-13
|
|
||||||
+55
-118
@@ -1,119 +1,56 @@
|
|||||||
# Workspace/editor
|
# Workspace/editor
|
||||||
.vscode/
|
.vscode/
|
||||||
frontend-web/.vscode/
|
frontend-web/.vscode/
|
||||||
node_modules/
|
|
||||||
# Claude Code local-only settings (per-user permissions, not shared)
|
|
||||||
.claude/settings.local.json
|
|
||||||
|
|
||||||
# Local runtime logs and pid files
|
|
||||||
.runtime/
|
|
||||||
logs/
|
|
||||||
offline-backend-20260512/backend/logs/
|
|
||||||
|
|
||||||
# Frontend local/runtime artifacts
|
|
||||||
frontend-web/.env
|
|
||||||
frontend-web/.env.local
|
|
||||||
frontend-web/.env.*.local
|
|
||||||
frontend-web/node_modules/
|
|
||||||
frontend-web/.pnpm-store/
|
|
||||||
frontend-web/tsconfig.tsbuildinfo
|
|
||||||
frontend-web/vite-dev.log
|
|
||||||
frontend-web/vite-dev.err.log
|
|
||||||
|
|
||||||
# Frontend local packages/archives/docs (non-source)
|
|
||||||
frontend-web/pnpm-lock.yaml
|
|
||||||
frontend-web/README.md
|
|
||||||
frontend-web/doc.md
|
|
||||||
frontend-web/src.zip
|
|
||||||
frontend-web/src9.zip
|
|
||||||
frontend-web/src-v1.zip
|
|
||||||
frontend-web/src-*.rar
|
|
||||||
frontend-web/dist
|
|
||||||
# Frontend build artifacts
|
|
||||||
frontend-web/dist/
|
|
||||||
frontend-web/dist-scheduled-check/
|
|
||||||
|
|
||||||
# Offline backend bundles and local deployment artifacts
|
|
||||||
offline-backend-20260505.zip
|
|
||||||
offline-backend-20260505/output/
|
|
||||||
offline-backend-20260505/bundle/.env
|
|
||||||
offline-backend-20260505/bundle/.env.example
|
|
||||||
offline-backend-20260505/bundle/DEPLOY_BACKEND_OFFLINE_ZH.md
|
|
||||||
offline-backend-20260505/bundle/SHA256SUMS
|
|
||||||
offline-backend-20260505/bundle/config.yaml
|
|
||||||
offline-backend-20260505/bundle/config.yaml.example
|
|
||||||
offline-backend-20260505/bundle/data/
|
|
||||||
offline-backend-20260505/bundle/deerflow-backend-offline-image-20260505.tar
|
|
||||||
offline-backend-20260505/bundle/extensions_config.json
|
|
||||||
offline-backend-20260505/bundle/frontend-vite.zip
|
|
||||||
offline-backend-20260505/bundle/skills/
|
|
||||||
offline-backend-20260505/bundle/start_backend.0509.sh
|
|
||||||
offline-backend-20260505/bundle/start_backend.sh
|
|
||||||
offline-backend-20260505/bundle/stop_backend.sh
|
|
||||||
|
|
||||||
# offline-backend-20260512 runtime artifacts (large files, local config, data)
|
|
||||||
offline-backend-20260512/.env.example
|
|
||||||
offline-backend-20260512/DEPLOY_BACKEND_OFFLINE_ZH.md
|
|
||||||
offline-backend-20260512/SHA256SUMS
|
|
||||||
offline-backend-20260512/config.yaml.example
|
|
||||||
offline-backend-20260512/data/
|
|
||||||
offline-backend-20260512/deerflow-backend-offline-image-20260505.tar
|
|
||||||
offline-backend-20260512/extensions_config.json
|
|
||||||
offline-backend-20260512/skills/
|
|
||||||
offline-backend-20260512/wheelhouse/
|
|
||||||
offline-backend-20260512/backend/.deer-flow/data/*.db
|
|
||||||
offline-backend-20260512/backend/.deer-flow/data/*.db-*
|
|
||||||
offline-backend-20260512/backend/.deer-flow/*
|
|
||||||
offline-backend-20260512/start_backend.sh
|
|
||||||
offline-backend-20260512/stop_backend.sh
|
|
||||||
offline-backend-20260512/check_backend.sh
|
|
||||||
|
|
||||||
hermes-agent-main/
|
|
||||||
|
|
||||||
|
|
||||||
skills/*
|
|
||||||
|
|
||||||
offline-backend-20260512/backend/.deer-flow/*
|
|
||||||
|
|
||||||
# Per-user skill_evolution overrides — runtime data written by the API
|
|
||||||
offline-backend-20260512/backend/skill_evolution.json
|
|
||||||
skills/
|
|
||||||
hermes-agent-main/
|
|
||||||
.gitignore
|
|
||||||
offline-backend-20260512/backend/tests/*
|
|
||||||
# MAF roundtable tests must be tracked (excepted from the broad tests/* ignore above)
|
|
||||||
!offline-backend-20260512/backend/tests/test_maf_*.py
|
|
||||||
!offline-backend-20260512/backend/tests/maf_test_helpers.py
|
|
||||||
deploy
|
|
||||||
.history
|
|
||||||
|
|
||||||
# Cloned third-party repos (local only)
|
|
||||||
git-clone/
|
|
||||||
|
|
||||||
# Repo-root offline dependency pack (local only)
|
|
||||||
/dist/
|
|
||||||
|
|
||||||
# Frontend offline pack working directories
|
|
||||||
frontend-web/.offline-pack-build/
|
|
||||||
frontend-web/.offline-extract-test/
|
|
||||||
frontend-web-node_modules-offline-*.tar.gz
|
|
||||||
|
|
||||||
.codegraph
|
# Frontend local/runtime artifacts
|
||||||
codegraph.mdc
|
frontend-web/.env
|
||||||
|
frontend-web/node_modules/
|
||||||
docs/aidev-docs
|
frontend-web/tsconfig.tsbuildinfo
|
||||||
docs/backups
|
frontend-web/vite-dev.log
|
||||||
# Frontend skills components must be tracked (excluded from the broad skills/ ignore above)
|
frontend-web/vite-dev.err.log
|
||||||
!frontend-web/src/components/workspace/skills/
|
|
||||||
|
# Frontend local packages/archives/docs (non-source)
|
||||||
# uv lockfile (not tracked per project preference)
|
frontend-web/pnpm-lock.yaml
|
||||||
offline-backend-20260512/backend/uv.lock
|
frontend-web/README.md
|
||||||
|
frontend-web/doc.md
|
||||||
# Local-only scratch directory (not committed)
|
frontend-web/src.zip
|
||||||
0622/
|
frontend-web/src9.zip
|
||||||
|
frontend-web/src-v1.zip
|
||||||
# Python bytecode cache
|
frontend-web/src-*.rar
|
||||||
__pycache__/
|
|
||||||
|
# Frontend build artifacts
|
||||||
# misc
|
frontend-web/dist-scheduled-check/
|
||||||
.DS_Store
|
|
||||||
|
# Offline backend bundles and local deployment artifacts
|
||||||
|
offline-backend-20260505.zip
|
||||||
|
offline-backend-20260505/output/
|
||||||
|
offline-backend-20260505/bundle/.env
|
||||||
|
offline-backend-20260505/bundle/.env.example
|
||||||
|
offline-backend-20260505/bundle/DEPLOY_BACKEND_OFFLINE_ZH.md
|
||||||
|
offline-backend-20260505/bundle/SHA256SUMS
|
||||||
|
offline-backend-20260505/bundle/config.yaml
|
||||||
|
offline-backend-20260505/bundle/config.yaml.example
|
||||||
|
offline-backend-20260505/bundle/data/
|
||||||
|
offline-backend-20260505/bundle/deerflow-backend-offline-image-20260505.tar
|
||||||
|
offline-backend-20260505/bundle/extensions_config.json
|
||||||
|
offline-backend-20260505/bundle/frontend-vite.zip
|
||||||
|
offline-backend-20260505/bundle/skills/
|
||||||
|
offline-backend-20260505/bundle/start_backend.0509.sh
|
||||||
|
offline-backend-20260505/bundle/start_backend.sh
|
||||||
|
offline-backend-20260505/bundle/stop_backend.sh
|
||||||
|
|
||||||
|
# offline-backend-20260512 runtime artifacts (large files, local config, data)
|
||||||
|
offline-backend-20260512/.env
|
||||||
|
offline-backend-20260512/.env.example
|
||||||
|
offline-backend-20260512/DEPLOY_BACKEND_OFFLINE_ZH.md
|
||||||
|
offline-backend-20260512/SHA256SUMS
|
||||||
|
offline-backend-20260512/config.yaml
|
||||||
|
offline-backend-20260512/config.yaml.example
|
||||||
|
offline-backend-20260512/data/
|
||||||
|
offline-backend-20260512/deerflow-backend-offline-image-20260505.tar
|
||||||
|
offline-backend-20260512/extensions_config.json
|
||||||
|
offline-backend-20260512/skills/
|
||||||
|
offline-backend-20260512/wheelhouse/
|
||||||
|
offline-backend-20260512/start_backend.sh
|
||||||
|
offline-backend-20260512/stop_backend.sh
|
||||||
|
offline-backend-20260512/check_backend.sh
|
||||||
@@ -1,122 +0,0 @@
|
|||||||
# MAF 多智能体会商 Phase-4 前端实施计划
|
|
||||||
|
|
||||||
## 决策回顾（已与用户确认）
|
|
||||||
- **入口**：独立顶级菜单 `/page/maf/*`，新增侧边栏一级项「MAF 会商」
|
|
||||||
- **实时更新**：纯前端轮询，`GET /runs/{id}/events?after_seq=N&limit=1000`，间隔 1.8s，复用现有后端，零 SSE、零后端改动
|
|
||||||
- **流程图**：要。基于 `confirmed_facts`（来自 `run.maf_checkpoint.fact_ledger`）+ 末轮 `final_result.content` 解析的 `flow-json`，复用 `@xyflow/react` + `flow-graph.ts` + `FlowGraphPanel`
|
|
||||||
- **审批**：卡片式，仿 `IntentClarificationCard` 的视觉/交互模式（参数摘要 + 批准/拒绝按钮 + 备注 textarea），落到 `POST /approvals/{id}/decision`
|
|
||||||
|
|
||||||
## 关键数据契约（已核实后端源码）
|
|
||||||
- **后端只读**：16 个端点全部命中，无改动。`GET /health` 返回 `enabled` 决定页面内容（入口仍可见，未启用时显示空态）。
|
|
||||||
- **事件流**：单调 `(run_id, seq)`，`GET /events?after_seq=N` 返回 `{events:[...], latest_seq}`；前端推进 `after_seq=latest_seq`。payload 已在后端**写入时脱敏**（`sanitize_payload`），前端直接渲染。
|
|
||||||
- **事件分类**（`event_normalizer.py`）：`run.started/completed/failed/cancelled`、`agent.turn_started/message.delta/message.completed`、`tool.requested/started/completed/failed`、`skill.started/completed/failed/selected`、`artifact.created`、`action.waiting_approval/approved/rejected`、`workflow.checkpointed`。
|
|
||||||
- **事实账本**（`fact_ledger.empty_ledger`）：`candidate_facts`/`confirmed_facts`/`evidence`/`tool_results`/`executed_actions`/`pending_actions`/`failed_or_unknown_actions`/`conflicts`。`confirmed_facts` 条目含 `{candidate_id, text, agent_id, confirmed_by, evidence_refs[]}`。
|
|
||||||
- **Run 字段**（`run_to_dict`）：`id, session_id, status, maf_checkpoint(含 fact_ledger + final_result + seat_outcomes), last_event_seq, started_at, finished_at, error_code, error_message_safe, token_usage, latency_ms`。
|
|
||||||
- **终态判定**：`runIsLive(status) = ["pending","running","waiting_approval","cancelling","cancel_failed"].includes(status)`，非 live 即停轮询。
|
|
||||||
- **Action/Approval**：`GET /runs/{id}/actions`、`GET /runs/{id}/approvals`；`POST /approvals/{id}/decision` `{decision:"approved"|"rejected"}`。
|
|
||||||
|
|
||||||
## 复用清单（已定位到文件:行）
|
|
||||||
- `apiFetch`（`core/api/fetch-client.ts`）：内部自动注入 `Authorization`（`getAuthorizationHeaderValue()`）+ `credentials:"include"`，**返回 Response 不解析、不拼 URL**。调用方拼 `${getBackendBaseURL()}/api/maf-roundtable/...`，自行 `res.ok` 检查 + `res.json()`。
|
|
||||||
- `getBackendBaseURL`（`core/config/index.ts`）：未设时返回 `""`，相对路径同源可用。
|
|
||||||
- TanStack Query 模式（`strategy-components/api/task-buttons.ts`）：`useQuery`+`refetchOnWindowFocus:false`；`useMutation`+`onSuccess invalidate`；queryKey 用嵌套数组 `["maf-roundtable", runId, "events"]`。
|
|
||||||
- 轮询模式（`core/scheduled-tasks/hooks.ts:105-115`）：函数式 `refetchInterval: (query) => runIsLive(query.state.data?.status) ? ms : false`。
|
|
||||||
- `FlowGraphPanel`（`roundtable-planning/components/FlowGraphPanel.tsx`）：props `{data: FlowGraphData, streaming, onClose, ...}`，自动 `useTheme()` 取明暗。`FlowGraphData = {title, nodes:[{id,label,type,detail?,group?}], edges:[{from,to,label?}]}`。`extractFlowGraph(text)`（`flow-graph.ts:263`）容错解析 ```flow-json``` 代码块（含半截 JSON）。
|
|
||||||
- `IntentClarificationCard`（`roundtable-planning/components/IntentClarificationCard.tsx`）：卡片视觉模板（`rounded-xl border-red-100` + 「需要确认」徽标 + 选项按钮 + textarea + 提交）。
|
|
||||||
- 时间线 feed（`roundtable-planning/components/Step1Panel.tsx` + `MessageBubble` + `useAutoScroll` + `ScrollToBottomButton`）：数组入、按 seq 序渲染。
|
|
||||||
- `useDesensitizeSubtree`（`roundtable-planning/lib/use-desensitize-subtree.ts`）：仅挂 header/面板框架；时间线 body 不挂（payload 已脱敏 + hook 自身警告勿用于消息列表）。
|
|
||||||
- 路由（`pages/PageRoutes.tsx:143-169`）：`<Route path="maf/*" element={<MafRoutes/>}/>`（仿 `RoundtableRoutes.tsx`）。
|
|
||||||
- 菜单（`core/page-layout/sidebar-menu.ts`）：在 `sidebarMenuItems` 数组加一级项，`icon` 用 lucide 组件（非字符串 key）。新节点经 `use-sidebar-menu.ts` 自动走 static→inject→override→role→desensitize 流水线，无需额外注册。
|
|
||||||
|
|
||||||
## 文件夹结构（镜像 `roundtable-planning/`，全新 `src/maf-roundtable/`）
|
|
||||||
```
|
|
||||||
frontend-web/src/maf-roundtable/
|
|
||||||
├── api/
|
|
||||||
│ ├── types.ts # TS 类型（snake_case 直传，后端即 snake_case）
|
|
||||||
│ ├── client.ts # BASE()=getBackendBaseURL()+"/api/maf-roundtable"；apiFetch 封装 + readJson<T>/parseDetail
|
|
||||||
│ ├── sessions.ts # 会话 CRUD hooks（list/get/create/update/delete）
|
|
||||||
│ ├── runs.ts # run hooks（get/list/create/cancel/resume/recover）+ useMafHealth
|
|
||||||
│ ├── events.ts # listEvents(runId, afterSeq) 原始 fetch（供轮询 hook 用）
|
|
||||||
│ └── approvals.ts # 审批 hooks（list + decide mutation）
|
|
||||||
├── hooks/
|
|
||||||
│ ├── use-maf-run-status.ts # GET /runs/{id} useQuery，函数式 refetchInterval 停终态
|
|
||||||
│ └── use-maf-events.ts # ★ cursor 轮询 hook（核心）
|
|
||||||
├── lib/
|
|
||||||
│ ├── event-timeline.ts # 纯函数：events[] → TimelineEntry[]（delta 聚合、tool 生命周期折叠、approval 锚点）
|
|
||||||
│ └── fact-flow-graph.ts # 纯函数：confirmed_facts+evidence → FlowGraphData
|
|
||||||
├── components/
|
|
||||||
│ ├── MafRunHeader.tsx # 状态徽标 + token/延迟 + 取消/恢复/重试
|
|
||||||
│ ├── MafEventTimeline.tsx # 时间线 feed（MessageBubble + useAutoScroll）
|
|
||||||
│ ├── MafSeatStatusPanel.tsx # 席位状态矩阵 + execution_stage 徽标
|
|
||||||
│ ├── MafFactFlowPanel.tsx # 包一层 FlowGraphPanel，数据来自 fact-flow-graph
|
|
||||||
│ ├── MafApprovalCard.tsx # 卡片式审批（批准/拒绝 + 备注）
|
|
||||||
│ └── MafHealthGate.tsx # health.enabled=false → 空态
|
|
||||||
├── pages/
|
|
||||||
│ ├── MafSessionsPage.tsx # 会话列表 + 新建
|
|
||||||
│ └── MafRunDetailPage.tsx # 单 run 工作区（三栏）
|
|
||||||
└── index.ts
|
|
||||||
```
|
|
||||||
|
|
||||||
## 核心：cursor 轮询 hook（`hooks/use-maf-events.ts`）
|
|
||||||
不用纯 `useQuery+refetchInterval`：cursor `after_seq` 需每次推进，queryFn 不持有「上次 latest_seq」，塞 queryKey 会抖动。**用自定义 hook**（结合 scheduled-tasks 的 refetchInterval 思路 + roundtable-planning 的 reader-loop 家族）：
|
|
||||||
```ts
|
|
||||||
export function useMafEvents(runId?: string, active=false) {
|
|
||||||
const [events, setEvents] = useState<MafEvent[]>([]);
|
|
||||||
const afterSeqRef = useRef(0); // 避免 setInterval 闭包旧值
|
|
||||||
useEffect(() => {
|
|
||||||
if (!runId || !active) return;
|
|
||||||
let cancelled = false;
|
|
||||||
const poll = async () => {
|
|
||||||
const res = await listEvents(runId, afterSeqRef.current);
|
|
||||||
if (cancelled || !res.events.length) return;
|
|
||||||
setEvents(prev => mergeBySeq(prev, res.events)); // seq 去重
|
|
||||||
afterSeqRef.current = res.latest_seq;
|
|
||||||
};
|
|
||||||
poll(); // 进入即补拉（after_seq=0 全量历史）
|
|
||||||
const id = setInterval(poll, 1800);
|
|
||||||
return () => { cancelled = true; clearInterval(id); };
|
|
||||||
}, [runId, active]);
|
|
||||||
return events;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
- **补拉历史**：进入页面 `after_seq=0` 立即拉全部已落库事件 → 天然支持断线补拉/刷新恢复。
|
|
||||||
- **终态停止**：`active` 由 `useMafRunStatus` 的 `runIsLive(status)` 传入，终态时 effect 清理 interval。
|
|
||||||
- **去重**：后端 `(run_id,seq)` + `source_event_id` 双重去重，前端再按 `seq` 做 `mergeBySeq`，幂等。
|
|
||||||
- **切换 run**：`runId` 变 → effect 重置（events 清空、afterSeq 归零）。
|
|
||||||
|
|
||||||
## 流程图数据流（`lib/fact-flow-graph.ts`）
|
|
||||||
两源按优先级合并 → `FlowGraphData`：
|
|
||||||
1. **`confirmed_facts`（主）**：每条已确认事实 → `task` 节点（label=text 截断、detail=全文、group=confirmed_by）；`evidence_refs` 连到 `evidence`（→ `role`）或 `tool_results`（`tool:{name}:{turn}` → `deliverable`）节点；证据根用 `start`。
|
|
||||||
2. **`final_result.content` 的 ```flow-json```（次）**：用现成 `extractFlowGraph(text)` 解析叠加为「结论流程图」。
|
|
||||||
|
|
||||||
输出喂 `<FlowGraphPanel data={...} streaming={!terminal}/>`（非终态蚂蚁线动）。两源皆空 → 空态「尚无可绘制事实」。
|
|
||||||
|
|
||||||
## 页面布局（`MafRunDetailPage`，三栏 / 窄屏堆叠）
|
|
||||||
- **左：时间线**（`MafEventTimeline`）—— `event-timeline.ts` 折叠成可读条目（delta 聚合气泡、tool 折叠「调用 X→完成」、action.waiting_approval 插锚点），复用 MessageBubble + useAutoScroll + ScrollToBottomButton。
|
|
||||||
- **中上：席位状态**（`MafSeatStatusPanel`）—— `maf_checkpoint.seat_outcomes` 的 agent × status 矩阵 + `execution_stage` 徽标。
|
|
||||||
- **中下：事实/结论流程图**（`MafFactFlowPanel`）—— 折叠面板，默认展开。
|
|
||||||
- **右：审批卡片**（`MafApprovalCard` 列表）—— 仅 pending 时显示；含工具名、参数摘要（脱敏）、批准/拒绝按钮 + 备注 textarea → `POST /approvals/{id}/decision`，成功后 invalidate `["maf-roundtable","approvals",runId]`，事件轮询自然看到 `action.approved/rejected`。
|
|
||||||
|
|
||||||
## 路由 + 菜单接入（3 处）
|
|
||||||
1. **新建** `pages/MafRoutes.tsx`（仿 `RoundtableRoutes.tsx`）：`index→MafSessionsPage`、`runs/:runId→MafRunDetailPage`、`*→重定向`。
|
|
||||||
2. **改** `pages/PageRoutes.tsx`：加 `import MafRoutes` + `<Route path="maf/*" element={<MafRoutes/>}/>`（插 `notebook` 后）。
|
|
||||||
3. **改** `core/page-layout/sidebar-menu.ts`：数组末尾加 `{ id:"maf-center", label:"MAF 会商", icon:Network, children:[{id:"maf-roundtable", label:"会商列表", icon:MessageSquareText, path:"/page/maf"}] }`。**不加 `adminOnly`**（全员可见；`/health.enabled=false` 由 `MafHealthGate` 客户端控制页面空态）。
|
|
||||||
|
|
||||||
## 实施顺序
|
|
||||||
1. `api/types.ts` + `api/client.ts`（地基）
|
|
||||||
2. `api/{sessions,runs,events,approvals}.ts`（端点 hook）
|
|
||||||
3. `hooks/{use-maf-run-status,use-maf-events}.ts`（轮询核心）
|
|
||||||
4. `lib/{event-timeline,fact-flow-graph}.ts`（纯函数）
|
|
||||||
5. `components/*`（6 个组件）
|
|
||||||
6. `pages/*`（2 个页面）+ `index.ts`
|
|
||||||
7. `pages/MafRoutes.tsx` + 接入 `PageRoutes.tsx` + `sidebar-menu.ts`
|
|
||||||
8. `pnpm typecheck` + 手动核对路由/菜单显隐
|
|
||||||
|
|
||||||
## 文件清单
|
|
||||||
- **新建**（14）：`maf-roundtable/api/{types,client,sessions,runs,events,approvals}.ts`、`maf-roundtable/hooks/{use-maf-run-status,use-maf-events}.ts`、`maf-roundtable/lib/{event-timeline,fact-flow-graph}.ts`、`maf-roundtable/components/{MafRunHeader,MafEventTimeline,MafSeatStatusPanel,MafFactFlowPanel,MafApprovalCard,MafHealthGate}.tsx`、`maf-roundtable/pages/{MafSessionsPage,MafRunDetailPage}.tsx`、`maf-roundtable/index.ts`、`pages/MafRoutes.tsx`
|
|
||||||
- **改动**（2）：`pages/PageRoutes.tsx`、`core/page-layout/sidebar-menu.ts`
|
|
||||||
- **后端**：无改动
|
|
||||||
|
|
||||||
## 验证
|
|
||||||
- `pnpm typecheck`（tsc --noEmit）通过
|
|
||||||
- 手动：菜单「MAF 会商」→ 列表 → 新建会话 → 启动 run → 时间线滚动 → 席位状态更新 → 流程图随 confirmed_facts 增长 → 审批可批准 → 终态停轮询
|
|
||||||
- 退路：`/health.enabled=false` → 入口可见但页面显示未启用提示；旧 `roundtable-planning` 零改动
|
|
||||||
@@ -1,103 +0,0 @@
|
|||||||
# AGENTS.md
|
|
||||||
|
|
||||||
This file provides guidance to Codex (Codex.ai/code) when working with code in this repository.
|
|
||||||
|
|
||||||
## Project Overview
|
|
||||||
|
|
||||||
This is a customized offline deployment of **DeerFlow** — a LangGraph-based AI super agent platform. The repo contains two sub-projects:
|
|
||||||
|
|
||||||
- `offline-backend-20260512/backend/` — Python backend (FastAPI Gateway + LangGraph agent runtime)
|
|
||||||
- `frontend-web/` — Vite + React 19 frontend (TypeScript, pnpm)
|
|
||||||
|
|
||||||
Managed together via shell scripts in `scripts/`.
|
|
||||||
|
|
||||||
## Commands
|
|
||||||
|
|
||||||
### Full Application (from repo root)
|
|
||||||
|
|
||||||
```bash
|
|
||||||
./scripts/start-all.sh # Start backend + frontend as background daemons
|
|
||||||
./scripts/stop-all.sh # Stop both
|
|
||||||
./scripts/restart-all.sh # Restart both
|
|
||||||
./scripts/status.sh # Check running status
|
|
||||||
```
|
|
||||||
|
|
||||||
Logs and PID files are written to `.runtime/logs/` and `.runtime/pids/`.
|
|
||||||
|
|
||||||
### Backend Only (from `offline-backend-20260512/backend/`)
|
|
||||||
|
|
||||||
```bash
|
|
||||||
make install # Install Python dependencies (uv)
|
|
||||||
make dev # Run Gateway API with hot-reload on port 8001
|
|
||||||
make gateway # Run Gateway API without reload
|
|
||||||
make test # Run all tests: PYTHONPATH=. uv run pytest tests/ -v
|
|
||||||
make lint # Lint with ruff
|
|
||||||
make format # Format with ruff
|
|
||||||
```
|
|
||||||
|
|
||||||
Run a single test file:
|
|
||||||
```bash
|
|
||||||
PYTHONPATH=. uv run pytest tests/test_<feature>.py -v
|
|
||||||
```
|
|
||||||
|
|
||||||
### Frontend Only (from `frontend-web/`)
|
|
||||||
|
|
||||||
```bash
|
|
||||||
pnpm install # Install dependencies
|
|
||||||
pnpm dev # Start Vite dev server on port 5174
|
|
||||||
pnpm build # Production build
|
|
||||||
pnpm typecheck # TypeScript type checking (tsc --noEmit)
|
|
||||||
```
|
|
||||||
|
|
||||||
## Service Ports
|
|
||||||
|
|
||||||
| Service | Port | Notes |
|
|
||||||
|---------|------|-------|
|
|
||||||
| Backend (Gateway API) | 8001 | FastAPI + LangGraph runtime |
|
|
||||||
| Frontend (Vite) | 5174 | React SPA |
|
|
||||||
|
|
||||||
Frontend connects to backend via env vars `VITE_BACKEND_BASE_URL` and `VITE_LANGGRAPH_BASE_URL` (injected by `scripts/start-frontend.sh`).
|
|
||||||
|
|
||||||
## Architecture
|
|
||||||
|
|
||||||
### Backend
|
|
||||||
|
|
||||||
The backend (`offline-backend-20260512/backend/`) is split into two layers:
|
|
||||||
|
|
||||||
- **`packages/harness/deerflow/`** — publishable agent framework (`deerflow.*` imports): LangGraph lead agent, middleware chain, sandbox, tools, MCP, memory, models, skills. **Never imports from `app.*`.**
|
|
||||||
- **`app/`** — application layer (`app.*` imports): FastAPI Gateway routers, IM channel integrations (Feishu, Slack, Telegram, DingTalk).
|
|
||||||
|
|
||||||
The **Lead Agent** (`deerflow/agents/lead_agent/`) is the single LangGraph graph entry point. It wraps a middleware chain (~18 middlewares assembled in strict order) around LLM calls, handling: thread isolation, sandbox lifecycle, uploads, memory, plan mode, vision, subagent delegation, and loop detection.
|
|
||||||
|
|
||||||
**Middleware order matters** — middlewares are appended in a fixed sequence; `ClarificationMiddleware` must always be last. See `offline-backend-20260512/backend/AGENTS.md` for the full ordered list.
|
|
||||||
|
|
||||||
**Harness → App import firewall** is enforced by `tests/test_harness_boundary.py` (runs in CI).
|
|
||||||
|
|
||||||
### Frontend
|
|
||||||
|
|
||||||
The frontend (`frontend-web/`) is a React 19 + Vite SPA:
|
|
||||||
|
|
||||||
- **Routing**: React Router v7; top-level routes in `src/pages/PageRoutes.tsx`, workspace sub-routes in `src/pages/WorkspaceRoutes.tsx`
|
|
||||||
- **Pages**: `ChatPage` (thread chat), `AgentChatPage` (custom agent chat), `AgentsPage`/`NewAgentPage` (agent management), `ScheduledTasksPage`/`ScheduledTaskRunDetailPage` (scheduled tasks), `LightAppManagementPage`/`LightAppListPage`/`LightAppIframeView` (轻应用中心 — register/list/embed mini-apps)
|
|
||||||
- **AI 写作·对话版（对话驱动写作台）**: a **parallel new entry** beside the classic AI-writing page (classic page/routes untouched) — route `/page/canvas/ai-writing-chat`, sidebar 「问答管理 → 课题研究(对话版)」. Page `open-canvas/pages/AIWritingChatPage.tsx` reuses the engine (`AIWritingContext` + `useStream` + `AIWritingDraftPanel`); **idle keeps the classic setup layout** (`WritingSetupChat` + collapsible form) and switches to the chat workbench once writing starts; left panel `components/ai-writing-chat/WritingChatPanel.tsx` = **unified chronological feed** (`ChatFlowTimeline.tsx`, chat bubbles anchor-interleaved into the progress timeline so triggered events render below the user's message) + button-only intervention cards (`ChatInterventionCards.tsx`, inline textareas removed) + bottom unified smart composer. Intent resolution: frontend fast path + `POST /api/ai-writing/sessions/{id}/intent` → `deerflow/agents/ai_writing/intent_router.py` (per-pause action whitelist, high-cost confidence gates, payload cleaning); supports QA bypass, clarify follow-ups, control intents, and material-stage auto re-search + pending-intent resume. Tests `tests/test_ai_writing_intent.py`; plan doc `frontend-web/docs/ai-writing-对话驱动写作台-实现方案.md`.
|
|
||||||
- **轻应用中心 (Light App Center)**: a sibling of 任务管理 in the sidebar with two pages — 应用管理 (admin registers `window_open` or `iframe` mini-apps with a route-param builder: login params resolved from `localStorage.userInfo`, theme params literal) and 应用列表 (card grid of `window_open` apps, `window.open` launch). `iframe` apps are mounted under a chosen parent menu (XK/PG/TY/综合管理) and **dynamically injected into the sidebar** by `core/page-layout/use-sidebar-menu.ts` (`useSidebarMenuItems`), opening in the `LightAppIframeView` host. Client + React Query hooks in `strategy-components/api/light-apps.ts`; URL builder/constants in `strategy-components/lib/light-app.ts`. Backend: `/api/light-apps` (global/shared, admin-gated writes).
|
|
||||||
- **菜单管理 (Menu Management, admin-only)**: an **overlay** over the static sidebar menu — `MenuManagementPage` (`pages/MenuManagementPage.tsx`, route `/page/strategy/admin/menu-management`, opened from the admin-only 「菜单管理」 item in the **bottom-left settings dropdown** of `components/page-sidebar.tsx`). Admins rename / 停用·启用 / reorder (↑↓ or @dnd-kit drag) / re-parent (horizontal drag **or** the edit dialog's 「移动到」parent selector) any node across 一级/二级/三级, **including injected iframe light-app nodes** (`light-app-<appId>`). The static tree (`core/page-layout/sidebar-menu.ts`) stays the source of icons/routes; only per-node deltas (`label`/`disabled`/`parentId`/`sortOrder`) persist to the backend. Merge logic in `core/page-layout/menu-overrides.ts` (`applyMenuOverrides`, applied in `use-sidebar-menu.ts` after light-app injection, before role filter; disabling a node hides its whole subtree) — strict **3-level cap** (`wouldExceedDepth`). Client `strategy-components/api/menu-overrides.ts`. Backend: `/api/menu-overrides` (global/shared; open read, admin atomic replace-all).
|
|
||||||
- **敏感词管理 (Sensitive Word Management)**: configures the **展示层脱敏映射** (原始词 → 替换词). **Gated on the username `lqq`** (not the admin role) — `getAccountDisplayName().toLowerCase() === "lqq"` (username = email `@` prefix, else `user_id`, same as the profile page); the dropdown entry, the route guard, and the page-level guard all use this check. `src/lib/desensitize.ts` ships a frozen seed map `SEED_DESENSITIZE_MAP` (the deployment seed) plus a live mutable `DESENSITIZE_MAP` (initialized from the seed so `desensitize()` works before any fetch). `DesensitizeWordsLoader` (mounted in `App.tsx` `AppProviders`) fetches `/api/sensitive-words` on startup and, if non-empty, calls `replaceDesensitizeMap(...)` to make the backend config the source of truth (empty/failed → keep seed). Page `SensitiveWordsPage.tsx` (route `/page/strategy/admin/sensitive-words`, opened from the 「敏感词管理」 item in the **bottom-left settings dropdown** of `components/page-sidebar.tsx`, present in **both** full + collapsed sidebar modes) lists/adds/edits/启停/deletes words and saves the **whole set atomically** (replace-all); a 「导入种子词」 button merges any missing `SEED_DESENSITIZE_MAP` entries into the editor. Client + hooks in `strategy-components/api/sensitive-words.ts` (`wordsToMap` folds enabled rows into the runtime map). Backend: `/api/sensitive-words` (global/shared; open read, write allowed for admin **or** the `lqq` account), mirroring 菜单管理's store shape. **侧边栏 + 导航栏 menu labels are desensitized** at the data source: `useSidebarMenuItems`/`useActiveThirdLevel` (`core/page-layout/use-sidebar-menu.ts`) map every node's `label` through a desensitizer built **directly from the `/api/sensitive-words` query** (`makeDesensitizer(wordsToMap(words))`, falling back to the global seed `desensitize` while empty) — this sidesteps the `replaceDesensitizeMap` effect-timing race. Only `label` is rewritten; `path`/`id`/`icon` are untouched so routing/highlight are unaffected. All nav surfaces (`page-sidebar.tsx`, `page-sidebar-dark.tsx`, `page-sidebar-v1.tsx`, `strategy-components/Header.tsx`, `PageRoutes.tsx`) consume this hook and are covered; `MenuManagementPage` uses the raw tree so admins still edit real labels.
|
|
||||||
- **技能地址管理 (Skill Address Management, admin-only)**: 扫描运行中的技能（`skills/{public,custom}` 下所有 `.md`/`.py`）里的 **http(s) URL 与 IP/IP:端口**，按唯一地址聚合全部出现位置（跨 .md/.py），支持**批量替换**（如把 UAT 地址一次性改成生产）。主体抽成可复用组件 `SkillAddressesPanel`（`pages/SkillAddressesPage.tsx` 导出，默认导出 `SkillAddressesPage` 仍保留旧路由 `/page/strategy/admin/skill-addresses` 作直链回退），**作为「技能地址管理」标签页嵌入管理员「技能管理」页 `pages/AdminSkillsPage.tsx`**（该页加 Tabs：「技能列表」+「技能地址管理」；入口在「设置和更多」下拉的「技能管理」`workspace-nav-menu.tsx` → `/page/workspace/admin/skills`，不再单列于 `components/page-sidebar.tsx` 左下角设置下拉）：打开自动扫描并带**进度条**（扫描逐技能 / 应用逐文件 X/N，应对 150+ 技能），URL/IP 类型过滤 + 搜索 + 「片段批量套用」（如所有 `uat.4.cn` → `prod.4.cn`）、每地址「替换为」输入框（可展开看 `file:line` 片段）、内联**预览**、**应用**、**多关键词检索**（空格分隔全部命中），以及**修改记录**面板——每次应用生成一条记录（显示时间/改了哪些地址 from→to/文件数/处数），可**针对单次记录回退**（二次确认）。client + NDJSON 流式解析在 `strategy-components/api/skill-addresses.ts`。后端 `/api/skill-addresses`（**仅管理员**）：所有文件 IO 走 `asyncio.to_thread` 不阻塞事件循环；`GET /scan`(+`/scan/stream`)、`POST /preview`、`POST /apply`(+`/apply/stream`)、`GET /backups`、`POST /rollback/{id}`；**子串安全替换**（基于 token span，不会误伤子串）、`expected_total` 乐观锁（409）、写前自动磁盘备份到 `{skills_root}/.address-edits/`（同时写一份 `{id}.manifest.json` 记录本次替换明细，供修改记录展示）、应用后刷新技能系统提示缓存。纯引擎 `deerflow/skills/address_scan.py`，router `app/gateway/routers/skill_addresses.py`，tests `tests/test_skill_addresses.py`。范围仅运行中技能，不动 `deploy/minimal/skills/`。
|
|
||||||
- **按钮管理 (Task Button Management, admin-only)**: configures the **可配置跳转按钮** rendered in the left task panel of the task deep-link workspaces (rwfx / 3qfx / xdfx, see `TaskFxWorkspace`). Each button = `{business, label, linkType, target, appendTaskId, idParam, idKind, enabled, sortOrder}`; `linkType` is `url` (外链 `window.open`, optional append of `?{idParam}={id}` — **`idParam` is the editable query-param name**, e.g. `id`/`task_id`), `business` (内部切换到另一业务, reuses `resolveTaskDeeplinkTarget`, always task id), or `purpose` (弹出当前任务的「任务目的」表格 via the shared `TaskPurposeDialog`, no target — configurable for any page incl. xdfx). **`idKind` (`task`/`action`) only matters for xdfx**: its deep-link `?taskId=` is an 行动id and the 任务id is resolved at login (`fetchTaskIdFromAction`) — `TaskContext` now also stashes the raw `actionId`, so a url button can append either (default `task`). Page `TaskButtonsPage.tsx` (route `/page/strategy/admin/task-buttons`, **admin-gated**, entry「按钮管理」in the bottom-left settings dropdown of `components/page-sidebar.tsx`, both full + collapsed modes) has per-business tabs, edits name/type/target/启停/排序/增删, saves the **whole set atomically** (replace-all), plus 「导入默认」 to merge code-seed defaults. **Seed/fallback** (like 敏感词管理): only when the whole table is empty (fresh deploy, never saved) do the workspace + page fall back to `defaultTaskButtons(cfg)` — rwfx's url buttons (编辑/下一步/3q详情) built from the **live** `/api/public/config/task-deeplink` plus cross-business switch buttons for **all three** businesses (each switches to the other two — rwfx→三情/行动, 3qfx→任务/行动, xdfx→任务/三情). Once saved, the store is the sole source of truth. The old hardcoded jump buttons were migrated out: `TaskFxWorkspace` no longer hardcodes 切换到三情分析, `TaskActionsPanel` keeps only the non-jump 清除记录, and `TaskPurposePanel` dropped its 3q详情 button (now configurable) **and defaults the 目的树 table to collapsed** (chevron toggle). Helpers `core/auth/task-buttons.ts` (`TaskButton`, `defaultTaskButtons`, `resolveTaskButtons`, `buttonsForBusiness`, `runTaskButton`), client+hooks `strategy-components/api/task-buttons.ts`. Backend: `/api/task-buttons` (global/shared; open read, admin replace-all), store `deerflow.persistence.task_buttons` (table `task_buttons`, auto-created by `create_all`), wired `app.state.task_button_store`. Tests: `tests/test_task_buttons.py`.
|
|
||||||
- **State**: TanStack Query for server state, context providers (`SubtasksProvider`, `ArtifactsProvider`, `PromptInputProvider`) scoped to `WorkspaceRoutes`
|
|
||||||
- **LLM streaming**: `@langchain/langgraph-sdk` streams messages from the backend via SSE
|
|
||||||
- **UI**: Radix UI primitives + TailwindCSS v4 + shadcn-style components in `src/components/ui/`
|
|
||||||
- **Shims**: `src/shims/` provides `next/link` and `next/navigation` polyfills (original code was Next.js)
|
|
||||||
- **Login URL params** (`LoginPage.tsx`, frontend-only — the backend never sees these): besides the auth params (`ticket`/`userId`/`env`/`theme`/`yUserId`/`token`/`access_token`/`authToken`/`password`), the page supports a **task deep-link** via `?taskId=&goPath=`. After login it calls the consumer API `GET {VITE_AIPI_CONSUMER_URL}/taskAnalyseSearch/cop-task-detail?taskId=` (header `Authorization: Bearer admin`, auto-injected by `utils/request.ts`), stashes the full `data` (`id/overview/taskDirection/taskName/taskContent`) into `sessionStorage["login.copTaskDetail"]`, then routes by `goPath`: base codes `3qfx`/`rwfx`/`xdfx` → that business's configured **single agent** Q&A inside a **任务工作区** (resolved via `/api/business-mapping`; `resolveTaskDeeplinkTarget` calls `persistTaskContext({taskId, agentId, openingText})` and navigates to the `…/chats` **index**, which opens the latest task conversation or 新建 — a 1:N task↔对话 workspace, NOT `pendingAgentMessage`); the `-A` suffix (`3qfx-A`/…) → **multi-agent roundtable** with `roundtablePrefill.businessCode` so the page auto-selects the configured 业务链条. **xdfx's deep-link `?taskId=` is actually an 行动id, not a 任务id** — `resolveDeeplinkTaskId(goPath, rawId)` (called in `LoginPage` before everything) detects `xdfx`/`xdfx-A` and resolves it via `GET {action_detail_url}/{actionId}` → `data.taskId` (`fetchTaskIdFromAction`; `action_test`+`mock.action_detail` for offline testing); the resolved 任务id then drives `cop-task-detail`, the purpose tree, and the 1:N binding (other businesses pass the id through unchanged). **xdfx additionally partitions its chat records by 行动id (action_id), NOT by task_id**: `resolveTaskDeeplinkTarget` sets `partitionByAction:true` + keeps the raw action_id as `TaskContext.actionId`, so new threads are tagged `metadata.{taskId,actionId}` (taskId kept only to preserve the backend「任务深链对话全局共享」semantics, which keys off `metadata.taskId`) and the conversation list filters by `actionId` (+`agent_id`) — different actions of the same task get separate lists. xdfx's first-question opening text also appends `行动id（action_id）为…` (see `buildOpeningText` / `taskThreadMetadata`). goPath→businessCode: `3qfx`→`3Q`, `rwfx`→`6BF`, `xdfx`→`7BF`. The roundtable target also threads the URL `taskId` into `roundtablePrefill.taskId` (`resolveTaskDeeplinkTarget(goPath, detail, taskId)`), which turns on two taskId-scoped behaviors: (1) **separate, unpartitioned per-task storage** — taskId 会商聊天记录 live in their **own** store/table (`roundtable_task_drafts`), keyed **only by `task_id`** (one taskId = many records, shared across users, **no user 分权** at all; `created_by` is audit-only), kept entirely out of the per-user personal store (`roundtable_drafts`, now strictly per-user) so the two never mix. Backend router `/api/roundtable-task-drafts` (`GET /by-task/{id}` + `/by-task/{id}/latest`, `POST`, `GET/PUT/DELETE /{id}` — all user-agnostic); frontend client `roundtable-planning/api/task-drafts.ts`, and `useDraftPersistence`/`useRoundtableDrafts` route **all** CRUD to it when a `taskId` is present (else the personal `drafts.ts`). The matching **background jobs** are shared by task too: `roundtable_jobs.task_id` marks a task job; reads/dedup/stream/resume/cancel pass `?task_id=` so any user opening the task sees the same running 研讨 (progress/flowchart), and the executor writes the final report back to the task-draft store. Existing rows are moved over by `scripts/migrate_roundtable_task_drafts.py` (migration `20260618_01`). The history dropdown filters to the task and 新建 keeps the binding; (2) **Step-3 auto structured output** — after the `roundtable-summary` agent writes the Markdown report it automatically runs a second round emitting a `flow-json` flowchart (`useStep3Summary` `autoFlow`+`chainLevels`), whose hierarchy follows the business chain's stage goals (任务 → 目的 → 行为体 → …; coordinatorPrompt-specified hierarchy wins) and whose nodes never carry 阶段编号/阶段名 (the prior bug). **Both targets render embedded under the 任务管理 layout** — nested routes under `task-management/<business-path>/{roundtable,agent/:agent_id/chats}` in `StrategyRoutes.tsx` (`<business-path>` = `plan-task-sentiment` / `plan-task/plan-task-fx` / `plan-task/plan-task-action`, matching the COH中任务 menu paths in `sidebar-menu.ts`) so the global sidebar keeps 任务管理 → COH中任务 → the matching business highlighted. **All three single-agent businesses share `TaskFxWorkspace`** (`task-components/TaskFxWorkspace.tsx`): left = a「当前任务」card (`readCopTaskDetail()` 任务名称 + 简介, desensitized, 留存 above 新建对话) + per-task 1:N conversation list (`useTaskThreads(taskId, agentId, actionId?)` — filtered by **both** `metadata.taskId` AND `metadata.agent_id` so the three businesses' conversations staLine truncated
|
|
||||||
- **iframe 嵌入模式 (外部系统用 iframe 套用深链问答/会商)** — 三个**按标签页**开关，全部由深链 URL 参数开启、存进同一份 `sessionStorage` 会话（`embed.session`，键名常量在 `core/embed/embed-session.ts`），跨登录跳转/刷新/页内导航存活，**绝不跨标签污染**同浏览器另开的正常系统页。核心隔离手法：用 `sessionStorage`（按标签页/浏览上下文隔离，iframe 即便同源也有独立一份）而非 `localStorage`（跨标签共享）。开关：(1) **`?embed=1`（可带 `&theme=`）** — 去全局 chrome（`PageLayout` 的 `pageSidebarAllowed && !isEmbedActive()` → 隐藏 Header + PageSidebar）+ 按外部主题色**强制**明/暗：走 next-themes 的 `forcedTheme`（`App.tsx` `AppProviders` 调 `resolveForcedEmbedTheme`，**不写** localStorage `strategy-theme`），离散映射 `dark-blue`/`dark`→深、其余→浅；嵌入侧**绝不**调 `setTheme`/`persistSidebarEnabled`（那俩落 localStorage 跨标签污染，`LoginPage` 据 `readEmbedParam` 跳过）。(2) **`?hideJump=1`** — 隐藏深链底部「快捷跳转」栏 `TaskJumpBar` 的两部分（底部「下一步」等按钮 + 右侧垂直居中悬浮菜单），单智能体问答 + 会商共用该栏，`isJumpBarHidden()` 为真时整条 `return null`。(3) **登录用户隔离** — 嵌入态下鉴权/身份键（`deerflow.auth` token、`userInfo`、`login.*`、`tools_token`、maxkey/userDetail token）全部经 `core/auth/scoped-storage.ts` 的 `authStorage()`（嵌入→sessionStorage / 正常→localStorage）读写，使 iframe 里登录的用户与正常登录用户**完全隔离**、互不覆盖；所有 token 读取都过 `getStoredAuth()`/`getAuthorizationHeaderValue()`（API 客户端 `core/api/*` 全走这俩），改中心函数即让全体调用方自动隔离；跨标签账号变更监听 `AuthSyncWatcher`（`core/auth/sync.tsx`）在嵌入态禁用。嵌入会话在 `main.tsx` 渲染前 `syncEmbedSessionFromCurrentUrl()` 同步启用（早于任何鉴权写入，避免首帧 effect 顺序漏写 localStorage）；`AppProviders` 的 effect 再按 SPA 导航同步。`embed=0`/`hideJump=0` 可显式关闭。正常（非嵌入）标签页所有 `isXxx()` 恒 false，行为**零变化**。第三个开关 `?isolate=1`（**独立登录会话**）把同一套**登录用户隔离**单独提供给**普通（带 chrome）标签页**——只切换鉴权存储、不去 chrome / 不强制主题 / 不动跳转栏：`authStorage()` 的条件从「仅嵌入」放宽为 `isEmbedActive() || isIsolatedSession()`，`AuthSyncWatcher` 的跨标签监听对嵌入态**或**独立态都即时忽略（handler 内实时判，运行时开关也即刻生效）。除 URL 参数外，**设置 → 外观 →「登录会话」** 有一个 Switch「独立登录会话（本标签页）」运行时切换（`setIsolatedSession`，`appearance-settings-page.tsx`）：**开启时先 `migrateAuthToSession()`**（`scoped-storage.ts`，把 localStorage 的受保护键 `deerflow.auth`/`userInfo`/`userId`/`tools_token` + `login.*` 前缀快照搬进 sessionStorage）再翻标志，故无感不登出；此后本标签页登录态独立——别处登录/换号影响不到它，它换号也影响不到别人，但关掉该标签即结束（需重登）。开启给 toast 提示。
|
|
||||||
|
|
||||||
### Configuration
|
|
||||||
|
|
||||||
Backend config lives in `offline-backend-20260512/backend/config.yaml`. Values starting with `$` resolve as environment variables (e.g., `$OPENAI_API_KEY`). MCP servers and skills are configured in `extensions_config.json` in the same directory.
|
|
||||||
|
|
||||||
## Detailed Backend Reference
|
|
||||||
|
|
||||||
The backend has its own comprehensive documentation at:
|
|
||||||
- `offline-backend-20260512/backend/AGENTS.md` — architecture, middleware chain, all API routes, config schema, sandbox/memory/subagent systems
|
|
||||||
- `offline-backend-20260512/backend/README.md` — setup guide, technology stack
|
|
||||||
@@ -1,108 +0,0 @@
|
|||||||
# CLAUDE.md
|
|
||||||
|
|
||||||
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
|
||||||
|
|
||||||
## Project Overview
|
|
||||||
|
|
||||||
This is a customized offline deployment of **DeerFlow** — a LangGraph-based AI super agent platform. The repo contains two sub-projects:
|
|
||||||
|
|
||||||
- `offline-backend-20260512/backend/` — Python backend (FastAPI Gateway + LangGraph agent runtime)
|
|
||||||
- `frontend-web/` — Vite + React 19 frontend (TypeScript, pnpm)
|
|
||||||
|
|
||||||
Managed together via shell scripts in `scripts/`.
|
|
||||||
|
|
||||||
## Commands
|
|
||||||
|
|
||||||
### Full Application (from repo root)
|
|
||||||
|
|
||||||
```bash
|
|
||||||
./scripts/start-all.sh # Start backend + frontend as background daemons
|
|
||||||
./scripts/stop-all.sh # Stop both
|
|
||||||
./scripts/restart-all.sh # Restart both
|
|
||||||
./scripts/status.sh # Check running status
|
|
||||||
```
|
|
||||||
|
|
||||||
Logs and PID files are written to `.runtime/logs/` and `.runtime/pids/`.
|
|
||||||
|
|
||||||
### Backend Only (from `offline-backend-20260512/backend/`)
|
|
||||||
|
|
||||||
```bash
|
|
||||||
make install # Install Python dependencies (uv)
|
|
||||||
make dev # Run Gateway API with hot-reload on port 8001
|
|
||||||
make gateway # Run Gateway API without reload
|
|
||||||
make test # Run all tests: PYTHONPATH=. uv run pytest tests/ -v
|
|
||||||
make lint # Lint with ruff
|
|
||||||
make format # Format with ruff
|
|
||||||
```
|
|
||||||
|
|
||||||
Run a single test file:
|
|
||||||
```bash
|
|
||||||
PYTHONPATH=. uv run pytest tests/test_<feature>.py -v
|
|
||||||
```
|
|
||||||
|
|
||||||
### Frontend Only (from `frontend-web/`)
|
|
||||||
|
|
||||||
```bash
|
|
||||||
pnpm install # Install dependencies
|
|
||||||
pnpm dev # Start Vite dev server on port 5174
|
|
||||||
pnpm build # Production build
|
|
||||||
pnpm typecheck # TypeScript type checking (tsc --noEmit)
|
|
||||||
```
|
|
||||||
|
|
||||||
## Service Ports
|
|
||||||
|
|
||||||
| Service | Port | Notes |
|
|
||||||
|---------|------|-------|
|
|
||||||
| Backend (Gateway API) | 8001 | FastAPI + LangGraph runtime |
|
|
||||||
| Frontend (Vite) | 5174 | React SPA |
|
|
||||||
|
|
||||||
Frontend connects to backend via env vars `VITE_BACKEND_BASE_URL` and `VITE_LANGGRAPH_BASE_URL` (injected by `scripts/start-frontend.sh`).
|
|
||||||
|
|
||||||
## Architecture
|
|
||||||
|
|
||||||
### Backend
|
|
||||||
|
|
||||||
The backend (`offline-backend-20260512/backend/`) is split into two layers:
|
|
||||||
|
|
||||||
- **`packages/harness/deerflow/`** — publishable agent framework (`deerflow.*` imports): LangGraph lead agent, middleware chain, sandbox, tools, MCP, memory, models, skills. **Never imports from `app.*`.**
|
|
||||||
- **`app/`** — application layer (`app.*` imports): FastAPI Gateway routers, IM channel integrations (Feishu, Slack, Telegram, DingTalk).
|
|
||||||
|
|
||||||
The **Lead Agent** (`deerflow/agents/lead_agent/`) is the single LangGraph graph entry point. It wraps a middleware chain (~18 middlewares assembled in strict order) around LLM calls, handling: thread isolation, sandbox lifecycle, uploads, memory, plan mode, vision, subagent delegation, and loop detection.
|
|
||||||
|
|
||||||
**Middleware order matters** — middlewares are appended in a fixed sequence; `ClarificationMiddleware` must always be last. See `offline-backend-20260512/backend/CLAUDE.md` for the full ordered list.
|
|
||||||
|
|
||||||
**Harness → App import firewall** is enforced by `tests/test_harness_boundary.py` (runs in CI).
|
|
||||||
|
|
||||||
### Frontend
|
|
||||||
|
|
||||||
The frontend (`frontend-web/`) is a React 19 + Vite SPA:
|
|
||||||
|
|
||||||
- **Routing**: React Router v7; top-level routes in `src/pages/PageRoutes.tsx`, workspace sub-routes in `src/pages/WorkspaceRoutes.tsx`
|
|
||||||
- **Pages**: `ChatPage` (thread chat), `AgentChatPage` (custom agent chat), `AgentsPage`/`NewAgentPage` (agent management), `ScheduledTasksPage`/`ScheduledTaskRunDetailPage` (scheduled tasks), `LightAppManagementPage`/`LightAppListPage`/`LightAppIframeView` (轻应用中心 — register/list/embed mini-apps)
|
|
||||||
- **定时任务「JSON → HTML 模板填充」(模板数据转换器)**: a third scheduled-task execution mode. In the create/edit dialog (`ScheduledTasksPage.tsx`), selecting the built-in agent **「模板数据转换器」** (`execution_agent_name === "template-json-builder"`, `TEMPLATE_BUILDER_AGENT_ID`) reveals a 「HTML模板」 select (`useHtmlTemplates` → `GET /api/scheduled-tasks/html-templates`) + a **.json 上传** button (reads the file's text into the prompt box) and **hides** the 必须生成 HTML/Markdown switches (this mode always outputs HTML). The chosen template persists as `execution_context.template_config.template_id` (`TemplateFillConfig` in `core/scheduled-tasks/types.ts`). At run time the backend converts the source JSON (the task prompt) into that template's `DATA` structure, validates (retry-on-fail), fills the template, and stores an HTML page previewable via the existing run-detail HTML preview. The source can be **pure JSON, plain text, or text-with-embedded-JSON** — the backend pre-extracts any embedded JSON and the agent's `SOUL.md` maps it (or the plain text's semantics) to the template's schema skeleton. **Chat-page debug entry (only this agent's `AgentChatPage`)**: when `agent_id === "template-json-builder"`, the chat header shows a 「页面模板」 select + a 「渲染预览」 button — after a normal Q&A run, the button takes the **latest AI reply**, POSTs it to `POST /api/scheduled-tasks/template-fill/render` (`renderTemplateFill`), and pops a dialog rendering the filled HTML in a `sandbox="allow-scripts"` iframe plus the structure-validation status/errors/gaps — for debugging the agent's conversion effect without creating a scheduled task. Gated strictly on the agent id, so other agents' chat pages are untouched. See the backend CLAUDE.md「Template-fill mode」for the engine (`deerflow/runtime/scheduler/template_fill.py`), agent seed, dispatch, and the render API.
|
|
||||||
- **AI 写作·对话版（对话驱动写作台）**: a **parallel new entry** beside the classic AI-writing page (classic page/routes untouched) — route `/page/canvas/ai-writing-chat` (`OpenCanvasRoutes.tsx`), sidebar 「问答管理 → 课题研究(对话版)」. Page `open-canvas/pages/AIWritingChatPage.tsx` fully **reuses the engine** (`AIWritingContext` state machine + LangGraph `useStream`, `AIWritingHistoryProvider`, right-side `AIWritingDraftPanel`) but replaces the presentation: left = `components/ai-writing-chat/WritingChatPanel.tsx` (timeline + **button-only intervention cards** `ChatInterventionCards.tsx` — the five pause cards copied from `InterventionCard.tsx` with all inline textareas removed, confirm/action buttons kept — plus a bottom **unified smart composer**). Free text goes through two-level intent resolution (`open-canvas/api/ai-writing-intent.ts`): deterministic short-phrase fast path (确认/继续/重新搜索/重写大纲…; high-cost actions never fast-pathed) then `POST /api/ai-writing/sessions/{id}/intent` — the backend reads the graph checkpoint (authoritative pause point from the pending interrupt) and routes via `deerflow/agents/ai_writing/intent_router.py` (LLM + strict per-pause action whitelist aligned to the graph's real resume actions, confidence gates: finalize/force_finalize/覆盖式 re_search need ≥0.85 else clarify, payload key-whitelist cleaning). Results map to `submitIntervention`/control (暂停/继续/后台挂起)/QA bypass (`answer` rendered as a chat bubble, never touches graph state)/clarify (amber follow-up bubble with multi-turn context). **Two-state layout**: idle (未开始写作) renders the **classic setup experience unchanged** — `WritingSetupChat` + collapsible `AIWritingPanel` form under `WritingFormProvider` (same as `AIWritingPage`'s idle branch); once writing starts (or history view opens) it switches to the chat workbench. **Unified chronological feed** (`ChatFlowTimeline.tsx`): intent-layer chat bubbles are interleaved INTO the progress-event timeline by anchor (= `progressEvents.length` at message creation), so events triggered by a user message render **below** it (Google-AI-Studio-style single stream, not timeline-above/chat-below); composer-driven interventions suppress the duplicate 「我的要求」card (`suppressedRequirementIndices`). **素材不足自动续跑** only at `material_confirm` (the only pause the graph supports re-search from): needResearch caches the payload as a pending intent, submits `re_search + userQuery`, and auto-submits the pending intent when the new material-confirm pause arrives (cancellable pill). Stage chips + per-stage placeholder + 「当前交互对象」status badge. Backend tests `tests/test_ai_writing_intent.py`. Plan doc: `frontend-web/docs/ai-writing-对话驱动写作台-实现方案.md`.
|
|
||||||
- **轻应用中心 (Light App Center)**: a sibling of 任务管理 in the sidebar with two pages — 应用管理 (admin registers `window_open` or `iframe` mini-apps with a route-param builder: login params resolved from `localStorage.userInfo`, theme params literal) and 应用列表 (card grid of `window_open` apps, `window.open` launch). `iframe` apps are mounted under a chosen parent menu (XK/PG/TY/综合管理) and **dynamically injected into the sidebar** by `core/page-layout/use-sidebar-menu.ts` (`useSidebarMenuItems`), opening in the `LightAppIframeView` host. Client + React Query hooks in `strategy-components/api/light-apps.ts`; URL builder/constants in `strategy-components/lib/light-app.ts`. Backend: `/api/light-apps` (global/shared, admin-gated writes).
|
|
||||||
- **菜单管理 (Menu Management, admin-only)**: an **overlay** over the static sidebar menu — `MenuManagementPage` (`pages/MenuManagementPage.tsx`, route `/page/strategy/admin/menu-management`, opened from the admin-only 「菜单管理」 item in the **bottom-left settings dropdown** of `components/page-sidebar.tsx`). Admins rename / 停用·启用 / reorder (↑↓ or @dnd-kit drag) / re-parent (horizontal drag **or** the edit dialog's 「移动到」parent selector) any node across 一级/二级/三级, **including injected iframe light-app nodes** (`light-app-<appId>`). The static tree (`core/page-layout/sidebar-menu.ts`) stays the source of icons/routes; only per-node deltas (`label`/`disabled`/`parentId`/`sortOrder`) persist to the backend. Merge logic in `core/page-layout/menu-overrides.ts` (`applyMenuOverrides`, applied in `use-sidebar-menu.ts` after light-app injection, before role filter; disabling a node hides its whole subtree) — strict **3-level cap** (`wouldExceedDepth`). Client `strategy-components/api/menu-overrides.ts`. Backend: `/api/menu-overrides` (global/shared; open read, admin atomic replace-all).
|
|
||||||
- **白名单管理 (Login Whitelist, admin-only)**: gates **who may log in**, run as a **blocklist (黑名单模式)**. Two pieces: a global master switch (`system_settings.json → login_whitelist.enabled`, surfaced by **admin-only** `GET|PUT /api/system-settings/login-whitelist`) + a per-user **放行** flag (`users.approved` column, migration `20260625_02`). Users **self-register** as usual and **every new account defaults to `approved=True`** — so a user who has never logged into this system before is allowed straight through; the switch only blocks users an admin has explicitly **取消放行** (`approved=False`). (`create_user`/`User`/`UserRow` all default `approved=True`; admins are always approved; existing rows are backfilled `True`.) Login interception is the single helper `enforce_user_approved(user)` in `app/gateway/routers/auth.py`, called in all three login endpoints (`/login/{local,username,token}`) **after** the account is resolved/created and **before** the JWT is issued: switch off → everyone passes; `system_role=="admin"` → always passes (anti-lockout); else `approved=False` (admin-revoked) → 403 `{code:"PENDING_APPROVAL"}` (the frontend's `extractErrorMessage` surfaces the message and login throws before writing any auth state, so no half-login). Admin approves on `pages/LoginWhitelistPage.tsx` (route `/page/strategy/admin/login-whitelist`, entry「白名单管理」in the bottom-left settings dropdown of `components/page-sidebar.tsx`, both sidebar modes): a top master-switch + a list of all registered users (`GET /api/v1/auth/users`, now carrying `approved`) with a per-row 放行 Switch (`PUT /api/v1/auth/users/{id}/approval`, admin-only; revoking only blocks the **next** login — `token_version` is left untouched, existing sessions are not force-killed). Client/hooks: switch in `strategy-components/api/login-whitelist.ts`, user list + approval in `core/auth/{api,hooks}.ts` (`useSetUserApproval`). Backend tests: `tests/test_login_approval.py`. **账号级「登录口令」(per-account password — 临时开通)**: the same page also lets an admin assign one specific account an individual **plaintext** password (`users.login_password` column, migration `20260625_04`, nullable; auto-added on startup by `_ensure_orm_columns_sync`). Once set, **that account's** username login (`POST /api/v1/auth/login/username`) **requires** `?password=` to exactly match it and that personal password **takes precedence over** the global shared-password gate (`username_login.require_password`); accounts without one keep today's shared-gate / passwordless behavior. The user then logs in via the **existing** frontend URL `#/login/<用户名>?password=xxxx` (LoginPage already forwards `?password=`; `<用户名>` = the account's email `@`-prefix). **Plaintext is intentional** — the password rides in the URL query anyway, so storing it readably lets the admin re-copy the full login link from the page; it is exposed only on the **admin-only** `GET /api/v1/auth/users` (`UserListItem.login_password`) and the new admin-only `PUT /api/v1/auth/users/{id}/login-password` (set non-empty / clear with null·empty; doesn't touch `token_version`). The whitelist page renders a per-user 「登录口令」 column with a set/修改 editor + a live 「复制登录链接」 button (`useSetUserLoginPassword` in `core/auth/hooks.ts`, `setUserLoginPassword` in `core/auth/api.ts`). Backend gate helper `_lookup_user_by_username` (lookup-only, no auto-register) in `routers/auth.py`; tests `tests/test_login_personal_password.py`.
|
|
||||||
- **敏感词管理 (Sensitive Word Management)**: configures the **展示层脱敏映射** (原始词 → 替换词). **Gated on the username `lqq`** (not the admin role) — `getAccountDisplayName().toLowerCase() === "lqq"` (username = email `@` prefix, else `user_id`, same as the profile page); the dropdown entry, the route guard, and the page-level guard all use this check. `src/lib/desensitize.ts` ships a frozen seed map `SEED_DESENSITIZE_MAP` (the deployment seed) plus a live mutable `DESENSITIZE_MAP` (initialized from the seed so `desensitize()` works before any fetch). `DesensitizeWordsLoader` (mounted in `App.tsx` `AppProviders`) fetches `/api/sensitive-words` on startup and, if non-empty, calls `replaceDesensitizeMap(...)` to make the backend config the source of truth (empty/failed → keep seed). Page `SensitiveWordsPage.tsx` (route `/page/strategy/admin/sensitive-words`, opened from the 「敏感词管理」 item in the **bottom-left settings dropdown** of `components/page-sidebar.tsx`, present in **both** full + collapsed sidebar modes) lists/adds/edits/启停/deletes words and saves the **whole set atomically** (replace-all); a 「导入种子词」 button merges any missing `SEED_DESENSITIZE_MAP` entries into the editor. Client + hooks in `strategy-components/api/sensitive-words.ts` (`wordsToMap` folds enabled rows into the runtime map). Backend: `/api/sensitive-words` (global/shared; open read, write allowed for admin **or** the `lqq` account), mirroring 菜单管理's store shape. **侧边栏 + 导航栏 menu labels are desensitized** at the data source: `useSidebarMenuItems`/`useActiveThirdLevel` (`core/page-layout/use-sidebar-menu.ts`) map every node's `label` through a desensitizer built **directly from the `/api/sensitive-words` query** (`makeDesensitizer(wordsToMap(words))`, falling back to the global seed `desensitize` while empty) — this sidesteps the `replaceDesensitizeMap` effect-timing race. Only `label` is rewritten; `path`/`id`/`icon` are untouched so routing/highlight are unaffected. All nav surfaces (`page-sidebar.tsx`, `page-sidebar-dark.tsx`, `page-sidebar-v1.tsx`, `strategy-components/Header.tsx`, `PageRoutes.tsx`) consume this hook and are covered; `MenuManagementPage` uses the raw tree so admins still edit real labels.
|
|
||||||
- **技能地址管理 (Skill Address Management, admin-only)**: 扫描运行中的技能（`skills/{public,custom}` 下所有 `.md`/`.py`）里的 **http(s) URL 与 IP/IP:端口**，按唯一地址聚合全部出现位置（跨 .md/.py），支持**批量替换**（如把 UAT 地址一次性改成生产）。主体抽成可复用组件 `SkillAddressesPanel`（`pages/SkillAddressesPage.tsx` 导出，默认导出 `SkillAddressesPage` 仍保留旧路由 `/page/strategy/admin/skill-addresses` 作直链回退），**作为「技能地址管理」标签页嵌入管理员「技能管理」页 `pages/AdminSkillsPage.tsx`**（该页加 Tabs：「技能列表」+「技能地址管理」；入口在「设置和更多」下拉的「技能管理」`workspace-nav-menu.tsx` → `/page/workspace/admin/skills`，不再单列于 `components/page-sidebar.tsx` 左下角设置下拉）：打开自动扫描并带**进度条**（扫描逐技能 / 应用逐文件 X/N，应对 150+ 技能），URL/IP 类型过滤 + 搜索 + 「片段批量套用」（如所有 `uat.4.cn` → `prod.4.cn`）、每地址「替换为」输入框（可展开看 `file:line` 片段）、内联**预览**、**应用**、**多关键词检索**（空格分隔全部命中），以及**修改记录**面板——每次应用生成一条记录（显示时间/改了哪些地址 from→to/文件数/处数），可**针对单次记录回退**（二次确认）。client + NDJSON 流式解析在 `strategy-components/api/skill-addresses.ts`。后端 `/api/skill-addresses`（**仅管理员**）：所有文件 IO 走 `asyncio.to_thread` 不阻塞事件循环；`GET /scan`(+`/scan/stream`)、`POST /preview`、`POST /apply`(+`/apply/stream`)、`GET /backups`、`POST /rollback/{id}`；**子串安全替换**（基于 token span，不会误伤子串）、`expected_total` 乐观锁（409）、写前自动磁盘备份到 `{skills_root}/.address-edits/`（同时写一份 `{id}.manifest.json` 记录本次替换明细，供修改记录展示）、应用后刷新技能系统提示缓存。纯引擎 `deerflow/skills/address_scan.py`，router `app/gateway/routers/skill_addresses.py`，tests `tests/test_skill_addresses.py`。范围仅运行中技能，不动 `deploy/minimal/skills/`。
|
|
||||||
- **按钮管理 (Task Button Management, admin-only)**: configures the **可配置跳转按钮** rendered in the left task panel of the task deep-link workspaces (rwfx / 3qfx / xdfx, see `TaskFxWorkspace`). Each button = `{business, label, linkType, target, appendTaskId, idParam, idKind, openMode, loginParams, appendAuth, authTokenParam, authNameParam, enabled, sortOrder}`; `linkType` is `url` (外链 `window.open`, optional append of `?{idParam}={id}` — **`idParam` is the editable query-param name**, e.g. `id`/`task_id`), `business` (内部切换到另一业务, reuses `resolveTaskDeeplinkTarget`, always task id), or `purpose` (弹出当前任务的「任务目的」表格 via the shared `TaskPurposeDialog`, no target — configurable for any page incl. xdfx). **`url` buttons support two independent, coexisting login-append mechanisms**: (1) **`loginParams` (追加登录参数, like 应用管理/Light App Center)** — a list of `{key, source, customValue}` resolved at click time: `runTaskButton` reads `userInfo` (via `readUserInfo` from `strategy-components/lib/light-app`, embed-isolated through `authStorage`) and appends `?{key}={value}` for each (`source` = a userInfo field such as `accessToken`/`yUserId`, or `other` → literal `customValue`); empty list = nothing appended. Reuses `LOGIN_SOURCE_OPTIONS` from light-app; stored as JSON column `task_buttons.login_params_json` (`PortableJSON`, migration `20260625_01`). (2) **`appendAuth` (追加登录态)** — appends `?{authTokenParam}={token1}&{authNameParam}={username}` (default param names `token`/`username`) so the跳转目标外部系统 can identify the current user — e.g. `…/action/sentiment?token=<JWT>&username=lizhaoxing`. **Gated on token login**: `token1` = the `?authToken=` used by token-exchange login; `username` = the raw login name the backend resolved from `getTokenInfo`. Both are stashed at login by `persistLoginCredentials` into `login.token1`/`login.username` (`core/auth/login-credentials.ts`, scoped via [[scoped-storage]] so嵌入/独立会话隔离 + 随独立会话迁移). Only token login writes them → a non-token-login session has no `token1`, so `runTaskButton` silently skips the auth append (the jump still works, just without those two params). The frontend reads `username` straight from the new `UsernameLoginResponse.username` field (the stored email local-part is lossy — lowercased/normalized — so not used), **not** by decoding the JWT. Stored as columns `task_buttons.{append_auth, auth_token_param, auth_name_param}` (migration `20260625_02`). The admin page renders both editors for `url` buttons (loginParams 虚线框 + 追加登录态 switch). **`idKind` (`task`/`action`) only matters for xdfx**: its deep-link `?taskId=` is an 行动id and the 任务id is resolved at login (`fetchTaskIdFromAction`) — `TaskContext` now also stashes the raw `actionId`, so a url button can append either (default `task`). Page `TaskButtonsPage.tsx` (route `/page/strategy/admin/task-buttons`, **admin-gated**, entry「按钮管理」in the bottom-left settings dropdown of `components/page-sidebar.tsx`, both full + collapsed modes) has per-business tabs, edits name/type/target/启停/排序/增删, saves the **whole set atomically** (replace-all), plus 「导入默认」 to merge code-seed defaults. **Seed/fallback** (like 敏感词管理): only when the whole table is empty (fresh deploy, never saved) do the workspace + page fall back to `defaultTaskButtons(cfg)` — rwfx's url buttons (编辑/上一步/下一步/3q详情) built from the **live** `/api/public/config/task-deeplink` plus cross-business switch buttons for **all three** businesses (each switches to the other two — rwfx→三情/行动, 3qfx→任务/行动, xdfx→任务/三情). Once saved, the store is the sole source of truth. **Bottom 快捷跳转 bar groups by prev/next**: `TaskJumpBar` renders only「上一步/下一步」-type buttons in the bottom bar — a `prev` group (id 含 `prev` 或文案「上一步」, 描边次要样式 + ←图标) rendered **左侧**, then a `next` group (id 含 `next` 或文案「下一步」, 实心主色) on the **右侧** (container `justify-end`); everything else goes to the right-edge floating menu. The default 上一步 button (`rwfx-prev`, `url`, target = `DASHBOARD_AGENT_ROUTE` `/page/strategy/dashboard-agent`, `appendTaskId` + `idParam=taskId` → `?taskId=任务id`, `openMode=self`) 默认指向**应用内**「大屏绘制」页，在 **both** 单智能体 (`TaskFxWorkspace`) 与 多智能体会商 (`RoundtablePlanningPage` 深链 rwfx-A) 都显示（共用 `TaskJumpBar`）。**`runTaskButton` 的 `url` 类型支持应用内路由**：target 以单个 `/` 开头时按内部路由处理——`self` 走 react-router 同窗导航（不刷新），`blank` 拼成当前源的 hash 路由新标签打开；外链行为不变。 The old hardcoded jump buttons were migrated out: `TaskFxWorkspace` no longer hardcodes 切换到三Line truncated
|
|
||||||
- **实时并发监控 (Concurrency / System-Pressure Monitor, admin-only)**: a live panel mounted at the **top of the admin 排行榜 page** (`components/workspace/admin/concurrency-monitor.tsx` `ConcurrencyMonitorPanel`, rendered in `pages/AdminUserLeaderboardPage.tsx`) showing **当前并发的大模型调用数 + 列表（用户/智能体/类型/已运行时长）**, each row with a 「停止」button (and a 「全部停止」) that **truly aborts** that run's in-flight model stream via `RunManager.cancel` (`POST /api/admin/active-runs/{run_id}/cancel`) — to relieve pressure when 使用人数过多. Two line charts (minute/hour toggle): **并发量折线图** (peak/avg, `GET /api/admin/active-runs/concurrency`, fed by a lightweight background sampler into `concurrency_samples`) and **大模型出字速度折线图** (tokens/sec, `GET /api/admin/active-runs/token-speed`, aggregated from `llm_call_metrics`) so a dip pinpoints where the bottleneck is. A **「后台采样」Switch** (`system_settings.json → concurrency_monitor.enabled`, **default off / opt-in**, `GET|PUT /api/admin/active-runs/settings`) turns the background sampling on/off **at runtime, no restart** (the live concurrency count + 「停止」 work even while sampling is off — only the 并发量 history chart needs it on); everything is designed to **never impact production** (one tiny INSERT/15s, retention-purged, best-effort). Client/hooks: `core/admin/active-runs.ts` + `core/admin/hooks.ts` (`useActiveRuns`/`useConcurrencySeries`/`useTokenSpeedSeries`/`useCancel*`/`useMonitorSettings`). See the backend CLAUDE.md「Admin Concurrency Monitor」.
|
|
||||||
- **会话冲突 409 中文化**: when a user submits a new question while the previous turn is still streaming, the backend's `RunManager.create_or_reject` rejects with HTTP 409 (`services.py` now returns a **Chinese** detail「当前对话还在生成回答…」). `core/threads/hooks.ts` `onError` detects the conflict (`isActiveRunConflictError`: 409 / "already has an active run" / the Chinese text) and shows a friendly `toast.info` instead of a raw error.
|
|
||||||
- **State**: TanStack Query for server state, context providers (`SubtasksProvider`, `ArtifactsProvider`, `PromptInputProvider`) scoped to `WorkspaceRoutes`
|
|
||||||
- **LLM streaming**: `@langchain/langgraph-sdk` streams messages from the backend via SSE
|
|
||||||
- **UI**: Radix UI primitives + TailwindCSS v4 + shadcn-style components in `src/components/ui/`
|
|
||||||
- **Shims**: `src/shims/` provides `next/link` and `next/navigation` polyfills (original code was Next.js)
|
|
||||||
- **Login URL params** (`LoginPage.tsx`, frontend-only — the backend never sees these): besides the auth params (`ticket`/`userId`/`env`/`theme`/`yUserId`/`token`/`access_token`/`authToken`/`password`), the page supports a **task deep-link** via `?taskId=&goPath=`. After login it calls the consumer API `GET {VITE_AIPI_CONSUMER_URL}/taskAnalyseSearch/cop-task-detail?taskId=` (header `Authorization: Bearer admin`, auto-injected by `utils/request.ts`), stashes the full `data` (`id/overview/taskDirection/taskName/taskContent`) into `sessionStorage["login.copTaskDetail"]`, then routes by `goPath`: base codes `3qfx`/`rwfx`/`xdfx` → that business's configured **single agent** Q&A inside a **任务工作区** (resolved via `/api/business-mapping`; `resolveTaskDeeplinkTarget` calls `persistTaskContext({taskId, agentId, openingText})` and navigates to the `…/chats` **index**, which opens the latest task conversation or 新建 — a 1:N task↔对话 workspace, NOT `pendingAgentMessage`); the `-A` suffix (`3qfx-A`/…) → **multi-agent roundtable** with `roundtablePrefill.businessCode` so the page auto-selects the configured 业务链条. **xdfx's deep-link `?taskId=` is actually an 行动id, not a 任务id** — `resolveDeeplinkTaskId(goPath, rawId)` (called in `LoginPage` before everything) detects `xdfx`/`xdfx-A` and resolves it via `GET {action_detail_url}/{actionId}` → `data.taskId` (`fetchTaskIdFromAction`; `action_test`+`mock.action_detail` for offline testing); the resolved 任务id then drives `cop-task-detail`, the purpose tree, and the 1:N binding (other businesses pass the id through unchanged). **xdfx additionally partitions its chat records by 行动id (action_id), NOT by task_id**: `resolveTaskDeeplinkTarget` sets `partitionByAction:true` + keeps the raw action_id as `TaskContext.actionId`, so new threads are tagged `metadata.{taskId,actionId}` (taskId kept only to preserve the backend「任务深链对话全局共享」semantics, which keys off `metadata.taskId`) and the conversation list filters by `actionId` (+`agent_id`) — different actions of the same task get separate lists. xdfx's first-question opening text also appends `行动id（action_id）为…` (see `buildOpeningText` / `taskThreadMetadata`). goPath→businessCode: `3qfx`→`3Q`, `rwfx`→`6BF`, `xdfx`→`7BF`. The roundtable target also threads the URL `taskId` into `roundtablePrefill.taskId` (`resolveTaskDeeplinkTarget(goPath, detail, taskId)`), which turns on two taskId-scoped behaviors: (1) **separate, unpartitioned per-task storage** — taskId 会商聊天记录 live in their **own** store/table (`roundtable_task_drafts`), keyed **only by `task_id`** (one taskId = many records, shared across users, **no user 分权** at all; `created_by` is audit-only), kept entirely out of the per-user personal store (`roundtable_drafts`, now strictly per-user) so the two never mix. Backend router `/api/roundtable-task-drafts` (`GET /by-task/{id}` + `/by-task/{id}/latest`, `POST`, `GET/PUT/DELETE /{id}` — all user-agnostic); frontend client `roundtable-planning/api/task-drafts.ts`, and `useDraftPersistence`/`useRoundtableDrafts` route **all** CRUD to it when a `taskId` is present (else the personal `drafts.ts`). The matching **background jobs** are shared by task too: `roundtable_jobs.task_id` marks a task job; reads/dedup/stream/resume/cancel pass `?task_id=` so any user opening the task sees the same running 研讨 (progress/flowchart), and the executor writes the final report back to the task-draft store. Existing rows are moved over by `scripts/migrate_roundtable_task_drafts.py` (migration `20260618_01`). The history dropdown filters to the task and 新建 keeps the binding; (2) **Step-3 auto structured output** — after the `roundtable-summary` agent writes the Markdown report it automatically runs a second round emitting a `flow-json` flowchart (`useStep3Summary` `autoFlow`+`chainLevels`), whose hierarchy follows the business chain's stage goals (任务 → 目的 → 行为体 → …; coordinatorPrompt-specified hierarchy wins) and whose nodes never carry 阶段编号/阶段名 (the prior bug). **Both targets render embedded under the 任务管理 layout** — nested routes under `task-management/<business-path>/{roundtable,agent/:agent_id/chats}` in `StrategyRoutes.tsx` (`<business-path>` = `plan-task-sentiment` / `plan-task/plan-task-fx` / `plan-task/plan-task-action`, matching the COH中任务 menu paths in `sidebar-menu.ts`) so the global sidebar keeps 任务管理 → COH中任务 → the matching business highlighted. **All three single-agent businesses share `TaskFxWorkspace`** (`task-components/TaskFxWorkspace.tsx`): left = a「当前任务」card (`readCopTaskDetail()` 任务名称 + 简介, desensitized, 留存 above 新建对话) + per-task 1:N conversation list (`useTaskThreads(taskId, agentId, actionId?)` — filtered by **both** `metadata.taskId` AND `metadata.agent_id` so the three businesses' conversations staLine truncated
|
|
||||||
- **iframe 嵌入模式 (外部系统用 iframe 套用深链问答/会商)** — 三个**按标签页**开关，全部由深链 URL 参数开启、存进同一份 `sessionStorage` 会话（`embed.session`，键名常量在 `core/embed/embed-session.ts`），跨登录跳转/刷新/页内导航存活，**绝不跨标签污染**同浏览器另开的正常系统页。核心隔离手法：用 `sessionStorage`（按标签页/浏览上下文隔离，iframe 即便同源也有独立一份）而非 `localStorage`（跨标签共享）。开关：(1) **`?embed=1`（可带 `&theme=`）** — 去全局 chrome（`PageLayout` 的 `pageSidebarAllowed && !isEmbedActive()` → 隐藏 Header + PageSidebar）+ 按外部主题色**强制**明/暗：走 next-themes 的 `forcedTheme`（`App.tsx` `AppProviders` 调 `resolveForcedEmbedTheme`，**不写** localStorage `strategy-theme`），离散映射 `dark-blue`/`dark`→深、其余→浅；嵌入侧**绝不**调 `setTheme`/`persistSidebarEnabled`（那俩落 localStorage 跨标签污染，`LoginPage` 据 `readEmbedParam` 跳过）。(2) **`?hideJump=1`** — 隐藏深链底部「快捷跳转」栏 `TaskJumpBar` 的两部分（底部「下一步」等按钮 + 右侧垂直居中悬浮菜单），单智能体问答 + 会商共用该栏，`isJumpBarHidden()` 为真时整条 `return null`。(2.5) **`?hideChrome=1`** — **仅**去全局 chrome（Header 导航栏 + PageSidebar 侧边栏），**不**强制主题、**不**隔离鉴权（区别于 `embed`：只想要一个干净全屏页面，如「大屏绘制」`/page/strategy/dashboard-agent?taskId=…&hideChrome=1`）。新增 `EmbedSession.hideChrome` 字段 + `readHideChromeParam()` + `isChromeHidden()`（取 `embed || hideChrome` 之并），与 `hideJump` 完全对称；`PageRoutes.tsx` 的 `PageLayout` 把 `chromeHidden`（`isChromeHidden() || readHideChromeParam(location.search)==="on"`）并入 `pageSidebarAllowed`，且其**优先级高于** dashboard-agent 路由原本的强制全局 chrome（`forceChromeForDashboardAgent`）。`hideChrome=0` 可显式关闭。(3) **登录用户隔离** — 嵌入态下鉴权/身份键（`deerflow.auth` token、`userInfo`、`login.*`、`tools_token`、maxkey/userDetail token）全部经 `core/auth/scoped-storage.ts` 的 `authStorage()`（嵌入→sessionStorage / 正常→localStorage）读写，使 iframe 里登录的用户与正常登录用户**完全隔离**、互不覆盖；所有 token 读取都过 `getStoredAuth()`/`getAuthorizationHeaderValue()`（API 客户端 `core/api/*` 全走这俩），改中心函数即让全体调用方自动隔离；跨标签账号变更监听 `AuthSyncWatcher`（`core/auth/sync.tsx`）在嵌入态禁用。嵌入会话在 `main.tsx` 渲染前 `syncEmbedSessionFromCurrentUrl()` 同步启用（早于任何鉴权写入，避免首帧 effect 顺序漏写 localStorage）；`AppProviders` 的 effect 再按 SPA 导航同步。`embed=0`/`hideJump=0` 可显式关闭。正常（非嵌入）标签页所有 `isXxx()` 恒 false，行为**零变化**。第三个开关 `?isolate=1`（**独立登录会话**）把同一套**登录用户隔离**单独提供给**普通（带 chrome）标签页**——只切换鉴权存储、不去 chrome / 不强制主题 / 不动跳转栏：`authStorage()` 的条件从「仅嵌入」放宽为 `isEmbedActive() || isIsolatedSession()`，`AuthSyncWatcher` 的跨标签监听对嵌入态**或**独立态都即时忽略（handler 内实时判，运行时开关也即刻生效）。除 URL 参数外，**设置 → 外观 →「登录会话」** 有一个 Switch「独立登录会话（本标签页）」运行时切换（`setIsolatedSession`，`appearance-settings-page.tsx`）：**开启时先 `migrateAuthToSession()`**（`scoped-storage.ts`，把 localStorage 的受保护键 `deerflow.auth`/`userInfo`/`userId`/`tools_token` + `login.*` 前缀快照搬进 sessionStorage）再翻标志，故无感不登出；此后本标签页登录态独立——别处登录/换号影响不到它，它换号也影响不到别人，但关掉该标签即结束（需重登）。开启给 toast 提示。
|
|
||||||
- **操作日志（Y-Log）上报** — 用户的关键操作（登录登出/查询/查看/增删改/启停/导入导出/问答等）成功后，**前端直连**外部接口 `POST {write_url}`（默认 `https://ch1.b.uat.4.cn/api/y-log/write`）记一条审计日志。核心模块 `src/core/log/`：`y-log.ts`（`writeYLog(params)` + `OptType` 枚举 0/1/3..12；**异步即发即忘、永不 await、永不抛错、失败静默**，自动把完整 url 转相对路径去 ip/host、对象入参/返回自动 `JSON.stringify` + 50k 裁剪、`optResult` 恒 0 只报成功），`y-log-config.ts`（从公开只读 `GET /api/public/config/y-log` 拉 `{enabled, writeUrl}`，模块级缓存 + 去重 + 默认兜底；`App.tsx` `AppProviders` 启动预热 `fetchYLogConfig()`），`y-log-token.ts`（token1 = token 登录的 `?authToken=`，经 [[scoped-storage]] 的 `authStorage*` 存取，嵌入态自动隔离）。**双门控**：仅当①存在 token1（即用 token 登录，`LoginPage` 成功后 `persistYLogToken(authToken)`，登出 `account-settings-page.tsx` 先报后清 token1）且②配置 `enabled && writeUrl` 才上报；否则一律不发。`optDetail` 统一「CM助手-全量-…」（**禁内部框架名**）。埋点**广覆盖**各 API client 的成功路径——原则是「一个用户操作（查看/查询/新增/编辑/删除/启停/导入导出）= 一条日志」，每个 API client 的**单条详情 GET（查看→view 4）/ 列表查询 GET（search 3）/ 新增 POST（create 9）/ 改 PUT·PATCH（edit 5）/ 删 DELETE（delete 6）/ 启停（enabled 11 / disabled 10）/ 导入导出（import 7 / export 8）**都各落一条，仅跳过高频 typeahead/状态轮询/纯 bootstrap config 读。覆盖文件：`strategy-components/api/{sensitive-words,menu-overrides,task-buttons,skill-addresses,light-apps,business-mapping}.ts`、`roundtable-planning/api/{drafts,task-drafts,roundtable-jobs,recommend,chains,multi-agent,dashboard-sessions}.ts`、`core/{agents,scheduled-tasks,knowledge,positions,tags,studio,system-settings,memory,mcp,models,custom-prompts,user-preferences,notifications,recommended-questions,user-qa,curator,admin,thread-shares,roundtable-draft-shares,tool-metrics,llm-metrics,note,artifacts}/api.ts`、`core/api/markdown-docx-export.ts`。**问答（Q&A）改为「一次大模型调用 = 一条日志」**：在共享的 `core/threads/hooks.ts` `useThreadStream` 的 `onLangChainEvent` 里监听 `on_chat_model_end`，每次模型调用结束就上报一条（optType 12，`reqParam` 取本次 input 的最后一条 user 文本 + 模型名，`returnParam` 取本次输出文本）——一个问答轮次里 lead agent / 子代理的**每次** LLM 调用都各记一条，覆盖所有走 `useThreadStream` 的页面（`ChatPage`/`AgentChatPage`/创建智能体/iframe/会商等）；`ChatPage`/`AgentChatPage` 的 `onFinish` 仍额外保留一条轮次汇总。后端仅新增公开只读配置：`deerflow/config/y_log_config.py`（`YLogConfig{enabled,write_url}`）挂到 `AppConfig.y_log`，`app/gateway/routers/public_config.py` 加 `GET /api/public/config/y-log`，地址写在 `config.yaml` 的 `y_log` 段（mtime 热重载，前端无需重建）；**不做后端代理**。Tests：`tests/test_y_log_config.py`。
|
|
||||||
|
|
||||||
### Configuration
|
|
||||||
|
|
||||||
Backend config lives in `offline-backend-20260512/backend/config.yaml`. Values starting with `$` resolve as environment variables (e.g., `$OPENAI_API_KEY`). MCP servers and skills are configured in `extensions_config.json` in the same directory.
|
|
||||||
|
|
||||||
## Detailed Backend Reference
|
|
||||||
|
|
||||||
The backend has its own comprehensive documentation at:
|
|
||||||
- `offline-backend-20260512/backend/CLAUDE.md` — architecture, middleware chain, all API routes, config schema, sandbox/memory/subagent systems
|
|
||||||
- `offline-backend-20260512/backend/README.md` — setup guide, technology stack
|
|
||||||
Submodule _skills_src/ai-skills deleted from cde1c8385e.
Submodule _skills_src/anthropics-skills deleted from 5754626092.
Submodule _skills_src/awesome-claude-skills deleted from 92568c1eda.
Submodule _skills_src/ce-kit deleted from d4973c4827.
Submodule _skills_src/csm deleted from 3fa16a94e0.
Submodule _skills_src/superpowers deleted from 6fd4507659.
Submodule _skills_src/tapestry-skills deleted from 80e1dc56df.
@@ -1,33 +0,0 @@
|
|||||||
# 批量人物蒸馏 → llmwiki
|
|
||||||
|
|
||||||
一个**完全独立的单文件脚本 + 内置定时器**：读 Excel 名单，串行调用线上 DeerFlow 服务问答接口，
|
|
||||||
复用「女娲 / huashu-nuwa」技能逐个蒸馏人物，**由脚本抓取回复并保存**成 llmwiki 风格 markdown。
|
|
||||||
|
|
||||||
- **不联网**：只用已配置的知识库查询技能（`knowledge-search-v2`）检索资料。
|
|
||||||
- **定时执行**：每天 **23:00 ~ 次日 08:00** 自动跑，到点暂停、次日继续。
|
|
||||||
- **md 由 py 保存**：agent 只产出内容，脚本抓最终回复写成 `.md`（不让项目自己写文件）。
|
|
||||||
|
|
||||||
## 你只需要做两件事
|
|
||||||
|
|
||||||
1. **改一行地址**：打开 `distill_people.py`，把顶部 `BASE_URL = "..."` 改成你的线上服务地址。
|
|
||||||
2. **放名单**：同目录放 `people.xlsx`（或 `people.csv`），**第一列 = 人名**，其余列=可选提示。
|
|
||||||
|
|
||||||
其余（用户名 `distiller`、口令 `123ewq`、技能名、时间窗）都已内置，不用填。
|
|
||||||
|
|
||||||
## 运行
|
|
||||||
|
|
||||||
```bash
|
|
||||||
python distill_people.py # 常驻，按 23:00~08:00 窗口自动执行（推荐挂后台）
|
|
||||||
python distill_people.py --now # 忽略时间窗，立刻把名单跑完（测试用）
|
|
||||||
python distill_people.py --redo # 忽略已完成，全部重做
|
|
||||||
```
|
|
||||||
|
|
||||||
读 `.xlsx` 需要 `openpyxl`；用 `.csv` 则零额外依赖。
|
|
||||||
|
|
||||||
## 输出（都在 output/ 一个文件夹）
|
|
||||||
|
|
||||||
- `<人名>.md` —— 每个人的 llmwiki 档案
|
|
||||||
- `manifest.json` —— 执行清单（状态/耗时/run_id）
|
|
||||||
- `index.md` —— 可读清单表（谁完成/失败，点开看 md）
|
|
||||||
|
|
||||||
**断点续跑**：已完成的人自动跳过；中途往名单里加人，下个执行窗会带上。
|
|
||||||
@@ -1,563 +0,0 @@
|
|||||||
#!/usr/bin/env python3
|
|
||||||
# -*- coding: utf-8 -*-
|
|
||||||
"""
|
|
||||||
批量人物蒸馏 → llmwiki markdown（完全独立的单文件客户端 + 内置定时器）
|
|
||||||
|
|
||||||
特点
|
|
||||||
----
|
|
||||||
- 串行（一个一个来）调用正在运行的 DeerFlow 服务问答接口
|
|
||||||
- 复用线上「女娲 / huashu-nuwa」技能做提炼；**不联网**，只用已配置的
|
|
||||||
知识库查询技能（knowledge-search-v2）检索资料
|
|
||||||
- agent 只负责产出内容，**markdown 由本脚本抓取最终回复后自己保存**
|
|
||||||
- 内置时间窗：每天 23:00 ~ 次日 08:00 才执行，到点自动暂停、次日继续
|
|
||||||
- 断点续跑：已完成的人自动跳过；中途加名单也会被带上
|
|
||||||
|
|
||||||
你只需要改一处：下面的 BASE_URL（线上服务地址）。其余都不用填。
|
|
||||||
|
|
||||||
名单
|
|
||||||
----
|
|
||||||
脚本同目录放 people.xlsx 或 people.csv，**第一列 = 人名**，其余列=可选提示。
|
|
||||||
|
|
||||||
运行
|
|
||||||
----
|
|
||||||
python distill_people.py # 常驻，按 23:00~08:00 窗口自动执行
|
|
||||||
python distill_people.py --now # 忽略时间窗，立刻把名单跑完（测试用）
|
|
||||||
python distill_people.py --redo # 忽略已完成，全部重做
|
|
||||||
"""
|
|
||||||
from __future__ import annotations
|
|
||||||
|
|
||||||
import argparse
|
|
||||||
import csv
|
|
||||||
import json
|
|
||||||
import re
|
|
||||||
import sys
|
|
||||||
import time
|
|
||||||
from datetime import datetime, time as dtime
|
|
||||||
from pathlib import Path
|
|
||||||
|
|
||||||
try:
|
|
||||||
import requests
|
|
||||||
except ImportError:
|
|
||||||
sys.exit("缺少依赖 requests：pip install requests")
|
|
||||||
|
|
||||||
|
|
||||||
# ════════════════════════════════════════════════════════════════════════
|
|
||||||
# 只改这一行：你的线上服务地址（不带结尾斜杠）
|
|
||||||
# ════════════════════════════════════════════════════════════════════════
|
|
||||||
BASE_URL = "http://47.94.209.59:2026/"
|
|
||||||
# ════════════════════════════════════════════════════════════════════════
|
|
||||||
|
|
||||||
|
|
||||||
# ---- 以下都已内置，正常无需改动 ----
|
|
||||||
USERNAME = "distiller" # 免密自动注册
|
|
||||||
PASSWORD = "123ewq" # 共享口令（你们开了口令门）
|
|
||||||
NUWA_SKILL = "huashu-nuwa" # 女娲技能
|
|
||||||
KB_SKILL = "knowledge-search-v2" # 知识库查询技能（不联网，用它检索）
|
|
||||||
DEPTH = "full" # full 完整 / fast 精简
|
|
||||||
|
|
||||||
HERE = Path(__file__).resolve().parent
|
|
||||||
OUTPUT_DIR = HERE / "output"
|
|
||||||
PEOPLE_FILE_DEFAULT = HERE / "people.example.csv"
|
|
||||||
|
|
||||||
# 执行时间窗：23:00 ~ 次日 08:00（跨午夜）
|
|
||||||
WIN_START = dtime(23, 0)
|
|
||||||
WIN_END = dtime(8, 0)
|
|
||||||
|
|
||||||
PER_PERSON_TIMEOUT = 1800 # 单人最长等待（秒）
|
|
||||||
POLL_INTERVAL = 5 # 轮询间隔（秒）
|
|
||||||
HTTP_TIMEOUT = 60
|
|
||||||
TERMINAL_STATUS = {"success", "error", "timeout", "interrupted"}
|
|
||||||
|
|
||||||
|
|
||||||
# ================================ llmwiki 模板 ================================
|
|
||||||
LLMWIKI_TEMPLATE = """\
|
|
||||||
---
|
|
||||||
name: <中文名/常用名>
|
|
||||||
aliases: [<别名/英文名...>]
|
|
||||||
type: person
|
|
||||||
era: <在世 | 历史人物>
|
|
||||||
domains: [<领域1>, <领域2>]
|
|
||||||
distilled_at: <YYYY-MM-DD>
|
|
||||||
sources_count: <检索到的来源条数>
|
|
||||||
primary_source_ratio: <一手来源占比, 0~1 的小数>
|
|
||||||
confidence: <high | medium | low>
|
|
||||||
---
|
|
||||||
|
|
||||||
# <人物名>
|
|
||||||
|
|
||||||
> **一句话定位**：<此人看世界的独特方式，一句话>
|
|
||||||
|
|
||||||
## 身份卡
|
|
||||||
- **活跃年代**：
|
|
||||||
- **核心身份**：
|
|
||||||
- **自述(50字, 以其语气)**：
|
|
||||||
|
|
||||||
## 核心观点（真信念 · 反复出现的主张）
|
|
||||||
1. ...
|
|
||||||
|
|
||||||
## 心智模型（3–7 个；每个含：一句话 / 证据场景≥2 / 应用 / 局限 / 来源）
|
|
||||||
### 1. <模型名>
|
|
||||||
- **一句话**：
|
|
||||||
- **证据场景**：
|
|
||||||
- **应用方式**：
|
|
||||||
- **局限**：
|
|
||||||
- **来源**：
|
|
||||||
|
|
||||||
## 决策启发式（5–10 条 · 如果 X 则 Y，带案例）
|
|
||||||
- 若 <X> → <Y>
|
|
||||||
|
|
||||||
## 表达 DNA
|
|
||||||
| 维度 | 特征 |
|
|
||||||
|------|------|
|
|
||||||
| 句式 | |
|
|
||||||
| 高频词 | |
|
|
||||||
| 幽默 | |
|
|
||||||
| 确定性 | |
|
|
||||||
| 引用习惯 | |
|
|
||||||
|
|
||||||
## 价值观与反模式
|
|
||||||
- **价值观排序**：
|
|
||||||
- **明确反对**：
|
|
||||||
|
|
||||||
## 内在张力（≥2 对矛盾）
|
|
||||||
- <A> ↔ <B>
|
|
||||||
|
|
||||||
## 经历时间线
|
|
||||||
| 年份 | 事件 | 思想意义 |
|
|
||||||
|------|------|---------|
|
|
||||||
| | | |
|
|
||||||
|
|
||||||
## 代表语录
|
|
||||||
- “...” —（出处/年份，标一手/二手）
|
|
||||||
|
|
||||||
## 智识谱系
|
|
||||||
- **受影响于**：
|
|
||||||
- **影响了**：
|
|
||||||
|
|
||||||
## 外部评价与争议
|
|
||||||
-
|
|
||||||
|
|
||||||
## 诚实边界
|
|
||||||
- <至少 3 条具体局限，含信息截止日期>
|
|
||||||
|
|
||||||
## 调研来源
|
|
||||||
**一手(N)**：
|
|
||||||
**二手(N)**：
|
|
||||||
"""
|
|
||||||
|
|
||||||
|
|
||||||
def build_prompt(name: str, hints: str, depth: str) -> str:
|
|
||||||
depth_note = (
|
|
||||||
"本次走【完整模式】：尽量覆盖著作/对话/表达/他者评价/决策/时间线 6 个维度。"
|
|
||||||
if depth == "full"
|
|
||||||
else "本次走【精简模式】：重点覆盖核心观点、心智模型、时间线三块即可。"
|
|
||||||
)
|
|
||||||
hint_block = f"\n补充提示（来自名单其它列，可作为检索关键词）：{hints}\n" if hints.strip() else ""
|
|
||||||
return f"""\
|
|
||||||
你的任务：把人物【{name}】蒸馏成一份 llmwiki 风格的人物档案 markdown。
|
|
||||||
|
|
||||||
请复用本服务中已启用的「女娲 / {NUWA_SKILL}」技能的提炼方法论
|
|
||||||
（心智模型三重验证、表达DNA分析、诚实边界）。
|
|
||||||
|
|
||||||
⚠️ 本环境**无法联网，严禁使用 WebSearch 等任何联网工具**。
|
|
||||||
所有资料**只能通过已配置的知识库查询技能「{KB_SKILL}」检索获取**。
|
|
||||||
请充分调用该知识库技能，围绕该人物多角度检索（生平、观点、著作、语录、决策、评价等），
|
|
||||||
基于检索到的内容做提炼。知识库里查不到的部分，如实在「诚实边界」标注，不要编造。
|
|
||||||
|
|
||||||
{depth_note}
|
|
||||||
{hint_block}
|
|
||||||
输出要求：
|
|
||||||
1. **不要写任何文件，不要调用 write_file / present_files**。
|
|
||||||
2. 直接在你的回复正文里输出**完整中文 markdown 全文**，严格按下面模板结构
|
|
||||||
（保留各级标题，逐项填实，不要保留尖括号占位符），**不要任何额外解说、前言或结语**：
|
|
||||||
|
|
||||||
------------------ 模板开始 ------------------
|
|
||||||
{LLMWIKI_TEMPLATE}
|
|
||||||
------------------ 模板结束 ------------------
|
|
||||||
|
|
||||||
现在开始，独立完成，不要向我提问。"""
|
|
||||||
|
|
||||||
|
|
||||||
# ================================ HTTP 客户端 ================================
|
|
||||||
class DeerFlowClient:
|
|
||||||
def __init__(self, base_url: str):
|
|
||||||
self.base = base_url.rstrip("/")
|
|
||||||
self.s = requests.Session()
|
|
||||||
self.token: str | None = None
|
|
||||||
|
|
||||||
def _headers(self) -> dict:
|
|
||||||
h = {"Content-Type": "application/json"}
|
|
||||||
if self.token:
|
|
||||||
h["Authorization"] = f"Bearer {self.token}" # 只用 Bearer，不带 cookie → 跳过 CSRF
|
|
||||||
return h
|
|
||||||
|
|
||||||
def login(self) -> bool:
|
|
||||||
url = f"{self.base}/api/v1/auth/login/username"
|
|
||||||
params = {"password": PASSWORD} if PASSWORD else None
|
|
||||||
try:
|
|
||||||
r = self.s.post(url, params=params, json={"username": USERNAME}, timeout=HTTP_TIMEOUT)
|
|
||||||
except requests.RequestException as e:
|
|
||||||
print(f" [登录] 连接失败：{e}")
|
|
||||||
return False
|
|
||||||
if r.status_code == 200:
|
|
||||||
self.token = r.json().get("access_token")
|
|
||||||
self.s.cookies.clear()
|
|
||||||
print(f" [登录] 成功，用户={USERNAME}")
|
|
||||||
return True
|
|
||||||
print(f" [登录] 返回 {r.status_code}：{r.text[:200]}")
|
|
||||||
return False
|
|
||||||
|
|
||||||
def ensure_skill_enabled(self, name: str) -> None:
|
|
||||||
try:
|
|
||||||
r = self.s.get(f"{self.base}/api/skills", headers=self._headers(), timeout=HTTP_TIMEOUT)
|
|
||||||
if r.status_code == 200:
|
|
||||||
skills = r.json().get("skills", [])
|
|
||||||
hit = next((x for x in skills if x.get("name") == name), None)
|
|
||||||
if hit is None:
|
|
||||||
print(f" [技能] 警告：服务里没找到 '{name}'")
|
|
||||||
return
|
|
||||||
if hit.get("enabled"):
|
|
||||||
print(f" [技能] '{name}' 已启用")
|
|
||||||
return
|
|
||||||
pr = self.s.put(f"{self.base}/api/skills/{name}", headers=self._headers(),
|
|
||||||
json={"enabled": True}, timeout=HTTP_TIMEOUT)
|
|
||||||
print(f" [技能] 启用 '{name}' → {pr.status_code}")
|
|
||||||
except requests.RequestException as e:
|
|
||||||
print(f" [技能] 检查 '{name}' 失败（忽略）：{e}")
|
|
||||||
|
|
||||||
def create_thread(self) -> str:
|
|
||||||
r = self.s.post(f"{self.base}/api/threads", headers=self._headers(), json={}, timeout=HTTP_TIMEOUT)
|
|
||||||
r.raise_for_status()
|
|
||||||
return r.json()["thread_id"]
|
|
||||||
|
|
||||||
def start_run(self, thread_id: str, prompt: str) -> str:
|
|
||||||
body = {
|
|
||||||
"input": {"messages": [{"role": "user", "content": prompt}]},
|
|
||||||
"excluded_tools": ["ask_clarification"], # 禁澄清，无人值守不卡住
|
|
||||||
}
|
|
||||||
r = self.s.post(f"{self.base}/api/threads/{thread_id}/runs",
|
|
||||||
headers=self._headers(), json=body, timeout=HTTP_TIMEOUT)
|
|
||||||
r.raise_for_status()
|
|
||||||
return r.json()["run_id"]
|
|
||||||
|
|
||||||
def poll_run(self, thread_id: str, run_id: str) -> str:
|
|
||||||
deadline = time.monotonic() + PER_PERSON_TIMEOUT
|
|
||||||
last = ""
|
|
||||||
while time.monotonic() < deadline:
|
|
||||||
try:
|
|
||||||
r = self.s.get(f"{self.base}/api/threads/{thread_id}/runs/{run_id}",
|
|
||||||
headers=self._headers(), timeout=HTTP_TIMEOUT)
|
|
||||||
if r.status_code == 200:
|
|
||||||
st = r.json().get("status", "")
|
|
||||||
if st != last:
|
|
||||||
print(f" ...状态：{st}")
|
|
||||||
last = st
|
|
||||||
if st in TERMINAL_STATUS:
|
|
||||||
return st
|
|
||||||
except requests.RequestException as e:
|
|
||||||
print(f" 轮询出错（重试）：{e}")
|
|
||||||
time.sleep(POLL_INTERVAL)
|
|
||||||
return "timeout"
|
|
||||||
|
|
||||||
def fetch_result_text(self, thread_id: str, run_id: str) -> str | None:
|
|
||||||
"""抓取该 thread 的最终 AI 回复文本（由 py 保存为 md）。
|
|
||||||
|
|
||||||
注意：本部署的 `/runs/{rid}/messages`、`/messages`、`/events` 端点都返回空
|
|
||||||
（事件库按登录用户过滤，后台 worker 写入时未带 user_id → 读不到）。
|
|
||||||
可靠来源是 LangGraph 检查点状态 `/api/threads/{tid}/state` → values.messages，
|
|
||||||
其中每条消息形如 {"type": "human"|"ai"|"tool", "content": <str | 内容块列表>, ...}。
|
|
||||||
取最后一条有正文的 ai 消息即可。
|
|
||||||
"""
|
|
||||||
try:
|
|
||||||
r = self.s.get(f"{self.base}/api/threads/{thread_id}/state",
|
|
||||||
headers=self._headers(), timeout=HTTP_TIMEOUT)
|
|
||||||
if r.status_code != 200:
|
|
||||||
print(f" 取回复返回 {r.status_code}：{r.text[:200]}")
|
|
||||||
return None
|
|
||||||
messages = (r.json().get("values") or {}).get("messages") or []
|
|
||||||
# 从后往前找最后一条「有正文」的 AI 回复（跳过只含工具调用的中间消息）
|
|
||||||
for msg in reversed(messages):
|
|
||||||
if not isinstance(msg, dict) or msg.get("type") != "ai":
|
|
||||||
continue
|
|
||||||
txt = _extract_text(msg)
|
|
||||||
if txt and txt.strip():
|
|
||||||
return txt
|
|
||||||
except requests.RequestException as e:
|
|
||||||
print(f" 取回复出错：{e}")
|
|
||||||
return None
|
|
||||||
|
|
||||||
|
|
||||||
def _extract_text(payload) -> str:
|
|
||||||
"""从一条消息的 content 里提取纯文本。
|
|
||||||
|
|
||||||
payload 可能是：
|
|
||||||
- LangChain 消息的 model_dump 字典（正文在 payload["content"]）
|
|
||||||
- 直接的字符串
|
|
||||||
- 内容块列表（[{"type":"text","text":"..."}, ...]）
|
|
||||||
"""
|
|
||||||
if payload is None:
|
|
||||||
return ""
|
|
||||||
# 若是整条消息的 model_dump，正文在其 content 字段
|
|
||||||
if isinstance(payload, dict):
|
|
||||||
c = payload.get("content", payload.get("text", ""))
|
|
||||||
else:
|
|
||||||
c = payload
|
|
||||||
if isinstance(c, str):
|
|
||||||
return c
|
|
||||||
if isinstance(c, list):
|
|
||||||
parts = []
|
|
||||||
for b in c:
|
|
||||||
if isinstance(b, dict):
|
|
||||||
# 只取文本块，跳过 tool_use / thinking 等非文本块
|
|
||||||
if b.get("type") in (None, "text", "text_block"):
|
|
||||||
parts.append(b.get("text") or b.get("content") or "")
|
|
||||||
elif b.get("text"):
|
|
||||||
parts.append(b["text"])
|
|
||||||
elif isinstance(b, str):
|
|
||||||
parts.append(b)
|
|
||||||
return "\n".join(p for p in parts if p)
|
|
||||||
return str(c) if c else ""
|
|
||||||
|
|
||||||
|
|
||||||
def _clean_markdown(text: str) -> str:
|
|
||||||
"""去掉 agent 可能套上的 ```markdown ... ``` 围栏，并规整 YAML frontmatter。"""
|
|
||||||
t = text.strip()
|
|
||||||
m = re.match(r"^```(?:markdown|md)?\s*\n(.*)\n```$", t, re.S)
|
|
||||||
if m:
|
|
||||||
t = m.group(1).strip()
|
|
||||||
return _normalize_frontmatter(t)
|
|
||||||
|
|
||||||
|
|
||||||
def _normalize_frontmatter(text: str) -> str:
|
|
||||||
"""修复模型常见的 frontmatter 跑偏，让 YAML 能正常解析。
|
|
||||||
|
|
||||||
模型经常把字段名写成 markdown 加粗（``**name:**``）、加空行、留行尾双空格，
|
|
||||||
这些都会让 frontmatter 解析失败。这里把开头 ``---`` 到下一个 ``---`` 之间的内容
|
|
||||||
规整为干净的 ``key: value`` 形式。正文（第二个 ``---`` 之后）保持原样。
|
|
||||||
"""
|
|
||||||
if not text.startswith("---"):
|
|
||||||
return text
|
|
||||||
# 拆出 frontmatter 块：开头 --- 与下一行单独的 --- 之间
|
|
||||||
m = re.match(r"^---[ \t]*\n(.*?)\n---[ \t]*\n?(.*)$", text, re.S)
|
|
||||||
if not m:
|
|
||||||
return text
|
|
||||||
body_fm, rest = m.group(1), m.group(2)
|
|
||||||
out_lines = []
|
|
||||||
for line in body_fm.splitlines():
|
|
||||||
s = line.rstrip() # 去行尾双空格
|
|
||||||
s = s.replace("**", "") # 去 markdown 加粗标记
|
|
||||||
if not s.strip():
|
|
||||||
continue # 丢掉空行
|
|
||||||
out_lines.append(s)
|
|
||||||
return "---\n" + "\n".join(out_lines) + "\n---\n\n" + rest.lstrip("\n")
|
|
||||||
|
|
||||||
|
|
||||||
# ================================ 名单读取 ================================
|
|
||||||
def slugify(name: str) -> str:
|
|
||||||
s = re.sub(r'[\\/:*?"<>|]+', "", name).strip()
|
|
||||||
s = re.sub(r"\s+", "_", s)
|
|
||||||
return s or "unnamed"
|
|
||||||
|
|
||||||
|
|
||||||
def read_people(path: Path) -> list[dict]:
|
|
||||||
if not path.exists():
|
|
||||||
return []
|
|
||||||
rows: list[list[str]] = []
|
|
||||||
if path.suffix.lower() in (".xlsx", ".xlsm"):
|
|
||||||
try:
|
|
||||||
import openpyxl
|
|
||||||
except ImportError:
|
|
||||||
sys.exit("读取 .xlsx 需要 openpyxl：pip install openpyxl（或把名单存成 .csv）")
|
|
||||||
wb = openpyxl.load_workbook(path, read_only=True, data_only=True)
|
|
||||||
for row in wb.active.iter_rows(values_only=True):
|
|
||||||
rows.append(["" if c is None else str(c).strip() for c in row])
|
|
||||||
elif path.suffix.lower() == ".csv":
|
|
||||||
with open(path, encoding="utf-8-sig", newline="") as f:
|
|
||||||
rows = [[c.strip() for c in r] for r in csv.reader(f)]
|
|
||||||
else:
|
|
||||||
sys.exit(f"不支持的名单格式：{path.suffix}（用 .xlsx 或 .csv）")
|
|
||||||
|
|
||||||
if rows and re.search(r"(姓名|名字|人物|name)", rows[0][0] if rows[0] else "", re.I):
|
|
||||||
rows = rows[1:]
|
|
||||||
people, seen = [], set()
|
|
||||||
for r in rows:
|
|
||||||
if not r or not r[0].strip():
|
|
||||||
continue
|
|
||||||
name = r[0].strip()
|
|
||||||
if name in seen:
|
|
||||||
continue
|
|
||||||
seen.add(name)
|
|
||||||
hints = " | ".join(x for x in r[1:] if x.strip())
|
|
||||||
people.append({"name": name, "hints": hints})
|
|
||||||
return people
|
|
||||||
|
|
||||||
|
|
||||||
# ================================ 时间窗 ================================
|
|
||||||
def in_window(now: datetime | None = None) -> bool:
|
|
||||||
now = now or datetime.now()
|
|
||||||
t = now.time()
|
|
||||||
return t >= WIN_START or t < WIN_END # 跨午夜
|
|
||||||
|
|
||||||
def seconds_until_window(now: datetime | None = None) -> int:
|
|
||||||
now = now or datetime.now()
|
|
||||||
if in_window(now):
|
|
||||||
return 0
|
|
||||||
target = now.replace(hour=WIN_START.hour, minute=WIN_START.minute, second=0, microsecond=0)
|
|
||||||
return max(1, int((target - now).total_seconds()))
|
|
||||||
|
|
||||||
def sleep_interruptible(total: int) -> None:
|
|
||||||
end = time.monotonic() + total
|
|
||||||
while time.monotonic() < end:
|
|
||||||
time.sleep(min(30, max(1, int(end - time.monotonic()))))
|
|
||||||
|
|
||||||
|
|
||||||
# ================================ 蒸馏单人 ================================
|
|
||||||
def distill_one(client: DeerFlowClient, person: dict, out_dir: Path,
|
|
||||||
manifest: dict, save_manifest, depth: str) -> None:
|
|
||||||
name, hints = person["name"], person["hints"]
|
|
||||||
slug = slugify(name)
|
|
||||||
md_path = out_dir / f"{slug}.md"
|
|
||||||
t0 = time.time()
|
|
||||||
|
|
||||||
rec = {"name": name, "slug": slug, "status": "running",
|
|
||||||
"started_at": _now(), "file": f"{slug}.md"}
|
|
||||||
manifest[name] = rec
|
|
||||||
save_manifest()
|
|
||||||
|
|
||||||
try:
|
|
||||||
tid = client.create_thread()
|
|
||||||
run_id = client.start_run(tid, build_prompt(name, hints, depth))
|
|
||||||
status = client.poll_run(tid, run_id)
|
|
||||||
rec.update(thread_id=tid, run_id=run_id, run_status=status)
|
|
||||||
|
|
||||||
text = client.fetch_result_text(tid, run_id) if status == "success" else None
|
|
||||||
if status == "success" and text:
|
|
||||||
md = _clean_markdown(text)
|
|
||||||
md_path.write_text(md, encoding="utf-8")
|
|
||||||
rec["status"] = "succeeded"
|
|
||||||
rec["chars"] = len(md)
|
|
||||||
print(f" ✅ 完成 → {md_path.name}（{len(md)} 字，耗时 {int(time.time()-t0)}s）")
|
|
||||||
else:
|
|
||||||
rec["status"] = "failed"
|
|
||||||
rec["error"] = f"run={status}, text={'有' if text else '无'}"
|
|
||||||
if text:
|
|
||||||
(out_dir / f"{slug}.partial.md").write_text(text, encoding="utf-8")
|
|
||||||
print(f" ❌ 失败（run={status}）")
|
|
||||||
except Exception as e:
|
|
||||||
rec["status"] = "failed"
|
|
||||||
rec["error"] = str(e)
|
|
||||||
print(f" ❌ 异常：{e}")
|
|
||||||
|
|
||||||
rec["finished_at"] = _now()
|
|
||||||
rec["seconds"] = int(time.time() - t0)
|
|
||||||
manifest[name] = rec
|
|
||||||
save_manifest()
|
|
||||||
|
|
||||||
|
|
||||||
# ================================ 主流程 ================================
|
|
||||||
def main():
|
|
||||||
ap = argparse.ArgumentParser(description="批量人物蒸馏 → llmwiki（定时窗 23:00~08:00）")
|
|
||||||
ap.add_argument("excel", nargs="?", default=str(PEOPLE_FILE_DEFAULT),
|
|
||||||
help="名单文件（.xlsx 或 .csv），默认同目录 people.xlsx")
|
|
||||||
ap.add_argument("--now", action="store_true", help="忽略时间窗，立刻跑完整批（测试用）")
|
|
||||||
ap.add_argument("--redo", action="store_true", help="忽略已完成，全部重做")
|
|
||||||
args = ap.parse_args()
|
|
||||||
|
|
||||||
excel = Path(args.excel)
|
|
||||||
OUTPUT_DIR.mkdir(parents=True, exist_ok=True)
|
|
||||||
manifest_path = OUTPUT_DIR / "manifest.json"
|
|
||||||
|
|
||||||
manifest: dict = {}
|
|
||||||
if manifest_path.exists():
|
|
||||||
try:
|
|
||||||
manifest = json.loads(manifest_path.read_text(encoding="utf-8"))
|
|
||||||
except Exception:
|
|
||||||
manifest = {}
|
|
||||||
|
|
||||||
# 校验名单存在
|
|
||||||
if not read_people(excel):
|
|
||||||
sys.exit(f"名单为空或不存在：{excel}\n请放 people.xlsx（第一列写人名）。")
|
|
||||||
|
|
||||||
# --redo：一次性清掉名单里这些人的旧记录，让他们重做一遍；
|
|
||||||
# 之后本次会话内跑成功的会正常计为「已完成」，循环才会往后推进
|
|
||||||
# （否则每轮 pending() 都把已完成的人当未完成，永远卡在第 1 个人）
|
|
||||||
if args.redo:
|
|
||||||
for p in read_people(excel):
|
|
||||||
manifest.pop(p["name"], None)
|
|
||||||
|
|
||||||
client = DeerFlowClient(BASE_URL)
|
|
||||||
if not client.login():
|
|
||||||
sys.exit("登录失败。请检查 BASE_URL 是否指向正在运行的服务、口令是否正确。")
|
|
||||||
client.ensure_skill_enabled(NUWA_SKILL)
|
|
||||||
client.ensure_skill_enabled(KB_SKILL)
|
|
||||||
|
|
||||||
def save_manifest():
|
|
||||||
manifest_path.write_text(json.dumps(manifest, ensure_ascii=False, indent=2), encoding="utf-8")
|
|
||||||
_write_index(OUTPUT_DIR, read_people(excel), manifest)
|
|
||||||
|
|
||||||
def pending() -> list[dict]:
|
|
||||||
people = read_people(excel)
|
|
||||||
out = []
|
|
||||||
for p in people:
|
|
||||||
r = manifest.get(p["name"], {})
|
|
||||||
done = r.get("status") == "succeeded" and (OUTPUT_DIR / f"{slugify(p['name'])}.md").exists()
|
|
||||||
if not done:
|
|
||||||
out.append(p)
|
|
||||||
return out
|
|
||||||
|
|
||||||
print(f"启动 | 服务={BASE_URL} | 输出={OUTPUT_DIR}")
|
|
||||||
print(f"模式={'立即跑完' if args.now else '定时窗 23:00~08:00'} | 名单={excel}")
|
|
||||||
|
|
||||||
try:
|
|
||||||
while True:
|
|
||||||
todo = pending()
|
|
||||||
if not todo:
|
|
||||||
print(f"[{_now()}] 全部已完成，待命中（每小时复查名单）...")
|
|
||||||
if args.now:
|
|
||||||
break
|
|
||||||
sleep_interruptible(3600)
|
|
||||||
continue
|
|
||||||
|
|
||||||
if not args.now and not in_window():
|
|
||||||
wait = seconds_until_window()
|
|
||||||
nxt = datetime.now().replace(hour=WIN_START.hour, minute=0, second=0, microsecond=0)
|
|
||||||
print(f"[{_now()}] 不在执行窗口，剩 {len(todo)} 人待蒸；"
|
|
||||||
f"休眠到 {nxt.strftime('%H:%M')}（约 {wait//60} 分钟）...")
|
|
||||||
sleep_interruptible(wait)
|
|
||||||
continue
|
|
||||||
|
|
||||||
# 在窗口内（或 --now）：处理一个人，然后回到循环重新判断窗口/名单
|
|
||||||
p = todo[0]
|
|
||||||
idx_total = len(read_people(excel))
|
|
||||||
done_n = sum(1 for v in manifest.values() if v.get("status") == "succeeded")
|
|
||||||
print(f"[{_now()}] ({done_n}/{idx_total} 已完成) 蒸馏：{p['name']}")
|
|
||||||
distill_one(client, p, OUTPUT_DIR, manifest, save_manifest, DEPTH)
|
|
||||||
except KeyboardInterrupt:
|
|
||||||
print("\n已手动停止。重跑脚本会从未完成处继续。")
|
|
||||||
|
|
||||||
ok = sum(1 for r in manifest.values() if r.get("status") == "succeeded")
|
|
||||||
fail = sum(1 for r in manifest.values() if r.get("status") == "failed")
|
|
||||||
print(f"\n结束：成功 {ok} / 失败 {fail}")
|
|
||||||
print(f"结果目录：{OUTPUT_DIR} | 清单：{manifest_path} | 索引：{OUTPUT_DIR/'index.md'}")
|
|
||||||
|
|
||||||
|
|
||||||
def _now() -> str:
|
|
||||||
return time.strftime("%Y-%m-%d %H:%M:%S")
|
|
||||||
|
|
||||||
|
|
||||||
def _write_index(out_dir: Path, people: list[dict], manifest: dict) -> None:
|
|
||||||
lines = ["# 蒸馏执行清单", "", f"更新时间：{_now()}", "",
|
|
||||||
"| # | 人物 | 状态 | 字数 | 耗时 | 文件 |",
|
|
||||||
"|---|------|------|------|------|------|"]
|
|
||||||
badge = {"succeeded": "✅完成", "failed": "❌失败", "running": "⏳进行中"}
|
|
||||||
for i, p in enumerate(people, 1):
|
|
||||||
r = manifest.get(p["name"], {})
|
|
||||||
st = badge.get(r.get("status", ""), "⌛排队")
|
|
||||||
f = r.get("file", "")
|
|
||||||
link = f"[{f}]({f})" if r.get("status") == "succeeded" and f else "-"
|
|
||||||
lines.append(f"| {i} | {p['name']} | {st} | {r.get('chars','-')} | {r.get('seconds','-')} | {link} |")
|
|
||||||
(out_dir / "index.md").write_text("\n".join(lines) + "\n", encoding="utf-8")
|
|
||||||
|
|
||||||
|
|
||||||
if __name__ == "__main__":
|
|
||||||
main()
|
|
||||||
@@ -1,4 +0,0 @@
|
|||||||
姓名,领域(可选提示),资料链接或备注(可选)
|
|
||||||
查理·芒格,投资/多元思维,
|
|
||||||
理查德·费曼,物理/教学,
|
|
||||||
纳瓦尔·拉维坎特,创业/杠杆,https://nav.al/
|
|
||||||
|
@@ -1,136 +0,0 @@
|
|||||||
# zncm Web Clipper
|
|
||||||
|
|
||||||
这是给 zncm 使用的 Chrome 插件，安装后默认连接 `config.js` 中配置好的服务地址。
|
|
||||||
|
|
||||||
默认地址配置在 `browser-extension/deer-web-clipper/config.js`：
|
|
||||||
|
|
||||||
```js
|
|
||||||
globalThis.ZNCM_WEB_CLIPPER_CONFIG = Object.freeze({
|
|
||||||
defaultWebBaseUrl: "http://47.94.209.59:2026",
|
|
||||||
defaultApiBaseUrl: "http://47.94.209.59:2026",
|
|
||||||
});
|
|
||||||
```
|
|
||||||
|
|
||||||
如果部署地址变化，只需要修改 `config.js` 里的这两个字段，然后重新加载插件。
|
|
||||||
|
|
||||||
正常情况下不需要手动配置 URL，也不需要手动复制 token。
|
|
||||||
|
|
||||||
## 能做什么
|
|
||||||
|
|
||||||
1. 把当前浏览器标签页发送到 zncm，作为 Markdown 附件进入聊天。
|
|
||||||
2. 接收 zncm 聊天中由 `browser_fetch_page` 工具创建的网页抓取任务。
|
|
||||||
3. 插件在 Chrome 中打开目标网页，读取可见文本和表格，再把结果回传给 zncm。
|
|
||||||
4. 在普通网页右下角显示“zncm 页面问答”浮窗，直接把当前页面内容交给 zncm 问答。
|
|
||||||
5. 接收 zncm 的 `browser_act` 交互式操作任务：在 Chrome 中打开页面并按 zncm 的指令**操作页面**——点击、输入、滚动、等待、页内跳转，每一步把页面上的可交互元素清单和正文回传给 zncm，由 zncm 决定下一步（observe→act 循环）。
|
|
||||||
|
|
||||||
## 页面操作（browser_act）
|
|
||||||
|
|
||||||
除了只读抓取，zncm 还能驱动插件**实际操作网页**，完成登录、填表、翻页找数据等多步任务：
|
|
||||||
|
|
||||||
1. zncm 调用 `browser_act` 工具，先 `navigate` 打开页面。
|
|
||||||
2. 插件打开标签页（同一会话会复用这个标签页），扫描页面上的可交互元素，给每个元素编号后连同正文回传给 zncm。
|
|
||||||
3. zncm 根据元素编号决定下一步（点第 3 个按钮、在第 1 个输入框填字……），再次调用 `browser_act`。
|
|
||||||
4. 插件执行动作、重新扫描页面、回传新状态，如此循环，直到任务完成。
|
|
||||||
5. 任务结束时 zncm 用 `action="close"` 关闭该会话标签页。
|
|
||||||
|
|
||||||
支持的动作：`navigate`（打开/跳转 URL）、`click`（点击元素）、`type`（输入文字，可选回车提交）、`scroll`（滚动到元素或下翻一屏）、`wait`（等待某 CSS 选择器出现）、`extract`（重新读取正文）、`observe`（仅重新扫描）、`close`（关闭会话标签页）。
|
|
||||||
|
|
||||||
> 提示：页面操作能力较强（可点击任意按钮、提交表单），可在后端 `config.yaml` 用 `browser_context.actions_enabled: false` 关闭，只保留只读抓取。
|
|
||||||
|
|
||||||
## 后端启用
|
|
||||||
|
|
||||||
在 `offline-backend-20260512/backend/config.yaml` 中保持：
|
|
||||||
|
|
||||||
```yaml
|
|
||||||
browser_context:
|
|
||||||
enabled: true # 只读抓取 + 页面问答
|
|
||||||
actions_enabled: true # 交互式页面操作 browser_act（不需要可设为 false）
|
|
||||||
```
|
|
||||||
|
|
||||||
修改配置后需要重启后端。
|
|
||||||
|
|
||||||
## 安装插件
|
|
||||||
|
|
||||||
1. 打开 Chrome 的 `chrome://extensions`。
|
|
||||||
2. 开启右上角的“开发者模式”。
|
|
||||||
3. 点击“加载已解压的扩展程序”。
|
|
||||||
4. 选择目录：`browser-extension/deer-web-clipper`。
|
|
||||||
5. 安装后插件名会显示为 `zncm Web Clipper`。
|
|
||||||
|
|
||||||
## 安装即用
|
|
||||||
|
|
||||||
插件默认已经开启：
|
|
||||||
|
|
||||||
- 自动识别已打开 zncm 页面的服务地址。
|
|
||||||
- 自动同步已登录 zncm 的 token。
|
|
||||||
- 自动轮询 zncm 聊天触发的浏览器抓取任务。
|
|
||||||
- 页面问答框默认开启。
|
|
||||||
|
|
||||||
如果你打开的是 `config.js` 里配置的默认服务器，通常无需进入设置页。
|
|
||||||
|
|
||||||
如果部署地址变了，保持一个已登录的 zncm 页面打开，然后在插件设置里点击：
|
|
||||||
|
|
||||||
- `重新识别服务地址`
|
|
||||||
- `同步 token`
|
|
||||||
|
|
||||||
## 自动同步 Token
|
|
||||||
|
|
||||||
插件会自动从两个位置获取登录 token：
|
|
||||||
|
|
||||||
1. zncm API 域名下的 `access_token` Cookie，包括 HttpOnly Cookie。
|
|
||||||
2. 已登录 zncm 前端页面里的浏览器本地登录态。
|
|
||||||
|
|
||||||
切换登录账号后，插件后台每次轮询任务前都会重新同步 token；点击插件里的“同步 token”也可以立即刷新。
|
|
||||||
|
|
||||||
如果当前浏览器已经登出 zncm，且打开的 zncm 页面里没有 token，插件会清空旧 token，避免继续用上一个账号请求。
|
|
||||||
|
|
||||||
## 页面问答框
|
|
||||||
|
|
||||||
安装插件后，普通 `http` / `https` 页面右下角会出现 `AI` 按钮。点击后可以在当前网页上直接提问，例如：
|
|
||||||
|
|
||||||
```text
|
|
||||||
总结这页的核心结论
|
|
||||||
提取页面里的价格和时间
|
|
||||||
这张表里哪个指标最高？
|
|
||||||
```
|
|
||||||
|
|
||||||
插件会读取当前页面可见文本和表格，发送到 zncm，并把 zncm 的回答显示回浮窗里。多轮追问会复用同一个 zncm 会话；如果页面 URL 变化，会自动重新开始当前页会话。
|
|
||||||
|
|
||||||
是否显示问答框可以自己控制：
|
|
||||||
|
|
||||||
- 插件弹窗里勾选或取消“启用页面问答框”。
|
|
||||||
- 插件设置页里勾选或取消“启用页面问答框”。
|
|
||||||
|
|
||||||
关闭问答框只会隐藏页面浮窗，不会影响“发送当前页”和 zncm 聊天中的 `browser_fetch_page` 抓取任务。
|
|
||||||
|
|
||||||
## 手动发送当前网页
|
|
||||||
|
|
||||||
点击插件图标，选择“发送当前页”。
|
|
||||||
|
|
||||||
插件会读取当前页面的可见文本和表格，发送到 zncm，并打开一个新的 zncm 聊天页面。zncm 会把网页内容作为上传文件注入到首条问题里。
|
|
||||||
|
|
||||||
## 在 zncm 聊天中触发浏览器抓取
|
|
||||||
|
|
||||||
在 zncm 中输入带有明确 URL 的问题，例如：
|
|
||||||
|
|
||||||
```text
|
|
||||||
使用 browser_fetch_page 打开 https://example.com/report，提取页面里的关键表格数据并总结。
|
|
||||||
```
|
|
||||||
|
|
||||||
执行流程：
|
|
||||||
|
|
||||||
1. zncm 调用 `browser_fetch_page` 工具创建浏览器任务。
|
|
||||||
2. 插件后台轮询到任务。
|
|
||||||
3. 插件在 Chrome 中打开目标网页。
|
|
||||||
4. 插件提取页面文本和表格。
|
|
||||||
5. 插件把结果回传给 zncm。
|
|
||||||
6. zncm 基于回传内容回答你的问题。
|
|
||||||
|
|
||||||
这个方式适合读取需要浏览器登录态、内网权限或当前 Chrome 环境才能访问的页面。
|
|
||||||
|
|
||||||
## 注意事项
|
|
||||||
|
|
||||||
- 目标 URL 必须是明确的 `http` 或 `https` 地址。
|
|
||||||
- 插件不能读取 `chrome://` 等浏览器内部页面。
|
|
||||||
- 如果目标网站阻止扩展脚本注入，抓取可能失败。
|
|
||||||
- 后台任务默认会打开新标签页；是否抓取完成后关闭标签页，可在插件设置里配置。
|
|
||||||
@@ -1,905 +0,0 @@
|
|||||||
importScripts("config.js", "shared.js");
|
|
||||||
|
|
||||||
const ALARM_NAME = "deer-browser-task-poll";
|
|
||||||
const LEGACY_LOCAL_API_BASE_URL = "http://localhost:8001";
|
|
||||||
const LEGACY_LOCAL_WEB_BASE_URL = "http://localhost:5174";
|
|
||||||
let pollTimer = null;
|
|
||||||
let isPolling = false;
|
|
||||||
|
|
||||||
function delay(ms) {
|
|
||||||
return new Promise((resolve) => setTimeout(resolve, ms));
|
|
||||||
}
|
|
||||||
|
|
||||||
async function getSettings() {
|
|
||||||
const settings = await chrome.storage.sync.get(DEER_CLIPPER_DEFAULTS);
|
|
||||||
const updates = {};
|
|
||||||
if (!settings.apiBaseUrl || settings.apiBaseUrl === LEGACY_LOCAL_API_BASE_URL) {
|
|
||||||
updates.apiBaseUrl = DEER_CLIPPER_DEFAULTS.apiBaseUrl;
|
|
||||||
}
|
|
||||||
if (!settings.webBaseUrl || settings.webBaseUrl === LEGACY_LOCAL_WEB_BASE_URL) {
|
|
||||||
updates.webBaseUrl = DEER_CLIPPER_DEFAULTS.webBaseUrl;
|
|
||||||
}
|
|
||||||
if (!settings.workerId) {
|
|
||||||
updates.workerId = deerMakeWorkerId();
|
|
||||||
}
|
|
||||||
if (Object.keys(updates).length > 0) {
|
|
||||||
await chrome.storage.sync.set(updates);
|
|
||||||
Object.assign(settings, updates);
|
|
||||||
}
|
|
||||||
return settings;
|
|
||||||
}
|
|
||||||
|
|
||||||
function pollIntervalMs(settings) {
|
|
||||||
const seconds = Number(settings.taskPollIntervalSeconds || DEER_CLIPPER_DEFAULTS.taskPollIntervalSeconds);
|
|
||||||
return Math.max(3, seconds) * 1000;
|
|
||||||
}
|
|
||||||
|
|
||||||
function originMatchPattern(value) {
|
|
||||||
try {
|
|
||||||
const url = new URL(deerNormalizeBaseUrl(value));
|
|
||||||
return `${url.protocol}//${url.host}/*`;
|
|
||||||
} catch {
|
|
||||||
return "";
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
function normalizeServiceBase(value) {
|
|
||||||
return deerNormalizeBaseUrl(value || "");
|
|
||||||
}
|
|
||||||
|
|
||||||
function serviceBaseFromTabUrl(value) {
|
|
||||||
try {
|
|
||||||
const url = new URL(value);
|
|
||||||
const path = url.pathname.replace(/\/+$/, "");
|
|
||||||
if (path === "/deerflow" || path.startsWith("/deerflow/")) {
|
|
||||||
return `${url.origin}/deerflow`;
|
|
||||||
}
|
|
||||||
return url.origin;
|
|
||||||
} catch {
|
|
||||||
return "";
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
function apiCandidatesForWebBase(webBase, currentApiBase) {
|
|
||||||
const candidates = [];
|
|
||||||
const add = (value) => {
|
|
||||||
const normalized = normalizeServiceBase(value);
|
|
||||||
if (normalized && !candidates.includes(normalized)) {
|
|
||||||
candidates.push(normalized);
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
add(currentApiBase);
|
|
||||||
add(webBase);
|
|
||||||
add(DEER_CLIPPER_DEFAULTS.apiBaseUrl);
|
|
||||||
add(LEGACY_LOCAL_API_BASE_URL);
|
|
||||||
|
|
||||||
try {
|
|
||||||
const url = new URL(normalizeServiceBase(webBase));
|
|
||||||
if (["5173", "5174", "3000"].includes(url.port)) {
|
|
||||||
const apiUrl = new URL(url.href);
|
|
||||||
apiUrl.port = "8001";
|
|
||||||
add(apiUrl.href);
|
|
||||||
}
|
|
||||||
} catch {
|
|
||||||
// Ignore invalid candidates.
|
|
||||||
}
|
|
||||||
|
|
||||||
return candidates;
|
|
||||||
}
|
|
||||||
|
|
||||||
async function browserContextStatus(apiBaseUrl) {
|
|
||||||
try {
|
|
||||||
const response = await fetch(`${apiBaseUrl}/api/browser-context/status`, {
|
|
||||||
credentials: "include",
|
|
||||||
});
|
|
||||||
if (!response.ok) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
const data = await response.json().catch(() => null);
|
|
||||||
if (data && typeof data.enabled === "boolean") {
|
|
||||||
return data;
|
|
||||||
}
|
|
||||||
} catch {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
function tabLooksLikeZncm(tab) {
|
|
||||||
const value = `${tab.url || ""} ${tab.title || ""}`.toLowerCase();
|
|
||||||
return (
|
|
||||||
value.includes("deerflow") ||
|
|
||||||
value.includes("deer") ||
|
|
||||||
value.includes("zncm") ||
|
|
||||||
value.includes("/page/workspace") ||
|
|
||||||
value.includes("/chats/") ||
|
|
||||||
value.includes("#/login")
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
async function findOpenZncmTabs(settings) {
|
|
||||||
const tabs = [];
|
|
||||||
const seen = new Set();
|
|
||||||
const addTabs = (items) => {
|
|
||||||
for (const tab of items || []) {
|
|
||||||
if (tab?.id && !seen.has(tab.id)) {
|
|
||||||
seen.add(tab.id);
|
|
||||||
tabs.push(tab);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
for (const pattern of [
|
|
||||||
originMatchPattern(settings.webBaseUrl || DEER_CLIPPER_DEFAULTS.webBaseUrl),
|
|
||||||
originMatchPattern(DEER_CLIPPER_DEFAULTS.webBaseUrl),
|
|
||||||
]) {
|
|
||||||
if (!pattern) {
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
try {
|
|
||||||
addTabs(await chrome.tabs.query({ url: pattern }));
|
|
||||||
} catch {
|
|
||||||
// Continue with broader discovery below.
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
try {
|
|
||||||
const allTabs = await chrome.tabs.query({ url: ["http://*/*", "https://*/*"] });
|
|
||||||
addTabs(allTabs.filter(tabLooksLikeZncm));
|
|
||||||
} catch {
|
|
||||||
// Ignore tab discovery failures.
|
|
||||||
}
|
|
||||||
|
|
||||||
return tabs;
|
|
||||||
}
|
|
||||||
|
|
||||||
async function discoverServiceBases(settings, force = false) {
|
|
||||||
if (!settings.autoDiscoverServiceUrl && !force) {
|
|
||||||
return settings;
|
|
||||||
}
|
|
||||||
|
|
||||||
let webBaseUrl = normalizeServiceBase(settings.webBaseUrl || DEER_CLIPPER_DEFAULTS.webBaseUrl);
|
|
||||||
let discoveredWebBaseUrl = webBaseUrl;
|
|
||||||
let source = "configured";
|
|
||||||
const tabs = await findOpenZncmTabs(settings);
|
|
||||||
if (tabs.length > 0) {
|
|
||||||
const tabBase = serviceBaseFromTabUrl(tabs[0].url);
|
|
||||||
if (tabBase) {
|
|
||||||
discoveredWebBaseUrl = tabBase;
|
|
||||||
source = `tab:${tabs[0].url || tabBase}`;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
let apiBaseUrl = normalizeServiceBase(settings.apiBaseUrl || DEER_CLIPPER_DEFAULTS.apiBaseUrl);
|
|
||||||
let verified = false;
|
|
||||||
for (const candidate of apiCandidatesForWebBase(discoveredWebBaseUrl, apiBaseUrl)) {
|
|
||||||
const status = await browserContextStatus(candidate);
|
|
||||||
if (status) {
|
|
||||||
apiBaseUrl = candidate;
|
|
||||||
webBaseUrl = discoveredWebBaseUrl;
|
|
||||||
verified = true;
|
|
||||||
source = status.enabled ? `${source}:browser_context_enabled` : `${source}:browser_context_disabled`;
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if (!verified && force) {
|
|
||||||
source = `${source}:api_not_verified`;
|
|
||||||
}
|
|
||||||
|
|
||||||
const next = {
|
|
||||||
...settings,
|
|
||||||
apiBaseUrl,
|
|
||||||
webBaseUrl,
|
|
||||||
lastServiceSyncAt: new Date().toISOString(),
|
|
||||||
lastServiceSyncSource: source,
|
|
||||||
};
|
|
||||||
|
|
||||||
if (
|
|
||||||
force ||
|
|
||||||
settings.apiBaseUrl !== next.apiBaseUrl ||
|
|
||||||
settings.webBaseUrl !== next.webBaseUrl ||
|
|
||||||
settings.lastServiceSyncSource !== next.lastServiceSyncSource
|
|
||||||
) {
|
|
||||||
await chrome.storage.sync.set({
|
|
||||||
apiBaseUrl: next.apiBaseUrl,
|
|
||||||
webBaseUrl: next.webBaseUrl,
|
|
||||||
lastServiceSyncAt: next.lastServiceSyncAt,
|
|
||||||
lastServiceSyncSource: next.lastServiceSyncSource,
|
|
||||||
});
|
|
||||||
}
|
|
||||||
return next;
|
|
||||||
}
|
|
||||||
|
|
||||||
async function getCookieToken(settings) {
|
|
||||||
if (!chrome.cookies?.get) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
const apiBaseUrl = deerNormalizeBaseUrl(settings.apiBaseUrl || DEER_CLIPPER_DEFAULTS.apiBaseUrl);
|
|
||||||
try {
|
|
||||||
const cookie = await chrome.cookies.get({ url: apiBaseUrl, name: "access_token" });
|
|
||||||
if (cookie?.value) {
|
|
||||||
return { token: cookie.value, source: `cookie:${new URL(apiBaseUrl).host}:access_token` };
|
|
||||||
}
|
|
||||||
} catch (error) {
|
|
||||||
console.warn("Failed to read zncm access_token cookie", error);
|
|
||||||
}
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
async function getTokenFromOpenZncmTab(settings) {
|
|
||||||
const tabs = await findOpenZncmTabs(settings);
|
|
||||||
let sawZncmTab = false;
|
|
||||||
|
|
||||||
for (const tab of tabs) {
|
|
||||||
if (!tab.id) {
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
sawZncmTab = true;
|
|
||||||
try {
|
|
||||||
const [result] = await chrome.scripting.executeScript({
|
|
||||||
target: { tabId: tab.id },
|
|
||||||
func: deerExtractAuthTokenFromPage,
|
|
||||||
});
|
|
||||||
const tokenInfo = result?.result;
|
|
||||||
if (tokenInfo?.token) {
|
|
||||||
const tabBase = serviceBaseFromTabUrl(tab.url);
|
|
||||||
if (tabBase && settings.autoDiscoverServiceUrl && settings.webBaseUrl !== tabBase) {
|
|
||||||
await chrome.storage.sync.set({
|
|
||||||
webBaseUrl: tabBase,
|
|
||||||
lastServiceSyncAt: new Date().toISOString(),
|
|
||||||
lastServiceSyncSource: `token-tab:${tab.url || tabBase}`,
|
|
||||||
});
|
|
||||||
}
|
|
||||||
return {
|
|
||||||
token: tokenInfo.token,
|
|
||||||
source: tokenInfo.source || `tab:${tab.url || "open-deer-tab"}`,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
} catch (error) {
|
|
||||||
console.warn("Failed to read zncm token from tab", tab.id, error);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if (sawZncmTab) {
|
|
||||||
return { token: "", source: "open-deer-tab", clearStale: true };
|
|
||||||
}
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
async function syncAuthToken(settings = null, forceStatus = false) {
|
|
||||||
let current = settings || (await getSettings());
|
|
||||||
current = await discoverServiceBases(current);
|
|
||||||
if (!current.tokenSyncEnabled && !forceStatus) {
|
|
||||||
return current;
|
|
||||||
}
|
|
||||||
|
|
||||||
const tokenInfo = (await getTokenFromOpenZncmTab(current)) || (await getCookieToken(current));
|
|
||||||
if (!tokenInfo?.token) {
|
|
||||||
if (tokenInfo?.clearStale && current.accessToken) {
|
|
||||||
const next = {
|
|
||||||
...current,
|
|
||||||
accessToken: "",
|
|
||||||
lastTokenSyncSource: "cleared:open-deer-tab-no-token",
|
|
||||||
lastTokenSyncAt: new Date().toISOString(),
|
|
||||||
};
|
|
||||||
await chrome.storage.sync.set({
|
|
||||||
accessToken: "",
|
|
||||||
lastTokenSyncSource: next.lastTokenSyncSource,
|
|
||||||
lastTokenSyncAt: next.lastTokenSyncAt,
|
|
||||||
});
|
|
||||||
return next;
|
|
||||||
}
|
|
||||||
return current;
|
|
||||||
}
|
|
||||||
|
|
||||||
const next = {
|
|
||||||
...current,
|
|
||||||
accessToken: tokenInfo.token,
|
|
||||||
lastTokenSyncSource: tokenInfo.source,
|
|
||||||
lastTokenSyncAt: new Date().toISOString(),
|
|
||||||
};
|
|
||||||
if (
|
|
||||||
forceStatus ||
|
|
||||||
current.accessToken !== next.accessToken ||
|
|
||||||
current.lastTokenSyncSource !== next.lastTokenSyncSource
|
|
||||||
) {
|
|
||||||
await chrome.storage.sync.set({
|
|
||||||
accessToken: next.accessToken,
|
|
||||||
lastTokenSyncSource: next.lastTokenSyncSource,
|
|
||||||
lastTokenSyncAt: next.lastTokenSyncAt,
|
|
||||||
});
|
|
||||||
}
|
|
||||||
return next;
|
|
||||||
}
|
|
||||||
|
|
||||||
async function refreshAlarm(settings) {
|
|
||||||
await chrome.alarms.clear(ALARM_NAME);
|
|
||||||
if (!settings.taskPollingEnabled) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
const minutes = Math.max(0.5, pollIntervalMs(settings) / 60000);
|
|
||||||
await chrome.alarms.create(ALARM_NAME, { delayInMinutes: minutes, periodInMinutes: minutes });
|
|
||||||
}
|
|
||||||
|
|
||||||
async function scheduleNextPoll(delayMs = null) {
|
|
||||||
if (pollTimer) {
|
|
||||||
clearTimeout(pollTimer);
|
|
||||||
pollTimer = null;
|
|
||||||
}
|
|
||||||
const settings = await getSettings();
|
|
||||||
if (!settings.taskPollingEnabled) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
const ms = delayMs ?? pollIntervalMs(settings);
|
|
||||||
pollTimer = setTimeout(() => {
|
|
||||||
void pollOnce().catch((error) => console.warn("zncm task poll failed", error));
|
|
||||||
}, ms);
|
|
||||||
}
|
|
||||||
|
|
||||||
async function waitForTabLoad(tabId, timeoutSeconds) {
|
|
||||||
const timeoutMs = Math.max(5, Number(timeoutSeconds || 30)) * 1000;
|
|
||||||
try {
|
|
||||||
const tab = await chrome.tabs.get(tabId);
|
|
||||||
if (tab.status === "complete") {
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
} catch {
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
|
|
||||||
return new Promise((resolve) => {
|
|
||||||
const timer = setTimeout(() => {
|
|
||||||
chrome.tabs.onUpdated.removeListener(listener);
|
|
||||||
resolve(false);
|
|
||||||
}, timeoutMs);
|
|
||||||
|
|
||||||
function listener(updatedTabId, changeInfo) {
|
|
||||||
if (updatedTabId === tabId && changeInfo.status === "complete") {
|
|
||||||
clearTimeout(timer);
|
|
||||||
chrome.tabs.onUpdated.removeListener(listener);
|
|
||||||
resolve(true);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
chrome.tabs.onUpdated.addListener(listener);
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
async function captureFromTab(tabId, maxContentChars) {
|
|
||||||
const [result] = await chrome.scripting.executeScript({
|
|
||||||
target: { tabId },
|
|
||||||
func: deerExtractCurrentPage,
|
|
||||||
});
|
|
||||||
const page = result?.result;
|
|
||||||
if (!page?.content) {
|
|
||||||
throw new Error("当前页面没有可读取的文本。");
|
|
||||||
}
|
|
||||||
const limit = Math.max(1000, Number(maxContentChars || 200000));
|
|
||||||
if (page.content.length > limit) {
|
|
||||||
page.content = `${page.content.slice(0, limit)}\n\n[Truncated by zncm browser task limit]`;
|
|
||||||
}
|
|
||||||
return page;
|
|
||||||
}
|
|
||||||
|
|
||||||
async function postTaskResult(taskId, settings, payload) {
|
|
||||||
const apiBaseUrl = deerNormalizeBaseUrl(settings.apiBaseUrl || DEER_CLIPPER_DEFAULTS.apiBaseUrl);
|
|
||||||
const response = await fetch(`${apiBaseUrl}/api/browser-context/tasks/${encodeURIComponent(taskId)}/result`, {
|
|
||||||
method: "POST",
|
|
||||||
headers: {
|
|
||||||
"Content-Type": "application/json",
|
|
||||||
...deerAuthHeaders(settings),
|
|
||||||
},
|
|
||||||
body: JSON.stringify(payload),
|
|
||||||
});
|
|
||||||
const data = await response.json().catch(() => ({}));
|
|
||||||
if (!response.ok) {
|
|
||||||
const detail = typeof data.detail === "string" ? data.detail : JSON.stringify(data.detail || data);
|
|
||||||
throw new Error(detail || `HTTP ${response.status}`);
|
|
||||||
}
|
|
||||||
return data;
|
|
||||||
}
|
|
||||||
|
|
||||||
function zncmApiBaseCandidates(settings) {
|
|
||||||
const candidates = [];
|
|
||||||
const add = (value) => {
|
|
||||||
const normalized = deerNormalizeBaseUrl(value || "");
|
|
||||||
if (normalized && !candidates.includes(normalized)) {
|
|
||||||
candidates.push(normalized);
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
add(settings.apiBaseUrl || DEER_CLIPPER_DEFAULTS.apiBaseUrl);
|
|
||||||
try {
|
|
||||||
const url = new URL(deerNormalizeBaseUrl(settings.apiBaseUrl || ""));
|
|
||||||
if (url.pathname && url.pathname !== "/") {
|
|
||||||
add(url.origin);
|
|
||||||
}
|
|
||||||
} catch {
|
|
||||||
// Ignore invalid configured API URL.
|
|
||||||
}
|
|
||||||
add(DEER_CLIPPER_DEFAULTS.apiBaseUrl);
|
|
||||||
return candidates;
|
|
||||||
}
|
|
||||||
|
|
||||||
async function zncmFetchJson(settings, path, options) {
|
|
||||||
let lastError = null;
|
|
||||||
for (const apiBaseUrl of zncmApiBaseCandidates(settings)) {
|
|
||||||
try {
|
|
||||||
const response = await fetch(`${apiBaseUrl}${path}`, options);
|
|
||||||
const contentType = response.headers.get("content-type") || "";
|
|
||||||
const data = contentType.includes("application/json")
|
|
||||||
? await response.json().catch(() => ({}))
|
|
||||||
: { detail: await response.text().catch(() => "") };
|
|
||||||
if (response.ok) {
|
|
||||||
return { data, apiBaseUrl, status: response.status };
|
|
||||||
}
|
|
||||||
const detail = typeof data.detail === "string" ? data.detail : JSON.stringify(data.detail || data);
|
|
||||||
lastError = new Error(detail || `HTTP ${response.status}`);
|
|
||||||
lastError.status = response.status;
|
|
||||||
lastError.detail = detail;
|
|
||||||
lastError.apiBaseUrl = apiBaseUrl;
|
|
||||||
if (response.status !== 404) {
|
|
||||||
throw lastError;
|
|
||||||
}
|
|
||||||
} catch (error) {
|
|
||||||
lastError = error;
|
|
||||||
if (error?.status && error.status !== 404) {
|
|
||||||
throw error;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
throw lastError || new Error("zncm 服务请求失败。");
|
|
||||||
}
|
|
||||||
|
|
||||||
function zncmMakeThreadId() {
|
|
||||||
if (globalThis.crypto?.randomUUID) {
|
|
||||||
return globalThis.crypto.randomUUID();
|
|
||||||
}
|
|
||||||
return `zncm-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
|
|
||||||
}
|
|
||||||
|
|
||||||
function zncmBuildPagePrompt(page, content, truncated, followUp) {
|
|
||||||
const title = page.title || "未知标题";
|
|
||||||
const url = page.url || "未知 URL";
|
|
||||||
const capturedAt = new Date().toISOString();
|
|
||||||
if (followUp) {
|
|
||||||
return [
|
|
||||||
"你是 zncm 页面问答助手。请继续基于本会话里已经读取的网页内容回答用户问题。",
|
|
||||||
"如果已有网页内容不足以回答，请说明缺少哪些信息；不要编造，也不要再尝试抓取其它网页。",
|
|
||||||
`当前页面标题：${title}`,
|
|
||||||
`当前页面 URL：${url}`,
|
|
||||||
`本轮提问时间：${capturedAt}`,
|
|
||||||
].join("\n\n");
|
|
||||||
}
|
|
||||||
|
|
||||||
return [
|
|
||||||
"你是 zncm 页面问答助手。请直接基于当前网页内容回答用户问题。",
|
|
||||||
"如果网页内容不足以回答，请说明缺少哪些信息；不要编造，也不要再尝试抓取其它网页。",
|
|
||||||
`页面标题：${title}`,
|
|
||||||
`页面 URL：${url}`,
|
|
||||||
`读取时间：${capturedAt}`,
|
|
||||||
truncated ? "说明：页面内容较长，本次已按插件限制截断。" : "说明：页面内容如下。",
|
|
||||||
"当前网页内容：",
|
|
||||||
page.contentType === "text" ? `\`\`\`text\n${content}\n\`\`\`` : content,
|
|
||||||
].join("\n\n");
|
|
||||||
}
|
|
||||||
|
|
||||||
function zncmExtractLatestAnswer(values) {
|
|
||||||
const messages = Array.isArray(values?.messages) ? values.messages : [];
|
|
||||||
for (let index = messages.length - 1; index >= 0; index -= 1) {
|
|
||||||
const message = messages[index] || {};
|
|
||||||
const type = String(message.type || message.role || "").toLowerCase();
|
|
||||||
if (type !== "ai" && type !== "assistant") {
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
const content = message.content;
|
|
||||||
if (typeof content === "string" && content.trim()) {
|
|
||||||
return content.trim();
|
|
||||||
}
|
|
||||||
if (Array.isArray(content)) {
|
|
||||||
const text = content
|
|
||||||
.map((part) => {
|
|
||||||
if (typeof part === "string") return part;
|
|
||||||
if (part && typeof part.text === "string") return part.text;
|
|
||||||
return "";
|
|
||||||
})
|
|
||||||
.filter(Boolean)
|
|
||||||
.join("\n")
|
|
||||||
.trim();
|
|
||||||
if (text) {
|
|
||||||
return text;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return "";
|
|
||||||
}
|
|
||||||
|
|
||||||
async function askZncmViaRunsWait(settings, payload, page, question) {
|
|
||||||
const contentLimit = 60000;
|
|
||||||
const rawContent = String(page.content || "");
|
|
||||||
const truncated = rawContent.length > contentLimit;
|
|
||||||
const content = truncated ? `${rawContent.slice(0, contentLimit)}\n\n[Truncated locally by zncm Web Clipper]` : rawContent;
|
|
||||||
const threadId = payload.threadId || zncmMakeThreadId();
|
|
||||||
const promptPrefix = zncmBuildPagePrompt(page, content, truncated, Boolean(payload.threadId));
|
|
||||||
const { data } = await zncmFetchJson(settings, "/api/runs/wait", {
|
|
||||||
method: "POST",
|
|
||||||
headers: {
|
|
||||||
"Content-Type": "application/json",
|
|
||||||
...deerAuthHeaders(settings),
|
|
||||||
},
|
|
||||||
body: JSON.stringify({
|
|
||||||
assistant_id: "lead_agent",
|
|
||||||
input: {
|
|
||||||
messages: [
|
|
||||||
{
|
|
||||||
type: "human",
|
|
||||||
content: question,
|
|
||||||
additional_kwargs: {
|
|
||||||
prompt_prefix: promptPrefix,
|
|
||||||
},
|
|
||||||
},
|
|
||||||
],
|
|
||||||
},
|
|
||||||
config: {
|
|
||||||
configurable: {
|
|
||||||
thread_id: threadId,
|
|
||||||
},
|
|
||||||
},
|
|
||||||
metadata: {
|
|
||||||
source: "zncm_page_assistant",
|
|
||||||
browser_context_url: page.url || "",
|
|
||||||
browser_context_title: page.title || "",
|
|
||||||
browser_context_fallback: true,
|
|
||||||
},
|
|
||||||
stream_mode: ["values"],
|
|
||||||
on_disconnect: "continue",
|
|
||||||
multitask_strategy: "reject",
|
|
||||||
}),
|
|
||||||
});
|
|
||||||
return {
|
|
||||||
success: true,
|
|
||||||
thread_id: threadId,
|
|
||||||
run_id: "",
|
|
||||||
answer: zncmExtractLatestAnswer(data) || "zncm 没有返回可显示的答案。",
|
|
||||||
truncated,
|
|
||||||
message: "zncm 页面问答已完成。",
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
async function askZncmAboutPage(payload) {
|
|
||||||
let settings = await getSettings();
|
|
||||||
settings = await discoverServiceBases(settings);
|
|
||||||
settings = await syncAuthToken(settings);
|
|
||||||
if (!settings.pageAssistantEnabled) {
|
|
||||||
throw new Error("页面问答框已关闭。");
|
|
||||||
}
|
|
||||||
|
|
||||||
const page = payload?.page || {};
|
|
||||||
const question = String(payload?.question || "").trim();
|
|
||||||
if (!question) {
|
|
||||||
throw new Error("请输入要询问的问题。");
|
|
||||||
}
|
|
||||||
if (!page.content) {
|
|
||||||
throw new Error("当前页面没有可读取的正文。");
|
|
||||||
}
|
|
||||||
|
|
||||||
try {
|
|
||||||
const { data } = await zncmFetchJson(settings, "/api/browser-context/ask", {
|
|
||||||
method: "POST",
|
|
||||||
headers: {
|
|
||||||
"Content-Type": "application/json",
|
|
||||||
...deerAuthHeaders(settings),
|
|
||||||
},
|
|
||||||
body: JSON.stringify({
|
|
||||||
thread_id: payload.threadId || null,
|
|
||||||
title: page.title || "",
|
|
||||||
url: page.url || "",
|
|
||||||
content: page.content || "",
|
|
||||||
content_type: page.contentType || "markdown",
|
|
||||||
question,
|
|
||||||
}),
|
|
||||||
});
|
|
||||||
return data;
|
|
||||||
} catch (error) {
|
|
||||||
const detail = String(error?.detail || error?.message || "");
|
|
||||||
if (error?.status === 404 && !/browser context integration is disabled/i.test(detail)) {
|
|
||||||
return askZncmViaRunsWait(settings, payload, page, question);
|
|
||||||
}
|
|
||||||
throw error;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
async function getActSessionMap() {
|
|
||||||
try {
|
|
||||||
const stored = await chrome.storage.session.get({ actSessions: {} });
|
|
||||||
return stored.actSessions && typeof stored.actSessions === "object" ? stored.actSessions : {};
|
|
||||||
} catch {
|
|
||||||
return {};
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
async function setActSessionTab(sessionId, tabId) {
|
|
||||||
if (!sessionId) return;
|
|
||||||
const map = await getActSessionMap();
|
|
||||||
map[sessionId] = tabId;
|
|
||||||
await chrome.storage.session.set({ actSessions: map }).catch(() => {});
|
|
||||||
}
|
|
||||||
|
|
||||||
async function removeActSession(sessionId) {
|
|
||||||
if (!sessionId) return;
|
|
||||||
const map = await getActSessionMap();
|
|
||||||
if (sessionId in map) {
|
|
||||||
delete map[sessionId];
|
|
||||||
await chrome.storage.session.set({ actSessions: map }).catch(() => {});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
async function resolveSessionTabId(sessionId) {
|
|
||||||
const map = await getActSessionMap();
|
|
||||||
const tabId = map[sessionId];
|
|
||||||
if (!tabId) return null;
|
|
||||||
try {
|
|
||||||
await chrome.tabs.get(tabId);
|
|
||||||
return tabId;
|
|
||||||
} catch {
|
|
||||||
await removeActSession(sessionId);
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
async function performActionInTab(tabId, action) {
|
|
||||||
const [result] = await chrome.scripting.executeScript({
|
|
||||||
target: { tabId },
|
|
||||||
func: deerPerformAction,
|
|
||||||
args: [action],
|
|
||||||
});
|
|
||||||
return result?.result || { status: "ok", message: "" };
|
|
||||||
}
|
|
||||||
|
|
||||||
async function observeTab(tabId, maxElements) {
|
|
||||||
const [result] = await chrome.scripting.executeScript({
|
|
||||||
target: { tabId },
|
|
||||||
func: deerObservePage,
|
|
||||||
args: [maxElements],
|
|
||||||
});
|
|
||||||
const observation = result?.result;
|
|
||||||
if (!observation) {
|
|
||||||
throw new Error("当前页面无法读取交互元素。");
|
|
||||||
}
|
|
||||||
return observation;
|
|
||||||
}
|
|
||||||
|
|
||||||
async function runActTask(task, settings) {
|
|
||||||
const sessionId = task.session_id || "";
|
|
||||||
const action = task.action || {};
|
|
||||||
const actionType = String(action.type || "").toLowerCase();
|
|
||||||
const maxElements = 150;
|
|
||||||
|
|
||||||
try {
|
|
||||||
if (!sessionId) {
|
|
||||||
throw new Error("act 任务缺少 session_id。");
|
|
||||||
}
|
|
||||||
|
|
||||||
if (actionType === "close") {
|
|
||||||
const tabId = await resolveSessionTabId(sessionId);
|
|
||||||
if (tabId) {
|
|
||||||
await chrome.tabs.remove(tabId).catch(() => {});
|
|
||||||
}
|
|
||||||
await removeActSession(sessionId);
|
|
||||||
await postTaskResult(task.id, settings, {
|
|
||||||
kind: "act",
|
|
||||||
observation: { action_status: "ok", message: "Tab closed.", url: "", title: "", elements: [], text: "" },
|
|
||||||
metadata: { source: "zncm-web-clipper", worker_id: settings.workerId, session_id: sessionId },
|
|
||||||
});
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
let tabId = await resolveSessionTabId(sessionId);
|
|
||||||
|
|
||||||
if (actionType === "navigate") {
|
|
||||||
const url = String(action.url || task.url || "");
|
|
||||||
if (!url) {
|
|
||||||
throw new Error("navigate 动作缺少 url。");
|
|
||||||
}
|
|
||||||
if (tabId) {
|
|
||||||
await chrome.tabs.update(tabId, { url });
|
|
||||||
} else {
|
|
||||||
const tab = await chrome.tabs.create({ url, active: false });
|
|
||||||
tabId = tab.id;
|
|
||||||
await setActSessionTab(sessionId, tabId);
|
|
||||||
}
|
|
||||||
await waitForTabLoad(tabId, settings.taskPageLoadTimeoutSeconds);
|
|
||||||
await delay(800);
|
|
||||||
} else {
|
|
||||||
if (!tabId) {
|
|
||||||
throw new Error("会话标签页不存在，请先用 navigate 打开页面。");
|
|
||||||
}
|
|
||||||
const outcome = await performActionInTab(tabId, action);
|
|
||||||
// Give the page a moment to react / navigate, then settle.
|
|
||||||
await delay(400);
|
|
||||||
await waitForTabLoad(tabId, settings.taskPageLoadTimeoutSeconds);
|
|
||||||
await delay(500);
|
|
||||||
if (outcome.status === "error") {
|
|
||||||
const observation = await observeTab(tabId, maxElements).catch(() => ({ elements: [], text: "", url: "", title: "" }));
|
|
||||||
await postTaskResult(task.id, settings, {
|
|
||||||
kind: "act",
|
|
||||||
observation: { ...observation, action_status: outcome.status, message: outcome.message },
|
|
||||||
metadata: { source: "zncm-web-clipper", worker_id: settings.workerId, session_id: sessionId },
|
|
||||||
});
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
const observation = await observeTab(tabId, maxElements);
|
|
||||||
await postTaskResult(task.id, settings, {
|
|
||||||
kind: "act",
|
|
||||||
title: observation.title || "",
|
|
||||||
url: observation.url || "",
|
|
||||||
observation: { ...observation, action_status: "ok", message: "" },
|
|
||||||
metadata: { source: "zncm-web-clipper", worker_id: settings.workerId, session_id: sessionId },
|
|
||||||
});
|
|
||||||
} catch (error) {
|
|
||||||
await postTaskResult(task.id, settings, {
|
|
||||||
kind: "act",
|
|
||||||
error: error instanceof Error ? error.message : String(error),
|
|
||||||
metadata: { source: "zncm-web-clipper", worker_id: settings.workerId, session_id: sessionId },
|
|
||||||
}).catch((submitError) => console.warn("Failed to submit zncm act task error", submitError));
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
async function runFetchTask(task, settings) {
|
|
||||||
let tabId = null;
|
|
||||||
try {
|
|
||||||
const tab = await chrome.tabs.create({ url: task.url, active: false });
|
|
||||||
tabId = tab.id;
|
|
||||||
await waitForTabLoad(tabId, settings.taskPageLoadTimeoutSeconds);
|
|
||||||
await delay(750);
|
|
||||||
const page = await captureFromTab(tabId, task.max_content_chars);
|
|
||||||
await postTaskResult(task.id, settings, {
|
|
||||||
kind: "fetch",
|
|
||||||
title: page.title,
|
|
||||||
url: page.url,
|
|
||||||
content: page.content,
|
|
||||||
content_type: page.contentType || "markdown",
|
|
||||||
metadata: {
|
|
||||||
source: "zncm-web-clipper",
|
|
||||||
worker_id: settings.workerId,
|
|
||||||
instruction: task.instruction || "",
|
|
||||||
},
|
|
||||||
});
|
|
||||||
} catch (error) {
|
|
||||||
await postTaskResult(task.id, settings, {
|
|
||||||
kind: "fetch",
|
|
||||||
error: error instanceof Error ? error.message : String(error),
|
|
||||||
metadata: {
|
|
||||||
source: "zncm-web-clipper",
|
|
||||||
worker_id: settings.workerId,
|
|
||||||
},
|
|
||||||
}).catch((submitError) => console.warn("Failed to submit zncm task error", submitError));
|
|
||||||
} finally {
|
|
||||||
if (tabId && settings.closeTaskTabs) {
|
|
||||||
await chrome.tabs.remove(tabId).catch(() => {});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
async function runTask(task, settings) {
|
|
||||||
if ((task.kind || "fetch") === "act") {
|
|
||||||
await runActTask(task, settings);
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
await runFetchTask(task, settings);
|
|
||||||
}
|
|
||||||
|
|
||||||
async function pollOnce() {
|
|
||||||
if (isPolling) {
|
|
||||||
return { ok: true, message: "任务轮询正在运行。" };
|
|
||||||
}
|
|
||||||
|
|
||||||
isPolling = true;
|
|
||||||
try {
|
|
||||||
let settings = await getSettings();
|
|
||||||
settings = await discoverServiceBases(settings);
|
|
||||||
settings = await syncAuthToken(settings);
|
|
||||||
if (!settings.taskPollingEnabled) {
|
|
||||||
return { ok: false, message: "任务轮询已关闭。" };
|
|
||||||
}
|
|
||||||
|
|
||||||
const apiBaseUrl = deerNormalizeBaseUrl(settings.apiBaseUrl || DEER_CLIPPER_DEFAULTS.apiBaseUrl);
|
|
||||||
const url = `${apiBaseUrl}/api/browser-context/tasks/next?worker_id=${encodeURIComponent(settings.workerId)}`;
|
|
||||||
const response = await fetch(url, { headers: deerAuthHeaders(settings) });
|
|
||||||
const data = await response.json().catch(() => ({}));
|
|
||||||
if (!response.ok) {
|
|
||||||
const detail = typeof data.detail === "string" ? data.detail : JSON.stringify(data.detail || data);
|
|
||||||
throw new Error(detail || `HTTP ${response.status}`);
|
|
||||||
}
|
|
||||||
if (!data.task) {
|
|
||||||
return { ok: true, message: "暂无待处理的 zncm 浏览器任务。" };
|
|
||||||
}
|
|
||||||
|
|
||||||
await runTask(data.task, settings);
|
|
||||||
return { ok: true, message: `已完成 zncm 浏览器任务 ${data.task.id}。` };
|
|
||||||
} finally {
|
|
||||||
isPolling = false;
|
|
||||||
await scheduleNextPoll();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
async function startup() {
|
|
||||||
let settings = await getSettings();
|
|
||||||
settings = await discoverServiceBases(settings);
|
|
||||||
settings = await syncAuthToken(settings);
|
|
||||||
await refreshAlarm(settings);
|
|
||||||
await scheduleNextPoll(1000);
|
|
||||||
}
|
|
||||||
|
|
||||||
chrome.runtime.onInstalled.addListener(() => void startup());
|
|
||||||
chrome.runtime.onStartup.addListener(() => void startup());
|
|
||||||
chrome.storage.onChanged.addListener((changes, areaName) => {
|
|
||||||
if (areaName === "sync") {
|
|
||||||
void startup();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
chrome.alarms.onAlarm.addListener((alarm) => {
|
|
||||||
if (alarm.name === ALARM_NAME) {
|
|
||||||
void pollOnce().catch((error) => console.warn("zncm alarm poll failed", error));
|
|
||||||
}
|
|
||||||
});
|
|
||||||
chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
|
|
||||||
if (message?.type === "zncm-discover-service") {
|
|
||||||
getSettings()
|
|
||||||
.then((settings) => discoverServiceBases(settings, true))
|
|
||||||
.then((settings) =>
|
|
||||||
sendResponse({
|
|
||||||
ok: Boolean(settings.apiBaseUrl && settings.webBaseUrl),
|
|
||||||
message: `服务地址：${settings.webBaseUrl}；API：${settings.apiBaseUrl}`,
|
|
||||||
apiBaseUrl: settings.apiBaseUrl,
|
|
||||||
webBaseUrl: settings.webBaseUrl,
|
|
||||||
source: settings.lastServiceSyncSource || "",
|
|
||||||
}),
|
|
||||||
)
|
|
||||||
.catch((error) => sendResponse({ ok: false, message: error instanceof Error ? error.message : String(error) }));
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (message?.type === "zncm-sync-token") {
|
|
||||||
syncAuthToken(null, true)
|
|
||||||
.then((settings) => {
|
|
||||||
const hasToken = Boolean(settings.accessToken);
|
|
||||||
sendResponse({
|
|
||||||
ok: hasToken,
|
|
||||||
message: hasToken
|
|
||||||
? `Token 已从 ${settings.lastTokenSyncSource || "zncm"} 同步。`
|
|
||||||
: "没有找到 zncm token。请打开已登录的 zncm 页面后重试。",
|
|
||||||
source: settings.lastTokenSyncSource || "",
|
|
||||||
});
|
|
||||||
})
|
|
||||||
.catch((error) => sendResponse({ ok: false, message: error instanceof Error ? error.message : String(error) }));
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (message?.type === "zncm-page-agent-ask") {
|
|
||||||
askZncmAboutPage(message)
|
|
||||||
.then((result) => sendResponse({ ok: true, ...result }))
|
|
||||||
.catch((error) => sendResponse({ ok: false, message: error instanceof Error ? error.message : String(error) }));
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (message?.type === "zncm-open-options") {
|
|
||||||
chrome.runtime.openOptionsPage()
|
|
||||||
.then(() => sendResponse({ ok: true }))
|
|
||||||
.catch((error) => sendResponse({ ok: false, message: error instanceof Error ? error.message : String(error) }));
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (message?.type !== "zncm-poll-now") {
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
pollOnce()
|
|
||||||
.then((result) => sendResponse(result))
|
|
||||||
.catch((error) => sendResponse({ ok: false, message: error instanceof Error ? error.message : String(error) }));
|
|
||||||
return true;
|
|
||||||
});
|
|
||||||
|
|
||||||
void startup();
|
|
||||||
@@ -1,9 +0,0 @@
|
|||||||
// Default deployment settings for zncm Web Clipper.
|
|
||||||
//
|
|
||||||
// Change these two values before loading or packaging the extension when the
|
|
||||||
// zncm service address changes. Users can still override them in the extension
|
|
||||||
// settings page after installation.
|
|
||||||
globalThis.ZNCM_WEB_CLIPPER_CONFIG = Object.freeze({
|
|
||||||
defaultWebBaseUrl: "http://47.94.209.59:2026",
|
|
||||||
defaultApiBaseUrl: "http://47.94.209.59:2026",
|
|
||||||
});
|
|
||||||
@@ -1,737 +0,0 @@
|
|||||||
(() => {
|
|
||||||
if (window.top !== window || window.__zncmPageAssistantLoaded) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
window.__zncmPageAssistantLoaded = true;
|
|
||||||
|
|
||||||
const HOST_ID = "zncm-page-assistant-host";
|
|
||||||
const state = {
|
|
||||||
enabled: true,
|
|
||||||
open: false,
|
|
||||||
busy: false,
|
|
||||||
threadId: "",
|
|
||||||
pageUrl: location.href,
|
|
||||||
messages: [],
|
|
||||||
};
|
|
||||||
|
|
||||||
let host = null;
|
|
||||||
let shadow = null;
|
|
||||||
let ui = {};
|
|
||||||
|
|
||||||
function sendRuntimeMessage(message) {
|
|
||||||
return new Promise((resolve, reject) => {
|
|
||||||
chrome.runtime.sendMessage(message, (response) => {
|
|
||||||
const error = chrome.runtime.lastError;
|
|
||||||
if (error) {
|
|
||||||
reject(new Error(error.message));
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
resolve(response || {});
|
|
||||||
});
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
function makeElement(tag, className = "", text = "") {
|
|
||||||
const element = document.createElement(tag);
|
|
||||||
if (className) {
|
|
||||||
element.className = className;
|
|
||||||
}
|
|
||||||
if (text) {
|
|
||||||
element.textContent = text;
|
|
||||||
}
|
|
||||||
return element;
|
|
||||||
}
|
|
||||||
|
|
||||||
function setStatus(message) {
|
|
||||||
if (ui.status) {
|
|
||||||
ui.status.textContent = message || "";
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
function setBusy(busy) {
|
|
||||||
state.busy = busy;
|
|
||||||
if (ui.send) ui.send.disabled = busy;
|
|
||||||
if (ui.input) ui.input.disabled = busy;
|
|
||||||
if (ui.panel) ui.panel.classList.toggle("is-busy", busy);
|
|
||||||
}
|
|
||||||
|
|
||||||
function resetThreadIfPageChanged() {
|
|
||||||
if (state.pageUrl === location.href) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
state.pageUrl = location.href;
|
|
||||||
state.threadId = "";
|
|
||||||
state.messages = [];
|
|
||||||
renderMessages();
|
|
||||||
setStatus("页面已变化，下一次提问会重新读取当前页面。");
|
|
||||||
}
|
|
||||||
|
|
||||||
function destroyWidget() {
|
|
||||||
if (host) {
|
|
||||||
host.remove();
|
|
||||||
}
|
|
||||||
host = null;
|
|
||||||
shadow = null;
|
|
||||||
ui = {};
|
|
||||||
}
|
|
||||||
|
|
||||||
function renderMessages() {
|
|
||||||
if (!ui.messages) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
ui.messages.replaceChildren();
|
|
||||||
if (state.messages.length === 0) {
|
|
||||||
const empty = makeElement("div", "empty");
|
|
||||||
const emptyTitle = makeElement("strong", "", "问问当前页面");
|
|
||||||
const emptyText = makeElement("span", "", "可以提问页面里的数据、表格、段落和结论。");
|
|
||||||
empty.append(emptyTitle, emptyText);
|
|
||||||
ui.messages.appendChild(empty);
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
for (const message of state.messages) {
|
|
||||||
const item = makeElement("div", `message ${message.role}`);
|
|
||||||
const avatar = makeElement("div", "avatar", message.role === "user" ? "你" : "zn");
|
|
||||||
const bubble = makeElement("div", "bubble");
|
|
||||||
const label = makeElement("div", "message-label", message.role === "user" ? "你" : "zncm");
|
|
||||||
const body = makeElement("div", "message-body", message.text);
|
|
||||||
if (message.pending) {
|
|
||||||
body.classList.add("pending");
|
|
||||||
}
|
|
||||||
bubble.append(label, body);
|
|
||||||
item.append(avatar, bubble);
|
|
||||||
ui.messages.appendChild(item);
|
|
||||||
}
|
|
||||||
ui.messages.scrollTop = ui.messages.scrollHeight;
|
|
||||||
}
|
|
||||||
|
|
||||||
function setOpen(open) {
|
|
||||||
state.open = open;
|
|
||||||
if (!ui.panel || !ui.launcher) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
ui.panel.classList.toggle("open", open);
|
|
||||||
ui.launcher.classList.toggle("open", open);
|
|
||||||
ui.launcher.setAttribute("aria-expanded", String(open));
|
|
||||||
if (open) {
|
|
||||||
resetThreadIfPageChanged();
|
|
||||||
setTimeout(() => ui.input?.focus(), 50);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
async function ask(question) {
|
|
||||||
const normalized = String(question || "").trim();
|
|
||||||
if (!normalized || state.busy) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
resetThreadIfPageChanged();
|
|
||||||
setBusy(true);
|
|
||||||
setStatus("正在读取页面并发送给 zncm...");
|
|
||||||
state.messages.push({ role: "user", text: normalized });
|
|
||||||
const pending = { role: "assistant", text: "zncm 正在理解当前页面...", pending: true };
|
|
||||||
state.messages.push(pending);
|
|
||||||
renderMessages();
|
|
||||||
ui.input.value = "";
|
|
||||||
|
|
||||||
try {
|
|
||||||
if (typeof deerExtractCurrentPage !== "function") {
|
|
||||||
throw new Error("页面读取脚本未加载，请刷新当前页面后重试。");
|
|
||||||
}
|
|
||||||
const page = deerExtractCurrentPage();
|
|
||||||
const response = await sendRuntimeMessage({
|
|
||||||
type: "zncm-page-agent-ask",
|
|
||||||
page,
|
|
||||||
question: normalized,
|
|
||||||
threadId: state.threadId || "",
|
|
||||||
});
|
|
||||||
if (!response.ok) {
|
|
||||||
throw new Error(response.message || "zncm 没有返回答案。");
|
|
||||||
}
|
|
||||||
state.threadId = response.thread_id || state.threadId;
|
|
||||||
pending.text = response.answer || "zncm 没有返回答案。";
|
|
||||||
pending.pending = false;
|
|
||||||
setStatus(response.truncated ? "已回答。页面内容较长，本次按配置做了截断。" : "已回答。");
|
|
||||||
} catch (error) {
|
|
||||||
pending.text = error instanceof Error ? error.message : "页面问答失败。";
|
|
||||||
pending.pending = false;
|
|
||||||
setStatus("本次问答失败。");
|
|
||||||
} finally {
|
|
||||||
setBusy(false);
|
|
||||||
renderMessages();
|
|
||||||
ui.input.focus();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
function buildWidget() {
|
|
||||||
host = document.createElement("div");
|
|
||||||
host.id = HOST_ID;
|
|
||||||
document.documentElement.appendChild(host);
|
|
||||||
shadow = host.attachShadow({ mode: "open" });
|
|
||||||
|
|
||||||
const style = document.createElement("style");
|
|
||||||
style.textContent = `
|
|
||||||
:host {
|
|
||||||
all: initial;
|
|
||||||
color-scheme: light;
|
|
||||||
font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
|
|
||||||
}
|
|
||||||
|
|
||||||
.launcher,
|
|
||||||
.panel {
|
|
||||||
position: fixed;
|
|
||||||
z-index: 2147483647;
|
|
||||||
font: 14px/1.45 Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
|
|
||||||
}
|
|
||||||
|
|
||||||
.launcher {
|
|
||||||
right: 20px;
|
|
||||||
bottom: 20px;
|
|
||||||
display: grid;
|
|
||||||
grid-template-columns: auto 1fr;
|
|
||||||
align-items: center;
|
|
||||||
gap: 8px;
|
|
||||||
height: 44px;
|
|
||||||
min-width: 112px;
|
|
||||||
border: 1px solid rgba(15, 118, 110, 0.28);
|
|
||||||
border-radius: 8px;
|
|
||||||
padding: 0 12px 0 10px;
|
|
||||||
background: #0f766e;
|
|
||||||
color: #fff;
|
|
||||||
box-shadow: 0 12px 34px rgba(15, 118, 110, 0.28), 0 2px 8px rgba(17, 24, 39, 0.12);
|
|
||||||
cursor: pointer;
|
|
||||||
font-weight: 750;
|
|
||||||
transition: transform 160ms ease, box-shadow 160ms ease, background 160ms ease;
|
|
||||||
}
|
|
||||||
|
|
||||||
.launcher:hover {
|
|
||||||
transform: translateY(-2px);
|
|
||||||
box-shadow: 0 16px 40px rgba(15, 118, 110, 0.32), 0 4px 12px rgba(17, 24, 39, 0.14);
|
|
||||||
}
|
|
||||||
|
|
||||||
.launcher-mark {
|
|
||||||
display: grid;
|
|
||||||
place-items: center;
|
|
||||||
width: 24px;
|
|
||||||
height: 24px;
|
|
||||||
border-radius: 7px;
|
|
||||||
background: rgba(255, 255, 255, 0.18);
|
|
||||||
font-size: 12px;
|
|
||||||
letter-spacing: 0;
|
|
||||||
box-shadow: inset 0 0 0 1px rgba(255, 255, 255, 0.2);
|
|
||||||
}
|
|
||||||
|
|
||||||
.launcher.open {
|
|
||||||
background: #115e59;
|
|
||||||
}
|
|
||||||
|
|
||||||
.panel {
|
|
||||||
right: 20px;
|
|
||||||
bottom: 72px;
|
|
||||||
width: min(430px, calc(100vw - 24px));
|
|
||||||
max-height: min(640px, calc(100vh - 96px));
|
|
||||||
display: none;
|
|
||||||
grid-template-rows: auto auto minmax(180px, 1fr) auto;
|
|
||||||
overflow: hidden;
|
|
||||||
border: 1px solid #d6d8dc;
|
|
||||||
border-radius: 8px;
|
|
||||||
background: #ffffff;
|
|
||||||
color: #171717;
|
|
||||||
box-shadow: 0 24px 70px rgba(17, 24, 39, 0.2), 0 1px 2px rgba(17, 24, 39, 0.08);
|
|
||||||
}
|
|
||||||
|
|
||||||
.panel.open {
|
|
||||||
display: grid;
|
|
||||||
animation: zncm-panel-in 160ms ease-out;
|
|
||||||
}
|
|
||||||
|
|
||||||
@keyframes zncm-panel-in {
|
|
||||||
from {
|
|
||||||
opacity: 0;
|
|
||||||
transform: translateY(8px) scale(0.985);
|
|
||||||
}
|
|
||||||
to {
|
|
||||||
opacity: 1;
|
|
||||||
transform: translateY(0) scale(1);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
.header {
|
|
||||||
display: grid;
|
|
||||||
gap: 10px;
|
|
||||||
padding: 14px;
|
|
||||||
background: linear-gradient(180deg, #f4fffc 0%, #ffffff 84%);
|
|
||||||
border-bottom: 1px solid #e5e7eb;
|
|
||||||
}
|
|
||||||
|
|
||||||
.header-top {
|
|
||||||
display: flex;
|
|
||||||
align-items: center;
|
|
||||||
justify-content: space-between;
|
|
||||||
gap: 12px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.brand {
|
|
||||||
display: flex;
|
|
||||||
align-items: center;
|
|
||||||
min-width: 0;
|
|
||||||
gap: 10px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.brand-mark {
|
|
||||||
display: grid;
|
|
||||||
place-items: center;
|
|
||||||
width: 34px;
|
|
||||||
height: 34px;
|
|
||||||
flex: 0 0 auto;
|
|
||||||
border-radius: 8px;
|
|
||||||
background: #0f766e;
|
|
||||||
color: #fff;
|
|
||||||
font-weight: 800;
|
|
||||||
box-shadow: 0 8px 20px rgba(15, 118, 110, 0.18);
|
|
||||||
}
|
|
||||||
|
|
||||||
.brand-copy {
|
|
||||||
display: grid;
|
|
||||||
min-width: 0;
|
|
||||||
gap: 1px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.brand-copy strong {
|
|
||||||
color: #111827;
|
|
||||||
font-size: 15px;
|
|
||||||
line-height: 1.25;
|
|
||||||
}
|
|
||||||
|
|
||||||
.brand-copy span {
|
|
||||||
overflow: hidden;
|
|
||||||
color: #6b7280;
|
|
||||||
font-size: 12px;
|
|
||||||
text-overflow: ellipsis;
|
|
||||||
white-space: nowrap;
|
|
||||||
}
|
|
||||||
|
|
||||||
.header-actions {
|
|
||||||
display: flex;
|
|
||||||
flex: 0 0 auto;
|
|
||||||
gap: 6px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.icon-button {
|
|
||||||
display: grid;
|
|
||||||
place-items: center;
|
|
||||||
width: auto;
|
|
||||||
min-width: 34px;
|
|
||||||
height: 30px;
|
|
||||||
padding: 0 8px;
|
|
||||||
border: 1px solid #dfe3e8;
|
|
||||||
border-radius: 7px;
|
|
||||||
background: #fff;
|
|
||||||
color: #374151;
|
|
||||||
cursor: pointer;
|
|
||||||
font: inherit;
|
|
||||||
font-size: 12px;
|
|
||||||
white-space: nowrap;
|
|
||||||
transition: background 140ms ease, border-color 140ms ease, color 140ms ease;
|
|
||||||
}
|
|
||||||
|
|
||||||
.icon-button:hover {
|
|
||||||
border-color: #0f766e;
|
|
||||||
color: #0f766e;
|
|
||||||
background: #f0fdfa;
|
|
||||||
}
|
|
||||||
|
|
||||||
.page-chip {
|
|
||||||
display: grid;
|
|
||||||
grid-template-columns: auto 1fr;
|
|
||||||
align-items: center;
|
|
||||||
gap: 8px;
|
|
||||||
min-width: 0;
|
|
||||||
border: 1px solid #dbeafe;
|
|
||||||
border-radius: 8px;
|
|
||||||
padding: 8px 10px;
|
|
||||||
background: #f8fbff;
|
|
||||||
color: #334155;
|
|
||||||
box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.8);
|
|
||||||
}
|
|
||||||
|
|
||||||
.page-chip-dot {
|
|
||||||
width: 8px;
|
|
||||||
height: 8px;
|
|
||||||
border-radius: 999px;
|
|
||||||
background: #0f766e;
|
|
||||||
}
|
|
||||||
|
|
||||||
.page-chip-text {
|
|
||||||
overflow: hidden;
|
|
||||||
font-size: 12px;
|
|
||||||
text-overflow: ellipsis;
|
|
||||||
white-space: nowrap;
|
|
||||||
}
|
|
||||||
|
|
||||||
.status {
|
|
||||||
min-height: 20px;
|
|
||||||
padding: 9px 14px;
|
|
||||||
border-bottom: 1px solid #f0f2f5;
|
|
||||||
color: #475569;
|
|
||||||
background: #fbfcfd;
|
|
||||||
font-size: 12px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.messages {
|
|
||||||
display: grid;
|
|
||||||
align-content: start;
|
|
||||||
gap: 12px;
|
|
||||||
overflow: auto;
|
|
||||||
padding: 14px;
|
|
||||||
background: linear-gradient(180deg, #f7f8fa 0%, #f3f6f8 100%);
|
|
||||||
}
|
|
||||||
|
|
||||||
.empty {
|
|
||||||
display: grid;
|
|
||||||
gap: 5px;
|
|
||||||
padding: 16px;
|
|
||||||
border: 1px solid #dfe7ed;
|
|
||||||
border-radius: 8px;
|
|
||||||
background: linear-gradient(180deg, #ffffff 0%, #fbfefd 100%);
|
|
||||||
color: #4b5563;
|
|
||||||
box-shadow: 0 8px 20px rgba(15, 23, 42, 0.04);
|
|
||||||
}
|
|
||||||
|
|
||||||
.empty strong {
|
|
||||||
color: #111827;
|
|
||||||
font-size: 14px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.empty span {
|
|
||||||
font-size: 13px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.message {
|
|
||||||
display: grid;
|
|
||||||
grid-template-columns: 28px minmax(0, 1fr);
|
|
||||||
gap: 8px;
|
|
||||||
align-items: start;
|
|
||||||
}
|
|
||||||
|
|
||||||
.message.user {
|
|
||||||
grid-template-columns: minmax(0, 1fr) 28px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.message.user .avatar {
|
|
||||||
grid-column: 2;
|
|
||||||
}
|
|
||||||
|
|
||||||
.message.user .bubble {
|
|
||||||
grid-column: 1;
|
|
||||||
justify-self: end;
|
|
||||||
}
|
|
||||||
|
|
||||||
.avatar {
|
|
||||||
display: grid;
|
|
||||||
place-items: center;
|
|
||||||
width: 28px;
|
|
||||||
height: 28px;
|
|
||||||
border-radius: 8px;
|
|
||||||
background: #e6fffb;
|
|
||||||
color: #0f766e;
|
|
||||||
font-size: 11px;
|
|
||||||
font-weight: 800;
|
|
||||||
}
|
|
||||||
|
|
||||||
.message.user .avatar {
|
|
||||||
background: #111827;
|
|
||||||
color: #fff;
|
|
||||||
}
|
|
||||||
|
|
||||||
.bubble {
|
|
||||||
display: grid;
|
|
||||||
gap: 4px;
|
|
||||||
max-width: 100%;
|
|
||||||
}
|
|
||||||
|
|
||||||
.message-label {
|
|
||||||
color: #6b7280;
|
|
||||||
font-size: 11px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.message.user .message-label {
|
|
||||||
text-align: right;
|
|
||||||
}
|
|
||||||
|
|
||||||
.message-body {
|
|
||||||
max-width: 330px;
|
|
||||||
padding: 10px 12px;
|
|
||||||
border: 1px solid #e5e7eb;
|
|
||||||
border-radius: 8px;
|
|
||||||
background: #fff;
|
|
||||||
color: #171717;
|
|
||||||
white-space: pre-wrap;
|
|
||||||
overflow-wrap: anywhere;
|
|
||||||
box-shadow: 0 1px 2px rgba(15, 23, 42, 0.04);
|
|
||||||
}
|
|
||||||
|
|
||||||
.message.user .message-body {
|
|
||||||
border-color: #0f172a;
|
|
||||||
background: #0f172a;
|
|
||||||
color: #fff;
|
|
||||||
}
|
|
||||||
|
|
||||||
.message-body.pending {
|
|
||||||
color: #6b7280;
|
|
||||||
}
|
|
||||||
|
|
||||||
.message-body.pending::after {
|
|
||||||
content: "";
|
|
||||||
display: inline-block;
|
|
||||||
width: 18px;
|
|
||||||
height: 4px;
|
|
||||||
margin-left: 6px;
|
|
||||||
border-radius: 999px;
|
|
||||||
background: linear-gradient(90deg, #0f766e 0 33%, transparent 33% 100%);
|
|
||||||
background-size: 9px 4px;
|
|
||||||
animation: zncm-thinking 900ms linear infinite;
|
|
||||||
vertical-align: middle;
|
|
||||||
}
|
|
||||||
|
|
||||||
@keyframes zncm-thinking {
|
|
||||||
from {
|
|
||||||
background-position: 0 0;
|
|
||||||
}
|
|
||||||
to {
|
|
||||||
background-position: 18px 0;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
.composer-wrap {
|
|
||||||
display: grid;
|
|
||||||
gap: 10px;
|
|
||||||
padding: 12px 14px 14px;
|
|
||||||
background: #fff;
|
|
||||||
border-top: 1px solid #e5e7eb;
|
|
||||||
}
|
|
||||||
|
|
||||||
.quick {
|
|
||||||
display: grid;
|
|
||||||
grid-template-columns: repeat(2, minmax(0, 1fr));
|
|
||||||
gap: 7px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.quick button {
|
|
||||||
border: 1px solid #d6d8dc;
|
|
||||||
border-radius: 8px;
|
|
||||||
padding: 8px 10px;
|
|
||||||
background: #fbfcfd;
|
|
||||||
color: #374151;
|
|
||||||
cursor: pointer;
|
|
||||||
font: inherit;
|
|
||||||
font-size: 12px;
|
|
||||||
text-align: left;
|
|
||||||
transition: background 140ms ease, border-color 140ms ease, color 140ms ease, transform 140ms ease;
|
|
||||||
}
|
|
||||||
|
|
||||||
.quick button:hover {
|
|
||||||
border-color: #0f766e;
|
|
||||||
color: #0f766e;
|
|
||||||
background: #f0fdfa;
|
|
||||||
transform: translateY(-1px);
|
|
||||||
}
|
|
||||||
|
|
||||||
.composer {
|
|
||||||
display: grid;
|
|
||||||
grid-template-columns: 1fr auto;
|
|
||||||
gap: 8px;
|
|
||||||
align-items: end;
|
|
||||||
}
|
|
||||||
|
|
||||||
.composer textarea {
|
|
||||||
min-height: 46px;
|
|
||||||
max-height: 130px;
|
|
||||||
resize: vertical;
|
|
||||||
border: 1px solid #cfd6dd;
|
|
||||||
border-radius: 8px;
|
|
||||||
padding: 10px 11px;
|
|
||||||
color: #171717;
|
|
||||||
background: #fbfcfd;
|
|
||||||
font: inherit;
|
|
||||||
outline: none;
|
|
||||||
}
|
|
||||||
|
|
||||||
.composer textarea:focus {
|
|
||||||
border-color: #0f766e;
|
|
||||||
box-shadow: 0 0 0 3px rgba(15, 118, 110, 0.12);
|
|
||||||
}
|
|
||||||
|
|
||||||
.composer button {
|
|
||||||
height: 42px;
|
|
||||||
border: 0;
|
|
||||||
border-radius: 8px;
|
|
||||||
padding: 0 14px;
|
|
||||||
background: #0f766e;
|
|
||||||
color: #fff;
|
|
||||||
cursor: pointer;
|
|
||||||
font: inherit;
|
|
||||||
font-weight: 750;
|
|
||||||
box-shadow: 0 8px 18px rgba(15, 118, 110, 0.2);
|
|
||||||
transition: transform 140ms ease, background 140ms ease, box-shadow 140ms ease;
|
|
||||||
}
|
|
||||||
|
|
||||||
.composer button:hover {
|
|
||||||
background: #115e59;
|
|
||||||
transform: translateY(-1px);
|
|
||||||
box-shadow: 0 10px 22px rgba(15, 118, 110, 0.24);
|
|
||||||
}
|
|
||||||
|
|
||||||
.panel.is-busy .brand-mark,
|
|
||||||
.panel.is-busy .launcher-mark {
|
|
||||||
opacity: 0.82;
|
|
||||||
}
|
|
||||||
|
|
||||||
.composer button:disabled,
|
|
||||||
.quick button:disabled,
|
|
||||||
.icon-button:disabled {
|
|
||||||
cursor: not-allowed;
|
|
||||||
opacity: 0.6;
|
|
||||||
}
|
|
||||||
|
|
||||||
@media (max-width: 480px) {
|
|
||||||
.launcher {
|
|
||||||
right: 12px;
|
|
||||||
bottom: 12px;
|
|
||||||
min-width: 96px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.panel {
|
|
||||||
right: 12px;
|
|
||||||
bottom: 64px;
|
|
||||||
width: calc(100vw - 24px);
|
|
||||||
max-height: calc(100vh - 80px);
|
|
||||||
}
|
|
||||||
|
|
||||||
.message-body {
|
|
||||||
max-width: calc(100vw - 104px);
|
|
||||||
}
|
|
||||||
|
|
||||||
.quick {
|
|
||||||
grid-template-columns: 1fr;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
`;
|
|
||||||
|
|
||||||
const launcher = makeElement("button", "launcher");
|
|
||||||
launcher.type = "button";
|
|
||||||
launcher.title = "打开 zncm 页面问答";
|
|
||||||
launcher.setAttribute("aria-expanded", "false");
|
|
||||||
launcher.append(makeElement("span", "launcher-mark", "zn"), makeElement("span", "", "页面问答"));
|
|
||||||
|
|
||||||
const panel = makeElement("section", "panel");
|
|
||||||
const header = makeElement("header", "header");
|
|
||||||
const headerTop = makeElement("div", "header-top");
|
|
||||||
const brand = makeElement("div", "brand");
|
|
||||||
const brandCopy = makeElement("div", "brand-copy");
|
|
||||||
const title = makeElement("strong", "", "zncm 页面问答");
|
|
||||||
const subtitle = makeElement("span", "", "读取当前页面并回答");
|
|
||||||
brandCopy.append(title, subtitle);
|
|
||||||
brand.append(makeElement("div", "brand-mark", "zn"), brandCopy);
|
|
||||||
|
|
||||||
const actions = makeElement("div", "header-actions");
|
|
||||||
const settings = makeElement("button", "icon-button", "设置");
|
|
||||||
settings.type = "button";
|
|
||||||
settings.title = "打开插件设置";
|
|
||||||
const minimize = makeElement("button", "icon-button", "－");
|
|
||||||
minimize.type = "button";
|
|
||||||
minimize.title = "收起";
|
|
||||||
actions.append(settings, minimize);
|
|
||||||
headerTop.append(brand, actions);
|
|
||||||
|
|
||||||
const pageChip = makeElement("div", "page-chip");
|
|
||||||
const pageTitle = makeElement("span", "page-chip-text", document.title || location.hostname);
|
|
||||||
pageChip.append(makeElement("span", "page-chip-dot"), pageTitle);
|
|
||||||
header.append(headerTop, pageChip);
|
|
||||||
|
|
||||||
const status = makeElement("div", "status", "已连接当前页面。");
|
|
||||||
const messages = makeElement("div", "messages");
|
|
||||||
|
|
||||||
const composerWrap = makeElement("div", "composer-wrap");
|
|
||||||
const quick = makeElement("div", "quick");
|
|
||||||
for (const text of ["总结此页", "提取关键数据", "列出待办", "解释表格"]) {
|
|
||||||
const chip = makeElement("button", "", text);
|
|
||||||
chip.type = "button";
|
|
||||||
chip.addEventListener("click", () => ask(text));
|
|
||||||
quick.appendChild(chip);
|
|
||||||
}
|
|
||||||
|
|
||||||
const composer = makeElement("form", "composer");
|
|
||||||
const input = makeElement("textarea");
|
|
||||||
input.placeholder = "问当前页面...";
|
|
||||||
input.rows = 2;
|
|
||||||
const send = makeElement("button", "", "发送");
|
|
||||||
send.type = "submit";
|
|
||||||
composer.append(input, send);
|
|
||||||
composerWrap.append(quick, composer);
|
|
||||||
|
|
||||||
panel.append(header, status, messages, composerWrap);
|
|
||||||
shadow.append(style, panel, launcher);
|
|
||||||
|
|
||||||
ui = { launcher, panel, subtitle, pageTitle, status, messages, input, send };
|
|
||||||
renderMessages();
|
|
||||||
|
|
||||||
launcher.addEventListener("click", () => setOpen(!state.open));
|
|
||||||
minimize.addEventListener("click", () => setOpen(false));
|
|
||||||
settings.addEventListener("click", () => {
|
|
||||||
sendRuntimeMessage({ type: "zncm-open-options" }).catch((error) => {
|
|
||||||
setStatus(error instanceof Error ? error.message : "无法打开插件设置。");
|
|
||||||
});
|
|
||||||
});
|
|
||||||
composer.addEventListener("submit", (event) => {
|
|
||||||
event.preventDefault();
|
|
||||||
ask(input.value);
|
|
||||||
});
|
|
||||||
input.addEventListener("keydown", (event) => {
|
|
||||||
if (event.key === "Enter" && !event.shiftKey) {
|
|
||||||
event.preventDefault();
|
|
||||||
ask(input.value);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
function ensureWidget() {
|
|
||||||
if (!state.enabled) {
|
|
||||||
destroyWidget();
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
if (document.getElementById(HOST_ID)) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
buildWidget();
|
|
||||||
}
|
|
||||||
|
|
||||||
async function loadSettings() {
|
|
||||||
const settings = await chrome.storage.sync.get(DEER_CLIPPER_DEFAULTS);
|
|
||||||
state.enabled = Boolean(settings.pageAssistantEnabled);
|
|
||||||
ensureWidget();
|
|
||||||
}
|
|
||||||
|
|
||||||
chrome.storage.onChanged.addListener((changes, areaName) => {
|
|
||||||
if (areaName !== "sync" || !changes.pageAssistantEnabled) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
state.enabled = Boolean(changes.pageAssistantEnabled.newValue);
|
|
||||||
ensureWidget();
|
|
||||||
if (state.enabled) {
|
|
||||||
setStatus("页面问答框已开启。");
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
setInterval(() => {
|
|
||||||
if (!state.enabled || !ui.pageTitle) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
if (state.pageUrl !== location.href) {
|
|
||||||
resetThreadIfPageChanged();
|
|
||||||
}
|
|
||||||
ui.pageTitle.textContent = document.title || location.hostname;
|
|
||||||
}, 1200);
|
|
||||||
|
|
||||||
void loadSettings();
|
|
||||||
})();
|
|
||||||
@@ -1,24 +0,0 @@
|
|||||||
{
|
|
||||||
"manifest_version": 3,
|
|
||||||
"name": "zncm Web Clipper",
|
|
||||||
"version": "0.2.0",
|
|
||||||
"description": "Send pages to zncm and execute browser-backed fetch tasks.",
|
|
||||||
"permissions": ["activeTab", "alarms", "cookies", "scripting", "storage", "tabs"],
|
|
||||||
"host_permissions": ["<all_urls>"],
|
|
||||||
"background": {
|
|
||||||
"service_worker": "background.js"
|
|
||||||
},
|
|
||||||
"action": {
|
|
||||||
"default_title": "zncm Web Clipper",
|
|
||||||
"default_popup": "popup.html"
|
|
||||||
},
|
|
||||||
"options_page": "options.html",
|
|
||||||
"content_scripts": [
|
|
||||||
{
|
|
||||||
"matches": ["http://*/*", "https://*/*"],
|
|
||||||
"js": ["config.js", "shared.js", "content.js"],
|
|
||||||
"run_at": "document_idle",
|
|
||||||
"all_frames": false
|
|
||||||
}
|
|
||||||
]
|
|
||||||
}
|
|
||||||
@@ -1,74 +0,0 @@
|
|||||||
<!doctype html>
|
|
||||||
<html lang="zh-CN">
|
|
||||||
<head>
|
|
||||||
<meta charset="utf-8" />
|
|
||||||
<title>zncm Web Clipper Settings</title>
|
|
||||||
<link rel="stylesheet" href="styles.css" />
|
|
||||||
</head>
|
|
||||||
<body>
|
|
||||||
<main class="options">
|
|
||||||
<h1>zncm Web Clipper Settings</h1>
|
|
||||||
<label>
|
|
||||||
API 地址
|
|
||||||
<input id="apiBaseUrl" />
|
|
||||||
</label>
|
|
||||||
<label>
|
|
||||||
前端地址
|
|
||||||
<input id="webBaseUrl" />
|
|
||||||
</label>
|
|
||||||
<label class="checkbox">
|
|
||||||
<input id="autoDiscoverServiceUrl" type="checkbox" />
|
|
||||||
自动识别已打开 zncm 页面的服务地址
|
|
||||||
</label>
|
|
||||||
<div class="actions">
|
|
||||||
<button id="discoverService" type="button">重新识别服务地址</button>
|
|
||||||
</div>
|
|
||||||
<p id="serviceStatus" class="status"></p>
|
|
||||||
<label>
|
|
||||||
Access Token
|
|
||||||
<textarea id="accessToken" rows="5" placeholder="会自动从已登录 zncm 页面或 access_token Cookie 获取。也可以手动粘贴。"></textarea>
|
|
||||||
</label>
|
|
||||||
<label class="checkbox">
|
|
||||||
<input id="tokenSyncEnabled" type="checkbox" />
|
|
||||||
自动同步已登录 zncm 的 token
|
|
||||||
</label>
|
|
||||||
<div class="actions">
|
|
||||||
<button id="syncToken" type="button">Sync token now</button>
|
|
||||||
</div>
|
|
||||||
<p id="tokenStatus" class="status"></p>
|
|
||||||
<label class="checkbox">
|
|
||||||
<input id="pageAssistantEnabled" type="checkbox" />
|
|
||||||
启用页面问答框
|
|
||||||
</label>
|
|
||||||
<label>
|
|
||||||
默认首问
|
|
||||||
<textarea id="defaultPrompt" rows="4"></textarea>
|
|
||||||
</label>
|
|
||||||
<label class="checkbox">
|
|
||||||
<input id="taskPollingEnabled" type="checkbox" />
|
|
||||||
启用 zncm 聊天触发的浏览器抓取任务
|
|
||||||
</label>
|
|
||||||
<label>
|
|
||||||
Worker ID
|
|
||||||
<input id="workerId" placeholder="自动生成" />
|
|
||||||
</label>
|
|
||||||
<label>
|
|
||||||
任务轮询间隔秒数
|
|
||||||
<input id="taskPollIntervalSeconds" type="number" min="3" step="1" />
|
|
||||||
</label>
|
|
||||||
<label>
|
|
||||||
页面加载超时秒数
|
|
||||||
<input id="taskPageLoadTimeoutSeconds" type="number" min="5" step="1" />
|
|
||||||
</label>
|
|
||||||
<label class="checkbox">
|
|
||||||
<input id="closeTaskTabs" type="checkbox" />
|
|
||||||
抓取完成后关闭任务标签页
|
|
||||||
</label>
|
|
||||||
<button id="save" type="button">保存</button>
|
|
||||||
<p id="status" class="status"></p>
|
|
||||||
</main>
|
|
||||||
<script src="config.js"></script>
|
|
||||||
<script src="shared.js"></script>
|
|
||||||
<script src="options.js"></script>
|
|
||||||
</body>
|
|
||||||
</html>
|
|
||||||
@@ -1,148 +0,0 @@
|
|||||||
const textFields = [
|
|
||||||
"apiBaseUrl",
|
|
||||||
"webBaseUrl",
|
|
||||||
"accessToken",
|
|
||||||
"defaultPrompt",
|
|
||||||
"workerId",
|
|
||||||
"taskPollIntervalSeconds",
|
|
||||||
"taskPageLoadTimeoutSeconds",
|
|
||||||
];
|
|
||||||
const checkboxFields = [
|
|
||||||
"autoDiscoverServiceUrl",
|
|
||||||
"tokenSyncEnabled",
|
|
||||||
"pageAssistantEnabled",
|
|
||||||
"taskPollingEnabled",
|
|
||||||
"closeTaskTabs",
|
|
||||||
];
|
|
||||||
|
|
||||||
function formatServiceStatus(settings) {
|
|
||||||
if (!settings.lastServiceSyncAt) {
|
|
||||||
return `当前服务地址：${settings.webBaseUrl || DEER_CLIPPER_DEFAULTS.webBaseUrl}；API：${settings.apiBaseUrl || DEER_CLIPPER_DEFAULTS.apiBaseUrl}`;
|
|
||||||
}
|
|
||||||
return `当前服务地址：${settings.webBaseUrl || ""}；API：${settings.apiBaseUrl || ""}\n上次识别：${settings.lastServiceSyncAt}（${settings.lastServiceSyncSource || "unknown source"}）`;
|
|
||||||
}
|
|
||||||
|
|
||||||
function formatTokenStatus(settings) {
|
|
||||||
if (!settings.lastTokenSyncAt) {
|
|
||||||
return "Token 尚未自动同步。";
|
|
||||||
}
|
|
||||||
return `上次 token 同步：${settings.lastTokenSyncAt}（${settings.lastTokenSyncSource || "unknown source"}）`;
|
|
||||||
}
|
|
||||||
|
|
||||||
async function loadSettings() {
|
|
||||||
const settings = await chrome.storage.sync.get(DEER_CLIPPER_DEFAULTS);
|
|
||||||
if (!settings.workerId) {
|
|
||||||
settings.workerId = deerMakeWorkerId();
|
|
||||||
await chrome.storage.sync.set({ workerId: settings.workerId });
|
|
||||||
}
|
|
||||||
document.getElementById("apiBaseUrl").placeholder =
|
|
||||||
DEER_CLIPPER_DEFAULTS.apiBaseUrl || "在 config.js 中配置默认 API 地址";
|
|
||||||
document.getElementById("webBaseUrl").placeholder =
|
|
||||||
DEER_CLIPPER_DEFAULTS.webBaseUrl || "在 config.js 中配置默认前端地址";
|
|
||||||
for (const field of textFields) {
|
|
||||||
document.getElementById(field).value = settings[field] ?? "";
|
|
||||||
}
|
|
||||||
for (const field of checkboxFields) {
|
|
||||||
document.getElementById(field).checked = Boolean(settings[field]);
|
|
||||||
}
|
|
||||||
document.getElementById("serviceStatus").textContent = formatServiceStatus(settings);
|
|
||||||
document.getElementById("tokenStatus").textContent = formatTokenStatus(settings);
|
|
||||||
}
|
|
||||||
|
|
||||||
async function saveSettings() {
|
|
||||||
const next = {};
|
|
||||||
for (const field of textFields) {
|
|
||||||
next[field] = document.getElementById(field).value.trim();
|
|
||||||
}
|
|
||||||
for (const field of checkboxFields) {
|
|
||||||
next[field] = document.getElementById(field).checked;
|
|
||||||
}
|
|
||||||
next.apiBaseUrl = deerNormalizeBaseUrl(next.apiBaseUrl || DEER_CLIPPER_DEFAULTS.apiBaseUrl);
|
|
||||||
next.webBaseUrl = deerNormalizeBaseUrl(next.webBaseUrl || DEER_CLIPPER_DEFAULTS.webBaseUrl);
|
|
||||||
next.defaultPrompt = next.defaultPrompt || DEER_CLIPPER_DEFAULT_PROMPT;
|
|
||||||
next.workerId = next.workerId || deerMakeWorkerId();
|
|
||||||
next.taskPollIntervalSeconds = Math.max(3, Number(next.taskPollIntervalSeconds || DEER_CLIPPER_DEFAULTS.taskPollIntervalSeconds));
|
|
||||||
next.taskPageLoadTimeoutSeconds = Math.max(5, Number(next.taskPageLoadTimeoutSeconds || DEER_CLIPPER_DEFAULTS.taskPageLoadTimeoutSeconds));
|
|
||||||
await chrome.storage.sync.set(next);
|
|
||||||
const settings = await chrome.storage.sync.get(DEER_CLIPPER_DEFAULTS);
|
|
||||||
document.getElementById("status").textContent = "已保存。";
|
|
||||||
document.getElementById("serviceStatus").textContent = formatServiceStatus(settings);
|
|
||||||
document.getElementById("tokenStatus").textContent = formatTokenStatus(settings);
|
|
||||||
}
|
|
||||||
|
|
||||||
function sendDiscoverServiceMessage() {
|
|
||||||
return new Promise((resolve, reject) => {
|
|
||||||
chrome.runtime.sendMessage({ type: "zncm-discover-service" }, (response) => {
|
|
||||||
const error = chrome.runtime.lastError;
|
|
||||||
if (error) {
|
|
||||||
reject(new Error(error.message));
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
resolve(response || { ok: false, message: "服务地址识别没有返回结果。" });
|
|
||||||
});
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
function sendSyncTokenMessage() {
|
|
||||||
return new Promise((resolve, reject) => {
|
|
||||||
chrome.runtime.sendMessage({ type: "zncm-sync-token" }, (response) => {
|
|
||||||
const error = chrome.runtime.lastError;
|
|
||||||
if (error) {
|
|
||||||
reject(new Error(error.message));
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
resolve(response || { ok: false, message: "Token 同步没有返回结果。" });
|
|
||||||
});
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
async function discoverServiceNow() {
|
|
||||||
const button = document.getElementById("discoverService");
|
|
||||||
button.disabled = true;
|
|
||||||
document.getElementById("serviceStatus").textContent = "正在识别服务地址...";
|
|
||||||
try {
|
|
||||||
await chrome.storage.sync.set({
|
|
||||||
autoDiscoverServiceUrl: document.getElementById("autoDiscoverServiceUrl").checked,
|
|
||||||
apiBaseUrl: deerNormalizeBaseUrl(document.getElementById("apiBaseUrl").value || DEER_CLIPPER_DEFAULTS.apiBaseUrl),
|
|
||||||
webBaseUrl: deerNormalizeBaseUrl(document.getElementById("webBaseUrl").value || DEER_CLIPPER_DEFAULTS.webBaseUrl),
|
|
||||||
});
|
|
||||||
const response = await sendDiscoverServiceMessage();
|
|
||||||
const settings = await chrome.storage.sync.get(DEER_CLIPPER_DEFAULTS);
|
|
||||||
document.getElementById("apiBaseUrl").value = settings.apiBaseUrl || "";
|
|
||||||
document.getElementById("webBaseUrl").value = settings.webBaseUrl || "";
|
|
||||||
document.getElementById("serviceStatus").textContent = response.message || formatServiceStatus(settings);
|
|
||||||
} catch (error) {
|
|
||||||
document.getElementById("serviceStatus").textContent = error instanceof Error ? error.message : "服务地址识别失败。";
|
|
||||||
} finally {
|
|
||||||
button.disabled = false;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
async function syncTokenNow() {
|
|
||||||
const button = document.getElementById("syncToken");
|
|
||||||
button.disabled = true;
|
|
||||||
document.getElementById("tokenStatus").textContent = "正在同步 zncm token...";
|
|
||||||
try {
|
|
||||||
await chrome.storage.sync.set({
|
|
||||||
tokenSyncEnabled: document.getElementById("tokenSyncEnabled").checked,
|
|
||||||
apiBaseUrl: deerNormalizeBaseUrl(document.getElementById("apiBaseUrl").value || DEER_CLIPPER_DEFAULTS.apiBaseUrl),
|
|
||||||
webBaseUrl: deerNormalizeBaseUrl(document.getElementById("webBaseUrl").value || DEER_CLIPPER_DEFAULTS.webBaseUrl),
|
|
||||||
});
|
|
||||||
const response = await sendSyncTokenMessage();
|
|
||||||
const settings = await chrome.storage.sync.get(DEER_CLIPPER_DEFAULTS);
|
|
||||||
document.getElementById("accessToken").value = settings.accessToken || "";
|
|
||||||
document.getElementById("apiBaseUrl").value = settings.apiBaseUrl || "";
|
|
||||||
document.getElementById("webBaseUrl").value = settings.webBaseUrl || "";
|
|
||||||
document.getElementById("serviceStatus").textContent = formatServiceStatus(settings);
|
|
||||||
document.getElementById("tokenStatus").textContent = response.message || formatTokenStatus(settings);
|
|
||||||
} catch (error) {
|
|
||||||
document.getElementById("tokenStatus").textContent = error instanceof Error ? error.message : "Token 同步失败。";
|
|
||||||
} finally {
|
|
||||||
button.disabled = false;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
document.getElementById("save").addEventListener("click", saveSettings);
|
|
||||||
document.getElementById("discoverService").addEventListener("click", discoverServiceNow);
|
|
||||||
document.getElementById("syncToken").addEventListener("click", syncTokenNow);
|
|
||||||
void loadSettings();
|
|
||||||
@@ -1,31 +0,0 @@
|
|||||||
<!doctype html>
|
|
||||||
<html lang="zh-CN">
|
|
||||||
<head>
|
|
||||||
<meta charset="utf-8" />
|
|
||||||
<title>zncm Web Clipper</title>
|
|
||||||
<link rel="stylesheet" href="styles.css" />
|
|
||||||
</head>
|
|
||||||
<body>
|
|
||||||
<main class="popup">
|
|
||||||
<h1>zncm Web Clipper</h1>
|
|
||||||
<label>
|
|
||||||
首问
|
|
||||||
<textarea id="prompt" rows="4"></textarea>
|
|
||||||
</label>
|
|
||||||
<label class="checkbox">
|
|
||||||
<input id="pageAssistantEnabled" type="checkbox" />
|
|
||||||
启用页面问答框
|
|
||||||
</label>
|
|
||||||
<div class="actions">
|
|
||||||
<button id="send" type="button">发送当前页</button>
|
|
||||||
<button id="syncToken" type="button">同步 token</button>
|
|
||||||
<button id="pollNow" type="button">检查任务</button>
|
|
||||||
<button id="options" type="button" class="secondary">设置</button>
|
|
||||||
</div>
|
|
||||||
<p id="status" class="status"></p>
|
|
||||||
</main>
|
|
||||||
<script src="config.js"></script>
|
|
||||||
<script src="shared.js"></script>
|
|
||||||
<script src="popup.js"></script>
|
|
||||||
</body>
|
|
||||||
</html>
|
|
||||||
@@ -1,151 +0,0 @@
|
|||||||
function setStatus(message) {
|
|
||||||
document.getElementById("status").textContent = message;
|
|
||||||
}
|
|
||||||
|
|
||||||
async function getActiveTab() {
|
|
||||||
const [tab] = await chrome.tabs.query({ active: true, currentWindow: true });
|
|
||||||
if (!tab?.id) {
|
|
||||||
throw new Error("No readable active tab found.");
|
|
||||||
}
|
|
||||||
return tab;
|
|
||||||
}
|
|
||||||
|
|
||||||
async function captureFromActiveTab(tabId) {
|
|
||||||
const [result] = await chrome.scripting.executeScript({
|
|
||||||
target: { tabId },
|
|
||||||
func: deerExtractCurrentPage,
|
|
||||||
});
|
|
||||||
if (!result?.result?.content) {
|
|
||||||
throw new Error("The current page has no readable text to send.");
|
|
||||||
}
|
|
||||||
return result.result;
|
|
||||||
}
|
|
||||||
|
|
||||||
async function submitToZncm(page, settings, prompt) {
|
|
||||||
const apiBaseUrl = deerNormalizeBaseUrl(settings.apiBaseUrl || DEER_CLIPPER_DEFAULTS.apiBaseUrl);
|
|
||||||
const response = await fetch(`${apiBaseUrl}/api/browser-context/capture`, {
|
|
||||||
method: "POST",
|
|
||||||
headers: {
|
|
||||||
"Content-Type": "application/json",
|
|
||||||
...deerAuthHeaders(settings),
|
|
||||||
},
|
|
||||||
body: JSON.stringify({
|
|
||||||
title: page.title,
|
|
||||||
url: page.url,
|
|
||||||
content: page.content,
|
|
||||||
content_type: page.contentType,
|
|
||||||
prompt,
|
|
||||||
}),
|
|
||||||
});
|
|
||||||
|
|
||||||
const data = await response.json().catch(() => ({}));
|
|
||||||
if (!response.ok) {
|
|
||||||
const detail = typeof data.detail === "string" ? data.detail : JSON.stringify(data.detail || data);
|
|
||||||
throw new Error(detail || `HTTP ${response.status}`);
|
|
||||||
}
|
|
||||||
return data;
|
|
||||||
}
|
|
||||||
|
|
||||||
async function sendCurrentPage() {
|
|
||||||
const sendButton = document.getElementById("send");
|
|
||||||
sendButton.disabled = true;
|
|
||||||
setStatus("正在读取当前页面...");
|
|
||||||
try {
|
|
||||||
await syncToken({ silent: true });
|
|
||||||
const settings = await chrome.storage.sync.get(DEER_CLIPPER_DEFAULTS);
|
|
||||||
const prompt = document.getElementById("prompt").value.trim() || settings.defaultPrompt || DEER_CLIPPER_DEFAULT_PROMPT;
|
|
||||||
const tab = await getActiveTab();
|
|
||||||
const page = await captureFromActiveTab(tab.id);
|
|
||||||
setStatus("正在发送到 zncm...");
|
|
||||||
const result = await submitToZncm(page, settings, prompt);
|
|
||||||
const webBaseUrl = deerNormalizeBaseUrl(settings.webBaseUrl || DEER_CLIPPER_DEFAULTS.webBaseUrl);
|
|
||||||
await chrome.tabs.create({ url: `${webBaseUrl}/${result.chat_url}`.replace(/\/#/g, "/#") });
|
|
||||||
setStatus("已发送，zncm 聊天页面已打开。");
|
|
||||||
} catch (error) {
|
|
||||||
setStatus(error instanceof Error ? error.message : "发送失败。");
|
|
||||||
} finally {
|
|
||||||
sendButton.disabled = false;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
function sendSyncTokenMessage() {
|
|
||||||
return new Promise((resolve, reject) => {
|
|
||||||
chrome.runtime.sendMessage({ type: "zncm-sync-token" }, (response) => {
|
|
||||||
const error = chrome.runtime.lastError;
|
|
||||||
if (error) {
|
|
||||||
reject(new Error(error.message));
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
resolve(response || { ok: false, message: "Token 同步没有返回结果。" });
|
|
||||||
});
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
function sendPollNowMessage() {
|
|
||||||
return new Promise((resolve, reject) => {
|
|
||||||
chrome.runtime.sendMessage({ type: "zncm-poll-now" }, (response) => {
|
|
||||||
const error = chrome.runtime.lastError;
|
|
||||||
if (error) {
|
|
||||||
reject(new Error(error.message));
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
resolve(response || { ok: true, message: "Poll requested." });
|
|
||||||
});
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
async function syncToken(options = {}) {
|
|
||||||
const button = document.getElementById("syncToken");
|
|
||||||
button.disabled = true;
|
|
||||||
if (!options.silent) {
|
|
||||||
setStatus("正在同步 zncm token...");
|
|
||||||
}
|
|
||||||
try {
|
|
||||||
const response = await sendSyncTokenMessage();
|
|
||||||
if (!options.silent) {
|
|
||||||
setStatus(response.message || "Token sync finished.");
|
|
||||||
}
|
|
||||||
return response;
|
|
||||||
} catch (error) {
|
|
||||||
if (!options.silent) {
|
|
||||||
setStatus(error instanceof Error ? error.message : "Token 同步失败。");
|
|
||||||
}
|
|
||||||
return { ok: false, message: error instanceof Error ? error.message : "Token 同步失败。" };
|
|
||||||
} finally {
|
|
||||||
button.disabled = false;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
async function pollNow() {
|
|
||||||
const button = document.getElementById("pollNow");
|
|
||||||
button.disabled = true;
|
|
||||||
setStatus("正在检查 zncm 浏览器任务...");
|
|
||||||
try {
|
|
||||||
await syncToken({ silent: true });
|
|
||||||
const response = await sendPollNowMessage();
|
|
||||||
setStatus(response.message || "任务检查完成。");
|
|
||||||
} catch (error) {
|
|
||||||
setStatus(error instanceof Error ? error.message : "任务检查失败。");
|
|
||||||
} finally {
|
|
||||||
button.disabled = false;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
async function togglePageAssistant() {
|
|
||||||
const enabled = document.getElementById("pageAssistantEnabled").checked;
|
|
||||||
await chrome.storage.sync.set({ pageAssistantEnabled: enabled });
|
|
||||||
setStatus(enabled ? "页面问答框已开启。" : "页面问答框已关闭。");
|
|
||||||
}
|
|
||||||
|
|
||||||
async function init() {
|
|
||||||
const settings = await chrome.storage.sync.get(DEER_CLIPPER_DEFAULTS);
|
|
||||||
document.getElementById("prompt").value = settings.defaultPrompt || DEER_CLIPPER_DEFAULT_PROMPT;
|
|
||||||
document.getElementById("pageAssistantEnabled").checked = Boolean(settings.pageAssistantEnabled);
|
|
||||||
document.getElementById("send").addEventListener("click", sendCurrentPage);
|
|
||||||
document.getElementById("syncToken").addEventListener("click", () => syncToken());
|
|
||||||
document.getElementById("pollNow").addEventListener("click", pollNow);
|
|
||||||
document.getElementById("pageAssistantEnabled").addEventListener("change", togglePageAssistant);
|
|
||||||
document.getElementById("options").addEventListener("click", () => chrome.runtime.openOptionsPage());
|
|
||||||
}
|
|
||||||
|
|
||||||
void init();
|
|
||||||
@@ -1,389 +0,0 @@
|
|||||||
const DEER_CLIPPER_DEFAULT_PROMPT =
|
|
||||||
"\u8bf7\u57fa\u4e8e\u521a\u521a\u53d1\u9001\u7684\u7f51\u9875\u5185\u5bb9\uff0c\u5148\u7528\u4e2d\u6587\u603b\u7ed3\u8981\u70b9\uff0c\u5e76\u7b49\u5f85\u6211\u7ee7\u7eed\u63d0\u95ee\u3002";
|
|
||||||
|
|
||||||
const ZNCM_EXTENSION_CONFIG = globalThis.ZNCM_WEB_CLIPPER_CONFIG || {};
|
|
||||||
const ZNCM_DEFAULT_WEB_BASE_URL = String(ZNCM_EXTENSION_CONFIG.defaultWebBaseUrl || "").trim().replace(/\/+$/, "");
|
|
||||||
const ZNCM_DEFAULT_API_BASE_URL = String(ZNCM_EXTENSION_CONFIG.defaultApiBaseUrl || "").trim().replace(/\/+$/, "");
|
|
||||||
|
|
||||||
const DEER_CLIPPER_DEFAULTS = {
|
|
||||||
apiBaseUrl: ZNCM_DEFAULT_API_BASE_URL,
|
|
||||||
webBaseUrl: ZNCM_DEFAULT_WEB_BASE_URL,
|
|
||||||
autoDiscoverServiceUrl: true,
|
|
||||||
lastServiceSyncAt: "",
|
|
||||||
lastServiceSyncSource: "",
|
|
||||||
accessToken: "",
|
|
||||||
tokenSyncEnabled: true,
|
|
||||||
lastTokenSyncAt: "",
|
|
||||||
lastTokenSyncSource: "",
|
|
||||||
defaultPrompt: DEER_CLIPPER_DEFAULT_PROMPT,
|
|
||||||
pageAssistantEnabled: true,
|
|
||||||
taskPollingEnabled: true,
|
|
||||||
workerId: "",
|
|
||||||
taskPollIntervalSeconds: 5,
|
|
||||||
taskPageLoadTimeoutSeconds: 30,
|
|
||||||
closeTaskTabs: false,
|
|
||||||
};
|
|
||||||
|
|
||||||
function deerNormalizeBaseUrl(value) {
|
|
||||||
return String(value || "").trim().replace(/\/+$/, "");
|
|
||||||
}
|
|
||||||
|
|
||||||
function deerAuthHeaders(settings) {
|
|
||||||
const token = String(settings.accessToken || "").trim();
|
|
||||||
if (!token) {
|
|
||||||
return {};
|
|
||||||
}
|
|
||||||
return {
|
|
||||||
Authorization: /^bearer\s+/i.test(token) ? token : `Bearer ${token}`,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
function deerMakeWorkerId() {
|
|
||||||
return `zncm-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
|
|
||||||
}
|
|
||||||
|
|
||||||
function deerExtractAuthTokenFromPage() {
|
|
||||||
const storageKeys = ["deerflow.auth"];
|
|
||||||
const tokenFieldNames = new Set(["access_token", "accessToken", "token", "id_token", "idToken"]);
|
|
||||||
|
|
||||||
function looksLikeToken(value) {
|
|
||||||
const text = String(value || "").trim();
|
|
||||||
return text.length > 20 && !/\s/.test(text);
|
|
||||||
}
|
|
||||||
|
|
||||||
function findToken(value, depth = 0) {
|
|
||||||
if (value == null || depth > 4) {
|
|
||||||
return "";
|
|
||||||
}
|
|
||||||
if (typeof value === "string") {
|
|
||||||
const text = value.trim();
|
|
||||||
if (!text) {
|
|
||||||
return "";
|
|
||||||
}
|
|
||||||
if ((text.startsWith("{") && text.endsWith("}")) || (text.startsWith("[") && text.endsWith("]"))) {
|
|
||||||
try {
|
|
||||||
return findToken(JSON.parse(text), depth + 1);
|
|
||||||
} catch {
|
|
||||||
return looksLikeToken(text) ? text : "";
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return looksLikeToken(text) ? text : "";
|
|
||||||
}
|
|
||||||
if (typeof value !== "object") {
|
|
||||||
return "";
|
|
||||||
}
|
|
||||||
for (const [key, nested] of Object.entries(value)) {
|
|
||||||
if (tokenFieldNames.has(key) && looksLikeToken(nested)) {
|
|
||||||
return String(nested).trim();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
for (const nested of Object.values(value)) {
|
|
||||||
const token = findToken(nested, depth + 1);
|
|
||||||
if (token) {
|
|
||||||
return token;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return "";
|
|
||||||
}
|
|
||||||
|
|
||||||
function scanStorage(storage, storageName) {
|
|
||||||
for (const key of storageKeys) {
|
|
||||||
const token = findToken(storage.getItem(key));
|
|
||||||
if (token) {
|
|
||||||
return { token, source: `${storageName}:${key}` };
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
for (let index = 0; index < storage.length; index += 1) {
|
|
||||||
const key = storage.key(index);
|
|
||||||
if (!key || !/(auth|token|session)/i.test(key)) {
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
const token = findToken(storage.getItem(key));
|
|
||||||
if (token) {
|
|
||||||
return { token, source: `${storageName}:${key}` };
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
try {
|
|
||||||
return scanStorage(window.localStorage, "localStorage") || scanStorage(window.sessionStorage, "sessionStorage");
|
|
||||||
} catch (error) {
|
|
||||||
return { token: "", source: "", error: error instanceof Error ? error.message : String(error) };
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
function deerExtractCurrentPage() {
|
|
||||||
const maxLocalChars = 220000;
|
|
||||||
|
|
||||||
function cleanText(value) {
|
|
||||||
return String(value || "")
|
|
||||||
.replace(/\s+\n/g, "\n")
|
|
||||||
.replace(/\n{3,}/g, "\n\n")
|
|
||||||
.trim();
|
|
||||||
}
|
|
||||||
|
|
||||||
function escapeCell(value) {
|
|
||||||
return cleanText(value).replace(/\|/g, "\\|").replace(/\n/g, " ");
|
|
||||||
}
|
|
||||||
|
|
||||||
function tableToMarkdown(table, index) {
|
|
||||||
const rows = Array.from(table.rows || []).map((row) =>
|
|
||||||
Array.from(row.cells || []).map((cell) => escapeCell(cell.innerText)),
|
|
||||||
);
|
|
||||||
if (rows.length === 0 || rows.every((row) => row.length === 0)) {
|
|
||||||
return "";
|
|
||||||
}
|
|
||||||
const width = Math.max(...rows.map((row) => row.length));
|
|
||||||
const normalized = rows.map((row) => {
|
|
||||||
const next = row.slice();
|
|
||||||
while (next.length < width) next.push("");
|
|
||||||
return next;
|
|
||||||
});
|
|
||||||
const header = normalized[0];
|
|
||||||
const divider = Array.from({ length: width }, () => "---");
|
|
||||||
const body = normalized.slice(1);
|
|
||||||
return [
|
|
||||||
`### Table ${index + 1}`,
|
|
||||||
"",
|
|
||||||
`| ${header.join(" | ")} |`,
|
|
||||||
`| ${divider.join(" | ")} |`,
|
|
||||||
...body.map((row) => `| ${row.join(" | ")} |`),
|
|
||||||
].join("\n");
|
|
||||||
}
|
|
||||||
|
|
||||||
const clone = document.body ? document.body.cloneNode(true) : null;
|
|
||||||
if (clone) {
|
|
||||||
clone.querySelectorAll("script, style, noscript, svg, canvas, iframe").forEach((node) => node.remove());
|
|
||||||
}
|
|
||||||
|
|
||||||
const title = document.title || "";
|
|
||||||
const url = location.href;
|
|
||||||
const description = document.querySelector('meta[name="description"]')?.getAttribute("content") || "";
|
|
||||||
const main = clone?.querySelector("article, main, [role='main']") || clone;
|
|
||||||
const text = cleanText(main?.innerText || document.body?.innerText || "");
|
|
||||||
const tables = Array.from(document.querySelectorAll("table"))
|
|
||||||
.map((table, index) => tableToMarkdown(table, index))
|
|
||||||
.filter(Boolean);
|
|
||||||
|
|
||||||
const parts = [];
|
|
||||||
if (description.trim()) {
|
|
||||||
parts.push(`## Meta Description\n\n${cleanText(description)}`);
|
|
||||||
}
|
|
||||||
if (text) {
|
|
||||||
parts.push(`## Page Text\n\n${text}`);
|
|
||||||
}
|
|
||||||
if (tables.length > 0) {
|
|
||||||
parts.push(`## Tables\n\n${tables.join("\n\n")}`);
|
|
||||||
}
|
|
||||||
|
|
||||||
let content = parts.join("\n\n");
|
|
||||||
if (content.length > maxLocalChars) {
|
|
||||||
content = `${content.slice(0, maxLocalChars)}\n\n[Truncated locally by zncm Web Clipper]`;
|
|
||||||
}
|
|
||||||
|
|
||||||
return { title, url, content, contentType: "markdown" };
|
|
||||||
}
|
|
||||||
|
|
||||||
// Injected into the page to build an indexed list of interactive elements plus
|
|
||||||
// the visible page text. Each interactive element is tagged with
|
|
||||||
// `data-deer-index` so a follow-up deerPerformAction call can find it by index.
|
|
||||||
function deerObservePage(maxElements) {
|
|
||||||
const limit = Math.max(10, Number(maxElements || 150));
|
|
||||||
const DEER_ATTR = "data-deer-index";
|
|
||||||
|
|
||||||
document.querySelectorAll(`[${DEER_ATTR}]`).forEach((node) => node.removeAttribute(DEER_ATTR));
|
|
||||||
|
|
||||||
function isVisible(el) {
|
|
||||||
if (!(el instanceof Element)) return false;
|
|
||||||
const rect = el.getBoundingClientRect();
|
|
||||||
if (rect.width <= 1 && rect.height <= 1) return false;
|
|
||||||
const style = window.getComputedStyle(el);
|
|
||||||
if (style.visibility === "hidden" || style.display === "none" || style.opacity === "0") return false;
|
|
||||||
if (el.disabled) return false;
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
|
|
||||||
function labelFor(el) {
|
|
||||||
const aria = el.getAttribute("aria-label");
|
|
||||||
if (aria && aria.trim()) return aria.trim();
|
|
||||||
const placeholder = el.getAttribute("placeholder");
|
|
||||||
const title = el.getAttribute("title");
|
|
||||||
const name = el.getAttribute("name");
|
|
||||||
const text = (el.innerText || el.textContent || "").trim();
|
|
||||||
if (text) return text.replace(/\s+/g, " ");
|
|
||||||
if (placeholder && placeholder.trim()) return placeholder.trim();
|
|
||||||
if (title && title.trim()) return title.trim();
|
|
||||||
if (el.value && String(el.value).trim()) return String(el.value).trim();
|
|
||||||
if (name && name.trim()) return name.trim();
|
|
||||||
const alt = el.querySelector?.("img[alt]")?.getAttribute("alt");
|
|
||||||
if (alt && alt.trim()) return alt.trim();
|
|
||||||
return "";
|
|
||||||
}
|
|
||||||
|
|
||||||
const selector = [
|
|
||||||
"a[href]",
|
|
||||||
"button",
|
|
||||||
"input:not([type=hidden])",
|
|
||||||
"select",
|
|
||||||
"textarea",
|
|
||||||
"[role=button]",
|
|
||||||
"[role=link]",
|
|
||||||
"[role=tab]",
|
|
||||||
"[role=menuitem]",
|
|
||||||
"[role=checkbox]",
|
|
||||||
"[role=radio]",
|
|
||||||
"[role=switch]",
|
|
||||||
"[contenteditable=true]",
|
|
||||||
"[onclick]",
|
|
||||||
].join(",");
|
|
||||||
|
|
||||||
const seen = new Set();
|
|
||||||
const elements = [];
|
|
||||||
let index = 0;
|
|
||||||
for (const el of document.querySelectorAll(selector)) {
|
|
||||||
if (index >= limit) break;
|
|
||||||
if (seen.has(el) || !isVisible(el)) continue;
|
|
||||||
seen.add(el);
|
|
||||||
el.setAttribute(DEER_ATTR, String(index));
|
|
||||||
const tag = el.tagName.toLowerCase();
|
|
||||||
let label = labelFor(el);
|
|
||||||
if (label.length > 200) label = label.slice(0, 200);
|
|
||||||
const entry = { index, tag, label };
|
|
||||||
const type = el.getAttribute("type") || el.getAttribute("role");
|
|
||||||
if (type) entry.type = type;
|
|
||||||
if (tag === "input" || tag === "textarea" || tag === "select") {
|
|
||||||
const value = String(el.value || "");
|
|
||||||
if (value) entry.value = value.slice(0, 80);
|
|
||||||
}
|
|
||||||
if (tag === "a") {
|
|
||||||
const href = el.getAttribute("href") || "";
|
|
||||||
if (href) entry.href = href.slice(0, 200);
|
|
||||||
}
|
|
||||||
elements.push(entry);
|
|
||||||
index += 1;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Inline text extraction so this function stays self-contained when injected
|
|
||||||
// via chrome.scripting.executeScript (no dependency on other content-script fns).
|
|
||||||
let text = "";
|
|
||||||
try {
|
|
||||||
const clone = document.body ? document.body.cloneNode(true) : null;
|
|
||||||
if (clone) {
|
|
||||||
clone.querySelectorAll(`script, style, noscript, svg, canvas, iframe, [${DEER_ATTR}-skip]`).forEach((node) => node.remove());
|
|
||||||
}
|
|
||||||
const main = clone?.querySelector("article, main, [role='main']") || clone;
|
|
||||||
text = String(main?.innerText || document.body?.innerText || "")
|
|
||||||
.replace(/\s+\n/g, "\n")
|
|
||||||
.replace(/\n{3,}/g, "\n\n")
|
|
||||||
.trim();
|
|
||||||
} catch {
|
|
||||||
text = "";
|
|
||||||
}
|
|
||||||
|
|
||||||
return {
|
|
||||||
url: location.href,
|
|
||||||
title: document.title || "",
|
|
||||||
elements,
|
|
||||||
text,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
// Injected into the page to perform a single action on the element previously
|
|
||||||
// tagged by deerObservePage (by index). Returns {status, message}.
|
|
||||||
async function deerPerformAction(action) {
|
|
||||||
const DEER_ATTR = "data-deer-index";
|
|
||||||
const type = String(action?.type || "").toLowerCase();
|
|
||||||
|
|
||||||
function findByIndex(idx) {
|
|
||||||
if (idx === undefined || idx === null || idx < 0) return null;
|
|
||||||
return document.querySelector(`[${DEER_ATTR}="${idx}"]`);
|
|
||||||
}
|
|
||||||
|
|
||||||
function fireInput(el, value) {
|
|
||||||
const proto = el instanceof HTMLTextAreaElement ? HTMLTextAreaElement.prototype : HTMLInputElement.prototype;
|
|
||||||
const setter = Object.getOwnPropertyDescriptor(proto, "value")?.set;
|
|
||||||
if (setter) {
|
|
||||||
setter.call(el, value);
|
|
||||||
} else {
|
|
||||||
el.value = value;
|
|
||||||
}
|
|
||||||
el.dispatchEvent(new Event("input", { bubbles: true }));
|
|
||||||
el.dispatchEvent(new Event("change", { bubbles: true }));
|
|
||||||
}
|
|
||||||
|
|
||||||
try {
|
|
||||||
if (type === "observe" || type === "extract") {
|
|
||||||
return { status: "ok", message: type === "extract" ? "Page text re-read." : "Observed page." };
|
|
||||||
}
|
|
||||||
|
|
||||||
if (type === "scroll") {
|
|
||||||
const el = findByIndex(action.index);
|
|
||||||
if (el) {
|
|
||||||
el.scrollIntoView({ block: "center", behavior: "instant" });
|
|
||||||
return { status: "ok", message: "Scrolled element into view." };
|
|
||||||
}
|
|
||||||
window.scrollBy(0, Math.round(window.innerHeight * 0.85));
|
|
||||||
return { status: "ok", message: "Scrolled down one viewport." };
|
|
||||||
}
|
|
||||||
|
|
||||||
if (type === "wait") {
|
|
||||||
const selector = String(action.wait_for || "").trim();
|
|
||||||
const timeoutMs = Math.max(500, Number(action.timeout_ms || 8000));
|
|
||||||
if (!selector) {
|
|
||||||
await new Promise((resolve) => setTimeout(resolve, Math.min(timeoutMs, 3000)));
|
|
||||||
return { status: "ok", message: "Waited." };
|
|
||||||
}
|
|
||||||
const start = Date.now();
|
|
||||||
while (Date.now() - start < timeoutMs) {
|
|
||||||
if (document.querySelector(selector)) {
|
|
||||||
return { status: "ok", message: `Element ${selector} appeared.` };
|
|
||||||
}
|
|
||||||
await new Promise((resolve) => setTimeout(resolve, 200));
|
|
||||||
}
|
|
||||||
return { status: "timeout", message: `Element ${selector} did not appear within ${timeoutMs}ms.` };
|
|
||||||
}
|
|
||||||
|
|
||||||
if (type === "click") {
|
|
||||||
const el = findByIndex(action.index);
|
|
||||||
if (!el) return { status: "error", message: `No element with index ${action.index}. Re-observe the page.` };
|
|
||||||
el.scrollIntoView({ block: "center", behavior: "instant" });
|
|
||||||
if (typeof el.focus === "function") el.focus();
|
|
||||||
el.click();
|
|
||||||
return { status: "ok", message: `Clicked element ${action.index}.` };
|
|
||||||
}
|
|
||||||
|
|
||||||
if (type === "type") {
|
|
||||||
const el = findByIndex(action.index);
|
|
||||||
if (!el) return { status: "error", message: `No element with index ${action.index}. Re-observe the page.` };
|
|
||||||
el.scrollIntoView({ block: "center", behavior: "instant" });
|
|
||||||
if (typeof el.focus === "function") el.focus();
|
|
||||||
const value = String(action.text ?? "");
|
|
||||||
if (el.isContentEditable) {
|
|
||||||
el.textContent = value;
|
|
||||||
el.dispatchEvent(new Event("input", { bubbles: true }));
|
|
||||||
} else {
|
|
||||||
fireInput(el, value);
|
|
||||||
}
|
|
||||||
if (action.submit) {
|
|
||||||
const enterInit = { bubbles: true, cancelable: true, key: "Enter", code: "Enter", keyCode: 13, which: 13 };
|
|
||||||
el.dispatchEvent(new KeyboardEvent("keydown", enterInit));
|
|
||||||
el.dispatchEvent(new KeyboardEvent("keyup", enterInit));
|
|
||||||
const form = el.form || el.closest("form");
|
|
||||||
if (form && typeof form.requestSubmit === "function") {
|
|
||||||
try {
|
|
||||||
form.requestSubmit();
|
|
||||||
} catch {
|
|
||||||
form.submit?.();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return { status: "ok", message: `Typed into element ${action.index}${action.submit ? " and submitted" : ""}.` };
|
|
||||||
}
|
|
||||||
|
|
||||||
return { status: "error", message: `Unsupported action type: ${type}` };
|
|
||||||
} catch (error) {
|
|
||||||
return { status: "error", message: error instanceof Error ? error.message : String(error) };
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,96 +0,0 @@
|
|||||||
* {
|
|
||||||
box-sizing: border-box;
|
|
||||||
}
|
|
||||||
|
|
||||||
body {
|
|
||||||
margin: 0;
|
|
||||||
color: #171717;
|
|
||||||
background: #fafafa;
|
|
||||||
font: 14px/1.5 system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
|
|
||||||
}
|
|
||||||
|
|
||||||
h1 {
|
|
||||||
margin: 0 0 14px;
|
|
||||||
font-size: 16px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.popup,
|
|
||||||
.options {
|
|
||||||
display: grid;
|
|
||||||
gap: 12px;
|
|
||||||
padding: 14px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.popup {
|
|
||||||
width: 340px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.options {
|
|
||||||
max-width: 720px;
|
|
||||||
}
|
|
||||||
|
|
||||||
label {
|
|
||||||
display: grid;
|
|
||||||
gap: 6px;
|
|
||||||
font-weight: 600;
|
|
||||||
}
|
|
||||||
|
|
||||||
label.checkbox {
|
|
||||||
grid-template-columns: auto 1fr;
|
|
||||||
align-items: center;
|
|
||||||
font-weight: 500;
|
|
||||||
}
|
|
||||||
|
|
||||||
label.checkbox input {
|
|
||||||
width: auto;
|
|
||||||
}
|
|
||||||
|
|
||||||
.actions {
|
|
||||||
display: flex;
|
|
||||||
flex-wrap: wrap;
|
|
||||||
gap: 8px;
|
|
||||||
}
|
|
||||||
|
|
||||||
input,
|
|
||||||
textarea {
|
|
||||||
width: 100%;
|
|
||||||
border: 1px solid #d4d4d4;
|
|
||||||
border-radius: 6px;
|
|
||||||
padding: 8px;
|
|
||||||
background: #fff;
|
|
||||||
color: inherit;
|
|
||||||
font: inherit;
|
|
||||||
font-weight: 400;
|
|
||||||
}
|
|
||||||
|
|
||||||
textarea {
|
|
||||||
resize: vertical;
|
|
||||||
}
|
|
||||||
|
|
||||||
button {
|
|
||||||
border: 0;
|
|
||||||
border-radius: 6px;
|
|
||||||
padding: 9px 12px;
|
|
||||||
background: #111827;
|
|
||||||
color: #fff;
|
|
||||||
cursor: pointer;
|
|
||||||
font: inherit;
|
|
||||||
font-weight: 600;
|
|
||||||
}
|
|
||||||
|
|
||||||
button.secondary {
|
|
||||||
background: #e5e7eb;
|
|
||||||
color: #111827;
|
|
||||||
}
|
|
||||||
|
|
||||||
button:disabled {
|
|
||||||
cursor: not-allowed;
|
|
||||||
opacity: 0.6;
|
|
||||||
}
|
|
||||||
|
|
||||||
.status {
|
|
||||||
min-height: 20px;
|
|
||||||
margin: 0;
|
|
||||||
color: #525252;
|
|
||||||
white-space: pre-wrap;
|
|
||||||
}
|
|
||||||
@@ -1,139 +0,0 @@
|
|||||||
# Iframe Chat Page Implementation Plan
|
|
||||||
|
|
||||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
|
||||||
|
|
||||||
**Goal:** Add a standalone `/page/workspace/chats_iframe/*` chat page that reuses the existing thread system and history, while showing only `你好` and no input box before the first user message.
|
|
||||||
|
|
||||||
**Architecture:** Keep the existing workspace shell and chat runtime intact, then add a new route pair and a copied page component dedicated to the iframe path. The new page keeps the original chat behavior once a thread already has messages, but it owns its empty-state rendering and URL transition to `/page/workspace/chats_iframe/:thread_id`.
|
|
||||||
|
|
||||||
**Tech Stack:** React, TypeScript, React Router, Next navigation shim, existing LangGraph thread hooks
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Task 1: Add the iframe chat routes
|
|
||||||
|
|
||||||
**Files:**
|
|
||||||
- Modify: `frontend-web/src/pages/WorkspaceRoutes.tsx`
|
|
||||||
|
|
||||||
- [ ] **Step 1: Add `chats_iframe/new` and `chats_iframe/:thread_id` routes that render the new page inside the existing workspace layout and chat runtime**
|
|
||||||
|
|
||||||
```tsx
|
|
||||||
<Route
|
|
||||||
path="chats_iframe/new"
|
|
||||||
element={
|
|
||||||
<WorkspaceLayout {...layoutProps}>
|
|
||||||
<ChatRuntime>
|
|
||||||
<IframeChatPage />
|
|
||||||
</ChatRuntime>
|
|
||||||
</WorkspaceLayout>
|
|
||||||
}
|
|
||||||
/>
|
|
||||||
<Route
|
|
||||||
path="chats_iframe/:thread_id"
|
|
||||||
element={
|
|
||||||
<WorkspaceLayout {...layoutProps}>
|
|
||||||
<ChatRuntime>
|
|
||||||
<IframeChatPage />
|
|
||||||
</ChatRuntime>
|
|
||||||
</WorkspaceLayout>
|
|
||||||
}
|
|
||||||
/>
|
|
||||||
```
|
|
||||||
|
|
||||||
- [ ] **Step 2: Ensure the new route imports compile cleanly**
|
|
||||||
|
|
||||||
Run: `rg -n "IframeChatPage|chats_iframe" frontend-web/src/pages/WorkspaceRoutes.tsx`
|
|
||||||
Expected: `WorkspaceRoutes.tsx` contains one import for `IframeChatPage` and both `chats_iframe` route entries.
|
|
||||||
|
|
||||||
### Task 2: Add a standalone iframe chat page
|
|
||||||
|
|
||||||
**Files:**
|
|
||||||
- Create: `frontend-web/src/pages/IframeChatPage.tsx`
|
|
||||||
- Reference: `frontend-web/src/pages/ChatPage.tsx`
|
|
||||||
|
|
||||||
- [ ] **Step 1: Copy the current `ChatPage` implementation into `IframeChatPage` and preserve the existing chat runtime integration**
|
|
||||||
|
|
||||||
```tsx
|
|
||||||
export default function IframeChatPage() {
|
|
||||||
const routeBase = useRouteBase();
|
|
||||||
const router = useRouter();
|
|
||||||
const [showFollowups, setShowFollowups] = useState(false);
|
|
||||||
const [hasStartedConversation, setHasStartedConversation] = useState(false);
|
|
||||||
const { threadId, setThreadId, isNewThread, setIsNewThread, isMock } =
|
|
||||||
useThreadChat();
|
|
||||||
// keep the rest of the existing chat hooks and handlers aligned with ChatPage
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
- [ ] **Step 2: Change the thread creation URL replacement to stay on the iframe route family**
|
|
||||||
|
|
||||||
```tsx
|
|
||||||
onStart: (createdThreadId) => {
|
|
||||||
setThreadId(createdThreadId);
|
|
||||||
setIsNewThread(false);
|
|
||||||
history.replaceState(
|
|
||||||
null,
|
|
||||||
"",
|
|
||||||
`${window.location.pathname}${window.location.search}#${routeBase}/chats_iframe/${createdThreadId}`,
|
|
||||||
);
|
|
||||||
},
|
|
||||||
```
|
|
||||||
|
|
||||||
- [ ] **Step 3: Replace the default landing state with a simple `你好` view and do not render the input box while the iframe page is still a brand-new untouched chat**
|
|
||||||
|
|
||||||
```tsx
|
|
||||||
{isLandingState && mounted ? (
|
|
||||||
<div className="flex min-h-[240px] items-center justify-center">
|
|
||||||
<div className="text-2xl font-medium">你好</div>
|
|
||||||
</div>
|
|
||||||
) : null}
|
|
||||||
{!isLandingState &&
|
|
||||||
(mounted ? (
|
|
||||||
<div className="w-full -translate-y-4">
|
|
||||||
<InputBox
|
|
||||||
className="w-full"
|
|
||||||
isNewThread={false}
|
|
||||||
threadId={threadId}
|
|
||||||
autoFocus={false}
|
|
||||||
status={thread.error ? "error" : thread.isLoading ? "streaming" : "ready"}
|
|
||||||
context={settings.context}
|
|
||||||
disabled={env.NEXT_PUBLIC_STATIC_WEBSITE_ONLY === "true" || isUploading}
|
|
||||||
onContextChange={(context) => setSettings("context", context)}
|
|
||||||
promptPrefix={promptPrefixProp}
|
|
||||||
onFollowupsVisibilityChange={setShowFollowups}
|
|
||||||
onSubmit={handleSubmit}
|
|
||||||
onStop={handleStop}
|
|
||||||
/>
|
|
||||||
</div>
|
|
||||||
) : (
|
|
||||||
<div aria-hidden="true" className="bg-background/5 h-32 w-full -translate-y-4 rounded-3xl border" />
|
|
||||||
))}
|
|
||||||
```
|
|
||||||
|
|
||||||
- [ ] **Step 4: Keep message rendering, thread title, export, token usage, todos, artifact triggers, and all post-first-message behavior identical to the original page**
|
|
||||||
|
|
||||||
Run: `rg -n "MessageList|ThreadTitle|ArtifactTrigger|TokenUsageIndicator|TodoList" frontend-web/src/pages/IframeChatPage.tsx`
|
|
||||||
Expected: The new page still renders the same core chat primitives used by `ChatPage`.
|
|
||||||
|
|
||||||
### Task 3: Verify the new page compiles
|
|
||||||
|
|
||||||
**Files:**
|
|
||||||
- Test: `frontend-web/src/pages/IframeChatPage.tsx`
|
|
||||||
- Test: `frontend-web/src/pages/WorkspaceRoutes.tsx`
|
|
||||||
|
|
||||||
- [ ] **Step 1: Run the frontend build**
|
|
||||||
|
|
||||||
Run: `cmd /c npm run build`
|
|
||||||
Expected: Build succeeds without TypeScript or bundling errors related to `IframeChatPage` or `chats_iframe`.
|
|
||||||
|
|
||||||
- [ ] **Step 2: Spot-check the changed routes in the built source**
|
|
||||||
|
|
||||||
Run: `rg -n "chats_iframe" frontend-web/src/pages`
|
|
||||||
Expected: Matches appear in `WorkspaceRoutes.tsx` and `IframeChatPage.tsx`.
|
|
||||||
|
|
||||||
- [ ] **Step 3: Commit after verification**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git add docs/superpowers/plans/2026-06-01-iframe-chat-page.md frontend-web/src/pages/WorkspaceRoutes.tsx frontend-web/src/pages/IframeChatPage.tsx
|
|
||||||
git commit -m "feat: add iframe chat page routes"
|
|
||||||
```
|
|
||||||
@@ -1,56 +0,0 @@
|
|||||||
# 本地开发（pnpm dev）— 与原先 .env 保持一致
|
|
||||||
# 个人覆盖请新建 .env.development.local（已 gitignore，优先级更高）
|
|
||||||
|
|
||||||
# 任务看板数据源：true=真实接口（默认）；改成 false 可让任务分析/三情分析两页走本地假数据。
|
|
||||||
VITE_USE_REAL_DATA=true
|
|
||||||
|
|
||||||
# 任务详情（登录深链 cop-task-detail）数据源：默认真实接口；改成 true 走本地假数据（consumer 外网不可达时调试用）。
|
|
||||||
VITE_MOCK_COP_TASK_DETAIL=true
|
|
||||||
|
|
||||||
# 研判情报报告（大屏绘制智能体深链 selectSqReport）数据源：true 走本地样例假数据（真实接口未就绪时调试用）；联调通过后置 false。
|
|
||||||
VITE_MOCK_SQ_REPORT=true
|
|
||||||
|
|
||||||
# 深链任务详情（cop-task-detail：任务名称/描述）数据源：true 走本地假数据（真实接口未就绪时调试用）；联调通过后置 false。
|
|
||||||
VITE_MOCK_COP_TASK_DETAIL=true
|
|
||||||
|
|
||||||
# Gateway / DeerFlow API
|
|
||||||
VITE_BACKEND_BASE_URL=http://127.0.0.1:8001
|
|
||||||
VITE_LANGGRAPH_BASE_URL=http://127.0.0.1:8001/api
|
|
||||||
|
|
||||||
# 轻应用「新建笔记」系列接口
|
|
||||||
VITE_NOTE_API_BASE_URL=http://47.88.25.99:8000
|
|
||||||
# CMZS后端接口
|
|
||||||
VITE_API_BASE_URL=https://ch1.b.uat.4.cn/zncm
|
|
||||||
# 佳来模型对话接口
|
|
||||||
VITE_AIPI_CHAT_URL=https://ch1.b.uat.4.cn/gpt
|
|
||||||
# 多轮检索接口
|
|
||||||
VITE_AIPI_GENERATE_CHAT_URL=https://ch1.b.uat.4.cn/jialai_b1_chat
|
|
||||||
VITE_AIPI_TASK_CHAT_URL=https://ch1.b.uat.4.cn/qq_b1_chat
|
|
||||||
VITE_AIPI_KNOWLEDGE_URL=https://chlib.b.uat.4.cn/knowlibrary
|
|
||||||
VITE_AIPI_B1COH_URL=https://ch1.b.uat.4.cn/web
|
|
||||||
VITE_AIPI_B2ACTOR_URL=https://ty.b.uat.4.cn
|
|
||||||
VITE_AIPI_B2ACTOR_XWT_PATH=/fromB/toXWT?isFrame=1
|
|
||||||
VITE_AIPI_KNOWLEDGE_IFRAME_API_URL=https://ch1.b.uat.4.cn/knowes/api/iframeKnowledgeUrl
|
|
||||||
VITE_AIPI_KNOWLEDGE_IFRAME_SKIN=red
|
|
||||||
VITE_AIPI_B2ACTOR_XWT_PATH=/fromB/toXWT?isFrame=1
|
|
||||||
VITE_AIPI_KNOWLEDGE_IFRAME_API_URL=https://ch1.b.uat.4.cn/knowes/api/iframeKnowledgeUrl
|
|
||||||
VITE_AIPI_KNOWLEDGE_IFRAME_SKIN=red
|
|
||||||
VITE_AIPI_MOPECHAT_URL=https://ch1.b.uat.4.cn/likun_b1_mope
|
|
||||||
VITE_AIPI_BACKENP_URL=http://47.88.25.99:8000
|
|
||||||
# 工作室/空间后端接口（侧边栏“工作室”列表、空间详情等都走这里，不是 VITE_NOTE_API_BASE_URL）
|
|
||||||
# 工作室/空间前端地址（用于 auth/callback 等跳转）
|
|
||||||
# VITE_AIPI_FRONTEND_URL=https://knowledgetoolserver.b.uat.4.cn
|
|
||||||
VITE_AIPI_FRONTEND_URL=http://localhost:3000
|
|
||||||
VITE_AIPI_CONSUMER_URL=https://ch1.b.uat.4.cn/consumer
|
|
||||||
# A 系统跳转地址（人物/组织/事件等列表项打开链接）
|
|
||||||
VITE_AIPI_PRESENT_URL=https://present.a.uat.4.cn/present/domain
|
|
||||||
# B 系统知识库 iframe 根地址
|
|
||||||
VITE_AIPI_KNOWES_URL=https://ch1.b.uat.4.cn/knowes
|
|
||||||
|
|
||||||
# MaxKey 鉴权（getTokenByOnlineTicket）
|
|
||||||
VITE_AUTH_BASE_URL=https://auth.y.sit.4.cn
|
|
||||||
VITE_AIPI_PGLINKTO_URL=https://pg.b.uat.4.cn
|
|
||||||
VITE_AIPI_XKLINKTO_URL=https://kz.b.uat.4.cn
|
|
||||||
# 可选：Canvas 独立 LangGraph 地址（不设则回退到 VITE_LANGGRAPH_BASE_URL）
|
|
||||||
# VITE_CANVAS_LANGGRAPH_BASE_URL=
|
|
||||||
|
|
||||||
@@ -1,31 +0,0 @@
|
|||||||
# 复制为 .env.development.local，仅本机生效，不提交 Git
|
|
||||||
# 直连本机 Gateway（需后端 CORS_ORIGINS 包含 http://127.0.0.1:5173 等）
|
|
||||||
|
|
||||||
VITE_BACKEND_BASE_URL=http://127.0.0.1:8001
|
|
||||||
VITE_LANGGRAPH_BASE_URL=http://127.0.0.1:8001/api
|
|
||||||
# 佳来模型对话接口
|
|
||||||
VITE_AIPI_CHAT_URL=https://ch1.b.uat.4.cn/gpt
|
|
||||||
# 多轮检索接口
|
|
||||||
VITE_AIPI_GENERATE_CHAT_URL=https://ch1.b.uat.4.cn/jialai_b1_chat
|
|
||||||
VITE_AIPI_TASK_CHAT_URL=https://ch1.b.uat.4.cn/qq_b1_chat
|
|
||||||
VITE_AIPI_KNOWLEDGE_URL=https://chlib.b.uat.4.cn/knowlibrary
|
|
||||||
VITE_AIPI_B1COH_URL=https://ch1.b.uat.4.cn/web
|
|
||||||
VITE_AIPI_B2ACTOR_URL=https://ty.b.uat.4.cn
|
|
||||||
VITE_AIPI_B2ACTOR_XWT_PATH=/fromB/toXWT?isFrame=1
|
|
||||||
VITE_AIPI_KNOWLEDGE_IFRAME_API_URL=https://ch1.b.uat.4.cn/knowes/api/iframeKnowledgeUrl
|
|
||||||
VITE_AIPI_KNOWLEDGE_IFRAME_SKIN=red
|
|
||||||
VITE_AIPI_MOPECHAT_URL=https://ch1.b.uat.4.cn/likun_b1_mope
|
|
||||||
# 工作室/空间后端接口（侧边栏“工作室”列表、空间详情等都走这里，不是 VITE_NOTE_API_BASE_URL）
|
|
||||||
VITE_AIPI_BACKENP_URL=https://knowledgetoolserver.b.uat.4.cn
|
|
||||||
# 工作室/空间前端地址（用于 auth/callback 等跳转）
|
|
||||||
VITE_AIPI_FRONTEND_URL=https://knowledgetoolserver.b.uat.4.cn
|
|
||||||
VITE_AIPI_CONSUMER_URL=https://ch1.b.uat.4.cn/consumer
|
|
||||||
# A 系统跳转地址（人物/组织/事件等列表项打开链接）
|
|
||||||
VITE_AIPI_PRESENT_URL=http://present.a.uat.4.cn/present/domain
|
|
||||||
# B 系统知识库 iframe 根地址
|
|
||||||
VITE_AIPI_KNOWES_URL=http://ch1.b.uat.4.cn/knowes
|
|
||||||
VITE_AUTH_BASE_URL=https://auth.y.sit.4.cn
|
|
||||||
VITE_AIPI_PGLINKTO_URL=https://pg.b.uat.4.cn
|
|
||||||
VITE_AIPI_XKLINKTO_URL=https://kz.b.uat.4.cn
|
|
||||||
|
|
||||||
# VITE_NOTE_API_BASE_URL=http://127.0.0.1:8000
|
|
||||||
@@ -1,59 +0,0 @@
|
|||||||
# 环境变量说明（Vite 仅暴露以 VITE_ 开头的变量）
|
|
||||||
#
|
|
||||||
# ┌─────────────────┬──────────────────────────────────────────────────┐
|
|
||||||
# │ 命令 │ 生效文件 │
|
|
||||||
# ├─────────────────┼──────────────────────────────────────────────────┤
|
|
||||||
# │ pnpm dev │ .env.development + .env.development.local │
|
|
||||||
# │ pnpm build │ .env.production + .env.production.local │
|
|
||||||
# │ pnpm build:network │ .env.network + .env.network.local（内网地址） │
|
|
||||||
# │ scripts/start-* │ 脚本注入的环境变量会覆盖上述文件（见下方说明） │
|
|
||||||
# └─────────────────┴──────────────────────────────────────────────────┘
|
|
||||||
#
|
|
||||||
# 推荐：
|
|
||||||
# - 日常本地开发：改 .env.development（已提交，团队默认 UAT 地址）
|
|
||||||
# - 本机连 127.0.0.1:8001：复制 .env.development.local.example → .env.development.local
|
|
||||||
# - 内网打包部署：改 .env.network 后执行 pnpm build:network（或改 .env.production 后 pnpm build）
|
|
||||||
#
|
|
||||||
# 若浏览器直连后端报 CORS，请在 Gateway 配置 GATEWAY_CORS_ORIGINS，包含前端源站；无界嵌入时还要加宿主源站，例如：
|
|
||||||
# GATEWAY_CORS_ORIGINS=http://127.0.0.1:5174,http://localhost:5174,http://127.0.0.1:5183,http://localhost:5183
|
|
||||||
|
|
||||||
# --- 开发环境（见 .env.development）---
|
|
||||||
# VITE_BACKEND_BASE_URL=https://ch1.b.uat.4.cn/deerflow
|
|
||||||
# VITE_LANGGRAPH_BASE_URL=https://ch1.b.uat.4.cn/deerflow/api
|
|
||||||
# VITE_NOTE_API_BASE_URL=http://47.88.25.99:8000
|
|
||||||
# VITE_AIPI_BACKENP_URL=https://knowledgetoolserver.b.uat.4.cn
|
|
||||||
# VITE_AIPI_FRONTEND_URL=https://knowledgetoolserver.b.uat.4.cn
|
|
||||||
|
|
||||||
# --- 生产打包（见 .env.production）---
|
|
||||||
# 部署前修改 .env.production 中的地址，再执行 pnpm build
|
|
||||||
|
|
||||||
# --- 任务看板（任务分析 / 三情分析）数据源开关 ---
|
|
||||||
# true=走真实接口；false 或未设=这两页使用本地假数据（演示用，无需后端）。
|
|
||||||
# .env.development / .env.production / .env.network / .env.sit 均默认 true（真实数据），
|
|
||||||
# 仅本机 .env 默认 false（假数据）。改后需重启 dev / 重新打包生效。
|
|
||||||
# VITE_USE_REAL_DATA=true
|
|
||||||
|
|
||||||
# --- 任务详情（登录深链 cop-task-detail）数据源开关 ---
|
|
||||||
# 默认真实接口（未设/false）；改成 true 时该接口走本地假数据（consumer 外网不可达时调试用）。
|
|
||||||
# 与 VITE_USE_REAL_DATA 独立。改后需重启 dev / 重新打包生效。
|
|
||||||
# VITE_MOCK_COP_TASK_DETAIL=false
|
|
||||||
# VITE_POSITION_ROUNDTABLE_DEMO_MODE=false
|
|
||||||
# true=免登录直达岗位分析，完全使用前端 JSON，不请求任何后台接口。
|
|
||||||
# 仅限离线演示环境；生产环境请保持 false。
|
|
||||||
# VITE_POSITION_ROUNDTABLE_STANDALONE_MODE=false
|
|
||||||
|
|
||||||
# MaxKey 鉴权根地址（无界 onlineTicket 换 token）
|
|
||||||
# VITE_AUTH_BASE_URL=https://auth.y.sit.4.cn
|
|
||||||
# VITE_AIPI_CONSUMER_URL=https://ch1.b.uat.4.cn/consumer
|
|
||||||
|
|
||||||
# VITE_AIPI_B2ACTOR_URL=https://ty.b.uat.4.cn
|
|
||||||
# VITE_AIPI_B2ACTOR_XWT_PATH=/fromB/toXWT?isFrame=1
|
|
||||||
# VITE_AIPI_KNOWLEDGE_IFRAME_API_URL=https://ch1.b.uat.4.cn/knowes/api/iframeKnowledgeUrl
|
|
||||||
# VITE_AIPI_KNOWLEDGE_IFRAME_SKIN=red
|
|
||||||
|
|
||||||
# 可选
|
|
||||||
# VITE_CANVAS_LANGGRAPH_BASE_URL=
|
|
||||||
# VITE_STATIC_WEBSITE_ONLY=
|
|
||||||
# 部署级紧凑导航：true 时固定收起工作台左侧栏，并隐藏换肤与全量/简洁模式切换。
|
|
||||||
# VITE_FORCE_COLLAPSED_SIDEBAR=false
|
|
||||||
# VITE_GITHUB_OAUTH_TOKEN=
|
|
||||||
@@ -1,57 +0,0 @@
|
|||||||
# 本地开发（pnpm dev）— 与原先 .env 保持一致
|
|
||||||
# 个人覆盖请新建 .env.development.local（已 gitignore，优先级更高）
|
|
||||||
|
|
||||||
# 任务看板数据源：true=真实接口（默认）；改成 false 可让任务分析/三情分析两页走本地假数据。
|
|
||||||
VITE_USE_REAL_DATA=true
|
|
||||||
|
|
||||||
# 任务详情（登录深链 cop-task-detail）数据源：默认真实接口；改成 true 走本地假数据（调试用）。
|
|
||||||
VITE_MOCK_COP_TASK_DETAIL=false
|
|
||||||
|
|
||||||
# 研判情报报告（大屏绘制智能体深链 selectSqReport）数据源：默认真实接口；真实接口未就绪可改 true 走本地样例假数据。
|
|
||||||
VITE_MOCK_SQ_REPORT=false
|
|
||||||
|
|
||||||
# 深链任务详情（cop-task-detail）数据源：默认真实接口；真实接口未就绪可改 true 走本地假数据。
|
|
||||||
VITE_MOCK_COP_TASK_DETAIL=false
|
|
||||||
|
|
||||||
# Gateway / DeerFlow API
|
|
||||||
VITE_BACKEND_BASE_URL=http://10.19.200.5:2026
|
|
||||||
VITE_LANGGRAPH_BASE_URL=http://10.19.200.5:2026/api
|
|
||||||
|
|
||||||
# 轻应用「新建笔记」系列接口
|
|
||||||
VITE_NOTE_API_BASE_URL=http://47.88.25.99:8000
|
|
||||||
# CMZS后端接口
|
|
||||||
VITE_API_BASE_URL=https://ch1.b.uat.4.cn/zncm
|
|
||||||
# 佳来模型对话接口
|
|
||||||
VITE_AIPI_CHAT_URL=https://ch1.b.uat.4.cn/gpt
|
|
||||||
# 多轮检索接口
|
|
||||||
VITE_AIPI_GENERATE_CHAT_URL=https://ch1.b.uat.4.cn/jialai_b1_chat
|
|
||||||
VITE_AIPI_TASK_CHAT_URL=https://ch1.b.uat.4.cn/qq_b1_chat
|
|
||||||
VITE_AIPI_KNOWLEDGE_URL=https://chlib.b.uat.4.cn/knowlibrary
|
|
||||||
VITE_AIPI_B1COH_URL=https://ch1.b.uat.4.cn/web
|
|
||||||
VITE_AIPI_B2ACTOR_URL=https://ty.b.uat.4.cn
|
|
||||||
VITE_AIPI_B2ACTOR_XWT_PATH=/fromB/toXWT?isFrame=1
|
|
||||||
VITE_AIPI_KNOWLEDGE_IFRAME_API_URL=https://ch1.b.uat.4.cn/knowes/api/iframeKnowledgeUrl
|
|
||||||
VITE_AIPI_KNOWLEDGE_IFRAME_SKIN=red
|
|
||||||
VITE_AIPI_B2ACTOR_XWT_PATH=/fromB/toXWT?isFrame=1
|
|
||||||
VITE_AIPI_KNOWLEDGE_IFRAME_API_URL=https://ch1.b.uat.4.cn/knowes/api/iframeKnowledgeUrl
|
|
||||||
VITE_AIPI_KNOWLEDGE_IFRAME_SKIN=red
|
|
||||||
VITE_AIPI_MOPECHAT_URL=https://ch1.b.uat.4.cn/likun_b1_mope
|
|
||||||
VITE_AIPI_BACKENP_URL=http://47.88.25.99:8000
|
|
||||||
# 工作室/空间后端接口（侧边栏“工作室”列表、空间详情等都走这里，不是 VITE_NOTE_API_BASE_URL）
|
|
||||||
# 工作室/空间前端地址（用于 auth/callback 等跳转）
|
|
||||||
# VITE_AIPI_FRONTEND_URL=https://knowledgetoolserver.b.uat.4.cn
|
|
||||||
VITE_NOTEBOOK_API_BASE_URL=http://47.88.25.99:8000
|
|
||||||
VITE_AIPI_FRONTEND_URL=http://47.88.25.99:3000
|
|
||||||
VITE_AIPI_CONSUMER_URL=http://10.19.200.5:8002/consumer
|
|
||||||
# A 系统跳转地址（人物/组织/事件等列表项打开链接）
|
|
||||||
VITE_AIPI_PRESENT_URL=http://present.a.uat.4.cn/present/domain
|
|
||||||
# B 系统知识库 iframe 根地址
|
|
||||||
VITE_AIPI_KNOWES_URL=http://ch1.b.uat.4.cn/knowes
|
|
||||||
|
|
||||||
# MaxKey 鉴权（getTokenByOnlineTicket）
|
|
||||||
VITE_AUTH_BASE_URL=https://auth.y.sit.4.cn
|
|
||||||
VITE_AIPI_PGLINKTO_URL=https://pg.b.uat.4.cn
|
|
||||||
VITE_AIPI_XKLINKTO_URL=https://kz.b.uat.4.cn
|
|
||||||
# 可选：Canvas 独立 LangGraph 地址（不设则回退到 VITE_LANGGRAPH_BASE_URL）
|
|
||||||
# VITE_CANVAS_LANGGRAPH_BASE_URL=
|
|
||||||
|
|
||||||
@@ -1,50 +0,0 @@
|
|||||||
# 生产打包（pnpm build）— 部署前请改成实际内网/生产地址
|
|
||||||
# 打包后变量会写入 dist，运行时不可再改
|
|
||||||
|
|
||||||
# 任务看板数据源：true=真实接口（默认）；改成 false 可让任务分析/三情分析两页走本地假数据。
|
|
||||||
VITE_USE_REAL_DATA=true
|
|
||||||
|
|
||||||
# 任务详情（登录深链 cop-task-detail）数据源：默认真实接口；改成 true 走本地假数据（调试用）。
|
|
||||||
VITE_MOCK_COP_TASK_DETAIL=false
|
|
||||||
|
|
||||||
# 研判情报报告（大屏绘制智能体深链 selectSqReport）数据源：默认真实接口；真实接口未就绪可改 true 走本地样例假数据。
|
|
||||||
VITE_MOCK_SQ_REPORT=false
|
|
||||||
|
|
||||||
# Gateway / DeerFlow API
|
|
||||||
VITE_BACKEND_BASE_URL=https://ch1.b.uat.4.cn/deerflow
|
|
||||||
VITE_LANGGRAPH_BASE_URL=https://ch1.b.uat.4.cn/deerflow/api
|
|
||||||
|
|
||||||
# 轻应用「新建笔记」系列接口
|
|
||||||
VITE_NOTE_API_BASE_URL=https://your-intranet-host/note-api
|
|
||||||
# CMZS后端接口
|
|
||||||
VITE_API_BASE_URL=https://ch1.b.uat.4.cn/zncm
|
|
||||||
# 佳来模型对话接口
|
|
||||||
VITE_AIPI_CHAT_URL=https://ch1.b.uat.4.cn/gpt
|
|
||||||
# 多轮检索接口
|
|
||||||
VITE_AIPI_GENERATE_CHAT_URL=https://ch1.b.uat.4.cn/jialai_b1_chat
|
|
||||||
VITE_AIPI_TASK_CHAT_URL=https://ch1.b.uat.4.cn/qq_b1_chat
|
|
||||||
VITE_AIPI_KNOWLEDGE_URL=https://chlib.b.uat.4.cn/knowlibrary
|
|
||||||
VITE_AIPI_B1COH_URL=https://ch1.b.uat.4.cn/web
|
|
||||||
VITE_AIPI_B2ACTOR_URL=https://ty.b.uat.4.cn
|
|
||||||
VITE_AIPI_B2ACTOR_XWT_PATH=/fromB/toXWT?isFrame=1
|
|
||||||
VITE_AIPI_KNOWLEDGE_IFRAME_API_URL=https://ch1.b.uat.4.cn/knowes/api/iframeKnowledgeUrl
|
|
||||||
VITE_AIPI_KNOWLEDGE_IFRAME_SKIN=red
|
|
||||||
VITE_AIPI_MOPECHAT_URL=https://ch1.b.uat.4.cn/likun_b1_mope
|
|
||||||
# 工作室/空间后端接口（侧边栏“工作室”列表、空间详情等都走这里，不是 VITE_NOTE_API_BASE_URL）
|
|
||||||
VITE_AIPI_BACKENP_URL=https://knowledgetoolserver.b.uat.4.cn
|
|
||||||
# 我的空间前端
|
|
||||||
VITE_AIPI_FRONTEND_URL= xxx
|
|
||||||
VITE_AIPI_CONSUMER_URL=https://ch1.b.uat.4.cn/consumer
|
|
||||||
# A 系统跳转地址（人物/组织/事件等列表项打开链接）
|
|
||||||
VITE_AIPI_PRESENT_URL=https://present.a.uat.4.cn/present/domain
|
|
||||||
# B 系统知识库 iframe 根地址
|
|
||||||
VITE_AIPI_KNOWES_URL=https://ch1.b.uat.4.cn/knowes
|
|
||||||
# MaxKey 鉴权（getTokenByOnlineTicket）
|
|
||||||
VITE_AUTH_BASE_URL=https://auth.y.uat.4.cn
|
|
||||||
VITE_AIPI_PGLINKTO_URL=https://pg.b.uat.4.cn
|
|
||||||
VITE_AIPI_XKLINKTO_URL=https://kz.b.uat.4.cn
|
|
||||||
# 工作室/空间前端地址（用于 auth/callback 等跳转）
|
|
||||||
VITE_AIPI_FRONTEND_URL=https://knowledgetoolweb.b.uat.4.cn
|
|
||||||
|
|
||||||
# 可选：Canvas 独立 LangGraph 地址
|
|
||||||
# VITE_CANVAS_LANGGRAPH_BASE_URL=
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
# 复制为 .env.production.local，打包前临时覆盖生产地址（不提交 Git）
|
|
||||||
|
|
||||||
# VITE_BACKEND_BASE_URL=https://your-intranet-host/deerflow
|
|
||||||
# VITE_LANGGRAPH_BASE_URL=https://your-intranet-host/deerflow/api
|
|
||||||
# VITE_NOTE_API_BASE_URL=https://your-intranet-host/note-api
|
|
||||||
# VITE_AIPI_BACKENP_URL=https://your-notebook-backend-host
|
|
||||||
# VITE_AIPI_FRONTEND_URL=https://your-notebook-frontend-host
|
|
||||||
@@ -1,56 +0,0 @@
|
|||||||
# SIT 环境打包（pnpm build:sit / npm run build:sit）— 接口地址为 UAT 的 sit 版本
|
|
||||||
# 打包后变量会写入 dist，运行时不可再改
|
|
||||||
|
|
||||||
# 任务看板数据源：true=真实接口（默认）；改成 false 可让任务分析/三情分析两页走本地假数据。
|
|
||||||
VITE_USE_REAL_DATA=true
|
|
||||||
|
|
||||||
# 任务详情（登录深链 cop-task-detail）数据源：默认真实接口；改成 true 走本地假数据（调试用）。
|
|
||||||
VITE_MOCK_COP_TASK_DETAIL=false
|
|
||||||
|
|
||||||
# 研判情报报告（大屏绘制智能体深链 selectSqReport）数据源：默认真实接口；真实接口未就绪可改 true 走本地样例假数据。
|
|
||||||
VITE_MOCK_SQ_REPORT=false
|
|
||||||
|
|
||||||
# 深链任务详情（cop-task-detail）数据源：默认真实接口；真实接口未就绪可改 true 走本地假数据。
|
|
||||||
VITE_MOCK_COP_TASK_DETAIL=false
|
|
||||||
|
|
||||||
# Gateway / DeerFlow API
|
|
||||||
VITE_BACKEND_BASE_URL=https://ch1.b.sit.4.cn/deerflow
|
|
||||||
VITE_LANGGRAPH_BASE_URL=https://ch1.b.sit.4.cn/deerflow/api
|
|
||||||
|
|
||||||
# 轻应用「新建笔记」系列接口
|
|
||||||
VITE_NOTE_API_BASE_URL=https://your-intranet-host/note-api
|
|
||||||
# CMZS后端接口
|
|
||||||
VITE_API_BASE_URL=https://ch1.b.sit.4.cn/zncm
|
|
||||||
# 佳来模型对话接口
|
|
||||||
VITE_AIPI_CHAT_URL=https://ch1.b.sit.4.cn/gpt
|
|
||||||
# 多轮检索接口
|
|
||||||
VITE_AIPI_GENERATE_CHAT_URL=https://ch1.b.sit.4.cn/jialai_b1_chat
|
|
||||||
VITE_AIPI_TASK_CHAT_URL=https://ch1.b.sit.4.cn/qq_b1_chat
|
|
||||||
VITE_AIPI_KNOWLEDGE_URL=https://chlib.b.sit.4.cn/knowlibrary
|
|
||||||
VITE_AIPI_B1COH_URL=https://ch1.b.sit.4.cn/web
|
|
||||||
VITE_AIPI_B2ACTOR_URL=https://ty.b.sit.4.cn
|
|
||||||
VITE_AIPI_B2ACTOR_XWT_PATH=/fromB/toXWT?isFrame=1
|
|
||||||
VITE_AIPI_KNOWLEDGE_IFRAME_API_URL=https://ch1.b.sit.4.cn/knowes/api/iframeKnowledgeUrl
|
|
||||||
VITE_AIPI_KNOWLEDGE_IFRAME_SKIN=red
|
|
||||||
VITE_AIPI_MOPECHAT_URL=https://ch1.b.sit.4.cn/likun_b1_mope
|
|
||||||
# 工作室/空间后端接口（侧边栏“工作室”列表、空间详情等都走这里，不是 VITE_NOTE_API_BASE_URL）
|
|
||||||
VITE_AIPI_BACKENP_URL=https://knowledgetoolserver.b.sit.4.cn
|
|
||||||
VITE_NOTEBOOK_API_BASE_URL=https://knowledgetoolserver.b.sit.4.cn
|
|
||||||
# 工作室侧边栏显示开关；仅控制入口显示，展开内容仍依赖 notebook 接口成功返回数据
|
|
||||||
VITE_STUDIO_ENABLED=true
|
|
||||||
# 工作室/笔记本前端地址（用于 auth/callback 等跳转）
|
|
||||||
VITE_AIPI_FRONTEND_URL=https://knowledgetoolserver.b.sit.4.cn
|
|
||||||
VITE_AIPI_CONSUMER_URL=https://ch1.b.sit.4.cn/consumer
|
|
||||||
# A 系统跳转地址（人物/组织/事件等列表项打开链接）
|
|
||||||
VITE_AIPI_PRESENT_URL=http://present.a.sit.4.cn/present/domain
|
|
||||||
# B 系统知识库 iframe 根地址
|
|
||||||
VITE_AIPI_KNOWES_URL=https://ch1.b.sit.4.cn/knowes
|
|
||||||
# MaxKey 鉴权（getTokenByOnlineTicket）
|
|
||||||
VITE_AUTH_BASE_URL=https://auth.y.sit.4.cn
|
|
||||||
VITE_AIPI_PGLINKTO_URL=https://pg.b.sit.4.cn
|
|
||||||
VITE_AIPI_XKLINKTO_URL=https://kz.b.sit.4.cn
|
|
||||||
# 工作室/空间前端地址（用于 auth/callback 等跳转）
|
|
||||||
VITE_AIPI_FRONTEND_URL=https://knowledgetoolserver.b.sit.4.cn
|
|
||||||
|
|
||||||
# 可选：Canvas 独立 LangGraph 地址
|
|
||||||
# VITE_CANVAS_LANGGRAPH_BASE_URL=
|
|
||||||
@@ -1,46 +0,0 @@
|
|||||||
**Comparison target**
|
|
||||||
|
|
||||||
- Source visual truth (dark intelligent-agent list): `C:/Users/董宏凯/AppData/Local/Temp/codex-clipboard-75f6ce1c-cd70-4b8c-a80a-a3d100105c69.png`
|
|
||||||
- Additional source references: `C:/Users/董宏凯/AppData/Local/Temp/codex-clipboard-00567484-ba8a-4595-b386-52e1467ae9cf.png` (segmented switch), `C:/Users/董宏凯/AppData/Local/Temp/codex-clipboard-02808803-05ba-4f2c-be50-c72b484a9f06.png` (business-chain node card), `C:/Users/董宏凯/AppData/Local/Temp/codex-clipboard-adf38fec-7baf-4d01-9c73-bdbae94b774e.png` (business-chain selector)
|
|
||||||
- Implementation screenshots: `C:/Users/董宏凯/AppData/Local/Temp/position-roundtable-revised-light.png`, `C:/Users/董宏凯/AppData/Local/Temp/position-roundtable-revised-dark.png`
|
|
||||||
- Full-view comparison evidence: `C:/Users/董宏凯/AppData/Local/Temp/position-roundtable-revised-comparison.png`
|
|
||||||
- Viewport: 1280 × 720. Light route: `#/page/strategy/qa/position-roundtable`; dark embedded route: `#/page/strategy/qa/position-roundtable?embed=1&theme=dark`.
|
|
||||||
- State: local browser has no authenticated API session. The original intent API is invoked and reports `Authentication required`; business-chain and agent endpoints return no usable data.
|
|
||||||
|
|
||||||
**Findings**
|
|
||||||
|
|
||||||
- [P1] Populated agent and business-chain states cannot be compared yet.
|
|
||||||
Location: right agent list and non-planning-role chain diagram.
|
|
||||||
Evidence: reference images show populated cards and nodes; the implementation has `0 个` agents and no available business chain in the unauthenticated preview.
|
|
||||||
Impact: card density, selected-card indicator, chain node flow, and agent-detail transition cannot be truthfully verified against live data.
|
|
||||||
Fix: verify the route in an authenticated session with at least one public chain and tagged agents.
|
|
||||||
|
|
||||||
**Open Questions**
|
|
||||||
|
|
||||||
- The final business-chain stage arrangement is still pending product confirmation. The compact graph maps whatever stage configuration is returned, while intentionally omitting dependency-label text as requested.
|
|
||||||
|
|
||||||
**Implementation Checklist**
|
|
||||||
|
|
||||||
1. Left task panel is now display-only and retains its independent position-roundtable task adapter.
|
|
||||||
2. Business-chain selection uses the original roundtable card/radio/relationship-entry pattern.
|
|
||||||
3. Every position uses the original `useStep1Intent` interface and `Step1Panel` message list/input panel; only the position header changes.
|
|
||||||
4. The right switch now uses the exact `课题研究 / ai写作` segmented-control treatment (light gray track, white active state; dark blue glass equivalent).
|
|
||||||
5. The embedded layout widens the left panel to 360px and applies the deep-blue right-panel tokens used by the reference.
|
|
||||||
6. Other roles render a taller top-to-bottom card-node flow without dependency labels. The canvas supports mouse-drag panning, and each node retains only a name plus a single-line description.
|
|
||||||
|
|
||||||
**Follow-up Polish**
|
|
||||||
|
|
||||||
- [P3] If live content is unusually long, tune the compact flow node width or horizontal scrolling after seeing the production chain data.
|
|
||||||
|
|
||||||
**Comparison history**
|
|
||||||
|
|
||||||
- Iteration 1: task fields were editable and the right TDesign card tabs looked unlike the reference. Replaced the task form with display-only information and replaced the tabs with the existing `课题研究 / ai写作` segmented switch.
|
|
||||||
- Iteration 2: business-chain selection was a dropdown and the flow was vertical avatar chips. Replaced it with original-roundtable selection cards and compact business-chain configuration-style node cards with link lines but no dependency labels.
|
|
||||||
- Iteration 3: dark right-panel background differed from the supplied deep-blue reference. Applied the `#032650` / `#042b59` / `#2b8ffe` token family and captured the revised embedded dark state in the full-view comparison.
|
|
||||||
- Iteration 4: removed the custom disabled input from non-planning positions and reused the original roundtable input panel. Enlarged the left flow viewport, retained its connection lines, and removed node level/seat/status metadata.
|
|
||||||
- Iteration 5: converted the compact flow from left-to-right to top-to-bottom. Added mouse-drag panning and single-line description truncation; populated-chain visual QA remains blocked by the unauthenticated preview.
|
|
||||||
- Iteration 6: constrained the flow canvas to its card viewport, narrowed nodes from 190px to 158px, and realigned branch gaps plus connector anchors to prevent clipping and offset lines.
|
|
||||||
|
|
||||||
**Final result**
|
|
||||||
|
|
||||||
blocked
|
|
||||||
@@ -1,253 +0,0 @@
|
|||||||
# AI 写作「四阶段内置智能体化」改造方案
|
|
||||||
|
|
||||||
> 目标：把 AI 写作现有的 **素材收集专家 / 写作大纲 / 作家写作 / 编辑审核** 四个功能，
|
|
||||||
> 从「硬编码的 LangGraph 节点 + 硬编码提示词」改造为由**内置功能型智能体**驱动——
|
|
||||||
> 每个阶段对应一个可配置的内置 agent（独立人设 SOUL、可配模型、可挂技能/工具）。
|
|
||||||
|
|
||||||
本文给出现状梳理、目标设计、以及**分步可独立交付的实现计划**。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 0. 一句话结论
|
|
||||||
|
|
||||||
不推倒重来。**保留现有图的编排骨架、4 个用户干预点、流式与状态机，只把每个阶段节点的「大脑」从「硬编码 prompt 直调 LLM」替换为「加载对应内置 agent 的 SOUL+配置、在子线程上跑该 agent、按结构化契约解析其输出」。** 这样前端几乎不动，复杂逻辑（严格模式、素材不足求助、逐章流式、技能检索步骤）全部保留。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 现状梳理（精确到文件）
|
|
||||||
|
|
||||||
AI 写作是一条 LangGraph 图：`packages/harness/deerflow/agents/ai_writing/graph.py`
|
|
||||||
|
|
||||||
```
|
|
||||||
intent_parser → researcher → (pause 素材确认) → writer_outline → (pause 大纲确认)
|
|
||||||
→ writer_draft → (pause 草稿确认 / 素材不足求助) → editor → (pause 编辑打回) → done
|
|
||||||
```
|
|
||||||
|
|
||||||
四个待改造阶段（均为**硬编码节点**，直接调 LLM、不走 agent 运行时）：
|
|
||||||
|
|
||||||
| 阶段（用户语言） | 节点文件 | 提示词 | 产出（`state.py`） |
|
|
||||||
|---|---|---|---|
|
|
||||||
| 素材收集专家 | `nodes/researcher.py` | `prompts/researcher_prompts.py` | `material_package`（keywords + materials） |
|
|
||||||
| 写作大纲 | `nodes/writer_outline.py` | `prompts/writer_prompts.py` | `current_outline`（Outline JSON） |
|
|
||||||
| 作家写作 | `nodes/writer_draft.py` | `prompts/writer_prompts.py` | `current_draft`（Markdown，逐章流式） |
|
|
||||||
| 编辑审核 | `nodes/editor.py` | `prompts/editor_prompts.py` | `review_result`（评分 + 问题列表 JSON） |
|
|
||||||
|
|
||||||
关键事实：
|
|
||||||
- **LLM 调用方式**：节点通过 `nodes/_utils.py` 的 `get_model()` + `llm_json()` **直接调 LLM**，提示词写死在 `prompts/*.py`。**没有**走 agent 人设 / 技能 / 工具体系。
|
|
||||||
- **模型**：全程单一 `state.model_name`（用户在写作表单里选的主模型），各阶段无法分别配。
|
|
||||||
- **干预点 / 流式 / 严格模式 / 素材不足求助**：都在 `graph.py` 的 pause 节点和 `writer_draft` 里，逻辑较重，需原样保留。
|
|
||||||
- **前端**：`frontend-web/src/open-canvas/contexts/AIWritingContext.tsx` 是状态机（`researching/writing_outline/writing_draft/reviewing/...`），时间线 `AIWritingTimeline.tsx` 按 `progress_events`（已带 `agent_name` 字段）渲染。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 可复用的现成机制（不用造轮子）
|
|
||||||
|
|
||||||
代码库里**已经有**一套成熟的「内置功能型智能体」范式——圆桌的 `roundtable-intent / roundtable-recommender / roundtable-coordinator`：
|
|
||||||
|
|
||||||
1. **资源即代码**：`app/gateway/routers/_roundtable_seed_assets/<agent-id>/`
|
|
||||||
- `config.yaml`（`id` / `name` / `description`，可扩展 `model` / `skills` / `tool_groups`）
|
|
||||||
- `SOUL.md`（人设 + 职责 + 工作流 + **结构化输出契约**）
|
|
||||||
2. **种子器**：`app/gateway/routers/_roundtable_seed.py::ensure_roundtable_functional_agents`
|
|
||||||
- 启动时 + 相关路由入口自愈：目录不存在才从资源字节级落盘到 `.deer-flow/agents/<id>/` + DB（**已存在则永不覆盖**，尊重本地编辑）。
|
|
||||||
3. **运行**：在**独立 thread** 上跑该内置 agent（见 `app/gateway/routers/intent.py`，`INTENT_AGENT_ID = "roundtable-intent"`），通过 lead agent 运行时把 SOUL.md 作系统提示，流式经 LangGraph `custom`/`messages` 通道透传。
|
|
||||||
4. **结构化输出约定**：SOUL 规定模型末尾输出固定 **marker + ```json```**（如 `[INTENT_READY]\n```json{...}```），后端用正则解析（`intent.py::_INTENT_READY_PATTERN`）。
|
|
||||||
|
|
||||||
> 我们要做的，本质就是**照搬这套范式，给 AI 写作做 4 个功能型 agent**，并让对应的图节点改成「跑这个 agent + 解析其结构化输出」。
|
|
||||||
|
|
||||||
另有 agents 通用体系可复用：`agents` 表、`/api/agents` CRUD、智能体管理页（配模型/技能/工具）——4 个写作 agent 落盘后天然出现在这里，可被 admin 编辑。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 目标设计
|
|
||||||
|
|
||||||
### 3.1 四个内置写作智能体（建议 id / 职责）
|
|
||||||
|
|
||||||
| Agent id | 名称 | 取代节点 | 结构化输出 marker | 产出 schema |
|
|
||||||
|---|---|---|---|---|
|
|
||||||
| `ai-writing-researcher` | 素材收集专家 | `researcher` | `[MATERIALS_READY]` | `MaterialPackage` |
|
|
||||||
| `ai-writing-outliner` | 大纲规划师 | `writer_outline` | `[OUTLINE_READY]` | `Outline` |
|
|
||||||
| `ai-writing-writer` | 作家 | `writer_draft` | `[SECTION_READY]`（逐章） | 章节 Markdown |
|
|
||||||
| `ai-writing-editor` | 编辑 | `editor` | `[REVIEW_READY]` | `ReviewResult` |
|
|
||||||
|
|
||||||
每个 agent 自带：
|
|
||||||
- `config.yaml`：`id / name / description` +（扩展）`model`（该阶段专用模型，可空=回退用户主模型）、`skills`（如 researcher 挂检索技能）、`tool_groups`。
|
|
||||||
- `SOUL.md`：由现有 `prompts/*.py` 内容迁移改写，**追加结构化输出契约**（严格 marker + JSON 格式 + 反例，仿 `roundtable-intent` SOUL 的「硬规则」写法，压制弱模型乱输出）。
|
|
||||||
|
|
||||||
### 3.2 节点改造方式（核心）
|
|
||||||
|
|
||||||
每个阶段节点保留**输入/输出契约不变**（仍读写 `state` 的同一批字段），内部从：
|
|
||||||
|
|
||||||
```
|
|
||||||
# 旧：硬编码 prompt 直调
|
|
||||||
model = get_model(config, state["model_name"])
|
|
||||||
result = llm_json(model, SYSTEM_PROMPT, USER_PROMPT.format(...))
|
|
||||||
```
|
|
||||||
|
|
||||||
改为：
|
|
||||||
|
|
||||||
```
|
|
||||||
# 新：跑对应内置 agent，按 marker 解析
|
|
||||||
result = await run_writing_agent(
|
|
||||||
agent_id="ai-writing-outliner",
|
|
||||||
state=state, config=config,
|
|
||||||
user_payload=<本阶段输入>, # 意图/素材/大纲/草稿等拼成的一段输入
|
|
||||||
marker="[OUTLINE_READY]", # 结构化输出契约
|
|
||||||
)
|
|
||||||
```
|
|
||||||
|
|
||||||
新增统一助手 `nodes/_agent_runner.py::run_writing_agent(...)`：在子 thread 上跑指定内置 agent（复用 `intent.py` 的 run/stream 机制）、把流式 chunk 透传到 `custom` 通道（前端时间线不回归）、用复用的 `_utils.parse_json` 多级容错解析 marker 后的 JSON。
|
|
||||||
|
|
||||||
### 3.3 为什么选这个方案（A）而非全多智能体重写（B）
|
|
||||||
|
|
||||||
- **方案 A（推荐）**：保留图骨架，逐节点替换大脑。前端基本不动；干预点/流式/严格模式/素材求助原样保留；可**按阶段灰度 + feature flag 回退**，风险可控。
|
|
||||||
- **方案 B（不推荐）**：仿圆桌重做成多 agent 编排，需重写编排、状态、流式、4 个干预点对接，工作量数倍、回归面巨大，收益（更"纯"的多 agent）对本场景并不必要。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. 配置与可管理性
|
|
||||||
|
|
||||||
- **落盘**：仿 roundtable 新增 `_ai_writing_seed_assets/` + 一个 `ensure_ai_writing_functional_agents()` 种子器，在 Gateway 启动与 ai_writing 会话入口自愈。
|
|
||||||
- **管理界面**：4 个 agent 落盘后即出现在智能体管理页，admin 可编辑 **SOUL（人设）/ 模型 / 挂载技能**。可选：在「文章类型配置页」旁加一个「写作智能体配置」入口，或给这 4 个打一个 `tag` 便于筛选。
|
|
||||||
- **模型优先级**：节点跑 agent 时 `该 agent config.model > 用户写作表单选的主模型 model_name`（保留现有"用户选模型"语义，新增 per-阶段覆盖能力）。
|
|
||||||
- **技能**：researcher 现有的技能检索能力（`search/skill_search.py`）改为 `ai-writing-researcher` 的**挂载技能**，admin 可增减；检索步骤事件（`SkillStep`）形态保留给前端展示。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5. 分步实现计划（每步可独立交付 / 验收）
|
|
||||||
|
|
||||||
### Phase 0 · 契约冻结
|
|
||||||
- 定 4 个 agent 的 `id / name`、每个的 **marker + JSON schema**（与 `state.py` 的 `MaterialPackage/Outline/DraftArticle/ReviewResult` 严格对齐）。
|
|
||||||
- **验收**：本文 §3.1 / §6 的契约评审通过、字段与现有 TypedDict 一一对应。
|
|
||||||
|
|
||||||
### Phase 1 · 内置 agent 种子化（后端，纯新增，不接管流程）
|
|
||||||
- 新建 `app/gateway/routers/_ai_writing_seed_assets/<4 个 agent>/{config.yaml, SOUL.md}`；SOUL 由现有 `prompts/*.py` 迁移改写 + 追加结构化输出契约。
|
|
||||||
- 仿 `_roundtable_seed.py` 写 `ensure_ai_writing_functional_agents()`，挂到启动 lifespan + ai_writing 入口。
|
|
||||||
- **验收**：启动后 4 个 agent 出现在 `.deer-flow/agents/`、DB、`/api/agents`，能在智能体管理页查看/编辑；**此阶段不改图，写作流程行为不变**。
|
|
||||||
|
|
||||||
### Phase 2 · 节点接入「跑内置 agent」（后端，逐阶段灰度）
|
|
||||||
- 新增 `nodes/_agent_runner.py::run_writing_agent(...)`（子线程跑 agent + 流式透传 + marker 解析）。
|
|
||||||
- 加 feature flag：`config.yaml → ai_writing.use_builtin_agents.{editor,outliner,researcher,writer}`（默认 false=走旧节点）。
|
|
||||||
- **接入顺序（由易到难）**：
|
|
||||||
1. **editor**（最简单：小 JSON、无检索、无逐章流式）→ flag 打开端到端验证。
|
|
||||||
2. **outliner**（输出 Outline JSON）。
|
|
||||||
3. **researcher**（保留技能检索步骤事件、素材确认暂停）。
|
|
||||||
4. **writer**（最难：保留**逐章流式** + **严格模式素材不足求助** `blocked_sections`；建议**仍由节点控制"逐章循环"**，每章调一次 `ai-writing-writer`，`section_help` 暂停逻辑不动）。
|
|
||||||
- 每接一个，旧 prompt 与旧逻辑**保留**，节点按 flag 二选一。
|
|
||||||
- **验收**：每个阶段 flag 打开后端到端走通，产出结构与旧版一致，干预点 / 流式 / 严格模式 / 求助暂停均不回归。
|
|
||||||
|
|
||||||
### Phase 3 · 每阶段 agent 配置化
|
|
||||||
- per-agent 模型覆盖生效（`agent.config.model > model_name`）。
|
|
||||||
- researcher 的检索能力改为挂载技能，admin 可增减。
|
|
||||||
- 智能体管理页可编辑这 4 个的 SOUL / 模型 / 技能；config 热加载，新会话即生效、不重启前端。
|
|
||||||
- **验收**：admin 改某阶段 agent 的模型 / SOUL / 技能后，新会话立即按新配置运行。
|
|
||||||
|
|
||||||
### Phase 4 · 前端适配（小改）
|
|
||||||
- 时间线 / 状态文案：阶段名读对应 agent 的 `name`（`progress_events.agent_name` 已存在，基本沿用，去掉写死文案）。
|
|
||||||
- 可选：写作表单 / 设置加「查看·配置写作智能体」入口，跳智能体管理页。
|
|
||||||
- **验收**：前端展示各阶段对应的智能体名；配置入口可达。
|
|
||||||
|
|
||||||
### Phase 5 · 清理收口
|
|
||||||
- 四阶段稳定后，默认打开全部 flag、移除旧 prompt 直调路径与 flag（prompts 历史留在 git）。
|
|
||||||
- 更新 `offline-backend-20260512/backend/CLAUDE.md` 架构描述。
|
|
||||||
- **验收**：回归测试通过、冗余删除、文档同步。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 6. 结构化输出契约（与现有 state 对齐）
|
|
||||||
|
|
||||||
各 agent SOUL 末尾必须输出 `marker + ```json``` 块，schema 直接对齐 `state.py`：
|
|
||||||
|
|
||||||
- `ai-writing-researcher` → `[MATERIALS_READY]`：`{ "keywords": string[], "materials": Material[] }`（`Material` 见 `state.py`，含 `id/title/content/source/relevance_score/source_type/...`）。
|
|
||||||
- `ai-writing-outliner` → `[OUTLINE_READY]`：`Outline = { "title": string, "sections": OutlineSection[] }`（`OutlineSection = { section_title, key_points: KeyPoint[], material_ids }`）。
|
|
||||||
- `ai-writing-writer` → 逐章 `[SECTION_READY]`：`{ "section_title": string, "markdown": string, "needs_more_material"?: { "reason": string } }`（`needs_more_material` 触发严格模式求助 `blocked_sections`）。
|
|
||||||
- `ai-writing-editor` → `[REVIEW_READY]`：`ReviewResult = { "verdict": "pass"|"reject", "fact_score", "logic_score", "language_score", "overall_score", "pass_threshold", "revision_notes": ReviewIssue[] }`。
|
|
||||||
|
|
||||||
解析复用 `nodes/_utils.py::parse_json`（多级容错），marker 正则仿 `intent.py::_INTENT_READY_PATTERN`。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 7. 风险与注意
|
|
||||||
|
|
||||||
1. **弱模型结构化输出不稳**：SOUL 写严格格式 + 反例 + 「输出 marker 后立刻闭嘴」硬规则（仿 `roundtable-intent` SOUL §0）；解析层复用 `parse_json` 多级降级。
|
|
||||||
2. **writer 的逐章流式 + 严格模式求助最复杂**：建议**循环控制权留在节点**（每章调一次 agent），不要让 agent 一次吐全文，否则 `blocked_sections` / `section_help` / 逐章流式都要重做。
|
|
||||||
3. **researcher 技能检索步骤事件**（`SkillStep`）前端有专门卡片：迁移时保留这些 `progress_events` 形态。
|
|
||||||
4. **种子器 never-overwrite**：迭代 SOUL 后**老部署不会自动更新**（与圆桌同一问题）。运维更新办法：删 `.deer-flow/agents/<id>/` 重新种子，或后续给种子器加「内置功能 agent 按版本/hash 覆盖」开关。
|
|
||||||
5. **子线程隔离**：跑写作 agent 的子 thread 与主 ai_writing thread 状态隔离，注意 checkpointer 与清理（沿用 ai_writing 既有的会话清理）。
|
|
||||||
6. **离线内网**：researcher 的检索一律走技能（不联网），与现有「离线部署禁 web_search、走 skill」策略一致。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 8. 涉及文件清单（落地时对照）
|
|
||||||
|
|
||||||
**后端（主要改动）**
|
|
||||||
- 新增 `app/gateway/routers/_ai_writing_seed_assets/{ai-writing-researcher,ai-writing-outliner,ai-writing-writer,ai-writing-editor}/{config.yaml,SOUL.md}`
|
|
||||||
- 新增 `app/gateway/routers/_ai_writing_seed.py`（种子器，仿 `_roundtable_seed.py`）
|
|
||||||
- 新增 `packages/harness/deerflow/agents/ai_writing/nodes/_agent_runner.py`（`run_writing_agent`）
|
|
||||||
- 改 `nodes/{researcher,writer_outline,writer_draft,editor}.py`（按 flag 二选一）
|
|
||||||
- 改 `config.yaml`（新增 `ai_writing.use_builtin_agents.*` 开关；可选 per-agent 默认模型）
|
|
||||||
- 保留 `prompts/*.py`（回退用，Phase 5 删）
|
|
||||||
|
|
||||||
**前端（小改）**
|
|
||||||
- 改 `src/open-canvas/components/ai-writing/AIWritingTimeline.tsx`（阶段名读 agent name）
|
|
||||||
- 可选：写作表单/设置加「配置写作智能体」入口（跳 `/page/...` 智能体管理页）
|
|
||||||
|
|
||||||
**文档**
|
|
||||||
- 本文件
|
|
||||||
- Phase 5 收口时更新 `offline-backend-20260512/backend/CLAUDE.md`
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 9. 实施记录（2026-06-11，Phase 1-4 已落地）
|
|
||||||
|
|
||||||
### 已交付
|
|
||||||
|
|
||||||
- **Phase 1**：`_ai_writing_seed_assets/{ai-writing-researcher,ai-writing-outliner,ai-writing-writer,ai-writing-editor}/{config.yaml,SOUL.md}` + `_ai_writing_seed.py::ensure_ai_writing_functional_agents()`，挂启动 lifespan（`_sync_legacy_agents` 之前）+ `ai_writing.list_sessions / list_article_types` 入口自愈。
|
|
||||||
- **Phase 2**：`nodes/_agent_runner.py`（`stream_writing_agent` / `run_writing_agent` / `parse_marker_json` / `resolve_agent_model_name` / `use_builtin_agent`）；四节点按 `config.yaml → ai_writing.use_builtin_agents.{researcher,outliner,writer,editor}` 二选一（默认全 false，config 按 mtime 热加载，改完即对新会话生效）。agent 目录缺失时节点**静默回退旧 prompt 路径**，写作流程永不因 agent 被删而中断。
|
|
||||||
- **Phase 3（部分）**：per-agent 模型覆盖已生效（优先级 `agent config.model > 节点显式回退模型（keyword_model/rank_model）> 表单主模型 model_name`）；SOUL/模型在智能体管理页可编辑、按 mtime 热加载。researcher「检索能力改挂载技能」未做（仍走节点内 SkillPicker 编排）。
|
|
||||||
- **Phase 4**：时间线 agent 名由后端 `progress_events.agent_name` 动态下发（flag 开启时读 agent config 的 `name`）；`TimelineStep.tsx` 补「大纲规划师」配色（未命中名字回退灰色，admin 改名不报错）。
|
|
||||||
- **测试**：`tests/test_ai_writing_seed.py`（资源完整性 / 契约 marker / never-overwrite）+ `tests/test_ai_writing_agent_runner.py`（marker 多级解析 / 模型优先级 / flag / 流式端到端 / SOUL 缺失降级），共 31 例。
|
|
||||||
|
|
||||||
### 与 §6 契约的修订（以实现为准）
|
|
||||||
|
|
||||||
为保住「逐章流式打字机」「review_chunk/review_item_done 分维度卡片」「素材确认/求助暂停」等前端形态，编排控制权全部留在节点，agent 只承担**单次结构化产出**：
|
|
||||||
|
|
||||||
| Agent | 实际契约 |
|
|
||||||
|---|---|
|
|
||||||
| `ai-writing-researcher` | 两个子任务：`[KEYWORDS_READY]` + `{"keywords": []}`；`[MATERIALS_RANKED]` + `{"ranked_ids": [], "summary": ""}`。素材本体来自节点的检索编排（agent 不联网），`MaterialPackage` 仍由节点组装 |
|
|
||||||
| `ai-writing-outliner` | `[OUTLINE_READY]` + 完整 `Outline` JSON（新规划 / 修改模式共用，payload 开头标明任务模式） |
|
|
||||||
| `ai-writing-writer` | **无 JSON marker**：每章直接输出 Markdown 正文（保流式）；严格模式素材不足只输出一行 `[[SECTION_BLOCKED]] 原因`（沿用原哨兵） |
|
|
||||||
| `ai-writing-editor` | 每个维度一次调用：`[REVIEW_READY]` + `{"score": int, "issues": []}`；综合分/verdict/pass_threshold 仍由节点按 config 计算（不信任 LLM 自判通过） |
|
|
||||||
|
|
||||||
另一处架构修订：**不在子 thread 上经 lead agent 运行时跑**（§3.2 原设想复用 `intent.py` 机制，但其 loopback 在 app 层，harness 图节点不可 import；且单轮结构化调用无需 thread/checkpointer/中间件成本）。`run_writing_agent` 直接「SOUL 作 system prompt + 单条输入」调模型，规避了 §7.5 的子线程隔离/清理风险。researcher 挂技能（Phase 3 剩余项）如需完整工具体系再评估接入运行时。
|
|
||||||
|
|
||||||
### 已知存量测试失败（与本次无关）
|
|
||||||
|
|
||||||
`test_ai_writing_graph.py`（mock 已删除的 `intent_parser.llm_json`）、`test_ai_writing_word_count.py`（mock 已删除的 `writer_draft.get_model`）、`test_ai_writing_draft_headings.py`（断言三级结构升级前的 `####→###` 行为）、`test_ai_writing_outline_revise.py`（断言旧 prompt 文案），改造前即失败，待另行清理。
|
|
||||||
|
|
||||||
## 10. Phase 3 收尾：检索类型两项化 + 配置技能驱动检索（2026-06-13 已实施）
|
|
||||||
|
|
||||||
本节落地了 §9 遗留的「researcher 检索改挂载技能」，并按新需求重新设计了检索类型与 PAUSE-1 交互。
|
|
||||||
|
|
||||||
### 10.1 检索类型（material_source）收敛为两项
|
|
||||||
|
|
||||||
- 写作表单「素材来源」改名「检索类型」，只剩 `general`（通用检索，默认）/ `notebook`（我的空间）；旧值 `knowledge_base` / `skill` 由 researcher 节点按 `general` 兼容（老会话 resume 不受影响）。
|
|
||||||
- 前端：`AIWritingForm.tsx`（选项/标签）、`WritingFormContext.tsx`（默认值/类型/applyProposal 旧值映射）、`types/ai-writing.ts`、`message-list.tsx`（审批卡标签兼容旧值）。
|
|
||||||
|
|
||||||
### 10.2 通用检索 = 素材收集专家配置的技能编排
|
|
||||||
|
|
||||||
- `ai-writing-researcher` agent 的 `config.yaml → skills` 是权威配置（智能体管理页可增删/替换）；种子默认 `[knowledge-base-search]`。
|
|
||||||
- 内置技能 **knowledge-base-search（知识库检索）**：把原 web/intranet 关键词并发检索包装成技能。researcher 对它特殊处理——不拼 description，直接对 Step1 生成的检索词做原生并发检索（行为与旧 knowledge_base 模式一致）。其它配置技能按 `意图 + description` 拼定向 query 检索。按配置顺序执行、累积达 `max_materials` 早停（`stop_early`）。
|
|
||||||
- 技能配置为空/全部失效 → 内存兜底回退知识库检索（`researcher._load_configured_skills`），检索永不瘫痪。
|
|
||||||
- 种子：`_ai_writing_seed_assets/skills/knowledge-base-search/SKILL.md` → `skills/public/`（never-overwrite）；旧部署的 researcher `config.yaml` 缺 `skills` 键时就地补默认（显式 `skills: []` 不动）。`_ai_writing_seed.py::ensure_ai_writing_functional_agents()` 一并处理。
|
|
||||||
|
|
||||||
### 10.3 PAUSE-1 输入框 → 匹配技能检索并**追加**
|
|
||||||
|
|
||||||
- 用户在素材确认卡输入自然语言（如「检索 A 的数据」）→ `re_search + user_query`：配置技能 >1 个时 `SkillPicker(candidates=配置技能)` 让模型按输入匹配排序（流式打字机保留），单技能直接用；用用户原话（非知识库技能附 description）检索。
|
|
||||||
- **追加语义**：保留原素材列表与顺序，新素材按 URL 去重后追加在末尾（ID 续号），跳过 LLM 重排与 max_materials 截断（仅 100 条硬上限），summary 显示「追加检索到 X 条新素材，当前共 Y 条」。原 20 条 + 新 20 条 = 40 条。
|
|
||||||
- 「技能检索」独立按钮已删除（通用检索本来就走技能编排）；后端继续兼容旧 `enable_skill_search` action（按 user_query 追加处理）。无输入的「重新搜索」仍为覆盖式重检。
|
|
||||||
- 前端：`InterventionCard.tsx`（按钮/文案，hasQuery 时按钮文案「检索并追加素材」）、`MaterialsToolbar.tsx`（提示语）、`useAIWritingStream.ts`（素材卡回到 researching 一律置 skillSearchPending，让 SkillStepsCard 占位即时挂载）。
|
|
||||||
|
|
||||||
### 10.4 测试
|
|
||||||
|
|
||||||
- `tests/test_ai_writing_material_source.py` 重写（9 例）：缺省/旧值→通用检索、自定义技能 description query、user_query 追加+URL 去重+多技能 picker 匹配（candidates 断言）、无输入重检覆盖、空配置回退。
|
|
||||||
- `tests/test_ai_writing_seed.py` 扩展（+5 例）：技能资产存在、researcher 种子含默认 skills、技能种子 never-overwrite、缺 skills 键就地补丁、显式 `[]` 不动。
|
|
||||||
@@ -1,507 +0,0 @@
|
|||||||
# AI 写作「对话驱动写作台」实现方案（可落地版）
|
|
||||||
|
|
||||||
> 需求：**复制**现有 AI 写作代码，新增一个独立页面（**原页面/原路由零改动**）。在新页面里
|
|
||||||
> **大改交互流程**——去掉「素材收集 / 大纲规划 / 作家写作 / 编辑审核」四个阶段干预卡里的**输入框**，
|
|
||||||
> 只**保留原来的确认按钮**；在页面**底部新增一个统一的多行智能输入框**，具备**强意图理解**能力：
|
|
||||||
> 重新搜索、新增检索词、添加检索素材、重新规划大纲、按要求改大纲、提修改意见、审核意见、
|
|
||||||
> 素材不足继续搜集、对写作内容提问……**覆盖现有全部交互甚至更多**。
|
|
||||||
>
|
|
||||||
> 交互节奏不变：**一步一确认**——进行到某个专家阶段时，交互就针对该专家（阶段作用域）；
|
|
||||||
> 用户可以**点原来的确认按钮**，也可以**在底部输入框里发「继续下一步」的意图**推进。
|
|
||||||
> 意图**拿不准时**主动向用户**发起协助/澄清**，绝不盲目触发高代价动作（定稿 / 重搜等）。
|
|
||||||
|
|
||||||
本文是**实现指引**，落地时按第 9 节路线图分阶段推进。文中所有文件路径、符号名均对齐当前代码。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 现状梳理（改造地基）
|
|
||||||
|
|
||||||
现有 AI 写作是一套**独立 LangGraph 子系统**（不是 lead_agent），前后端都已成型、可复用。
|
|
||||||
|
|
||||||
### 1.1 后端 `ai_writing` graph
|
|
||||||
|
|
||||||
- 图工厂：`offline-backend-20260512/backend/packages/harness/deerflow/agents/ai_writing/graph.py`
|
|
||||||
（`make_ai_writing_graph`，registered as `assistant_id="ai_writing"`）
|
|
||||||
- 状态：`.../ai_writing/state.py`（`AIWritingState`）
|
|
||||||
- 四个「阶段大脑」节点：
|
|
||||||
|
|
||||||
| 阶段 | 节点 | 文件 |
|
|
||||||
|------|------|------|
|
|
||||||
| 素材收集 | `researcher` | `nodes/researcher.py` |
|
|
||||||
| 大纲规划 | `writer_outline` | `nodes/writer_outline.py` |
|
|
||||||
| 作家写作 | `writer_draft` | `nodes/writer_draft.py` |
|
|
||||||
| 编辑审核 | `editor` | `nodes/editor.py` |
|
|
||||||
|
|
||||||
- **五个暂停点**（`interrupt()`，`Command(resume=payload)` 续跑）——这是对话改造的核心可复用资产：
|
|
||||||
|
|
||||||
| pause_point | 语义 | 现有 action |
|
|
||||||
|-------------|------|-------------|
|
|
||||||
| `material_confirm` | 素材确认 | `confirm` / `re_search` / `enable_skill_search` |
|
|
||||||
| `outline_confirm` | 大纲确认 | `confirm` / `re_outline` |
|
|
||||||
| `draft_confirm` | 草稿确认 | `to_editor` / `finalize` / `user_revise` |
|
|
||||||
| `review_confirm` | 编辑打回确认 | `accept_review` / `force_finalize` |
|
|
||||||
| `section_help` | 素材不足求助 | `section_help`(+`sectionDecisions`) |
|
|
||||||
|
|
||||||
- resume 载荷（`UserInterventionPayload`，`types/ai-writing.ts`）字段：`action`、`approvedMaterialIds`、
|
|
||||||
`userQuery`（自然语言补充检索）、`editedOutline`、`outlineFeedback`、`userRevisionNotes`、
|
|
||||||
`overrideVerdict`、`selectedIssueIndices`、`sectionDecisions`。
|
|
||||||
**协议已同时支持「自然语言 + 结构化 action」**——这是对话层能复用的关键。
|
|
||||||
|
|
||||||
> 结论：**状态机 / 流式 / 暂停·续跑协议 / 持久化都可复用**，无需重写引擎。改造本质是
|
|
||||||
> 「把分散在干预卡里的输入框，换成一个底部智能输入框 + 意图路由层」，再把意图翻译回**现有
|
|
||||||
> `action + payload`**；仅少量新意图（对内容提问、素材不足自动回退重搜、追加审核意见）需新增能力。
|
|
||||||
|
|
||||||
### 1.2 前端 `open-canvas` 子系统
|
|
||||||
|
|
||||||
- 主页面：`frontend-web/src/open-canvas/pages/AIWritingPage.tsx`
|
|
||||||
- 路由注册：`open-canvas/routes/OpenCanvasRoutes.tsx`（`/page/canvas/ai-writing/*`）、
|
|
||||||
`pages/WorkspaceRoutes.tsx`（`/page/workspace/ai-writing/*`）、`pages/NotebookAIWritingPage.tsx`
|
|
||||||
- 状态机 + 流式：`contexts/AIWritingContext.tsx`（`useReducer` + LangGraph `useStream`，`assistantId:'ai_writing'`）
|
|
||||||
- 事件翻译 / reducer：`hooks/useAIWritingStream.ts`
|
|
||||||
- 类型：`types/ai-writing.ts`
|
|
||||||
- **左栏面板**：`components/ai-writing/AIWritingPanel.tsx`（时间线 + 干预卡 + 状态栏；idle 时挂启动表单）
|
|
||||||
- **要改造的输入 UI**（本次重点）：
|
|
||||||
- 干预卡 `components/ai-writing/InterventionCard.tsx`：内含
|
|
||||||
`MaterialConfirmCard`（素材：有 `MaterialsToolbar` 输入框）、
|
|
||||||
`OutlineConfirmCard`（大纲：有 feedback textarea）、
|
|
||||||
`DraftConfirmCard`（草稿：有「修改意见」textarea）、
|
|
||||||
`ReviewConfirmCard`（审核：有「补充修改指令」textarea）、
|
|
||||||
`SectionHelpCard`（素材不足：按钮组）。
|
|
||||||
**每张卡里都既有输入框又有确认/动作按钮**——本次要**去掉输入框、保留按钮**。
|
|
||||||
- 启动表单 `components/ai-writing/AIWritingForm.tsx`（idle 阶段的配置表单）——本次由底部输入框接管启动。
|
|
||||||
- **已存在的对话原型**（可借鉴）：`components/ai-writing/WritingSetupChat.tsx`
|
|
||||||
（`useThreadStream` 起 lead_agent 线程 + `setup_writing` 审批卡回填表单；仅管启动前配置，不直接复用）。
|
|
||||||
- 底部输入框可直接复用 UI 组件：`@/components/ai-elements/prompt-input`
|
|
||||||
（`PromptInput` / `PromptInputTextarea` / `PromptInputSubmit` / `PromptInputFooter`，见 `WritingSetupChat`）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 目标与范围
|
|
||||||
|
|
||||||
### 2.1 必须满足
|
|
||||||
|
|
||||||
1. **复制式新增**：新目录 / 新路由 / 新侧边栏入口，**旧页面、旧路由、旧组件零改动**（「初始的不用动」）。
|
|
||||||
2. 页面**底部单一多行智能输入框**接管全流程交互；四个阶段干预卡里的**输入框全部移除**。
|
|
||||||
3. **保留确认按钮**：每个阶段到达暂停点时，消息流里仍渲染**产物卡 + 原来的确认/动作按钮**
|
|
||||||
（素材「确认素材」、大纲「确认大纲」、草稿「让编辑审核 / 确认定稿」、审核「按编辑意见修改 / 强制定稿」、
|
|
||||||
素材不足的三选一按钮）。用户**点按钮**或**在底部输入框发自然语言意图**二选一均可推进。
|
|
||||||
4. **强意图理解**：把用户自由文本准确路由到正确动作，**覆盖现有全部交互 + 更多**（见 3.2）。
|
|
||||||
5. **阶段作用域**：意图解析必须知道「当前停在哪个专家阶段」，把同一句话按当前阶段翻译成对应 action。
|
|
||||||
6. **素材不足自动回退重搜**：修改意见需要的信息现有素材没有时，先重搜补素材、补完自动继续原意图。
|
|
||||||
7. **拿不准就协助**：低置信意图**不猜着执行**，走澄清追问（clarify）或用户协助。
|
|
||||||
8. 保留右侧草稿实时预览（可编辑）与时间线 / 进度展示。
|
|
||||||
|
|
||||||
### 2.2 明确不做（本期）
|
|
||||||
|
|
||||||
- 不改旧 `AIWritingPage` 及其 `AIWritingForm` / `InterventionCard`（这两个是要在**副本**里改的）。
|
|
||||||
- 不替换 `ai_writing` graph 四个阶段大脑逻辑，不动五个暂停点 / checkpoint / 持久化。
|
|
||||||
- 不引新状态管理库（继续 `useReducer` + `useStream`）。
|
|
||||||
|
|
||||||
### 2.3 复制策略（关键决策）
|
|
||||||
|
|
||||||
「复制一份」= **复制会被大改的表现层组件**（页面 + 干预卡 + 面板），**复用不改的引擎层**：
|
|
||||||
|
|
||||||
| 复制（新建副本，大改） | 复用（原样，不改；仅对 `types` 做**追加式**扩展） |
|
|
||||||
|------------------------|--------------------------------------------------|
|
|
||||||
| 新页面 `AIWritingChatPage.tsx` | `contexts/AIWritingContext.tsx`（状态机 + 流式） |
|
|
||||||
| 新面板 `WritingChatPanel.tsx`（消息流 + 底部输入框） | `hooks/useAIWritingStream.ts`（事件 → state） |
|
|
||||||
| 新消息卡 `chat-cards/*`（产物卡+确认按钮，**无输入框**） | `components/ai-writing/AIWritingDraftPanel.tsx`（右侧草稿预览） |
|
|
||||||
| 新意图客户端 `api/ai-writing-intent.ts` | 各流式展示子组件（`MaterialsCard`/`OutlineCard`/`ReviewCard`/`SkillStepsCard`…） |
|
|
||||||
| （可选）新 `contexts/WritingChatContext.tsx` 包一层「pending 意图 / 澄清态」 | `types/ai-writing.ts`（**只加字段不改旧字段**，保证旧页面不受影响） |
|
|
||||||
|
|
||||||
> **不复用、也不改** 的三个「输入框组件」：`AIWritingForm` / `InterventionCard` / `WritingFormContext`——
|
|
||||||
> 旧页面继续用它们，新页面完全不引用它们。这样「初始的不用动」得到硬保证。
|
|
||||||
>
|
|
||||||
> 为什么复用 `AIWritingContext` 而不复制它？它**不含任何输入框 UI**，只是「状态机 + 与后端 graph 的
|
|
||||||
> 流式桥」，复用它**不会改动旧页面的任何呈现**（旧页面照常在自己的 Provider 实例里跑）。复用能显著
|
|
||||||
> 降低维护成本、避免两套引擎漂移。若要绝对物理隔离，也可整目录复制 `AIWritingContext` +
|
|
||||||
> `useAIWritingStream` 到新目录——**推荐先复用**，仅当后续需要给对话态加大量图内新协议时再分叉。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 核心设计
|
|
||||||
|
|
||||||
### 3.1 三层结构
|
|
||||||
|
|
||||||
```
|
|
||||||
┌──────────────────────────────────────────────────────────────┐
|
|
||||||
│ 对话 UI 层（新） WritingChatPanel │
|
|
||||||
│ - 消息流：用户消息 + AI 阶段产物卡（含【保留的确认按钮】）+ 进度 │
|
|
||||||
│ - 底部：统一多行智能输入框（唯一自由输入入口） │
|
|
||||||
│ - 右侧：草稿实时预览（复用 AIWritingDraftPanel） │
|
|
||||||
└───────────────┬──────────────────────────────────────────────┘
|
|
||||||
│ 用户自然语言（+ 当前 status/pausePoint 上下文）
|
|
||||||
▼
|
|
||||||
┌──────────────────────────────────────────────────────────────┐
|
|
||||||
│ 意图解析层（新，核心） POST /api/ai-writing/sessions/{id}/intent │
|
|
||||||
│ 输出：{ intent, pausePoint, action, payload, │
|
|
||||||
│ needResearch, researchQuery, answer, confidence, clarify }│
|
|
||||||
└───────────────┬──────────────────────────────────────────────┘
|
|
||||||
│ 结构化 action + payload
|
|
||||||
▼
|
|
||||||
┌──────────────────────────────────────────────────────────────┐
|
|
||||||
│ 执行层（复用现有 AIWritingContext） │
|
|
||||||
│ idle → startWriting(AIWritingRequest) │
|
|
||||||
│ 暂停 → submitIntervention(UserInterventionPayload) │
|
|
||||||
│ 问答 → 旁路回答（不改写作状态） │
|
|
||||||
│ 素材不足 → 先重搜、缓存 pending、补完自动续跑 │
|
|
||||||
└──────────────────────────────────────────────────────────────┘
|
|
||||||
```
|
|
||||||
|
|
||||||
**设计原则**：意图解析层是「翻译官」——把自由文本翻译成**执行层已经懂的指令**。能复用
|
|
||||||
`action + payload` 的绝不新造协议；确认按钮点击**直接走执行层**（不经意图层，零延迟、零误判）。
|
|
||||||
|
|
||||||
### 3.2 意图分类体系（覆盖全流程 + 更多）
|
|
||||||
|
|
||||||
按「意图 → 触发时机（当前 status/pausePoint）→ 映射执行」组织，即意图解析引擎的目标 schema。
|
|
||||||
**「甚至更多」** = G（问答）、H（控制）、以及 B/C/D/E 里的「素材不足自动回退重搜」。
|
|
||||||
|
|
||||||
#### A. 启动类（status = `idle`）
|
|
||||||
| 意图 | 用户说法示例 | 映射 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| `start_writing` | 「写一篇关于新能源出口的深度分析，2000 字」 | 解析成 `AIWritingRequest` → `startWriting()` |
|
|
||||||
| `start_with_outline` | 「按这个大纲写：…」 | `AIWritingRequest.userOutline` |
|
|
||||||
| `start_imitate` | 「仿照这篇样文写…」 | `writingModeType='imitate'` + `sampleText` |
|
|
||||||
|
|
||||||
#### B. 素材类（pausePoint = `material_confirm`）
|
|
||||||
| 意图 | 示例 | 映射 |
|
|
||||||
|------|------|------|
|
|
||||||
| `confirm_materials` | 「素材可以，继续 / 下一步」 | `{action:'confirm', approvedMaterialIds}` |
|
|
||||||
| `research_again` | 「重新搜索素材」 | `{action:'re_search'}`（无 userQuery=覆盖式重检） |
|
|
||||||
| `add_material`/`add_keyword` | 「再补点关于 X 的素材」「加个关键词 Y」 | `{action:'re_search', userQuery:'X/Y'}`（追加） |
|
|
||||||
| `select_materials` | 「只用第 1、3 条」 | `{action:'confirm', approvedMaterialIds:[…]}` |
|
|
||||||
| `drop_materials` | 「去掉第 2 条」 | 同上（反选后的子集） |
|
|
||||||
|
|
||||||
#### C. 大纲类（pausePoint = `outline_confirm`）
|
|
||||||
| 意图 | 示例 | 映射 |
|
|
||||||
|------|------|------|
|
|
||||||
| `confirm_outline` | 「大纲 OK，开始写」 | `{action:'confirm'}` |
|
|
||||||
| `reoutline` | 「重写大纲」 | `{action:'re_outline'}`（feedback 可空） |
|
|
||||||
| `revise_outline` | 「第二章拆成两节」「调整顺序」 | `{action:'re_outline', outlineFeedback:自然语言}` |
|
|
||||||
|
|
||||||
#### D. 写作 / 草稿类（pausePoint = `draft_confirm`）
|
|
||||||
| 意图 | 示例 | 映射 |
|
|
||||||
|------|------|------|
|
|
||||||
| `to_editor` | 「交给编辑审核」 | `{action:'to_editor'}` |
|
|
||||||
| `finalize` | 「就这样定稿」 | `{action:'finalize'}` **（高代价：低置信必澄清）** |
|
|
||||||
| `revise_draft` | 「第三段太啰嗦，精简」「补个 2024 案例」 | `{action:'user_revise', userRevisionNotes:意见}` |
|
|
||||||
| `rewrite_section` | 「重写第二章」 | `user_revise` + 章节定位写进 notes |
|
|
||||||
| `change_tone/style` | 「更口语一点 / 更正式」 | `user_revise` + notes |
|
|
||||||
| `apply_review`（若已有审核结果） | 「按编辑意见改」「只接受第 1、2 条」 | `{action:'user_revise', selectedIssueIndices:[…]}` |
|
|
||||||
|
|
||||||
#### E. 编辑审核类（pausePoint = `review_confirm`）
|
|
||||||
| 意图 | 示例 | 映射 |
|
|
||||||
|------|------|------|
|
|
||||||
| `accept_review` | 「按编辑意见改」 | `{action:'accept_review', selectedIssueIndices}` |
|
|
||||||
| `partial_accept_review` | 「只接受第 1、2 条」 | `accept_review` + `selectedIssueIndices` 子集 |
|
|
||||||
| `add_review_opinion` | 「再补一条：核查数据准确性」 | `accept_review` + `userRevisionNotes`（并入补充指令，现协议已支持） |
|
|
||||||
| `force_finalize` | 「不改了，强制定稿」 | `{action:'force_finalize', overrideVerdict:true}` **（高代价：必澄清）** |
|
|
||||||
|
|
||||||
#### F. 素材不足求助类（pausePoint = `section_help`）
|
|
||||||
| 意图 | 映射 |
|
|
||||||
|------|------|
|
|
||||||
| `section_supplement` | `{action:'section_help', sectionDecisions:[…'supplement']}` |
|
|
||||||
| `section_loose` | `sectionDecisions:[…'loose']` |
|
|
||||||
| `section_delete` | `sectionDecisions:[…'delete']` |
|
|
||||||
|
|
||||||
#### G. 问答类（**新**；任意 status；旁路，不改写作状态）
|
|
||||||
| 意图 | 示例 | 映射 |
|
|
||||||
|------|------|------|
|
|
||||||
| `ask_about_content` | 「第二章讲了啥？」「为什么用这个论点？」 | 意图节点直接带回 `answer`，对话流渲染（见 5.4） |
|
|
||||||
| `ask_meta` | 「现在到哪步了？」「用了哪些素材？」 | 读当前 state 直接回答，不走图 |
|
|
||||||
|
|
||||||
#### H. 控制类（**新 / 半新**）
|
|
||||||
| 意图 | 映射 |
|
|
||||||
|------|------|
|
|
||||||
| `next_step`（通用「继续/下一步」） | 按**当前 pausePoint** 映射到该阶段的默认确认（material/outline→`confirm`，draft→`to_editor`…；等价点确认按钮） |
|
|
||||||
| `restart_stage` | 重跑当前阶段（复用 `resumeWriting()` 空 command 续跑） |
|
|
||||||
| `run_background` | 转后台自动跑：`suspendAIWritingToBackground()` |
|
|
||||||
| `cancel` | `pauseWriting()`（`stream.stop()`） |
|
|
||||||
| `unknown/clarify` | 无法判定 → 反问澄清 / 用户协助（**防误触发硬指标**） |
|
|
||||||
|
|
||||||
### 3.3 「素材不足自动重搜」判定与回退（用户强调点）
|
|
||||||
|
|
||||||
触发：用户在**大纲/草稿/审核**阶段提出修改意见，但意见需要的信息现有素材里没有。
|
|
||||||
|
|
||||||
判定来源（组合）：
|
|
||||||
1. **意图节点直接判**：把「素材摘要（keywords + 每条 title/source）」喂给意图 prompt，让它判断
|
|
||||||
「这条意见能否用现有素材满足」；不能 → `needResearch=true` + `researchQuery`。
|
|
||||||
2. **执行阶段兜底**：`writer_draft` 严格模式已有 `blocked_sections` → `section_help` 暂停点，
|
|
||||||
对话层把它翻译成「素材不足，是否重搜？」的追问。
|
|
||||||
|
|
||||||
回退动作（**首期纯前端实现，不动后端协议**）：`needResearch=true` 时，前端把用户的修改
|
|
||||||
`payload` 缓存为 `pendingIntent`，先 `submitIntervention({action:'re_search', userQuery:researchQuery})`
|
|
||||||
补素材；监听到新一轮 `material_confirm`（素材追加完成）后，**自动提交** `pendingIntent`。
|
|
||||||
需处理「重搜期间用户又改主意」→ 允许覆盖 pending。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. 意图解析引擎：方案与契约
|
|
||||||
|
|
||||||
**采用方案 A：后端 LLM 意图节点（独立 REST）**，叠加高频短句**规则快路径**优化。
|
|
||||||
|
|
||||||
理由：`needResearch` 判定需要**完整写作上下文**（素材/大纲/草稿），后端天然持有 checkpoint state；
|
|
||||||
与 `setup_writing` 一脉相承，离线模型选择策略统一；输出 schema 稳定、前端只消费。
|
|
||||||
|
|
||||||
### 4.1 后端入口
|
|
||||||
|
|
||||||
`app/gateway/routers/ai_writing.py` 新增：
|
|
||||||
|
|
||||||
```
|
|
||||||
POST /api/ai-writing/sessions/{session_id}/intent
|
|
||||||
Body: { text: string, status: string, pausePoint?: string }
|
|
||||||
Resp: IntentResult（见 4.3）
|
|
||||||
```
|
|
||||||
|
|
||||||
实现：读该 session 的 checkpoint state（素材摘要 / 大纲纲要 / 草稿字数·章节 / 审核意见）→
|
|
||||||
用 `ai_writing` 配置模型（复用 `intent_parser.py` 同套 `create_chat_model` + `parse_json` +
|
|
||||||
模型容错 `_model_fallback`）解析 → 返回结构化契约。**不改图拓扑**。
|
|
||||||
|
|
||||||
新增 prompt：`agents/ai_writing/prompts/intent_router_prompts.py`
|
|
||||||
- 输入：用户文本、`current_status`/`pause_point`、素材摘要、大纲纲要、草稿字数+章节标题、审核意见列表。
|
|
||||||
- 输出：严格 JSON（4.3 契约）。硬要求：**只在证据充分时给高 confidence，否则给 `clarify`**；
|
|
||||||
`finalize`/`force_finalize`/`re_search` 等高代价意图**必须**高置信才不澄清。
|
|
||||||
|
|
||||||
### 4.2 前端快路径（先跑规则，未命中再调后端）
|
|
||||||
|
|
||||||
`api/ai-writing-intent.ts` 里对**当前 pausePoint** 做少量确定性短语命中，直接产出 payload，省一次往返：
|
|
||||||
- 「继续/下一步/确认/可以/ok/好的」→ 当前阶段默认 `confirm`（draft 阶段=`to_editor`）。
|
|
||||||
- 「重新搜索/重搜」（material）→ `re_search`。「重写大纲」（outline）→ `re_outline`。
|
|
||||||
- 「定稿/强制定稿」→ **不进快路径**（高代价，一律走后端 + 可能澄清）。
|
|
||||||
- 命中即执行；未命中 → 调后端 `intent` 接口。
|
|
||||||
|
|
||||||
### 4.3 意图解析输出契约
|
|
||||||
|
|
||||||
```jsonc
|
|
||||||
{
|
|
||||||
"intent": "revise_draft", // 见 3.2 分类
|
|
||||||
"pausePoint": "draft_confirm", // 需要 resume 时；否则 null
|
|
||||||
"action": "user_revise", // 映射到现有 action
|
|
||||||
"payload": { // 直接可喂 submitIntervention 的字段（camelCase）
|
|
||||||
"userRevisionNotes": "第三段精简，并补一个 2024 年的案例"
|
|
||||||
},
|
|
||||||
"needResearch": true, // 素材是否不足
|
|
||||||
"researchQuery": "2024 行业案例", // needResearch 时的检索意图
|
|
||||||
"answer": null, // 问答类意图的直接回答（旁路）
|
|
||||||
"confidence": 0.86,
|
|
||||||
"clarify": null // 低置信时的反问话术（非空则不执行、只追问）
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
前端消费顺序：
|
|
||||||
1. `answer` 非空 → 对话流渲染回答（问答旁路，不动写作状态）。
|
|
||||||
2. `clarify` 非空 **或** `confidence < 阈值(建议 0.6)` → 渲染反问气泡，等用户澄清（**防误触发**）。
|
|
||||||
3. `needResearch=true` → 缓存 `pendingIntent=payload`，先重搜，收到新素材后自动提交。
|
|
||||||
4. 否则 → `idle` 走 `startWriting(...)`；暂停态走 `submitIntervention({action, ...payload})`。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5. 前端改造方案
|
|
||||||
|
|
||||||
### 5.1 新页面与路由（复制式）
|
|
||||||
|
|
||||||
- 新页面：`open-canvas/pages/AIWritingChatPage.tsx`
|
|
||||||
（骨架照抄 `AIWritingPage.tsx` 的 Provider 包裹与左右分栏；左栏换成 `WritingChatPanel`，右栏仍
|
|
||||||
`AIWritingDraftPanel`；idle 不再挂 `AIWritingForm`，改由底部输入框启动）。
|
|
||||||
- 路由注册（**新增，不动旧行**）：
|
|
||||||
- `open-canvas/routes/OpenCanvasRoutes.tsx` 加 `path="ai-writing-chat/*"`。
|
|
||||||
- 侧边栏 `core/page-layout/sidebar-menu.ts`：在 `qa-research` 旁新增
|
|
||||||
`{ id:"qa-research-chat", label:"AI写作(对话版)", icon:FileText, path:"/page/canvas/ai-writing-chat" }`。
|
|
||||||
（或先不加、内部灰度直链验证。）
|
|
||||||
|
|
||||||
### 5.2 新面板 `WritingChatPanel.tsx`（左栏主体）
|
|
||||||
|
|
||||||
职责 = 消息流容器 + 底部输入框，替代 `AIWritingPanel` 里的「时间线 + InterventionCard + 状态栏」。
|
|
||||||
复用 `useAIWriting()` 读 state / 调 `startWriting` / `submitIntervention` / `pauseWriting` /
|
|
||||||
`suspendAIWritingToBackground`。
|
|
||||||
|
|
||||||
消息流渲染（把 `ProgressEvent` / 阶段产物适配成消息卡，复用现有展示子组件）：
|
|
||||||
- 运行中：`research_progress`/`outline_chunk`/`draft_chunk`/`review_chunk` → 进度 / 流式卡
|
|
||||||
（复用 `SkillStepsCard`/`OutlineStreamingView`/`DraftGeneratingView`/`ReviewStreamingView` 的展示部分）。
|
|
||||||
- 到达暂停点：渲染 **产物卡 + 保留的确认按钮**（见 5.3），不再有输入框。
|
|
||||||
- 用户消息、AI 澄清追问、问答回答：普通气泡。
|
|
||||||
|
|
||||||
底部输入框：直接复用 `@/components/ai-elements/prompt-input`（`PromptInput`+`PromptInputTextarea`+
|
|
||||||
`PromptInputSubmit`），Enter 发送、Shift+Enter 换行；发送时读当前 `state.status`/`currentPause?.pausePoint`
|
|
||||||
交给意图路由（见 5.5）。运行中（非暂停点）可禁用发送或转「排队/提示当前在生成」。
|
|
||||||
|
|
||||||
### 5.3 新消息卡 `chat-cards/*`（**保留按钮、去掉输入框**）
|
|
||||||
|
|
||||||
把 `InterventionCard.tsx` 的五张卡各复制一份到 `open-canvas/components/ai-writing-chat/chat-cards/`，
|
|
||||||
**删掉其中的 textarea / MaterialsToolbar 输入部分，保留产物展示 + 确认/动作按钮**：
|
|
||||||
|
|
||||||
| 新卡 | 展示（复用） | 保留的按钮 | 删除的输入 |
|
|
||||||
|------|-------------|-----------|-----------|
|
|
||||||
| `MaterialConfirmChatCard` | `MaterialsCard`（勾选保留）+ `SkillStepsCard` | 「确认素材，规划大纲」「重新搜索」 | `MaterialsToolbar` 的 userQuery 输入框 |
|
|
||||||
| `OutlineConfirmChatCard` | `OutlineCard`（可点标题微调保留） | 「确认大纲，开始写作」 | feedback textarea + 发送 |
|
|
||||||
| `DraftConfirmChatCard` | `ReviewCard`（若有审核，勾选保留） | 「按编辑审核意见修改」「让编辑继续审核」「确认定稿」 | 「修改意见」textarea |
|
|
||||||
| `ReviewConfirmChatCard` | `ReviewCard`（勾选保留） | 「按编辑意见修改」「强制定稿」 | 「补充修改指令」textarea |
|
|
||||||
| `SectionHelpChatCard` | 章节 + 三选一按钮组 | 三选一 + 「提交并继续」 | （本就无自由输入，原样保留） |
|
|
||||||
|
|
||||||
> 勾选态（素材/审核意见）**保留**——它是「点按钮」路径的一部分，不算自由输入框。用户想用自然语言
|
|
||||||
> 「只用第 1、3 条」也能走底部输入框（意图层产出 `approvedMaterialIds`/`selectedIssueIndices`）。
|
|
||||||
> 按钮点击 **直接调 `submitIntervention`**，与旧卡完全一致，零改动风险。
|
|
||||||
|
|
||||||
### 5.4 问答旁路（新能力）
|
|
||||||
|
|
||||||
「对写作内容提问」不改写作 state。首期**轻量实现**：意图节点检出 `ask_*` 时读 state 直接带回 `answer`，
|
|
||||||
前端在消息流渲染为普通 AI 气泡即可（一次调用出答案）。完整版（后续）可另起只读 lead_agent 线程注入
|
|
||||||
草稿/大纲作背景，类似 `WritingSetupChat` 的 `useThreadStream`。
|
|
||||||
|
|
||||||
### 5.5 交互流程（对话版）串起来
|
|
||||||
|
|
||||||
1. **空闲**：底部输入「写一篇关于 X 的深度分析，2000 字」→ 意图 `start_writing` → 组 `AIWritingRequest`
|
|
||||||
→ `startWriting()`。（缺关键字段时先 `clarify` 追问字数/读者/类型。）
|
|
||||||
2. **运行中**：进度/流式卡渲染。
|
|
||||||
3. **到暂停点**：渲染产物卡 + 按钮 + 一句提示「你可以点上面的按钮，或直接说：确认继续 / 补充素材 / 改大纲…」。
|
|
||||||
- **点按钮** → 直接 `submitIntervention`（旧逻辑）。
|
|
||||||
- **发文字** → `resolveIntent(text, status, pausePoint)`（先快路径、后后端）→ 按 4.3 消费。
|
|
||||||
4. **问答**：任意时刻提问 → 旁路 `answer`，不打断写作。
|
|
||||||
5. **素材不足**：`needResearch` 或 `section_help` → 追问/执行「重搜 → 自动续跑 pending 意图」。
|
|
||||||
6. **拿不准**：`clarify`/低置信 → 反问气泡，不执行。
|
|
||||||
|
|
||||||
### 5.6 pending 意图 & 澄清态（新增本地状态）
|
|
||||||
|
|
||||||
在 `WritingChatPanel`（或新 `WritingChatContext`）维护：
|
|
||||||
- `pendingIntent: UserInterventionPayload | null` —— 素材不足重搜完成后自动提交。
|
|
||||||
- `awaitingClarify: { originalText: string } | null` —— 澄清态，用户下一句与上一句拼接再解析。
|
|
||||||
- pending 生命周期：设置 → 提交 `re_search` → 监听 reducer 里新一轮 `awaiting_material_confirm`
|
|
||||||
（`state.status` 从 `researching` 回到 `awaiting_material_confirm`）→ 自动 `submitIntervention(pending)` → 清空。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 6. 后端改造方案
|
|
||||||
|
|
||||||
### 6.1 意图解析入口（新增，唯一后端改动主体）
|
|
||||||
|
|
||||||
- `app/gateway/routers/ai_writing.py`：新增 `POST /sessions/{id}/intent`（见 4.1）。
|
|
||||||
读 checkpoint state 用 `app.state.checkpointer` + `make_ai_writing_graph().aget_state(...)`
|
|
||||||
（参照 `ai_writing_job_executor.py` 的读法）取素材/大纲/草稿/审核摘要。
|
|
||||||
- `agents/ai_writing/prompts/intent_router_prompts.py`：新增意图 prompt（见 4.1）。
|
|
||||||
- 复用 `nodes/intent_parser.py` 的模型创建 / `parse_json` / `_model_fallback` 容错。
|
|
||||||
|
|
||||||
### 6.2 不需要改的部分
|
|
||||||
|
|
||||||
- 四个阶段大脑节点、五个暂停点、checkpoint、StreamBridge、持久化、sessions/transcript REST——**全不动**。
|
|
||||||
- 「素材不足自动续跑」「问答旁路」首期都在**前端 / 意图节点**实现，**不扩 resume 协议**。
|
|
||||||
|
|
||||||
### 6.3 可选增强（阶段 3，按需）
|
|
||||||
|
|
||||||
- `add_review_opinion` 完整版：`review_confirm` resume 增字段 `extra_review_notes`（首期已用现有
|
|
||||||
`userRevisionNotes` 降级承载，够用）。
|
|
||||||
- `resume_intent` 后端化（把「重搜完自动续跑」搬到后端，减少前端状态机复杂度）。
|
|
||||||
- undo / 回退到上一暂停点（依赖 checkpoint 回滚）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 7. 数据流时序（改稿 + 素材不足自动重搜）
|
|
||||||
|
|
||||||
```
|
|
||||||
用户（draft_confirm 暂停）: "第三段补个2024年的行业案例"
|
|
||||||
│ 底部输入框 → resolveIntent(text, status='awaiting_draft_confirm', pausePoint='draft_confirm')
|
|
||||||
▼ POST /api/ai-writing/sessions/{id}/intent { text, status, pausePoint }
|
|
||||||
后端: 读 state(素材摘要) + LLM 解析
|
|
||||||
│ 返回 { intent:revise_draft, action:user_revise,
|
|
||||||
│ payload:{userRevisionNotes:"第三段…补2024案例"},
|
|
||||||
│ needResearch:true, researchQuery:"2024 行业案例", confidence:0.9 }
|
|
||||||
▼
|
|
||||||
前端: needResearch=true → pendingIntent = payload
|
|
||||||
│ submitIntervention({action:'re_search', userQuery:"2024 行业案例"})
|
|
||||||
▼ LangGraph resume → researcher 追加素材 → status 回到 awaiting_material_confirm
|
|
||||||
前端: 监听到新一轮素材确认 → 自动提交 pendingIntent
|
|
||||||
│ submitIntervention({action:'user_revise', userRevisionNotes:"第三段…补2024案例"})
|
|
||||||
▼ writer_draft 用新素材改稿 → draft_chunk… → draft_ready → draft_confirm
|
|
||||||
前端: 消息流展示新草稿卡 + "已按你的意见改写并补充了 2024 案例"
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 8. 关键实现细节与坑
|
|
||||||
|
|
||||||
1. **阶段作用域**：`resolveIntent` 必须带 `state.currentPause?.pausePoint` + `state.status`——
|
|
||||||
同一句「重新来」在 material 是重搜、在 outline 是重写大纲。`AIWritingContext` 已有这两个字段，直接读。
|
|
||||||
2. **确认按钮零改动**：新卡的按钮 `onClick` 原样调 `submitIntervention(payload)`，与旧卡逐字一致，
|
|
||||||
风险最低；**只删输入框**。
|
|
||||||
3. **防误触发**：低置信（<0.6）或 `clarify` 非空一律追问；`finalize`/`force_finalize`/`re_search`
|
|
||||||
即使命中也要求高置信，否则澄清。绝不盲目定稿/覆盖重搜。
|
|
||||||
4. **pending 意图队列**：素材不足是「先插重搜、再回原意图」，用 5.6 的小状态机；重搜完成前允许覆盖 pending。
|
|
||||||
5. **问答不污染 transcript**：问答/澄清消息在前端标记 `kind:'qa'|'clarify'`，与写作进度事件区分（
|
|
||||||
`AIWritingContext` 的 transcript 只存 progressEvents/completedInterventions，问答气泡是纯前端消息，
|
|
||||||
默认不入 transcript，避免历史回看错乱）。
|
|
||||||
6. **流式产物→消息卡**：复用 `OutlineStreamingView`/`DraftGeneratingView`/`ReviewStreamingView`/
|
|
||||||
`SkillStepsCard` 的**展示部分**，套进消息容器，不重写渲染。
|
|
||||||
7. **右侧草稿预览**：`AIWritingDraftPanel` + `DraftSync` 原样复用（`DraftSync` 依据 status/markdown
|
|
||||||
同步右侧画布）。
|
|
||||||
8. **离线内网**：意图模型走 `config.yaml → ai_writing` 配置模型；检索仍走技能/内网 ES，不联网。
|
|
||||||
9. **模型选择透传**：`submitIntervention` 的 resume 已把 `state.request?.modelName` 一并回传（见
|
|
||||||
`AIWritingContext`），新页面沿用即可。
|
|
||||||
10. **旧页面隔离验证**：改完后回归旧 `/page/canvas/ai-writing` 与 `/page/workspace/ai-writing`、
|
|
||||||
笔记本嵌入页，确认零变化（新代码不 import 旧的 `AIWritingForm`/`InterventionCard`/`WritingFormContext`）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 9. 分阶段实施路线图
|
|
||||||
|
|
||||||
**阶段 0 — 骨架（不含意图）**
|
|
||||||
- 复制 `AIWritingChatPage` + 注册新路由 + 侧边栏入口；复用 `AIWritingContext`/`useStream`/`DraftPanel`。
|
|
||||||
- 复制五张 `chat-cards`（删输入框、留按钮）；底部输入框先只做 idle 直发 `start_writing`
|
|
||||||
（文本原样当 `userIntent`，其余字段取默认）+ 暂停点靠按钮推进。端到端跑通。
|
|
||||||
|
|
||||||
**阶段 1 — 意图解析（核心）**
|
|
||||||
- 后端 `POST /sessions/{id}/intent` + `intent_router_prompts.py`，返回 4.3 契约。
|
|
||||||
- 前端 `api/ai-writing-intent.ts`（快路径 + 后端）接入 `WritingChatPanel`，覆盖 A~F 类意图。
|
|
||||||
- 低置信 `clarify` 澄清态（5.6）。
|
|
||||||
|
|
||||||
**阶段 2 — 问答旁路 + 素材不足自动重搜**
|
|
||||||
- G 类问答（意图节点直接带 `answer`）。
|
|
||||||
- `needResearch` + pending 意图机制（前端实现重搜后自动续跑，5.6）。
|
|
||||||
|
|
||||||
**阶段 3 — 增强（按需）**
|
|
||||||
- `add_review_opinion` 扩协议、`resume_intent` 后端化、undo/回退、完整问答只读线程。
|
|
||||||
|
|
||||||
**阶段 4 — 打磨**
|
|
||||||
- 消息卡视觉、历史回看（transcript）、后台挂起入口、灰度到侧边栏。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 10. 关键文件清单（落地对照）
|
|
||||||
|
|
||||||
### 新增（前端）
|
|
||||||
- `open-canvas/pages/AIWritingChatPage.tsx` — 新页面（复制 `AIWritingPage` 骨架改造）
|
|
||||||
- `open-canvas/components/ai-writing-chat/WritingChatPanel.tsx` — 消息流 + 底部输入框
|
|
||||||
- `open-canvas/components/ai-writing-chat/chat-cards/{MaterialConfirmChatCard,OutlineConfirmChatCard,DraftConfirmChatCard,ReviewConfirmChatCard,SectionHelpChatCard}.tsx` — 保留按钮、去掉输入框
|
|
||||||
- `open-canvas/components/ai-writing-chat/progressToMessage.ts` — `ProgressEvent` → 消息卡适配
|
|
||||||
- `open-canvas/api/ai-writing-intent.ts` — 意图解析客户端（快路径 + `POST …/intent`）
|
|
||||||
- （可选）`open-canvas/contexts/WritingChatContext.tsx` — pending 意图 / 澄清态
|
|
||||||
|
|
||||||
### 修改（前端，仅追加，不动旧逻辑）
|
|
||||||
- `open-canvas/routes/OpenCanvasRoutes.tsx` — 加一条 `ai-writing-chat/*` 路由
|
|
||||||
- `core/page-layout/sidebar-menu.ts` — 加一个侧边栏入口（可选）
|
|
||||||
- `open-canvas/types/ai-writing.ts` — **仅追加** `IntentResult` 等新类型，不改旧字段
|
|
||||||
|
|
||||||
### 新增（后端）
|
|
||||||
- `app/gateway/routers/ai_writing.py` — 加 `POST /sessions/{id}/intent`
|
|
||||||
- `agents/ai_writing/prompts/intent_router_prompts.py` — 意图 prompt
|
|
||||||
- `tests/test_ai_writing_intent.py` — 意图接口单测（TDD 强制）
|
|
||||||
|
|
||||||
### 复用（不改）
|
|
||||||
- `open-canvas/contexts/AIWritingContext.tsx`、`hooks/useAIWritingStream.ts`
|
|
||||||
- `open-canvas/components/ai-writing/{AIWritingDraftPanel,DraftSync,MaterialsCard,OutlineCard,ReviewCard,SkillStepsCard,OutlineStreamingView,DraftGeneratingView,ReviewStreamingView}.tsx`
|
|
||||||
- `agents/ai_writing/graph.py`、四个阶段节点、五个暂停点、`nodes/intent_parser.py`
|
|
||||||
|
|
||||||
### 绝不动（保证「初始的不用动」）
|
|
||||||
- `open-canvas/pages/AIWritingPage.tsx` 及其引用的
|
|
||||||
`components/ai-writing/{AIWritingForm,InterventionCard}.tsx`、`contexts/WritingFormContext.tsx`
|
|
||||||
- 旧路由 `/page/canvas/ai-writing`、`/page/workspace/ai-writing`、笔记本嵌入页
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 11. 待确认（默认取值已给出，可直接推进）
|
|
||||||
|
|
||||||
1. 意图引擎：**后端 LLM 节点（方案 A）+ 前端短句快路径** —— 默认采用。
|
|
||||||
2. `AIWritingContext` / `useAIWritingStream`：**复用**（不物理复制）——默认采用；需绝对隔离可改为复制。
|
|
||||||
3. 新页面入口：**侧边栏新增「AI写作(对话版)」** —— 默认加；若要先灰度可只留直链。
|
|
||||||
4. 「素材不足自动重搜」：**首期前端 pending 续跑**（不动后端 resume 协议）——默认采用。
|
|
||||||
5. 问答旁路：**首期意图节点直接带 `answer`** —— 默认采用。
|
|
||||||
|
|
||||||
> 以上默认按「A + 复用引擎 + 侧边栏入口 + 前端 pending + 意图节点带答案」推进，如需调整请指出。
|
|
||||||
@@ -1,454 +0,0 @@
|
|||||||
# AI 写作「对话驱动 + 意图解析」改造方案
|
|
||||||
|
|
||||||
> 目标：在**不动现有 AI 写作页面**的前提下，新建一个「对话驱动」的写作工作台。
|
|
||||||
> 去掉素材收集 / 大纲规划 / 作家写作 / 编辑审核各阶段**分散的输入框/表单**，
|
|
||||||
> 用**底部一个统一的智能输入框**接管全流程交互；该输入框具备**强意图解析**能力，
|
|
||||||
> 能准确识别用户意图（重新搜索、加素材、加关键词、重写大纲、按要求改大纲、改写作、
|
|
||||||
> 改编辑、提编辑意见、对写作内容提问……），并在**素材不足**时自动回退去重新检索素材。
|
|
||||||
|
|
||||||
本文只做**方案与实现指引**，不含代码改动。落地时按第 9 节的路线图分阶段推进。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 现状梳理（改造的地基）
|
|
||||||
|
|
||||||
现有 AI 写作是一套**独立的 LangGraph 子系统**（不是 lead_agent），前后端都已成型。
|
|
||||||
|
|
||||||
### 1.1 后端：`ai_writing` graph
|
|
||||||
|
|
||||||
- 图工厂：`offline-backend-20260512/backend/packages/harness/deerflow/agents/ai_writing/graph.py`
|
|
||||||
- 状态：`.../agents/ai_writing/state.py`（`AIWritingState` + `UserInterventionPayload`）
|
|
||||||
- 注册：`offline-backend-20260512/backend/langgraph.json` → `assistant_id = "ai_writing"`
|
|
||||||
- 执行：与 lead agent **共用** RunManager + StreamBridge + checkpointer（`app/gateway/services.py` 里 `assistant_id=="ai_writing"` 分发到 `make_ai_writing_graph`）
|
|
||||||
|
|
||||||
节点拓扑（实际）：
|
|
||||||
|
|
||||||
```
|
|
||||||
sample_analyzer → intent_parser → researcher
|
|
||||||
→ [cond] pause_material | writer_draft
|
|
||||||
→ writer_outline → pause_outline
|
|
||||||
→ writer_draft → [cond] pause_section_help | pause_draft | END
|
|
||||||
→ editor → [cond] pause_draft | pause_review
|
|
||||||
→ pause_review → END | writer_draft
|
|
||||||
```
|
|
||||||
|
|
||||||
四个「阶段大脑」节点：
|
|
||||||
|
|
||||||
| 阶段 | 节点 | 文件 |
|
|
||||||
|------|------|------|
|
|
||||||
| 素材收集 | `researcher` | `nodes/researcher.py` |
|
|
||||||
| 大纲规划 | `writer_outline` | `nodes/writer_outline.py` |
|
|
||||||
| 作家写作 | `writer_draft` | `nodes/writer_draft.py` |
|
|
||||||
| 编辑审核 | `editor` | `nodes/editor.py` |
|
|
||||||
|
|
||||||
五个**暂停点**（`interrupt()`，靠 `Command(resume=payload)` 续跑）：
|
|
||||||
|
|
||||||
| pause_point | 语义 | 可用 action（现有） |
|
|
||||||
|-------------|------|---------------------|
|
|
||||||
| `material_confirm` | 素材确认 | `confirm` / `re_search` / `supplement_search` / `enable_skill_search` |
|
|
||||||
| `outline_confirm` | 大纲确认 | `confirm` / `re_outline` |
|
|
||||||
| `draft_confirm` | 草稿确认 | `to_editor` / `finalize` / `user_revise` / `custom_revise` |
|
|
||||||
| `review_confirm` | 编辑打回确认 | `accept_review` / `force_finalize` |
|
|
||||||
| `section_help` | 素材不足求助 | `supplement` / `loose` / `delete` |
|
|
||||||
|
|
||||||
> resume 载荷字段（`UserInterventionPayload`）：`action`、`approved_material_ids`、
|
|
||||||
> `extra_keywords`、`user_query`(自然语言补充检索)、`edited_outline`、`outline_feedback`、
|
|
||||||
> `user_revision_notes`、`override_verdict`、`selected_issue_indices`、`section_decisions`。
|
|
||||||
> **关键点**：现有协议已经支持「自然语言 + 结构化 action」，这是对话改造的核心可复用资产。
|
|
||||||
|
|
||||||
REST（业务元数据，非图执行）：`app/gateway/routers/ai_writing.py`，前缀 `/api/ai-writing`
|
|
||||||
（sessions CRUD、transcript 保存、article-types、后台挂起 `/background` + `/progress` 等）。
|
|
||||||
|
|
||||||
持久化：`ai_writing_sessions` 表（`transcript` 为 `PortableLongText`）
|
|
||||||
+ `ai_writing_article_types`（`deerflow/persistence/...`）。
|
|
||||||
|
|
||||||
配置：`config.yaml → ai_writing`（`keyword_model`、`rank_model`、`max_materials`、
|
|
||||||
`use_builtin_agents.{researcher,outliner,writer,editor}` 等）。
|
|
||||||
|
|
||||||
### 1.2 前端：`open-canvas` 子系统
|
|
||||||
|
|
||||||
- 主页面：`frontend-web/src/open-canvas/pages/AIWritingPage.tsx`
|
|
||||||
- 路由：`/page/canvas/ai-writing`、`/page/workspace/ai-writing`
|
|
||||||
- 状态机：`contexts/AIWritingContext.tsx`（`useReducer` + LangGraph `useStream`）
|
|
||||||
- 事件翻译/reducer：`hooks/useAIWritingStream.ts`
|
|
||||||
- 类型：`types/ai-writing.ts`（`WritingStatus`、`ProgressEvent`、`UserInterventionPayload`、`AIWritingRequest`…）
|
|
||||||
- 流式：LangGraph `useStream`，`assistantId: 'ai_writing'`，`streamMode: ['values','updates','custom','messages-tuple']`
|
|
||||||
- **要去掉的输入 UI**（改造重点）：
|
|
||||||
- 启动表单 `components/ai-writing/AIWritingForm.tsx` + `WritingFormContext`
|
|
||||||
- 阶段暂停输入 `components/ai-writing/InterventionCard.tsx`（素材/大纲/草稿/审核四套内嵌表单）
|
|
||||||
- **已存在的对话原型**：`components/ai-writing/WritingSetupChat.tsx`
|
|
||||||
（用 `useThreadStream` 起一条 lead_agent 线程 + `setup_writing` 工具审批卡回填表单）——
|
|
||||||
这是「对话 → 结构化配置」的现成范式，可借鉴但**不直接复用**（它只管启动前配置）。
|
|
||||||
|
|
||||||
### 1.3 结论
|
|
||||||
|
|
||||||
- **状态机、流式、暂停/续跑协议、持久化都可复用**，无需重写引擎。
|
|
||||||
- 改造本质 = **把「分散表单」换成「一个对话输入框 + 意图路由层」**，
|
|
||||||
再把意图映射回**现有的 `action + payload`**（大部分场景），
|
|
||||||
少量新意图（如「对内容提问」「素材不足自动重搜」）需要**新增协议/节点**。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 目标与范围
|
|
||||||
|
|
||||||
### 2.1 必须满足
|
|
||||||
|
|
||||||
1. 新页面/新路由，**旧页面零改动**（用户要求「初始的不用动」）。
|
|
||||||
2. 底部**单一对话输入框**控制所有阶段交互，移除各阶段独立输入框。
|
|
||||||
3. **强意图解析**：准确识别用户自然语言意图并路由到正确动作，覆盖全流程 + 更多。
|
|
||||||
4. 用户给修改意见后，**若现有素材不足以满足要求 → 自动/建议重新检索素材**再继续。
|
|
||||||
5. 保留右侧草稿实时预览（可编辑）与时间线/进度展示。
|
|
||||||
|
|
||||||
### 2.2 明确不做（本期）
|
|
||||||
|
|
||||||
- 不改旧 `AIWritingPage` 及其表单/干预卡组件。
|
|
||||||
- 不替换底层 `ai_writing` graph 的四个阶段大脑逻辑（只加意图层与少量新协议）。
|
|
||||||
- 不引入新的状态管理库（继续 `useReducer` + `useStream`）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 核心设计
|
|
||||||
|
|
||||||
### 3.1 总体思路：三层结构
|
|
||||||
|
|
||||||
```
|
|
||||||
┌─────────────────────────────────────────────────────────┐
|
|
||||||
│ 对话 UI 层（新） │
|
|
||||||
│ - 左：消息流（用户消息 + AI 阶段产物卡片 + 进度） │
|
|
||||||
│ - 底：统一智能输入框（唯一交互入口） │
|
|
||||||
│ - 右：草稿实时预览（复用 AIWritingDraftPanel） │
|
|
||||||
└───────────────┬─────────────────────────────────────────┘
|
|
||||||
│ 用户自然语言
|
|
||||||
▼
|
|
||||||
┌─────────────────────────────────────────────────────────┐
|
|
||||||
│ 意图解析层（新，核心） │
|
|
||||||
│ - 输入：用户文本 + 当前 WritingStatus + 上下文快照 │
|
|
||||||
│ - 输出：{ intent, action, payload, needResearch, ... } │
|
|
||||||
└───────────────┬─────────────────────────────────────────┘
|
|
||||||
│ 结构化 action + payload
|
|
||||||
▼
|
|
||||||
┌─────────────────────────────────────────────────────────┐
|
|
||||||
│ 执行层（复用现有） │
|
|
||||||
│ - 空闲态：startWriting(AIWritingRequest) │
|
|
||||||
│ - 暂停态：submitIntervention(UserInterventionPayload) │
|
|
||||||
│ - 运行中：stream.stop() → 续跑 / 新命令 │
|
|
||||||
│ - 提问态：旁路问答（不改写作状态） │
|
|
||||||
└─────────────────────────────────────────────────────────┘
|
|
||||||
```
|
|
||||||
|
|
||||||
**设计原则**：意图解析层是「翻译官」——把自由文本翻译成**现有执行层已经懂的指令**。
|
|
||||||
能复用 `action + payload` 的绝不新造协议；只有现有协议表达不了的才扩展。
|
|
||||||
|
|
||||||
### 3.2 意图分类体系（覆盖用户全流程 + 更多）
|
|
||||||
|
|
||||||
按「意图类别 → 触发时机（当前 status）→ 映射到的执行」组织。这是**意图解析引擎的目标 schema**。
|
|
||||||
|
|
||||||
#### A. 启动类（status = idle）
|
|
||||||
|
|
||||||
| 意图 | 说明 | 映射 |
|
|
||||||
|------|------|------|
|
|
||||||
| `start_writing` | 用户描述要写什么 | 解析成 `AIWritingRequest` → `startWriting()` |
|
|
||||||
| `start_with_outline` | 用户自带大纲 | `AIWritingRequest.userOutline` |
|
|
||||||
| `start_imitate` | 样文仿写 | `writingModeType=imitate` + 样文 |
|
|
||||||
|
|
||||||
#### B. 素材类（status ≈ awaiting_material_confirm / 运行中）
|
|
||||||
|
|
||||||
| 意图 | 用户说法示例 | 映射 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| `confirm_materials` | 「素材可以，继续」 | `material_confirm` + `confirm`（可带勾选 ids） |
|
|
||||||
| `research_again` | 「重新搜索素材」 | `material_confirm` + `re_search` |
|
|
||||||
| `add_material` / `add_keyword` | 「补充关于 X 的素材」「加个关键词 Y」 | `material_confirm` + `supplement_search`，`user_query`=X/Y |
|
|
||||||
| `use_skill_search` | 「用 XX 技能查」 | `material_confirm` + `enable_skill_search`，`user_query`=技能/来源 |
|
|
||||||
| `select_materials` | 「只用第 1、3 条」 | `confirm` + `approved_material_ids` 子集 |
|
|
||||||
| `drop_materials` | 「去掉第 2 条」 | 同上，反选后 `approved_material_ids` |
|
|
||||||
|
|
||||||
#### C. 大纲类（status ≈ awaiting_outline_confirm）
|
|
||||||
|
|
||||||
| 意图 | 示例 | 映射 |
|
|
||||||
|------|------|------|
|
|
||||||
| `confirm_outline` | 「大纲 OK」 | `outline_confirm` + `confirm` |
|
|
||||||
| `reoutline` | 「重写大纲」 | `outline_confirm` + `re_outline`（`outline_feedback` 可空） |
|
|
||||||
| `revise_outline` | 「第二章拆成两节」「调整顺序」 | `re_outline` + `outline_feedback`=自然语言 |
|
|
||||||
| `edit_outline_manually` | 用户直接给出新大纲文本 | 解析成 `edited_outline` |
|
|
||||||
|
|
||||||
#### D. 写作/草稿类（status ≈ awaiting_draft_confirm / writing_draft）
|
|
||||||
|
|
||||||
| 意图 | 示例 | 映射 |
|
|
||||||
|------|------|------|
|
|
||||||
| `to_editor` | 「交给编辑审核」 | `draft_confirm` + `to_editor` |
|
|
||||||
| `finalize` | 「就这样定稿」 | `draft_confirm` + `finalize` |
|
|
||||||
| `revise_draft` | 「第三段太啰嗦，精简」「补个案例」 | `draft_confirm` + `user_revise`，`user_revision_notes`=意见 |
|
|
||||||
| `rewrite_section` | 「重写第二章」 | `user_revise` + 定位信息（章节）写进 notes |
|
|
||||||
| `change_tone/style` | 「更口语一点」 | `user_revise` + notes |
|
|
||||||
|
|
||||||
#### E. 编辑审核类（status ≈ awaiting_review_confirm）
|
|
||||||
|
|
||||||
| 意图 | 示例 | 映射 |
|
|
||||||
|------|------|------|
|
|
||||||
| `accept_review` | 「按编辑意见改」 | `review_confirm` + `accept_review`（可带 `selected_issue_indices`） |
|
|
||||||
| `partial_accept_review` | 「只接受第 1、2 条意见」 | `accept_review` + `selected_issue_indices` |
|
|
||||||
| `force_finalize` | 「不改了，强制定稿」 | `review_confirm` + `force_finalize` |
|
|
||||||
| `add_review_opinion` | 「你再补一条：检查数据准确性」 | 追加自定义审核意见（见 5.3 扩展） |
|
|
||||||
|
|
||||||
#### F. 素材不足求助类（status = awaiting_section_help）
|
|
||||||
|
|
||||||
| 意图 | 映射 |
|
|
||||||
|------|------|
|
|
||||||
| `section_supplement` | `section_help` + `supplement`（去重搜） |
|
|
||||||
| `section_loose` | `section_help` + `loose`（放宽续写） |
|
|
||||||
| `section_delete` | `section_help` + `delete` |
|
|
||||||
|
|
||||||
#### G. 问答类（**新**，任意 status，旁路，不改写作状态）
|
|
||||||
|
|
||||||
| 意图 | 示例 | 映射 |
|
|
||||||
|------|------|------|
|
|
||||||
| `ask_about_content` | 「第二章讲了啥？」「为什么用这个论点？」 | 旁路问答（见 5.4） |
|
|
||||||
| `ask_meta` | 「现在进行到哪一步？」「用了哪些素材？」 | 读当前 state 直接回答，不走图 |
|
|
||||||
|
|
||||||
#### H. 控制类（**新/半新**）
|
|
||||||
|
|
||||||
| 意图 | 映射 |
|
|
||||||
|------|------|
|
|
||||||
| `undo/back` | 回退到上一暂停点（依赖 checkpoint 回滚，见 8.4） |
|
|
||||||
| `restart_stage` | 重跑当前阶段 |
|
|
||||||
| `run_background` | 挂起后台自动跑 → `POST /sessions/{id}/background` |
|
|
||||||
| `cancel` | `stream.stop()` |
|
|
||||||
| `unknown/clarify` | 无法判定 → 反问澄清（对话追问，不误触发） |
|
|
||||||
|
|
||||||
> **覆盖「甚至更多」**：G（问答）、H（控制）、以及 D/E 里「素材不足自动回退重搜」都是超出原表单能力的新增。
|
|
||||||
|
|
||||||
### 3.3 「素材不足自动重搜」的判定与回退（用户强调的重点）
|
|
||||||
|
|
||||||
触发场景：用户在**大纲/草稿/审核**阶段提出修改意见，但意见需要的**信息现有素材里没有**。
|
|
||||||
|
|
||||||
判定放在**意图解析层**输出一个 `needResearch: boolean` + `researchQuery`，判定来源二选一（推荐组合）：
|
|
||||||
|
|
||||||
1. **意图解析 LLM 直接判断**：把「当前素材摘要（keywords + 每条 title/来源）」喂给意图解析
|
|
||||||
prompt，让它判断「用户这条意见能否用现有素材满足」。不能 → `needResearch=true` 并给出检索词。
|
|
||||||
2. **执行阶段兜底**：`writer_draft` 严格模式本就有 `blocked_sections` → `pause_section_help`，
|
|
||||||
这是**已有的**素材不足闸门；对话层把它翻译成「素材不足，是否重新检索？」的对话追问。
|
|
||||||
|
|
||||||
回退动作：`needResearch=true` 时，先走 `material_confirm + supplement_search`（或新的
|
|
||||||
「带目标的重搜」协议，见 8.3）补素材，**补完自动继续**用户原本的修改意图（需要在对话层
|
|
||||||
记住「pending 修改意图」，重搜结束后再提交）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. 意图解析引擎：方案对比与推荐
|
|
||||||
|
|
||||||
| 方案 | 做法 | 优点 | 缺点 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| **A. 后端 LLM 意图节点**（推荐） | 新增 `/api/ai-writing/intent/parse`（或图内新节点），后端用 LLM 把 `{text, status, contextSnapshot}` → 结构化意图 JSON | 能吃到完整 state（素材/大纲/草稿）；可判 `needResearch`；prompt/模型集中可控；离线内网可用配置模型 | 多一次网络往返（可接受，交互本就等待） |
|
|
||||||
| B. 前端调模型接口分类 | 前端直接调现有 `/api/models` 聊天做分类 | 少一层后端改动 | 前端难拿全后端 state 快照；prompt 分散；鉴权/模型选择复杂 |
|
|
||||||
| C. 规则 + LLM 混合 | 常见短句走关键词规则快路径，兜底 LLM | 快、省 token | 规则易漏、维护成本高；中文表达多样命中率低 |
|
|
||||||
|
|
||||||
**推荐 A（后端 LLM 意图节点）**，并在其上**叠加 C 的快路径**做优化（如「确认/继续/定稿」等
|
|
||||||
高频短句先走轻量规则，未命中再调 LLM）。理由：
|
|
||||||
|
|
||||||
- 意图判定需要**当前写作上下文**（尤其 `needResearch` 判定），后端天然持有 state/checkpoint。
|
|
||||||
- 与现有「配置助手 `setup_writing`」一脉相承，模型选择/离线部署策略统一。
|
|
||||||
- 输出 schema 稳定，前端只消费结构化结果，UI 简单。
|
|
||||||
|
|
||||||
### 4.1 意图解析输出契约（建议）
|
|
||||||
|
|
||||||
```jsonc
|
|
||||||
{
|
|
||||||
"intent": "revise_draft", // 见第 3.2 分类
|
|
||||||
"pausePoint": "draft_confirm", // 若需 resume；否则 null
|
|
||||||
"action": "user_revise", // 映射到现有 action；新意图可为新值
|
|
||||||
"payload": { // 直接可喂 submitIntervention 的字段
|
|
||||||
"userRevisionNotes": "第三段精简，并补一个 2024 年的案例"
|
|
||||||
},
|
|
||||||
"needResearch": true, // 素材是否不足
|
|
||||||
"researchQuery": "2024 行业案例", // needResearch 时的检索意图
|
|
||||||
"answer": null, // 问答类意图的直接回答（旁路）
|
|
||||||
"confidence": 0.86,
|
|
||||||
"clarify": null // 低置信时的反问话术
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
前端拿到后：
|
|
||||||
- `answer` 非空 → 直接在对话流渲染回答（问答旁路，不动写作状态）。
|
|
||||||
- `clarify` 非空或 `confidence` 低 → 渲染反问，等用户澄清（**防误触发**）。
|
|
||||||
- `needResearch=true` → 先重搜，缓存 `payload` 为 pending，重搜完再提交。
|
|
||||||
- 否则 → `submitIntervention({action, ...payload})` 或 `startWriting(...)`。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5. 前端改造方案
|
|
||||||
|
|
||||||
### 5.1 新页面与路由
|
|
||||||
|
|
||||||
- 新目录：`frontend-web/src/open-canvas/pages/AIWritingChatPage.tsx`（或 `conversational/` 子目录）。
|
|
||||||
- 新路由：`/page/canvas/ai-writing-chat`（在 `OpenCanvasRoutes.tsx` 注册；旧路由保留）。
|
|
||||||
- 侧边栏：`sidebar-menu.ts` 加一个入口（如「AI 写作（对话版）」），或先不加、内部灰度。
|
|
||||||
|
|
||||||
### 5.2 复用 vs 新建
|
|
||||||
|
|
||||||
| 复用（尽量不改） | 新建 |
|
|
||||||
|------------------|------|
|
|
||||||
| `AIWritingContext` / `useAIWritingStream`（状态机 + 流式） | 统一对话输入框组件 `WritingChatComposer` |
|
|
||||||
| `AIWritingDraftPanel`（右侧草稿预览） | 消息流容器 `WritingChatThread`（渲染阶段产物为消息卡片） |
|
|
||||||
| `types/ai-writing.ts`（按需扩展） | 意图解析客户端 `api/ai-writing-intent.ts` |
|
|
||||||
| `ProgressEvent` 事件模型 | 阶段产物 → 消息卡片的适配器 `progressToMessage.ts` |
|
|
||||||
| 会话持久化 REST | 「pending 意图」暂存逻辑（重搜后续跑） |
|
|
||||||
|
|
||||||
**不复用**：`AIWritingForm` / `WritingFormContext` / `InterventionCard`（这三个就是要去掉的表单）。
|
|
||||||
|
|
||||||
### 5.3 交互流程（对话版）
|
|
||||||
|
|
||||||
1. 空闲：用户在底部输入「写一篇关于 X 的深度分析，2000 字」→ 意图解析 `start_writing`
|
|
||||||
→ 组装 `AIWritingRequest` → `startWriting()`。
|
|
||||||
2. 运行中：`ProgressEvent`（`research_progress`/`outline_chunk`/`draft_chunk`…）
|
|
||||||
→ 适配成消息流里的**进度卡片/流式卡片**（复用现有流式视图组件的展示部分）。
|
|
||||||
3. 到达暂停点：不再弹 `InterventionCard`，而是在消息流里展示**阶段产物卡片**
|
|
||||||
（素材列表 / 大纲 / 草稿 / 审核结果）+ 一句提示「你可以说：确认继续 / 补充素材 / 改大纲…」。
|
|
||||||
用户下一句自然语言 → 意图解析 → `submitIntervention`。
|
|
||||||
4. 问答：任意时刻用户提问 → 旁路回答，不打断写作状态。
|
|
||||||
5. 素材不足：意图解析 `needResearch` 或后端 `section_help` → 对话追问「素材不足，帮你重搜？」
|
|
||||||
→ 确认后重搜 → 自动续跑 pending 意图。
|
|
||||||
|
|
||||||
### 5.4 问答旁路（新能力）
|
|
||||||
|
|
||||||
「对写作内容提问」不应改写作 state。两种实现：
|
|
||||||
|
|
||||||
- **轻量（推荐先做）**：意图解析节点直接带回 `answer`（后端能读 state，一次调用出答案）。
|
|
||||||
- **完整**：新起一条**只读**问答线程（lead_agent，context 注入当前草稿/大纲作为背景），
|
|
||||||
类似 `WritingSetupChat` 的 `useThreadStream` 模式，但只读不回填。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 6. 后端改造方案
|
|
||||||
|
|
||||||
### 6.1 意图解析入口（二选一）
|
|
||||||
|
|
||||||
- **方案 A1（推荐，独立 REST）**：`app/gateway/routers/ai_writing.py` 新增
|
|
||||||
`POST /api/ai-writing/sessions/{id}/intent`，入参 `{text}`，后端读该 session 的
|
|
||||||
checkpoint state（素材/大纲/草稿摘要）+ 用 `ai_writing` 配置模型解析，返回第 4.1 的契约。
|
|
||||||
- 好处：不改图拓扑；前端拿到结果后再决定调 `startWriting`/`submitIntervention`。
|
|
||||||
- 方案 A2（图内节点）：在图里加 `conversation_router` 节点。改动大、状态耦合高，**不推荐**首期。
|
|
||||||
|
|
||||||
### 6.2 意图解析 prompt
|
|
||||||
|
|
||||||
新增 `agents/ai_writing/prompts/intent_router_prompts.py`（或复用/扩展 `intent_parser.py`）：
|
|
||||||
- 输入：用户文本、`current_status`、素材摘要（keywords + 每条 title/source）、大纲纲要、
|
|
||||||
草稿字数/章节标题、审核意见列表。
|
|
||||||
- 输出：严格 JSON（第 4.1 契约）。要求模型**只在证据充分时给高 confidence**，
|
|
||||||
否则给 `clarify`（防误触发是硬指标）。
|
|
||||||
|
|
||||||
### 6.3 「带目标的重搜」协议扩展（可选增强）
|
|
||||||
|
|
||||||
现有 `supplement_search` 用 `user_query` 追加检索。为支持「改稿意见 → 缺素材 → 重搜 → 自动续跑」，
|
|
||||||
建议在 `material_confirm` 的 resume 里新增可选字段 `resume_intent`（重搜完成后要自动执行的原始意图）。
|
|
||||||
- 前端也可**纯前端**实现（重搜完成事件回来后再自动提交缓存的 pending payload），**首期优先前端实现**，避免动后端协议。
|
|
||||||
|
|
||||||
### 6.4 追加自定义审核意见（`add_review_opinion`）
|
|
||||||
|
|
||||||
`editor`/`pause_review` 目前只接受「接受/强制定稿」。要支持「你再补一条审核意见」，
|
|
||||||
需在 `review_confirm` resume 里接受 `extra_review_notes`，`editor` 或 `writer_draft`
|
|
||||||
修订时并入。首期可先降级为 `user_revise` + notes（把用户的审核诉求当作改稿意见），
|
|
||||||
**完整版**再扩协议。
|
|
||||||
|
|
||||||
### 6.5 不需要改的部分
|
|
||||||
|
|
||||||
- 四个阶段大脑节点（researcher/writer_outline/writer_draft/editor）逻辑不动。
|
|
||||||
- 五个暂停点、checkpoint、StreamBridge、持久化不动。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 7. 数据流时序（改稿 + 素材不足自动重搜）
|
|
||||||
|
|
||||||
```
|
|
||||||
用户: "第三段补个2024年的行业案例"
|
|
||||||
│
|
|
||||||
▼ POST /api/ai-writing/sessions/{id}/intent { text }
|
|
||||||
后端: 读 state(素材摘要) + LLM 解析
|
|
||||||
│ 返回 { intent:revise_draft, action:user_revise,
|
|
||||||
│ payload:{userRevisionNotes:...},
|
|
||||||
│ needResearch:true, researchQuery:"2024 行业案例" }
|
|
||||||
▼
|
|
||||||
前端: needResearch=true → 缓存 pending=payload
|
|
||||||
│ 对话追问/直接执行: submitIntervention(material_confirm, supplement_search, user_query="2024 行业案例")
|
|
||||||
▼ LangGraph resume → researcher 补素材 → materials_ready
|
|
||||||
前端: 收到新素材 → 自动提交 pending
|
|
||||||
│ submitIntervention(draft_confirm, user_revise, userRevisionNotes=...)
|
|
||||||
▼ writer_draft 用新素材改稿 → draft_chunk... → draft_ready → pause_draft
|
|
||||||
前端: 消息流展示新草稿 + "已按你的意见改写并补充了案例"
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 8. 关键实现细节与坑
|
|
||||||
|
|
||||||
1. **暂停态识别**：对话层必须知道「现在停在哪个 pause_point」才能正确映射 action。
|
|
||||||
`AIWritingContext` 已有 `currentPause`/`status`，直接读。
|
|
||||||
2. **防误触发**：低置信意图一律走 `clarify` 反问，绝不猜着执行（尤其 `finalize`/`re_search` 这种代价大的）。
|
|
||||||
3. **pending 意图队列**：素材不足重搜是「先插一段、再回原意图」，需要一个小状态机记住 pending，
|
|
||||||
并处理「重搜后用户又改主意」的情况（重搜完成前允许覆盖 pending）。
|
|
||||||
4. **回退/undo（H 类）**：依赖 checkpoint 回滚，`runtime/runs/worker.py` 有 `rollback` 概念，
|
|
||||||
首期可**不做**或只做「重跑当前阶段」。
|
|
||||||
5. **问答旁路不污染 transcript**：问答消息可标记 `kind:'qa'`，与写作进度事件区分持久化。
|
|
||||||
6. **流式产物→消息卡片**：复用现有 `OutlineStreamingView`/`DraftStreamingPreview` 等的**展示部分**，
|
|
||||||
套进消息气泡即可，不必重写渲染。
|
|
||||||
7. **离线内网**：意图解析模型走 `config.yaml → ai_writing` 里的配置模型；检索仍走技能/内网 ES，
|
|
||||||
不联网（与现有并行席位「禁 web_search」的离线策略一致）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 9. 分阶段实施路线图
|
|
||||||
|
|
||||||
**阶段 0 — 骨架（不含意图）**
|
|
||||||
- 新路由 + 新页面 `AIWritingChatPage`，复用 `AIWritingContext`/`useStream`/`DraftPanel`。
|
|
||||||
- 底部对话框先只做「空闲 `start_writing` + 暂停点固定按钮」跑通端到端（相当于把干预卡换成消息）。
|
|
||||||
|
|
||||||
**阶段 1 — 意图解析（核心）**
|
|
||||||
- 后端 `POST /sessions/{id}/intent` + intent prompt，返回第 4.1 契约。
|
|
||||||
- 前端接入：自然语言 → 意图 → `startWriting`/`submitIntervention`，覆盖 A~F 类意图。
|
|
||||||
- 加高频短句规则快路径 + 低置信 `clarify` 反问。
|
|
||||||
|
|
||||||
**阶段 2 — 问答旁路 + 素材不足自动重搜**
|
|
||||||
- G 类问答（先用 intent 节点直接带 `answer`）。
|
|
||||||
- `needResearch` + pending 意图机制（前端实现重搜后自动续跑）。
|
|
||||||
|
|
||||||
**阶段 3 — 增强协议（按需）**
|
|
||||||
- `add_review_opinion` 扩 `review_confirm` 协议、`resume_intent` 后端化、undo/回退。
|
|
||||||
|
|
||||||
**阶段 4 — 打磨**
|
|
||||||
- 消息卡片视觉、历史回看（复用 transcript）、后台挂起入口、灰度到侧边栏。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 10. 关键文件清单（落地时对照）
|
|
||||||
|
|
||||||
### 新增（前端）
|
|
||||||
- `open-canvas/pages/AIWritingChatPage.tsx` — 新页面
|
|
||||||
- `open-canvas/components/ai-writing-chat/WritingChatComposer.tsx` — 统一输入框
|
|
||||||
- `open-canvas/components/ai-writing-chat/WritingChatThread.tsx` — 消息流
|
|
||||||
- `open-canvas/components/ai-writing-chat/progressToMessage.ts` — 事件→消息适配
|
|
||||||
- `open-canvas/api/ai-writing-intent.ts` — 意图解析客户端
|
|
||||||
- 路由注册：`open-canvas/OpenCanvasRoutes.tsx`（+ 可选 `sidebar-menu.ts`）
|
|
||||||
|
|
||||||
### 新增（后端）
|
|
||||||
- `app/gateway/routers/ai_writing.py` — 加 `POST /sessions/{id}/intent`
|
|
||||||
- `agents/ai_writing/prompts/intent_router_prompts.py` — 意图 prompt
|
|
||||||
- （阶段 3）`state.py` / `nodes/*` — 扩 `review_confirm`、`resume_intent`
|
|
||||||
|
|
||||||
### 复用（尽量不改）
|
|
||||||
- `open-canvas/contexts/AIWritingContext.tsx`、`hooks/useAIWritingStream.ts`
|
|
||||||
- `open-canvas/components/ai-writing/AIWritingDraftPanel.tsx` 及各流式展示组件
|
|
||||||
- `open-canvas/types/ai-writing.ts`（按需扩字段）
|
|
||||||
- `agents/ai_writing/graph.py`、四个阶段节点、五个暂停点
|
|
||||||
|
|
||||||
### 不动
|
|
||||||
- 旧 `open-canvas/pages/AIWritingPage.tsx` 及 `AIWritingForm`/`WritingFormContext`/`InterventionCard`
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 11. 待确认
|
|
||||||
|
|
||||||
1. 意图解析引擎是否采用**推荐的方案 A（后端 LLM 节点）**？
|
|
||||||
2. 新页面是**独立入口**（侧边栏新增）还是先**内部灰度**（仅直链）？
|
|
||||||
3. 「素材不足自动重搜」首期是否接受**前端实现 pending 续跑**（不动后端 resume 协议）？
|
|
||||||
4. 问答旁路首期是否接受**意图节点直接带答案**（不新起只读线程）？
|
|
||||||
|
|
||||||
> 以上默认按「A / 内部灰度 / 前端 pending / 意图节点带答案」推进，如需调整请指出。
|
|
||||||
@@ -1,436 +0,0 @@
|
|||||||
# 工作台问答 · iframe 嵌入开发说明
|
|
||||||
|
|
||||||
本文档说明如何将 DeerFlow **通用工作台问答**（与 `/page/workspace/chats/*` 同一套 LangGraph 流式能力）以**普通 iframe** 形式嵌入第三方页面，并在**父页面无法读取子 frame 内 `thread_id`** 的前提下，轮询「本次问答是否已结束」。
|
|
||||||
|
|
||||||
后端公开 API 实现见：`offline-backend-20260512/backend/app/gateway/routers/public_embed.py`
|
|
||||||
数据表：`embed_sessions`（迁移 `20260602_01`）
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 0. 速读
|
|
||||||
|
|
||||||
| 角色 | 要做的事 |
|
|
||||||
|------|----------|
|
|
||||||
| **父页面** | 自己生成 `sessionId`（UUID），拼进 iframe `src`；用 `sessionId` 调公开 API 轮询 `finished` |
|
|
||||||
| **iframe（DeerFlow）** | 打开 `/embed/chats/...`，自动登录、自动发问、登记 `sessionId → thread_id` |
|
|
||||||
| **不需要** | 无界（wujie）、父页面拿 `thread_id`、DeerFlow 登录态 Cookie |
|
|
||||||
|
|
||||||
**完成条件**：`GET .../sessions/{sessionId}/status` 返回 `finished === true`（且无进行中的 run，非澄清中断）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 背景与约束
|
|
||||||
|
|
||||||
### 1.1 业务目标
|
|
||||||
|
|
||||||
- 第三方系统用 **iframe** 嵌 DeerFlow 问答 UI。
|
|
||||||
- 传入：**问题文案**、**用户名**（走现有 `login/username`）、**主题色**。
|
|
||||||
- 展示：**消息列表** + **沙箱/产物侧栏**（与主聊天相同的 `ChatBox`）；**隐藏**页面左侧栏、Workspace 侧栏、底部输入框。
|
|
||||||
- 进入后 **自动发送** 首条用户消息并走流式问答。
|
|
||||||
|
|
||||||
### 1.2 为何需要 `sessionId`
|
|
||||||
|
|
||||||
iframe 与父页面通常 **跨域**，父页面 **不能** 读取子应用 URL 里的 `thread_id`（hash 路由在子 frame 内）。
|
|
||||||
因此约定：
|
|
||||||
|
|
||||||
1. **父页面**在打开 iframe 前生成全局唯一的 `sessionId`；
|
|
||||||
2. **子页面**在创建/确定 `thread_id` 后，调用后端 **登记接口** 写入 `session_id → thread_id`；
|
|
||||||
3. **父页面**只凭 `sessionId` 查询状态，必要时响应里会带上 `thread_id`（可选使用）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 端到端流程
|
|
||||||
|
|
||||||
```mermaid
|
|
||||||
sequenceDiagram
|
|
||||||
participant Parent as 父页面
|
|
||||||
participant Iframe as DeerFlow iframe
|
|
||||||
participant API as Gateway /api/public/embed
|
|
||||||
|
|
||||||
Parent->>Parent: sessionId = crypto.randomUUID()
|
|
||||||
Parent->>Iframe: iframe src 含 sessionId、message、username、theme
|
|
||||||
Iframe->>Iframe: loginByUsername + 自动 sendMessage
|
|
||||||
Iframe->>API: POST /sessions { session_id, thread_id }
|
|
||||||
loop 每 1–3s
|
|
||||||
Parent->>API: GET /sessions/{sessionId}/status
|
|
||||||
API-->>Parent: registered, finished, thread_id
|
|
||||||
end
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 前端路由与页面
|
|
||||||
|
|
||||||
### 3.1 路由（独立于 `/page/*`）
|
|
||||||
|
|
||||||
在 `App.tsx` 注册，**不经过** `PageRoutes` / `PageSidebar`，因此无外层导航与 Workspace 侧栏。
|
|
||||||
|
|
||||||
| 路由 | 组件 | 说明 |
|
|
||||||
|------|------|------|
|
|
||||||
| `/embed/chats/:thread_id` | `EmbedChatPage`（外包 `ChatRuntime`） | `thread_id` 可为 `new` 或已有 UUID |
|
|
||||||
|
|
||||||
示例（HashRouter，注意 `#`）：
|
|
||||||
|
|
||||||
```
|
|
||||||
http://localhost:5173/#/embed/chats/new?sessionId=...&message=...&username=guest&theme=red
|
|
||||||
```
|
|
||||||
|
|
||||||
开发环境端口以本地 Vite 为准（如 5173 / 5174）。
|
|
||||||
|
|
||||||
### 3.2 URL 查询参数
|
|
||||||
|
|
||||||
| 参数 | 必填 | 说明 |
|
|
||||||
|------|------|------|
|
|
||||||
| `sessionId` 或 `session_id` | **是** | 父页面生成的关联 id，8–128 位，仅字母数字 `_` `-` |
|
|
||||||
| `message` / `question` / `text` | 建议 | 首条用户问题；有则进入后自动发送 |
|
|
||||||
| `username` / `userName` | 否 | 默认 `guest`，对应 `POST /api/v1/auth/login/username` |
|
|
||||||
| `theme` | 否 | `dark-blue` → 深色；`red` 等 → 浅色（与 `LoginPage` 一致） |
|
|
||||||
|
|
||||||
缺少 `sessionId` 时，嵌入页会提示错误，不会发起登记。
|
|
||||||
|
|
||||||
### 3.3 相关源码
|
|
||||||
|
|
||||||
| 路径 | 职责 |
|
|
||||||
|------|------|
|
|
||||||
| [src/pages/EmbedChatPage.tsx](../src/pages/EmbedChatPage.tsx) | 嵌入页：登录、自动发问、登记 session、仅消息列表 + ChatBox |
|
|
||||||
| [src/core/embed/params.ts](../src/core/embed/params.ts) | 从 URL 解析嵌入参数 |
|
|
||||||
| [src/core/embed/status-api.ts](../src/core/embed/status-api.ts) | 登记 / 轮询 API 封装 |
|
|
||||||
| [src/App.tsx](../src/App.tsx) | 路由注册 |
|
|
||||||
|
|
||||||
### 3.4 UI 行为说明
|
|
||||||
|
|
||||||
- **隐藏**：`PageSidebar`、`WorkspaceSidebar`、`InputBox`、顶栏标题栏等（相对完整 `ChatPage`）。
|
|
||||||
- **保留**：`MessageList`、流式指示、澄清卡片（若 agent 触发 `ask_clarification`）、右侧 **产物/沙箱**（`ChatBox` 内 60/40 分栏逻辑与主聊天一致）。
|
|
||||||
- **线程 id**：新建会话时客户端先分配 UUID，`onStart` 后 `history.replaceState` 更新 hash 为 `/embed/chats/{真实id}`（与主聊天 `ChatPage` 相同手法，避免整页重载）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. 公开 HTTP API（无需鉴权）
|
|
||||||
|
|
||||||
前缀：`/api/public/embed/`（走 Gateway，与 `VITE_BACKEND_BASE_URL` 一致，默认 `http://47.88.25.99:7001/`）。
|
|
||||||
|
|
||||||
CSRF / Auth 中间件对 `/api/public/` 放行；请求 **不需要** Cookie。
|
|
||||||
|
|
||||||
### 4.1 登记映射（iframe 内自动调用）
|
|
||||||
|
|
||||||
```http
|
|
||||||
POST /api/public/embed/sessions
|
|
||||||
Content-Type: application/json
|
|
||||||
|
|
||||||
{
|
|
||||||
"session_id": "parent-generated-uuid",
|
|
||||||
"thread_id": "e9c7d09e-821d-421f-ae24-e5ddfe0cff5b"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**响应：**
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"session_id": "parent-generated-uuid",
|
|
||||||
"thread_id": "e9c7d09e-821d-421f-ae24-e5ddfe0cff5b",
|
|
||||||
"registered": true
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
同一 `session_id` 再次 POST 会 **更新** `thread_id`（例如 `onStart` 后 id 变化）。
|
|
||||||
|
|
||||||
### 4.2 轮询状态（父页面使用）
|
|
||||||
|
|
||||||
```http
|
|
||||||
GET /api/public/embed/sessions/{session_id}/status
|
|
||||||
```
|
|
||||||
|
|
||||||
**尚未登记**（iframe 仍在加载或未 POST）：
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"session_id": "parent-generated-uuid",
|
|
||||||
"registered": false,
|
|
||||||
"thread_id": null,
|
|
||||||
"finished": false,
|
|
||||||
"thread_status": "pending",
|
|
||||||
"has_active_run": false,
|
|
||||||
"latest_run_status": null
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**已登记且问答进行中：**
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"session_id": "parent-generated-uuid",
|
|
||||||
"registered": true,
|
|
||||||
"thread_id": "e9c7d09e-821d-421f-ae24-e5ddfe0cff5b",
|
|
||||||
"finished": false,
|
|
||||||
"thread_status": "idle",
|
|
||||||
"has_active_run": true,
|
|
||||||
"latest_run_status": "running"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**已登记且已结束：**
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"session_id": "parent-generated-uuid",
|
|
||||||
"registered": true,
|
|
||||||
"thread_id": "e9c7d09e-821d-421f-ae24-e5ddfe0cff5b",
|
|
||||||
"finished": true,
|
|
||||||
"thread_status": "idle",
|
|
||||||
"has_active_run": false,
|
|
||||||
"latest_run_status": "success"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 字段说明
|
|
||||||
|
|
||||||
| 字段 | 含义 |
|
|
||||||
|------|------|
|
|
||||||
| `registered` | 是否已收到 iframe 的 POST 登记 |
|
|
||||||
| `finished` | **父页面应以此为准**：无 inflight run，且线程非 running/busy，且非 `interrupted`（澄清等待用户） |
|
|
||||||
| `thread_status` | 从 checkpoint 推导：`idle` / `interrupted` / `error` 等 |
|
|
||||||
| `has_active_run` | 是否存在 pending/running 的 LangGraph run |
|
|
||||||
| `latest_run_status` | 该线程最近一次 run 的状态：`success` / `error` / … |
|
|
||||||
| `thread_id` | 解析出的 DeerFlow 线程 id（父页面可选用，非必须） |
|
|
||||||
|
|
||||||
### 4.3 获取生成结果（父页面使用）
|
|
||||||
|
|
||||||
问答结束后（建议先确认 `finished === true`），拉取本次模型输出：
|
|
||||||
|
|
||||||
```http
|
|
||||||
GET /api/public/embed/sessions/{session_id}/result
|
|
||||||
```
|
|
||||||
|
|
||||||
**尚未登记：**
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"session_id": "parent-generated-uuid",
|
|
||||||
"registered": false,
|
|
||||||
"thread_id": null,
|
|
||||||
"finished": false,
|
|
||||||
"thread_status": "pending",
|
|
||||||
"has_active_run": false,
|
|
||||||
"latest_run_status": null,
|
|
||||||
"messages": [],
|
|
||||||
"generated_text": "",
|
|
||||||
"generated_files": []
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**已登记且已有内容：**
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"session_id": "parent-generated-uuid",
|
|
||||||
"registered": true,
|
|
||||||
"thread_id": "e9c7d09e-821d-421f-ae24-e5ddfe0cff5b",
|
|
||||||
"finished": true,
|
|
||||||
"thread_status": "idle",
|
|
||||||
"has_active_run": false,
|
|
||||||
"latest_run_status": "success",
|
|
||||||
"messages": [
|
|
||||||
{ "type": "human", "content": "请总结要点", "id": "..." },
|
|
||||||
{ "type": "ai", "content": "根据分析，要点如下：...", "id": "..." }
|
|
||||||
],
|
|
||||||
"generated_text": "根据分析，要点如下：...",
|
|
||||||
"generated_files": [
|
|
||||||
"/mnt/user-data/outputs/summary.md",
|
|
||||||
"/mnt/user-data/outputs/chart.png"
|
|
||||||
]
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 结果字段说明
|
|
||||||
|
|
||||||
| 字段 | 含义 |
|
|
||||||
|------|------|
|
|
||||||
| `messages` | 完整消息列表（与 checkpoint 中序列化结构一致，含 human / ai / tool 等） |
|
|
||||||
| `generated_text` | 所有 `ai` / `assistant` 消息正文按顺序拼接（段落间空一行） |
|
|
||||||
| `generated_files` | 本次会话产物的虚拟路径列表（与 UI 产物栏 `artifacts` 一致） |
|
|
||||||
|
|
||||||
未结束时也可调用，会返回当前已有内容；`finished` 仍为 false 表示可能还会继续生成。
|
|
||||||
|
|
||||||
### 4.4 按 thread_id 查询（可选）
|
|
||||||
|
|
||||||
调试或父页面已持有 thread_id 时：
|
|
||||||
|
|
||||||
```http
|
|
||||||
GET /api/public/embed/threads/{thread_id}/status
|
|
||||||
GET /api/public/embed/threads/{thread_id}/result
|
|
||||||
```
|
|
||||||
|
|
||||||
状态接口响应不含 `messages` / `generated_text` / `generated_files`；结果接口字段与 §4.3 相同（无 `session_id` / `registered`）。
|
|
||||||
|
|
||||||
### 4.5 前端封装
|
|
||||||
|
|
||||||
```ts
|
|
||||||
import {
|
|
||||||
getEmbedSessionResult,
|
|
||||||
getEmbedSessionStatus,
|
|
||||||
registerEmbedSession,
|
|
||||||
} from "@/core/embed/status-api";
|
|
||||||
|
|
||||||
// 父页面（或你们自己的脚本）
|
|
||||||
const status = await getEmbedSessionStatus(sessionId);
|
|
||||||
if (status.registered && status.finished) {
|
|
||||||
const result = await getEmbedSessionResult(sessionId);
|
|
||||||
console.log(result.generated_text, result.generated_files);
|
|
||||||
}
|
|
||||||
|
|
||||||
// 仅 iframe 内需要
|
|
||||||
await registerEmbedSession(sessionId, threadId);
|
|
||||||
```
|
|
||||||
|
|
||||||
`fetch` 使用 `credentials: "omit"`，不携带 DeerFlow 会话。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5. 父页面集成示例
|
|
||||||
|
|
||||||
### 5.1 拼接 iframe
|
|
||||||
|
|
||||||
```html
|
|
||||||
<iframe
|
|
||||||
id="deerflow-embed"
|
|
||||||
title="DeerFlow 问答"
|
|
||||||
style="width:100%;height:600px;border:0"
|
|
||||||
></iframe>
|
|
||||||
```
|
|
||||||
|
|
||||||
```javascript
|
|
||||||
const sessionId = crypto.randomUUID();
|
|
||||||
const base = "http://localhost:5173"; // 换成你们部署的前端 origin
|
|
||||||
const params = new URLSearchParams({
|
|
||||||
sessionId,
|
|
||||||
message: "请根据附件总结要点",
|
|
||||||
username: "guest",
|
|
||||||
theme: "red",
|
|
||||||
});
|
|
||||||
document.getElementById("deerflow-embed").src =
|
|
||||||
`${base}/#/embed/chats/new?${params.toString()}`;
|
|
||||||
```
|
|
||||||
|
|
||||||
### 5.2 轮询直到结束
|
|
||||||
|
|
||||||
```javascript
|
|
||||||
const API = "http://47.88.25.99:7001/"; // VITE_BACKEND_BASE_URL
|
|
||||||
|
|
||||||
async function pollUntilFinished(sessionId) {
|
|
||||||
const res = await fetch(
|
|
||||||
`${API}/api/public/embed/sessions/${encodeURIComponent(sessionId)}/status`,
|
|
||||||
{ credentials: "omit" },
|
|
||||||
);
|
|
||||||
if (!res.ok) throw new Error(`status HTTP ${res.status}`);
|
|
||||||
const data = await res.json();
|
|
||||||
if (!data.registered) return { done: false, reason: "pending" };
|
|
||||||
if (data.finished) return { done: true, data };
|
|
||||||
return { done: false, reason: "running" };
|
|
||||||
}
|
|
||||||
|
|
||||||
const timer = setInterval(async () => {
|
|
||||||
try {
|
|
||||||
const poll = await pollUntilFinished(sessionId);
|
|
||||||
if (poll.done) {
|
|
||||||
clearInterval(timer);
|
|
||||||
const output = await fetch(
|
|
||||||
`${API}/api/public/embed/sessions/${encodeURIComponent(sessionId)}/result`,
|
|
||||||
{ credentials: "omit" },
|
|
||||||
).then((r) => r.json());
|
|
||||||
console.log("问答已结束", output.generated_text, output.generated_files);
|
|
||||||
}
|
|
||||||
} catch (e) {
|
|
||||||
console.error(e);
|
|
||||||
}
|
|
||||||
}, 2000);
|
|
||||||
```
|
|
||||||
|
|
||||||
### 5.3 跨域注意
|
|
||||||
|
|
||||||
父页面从浏览器 `fetch` Gateway（如 `http://47.88.25.99:7001/`）时，**Origin 必须是后端 CORS 白名单里的完整地址**（含协议、主机、端口），与 API 地址是否写 `localhost` / `127.0.0.1` 无关。
|
|
||||||
|
|
||||||
**本地开发**（前端默认 `5174`）请在 Gateway 环境变量中配置：
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# offline-backend-20260512/.env 或启动脚本注入
|
|
||||||
GATEWAY_CORS_ORIGINS=http://localhost:5174,http://127.0.0.1:5174,http://localhost:5173,http://127.0.0.1:5173
|
|
||||||
```
|
|
||||||
|
|
||||||
修改后**重启 Gateway**（`make dev` / `make gateway`）。若父页面部署在其它域名，把该域名的 origin 一并加入逗号分隔列表。
|
|
||||||
|
|
||||||
临时调试（勿用于公网生产）：
|
|
||||||
|
|
||||||
```bash
|
|
||||||
GATEWAY_CORS_ALLOW_ALL=1
|
|
||||||
```
|
|
||||||
|
|
||||||
常见报错：`No 'Access-Control-Allow-Origin' header` → 当前页面的 origin 未出现在 `GATEWAY_CORS_ORIGINS` 中。
|
|
||||||
|
|
||||||
### 5.4 其它部署注意
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 6. 部署与数据库
|
|
||||||
|
|
||||||
1. **跑迁移**（SQL 持久化后端）：
|
|
||||||
|
|
||||||
```bash
|
|
||||||
cd offline-backend-20260512/backend
|
|
||||||
# 按项目惯例执行 alembic upgrade head
|
|
||||||
```
|
|
||||||
|
|
||||||
表：`embed_sessions(session_id PK, thread_id, created_at, updated_at)`。
|
|
||||||
|
|
||||||
2. **重启 Gateway**，确认路由已挂载：`public_embed.router`（`app/gateway/app.py`）。
|
|
||||||
|
|
||||||
3. **前端构建** 后，将嵌入地址配给第三方；`VITE_BACKEND_BASE_URL` 指向可达的 Gateway。
|
|
||||||
|
|
||||||
无 SQL 时开发环境会退化为 **内存** `MemoryEmbedSessionStore`（进程重启后映射丢失）；生产请使用持久化库。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 7. 安全说明
|
|
||||||
|
|
||||||
- `sessionId` 与 `thread_id` 均视为 **不透明能力令牌**：知晓即可查询状态（公开 API **无登录**）。
|
|
||||||
- 建议：父系统自行生成不可猜测的 UUID；敏感场景在贵司 API 网关再加鉴权或 IP 限制。
|
|
||||||
- 登记接口为 **POST upsert**，不校验「session 是否属于某租户」——若需多租户隔离，请在业务层约定 `sessionId` 命名空间或增加网关校验。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 8. 与主聊天 `/page/workspace/chats` 的差异
|
|
||||||
|
|
||||||
| 项目 | 主聊天 | iframe 嵌入 |
|
|
||||||
|------|--------|-------------|
|
|
||||||
| 路由 | `/page/workspace/chats/:id` | `/embed/chats/:id` |
|
|
||||||
| 布局 | 完整 Workspace + 输入框 | 仅消息区 + 产物栏 |
|
|
||||||
| 登录 | 常规登录流 | URL `username` 自动 `login/username` |
|
|
||||||
| 首条消息 | 用户输入 | URL `message` 自动发送 |
|
|
||||||
| 完成态查询 | 无公开 API | `sessionId` + `/api/public/embed/sessions/.../status` |
|
|
||||||
|
|
||||||
能力上仍走同一 `useThreadStream` + `lead_agent` 流式链路，沙箱与产物行为与主聊天一致。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 9. 常见问题
|
|
||||||
|
|
||||||
**Q：`registered` 一直为 false？**
|
|
||||||
A：检查 iframe URL 是否带 `sessionId`；子页是否登录成功；Network 里是否有 `POST /api/public/embed/sessions` 且 200。
|
|
||||||
|
|
||||||
**Q：`finished` 一直 false？**
|
|
||||||
A：可能仍在流式生成（`has_active_run: true`），或 agent 进入澄清（`thread_status: interrupted`）。嵌入模式无底部输入框，澄清需产品侧另行处理或避免触发澄清类工具。
|
|
||||||
|
|
||||||
**Q：父页面能否不用轮询？**
|
|
||||||
A：当前标准方案为公开 GET 轮询。若同源可考虑 `postMessage` 扩展（未默认实现）。
|
|
||||||
|
|
||||||
**Q：能否继续用已有 thread_id 嵌入？**
|
|
||||||
A：可以：`#/embed/chats/{thread_id}?sessionId=...`，可选再带 `message` 追加一轮；登记会在已知 id 上 upsert。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 10. 变更记录
|
|
||||||
|
|
||||||
| 日期 | 说明 |
|
|
||||||
|------|------|
|
|
||||||
| 2026-06-02 | 初版：iframe 嵌入路由、`sessionId` 映射表、公开登记与状态 API |
|
|
||||||
| 2026-06-02 | 新增 `GET /sessions/{session_id}/result`：返回 messages、generated_text、generated_files |
|
|
||||||
@@ -1,154 +0,0 @@
|
|||||||
# 公开页 · iframe 嵌入外观对接说明（主题 / 背景色）
|
|
||||||
|
|
||||||
本文档面向**嵌入方（宿主系统）**，说明如何在用 `<iframe>` 嵌入 DeerFlow 公开页时，从外部控制页面的**整体明暗主题（light/dark）**与**背景色 / 文字色**，使其与宿主站点的视觉风格保持一致。
|
|
||||||
|
|
||||||
前端实现见：`src/core/embed/background.ts`（参数解析与 postMessage 监听）、`src/App.tsx`（主题接入 `forcedTheme`）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 0. 速读
|
|
||||||
|
|
||||||
| 想做什么 | 怎么做 |
|
|
||||||
|----------|--------|
|
|
||||||
| 嵌入时指定深色主题 | iframe `src` 加 `?theme=dark` |
|
|
||||||
| 嵌入时指定背景/文字色 | iframe `src` 加 `?bg=%23001529&text=%23ffffff`（`#` 需编码为 `%23`） |
|
|
||||||
| 宿主切主题时同步切换 | `postMessage({ type: "deerflow:set-theme", theme: "dark" }, "*")` |
|
|
||||||
| 宿主动态改背景色 | `postMessage({ type: "deerflow:set-bg", bg: "#001529", text: "#fff" }, "*")` |
|
|
||||||
| 什么都不传 | 页面使用 DeerFlow 自带默认配色，互不影响 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 适用页面
|
|
||||||
|
|
||||||
以下公开页（免登录、只读）均支持本文档的全部参数：
|
|
||||||
|
|
||||||
| 页面 | 路由 |
|
|
||||||
|------|------|
|
|
||||||
| 会话分享页 | `/#/share/{shareCode}` |
|
|
||||||
| 圆桌分享页 | `/#/roundtable-share/{shareCode}`、`/#/roundtable-share/{shareCode}/report` |
|
|
||||||
| 用户排行榜 | `/#/public/leaderboard` |
|
|
||||||
| 定时任务公开页 | `/#/public/scheduled-tasks/{taskId}`（含 `/runs/{runId}/fullscreen` 全屏页） |
|
|
||||||
|
|
||||||
> 注意：站点使用 **hash 路由**，路径在 `#` 之后。
|
|
||||||
> 嵌入聊天页（`/#/embed/chats/*`、`/#/embed/roundtable`）有自己的主题约定，见 `embed-iframe-chat.md`，不在本文范围内。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. URL 查询参数（嵌入时一次性指定）
|
|
||||||
|
|
||||||
### 2.1 参数列表
|
|
||||||
|
|
||||||
| 参数 | 别名 | 作用 | 合法值 |
|
|
||||||
|------|------|------|--------|
|
|
||||||
| `theme` | — | 切整体明暗主题 | 见 2.2 取值映射表 |
|
|
||||||
| `bg` | `background` | 页面根容器背景色 | 见 2.3 颜色格式 |
|
|
||||||
| `text` | `fg` | 页面根容器文字色 | 见 2.3 颜色格式 |
|
|
||||||
|
|
||||||
三个参数相互独立，可任意组合；不传或传非法值时该项忽略、沿用默认。
|
|
||||||
|
|
||||||
### 2.2 `theme` 取值映射
|
|
||||||
|
|
||||||
| 传入值（不区分大小写） | 实际主题 |
|
|
||||||
|------|------|
|
|
||||||
| `dark`、`dark-blue`、`深蓝`、`深色` | 深色 |
|
|
||||||
| `light`、`red`、`红白`、`浅色` | 浅色 |
|
|
||||||
| 其他 / 不传 | 忽略，沿用站内默认（浅色） |
|
|
||||||
|
|
||||||
### 2.3 颜色格式（`bg` / `text`）
|
|
||||||
|
|
||||||
颜色值经过白名单校验，仅接受以下写法，其余一律丢弃（防注入）：
|
|
||||||
|
|
||||||
- **hex**：`#fff`、`#ffffffcc` 等 3/4/6/8 位（`#` 可省略；URL 里 `#` 必须编码为 `%23`）
|
|
||||||
- **函数式**：`rgb()` / `rgba()` / `hsl()` / `hsla()`，括号内仅允许数字、逗号、百分号、空格、`/`
|
|
||||||
- **命名色**：纯英文字母，如 `white`、`transparent`
|
|
||||||
|
|
||||||
### 2.4 参数位置
|
|
||||||
|
|
||||||
参数放在 hash 路由之后（推荐）或 `#` 之前都能识别；两处都传时**hash 路由内的优先**：
|
|
||||||
|
|
||||||
```
|
|
||||||
https://<host>/#/public/leaderboard?theme=dark ← 推荐
|
|
||||||
https://<host>/?theme=dark#/public/leaderboard ← 也支持
|
|
||||||
```
|
|
||||||
|
|
||||||
### 2.5 示例
|
|
||||||
|
|
||||||
```html
|
|
||||||
<!-- 深色主题 -->
|
|
||||||
<iframe src="https://<host>/#/public/leaderboard?theme=dark"></iframe>
|
|
||||||
|
|
||||||
<!-- 浅色主题 + 自定义背景与文字色（# 编码为 %23） -->
|
|
||||||
<iframe src="https://<host>/#/share/Ab3xYz?theme=light&bg=%23f5f7fa&text=%23333333"></iframe>
|
|
||||||
|
|
||||||
<!-- 主题与背景叠加：整页走深色变量，根背景用宿主品牌色 -->
|
|
||||||
<iframe src="https://<host>/#/roundtable-share/Ab3xYz?theme=dark&bg=%23001529"></iframe>
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. postMessage（嵌入后动态切换）
|
|
||||||
|
|
||||||
适用于宿主站点支持用户切主题、需要 iframe 实时跟随的场景。向 iframe 的 `contentWindow` 发消息即可，**无需等待子页面回执**（监听器在应用挂载时注册）。
|
|
||||||
|
|
||||||
### 3.1 消息格式
|
|
||||||
|
|
||||||
```js
|
|
||||||
const frame = document.getElementById("deerflow-frame");
|
|
||||||
|
|
||||||
// 切整体明暗主题（theme 取值同 2.2）
|
|
||||||
frame.contentWindow.postMessage({ type: "deerflow:set-theme", theme: "dark" }, "*");
|
|
||||||
|
|
||||||
// 改背景色 / 文字色（字段名与 URL 参数一致，bg/background、text/fg 均可）
|
|
||||||
frame.contentWindow.postMessage({ type: "deerflow:set-bg", bg: "#001529", text: "#fff" }, "*");
|
|
||||||
// 兼容别名：type 也可写 "deerflow:set-background"
|
|
||||||
```
|
|
||||||
|
|
||||||
说明：
|
|
||||||
|
|
||||||
- 两类消息相互独立，可只发其一；`set-bg` 里 `bg`、`text` 也可只传其一，未传的字段保持当前值。
|
|
||||||
- 非法颜色值 / 不认识的 `theme` 取值会被忽略，不会清空已有设置。
|
|
||||||
- targetOrigin 建议按需收紧（写 DeerFlow 站点的 origin 而非 `"*"`）。
|
|
||||||
|
|
||||||
### 3.2 宿主主题联动示例
|
|
||||||
|
|
||||||
```js
|
|
||||||
function syncDeerflowTheme(isDark) {
|
|
||||||
const win = document.getElementById("deerflow-frame").contentWindow;
|
|
||||||
win.postMessage({ type: "deerflow:set-theme", theme: isDark ? "dark" : "light" }, "*");
|
|
||||||
win.postMessage(
|
|
||||||
{ type: "deerflow:set-bg", bg: isDark ? "#001529" : "#ffffff" },
|
|
||||||
"*",
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
// iframe 首次加载用 URL 参数兜底，之后切换走 postMessage
|
|
||||||
myThemeStore.subscribe((theme) => syncDeerflowTheme(theme === "dark"));
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. 优先级与默认行为
|
|
||||||
|
|
||||||
同一项配置多处传入时，按以下优先级取值（高 → 低）：
|
|
||||||
|
|
||||||
1. **postMessage** 动态设置的值
|
|
||||||
2. hash 路由内的 URL 参数（`#/路由?theme=...`）
|
|
||||||
3. `#` 之前的 URL 参数（`?theme=...#/路由`）
|
|
||||||
4. 都没传 → DeerFlow 默认配色（浅色主题 + 页面自带 Tailwind 配色）
|
|
||||||
|
|
||||||
其他保证：
|
|
||||||
|
|
||||||
- 外部主题只影响**当前 iframe 的渲染**，不写 localStorage——不会污染用户直接访问 DeerFlow 主站时自己选择的主题。
|
|
||||||
- `bg`/`text` 是内联样式，作用在页面根容器上，优先级高于主题变量；与 `theme` 叠加时以 `bg`/`text` 为准。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5. 常见问题排查
|
|
||||||
|
|
||||||
| 现象 | 排查 |
|
|
||||||
|------|------|
|
|
||||||
| `theme=dark` 不生效 | 确认路由属于第 1 节列出的公开页；确认参数拼在 hash 路由后（`/#/share/xx?theme=dark`），而不是写成了 `/#/share/xx#theme=dark` |
|
|
||||||
| `bg=#fff` 不生效 | URL 里 `#` 没编码会被浏览器截断，必须写 `%23fff`；或直接省略 `#` 写 `bg=fff` |
|
|
||||||
| postMessage 无反应 | 确认消息体是对象且 `type` 拼写为 `deerflow:set-theme` / `deerflow:set-bg`；确认在 iframe `load` 之后发送 |
|
|
||||||
| 颜色被忽略 | 检查是否符合 2.3 白名单格式（如 `linear-gradient(...)` 等复杂值不支持） |
|
|
||||||
| 主题切了但个别区域颜色没变 | 该区域可能使用了固定配色；把页面路由与截图反馈给 DeerFlow 维护方补充 `dark:` 样式 |
|
|
||||||
@@ -1,975 +0,0 @@
|
|||||||
# DeerFlow 前端开发文档
|
|
||||||
|
|
||||||
## 目录
|
|
||||||
|
|
||||||
1. [整体目录结构](#1-整体目录结构)
|
|
||||||
2. [路由结构](#2-路由结构)
|
|
||||||
3. [核心数据流与状态管理](#3-核心数据流与状态管理)
|
|
||||||
4. [主要页面组件](#4-主要页面组件)
|
|
||||||
5. [核心业务组件](#5-核心业务组件)
|
|
||||||
6. [核心 Hooks 与工具函数](#6-核心-hooks-与工具函数)
|
|
||||||
7. [API 调用层](#7-api-调用层)
|
|
||||||
8. [国际化机制](#8-国际化机制)
|
|
||||||
9. [主题与样式体系](#9-主题与样式体系)
|
|
||||||
10. [关键业务流程](#10-关键业务流程)
|
|
||||||
11. [项目配置与依赖](#11-项目配置与依赖)
|
|
||||||
12. [常见开发模式](#12-常见开发模式)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 整体目录结构
|
|
||||||
|
|
||||||
```
|
|
||||||
frontend-web/src/
|
|
||||||
├── App.tsx # 应用入口，顶层路由 + Provider
|
|
||||||
├── env.ts # 环境变量类型定义
|
|
||||||
├── pages/ # 路由级页面组件
|
|
||||||
│ ├── PageRoutes.tsx # /page/* 根路由容器（含外部系统预留位）
|
|
||||||
│ ├── WorkspaceRoutes.tsx # /page/workspace/* 工作区路由
|
|
||||||
│ ├── LoginPage.tsx # 登录页
|
|
||||||
│ ├── LandingPage.tsx # 营销落地页（强制 dark 主题）
|
|
||||||
│ ├── ChatsPage.tsx # 对话列表
|
|
||||||
│ ├── ChatPage.tsx # 单条对话（核心页面）
|
|
||||||
│ ├── AgentsPage.tsx # 智能体库
|
|
||||||
│ ├── AgentChatPage.tsx # 与智能体对话
|
|
||||||
│ ├── NewAgentPage.tsx # 创建智能体（两步流程）
|
|
||||||
│ ├── ScheduledTasksPage.tsx # 定时任务管理
|
|
||||||
│ ├── ScheduledTaskRunDetailPage.tsx # 定时任务执行详情
|
|
||||||
│ ├── ScheduledChatPage.tsx # 定时任务对话跳转页
|
|
||||||
│ └── NotFoundPage.tsx # 404 页面
|
|
||||||
├── components/ # 业务组件库
|
|
||||||
│ ├── ui/ # shadcn/ui 基础组件（Button、Card、Dialog 等 40+）
|
|
||||||
│ ├── ai-elements/ # AI 交互可视化组件
|
|
||||||
│ │ ├── prompt-input/ # 输入框 Context + 子组件系统
|
|
||||||
│ │ ├── artifact.tsx # 制品展示
|
|
||||||
│ │ ├── canvas.tsx
|
|
||||||
│ │ ├── conversation.tsx # 虚拟滚动对话容器
|
|
||||||
│ │ ├── message.tsx
|
|
||||||
│ │ ├── model-selector.tsx
|
|
||||||
│ │ ├── code-block.tsx
|
|
||||||
│ │ └── shimmer.tsx
|
|
||||||
│ ├── workspace/ # 工作区业务组件（详见第 5 节）
|
|
||||||
│ └── landing/ # 落地页组件
|
|
||||||
├── core/ # 核心业务逻辑层（非 UI）
|
|
||||||
│ ├── api/ # API 客户端（LangGraph SDK + Fetch）
|
|
||||||
│ ├── auth/ # 认证管理
|
|
||||||
│ ├── config/ # 环境配置 & Base URL
|
|
||||||
│ ├── i18n/ # 国际化（上下文、翻译文件、语言检测）
|
|
||||||
│ ├── threads/ # 对话线程管理（最核心）
|
|
||||||
│ ├── agents/ # 智能体 CRUD
|
|
||||||
│ ├── models/ # 模型列表
|
|
||||||
│ ├── settings/ # 本地设置（LocalStorage 发布订阅）
|
|
||||||
│ ├── uploads/ # 文件上传
|
|
||||||
│ ├── artifacts/ # 制品管理
|
|
||||||
│ ├── memory/ # 用户记忆
|
|
||||||
│ ├── skills/ # 技能管理
|
|
||||||
│ ├── scheduled-tasks/ # 定时任务
|
|
||||||
│ ├── messages/ # 消息处理工具函数
|
|
||||||
│ ├── tasks/ # 子任务 Context
|
|
||||||
│ ├── notification/ # 系统通知
|
|
||||||
│ └── utils/ # 通用工具（文件下载、日期格式化等）
|
|
||||||
└── hooks/ # 全局自定义 hooks
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 路由结构
|
|
||||||
|
|
||||||
> 项目使用 **HashRouter**，所有路由访问形如 `http://host/#/xxx`
|
|
||||||
|
|
||||||
### 2.1 App.tsx 顶层路由
|
|
||||||
|
|
||||||
| 路径 | 组件 | 说明 |
|
|
||||||
|------|------|------|
|
|
||||||
| `/` | Navigate | 重定向到 `/login` |
|
|
||||||
| `/login` | LoginPage | 登录（自动登录，无表单） |
|
|
||||||
| `/login/:username` | LoginPage | 带用户名登录 |
|
|
||||||
| `/landing` | LandingPage | 营销落地页（固定 dark 主题） |
|
|
||||||
| `/page/*` | PageRoutes | 应用内容根容器 |
|
|
||||||
| `*` | NotFoundPage | 404 |
|
|
||||||
|
|
||||||
### 2.2 PageRoutes.tsx（`/page/*`）
|
|
||||||
|
|
||||||
```
|
|
||||||
/page/
|
|
||||||
├── index → Navigate to "workspace"
|
|
||||||
├── workspace/* → WorkspaceRoutes
|
|
||||||
└── [TODO 预留] → 外部系统路由挂载位置
|
|
||||||
```
|
|
||||||
|
|
||||||
### 2.3 WorkspaceRoutes.tsx（`/page/workspace/*`）
|
|
||||||
|
|
||||||
| 路径 | 页面组件 | 布局包裹 |
|
|
||||||
|------|---------|--------|
|
|
||||||
| `index` | Navigate → `chats/new` | - |
|
|
||||||
| `chats` | ChatsPage | WorkspaceLayout |
|
|
||||||
| `chats/:thread_id` | ChatPage | WorkspaceLayout + ChatRuntime |
|
|
||||||
| `agents` | AgentsPage | WorkspaceLayout |
|
|
||||||
| `agents/new` | NewAgentPage | WorkspaceLayout |
|
|
||||||
| `agents/:agent_id/chats` | Navigate → `/page/workspace/agents` | - |
|
|
||||||
| `agents/:agent_id/chats/:thread_id` | AgentChatPage | WorkspaceLayout + ChatRuntime |
|
|
||||||
| `scheduled` | Navigate → `.../scheduled/tasks` | - |
|
|
||||||
| `scheduled/tasks` | ScheduledTasksPage | WorkspaceLayout |
|
|
||||||
| `scheduled/runs/:run_id` | ScheduledTaskRunDetailPage | WorkspaceLayout |
|
|
||||||
|
|
||||||
### 2.4 布局 Provider 层级结构
|
|
||||||
|
|
||||||
```
|
|
||||||
WorkspaceLayout
|
|
||||||
├── SidebarProvider（侧边栏展开/收起状态）
|
|
||||||
│ ├── WorkspaceSidebar
|
|
||||||
│ │ ├── WorkspaceHeader（Logo、新建按钮）
|
|
||||||
│ │ ├── WorkspaceNavChatList（Chats / Agents / Scheduled 导航）
|
|
||||||
│ │ ├── RecentChatList（最近会话列表）
|
|
||||||
│ │ └── WorkspaceNavMenu（Settings / About / GitHub）
|
|
||||||
│ ├── SidebarInset（主内容区）
|
|
||||||
│ │ └── [Page Content]
|
|
||||||
│ ├── CommandPalette（快捷命令面板）
|
|
||||||
│ └── Toaster（全局通知）
|
|
||||||
|
|
||||||
ChatRuntime（仅 ChatPage / AgentChatPage 使用）
|
|
||||||
├── SubtasksProvider（子任务执行状态）
|
|
||||||
├── ArtifactsProvider（制品选中/打开状态）
|
|
||||||
└── PromptInputProvider（输入框内容/附件状态）
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 核心数据流与状态管理
|
|
||||||
|
|
||||||
### 3.1 全局 Provider 架构
|
|
||||||
|
|
||||||
```
|
|
||||||
App
|
|
||||||
└── HashRouter
|
|
||||||
└── AppProviders（useLocation 驱动主题判断）
|
|
||||||
├── NextThemesProvider
|
|
||||||
│ └── attribute="class"，/landing 强制 forcedTheme="dark"
|
|
||||||
├── I18nProvider
|
|
||||||
│ └── initialLocale = detectLocale()（从 cookie 或浏览器语言）
|
|
||||||
└── QueryClientProvider（TanStack React Query 全局缓存）
|
|
||||||
```
|
|
||||||
|
|
||||||
### 3.2 全局 Context 列表
|
|
||||||
|
|
||||||
| Context | 文件 | 职责 | 消费 Hook |
|
|
||||||
|---------|------|------|-----------|
|
|
||||||
| `I18nContext` | `core/i18n/context.tsx` | 当前语言 + 翻译对象 | `useI18n()` |
|
|
||||||
| `SubtaskContext` | `core/tasks/context.tsx` | 实时子任务执行状态 | `useSubtaskContext()` |
|
|
||||||
| `ArtifactsContext` | `components/workspace/artifacts/context.tsx` | 制品选中/面板开关 | `useArtifacts()` |
|
|
||||||
| `PromptInputContext` | `components/ai-elements/prompt-input/` | 输入框内容、附件列表 | `usePromptInputController()` |
|
|
||||||
| `ThreadContext` | `components/workspace/messages/context.tsx` | 当前 thread 对象下传 | 直接读 context.thread |
|
|
||||||
|
|
||||||
### 3.3 LocalStorage 数据
|
|
||||||
|
|
||||||
**操作层：** `core/settings/store.ts`（发布-订阅，`useSyncExternalStore` 驱动响应式）
|
|
||||||
|
|
||||||
| Key | 内容 |
|
|
||||||
|-----|------|
|
|
||||||
| `deerflow.auth` | `{ access_token, token_type, user_id, email }` |
|
|
||||||
| `deerflow.local-settings` | `{ notification, context: { model_name, mode, reasoning_effort } }` |
|
|
||||||
| `deerflow.thread-model.{threadId}` | 每条线程的模型覆盖 |
|
|
||||||
|
|
||||||
### 3.4 SessionStorage 数据
|
|
||||||
|
|
||||||
| Key | 内容 |
|
|
||||||
|-----|------|
|
|
||||||
| `deerflow.run-id.{threadId}` | WebSocket run_id，用于断线重连 |
|
|
||||||
|
|
||||||
### 3.5 React Query 缓存 Key
|
|
||||||
|
|
||||||
| Query Key | 数据 |
|
|
||||||
|-----------|------|
|
|
||||||
| `["threads"]` | 线程列表 |
|
|
||||||
| `["thread", threadId]` | 单条线程 |
|
|
||||||
| `["agents"]` | 智能体列表 |
|
|
||||||
| `["models"]` | 模型列表 |
|
|
||||||
| `["skills"]` | 技能列表 |
|
|
||||||
| `["memory"]` | 用户记忆 |
|
|
||||||
| `["scheduled-tasks"]` | 定时任务列表 |
|
|
||||||
| `["scheduled-runs", taskId]` | 任务执行记录 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. 主要页面组件
|
|
||||||
|
|
||||||
### 4.1 ChatPage.tsx — 单条对话页面
|
|
||||||
|
|
||||||
**职责：** 管理单条聊天线程的完整交互，包括消息流、输入、工具调用展示、制品等。
|
|
||||||
|
|
||||||
**关键状态：**
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
const [threadId, setThreadId] = useState(routeThreadId || uuid());
|
|
||||||
const [isNewThread, setIsNewThread] = useState(!routeThreadId || routeThreadId === "new");
|
|
||||||
const [hasStartedConversation, setHasStartedConversation] = useState(false);
|
|
||||||
const [showFollowups, setShowFollowups] = useState(false);
|
|
||||||
const [settings, setSettings] = useThreadSettings(threadId);
|
|
||||||
```
|
|
||||||
|
|
||||||
**核心 Hook：**
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
const [thread, sendMessage, isUploading] = useThreadStream({
|
|
||||||
threadId: isNewThread ? undefined : threadId,
|
|
||||||
context: settings.context,
|
|
||||||
onStart: (createdThreadId) => {
|
|
||||||
setThreadId(createdThreadId);
|
|
||||||
setIsNewThread(false);
|
|
||||||
// 不刷新页面，直接更新 URL hash
|
|
||||||
history.replaceState(null, "", `...#/page/workspace/chats/${createdThreadId}`);
|
|
||||||
},
|
|
||||||
onFinish: (state) => {
|
|
||||||
// 后台通知
|
|
||||||
showNotification(state.title, { body: lastMessageText });
|
|
||||||
}
|
|
||||||
});
|
|
||||||
```
|
|
||||||
|
|
||||||
**主要子组件：**
|
|
||||||
|
|
||||||
| 组件 | 职责 |
|
|
||||||
|------|------|
|
|
||||||
| `<MessageList>` | 消息渲染（含工具调用、子任务、制品） |
|
|
||||||
| `<Welcome>` | 新对话欢迎屏 |
|
|
||||||
| `<InputBox>` | 输入框（模式选择、附件、发送） |
|
|
||||||
| `<ThreadTitle>` | 线程标题（自动生成后同步更新） |
|
|
||||||
| `<ExportTrigger>` | 导出对话按钮 |
|
|
||||||
| `<ArtifactTrigger>` | 制品面板开关 |
|
|
||||||
| `<TokenUsageIndicator>` | Token 用量展示（可选） |
|
|
||||||
| `<TodoList>` | 任务清单 |
|
|
||||||
| `<Suggestions>` | 追问建议 |
|
|
||||||
|
|
||||||
**数据流：**
|
|
||||||
|
|
||||||
```
|
|
||||||
用户输入 (InputBox)
|
|
||||||
↓ handleSubmit(message: PromptInputMessage)
|
|
||||||
↓ sendMessage(threadId, message)
|
|
||||||
↓ [内部] 上传文件 → 提交到 LangGraph API
|
|
||||||
↓ WebSocket 流返回消息
|
|
||||||
↓ thread.messages 更新 → MessageList 重渲染
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 4.2 AgentChatPage.tsx — 与智能体对话
|
|
||||||
|
|
||||||
与 ChatPage 结构基本一致，差异点：
|
|
||||||
|
|
||||||
- 从路由获取 `agent_id`，传入 `useThreadStream({ assistantId: agent_id })`
|
|
||||||
- Header 展示智能体名称 Badge
|
|
||||||
- "新建对话"跳转到 `/page/workspace/agents/${agent_id}/chats/new`
|
|
||||||
- URL 更新为 `#/page/workspace/agents/${agent_id}/chats/${threadId}`
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 4.3 NewAgentPage.tsx — 创建智能体（两步流程）
|
|
||||||
|
|
||||||
**Step 1：name（命名 + 选技能）**
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
// 自动预选前 3 个启用的技能
|
|
||||||
useEffect(() => {
|
|
||||||
if (!isSkillSelectionTouched) {
|
|
||||||
setSelectedSkills(enabledSkills.slice(0, 3).map(s => s.name));
|
|
||||||
}
|
|
||||||
}, [enabledSkills]);
|
|
||||||
|
|
||||||
// 提交：验证名称 → 创建智能体
|
|
||||||
await checkAgentName(name); // 检查重名
|
|
||||||
await createAgent(request); // 创建，返回 agent.id
|
|
||||||
setStep("chat"); // 进入 Step 2
|
|
||||||
```
|
|
||||||
|
|
||||||
**Step 2：chat（初始化对话）**
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
// 发送 bootstrap 消息触发智能体初始化
|
|
||||||
sendMessage(threadId, bootstrapMessage, { agent_id: agentId });
|
|
||||||
|
|
||||||
// 监听 setup_agent 工具完成事件
|
|
||||||
onToolEnd: (event) => {
|
|
||||||
if (event.name === "setup_agent") {
|
|
||||||
// 带重试轮询加载 agent 最新信息
|
|
||||||
retryLoadAgent(agentId);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 4.4 ChatsPage.tsx — 对话列表
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
const { data: threads } = useThreads({ limit: 50, sortBy: "updated_at" });
|
|
||||||
|
|
||||||
// 客户端过滤：排除定时任务线程 + 搜索关键词
|
|
||||||
const filteredThreads = useMemo(() =>
|
|
||||||
threads?.filter(t =>
|
|
||||||
t.metadata?.thread_type !== "scheduler" &&
|
|
||||||
titleOfThread(t).toLowerCase().includes(search)
|
|
||||||
), [threads, search]
|
|
||||||
);
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 4.5 LoginPage.tsx — 登录
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
// 自动登录，无需用户操作
|
|
||||||
useEffect(() => {
|
|
||||||
loginByUsername(username || "guest")
|
|
||||||
.then(auth => {
|
|
||||||
setStoredAuth(auth);
|
|
||||||
router.replace("/page/workspace/chats/new");
|
|
||||||
})
|
|
||||||
.catch(err => setStatus("error"));
|
|
||||||
}, [username]);
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 4.6 ScheduledTasksPage.tsx — 定时任务
|
|
||||||
|
|
||||||
**功能：** 创建/编辑/发布/暂停/恢复定时任务，查看执行历史。
|
|
||||||
|
|
||||||
**Cron 表达式构建：**
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
type ScheduleFreq = "hourly" | "daily" | "weekly" | "monthly";
|
|
||||||
|
|
||||||
function buildCron(config): string {
|
|
||||||
// hourly → "15 * * * *"
|
|
||||||
// daily → "0 9 * * *"
|
|
||||||
// weekly → "0 9 * * 1"
|
|
||||||
// monthly → "0 9 1 * *"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**核心操作：**
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
const actions = useScheduledTaskActions();
|
|
||||||
actions.create.mutateAsync(payload);
|
|
||||||
actions.publish.mutateAsync(taskId);
|
|
||||||
actions.pause.mutateAsync(taskId);
|
|
||||||
actions.trigger.mutateAsync(taskId); // 立即执行一次
|
|
||||||
actions.subscribe.mutateAsync(params); // 订阅推送
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5. 核心业务组件
|
|
||||||
|
|
||||||
### 5.1 消息系统（`components/workspace/messages/`）
|
|
||||||
|
|
||||||
| 文件 | 职责 |
|
|
||||||
|------|------|
|
|
||||||
| `message-list.tsx` | 消息列表容器，调用 `groupMessages` 分组后渲染 |
|
|
||||||
| `message-list-item.tsx` | 单条消息渲染（含 role 判断） |
|
|
||||||
| `message-group.tsx` | 消息组（human / assistant / processing 等） |
|
|
||||||
| `markdown-content.tsx` | Markdown 渲染（rehype 系列插件） |
|
|
||||||
| `subtask-card.tsx` | 子任务状态卡片 |
|
|
||||||
| `message-token-usage.tsx` | 单条消息 Token 用量 |
|
|
||||||
| `skeleton.tsx` | 流式加载骨架屏 |
|
|
||||||
| `context.tsx` | ThreadContext，向下传递 thread 对象 |
|
|
||||||
|
|
||||||
**消息分组类型（`groupMessages`）：**
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
type MessageGroup =
|
|
||||||
| "human" // 用户输入
|
|
||||||
| "assistant:processing" // 推理/工具调用中
|
|
||||||
| "assistant" // 最终响应
|
|
||||||
| "assistant:clarification" // 澄清请求
|
|
||||||
| "assistant:present-files" // 文件呈现
|
|
||||||
| "assistant:subagent"; // 子智能体消息
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 5.2 输入框（`components/workspace/input-box.tsx`）
|
|
||||||
|
|
||||||
**子组件层级：**
|
|
||||||
|
|
||||||
```
|
|
||||||
InputBox
|
|
||||||
└── PromptInput（Context Provider）
|
|
||||||
├── PromptInputBody
|
|
||||||
│ ├── PromptInputTextarea（文本输入）
|
|
||||||
│ ├── PromptInputAttachments（附件列表）
|
|
||||||
│ └── PromptInputTools（工具栏：附件上传、模式选择）
|
|
||||||
├── PromptInputFooter
|
|
||||||
│ ├── PromptInputSubmit（发送/停止按钮）
|
|
||||||
│ └── Suggestions（追问建议列表）
|
|
||||||
└── ModelSelector（模型下拉选择）
|
|
||||||
```
|
|
||||||
|
|
||||||
**四种会话模式：**
|
|
||||||
|
|
||||||
| Mode | 说明 |
|
|
||||||
|------|------|
|
|
||||||
| `flash` | 快速模式，无推理步骤 |
|
|
||||||
| `thinking` | 推理模式，开启深度思考 |
|
|
||||||
| `pro` | 专业模式，多模态 + 规划 |
|
|
||||||
| `ultra` | 超级模式，启用子智能体 |
|
|
||||||
|
|
||||||
**推理努力等级（mode ≠ flash 时可选）：** `minimal` / `low` / `medium` / `high`
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 5.3 侧边栏（`components/workspace/workspace-sidebar.tsx`）
|
|
||||||
|
|
||||||
```
|
|
||||||
WorkspaceSidebar
|
|
||||||
├── SidebarHeader → WorkspaceHeader
|
|
||||||
│ ├── Logo（可点击，跳转 /page/workspace/chats/new）
|
|
||||||
│ └── 新建对话按钮
|
|
||||||
├── SidebarContent
|
|
||||||
│ ├── WorkspaceNavChatList
|
|
||||||
│ │ ├── 新建对话（/page/workspace/chats/new）
|
|
||||||
│ │ ├── 所有对话（/page/workspace/chats）
|
|
||||||
│ │ ├── 智能体（/page/workspace/agents）
|
|
||||||
│ │ └── 任务管理（/page/workspace/scheduled/tasks）
|
|
||||||
│ └── RecentChatList（最近会话，含搜索）
|
|
||||||
└── SidebarFooter → WorkspaceNavMenu
|
|
||||||
├── Settings（打开设置 Dialog）
|
|
||||||
├── About
|
|
||||||
└── GitHub
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 5.4 制品管理（`components/workspace/artifacts/`）
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
interface ArtifactsContextType {
|
|
||||||
artifacts: string[]; // artifact ID 列表
|
|
||||||
selectedArtifact: string | null;
|
|
||||||
autoSelect: boolean; // 是否自动选中最新制品
|
|
||||||
open: boolean; // 面板是否展开
|
|
||||||
autoOpen: boolean;
|
|
||||||
select(artifact: string, autoSelect?: boolean): void;
|
|
||||||
deselect(): void;
|
|
||||||
setOpen(open: boolean): void;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**文件：**
|
|
||||||
|
|
||||||
| 文件 | 职责 |
|
|
||||||
|------|------|
|
|
||||||
| `context.tsx` | ArtifactsContext + Provider |
|
|
||||||
| `artifact-trigger.tsx` | 面板展开/收起按钮 |
|
|
||||||
| `artifact-file-list.tsx` | 制品文件列表 |
|
|
||||||
| `artifact-file-detail.tsx` | 单个制品详情（含代码编辑器） |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 5.5 设置面板（`components/workspace/settings/`）
|
|
||||||
|
|
||||||
| 页面文件 | 内容 |
|
|
||||||
|---------|------|
|
|
||||||
| `appearance-settings-page.tsx` | 主题切换（light/dark/system）、语言切换 |
|
|
||||||
| `memory-settings-page.tsx` | 用户记忆（事实列表、总结管理） |
|
|
||||||
| `notification-settings-page.tsx` | 桌面通知开关 |
|
|
||||||
| `skill-settings-page.tsx` | 技能启用/禁用 |
|
|
||||||
| `tool-settings-page.tsx` | 工具配置 |
|
|
||||||
| `about-settings-page.tsx` | 版本号、仓库链接 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 5.6 命令面板（`components/workspace/command-palette.tsx`）
|
|
||||||
|
|
||||||
通过 `Cmd/Ctrl + K` 触发，提供快速导航和操作入口。
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
const handleNewChat = useCallback(() => {
|
|
||||||
router.push("/page/workspace/chats/new");
|
|
||||||
setOpen(false);
|
|
||||||
}, [router]);
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 6. 核心 Hooks 与工具函数
|
|
||||||
|
|
||||||
### 6.1 useThreadStream（最核心 Hook）
|
|
||||||
|
|
||||||
**位置：** `core/threads/hooks.ts`
|
|
||||||
|
|
||||||
管理 LangGraph WebSocket 连接、消息流、乐观更新。
|
|
||||||
|
|
||||||
**签名：**
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
const [thread, sendMessage, isUploading] = useThreadStream({
|
|
||||||
threadId?: string, // 有值则连接现有线程，无值表示新建
|
|
||||||
context: LocalSettings["context"], // 模型、模式等
|
|
||||||
isMock?: boolean,
|
|
||||||
assistantId?: string, // 默认 "lead_agent"
|
|
||||||
onStart?: (threadId: string) => void,
|
|
||||||
onFinish?: (state: AgentThreadState) => void,
|
|
||||||
onToolEnd?: (event: ToolEndEvent) => void,
|
|
||||||
});
|
|
||||||
```
|
|
||||||
|
|
||||||
**thread 对象关键属性：**
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
thread: {
|
|
||||||
messages: Message[], // 含乐观消息的完整列表
|
|
||||||
isLoading: boolean, // 流是否进行中
|
|
||||||
isThreadLoading: boolean, // 初始线程数据是否加载中
|
|
||||||
values: AgentThreadState, // 线程最终状态
|
|
||||||
error?: Error,
|
|
||||||
stop: async () => void, // 终止当前流
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**sendMessage 签名：**
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
sendMessage(
|
|
||||||
threadId: string | undefined,
|
|
||||||
message: PromptInputMessage,
|
|
||||||
extraContext?: Partial<AgentThreadContext>,
|
|
||||||
options?: { isMock?: boolean }
|
|
||||||
): Promise<void>
|
|
||||||
```
|
|
||||||
|
|
||||||
**内部机制：**
|
|
||||||
- **乐观更新：** 用户发送后立即本地展示消息，不等服务端响应
|
|
||||||
- **文件上传：** 自动调用 `uploadFiles()` 后再提交
|
|
||||||
- **run_id 持久化：** sessionStorage 保存，支持页面刷新后断线重连
|
|
||||||
- **消息同步：** 流结束后通过 `queryClient.invalidateQueries(["threads"])` 刷新列表
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 6.2 useThreadSettings
|
|
||||||
|
|
||||||
**位置：** `core/settings/hooks.ts`
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
const [settings, setSettings] = useThreadSettings(threadId);
|
|
||||||
|
|
||||||
// settings 结构
|
|
||||||
{
|
|
||||||
notification: { enabled: boolean },
|
|
||||||
context: {
|
|
||||||
model_name?: string,
|
|
||||||
mode: "flash" | "thinking" | "pro" | "ultra",
|
|
||||||
reasoning_effort?: "minimal" | "low" | "medium" | "high"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// 修改（合并更新）
|
|
||||||
setSettings("context", { mode: "pro" });
|
|
||||||
setSettings("notification", { enabled: true });
|
|
||||||
```
|
|
||||||
|
|
||||||
**工作原理：** `useSyncExternalStore` 监听 localStorage 变化，跨标签页同步。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 6.3 useI18n
|
|
||||||
|
|
||||||
**位置：** `core/i18n/hooks.ts`
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
const { t, locale, changeLocale } = useI18n();
|
|
||||||
|
|
||||||
t.sidebar.newChat // "New Chat"
|
|
||||||
t.agents.createPageTitle // "Create Agent"
|
|
||||||
t.toolCalls.moreSteps(3) // "Show 3 more steps"
|
|
||||||
|
|
||||||
changeLocale("zh-CN"); // 切换语言，自动存 cookie
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 6.4 useScheduledTaskActions
|
|
||||||
|
|
||||||
**位置：** `core/scheduled-tasks/hooks.ts`
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
const actions = useScheduledTaskActions();
|
|
||||||
|
|
||||||
// 所有返回值均为 TanStack Query Mutation
|
|
||||||
actions.create // 创建定时任务
|
|
||||||
actions.update // 更新任务配置
|
|
||||||
actions.remove // 删除任务
|
|
||||||
actions.removeRun // 删除执行记录
|
|
||||||
actions.pause // 暂停
|
|
||||||
actions.resume // 恢复
|
|
||||||
actions.trigger // 立即触发一次
|
|
||||||
actions.publish // 发布（激活）
|
|
||||||
actions.unpublish // 取消发布
|
|
||||||
actions.subscribe // 订阅推送
|
|
||||||
actions.updateSubscription
|
|
||||||
actions.unsubscribe
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 6.5 工具函数
|
|
||||||
|
|
||||||
**消息处理（`core/messages/utils.ts`）：**
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
groupMessages(messages, mapper) // 按类型分组消息列表
|
|
||||||
extractTextFromMessage(message) // 提取纯文本
|
|
||||||
extractContentFromMessage(message) // 提取 Markdown/图像内容
|
|
||||||
extractReasoningContentFromMessage(msg) // 提取推理过程
|
|
||||||
hasToolCalls(message) // 是否含工具调用
|
|
||||||
hasPresentFiles(message) // 是否包含文件呈现
|
|
||||||
extractPresentFilesFromMessage(message) // 获取文件列表
|
|
||||||
isClarificationToolMessage(message) // 是否为澄清请求
|
|
||||||
```
|
|
||||||
|
|
||||||
**线程路由（`core/threads/utils.ts`）：**
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
pathOfThread(thread, context?)
|
|
||||||
// → "/page/workspace/agents/{agentRef}/chats/{threadId}"
|
|
||||||
// 或 "/page/workspace/chats/{threadId}"
|
|
||||||
|
|
||||||
titleOfThread(thread)
|
|
||||||
// → thread.values?.title ?? "Untitled"
|
|
||||||
|
|
||||||
textOfMessage(message)
|
|
||||||
// → 消息文本内容（string 或 content 数组中第一个 text）
|
|
||||||
```
|
|
||||||
|
|
||||||
**其他工具：**
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
// core/utils/files.tsx
|
|
||||||
downloadFile(blob: Blob, filename: string)
|
|
||||||
|
|
||||||
// core/utils/datetime.ts
|
|
||||||
formatTimeAgo(dateString: string) // → "2 小时前" / "3 days ago"
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 7. API 调用层
|
|
||||||
|
|
||||||
### 7.1 API 客户端架构
|
|
||||||
|
|
||||||
**两层设计：**
|
|
||||||
|
|
||||||
**第一层：LangGraph SDK Client**（`core/api/api-client.ts`）
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
const client = new LangGraphClient({
|
|
||||||
apiUrl: getLangGraphBaseURL(isMock),
|
|
||||||
onRequest(url, init) {
|
|
||||||
const headers = new Headers(init.headers ?? {});
|
|
||||||
headers.set("Authorization", getAuthorizationHeaderValue());
|
|
||||||
return { ...init, headers };
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
export function getAPIClient(isMock?: boolean): LangGraphClient
|
|
||||||
```
|
|
||||||
|
|
||||||
**第二层：Fetch Client**（`core/api/fetch-client.ts`）
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
function apiFetch(input: RequestInfo, init?: RequestInit): Promise<Response> {
|
|
||||||
return fetch(input, {
|
|
||||||
...init,
|
|
||||||
headers: withAuthHeaders(init?.headers)
|
|
||||||
});
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### 7.2 主要 API 模块
|
|
||||||
|
|
||||||
| 模块 | 文件 | 关键函数 |
|
|
||||||
|------|------|---------|
|
|
||||||
| **Auth** | `core/auth/api.ts` | `loginByUsername(username)` → `LoginByUsernameResponse` |
|
|
||||||
| **Agents** | `core/agents/api.ts` | `createAgent()`, `updateAgent()`, `listAgents()`, `deleteAgent()`, `checkAgentName()` |
|
|
||||||
| **Models** | `core/models/api.ts` | `loadModels()` → `Model[]` |
|
|
||||||
| **Threads** | (via LangGraph SDK) | `useThreadStream()`, `useThreads()`, `useDeleteThread()`, `useRenameThread()` |
|
|
||||||
| **Skills** | `core/skills/api.ts` | `loadSkills()`, `enableSkill(name, enabled)` |
|
|
||||||
| **Uploads** | `core/uploads/api.ts` | `uploadFiles(threadId, files[])`, `listUploadedFiles()`, `deleteUploadedFile()` |
|
|
||||||
| **Memory** | `core/memory/api.ts` | `loadMemory()`, `createMemoryFact()`, `updateMemoryFact()`, `deleteMemoryFact()` |
|
|
||||||
| **Scheduled Tasks** | `core/scheduled-tasks/api.ts` | CRUD、publish、pause、resume、trigger、subscribe |
|
|
||||||
|
|
||||||
### 7.3 Base URL 配置
|
|
||||||
|
|
||||||
**文件：** `core/config/index.ts`
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
export function getBackendBaseURL(): string {
|
|
||||||
// env.NEXT_PUBLIC_BACKEND_BASE_URL
|
|
||||||
// 默认：""（当前域名根路径）
|
|
||||||
}
|
|
||||||
|
|
||||||
export function getLangGraphBaseURL(isMock?: boolean): string {
|
|
||||||
// mock 模式：${origin}/mock/api
|
|
||||||
// 正常：${origin}/api/langgraph
|
|
||||||
// 或读取 env.NEXT_PUBLIC_LANGGRAPH_BASE_URL
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### 7.4 认证流程
|
|
||||||
|
|
||||||
```
|
|
||||||
LoginPage 调用 loginByUsername(username)
|
|
||||||
↓ POST /api/auth/login
|
|
||||||
↓ 返回 { access_token, token_type, user_id, email }
|
|
||||||
↓ setStoredAuth() 存入 localStorage["deerflow.auth"]
|
|
||||||
↓
|
|
||||||
后续所有 API 请求
|
|
||||||
↓ getAuthorizationHeaderValue()
|
|
||||||
↓ → "Bearer {access_token}"
|
|
||||||
↓ 自动添加到 Authorization header
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 8. 国际化机制
|
|
||||||
|
|
||||||
### 8.1 文件结构
|
|
||||||
|
|
||||||
```
|
|
||||||
core/i18n/
|
|
||||||
├── context.tsx # I18nProvider（包裹 App）
|
|
||||||
├── hooks.ts # useI18n()
|
|
||||||
├── locale.ts # detectLocale()，Locale = "en-US" | "zh-CN"
|
|
||||||
├── cookies.ts # cookie 读写（持久化语言选择）
|
|
||||||
├── translations.ts # 翻译映射表入口
|
|
||||||
└── locales/
|
|
||||||
├── types.ts # Translations 接口定义（所有翻译 key 的类型）
|
|
||||||
├── en-US.ts # 英文翻译
|
|
||||||
└── zh-CN.ts # 简体中文翻译
|
|
||||||
```
|
|
||||||
|
|
||||||
### 8.2 Translations 接口分类
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
interface Translations {
|
|
||||||
locale: { localName: string } // 语言自身名称
|
|
||||||
common: { ... } // 通用词汇（确认、取消等）
|
|
||||||
welcome: { ... } // 欢迎屏
|
|
||||||
inputBox: { ... } // 输入框（模式、占位符）
|
|
||||||
sidebar: { ... } // 侧边栏导航
|
|
||||||
agents: { ... } // 智能体相关
|
|
||||||
chats: { ... } // 对话相关
|
|
||||||
workspace: { ... } // 工作区通用
|
|
||||||
settings: { ... } // 设置面板
|
|
||||||
toolCalls: { ... } // 工具调用展示
|
|
||||||
uploads: { ... } // 文件上传
|
|
||||||
subtasks: { ... } // 子任务
|
|
||||||
tokenUsage: { ... } // Token 用量
|
|
||||||
shortcuts: { ... } // 快捷键说明
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### 8.3 语言检测优先级
|
|
||||||
|
|
||||||
1. 读取 cookie `deerflow.locale`
|
|
||||||
2. 读取浏览器 `navigator.language`
|
|
||||||
3. 回退到 `en-US`
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 9. 主题与样式体系
|
|
||||||
|
|
||||||
### 9.1 主题系统
|
|
||||||
|
|
||||||
**库：** `next-themes`
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
// App.tsx
|
|
||||||
<NextThemesProvider
|
|
||||||
attribute="class" // 通过 <html class="dark"> 应用主题
|
|
||||||
enableSystem // 跟随系统偏好
|
|
||||||
disableTransitionOnChange // 切换时禁用过渡动画
|
|
||||||
forcedTheme={pathname === "/landing" ? "dark" : undefined}
|
|
||||||
>
|
|
||||||
```
|
|
||||||
|
|
||||||
**可选主题值：** `light` / `dark` / `system`
|
|
||||||
|
|
||||||
### 9.2 样式方案
|
|
||||||
|
|
||||||
**基础：** Tailwind CSS
|
|
||||||
|
|
||||||
**组件库：** shadcn/ui（`components/ui/` 目录，40+ 基础组件）
|
|
||||||
|
|
||||||
**主要 CSS 自定义属性：**
|
|
||||||
|
|
||||||
```css
|
|
||||||
--container-width-sm /* 小容器宽度 */
|
|
||||||
--container-width-md /* 中等容器宽度（对话主区域） */
|
|
||||||
--primary /* 主色 */
|
|
||||||
--background /* 页面背景 */
|
|
||||||
--foreground /* 主文本色 */
|
|
||||||
--muted-foreground /* 次要文本色 */
|
|
||||||
--border /* 边框色 */
|
|
||||||
--sidebar-foreground /* 侧边栏文本 */
|
|
||||||
```
|
|
||||||
|
|
||||||
### 9.3 样式使用规范
|
|
||||||
|
|
||||||
- 工具类优先（Tailwind）
|
|
||||||
- 动态样式用 `cn()` 工具函数合并（基于 `clsx` + `tailwind-merge`）
|
|
||||||
- 主题感知样式使用 CSS 变量（如 `text-muted-foreground`）
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 10. 关键业务流程
|
|
||||||
|
|
||||||
### 10.1 新建对话流程
|
|
||||||
|
|
||||||
```
|
|
||||||
1. 点击"新建对话" → navigate("/page/workspace/chats/new")
|
|
||||||
2. ChatPage 挂载，threadId = uuid()，isNewThread = true
|
|
||||||
3. 用户输入消息，点击发送
|
|
||||||
4. sendMessage(undefined, message) 调用
|
|
||||||
5. useThreadStream 内部：
|
|
||||||
a. 上传文件（若有）
|
|
||||||
b. 创建 LangGraph 线程，后端返回 threadId
|
|
||||||
c. onStart(threadId) 回调：
|
|
||||||
- setIsNewThread(false)
|
|
||||||
- history.replaceState 更新 URL hash
|
|
||||||
6. WebSocket 流开始接收 AI 消息
|
|
||||||
7. MessageList 实时渲染消息
|
|
||||||
8. 流结束，onFinish 回调，可能触发桌面通知
|
|
||||||
```
|
|
||||||
|
|
||||||
### 10.2 创建智能体流程
|
|
||||||
|
|
||||||
```
|
|
||||||
Step 1（name 步骤）
|
|
||||||
↓ 用户输入名称
|
|
||||||
↓ checkAgentName(name) → 验证是否重名
|
|
||||||
↓ createAgent({ name, skills: selectedSkills })
|
|
||||||
↓ 后端返回 agent.id，setStep("chat")
|
|
||||||
|
|
||||||
Step 2（chat 步骤）
|
|
||||||
↓ 生成临时 threadId
|
|
||||||
↓ useThreadStream({ assistantId: agent.id })
|
|
||||||
↓ 发送 bootstrap 消息（触发智能体自我设置）
|
|
||||||
↓ onToolEnd 监听：event.name === "setup_agent"
|
|
||||||
↓ 指数退避重试加载 agent 信息，确认已保存
|
|
||||||
↓ 显示"Agent Created"完成界面
|
|
||||||
↓ 用户可点击"开始对话"或"返回列表"
|
|
||||||
```
|
|
||||||
|
|
||||||
### 10.3 文件上传流程
|
|
||||||
|
|
||||||
```
|
|
||||||
1. 用户在 InputBox 选择/粘贴文件
|
|
||||||
2. PromptInputAttachments 展示预览列表
|
|
||||||
3. 用户点击发送
|
|
||||||
4. sendMessage 内部调用 uploadFiles(threadId, files)
|
|
||||||
5. POST /api/threads/{threadId}/upload
|
|
||||||
6. 后端返回 { files: [{ filename, size, virtual_path }] }
|
|
||||||
7. 构建 Message additional_kwargs.files
|
|
||||||
8. 完整 Message 提交到 LangGraph
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 11. 项目配置与依赖
|
|
||||||
|
|
||||||
### 11.1 主要依赖
|
|
||||||
|
|
||||||
| 包 | 版本 | 用途 |
|
|
||||||
|----|------|------|
|
|
||||||
| `react` | ^18 | 核心框架 |
|
|
||||||
| `react-router-dom` | ^6 | 客户端路由（HashRouter） |
|
|
||||||
| `@tanstack/react-query` | - | 服务端状态缓存 |
|
|
||||||
| `@langchain/langgraph-sdk` | - | LangGraph WebSocket 连接 |
|
|
||||||
| `next-themes` | - | 主题管理 |
|
|
||||||
| `sonner` | - | Toast 通知 |
|
|
||||||
| `lucide-react` | - | 图标库 |
|
|
||||||
| `tailwindcss` | - | CSS 框架 |
|
|
||||||
| `rehype` 系列 | - | Markdown 渲染 |
|
|
||||||
| `uuid` | - | 生成临时 thread ID |
|
|
||||||
|
|
||||||
### 11.2 环境变量
|
|
||||||
|
|
||||||
| 变量 | 说明 | 默认值 |
|
|
||||||
|------|------|--------|
|
|
||||||
| `NEXT_PUBLIC_BACKEND_BASE_URL` | 后端接口基础 URL | `""` (当前域名) |
|
|
||||||
| `NEXT_PUBLIC_LANGGRAPH_BASE_URL` | LangGraph API URL | `/api/langgraph` |
|
|
||||||
| `NEXT_PUBLIC_STATIC_WEBSITE_ONLY` | 纯静态演示模式 | `"false"` |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 12. 常见开发模式
|
|
||||||
|
|
||||||
### 12.1 添加新工作区页面
|
|
||||||
|
|
||||||
```
|
|
||||||
1. 创建 src/pages/MyPage.tsx
|
|
||||||
2. 在 WorkspaceRoutes.tsx 中添加路由：
|
|
||||||
<Route path="my-page" element={<WorkspaceLayout><MyPage /></WorkspaceLayout>} />
|
|
||||||
3. 在 workspace-nav-chat-list.tsx 中添加导航入口（如需要）
|
|
||||||
4. 更新相关的跳转路径
|
|
||||||
```
|
|
||||||
|
|
||||||
### 12.2 添加新 API 接口
|
|
||||||
|
|
||||||
```
|
|
||||||
1. 在 core/xxx/api.ts 中定义 API 函数（使用 apiFetch 或 getAPIClient()）
|
|
||||||
2. 在 core/xxx/hooks.ts 中封装 useQuery / useMutation
|
|
||||||
3. 在页面或组件中调用 hook
|
|
||||||
```
|
|
||||||
|
|
||||||
### 12.3 添加新 Context
|
|
||||||
|
|
||||||
```
|
|
||||||
1. 创建 core/xxx/context.tsx：定义 Context + Provider + 默认值
|
|
||||||
2. 创建消费 hook（如 useXxx()）
|
|
||||||
3. 在合适的组件树根部插入 Provider（WorkspaceRoutes 或 ChatRuntime）
|
|
||||||
```
|
|
||||||
|
|
||||||
### 12.4 添加国际化文本
|
|
||||||
|
|
||||||
```
|
|
||||||
1. 在 core/i18n/locales/types.ts 的 Translations 接口中添加字段
|
|
||||||
2. 在 core/i18n/locales/en-US.ts 添加英文内容
|
|
||||||
3. 在 core/i18n/locales/zh-CN.ts 添加中文内容
|
|
||||||
4. 组件中通过 useI18n() 访问：const { t } = useI18n(); t.xxx.yyy
|
|
||||||
```
|
|
||||||
|
|
||||||
### 12.5 引入外部系统路由
|
|
||||||
|
|
||||||
在 `src/pages/PageRoutes.tsx` 中找到 TODO 注释位置，填入：
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
import AnotherSystemRoutes from "外部系统路径";
|
|
||||||
|
|
||||||
// 在 Routes 中添加：
|
|
||||||
<Route path="other/*" element={<AnotherSystemRoutes />} />
|
|
||||||
```
|
|
||||||
|
|
||||||
如外部系统有独立 Provider 依赖，在此文件或 App.tsx 中包裹。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 附：关键文件速查
|
|
||||||
|
|
||||||
| 需求 | 关键文件 |
|
|
||||||
|------|---------|
|
|
||||||
| 修改路由结构 | `App.tsx`, `PageRoutes.tsx`, `WorkspaceRoutes.tsx` |
|
|
||||||
| 修改侧边栏导航 | `components/workspace/workspace-nav-chat-list.tsx` |
|
|
||||||
| 修改对话逻辑 | `pages/ChatPage.tsx`, `core/threads/hooks.ts` |
|
|
||||||
| 修改输入框 | `components/workspace/input-box.tsx`, `components/ai-elements/prompt-input/` |
|
|
||||||
| 修改消息渲染 | `components/workspace/messages/` |
|
|
||||||
| 添加 API 接口 | `core/xxx/api.ts` + `core/xxx/hooks.ts` |
|
|
||||||
| 修改全局设置 | `core/settings/store.ts`, `core/settings/hooks.ts` |
|
|
||||||
| 修改翻译文本 | `core/i18n/locales/en-US.ts`, `core/i18n/locales/zh-CN.ts` |
|
|
||||||
| 修改主题 | `App.tsx` (NextThemesProvider) |
|
|
||||||
| 修改认证逻辑 | `core/auth/api.ts`, `pages/LoginPage.tsx` |
|
|
||||||
| 定时任务 | `pages/ScheduledTasksPage.tsx`, `core/scheduled-tasks/` |
|
|
||||||
| 智能体管理 | `pages/NewAgentPage.tsx`, `core/agents/` |
|
|
||||||
@@ -1,198 +0,0 @@
|
|||||||
# MAF-R0 阶段 0 交付文档：旧会商交互基线与组件映射
|
|
||||||
|
|
||||||
> 状态：已完成
|
|
||||||
> 更新时间：2026-08-03
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 实验原型隐藏说明
|
|
||||||
|
|
||||||
### 已完成的操作
|
|
||||||
|
|
||||||
- `/page/maf/*` 路由（`MafSessionsPage` + `MafRunDetailPage`）已从正式菜单移除。
|
|
||||||
- `workspace-nav-chat-list.tsx:199` 保留了墓碑注释：`{/* [MAF-R0] 实验原型已从正式菜单隐藏，仅保留路由供开发诊断：/page/maf */}`
|
|
||||||
- `MafRoutes.tsx` 文件头部标注为 `[MAF-R0 实验原型 — 仅供开发诊断，已从正式菜单移除]`。
|
|
||||||
- 该原型仅可通过手动输入 URL `/page/maf` 访问，不在任何侧边栏、导航菜单或工作区入口中出现。
|
|
||||||
- 停止在该原型上新增业务功能。
|
|
||||||
|
|
||||||
### 原型文件位置
|
|
||||||
|
|
||||||
| 文件 | 用途 |
|
|
||||||
|------|------|
|
|
||||||
| `src/pages/MafRoutes.tsx` | 路由定义（index → MafSessionsPage, runs/:runId → MafRunDetailPage） |
|
|
||||||
| `src/maf-roundtable/pages/MafSessionsPage.tsx` | 会话列表页（642 行） |
|
|
||||||
| `src/maf-roundtable/pages/MafRunDetailPage.tsx` | 单 run 工作区（195 行） |
|
|
||||||
| `src/maf-roundtable/` | 完整模块（33 文件：api/hooks/components/lib/tests） |
|
|
||||||
| `vitest.maf.config.ts` | MAF 专用测试配置 |
|
|
||||||
| `package.json` → `test:maf` | MAF 测试脚本 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 旧会商 8 类页面状态交互地图
|
|
||||||
|
|
||||||
旧会商入口：`src/roundtable-planning/pages/RoundtablePlanningPage.tsx`（4376 行，三步合一）。
|
|
||||||
|
|
||||||
### 状态 1：空白 / 新建
|
|
||||||
|
|
||||||
- 触发：点击「新建会商」或首次进入。
|
|
||||||
- 表现：中心区域显示欢迎语 + 业务链选择入口 + 底部输入框。左侧历史列表为空或显示已有草稿。
|
|
||||||
- 关键组件：`RoundtablePlanningPage`（currentStep=1 初始态）、`Step1Panel`（空消息列表 + 输入栏）。
|
|
||||||
- 数据：`useDraftPersistence` 创建新草稿记录。
|
|
||||||
|
|
||||||
### 状态 2：历史切换
|
|
||||||
|
|
||||||
- 触发：点击左侧草稿列表中的某一条。
|
|
||||||
- 表现：加载该草稿的 Step1/Step2/Step3 快照，恢复到对应步骤。
|
|
||||||
- 关键组件：`useRoundtableDrafts`（列表）、`useDraftPersistence`（加载 + hydrate）。
|
|
||||||
- 数据：`GET /api/roundtable-drafts/{id}` 或 `GET /api/roundtable-task-drafts/{id}`。
|
|
||||||
|
|
||||||
### 状态 3：用户提问
|
|
||||||
|
|
||||||
- 触发：用户在 Step1 输入框输入任务文本并点击发送。
|
|
||||||
- 表现：用户气泡立即插入，随后出现 `MessageLoadingPlaceholder`（spinner + 跳动点），等待 SSE 首帧。
|
|
||||||
- 关键组件：`Step1Panel`（输入栏 → 发送）、`MessageBubble`（用户气泡）、`MessageLoadingPlaceholder`。
|
|
||||||
- 数据：`POST /api/intent/init` → `POST /api/intent/stream`（SSE）。
|
|
||||||
|
|
||||||
### 状态 4：意图澄清
|
|
||||||
|
|
||||||
- 触发：总控/意图智能体判断信息不足，返回 `ask_clarification` 帧。
|
|
||||||
- 表现：对话流中嵌入 `IntentClarificationCard`（单选/多选 + 自定义输入），用户选择后提交。
|
|
||||||
- 关键组件：`IntentClarificationCard`（选项卡）、`Step1Panel`（澄清提交逻辑）。
|
|
||||||
- 数据：SSE 帧 `phase=clarification`，用户回答后继续 `POST /api/intent/stream`。
|
|
||||||
|
|
||||||
### 状态 5：总控派活
|
|
||||||
|
|
||||||
- 触发：Step1 完成（INTENT_READY）→ 进入 Step2 → 总控输出派活计划。
|
|
||||||
- 表现：总控气泡显示派活计划（谁做什么），`ParallelSeatStrip` 显示参与席位头像条（running/done/error 徽章）。
|
|
||||||
- 关键组件：`Step2Panel`（派活叙事）、`ParallelSeatStrip`（席位条）、`MessageBubble`（总控气泡）。
|
|
||||||
- 数据：`POST /api/multi-agent/init`（SSE，建立 thread map）→ `POST /api/multi-agent/run/stream`。
|
|
||||||
|
|
||||||
### 状态 6：席位发言
|
|
||||||
|
|
||||||
- 触发：总控派活后，各席位按序/并行执行。
|
|
||||||
- 表现：每个席位的气泡流式出现（`StreamingCursor` 闪烁尾标），工具调用显示为 `MessageStepsCard`（ChainOfThought 折叠卡）。
|
|
||||||
- 关键组件：`MessageBubble`（席位气泡 + avatar）、`StreamingCursor`、`MessageStepsCard`（工具步骤）、`DialogueSpeedMeter`（tok/s）。
|
|
||||||
- 数据：SSE delta 帧按 message id 合并。
|
|
||||||
|
|
||||||
### 状态 7：审批
|
|
||||||
|
|
||||||
- 触发：席位执行外部写操作，WriteGuard 拦截并请求审批。
|
|
||||||
- 表现：对话流中嵌入审批卡（工具名 + 风险等级 + 摘要），用户点击批准/拒绝。
|
|
||||||
- 关键组件：MAF 原型中为 `MafApprovalCard`；旧会商中审批通过 `roundtable-jobs` 的 clarify-resume 机制。
|
|
||||||
- 数据：`POST /api/maf-roundtable/approvals/{id}/decision`（MAF）或 `POST /api/roundtable-jobs/{id}/clarify-resume`（旧）。
|
|
||||||
|
|
||||||
### 状态 8：完成 / 失败恢复
|
|
||||||
|
|
||||||
- 触发：所有席位完成 + 总控收束 → Step3；或 SSE 错误帧 / 网络断开。
|
|
||||||
- 表现（完成）：Step3 显示最终报告（Markdown 总结 / HTML 看板 / 大屏），可追问。
|
|
||||||
- 表现（失败）：错误提示 + 恢复按钮；后台任务可挂起/恢复。
|
|
||||||
- 关键组件：`Step3Panel` → `HighFidelityReport`（Report/Dashboard/Summary/FileBrowse 模式）；失败时 `RoundtableJobNotifier`。
|
|
||||||
- 数据：`useStep3Summary` / `useStep3Report` / `useStep3Dashboard`；失败恢复 via `POST /api/roundtable-jobs/{id}/resume`。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 旧组件 → 新 MAF view-model 映射表
|
|
||||||
|
|
||||||
| 旧组件 / hook | 新 MAF 对应 | 映射说明 |
|
|
||||||
|---|---|---|
|
|
||||||
| `RoundtablePlanningPage`（三步壳） | `MafRoundtableConversationPage` | 不再有步骤切换；单一连续时间线。 |
|
|
||||||
| `Step1Panel`（意图问答） | `ConversationTimeline` + `ClarificationCard` | 意图理解变为 `manager.intent` 事件卡。 |
|
|
||||||
| `Step2Panel`（研讨对话流） | `ConversationTimeline` + `SeatMessageBubble` | 席位发言由 SSE `agent.message.*` 驱动。 |
|
|
||||||
| `Step3Panel` / `HighFidelityReport` | `FinalResultCard` | 结论作为时间线中的结果卡。 |
|
|
||||||
| `MessageBubble` | `SeatMessageBubble` / 总控气泡 | 重写为 MAF view model；不复用旧 props。 |
|
|
||||||
| `MessageStepsCard` | `ToolProgressCard` | 工具过程由 `tool.started/progress/completed` 事件驱动。 |
|
|
||||||
| `IntentClarificationCard` | `ClarificationCard` | 由 `clarification.required` 事件触发。 |
|
|
||||||
| `ParallelSeatStrip` | `ParticipantStrip` | 状态改由 `manager.dispatch` + `seat.delivery.submitted` + `manager.review.decision` 驱动。 |
|
|
||||||
| `useStep1Intent` | 删除 | 意图理解完全服务端化。 |
|
|
||||||
| `useStep2Orchestration` | 删除 | 编排完全服务端化；前端只消费 SSE。 |
|
|
||||||
| `useDraftPersistence` | `use-maf-conversations` | 历史改为 conversation 列表。 |
|
|
||||||
| `useRoundtableDrafts` | `use-maf-conversations` | 同上。 |
|
|
||||||
| `useStep3Summary/Report/Dashboard` | 删除 | 结论由服务端生成，前端只渲染结果卡。 |
|
|
||||||
| `useAutoScroll` | 可复用（无业务依赖） | 纯 UI 滚动逻辑。 |
|
|
||||||
| `useDialogueSpeedMetrics` | 可复用（无业务依赖） | 纯 UI 速度指标。 |
|
|
||||||
| `MafApprovalCard`（原型） | `ApprovalMessageCard` | 重写为 conversation 时间线内卡片。 |
|
|
||||||
| `MafEventTimeline`（原型） | 删除 | 不再暴露 run/event 管理后台。 |
|
|
||||||
| `MafSeatStatusPanel`（原型） | `ParticipantStrip` | 合并到右侧席位条。 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. 禁止复用的旧业务 hook / API / 状态清单
|
|
||||||
|
|
||||||
以下模块 **严禁** 被新 MAF conversation 页面直接 import 或调用：
|
|
||||||
|
|
||||||
### 4.1 旧会商 API 客户端（`src/roundtable-planning/api/`）
|
|
||||||
|
|
||||||
| 文件 | 禁止原因 |
|
|
||||||
|------|----------|
|
|
||||||
| `multi-agent.ts` | 调用 `/api/multi-agent/*`，包含前端 thread map 和编排逻辑 |
|
|
||||||
| `intent.ts` | 调用 `/api/intent/*`，前端驱动意图流 |
|
|
||||||
| `drafts.ts` | 调用 `/api/roundtable-drafts`，旧草稿状态 |
|
|
||||||
| `task-drafts.ts` | 调用 `/api/roundtable-task-drafts`，旧任务草稿 |
|
|
||||||
| `roundtable-jobs.ts` | 调用 `/api/roundtable-jobs`，旧后台任务 |
|
|
||||||
| `chains.ts` | 调用 `/api/roundtable-chains`，旧业务链 CRUD |
|
|
||||||
| `recommend.ts` | 调用 `/api/recommend/stream`，旧推荐流 |
|
|
||||||
| `flow-extract.ts` | 调用 `/api/flow-extract/*`，旧流程图提取 |
|
|
||||||
| `ingest.ts` | 调用 `/api/flow-extract/ingest-eligibility` |
|
|
||||||
| `dashboard-sessions.ts` | 调用 `/api/dashboard-sessions` |
|
|
||||||
| `diagnostics-report.ts` | 调用 `/api/roundtable-diagnostics/report` |
|
|
||||||
|
|
||||||
### 4.2 旧会商业务 Hook（`src/roundtable-planning/hooks/`）
|
|
||||||
|
|
||||||
| 文件 | 禁止原因 |
|
|
||||||
|------|----------|
|
|
||||||
| `useStep1Intent.ts` | 前端驱动意图状态机 |
|
|
||||||
| `useStep2Orchestration.ts` | 前端编排循环（thread map、派活、轮次控制） |
|
|
||||||
| `useDraftPersistence.ts` | 旧草稿持久化逻辑 |
|
|
||||||
| `useRoundtableDrafts.ts` | 旧草稿列表 |
|
|
||||||
| `useStep3Summary.ts` | 前端驱动总结生成 |
|
|
||||||
| `useStep3Report.ts` | 前端驱动看板生成 |
|
|
||||||
| `useStep3Dashboard.ts` | 前端驱动大屏生成 |
|
|
||||||
|
|
||||||
### 4.3 旧会商业务状态类型
|
|
||||||
|
|
||||||
- `Step1Snapshot`、`Step2Snapshot`、`Step2Dialogue`、`StubAiMessage`、`ParallelSeatView`
|
|
||||||
- `ThreadIdMap`、`ClarificationPayload`、`LeaderDispatch`、`StreamPhase`
|
|
||||||
- `DraftRecord`、`DraftMeta`、`DraftStep1Snapshot`、`DraftStep2Snapshot`、`DraftStep3Snapshot`
|
|
||||||
- `RoundtableJob`、`JobStatus`、`DispatchChainNode`、`StartJobPayload`
|
|
||||||
- `IntentSummary`、`IntentFileRef`、`IntentStreamPhase`
|
|
||||||
|
|
||||||
### 4.4 MAF 原型中禁止继续扩展的模块
|
|
||||||
|
|
||||||
| 文件 | 禁止原因 |
|
|
||||||
|------|----------|
|
|
||||||
| `src/maf-roundtable/pages/MafSessionsPage.tsx` | 实验原型，不作为产品主界面 |
|
|
||||||
| `src/maf-roundtable/pages/MafRunDetailPage.tsx` | 实验原型，暴露 run/session 管理 |
|
|
||||||
| `src/maf-roundtable/hooks/use-maf-events.ts` | 原型轮询 hook |
|
|
||||||
| `src/maf-roundtable/api/sessions.ts` | 原型 session CRUD |
|
|
||||||
| `src/maf-roundtable/api/runs.ts` | 原型 run 管理 |
|
|
||||||
| `src/maf-roundtable/api/events.ts` | 原型事件轮询 |
|
|
||||||
| `src/maf-roundtable/lib/session-form.ts` | 原型表单逻辑 |
|
|
||||||
|
|
||||||
### 4.5 允许参考但必须重写的视觉组件
|
|
||||||
|
|
||||||
以下组件的 **交互模式和信息架构** 可作为参考，但新 MAF 页面必须使用独立实现（MAF view model + tdesign-react），不得直接 import：
|
|
||||||
|
|
||||||
- `MessageBubble.tsx`（气泡布局）
|
|
||||||
- `MessageStepsCard.tsx`（工具步骤折叠）
|
|
||||||
- `IntentClarificationCard.tsx`（澄清选项卡）
|
|
||||||
- `ParallelSeatStrip.tsx`（席位头像条）
|
|
||||||
- `ScrollToBottomButton.tsx`（回到底部按钮）
|
|
||||||
- `Avatars.tsx`（头像 SVG）
|
|
||||||
|
|
||||||
### 4.6 可安全复用的无业务依赖工具
|
|
||||||
|
|
||||||
- `useAutoScroll.ts`（纯滚动逻辑）
|
|
||||||
- `useDialogueSpeedMetrics.ts`（纯速度指标）
|
|
||||||
- `src/lib/use-desensitize-subtree.ts`（DOM 脱敏，已标注多模块共享）
|
|
||||||
- `markdown-components.tsx`（markdown 渲染配置，需确认无旧状态依赖）
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5. 验收确认
|
|
||||||
|
|
||||||
- [x] 旧会商 `RoundtablePlanningPage` 无代码行为变化（未修改任何 `src/roundtable-planning/` 文件）。
|
|
||||||
- [x] `/page/maf/*` 原型已从菜单隐藏，仅保留路由供开发诊断。
|
|
||||||
- [x] 8 类页面状态已记录，含触发条件、表现、关键组件和数据流。
|
|
||||||
- [x] 旧组件到新 MAF view-model 的映射表已完成。
|
|
||||||
- [x] 禁止复用的 hook/API/状态清单已明确。
|
|
||||||
- [x] 任何人可根据本文档判断新版是否「像原页面」。
|
|
||||||
@@ -1,645 +0,0 @@
|
|||||||
# MAF 多智能体会商升级版实施计划（V2：保留原会商体验，替换底层编排）
|
|
||||||
|
|
||||||
> 文档状态：**V2 重写，待按本计划重新实施**
|
|
||||||
> 更新时间：2026-08-02
|
|
||||||
> 本轮决策：原 `/page/maf/*` 的「会话列表 + run 详情 + 前端轮询」原型不再作为目标产品继续扩展。
|
|
||||||
> 产品目标：新 MAF 会商是**原多智能体会商页面的底层升级版**，不是另造一套会商产品。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 本次重新确认的产品目标
|
|
||||||
|
|
||||||
用户认可的是现有多智能体会商的视觉语言和交互链路：左侧历史会话、中心对话流、输入框发问、意图理解、总控派活、席位发言、过程卡片、澄清与审批、最终结论。
|
|
||||||
|
|
||||||
本次升级只替换以下“看不见的发动机”：
|
|
||||||
|
|
||||||
- 旧的前端驱动编排、多个前端可见线程和旧会商作业，替换为 MAF Workflow + DeerFlow Agent Adapter；
|
|
||||||
- 浏览器定时轮询，替换为一条可恢复的 SSE 对话事件流；
|
|
||||||
- 用户手动创建/管理多个智能体线程，收敛为服务端按需创建和持久化的内部执行线程；
|
|
||||||
- 保留现有工具、技能、MCP、沙箱、WriteGuard、审批和审计能力，并让它们在原有会商体验中自然出现。
|
|
||||||
|
|
||||||
**不能接受的结果：** 新页面没有对话列表、没有输入框、让用户先创建 session/run、需要用户选择或理解多个内部线程、靠多个定时 GET 拼出实时效果，或把审批/流程图做成脱离聊天主链路的独立后台页。
|
|
||||||
|
|
||||||
### 1.1 必须保留的用户体验
|
|
||||||
|
|
||||||
| 原会商能力 | 升级版要求 |
|
|
||||||
|---|---|
|
|
||||||
| 左侧会商历史、新建会商 | 保留。一个条目就是一个用户可见会商，不暴露 MAF session/run/thread。 |
|
|
||||||
| 中央连续对话流 | 保留。用户消息、总控消息、席位发言、工具进度、澄清、审批、最终报告按时间顺序呈现。 |
|
|
||||||
| 底部对话输入框 | 保留。用户可在首轮发起任务、在澄清时回答、在会商结束后追问/继续会商。 |
|
|
||||||
| 意图理解 | 保留并服务端化。先识别“可直接会商 / 需要澄清 / 只回答问题 / 需要工具或写入”。 |
|
|
||||||
| 总控智能体派活 | 保留。总控是唯一能选择席位、分派任务、收束轮次和生成结论的主体。 |
|
|
||||||
| 业务链、席位与过程可视化 | 保留其信息架构和交互，不复用旧业务状态；数据改由 MAF 事件驱动。 |
|
|
||||||
| 澄清、取消、恢复、审批 | 保留，并成为对话流中的卡片，而不是跳转到 run 管理页。 |
|
|
||||||
|
|
||||||
### 1.2 明确不保留的实现方式
|
|
||||||
|
|
||||||
- 不在浏览器端 `setInterval` 轮询 run、events、actions、approvals；
|
|
||||||
- 不让浏览器创建或维护 seat thread、manager thread、thread map；
|
|
||||||
- 不让用户先填写“经理、席位、模式、最大轮数”才能开始一次正常会商；
|
|
||||||
- 不把 `MafSessionsPage` / `MafRunDetailPage` 当作新产品主界面继续堆功能；
|
|
||||||
- 不调用旧的 `/api/roundtable-*`、`/api/multi-agent/*`、`roundtable_jobs`、旧草稿或旧会商状态；
|
|
||||||
- 不修改旧 `RoundtablePlanningPage` 的业务状态机、历史数据和对外行为。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 总体架构与边界
|
|
||||||
|
|
||||||
```mermaid
|
|
||||||
flowchart LR
|
|
||||||
U[用户：会商对话页] -->|POST 新建/发送消息| API[MAF Conversation API]
|
|
||||||
API --> C[(MAF Conversation / Message)]
|
|
||||||
API --> D[MAF Dispatcher]
|
|
||||||
D --> W[MAF Workflow]
|
|
||||||
W --> M[总控：意图、派活、收束]
|
|
||||||
M --> S[服务端按需创建席位执行线程]
|
|
||||||
S --> A[DeerFlow Agent Adapter]
|
|
||||||
A --> T[工具 / 技能 / MCP / 沙箱]
|
|
||||||
T --> G[WriteGuard + 审批]
|
|
||||||
W --> E[(持久化会商事件)]
|
|
||||||
E --> H[SSE Hub：重放 + 实时推送]
|
|
||||||
H -->|一条 SSE 流| U
|
|
||||||
```
|
|
||||||
|
|
||||||
### 2.1 前后端职责
|
|
||||||
|
|
||||||
| 层 | 职责 | 禁止事项 |
|
|
||||||
|---|---|---|
|
|
||||||
| 前端 | 呈现会商、发送用户消息、消费 SSE、执行用户明确点击的取消/审批/重试 | 编排席位、决定下一位发言者、创建内部线程、轮询事件。 |
|
|
||||||
| MAF Conversation Service | 会话聚合、消息持久化、运行创建、SSE 重放、所有权校验 | 让浏览器传入 user_id、工具能力快照、目标键或内部幂等键。 |
|
|
||||||
| MAF Workflow | 意图判断、总控派活、席位协作、交叉审查、结论、恢复 | 把模型输出直接当作可写外部系统的授权。 |
|
|
||||||
| DeerFlow Adapter | 为总控/席位提供既有模型、工具、技能、MCP、沙箱和用户上下文 | 从 `packages/harness/deerflow/**` 导入 `app.*`。 |
|
|
||||||
| WriteGuard | 风险识别、审批、目标租约、一次执行、审计 | 将密钥、target_key、idempotency_key 回传给浏览器或模型。 |
|
|
||||||
|
|
||||||
### 2.2 新旧隔离规则
|
|
||||||
|
|
||||||
1. 旧会商继续运行，旧路由、旧 API、旧数据表、旧任务深链全部不变。
|
|
||||||
2. 新页面独立使用 `/api/maf-roundtable/*` 和 `maf_roundtable_*` 表；只允许参考旧页面的布局、文案、交互和通用视觉规范。
|
|
||||||
3. 旧 `roundtable-planning/**` 中的业务 hook、草稿、Job、SSE 消费器和状态类型不能被新页面直接 import。
|
|
||||||
4. 若需要复用旧组件的视觉效果，必须复制/迁移为 `maf-roundtable/legacy-compatible/**` 中的新组件，替换为 MAF view model；或抽到无业务依赖的公共展示组件。旧页面不得因此改变行为。
|
|
||||||
5. 新旧页面都只能使用仓库本地依赖；UI 基础组件统一采用 **`tdesign-react`**，不接远程 UI、CDN 或外部运行时。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 用户可见的新版会商流程
|
|
||||||
|
|
||||||
### 3.1 首次进入
|
|
||||||
|
|
||||||
1. 用户点击独立菜单“MAF 会商（升级版）”，进入与旧会商相同层级的页面壳。
|
|
||||||
2. 左侧显示自己的 MAF 会商历史和“新建会商”。新建只创建一个**用户可见会商**，不显示 session/run/thread 表单。
|
|
||||||
3. 中心区域显示欢迎语、业务链/任务上下文入口和对话输入框。
|
|
||||||
4. 用户输入任务后，前端立即插入本地的用户气泡，调用一次 `POST /messages`，然后消费同一会商的 SSE 流。
|
|
||||||
|
|
||||||
### 3.2 一次会商轮次
|
|
||||||
|
|
||||||
1. SSE 推送“正在理解任务”事件；页面以旧会商的过程卡/总控气泡表现。
|
|
||||||
2. 若信息不足，推送 `clarification.required`，页面显示可回复的澄清卡；用户回答后仍通过输入框或卡片提交。
|
|
||||||
3. 若可以执行，总控输出“派活计划”；页面以旧的席位条、派活卡和消息气泡展示。
|
|
||||||
4. 每个席位的可见发言、工具进度、技能过程、交叉审查和总控收束都写入同一条时间线。
|
|
||||||
5. 出现外部写操作时，SSE 推送审批卡。用户批准/拒绝后，后端恢复工作流，SSE 继续推送；前端不手工轮询 run 状态。
|
|
||||||
6. 最终结论、事实账本、执行动作和报告作为对话流中的结果卡呈现；用户可以继续在同一会商输入追问。
|
|
||||||
|
|
||||||
### 3.3 “一个会商”与内部线程的关系
|
|
||||||
|
|
||||||
- 用户只认识 `conversation_id`；左侧历史、URL 和前端状态都以它为主键。
|
|
||||||
- 一个 conversation 可以有多轮用户消息，每轮消息产生一个内部 `maf_run`。
|
|
||||||
- `maf_session`、manager/seat thread、seat run 都是服务端内部执行身份。服务端使用既有 `ExecutionPrincipal` 绑定当前用户，并在真正需要某席位执行时懒创建/复用线程。
|
|
||||||
- 浏览器只收到经过脱敏的消息和事件，不会收到内部 thread id、能力快照、目标键、幂等键、密钥或原始工具结果。
|
|
||||||
|
|
||||||
### 3.4 总控质量闸门：派活不是“发出即完成”
|
|
||||||
|
|
||||||
当前旧会商的问题不是没有派活，而是席位只说一两句话、格式和证据都不合格时，总控仍把它当作完成并直接进入下一步。新版 MAF 必须把总控从“消息转发者”升级为**每项席位交付的验收责任人**。
|
|
||||||
|
|
||||||
每一个由总控发布的席位任务都必须有服务端持久化的 `task_contract`：
|
|
||||||
|
|
||||||
| 字段 | 含义 |
|
|
||||||
|---|---|
|
|
||||||
| `objective` | 本席位要回答的具体问题，不能只写泛泛角色描述。 |
|
|
||||||
| `expected_deliverable` | 交付类型和结构，例如“风险清单 + 依据 + 优先级 + 建议”。 |
|
|
||||||
| `acceptance_criteria` | 由总控给出的可验收标准：覆盖范围、最少关键点、证据/工具依据、格式与约束。 |
|
|
||||||
| `required` | 是否为本阶段必需交付；必需项不能被静默跳过。 |
|
|
||||||
| `max_rework_attempts` | 同一席位最多返工次数，默认 **2**（初稿之外最多两次返工），服务端配置且写入快照。 |
|
|
||||||
| `fallback_policy` | 到达返工上限后的策略：改派、请求用户澄清，或带缺口受控推进。 |
|
|
||||||
|
|
||||||
#### 3.4.1 席位交付与总控验收状态机
|
|
||||||
|
|
||||||
```mermaid
|
|
||||||
stateDiagram-v2
|
|
||||||
[*] --> assigned
|
|
||||||
assigned --> delivering
|
|
||||||
delivering --> submitted
|
|
||||||
submitted --> manager_review
|
|
||||||
manager_review --> accepted: 达到合同标准
|
|
||||||
manager_review --> rework: 不合格且未到返工上限
|
|
||||||
rework --> delivering: 带明确退回意见
|
|
||||||
manager_review --> reassigned: 达到上限且可改派
|
|
||||||
reassigned --> delivering
|
|
||||||
manager_review --> exhausted: 达到上限且无合适改派
|
|
||||||
exhausted --> controlled_gap: 记录缺口、风险与原因
|
|
||||||
accepted --> [*]
|
|
||||||
controlled_gap --> [*]
|
|
||||||
```
|
|
||||||
|
|
||||||
验收规则如下：
|
|
||||||
|
|
||||||
1. 席位先提交结构化 `delivery`，至少包含结论、依据/证据、未解决项、自检结果；不能只输出“已完成”或一两句空泛结论。
|
|
||||||
2. 进入 `manager_review` 前先执行确定性检查：空内容、最小有效长度、必须章节、必填字段、所需证据/工具引用、重复文本、错误 schema。确定性不通过时不允许直接 accepted。
|
|
||||||
3. 总控随后根据 `task_contract` 做结构化审查，决策只能是 `accept`、`return_for_rework`、`reassign`、`ask_user`、`controlled_gap`，并必须写明 `reason` 和针对性修改要求。
|
|
||||||
4. **总控的模型自评不是验收证据。** 席位自评分只作为参考；验收由确定性规则 + 总控审查 + 必要时交叉审查共同决定。
|
|
||||||
5. 对同一席位，默认最多两次返工。每次打回都必须把“缺什么、怎样补、哪些原结论不可用”带入下一次任务上下文。
|
|
||||||
6. 到达上限后绝不把不合格结果伪装成合格：总控应优先改派给一个合适备用席位（默认最多一次改派）；仍无法满足时生成 `controlled_gap`，明确标记未覆盖问题、风险和对最终结论的影响，再受控进入下一阶段。
|
|
||||||
7. 一个阶段的所有 `required` 任务必须处于 `accepted` 或 `controlled_gap` 等明确终态，阶段闸门才可通过。总控不能因为“轮数到了”或“已有部分回答”跳过未决必需项。
|
|
||||||
8. 最终报告不得将 `controlled_gap` 的内容写成已验证事实；它必须在结论中的风险/待补信息部分可追溯显示。
|
|
||||||
|
|
||||||
这既满足“打回几次后不要死循环”的要求，也避免“超过次数就把垃圾答案强行推进”的错误行为。
|
|
||||||
|
|
||||||
#### 3.4.2 对话页必须可见的质量反馈
|
|
||||||
|
|
||||||
- 总控派活卡展示任务目标、交付要求和当前第几次尝试；
|
|
||||||
- 席位提交后显示“总控审核中”，而不是立即标为完成；
|
|
||||||
- 打回时以总控消息卡显示具体退回理由和补充要求；
|
|
||||||
- 改派时显示原席位未通过和新席位承接范围，但不羞辱性展示内部评分；
|
|
||||||
- 受控降级时显示“存在未解决缺口”，并在最终结果卡中保留风险提示；
|
|
||||||
- 右侧席位条区分“执行中、待返工、已验收、已改派、存在缺口”，不能只显示“发过言”。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. API 与 SSE 契约（必须先定，前端不得猜测）
|
|
||||||
|
|
||||||
### 4.1 Conversation API
|
|
||||||
|
|
||||||
以下接口全部位于 `/api/maf-roundtable`，身份只从服务端鉴权上下文读取。
|
|
||||||
|
|
||||||
| 接口 | 用途 | 前端调用时机 |
|
|
||||||
|---|---|---|
|
|
||||||
| `GET /conversations` | 左侧历史列表（分页） | 首次进入、用户显式刷新、创建/删除后失效刷新；**无定时轮询**。 |
|
|
||||||
| `POST /conversations` | 创建空白用户会商 | 点击“新建会商”。只接收 title、任务上下文等安全字段。 |
|
|
||||||
| `GET /conversations/{id}` | 获取会商快照、权限和当前状态 | 进入会商或浏览器刷新时。 |
|
|
||||||
| `GET /conversations/{id}/messages` | 获取历史消息分页 | 进入会商、向上滚动加载历史。 |
|
|
||||||
| `POST /conversations/{id}/messages` | 原子写入用户消息并启动 MAF run | 用户点击发送或提交澄清。返回 `message_id`、`run_id`、`conversation_id`。 |
|
|
||||||
| `POST /conversations/{id}/cancel` | 取消当前活跃 run | 用户显式点击取消。 |
|
|
||||||
| `POST /approvals/{id}/decision` | 批准/拒绝写入动作 | 审批卡点击；成功后由后端恢复 workflow。 |
|
|
||||||
| `POST /conversations/{id}/recover` | 显式恢复异常中断的活跃会商 | 仅在后端判定可恢复时展示。 |
|
|
||||||
|
|
||||||
不再让页面以“创建 session → 创建 run → GET events 循环”的方式驱动会商。原有低层 session/run 接口可以作为内部诊断 API 暂时保留，但从用户页面和导航移除。
|
|
||||||
|
|
||||||
### 4.2 SSE：唯一的实时通道
|
|
||||||
|
|
||||||
```text
|
|
||||||
GET /api/maf-roundtable/conversations/{conversation_id}/stream?after_seq={last_seen_seq}
|
|
||||||
Accept: text/event-stream
|
|
||||||
Authorization: 与现有 fetch 客户端一致
|
|
||||||
```
|
|
||||||
|
|
||||||
- 前端在进入一个 conversation 后只建立**一条** fetch-reader SSE 连接；切换会商、卸载页面、权限失效时 Abort。
|
|
||||||
- 浏览器不能用定时 GET 代替 SSE。连接断开后采用指数退避重连，并携带最后已确认的 `after_seq`；不产生全量重复气泡。
|
|
||||||
- `after_seq` 是 conversation 维度、服务端单调递增的序号，不能复用每个 run 独立的 `seq`。
|
|
||||||
- 首次连接先由 `GET messages` 加载历史，再从该历史的最大 `seq` 订阅 SSE；服务端也必须支持重放，避免“历史请求和订阅之间”丢事件。
|
|
||||||
- SSE 使用 `fetch` + `ReadableStream` 解析，以复用项目鉴权头；响应必须带 `Content-Type: text/event-stream`、`Cache-Control: no-cache`、`X-Accel-Buffering: no`，并每 15 秒发送心跳。
|
|
||||||
- 服务端负责等待和推送。单 worker 可用进程内 conversation event hub；生产多 worker 部署前必须接入 Redis Pub/Sub 或等价分布式广播，不能退回浏览器轮询。
|
|
||||||
|
|
||||||
### 4.3 SSE 事件信封
|
|
||||||
|
|
||||||
所有事件统一为：
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"seq": 42,
|
|
||||||
"event_id": "evt_...",
|
|
||||||
"conversation_id": "conv_...",
|
|
||||||
"run_id": "run_...",
|
|
||||||
"type": "agent.message.delta",
|
|
||||||
"occurred_at": "2026-08-02T12:00:00Z",
|
|
||||||
"data": {}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
允许的首批 `type`：
|
|
||||||
|
|
||||||
| 类型 | 对话页表现 |
|
|
||||||
|---|---|
|
|
||||||
| `conversation.snapshot` | 首帧状态同步，不重复插入消息。 |
|
|
||||||
| `user.message.created` | 刷新/多标签同步时补齐用户气泡。 |
|
|
||||||
| `manager.intent` | 总控“正在理解/已理解”的过程卡。 |
|
|
||||||
| `clarification.required` / `clarification.resolved` | 澄清卡及其回答状态。 |
|
|
||||||
| `manager.dispatch` | 总控派活卡、席位条状态更新。 |
|
|
||||||
| `seat.delivery.submitted` | 席位提交交付，进入总控审核而非直接完成。 |
|
|
||||||
| `manager.review.decision` | 展示验收、打回、改派或受控降级及其安全摘要。 |
|
|
||||||
| `seat.rework.assigned` / `seat.reassigned` | 更新第几次返工、原/新席位和新的任务要求。 |
|
|
||||||
| `stage.quality_gate` | 阶段质量闸门通过、阻塞或带缺口推进。 |
|
|
||||||
| `agent.message.start` / `delta` / `complete` | 席位或总控流式气泡。 |
|
|
||||||
| `tool.started` / `tool.progress` / `tool.completed` | 现有步骤卡/工具过程，不显示敏感参数。 |
|
|
||||||
| `approval.required` / `approval.decided` | 嵌入对话流的审批卡。 |
|
|
||||||
| `fact.confirmed` / `review.completed` | 事实/交叉审查摘要卡。 |
|
|
||||||
| `run.status` / `run.error` / `run.completed` | 顶部状态、失败重试与最终结果。 |
|
|
||||||
|
|
||||||
事件 `data` 必须先经过现有 MAF 安全规范化和二次展示脱敏；前端不负责猜测工具风险或修复敏感数据。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5. 后端改造计划
|
|
||||||
|
|
||||||
### MAF-R0：冻结错误原型并建立旧会商基线
|
|
||||||
|
|
||||||
**难度：D2（中低）｜负责人：前端/测试各 1 人｜前置：无**
|
|
||||||
|
|
||||||
- 将现有 `/page/maf/*` 标记为“实验原型”，从正式菜单移除；不得在其上继续新增业务功能。
|
|
||||||
- 记录旧会商的页面状态：空会商、发送后、意图澄清、总控派活、席位流式发言、审批、完成、失败恢复、历史切换。
|
|
||||||
- 为每种状态保存可复现的测试数据与截图基线；截图只作为视觉验收参考，不作为数据契约。
|
|
||||||
- 输出旧组件到新 MAF view-model 的映射清单，禁止直接搬旧 hook。
|
|
||||||
|
|
||||||
**验收：** 旧会商无行为回归；团队对“复制体验、替换编排”有书面映射表。
|
|
||||||
|
|
||||||
### MAF-R1：Conversation 聚合与消息持久化
|
|
||||||
|
|
||||||
**难度：D5（高）｜负责人：后端资深 1 人｜前置：R0**
|
|
||||||
|
|
||||||
新增/迁移 MAF 专用持久化模型：
|
|
||||||
|
|
||||||
- `maf_roundtable_conversations`：用户可见会商，至少包含 id、owner_user_id、title、task_context、安全状态、active_run_id、created_at、updated_at；
|
|
||||||
- `maf_roundtable_messages`：用户消息、总控/席位消息、澄清/审批/结果卡的稳定历史表示；
|
|
||||||
- `maf_roundtable_conversation_events`：conversation 维度严格递增的 `seq`、event_id、run_id、type、安全 data、created_at；
|
|
||||||
- 现有 `maf_roundtable_sessions/runs/events/seat_runs/actions/approvals` 保留为底层执行与审计记录；conversation 与内部 session/run 显式关联。
|
|
||||||
|
|
||||||
要求：
|
|
||||||
|
|
||||||
1. 发送用户消息、创建/占用 run、写入首个用户消息事件必须在清晰的事务边界内完成；失败不留“消息已显示但未运行”的孤儿状态。
|
|
||||||
2. 消息历史必须可在刷新后重建对话；不能只依赖内存或 SSE 临时帧。
|
|
||||||
3. 所有读写继续 owner-only；管理员诊断只读不扩大写权限。
|
|
||||||
4. 新迁移必须 SQLite/PostgreSQL/MySQL 可重复执行；旧 MAF 原型数据可保留，不强制伪造为新对话历史。
|
|
||||||
|
|
||||||
**验收：** 会话创建、连续发消息、刷新恢复、并发发送冲突、跨用户隔离、迁移幂等都有 API 和存储测试。
|
|
||||||
|
|
||||||
### MAF-R2：服务端 SSE Hub 与断线续传
|
|
||||||
|
|
||||||
**难度：D5（高）｜负责人：后端流式/并发经验者 1 人｜前置：R1**
|
|
||||||
|
|
||||||
- 新增 conversation stream 路由和 `ConversationEventHub`；Workflow/Dispatcher 的规范化事件落库后再发布，顺序是“先持久化、后通知”。
|
|
||||||
- SSE 连接先按 `after_seq` 重放，再订阅实时事件；重放和订阅切换期间必须有序、不丢帧、不重复。
|
|
||||||
- workflow 终态、审批等待、审批恢复、取消、失败重试都必须通过同一流通知。
|
|
||||||
- 不允许每个 SSE 客户端创建数据库轮询循环。服务端可以阻塞等待 hub 通知，事件重放只在连接/重连时发生。
|
|
||||||
- 写出单 worker 与多 worker 的实现边界；若部署配置多 worker，未接入分布式广播时健康检查必须明确告警并禁止该模式上线。
|
|
||||||
|
|
||||||
**验收：** 测试覆盖慢客户端、断线重连、`after_seq` 重放、同时打开两个标签、切换会商、取消、审批后恢复、进程内 hub 异常和终态自动关流。
|
|
||||||
|
|
||||||
### MAF-R3：总控意图理解与派活语义对齐
|
|
||||||
|
|
||||||
**难度：D5（高）｜负责人：MAF/Agent 负责人 1 人｜前置：R1，可与 R2 并行**
|
|
||||||
|
|
||||||
在现有 MAF Workflow 上增加用户对话入口状态，而不是让前端预先填 manager/seat/run：
|
|
||||||
|
|
||||||
1. 总控首先进行意图判断：普通问答、需要澄清、单席位任务、并行专家会商、链式业务会商、需要工具/写入。
|
|
||||||
2. 总控产出受 schema 校验的派活计划；只有服务端可将计划转成实际席位执行。
|
|
||||||
3. 每个计划项必须生成并冻结 `task_contract`（目标、交付结构、验收标准、必需性、返工上限和降级策略），席位的发言不等于交付完成。
|
|
||||||
4. 席位完成后先做确定性完整性检查，再由总控做结构化验收；总控可接受、打回同一席位、改派、请求用户补充或记录受控缺口。所有决策、次数和理由持久化到 checkpoint 与审计事件。
|
|
||||||
5. 默认初稿后最多两次同席位返工；到达上限优先改派一次，仍失败才以带风险标记的 `controlled_gap` 结束。严禁自动把不合格交付推进为合格事实。
|
|
||||||
6. 阶段迁移需经过质量闸门：所有必需任务均有 `accepted` 或受控缺口终态；最终总结只能消费已验收事实，缺口必须显式传入风险章节。
|
|
||||||
7. 席位集合来自业务链、可信能力快照和上下文；前端可呈现“建议/已参与席位”，但不能提交任意工具权限或 thread id。
|
|
||||||
8. 总控每轮应吸收已确认事实、验收结果、退回原因和用户追问；弱模型无效派活、重复派活、无收敛时走确定性纠偏/终止策略。
|
|
||||||
9. 已有 structured/group_chat、事实账本、交叉审查、审批 checkpoint、执行阶段身份均继续复用；只重构其输入输出为 conversation event。
|
|
||||||
|
|
||||||
**验收：** 用同一任务对照旧会商的意图澄清、总控派活、席位协作、打回/改派和收束结论；弱模型的短答、空答、错误 schema、缺证据、重复派活、非法席位、超轮次、返工上限和受控降级都有确定性保护测试。
|
|
||||||
|
|
||||||
#### R3 当前实施记录（2026-08-03）
|
|
||||||
|
|
||||||
后端已先完成 R3 的服务端核心骨架，作为 R1/R2 Conversation API/SSE 的后续：
|
|
||||||
|
|
||||||
- `app/maf_roundtable/dispatch_contracts.py` 提供确定性意图分类、服务端业务路线解析、schema 校验的 `MafDispatchPlan` 和弱模型防护；请求、模型输出都不能提供 agent id、thread id、tool metadata 或能力快照。
|
|
||||||
- `MafRoundtableConfig` 增加 `default_manager_agent_id`、`default_seat_agent_ids`、`business_routes` 和 `max_seats_per_run`。仓库配置保持空路线；上线前必须由部署配置填入实际 agent catalog 中的精确 id，未知业务路线失败关闭。
|
|
||||||
- 首条消息在同一事务内创建内部 session、服务端选定的 manager/seat participants 和冻结能力快照；澄清意图进入 `waiting_input`，不创建 run，用户补充信息后才允许重新 claim。
|
|
||||||
- Conversation service 已接入现有 `MafRunDispatcher`/`WorkflowRunner`，持久化 `manager.intent`、`manager.dispatch` 和 run 状态桥接事件；现有结构化工作流的席位集合仍只来自服务端 participants，manager 文本不能扩席或改派非法席位。
|
|
||||||
- V2 `POST /conversations/{id}/messages` 只返回 `message_id`、`conversation_id`、`seq`；`run_id` 仍是持久层/服务端内部关联字段，不返回给浏览器。
|
|
||||||
- 新增 `tests/test_maf_phase3_conversation_dispatch.py`，覆盖未知业务路线、默认路线、澄清、完成状态桥接、重复/越权派发计划等确定性用例。R3 尚未整体验收完成：仍需完成新页面、完整真实 MAF Workflow E2E、质量门禁和与旧会商体验的浏览器对照验收。
|
|
||||||
|
|
||||||
### MAF-R4：将审批和外部写入嵌回对话主链路
|
|
||||||
|
|
||||||
**难度：D4（较高）｜负责人：后端安全 + 前端各 1 人｜前置：R2、R3**
|
|
||||||
|
|
||||||
- 保留 Phase 5 的 WriteGuard、能力快照、HMAC 目标键、租约、加密参数、一次执行和审计；不得为了 SSE 改弱任何安全边界。
|
|
||||||
- `approval.required` 只携带白名单展示字段和安全摘要。审批决定后由后端自动续跑，前端只等待同一 SSE 流中的新事件。
|
|
||||||
- 拒绝、过期、执行失败、unknown 均形成清晰对话卡和可恢复状态；不得把“未知结果”伪装成成功。
|
|
||||||
- 行为审计可在最终结果区展开查看，但不能替代对话中的关键用户反馈。
|
|
||||||
|
|
||||||
**验收：** HTTP → MAF → ToolNode/outbox → 审批 → SSE → 前端卡片 的端到端测试；确保 target_key、idempotency_key、internal_canary、密钥和原始工具结果从不进入消息/API/SSE。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 6. 前端改造计划：复刻体验，替换状态源
|
|
||||||
|
|
||||||
### MAF-R5：新会商页面壳与历史列表
|
|
||||||
|
|
||||||
**难度：D4（较高）｜负责人：熟悉旧会商的前端 1 人｜前置：R0、R1**
|
|
||||||
|
|
||||||
新建 `src/maf-roundtable/conversation/**`，建议结构：
|
|
||||||
|
|
||||||
```text
|
|
||||||
maf-roundtable/conversation/
|
|
||||||
pages/MafRoundtableConversationPage.tsx
|
|
||||||
components/
|
|
||||||
ConversationSidebar.tsx
|
|
||||||
ConversationTimeline.tsx
|
|
||||||
ConversationComposer.tsx
|
|
||||||
ManagerDispatchCard.tsx
|
|
||||||
SeatMessageBubble.tsx
|
|
||||||
ToolProgressCard.tsx
|
|
||||||
ClarificationCard.tsx
|
|
||||||
ApprovalMessageCard.tsx
|
|
||||||
FinalResultCard.tsx
|
|
||||||
ParticipantStrip.tsx
|
|
||||||
hooks/
|
|
||||||
use-maf-conversations.ts
|
|
||||||
use-maf-conversation-stream.ts
|
|
||||||
use-maf-conversation-reducer.ts
|
|
||||||
api/conversations.ts
|
|
||||||
lib/event-reducer.ts
|
|
||||||
styles/maf-roundtable-legacy-compatible.css
|
|
||||||
```
|
|
||||||
|
|
||||||
页面要求：
|
|
||||||
|
|
||||||
- 左侧 `ConversationSidebar` 的层级、历史列表、新建、激活态、删除/重命名交互对齐旧会商；
|
|
||||||
- 中间 `ConversationTimeline` 使用连续消息流，保留旧会商的用户气泡、总控气泡、席位气泡和时间锚点；
|
|
||||||
- `ConversationComposer` 常驻底部；发送、停止、澄清回答、追问都在该入口完成；
|
|
||||||
- 右侧仅保留旧体验中真正有用的参与席位、当前阶段和业务链摘要，不再摆放 run/session 管理后台；
|
|
||||||
- 使用本地 `tdesign-react` 组件实现按钮、输入、Dialog、Tag、Tabs 等基础交互，同时通过 scoped CSS 对齐旧视觉；
|
|
||||||
- 视觉相似不等于 import 旧业务组件。旧组件仅作参考，数据类型、hook 和 API 必须是 MAF 专用实现。
|
|
||||||
|
|
||||||
**验收：** 不连接后端时，使用固定 MAF 事件样本可完整演示旧会商同等的 8 种关键状态；没有 session/run/thread 表单。
|
|
||||||
|
|
||||||
### MAF-R6：SSE 客户端、事件 reducer 与刷新恢复
|
|
||||||
|
|
||||||
**难度：D5（高）｜负责人：前端流式经验者 1 人｜前置：R2、R5**
|
|
||||||
|
|
||||||
- `use-maf-conversation-stream` 只维护一个连接、一个 cursor、一个 AbortController；不得含 `setInterval`、`refetchInterval` 或轮询 fallback。
|
|
||||||
- reducer 以 `(conversation_id, seq)` 去重并排序，将原始事件转为稳定 view model；流式 delta 必须按 `message_id` 合并，不能用数组下标。
|
|
||||||
- 切换会商时先 abort 旧流并增加 generation；旧 SSE 帧永远不能污染新会商。
|
|
||||||
- 刷新时先加载消息历史，再以最后 seq 订阅；网络断开显示“正在重连”，重连成功不重复气泡。
|
|
||||||
- 只有历史列表等非实时资源可在用户主动操作后调用 GET；不能靠后台刷新伪装实时性。
|
|
||||||
|
|
||||||
**验收：** 模拟 1 万条历史、跨页加载、慢旧流切换、新流先到、断线重连、重复帧、乱序帧、终态关流和多标签同步；所有案例必须组件级测试。
|
|
||||||
|
|
||||||
### MAF-R7：意图/派活/审批卡的旧体验兼容
|
|
||||||
|
|
||||||
**难度：D4（较高）｜负责人：前端业务负责人 1 人｜前置：R3、R4、R6**
|
|
||||||
|
|
||||||
- 用旧 `IntentClarificationCard`、`MessageStepsCard`、`ParallelSeatStrip`、`MessageBubble` 的交互作为视觉和信息架构参照，重新实现 MAF 版本。
|
|
||||||
- 总控派活计划必须先显示“将由谁做什么”，席位开始/结束、工具过程和交叉审查要回到原有对话叙事中。
|
|
||||||
- 席位“发言结束”只能显示为“已提交，待总控审核”；只有收到 `manager.review.decision=accept` 才能显示“已验收”。打回次数、改派和缺口必须清楚可见。
|
|
||||||
- 审批卡需要同步防双击锁、二次脱敏、拒绝/通过后的“等待工作流继续”状态；不可另外跳转到 action 审计页。
|
|
||||||
- 最终结论卡要区分“建议动作”“审批中动作”“已执行动作”“失败/未知动作”。
|
|
||||||
- 继续追问时，页面不新建多个用户可见线程；后端根据 conversation 上下文决定是否创建新 run 或继续恢复。
|
|
||||||
|
|
||||||
**验收：** 产品人员可在不看技术术语的情况下完成“发起会商 → 澄清 → 观察派活 → 审批 → 查看结论 → 追问”全链路。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 7. 测试、上线与回滚
|
|
||||||
|
|
||||||
### 7.1 必须新增的自动化测试
|
|
||||||
|
|
||||||
| 类别 | 核心用例 |
|
|
||||||
|---|---|
|
|
||||||
| 后端事务 | 发消息/创建 run 原子性、并发发送、跨用户隔离、迁移幂等。 |
|
|
||||||
| SSE 服务端 | 重放、顺序、心跳、取消、断线、审批恢复、多订阅者、终态关流。 |
|
|
||||||
| Workflow | 意图澄清、总控派活、弱模型格式错误、重复派活、最大轮次、恢复。 |
|
|
||||||
| 质量闸门 | 短答/空答、缺少必填章节、无证据、总控打回、两次返工上限、一次改派、受控缺口、阶段阻塞和最终报告不把缺口伪装成事实。 |
|
|
||||||
| 安全 | SSE/API/历史消息不泄露敏感键和值；审批和一次写入仍保持现有 Phase 5 保证。 |
|
|
||||||
| 前端 reducer | delta 合并、去重、乱序、切换代次隔离、重连 cursor。 |
|
|
||||||
| 前端组件 | 输入发送、澄清、派活、审批锁、取消、失败恢复、历史切换、无轮询断言。 |
|
|
||||||
| E2E | 从用户输入到真实 MAF Workflow、ToolNode/outbox、审批、最终结果的 SSE 全链路。 |
|
|
||||||
| 回归 | 旧 `roundtable-planning`、旧 DeerFlow、AI 写作以及既有 MAF Phase 1–5 用例全部通过。 |
|
|
||||||
|
|
||||||
### 7.2 人工视觉验收
|
|
||||||
|
|
||||||
在同一浏览器尺寸下对照旧会商，至少核对：
|
|
||||||
|
|
||||||
1. 空白页和新建会商；
|
|
||||||
2. 左侧历史/当前会商切换；
|
|
||||||
3. 用户输入、流式总控消息、席位消息；
|
|
||||||
4. 意图澄清和总控派活；
|
|
||||||
5. 工具过程、审批、取消、失败恢复；
|
|
||||||
6. 最终结论和连续追问；
|
|
||||||
7. 窄屏滚动、长内容、断线重连和页面刷新。
|
|
||||||
|
|
||||||
### 7.3 灰度与回滚
|
|
||||||
|
|
||||||
- 新入口使用独立 feature flag，例如 `maf_roundtable.conversation_ui_enabled`；旧会商不受该开关影响。
|
|
||||||
- 先仅向内部账号开放，记录连接数、重连率、事件延迟、工作流失败率、审批耗时和前端异常。
|
|
||||||
- 出现问题时关闭新入口即可；不迁移或删除旧会商数据，也不需要回滚旧页面。
|
|
||||||
- 当前错误原型可保留为仅开发者诊断路由，或在新版稳定后删除；它不应继续出现在用户菜单。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 8. 分阶段任务分配、难度与交付顺序
|
|
||||||
|
|
||||||
本节是分工的唯一依据。难度定义：D1=很低（局部文案/样式），D2=低（明确边界的小模块），D3=中（跨 2–3 个模块），D4=较高（跨前后端或需回归），D5=高（并发、状态机、安全或 Agent 行为，必须由有经验者负责）。
|
|
||||||
|
|
||||||
### 阶段 0：冻结错误原型，提取旧会商交互基线（R0）
|
|
||||||
|
|
||||||
**难度：D2｜建议人员：1 名熟悉旧会商的前端 + 1 名测试｜依赖：无**
|
|
||||||
|
|
||||||
具体要做：
|
|
||||||
|
|
||||||
1. 将现有 `/page/maf/*` 的 session/run 详情原型从正式菜单隐藏，标注为开发诊断原型，停止继续加功能。
|
|
||||||
2. 逐一记录旧会商的 8 类页面状态：空白/新建、历史切换、用户提问、意图澄清、总控派活、席位发言、审批、完成/失败恢复。
|
|
||||||
3. 给每种状态保留可复现 mock 数据、页面截图和操作步骤；梳理旧组件到新 MAF view-model 的映射。
|
|
||||||
4. 明确哪些只能参考视觉和交互，哪些旧业务 hook/API/状态禁止复用。
|
|
||||||
|
|
||||||
交付物：旧会商交互地图、截图基线、组件映射表、被隐藏的原型入口说明。
|
|
||||||
|
|
||||||
验收：旧会商没有代码行为变化；任何人可以根据基线判断新版是否“像原页面”。
|
|
||||||
|
|
||||||
### 阶段 1：建立用户可见 Conversation 与消息历史（R1）
|
|
||||||
|
|
||||||
**难度：D5｜建议人员：1 名资深后端｜依赖：阶段 0**
|
|
||||||
|
|
||||||
具体要做：
|
|
||||||
|
|
||||||
1. 新增 `maf_roundtable_conversations`、`maf_roundtable_messages`、`maf_roundtable_conversation_events`，设计 owner、标题、消息、conversation 全局序号、活跃 run 和安全状态字段。
|
|
||||||
2. 建立 conversation 与现有 MAF session/run/seat-run 的内部关联；用户只得到 conversation id，不能看到内部 thread id。
|
|
||||||
3. 实现会商历史列表、创建空白会商、读取会商快照、读取消息分页、发送用户消息五类 API。
|
|
||||||
4. 发送消息时，用户消息持久化、run 创建/占用和首个事件必须有明确事务边界；并发发送、重复请求、失败回滚都要处理。
|
|
||||||
5. 完成 SQLite/PostgreSQL/MySQL 迁移与 owner-only 权限测试。
|
|
||||||
|
|
||||||
交付物：迁移脚本、repository/service/router、API schema、后端事务与隔离测试。
|
|
||||||
|
|
||||||
验收：刷新后能从消息历史恢复完整会商；跨用户不可读写；失败不会留下“已显示但没有实际运行”的孤儿消息。
|
|
||||||
|
|
||||||
### 阶段 2：服务端 SSE 对话流、事件 Hub 与断线续传（R2）
|
|
||||||
|
|
||||||
**难度：D5｜建议人员：1 名熟悉 FastAPI 异步流与并发的后端｜依赖：阶段 1**
|
|
||||||
|
|
||||||
具体要做：
|
|
||||||
|
|
||||||
1. 实现 `GET /conversations/{id}/stream?after_seq=`，按 conversation 全局 seq 先重放、后订阅实时事件。
|
|
||||||
2. 新建 `ConversationEventHub`；所有 workflow 事件先安全落库，再按顺序广播。禁止 SSE 客户端通过定时查库等待更新。
|
|
||||||
3. SSE 实现心跳、连接取消、权限校验、终态关流、异常帧和断线后的 cursor 续传。
|
|
||||||
4. 明确多 worker 部署方案：单 worker 可进程内广播；多 worker 必须 Redis Pub/Sub 或等价方案，未满足时不能灰度上线。
|
|
||||||
5. 把 run 状态、总控派活、席位消息 delta、工具过程、审批、质量审核、最终结论全部映射为统一事件信封。
|
|
||||||
|
|
||||||
交付物：SSE router/hub、事件发布适配器、集成测试、部署说明。
|
|
||||||
|
|
||||||
验收：慢连接、断线重连、乱序/重复防护、多标签订阅、审批后续跑、取消和终态均不丢事件；前端不需要轮询任何实时资源。
|
|
||||||
|
|
||||||
### 阶段 3：总控意图理解、业务链选择与服务端派活（R3）
|
|
||||||
|
|
||||||
**难度：D5｜建议人员：1 名 MAF/Agent 工程师｜依赖：阶段 1；可与阶段 2 并行**
|
|
||||||
|
|
||||||
具体要做：
|
|
||||||
|
|
||||||
1. 将旧会商的意图理解能力迁到 MAF 总控入口：识别直接问答、需澄清、单席位、并行会商、链式业务会商、工具/写入请求。
|
|
||||||
2. 总控根据业务链、用户上下文、可信能力快照选择席位，生成 schema 校验的派活计划；前端只展示，不参与编排。
|
|
||||||
3. Dispatcher 在服务端按需创建/复用 manager 和 seat 的内部执行线程，并由 `ExecutionPrincipal` 绑定当前用户。
|
|
||||||
4. 对弱模型增加确定性保护：非法席位、空派活、重复派活、无效 schema、超轮次、无法收束必须被拒绝、纠偏或终止。
|
|
||||||
5. 保持既有工具、技能、MCP、沙箱、事实账本、交叉审查和 checkpoint 恢复可用。
|
|
||||||
|
|
||||||
交付物：总控状态 schema、workflow executor、派活事件、弱模型测试矩阵。
|
|
||||||
|
|
||||||
验收：用户只输入任务，就能看到“意图理解 → 总控派活 → 席位执行”；浏览器没有 thread map 和派活决策代码。
|
|
||||||
|
|
||||||
### 阶段 4：席位任务合同、总控验收、打回与强制收束（R3-Q）
|
|
||||||
|
|
||||||
**难度：D5｜建议人员：1 名 Agent/MAF 工程师 + 1 名后端状态机工程师｜依赖：阶段 3**
|
|
||||||
|
|
||||||
具体要做：
|
|
||||||
|
|
||||||
1. 总控发布任务时冻结 `task_contract`：具体目标、交付格式、验收标准、必需性、返工次数、改派与降级策略。
|
|
||||||
2. 为每项席位任务持久化状态机：`assigned → delivering → submitted → manager_review → accepted/rework/reassigned/controlled_gap`。
|
|
||||||
3. 席位提交后先做确定性质量检查：空答、过短、必填章节缺失、格式错、无证据、重复内容等均不能自动完成。
|
|
||||||
4. 总控必须生成结构化验收决定和原因；不合格时打回并带精确补充要求。默认最多两次同席位返工，之后最多一次改派。
|
|
||||||
5. 改派仍失败时只能产生 `controlled_gap`，标记风险、缺失项和最终报告影响；严禁伪装为成功。
|
|
||||||
6. 增加阶段质量闸门：所有必需任务处于 `accepted` 或 `controlled_gap`，才允许进入交叉审查/下一阶段/最终总结。
|
|
||||||
7. 将尝试次数、退回理由、验收结果和缺口写入 checkpoint、审计和 SSE。
|
|
||||||
|
|
||||||
交付物：任务合同模型、持久化表/迁移、质量状态机、总控审查 prompt/schema、事件和测试。
|
|
||||||
|
|
||||||
验收：席位只说一两句话、无依据或内容垃圾时会被明确打回；达到上限不会死循环，也不会被当作合格产出；最终报告可追溯所有缺口。
|
|
||||||
|
|
||||||
### 阶段 5：审批、WriteGuard 与外部动作嵌入对话流（R4）
|
|
||||||
|
|
||||||
**难度：D4｜建议人员：1 名安全后端 + 1 名前端｜依赖：阶段 2、3、4**
|
|
||||||
|
|
||||||
具体要做：
|
|
||||||
|
|
||||||
1. 保留现有 Phase 5 的可信能力快照、WriteGuard、目标租约、HMAC、加密参数、一次执行与审计，不允许为新页面降低安全性。
|
|
||||||
2. 将工具开始、审批请求、批准/拒绝、执行成功/失败/unknown 变成安全 SSE 事件和对话卡。
|
|
||||||
3. 审批点击只调用明确决策 API；后端负责恢复 checkpoint/workflow，浏览器只等待 SSE。
|
|
||||||
4. 安全展示统一二次脱敏，禁止 target_key、idempotency_key、internal_canary、密钥、凭据和原始工具结果进入 API、消息、SSE 或 DOM。
|
|
||||||
|
|
||||||
交付物：事件映射、审批消息卡契约、端到端 ToolNode/outbox 测试。
|
|
||||||
|
|
||||||
验收：一次真实测试写入能在对话里经历“申请 → 审批 → 继续 → 结果”；重复点击或断线都不会重复外部写入。
|
|
||||||
|
|
||||||
### 阶段 6：复刻旧会商页面壳、历史列表和输入框（R5）
|
|
||||||
|
|
||||||
**难度：D4｜建议人员：1 名熟悉旧会商代码的前端｜依赖：阶段 0、1**
|
|
||||||
|
|
||||||
具体要做：
|
|
||||||
|
|
||||||
1. 新建 MAF 专用 conversation 页面、路由和独立 feature flag；不修改旧 `RoundtablePlanningPage`。
|
|
||||||
2. 依据阶段 0 的映射，复刻左侧历史会话、新建会商、中心时间线、常驻输入框、参与席位区和业务链摘要的视觉与交互层级。
|
|
||||||
3. 基础组件使用本地 `tdesign-react`，旧页面仅参考；需要的视觉组件在 MAF 目录重写或抽无业务依赖公共组件。
|
|
||||||
4. 接上 Conversation API：创建、历史、切换、消息分页。此阶段不允许先做任何轮询实时逻辑。
|
|
||||||
5. 删除新页面中暴露给用户的 manager/seat/max round/session/run 创建表单。
|
|
||||||
|
|
||||||
交付物：新页面壳、MAF 专用 view model、静态/接口 mock 组件测试、视觉对照截图。
|
|
||||||
|
|
||||||
验收：即使 SSE 未接通，用户也能看到与旧会商同类的历史、对话与输入体验；新旧业务状态零耦合。
|
|
||||||
|
|
||||||
### 阶段 7：前端 SSE 消费、对话 reducer 与过程交互（R6 + R7）
|
|
||||||
|
|
||||||
**难度：D5｜建议人员：1 名前端流式工程师 + 1 名前端业务工程师｜依赖：阶段 2、4、5、6**
|
|
||||||
|
|
||||||
具体要做：
|
|
||||||
|
|
||||||
1. 实现单连接 `use-maf-conversation-stream`：fetch-reader SSE、cursor、AbortController、指数退避重连和会商切换 generation 隔离。
|
|
||||||
2. 实现 event reducer：按 `conversation_id + seq` 去重排序；按 message_id 合并 delta；刷新后历史与 SSE 无缝衔接。
|
|
||||||
3. 重写旧会商对应的 MAF 版组件：总控意图卡、派活卡、席位条、席位气泡、工具步骤、澄清卡、审批卡、质量审核/打回卡、结果卡。
|
|
||||||
4. 所有卡片在时间线内叙事，不另开 run/session 管理后台；继续追问仍使用同一输入框。
|
|
||||||
5. 页面必须显示待审核、已验收、返工次数、改派、受控缺口和恢复状态，不能把“发过言”显示为“已完成”。
|
|
||||||
6. 代码审查和测试中检查不存在 `setInterval`、`refetchInterval` 或事件轮询 fallback。
|
|
||||||
|
|
||||||
交付物：SSE hook、reducer、对话组件、组件/API mock 测试、无轮询静态检查。
|
|
||||||
|
|
||||||
验收：切换会商、断线重连、审批续跑、慢旧流回包、长会话翻页均不污染、不丢消息、不重复；整个会商过程只依赖 SSE 实时更新。
|
|
||||||
|
|
||||||
### 阶段 8：端到端验收、灰度和回滚演练（R8）
|
|
||||||
|
|
||||||
**难度：D4｜建议人员：1 名测试/集成人 + 各阶段负责人配合｜依赖：阶段 1–7**
|
|
||||||
|
|
||||||
具体要做：
|
|
||||||
|
|
||||||
1. 跑完后端事务/SSE/Workflow/质量闸门/WriteGuard 测试、前端 reducer/组件测试、旧会商与 DeerFlow 回归。
|
|
||||||
2. 在真实浏览器按阶段 0 截图基线逐项对照，并完成用户任务：发起、澄清、派活、短答打回、两次返工、改派、审批、受控缺口、结论和追问。
|
|
||||||
3. 内部账号灰度，观测 SSE 建连/重连、事件时延、派活/验收/返工次数、workflow 失败率、审批耗时和前端错误。
|
|
||||||
4. 验证关闭 feature flag 后立即回到旧会商入口，旧数据和旧任务不受影响。
|
|
||||||
5. 若需生产外部写入，补齐 UAT 系统、最小权限凭据、核验 API、补偿联系人和生产 `MAF_ACTION_SECRET_KEY`。
|
|
||||||
|
|
||||||
交付物：自动化结果、人工验收记录、灰度指标面板、回滚演练记录、上线清单。
|
|
||||||
|
|
||||||
验收：满足第 9 节全部条件后才允许标记开发完成。
|
|
||||||
|
|
||||||
### 8.1 可并行边界
|
|
||||||
|
|
||||||
- 阶段 2 与阶段 3 可在阶段 1 的 schema/API 定稿后并行，但二者必须共用同一事件信封。
|
|
||||||
- 阶段 6 可在阶段 1 的 API mock 契约定稿后提前开始；不得自行发明事件字段。
|
|
||||||
- 阶段 5 必须等待阶段 2、3、4 的安全事件与状态机定稿。
|
|
||||||
- 阶段 7 必须等待阶段 2、4、6，不能以轮询临时替代 SSE。
|
|
||||||
- 阶段 8 只做集成、验收和上线准备，不补写前面阶段缺失的核心设计。
|
|
||||||
|
|
||||||
建议主顺序：`阶段 0 → 阶段 1 → (阶段 2 + 阶段 3 + 阶段 6) → 阶段 4 → 阶段 5 → 阶段 7 → 阶段 8`。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 9. 最终验收定义
|
|
||||||
|
|
||||||
只有同时满足以下条件，才可以说“本次 MAF 会商升级开发完成”：
|
|
||||||
|
|
||||||
- 新页面在视觉和主交互上可被用户认作原多智能体会商的升级版；
|
|
||||||
- 页面具备历史会话、连续对话流、输入框、意图理解、总控派活、席位协作、澄清、审批、结果和追问；
|
|
||||||
- 每个必需席位任务都有任务合同、总控验收、有限返工和改派/受控缺口处理；席位短答或垃圾产出不能自动被当作完成；
|
|
||||||
- 浏览器没有会商事件/run/approval 的定时轮询；实时交互通过可重连 SSE 完成；
|
|
||||||
- 用户不需要创建或管理多个智能体线程，内部线程由服务端按用户身份安全创建和恢复；
|
|
||||||
- 新页面未调用旧会商业务 API/状态，旧会商零回归；
|
|
||||||
- 工具、技能、MCP、沙箱、审批、WriteGuard、一次写入和审计都仍可用；
|
|
||||||
- 自动化测试、SSE 故障测试、真实浏览器人工验收和旧功能回归全部通过；
|
|
||||||
- 真实 UAT 写入系统、最小权限凭据、外部核验 API、补偿协议及生产 `MAF_ACTION_SECRET_KEY` 已按 Phase 5 前置条件完成。
|
|
||||||
|
|
||||||
在这之前，任何“会话/run 原型页面通过构建或轮询测试”的结果，都只能算技术验证，不算产品升级验收。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 阶段 3 实施记录（当前代码基线）
|
|
||||||
|
|
||||||
本轮已补齐阶段 3 的服务端安全路由与真实 MAF Workflow 入口，范围仅针对新 MAF 会商；旧 DeerFlow、旧 roundtable 和 AI 写作行为不变。
|
|
||||||
|
|
||||||
### 配置与入口闸门
|
|
||||||
|
|
||||||
- 仓库默认 `maf_roundtable.enabled: false`。部署环境必须注入真实的 `default_manager_agent_id`、席位 ID 和业务路由后再开启，避免出现“入口显示正常但首条消息必然 503”的空配置。
|
|
||||||
- 健康接口返回非敏感的 `conversation_dispatch_ready` 与 `conversation_dispatch_status`；新会商入口只有在配置路由可用且服务已启用时才开放。
|
|
||||||
- 首条消息使用服务端可信能力快照校验 manager/seat 的可访问性；浏览器、会话请求和模型输出都不能提供或扩大 agent、thread、tool、capability 范围。
|
|
||||||
- 配置模型会清理并校验 manager/seat ID，拒绝 manager 出现在 seat 列表、重复席位、超过 `max_seats_per_run` 的路由和非法业务 code。
|
|
||||||
|
|
||||||
### 受约束的总控派活
|
|
||||||
|
|
||||||
服务端先由业务链与可信 capability snapshot 生成候选席位集合。总控模型只能返回严格 JSON：`intent_type`、`selected_seat_agent_ids`、每席 `task_goal`/`delivery_requirements`、`execution_mode`、`convergence_path` 和 `reason`。Pydantic schema、服务端 allowlist 和顺序校验全部通过后，最终计划才会写入 checkpoint，并产生 `manager.dispatch` 审计/SSE 投影。
|
|
||||||
|
|
||||||
非法席位、重复席位、空任务、错误 schema、席位超限、缺少收敛路径或链式顺序错误，统一回退到服务端安全计划，不会扩大权限或启动越权席位。
|
|
||||||
|
|
||||||
四种结构化拓扑已固定为：
|
|
||||||
|
|
||||||
- `direct_answer`：manager-only Workflow，不创建专家席位任务；
|
|
||||||
- `single_seat` / `tool_write`：一个可信席位；
|
|
||||||
- `parallel_consultation`：至少两个可信席位并行；
|
|
||||||
- `chain_consultation`：按服务端业务链顺序串行。
|
|
||||||
|
|
||||||
### 阶段 3 验证状态
|
|
||||||
|
|
||||||
已覆盖配置校验、候选路由、非法总控计划回退、manager-only 真实 `WorkflowBuilder` 拓扑、线程/执行阶段回归、旧 DeerFlow 回归和会话 API 回归。当前仍不能据此标记整个 MAF 项目或阶段 5 为“验收完成”；真实 UAT 写入系统、最小权限凭据、外部核验 API、补偿协议和生产 `MAF_ACTION_SECRET_KEY` 仍按阶段 5/8 前置条件保持阻塞。
|
|
||||||
|
|
||||||
### Stage 3 P0 dispatch correction
|
|
||||||
|
|
||||||
- New MAF conversations no longer classify user text with server keyword rules. The server first freezes only the business-route candidate set and trusted, redacted capability summary; `ManagerDispatchExecutor` then returns the strict intent-and-dispatch JSON contract.
|
|
||||||
- The final plan is Pydantic-validated and allowlisted before it is checkpointed. Invalid JSON, illegal intent or seat, missing convergence, manager failure, and timeout all finish on the clarification branch; they do not create expert threads or start expert/tool work.
|
|
||||||
- A conversation initially persists and binds the manager only. After a valid decision, only `selected_seat_agent_ids` are added to the participant store and receive internal threads.
|
|
||||||
- Every non-clarification route, including `group_chat`, starts at the same manager dispatch node. Group speakers are limited to the verified selected seats; static candidate configuration cannot bypass the plan.
|
|
||||||
File diff suppressed because it is too large.
Load diff
@@ -1,514 +0,0 @@
|
|||||||
# 多智能体规划 · 后台挂起执行 + 进度可视化 —— 分步实现方案
|
|
||||||
|
|
||||||
> 目标：在「多智能体规划」第二步增加**后台挂起**能力——把当前任务挂到后台，自动一路跑到
|
|
||||||
> 最后一步（Step3 结果绘制完成）为止；历史记录下拉框里进行中的任务显示加载动画；点击进行中
|
|
||||||
> 的任务弹出一个**大弹窗**，里面是**横向的智能体派活链路流程图**（节点 = 各席位智能体，图标 +
|
|
||||||
> 名称，不同颜色，正在发言的节点和它的连接线带加载动画）；弹窗里有「查看」按钮，点击进入正在
|
|
||||||
> 进行中的任务实时观察。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 0. 现状与架构事实（动手前必读）
|
|
||||||
|
|
||||||
研究自现有代码，决定了整套方案的形态。**关键结论：当前编排循环跑在前端，离开页面即中断。**
|
|
||||||
|
|
||||||
### 0.1 前端现状
|
|
||||||
|
|
||||||
| 事实 | 位置 |
|
|
||||||
|------|------|
|
|
||||||
| Step2 编排循环（leader → 顺序派 special → leader … 直到 `dispatched===[]` 共识 / `MAX_CYCLES=8`）**完全由前端 hook 驱动** | `src/roundtable-planning/hooks/useStep2Orchestration.ts:992-1204`（recommend）、`1228-1439`（chain） |
|
|
||||||
| 循环由 `currentStep===2` 的 `useEffect` 启停；离开 Step2 的 cleanup 会 `orchestrationCancelRef.current=true` + `abortAllInFlight()` 中断 | `useStep2Orchestration.ts:1468-1541`（尤其 cleanup `1534-1537`、`1471-1477`） |
|
|
||||||
| 共识判定：`leaderRes.dispatched.length===0` → `setHasConsensus(true)` | `useStep2Orchestration.ts:1091-1099` |
|
|
||||||
| 进入 Step3：手动点按钮，前置 `hasConsensus===true` | `Step2Panel.tsx:370-381`、`RoundtablePlanningPage.tsx:586-595` |
|
|
||||||
| Step3「结果绘制」：前端流式调 `roundtable-report` 智能体，写出 `outputs/方案总览.html`，`phase→"done"` 即完成 | `src/roundtable-planning/hooks/useStep3Report.ts:36,51,165,560-596,636-652` |
|
|
||||||
| 草稿持久化：`/api/roundtable-drafts`，含 step1/step2/step3 三段快照 + `furthestStep(1|2|3)`，**无显式 status 字段** | `src/roundtable-planning/api/drafts.ts:25-110,112,184-225` |
|
|
||||||
| 历史下拉 UI（触发按钮 + 列表 + 重命名/删除） | `RoundtablePlanningPage.tsx:771-892` |
|
|
||||||
| 自动保存触发点（Step1 回复完 / Step2 每轮气泡收尾 / Step3 报告保存 / 步骤前进） | `useDraftPersistence.ts:248-316` |
|
|
||||||
| 加载草稿恢复：`handleLoadDraft` → `getDraft` → `cancelAllStreams` → hydrate → `setCurrentStep(furthestStep)` | `useDraftPersistence.ts:308-368` |
|
|
||||||
|
|
||||||
### 0.2 后端现状
|
|
||||||
|
|
||||||
| 事实 | 位置 |
|
|
||||||
|------|------|
|
|
||||||
| `/api/multi-agent/init`：为各席位并行建 thread + 单例总控 `roundtable-coordinator`，SSE 返回 `seat_ready`/`coordinator_ready`/`init_done(thread_ids)` | `app/gateway/routers/multi_agent.py:647-823` |
|
|
||||||
| `/api/multi-agent/run/stream`：驱动**单轮** leader 或 special 的 LLM 执行，末尾 JSON 帧 `status`（派活列表 / `[]` 共识 / `clarification` / `error`） | `multi_agent.py:1076-1142` |
|
|
||||||
| `/api/multi-agent/report/init`：为 Step3 报告建 thread | `multi_agent.py`（report/init） |
|
|
||||||
| **后端不存在编排循环**——leader 派活由前端解释后再逐个发 `run/stream`；后端只做单轮执行 + 把派活/完成「广播」追加进各 thread 历史消息 | `multi_agent.py:24-29,487-502,1108-1142` |
|
|
||||||
| 派活格式：`agent_orchestration` 工具调用 `{agent_name, task}`（旧式 bash 解析兼容） | `multi_agent.py:525-552` |
|
|
||||||
|
|
||||||
### 0.3 可复用模板：AI 写作的「后台多阶段流程」
|
|
||||||
|
|
||||||
AI 写作已经把「后台跑多阶段流程 + 前端 SSE 订阅 + 可 resume + 定时清理」跑通了，**圆桌后台作业直接照搬这套**：
|
|
||||||
|
|
||||||
| 模板要素 | 位置 |
|
|
||||||
|------|------|
|
|
||||||
| LangGraph 图驱动多阶段（researching/writing_outline/writing_draft/reviewing/…），条件路由推进，`interrupt()` 暂停点等用户输入 | `packages/harness/deerflow/agents/ai_writing/graph.py`、`nodes/*`（`pause_material_confirm` 等 `45-290`） |
|
|
||||||
| Session 持久化表 `ai_writing_sessions`：`id/user_id/title/status/draft_*/transcript(LONGTEXT)/...`，`status∈{in_progress,done,error}` | `packages/harness/deerflow/persistence/ai_writing_sessions/model.py:14-39` |
|
|
||||||
| `transcript` 用 `PortableLongText`（MySQL LONGTEXT，避开 64KB），时间用 `BeijingDateTime` | 同上 `27-38` |
|
|
||||||
| 进度走 LangGraph Server 标准流 `stream_mode=["messages-tuple","values"]`，**graph 在 langgraph runtime 里跑，任意 worker 可 join stream**（这是后台健壮性的关键） | `ai_writing.py:1-17`、`langgraph.json:16-18` |
|
|
||||||
| Checkpointer 共享 `AsyncSqliteSaver`，落 `.deer-flow/data/checkpoints.db`（需挂数据卷） | `runtime/checkpointer/async_provider.py` |
|
|
||||||
| Cleanup cron（leader 文件锁、活跃保护、先删 CP 再删 DB、admin 手动触发） | `app/gateway/ai_writing_cleanup.py:26,34-59,111-135,193-215,307-367` |
|
|
||||||
| **多 worker 坑**：模块级内存 dict（`_event_queues`）每 worker 一份会丢会话；SSE 进程内直调会整段 buffer。解法：状态进 DB+checkpointer、SSE 走真 TCP loopback `127.0.0.1`（`trust_env=False` 禁代理） | `multi_agent.py:271-293`、`AIWritingPage.tsx` 文件头注释 §3/§5 |
|
|
||||||
|
|
||||||
### 0.4 决策（已与产品确认）
|
|
||||||
|
|
||||||
1. **后端真后台执行**：把编排循环搬到后端 run，刷新 / 关页 / 换设备都不中断。
|
|
||||||
2. **流程图节点 = 智能体派活链路**：横向排列的席位节点，正在发言的节点 + 连接线加载动画。
|
|
||||||
|
|
||||||
> ⚠️ **本方案最大的工作量在 Phase 2**：把目前跑在前端 TS 里的编排循环（`runOrchestration`/`runChainOrchestration`）
|
|
||||||
> 移植成一个后端 **LangGraph「圆桌总控编排图」**。这是与 AI 写作一致、可在 LangGraph runtime 里
|
|
||||||
> 后台跑且天然 checkpoint 的健壮路径。下文每个阶段都给出验收标准，可独立提测。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 总体架构
|
|
||||||
|
|
||||||
```
|
|
||||||
┌─────────────────────────────── 前端 (frontend-web) ───────────────────────────────┐
|
|
||||||
│ Step2Panel ──「后台挂起」按钮──▶ POST /api/roundtable-jobs (start) │
|
|
||||||
│ HistoryDropdown ── 进行中任务显示 spinner ──▶ 点击 ──▶ DispatchChainModal(大弹窗) │
|
|
||||||
│ DispatchChainModal ── 订阅 GET /api/roundtable-jobs/{id}/stream(SSE) │
|
|
||||||
│ 横向派活链路流程图(节点=席位, 活动节点+连线动画) ──「查看」──▶ 进入任务实时观察 │
|
|
||||||
└───────────────────────────────────────────────────────────────────────────────────┘
|
|
||||||
│ SSE 进度 / 快照
|
|
||||||
┌─────────────────────────────── 后端 (backend) ─────────────────────────────────────┐
|
|
||||||
│ /api/roundtable-jobs 路由层(start/get/stream/resume/cancel) ── 仿 ai_writing.py │
|
|
||||||
│ │ 启动后台 run │
|
|
||||||
│ LangGraph「圆桌总控编排图」 roundtable_orchestrator ── 仿 ai_writing graph │
|
|
||||||
│ init → leader_call → parse_dispatch → dispatch_seats(顺序) → loop ↺ │
|
|
||||||
│ → consensus → report_draw(写 HTML) → done （clarification 点 interrupt()) │
|
|
||||||
│ │ 每次状态转移持久化进度 │
|
|
||||||
│ roundtable_jobs 表(status/phase/dispatch_chain/active_speaker/...) + 共享 checkpointer│
|
|
||||||
│ cleanup cron (仿 ai_writing_cleanup.py) │
|
|
||||||
└───────────────────────────────────────────────────────────────────────────────────┘
|
|
||||||
```
|
|
||||||
|
|
||||||
**核心思路**：后台作业 = 一个 LangGraph 图的一次 run。图节点内部复用现有的单轮执行能力
|
|
||||||
（`multi_agent.py` 里 leader/special 的 run 逻辑），把「解释派活 → 顺序派活 → 回到 leader」的
|
|
||||||
循环从前端搬进图节点。前端从「驱动者」退化为「观察者」：通过 SSE 订阅进度渲染。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 数据契约（前后端共享，先定义后实现）
|
|
||||||
|
|
||||||
### 2.1 作业状态机 `JobStatus`
|
|
||||||
|
|
||||||
```
|
|
||||||
queued # 已创建，等待 worker 拉起
|
|
||||||
running # 编排进行中（Step2 派活循环 / Step3 绘制）
|
|
||||||
awaiting_input # 命中 clarification，等用户回答（interrupt 挂起）
|
|
||||||
done # 已跑到 Step3 绘制完成
|
|
||||||
error # 出错终止
|
|
||||||
cancelled # 用户取消
|
|
||||||
```
|
|
||||||
|
|
||||||
### 2.2 作业阶段 `JobPhase`（细化给流程图/进度条用）
|
|
||||||
|
|
||||||
```
|
|
||||||
initializing # 建 thread / 总控就绪
|
|
||||||
leader_thinking # 总控在决策派活
|
|
||||||
dispatching # 正在顺序派活给席位（配合 active_speaker）
|
|
||||||
consensus # 共识达成（dispatched=[]）
|
|
||||||
report_drawing # Step3 报告绘制中
|
|
||||||
report_done # 绘制完成
|
|
||||||
```
|
|
||||||
|
|
||||||
### 2.3 派活链路节点 `DispatchChainNode`（流程图核心数据）
|
|
||||||
|
|
||||||
```ts
|
|
||||||
interface DispatchChainNode {
|
|
||||||
agentId: string; // 席位 agent_id（小写）
|
|
||||||
name: string; // 显示名
|
|
||||||
avatarType: string; // 复用 getAvatarTypeFor(agentId, index) → 决定颜色
|
|
||||||
order: number; // 横向排列次序（chain 模式=链条顺序；recommend 模式=席位/发言顺序）
|
|
||||||
state: 'pending' | 'active' | 'done'; // 节点状态（驱动颜色/动画）
|
|
||||||
lastSpokeCycle?: number; // 最近发言轮次（可选，做 tooltip）
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### 2.4 进度事件 `JobProgressEvent`（SSE 推送的归一化事件）
|
|
||||||
|
|
||||||
```ts
|
|
||||||
type JobProgressEvent =
|
|
||||||
| { type: 'status'; status: JobStatus }
|
|
||||||
| { type: 'phase'; phase: JobPhase; cycle: number }
|
|
||||||
| { type: 'chain'; nodes: DispatchChainNode[] } // 派活链路全量/增量
|
|
||||||
| { type: 'active'; agentId: string | null } // 当前发言席位（null=总控/无）
|
|
||||||
| { type: 'consensus'; percentage: number }
|
|
||||||
| { type: 'dialogue'; bubble: Step2DialogueLike } // 新增/收尾的对话气泡（供「查看」实时渲染）
|
|
||||||
| { type: 'clarification'; question: string } // 命中澄清
|
|
||||||
| { type: 'done'; step3: DraftStep3Snapshot } // 终态：最终报告快照
|
|
||||||
| { type: 'error'; detail: string };
|
|
||||||
```
|
|
||||||
|
|
||||||
> SSE 通道可直接复用 LangGraph Server 的 `values` 流（图状态快照），由前端 hook 把 `values`
|
|
||||||
> 映射成上述归一化事件；也可在路由层做映射后再下发。**推荐前端映射**（少一层后端耦合）。
|
|
||||||
|
|
||||||
### 2.5 作业记录 `RoundtableJob`（持久化 + 列表展示）
|
|
||||||
|
|
||||||
```ts
|
|
||||||
interface RoundtableJob {
|
|
||||||
id: string;
|
|
||||||
draftId: string; // 关联的草稿
|
|
||||||
userId: string;
|
|
||||||
status: JobStatus;
|
|
||||||
phase: JobPhase;
|
|
||||||
cycle: number; // 当前轮次（0..MAX_CYCLES）
|
|
||||||
dispatchChain: DispatchChainNode[];
|
|
||||||
activeAgentId: string | null;
|
|
||||||
consensusPercentage: number;
|
|
||||||
pendingClarification: string | null;
|
|
||||||
threadIds: Record<string,string> | null; // 复用 ThreadIdMap
|
|
||||||
coordinatorName: string | null;
|
|
||||||
orchestrationMode: 'recommend' | 'chain';
|
|
||||||
chain?: { id: string; title: string } | null;
|
|
||||||
error: string | null;
|
|
||||||
createdAt: string;
|
|
||||||
updatedAt: string;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Phase 1 —— 后端：圆桌作业持久化模型
|
|
||||||
|
|
||||||
**目标**：建一张 `roundtable_jobs` 表（仿 `ai_writing_sessions`），存作业状态/阶段/派活链路，
|
|
||||||
并在 `roundtable_drafts` 列表里能 join 出当前作业状态。
|
|
||||||
|
|
||||||
**涉及文件（新增/改）**
|
|
||||||
- 新增 `packages/harness/deerflow/persistence/roundtable_jobs/model.py`（ORM 模型，仿 `ai_writing_sessions/model.py:14-39`）
|
|
||||||
- 新增 `.../roundtable_jobs/sql.py`（Repository：`create / get / update_progress / list_by_user / list_older_than / delete`，仿 `ai_writing_sessions/sql.py`）
|
|
||||||
- 新增 alembic 迁移 `persistence/migrations/versions/<date>_create_roundtable_jobs.py`
|
|
||||||
- 改 `roundtable_drafts` 的列表查询：返回里带上 `status`/`jobId`（LEFT JOIN roundtable_jobs，或在 draft 行上冗余一个 `status` 字段，二选一，见下）
|
|
||||||
|
|
||||||
**步骤**
|
|
||||||
1. 字段设计（对齐 §2.5）：`id(PK)`、`draft_id`、`user_id`、`status`、`phase`、`cycle(Int)`、
|
|
||||||
`dispatch_chain(PortableLongText/JSON)`、`active_agent_id`、`consensus_percentage(Int)`、
|
|
||||||
`pending_clarification(Text)`、`thread_ids(JSON)`、`coordinator_name`、`orchestration_mode`、
|
|
||||||
`chain(JSON)`、`error(Text)`、`created_at/updated_at(BeijingDateTime)`。
|
|
||||||
2. `dispatch_chain` / `thread_ids` / `chain` 用 `PortableLongText` 存 JSON 字符串，repo 层序列化。
|
|
||||||
3. 列表 join：给 `DraftMeta` 增加 `status?: JobStatus` 与 `jobId?: string`。
|
|
||||||
**推荐方案**：草稿与作业 1:1（一个草稿最多一个活跃作业），在 draft 列表查询 LEFT JOIN
|
|
||||||
`roundtable_jobs` 取最新作业的 `status`。
|
|
||||||
4. 索引：`(user_id, updated_at)`、`(draft_id)`、`(status)`（cleanup/列表用）。
|
|
||||||
|
|
||||||
**验收**
|
|
||||||
- 迁移可 `alembic upgrade head` 跑通，MySQL 上 `dispatch_chain` 为 `longtext`。
|
|
||||||
- 单测：create→update_progress→get 往返；`list_by_user` 按 `updated_at` 倒序；`list_older_than` 分批。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Phase 2 —— 后端：圆桌总控编排 LangGraph 图（核心 / 最大工作量）
|
|
||||||
|
|
||||||
**目标**：把前端的编排循环移植成一个后端 LangGraph 图，可在 LangGraph runtime 里后台跑、天然
|
|
||||||
checkpoint，一路跑到 Step3 绘制完成。
|
|
||||||
|
|
||||||
**涉及文件（新增）**
|
|
||||||
- `packages/harness/deerflow/agents/roundtable_orchestrator/graph.py`（图装配，仿 `ai_writing/graph.py`）
|
|
||||||
- `.../roundtable_orchestrator/state.py`（图状态 schema：intent、selectedAgents、threadIds、coordinatorName、
|
|
||||||
mode/chain、dialogues、dispatchChain、activeAgentId、cycle、consensus、phase、step3 等）
|
|
||||||
- `.../roundtable_orchestrator/nodes/*.py`（各节点）
|
|
||||||
- 在 `langgraph.json` 注册新 assistant `roundtable_orchestrator`（仿 ai_writing assistant 注册，参考 `langgraph.json:16-18`）
|
|
||||||
|
|
||||||
**图节点设计（把前端循环逐段翻译过来）**
|
|
||||||
|
|
||||||
| 节点 | 职责 | 对应前端逻辑 |
|
|
||||||
|------|------|------|
|
|
||||||
| `init` | 复用 `_create_thread_direct` 批量建席位 thread + 总控就绪（或接收前端已建好的 `threadIds` 直接用） | `useStep2Orchestration.ts:1485-1531` / `multi_agent.py:647-823` |
|
|
||||||
| `leader_call` | 跑一轮总控（agent_type=leader），拿 `status`（派活列表 / `[]` / `clarification`） | 单轮逻辑 `multi_agent.py:1076-1142` |
|
|
||||||
| `route_after_leader`（条件边） | `clarification`→`interrupt`；有派活→`dispatch_seats`；`[]`→`consensus` | `useStep2Orchestration.ts:1091-1181` |
|
|
||||||
| `dispatch_seats` | **顺序**派活：对 dispatched 里每个席位依次跑 special run；每开始一个就更新 `activeAgentId` + 进度持久化 | `useStep2Orchestration.ts:1101-1181`（务必串行，勿并行，详见前端 §5.4 注释） |
|
|
||||||
| `clarification_pause` | `interrupt()` 挂起，`status→awaiting_input`，写 `pending_clarification` | 仿 ai_writing `pause_*` `45-290` |
|
|
||||||
| `consensus` | `setHasConsensus`、`consensus=100`，落库后进入 `report_draw` | `1091-1099` |
|
|
||||||
| `report_draw` | 跑 `roundtable-report`（先 report/init 建 thread），流式写 `outputs/方案总览.html`，产出 `DraftStep3Snapshot` | `useStep3Report.ts:91-149,636-652,560-596` |
|
|
||||||
| `done` | `status→done`、写 `step3` 进作业 + 回写草稿 step3 快照 | `RoundtablePlanningPage.tsx:613-617` |
|
|
||||||
|
|
||||||
**关键实现要点**
|
|
||||||
1. **复用单轮执行**：节点内部不要重写 LLM 调用，抽出 `multi_agent.py` 里 leader/special/report 的
|
|
||||||
单轮 run 为可被图节点直接 `await` 的内部函数（去掉 HTTP 层，进程内调 LangGraph）。
|
|
||||||
2. **派活广播**：保留现有把「总控给 X 派了活 / X 完成」追加进各 thread 历史的广播
|
|
||||||
（`multi_agent.py:487-502`），让席位读到全局上下文。
|
|
||||||
3. **MAX_CYCLES 兜底**：图里维护 `cycle`，≥8 强制收敛（对齐 `roundtable-constants.ts:13`）。
|
|
||||||
4. **chain 模式**：`orchestration_mode==='chain'` 时按 `chain.seats` 固定顺序派活，跳过总控自由决策的
|
|
||||||
部分（对齐 `runChainOrchestration` `1228-1439`）。
|
|
||||||
5. **进度落库**：每个节点结束 `update_progress(jobId, {phase, cycle, dispatchChain, activeAgentId,
|
|
||||||
consensus, dialogues_delta})`，前端 SSE 才有实时数据。
|
|
||||||
6. **dialogues 累积**：把每轮气泡写进图状态 `dialogues`，既供「查看」实时渲染，也供作业结束回写草稿 step2。
|
|
||||||
|
|
||||||
**验收**
|
|
||||||
- 用脚本（仿 `scripts/probe_ai_writing_assistant.py`）直接对图发起一次 run，不开前端，能从 intent +
|
|
||||||
selectedAgents 一路跑到写出 `方案总览.html`，作业 `status` 终态 `done`。
|
|
||||||
- 命中 clarification 时图 `interrupt`，`status=awaiting_input`，`pending_clarification` 有值。
|
|
||||||
- chain 模式按链条顺序派活，recommend 模式由总控自由派活，两条路径都能收敛。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Phase 3 —— 后端：作业控制 + 进度 SSE 接口
|
|
||||||
|
|
||||||
**目标**：暴露 start/get/stream/resume/cancel，后台 run 走 LangGraph Server（任意 worker 可 join）。
|
|
||||||
|
|
||||||
**涉及文件（新增/改）**
|
|
||||||
- 新增 `app/gateway/routers/roundtable_jobs.py`（仿 `ai_writing.py` 的 CRUD + 控制壳）
|
|
||||||
- 在 gateway `app.py` 注册路由
|
|
||||||
- 新增 `app/gateway/roundtable_jobs_cleanup.py`（仿 `ai_writing_cleanup.py`）+ 在启动处挂 cron
|
|
||||||
|
|
||||||
**接口契约**
|
|
||||||
|
|
||||||
| 方法 | 路径 | 说明 |
|
|
||||||
|------|------|------|
|
|
||||||
| `POST` | `/api/roundtable-jobs` | 入参：`{draftId, intent, selectedAgents, threadIds?, coordinatorName?, model, orchestrationMode, chain?}`。建作业记录(`queued`) + 启动图 run（LangGraph Server thread），返回 `RoundtableJob` |
|
|
||||||
| `GET` | `/api/roundtable-jobs/{id}` | 作业快照（轮询兜底 / 弹窗首帧） |
|
|
||||||
| `GET` | `/api/roundtable-jobs/{id}/stream` | SSE 进度流：透传图 `values`/`messages-tuple`，或映射成 §2.4 事件下发。**走真 TCP loopback**（`multi_agent.py:271-293`），禁代理 |
|
|
||||||
| `POST` | `/api/roundtable-jobs/{id}/resume` | 入参 `{answer}`，回填 clarification → 图 resume，`status→running` |
|
|
||||||
| `POST` | `/api/roundtable-jobs/{id}/cancel` | 取消图 run，`status→cancelled` |
|
|
||||||
| `GET` | `/api/roundtable-jobs?draftId=` | 按草稿查活跃作业（页面恢复用） |
|
|
||||||
| `POST` | `/api/roundtable-jobs/admin/cleanup` | 管理员手动清理（仿 ai_writing admin cleanup `307-367`） |
|
|
||||||
|
|
||||||
**多 worker 健壮性（务必遵守，照搬 ai_writing 教训）**
|
|
||||||
- 作业状态只存 **DB + checkpointer**，**不要**用模块级内存 dict 存 per-session 状态。
|
|
||||||
- SSE 必须经真 TCP `127.0.0.1` loopback，不能 `httpx.ASGITransport(app=...)` 进程内直调（会整段 buffer）。
|
|
||||||
- 图 run 跑在 LangGraph runtime（独立于处理 HTTP 的 worker），刷新/换 worker 都能重新 join stream。
|
|
||||||
- 数据卷：`.deer-flow/data/checkpoints.db` 必须挂出，否则容器重启丢状态。
|
|
||||||
|
|
||||||
**验收**
|
|
||||||
- `POST /start` 后立刻 `GET /{id}` 能拿到 `queued/running`；关掉 SSE 再重连能继续收进度。
|
|
||||||
- 杀掉发起 start 的 worker（或多 worker 轮询），`resume`/`stream` 仍命中同一作业。
|
|
||||||
- cleanup 干跑：活跃作业永不删，先删 CP 再删 DB。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Phase 4 —— 前端：作业 API 客户端 + 数据模型扩展
|
|
||||||
|
|
||||||
**目标**：前端有一层干净的作业 API 与类型，历史列表能拿到 status。
|
|
||||||
|
|
||||||
**涉及文件（新增/改）**
|
|
||||||
- 新增 `src/roundtable-planning/api/roundtable-jobs.ts`：
|
|
||||||
```ts
|
|
||||||
export async function startJob(payload: StartJobPayload): Promise<RoundtableJob>
|
|
||||||
export async function getJob(id: string): Promise<RoundtableJob>
|
|
||||||
export function streamJob(id: string, on: (e: JobProgressEvent) => void): () => void // 返回 unsubscribe
|
|
||||||
export async function resumeJob(id: string, answer: string): Promise<void>
|
|
||||||
export async function cancelJob(id: string): Promise<void>
|
|
||||||
```
|
|
||||||
- `streamJob` 复用项目现有 SSE/`streamMultiAgent` 的封装方式（`api/multi-agent.ts:403+`），把
|
|
||||||
LangGraph `values` 映射成 §2.4 的归一化事件。
|
|
||||||
- 改 `src/roundtable-planning/api/drafts.ts`：`DraftMeta` 增 `status?: JobStatus; jobId?: string`
|
|
||||||
（`drafts.ts:76-83` + 字段映射 `122-178` 加 snake_case 转换）。
|
|
||||||
- 新增 `src/roundtable-planning/lib/job-types.ts`：把 §2.1–2.5 的类型集中导出。
|
|
||||||
|
|
||||||
**验收**：`pnpm typecheck` 通过；`getJob`/`streamJob` 能拉到 Phase 3 的数据。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Phase 5 —— 前端：Step2「后台挂起」按钮
|
|
||||||
|
|
||||||
**目标**：Step2 顶栏/底栏加按钮，点击把当前任务交给后端后台跑，前端停止本地循环、转为观察者。
|
|
||||||
|
|
||||||
**涉及文件（改）**
|
|
||||||
- `src/roundtable-planning/components/Step2Panel.tsx`（按钮放在现有「进入第三步」附近 `370-381`）
|
|
||||||
- `src/roundtable-planning/pages/RoundtablePlanningPage.tsx`（接线 + 观察者模式）
|
|
||||||
- `src/roundtable-planning/hooks/useStep2Orchestration.ts`（暴露「停止本地循环并交后台」的方法）
|
|
||||||
|
|
||||||
**步骤**
|
|
||||||
1. Step2Panel 加「⏼ 后台挂起」按钮，`onBackgroundSuspend` 回调。
|
|
||||||
2. 页面 `handleBackgroundSuspend`：
|
|
||||||
- `ensureDraft(2)` 拿到 `draftId`（`useDraftPersistence.ts` ensureDraft）。
|
|
||||||
- 收集当前状态：`intentReady`、`selectedAgents`、`threadIds`、`coordinatorName`、`model`、
|
|
||||||
`orchestrationMode`、`chain`（全部来自 `step2`/`step1` 现有状态）。
|
|
||||||
- `startJob(...)` → 拿到 `jobId`。
|
|
||||||
- **停止前端本地编排**：调用 `step2.stopOrchestration()` + 置一个 `backgroundedJobId` 标记，
|
|
||||||
让 `currentStep===2` 的 useEffect **不再自启本地循环**（在 `useStep2Orchestration.ts:1468-1541`
|
|
||||||
的启动条件里加 `&& !backgrounded`）。
|
|
||||||
- toast「已转入后台，可离开页面，任务会自动跑到结果绘制完成」。
|
|
||||||
- 刷新历史列表（`drafts` 重新拉，进行中项即出现 spinner）。
|
|
||||||
3. **观察者模式**：若当前停留在 Step2 且该 draft 有 running 作业，订阅 `streamJob`，把进度事件渲染成
|
|
||||||
对话气泡/活动席位（复用现有 Step2 渲染），而不是本地驱动。
|
|
||||||
|
|
||||||
**注意：避免「双跑」**——后台已接管后，前端绝不能再并行驱动同一批 thread。用 `backgroundedJobId`
|
|
||||||
互斥；加载草稿时若发现有 running 作业，直接进观察者模式。
|
|
||||||
|
|
||||||
**验收**：点「后台挂起」→ 可立即切到别的任务/路由；回来仍在跑；不会出现前后端同时派活。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Phase 6 —— 前端：历史下拉框「进行中」加载动画
|
|
||||||
|
|
||||||
**目标**：历史下拉里 `status==='running'`（或 `awaiting_input`）的草稿条目显示加载动画；点击进行中
|
|
||||||
条目不直接 load，而是打开流程图弹窗。
|
|
||||||
|
|
||||||
**涉及文件（改）**
|
|
||||||
- `src/roundtable-planning/pages/RoundtablePlanningPage.tsx` 的 `HistoryDropdown`（`771-892`）
|
|
||||||
|
|
||||||
**步骤**
|
|
||||||
1. 列表项左侧名称前/后，按 `d.status` 渲染状态标记：
|
|
||||||
- `running` → 旋转的 `Loader2`（`animate-spin`）+「进行中」。
|
|
||||||
- `awaiting_input` → 呼吸点 +「待澄清」（琥珀色）。
|
|
||||||
- `done`/无 → 维持现状（显示 `Step {furthestStep}`）。
|
|
||||||
- `error` → 红点 +「出错」。
|
|
||||||
2. 点击行为分流：
|
|
||||||
- `running`/`awaiting_input` → `openDispatchChainModal(d.jobId)`（Phase 7），**不**直接 `onLoad`。
|
|
||||||
- 其它 → 维持 `onLoad(id)`。
|
|
||||||
3. 列表需要 `status`，确保 Phase 4 的 `DraftMeta.status` 已就位；下拉打开时 `refresh()` 拉最新。
|
|
||||||
|
|
||||||
**验收**：后台挂起后，历史下拉对应条目转圈；点击弹出流程图弹窗。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Phase 7 —— 前端：派活链路流程图弹窗（横向 / 大弹窗 / 动画）
|
|
||||||
|
|
||||||
**目标**：大弹窗，横向排列的智能体派活链路。节点 = 席位（图标 + 名称），不同颜色；正在发言的
|
|
||||||
节点和它的连接线带加载动画；含「查看」按钮。
|
|
||||||
|
|
||||||
**涉及文件（新增）**
|
|
||||||
- `src/roundtable-planning/components/DispatchChainModal.tsx`
|
|
||||||
|
|
||||||
**实现选型**：链路是「总控 → 席位序列」的线性结构 + 需要对**单个节点和单条连线**做精确动画，
|
|
||||||
**推荐手写 flex 横向布局 + CSS 动画连接线**（轻、可控）。项目已装 `@xyflow/react@12`（带 `animated`
|
|
||||||
边）作为备选，但手写对本场景的「节点 loading + 连线流动」更直接。
|
|
||||||
|
|
||||||
**结构（手写方案草图）**
|
|
||||||
```tsx
|
|
||||||
<Dialog open={open} onOpenChange={onOpenChange}>
|
|
||||||
<DialogContent className="flex max-h-[88vh] flex-col gap-0 sm:max-w-5xl"> {/* 大弹窗 */}
|
|
||||||
<DialogHeader>… 任务标题 + 阶段标签（leader_thinking/dispatching/report_drawing…） …</DialogHeader>
|
|
||||||
|
|
||||||
{/* 横向链路：总控 ──▶ 席位1 ──▶ 席位2 ──▶ … ──▶ [共识] ──▶ [报告绘制] */}
|
|
||||||
<div className="custom-scrollbar overflow-x-auto py-8">
|
|
||||||
<div className="flex items-center gap-0 min-w-max px-6">
|
|
||||||
<CoordinatorNode active={phase==='leader_thinking'} />
|
|
||||||
{nodes.map((n,i)=>(
|
|
||||||
<Fragment key={n.agentId}>
|
|
||||||
<Connector active={n.state==='active'} /> {/* 活动连线：流动虚线动画 */}
|
|
||||||
<ChainNode node={n} /> {/* 活动节点：彩色+脉冲光环 */}
|
|
||||||
</Fragment>
|
|
||||||
))}
|
|
||||||
<Connector active={phase==='consensus'} />
|
|
||||||
<MilestoneNode label="共识" done={consensus===100} />
|
|
||||||
<Connector active={phase==='report_drawing'} />
|
|
||||||
<MilestoneNode label="报告绘制" active={phase==='report_drawing'} done={phase==='report_done'} />
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<DialogFooter className="border-t pt-3 sm:justify-between">
|
|
||||||
<span className="text-xs text-muted-foreground">轮次 {cycle}/8 · {statusLabel}</span>
|
|
||||||
<Button onClick={onView}>查看</Button> {/* Phase 8 */}
|
|
||||||
</DialogFooter>
|
|
||||||
</DialogContent>
|
|
||||||
</Dialog>
|
|
||||||
```
|
|
||||||
|
|
||||||
**节点颜色**：`avatarType = getAvatarTypeFor(agentId, order)` → `chainTagClasses(avatarType)`
|
|
||||||
（复用 `lib/business-chain.ts:56-72` + `lib/roundtable-constants.ts`），与业务链条卡片同一套色。
|
|
||||||
|
|
||||||
**节点状态样式**
|
|
||||||
- `pending`：灰色描边、低透明度。
|
|
||||||
- `active`：席位色填充 + 外圈 `animate-ping`/脉冲光环 + 图标旋转或呼吸。
|
|
||||||
- `done`：席位色实心 + 右上角 ✓。
|
|
||||||
|
|
||||||
**连接线加载动画（active 连线）**：CSS 流动虚线（marching-ants）或渐变扫光：
|
|
||||||
```css
|
|
||||||
/* roundtable-planning.css 追加 */
|
|
||||||
@keyframes chain-flow { to { background-position: 20px 0; } }
|
|
||||||
.chain-connector--active {
|
|
||||||
background-image: linear-gradient(90deg, var(--brand-500) 50%, transparent 50%);
|
|
||||||
background-size: 20px 100%;
|
|
||||||
animation: chain-flow 0.6s linear infinite;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**数据来源**：弹窗 mount 时 `getJob(jobId)` 取首帧，随后 `streamJob(jobId, onEvent)` 实时更新
|
|
||||||
`nodes`/`activeAgentId`/`phase`/`consensus`/`cycle`；`done` 事件后停止动画、全节点置 `done`。
|
|
||||||
弹窗关闭时 `unsubscribe`。
|
|
||||||
|
|
||||||
**验收**：弹窗够大、横向滚动；活动席位节点和它左侧连线在动；阶段推进时高亮顺移；`done` 后静止。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Phase 8 —— 前端：「查看」进入进行中任务并实时观察
|
|
||||||
|
|
||||||
**目标**：弹窗「查看」→ 进入该任务，停在 Step2 实时看后台进度（气泡/活动席位随 SSE 刷新），
|
|
||||||
跑完自动呈现 Step3 结果。
|
|
||||||
|
|
||||||
**涉及文件（改）**
|
|
||||||
- `RoundtablePlanningPage.tsx`（接 `onView`）
|
|
||||||
- `useDraftPersistence.ts`（`handleLoadDraft` 增「带作业」分支）
|
|
||||||
- `useStep2Orchestration.ts`（观察者渲染）
|
|
||||||
|
|
||||||
**步骤**
|
|
||||||
1. `onView`：关弹窗 → `handleLoadDraft(draftId)` 恢复该草稿到 Step2（`useDraftPersistence.ts:308-368`），
|
|
||||||
但**跳过本地编排自启**（识别到有 running 作业 → 进观察者模式，对齐 Phase 5 的互斥标记）。
|
|
||||||
2. 订阅 `streamJob(jobId)`，把 `dialogue` 事件 append 进 `step2RoundtableDialogues`、`active` 事件
|
|
||||||
驱动 `activeSpeakerId` 高亮、`consensus` 更新百分比。
|
|
||||||
3. 命中 `awaiting_input`：在 Step2 弹出澄清输入（复用现有 `pendingClarification` UI），用户回答 →
|
|
||||||
`resumeJob(jobId, answer)`（而非本地 `submitClarification`）。
|
|
||||||
4. `done` 事件：用返回的 `DraftStep3Snapshot` 走 `hydrateStep3` + 允许切到 Step3 查看报告
|
|
||||||
（`useStep3Report.hydrateSaved` `708-767`）；作业列表该项变「已完成」。
|
|
||||||
|
|
||||||
**验收**：从历史「查看」进入能实时看到后台在跑；澄清能在前端回答并续跑；跑完能看到最终报告。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Phase 9 —— 边界、健壮性与收尾
|
|
||||||
|
|
||||||
1. **双跑互斥**：任一 draft 同一时刻只允许一个执行者（前端本地 or 后台作业）。加载草稿/进入 Step2
|
|
||||||
前先 `GET /api/roundtable-jobs?draftId=`，有 running 就进观察者模式。
|
|
||||||
2. **后台命中澄清**：`awaiting_input` 时历史下拉显示「待澄清」徽标；流程图弹窗显示「等待澄清」；
|
|
||||||
只有「查看」进去才能回答（或在弹窗里直接给一个回答框，调用 `resumeJob`）。
|
|
||||||
3. **取消**：流程图弹窗/Step2 提供「停止后台」→ `cancelJob`，`status→cancelled`，前端可恢复本地编辑。
|
|
||||||
4. **错误恢复**：`error` 事件展示 detail；允许「重试」= 重新 `startJob`（沿用已建 threadIds）。
|
|
||||||
5. **MAX_CYCLES / 预算**：后台图内兜底（对齐前端 `MAX_CYCLES=8`），到顶强制收敛并照常进 Step3。
|
|
||||||
6. **多 worker**：严格遵守 Phase 3 的「状态进 DB+checkpointer、SSE 走 loopback」；部署若多 worker
|
|
||||||
需 sticky 或全靠 DB 态（推荐后者）。
|
|
||||||
7. **清理**：`roundtable_jobs` cleanup cron（活跃保护、先删 CP 再删 DB），与 draft 生命周期对齐。
|
|
||||||
8. **历史列表性能**：draft 列表 join 作业 status 时注意 N+1；用一次 LEFT JOIN 取最新作业。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 端到端验证清单（提测前逐条过）
|
|
||||||
|
|
||||||
- [ ] Step2 点「后台挂起」→ 立刻可离开页面 / 切到别的任务，后台继续跑。
|
|
||||||
- [ ] 历史下拉里该任务显示加载动画（转圈）。
|
|
||||||
- [ ] 点击进行中任务 → 大弹窗、横向派活链路、活动节点+连线在动、节点不同颜色。
|
|
||||||
- [ ] 阶段推进（leader→派活→共识→报告绘制）时弹窗高亮顺移。
|
|
||||||
- [ ] 弹窗「查看」→ 进入任务实时观察气泡/活动席位。
|
|
||||||
- [ ] 后台命中澄清 → 列表「待澄清」+ 弹窗提示 + 可回答续跑（`resumeJob`）。
|
|
||||||
- [ ] 一路自动跑到 Step3「绘制完成」，最终报告可在 Step3 查看，作业 `done`。
|
|
||||||
- [ ] 浏览器刷新 / 关页重开后，任务仍在后台跑、状态可恢复（真后台验证）。
|
|
||||||
- [ ] 取消后台 → `cancelled`，无残留双跑。
|
|
||||||
- [ ] 多 worker（或杀 worker）下 stream/resume 不丢会话。
|
|
||||||
- [ ] cleanup 干跑不误删活跃作业。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 工作量与排期建议
|
|
||||||
|
|
||||||
| 阶段 | 内容 | 粗估 | 依赖 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| P0 | 数据契约定型（本文 §2） | 0.5d | — |
|
|
||||||
| P1 | 后端作业表 + repo + 迁移 | 1d | P0 |
|
|
||||||
| **P2** | **后端编排图（移植循环）** | **3–5d（核心难点）** | P0,P1 |
|
|
||||||
| P3 | 后端控制 + SSE + cleanup | 1.5d | P1,P2 |
|
|
||||||
| P4 | 前端作业 API + 类型 + draft status | 0.5d | P3 |
|
|
||||||
| P5 | Step2 后台挂起按钮 + 互斥 | 1d | P4 |
|
|
||||||
| P6 | 历史下拉 loading 动画 | 0.5d | P4 |
|
|
||||||
| P7 | 派活链路流程图弹窗 | 1.5d | P4 |
|
|
||||||
| P8 | 「查看」实时观察 + 澄清续跑 | 1.5d | P5,P7 |
|
|
||||||
| P9 | 边界/健壮性/清理 | 1d | 全部 |
|
|
||||||
|
|
||||||
> 建议先打通 **P1→P2→P3** 的后端最小闭环（脚本验证图能后台跑到出报告），再做前端 P4–P8。
|
|
||||||
> P2 是整条链路成败的关键，务必先用脱离前端的探针脚本（仿 `scripts/probe_ai_writing_assistant.py`）跑通。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 附：关键参考代码索引
|
|
||||||
|
|
||||||
- 前端编排循环（待移植到后端）：`useStep2Orchestration.ts:992-1204,1228-1439,1468-1541`
|
|
||||||
- 共识判定 / 进 Step3：`useStep2Orchestration.ts:1091-1099`、`Step2Panel.tsx:370-381`、`RoundtablePlanningPage.tsx:586-595`
|
|
||||||
- Step3 绘制完成标志：`useStep3Report.ts:51,165,560-596,636-652`
|
|
||||||
- 草稿模型 / API / 自动保存 / 加载恢复：`api/drafts.ts:25-110,184-225`、`useDraftPersistence.ts:248-316,308-368`
|
|
||||||
- 历史下拉 UI：`RoundtablePlanningPage.tsx:771-892`
|
|
||||||
- 后端单轮执行 / 派活 / 广播：`multi_agent.py:647-823,1076-1142,525-552,487-502`、loopback `271-293`
|
|
||||||
- AI 写作模板：`agents/ai_writing/graph.py`、`ai_writing_sessions/model.py:14-39`、`ai_writing.py`、`ai_writing_cleanup.py:307-367`、`AIWritingPage.tsx` 文件头注释
|
|
||||||
- 颜色体系复用：`lib/business-chain.ts:56-72`、`lib/roundtable-constants.ts`（`getAvatarTypeFor`）
|
|
||||||
- 流程图备选库：`@xyflow/react@12`（已安装）
|
|
||||||
```
|
|
||||||
@@ -1,400 +0,0 @@
|
|||||||
# 业务链条模式 · 需求与分步实现文档
|
|
||||||
|
|
||||||
> 面向「智能体推荐弹窗」的扩展：在现有**智能推荐**之外，新增**业务链条选择**与**业务链条配置**两块能力；选定业务链条后，Step 2 圆桌研讨**按链条内的固定顺序**逐个发言（而非现在的总控派活）。
|
|
||||||
>
|
|
||||||
> 配套阅读：
|
|
||||||
> - 前端总览：`multi-agent-frontend-dev.md`（推荐弹窗 §6.2、Step 2 编排 §5.4、草稿持久化 §5.7）
|
|
||||||
> - 后端总览：`multi-agent-backend-dev.md`（Step 2 §6、草稿/历史持久化 §7A）
|
|
||||||
>
|
|
||||||
> 本文档约定：**「席位 / 智能体」**指一个 agent；**「业务链条 / chain」**指一组有序排列的 agent 配置，是可命名、可复用、可持久化的实体。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 0. 需求原文拆解
|
|
||||||
|
|
||||||
用户原始诉求逐条拆成可实现条目：
|
|
||||||
|
|
||||||
| # | 原始诉求 | 拆解 |
|
|
||||||
|---|----------|------|
|
|
||||||
| 1 | 推荐弹窗要有「模式选择」 | 弹窗顶部加模式切换（智能推荐 / 业务链条），两种模式互斥，确认后都产出**有序**的 `SelectedAgent[]` |
|
|
||||||
| 2 | 「智能推荐」就是现在这个 | 现有 `RecommendAgentsDialog` 整体收进「智能推荐」模式，行为不变 |
|
|
||||||
| 3 | 「业务链条选择」是卡片列表 | 卡片 = 标题 + 一排智能体名 tag；tag 不同颜色；tag 之间有**向左箭头**连接，表达链条次序 |
|
|
||||||
| 4 | 业务链条需要一个**配置页面** | 左侧智能体列表（复用 `GET /api/agents`），右侧有序长条卡片（名称 + 描述）；支持右侧内部拖拽排序、左→右拖入指定位置 |
|
|
||||||
| 5 | 配置页用弹窗还是新页面？ | **本文档决策：独立路由页面**（理由见 §2.1） |
|
|
||||||
| 6 | 选定链条后，Step 2 用链条内智能体研讨 | 复用既有 Step 2 init/stream；**总控（leader）按链条顺序逐个派活**（§6） |
|
|
||||||
| 7 | 规划成分步可实现的需求文档 | 见 §7 分阶段实现 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 目标与非目标
|
|
||||||
|
|
||||||
### 1.1 目标
|
|
||||||
- 推荐弹窗成为「**席位来源选择器**」：无论智能推荐还是业务链条，最终都向 `onConfirm` 交付一个**有序的 `{ agent_id, name }[]`** + 一个 `orchestrationMode`。
|
|
||||||
- 业务链条是**用户可创建、命名、保存、复用、删除**的有序智能体编排模板。
|
|
||||||
- Step 2 支持两种编排：
|
|
||||||
- `recommend` 模式 → 现有总控**自由派活**循环（不动）。
|
|
||||||
- `chain` 模式 → 总控仍是派活方，但**被约束按链条顺序逐个派活**（新增）。
|
|
||||||
|
|
||||||
### 1.2 非目标（本期不做，留扩展点）
|
|
||||||
- 链条内每个席位的 per-seat prompt/temperature 真实覆盖（仍仅前端记录，沿用现状）。
|
|
||||||
- 链条的分支 / 条件流转（只做线性顺序链）。
|
|
||||||
- 链条跨用户共享 / 市场（先做「本人私有链条」）。
|
|
||||||
- 链条版本管理 / 协作编辑。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 关键设计决策
|
|
||||||
|
|
||||||
### 2.1 决策 A：配置页面用「独立路由页面」而非弹窗 ✅
|
|
||||||
|
|
||||||
**结论：业务链条的「编辑/管理」用独立路由页面 `/page/workspace/roundtable/chains`；业务链条的「选择」仍内嵌在推荐弹窗里（卡片列表）。**
|
|
||||||
|
|
||||||
理由：
|
|
||||||
|
|
||||||
| 维度 | 弹窗 | 独立页面 ✅ |
|
|
||||||
|------|------|------------|
|
|
||||||
| 双栏 + 拖拽 + 长条卡片 | 弹窗宽度（`sm:max-w-3xl`）+ `max-h-[85vh]` 拖拽空间局促，左右栏挤 | 整屏宽度，拖拽手感好 |
|
|
||||||
| 复用入口 | 只能从推荐弹窗进 | 可从侧栏、推荐弹窗「管理链条」按钮、深链接进入 |
|
|
||||||
| 可深链接/刷新 | 不可 | `/roundtable/chains` 可直达、可分享 |
|
|
||||||
| 推荐弹窗内嵌编辑器 | 弹窗套弹窗 / 模式套编辑，状态复杂 | 关注点分离：弹窗只「选」，页面只「编」 |
|
|
||||||
|
|
||||||
**分工**：
|
|
||||||
- **推荐弹窗**：模式选择 + 业务链条**选择**（只读卡片列表，可点「去配置」跳到页面）。
|
|
||||||
- **配置页面**：业务链条的**增删改**（双栏拖拽编辑器 + 链条列表管理）。
|
|
||||||
|
|
||||||
> 备选：若产品坚持不加路由，可改为**全屏 Dialog（`max-w-[90vw] h-[90vh]`）**承载编辑器，从推荐弹窗内打开。结构与页面版一致，仅外壳不同。本文档按「独立页面」实现，§7 标注了切换成本。
|
|
||||||
|
|
||||||
### 2.2 决策 B：链条持久化 —— 后端 MySQL（确定） ✅
|
|
||||||
|
|
||||||
**结论：业务链条存后端 MySQL，仿 `roundtable_drafts`（§7A）新建 `roundtable_chains` 表 + `/api/roundtable-chains` 路由，按登录用户隔离、跨设备保留。** 不走 localStorage。
|
|
||||||
|
|
||||||
理由：链条是可复用、需跨设备/会话保留的模板，与草稿/推荐历史性质一致；草稿当年正是因 localStorage 换设备即丢才迁后端（§7A），链条不重复踩坑。
|
|
||||||
|
|
||||||
落地：
|
|
||||||
- 表/路由设计见 §5.2，是「复制 §7A 草稿持久化、把字段换成 chain」的机械工作。
|
|
||||||
- 前端 `api/chains.ts` 直接打后端接口（snake_case↔camelCase 在这层收口，仿 `api/drafts.ts`），**不提供 localStorage 实现**。
|
|
||||||
- 后端表必须先于前端 UI 落地（§7 阶段 0 即包含后端表/路由）。
|
|
||||||
|
|
||||||
### 2.3 决策 C：拖拽库选型 —— `@dnd-kit`
|
|
||||||
|
|
||||||
仓库**当前无任何拖拽库**（`package.json` 无 `@dnd-kit` / `react-dnd` / `sortablejs`；`@xyflow/react` 是节点图，不适合列表排序）。
|
|
||||||
|
|
||||||
| 方案 | 取舍 |
|
|
||||||
|------|------|
|
|
||||||
| **`@dnd-kit/core` + `@dnd-kit/sortable`**（推荐） | React 19 友好、可访问性好、跨容器拖入 + 列表排序 + 插入指示器开箱即用；新增 ~30KB gzip 依赖 |
|
|
||||||
| 原生 HTML5 DnD（零依赖兜底） | 不加依赖，但跨容器插入位置指示、键盘可达性都要手写，易出 bug |
|
|
||||||
|
|
||||||
**建议**：新增 `@dnd-kit/core`、`@dnd-kit/sortable`、`@dnd-kit/utilities`。若产品方禁止新增依赖，退回原生 HTML5 DnD（§7 阶段 2 标注差异）。
|
|
||||||
|
|
||||||
### 2.4 决策 D：Step 2「总控按链条顺序派活」，后端零改动 ✅
|
|
||||||
|
|
||||||
**形态：总控（leader）仍是唯一派活方，但每一轮被前端约束「只能派给链条里的下一个席位」，逐个走完整条链，最后由总控收口。** 区别于 recommend 模式的「总控自由决定派给谁」。
|
|
||||||
|
|
||||||
为什么后端无需改动：
|
|
||||||
- Step 2 后端 `streamMultiAgent({ agentType: "leader" })` 每轮返回 `dispatched = [[agent, task], ...]`；`agentType: "special"` 单独驱动某席位跑一轮。这两个原语已足够。
|
|
||||||
- 每个 special 跑完，后端 `_broadcast` 会把「子智能体 X 完成…交付内容为:…」append 进**其它所有席位 + 总控 thread** 的历史（后端 §6.4），所以链路上下文天然累积。
|
|
||||||
- chain 模式只是**改变前端怎么提示 leader、以及怎么校验它的派活**——把每轮 leader 的提示词约束成「请向链条第 i 位【X】派活」，并对返回的 `dispatched` 做「必须命中链条下一席位」的校验/纠偏。**后端路由、SOUL、表结构都不动。**
|
|
||||||
|
|
||||||
→ chain 模式 = 在 `useStep2Orchestration` 里新增 `runChainOrchestration`：按链条游标逐位调 leader（约束派给该位）→ 拿到 task → 调 special → 下一位 → 链尾后调一次 leader 收口。详见 §6。
|
|
||||||
|
|
||||||
> 与「前端绕过 leader 直接顺序 special」的区别：本方案**保留总控在每一步的协调/串接职责**（leader 结合前序进展为下一席位编写针对性任务、并在派活说明里承上启下），更符合「总控按链条顺序派活」的语义，圆桌可视化里总控气泡也照常出现。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 数据模型与类型
|
|
||||||
|
|
||||||
新增前端类型，建议放 `frontend-web/src/roundtable-planning/lib/business-chain.ts`：
|
|
||||||
|
|
||||||
```ts
|
|
||||||
/** 业务链条里的一个有序席位。 */
|
|
||||||
export interface ChainSeat {
|
|
||||||
agent_id: string;
|
|
||||||
/** 落库时的快照名/描述，避免 agent 改名后链条显示错乱；展示优先用实时 agent 数据，回退到快照。 */
|
|
||||||
name: string;
|
|
||||||
description?: string;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** 一条可复用的业务链条。 */
|
|
||||||
export interface BusinessChain {
|
|
||||||
id: string;
|
|
||||||
title: string;
|
|
||||||
description?: string;
|
|
||||||
/** 有序席位列表；seats[0] 是第一个发言者。 */
|
|
||||||
seats: ChainSeat[];
|
|
||||||
createdAt?: string;
|
|
||||||
updatedAt?: string;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** 推荐弹窗确认后回传给主页面的统一结果。 */
|
|
||||||
export interface SeatSelectionResult {
|
|
||||||
/** 有序席位（与现有 handleConfirmAgents 入参兼容）。 */
|
|
||||||
agents: Array<{ agent_id: string; name: string }>;
|
|
||||||
/** 决定 Step 2 走哪种编排。 */
|
|
||||||
mode: "recommend" | "chain";
|
|
||||||
/** chain 模式下带上来源链条（用于草稿快照 / Step 2 展示链名）。 */
|
|
||||||
chain?: Pick<BusinessChain, "id" | "title">;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**约束**：链条席位数沿用圆桌的 `2 ≤ N ≤ 8`（`MIN_SELECTED`/`MAX_SELECTED`），配置页保存时校验。
|
|
||||||
|
|
||||||
**tag 配色**：复用 `roundtable-constants.ts::getAvatarTypeFor(agentId, index)`，得到 `blue|purple|emerald|amber|pink|human`，再映射到已有的 avatar 配色 token（与圆桌可视化、Step 2 气泡同一套色板，视觉统一）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. 现有代码改动点速查
|
|
||||||
|
|
||||||
| 位置 | 改动 | 说明 |
|
|
||||||
|------|------|------|
|
|
||||||
| `components/RecommendAgentsDialog.tsx` | 包一层「模式选择」外壳，现有内容收进「智能推荐」Tab | `onConfirm` 签名从 `agents[]` 升级为 `SeatSelectionResult`（或加可选第二参 `mode`，见 §7 阶段 3 的兼容策略） |
|
|
||||||
| `pages/RoundtablePlanningPage.tsx` | `handleConfirmAgents` 接收 `mode`，存到新状态 `orchestrationMode` | 透传给 `useStep2Orchestration` |
|
|
||||||
| `hooks/useStep2Orchestration.ts` | 新增 `runChainOrchestration` + `orchestrationMode` 分支 | init effect 里按 mode 选择 `runOrchestration` 或 `runChainOrchestration` |
|
|
||||||
| `lib/roundtable-constants.ts` | 复用 `getAvatarTypeFor` / `SelectedAgent` | 不改，仅引用 |
|
|
||||||
| `hooks/useDraftPersistence.ts` + `api/drafts.ts` | Step2 快照新增 `orchestrationMode` + `chain` 字段 | 草稿能记住「这次是链条模式」 |
|
|
||||||
| `pages/WorkspaceRoutes.tsx` | 注册 `roundtable/chains` 路由 | 仿 `roundtable/planning` |
|
|
||||||
| `components/page-sidebar.tsx`（如有侧栏入口） | 加「业务链条」入口（可选） | 也可只从推荐弹窗进 |
|
|
||||||
| `api/chains.ts`（新增） | 链条 CRUD 客户端 | 直接打后端 `/api/roundtable-chains` |
|
|
||||||
| 后端 `roundtable_chains` | 表 + 路由（MySQL） | 仿 `roundtable_drafts`，**必做** |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5. 链条持久化 API 设计
|
|
||||||
|
|
||||||
### 5.1 前端客户端 `api/chains.ts`（直接打后端）
|
|
||||||
|
|
||||||
```ts
|
|
||||||
listChains(): Promise<BusinessChain[]> // 当前用户全部链条
|
|
||||||
getChain(id: string): Promise<BusinessChain>
|
|
||||||
createChain(input: Omit<BusinessChain,"id"|"createdAt"|"updatedAt">): Promise<BusinessChain>
|
|
||||||
updateChain(id: string, patch: Partial<BusinessChain>): Promise<BusinessChain>
|
|
||||||
deleteChain(id: string): Promise<void>
|
|
||||||
```
|
|
||||||
|
|
||||||
- 实现用 `apiFetch` 打 `/api/roundtable-chains`（§5.2），snake_case↔camelCase 在这层收口（仿 `api/drafts.ts`）。
|
|
||||||
- 不提供 localStorage 实现；后端表是前端 UI 的硬依赖。
|
|
||||||
|
|
||||||
### 5.2 后端表 + 路由（仿 §7A `roundtable_drafts`）
|
|
||||||
|
|
||||||
- 表 `roundtable_chains`：`id`(PK) / `user_id`(idx) / `title`(512) / `description`(text) / `seats`(`PortableLongText`，存 `ChainSeat[]` JSON) / `created_at` / `updated_at`(`BeijingDateTime`)。
|
|
||||||
- 路由 `app/gateway/routers/roundtable_chains.py`，前缀 `/api/roundtable-chains`：`GET ``（列表）/ `POST ``（建）/ `GET /{id}` / `PUT /{id}`（partial，`exclude_unset`）/ `DELETE /{id}`。
|
|
||||||
- 鉴权/属主：`_current_user_id(request)`，跨用户访问一律 404，与 `roundtable_drafts` 完全一致。
|
|
||||||
- 启动 `Base.metadata.create_all` 自动建表（MySQL 生产 / sqlite 本地走同一套 SQLAlchemy 代码，`PortableLongText` 各自降级），登记进 `persistence/models/__init__.py`，store 接到 `app.state` 并 `include_router`。
|
|
||||||
|
|
||||||
> 整体是「复制 §7A 的草稿持久化、把字段换成 chain」的机械工作，风险低。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 6. Step 2 链条模式编排设计（`runChainOrchestration`）
|
|
||||||
|
|
||||||
### 6.1 与现有 `runOrchestration` 的差异
|
|
||||||
|
|
||||||
| 维度 | `runOrchestration`（recommend） | `runChainOrchestration`（chain，新增） |
|
|
||||||
|------|--------------------------------|----------------------------------------|
|
|
||||||
| 谁派活 | 总控 leader | 总控 leader（**不变**） |
|
|
||||||
| 派给谁由谁定 | leader 自由决定 | 前端按链条游标**约束 leader 只能派给下一席位** |
|
|
||||||
| 发言顺序 | leader 每轮自由派 | **链条数组的固定顺序** |
|
|
||||||
| 循环结构 | `while` 直到 leader 返回 `[]` 共识 / MAX_CYCLES | 按链条游标走一趟（每位：leader 派活 → special 交付） |
|
|
||||||
| 收口 | leader 返回 `[]` 即共识 | 链尾后再调一次 leader 做总结收口，产出 `lastLeaderContent` + `hasConsensus` |
|
|
||||||
|
|
||||||
> **核心**：leader 始终在场，只是**每轮的派活目标被前端钉死成链条的下一席位**——前端在 leader 的 `newMessage` 里写明「本轮请通过 `agent_orchestration` 仅向【X】派活」，并对 `leaderRes.dispatched` 做命中校验/纠偏。
|
|
||||||
|
|
||||||
### 6.2 伪代码
|
|
||||||
|
|
||||||
```
|
|
||||||
runChainOrchestration(seedMessage, ids, coord, chainSeats):
|
|
||||||
isOrchestrating = true
|
|
||||||
cancel = false
|
|
||||||
N = chainSeats.length
|
|
||||||
|
|
||||||
for (let i = 0; i < N; i++): // 链条游标，逐位推进
|
|
||||||
if cancel: break
|
|
||||||
seat = chainSeats[i]
|
|
||||||
seatMeta = agentNameToRole[seat.agent_id]
|
|
||||||
|
|
||||||
// ── (a) 总控派活给「链条下一席位」──────────────────────────
|
|
||||||
highlightSpeaker(null) // leader 阶段不高亮任何 sub
|
|
||||||
leaderBubble = appendStreamingDialogue("总控协调", confidence:"链条派活中")
|
|
||||||
leaderTask = buildChainLeaderTask({
|
|
||||||
seedMessage, // 任务目标/约束（首轮）
|
|
||||||
position: i, total: N,
|
|
||||||
nextSeat: seat, // 「本轮请仅向【X(seat.agent_id)】派活」
|
|
||||||
isFirst: i === 0,
|
|
||||||
})
|
|
||||||
leaderRes = await streamMultiAgent(leader, ids, coord, leaderTask, model=globalModel)
|
|
||||||
|
|
||||||
// 约束/纠偏：取 dispatched 中命中 seat.agent_id 的那条 task；
|
|
||||||
// 若 leader 没派或派错（派给非 seat、或派给多个），前端兜底：
|
|
||||||
// - 命中就用它给出的 task 文本（保留总控的承上启下措辞）；
|
|
||||||
// - 没命中则用 leader 的正文 content 作为兜底 task，或回退到模板 task。
|
|
||||||
task = pickChainTask(leaderRes, seat)
|
|
||||||
// leader 若返回 clarification → 暂停链条，走与现状一致的澄清条（§6.3）
|
|
||||||
finalizeDialogue(leaderBubble, leaderRes.content, "派活说明")
|
|
||||||
|
|
||||||
// ── (b) 被派席位交付（special，顺序、不并行）──────────────────
|
|
||||||
markSpeakerStreaming(seatMeta.speakerId)
|
|
||||||
seatBubble = appendStreamingDialogue(seatMeta.displayName, confidence:"调度中")
|
|
||||||
perSeatModel = agentConfigs[seatMeta.speakerId]?.model || globalModel
|
|
||||||
specRes = await streamMultiAgent(special, ids, seat.agent_id, task, model=perSeatModel)
|
|
||||||
finalizeDialogue(seatBubble, specRes.content, "子智能体交付")
|
|
||||||
markSpeakerIdle(seatMeta.speakerId)
|
|
||||||
// 后端 _broadcast 已把本席位交付注入其余 thread 历史 → 下一席位天然可见
|
|
||||||
|
|
||||||
if cancel: return
|
|
||||||
|
|
||||||
// ── (c) 总控收口：综合全链交付，产出最终结论 ──────────────────
|
|
||||||
leaderBubble = appendStreamingDialogue("总控协调", confidence:"汇总链条结论")
|
|
||||||
leaderRes = await streamMultiAgent(leader, ids, coord,
|
|
||||||
"各链条席位已按顺序完成发言，请综合所有交付，输出最终方案，不要再派活。")
|
|
||||||
finalizeDialogue(leaderBubble, leaderRes.content, "全案盖印")
|
|
||||||
setLastLeaderContent(leaderRes.content)
|
|
||||||
setHasConsensus(true); setConsensusPercentage(100)
|
|
||||||
isOrchestrating = false
|
|
||||||
```
|
|
||||||
|
|
||||||
要点：
|
|
||||||
- **派活方仍是总控**，符合「总控按链条顺序派活」的语义；圆桌可视化里每位席位前都先出现一个总控派活气泡，再出现该席位交付气泡。
|
|
||||||
- **约束手段是 prompt + 前端校验，不动后端**：`buildChainLeaderTask` 把「本轮只能派给【X】」写进 leader 的 `newMessage`；`pickChainTask` 对 `leaderRes.dispatched` 做命中校验，派错/未派时兜底，保证链条游标严格推进。
|
|
||||||
- **复用现有三段式气泡 / 高亮 / abort 基建**（`appendStreamingDialogue` / `finalizeDialogue` / `markSpeakerStreaming` / `activeAbortersRef` / `orchestrationCancelRef`），只是驱动顺序不同。
|
|
||||||
- **special 仍是顺序**（不并行），与现状不变量一致（文件顶部注释 §1）。
|
|
||||||
- **收口 leader 调用默认开**（产出 Step 3 结论）；若链条末位本身是「总结陈述」类，可关掉收口，直接拿末位交付当 `lastLeaderContent`。配置位 `chainNeedsLeaderSummary`（默认 true）。
|
|
||||||
|
|
||||||
### 6.3 澄清 / 挂起 / 恢复 / 干预
|
|
||||||
- **澄清**：链条中途某轮 leader 返回 `clarification` → 与现状一致，暂停链条、底部弹澄清条；用户回答后从**当前游标**继续（需记录 `chainCursor`）。
|
|
||||||
- **挂起/恢复**：`isRoundTableRunning` toggle 复用现有机制；恢复时从 `chainCursor` 续跑。MVP 若不做断点续跑，可先只支持「整体停止 / 从头重跑」，UI 文案说明（扩展点，§7 阶段 4 标注）。
|
|
||||||
- **干预**：可在两席位之间插入一条用户指令，由下一轮 leader 派活前消化。MVP 同上可后置。
|
|
||||||
|
|
||||||
### 6.4 多轮链条（扩展点，非 MVP）
|
|
||||||
单趟遍历是 MVP。若要「链条跑完后总控判断是否再来一轮」，可在收口 leader 处复用 `dispatched===[]?` 判定：收口 leader 若仍派活则回到链条头再跑一轮，直到共识或 MAX_CYCLES。MVP 不做，避免复杂度。
|
|
||||||
|
|
||||||
### 6.5 init 复用
|
|
||||||
chain 模式的 Step 2 init **完全复用** `initMultiAgent`：`agentNames = chainSeats.map(s => s.agent_id)`（**按链条顺序**传入，使 `buildRoleTemplates` 的 seat id 顺序 = 链条顺序，且后端注入 coordinator 的「可调度席位清单」也按此序）。init effect 里按 `orchestrationMode` 决定 init 完成后调 `runOrchestration` 还是 `runChainOrchestration`。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 7. 分阶段实现计划
|
|
||||||
|
|
||||||
> 每阶段都可独立交付、独立验收。建议顺序：**数据层 → 配置页 → 弹窗模式 → 链条选择 → Step2 编排 → 持久化兼容与收尾**。
|
|
||||||
|
|
||||||
### 阶段 0 · 后端链条表 + 脚手架（1.5 天） ✅ 已完成
|
|
||||||
**目标**：打地基（含后端持久化），不含前端 UI。
|
|
||||||
- [x] **后端**：仿 §7A `roundtable_drafts` 新建 `roundtable_chains` 表 + `/api/roundtable-chains` 路由（§5.2）：
|
|
||||||
- [x] `persistence/roundtable_chains/`（model + sql repo + `make_roundtable_chain_store`），登记进 `persistence/models/__init__.py`。
|
|
||||||
- [x] `app/gateway/routers/roundtable_chains.py`（GET 列表 / POST / GET{id} / PUT{id} / DELETE），鉴权属主同 `roundtable_drafts`；席位 2–8 + 去重校验。
|
|
||||||
- [x] `deps.py` 接 `app.state.roundtable_chain_store`，`app.py` `include_router`。
|
|
||||||
- [x] 后端测试 `tests/test_roundtable_chains.py`：CRUD + 部分更新 + 跨用户隔离（5 用例全过）。
|
|
||||||
- [x] **前端**：新增 `lib/business-chain.ts`（`ChainSeat` / `BusinessChain` / `SeatSelectionResult`，§3）+ `api/chains.ts`（直接打后端，§5.1）。
|
|
||||||
- [x] （决策 C）安装 `@dnd-kit/core` `@dnd-kit/sortable` `@dnd-kit/utilities`。
|
|
||||||
- **验收**：✅ 后端 5 用例通过；✅ 表注册进 `Base.metadata`、路由 `/api/roundtable-chains` 加载正常；✅ ruff 0 错；✅ 前端 typecheck 新增文件 0 错。
|
|
||||||
|
|
||||||
### 阶段 1 · 业务链条配置页面（2–3 天） ✅ 已完成
|
|
||||||
**目标**：能创建/编辑/保存/删除链条。
|
|
||||||
- [x] 路由：`WorkspaceRoutes.tsx` 注册 `roundtable/chains`（套 `WorkspaceLayout`；本页**不需要** `ChatRuntime`，无沙箱依赖）。
|
|
||||||
- [x] 页面 `roundtable-planning/pages/BusinessChainEditorPage.tsx`：
|
|
||||||
- [x] 顶部：链条列表下拉（`<select>` 列出已存链条 + 新建项）/ 新建按钮 / 标题+描述输入 / 保存 / 删除（`window.confirm`）。
|
|
||||||
- [x] **左栏**：候选智能体（`listAgents()` + `filterRecommendCandidates`），竖排卡片，可拖、可点「＋」快捷加入；已加入的置灰「已加入」。
|
|
||||||
- [x] **右栏**：有序长条卡片（序号 tag + 名称 + 描述 + 移除），`SortableContext` 内拖拽排序；空态有占位提示。
|
|
||||||
- [x] 拖拽用 `@dnd-kit`：左栏 `useDraggable`，右栏 `useDroppable` + `SortableContext`/`useSortable`，`onDragEnd` 计算插入 index（pool→右栏按落点插入；seat→seat `arrayMove`）；`DragOverlay` 跟手卡片。
|
|
||||||
- [x] 校验：`2 ≤ seats ≤ 8`（前端禁用保存 + toast，后端 `_validate_seats` 兜底），重复 agent 去重提示。
|
|
||||||
- [x] 保存走 `api/chains.ts`（create 用 `nanoid()` 客户端 id，update 走同一 id）。
|
|
||||||
- **验收**：✅ typecheck 0 新增错误（76 个预存量错误均在无关模块）。**人工验收待跑**：新建「情报→方案→风险→总结」链保存 → 刷新后下拉重载 → 右栏拖拽排序 → 左栏拖入指定位 → 2–8 边界禁用保存。
|
|
||||||
- **切换成本备注**：若改全屏 Dialog 方案，编辑器组件原样复用，仅去掉路由、外面套 `Dialog`。
|
|
||||||
- **入口说明**：圆桌本身未在侧栏（`sidebar-menu.ts` 入口被注释），本页暂经直链 `/page/workspace/roundtable/chains` 或顶栏「返回圆桌」往返；阶段 3 推荐弹窗「去配置」按钮会导航到此。
|
|
||||||
- **视觉（后续重画）**：本页**不**套圆桌 `roundtable-planning` scope，直接遵循《浅红色/深蓝色 UI 规范》——用 app 语义 token（光 `--primary` 红 hue27 / 暗 蓝 hue259，已内置自适应）+ 规范小圆角（输入/按钮/tag/卡片内项 2px = `R_CTRL`，分栏/面板 4px = `R_CARD`）+ 克制阴影（`PANEL_SHADOW`）。筛选框复用通用 `TagSearchBar`，配色随 app 中性 token，不再被红 scope 染色。
|
|
||||||
|
|
||||||
### 阶段 2 · 推荐弹窗「模式选择」外壳（1 天） ✅ 已完成
|
|
||||||
**目标**：弹窗顶部模式切换，智能推荐行为不变。
|
|
||||||
- [x] `RecommendAgentsDialog` 顶部加**分段按钮**模式切换：`智能推荐 | 业务链条`（active 态品牌色 + 卡底；DialogDescription 随模式切换文案）。
|
|
||||||
- [x] 现有全部内容原样收进「智能推荐」面板（`{mode === "recommend" && (<>…</>)}` 包裹，**零行为变更**）。
|
|
||||||
- [x] 「业务链条」面板放占位：居中提示 + 「去配置业务链条」按钮（`handleGoConfig` → 关弹窗 + 跳 `roundtable/chains`）。
|
|
||||||
- [x] `onConfirm` 统一升级为回传 `SeatSelectionResult`（含 `mode`）：智能推荐确认回传 `{ agents, mode: "recommend" }`；主页面 `handleConfirmAgents` 同步改签名取 `result.agents`（`result.mode` 预留给阶段 4）。
|
|
||||||
- **验收**：✅ typecheck 0 新增错误（总数仍 76）；智能推荐分支 JSX/逻辑原样保留（流式/勾选/进入研讨未改）；模式切换只切显示、`state`/`selectedIds` 不卸载 → 候选池不丢。**人工验收待跑**：切到业务链条→再切回，推荐结果与勾选仍在。
|
|
||||||
|
|
||||||
### 阶段 3 · 业务链条选择卡片列表（1.5 天） ✅ 已完成
|
|
||||||
**目标**：弹窗「业务链条」面板里选链条。新增 `components/BusinessChainPicker.tsx`，替换阶段 2 的占位。
|
|
||||||
- [x] 进入该 Tab 时 `listChains()` 拉本人链条 + `listAgents()` 取存活 id/名称，渲染**卡片列表**：
|
|
||||||
- [x] 卡片标题（链条 title）+ 「N 席」徽章 + 选中 ✓；描述行。
|
|
||||||
- [x] 标题下一排**智能体名 tag**：按链条顺序**从左到右**、不同颜色（`getAvatarTypeFor`→`chainTagClasses`），tag 之间插 `→`（`ArrowRightIcon`）箭头连接（`seats[0]` 最左、先发言）。
|
|
||||||
- [x] 底部「配置链条」按钮（跳 `roundtable/chains`）。
|
|
||||||
- [x] 空态：无链条时引导「去配置页面创建第一条业务链条」+ 按钮。
|
|
||||||
- [x] 选中一条 → 高亮（`ring-primary`）；底部「进入研讨」`onConfirm({ agents: 存活席位有序, mode:"chain", chain:{id,title} })`。
|
|
||||||
- [x] 链条里有 agent 已不存在（被删）→ 该 tag 置灰删除线 + `title` 提示 + 卡片下方 amber 警告；confirm 按**存活席位**过滤；存活 < `CHAIN_MIN_SEATS` 则禁用「进入研讨」并提示。agent 列表加载失败时 `existingIds=null` → 不误判删除。
|
|
||||||
- **验收**：✅ typecheck 0 新增错误（总数仍 76）。卡片渲染标题 + 彩色 tag + ← 箭头；选链 → `onConfirm(mode:"chain")` → `handleConfirmAgents` 按链条顺序 `setSelectedAgents` → Step 2 左侧「参与角色」顺序 = 链条顺序（**按顺序派活在阶段 4**）。**人工 UI 验收待跑**。
|
|
||||||
- **箭头方向**（已确认）：tag 左→右排列、`→`（`ArrowRightIcon`）连接，`seats[0]` 最左、先发言，箭头顺读即链条研讨顺序。
|
|
||||||
|
|
||||||
### 阶段 4 · Step 2 链条顺序编排（2–3 天） ✅ 已完成
|
|
||||||
**目标**：chain 模式按链顺序逐席发言。**后端零改动。**
|
|
||||||
- [x] 主页面新增 `orchestrationMode` 状态，`handleConfirmAgents` 从 `SeatSelectionResult.mode` 写入（chain 模式 toast 带链名）；`handleStartNewTask` 复位为 `recommend`；透传给 `useStep2Orchestration`。chain 顺序 = `selectedAgents`（确认时已按链条顺序写入），无需单独 `chainSeats`。
|
|
||||||
- [x] `useStep2Orchestration` 新增 `runChainOrchestration`（§6.2）+ `orchestrationModeRef`/`selectedAgentsRef`；复用现有三段式气泡/高亮/abort 基建。
|
|
||||||
- [x] 新增 `runActiveOrchestration` 分发器：init / 恢复 / 干预 / 澄清回复 4 处调用点统一改走它，按 `orchestrationModeRef` 选 `runOrchestration`（recommend）或 `runChainOrchestration`（chain）。
|
|
||||||
- [x] `runChainOrchestration`：按 `selectedAgents` 游标，每位先 leader 约束派活（`buildChainLeaderTask` 钉死目标席位 + `pickChainTask` 命中校验/纠偏，派错/未派都兜底推进）→ 再对**该席位**跑 special；中途 leader 若 `clarification` 则暂停（MVP 回复后整链重跑）。
|
|
||||||
- [x] `initMultiAgent` 的 `agentNames` 即 `roundtableAgentIds`（由 `selectedAgents` 派生，已是链条顺序，§6.5）。
|
|
||||||
- [x] 收口 leader（`finishedAllSeats` 时触发），产出 `lastLeaderContent` + `hasConsensus=true` + `consensusPercentage=100` 解锁 Step 3。
|
|
||||||
- **验收**：✅ typecheck 0 新增错误（总数仍 76）；✅ 唯一直接引用 `runOrchestration` 的是 dispatcher。逻辑层：每席「总控派活气泡 → 席位交付气泡」、严格顺序、单 special 在跑、`_broadcast` 注入前序上下文、leader 纠偏推进、跑完解锁 Step 3、abort 可中断。**人工 UI 验收待跑**。
|
|
||||||
- **MVP 边界**：chain 模式的「挂起→断点续跑」「逐席间干预」未做断点续跑，`clarification`/恢复/干预当前为**整链重跑**（`chainCursor` 列为扩展点）。
|
|
||||||
|
|
||||||
### 阶段 5 · 草稿持久化兼容 + 收尾（1 天） ✅ 已完成
|
|
||||||
**目标**：草稿记住模式，回归不破。
|
|
||||||
- [x] `Step2Snapshot`（`useStep2Orchestration.ts`）+ `DraftStep2Snapshot`（`api/drafts.ts`）新增 `orchestrationMode?: "recommend"|"chain"` 与 `chain?: {id,title}|null`。
|
|
||||||
- [x] 恢复路径：`orchestrationMode`/`chainMeta` 是**主页面 state**，`getStep2Snapshot` 写入；**包裹版 `hydrateStep2`** 在加载时 `setOrchestrationMode(snapshot.orchestrationMode ?? "recommend")` + `setChainMeta(snapshot.chain ?? null)` 再调 `step2.hydrateFromDraft`；老草稿无字段 → 默认 `recommend`（向后兼容）。`handleStartNewTask` 复位两者。
|
|
||||||
- [x] 文档回写：`multi-agent-frontend-dev.md` §5.7（快照形状 + `orchestrationMode/chain` 说明）、§6.2（席位来源选择器导语）；`multi-agent-backend-dev.md` 新增 §7B（`roundtable_chains` 表/路由）。
|
|
||||||
- **验收**：✅ `pnpm typecheck` 0 新增错误（总数仍 76）。逻辑：chain 会话保存草稿 → 重载 `orchestrationMode="chain"` + 链信息恢复；老草稿（无字段）默认 recommend 照常加载。**人工 UI 验收 + `pnpm build` 待跑**。
|
|
||||||
|
|
||||||
### 工期粗估
|
|
||||||
| 阶段 | 估时 |
|
|
||||||
|------|------|
|
|
||||||
| 0 后端链条表 + 脚手架 | 1.5d |
|
|
||||||
| 1 配置页 | 2–3d |
|
|
||||||
| 2 弹窗模式壳 | 1d |
|
|
||||||
| 3 链条选择卡片 | 1.5d |
|
|
||||||
| 4 Step2 链编排 | 2–3d |
|
|
||||||
| 5 持久化兼容收尾 | 1d |
|
|
||||||
| **合计** | **约 9–11 人日**（含后端 `roundtable_chains` 表/路由） |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 8. 验收清单（端到端）
|
|
||||||
|
|
||||||
1. 推荐弹窗顶部有「智能推荐 / 业务链条」切换；智能推荐与现状逐像素一致。
|
|
||||||
2. 配置页 `/page/workspace/roundtable/chains` 左栏列出智能体、右栏有序长条卡片；左→右拖入指定位、右栏内拖拽排序均生效；2–8 校验生效；保存/重载/删除正常。
|
|
||||||
3. 业务链条卡片：标题 + 彩色智能体 tag + ← 箭头连接，渲染正确。
|
|
||||||
4. 选定链条 → Step 2 席位顺序 = 链条顺序，并**按顺序逐个发言**，后序能看到前序交付。
|
|
||||||
5. chain 跑完解锁 Step 3；草稿记住 chain 模式并可重载。
|
|
||||||
6. 删除链条中引用的 agent 后，选择端有降级提示，不崩。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 9. 风险与开放问题
|
|
||||||
|
|
||||||
| # | 项 | 说明 / 建议 |
|
|
||||||
|---|----|-------------|
|
|
||||||
| 1 | 配置页：弹窗 vs 页面 | 本文档定为**独立页面**（§2.1）。若产品要弹窗，编辑器组件可复用，仅换外壳。**请确认。** |
|
|
||||||
| 2 | 链条持久化 | **已定：后端 MySQL `roundtable_chains`**（§2.2 / §5.2），仿草稿持久化。 |
|
|
||||||
| 3 | Step 2 链编排 | **已定：总控按链条顺序派活**（§2.4 / §6），后端零改动。 |
|
|
||||||
| 4 | 新增 `@dnd-kit` 依赖 | 若禁止新增依赖，退原生 HTML5 DnD（手感与可达性下降）。**请确认。** |
|
|
||||||
| 5 | ← 箭头方向 / tag 阅读顺序 | 默认 `seats[0]` 在最左、先发言；箭头仅作视觉连接。**请确认是否要「从右往左读」。** |
|
|
||||||
| 6 | chain 模式是否需要收口 leader 总结 | 默认需要（产出 Step 3 结论）。若末位席位自带总结可关掉。 |
|
|
||||||
| 7 | leader 派活纠偏策略 | leader 派错/未派时前端兜底推进游标（§6.2 `pickChainTask`）；可加 toast 提示「已按链条强制推进」。 |
|
|
||||||
| 8 | chain 模式断点续跑 / 逐席干预 | MVP 不做，列为扩展点（§6.3 / §7 阶段 4）。 |
|
|
||||||
| 9 | 链条是否私有 | 本期仅本人私有（仿草稿按 `user_id` 隔离）。共享/市场留扩展。 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 10. 路径速查（新增/改动）
|
|
||||||
|
|
||||||
| 资源 | 路径 | 状态 |
|
|
||||||
|------|------|------|
|
|
||||||
| 链条类型 | `frontend-web/src/roundtable-planning/lib/business-chain.ts` | 新增 |
|
|
||||||
| 链条 API 客户端 | `frontend-web/src/roundtable-planning/api/chains.ts` | 新增 |
|
|
||||||
| 配置页 | `frontend-web/src/roundtable-planning/pages/BusinessChainEditorPage.tsx` | 新增 |
|
|
||||||
| 链条选择面板 | `frontend-web/src/roundtable-planning/components/BusinessChainPicker.tsx` | 新增 |
|
|
||||||
| 链条卡片 | `frontend-web/src/roundtable-planning/components/BusinessChainCard.tsx` | 新增 |
|
|
||||||
| 推荐弹窗（加模式壳） | `frontend-web/src/roundtable-planning/components/RecommendAgentsDialog.tsx` | 改 |
|
|
||||||
| 主页面（mode 透传） | `frontend-web/src/roundtable-planning/pages/RoundtablePlanningPage.tsx` | 改 |
|
|
||||||
| Step2 编排（加 chain） | `frontend-web/src/roundtable-planning/hooks/useStep2Orchestration.ts` | 改 |
|
|
||||||
| 草稿快照（加 mode） | `hooks/useDraftPersistence.ts` + `api/drafts.ts` | 改 |
|
|
||||||
| 路由注册 | `frontend-web/src/pages/WorkspaceRoutes.tsx` | 改 |
|
|
||||||
| 后端链条持久化 | `offline-backend-20260512/backend/packages/harness/deerflow/persistence/roundtable_chains/` | 新增 |
|
|
||||||
| 后端链条路由 | `offline-backend-20260512/backend/app/gateway/routers/roundtable_chains.py` | 新增 |
|
|
||||||
| 后端 store 接线 | `offline-backend-20260512/backend/app/gateway/deps.py`（`app.state.roundtable_chain_store`）+ `app.py` | 改 |
|
|
||||||
</content>
|
|
||||||
</invoke>
|
|
||||||
@@ -1,781 +0,0 @@
|
|||||||
# 多智能体圆桌研讨 · 前端开发文档
|
|
||||||
|
|
||||||
本文档面向维护 `frontend-web` 圆桌规划功能的开发者。后端实现见 `multi-agent-backend-dev.md`；HTTP 字段速查见 `multi-agent-api.md`；推荐弹窗专项进度见 `recommend-agents-progress.md`（若不存在则为待补文件）。
|
|
||||||
|
|
||||||
> ⚠️ 历史版本曾引用 `multi-agent-step1-api.md`、`multi-agent-step3-api.md`，当前仓库未提供这两份文件；Step 1（intent）/ Step 3（artifacts）的接口签名直接参考本页第 4 节即可。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 0. 速读：你需要先知道的事
|
|
||||||
|
|
||||||
- **三步 UI 通过 `currentStep ∈ {1,2,3}` 切换**，不使用 React Router 子路由。主页面 `RoundtablePlanningPage.tsx`（≈ 1 150 行）只负责组合 + 编排，业务状态全部下沉到三个 hook（见下面）。
|
|
||||||
- **业务状态分三块**：`useStep1Intent`（任务理解 + 澄清）、`useStep2Orchestration`（编排循环 + 对话流 + Persona）、`useDraftPersistence`（草稿）。改 Step X 的逻辑请直接进对应 hook，不要回到主页面里写。
|
|
||||||
- **消息气泡有共享件**：Step 1 / Step 2 的对话气泡共用 `MessageBubble.tsx` 里的 `MessageBubble` + `MessageLoadingPlaceholder` + `StreamingCursor` + `MarkdownContent`。改气泡通用样式（头像、header、loading、流式 cursor、Markdown 渲染配置）请改这里,不要在两个 Panel 各改一遍。
|
|
||||||
- **步骤折叠卡与主聊天对齐**：思考过程 / 工具调用展示走 `MessageStepsCard`,**always-show-last-tool + 折叠 "查看其他 N 个步骤"** 的视觉与主聊天 `chats/new` 的 `MessageGroup` 一致。工具图标 / 文案映射在 `lib/step-display.tsx`,新增工具时与 `src/core/i18n/locales/zh-CN.ts` 的 `toolCalls` 字段对齐。
|
|
||||||
- **`<think>` 标签自动提取为「思考过程」**：`lib/reasoning.ts::splitInlineReasoning(text)` 把 `<think>...</think>`(含未闭合的流式中段)抽离成 `reasoning`,正文走 markdown;由 `MessageBubble.tsx::ReasoningBlock` 渲染一个折叠卡。Step 1 / Step 2 气泡和推荐弹窗的 rationale 都走这一套,与主聊天 `Reasoning` 元素的视觉对齐。
|
|
||||||
- **不使用 LangGraph SDK**：所有 API 都是自研的 `apiFetch` + `ReadableStream` SSE 解析（见 `api/intent.ts`、`api/recommend.ts`、`api/multi-agent.ts`）。
|
|
||||||
- **草稿/历史持久化在后端（2026-06）**：草稿不再存浏览器 `localStorage`，改走后端 MySQL（`/api/roundtable-drafts`，按登录用户隔离、跨设备保留）。`api/drafts.ts` 封装 CRUD，`useDraftPersistence` 异步对接、对外接口不变。**推荐弹窗带「会话级推荐历史」**：每个草稿一串历史，重开弹窗先显示上次推荐结果，可「重新分析」重跑（详见 §5.7 / §6.2）。后端实现见 backend doc 的「圆桌草稿持久化」一节。
|
|
||||||
- **不写死模型名**：与 `/page/canvas/ai-writing` 同样的策略 —— 全局选中模型由 `selectedModel` state 维护，首次 `useModels()` 完成后初始化为 `availableModels[0].name`，顶栏「模型」下拉可切换。所有 API 调用统一传 `model: selectedModel || undefined`；后端缺省由 `lead_agent._resolve_model_name()` 回退到 `config.yaml` 的 `models[0]`。**内网部署只需在 `config.yaml` 配自家模型即可，前后端均无需改动**。
|
|
||||||
- **席位区间硬约束**：推荐弹窗要求 **2 ≤ 选中数 ≤ 8**（`MIN_SELECTED` / `MAX_SELECTED`）。
|
|
||||||
- **协调智能体单例（2026-05）**：`COORDINATOR_AGENT_ID = "roundtable-coordinator"` 是固定常量，不再每会话生成新 id。后端 seeder 自动落地，「本次席位列表」改由后端通过 thread 历史 human 消息注入，前端无感。`newCoordinatorName()` 仅作为兼容性壳保留。
|
|
||||||
- **总控编排循环上限**：`MAX_CYCLES = 8`，超出后强制停止并 toast。
|
|
||||||
- **席位派活策略**：**顺序**（不是并行）。旧实现并行触发多路 SSE 会让浏览器卡顿，现已改为顺序。
|
|
||||||
- **调试开关**：`window.__MULTI_AGENT_INIT_TIMING__` 与 `window.__MULTI_AGENT_DEBUG__`（**不是** `__MULTI_AGENT_STREAM_DEBUG__`，文档历史版本有误）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 功能定位
|
|
||||||
|
|
||||||
**页面路由**：`/page/workspace/roundtable/planning`（侧栏「圆桌规划」）
|
|
||||||
|
|
||||||
**入口组件**：`src/roundtable-planning/pages/RoundtablePlanningPage.tsx`
|
|
||||||
|
|
||||||
**核心能力**：
|
|
||||||
|
|
||||||
| 步骤 | 用户目标 | 真实后端对接 |
|
|
||||||
|------|----------|--------------|
|
|
||||||
| 1 | 与「任务理解智能体」多轮澄清，得到结构化意图 | `intent.ts` |
|
|
||||||
| 1→2 | 从候选池选 2–8 个研讨席位 | `recommend.ts` + `RecommendAgentsDialog` |
|
|
||||||
| 2 | 总控派活、子智能体顺序交付、可澄清/挂起 | `multi-agent.ts` + 编排循环 |
|
|
||||||
| 3 | 查看总控结论、席位交付、产出文件下载 | `HighFidelityReport` + `listSessionArtifacts` |
|
|
||||||
|
|
||||||
**步骤门禁**：
|
|
||||||
|
|
||||||
- **Step 2**：`intentReady` 非空才可点击（顶栏按钮禁用 + toast 提示）。
|
|
||||||
- **Step 3**：`hasConsensus === true` 才可点击。Leader 派活返回空数组才会自然收敛触发 `hasConsensus`，手动跳转的「达成共识生成全案成果」按钮也会校验。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 目录结构
|
|
||||||
|
|
||||||
```
|
|
||||||
frontend-web/src/roundtable-planning/
|
|
||||||
├── index.ts # 导出 RoundtablePlanningPage、HighFidelityReport
|
|
||||||
├── pages/
|
|
||||||
│ └── RoundtablePlanningPage.tsx # 主页面：组合 hook + 顶栏/侧栏 + 三步路由（≈1 150 行）
|
|
||||||
├── api/
|
|
||||||
│ ├── intent.ts # Step 1：initIntent、streamIntent
|
|
||||||
│ ├── recommend.ts # 推荐：streamRecommend、filterRecommendCandidates、parseRecommendStreamContent；**+ 推荐历史 listRecommendHistory / saveRecommendHistory**
|
|
||||||
│ ├── drafts.ts # **草稿后端 CRUD**：listDrafts / getDraft / createDraft / updateDraft / deleteDraft / deriveDraftName（替代旧 localStorage utils/drafts.ts）
|
|
||||||
│ └── multi-agent.ts # Step 2/3：initMultiAgent、streamMultiAgent、listSessionArtifacts、buildArtifactDownloadUrl
|
|
||||||
├── components/
|
|
||||||
│ ├── Avatars.tsx # 所有 SVG 头像 + getAvatar 选择器
|
|
||||||
│ ├── MessageBubble.tsx # Step 1/2 共享:消息壳 + loading 占位 + 流式 cursor + MD 配置
|
|
||||||
│ ├── MessageStepsCard.tsx # Step 1/2 共享:工具调用 + 思考过程的折叠卡(对齐主聊天 MessageGroup)
|
|
||||||
│ ├── Step1Panel.tsx # Step 1 对话面板（不含状态,只读 props）
|
|
||||||
│ ├── Step2Panel.tsx # Step 2 主面板（圆桌对话流 + 澄清条 + 干预输入）
|
|
||||||
│ ├── Step3Panel.tsx # Step 3 薄壳,内部仍是 HighFidelityReport
|
|
||||||
│ ├── PersonaDrawer.tsx # Step 2 Persona 抽屉（System Prompt / Temp / Model）
|
|
||||||
│ ├── IntentClarificationCard.tsx # Step 1 选项卡片（单选/多选）+ formatIntentClarificationAnswer
|
|
||||||
│ ├── RecommendAgentsDialog.tsx # Step 1→2 推荐弹窗（含流式 rationale + 候选筛选）
|
|
||||||
│ ├── HighFidelityReport.tsx # Step 3 报告 + 文件清单
|
|
||||||
│ ├── ArtifactPreviewModal.tsx # Markdown/纯文本/JSON/CSV/YAML 等文本类文件 in-app 预览
|
|
||||||
│ └── ScrollToBottomButton.tsx # 对话区「回到底部」浮动按钮
|
|
||||||
├── hooks/
|
|
||||||
│ ├── useAutoScroll.ts # 滚动跟随 + 用户上滑暂停跟随
|
|
||||||
│ ├── useStep1Intent.ts # Step 1 状态机:init、send、stream、abort、INTENT_READY 同步
|
|
||||||
│ ├── useStep2Orchestration.ts # Step 2 状态机:initMultiAgent + 编排循环 + 对话流管理 + Persona
|
|
||||||
│ └── useDraftPersistence.ts # 草稿(后端版):异步走 api/drafts;自动保存(前进切换)/手动保存/加载/重命名/删除/ensureDraft
|
|
||||||
├── lib/
|
|
||||||
│ ├── clarification.ts # resolveAllowMultiple（单选/多选解析）,与主聊天 ClarificationCard 对齐
|
|
||||||
│ ├── reasoning.ts # splitInlineReasoning:从模型流式文本里提取 `<think>...</think>` 思考过程
|
|
||||||
│ ├── roundtable-constants.ts # 类型(RoleEntry / SelectedAgent) + 常量 + 纯工具函数(buildRoleTemplates / splitIntentReadyBlock 等)
|
|
||||||
│ └── step-display.tsx # Step 2 ChainOfThought 折叠卡图标 + 文案 + 子节点渲染
|
|
||||||
├── utils/ # （旧 drafts.ts 已删除 —— 草稿改走后端 api/drafts.ts）
|
|
||||||
└── styles/
|
|
||||||
└── roundtable-planning.css # 页面主题变量（浅红品牌色 + 深色覆盖）
|
|
||||||
```
|
|
||||||
|
|
||||||
**模块依赖方向（自上而下）**：
|
|
||||||
|
|
||||||
```
|
|
||||||
pages/RoundtablePlanningPage
|
|
||||||
├─ uses → hooks/useStep1Intent
|
|
||||||
├─ uses → hooks/useStep2Orchestration
|
|
||||||
├─ uses → hooks/useDraftPersistence (依赖 step1 / step2 的 getSnapshot + hydrate)
|
|
||||||
├─ uses → components/Step{1,2,3}Panel (纯 props 驱动)
|
|
||||||
├─ uses → components/RecommendAgentsDialog
|
|
||||||
└─ uses → components/Avatars
|
|
||||||
|
|
||||||
hooks/useStep1Intent → api/intent
|
|
||||||
hooks/useStep2Orchestration → api/multi-agent + components/PersonaDrawer 的类型
|
|
||||||
hooks/useDraftPersistence → utils/drafts + step1/step2 的 Snapshot 类型
|
|
||||||
```
|
|
||||||
|
|
||||||
主页面通过 ref 桥接两个 hook 之间的依赖（`buildInitialIntent` 在 Step 2 init 时从 Step 1 状态读取），避免 hook 互相引用造成的循环导入。
|
|
||||||
|
|
||||||
**路由注册**（`src/pages/WorkspaceRoutes.tsx`）：
|
|
||||||
|
|
||||||
```tsx
|
|
||||||
<Route path="roundtable/planning" element={<WorkspaceLayout><RoundtablePlanningPage /></WorkspaceLayout>} />
|
|
||||||
```
|
|
||||||
|
|
||||||
侧栏入口：`src/components/page-sidebar.tsx` → `/page/roundtable/planning`。
|
|
||||||
|
|
||||||
**环境变量**（由 `scripts/start-frontend.sh` 注入）：
|
|
||||||
|
|
||||||
- `VITE_BACKEND_BASE_URL` → `getBackendBaseURL()`，所有 API 前缀
|
|
||||||
- `VITE_LANGGRAPH_BASE_URL` → 本功能**不**直接用 LangGraph SDK，全部走 Gateway 封装
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 三步数据流（前端视角）
|
|
||||||
|
|
||||||
```
|
|
||||||
[进入 Step 1]
|
|
||||||
useEffect → runStep1Init()
|
|
||||||
initIntent(model) → { agent_id, thread_id }
|
|
||||||
setIntentThreadId、setTimelineEntries
|
|
||||||
interactiveMessages seed 欢迎语（本地 seed，非 API）
|
|
||||||
|
|
||||||
[用户发送 / 选项卡片提交]
|
|
||||||
sendIntentMessage(text)
|
|
||||||
追加 user 气泡 + agent 占位（streaming + phase）
|
|
||||||
streamIntent({ onTextDelta, onPhaseChange, signal })
|
|
||||||
终态：
|
|
||||||
done + summary → setIntentReady，解锁 Step 2 / 推荐弹窗
|
|
||||||
clarification → IntentClarificationCard + pendingIntentClarificationMsgId
|
|
||||||
asking → 继续对话
|
|
||||||
error → toast + 红色 (错误) 文案
|
|
||||||
|
|
||||||
[点击「进入多智能体研讨」且 intentReady]
|
|
||||||
setIsRecommendDialogOpen(true)
|
|
||||||
RecommendAgentsDialog
|
|
||||||
listAgents() → filterRecommendCandidates()
|
|
||||||
streamRecommend({ onRationaleUpdate, onPicksUpdate, onPhaseChange })
|
|
||||||
用户勾选 2–8 个 → onConfirm(agentIds)
|
|
||||||
handleConfirmAgents
|
|
||||||
setSelectedAgents(agentIds.map(...))
|
|
||||||
step2InitRef.current = false // 复位 Step 2 init 闸门
|
|
||||||
setCurrentStep(2)
|
|
||||||
|
|
||||||
[进入 Step 2]
|
|
||||||
useEffect（step2InitRef 闸门）→ initMultiAgent(SSE)
|
|
||||||
onSeatReady：右侧席位面板逐个「在线」
|
|
||||||
onCoordinatorReady / init_done → threadIds + coordinatorName
|
|
||||||
runOrchestration(buildInitialIntent(), threadIds, coordinatorName)
|
|
||||||
while !cancelled && cycles<8:
|
|
||||||
leader stream → 若 clarification：暂停循环，展示 Step 2 底部澄清条
|
|
||||||
否则 dispatched[] → **顺序** streamMultiAgent(special) → 再 leader 综合…
|
|
||||||
dispatched.length === 0 → hasConsensus = true，可进 Step 3
|
|
||||||
|
|
||||||
[进入 Step 3]
|
|
||||||
HighFidelityReport
|
|
||||||
consensusText ← lastLeaderContent
|
|
||||||
seatDeliveries ← step2RoundtableDialogues.filter(d => d.confidence === "子智能体交付")
|
|
||||||
Object.entries(threadIds).filter(name !== coordinatorName).map → listSessionArtifacts(threadId)
|
|
||||||
文本类文件 → ArtifactPreviewModal；其它 → window.open(downloadUrl)
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. API 层
|
|
||||||
|
|
||||||
### 4.1 `api/intent.ts` — Step 1
|
|
||||||
|
|
||||||
| 函数 | 说明 |
|
|
||||||
|------|------|
|
|
||||||
| `initIntent(model?)` | `POST /api/intent/init` → `{ status, agent_id, thread_id }` |
|
|
||||||
| `streamIntent(req)` | `POST /api/intent/stream`，读 SSE 至终态帧 |
|
|
||||||
|
|
||||||
**`StreamIntentRequest` 重要字段**：
|
|
||||||
|
|
||||||
- `threadId`：必填，跨多轮对话保持
|
|
||||||
- `signal`：必填（页面通过 `intentAborterRef` 控制暂停 / 切步取消）
|
|
||||||
- `onTextDelta(text, messageId)`：每个 AI 文本增量
|
|
||||||
- `onPhaseChange(phase, toolName?)`：`connecting → connected → streaming|tool_calling`
|
|
||||||
- **`onClarification(clarification, index)`（2026-06）**：每解析到一条 `ask_clarification` 工具结果帧就回调一次，让前端**实时**逐个渲染澄清卡。任务理解智能体**一轮可能问多个问题**，这是「实时接收显示协助过程」的关键入口。
|
|
||||||
|
|
||||||
**`StreamIntentResult`**：
|
|
||||||
|
|
||||||
| 字段 | 类型 | 说明 |
|
|
||||||
|------|------|------|
|
|
||||||
| `status` | `"asking" \| "clarification" \| "done" \| "error"` | 终态分支 |
|
|
||||||
| `content` | `string` | 完整 AI 文本（含 `[INTENT_READY]` 块） |
|
|
||||||
| `summary` | `IntentSummary \| null` | 仅 `done` 有；前端 fallback 也会从 `content` 里用 `splitIntentReadyBlock` 解 |
|
|
||||||
| `clarification` | `ClarificationPayload \| null` | **第一个**澄清（向后兼容字段） |
|
|
||||||
| `clarifications` | `ClarificationPayload[]` | **本轮全部澄清问题**（2026-06）。来源是流式 `type:"tool"` 帧而非终态帧——**终态帧只带第 1 个**，多问题必须靠它。每条带 `id`（= `tool_call_id`）供前端按题维护选择。 |
|
|
||||||
|
|
||||||
**SSE 解析要点**：
|
|
||||||
|
|
||||||
- `event: metadata` → phase `connected`
|
|
||||||
- `event: messages` + `extractAiTextDelta` → `onTextDelta`
|
|
||||||
- `event: messages` + `type:"tool"` 且 `name==="ask_clarification"` → `extractClarificationToolMessage` 解出完整澄清（options 已是 `{id,label}`），按 `tool_call_id` 去重后 `onClarification` 实时回调并收进 `result.clarifications`
|
|
||||||
- tool call 帧（`tool_calls` / `tool_call_chunks` 非空）→ phase `tool_calling`（含 `ask_clarification` 工具名）
|
|
||||||
- 终态帧识别：`isFinalIntentFrame`（必须有 `status` + `content`）；`status==="clarification"` 且**未**收到任何流式 tool 澄清帧时，才用终态帧字段兜底合成单条澄清
|
|
||||||
|
|
||||||
**Abort 行为**：
|
|
||||||
|
|
||||||
- `sendIntentMessage` 内建 `AbortController`，保存到 `intentAborterRef`
|
|
||||||
- `stopIntentStream()` 用于「暂停」按钮、`currentStep !== 1` 自动调用、`handleStartNewTask`、`handleLoadDraft`
|
|
||||||
- 触发 AbortError 时不当作错误：在气泡尾部追加「(已暂停)」并 toast「⏸️ 已暂停任务理解回复」
|
|
||||||
|
|
||||||
### 4.2 `api/recommend.ts` — 推荐弹窗
|
|
||||||
|
|
||||||
| 函数 | 说明 |
|
|
||||||
|------|------|
|
|
||||||
| `filterRecommendCandidates(agents)` | 从 `GET /api/agents` 结果剔除 intent / recommender / `roundtable-coordinator-*` |
|
|
||||||
| `streamRecommend(req)` | `POST /api/recommend/stream`，无 init（一次性、无状态） |
|
|
||||||
| `parseRecommendStreamContent(raw)` | 将累计文本拆成 `{ rationale, picks[] }`，供边流边渲染 |
|
|
||||||
|
|
||||||
**`EXCLUDED_AGENT_IDS`** 内置常量（仅 `recommend.ts` 内可见）：
|
|
||||||
|
|
||||||
- `roundtable-intent`
|
|
||||||
- `roundtable-recommender`
|
|
||||||
- 任何以 `roundtable-coordinator-` 开头的 agent_id（动态创建的协调器壳）
|
|
||||||
|
|
||||||
**流式 UI 拆分**（与主聊天的 `[RECOMMEND_READY]` 分界类似）：
|
|
||||||
|
|
||||||
- 标记常量：`RECOMMEND_READY_MARKER = "[RECOMMEND_READY]"`
|
|
||||||
- `parseRecommendStreamContent(raw)`：用 `PICK_OBJECT_PATTERN` 正则增量匹配出已完成的 `{agent_id, reason}` 对象
|
|
||||||
- `onRationaleUpdate`：仅 marker 之前的自然语言（弹窗顶部展示）
|
|
||||||
- `onPicksUpdate`：从部分 JSON 增量解析 `picks[]`（卡片边流边出，过滤已见 id）
|
|
||||||
- 过滤 `TitleMiddleware` 产生的标题增量（`langgraph_node` 含 `TitleMiddleware` 或 `tags` 含 `middleware:title`）
|
|
||||||
|
|
||||||
**终态语义**：
|
|
||||||
|
|
||||||
- `status === "done"` 且 `picks.length >= 2` → 弹窗用 picks 作为默认勾选
|
|
||||||
- 否则 → `phase: "fallback"`，使用 `FALLBACK_AGENT_IDS`（6 个内置 roundtable-* 席位）与候选池交集
|
|
||||||
|
|
||||||
### 4.3 `api/multi-agent.ts` — Step 2 & Step 3 文件
|
|
||||||
|
|
||||||
| 函数 | 说明 |
|
|
||||||
|------|------|
|
|
||||||
| `initMultiAgent(payload)` | SSE：`seat_ready`(N 次) → `coordinator_ready` → `init_done` |
|
|
||||||
| `streamMultiAgent(req)` | leader / special 一轮 |
|
|
||||||
| `listSessionArtifacts(threadId)` | `GET /api/threads/{id}/artifacts` |
|
|
||||||
| `buildArtifactDownloadUrl(threadId, virtualPath, { download? })` | 预览或附件下载 URL |
|
|
||||||
|
|
||||||
**`initMultiAgent` 事件**（`data:` JSON 的 `event` 字段）：
|
|
||||||
|
|
||||||
```ts
|
|
||||||
{ event: "seat_ready", agent_name, thread_id, display_name, description }
|
|
||||||
{ event: "coordinator_ready", main_agent_name, thread_id }
|
|
||||||
{ event: "init_done", main_agent_name, thread_ids } // thread_ids: Record<agent_name, thread_id>
|
|
||||||
{ event: "error", detail }
|
|
||||||
```
|
|
||||||
|
|
||||||
**`streamMultiAgent` 终态**（`isFinalStatusFrame`）：
|
|
||||||
|
|
||||||
| `status` | 含义 | 前端处理 |
|
|
||||||
|----------|------|----------|
|
|
||||||
| `[["agent","task"], ...]` | 派活列表（数组形态） | **顺序**触发 special；最终用 `nextLeaderTask` 综合 |
|
|
||||||
| `[]` | 共识达成（空数组） | `hasConsensus = true`，跳出循环 |
|
|
||||||
| `"clarification"` | 总控追问 | `setPendingClarification`，暂停循环 |
|
|
||||||
| `"子智能体 X 完成..."` | special 完成 | 更新对应对话气泡 confidence |
|
|
||||||
| `"error"` | 失败 | toast + 红色气泡 |
|
|
||||||
|
|
||||||
**为什么 special 是顺序而不是并行**：旧版并行触发多路 SSE，每路都在 token 级别对 `step2RoundtableDialogues` 整表 setState，N 个并行 stream 让浏览器卡顿明显。改为顺序后同一时刻只有一个 SSE 在跑，UX 平滑很多（详见 `RoundtablePlanningPage.tsx` 编排循环里的注释）。
|
|
||||||
|
|
||||||
**`buildArtifactDownloadUrl` 路径编码**：将 `virtualPath` 按 `/` 切段后逐段 `encodeURIComponent` 再拼回，避免文件名里的中文 / 空格触发后端 404；`download=true` 加在 query string 上而非 path。
|
|
||||||
|
|
||||||
**调试开关**：
|
|
||||||
|
|
||||||
```js
|
|
||||||
window.__MULTI_AGENT_INIT_TIMING__ = true; // 默认开启；init 各阶段耗时（fetch.start / first-byte / seat_ready#n / coordinator_ready / init_done / total）
|
|
||||||
window.__MULTI_AGENT_DEBUG__ = true; // 默认开启；stream 帧计数 + lastEvent + bad JSON 提示，前缀 [stream:<agentType>:<agentName>]
|
|
||||||
```
|
|
||||||
|
|
||||||
> ⚠️ 文档历史版本曾写作 `__MULTI_AGENT_STREAM_DEBUG__`，**实际代码并不识别**这个名字。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5. 主页面状态（`RoundtablePlanningPage`）
|
|
||||||
|
|
||||||
> **注意**：自 2026-05 重构后，绝大多数业务状态从主页面下沉到 3 个 hook。下面列出的 state 仍按"位置"分组以便对照原代码，实际所有者请看右列。
|
|
||||||
|
|
||||||
| 维度 | 所有者 | 暴露给主页面的方式 |
|
|
||||||
|------|--------|-------------------|
|
|
||||||
| `currentStep`、`showToast`、`selectedModel`、`roles`、`isRecommendDialogOpen` | 主页面 | useState |
|
|
||||||
| Step 1 全部 state + handler | `useStep1Intent` | hook 返回值 |
|
|
||||||
| Step 2 全部 state + handler + 编排循环 | `useStep2Orchestration` | hook 返回值 |
|
|
||||||
| 草稿(drafts / currentDraftId / 重命名 / 历史下拉) | `useDraftPersistence` | hook 返回值 |
|
|
||||||
| `loadedFromDraftRef` 共享 latch | `useDraftPersistence` 拥有,Step 2 init effect 通过 options 读 | hook 间共享 ref |
|
|
||||||
|
|
||||||
### 5.1 步骤与门禁
|
|
||||||
|
|
||||||
- `currentStep`: `1 | 2 | 3`
|
|
||||||
- **Step 2 锁定**：`intentReady == null` 时顶栏 Step 2 按钮禁用（visual + `aria-disabled`），同时点击「进入多智能体研讨」会 toast 「⚠️ 请先与任务理解智能体完成澄清…」
|
|
||||||
- **Step 3**：`hasConsensus === false` 时顶栏 Step 3 与底部「达成共识生成全案成果」按钮均禁用
|
|
||||||
|
|
||||||
### 5.2 Step 1 关键 state
|
|
||||||
|
|
||||||
| 状态 | 用途 |
|
|
||||||
|------|------|
|
|
||||||
| `intentThreadId` | `/api/intent/init` 返回的线程 id；未就绪前发送按钮置灰 |
|
|
||||||
| `intentReady` | `IntentSummary`，驱动 Step 2 初始 prompt + 右侧摘要面板 + 顶栏 step2 解锁 |
|
|
||||||
| `interactiveMessages` | 问答气泡列表（user / agent，含 streaming/phase/clarification 元数据） |
|
|
||||||
| `pendingIntentClarificationMsgId` | 当前可操作的 agent 消息 id（保证只有最新一条 clarification 展示可点卡片） |
|
|
||||||
| `intentClarificationSelections` | `Map<msgId, {selectedIds, custom}>`，多选 / 多消息时各自维护 |
|
|
||||||
| `isIntentSending` | 发送中（屏蔽双发 / 显示「暂停」按钮） |
|
|
||||||
| `intentAborterRef` | 当前 stream 的 AbortController |
|
|
||||||
| `intentInitError` | init 失败信息；驱动右侧角色面板「异常」状态与红色提示 |
|
|
||||||
| `step1InitRef` | 闸门：true 即认为已 init 过 |
|
|
||||||
| `step1InitGenRef` | **单调递增**的代数标记，详见下文 |
|
|
||||||
| `timelineEntries` | 右侧「澄清记录」时间线（init / user 反馈 / 任务意图已明确） |
|
|
||||||
|
|
||||||
**`step1InitGenRef` 的存在原因**：
|
|
||||||
|
|
||||||
React 18 StrictMode 开发环境下，effect 会 mount → cleanup → mount 两次。早期实现用闭包 `cancelled` 标志做防抖，结果是：第二次 mount 因 `step1InitRef.current === true` 早返回，但第一次 mount 的 async 仍未完成；当它最终 resolve 时，`cancelled` 已被 cleanup 置 true，因此 `setIntentThreadId` 被跳过，右栏卡在「正在上线」。改为单调代数后：每次 `runStep1Init` 自增 `step1InitGenRef`；async 完成时检查 `myGen === step1InitGenRef.current`，等价于「我是当前最新一次 init」，否则丢弃结果。这也覆盖了「新建任务 / 加载草稿期间旧 init 晚归」的场景。
|
|
||||||
|
|
||||||
**`splitIntentReadyBlock(text)`**（页面内工具函数，使用 `INTENT_READY_RE` 正则）：
|
|
||||||
|
|
||||||
- 从气泡正文解析 `[INTENT_READY]\n```json\n{...}\n``` ` 块
|
|
||||||
- 返回 `{ before, summary, after }`，前后文与结构化卡片分别渲染
|
|
||||||
- 单独的 `useEffect` 监听 `interactiveMessages`：若已存在含 `[INTENT_READY]` 的 agent 消息但 `intentReady` 仍为 null（极少数终态帧丢 summary 的场景），主动 `setIntentReady`，与后端 "READY 优先" 对齐
|
|
||||||
|
|
||||||
### 5.3 推荐与 Step 2 席位
|
|
||||||
|
|
||||||
| 状态 | 用途 |
|
|
||||||
|------|------|
|
|
||||||
| `selectedAgents` | `{ agent_id, name }[]`，默认 `DEFAULT_SELECTED_AGENTS`（6 内置） |
|
|
||||||
| `roleTemplates` / `roles` | 右侧席位面板（`buildRoleTemplates`，commander 占 id=1，agents 从 id=2 开始） |
|
|
||||||
| `agentNameToRole` | 流式输出时根据 `agent_name`（小写）反查 speakerId、avatarType、displayName |
|
|
||||||
| `roundtableAgentIds` | `selectedAgents.map(a => a.agent_id)`，传给 `/api/multi-agent/init` 的 `agent_names` |
|
|
||||||
| `threadIds` / `coordinatorName` | `/api/multi-agent/init` 结果；离开 Step 2 **不**清空，允许回来继续看 |
|
|
||||||
| `step2RoundtableDialogues` | Step 2 对话流（含 `streaming` / `confidence` / `time` / `avatarType`） |
|
|
||||||
| `lastLeaderContent` / `hasConsensus` | Step 3 总控结论 + 共识标记 |
|
|
||||||
| `pendingClarification` | Step 2 总控澄清（复用 `ClarificationPayload`） |
|
|
||||||
| `clarificationDraft` | 底部自定义回答输入框（受 `allowCustom` 控制） |
|
|
||||||
| `isRoundTableRunning` | 用户挂起 / 恢复协商的 UI 开关 |
|
|
||||||
| `isOrchestrating` | 编排循环正在 run（屏蔽并发触发） |
|
|
||||||
| `orchestrationCancelRef` | 与 `abortAllInFlight` 配合中断当前循环 |
|
|
||||||
| `activeAbortersRef` | 当前 Step 2 所有 in-flight stream 的 AbortController 集合 |
|
|
||||||
| `activeSpeakerId` / `activeSpeakerSet` | 圆桌可视化高亮：单 leader 时用单值，多席位并行时用 Set |
|
|
||||||
| `selectedAgentId` | 当前 Persona 抽屉所在的席位 id（点击圆桌头像打开） |
|
|
||||||
| `agentConfigs` | `Map<seatId, {model, weight, prompt, temp}>` Persona 覆盖；下一轮该席位的派活会用此 model |
|
|
||||||
| `isUpperPanelCollapsed` | 是否折叠圆桌可视化 + 调控台，给对话区让出垂直空间 |
|
|
||||||
|
|
||||||
**协调智能体命名（2026-05 改造）**：现在是**固定单例 id** `roundtable-coordinator`（见 `lib/roundtable-constants.ts::COORDINATOR_AGENT_ID`）。`newCoordinatorName()` 函数为兼容性保留，内部直接返回这个常量字符串。后端 `ensure_roundtable_functional_agents()` 缺失自动落地，不再每次新建。`filterRecommendCandidates` 在 `EXCLUDED_AGENT_IDS` 集合里同时排除：
|
|
||||||
|
|
||||||
- `roundtable-coordinator`（新版单例 id，永远过滤）；
|
|
||||||
- `roundtable-coordinator-*` 前缀（历史残留，管理员清理之前先在 UI 隐藏）。
|
|
||||||
|
|
||||||
> 历史草稿兼容性：用户加载 2026-05 前保存的草稿时，存储的 `coordinatorName` 仍是 `roundtable-coordinator-<ts36>` 形式。只要那个旧 agent 目录还在磁盘上（即运维没手动删过），加载后继续在 Step 2 干活就能正常工作；如果旧 agent 被清理掉了，需要让用户「重新起草」从头跑一遍 Step 1 → Step 2。
|
|
||||||
|
|
||||||
### 5.4 编排循环 `runOrchestration(seedMessage, ids, coord)`
|
|
||||||
|
|
||||||
伪代码：
|
|
||||||
|
|
||||||
```
|
|
||||||
isOrchestrating = true
|
|
||||||
orchestrationCancelRef = false
|
|
||||||
nextLeaderTask = seedMessage
|
|
||||||
cycles = 0
|
|
||||||
MAX_CYCLES = 8
|
|
||||||
|
|
||||||
while !cancelled && cycles < MAX_CYCLES:
|
|
||||||
cycles += 1
|
|
||||||
highlight(speakerId=2) // 总控
|
|
||||||
leaderBubble = appendStreamingDialogue("总控协调", confidence: "调度中")
|
|
||||||
res = streamMultiAgent(leader, ids, coord, nextLeaderTask, onTextDelta, onPhaseChange)
|
|
||||||
|
|
||||||
if res.clarification:
|
|
||||||
finalize(leaderBubble, content, "等待用户澄清")
|
|
||||||
setPendingClarification(res.clarification)
|
|
||||||
break // 等用户回复后由 submitClarification 重启循环
|
|
||||||
|
|
||||||
finalize(leaderBubble, content, dispatched.length === 0 ? "全案盖印" : "派活说明")
|
|
||||||
if res.content: setLastLeaderContent(res.content)
|
|
||||||
|
|
||||||
if res.dispatched.length === 0:
|
|
||||||
setHasConsensus(true); setConsensusPercentage(100); break
|
|
||||||
|
|
||||||
for [subName, task] of res.dispatched: // **顺序**，不是并行
|
|
||||||
meta = agentNameToRole[subName.toLowerCase()]
|
|
||||||
markSpeakerStreaming(meta.speakerId)
|
|
||||||
perSeatModel = agentConfigs[meta.speakerId]?.model || DEFAULT_MODEL
|
|
||||||
subBubble = appendStreamingDialogue(meta.displayName, confidence: "调度中")
|
|
||||||
specRes = streamMultiAgent(special, ..., perSeatModel, signal=subAborter)
|
|
||||||
finalize(subBubble, specRes.content, "子智能体交付")
|
|
||||||
markSpeakerIdle(meta.speakerId)
|
|
||||||
if cancelled: break
|
|
||||||
|
|
||||||
setConsensusPercentage(prev => min(95, prev + 8))
|
|
||||||
nextLeaderTask = "各子智能体已就上一轮派活完成交付,请你结合最新结论..."
|
|
||||||
|
|
||||||
if cycles >= MAX_CYCLES:
|
|
||||||
toast("⏱️ 已达到最大研讨轮次,自动停止以避免循环")
|
|
||||||
|
|
||||||
clearAllStreamingSpeakers()
|
|
||||||
isOrchestrating = false
|
|
||||||
```
|
|
||||||
|
|
||||||
要点：
|
|
||||||
|
|
||||||
- **`buildInitialIntent()`**：
|
|
||||||
- 有 `intentReady` → 拼装 `objective / 约束条件 / 关键假设` + 「不要再反问用户」终结语
|
|
||||||
- 无 `intentReady`（用户跳过澄清 / 顶栏直接切到 Step 2）→ 拼接 Step 1 内 `interactiveMessages` 里 sender==='user' 的内容，逐行 `用户#N: ...`，**绝不**注入 mock 的「预算 500 万 / 72 小时」数字
|
|
||||||
- 用户输入完全为空 → 让总控先调用 `ask_clarification` 而不是凭空派活
|
|
||||||
- **用户「干预研审」**：`handleInjectToRoundtable` 追加一个「💡 (人工指令介入) ...」气泡，然后构造 `runOrchestration("用户人工干预新指令:...", ...)`
|
|
||||||
- **挂起 / 恢复**：
|
|
||||||
- 挂起 = `setIsRoundTableRunning(false)` → `stopOrchestration()` → `orchestrationCancelRef = true` + `abortAllInFlight()`
|
|
||||||
- 恢复 = `setIsRoundTableRunning(true)`，effect 触发 `runOrchestration("用户已恢复研讨,请继续上一轮的协调工作。", ...)`
|
|
||||||
- **澄清恢复**：`submitClarification` 把用户回答拼到 prompt 里再 `runOrchestration`，不会重建 thread
|
|
||||||
|
|
||||||
### 5.5 Persona 抽屉（Step 2 圆桌可视化点击）
|
|
||||||
|
|
||||||
- 点击圆桌头像 → `setSelectedAgentId(seatId)` → 在上半部分下方展开抽屉
|
|
||||||
- 抽屉控件：
|
|
||||||
- **System Prompt**：仅前端记录（后端覆写未开放）
|
|
||||||
- **Temp**：仅前端记录
|
|
||||||
- **推理模型**：选项来自 `useModels()`；显示值优先级 `agentConfigs[seat]?.model > selectedModel`
|
|
||||||
- 「参数覆盖并重启动算研讨」按钮 → `handleSaveAgentAndRecalculate`：
|
|
||||||
- 把新的 `(seatId, model)` 写入 `agentConfigs`
|
|
||||||
- 追加一条「⚡ [模型偏好已保存] ...」对话气泡
|
|
||||||
- **不**立即重启编排；下一轮该席位被派活时 `runOrchestration` 内会读 `agentConfigs[meta.speakerId]?.model || selectedModel || undefined` 作为 special 调用的 `model` 参数
|
|
||||||
|
|
||||||
### 5.6 全局模型选择器（右侧 sidebar 顶部）
|
|
||||||
|
|
||||||
- **位置**：右侧 sidebar `currentStep !== 3` 时显示的第一个面板 —— 在「当前意图摘要」**正上方**。Step 3 时整个 sidebar 切换成「最终共识结论 / 风险与预算摘要 / 导出与交付」，所以模型选择器仅在 Step 1 / Step 2 可见（此时也是唯一会发起新模型调用的阶段）
|
|
||||||
- **state**：`const [selectedModel, setSelectedModel] = useState<string>("")`
|
|
||||||
- **初始化**：`useEffect(() => ...)` 在 `availableModels` 首次返回后把 `selectedModel` 设为 `availableModels[0].name`；后端配置变化导致当前选中 model 不在列表里时也回退到首项
|
|
||||||
- **传参规则**：所有 5 个 API 调用点（`initIntent` / `streamIntent` / `streamRecommend` / `initMultiAgent` / `streamMultiAgent` leader / `streamMultiAgent` special）都传 `selectedModel || undefined`；special 还会先看 `agentConfigs[seat]?.model` per-seat 覆盖
|
|
||||||
- **禁用态**：`availableModels.length === 0` 或 `modelsLoading` → `disabled`，placeholder 显示「加载中…」或「未配置模型」
|
|
||||||
- **可改换为 Radix Select**：当前用原生 `<select>` 与 Persona 抽屉保持一致；如需统一样式可改为 `@/components/ui/select`，行为不变
|
|
||||||
|
|
||||||
### 5.7 草稿持久化（`api/drafts.ts` + 后端 MySQL，2026-06 改造）
|
|
||||||
|
|
||||||
> **重大变更**：草稿从浏览器 `localStorage` 迁到**后端 MySQL**，按登录用户隔离、跨设备/会话保留。旧 `utils/drafts.ts` 已删除；`useDraftPersistence` 仍保持对外接口不变（列表项含 `name`，由后端 `title` 映射而来），主页面无需改动。后端表/路由见 backend doc「圆桌草稿持久化」。
|
|
||||||
|
|
||||||
- **API 客户端 `api/drafts.ts`**：`listDrafts()`（轻量元数据）/ `getDraft(id)`（全量 step1+step2）/ `createDraft` / `updateDraft`（partial）/ `deleteDraft` / `deriveDraftName`。snake_case↔camelCase 映射在这一层收口（后端 `furthest_step/created_at/updated_at` ↔ 前端 `furthestStep/...`）。
|
|
||||||
- **快照形状**：`DraftStep1Snapshot.{intentThreadId, intentReady, interactiveMessages, timelineEntries}`、`DraftStep2Snapshot.{selectedAgents, threadIds, coordinatorName, step2RoundtableDialogues, lastLeaderContent, hasConsensus, consensusPercentage, budgetLimit, seatStubMessages, orchestrationMode?, chain?}`；以 JSON 整存进后端 `step1`/`step2`（`PortableLongText`/LONGTEXT，避免大对话超 64KB）。
|
|
||||||
- **`selectedAgents`（2026-06 修复）**：本次研讨实际选中的席位。**不存的话加载草稿后 Step 2/3 左侧「参与角色」会回退到 `DEFAULT_SELECTED_AGENTS`（默认 6 个）而非当时真正选的那几个** —— `roleTemplates`/`agentNameToRole` 都由 `selectedAgents` 派生。`useStep2Orchestration.hydrateFromDraft` 在该字段非空时 `setSelectedAgents`，老草稿（无此字段）保持当前值不强行覆盖。
|
|
||||||
- **`orchestrationMode?` / `chain?`（2026-06 业务链条）**：Step 2 编排模式（`recommend`=总控自由派活 / `chain`=按业务链条顺序派活）+ 来源链条 `{id,title}`。是**主页面 state**，由页面在 `getStep2Snapshot` 写入、在**包裹版 `hydrateStep2`** 里读出后 `setOrchestrationMode`/`setChainMeta`（step2 hook 的 `hydrateFromDraft` 不直接消费）。老草稿无字段 → 默认 `recommend`。业务链条完整设计见 `multi-agent-business-chain-dev.md`。
|
|
||||||
- `deriveDraftName({intentReady, interactiveMessages})`：优先 `intentReady.objective`，否则第一个 user 消息，否则 `未命名草稿 <时间>`，截断 40 字。**仅在 create 时写一次**（见下方 bug 修复）。
|
|
||||||
- **列表加载**：挂载时 `useEffect` 调 `listDrafts()`；增删改后 `refreshList()` 重拉。
|
|
||||||
- **自动保存策略**：仅在「前进」步骤切换时保存（1→2、2→3），后退不触发。
|
|
||||||
- **手动保存 / `ensureDraft`**：`handleManualSave` 走同一条保存队列；`ensureDraft(furthestStep?)` 幂等保证后端有一条对应草稿并返回 id（**推荐弹窗打开前调用**，让推荐历史有 `draft_id` 归属）。
|
|
||||||
- **加载草稿 `handleLoadDraft`**：
|
|
||||||
- 走 `getDraft(id)` **实时拉服务端最新全量**（不再读内存里可能过期的列表快照）；404 → toast「草稿已不存在」并刷新列表。
|
|
||||||
- **先**置 `loadedFromDraftRef.current = true`，再 `setCurrentStep(draft.furthestStep)`（顺序不能反）。
|
|
||||||
- `setStep2InitGate(draft.furthestStep >= 2)`：曾走到 Step 2 才跳过自动 init。
|
|
||||||
- 角色面板基线：被恢复时全部「在线」，否则 init 流程逐个「在线」。
|
|
||||||
|
|
||||||
**本次随手修复的 4 个旧 localStorage 版 bug**（对接后端时一并解决）：
|
|
||||||
|
|
||||||
1. **自动保存覆盖手动重命名** —— 现在所有 `updateDraft` 一律**不带 title**；标题只由 create（派生）与显式「重命名」改写。
|
|
||||||
2. **快速连续前进（1→2→3）产生重复草稿** —— 所有保存经一条**串行队列**（`saveQueueRef`）+ 同步镜像 `currentDraftIdRef`，create 完成即写 id，后续保存读到 id 走 update 而非再 create。
|
|
||||||
3. **加载读到内存旧列表快照** —— 改为 `getDraft(id)` 实时拉。
|
|
||||||
4. **localStorage 配额静默写失败 / 数据丢失** —— 迁后端后不复存在。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 6. 组件说明
|
|
||||||
|
|
||||||
### 6.1 `IntentClarificationCard`
|
|
||||||
|
|
||||||
- Props：`payload`（`ClarificationPayload`）、`selection`、`onSubmit(overrideSelection?)`、`disabled`、`submitting`、`fallbackContent`、**`deferSubmit?`（2026-06）**
|
|
||||||
- **单选**（默认 `allowMultiple === false`）：`resolveAllowMultiple` 返回 false → 点击选项即 `onSubmit({selectedIds:[id], custom: ""})`，UI 不显示「发送回答」按钮（除非 `allowCustom`）
|
|
||||||
- **多选**：勾选多个 + 输入补充，再点「发送回答」；答案格式见 `formatIntentClarificationAnswer`：
|
|
||||||
- 仅选项 → `我选择：A、B`
|
|
||||||
- 仅自定义 → 直接发自定义文本
|
|
||||||
- 同时存在 → `我选择：A、B；补充：…`
|
|
||||||
- **单问题 vs 多问题的判断（2026-06）**：`Step1Message` 按 `clarifications.length` 分流，**默认单选**（后端 `allow_multiple` 缺省 false，`resolveAllowMultiple` 兜底）：
|
|
||||||
- **单问题（最常见）**：`deferSubmit={false}`，沿用原交互 —— 单选**点击选项即发送**；多选 / 允许自定义则走卡片自带的「发送回答」按钮。**不**显示合并按钮。
|
|
||||||
- **多问题**：`deferSubmit={true}` —— 连单选点击也只**记录**选择（不立即发送），卡片自身隐藏按钮；父组件在卡片下方渲染**一个**「发送全部回答」按钮，统一提交。
|
|
||||||
- 该判断纯在前端（不动工具/后端）：依据 `clarifications.length` + `allow_multiple`，后端 `ask_clarification` 本就默认单选。
|
|
||||||
- **合并提交逻辑**：`submitIntentClarifications(msgId, clarifications, overrideByKey?)` 逐题取选择、格式化、拼成一条消息（多题带 `1. <问题>\n答:<答案>` 编号；单题直接发答案；至少答一题才发）。`overrideByKey` 供「单题单选点击即发送」用——此时选择还没写进 state map（setState 异步），把即时选择按 `clarificationKey` 传进去直接用。
|
|
||||||
- **逐题选择隔离**：选择 Map 改为 `Map<string, IntentClarificationSelection>`，key 由 `clarificationKey(msgId, clar.id, index)` 生成（`clar.id` = `tool_call_id`，缺省退化为 `idx-N`）。
|
|
||||||
- 展示条件：`isAgent && clarifications.length>0 && !intentReady && !parts.summary`；**流式期也展示**（卡片 `disabled`，只读，体现「协助过程」实时出现），仅当终态且 `pendingIntentClarificationMsgId === msg.id && !streaming` 时才可交互。出现 `[INTENT_READY]` / summary 后隐藏。
|
|
||||||
- **步骤链强化**：`onClarification` 同时往 `msg.steps` 追加一条 `追问 N:<问题>`，让 `MessageStepsCard` 把每个 `ask_clarification` 调用显示成独立步骤。
|
|
||||||
|
|
||||||
### 6.2 `RecommendAgentsDialog`
|
|
||||||
|
|
||||||
> **席位来源选择器（2026-06 业务链条）**：弹窗顶部加了**模式分段切换** `智能推荐 | 业务链条`。智能推荐 = 本节描述的现状（零行为变更，整体收进 `{mode==="recommend"}` 分支）；业务链条 = `BusinessChainPicker`（选一条已配置链条，卡片标题 + 彩色席位 tag + `→` 箭头）。`onConfirm` 统一回传 `SeatSelectionResult{ agents, mode, chain? }`；`mode==="chain"` 时 Step 2 由总控**按链条顺序派活**（`useStep2Orchestration.runChainOrchestration`）。配置页与编排详见 `multi-agent-business-chain-dev.md`。
|
|
||||||
|
|
||||||
- **新增 `draftId` prop（2026-06）**：本次推荐归属的草稿/会话 id。由主页面在打开弹窗前 `await drafts.ensureDraft(1)` 拿到并传入（见 §6.6）。`null` 时退化为「直接推荐、不存历史」的旧行为。
|
|
||||||
- 打开时管线（`start(forceFresh=false)`）：`listAgents() → filterRecommendCandidates()` → **若 `draftId` 有历史 → `listRecommendHistory()` 取最近一次直接展示（不重跑模型）**；否则 `streamRecommend()` 跑新推荐。
|
|
||||||
- 阶段 UI（`InternalState.phase`）：
|
|
||||||
- `idle` → `loading_agents` → **`loading_history`** → **`history`**（展示上次推荐，可直接进入研讨或「重新分析」）
|
|
||||||
- 或 `loading_agents` → `recommending`（顶部「模型生成内容」流式；推荐卡 streaming=true）→ `ready` / `fallback` / `error`
|
|
||||||
- **推荐历史（会话级）**：
|
|
||||||
- 打开时若该 `draftId` 有历史，进入 `history` 态：蓝色提示条标注上次推荐时间，picks 默认勾选、rationale 回显，**不**自动重跑模型。
|
|
||||||
- 「**重新分析**」按钮（`history` 态显示该文案，其它态为「重新推荐」）→ `start(true)` 强制跑新推荐，跳过历史。
|
|
||||||
- 每次**新推荐**完成（`ready`/`fallback`）后 `saveRecommendHistory(draftId, {objective,status,model,rationale,picks,candidates})` best-effort 追加一条（失败仅告警不阻断）。
|
|
||||||
- `history`/`fallback`/`ready` 三态都允许 `onConfirm`（用户可直接采纳历史 picks）。
|
|
||||||
- **布局分两段**：
|
|
||||||
- **顶部「模型生成内容」**：`RecommenderOutput` —— 状态行（`spinner + 调度推荐 / 已连接 / 正在生成`）+ `MessageStepsCard` 步骤卡 + `ReasoningBlock`（从 `<think>` 拆出来）+ markdown rationale + 末尾 `StreamingCursor`。视觉与 Step 1/Step 2 气泡的内容区一致，参考主聊天 `chats/new`。
|
|
||||||
- **底部「推荐参会智能体」**：候选卡片(`AgentCard`),分「推荐参会 / 其他候选」两组。
|
|
||||||
- 选择约束：`2 ≤ selected ≤ 8`；底部实时显示「至少再选 N 个」「已选 X / 8」
|
|
||||||
- 失败兜底：候选为空 → error；status==="asking" 或 picks 不足 2 → `fallback`，自动用 `FALLBACK_AGENT_IDS` 与候选池交集勾选
|
|
||||||
- 反竞态：内部 `generationRef`，每次 `start()` 自增，所有 setState（含历史读取/流式回调）都校验 `myGen === generationRef.current`，避免「重新分析」时旧 stream / 旧历史写脏 state
|
|
||||||
- `onConfirm(agentIds)` → 父组件 `handleConfirmAgents`：复位 `step2InitRef` 并 `setCurrentStep(2)`，触发 Step 2 init
|
|
||||||
|
|
||||||
### 6.3 `HighFidelityReport`（Step 3）
|
|
||||||
|
|
||||||
- 输入：`threadIds`、`coordinatorName`、`consensusText`、`hasConsensus`、`seatDeliveries`、`seatNameMap`、`onReset`
|
|
||||||
- `seatThreadEntries`：过滤掉 `coordinatorName`，给每个 sub-thread 拉一次 `listSessionArtifacts`（`Promise.all` 并行）
|
|
||||||
- `reloadKey`：「刷新文件清单」按钮自增，触发 effect 重新拉
|
|
||||||
- **文件预览策略**（`shouldPreviewInModal`）：
|
|
||||||
- 命中 → `ArtifactPreviewModal`（Markdown 用 react-markdown 渲染，其它当 plain text）
|
|
||||||
- 不命中（pdf / png / html / 二进制）→ `window.open(buildArtifactDownloadUrl)`，交给浏览器原生 viewer
|
|
||||||
- 命中规则：
|
|
||||||
- mimeType 是 `text/markdown` / `text/plain` / `text/csv` / `application/json` / `text/*`
|
|
||||||
- 或文件名后缀属于 `md / markdown / txt / json / csv / log / yml / yaml / xml`
|
|
||||||
- 各席位最终交付（中段折叠区）数据源：父组件传入的 `seatDeliveries`，按发送者去重（后到的覆盖前者）
|
|
||||||
- 「重新起草」→ 父组件 `handleStartNewTask`（清空并 `runStep1Init`）
|
|
||||||
- 「打印 / 另存 PDF」→ `window.print()`，浏览器原生流程
|
|
||||||
- **Step 3 不显示左侧栏（2026-06）**：`LeftSidebar` 在 `currentStep === 3` 时 `return null`（原「参与与结论贡献」列已移除），右侧栏在 Step !== 1 时本就 `return null`，因此中间 `middle-viewport`（`flex-1`）会自适应撑满整行，报告区获得最大宽度。
|
|
||||||
|
|
||||||
### 6.4 `ArtifactPreviewModal`
|
|
||||||
|
|
||||||
- 通过 `buildArtifactDownloadUrl(threadId, path)`（不带 `download=true`）GET 文件正文
|
|
||||||
- Markdown 文件（mime===`text/markdown` 或后缀 `.md/.markdown`）→ react-markdown + remark-gfm
|
|
||||||
- 其它文本类 → `<pre>` 直出
|
|
||||||
- 头部「下载」按钮单独走 `download=true` URL，触发浏览器附件下载
|
|
||||||
- 关闭：Esc / 点击外层遮罩（精确匹配 `e.target === e.currentTarget`，避免内部冒泡误关）
|
|
||||||
|
|
||||||
### 6.5 共享 UI 模式与辅助
|
|
||||||
|
|
||||||
- **三段式流式气泡**：`appendStreamingDialogue` → `appendToDialogue`（仅追加增量）→ `finalizeDialogue`（设最终 content + confidence + `streaming=false`）。三函数都通过 `id` 匹配，避免数组下标错位
|
|
||||||
- **Phase 到中文文案**：`phaseLabel(phase, agentType, toolName)`：
|
|
||||||
- `connecting` → 「调度中」
|
|
||||||
- `connected` → 「已连接,等待响应」
|
|
||||||
- `tool_calling` 按 toolName：`agent_orchestration → 正在派活`、`ask_clarification → 正在提问`、`present_files → 正在交付文件`，其它 → 「调用工具:<name>」
|
|
||||||
- `tool_result` → 「处理工具结果」
|
|
||||||
- `streaming` → leader 时「正在派活说明」、special 时「正在输出」
|
|
||||||
- Step 1 的 `intentPhaseLabel`：`ask_clarification → 正在生成追问`、`streaming → 正在思考问题`
|
|
||||||
- **Markdown 渲染**：Step 1 / 2 / 3 都用 `react-markdown` + `remark-gfm`，自定义紧凑间距的 `components`（`p` 用 `my-1 whitespace-pre-wrap` 等）
|
|
||||||
- **自动滚动**：`useAutoScroll(ref, [list])` 跟随；用户上滑后停止跟随；`ScrollToBottomButton` 一键回底
|
|
||||||
- **`activeSpeakerSet`**：圆桌可视化里多席位同时高亮需要 Set，单 leader 时仍可用 `activeSpeakerId`；两者均触发 ring 动画
|
|
||||||
- **状态条颜色**：`研讨中` 红 / `在线` 绿 / `已完成` 绿勾 / `正在上线` 黄旋 / 其它灰
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 7. 澄清交互（与主聊天对齐）
|
|
||||||
|
|
||||||
| 能力 | 实现位置 |
|
|
||||||
|------|----------|
|
|
||||||
| 结构化 payload 类型 | `multi-agent.ts` → `ClarificationPayload`（intent.ts 复用） |
|
|
||||||
| 单选/多选 | `lib/clarification.ts` → `resolveAllowMultiple`（缺省单选） |
|
|
||||||
| 答案拼接 | `formatIntentClarificationAnswer`（`IntentClarificationCard`） |
|
|
||||||
| Step 1 卡片 | `IntentClarificationCard` + `submitIntentClarification` |
|
|
||||||
| Step 2 卡片 | 页面底部 `pendingClarification` 区块 + `submitClarification` → 再 `runOrchestration` |
|
|
||||||
| 主聊天参考 | `src/components/workspace/messages/message-list.tsx` → `ClarificationCard` |
|
|
||||||
|
|
||||||
后端字段 `allow_multiple` 缺省为 **false**（单选、点击即发送）。
|
|
||||||
|
|
||||||
**关键差异**：
|
|
||||||
|
|
||||||
- Step 1 用 `IntentClarificationCard` 组件（嵌在气泡里），Step 2 直接在页面底部渲染 amber 色带（**没有**抽象成独立组件，紧贴对话区）。
|
|
||||||
- Step 2 澄清回复后**不**重建 thread；新 prompt 自带「用户已回复你刚才的澄清问题。问题:... 用户回答:...」上下文。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 8. 与主聊天的差异
|
|
||||||
|
|
||||||
| 维度 | 主聊天 `/page/workspace/chats/new` | 圆桌规划 |
|
|
||||||
|------|-----------------------------------|----------|
|
|
||||||
| SDK | `@langchain/langgraph-sdk` 直连 | 自研 SSE 解析（`apiFetch` + ReadableStream） |
|
|
||||||
| 澄清展示 | `message-list` ToolMessage `additional_kwargs` | 终态帧 `status: "clarification"` |
|
|
||||||
| Agent | 用户可选 assistant | 内置 intent + 动态 coordinator + 可选席位 |
|
|
||||||
| 线程 | 单 thread | Step 1 一线程；Step 2 每席位 + 协调各一线程 |
|
|
||||||
| 终态语义 | LangGraph state | 自定义 `{status, content, ...}` 终态帧 |
|
|
||||||
| 暂停 | LangGraph interrupt | `AbortController.abort()` |
|
|
||||||
|
|
||||||
复用思路：澄清卡片交互、答案文案格式；**不要**假设能直接复用 LangGraph React hooks。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 9. 关键交互清单
|
|
||||||
|
|
||||||
| 交互 | 行为 |
|
|
||||||
|------|------|
|
|
||||||
| Step 1 发送 | Enter 发送（Shift+Enter 换行）；发送中显示「暂停」 |
|
|
||||||
| Step 1 暂停 | `stopIntentStream()`，气泡尾部追加 `(已暂停)` 并 toast |
|
|
||||||
| Step 1 进入 Step 2 | 需 `intentReady`；打开推荐弹窗而非直接切步 |
|
|
||||||
| Step 1 跳过此项 | 仅本地追加「系统」气泡，不发请求；适合演示 |
|
|
||||||
| Step 2 init | 首次进入自动 SSE init；离开 Step 2 **不**销毁 `threadIds`（可返回继续看，不会二次 init） |
|
|
||||||
| Step 2 挂起/恢复 | `isRoundTableRunning` + `stopOrchestration` / 恢复时再 leader 一轮 |
|
|
||||||
| Step 2 干预 | 底部输入框 → `runOrchestration` 新 seed，wrap 进「用户人工干预新指令:...」 prompt |
|
|
||||||
| Step 2 Persona | 点圆桌头像打开抽屉；保存后下一轮该席位使用所选模型 |
|
|
||||||
| 新建任务 | `handleStartNewTask`：abort 全部、清 state、`runStep1Init`，与 Step 3「重新起草」共用 |
|
|
||||||
| 历史草稿 | 顶栏下拉：加载 / 重命名 / 删除（删除带 `window.confirm`） |
|
|
||||||
| Step 3 预览 | 文本类 → 模态预览；其它 → 新窗口下载 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 10. 类型与常量速查
|
|
||||||
|
|
||||||
```ts
|
|
||||||
// Step 1 输出 → Step 2 输入
|
|
||||||
interface IntentSummary {
|
|
||||||
objective: string;
|
|
||||||
constraints: string[];
|
|
||||||
assumptions?: string[];
|
|
||||||
}
|
|
||||||
|
|
||||||
// Step 2 线程映射（init_done.thread_ids）
|
|
||||||
type ThreadIdMap = Record<string, string>;
|
|
||||||
|
|
||||||
// 派活
|
|
||||||
type LeaderDispatch = [string, string]; // [agent_name, task]
|
|
||||||
|
|
||||||
// 当前选中的研讨席位
|
|
||||||
type SelectedAgent = { agent_id: string; name: string };
|
|
||||||
|
|
||||||
// Step 1 单条澄清问题
|
|
||||||
interface ClarificationPayload {
|
|
||||||
question: string;
|
|
||||||
clarificationType: string;
|
|
||||||
context: string;
|
|
||||||
options: unknown[];
|
|
||||||
allowCustom: boolean;
|
|
||||||
allowMultiple?: boolean;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Step 2 stream 终态
|
|
||||||
interface StreamMultiAgentResult {
|
|
||||||
dispatched: LeaderDispatch[];
|
|
||||||
message: string | null;
|
|
||||||
content: string;
|
|
||||||
agentName: string | null;
|
|
||||||
clarification: ClarificationPayload | null;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**核心常量**：
|
|
||||||
|
|
||||||
| 常量 | 值 | 位置 |
|
|
||||||
|------|----|------|
|
|
||||||
| `COMMANDER_SEAT_ID` | `1` | RoundtablePlanningPage |
|
|
||||||
| `MAX_CYCLES` | `8` | RoundtablePlanningPage（`runOrchestration` 内） |
|
|
||||||
| `MIN_SELECTED` / `MAX_SELECTED` | `2` / `8` | RecommendAgentsDialog |
|
|
||||||
| `FALLBACK_AGENT_IDS` | 6 内置 roundtable-* | RecommendAgentsDialog |
|
|
||||||
| `BUILTIN_AGENT_META` | 6 内置头像/中文名 | RoundtablePlanningPage |
|
|
||||||
| `FALLBACK_AVATAR_TYPES` | `[blue, purple, emerald, amber, pink]` | RoundtablePlanningPage |
|
|
||||||
| ~~`STORAGE_KEY`~~ | 已废弃 —— 草稿改存后端 `/api/roundtable-drafts`，不再用 localStorage | （旧 utils/drafts.ts，已删除） |
|
|
||||||
| `INTENT_READY_RE` | `/\[INTENT_READY\]\s*```json\s*(\{[\s\S]*?\})\s*```/` | RoundtablePlanningPage |
|
|
||||||
| `RECOMMEND_READY_MARKER` | `"[RECOMMEND_READY]"` | recommend.ts |
|
|
||||||
| `EXCLUDED_AGENT_IDS` / 前缀 | `roundtable-intent`、`roundtable-recommender`、`roundtable-coordinator-*` | recommend.ts |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 11. 故障排查
|
|
||||||
|
|
||||||
| 现象 | 可能原因 | 排查 |
|
|
||||||
|------|----------|------|
|
|
||||||
| Step 1 一直「等待澄清」但气泡里出现绿色 [INTENT_READY] 摘要 | 终态帧未带 `summary` | 看 `splitIntentReadyBlock` + 同步 `useEffect`，必要时手动刷新 |
|
|
||||||
| Step 1 角色面板卡在「正在上线」 | StrictMode 双 mount 导致 init 异步被丢弃 | 已用 `step1InitGenRef` 修复；检查是否被改坏 |
|
|
||||||
| 选项全是多选 | `allow_multiple` 未传或为 true | Network 终态帧；`resolveAllowMultiple` |
|
|
||||||
| Step 2 init 卡住 | init SSE error / 代理 | Network `init`；控制台 `[init-timing]` |
|
|
||||||
| Step 2 stream 看不到任何文字 | TitleMiddleware 过滤错杀 / phase 卡在 connecting | 控制台搜 `[stream:` 前缀（需 `__MULTI_AGENT_DEBUG__`） |
|
|
||||||
| 总控不派活 | `dispatched` 一直 `[]` 且非 clarification | 看 leader 终态帧；模型 SOUL 配置 |
|
|
||||||
| 推荐弹窗为空 | `filterRecommendCandidates` 把所有候选都过滤了 | `GET /api/agents` 列表；检查 `EXCLUDED_AGENT_IDS` |
|
|
||||||
| 推荐弹窗一直「等待推荐结果」 | recommender 模型死循环 | 控制台看 `[stream:` 日志，或点「重新推荐」 |
|
|
||||||
| Step 3 各席位文件为空 | 子 agent 未写 outputs 或 thread id 错 | 对应 thread 调 `listSessionArtifacts` |
|
|
||||||
| Step 3 预览空白 | 文件不是文本类，但被错误命中 `shouldPreviewInModal` | 检查 mime + 后缀；不在白名单的应该跳 `window.open` |
|
|
||||||
| Step 3 文件名乱码 / 404 | `buildArtifactDownloadUrl` 编码错 | 看 path 是否被分段 encode；不能整体 encode（会把 `/` 也编了） |
|
|
||||||
| 草稿加载后重复 init | `loadedFromDraftRef` 未置位 | `handleLoadDraft` 流程，注意 ref 必须先于 `setCurrentStep` |
|
|
||||||
| 顶栏 Step 2 / Step 3 一直灰 | `intentReady` / `hasConsensus` 没设上 | 看终态帧；leader.dispatched 是否真为 `[]` |
|
|
||||||
| Persona 抽屉改模型不生效 | 下一轮才生效 / 抽屉 model 未传给 streamMultiAgent | 看 `agentConfigs[meta.speakerId]?.model` 的传递路径 |
|
|
||||||
| 并行 SSE 卡顿 | 误改为 parallel 派活 | 保持顺序 dispatch，详见 §5.4 注释 |
|
|
||||||
|
|
||||||
**本地调试开关**：
|
|
||||||
|
|
||||||
```js
|
|
||||||
window.__MULTI_AGENT_INIT_TIMING__ = true; // init 各阶段耗时（默认开）
|
|
||||||
window.__MULTI_AGENT_DEBUG__ = true; // stream 帧计数（默认开）
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 12. 扩展指南
|
|
||||||
|
|
||||||
### 12.1 新增默认研讨席位
|
|
||||||
|
|
||||||
1. 后端 `.deer-flow/agents/roundtable-xxx/`
|
|
||||||
2. `BUILTIN_AGENT_META` + `DEFAULT_SELECTED_AGENTS` + `RecommendAgentsDialog` 的 `FALLBACK_AGENT_IDS`
|
|
||||||
3. 无需改 API 层（`agent_names` 由推荐结果传入）
|
|
||||||
|
|
||||||
### 12.2 调整 Step 1 澄清轮次上限
|
|
||||||
|
|
||||||
逻辑在 agent SOUL，不在前端；前端只需处理任意轮 `asking` / `clarification` / `done`。
|
|
||||||
|
|
||||||
### 12.3 调整 Step 2 编排上限
|
|
||||||
|
|
||||||
`RoundtablePlanningPage.tsx` 内 `MAX_CYCLES = 8`，超出会 toast「⏱️ 已达到最大研讨轮次,自动停止以避免循环」。若放宽：注意 `step2RoundtableDialogues` 数组会线性增长，超长讨论需要考虑虚拟滚动。
|
|
||||||
|
|
||||||
### 12.4 把 special 改回并行
|
|
||||||
|
|
||||||
不推荐；若一定要做：
|
|
||||||
|
|
||||||
- 把 `for ... of leaderRes.dispatched` 改成 `await Promise.all(leaderRes.dispatched.map(...))`
|
|
||||||
- 评估浏览器性能：每 token 一次 `setStep2RoundtableDialogues(prev => prev.map(...))`，N=6 时实测明显掉帧
|
|
||||||
- 用更高效的派发结构（如按 id 分桶 `Map<id, Bubble>` + ref 缓存）改善之后再启用
|
|
||||||
|
|
||||||
### 12.5 接入真实 Persona 覆盖
|
|
||||||
|
|
||||||
当前 prompt / temp 只在前端记录；要落地需：
|
|
||||||
|
|
||||||
- 后端开放 per-agent override 接口或在 `streamMultiAgent` 新增 `prompt_override` / `temperature` 字段
|
|
||||||
- 前端：`agentConfigs[meta.speakerId]` 一并传入
|
|
||||||
|
|
||||||
### 12.6 拆分页面（已完成 · 2026-05）
|
|
||||||
|
|
||||||
主页面早期是 4 000+ 行单文件,2026-05 重构按"hooks 抽逻辑、components 抽 UI"原则拆分:
|
|
||||||
|
|
||||||
- `hooks/useStep1Intent.ts` —— Step 1 全部状态机、init effect、INTENT_READY 同步
|
|
||||||
- `hooks/useStep2Orchestration.ts` —— Step 2 状态、编排循环、对话流、Persona、澄清
|
|
||||||
- `hooks/useDraftPersistence.ts` —— 草稿自动保存 / 手动保存 / 加载 / 重命名 / 删除
|
|
||||||
- `components/Step{1,2,3}Panel.tsx` —— 纯 UI,只接收 props,不持有业务状态
|
|
||||||
- `components/PersonaDrawer.tsx` —— Persona 抽屉
|
|
||||||
- `components/Avatars.tsx` —— 所有 SVG 头像 + getAvatar
|
|
||||||
- `lib/roundtable-constants.ts` —— 常量、类型、纯工具函数(buildRoleTemplates 等)
|
|
||||||
- `lib/step-display.tsx` —— ChainOfThought 折叠卡的图标 + 文案 + 子节点渲染
|
|
||||||
|
|
||||||
**主页面只保留**:顶栏(StepNavigation / HistoryDropdown)、左右两侧栏(LeftSidebar / RightSidebar)、步骤路由、推荐弹窗,以及编排 hook 与跨步 handler(`handleConfirmAgents` / `handleStartNewTask`)。
|
|
||||||
|
|
||||||
继续重构请遵守:
|
|
||||||
|
|
||||||
1. **不要在 Panel 组件里写 fetch / setState 业务流程** —— Panel 只渲染,事件透传到 hook。
|
|
||||||
2. **hook 之间不要互相 import** —— 跨 hook 的数据通过主页面的 ref / callback 桥接(参考 `buildInitialIntent` 与 `loadedFromDraftRef` 的实现)。
|
|
||||||
3. **草稿 snapshot 形状**(Step 1 的 `Step1Snapshot` / Step 2 的 `Step2Snapshot`)与 `api/drafts.ts` 的 `DraftStep{1,2}Snapshot` 是同一份语义,改字段时两边都要改;后端以 JSON 整存,不强约束嵌套字段。
|
|
||||||
4. **lint/typecheck**:重构后 `pnpm typecheck` 与 `pnpm build` 必须保持 0 个新增错误(预存量错误来自其它无关模块如 `strategy-components` / `next/link` shim,与本特性无关)。
|
|
||||||
|
|
||||||
### 12.7 文档协同
|
|
||||||
|
|
||||||
`@/roundtable-planning/` 内一切公共 API 都应当：
|
|
||||||
|
|
||||||
1. 在 `api/*.ts` 文件级注释里说明 endpoint
|
|
||||||
2. 在本页第 4 节 / 第 10 节同步对照
|
|
||||||
3. 后端字段变化（如 `init_done` 字段名）需要同步改 `initMultiAgent` 解析逻辑 + `multi-agent-api.md`
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 13. 路径速查
|
|
||||||
|
|
||||||
| 资源 | 路径 |
|
|
||||||
|------|------|
|
|
||||||
| 主页面（组合 + 顶栏 + 侧栏） | `frontend-web/src/roundtable-planning/pages/RoundtablePlanningPage.tsx` |
|
|
||||||
| Step 1 hook | `frontend-web/src/roundtable-planning/hooks/useStep1Intent.ts` |
|
|
||||||
| Step 2 hook(含编排循环) | `frontend-web/src/roundtable-planning/hooks/useStep2Orchestration.ts` |
|
|
||||||
| 草稿 hook | `frontend-web/src/roundtable-planning/hooks/useDraftPersistence.ts` |
|
|
||||||
| Step 1 面板 | `frontend-web/src/roundtable-planning/components/Step1Panel.tsx` |
|
|
||||||
| Step 2 面板 | `frontend-web/src/roundtable-planning/components/Step2Panel.tsx` |
|
|
||||||
| Step 3 面板 | `frontend-web/src/roundtable-planning/components/Step3Panel.tsx` |
|
|
||||||
| 消息气泡共享件 | `frontend-web/src/roundtable-planning/components/MessageBubble.tsx` |
|
|
||||||
| 步骤折叠卡(工具/思考) | `frontend-web/src/roundtable-planning/components/MessageStepsCard.tsx` |
|
|
||||||
| `<think>` 提取工具 | `frontend-web/src/roundtable-planning/lib/reasoning.ts` |
|
|
||||||
| Persona 抽屉 | `frontend-web/src/roundtable-planning/components/PersonaDrawer.tsx` |
|
|
||||||
| 头像集合 | `frontend-web/src/roundtable-planning/components/Avatars.tsx` |
|
|
||||||
| 常量/工具函数 | `frontend-web/src/roundtable-planning/lib/roundtable-constants.ts` |
|
|
||||||
| ChainOfThought 渲染 | `frontend-web/src/roundtable-planning/lib/step-display.tsx` |
|
|
||||||
| Step 1 API | `frontend-web/src/roundtable-planning/api/intent.ts` |
|
|
||||||
| 推荐 API（含推荐历史） | `frontend-web/src/roundtable-planning/api/recommend.ts` |
|
|
||||||
| 草稿 API（后端 CRUD） | `frontend-web/src/roundtable-planning/api/drafts.ts` |
|
|
||||||
| Step 2/3 API | `frontend-web/src/roundtable-planning/api/multi-agent.ts` |
|
|
||||||
| 澄清卡片 | `frontend-web/src/roundtable-planning/components/IntentClarificationCard.tsx` |
|
|
||||||
| 推荐弹窗 | `frontend-web/src/roundtable-planning/components/RecommendAgentsDialog.tsx` |
|
|
||||||
| Step 3 报告 | `frontend-web/src/roundtable-planning/components/HighFidelityReport.tsx` |
|
|
||||||
| 文件预览 | `frontend-web/src/roundtable-planning/components/ArtifactPreviewModal.tsx` |
|
|
||||||
| 回底按钮 | `frontend-web/src/roundtable-planning/components/ScrollToBottomButton.tsx` |
|
|
||||||
| 滚动跟随 | `frontend-web/src/roundtable-planning/hooks/useAutoScroll.ts` |
|
|
||||||
| 澄清单选逻辑 | `frontend-web/src/roundtable-planning/lib/clarification.ts` |
|
|
||||||
| 后端草稿/历史路由 | `offline-backend-20260512/backend/app/gateway/routers/roundtable_drafts.py` |
|
|
||||||
| 路由 | `frontend-web/src/pages/WorkspaceRoutes.tsx` |
|
|
||||||
| 样式 | `frontend-web/src/roundtable-planning/styles/roundtable-planning.css` |
|
|
||||||
| 主聊天澄清参考 | `frontend-web/src/components/workspace/messages/message-list.tsx` |
|
|
||||||
| 后端开发文档 | `frontend-web/docs/multi-agent-backend-dev.md` |
|
|
||||||
| API 速查 | `frontend-web/docs/multi-agent-api.md` |
|
|
||||||
@@ -1,404 +0,0 @@
|
|||||||
# 多智能体会商 Step2 多结果线方案
|
|
||||||
|
|
||||||
## 背景
|
|
||||||
|
|
||||||
当前「多智能体会商 / 多智能体规划」里，一个历史草稿只保存一份 `step2` 快照。用户从历史记录加载草稿后，如果再次点击「智能体推荐」并在弹窗里点击「进入研讨」，新的 Step2 研讨会继续写入同一份 `draft.step2`，结果是第一次生成内容会被第二次生成内容覆盖，或者页面只能展示最新一次结果。
|
|
||||||
|
|
||||||
产品期望是：
|
|
||||||
|
|
||||||
- 用户从历史记录进入已有草稿时，进入第二步后，左下角能看到第一次生成结果。
|
|
||||||
- 用户再次点击「智能体推荐」并点击「进入研讨」时，要开启一条新的研讨结果线。
|
|
||||||
- 第二次生成结果显示在左下角，但不能影响第一次生成结果。
|
|
||||||
- 用户之后再次查看同一个历史草稿时，可以分别查看第一次生成结果和第二次生成结果。
|
|
||||||
|
|
||||||
因此，这个需求的核心不是简单增加一个展示区域，而是把 Step2 从「单结果」升级为「一个草稿下多条研讨 run」。
|
|
||||||
|
|
||||||
## 现状
|
|
||||||
|
|
||||||
相关位置：
|
|
||||||
|
|
||||||
- `src/roundtable-planning/api/drafts.ts`
|
|
||||||
- `src/roundtable-planning/pages/RoundtablePlanningPage.tsx`
|
|
||||||
- `src/roundtable-planning/hooks/useStep2Orchestration.ts`
|
|
||||||
- `src/roundtable-planning/components/Step2Panel.tsx`
|
|
||||||
- `src/roundtable-planning/components/RecommendAgentsDialog.tsx`
|
|
||||||
|
|
||||||
当前 `DraftStep2Snapshot` 结构大致是：
|
|
||||||
|
|
||||||
```ts
|
|
||||||
export interface DraftStep2Snapshot {
|
|
||||||
selectedAgents?: Array<{ agent_id: string; name: string }>;
|
|
||||||
threadIds: ThreadIdMap | null;
|
|
||||||
coordinatorName: string | null;
|
|
||||||
step2RoundtableDialogues: unknown[];
|
|
||||||
lastLeaderContent: string;
|
|
||||||
hasConsensus: boolean;
|
|
||||||
consensusPercentage: number;
|
|
||||||
budgetLimit: number;
|
|
||||||
seatStubMessages?: Record<string, unknown[]>;
|
|
||||||
orchestrationMode?: "recommend" | "chain";
|
|
||||||
chain?: { id: string; title: string } | null;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
这意味着一个草稿只有一份：
|
|
||||||
|
|
||||||
- 参会智能体
|
|
||||||
- 多智能体 thread 映射
|
|
||||||
- 研讨气泡
|
|
||||||
- 总控最终内容
|
|
||||||
- 共识状态
|
|
||||||
- 沙箱产物 stub
|
|
||||||
- 编排模式和业务链条
|
|
||||||
|
|
||||||
当前 `RoundtablePlanningPage.tsx` 里的 `handleConfirmAgents` 在用户点击「进入研讨」后会：
|
|
||||||
|
|
||||||
1. 规范化选中的 agents。
|
|
||||||
2. 写入 `step2.selectedAgents`。
|
|
||||||
3. 调用 `step2.resetInitGate()`。
|
|
||||||
4. 设置 `orchestrationMode` / `chainMeta`。
|
|
||||||
5. 切到 `currentStep = 2`。
|
|
||||||
|
|
||||||
它没有先把当前 Step2 结果归档成「第一次生成结果」，也没有为新的研讨创建独立 run。因此第二次研讨天然会复用同一个 `draft.step2` 写入位置。
|
|
||||||
|
|
||||||
## 目标模型
|
|
||||||
|
|
||||||
建议引入 Step2 run 概念：一个草稿可以有多条 Step2 结果线，每条结果线保存一份完整的 Step2 快照。
|
|
||||||
|
|
||||||
```ts
|
|
||||||
interface Step2RunSnapshot {
|
|
||||||
id: string;
|
|
||||||
title: string;
|
|
||||||
createdAt: string;
|
|
||||||
source: "initial" | "recommend" | "chain" | "manual";
|
|
||||||
selectedAgents?: Array<{ agent_id: string; name: string }>;
|
|
||||||
threadIds: ThreadIdMap | null;
|
|
||||||
coordinatorName: string | null;
|
|
||||||
step2RoundtableDialogues: unknown[];
|
|
||||||
lastLeaderContent: string;
|
|
||||||
hasConsensus: boolean;
|
|
||||||
consensusPercentage: number;
|
|
||||||
budgetLimit: number;
|
|
||||||
seatStubMessages?: Record<string, unknown[]>;
|
|
||||||
orchestrationMode?: "recommend" | "chain";
|
|
||||||
chain?: { id: string; title: string } | null;
|
|
||||||
step3?: DraftStep3Snapshot | null;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
`DraftStep2Snapshot` 保留现有字段作为当前激活 run 的镜像，同时新增 `runs` 和 `activeRunId`：
|
|
||||||
|
|
||||||
```ts
|
|
||||||
export interface DraftStep2Snapshot {
|
|
||||||
activeRunId?: string;
|
|
||||||
runs?: Step2RunSnapshot[];
|
|
||||||
|
|
||||||
selectedAgents?: Array<{ agent_id: string; name: string }>;
|
|
||||||
threadIds: ThreadIdMap | null;
|
|
||||||
coordinatorName: string | null;
|
|
||||||
step2RoundtableDialogues: unknown[];
|
|
||||||
lastLeaderContent: string;
|
|
||||||
hasConsensus: boolean;
|
|
||||||
consensusPercentage: number;
|
|
||||||
budgetLimit: number;
|
|
||||||
seatStubMessages?: Record<string, unknown[]>;
|
|
||||||
orchestrationMode?: "recommend" | "chain";
|
|
||||||
chain?: { id: string; title: string } | null;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
这样做的好处：
|
|
||||||
|
|
||||||
- 老代码仍然可以从 `draft.step2.step2RoundtableDialogues` 读取当前结果。
|
|
||||||
- 新 UI 可以从 `draft.step2.runs` 展示第一次、第二次、第三次生成结果。
|
|
||||||
- 老草稿没有 `runs` 时，可以在 hydrate 时把原来的 `step2` 包装成一条默认 run。
|
|
||||||
- 暂时不需要改数据库表结构，因为 `step2` 本身就是 JSON 快照。
|
|
||||||
|
|
||||||
## 行为设计
|
|
||||||
|
|
||||||
### 1. 历史记录加载
|
|
||||||
|
|
||||||
用户点击历史记录加载草稿时：
|
|
||||||
|
|
||||||
1. 拉取完整草稿。
|
|
||||||
2. 如果 `draft.step2.runs` 存在，使用 `activeRunId` 找到当前结果线。
|
|
||||||
3. 如果 `draft.step2.runs` 不存在，但旧字段里有 `step2RoundtableDialogues`，自动包装成一条 run：
|
|
||||||
|
|
||||||
```ts
|
|
||||||
{
|
|
||||||
id: "legacy-run",
|
|
||||||
title: "第一次生成结果",
|
|
||||||
createdAt: draft.updatedAt,
|
|
||||||
source: "initial",
|
|
||||||
...draft.step2
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
4. hydrate 当前 active run 到 Step2 runtime。
|
|
||||||
5. 左下角展示 run 列表。
|
|
||||||
|
|
||||||
### 2. 再次点击智能体推荐进入研讨
|
|
||||||
|
|
||||||
用户在已有历史草稿中再次点击「智能体推荐」并确认进入研讨时：
|
|
||||||
|
|
||||||
1. 先把当前页面里的 Step2 状态保存为当前 active run。
|
|
||||||
2. 创建一条新的 run：
|
|
||||||
|
|
||||||
```ts
|
|
||||||
{
|
|
||||||
id: crypto.randomUUID(),
|
|
||||||
title: `第 ${runs.length + 1} 次生成结果`,
|
|
||||||
createdAt: new Date().toISOString(),
|
|
||||||
source: result.mode,
|
|
||||||
selectedAgents: normalizedAgents,
|
|
||||||
threadIds: null,
|
|
||||||
coordinatorName: null,
|
|
||||||
step2RoundtableDialogues: [],
|
|
||||||
lastLeaderContent: "",
|
|
||||||
hasConsensus: false,
|
|
||||||
consensusPercentage: 0,
|
|
||||||
budgetLimit: DEFAULT_BUDGET,
|
|
||||||
seatStubMessages: {},
|
|
||||||
orchestrationMode: result.mode,
|
|
||||||
chain: result.mode === "chain" ? result.chain ?? null : null
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
3. 将 `activeRunId` 切到新 run。
|
|
||||||
4. 清空 Step2 runtime。
|
|
||||||
5. 设置新选中的 agents / mode / chain。
|
|
||||||
6. `resetInitGate()`，进入 Step2 后重新创建一组独立 thread。
|
|
||||||
7. 自动保存草稿。
|
|
||||||
|
|
||||||
关键点：第二次 run 必须使用新的 `threadIds`，不能沿用第一次 run 的 `threadIds`，否则后端 thread 历史会混在一起。
|
|
||||||
|
|
||||||
### 3. 左下角结果列表
|
|
||||||
|
|
||||||
左下角建议展示一个「生成结果」区域：
|
|
||||||
|
|
||||||
- 第一次生成结果
|
|
||||||
- 第二次生成结果
|
|
||||||
- 第三次生成结果
|
|
||||||
|
|
||||||
每条展示：
|
|
||||||
|
|
||||||
- 标题
|
|
||||||
- 创建时间
|
|
||||||
- 状态：研讨中 / 已达成共识 / 未完成 / 已生成报告
|
|
||||||
- 使用模式：智能体推荐 / 业务链条
|
|
||||||
|
|
||||||
点击某条结果时：
|
|
||||||
|
|
||||||
1. 保存当前 active run。
|
|
||||||
2. 切换 `activeRunId`。
|
|
||||||
3. hydrate 被点击的 run。
|
|
||||||
4. 中间 Step2 对话区显示该 run 的研讨气泡。
|
|
||||||
5. 如果该 run 已有 `step3`，进入 Step3 时展示对应报告。
|
|
||||||
|
|
||||||
### 4. Step3 结果归属
|
|
||||||
|
|
||||||
目前 `draft.step3` 是草稿级别的一份报告。如果只保留这一份，第二次结果生成报告后仍会覆盖第一次报告。
|
|
||||||
|
|
||||||
建议：
|
|
||||||
|
|
||||||
- `draft.step3` 继续作为当前 active run 的镜像，兼容现有 Step3 页面。
|
|
||||||
- 每条 `Step2RunSnapshot.step3` 保存自己的报告。
|
|
||||||
- `onReportSaved` 时同时写入当前 active run 的 `step3`。
|
|
||||||
|
|
||||||
这样用户切换到第一次生成结果时，可以看到第一次的 Step3 报告；切换到第二次生成结果时，可以看到第二次的 Step3 报告。
|
|
||||||
|
|
||||||
## 建议改动点
|
|
||||||
|
|
||||||
### 1. `api/drafts.ts`
|
|
||||||
|
|
||||||
扩展类型：
|
|
||||||
|
|
||||||
- 新增 `Step2RunSnapshot`。
|
|
||||||
- `DraftStep2Snapshot` 增加 `activeRunId?: string` 和 `runs?: Step2RunSnapshot[]`。
|
|
||||||
|
|
||||||
同时保留旧字段，避免影响现有保存、加载和 Step3。
|
|
||||||
|
|
||||||
### 2. `useStep2Orchestration.ts`
|
|
||||||
|
|
||||||
新增或暴露两个能力：
|
|
||||||
|
|
||||||
- `getCurrentRunSnapshot()`：从当前 Step2 runtime 生成一条 run 快照。
|
|
||||||
- `hydrateRunSnapshot(run)`：把某条 run 恢复到 Step2 runtime。
|
|
||||||
|
|
||||||
`hydrateFromDraft` 继续存在，但内部可以优先选择 active run 来 hydrate。
|
|
||||||
|
|
||||||
### 3. `RoundtablePlanningPage.tsx`
|
|
||||||
|
|
||||||
新增页面级状态：
|
|
||||||
|
|
||||||
```ts
|
|
||||||
const [step2Runs, setStep2Runs] = useState<Step2RunSnapshot[]>([]);
|
|
||||||
const [activeStep2RunId, setActiveStep2RunId] = useState<string | null>(null);
|
|
||||||
```
|
|
||||||
|
|
||||||
调整几个流程：
|
|
||||||
|
|
||||||
- `getStep2Snapshot` 输出 `runs` 和 `activeRunId`。
|
|
||||||
- `hydrateStep2` 兼容旧草稿并恢复 runs。
|
|
||||||
- `handleConfirmAgents` 在新建研讨前先归档当前 active run，再创建新 run。
|
|
||||||
- `onReportSaved` 把 Step3 报告写回当前 active run。
|
|
||||||
|
|
||||||
### 4. `Step2Panel.tsx`
|
|
||||||
|
|
||||||
新增左下角结果列表展示。建议作为一个独立组件，避免 Step2Panel 继续变大：
|
|
||||||
|
|
||||||
```tsx
|
|
||||||
<Step2RunSwitcher
|
|
||||||
runs={step2Runs}
|
|
||||||
activeRunId={activeStep2RunId}
|
|
||||||
onSelect={handleSelectStep2Run}
|
|
||||||
/>
|
|
||||||
```
|
|
||||||
|
|
||||||
组件职责只做展示和选择，不直接读写 draft。
|
|
||||||
|
|
||||||
### 5. `Step3Panel.tsx`
|
|
||||||
|
|
||||||
传入当前 active run 的报告：
|
|
||||||
|
|
||||||
- 如果当前 run 有 `step3`，展示它。
|
|
||||||
- 如果没有，按现有逻辑生成新报告。
|
|
||||||
- 生成完成后通过 `onReportSaved` 写回 run。
|
|
||||||
|
|
||||||
## 兼容策略
|
|
||||||
|
|
||||||
老草稿没有 `runs` 字段时，不做数据迁移，前端加载时即时包装。
|
|
||||||
|
|
||||||
判断规则：
|
|
||||||
|
|
||||||
```ts
|
|
||||||
function normalizeStep2Runs(step2: DraftStep2Snapshot): {
|
|
||||||
runs: Step2RunSnapshot[];
|
|
||||||
activeRunId: string | null;
|
|
||||||
} {
|
|
||||||
if (step2.runs?.length) {
|
|
||||||
return {
|
|
||||||
runs: step2.runs,
|
|
||||||
activeRunId: step2.activeRunId ?? step2.runs[0].id,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
const hasLegacyContent =
|
|
||||||
step2.step2RoundtableDialogues?.length > 0 ||
|
|
||||||
Boolean(step2.threadIds) ||
|
|
||||||
Boolean(step2.lastLeaderContent);
|
|
||||||
|
|
||||||
if (!hasLegacyContent) {
|
|
||||||
return { runs: [], activeRunId: null };
|
|
||||||
}
|
|
||||||
|
|
||||||
const legacyRun: Step2RunSnapshot = {
|
|
||||||
id: "legacy-run",
|
|
||||||
title: "第一次生成结果",
|
|
||||||
createdAt: new Date().toISOString(),
|
|
||||||
source: step2.orchestrationMode ?? "initial",
|
|
||||||
selectedAgents: step2.selectedAgents,
|
|
||||||
threadIds: step2.threadIds,
|
|
||||||
coordinatorName: step2.coordinatorName,
|
|
||||||
step2RoundtableDialogues: step2.step2RoundtableDialogues,
|
|
||||||
lastLeaderContent: step2.lastLeaderContent,
|
|
||||||
hasConsensus: step2.hasConsensus,
|
|
||||||
consensusPercentage: step2.consensusPercentage,
|
|
||||||
budgetLimit: step2.budgetLimit,
|
|
||||||
seatStubMessages: step2.seatStubMessages,
|
|
||||||
orchestrationMode: step2.orchestrationMode,
|
|
||||||
chain: step2.chain,
|
|
||||||
};
|
|
||||||
|
|
||||||
return { runs: [legacyRun], activeRunId: legacyRun.id };
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
## 风险点
|
|
||||||
|
|
||||||
### 1. 自动保存覆盖
|
|
||||||
|
|
||||||
Step2 现在会在每个气泡收尾时自动保存。如果引入多 run，自动保存必须先把当前 runtime 合并回 active run，再写入 `draft.step2.runs`。
|
|
||||||
|
|
||||||
否则会出现 UI 切到第二次结果，但保存时仍更新第一次 run 的情况。
|
|
||||||
|
|
||||||
### 2. threadIds 混用
|
|
||||||
|
|
||||||
每条 run 必须拥有自己的 `threadIds`。新建 run 时要清空 `threadIds` 并让 Step2 重新 init。
|
|
||||||
|
|
||||||
如果复用旧 thread，会导致两次研讨的后端上下文互相污染。
|
|
||||||
|
|
||||||
### 3. Step3 报告覆盖
|
|
||||||
|
|
||||||
如果只保存草稿级 `step3`，多 run 的报告无法分别查看。
|
|
||||||
|
|
||||||
建议把报告写入当前 run，同时保留草稿级 `step3` 作为 active run 镜像。
|
|
||||||
|
|
||||||
### 4. 正在运行中的 run
|
|
||||||
|
|
||||||
如果配合后台任务能力，run 还需要带 job 信息：
|
|
||||||
|
|
||||||
```ts
|
|
||||||
jobId?: string | null;
|
|
||||||
jobStatus?: JobStatus | null;
|
|
||||||
```
|
|
||||||
|
|
||||||
这样左下角可以显示「第二次生成结果正在运行」，并打开派活链路弹窗。
|
|
||||||
|
|
||||||
## 分阶段实现建议
|
|
||||||
|
|
||||||
### P0：纯前端多 run 快照
|
|
||||||
|
|
||||||
目标：先解决“第一次 / 第二次结果分别可查看”。
|
|
||||||
|
|
||||||
- 扩展 `DraftStep2Snapshot` 类型。
|
|
||||||
- 页面维护 `step2Runs` / `activeStep2RunId`。
|
|
||||||
- `handleConfirmAgents` 新建 run。
|
|
||||||
- 左下角展示 run 列表。
|
|
||||||
- 切换 run 能恢复不同 Step2 对话。
|
|
||||||
|
|
||||||
不改后端表结构。
|
|
||||||
|
|
||||||
### P1：Step3 绑定 run
|
|
||||||
|
|
||||||
目标：每次研讨结果对应自己的报告。
|
|
||||||
|
|
||||||
- `Step2RunSnapshot.step3` 保存报告。
|
|
||||||
- `onReportSaved` 写回 active run。
|
|
||||||
- 切换 run 时同步 Step3 显示。
|
|
||||||
|
|
||||||
### P2：后台任务绑定 run
|
|
||||||
|
|
||||||
目标：和后台挂起执行方案打通。
|
|
||||||
|
|
||||||
- run 增加 `jobId` / `jobStatus`。
|
|
||||||
- 历史列表和左下角都能显示某条 run 正在执行。
|
|
||||||
- 点击正在执行的 run 打开派活链路弹窗。
|
|
||||||
|
|
||||||
### P3：后端 run 表
|
|
||||||
|
|
||||||
如果后续一个草稿下 run 数量很多，或者需要服务端按 run 查询、删除、重命名，再考虑新增后端表：
|
|
||||||
|
|
||||||
- `roundtable_runs`
|
|
||||||
- `draft_id`
|
|
||||||
- `run_id`
|
|
||||||
- `title`
|
|
||||||
- `status`
|
|
||||||
- `step2_snapshot`
|
|
||||||
- `step3_snapshot`
|
|
||||||
- `created_at`
|
|
||||||
- `updated_at`
|
|
||||||
|
|
||||||
短期不建议一开始就上表，先用现有 `step2` JSON 快照落地更快。
|
|
||||||
|
|
||||||
## 验收清单
|
|
||||||
|
|
||||||
- 从历史记录加载旧草稿时，左下角出现「第一次生成结果」。
|
|
||||||
- 点击「第一次生成结果」能看到原来的 Step2 研讨气泡。
|
|
||||||
- 在历史草稿中重新点击「智能体推荐」并「进入研讨」后，左下角新增「第二次生成结果」。
|
|
||||||
- 第二次研讨开始时，Step2 对话区为空或只显示新 run 初始化内容。
|
|
||||||
- 第二次 run 使用新的 `threadIds`，不会复用第一次 run 的后端线程。
|
|
||||||
- 切回「第一次生成结果」时，第一次的对话、共识状态、沙箱产物仍可查看。
|
|
||||||
- 切回「第二次生成结果」时，第二次的对话继续显示。
|
|
||||||
- 刷新页面后再次加载该历史草稿，两条结果线都还在。
|
|
||||||
- 如果两次都生成了 Step3 报告，切换不同结果线时能看到各自对应的报告。
|
|
||||||
@@ -1,198 +0,0 @@
|
|||||||
# 后台挂起「在当前进度继续」实现方案
|
|
||||||
|
|
||||||
> 状态：**待实现**（仅方案，未改代码）
|
|
||||||
> 关联：[[multi-agent-background-run-dev.md]]、[[multi-agent-frontend-dev.md]]、memory `project-roundtable-background`
|
|
||||||
> 目标：点「后台挂起」后，后端作业**在前端当前研讨进度上接着跑**，而不是新建空线程从头重跑。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 现象与根因
|
|
||||||
|
|
||||||
### 现象
|
|
||||||
在第二步研讨进行中点「后台挂起」，转入后台的作业是**从头重新开始执行**（重新初始化席位、从原始 intent 重新派活），而不是接着前端已经讨论到的进度往下走。
|
|
||||||
|
|
||||||
### 根因
|
|
||||||
后端「起作业」路由 `start_job` **从不设 `is_resume`**（默认 `False`），而执行器据此**新建一套全新线程**：
|
|
||||||
|
|
||||||
```python
|
|
||||||
# offline-backend-20260512/backend/app/gateway/roundtable_job_executor.py (_run, 约 215 行)
|
|
||||||
init = getattr(gateway, "init_threads", None)
|
|
||||||
if init is not None and not params.is_resume:
|
|
||||||
thread_ids, coordinator_name = await init() # ← 建全新空线程
|
|
||||||
```
|
|
||||||
|
|
||||||
加上前端 `startBackgroundJob` **故意不传 `threadIds`**、用 `buildInitialIntent()` 作第一轮 leader prompt，于是后台作业 = 空线程 + 原始意图 = 从头重跑。
|
|
||||||
|
|
||||||
> 这是**原设计的有意取舍**。`startBackgroundJob` 注释写明：不复用前端线程，因为「那些线程可能有活跃 run，复用会撞 409」。本方案就是要在可控前提下打开「复用前端线程续跑」这条路。
|
|
||||||
|
|
||||||
### 后端其实已支持续跑
|
|
||||||
澄清续跑路由 `resume_job`（`roundtable_jobs.py` 约 293 行）已经在做「在原线程上接着派活」：
|
|
||||||
|
|
||||||
```python
|
|
||||||
executor.start_job(StartParams(
|
|
||||||
...,
|
|
||||||
seed_message=_RESUME_PREFIX + answer, # 续跑式提示，而非原始 intent
|
|
||||||
thread_ids=row.get("thread_ids"), # 复用作业自己的线程
|
|
||||||
coordinator_name=row.get("coordinator_name") or "roundtable-coordinator",
|
|
||||||
is_resume=True, # ← 关键：跳过 init_threads，直接复用
|
|
||||||
...
|
|
||||||
))
|
|
||||||
```
|
|
||||||
|
|
||||||
执行器在 `is_resume=True` 时直接用 `params.thread_ids` + `params.coordinator_name`（不调 `init_threads`），交给 `run_orchestration` 续跑。**所以能力已存在，`start_job` 只是没走这条路。**
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 设计目标与关键事实
|
|
||||||
|
|
||||||
- 「同进度续跑」= 后台作业复用**前端当前会话的真实线程**（总控 + 各席位），这些线程的 checkpoint 里已存着到目前为止的完整研讨上下文，续跑 = 在原线程上 post 一条「继续」消息让总控接着派活。
|
|
||||||
- 前端编排是**逐轮**的：每轮一个 `POST /api/multi-agent/run/stream`（leader 或某席位），**轮与轮之间线程空闲**。只有「某一轮在飞时」线程才被占用。
|
|
||||||
- 后端复用现成线程是**已验证路径**（`resume_job` 天天在用），唯一新增的不同点是：这次复用的是「前端会话线程」而非「上一个后台作业的线程」——但线程同属一个后端线程库，复用方式完全一致。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 改造点（最小集）
|
|
||||||
|
|
||||||
### 3.1 后端：让 `start_job` 支持复用线程
|
|
||||||
|
|
||||||
文件：`offline-backend-20260512/backend/app/gateway/routers/roundtable_jobs.py`
|
|
||||||
|
|
||||||
1. `StartJobRequest` 增加字段：
|
|
||||||
```python
|
|
||||||
resume: bool = False # true + 携带 threadIds ⇒ 复用这些线程续跑，不新建
|
|
||||||
```
|
|
||||||
2. `start_job` 里把它透传给 `StartParams`：
|
|
||||||
```python
|
|
||||||
is_resume = bool(body.resume and body.threadIds)
|
|
||||||
executor.start_job(StartParams(
|
|
||||||
...,
|
|
||||||
thread_ids=body.threadIds,
|
|
||||||
coordinator_name=body.coordinatorName,
|
|
||||||
is_resume=is_resume, # ← 新增
|
|
||||||
...
|
|
||||||
))
|
|
||||||
```
|
|
||||||
其余执行器逻辑**不动**（它在 `is_resume=True` 时已能复用 `params.thread_ids`）。
|
|
||||||
|
|
||||||
> 幂等闸门（同草稿未终态作业直接返回）保持不变；续跑挂起前前端应保证该草稿没有在跑的旧作业。
|
|
||||||
|
|
||||||
### 3.2 前端 API：补 `resume` 入参
|
|
||||||
|
|
||||||
文件：`frontend-web/src/roundtable-planning/lib/job-types.ts`
|
|
||||||
- `StartJobPayload` 增加 `resume?: boolean`。
|
|
||||||
|
|
||||||
文件：`frontend-web/src/roundtable-planning/api/roundtable-jobs.ts`
|
|
||||||
- `toStartBody` 增加 `resume: p.resume ?? false`。
|
|
||||||
|
|
||||||
### 3.3 前端：`startBackgroundJob` 改为复用线程续跑
|
|
||||||
|
|
||||||
文件：`frontend-web/src/roundtable-planning/pages/RoundtablePlanningPage.tsx`（`startBackgroundJob` 约 1119 行）
|
|
||||||
|
|
||||||
当前端已有现成会话（`step2.threadIds` 且 `step2.coordinatorName` 非空，说明研讨已 init）时，改传：
|
|
||||||
|
|
||||||
```ts
|
|
||||||
const canContinue = !!(step2.threadIds && step2.coordinatorName);
|
|
||||||
await startJob({
|
|
||||||
draftId: draftId ?? undefined,
|
|
||||||
// 续跑：用「继续」式 seed，而不是 buildInitialIntent()（后者会让总控从头理解任务）
|
|
||||||
intent: buildInitialIntent(), // 仍传，作为无线程回退时的首轮 prompt
|
|
||||||
seedMessage: canContinue
|
|
||||||
? "用户已将本次研讨转入后台，请基于现有进展继续上一轮的协调与派活；若已可收口则直接综合输出结论。"
|
|
||||||
: undefined,
|
|
||||||
agents,
|
|
||||||
model: selectedModel || undefined,
|
|
||||||
orchestrationMode,
|
|
||||||
chain: chainMeta,
|
|
||||||
orchestrationPlan: orchestrationMode === "dag" ? orchestrationPlan : null,
|
|
||||||
// 关键三件套：复用前端真实线程 + 协调名 + resume 标志
|
|
||||||
threadIds: canContinue ? step2.threadIds ?? undefined : undefined,
|
|
||||||
coordinatorName: canContinue ? step2.coordinatorName ?? undefined : undefined,
|
|
||||||
resume: canContinue,
|
|
||||||
});
|
|
||||||
```
|
|
||||||
|
|
||||||
> 没有现成会话（极早期、线程未建）时 `canContinue=false`，自动回退到「新建线程 + 原 intent」的旧行为，安全。
|
|
||||||
|
|
||||||
### 3.4 前端：挂起前先停本地编排（避免交出去时线程还在飞）
|
|
||||||
|
|
||||||
文件：同上，`handleBackgroundSuspend`（约 1161 行）
|
|
||||||
|
|
||||||
当前顺序是 `startBackgroundJob()` → `resetToStep1()`（reset 里才 `stopOrchestration`）。复用线程时必须**先停再交**：
|
|
||||||
|
|
||||||
```ts
|
|
||||||
const handleBackgroundSuspend = useCallback(async () => {
|
|
||||||
if (step2.selectedAgents.length === 0) { /* toast 提示后 return */ }
|
|
||||||
// 1. 先彻底停掉前端在飞的那一轮，尽量让线程在交给后台前变空闲
|
|
||||||
step2.stopOrchestration();
|
|
||||||
step2.setIsRoundTableRunning(false);
|
|
||||||
try {
|
|
||||||
// 2. 再起后台作业（复用线程续跑）
|
|
||||||
await startBackgroundJob();
|
|
||||||
} catch (err) { /* toast 失败后 return */ }
|
|
||||||
// 3. 最后重置回第一步（后台作业继续在历史记录里跑）
|
|
||||||
resetToStep1();
|
|
||||||
triggerToast("🚀 已转入后台，将基于当前进度继续研讨…");
|
|
||||||
void drafts.refresh();
|
|
||||||
}, [...]);
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. 关键风险：线程占用（409）与三种处理
|
|
||||||
|
|
||||||
复用前端线程的唯一风险：**在某一轮在飞时挂起**，`stopOrchestration()` 只断了客户端 SSE，服务端那次 run 可能还在跑一小会儿；后台作业首轮 leader 向同一总控线程 post → 撞 409 / rollback。
|
|
||||||
|
|
||||||
| 方案 | 做法 | 取舍 |
|
|
||||||
|---|---|---|
|
|
||||||
| **A（推荐起步）** | 仅前端 stop + 后端 `is_resume` 复用，接受小概率 409 | 实现最简，真正同进度续跑；轮间挂起 100% 安全，仅「某轮在飞时挂起」有小概率 409 —— 走编排循环**现有 rollback/重试容错**兜底 |
|
|
||||||
| **B（最稳）** | 同 A，但后端在复用线程续跑前，**先 cancel 这些线程上可能残留的 run**（参考 takeover 里 `cancelJob` 的 `task.cancel()` 思路，落到 thread-run 级别）再 post | 几乎无 409；后端要多写「按 thread_id 取消活跃 run」的逻辑 |
|
|
||||||
| **C（不推荐）** | 不复用线程，新建空线程，但把「目前为止的研讨」塞进 seed_message 让总控续写 | 零 409，但**席位子线程上下文全丢**、不是真正同进度、leader prompt 臃肿 |
|
|
||||||
|
|
||||||
> 建议：先上 **A**，真机验证 409 命中率；若频繁再加 **B** 的后端线程级 cancel。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5. 适用范围（哪些挂起入口改续跑）
|
|
||||||
|
|
||||||
三个触发源（见 `autoSuspendRef`）：
|
|
||||||
|
|
||||||
1. **手动「后台挂起」按钮**（`handleBackgroundSuspend`）——**改续跑**。能在 start 前干净 stop，最适合复用线程。
|
|
||||||
2. **路由卸载自动挂起**（切到其它页面，`fire`）——可改续跑（能走完整异步链）；卸载瞬间 stop 不一定彻底，按 A 方案的容错兜底。
|
|
||||||
3. **刷新/关标签页 keepalive**（`beforeunload` 的 `beacon` → `startJobKeepalive`）——**建议保持新建线程**。关页时无法保证前端 run 已停，复用线程 409 风险最高；这里走「新建线程 + 原 intent」的安全回退即可（用户可在历史记录里点「查看」再用我们已实现的 takeover 接管回前端续跑）。
|
|
||||||
|
|
||||||
> 落地顺序建议：先只改 #1，验证稳定后再决定是否推广到 #2。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 6. 与已实现「查看=接管回前端」的关系
|
|
||||||
|
|
||||||
二者是一对对称操作，复用同一套「线程同属一个后端库、可跨前后端续跑」的事实：
|
|
||||||
|
|
||||||
- **后台挂起（本方案）**：前端 → 后端。前端 stop，把前端线程交给后台 `is_resume` 续跑。
|
|
||||||
- **查看接管（已实现，见 memory）**：后端 → 前端。`cancelJob` 停后台，`hydrateFromDraft` 恢复作业真实线程，`resumeLiveTakeover()` 由前端在那些线程上续跑。
|
|
||||||
|
|
||||||
实现本方案时可直接参照 takeover 的线程复用与 `is_resume` 经验。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 7. 测试
|
|
||||||
|
|
||||||
后端（`make test`）：
|
|
||||||
- 新增/扩展 `tests/test_roundtable_jobs.py`：`start_job` 带 `resume=true + threadIds` ⇒ `StartParams.is_resume=True` 且**不调** `init_threads`、直接用传入线程；`resume=false` 或无 `threadIds` ⇒ 走 `init_threads` 新建（回归旧行为）。
|
|
||||||
- 回归：`tests/test_roundtable_inprocess_request.py`、`tests/test_roundtable_step3_pipeline.py`（确认续跑不破坏 Step3 双产物）。
|
|
||||||
|
|
||||||
前端（`pnpm typecheck`）+ 真机：
|
|
||||||
- 研讨进行到几轮后点「后台挂起」→ 历史记录里点「查看」→ 确认后台是**接着已有对话**往下派活，而非从第 1 轮重来。
|
|
||||||
- 轮间挂起 / 某轮在飞时挂起两种时机各验一次，观察是否出现 409（A 方案下应被 rollback 容错吸收）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 8. 落地清单（TL;DR）
|
|
||||||
|
|
||||||
- [ ] 后端 `StartJobRequest.resume` 字段 + `start_job` 透传 `is_resume`
|
|
||||||
- [ ] 前端 `StartJobPayload.resume` + `toStartBody`
|
|
||||||
- [ ] 前端 `startBackgroundJob`：有会话时传 `threadIds/coordinatorName/seedMessage/resume`
|
|
||||||
- [ ] 前端 `handleBackgroundSuspend`：调整为 **先 stop 再 start 再 reset**
|
|
||||||
- [ ] 后端测试（resume 复用 vs 新建分支）
|
|
||||||
- [ ] 真机验证「接着进度跑」+ 409 命中率
|
|
||||||
- [ ]（可选）方案 B：后端复用线程前按 thread_id 取消残留 run
|
|
||||||
@@ -1,362 +0,0 @@
|
|||||||
# 岗位会商交付闭环与内置智能体实现计划
|
|
||||||
|
|
||||||
> 页面：`/page/strategy/qa/position-roundtable`
|
|
||||||
>
|
|
||||||
> 目标：在现有岗位会商基础上补齐“产物交付、查看、驳回、方案总结、行动规划”的完整闭环，同时继续保持原多智能体会商页面不受影响。
|
|
||||||
|
|
||||||
## 实施核对（2026-07-21）
|
|
||||||
|
|
||||||
本计划已按“岗位会商独立路由、无总控、各席位直接问答”的边界完成第一轮闭环。实际流程调整为：
|
|
||||||
|
|
||||||
```text
|
|
||||||
任务信息 → 情报分析岗识别并确认意图 → 启动校验并冻结业务链
|
|
||||||
→ 分阶段席位直接问答/交付 Markdown → 全部有效交付
|
|
||||||
→ 方案总结智能体（roundtable-summary）→ 行动规划智能体（position-action-planner）
|
|
||||||
→ 可随时返回交付产物驳回 → 后续阶段及内置产物级联失效 → 重做后重新收口
|
|
||||||
```
|
|
||||||
|
|
||||||
- [x] 情报意图、业务链选择、席位岗位归属和席位智能体配置均在启动前校验；启动后保存业务链快照。
|
|
||||||
- [x] 普通席位直接调用各自分配的智能体，并注入任务、意图及已完成上游席位的问答/产物；不经过总控智能体。
|
|
||||||
- [x] 普通席位必须在 `outputs` 中交付 Markdown 才会完成；情报分析岗以确认的结构化意图完成为准。
|
|
||||||
- [x] 节点、交付卡片、流程图和大图弹窗均展示 `locked / ready / running / done / rejected / stale / error` 状态，并可回看节点会话和产物。
|
|
||||||
- [x] 驳回要求标题和理由；当前节点转为 `rejected`，后续阶段按依赖转为 `stale/locked`，总结和行动规划同时失效，历史内容保留可查看。
|
|
||||||
- [x] 被驳回或失效的普通席位必须写入一份**新的或已改写** Markdown 才能再次完成；单纯继续问答且没有新交付不会误使下游产物失效。
|
|
||||||
- [x] 方案总结复用 `roundtable-summary` 的真实流式线程；行动规划新增 `position-action-planner`，强制输出 Markdown 报告和 `action-plan-subtasks.json`。
|
|
||||||
- [x] 两个内置智能体的线程、产物快照和来源节点版本栅栏均持久化；流式期间若上游版本变化，旧运行不能覆盖最新状态。
|
|
||||||
- [x] 右侧“交付产物”可查看内置节点结果、继续同一线程问答/修改交付，并在打开 Markdown 沙箱时自动收起右栏。
|
|
||||||
|
|
||||||
设计收敛：当前版本以节点的 `artifact_manifest`、`latest_answer`、版本、驳回记录及 Session 内置快照作为唯一事实来源，已能覆盖统一产物卡片和级联逻辑，因此不新增重复的 `position_roundtable_deliverables` 表。若后续需要“单个文件独立驳回、跨会话检索或完整版本对比”，再将清单归一化为独立产物表，避免现在的双写一致性风险。
|
|
||||||
|
|
||||||
## 数据持久化与灾难恢复（2026-07-23）
|
|
||||||
|
|
||||||
岗位会商现在使用“两层持久化”，两层职责不同：
|
|
||||||
|
|
||||||
1. LangGraph checkpoint/thread 是智能体继续推理与流式问答的执行源。
|
|
||||||
2. `position_roundtable_sessions` / `position_roundtable_nodes` 是页面历史的数据库恢复源。
|
|
||||||
|
|
||||||
数据库恢复源会保存：
|
|
||||||
|
|
||||||
- 情报分析岗完整消息、步骤时间线和未发送输入草稿；
|
|
||||||
- 每个业务链岗位的完整消息和未发送输入草稿；
|
|
||||||
- 方案总结、行动规划两个收口智能体的完整消息和未发送输入草稿；
|
|
||||||
- 已确认意图、冻结任务与业务链快照、节点状态、版本、驳回记录；
|
|
||||||
- Markdown / JSON 等文本产物正文（单文件最多 400 万字符）和文件元数据。
|
|
||||||
|
|
||||||
因此即使线上重启后 checkpoint 或沙箱 outputs 卷丢失，历史页仍能从数据库展示对话与产物正文，后续收口智能体也能继续读取数据库中的有效上游交付。新任务在意图识别开始前就会创建 Session，用户不必等到“启动业务链”才获得持久化保护。历史下拉支持删除，删除会显式清理 Session 与全部节点恢复快照，不依赖 SQLite 外键开关。
|
|
||||||
|
|
||||||
对应迁移：`20260723_05_position_roundtable_conversations.py`。部署时必须执行到 Alembic head。
|
|
||||||
|
|
||||||
## 0. 核心结论
|
|
||||||
|
|
||||||
- 方案总结智能体建议复用现有会商里的 `roundtable-summary` 能力，但不要直接搬整套 Step 3 页面流程。
|
|
||||||
- 可复用：内置智能体 ID、总结报告 prompt 组织方式、Markdown 报告产物、流式对话、报告续问与文件预览能力。
|
|
||||||
- 需要改造：输入材料从“总控共识 + 各席位交付”改成“任务信息 + 意图结果 + 已通过的岗位产物 + 业务链快照”，并把结果存到岗位会商 Session 下。
|
|
||||||
- 行动规划智能体建议作为新的内置智能体新增。
|
|
||||||
- 输入：方案总结报告、各岗位最终有效产物、业务链阶段信息、任务意图。
|
|
||||||
- 输出：行动规划报告、结构化子任务清单。
|
|
||||||
- 这个模式仍然不需要总控智能体。情报分析岗负责意图识别，业务链节点直接调用各自配置的智能体，最终再由内置总结/规划智能体收口。
|
|
||||||
- 驳回不删除历史内容，只改变“当前有效版本”的状态；被驳回节点和后续节点需要重新交付，既保留可追溯性，也方便后续返回查看。
|
|
||||||
|
|
||||||
## 1. 目标业务流程
|
|
||||||
|
|
||||||
1. 情报分析岗进入页面，查看任务信息并完成意图识别。
|
|
||||||
2. 用户点击“确认意图并启动业务链”。
|
|
||||||
3. 启动前做校验：
|
|
||||||
- 未选择业务链：提示“请先选择业务链”。
|
|
||||||
- 业务链存在未配置岗位的席位：提示并引导去业务链配置页。
|
|
||||||
- 业务链席位缺少智能体：提示具体席位名称。
|
|
||||||
- 意图尚未完成：提示先完成任务意图识别。
|
|
||||||
4. 校验通过后冻结业务链快照，初始化岗位会商节点。
|
|
||||||
5. 各岗位只对分配给本岗位的智能体进行问答。
|
|
||||||
6. 节点问答完成后形成交付产物，右侧产物卡片显示“已完成 / 未完成 / 进行中 / 已驳回 / 已失效”。
|
|
||||||
7. 左侧流程图显示各节点状态，节点可点击查看该节点对话与产物。
|
|
||||||
8. 流程图右上角提供“查看”按钮，打开弹窗展示更完整的业务链流程图。
|
|
||||||
9. 当业务链中所有岗位产物都处于有效已交付状态后，开放“方案总结”。
|
|
||||||
10. 方案总结完成后开放“行动规划”。
|
|
||||||
11. 即使进入方案总结或行动规划，用户仍可返回产物列表执行驳回。
|
|
||||||
12. 若驳回早期阶段产物，后续阶段产物、方案总结、行动规划都一起失效并回到待重新完成状态。
|
|
||||||
|
|
||||||
## 2. 状态设计
|
|
||||||
|
|
||||||
### 2.1 节点状态
|
|
||||||
|
|
||||||
现有节点状态需要扩展或映射为更贴近页面的展示状态：
|
|
||||||
|
|
||||||
| 展示状态 | 建议内部状态 | 含义 |
|
|
||||||
| --- | --- | --- |
|
|
||||||
| 未完成 | `ready` / `locked` / `rejected` | 尚未有效交付，或被驳回后等待重做 |
|
|
||||||
| 进行中 | `running` | 当前智能体正在回答或产物正在生成 |
|
|
||||||
| 已完成 | `done` | 当前节点已有有效交付 |
|
|
||||||
| 已失效 | `stale` | 上游被更新或驳回，当前结果不可作为最终材料 |
|
|
||||||
| 异常 | `error` | 生成或保存失败 |
|
|
||||||
|
|
||||||
建议新增 `rejected` 状态，便于区分“从未完成”和“被驳回后待重做”。如果第一轮想少改后端，也可以先用 `ready + rejection_record` 表示被驳回。
|
|
||||||
|
|
||||||
### 2.2 产物状态
|
|
||||||
|
|
||||||
产物状态建议独立于节点状态保存，因为一个节点可能同时有回答文本和多个文件产物。
|
|
||||||
|
|
||||||
| 状态 | 含义 |
|
|
||||||
| --- | --- |
|
|
||||||
| `pending` | 还没有交付 |
|
|
||||||
| `running` | 正在生成 |
|
|
||||||
| `delivered` | 已交付且当前有效 |
|
|
||||||
| `rejected` | 被用户驳回 |
|
|
||||||
| `stale` | 受上游驳回或重做影响，已经失效 |
|
|
||||||
|
|
||||||
### 2.3 内置收口节点
|
|
||||||
|
|
||||||
在流程图中把两个内置节点追加到业务链末尾：
|
|
||||||
|
|
||||||
1. `builtin:summary`：方案总结智能体。
|
|
||||||
2. `builtin:action-plan`：行动规划智能体。
|
|
||||||
|
|
||||||
这两个节点不属于普通业务链席位，但要和普通节点一样显示状态、支持点击查看结果。
|
|
||||||
|
|
||||||
## 3. 数据模型调整
|
|
||||||
|
|
||||||
### 3.1 Session 扩展
|
|
||||||
|
|
||||||
`position_roundtable_sessions` 已使用下列持久化字段：
|
|
||||||
|
|
||||||
| 字段 | 含义 |
|
|
||||||
| --- | --- |
|
|
||||||
| `status` | `intent_pending / active / completed / archived`；总结/规划运行态由前端瞬时状态与对应快照的 `status` 表示，避免一次运行中断后留下伪运行态 |
|
|
||||||
| `summary_thread_id` | 方案总结智能体线程 |
|
|
||||||
| `summary_snapshot` | 最新有效总结报告快照 |
|
|
||||||
| `action_plan_thread_id` | 行动规划智能体线程 |
|
|
||||||
| `action_plan_snapshot` | 最新有效行动规划快照 |
|
|
||||||
| `invalidated_at` | 记录在 `summary_snapshot` / `action_plan_snapshot` 内，包含 `invalidated_by`，无需重复写 Session 字段 |
|
|
||||||
|
|
||||||
### 3.2 Node 扩展
|
|
||||||
|
|
||||||
`position_roundtable_nodes` 已使用下列字段（展示状态由前端按状态映射）：
|
|
||||||
|
|
||||||
| 字段 | 含义 |
|
|
||||||
| --- | --- |
|
|
||||||
| `status` | `locked / ready / running / done / stale / rejected / error`，前端直接映射为展示状态 |
|
|
||||||
| `rejection_count` | 当前节点累计驳回次数 |
|
|
||||||
| `last_rejection` | 最新驳回标题、理由、操作者、时间 |
|
|
||||||
| `revision` | 当前有效交付版本 |
|
|
||||||
| `invalidated_by` | 导致当前节点失效的上游节点 key |
|
|
||||||
|
|
||||||
### 3.3 Deliverable 新表（后续可选）
|
|
||||||
|
|
||||||
当需要“单个文件独立驳回、跨会话检索或完整版本对比”时，再新增 `position_roundtable_deliverables`，不要只依赖 `artifact_manifest`。
|
|
||||||
|
|
||||||
| 字段 | 含义 |
|
|
||||||
| --- | --- |
|
|
||||||
| `id` | 产物 ID |
|
|
||||||
| `session_id` | 会话 ID |
|
|
||||||
| `node_key` | 来源节点 |
|
|
||||||
| `agent_id` | 来源智能体 |
|
|
||||||
| `position_id` | 来源岗位 |
|
|
||||||
| `title` | 产物名称 |
|
|
||||||
| `kind` | `answer / file / summary / action_plan` |
|
|
||||||
| `content` | 文本产物内容摘要或正文 |
|
|
||||||
| `artifact_path` | 文件产物虚拟路径 |
|
|
||||||
| `thread_id` | 所属线程 |
|
|
||||||
| `status` | `pending / running / delivered / rejected / stale` |
|
|
||||||
| `revision` | 来源节点版本 |
|
|
||||||
| `rejection_title` | 驳回标题 |
|
|
||||||
| `rejection_reason` | 驳回理由 |
|
|
||||||
| `created_at` | 创建时间 |
|
|
||||||
| `updated_at` | 更新时间 |
|
|
||||||
|
|
||||||
当前第一轮不新增这张表：右侧产物卡片、驳回记录、总结输入材料从节点 `artifact_manifest`、节点版本/驳回记录和 Session 快照聚合，避免节点表与产物表双写。后续引入该表时，应把它提升为唯一事实来源，而不是并行维护两套状态。
|
|
||||||
|
|
||||||
## 4. 驳回与级联失效规则
|
|
||||||
|
|
||||||
### 4.1 基本驳回
|
|
||||||
|
|
||||||
用户点击产物卡片的“驳回”后弹窗填写：
|
|
||||||
|
|
||||||
- 驳回标题。
|
|
||||||
- 驳回理由。
|
|
||||||
|
|
||||||
提交后：
|
|
||||||
|
|
||||||
- 当前产物状态改为 `rejected`。
|
|
||||||
- 当前节点状态改为 `rejected` 或 `ready`。
|
|
||||||
- 当前节点的 `latest_answer` 和历史文件不删除，但不再作为有效交付输入。
|
|
||||||
- 记录 `last_rejection`，用于页面展示和后续追踪。
|
|
||||||
|
|
||||||
### 4.2 级联失效
|
|
||||||
|
|
||||||
如果驳回的节点位于第 N 阶段：
|
|
||||||
|
|
||||||
- 同阶段其他节点不自动驳回，除非业务链未来明确配置了依赖关系。
|
|
||||||
- 第 N+1 阶段及之后所有节点的有效产物全部标记为 `stale`。
|
|
||||||
- 后续节点状态回到未完成展示态。
|
|
||||||
- `builtin:summary` 和 `builtin:action-plan` 如果已经生成，也标记为 `stale`。
|
|
||||||
- 页面允许用户继续查看旧报告和旧行动规划，但必须提示“上游产物已变更，需要重新生成”。
|
|
||||||
|
|
||||||
### 4.3 重新交付
|
|
||||||
|
|
||||||
被驳回节点重新问答并完成后：
|
|
||||||
|
|
||||||
- 当前节点产生新的 `revision`。
|
|
||||||
- 当前节点产物状态变为 `delivered`。
|
|
||||||
- 只有当该阶段所有必要节点都重新有效交付后，下一阶段才重新解锁。
|
|
||||||
- 方案总结和行动规划必须基于最新有效产物重新生成。
|
|
||||||
|
|
||||||
## 5. 接口规划
|
|
||||||
|
|
||||||
### 5.1 启动与校验
|
|
||||||
|
|
||||||
| 方法 | 路径 | 用途 |
|
|
||||||
| --- | --- | --- |
|
|
||||||
| `POST` | `/api/position-roundtable/sessions/{id}/validate-activation` | 校验业务链、岗位、智能体、意图状态 |
|
|
||||||
| `POST` | `/api/position-roundtable/sessions/{id}/activate` | 校验通过后冻结链条并初始化节点 |
|
|
||||||
|
|
||||||
第一轮也可以先把校验合并在 `activate` 内，前端根据后端返回的错误码提示。
|
|
||||||
|
|
||||||
### 5.2 产物
|
|
||||||
|
|
||||||
| 方法 | 路径 | 用途 |
|
|
||||||
| --- | --- | --- |
|
|
||||||
| `GET` | `/api/position-roundtable/sessions/{id}/results` | 获取右侧统一产物来源节点（前端聚合文件与内置快照） |
|
|
||||||
| `GET` | `/api/position-roundtable/sessions/{id}/nodes/{node_key}` | 获取节点详情；文件正文由既有线程产物预览接口读取 |
|
|
||||||
| `POST` | `/api/position-roundtable/sessions/{id}/nodes/{node_key}/reject` | 驳回当前节点交付并触发级联失效 |
|
|
||||||
| `POST` | `/api/position-roundtable/sessions/{id}/nodes/{node_key}/complete-turn` | 节点回答结束后同步回答与产物 |
|
|
||||||
|
|
||||||
### 5.3 方案总结与行动规划
|
|
||||||
|
|
||||||
| 方法 | 路径 | 用途 |
|
|
||||||
| --- | --- | --- |
|
|
||||||
| `POST` | `/api/position-roundtable/sessions/{id}/summary/prepare` | 服务端准备版本锁定的总结材料和线程信息 |
|
|
||||||
| `POST` | `/api/position-roundtable/sessions/{id}/summary/ask` | 服务端准备总结的同线程续问材料 |
|
|
||||||
| `POST` | `/api/position-roundtable/sessions/{id}/summary/complete` | 校验 Markdown 交付与来源版本后持久化总结快照 |
|
|
||||||
| `POST` | `/api/position-roundtable/sessions/{id}/action-plan/prepare` | 服务端准备行动规划材料和线程信息 |
|
|
||||||
| `POST` | `/api/position-roundtable/sessions/{id}/action-plan/ask` | 服务端准备行动规划同线程续问材料 |
|
|
||||||
| `POST` | `/api/position-roundtable/sessions/{id}/action-plan/complete` | 校验 Markdown + JSON 交付与来源版本后持久化行动规划快照 |
|
|
||||||
|
|
||||||
可以复用现有 `streamMultiAgent` 流式协议，但建议在岗位会商下包一层 API，由后端负责拼装岗位会商材料，前端不直接拼长 prompt。
|
|
||||||
|
|
||||||
## 6. 前端实施步骤
|
|
||||||
|
|
||||||
### 阶段 1：状态与启动校验（已完成）
|
|
||||||
|
|
||||||
- 扩展 `PositionNodeStatus` 和状态显示映射。
|
|
||||||
- “确认意图并启动业务链”前补齐校验提示。
|
|
||||||
- 后端 `activate` 返回未配置岗位、缺智能体、未选择链条等具体错误。
|
|
||||||
- 左侧流程图节点右上角添加状态小图标。
|
|
||||||
- 节点样式调整为上方智能体名称、下方岗位名称，移除左侧 logo。
|
|
||||||
|
|
||||||
验收标准：未选择业务链、岗位未配齐、意图未完成时都能准确阻止启动；启动后流程图能显示各节点状态。
|
|
||||||
|
|
||||||
### 阶段 2：流程图弹窗（已完成）
|
|
||||||
|
|
||||||
- 左侧保留小型从上到下流程图。
|
|
||||||
- 流程图右上角增加“查看”按钮。
|
|
||||||
- 点击后打开弹窗，展示更大的流程图。
|
|
||||||
- 弹窗内支持点击节点查看对话与产物，保持和主页面选中节点同步。
|
|
||||||
|
|
||||||
验收标准：小图不挤占左侧空间，大图能完整展示业务链和两个内置收口节点。
|
|
||||||
|
|
||||||
### 阶段 3：产物卡片与预览（已完成）
|
|
||||||
|
|
||||||
- 右侧新增或改造“分析结果”Tab 为“交付产物”列表。
|
|
||||||
- 卡片展示智能体名称、产物名称、岗位名称、时间、状态。
|
|
||||||
- 点击卡片打开详情弹窗。
|
|
||||||
- 文本产物直接展示正文，文件产物复用现有 `ArtifactPreviewModal`。
|
|
||||||
- 每个有效产物提供“驳回”入口。
|
|
||||||
|
|
||||||
验收标准：节点回答和文件产物能进入统一产物列表；点击可查看详情。
|
|
||||||
|
|
||||||
### 阶段 4：驳回弹窗与级联失效（已完成）
|
|
||||||
|
|
||||||
- 新增 `RejectDeliverableDialog`。
|
|
||||||
- 驳回表单包含标题和理由，均必填。
|
|
||||||
- 后端事务内完成当前产物驳回、当前节点状态更新、后续阶段级联失效、总结和行动规划失效。
|
|
||||||
- 前端刷新 Session、Node、Deliverable 和流程图状态。
|
|
||||||
- 被驳回节点在对话区显示驳回信息，提示用户重新交付。
|
|
||||||
|
|
||||||
验收标准：驳回第一阶段任意节点后，第二阶段及之后产物都显示未完成或已失效；旧内容可查看但不能作为总结输入。
|
|
||||||
|
|
||||||
### 阶段 5：方案总结智能体（已完成）
|
|
||||||
|
|
||||||
- 封装 `usePositionSummary`，内部复用 `roundtable-summary` 的线程初始化、流式输出和 Markdown 产物预览能力。
|
|
||||||
- 输入材料改为岗位会商材料：
|
|
||||||
- 任务信息。
|
|
||||||
- 情报分析岗意图结果。
|
|
||||||
- 业务链快照。
|
|
||||||
- 所有状态为 `delivered` 的岗位产物。
|
|
||||||
- 已驳回或失效产物只作为历史参考，不进入默认总结材料。
|
|
||||||
- 方案总结节点追加到流程图末尾。
|
|
||||||
- 所有产物有效交付后才允许点击“生成方案总结”。
|
|
||||||
- 总结结果写入 `summary_snapshot`，同时进入产物列表。
|
|
||||||
|
|
||||||
验收标准：总结报告使用现有方案总结能力生成 Markdown；刷新页面后可恢复；上游驳回后总结标记失效。
|
|
||||||
|
|
||||||
### 阶段 6：行动规划智能体（已完成）
|
|
||||||
|
|
||||||
- 新增内置智能体 ID，建议先命名为 `position-action-planner`。
|
|
||||||
- 新增行动规划 prompt：
|
|
||||||
- 读取方案总结报告。
|
|
||||||
- 读取各岗位最终有效产物。
|
|
||||||
- 拆解为若干子任务。
|
|
||||||
- 每个子任务包含名称、目标、输入依据、责任岗位建议、前置依赖、交付物、验收标准。
|
|
||||||
- 输出两类产物：
|
|
||||||
- `行动规划报告.md`。
|
|
||||||
- `action-plan-subtasks.json`。
|
|
||||||
- 行动规划节点追加到方案总结之后。
|
|
||||||
- 方案总结有效完成后才允许启动行动规划。
|
|
||||||
|
|
||||||
验收标准：行动规划能生成可读报告和结构化子任务；刷新可恢复；上游驳回后自动失效。
|
|
||||||
|
|
||||||
### 阶段 7：返回修改与重新生成（已完成）
|
|
||||||
|
|
||||||
- 用户在方案总结或行动规划视图中仍可切回“交付产物”。
|
|
||||||
- 驳回后自动显示需要重做的节点。
|
|
||||||
- 重做节点完成后，允许重新生成方案总结和行动规划。
|
|
||||||
- 旧总结、旧行动规划保留历史查看，但状态显示“已失效”。
|
|
||||||
|
|
||||||
验收标准：不会因为进入总结/规划阶段而锁死前序产物；前序重做后能形成新版本闭环。
|
|
||||||
|
|
||||||
### 阶段 8：测试与回归（已完成）
|
|
||||||
|
|
||||||
- 后端测试：
|
|
||||||
- activate 校验。
|
|
||||||
- 节点完成后产物入库。
|
|
||||||
- 驳回当前节点。
|
|
||||||
- 驳回第一阶段时后续阶段级联失效。
|
|
||||||
- 总结和行动规划失效。
|
|
||||||
- 前端测试：
|
|
||||||
- 启动校验提示。
|
|
||||||
- 状态图标显示。
|
|
||||||
- 产物卡片筛选和预览。
|
|
||||||
- 驳回弹窗必填校验。
|
|
||||||
- 回归验证：
|
|
||||||
- 原多智能体会商页面不受影响。
|
|
||||||
- 业务链普通配置入口不显示岗位配置。
|
|
||||||
- 岗位会商页面刷新恢复正常。
|
|
||||||
- 深色模式和嵌入模式布局不溢出。
|
|
||||||
|
|
||||||
## 7. 推荐提交拆分
|
|
||||||
|
|
||||||
1. `feat(position-roundtable): add delivery status model`
|
|
||||||
2. `feat(position-roundtable): validate chain activation`
|
|
||||||
3. `feat(position-roundtable): add workflow status graph`
|
|
||||||
4. `feat(position-roundtable): add deliverable cards and preview`
|
|
||||||
5. `feat(position-roundtable): support rejection cascade`
|
|
||||||
6. `feat(position-roundtable): add summary builtin node`
|
|
||||||
7. `feat(position-roundtable): add action planning builtin node`
|
|
||||||
8. `test(position-roundtable): cover delivery workflow`
|
|
||||||
|
|
||||||
## 8. 第一轮建议范围
|
|
||||||
|
|
||||||
第一轮优先做最小可闭环：
|
|
||||||
|
|
||||||
```text
|
|
||||||
意图识别
|
|
||||||
→ 启动校验
|
|
||||||
→ 业务链节点状态
|
|
||||||
→ 节点产物列表
|
|
||||||
→ 产物详情查看
|
|
||||||
→ 驳回与级联失效
|
|
||||||
→ 全部交付后生成方案总结
|
|
||||||
→ 基于总结生成行动规划
|
|
||||||
```
|
|
||||||
|
|
||||||
如果时间紧，行动规划可以先生成 Markdown 报告，结构化 `subtasks.json` 放到第二轮；但数据模型和 UI 入口第一轮就要预留，否则后面会返工。
|
|
||||||
File diff suppressed because it is too large.
Load diff
@@ -1,610 +0,0 @@
|
|||||||
# 圆桌 DAG 编排 + 并行执行显示 —— 分步实现需求文档
|
|
||||||
|
|
||||||
> 目标读者：实现本功能的前端 / 后端工程师。
|
|
||||||
> 本文是**可逐步落地**的需求 + 设计文档，每个 Phase 都能独立交付、独立验收。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 0. 背景与目标
|
|
||||||
|
|
||||||
### 0.1 现状
|
|
||||||
|
|
||||||
Step 2 圆桌目前有两种编排模式（`orchestrationMode`，见 `hooks/useStep2Orchestration.ts`）：
|
|
||||||
|
|
||||||
- **`free`（自由模式）**：总控（leader）自由决定派活给谁，`runOrchestration` 循环驱动。
|
|
||||||
- **`chain`（线性链条）**：用户把席位排成一条**线性**链 `A → B → C`，`runChainOrchestration` 按顺序逐个派活，最后总控收口。链路用 `DispatchChainModal.tsx` 的**横向流程图**展示（总控 → 席位1 → 席位2 → … → 共识 → 报告）。
|
|
||||||
|
|
||||||
链条数据现在只是一个**有序数组** `selectedAgents`（线性），节点状态类型见 `lib/job-types.ts`（`ChainNodeState = pending | active | done`）。
|
|
||||||
|
|
||||||
### 0.2 目标（本次新增）
|
|
||||||
|
|
||||||
1. **DAG 编排**：用户可视化指定**智能体之间的直接依赖关系**——有的串行（`A → B → C`），有的并行（`A B C` 同时跑）。编排结果是一张**流程图（DAG）**。
|
|
||||||
2. **并行执行**：DAG 里同一层（互不依赖）的智能体**并行**跑，墙钟时间从「串行求和」降到「并行取最慢」。
|
|
||||||
3. **并行禁止写文件**：并行的智能体**禁用文件写入 / 沙箱命令**，避免它们同时打开沙箱互相打架。产物以消息正文交付；落文件留给串行 / 收口阶段。
|
|
||||||
4. **并行高性能显示**：并行时收起左侧、顶部头像条切换、主区同时显示 2 个智能体的消息流，其余**只接流不渲染**，避免页面卡死。
|
|
||||||
|
|
||||||
### 0.3 设计总原则
|
|
||||||
|
|
||||||
- **复用** 现有 special run / leader run / rollback 抢占 / 轻量交付状态接口（`GET /threads/{id}/last-ai-message`），不另起炉灶。
|
|
||||||
- **线性链是 DAG 的特例**：`chain` 模式可平滑迁移成"每层 1 个节点"的 DAG，老数据不破坏。
|
|
||||||
- **分层（Stage）优先于自由连线**：编辑交互首选「分层」模型（每个 stage 放若干并行席位，stage 间串行），实现成本低、覆盖 95% 的"串 / 并"诉求；自由连线画布作为后续可选增强（见 §2.3）。
|
|
||||||
|
|
||||||
### 0.4 已确认的设计决策（✅ 本期按这些实现）
|
|
||||||
|
|
||||||
> 以下三项已与需求方确认锁定，实现时直接按此，不再二选一。
|
|
||||||
|
|
||||||
1. **✅ 编排模型 = 分层 Stage**：本期只做分层（每个 stage 放若干并行席位、stage 间串行）。**自由连线画布本期不做**，仅在数据模型层预留（§1.2）以免将来返工。
|
|
||||||
2. **✅ 并行跳过 leader、前端直派**：DAG 由用户显式指定，执行时前端**直接**对 stage 内席位发起 special run，**不**每个 stage 再跑一轮总控派活；只在最后 `finalSynthesis` 跑一轮 leader 综合（即 §3.2 的方案 B）。
|
|
||||||
3. **✅ 主区固定 2 列，窄屏降 1 列**：并行时主区最多并排显示 2 个被选中智能体的消息流；窄屏（断点见 §5.3）降为 1 列 + 头像条横向滚动。不做 3+ 列。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 数据模型
|
|
||||||
|
|
||||||
### 1.1 DAG 的「分层」表示（推荐，主模型）
|
|
||||||
|
|
||||||
把 DAG 表示成**有序的 stage 列表**，每个 stage 内的席位并行、stage 之间串行：
|
|
||||||
|
|
||||||
```ts
|
|
||||||
// lib/dag-types.ts （新建）
|
|
||||||
|
|
||||||
/** 一个并行批次：stage 内所有席位并行执行。 */
|
|
||||||
export interface OrchestrationStage {
|
|
||||||
/** stage 稳定 id（拖拽重排 / diff 用）。 */
|
|
||||||
id: string;
|
|
||||||
/** 本 stage 并行执行的席位（agent_id 列表）。1 个 = 退化为串行节点。 */
|
|
||||||
agentIds: string[];
|
|
||||||
}
|
|
||||||
|
|
||||||
/** 用户编排出的执行计划。stages 顺序即串行顺序。 */
|
|
||||||
export interface OrchestrationPlan {
|
|
||||||
/** 编排模式标识，持久化进 step2。 */
|
|
||||||
mode: "dag";
|
|
||||||
/** 串行执行的批次；每批内并行。 */
|
|
||||||
stages: OrchestrationStage[];
|
|
||||||
/** 收口：是否在所有 stage 完成后由总控综合（默认 true）。 */
|
|
||||||
finalSynthesis: boolean;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
- **串行** `A → B → C` = `stages: [{agentIds:[A]}, {agentIds:[B]}, {agentIds:[C]}]`。
|
|
||||||
- **并行** `A B C` = `stages: [{agentIds:[A,B,C]}]`。
|
|
||||||
- **混合** `A →(B C)→ D` = `stages: [{[A]}, {[B,C]}, {[D]}]`。
|
|
||||||
|
|
||||||
> 为什么用分层而不是「邻接表 / 边」：执行调度本就是「拓扑分批」，分层就是分批的结果，前端不必再做拓扑排序，也天然避免环；编辑器交互更直观（拖卡片进 stage）。真正的自由连线 DAG 见 §2.3（可选）。
|
|
||||||
|
|
||||||
### 1.2 通用 DAG 表示（§2.3 自由连线时才需要）
|
|
||||||
|
|
||||||
若将来做自由连线画布，再引入边表示，并在执行前做一次**拓扑排序 → 分层**，落回 §1.1 的 stages 结构给调度器用：
|
|
||||||
|
|
||||||
```ts
|
|
||||||
export interface DagEdge { from: string; to: string } // from 完成后才能跑 to
|
|
||||||
export interface DagGraph { nodes: string[]; edges: DagEdge[] }
|
|
||||||
// 执行前：toposortToStages(graph) -> OrchestrationStage[]
|
|
||||||
```
|
|
||||||
|
|
||||||
### 1.3 持久化
|
|
||||||
|
|
||||||
- 复用 `roundtable_drafts.step2` JSON（见后端 `app.gateway.routers` roundtable-drafts + `hooks/useStep2Orchestration.ts` 里对 `step2` 的读写）。
|
|
||||||
- 在 `step2` 增加字段：`orchestrationPlan: OrchestrationPlan | null`。
|
|
||||||
- `orchestrationMode` 扩展为 `"free" | "chain" | "dag"`；`chain` 旧数据读取时即时转换为单节点-stage 的 `dag`（兼容层，不改老 draft）。
|
|
||||||
|
|
||||||
### 1.4 校验（纯函数，可单测）
|
|
||||||
|
|
||||||
`lib/dag-types.ts` 内提供：
|
|
||||||
|
|
||||||
```ts
|
|
||||||
validatePlan(plan: OrchestrationPlan, selectedAgentIds: string[]): {
|
|
||||||
ok: boolean;
|
|
||||||
errors: string[]; // 面向用户的中文提示
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
校验项：
|
|
||||||
- 每个 `agentId` 必须在本次选定席位 `selectedAgents` 内（防止编排了不存在的席位 → 复用后端 `_partition_dispatch` 同思路的"必须在 roster 内"）。
|
|
||||||
- 不允许空 stage；不允许同一席位出现在多个 stage（一个席位只跑一次）。
|
|
||||||
- 至少 1 个 stage。
|
|
||||||
- （可选）单 stage 并行度上限提示（如 > 6 并行给 warning：远程模型并发 + 沙箱压力）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 编排编辑器（流程图构建）交互
|
|
||||||
|
|
||||||
### 2.1 入口与整体布局
|
|
||||||
|
|
||||||
- 在 Step 2 顶部模式切换里新增 **「依赖编排」**（`dag`）模式（与现有 自由 / 链条 并列）。
|
|
||||||
- 选择 `dag` 后弹出 / 进入**编排编辑器**（复用 Dialog 大弹窗，参考 `DispatchChainModal` 的尺寸 `w-[94vw] max-w-[1240px]`）。
|
|
||||||
|
|
||||||
### 2.2 推荐交互：分层（Stage）编辑器（Phase 2 实现）
|
|
||||||
|
|
||||||
```
|
|
||||||
┌ 依赖编排 ───────────────────────────────────────── [校验✓] [保存] ┐
|
|
||||||
│ 可选席位（点/拖加入某个 stage） │
|
|
||||||
│ [情报收集] [环境评估] [方案设计] [风险审查] [执行规划] [前端实现] │
|
|
||||||
│ ─────────────────────────────────────────────────────────────── │
|
|
||||||
│ Stage 1（并行） Stage 2（并行） Stage 3 │
|
|
||||||
│ ┌──────────┐ ─────▶ ┌──────────┐ ┌────────┐ ─▶ ┌──────────┐ │
|
|
||||||
│ │ 情报收集 │ │ 方案设计 │ │风险审查│ │ 执行规划 │ │
|
|
||||||
│ └──────────┘ └──────────┘ └────────┘ └──────────┘ │
|
|
||||||
│ [＋ 拖席位到此] [＋] [＋] │
|
|
||||||
│ [＋ 新建 Stage（串在最后）] │
|
|
||||||
│ ─────────────────────────────────────────────────────────────── │
|
|
||||||
│ 说明：同一 Stage 内的席位会**并行**执行；Stage 之间**串行** │
|
|
||||||
│ （后一个 Stage 能看到前面所有 Stage 的交付摘要）。 │
|
|
||||||
└───────────────────────────────────────────────────────────────────┘
|
|
||||||
```
|
|
||||||
|
|
||||||
交互要点：
|
|
||||||
- **加入 stage**：从顶部可选席位**拖拽**到某个 stage，或点席位 →「加入 Stage N」。
|
|
||||||
- **移动 / 重排**：席位可在 stage 间拖动；stage 可整体左右拖动重排（改串行顺序）。
|
|
||||||
- **删除**：席位 / 空 stage 可删。
|
|
||||||
- **并行度提示**：stage 内 ≥2 席位即标「并行」徽标；过多给 warning。
|
|
||||||
- **实时校验**：`validatePlan` 实时跑，错误在顶部红条提示，「保存」在校验通过前禁用。
|
|
||||||
- **预览流程图**：编辑区下方实时渲染只读流程图缩略（复用 §7 的 DAG 流程图组件）。
|
|
||||||
|
|
||||||
> 拖拽可用现成轻量方案（HTML5 DnD 或 `@dnd-kit`，看项目是否已有依赖；没有就先用「点选 + 加入/移出按钮」的无拖拽版，Phase 2 先上无拖拽、Phase 2.5 再加拖拽）。
|
|
||||||
|
|
||||||
### 2.3 可选增强：自由连线画布（后续，非本期必须）
|
|
||||||
|
|
||||||
- 节点自由摆放 + 拉线建边 → `DagGraph`（§1.2）。
|
|
||||||
- 实现成本高（画布 / 连线 / 命中检测 / 自动布局），且分层模型已覆盖绝大多数诉求。**本期不做**，仅在数据模型上预留 §1.2，避免将来返工。
|
|
||||||
|
|
||||||
### 2.4 验收（Phase 2）
|
|
||||||
|
|
||||||
- 能拖 / 点把席位分配到多个 stage，保存进 `step2.orchestrationPlan`。
|
|
||||||
- 刷新 / 重进 draft 能恢复编排。
|
|
||||||
- 非法编排（空 stage / 席位重复 / 席位不在 roster）有明确中文提示且无法保存。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 执行调度（前端编排循环 + 后端复用）
|
|
||||||
|
|
||||||
### 3.1 新增 `runDagOrchestration`（`useStep2Orchestration.ts`）
|
|
||||||
|
|
||||||
与现有 `runOrchestration` / `runChainOrchestration` 并列，逻辑：
|
|
||||||
|
|
||||||
```
|
|
||||||
for (stageIndex, stage of plan.stages):
|
|
||||||
if isStale() break // 复用现有 epoch 抢占（人工干预/暂停）
|
|
||||||
// 1) 总控按本 stage 的席位并行派活（一轮 leader，dispatched = stage.agentIds）
|
|
||||||
// —— 或跳过 leader，前端直接对 stage 内每个席位发起 special run（见 3.2）
|
|
||||||
// 2) 并行跑 stage 内所有席位
|
|
||||||
await Promise.all(stage.agentIds.map(seat =>
|
|
||||||
streamMultiAgent({ agentType:"special", agentName:seat,
|
|
||||||
newMessage: buildStageTask(seat, plan, stageIndex),
|
|
||||||
parallelNoFile: stage.agentIds.length > 1, // §4
|
|
||||||
... })))
|
|
||||||
// 3) 等本 stage 全部 ✅（Promise.all 天然 barrier）再进入下一 stage
|
|
||||||
// 4) finalSynthesis：最后一轮 leader（synthesisMode=true）综合所有 stage 交付
|
|
||||||
```
|
|
||||||
|
|
||||||
要点：
|
|
||||||
- **批内并行**：`Promise.all`（不是现在的 `for await` 串行）。
|
|
||||||
- **批间串行**：`Promise.all` 即 barrier，自动等齐。
|
|
||||||
- **依赖可见性**：进入 stage N 的席位时，把**前面所有 stage 已交付席位的摘要**拼进它的 `newMessage`（复用 §交付状态：网关 `_collect_delivery_status` / `GET last-ai-message?max_chars=N`，前端也可在 stage 边界拉一次摘要拼进 task）。这样 `(B C)` 能看到 `A` 的产出。
|
|
||||||
- **抢占 / 干预 / 暂停**：每个 stage 边界检查 `isStale()`（epoch），与现有自由 / 链条模式一致。
|
|
||||||
- **rollback**：special run 已统一 `multitask_strategy=rollback`，并行多席位各自不同 thread，互不冲突。
|
|
||||||
|
|
||||||
### 3.2 是否每 stage 都走 leader？ — ✅ 已定：前端直派（方案 B）
|
|
||||||
|
|
||||||
**本期采用方案 B**：DAG 由用户**显式**指定，不需要 leader 再"决定派给谁"。前端**直接**对 stage 内每个席位发起 special run，省掉每 stage 的 leader LLM 往返（更快、更可控）；只在所有 stage 完成后、`finalSynthesis` 为真时跑**一轮** leader（`synthesisMode=true`）综合所有交付。
|
|
||||||
|
|
||||||
> （备选方案 A：每 stage 跑一轮 leader 派活——更贴现有架构但每 stage 多一次 leader LLM、更慢。**本期不采用**，留档备查。）
|
|
||||||
|
|
||||||
### 3.3 后端改动
|
|
||||||
|
|
||||||
- **基本不需要新接口**：special run（`POST /api/multi-agent/run/stream` agent_type=special）、leader run、轻量交付读（`GET /threads/{id}/last-ai-message`）、轻量追加（`POST /threads/{id}/messages/append`）都已就绪。
|
|
||||||
- 仅需 §4 的「并行禁写文件」run policy 开关。
|
|
||||||
|
|
||||||
### 3.4 验收（Phase 3）
|
|
||||||
|
|
||||||
- `(B C)` 两席位**同时**出现在执行（后端日志两条 special run 时间重叠；前端两个流并行增长）。
|
|
||||||
- stage 间严格串行（stage 2 不早于 stage 1 全部完成）。
|
|
||||||
- stage N 席位的输入里能看到 stage <N 的交付摘要。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. 并行时禁止写文件（防沙箱打架）
|
|
||||||
|
|
||||||
### 4.1 后端 run policy
|
|
||||||
|
|
||||||
`app/gateway/roundtable_run_policy.py` 现有角色：`leader` / `seat` / `report`。新增一个角色或开关：
|
|
||||||
|
|
||||||
- 方案：给 `seat` 增加一个「并行变体」`seat_parallel`，其 `excluded_tools` 在 `seat` 基础上**再禁** `write_file` / `bash` / `str_replace` / `present_files`（与 `report` 角色禁写的思路一致）。
|
|
||||||
- `_special_run`（`multi_agent.py`）按请求里的一个新 flag（如 `no_file: true`）选择 `seat_parallel` policy。
|
|
||||||
|
|
||||||
### 4.2 前端传参
|
|
||||||
|
|
||||||
- `streamMultiAgent` 请求体新增 `parallel_no_file?: boolean`（或复用 `no_file`）。
|
|
||||||
- `runDagOrchestration` 在 `stage.agentIds.length > 1`（真并行）时置 `true`；单节点 stage（实际串行）不限制，可正常写文件。
|
|
||||||
|
|
||||||
### 4.3 产物归属
|
|
||||||
|
|
||||||
- 并行席位的产物 = **消息正文**（被 `_collect_delivery_status` / 综合块读取）。
|
|
||||||
- 需要落文件 / 画图的（如 Step3 报告、`roundtable-report`）放在**串行的收口阶段**单独跑，不在并行批次里。
|
|
||||||
|
|
||||||
### 4.4 验收（Phase 4）
|
|
||||||
|
|
||||||
- 并行 stage 的席位 run 日志显示 `Excluded ... ['write_file','bash','str_replace','present_files', ...]`。
|
|
||||||
- 并行期间不再出现多个席位抢同一沙箱 / 写文件冲突。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5. 并行执行的前端显示
|
|
||||||
|
|
||||||
### 5.1 布局总览（并行进行时）
|
|
||||||
|
|
||||||
```
|
|
||||||
┌ 多智能体圆桌会商中心 ─────────────────────────────────────────────┐
|
|
||||||
│ [头像条：进行中的并行智能体] [模型选择 ▾] [暂停会商] │
|
|
||||||
│ (情报)● (方案)● (风险)● (执行) … │
|
|
||||||
│ ↑选中 ↑选中 loading hidden │
|
|
||||||
│ ───────────────────────────────────────────────────────────────── │
|
|
||||||
│ ┌─ 方案设计（选中）──────────┐ ┌─ 风险审查（选中）──────────┐ │
|
|
||||||
│ │ 一、整体架构…（流式渲染） │ │ 1. 合规风险 IDFA/OAID… │ │
|
|
||||||
│ │ … │ │ … │ │
|
|
||||||
│ └────────────────────────────┘ └────────────────────────────┘ │
|
|
||||||
└───────────────────────────────────────────────────────────────────┘
|
|
||||||
（左侧"参与角色"栏在并行时整体收起，腾出横向空间放两列消息）
|
|
||||||
```
|
|
||||||
|
|
||||||
### 5.2 关键交互（与需求逐条对齐）
|
|
||||||
|
|
||||||
1. **收起左侧**：并行执行时把左侧「参与角色 / 人工参与」栏整体折叠（一个 `isParallelRunning` 状态控制；非并行恢复）。
|
|
||||||
2. **头像条**：位置在**消息列表上方、模型选择器左侧**。展示**当前并行批次的所有进行中智能体头像**：
|
|
||||||
- **进行中** → 头像加 loading 动画（复用 `DispatchChainModal` 的 `animate-ping` 光环 + `Loader2Icon animate-spin` 角标）。
|
|
||||||
- **已完成** → 打勾（复用现有 `CheckIcon` 角标）。
|
|
||||||
- **选中** → 高亮描边（当前正在主区显示的那 2 个）。
|
|
||||||
3. **主区同时显示 2 个**：被选中的 2 个智能体的消息列表**并排两列**渲染。
|
|
||||||
4. **多于 2 个先隐藏**：未选中的智能体**不渲染 DOM**（见 §6 性能）。
|
|
||||||
5. **点头像切换**：点击未选中的头像 → 把它设为选中之一（替换当前 2 个里的一个，或按"最近点击保留 2 个"的 LRU 策略）；被换下的智能体**停止渲染但继续接流**。
|
|
||||||
|
|
||||||
### 5.3 选中策略 — ✅ 固定 2 列，窄屏降 1 列
|
|
||||||
|
|
||||||
- 维护 `selectedParallelSeats: string[]`，**最多 2**（固定 2 列）。**不做 3+ 列**。
|
|
||||||
- **响应式**：宽屏 2 列并排；窄屏（建议断点 `< 1024px` / `lg`）降为**1 列**，头像条横向滚动切换；此时 `selectedParallelSeats` 仍可存 2 个，但主区只渲染当前 1 个（点头像切换哪个在前）。
|
|
||||||
- 默认选中本批次**最先开始**的（宽屏 2 个 / 窄屏 1 个）。
|
|
||||||
- 点头像：若已选中则取消；未选中则加入（超过上限时按 LRU 踢掉最早选中的）。被换下的席位**停止渲染但继续接流**（§6）。
|
|
||||||
|
|
||||||
### 5.4 验收（Phase 5）
|
|
||||||
|
|
||||||
- 并行时左侧收起、出现头像条、主区两列。
|
|
||||||
- 进行中头像有 loading；完成打勾；选中有高亮。
|
|
||||||
- 点头像能切换主区显示的智能体，且切换是**即时**的（数据已在内存，见 §6）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 6. 流式高性能策略（避免页面卡死）
|
|
||||||
|
|
||||||
> 核心矛盾：N 个并行席位同时高频 `onTextDelta`，若都 setState + Markdown 渲染会卡死。
|
|
||||||
|
|
||||||
### 6.1 全接收、惰性渲染
|
|
||||||
|
|
||||||
- **所有**并行 run 的流都正常订阅（不丢数据）：每个席位的增量文本**累积进 store / ref**（`Map<agentId, { text, status, charCount }>`）。
|
|
||||||
- **只有被选中（主区显示）的席位**才把累积文本挂到 DOM 渲染（Markdown）。
|
|
||||||
- **未选中**席位：只更新内存 + 头像条上的轻量进度（字数 / loading），**不挂载消息 DOM**。
|
|
||||||
- 切换选中时：把该席位已累积的全文一次性渲染 + 继续接增量。
|
|
||||||
|
|
||||||
### 6.2 渲染节流
|
|
||||||
|
|
||||||
- 选中席位的流式渲染**节流/合帧**：用 `requestAnimationFrame` 或 ~50–100ms 批量 flush 累积的 token，而不是每个 token 一次 setState。
|
|
||||||
- Markdown 渲染对"流式中"可降级（纯文本 / 轻量渲染），**完成后**再做完整 Markdown（现有 `MessageBubble` 的 `streaming` 标志可复用：streaming 时简渲、done 后全渲）。
|
|
||||||
|
|
||||||
### 6.3 头像条进度
|
|
||||||
|
|
||||||
- 头像条只显示**廉价**信息：loading 动画 + 可选字数（`charCount`，从内存 Map 取，节流更新，例如每 500ms 刷一次）。不触发消息体渲染。
|
|
||||||
|
|
||||||
### 6.4 数据流（建议结构）
|
|
||||||
|
|
||||||
```
|
|
||||||
streamMultiAgent(seat).onTextDelta(text) →
|
|
||||||
parallelStore.append(seatId, text) // 纯内存累积，O(1)
|
|
||||||
if seatId ∈ selectedParallelSeats: // 仅选中的进 React state（节流）
|
|
||||||
scheduleFlush(seatId) // rAF / 节流 setState
|
|
||||||
else:
|
|
||||||
bumpCharCount(seatId) // 仅更新头像条进度（节流）
|
|
||||||
```
|
|
||||||
|
|
||||||
### 6.5 验收（Phase 6）
|
|
||||||
|
|
||||||
- 6+ 席位并行时页面不卡（输入 / 滚动 / 切换流畅）。
|
|
||||||
- 切到一个之前隐藏的席位，能立刻看到它**到目前为止的全部**输出（证明流没丢、只是没渲染）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 7. 流程图执行态可视化（DAG 版）
|
|
||||||
|
|
||||||
- 把现有 `DispatchChainModal.tsx`（横向**线性**流程图）扩展 / 复刻成 **DAG 流程图**：
|
|
||||||
- 按 stage 分**列**，stage 内席位**纵向并列**，stage 间用连接线。
|
|
||||||
- 节点状态复用 `ChainNodeState`（pending / active / done）+ 现有动画（`animate-ping` / `Loader2Icon` / `CheckIcon`）。
|
|
||||||
- 末尾接 `共识 → 结果绘制` 里程碑（沿用现有）。
|
|
||||||
- 用途：编辑器里的只读预览（§2.2 底部）+ 执行时的总览（可选小窗 / 顶部缩略）。
|
|
||||||
|
|
||||||
```
|
|
||||||
总控 ─▶ ┌ Stage1 ┐ ─▶ ┌ Stage2 ┐ ─▶ ┌ Stage3 ┐ ─▶ 🤝共识 ─▶ 📊报告
|
|
||||||
│ 情报● │ │ 方案✓ │ │ 执行○ │
|
|
||||||
└────────┘ │ 风险● │ └────────┘
|
|
||||||
└────────┘
|
|
||||||
```
|
|
||||||
|
|
||||||
### 7.1 验收（Phase 7）
|
|
||||||
|
|
||||||
- 编辑器底部 / 执行时能看到 DAG 流程图，节点状态随执行实时更新（active/done）。
|
|
||||||
|
|
||||||
### 7.2 实施结论（2026-06-07，✅ 已完成）
|
|
||||||
|
|
||||||
- **新组件** `components/DagFlowChart.tsx`：纯展示组件，复刻 `DispatchChainModal` 的节点 / 连线 / 里程碑视觉（`animate-ping` 光环 + `Loader2Icon` 转圈 + `CheckIcon` 打勾 + `rt-chain-connector` 连线动画），但按 **stage 分列**：总控 ─▶ ┌Stage1┐ ─▶ ┌Stage2┐ ─▶ 🤝共识 ─▶ 📊结果绘制，stage 内席位**纵向并列**。`compact` 紧凑模式给缩略图用。所有状态由 props 传入（`stages` / `resolveSeat` / `seatStates` / `coordinatorState` / `consensusState` / `reportState`）；不传 `seatStates` → 全 pending（只读预览）。`aggregateStageState` 把 stage 内席位聚合成列状态(任一 active→active、全 done→done)驱动 stage 间连线。
|
|
||||||
- **编辑器只读预览**（§2.2 底部）：`BusinessChainEditorPage` 底部加「编排预览」section，把 `stageGroups`(去空 stage) 映射成 `DagFlowChart` 的 stages + `resolvePreviewSeat`(席位名/配色)，`compact`、全 pending、随编辑实时变。
|
|
||||||
- **执行态总览**（Step 2 顶部缩略）：`useStep2Orchestration` 新增 `dagNodeStates: Record<agentId, ChainNodeState>`，`runDagOrchestration` 跨 stage 维护(进入 stage→该批 active、席位终态→done、`resetStep2State` 清空)；经 `RoundtablePlanningPage` 把 `orchestrationMode/orchestrationPlan/dagNodeStates` 传到 `Step2Panel`，dag 模式下会话区顶部 `compact` 渲染 DagFlowChart。总控/共识里程碑状态由 `Step2Panel` 从节点状态 + `isOrchestrating`/`hasConsensus` 派生（中转轮时无席位 active + isOrchestrating → 总控 active）。
|
|
||||||
- 改动文件：`components/DagFlowChart.tsx`(新)、`pages/BusinessChainEditorPage.tsx`、`hooks/useStep2Orchestration.ts`、`components/Step2Panel.tsx`、`pages/RoundtablePlanningPage.tsx`。typecheck 零新增(基线 65)。
|
|
||||||
- **下次实地验收**：①编辑器底部随分层编辑实时画出流程图;②Step2 dag 模式顶部出现缩略流程图,跑起来后当前 stage 列点亮(active 转圈)、完成打勾、中转时总控亮、最后共识亮。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 8. 分步实现计划（每步可独立交付 + 验收）
|
|
||||||
|
|
||||||
| Phase | 内容 | 主要文件 | 依赖 | 可独立验收 |
|
|
||||||
|---|---|---|---|---|
|
|
||||||
| **1** | DAG 数据模型 + 校验 + 持久化字段 | `lib/dag-types.ts`（新）、draft step2 读写 | — | 纯函数单测：`validatePlan` / `chain→dag` 兼容转换 |
|
|
||||||
| **2** | 分层编排编辑器（先无拖拽：点选加入/移出） | `components/DagPlanEditor.tsx`（新）、Step2 模式切换 | P1 | 能编排并保存/恢复，非法编排有提示 |
|
|
||||||
| **2.5** | 编辑器拖拽 | 同上 + `@dnd-kit`（若引入） | P2 | 拖拽分配/重排 |
|
|
||||||
| **3** | `runDagOrchestration`：批内并行 + 批间串行 + 依赖摘要注入 | `hooks/useStep2Orchestration.ts`、`api/multi-agent.ts` | P1 | 后端日志并行 special run 时间重叠；stage 严格串行 |
|
|
||||||
| **4** | 并行禁写文件 run policy | `roundtable_run_policy.py`、`multi_agent.py`、`api/multi-agent.ts` | P3 | 并行 run 的 excluded_tools 含 write_file/bash/... |
|
|
||||||
| **5** | 并行显示骨架：收起左侧 + 头像条 + 两列 + 选中切换 | `components/Step2Panel.tsx`、`components/ParallelSeatStrip.tsx`（新） | P3 | 见 §5.4 |
|
|
||||||
| **6** | 流式高性能：全接收 / 惰性渲染 / 节流 | `hooks/useStep2Orchestration.ts`（parallelStore）、`Step2Panel` | P5 | 见 §6.5（6+ 并行不卡） |
|
|
||||||
| **7** | DAG 流程图执行态可视化 | `components/DagFlowChart.tsx`（复刻自 `DispatchChainModal`） | P2、P3 | 见 §7.1 |
|
|
||||||
| **8** | 边界 / 异常 | 各处 | 全部 | 见 §9 |
|
|
||||||
|
|
||||||
> 落地顺序建议：**P1 → P3 → P4 → P5 → P6**（先把"能并行跑 + 能看 + 不卡"打通），**P2 编辑器**可与 P3 并行开发（先用一份 hardcode/简单 UI 的 plan 驱动 P3 联调），**P7 / P2.5 / 2.3** 作为增强后置。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 9. 边界与异常（Phase 8）
|
|
||||||
|
|
||||||
- **某并行节点失败 / 超时**：单个席位失败不拖垮整 stage；标该节点 error，stage 其余 ✅ 仍推进；收口时把"X 失败"如实告知总控（复用交付状态 ⬜ + 失败标记）。
|
|
||||||
- **依赖未满足**：调度器保证 stage 串行，理论不会发生；防御性校验 stage N 启动前 stage <N 必须全部终态（done/failed）。
|
|
||||||
- **人工干预 / 暂停 / 恢复**：在 stage 边界检查 `isStale()`（epoch）；干预指令插入后，从"下一个未开始的 stage"继续（已完成 stage 不重跑）。
|
|
||||||
- **并行禁写文件 vs 席位本想写文件**：在席位 SOUL / 派活提示里说明"本轮为并行研讨，产出请直接写在回复正文，不要写文件"，降低模型困惑。
|
|
||||||
- **窄屏**：主区两列降为一列 + 头像条横向滚动。
|
|
||||||
- **单 stage 全并行（一次性 N 个）**：给并行度 warning（远程模型并发限流 / 成本）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 10. 与现有代码的衔接点速查
|
|
||||||
|
|
||||||
- 编排循环：`hooks/useStep2Orchestration.ts`（`runOrchestration` / `runChainOrchestration` 旁新增 `runDagOrchestration`；复用 `isStale()` epoch、`abortAllInFlight`、`appendStreamingDialogue` / `appendToDialogue`）。
|
|
||||||
- 流式 API：`api/multi-agent.ts`（`streamMultiAgent`，新增 `parallel_no_file` 入参；`onTextDelta(text, messageId)` 已是按席位回调，天然支持并行分流）。
|
|
||||||
- 显示：`components/Step2Panel.tsx`（消息列表 `step2RoundtableDialogues.map`；新增头像条 `ParallelSeatStrip` + 两列容器 + 折叠左侧）。
|
|
||||||
- 流程图：`components/DispatchChainModal.tsx` / `lib/job-types.ts` / `lib/business-chain.ts`（复刻成 DAG 版）。
|
|
||||||
- 常量 / 元数据：`lib/roundtable-constants.ts`（`BUILTIN_AGENT_META` 头像/中文名、`buildAgentNameToRole`）。
|
|
||||||
- 后端 run policy：`app/gateway/roundtable_run_policy.py`（新增 `seat_parallel`）、`app/gateway/routers/multi_agent.py`（`_special_run` 读 `no_file` flag）。
|
|
||||||
- 交付摘要：`GET /api/threads/{id}/last-ai-message?max_chars=N`（依赖注入 stage N 输入用）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 11. 一句话总结
|
|
||||||
|
|
||||||
把「线性链条」升级为「分层 DAG」：**编辑器**用分层 stage（拖卡片）表达串/并；**调度**用 `Promise.all` 批内并行、批间 barrier 串行，依赖摘要在 stage 边界注入；**并行禁写文件**避免沙箱打架；**显示**收起左侧、头像条切换、主区两列、未选中只接流不渲染（rAF 节流）保证不卡。全部建立在现有 special/leader run + 轻量交付接口之上，后端几乎零新接口。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 12. 已知问题与排查记录（2026-06-06）
|
|
||||||
|
|
||||||
### 12.1 ❗并行席位「步骤条」不显示 —— 根因：`seat_parallel` 工具面禁得过多
|
|
||||||
|
|
||||||
**现象**：并行两列里的席位气泡看不到步骤条（`MessageStepsCard`），而串行席位有。
|
|
||||||
|
|
||||||
**排查结论（已定位，待修）**：
|
|
||||||
|
|
||||||
1. **步骤条只渲染「工具调用」步骤**。`MessageStepsCard` 的 `isToolStep` 只认 `tool_calling:<toolName>` 的步骤进折叠卡；纯阶段步骤（`connecting:` / `streaming:` 这类 reasoning）只渲染成**底部一行小灯泡**，不出大卡（见 `MessageStepsCard.tsx` L80-100）。
|
|
||||||
2. **并行席位几乎调不动任何会产生步骤的工具**。后端 `app/gateway/roundtable_run_policy.py`：
|
|
||||||
- `_SEAT_EXCLUDED = [web_search, ask_clarification, present_files, view_image, agent_orchestration]` —— **注意 `web_search` 对所有席位（串行也）就禁了**（注释「圆桌研讨里联网搜索一律禁用」）。
|
|
||||||
- `_SEAT_PARALLEL_EXCLUDED = _SEAT_EXCLUDED + [write_file, bash, str_replace]`。
|
|
||||||
- 于是并行席位可用工具几乎只剩 `read_file / ls / task / write_todos / memory / hindsight_*`，研究/分析类席位基本一个都不会调 → **没有任何 `tool_calling` 步骤** → 步骤条（大卡）不出现。
|
|
||||||
3. **对比串行为何「有步骤条」**：串行席位（`seat` policy）**能 `write_file`**，会产生 `tool_calling:write_file` 步骤 → 大卡出现。并行被禁了 write_file + 又没有 search，所以一个工具步都没有。
|
|
||||||
|
|
||||||
**用户诉求**：并行时**只禁真正会冲突的写操作**，搜索信息 / 调用技能等**必要操作不要禁**。
|
|
||||||
|
|
||||||
**关键事实（影响方案选择）**：圆桌每个席位是**独立 thread = 独立 sandbox**（后端 per-thread 隔离 `.deer-flow/users/{uid}/threads/{tid}/`）。所以并行席位写文件**在后端并不会互相冲突**；当初 §4「并行禁写文件」的「打架」其实主要是**前端单沙箱预览**（`activeArtifactThreadId` 只能同时显示一个）+ 产物归集到正文的简化考量，并非后端真冲突。→ 这意味着「并行禁写」的必要性比原设想弱，可放宽。
|
|
||||||
|
|
||||||
**✅ 决策：选 A（2026-06-06 已实施）**：把 `seat_parallel` 放宽到**只禁 `write_file / bash / str_replace`**（防前端单沙箱预览串台 + 产物走正文）+ 仍禁 `ask_clarification / present_files / view_image / agent_orchestration`（打断/越权类），但**放开 `web_search` 与技能**（搜索不碰 sandbox；技能靠 `read_file`）。改在 `app/gateway/roundtable_run_policy.py` 的 `_SEAT_PARALLEL_EXCLUDED`（**不再继承** seat 的 web_search 禁用，显式列举），测试 `tests/test_roundtable_run_policy.py` 同步更新（`test_seat_parallel_allows_web_search_and_skills`）。
|
|
||||||
→ 并行席位现在能联网搜索/用技能 → 产生 `tool_calling` 步骤 → 步骤条显示。
|
|
||||||
|
|
||||||
> 备选 B（连写文件也放开，沙箱按 thread 隔离）/ C（重新评估「圆桌串行也一律禁 web_search」）**本期不做**，留档。串行席位目前仍禁搜索（`seat` policy 不变）。
|
|
||||||
|
|
||||||
### 12.2 其它已修（本轮反馈）
|
|
||||||
|
|
||||||
- 最左侧**全局工作区侧栏**并行时收起：改用与「打开沙箱」同一路径 `useSidebarSafe()?.setOpen(false)`（之前只收了圆桌「参与角色」栏 `step2SidebarExpanded`）。并行结束**不自动展开**（与沙箱收起不回弹一致）。
|
|
||||||
- 并行两列改回**完整 Markdown**（撤销 §6.2 流式纯文本降级 `plainWhileStreaming`），与串行同款 `Step2Message`。
|
|
||||||
- 头像条**不再显示字数**（去掉 charCount 徽标 + 字段）。
|
|
||||||
- **致命 bug 已修**：用户干预 / 并行跑完后**不再重跑整张 DAG**。`dagPlanExecutedRef` 闸门 + DAG 各阶段跑完后释放锁 `await runOrchestration(handoff)` 交回总控继续派活/收口；后续干预/恢复一律走 leader 自由派活。
|
|
||||||
- **并行两列宽表溢出已修（2026-06-07）**：模型输出的 Markdown **表格**（如「法律免责条款」表）没有宽度约束 / 横向滚动容器，在并行两列的窄列里会**超出左列、盖到相邻列**。修法：`MessageBubble.sharedMarkdownComponents.table`（+ `markdown-components.tsx`）把 `<table>` 套进 `<div class="max-w-full overflow-x-auto">`——表格保持自然宽度、超出时**列内横向滚动**而非撑破列宽。`min-w-0` 链(grid `minmax(0,1fr)` → 列 `min-w-0` → 气泡 `flex-1 min-w-0`)本就齐全,只差 table 这一层。
|
|
||||||
- **关于「并行席位无步骤条」**：步骤条(`MessageStepsCard` 大卡)只在席位产生 `tool_calling` 步骤时出现(§12.1)。纯分析型席位若本轮**直接写分析正文、没调用任何工具**(web_search 等),就只显示一行「正在输出」思考指示、不出大卡——这是设计使然,非解析失败。要确认是否真调了工具:浏览器 devtools 设 `window.__MULTI_AGENT_DEBUG__=true` 看 `frame# event=messages` 里有无 tool_calls,或查后端 special run 日志。
|
|
||||||
|
|
||||||
### 12.3 ✅需求变更：Stage 间「经总控中转 + 广播」（2026-06-06 提出，2026-06-07 已实施）
|
|
||||||
|
|
||||||
**当前实现（方案 B，§3.2）**：DAG 各 stage 由前端**直接**派活，stage 间不跑 leader，靠前端把 `buildDependencySummary` 拼进下一 stage 的 task（`priorSummary`）。各 stage 跑完后才 `await runOrchestration` 交回总控收口。
|
|
||||||
|
|
||||||
**新诉求**：业务链条调用时，**每一轮 stage 之间都要经总控中转 + 广播**，而不是前端直接串下去。具体：
|
|
||||||
|
|
||||||
1. 第 1 轮并行调用 stage1 的 A、B、C；
|
|
||||||
2. A/B/C **全部完成后**，把这一批的**输出广播出来**（广播给其它席位 + 总控 thread）；
|
|
||||||
3. **总控（leader）接收**这批交付 → 再**往下继续派活**（派 stage2 的 D、E）；
|
|
||||||
4. 派活时把（承上的）消息**广播给下一轮的 D、E**；
|
|
||||||
5. 以此类推，直到所有 stage 跑完再收口。
|
|
||||||
|
|
||||||
> 即把 §3.2 的「方案 B 前端直派」改成 **「方案 A' = 计划约束下的总控中转」**：stage 边界插入一轮 leader，由它综合上一批交付并驱动下一批（下一批席位仍由编排计划**钉死**为 D、E，不是 leader 自由乱派——leader 负责「承上启下 + 广播上下文」，计划负责「派给谁」）。
|
|
||||||
|
|
||||||
**实施要点（下次会话）**：
|
|
||||||
|
|
||||||
- **每个 stage 完成 → 广播该批输出**：后端 `_special_run` 已对每个 seat 做 detached 后广播（「子智能体X完成…交付内容为:…」→ 其它席位 + 总控）。但它是 **detached/best-effort + 截断**；要让总控**可靠**地在下一轮前看到，需在 stage barrier 处**等广播落地**（或前端在 stage 边界用 `GET /threads/{id}/last-ai-message` 主动收齐各席位交付再喂给 leader）。
|
|
||||||
- **插入 leader 中转轮**：`runDagOrchestration` 在进入下一 stage 前，跑一轮 leader（`synthesisMode=true` 让后端注入上一批**完整**交付），让总控产出一段「承上启下」说明；把这段说明（而非机械 `priorSummary`）作为下一 stage 席位 task 的上下文 / 或广播给下一批席位 thread（复用 `POST /threads/{id}/messages/append`）。
|
|
||||||
- **下一批仍由计划钉死**：leader 中转轮**不**自由决定派给谁（计划已定 D、E）；可参考 `buildChainLeaderTask` 的「约束 leader 只派给指定席位」思路，或干脆 leader 只做综合、前端照计划派 D、E 并把 leader 综合 + 广播注入其 task。
|
|
||||||
- **与「并行禁写」「§12.1 放开搜索」并存**：中转/广播不影响工具面。
|
|
||||||
- **与致命 bug 修复并存**：最后一个 stage 跑完仍走「交回总控（`runOrchestration`）收口/继续派活」；用户干预仍走 leader、不重跑 DAG。
|
|
||||||
|
|
||||||
**影响文件（预估）**：`hooks/useStep2Orchestration.ts`（`runDagOrchestration` 的 stage 循环里加 leader 中转 + 广播收齐）、可能复用后端 `_leader_run`（synthesisMode 注入全文）/ `/messages/append`（广播）/ `/last-ai-message`（收齐交付）。后端基本无需新接口。
|
|
||||||
|
|
||||||
**✅ 实施结论（2026-06-07）**：后端**零改动**，全部在前端 `runDagOrchestration` 内完成，复用既有「传摘要按需传全文」优化链路：
|
|
||||||
|
|
||||||
1. **中转轮位置**：每个**非最后**的 stage barrier 到达后（`Promise.all` 收齐本批交付），插入**一轮 leader**「中转轮」，展示为「总控协调（承上启下）」气泡。最后一个 stage 后**不**插中转，综合/收口仍交给末尾的 `runOrchestration` 接管（与致命 bug 修复一致）。
|
|
||||||
2. **可靠收齐交付（传摘要）**：中转轮跑 `streamMultiAgent({agentType:"leader", synthesisMode:false})`。后端 `_leader_run` 本就在每轮 leader 前用 `_collect_delivery_status`（走**轻量 `GET /last-ai-message?max_chars=600` 接口**）**客观核对**各席位真实交付并把**摘要**注入总控输入（`_build_seat_status_block`）——比 detached 广播可靠（直接实读各席位 thread，不依赖 best-effort 广播是否落地）。故中转轮传 `synthesisMode:false`：只综合本批、**不收口**，只注入摘要；**完整交付正文**留到末尾收口的 synthesis 轮（`_build_full_deliverables_block`，全 ✅ 才注入）按需读取——即「**传摘要按需传全文**」。
|
|
||||||
3. **承上启下驱动下一批**：中转轮产出的综合说明存进 `leaderBridge`，作为**下一 stage** 席位 task 的上下文（`buildStageTask({priorSummary: leaderBridge, priorIsBridge:true})`，措辞为「承上启下综合说明」而非机械「交付摘要」），替代原来的 `buildDependencySummary(deliveries)`。中转失败/无产出时回退机械依赖摘要，不阻断。
|
|
||||||
4. **下一批由计划钉死**：中转轮提示（`buildDagTransitTask`）明确告知总控「下一阶段席位已由编排计划钉死为 X、Y，你**不要**自行 `agent_orchestration` 派活、**不要**收口」，前端仍照计划直派下一批；即便弱模型仍派了活，前端忽略其 `dispatched`、只取 `content` 当 bridge。
|
|
||||||
5. **广播**：本批输出广播给其它席位 + 总控 = 后端 `_special_run` 既有 detached 后广播（截断摘要）；承上消息给下一批 = 注入其 task `new_message`（席位 run 输入必见，比 `/messages/append` 更可靠，省一次写盘）。
|
|
||||||
6. **澄清/抢占/失败**：中转轮触发澄清 → 暂停 DAG（回复后走 leader 自由派活、不重跑 DAG，沿用 `dagPlanExecutedRef` 闸门）；被 `isStale()`/abort 抢占 → 静默收尾；异常 → 该气泡标错误、清空 bridge 继续。
|
|
||||||
|
|
||||||
**纯函数**：`lib/dag-types.ts` 新增 `buildDagTransitTask`（中转轮提示）+ `buildStageTask` 加 `priorIsBridge` 形参；`lib/dag-types.test.ts` 加 4 个单测（共 27 个全过）。
|
|
||||||
|
|
||||||
> ⚠️ **§12.3 的「单独中转轮 + 前端直派」已被 §12.4 取代**（2026-06-07 同日）：见下。`buildDagTransitTask` / `buildStageTask` / `buildDependencySummary` 仍保留在 lib（带单测），但 `runDagOrchestration` 不再调用它们。
|
|
||||||
|
|
||||||
### 12.4 ✅ 需求再变更：DAG 改成「总控驱动每 stage 派活」（2026-06-07，§3.2 方案 A）
|
|
||||||
|
|
||||||
**新诉求（用户原话）**：把并行(DAG)逻辑改得和串行一样——串行时总控给多个智能体派活、它们完成后汇报给总控、总控再继续往下派活；并行也改成「由总控判断要执行哪些步骤，这些步骤完成后再汇报给总控，总控继续往下派活」。
|
|
||||||
|
|
||||||
**已确认的两个关键决策**：
|
|
||||||
1. **每批「派给谁」**：✅ **计划钉死成员，但走总控派活**（不是总控自由乱派）。即 stage 成员仍由编排计划定死，但改成总控每轮**真正** `agent_orchestration` 派活给这些席位（约束只派给它们、且每个都派到）。= §3.2「方案 A」+ 批内并行。
|
|
||||||
2. **适用范围**：✅ **只改 dag 模式**（recommend 仍串行逐个、chain 不动）。
|
|
||||||
|
|
||||||
**实现（后端零改动，全在 `runDagOrchestration`）**：每个 stage 两步——
|
|
||||||
- **(a) 总控派活轮**：跑一轮 `leader`，提示 `buildDagStageLeaderTask`（首 stage 带任务背景；后续 stage 靠后端注入的此前交付摘要承上；列出本 stage 钉死席位的 `agent_name`，要求逐个派到、不派清单外、不收口）。`synthesisMode:false` → 后端 `_build_seat_status_block` 走轻量 `last-ai-message` 注入各席位**摘要**（传摘要按需传全文）。
|
|
||||||
- **(b) 批内并行**：本 stage 席位并行跑总控派给各自的 task——`pickDagSeatTask(leaderRes.dispatched, content, agentId, name)` 命中其 `agent_name`；总控漏派/写偏则回退总控正文/模板，**不借用别席位 task**（多席位并行避免张冠李戴）。完成后交付经后端 `_special_run` detached 后广播回总控；下一 stage 的派活轮即可看到。
|
|
||||||
- barrier 后进入下一 stage，总控再派下一批。全部 stage 跑完 → 交回 `runOrchestration` 收口（synthesisMode 按需注入全文）。
|
|
||||||
|
|
||||||
**相比 §12.3 的变化**：§12.3 是「前端直派 + stage 间单独插一轮只综合的中转轮」；§12.4 把**每个 stage 本身**就改成「总控派活轮 + 批内并行」——总控既承上（注入的摘要）又派活，不再需要单独的中转轮。与 chain 模式同构，区别是一次钉死一批、批内并行。
|
|
||||||
|
|
||||||
**纯函数**：`lib/dag-types.ts` 新增 `buildDagStageLeaderTask`（每 stage 派活提示）+ `pickDagSeatTask`（取某席位 task，多席位不张冠李戴）；`lib/dag-types.test.ts` 加 5 个单测（共 32 个全过）。`runDagOrchestration` 不再用 `buildStageTask/buildDependencySummary/buildDagTransitTask`（保留在 lib）。
|
|
||||||
|
|
||||||
**Phase 7 流程图兼容**：总控派活轮无席位 active + `isOrchestrating` → 流程图「总控」节点显示 active（承上派活中），随后该 stage 列点亮，无缝衔接。
|
|
||||||
|
|
||||||
**下次实地验收**：①每个 stage 前出现「总控协调（派活中/承上派活中）」气泡,内容是总控对本 stage 席位的派活说明;②后端日志该轮 leader 的 `_partition_dispatch` 派给的正是本 stage 钉死席位;③这些席位并行跑(special 日志时间重叠);④完成后下一 stage 总控派活轮能看到上一批交付摘要(`[leader-roster]` 日志)。
|
|
||||||
|
|
||||||
### 12.5 ✅ 流程图弹窗化 + DAG「快速/沙箱」执行子模式（2026-06-07）
|
|
||||||
|
|
||||||
三个改动一起做:
|
|
||||||
|
|
||||||
**(1) 流程图改成弹窗**:Step2 顶部不再内联 `DagFlowChart`(挤占两列消息高度,截图 `样式优化-1.png`)。改成一条细栏「分层编排执行中 · 共 N 个阶段 ＋ [查看编排流程图]」按钮,点开 `Dialog` 看**全尺寸**流程图(非 compact)。编辑器(`BusinessChainEditorPage`)底部预览保持内联不变。改 `Step2Panel.tsx`(加 `dagFlowOpen` state + Dialog)。
|
|
||||||
|
|
||||||
**(2) 推荐弹窗新增 DAG 执行子模式(快速/沙箱)**:`BusinessChainPicker` 在选中链条**有分层并行**(走 dag)时,「进入研讨」旁出现「执行方式:快速·双列禁写 / 沙箱·单列可写」二选一(只 dag 时出现,§已确认)。
|
|
||||||
- **快速(`fast`,默认)**:同 stage 席位**并行**、主区**双列**、`parallelNoFile=true`(seat_parallel **禁写文件**)。= 之前的行为。
|
|
||||||
- **沙箱(`sandbox`)**:同 stage 席位**仍并行**,但主区**单列**(`selectedParallelSeats` 最多 1)、`parallelNoFile=false`(seat policy **允许写文件**);点头像切换查看,沙箱跟随当前席位。
|
|
||||||
- 数据流:`SeatSelectionResult.dagExecMode` → `RoundtablePlanningPage` state(持久化进 `DraftStep2(Run)Snapshot.dagExecMode`,mirror orchestrationPlan)→ `useStep2Orchestration` option → `runDagOrchestration`。
|
|
||||||
|
|
||||||
**(3) 沙箱跟随当前显示席位(防 bug 重点,用户特别强调)**:`useStep2Orchestration`
|
|
||||||
- `sandboxFollowThreadIdRef` = 当前显示席位的 thread;`openSeatVirtualArtifact` 的 auto 守卫:sandbox 模式下,**后台并行席位**写文件时若不是当前显示席位,**不自动打开**(否则沙箱内容和主区列表错位)。
|
|
||||||
- 切换显示席位的 effect(keyed on `selectedParallelSeats` + `dagExecMode`):该席位**有产物**(stub 里有 write_file/str_replace)→ `openSeatLatestArtifact` 强制打开它最新的文件;**无产物**→ 关闭沙箱面板(`setActiveArtifactThreadId(null)` + `deselectArtifact` + `setArtifactsOpen(false)`)。
|
|
||||||
- 当前显示席位 live 写文件 → `handleArtifactToolPhase` auto-open,守卫放行(follow===该席位)。后台席位写 → 守卫拦掉、只缓存 stub;切到它时 effect 再打开。
|
|
||||||
- `toggleParallelSeat`:sandbox 单列 = 点头像切换(始终保留 1 个,不取消到空);fast 双列 = 原 LRU 2 个。
|
|
||||||
|
|
||||||
**改动文件**:`lib/business-chain.ts`(SeatSelectionResult.dagExecMode)、`components/BusinessChainPicker.tsx`(子模式 UI)、`api/drafts.ts`(快照 dagExecMode)、`pages/RoundtablePlanningPage.tsx`(state/snapshot/hydrate/confirm/reset 全链)、`hooks/useStep2Orchestration.ts`(option + parallelNoFile/单列 + 沙箱跟随 + toggle cap)、`components/Step2Panel.tsx`(流程图弹窗 + 单列 grid)。typecheck 零新增(基线 65),dag-types 32 单测全过。
|
|
||||||
|
|
||||||
**下次实地验收(沙箱跟随是重点)**:①推荐弹窗选有并行的链条 → 出现「快速/沙箱」二选一;②快速=双列禁写(无沙箱);③沙箱=单列、席位能写文件、点头像切换列表时沙箱内容**同步**切换:有产物显示、无产物关闭;④后台席位写文件不会把沙箱抢到非当前列表;⑤流程图点按钮弹窗、全尺寸、节点随执行点亮。
|
|
||||||
|
|
||||||
### 12.6 ✅ 修:并行席位「跟着派活」（2026-06-07）
|
|
||||||
|
|
||||||
**现象**(截图 `bug-1.png`):总控派活后,并行席位的气泡里显示的是**总控的整段派活叙述**(「我来调度各智能体…第1阶段任务清单:席位1…席位2…」),还去调 `skill_list` 找 `agent_orchestration`——席位在**模仿派活**。
|
|
||||||
|
|
||||||
**根因**:总控这轮**没真正调用 `agent_orchestration` 工具**(弱模型 deepseek 用文字罗列了派活计划)→ 后端解析的 `dispatched=[]` → 前端 `pickDagSeatTask` 回退把**总控整段叙述**喂给**每个**席位 → 席位照抄叙述、模仿派活。(席位本就被 run policy 禁了 `agent_orchestration`,**派不了活**,只是空转一轮叙述 + 调 `skill_list`。)
|
|
||||||
|
|
||||||
**修 v1(护栏,效果不足)**:`pickDagSeatTask` 加角色边界护栏 + 回退措辞改「挑出属于你的那份」;`buildDagStageLeaderTask` 加「必须真正调用工具」。→ **没拦住**:总控对 deepseek 仍只写文字不调工具(`dispatched` 还是空),席位拿到的**任务正文本身**就是那段「我来调度…席位1/2/3」,护栏被淹没;3/4 席位仍模仿派活,有的甚至绕道 `bash`+`python requests.get('/api/agents')` 调内部接口派活(bug-1~4)。
|
|
||||||
|
|
||||||
**✅ 修 v2(根治:回退绝不注入派活叙述)**:`pickDagSeatTask` 去掉 `leaderContent` 入参——
|
|
||||||
- **命中**总控结构化派活(真调了工具)→ `请你作为「X」，完成总控派给你的本阶段任务：<dispatched task>` + 护栏;
|
|
||||||
- **未命中 / `dispatched` 空**(总控只写文字)→ **绝不**把总控派活叙述喂给席位,改给**干净本职任务**:「请你作为「X」,从你的专业职责出发,独立完成本阶段属于你的分析与交付。任务背景与此前各阶段交付已在你的会话上下文里(后端广播注入),据此承接」+ 护栏。护栏强化到「不要用 bash/python/脚本访问内部接口(/api/agents、agent_orchestration)派活、不要复述『我来调度』总控口吻」。
|
|
||||||
- `buildDagStageLeaderTask` 的「必须真正调用工具」保留(让命中率更高、尽量走 exact-match)。
|
|
||||||
- `dag-types.test.ts` 改 2 单测(共 33 过)。typecheck 65。
|
|
||||||
|
|
||||||
> ⚠️ **残留次要污染源(若仍复发再处理)**:DAG 每个 stage 的 leader 轮,后端 `_leader_run` 会把 leader 的输入(含「请你作为总控…派活」)**预广播**进所有席位线程(`总控智能体收到用户消息:…`)。席位的**当轮任务**已干净(修 v2),这条只是历史上下文,理论上被「最新的干净任务 + 护栏」压制。若实测仍模仿派活,下一步:后端给 DAG leader 轮加 `suppress_pre_broadcast` / 或广播一条**净化**过的背景(去掉派活措辞)。
|
|
||||||
|
|
||||||
### 12.7 ✅ 修 4 项(2026-06-07):席位仍派活(v3 后端)+ 沙箱关不掉 + 并行不自动下滑 + 流程图只到 Step2
|
|
||||||
|
|
||||||
实测 §12.6 仍有席位派活(视觉设计师 `skill_manage` 找 agent-orchestration、列 dispatch all 4)——**坐实**了「残留次要污染源」:后端 leader 预广播把派活 prompt 推进席位线程,弱模型从历史里捡到派活意图。一起修了 4 项:
|
|
||||||
|
|
||||||
1. **席位仍派活(根治·后端)**:`_leader_run` 加 `suppress_pre_broadcast` 参数;DAG「每 stage 派活轮」前端传 `suppressPreBroadcast: true`(`api/multi-agent.ts` → `suppress_pre_broadcast`,run/stream 读取)。为真时:**不**把总控派活 prompt 预广播给席位、**也不**把「总控给 X 派活」detached 广播给兄弟席位。recommend/chain 不传该 flag,行为不变。配套:`pickDagSeatTask` 加 `seedMessage` 入参——预广播抑制后席位线程没有用户原始消息了,把**任务背景**直接写进席位 task(此前各阶段交付仍由 special 完成后广播注入)。→ 席位线程里**任何地方都没有派活语句**,根治模仿。
|
|
||||||
2. **沙箱关闭按钮关不掉**:沙箱跟随 effect 之前每次 render(deps 身份变)都重跑 → 把用户刚关的沙箱强制重开。加 `lastReconciledSeatRef` 守卫:**只在显示席位真正变化时**才开/关沙箱;用户手动关闭(席位没变)时 effect 早退,不再回弹。
|
|
||||||
3. **并行时自动下滑失效**:平铺列表 ↔ 网格(两列/单列)切换时 `scrollHeight` 突变、`scrollTop` 被浏览器 clamp → `useAutoScroll` 误判「用户上滚」而停跟随。`Step2Panel` 加 effect:`isParallelRunning` / `selectedParallelSeats` 变化时 `scrollStep2ToBottom()` 重新拉到底 + 恢复跟随。
|
|
||||||
4. **流程图只展示 Step2**:`DagFlowChart` 加 `showReportMilestone`(默认 true);Step2 弹窗 + 编辑器预览传 `false` —— 只到「共识」(Step2 终点),去掉「结果绘制」(那是 Step3)。
|
|
||||||
|
|
||||||
**改动**:后端 `multi_agent.py`(`_leader_run` suppress 两处广播 + run/stream 读 flag);前端 `api/multi-agent.ts`、`lib/dag-types.ts`(pickDagSeatTask + seedMessage)、`hooks/useStep2Orchestration.ts`(传 flag + seed + 沙箱跟随守卫)、`components/Step2Panel.tsx`(自动下滑 effect + showReportMilestone)、`components/DagFlowChart.tsx`、`pages/BusinessChainEditorPage.tsx`。`dag-types.test.ts` 共 **34 单测过**;前端 tsc 65 基线零新增;后端 `py_compile` OK。
|
|
||||||
|
|
||||||
### 12.8 ✅ 席位产出 md 文件 + 禁写 .py（2026-06-07）
|
|
||||||
|
|
||||||
**现象**:某次 7 席位**全都没产出 md 文件**;且一直有的问题——席位**有时写 .py 脚本**(用户要求:不写 .py,其它格式可以)。
|
|
||||||
|
|
||||||
**根因(没 md)**:两层都堵了——(a)**快速模式** `seat_parallel` policy 禁了 `write_file`(原「产物走正文」设计);(b)DAG 席位**提示词**写的是「直接输出你的交付正文」,即使沙箱模式(允许写)也不会去写文件。
|
|
||||||
|
|
||||||
**修**:
|
|
||||||
1. **后端 policy 放开写文件、统一禁 bash**(`roundtable_run_policy.py`):
|
|
||||||
- `seat_parallel`:去掉 `write_file` / `str_replace` 禁用(**可写 md**),保留禁 `bash` + 打断/越权类;仍放开 `web_search`。
|
|
||||||
- `seat`:新增禁 `bash`(原来允许)——圆桌席位是「文档产出者」,不该跑 shell/python 脚本(弱模型爱写 .py 再跑生成产物,乱且抓不到预览);改为**直接 write_file 写成品文档**。
|
|
||||||
- `report`:`bash` 已随 `seat` 禁,改为 `[*_SEAT_EXCLUDED, "str_replace"]`(集合不变)。
|
|
||||||
- 测试 `test_roundtable_run_policy.py`:`test_seats_can_write_files_but_not_run_bash`(seat / seat_parallel 都可写文件、都禁 bash),6 用例过。
|
|
||||||
2. **前端提示词**(`pickDagSeatTask`)加「产物要求」:**把完整交付写成一个 .md 文件**(write_file 到 outputs)+ 正文给摘要;**禁写 .py 或任何脚本文件**,.md/.html/.txt 等其它格式都可以,唯独不要 .py。
|
|
||||||
3. **快速模式(双列)不自动开沙箱**(`openSeatVirtualArtifact` 新增守卫):放开写文件后,双列里多席位并发写文件会让单沙箱预览反复串台——fast 模式 DAG 并行批次**完全不自动开沙箱**(文件仍写盘,Step3/文件卡可查看);沙箱模式(单列)仍按「沙箱跟随当前席位」预览。
|
|
||||||
|
|
||||||
**关于 .py 的强度**:`write_file` 是全局工具(所有 agent 共用),无法在网关层按扩展名硬拦,故 .py 禁止走**提示词**(强约束)+ **禁 bash**(写了也跑不了,脚本生成产物的动机被掐断)。若实测仍偶发写 .py 且需**硬拦**,下一步:给 lead_agent 的 `write_file` 工具加一个「按 run context 禁某些扩展名」的开关,网关 `_run_payload` 对圆桌席位置 `[".py"]`(只影响圆桌 run,不动其它 agent)。
|
|
||||||
|
|
||||||
**改动**:`roundtable_run_policy.py`、`test_roundtable_run_policy.py`、`lib/dag-types.ts`、`lib/dag-types.test.ts`(35 过)、`hooks/useStep2Orchestration.ts`。前端 tsc 65、后端 py_compile OK + 6 policy 单测过。⚠️ **改了后端,需重启 Gateway**。
|
|
||||||
|
|
||||||
### 12.9 ✅ 席位「按需取前序全文」只读工具 read_peer_delivery（2026-06-07）
|
|
||||||
|
|
||||||
**诉求**:A,B,C → D,E 时,D,E 默认拿 A,B,C 的**摘要**,但识别到需要**全文**时也能取到。之前只有总控(leader)能「摘要默认+按需全文」(跨 thread 读),下游席位**不能**(席位间 thread 隔离、只有 1500 字截断广播)。
|
|
||||||
|
|
||||||
**实现**(真·按需,全文只在调用工具时才进 LLM 上下文):
|
|
||||||
1. **新 harness 只读工具** `read_peer_delivery(seat_name)`(`packages/harness/deerflow/tools/builtins/roundtable_peers_tool.py`):从 `runtime.context["roundtable_peer_deliveries"]`(网关注入的 `[{name,content}]`)按席位名取全文;空名→列出可取席位;非圆桌场景→「无」。只读 context dict,**不跨 thread、不碰 sandbox、无网络**,纯 `deerflow.*`(不违反 harness→app 防火墙)。注册进 `tools/tools.py` 的 builtin(始终在,只读无副作用)。
|
|
||||||
2. **网关注入 context**:`_run_payload` 加 `extra_context`;`_special_run` 收 `peer_deliveries` → 注入 `context.roundtable_peer_deliveries`;run/stream 读 `peer_deliveries`(规整 `[{name,content}]`)。**不进 prompt → 不调工具就不耗 token**。
|
|
||||||
3. **run policy**:`read_peer_delivery` 从 `leader`(总控自己跨 thread 读,不需要)+ `report`(Step3 不读前序)排除;**席位(seat/seat_parallel)保留**。
|
|
||||||
4. **前端**:`runDagOrchestration` 跨 stage 累积**完整交付** `priorDeliveries`,stage>0 席位的 special run 带 `peerDeliveries`(`api/multi-agent.ts` → `peer_deliveries`);`pickDagSeatTask` 加 `hasPeers` 形参,有前序时在 task 里提示「需要某前序席位全文时调用 read_peer_delivery('<名>'),平时用摘要」。
|
|
||||||
|
|
||||||
**最终语义**:D、E 默认看 A、B、C 的**摘要**(1500 字广播);识别到不够 → 调 `read_peer_delivery('情报收集')` 取**全文**。总控仍是摘要默认+综合轮全文。**= 用户要的「摘要默认、按需全文」对席位也成立了。**
|
|
||||||
|
|
||||||
**改动**:后端 `roundtable_peers_tool.py`(新)、`tools/tools.py`、`roundtable_run_policy.py`、`multi_agent.py`;前端 `api/multi-agent.ts`、`lib/dag-types.ts`、`lib/dag-types.test.ts`(36 过)、`hooks/useStep2Orchestration.ts`。前端 tsc 65;后端 py_compile OK + 6 policy 单测过 + 工具导入/行为 smoke 通过。⚠️ **改了后端 + 新增 harness 工具,需重启 Gateway**。
|
|
||||||
|
|
||||||
### 12.10 ✅ 修:沙箱模式第一个席位不自动开沙箱（2026-06-07，前端）
|
|
||||||
|
|
||||||
**现象**:沙箱(单列)模式并行时,**第一个**席位的消息列表不自动打开沙箱(要手动开);切换到其它席位时正常自动打开。
|
|
||||||
|
|
||||||
**根因**:沙箱跟随 effect(§12.5)在选中席位**还没写产物**时走「关闭沙箱」分支,里面同时调了 `deselectArtifact()` **和** `setArtifactsOpen(false)`。后者是 context 的 **wrapped setOpen**(`context.tsx:73`):`关闭时若 autoOpen 为真 → 把 autoOpen 置 false`。于是第一个席位刚选中(还没写文件)→ autoOpen 被关 → 该席位**随后 live 写文件**时,`openSeatVirtualArtifact` 的 `!flags.autoOpen` 守卫拦掉自动打开。切换到**已写过**文件的席位能开,是因为那条路走 `openSeatLatestArtifact`(force,auto=false,绕过 autoOpen 守卫)。
|
|
||||||
|
|
||||||
**修**(一行):关闭分支只保留 `deselectArtifact()`(它走 raw `setOpen(false)`,**不**动 autoOpen),删掉多余的 `setArtifactsOpen(false)`。这样面板关掉、但 autoOpen 仍为真 → 第一个席位 live 写文件时正常自动开沙箱。(若用户**手动**关过沙箱,autoOpen 本就为 false,不会自动重开 —— 尊重用户。)改 `hooks/useStep2Orchestration.ts` 沙箱跟随 effect。tsc 65。
|
|
||||||
|
|
||||||
### 12.11 ✅ 修:快速模式又生成文件了 + Fragment 警告（2026-06-07）；记录无关 404
|
|
||||||
|
|
||||||
1. **快速模式不应生成文件(回退 §12.8 的过度放开)**:§12.8 为「让席位产 md」把 `seat_parallel`(快速模式)也放开了 write_file —— 但**快速模式(双列)的设计就是产物走正文、不写文件**,写文件归**沙箱模式**(单列 + 沙箱预览)。修:
|
|
||||||
- `roundtable_run_policy.py`:`seat_parallel` 重新**禁 write_file / str_replace**(保留禁 bash);`seat`(沙箱模式)仍可写。
|
|
||||||
- `useStep2Orchestration.ts`:`parallelNoFile = dagExecMode !== "sandbox"`(快速模式一律禁写,含单节点 stage;沙箱模式放开)。
|
|
||||||
- `pickDagSeatTask` 加 `allowFiles` 形参:沙箱(true)=写 .md 文件 + 禁 .py;快速(false)=产物走正文、不写文件。hook 按 `dagExecMode === "sandbox"` 传。
|
|
||||||
- 测试:`test_sandbox_seat_writes_files_fast_parallel_does_not`(6 过);`dag-types.test.ts` 拆成沙箱/快速两个产物要求用例(37 过)。
|
|
||||||
- **语义**:快速=双列、产物走正文、不写文件;沙箱=单列、写 .md、沙箱跟随预览。
|
|
||||||
2. **`Invalid prop data-lov-id supplied to React.Fragment`**:`DagFlowChart` 的 stage 循环用了具名 `<Fragment key>`,dev 代码标注插件(lovable-tagger)给它注入 `data-lov-id`,而 Fragment 只接受 key/children → React 警告。修:换成 `<div className="contents" key=...>`(display:contents 不生成盒子,Connector/StageColumn 仍是外层 flex 直接子项,布局不变,且能接收 data-*)。移除 `Fragment` import。
|
|
||||||
3. **(无关,非本期引入)`/api/getTokenByEmail?email=…%40local.deerflow` 404 ×60**:来自 `src/core/studio/api.ts` 的 `fetchStudioToken`(studio/expert-auth 引导),用户邮箱被映射到 legacy `@local.deerflow` 域、后端 `getTokenByEmail` 不认 → 404,React Query 跨多个 `useStudioToken` 调用点重试 → 重复多次。**与圆桌 DAG 改动无关**(圆桌头像是本地 SVG,本期未新增任何前端 GET)。需要的话单独排查 studio token 链路。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 13. 实施进度（截至 2026-06-06，下次会话续）
|
|
||||||
|
|
||||||
| Phase | 内容 | 状态 |
|
|
||||||
|---|---|---|
|
|
||||||
| 1 | DAG 数据模型 + 校验 + 持久化字段（`lib/dag-types.ts`，24 单测） | ✅ 完成 |
|
|
||||||
| 2 | 分层编辑器（**做进业务链条页**）：链条加 `stages` 字段（前后端 + alembic `20260607_03` + 11 后端单测）；`BusinessChainEditorPage` 竖列分组 Stage（DnD + 按钮）；纯逻辑 `lib/chain-stages.ts`（19 单测） | ✅ 完成 |
|
|
||||||
| 3 | `runDagOrchestration`：批内 `Promise.all` 并行 + 批间 barrier 串行 + 依赖摘要注入（方案 B 前端直派） | ✅ 完成 |
|
|
||||||
| 4 | 并行 run policy `seat_parallel`（`roundtable_run_policy.py` + `multi_agent.py` 读 `parallel_no_file`，6 后端单测）；**§12.1 方案 A 已放开 web_search/技能** | ✅ 完成 |
|
|
||||||
| 5 | 并行显示：收起左侧 + 头像条 + 两列 + 选中切换 | ✅ 完成（本轮修了侧栏/Markdown/字数） |
|
|
||||||
| 6 | 流式高性能：ref 全量累积 + 节流 flush（仅选中渲染） | ✅ 完成 |
|
|
||||||
| 7 | DAG 流程图执行态可视化（`DispatchChainModal` 复刻成按 stage 分列；后改成**弹窗**见 §12.5） | ✅ 完成（2026-06-07） |
|
|
||||||
|
|
||||||
**端到端闭环已通**：链条页编排分层 → 存库 → 选链条进 Step2 → `runDagOrchestration` 并行直派 → 各阶段完交回总控派活/收口。
|
|
||||||
|
|
||||||
**✅ §12.3 已实施（2026-06-07）**：见 §12.3「实施结论」。`runDagOrchestration` 在每个非末尾 stage barrier 后插入 leader 中转轮（`synthesisMode:false` 走轻量 `last-ai-message` 注入摘要、收口轮才按需全文），承上启下驱动下一批；后端零改动；`dag-types.ts` 加 `buildDagTransitTask` + `buildStageTask.priorIsBridge`，27 单测全过。
|
|
||||||
|
|
||||||
**下次会话 TODO（优先级从高到低）**：
|
|
||||||
1. **运行时实地验收 §12.3**：①每个 stage 之间出现「总控协调（承上启下）」气泡，内容是对上一批的综合；②后端日志中转轮 `[leader-roster] ... 注入席位交付状态` 显示上一批 ✅、未跑的 ⬜；③下一 stage 席位 task 里带的是总控承上说明（非机械摘要）；④中转轮不应真的派活（即使派了前端也忽略）。
|
|
||||||
2. 运行时实地验收（旧）：①§12.1 后并行席位能搜索、步骤条显示；②并行 special 日志时间重叠 + `Excluded` 不含 web_search 含 write_file；③用户干预后是「总控派活」而非重跑 DAG；④最左全局侧栏 + 参与角色栏并行收起且不回弹。
|
|
||||||
3. **✅ Phase 7 DAG 流程图可视化已完成（2026-06-07）**：见 §7.2。`DagFlowChart` 组件 + 编辑器只读预览 + Step2 执行态缩略(`dagNodeStates` 实时驱动)。
|
|
||||||
4. （可选）串行也确定性注入上一轮交付摘要。
|
|
||||||
|
|
||||||
**关键文件速查**：
|
|
||||||
- 前端：`hooks/useStep2Orchestration.ts`（`runDagOrchestration` / `dagPlanExecutedRef` / 并行 store+flush）、`components/Step2Panel.tsx`（两列+头像条）、`components/ParallelSeatStrip.tsx`、`lib/dag-types.ts`、`lib/chain-stages.ts`、`pages/BusinessChainEditorPage.tsx`、`pages/RoundtablePlanningPage.tsx`（侧栏收起 effect + handleConfirmAgents dag 分支）、`components/BusinessChainPicker.tsx`（链条→dag）。
|
|
||||||
- 后端：`app/gateway/roundtable_run_policy.py`（`seat_parallel`，**待放宽**）、`app/gateway/routers/multi_agent.py`（`_special_run` 读 `parallel_no_file`）、`persistence/roundtable_chains/`（`stages` 列）、`migrations/versions/20260607_03_chain_stages.py`。
|
|
||||||
- 测试：`frontend-web` 用 esbuild 转译 `.test.ts` 后 `node --test`（项目无 vitest）；后端 `PYTHONPATH=. uv run pytest tests/test_roundtable_chain_stages.py tests/test_roundtable_run_policy.py`。
|
|
||||||
|
|
||||||
@@ -1,207 +0,0 @@
|
|||||||
# 圆桌 Step 2 沙箱预览 · 开发进度
|
|
||||||
|
|
||||||
> 最后更新：2026-05-27
|
|
||||||
> 关联文档：`multi-agent-frontend-dev.md`（总览）、`multi-agent-backend-dev.md`（后端）、`multi-agent-api.md`（接口）
|
|
||||||
> 对照参考：主聊天 `/page/workspace/chats/:threadId`（`ChatBox` + `ArtifactsProvider` + `message-group.tsx`）
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 目标
|
|
||||||
|
|
||||||
在 Step 2「多智能体圆桌研讨」中，当子智能体调用 `write_file` / `str_replace` / `present_files` 时，**行为与主聊天一致**：
|
|
||||||
|
|
||||||
| 能力 | 主聊天 | Step 2 目标 |
|
|
||||||
|------|--------|-------------|
|
|
||||||
| `write_file` 流式期间自动打开右侧沙箱 | ✅ | ✅ 虚拟 URL |
|
|
||||||
| 步骤卡里点击文件路径打开沙箱 | ✅ | ✅ |
|
|
||||||
| 消息下方文件卡片（`present_files`）点击打开 | ✅ | ✅ `PresentFilesRow` |
|
|
||||||
| 沙箱打开时收起 workspace 左侧栏 | ✅（`ArtifactsProvider.select`） | ✅ Step 2 左栏联动 |
|
|
||||||
| 60/40 对话 \| 产物预览分栏 | ✅ `ChatBox` | ✅ `Step2SandboxLayout` |
|
|
||||||
| 流式 MD 从 tool_call.args.content 预览 | ✅ 虚拟 URL + stub messages | ✅ `seatStubMessages`（双通道：`onPhaseChange` + `onUpstreamFrame`） |
|
|
||||||
| 落盘后 HTTP 拉取真实文件 | ✅ artifacts API | ✅ `present_files` 卡片走 HTTP |
|
|
||||||
| 草稿 reload 后历史文件可预览 | ✅ | ✅ `seatStubMessages` 一并入草稿 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 已完成
|
|
||||||
|
|
||||||
### 2.1 Step 2 布局调整
|
|
||||||
|
|
||||||
| 项 | 状态 | 说明 |
|
|
||||||
|----|------|------|
|
|
||||||
| 推理模型下拉 | ✅ | 从右侧栏迁至 Step 2 顶栏「多智能体圆桌会商中心」右侧 |
|
|
||||||
| 意图理解 | ✅ | 移至左侧栏顶部，支持展开/收起；收起时仅显示「目标」 |
|
|
||||||
| 任务概览 | ✅ | 放在「人工参与」下方 |
|
|
||||||
| 右侧栏 Step 2/3 隐藏 | ✅ | `RightSidebar` 仅在 `currentStep === 1` 渲染 |
|
|
||||||
| 左侧栏整体收起 | ✅ | 宽度 56px；展开按钮在顶部；研讨中角色 ring + ping 动画 |
|
|
||||||
| 沙箱打开 → 左栏收起 | ✅ | `Step2SandboxSidebarSync` 监听 `useArtifacts().open` |
|
|
||||||
|
|
||||||
**主要文件**：`RoundtablePlanningPage.tsx`（`step2SidebarExpanded`、`LeftSidebar`、`Step2SandboxSidebarSync`）
|
|
||||||
|
|
||||||
### 2.2 沙箱基础设施（Phase 1）
|
|
||||||
|
|
||||||
| 项 | 状态 | 说明 |
|
|
||||||
|----|------|------|
|
|
||||||
| 路由包 `ChatRuntime` | ✅ | `WorkspaceRoutes.tsx` → `roundtable/planning` 外包 `ArtifactsProvider` |
|
|
||||||
| 60/40 分栏壳 | ✅ | `Step2SandboxLayout.tsx`，对齐 `chat-box.tsx` |
|
|
||||||
| `ArtifactFileDetail` / `ArtifactFileList` | ✅ | 嵌在右栏 ResizablePanel |
|
|
||||||
| `ThreadContext` stub | ✅ | 最小 `BaseStream` stub，供 `useArtifactContent` 工作 |
|
|
||||||
|
|
||||||
### 2.3 沙箱打开逻辑（Phase 2）
|
|
||||||
|
|
||||||
| 项 | 状态 | 说明 |
|
|
||||||
|----|------|------|
|
|
||||||
| `write_file` 自动打开 | ✅ | `handleArtifactToolPhase` 在 `tool_calling` + 完整 `args.path` 时触发 |
|
|
||||||
| 步骤卡点击打开 | ✅ | `MessageStepsCard` → `openArtifactFromStep` |
|
|
||||||
| 虚拟 URL 机制 | ✅ | `write-file:<path>?message_id=...&tool_call_id=...`（对齐主聊天） |
|
|
||||||
| Stub messages 注入 | ✅ | `seatStubMessages` + `upsertSeatToolCall` → `loadArtifactContentFromToolCall` |
|
|
||||||
| 重置清理 | ✅ | `resetStep2State` 清空 artifacts / stub / deselect |
|
|
||||||
| `present_files` 步骤点击 | ✅ | 走真实路径 `openArtifactPreview`（HTTP API） |
|
|
||||||
|
|
||||||
### 2.4 上游帧兜底注入（Phase 3）
|
|
||||||
|
|
||||||
| 项 | 状态 | 说明 |
|
|
||||||
|----|------|------|
|
|
||||||
| `onPhaseChange` 主通道 | ✅ | `tool_calling` 阶段每帧把完整 `args` 喂进 stub；首次出现 `path` 即触发自动打开 |
|
|
||||||
| `onUpstreamFrame` 兜底通道 | ✅ | `handleUpstreamFrame` 扫描 messages-tuple 帧的 `tool_calls[]`，对 `write_file`/`str_replace` 持续 upsert `args.content`；覆盖 phase 已切走但 tool_calls 又回包的边界 |
|
|
||||||
| 双通道幂等 | ✅ | `upsertSeatToolCall` 按 `(toolName, path)` 去重，两个通道并发写入安全 |
|
|
||||||
|
|
||||||
### 2.5 `present_files` 文件卡（Phase 4）
|
|
||||||
|
|
||||||
| 项 | 状态 | 说明 |
|
|
||||||
|----|------|------|
|
|
||||||
| 气泡下方文件卡行 | ✅ | `Step2Message` → `collectPresentedFiles` → `PresentFilesRow` |
|
|
||||||
| 卡片样式 | ✅ | 文件名 + 扩展名徽章（FILE_EXT_LABELS），最小宽度 30/最大 50（hover 边框亮色） |
|
|
||||||
| 点击 → HTTP 预览 | ✅ | `openArtifactPreview(agentThreadId, path)`，与步骤卡 `present_files` 走同一通道 |
|
|
||||||
| 席位 thread 缺失保护 | ✅ | 没有 `agentThreadId` 时 disabled + tooltip |
|
|
||||||
| 同气泡多次 present_files | ✅ | `filepaths` 顺序去重，全部聚合到一行卡片 |
|
|
||||||
|
|
||||||
### 2.6 草稿持久化（Phase 5）
|
|
||||||
|
|
||||||
| 项 | 状态 | 说明 |
|
|
||||||
|----|------|------|
|
|
||||||
| `seatStubMessages` 进 `Step2Snapshot` | ✅ | `useStep2Orchestration.ts` Step2Snapshot 新增字段 |
|
|
||||||
| `seatStubMessages` 进 `DraftStep2Snapshot` | ✅ | `drafts.ts` 加 optional 字段，老草稿 reload 时回退到 `{}` |
|
|
||||||
| `hydrateFromDraft` 还原 stub | ✅ | 同步写 `seatStubMessagesRef` + state，加载草稿后点击历史 write_file 步骤可直接预览 |
|
|
||||||
| `getStep2Snapshot` 透出 stub | ✅ | `RoundtablePlanningPage.tsx` 给 `useDraftPersistence` 的 getter 加上该字段 |
|
|
||||||
|
|
||||||
**主要文件**：
|
|
||||||
|
|
||||||
```
|
|
||||||
frontend-web/src/pages/WorkspaceRoutes.tsx
|
|
||||||
frontend-web/src/roundtable-planning/hooks/useStep2Orchestration.ts
|
|
||||||
frontend-web/src/roundtable-planning/components/Step2SandboxLayout.tsx
|
|
||||||
frontend-web/src/roundtable-planning/components/Step2Panel.tsx
|
|
||||||
frontend-web/src/roundtable-planning/components/MessageStepsCard.tsx
|
|
||||||
frontend-web/src/roundtable-planning/pages/RoundtablePlanningPage.tsx
|
|
||||||
frontend-web/src/roundtable-planning/utils/drafts.ts
|
|
||||||
```
|
|
||||||
|
|
||||||
### 2.7 与主聊天对齐的核心数据流
|
|
||||||
|
|
||||||
```
|
|
||||||
special seat SSE (streamMultiAgent)
|
|
||||||
├── onPhaseChange("tool_calling", "write_file", args)
|
|
||||||
│ ↓
|
|
||||||
│ upsertSeatToolCall(seatThreadId, "write_file", args)
|
|
||||||
│ → seatStubMessages[seatThreadId] = [{ type:"ai", tool_calls:[{ id, name, args }] }]
|
|
||||||
│ ↓
|
|
||||||
│ buildWriteFileVirtualUrl(path, messageId, toolCallId)
|
|
||||||
│ → "write-file:/mnt/user-data/outputs/foo.md?message_id=...&tool_call_id=..."
|
|
||||||
│ ↓
|
|
||||||
│ openSeatVirtualArtifact(seatThreadId, virtualUrl, auto=true)
|
|
||||||
│ → selectArtifact(virtualUrl) + setArtifactsOpen(true)
|
|
||||||
│
|
|
||||||
└── onUpstreamFrame(frame) ← 兜底通道
|
|
||||||
↓
|
|
||||||
handleUpstreamFrame —— 持续 upsert tool_calls 里完整的 args（不打开沙箱）
|
|
||||||
|
|
||||||
Step2SandboxLayout
|
|
||||||
ThreadContext.thread.messages = seatStubMessages[activeThreadId]
|
|
||||||
ArtifactFileDetail(filepath=virtualUrl, threadId=seatThreadId)
|
|
||||||
↓
|
|
||||||
useArtifactContent → loadArtifactContentFromToolCall
|
|
||||||
→ 从 thread.messages 读 tool_call.args.content（不发 HTTP）
|
|
||||||
```
|
|
||||||
|
|
||||||
**为何不用真实 path 直接预览**：流式期间文件可能尚未落盘，直接调 `/api/threads/:id/artifacts/...` 会返回 `404 {"detail":"Not Found"}`。主聊天同样用虚拟 URL 绕过此问题。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 未完成 / 待验证
|
|
||||||
|
|
||||||
### 3.1 功能缺口（按优先级）
|
|
||||||
|
|
||||||
| 优先级 | 项 | 状态 | 说明 |
|
|
||||||
|--------|----|------|------|
|
|
||||||
| P0 | 端到端回归 | ⚠️ 待验证 | 虚拟 URL + 双通道 + 文件卡 + 草稿持久化全链路尚未在浏览器里跑一遍 |
|
|
||||||
| P2 | `str_replace` 流式编辑预览 | ❌ | 主聊天 `applyPendingTextEdit` 依赖完整 message 链；stub 未模拟 tool result / 多轮 str_replace 累加 |
|
|
||||||
| P2 | 沙箱 `artifacts[]` 列表与虚拟 URL 混排 | ❌ | 虚拟 URL 不写入 `setArtifacts([])`；多文件切换、文件名下拉体验未完全对齐主聊天 |
|
|
||||||
| P3 | Step 3 与沙箱衔接 | ❌ | Step 3 仍用 `HighFidelityReport` + `listSessionArtifacts`；与 Step 2 沙箱选中态无联动 |
|
|
||||||
| P3 | 文档同步 | ❌ | `multi-agent-frontend-dev.md` 仍描述旧布局（右侧栏模型选择器等），需更新 § 布局 + 沙箱章节 |
|
|
||||||
|
|
||||||
### 3.2 已知风险 / 边界
|
|
||||||
|
|
||||||
1. **打开时机**：仅在 SSE 进入 `tool_calling` 且 `tool_calls[0].args` 为完整对象时触发自动打开（`multi-agent.ts` 刻意忽略 `tool_call_chunks` 的拼接 args）。若模型只发 chunks、迟迟不发完整 tool_calls，自动打开会延迟到 args 完整那一帧——与主聊天一致。
|
|
||||||
2. **多 write_file 同气泡**：`upsertSeatToolCall` 按 `(toolName, path)` 幂等；同 path 多次 write 会更新 args，不会新建多条 stub tool_call。
|
|
||||||
3. **leader 席位**：当前仅 special 流绑定 `agentThreadId` 并接 `onUpstreamFrame`；总控若直接 write_file，需单独接 thread id 与帧回调。
|
|
||||||
4. **`present_files` 文件大小**：流式期间 backend 尚未给出真实大小；卡片只显示扩展名徽章，不显示 size。落盘后用户点开走 HTTP API 自然能看到完整内容。
|
|
||||||
5. **调试日志**：控制台 `[roundtable-sandbox]` 前缀；生产环境可考虑加 `window.__ROUNDTABLE_SANDBOX_DEBUG__` 门控。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. 分阶段计划（原始规划 vs 现状）
|
|
||||||
|
|
||||||
| 阶段 | 内容 | 状态 |
|
|
||||||
|------|------|------|
|
|
||||||
| Phase 1 | `ChatRuntime` + 分栏壳 + 侧栏联动 | ✅ 完成 |
|
|
||||||
| Phase 2 | `write_file` 自动/点击打开 + 虚拟 URL 预览 | ✅ 完成 |
|
|
||||||
| Phase 3 | `onUpstreamFrame` 注入完整 LangGraph messages | ✅ 完成（双通道兜底） |
|
|
||||||
| Phase 4 | `present_files` 卡片 + Step 3 文件区衔接 | ⚠️ 卡片完成；Step 3 衔接遗留 |
|
|
||||||
| Phase 5 | 草稿 stub 持久化 + 文档更新 | ✅ stub 完成；本文档同步更新 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5. 测试清单
|
|
||||||
|
|
||||||
在 `/page/workspace/roundtable/planning` Step 2 下逐项勾选：
|
|
||||||
|
|
||||||
- [ ] 子智能体 `write_file` 进入 `tool_calling` 后，右侧沙箱 **自动** 打开（约 100ms 延迟，对齐主聊天）
|
|
||||||
- [ ] 沙箱标题为文件名（如 `sample-paper.md`），**不是** `{"detail":"Not Found"}`
|
|
||||||
- [ ] 流式期间 MD 内容随 `args.content` 更新（双通道：phase 切换帧 + 兜底帧）
|
|
||||||
- [ ] 点击 ChainOfThought 步骤「写入文件」/ 路径 chip → 手动打开同一文件
|
|
||||||
- [ ] `present_files` 后气泡下方出现文件卡（带扩展名徽章），点击 → HTTP 预览
|
|
||||||
- [ ] 沙箱打开时左侧「意图理解」栏 **自动收起**
|
|
||||||
- [ ] 关闭沙箱（X）后对话区恢复全宽
|
|
||||||
- [ ] 「新建任务」后 artifacts / 沙箱 / `seatStubMessages` 全部清空
|
|
||||||
- [ ] 「保存草稿」→「加载草稿」后，点击历史 `write_file` 步骤可立即预览（stub 已还原）
|
|
||||||
- [ ] 与主聊天 `/page/workspace/chats/:threadId` 对比：同一 write_file 行为一致
|
|
||||||
|
|
||||||
**调试**：DevTools Console 过滤 `[roundtable-sandbox]` 或 `[stream:special:...]`。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 6. 关键代码索引
|
|
||||||
|
|
||||||
| 用途 | 路径 |
|
|
||||||
|------|------|
|
|
||||||
| 主聊天 write_file 虚拟 URL + 自动打开 | `src/components/workspace/messages/message-group.tsx` |
|
|
||||||
| 主聊天 `RichFileCard`（present_files） | `src/components/workspace/messages/message-list-item.tsx` |
|
|
||||||
| 主聊天 60/40 分栏 | `src/components/workspace/chats/chat-box.tsx` |
|
|
||||||
| 虚拟 URL 内容加载 | `src/core/artifacts/loader.ts` → `loadArtifactContentFromToolCall` |
|
|
||||||
| Artifacts 上下文 | `src/components/workspace/artifacts/context.tsx` |
|
|
||||||
| Step 2 编排 + 沙箱状态 + 草稿快照 | `src/roundtable-planning/hooks/useStep2Orchestration.ts` |
|
|
||||||
| Step 2 沙箱布局 | `src/roundtable-planning/components/Step2SandboxLayout.tsx` |
|
|
||||||
| Step 2 文件卡 + 步骤渲染 | `src/roundtable-planning/components/Step2Panel.tsx` |
|
|
||||||
| SSE phase 推断 + `onUpstreamFrame` | `src/roundtable-planning/api/multi-agent.ts` → `setPhase` |
|
|
||||||
| 主页面侧栏 + 联动 | `src/roundtable-planning/pages/RoundtablePlanningPage.tsx` |
|
|
||||||
| 草稿持久化 | `src/roundtable-planning/utils/drafts.ts`、`hooks/useDraftPersistence.ts` |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 7. 下一步建议（给接续开发者）
|
|
||||||
|
|
||||||
1. **先跑通 P0 测试清单**，确认 Phase 3/4/5 改造后无回归；重点观察双通道并发写入 stub 时 args 是否被旧帧覆盖（理论上 LangGraph 完整 tool_calls 是单调累积的，应该没问题）。
|
|
||||||
2. **Phase 4 收尾**：把 Step 3 的 `listSessionArtifacts` / `HighFidelityReport` 接进沙箱选中态——Step 3 进入时复用 Step 2 的 `ArtifactsProvider`，让用户在 Step 3 也能预览 Step 2 留下的产物。
|
|
||||||
3. **Phase 2 边界**：`str_replace` 多轮编辑的 stub 模拟（追加 tool result 消息让 `applyPendingTextEdit` 能 replay edit 序列），优先级低。
|
|
||||||
4. **更新** `multi-agent-frontend-dev.md`：Step 2 布局、沙箱架构、`seatStubMessages` 数据流，避免与本文档重复——可在总览文档加一节「见 `roundtable-step2-sandbox-progress.md`」。
|
|
||||||
@@ -1,375 +0,0 @@
|
|||||||
# 浅蓝色 UI 规范
|
|
||||||
|
|
||||||
> 本文档由设计稿截图（`1.1 全局样式-色彩`、`1.2 全局样式-色彩附录`）识别整理而成。
|
|
||||||
> 全部色值已与"色彩附录"编号表逐一核对，保证准确。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1.1 色彩体系总览
|
|
||||||
|
|
||||||
调色体系分为 **主色** 与 **辅色** 两大类。每个色相按用途分为若干阶梯：
|
|
||||||
|
|
||||||
| 阶梯 | 数量 | 用途 |
|
|
||||||
| --- | --- | --- |
|
|
||||||
| 浅色 | 3 | 用于大面积底色 |
|
|
||||||
| 中亮色 | 6 | 用于标签、图表、提示等 |
|
|
||||||
| 深色 | 4（+基准色，共 5 个深阶） | 用于小面积按钮、图标等 |
|
|
||||||
| 线性渐变色 | 1 | 用于特殊装饰性小面积底色 |
|
|
||||||
| 径向渐变色 | 1 | 用于特殊装饰性小面积底色 |
|
|
||||||
|
|
||||||
> 中性色（灰阶）略有不同：浅色用于背景 / 白色文字及分割线，中亮色用于备注文字及图标，深色用于正文，且**无渐变色**。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 主色
|
|
||||||
|
|
||||||
### 主色 - 红（基准 `#CF1322`）
|
|
||||||
|
|
||||||
| 用途 | 色值 |
|
|
||||||
| --- | --- |
|
|
||||||
| 浅色 | `#FEFAFA` · `#FEF6F6` · `#FEEDED` |
|
|
||||||
| 中亮色 | `#FDDADC` · `#FCB5B9` · `#FA9196` · `#F86C73` · `#F74750` · `#F5222D` |
|
|
||||||
| 深色 | `#CF1322` · `#BC0D1E` · `#A8071A` · `#820014` · `#5C0011` |
|
|
||||||
| 线性渐变色 | `#F5222D` → `#A8071A` |
|
|
||||||
| 径向渐变色 | `#F86C73` → `#F5222D` |
|
|
||||||
|
|
||||||
### 主色 - 蓝（基准 `#0062D9`）
|
|
||||||
|
|
||||||
| 用途 | 色值 |
|
|
||||||
| --- | --- |
|
|
||||||
| 浅色 | `#F9FCFF` · `#F4F9FF` · `#EAF4FF` |
|
|
||||||
| 中亮色 | `#D4E9FF` · `#AAD2FF` · `#80BCFF` · `#55A6FE` · `#2B8FFE` · `#0079FE` |
|
|
||||||
| 深色 | `#0062D9` · `#0056C6` · `#004AB3` · `#00368C` · `#002466` |
|
|
||||||
| 线性渐变色 | `#0079FE` → `#004AB3` |
|
|
||||||
| 径向渐变色 | `#55A6FE` → `#0079FE` |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 辅色
|
|
||||||
|
|
||||||
### 辅色 - 橙（基准 `#D97B00`）
|
|
||||||
|
|
||||||
| 用途 | 色值 |
|
|
||||||
| --- | --- |
|
|
||||||
| 浅色 | `#FFFCF9` · `#FFFAF4` · `#FFF6EA` |
|
|
||||||
| 中亮色 | `#FFEED4` · `#FFDDAA` · `#FFCC80` · `#FFBB55` · `#FFAA2B` · `#FF9900` |
|
|
||||||
| 深色 | `#D97B00` · `#C66D00` · `#B35F00` · `#8C4600` · `#663000` |
|
|
||||||
| 线性渐变色 | `#FF9900` → `#B35F00` |
|
|
||||||
| 径向渐变色 | `#FFBB55` → `#FF9900` |
|
|
||||||
|
|
||||||
### 辅色 - 绿（基准 `#1EB07F`）
|
|
||||||
|
|
||||||
| 用途 | 色值 |
|
|
||||||
| --- | --- |
|
|
||||||
| 浅色 | `#FAFEFD` · `#F6FDFB` · `#EEFCF7` |
|
|
||||||
| 中亮色 | `#DCF8EE` · `#BAF1DD` · `#97EBCD` · `#74E4BC` · `#52DDAB` · `#2FD69A` |
|
|
||||||
| 深色 | `#1EB07F` · `#189D72` · `#118A65` · `#07634B` · `#043D30` |
|
|
||||||
| 线性渐变色 | `#2FD69A` → `#118A65` |
|
|
||||||
| 径向渐变色 | `#74E4BC` → `#2FD69A` |
|
|
||||||
|
|
||||||
### 辅色 - 青蓝（基准 `#2F9ACC`）
|
|
||||||
|
|
||||||
| 用途 | 色值 |
|
|
||||||
| --- | --- |
|
|
||||||
| 浅色 | `#FBFDFE` · `#F7FCFE` · `#EFFAFE` |
|
|
||||||
| 中亮色 | `#E0F5FD` · `#C1EBFB` · `#A2E1F9` · `#83D7F7` · `#64CDF5` · `#45C3F3` |
|
|
||||||
| 深色 | `#2F9ACC` · `#2788B9` · `#1E76A6` · `#115580` · `#0B3959` |
|
|
||||||
| 线性渐变色 | `#45C3F3` → `#1E76A6` |
|
|
||||||
| 径向渐变色 | `#83D7F7` → `#45C3F3` |
|
|
||||||
|
|
||||||
### 中性色 - 灰（基准 `#222222`）
|
|
||||||
|
|
||||||
| 用途 | 色值 |
|
|
||||||
| --- | --- |
|
|
||||||
| 浅色（背景、白色文字及分割线） | `#FFFFFF` · `#FAFAFA` · `#F5F5F5` |
|
|
||||||
| 中亮色（备注文字及图标） | `#E8E8E8` · `#DBDBDB` · `#C1C1C1` · `#A6A6A6` · `#7F7F7F` · `#575757` |
|
|
||||||
| 深色（正文） | `#3D3D3D` · `#222222` |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1.2 色彩附录（编号对照表）
|
|
||||||
|
|
||||||
编号规则：`ZS` = 主色（主色调），`FS` = 辅色 / 中性色。`-01~-03` 为浅色，`-04~-09` 为中亮色，`-10~-13` 为深色，`-14` 为线性渐变色，`-15` 为径向渐变色；不带后缀的为该色相基准深色。
|
|
||||||
|
|
||||||
### 主色 ZS
|
|
||||||
|
|
||||||
| 编号 | 红 (ZS-001) | 编号 | 蓝 (ZS-002) |
|
|
||||||
| --- | --- | --- | --- |
|
|
||||||
| ZS-001 | `#CF1322` | ZS-002 | `#0062D9` |
|
|
||||||
| ZS-001-01 | `#FEFAFA` | ZS-002-01 | `#F9FCFF` |
|
|
||||||
| ZS-001-02 | `#FEF6F6` | ZS-002-02 | `#F4F9FF` |
|
|
||||||
| ZS-001-03 | `#FEEDED` | ZS-002-03 | `#EAF4FF` |
|
|
||||||
| ZS-001-04 | `#FDDADC` | ZS-002-04 | `#D4E9FF` |
|
|
||||||
| ZS-001-05 | `#FCB5B9` | ZS-002-05 | `#AAD2FF` |
|
|
||||||
| ZS-001-06 | `#FA9196` | ZS-002-06 | `#80BCFF` |
|
|
||||||
| ZS-001-07 | `#F86C73` | ZS-002-07 | `#55A6FE` |
|
|
||||||
| ZS-001-08 | `#F74750` | ZS-002-08 | `#2B8FFE` |
|
|
||||||
| ZS-001-09 | `#F5222D` | ZS-002-09 | `#0079FE` |
|
|
||||||
| ZS-001-10 | `#BC0D1E` | ZS-002-10 | `#0056C6` |
|
|
||||||
| ZS-001-11 | `#A8071A` | ZS-002-11 | `#004AB3` |
|
|
||||||
| ZS-001-12 | `#820014` | ZS-002-12 | `#00368C` |
|
|
||||||
| ZS-001-13 | `#5C0011` | ZS-002-13 | `#002466` |
|
|
||||||
| ZS-001-14 | `#F5222D` → `#A8071A` | ZS-002-14 | `#0079FE` → `#004AB3` |
|
|
||||||
| ZS-001-15 | `#F86C73` → `#F5222D` | ZS-002-15 | `#55A6FE` → `#0079FE` |
|
|
||||||
|
|
||||||
### 辅色 / 中性色 FS
|
|
||||||
|
|
||||||
| 编号 | 橙 (FS-001) | 绿 (FS-002) | 青蓝 (FS-003) | 中性灰 (FS-004) |
|
|
||||||
| --- | --- | --- | --- | --- |
|
|
||||||
| FS-00n | `#D97B00` | `#1EB07F` | `#2F9ACC` | `#222222` |
|
|
||||||
| -01 | `#FFFCF9` | `#FAFEFD` | `#FBFDFE` | `#FFFFFF` |
|
|
||||||
| -02 | `#FFFAF4` | `#F6FDFB` | `#F7FCFE` | `#FAFAFA` |
|
|
||||||
| -03 | `#FFF6EA` | `#EEFCF7` | `#EFFAFE` | `#F5F5F5` |
|
|
||||||
| -04 | `#FFEED4` | `#DCF8EE` | `#E0F5FD` | `#E8E8E8` |
|
|
||||||
| -05 | `#FFDDAA` | `#BAF1DD` | `#C1EBFB` | `#DBDBDB` |
|
|
||||||
| -06 | `#FFCC80` | `#97EBCD` | `#A2E1F9` | `#C1C1C1` |
|
|
||||||
| -07 | `#FFBB55` | `#74E4BC` | `#83D7F7` | `#A6A6A6` |
|
|
||||||
| -08 | `#FFAA2B` | `#52DDAB` | `#64CDF5` | `#7F7F7F` |
|
|
||||||
| -09 | `#FF9900` | `#2FD69A` | `#45C3F3` | `#575757` |
|
|
||||||
| -10 | `#C66D00` | `#189D72` | `#2788B9` | `#3D3D3D` |
|
|
||||||
| -11 | `#B35F00` | `#118A65` | `#1E76A6` | — |
|
|
||||||
| -12 | `#8C4600` | `#07634B` | `#115580` | — |
|
|
||||||
| -13 | `#663000` | `#043D30` | `#0B3959` | — |
|
|
||||||
| -14 | `#FF9900` → `#B35F00` | `#2FD69A` → `#118A65` | `#45C3F3` → `#1E76A6` | — |
|
|
||||||
| -15 | `#FFBB55` → `#FF9900` | `#74E4BC` → `#2FD69A` | `#83D7F7` → `#45C3F3` | — |
|
|
||||||
|
|
||||||
> 注：中性灰（FS-004）无渐变阶，最深至 `#222222`（基准）/`#3D3D3D`（FS-004-10），用于正文文字。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
# 组件规范
|
|
||||||
|
|
||||||
> 以下为各组件的视觉规范与实现方式。颜色统一引用上文色值，建议在项目中先抽取为 CSS 变量 / Tailwind token，组件只引用语义化变量。
|
|
||||||
|
|
||||||
## 语义化 Token 建议
|
|
||||||
|
|
||||||
把色彩体系映射成语义变量，组件层只用语义名，便于换肤与维护：
|
|
||||||
|
|
||||||
```css
|
|
||||||
:root {
|
|
||||||
/* 品牌 / 主色（蓝） */
|
|
||||||
--color-primary: #0062D9; /* 主按钮、实底选中：ZS-002 深色基准 */
|
|
||||||
--color-primary-hover: #0079FE; /* 悬浮态：ZS-002-09 */
|
|
||||||
--color-primary-active: #0056C6; /* 按下态：ZS-002-10 */
|
|
||||||
--color-primary-bg: #EAF4FF; /* 浅底选中底色：ZS-002-03 */
|
|
||||||
--color-primary-border: #0079FE; /* 描边选中边框 */
|
|
||||||
|
|
||||||
/* 中性 */
|
|
||||||
--color-text: #3D3D3D; /* 正文：FS-004-10 */
|
|
||||||
--color-text-secondary: #A6A6A6; /* 次要 / 占位符：FS-004-07 */
|
|
||||||
--color-border: #DBDBDB; /* 默认边框：FS-004-05 */
|
|
||||||
--color-bg-disabled: #F5F5F5; /* 失效底色：FS-004-03 */
|
|
||||||
--color-fill-disabled: #A6A6A6; /* 主按钮失效底色：FS-004-07 */
|
|
||||||
--color-surface: #FFFFFF; /* 卡片 / 控件底 */
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
> 项目使用 Tailwind v4 + shadcn，可在 `@theme` 中声明这些变量后用 `bg-primary` / `text-primary` 等使用；下文示例同时给出等价的 Tailwind 写法。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2.1 基础 - 按钮（Button）
|
|
||||||
|
|
||||||
### 按钮尺寸
|
|
||||||
|
|
||||||
| 规格 | 高度 | 圆角 | 用途 |
|
|
||||||
| --- | --- | --- | --- |
|
|
||||||
| 小 | **28px** | 4px | 空间小的板块内部，如表格中、卡片标题等 |
|
|
||||||
| 正常 | **32px** | 4px | 常用按钮（默认尺寸） |
|
|
||||||
|
|
||||||
水平内边距约 12–16px，字号 14px，图标与文字间距 4–8px。
|
|
||||||
|
|
||||||
### 常用按钮类型
|
|
||||||
|
|
||||||
| 类型 | 视觉 | 用途 |
|
|
||||||
| --- | --- | --- |
|
|
||||||
| 主按钮 | 实底 `--color-primary`，白字 | 一个操作区域**只能有一个**主按钮 |
|
|
||||||
| 主按钮·失效 | 实底灰 `--color-fill-disabled`，白字 | 主按钮禁用态 |
|
|
||||||
| 次要按钮 | 白底 + `--color-primary` 边框 + 蓝字 | 重要度低于主按钮，高于默认按钮 |
|
|
||||||
| 默认按钮 | 白底 + `--color-border` 边框 + `--color-text` | 默认动作（取消等） |
|
|
||||||
| 默认·失效 | `--color-bg-disabled` 底 + 浅边框 + `--color-text-secondary` | 次要/默认按钮禁用态 |
|
|
||||||
| 文本按钮 | 无边框无底，蓝字（可加下划线） | 表格操作、文件下载等 |
|
|
||||||
| 图标按钮 | 仅图标，可选 描边/实底/浅底 × 方形/圆形 | 增强辨识度或节省空间 |
|
|
||||||
|
|
||||||
实现（Tailwind 示意）：
|
|
||||||
|
|
||||||
```tsx
|
|
||||||
// 主按钮
|
|
||||||
<button className="h-8 px-4 rounded text-sm text-white bg-[#0062D9]
|
|
||||||
hover:bg-[#0079FE] active:bg-[#0056C6]
|
|
||||||
disabled:bg-[#A6A6A6] disabled:cursor-not-allowed">确定</button>
|
|
||||||
|
|
||||||
// 次要按钮（次按钮）
|
|
||||||
<button className="h-8 px-4 rounded text-sm text-[#0062D9] bg-white
|
|
||||||
border border-[#0062D9] hover:bg-[#EAF4FF]">点击</button>
|
|
||||||
|
|
||||||
// 默认按钮
|
|
||||||
<button className="h-8 px-4 rounded text-sm text-[#3D3D3D] bg-white
|
|
||||||
border border-[#DBDBDB] hover:border-[#0079FE] hover:text-[#0079FE]
|
|
||||||
disabled:bg-[#F5F5F5] disabled:text-[#A6A6A6] disabled:border-[#DBDBDB]">取消</button>
|
|
||||||
|
|
||||||
// 文本按钮
|
|
||||||
<button className="text-sm text-[#0062D9] hover:underline">文本按钮样式</button>
|
|
||||||
|
|
||||||
// 图标按钮（实底圆形）
|
|
||||||
<button className="size-7 grid place-items-center rounded-full text-white bg-[#0062D9]
|
|
||||||
hover:bg-[#0079FE]"><TrashIcon className="size-4" /></button>
|
|
||||||
```
|
|
||||||
|
|
||||||
图标按钮三种底 × 两种形状：
|
|
||||||
- **描边**：白底 + `--color-border` 边框，图标用 `--color-text`
|
|
||||||
- **实底**：`--color-primary` 底 + 白图标
|
|
||||||
- **浅底**：`--color-primary-bg`（`#EAF4FF`）底 + 蓝图标
|
|
||||||
- 形状：方形 `rounded`（4px）/ 圆形 `rounded-full`
|
|
||||||
|
|
||||||
### 按钮组合
|
|
||||||
|
|
||||||
| 组合 | 说明 |
|
|
||||||
| --- | --- |
|
|
||||||
| 文字 + 下拉按钮 | 按钮右侧带 `⌄` 箭头；有 默认 / 主按钮 两种变体 |
|
|
||||||
| 图标 + 文字按钮 | `+ 正常`，前置图标；有 描边 / 实底 两种变体 |
|
|
||||||
| 文本按钮 + 图标 | 蓝色文本链按钮：`更多 »` `展开 ⌄` `下一页 »|` `收起 ⌃` `|⌜ 上一页` |
|
|
||||||
| 主按钮 + 默认按钮 | `确定`(主) `取消`(默认) `返回`(默认) 并排，间距 8–12px |
|
|
||||||
|
|
||||||
### 其他状态
|
|
||||||
|
|
||||||
- **悬浮状态（hover）**：主按钮悬浮时底色变亮（`--color-primary-hover` `#0079FE`），用于 Banner / 登录 / 视觉冲击强的场景。
|
|
||||||
- **加载中（loading）**：按钮内前置旋转图标 `⟳ 加载中`，期间 `disabled` 并降低交互；用于异步操作等待反馈。
|
|
||||||
|
|
||||||
```tsx
|
|
||||||
<button className="h-8 px-4 rounded text-sm text-white bg-[#0062D9] inline-flex items-center gap-1.5" disabled>
|
|
||||||
<Spinner className="size-4 animate-spin" /> 加载中
|
|
||||||
</button>
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5.9 输入 - 单选框（选择按钮 / Segmented Radio）
|
|
||||||
|
|
||||||
一组互斥选项，外观为按钮组。两种排布 × 三种选中样式。
|
|
||||||
|
|
||||||
### 排布方式
|
|
||||||
|
|
||||||
| 排布 | 说明 |
|
|
||||||
| --- | --- |
|
|
||||||
| 拼接式 | 选项首尾相连，仅最外侧两角圆角，相邻共用 1px 边框 |
|
|
||||||
| 分离式 | 选项之间留间距（约 8px），每个独立 4px 圆角，各自带完整边框 |
|
|
||||||
|
|
||||||
### 选中（已选）样式 × 三种
|
|
||||||
|
|
||||||
| 样式 | 已选 | 未选 |
|
|
||||||
| --- | --- | --- |
|
|
||||||
| 描边式 | 白底 + 蓝边框 `--color-primary` + 蓝字 | 白底 + `--color-border` 边框 + `--color-text` |
|
|
||||||
| 浅底式 | `--color-primary-bg`(`#EAF4FF`) 底 + 蓝字 + 蓝边框 | 同上 |
|
|
||||||
| 实底式 | `--color-primary` 实底 + 白字 | 同上 |
|
|
||||||
|
|
||||||
- **带统计**：选项文字后追加计数，如 `已选(230)` / `未选(230)`，计数用次要色 `--color-text-secondary`。
|
|
||||||
|
|
||||||
实现（拼接式 + 描边选中）：
|
|
||||||
|
|
||||||
```tsx
|
|
||||||
<div className="inline-flex rounded overflow-hidden border border-[#DBDBDB] divide-x divide-[#DBDBDB]">
|
|
||||||
{options.map((o) => (
|
|
||||||
<button key={o.value}
|
|
||||||
className={cn(
|
|
||||||
"h-8 px-4 text-sm bg-white",
|
|
||||||
value === o.value
|
|
||||||
? "text-[#0062D9] ring-1 ring-inset ring-[#0079FE] z-10" // 描边选中
|
|
||||||
: "text-[#3D3D3D] hover:text-[#0079FE]"
|
|
||||||
)}>
|
|
||||||
{o.label}{o.count != null && <span className="text-[#A6A6A6]">({o.count})</span>}
|
|
||||||
</button>
|
|
||||||
))}
|
|
||||||
</div>
|
|
||||||
```
|
|
||||||
|
|
||||||
> 浅底式把选中态换成 `bg-[#EAF4FF] text-[#0062D9]`；实底式换成 `bg-[#0062D9] text-white`。
|
|
||||||
> 分离式去掉 `divide-x` / `overflow-hidden`，外层用 `gap-2`，每个按钮单独 `rounded border`。
|
|
||||||
|
|
||||||
### 按钮式页签（Tab as Button）
|
|
||||||
|
|
||||||
图标 + 文字的页签型按钮：
|
|
||||||
- **激活** 两种：描边（白底 + 蓝边框 + 蓝字）/ 实底（`--color-primary` 底 + 白字）
|
|
||||||
- **正常**：白底 + `--color-border` 边框 + `--color-text`，前置图标
|
|
||||||
- 结构与拼接式选择按钮一致，区别在每项前置一个功能图标。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5.11 输入 - 选择器（Select / Dropdown）
|
|
||||||
|
|
||||||
单项输入选择，下拉单选。
|
|
||||||
|
|
||||||
### 状态
|
|
||||||
|
|
||||||
| 状态 | 触发框 |
|
|
||||||
| --- | --- |
|
|
||||||
| 占位 | `请选择` 占位文字用 `--color-text-secondary`，灰边框 `--color-border`，右侧 `⌄` |
|
|
||||||
| 展开/聚焦 | 边框变 `--color-primary`，箭头翻转为 `⌃` |
|
|
||||||
| 已选 | 显示选中项文字（正文色），保持聚焦时蓝边框 |
|
|
||||||
|
|
||||||
### 下拉面板
|
|
||||||
|
|
||||||
- 白底、圆角 4px、投影（如 `shadow-lg`），最大高度后出现滚动条
|
|
||||||
- 选项默认 `--color-text`；**hover / 选中** 项：`--color-primary-bg`(`#EAF4FF`) 底 + `--color-primary` 文字
|
|
||||||
- **分组**：分组标题用小号灰字 `--color-text-secondary`，组之间用 1px 分割线 `--color-border`
|
|
||||||
|
|
||||||
实现示意：
|
|
||||||
|
|
||||||
```tsx
|
|
||||||
// 触发框
|
|
||||||
<button className="h-8 w-full px-3 inline-flex items-center justify-between rounded
|
|
||||||
border border-[#DBDBDB] bg-white text-sm
|
|
||||||
data-[state=open]:border-[#0062D9]">
|
|
||||||
<span className={selected ? "text-[#3D3D3D]" : "text-[#A6A6A6]"}>{selected ?? "请选择"}</span>
|
|
||||||
<ChevronDown className="size-4 text-[#A6A6A6] transition-transform data-[state=open]:rotate-180" />
|
|
||||||
</button>
|
|
||||||
|
|
||||||
// 下拉项
|
|
||||||
<li className={cn(
|
|
||||||
"h-9 px-3 flex items-center text-sm cursor-pointer rounded-sm",
|
|
||||||
active ? "bg-[#EAF4FF] text-[#0062D9]" : "text-[#3D3D3D] hover:bg-[#EAF4FF]"
|
|
||||||
)}>{label}</li>
|
|
||||||
|
|
||||||
// 分组标题
|
|
||||||
<div className="px-3 py-1.5 text-xs text-[#A6A6A6]">分组标题1</div>
|
|
||||||
```
|
|
||||||
|
|
||||||
> 推荐直接基于 Radix `Select`（项目已有 shadcn 封装）改这些类名落地。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5.14 输入 - 开关（Switch）
|
|
||||||
|
|
||||||
两种形态：
|
|
||||||
|
|
||||||
### 1. 滑块开关（多用于表单、表格中）
|
|
||||||
|
|
||||||
- **开**：胶囊底 `--color-primary`，白色圆形滑块在右，左侧白字「开」
|
|
||||||
- **关**：胶囊底灰 `--color-text-secondary`/`#C1C1C1`，滑块在左，右侧灰字「关」
|
|
||||||
- 切换时滑块带左右过渡动画
|
|
||||||
|
|
||||||
```tsx
|
|
||||||
<button role="switch" aria-checked={on}
|
|
||||||
className={cn(
|
|
||||||
"relative h-6 w-12 rounded-full transition-colors text-[11px] text-white",
|
|
||||||
on ? "bg-[#0062D9]" : "bg-[#C1C1C1]"
|
|
||||||
)}>
|
|
||||||
<span className={cn("absolute top-0.5 size-5 rounded-full bg-white transition-all",
|
|
||||||
on ? "left-[26px]" : "left-0.5")} />
|
|
||||||
<span className={cn("absolute top-1/2 -translate-y-1/2", on ? "left-2" : "right-2 text-[#7F7F7F]")}>
|
|
||||||
{on ? "开" : "关"}
|
|
||||||
</span>
|
|
||||||
</button>
|
|
||||||
```
|
|
||||||
|
|
||||||
### 2. 单选框作为开关（分段式）
|
|
||||||
|
|
||||||
- `开 | 关` 两段式：激活段 `--color-primary` 实底白字，未激活段白底灰字 + `--color-border` 边框
|
|
||||||
- 即 5.9 拼接式「实底选择按钮」的两选项特例
|
|
||||||
|
|
||||||
```tsx
|
|
||||||
<div className="inline-flex rounded overflow-hidden border border-[#DBDBDB]">
|
|
||||||
<button className={cn("h-7 px-4 text-sm", on ? "bg-[#0062D9] text-white" : "bg-white text-[#3D3D3D]")}>开</button>
|
|
||||||
<button className={cn("h-7 px-4 text-sm border-l border-[#DBDBDB]", !on ? "bg-[#0062D9] text-white" : "bg-white text-[#3D3D3D]")}>关</button>
|
|
||||||
</div>
|
|
||||||
```
|
|
||||||
@@ -1,580 +0,0 @@
|
|||||||
# 深蓝色 UI 规范 · 00 基础（色彩 / 字体 / 阴影 / 圆角 / 间距 / 分割线）
|
|
||||||
|
|
||||||
> 本文件是《深蓝色 UI 规范》拆分后的**基础篇（§1–§7）**，是全站设计令牌的唯一来源。
|
|
||||||
> 其余分册见同目录 `README.md`；可直接 import 的变量见 `tokens.css`。
|
|
||||||
> 跨章节 `§N` 编号全局唯一，所属文件见 README 的「§ 索引」。
|
|
||||||
|
|
||||||
**本篇目录（§1–§7）**：`1` 色彩 · `2` 字体 · `3` 阴影 · `4` 圆角 · `5` 按钮 · `6` 分割线 · `7` 间距
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 色彩
|
|
||||||
|
|
||||||
### 1.1 标准色
|
|
||||||
|
|
||||||
色彩体系由四个色系构成，每个色系分主色与辅色两组，每组按明度从浅到深编号（01 最浅，数字越大越深）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 1.1.1 色系总览
|
|
||||||
|
|
||||||
| 色系 | 用途定位 | 代码前缀 |
|
|
||||||
|------|----------|----------|
|
|
||||||
| 渐红系 | 警示、错误、强调操作 | ZS-001 |
|
|
||||||
| 渐蓝系 | 信息、链接、次级操作 | ZS-002 |
|
|
||||||
| 渐青系 | 成功、在线状态、数据高亮 | ZS-003 |
|
|
||||||
| 深蓝系 | 页面背景、容器、导航底色 | ZS-004 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 1.1.2 渐红系（ZS-001）
|
|
||||||
|
|
||||||
用于错误提示、危险操作、重要告警。
|
|
||||||
|
|
||||||
| 编号 | 色值 | 说明 |
|
|
||||||
|------|------|------|
|
|
||||||
| ZS-001-01 | `#FFF1F0` | 极浅红，错误背景底色 |
|
|
||||||
| ZS-001-02 | `#FFCCC7` | 浅红，输入框错误边框 |
|
|
||||||
| ZS-001-03 | `#FFA39E` | — |
|
|
||||||
| ZS-001-04 | `#FF7875` | — |
|
|
||||||
| ZS-001-05 | `#FF4D4F` | 标准红，Tag / Badge |
|
|
||||||
| ZS-001-06 | `#F5222D` | 主色红，按钮 / 图标 |
|
|
||||||
| ZS-001-07 | `#CF1322` | 深红，Hover 状态 |
|
|
||||||
| ZS-001-08 | `#A8071A` | 深红，Active / Press |
|
|
||||||
| ZS-001-09 | `#820014` | 极深红 |
|
|
||||||
| ZS-001-10 | `#5C0011` | 最深红 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 1.1.3 渐蓝系（ZS-002）
|
|
||||||
|
|
||||||
用于信息提示、链接、次级按钮。
|
|
||||||
|
|
||||||
| 编号 | 色值 | 说明 |
|
|
||||||
|------|------|------|
|
|
||||||
| ZS-002-01 | `#E6F4FF` | 极浅蓝，信息背景底色 |
|
|
||||||
| ZS-002-02 | `#BAE0FF` | 浅蓝 |
|
|
||||||
| ZS-002-03 | `#91CAFF` | — |
|
|
||||||
| ZS-002-04 | `#69B1FF` | — |
|
|
||||||
| ZS-002-05 | `#4096FF` | 标准蓝，链接 / 信息 Tag |
|
|
||||||
| ZS-002-06 | `#1677FF` | 主色蓝，主操作按钮 |
|
|
||||||
| ZS-002-07 | `#0958D9` | 深蓝，Hover |
|
|
||||||
| ZS-002-08 | `#003EB3` | 深蓝，Active |
|
|
||||||
| ZS-002-09 | `#002C8C` | 极深蓝 |
|
|
||||||
| ZS-002-10 | `#001D6C` | 最深蓝 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 1.1.4 渐青系（ZS-003）
|
|
||||||
|
|
||||||
用于成功状态、在线标识、数据图表高亮。
|
|
||||||
|
|
||||||
| 编号 | 色值 | 说明 |
|
|
||||||
|------|------|------|
|
|
||||||
| ZS-003-01 | `#E6FFFB` | 极浅青，成功背景 |
|
|
||||||
| ZS-003-02 | `#B5F5EC` | 浅青 |
|
|
||||||
| ZS-003-03 | `#87E8DE` | — |
|
|
||||||
| ZS-003-04 | `#5CDBD3` | — |
|
|
||||||
| ZS-003-05 | `#36CFC9` | 标准青，成功 Tag |
|
|
||||||
| ZS-003-06 | `#13C2C2` | 主色青，在线点 / 图标 |
|
|
||||||
| ZS-003-07 | `#08979C` | 深青，Hover |
|
|
||||||
| ZS-003-08 | `#006D75` | 深青，Active |
|
|
||||||
| ZS-003-09 | `#00474F` | 极深青 |
|
|
||||||
| ZS-003-10 | `#002329` | 最深青 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 1.1.5 深蓝系（ZS-004）
|
|
||||||
|
|
||||||
用于页面背景、导航栏、侧边栏、卡片容器。这是深蓝主题的核心色系。
|
|
||||||
|
|
||||||
| 编号 | 色值 | 说明 |
|
|
||||||
|------|------|------|
|
|
||||||
| ZS-004-01 | `#E8EDF5` | 极浅，分割线 / 禁用底色 |
|
|
||||||
| ZS-004-02 | `#C5CFE0` | 浅，边框 |
|
|
||||||
| ZS-004-03 | `#9BADC8` | — |
|
|
||||||
| ZS-004-04 | `#6E88B0` | — |
|
|
||||||
| ZS-004-05 | `#4A6491` | 中深蓝，次级文字 |
|
|
||||||
| ZS-004-06 | `#2D4473` | 深蓝，卡片容器背景 |
|
|
||||||
| ZS-004-07 | `#1A2F5A` | 深蓝，侧边栏背景 |
|
|
||||||
| ZS-004-08 | `#122347` | 深蓝，导航栏背景 |
|
|
||||||
| ZS-004-09 | `#0C1836` | 极深蓝，页面背景 |
|
|
||||||
| ZS-004-10 | `#060E24` | 最深，全局底色 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 1.1.6 功能色（主色 / 字体色 / 辅色 / 背景色）
|
|
||||||
|
|
||||||
从标准色系中提取，用于具体 UI 角色指定。
|
|
||||||
|
|
||||||
| 角色 | 色值 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 主色（Primary） | `#1677FF` | ZS-002-06 |
|
|
||||||
| 主色 Hover | `#0958D9` | ZS-002-07 |
|
|
||||||
| 主色 Active | `#003EB3` | ZS-002-08 |
|
|
||||||
| 正常字体色 | `#C5CFE0` | ZS-004-02 |
|
|
||||||
| 次级字体色 | `#6E88B0` | ZS-004-04 |
|
|
||||||
| 禁用字体色 | `#4A6491` | ZS-004-05 |
|
|
||||||
| 辅色（Accent） | `#13C2C2` | ZS-003-06 |
|
|
||||||
| 页面背景色 | `#0C1836` | ZS-004-09 |
|
|
||||||
| 容器背景色 | `#1A2F5A` | ZS-004-07 |
|
|
||||||
| 白色 | `#FFFFFF` | — |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 1.1.7 小面积装饰色
|
|
||||||
|
|
||||||
用于图标点缀、徽标、少量强调，不用于大面积背景。
|
|
||||||
|
|
||||||
| 色值 | 说明 |
|
|
||||||
|------|------|
|
|
||||||
| `#6388FF` | 紫蓝，图标装饰 |
|
|
||||||
| `#F5222D` | 红色，危险徽标 |
|
|
||||||
| `#12306C` | 深蓝，品牌点缀 |
|
|
||||||
| `#478880` | 青绿，辅助点缀 |
|
|
||||||
| `#950404` | 深红，重要告警点 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 1.1.8 图表配色
|
|
||||||
|
|
||||||
**通用图表色序**（面积较大，如柱状图、折线图、饼图）：
|
|
||||||
|
|
||||||
| 序号 | 色值 |
|
|
||||||
|------|------|
|
|
||||||
| 1 | `#1677FF` |
|
|
||||||
| 2 | `#13C2C2` |
|
|
||||||
| 3 | `#4096FF` |
|
|
||||||
| 4 | `#36CFC9` |
|
|
||||||
| 5 | `#69B1FF` |
|
|
||||||
| 6 | `#5CDBD3` |
|
|
||||||
| 7 | `#91CAFF` |
|
|
||||||
| 8 | `#87E8DE` |
|
|
||||||
|
|
||||||
**小面积图表色序**（面积较小，如散点、小徽章、迷你图）：
|
|
||||||
|
|
||||||
| 序号 | 色值 |
|
|
||||||
|------|------|
|
|
||||||
| 1 | `#4096FF` |
|
|
||||||
| 2 | `#36CFC9` |
|
|
||||||
| 3 | `#FF4D4F` |
|
|
||||||
| 4 | `#FFA39E` |
|
|
||||||
| 5 | `#6388FF` |
|
|
||||||
| 6 | `#478880` |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 1.1.9 功能语义色（Functional / Status）
|
|
||||||
|
|
||||||
承载「成功 / 警告 / 错误 / 信息 / 处理中」语义。其中**错误红、信息蓝、处理中青**直接复用标准色；**成功绿、警告橙**为标准色系之外的补充色（深色背景下 ZS-003 青偏冷、且无现成橙），在此正式收录。全站语义场景一律引用本表，不再各处自定义。
|
|
||||||
|
|
||||||
| 语义 | 色值 | 来源 | 典型用途 |
|
|
||||||
|------|------|------|----------|
|
|
||||||
| 成功 / 已完成 | `#52C41A` | 补充色（绿） | 成功提示、完成状态、通过校验 |
|
|
||||||
| 警告 / 进行中 | `#FAAD14` | 补充色（橙） | 警告提示、进行中、需注意 |
|
|
||||||
| 错误 / 失败 | `#F5222D` | ZS-001-06 | 错误提示、删除、失败状态 |
|
|
||||||
| 信息 / 默认 | `#1677FF` | ZS-002-06 | 信息提示、主操作、链接 |
|
|
||||||
| 处理中 / 等待 | `#13C2C2` | ZS-003-06 | 处理中、排队、等待反馈 |
|
|
||||||
|
|
||||||
> 浅底变体（Message / Alert / Tag 底色）：前景色取 16% 透明度，如成功底 `rgba(82,196,26,0.16)`、警告底 `rgba(250,173,20,0.16)`。
|
|
||||||
> CSS Token 见 `tokens.css` 的 `--func-success / --func-warning / --func-error / --func-info / --func-processing`。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 字体
|
|
||||||
|
|
||||||
### 2.1 全局样式 - 字体
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 2.1.1 大屏页面字体规范
|
|
||||||
|
|
||||||
##### 中文字体：Noto Sans S Chinese
|
|
||||||
|
|
||||||
| 样式 | 使用场景 |
|
|
||||||
|------|----------|
|
|
||||||
| 24px Bold | 一级标题 |
|
|
||||||
| 24px Medium | 次要一级标题 |
|
|
||||||
| 22px Medium | 二级标题 |
|
|
||||||
| 22px Regular | 正文 |
|
|
||||||
| 20px Regular | 排版空间有限的正文 |
|
|
||||||
|
|
||||||
##### 数字字体：D-DIN
|
|
||||||
|
|
||||||
| 样式 | 使用场景 |
|
|
||||||
|------|----------|
|
|
||||||
| 32px Bold | 重要数据展示 |
|
|
||||||
| 32px Regular | 普通数据展示 |
|
|
||||||
| 26px Bold | 常规数据展示 |
|
|
||||||
| 26px Regular | 常规数据展示 |
|
|
||||||
|
|
||||||
##### 特殊数字：DS-Digital
|
|
||||||
|
|
||||||
| 样式 | 使用场景 |
|
|
||||||
|------|----------|
|
|
||||||
| 50px Bold | 大屏主数据展示 |
|
|
||||||
|
|
||||||
##### 表格字体：Arial
|
|
||||||
|
|
||||||
| 样式 | 使用场景 |
|
|
||||||
|------|----------|
|
|
||||||
| 20px Regular | 表格横纵轴数字 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 2.1.2 后台系统字体规范
|
|
||||||
|
|
||||||
##### 中文字体：Noto Sans S Chinese
|
|
||||||
|
|
||||||
| 样式 | 使用场景 |
|
|
||||||
|------|----------|
|
|
||||||
| 18px Bold | 导航、一级标题 |
|
|
||||||
| 18px Medium | 次要一级标题 |
|
|
||||||
| 16px Bold | 二级标题 |
|
|
||||||
| 16px Medium | 次要二级标题 |
|
|
||||||
| 16px Regular | 正文、按钮内部文字等 |
|
|
||||||
| 16px Light | 次要正文 |
|
|
||||||
|
|
||||||
##### 数字字体：D-DIN
|
|
||||||
|
|
||||||
| 样式 | 使用场景 |
|
|
||||||
|------|----------|
|
|
||||||
| 26px Bold | 重要数据展示 |
|
|
||||||
| 26px Regular | 普通数据展示 |
|
|
||||||
| 24px Bold | 常规数据展示（小） |
|
|
||||||
| 24px Regular | 常规数据展示（小） |
|
|
||||||
|
|
||||||
##### LOGO 字体：DOUYUFont
|
|
||||||
|
|
||||||
| 样式 | 使用场景 |
|
|
||||||
|------|----------|
|
|
||||||
| 20px 文字样式 | 页面顶部系统名称 |
|
|
||||||
|
|
||||||
##### 表格数字：Arial
|
|
||||||
|
|
||||||
| 样式 | 使用场景 |
|
|
||||||
|------|----------|
|
|
||||||
| 16px Regular | 表格横纵轴数字 |
|
|
||||||
| 14px Regular | 表格横轴数字（空间有限） |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 阴影
|
|
||||||
|
|
||||||
### 3.1 容器与卡片配色
|
|
||||||
|
|
||||||
阴影组通过深浅层级叠加形成空间感：外层容器最深，内层卡片次之，边框与高亮文字使用主色或字体色。
|
|
||||||
|
|
||||||
#### 3.1.1 外层容器
|
|
||||||
|
|
||||||
| 角色 | 色值 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 页面 / 最外层背景 | `#060E24` | ZS-004-10 |
|
|
||||||
| 分栏容器背景 | `#0C1836` | ZS-004-09 |
|
|
||||||
|
|
||||||
#### 3.1.2 卡片（标题 + 操作）
|
|
||||||
|
|
||||||
| 角色 | 色值 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 卡片背景 | `#122347` | ZS-004-08 |
|
|
||||||
| 卡片边框 | `#1A2F5A` | ZS-004-07 |
|
|
||||||
| 卡片阴影（外发光） | `rgba(22, 119, 255, 0.12)` | 基于 ZS-002-06 主色蓝 12% 透明度 |
|
|
||||||
| 标题文字（16px Bold） | `#C5CFE0` | ZS-004-02（正常字体色） |
|
|
||||||
| 操作按钮文字 | `#4096FF` | ZS-002-05（标准蓝，链接） |
|
|
||||||
| 次级操作图标（✏️ / ⋯） | `#6E88B0` | ZS-004-04（次级字体色） |
|
|
||||||
|
|
||||||
#### 3.1.3 卡片新增（占位卡片）
|
|
||||||
|
|
||||||
虚线描边的"新增入口"卡片，用于引导用户添加内容。
|
|
||||||
|
|
||||||
| 角色 | 色值 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 卡片背景 | `#0C1836` | ZS-004-09（与外层同色，营造凹陷感） |
|
|
||||||
| 虚线边框 | `#4096FF` | ZS-002-05 |
|
|
||||||
| 加号图标 | `#4096FF` | ZS-002-05 |
|
|
||||||
|
|
||||||
#### 3.1.4 阴影投影规则
|
|
||||||
|
|
||||||
| 层级 | 阴影值 | 使用场景 |
|
|
||||||
|------|--------|----------|
|
|
||||||
| 一级阴影（卡片悬浮） | `0 2px 8px rgba(22, 119, 255, 0.12)` | 普通卡片 |
|
|
||||||
| 二级阴影（hover / 强调） | `0 4px 16px rgba(22, 119, 255, 0.24)` | 卡片 hover、弹出层 |
|
|
||||||
| 三级阴影（弹窗 / Modal） | `0 8px 32px rgba(6, 14, 36, 0.6)` | Dialog、Drawer |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. 圆角
|
|
||||||
|
|
||||||
### 4.1 圆角统一规范
|
|
||||||
|
|
||||||
| 元素 | 圆角值 | 说明 |
|
|
||||||
|------|--------|------|
|
|
||||||
| 按钮 | `2px` | 所有按钮（主按钮 / 次按钮 / 文本按钮）统一使用 |
|
|
||||||
| 卡片 | `4px` | 内容卡片、标题+操作卡片、卡片新增占位 |
|
|
||||||
| 页面分栏框 | `4px` | 外层容器、分栏区域 |
|
|
||||||
| 输入框 / 选择器 | `2px` | 与按钮一致，保持表单内对齐 |
|
|
||||||
| Tag / Badge | `2px` | 与按钮一致 |
|
|
||||||
| Modal / Drawer | `4px` | 与卡片一致 |
|
|
||||||
|
|
||||||
### 4.2 按钮配色（圆角 2px）
|
|
||||||
|
|
||||||
#### 4.2.1 主按钮（Primary）
|
|
||||||
|
|
||||||
| 角色 | 色值 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 背景 | `#1677FF` | ZS-002-06 |
|
|
||||||
| 文字 | `#FFFFFF` | — |
|
|
||||||
| Hover 背景 | `#0958D9` | ZS-002-07 |
|
|
||||||
| Active 背景 | `#003EB3` | ZS-002-08 |
|
|
||||||
| 禁用背景 | `#4A6491` | ZS-004-05 |
|
|
||||||
| 禁用文字 | `#6E88B0` | ZS-004-04 |
|
|
||||||
|
|
||||||
#### 4.2.2 次按钮（Outline / Default）
|
|
||||||
|
|
||||||
| 角色 | 色值 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 背景 | `transparent` | — |
|
|
||||||
| 边框 | `#6E88B0` | ZS-004-04 |
|
|
||||||
| 文字 | `#C5CFE0` | ZS-004-02 |
|
|
||||||
| Hover 边框 | `#4096FF` | ZS-002-05 |
|
|
||||||
| Hover 文字 | `#4096FF` | ZS-002-05 |
|
|
||||||
| Active 边框 | `#1677FF` | ZS-002-06 |
|
|
||||||
|
|
||||||
### 4.3 卡片与分栏（圆角 4px）
|
|
||||||
|
|
||||||
| 角色 | 色值 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 卡片背景 | `#122347` | ZS-004-08 |
|
|
||||||
| 卡片边框 | `#1A2F5A` | ZS-004-07 |
|
|
||||||
| 分栏框背景 | `#0C1836` | ZS-004-09 |
|
|
||||||
| 分栏框边框 | `#1A2F5A` | ZS-004-07 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5. 按钮
|
|
||||||
|
|
||||||
> 全部圆角 `2px`，文字字号 14px（小尺寸）/ 14px（正常尺寸），字体 Noto Sans S Chinese Regular。
|
|
||||||
|
|
||||||
### 5.1 按钮尺寸
|
|
||||||
|
|
||||||
| 规格 | 高度 | 内边距 | 使用场景 |
|
|
||||||
|------|------|--------|----------|
|
|
||||||
| 小 | `28px` | `0 10px` | 空间小的板块内部，如表格中、卡片标题等 |
|
|
||||||
| 正常 | `32px` | `0 14px` | 默认尺寸，所有常用按钮 |
|
|
||||||
|
|
||||||
### 5.2 按钮类型与配色
|
|
||||||
|
|
||||||
#### 5.2.1 主按钮（Primary）
|
|
||||||
|
|
||||||
> 一个操作区域只能有一个主按钮。
|
|
||||||
|
|
||||||
| 状态 | 背景 | 边框 | 文字 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| 默认 | `#1677FF` (ZS-002-06) | — | `#FFFFFF` |
|
|
||||||
| Hover | `#0958D9` (ZS-002-07) | — | `#FFFFFF` |
|
|
||||||
| Active | `#003EB3` (ZS-002-08) | — | `#FFFFFF` |
|
|
||||||
| 失效 | `rgba(22, 119, 255, 0.35)` | — | `#6E88B0` (ZS-004-04) |
|
|
||||||
|
|
||||||
#### 5.2.2 默认按钮（Default / Outline）
|
|
||||||
|
|
||||||
用于"取消 / 返回"等次要操作，与主按钮成对出现时主按钮在右。
|
|
||||||
|
|
||||||
| 状态 | 背景 | 边框 | 文字 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| 默认 | `transparent` | `#6E88B0` (ZS-004-04) | `#C5CFE0` (ZS-004-02) |
|
|
||||||
| Hover | `rgba(22, 119, 255, 0.08)` | `#4096FF` (ZS-002-05) | `#4096FF` (ZS-002-05) |
|
|
||||||
| Active | `rgba(22, 119, 255, 0.16)` | `#1677FF` (ZS-002-06) | `#1677FF` (ZS-002-06) |
|
|
||||||
| 失效 | `transparent` | `#4A6491` (ZS-004-05) | `#4A6491` (ZS-004-05) |
|
|
||||||
|
|
||||||
#### 5.2.3 文本按钮（Text）
|
|
||||||
|
|
||||||
用于表格操作、文件下载等。无背景与边框，靠文字色识别。
|
|
||||||
|
|
||||||
| 状态 | 文字 | 装饰 |
|
|
||||||
|------|------|------|
|
|
||||||
| 默认 | `#4096FF` (ZS-002-05) | 无下划线 |
|
|
||||||
| Hover | `#1677FF` (ZS-002-06) | 显示下划线（与文字同色） |
|
|
||||||
| Active | `#0958D9` (ZS-002-07) | 下划线 |
|
|
||||||
| 失效 | `#4A6491` (ZS-004-05) | 无装饰 |
|
|
||||||
|
|
||||||
#### 5.2.4 图标按钮（Icon-only）
|
|
||||||
|
|
||||||
用于增强辨识度或节省空间。仅图标，无文字。
|
|
||||||
|
|
||||||
| 变体 | 背景 | 图标颜色 |
|
|
||||||
|------|------|----------|
|
|
||||||
| 主色（常用） | `#1677FF` (ZS-002-06) | `#FFFFFF` |
|
|
||||||
| 主色 Hover | `#0958D9` (ZS-002-07) | `#FFFFFF` |
|
|
||||||
| 危险（删除等） | `#F5222D` (ZS-001-06) | `#FFFFFF` |
|
|
||||||
| 危险 Hover | `#CF1322` (ZS-001-07) | `#FFFFFF` |
|
|
||||||
| 透明（仅图标） | `transparent` | `#6E88B0` (ZS-004-04) → hover `#4096FF` (ZS-002-05) |
|
|
||||||
|
|
||||||
### 5.3 按钮组合
|
|
||||||
|
|
||||||
#### 5.3.1 文字 + 下拉按钮（含 ▾）
|
|
||||||
|
|
||||||
两种填充：
|
|
||||||
|
|
||||||
| 形态 | 配色规则 |
|
|
||||||
|------|----------|
|
|
||||||
| 默认（Outline） | 沿用 §5.2.2 默认按钮，箭头 ▾ 与文字同色 `#C5CFE0` |
|
|
||||||
| 主色（Filled） | 沿用 §5.2.1 主按钮，箭头 ▾ 同步白色 `#FFFFFF` |
|
|
||||||
|
|
||||||
#### 5.3.2 图标 + 文字按钮（如 `+ 正常`）
|
|
||||||
|
|
||||||
| 形态 | 配色规则 |
|
|
||||||
|------|----------|
|
|
||||||
| 默认（Outline） | 沿用 §5.2.2，左侧图标颜色与文字一致 `#C5CFE0` |
|
|
||||||
| 主色（Filled） | 沿用 §5.2.1，左侧图标与文字一致 `#FFFFFF` |
|
|
||||||
|
|
||||||
#### 5.3.3 文本按钮 + 图标（"更多 »"、"展开 ⌄"、"下一页 »"、"« 上一页"）
|
|
||||||
|
|
||||||
| 角色 | 色值 |
|
|
||||||
|------|------|
|
|
||||||
| 文字 + 图标（默认） | `#4096FF` (ZS-002-05) |
|
|
||||||
| 文字 + 图标（Hover） | `#1677FF` (ZS-002-06) |
|
|
||||||
| 失效 | `#4A6491` (ZS-004-05) |
|
|
||||||
|
|
||||||
> 图标可在文字前或后；多个文本按钮排成一行时，间距 `16px`，无分隔符。
|
|
||||||
|
|
||||||
#### 5.3.4 主按钮 + 默认按钮组合（如"确定 / 取消 / 返回"）
|
|
||||||
|
|
||||||
- **排列顺序**：默认按钮在左，主按钮在右（最右侧为主操作）
|
|
||||||
- **按钮间距**：`8px`
|
|
||||||
- **示例**：`[ 返回 ] [ 取消 ] [ 确定 ]`
|
|
||||||
- **配色**：主按钮沿用 §5.2.1，其余沿用 §5.2.2
|
|
||||||
|
|
||||||
### 5.4 其他按钮
|
|
||||||
|
|
||||||
#### 5.4.1 悬浮状态（Floating）
|
|
||||||
|
|
||||||
用于 Banner / 登录 / 视觉冲击强等展示场景。配色与主按钮一致，叠加阴影抬升。
|
|
||||||
|
|
||||||
| 状态 | 阴影 |
|
|
||||||
|------|------|
|
|
||||||
| 默认 | `0 2px 8px rgba(22, 119, 255, 0.12)`（§3.1.4 一级阴影） |
|
|
||||||
| Hover | `0 4px 16px rgba(22, 119, 255, 0.24)`（§3.1.4 二级阴影） |
|
|
||||||
| Active | 阴影消失，按下感 |
|
|
||||||
|
|
||||||
#### 5.4.2 加载中（Loading）
|
|
||||||
|
|
||||||
用于异步操作等待反馈。点击瞬间将按钮锁定，文字前显示旋转图标。
|
|
||||||
|
|
||||||
| 角色 | 色值 |
|
|
||||||
|------|------|
|
|
||||||
| 背景 | `#1677FF` (ZS-002-06) |
|
|
||||||
| 文字 | `#FFFFFF` |
|
|
||||||
| 加载图标 | `#FFFFFF`，旋转动画 `1.2s linear infinite` |
|
|
||||||
| 不可点击 | 鼠标 `cursor: not-allowed` |
|
|
||||||
|
|
||||||
> 与失效态的区别：失效是"不可操作"，加载是"操作进行中"——保留品牌主色，只是不可再次触发。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 6. 分割线
|
|
||||||
|
|
||||||
> 统一线宽 `1px`，颜色全部从 ZS-004 深蓝系取色，与深色背景保持低对比度但仍可识别。
|
|
||||||
|
|
||||||
### 6.1 水平分割线
|
|
||||||
|
|
||||||
水平分割线常用来对不同元素内容进行分割。
|
|
||||||
|
|
||||||
| 类型 | 色值 | 来源 | 样式 | 使用场景 |
|
|
||||||
|------|------|------|------|----------|
|
|
||||||
| 实线（默认） | `#4A6491` | ZS-004-05 | `border-top: 1px solid` | 模块间、列表项间分割 |
|
|
||||||
| 实线（强调） | `#6E88B0` | ZS-004-04 | `border-top: 1px solid` | 主区块标题下方、卡片头部分割 |
|
|
||||||
| 实线（弱化） | `#2D4473` | ZS-004-06 | `border-top: 1px solid` | 卡片内部、密集列表分隔 |
|
|
||||||
| 虚线 | `#4A6491` | ZS-004-05 | `border-top: 1px dashed` | 次级 / 层级内分割，提示"非主结构" |
|
|
||||||
| 主色实线（高亮） | `#1677FF` | ZS-002-06 | `border-top: 1px solid` | 强调分隔，少量使用（如当前激活区块底边） |
|
|
||||||
|
|
||||||
### 6.2 垂直分割线
|
|
||||||
|
|
||||||
垂直分割线常用来做行内分割（如导航项之间、状态指示之间、表格列头之间）。
|
|
||||||
|
|
||||||
| 类型 | 色值 | 来源 | 样式 | 使用场景 |
|
|
||||||
|------|------|------|------|----------|
|
|
||||||
| 实线（默认） | `#4A6491` | ZS-004-05 | `border-left: 1px solid` | 行内 inline 元素分割（面包屑、操作按钮组） |
|
|
||||||
| 实线（弱化） | `#2D4473` | ZS-004-06 | `border-left: 1px solid` | 表格列分割、紧凑布局 |
|
|
||||||
| 虚线 | `#4A6491` | ZS-004-05 | `border-left: 1px dashed` | 多列对齐辅助、辅助参考线 |
|
|
||||||
|
|
||||||
### 6.3 规格与间距
|
|
||||||
|
|
||||||
| 规则 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 线宽 | `1px` |
|
|
||||||
| 水平分割线与上下元素间距 | `≥ 8px`（紧凑布局可用 `4px`） |
|
|
||||||
| 垂直分割线与左右元素间距 | `≥ 8px`（行内紧凑 `4px`） |
|
|
||||||
| 垂直分割线高度 | 与文字行高一致，约 `12–14px`（也可全高跟随容器） |
|
|
||||||
| 透明度 | 必要时叠 `opacity: 0.6` 实现"更弱"层级 |
|
|
||||||
|
|
||||||
### 6.4 CSS 参考
|
|
||||||
|
|
||||||
```css
|
|
||||||
/* 默认水平分割线 */
|
|
||||||
.divider-h { border-top: 1px solid #4A6491; }
|
|
||||||
.divider-h-strong { border-top: 1px solid #6E88B0; }
|
|
||||||
.divider-h-weak { border-top: 1px solid #2D4473; }
|
|
||||||
.divider-h-dashed { border-top: 1px dashed #4A6491; }
|
|
||||||
.divider-h-accent { border-top: 1px solid #1677FF; }
|
|
||||||
|
|
||||||
/* 垂直分割线 */
|
|
||||||
.divider-v { border-left: 1px solid #4A6491; height: 14px; display: inline-block; vertical-align: middle; }
|
|
||||||
.divider-v-weak { border-left: 1px solid #2D4473; height: 14px; display: inline-block; vertical-align: middle; }
|
|
||||||
.divider-v-dashed { border-left: 1px dashed #4A6491; height: 14px; display: inline-block; vertical-align: middle; }
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 7. 间距
|
|
||||||
|
|
||||||
> 全站以 `8px (0.5rem)` 为对照基准单位，划分"密 / 疏"两个层次。所有间距取值均来自下列阶梯，禁止使用非阶梯值（如 5px、13px）。
|
|
||||||
|
|
||||||
### 7.1 间距阶梯
|
|
||||||
|
|
||||||
| 阶 | px | rem | 分组 | 典型场景 |
|
|
||||||
|----|------|--------|------|----------|
|
|
||||||
| 1 | `4px` | `0.25rem` | 密 | 图标与文字间距、Tag 内边距、紧凑徽标 |
|
|
||||||
| 2 | `8px` | `0.5rem` | 密 | 行内元素相邻、按钮组间距、表单 label 与控件 |
|
|
||||||
| 3 | `12px` | `0.75rem` | 密 | 表单项垂直间距、列表项内边距 |
|
|
||||||
| 4 | `16px` | `1rem` | 密 | 卡片内容内边距、模块内分隔 |
|
|
||||||
| 5 | `24px` | `1.5rem` | 疏 | 模块之间、Section 内边距 |
|
|
||||||
| 6 | `32px` | `2rem` | 疏 | 卡片之间、表单组之间 |
|
|
||||||
| 7 | `40px` | `2.5rem` | 疏 | 主区块之间、页面 Header / Footer 内边距 |
|
|
||||||
| 8 | `56px` | `3.5rem` | 疏 | 页面段落级隔断、Banner 区域 |
|
|
||||||
|
|
||||||
> "密"对应紧凑信息密度（表格、表单、卡片内部）；"疏"对应视觉呼吸（模块之间、页面整体留白）。**16px 是"密"的上限，24px 是"疏"的下限**，两者之间不应再插入自定义值。
|
|
||||||
|
|
||||||
### 7.2 使用原则
|
|
||||||
|
|
||||||
- **同层级一致**：同一布局层级内的间距必须使用同一阶值；多种取值会破坏节奏。
|
|
||||||
- **就近取阶**：相邻区块的间距尽量从相邻阶梯取值（如 `16px → 24px`），跨越过多阶（如 `8px → 56px`）会让视觉断裂。
|
|
||||||
- **密疏不混用**：一个组件内部全部用"密"，外部用"疏"，避免内/外间距颠倒。
|
|
||||||
- **优先 8 的倍数**：除最小阶 `4px` 外，所有阶皆为 8 的倍数，方便 4/8 网格对齐。
|
|
||||||
- **响应式按比例衰减**：移动端可整体降一阶（如 `24px → 16px`），但仍在阶梯内。
|
|
||||||
|
|
||||||
### 7.3 CSS Token 建议
|
|
||||||
|
|
||||||
```css
|
|
||||||
:root {
|
|
||||||
--spacing-1: 4px; /* 0.25rem */
|
|
||||||
--spacing-2: 8px; /* 0.5rem */
|
|
||||||
--spacing-3: 12px; /* 0.75rem */
|
|
||||||
--spacing-4: 16px; /* 1rem */
|
|
||||||
--spacing-5: 24px; /* 1.5rem */
|
|
||||||
--spacing-6: 32px; /* 2rem */
|
|
||||||
--spacing-7: 40px; /* 2.5rem */
|
|
||||||
--spacing-8: 56px; /* 3.5rem */
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### 7.4 与已有规范的对齐
|
|
||||||
|
|
||||||
| 已有规则 | 对应阶 |
|
|
||||||
|----------|--------|
|
|
||||||
| §4.x 卡片圆角内边距 | `--spacing-4` (16px) |
|
|
||||||
| §5.3.4 主+默认按钮组合间距 `8px` | `--spacing-2` |
|
|
||||||
| §5.3.3 文本按钮间距 `16px` | `--spacing-4` |
|
|
||||||
| §6.3 分割线与上下元素间距 `≥ 8px` | `--spacing-2` 起 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
@@ -1,780 +0,0 @@
|
|||||||
# 深蓝色 UI 规范 · 01 导航（§8–§13）
|
|
||||||
|
|
||||||
> 《深蓝色 UI 规范》分册之一。基础令牌见 `00-基础-色彩字体间距.md`，可 import 的变量见 `tokens.css`，总目录与 §索引见 `README.md`。`§N` 编号全局唯一。
|
|
||||||
|
|
||||||
**本篇目录**：`8` 导航组件 · `9` 锚点与页签 · `10` 步骤条 · `11` 面包屑 · `12` 页头 · `13` 分页
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 8. 导航组件
|
|
||||||
|
|
||||||
> 适用于"大屏后台 / 控制台"类深蓝主题界面。整体结构 = 顶部导航 + 左侧分级菜单 + 多级下拉。所有颜色取自 ZS-002 / ZS-004 两个色系。
|
|
||||||
|
|
||||||
### 8.1 整体结构
|
|
||||||
|
|
||||||
```
|
|
||||||
┌─ 顶部导航（Header）─ 高 56px ──────────────────────────────────────────────┐
|
|
||||||
│ ≡ 二级菜单 二级菜单 二级菜单 〈一级菜单〉〈一级菜单〉 ⟪ XXXX系统 ⟫ 〈一级菜单〉 ⟳ 时间 ⌂ 返回首页 │
|
|
||||||
├──┬──────────────────────────────────────────────────────────────────────────┤
|
|
||||||
│ 三│ ┌─ 四级菜单（下拉面板）──┐ │
|
|
||||||
│ 级│ │ ▾ 四级菜单 │ │
|
|
||||||
│ 菜│ │ ▾ 五级菜单 │ │
|
|
||||||
│ 单│ │ - 六级菜单 (active)│ │
|
|
||||||
│ 三│ │ - 六级菜单 │ │
|
|
||||||
│ 级│ │ ▸ 五级菜单 │ │
|
|
||||||
│ 菜│ │ ▸ 四级菜单 │ │
|
|
||||||
│ 单│ └────────────────────────┘ │
|
|
||||||
│ …│ │
|
|
||||||
└──┴──────────────────────────────────────────────────────────────────────────┘
|
|
||||||
```
|
|
||||||
|
|
||||||
### 8.2 顶部导航（Header）
|
|
||||||
|
|
||||||
#### 8.2.1 规格
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 高度 | `56px` |
|
|
||||||
| 左右 padding | `--spacing-4` (16px) |
|
|
||||||
| 背景 | 渐变 `linear-gradient(180deg, #122347 0%, #0C1836 100%)`（ZS-004-08 → ZS-004-09） |
|
|
||||||
| 底边 | `border-bottom: 1px solid #1A2F5A` (ZS-004-07) |
|
|
||||||
| 阴影 | `0 2px 8px rgba(6, 14, 36, 0.6)`（§3.1.4 一级阴影变体） |
|
|
||||||
| 文字基线 | `Noto Sans S Chinese`，垂直居中 |
|
|
||||||
|
|
||||||
#### 8.2.2 二级菜单（左侧 Tabs，小号 14px）
|
|
||||||
|
|
||||||
| 状态 | 文字 | 背景 | 装饰 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| 默认 | `#6E88B0` (ZS-004-04) | `transparent` | — |
|
|
||||||
| Hover | `#C5CFE0` (ZS-004-02) | `rgba(22,119,255,0.08)` | — |
|
|
||||||
| 激活 | `#4096FF` (ZS-002-05) | `transparent` | 底部 `2px solid #4096FF` 高亮线 |
|
|
||||||
|
|
||||||
- 字号 `14px Regular`，间距 `--spacing-3` (12px)
|
|
||||||
- 与最左侧的"折叠菜单 ≡"图标间距 `--spacing-4` (16px)
|
|
||||||
|
|
||||||
#### 8.2.3 一级菜单（中部主导航，16px 带切角装饰）
|
|
||||||
|
|
||||||
| 状态 | 文字 | 装饰 |
|
|
||||||
|------|------|------|
|
|
||||||
| 默认 | `#C5CFE0` (ZS-004-02) | 两端切角斜边，`border: 1px solid #1A2F5A` |
|
|
||||||
| Hover | `#4096FF` (ZS-002-05) | 切角线变 `#4096FF` |
|
|
||||||
| 激活 | `#FFFFFF` | 切角线 `#1677FF` (ZS-002-06)，背景 `rgba(22,119,255,0.16)` |
|
|
||||||
|
|
||||||
- 字号 `16px Medium`
|
|
||||||
- 切角推荐 `clip-path: polygon(8px 0, calc(100% - 8px) 0, 100% 100%, 0 100%)`
|
|
||||||
- 项间距 `--spacing-2` (8px)
|
|
||||||
|
|
||||||
#### 8.2.4 系统标题（XXXX系统）
|
|
||||||
|
|
||||||
- 字号 `20px Bold`，颜色 `#FFFFFF`
|
|
||||||
- 字体 `DOUYUFont` 或 Noto Sans Medium
|
|
||||||
- 左右装饰用主色蓝渐变线条：`linear-gradient(90deg, transparent 0%, #1677FF 50%, transparent 100%)`，线宽 `1px`
|
|
||||||
- 居中相对 Header 几何中心，左右最少留 `--spacing-6` (32px) 间距给一级菜单
|
|
||||||
|
|
||||||
#### 8.2.5 右侧工具区（时间 / 图标 / 返回首页）
|
|
||||||
|
|
||||||
| 元素 | 字号/尺寸 | 颜色 |
|
|
||||||
|------|----------|------|
|
|
||||||
| 更新时间文字 | `12px Regular` | `#6E88B0` (ZS-004-04) |
|
|
||||||
| 时间数值（数字） | `12px D-DIN Regular` | `#C5CFE0` (ZS-004-02) |
|
|
||||||
| 工具图标（刷新/上/家） | `16px` | `#6E88B0`，hover → `#4096FF` |
|
|
||||||
| 返回首页文字 | `14px Regular` | `#C5CFE0`，hover → `#4096FF` |
|
|
||||||
|
|
||||||
- 元素间距 `--spacing-3` (12px)
|
|
||||||
- 整体右 padding `--spacing-4` (16px)
|
|
||||||
|
|
||||||
### 8.3 侧边栏（三级菜单）
|
|
||||||
|
|
||||||
#### 8.3.1 规格
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 宽度 | `64px`（仅图标 / 竖排文字） |
|
|
||||||
| 背景 | `#0C1836` (ZS-004-09) |
|
|
||||||
| 右边界 | `border-right: 1px solid #1A2F5A` (ZS-004-07) |
|
|
||||||
| 项高度 | `64px`（与宽度一致，呈正方形） |
|
|
||||||
| 项内间距 | 上下 `--spacing-3` (12px) |
|
|
||||||
| 字号 | `14px Medium`，竖排（`writing-mode: vertical-rl`）或正常排两行 |
|
|
||||||
|
|
||||||
#### 8.3.2 状态配色
|
|
||||||
|
|
||||||
| 状态 | 背景 | 文字 | 左侧指示条 |
|
|
||||||
|------|------|------|-----------|
|
|
||||||
| 默认 | `transparent` | `#6E88B0` (ZS-004-04) | 无 |
|
|
||||||
| Hover | `rgba(22,119,255,0.08)` | `#C5CFE0` (ZS-004-02) | 无 |
|
|
||||||
| 激活 | `#1A2F5A` (ZS-004-07) | `#FFFFFF` | 左侧 `2px solid #1677FF` (ZS-002-06) |
|
|
||||||
|
|
||||||
### 8.4 下拉菜单面板（四级 / 五级 / 六级）
|
|
||||||
|
|
||||||
#### 8.4.1 面板规格
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 背景 | `#122347` (ZS-004-08) |
|
|
||||||
| 边框 | `1px solid #1A2F5A` (ZS-004-07) |
|
|
||||||
| 阴影 | `0 4px 16px rgba(6, 14, 36, 0.6)`（§3.1.4 三级阴影变体） |
|
|
||||||
| 圆角 | `4px` |
|
|
||||||
| 内边距 | 上下 `--spacing-2` (8px) |
|
|
||||||
| 最小宽度 | `150px` |
|
|
||||||
|
|
||||||
#### 8.4.2 菜单项规格
|
|
||||||
|
|
||||||
| 层级 | 缩进（padding-left） | 字号 | 展开图标 | 前缀 |
|
|
||||||
|------|---------------------|------|----------|------|
|
|
||||||
| 四级菜单 | `--spacing-3` (12px) | `14px Medium` | `▾ / ▸` | — |
|
|
||||||
| 五级菜单 | `--spacing-5` (24px) | `14px Regular` | `▾ / ▸` | — |
|
|
||||||
| 六级菜单 | `--spacing-6` (32px) | `14px Regular` | — | `-` 短横线 |
|
|
||||||
|
|
||||||
- 行高 `32px`
|
|
||||||
- 项之间无分割线（靠缩进与图标区分层级）
|
|
||||||
|
|
||||||
#### 8.4.3 菜单项配色
|
|
||||||
|
|
||||||
| 状态 | 背景 | 文字 | 展开图标 |
|
|
||||||
|------|------|------|----------|
|
|
||||||
| 默认 | `transparent` | `#C5CFE0` (ZS-004-02) | `#6E88B0` (ZS-004-04) |
|
|
||||||
| Hover | `rgba(22,119,255,0.08)` | `#4096FF` (ZS-002-05) | `#4096FF` |
|
|
||||||
| 激活（当前选中） | `rgba(22,119,255,0.16)` | `#4096FF` (ZS-002-05) | `#1677FF` (ZS-002-06) |
|
|
||||||
| 父级（含激活子项） | `transparent` | `#FFFFFF` | `#1677FF` |
|
|
||||||
| 失效 | `transparent` | `#4A6491` (ZS-004-05) | `#4A6491` |
|
|
||||||
|
|
||||||
### 8.5 交互与动画
|
|
||||||
|
|
||||||
| 行为 | 动效 |
|
|
||||||
|------|------|
|
|
||||||
| 下拉面板展开 | `transform-origin: top; transform: scaleY(0.95) → scaleY(1); opacity 0 → 1`，`200ms ease-out` |
|
|
||||||
| 展开图标旋转 | `transform: rotate(0 → 90deg)`，`200ms ease-out` |
|
|
||||||
| Hover 背景过渡 | `background-color 120ms ease-out` |
|
|
||||||
| 激活底部高亮线（二级菜单） | `width 0% → 100%`，`240ms ease-out` |
|
|
||||||
|
|
||||||
### 8.6 间距引用
|
|
||||||
|
|
||||||
| 位置 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| Header 内部元素间距 | `--spacing-2 / --spacing-3` |
|
|
||||||
| Header 与下方内容间距 | `0`（贴合，靠底边线与阴影区分） |
|
|
||||||
| 侧边栏与下拉面板间距 | `--spacing-1` (4px) |
|
|
||||||
| 下拉面板与触发元素间距 | `--spacing-1` (4px) |
|
|
||||||
| 同级菜单项之间 | `0`（紧贴排列，靠 hover/active 背景区分） |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 9. 锚点与页签
|
|
||||||
|
|
||||||
> 对应"4.2 导航组件-锚点"。三类组件共用主色蓝指示当前位置：**页签 / 锚点 / 回到顶部**。
|
|
||||||
>
|
|
||||||
> 视觉参考：标签横向 / 标签纵向 / 锚点的三联图见设计稿「选项卡.png」——三种形态在本节均已规范化（§9.1 = 标签横纵向、§9.2 = 锚点）。
|
|
||||||
|
|
||||||
### 9.1 页签（Tabs）
|
|
||||||
|
|
||||||
#### 9.1.1 横向页签（下划线-横向）
|
|
||||||
|
|
||||||
| 状态 | 文字 | 下划线 |
|
|
||||||
|------|------|--------|
|
|
||||||
| 默认 | `#C5CFE0` (ZS-004-02) | 无 |
|
|
||||||
| Hover | `#4096FF` (ZS-002-05) | 无 |
|
|
||||||
| 激活 | `#4096FF` (ZS-002-05) | `2px solid #4096FF`，宽度与文字齐 |
|
|
||||||
| 失效 | `#4A6491` (ZS-004-05) | 无 |
|
|
||||||
|
|
||||||
- 字号 `14px Medium`
|
|
||||||
- 项间距 `--spacing-5` (24px)
|
|
||||||
- 下划线与文字底部间距 `--spacing-2` (8px)
|
|
||||||
- 容器底边可叠一条 `1px solid #1A2F5A` (ZS-004-07) 作为基线，激活态的高亮线压在上面
|
|
||||||
|
|
||||||
#### 9.1.2 纵向页签（下划线-纵向）
|
|
||||||
|
|
||||||
| 状态 | 文字 | 右侧指示线 |
|
|
||||||
|------|------|-----------|
|
|
||||||
| 默认 | `#C5CFE0` (ZS-004-02) | 无 |
|
|
||||||
| Hover | `#4096FF` (ZS-002-05) | 无 |
|
|
||||||
| 激活 | `#4096FF` (ZS-002-05) | 右侧 `2px solid #4096FF`，高度与文字齐 |
|
|
||||||
| 失效 | `#4A6491` (ZS-004-05) | 无 |
|
|
||||||
|
|
||||||
- 字号 `14px Medium`，项高度 `32px`
|
|
||||||
- 项间距 `--spacing-2` (8px)
|
|
||||||
- 容器右边可叠一条 `1px solid #1A2F5A` 基线，激活指示线压在上面
|
|
||||||
|
|
||||||
### 9.2 锚点（Anchor）
|
|
||||||
|
|
||||||
用于长内容页（如详情页、文档页）的章节快速跳转。
|
|
||||||
|
|
||||||
#### 9.2.1 结构
|
|
||||||
|
|
||||||
```
|
|
||||||
│ 一级
|
|
||||||
│ 一级 (active)
|
|
||||||
│ 二级
|
|
||||||
│ 二级
|
|
||||||
│ 一级
|
|
||||||
│ 一级
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 9.2.2 规格
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 容器背景 | `#122347` (ZS-004-08) 或 `transparent`（嵌入页面侧栏时） |
|
|
||||||
| 左侧基线 | `1px solid #1A2F5A` (ZS-004-07) 通栏 |
|
|
||||||
| 项高度 | `32px` |
|
|
||||||
| 一级项左 padding | `--spacing-3` (12px) |
|
|
||||||
| 二级项左 padding | `--spacing-5` (24px) |
|
|
||||||
| 项间距 | `0`（贴合排列） |
|
|
||||||
| 字号 | `14px Regular` |
|
|
||||||
|
|
||||||
#### 9.2.3 状态配色
|
|
||||||
|
|
||||||
| 状态 | 一级文字 | 二级文字 | 左侧指示条 |
|
|
||||||
|------|----------|----------|-----------|
|
|
||||||
| 默认 | `#C5CFE0` (ZS-004-02) | `#6E88B0` (ZS-004-04) | 无 |
|
|
||||||
| Hover | `#4096FF` (ZS-002-05) | `#4096FF` (ZS-002-05) | 无 |
|
|
||||||
| 激活 | `#4096FF` (ZS-002-05) | — | 左侧 `2px solid #4096FF`，覆盖容器基线 |
|
|
||||||
| 父级（含激活子项） | `#FFFFFF` | — | — |
|
|
||||||
|
|
||||||
- 激活态指示条与基线重合，宽 `2px`，色压主色蓝 `#4096FF`
|
|
||||||
- 二级项**不单独支持激活态**：当二级被点中时，其父级一级显示激活态，左侧指示条按父级位置渲染
|
|
||||||
|
|
||||||
#### 9.2.4 滚动同步
|
|
||||||
|
|
||||||
| 行为 | 规则 |
|
|
||||||
|------|------|
|
|
||||||
| 页面滚动 | 监听锚点对应区块进入视口的相对位置，自动切换激活态 |
|
|
||||||
| 点击锚点 | `behavior: smooth` 滚动到目标，激活指示条 `top` 过渡 `200ms ease-out` |
|
|
||||||
| 边界处理 | 滚动到页面顶部 → 第一个锚点激活；到页尾 → 最后一个锚点激活 |
|
|
||||||
|
|
||||||
### 9.3 回到顶部（BackToTop）
|
|
||||||
|
|
||||||
固定在视口右下角的悬浮按钮，向上滚动到页面顶部。
|
|
||||||
|
|
||||||
#### 9.3.1 规格
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 形状 | 圆形 `40px × 40px`（`border-radius: 50%`） |
|
|
||||||
| 图标 | `↑` 上箭头，`16px`，`#FFFFFF` |
|
|
||||||
| 距视口右边 | `--spacing-5` (24px) |
|
|
||||||
| 距视口下边 | `--spacing-6` (32px) |
|
|
||||||
| 出现时机 | 页面 `scrollTop > 200px` 时淡入；回到顶部后淡出 |
|
|
||||||
| 淡入/淡出 | `opacity 0 → 1` / `1 → 0`，`200ms ease-out` |
|
|
||||||
|
|
||||||
#### 9.3.2 状态配色
|
|
||||||
|
|
||||||
| 状态 | 背景 | 阴影 | 图标 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| 正常（默认） | `#1677FF` (ZS-002-06) | `0 2px 8px rgba(22,119,255,0.12)` (§3.1.4 一级阴影) | `#FFFFFF` |
|
|
||||||
| 悬停（Hover） | `#0958D9` (ZS-002-07) | `0 4px 16px rgba(22,119,255,0.24)` (§3.1.4 二级阴影) | `#FFFFFF` |
|
|
||||||
| 点按（Active） | `#003EB3` (ZS-002-08) | 阴影消失，按下感 | `#FFFFFF` |
|
|
||||||
| 失效 / 不显示 | — | — | 整体 `opacity: 0`，`pointer-events: none` |
|
|
||||||
|
|
||||||
#### 9.3.3 悬停 Tooltip
|
|
||||||
|
|
||||||
Hover 状态下方显示 `回到顶部` 提示气泡：
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 文字 | `回到顶部`，`12px Regular` |
|
|
||||||
| 文字颜色 | `#C5CFE0` (ZS-004-02) |
|
|
||||||
| 背景 | `#1677FF` (ZS-002-06) |
|
|
||||||
| 圆角 | `2px` |
|
|
||||||
| 内边距 | 上下 `4px`，左右 `--spacing-2` (8px) |
|
|
||||||
| 与按钮间距 | `--spacing-2` (8px) |
|
|
||||||
| 出现时机 | Hover 进入 `300ms` 后显示，离开立即消失 |
|
|
||||||
|
|
||||||
### 9.4 三者的差异与选用
|
|
||||||
|
|
||||||
| 组件 | 主要用途 | 视觉特征 |
|
|
||||||
|------|----------|---------|
|
|
||||||
| 页签 | 同层级内容切换（多 Tab 互斥） | 文字 + 下划线（横/纵） |
|
|
||||||
| 锚点 | 长页面内章节跳转 | 文字 + 左侧指示条 + 层级缩进 |
|
|
||||||
| 回到顶部 | 长页面快速返回起点 | 圆形悬浮按钮 + 上箭头 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 10. 步骤条
|
|
||||||
|
|
||||||
> 对应「4.7 导航组件-步骤条」。用于多步流程的进度指引，按布局方向分**横向**与**纵向**两类，按使用场景分**弹窗步骤条**、**页面步骤条**、**纵向步骤条**三种。所有颜色取自 ZS-002 主色蓝与 ZS-004 深蓝系。
|
|
||||||
|
|
||||||
### 10.1 步骤节点（公共）
|
|
||||||
|
|
||||||
每个步骤由「指示圆 + 标题（可选描述）」组成。指示圆按状态切换三种形态：
|
|
||||||
|
|
||||||
| 状态 | 圆形外观 | 圆内符号 | 来源 |
|
|
||||||
|------|----------|----------|------|
|
|
||||||
| 已完成（Completed） | 描边圆，`2px solid #1677FF`，背景 `transparent` | `✓`（对勾，`#1677FF`） | ZS-002-06 |
|
|
||||||
| 当前（Current / Active） | 实心圆，背景 `#1677FF` | 步骤数字，`#FFFFFF` | ZS-002-06 / 白 |
|
|
||||||
| 未开始（Upcoming） | 描边圆，`1px solid #4A6491`，背景 `transparent` | 步骤数字，`#6E88B0` | ZS-004-05 / ZS-004-04 |
|
|
||||||
| 失效（Disabled） | 描边圆，`1px solid #2D4473`，背景 `transparent` | 步骤数字，`#4A6491` | ZS-004-06 / ZS-004-05 |
|
|
||||||
|
|
||||||
**指示圆规格**：
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 直径 | `24px` |
|
|
||||||
| 圆内字号 | `12px Bold`（D-DIN 或 Noto Sans Bold） |
|
|
||||||
| 对勾图标 | `12px`，居中 |
|
|
||||||
| 字体水平居中 | 数字 / 对勾 在圆几何中心 |
|
|
||||||
|
|
||||||
**标题与描述文字**：
|
|
||||||
|
|
||||||
| 元素 | 状态 | 字号 / 颜色 | 来源 |
|
|
||||||
|------|------|-------------|------|
|
|
||||||
| 标题 | 已完成 / 当前 | `14px Medium`，`#FFFFFF` | — |
|
|
||||||
| 标题 | 未开始 | `14px Medium`，`#6E88B0` | ZS-004-04 |
|
|
||||||
| 标题 | 失效 | `14px Medium`，`#4A6491` | ZS-004-05 |
|
|
||||||
| 描述 | 已完成 / 当前 | `12px Regular`，`#C5CFE0` | ZS-004-02 |
|
|
||||||
| 描述 | 未开始 / 失效 | `12px Regular`，`#6E88B0` → `#4A6491` | ZS-004-04 → ZS-004-05 |
|
|
||||||
|
|
||||||
**连接线（步骤之间）**：
|
|
||||||
|
|
||||||
| 类型 | 色值 | 来源 | 样式 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| 已完成段（前一节点已完成） | `#1677FF` | ZS-002-06 | `1px dashed`（弹窗）/ `1px solid`（页面） |
|
|
||||||
| 未完成段 | `#4A6491` | ZS-004-05 | `1px dashed` |
|
|
||||||
|
|
||||||
> 连接线在指示圆**两侧水平居中**（横向）或**正下方垂直**（纵向）；线两端与圆外缘留 `--spacing-1` (4px) 间隙，避免线穿圆。
|
|
||||||
|
|
||||||
### 10.2 弹窗步骤条（横向 · 描边圆为主）
|
|
||||||
|
|
||||||
用于 Modal / Drawer 内引导多步操作的紧凑步骤条。指示圆**完成态用描边 + 对勾**而非实心，避免在弹窗背景上过于抢眼。
|
|
||||||
|
|
||||||
#### 10.2.1 布局
|
|
||||||
|
|
||||||
```
|
|
||||||
( ✓ ) ┄┄┄┄┄ (●2) ┄┄┄┄┄ ( 3 ) ┄┄┄┄┄ ( 4 ) ┄┄┄┄┄ ( 5 )
|
|
||||||
标题 标题 标题 标题 标题
|
|
||||||
(描述) (描述) (描述) (描述) (描述)
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 10.2.2 规格
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 容器水平 padding | `--spacing-5` (24px) |
|
|
||||||
| 指示圆 → 标题间距 | `--spacing-2` (8px) |
|
|
||||||
| 标题 → 描述间距 | `--spacing-1` (4px) |
|
|
||||||
| 节点之间水平间距 | 节点间距自适应等分；连接线占用中间空间 |
|
|
||||||
| 连接线 | `1px dashed`，已完成段 `#1677FF`，未完成段 `#4A6491` |
|
|
||||||
| 文字对齐 | 标题、描述居中对齐于指示圆下方 |
|
|
||||||
|
|
||||||
#### 10.2.3 两种变体
|
|
||||||
|
|
||||||
| 变体 | 适用 |
|
|
||||||
|------|------|
|
|
||||||
| **仅标题** | 步骤含义已经清晰（如「填写信息 / 确认 / 完成」），节省垂直空间 |
|
|
||||||
| **标题 + 描述** | 步骤名抽象需要一行小字补充时使用 |
|
|
||||||
|
|
||||||
### 10.3 页面步骤条（横向 · 实心圆 + 自定义首项标题）
|
|
||||||
|
|
||||||
用于页面级流程（如「新建集群」类向导）。和弹窗步骤条相比，**已完成态指示圆改为实心填充 + 白色对勾**，视觉权重更高；首步标题可显示具体名称（如「新建集群」）而非「标题」占位。
|
|
||||||
|
|
||||||
#### 10.3.1 布局
|
|
||||||
|
|
||||||
```
|
|
||||||
(✓) ────── (●2) ┄┄┄┄┄ ( 3 ) ┄┄┄┄┄ ( 4 ) ┄┄┄┄┄ ( 5 )
|
|
||||||
新建集群 标题 标题 标题 标题
|
|
||||||
(描述文本) (描述文本) (描述文本) (描述文本) (描述文本)
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 10.3.2 与 §10.2 弹窗步骤条的差异
|
|
||||||
|
|
||||||
| 维度 | 弹窗步骤条 | 页面步骤条 |
|
|
||||||
|------|-----------|-----------|
|
|
||||||
| 完成态圆形 | 描边圆 + 蓝色对勾 | 实心蓝圆 + 白色对勾 |
|
|
||||||
| 完成段连接线样式 | `1px dashed #1677FF` | `1px solid #1677FF` |
|
|
||||||
| 标题文字号 | `14px Medium` | `14px Medium`（同） |
|
|
||||||
| 第一项 | 通用「标题」占位 | 可显示具体名称（自定义文案） |
|
|
||||||
|
|
||||||
#### 10.3.3 完成态指示圆补充
|
|
||||||
|
|
||||||
| 角色 | 色值 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 已完成圆背景 | `#1677FF` | ZS-002-06 |
|
|
||||||
| 已完成圆内对勾 | `#FFFFFF` | — |
|
|
||||||
| 已完成圆边框 | 无（实心） | — |
|
|
||||||
|
|
||||||
### 10.4 纵向步骤条
|
|
||||||
|
|
||||||
用于侧栏 / 详情页内的纵向流程指引。两种变体——「仅标题」与「标题 + 描述」。
|
|
||||||
|
|
||||||
#### 10.4.1 布局
|
|
||||||
|
|
||||||
```
|
|
||||||
仅标题: 标题 + 描述:
|
|
||||||
|
|
||||||
(✓) 新建集群 (✓) 新建集群
|
|
||||||
┊ 描述文本描述
|
|
||||||
(●2) 标题 ┊
|
|
||||||
┊ (●2) 标题
|
|
||||||
( 3 ) 标题 描述文本描述
|
|
||||||
┊ ┊
|
|
||||||
( 4 ) 标题 ( 3 ) 标题
|
|
||||||
描述文本描述
|
|
||||||
┊
|
|
||||||
( 4 ) 标题
|
|
||||||
描述文本描述
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 10.4.2 规格
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 指示圆 → 标题水平间距 | `--spacing-2` (8px) |
|
|
||||||
| 节点垂直间距（仅标题） | `--spacing-5` (24px)，圆心到圆心 |
|
|
||||||
| 节点垂直间距（标题 + 描述） | `--spacing-6` (32px)，圆心到圆心 |
|
|
||||||
| 标题 → 描述间距 | `--spacing-1` (4px) |
|
|
||||||
| 连接线位置 | 上下两个指示圆**正下方垂直**，居中于圆心 |
|
|
||||||
| 连接线样式 | `1px dashed`，已完成段 `#1677FF`，未完成段 `#4A6491` |
|
|
||||||
| 文字左对齐 | 标题与描述左对齐，与指示圆右侧对齐基线 |
|
|
||||||
|
|
||||||
#### 10.4.3 与横向步骤条共用规则
|
|
||||||
|
|
||||||
- 指示圆三态规格沿用 §10.1
|
|
||||||
- 已完成态默认用**描边 + 对勾**（与 §10.2 弹窗一致）；若纵向步骤条用于页面级主流程，可切换为 §10.3 的实心圆变体
|
|
||||||
|
|
||||||
### 10.5 交互与动画
|
|
||||||
|
|
||||||
| 行为 | 动效 |
|
|
||||||
|------|------|
|
|
||||||
| 步骤切换（next） | 当前圆 `background: transparent → #1677FF`，`200ms ease-out`；同时上一步圆 `border-color: #4A6491 → #1677FF`，再用 `200ms` 切换为对勾图标淡入 |
|
|
||||||
| 步骤切换（prev / 回退） | 反向，未完成态恢复 `#4A6491` 边框，圆内数字淡入 |
|
|
||||||
| 连接线高亮 | 完成段 `border-color: #4A6491 → #1677FF`，`240ms ease-out` |
|
|
||||||
| Hover 节点（可点击） | 圆边框色暂时变 `#4096FF` (ZS-002-05)，标题文字 `#4096FF`，`120ms ease-out`；不可点击节点（未来步骤）无 hover |
|
|
||||||
| 点击节点 | 节点必须**已完成**才能点（回看），否则视为禁用；点击合法节点触发 `step:change` 事件 |
|
|
||||||
|
|
||||||
### 10.6 状态机与可达性
|
|
||||||
|
|
||||||
| 当前步 = N | 节点 i 的状态 |
|
|
||||||
|-----------|----------------|
|
|
||||||
| `i < N` | Completed（已完成，可点回看） |
|
|
||||||
| `i === N` | Current（当前，不可点） |
|
|
||||||
| `i > N` | Upcoming（未开始，不可点） |
|
|
||||||
| `i.disabled` | Disabled（被显式禁用，例如条件未满足） |
|
|
||||||
|
|
||||||
**键盘导航**：
|
|
||||||
- `Tab` 顺序在「已完成」节点之间流转，跳过 `Current / Upcoming / Disabled`
|
|
||||||
- 焦点节点圆外加 `2px solid #4096FF` 焦点环（`outline`，`offset 2px`）
|
|
||||||
|
|
||||||
**屏幕阅读器**：
|
|
||||||
- 指示圆 `role="img"`，`aria-label="已完成第 N 步"` / `"当前第 N 步"` / `"未开始第 N 步"`
|
|
||||||
- 容器 `role="list"`，节点 `role="listitem"`
|
|
||||||
- 当前节点额外 `aria-current="step"`
|
|
||||||
|
|
||||||
### 10.7 CSS Token 参考
|
|
||||||
|
|
||||||
```css
|
|
||||||
:root {
|
|
||||||
/* 步骤条节点 */
|
|
||||||
--step-circle-size: 24px;
|
|
||||||
--step-circle-current-bg: #1677FF; /* ZS-002-06 */
|
|
||||||
--step-circle-current-text: #FFFFFF;
|
|
||||||
--step-circle-done-border: #1677FF; /* ZS-002-06 */
|
|
||||||
--step-circle-done-icon: #1677FF; /* 弹窗变体 */
|
|
||||||
--step-circle-done-bg-page: #1677FF; /* 页面变体:实心 */
|
|
||||||
--step-circle-done-icon-page: #FFFFFF;
|
|
||||||
--step-circle-upcoming-border: #4A6491; /* ZS-004-05 */
|
|
||||||
--step-circle-upcoming-text: #6E88B0; /* ZS-004-04 */
|
|
||||||
--step-circle-disabled-border: #2D4473; /* ZS-004-06 */
|
|
||||||
--step-circle-disabled-text: #4A6491; /* ZS-004-05 */
|
|
||||||
|
|
||||||
/* 连接线 */
|
|
||||||
--step-line-done: #1677FF; /* 已完成段 */
|
|
||||||
--step-line-upcoming: #4A6491; /* 未完成段:ZS-004-05 */
|
|
||||||
|
|
||||||
/* 文字 */
|
|
||||||
--step-title-active: #FFFFFF;
|
|
||||||
--step-title-inactive: #6E88B0; /* ZS-004-04 */
|
|
||||||
--step-desc-active: #C5CFE0; /* ZS-004-02 */
|
|
||||||
--step-desc-inactive: #6E88B0; /* ZS-004-04 */
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### 10.8 三种步骤条的选用决策
|
|
||||||
|
|
||||||
| 场景 | 选择 |
|
|
||||||
|------|------|
|
|
||||||
| Modal / Drawer 内多步表单 | §10.2 弹窗步骤条（描边圆，紧凑） |
|
|
||||||
| 页面级向导（独占大区域） | §10.3 页面步骤条（实心圆，视觉重） |
|
|
||||||
| 侧栏 / 详情页纵向流程 | §10.4 纵向步骤条 |
|
|
||||||
| 步骤数 ≤ 3 且无描述 | 优先「仅标题」变体 |
|
|
||||||
| 步骤名抽象需补充说明 | 用「标题 + 描述」变体 |
|
|
||||||
| 步骤数 > 7 | 不推荐用步骤条，改用「锚点」（§9.2）或分页 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 11. 面包屑
|
|
||||||
|
|
||||||
> 对应「4.3 导航组件-面包屑」。用于显示当前位置在整个站点层级中的路径，配合「← 返回」按钮支持逐级回溯。颜色取自 ZS-002 主色蓝与 ZS-004 深蓝系。
|
|
||||||
|
|
||||||
### 11.1 标准形态
|
|
||||||
|
|
||||||
容器顶部带一个独立的容器 / 边框包裹：
|
|
||||||
|
|
||||||
```
|
|
||||||
🏠 | 概况 / 总概况
|
|
||||||
```
|
|
||||||
|
|
||||||
带「返回」按钮的层级形态（一级到四级）：
|
|
||||||
|
|
||||||
```
|
|
||||||
一级: ← 返回 │ 现在位置
|
|
||||||
二级: ← 返回 │ 上一级位置 / 现在位置
|
|
||||||
三级: ← 返回 │ 上二级位置 / 上一级位置 / 现在位置
|
|
||||||
四级: ← 返回 │ 上三级位置 / 上二级位置 / 上一级位置 / 现在位置
|
|
||||||
```
|
|
||||||
|
|
||||||
### 11.2 规格
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 容器高度 | `40px` |
|
|
||||||
| 容器背景 | `#0C1836` (ZS-004-09) |
|
|
||||||
| 容器底边 | `1px solid #1A2F5A` (ZS-004-07) |
|
|
||||||
| 容器水平 padding | `--spacing-4` (16px) |
|
|
||||||
| 字号 | `14px Regular` |
|
|
||||||
| 元素间距（图标 / 文字 / 分隔符之间） | `--spacing-2` (8px) |
|
|
||||||
| 「返回」与首段路径之间分隔符 `│` | `1px solid #4A6491`，高度 `14px` |
|
|
||||||
|
|
||||||
### 11.3 配色
|
|
||||||
|
|
||||||
| 角色 | 色值 | 来源 | 备注 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| Home 图标 🏠 | `#4096FF` | ZS-002-05 | 默认主色，hover → `#1677FF` (ZS-002-06) |
|
|
||||||
| 「← 返回」图标 + 文字 | `#4096FF` | ZS-002-05 | 链接样式，hover 显示下划线 |
|
|
||||||
| 历史路径文字（可点击） | `#4096FF` | ZS-002-05 | 同链接配色 |
|
|
||||||
| 当前位置文字（最后一段） | `#FFFFFF` | — | 加粗 `14px Medium`，不可点击 |
|
|
||||||
| 分隔符 `/` | `#4A6491` | ZS-004-05 | 静态、不可点 |
|
|
||||||
| 分隔符 `│`（返回按钮与路径之间） | `#4A6491` | ZS-004-05 | 同上 |
|
|
||||||
| Hover 路径项 | `#1677FF` | ZS-002-06 | 文字色 + 下划线 |
|
|
||||||
| 失效路径项（无对应页） | `#4A6491` | ZS-004-05 | `cursor: not-allowed` |
|
|
||||||
|
|
||||||
### 11.4 交互规则
|
|
||||||
|
|
||||||
- **点击「← 返回」**：逐步向上返回一级（等同浏览器 back）
|
|
||||||
- **点击文字路径**：快速跳回到对应任意上级页面
|
|
||||||
- **当前位置**（最后一段）：不响应点击，仅作展示
|
|
||||||
- **层级建议**：尽可能不超过 **4 级**；超过 4 级会让面包屑过长，应改用侧栏 / 锚点辅助
|
|
||||||
|
|
||||||
### 11.5 与导航的关系
|
|
||||||
|
|
||||||
面包屑**不替代**主导航（§8）：
|
|
||||||
|
|
||||||
- 主导航 = 「我能去哪些地方」（站点结构）
|
|
||||||
- 面包屑 = 「我当前在哪里」（路径回溯）
|
|
||||||
|
|
||||||
两者并存时，面包屑紧贴页面主内容区顶部，位于主导航下方、页头（§12）上方。
|
|
||||||
|
|
||||||
### 11.6 CSS 参考
|
|
||||||
|
|
||||||
```css
|
|
||||||
.breadcrumb {
|
|
||||||
display: flex;
|
|
||||||
align-items: center;
|
|
||||||
height: 40px;
|
|
||||||
padding: 0 var(--spacing-4);
|
|
||||||
background: #0C1836;
|
|
||||||
border-bottom: 1px solid #1A2F5A;
|
|
||||||
font-size: 14px;
|
|
||||||
gap: var(--spacing-2);
|
|
||||||
}
|
|
||||||
.breadcrumb-back { color: #4096FF; cursor: pointer; }
|
|
||||||
.breadcrumb-back:hover { color: #1677FF; text-decoration: underline; }
|
|
||||||
.breadcrumb-sep-bar { width: 1px; height: 14px; background: #4A6491; }
|
|
||||||
.breadcrumb-sep { color: #4A6491; }
|
|
||||||
.breadcrumb-link { color: #4096FF; cursor: pointer; }
|
|
||||||
.breadcrumb-link:hover { color: #1677FF; text-decoration: underline; }
|
|
||||||
.breadcrumb-current { color: #FFFFFF; font-weight: 500; }
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 12. 页头
|
|
||||||
|
|
||||||
> 对应「4.6 导航组件-分页」上半段示意。用于页面主内容区顶部、面包屑下方，承载页面标题与可选的说明 / Tabs。共有 4 种变体。
|
|
||||||
|
|
||||||
### 12.1 通用规格
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 容器高度 | `56px`（仅标题）/ `64px`（含 Tabs） |
|
|
||||||
| 背景 | `#0C1836` (ZS-004-09) |
|
|
||||||
| 底边 | `1px solid #1A2F5A` (ZS-004-07) |
|
|
||||||
| 水平 padding | `--spacing-5` (24px) |
|
|
||||||
| 文字基线 | 垂直居中 |
|
|
||||||
|
|
||||||
### 12.2 四种变体
|
|
||||||
|
|
||||||
#### 12.2.1 基础页头
|
|
||||||
|
|
||||||
只有标题：
|
|
||||||
|
|
||||||
```
|
|
||||||
页头标题
|
|
||||||
```
|
|
||||||
|
|
||||||
| 角色 | 色值 / 字号 | 来源 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| 标题 | `18px Bold`，`#FFFFFF` | — |
|
|
||||||
|
|
||||||
#### 12.2.2 页头 + 说明
|
|
||||||
|
|
||||||
标题后跟一段灰色说明文字：
|
|
||||||
|
|
||||||
```
|
|
||||||
页头标题 （这是一句简要说明）
|
|
||||||
```
|
|
||||||
|
|
||||||
| 角色 | 色值 / 字号 | 来源 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| 标题 | `18px Bold`，`#FFFFFF` | — |
|
|
||||||
| 说明文字 | `14px Regular`，`#6E88B0` | ZS-004-04 |
|
|
||||||
| 标题 → 说明间距 | `--spacing-3` (12px) | — |
|
|
||||||
|
|
||||||
说明用半角圆括号包裹，颜色与括号一致（不要让括号比文字更醒目）。
|
|
||||||
|
|
||||||
#### 12.2.3 页头 + 说明 icon
|
|
||||||
|
|
||||||
标题后跟一个可悬停查看说明的图标：
|
|
||||||
|
|
||||||
```
|
|
||||||
页头标题 ⓘ
|
|
||||||
```
|
|
||||||
|
|
||||||
| 角色 | 色值 / 字号 | 来源 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| 标题 | `18px Bold`，`#FFFFFF` | — |
|
|
||||||
| 说明 icon `ⓘ` 或 `?` | `16px`，`#6E88B0` | ZS-004-04 |
|
|
||||||
| Icon hover | `#4096FF` | ZS-002-05 |
|
|
||||||
| 标题 → 图标间距 | `--spacing-2` (8px) | — |
|
|
||||||
|
|
||||||
Hover 弹出 Tooltip（沿用 §9.3.3 Tooltip 配色），承载完整说明文字。
|
|
||||||
|
|
||||||
#### 12.2.4 分 Tabs 页头
|
|
||||||
|
|
||||||
标题位置直接放横向页签（沿用 §9.1.1 横向页签配色），点击切换右侧主内容区：
|
|
||||||
|
|
||||||
```
|
|
||||||
标题 标题 标题
|
|
||||||
─────
|
|
||||||
```
|
|
||||||
|
|
||||||
| 复用规则 | 说明 |
|
|
||||||
|----------|------|
|
|
||||||
| Tab 配色 | 完全沿用 §9.1.1 横向页签 |
|
|
||||||
| Tab 字号 | `16px Medium`（页头位置比一般 tab 略大） |
|
|
||||||
| Tab 间距 | `--spacing-5` (24px) |
|
|
||||||
| 激活态下划线 | `2px solid #4096FF`，宽与文字齐 |
|
|
||||||
|
|
||||||
### 12.3 与右侧操作区的组合
|
|
||||||
|
|
||||||
页头右侧常承载主操作按钮（「+ 新建」、「导出」等）。规则：
|
|
||||||
|
|
||||||
- 按钮组靠右对齐，右 padding 与左 padding 一致 (`--spacing-5`)
|
|
||||||
- 多按钮排列顺序参照 §5.3.4（默认按钮在左、主按钮在右），按钮间距 `--spacing-2`
|
|
||||||
- Tabs 页头中右侧操作区与 Tabs 同高居中
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 13. 分页
|
|
||||||
|
|
||||||
> 对应「4.6 导航组件-分页」下半段。三种形态——**正常分页 / 精简分页 / 导航式分页**——按页面信息量与可用空间选用。
|
|
||||||
|
|
||||||
### 13.1 正常分页
|
|
||||||
|
|
||||||
承载大列表，提供页码、跳转、每页条数选择：
|
|
||||||
|
|
||||||
```
|
|
||||||
共 240 项 < ① 2 3 4 5 … 24 > 每页 [10▾] 条 前往 [ ] 页
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 13.1.1 元素配色与规格
|
|
||||||
|
|
||||||
| 元素 | 字号 / 色值 | 来源 / 说明 |
|
|
||||||
|------|-------------|-------------|
|
|
||||||
| 「共 N 项」总数文字 | `14px Regular`，`#6E88B0` | ZS-004-04 |
|
|
||||||
| 页码按钮（默认） | `14px Regular`，`#C5CFE0`，背景 `transparent` | ZS-004-02 |
|
|
||||||
| 页码按钮（hover） | `#4096FF`，背景 `rgba(22,119,255,0.08)` | ZS-002-05 |
|
|
||||||
| 页码按钮（激活/当前页） | `#FFFFFF`，背景 `#1677FF`（实心圆） | ZS-002-06 |
|
|
||||||
| 页码按钮（失效） | `#4A6491`，背景 `transparent` | ZS-004-05 |
|
|
||||||
| 左右翻页箭头 `<` `>` | `14px`，`#6E88B0`，hover → `#4096FF` | ZS-004-04 → ZS-002-05 |
|
|
||||||
| 翻页箭头失效（首/末页） | `#4A6491` | ZS-004-05 |
|
|
||||||
| 省略号 `…` | `#6E88B0` | ZS-004-04，静态展示，不可点 |
|
|
||||||
| 每页条数下拉 `[10▾]` | 沿用 §14.1 输入框规格 | 高度 `28px`，宽 `60px` |
|
|
||||||
| 「前往 N 页」输入框 | 沿用 §14.1 输入框规格 | 高度 `28px`，宽 `48px` |
|
|
||||||
|
|
||||||
#### 13.1.2 页码按钮规格
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 形状 | 圆形 `28px × 28px`（`border-radius: 50%`） |
|
|
||||||
| 默认背景 | `transparent` |
|
|
||||||
| 当前页背景 | `#1677FF` (ZS-002-06)，实心圆，白色数字 |
|
|
||||||
| 字号 | `14px Regular`（数字 D-DIN 或 Noto Sans） |
|
|
||||||
| 项间距 | `--spacing-1` (4px) |
|
|
||||||
|
|
||||||
#### 13.1.3 元素间距
|
|
||||||
|
|
||||||
| 区段 | 间距 |
|
|
||||||
|------|------|
|
|
||||||
| 「共 N 项」→ 翻页区 | `--spacing-4` (16px) |
|
|
||||||
| 翻页区内（箭头 / 页码） | `--spacing-1` (4px) |
|
|
||||||
| 翻页区 → 每页下拉 | `--spacing-5` (24px) |
|
|
||||||
| 每页下拉 → 前往输入 | `--spacing-4` (16px) |
|
|
||||||
|
|
||||||
### 13.2 精简分页
|
|
||||||
|
|
||||||
承载弹窗 / 表格紧凑场景，只暴露「当前页 / 总页数」与左右翻页：
|
|
||||||
|
|
||||||
```
|
|
||||||
共 1 项 < [ 1 ] / 10 >
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 13.2.1 规格
|
|
||||||
|
|
||||||
| 元素 | 配色 / 备注 |
|
|
||||||
|------|------------|
|
|
||||||
| 「共 N 项」 | 同 §13.1.1 |
|
|
||||||
| `<` `>` 翻页箭头 | 同 §13.1.1 |
|
|
||||||
| `[ 1 ]` 当前页输入框 | 沿用 §14.1 输入框规格，高 `28px`，宽 `40px`，居中文字 |
|
|
||||||
| `/ N` 总页数 | `14px Regular`，`#6E88B0` (ZS-004-04) |
|
|
||||||
| 元素间距 | `--spacing-2` (8px) |
|
|
||||||
|
|
||||||
#### 13.2.2 与正常分页的差异
|
|
||||||
|
|
||||||
| 维度 | 正常分页 | 精简分页 |
|
|
||||||
|------|----------|----------|
|
|
||||||
| 页码 | 点击式数字列表 | 输入框 + 总页数文字 |
|
|
||||||
| 跳转方式 | 点击数字 / 前往输入 | 直接修改输入框 |
|
|
||||||
| 每页条数 | 暴露下拉 | 不暴露（默认值由调用方决定） |
|
|
||||||
| 适用 | 列表 / 表格主内容区 | 弹窗、抽屉、卡片内嵌列表 |
|
|
||||||
|
|
||||||
### 13.3 导航式分页
|
|
||||||
|
|
||||||
承载长文 / 详情页的「上一篇 / 下一篇」式翻页，只有方向，不暴露页码：
|
|
||||||
|
|
||||||
```
|
|
||||||
下一页 »
|
|
||||||
« 上一页
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 13.3.1 规格
|
|
||||||
|
|
||||||
| 元素 | 配色 / 备注 |
|
|
||||||
|------|------------|
|
|
||||||
| 「下一页」/「上一页」文字 + 箭头 | `14px Regular`，`#4096FF` (ZS-002-05) |
|
|
||||||
| Hover | `#1677FF` (ZS-002-06) + 下划线 |
|
|
||||||
| 失效（首/末篇） | `#4A6491` (ZS-004-05)，`cursor: not-allowed` |
|
|
||||||
| 箭头位置 | `下一页 »`（箭头在后）/ `« 上一页`（箭头在前） |
|
|
||||||
| 文字 → 箭头间距 | `--spacing-2` (8px) |
|
|
||||||
| 两个按钮纵向排列时项间距 | `--spacing-3` (12px) |
|
|
||||||
|
|
||||||
### 13.4 三种分页的选用决策
|
|
||||||
|
|
||||||
| 场景 | 选择 |
|
|
||||||
|------|------|
|
|
||||||
| 后台列表 / 表格 | §13.1 正常分页 |
|
|
||||||
| Modal / Drawer 内嵌列表 | §13.2 精简分页 |
|
|
||||||
| 详情页前后翻 | §13.3 导航式分页 |
|
|
||||||
| 列表少于 1 页（项数 ≤ pageSize） | **不显示**分页 |
|
|
||||||
| 项数明确但页码可能很多（>50 页） | 用正常分页 + 隐藏中间页码（`...` 省略） |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
File diff suppressed because it is too large.
Load diff
File diff suppressed because it is too large.
Load diff
@@ -1,573 +0,0 @@
|
|||||||
# 深蓝色 UI 规范 · 04 图表（§35–§41）
|
|
||||||
|
|
||||||
> 《深蓝色 UI 规范》分册之一。基础令牌见 `00-基础-色彩字体间距.md`，可 import 的变量见 `tokens.css`，总目录与 §索引见 `README.md`。`§N` 编号全局唯一。
|
|
||||||
|
|
||||||
**本篇目录**：`35` 图表通用规范 · `36` 柱状图 · `37` 折线图 · `38` 甘特图 · `39` 环形图 · `40` 关系图/散点图 · `41` 图表色值
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 35. 图表通用规范（Chart 基础）
|
|
||||||
|
|
||||||
> 对应设计稿「8. 图表」系列（柱状图 / 折线图 / 甘特图）。本节先约定**所有图表共用**的容器、标题、坐标轴、网格、图例、Tooltip、配色与空状态；§36 起按图表类型补充各自细则。配色一律取自 §1.1.8 图表配色与 §1.1.5 深蓝系，不另造色。
|
|
||||||
|
|
||||||
### 35.1 图表容器
|
|
||||||
|
|
||||||
| 属性 | 取值 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 背景 | `#0C1836` (ZS-004-09)，嵌入卡片时随 §22 卡片 `#122347` | §3.1 |
|
|
||||||
| 圆角 | `4px` | §4.1 |
|
|
||||||
| 内边距 | `--spacing-5` (24px) | §7.1 |
|
|
||||||
| 多图并排间距 | `--spacing-6` (32px) | §7.1 |
|
|
||||||
| 边框（可选） | `1px solid #1A2F5A` (ZS-004-07) | — |
|
|
||||||
|
|
||||||
### 35.2 图表标题
|
|
||||||
|
|
||||||
设计稿中标题统一为「**主色蓝竖条 ▌ + 文字**」的小标题样式。
|
|
||||||
|
|
||||||
| 元素 | 规格 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 左侧竖条 | `3px × 14px`，`#1677FF` (ZS-002-06)，圆角 `1px` | §1.1.6 |
|
|
||||||
| 竖条 → 文字间距 | `--spacing-2` (8px) | §7.1 |
|
|
||||||
| 标题文字 | `16px Bold`，`#FFFFFF`（或 `#C5CFE0`） | §2.1.2 |
|
|
||||||
| 标题 → 图表区间距 | `--spacing-4` (16px) | §7.1 |
|
|
||||||
| 副标题 / 单位 | `12px Regular`，`#6E88B0` (ZS-004-04) | — |
|
|
||||||
|
|
||||||
> 部分卡片标题不带竖条（如「标题（BW）」「数据采集XXX」），此时直接用 `16px Bold #C5CFE0`，与 §22 卡片标题一致。
|
|
||||||
|
|
||||||
### 35.3 坐标轴
|
|
||||||
|
|
||||||
| 元素 | 色值 / 规格 | 来源 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| 轴线（X / Y 基线） | `1px solid #2D4473` (ZS-004-06) | §6.1 |
|
|
||||||
| 刻度文字（轴标签） | `12px Regular`，`#6E88B0` (ZS-004-04) | — |
|
|
||||||
| 轴标题 / 类目名（如「类型」「2012」） | `12px Regular`，`#4096FF` (ZS-002-05) 或 `#6E88B0` | — |
|
|
||||||
| 刻度线（tick） | 通常隐藏，仅留网格线 | — |
|
|
||||||
| 轴名称单位 | `12px`，`#6E88B0`，置于轴末端 | — |
|
|
||||||
|
|
||||||
### 35.4 网格线（splitLine）
|
|
||||||
|
|
||||||
| 类型 | 色值 | 样式 | 使用场景 |
|
|
||||||
|------|------|------|----------|
|
|
||||||
| 主网格（默认） | `#2D4473` (ZS-004-06) | `1px dashed` | 柱状 / 折线的 Y 向参考线 |
|
|
||||||
| 弱化网格 | `#1A2F5A` (ZS-004-07) | `1px dashed` | 密集图表、次要参考 |
|
|
||||||
|
|
||||||
> 深色背景下网格一律用**虚线**且低对比，避免抢戏；纵向类目方向通常不画网格。
|
|
||||||
|
|
||||||
### 35.5 图例（Legend）
|
|
||||||
|
|
||||||
| 属性 | 取值 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 位置 | 右上角（多数）或顶部居中 | — |
|
|
||||||
| 色块（marker） | `10px` 方块 / 圆点，取系列色 | §1.1.8 |
|
|
||||||
| 色块 → 文字间距 | `--spacing-1` (4px) | §7.1 |
|
|
||||||
| 图例文字 | `12px Regular`，`#C5CFE0` (ZS-004-02) | — |
|
|
||||||
| 项间距 | `--spacing-3` (12px) | §7.1 |
|
|
||||||
| 未选中态（点击隐藏系列） | 色块 + 文字置灰 `#4A6491` (ZS-004-05) | §1.1.5 |
|
|
||||||
|
|
||||||
### 35.6 Tooltip（悬浮提示）
|
|
||||||
|
|
||||||
鼠标悬停时跟随的浮层（如折线图「1月10日 异常率12.9%」、「5.32」）。
|
|
||||||
|
|
||||||
| 属性 | 取值 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 背景 | `rgba(12,24,54,0.92)`（ZS-004-09 92%） | §3.1 |
|
|
||||||
| 边框 | `1px solid #1A2F5A` (ZS-004-07) | — |
|
|
||||||
| 圆角 | `4px` | §4.1 |
|
|
||||||
| 阴影 | `0 4px 16px rgba(6,14,36,0.6)` | §3.1.4 |
|
|
||||||
| 内边距 | 上下 `--spacing-2`，左右 `--spacing-3` | §7.1 |
|
|
||||||
| 标题行（日期 / 类目） | `12px Medium`，`#FFFFFF` | — |
|
|
||||||
| 数值行 | `12px Regular`，色块（系列色）+ 名称 `#6E88B0` + 数值 `#C5CFE0` | — |
|
|
||||||
| 指示线（axisPointer） | `1px dashed #4096FF` (ZS-002-05)，或半透明竖向高亮带 `rgba(22,119,255,0.12)` | §6.1 |
|
|
||||||
|
|
||||||
> 设计稿中数据点 hover 常显示一个**实心小标签**（如圆点 + 数值 `5.32`）：标签背景 `#122347`，文字 `#FFFFFF`，圆点取系列色，圆角 `2px`。
|
|
||||||
|
|
||||||
### 35.7 数据点与标记
|
|
||||||
|
|
||||||
| 元素 | 规格 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 折线拐点（默认） | 不显示或 `2px` 实心点 | — |
|
|
||||||
| 折线拐点（hover / 强调） | `空心圆`，描边 `2px` 系列色，填充 `#0C1836`，直径 `6px` | — |
|
|
||||||
| 高亮竖带（选中区间） | `rgba(22,119,255,0.12)` 矩形，无边框 | §3.1 |
|
|
||||||
|
|
||||||
### 35.8 图表配色引用
|
|
||||||
|
|
||||||
| 用途 | 色序 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 多系列（面积大：柱 / 折线 / 饼） | `#1677FF → #13C2C2 → #4096FF → #36CFC9 → #69B1FF → #5CDBD3 → #91CAFF → #87E8DE` | §1.1.8 通用图表色序 |
|
|
||||||
| 小面积（散点 / 迷你图 / 徽标） | `#4096FF → #36CFC9 → #FF4D4F → #FFA39E → #6388FF → #478880` | §1.1.8 小面积色序 |
|
|
||||||
| 语义系列（成功 / 警告 / 错误） | 绿 `--func-success` / 橙 `--func-warning` / 红 `#F5222D` | §27.4 / §1.1.2 |
|
|
||||||
|
|
||||||
> 设计稿柱状图出现的「绿(Paper) / 橙(Project) / 蓝(Book)」三系列，对应**语义化分类**：绿取 §27.4 成功绿、橙取 §27.4 警告橙、蓝取主色 `#1677FF`；若为无语义的并列分类，应改用通用图表色序避免误读。
|
|
||||||
|
|
||||||
### 35.9 空状态 / 加载
|
|
||||||
|
|
||||||
| 状态 | 表现 |
|
|
||||||
|------|------|
|
|
||||||
| 加载中 | 图表区居中显示旋转图标 `#4096FF` + 文字「加载中…」`12px #6E88B0`（沿用 §5.4.2） |
|
|
||||||
| 无数据 | 居中占位插画 / 文字「暂无数据」`14px #6E88B0` |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 36. 柱状图（Column / Bar）
|
|
||||||
|
|
||||||
> 对应设计稿「8.1 图表-柱状图」。涵盖**堆叠柱 / 分组柱 / 条形图（横向）/ 排行进度条**四种形态。容器、坐标轴、网格、图例、Tooltip 全部沿用 §35。
|
|
||||||
|
|
||||||
### 36.1 通用规格
|
|
||||||
|
|
||||||
| 属性 | 取值 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 柱体圆角 | 顶部 `2px`（堆叠柱仅最顶段圆角） | §4.1 |
|
|
||||||
| 柱宽 | 类目宽度的 `40%~60%` | — |
|
|
||||||
| 同组柱间距 | `--spacing-1` (4px) | §7.1 |
|
|
||||||
| 类目（组）间距 | 自适应等分 | — |
|
|
||||||
| 数值标签（可选） | `12px Regular`，`#C5CFE0`，置柱顶上方 `--spacing-1` | — |
|
|
||||||
|
|
||||||
### 36.2 堆叠柱状图（如「标题」Paper/Project/Book）
|
|
||||||
|
|
||||||
| 元素 | 配色 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 系列 1（Book / 底段） | `#69B1FF` (ZS-002-04) 或主色 `#1677FF` | §1.1.3 |
|
|
||||||
| 系列 2（Project / 中段） | `--func-warning`（橙） | §27.4 |
|
|
||||||
| 系列 3（Paper / 顶段） | `--func-success`（绿） | §27.4 |
|
|
||||||
| 段间分隔 | `1px` 容器底色 `#0C1836` 描边，制造堆叠缝隙 | — |
|
|
||||||
| Y 轴类目标签「类型」 | `12px`，`#4096FF` (ZS-002-05) | §35.3 |
|
|
||||||
|
|
||||||
### 36.3 分组柱状图（如「标题（BW）」「标题」双系列）
|
|
||||||
|
|
||||||
| 元素 | 配色 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 系列依次取色 | 通用图表色序 `#1677FF / #13C2C2 / #4096FF …` | §1.1.8 |
|
|
||||||
| 设计稿 BW 三色变体 | 蓝 `#69B1FF` / 绿 `--func-success` / 橙 `--func-warning` | §35.8 |
|
|
||||||
| 双系列变体 | 蓝 `#69B1FF`(ZS-002-04) + 橙 `--func-warning` | — |
|
|
||||||
|
|
||||||
### 36.4 条形图（横向，如「标题」x 轴 0–400）
|
|
||||||
|
|
||||||
| 属性 | 取值 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 方向 | 水平，类目在 Y 轴、数值在 X 轴 | — |
|
|
||||||
| 条体颜色 | `#69B1FF` (ZS-002-04)（单系列）或图表色序 | §1.1.3 |
|
|
||||||
| 条体圆角 | 右端 `2px` | §4.1 |
|
|
||||||
| 类目标签「类型」 | 左对齐，`12px #6E88B0` | §35.3 |
|
|
||||||
| X 轴刻度 | `0 / 100 / 200 / 300 / 400`，`12px #6E88B0` | §35.3 |
|
|
||||||
|
|
||||||
### 36.5 排行进度条（如「数据采集XXX」TOP1–5）
|
|
||||||
|
|
||||||
横向「标签 + 渐变进度条 + 数值」的榜单形态。
|
|
||||||
|
|
||||||
```
|
|
||||||
TOP1 项目任务名称一 15,465
|
|
||||||
■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■▓▓▓▓▓▓▓▓
|
|
||||||
TOP2 项目任务名称二 15,234
|
|
||||||
■■■■■■■■■■■■■■■■■■■■■■■■■▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
|
|
||||||
```
|
|
||||||
|
|
||||||
| 元素 | 规格 / 配色 | 来源 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| 排名 + 名称（TOPn 项目任务名称） | `14px Regular`，`#C5CFE0` (ZS-004-02) | — |
|
|
||||||
| 数值（右对齐） | `16px D-DIN Regular`，`#FFFFFF` | §2.1.2 |
|
|
||||||
| 进度条高度 | `8px`，圆角 `4px` | §4.1 |
|
|
||||||
| 进度填充 | 渐变 `linear-gradient(90deg, #1677FF 0%, #13C2C2 100%)`（主色蓝→主色青） | §1.1.8 |
|
|
||||||
| 进度轨道（底槽） | `#1A2F5A` (ZS-004-07) | §1.1.5 |
|
|
||||||
| 行间距 | `--spacing-4` (16px) | §7.1 |
|
|
||||||
| 名称行 → 进度条间距 | `--spacing-2` (8px) | §7.1 |
|
|
||||||
|
|
||||||
### 36.6 交互
|
|
||||||
|
|
||||||
| 行为 | 动效 |
|
|
||||||
|------|------|
|
|
||||||
| 入场 | 柱体由 `0` 向目标高度 / 长度增长，`scaleY/scaleX 0→1`，`400ms ease-out`，按系列依次 `60ms` 错峰 |
|
|
||||||
| Hover 柱 | 该柱亮度 `+8%`，弹出 §35.6 Tooltip，axisPointer 高亮该类目竖带 |
|
|
||||||
| Hover 进度条 | 数值放大或显示绝对值 Tooltip |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 37. 折线图（Line / Area）
|
|
||||||
|
|
||||||
> 对应设计稿「8.2 图表-折线图」与「8.3 多系列折线」。涵盖**迷你面积图 / 单线（含异常点 Tooltip）/ 长时序面积图（带缩略轴）/ 多系列折线**。容器、轴、网格、图例、Tooltip 沿用 §35。
|
|
||||||
|
|
||||||
### 37.1 线条与面积
|
|
||||||
|
|
||||||
| 元素 | 规格 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 线宽 | `2px` | — |
|
|
||||||
| 线条颜色 | 取图表色序，单线默认 `#1677FF` (ZS-002-06) | §1.1.8 |
|
|
||||||
| 平滑 | `smooth`（曲线）或折线，按数据性质选用 | — |
|
|
||||||
| 面积填充（单线） | 自顶向下渐变 `rgba(22,119,255,0.32) → rgba(22,119,255,0)` | §3.1 |
|
|
||||||
| 拐点 | 默认隐藏，hover 显示空心圆（§35.7） | — |
|
|
||||||
|
|
||||||
### 37.2 迷你面积图（如左上「图表标题」+ 已选/未选 标签）
|
|
||||||
|
|
||||||
| 元素 | 规格 / 配色 | 来源 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| 顶部切换标签（已选 / 未选） | §29 标签：选中 `#1677FF` 实心白字 / 未选 `transparent` + `1px #6E88B0` 边、`#6E88B0` 字 | §29 |
|
|
||||||
| 线条 | `2px #4096FF` (ZS-002-05) | — |
|
|
||||||
| 面积渐变 | `rgba(64,150,255,0.32) → 0` | — |
|
|
||||||
| 当前值标签（如 `59.32`） | 实心小牌 `#122347` 背景 / `#FFFFFF` 文字，圆角 `2px`，定位于末端点 | §35.6 |
|
|
||||||
| 轴标签（日期） | `12px #6E88B0` | §35.3 |
|
|
||||||
|
|
||||||
### 37.3 单线异常点图（如中部「5-1…5-12」+「1月10日 异常率12.9%」）
|
|
||||||
|
|
||||||
| 元素 | 规格 / 配色 | 来源 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| 主线 | `2px #1677FF` | — |
|
|
||||||
| 面积渐变 | `rgba(22,119,255,0.32) → 0` | — |
|
|
||||||
| 选中竖带 | `rgba(22,119,255,0.12)` 矩形高亮当前 X 区间 | §35.7 |
|
|
||||||
| 异常点标记 | 空心圆 `6px`，描边 `#FAAD14`（警告橙），填充 `#0C1836` | §27.4 |
|
|
||||||
| Tooltip（日期 + 指标） | §35.6；指标行如「异常率 12.9%」用 `--func-warning` 橙强调 | §35.6 |
|
|
||||||
| Y 轴（0–2500） | `12px #6E88B0`，虚线网格 `#2D4473` | §35.3 / §35.4 |
|
|
||||||
|
|
||||||
### 37.4 长时序面积图 + 缩略轴（如底部「图表标题」1986–2024）
|
|
||||||
|
|
||||||
| 元素 | 规格 / 配色 | 来源 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| 主线 | `2px #36CFC9`（标准青）或 `#4096FF` | §1.1.4 |
|
|
||||||
| 面积渐变 | `rgba(54,207,201,0.24) → 0` | — |
|
|
||||||
| 数据点标签（如 `2.43`） | 实心小牌（§35.6），定位于选中点上方 | — |
|
|
||||||
| 缩略轴（dataZoom，右下迷你图） | 缩略折线 `#4A6491`；滑窗手柄 `#1677FF`，选中区 `rgba(22,119,255,0.16)` | §1.1.5 / §1.1.6 |
|
|
||||||
| X 轴年份 | `12px #6E88B0`，密集时隔项显示 | §35.3 |
|
|
||||||
|
|
||||||
### 37.5 多系列折线图（如「图表标题」XXX/XXX/都是/无反应）
|
|
||||||
|
|
||||||
| 元素 | 规格 / 配色 | 来源 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| 图例（顶部居中） | 方块 marker + 文字，项间距 `--spacing-3` | §35.5 |
|
|
||||||
| 系列 1（XXX） | 红 `#FF4D4F` (ZS-001-05) | §1.1.2 |
|
|
||||||
| 系列 2（XXX） | 蓝 `#1677FF` (ZS-002-06) | §1.1.3 |
|
|
||||||
| 系列 3（都是） | 橙 `--func-warning` | §27.4 |
|
|
||||||
| 系列 4（无反应） | 绿 `--func-success` 或青 `#36CFC9` | §27.4 / §1.1.4 |
|
|
||||||
| 线宽 | `2px`，多系列**不填充面积**（避免互相遮挡） | — |
|
|
||||||
| 拐点 | 全程显示 `4px` 空心圆（描边系列色，填充 `#0C1836`） | §35.7 |
|
|
||||||
| 选中竖带 + Tooltip | hover 竖带 `rgba(22,119,255,0.12)`，Tooltip 列出各系列值（如 `5.32`） | §35.6 |
|
|
||||||
| Y 轴（0–10） / X 轴（年份） | `12px #6E88B0`，横向虚线网格 `#2D4473` | §35.3 / §35.4 |
|
|
||||||
|
|
||||||
### 37.6 交互
|
|
||||||
|
|
||||||
| 行为 | 动效 |
|
|
||||||
|------|------|
|
|
||||||
| 入场 | 线条沿路径绘制 `stroke-dashoffset` 动画，`600ms ease-out`；面积同步淡入 |
|
|
||||||
| Hover | 显示 §35.6 Tooltip + 竖向 axisPointer 高亮带；对应拐点放大为空心圆 |
|
|
||||||
| 图例点击 | 切换系列显隐，隐藏态图例置灰 `#4A6491`（§35.5） |
|
|
||||||
| 缩略轴拖拽 | 主图 X 轴范围实时联动，`100ms` 节流 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 38. 甘特图（Gantt）
|
|
||||||
|
|
||||||
> 对应设计稿「甘特图」。以时间为横轴、任务行为纵轴的进度条排期图。深蓝背景上以**交替行底纹 + 渐变任务条 + 箭头收尾**呈现，配色取 §1.1.8 图表色序与语义色。
|
|
||||||
|
|
||||||
### 38.1 结构
|
|
||||||
|
|
||||||
```
|
|
||||||
1 2 3 … 15 16 17 … 31 ← 时间刻度表头
|
|
||||||
Jan ▐▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▶ ← 任务条（带箭头收尾）
|
|
||||||
Feb ▐▓▓▓▓▓▓▓▓▓▶
|
|
||||||
Mar ▐▓▓▓▓▓▓▓▶
|
|
||||||
…
|
|
||||||
Dec ▐▓▓▓▓▓▓▓▓▓▓▓▶
|
|
||||||
● Lorem ipsum 1 ● Lorem ipsum 2 … ← 底部图例
|
|
||||||
```
|
|
||||||
|
|
||||||
### 38.2 表格框架
|
|
||||||
|
|
||||||
| 元素 | 规格 / 配色 | 来源 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| 容器背景 | `#0C1836` (ZS-004-09) | §35.1 |
|
|
||||||
| 时间刻度表头（1–31 / 月） | `12px Regular`，`#C5CFE0` (ZS-004-02) | §35.3 |
|
|
||||||
| 行标签（Jan…Dec） | `14px Regular`，`#C5CFE0` | — |
|
|
||||||
| 行高 | `28px`，行间距 `--spacing-1` (4px) | §7.1 |
|
|
||||||
| 行底纹（轨道） | `#122347` (ZS-004-08)，整行通栏，圆角 `2px` | §1.1.5 |
|
|
||||||
| 行底纹（隔行可选） | 奇偶交替 `#122347` / `#0F1C3D` | — |
|
|
||||||
| 列分隔（可选） | `1px dashed #1A2F5A` (ZS-004-07) | §6.2 |
|
|
||||||
|
|
||||||
### 38.3 任务条
|
|
||||||
|
|
||||||
| 元素 | 规格 / 配色 | 来源 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| 条高 | `16px`，垂直居中于行内 | — |
|
|
||||||
| 圆角 | `2px`（左端）；右端收**箭头**三角表示方向 | §4.1 |
|
|
||||||
| 填充 | 沿条向右渐变（系列色 `0%` → 同色 70% 透明 `100%`），叠加斜纹/点纹理增强层次 | §1.1.8 |
|
|
||||||
| 纹理 | `repeating-linear-gradient(45deg, rgba(255,255,255,0.06) 0 4px, transparent 4px 8px)` | — |
|
|
||||||
| 箭头收尾 | 与条同色实心三角，`6px`，指向时间推进方向 | — |
|
|
||||||
| 进度（可选） | 条内再叠一段高饱和系列色表示完成比例 | — |
|
|
||||||
|
|
||||||
### 38.4 任务分类配色（对应底部图例 Lorem ipsum 1–5）
|
|
||||||
|
|
||||||
| 图例 | 圆点 / 任务条主色 | 来源 |
|
|
||||||
|------|------------------|------|
|
|
||||||
| Lorem ipsum 1 | 橙 `--func-warning` | §27.4 |
|
|
||||||
| Lorem ipsum 2 | 红 `#FF4D4F` (ZS-001-05) | §1.1.2 |
|
|
||||||
| Lorem ipsum 3 | 青绿 `#36CFC9` (ZS-003-05) | §1.1.4 |
|
|
||||||
| Lorem ipsum 4 | 浅蓝 `#91CAFF` (ZS-002-03) | §1.1.3 |
|
|
||||||
| Lorem ipsum 5 | 主色蓝 `#1677FF` (ZS-002-06) | §1.1.3 |
|
|
||||||
|
|
||||||
### 38.5 图例与表头
|
|
||||||
|
|
||||||
| 元素 | 规格 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 底部图例圆点 | `10px` 圆形，取 §38.4 分类色 | §35.5 |
|
|
||||||
| 图例文字 | `14px Regular`，`#C5CFE0` | — |
|
|
||||||
| 图例项间距 | `--spacing-5` (24px) | §7.1 |
|
|
||||||
| 表头 → 首行间距 | `--spacing-3` (12px) | §7.1 |
|
|
||||||
|
|
||||||
### 38.6 交互
|
|
||||||
|
|
||||||
| 行为 | 动效 |
|
|
||||||
|------|------|
|
|
||||||
| 入场 | 任务条由左端起点向右展开 `scaleX 0→1`（`transform-origin:left`），`400ms ease-out`，按行错峰 `60ms` |
|
|
||||||
| Hover 任务条 | 整条亮度 `+8%`，弹出 §35.6 Tooltip（任务名 / 起止日期 / 进度） |
|
|
||||||
| Hover 行 | 行底纹由 `#122347` → `#1A2F5A` (ZS-004-07) |
|
|
||||||
| 今日线（可选） | 一条 `1px dashed #4096FF` (ZS-002-05) 竖线标注当前日期 | §6.2 |
|
|
||||||
|
|
||||||
### 38.7 CSS Token 参考（§35–§38 共用）
|
|
||||||
|
|
||||||
```css
|
|
||||||
:root {
|
|
||||||
/* 图表容器与标题 */
|
|
||||||
--chart-bg: #0C1836; /* ZS-004-09 */
|
|
||||||
--chart-title-bar: #1677FF; /* ZS-002-06 标题竖条 */
|
|
||||||
--chart-title-text: #FFFFFF;
|
|
||||||
--chart-subtitle: #6E88B0; /* ZS-004-04 */
|
|
||||||
|
|
||||||
/* 坐标轴与网格 */
|
|
||||||
--chart-axis-line: #2D4473; /* ZS-004-06 */
|
|
||||||
--chart-axis-label: #6E88B0; /* ZS-004-04 */
|
|
||||||
--chart-axis-cat: #4096FF; /* ZS-002-05 类目名 */
|
|
||||||
--chart-grid: #2D4473; /* ZS-004-06 虚线网格 */
|
|
||||||
--chart-grid-weak: #1A2F5A; /* ZS-004-07 */
|
|
||||||
|
|
||||||
/* 图例 / Tooltip */
|
|
||||||
--chart-legend-text: #C5CFE0; /* ZS-004-02 */
|
|
||||||
--chart-legend-off: #4A6491; /* ZS-004-05 未选中 */
|
|
||||||
--chart-tooltip-bg: rgba(12,24,54,0.92);
|
|
||||||
--chart-tooltip-border:#1A2F5A; /* ZS-004-07 */
|
|
||||||
--chart-tooltip-title: #FFFFFF;
|
|
||||||
--chart-tooltip-value: #C5CFE0;
|
|
||||||
--chart-axispointer: #4096FF; /* ZS-002-05 */
|
|
||||||
--chart-highlight-band:rgba(22,119,255,0.12);
|
|
||||||
|
|
||||||
/* 通用图表色序（面积大） */
|
|
||||||
--chart-c1: #1677FF; --chart-c2: #13C2C2; --chart-c3: #4096FF; --chart-c4: #36CFC9;
|
|
||||||
--chart-c5: #69B1FF; --chart-c6: #5CDBD3; --chart-c7: #91CAFF; --chart-c8: #87E8DE;
|
|
||||||
|
|
||||||
/* 小面积图表色序 */
|
|
||||||
--chart-s1: #4096FF; --chart-s2: #36CFC9; --chart-s3: #FF4D4F;
|
|
||||||
--chart-s4: #FFA39E; --chart-s5: #6388FF; --chart-s6: #478880;
|
|
||||||
|
|
||||||
/* 排行进度条（§36.5） */
|
|
||||||
--rank-bar-fill: linear-gradient(90deg, #1677FF 0%, #13C2C2 100%);
|
|
||||||
--rank-bar-track: #1A2F5A; /* ZS-004-07 */
|
|
||||||
--rank-value: #FFFFFF;
|
|
||||||
|
|
||||||
/* 甘特图（§38） */
|
|
||||||
--gantt-track: #122347; /* ZS-004-08 行底纹 */
|
|
||||||
--gantt-row-hover: #1A2F5A; /* ZS-004-07 */
|
|
||||||
--gantt-c1: #FAAD14; /* 警告橙 */
|
|
||||||
--gantt-c2: #FF4D4F; /* ZS-001-05 */
|
|
||||||
--gantt-c3: #36CFC9; /* ZS-003-05 */
|
|
||||||
--gantt-c4: #91CAFF; /* ZS-002-03 */
|
|
||||||
--gantt-c5: #1677FF; /* ZS-002-06 */
|
|
||||||
--gantt-today: #4096FF; /* ZS-002-05 今日线 */
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
> 项目当前未引入图表库；若后续接入 ECharts，可将以上 token 注入主题（`backgroundColor` / `axisLine.lineStyle.color` / `splitLine.lineStyle` / `color[]` 色序 / `tooltip.backgroundColor` 等），保持与本规范一致。
|
|
||||||
>
|
|
||||||
> **关于多系列填充色**：§36–§38 表格中标注的系列色用于说明语义映射；**实际多系列图表的系列填充色一律以 §41 图表色值（设计稿 8.7）为准**——即淡色系 `#FA9196 / #FFCC80 / #97EBCD / #A2E1F9 / #80BCFF …`，按系列数量取对应色序。§1.1.8 的高彩度色序仅用于需要强对比的强调场景（如单色进度条渐变、KPI 高亮）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 39. 环形图（Donut / Ring）
|
|
||||||
|
|
||||||
> 对应设计稿「8.3 图表-环形图」。中心带总量数字的占比环图，按分类数量分**三环 / 四环 / 五环 / 六环 / 七环 / 八环**等变体。环段配色取 §41 图表色值（淡色系列），中心总量与引导标签取深蓝系字体色。
|
|
||||||
|
|
||||||
### 39.1 结构
|
|
||||||
|
|
||||||
```
|
|
||||||
三环 / 四环 …（标题）
|
|
||||||
╭──────────╮
|
|
||||||
Media│ │Social
|
|
||||||
28% │ 34801 │ 36%
|
|
||||||
│ XXX总量 │
|
|
||||||
╰──────────╯
|
|
||||||
News 28%
|
|
||||||
```
|
|
||||||
|
|
||||||
### 39.2 环体规格
|
|
||||||
|
|
||||||
| 属性 | 取值 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 外径 | 容器短边的 `60%~70%` | — |
|
|
||||||
| 内径（中空比） | 外径的 `62%`（环宽约 `38%`） | — |
|
|
||||||
| 环段间隙 | `2px`（用容器底色 `#0C1836` 描边分隔） | §35.1 |
|
|
||||||
| 环段圆角 | `2px`（段端微圆角，可选） | §4.1 |
|
|
||||||
| 环段配色 | 按分类数取 §41 对应「N 色」色序 | §41 |
|
|
||||||
| 起始角 / 方向 | 顶部 `90°` 起，顺时针 | — |
|
|
||||||
|
|
||||||
### 39.3 中心与标签
|
|
||||||
|
|
||||||
| 元素 | 规格 / 配色 | 来源 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| 中心主数值（如 `34801`） | `26px Bold D-DIN`，`#FFFFFF` | §2.1.2 |
|
|
||||||
| 中心说明（如 `XXX总量`） | `12px Regular`，`#6E88B0` (ZS-004-04) | — |
|
|
||||||
| 引导标签名（如 `Social`） | `12px Regular`，`#C5CFE0` (ZS-004-02) | — |
|
|
||||||
| 引导标签占比（如 `36%`） | `12px Regular`，`#FFFFFF` 或对应环段色 | — |
|
|
||||||
| 引导线 | `1px solid #4A6491` (ZS-004-05) 折线，从环段引至外侧标签 | §6.1 |
|
|
||||||
| 变体标题（三环 / 四环…） | `14px Medium`，`#C5CFE0`，居中于图上方 | §35.2 |
|
|
||||||
|
|
||||||
### 39.4 交互
|
|
||||||
|
|
||||||
| 行为 | 动效 |
|
|
||||||
|------|------|
|
|
||||||
| 入场 | 环段沿顺时针扫出 `0°→终值`，`600ms ease-out`，按段错峰 `60ms` |
|
|
||||||
| Hover 环段 | 该段沿半径外扩 `4px`（`offset`），中心数值切换为该段值 + 占比，弹出 §35.6 Tooltip |
|
|
||||||
| 图例点击 | 切换分类显隐，其余环段占比按比例重算 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 40. 关系图 / 散点图（Network / Scatter）
|
|
||||||
|
|
||||||
> 对应设计稿「8.6 图表-散点图」「关系图」。用于展示账号、节点间关系的力导向网络图与散点分布。深蓝背景上以**发光节点 + 渐隐连线 + 平台聚类**呈现，节点配色取主色蓝 / 警告橙 / 危险红做分类，节点尺寸映射权重。
|
|
||||||
|
|
||||||
### 40.1 节点（Node）
|
|
||||||
|
|
||||||
| 元素 | 规格 / 配色 | 来源 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| 形状 | 圆形（普通节点）/ 头像圆（账号节点，`2px` 描边）/ 六边形（聚合节点） | — |
|
|
||||||
| 直径 | `8px ~ 40px`，按权重（连接数 / 数值）线性映射 | — |
|
|
||||||
| 分类色 A（本方 / 主） | `#1677FF` (ZS-002-06) | §1.1.3 |
|
|
||||||
| 分类色 B（异常 / 外部） | `--func-warning`（橙） | §27.4 |
|
|
||||||
| 分类色 C（高危 / 标红） | `#FF4D4F` (ZS-001-05) | §1.1.2 |
|
|
||||||
| 节点发光（重点节点） | `0 0 12px` 同色 40% 透明外发光 | §3.1 |
|
|
||||||
| 节点文字（数值 / 名称） | `12px Regular`，`#FFFFFF`（节点内）/ `#C5CFE0`（节点外） | — |
|
|
||||||
| 中心 / 焦点节点 | 加大直径 + 强发光，橙色 `--func-warning` 高亮 | — |
|
|
||||||
|
|
||||||
### 40.2 连线（Edge）
|
|
||||||
|
|
||||||
| 元素 | 规格 / 配色 | 来源 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| 线宽 | `1px`（普通）/ `2px`（强关系） | — |
|
|
||||||
| 颜色 | `#4A6491` (ZS-004-05) 半透明，或取**起点节点分类色** 40% 透明 | §1.1.5 |
|
|
||||||
| 渐隐 | 由中心向外渐隐（`opacity 0.6 → 0.15`），弱化边缘视觉噪声 | — |
|
|
||||||
| 方向（有向） | 末端箭头 `4px`，同线色 | — |
|
|
||||||
| 高亮态（hover 节点时） | 关联边升为节点分类色满饱和、`2px`，无关边降至 `opacity 0.08` | — |
|
|
||||||
|
|
||||||
### 40.3 散点图（Scatter，纯坐标分布）
|
|
||||||
|
|
||||||
| 元素 | 规格 / 配色 | 来源 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| 散点 | 实心圆 `6px ~ 16px`（尺寸可映射第三维） | — |
|
|
||||||
| 配色 | 小面积色序（§41 或 §1.1.8 小面积），分类着色 | §41 |
|
|
||||||
| 坐标轴 / 网格 | 沿用 §35.3 / §35.4 | §35 |
|
|
||||||
| 气泡变体 | 半透明填充 `35%` + `1px` 同色描边，避免重叠遮挡 | — |
|
|
||||||
|
|
||||||
### 40.4 平台聚类与图例（如 Facebook / Twitter / 微博 / TikTok）
|
|
||||||
|
|
||||||
| 元素 | 规格 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 聚类标签 | 平台名 `14px Medium`，对应聚类主色（如蓝 / 橙 / 红） | — |
|
|
||||||
| 聚类辅文 | 数值 `12px Regular`，`#6E88B0` | — |
|
|
||||||
| 图例（XXX / XXX） | 方块 marker + 文字，置右下角 | §35.5 |
|
|
||||||
| 更新提示（如「近30分钟更新数据」） | `12px Regular`，`#6E88B0`，右下角 | — |
|
|
||||||
|
|
||||||
### 40.5 控制区（关系图侧栏）
|
|
||||||
|
|
||||||
设计稿左侧含「选择目标」下拉 + 分类勾选列表（主页发帖 / 群组发帖 / 私信 / 点赞 / 转发 / 帖子评论 / Pages内容 / 目标的主页帖子）+「添加账号 / 全选账号」按钮。
|
|
||||||
|
|
||||||
| 元素 | 规格 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 「选择目标」下拉 | 沿用 §15 选择器 | §15 |
|
|
||||||
| 分类列表项 | `14px Regular`，前缀分类色圆点 `8px`，沿用 §16 多选 | §16 |
|
|
||||||
| 「添加账号」 | §5.2.2 默认按钮（含 `+` 图标） | §5.3.2 |
|
|
||||||
| 「全选账号」 | §5.2.3 文本按钮 | §5.2.3 |
|
|
||||||
| 刷新图标（右上 ⟳） | `16px`，`#6E88B0`，hover `#4096FF` | §8.2.5 |
|
|
||||||
|
|
||||||
### 40.6 交互
|
|
||||||
|
|
||||||
| 行为 | 动效 |
|
|
||||||
|------|------|
|
|
||||||
| 力导向布局 | 节点入场后力导向收敛，`tick` 动画 `~800ms` 后静止 |
|
|
||||||
| Hover 节点 | 高亮关联边与邻接节点（§40.2），其余降透明；弹出 §35.6 Tooltip（节点名 / 类型 / 指标） |
|
|
||||||
| 点击节点 | 居中聚焦该节点并展开其一度关系；可下钻 |
|
|
||||||
| 缩放 / 平移 | 滚轮缩放 `0.5×~3×`，拖拽平移画布 |
|
|
||||||
| 拖拽节点 | 可手动拖拽固定节点位置 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 41. 图表色值（Chart Palette · 多系列色序）
|
|
||||||
|
|
||||||
> 对应设计稿「8.7 图表-色值」。这是**全站图表多系列填充的权威色序**（淡色系，深蓝背景上柔和、区分度高）。按系列数量从「三色」到「十色」各有固定取色顺序——系列数为 N 时直接取「N 色」整行，**不要自行截取或乱序**。如需超过十色或特殊场景，由 UI 设计师按整体风格补充。
|
|
||||||
|
|
||||||
### 41.1 基础色板
|
|
||||||
|
|
||||||
| 色名 | 色值 | 色相 |
|
|
||||||
|------|------|------|
|
|
||||||
| 粉红 | `#FA9196` | 红 |
|
|
||||||
| 橙红 | `#FCA58F` | 橙红 |
|
|
||||||
| 橙 | `#FDB887` | 橙 |
|
|
||||||
| 浅橙 | `#FFCC80` | 黄橙 |
|
|
||||||
| 黄绿 | `#DCD69A` | 黄绿 |
|
|
||||||
| 浅绿 | `#BAE1B3` | 绿 |
|
|
||||||
| 青绿 | `#97EBCD` | 青绿 |
|
|
||||||
| 浅青 | `#9EE4EA` | 青 |
|
|
||||||
| 浅蓝 | `#A2E1F9` | 天蓝 |
|
|
||||||
| 蓝 | `#80BCFF` | 蓝 |
|
|
||||||
|
|
||||||
### 41.2 按系列数取色序
|
|
||||||
|
|
||||||
| 系列数 | 取色顺序 |
|
|
||||||
|--------|----------|
|
|
||||||
| 三色 | `#FA9196` · `#97EBCD` · `#80BCFF` |
|
|
||||||
| 四色 | `#FA9196` · `#FFCC80` · `#97EBCD` · `#A2E1F9` |
|
|
||||||
| 五色 | `#FA9196` · `#FFCC80` · `#97EBCD` · `#A2E1F9` · `#80BCFF` |
|
|
||||||
| 六色 | `#FA9196` · `#FFCC80` · `#BAE1B3` · `#97EBCD` · `#A2E1F9` · `#80BCFF` |
|
|
||||||
| 七色 | `#FA9196` · `#FCA58F` · `#FFCC80` · `#BAE1B3` · `#97EBCD` · `#A2E1F9` · `#80BCFF` |
|
|
||||||
| 八色 | `#FA9196` · `#FCA58F` · `#FDB887` · `#FFCC80` · `#BAE1B3` · `#97EBCD` · `#A2E1F9` · `#80BCFF` |
|
|
||||||
| 九色 | `#FA9196` · `#FCA58F` · `#FDB887` · `#FFCC80` · `#DCD69A` · `#BAE1B3` · `#97EBCD` · `#A2E1F9` · `#80BCFF` |
|
|
||||||
| 十色 | `#FA9196` · `#FCA58F` · `#FDB887` · `#FFCC80` · `#DCD69A` · `#BAE1B3` · `#97EBCD` · `#9EE4EA` · `#A2E1F9` · `#80BCFF` |
|
|
||||||
|
|
||||||
> 规律：色序整体沿「红 → 橙 → 黄绿 → 绿 → 青 → 蓝」色相环渐变铺开；系列数增加时在中间插入过渡色，**首色恒为 `#FA9196`、末色恒为 `#80BCFF`**，保证冷暖两端锚定不变。
|
|
||||||
|
|
||||||
### 41.3 与既有规范的关系
|
|
||||||
|
|
||||||
| 色序 | 用途 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| §41 淡色系列（本节） | 图表**多系列填充**（柱 / 折线 / 环形 / 散点分类）默认色序 | 设计稿 8.7 |
|
|
||||||
| §1.1.8 通用图表色序（高彩度） | 强对比强调：单色渐变进度条、KPI 高亮、需要醒目的单系列 | §1.1.8 |
|
|
||||||
| §27.4 / §1.1.2 语义色 | 带语义的系列（成功 / 警告 / 错误 / 信息） | §27.4 |
|
|
||||||
|
|
||||||
> 三者优先级：**有语义 → 用语义色；多分类并列 → 用 §41；需强调单值 → 用 §1.1.8 高彩度**。§36–§40 中标注的具体系列色为语义示例，实际并列分类应回落到本节色序。
|
|
||||||
|
|
||||||
### 41.4 CSS Token 参考
|
|
||||||
|
|
||||||
```css
|
|
||||||
:root {
|
|
||||||
/* §41 图表多系列色板（淡色系，设计稿 8.7） */
|
|
||||||
--chart-p-red: #FA9196;
|
|
||||||
--chart-p-redorange:#FCA58F;
|
|
||||||
--chart-p-orange: #FDB887;
|
|
||||||
--chart-p-amber: #FFCC80;
|
|
||||||
--chart-p-olive: #DCD69A;
|
|
||||||
--chart-p-green: #BAE1B3;
|
|
||||||
--chart-p-teal: #97EBCD;
|
|
||||||
--chart-p-cyan: #9EE4EA;
|
|
||||||
--chart-p-skyblue: #A2E1F9;
|
|
||||||
--chart-p-blue: #80BCFF;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
```js
|
|
||||||
// 按系列数取色序（接入 ECharts 时用作 option.color）
|
|
||||||
export const CHART_PALETTES = {
|
|
||||||
3: ['#FA9196', '#97EBCD', '#80BCFF'],
|
|
||||||
4: ['#FA9196', '#FFCC80', '#97EBCD', '#A2E1F9'],
|
|
||||||
5: ['#FA9196', '#FFCC80', '#97EBCD', '#A2E1F9', '#80BCFF'],
|
|
||||||
6: ['#FA9196', '#FFCC80', '#BAE1B3', '#97EBCD', '#A2E1F9', '#80BCFF'],
|
|
||||||
7: ['#FA9196', '#FCA58F', '#FFCC80', '#BAE1B3', '#97EBCD', '#A2E1F9', '#80BCFF'],
|
|
||||||
8: ['#FA9196', '#FCA58F', '#FDB887', '#FFCC80', '#BAE1B3', '#97EBCD', '#A2E1F9', '#80BCFF'],
|
|
||||||
9: ['#FA9196', '#FCA58F', '#FDB887', '#FFCC80', '#DCD69A', '#BAE1B3', '#97EBCD', '#A2E1F9', '#80BCFF'],
|
|
||||||
10: ['#FA9196', '#FCA58F', '#FDB887', '#FFCC80', '#DCD69A', '#BAE1B3', '#97EBCD', '#9EE4EA', '#A2E1F9', '#80BCFF'],
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
@@ -1,320 +0,0 @@
|
|||||||
# 深蓝色 UI 规范 · 05 页面范例（§42–§44）
|
|
||||||
|
|
||||||
> 《深蓝色 UI 规范》分册之一。基础令牌见 `00-基础-色彩字体间距.md`，可 import 的变量见 `tokens.css`，总目录与 §索引见 `README.md`。`§N` 编号全局唯一。
|
|
||||||
|
|
||||||
**本篇目录**：`42` 表单弹窗范例 · `43` 卡片列表页 · `44` 数据概览仪表盘
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 42. 表单弹窗范例（添加 / 编辑标题）
|
|
||||||
|
|
||||||
> 对应设计稿「添加/编辑标题」弹窗（截图 ui-25）。这是 §21 弹出式窗口在「专项 / 标题录入」场景下的落地范例：容器 / 遮罩 / 标题栏 / 底部按钮全部沿用 §21，本节补充截图中出现而 §21 未单列的两个原子——**复合输入行**（输入框 + 行内下拉 + 行内按钮）与**行内「添加项」实心按钮**（+ 类别一 / + 类别二），并给出完整表单项清单。配色从 §1.1.2 渐红系（必填星号）、§1.1.3 渐蓝系（ZS-002，主色 / 下拉 / 按钮）、§1.1.5 深蓝系（ZS-004，label / 边框 / 容器）取。
|
|
||||||
|
|
||||||
### 42.1 整体布局
|
|
||||||
|
|
||||||
```
|
|
||||||
┌──────────────────────────────────────────────────────────────┐
|
|
||||||
│ 添加/编辑标题 ✕ │ ← 标题居中 + 关闭
|
|
||||||
│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │ ← 发光分割线
|
|
||||||
│ │
|
|
||||||
│ * 专项名称 [请输入内容 ] [一键导入历史专项模板▾] [预览] │ ← 复合输入行
|
|
||||||
│ * 专项简介 [请输入内容 ] │
|
|
||||||
│ * 国家地区 [ ▾ ] │
|
|
||||||
│ * 涉及类别 [ + 类别一 ] [ + 类别二 ] │ ← 行内添加按钮
|
|
||||||
│ * 显示指数 [请选择 ▾ ] │
|
|
||||||
│ │
|
|
||||||
│ [ 取消 ] [ 保存 ] │ ← 底部居中
|
|
||||||
└──────────────────────────────────────────────────────────────┘
|
|
||||||
```
|
|
||||||
|
|
||||||
### 42.2 容器与标题（沿用 §21）
|
|
||||||
|
|
||||||
| 元素 | 取值 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 遮罩 / 容器 / 圆角 / 阴影 | 全部沿用 §21.1 | §21.1 |
|
|
||||||
| 容器宽度 | 大档 `800px`（复合输入行需要横向空间） | §21.1 |
|
|
||||||
| 标题文字 | `添加/编辑标题`，`20px Bold`，`#FFFFFF`，居中 | §21.2 |
|
|
||||||
| 标题发光分割线 | `linear-gradient(90deg, transparent, #1677FF, transparent)`，`1px` 高 | §8.2.4 / §21.2 |
|
|
||||||
| 关闭 `✕` | `16px`，`#6E88B0` (ZS-004-04)，hover `#4096FF` (ZS-002-05) | §21.2 |
|
|
||||||
|
|
||||||
### 42.3 表单项（左 label + 右控件，沿用 §21.4）
|
|
||||||
|
|
||||||
| 行 | label | 控件 | 复用 |
|
|
||||||
|----|-------|------|------|
|
|
||||||
| 1 | `* 专项名称` | 复合输入行（见 §42.4） | §42.4 |
|
|
||||||
| 2 | `* 专项简介` | 单行输入框，占位「请输入内容」 | §14.1 |
|
|
||||||
| 3 | `* 国家地区` | 选择器（▾，空态占位） | §15.1 |
|
|
||||||
| 4 | `* 涉及类别` | 行内「添加项」实心按钮组（见 §42.5） | §42.5 |
|
|
||||||
| 5 | `* 显示指数` | 选择器（▾，占位「请选择」） | §15.1 |
|
|
||||||
|
|
||||||
- label `14px Regular`，`#C5CFE0` (ZS-004-02)，右对齐；必填星号 `*` `#F5222D` (ZS-001-06) 置于 label 前（§21.4）
|
|
||||||
- 表单项纵向间距 `--spacing-4` (16px)（§7.1）
|
|
||||||
|
|
||||||
### 42.4 复合输入行（输入框 + 行内下拉 + 行内按钮）
|
|
||||||
|
|
||||||
「专项名称」行把主输入框、「一键导入历史专项模板」下拉、「预览」主按钮拼在同一行。
|
|
||||||
|
|
||||||
| 元素 | 色值 / 规格 | 来源 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| 主输入框 | 沿用 §14.1，弹性撑满左侧剩余宽 | §14.1 |
|
|
||||||
| 行内下拉「一键导入历史专项模板 ▾」 | 沿用 §15.1 选择器触发器，固定宽（约 `200px`），占位文字 `#6E88B0` | §15.1 |
|
|
||||||
| 行内按钮「预览」 | §5.2.1 主按钮（实心 `#1677FF` + 白字） | §5.2.1 |
|
|
||||||
| 元素间水平间距 | `--spacing-2` (8px) | §7.1 |
|
|
||||||
| 三者垂直对齐 | 统一 `32px` 高，基线居中 | §5.1 |
|
|
||||||
|
|
||||||
### 42.5 行内「添加项」实心按钮（+ 类别一 / + 类别二）
|
|
||||||
|
|
||||||
「涉及类别」用一排实心主色蓝按钮，左侧 `+` 图标，点击进入对应类别的添加 / 编辑流程。
|
|
||||||
|
|
||||||
| 状态 | 背景 | 文字 / 图标 | 来源 |
|
|
||||||
|------|------|-------------|------|
|
|
||||||
| 默认 | `#1677FF` (ZS-002-06) | `#FFFFFF` | §5.2.1 / §5.3.2 |
|
|
||||||
| Hover | `#0958D9` (ZS-002-07) | `#FFFFFF` | §5.2.1 |
|
|
||||||
| Active | `#003EB3` (ZS-002-08) | `#FFFFFF` | §5.2.1 |
|
|
||||||
|
|
||||||
- 高度 `32px`，圆角 `2px`（§4.1），内边距 `0 14px`（§5.1）
|
|
||||||
- `+` 图标与文字同色 `#FFFFFF`，间距 `--spacing-1` (4px)（§5.3.2）
|
|
||||||
- 按钮之间间距 `--spacing-2` (8px)
|
|
||||||
- 与 §21.5.1 分段按钮组的区别：分段组是**互斥单选**（选中才高亮）；此处每个按钮都是**独立的添加入口**，常驻主色实心。
|
|
||||||
|
|
||||||
### 42.6 底部操作（沿用 §21.6）
|
|
||||||
|
|
||||||
| 元素 | 规格 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 对齐 | 居中（跟随截图） | §21.6 |
|
|
||||||
| 「取消」 | §5.2.2 默认按钮（Outline） | §5.2.2 |
|
|
||||||
| 「保存」 | §5.2.1 主按钮（实心蓝） | §5.2.1 |
|
|
||||||
| 顺序 / 间距 | 取消在左、保存在右；间距 `--spacing-2` (8px) | §5.3.4 |
|
|
||||||
|
|
||||||
### 42.7 CSS Token 参考
|
|
||||||
|
|
||||||
```css
|
|
||||||
:root {
|
|
||||||
/* 复合输入行 */
|
|
||||||
--field-row-gap: 8px; /* --spacing-2 元素间距 */
|
|
||||||
--field-addon-select-w: 200px; /* 行内下拉固定宽 */
|
|
||||||
--field-row-h: 32px; /* 统一高度 */
|
|
||||||
|
|
||||||
/* 行内添加按钮（沿用主按钮） */
|
|
||||||
--addbtn-bg: #1677FF; /* ZS-002-06 */
|
|
||||||
--addbtn-bg-hover: #0958D9; /* ZS-002-07 */
|
|
||||||
--addbtn-bg-active: #003EB3; /* ZS-002-08 */
|
|
||||||
--addbtn-text: #FFFFFF;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 43. 卡片列表页（监测任务卡片）
|
|
||||||
|
|
||||||
> 对应设计稿「监测任务卡片列表」（截图 ui-26）。这是 §22 卡片在「监测任务管理」场景下的整页范例：顶部导航沿用 §8、左侧三级菜单沿用 §8.3、卡片容器沿用 §22，本节补充**页面工具条**（搜索 + 添加 + 排序）与**监测任务卡片**的专用布局（头部 + 总量 KPI + 平台统计矩阵 + 底部操作 + 空态）。配色从 §1.1.3 渐蓝系（ZS-002，主色 / KPI 数字）与 §1.1.5 深蓝系（ZS-004，容器 / 文字）取。
|
|
||||||
|
|
||||||
### 43.1 整体布局
|
|
||||||
|
|
||||||
```
|
|
||||||
┌─ Header（§8.2）──────────────────────────────────────────────┐
|
|
||||||
├──┬────────────────────────────────────────────────────────────┤
|
|
||||||
│三│ [🔍 搜索关键词/任务名称 ] [+ 添加任务] 排序: 创建时间▾ ↑升序 │ ← 工具条
|
|
||||||
│级│ ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌──────────┐ │
|
|
||||||
│菜│ │ 莫某某 10247│ │ 冯某某 10247│ │ 钱某艺 10247│ │ 赵磊 12 │ │ ← 卡片网格
|
|
||||||
│单│ │ 社交媒体(52)│ │ 社交媒体(52)│ │ 社交媒体(52)│ │ ... │ │
|
|
||||||
│ │ │ [开始监测] │ │ [开始监测] │ │ [开始监测] │ │ │ │
|
|
||||||
│ │ └────────────┘ └────────────┘ └────────────┘ └──────────┘ │
|
|
||||||
└──┴────────────────────────────────────────────────────────────┘
|
|
||||||
```
|
|
||||||
|
|
||||||
### 43.2 页面工具条
|
|
||||||
|
|
||||||
| 元素 | 色值 / 规格 | 来源 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| 搜索框 | 沿用 §14.2 基本搜索框，占位「搜索关键词 / 任务名称」 | §14.2 |
|
|
||||||
| 「+ 添加任务」 | §5.3.2 图标 + 文字主按钮（实心 `#1677FF` + 白字 + `+`） | §5.3.2 |
|
|
||||||
| 排序标签「排序」 | `14px Regular`，`#6E88B0` (ZS-004-04) | — |
|
|
||||||
| 排序字段「创建时间 ▾」 | §15.1 选择器触发器（小号） | §15.1 |
|
|
||||||
| 升 / 降序切换「↑ 升序 / ↓ 降序」 | §5.2.3 文本按钮，激活向 `#4096FF` (ZS-002-05) | §5.2.3 |
|
|
||||||
| 工具条 → 卡片区间距 | `--spacing-5` (24px) | §7.1 |
|
|
||||||
| 工具条内元素间距 | `--spacing-3` (12px) | §7.1 |
|
|
||||||
|
|
||||||
### 43.3 监测任务卡片
|
|
||||||
|
|
||||||
```
|
|
||||||
┌──────────────────────────────────────┐
|
|
||||||
│ 👤 莫某某 10247 │ ← 头部：头像+名称 / 右上总量
|
|
||||||
│ 2023-09-09 09:13:00 总数量 │
|
|
||||||
│ ──────────────────────────────────── │
|
|
||||||
│ 社交媒体 (52) │ ← 统计区标题
|
|
||||||
│ 微博 16 推特 8 facebook 16 │ ← 平台统计矩阵
|
|
||||||
│ 抖音 12 土豆 6 大牛网 9 │
|
|
||||||
│ ──────────────────────────────────── │
|
|
||||||
│ url: t.djxqbjhgf9y.cn 也方开夫某利地址│
|
|
||||||
│ [ 开始监测 ] │ ← 底部操作
|
|
||||||
└──────────────────────────────────────┘
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 43.3.1 结构与配色
|
|
||||||
|
|
||||||
| 元素 | 色值 / 规格 | 来源 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| 卡片容器 | 同 §22.1（背景 `#122347` / 边框 `#1A2F5A` / 圆角 `4px` / 一级阴影） | §22.1 |
|
|
||||||
| 头像占位 | 圆 `40px`，底 `#1A2F5A` (ZS-004-07)，图标 `#6E88B0` | §22.3 |
|
|
||||||
| 任务名（莫某某） | `16px Medium`，`#FFFFFF` | §22.3 |
|
|
||||||
| 创建时间 | `12px Regular`（D-DIN 数字），`#6E88B0` (ZS-004-04) | §8.2.5 |
|
|
||||||
| 总量数值（10247） | `26px Bold`（D-DIN），`#4096FF` (ZS-002-05) | §2.1.2 / §1.1.3 |
|
|
||||||
| 总量标签「总数量」 | `12px Regular`，`#6E88B0` (ZS-004-04) | — |
|
|
||||||
| 头部底分割线 | `1px solid #1A2F5A` (ZS-004-07) | §6.1 |
|
|
||||||
|
|
||||||
#### 43.3.2 平台统计矩阵
|
|
||||||
|
|
||||||
统计区为「平台名 + 数值」多列网格（如 社交媒体 (52) 下的 微博 / 推特 / facebook…）。
|
|
||||||
|
|
||||||
| 元素 | 色值 / 规格 | 来源 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| 区标题「社交媒体 (52)」 | `14px Medium`，`#C5CFE0` (ZS-004-02)；括号计数 `#6E88B0` | — |
|
|
||||||
| 平台名 | `14px Regular`，`#6E88B0` (ZS-004-04) | — |
|
|
||||||
| 平台数值（数字） | `16px Bold`（D-DIN），`#C5CFE0` (ZS-004-02) | §2.1.2 |
|
|
||||||
| 矩阵列数 | 3 列等分，行间距 `--spacing-2` (8px) | §7.1 |
|
|
||||||
| 名 / 值间距 | `--spacing-1` (4px) | §7.1 |
|
|
||||||
|
|
||||||
#### 43.3.3 底部操作
|
|
||||||
|
|
||||||
| 元素 | 色值 / 规格 | 来源 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| 「开始监测」 | §5.2.1 主按钮（实心 `#1677FF`）；运行中切 §5.4.2 加载态 | §5.2.1 / §5.4.2 |
|
|
||||||
| 次要链接（如 url / 地址） | §5.2.3 文本按钮 `#4096FF` (ZS-002-05) | §5.2.3 |
|
|
||||||
| 操作区上分割线 | `1px solid #2D4473`（弱化） | §6.1 |
|
|
||||||
|
|
||||||
#### 43.3.4 空态卡片变体
|
|
||||||
|
|
||||||
部分卡片暂无数据（总量 `0` + 占位）：
|
|
||||||
|
|
||||||
| 元素 | 色值 / 规格 | 来源 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| 总量数值 | `0`，`26px Bold`，`#6E88B0` (ZS-004-04，弱化非主色) | — |
|
|
||||||
| 占位文字「暂无数据」 | `14px Regular`，`#6E88B0` (ZS-004-04)，居中 | §35.9 |
|
|
||||||
| 占位插画 | 灰度线性图标，`#4A6491` (ZS-004-05) | §35.9 |
|
|
||||||
|
|
||||||
### 43.4 卡片栅格（沿用 §22.4）
|
|
||||||
|
|
||||||
| 规则 | 取值 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 列数 | 自适应，常用 3~4 列 | — |
|
|
||||||
| 卡片横 / 纵间距 | `--spacing-6` (32px) | §22.4 |
|
|
||||||
| 卡片内边距 | `--spacing-4` (16px) | §22.4 |
|
|
||||||
|
|
||||||
### 43.5 CSS Token 参考
|
|
||||||
|
|
||||||
```css
|
|
||||||
:root {
|
|
||||||
/* 监测任务卡片 */
|
|
||||||
--task-card-name: #FFFFFF;
|
|
||||||
--task-card-time: #6E88B0; /* ZS-004-04 */
|
|
||||||
--task-kpi-num: #4096FF; /* ZS-002-05 总量数字 */
|
|
||||||
--task-kpi-label: #6E88B0; /* ZS-004-04 */
|
|
||||||
--task-stat-name: #6E88B0; /* ZS-004-04 平台名 */
|
|
||||||
--task-stat-num: #C5CFE0; /* ZS-004-02 平台数值 */
|
|
||||||
--task-divider: #1A2F5A; /* ZS-004-07 头部分割 */
|
|
||||||
--task-divider-weak: #2D4473; /* ZS-004-06 操作区分割 */
|
|
||||||
--task-empty-text: #6E88B0; /* ZS-004-04 空态 */
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 44. 数据概览仪表盘（KPI 指标条 + 综合图表）
|
|
||||||
|
|
||||||
> 对应设计稿「资源使用率概览大屏」（截图 ui-27）。这是一张把 §35–§41 各图表与 §28 表格、§9.1 页签组合在一起的概览页。本节补充截图顶部出现而前文未单列的新原子——**KPI 指标卡条**（图标 + 标签 + 大数值 + 已用 + 迷你环 + 同比 / 环比箭头徽标），其余区块均引用既有章节。配色从 §1.1.3 渐蓝系（ZS-002，主色 / 数值）、§1.1.4 渐青系（ZS-003，辅色）、§1.1.5 深蓝系（ZS-004，容器 / 文字）取；涨跌语义色见 §44.2。
|
|
||||||
|
|
||||||
### 44.1 整体布局
|
|
||||||
|
|
||||||
```
|
|
||||||
┌──┬────────────────────────────────────────────────────────────┐
|
|
||||||
│三│ ▓ KPI 指标条（账号/设备/浏览器/代理IP/VPS/邮箱/手机卡/链卡服 使用率）▓│
|
|
||||||
│级│ ┌─ ▌XXX标题 ───────────────┐ ┌─ ▌XXX标题（资源列表）────────┐│
|
|
||||||
│菜│ │ [全部|账号资源|设备指标…] │ │ 🔍搜索 排序 ││
|
|
||||||
│单│ │ ◐异常率40% ╱╲折线异常点 │ │ 资源资料 关联设备 2024-… ││
|
|
||||||
│ │ │ 总量300 正常270 异常30 │ │ …（§28 表格行） ││
|
|
||||||
│ │ └───────────────────────────┘ └──────────────────────────────┘│
|
|
||||||
│ │ ┌─ ▌XXX标题 ───────────────────────┐ ┌─ ▌XXX标题 ──────────┐│
|
|
||||||
│ │ │ 异常分析 饼 + 折线（§37 / §39） │ │ ◐300/270 + 趋势饼 ││
|
|
||||||
│ │ └────────────────────────────────────┘ └─────────────────────┘│
|
|
||||||
└──┴────────────────────────────────────────────────────────────┘
|
|
||||||
```
|
|
||||||
|
|
||||||
### 44.2 涨跌语义色
|
|
||||||
|
|
||||||
| 语义 | 色值 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 上升 / 正向（▲） | `#13C2C2` (ZS-003-06，辅色青) | §1.1.4 |
|
|
||||||
| 下降 / 负向（▼） | `#F5222D` (ZS-001-06，主色红) | §1.1.2 |
|
|
||||||
| 持平 | `#6E88B0` (ZS-004-04) | §1.1.5 |
|
|
||||||
|
|
||||||
> 涨跌仅用语义色，不混入图表多系列色；正向用辅色青（ZS-003）而非主色蓝，避免与 KPI 数值蓝撞色。
|
|
||||||
|
|
||||||
### 44.3 KPI 指标卡条
|
|
||||||
|
|
||||||
横向一排等宽指标卡，每张承载一个使用率指标（如「账号使用率 139 已用」+ 迷你环 + 同比箭头）。
|
|
||||||
|
|
||||||
```
|
|
||||||
┌────────────────────────┐
|
|
||||||
│ 🅰 账号使用率 │ ← 图标 + 标签
|
|
||||||
│ 139 ◐ 45% ▲ │ ← 大数值 + 迷你环 + 同比
|
|
||||||
│ 已用 同比 │
|
|
||||||
└────────────────────────┘
|
|
||||||
```
|
|
||||||
|
|
||||||
| 元素 | 色值 / 规格 | 来源 |
|
|
||||||
|------|-------------|------|
|
|
||||||
| 卡片容器 | 背景 `#122347` (ZS-004-08)，边框 `1px solid #1A2F5A`，圆角 `4px`，一级阴影 | §22.1 |
|
|
||||||
| 指标图标 | `20px`，主色 `#4096FF` (ZS-002-05) 单色化 | §1.1.6 |
|
|
||||||
| 指标标签（账号使用率） | `14px Regular`，`#C5CFE0` (ZS-004-02) | — |
|
|
||||||
| 大数值（139） | `26px Bold`（D-DIN），`#FFFFFF` | §2.1.2 |
|
|
||||||
| 单位 / 说明「已用」 | `12px Regular`，`#6E88B0` (ZS-004-04) | — |
|
|
||||||
| 迷你环（mini-donut） | 直径 `32px`，环宽 `4px`，已用段 `#1677FF` (ZS-002-06)，底环 `#2D4473` (ZS-004-06) | §39.2 |
|
|
||||||
| 环内百分比 | `12px Bold`（D-DIN），`#FFFFFF` | §39.3 |
|
|
||||||
| 同比 / 环比箭头徽标 | `12px`，▲ 用 `#13C2C2`、▼ 用 `#F5222D`（见 §44.2） | §44.2 |
|
|
||||||
| 卡片宽度 | 等分横排（8 张则各占 1/8），最小宽 `160px` | — |
|
|
||||||
| 卡片间距 | `--spacing-4` (16px) | §7.1 |
|
|
||||||
| 卡片内边距 | `--spacing-4` (16px) | §7.1 |
|
|
||||||
|
|
||||||
### 44.4 区块组合引用
|
|
||||||
|
|
||||||
| 区块 | 复用 | 备注 |
|
|
||||||
|------|------|------|
|
|
||||||
| 区块标题（▌XXX标题） | §35.2 图表标题（主色蓝竖条 + 文字） | — |
|
|
||||||
| 分类页签（全部 / 账号资源 / …） | §9.1.1 横向页签 | 激活 `#4096FF` + `2px` 下划线 |
|
|
||||||
| 日期筛选（右上 `2023-02`） | §17.1 日期触发器 | — |
|
|
||||||
| 异常率环形图（40% / 总量300 / 正常270 / 异常30） | §39 环形图 | 正常段主色蓝、异常段 `#F5222D`（§44.2） |
|
|
||||||
| 折线异常点图（1月10日 异常率12.9%） | §37.3 单线异常点图 + §35.6 Tooltip | 异常点用红 `#F5222D` 强调 |
|
|
||||||
| 资源列表表格 | §28 表格 + §14.2 搜索 + §13 分页 | — |
|
|
||||||
| 异常分析饼 / 趋势饼 | §39 环形图 | 多系列回落 §41 色序 |
|
|
||||||
| 容器 / 内边距 / 多图间距 | §35.1 图表容器 | `--spacing-5` / `--spacing-6` |
|
|
||||||
|
|
||||||
### 44.5 交互
|
|
||||||
|
|
||||||
| 行为 | 规则 |
|
|
||||||
|------|------|
|
|
||||||
| KPI 卡 hover | 卡片阴影升二级（§3.1.4），迷你环高亮，弹出 §35.6 Tooltip（已用 / 总量 / 同比明细） |
|
|
||||||
| 页签切换 | 切换分类后下方图表与表格联动刷新（§9.1.1） |
|
|
||||||
| 图表 hover | 沿用各图表节交互（§37.6 / §39.4 等） |
|
|
||||||
| 日期筛选变更 | 重新拉取区块数据，图表入场动画重放 |
|
|
||||||
|
|
||||||
### 44.6 CSS Token 参考
|
|
||||||
|
|
||||||
```css
|
|
||||||
:root {
|
|
||||||
/* KPI 指标卡 */
|
|
||||||
--kpi-card-bg: #122347; /* ZS-004-08 */
|
|
||||||
--kpi-card-border: #1A2F5A; /* ZS-004-07 */
|
|
||||||
--kpi-icon: #4096FF; /* ZS-002-05 */
|
|
||||||
--kpi-label: #C5CFE0; /* ZS-004-02 */
|
|
||||||
--kpi-value: #FFFFFF;
|
|
||||||
--kpi-sub: #6E88B0; /* ZS-004-04 已用 */
|
|
||||||
--kpi-ring-used: #1677FF; /* ZS-002-06 迷你环已用段 */
|
|
||||||
--kpi-ring-track: #2D4473; /* ZS-004-06 迷你环底 */
|
|
||||||
|
|
||||||
/* 涨跌语义 */
|
|
||||||
--trend-up: #13C2C2; /* ZS-003-06 上升（辅色青） */
|
|
||||||
--trend-down: #F5222D; /* ZS-001-06 下降（红） */
|
|
||||||
--trend-flat: #6E88B0; /* ZS-004-04 持平 */
|
|
||||||
}
|
|
||||||
```
|
|
||||||
@@ -1,82 +0,0 @@
|
|||||||
# 深蓝色 UI 规范（拆分版）
|
|
||||||
|
|
||||||
面向开发的深蓝主题设计规范。原单文件 `../ui修改-深蓝.md`（约 5200 行）已按模块拆分到本目录，便于按需查阅、减少 diff 冲突，也方便配合 AI 只加载相关分册。
|
|
||||||
|
|
||||||
> **颜色唯一来源**：所有色值以 **§1 色彩**（见 [`00-基础-色彩字体间距.md`](./00-基础-色彩字体间距.md)）为准，可执行变量见 [`tokens.css`](./tokens.css)。业务代码 **import `tokens.css` 并用 `var(--token)`**，不要硬编码 HEX。
|
|
||||||
|
|
||||||
## 分册
|
|
||||||
|
|
||||||
| 文件 | 章节 | 内容 |
|
|
||||||
|------|------|------|
|
|
||||||
| [`00-基础-色彩字体间距.md`](./00-基础-色彩字体间距.md) | §1–§7 | 色彩 / 字体 / 阴影 / 圆角 / 按钮 / 分割线 / 间距 |
|
|
||||||
| [`01-导航.md`](./01-导航.md) | §8–§13 | 导航组件 / 锚点页签 / 步骤条 / 面包屑 / 页头 / 分页 |
|
|
||||||
| [`02-表单.md`](./02-表单.md) | §14–§21 | 输入框 / 选择器 / 单复选 / 日期 / 穿梭框 / 树选择 / 上传 / 弹窗 |
|
|
||||||
| [`03-数据展示.md`](./03-数据展示.md) | §22–§34 | 卡片 / 折叠 / 描述列表 / 列表 / 时间轴 / 进度条 / 表格 / 标签 / 树 / 对话框 / 提示 / 气泡确认 |
|
|
||||||
| [`04-图表.md`](./04-图表.md) | §35–§41 | 图表通用 / 柱状 / 折线 / 甘特 / 环形 / 关系散点 / 图表色值 |
|
|
||||||
| [`05-页面范例.md`](./05-页面范例.md) | §42–§44 | 表单弹窗 / 卡片列表页 / 数据概览仪表盘 |
|
|
||||||
| [`tokens.css`](./tokens.css) | — | 全量 CSS 变量（颜色 / 间距 / 圆角 / 阴影 / 字体），可直接 import |
|
|
||||||
|
|
||||||
## § 索引（编号 → 所在文件）
|
|
||||||
|
|
||||||
章节编号 `§N` 全局唯一、跨文件不变；文中 `§N` / `§N.x` 引用按下表定位。
|
|
||||||
|
|
||||||
| § | 标题 | 文件 |
|
|
||||||
|---|------|------|
|
|
||||||
| §1 | 色彩 | 00 |
|
|
||||||
| §2 | 字体 | 00 |
|
|
||||||
| §3 | 阴影 | 00 |
|
|
||||||
| §4 | 圆角 | 00 |
|
|
||||||
| §5 | 按钮 | 00 |
|
|
||||||
| §6 | 分割线 | 00 |
|
|
||||||
| §7 | 间距 | 00 |
|
|
||||||
| §8 | 导航组件 | 01 |
|
|
||||||
| §9 | 锚点与页签 | 01 |
|
|
||||||
| §10 | 步骤条 | 01 |
|
|
||||||
| §11 | 面包屑 | 01 |
|
|
||||||
| §12 | 页头 | 01 |
|
|
||||||
| §13 | 分页 | 01 |
|
|
||||||
| §14 | 输入框（搜索框） | 02 |
|
|
||||||
| §15 | 选择器 | 02 |
|
|
||||||
| §16 | 单选与多选 | 02 |
|
|
||||||
| §17 | 日期选择器 | 02 |
|
|
||||||
| §18 | 穿梭框 | 02 |
|
|
||||||
| §19 | 树选择 | 02 |
|
|
||||||
| §20 | 上传 | 02 |
|
|
||||||
| §21 | 弹出式窗口（Modal） | 02 |
|
|
||||||
| §22 | 卡片 | 03 |
|
|
||||||
| §23 | 折叠面板 | 03 |
|
|
||||||
| §24 | 描述列表 | 03 |
|
|
||||||
| §25 | 列表 | 03 |
|
|
||||||
| §26 | 时间轴（节点型） | 03 |
|
|
||||||
| §27 | 进度条 | 03 |
|
|
||||||
| §28 | 表格 | 03 |
|
|
||||||
| §29 | 标签 | 03 |
|
|
||||||
| §30 | 树形控件 | 03 |
|
|
||||||
| §31 | 时间轴（长文本） | 03 |
|
|
||||||
| §32 | 对话框（确认框） | 03 |
|
|
||||||
| §33 | 全局提示 | 03 |
|
|
||||||
| §34 | 气泡确认 | 03 |
|
|
||||||
| §35 | 图表通用规范 | 04 |
|
|
||||||
| §36 | 柱状图 | 04 |
|
|
||||||
| §37 | 折线图 | 04 |
|
|
||||||
| §38 | 甘特图 | 04 |
|
|
||||||
| §39 | 环形图 | 04 |
|
|
||||||
| §40 | 关系图 / 散点图 | 04 |
|
|
||||||
| §41 | 图表色值 | 04 |
|
|
||||||
| §42 | 表单弹窗范例 | 05 |
|
|
||||||
| §43 | 卡片列表页 | 05 |
|
|
||||||
| §44 | 数据概览仪表盘 | 05 |
|
|
||||||
|
|
||||||
## 约定
|
|
||||||
|
|
||||||
- **颜色**：以 §1 为准，代码用 `tokens.css` 的 `var(--token)`。功能语义色（成功/警告/错误/信息/处理中）见 §1.1.9 / `--func-*`。
|
|
||||||
- **间距**：仅用 §7 的 8px 阶梯（`--spacing-1..8`），禁用 5px / 13px 等非阶梯值。
|
|
||||||
- **圆角**：按钮/输入/标签 `2px`，卡片/分栏/弹窗 `4px`（`--radius-*`）。
|
|
||||||
- **跨节引用**：保留 `§N` 编号，用上方「§ 索引」定位文件。
|
|
||||||
- **名称易混点**：§26 时间轴(节点型) ↔ §31 时间轴(长文本)；§21 弹出式窗口(Modal) ↔ §32 对话框(确认框)。
|
|
||||||
- **图表两套色板**：§1.1.8（高彩度，强调单值）与 §41（淡色系，多分类并列）并存，优先级见 §41.3。
|
|
||||||
|
|
||||||
## 维护
|
|
||||||
|
|
||||||
- 改色 / 改间距 → 先改 **`tokens.css` + §1/§7**，组件分册回落引用，不在分册里另立硬编码。
|
|
||||||
- 新增整页范例 → 进 `05-页面范例.md`，沿用既有组件 § 与 `tokens.css`。
|
|
||||||
@@ -1,211 +0,0 @@
|
|||||||
/* =============================================================================
|
|
||||||
* 深蓝色 UI 规范 · 设计令牌（tokens.css）
|
|
||||||
* -----------------------------------------------------------------------------
|
|
||||||
* 这是《深蓝色 UI 规范》全站颜色 / 间距 / 圆角 / 阴影 / 字体的唯一可执行来源。
|
|
||||||
* 开发时优先 import 本文件并使用 var(--token)，不要在业务代码里硬编码 HEX。
|
|
||||||
*
|
|
||||||
* 文档对应：
|
|
||||||
* §1 色彩 → 原始色阶 --zs-*、功能语义 --func-*、装饰/图表色板
|
|
||||||
* §2 字体 → --font-* / --fs-*
|
|
||||||
* §3 阴影 → --shadow-*
|
|
||||||
* §4 圆角 → --radius-*
|
|
||||||
* §7 间距 → --spacing-*
|
|
||||||
* 组件级 token（--card-* / --modal-* / --kpi-* 等）保留在各分册的「CSS Token 参考」
|
|
||||||
* 小节中，均回落到本文件的原始/语义 token。
|
|
||||||
* ========================================================================== */
|
|
||||||
|
|
||||||
:root {
|
|
||||||
/* ---------------------------------------------------------------------------
|
|
||||||
* 1. 原始色阶（§1.1.2–§1.1.5）—— 01 最浅 → 10 最深
|
|
||||||
* ------------------------------------------------------------------------ */
|
|
||||||
|
|
||||||
/* 渐红系 ZS-001 —— 警示 / 错误 / 强调 */
|
|
||||||
--zs-001-01: #FFF1F0;
|
|
||||||
--zs-001-02: #FFCCC7;
|
|
||||||
--zs-001-03: #FFA39E;
|
|
||||||
--zs-001-04: #FF7875;
|
|
||||||
--zs-001-05: #FF4D4F;
|
|
||||||
--zs-001-06: #F5222D;
|
|
||||||
--zs-001-07: #CF1322;
|
|
||||||
--zs-001-08: #A8071A;
|
|
||||||
--zs-001-09: #820014;
|
|
||||||
--zs-001-10: #5C0011;
|
|
||||||
|
|
||||||
/* 渐蓝系 ZS-002 —— 信息 / 链接 / 次级操作（含主色） */
|
|
||||||
--zs-002-01: #E6F4FF;
|
|
||||||
--zs-002-02: #BAE0FF;
|
|
||||||
--zs-002-03: #91CAFF;
|
|
||||||
--zs-002-04: #69B1FF;
|
|
||||||
--zs-002-05: #4096FF;
|
|
||||||
--zs-002-06: #1677FF;
|
|
||||||
--zs-002-07: #0958D9;
|
|
||||||
--zs-002-08: #003EB3;
|
|
||||||
--zs-002-09: #002C8C;
|
|
||||||
--zs-002-10: #001D6C;
|
|
||||||
|
|
||||||
/* 渐青系 ZS-003 —— 成功 / 在线 / 数据高亮（含辅色） */
|
|
||||||
--zs-003-01: #E6FFFB;
|
|
||||||
--zs-003-02: #B5F5EC;
|
|
||||||
--zs-003-03: #87E8DE;
|
|
||||||
--zs-003-04: #5CDBD3;
|
|
||||||
--zs-003-05: #36CFC9;
|
|
||||||
--zs-003-06: #13C2C2;
|
|
||||||
--zs-003-07: #08979C;
|
|
||||||
--zs-003-08: #006D75;
|
|
||||||
--zs-003-09: #00474F;
|
|
||||||
--zs-003-10: #002329;
|
|
||||||
|
|
||||||
/* 深蓝系 ZS-004 —— 背景 / 容器 / 导航 / 文字（主题核心） */
|
|
||||||
--zs-004-01: #E8EDF5;
|
|
||||||
--zs-004-02: #C5CFE0;
|
|
||||||
--zs-004-03: #9BADC8;
|
|
||||||
--zs-004-04: #6E88B0;
|
|
||||||
--zs-004-05: #4A6491;
|
|
||||||
--zs-004-06: #2D4473;
|
|
||||||
--zs-004-07: #1A2F5A;
|
|
||||||
--zs-004-08: #122347;
|
|
||||||
--zs-004-09: #0C1836;
|
|
||||||
--zs-004-10: #060E24;
|
|
||||||
|
|
||||||
/* ---------------------------------------------------------------------------
|
|
||||||
* 2. 功能角色色（§1.1.6）—— 从色阶提取的语义别名
|
|
||||||
* ------------------------------------------------------------------------ */
|
|
||||||
--color-primary: var(--zs-002-06); /* #1677FF 主操作 */
|
|
||||||
--color-primary-hover: var(--zs-002-07); /* #0958D9 */
|
|
||||||
--color-primary-active: var(--zs-002-08); /* #003EB3 */
|
|
||||||
--color-link: var(--zs-002-05); /* #4096FF 链接 / 文本按钮 */
|
|
||||||
--color-accent: var(--zs-003-06); /* #13C2C2 辅色 */
|
|
||||||
|
|
||||||
--color-text: var(--zs-004-02); /* #C5CFE0 正文字体 */
|
|
||||||
--color-text-secondary: var(--zs-004-04); /* #6E88B0 次级字体 */
|
|
||||||
--color-text-disabled: var(--zs-004-05); /* #4A6491 禁用字体 */
|
|
||||||
--color-text-strong: #FFFFFF; /* 标题 / 强调 */
|
|
||||||
|
|
||||||
--color-bg-page: var(--zs-004-09); /* #0C1836 页面背景 */
|
|
||||||
--color-bg-container: var(--zs-004-07); /* #1A2F5A 容器背景 */
|
|
||||||
--color-bg-card: var(--zs-004-08); /* #122347 卡片背景 */
|
|
||||||
--color-bg-deepest: var(--zs-004-10); /* #060E24 全局底色 */
|
|
||||||
--color-border: var(--zs-004-07); /* #1A2F5A 容器边框 */
|
|
||||||
--color-border-strong: var(--zs-004-04); /* #6E88B0 控件边框 */
|
|
||||||
--color-white: #FFFFFF;
|
|
||||||
|
|
||||||
/* ---------------------------------------------------------------------------
|
|
||||||
* 3. 功能语义色（§1.1.9）—— 成功/警告/错误/信息/处理中
|
|
||||||
* 成功绿、警告橙为标准色系外补充色；其余复用色阶。
|
|
||||||
* ------------------------------------------------------------------------ */
|
|
||||||
--func-success: #52C41A; /* 补充色 · 成功绿 */
|
|
||||||
--func-warning: #FAAD14; /* 补充色 · 警告橙 */
|
|
||||||
--func-error: var(--zs-001-06); /* #F5222D */
|
|
||||||
--func-info: var(--zs-002-06); /* #1677FF */
|
|
||||||
--func-processing: var(--zs-003-06); /* #13C2C2 */
|
|
||||||
|
|
||||||
/* 浅底变体（Message / Alert / Tag 背景，16% 透明度） */
|
|
||||||
--func-success-bg: rgba(82, 196, 26, 0.16);
|
|
||||||
--func-warning-bg: rgba(250, 173, 20, 0.16);
|
|
||||||
--func-error-bg: rgba(245, 34, 45, 0.16);
|
|
||||||
--func-info-bg: rgba(22, 119, 255, 0.16);
|
|
||||||
|
|
||||||
/* ---------------------------------------------------------------------------
|
|
||||||
* 4. 小面积装饰色（§1.1.7）—— 仅点缀 / 徽标，勿做大面积背景
|
|
||||||
* ------------------------------------------------------------------------ */
|
|
||||||
--deco-violet: #6388FF;
|
|
||||||
--deco-danger: #F5222D;
|
|
||||||
--deco-brand-blue: #12306C;
|
|
||||||
--deco-teal: #478880;
|
|
||||||
--deco-alert: #950404;
|
|
||||||
|
|
||||||
/* ---------------------------------------------------------------------------
|
|
||||||
* 5. 字体（§2）
|
|
||||||
* ------------------------------------------------------------------------ */
|
|
||||||
--font-zh: 'Noto Sans S Chinese', 'Noto Sans SC', system-ui, sans-serif;
|
|
||||||
--font-num: 'D-DIN', 'Noto Sans S Chinese', sans-serif; /* 数据数字 */
|
|
||||||
--font-digital:'DS-Digital', 'D-DIN', sans-serif; /* 大屏特殊数字 */
|
|
||||||
--font-logo: 'DOUYUFont', 'Noto Sans S Chinese', sans-serif;
|
|
||||||
--font-table: 'Arial', 'Noto Sans S Chinese', sans-serif; /* 表格数字 */
|
|
||||||
|
|
||||||
/* 常用字号（后台系统，§2.1.2） */
|
|
||||||
--fs-12: 12px;
|
|
||||||
--fs-14: 14px;
|
|
||||||
--fs-16: 16px;
|
|
||||||
--fs-18: 18px;
|
|
||||||
--fs-20: 20px;
|
|
||||||
--fs-24: 24px;
|
|
||||||
--fs-26: 26px;
|
|
||||||
|
|
||||||
/* ---------------------------------------------------------------------------
|
|
||||||
* 6. 间距（§7）—— 8px 基准，密(≤16) / 疏(≥24)，禁用非阶梯值
|
|
||||||
* ------------------------------------------------------------------------ */
|
|
||||||
--spacing-1: 4px;
|
|
||||||
--spacing-2: 8px;
|
|
||||||
--spacing-3: 12px;
|
|
||||||
--spacing-4: 16px;
|
|
||||||
--spacing-5: 24px;
|
|
||||||
--spacing-6: 32px;
|
|
||||||
--spacing-7: 40px;
|
|
||||||
--spacing-8: 56px;
|
|
||||||
|
|
||||||
/* ---------------------------------------------------------------------------
|
|
||||||
* 7. 圆角（§4）
|
|
||||||
* ------------------------------------------------------------------------ */
|
|
||||||
--radius-button: 2px;
|
|
||||||
--radius-input: 2px;
|
|
||||||
--radius-tag: 2px;
|
|
||||||
--radius-card: 4px;
|
|
||||||
--radius-panel: 4px;
|
|
||||||
--radius-modal: 4px;
|
|
||||||
|
|
||||||
/* ---------------------------------------------------------------------------
|
|
||||||
* 8. 阴影（§3.1.4）
|
|
||||||
* ------------------------------------------------------------------------ */
|
|
||||||
--shadow-1: 0 2px 8px rgba(22, 119, 255, 0.12); /* 卡片悬浮 */
|
|
||||||
--shadow-2: 0 4px 16px rgba(22, 119, 255, 0.24); /* hover / 弹出层 */
|
|
||||||
--shadow-3: 0 8px 32px rgba(6, 14, 36, 0.6); /* Dialog / Drawer */
|
|
||||||
--shadow-modal-mask: rgba(6, 14, 36, 0.6); /* 遮罩 */
|
|
||||||
|
|
||||||
/* 常用渐变 */
|
|
||||||
--gradient-header: linear-gradient(180deg, #122347 0%, #0C1836 100%); /* 顶栏 §8.2.1 */
|
|
||||||
--gradient-title-line: linear-gradient(90deg, transparent 0%, #1677FF 50%, transparent 100%); /* 标题发光线 §8.2.4 */
|
|
||||||
}
|
|
||||||
|
|
||||||
/* =============================================================================
|
|
||||||
* 图表多系列色板
|
|
||||||
* ========================================================================== */
|
|
||||||
:root {
|
|
||||||
/* 通用图表色序（§1.1.8，面积大：柱/折线/饼，高彩度） */
|
|
||||||
--chart-g-1: #1677FF;
|
|
||||||
--chart-g-2: #13C2C2;
|
|
||||||
--chart-g-3: #4096FF;
|
|
||||||
--chart-g-4: #36CFC9;
|
|
||||||
--chart-g-5: #69B1FF;
|
|
||||||
--chart-g-6: #5CDBD3;
|
|
||||||
--chart-g-7: #91CAFF;
|
|
||||||
--chart-g-8: #87E8DE;
|
|
||||||
|
|
||||||
/* 小面积图表色序（§1.1.8，散点/迷你图/徽标） */
|
|
||||||
--chart-s-1: #4096FF;
|
|
||||||
--chart-s-2: #36CFC9;
|
|
||||||
--chart-s-3: #FF4D4F;
|
|
||||||
--chart-s-4: #FFA39E;
|
|
||||||
--chart-s-5: #6388FF;
|
|
||||||
--chart-s-6: #478880;
|
|
||||||
|
|
||||||
/* 多系列填充色板（§41，淡色系，分类并列默认色序） */
|
|
||||||
--chart-p-red: #FA9196;
|
|
||||||
--chart-p-redorange: #FCA58F;
|
|
||||||
--chart-p-orange: #FDB887;
|
|
||||||
--chart-p-amber: #FFCC80;
|
|
||||||
--chart-p-olive: #DCD69A;
|
|
||||||
--chart-p-green: #BAE1B3;
|
|
||||||
--chart-p-teal: #97EBCD;
|
|
||||||
--chart-p-cyan: #9EE4EA;
|
|
||||||
--chart-p-skyblue: #A2E1F9;
|
|
||||||
--chart-p-blue: #80BCFF;
|
|
||||||
}
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 图表配色优先级（§41.3）：
|
|
||||||
* 有语义 → 用 --func-*；多分类并列 → 用 --chart-p-*（§41 色板）；
|
|
||||||
* 需强调单值 → 用 --chart-g-* / --chart-s-*（§1.1.8 高彩度）。
|
|
||||||
*
|
|
||||||
* 接入 ECharts 时按系列数取 option.color，见 §41.4 的 CHART_PALETTES。
|
|
||||||
*/
|
|
||||||
@@ -1,161 +0,0 @@
|
|||||||
# 需求文档 · 问答中心左侧栏改造（0616）
|
|
||||||
|
|
||||||
> 整理自 2026-06-16 需求草稿。本批需求统一围绕「问答中心」菜单下 5 个页面入口的**左侧侧边栏**进行改造，目标是让每个业务页面的左栏从「通用导航」变为「贴合该业务场景的快捷入口 + 历史记录」。
|
|
||||||
>
|
|
||||||
> 菜单结构参考：`frontend-web/src/core/page-layout/sidebar-menu.ts` 中 `qa-center`（问答中心）分组，含 5 个子项，正好对应下文 5 条需求。
|
|
||||||
|
|
||||||
## 0. 背景与共性约定
|
|
||||||
|
|
||||||
| 需求 | 菜单项 | id | 现有路由 | 对应页面/组件 |
|
|
||||||
|------|--------|----|----------|--------------|
|
|
||||||
| 1 | 通用问答 | `general-qa` | `/page/workspace/chats/new` | Workspace Chat + 左栏（`recent-chat-list.tsx` 等） |
|
|
||||||
| 2 | 多智能体会商 | `multi-agent-roundtable` | `/page/strategy/qa/multi-agent-roundtable` | `roundtable-planning/pages/RoundtablePlanningPage.tsx` |
|
|
||||||
| 3 | zzJC支持 | `qa-zzjc` | `/page/strategy/agents/6bf/chats/new` | `pages/AgentChatPage.tsx` |
|
|
||||||
| 4 | zzXD应用 | `qa-zzxd` | `/page/strategy/agents/10d69686718349688e58a8790cb61024/chats/new` | `pages/AgentChatPage.tsx` |
|
|
||||||
| 5 | 课题研究 | `qa-research` | `/page/canvas/ai-writing` | `open-canvas/pages/AIWritingPage.tsx` |
|
|
||||||
|
|
||||||
**共性约定（适用于全部 5 条，除非单条另有说明）：**
|
|
||||||
|
|
||||||
- 「更多」一律为可点击入口；点击后跳转到对应的完整列表/管理页（具体目标见各条「待确认」）。
|
|
||||||
- 列表为空时的兜底：参考各条「现状」中的级联/空态规则；无内容时该区块整体隐藏或显示占位文案（待 UI 设计确认，默认隐藏，与现有 `recent-chat-list.tsx` 一致）。
|
|
||||||
- 左栏宽度、折叠交互沿用现有侧边栏体系（`SidebarGroup` 系列组件）。
|
|
||||||
- 所有「智能体」相关数据复用 `core/agents`（`Agent` 类型已含 `is_pinned` / `is_favorite` / `featured_order`，scope 支持 `mine` / `square` / `builtin`）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 通用问答 — 左侧栏改造
|
|
||||||
|
|
||||||
**页面**：`/page/workspace/chats/new`
|
|
||||||
|
|
||||||
### 1.1 现状
|
|
||||||
当前左栏主要展示「最近会话」列表（`recent-chat-list.tsx`，已过滤 `scheduler` / `bootstrap` / `roundtable` 类型线程，置顶会话优先）。
|
|
||||||
|
|
||||||
### 1.2 目标布局（自上而下）
|
|
||||||
左栏从上到下依次为三块：**新建回答按钮 → 常用智能体 → 聊天记录**。
|
|
||||||
|
|
||||||
#### ① 顶部：新建回答
|
|
||||||
- 左栏最顶部放置「**新建回答**」按钮（主操作）。
|
|
||||||
- 点击 = 开启一次全新的通用问答会话（等价于跳转 `/page/workspace/chats/new`）。
|
|
||||||
|
|
||||||
#### ② 常用智能体（最多 3 个 + 更多）
|
|
||||||
- 展示「常用智能体」卡片/列表项，**最多 3 个**。
|
|
||||||
- 数据来源采用**级联兜底**逻辑（取到即用，不足再降级）：
|
|
||||||
1. 若用户有**置顶智能体**（`is_pinned = true`）→ 展示置顶的；
|
|
||||||
2. 否则展示**用户自己的智能体**（`scope = "mine"`）；
|
|
||||||
3. 仍没有 → 展示**默认广场智能体**（`scope = "square"` / `builtin`，即广场默认推荐）。
|
|
||||||
- 三者按上述优先级取，最终最多取 3 个。
|
|
||||||
- 下方显示「**更多**」入口。
|
|
||||||
- 点击某个常用智能体 → 进入该智能体的对话（待确认：是否为该智能体新建会话）。
|
|
||||||
|
|
||||||
#### ③ 聊天记录（最多 10 条 + 更多）
|
|
||||||
- 展示用户的问答聊天记录，**最多 10 条**（沿用现有 `useThreads` + 过滤规则）。
|
|
||||||
- 下方显示「**更多**」入口。
|
|
||||||
- 点击「更多」→ **跳转到问答记录页面**（完整聊天记录列表页）。
|
|
||||||
|
|
||||||
### 1.3
|
|
||||||
- 「常用智能体」点击后「打开该智能体主页」
|
|
||||||
- 「常用智能体」的「更多」跳转目标页 智能体管理 `/page/strategy/agents`。
|
|
||||||
- 「聊天记录」的「问答记录页面」具体路由http://localhost:5173/#/page/workspace/chats。
|
|
||||||
- 级联兜底是（置顶组够 3 个就完全不展示我的/广场）如果不够「补足到 3 个
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 多智能体会商 — 左侧栏重做
|
|
||||||
|
|
||||||
**页面**：`/page/strategy/qa/multi-agent-roundtable`（`RoundtablePlanningPage`）
|
|
||||||
|
|
||||||
### 2.1 现状
|
|
||||||
圆桌会商页已有业务链选择、分析草稿等能力（`roundtable-planning/api/chains.ts`、`hooks/useRoundtableDrafts.ts`）。需求要求**左栏整体重做**。
|
|
||||||
|
|
||||||
### 2.2 目标布局（自上而下）
|
|
||||||
|
|
||||||
#### ① 顶部：业务链（公共，前 3 个）
|
|
||||||
- 顶部展示**业务链**，仅取**公共**链条（`listChains("public")`，即所有已发布 `is_public = true` 的链条）。
|
|
||||||
- 仅展示**前 3 个**。
|
|
||||||
- 点击某条业务链 → 以该业务链启动一次会商（沿用现有"会商自动串联圆桌"流程，见记忆 `business-chain-mapping`）。
|
|
||||||
|
|
||||||
#### ② 下方：分析记录
|
|
||||||
- 业务链下方展示「**分析记录**」列表。
|
|
||||||
- 数据来源：圆桌分析草稿/历史（`useRoundtableDrafts` / `listDrafts`）。
|
|
||||||
- 点击某条分析记录 → 打开对应的历史会商分析。
|
|
||||||
|
|
||||||
### 2.3 待确认
|
|
||||||
- 「业务链」是否需要「更多」入口跳转到业务链条配置页（`/page/strategy/business-chains`）？需求未提及，默认仅展示前 3 个、无更多。 需要更多入口
|
|
||||||
- 「分析记录」是否需要分页/「更多」？需求未提及，默认展示全部或合理上限 分析记录默认全部吧。
|
|
||||||
- 公共业务链「前 3 个」的排序口径（创建时间倒序？已有 `listChains` 默认 newest first） 按照现在默认的显示来吧，然后要支持用户单选，如果用户选择后，点击进入多智能体研讨按钮时，直接按照选择的业务链进去执行，如果用户取消勾选，或没有勾选就还是打开弹窗。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. zzJC支持 — 左侧栏改造（按类型聚合智能体）
|
|
||||||
|
|
||||||
**页面**：`/page/strategy/agents/6bf/chats/new`（当前为单一智能体 `6bf` 的对话页）
|
|
||||||
|
|
||||||
### 3.1 现状
|
|
||||||
当前 zzJC支持直接进入某个固定智能体（id=`6bf`）的对话页（`AgentChatPage`）。
|
|
||||||
|
|
||||||
### 3.2 目标布局
|
|
||||||
- **左栏按「类型」分组**，展示该类型下的智能体列表（"类型"待确认，推测为智能体 `tags` / 分类）。
|
|
||||||
- 智能体分组**下方**展示**聊天记录**。
|
|
||||||
- 左栏**宽度与通用问答（需求 1）保持一致**（"左侧是问答宽"）。
|
|
||||||
|
|
||||||
### 3.3 Admin 设置入口
|
|
||||||
- 在 **admin 账号权限下**，页面**右侧顶部显示「设置」图标按钮**（齿轮图标）。
|
|
||||||
- 点击设置按钮 → 打开设置面板，可对该模块进行配置。
|
|
||||||
- 非 admin 账号不显示设置按钮（沿用 `sidebar-menu.ts` 中 `adminOnly` 同款角色判断）。
|
|
||||||
|
|
||||||
### 3.4 待确认
|
|
||||||
- 「类型」的确切含义：是智能体的 `tags`，还是 zzJC 业务自定义的一组分类？
|
|
||||||
- 现 zzJC 入口是单个智能体 `6bf`；改为「按类型展示多个智能体」后，**进入该菜单时默认落地页是什么**（智能体列表？还是仍默认进 `6bf` 对话）？是否需要新建一个 zzJC 聚合页。
|
|
||||||
- Admin「设置」具体可配置项：配置「该模块纳入哪些类型/哪些智能体」？还是其他（如默认智能体、欢迎语）？需明确设置项清单。
|
|
||||||
- 「聊天记录」过滤范围：仅 zzJC 相关会话，还是全部会话？
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. zzXD应用 — 左侧栏改造
|
|
||||||
|
|
||||||
**页面**：`/page/strategy/agents/10d69686718349688e58a8790cb61024/chats/new`
|
|
||||||
|
|
||||||
### 4.1 需求
|
|
||||||
**与需求 3（zzJC支持）完全一致**：
|
|
||||||
- 左栏按类型展示该类型下的智能体 + 下方聊天记录；
|
|
||||||
- 左栏宽度同通用问答；
|
|
||||||
- admin 账号下右侧顶部显示设置图标按钮，可设置。
|
|
||||||
|
|
||||||
### 4.2 待确认
|
|
||||||
- 同需求 3 全部待确认项。
|
|
||||||
- zzXD 与 zzJC 是否共用同一套「按类型 + 设置」组件（仅数据源/默认智能体不同），还是各自独立配置？建议**抽象为同一可复用组件**，通过参数区分。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5. 课题研究 — 左侧栏改造（研究模板 + 笔记本）
|
|
||||||
|
|
||||||
**页面**：`/page/canvas/ai-writing`（`AIWritingPage`）
|
|
||||||
|
|
||||||
### 5.1 目标布局（自上而下）
|
|
||||||
|
|
||||||
#### ① 上半部分：研究模板
|
|
||||||
- 左栏上半部分展示「**研究模板**」。
|
|
||||||
- 研究模板 = **原来的「文章类型」**（`open-canvas/hooks/useArticleTypes.ts` 的 `articleTypes`，即 AI 写作表单里的「文章类型」选择项）。
|
|
||||||
- 点击某个研究模板 → 以该模板/文章类型发起课题研究（沿用现有 `articleType` 设置逻辑）。
|
|
||||||
|
|
||||||
#### ② 下半部分：笔记本
|
|
||||||
- 左栏下半部分展示「**笔记本**」。
|
|
||||||
- 笔记本内容 = **「简洁模式」左侧菜单下方展示的笔记本内容**（`useStudioNotebooks`，即 `workspace-nav-studio.tsx` 中渲染的 studio notebooks 列表）。
|
|
||||||
- 点击某个笔记本 → 打开该笔记本（沿用现有 `/page/workspace/studio/notebooks/{id}` 行为，或作为课题研究的素材来源 `materialSource = 'notebook'`，待确认）。
|
|
||||||
|
|
||||||
> 备注：草稿原文写作「简介模式」，结合代码应为「**简洁模式**」（`appearance-settings-page.tsx` 中的全局界面模式：全量 / 简洁；简洁模式下笔记本在左栏菜单展示）。
|
|
||||||
|
|
||||||
### 5.2 待确认
|
|
||||||
- 「研究模板」点击行为：仅预填表单 `articleType`，还是直接开始生成？
|
|
||||||
- 「笔记本」点击行为：跳转笔记本详情页，还是将笔记本设为当前课题研究的素材来源（`materialSource='notebook'`）？
|
|
||||||
- 上/下两部分是否各自可折叠、是否需要「更多」入口与数量上限？需求未提及。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 6. 整体待确认与建议
|
|
||||||
|
|
||||||
1. **复用性**：需求 3 / 4（zzJC / zzXD）布局完全相同，建议实现为同一套「按类型分组 + 聊天记录 + admin 设置」可复用组件，通过配置区分模块。
|
|
||||||
2. **左栏宽度统一**：需求 1 / 3 / 4 都要求"问答宽"，建议统一左栏宽度常量，避免各页面各写一套。
|
|
||||||
3. **「更多」目标页**：需求 1 涉及「智能体更多」「聊天记录更多→问答记录页」两个跳转目标需先确定路由是否已存在。
|
|
||||||
4. **Admin 设置项清单**：需求 3 / 4 的设置面板具体能配置什么，需要产品给出字段清单后才能落地。
|
|
||||||
5. **入口语义变更**：需求 3 / 4 把原「单一智能体对话」入口改为「按类型聚合」，菜单 `path` 与默认落地页可能需要调整，需同步确认。
|
|
||||||
@@ -1,156 +0,0 @@
|
|||||||
# DeerFlow 上游升级对比与回合建议
|
|
||||||
|
|
||||||
> 对比对象：`bytedance/deer-flow`（上游，HEAD `9f3be2a` @ 2026-05-30）vs 本仓库 fork。
|
|
||||||
> 生成日期：2026-05-31。
|
|
||||||
> 说明：按用户要求，**多语言 (i18n)** 与 **播客 / TTS (podcast)** 不在本次升级范围内，已剔除。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 0. 背景与对比结论
|
|
||||||
|
|
||||||
| 项 | 结论 |
|
|
||||||
|---|---|
|
|
||||||
| fork 切出时间 | **≈ 2026-05-12**（与目录名 `offline-backend-20260512` 吻合） |
|
|
||||||
| 上游当前 HEAD | `9f3be2a` @ 2026-05-30，完整历史 2186 提交 |
|
|
||||||
| fork 之后上游新增 | **95 个提交**（7 feat / 1 perf / 60 fix / 依赖与文档若干） |
|
|
||||||
| 后端核心框架 `packages/harness/deerflow/` | **高度同源、目录结构完全一致**，差异主要来自这 95 个提交 |
|
|
||||||
| 前端 | 技术栈已分道扬镳：上游仍是 **Next.js**，本仓库已迁到 **Vite + React Router**，文件几乎全不同 |
|
|
||||||
|
|
||||||
「升级」分两类，本文都覆盖：
|
|
||||||
- **A 类**：fork 之后上游真正新增的（95 提交）——同源、可 cherry-pick，**优先回合**。
|
|
||||||
- **B 类**：fork 时就裁掉/换了路线、上游一直保留的能力——成本高、按业务取舍。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 后端升级（A 类：fork 后上游新增）
|
|
||||||
|
|
||||||
### 1.1 新能力（feat / perf）
|
|
||||||
|
|
||||||
| 日期 | 升级 | 提交 | 说明 |
|
|
||||||
|---|---|---|---|
|
|
||||||
| 05-29 | ToolOutputBudgetMiddleware | #3303 | 给超大工具输出做预算保护，防止单个结果撑爆上下文 |
|
|
||||||
| 05-28 | MiMo reasoning 支持 | #3298 | 兼容小米 MiMo 模型思维链回传 |
|
|
||||||
| 05-21 | 链路追踪命名优化 | #3101 | 图名改 `lead_agent`、用自定义 agent 名作 run_name |
|
|
||||||
| 05-21 | 循环检测延迟告警 | #2752 | 警告延迟注入，减少对正常多轮对话的误打断 |
|
|
||||||
| 05-20 | Sandbox 下载文件接口 | #3038 | 可把沙箱内产物取回 |
|
|
||||||
| 05-15 | Discord 渠道增强 | #2842 | 仅@提及、thread 路由、typing 指示 |
|
|
||||||
| 05-13 | 子代理 token 用量流式上报 | #2882 | subagent 消耗实时汇总到 header，利于展示/计费 |
|
|
||||||
| 05-12 | perf：线程元数据过滤下推 SQL | #2865 | 线程列表筛选走 SQL，性能提升 |
|
|
||||||
|
|
||||||
能力性增强（fix 前缀实为增强）：MCP 跨调用持久化会话、支持有状态 server（#3089 / #3203）；摘要触发阈值调优（#3174）。
|
|
||||||
|
|
||||||
### 1.2 重要稳定性修复
|
|
||||||
|
|
||||||
| 主题 | 提交 | 价值 |
|
|
||||||
|---|---|---|
|
|
||||||
| 摘要压缩后保留消息 | #3280 | 数据正确性关键 |
|
|
||||||
| 重启后从持久化恢复 runs / interrupted 状态 | #2932(破坏性)、#2989、#3152、#3155 | 网关重启不丢运行 |
|
|
||||||
| JWT secret 持久化、多 worker 共享网关 token | #2933、#3184 | 重启/多进程登录态不失效 |
|
|
||||||
| memory 更新按 agent 隔离 + 包裹 JSON 解析健壮性 | #2941、#3252 | 记忆串号/解析修复 |
|
|
||||||
| MCP 配置接口脱敏 | #2667 | 防密钥泄露 |
|
|
||||||
| 阻塞 IO 移出事件循环 | #3311、#2822（+检测门禁 #3229） | 消除事件循环阻塞 |
|
|
||||||
|
|
||||||
### 1.3 依赖升级
|
|
||||||
- Python：`langsmith 0.7.36 → 0.8.0`、`idna 3.13 → 3.15`
|
|
||||||
|
|
||||||
### 1.4 怎么做（回合 A 类后端升级）
|
|
||||||
|
|
||||||
> 前提：本仓库 `packages/harness/deerflow/` 与上游高度同源，cherry-pick 冲突面小。
|
|
||||||
|
|
||||||
1. **加上游为远程并拉取历史**（在后端所在 git 仓库根执行）：
|
|
||||||
```bash
|
|
||||||
git remote add upstream https://github.com/bytedance/deer-flow.git
|
|
||||||
git fetch upstream
|
|
||||||
```
|
|
||||||
2. **逐条预览某个提交的改动范围**：
|
|
||||||
```bash
|
|
||||||
git show <commit_hash> --stat
|
|
||||||
git show <commit_hash> -- backend/packages/harness/deerflow/...
|
|
||||||
```
|
|
||||||
3. **单条回合**（推荐用 `-x` 记录来源；如路径前缀不一致需先确认）：
|
|
||||||
```bash
|
|
||||||
git cherry-pick -x <commit_hash>
|
|
||||||
# 冲突时：解决后
|
|
||||||
git cherry-pick --continue
|
|
||||||
```
|
|
||||||
> 注意：上游后端在 `backend/` 子目录，本仓库后端在 `offline-backend-20260512/backend/`。若 cherry-pick 因路径不匹配失败，改用按文件打补丁：
|
|
||||||
> ```bash
|
|
||||||
> git show <hash> -- backend/<path> | git apply --directory=offline-backend-20260512/backend -p2 -3
|
|
||||||
> ```
|
|
||||||
4. **回合后必跑校验**（在 `offline-backend-20260512/backend/`）：
|
|
||||||
```bash
|
|
||||||
make test # PYTHONPATH=. uv run pytest tests/ -v
|
|
||||||
make lint
|
|
||||||
```
|
|
||||||
重点确认 `tests/test_harness_boundary.py`（harness→app 防火墙）与中间件链顺序未被破坏。
|
|
||||||
5. **依赖升级**：同步上游 `pyproject.toml` 对应行后执行 `uv lock && make install`；离线环境需同步更新 `requirements-offline.txt` / `wheelhouse`。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 前端升级（B 类：上游有、本仓库缺）
|
|
||||||
|
|
||||||
> 已剔除多语言、播客。下表为关键词核验结果（本仓库 vs 上游命中文件数）。
|
|
||||||
|
|
||||||
| 功能 | 本仓库 | 上游 | 状态 |
|
|
||||||
|---|---|---|---|
|
|
||||||
| Prose 文本润色 | 0 | 8 | 上游独有 |
|
|
||||||
| Replay 研究回放 | 2 | 29 | 上游完整，本仓库近乎无 |
|
|
||||||
| PPT / PPTX 生成 | 2 | 14 | 上游完整，本仓库近乎无 |
|
|
||||||
| Landing 落地页 | 0 | 11 | 上游独有（营销/介绍页，按需） |
|
|
||||||
| 静态 demo 模式 | 无 | #3170 | fork 后上游新增 |
|
|
||||||
|
|
||||||
前端体验类修复（可参考实现）：流式渲染、消息去重、历史消息 Mermaid 预览、新建会话即时入侧栏。
|
|
||||||
前端依赖升级：`brace-expansion 1.x → 5.0.5`（安全）、`uuid 10 → 14`。
|
|
||||||
|
|
||||||
### 2.1 怎么做（前端能力移植）
|
|
||||||
|
|
||||||
> 前端技术栈已不同（Next.js → Vite + React Router），**不能直接 cherry-pick**，需按"读上游实现 → 适配到本仓库"的方式重写。
|
|
||||||
|
|
||||||
通用步骤：
|
|
||||||
1. 在上游 `frontend/src/` 定位目标功能的页面/组件/hook 与对应的后端 API 调用。
|
|
||||||
2. 后端能力是否具备：Prose / PPT / Replay 依赖后端相应接口，先确认本仓库后端有无对应路由（多为 deep_research/skills 相关），**没有则前端无法独立完成**，需连带回合后端。
|
|
||||||
3. 适配差异点：
|
|
||||||
- 路由：上游 app router (`src/app/...`) → 本仓库 `src/pages/` + `PageRoutes.tsx` / `WorkspaceRoutes.tsx`。
|
|
||||||
- 导航 API：用本仓库 `src/shims/`（`next/link`、`next/navigation` 已 polyfill）。
|
|
||||||
- 数据流：沿用本仓库 TanStack Query + `@langchain/langgraph-sdk` 流式。
|
|
||||||
4. 验证：`pnpm typecheck` + `pnpm dev` 实测。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 推荐升级清单（按优先级）
|
|
||||||
|
|
||||||
### P0 — 强烈建议（低风险、高价值，A 类）
|
|
||||||
- **摘要压缩后保留消息 #3280** —— 数据正确性，直接影响长对话可用性。
|
|
||||||
- **重启后恢复 runs / interrupted #2932 #2989 #3152 #3155** —— 生产稳定性核心。
|
|
||||||
- **JWT secret 持久化 / 多 worker 共享 token #2933 #3184** —— 否则重启或多进程部署会掉登录态。
|
|
||||||
- **阻塞 IO 移出事件循环 #3311 #2822** —— 并发吞吐与响应延迟改善。
|
|
||||||
|
|
||||||
### P1 — 建议（实用增强）
|
|
||||||
- **ToolOutputBudgetMiddleware #3303** —— 防超大工具输出拖垮上下文，对 agent 稳定性有实际帮助。
|
|
||||||
- **MCP 持久化会话 / 有状态 server #3089 #3203** —— 若用到有状态 MCP server 则必需。
|
|
||||||
- **MCP 配置接口脱敏 #2667** —— 安全加固。
|
|
||||||
- **子代理 token 用量流式上报 #2882** —— 计费/可观测。
|
|
||||||
- **线程元数据过滤下推 SQL #2865（perf）** —— 列表性能。
|
|
||||||
|
|
||||||
### P2 — 按需（看是否用到对应模型/渠道）
|
|
||||||
- MiMo reasoning #3298（用小米模型才需要）
|
|
||||||
- Discord 渠道增强 #2842（用 Discord 才需要）
|
|
||||||
- Sandbox 下载文件接口 #3038、追踪命名 #3101、循环检测延迟告警 #2752
|
|
||||||
|
|
||||||
### 前端（按业务价值）
|
|
||||||
- **Replay 研究回放** —— 对"深研/写作"类产品体验提升明显，建议优先（需后端配合）。
|
|
||||||
- **Prose 文本润色** —— 与写作工作台契合，建议评估接入。
|
|
||||||
- **PPT 生成** —— 若有汇报/导出诉求再做。
|
|
||||||
- **Landing 落地页** —— 仅当面向外部用户时考虑。
|
|
||||||
|
|
||||||
### 暂不做
|
|
||||||
- 多语言 i18n（本次明确排除）
|
|
||||||
- 播客 / TTS（本次明确排除）
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. 建议执行节奏
|
|
||||||
1. 先做 **P0 后端 4 项** + 跑全量测试，单独提交一个"上游稳定性回合"分支。
|
|
||||||
2. 再做 **P1**，逐条 cherry-pick、逐条验证。
|
|
||||||
3. 前端 **Replay / Prose** 立项评估（确认后端依赖），单独排期重写适配。
|
|
||||||
4. 依赖升级随回合同步，离线包 (`wheelhouse` / `requirements-offline.txt`) 一并更新。
|
|
||||||
File diff suppressed because it is too large.
Load diff
@@ -1,514 +0,0 @@
|
|||||||
# 浅红色 UI 规范 · 一、基础样式
|
|
||||||
|
|
||||||
> 返回 [规范目录](README.md) | 本篇：色彩 · 字体 · 阴影 · 圆角 · 间距 · 语义状态色
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 色彩
|
|
||||||
|
|
||||||
### 1.1 标准色
|
|
||||||
|
|
||||||
色彩体系分为**主色**与**辅色**两大类。
|
|
||||||
|
|
||||||
- **主色**：渐红系（ZS-001）、渐蓝系（ZS-002），用于品牌表达与核心交互。
|
|
||||||
- **辅色**：渐橙系（FS-001）、渐绿系（FS-002）、渐青系（FS-003）、中性灰系（FS-004），用于状态提示、数据可视化与文字 / 背景 / 分割线。
|
|
||||||
|
|
||||||
每个色系按明度从浅到深编号（`-01` 最浅，数字越大越深），并附两种渐变色（`-14` 线性渐变、`-15` 径向渐变）。本主题为**浅色主题**：以白 / 浅灰作大面积背景，以深色作正文，红色为品牌强调主色。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 1.1.1 色系总览
|
|
||||||
|
|
||||||
| 类别 | 色系 | 用途定位 | 代码前缀 |
|
|
||||||
|------|------|----------|----------|
|
|
||||||
| 主色 | 渐红系 | 品牌主色、强调操作、警示与错误 | ZS-001 |
|
|
||||||
| 主色 | 渐蓝系 | 信息、链接、次级操作 | ZS-002 |
|
|
||||||
| 辅色 | 渐橙系 | 警告、进行中、提示标签 | FS-001 |
|
|
||||||
| 辅色 | 渐绿系 | 成功、在线、通过状态 | FS-002 |
|
|
||||||
| 辅色 | 渐青系 | 数据高亮、图表、辅助信息 | FS-003 |
|
|
||||||
| 辅色 | 中性灰系 | 背景、文字、图标、分割线 | FS-004 |
|
|
||||||
|
|
||||||
> 每个色系内：`-01 ~ -03` 为**浅色**（用于大面积底色）；`-04 ~ -09` 为**中亮色**（用于标签、图表、提示等）；`-10` 及以后为**深色**（用于小面积按钮、图标等）；`-14 / -15` 为渐变色（用于特殊装饰性小面积底色）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 1.1.2 主色 · 渐红系（ZS-001）
|
|
||||||
|
|
||||||
品牌主色系。用于主操作按钮、重要强调、错误与危险告警。
|
|
||||||
|
|
||||||
| 编号 | 色值 | 明度分组 | 说明 |
|
|
||||||
|------|------|----------|------|
|
|
||||||
| ZS-001 | `#CF1322` | 深色 | 品牌代表红（默认主色基准） |
|
|
||||||
| ZS-001-01 | `#FEFAFA` | 浅色 | 极浅红，大面积底色 |
|
|
||||||
| ZS-001-02 | `#FEF6F6` | 浅色 | 浅红底色 |
|
|
||||||
| ZS-001-03 | `#FEEDED` | 浅色 | 浅红底色 / 错误背景 |
|
|
||||||
| ZS-001-04 | `#FDDADC` | 中亮色 | — |
|
|
||||||
| ZS-001-05 | `#FCB5B9` | 中亮色 | — |
|
|
||||||
| ZS-001-06 | `#FA9196` | 中亮色 | — |
|
|
||||||
| ZS-001-07 | `#F86C73` | 中亮色 | 浅红 Tag / 图表 |
|
|
||||||
| ZS-001-08 | `#F74750` | 中亮色 | — |
|
|
||||||
| ZS-001-09 | `#F5222D` | 中亮色 | **标准红**，主按钮 / 图标 |
|
|
||||||
| ZS-001-10 | `#BC0D1E` | 深色 | 深红，Hover |
|
|
||||||
| ZS-001-11 | `#A8071A` | 深色 | 深红，Active / Press |
|
|
||||||
| ZS-001-12 | `#820014` | 深色 | 极深红 |
|
|
||||||
| ZS-001-13 | `#5C0011` | 深色 | 最深红 |
|
|
||||||
| ZS-001-14 | `#F5222D → #A8071A` | 线性渐变 | 装饰底色 |
|
|
||||||
| ZS-001-15 | `#F86C73 → #F5222D` | 径向渐变 | 装饰底色 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 1.1.3 主色 · 渐蓝系（ZS-002）
|
|
||||||
|
|
||||||
用于信息提示、链接、次级按钮与图表。
|
|
||||||
|
|
||||||
| 编号 | 色值 | 明度分组 | 说明 |
|
|
||||||
|------|------|----------|------|
|
|
||||||
| ZS-002 | `#0062D9` | 深色 | 蓝色代表色（基准） |
|
|
||||||
| ZS-002-01 | `#F9FCFF` | 浅色 | 极浅蓝，大面积底色 |
|
|
||||||
| ZS-002-02 | `#F4F9FF` | 浅色 | 浅蓝底色 |
|
|
||||||
| ZS-002-03 | `#EAF4FF` | 浅色 | 浅蓝底色 / 信息背景 |
|
|
||||||
| ZS-002-04 | `#D4E9FF` | 中亮色 | — |
|
|
||||||
| ZS-002-05 | `#AAD2FF` | 中亮色 | — |
|
|
||||||
| ZS-002-06 | `#80BCFF` | 中亮色 | — |
|
|
||||||
| ZS-002-07 | `#55A6FE` | 中亮色 | 浅蓝 Tag / 图表 |
|
|
||||||
| ZS-002-08 | `#2B8FFE` | 中亮色 | — |
|
|
||||||
| ZS-002-09 | `#0079FE` | 中亮色 | **标准蓝**，链接 / 信息主色 |
|
|
||||||
| ZS-002-10 | `#0056C6` | 深色 | 深蓝，Hover |
|
|
||||||
| ZS-002-11 | `#004AB3` | 深色 | 深蓝，Active |
|
|
||||||
| ZS-002-12 | `#00368C` | 深色 | 极深蓝 |
|
|
||||||
| ZS-002-13 | `#002466` | 深色 | 最深蓝 |
|
|
||||||
| ZS-002-14 | `#0079FE → #004AB3` | 线性渐变 | 装饰底色 |
|
|
||||||
| ZS-002-15 | `#55A6FE → #0079FE` | 径向渐变 | 装饰底色 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 1.1.4 辅色 · 渐橙系（FS-001）
|
|
||||||
|
|
||||||
用于警告、进行中、待处理等中性偏提醒状态。
|
|
||||||
|
|
||||||
| 编号 | 色值 | 明度分组 | 说明 |
|
|
||||||
|------|------|----------|------|
|
|
||||||
| FS-001 | `#D97B00` | 深色 | 橙色代表色（基准） |
|
|
||||||
| FS-001-01 | `#FFFCF9` | 浅色 | 极浅橙，大面积底色 |
|
|
||||||
| FS-001-02 | `#FFFAF4` | 浅色 | 浅橙底色 |
|
|
||||||
| FS-001-03 | `#FFF6EA` | 浅色 | 浅橙底色 / 警告背景 |
|
|
||||||
| FS-001-04 | `#FFEED4` | 中亮色 | — |
|
|
||||||
| FS-001-05 | `#FFDDAA` | 中亮色 | — |
|
|
||||||
| FS-001-06 | `#FFCC80` | 中亮色 | — |
|
|
||||||
| FS-001-07 | `#FFBB55` | 中亮色 | 浅橙 Tag / 图表 |
|
|
||||||
| FS-001-08 | `#FFAA2B` | 中亮色 | — |
|
|
||||||
| FS-001-09 | `#FF9900` | 中亮色 | **标准橙**，警告主色 |
|
|
||||||
| FS-001-10 | `#C66D00` | 深色 | 深橙，Hover |
|
|
||||||
| FS-001-11 | `#B35F00` | 深色 | 深橙，Active |
|
|
||||||
| FS-001-12 | `#8C4600` | 深色 | 极深橙 |
|
|
||||||
| FS-001-13 | `#663000` | 深色 | 最深橙 |
|
|
||||||
| FS-001-14 | `#FF9900 → #B35F00` | 线性渐变 | 装饰底色 |
|
|
||||||
| FS-001-15 | `#FFBB55 → #FF9900` | 径向渐变 | 装饰底色 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 1.1.5 辅色 · 渐绿系（FS-002）
|
|
||||||
|
|
||||||
用于成功、在线、通过、已完成等正向状态。
|
|
||||||
|
|
||||||
| 编号 | 色值 | 明度分组 | 说明 |
|
|
||||||
|------|------|----------|------|
|
|
||||||
| FS-002 | `#1EB07F` | 深色 | 绿色代表色（基准） |
|
|
||||||
| FS-002-01 | `#FAFEFD` | 浅色 | 极浅绿，大面积底色 |
|
|
||||||
| FS-002-02 | `#F6FDFB` | 浅色 | 浅绿底色 |
|
|
||||||
| FS-002-03 | `#EEFCF7` | 浅色 | 浅绿底色 / 成功背景 |
|
|
||||||
| FS-002-04 | `#DCF8EE` | 中亮色 | — |
|
|
||||||
| FS-002-05 | `#BAF1DD` | 中亮色 | — |
|
|
||||||
| FS-002-06 | `#97EBCD` | 中亮色 | — |
|
|
||||||
| FS-002-07 | `#74E4BC` | 中亮色 | 浅绿 Tag / 图表 |
|
|
||||||
| FS-002-08 | `#52DDAB` | 中亮色 | — |
|
|
||||||
| FS-002-09 | `#2FD69A` | 中亮色 | **标准绿**，成功主色 |
|
|
||||||
| FS-002-10 | `#189D72` | 深色 | 深绿，Hover |
|
|
||||||
| FS-002-11 | `#118A65` | 深色 | 深绿，Active |
|
|
||||||
| FS-002-12 | `#07634B` | 深色 | 极深绿 |
|
|
||||||
| FS-002-13 | `#043D30` | 深色 | 最深绿 |
|
|
||||||
| FS-002-14 | `#2FD69A → #118A65` | 线性渐变 | 装饰底色 |
|
|
||||||
| FS-002-15 | `#74E4BC → #2FD69A` | 径向渐变 | 装饰底色 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 1.1.6 辅色 · 渐青系（FS-003）
|
|
||||||
|
|
||||||
用于数据高亮、图表配色、辅助信息标识。
|
|
||||||
|
|
||||||
| 编号 | 色值 | 明度分组 | 说明 |
|
|
||||||
|------|------|----------|------|
|
|
||||||
| FS-003 | `#2F9ACC` | 深色 | 青色代表色（基准） |
|
|
||||||
| FS-003-01 | `#FBFDFE` | 浅色 | 极浅青，大面积底色 |
|
|
||||||
| FS-003-02 | `#F7FCFE` | 浅色 | 浅青底色 |
|
|
||||||
| FS-003-03 | `#EFFAFE` | 浅色 | 浅青底色 |
|
|
||||||
| FS-003-04 | `#E0F5FD` | 中亮色 | — |
|
|
||||||
| FS-003-05 | `#C1EBFB` | 中亮色 | — |
|
|
||||||
| FS-003-06 | `#A2E1F9` | 中亮色 | — |
|
|
||||||
| FS-003-07 | `#83D7F7` | 中亮色 | 浅青 Tag / 图表 |
|
|
||||||
| FS-003-08 | `#64CDF5` | 中亮色 | — |
|
|
||||||
| FS-003-09 | `#45C3F3` | 中亮色 | **标准青**，数据高亮主色 |
|
|
||||||
| FS-003-10 | `#2788B9` | 深色 | 深青，Hover |
|
|
||||||
| FS-003-11 | `#1E76A6` | 深色 | 深青，Active |
|
|
||||||
| FS-003-12 | `#115580` | 深色 | 极深青 |
|
|
||||||
| FS-003-13 | `#0B3959` | 深色 | 最深青 |
|
|
||||||
| FS-003-14 | `#45C3F3 → #1E76A6` | 线性渐变 | 装饰底色 |
|
|
||||||
| FS-003-15 | `#83D7F7 → #45C3F3` | 径向渐变 | 装饰底色 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 1.1.7 辅色 · 中性灰系（FS-004）
|
|
||||||
|
|
||||||
承载页面背景、正文、备注文字、图标与分割线。浅色主题的核心承载色系。
|
|
||||||
|
|
||||||
| 编号 | 色值 | 明度分组 | 说明 |
|
|
||||||
|------|------|----------|------|
|
|
||||||
| FS-004 | `#222222` | 深色 | 中性代表色（基准） |
|
|
||||||
| FS-004-01 | `#FFFFFF` | 浅色 | 纯白，页面 / 容器背景、白色文字 |
|
|
||||||
| FS-004-02 | `#FAFAFA` | 浅色 | 浅灰背景 |
|
|
||||||
| FS-004-03 | `#F5F5F5` | 浅色 | 浅灰背景 / 分割区底 |
|
|
||||||
| FS-004-04 | `#E8E8E8` | 中亮色 | 分割线 / 边框 |
|
|
||||||
| FS-004-05 | `#DBDBDB` | 中亮色 | 边框 / 禁用底 |
|
|
||||||
| FS-004-06 | `#C1C1C1` | 中亮色 | 禁用文字 / 占位符 |
|
|
||||||
| FS-004-07 | `#A6A6A6` | 中亮色 | 备注文字 / 图标 |
|
|
||||||
| FS-004-08 | `#7F7F7F` | 中亮色 | 次级文字 |
|
|
||||||
| FS-004-09 | `#575757` | 中亮色 | 次要正文 |
|
|
||||||
| FS-004-10 | `#3D3D3D` | 深色 | 正文加强 |
|
|
||||||
|
|
||||||
> 灰系用途分层：`01 ~ 03` 背景 / 白色文字 / 分割线；`04 ~ 09` 备注文字及图标；`10` 与基准 `#222222` 用于正文。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 1.1.8 功能色（主色 / 字体色 / 辅色 / 背景色）
|
|
||||||
|
|
||||||
从标准色系中提取，用于具体 UI 角色指定。
|
|
||||||
|
|
||||||
| 角色 | 色值 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 主色（Primary） | `#F5222D` | ZS-001-09 |
|
|
||||||
| 主色 Hover | `#CF1322` | ZS-001 |
|
|
||||||
| 主色 Active | `#A8071A` | ZS-001-11 |
|
|
||||||
| 信息 / 链接色 | `#0079FE` | ZS-002-09 |
|
|
||||||
| 成功色 | `#2FD69A` | FS-002-09 |
|
|
||||||
| 警告色 | `#FF9900` | FS-001-09 |
|
|
||||||
| 错误色 | `#F5222D` | ZS-001-09 |
|
|
||||||
| 正文字体色 | `#222222` | FS-004 |
|
|
||||||
| 次级字体色 | `#575757` | FS-004-09 |
|
|
||||||
| 备注 / 占位字体色 | `#A6A6A6` | FS-004-07 |
|
|
||||||
| 禁用字体色 | `#C1C1C1` | FS-004-06 |
|
|
||||||
| 页面背景色 | `#FAFAFA` | FS-004-02 |
|
|
||||||
| 容器背景色 | `#FFFFFF` | FS-004-01 |
|
|
||||||
| 分割线 | `#E8E8E8` | FS-004-04 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 1.1.9 小面积装饰色
|
|
||||||
|
|
||||||
用于图标点缀、徽标、少量强调，不用于大面积背景。
|
|
||||||
|
|
||||||
| 色值 | 来源 | 说明 |
|
|
||||||
|------|------|------|
|
|
||||||
| `#F5222D` | ZS-001-09 | 红色，危险 / 品牌徽标 |
|
|
||||||
| `#0079FE` | ZS-002-09 | 蓝色，信息点缀 |
|
|
||||||
| `#FF9900` | FS-001-09 | 橙色，提醒点缀 |
|
|
||||||
| `#2FD69A` | FS-002-09 | 绿色，在线点 |
|
|
||||||
| `#45C3F3` | FS-003-09 | 青色，数据点缀 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 1.1.10 图表配色
|
|
||||||
|
|
||||||
> **以 §25.1 图表通用色序为准**。本小节给出的是从主 / 辅色提取的强调型色序，适用于需要突出对比的少量序列；柱状 / 饼 / 环 / 面积等多分类图表的标准柔和色序见 [05-图表](05-图表.md)（§25）。
|
|
||||||
|
|
||||||
**通用图表色序**（面积较大，如柱状图、折线图、饼图）：
|
|
||||||
|
|
||||||
| 序号 | 色值 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 1 | `#F5222D` | ZS-001-09 |
|
|
||||||
| 2 | `#0079FE` | ZS-002-09 |
|
|
||||||
| 3 | `#FF9900` | FS-001-09 |
|
|
||||||
| 4 | `#2FD69A` | FS-002-09 |
|
|
||||||
| 5 | `#45C3F3` | FS-003-09 |
|
|
||||||
| 6 | `#FA9196` | ZS-001-06 |
|
|
||||||
| 7 | `#55A6FE` | ZS-002-07 |
|
|
||||||
| 8 | `#FFBB55` | FS-001-07 |
|
|
||||||
|
|
||||||
**小面积图表色序**（面积较小，如散点、小徽章、迷你图）：
|
|
||||||
|
|
||||||
| 序号 | 色值 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 1 | `#F86C73` | ZS-001-07 |
|
|
||||||
| 2 | `#55A6FE` | ZS-002-07 |
|
|
||||||
| 3 | `#74E4BC` | FS-002-07 |
|
|
||||||
| 4 | `#FFBB55` | FS-001-07 |
|
|
||||||
| 5 | `#83D7F7` | FS-003-07 |
|
|
||||||
| 6 | `#A6A6A6` | FS-004-07 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
#### 1.1.11 CSS Token 建议
|
|
||||||
|
|
||||||
```css
|
|
||||||
:root {
|
|
||||||
/* 主色 · 渐红系 ZS-001 */
|
|
||||||
--zs-001: #CF1322;
|
|
||||||
--zs-001-01: #FEFAFA; --zs-001-02: #FEF6F6; --zs-001-03: #FEEDED;
|
|
||||||
--zs-001-04: #FDDADC; --zs-001-05: #FCB5B9; --zs-001-06: #FA9196;
|
|
||||||
--zs-001-07: #F86C73; --zs-001-08: #F74750; --zs-001-09: #F5222D;
|
|
||||||
--zs-001-10: #BC0D1E; --zs-001-11: #A8071A; --zs-001-12: #820014;
|
|
||||||
--zs-001-13: #5C0011;
|
|
||||||
|
|
||||||
/* 主色 · 渐蓝系 ZS-002 */
|
|
||||||
--zs-002: #0062D9;
|
|
||||||
--zs-002-01: #F9FCFF; --zs-002-02: #F4F9FF; --zs-002-03: #EAF4FF;
|
|
||||||
--zs-002-04: #D4E9FF; --zs-002-05: #AAD2FF; --zs-002-06: #80BCFF;
|
|
||||||
--zs-002-07: #55A6FE; --zs-002-08: #2B8FFE; --zs-002-09: #0079FE;
|
|
||||||
--zs-002-10: #0056C6; --zs-002-11: #004AB3; --zs-002-12: #00368C;
|
|
||||||
--zs-002-13: #002466;
|
|
||||||
|
|
||||||
/* 辅色 · 渐橙系 FS-001 */
|
|
||||||
--fs-001: #D97B00;
|
|
||||||
--fs-001-01: #FFFCF9; --fs-001-02: #FFFAF4; --fs-001-03: #FFF6EA;
|
|
||||||
--fs-001-04: #FFEED4; --fs-001-05: #FFDDAA; --fs-001-06: #FFCC80;
|
|
||||||
--fs-001-07: #FFBB55; --fs-001-08: #FFAA2B; --fs-001-09: #FF9900;
|
|
||||||
--fs-001-10: #C66D00; --fs-001-11: #B35F00; --fs-001-12: #8C4600;
|
|
||||||
--fs-001-13: #663000;
|
|
||||||
|
|
||||||
/* 辅色 · 渐绿系 FS-002 */
|
|
||||||
--fs-002: #1EB07F;
|
|
||||||
--fs-002-01: #FAFEFD; --fs-002-02: #F6FDFB; --fs-002-03: #EEFCF7;
|
|
||||||
--fs-002-04: #DCF8EE; --fs-002-05: #BAF1DD; --fs-002-06: #97EBCD;
|
|
||||||
--fs-002-07: #74E4BC; --fs-002-08: #52DDAB; --fs-002-09: #2FD69A;
|
|
||||||
--fs-002-10: #189D72; --fs-002-11: #118A65; --fs-002-12: #07634B;
|
|
||||||
--fs-002-13: #043D30;
|
|
||||||
|
|
||||||
/* 辅色 · 渐青系 FS-003 */
|
|
||||||
--fs-003: #2F9ACC;
|
|
||||||
--fs-003-01: #FBFDFE; --fs-003-02: #F7FCFE; --fs-003-03: #EFFAFE;
|
|
||||||
--fs-003-04: #E0F5FD; --fs-003-05: #C1EBFB; --fs-003-06: #A2E1F9;
|
|
||||||
--fs-003-07: #83D7F7; --fs-003-08: #64CDF5; --fs-003-09: #45C3F3;
|
|
||||||
--fs-003-10: #2788B9; --fs-003-11: #1E76A6; --fs-003-12: #115580;
|
|
||||||
--fs-003-13: #0B3959;
|
|
||||||
|
|
||||||
/* 辅色 · 中性灰系 FS-004 */
|
|
||||||
--fs-004: #222222;
|
|
||||||
--fs-004-01: #FFFFFF; --fs-004-02: #FAFAFA; --fs-004-03: #F5F5F5;
|
|
||||||
--fs-004-04: #E8E8E8; --fs-004-05: #DBDBDB; --fs-004-06: #C1C1C1;
|
|
||||||
--fs-004-07: #A6A6A6; --fs-004-08: #7F7F7F; --fs-004-09: #575757;
|
|
||||||
--fs-004-10: #3D3D3D;
|
|
||||||
|
|
||||||
/* 功能色（语义别名） */
|
|
||||||
--color-primary: var(--zs-001-09); /* #F5222D */
|
|
||||||
--color-primary-hover: var(--zs-001); /* #CF1322 */
|
|
||||||
--color-primary-active: var(--zs-001-11); /* #A8071A */
|
|
||||||
--color-link: var(--zs-002-09); /* #0079FE */
|
|
||||||
--color-success: var(--fs-002-09); /* #2FD69A */
|
|
||||||
--color-warning: var(--fs-001-09); /* #FF9900 */
|
|
||||||
--color-error: var(--zs-001-09); /* #F5222D */
|
|
||||||
--color-text: var(--fs-004); /* #222222 */
|
|
||||||
--color-text-secondary: var(--fs-004-09); /* #575757 */
|
|
||||||
--color-text-tertiary: var(--fs-004-07); /* #A6A6A6 */
|
|
||||||
--color-text-disabled: var(--fs-004-06); /* #C1C1C1 */
|
|
||||||
--color-bg-page: var(--fs-004-02); /* #FAFAFA */
|
|
||||||
--color-bg-container: var(--fs-004-01); /* #FFFFFF */
|
|
||||||
--color-border: var(--fs-004-04); /* #E8E8E8 */
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 字体
|
|
||||||
|
|
||||||
字体规范分**大屏页面**与**后台系统**两套，分别对应可视化大屏与管理后台两类场景。
|
|
||||||
|
|
||||||
### 2.1 大屏页面字体规范
|
|
||||||
|
|
||||||
#### 2.1.1 中文字体：Noto Sans S Chinese
|
|
||||||
|
|
||||||
| 样式 | 使用场景 |
|
|
||||||
|------|----------|
|
|
||||||
| 24px Bold | 一级标题 |
|
|
||||||
| 24px Medium | 次要一级标题 |
|
|
||||||
| 22px Medium | 二级标题 |
|
|
||||||
| 22px Regular | 正文 |
|
|
||||||
| 20px Regular | 排版空间有限的正文 |
|
|
||||||
|
|
||||||
#### 2.1.2 数字字体：D-DIN
|
|
||||||
|
|
||||||
| 样式 | 使用场景 |
|
|
||||||
|------|----------|
|
|
||||||
| 32px Bold | 重要数据展示 |
|
|
||||||
| 32px Regular | 普通数据展示 |
|
|
||||||
| 26px Bold | 常规数据展示 |
|
|
||||||
| 26px Regular | 常规数据展示 |
|
|
||||||
|
|
||||||
#### 2.1.3 特殊数字：DS-Digital
|
|
||||||
|
|
||||||
| 样式 | 使用场景 |
|
|
||||||
|------|----------|
|
|
||||||
| 50px Bold | 大屏主数据展示 |
|
|
||||||
|
|
||||||
#### 2.1.4 表格数字：Arial
|
|
||||||
|
|
||||||
| 样式 | 使用场景 |
|
|
||||||
|------|----------|
|
|
||||||
| 20px Regular | 表格横纵轴数字 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 2.2 后台系统字体规范
|
|
||||||
|
|
||||||
#### 2.2.1 中文字体：Noto Sans S Chinese
|
|
||||||
|
|
||||||
| 样式 | 使用场景 |
|
|
||||||
|------|----------|
|
|
||||||
| 18px Bold | 导航、一级标题 |
|
|
||||||
| 18px Medium | 次要一级标题 |
|
|
||||||
| 16px Bold | 二级标题 |
|
|
||||||
| 16px Medium | 次要二级标题 |
|
|
||||||
| 16px Regular | 正文、按钮内部文字等 |
|
|
||||||
| 16px Light | 次要正文 |
|
|
||||||
|
|
||||||
#### 2.2.2 数字字体：D-DIN
|
|
||||||
|
|
||||||
| 样式 | 使用场景 |
|
|
||||||
|------|----------|
|
|
||||||
| 26px Bold | 重要数据展示 |
|
|
||||||
| 26px Regular | 普通数据展示 |
|
|
||||||
| 24px Bold | 常规数据展示（小） |
|
|
||||||
| 24px Regular | 常规数据展示（小） |
|
|
||||||
|
|
||||||
#### 2.2.3 LOGO 字体：DOUYUFont
|
|
||||||
|
|
||||||
| 样式 | 使用场景 |
|
|
||||||
|------|----------|
|
|
||||||
| 20px 文字样式 | 页面顶部系统名称 |
|
|
||||||
|
|
||||||
#### 2.2.4 表格数字：Arial
|
|
||||||
|
|
||||||
| 样式 | 使用场景 |
|
|
||||||
|------|----------|
|
|
||||||
| 16px Regular | 表格横纵轴数字 |
|
|
||||||
| 14px Regular | 表格横纵轴的数字（空间有限） |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 阴影
|
|
||||||
|
|
||||||
> 浅色主题采用**中性投影**（基于 FS-004 `#222222`）营造层级，避免使用彩色外发光。卡片以纯白 `#FFFFFF` 浮于浅灰页面背景 `#FAFAFA` 之上，靠投影与边框区分。
|
|
||||||
|
|
||||||
### 3.1 容器与卡片配色
|
|
||||||
|
|
||||||
#### 3.1.1 卡片（标题 + 操作）
|
|
||||||
|
|
||||||
白底卡片，标题在左、操作区在右（文字操作或图标操作）。
|
|
||||||
|
|
||||||
| 角色 | 色值 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 卡片背景 | `#FFFFFF` | FS-004-01 |
|
|
||||||
| 卡片边框 | `#E8E8E8` | FS-004-04 |
|
|
||||||
| 卡片阴影 | `0 2px 8px rgba(34, 34, 34, 0.08)` | 基于 FS-004 中性投影 |
|
|
||||||
| 标题文字（16px Bold） | `#222222` | FS-004（正文色） |
|
|
||||||
| 操作按钮文字 | `#F5222D` | ZS-001-09（主色红，链接型操作） |
|
|
||||||
| 次级操作图标（✏️ / ⋯） | `#A6A6A6` | FS-004-07（备注图标色） |
|
|
||||||
|
|
||||||
#### 3.1.2 卡片新增（占位卡片）
|
|
||||||
|
|
||||||
虚线描边的"新增入口"卡片，用于引导用户添加内容。
|
|
||||||
|
|
||||||
| 角色 | 色值 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 卡片背景 | `#FFFFFF` | FS-004-01 |
|
|
||||||
| 虚线边框 | `#DBDBDB` | FS-004-05 |
|
|
||||||
| 加号图标 | `#A6A6A6` | FS-004-07 |
|
|
||||||
| Hover 边框 | `#F5222D` | ZS-001-09（悬停时提示可点击） |
|
|
||||||
| Hover 加号 | `#F5222D` | ZS-001-09 |
|
|
||||||
|
|
||||||
#### 3.1.3 阴影投影规则
|
|
||||||
|
|
||||||
| 层级 | 阴影值 | 使用场景 |
|
|
||||||
|------|--------|----------|
|
|
||||||
| 一级阴影（卡片浮起） | `0 2px 8px rgba(34, 34, 34, 0.08)` | 普通卡片 |
|
|
||||||
| 二级阴影（hover / 强调） | `0 4px 16px rgba(34, 34, 34, 0.12)` | 卡片 hover、悬浮按钮、弹出层 |
|
|
||||||
| 三级阴影（弹窗 / Modal） | `0 8px 32px rgba(34, 34, 34, 0.16)` | Dialog、Drawer |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. 圆角
|
|
||||||
|
|
||||||
### 4.1 圆角统一规范
|
|
||||||
|
|
||||||
| 元素 | 圆角值 | 说明 |
|
|
||||||
|------|--------|------|
|
|
||||||
| 按钮 | `2px` | 所有按钮（主 / 次要 / 默认 / 文本）统一使用 |
|
|
||||||
| 卡片 | `4px` | 内容卡片、标题+操作卡片、卡片新增占位 |
|
|
||||||
| 页面分栏框 | `4px` | 外层容器、分栏区域 |
|
|
||||||
| 输入框 / 选择器 | `2px` | 与按钮一致，保持表单内对齐 |
|
|
||||||
| Tag / Badge | `2px` | 与按钮一致 |
|
|
||||||
| Modal / Drawer | `4px` | 与卡片一致 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 6. 间距
|
|
||||||
|
|
||||||
> 全站以 `8px (0.5rem)` 为对照基准单位，划分"密 / 疏"两个层次。所有间距取值均来自下列阶梯，禁止使用非阶梯值（如 5px、13px）。
|
|
||||||
|
|
||||||
### 6.1 间距阶梯
|
|
||||||
|
|
||||||
| 阶 | px | rem | 分组 | 典型场景 |
|
|
||||||
|----|------|--------|------|----------|
|
|
||||||
| 1 | `4px` | `0.25rem` | 密 | 图标与文字间距、Tag 内边距、紧凑徽标 |
|
|
||||||
| 2 | `8px` | `0.5rem` | 密 | 行内元素相邻、按钮组间距、表单 label 与控件 |
|
|
||||||
| 3 | `12px` | `0.75rem` | 密 | 表单项垂直间距、列表项内边距 |
|
|
||||||
| 4 | `16px` | `1rem` | 密 | 卡片内容内边距、模块内分隔 |
|
|
||||||
| 5 | `24px` | `1.5rem` | 疏 | 模块之间、Section 内边距 |
|
|
||||||
| 6 | `32px` | `2rem` | 疏 | 卡片之间、表单组之间 |
|
|
||||||
| 7 | `40px` | `2.5rem` | 疏 | 主区块之间、页面 Header / Footer 内边距 |
|
|
||||||
| 8 | `56px` | `3.5rem` | 疏 | 页面段落级隔断、Banner 区域 |
|
|
||||||
|
|
||||||
> "密"对应紧凑信息密度（表格、表单、卡片内部）；"疏"对应视觉呼吸（模块之间、页面整体留白）。**16px 是"密"的上限，24px 是"疏"的下限**，两者之间不应再插入自定义值。
|
|
||||||
|
|
||||||
### 6.2 使用原则
|
|
||||||
|
|
||||||
- **同层级一致**：同一布局层级内的间距必须使用同一阶值；多种取值会破坏节奏。
|
|
||||||
- **就近取阶**：相邻区块的间距尽量从相邻阶梯取值（如 `16px → 24px`），跨越过多阶（如 `8px → 56px`）会让视觉断裂。
|
|
||||||
- **密疏不混用**：一个组件内部全部用"密"，外部用"疏"，避免内 / 外间距颠倒。
|
|
||||||
- **优先 8 的倍数**：除最小阶 `4px` 外，所有阶皆为 8 的倍数，方便 4/8 网格对齐。
|
|
||||||
- **响应式按比例衰减**：移动端可整体降一阶（如 `24px → 16px`），但仍在阶梯内。
|
|
||||||
|
|
||||||
### 6.3 CSS Token 建议
|
|
||||||
|
|
||||||
```css
|
|
||||||
:root {
|
|
||||||
--spacing-1: 4px; /* 0.25rem */
|
|
||||||
--spacing-2: 8px; /* 0.5rem */
|
|
||||||
--spacing-3: 12px; /* 0.75rem */
|
|
||||||
--spacing-4: 16px; /* 1rem */
|
|
||||||
--spacing-5: 24px; /* 1.5rem */
|
|
||||||
--spacing-6: 32px; /* 2rem */
|
|
||||||
--spacing-7: 40px; /* 2.5rem */
|
|
||||||
--spacing-8: 56px; /* 3.5rem */
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 20. 语义状态色（统一约定）
|
|
||||||
|
|
||||||
> 进度、状态标签、表格状态、时间轴等大量组件共用同一套语义色。后续章节直接引用本表。
|
|
||||||
|
|
||||||
| 语义 | 文字色 | 浅底背景 | 实填背景 | 来源 |
|
|
||||||
|------|--------|----------|----------|------|
|
|
||||||
| 成功 / 完成（绿） | `#189D72` (FS-002-10) | `#EEFCF7` (FS-002-03) | `#2FD69A` (FS-002-09) | 渐绿系 |
|
|
||||||
| 警告 / 进行中（橙） | `#FF9900` (FS-001-09) | `#FFF6EA` (FS-001-03) | `#FF9900` (FS-001-09) | 渐橙系 |
|
|
||||||
| 错误 / 失败（红） | `#F5222D` (ZS-001-09) | `#FEEDED` (ZS-001-03) | `#F5222D` (ZS-001-09) | 渐红系 |
|
|
||||||
| 信息 / 等待（蓝） | `#0079FE` (ZS-002-09) | `#EAF4FF` (ZS-002-03) | `#0079FE` (ZS-002-09) | 渐蓝系 |
|
|
||||||
| 待更新（青） | `#45C3F3` (FS-003-09) | `#EFFAFE` (FS-003-03) | `#45C3F3` (FS-003-09) | 渐青系 |
|
|
||||||
| 未开始 / 中性（灰） | `#7F7F7F` (FS-004-08) | `#F5F5F5` (FS-004-03) | `#A6A6A6` (FS-004-07) | 中性灰系 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
> 返回 [规范目录](README.md)
|
|
||||||
@@ -1,314 +0,0 @@
|
|||||||
# 浅红色 UI 规范 · 二、按钮与表单输入
|
|
||||||
|
|
||||||
> 返回 [规范目录](README.md) | 本篇：按钮 · 表单 · 输入框 · 选择按钮 · 标签输入框 · 上传
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5. 按钮
|
|
||||||
|
|
||||||
> 全部圆角 `2px`，文字字号 `14px`，字体 Noto Sans S Chinese Regular。配色取自 ZS-001 主色红与 FS-004 中性灰。
|
|
||||||
|
|
||||||
### 5.1 按钮尺寸
|
|
||||||
|
|
||||||
| 规格 | 高度 | 内边距 | 使用场景 |
|
|
||||||
|------|------|--------|----------|
|
|
||||||
| 小 | `24px` | `0 8px` | 空间小的板块内部，如表格中、卡片标题等 |
|
|
||||||
| 正常 | `32px` | `0 14px` | 默认尺寸，所有常用按钮 |
|
|
||||||
|
|
||||||
### 5.2 按钮类型与配色
|
|
||||||
|
|
||||||
#### 5.2.1 主按钮（Primary）
|
|
||||||
|
|
||||||
> 一个操作区域只能有一个主按钮。
|
|
||||||
|
|
||||||
| 状态 | 背景 | 边框 | 文字 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| 默认 | `#F5222D` (ZS-001-09) | — | `#FFFFFF` |
|
|
||||||
| Hover | `#CF1322` (ZS-001) | — | `#FFFFFF` |
|
|
||||||
| Active | `#A8071A` (ZS-001-11) | — | `#FFFFFF` |
|
|
||||||
| 失效 | `#A6A6A6` (FS-004-07) | — | `#FFFFFF` |
|
|
||||||
|
|
||||||
#### 5.2.2 次要按钮（Secondary / Outline-Primary）
|
|
||||||
|
|
||||||
重要度低于主按钮、高于默认按钮。红色描边 + 红色文字。
|
|
||||||
|
|
||||||
| 状态 | 背景 | 边框 | 文字 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| 默认 | `#FFFFFF` | `#F5222D` (ZS-001-09) | `#F5222D` (ZS-001-09) |
|
|
||||||
| Hover | `#FEEDED` (ZS-001-03) | `#CF1322` (ZS-001) | `#CF1322` (ZS-001) |
|
|
||||||
| Active | `#FDDADC` (ZS-001-04) | `#A8071A` (ZS-001-11) | `#A8071A` (ZS-001-11) |
|
|
||||||
| 失效 | `#FFFFFF` | `#FCB5B9` (ZS-001-05) | `#FCB5B9` (ZS-001-05) |
|
|
||||||
|
|
||||||
#### 5.2.3 默认按钮（Default）
|
|
||||||
|
|
||||||
用于"取消 / 返回"等次要操作，与主按钮成对出现时主按钮在右。中性描边。
|
|
||||||
|
|
||||||
| 状态 | 背景 | 边框 | 文字 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| 默认 | `#FFFFFF` | `#DBDBDB` (FS-004-05) | `#222222` (FS-004) |
|
|
||||||
| Hover | `#FAFAFA` (FS-004-02) | `#F5222D` (ZS-001-09) | `#F5222D` (ZS-001-09) |
|
|
||||||
| Active | `#F5F5F5` (FS-004-03) | `#CF1322` (ZS-001) | `#CF1322` (ZS-001) |
|
|
||||||
| 禁用 | `#F5F5F5` (FS-004-03) | `#E8E8E8` (FS-004-04) | `#C1C1C1` (FS-004-06) |
|
|
||||||
|
|
||||||
#### 5.2.4 文本按钮（Text）
|
|
||||||
|
|
||||||
用于表格操作、文件下载等。无背景与边框，靠文字色识别。
|
|
||||||
|
|
||||||
| 状态 | 文字 | 装饰 |
|
|
||||||
|------|------|------|
|
|
||||||
| 默认 | `#F5222D` (ZS-001-09) | 无下划线 |
|
|
||||||
| Hover | `#CF1322` (ZS-001) | 显示下划线（与文字同色） |
|
|
||||||
| Active | `#A8071A` (ZS-001-11) | 下划线 |
|
|
||||||
| 失效 | `#C1C1C1` (FS-004-06) | 无装饰 |
|
|
||||||
|
|
||||||
#### 5.2.5 图标按钮（Icon-only）
|
|
||||||
|
|
||||||
用于增强辨识度或节省空间。仅图标，无文字。
|
|
||||||
|
|
||||||
| 变体 | 背景 | 边框 | 图标颜色 |
|
|
||||||
|------|------|------|----------|
|
|
||||||
| 描边（默认） | `#FFFFFF` | `#DBDBDB` (FS-004-05) | `#575757` (FS-004-09) |
|
|
||||||
| 描边 Hover | `#FAFAFA` | `#F5222D` (ZS-001-09) | `#F5222D` (ZS-001-09) |
|
|
||||||
| 主色（填充） | `#F5222D` (ZS-001-09) | — | `#FFFFFF` |
|
|
||||||
| 主色 Hover | `#CF1322` (ZS-001) | — | `#FFFFFF` |
|
|
||||||
| 浅色（弱填充） | `#FEEDED` (ZS-001-03) | — | `#F5222D` (ZS-001-09) |
|
|
||||||
|
|
||||||
### 5.3 按钮组合
|
|
||||||
|
|
||||||
#### 5.3.1 文字 + 下拉按钮（含 ⌄）
|
|
||||||
|
|
||||||
| 形态 | 配色规则 |
|
|
||||||
|------|----------|
|
|
||||||
| 默认（Outline） | 沿用 §5.2.3 默认按钮，箭头 ⌄ 与文字同色 `#222222` |
|
|
||||||
| 主色（Filled） | 沿用 §5.2.1 主按钮，箭头 ⌄ 同步白色 `#FFFFFF` |
|
|
||||||
|
|
||||||
#### 5.3.2 图标 + 文字按钮（如 `+ 正常`）
|
|
||||||
|
|
||||||
| 形态 | 配色规则 |
|
|
||||||
|------|----------|
|
|
||||||
| 默认（Outline） | 沿用 §5.2.3，左侧图标颜色与文字一致 `#222222` |
|
|
||||||
| 主色（Filled） | 沿用 §5.2.1，左侧图标与文字一致 `#FFFFFF` |
|
|
||||||
|
|
||||||
#### 5.3.3 文本按钮 + 图标（"更多 »"、"展开 ⌄"、"下一页 »"、"« 上一页"、"收起 ^"）
|
|
||||||
|
|
||||||
| 角色 | 色值 |
|
|
||||||
|------|------|
|
|
||||||
| 文字 + 图标（默认） | `#F5222D` (ZS-001-09) |
|
|
||||||
| 文字 + 图标（Hover） | `#CF1322` (ZS-001) |
|
|
||||||
| 失效 | `#C1C1C1` (FS-004-06) |
|
|
||||||
|
|
||||||
> 图标可在文字前或后；多个文本按钮排成一行时，间距 `16px`，无分隔符。
|
|
||||||
|
|
||||||
#### 5.3.4 主按钮 + 默认按钮组合（如"确定 / 取消 / 返回"）
|
|
||||||
|
|
||||||
- **排列顺序**：默认按钮在左，主按钮在右（最右侧为主操作）
|
|
||||||
- **按钮间距**：`8px`
|
|
||||||
- **示例**：`[ 返回 ] [ 取消 ] [ 确定 ]`
|
|
||||||
- **配色**：主按钮沿用 §5.2.1，其余沿用 §5.2.3
|
|
||||||
|
|
||||||
### 5.4 其他按钮
|
|
||||||
|
|
||||||
#### 5.4.1 悬浮状态（Floating）
|
|
||||||
|
|
||||||
用于 Banner / 登录 / 视觉冲击强等展示场景。配色与主按钮一致，叠加阴影抬升。
|
|
||||||
|
|
||||||
| 状态 | 阴影 |
|
|
||||||
|------|------|
|
|
||||||
| 默认 | `0 2px 8px rgba(34, 34, 34, 0.08)`（§3.1.3 一级阴影） |
|
|
||||||
| Hover | `0 4px 16px rgba(34, 34, 34, 0.12)`（§3.1.3 二级阴影） |
|
|
||||||
| Active | 阴影消失，按下感 |
|
|
||||||
|
|
||||||
#### 5.4.2 加载中（Loading）
|
|
||||||
|
|
||||||
用于异步操作等待反馈。点击瞬间将按钮锁定，文字前显示旋转图标。
|
|
||||||
|
|
||||||
| 角色 | 色值 |
|
|
||||||
|------|------|
|
|
||||||
| 背景 | `#F5222D` (ZS-001-09) |
|
|
||||||
| 文字 | `#FFFFFF` |
|
|
||||||
| 加载图标 | `#FFFFFF`，旋转动画 `1.2s linear infinite` |
|
|
||||||
| 不可点击 | 鼠标 `cursor: not-allowed` |
|
|
||||||
|
|
||||||
> 与失效态的区别：失效是"不可操作"，加载是"操作进行中"——保留品牌主色，只是不可再次触发。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 12. 表单（Form）
|
|
||||||
|
|
||||||
> 页面级表单可参照弹窗表单，**操作按钮置于左下角**。容器为白底卡片，标题下叠 `1px solid #E8E8E8` 分割线。
|
|
||||||
|
|
||||||
### 12.1 基础表单结构
|
|
||||||
|
|
||||||
| 元素 | 规格 / 配色 |
|
|
||||||
|------|-------------|
|
|
||||||
| 容器背景 | `#FFFFFF` (FS-004-01)，圆角 `4px` |
|
|
||||||
| 表单标题 | `16px Bold`，`#222222` (FS-004)，下叠 `1px solid #E8E8E8` |
|
|
||||||
| 字段标签（label） | `14px Regular`，`#575757` (FS-004-09)，左对齐 |
|
|
||||||
| 字段垂直间距 | `--spacing-3` (12px) |
|
|
||||||
| 输入控件 | 见 §13 输入框 |
|
|
||||||
| 操作按钮区 | 置于左下角，主按钮 + 默认按钮（§5.3.4），间距 `--spacing-2` (8px) |
|
|
||||||
|
|
||||||
### 12.2 开关（Switch）
|
|
||||||
|
|
||||||
| 状态 | 轨道背景 | 滑块 | 文字 |
|
|
||||||
|------|----------|------|------|
|
|
||||||
| 开（ON） | `#F5222D` (ZS-001-09) | `#FFFFFF` 圆点 | "开" `#FFFFFF` |
|
|
||||||
| 关（OFF） | `#DBDBDB` (FS-004-05) | `#FFFFFF` 圆点 | "关" `#A6A6A6` (FS-004-07) |
|
|
||||||
| 禁用 | `#E8E8E8` (FS-004-04) | `#FFFFFF` | `#C1C1C1` |
|
|
||||||
|
|
||||||
- 轨道高 `20px`，圆角全圆；切换过渡 `transform 160ms ease-out`
|
|
||||||
|
|
||||||
### 12.3 表格内报错（Table 报错）
|
|
||||||
|
|
||||||
行内可编辑表格的校验错误态。
|
|
||||||
|
|
||||||
| 元素 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 表头背景 | `#FEEDED` (ZS-001-03) |
|
|
||||||
| 表头文字 | `#222222` (FS-004)，`14px Medium` |
|
|
||||||
| 行（默认） | 背景 `#FFFFFF`，底边 `1px solid #F5F5F5` (FS-004-03) |
|
|
||||||
| 行（hover / 选中） | 背景 `#FEF6F6` (ZS-001-02) |
|
|
||||||
| 正文文字 | `#222222` (FS-004) |
|
|
||||||
| 错误输入框边框 | `1px solid #F5222D` (ZS-001-09) |
|
|
||||||
| 单位后缀（如 `M`） | addon 背景 `#FAFAFA`，边框 `#DBDBDB`，文字 `#575757` |
|
|
||||||
| 错误提示气泡 | 背景 `#F5222D`，文字 `#FFFFFF` `12px`，圆角 `2px`，带向上箭头，定位于出错输入框下方 |
|
|
||||||
| 复选框（选中） | 勾选填充 `#F5222D`，对勾 `#FFFFFF` |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 13. 输入框（Input）
|
|
||||||
|
|
||||||
> 字号 `16px`，高度 `32px`，圆角 `2px`，内边距 `0 12px`，背景 `#FFFFFF`。
|
|
||||||
|
|
||||||
### 13.1 基础状态
|
|
||||||
|
|
||||||
| 状态 | 边框 | 背景 | 文字 / 占位符 |
|
|
||||||
|------|------|------|--------------|
|
|
||||||
| 未填（默认） | `1px solid #DBDBDB` (FS-004-05) | `#FFFFFF` | 占位符 `#A6A6A6` (FS-004-07) |
|
|
||||||
| 聚焦（Focus） | `1px solid #F5222D` (ZS-001-09) | `#FFFFFF` | 文字 `#222222` |
|
|
||||||
| 已填 | `1px solid #DBDBDB` | `#FFFFFF` | 文字 `#222222` (FS-004) |
|
|
||||||
| 未填 · 禁用 | `1px solid #E8E8E8` (FS-004-04) | `#F5F5F5` (FS-004-03) | 占位符 `#C1C1C1` (FS-004-06)，`cursor: not-allowed` |
|
|
||||||
| 已填 · 禁用 | `1px solid #E8E8E8` | `#F5F5F5` | 文字 `#A6A6A6` |
|
|
||||||
| 错误（Error） | `1px solid #F5222D` | `#FFFFFF` | 文字 `#222222`，下方红色提示文字 `12px #F5222D` |
|
|
||||||
|
|
||||||
### 13.2 带操作 / 特殊输入框
|
|
||||||
|
|
||||||
| 类型 | 说明 | 配色 |
|
|
||||||
|------|------|------|
|
|
||||||
| 未填 / 已填 · 操作 | 尾部带操作图标（如 ⚙） | 图标 `#A6A6A6`，hover `#F5222D` |
|
|
||||||
| 密码 · 不可见 | 尾部带可见性切换 👁 | 图标 `#A6A6A6`，点击切换明 / 密文 |
|
|
||||||
| 前置标签 | 头部下拉（如 `http:// ▾`） | addon 背景 `#FAFAFA`，边框 `#DBDBDB`，文字 `#575757` |
|
|
||||||
| 后置标签 | 尾部下拉（如 `.com ▾`） | 同前置标签 |
|
|
||||||
| 前后置标签 | 头尾各一段 addon | 同上；输入区与 addon 共用一条外边框 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 14. 选择按钮（单选 / 多选式）
|
|
||||||
|
|
||||||
> 以按钮形态替代传统单选 / 复选，提升点击区域与辨识度。每组提供三种"已选"填充强度，可按对比需要选用；布局分**相连**（segmented）与**分离**两种。
|
|
||||||
|
|
||||||
### 14.1 选择按钮（基础）
|
|
||||||
|
|
||||||
| 状态 / 变体 | 背景 | 边框 | 文字 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| 未选 | `#FFFFFF` | `1px solid #DBDBDB` (FS-004-05) | `#222222` (FS-004) |
|
|
||||||
| 已选 · 描边 | `#FFFFFF` | `1px solid #F5222D` (ZS-001-09) | `#F5222D` (ZS-001-09) |
|
|
||||||
| 已选 · 浅填 | `#FEEDED` (ZS-001-03) | `1px solid #FCB5B9` (ZS-001-05) | `#F5222D` (ZS-001-09) |
|
|
||||||
| 已选 · 实填 | `#F5222D` (ZS-001-09) | — | `#FFFFFF` |
|
|
||||||
| 禁用 | `#F5F5F5` (FS-004-03) | `1px solid #E8E8E8` | `#C1C1C1` (FS-004-06) |
|
|
||||||
|
|
||||||
- 高度 `32px`，内边距 `0 14px`，圆角 `2px`，字号 `14px`
|
|
||||||
- **相连布局**：按钮紧贴，仅最外两端圆角，相邻共用边框
|
|
||||||
- **分离布局**：按钮间距 `--spacing-2` (8px)，各自独立圆角
|
|
||||||
|
|
||||||
### 14.2 选择按钮（带统计）
|
|
||||||
|
|
||||||
在文案后附计数，如 `已选(230)`。配色完全沿用 §14.1，计数文字与主文字同色（实填态为 `#FFFFFF`）。
|
|
||||||
|
|
||||||
### 14.3 按钮式页签（带图标）
|
|
||||||
|
|
||||||
文案前带图标（如 `田`），用于视图 / 模式切换。
|
|
||||||
|
|
||||||
| 状态 / 变体 | 背景 | 边框 | 图标 + 文字 |
|
|
||||||
|------|------|------|-------------|
|
|
||||||
| 正常（未激活） | `#FFFFFF` | `1px solid #DBDBDB` | `#222222` |
|
|
||||||
| 激活 · 描边 | `#FFFFFF` | `1px solid #F5222D` | `#F5222D` |
|
|
||||||
| 激活 · 实填 | `#F5222D` (ZS-001-09) | — | `#FFFFFF` |
|
|
||||||
|
|
||||||
- 图标与文字间距 `--spacing-1` (4px)，其余规格同 §14.1
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 15. 标签输入框（Tag Input）
|
|
||||||
|
|
||||||
> 在输入框内以"标签 + 自由输入"混合录入，支持单行 / 多行，含字数统计。
|
|
||||||
|
|
||||||
### 15.1 规格
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 容器边框 | `1px solid #DBDBDB` (FS-004-05)，圆角 `2px` |
|
|
||||||
| 聚焦边框 | `1px solid #F5222D` (ZS-001-09) |
|
|
||||||
| 容器背景 | `#FFFFFF` |
|
|
||||||
| 内边距 | `--spacing-2` (8px) |
|
|
||||||
| 标签与标签间距 | `--spacing-1` (4px) |
|
|
||||||
| 右下角支持拖拽缩放（多行） | `resize: vertical` |
|
|
||||||
|
|
||||||
### 15.2 标签（Tag）配色
|
|
||||||
|
|
||||||
| 元素 | 色值 | 来源 |
|
|
||||||
|------|------|------|
|
|
||||||
| 标签背景 | `#F5F5F5` (FS-004-03) | — |
|
|
||||||
| 标签文字 | `#575757` (FS-004-09) | — |
|
|
||||||
| 关闭图标 `×` | `#A6A6A6` (FS-004-07) | hover `#F5222D` |
|
|
||||||
| 占位符（请输入） | `#A6A6A6` (FS-004-07) | — |
|
|
||||||
| 字数统计（如 `2/100`） | `#A6A6A6` (FS-004-07) | 超限时变 `#F5222D` |
|
|
||||||
|
|
||||||
> 折叠多标签时可用 `+N` 形式聚合（如 `+1 ×`），样式同普通标签。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 16. 上传（Upload）
|
|
||||||
|
|
||||||
> 含单文件、批量上传、拖拽上传三种形态。操作按钮中"开始上传 / 上传"为主按钮，"取消"为默认按钮。
|
|
||||||
|
|
||||||
### 16.1 上传触发器
|
|
||||||
|
|
||||||
| 形态 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 上传按钮（⬆ 上传文件） | 默认按钮（§5.2.3），含上传图标 |
|
|
||||||
| 选择文件输入 | 只读输入框（§13）+ 右侧"选择文件"默认按钮 |
|
|
||||||
| 提示文字 | `12px Regular`，`#A6A6A6` (FS-004-07)，如"支持 DOCX/ZIP/PDF，文件大小不超过 2MB" |
|
|
||||||
| 示例文件链接（下载 / 查看示例文件） | 文本按钮 `#F5222D` (ZS-001-09)，hover `#CF1322` |
|
|
||||||
|
|
||||||
### 16.2 拖拽区（Drop Zone）
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 背景 | `#FAFAFA` (FS-004-02) |
|
|
||||||
| 边框 | `1px dashed #DBDBDB` (FS-004-05) |
|
|
||||||
| 拖入高亮 | 边框 `1px dashed #F5222D` (ZS-001-09)，背景 `#FEF6F6` (ZS-001-02) |
|
|
||||||
| 提示文字（释放鼠标） | `#A6A6A6` (FS-004-07) |
|
|
||||||
|
|
||||||
### 16.3 文件列表与状态
|
|
||||||
|
|
||||||
列表表头：文件名 / 大小 / 状态 / 操作。各状态配色：
|
|
||||||
|
|
||||||
| 状态 | 图标 | 文字色 |
|
|
||||||
|------|------|--------|
|
|
||||||
| 上传成功 | ✓ 圆形，`#2FD69A` (FS-002-09) | `#189D72` (FS-002-10) |
|
|
||||||
| 文件格式有误 / 失败 | ❗ 圆形，`#F5222D` (ZS-001-09) | `#F5222D` |
|
|
||||||
| 上传中（如 上传 40%） | ⟳ 旋转，`#F5222D` (ZS-001-09) | `#575757` (FS-004-09) |
|
|
||||||
| 待上传 | 🕐 时钟，`#A6A6A6` (FS-004-07) | `#A6A6A6` |
|
|
||||||
| 操作列「删除」 | — | 文本按钮 `#A6A6A6`，hover `#F5222D` |
|
|
||||||
|
|
||||||
### 16.4 底部操作
|
|
||||||
|
|
||||||
`[ 取消 ]（默认按钮） [ 开始上传 ]（主按钮 #F5222D）`，间距 `--spacing-2` (8px)，右对齐。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
> 返回 [规范目录](README.md)
|
|
||||||
@@ -1,495 +0,0 @@
|
|||||||
# 浅红色 UI 规范 · 三、导航
|
|
||||||
|
|
||||||
> 返回 [规范目录](README.md) | 本篇：导航组件 · 面包屑 · 页头与分页 · 步骤条 · 页签与锚点
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 7. 导航组件
|
|
||||||
|
|
||||||
> 适用于"后台 / 控制台"类浅红主题界面。整体结构 = 顶部导航（红底）+ 二级导航（白底）+ 左侧分级菜单 + 多级下拉。颜色取自 ZS-001 主色红与 FS-004 中性灰。
|
|
||||||
|
|
||||||
### 7.1 顶部导航（Header · 红底）
|
|
||||||
|
|
||||||
#### 7.1.1 规格
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 高度 | `56px` |
|
|
||||||
| 左右 padding | `--spacing-4` (16px) |
|
|
||||||
| 背景 | `linear-gradient(90deg, #A8071A 0%, #CF1322 100%)`（ZS-001-11 → ZS-001） |
|
|
||||||
| LOGO 区切角装饰 | 叠深红斜切块 `#A8071A` (ZS-001-11)，`clip-path` 斜边 |
|
|
||||||
| 底边 | 无（与二级导航白底直接相接） |
|
|
||||||
| 文字基线 | `Noto Sans S Chinese`，垂直居中 |
|
|
||||||
|
|
||||||
#### 7.1.2 系统标题（LOGO + ******系统）
|
|
||||||
|
|
||||||
- 字号 `20px Bold`，颜色 `#FFFFFF`，字体 `DOUYUFont` 或 Noto Sans Medium
|
|
||||||
- LOGO 图标 `#FFFFFF`，置于左侧切角块上
|
|
||||||
|
|
||||||
#### 7.1.3 一级导航（中部主导航，红底白字）
|
|
||||||
|
|
||||||
| 状态 | 文字 | 背景 / 装饰 |
|
|
||||||
|------|------|------------|
|
|
||||||
| 默认 | `#FFFFFF` | `transparent` |
|
|
||||||
| Hover | `#FFFFFF` | 背景 `rgba(255, 255, 255, 0.12)` |
|
|
||||||
| 激活 | `#FFFFFF` | 底部 `2px solid #FFFFFF` 高亮线，背景 `rgba(255, 255, 255, 0.16)` |
|
|
||||||
|
|
||||||
- 字号 `16px Medium`，项间距 `--spacing-5` (24px)
|
|
||||||
|
|
||||||
#### 7.1.4 右侧工具区（图标 / 用户 / 退出）
|
|
||||||
|
|
||||||
| 元素 | 字号/尺寸 | 颜色 |
|
|
||||||
|------|----------|------|
|
|
||||||
| 工具图标（消息 / 通知等） | `16px` | `#FFFFFF`，hover `rgba(255,255,255,0.7)` |
|
|
||||||
| 用户名（如"李向前"） | `14px Regular` | `#FFFFFF` |
|
|
||||||
| 用户头像 | `28px` 圆形 | — |
|
|
||||||
| 退出图标 | `16px` | `#FFFFFF` |
|
|
||||||
|
|
||||||
- 元素间距 `--spacing-3` (12px)，整体右 padding `--spacing-4` (16px)
|
|
||||||
|
|
||||||
#### 7.1.5 用户下拉菜单（右上角）
|
|
||||||
|
|
||||||
白底面板，规格同 §7.4 下拉面板。
|
|
||||||
|
|
||||||
| 状态 | 背景 | 文字 / 图标 |
|
|
||||||
|------|------|-------------|
|
|
||||||
| 默认 | `transparent` | `#575757` (FS-004-09) |
|
|
||||||
| Hover / 激活 | `#FEEDED` (ZS-001-03) | `#F5222D` (ZS-001-09) |
|
|
||||||
|
|
||||||
> 项示例：用户中心 / 修改密码 / 退出；每项左侧带 16px 图标，图标色与文字同步。
|
|
||||||
|
|
||||||
### 7.2 二级导航（白底 Tab 行）
|
|
||||||
|
|
||||||
紧贴顶部导航下方的白底标签行。
|
|
||||||
|
|
||||||
#### 7.2.1 规格
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 高度 | `48px` |
|
|
||||||
| 背景 | `#FFFFFF` (FS-004-01) |
|
|
||||||
| 底边 | `border-bottom: 1px solid #E8E8E8` (FS-004-04) |
|
|
||||||
| 项间距 | `--spacing-6` (32px) |
|
|
||||||
| 字号 | `16px Medium` |
|
|
||||||
|
|
||||||
#### 7.2.2 状态配色
|
|
||||||
|
|
||||||
| 状态 | 文字 | 下划线 / 装饰 |
|
|
||||||
|------|------|--------------|
|
|
||||||
| 默认 | `#222222` (FS-004) | 无 |
|
|
||||||
| Hover | `#F5222D` (ZS-001-09) | 无 |
|
|
||||||
| 激活 | `#F5222D` (ZS-001-09) | 底部 `2px solid #F5222D`，含下拉箭头 `▾` 同色 |
|
|
||||||
| 失效 | `#C1C1C1` (FS-004-06) | 无 |
|
|
||||||
|
|
||||||
### 7.3 侧边栏（分级菜单）
|
|
||||||
|
|
||||||
#### 7.3.1 规格
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 宽度 | `200px`（展开）/ `64px`（折叠仅图标） |
|
|
||||||
| 背景 | `#FFFFFF` (FS-004-01) |
|
|
||||||
| 右边界 | `border-right: 1px solid #E8E8E8` (FS-004-04) |
|
|
||||||
| 项高度 | `40px` |
|
|
||||||
| 项左 padding | 二级 `--spacing-4` (16px)；三级 `--spacing-6` (32px) |
|
|
||||||
| 字号 | `16px Regular`（二级）/ `14px Regular`（三级） |
|
|
||||||
|
|
||||||
#### 7.3.2 二级菜单项配色
|
|
||||||
|
|
||||||
| 状态 | 背景 | 文字 | 图标 | 左侧指示条 |
|
|
||||||
|------|------|------|------|-----------|
|
|
||||||
| 默认 | `transparent` | `#222222` (FS-004) | `#A6A6A6` (FS-004-07) | 无 |
|
|
||||||
| Hover | `#FAFAFA` (FS-004-02) | `#F5222D` (ZS-001-09) | `#F5222D` | 无 |
|
|
||||||
| 激活 | `#FEEDED` (ZS-001-03) | `#F5222D` (ZS-001-09) | `#F5222D` | 左侧 `2px solid #F5222D` |
|
|
||||||
|
|
||||||
#### 7.3.3 三级菜单项配色（前缀 `-` 短横线）
|
|
||||||
|
|
||||||
| 状态 | 背景 | 文字 | 左侧指示条 |
|
|
||||||
|------|------|------|-----------|
|
|
||||||
| 默认 | `transparent` | `#575757` (FS-004-09) | 无 |
|
|
||||||
| Hover | `#FAFAFA` (FS-004-02) | `#F5222D` (ZS-001-09) | 无 |
|
|
||||||
| 激活 | `#FEEDED` (ZS-001-03) | `#F5222D` (ZS-001-09) | 左侧 `2px solid #F5222D` |
|
|
||||||
|
|
||||||
### 7.4 下拉菜单面板
|
|
||||||
|
|
||||||
#### 7.4.1 列表型面板（如二级导航的"浏览器容器 / 手机板卡容器…"）
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 背景 | `#FFFFFF` (FS-004-01) |
|
|
||||||
| 边框 | `1px solid #E8E8E8` (FS-004-04) |
|
|
||||||
| 阴影 | `0 4px 16px rgba(34, 34, 34, 0.12)`（§3.1.3 二级阴影） |
|
|
||||||
| 圆角 | `4px` |
|
|
||||||
| 内边距 | 上下 `--spacing-2` (8px) |
|
|
||||||
| 最小宽度 | `150px` |
|
|
||||||
| 行高 | `36px` |
|
|
||||||
|
|
||||||
| 状态 | 背景 | 文字 |
|
|
||||||
|------|------|------|
|
|
||||||
| 默认 | `transparent` | `#575757` (FS-004-09) |
|
|
||||||
| Hover / 激活 | `#FEEDED` (ZS-001-03) | `#F5222D` (ZS-001-09) |
|
|
||||||
| 失效 | `transparent` | `#C1C1C1` (FS-004-06) |
|
|
||||||
|
|
||||||
#### 7.4.2 卡片宫格型面板（一级导航的图标宫格下拉）
|
|
||||||
|
|
||||||
白底大面板内以网格陈列"图标 + 二级导航名"卡片。
|
|
||||||
|
|
||||||
| 角色 | 背景 | 图标 / 文字 |
|
|
||||||
|------|------|-------------|
|
|
||||||
| 卡片（默认） | `#FEF6F6` (ZS-001-02) | 图标 `#F5222D`，文字 `#575757` |
|
|
||||||
| 卡片（Hover） | `#FEEDED` (ZS-001-03) | 图标 / 文字 `#F5222D` |
|
|
||||||
| 卡片（激活 / 当前） | `#F5222D` (ZS-001-09) | 图标 / 文字 `#FFFFFF` |
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 卡片尺寸 | `80px × 72px`（自适应等分） |
|
|
||||||
| 卡片圆角 | `4px` |
|
|
||||||
| 卡片间距 | `--spacing-2` (8px) |
|
|
||||||
| 面板内边距 | `--spacing-4` (16px) |
|
|
||||||
| 面板阴影 | `0 8px 32px rgba(34, 34, 34, 0.16)`（§3.1.3 三级阴影） |
|
|
||||||
|
|
||||||
### 7.5 交互与动画
|
|
||||||
|
|
||||||
| 行为 | 动效 |
|
|
||||||
|------|------|
|
|
||||||
| 下拉面板展开 | `transform-origin: top; scaleY(0.95) → scaleY(1); opacity 0 → 1`，`200ms ease-out` |
|
|
||||||
| 展开箭头旋转 | `rotate(0 → 180deg)`，`200ms ease-out` |
|
|
||||||
| Hover 背景过渡 | `background-color 120ms ease-out` |
|
|
||||||
| 激活底部高亮线 | `width 0% → 100%`，`240ms ease-out` |
|
|
||||||
|
|
||||||
### 7.6 侧边栏布局变体
|
|
||||||
|
|
||||||
> 侧边栏宽度通常固定，按"是否分级 / 是否展开"分为四种形态。关键区分：**叶子节点选中**用实心红填充 + 白字 + 左侧红指示条；**父级（含子项的可展开项）选中**仅用红字 + 红图标，不填充。
|
|
||||||
|
|
||||||
#### 7.6.1 上下分级 · 收起（仅图标）
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 宽度 | `64px`，仅图标 |
|
|
||||||
| 图标项（默认） | 图标 `#A6A6A6`，背景 `transparent` |
|
|
||||||
| 图标项（激活） | 图标 `#FFFFFF`，背景 `#F5222D` (ZS-001-09) 圆角方块 `4px` |
|
|
||||||
| Hover 弹出浮层 | **深色浮层**：背景 `#3D3D3D` (FS-004-10)，圆角 `4px`，阴影 §3.1.3 三级 |
|
|
||||||
| 浮层内二级标题 | `14px Medium`，`#FFFFFF` |
|
|
||||||
| 浮层内三级项（前缀 `-`） | `14px Regular`，`#FFFFFF`；hover 背景 `rgba(255,255,255,0.1)` |
|
|
||||||
|
|
||||||
#### 7.6.2 上下分级 · 展开
|
|
||||||
|
|
||||||
完整宽度列表，二级为可展开组（`^ / ▾`），其下挂三级项。
|
|
||||||
|
|
||||||
| 层级 / 状态 | 背景 | 文字 / 图标 | 左侧指示条 |
|
|
||||||
|------|------|-------------|-----------|
|
|
||||||
| 二级（默认） | `transparent` | 文字 `#222222`、图标 `#A6A6A6` | 无 |
|
|
||||||
| 二级（展开 / 当前父级） | `transparent` | 文字 `#F5222D`、图标 `#F5222D` | 无 |
|
|
||||||
| 三级（默认，前缀 `-`） | `transparent` | `#575757` (FS-004-09) | 无 |
|
|
||||||
| 三级（选中 · 叶子） | `#F5222D` (ZS-001-09) | `#FFFFFF` | 左侧 `2px solid #F5222D` |
|
|
||||||
|
|
||||||
#### 7.6.3 只有二级标题 · 不分级
|
|
||||||
|
|
||||||
扁平列表，二级即叶子节点，无三级。
|
|
||||||
|
|
||||||
| 状态 | 背景 | 文字 / 图标 | 左侧指示条 |
|
|
||||||
|------|------|-------------|-----------|
|
|
||||||
| 默认 | `transparent` | 文字 `#222222`、图标 `#A6A6A6` | 无 |
|
|
||||||
| Hover | `#FAFAFA` (FS-004-02) | 文字 `#F5222D`、图标 `#F5222D` | 无 |
|
|
||||||
| 选中 | `#F5222D` (ZS-001-09) | `#FFFFFF` | 左侧 `2px solid #F5222D` |
|
|
||||||
|
|
||||||
#### 7.6.4 二级选中 · 分级（含四级浮层）
|
|
||||||
|
|
||||||
二级展开后选中三级，三级再向右弹出**白底四级浮层**。
|
|
||||||
|
|
||||||
| 角色 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 三级选中（叶子） | 背景 `#F5222D`，文字 `#FFFFFF`，左侧 `2px solid #F5222D` |
|
|
||||||
| 四级浮层背景 | `#FFFFFF`，边框 `1px solid #E8E8E8`，阴影 §3.1.3 二级 |
|
|
||||||
| 四级项（默认） | `#575757` (FS-004-09) |
|
|
||||||
| 四级项（Hover） | 背景 `#FEEDED` (ZS-001-03)，文字 `#F5222D` |
|
|
||||||
| 四级项（选中） | 文字 `#F5222D`，左侧 `2px solid #F5222D` |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 8. 面包屑（Breadcrumb）
|
|
||||||
|
|
||||||
> 用于标识当前页面在层级结构中的位置，并提供逐级返回与跳转。建议层级**不超过四级**。
|
|
||||||
|
|
||||||
### 8.1 顶部路径式（🏠 | 概况 / 总概况）
|
|
||||||
|
|
||||||
页面顶部的简版面包屑，靠 `/` 分隔。
|
|
||||||
|
|
||||||
| 元素 | 色值 | 来源 | 说明 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| 首页图标 🏠 | `#A6A6A6` (FS-004-07) | — | hover `#F5222D` |
|
|
||||||
| 竖分隔 `\|` | `#E8E8E8` | FS-004-04 | 首页图标与路径间 |
|
|
||||||
| 父级路径文字 | `#575757` (FS-004-09) | — | 可点击，hover `#F5222D` |
|
|
||||||
| 路径分隔 `/` | `#C1C1C1` | FS-004-06 | — |
|
|
||||||
| 当前页文字 | `#222222` (FS-004) | — | `Medium`，不可点击 |
|
|
||||||
|
|
||||||
### 8.2 返回 + 路径式（含 ← 返回）
|
|
||||||
|
|
||||||
左侧"← 返回"按钮 + 竖分隔 + 文字路径。按层级展开：
|
|
||||||
|
|
||||||
```
|
|
||||||
一级: ← 返回 │ 现在位置
|
|
||||||
二级: ← 返回 │ 上一级位置 / 现在位置
|
|
||||||
三级: ← 返回 │ 上二级位置 / 上一级位置 / 现在位置
|
|
||||||
四级: ← 返回 │ 上三级位置 / 上二级位置 / 上一级位置 / 现在位置
|
|
||||||
```
|
|
||||||
|
|
||||||
| 元素 | 色值 | 来源 | 说明 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| 返回箭头 ← + "返回" | `#F5222D` (ZS-001-09) | — | hover `#CF1322`，文本按钮态 |
|
|
||||||
| 竖分隔 `\|` | `#E8E8E8` | FS-004-04 | 返回与路径间 |
|
|
||||||
| 历史层级文字 | `#575757` (FS-004-09) | — | 可点击，hover `#F5222D` |
|
|
||||||
| 路径分隔 `/` | `#C1C1C1` | FS-004-06 | — |
|
|
||||||
| 当前位置文字 | `#222222` (FS-004) | — | `Medium`，不可点击 |
|
|
||||||
|
|
||||||
### 8.3 行为规则
|
|
||||||
|
|
||||||
- 点击「返回」按钮逐步向上返回一级。
|
|
||||||
- 点击文字路径，快速返回到该层级页面。
|
|
||||||
- 层级尽可能不超过四级；超出时中间层折叠为 `…`。
|
|
||||||
- 字号 `14px Regular`，元素间距 `--spacing-2` (8px)，竖分隔高度约 `12–14px`。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 9. 页头与分页
|
|
||||||
|
|
||||||
### 9.1 页头（Page Header）
|
|
||||||
|
|
||||||
内容区顶部的标题区，底部叠一条 `1px solid #E8E8E8` (FS-004-04) 分割线。
|
|
||||||
|
|
||||||
| 变体 | 构成 | 配色 |
|
|
||||||
|------|------|------|
|
|
||||||
| 基础页头 | 页头标题 | 标题 `16px Bold #222222` (FS-004) |
|
|
||||||
| 页头 + 说明 | 标题 +（简要说明） | 说明 `14px Regular #A6A6A6` (FS-004-07) |
|
|
||||||
| 页头 + 说明 icon | 标题 + `?` 帮助图标 | 图标 `#A6A6A6`，hover `#F5222D` |
|
|
||||||
| 分 Tabs 页头 | 多个标题 Tab | 见 §9.2 |
|
|
||||||
|
|
||||||
### 9.2 分 Tabs 页头
|
|
||||||
|
|
||||||
横向页签形态，激活态红色下划线。
|
|
||||||
|
|
||||||
| 状态 | 文字 | 下划线 |
|
|
||||||
|------|------|--------|
|
|
||||||
| 默认 | `#222222` (FS-004) | 无 |
|
|
||||||
| Hover | `#F5222D` (ZS-001-09) | 无 |
|
|
||||||
| 激活 | `#F5222D` (ZS-001-09) | `2px solid #F5222D`，宽度与文字齐 |
|
|
||||||
| 失效 | `#C1C1C1` (FS-004-06) | 无 |
|
|
||||||
|
|
||||||
- 字号 `14px Medium`，项间距 `--spacing-5` (24px)，下划线与文字底部间距 `--spacing-2` (8px)
|
|
||||||
|
|
||||||
### 9.3 分页（Pagination）
|
|
||||||
|
|
||||||
#### 9.3.1 正常分页
|
|
||||||
|
|
||||||
`共 240 项 [1] 2 3 4 5 … 24 > 每页 [10 ▾] 条 前往 [ ] 页`
|
|
||||||
|
|
||||||
| 元素 | 默认 | Hover | 激活 | 失效 |
|
|
||||||
|------|------|-------|------|------|
|
|
||||||
| 总数 / 辅助文字（共N项 / 每页 / 条 / 前往 / 页） | `#575757` (FS-004-09) | — | — | — |
|
|
||||||
| 页码数字 | `#222222` (FS-004) | `#F5222D` (ZS-001-09) | 背景 `#F5222D` + 文字 `#FFFFFF` | `#C1C1C1` (FS-004-06) |
|
|
||||||
| 翻页箭头 `< >` | `#575757` (FS-004-09) | `#F5222D` | — | `#C1C1C1` |
|
|
||||||
| 省略号 `…` | `#A6A6A6` (FS-004-07) | — | — | — |
|
|
||||||
| 每页选择器 / 跳转输入框 | 边框 `#DBDBDB` (FS-004-05) | 边框 `#F5222D` | — | 边框 `#E8E8E8` |
|
|
||||||
|
|
||||||
- 页码项尺寸 `28px × 28px`，圆角 `2px`，激活态为实心红方块；项间距 `--spacing-1` (4px)
|
|
||||||
|
|
||||||
#### 9.3.2 精简分页
|
|
||||||
|
|
||||||
`共 1 项 < [1] / 10 >`
|
|
||||||
|
|
||||||
| 元素 | 色值 |
|
|
||||||
|------|------|
|
|
||||||
| 总数文字 | `#575757` (FS-004-09) |
|
|
||||||
| 当前页输入框 | 边框 `#DBDBDB`，文字 `#222222` |
|
|
||||||
| 总页数 `/ N` | `#A6A6A6` (FS-004-07) |
|
|
||||||
| 翻页箭头 `< >` | `#575757`，hover `#F5222D`，失效 `#C1C1C1` |
|
|
||||||
|
|
||||||
#### 9.3.3 导航式分页
|
|
||||||
|
|
||||||
仅"下一页 » / « 上一页"文本按钮，无页码。配色沿用 §5.3.3 文本按钮 + 图标：
|
|
||||||
|
|
||||||
| 状态 | 色值 |
|
|
||||||
|------|------|
|
|
||||||
| 默认 | `#F5222D` (ZS-001-09) |
|
|
||||||
| Hover | `#CF1322` (ZS-001) |
|
|
||||||
| 失效 | `#C1C1C1` (FS-004-06) |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 10. 步骤条（Steps）
|
|
||||||
|
|
||||||
> 用于多步流程的进度指引。按布局分**横向**（弹窗 / 页面）与**纵向**两类。颜色取自 ZS-001 主色红与 FS-004 中性灰。
|
|
||||||
|
|
||||||
### 10.1 步骤节点（公共）
|
|
||||||
|
|
||||||
每个步骤由「指示圆 + 标题（可选描述）」组成。指示圆按状态切换形态：
|
|
||||||
|
|
||||||
| 状态 | 圆形外观 | 圆内符号 | 来源 |
|
|
||||||
|------|----------|----------|------|
|
|
||||||
| 已完成（Completed） | 描边圆 `2px solid #F5222D`，背景 `transparent` | `✓`（对勾，`#F5222D`） | ZS-001-09 |
|
|
||||||
| 当前（Current） | 实心圆，背景 `#F5222D` | 步骤数字，`#FFFFFF` | ZS-001-09 / 白 |
|
|
||||||
| 未开始（Upcoming） | 描边圆 `1px solid #C1C1C1`，背景 `transparent` | 步骤数字，`#A6A6A6` | FS-004-06 / FS-004-07 |
|
|
||||||
| 失效（Disabled） | 描边圆 `1px solid #E8E8E8`，背景 `transparent` | 步骤数字，`#C1C1C1` | FS-004-04 / FS-004-06 |
|
|
||||||
|
|
||||||
**指示圆规格**：
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 直径 | `24px` |
|
|
||||||
| 圆内字号 | `12px Bold`（D-DIN 或 Noto Sans Bold） |
|
|
||||||
| 对勾图标 | `12px`，居中 |
|
|
||||||
|
|
||||||
**标题与描述文字**：
|
|
||||||
|
|
||||||
| 元素 | 状态 | 字号 / 颜色 | 来源 |
|
|
||||||
|------|------|-------------|------|
|
|
||||||
| 标题 | 已完成 / 当前 | `14px Medium`，`#222222` | FS-004 |
|
|
||||||
| 标题 | 未开始 / 失效 | `14px Medium`，`#A6A6A6` → `#C1C1C1` | FS-004-07 → FS-004-06 |
|
|
||||||
| 描述 | 已完成 / 当前 | `12px Regular`，`#575757` | FS-004-09 |
|
|
||||||
| 描述 | 未开始 / 失效 | `12px Regular`，`#A6A6A6` → `#C1C1C1` | FS-004-07 → FS-004-06 |
|
|
||||||
|
|
||||||
**连接线（步骤之间）**：
|
|
||||||
|
|
||||||
| 类型 | 色值 | 来源 | 样式 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| 已完成段 | `#F5222D` | ZS-001-09 | `1px dashed`（弹窗）/ `1px solid`（页面） |
|
|
||||||
| 未完成段 | `#C1C1C1` | FS-004-06 | `1px dashed` |
|
|
||||||
|
|
||||||
> 连接线在指示圆两侧水平居中（横向）或正下方垂直（纵向）；线两端与圆外缘留 `--spacing-1` (4px) 间隙。
|
|
||||||
|
|
||||||
### 10.2 弹窗步骤条（横向 · 描边圆为主）
|
|
||||||
|
|
||||||
用于 Modal / Drawer 内的紧凑步骤条。完成态用**描边 + 红色对勾**，避免在弹窗内过于抢眼。
|
|
||||||
|
|
||||||
```
|
|
||||||
( ✓ ) ┄┄┄ (●2) ┄┄┄ ( 3 ) ┄┄┄ ( 4 ) ┄┄┄ ( 5 )
|
|
||||||
标题 标题 标题 标题 标题
|
|
||||||
(描述) (描述) (描述) (描述) (描述)
|
|
||||||
```
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 容器水平 padding | `--spacing-5` (24px) |
|
|
||||||
| 指示圆 → 标题间距 | `--spacing-2` (8px) |
|
|
||||||
| 标题 → 描述间距 | `--spacing-1` (4px) |
|
|
||||||
| 连接线 | `1px dashed`，完成段 `#F5222D`，未完成段 `#C1C1C1` |
|
|
||||||
| 文字对齐 | 标题、描述居中于指示圆下方 |
|
|
||||||
| 两种变体 | 仅标题 / 标题 + 描述 |
|
|
||||||
|
|
||||||
### 10.3 页面步骤条（横向 · 实心圆 + 自定义首项标题）
|
|
||||||
|
|
||||||
用于页面级向导（如「新建集群」）。完成态连接线改为**实线**，首步标题可显示具体名称。
|
|
||||||
|
|
||||||
```
|
|
||||||
(✓) ──── (●2) ┄┄┄ ( 3 ) ┄┄┄ ( 4 ) ┄┄┄ ( 5 )
|
|
||||||
新建集群 标题 标题 标题 标题
|
|
||||||
(描述文本) (描述文本) (描述文本) (描述文本) (描述文本)
|
|
||||||
```
|
|
||||||
|
|
||||||
| 维度 | 弹窗步骤条 | 页面步骤条 |
|
|
||||||
|------|-----------|-----------|
|
|
||||||
| 完成态圆形 | 描边圆 + 红色对勾 | 描边圆 + 红色对勾（同） |
|
|
||||||
| 完成段连接线 | `1px dashed #F5222D` | `1px solid #F5222D` |
|
|
||||||
| 第一项 | 通用「标题」占位 | 可显示具体名称（自定义文案） |
|
|
||||||
|
|
||||||
### 10.4 纵向步骤条
|
|
||||||
|
|
||||||
用于侧栏 / 详情页内的纵向流程指引。两种变体——「仅标题」与「标题 + 描述」。
|
|
||||||
|
|
||||||
```
|
|
||||||
仅标题: 标题 + 描述:
|
|
||||||
|
|
||||||
(✓) 新建集群 (✓) 新建集群
|
|
||||||
┊ 描述文本描述
|
|
||||||
(●2) 标题 ┊
|
|
||||||
┊ (●2) 标题
|
|
||||||
( 3 ) 标题 描述文本描述
|
|
||||||
┊ ┊
|
|
||||||
( 4 ) 标题 ( 3 ) 标题
|
|
||||||
描述文本描述
|
|
||||||
```
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 指示圆 → 标题水平间距 | `--spacing-2` (8px) |
|
|
||||||
| 节点垂直间距（仅标题） | `--spacing-5` (24px)，圆心到圆心 |
|
|
||||||
| 节点垂直间距（标题 + 描述） | `--spacing-6` (32px)，圆心到圆心 |
|
|
||||||
| 标题 → 描述间距 | `--spacing-1` (4px) |
|
|
||||||
| 连接线位置 | 上下指示圆正下方垂直，居中于圆心 |
|
|
||||||
| 连接线样式 | `1px dashed`，完成段 `#F5222D`，未完成段 `#C1C1C1` |
|
|
||||||
| 文字对齐 | 标题与描述左对齐 |
|
|
||||||
|
|
||||||
### 10.5 交互与动画
|
|
||||||
|
|
||||||
| 行为 | 动效 |
|
|
||||||
|------|------|
|
|
||||||
| 步骤切换（next） | 当前圆 `background: transparent → #F5222D`，`200ms ease-out`；上一步圆 `border-color: #C1C1C1 → #F5222D`，再 `200ms` 切换为对勾图标淡入 |
|
|
||||||
| 连接线进度 | 完成段 `width 0% → 100%`，`240ms ease-out` |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 11. 页签与锚点
|
|
||||||
|
|
||||||
> 共用主色红指示当前位置：页签用于同层级内容切换，锚点用于长页面内章节跳转。
|
|
||||||
|
|
||||||
### 11.1 页签（Tabs）
|
|
||||||
|
|
||||||
#### 11.1.1 横向页签（下划线 · 横向）
|
|
||||||
|
|
||||||
| 状态 | 文字 | 下划线 |
|
|
||||||
|------|------|--------|
|
|
||||||
| 默认 | `#222222` (FS-004) | 无 |
|
|
||||||
| Hover | `#F5222D` (ZS-001-09) | 无 |
|
|
||||||
| 激活 | `#F5222D` (ZS-001-09) | `2px solid #F5222D`，宽度与文字齐 |
|
|
||||||
| 失效 | `#C1C1C1` (FS-004-06) | 无 |
|
|
||||||
|
|
||||||
- 字号 `14px Medium`，项间距 `--spacing-5` (24px)，下划线与文字底部间距 `--spacing-2` (8px)
|
|
||||||
- 容器底边叠一条 `1px solid #E8E8E8` (FS-004-04) 基线，激活高亮线压在其上
|
|
||||||
|
|
||||||
#### 11.1.2 纵向页签（下划线 · 纵向）
|
|
||||||
|
|
||||||
| 状态 | 文字 | 右侧指示线 |
|
|
||||||
|------|------|-----------|
|
|
||||||
| 默认 | `#222222` (FS-004) | 无 |
|
|
||||||
| Hover | `#F5222D` (ZS-001-09) | 无 |
|
|
||||||
| 激活 | `#F5222D` (ZS-001-09) | 右侧 `2px solid #F5222D`，高度与文字齐 |
|
|
||||||
| 失效 | `#C1C1C1` (FS-004-06) | 无 |
|
|
||||||
|
|
||||||
- 字号 `14px Medium`，项高度 `32px`，项间距 `--spacing-2` (8px)
|
|
||||||
- 容器右边叠一条 `1px solid #E8E8E8` 基线，激活指示线压在其上
|
|
||||||
|
|
||||||
### 11.2 锚点（Anchor）
|
|
||||||
|
|
||||||
用于长内容页的章节快速跳转，支持一 / 二级缩进。
|
|
||||||
|
|
||||||
```
|
|
||||||
│ 一级
|
|
||||||
│ 一级 (active)
|
|
||||||
│ 二级
|
|
||||||
│ 二级
|
|
||||||
│ 一级
|
|
||||||
│ 一级
|
|
||||||
```
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 左侧基线 | `1px solid #E8E8E8` (FS-004-04) 通栏 |
|
|
||||||
| 项高度 | `32px` |
|
|
||||||
| 一级项左 padding | `--spacing-3` (12px) |
|
|
||||||
| 二级项左 padding | `--spacing-5` (24px) |
|
|
||||||
| 字号 | `14px Regular` |
|
|
||||||
|
|
||||||
| 状态 | 一级文字 | 二级文字 | 左侧指示条 |
|
|
||||||
|------|----------|----------|-----------|
|
|
||||||
| 默认 | `#222222` (FS-004) | `#A6A6A6` (FS-004-07) | 无 |
|
|
||||||
| Hover | `#F5222D` (ZS-001-09) | `#F5222D` (ZS-001-09) | 无 |
|
|
||||||
| 激活 | `#F5222D` (ZS-001-09) | — | 左侧 `2px solid #F5222D`，覆盖容器基线 |
|
|
||||||
|
|
||||||
- 二级项不单独支持激活态：选中二级时其父级一级显示激活态，指示条按父级位置渲染
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
> 返回 [规范目录](README.md)
|
|
||||||
@@ -1,308 +0,0 @@
|
|||||||
# 浅红色 UI 规范 · 四、数据展示
|
|
||||||
|
|
||||||
> 返回 [规范目录](README.md) | 本篇：弹出式窗口 · 卡片 · 折叠面板 · 进度条 · 表格 · 标签 · 时间轴
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 17. 弹出式窗口（Modal / Dialog）
|
|
||||||
|
|
||||||
> 用于聚焦的多步表单 / 确认操作。内部可承载页签、步骤条、表单控件。
|
|
||||||
|
|
||||||
### 17.1 容器规格
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 背景 | `#FFFFFF` (FS-004-01)，圆角 `4px` |
|
|
||||||
| 阴影 | `0 8px 32px rgba(34, 34, 34, 0.16)`（§3.1.3 三级阴影） |
|
|
||||||
| 遮罩层 | `rgba(34, 34, 34, 0.45)`（基于 FS-004） |
|
|
||||||
| 标题区 | 左侧 `3px` 主色红竖条 `#F5222D` + 标题 `16px Bold #222222` |
|
|
||||||
| 关闭按钮 `×` | `#A6A6A6` (FS-004-07)，hover `#F5222D` |
|
|
||||||
| 内边距 | `--spacing-5` (24px) |
|
|
||||||
| 底部操作区 | 右对齐，主按钮在最右（§5.3.4） |
|
|
||||||
|
|
||||||
### 17.2 内部页签与步骤条
|
|
||||||
|
|
||||||
- 顶部页签沿用 §11.1 横向页签（Tab 激活红字 + 红下划线，基线 `#E8E8E8`）。
|
|
||||||
- 步骤条沿用 §10.2 弹窗步骤条（完成态红描边对勾、当前态红实心、未开始灰描边，连接线 `1px dashed`）。
|
|
||||||
|
|
||||||
### 17.3 表单控件补充（Modal 内常用）
|
|
||||||
|
|
||||||
| 控件 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 必填星号 `*` | `#F5222D` (ZS-001-09)，置于 label 前 |
|
|
||||||
| 下拉选择（Select，`请选择 ▾`） | 同输入框（§13），箭头 `#A6A6A6`，聚焦边框 `#F5222D` |
|
|
||||||
| 日期 / 时间选择器（📅） | 输入框 + 日历图标 `#A6A6A6`；区间用"起 至 止"两段 |
|
|
||||||
| 文本区域（Textarea） | 同输入框，`resize: vertical`，最小高度约 `80px` |
|
|
||||||
| 数值 + 单位（如 `100 天`） | 输入框 + 尾部 addon（背景 `#FAFAFA`，边框 `#DBDBDB`，文字 `#575757`） |
|
|
||||||
| 复选框（Checkbox） | 未选边框 `#DBDBDB`；选中背景 `#F5222D` + 对勾 `#FFFFFF` |
|
|
||||||
| 错误态 | 控件边框 `1px solid #F5222D`，下方红色提示文字 `12px #F5222D`（如"输入表单内容报错"） |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 18. 数据展示 · 卡片（Card）
|
|
||||||
|
|
||||||
> 用于陈列结构化信息（人物 / 媒体 / 群组等档案）。在 §3 卡片基础上扩展"分级信息卡片"。
|
|
||||||
|
|
||||||
### 18.1 卡片头部
|
|
||||||
|
|
||||||
| 元素 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 类目竖条（标题前） | `3px` 主色红 `#F5222D` (ZS-001-09) |
|
|
||||||
| 标题（如「个体」「媒体」） | `16px Bold`，`#222222` (FS-004) |
|
|
||||||
| 关闭 `×` | `#A6A6A6` (FS-004-07)，hover `#F5222D` |
|
|
||||||
| 右上操作（查看档案） | 小尺寸主按钮 `#F5222D` + 白字（§5.1 小，含图标） |
|
|
||||||
|
|
||||||
### 18.2 标签 / 属性 Tag
|
|
||||||
|
|
||||||
| 类型 | 背景 | 文字 | 来源 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| 人物属性 / 红色标签 | `#FEEDED` (ZS-001-03) | `#F5222D` (ZS-001-09) | 主色红 |
|
|
||||||
| 立场 / 成功类（绿） | `#EEFCF7` (FS-002-03) | `#189D72` (FS-002-10) | 渐绿系 |
|
|
||||||
| 状态签（右上角强调） | `transparent` | `#F5222D` (ZS-001-09) | 主色红 |
|
|
||||||
| 话题标签（#话题） | `transparent` | `#F5222D` (ZS-001-09) | 主色红，`#` 前缀 |
|
|
||||||
|
|
||||||
- Tag 圆角 `2px`，内边距 `0 8px`，字号 `12px`
|
|
||||||
|
|
||||||
### 18.3 卡片内页签与信息行
|
|
||||||
|
|
||||||
| 元素 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 页签（基本信息 / 线下活动 / 线上发声） | 激活 `#F5222D` + 红下划线；默认 `#222222`（§11.1.1） |
|
|
||||||
| 页签红点提示（•） | `#F5222D` (ZS-001-09)，标识有更新 |
|
|
||||||
| 信息项标签（国家/地区、职务…） | `#A6A6A6` (FS-004-07) |
|
|
||||||
| 信息项取值 | `#222222` (FS-004) |
|
|
||||||
| 来源平台图标（如 Facebook） | 平台原色（蓝 `#0079FE` 近似），不纳入主题强调色 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 19. 数据展示 · 折叠面板（Collapse）
|
|
||||||
|
|
||||||
> 用于长内容的收起 / 展开。含列表概览折叠、带图标折叠、手风琴折叠、信息流折叠四类。
|
|
||||||
|
|
||||||
### 19.1 列表概览折叠（含 + 图标变体）
|
|
||||||
|
|
||||||
| 状态 | 构成 | 配色 |
|
|
||||||
|------|------|------|
|
|
||||||
| 收起 | 标题 + 描述 + 右侧 `▾` | 标题 `#222222` (FS-004)、描述 `#A6A6A6` (FS-004-07)、箭头 `#A6A6A6` |
|
|
||||||
| 展开 | 上述 + 下方内容区 | 内容区背景 `#FAFAFA` (FS-004-02)，箭头旋转为 `^` |
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 容器边框 | `1px solid #DBDBDB` (FS-004-05)，圆角 `4px` |
|
|
||||||
| 头部内边距 | `--spacing-4` (16px) |
|
|
||||||
| 左侧图标（带图标变体） | 占位 `40px`，图标 `#A6A6A6` |
|
|
||||||
|
|
||||||
### 19.2 手风琴折叠（Accordion）
|
|
||||||
|
|
||||||
多面板同列堆叠，同一时刻通常仅展开一项。
|
|
||||||
|
|
||||||
| 元素 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 项分隔 | `1px solid #E8E8E8` (FS-004-04) |
|
|
||||||
| 标题 | `#222222` (FS-004)，前置 `▾ / >` 箭头 `#A6A6A6` |
|
|
||||||
| 收起 / 展开 链接 | 文本按钮 `#F5222D` (ZS-001-09) |
|
|
||||||
| 展开正文 | `#575757` (FS-004-09)，背景 `#FFFFFF` |
|
|
||||||
|
|
||||||
### 19.3 信息流折叠（Feed）
|
|
||||||
|
|
||||||
用于资讯流条目的展开详情。
|
|
||||||
|
|
||||||
| 元素 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 前置「标签」Tag | 背景 `#FEEDED` (ZS-001-03)，文字 `#F5222D` (ZS-001-09) |
|
|
||||||
| 条目标题 | `#222222` (FS-004)，`14px Medium` |
|
|
||||||
| 热度计数（🔥 6405） | 火苗图标 `#FF9900` (FS-001-09)，数字 `#575757` (FS-004-09) |
|
|
||||||
| 收起 / 展开 链接 + 箭头 | `#F5222D` (ZS-001-09) |
|
|
||||||
| 分节标题（【热点首发】/【应对建议】） | `#F5222D` (ZS-001-09)，`Medium` |
|
|
||||||
| 来源 / 作者行（社交媒体 \| 平台 \| @用户） | `#A6A6A6` (FS-004-07) |
|
|
||||||
| 外链 URL | `#0079FE` (ZS-002-09)，hover 下划线 |
|
|
||||||
| 日期 | `#A6A6A6` (FS-004-07) |
|
|
||||||
| 正文 | `#575757` (FS-004-09) |
|
|
||||||
| 缩略图 | 圆角 `2px`，间距 `--spacing-1` (4px) |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 21. 数据展示 · 进度条（Progress）
|
|
||||||
|
|
||||||
### 21.1 标准进度条
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 轨道背景 | `#F5F5F5` (FS-004-03) |
|
|
||||||
| 轨道高度 | `8px`，圆角全圆 |
|
|
||||||
| 已完成段 | 按语义取色（§20）：成功绿 / 失败红 / 警告橙 |
|
|
||||||
| 百分比文字 | `#222222` (FS-004)，置于条右侧 |
|
|
||||||
| 末端状态图标 | 成功 ✓ `#2FD69A`；失败 ✗ `#F5222D`（橙色进行态可不带图标） |
|
|
||||||
|
|
||||||
### 21.2 小型进度条
|
|
||||||
|
|
||||||
放在较窄区域内（如表格单元格）。规格同 §21.1，仅尺寸缩小：
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 轨道高度 | `4px` |
|
|
||||||
| 百分比 / 图标 | 字号缩至 `12px`，图标 `12px` |
|
|
||||||
|
|
||||||
### 21.3 环形进度条
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 轨道环 | `#F5F5F5` (FS-004-03) |
|
|
||||||
| 进度环 | 按语义取色（§20），线宽 `6px`，圆头端点 |
|
|
||||||
| 中心主数字（如 `82.0%`） | `#222222` (FS-004)，D-DIN |
|
|
||||||
| 中心名称 | `12px Regular`，`#A6A6A6` (FS-004-07) |
|
|
||||||
|
|
||||||
> 进度环颜色按阈值映射（如低→绿、中→橙、高→红）由业务自定义，但必须取自 §20 语义色。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 22. 数据展示 · 表格（Table）
|
|
||||||
|
|
||||||
### 22.1 结构规格
|
|
||||||
|
|
||||||
| 属性 | 取值 |
|
|
||||||
|------|------|
|
|
||||||
| 表头背景 | `#FFFFFF`（或浅红 `#FEF6F6` ZS-001-02 强调首行） |
|
|
||||||
| 表头文字 | `14px Medium`，`#222222` (FS-004) |
|
|
||||||
| 单元格文字 | `14px Regular`，`#222222` |
|
|
||||||
| 行高 | `48px` |
|
|
||||||
| 行分隔 | `1px solid #F5F5F5` (FS-004-03) |
|
|
||||||
| 行 Hover | 背景 `#FAFAFA` (FS-004-02) |
|
|
||||||
| 斑马纹（可选） | 偶数行 `#FAFAFA` (FS-004-02) |
|
|
||||||
| 复选框（选中） | 填充 `#F5222D` + 对勾 `#FFFFFF` |
|
|
||||||
|
|
||||||
### 22.2 状态列（圆点 + 文字）
|
|
||||||
|
|
||||||
| 文字 | 圆点色 | 来源 |
|
|
||||||
|------|--------|------|
|
|
||||||
| 普通 | `#2FD69A`（成功绿） | FS-002-09 |
|
|
||||||
| 异常 | `#F5222D`（错误红） | ZS-001-09 |
|
|
||||||
| 特殊 | `#FF9900`（警告橙） | FS-001-09 |
|
|
||||||
|
|
||||||
- 文字统一 `#222222` (FS-004)，圆点直径 `6px`，与文字间距 `--spacing-1` (4px)
|
|
||||||
|
|
||||||
### 22.3 整体状态列（状态标签）
|
|
||||||
|
|
||||||
使用 §23 浅底状态标签：进行中（橙）/ 已完成（绿）/ 已失败（红）。
|
|
||||||
|
|
||||||
### 22.4 操作列
|
|
||||||
|
|
||||||
文本按钮 + 图标，沿用 §5.3.3：查看 / 配置 等均为 `#F5222D` (ZS-001-09)，hover `#CF1322`，按钮间距 `--spacing-3` (12px)。
|
|
||||||
|
|
||||||
### 22.5 单元格内编辑报错
|
|
||||||
|
|
||||||
可编辑单元格（如 `100 [M]`）校验失败：输入框边框 `1px solid #F5222D`，红色气泡提示"Table 内输入报错"（背景 `#F5222D`、白字 `12px`，§12.3 同款）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 23. 数据展示 · 标签（Tag / Badge）
|
|
||||||
|
|
||||||
### 23.1 标签形式
|
|
||||||
|
|
||||||
| 形式 | 用途 | 配色 |
|
|
||||||
|------|------|------|
|
|
||||||
| 文字按钮标签 | 重点突出标记属性 | 三种强度：灰底 `#F5F5F5`/`#575757`；浅红底 `#FEEDED`/`#F5222D`；实红 `#F5222D`/`#FFFFFF` |
|
|
||||||
| 图标 + 文字按钮标签 | 增强辨识度 | 灰底 + 平台原色图标（如 Twitter 蓝）；或实红 `#F5222D` + 白字 + ✓ |
|
|
||||||
| 圆点 + 文字标签 | 属性多 / 复杂、无需突出 | 圆点按语义色（普通绿 / 特殊橙 / 异常红），文字 `#222222` |
|
|
||||||
| 动态标签 | 可增删（筛选列表、关键词） | 已加：灰底 `#F5F5F5` + `×`；新增入口：虚线框 `#DBDBDB` + "+ 标签" |
|
|
||||||
|
|
||||||
- 标签圆角 `2px`，高度 `24px`，内边距 `0 8px`，字号 `12px`
|
|
||||||
|
|
||||||
### 23.2 状态标签（Status Badge）
|
|
||||||
|
|
||||||
四种呈现风格，颜色全部取自 §20 语义状态色：
|
|
||||||
|
|
||||||
| 风格 | 说明 |
|
|
||||||
|------|------|
|
|
||||||
| ① 浅底彩字 | 浅底背景 + 语义文字色（默认推荐，弱干扰） |
|
|
||||||
| ② 实填白字 | 语义实填背景 + 白字（强调态，用于重点状态） |
|
|
||||||
| ③ 图标 + 浅底彩字 | ① 基础上前置语义图标 |
|
|
||||||
| ④ 图标 + 彩字（无底） | 仅图标 + 文字，最轻量 |
|
|
||||||
|
|
||||||
常见状态与语义映射：
|
|
||||||
|
|
||||||
| 状态 | 语义 / 取色 |
|
|
||||||
|------|-------------|
|
|
||||||
| 未开始 / 就绪 | 中性灰 |
|
|
||||||
| 等待中 / 等待 | 信息蓝 |
|
|
||||||
| 进行中 / 进行 | 警告橙 |
|
|
||||||
| 已完成 / 成功 | 成功绿 |
|
|
||||||
| 已失败 / 失败 | 错误红 |
|
|
||||||
| 待更新 / 待更 | 青 |
|
|
||||||
|
|
||||||
- 图标（②④ 风格）：就绪 ⊖、等待 ⊗、进行 🕐、成功 ✓、失败 ✗、待更 🕐，颜色与文字同步
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 24. 数据展示 · 时间轴（Timeline）
|
|
||||||
|
|
||||||
> 用于按时间顺序陈列事件。分纵向（基础 / 卡片 / 长文本）与横向两种主轴方向，另含全局缩略时间轴。
|
|
||||||
|
|
||||||
### 24.1 纵向时间轴点（基础）
|
|
||||||
|
|
||||||
| 元素 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 轴线 | `1px solid #E8E8E8` (FS-004-04) 或虚线 |
|
|
||||||
| 最新 / 当前节点 | 空心红圆环 `2px solid #F5222D` (ZS-001-09)，背景 `#FFFFFF` |
|
|
||||||
| 历史节点 | 实心红点 `#F5222D` (ZS-001-09)，直径 `8px` |
|
|
||||||
| 事件标题 | `14px Medium`，`#222222` (FS-004) |
|
|
||||||
| 时间文字 | `12px Regular`，`#A6A6A6` (FS-004-07) |
|
|
||||||
|
|
||||||
### 24.2 卡片式时间轴点
|
|
||||||
|
|
||||||
节点内容置于浅灰卡片中。
|
|
||||||
|
|
||||||
| 元素 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 卡片背景 | `#FAFAFA` (FS-004-02)，圆角 `4px` |
|
|
||||||
| 卡片内分隔 | `1px solid #E8E8E8` |
|
|
||||||
| 正文标签（如"安全状况："） | `#575757` (FS-004-09) |
|
|
||||||
| 正向取值（如"今日无安全风险"） | `#189D72`（成功绿，FS-002-10） |
|
|
||||||
|
|
||||||
### 24.3 横向长文本时间轴
|
|
||||||
|
|
||||||
横轴双向箭头，节点上下交错分布。
|
|
||||||
|
|
||||||
| 元素 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 主轴线 + 双向箭头 | `#222222` (FS-004) |
|
|
||||||
| 上方节点标记 + 日期 | 红色 `#F5222D` (ZS-001-09)，`▼` 标记 |
|
|
||||||
| 下方节点标记 + 日期 | 橙色 `#FF9900` (FS-001-09)，`▲` 标记 |
|
|
||||||
| 节点正文 | `#575757` (FS-004-09)，`14px Regular` |
|
|
||||||
|
|
||||||
> 上 / 下用红 / 橙双色区分两类事件或交替排布，避免拥挤。
|
|
||||||
|
|
||||||
### 24.4 纵向长文本时间轴
|
|
||||||
|
|
||||||
带头像、状态标签、富文本与附件的纵向时间流。
|
|
||||||
|
|
||||||
| 元素 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 轴线 | `1px dashed #DBDBDB` (FS-004-05) |
|
|
||||||
| 日期分组吸顶标签 | 背景 `#A6A6A6`(FS-004-07) 或 `#F5F5F5`，文字 `#FFFFFF` / `#575757`，圆角 `2px` |
|
|
||||||
| 节点圆点 | 红 `#F5222D`（重点）/ 浅红 `#FCB5B9`（次要） |
|
|
||||||
| 状态标签 | 浅底状态标签：计划（橙 `#FFF6EA`/`#FF9900`）、已成行（红 `#FEEDED`/`#F5222D`）（§23.2 ①） |
|
|
||||||
| 人物名 | `14px Regular`，`#222222` |
|
|
||||||
| 时间 | `12px`，`#A6A6A6` (FS-004-07) |
|
|
||||||
| 正文 | `#575757` (FS-004-09) |
|
|
||||||
| 地址（📍 地址） | 图标 + 文字 `#A6A6A6` |
|
|
||||||
| 缩略图 | 圆角 `2px`，间距 `--spacing-1` (4px) |
|
|
||||||
|
|
||||||
### 24.5 全局时间轴（缩略 / 范围选择）
|
|
||||||
|
|
||||||
页面顶部用于框选时间范围的缩略轴。
|
|
||||||
|
|
||||||
| 元素 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 刻度轴背景 | 灰阶渐变 `linear-gradient(90deg, #7F7F7F, #DBDBDB)`（FS-004-08 → FS-004-05） |
|
|
||||||
| 刻度文字（如 04-03） | `#FFFFFF`，`12px` |
|
|
||||||
| 拖拽游标（handle） | `#FFFFFF` 竖条，带轻微阴影 |
|
|
||||||
| 选区刷选框（brush） | 边框 `1px solid #F5222D`，填充 `rgba(245, 34, 45, 0.08)`（浅红 ZS-001-09 8%） |
|
|
||||||
| 选区内迷你面积图 | 描边 `#F5222D`，填充浅红渐变 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
> 返回 [规范目录](README.md)
|
|
||||||
@@ -1,90 +0,0 @@
|
|||||||
# 浅红色 UI 规范 · 五、图表
|
|
||||||
|
|
||||||
> 返回 [规范目录](README.md) | 本篇：图表通用色序 · 公共元素 · 柱状/折线/甘特/饼环
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 25. 图表（Charts）
|
|
||||||
|
|
||||||
> 图表配色以**柔和色系**为主（保证大面积色块不刺眼），强调线 / 排行榜可叠加主色红渐变。多分类图表的色序按"用几色取几色"，从下表对应行从左到右取用。
|
|
||||||
|
|
||||||
### 25.1 图表通用色序（权威）
|
|
||||||
|
|
||||||
> 如需更多色值，请 UI 设计师按系统整体风格在同色系内扩展。
|
|
||||||
|
|
||||||
| 分类数 | 色序（从左到右） |
|
|
||||||
|--------|------------------|
|
|
||||||
| 三色 | `#FA9196` `#97EBCD` `#80BCFF` |
|
|
||||||
| 四色 | `#FA9196` `#FFCC80` `#97EBCD` `#A2E1F9` |
|
|
||||||
| 五色 | `#FA9196` `#FFCC80` `#97EBCD` `#A2E1F9` `#80BCFF` |
|
|
||||||
| 六色 | `#FA9196` `#FFCC80` `#BAE1B3` `#97EBCD` `#A2E1F9` `#80BCFF` |
|
|
||||||
| 七色 | `#FA9196` `#FCA58F` `#FFCC80` `#BAE1B3` `#97EBCD` `#A2E1F9` `#80BCFF` |
|
|
||||||
| 八色 | `#FA9196` `#FCA58F` `#FDB887` `#FFCC80` `#BAE1B3` `#97EBCD` `#A2E1F9` `#80BCFF` |
|
|
||||||
| 九色 | `#FA9196` `#FCA58F` `#FDB887` `#FFCC80` `#DCD69A` `#BAE1B3` `#97EBCD` `#A2E1F9` `#80BCFF` |
|
|
||||||
| 十色 | `#FA9196` `#FCA58F` `#FDB887` `#FFCC80` `#DCD69A` `#BAE1B3` `#97EBCD` `#9EE4EA` `#A2E1F9` `#80BCFF` |
|
|
||||||
|
|
||||||
- 色值映射：`#FA9196`(ZS-001-06 浅红) / `#FCA58F`·`#FDB887`(橙红过渡) / `#FFCC80`(FS-001-06 浅橙) / `#DCD69A`(黄绿过渡) / `#BAE1B3`·`#97EBCD`(FS-002-06 浅绿) / `#9EE4EA`·`#A2E1F9`(FS-003-06 浅青) / `#80BCFF`(ZS-002-06 浅蓝)
|
|
||||||
- 取色原则：序列从暖（红）到冷（蓝）渐变排布，相邻类别对比清晰
|
|
||||||
|
|
||||||
### 25.2 图表公共元素
|
|
||||||
|
|
||||||
| 元素 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 坐标轴线 | `1px solid #E8E8E8` (FS-004-04) |
|
|
||||||
| 网格线 | `1px dashed #F5F5F5` (FS-004-03) |
|
|
||||||
| 轴刻度文字 | `12px`，`#A6A6A6` (FS-004-07) |
|
|
||||||
| 图例文字 | `12px`，`#575757` (FS-004-09)，前置色块圆角 `2px` |
|
|
||||||
| Tooltip 浮层 | 背景 `rgba(34,34,34,0.85)`（FS-004），文字 `#FFFFFF` `12px`，圆角 `4px` |
|
|
||||||
| 数值标注气泡 | 背景 `#7F7F7F` (FS-004-08)，白字（如悬停值 `59.32`） |
|
|
||||||
| 高亮选区（band） | 填充 `rgba(245,34,45,0.08)`，中线 `1px dashed #F5222D` (ZS-001-09) |
|
|
||||||
|
|
||||||
### 25.3 柱状图（Bar）
|
|
||||||
|
|
||||||
| 形态 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 堆叠柱 / 分组柱 | 各序列按 §25.1 取色（如 Paper 绿 `#97EBCD`、Project 橙 `#FFCC80`、Book 红 `#FA9196`） |
|
|
||||||
| 单序列柱 / 条形 | 主序列 `#FA9196`（浅红） |
|
|
||||||
| 排行榜（TOP 渐变条） | 进度条填充 `linear-gradient(90deg, #F5222D 0%, #FF9900 100%)`（红→橙），轨道 `#F5F5F5`，名称 `#222222`、数值 `#222222` 右对齐 |
|
|
||||||
|
|
||||||
- 柱体圆角 `2px`，柱间距按类目自适应
|
|
||||||
|
|
||||||
### 25.4 折线图（Line / Area）
|
|
||||||
|
|
||||||
| 元素 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 主折线 | `#F5222D` (ZS-001-09)，线宽 `2px` |
|
|
||||||
| 面积填充 | `linear-gradient(180deg, rgba(245,34,45,0.15), rgba(245,34,45,0))` |
|
|
||||||
| 数据点 | 描边 `#F5222D` + 白色填充，悬停放大并实心 |
|
|
||||||
| 多序列线 | 用饱和主色保证细线可辨：红 `#F5222D` / 蓝 `#0079FE` / 橙 `#FF9900` / 绿 `#2FD69A` |
|
|
||||||
| 涨跌双色线 | 上行 `#F5222D`（红）/ 下行 `#2FD69A`（绿） |
|
|
||||||
| 堆叠面积 | 各层按 §25.1 柔和色 + 各自浅色渐变填充 |
|
|
||||||
| 悬停辅助线 + tooltip | 竖虚线 `#F5222D`，tooltip 见 §25.2（如"异常率 12.3%"） |
|
|
||||||
|
|
||||||
### 25.5 甘特图（Gantt）
|
|
||||||
|
|
||||||
| 元素 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 行背景斑马纹 | 浅红 `#FEF6F6` (ZS-001-02) 与 `#FFFFFF` 交替 |
|
|
||||||
| 任务条 | 按 §25.1 取色（每类任务一色），圆角 `2px`，末端可带箭头 |
|
|
||||||
| 网格线 | `1px solid #F5F5F5` (FS-004-03) |
|
|
||||||
| 时间轴 / 月份标签 | `12px`，`#A6A6A6` (FS-004-07) |
|
|
||||||
| 图例 | 圆点 + 文字，圆点取对应任务色，文字 `#575757` |
|
|
||||||
|
|
||||||
### 25.6 饼图 / 环形图（Pie / Donut）
|
|
||||||
|
|
||||||
支持三环至八环（即 3~8 个分类），扇区按 §25.1 对应行取色。
|
|
||||||
|
|
||||||
| 元素 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 扇区 | §25.1 通用色序 |
|
|
||||||
| 中心主数字（如 `34801`） | `#222222` (FS-004)，D-DIN |
|
|
||||||
| 中心说明（XXX总数） | `12px`，`#A6A6A6` (FS-004-07) |
|
|
||||||
| 引导线 + 标签 | 引导线同扇区色，标签文字 `#575757` (FS-004-09)，百分比同行 |
|
|
||||||
| 扇区间隙 | `2px` 白色描边分隔，环宽适中（甜甜圈留中心空 ≥ 50%） |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
> 返回 [规范目录](README.md)
|
|
||||||
@@ -1,121 +0,0 @@
|
|||||||
# 浅红色 UI 规范 · 六、页面与布局
|
|
||||||
|
|
||||||
> 返回 [规范目录](README.md) | 本篇：统计与汇总卡 · 实体卡片 · 综合页面布局示例
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 26. 统计与汇总卡（Dashboard）
|
|
||||||
|
|
||||||
> 仪表盘顶部的指标卡与汇总卡，用于一屏概览关键数据。
|
|
||||||
|
|
||||||
### 26.1 指标卡（已用 / 可用 + 迷你环）
|
|
||||||
|
|
||||||
横向排列的使用率卡，左侧数值、右侧迷你环形进度。
|
|
||||||
|
|
||||||
| 元素 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 卡标题（如"账号使用率"） | `14px Regular`，`#575757` (FS-004-09) |
|
|
||||||
| 主数值（已用，如 `139`） | D-DIN `26px Bold`，`#222222` (FS-004) |
|
|
||||||
| 次数值（可用，如 `2`） | D-DIN，`#FF9900`（警告橙，FS-001-09） |
|
|
||||||
| 数值下标签（已用 / 可用） | `12px`，`#A6A6A6` (FS-004-07) |
|
|
||||||
| 迷你环 + 中心百分比 | 按使用率阈值取语义色（§20）：低→绿、中→橙、高→红；轨道 `#F5F5F5` |
|
|
||||||
| 卡间竖分隔 | `1px solid #E8E8E8` (FS-004-04) |
|
|
||||||
|
|
||||||
### 26.2 汇总卡（总量 + 正常 / 异常 + 环形）
|
|
||||||
|
|
||||||
| 元素 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 总量数值（如 `300`） | D-DIN，`#222222` (FS-004) |
|
|
||||||
| 正常数值（如 `270`） | `#FF9900`（橙）或成功绿，按业务定 |
|
|
||||||
| 异常数值（如 `30`） | `#F5222D`（错误红，ZS-001-09） |
|
|
||||||
| 标签（总量 / 正常 / 异常） | `#575757` (FS-004-09) |
|
|
||||||
| 环形图 | 正常段绿 `#97EBCD`、异常段红 `#FA9196`（§25.1 色序）；中心主数（如 `40%`）`#222222`、说明（异常率）`#A6A6A6` |
|
|
||||||
|
|
||||||
### 26.3 时间范围切换（今日 / 近7日）
|
|
||||||
|
|
||||||
分段选择，沿用 §14.3 按钮式页签：
|
|
||||||
|
|
||||||
| 状态 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 选中（今日） | 背景 `#F5222D` (ZS-001-09)，文字 `#FFFFFF` |
|
|
||||||
| 未选（近7日） | 背景 `#FFFFFF`，边框 `#DBDBDB`，文字 `#222222` |
|
|
||||||
|
|
||||||
### 26.4 资源检索条
|
|
||||||
|
|
||||||
`[资源类型 ▾] [请输入关键词] [搜索]`：下拉 + 输入框沿用 §13；搜索为主按钮（§5.2.1 红）。配合右侧表格（§22），表头含排序箭头（默认 `#A6A6A6`，激活 `#F5222D`）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 27. 实体卡片（列表卡 / 任务集卡）
|
|
||||||
|
|
||||||
> 卡片网格陈列实体（任务集 / 人物 / 项目等），含主数据、属性表、负责人操作按钮与空状态。
|
|
||||||
|
|
||||||
### 27.1 卡片结构
|
|
||||||
|
|
||||||
| 元素 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 卡片背景 / 边框 / 阴影 | `#FFFFFF` / `1px solid #E8E8E8` / §3.1.3 一级阴影，圆角 `4px` |
|
|
||||||
| 主标题（如人名） | `16px Bold`，`#222222` (FS-004) |
|
|
||||||
| 副标题（项目名） | `14px Regular`，`#575757` (FS-004-09) |
|
|
||||||
| 创建时间 | `12px`，`#A6A6A6` (FS-004-07) |
|
|
||||||
| 主指标（目标数量，如 `10247`） | D-DIN `26px Bold`，`#F5222D` (ZS-001-09)；标签"目标数量" `#A6A6A6` |
|
|
||||||
| 属性面板（社交媒体(52)） | 背景 `#FEF6F6` (ZS-001-02)；条目名 `#575757`、数值 `#F5222D` (ZS-001-09) |
|
|
||||||
| 联系/备注行 | `#575757` (FS-004-09)，时间后缀 `#A6A6A6` |
|
|
||||||
| 底部负责人按钮 | 通栏主按钮：背景 `#F5222D`、文字 `#FFFFFF`（§5.2.1） |
|
|
||||||
|
|
||||||
### 27.2 卡片 Hover 操作菜单
|
|
||||||
|
|
||||||
卡片右上 `⋯` 触发**深色下拉**：
|
|
||||||
|
|
||||||
| 元素 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 菜单背景 | `#3D3D3D` (FS-004-10)，圆角 `4px`，阴影 §3.1.3 二级 |
|
|
||||||
| 菜单项（修改 / 删除） | 文字 + 图标 `#FFFFFF`；hover 背景 `rgba(255,255,255,0.1)` |
|
|
||||||
|
|
||||||
### 27.3 空状态（暂无任务）
|
|
||||||
|
|
||||||
| 元素 | 配色 |
|
|
||||||
|------|------|
|
|
||||||
| 空状态插图 / 图标 | 中性灰 `#C1C1C1` (FS-004-06) |
|
|
||||||
| 空状态文字（暂无任务） | `14px`，`#A6A6A6` (FS-004-07) |
|
|
||||||
| 主指标归零 | 数值显示 `0`，颜色同 §27.1（红） |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 28. 综合页面布局示例
|
|
||||||
|
|
||||||
> 标准后台页面 = 顶部红底导航（§7.1）+ 左侧分级侧边栏（§7.3 / §7.6）+ 右侧内容区。
|
|
||||||
|
|
||||||
### 28.1 仪表盘页
|
|
||||||
|
|
||||||
```
|
|
||||||
┌ Header（红底，§7.1）────────────────────────────────────────────┐
|
|
||||||
├──────┬───────────────────────────────────────────────────────────┤
|
|
||||||
│ 侧栏 │ 面包屑（§8.1） │
|
|
||||||
│(§7.3)│ ┌ 指标卡 × N（§26.1，横向等分，竖线分隔）───────────────┐ │
|
|
||||||
│ │ ├ 汇总卡(§26.2) │ 折线图(§25.4) │ 资源表(§22 + 检索§26.4)│ │
|
|
||||||
│ │ └ 异常分布图 … │ │
|
|
||||||
└──────┴───────────────────────────────────────────────────────────┘
|
|
||||||
```
|
|
||||||
|
|
||||||
- 内容区背景 `#FAFAFA` (FS-004-02)，卡片白底浮起；模块间距 `--spacing-5` (24px)，卡内边距 `--spacing-4` (16px)
|
|
||||||
|
|
||||||
### 28.2 列表卡片页
|
|
||||||
|
|
||||||
```
|
|
||||||
┌ Header（红底）─────────────────────────────────────────────────┐
|
|
||||||
├──────┬───────────────────────────────────────────────────────────┤
|
|
||||||
│ 侧栏 │ [搜索框] [搜索] [+ 添加任务集] 排序 [创建时间 ▾]│
|
|
||||||
│ │ ┌实体卡┐ ┌实体卡┐ ┌实体卡┐ ┌实体卡┐ （§27，等宽网格） │
|
|
||||||
│ │ └─────┘ └─────┘ └─────┘ └─────┘ │
|
|
||||||
│ │ ┌实体卡┐ ┌空状态┐ … │
|
|
||||||
└──────┴───────────────────────────────────────────────────────────┘
|
|
||||||
```
|
|
||||||
|
|
||||||
- 卡片网格列间距 / 行间距 `--spacing-5` (24px)
|
|
||||||
- 顶部工具条：搜索输入（§13）+ 搜索主按钮（§5.2.1）+ "添加"主按钮；右侧排序下拉（§13）
|
|
||||||
- "+ 添加任务集"为主按钮（红 `#F5222D` + 白字 + 加号图标，§5.3.2）
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
> 返回 [规范目录](README.md)
|
|
||||||
@@ -1,85 +0,0 @@
|
|||||||
# 浅红色 UI 规范
|
|
||||||
|
|
||||||
浅色主题设计规范：以白 / 浅灰作大面积背景、深色作正文、**红色（`#F5222D`）为品牌强调主色**。
|
|
||||||
|
|
||||||
> 全文按主题拆分为 6 篇，章节号（§1 ~ §28）全局唯一，跨篇引用（如"沿用 §5.2.1"）按下表定位即可。
|
|
||||||
|
|
||||||
## 篇目导航
|
|
||||||
|
|
||||||
| 篇 | 文件 | 内容 |
|
|
||||||
|----|------|------|
|
|
||||||
| 一、基础样式 | [01-基础样式.md](01-基础样式.md) | §1 色彩 · §2 字体 · §3 阴影 · §4 圆角 · §6 间距 · §20 语义状态色 |
|
|
||||||
| 二、按钮与表单 | [02-按钮与表单.md](02-按钮与表单.md) | §5 按钮 · §12 表单 · §13 输入框 · §14 选择按钮 · §15 标签输入框 · §16 上传 |
|
|
||||||
| 三、导航 | [03-导航.md](03-导航.md) | §7 导航组件 · §8 面包屑 · §9 页头与分页 · §10 步骤条 · §11 页签与锚点 |
|
|
||||||
| 四、数据展示 | [04-数据展示.md](04-数据展示.md) | §17 弹窗 · §18 卡片 · §19 折叠面板 · §21 进度条 · §22 表格 · §23 标签 · §24 时间轴 |
|
|
||||||
| 五、图表 | [05-图表.md](05-图表.md) | §25 图表（通用色序 / 柱 / 折线 / 甘特 / 饼环） |
|
|
||||||
| 六、页面与布局 | [06-页面与布局.md](06-页面与布局.md) | §26 统计与汇总卡 · §27 实体卡片 · §28 综合页面布局示例 |
|
|
||||||
|
|
||||||
## 章节速查（§ → 篇）
|
|
||||||
|
|
||||||
| § | 章节 | 所在篇 |
|
|
||||||
|---|------|--------|
|
|
||||||
| 1 | 色彩 | [一](01-基础样式.md) |
|
|
||||||
| 2 | 字体 | [一](01-基础样式.md) |
|
|
||||||
| 3 | 阴影 | [一](01-基础样式.md) |
|
|
||||||
| 4 | 圆角 | [一](01-基础样式.md) |
|
|
||||||
| 5 | 按钮 | [二](02-按钮与表单.md) |
|
|
||||||
| 6 | 间距 | [一](01-基础样式.md) |
|
|
||||||
| 7 | 导航组件 | [三](03-导航.md) |
|
|
||||||
| 8 | 面包屑 | [三](03-导航.md) |
|
|
||||||
| 9 | 页头与分页 | [三](03-导航.md) |
|
|
||||||
| 10 | 步骤条 | [三](03-导航.md) |
|
|
||||||
| 11 | 页签与锚点 | [三](03-导航.md) |
|
|
||||||
| 12 | 表单 | [二](02-按钮与表单.md) |
|
|
||||||
| 13 | 输入框 | [二](02-按钮与表单.md) |
|
|
||||||
| 14 | 选择按钮 | [二](02-按钮与表单.md) |
|
|
||||||
| 15 | 标签输入框 | [二](02-按钮与表单.md) |
|
|
||||||
| 16 | 上传 | [二](02-按钮与表单.md) |
|
|
||||||
| 17 | 弹出式窗口 | [四](04-数据展示.md) |
|
|
||||||
| 18 | 卡片 | [四](04-数据展示.md) |
|
|
||||||
| 19 | 折叠面板 | [四](04-数据展示.md) |
|
|
||||||
| 20 | 语义状态色 | [一](01-基础样式.md) |
|
|
||||||
| 21 | 进度条 | [四](04-数据展示.md) |
|
|
||||||
| 22 | 表格 | [四](04-数据展示.md) |
|
|
||||||
| 23 | 标签 | [四](04-数据展示.md) |
|
|
||||||
| 24 | 时间轴 | [四](04-数据展示.md) |
|
|
||||||
| 25 | 图表 | [五](05-图表.md) |
|
|
||||||
| 26 | 统计与汇总卡 | [六](06-页面与布局.md) |
|
|
||||||
| 27 | 实体卡片 | [六](06-页面与布局.md) |
|
|
||||||
| 28 | 综合页面布局示例 | [六](06-页面与布局.md) |
|
|
||||||
|
|
||||||
## 颜色速查
|
|
||||||
|
|
||||||
完整色板与编号见 [§1 色彩](01-基础样式.md)。最常用的功能色：
|
|
||||||
|
|
||||||
| 角色 | 色值 | 编号 |
|
|
||||||
|------|------|------|
|
|
||||||
| 主色 Primary | `#F5222D` | ZS-001-09 |
|
|
||||||
| 主色 Hover | `#CF1322` | ZS-001 |
|
|
||||||
| 主色 Active | `#A8071A` | ZS-001-11 |
|
|
||||||
| 链接 / 信息 | `#0079FE` | ZS-002-09 |
|
|
||||||
| 正文 | `#222222` | FS-004 |
|
|
||||||
| 次级文字 | `#575757` | FS-004-09 |
|
|
||||||
| 备注 / 占位 | `#A6A6A6` | FS-004-07 |
|
|
||||||
| 禁用文字 | `#C1C1C1` | FS-004-06 |
|
|
||||||
| 页面背景 | `#FAFAFA` | FS-004-02 |
|
|
||||||
| 容器背景 | `#FFFFFF` | FS-004-01 |
|
|
||||||
| 分割线 | `#E8E8E8` | FS-004-04 |
|
|
||||||
|
|
||||||
**语义状态色**（成功 / 警告 / 错误 / 信息 / 待更新 / 中性，详见 [§20](01-基础样式.md)）：
|
|
||||||
|
|
||||||
| 语义 | 文字 | 浅底 | 实填 |
|
|
||||||
|------|------|------|------|
|
|
||||||
| 成功（绿） | `#189D72` | `#EEFCF7` | `#2FD69A` |
|
|
||||||
| 警告（橙） | `#FF9900` | `#FFF6EA` | `#FF9900` |
|
|
||||||
| 错误（红） | `#F5222D` | `#FEEDED` | `#F5222D` |
|
|
||||||
| 信息（蓝） | `#0079FE` | `#EAF4FF` | `#0079FE` |
|
|
||||||
| 待更新（青） | `#45C3F3` | `#EFFAFE` | `#45C3F3` |
|
|
||||||
| 中性（灰） | `#7F7F7F` | `#F5F5F5` | `#A6A6A6` |
|
|
||||||
|
|
||||||
## 通用约定速记
|
|
||||||
|
|
||||||
- **圆角**：按钮 / 输入框 / Tag `2px`；卡片 / 分栏 / Modal `4px`（§4）
|
|
||||||
- **间距阶梯**：4 / 8 / 12 / 16（密）· 24 / 32 / 40 / 56（疏），16 是密的上限、24 是疏的下限（§6）
|
|
||||||
- **按钮尺寸**：小 `24px` / 正常 `32px`（§5.1）
|
|
||||||
- **字体**：中文 Noto Sans S Chinese，数字 D-DIN（§2）
|
|
||||||
@@ -1,14 +0,0 @@
|
|||||||
# 浅红色 UI 规范（已拆分）
|
|
||||||
|
|
||||||
本规范已按主题拆分到文件夹 **[`浅红色UI规范/`](浅红色UI规范/README.md)**，请从目录进入：
|
|
||||||
|
|
||||||
👉 **[浅红色UI规范 / README.md](浅红色UI规范/README.md)**
|
|
||||||
|
|
||||||
| 篇 | 文件 |
|
|
||||||
|----|------|
|
|
||||||
| 一、基础样式（色彩 / 字体 / 阴影 / 圆角 / 间距 / 语义色） | [01-基础样式.md](浅红色UI规范/01-基础样式.md) |
|
|
||||||
| 二、按钮与表单 | [02-按钮与表单.md](浅红色UI规范/02-按钮与表单.md) |
|
|
||||||
| 三、导航 | [03-导航.md](浅红色UI规范/03-导航.md) |
|
|
||||||
| 四、数据展示 | [04-数据展示.md](浅红色UI规范/04-数据展示.md) |
|
|
||||||
| 五、图表 | [05-图表.md](浅红色UI规范/05-图表.md) |
|
|
||||||
| 六、页面与布局 | [06-页面与布局.md](浅红色UI规范/06-页面与布局.md) |
|
|
||||||
@@ -1,148 +0,0 @@
|
|||||||
# 定时任务 — 模板填充「源数据抽取」手工测试清单
|
|
||||||
|
|
||||||
> 覆盖功能：定时任务「模板数据转换器」内置 agent —— 把用户传入的源数据转换成 HTML
|
|
||||||
> 模板的 `DATA` 结构并填充生成可预览页面。**重点测「源数据抽取」**：源可能是
|
|
||||||
> ① 纯 JSON、② 含 JSON 的文本、③ 纯文本，三种形态都要正确处理。
|
|
||||||
>
|
|
||||||
> 测试环境：后端 `http://localhost:8001`（`make dev`），前端 `http://localhost:5174`（`pnpm dev`）。
|
|
||||||
> 相关代码：`deerflow/runtime/scheduler/template_fill.py`（`extract_embedded_json`）、
|
|
||||||
> `service.py`（`_run_template_fill_attempt` / `_build_conversion_prompt`）、
|
|
||||||
> `pages/ScheduledTasksPage.tsx`。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 前置 — 进入表单
|
|
||||||
|
|
||||||
| # | 步骤 | 预期结果 |
|
|
||||||
|---|------|----------|
|
|
||||||
| 0.1 | 任务管理 → 新建定时任务 | 弹出「新建定时任务」对话框 |
|
|
||||||
| 0.2 | 「执行智能体」下拉选择 **模板数据转换器** | 表单出现「HTML 模板」下拉；「必须生成 HTML/Markdown」两个开关隐藏 |
|
|
||||||
| 0.3 | 「HTML 模板」下拉选择 **no.1** | 下方出现「上传 .json」按钮 + 源数据文本框；说明含「未提供源 JSON 时，将直接展示该模板的默认数据」|
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## T1 — 源形态①：纯 JSON
|
|
||||||
|
|
||||||
| # | 步骤 / 输入 | 预期结果 |
|
|
||||||
|---|------|----------|
|
|
||||||
| 1.1 | 在源数据框粘贴纯 JSON（示例见下「样例 A」） | 文本框正常接收，无报错 |
|
|
||||||
| 1.2 | 保存任务 → 「立即执行」 | 执行记录新增一条，状态最终 succeeded |
|
|
||||||
| 1.3 | 打开执行记录 → HTML 预览 | 渲染出 no.1 大屏，**总览指标/各列表数据来自粘贴的 JSON**（而非模板默认值）|
|
|
||||||
| 1.4 | 执行记录正文 | 文案为「已根据源数据填充模板「no.1」生成页面」|
|
|
||||||
|
|
||||||
## T2 — 源形态②：含 JSON 的文本（抽取重点）
|
|
||||||
|
|
||||||
| # | 步骤 / 输入 | 预期结果 |
|
|
||||||
|---|------|----------|
|
|
||||||
| 2.1 | 粘贴「样例 B」（前后是中文说明，中间夹一段 JSON） | 文本框正常接收 |
|
|
||||||
| 2.2 | 保存 → 立即执行 → 查看 HTML | 页面数据以**夹带的 JSON 为准**填充；正文里的补充说明（如「重点突出 X」）被一并参考 |
|
|
||||||
| 2.3 | 验证抽取正确性：JSON 字符串值里含 `}`（如 `"备注": "进度 80%}尚未完成"`） | 不会被误判为 JSON 块提前结束，整段 JSON 被完整抽取 |
|
|
||||||
|
|
||||||
## T3 — 源形态③：纯文本（无 JSON）
|
|
||||||
|
|
||||||
| # | 步骤 / 输入 | 预期结果 |
|
|
||||||
|---|------|----------|
|
|
||||||
| 3.1 | 粘贴「样例 C」（一段纯中文描述，无任何 JSON） | 文本框正常接收 |
|
|
||||||
| 3.2 | 保存 → 立即执行 → 查看 HTML | 智能体**理解文本语义**后据实填充模板，产出完整可预览页面（数据可能较稀疏但结构完整）|
|
|
||||||
| 3.3 | 不应报「未返回 JSON」类硬失败（除非模型彻底失败重试耗尽）| 状态 succeeded |
|
|
||||||
|
|
||||||
## T4 — 空源 → 模板默认数据
|
|
||||||
|
|
||||||
| # | 步骤 | 预期结果 |
|
|
||||||
|---|------|----------|
|
|
||||||
| 4.1 | 源数据框留空，保存 → 立即执行 | **不调用模型**，直接用 no.1 模板自带的默认数据生成 |
|
|
||||||
| 4.2 | 执行记录正文 | 「未提供源数据，已用模板「no.1」的默认数据生成页面」|
|
|
||||||
| 4.3 | HTML 预览 | 展示模板内置的默认大屏 |
|
|
||||||
|
|
||||||
## T5 — 上传 .json 文件
|
|
||||||
|
|
||||||
| # | 步骤 | 预期结果 |
|
|
||||||
|---|------|----------|
|
|
||||||
| 5.1 | 点击「上传 .json 文件」，选一个合法 `.json` | 文件内容被读入源数据文本框 |
|
|
||||||
| 5.2 | 上传一个非法 JSON 内容的文件 | toast 提示「文件不是合法 JSON，已填入文本框请检查」，内容仍填入（可手改）|
|
|
||||||
| 5.3 | 连续上传同一个文件两次 | 第二次仍能触发读取（input 已被重置 value）|
|
|
||||||
|
|
||||||
## T6 — no.2（只展示模板）
|
|
||||||
|
|
||||||
| # | 步骤 | 预期结果 |
|
|
||||||
|---|------|----------|
|
|
||||||
| 6.1 | 「HTML 模板」下拉选 **no.2** | **隐藏**上传按钮与源数据文本框；显示「该模板暂为直接展示已有数据，无需填写」|
|
|
||||||
| 6.2 | 即使之前填过源数据，保存 → 立即执行 | 忽略源数据，**原样输出** no.2 现有页面 |
|
|
||||||
| 6.3 | 执行记录正文 | 「已展示模板「no.2」的现有数据」|
|
|
||||||
|
|
||||||
## T7 — 编辑回显
|
|
||||||
|
|
||||||
| # | 步骤 | 预期结果 |
|
|
||||||
|---|------|----------|
|
|
||||||
| 7.1 | 对已保存的模板任务点「编辑」 | 「执行智能体」「HTML 模板」「源数据」均正确回显 |
|
|
||||||
| 7.2 | 把模板从 no.1 改成 no.2 再保存 | 切到 no.2 时源数据区即时隐藏；保存后执行走只展示分支 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 样例数据（可直接复制粘贴到源数据框）
|
|
||||||
|
|
||||||
### 样例 A — 纯 JSON
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"overview": {
|
|
||||||
"核心指标": [
|
|
||||||
{ "名称": "综合区域", "数值": 7, "单位": "区", "说明": "测试数据" },
|
|
||||||
{ "名称": "组织与单位", "数值": 188, "单位": "个", "说明": "测试数据" }
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"regions": [
|
|
||||||
{ "name": "测试区域甲", "scope": "本岛西岸" }
|
|
||||||
],
|
|
||||||
"equipment": [
|
|
||||||
{ "name_zh": "测试装备X", "category": "无人系统", "status": "列装" }
|
|
||||||
]
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
> 预期：总览第一项「综合区域」显示 **7**，「组织与单位」显示 **188**，区域/装备出现「测试区域甲」「测试装备X」。
|
|
||||||
|
|
||||||
### 样例 B — 含 JSON 的文本
|
|
||||||
|
|
||||||
```
|
|
||||||
这是本月台海态势数据，请据此填充大屏，重点突出离岛防卫：
|
|
||||||
|
|
||||||
{"overview": {"核心指标": [{"名称": "综合区域", "数值": 9, "单位": "区", "说明": "含离岛"}]}, "regions": [{"name": "离岛防区", "scope": "外岛", "备注": "进度 80%}尚未完成"}]}
|
|
||||||
|
|
||||||
以上数据来自 6 月例会，务必准确，不要臆造未提供的字段。
|
|
||||||
```
|
|
||||||
|
|
||||||
> 预期：① 数据以中间 JSON 为准（综合区域=9、出现「离岛防区」）；② 字符串里的 `}`（`进度 80%}`）不破坏抽取；③ 前后的「重点突出离岛防卫」「务必准确」作为补充说明被模型参考。
|
|
||||||
|
|
||||||
### 样例 C — 纯文本
|
|
||||||
|
|
||||||
```
|
|
||||||
请整理一份台湾滨海防卫概览：覆盖本岛沿岸 9 个综合区域，组织与单位约 280 个，
|
|
||||||
装备条目近百项（含无人系统、防空、海军平台等类别），并列出若干关键节点与近期演习。
|
|
||||||
数据以离线知识为准，没有的字段留空即可。
|
|
||||||
```
|
|
||||||
|
|
||||||
> 预期：智能体理解语义后据实填充，产出结构完整的页面（具体数值取决于模型，可较稀疏），不报硬失败。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 后端单元测试（自动化补充）
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# 在 offline-backend-20260512/backend/ 下运行
|
|
||||||
PYTHONPATH=. uv run --no-sync pytest tests/test_template_fill.py -v # 引擎：抽取/校验/填充/注册表
|
|
||||||
PYTHONPATH=. uv run --no-sync pytest tests/test_template_fill_attempt.py -v # 调度器执行分支：三形态/默认/只展示/重试
|
|
||||||
PYTHONPATH=. uv run --no-sync pytest tests/test_template_builder_seed.py -v # 内置 agent 种子
|
|
||||||
```
|
|
||||||
|
|
||||||
抽取相关关键用例：
|
|
||||||
- `test_extract_embedded_json_pure_object` / `_pure_array` —— 纯 JSON。
|
|
||||||
- `test_extract_embedded_json_text_with_json` / `_fenced` —— 含 JSON 的文本 / ```json 围栏。
|
|
||||||
- `test_extract_embedded_json_plain_text_returns_none` —— 纯文本返回 None。
|
|
||||||
- `test_extract_embedded_json_ignores_braces_in_strings` —— 引号内 `}` 不误判。
|
|
||||||
- `test_text_with_embedded_json_surfaced_in_prompt` —— 转换 prompt 单独标注「识别到的结构化数据」。
|
|
||||||
- `test_plain_text_source_converts` —— 纯文本仍照常转换。
|
|
||||||
- `test_empty_source_uses_template_default` —— 空源用模板默认数据。
|
|
||||||
- `test_display_only_template_renders_as_is` —— no.2 原样输出。
|
|
||||||
|
|
||||||
三个文件应全部通过（0 failed）。
|
|
||||||
@@ -1,109 +0,0 @@
|
|||||||
# AI 智能写作 — 手工测试清单
|
|
||||||
|
|
||||||
> 测试环境：后端 `http://localhost:8001`，前端 `http://localhost:5174`
|
|
||||||
> 每项测试前确认后端已启动（`make dev`）、前端已启动（`pnpm dev`）
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## T1 — 启动写作任务
|
|
||||||
|
|
||||||
| # | 步骤 | 预期结果 |
|
|
||||||
|---|------|----------|
|
|
||||||
| 1.1 | 打开 Canvas 页面，点击右上角「AI 写作」按钮 | AIWritingPanel 在右侧展开，显示写作配置表单 |
|
|
||||||
| 1.2 | 填写：意图「新能源汽车市场趋势分析」，类型「分析报告」，目标读者「行业研究人员」，字数「1200」 | 表单验证通过，提交按钮可点击 |
|
|
||||||
| 1.3 | 点击「开始写作」 | 按钮变为 loading 状态；时间轴出现第一条「素材收集专家 · 开始检索素材」进度条目 |
|
|
||||||
| 1.4 | 意图字段留空后点击提交 | 表单校验阻止提交，提示「请填写写作意图」 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## T2 — SSE 进度流（时间轴）
|
|
||||||
|
|
||||||
| # | 步骤 | 预期结果 |
|
|
||||||
|---|------|----------|
|
|
||||||
| 2.1 | 任务启动后观察时间轴 | 每隔几秒新增进度条目，agent_name 标签分别出现「素材收集专家」「作家」「编辑」 |
|
|
||||||
| 2.2 | 打开浏览器 DevTools → Network，过滤 `stream` | 看到一个 `text/event-stream` 请求长连接，持续收到 `data:` 帧 |
|
|
||||||
| 2.3 | 断网 5 秒后恢复 | 面板显示「连接中断」提示（或 error 事件），不崩溃 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## T3 — PAUSE-1 素材确认
|
|
||||||
|
|
||||||
| # | 步骤 | 预期结果 |
|
|
||||||
|---|------|----------|
|
|
||||||
| 3.1 | 等待素材收集专家完成检索，出现 PAUSE-1 干预卡 | 卡片标题「素材确认」，列出 ≥1 条素材，每条有复选框、标题、来源、相关度分数色条 |
|
|
||||||
| 3.2 | 全选所有素材，点击「确认素材，继续写作」 | 干预卡禁用，时间轴新增「作家 · 开始规划大纲」 |
|
|
||||||
| 3.3 | 重新发起任务，PAUSE-1 出现后取消勾选全部素材，点击「重新检索」 | 向后端发送 `action: re_search`；时间轴回到素材收集专家节点重新检索 |
|
|
||||||
| 3.4 | PAUSE-1 出现后填写「追加关键词」输入框（如「锂电池」）并按 Enter，再点「追加搜索」 | 标签出现「锂电池」；后端收到 `action: append_search, extraKeywords: ["锂电池"]` |
|
|
||||||
| 3.5 | 验证相关度色条颜色：分数 ≥0.8 绿色 / 0.5–0.8 橙色 / <0.5 红色 | 三种颜色均可在不同素材中观察到 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## T4 — PAUSE-2 大纲确认
|
|
||||||
|
|
||||||
| # | 步骤 | 预期结果 |
|
|
||||||
|---|------|----------|
|
|
||||||
| 4.1 | PAUSE-2 出现后检查大纲卡 | 显示文章标题 + ≥2 个章节，每节有节标题与要点列表 |
|
|
||||||
| 4.2 | 点击文章标题，内联编辑改为「2025 新能源趋势报告」，按 Enter | 标题实时变更，不刷新页面 |
|
|
||||||
| 4.3 | 展开某章节，点击一条要点，修改文字，按 Blur 失焦 | 要点文字更新 |
|
|
||||||
| 4.4 | 点击「+ 新增章节」，填写章节标题 | 大纲末尾追加新章节 |
|
|
||||||
| 4.5 | 点击「确认大纲，开始写作」 | 编辑后的大纲随 `action: confirm_outline` 提交；时间轴出现「作家 · 开始撰写草稿」 |
|
|
||||||
| 4.6 | PAUSE-2 出现后点击「重新规划大纲」 | 显示意见输入框；填写「请增加政策分析章节」后提交；后端收到 `action: re_outline, outlineFeedback: ...` |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## T5 — PAUSE-3 草稿确认
|
|
||||||
|
|
||||||
| # | 步骤 | 预期结果 |
|
|
||||||
|---|------|----------|
|
|
||||||
| 5.1 | 作家完成草稿，PAUSE-3 出现 | 干预卡显示修改次数（如「第 1 稿」）；右侧 Artifact 面板同步显示 Markdown 草稿内容 |
|
|
||||||
| 5.2 | 点击「定稿，提交编辑审核」 | 进入编辑节点；时间轴出现「编辑 · 开始审核」 |
|
|
||||||
| 5.3 | 点击「提出修改意见」，填写意见后提交 | 作家节点重新生成草稿；修改次数 +1 |
|
|
||||||
| 5.4 | 连续打回 3 次，观察第 4 次 PAUSE-3 | revisionCount 正确递增显示 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## T6 — PAUSE-4 审核结果确认
|
|
||||||
|
|
||||||
| # | 步骤 | 预期结果 |
|
|
||||||
|---|------|----------|
|
|
||||||
| 6.1 | 编辑审核完成，PAUSE-4 出现 | ReviewCard 显示：综合得分、事实/逻辑/语言三项分数、及格线（默认 75）、verdict 徽章（通过=绿 / 打回=红）|
|
|
||||||
| 6.2 | verdict=pass 时，点击「接受审核，定稿」 | 流程结束；时间轴出现「完成」；右侧面板保留最终草稿 |
|
|
||||||
| 6.3 | verdict=reject 时，查看问题列表 | major 问题排在 minor 前；每条显示类别徽章、位置、问题描述、建议 |
|
|
||||||
| 6.4 | verdict=reject 时，点击「强制定稿」 | 向后端发送 `action: force_finalize`；流程结束 |
|
|
||||||
| 6.5 | 添加「额外说明」文字后点击「接受审核，定稿」 | extra_notes 包含在提交的 intervention payload 中（DevTools → Network 验证） |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## T7 — 错误与边界场景
|
|
||||||
|
|
||||||
| # | 步骤 | 预期结果 |
|
|
||||||
|---|------|----------|
|
|
||||||
| 7.1 | 后端未启动时点击「开始写作」 | 面板显示错误提示「无法连接到服务器」，不白屏 |
|
|
||||||
| 7.2 | 写作进行中点击「停止/重置」 | 时间轴清空，表单恢复可编辑，后端流被中断（Network 连接关闭）|
|
|
||||||
| 7.3 | 素材列表为空（后端返回 0 条）时 PAUSE-1 | 干预卡显示「暂无素材」提示，「确认」按钮仍可点击 |
|
|
||||||
| 7.4 | 大纲只有 1 个章节时，点击删除该章节 | 删除按钮禁用或弹出「至少保留一个章节」提示 |
|
|
||||||
| 7.5 | 弱模型返回格式错误的 JSON（手动 mock 后端） | 前端收到 fallback 结构，不崩溃；时间轴正常继续 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## T8 — 跨阶段状态一致性
|
|
||||||
|
|
||||||
| # | 步骤 | 预期结果 |
|
|
||||||
|---|------|----------|
|
|
||||||
| 8.1 | PAUSE-2 时展开大纲卡，刷新页面（F5） | 页面恢复；如写作任务 ID 持久化，状态可恢复（否则回到初始状态，均可接受）|
|
|
||||||
| 8.2 | 同时打开两个浏览器标签，各自启动独立写作任务 | 两个任务互不干扰，各自有独立 task_id |
|
|
||||||
| 8.3 | 完整跑通一次全流程（T1→T2→T3→T4→T5→T6 pass） | 右侧 Artifact 面板显示完整定稿文章，时间轴所有节点状态为「完成」 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 后端单元测试（补充确认）
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# 在 offline-backend-20260512/backend/ 下运行
|
|
||||||
PYTHONPATH=. uv run pytest tests/test_ai_writing_json_parse.py -v # 16 tests
|
|
||||||
PYTHONPATH=. uv run pytest tests/test_ai_writing_graph.py -v # 19 tests
|
|
||||||
```
|
|
||||||
|
|
||||||
两个测试文件均应全部通过（0 failed）。
|
|
||||||
|
|
||||||
npm install @tiptap/core @tiptap/starter-kit @tiptap/extension-underline @tiptap/extension-placeholder
|
|
||||||
+10
-23
@@ -1,25 +1,12 @@
|
|||||||
<!doctype html>
|
<!doctype html>
|
||||||
<html lang="en-US" suppressHydrationWarning>
|
<html lang="en-US">
|
||||||
<head>
|
<head>
|
||||||
<meta charset="UTF-8" />
|
<meta charset="UTF-8" />
|
||||||
<script>
|
|
||||||
(function () {
|
|
||||||
try {
|
|
||||||
var t = localStorage.getItem("strategy-theme");
|
|
||||||
var root = document.documentElement;
|
|
||||||
root.classList.remove("dark", "light");
|
|
||||||
if (t === "light") return;
|
|
||||||
root.classList.add("dark");
|
|
||||||
} catch (e) {}
|
|
||||||
})();
|
|
||||||
</script>
|
|
||||||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||||
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
|
<title>DeerFlow Vite</title>
|
||||||
<title>CM 助手</title>
|
|
||||||
<script src="/runtime-config.js" data-runtime-config></script>
|
|
||||||
</head>
|
</head>
|
||||||
<body>
|
<body>
|
||||||
<div id="root"></div>
|
<div id="root"></div>
|
||||||
<script type="module" src="/src/main.tsx"></script>
|
<script type="module" src="/src/main.tsx"></script>
|
||||||
</body>
|
</body>
|
||||||
</html>
|
</html>
|
||||||
Generated
+152
-1724
File diff suppressed because it is too large.
Load diff
@@ -5,15 +5,9 @@
|
|||||||
"type": "module",
|
"type": "module",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"dev": "vite",
|
"dev": "vite",
|
||||||
"build": "node --max-old-space-size=8192 ./node_modules/vite/bin/vite.js build",
|
"build": "vite build",
|
||||||
"build:sit": "node --max-old-space-size=8192 ./node_modules/vite/bin/vite.js build --mode sit",
|
|
||||||
"build:test": "node --max-old-space-size=8192 ./node_modules/vite/bin/vite.js build --mode test",
|
|
||||||
"build:network": "node --max-old-space-size=8192 ./node_modules/vite/bin/vite.js build --mode network",
|
|
||||||
"preview": "vite preview",
|
"preview": "vite preview",
|
||||||
"typecheck": "tsc --noEmit",
|
"typecheck": "tsc --noEmit"
|
||||||
"test:maf": "vitest run --config vitest.maf.config.ts",
|
|
||||||
"check:chrome109-css": "node scripts/check-chrome109-css.mjs",
|
|
||||||
"check:legacy-chrome-css": "node scripts/check-chrome109-css.mjs"
|
|
||||||
},
|
},
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"@codemirror/lang-css": "^6.3.1",
|
"@codemirror/lang-css": "^6.3.1",
|
||||||
@@ -23,10 +17,6 @@
|
|||||||
"@codemirror/lang-markdown": "^6.5.0",
|
"@codemirror/lang-markdown": "^6.5.0",
|
||||||
"@codemirror/lang-python": "^6.2.1",
|
"@codemirror/lang-python": "^6.2.1",
|
||||||
"@codemirror/language-data": "^6.5.2",
|
"@codemirror/language-data": "^6.5.2",
|
||||||
"@dnd-kit/core": "^6.3.1",
|
|
||||||
"@dnd-kit/sortable": "^10.0.0",
|
|
||||||
"@dnd-kit/utilities": "^3.2.2",
|
|
||||||
"@fontsource/noto-sans-sc": "^5.2.9",
|
|
||||||
"@langchain/core": "^1.1.15",
|
"@langchain/core": "^1.1.15",
|
||||||
"@langchain/langgraph-sdk": "^1.5.3",
|
"@langchain/langgraph-sdk": "^1.5.3",
|
||||||
"@radix-ui/react-avatar": "^1.1.11",
|
"@radix-ui/react-avatar": "^1.1.11",
|
||||||
@@ -47,20 +37,12 @@
|
|||||||
"@radix-ui/react-tooltip": "^1.2.8",
|
"@radix-ui/react-tooltip": "^1.2.8",
|
||||||
"@radix-ui/react-use-controllable-state": "^1.2.2",
|
"@radix-ui/react-use-controllable-state": "^1.2.2",
|
||||||
"@tanstack/react-query": "^5.90.17",
|
"@tanstack/react-query": "^5.90.17",
|
||||||
"@tiptap/core": "^3.23.4",
|
|
||||||
"@tiptap/extension-bubble-menu": "^3.23.4",
|
|
||||||
"@tiptap/extension-placeholder": "^3.23.4",
|
|
||||||
"@tiptap/extension-underline": "^3.23.4",
|
|
||||||
"@tiptap/pm": "^3.23.4",
|
|
||||||
"@tiptap/react": "^3.23.4",
|
|
||||||
"@tiptap/starter-kit": "^3.23.4",
|
|
||||||
"@types/hast": "^3.0.4",
|
"@types/hast": "^3.0.4",
|
||||||
"@uiw/codemirror-theme-basic": "^4.25.4",
|
"@uiw/codemirror-theme-basic": "^4.25.4",
|
||||||
"@uiw/codemirror-theme-monokai": "^4.25.4",
|
"@uiw/codemirror-theme-monokai": "^4.25.4",
|
||||||
"@uiw/react-codemirror": "^4.25.4",
|
"@uiw/react-codemirror": "^4.25.4",
|
||||||
"@xyflow/react": "^12.10.0",
|
"@xyflow/react": "^12.10.0",
|
||||||
"ai": "^6.0.33",
|
"ai": "^6.0.33",
|
||||||
"axios": "1.16.1",
|
|
||||||
"best-effort-json-parser": "^1.2.1",
|
"best-effort-json-parser": "^1.2.1",
|
||||||
"canvas-confetti": "^1.9.4",
|
"canvas-confetti": "^1.9.4",
|
||||||
"class-variance-authority": "^0.7.1",
|
"class-variance-authority": "^0.7.1",
|
||||||
@@ -68,27 +50,20 @@
|
|||||||
"cmdk": "^1.1.1",
|
"cmdk": "^1.1.1",
|
||||||
"codemirror": "^6.0.2",
|
"codemirror": "^6.0.2",
|
||||||
"date-fns": "^4.1.0",
|
"date-fns": "^4.1.0",
|
||||||
"dayjs": "^1.11.21",
|
|
||||||
"dnd-kit": "^0.0.2",
|
|
||||||
"docx": "^9.5.1",
|
|
||||||
"dotenv": "^17.2.3",
|
"dotenv": "^17.2.3",
|
||||||
"embla-carousel-react": "^8.6.0",
|
"embla-carousel-react": "^8.6.0",
|
||||||
"file-saver": "^2.0.5",
|
|
||||||
"gsap": "^3.13.0",
|
"gsap": "^3.13.0",
|
||||||
"hast": "^1.0.0",
|
"hast": "^1.0.0",
|
||||||
"katex": "^0.16.28",
|
"katex": "^0.16.28",
|
||||||
"lucide-react": "^0.562.0",
|
"lucide-react": "^0.562.0",
|
||||||
"mermaid": "^11.15.0",
|
|
||||||
"motion": "^12.26.2",
|
"motion": "^12.26.2",
|
||||||
"nanoid": "^5.1.6",
|
"nanoid": "^5.1.6",
|
||||||
"next-themes": "^0.4.6",
|
"next-themes": "^0.4.6",
|
||||||
"ogl": "^1.0.11",
|
"ogl": "^1.0.11",
|
||||||
"react": "^19.0.0",
|
"react": "^19.0.0",
|
||||||
"react-dom": "^19.0.0",
|
"react-dom": "^19.0.0",
|
||||||
"react-markdown": "^10.1.0",
|
|
||||||
"react-resizable-panels": "^4.4.1",
|
"react-resizable-panels": "^4.4.1",
|
||||||
"react-router-dom": "^7.9.4",
|
"react-router-dom": "^7.9.4",
|
||||||
"react-syntax-highlighter": "^16.1.1",
|
|
||||||
"rehype-katex": "^7.0.1",
|
"rehype-katex": "^7.0.1",
|
||||||
"rehype-raw": "^7.0.0",
|
"rehype-raw": "^7.0.0",
|
||||||
"remark-gfm": "^4.0.1",
|
"remark-gfm": "^4.0.1",
|
||||||
@@ -97,8 +72,6 @@
|
|||||||
"sonner": "^2.0.7",
|
"sonner": "^2.0.7",
|
||||||
"streamdown": "1.4.0",
|
"streamdown": "1.4.0",
|
||||||
"tailwind-merge": "^3.4.0",
|
"tailwind-merge": "^3.4.0",
|
||||||
"tdesign-react": "^1.12.3",
|
|
||||||
"tiptap-markdown": "^0.9.0",
|
|
||||||
"tokenlens": "^1.3.1",
|
"tokenlens": "^1.3.1",
|
||||||
"unist-util-visit": "^5.0.0",
|
"unist-util-visit": "^5.0.0",
|
||||||
"use-stick-to-bottom": "^1.1.1",
|
"use-stick-to-bottom": "^1.1.1",
|
||||||
@@ -107,23 +80,16 @@
|
|||||||
},
|
},
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"@tailwindcss/postcss": "^4.0.15",
|
"@tailwindcss/postcss": "^4.0.15",
|
||||||
"@testing-library/react": "^16.3.2",
|
|
||||||
"@testing-library/user-event": "^14.6.1",
|
|
||||||
"@types/file-saver": "^2.0.7",
|
|
||||||
"@types/gsap": "^3.0.0",
|
"@types/gsap": "^3.0.0",
|
||||||
"@types/node": "^20.14.10",
|
"@types/node": "^20.14.10",
|
||||||
"@types/react": "^19.0.0",
|
"@types/react": "^19.0.0",
|
||||||
"@types/react-dom": "^19.0.0",
|
"@types/react-dom": "^19.0.0",
|
||||||
"@vitejs/plugin-react": "^5.0.4",
|
"@vitejs/plugin-react": "^5.0.4",
|
||||||
"jsdom": "^30.0.1",
|
|
||||||
"lightningcss": "^1.30.2",
|
|
||||||
"postcss": "^8.5.3",
|
"postcss": "^8.5.3",
|
||||||
"tailwindcss": "^4.0.15",
|
"tailwindcss": "^4.0.15",
|
||||||
"tw-animate-css": "^1.4.0",
|
"tw-animate-css": "^1.4.0",
|
||||||
"typescript": "^5.8.2",
|
"typescript": "^5.8.2",
|
||||||
"vite": "^6.0.0",
|
"vite": "^6.0.0"
|
||||||
"vite-plugin-source-identifier": "^1.1.2",
|
|
||||||
"vitest": "^4.1.10"
|
|
||||||
},
|
},
|
||||||
"packageManager": "pnpm@10.26.2"
|
"packageManager": "pnpm@10.26.2"
|
||||||
}
|
}
|
||||||
@@ -1,11 +1,5 @@
|
|||||||
import tailwindcss from "@tailwindcss/postcss";
|
|
||||||
import legacyColorFallback from "./scripts/postcss-legacy-color-fallback.mjs";
|
|
||||||
import lightningCssLegacyChrome from "./scripts/postcss-lightningcss-chrome109.mjs";
|
|
||||||
|
|
||||||
export default {
|
export default {
|
||||||
plugins: [
|
plugins: {
|
||||||
tailwindcss(),
|
"@tailwindcss/postcss": {},
|
||||||
legacyColorFallback(),
|
},
|
||||||
lightningCssLegacyChrome(),
|
|
||||||
],
|
|
||||||
};
|
};
|
||||||
Binary file not shown.
|
Before Width: | Height: | Size: 27 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 27 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 27 KiB |
@@ -1,29 +0,0 @@
|
|||||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="智能助手中心">
|
|
||||||
<defs>
|
|
||||||
<!-- 品牌玫红渐变填充的圆角磁贴 -->
|
|
||||||
<linearGradient id="tile" x1="6" y1="4" x2="58" y2="60" gradientUnits="userSpaceOnUse">
|
|
||||||
<stop stop-color="#FB7185"/>
|
|
||||||
<stop offset="1" stop-color="#E11D48"/>
|
|
||||||
</linearGradient>
|
|
||||||
<!-- 气泡内 AI 闪光星：玫红渐变，与白色气泡形成对比 -->
|
|
||||||
<linearGradient id="spark" x1="24" y1="18" x2="40" y2="36" gradientUnits="userSpaceOnUse">
|
|
||||||
<stop stop-color="#FB7185"/>
|
|
||||||
<stop offset="1" stop-color="#E11D48"/>
|
|
||||||
</linearGradient>
|
|
||||||
</defs>
|
|
||||||
|
|
||||||
<!-- 磁贴背景 -->
|
|
||||||
<rect width="64" height="64" rx="15" fill="url(#tile)"/>
|
|
||||||
|
|
||||||
<!-- 辅助小闪光，点出「多种智能工具」 -->
|
|
||||||
<path fill="#FFFFFF" fill-opacity="0.85"
|
|
||||||
d="M47 43 Q47.6 46.4 50.5 47 Q47.6 47.6 47 51 Q46.4 47.6 43.5 47 Q46.4 46.4 47 43 Z"/>
|
|
||||||
|
|
||||||
<!-- 助手对话气泡（白色）+ 尾巴 -->
|
|
||||||
<rect x="12" y="13" width="40" height="28" rx="10" fill="#FFFFFF"/>
|
|
||||||
<path fill="#FFFFFF" d="M21 40 H31 L19 49 Z"/>
|
|
||||||
|
|
||||||
<!-- 气泡内的 AI 闪光星 -->
|
|
||||||
<path fill="url(#spark)"
|
|
||||||
d="M32 17.5 Q33.2 25.8 41.5 27 Q33.2 28.2 32 36.5 Q30.8 28.2 22.5 27 Q30.8 25.8 32 17.5 Z"/>
|
|
||||||
</svg>
|
|
||||||
|
Before Width: | Height: | Size: 1.2 KiB |
@@ -1,135 +0,0 @@
|
|||||||
// 前端运行时配置文件
|
|
||||||
//
|
|
||||||
// 说明：
|
|
||||||
// 1. 本文件会在打包时原样复制到 dist/runtime-config.js。
|
|
||||||
// 2. 应用启动时会优先读取 window.__CM_RUNTIME_CONFIG__ 里的配置。
|
|
||||||
// 3. 部署后如果需要切换接口地址，直接修改 dist/runtime-config.js 即可，不需要重新 pnpm build。
|
|
||||||
// 4. 这里的默认值来自 .env.network；如某个环境不用某项，可以留空字符串。
|
|
||||||
// 5. 布尔开关也用字符串形式填写："true" / "false"。
|
|
||||||
window.__CM_RUNTIME_CONFIG__ = {
|
|
||||||
// 品牌图片相对路径会以 runtime-config.js 所在目录为基准解析。
|
|
||||||
// Nginx 以子路径部署时不需要修改前端图片路径。
|
|
||||||
// 打包后可直接替换 dist/brand-assets/ 内的同名 PNG。
|
|
||||||
// 也可以把下方图片地址改为其他 PNG 地址，无需重新打包。
|
|
||||||
// 是否显示整块欢迎页图标区域："true" 显示，"false" 隐藏，默认隐藏。
|
|
||||||
VITE_WELCOME_LOGO_VISIBLE: "false",
|
|
||||||
// 深色主题顶栏 Logo 位置："center" 显示在中间，"left" 显示在左上角，默认中间。
|
|
||||||
VITE_DARK_LOGO_POSITION: "center",
|
|
||||||
// 红白主题的顶栏系统 Logo 图片地址。
|
|
||||||
VITE_BRAND_LOGO_LIGHT_URL: "brand-assets/brand-logo-light.png",
|
|
||||||
// 浅蓝主题的顶栏系统 Logo 图片地址。
|
|
||||||
VITE_BRAND_LOGO_LIGHTBLUE_URL: "brand-assets/brand-logo-lightblue.png",
|
|
||||||
// 绿色主题可单独替换 Logo；默认复用浅色 Logo。
|
|
||||||
VITE_BRAND_LOGO_LIGHTGREEN_URL: "brand-assets/brand-logo-light.png",
|
|
||||||
// 深色主题的顶栏系统 Logo 图片地址。
|
|
||||||
VITE_BRAND_LOGO_DARK_URL: "brand-assets/brand-logo-dark.png",
|
|
||||||
// 红白主题的欢迎页 Logo 图片地址：为空时显示原有 CM 文字和渐变背景。
|
|
||||||
VITE_BRAND_WELCOME_LIGHT_URL: "",
|
|
||||||
// 浅蓝主题的欢迎页 Logo 图片地址：为空时显示原有 CM 文字和渐变背景。
|
|
||||||
VITE_BRAND_WELCOME_LIGHTBLUE_URL: "",
|
|
||||||
VITE_BRAND_WELCOME_LIGHTGREEN_URL: "",
|
|
||||||
// 深色主题的欢迎页 Logo 图片地址：为空时显示原有 CM 文字和渐变背景。
|
|
||||||
VITE_BRAND_WELCOME_DARK_URL: "",
|
|
||||||
|
|
||||||
// DeerFlow Gateway 地址：前端自有后端接口，例如 /api/agents、/api/auth、/api/threads 等。
|
|
||||||
// VITE_BACKEND_BASE_URL: "http://10.19.200.5:2026",
|
|
||||||
|
|
||||||
// LangGraph 流式对话接口地址：普通问答、智能体对话等流式能力使用。
|
|
||||||
// VITE_LANGGRAPH_BASE_URL: "http://10.19.200.5:2026/api",
|
|
||||||
|
|
||||||
// Canvas/AI 写作独立 LangGraph 地址：为空时前端会回退使用 VITE_LANGGRAPH_BASE_URL。
|
|
||||||
VITE_CANVAS_LANGGRAPH_BASE_URL: "",
|
|
||||||
|
|
||||||
// routeKey 短路由的用户名直登口令：例如 #/login/admin?routeKey=a。
|
|
||||||
// 填值时优先使用这里的 password；留空时使用 URL 中的 ?password=。
|
|
||||||
VITE_ROUTE_LOGIN_PASSWORD: "",
|
|
||||||
|
|
||||||
// 轻应用「新建笔记」系列接口地址。
|
|
||||||
VITE_NOTE_API_BASE_URL: "http://47.88.25.99:8000",
|
|
||||||
|
|
||||||
// CMZS 后端接口：任务管理、任务分析、三情分析、行动分析等业务接口。
|
|
||||||
VITE_API_BASE_URL: "https://ch1.b.uat.4.cn/zncm",
|
|
||||||
|
|
||||||
// 佳来模型对话接口。
|
|
||||||
VITE_AIPI_CHAT_URL: "https://ch1.b.uat.4.cn/gpt",
|
|
||||||
|
|
||||||
// 多轮检索/生成接口。
|
|
||||||
VITE_AIPI_GENERATE_CHAT_URL: "https://ch1.b.uat.4.cn/jialai_b1_chat",
|
|
||||||
|
|
||||||
// 任务问答接口。
|
|
||||||
VITE_AIPI_TASK_CHAT_URL: "https://ch1.b.uat.4.cn/qq_b1_chat",
|
|
||||||
|
|
||||||
// B 系统知识库前端地址：用于打开知识详情、原文详情等。
|
|
||||||
VITE_AIPI_KNOWLEDGE_URL: "https://chlib.b.uat.4.cn/knowlibrary",
|
|
||||||
|
|
||||||
// B1 COH 系统地址。
|
|
||||||
VITE_AIPI_B1COH_URL: "https://ch1.b.uat.4.cn/web",
|
|
||||||
|
|
||||||
// B2 行为体/网络资源系统地址。
|
|
||||||
VITE_AIPI_B2ACTOR_URL: "https://ty.b.uat.4.cn",
|
|
||||||
|
|
||||||
// B2 网络 XWT iframe 路径。
|
|
||||||
VITE_AIPI_B2ACTOR_XWT_PATH: "/fromB/toXWT?isFrame=1",
|
|
||||||
|
|
||||||
// 知识库 iframe 地址换取接口。
|
|
||||||
VITE_AIPI_KNOWLEDGE_IFRAME_API_URL: "https://ch1.b.uat.4.cn/knowes/api/iframeKnowledgeUrl",
|
|
||||||
|
|
||||||
// 知识库 iframe 皮肤参数。
|
|
||||||
VITE_AIPI_KNOWLEDGE_IFRAME_SKIN: "red",
|
|
||||||
|
|
||||||
// MopeChat 接口地址。
|
|
||||||
VITE_AIPI_MOPECHAT_URL: "https://ch1.b.uat.4.cn/likun_b1_mope",
|
|
||||||
|
|
||||||
// 工作室/空间后端接口：空间列表、空间详情、素材上传等使用。
|
|
||||||
VITE_AIPI_BACKENP_URL: "http://47.88.25.99:8000",
|
|
||||||
|
|
||||||
// 工作室/空间后端别名：兼容旧配置命名，通常与 VITE_AIPI_BACKENP_URL 保持一致。
|
|
||||||
VITE_NOTEBOOK_API_BASE_URL: "http://47.88.25.99:8000",
|
|
||||||
|
|
||||||
// 工作室/空间前端地址：用于 auth/callback、新建对话等跳转。
|
|
||||||
VITE_AIPI_FRONTEND_URL: "http://47.88.25.99:3000",
|
|
||||||
|
|
||||||
// Consumer 接口：深链任务详情 cop-task-detail、研判情报报告 selectSqReport 等使用。
|
|
||||||
VITE_AIPI_CONSUMER_URL: "http://10.19.200.5:8002/consumer",
|
|
||||||
|
|
||||||
// A 系统跳转地址：人物、组织、事件等列表项打开链接使用。
|
|
||||||
VITE_AIPI_PRESENT_URL: "http://present.a.uat.4.cn/present/domain",
|
|
||||||
|
|
||||||
// B 系统 knowes 根地址。
|
|
||||||
VITE_AIPI_KNOWES_URL: "http://ch1.b.uat.4.cn/knowes",
|
|
||||||
|
|
||||||
// MaxKey 鉴权地址：onlineTicket 换 token 使用。
|
|
||||||
VITE_AUTH_BASE_URL: "https://auth.y.uat.4.cn",
|
|
||||||
|
|
||||||
// PG 中任务 iframe 地址。
|
|
||||||
VITE_AIPI_PGLINKTO_URL: "https://pg.b.uat.4.cn",
|
|
||||||
|
|
||||||
// XK 中任务 iframe 地址。
|
|
||||||
VITE_AIPI_XKLINKTO_URL: "https://kz.b.uat.4.cn",
|
|
||||||
|
|
||||||
// 是否使用真实任务看板数据：true=真实接口；false=本地 mock。
|
|
||||||
VITE_USE_REAL_DATA: "true",
|
|
||||||
|
|
||||||
// 登录深链任务详情是否使用本地 mock：false=真实接口；true=本地 mock。
|
|
||||||
VITE_MOCK_COP_TASK_DETAIL: "false",
|
|
||||||
|
|
||||||
// 岗位会商完整演示数据：true=启动时幂等写入后端；后端不可用时直接使用前端 JSON 兜底。
|
|
||||||
// 默认关闭，避免演示历史记录出现在正常生产账号中。
|
|
||||||
VITE_POSITION_ROUNDTABLE_DEMO_MODE: "false",
|
|
||||||
// 纯前端岗位分析演示：跳过登录，直接进入岗位分析页，并禁止所有后台请求。
|
|
||||||
// 仅用于离线展台/演示环境，生产环境必须保持 false。
|
|
||||||
VITE_POSITION_ROUNDTABLE_STANDALONE_MODE: "false",
|
|
||||||
|
|
||||||
// 大屏绘制 selectSqReport 是否使用本地 mock：不在运行时强制覆盖，
|
|
||||||
// 由各环境的 .env 文件决定（开发环境为 true，生产环境为 false）。
|
|
||||||
|
|
||||||
// 静态站点模式开关；一般部署业务系统时保持 false。
|
|
||||||
VITE_STATIC_WEBSITE_ONLY: "false",
|
|
||||||
|
|
||||||
// 紧凑导航开关：true 时固定使用简洁布局，工作台左侧栏收起为菜单图标，
|
|
||||||
// 隐藏系统 Logo、换肤按钮以及“全量/简洁模式”切换。修改后刷新页面即可生效。
|
|
||||||
VITE_FORCE_COLLAPSED_SIDEBAR: "false",
|
|
||||||
|
|
||||||
// GitHub OAuth Token；不使用 GitHub 相关能力时留空。
|
|
||||||
VITE_GITHUB_OAUTH_TOKEN: "",
|
|
||||||
};
|
|
||||||
@@ -1,109 +0,0 @@
|
|||||||
import fs from "node:fs";
|
|
||||||
import path from "node:path";
|
|
||||||
import postcss from "postcss";
|
|
||||||
|
|
||||||
const unsupportedColor = /(?:color-mix|oklch|oklab|lab|lch)\(/i;
|
|
||||||
const assetsDir = path.resolve("dist/assets");
|
|
||||||
|
|
||||||
if (!fs.existsSync(assetsDir)) {
|
|
||||||
throw new Error("dist/assets 不存在，请先运行 pnpm build");
|
|
||||||
}
|
|
||||||
|
|
||||||
const cssFiles = fs
|
|
||||||
.readdirSync(assetsDir)
|
|
||||||
.filter((file) => file.endsWith(".css"));
|
|
||||||
|
|
||||||
if (cssFiles.length === 0) {
|
|
||||||
throw new Error("dist/assets 中没有 CSS 构建产物");
|
|
||||||
}
|
|
||||||
|
|
||||||
const failures = [];
|
|
||||||
let modernDeclarations = 0;
|
|
||||||
|
|
||||||
const requiredLegacyFallbacks = [
|
|
||||||
{
|
|
||||||
file: "src/components/ui/textarea.tsx",
|
|
||||||
pattern: /rows=\{rows\s*\?\?\s*3\}/,
|
|
||||||
description: "Textarea needs a native rows fallback",
|
|
||||||
},
|
|
||||||
{
|
|
||||||
file: "src/components/ai-elements/prompt-input.tsx",
|
|
||||||
pattern: /<InputGroup className="h-auto min-h-16">/,
|
|
||||||
description: "Prompt textarea must not rely on :has() for its parent height",
|
|
||||||
},
|
|
||||||
];
|
|
||||||
|
|
||||||
for (const file of cssFiles) {
|
|
||||||
const root = postcss.parse(
|
|
||||||
fs.readFileSync(path.join(assetsDir, file), "utf8"),
|
|
||||||
{ from: file },
|
|
||||||
);
|
|
||||||
|
|
||||||
root.walkDecls((declaration) => {
|
|
||||||
if (!unsupportedColor.test(declaration.value)) return;
|
|
||||||
modernDeclarations += 1;
|
|
||||||
|
|
||||||
let ancestor = declaration.parent;
|
|
||||||
while (ancestor) {
|
|
||||||
if (
|
|
||||||
ancestor.type === "atrule" &&
|
|
||||||
ancestor.name === "supports" &&
|
|
||||||
unsupportedColor.test(ancestor.params)
|
|
||||||
) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
ancestor = ancestor.parent;
|
|
||||||
}
|
|
||||||
|
|
||||||
let previous = declaration.prev();
|
|
||||||
while (previous?.type === "comment") previous = previous.prev();
|
|
||||||
const hasSafeFallback =
|
|
||||||
!declaration.prop.startsWith("--") &&
|
|
||||||
previous?.type === "decl" &&
|
|
||||||
previous.prop === declaration.prop &&
|
|
||||||
!unsupportedColor.test(previous.value);
|
|
||||||
|
|
||||||
if (!hasSafeFallback) {
|
|
||||||
failures.push(
|
|
||||||
`${file}:${declaration.source?.start?.line ?? "?"} ${declaration.prop}: ${declaration.value}`,
|
|
||||||
);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
function walk(directory) {
|
|
||||||
return fs.readdirSync(directory, { withFileTypes: true }).flatMap((entry) => {
|
|
||||||
const fullPath = path.join(directory, entry.name);
|
|
||||||
return entry.isDirectory() ? walk(fullPath) : [fullPath];
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
for (const file of walk(path.resolve("src"))) {
|
|
||||||
if (!/\.[jt]sx?$/.test(file)) continue;
|
|
||||||
const source = fs.readFileSync(file, "utf8");
|
|
||||||
if (unsupportedColor.test(source)) {
|
|
||||||
failures.push(
|
|
||||||
`${path.relative(process.cwd(), file)} contains a runtime-only modern color function`,
|
|
||||||
);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
for (const fallback of requiredLegacyFallbacks) {
|
|
||||||
const source = fs.readFileSync(path.resolve(fallback.file), "utf8");
|
|
||||||
if (!fallback.pattern.test(source)) {
|
|
||||||
failures.push(`${fallback.file}: ${fallback.description}`);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if (failures.length > 0) {
|
|
||||||
console.error("Legacy Chrome CSS compatibility check failed:\n");
|
|
||||||
console.error(failures.slice(0, 50).join("\n"));
|
|
||||||
if (failures.length > 50) {
|
|
||||||
console.error(`... and ${failures.length - 50} more`);
|
|
||||||
}
|
|
||||||
process.exit(1);
|
|
||||||
}
|
|
||||||
|
|
||||||
console.log(
|
|
||||||
`Legacy Chrome (100+) CSS compatibility check passed (${modernDeclarations} guarded modern declarations).`,
|
|
||||||
);
|
|
||||||
@@ -1,70 +0,0 @@
|
|||||||
/**
|
|
||||||
* Tailwind 4 gracefully falls back from color-mix() to the base semantic
|
|
||||||
* color, but that turns utilities such as bg-primary/5 into an opaque fill on
|
|
||||||
* Chrome 109. Replace that fallback with an sRGB-channel based alpha color.
|
|
||||||
* The modern color-mix() declaration remains in its @supports block.
|
|
||||||
*/
|
|
||||||
|
|
||||||
const LEGACY_RGB_TOKENS = new Set([
|
|
||||||
"accent",
|
|
||||||
"background",
|
|
||||||
"border",
|
|
||||||
"brand-200",
|
|
||||||
"card",
|
|
||||||
"destructive",
|
|
||||||
"foreground",
|
|
||||||
"input",
|
|
||||||
"muted",
|
|
||||||
"muted-foreground",
|
|
||||||
"primary",
|
|
||||||
"primary-foreground",
|
|
||||||
"ring",
|
|
||||||
"secondary",
|
|
||||||
"sidebar-accent",
|
|
||||||
"sidebar-border",
|
|
||||||
"sidebar-foreground",
|
|
||||||
"workspace-brand",
|
|
||||||
]);
|
|
||||||
|
|
||||||
const TRANSPARENT_MIX_RE =
|
|
||||||
/color-mix\(\s*in\s+[\w-]+\s*,\s*var\(--([\w-]+)\)\s+([\d.]+)%\s*,\s*transparent\s*\)/i;
|
|
||||||
|
|
||||||
function legacyAlphaColor(value) {
|
|
||||||
const match = value.match(TRANSPARENT_MIX_RE);
|
|
||||||
if (!match || !LEGACY_RGB_TOKENS.has(match[1])) return null;
|
|
||||||
|
|
||||||
const [, token, percentage] = match;
|
|
||||||
return `rgb(var(--legacy-${token}-rgb) / ${percentage}%)`;
|
|
||||||
}
|
|
||||||
|
|
||||||
export default function legacyColorFallback() {
|
|
||||||
return {
|
|
||||||
postcssPlugin: "postcss-legacy-color-fallback",
|
|
||||||
OnceExit(root) {
|
|
||||||
root.walkAtRules("supports", (atRule) => {
|
|
||||||
if (!atRule.params.includes("color-mix")) return;
|
|
||||||
|
|
||||||
atRule.walkDecls((modernDeclaration) => {
|
|
||||||
const fallbackValue = legacyAlphaColor(modernDeclaration.value);
|
|
||||||
if (!fallbackValue) return;
|
|
||||||
|
|
||||||
// Tailwind emits the old-browser declaration immediately before
|
|
||||||
// the nested @supports block, in the same utility/variant rule.
|
|
||||||
let fallbackDeclaration = atRule.prev();
|
|
||||||
while (fallbackDeclaration?.type === "comment") {
|
|
||||||
fallbackDeclaration = fallbackDeclaration.prev();
|
|
||||||
}
|
|
||||||
|
|
||||||
if (
|
|
||||||
fallbackDeclaration?.type === "decl" &&
|
|
||||||
fallbackDeclaration.prop === modernDeclaration.prop
|
|
||||||
) {
|
|
||||||
fallbackDeclaration.value = fallbackValue;
|
|
||||||
}
|
|
||||||
});
|
|
||||||
});
|
|
||||||
},
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
legacyColorFallback.postcss = true;
|
|
||||||
@@ -1,33 +0,0 @@
|
|||||||
import postcss from "postcss";
|
|
||||||
import { transform } from "lightningcss";
|
|
||||||
|
|
||||||
const LEGACY_CHROME = 100 << 16;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Keep Vite's PostCSS pipeline (required by Tailwind 4), then compile the
|
|
||||||
* resulting CSS to Chrome 100-compatible syntax for both dev and production.
|
|
||||||
*/
|
|
||||||
export default function lightningCssLegacyChrome() {
|
|
||||||
return {
|
|
||||||
postcssPlugin: "postcss-lightningcss-legacy-chrome",
|
|
||||||
OnceExit(root, { result }) {
|
|
||||||
const filename = root.source?.input.file ?? result.opts.from ?? "style.css";
|
|
||||||
const output = transform({
|
|
||||||
filename,
|
|
||||||
code: Buffer.from(root.toString()),
|
|
||||||
targets: { chrome: LEGACY_CHROME },
|
|
||||||
minify: false,
|
|
||||||
});
|
|
||||||
const compiled = postcss.parse(output.code.toString(), { from: filename });
|
|
||||||
|
|
||||||
root.removeAll();
|
|
||||||
root.append(compiled.nodes);
|
|
||||||
|
|
||||||
for (const warning of output.warnings) {
|
|
||||||
result.warn(warning.message, { plugin: "lightningcss" });
|
|
||||||
}
|
|
||||||
},
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
lightningCssLegacyChrome.postcss = true;
|
|
||||||
+106
-152
@@ -1,198 +1,152 @@
|
|||||||
import { useEffect, useMemo } from "react";
|
import { useMemo } from "react";
|
||||||
import { Navigate, Route, Routes } from "react-router-dom";
|
import { Navigate, Route, Routes } from "react-router-dom";
|
||||||
import { ThemeProvider as NextThemesProvider } from "next-themes";
|
import { ThemeProvider as NextThemesProvider } from "next-themes";
|
||||||
|
|
||||||
import { DesensitizeWordsLoader } from "@/components/desensitize-words-loader";
|
|
||||||
import { FontScaleApplier } from "@/components/font-scale";
|
|
||||||
import { QueryClientProvider } from "@/components/query-client-provider";
|
import { QueryClientProvider } from "@/components/query-client-provider";
|
||||||
import { AuthSyncWatcher } from "@/core/auth/sync";
|
import { SidebarInset, SidebarProvider } from "@/components/ui/sidebar";
|
||||||
|
import { PromptInputProvider } from "@/components/ai-elements/prompt-input";
|
||||||
|
import { WorkspaceSidebar } from "@/components/workspace/workspace-sidebar";
|
||||||
|
import { CommandPalette } from "@/components/workspace/command-palette";
|
||||||
|
import { Toaster } from "sonner";
|
||||||
import { I18nProvider } from "@/core/i18n/context";
|
import { I18nProvider } from "@/core/i18n/context";
|
||||||
import { fetchYLogConfig } from "@/core/log/y-log-config";
|
|
||||||
import { detectLocale } from "@/core/i18n/locale";
|
import { detectLocale } from "@/core/i18n/locale";
|
||||||
import { resolveForcedThemeForPath } from "@/core/page-layout/chats-iframe-route";
|
import { SubtasksProvider } from "@/core/tasks/context";
|
||||||
import { ChatProvider } from "@/contexts/ChatContext";
|
import { ArtifactsProvider } from "@/components/workspace/artifacts";
|
||||||
import { ThemeProvider } from "@/contexts/ThemeContext";
|
|
||||||
import {
|
|
||||||
resolveEmbedRoundtableTheme,
|
|
||||||
resolveEmbedTheme,
|
|
||||||
} from "@/core/embed/params";
|
|
||||||
import { usePublicEmbedTheme } from "@/core/embed/background";
|
|
||||||
import { readWujieProps } from "@/core/embed/wujie";
|
|
||||||
import {
|
|
||||||
resolveForcedEmbedTheme,
|
|
||||||
syncEmbedSessionFromSearch,
|
|
||||||
} from "@/core/embed/embed-session";
|
|
||||||
|
|
||||||
import { HashRouter, useLocation } from "react-router-dom";
|
import { HashRouter, useLocation } from "react-router-dom";
|
||||||
|
|
||||||
import LandingPage from "./pages/LandingPage";
|
import LandingPage from "./pages/LandingPage";
|
||||||
|
import ChatsPage from "./pages/ChatsPage";
|
||||||
|
import ChatPage from "./pages/ChatPage";
|
||||||
|
import AgentsPage from "./pages/AgentsPage";
|
||||||
|
import AgentChatPage from "./pages/AgentChatPage";
|
||||||
|
import NewAgentPage from "./pages/NewAgentPage";
|
||||||
import LoginPage from "./pages/LoginPage";
|
import LoginPage from "./pages/LoginPage";
|
||||||
import PageRoutes from "./pages/PageRoutes";
|
import ScheduledTaskRunDetailPage from "./pages/ScheduledTaskRunDetailPage";
|
||||||
import PublicScheduledTaskPage, {
|
import ScheduledTasksPage from "./pages/ScheduledTasksPage";
|
||||||
PublicScheduledTaskFullscreenPage,
|
|
||||||
} from "./pages/PublicScheduledTaskPage";
|
|
||||||
import PublicSharePage from "./pages/PublicSharePage";
|
|
||||||
import PublicLeaderboardPage from "./pages/PublicLeaderboardPage";
|
|
||||||
import PublicRoundtableSharePage from "./pages/PublicRoundtableSharePage";
|
|
||||||
import EmbedChatPage from "./pages/EmbedChatPage";
|
|
||||||
import EmbedRoundtablePage from "./pages/EmbedRoundtablePage";
|
|
||||||
import DashboardStandalonePage from "@/roundtable-planning/pages/DashboardStandalonePage";
|
|
||||||
import PositionRoundtablePage from "@/position-roundtable/pages/PositionRoundtablePage";
|
|
||||||
import {
|
|
||||||
isPositionRoundtableStandaloneMode,
|
|
||||||
POSITION_ROUNDTABLE_ROUTE,
|
|
||||||
} from "@/position-roundtable/demo/position-roundtable-demo-config";
|
|
||||||
import { ChatRuntime } from "./pages/WorkspaceRoutes";
|
|
||||||
import { NotFoundPage } from "./pages/NotFoundPage";
|
import { NotFoundPage } from "./pages/NotFoundPage";
|
||||||
|
|
||||||
const PUBLIC_EMBED_PREFIXES = ["/share/", "/public/", "/roundtable-share/"];
|
|
||||||
|
|
||||||
function AppProviders({ children }: { children: React.ReactNode }) {
|
function AppProviders({ children }: { children: React.ReactNode }) {
|
||||||
const locale = useMemo(() => detectLocale(), []);
|
const locale = useMemo(() => detectLocale(), []);
|
||||||
const location = useLocation();
|
const location = useLocation();
|
||||||
const publicEmbedTheme = usePublicEmbedTheme();
|
const forcedTheme = location.pathname === "/landing" ? "dark" : undefined;
|
||||||
const positionStandaloneMode = isPositionRoundtableStandaloneMode();
|
|
||||||
// iframe 嵌入会话（按标签页 sessionStorage）集中在此同步：任何带 `&embed=1` 的入口（深链登录页
|
|
||||||
// 或直接深链路由）一进来就启用、`embed=0` 关闭，后续干净路由靠会话维持去 chrome + 强制主题。
|
|
||||||
useEffect(() => {
|
|
||||||
syncEmbedSessionFromSearch(location.search);
|
|
||||||
}, [location.search]);
|
|
||||||
// 操作日志(Y-Log)：启动早期预热上报配置，使 writeYLog 同步读缓存即可工作
|
|
||||||
// （刷新后 module 缓存清空，token 登录用户也能继续上报）。失败静默。
|
|
||||||
useEffect(() => {
|
|
||||||
if (positionStandaloneMode) return;
|
|
||||||
void fetchYLogConfig();
|
|
||||||
}, [positionStandaloneMode]);
|
|
||||||
const forcedTheme = useMemo(() => {
|
|
||||||
// iframe 嵌入模式（外部系统 `&embed=1`）最高优先：按本标签页的嵌入主题强制明/暗。
|
|
||||||
// 走 next-themes forcedTheme（不写 localStorage）→ 同浏览器另开的正常系统页不受影响。
|
|
||||||
const embedTheme = resolveForcedEmbedTheme(location.search);
|
|
||||||
if (embedTheme) return embedTheme;
|
|
||||||
const routeTheme = resolveForcedThemeForPath(
|
|
||||||
location.pathname,
|
|
||||||
location.search,
|
|
||||||
);
|
|
||||||
if (routeTheme) return routeTheme;
|
|
||||||
if (location.pathname === "/embed/roundtable") {
|
|
||||||
const wp = readWujieProps();
|
|
||||||
const raw =
|
|
||||||
(typeof wp.theme === "string" && wp.theme.trim()) ||
|
|
||||||
new URLSearchParams(location.search).get("theme")?.trim() ||
|
|
||||||
"dark";
|
|
||||||
return resolveEmbedRoundtableTheme(raw);
|
|
||||||
}
|
|
||||||
if (location.pathname.startsWith("/embed/chats")) {
|
|
||||||
const raw = new URLSearchParams(location.search).get("theme")?.trim();
|
|
||||||
return raw ? resolveEmbedTheme(raw) : undefined;
|
|
||||||
}
|
|
||||||
if (PUBLIC_EMBED_PREFIXES.some((p) => location.pathname.startsWith(p))) {
|
|
||||||
return publicEmbedTheme;
|
|
||||||
}
|
|
||||||
return undefined;
|
|
||||||
}, [location.pathname, location.search, publicEmbedTheme]);
|
|
||||||
|
|
||||||
return (
|
return (
|
||||||
<NextThemesProvider
|
<NextThemesProvider
|
||||||
attribute="class"
|
attribute="class"
|
||||||
storageKey="strategy-theme"
|
enableSystem
|
||||||
defaultTheme="light"
|
|
||||||
themes={["light", "dark", "lightblue", "lightgreen", "iceblue", "lightyellow"]}
|
|
||||||
enableSystem={false}
|
|
||||||
disableTransitionOnChange
|
disableTransitionOnChange
|
||||||
forcedTheme={forcedTheme}
|
forcedTheme={forcedTheme}
|
||||||
>
|
>
|
||||||
<QueryClientProvider>
|
<I18nProvider initialLocale={locale}>
|
||||||
<I18nProvider initialLocale={locale}>
|
<QueryClientProvider>{children}</QueryClientProvider>
|
||||||
<ThemeProvider>
|
</I18nProvider>
|
||||||
<ChatProvider>
|
|
||||||
{!positionStandaloneMode && <AuthSyncWatcher />}
|
|
||||||
{!positionStandaloneMode && <DesensitizeWordsLoader />}
|
|
||||||
<FontScaleApplier />
|
|
||||||
{children}
|
|
||||||
</ChatProvider>
|
|
||||||
</ThemeProvider>
|
|
||||||
</I18nProvider>
|
|
||||||
</QueryClientProvider>
|
|
||||||
</NextThemesProvider>
|
</NextThemesProvider>
|
||||||
);
|
);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
function WorkspaceLayout({ children }: { children: React.ReactNode }) {
|
||||||
* 根路由 `/` → `/login` 重定向，**保留 query string**。
|
return (
|
||||||
* 外部系统的任务深链落在 `#/?taskId=...&goPath=...`，裸 `<Navigate to="/login">` 会丢掉
|
<SidebarProvider className="h-screen" defaultOpen>
|
||||||
* query，导致 LoginPage 读不到参数；这里把 search 一并带过去。
|
<WorkspaceSidebar />
|
||||||
*/
|
<SidebarInset className="min-w-0">{children}</SidebarInset>
|
||||||
function RootRedirect() {
|
<CommandPalette />
|
||||||
const { search } = useLocation();
|
<Toaster position="top-center" />
|
||||||
if (isPositionRoundtableStandaloneMode()) {
|
</SidebarProvider>
|
||||||
return <Navigate to={POSITION_ROUNDTABLE_ROUTE} replace />;
|
);
|
||||||
}
|
}
|
||||||
return <Navigate to={`/login${search}`} replace />;
|
|
||||||
|
function ChatRuntime({ children }: { children: React.ReactNode }) {
|
||||||
|
return (
|
||||||
|
<SubtasksProvider>
|
||||||
|
<ArtifactsProvider>
|
||||||
|
<PromptInputProvider>{children}</PromptInputProvider>
|
||||||
|
</ArtifactsProvider>
|
||||||
|
</SubtasksProvider>
|
||||||
|
);
|
||||||
}
|
}
|
||||||
|
|
||||||
export function App() {
|
export function App() {
|
||||||
const positionStandaloneMode = isPositionRoundtableStandaloneMode();
|
|
||||||
const standaloneLoginRedirect = (
|
|
||||||
<Navigate to={POSITION_ROUNDTABLE_ROUTE} replace />
|
|
||||||
);
|
|
||||||
const pageElement = positionStandaloneMode ? (
|
|
||||||
<ChatRuntime>
|
|
||||||
<PositionRoundtablePage compactChrome />
|
|
||||||
</ChatRuntime>
|
|
||||||
) : (
|
|
||||||
<PageRoutes />
|
|
||||||
);
|
|
||||||
|
|
||||||
return (
|
return (
|
||||||
<HashRouter>
|
<HashRouter>
|
||||||
<AppProviders>
|
<AppProviders>
|
||||||
<Routes>
|
<Routes>
|
||||||
<Route path="/" element={<RootRedirect />} />
|
<Route path="/" element={<Navigate to="/login" replace />} />
|
||||||
<Route
|
<Route path="/login" element={<LoginPage />} />
|
||||||
path="/login"
|
<Route path="/login/:username" element={<LoginPage />} />
|
||||||
element={positionStandaloneMode ? standaloneLoginRedirect : <LoginPage />}
|
|
||||||
/>
|
|
||||||
<Route
|
|
||||||
path="/login/:username"
|
|
||||||
element={positionStandaloneMode ? standaloneLoginRedirect : <LoginPage />}
|
|
||||||
/>
|
|
||||||
<Route path="/landing" element={<LandingPage />} />
|
<Route path="/landing" element={<LandingPage />} />
|
||||||
<Route path="/share/:shareCode" element={<PublicSharePage />} />
|
|
||||||
<Route path="/public/leaderboard" element={<PublicLeaderboardPage />} />
|
|
||||||
<Route
|
<Route
|
||||||
path="/roundtable-share/:shareCode"
|
path="/workspace"
|
||||||
element={<PublicRoundtableSharePage view="landing" />}
|
element={<Navigate to="/workspace/chats/new" replace />}
|
||||||
/>
|
/>
|
||||||
<Route
|
<Route
|
||||||
path="/roundtable-share/:shareCode/report"
|
path="/workspace/chats"
|
||||||
element={<PublicRoundtableSharePage view="report" />}
|
|
||||||
/>
|
|
||||||
<Route
|
|
||||||
path="/roundtable-share/:shareCode/dashboard"
|
|
||||||
element={<PublicRoundtableSharePage view="dashboard" />}
|
|
||||||
/>
|
|
||||||
<Route
|
|
||||||
path="/public/scheduled-tasks/:taskId"
|
|
||||||
element={<PublicScheduledTaskPage />}
|
|
||||||
/>
|
|
||||||
<Route
|
|
||||||
path="/public/scheduled-tasks/:taskId/runs/:runId/fullscreen"
|
|
||||||
element={<PublicScheduledTaskFullscreenPage />}
|
|
||||||
/>
|
|
||||||
<Route
|
|
||||||
path="/embed/chats/:thread_id"
|
|
||||||
element={
|
element={
|
||||||
<ChatRuntime>
|
<WorkspaceLayout>
|
||||||
<EmbedChatPage />
|
<ChatsPage />
|
||||||
</ChatRuntime>
|
</WorkspaceLayout>
|
||||||
}
|
}
|
||||||
/>
|
/>
|
||||||
<Route path="/embed/roundtable" element={<EmbedRoundtablePage />} />
|
|
||||||
<Route
|
<Route
|
||||||
path="/roundtable-dashboard"
|
path="/workspace/chats/:thread_id"
|
||||||
element={<DashboardStandalonePage />}
|
element={
|
||||||
|
<WorkspaceLayout>
|
||||||
|
<ChatRuntime>
|
||||||
|
<ChatPage />
|
||||||
|
</ChatRuntime>
|
||||||
|
</WorkspaceLayout>
|
||||||
|
}
|
||||||
|
/>
|
||||||
|
<Route
|
||||||
|
path="/workspace/agents"
|
||||||
|
element={
|
||||||
|
<WorkspaceLayout>
|
||||||
|
<AgentsPage />
|
||||||
|
</WorkspaceLayout>
|
||||||
|
}
|
||||||
|
/>
|
||||||
|
<Route
|
||||||
|
path="/workspace/scheduled"
|
||||||
|
element={<Navigate to="/workspace/scheduled/tasks" replace />}
|
||||||
|
/>
|
||||||
|
<Route
|
||||||
|
path="/workspace/scheduled/tasks"
|
||||||
|
element={
|
||||||
|
<WorkspaceLayout>
|
||||||
|
<ScheduledTasksPage />
|
||||||
|
</WorkspaceLayout>
|
||||||
|
}
|
||||||
|
/>
|
||||||
|
<Route
|
||||||
|
path="/workspace/scheduled/runs/:run_id"
|
||||||
|
element={
|
||||||
|
<WorkspaceLayout>
|
||||||
|
<ScheduledTaskRunDetailPage />
|
||||||
|
</WorkspaceLayout>
|
||||||
|
}
|
||||||
|
/>
|
||||||
|
<Route
|
||||||
|
path="/workspace/agents/new"
|
||||||
|
element={
|
||||||
|
<WorkspaceLayout>
|
||||||
|
<NewAgentPage />
|
||||||
|
</WorkspaceLayout>
|
||||||
|
}
|
||||||
|
/>
|
||||||
|
<Route
|
||||||
|
path="/workspace/agents/:agent_id/chats"
|
||||||
|
element={<Navigate to="/workspace/agents" replace />}
|
||||||
|
/>
|
||||||
|
<Route
|
||||||
|
path="/workspace/agents/:agent_id/chats/:thread_id"
|
||||||
|
element={
|
||||||
|
<WorkspaceLayout>
|
||||||
|
<ChatRuntime>
|
||||||
|
<AgentChatPage />
|
||||||
|
</ChatRuntime>
|
||||||
|
</WorkspaceLayout>
|
||||||
|
}
|
||||||
/>
|
/>
|
||||||
<Route path="/page/*" element={pageElement} />
|
|
||||||
<Route path="*" element={<NotFoundPage />} />
|
<Route path="*" element={<NotFoundPage />} />
|
||||||
</Routes>
|
</Routes>
|
||||||
</AppProviders>
|
</AppProviders>
|
||||||
|
|||||||
@@ -1 +0,0 @@
|
|||||||
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="16" height="16" viewBox="0 0 16 16"><defs><style>.a{fill:#fff;opacity:0;}.b{fill:url(#a);}</style><linearGradient id="a" x1="0.277" y1="0.03" x2="0.725" y2="1.083" gradientUnits="objectBoundingBox"><stop offset="0" stop-color="#92eeff"/><stop offset="1" stop-color="#00c7ff"/></linearGradient></defs><g transform="translate(-128.5 -117)"><rect class="a" width="16" height="16" transform="translate(128.5 117)"/><path class="b" d="M4,0,8,5H0Z" transform="translate(140.5 128) rotate(180)"/></g></svg>
|
|
||||||
|
Before Width: | Height: | Size: 589 B |
@@ -1 +0,0 @@
|
|||||||
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="84.499" height="70" viewBox="0 0 84.499 70"><defs><style>.a{fill:url(#a);}</style><linearGradient id="a" x1="0.043" x2="0.978" y2="1.016" gradientUnits="objectBoundingBox"><stop offset="0" stop-color="#0062d9" stop-opacity="0.6"/><stop offset="1" stop-color="#0062d9" stop-opacity="0.302"/></linearGradient></defs><path class="a" d="M8855.277-1940.39l-.054-70h78v31.183l6.5,5.257-6.5,5.259v28.3Z" transform="translate(-8855.224 2010.389)"/></svg>
|
|
||||||
|
Before Width: | Height: | Size: 536 B |
@@ -1 +0,0 @@
|
|||||||
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="77" height="45" viewBox="0 0 77 45"><defs><style>.a{fill:url(#a);}</style><pattern id="a" preserveAspectRatio="none" width="100%" height="100%" viewBox="0 0 340 45"><image width="340" height="45" xlink:href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVQAAAAtCAYAAADxyJMIAAAABHNCSVQICAgIfAhkiAAAIABJREFUeF7tnd2O5MZ1x5vdPTO7WkmGhMiQDQS5NODbvEBeIgbygcRwjOQur+D1K+QiQC4CBMld8hJ+CgO+DpAIcixblvZjZnqG+f/PqcM6Vawii+zuda+0XLSaXawvFos//s85xVHX9/3mXFvXdeeq+htSb/9mB4iX+vlmfZu/PKLs1BX7/ET1fndznsn8w5X1Pkc5jvfPV5ZfPcu784zD6v683QWXMLJbknnpsHy7gXpmWP5sIYRaYHgqsC2dKG97/haQL4Xy2SH8Drqt024JI98BtXVUi/nOBM0pWLaAkX09JRx/sBDe+Vj99sjyR10jV/ijI5Xir44s78+jBcLMPwXis0H3HWz9pXoH1FPdgFLPCaF5DCjXAvLrALM/rQzKuWH36QnH7xTX9bMzw2IO2muhPAfgNwbeM4/fKa7xiet4B9RVAzq4ndb7GL3nquSrnFKXrcBcqhbngHlO4P3+Qp3oH54xcDAH7Dng5nO3FcBTwC3Blv5d29bPeNfbby5o3wF1EVBH/vtl0+tn0ti4TA2ex4JzDpD5uc8B81TQe3FhSnTRHEDmZycCwhys54Cb97sG4GNBW1O0R7sRTjSOS6/fGfO/A2pxcJsDnykcFZjlLYdmGZZj2JZUZisof4iufJHBaykUW+D38QJ1+fIth6ld3fcWwOCLTOUSyPm4zkHa4MvrVwNxK4BL4F0L3bO4DxaM7RnhuKbqd0BdEzuo+TdLSnNOZY6B2W3mgFlSki2grMFxCoinAOBtBbg3ATS14zajP3FT+/WJgPzE3bS/XnPruDJ2HsdUUwL0/6DC78tDsfyEb4Vw3q858K4B7tiN0CNI5rd4Dj+fHajC+S4zBmdbOFOGbxlQm5VnHO4SPH85HNar/Pno6kwrzTZgah05KKlO8rQSKEuQXArHGugIuBawEVot+fzw3U5E+W/w9Js67utZkrd0c7H8kq31XJmvBvClYC5BuATfHLylOWSq92P0L87v8gh44I6V7XjcctiWVG0K2caxvzzIfguA2nht8qkzDVLNXVef3eYHSYVUnbaNZ0GuOBWY5dmSw/M18lLF+C0Hp4GxdMPWoPnBCZRgK/xmwPXRswUuhSUQDHl/+2JF4KkE7KUQLvX1q4q5O3Xt8mM5aKl0nxTcDrWxyl0KU4o2wlVvtCnXQTtYV9y0lwHXbyhQF16PHJ7+Ca3qs361vMk+pTw9NKPCTOtNYanHcqU5pTJPBccZELYC7vFEQF3ByDdSZBsAaudpv+canwX4UjAvgbB1Lodui7K1sh64Ebbjm25ayVptWu67btRyBbs4+PWHg+s3AKiL4ZnOd+/3HJvuqao01VkDZ6o0O5jmaXn75cGpwNSMY1imM6MEzDklWYNaTfUh/3fQFcLh5EC8v5BF+3PEaz1+tdAt0Fjvl1NAranpOQiXoDvnYvDQ9cBNXQjpDViGLc885jPQ/koGpH4De0Wb+mM3y1/RfTOQfQuBugCgpah7C0BT1elvA70qn2brUBWcZbX5x6H4i2C2KjTHV/e22yb3WwRleSaUQFmA5HeOUYmNAOyfnsA90Aibty7bl7jY141R6yMAXYRwCb5LwVuDrsH2Wf8o1+S/8RkHyfRGmXch9JuP3JWtuQ2mAEswzwe7XCPnAexbBNRGkFq25xi7sXO9KwSQNhP+TsJzPPI+KGRqk+A0aD5DJ14EyHrV6RXmJw6qMXAT24og1LQMlgZKb2bOKsoaIClJC1t/dxpQ9nfjB0h3rcqkdEyeTuH4VJ5TwbWlran++vLH9KkKXkC5uM0AuDQ3RuDNoVsCbm1FxE2AKTsXAYslYWEaP4PflqDV+Rtv4AjYmOb9tPkqA1WyMhWGPe8isES6Cp6HH828bM7YdGkvHKiNEOWp5mrUYDq1bGnKhDcVOl6O1GENoQ1uBx+n7kdwlsx0TUvN81Z4Sr4mpTmjKE+pJGsgbJp1LlN/OG/AaWl/avm7/YrAVaGyU8GXVXevZpRvg+IdAZaK9Ius4zVV+1Wn6pRbVLLpTWugVZeBHist9zLIlgJg0UUw5R7Qfoz9rwumwPFwvVCgNoLUQ3QcSJI5N4xmhOd4gE2FlnyeCk8LEOV+Tk3PfZs1c11VZ644c2DmVzX+rgDzGFC2gHE19J4UFO5XGIEPFszxS83K87DNzud1o2mfnVMLrI8BcRW8a4DrFe3NJgJVz0lv3NRf2zvY2pn3ULS2vnYtZLW9qF7jqNYCXM0ugfVgvSCgNtw5BtDclC8Fk8wPGpcraQPe/xkBqsfSYBFTOihP65jBU9O5jddjhjwO5GqqT0EzB+bwO4By8dWdguQiOJaA2HCZzpWlb/TptrbfNQClta6j8xHQV21AngPwWviOwDs9Pn2ibhW0erNERRuVUVx/G/Ikil8By/JfqCdI6nkW0mxwP3THPstuizTQlV6O8XItPX4GwF42UOtm/Hj++nWfPgofAcpF8ikczXS3pUlT8PzAKVWrxfyc0b85D84IBZ0tGtCpq1J3rAbKWUieAYwnhdvNhUf/b08XzT8LxGeUcQ3AS8BbgG1ZnWIyB9BGmBpsU9fBWM3mboMcsgrYuNVWFKQBLl9C2zQFO145MOZKkjKvbS4XqK0wTU35eMbRB5oO0liFjpcrmQk/XpLU4U0dbonZnvk3/ah3m1RVdc48T/OlvewyeEbV2uJzPAFAVwHz0sE4c7uc/PAKEJ8EuA2uh2MhC8CmQL1KzP/EZwfAat7oLoAbYPSQ6gdXQe1FhXTpluiR4Zqpet1sch+swTVforUaqvH2L82XywNqbtaXzXk9F2/Opwvn47nWVaiOzG1gVWk9p19yFFRogOdYUdbBmV8BVaYa+U6g6pRmWbEeCcpmSP4BwDirsk9Ou7YK58zrtloW5KKZ/XVb/qPhu0LZOlWbBzrUhNNAWTxWAe2gYvX+rLsKzB9bh6yW9+o1Va5xMCNcx0GaHLAr3QGXA9Tn4bxjdD6dVbWgEpXo+N12vmGk5cevYarvkzB77ca1Dk/rh1a4AJwllRnAYcCM4FRYjtO19aqtMQvJM8BxNfyusyCV+Qzvj1ue1T9Muwy63elM9mRS3rX5PHM8ngXSM2p4NXwr0MU5jEz+AmxjACIFbb9J/bOSb/DJpko2AteWb/FvIUwBtuR7bfW5rlKu8fa8HKD+WT7t8JsQrQeVIkjjMiYFafSFxgi8+kB1K8NzDC7n74Spnh8f4Adw+mOqQKNpHiEZFWbN3E+A6mA5BuqJQNkExxyEhUuVJ81BrqGKtzrLIog3gPlkEJ4A70Lo4g/fDA+UCM4UtHrT6Jpirwptv098swrZJF8Bsj7oFVcU3AzFbAVBBLGpV3ML8IgCNrZF9Tq1YsD7WyfU65LFdef9f0oZUPn9v+FeSk16TfSRefpDoxKNNyDNeKrQX0O5GEjp+/yYMO0677MeFsN75akL3eHHTCE6Y6ZzOVAEYqq6cuU5AmqAZ0x/H3VlAaylhKnC8pmrqUEdrobjIVOOT9HuHpM4T6+dWK48qTRn1OjG1OhcvrzNNSr2VVYJz23F1gRfvwLgRbmRo6FbcDdMQLYESK5UMOUKn+jQz971LcLUvbxBuA0vNnyZuAwkv3tJoRcs2HrZG2mD/le757lMKw6QD2ylbgHNk75QoGnfw+cX2RinS7H0YAGslwPUf3AnYCAtReipRhWiCh9To+YLZZpF5DWApBsGs7A4ntCSrRIsGvk6R8ozNdVjvzL/qLRxv/Gvl6aQVcU5p1yzq5wo4dGxTYOyXA1L35oHJKGZb0vhFsr3rt4uwMqnFVratObLy1q5Up3FtDkAe9iuBK1vtwm6E0p3NWzrirZ3sC2qT7uM8q1qNsI0fVECMI3H3HlHBVtzEUTrlIEu3fw6WINr+ncJbEkWX4uVW1PKmVugtkqgAaqXA9QfuWFUv2g6jw2kClA9GANKMa9F4fk08kC1MgGgUoea8VLfhxzV7BXJzN/JP4FWU5oJCAumuh5PoVmC51i5qutgbPLPwPJoUJYgOQHGOdClF3PBr+s39CbV3ZJbob3/k6A2KJ9I6cpEngN9BborgMu/TTsAMoyI3pyp6V6HbR2yg6vg91qx1uHfDIuAjfVz5YAB1q8ioHqV+89dY32xIILV2iBgvb81XSWg9UwEsJbMovOa/P84AVGeRFSi0Yy3eU1wKkBT8JThKdec//nA+T4BzyHdgTOmlRWnh11s+2ZCiWaBp2qQ6rovqVmdXUsV35yJfT0G9ipAtsDv0BiAemIX9w1/v25sb98QkFoB6SKA72ZcCQsV8CR024FbB6WCdgTbgqItAtmrWe8q+OrawVUvUw/I6je3q+w4FSsDXKZcrQwBG5WrpipcU5eNh2tJtRYCWP3zxvlDCC2JYLVXqzm7H4cScZlTHlyK78Kb8jSfiFei5nd06pM1B3hKUwGesg94WleL5nbm2/RKU8uH7le+hzxoMwWkgqXbvKen78arC8Csmf/joa0B81hQ1gC5EIr9Q6PKfFgIW6t3h5uG+/y2jWC8Cmk+H4+XoLnDzZS3z7SGrbN2j4XxAgAvAu8pgPsyDER8kKiKVNO9DMZxOouYsk3KzKpap2a9mgZk07YNsApX3Uyt5urVg5X54uuwXrmqWyBLine truncated
|
|
||||||
|
Before Width: | Height: | Size: 12 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 2.5 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 27 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 27 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 27 KiB |
@@ -1 +0,0 @@
|
|||||||
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="1920" height="62" viewBox="0 0 1920 62"><defs><style>.a{fill:url(#a);}.b{fill:rgba(0,98,217,0.1);}.c{fill:#fff;}.d{fill:rgba(0,98,217,0.2);}.e{filter:url(#h);}.f{filter:url(#e);}.g{filter:url(#b);}</style><linearGradient id="a" x1="0.5" x2="0.5" y2="1" gradientUnits="objectBoundingBox"><stop offset="0" stop-color="#0b3776"/><stop offset="1" stop-color="#0c1935"/></linearGradient><filter id="b"><feOffset dy="-3" input="SourceAlpha"/><feGaussianBlur result="c"/><feFlood flood-color="#0062d9" flood-opacity="0.102" result="d"/><feComposite operator="out" in="SourceGraphic" in2="c"/><feComposite operator="in" in="d"/><feComposite operator="in" in2="SourceGraphic"/></filter><filter id="e"><feOffset dy="-3" input="SourceAlpha"/><feGaussianBlur result="f"/><feFlood flood-color="#0062d9" flood-opacity="0.102" result="g"/><feComposite operator="out" in="SourceGraphic" in2="f"/><feComposite operator="in" in="g"/><feComposite operator="in" in2="SourceGraphic"/></filter><filter id="h"><feOffset dy="-3" input="SourceAlpha"/><feGaussianBlur result="i"/><feFlood flood-color="#0062d9" flood-opacity="0.2" result="j"/><feComposite operator="out" in="SourceGraphic" in2="i"/><feComposite operator="in" in="j"/><feComposite operator="in" in2="SourceGraphic"/></filter></defs><g transform="translate(-2009 -3361)"><rect class="a" width="1920" height="62" transform="translate(2009 3361)"/><g data-type="innerShadowGroup"><path class="b" d="M0,0H318L268,62H0Z" transform="translate(2009 3361)"/><g class="g" transform="matrix(1, 0, 0, 1, 2009, 3361)"><path class="c" d="M0,0H318L268,62H0Z"/></g></g><g data-type="innerShadowGroup"><path class="b" d="M0,0H310L260,62H0Z" transform="translate(2009 3361)"/><g class="f" transform="matrix(1, 0, 0, 1, 2009, 3361)"><path class="c" d="M0,0H310L260,62H0Z"/></g></g><g data-type="innerShadowGroup"><path class="d" d="M0,0H302L252,62H0Z" transform="translate(2009 3361)"/><g class="e" transform="matrix(1, 0, 0, 1, 2009, 3361)"><path class="c" d="M0,0H302L252,62H0Z"/></g></g></g></svg>
|
|
||||||
|
Before Width: | Height: | Size: 2.1 KiB |
@@ -1 +0,0 @@
|
|||||||
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="1920" height="1080" viewBox="0 0 1920 1080"><image width="1920" height="1080" xlink:href="data:image/jpeg;base64,/9j/4QAYRXhpZgAASUkqAAgAAAAAAAAAAAAAAP/sABFEdWNreQABAAQAAAA8AAD/4QMwaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wLwA8P3hwYWNrZXQgYmVnaW49Iu+7vyIgaWQ9Ilc1TTBNcENlaGlIenJlU3pOVGN6a2M5ZCI/PiA8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIiB4OnhtcHRrPSJBZG9iZSBYTVAgQ29yZSA5LjEtYzAwMSA3OS4xNDYyODk5Nzc3LCAyMDIzLzA2LzI1LTIzOjU3OjE0ICAgICAgICAiPiA8cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPiA8cmRmOkRlc2NyaXB0aW9uIHJkZjphYm91dD0iIiB4bWxuczp4bXA9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC8iIHhtbG5zOnhtcE1NPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvbW0vIiB4bWxuczpzdFJlZj0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL3NUeXBlL1Jlc291cmNlUmVmIyIgeG1wOkNyZWF0b3JUb29sPSJBZG9iZSBQaG90b3Nob3AgMjUuMCAoV2luZG93cykiIHhtcE1NOkluc3RhbmNlSUQ9InhtcC5paWQ6OUVERkMwNjI0Q0RCMTFGMDg5MTZCMkY2RDg1RkVEQkUiIHhtcE1NOkRvY3VtZW50SUQ9InhtcC5kaWQ6OUVERkMwNjM0Q0RCMTFGMDg5MTZCMkY2RDg1RkVEQkUiPiA8eG1wTU06RGVyaXZlZEZyb20gc3RSZWY6aW5zdGFuY2VJRD0ieG1wLmlpZDo5RURGQzA2MDRDREIxMUYwODkxNkIyRjZEODVGRURCRSIgc3RSZWY6ZG9jdW1lbnRJRD0ieG1wLmRpZDo5RURGQzA2MTRDREIxMUYwODkxNkIyRjZEODVGRURCRSIvPiA8L3JkZjpEZXNjcmlwdGlvbj4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gPD94cGFja2V0IGVuZD0iciI/Pv/uAA5BZG9iZQBkwAAAAAH/2wCEAAYEBAQFBAYFBQYJBgUGCQsIBgYICwwKCgsKCgwQDAwMDAwMEAwODxAPDgwTExQUExMcGxsbHB8fHx8fHx8fHx8BBwcHDQwNGBAQGBoVERUaHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fH//AABEIBaAKAAMBEQACEQEDEQH/xACVAAEBAQEBAQEBAQAAAAAAAAAAAQIDBAUGBwgBAQEBAQEBAAAAAAAAAAAAAAABAgMEBRAAAQMDAwIEBAYCAgICAAENAQARITFBAlFhEnEDgZGhIrHBMhPw0eFCUgTxBWIjcjMUBoKSokOywtIkFeJTFmMHEQEBAQEAAwEBAAIDAQEAAAAAARECITEDEkFhBFFxEyIy/9oADAMBAAIRAxEAPwD/ADJ3O73PuZjnk3I1J1XqcWfu91/ry8ygfd7n88urlA+73W+vJ+pQT7nd/nlG5QX7vdE88tpKCDu9z+WXmUFPd7tOeUblA+73f5nzKB97ufyy8ygfe7teeXmVA+73J9+TdSgfe7n88m6lBPu92nLLzKov3e4R9eXVygn3e5/PLzKB93uH9+XmUD7vd/nl5lA+73a88o3KB93u/wA8vMoq/d7rtzy0qUD7vdvnkPEoh93ufzy8yig7vdrzPmUQ+73K88vNA+93P5ZeZRT7vcB+vLzKiH3e4w9+XmUU+73P55HxKIfd7tTkfMoH3e6/15eZQPu93+eXmUD7vdec8vMoH3e7/LLq5QT7nd/nl5lFX73dpyy8ygHu93+eW0lUPu90/vPmUQPd7v8APLzKB93u/wAz5lA+73a88vMop97uv9eXmUD7vd/nl5lED3e6z88tpKB93ufzy8ygfd7v88vMoL93ut9WUblBPudz+eXmUF+53f55eaB93ufzy6uUA93uv9eXmVQ+73P55eZQPu93+ZPiUAd3uP8AXl5lA+73f55eZQPvd1/rPmURfu93+eXmUE+73f55eZVF+73P55P1KB93u/yy8ygfd7rPzPmUA97u/wAz5lUPu9yvM+ZQPu9xvryHiUAd3ufzPiSgfd7leeXVygv3e7/M9HKCfd7v8svMoL93u/zy8yqIO73f5HzKC/e7rPzy8ygfd7ls8vMoh97ufzy2koH3O7/M+ZQPu9z+eXmUU+73P55dHKB93uU55eZQPu9wfvy8ygn3e7/PJupQX7vd/nk3UoH3e7/PLzKQfs/9f/tv6eX+qyJ7gxyxxIyxL1ZvVeueXyPp8+p2/HZ97uHPIjPJiYkrzd5vh9bn0n3e7/PLq5WVT7vd/nl5lA+73H+vLzKgfd7l88vMoH3e5/PLzKAO73bZZeZQD3O5bPI+JRT7vc/nl5lBPu9x/ry8yoL93uT7svMoIe73K88vMoH3e7/PLzKC/d7n88m1coH3e40Z5N1KIfd7n88vMoA7vc/nl5lFPu9yvPLzKgn3e5/PLzKoDu93+eXmUD7vdf68vMoH3e7/ADy8ygfd7v8AM+ZUD7vd/nk/UoIe73R+/J+pQX7vcpzy8ygfd7leeXmUD7vd/nkPEoB73c/nl5lA+73f55eZQPu92+eXmVA+73f55eZVD7vctmfMoJ93umeWXmUD7vdb68vMqB93u/zPmVRfu93+eQ8Sgfc7tOeXmUD7vc/mT4lA+73P55eZQT7nc/nl5lBfu93+Z8ygfd7p/efMoH3e7/LLzKgfd7lOeXmVQ+73f55eZQPu9z+eXmUD7vd/mfMoH3e7/PLzKB93ut9eT9Sgfd7v88vMoH3e431k+JQPu9z+eXmUF+73f55eZVD7nc/nl5lBPud3+eXmVBfu9z+R8yqh93u/zy8ygfd7t88vMoq/d7jkc8tpKCHu9z+eXmUD7vcb68vMoH3e6f35eZQPu9z+eXmUD7nddueRGjlA+53R+8t1KB93uu/PLzKC/e7o/fl5lUT7vdj35dHKAO53W+vLzKCnu9xvqy8ygv3e9/PLzKIfd7rfXk3UoH3O649x8ygfd7pP15eZQPu9yPefMwgfd7kjlkPEop93u/yy8yqh93uH9+XmUD7vcMc8urlAHd7n88vMpA+73f5ZeZVD7vdvlk53KAe73f5ZeZUD7nd/nk3UoJ93ufyy8ygfd7l88vMoOv8AV/uZdnv493PlmMX9pyIdwyJZsTu/2Mu538+5iTjjkTkMXJZMWMfe7teeU7lAHd7v88n6lA+73KjPLzKo32v7f9jtl+33csTsSkqWad3+3/Y7uXLudzLI6klW3STGD3e5/M+ZRU+73Qfry8yoB7vcvnl5lA+73THPLaSgfc7388o3QB3e4/15eZQPu9z+eXRygfd7n88vMoi/d7v8z5lFT7nc/nlvJQUd3uV5ZdHKIn3e40Z5byUF+73R+/LzKB97ufyy8ygn3O5/PLzKB93u/wAzTUoL9zufzPmUD7vc/mW6lA+73G+sv1KB93uU55RuVRR3u7fPKdygfd7grnltJQD3O4R9eXRygfd7k+8nxKofc7p/fltJQPu91/rPmYQD3e7/ADy8yiH3e6G9+T9Sgfd7n88vMqi/c7p/efMoJ9zu/wA8vMoL93uP9WXgSgv3e5fPLzKofc7v/wDcy8ymCDu9z+eT9Sgfc7v88tpKgp7ncf68urlBPu9w/uy8ygfd7n8st5KB93ufyy8ygfd7n88p3Kgp7vdf68n6lUPud3+eXVyiB7ndH78vMoJ93un9+QazlBfu9yvLLzKAO73p958ygfc7v88t5KYan3e7QZ5P1KC/d7ls8t5KCfd7k+8kdSgfd7jfXkfEqB93vWzy8SVRfvd1m5mdygn3O6I55eZUD73ceMy3UoH3e68ZZOdyqL9zu3yy2koIO73XnM+ZUFHe7xLcsnO5VD7vdEc8n6qAO53ZbPI+JTDUHe7gB9+XmUgDud2+WWgkpgfdz4znl5lBB3e7Tkd5KBj3O4x9xi7lSQqjvd3+eQ8Sgfd7teWTauUDn3WnPKNymGh7vcrzyO7mqofc7onmZ3Kgfd7wD8y4oHKB9zumueXmUU+73T+7JjdyiB7ndY+8ltygfc7rPyym7lFT7ndb68n6lTBfu9z+eR8SqiHu9wBxnlpUqKDud0//AKQ+ZQPu9wge7LzKoDu9z+eTdSoH3e7/ADy8ygfd7teR8ygn3e67c8iTSSin3u431FxUOVBD3e63/sy1qUF+73D+8v1KBj3e7Puy8yqH3O67cj1coJ93u2zLdSgp7ubfXl5lBPu93+eRrcqCnud2pyPmUEHd7g/fl5lA+73ZHPLq5hBfu9z+eQbcqCc+88ZF+pQU9zuGeeT9UE+93Kc8h0KKo73c/nl5lED3e63/ALMtalUPu93+eXRyoJ93u/zIOjlFX7vcYe8+ZQPu94zzy6uUEPc7gH15TuWUA93u/wAyB1KCfc7j/WX6lBfu93+WQaklAPd7tszO5QPu9y+WR8Sgg7vd/nl4koL93uuRzMblA+73Sfryncqh93uH9+U7lA+53P55eZQT7ndvnkT1KB93u055dXKgfd7v8yAayVQ+73Kcy2rlBfu9yTzy8ygn3e659+T3YlQPu912OeT6uUwPudz+WXmgfd7rxnk3UoIO93aDPLq5QPu9Line truncated
|
|
||||||
|
Before Width: | Height: | Size: 431 KiB |
Loaded 100 of 2489 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user