# 徐工语音测试验证记录

## 验证目标

将每次语音模块修改、配置调整、资源替换和问题修复都沉淀为可复用的验证记录，覆盖主流程、异常流程和回归项。

## 基础验证环境

| 项 | 内容 |
|---|---|
| 项目 | 徐工 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 和录音文件结论。