first commit

项目文档/徐工/语音/04_测试验证记录.md

@@ -0,0 +1,80 @@
+# 徐工语音测试验证记录
+
+## 验证目标
+
+将每次语音模块修改、配置调整、资源替换和问题修复都沉淀为可复用的验证记录，覆盖主流程、异常流程和回归项。
+
+## 基础验证环境
+
+| 项 | 内容 |
+|---|---|
+| 项目 | 徐工 X9HP / 语音 |
+| 语音助手 | 同行者 TXZ |
+| 语音包名 | `com.txzing.voiceassistant` |
+| 语音模块包名 | `com.yaxon.voice` |
+| 测试账号 | `T9999911` / `xgtest010002` |
+| 代码工程 | `F:\ZDCode\xugong` |
+| 文档工程 | `F:\AI\Obsidian\项目文档\徐工\语音` |
+
+## 通用验证前置
+
+```bash
+adb devices
+adb shell pm clear com.txzing.voiceassistant
+adb shell pm clear com.yaxon.voice
+adb shell am start com.txzing.voiceassistant/com.txzing.assistant.core.console.ui.ConsoleActivity
+```
+
+## 验证清单
+
+| 验证项 | 操作 | 期望结果 | 状态 |
+|---|---|---|---|
+| TXZ 初始化 | 启动语音助手 | 初始化成功，有版本和连接日志 | 待验证 |
+| 语音服务启动 | 重启设备或启动服务 | `VoiceService` 正常创建并连接 TXZ | 待验证 |
+| 方控唤醒 | `adb shell am broadcast -a android.intent.action.start_txzvoice` | 语音界面或唤醒状态正常 | 待验证 |
+| 直接语音指令 | 发送 `startWithRawText` 指令 | TXZ 识别并分发到 YX_Voice | 待验证 |
+| 协议分发 | 执行车辆/空调/媒体指令 | `ProtocolManager` 和目标 Protocol 有日志 | 待验证 |
+| IPC 调用 | 执行业务控制 | 目标业务模块收到并执行 | 待验证 |
+| 状态同步 | 连接成功后同步状态 | 蓝牙、音量、亮度、车辆设置状态正确 | 待验证 |
+| 可见即可说 | 当前界面说出控件名称 | 控件被命中并触发点击 | 待验证 |
+| 异常恢复 | 清缓存后重新初始化 | 能恢复连接和指令处理 | 待验证 |
+
+## 验证记录模板
+
+### TEST-YYYYMMDD-XXX：验证标题
+
+| 字段 | 内容 |
+|---|---|
+| 日期 | 待填写 |
+| 关联 Bug/需求 | 待填写 |
+| 版本/构建号 | 待填写 |
+| 测试设备 | 待填写 |
+| 测试人员 | 待填写 |
+| 结论 | 通过 / 不通过 / 部分通过 |
+
+#### 验证步骤
+
+1. 待填写。
+2. 待填写。
+3. 待填写。
+
+#### 实际结果
+
+待填写。
+
+#### 关键日志
+
+```text
+待填写。
+```
+
+#### 遗留问题
+
+待填写。
+
+## 回归要求
+
+- 修改协议映射后，至少验证目标协议、相邻协议和未知指令处理。
+- 修改 TXZ 连接逻辑后，至少验证清缓存、冷启动、重启后连接。
+- 修改状态同步后，至少验证初始同步和状态变化后的再次同步。
+- 修改音频/唤醒相关逻辑后，至少保留 AudioFlinger/AudioPolicy dump 和录音文件结论。