bmad base

docs/development-guide.md

@@ -0,0 +1,66 @@
+# 开发与实验指南（chromebox_10th_audio_driver）
+
+**体例**：[meta/DOCUMENTATION_STYLE.md](meta/DOCUMENTATION_STYLE.md)。**面向：** 维护文档、打补丁、真机验证。
+
+---
+
+## 前置条件
+
+- **Linux（推荐 Ubuntu 24.04 Noble）**：与 **HWE 6.17** 内核文档路径一致。
+- 工具：**bash**、**git**、**patch**；编内核时需 **fakeroot**、**dpkg-dev**、**debhelper** 等（见 **kernel-src/README.md** 与 **`scripts/ubuntu-hwe-617-build.sh deps`**）。
+- 大目录：**kernel-src** 解压与 **deb 构建** 需 **数十 GB** 磁盘空间。
+
+---
+
+## 克隆与目录
+
+```bash
+git clone <本仓库 URL> chromebox_10th_audio_driver
+cd chromebox_10th_audio_driver
+```
+
+可选：按 **docs/meta/WORK_PROGRESS.md** 拉取 **chromiumos_kernel**、**kernel-src**（不提交二进制/大 tarball）。
+
+---
+
+## 应用补丁并构建（摘要）
+
+```bash
+export PATCH="$PWD/patches/ubuntu-hwe-6.17/0001-....patch"
+./scripts/ubuntu-hwe-617-build.sh apply
+# 按需继续 0002、0003
+./scripts/ubuntu-hwe-617-build.sh deps
+./scripts/ubuntu-hwe-617-build.sh build
+```
+
+完整安装 **linux-image-unsigned**、**modules**、**modules-extra**：**docs/kernel-build/OPERATION_Install_CustomKernel_Ubuntu_HWE617.md**。
+
+---
+
+## 验证补丁（真机）
+
+```bash
+./scripts/verify-ubuntu-hwe617-patches-runtime.sh
+RUN_HDMI_TEST=0 ./scripts/verify-ubuntu-hwe617-patches-runtime.sh   # 不跑 speaker-test
+```
+
+说明：**patches/ubuntu-hwe-6.17/VERIFY_PATCHES.md**。
+
+---
+
+## 文档维护约定
+
+- **全项目体例与改写自检**：[meta/DOCUMENTATION_STYLE.md](meta/DOCUMENTATION_STYLE.md)。
+- 新主题：在 **docs/INDEX.md**（或 **REPO_INDEX.md**）增加**一条**链入，避免孤岛文档。
+- 用户向说明：默认 **中文**（与 **\_bmad/bmm/config.yaml** 一致）。
+- **勿**在无请求时批量修改 **.cursor/plans/**（见 **WORK_PROGRESS** 说明）。
+
+---
+
+## 常用引用
+
+| 文档 | 内容 |
+|------|------|
+| **docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md** | Linux HDMI 分阶段路线图 |
+| **patches/ubuntu-hwe-6.17/DIFF_SUMMARY.txt** | 补丁设计与 smoke |
+| **audio_topology/REPAIR_Plan_Audio.md** | Linux / Windows 分平台修复总览 |