From 7a7ecdac55af37ee458d852050853004f62acdaf Mon Sep 17 00:00:00 2001 From: Chen Ye <36871584+evachxji@users.noreply.github.com> Date: Sat, 6 Jun 2026 23:00:57 +0800 Subject: [PATCH] docs: Add Chinese (Simplified) README translation (#912) * Add Chinese README translation and link badge - Add README_ZH.md with full Chinese translation - Add README badge linking to Chinese version * docs(zh-Hans): rename to README_zh-Hans.md, replace shields.io badge with text link Addressing review feedback from AkazaRenn: - Rename README_ZH.md to README_zh-Hans.md for standard IETF language tag - Remove shields.io external badge, use plain text language switcher instead - Add bidirectional language links in both READMEs Co-Authored-By: Claude Opus 4.8 --------- Co-authored-by: juncheng.ye Co-authored-by: Claude Opus 4.8 --- README.md | 3 ++ README_zh-Hans.md | 129 ++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 132 insertions(+) create mode 100644 README_zh-Hans.md diff --git a/README.md b/README.md index 87b8bd44..82a9e309 100644 --- a/README.md +++ b/README.md @@ -15,6 +15,9 @@

+ 🌐 English · 简体中文 +
+

diff --git a/README_zh-Hans.md b/README_zh-Hans.md new file mode 100644 index 00000000..2070eb23 --- /dev/null +++ b/README_zh-Hans.md @@ -0,0 +1,129 @@ +

+ Deckbrew logo +
+ Decky Loader +
+ Download decky +

+ +

+ + + + Translation status + + +
+
+ 🌐 English · 简体中文 +
+
+ +

+ +## 🩵 赞助者 + +[成为赞助者](https://opencollective.com/steamdeckhomebrew)来支持我们的工作！向我们的集体项目捐款将帮助 Decky Loader 开发者支付网络服务器费用、购买新的开发硬件等。 + +Steam Deck Homebrew sponsors on Open Collective + +Steam Deck Homebrew backers on Open Collective + +## 📖 关于 + +Decky Loader 是一款用于 Steam Deck 的自制插件启动器。它可以用来[美化菜单界面](https://github.com/suchmememanyskill/SDH-CssLoader)、[更改系统音效](https://github.com/EMERALD0874/SDH-AudioLoader)、[调整屏幕饱和度](https://github.com/libvibrant/vibrantDeck)、[修改更多系统设置](https://github.com/NGnius/PowerTools)，以及[更多功能](https://plugins.deckbrew.xyz/)。 + +有关 Decky Loader 的更多信息、文档和开发工具，请访问[我们的维基](https://wiki.deckbrew.xyz)。 + +### 🎨 功能特性 + +🧹 干净地注入和加载多个插件。 +🔒 在系统更新和重启后仍然保持安装状态。 +🔗 允许插件与启动器之间进行双向通信。 +🐍 支持从 TypeScript React 中运行 Python 函数。 +🌐 允许插件发起完全绕过 CORS 的 fetch 请求。 + +### 🤔 常见问题 + +- Syncthing 可能会占用 Steam Deck 上的 8080 端口，而 Decky Loader 需要该端口才能运行。如果您将 Syncthing 作为服务使用，请将其端口更改为其他端口。 + - 建议将 Syncthing 的端口改为 8384。 +- 如果您使用的任何软件占用了 1337 或 8080 端口，请将其端口更改为其他端口或卸载该软件。 +- 有时 Decky 会在 SteamOS 更新后消失。只需重新运行安装程序并再次安装稳定版即可轻松解决。如果这不起作用，请尝试安装预发布版。如果还是不行，请[查看现有问题](https://github.com/SteamDeckHomebrew/decky-loader/issues)，如果没有相关问题，您可以[提交一个新问题](https://github.com/SteamDeckHomebrew/decky-loader/issues/new?assignees=&labels=bug&template=bug_report.yml&title=%5BBUG%5D+%3Ctitle%3E)。 + +## 💾 安装 + +- 安装过程无需设置管理员/sudo 密码。 + +1. 如果可能，请准备鼠标和键盘。 + - 键盘和鼠标可以通过 USB-C 或蓝牙连接到 Steam Deck。 + - iOS 和 Android 上有许多蓝牙键盘和鼠标应用可用。（Steam Deck 上预安装了 KDE Connect） + - Steam Link 应用可在 [Windows](https://media.steampowered.com/steamlink/windows/latest/SteamLink.zip)、[macOS](https://apps.apple.com/us/app/steam-link/id1246969117) 和 [Linux](https://flathub.org/apps/details/com.valvesoftware.SteamLink) 上使用。它可以很好地替代远程桌面。 + - 如果您没有其他选择，可以使用右侧触控板作为鼠标，并按 + 打开屏幕键盘。 +1. 按下 按钮并打开电源菜单。 +1. 选择"切换到桌面模式"。 +1. 在您选择的浏览器中访问此 GitHub 页面。 +1. 下载[安装程序文件](https://github.com/SteamDeckHomebrew/decky-installer/releases/latest/download/decky_installer.desktop)。（如果使用 Firefox，文件将命名为 `decky_installer.desktop.download`，请在运行前将其重命名为 `decky_installer.desktop`） +1. 将文件拖到桌面上，然后双击运行。 +1. 输入您的管理员密码或允许 Decky 临时将您的管理员密码设置为 `Decky!`（安装程序完成后将删除此密码）。 +1. 选择您要安装的 Decky Loader 版本。 + - **最新正式版** + 面向大多数用户。这是 Decky Loader 的最新稳定版本。 + - **最新预发布版** + 面向插件开发者。预发布版可能尚未完全稳定，但包含最新更改。有关插件开发的更多信息，请参阅[维基页面](https://wiki.deckbrew.xyz/en/loader-dev/development)。 +1. 打开桌面上的"返回游戏模式"快捷方式。 + +- 对于可以使用 Konsole 的用户，还有一种快速安装方式。运行 `curl -L https://github.com/SteamDeckHomebrew/decky-installer/releases/latest/download/install_release.sh | sh` 并在提示时输入密码。 + +### 👋 卸载 + +很抱歉看到您离开！如果您因为遇到问题而考虑卸载，请考虑[提交问题](https://github.com/SteamDeckHomebrew/decky-loader/issues)或[加入我们的 Discord](https://deckbrew.xyz/discord)，以便我们帮助您和其他用户。 + +1. 按下 按钮并打开电源菜单。 +1. 选择"切换到桌面模式"。 +1. 再次运行安装程序文件，然后选择 `uninstall decky loader`。 + +- 对于可以使用 Konsole 的用户，还有一种快速卸载方式。运行 `curl -L https://github.com/SteamDeckHomebrew/decky-installer/releases/latest/download/uninstall.sh | sh` 并在提示时输入密码。 + +## 🚀 入门指南 + +现在您已经安装了 Decky Loader，可以开始使用插件了。每个插件由不同的开发者维护，具有各自的用途，但大多数遵循以下通用结构。 + +### 📦 插件 + +1. 按下 按钮并导航到 图标。这是 Decky 菜单，用于与插件和启动器本身交互。 +1. 选择 图标打开插件浏览器。在这里您可以查找和安装插件。 + - 您也可以在设置菜单中通过 URL 安装。我们不建议安装来自不可信来源的插件。 +1. 要安装插件，请在您想要的插件上选择"安装"按钮。您也可以从下拉菜单中选择一个版本，但不建议这样做。 +1. 要更新、卸载和重新加载插件，请导航到 Decky 菜单并选择 图标。 + - 请注意，卸载插件只会移除其插件文件，而不会删除它可能创建的任何其他文件。 + +### 🛠️ 插件开发 + +目前还没有完整的插件开发文档。不过，一个好的起点是[插件模板仓库](https://github.com/SteamDeckHomebrew/decky-plugin-template)。如果您有任何问题，请考虑[加入我们的 Discord](https://deckbrew.xyz/discord)。 + +### 🤝 贡献 + +有关安装 Decky Loader 开发版本的更多信息，请参阅[有关开发的维基页面](https://wiki.deckbrew.xyz/en/loader-dev/development)。您还可以通过观看[此 YouTube 教程](https://youtu.be/1IAbZte8e7E?t=112)在 Windows 或 Linux 计算机上安装 Steam Deck UI 进行测试。 + +1. 在开始您的 PR 之前，使用最新的 main 分支提交克隆仓库。 +1. 在您的仓库克隆中，运行以下命令。 + ```bash + cd frontend + pnpm i # 注意：您可能需要使用 pnpm approve-builds 批准 esbuild 的构建脚本 + pnpm run build + ``` +1. 如果您正在修改 UI，则需要在部署更改到 Steam Deck 之前运行这些命令。 +1. 使用 VS Code 任务或 `deck.sh` 脚本将您的更改部署到 Steam Deck 以进行测试。 +1. 您将使用 Python 脚本版本测试您的更改。每次都需要构建、部署和重新加载。 + +⚠️ 如果您因库过时而收到构建错误，请在仓库内运行此命令。 + +```bash +pnpm update @decky/ui --latest +``` + +源代码管理和插件部署留给克隆仓库的各自贡献者处理，以保持依赖项为最新版本。 + +## 📜 鸣谢 + +插件加载器概念的最初想法基于 [marios8543 的 Steam Deck UI Inject 项目](https://github.com/marios8543/steamdeck-ui-inject)的工作。