first commit

项目文档/徐工/语音/03_日志分析记录.md

@@ -0,0 +1,96 @@
+# 徐工语音日志分析记录
+
+## 日志分析流程
+
+```text
+确认问题现象
+  -> 确认时间点
+  -> 收集 logcat / dumpsys / 录音 / 截图
+  -> 提取关键字
+  -> 建立时间线
+  -> 区分现象、直接原因、根因
+  -> 给出验证动作
+```
+
+## 常用调试命令
+
+### 语音唤醒与调用
+
+```bash
+adb shell am broadcast -a android.intent.action.start_txzvoice
+adb shell am start com.txzing.voiceassistant/com.txzing.assistant.core.console.ui.ConsoleActivity
+adb shell am broadcast -a com.txznet.txz.invoke -d "txznet://com.txznet.txz/comm.asr.startWithRawText?打开空调"
+```
+
+### 缓存清理
+
+```bash
+adb shell pm clear com.txzing.voiceassistant
+adb shell pm clear com.yaxon.voice
+```
+
+### 音频排查
+
+```bash
+adb shell setprop persist.pcm.dump 9
+adb shell dumpsys media.audio_flinger > audio_flinger.log
+adb shell dumpsys media.audio_policy > audio_policy.log
+adb shell dumpsys audio > audio.log
+adb shell setprop persist.pcm.dump 0
+adb pull /data/misc/audioserver/dump_audio_9.pcm
+```
+
+## 常用过滤关键字
+
+| 场景 | 关键字 |
+|---|---|
+| 中间件报文 | `processBodyControl` |
+| 语音模块 | `package:com.yaxon.voice`、`VoiceEventHelper`、`sendCommandTxz` |
+| 协议逻辑 | `VoiceProtocol`、`ProtocolManager`、`YxProtocolHandler` |
+| 同行者状态 | `defaultRegisterHandler`、`TxzProtocolManager` |
+| 激活状态 | `onActivationSuccess` |
+| 初始化 | `initialize: versions` |
+| 音频 dump | `AudioFlinger`、`Input thread`、`Output thread`、`Frames read` |
+
+## 分析记录模板
+
+### LOG-YYYYMMDD-XXX：问题标题
+
+| 字段 | 内容 |
+|---|---|
+| 日期 | 待填写 |
+| 关联 Bug | 待填写 |
+| 日志来源 | 待填写 |
+| 时间范围 | 待填写 |
+| 设备/版本 | 待填写 |
+| 分析状态 | 待分析 / 已定位 / 待复测 |
+
+#### 问题现象
+
+待填写。
+
+#### 关键时间线
+
+| 时间 | 进程/模块 | 日志摘要 | 判断 |
+|---|---|---|---|
+| 待填写 | 待填写 | 待填写 | 待填写 |
+
+#### 关键证据
+
+```text
+粘贴关键日志片段，避免贴整份日志。
+```
+
+#### 初步结论
+
+待填写。
+
+#### 需要补充的证据
+
+- 待填写。
+
+## 已有关联资料
+
+- [[../语音唤醒异常问题分析]]
+- [[../log 录音分析]]
+- [[../语音]]