Initial commit

REPO_INDEX.md

@@ -0,0 +1,56 @@
+# 全仓库索引（路径速查）
+
+**当前维护文档**以根 [README.md](./README.md) 为准（**OPERATION** / **REPRO** / **next**）。
+
+## 大目录
+
+| 路径 | 说明 |
+| ---- | ---- |
+| [`.cursor/`](./.cursor/) | Cursor 配置，非业务源码 |
+| [`chromiumos_kernel/v5.15/`](./chromiumos_kernel/v5.15/) | 可选对照用 ChromiumOS 5.15 树（浅克隆常见） |
+| [`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**。
+- 大目录变更：在本文件补一行。