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
This commit is contained in:
2026-04-08 11:07:13 +08:00
parent 5c7d0aa360
commit 17f0a4521f
29 changed files with 1505 additions and 427 deletions

View File

@@ -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/`,与 **本 overlay 或历史 deb 路径** 可能冲突 — 优先 **合并上游****改名/拆包**(与 [UCM / ProAudio 文档](../../docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md) 中互斥说明一致;**deb 当前不作为交付**,见 [ProAudio §4.4](../../docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md))。
## 手工安装(调试)
@@ -46,6 +46,8 @@ alsaucm -c sof-rt5682 set _verb HiFi list _devices
插拔 HDMI 时对照 **`amixer -c0`** 中 **`HDMI/DP,pcm=N` Jack** 与 **`IEC958',N`**。
**一次跑完(推荐)**:在仓库根目录执行 **`./scripts/verify-kaisa-audio-environment.sh`**(可选 **`--output ~/kaisa-audio-verify.txt`**覆盖硬件枚举、UCM、PipeWire、WirePlumber 与摘要;详见 [ProAudio 文档](../../docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md)「一键环境验证」。
## 实机验收表(勾选)
| 步骤 | 预期 |