Decky Loader 是 Steam Deck 的自制插件启动器。它可用于设计菜单风格、更改系统声音、调整屏幕饱和度、更改其他系统设置等等。
有关 Decky Loader 以及文档和开发工具的更多信息,请访问我们的 wiki。
干净地注入和加载多个插件。
在系统更新和重新启动之间保持安装状态。
允许插件和加载器之间的双向通信。
支持从 TypeScript React 运行的 Python 函数。
允许插件进行完全绕过 CORS 的 fetch 调用。
Syncthing 可能使用 Steam Deck 上的端口 8080,Decky Loader 需要该端口才能运行。如果您使用 Syncthing 作为服务,请将其端口更改为其他端口。
8384 是 Syncthing 的推荐端口。
如果您正在使用任何使用端口 1337 或 8080 的软件,请将其端口更改为其他端口或卸载它。
有时 Decky 会在 SteamOS 更新时消失。只需重新运行安装程序并再次安装稳定分支即可轻松解决此问题。如果这不起作用,请尝试安装预发行版。如果这不起作用,请检查现有问题,如果没有问题,则可以提交新问题。
无需设置 admin/sudo 密码即可完成此安装。
如果可能的话准备一个鼠标和键盘。
键盘和鼠标可以通过 USB-C 或蓝牙连接到 Steam Deck。
许多蓝牙键盘和鼠标应用程序可用于 iOS 和 Android。 (KDE connect 已预装在 Steam 平台上)
Steam Link 应用程序可在 Windows、macOS 和 Linux 上使用。它可以很好地作为远程桌面的替代品。
如果您没有其他选择,请使用右侧触控板作为鼠标,然后根据需要按 打开屏幕键盘。
按下按钮并打开电源菜单。
选择“切换到桌面”。
在您选择的浏览器上导航到此 Github 页面。
下载安装程序文件。 (如果使用 Firefox,它将被命名为decky_installer.desktop.download
。在运行之前将其重命名为decky_installer.desktop
)
将文件拖到桌面上并双击运行它。
输入您的管理员密码或允许 Decky 临时将您的管理员密码设置为Decky!
(安装程序完成后该密码将被删除)
选择您要安装的 Decky Loader 版本。
最新版本
适合大多数用户。这是 Decky Loader 的最新稳定版本。
最新预发布
适用于插件开发人员。预发行版不太可能完全稳定,但包含最新的更改。有关插件开发的更多信息,请参阅 wiki 页面。
打开桌面上的返回游戏模式快捷方式。
对于那些可以使用 Konsole 的人来说,还可以进行快速安装。运行curl -L https://github.com/SteamDeckHomebrew/decky-installer/releases/latest/download/install_release.sh | sh
并在出现提示时输入您的密码。
看到你离开我们感到很遗憾!如果您因为遇到问题而考虑卸载,请考虑提出问题或加入我们的 Discord,以便我们可以帮助您和其他用户。
按下按钮并打开电源菜单。
选择“切换到桌面”。
再次运行安装程序文件,然后选择uninstall decky loader
。
对于那些可以使用 Konsole 的人来说,还可以快速卸载。运行curl -L https://github.com/SteamDeckHomebrew/decky-installer/releases/latest/download/uninstall.sh | sh
并在出现提示时输入您的密码。
现在您已经安装了 Decky Loader,您可以开始使用插件了。每个插件都由不同的开发人员维护并具有其自己的用途,但大多数插件都遵循下面概述的一般结构。
按按钮并导航至该图标。这是用于与插件和加载器本身交互的 Decky 菜单。
选择该图标以打开插件浏览器。您可以在这里找到并安装插件。
您还可以从“设置”菜单中的 URL 安装。我们不建议安装来自不受信任来源的插件。
要安装插件,请选择所需插件上的“安装”按钮。您还可以从下拉菜单中选择版本,但不建议这样做。
要更新、卸载和重新加载插件,请导航至 Decky 菜单并选择 图标。
请记住,卸载插件只会删除其插件文件,而不会删除它可能创建的任何其他文件。
目前还没有完整的插件开发文档。然而,一个好的起点是插件模板存储库。如果您有任何疑问,请考虑加入我们的 Discord。
请查阅有关开发的 wiki 页面,以获取有关安装 Decky Loader 开发版本的更多信息。您还可以按照此 YouTube 指南在 Windows 或 Linux 计算机上安装 Steam Deck UI 进行测试。
在开始 PR 之前,使用对 main 的最新提交来克隆存储库。
在存储库的克隆中,运行这些命令。
CD前端 PNPM我 pnpm 运行构建
如果您要修改 UI,则需要在将更改部署到 Steam Deck 之前运行这些命令。
使用 VS Code 任务或deck.sh
脚本将更改部署到 Steam Deck 进行测试。
您将使用 Python 脚本版本测试您的更改。您每次都需要构建、部署和重新加载。
pnpm 更新 Decky-frontend-lib --latest
源代码控制和部署插件留给克隆存储库的每个贡献者,以保持依赖项最新。
插件加载器概念的最初想法基于 marios8543 的 Steam Deck UI Inject 项目的工作。