RULE 01 // MAJOR (2.x.y)需要完全重新构建
主版本升级（v1.x → v2.0.0+）
主版本号更新会改变提升后的 C 分片布局（g_module_a / g_module_b）、NSO 重定位表或提取的 RomFS 资产目录架构。必须针对您的 0400486024DEC000 v131072 转储重新运行 HookshotBuilder，以重新生成 work/sa/gen/*.c 并重新链接 hookshot.exe。
Hookshot 全部发行版与 SHA-256 校验归档
直接从 GitHub 上的 NotRexed/Hookshot 下载官方 Hookshot v2.0.11 二进制包。Windows x64 用户运行 0.2 MB 的 HookshotBuilder.exe 启动器（该启动器会自动获取分卷 builder-parts Clang/Python 工具链），而 Linux x86_64 与 Steam Deck 用户则运行独立的 205.5 MB Hookshot-v2.0.11-x86_64.AppImage。两个软件包均不包含受版权保护的 Nintendo Switch 2 游戏转储或密钥——您必须自行提供合法转储且已更新至 v131072 的 Title ID 0400486024DEC000（ExeFS 主 NSO SHA-1 前缀 e0f3ccfa）。
GITHUB 官方直连包 // v2.0.14 最新版
Hookshot v2.0.14 官方发行包与 SHA-256 校验表
直连 NotRexed/Hookshot 仓库 v2.0.14 全部官方构建产物，附精确字节大小与一键复制 SHA-256 摘要。
| 文件名 | 适用平台 | 体积 | SHA-256 校验值 | 官方直连 |
|---|---|---|---|---|
hookshot-linux.txt | Linux x86_64 / Steam Deck | 1.3 KB | d09f1c65db…6e49a8 | ⬇ 下载 ↗ |
hookshot-setup.txt | Windows 10 / 11 (64位) | 1.6 KB | 76f00a7530…d5000e | ⬇ 下载 ↗ |
Hookshot-v2.0.14-x86_64.AppImage | Linux x86_64 / Steam Deck | 221.1 MB | a6964ac29b…b43419 | ⬇ 下载 ↗ |
HookshotBuilder.exe | Windows 10 / 11 (64位) | 178.5 KB | 6e64916c1a…ae17bb | ⬇ 下载 ↗ |
展开历史旧版本（2.0.13 至 2.0.8）及全部 31 个归档文件
| Tag 与通道 | 文件名 | 体积 | SHA-256 校验值 | 官方直连 |
|---|---|---|---|---|
| v2.0.14 | hookshot-linux.txt | 1.3 KB | d09f1c65db…6e49a8 | ⬇ 下载 ↗ |
| v2.0.14 | hookshot-setup.txt | 1.6 KB | 76f00a7530…d5000e | ⬇ 下载 ↗ |
| v2.0.14 | Hookshot-v2.0.14-x86_64.AppImage | 221.1 MB | a6964ac29b…b43419 | ⬇ 下载 ↗ |
| v2.0.14 | HookshotBuilder.exe | 178.5 KB | 6e64916c1a…ae17bb | ⬇ 下载 ↗ |
| v2.0.13 | hookshot-linux.txt | 1.3 KB | ae8ca00361…bc2628 | ⬇ 下载 ↗ |
| v2.0.13 | hookshot-setup.txt | 1.6 KB | cf244c1533…4ddd33 | ⬇ 下载 ↗ |
| v2.0.13 | Hookshot-v2.0.13-x86_64.AppImage | 221.1 MB | c45bc7efb8…054874 | ⬇ 下载 ↗ |
| v2.0.13 | HookshotBuilder.exe | 178.5 KB | 86d2b44fea…745abb | ⬇ 下载 ↗ |
| v2.0.12 | hookshot-linux.txt | 1.3 KB | d78f73dcd5…68a9cf | ⬇ 下载 ↗ |
| v2.0.12 | hookshot-setup.txt | 1.6 KB | 5eb9987a74…8ad4e9 | ⬇ 下载 ↗ |
| v2.0.12 | Hookshot-v2.0.12-x86_64.AppImage | 221.1 MB | 2fc636f973…ca6571 | ⬇ 下载 ↗ |
| v2.0.12 | HookshotBuilder.exe | 178.5 KB | 82f37b623c…4c20e9 | ⬇ 下载 ↗ |
| v2.0.11 | hookshot-linux.txt | 1.3 KB | 085a7986f9…0b51e6 | ⬇ 下载 ↗ |
| v2.0.11 | hookshot-setup.txt | 1.6 KB | aeac668f09…f6f333 | ⬇ 下载 ↗ |
| v2.0.11 | Hookshot-v2.0.11-x86_64.AppImage | 205.5 MB | 5863f9dcea…346e01 | ⬇ 下载 ↗ |
| v2.0.11 | HookshotBuilder.exe | 175.5 KB | d085bd291c…75b09b | ⬇ 下载 ↗ |
| v2.0.10 | hookshot-linux.txt | 1.3 KB | f87def339b…1b68d2 | ⬇ 下载 ↗ |
| v2.0.10 | hookshot-setup.txt | 1.6 KB | 4edc5aecc9…7ff02f | ⬇ 下载 ↗ |
| v2.0.10 | Hookshot-v2.0.10-x86_64.AppImage | 205.5 MB | cced69bf1b…a6e763 | ⬇ 下载 ↗ |
| v2.0.10 | HookshotBuilder.exe | 175.5 KB | d085bd291c…75b09b | ⬇ 下载 ↗ |
| v2.0.9 | hookshot-linux.txt | 1.3 KB | b0cb49268c…e6af31 | ⬇ 下载 ↗ |
| v2.0.9 | hookshot-setup.txt | 1.6 KB | bf8f14c9e4…9959c4 | ⬇ 下载 ↗ |
| v2.0.9 | Hookshot-v2.0.9-x86_64.AppImage | 205.5 MB | 687d99c179…c24e97 | ⬇ 下载 ↗ |
| v2.0.9 | HookshotBuilder.exe | 175.5 KB | d085bd291c…75b09b | ⬇ 下载 ↗ |
| v2.0.8 | hookshot-linux.txt | 1.3 KB | 8e870c365b…30b436 | ⬇ 下载 ↗ |
| v2.0.8 | hookshot-setup.txt | 1.6 KB | a07eb50e51…200eba | ⬇ 下载 ↗ |
| v2.0.8 | Hookshot-v2.0.8-x86_64.AppImage | 205.5 MB | e57a994341…6d2d33 | ⬇ 下载 ↗ |
| v2.0.8 | HookshotBuilder.exe | 175.5 KB | d085bd291c…75b09b | ⬇ 下载 ↗ |
| v2.0.8-rc.5 | hookshot-linux.txt | 1.3 KB | e2ed8f90bd…5648c1 | ⬇ 下载 ↗ |
| v2.0.8-rc.5 | hookshot-setup.txt | 1.6 KB | a07eb50e51…200eba | ⬇ 下载 ↗ |
| v2.0.8-rc.5 | Hookshot-v2.0.8-rc.5-x86_64.AppImage | 205.5 MB | ca685ffc61…6105a2 | ⬇ 下载 ↗ |
分组发布台账 // 发布通道筛选
完整 Hookshot Release 与资源清单（v2.0.11 至 v0.1.0）
按发布通道（稳定版、预览版或工具链）筛选全部 10 个已验证的发布记录。查看具体的 Windows 与 Linux 资产文件名、折合为 205.5 MB 的 AppImage 有效负载大小、关键工程变更以及已废弃构建的警告信息。
| Tag 与通道 | 发布日期 | Windows x64 资产 | Linux x86_64 资产与大小比例条 | Release Status | 关键工程改动与关联 |
|---|---|---|---|---|---|
v2.0.11Hookshot v2.0.11（最新稳定版）稳定版 | 2026-11-09 | HookshotBuilder.exe（0.2 MB 启动器 + builder-parts） | Hookshot-v2.0.11-x86_64.AppImage 205.5 MB | 官方推荐最新版 | 重新启用 VRAM 写回差分（默认 RX_VK_WB_DIFF=1），同时保持独立的呈现队列关闭；相比 v2.0.9 的约 36 FPS，在 RTX 4060 Ti 上的 3440x1440 分辨率下恢复至约 48 FPS。 |
v2.0.10Hookshot v2.0.10（构建器更新修复）稳定版 | 2026-11-09 | HookshotBuilder.exe（0.2 MB 启动器 + builder-parts） | Hookshot-v2.0.10-x86_64.AppImage 205.5 MB | 历史稳定版 | 修复因残留的旧版已翻译 C 文件（未声明的 g_module_b 或未定义的符号 f_8...）导致的更新编译/链接失败（#1176、#1197）；失败的构建现在会自动丢弃部分生成的代码。 |
v2.0.9Hookshot v2.0.9（NVIDIA 621 驱动热修）稳定版 | 2026-11-09 | HookshotBuilder.exe（0.2 MB 启动器 + builder-parts） | Hookshot-v2.0.9-x86_64.AppImage 205.4 MB | 历史稳定版 | 通过还原独立的呈现队列与回写差异路径，缓解 NVIDIA 621 系列驱动程序在着色器准备就绪后立即出现 GPU 设备丢失的问题（#1161），同时保留 v2.0.8 超宽屏及启动阶段的 UI 修复。 |
v2.0.8Hookshot v2.0.8（性能与启动进度 Update）稳定版 | 2026-11-09 | HookshotBuilder.exe（0.2 MB 启动器 + builder-parts） | Hookshot-v2.0.8-x86_64.AppImage 205.4 MB | 已被 v2.0.9+ 取代 | 借助 VRAM 回写差异比对，相较于 v2.0.7 带来约 25% 的 FPS 提升；新增启动时即刻显示的着色器进度窗口（#860），并修复超宽屏崩溃问题。 |
v2.0.8-rc.5Hookshot v2.0.8-rc.5（候选发布版 5）预发布版 | 2026-11-09 | 源码 / CI 构建 | Hookshot-v2.0.8-rc.5-x86_64.AppImage 205.4 MB | 预发布版本归档 | v2.0.8 的最终候选发布版，汇集了 rc.4 的各项改动，并针对 VRAM 回写差异实现修复了 Linux 构建问题。 |
v2.0.8-rc.4Hookshot v2.0.8-rc.4（Release Candidate 4）预发布版 | 2026-11-09 | 源码 / CI 构建 | CI 构建已跳过（已在 rc.5 修复） 0 MB | 已被取代的预发布版 | next 分支上的过渡测试构建，在修复 Linux AppImage 打包问题后立即被 v2.0.8-rc.5 取代。 |
v2.0.8-rc.3Hookshot v2.0.8-rc.3（候选发布版 3）预发布版 | 2026-11-09 | 源码 / CI 构建 | Hookshot-v2.0.8-rc.3-x86_64.AppImage 205.3 MB | 预发布版本归档 | 将启动流水线预测上限设为 90 秒，并立即打开游戏窗口以实时显示着色器编译进度（#860）。 |
v2.0.7Hookshot v2.0.7（Linux 与 Steam Deck AppImage Fix）稳定版 | 2026-11-09 | HookshotBuilder.exe（0.2 MB 启动器 + builder-parts） | Hookshot-v2.0.7-x86_64.AppImage 205.3 MB | 历史稳定版 | 修复 Linux 与 Steam Deck AppImage 构建失败问题（#990，即编译 hos_main.c 时缺少 gpu/vk/oot_cheat_items.h）；为随附的宿主头文件添加回归测试。 |
v0.1.0Hookshot v0.1.0（初始语义化 Release 基线）稳定版 | 2026-11-07 | HookshotBuilder.exe（0.2 MB 启动器 + builder-parts） | Hookshot-v0.1.0-x86_64.AppImage 204 MB | 初始版本化基线 | 建立语义化版本 2.0.0 发布自动化，附带 NVIDIA DLSS（NGX SDK 310.9.16）与内置 AMD FSR 3.1（FidelityFX SDK 1.1.4），并移除无法正常工作的 MSAA 选项（#439）。 |
builder-partsHookshot Builder Parts（Windows Toolchain 与 Clang Payload）工具链 | 2026-11-09 | hookshot-setup.txt + 分卷构建器归档 | 直接内置于 Hookshot-x86_64.AppImage 中 205.5 MB | 必需的 Windows Payload | 提供嵌入式 Python 运行时、a64-kit 提升器以及 llvm-mingw（ucrt-x86_64 clang/lld）工具链，由 HookshotBuilder.exe 在 Windows 上自动下载。 |
KPI-DL-01 // RECOMMENDED TAG
v2.0.14
最新稳定版 Release
发布于 2026-11-09 · 恢复 RX_VK_WB_DIFF=1 写回差分机制
KPI-DL-02 // WINDOWS PAYLOAD
0.2 MB
HookshotBuilder.exe Launcher
50,144 次 v2.0.11 下载 · 自动拉取 builder-parts Clang/Python 有效负载
KPI-DL-03 // LINUX & STEAM DECK
205.5 MB
Hookshot-v2.0.11-x86_64.AppImage
v2.0.11 累计 10,151 次下载 · 打包集成反编译提升器、Clang 以及 SDL3/Vulkan
KPI-DL-04 // VERSIONING CADENCE
SemVer 2.0
10 个已编入索引的 Build 里程碑
6 个稳定版标签，3 个 v2.0.8 Release 候选版本，1 个 Toolchain 发布
文件资产与防恶意软件严格校验启动前请核对官方 GitHub 资产的文件名与大小
NotRexed/Hookshot 官方发布在 github.com/NotRexed/Hookshot/releases 上每个标签发布四个主要文件：HookshotBuilder.exe（0.2 MB Windows WPF 引导启动程序，在 v2.0.11 上记录有 50,144 次下载）、Hookshot-v2.0.11-x86_64.AppImage（205.5 MB Linux 捆绑包，10,151 次下载）、hookshot-setup.txt（36,046 次下载）以及 hookshot-linux.txt（3,788 次下载）。切勿运行来自非官方镜像的预打包归档。
构建器组件与 SEMVER 重新构建规则
何时升级 Hookshot 需要重新运行 资源构建器
根据 docs/VERSIONING.md，Hookshot 遵循 Semantic Versioning 2.0.0：版本号的递增方式明确指示了你是需要重新解包 Switch 2 转储，还是仅替换运行时二进制文件即可。
RULE 02 // MINOR (x.1.y)着色器 / 代码重新链接
Minor Feature Update
Minor 更新会增加新的图形子系统（如内置 AMD FSR 3.1.3、NVIDIA DLSS NGX 310.9.16 或协作矩阵 TAAU），而不会使已解包的 RomFS 文件失效。HookshotBuilder 会重新编译变更的 C 单元并更新 hookshot_vk.dll。
RULE 03 // PATCH (v2.0.8 → v2.0.11)DROP-IN UPDATE
Patch 与 Hotfix Release
Patch 发布用于修复 Vulkan 驱动退化（#1161 NVIDIA 621 驱动在 v2.0.9 中的崩溃）、清理残留的旧版 C 翻译代码（v2.0.10 中的 #1176/#1197）以及恢复 RX_VK_WB_DIFF=1 性能（v2.0.11），同时保留所有现存的 save_00.sav 文件。
技术规范 // 发行包结构与性能演进
Windows HookshotBuilder.exe 与 Linux x86_64 AppImage 打包对比
在 On Windows 10（21H2+）和 Windows 11 x64 上，Hookshot 以小巧的 0.2 MB WPF 启动程序形式发布，命名为 HookshotBuilder.exe 并附带 hookshot-setup.txt。首次启动时，HookshotBuilder.exe 会从 GitHub Releases 下载分卷 builder-parts 工具链标签——内含嵌入式 Python 3 解释器、Capstone/Unicorn AArch64 提升器依赖项以及 llvm-mingw（ucrt-x86_64 Clang/LLD）编译器——之后提示您选择已解密的 Switch 2 转储（.nup 归档或已提取的 romfs+exefs 目录）。从 v2.0.10 和 v2.0.11 开始，失败或中断的更新构建会自动丢弃部分生成的 C 文件，确保残留符号绝不会破坏后续编译（#1176、#1197）。
在 On Linux x86_64 桌面发行版（glibc 2.35+）和 SteamOS 3.6+（Steam Deck LCD 与 OLED）上，每个版本均以单个独立的 205.5 MB AppImage（Hookshot-v2.0.11-x86_64.AppImage）形式发布，并附带 hookshot-linux.txt。使用 chmod +x Hookshot-v2.0.11-x86_64.AppImage 为该文件赋予可执行权限后启动，即可直接打开构建器向导，无需外部 Python 或 Clang 依赖，进而生成原生 hookshot 可执行文件及 hookshot_vk.so 渲染器。
Release 演进：从 v2.0.8 写回差分到 v2.0.11 恢复
理清 v2.0.8 到 v2.0.11 之间的快速更迭，有助于玩家挑选适宜的构建版本与启动参数。v2.0.8 版本（历经 rc.3、rc.4 和 rc.5 候选版）引入了 VRAM 回写差异比对（相较于 v2.0.7 带来 +25% FPS），并加入了实时显示着色器编译进度的启动窗口（#860，管线预测上限 90 秒）。然而，将回写差异比对与独立的 Vulkan 呈现队列搭配使用时，会导致 NVIDIA 621 系列驱动在着色器准备完成后立即触发 VK_ERROR_DEVICE_LOST 崩溃（#1161）。
版本 v2.0.9 通过同时禁用独立呈现队列与写回差分，热修复了 NVIDIA 621 驱动崩溃问题；而 v2.0.10 解决了构建器更新时的链接错误（#1176、#1197）。最终，v2.0.11 重新启用了 VRAM 写回差分（默认 RX_VK_WB_DIFF=1），同时保持独立呈现队列关闭——在 RTX 4060 Ti 上以 3440x1440 带宽运行时的帧率恢复至约 48 FPS（高于 v2.0.9 上的约 36 FPS），且未重新引入 NVIDIA 驱动崩溃问题。
技术问答 // 版本与升级解答
下载与 Release 常见问题解答
为什么 HookshotBuilder.exe 在 Windows 上仅有 0.2 MB，而 Linux AppImage 却有 205.5 MB？
HookshotBuilder.exe 是一个轻量级的 .NET 8 WPF 引导程序，会按需将分卷 builder-parts 工具链（嵌入式 Python + llvm-mingw Clang/LLD）下载到您的工作文件夹中。而 Linux x86_64 AppImage 则将完整的工具链和运行时打包在单个 205.5 MB squashfs 镜像内，因此可在 Steam Deck 和桌面版 Linux 上完全离线运行。
我应该下载 v2.0.11 还是停留在 v2.0.9 / v2.0.10？
建议所有用户升级至 v2.0.11。该版本整合了针对 v2.0.9 NVIDIA 621 系列驱动的修复（#1161）、v2.0.10 构建器更新清理修复（#1176/#1197），并恢复了 RX_VK_WB_DIFF=1 VRAM 回写差异比对，使超宽屏帧率提升约 33%。
从 v2.0.7/v2.0.9 更新到 v2.0.11 会丢失存档文件吗？
不会。存档文件（save_00.sav 至 save_02.sav 及 autosave.sav）与编译生成的二进制文件分开存储，在所有 v2.0.x 修订版本之间保持 100% 兼容。
官方发布凭据
官方 GitHub Release 与版本控制来源
- SRC-REL-01
所有 10 个发布标签、资源文件名、字节大小及下载计数的一手来源。
- SRC-REL-02
关于 v2.0.11 RX_VK_WB_DIFF=1、v2.0.10 #1176/#1197、v2.0.9 #1161 以及 v2.0.8 #860 说明的一手来源。
- SRC-REL-03
主版本.Minor.Patch 重建规则与 builder-parts 工具链分卷划分的主要来源。