57 lines
2.0 KiB
Markdown
57 lines
2.0 KiB
Markdown
|
# 前端高完成度保障机制 (V30.0)
|
|||
|
|
|
|||
|
|
## 1. 交付标准
|
|||
|
|
|
|||
|
|
### 1.1 UI 一致性
|
|||
|
|
- **对标 Ant Design 5.0**：组件使用、色彩体系、间距规范
|
|||
|
|
- **响应式适配**：桌面端 (≥1200px) / 平板端 (768-1199px) / 移动端 (<768px)
|
|||
|
|
- **主题配置**：支持亮色/暗色主题切换，CSS 变量统一管理
|
|||
|
|
- **图标规范**：使用统一图标库 (Ant Design Icons)
|
|||
|
|
|
|||
|
|
### 1.2 UX 透明度
|
|||
|
|
- **AGI 决策因果链路可视化**：每个 AI 建议必须展示决策原因
|
|||
|
|
- **加载状态全覆盖**：骨架屏 / Loading 动画 / 进度条
|
|||
|
|
- **错误处理**：统一的错误提示组件，支持重试机制
|
|||
|
|
- **空状态**：友好的空数据展示与引导操作
|
|||
|
|
|
|||
|
|
## 2. 评分维度
|
|||
|
|
|
|||
|
|
| 维度 | 权重 | 评分细则 |
|
|||
|
|
|------|------|----------|
|
|||
|
|
| 代码质量 | 30% | TypeScript 类型完整、无 any、单元测试覆盖率 >80% |
|
|||
|
|
| 交互体验 | 30% | 响应速度 <200ms、动画流畅、Accessibility 合规 |
|
|||
|
|
| AGI 透明度 | 40% | 因果链完整、可解释性高、人工可干预 |
|
|||
|
|
|
|||
|
|
## 3. 交付检查清单
|
|||
|
|
|
|||
|
|
### 3.1 代码层面
|
|||
|
|
- [ ] TypeScript strict 模式无报错
|
|||
|
|
- [ ] ESLint/Prettier 检查通过
|
|||
|
|
- [ ] 组件 Props 定义完整，附带 JSDoc
|
|||
|
|
- [ ] 无 hardcoded 字符串 (使用 i18n)
|
|||
|
|
|
|||
|
|
### 3.2 交互层面
|
|||
|
|
- [ ] 所有按钮有点击反馈 (Hover/Active)
|
|||
|
|
- [ ] 表单提交有 Loading 状态
|
|||
|
|
- [ ] 键盘导航完整 (Tab / Enter / Escape)
|
|||
|
|
- [ ] 移动端 touch 事件适配
|
|||
|
|
|
|||
|
|
### 3.3 AGI 透明度层面
|
|||
|
|
- [ ] AI 建议展示 "为何建议" 展开项
|
|||
|
|
- [ ] 置信度/信心指数可视化
|
|||
|
|
- [ ] 支持人工 override 并记录原因
|
|||
|
|
- [ ] 决策日志可追溯
|
|||
|
|
|
|||
|
|
## 4. AGI 透明度评估标准
|
|||
|
|
|
|||
|
|
| 等级 | 描述 | 要求 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| L1 | 基础展示 | 仅展示 AI 建议结果 |
|
|||
|
|
| L2 | 因果展示 | 展示决策原因 (因果链) |
|
|||
|
|
| L3 | 可干预 | 支持人工修改建议参数 |
|
|||
|
|
| L4 | 可追溯 | 完整决策日志与审计 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
**标准制定**: AI-2 (Internal)
|
|||
|
|
**更新日志**: [AI-3 @ 2026-03-15] 补充评分细则与交付检查清单
|