summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChen Ye <36871584+evachxji@users.noreply.github.com>2026-06-06 23:00:57 +0800
committerGitHub <noreply@github.com>2026-06-06 11:00:57 -0400
commit7a7ecdac55af37ee458d852050853004f62acdaf (patch)
tree1bcc4c3037fef13319884b707394a20a17fa19b3
parent232fadd796087bbcbc4dd080cf12b42bf53b71ce (diff)
downloaddecky-loader-7a7ecdac55af37ee458d852050853004f62acdaf.tar.gz
decky-loader-7a7ecdac55af37ee458d852050853004f62acdaf.zip
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 <noreply@anthropic.com> --------- Co-authored-by: juncheng.ye <yechen_0@foxmail.com> Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
-rw-r--r--README.md3
-rw-r--r--README_zh-Hans.md129
2 files changed, 132 insertions, 0 deletions
diff --git a/README.md b/README.md
index 87b8bd44..82a9e309 100644
--- a/README.md
+++ b/README.md
@@ -15,6 +15,9 @@
<a href="https://deckbrew.xyz/discord"><img src="https://img.shields.io/discord/960281551428522045?color=%235865F2&label=discord" /></a>
<br>
<br>
+ 🌐 <a href="./README.md">English</a> · <a href="./README_zh-Hans.md">简体中文</a>
+ <br>
+ <br>
<!-- <img src="https://media.discordapp.net/attachments/966017112244125756/1012466063893610506/main.jpg" alt="Decky screenshot" width="80%">-->
</p>
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 @@
+<h1 align="center">
+ <a name="logo" href="https://deckbrew.xyz/"><img src="https://deckbrew.xyz/static/icon-45ca1f5aea376a9ad37e92db906f283e.png" alt="Deckbrew logo" width="200"></a>
+ <br>
+ Decky Loader
+ <br>
+ <a name="download button" href="https://github.com/SteamDeckHomebrew/decky-installer/releases/latest/download/decky_installer.desktop"><img src="./docs/images/download_button.svg" alt="Download decky" width="150px" style="padding-top: 15px;"></a>
+</h1>
+
+<p align="center">
+ <a href="https://github.com/SteamDeckHomebrew/decky-loader/releases"><img src="https://img.shields.io/github/downloads/SteamDeckHomebrew/decky-loader/total" /></a>
+ <a href="https://github.com/SteamDeckHomebrew/decky-loader/stargazers"><img src="https://img.shields.io/github/stars/SteamDeckHomebrew/decky-loader" /></a>
+ <a href="https://github.com/SteamDeckHomebrew/decky-loader/commits/main"><img src="https://img.shields.io/github/last-commit/SteamDeckHomebrew/decky-loader.svg" /></a>
+ <a href="https://weblate.werwolv.net/engage/decky/"><img src="https://weblate.werwolv.net/widgets/decky/-/decky/svg-badge.svg" alt="Translation status" /></a>
+ <a href="https://github.com/SteamDeckHomebrew/decky-loader/blob/main/LICENSE"><img src="https://img.shields.io/github/license/SteamDeckHomebrew/decky-loader" /></a>
+ <a href="https://deckbrew.xyz/discord"><img src="https://img.shields.io/discord/960281551428522045?color=%235865F2&label=discord" /></a>
+ <br>
+ <br>
+ 🌐 <a href="./README.md">English</a> · <a href="./README_zh-Hans.md">简体中文</a>
+ <br>
+ <br>
+<!-- <img src="https://media.discordapp.net/attachments/966017112244125756/1012466063893610506/main.jpg" alt="Decky screenshot" width="80%">-->
+</p>
+
+## 🩵 赞助者
+
+[成为赞助者](https://opencollective.com/steamdeckhomebrew)来支持我们的工作!向我们的集体项目捐款将帮助 Decky Loader 开发者支付网络服务器费用、购买新的开发硬件等。
+
+<a href="https://opencollective.com/steamdeckhomebrew"><img alt="Steam Deck Homebrew sponsors on Open Collective" src="https://opencollective.com/steamdeckhomebrew/sponsors.svg?button=true&avatarHeight=46&width=750"></a>
+
+<a href="https://opencollective.com/steamdeckhomebrew"><img alt="Steam Deck Homebrew backers on Open Collective" src="https://opencollective.com/steamdeckhomebrew/backers.svg?button=false&avatarHeight=46&width=750"></a>
+
+## 📖 关于
+
+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) 上使用。它可以很好地替代远程桌面。
+ - 如果您没有其他选择,可以使用右侧触控板作为鼠标,并按 <img src="./docs/images/light/steam.svg#gh-dark-mode-only" height=16><img src="./docs/images/dark/steam.svg#gh-light-mode-only" height=16>+<img src="./docs/images/light/x.svg#gh-dark-mode-only" height=16><img src="./docs/images/dark/x.svg#gh-light-mode-only" height=16> 打开屏幕键盘。
+1. 按下 <img src="./docs/images/light/steam.svg#gh-dark-mode-only" height=16><img src="./docs/images/dark/steam.svg#gh-light-mode-only" height=16> 按钮并打开电源菜单。
+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. 按下 <img src="./docs/images/light/steam.svg#gh-dark-mode-only" height=16><img src="./docs/images/dark/steam.svg#gh-light-mode-only" height=16> 按钮并打开电源菜单。
+1. 选择"切换到桌面模式"。
+1. 再次运行安装程序文件,然后选择 `uninstall decky loader`。
+
+- 对于可以使用 Konsole 的用户,还有一种快速卸载方式。运行 `curl -L https://github.com/SteamDeckHomebrew/decky-installer/releases/latest/download/uninstall.sh | sh` 并在提示时输入密码。
+
+## 🚀 入门指南
+
+现在您已经安装了 Decky Loader,可以开始使用插件了。每个插件由不同的开发者维护,具有各自的用途,但大多数遵循以下通用结构。
+
+### 📦 插件
+
+1. 按下 <img src="./docs/images/light/qam.svg#gh-dark-mode-only" height=16><img src="./docs/images/dark/qam.svg#gh-light-mode-only" height=16> 按钮并导航到 <img src="./docs/images/light/plug.svg#gh-dark-mode-only" height=16><img src="./docs/images/dark/plug.svg#gh-light-mode-only" height=16> 图标。这是 Decky 菜单,用于与插件和启动器本身交互。
+1. 选择 <img src="./docs/images/light/store.svg#gh-dark-mode-only" height=16><img src="./docs/images/dark/store.svg#gh-light-mode-only" height=16> 图标打开插件浏览器。在这里您可以查找和安装插件。
+ - 您也可以在设置菜单中通过 URL 安装。我们不建议安装来自不可信来源的插件。
+1. 要安装插件,请在您想要的插件上选择"安装"按钮。您也可以从下拉菜单中选择一个版本,但不建议这样做。
+1. 要更新、卸载和重新加载插件,请导航到 Decky 菜单并选择 <img src="./docs/images/light/gear.svg#gh-dark-mode-only" height=16><img src="./docs/images/dark/gear.svg#gh-light-mode-only" height=16> 图标。
+ - 请注意,卸载插件只会移除其插件文件,而不会删除它可能创建的任何其他文件。
+
+### 🛠️ 插件开发
+
+目前还没有完整的插件开发文档。不过,一个好的起点是[插件模板仓库](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)的工作。