全仓库索引（Index Docs）

面向 LLM / 换机交接：快速定位本仓库「与 Chromebox 音频、Linux HDMI、内核补丁」相关的路径。
详细文档主题索引仍以 docs/INDEX.md 为准（表格更全）。

未纳入逐条列举的目录

以下体积大或为上游/工具树，本索引只作说明，不展开每个文件：

路径	说明
`.cursor/`	Cursor 编辑器技能与配置，非项目业务源码
`kernel-src/linux-hwe-6.17-*/`	Ubuntu HWE 内核解压树、`.dsc` / `.deb` / 构建日志；说明见 `kernel-src/README.md`
`chromiumos_kernel/v5.15/`	ChromiumOS 5.15 对照用内核树（浅克隆/sparse 常见）
`_bmad/`	BMad Method 安装模块（技能与工作流）；总目录见 `_bmad/_config/bmad-help.csv`
`_bmad-output/`	BMad 生成物输出目录（若存在）

文件	说明
README.md	唯一仓库 README：问题表、任务、文档入口
REPO_INDEX.md	本文件：全仓库导航
help.md	BMad 菜单码速查（Core / Method / CIS 等）
bmad-help.zh-CN.md	`_bmad/_config/bmad-help.csv` 全表中文对照（脚本生成）

文件 / 目录	说明
docs/INDEX.md	`docs/` 主题索引（Linux HDMI、内核安装、脚本等）
docs/WORK_PROGRESS.md	重定向 → `docs/meta/WORK_PROGRESS.md`
docs/Linux_HDMI_Audio_Roadmap.md	重定向 → `docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md`
docs/linux-hdmi/	HDMI 路线图、重分析、ChromeOS 对照、trace、上游复现
docs/kernel-build/	自编内核安装、ChromiumOS 深度 diff 操作
docs/meta/	工作进度、双系统、自动 diff 摘要
docs/windows/	Windows 音频与硬件 ID 文档

文件	说明
ANALYSIS_Audio.md	三平台技术分析与对比
REPAIR_Plan_Audio.md	Linux / Windows 分平台修复与文档索引
COLLECT.md	拓扑采集脚本用法
OPERATION_Force_Intel_Signed_Firmware.md	intel-signed 固件路径与回退
collect_linux_audio_topology.sh	Linux 拓扑与 dmesg 等一键采集
collect_chromeos_audio_topology.sh	ChromeOS 侧采集
collect_shell_audio.sh	Shell 环境采集辅助

真机/脚本生成的 原始采集与 trace（*.txt 为主）；说明见 README_TRACE_KAISA.md。文件随实验累积，按文件名日期与主机名区分。

文件	说明
README.md	补丁顺序、`PATCH=` 应用方式
0001-*.patch	ipc3-pcm FREE/trigger 与 Chromium 对齐
0002-*.patch	`STREAM_PCM_PARAMS` 诊断打印（不改载荷）
DIFF_SUMMARY.txt	补丁设计备忘
STREAM_PCM_PARAMS_CHROME_UBUNTU_NOTES.md	IPC 载荷与 Chrome 对照笔记
reference/	导出用 unified diff 文本（ipc3/pcm/hda-dai）

脚本	说明
ubuntu-hwe-617-build.sh	`apply` / `deps` / `build` / `install` HWE 6.17 deb
verify-ubuntu-hwe617-0001-patch.sh	0001 补丁 `patch --dry-run`
linux-hdmi-followup-workflow.sh	HDMI 后续 diff / 文档入口
diff-chromeos-ubuntu-sound.sh	`sound/soc` 统计对照
preflight-chromeos-ubuntu-diff.sh	双树预检并跑 diff + export
export-chromeos-ubuntu-sound-file-diffs.sh	导出关键文件 unified diff
collect-kaisa-sof-trace.sh	Kaisa SOF trace 采集
collect-hda-link-ftrace.sh	§6.1：`hda_link_dma` / `set_stream_id` / `sof_ipc3_pcm_hw_params` function_graph
export-boards-chrome-ubuntu-diff.sh	导出 `sof_rt5682` / `sof_board_helpers` Chrome vs 6.17 diff

条目	说明
README.md	`apt source`、`debian/rules`、`make mrproper` 注意
`linux-hwe-6.17-6.17.0/`	解压后的内核源码（含 `debian/` 时方可 `binary-generic`）
`.dsc` / `.orig.tar.gz` / `*.diff.gz`	Ubuntu 源码包元数据与 tarball
`linux-*.deb` / `full-build.log`	构建产物或日志（视本机是否编过）

对照 ChromeOS 5.15 行为用；克隆与 sparse 说明见 docs/meta/WORK_PROGRESS.md。

人机速查可配合根目录 help.md。