# 全仓库索引（路径速查）

**当前维护文档**以根 [README.md](./README.md) 为准（**OPERATION** / **REPRO** / **next**）。

## 大目录

| 路径 | 说明 |
| ---- | ---- |
| [`.cursor/`](./.cursor/) | Cursor 配置，非业务源码 |
| [`chromiumos_kernel/v5.15/`](./chromiumos_kernel/v5.15/) | 可选对照用 ChromiumOS kernel 工作树（**本机保留、主仓库不入库**；拉取/镜像/备份见 [`chromiumos_kernel/README.md`](./chromiumos_kernel/README.md)） |
| [`reference/ucm2/`](./reference/ucm2/) | Kaisa UCM2 overlay；见 [reference/ucm2/README.md](./reference/ucm2/README.md) |
| [`reference/chromeos-ubuntu-sound-diffs/`](./reference/chromeos-ubuntu-sound-diffs/) | 可选：本机 `diff -u` 生成物目录（见目录内 README） |
| [`_bmad/`](./_bmad/) | BMad 模块；总表 [`_bmad/_config/bmad-help.csv`](./_bmad/_config/bmad-help.csv) |
| [`_bmad-output/`](./_bmad-output/) | BMad 生成物（若存在） |

## [`docs/`](./docs/) — 正式文档

| 文件 | 说明 |
| ---- | ---- |
| [docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md](./docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md) | **核心问题复盘**、pro-audio、`default-profile`、恢复 Ubuntu 重测、基线（deb §4.4 存档） |
| [docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md](./docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md) | 可选 UCM / HiFi |
| [docs/linux-hdmi/REPRO_Kaisa_Deb_ProAudio_Manual.md](./docs/linux-hdmi/REPRO_Kaisa_Deb_ProAudio_Manual.md) | deb 手顺存档（未来计划） |

## [`audio_topology/`](./audio_topology/)

| 文件 | 说明 |
| ---- | ---- |
| [COLLECT.md](./audio_topology/COLLECT.md) | 拓扑采集用法 |
| [collect_linux_audio_topology.sh](./audio_topology/collect_linux_audio_topology.sh) 等 | 采集脚本 |
| [`collected/`](./audio_topology/collected/) | 实机 `*.txt` 等原始输出 |

## [`scripts/`](./scripts/) — 脚本

| 脚本 | 说明 |
| ---- | ---- |
| [capture-ubuntu-audio-baseline.sh](./scripts/capture-ubuntu-audio-baseline.sh) | 大改前 / overlay 或历史 deb 后采集系统音频基线 |
| [restore-ubuntu-audio-baseline.sh](./scripts/restore-ubuntu-audio-baseline.sh) | 恢复到某次基线 |
| [remove-kaisa-hdmi-deb.sh](./scripts/remove-kaisa-hdmi-deb.sh) | **purge `kaisa-hdmi-pipewire-fix`** + **reinstall `alsa-ucm-conf`**（仅清 deb，不改 WirePlumber） |
| [apply-kaisa-pro-audio.sh](./scripts/apply-kaisa-pro-audio.sh) / [verify-kaisa-pro-audio.sh](./scripts/verify-kaisa-pro-audio.sh) | 一键 pro-audio / 门禁 |
| [strip-kaisa-default-profile-state.sh](./scripts/strip-kaisa-default-profile-state.sh) | 去掉 WirePlumber `default-profile` 里 cml_rt5682 的 stereo-fallback 持久行 |
| [kaisa-reapply-pro-audio-session.sh](./scripts/kaisa-reapply-pro-audio-session.sh) | strip + 再拉 pro-audio（见 ProAudio §4.1b） |
| [build-deb.sh](./scripts/build-deb.sh) | 生成 `kaisa-hdmi-pipewire-fix_*.deb`（**未来计划**，当前不维护发布；若不存在见 ProAudio §4.4） |

BMad 中文帮助表生成：[`_bmad/scripts/render_bmad_help_zh_cn.py`](./_bmad/scripts/render_bmad_help_zh_cn.py) → 根目录 `bmad-help.zh-CN.md`。

## [`debian/`](./debian/)（deb 打包草稿，**未来计划**，当前不维护）

`kaisa-hdmi-pipewire-fix` 包定义与安装文件。

## 根目录

| 文件 | 说明 |
| ---- | ---- |
| [README.md](./README.md) | 仓库说明 |
| [next.md](./next.md) | 下一步速查 |
| [help.md](./help.md) | BMad 菜单码 |

## 维护

- 新增说明性文档：放入 **`docs/linux-hdmi/`** 或更新 **OPERATION**。
- 大目录变更：在本文件补一行。