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

**当前维护文档**以根 [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_HDMI.md](./docs/linux-hdmi/OPERATION_PipeWire_Kaisa_HDMI.md) | PipeWire / deb / 基线 |
| [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) | 安装 deb / 大改前采集系统音频基线 |
| [restore-ubuntu-audio-baseline.sh](./scripts/restore-ubuntu-audio-baseline.sh) | 恢复到某次基线 |
| [build-deb.sh](./scripts/build-deb.sh) | 生成 `kaisa-hdmi-pipewire-fix_*.deb`（**≥0.3.0** 仅 **UCM2 + WirePlumber**，无 `/usr/bin` 辅助脚本） |

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

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

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

## 根目录

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

## 维护

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