docs(kaisa): make UCM HiFi the only supported path

Promote UCM2/HiFi (Jack-driven) as the primary delivery, add HISTORY.md,
remove ProAudio/REPRO docs and non-UCM scripts, and fix repo-wide references.

Made-with: Cursor
This commit is contained in:
2026-04-08 15:22:45 +08:00
parent 17f0a4521f
commit bda6b60c15
33 changed files with 384 additions and 1780 deletions

View File

@@ -17,9 +17,7 @@
| 文件 | 说明 |
| ---- | ---- |
| [docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md](./docs/linux-hdmi/OPERATION_PipeWire_Kaisa_ProAudio.md) | **核心问题复盘**、pro-audio、`default-profile`、恢复 Ubuntu 重测、基线deb §4.4 存档 |
| [docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md](./docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md) | 可选 UCM / HiFi |
| [docs/linux-hdmi/REPRO_Kaisa_Deb_ProAudio_Manual.md](./docs/linux-hdmi/REPRO_Kaisa_Deb_ProAudio_Manual.md) | deb 手顺存档(未来计划) |
| [docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md](./docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md) | **主路线(交付)**UCM2 + HiFiJack-driven |
## [`audio_topology/`](./audio_topology/)
@@ -33,13 +31,9 @@
| 脚本 | 说明 |
| ---- | ---- |
| [capture-ubuntu-audio-baseline.sh](./scripts/capture-ubuntu-audio-baseline.sh) | 大改前 / overlay 或历史 deb 后采集系统音频基线 |
| [restore-ubuntu-audio-baseline.sh](./scripts/restore-ubuntu-audio-baseline.sh) | 恢复到某次基线 |
| [remove-kaisa-hdmi-deb.sh](./scripts/remove-kaisa-hdmi-deb.sh) | **purge `kaisa-hdmi-pipewire-fix`** + **reinstall `alsa-ucm-conf`**(仅清 deb不改 WirePlumber |
| [apply-kaisa-pro-audio.sh](./scripts/apply-kaisa-pro-audio.sh) / [verify-kaisa-pro-audio.sh](./scripts/verify-kaisa-pro-audio.sh) | 一键 pro-audio / 门禁 |
| [strip-kaisa-default-profile-state.sh](./scripts/strip-kaisa-default-profile-state.sh) | 去掉 WirePlumber `default-profile` 里 cml_rt5682 的 stereo-fallback 持久行 |
| [kaisa-reapply-pro-audio-session.sh](./scripts/kaisa-reapply-pro-audio-session.sh) | strip + 再拉 pro-audio见 ProAudio §4.1b |
| [build-deb.sh](./scripts/build-deb.sh) | 生成 `kaisa-hdmi-pipewire-fix_*.deb`**未来计划**,当前不维护发布;若不存在见 ProAudio §4.4 |
| [disable-kaisa-pro-audio-wireplumber.sh](./scripts/disable-kaisa-pro-audio-wireplumber.sh) | 禁用强制 pro-audio 的 WirePlumber 片段(与 UCM 互斥) |
| [install-kaisa-ucm-overlay.sh](./scripts/install-kaisa-ucm-overlay.sh) | 安装 UCM2 overlay + `60-kaisa-ucm.lua` 到系统路径 |
| [remove-kaisa-ucm-overlay.sh](./scripts/remove-kaisa-ucm-overlay.sh) | 卸载本仓库安装的 UCM2 overlay 与系统级 `60-kaisa-ucm.lua` |
BMad 中文帮助表生成:[`_bmad/scripts/render_bmad_help_zh_cn.py`](./_bmad/scripts/render_bmad_help_zh_cn.py) → 根目录 `bmad-help.zh-CN.md`
@@ -52,7 +46,6 @@ BMad 中文帮助表生成:[`_bmad/scripts/render_bmad_help_zh_cn.py`](./_bmad
| 文件 | 说明 |
| ---- | ---- |
| [README.md](./README.md) | 仓库说明 |
| [next.md](./next.md) | 下一步速查 |
| [help.md](./help.md) | BMad 菜单码 |
## 维护