# 文档索引

与根 [README.md](../README.md) 相同：**仅**下列为当前维护文档。

| 文档 | 说明 |
| ---- | ---- |
| [linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md](linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md) | **主路线（交付）**：UCM2、HiFi、`60-kaisa-ucm.lua`、Jack-driven 端口、IEC958、安装 / 验收 / 排障 |
| [linux-hdmi/DEBUG_Reboot_No_Sound_and_Fix.md](linux-hdmi/DEBUG_Reboot_No_Sound_and_Fix.md) | 排障记录：重启后无声的根因链路（WirePlumber 状态恢复 / `set_hw_params`）与 `--fix` 一键恢复 |
| [linux-hdmi/LOCAL_Root_Cause_and_Fix.md](linux-hdmi/LOCAL_Root_Cause_and_Fix.md) | **本机判因（替代 Live）**：`kaisa-audio-doctor.sh` 流程、证据表、安装顺序、与 DEBUG 文档衔接 |
| [linux-hdmi/ROOTCAUSE_Reboot_Silent_Analysis.md](linux-hdmi/ROOTCAUSE_Reboot_Silent_Analysis.md) | **根因深读**：`default-routes` 极低 HDMI 音量（机制 A 实测）与 `set_hw_params`（机制 B）分工 |
| [linux-hdmi/FIX_HDMI_No_Sound_ProAudio_Session_20260410.md](linux-hdmi/FIX_HDMI_No_Sound_ProAudio_Session_20260410.md) | **应急兜底（pro-audio）**：卡 `off`/ `auto_null` 恢复、`pro-output-N` 与 IEC958 对照、检查点速查表（非 UCM/HiFi 主交付） |
| [README.md](README.md) | 本目录说明 |

**脚本（仓库根 `scripts/`）**：禁用 pro-audio 片段 — [`disable-kaisa-pro-audio-wireplumber.sh`](../scripts/disable-kaisa-pro-audio-wireplumber.sh)；安装 UCM overlay — [`install-kaisa-ucm-overlay.sh`](../scripts/install-kaisa-ucm-overlay.sh)。