decky-loader/README_zh-Hans.md

Decky Loader

🌐 English · 简体中文

🩵 赞助者

成为赞助者来支持我们的工作！向我们的集体项目捐款将帮助 Decky Loader 开发者支付网络服务器费用、购买新的开发硬件等。

📖 关于

Decky Loader 是一款用于 Steam Deck 的自制插件启动器。它可以用来美化菜单界面、更改系统音效、调整屏幕饱和度、修改更多系统设置，以及更多功能。

有关 Decky Loader 的更多信息、文档和开发工具，请访问我们的维基。

🎨 功能特性

🧹 干净地注入和加载多个插件。
🔒 在系统更新和重启后仍然保持安装状态。
🔗 允许插件与启动器之间进行双向通信。
🐍 支持从 TypeScript React 中运行 Python 函数。
🌐 允许插件发起完全绕过 CORS 的 fetch 请求。

🤔 常见问题

• Syncthing 可能会占用 Steam Deck 上的 8080 端口，而 Decky Loader 需要该端口才能运行。如果您将 Syncthing 作为服务使用，请将其端口更改为其他端口。
  • 建议将 Syncthing 的端口改为 8384。
• 如果您使用的任何软件占用了 1337 或 8080 端口，请将其端口更改为其他端口或卸载该软件。
• 有时 Decky 会在 SteamOS 更新后消失。只需重新运行安装程序并再次安装稳定版即可轻松解决。如果这不起作用，请尝试安装预发布版。如果还是不行，请查看现有问题，如果没有相关问题，您可以提交一个新问题。

💾 安装

• 安装过程无需设置管理员/sudo 密码。

1. 如果可能，请准备鼠标和键盘。
   • 键盘和鼠标可以通过 USB-C 或蓝牙连接到 Steam Deck。
   • iOS 和 Android 上有许多蓝牙键盘和鼠标应用可用。（Steam Deck 上预安装了 KDE Connect）
   • Steam Link 应用可在 Windows、macOS 和 Linux 上使用。它可以很好地替代远程桌面。
   • 如果您没有其他选择，可以使用右侧触控板作为鼠标，并按 + 打开屏幕键盘。
2. 按下 按钮并打开电源菜单。
3. 选择"切换到桌面模式"。
4. 在您选择的浏览器中访问此 GitHub 页面。
5. 下载安装程序文件。（如果使用 Firefox，文件将命名为 decky_installer.desktop.download，请在运行前将其重命名为 decky_installer.desktop）
6. 将文件拖到桌面上，然后双击运行。
7. 输入您的管理员密码或允许 Decky 临时将您的管理员密码设置为 Decky!（安装程序完成后将删除此密码）。
8. 选择您要安装的 Decky Loader 版本。
   • 最新正式版
     面向大多数用户。这是 Decky Loader 的最新稳定版本。
   • 最新预发布版
     面向插件开发者。预发布版可能尚未完全稳定，但包含最新更改。有关插件开发的更多信息，请参阅维基页面。
9. 打开桌面上的"返回游戏模式"快捷方式。

• 对于可以使用 Konsole 的用户，还有一种快速安装方式。运行 curl -L https://github.com/SteamDeckHomebrew/decky-installer/releases/latest/download/install_release.sh | sh 并在提示时输入密码。

👋 卸载

很抱歉看到您离开！如果您因为遇到问题而考虑卸载，请考虑提交问题或加入我们的 Discord，以便我们帮助您和其他用户。

1. 按下 按钮并打开电源菜单。
2. 选择"切换到桌面模式"。
3. 再次运行安装程序文件，然后选择 uninstall decky loader。

• 对于可以使用 Konsole 的用户，还有一种快速卸载方式。运行 curl -L https://github.com/SteamDeckHomebrew/decky-installer/releases/latest/download/uninstall.sh | sh 并在提示时输入密码。

🚀 入门指南

现在您已经安装了 Decky Loader，可以开始使用插件了。每个插件由不同的开发者维护，具有各自的用途，但大多数遵循以下通用结构。

📦 插件

1. 按下 按钮并导航到 图标。这是 Decky 菜单，用于与插件和启动器本身交互。
2. 选择 图标打开插件浏览器。在这里您可以查找和安装插件。
   • 您也可以在设置菜单中通过 URL 安装。我们不建议安装来自不可信来源的插件。
3. 要安装插件，请在您想要的插件上选择"安装"按钮。您也可以从下拉菜单中选择一个版本，但不建议这样做。
4. 要更新、卸载和重新加载插件，请导航到 Decky 菜单并选择 图标。
   • 请注意，卸载插件只会移除其插件文件，而不会删除它可能创建的任何其他文件。

🛠️ 插件开发

目前还没有完整的插件开发文档。不过，一个好的起点是插件模板仓库。如果您有任何问题，请考虑加入我们的 Discord。

🤝 贡献

有关安装 Decky Loader 开发版本的更多信息，请参阅有关开发的维基页面。您还可以通过观看此 YouTube 教程在 Windows 或 Linux 计算机上安装 Steam Deck UI 进行测试。

1. 在开始您的 PR 之前，使用最新的 main 分支提交克隆仓库。
2. 在您的仓库克隆中，运行以下命令。

   cd frontend
   pnpm i # 注意：您可能需要使用 pnpm approve-builds 批准 esbuild 的构建脚本
   pnpm run build
   

3. 如果您正在修改 UI，则需要在部署更改到 Steam Deck 之前运行这些命令。
4. 使用 VS Code 任务或 deck.sh 脚本将您的更改部署到 Steam Deck 以进行测试。
5. 您将使用 Python 脚本版本测试您的更改。每次都需要构建、部署和重新加载。

⚠️ 如果您因库过时而收到构建错误，请在仓库内运行此命令。

pnpm update @decky/ui --latest

源代码管理和插件部署留给克隆仓库的各自贡献者处理，以保持依赖项为最新版本。

📜 鸣谢

插件加载器概念的最初想法基于 marios8543 的 Steam Deck UI Inject 项目的工作。