测试知识库

自动化测试的中央知识库，集成 AI 测试运行器，实现测试执行、截图分析、报告生成的自动化闭环。

目录结构

test-knowledge-base/
├── README.md                # 本文件
├── config.yaml              # 核心配置（项目路径、端口、模块清单）
├── strategy.md              # 测试策略：测什么、不测什么、优先级
├── framework.md             # 测试框架选型和架构说明
├── env-setup.md             # 环境搭建指南和踩坑记录
├── page-map.md              # 页面地图：所有页面路径和导航关系
├── coverage-matrix.md       # 覆盖矩阵：哪些用例已测/未测（自动更新）
├── defect-patterns/         # 缺陷模式库
│   ├── index.md             # 缺陷分类索引
│   └── common-issues.md     # 常见缺陷及解决方案
├── templates/               # 模板
│   ├── test-case-template.md    # 测试用例编写模板
│   └── test-script-template.py  # 测试脚本骨架
├── decisions/               # 架构决策记录 (ADR)
│   └── 001-framework-choice.md  # 示例：框架选型决策
├── scripts/                 # 自动化脚本
│   └── ai_test_runner.py    # AI 测试运行器（核心）
└── outputs/                 # 运行输出（自动创建）
    └── run_YYYYMMDD_HHMMSS/
        ├── report.md        # 测试报告
        └── screenshots/     # 截图存档

快速开始

1. 编译前端（首次或代码变更后）

python scripts/ai_test_runner.py --build

会弹出独立 cmd 窗口执行编译，等待约6分钟，编译完后重新运行步骤2。

2. 执行所有测试

python scripts/ai_test_runner.py

自动启动微信开发者工具 + 跑测试 + 截图 + AI分析。

3. 执行指定模块

python scripts/ai_test_runner.py --module contact

4. 检查环境

python scripts/ai_test_runner.py --check

5. 查看结果

执行完成后查看：

• 报告：outputs/run_xxx/report.md
• 截图：outputs/run_xxx/screenshots/
• 覆盖矩阵：coverage-matrix.md（自动更新）

工作流程

┌─────────────────────────────────────────────────┐
│                AI 测试闭环                        │
│                                                 │
│   config.yaml ──→ ai_test_runner.py             │
│                        │                        │
│        ┌───────────────┼───────────────┐        │
│        ▼               ▼               ▼        │
│   ① 编译前端      ② 环境检查       ⑤ 生成报告   │
│   nvm use 16      端口 9420       (report.md)   │
│   pnpm dev:weapp  启动微信DevTools              │
│   (自动)          (自动)                         │
│        │               │               │        │
│        └───────┬───────┘               │        │
│                ▼                       │        │
│          ③ 执行测试                    │        │
│        (Minium + 截图)                 │        │
│                │                       │        │
│                ▼                       │        │
│          ④ AI 截图分析                 │        │
│        (Claude Vision)                │        │
│                │                       │        │
│                ▼                       ▼        │
│          coverage-matrix.md ←─────────┘        │
└─────────────────────────────────────────────────┘

和测试脚本的关系

知识库（指导层）              测试脚本（执行层）
┌──────────────┐            ┌──────────────────┐
│ config.yaml  │──配置────→│ ai_test_runner.py│
│ strategy.md  │──指导──┐  └────────┬─────────┘
│ page-map.md  │──参考──┤           │
│ templates/   │──规范──┘           ▼
└──────────────┘            ┌──────────────────┐
      ↑                     │ test_contact.py  │
      └────测试结果反馈─────│ (Minium 脚本)    │
                            └──────────────────┘

知识沉淀流程

场景	操作
修了一个 bug	写入 defect-patterns/common-issues.md
搭环境踩坑	更新 env-setup.md
发现新页面	更新 page-map.md
做了技术选型	新建 decisions/XXX-决策名.md
每次测试执行	coverage-matrix.md 自动更新

维护原则

1. 先写再优化 — 烂文档好过没文档
2. 解决问题导向 — 每篇回答一个具体问题
3. 谁用谁维护 — 写的人和用的人是同一批
4. 定期清理 — 每月花 30 分钟删过时内容