# AI球出厂测试标准

本文档定义 AI球设备出厂测试的初版项目、流程和判定标准，用于首批设备生产验证。

## 1. 测试目标

- 确认每台设备完成固件烧录和基础配置。
- 确认核心硬件模块可用。
- 确认设备能与 PC 上位机通信并执行应援脚本。
- 输出可追溯的测试结果，区分合格、失败和待复测。

## 2. 测试环境

- PC 上位机测试工具。
- 标准测试资源包。
- 标准应援脚本。
- 设备序列号或生产批次标识。

## 3. 测试项目

| 项目 | 说明 | 初版判定 |
| --- | --- | --- |
| 固件烧录 | 写入指定版本固件。 | 版本读取一致。 |
| 设备自检 | 启动后执行内部自检。 | 返回 `ok=true`。 |
| 灯效/屏幕 | 显示指定颜色、亮度或图案。 | 观察或传感器检测通过。 |
| 喇叭 | 播放标准提示音。 | 音频输出正常。 |
| 麦克风 | 采集测试音频。 | 音量或频率检测达标。 |
| 按键 | 检测按下和释放事件。 | 事件顺序正确。 |
| 无线充电 | 检测充电状态。 | 能进入充电状态。 |
| 通信 | PC 上位机连接和命令往返。 | ping 和 info 命令正常。 |
| 资源包 | 导入并校验标准资源包。 | 校验成功。 |
| 应援脚本 | 执行标准脚本片段。 | 动作按时间轴触发。 |

## 4. 测试流程

1. 扫描或录入设备序列号。
2. 烧录固件并读取版本。
3. 执行设备自检。
4. 分项测试灯效/屏幕、喇叭、麦克风、按键和无线充电。
5. 连接 PC 上位机并执行通信测试。
6. 下发标准资源包和应援脚本。
7. 执行短时同步播放测试。
8. 生成测试结果并标记合格或失败。

## 5. 测试结果格式初稿

```json
{
  "device_sn": "AIBALL-000001",
  "firmware_version": "0.1.0",
  "result": "pass",
  "failed_items": [],
  "tested_at": "2026-01-01T00:00:00Z"
}
```

## 6. 失败处理

- 单项失败时记录失败项和错误码。
- 允许维修后复测，并保留复测次数。
- 关键项失败的设备不得进入包装流程。

## 7. 待确认问题

- 自动化检测设备的型号和接口。
- 测试报告最终保存格式：JSON、CSV 或数据库。
- 首批 100 台设备的抽检和全检策略。