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

wireplumber/main.lua.d/60-kaisa-ucm.lua

@@ -2,7 +2,13 @@
 -- WirePlumber 0.4.x: appended after stock alsa rules.
 --
 -- 若仅启用 use-ucm 而不固定 profile，栈常会默认选 stereo-fallback，界面只剩模拟/耳机，HDMI 消失。
--- 固定为 UCM 中 SectionUseCase 名 "HiFi"；并关闭 auto-profile，避免抢回 stereo-fallback。
+--
+-- 重要（policy-device-profile.lua / findBestProfile）：若下面 KAISA_WP_DEVICE_PROFILE 设为 "HiFi"，
+-- 但 PipeWire 的 EnumProfile 里还没有名为 HiFi 的条目（pactl「配置文件」仅有 off / pro-audio），
+-- WirePlumber 无法匹配 device.profile，最终会把活动配置留在 off，且 pactl set-card-profile HiFi
+-- 报「无此实体」。此时请保持 "pro-audio" 先恢复输出；待 install-kaisa-ucm-overlay + 重启后 pactl 已出现
+-- HiFi: 时，再把本变量改为 "HiFi" 并重启用户 pipewire 栈。
+local KAISA_WP_DEVICE_PROFILE = "pro-audio" -- 或 "HiFi"
 
 table.insert(alsa_monitor.rules, {
   matches = {
@@ -15,6 +21,6 @@ table.insert(alsa_monitor.rules, {
     ["api.alsa.use-ucm"] = true,
     ["api.acp.auto-profile"] = false,
     ["api.acp.auto-port"] = true,
-    ["device.profile"] = "HiFi",
+    ["device.profile"] = KAISA_WP_DEVICE_PROFILE,
   },
 })