DevFlow/docs/05-代码审查/UIUX扩展审查-2026-08-02.md

DevFlow UI/UX 扩展审查报告(2026-08-02)

触发:任务 0115aea6「总览页 + 项目列表 UI/UX 优化(持续更新)」原 12 问题清单 方法:基于原 12 问题提炼 15 审查角度(A-O),workflow wf_wynylx23h 10 路并行扫描(6 模块深审 + 4 跨文件维度 grep),11 agent / 91 万 token / 488s 完整数据:audit_summary.json(80 条发现) 核验:主代理独立 grep 核验 8 条高严重度,全部属实(子代理本次无幻觉)

一、与原 12 问题关系

• 38 条全新:原 12 完全未碰的模块 —— AI 对话核心区(MessageList/ChatInput/ConversationSidebar/PlanProgress 等)、工具卡审批体系(ToolCard/ApprovalPopup/DirAuthDialog)、文件浏览器(FileExplorer/FileTree/FilePreview)、AuditLog、后端 commands(task/idea/workflow/events/knowledge/services/project)、死代码
• 29+ 条延伸:原 12 涉及文件/角度的新的具体落点(GitChanges 子串误配延伸、settings 控件延伸、Tasks 菜单延伸、git 子进程 CREATE_NO_WINDOW 延伸等)

二、高严重度核查(8 条 · 主代理独立 grep 核验 · 全部属实)

#	标题	位置	核查佐证	严重度
1	project.rs 空 if 目录校验	L250-251 / L410-411 / L473-474 / L708-709	✅ 4 处空块(原报 3 处,实 4 处),对比 L135 create_project 正确写法(create_dir_all)。import/relocate/scan 不应静默放行	高
2	git_branch create/switch 吞错误	ai/tools/git.rs L284/L289-291	✅ let _ = exec_git(...) 恒返 {created}/{switched_to},exec_git 失败返 String::new()(L36-48 非 Result)	高
3	git_commit committed 假成功	ai/tools/git.rs L243	✅ committed: !hash.is_empty(),commit 失败 HEAD 不动,log -1 仍返上次 hash	高
4	DependencyGraph 环检测被抹除	DependencyGraph.vue L227-232	✅ cell.attr 设红框后立即 renderGraph()→fromJSON(L175)重建节点,attr 丢失。功能完全失效	高
5	FileExplorer 工程下拉打不开	FileExplorer.vue L13 + L364-365	✅ 按钮 toggle 开 → 事件冒泡到 document closeDropdown(无 target 判定)立即关。功能失效	高
6	统计源污染 state.tasks	stores/project.ts L96	✅ activeTasks: state.tasks.filter(...) 读 Tasks 当前筛选+分页页	高
7	ActiveProjectsPanel 同源	ActiveProjectsPanel.vue L55	✅ getProjectTaskCount 同读 store.tasks,与 StatCard 数字打架	高(与 6 合并)
8	ApprovalPopup 浮窗无计时	ApprovalPopup.vue L38-105	✅ grep waitSecs/waitLevel 无命中,浮窗确无挂起倒计时	降中(体验,非功能;ToolCard 内联审批有,浮窗缺)

三、高频主题(8)

1. 列表筛选/排序/分页/Tab 状态不持久化(Tasks/Ideas/Knowledge/Projects/AuditLog/ProjectDetail 多处裸 ref 不入 localStorage)
2. AuditLog 客户端筛选只作用于当前页 50 条 + hasMore 靠满页推断 + 无总数(4 路共同命中,筛选给人全局错觉)
3. 多处长内容缺折叠/截断(AI 文本气泡/ConflictResolver 多冲突/HelpRequiredCard 错误堆栈/AuditLog brief 列/ToolResultBody 100px 过小)
4. 后端 git 工具吞错误返假成功(exec_git 返空串非 Result,let _= 丢弃,branch create/switch/commit 三处)
5. Dashboard 统计源与 Tasks 分页源共用 state.tasks(统计卡/项目行活跃数被分页/筛选污染,两面板数字打架)
6. 审批体系三入口授权粒度不一致 + 反馈缺失(ToolCard/ApprovalPopup 三按钮 vs DirAuthDialog 四按钮,拒绝无确认,失败无提示,浮窗无超时计时)
7. git 子进程缺 CREATE_NO_WINDOW 散落多处(module.rs/ai/tools/git.rs,Windows 闪窗)且 N² 放大(每次展开全仓 git status)
8. 设计 token 漂移与硬编码(--df-primary 幽灵变量/git 状态色 3 文件重复硬编码/内联 style 散落)

四、实施批次规划

🅿 P0 确定性 bug(低风险,本会话首批 · 并行实施)

批 1 后端(src-tauri,主代理统一 cargo check):

• commands/project.rs —— 4 处空 if 块补 return Err
• commands/ai/tools/git.rs —— exec_git 改返 (String,bool) 暴露 success;create/switch/commit 验证判定;顺带加 CREATE_NO_WINDOW
• commands/module.rs —— run_git_cmd 加 CREATE_NO_WINDOW(原问题 9)

批 2 前端(主代理统一 vue-tsc):

• DependencyGraph.vue —— 环高亮注入 renderGraph(不再 attr 后 fromJSON)
• FileExplorer.vue —— closeDropdown 加 closest('.module-dropdown') 判定
• Tasks.vue —— 快捷菜单 document click 监听(原问题 11)

🅿 P1 体验/数据源(中风险,后续批)

• 数据源解耦:stores/project.ts 统计 + Dashboard + ActiveProjectsPanel 改读独立 count(后端聚合或 store 全量计数),不依赖分页 state.tasks
• 长 AI 文本折叠:MessageList 文本气泡 max-height+折叠 / ConflictResolver 多冲突折叠 / HelpRequiredCard 堆栈折叠 / ToolResultBody max-height 调大
• AuditLog:后端 WHERE 筛选 + 真实 total + 筛选持久化
• 列表状态持久化:抽 usePersistedRef composable,Tasks/Ideas/Knowledge/Projects/ProjectDetail Tab 接入
• 审批体系一致:ApprovalPopup 浮窗加挂起计时(H1)+ 授权粒度统一 + 拒绝二次确认 + 失败 toast
• cmd 闪烁 N²:FileTree 展开缓存的 git status(避免每次全仓扫描)

🅿 P2 一致性/打磨

• 幽灵 CSS 变量 --df-primary 定义(global.css + 5 处引用)
• git 变更状态色抽设计 token(3 文件硬编码)
• settings 控件统一(原问题 8 延伸:.setting-number/.setting-input/.setting-textarea)
• 死代码清理(PlanProgress.vue 全文件 / MessageList isLastUser+残留 CSS)

🅿 批次 I —— 原 12 问题大改(风险大,后续专项)

依赖 P1 数据源的:Dashboard 统计卡压底行(问题 1)。独立大改:Projects 列表/卡片视图(问题 2)、TaskDetail 重设计(问题 4)、IdeaDetail 重设计(问题 5)、KnowledgeDetail 重设计(问题 6)、ProjectDetail 三栏(问题 10)。埋点:project_event_repo 接入(问题 3)。

五、中/低严重度详单

38 中 + 34 低,按主题归组见 audit_summary.json(字段:highSeverity/mediumSeverity/lowSeverity,每条含 file/location/current/issue/angle/severity/novelty/suggestion)。