常见问题¶
这里优先给出排查顺序；具体按钮和设置说明请进入对应平台的章节。
安装失败或不能覆盖升级¶
先检查安装包是手机版还是 TV 版、Android 版本是否满足要求，以及系统支持 32 位还是 64 位应用。下载不完整也可能导致“解析失败”。
如果是旧 Preview 与正式版签名冲突，先备份再迁移，不要直接清空数据。详见安装与更新。
在哪里检查更新¶
- 手机： 设置 › 关于，点击「版本」一行。
- TV： 设置 › 关于 › 检查更新。
两端独立发布，版本号不一致不代表其中一端漏更。日志与发布页见版本说明。
连不上服务器¶
- 检查地址、协议、端口、用户名与密码；局域网地址只有在相应网络内才可访问。
- 用同一设备确认服务端本身可访问，不要只以另一台电脑能打开作为依据。
- 按错误提示区分登录失败、网络超时或证书问题，不要为连接方便而随意关闭证书验证。
首页、搜索或海报缺少内容¶
先确认当前服务器、账号和媒体库是否正确，再检查是否隐藏了服务器或媒体库。跨服搜索仍依赖各个来源可访问，并非本地保存了所有服务器内容。
只有 TMDB 海报或推荐内容失败时，再检查对应服务配置与网络；不必先删除整台服务器。见手机搜索、代理设置。
播放卡顿、黑屏、颜色发绿或发紫¶
先用同一片段切换内核比较；持续缓冲优先检查网络和片源码率。杜比视界修正是否适用取决于设备与片源，不要把所有高级开关同时打开。
字幕不显示、不同步或改样式没效果¶
先在播放器中选中正确字幕；不同步再调「字幕延迟」。没有合适字幕时，新版可在字幕面板选择「加载本地字幕」或「在线搜索字幕」，在线来源可能需要先配置密钥；字幕不会仅因切换内核自动生成。
图形字幕不能像文本一样换字体，ASS 或不同内核也可能使用独立样式。手机操作见字幕指引，TV 见播放器。
弹幕没有匹配到¶
先确认已启用弹幕，再用手动搜索选择正确作品和集数；仍无内容时检查弹幕服务是否可用，以及透明度、屏蔽设置是否过滤了显示。
原盘没有菜单，或直播频繁断流¶
- 原盘： 支持的 DVD / HDMV 菜单可交互，BD-J 菜单可尝试改为直接播放正片；加密光盘不能靠切换模式解密。
- 直播： 等待自动重连，若同一频道持续失败，检查源地址并更新频道表。更新列表并不保证失效频道恢复。
手机发现不了电视，或投屏后播不了¶
先区分两件事：投屏是在接收设备播放内容；发送到电视是传配置，要求电视打开相应配置页面。
确认手机与电视处于可互相访问的局域网，路由器没有客户端隔离。投屏设备还需支持接收协议和片源格式；扫码能打开配置页不等于支持所有投屏内容。见投屏、手机配置电视。
换手机或首次配置电视，怎么迁移¶
从旧设备导出备份，保存到应用之外；新设备恢复时查看预览与结果，不要假定所有本地路径、离线文件和平台专属设置都会一起迁移。
WebDAV 备份失败，或恢复列表为空¶
先在 NAS / 网盘里创建 Entryway 文件夹，并确保账号可通过 WebDAV 列目录、读写。手机和 TV 的备份地址都应填写它的完整地址，以 /Entryway/ 结尾；服务商基础路径要保留，不能只填域名或分享链接。
- 目录不存在 / 404： 检查目录是否已创建、路径与大小写是否一致，不要依赖自动创建父目录。
- 401 / 403： 检查 WebDAV 账号、应用专用密码和目录权限；它们不同于备份文件的解密密码。
- 列表为空： 确认
.json备份已上传到这个目录，两端路径一致；应用不递归查找子目录。 - 恢复只成功一部分： 查看跳过项和「疑似高版本备份包」提示，保留原备份；不要为此删除旧设备的数据。
独立设备使用各自父目录下的 Entryway/，避免同型号设备覆盖备份。操作示例见手机版 WebDAV与TV WebDAV。
还有问题，怎样反馈¶
通过 设置 › 关于 › Telegram 交流群 获取帮助。提供手机 / TV 平台、应用版本、设备型号、复现步骤和具体报错；播放问题可按播放器章节导出诊断包。
截图和日志先脱敏，不公开账号、密码、令牌或整份个人备份。