42 lines
2.6 KiB
Markdown
42 lines
2.6 KiB
Markdown
# 前端重构迁移清单（阶段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 过 + 浏览器走查
|