yawan-workbench/web/MIGRATION.md

前端重构迁移清单（阶段0盘点结论）

现状

• React 18 + Vite 5 + TS 5.5；无路由库（手写 window.history + tab state）；图标全用字符/emoji
• 已装：react-router-dom 7.18、lucide-react 1.39（6143 图标可用）
• 14 个入口平铺侧栏；TasksPage 468 行单文件含列表+详情；KBsPage 370 行；CanvasPage 292 行
• api.ts（151 行）封装 fetch + token；progress.tsx SSE 进度；dialog.tsx 对话框；ui.tsx Tag/边界
• 登录入口 /admin /app 双门户；后端 API 契约 158 端点不动

新路由映射（旧 tab → 新路由）

旧	新
overview	/admin（工作台首页）
tasks	/admin/tasks（内容任务列表）
tasks 详情内联	/admin/tasks/:id（页签：内容段/运行轨迹/最终成稿/配置快照）
ops	/admin/ops（并入工作台二级）
canvas	/admin/flows（画布）
agents	/admin/agents（列表）+ /admin/agents/:id（详情五页签）
skills	/admin/agents?tab=skills（智能体模块内页签）
prompt-templates	/admin/agents?tab=prompt-templates
kbs	/admin/knowledge（列表）+ /admin/knowledge/:id（页签：文件/分类/检索测试/消费记录/设置）
tags	/admin/knowledge?tab=tags
models	/admin/settings/providers
access	/admin/settings/access（页签：成员/角色权限/资源授权/登录安全）
logs	/admin/runs（页签：通知/待确认/运行记录）+ /admin/runs/:id（Trace 详情）
memories	/admin/agents?tab=memories
usage	/admin/settings/usage（用量）+ 点数发放并入 access 或独立 /admin/settings/billing

一级导航（5 项）

1. 工作台 LayoutDashboard → /admin（含运营数据）
2. 内容任务 ListChecks → /admin/tasks
3. 智能体 Bot → /admin/agents（页签：Agent/技能/提示模板/记忆）+ /admin/flows（画布）+ /admin/runs（运行）
4. 知识资产 Database → /admin/knowledge（页签：知识库/标签）
5. 系统管理 Settings → /admin/settings/providers|access|usage

分阶段实施

• P1 路由骨架 + AppShell（240px 侧栏/56 顶栏/移动抽屉）+ 导航迁移：保持旧页面组件原样挂进新路由
• P2 TasksPage 拆列表页+详情页（页签）；AgentsPage 拆 320px 列表+详情；LogsPage 拆页签+服务端分页
• P3 KBsPage 详情页签+文件列表；CanvasPage 工具栏+节点库+属性检查器+修复 0 节点 bug；AccessPage 四页签
• P4 Skills/Templates/Tags 抽屉化；Models/Usage 口径修复；lucide 图标替换；视觉统一（14px/12px/8px 圆角/单主按钮）
• 每阶段保持旧功能可运行 + tsc/build 过 + 浏览器走查