SteamDeck 小黄鸭汉化版安装指南：从 GitHub 下载 zip 到排查报错

MAKO 小黄鸭（实验性小黄鸭）汉化版最近在 SteamDeck 折腾圈里传得挺快。简单说，这是一个目前在 GitHub 上以 zip 形式提供的 SteamDeck 实验性模块，原版以英文为主，现在有汉化版本，对中文用户友好了不少。如果你已经看到作者说“可以去 github 自取 zip”，又提到“已分享给 Lgc，大家可以在 Lgc 的下个版本自行安装”，那这篇内容刚好可以帮你把整个流程理清楚：从下载 zip、检查文件完整性、在 SteamDeck 桌面模式解压、放进正确目录，到等待 Lgc 整合版发布，再到常见报错怎么排查。

先说结论：这个项目目前明显属于“你能折腾就折腾一下”的实验阶段，不是开箱即用的稳定工具。最值得关注的不是它有多少功能，而是下载、解压、放目录这三步特别容易出问题。很多报错根本不是功能有问题，而是 zip 没下完整，或者解压后目录层级不对。

1. 先搞清楚这个压缩包到底要放在哪

1.1 这不是 Windows 软件，别拿双击安装那套思路来

SteamDeck 本身是 Linux 系统，游戏模式下看起来像个掌机，但切到桌面模式之后，就是一个比较标准的 Linux 桌面环境。你在桌面模式下看到的文件管理器、解压工具、终端，都和普通 Windows 电脑的操作逻辑不一样。

所以从 GitHub 下载的 MAKO 小黄鸭 zip，不是双击就能“安装”的那种 Windows 安装包。它更像一个插件、模组、辅助工具或主题类的独立目录，里面可能会包含配置文件、脚本、语言文件或资源文件。你要做的是把它解压，然后放到对应工具指定的目录里。

如果你之前没在 SteamDeck 上装过类似插件，建议先建立这个认知：这类 zip 的安装方式基本就是“解压 + 复制到目标目录 + 重启对应程序”，没有注册表，也没有自动安装向导。如果教程里说放在某个目录，那就老老实实放在那个目录，不要觉得自己聪明可以换个地方。

1.2 安装前先确认版本和来源

汉化版虽然说了“已汉化”，但原项目本身标记为实验性小黄鸭，也就是说功能、界面、目录结构都可能在未来版本里变化。

下载之前，我建议你先做两件事：

1. 看一眼 GitHub 仓库的说明，确认当前要装的版本和你的 SteamDeck 系统、前置工具是否匹配。
2. 如果你已经在用旧版本或者别的类似工具，先把旧目录和配置文件备份一份，不要直接覆盖。

实验性项目最怕的就是“覆盖安装”。因为新版本可能改了目录结构、改了配置字段，直接覆盖进去，轻则功能不生效，重则连带原来的稳定版本也打不开。

注意：这里不要急着解压，先把 zip 文件保存到一个方便找的位置，比如 SteamDeck 桌面模式的“下载”目录，然后先检查文件本身有没有下完整。

2. GitHub 下载 zip 的几个坑

2.1 访问不稳定，容易下载出“半个文件”

GitHub 访问不稳定是很多用户都会遇到的情况，这里不讨论任何特殊网络工具，只说一个很现实的现象：网络波动会直接导致 zip 文件下载不完整。

很多人遇到报错时，第一反应是“工具坏了”“模块有问题”，但实际是浏览器下载到一半断了，浏览器却仍然给文件标上了 .zip 后缀。你拿到的是一个残缺文件，解压当然失败。

判断方法很简单：

• 看文件大小是不是合理。一个 zip 如果只有几 KB，那