绝尘
874cad22db
- docs/06-前端开发/前端架构技术债-2026-06-19.md: P0/P1/P2清单 + 留待用户决策 + AI coding强项 - 来源: fe-arch-review子代理多角度审查(B+ AI coding 7.5/10) - 已修复: i18n as any收口(f4cc2e5); 留待: status union试点/AI三大件拆/ErrorBoundary接入/components归位/meta.icon
3.3 KiB
3.3 KiB
前端架构技术债清单(2026-06-19 审查)
来源:fe-arch-review 子代理多角度审查(目录/组件粒度/状态/类型/依赖/路由/命名/测试/AI coding 友好度)。 整体:B+(AI coding 友好 7.5/10)。类型基础扎实(strict + vue-tsc 0)、命名一致(A 95/100)、依赖无环、死代码 1.7%。债集中在 AI 模块体量 + status 类型化。 已修复:i18n
as any样板收口(i18n-helpers.ts,as any 22→10,i18n 13→0,commit f4cc2e5)。
P0(阻碍 AI coding)
| # | 项 | 影响 | ROI | 风险 |
|---|---|---|---|---|
| P0-1 | useAiSend.ts(532 行)混合发送+队列+审批三条链 |
改一处需通读全文 | 高(拆 3 文件) | 中 |
| P0-2 | useAiEvents.ts(427 行)巨型 switch 12 case 216 行 |
新增事件改 200+ 行函数 | 高(按域拆 handler) | 中 |
| P0-3 | useToolCard.ts formatToolResult switch 15+ case |
新增工具改多处 | 高(策略表) | 中 |
| P0-4 | status 字段无 union(types.ts 4 处 Record + 34 处比较) | 拼写错误编译期不报错 | 高 | 中(逐字段核对字面量集) |
P1(降效率)
| # | 项 | 影响 |
|---|---|---|
| P1-1 | AiChat.vue(1474)/MessageList.vue(1444)/ToolCard.vue(1066) 仍过重 | AI 改 AI 模块上下文巨大 |
| P1-2 | components/ 一级散落 AiChat/ToolCard/ToolCardList(应进 ai/) |
找文件靠记忆 |
| P1-3 | catch (e: any) 30+ 处 |
应改 unknown + Error 收窄 |
| P1-4 | App.vue 8 职责(布局已拆 layout/ → AppLayout/AppSidebar,App.vue 546→179,余初始化职责) |
layout 已抽取,App.vue 收敛 |
| P1-5 | JSON.parse 后 cast 无守卫 4 处(IdeaDetail/TaskOutputCard/useToolCard/useAiConversations) | 后端格式漂移运行时崩 |
| P1-6 | useAiConversations.switchConversation 116 行单函数 |
难维护 |
| P1-7 | constants/project.ts 含 task 常量(命名狭窄) |
找 task 常量去错文件 |
P2(优化)
- 测试覆盖 0%(无 vitest)。高 ROI 目标:utils/time.ts(parseTs 边界)/ utils/markdown.ts(stripMd)/ utils/project.ts(parseStack)纯函数易测
- router 无 404 catch-all
meta.icon11 处死字段(删或接入 AppSidebar)- ErrorBoundary.vue 已实现(76 行)+ i18n key 就绪,从未接入(main.ts:12 注释承诺未落地)
useAiEvents.ts:95模块级导出pendingMaxRoundsref(破坏 composable 可复用性)- store 三段式 try/catch/finally 样板可抽高阶函数
留待用户决策(高风险/需拍板)
- P0-4 status union 类型化:试点 IdeaRecord.status(语义最单一),跑通后推其余(TaskRecord/AiToolCallInfo/WorkflowRecord 字段名同语义不同,易误伤)
- P0-1/2/3 AI 三大件拆分(useAiSend/useAiEvents/useToolCard):行为变更面大,独立任务逐个 + vue-tsc + 手测
- ErrorBoundary 接入:App.vue router-view 外层包裹,或删组件+删注释
- P1-2 components 一级归位(AiChat/ToolCard/ToolCardList → ai/)+ P1-7 constants/project 拆 task:改 import 路径面广,集中"目录整理"任务
- router meta.icon 死字段:删或接入 AppSidebar
AI coding 友好强项(保持)
- 类型基础好(strict + vue-tsc 0 + 0 处 @ts-ignore)
- 命名一致(PascalCase/动词前缀/kebab-case)
- 依赖无环(stores→composables→components→views 单向)
- 死代码少(1.7%)
- 注释详尽(每个 composable 头部职责+耦合说明,极利 AI 理解)