louCollaplex 音效
耳机方向的空间音效链路（PipeWire）。
当前链路（2026-09-19 固化）：
全局音频(应用输出) → collaplex_vsink(虚拟声卡) → 响度归一化(pipe DSP) → 数字输出(S/PDIF)
安装
把项目里的定义部署到 PipeWire 用户级：
bash 脚本/安装.sh
脚本会：探测数字输出设备 → 渲染并安装链路配置到 ~/.config/pipewire/pipewire.conf.d/ →
装 pipe 插件入口到 ~/.local/bin/ → 重启 PipeWire → 自检（节点 / DSP 进程 / 默认输出）。
设备名变化或项目挪了位置，重跑这个脚本即可 —— 定义在项目里，部署可复现。
开关与调参
- 实时状态（推子 / 响度 / 输出电平）：
python3 dsp/状态.py - 目标电平（DSP 每秒重读，改完即时生效，不用重建链路）：
echo '{"on": true, "target_db": -16}' > ~/.local/state/cinema-spatial/loudness.json
文件
| 路径 | 作用 |
|---|---|
dsp/loudness_norm.py |
响度归一化 DSP（pipe 插件载荷；左右各一进程，flock 共享能量算同一增益，声像不漂） |
dsp/状态.py |
读共享内存看实时推子 / 电平 |
bin/collaplex-loudness-norm |
pipe 插件入口模板（纯 ASCII 路径；参数写在这里，配置里只给路径） |
pipewire/10-collaplex-vsink.conf |
链路定义模板（__TARGET__ 数字输出、__WRAPPER__ 入口） |
脚本/安装.sh |
渲染 + 部署 + 重启 + 自检 |
实测（2026-09-19 固化后复测）
| 输入素材 | DSP 推子 | 数字输出端实测 |
|---|---|---|
| −12 dBFS | −8.37 dB | −19.31 dBFS |
| −32 dBFS | −3.58 dB | −18.97 dBFS |
输入差 20.00 dB → 输出端实测差 0.34 dB；推子方向相反（响的压、轻的抬）， 目标 −16 dBFS，限速 6 dB/s。
注意
- pipe 插件的
command只吃「程序 + 一个参数」，且不能用中文路径（否则节点照建、 音频绕过、零日志）。所以配置里给的是bin/里的 ASCII wrapper，由它转发到中文项目路径。 node.target写的是设备名，设备重连/换口后可能变；重跑脚本/安装.sh修正。- 播放中的实测要抓 sink 的 monitor：
pw-record --target <sink 节点 id> -P '{ stream.capture.sink = true }'。