DroidDeck 故障排查
黑屏、闪退与会话结束

启动后提示“会话结束”

先区分所有会话都失败，还是只有一个游戏失败。前者优先检查系统与运行环境，后者再检查单个游戏。

1. 核对 GPU 支持范围，留意 Mali、Adreno 710 和实验性型号。
2. 确认 Linux 运行时和首次启动组件已下载完整。
3. 按 Android 版本处理子进程限制。
4. 记录错误后导出 Share logs，避免先反复重装。

Steam 黑屏，或打开 FSR 后没有画面

官方有特定设备在 FSR / SGSR 下黑屏、切到 Linear 后恢复的记录。可作对照排查，但不是所有黑屏的统一原因。

1. 若刚开启缩放或改过驱动，先恢复上一次可用设置。
2. 尝试 Linear 或关闭缩放，核对是否仅该选项影响画面。
3. 记录驱动、分辨率和版本，检查更新说明。
4. 实验性 Adreno 850 需核对专门的驱动兼容文档。

Steam 或组件下载失败

0.6.0 起增加了 Steam 下载失败的网络 / VPN 提示与 Retry。退出会话不一定是设备性能问题。

1. 如果卡在 Linux 运行时，先检查解压所需的可用空间并记录失败提示。
2. 如果运行时已就绪、Steam 首启时才下载失败，检查 Steam 服务连通性与 VPN，再使用应用给出的 Retry。
3. 如果 Steam 已能登录，只有某款游戏下不动，再查该商店的下载状态与游戏存储位置。
4. 保留错误文本和日志，定位下载阶段。

外接手柄没反应，或无法成为玩家 1

部分游戏只读取第一个控制器，需区分系统识别、控制器顺序与游戏布局。

1. 确认 Android 已识别控制器，检查 Steam Input。
2. 参考 Steam settings → Controller → None 关闭内置控制器后验证。
3. 双屏设备输入无响应，可对照 0.6.9 双屏修复。

过场卡住、Steam 反复重启或组件丢失

0.6.9 包含这些问题的部分修复。核查版本与兼容工具，不要仅凭相同症状认定相同原因。

1. 对照 0.6.9 发布说明。
2. 核对游戏使用的 Proton 与 Windows 组件。
3. 更新前保留存档；仍发生时附上复现步骤和日志。

Steam 能打开，只有一款游戏打不开

先用另一款已拥有的轻量游戏做对照。若它能启动，优先记录问题游戏的名称、启动提示、驱动与 Proton 配置；一次只调整一项，保留可恢复的原设置。

带反作弊、额外启动器或特殊图形依赖的游戏应分别判断。了解游戏兼容边界，需要反馈时按模板记录复现步骤。