# 徐工语音决策记录

## 使用规则

本文件记录影响项目方向、接口契约、模块边界、测试策略、资源路径和风险取舍的决策。不要删除旧决策；如果结论变化，用“更新标记”追加。

## 决策列表

| ID      | 日期         | 决策                                                   | 原因                           | 影响范围        | 状态  |
| ------- | ---------- | ---------------------------------------------------- | ---------------------------- | ----------- | --- |
| ADR-001 | 2026-06-15 | 先在 Obsidian 建立语音项目工程化文档骨架，不直接改 `F:\ZDCode\xugong` 源码 | 当前目标是建立长期记忆和协作流程，不是修具体代码 Bug | 文档工程        | 生效  |
| ADR-002 | 2026-06-15 | 语音项目入口文档使用 `00_项目总览.md`                              | 让 Agent 和人都能先读一个入口文件快速进入上下文  | Obsidian 文档 | 生效  |
| ADR-003 | 2026-06-15 | Bug、日志、测试、决策分文件记录                                    | 避免问题分析、验证结论和需求设计混在同一文档中      | 项目管理方式      | 生效  |

## 决策模板

### ADR-XXX：标题

| 字段 | 内容 |
|---|---|
| 日期 | 待填写 |
| 背景 | 待填写 |
| 决策 | 待填写 |
| 备选方案 | 待填写 |
| 选择原因 | 待填写 |
| 影响范围 | 待填写 |
| 风险 | 待填写 |
| 验证方式 | 待填写 |
| 状态 | 生效 / 废弃 / 被替代 |

#### 背景

待填写。

#### 决策

待填写。

#### 影响

待填写。

#### 更新记录

- 待填写。

## 当前约束

- 项目文档放在 `F:\AI\Obsidian\项目文档\徐工\语音`。
- 代码工程位于 `F:\ZDCode\xugong`，只有进入具体开发/修复任务时才修改。
- 高风险变更包括协议契约、权限、状态同步、TXZ 连接、IPC 接口、并发/生命周期逻辑。
- 高风险变更必须先给计划并等待确认。