安装与排错 / 已核验 v2.3.2最近核验:2026-11-16 · 15:31 UTC

安装 Hookshot,保留存档,了解限制

使用你自己的受支持游戏文件在本地构建。先读当前项目文档;遇到错误时,记录具体步骤、版本及硬件。

01

构建前核对要求

当前 README 的要求;满足条件不代表运行一定稳定
项目文档要求
WindowsWindows 10/11,x64。使用当前 Windows Builder。
Linuxx64;AppImage 要求 glibc 2.35+ 与 AVX2。保留 AppImage 以便更新。
显卡Vulkan 1.3 与网格着色器。README 列出 RTX 20 系列及以上、Radeon RX 6000 系列及以上、Intel Arc。建议 8 GB 显存。
内存 / 存储至少 16 GB 内存;构建约需 60 GB 可用空间。
游戏输入你自己的受支持 .nup。当前 README 也接受 .nx 或已提取的 romfs/exefs;Builder 会验证游戏版本。

本站不提供游戏文件,也不托管或接收 .nup 转储、ROM、密钥或现成游戏可执行文件;不提供获取未授权副本的指引。

02

Windows x64:当前 Builder 流程

01

打开已核验的发布页

从 NotRexed 的 Forgejo 发布页进入,阅读对应版本说明。通过项目本身获取 Builder;本指南只链接发布页,不重新分发文件。

02

让安装程序准备工具

运行当前 Builder,让正常依赖安装完成。编译器和库由它提供。下载失败时,查看下方项目自己的手动依赖安装指引。

03

选择输入文件与输出目录

选择你自己的受支持 .nup、输出目录和语言。留足磁盘空间并等待验证完成。游戏版本不匹配的文件可能被拒绝。

04

构建、准备着色器,再运行

等待本地构建和首次着色器准备完成。如果点击 Play 后立即退出,先记录日志及显卡/驱动信息,再判断应采用哪种修复。

关于 Visual Studio Desktop C++ 与 MFC:它们出现在旧版教程中。当前 v2.3.2 README 明确说明,无需预先安装 Visual Studio、Python 或 Git。从源码开发 Builder 属于另一套流程。

03

常见错误与适用范围

Builder 卡在查找游戏文件

v2.3.1 发布说明修复了因 USB、云端或网络驱动器无响应而无限等待的问题。若使用旧 Builder,先更新。若当前版本仍卡住,报告具体步骤和日志;单纯等待不是通用修复。

依赖下载失败

v2.3.2 提供手动回退方式:通过项目手动安装页获取指定依赖,放入 Downloads,再运行安装程序进行验证。避免第三方整合包。可选 DLSS 的连接错误,常见问题文档建议稍后重试或不安装可选 DLSS。

点击 Play 后立即退出

记录 Hookshot 版本、系统、显卡、驱动及 hookshot_log.txt。查看迁移后的崩溃追踪 #2507。旧问题 #1288 已被合并关闭;“已关闭”并不表示你的系统问题已经修复。

“Incomplete compressed frame” 或输入验证错误

常见问题文档将不完整压缩帧与不完整的游戏副本关联。重新检查或复制你自己的本地输入,核对支持的游戏版本。不要从未知下载站获取替代游戏包。

低帧率、卡顿或不稳定

等待着色器准备完成。用相同场景、分辨率、升频设置和帧率上限比较;比较基础游戏帧率时关闭帧生成。记录内存占用、显卡/驱动和卡顿日志。查看硬件追踪,不假设某个预设适用于所有设备。

常见问题页主要汇集 11 月 10 日、v2.0.14 的报告,部分链接仍指向旧 GitHub。阅读这些历史建议时,应同时对照当前发布说明和迁移后的 Forgejo 问题追踪。

04

Linux、Steam Deck 与显卡

不支持网格着色器的显卡,其回退方案仍不完整。部分变通设置会去除几何体或重要模型,不应盲目套用。v2.3.2 宣布了 Linux 内存与 GPU 改进,但本站未进行独立硬件基准测试。

Linux 与 Steam Deck

Linux AppImage 要求 glibc 2.35+ 与 AVX2。赋予可执行权限后,按本地文件构建流程操作。追踪 #1000 仍开放,包含 GPU 重置、崩溃、低帧率与构建问题;不能据此承诺 Steam Deck 流畅运行。

Windows 上的 AMD 显卡

追踪 #996 仍开放,包含设备丢失、驱动与冻结报告。满足最低显卡条件不能排除这些问题。更改正常工作的配置前,先对照自己具体的显卡和驱动版本。

05

保留进度再更新

01

关闭游戏并备份

Windows:<游戏目录>\user\save\<用户 ID>\ Linux:~/.local/share/hookshot/save/<用户 ID>/ XDG_DATA_HOME 可改变 Linux 基础路径。使用 --user <目录> 时,存档在 <目录>/save/<用户 ID>/。请另存一份独立备份。

02

通过当前启动器更新

当前 README 说明可复用同一游戏目录,保留存档、设置和模组。原始本地输入会保留,常规更新不必再次提供 .nup。先读发布说明,确认新构建能读取存档前不要删除旧备份。

03

了解自动备份位置

v2.3.2 增加目录外备份,保留最近 20 份。 Windows:%LOCALAPPDATA%\Hookshot\save-backups Linux:~/.local/share/hookshot/save-backups 仍应保留手动备份,尤其是在切换项目之前。