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

debian/control

@@ -16,10 +16,11 @@ Description: Google Kaisa HDMI audio fix (PipeWire / sof-rt5682, UCM2)
  GoogleKaisa/sof-rt5682) for Jack-driven HDMI routes plus IEC958 sequences,
  and a system-wide WirePlumber drop-in (pro-audio profile, HDMI sink
  priorities). Does not ship helper binaries or user systemd units yet —
- use manual pactl/amixer steps in OPERATION until automated restore is ready.
- UCM-first and pro-audio WirePlumber are mutually exclusive — see
- /usr/share/doc/kaisa-hdmi-pipewire-fix/README.md and OPERATION.
+ use manual pactl/amixer steps in upstream docs (ProAudio / UCM) until
+ automated restore is ready. UCM-first and pro-audio WirePlumber are mutually
+ exclusive — see /usr/share/doc/kaisa-hdmi-pipewire-fix/README.md and
+ docs in the source tree: OPERATION_PipeWire_Kaisa_ProAudio.md,
+ OPERATION_PipeWire_Kaisa_UCM_HiFi.md.
  .
  PCI path in the WirePlumber fragment targets BDF 0000:00:1f.3; edit under
- /etc/wireplumber/ if needed. See OPERATION_PipeWire_Kaisa_HDMI.md.gz in
- /usr/share/doc/.
+ /etc/wireplumber/ if needed.

debian/kaisa-hdmi-pipewire-fix/DEBIAN/control

@@ -12,10 +12,11 @@ Description: Google Kaisa HDMI audio fix (PipeWire / sof-rt5682, UCM2)
  GoogleKaisa/sof-rt5682) for Jack-driven HDMI routes plus IEC958 sequences,
  and a system-wide WirePlumber drop-in (pro-audio profile, HDMI sink
  priorities). Does not ship helper binaries or user systemd units yet —
- use manual pactl/amixer steps in OPERATION until automated restore is ready.
- UCM-first and pro-audio WirePlumber are mutually exclusive — see
- /usr/share/doc/kaisa-hdmi-pipewire-fix/README.md and OPERATION.
+ use manual pactl/amixer steps in upstream docs (ProAudio / UCM) until
+ automated restore is ready. UCM-first and pro-audio WirePlumber are mutually
+ exclusive — see /usr/share/doc/kaisa-hdmi-pipewire-fix/README.md and
+ docs in the source tree: OPERATION_PipeWire_Kaisa_ProAudio.md,
+ OPERATION_PipeWire_Kaisa_UCM_HiFi.md.
  .
  PCI path in the WirePlumber fragment targets BDF 0000:00:1f.3; edit under
- /etc/wireplumber/ if needed. See OPERATION_PipeWire_Kaisa_HDMI.md.gz in
- /usr/share/doc/.
+ /etc/wireplumber/ if needed.

debian/kaisa-hdmi-pipewire-fix/usr/share/doc/kaisa-hdmi-pipewire-fix/README.md

@@ -1,6 +1,6 @@
 # Kaisa UCM2 overlay（`sof-rt5682`）
 
-本目录为 **alsa-ucm-conf** 风格的 **UCM2** 草稿，目标：**Jack off 时 HDMI 路由对 ACP/桌面不表现为可随意可用的输出**（与强制 **`pro-audio`** 的 WirePlumber 策略不同，见 [docs/linux-hdmi/OPERATION_PipeWire_Kaisa_HDMI.md](../../../../../../docs/linux-hdmi/OPERATION_PipeWire_Kaisa_HDMI.md)「UCM 模式 vs pro-audio 模式」）。
+本目录为 **alsa-ucm-conf** 风格的 **UCM2** 草稿，目标：**Jack off 时 HDMI 路由对 ACP/桌面不表现为可随意可用的输出**（与强制 **`pro-audio`** 的 WirePlumber 策略不同，见源码树 **[UCM 操作文档](../../../../../../docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md)** 与 **[ProAudio](../../../../../../docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md)**）。
 
 ## 布局
 
@@ -9,7 +9,7 @@
 | `conf.d/sof-rt5682/sof-rt5682.conf` | 卡入口，匹配 ALSA **card name** `sof-rt5682` |
 | `GoogleKaisa/sof-rt5682/HiFi.conf` | HiFi：`Port1` + **HDMI1/2/3**，**JackControl** + **`IEC958',N`** |
 
-上游 **alsa-ucm-conf** 若日后增加同名 `conf.d/sof-rt5682/`，与本仓库 **deb 同时安装会冲突** — 优先 **合并上游** 或 **改名/拆包**（与 [OPERATION](../../../../../../docs/linux-hdmi/OPERATION_PipeWire_Kaisa_HDMI.md) 中 UCM / pro-audio 互斥说明一致）。
+上游 **alsa-ucm-conf** 若日后增加同名 `conf.d/sof-rt5682/`，与本仓库 **deb 同时安装会冲突** — 优先 **合并上游** 或 **改名/拆包**（与源码树 [UCM / ProAudio 文档](../../../../../../docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md) 中互斥说明一致）。
 
 ## 手工安装（调试）