docs(kaisa): ProAudio 主路线、WirePlumber default-profile 与一键脚本

- 新增 OPERATION_PipeWire_Kaisa_ProAudio / UCM_HiFi，核心问题复盘与恢复 Ubuntu 重测手顺；HDMI 旧文改为 stub。
- 脚本：apply / verify-pro-audio、strip default-profile、reapply-session、remove deb 与 UCM overlay、verify-audio-environment。
- systemd-user：kaisa-pro-audio-reapply.service 示例。
- README、docs 索引、REPO_INDEX、REPRO deb 存档说明；deb 标为未来计划；reference/ucm2 与采集脚本小改。
- debian 与 _bmad-output 规划文件随本次工作区一并更新。

Made-with: Cursor

README.md

@@ -1,16 +1,17 @@
 # chromebox_10th_audio_driver
 
-Google **Kaisa**（Chromebox 10）上 **Ubuntu + PipeWire** 的 **HDMI 出声**交付：仓库主线为 **`pro-audio` + IEC958 + WirePlumber 片段**（及可选 **UCM2**），与 **`kaisa-hdmi-pipewire-fix` deb**。**自编内核 / SOF 诊断补丁**与 **`kernel-src/` 大目录**已不随仓库提供；若要做 **ChromiumOS ↔ HWE** 源码对照，在本机 **`apt source linux-hwe-6.17`** 后对两棵树自行 **`diff -u`** / **`diff -rq`**（**`chromiumos_kernel/v5.15`** 与解压的 `linux-hwe-6.17-*`）。
+Google **Kaisa**（Chromebox 10）上 **Ubuntu + PipeWire** 的 **HDMI 出声**交付：仓库主线为 **`pro-audio` + IEC958 + WirePlumber 用户级片段**（及可选 **UCM2 overlay 脚本**）。**`kaisa-hdmi-pipewire-fix` deb 不作为当前交付**，仅作未来计划（见 [ProAudio §4.4](docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md) 存档）。**自编内核 / SOF 诊断补丁**与 **`kernel-src/` 大目录**已不随仓库提供；若要做 **ChromiumOS ↔ HWE** 源码对照，在本机 **`apt source linux-hwe-6.17`** 后对两棵树自行 **`diff -u`** / **`diff -rq`**（**`chromiumos_kernel/v5.15`** 与解压的 `linux-hwe-6.17-*`）。
 
 ## 文档（仅保留已实机验证路线）
 
 | 你想… | 打开 |
 | ----- | ---- |
-| **操作与排障**（WirePlumber、`50-kaisa-…`、deb、基线脚本） | [docs/linux-hdmi/OPERATION_PipeWire_Kaisa_HDMI.md](docs/linux-hdmi/OPERATION_PipeWire_Kaisa_HDMI.md) |
-| **deb 手顺与验收** | [docs/linux-hdmi/REPRO_Kaisa_Deb_ProAudio_Manual.md](docs/linux-hdmi/REPRO_Kaisa_Deb_ProAudio_Manual.md) |
+| **操作与排障（pro-audio 主路线）** | [docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md](docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md)（文内 **「核心问题」**、**恢复 Ubuntu 后重测**） |
+| **UCM / HiFi（可选）** | [docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md](docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md) |
+| **deb 手顺（存档，未来计划）** | [docs/linux-hdmi/REPRO_Kaisa_Deb_ProAudio_Manual.md](docs/linux-hdmi/REPRO_Kaisa_Deb_ProAudio_Manual.md) |
 | 速查下一步 | [next.md](next.md) |
 | 全仓库路径与脚本表 | [REPO_INDEX.md](REPO_INDEX.md) |
-| UCM2 源码（打入 deb） | [reference/ucm2/README.md](reference/ucm2/README.md) |
+| UCM2 源码（overlay / 曾拟打入 deb） | [reference/ucm2/README.md](reference/ucm2/README.md) |
 | 拓扑采集脚本 | [audio_topology/COLLECT.md](audio_topology/COLLECT.md) |
 | BMad 菜单码 | [bmad-help.zh-CN.md](bmad-help.zh-CN.md) |
 | 产品需求（若仍用 BMad） | [_bmad-output/planning-artifacts/prd.md](_bmad-output/planning-artifacts/prd.md) |
@@ -25,12 +26,15 @@ Google **Kaisa**（Chromebox 10）上 **Ubuntu + PipeWire** 的 **HDMI 出声**
 |------|------|-------|
 | Linux（本仓库目标） | 需 **pro-audio profile** + 正确 **IEC958** / 默认 sink；**`stereo-fallback` 常仅一路** | 一般有（以本机 `aplay -L` 为准） |
 
-细节以 **OPERATION** 为准。
+细节以 **[ProAudio 文档](docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md)** 为准。
 
 ---
 
 ## 速链
 
-- **基线**：`scripts/capture-ubuntu-audio-baseline.sh`（装 deb / 大改前）、`scripts/restore-ubuntu-audio-baseline.sh`（回滚）— [OPERATION](docs/linux-hdmi/OPERATION_PipeWire_Kaisa_HDMI.md) §4.5。
-- **打 deb**：`debian/` + `scripts/build-deb.sh`（**≥0.3.0** 包内为 **UCM2 + WirePlumber 片段**，无随包 shell 工具）。
+- **基线**：`scripts/capture-ubuntu-audio-baseline.sh`（大改前 / 曾用 overlay 或历史 deb 时）、`scripts/restore-ubuntu-audio-baseline.sh`（回滚）— [ProAudio 文档](docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md) §4.5。
+- **一键 pro-audio**：`scripts/apply-kaisa-pro-audio.sh`（默认 purge 已装的 `kaisa-hdmi-pipewire-fix` + 应用 + `verify-kaisa-pro-audio.sh` 门禁）；仅校验：`scripts/verify-kaisa-pro-audio.sh` — 见 [ProAudio「一键脚本」](docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md)。
+- **只卸历史 deb**：`scripts/remove-kaisa-hdmi-deb.sh`（`apt purge kaisa-hdmi-pipewire-fix` + `reinstall alsa-ucm-conf`，不改 WirePlumber）。
+- **登录后 pro-audio 被顶掉**：多为 **`~/.local/state/wireplumber/default-profile`** 里持久了 **stereo-fallback**；`scripts/strip-kaisa-default-profile-state.sh` 或重跑 **`apply-kaisa-pro-audio.sh`**。仍偶发再用 `scripts/kaisa-reapply-pro-audio-session.sh` / [§4.1b](docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md)。
+- **打 deb（未来计划）**：`debian/` + `scripts/build-deb.sh` 仅作存档，**当前不维护发布**；见 [ProAudio §4.4](docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md)。
 - 原始拓扑与 dmesg：`audio_topology/collected/`（`baseline-stash/` 见 `.gitignore`）。