protocol-docs/docs/factory_test_spec.md

AI球出厂测试标准

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

1. 测试目标

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

2. 测试环境

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

3. 测试项目

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

4. 测试流程

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

5. 测试结果格式初稿

{
  "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 台设备的抽检和全检策略。