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 個歸檔檔案
| 標籤與通道 | 檔案名稱 | 檔案大小 | 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 酬載大小、重大工程變更以及被取代版本的警告提示。
| 標籤與通道 | 發佈日期 | 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 | 過往穩定版 | 還原獨立 present 佇列與 write-back diff 路徑，緩解 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 write-back diffing 使 FPS 相較 v2.0.7 提升約 25%，新增即時啟動著色器進度視窗（#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 write-back diff 實作的 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 | 過往穩定版 | 修復編譯 hos_main.c 期間遺失 gpu/vk/oot_cheat_items.h 所導致的 Linux 與 Steam Deck AppImage 組建失敗問題（#990）；新增隨附 host 標頭檔的回歸測試。 |
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 提升器，以及由 HookshotBuilder.exe 在 Windows 上自動下載的 llvm-mingw（ucrt-x86_64 clang/lld）工具鏈。 |
KPI-DL-01 // RECOMMENDED TAG
v2.0.14
最新穩定 Release
發布於 2026-11-09 · 恢復 RX_VK_WB_DIFF=1 寫回 diff 比對
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
10,151 次 v2.0.11 下載 · 整合提取器、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 次下載）。切勿執行來自非官方鏡像站的預打包封存檔。
BUILDER-PARTS 與語意化版本重建規則
何時升級 Hookshot 需要重新執行 資源建置器
根據 docs/VERSIONING.md，Hookshot 遵循語意化版本 2.0.0；版本號碼的遞增可讓您判斷是否必須重新解壓縮 Switch 2 傾印檔案，或只需替換執行時期二進位檔。
RULE 02 // MINOR (x.1.y)著色器 / 程式碼重新連結
Minor Feature Update
Minor 次版本號提升會在不破壞已解包 RomFS 檔案有效性的情況下，加入新的圖形子系統（例如內建 AMD FSR 3.1.3、NVIDIA DLSS NGX 310.9.16 或協同矩陣 TAAU）。HookshotBuilder 會重新編譯變更的 C 單元並更新 hookshot_vk.dll。
RULE 03 // PATCH (v2.0.8 → v2.0.11)DROP-IN UPDATE
Patch 與 Hotfix Release
Patch 修補發布修正了 Vulkan 驅動程式退化問題（v2.0.9 中的 #1161 NVIDIA 621 當機）、過期 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 write-back diffing（相較於 v2.0.7 FPS 提升 25%）以及即時顯示著色器編譯進度（#860）的啟動視窗，並將管線預測上限設為 90 秒。然而，write-back diffing 與獨立 Vulkan present 佇列同時啟用時，會在 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 write-back diffing，使超寬螢幕畫面播放速率提升約 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 工具鏈分段的主要參考來源。