GitHub 热门项目推荐：Hookshot（C++｜8787 Star）-无双技术网

这个项目有什么用

Hookshot 是一个静态重编译（static recompilation）项目：它把《塞尔达传说：时之笛》（Nintendo Switch 2 版）的游戏代码翻译成 C 语言，再编译成 Windows 或 Linux 原生程序，在 PC 上直接运行，无需模拟器。控制台系统软件被重新实现，Switch 2 的图形部分在 Vulkan 上重建，整个过程都在你自己的电脑上、用你自己的游戏副本完成。

它解决的问题

不想依赖模拟器运行游戏，而是得到一份原生可执行程序。
把「翻译代码、重建系统层、重建图形后端」这些原本需要手工折腾的工作，交给一个构建器一次性完成。
构建完成后，日常启动和更新都通过启动器完成，不必每次重新编译。

典型使用场景

在 Windows 10/11 或主流 Linux 桌面上，用自己合法持有的游戏副本构建并游玩。
在支持 Vulkan 1.3 与 mesh shaders 的较新显卡上获得原生渲染路径。
通过 SSH 或脚本在无图形界面的机器上构建与启动（README 提到 AppImage 支持命令行方式，详见其「Build from source」章节）。

适合愿意按步骤准备环境、硬件达到要求的开发者与玩家；不适合显卡较旧、显存或内存不足、或希望「下载即玩」的用户。

核心特性

静态重编译而非模拟：游戏代码被翻译为 C 并编译成本机程序，控制台系统软件被重新实现，图形层重建在 Vulkan 之上。
自带构建器：Hookshot Builder 自带编译器与工具链，README 明确说明「Nothing else to install」，只需联网下载。
构建一次，之后用启动器：构建完成后从启动器启动游戏，启动器同时提供 Play 与 Update。
游戏内菜单：README 提到可通过游戏内菜单选择较低的 Quality 预设，以适配显存较少的显卡。
跨平台：提供 Windows 安装程序与 Linux AppImage 两种分发形式。
可移植安装：Windows 下可用 --portable 参数做便携安装（详见其文档 docs/windows-portable-builder.md）。

怎么安装

前提条件（README 明确列出）：需要受支持版本的游戏副本——程序 0400486024DEC000、更新 v131072、构建 e0f3ccfa，其他版本不可用；形式可以是 .nup 文件，或 romfs 与 exefs 文件夹。系统方面需要 64 位 Windows 10/11，或 glibc 2.35 及以上的 64 位 Linux，CPU 需支持 AVX2；显卡需支持 Vulkan 1.3 与 mesh shaders（如 NVIDIA GeForce RTX 20 系列及以上、AMD Radeon RX 6000 系列及以上、Intel Arc）；建议 8 GB 以上显存、16 GB 以上内存（一次运行约占用 10 GB），构建期间需要约 60 GB 空闲空间，并需要联网下载。

Windows

打开最新 release 页面，下载 HookshotBuilder.exe。
运行它，它会下载 Hookshot Builder 的其余部分（约 500 MB）、校验并打开。
选择游戏：构建器会在 Downloads、Desktop、Documents 中查找 .nup 文件并列入 Found on this PC；未列出时可点 Browse…、把文件拖到窗口，或选择 romfs and exefs folders。构建器会校验版本。
在 Install the game to 下保留默认目录（用户目录下的 GamesHookshot）或点 Change，并选择 Game language。
点 Build the game，视 CPU 与内存情况约需 10 到 45 分钟。
出现 Your game is ready 后点 Play；Desktop shortcut 与 Start menu entry 默认勾选，不需要可取消。

如需在外置 SSD 上做便携安装，可用 --portable 参数运行下载的安装程序。

Linux

下载 Hookshot--x86_64.AppImage。
赋予可执行权限，可在文件管理器属性中开启「允许作为程序执行」，或在终端执行：
```
chmod +x Hookshot-*-x86_64.AppImage
```
双击打开 Hookshot Builder 窗口。
在 Game files 下选择 .nup file 或 romfs and exefs，点 Browse 选取，构建器会校验版本。
在 Save the game to 下保留 ~/Games/Hookshot 或另选目录，并选择 Language。
点 Build，约需 10 到 45 分钟。
出现「Your game is ready」后点 Play。

注意 AppImage 需要 AVX2；且请保留 AppImage 原位置，启动器依赖它进行更新。首次启动会准备着色器，耗时较长，之后启动更快。

怎么使用

最基础的用法就是构建完成后通过启动器启动。Windows 下从 Hookshot 快捷方式或游戏目录中的 hookshot.exe 启动；Linux 下从应用菜单的「Hookshot」条目或游戏目录中的 hookshot 启动。启动器提供 Play，并在有新版本时提供 Update。

进阶用法一：Linux 下同一份 AppImage 也能在不打开窗口的情况下构建并启动游戏，适用于通过 SSH 访问的机器或脚本场景，README 指向其「Build from source」章节中的命令行说明。

进阶用法二：Linux 下若希望获得较快的 GPU 显存导入，游戏用户需要对 /dev/udmabuf 有读写权限。否则会回退到 host-pointer 导入，在 AMD/RADV 上可能明显变慢；NVIDIA 驱动本身拒绝这些 dma-buf，因此在 NVIDIA 上使用 host-pointer 导入并不慢，可忽略相关警告。若设备不存在，需先加载模块：

sudo modprobe udmabuf

对使用 systemd-logind 的本地桌面会话，README 建议使用设备级 udev 规则，在 /etc/udev/rules.d/70-hookshot-udmabuf.rules 中写入：

SUBSYSTEM=="misc", KERNEL=="udmabuf", TAG+="uaccess"

随后重新加载并应用规则：

sudo udevadm control --reload-rules
sudo udevadm trigger --action=add /sys/class/misc/udmabuf

README 同时提醒不要以 root 身份运行游戏。

适用场景与注意事项

适合：硬件满足 Vulkan 1.3 与 mesh shaders 要求、拥有受支持版本游戏副本、愿意花一次构建时间换取原生运行体验的用户；以及希望在 Linux 上通过脚本或 SSH 流程构建的开发者。

不适合：显卡不支持 mesh shaders 的用户（README 明确「not supported」）；游戏版本不匹配的用户；磁盘空间不足 60 GB 或内存不足 16 GB 的环境；以及希望开箱即玩的用户——游戏需要在你自己的机器上构建。

其他注意点：

项目状态为实验性，README 说明玩家已在多台 PC 上反馈从 Kokiri Forest 到地牢的表现，未解决的问题收集在 tracking issues 中。
构建与首次下载需要联网；构建器自带工具链，无需额外安装编译器。
在机械硬盘上构建会明显变慢，README 建议使用 SSD。
许可证为 GPL-3.0，使用与分发时需遵守其条款。
关于 /dev/udmabuf 的权限，README 提醒加入设备所属组可能同时获得其他设备权限（例如 kvm 会带来虚拟化访问），应谨慎处理。