Initial commit

audio_topology/COLLECT.md

@@ -0,0 +1,34 @@
+# 音频拓扑收集
+
+脚本用于在 **Linux / Windows / ChromeOS** 下导出 `aplay`、`pactl`、`dmesg` 等，输出默认落在 **`audio_topology/collected/`**（可按日期与主机名区分文件）。
+
+## 对外分享与脱敏
+
+采集输出可能含 **hostname、账号** 等；外发或贴 issue 前请自行裁剪。
+
+## 目录结构
+
+- `collect_linux_audio_topology.sh` — Linux
+- `collect_windows_audio_topology.ps1` — Windows
+- `collect_chromeos_audio_topology.sh` — ChromeOS（crosh → shell）
+- `collected/` — 原始输出（`*.txt` 等）
+
+## Linux
+
+```bash
+sudo ./audio_topology/collect_linux_audio_topology.sh
+# 或指定输出文件
+sudo ./audio_topology/collect_linux_audio_topology.sh /path/to/output.txt
+```
+
+## Windows
+
+在 `audio_topology` 下以管理员 PowerShell 运行 `collect_windows_audio_topology.ps1`（可用 `-OutputPath`）。
+
+## ChromeOS
+
+见脚本内注释：crosh → `shell`，将脚本拷至设备执行，默认输出在 `/tmp/`，再拷回本仓库 `collected/`。
+
+## 与当前维护文档的关系
+
+排查 HDMI 用户态路由以 **[docs/linux-hdmi/OPERATION_PipeWire_Kaisa_HDMI.md](../docs/linux-hdmi/OPERATION_PipeWire_Kaisa_HDMI.md)** 为准；本目录采集为**辅助证据**，不替代该操作文档。