# 全仓库索引（Index Docs） 面向 **LLM / 换机交接**：快速定位本仓库「与 Chromebox 音频、Linux HDMI、内核补丁」相关的路径。 **详细文档主题索引**仍以 [docs/INDEX.md](./docs/INDEX.md) 为准（表格更全）。 --- ## 未纳入逐条列举的目录 以下体积大或为上游/工具树，本索引**只作说明**，不展开每个文件： | 路径 | 说明 | | ---- | ---- | | [`.cursor/`](./.cursor/) | Cursor 编辑器技能与配置，非项目业务源码 | | [`kernel-src/linux-hwe-6.17-*/`](./kernel-src/) | Ubuntu HWE 内核解压树、`.dsc` / `.deb` / 构建日志；说明见 [`kernel-src/README.md`](./kernel-src/README.md) | | [`chromiumos_kernel/v5.15/`](./chromiumos_kernel/v5.15/) | ChromiumOS 5.15 对照用内核树（浅克隆/sparse 常见） | | [`_bmad/`](./_bmad/) | BMad Method 安装模块（技能与工作流）；总目录见 [`_bmad/_config/bmad-help.csv`](./_bmad/_config/bmad-help.csv) | | [`_bmad-output/`](./_bmad-output/) | BMad 生成物输出目录（若存在） | --- ## 根目录 | 文件 | 说明 | | ---- | ---- | | [README.md](./README.md) | **唯一仓库 README**：问题表、任务、文档入口 | | [REPO_INDEX.md](./REPO_INDEX.md) | 本文件：全仓库导航 | | [help.md](./help.md) | BMad 菜单码速查（Core / Method / CIS 等） | | [bmad-help.zh-CN.md](./bmad-help.zh-CN.md) | `_bmad/_config/bmad-help.csv` 全表中文对照（脚本生成） | --- ## [`docs/`](./docs/) — 正式文档 | 文件 / 目录 | 说明 | | ----------- | ---- | | [docs/INDEX.md](./docs/INDEX.md) | **`docs/` 主题索引**（Linux HDMI、内核安装、脚本等） | | [docs/WORK_PROGRESS.md](./docs/WORK_PROGRESS.md) | 重定向 → `docs/meta/WORK_PROGRESS.md` | | [docs/Linux_HDMI_Audio_Roadmap.md](./docs/Linux_HDMI_Audio_Roadmap.md) | 重定向 → `docs/linux-hdmi/Linux_HDMI_Audio_Roadmap.md` | | [docs/linux-hdmi/](./docs/linux-hdmi/) | HDMI 路线图、重分析、ChromeOS 对照、trace、上游复现 | | [docs/kernel-build/](./docs/kernel-build/) | 自编内核安装、ChromiumOS 深度 diff 操作 | | [docs/meta/](./docs/meta/) | 工作进度、双系统、自动 diff 摘要 | | [docs/windows/](./docs/windows/) | Windows 音频与硬件 ID 文档 | --- ## [`audio_topology/`](./audio_topology/) — 拓扑、采集、修复计划 | 文件 | 说明 | | ---- | ---- | | [ANALYSIS_Audio.md](./audio_topology/ANALYSIS_Audio.md) | 三平台技术分析与对比 | | [REPAIR_Plan_Audio.md](./audio_topology/REPAIR_Plan_Audio.md) | Linux / Windows 分平台修复与文档索引 | | [COLLECT.md](./audio_topology/COLLECT.md) | 拓扑采集脚本用法 | | [OPERATION_Force_Intel_Signed_Firmware.md](./audio_topology/OPERATION_Force_Intel_Signed_Firmware.md) | intel-signed 固件路径与回退 | | [collect_linux_audio_topology.sh](./audio_topology/collect_linux_audio_topology.sh) | Linux 拓扑与 dmesg 等一键采集 | | [collect_chromeos_audio_topology.sh](./audio_topology/collect_chromeos_audio_topology.sh) | ChromeOS 侧采集 | | [collect_shell_audio.sh](./audio_topology/collect_shell_audio.sh) | Shell 环境采集辅助 | ### [`audio_topology/collected/`](./audio_topology/collected/) 真机/脚本生成的 **原始采集与 trace**（`*.txt` 为主）；说明见 [README_TRACE_KAISA.md](./audio_topology/collected/README_TRACE_KAISA.md)。文件随实验累积，**按文件名日期与主机名区分**。 --- ## [`patches/ubuntu-hwe-6.17/`](./patches/ubuntu-hwe-6.17/) — Ubuntu HWE 6.17 内核补丁 | 文件 | 说明 | | ---- | ---- | | [README.md](./patches/ubuntu-hwe-6.17/README.md) | 补丁顺序、`PATCH=` 应用方式 | | [0001-*.patch](./patches/ubuntu-hwe-6.17/0001-ASoC-SOF-ipc3-pcm-await-DSP-reply-for-FREE-and-trigger.patch) | ipc3-pcm FREE/trigger 与 Chromium 对齐 | | [0002-*.patch](./patches/ubuntu-hwe-6.17/0002-ASoC-SOF-ipc3-pcm-dump-STREAM_PCM_PARAMS-fields.patch) | `STREAM_PCM_PARAMS` 诊断打印（不改载荷） | | [DIFF_SUMMARY.txt](./patches/ubuntu-hwe-6.17/DIFF_SUMMARY.txt) | 补丁设计备忘 | | [STREAM_PCM_PARAMS_CHROME_UBUNTU_NOTES.md](./patches/ubuntu-hwe-6.17/STREAM_PCM_PARAMS_CHROME_UBUNTU_NOTES.md) | IPC 载荷与 Chrome 对照笔记 | | [reference/](./patches/ubuntu-hwe-6.17/reference/) | 导出用 unified diff 文本（ipc3/pcm/hda-dai） | --- ## [`scripts/`](./scripts/) — 仓库脚本 | 脚本 | 说明 | | ---- | ---- | | [ubuntu-hwe-617-build.sh](./scripts/ubuntu-hwe-617-build.sh) | `apply` / `deps` / `build` / `install` HWE 6.17 deb | | [verify-ubuntu-hwe617-0001-patch.sh](./scripts/verify-ubuntu-hwe617-0001-patch.sh) | 0001 补丁 `patch --dry-run` | | [linux-hdmi-followup-workflow.sh](./scripts/linux-hdmi-followup-workflow.sh) | HDMI 后续 diff / 文档入口 | | [diff-chromeos-ubuntu-sound.sh](./scripts/diff-chromeos-ubuntu-sound.sh) | `sound/soc` 统计对照 | | [preflight-chromeos-ubuntu-diff.sh](./scripts/preflight-chromeos-ubuntu-diff.sh) | 双树预检并跑 diff + export | | [export-chromeos-ubuntu-sound-file-diffs.sh](./scripts/export-chromeos-ubuntu-sound-file-diffs.sh) | 导出关键文件 unified diff | | [collect-kaisa-sof-trace.sh](./scripts/collect-kaisa-sof-trace.sh) | Kaisa SOF trace 采集 | | [collect-hda-link-ftrace.sh](./scripts/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](./scripts/export-boards-chrome-ubuntu-diff.sh) | 导出 `sof_rt5682` / `sof_board_helpers` Chrome vs 6.17 diff | --- ## [`kernel-src/`](./kernel-src/) — 内核源码与构建产物 | 条目 | 说明 | | ---- | ---- | | [README.md](./kernel-src/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` | 构建产物或日志（视本机是否编过） | --- ## [`chromiumos_kernel/`](./chromiumos_kernel/) 对照 **ChromeOS 5.15** 行为用；克隆与 sparse 说明见 [docs/meta/WORK_PROGRESS.md](./docs/meta/WORK_PROGRESS.md)。 --- ## [`_bmad/`](./_bmad/) — BMad 模块（工具型） | 条目 | 说明 | | ---- | ---- | | [`_bmad/_config/bmad-help.csv`](./_bmad/_config/bmad-help.csv) | 已安装技能与菜单码总表 | | [`_bmad/core/config.yaml`](./_bmad/core/config.yaml) | Core 模块配置（语言、输出目录等） | | `bmb/`、`bmm/`、`cis/`、`tea/`、`gds/`、`wds/` 等 | 各子模块技能与工作流 Markdown | 人机速查可配合根目录 [help.md](./help.md)。 --- ## 维护说明 - 新增 **正式设计文档**：优先放入 `docs/` 并更新 [docs/INDEX.md](./docs/INDEX.md)。 - 新增 **顶层目录或大目录**：在本文件对应小节补一行。 - **Index Docs（`bmad-index-docs`）** 技能：以本文件 + `docs/INDEX.md` 为仓库文档地图即可覆盖主要用例。