AgentEvalTool/docs/adr/0005-ui-consistency-baseline.md
2026-08-06 02:01:36 +08:00

1.3 KiB
Raw Blame History

ADR-0005: 管理后台 UI 一致性重构以智能评估页为基准

状态

已接受2026-08-05

背景

管理后台 9 个业务页面交互模式不一致(表单容器 Drawer/Modal 混用、空态/加载态/删除确认各页不同、Runs/Reports 绕过 PageWrapper。智能评估 v1.0 的页面模式是最新打磨并被用户验证过的。

决策

  • 以智能评估页模式为唯一基准,逐页迁移对齐(先沉淀共享件 FormDrawer/usePolling再按 IntelligentEvals → Targets → Files → ModelConfigs → Scenarios → Runs → Reports → Campaigns 顺序)。
  • 重构边界:只统一交互层,不增删业务功能、不动 API、不动信息架构与 keep-alive 路由。
  • 交互标准PageWrapper 骨架、Table+Empty、20 行分页阈值、Drawer 640 表单、详情用页内视图切换或右侧 Drawer 弹出列表常驻、Popconfirm 危险操作、message 反馈、活跃态 5s 轮询。

后果

  • 正面:用户操作肌肉记忆可跨页面复用;新页面有明确模式可循;共享件减少重复代码。
  • 负面迁移期间每页需人工走查验收Runs/Reports 的特殊 hack 需小心保留。
  • 不做:视觉设计系统重做、导航重构、自动化视觉回归。

详细 spec 见 .scratch/ui-consistency/spec.md