CryoUtilities

为Steam Deck提供改善性能和管理存储的脚本和工具。（可能适用于其他Linux发行版。）

更新

关于Steam Deck OLED的说明

最新更新解决了新OLED Deck上的缩放问题，我认为应该在这里提供一个更新：

CU2仍然完全兼容新的OLED型号。
性能提升应该与LCD型号相似（或可能略好）（详细测试待进行）

一般Linux兼容性

从最新更新开始，这应该与大多数Linux系统兼容，但有以下限制：

这不会在交换分区上操作，只能在文件上操作。
游戏数据和VRAM标签可能无法工作
Pop_OS!有一个自定义的swappiness，它会在重启后覆盖这里设置的任何值。

请记住，对非Steam Deck设备的支持仅基于"尽力而为"的原则，并将具有较低的优先级。不幸的是，为所有发行版保证功能所需的努力和支持量会要求我全职投入这项工作，而事实并非如此。

如果你想在不依赖此工具的情况下使用这里的调整，请参阅下面的"它是如何工作的"部分。

VRAM标签

有一个新的VRAM标签，它会告诉你当前的"UMA帧缓冲区大小"设置，以及如果你还没有配置它，如何进行配置！

交换改进

交换文件路径现在完全动态化，调整大小功能可以在早期失败的情况下恢复！如果之前的交换调整失败，你不再需要手动干预，只需再次运行调整大小，它就会发挥魔力。

一键清理游戏数据

在"清理游戏数据"窗口中现在有一个简单的"删除所有未安装"按钮。只需点击它，所有未安装游戏的数据就会被删除！

请记住，非云存档的游戏存档仍应在使用此功能前手动备份。

解释和教程

如果你感兴趣，请查看这里的公告视频，我在其中介绍了所有新功能及其工作原理。

功能

一键设置推荐设置
一键恢复出厂设置
交换调优器
- 交换文件调整器 + 恢复
- Swappiness调整器
内存参数调优
- 大页面切换
- 压缩主动性调整器
- 大页面碎片整理切换
- 页面锁定不公平性调整器
- 共享内存（shmem）切换
存储管理器
- 将shadercache和compatdata同步到游戏安装的相同位置
- 删除你选择的游戏的shadercache和compatdata
- 一键删除所有未安装游戏的shadercache和compatdata
完整CLI模式

查看下面的常见问题和答案，或访问我的YouTube频道了解如何使用此工具以及可以期待的性能。

安装

简单方法

在你的Steam Deck上下载此链接到桌面（右键点击并保存文件），删除文件名末尾的.download，然后双击它。

这将安装程序，创建桌面图标和菜单条目。

手动安装

参见manual-install.md。

离线/防火墙安装

如果你在中国等有防火墙的国家，请查看我网站上的这篇文章获取安装说明和非GitHub下载链接。

使用方法

注意： 这需要在Steam Deck上设置密码。可以使用passwd命令完成。

图形界面

安装后，只需运行桌面上或应用程序菜单中"工具"下的"CryoUtilities"图标。

命令行界面

最新版本有一个完整的CLI处理程序，可用于执行所有调整，但不执行游戏数据操作。

sudo ~/.cryo_utilities/cryo_utilities <命令> [参数]

如果你想查看可用命令和接受的值，可以使用：

sudo ~/.cryo_utilities/cryo_utilities help

注意： 你_需要_使用sudo才能使调整生效，否则无法写入磁盘上必要的位置。

升级

双击桌面上的"更新CryoUtilities"图标，更新完成后你会看到一个对话框。

卸载

双击桌面上的"卸载CryoUtilities"图标，系统会询问你是否确定，然后询问你是否要恢复已做的调整。

恢复默认设置

要恢复Steam Deck默认设置，请执行以下操作之一：

启动CryoUtilities并点击主页上的"出厂设置"。
卸载CryoUtilities，系统会询问你是否要恢复出厂设置。选择是。

选择这些选项后，Deck将与未修改版本完全相同。

已知问题

如果在调整交换文件大小时驱动器变满，你可能会触发一个已知的SteamOS错误，导致引导循环。
- CryoUtilities的编程方式不允许这种情况发生，但在最坏的情况下，如果在CryoUtilities调整交换文件大小的同时有其他操作/下载在后台进行，仍有可能发生。
- 如果发生这种情况，你需要进入live环境并删除一些文件，或使用非破坏性方法重新安装SteamOS。
在使用CLI模式时，交换文件调整可能需要足够长的时间，以至于sudo凭证会超时。
- 这在GUI模式下不会发生，因为我能够实现身份验证，并且很快就会从仅CLI模式中修复。

常见问题

参见FAQ页面。

它做了什么？

参见调整解释页面。

故障排除

双击桌面图标后CryoUtilities没有出现

确保你使用的是SteamOS 3.4或更高版本
验证/home/deck/.cryo_utilities/cryo_utilities和/home/deck/.cryo_utilities/launcher.sh是否存在
- /home/deck/.cryo_utilities是一个隐藏目录，所以确保你可以查看隐藏文件

如果上述方法不起作用，请在这里提出问题或在Discord上联系我们！

使用CryoUtilities的推荐设置后游戏不稳定

尝试重启Deck并再次尝试，我没有听说过重启后仍不稳定的情况，但如果你发现了，请告诉我！

右键点击链接保存不会打开对话框

重启Deck或重启桌面模式，之后链接应该可以工作。

下载后.desktop文件只是用KWrite打开。

确保运行时CryoUtilities.desktop文件在桌面上。如果仍然不起作用，请尝试以下操作之一：

运行chmod +x ~/Downloads/InstallCryoUtilities.desktop然后再试一次。
将CryoUtilities.desktop添加为非Steam游戏并从Steam运行。

交换调整超时

进入游戏模式，导航到设置 > 系统，然后在最底部按"运行存储设备维护任务"。完成后，你应该可以轻松调整交换文件大小。

尝试执行任何操作都会导致程序崩溃

确保你使用安装程序进行了安装。如果不行，请运行：

chown -R deck:deck ~/.cryo_utilities
chmod -R 777 ~/.cryo_utilities

这些权限比必要的更开放，所以只作为最后的手段使用。

steam-deck-utilities