eugeniosegala/MAKO

项目介绍

MAKO 是一个面向 Linux 游戏的 Vulkan 图形层，为 SteamOS、Steam Deck、Steam Machine 和桌面 Linux 上的游戏加入帧生成、空间缩放和后处理着色器效果。它由两部分紧密配合：MAKO Decky 是 Decky Loader 插件，负责逐游戏控制、安装、更新和启动器集成；MAKO Renderer 是实际承担帧生成与缩放的 Vulkan 层 MAKO 仓库。

默认组件自成一体：MAKO FG 帧生成和开源 MAKO Scaler 无需任何商业组件，着色器效果来自内置的 vkBasalt 分支。只有可选的 Lossless Scaling 帧生成模型和 LS1 缩放会在运行时读取用户自己安装的 Lossless Scaling 资源 Steam 上的 Lossless Scaling，项目本身不分发专有内容。设置按游戏保存为配置文件，可通过 Steam app ID 或进程名匹配。

快速使用

1. 在桌面模式按 Decky Loader 安装指南 装好 Decky Loader，然后回到游戏模式。

2. 从 最新 MAKO Decky 发布页 的 Assets 下载 ZIP。

3. 在 Decky 设置中启用 Developer Mode，选择 Developer > Install Plugin from Zip。

4. 打开 MAKO Decky，选择 Install MAKO Renderer。只装 ZIP 并不会装上渲染层。

5. 对原生 Steam 或 Proton 游戏，在 Steam 属性 > 启动选项 中加入：

   /home/deck/.local/bin/mako-run %command%
   

6. 正常启动游戏，逐个调整固定或自适应帧生成、缩放和着色器效果。

不想用 Decky 的桌面 Linux 用户可以直接安装 MAKO Renderer：解压 最新 Renderer 发布包 中的 MAKO-Renderer-v<version>-linux.tar.xz，运行 Install MAKO Renderer，在配置窗口中匹配游戏可执行文件，再为每个 Steam 游戏添加启动项 ~/.local/bin/mako-launch %command% 直接使用说明。Flatpak 游戏和第三方启动器需要额外的沙箱准备，宿主机的 mako-launch 无法替代；可参考 Flatpak 指南 以及 Heroic、Lutris、EmuDeck 的启动器说明。

项目还在 Hugging Face 发布了可独立使用的帧生成模型与运行时。

使用约束

已发布的 Renderer 包面向 x86_64 Linux 主机，包含 64 位和 32 位 x86 游戏进程的层；不提供原生 AArch64 包。开发和测试使用 AMD GPU 与 Mesa RADV 驱动，包括 Steam Deck；NVIDIA 和 Intel GPU 由社区测试，依赖 AMD 硬件的选项在 配置指南 中已注明。效果因游戏、显示模式和 VRR 状态而异，项目建议每次只比较一项设置，并在全屏、无边框和窗口模式间尝试。MAKO Decky 与独立压缩包共用同一份原生 Renderer，安装任一方都会选定其版本；卸载 Renderer 会保留插件配置，卸载 Decky 则保留 Renderer 与启动器。MAKO 是独立社区项目，与 Lossless Scaling、Decky Loader、lsfg-vk、vkBasalt 或 ReShade 无隶属关系；使用可选 Lossless Scaling 模型的用户需自行遵守相应许可。代码以 GPL-3.0-or-later 分发。

HotRepo 点评

2026-11-13 的快照显示 MAKO 共 773 星，当日新增 49 星，在 C++ 日榜上的最好名次为第 10。单条快照只能说明当天的位置，不足以判断增长趋势，但可以看出 Decky 插件加 Vulkan 帧生成层这一组合在 C++ 生态中当天确实获得了关注。项目的来源交代得很清楚：Renderer 源自 lsfg-vk 上游提交，Decky 界面源自早期的 Decky LSFG-VK 插件 Decky LSFG-VK 插件，而开源的 MAKO Scaler 是在本仓库独立实现的，这让代码比黑盒分发更容易审查。