Obsidian/项目文档/徐工/语音/00_项目总览.md

徐工语音项目总览

一句话结论

徐工语音项目的核心是 YX_Voice 系统应用，它作为同行者 TXZ 语音助手与车载业务模块之间的桥接层，负责语音指令接收、协议分发、IPC 调用、车辆状态同步和语音相关问题排查。

当前定位

项目项	内容
项目名称	徐工语音项目
核心模块	YX_Voice
包名	com.yaxon.voice
应用类型	Android System Application
进程属性	系统持久化进程，persistent=true
运行身份	android.uid.system
语音方案	同行者 TXZ 语音助手
主要职责	TXZ 连接、语音指令分发、协议处理、IPC 调用、状态同步

核心链路

用户语音
  -> TXZ 语音助手
  -> VoiceService
  -> ProtocolManager
  -> YxProtocolHandler
  -> 具体 Protocol
  -> VoiceEventHelper
  -> YxIPC / 业务模块
  -> 状态同步回 TXZ

已有资料索引

文档	用途
YX_Voice_架构文档	系统架构、模块分层、核心链路
YX_Voice_模块详细文档	应用入口、服务、管理器、Helper、Receiver 等详细说明
YX_Voice_协议设计文档	协议接口、命令映射、Bundle 消息格式、状态同步
YX_Voice_配置文档	Gradle、Manifest、权限、IPC、TXZ 连接配置
同行者可见即可说自动注册框架对接方案_快速阅读	可见即可说接入原则、控件要求、AIDL/广播链路
../语音.md	调试命令、账号、问题汇总、资源路径
../语音_整理.md	原始整理记录
../语音唤醒异常问题分析.md	AudioFlinger dump 与唤醒异常排查
../log 录音分析.md	录音/音频相关原始分析材料

当前核心难点

难点	说明	风险
TXZ 连接与状态同步	连接成功后需同步车辆配置、蓝牙、音量、亮度、设置等状态	状态不同步会导致语音反馈与车机实际状态不一致
协议映射完整性	语音指令需要映射到正确协议和业务模块	漏映射会出现语音识别成功但功能无响应
IPC 可靠性	VoiceEventHelper 通过 IPC 控制音乐、设置、空调等模块	业务模块未绑定或接口变更会导致调用失败
可见即可说接入	控件需要唯一 ID、文本/隐藏标签、状态型描述动态更新	UI 可见但语音无法命中或命中错误状态
音频唤醒问题	涉及 AudioFlinger、AudioPolicy、录音 dump 和硬件输入链路	需要日志、dump 和录音文件联合判断

近期优先级

1. 固化调试命令和日志过滤方式，减少重复查找。
2. 维护 Bug 记录，区分现象、根因、修复和验证结果。
3. 建立协议/模块变更记录，避免接口变更后文档失真。
4. 用测试验证记录沉淀每次构建、安装、语音唤醒、指令执行、状态同步结果。
5. 后续进入代码修改时，再联动 F:\ZDCode\xugong 源码工程。

Agent 使用入口

每次让 Agent 处理本项目任务，建议先说：

先读取 agent.md 和 项目文档/徐工/语音/00_项目总览.md。
本次目标是：……
涉及日志/代码/文档是：……
先判断风险等级；如果要改文件，先问我要不要备份。
完成后把原因、处理方式、验证结果、遗留问题写入对应记录文档。