EmuDeck项目中的Citron模拟器全屏启动问题解决方案

问题背景

在SteamOS系统上使用EmuDeck项目时，用户发现通过Steam Rom Manager(SRM)添加的Citron模拟器游戏无法以全屏模式启动。这是一个影响用户体验的常见问题，特别是在Steam Deck这样的手持设备上，全屏模式对于游戏体验至关重要。

技术分析

Citron模拟器是EmuDeck项目支持的一个模拟器组件。通过分析问题现象和社区反馈，可以确定：

1. 根本原因在于启动脚本中缺少必要的全屏参数
2. 默认情况下，Citron模拟器会以窗口模式启动
3. 该问题仅影响通过SRM添加的游戏，直接启动模拟器不受影响

解决方案

要解决这个问题，需要修改Citron模拟器的启动脚本。具体步骤如下：

1. 定位到EmuDeck安装目录下的citron.sh脚本文件
2. 找到游戏启动命令的执行行
3. 修改参数添加全屏标志

修改前后的代码对比：

# 修改前
eval "${exe} ${param}"

# 修改后
eval "${exe} -f -g ${param}"

其中：

• -f 参数强制全屏模式
• -g 参数保持原始游戏分辨率

实现原理

这个修改利用了Citron模拟器内置的命令行参数功能：

• 全屏参数(-f)会覆盖模拟器的默认窗口模式设置
• 分辨率参数(-g)确保游戏保持原始比例，避免拉伸变形
• 参数组合使用可以提供最佳的全屏游戏体验

验证与测试

多位社区用户已确认该解决方案有效：

1. 修改后游戏能够正常以全屏模式启动
2. 游戏画面比例保持正确
3. 不影响其他功能的正常运行

注意事项

1. 修改脚本前建议备份原文件
2. 不同版本的EmuDeck可能脚本路径略有不同
3. 如果后续更新覆盖了脚本，可能需要重新应用修改

总结

通过简单的脚本修改，可以完美解决Citron模拟器在EmuDeck中的全屏启动问题。这个案例也展示了开源社区协作解决问题的典型流程：用户反馈→技术分析→方案验证→最终修复。对于遇到类似问题的用户，可以参考此方案进行解决。