AI 执行的核心策略 + 关键控制点

来源: Trilium

针对 AI 执行的核心策略 + 关键控制点，聚焦 “自动化落地、风险兜底、效果验证”，无需手动编写代码，仅需明确 AI 执行的优先级和校验规则：

一、核心执行原则（AI 优先遵循）- 优先级驱动：严格按「CRITICAL > HIGH > MEDIUM」执行，完成上一优先级所有任务并验证通过后，再启动下一优先级；

  • 增量验证：每完成一个子任务（如修复 1 个浏览器超时问题），立即运行对应测试用例，避免批量修改后定位问题困难；
  • 标准化优先：所有 API 整改必须严格匹配预设的响应格式模板，不允许自定义字段结构；
  • 兼容性适配：针对 Firefox/WebKit 的优化仅在对应浏览器环境测试，不影响 Chromium 现有稳定性。

二、Day 1-2 关键动作（AI 快速启动）- 自动化验证：调用预设的 API 验证脚本，批量检查修复后的端点是否包含 success/data 字段，输出验证报告（失败项需立即重试）；

  • 执行冒烟测试时，自动过滤「announcement/database/market」核心用例，仅关注关键路径，缩短验证耗时；
  • 问题分类自动化：解析 E2E 测试报告，按「浏览器类型 + 失败类型（时序 / 选择器 / API）」自动归类，生成问题清单（无需手动整理）；
  • 环境配置：自动注入 Playwright 浏览器特定超时配置，无需手动修改配置文件，仅需传递浏览器类型参数；
  • 规范文档生成：基于预设模板自动生成 API 标准化规范，填充项目实际端点列表，无需手动编写文档结构。

三、Week 1 核心执行建议（AI 聚焦高收益动作）### 1. E2E 测试稳定性优化- 核心策略：自动为 Firefox/WebKit 增加 30%-50% 超时时间（无需逐用例调整，全局配置生效）；

  • 所有测试用例统一添加「显式等待元素可见 + 网络空闲」逻辑，替换文本选择器为 CSS 类选择器；
  • 对失败用例自动触发重试（最多 2 次），降低偶发超时导致的失败率；
  • 验证规则：优化后 Firefox/WebKit 通过率需≥85%，否则回滚并重新分析根因。

2. API 标准化落地- 核心策略：启用响应标准化中间件，自动包裹所有 API 响应（无需逐端点修改）；

  • 批量扫描 25+ 端点，检查是否符合「success 必填、数据在 data 字段、错误含 code/message」规则，生成整改清单；
  • 对非标准端点自动注入缺失字段（如补全 success: true），复杂结构需标记为 “人工复核”；
  • 验证规则：所有端点响应格式 100% 匹配模板，无字段缺失 / 格式错误。

3. 验证闭环- 周五自动运行全量 E2E 测试，生成通过率 / 执行时间报告，对比基线数据（Phase 9），确认 Week 1 目标达成（E2E 通过率≥92%）；

  • 自动汇总剩余失败用例，归类为「Week 2 重点问题」。

四、Week 2 核心执行建议（AI 聚焦性能 + 稳定性）### 1. 性能优化- 核心策略：为高频 API（如 announcement/stats）自动添加 Redis 缓存层（缓存 TTL 5 分钟），优先通过缓存提升响应速度；

  • 自动分析数据库慢查询，对重复扫描的 SQL 优化为单次查询 + 应用层计算；
  • 验证规则：API 响应时间≤400ms（缓存命中≤50ms），否则调整缓存策略。

2. WebSocket 完善- 核心策略：自动实现连接管理逻辑（连接建立 / 心跳检测 / 断开清理），限制最大重连次数（5 次）；

  • 消息推送增加失败重试机制，断开连接后自动清理无效连接；
  • 验证规则：模拟 100+ 并发连接，消息推送成功率≥99%，无内存泄漏。

3. 数据导出功能- 核心策略：复用开源 PDF/CSV 转换库（如 tabula-py），自动映射 API 数据到导出模板，无需自定义开发；

  • 验证规则：导出文件格式正确、数据完整，支持批量导出 1000+ 条数据无报错。

五、关键控制点（AI 必须校验）- 指标达标校验：E2E 通过率：Week1≥92%、Week2≥95%、最终≥96%；

  • 浏览器通过率：Chromium 100%、Firefox/WebKit≥90%；
  • API 响应时间：最终≤300ms；
  • 风险兜底：若浏览器兼容性未达标：自动降级为「仅保障核心功能适配」，非核心功能标记为 “后续迭代”；
  • 若性能未达标：优先上线缓存层，数据库优化延后；
  • 若 WebSocket 不稳定：自动启用 “轮询 + WebSocket” 降级方案；
  • 文档同步：所有修改自动同步到指标追踪表 / 问题清单，无需手动更新；
  • 每日生成执行报告，包含「完成任务 / 剩余任务 / 失败项 / 调整建议」。

六、最终交付物校验（AI 自动验收）- 功能层面：所有 CRITICAL/HIGH 任务 100% 完成，MEDIUM 任务≥80% 完成；

  • E2E 测试通过率≥95%，API 响应格式 100% 标准化；
  • 性能层面：API 响应时间≤300ms，WebSocket 延迟≤100ms；
  • 文档层面：生成完整的执行总结报告，包含「修复前后对比、剩余问题、后续优化建议」。

核心逻辑：AI 执行时无需关注代码细节，只需严格遵循「优先级 + 校验规则 + 增量验证」，所有技术动作（如超时配置、缓存添加、格式标准化）均可通过调用预设工具 / 模板完成，重点保障 “执行结果符合预设指标” 而非 “代码实现方式”。