52 lines
1.9 KiB
Markdown
52 lines
1.9 KiB
Markdown
|
# 徐工语音决策记录
|
||
|
|
|
||
|
|
## 使用规则
|
||
|
|
|
||
|
|
本文件记录影响项目方向、接口契约、模块边界、测试策略、资源路径和风险取舍的决策。不要删除旧决策；如果结论变化，用“更新标记”追加。
|
||
|
|
|
||
|
|
## 决策列表
|
||
|
|
|
||
|
|
| 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 接口、并发/生命周期逻辑。
|
||
|
|
- 高风险变更必须先给计划并等待确认。
|