chromebox_10th_audio_driver/docs/project-overview.md

chromebox_10th_audio_driver — 项目概览（BMad 文档扫描）

日期： 2026-04-05
类型： 近类 infra（脚本、补丁、自动化与文档为主；非典型 Terraform 独占仓库）
架构： 单体仓库（monolith），以 文档索引 + Shell 脚本 + 内核补丁 组织工作

文档体例：meta/DOCUMENTATION_STYLE.md

---

摘要

本仓库面向 Google Kaisa（Chromebox 10 代） 在 Coreboot 环境下的 跨平台音频问题（Linux HDMI、Windows 3.5mm 等），集中存放：

• 操作文档与路线图（docs/，含 Linux HDMI 主路线图）；
• Ubuntu HWE 6.17 内核补丁（patches/ubuntu-hwe-6.17/，0001–0003）与验证说明；
• 自动化脚本（scripts/，构建、diff、采集）；
• 可选对照源码树路径（chromiumos_kernel/、kernel-src/，大文件常不提交）。

不是以单一 package.json / Web 应用为核心的「典型 web 项目」；AI 代理实现变更时应以 最小 diff、对齐现有文档结构 为准。

---

分类

项	内容
仓库类型	单体（monolith）
主要语言	Bash、Markdown；内核相关为 C（补丁上下文）
架构模式	文档驱动 + 可重复实验脚本（内核构建、补丁应用、采集）

---

技术栈摘要

类别	技术/工件
自动化	Bash、ubuntu-hwe-617-build.sh
内核	Ubuntu linux-hwe-6.17 源码（apt source）、可选 chromiumos_kernel/v5.15
文档	CommonMark Markdown，docs/INDEX.md 为主题索引
版本控制	Git

---

关键能力（功能视角）

• Linux：SOF / iDisp / HDMI 排查路径、自编内核、0001/0002/0003 验证脚本。
• 采集：audio_topology/collected/、拓扑与 dmesg 基线。
• 对照：ChromeOS 5.15 与 Ubuntu 6.17 sound/soc diff 脚本与 reference。

---

架构要点

• 文档入口：根目录仅 README.md；详细索引为 INDEX.md 与 REPO_INDEX.md。
• 补丁与验证：patches/ubuntu-hwe-6.17/VERIFY_PATCHES.md。
• BMad 主索引（本工作流）：index.md（与 INDEX.md 并存：INDEX.md 为人用总目，index.md 面向 AI 检索约定）。

---

后续（棕地 PRD / 功能规划）

文档改写约定：meta/DOCUMENTATION_STYLE.md。规划新功能时请将 docs/index.md 与 docs/INDEX.md 一并纳入上下文；内核修改对齐 uname -r 与 patches/ubuntu-hwe-6.17/README.md。