boykopovar/AnyPS5

Tool for automatic PS5 executables porting to Linux and Windows

這是什麼

AnyPS5 是一個用來把 PS5 executables 自動移植到 Linux 與 Windows 的工具，README 對它的定位很直接：不是模擬器，也不是另開一個獨立 runtime process，而是透過 relinker 將可執行檔轉成目標系統的 native format，並提供可動態連結的 system prx libraries 實作。它的目標比較接近相容性、保存與研究工具：讓既有執行檔在不同桌面平台上被重新連結與執行，同時處理 shader、輸入映射、系統函式等落差。README 也把 Usage、Build instructions、Architecture、Technical debt、Conventions、Contributing 分成文件連結，顯示這不是單一腳本，而是一套仍在演進的移植基礎工程。

為什麼上榜

週榜第一名、30050 stars、週增 25151 stars，熱度非常集中。它吸引人的地方在於命題本身很大膽：PS5 executable 到 Linux/Windows 的自動 porting，而且 README 明確寫出 No emulation or separate runtime process。這與一般玩家熟悉的「模擬器」敘事不同，更像是把主機執行環境拆成可重新連結的系統介面與函式庫實作。另一個上榜原因是它提供了可視化狀態：system libraries、shaders 的 badge 與 progress map，讓外界能看到專案已知函式、shader recompiler 與遊戲相容性的進度，而不是只有概念宣示。

適合誰，可以拿來做什麼

AnyPS5 適合對 遊戲保存、平台相容性、逆向工程、系統函式重建 有興趣的開發者閱讀與實驗。README 提到 verified games 清單，也列出 Dreaming Sarah 這款 2D platformer 在 GTX 1050 Ti / i5-7500 3.4GHz 上可穩定 60 fps，這提供了一個具體但有限的參考點：專案已能跑部分案例，但相容性仍需看清單與已知問題。一般玩家若只想「一鍵玩遊戲」，README 並沒有把它包裝成成熟產品；更合理的期待是把它當成研究型工具，理解 relinker、PRX library、SPIR-V shader recompiler 與輸入映射如何共同補齊跨平台執行所需的層次。

上手

README 本身沒有直接列出安裝或 build 指令，而是提供文件連結：Usage 在 docs/user/USAGE.md，Build instructions 在 docs/dev/BUILD.md，Architecture 在 docs/dev/ARCHITECTURE.md。因此這裡不補寫 README 沒有的命令；建議先從專案內文件開始。

README 未提供明確安裝步驟；請參考：
docs/user/USAGE.md
docs/dev/BUILD.md
docs/dev/ARCHITECTURE.md

README 另外提醒，遇到不支援或非預期狀態時會丟出 std::runtime_error，what() 會輸出到 stderr，然後 process 結束；這也意味著除錯時要留意標準錯誤輸出。

README 重點摘要

• 核心架構：relinker 轉換 executable，system prx libraries 提供可動態連結的系統介面實作。
• 不是模擬器路線：README 明確寫出不需要 emulation 或 separate runtime process。
• 相容性仍需查清單：README 指向 verified games 與 compatibility list，並只舉出 Dreaming Sarah 的 60 fps 案例。
• Shader recompiler：可產生 SPIR-V，並可在啟用 ANYPS5_ENABLE_SPIRV_TOOLS 時用 Spirv-Tools 驗證。
• 法律與授權提醒：專案聲明不包含或散布受版權保護軟體、firmware、keys、proprietary libraries，授權為 GPL-2.0 only。