调试与日志
开启开发者模式
设置 → 关于与鸣谢 → 连续点击版本号 8 次（第 5–7 次会提示剩余次数）。开启后解锁下载配置、自定义代码注入、页面缩放滑条等隐藏项。DEV / Nightly 构建默认即为开发者模式。
抓取日志
应用与原生层
内嵌 Node 运行时的输出已重定向到 logcat，原生播放层也会输出诊断日志：
bash
# 全量
adb logcat > splayer.log
# 只看崩溃
adb logcat -b crash > crash.log
# 过滤本应用进程
adb logcat --pid=$(adb shell pidof top.imsyy.splayer.android)关注标签：nodejs（内置 API）、播放管理器诊断输出、Capacitor 桥接日志。
内置 API 自检
内置 API 每 30s 请求一次 GET /api 做健康检查，连续两次失败会弹「内置 API 服务异常，正在自动恢复...」并重启运行时。若日志中反复出现重启记录，请连同设备型号与 Android 版本一起反馈。
WebView 调试
Release 包默认关闭 WebView 调试（webContentsDebuggingEnabled: false）。自编译调试包可在 capacitor.config.ts 中开启，然后 Chrome 访问 chrome://inspect 调试前端页面。
缓存问题排查
设置 → 本地与缓存 → 缓存配置：
- 缓存总占用 异常偏大：点击「立即整理」手动执行 LRU 清理（清理到上限的 80%）；
- 封面 / 歌词显示陈旧：按类型清空对应缓存后重进页面；
- 设备存储紧张时缓存上限会自动下调到剩余空间的 60%，属预期行为。
设置异常 / 想重置
- 重置所有设置：恢复默认配置，保留登录态与缓存；
- 清除全部数据：清空 localStorage / IndexedDB 并退出登录，等价于全新安装；
- 操作前可用 导出设置 备份为 JSON。
复现与反馈 Checklist
提交 Issue 前请确认：
- [ ] 已搜索是否存在相同 Issue；
- [ ] 问题出现在 Android 版而非桌面版（桌面版问题请去上游）；
- [ ] 已在最新 Release 上复现；
- [ ] 可稳定复现并写清步骤；
- [ ] 附上：应用版本、设备型号、Android 版本、ABI、复现步骤；
- [ ] 崩溃类问题附
adb logcat -b crash输出。
QQ 群 602750631 适合讨论使用问题；Bug 修复仍以 Issue 为准，便于跟踪。