已知限制与排查——出问题先看这里
不是 Bug 的已知限制
DSP 效果投屏时不生效
不是 Bug，是架构限制——Chromecast / UPnP / Sonos / Kodi 这些远程渲染器自己解码音频，Symfonium 的 DSP 引擎碰不到解码后的音频流。这和"其他播放器投屏时 EQ 也不生效"是一个道理。
实验性 ReplayGain：Chromecast 投屏可以开 Casting replay gain processor，让 Symfonium 临时转码叠加 ReplayGain 后再推。代价是耗电和临时存储，且只支持 ReplayGain 一种效果，PEQ / GEQ / 交叉馈送都不行。
Subsonic 原版不支持歌单写回
Subsonic（原版）协议层没有歌单写回能力——这是协议标准本身的决定，不是 Symfonium 没做。想写回歌单用 Navidrome 或 OpenSubsonic。
WebDAV 投屏需要手机代理
WebDAV 的 HTTP Basic / Digest 认证头，Chromecast / UPnP 渲染器自己发不出来。Symfonium 只能在手机上代理转流，耗电耗流量。想在投屏场景省点手机资源，考虑把 WebDAV 源换成 SMB 或媒体服务器。
远程访问速度取决于媒体服务器
Symfonium 只是一个客户端——在外用 Plex / Jellyfin / Navidrome 的速度，取决于服务器端的公网带宽和手机的蜂窝网络质量。Symfonium 没法凭空加速。
云盘 API 限速
Google Drive / OneDrive / Dropbox 等免费版对 API 调用和流量都有限速，高峰时段或超出 API 配额后会出现拉流慢、甚至暂时被封。付费版配额更高。这是云盘供应商的限制，Symfonium 无能为力。
Wear OS 需要和手机在同一 Wi-Fi 同步
手表和手机的配对走蓝牙，但同步内容（把歌单推到手表上）必须同 Wi-Fi。蓝牙带宽不够同步大文件。
某些国产 ROM 后台限制
小米 MIUI、OPPO ColorOS、vivo OriginOS 等国产 ROM 对后台 App的限制比原生 Android 严——Symfonium 被"清理"后可能被后台策略杀掉，导致：
- 播放中被打断
- 自动缓存规则在后台不触发
- 媒体源同步延迟
建议：把 Symfonium 加入 ROM 的"后台白名单 / 自启动 / 省电优化豁免"列表。
排查步骤（通用）
遇到任何问题，按这个顺序查：
- App 版本是不是最新？ 设置 → About → 看版本号。如果比官网最新版低，先更到最新再试
- 清 App 缓存？ 设置 → Database → Clear cache（不会删你的歌单和设置，只会清曲库索引、播放历史、媒体源同步缓存）
- 重启手机？ 治标但有时确实管用，特别是国产 ROM
- 媒体源重连？ 设置 → Providers → 选中问题源 → Remove → 重新 Add
- 查看 Symfonium 内置日志？ 设置 → Support & reference → Secure file sharing with support → 生成日志链接。日志里有详细的错误栈，很多问题一眼能定位
- 去支持平台搜一下？ 把你的问题关键词（英文）输进去，大概率有人也遇到过
常见场景排查
播放卡顿
| 现象 | 可能原因 | 排查 |
|---|---|---|
| 流式播放时卡顿 + 速率指示器红 | 网络慢 / 服务器扛不住 / 云盘限速 | 先缓存再听、检查服务器 CPU、云盘升级 |
| DSD + 全 DSP 叠加时卡顿 | 手机 CPU 扛不住 | 关掉虚拟器 / 交叉馈送、降低 EQ block size |
| 有线耳机正常、蓝牙耳机卡 | 蓝牙编解码带宽问题 | 换 aptX LDAC / aptX Adaptive 等更高带宽的蓝牙协议 |
媒体源连不上
| 源 | 排查方向 |
|---|---|
| Plex / Jellyfin / Navidrome | 确认服务器端 API 可达、用户名密码对、服务器没挂、防火墙允许 Symfonium IP |
| SMB | 同网段？共享路径对？账号有读权限？ |
| WebDAV | URL 末尾斜杠对？HTTPS 证书受信？ |
| Google Drive / OneDrive | 账号对？OAuth 授权没过期？ |
| Kodi | Kodi Web 服务器开了？端口对？ |
EQ 不生效
- 是不是投屏时看的？ 投屏时 DSP 本来就不生效，本地播放才生效
- 是不是选对了输出设备？ EQ 按输出设备分别保存，换了设备就是另一套参数
- 是不是关掉了 Equalizer 总开关？ 每块 EQ 效果各自有开关
歌词不出
- 按歌词来源优先级依次检查：文件标签里有没有？同目录 .lrc 有没有？媒体服务器有没有？在线服务能搜到吗？
- 冷门曲目大概率搜不到在线歌词，手动配对 .lrc 文件最靠谱
联系支持
如果按上面步骤排查了还是解决不了：
- 生成 Symfonium 诊断日志链接（设置 → Support → Secure file sharing）
- 去官方支持平台（support.symfonium.app）发 Bug 报告板块
- 附上诊断日志链接、你的设备型号、Android 版本、Symfonium 版本、复现步骤
开发者处理报告时会非常依赖那份诊断日志——附上它能大幅加快排查速度。