bmad base

docs/source-tree-analysis.md

@@ -0,0 +1,46 @@
+# 源码树说明（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** 进入子主题。