# 源码树说明（Quick Scan）

**体例**：[meta/DOCUMENTATION_STYLE.md](meta/DOCUMENTATION_STYLE.md)。**扫描级别：** quick（基于目录与关键文件，非全量读源）

---

## 仓库根目录（节选）

```
chromebox_10th_audio_driver/
├── README.md              # 全仓库唯一根 README；文档入口表
├── REPO_INDEX.md          # 全路径索引（脚本、补丁、大目录）
├── help.md / bmad-help.zh-CN.md
├── next.md
├── docs/                  # 主题文档（INDEX.md、linux-hdmi/、meta/、kernel-build/ 等）
├── scripts/               # 构建、diff、验证、采集脚本
├── patches/
│   └── ubuntu-hwe-6.17/   # 0001–0003 补丁、VERIFY_PATCHES.md、STREAM_PCM 笔记
├── audio_topology/        # 拓扑采集脚本、collected/ 真机输出
├── chromiumos_kernel/     # 可选：ChromiumOS 5.15 对照树
├── kernel-src/            # 可选：Ubuntu HWE 6.17 解压源码（常 gitignore）
├── design-artifacts/
├── _bmad/                 # BMad 模块配置与工作流
└── _bmad-output/          # BMad 输出目录
```

---

## 关键目录用途

| 路径 | 用途 |
|------|------|
| **docs/** | 人读文档主区；**INDEX.md** 分类索引 |
| **scripts/** | `ubuntu-hwe-617-build.sh`、`verify-ubuntu-hwe617-patches-runtime.sh`、`diff-*` 等 |
| **patches/ubuntu-hwe-6.17/** | 内核补丁与对照笔记 |
| **audio_topology/** | 三平台音频采集与 **REPAIR_Plan_Audio.md** |
| **chromiumos_kernel/v5.15** | ChromeOS 内核对照（若已克隆） |
| **kernel-src/** | 本机 `apt source` 的 HWE 树（若存在） |

---

## 入口点（开发/实验）

- **应用补丁并编内核**：`scripts/ubuntu-hwe-617-build.sh` + 环境变量 `PATCH=`（见 **patches/ubuntu-hwe-6.17/README.md**）。
- **补丁真机验证**：`scripts/verify-ubuntu-hwe617-patches-runtime.sh`（成功输出 `VERIFY_OK`）。
- **文档导航**：从 **docs/INDEX.md** 或 **本工作流生成的 index.md** 进入子主题。