
XGP-save-extractorXbox Game Pass for PC 游戲存檔提取完整指南【免費(fèi)下載鏈接】XGP-save-extractorPython script to extract savefiles out of Xbox Game Pass for PC games項(xiàng)目地址: https://gitcode.com/gh_mirrors/xg/XGP-save-extractor如果你是 Xbox Game Pass for PC 的玩家XGP-save-extractor 這款免費(fèi)開源的 Python 工具能幫你一鍵提取游戲存檔運(yùn)行一條命令它就把指定游戲在當(dāng)前 Windows 用戶下的存檔打包成一個(gè) ZIP 文件方便你備份或把進(jìn)度遷移到 Steam / Epic 版本。它替你做完了找存檔目錄、解析容器格式、還原文件結(jié)構(gòu)這些最容易出錯(cuò)的手工環(huán)節(jié)。工具速覽為什么不必再手動(dòng)翻系統(tǒng)目錄XGP 游戲的存檔藏在%LOCALAPPDATA%\Packages\游戲包名\SystemAppData\wgs這條深層路徑里且文件以 GUID 命名、裝在容器格式中手動(dòng)處理基本靠反復(fù)試錯(cuò)。XGP-save-extractor 的原理很簡單掃描本機(jī)已安裝的支持游戲解析wgs目錄下的containers.index索引和 GUID 映射按每款游戲自己的命名規(guī)則還原出標(biāo)準(zhǔn)存檔文件最后打包成 ZIP。手動(dòng)操作對(duì)比環(huán)節(jié)純手工用 XGP-save-extractor定位存檔位置在Packages下逐層翻找靠文件夾名猜游戲自動(dòng)掃描并匹配內(nèi)置游戲列表解析容器格式自行讀懂containers.index二進(jìn)制索引和 GUID 對(duì)應(yīng)關(guān)系自動(dòng)完成區(qū)分多賬戶用戶目錄形如用戶ID_標(biāo)題ID需手動(dòng)查用戶 ID讀取 Xbox 應(yīng)用的XboxLiveGamer.xml自動(dòng)關(guān)聯(lián) gamertag還原文件命名每款游戲規(guī)則不同加后綴、拆文件夾等容易出錯(cuò)按games.json中各游戲的 handler 配置自動(dòng)處理產(chǎn)出散落的原始文件一個(gè)命名清晰的游戲名_用戶名_時(shí)間戳.zip上手準(zhǔn)備3 步確認(rèn)環(huán)境就緒安裝 Python 3.10 或更高版本python --version預(yù)期看到Python 3.10.x或更新的版本號(hào)。獲取項(xiàng)目代碼git clone https://gitcode.com/gh_mirrors/xg/XGP-save-extractor cd XGP-save-extractor項(xiàng)目結(jié)構(gòu)非常輕量核心就是main.py全部邏輯和games.json支持的游戲列表。確認(rèn)你的游戲在支持列表中打開games.json搜索游戲名能查到即支持。例如{ name: Forza Horizon 5, package: Microsoft.624F8B84B80_8wekyb3d8bbwe, handler: forza }注意區(qū)分支持列表里有 ?未確認(rèn)標(biāo)記的游戲可能尚未在 Steam/Epic 端驗(yàn)證過README.md中還有一份不兼容游戲清單如 Forza Horizon 4、Persona 3 Reload 等這些游戲的存檔格式差異較大暫無法直接轉(zhuǎn)換不建議強(qiáng)行提取。核心操作3 步跑通存檔提取第 1 步保證游戲已安裝并至少完整啟動(dòng)過一次存檔容器是在你進(jìn)游戲后由 Xbox 應(yīng)用創(chuàng)建的。只裝游戲沒進(jìn)過存檔目錄不會(huì)生成反之日常游玩時(shí)云同步會(huì)在后臺(tái)工作后文排錯(cuò)會(huì)用到這一點(diǎn)。第 2 步運(yùn)行提取腳本python main.py你會(huì)看到當(dāng)前用戶下所有已安裝且受支持的游戲被逐一處理無需手動(dòng)選擇Xbox Game Pass for PC savefile extractor Installed supported games: - Hades Save files for user 你的GamerTag: - saves.sav Save files written to hades_你的GamerTag_2026-08-21_20_15_00.zip第 3 步留意同步警告如果輸出中出現(xiàn)Xbox cloud save syncing might not be complete一類的黃色警告如Missing container、Missing file說明此時(shí)云存檔同步可能還沒結(jié)束工具會(huì)按提示暫停等待。按回車跳過即可但被跳過的文件不會(huì)進(jìn) ZIP——建議過幾分鐘重跑一次直到警告消失。結(jié)果驗(yàn)證確認(rèn)提取出來的存檔可用檢查 ZIP 內(nèi)容ZIP 生成在運(yùn)行腳本的當(dāng)前目錄文件名格式為游戲名_用戶名_時(shí)間戳.zip例如hades_YourTag_2026-08-21_20_15_00.zip。解壓后應(yīng)看到該游戲正常的存檔文件例如 Hades 是.sav、Starfield 是重組后的.sfs、Persona 5 Royal 是還原后的目錄結(jié)構(gòu)。遷移到 Steam/Epic把 ZIP 里的文件復(fù)制到目標(biāo)平臺(tái)的存檔目錄各游戲的具體位置可查 PCGamingWiki 對(duì)應(yīng)詞條的 Save game data location。實(shí)測加載啟動(dòng) Steam/Epic 版本游戲確認(rèn)進(jìn)度正確讀取。穩(wěn)妥起見先在游戲里新建一個(gè)存檔槽手動(dòng)保存一次萬一格式不兼容也不至于丟檔。出問題時(shí)的自檢5 個(gè)高頻現(xiàn)象與解法現(xiàn)象 / 報(bào)錯(cuò)可能原因解決辦法提示No supported games installed沒有安裝任何受支持的游戲或裝了但沒啟動(dòng)過到游戲庫確認(rèn)游戲已安裝完整進(jìn)入游戲一次后再運(yùn)行腳本提示Failed to read game listgames.json缺失或損壞重新 clone 倉庫或檢查項(xiàng)目目錄下games.json是否完整反復(fù)出現(xiàn)Missing container/Missing file警告Xbox 云存檔同步正在進(jìn)行中文件處于中間狀態(tài)關(guān)閉游戲等幾分鐘云同步完成后重跑仍反復(fù)出現(xiàn)可檢查 Xbox 應(yīng)用的同步設(shè)置提示The save directory contains backupsXbox 應(yīng)用曾生成過備份副本按提示回車?yán)^續(xù)腳本默認(rèn)跳過備份目錄提取的是正式存檔殺毒軟件把可執(zhí)行文件標(biāo)記為惡意官方發(fā)布的是 PyInstaller 打包的 exe內(nèi)含 Python 解釋器 本腳本易被誤報(bào)改用源碼方式運(yùn)行python main.py行為與 exe 完全一致遷移到 Steam/Epic 后讀檔失敗游戲?qū)儆诟袷讲患嫒萸鍐位蚱脚_(tái)版本差異大對(duì)照README.md中的不兼容清單已確認(rèn)支持的游戲若也失敗檢查存檔目錄是否放對(duì)位置、游戲版本是否一致進(jìn)階拓展容器解析原理與添加新游戲原理要點(diǎn)對(duì)應(yīng)main.py中的函數(shù)discover_games遍歷games.json中的包名在%LOCALAPPDATA%\Packages下查找已安裝的包find_user_containers進(jìn)入包名\SystemAppData\wgs按用戶ID_標(biāo)題ID目錄區(qū)分多賬戶并嘗試把用戶 ID 換成 gamertagread_user_containers讀取containers.index按 GUID 定位每個(gè)容器目錄如...\{容器GUID}\container.1中的真實(shí)文件同時(shí)校驗(yàn)文件是否齊全這就是同步警告的來源get_save_paths按 handler 類型重組文件。通用 handler 有1c1f一容器一文件如 Atomic Heart、1cnf一容器多文件如 Hades、1cnf-folder容器轉(zhuǎn)目錄如 Persona 5 RoyalStarfield、Forza Horizon 5 等則使用專屬 handler 做更復(fù)雜的重組例如把碎片文件按序拼接回.sfs。為它添加新游戲支持有兩條路提需求零代碼在倉庫的 issue 中按 Support for [Game name] 模板提交。模板會(huì)引導(dǎo)你找到該游戲的包名形如開發(fā)商.可能的游戲名_一串字符并把SystemAppData下的wgs文件夾打包附上維護(hù)者據(jù)此實(shí)現(xiàn)支持。自己寫有 Python 基礎(chǔ)在games.json新增一條name/package/handler記錄若現(xiàn)有 handler 不適用在main.py的get_save_paths中實(shí)現(xiàn)一個(gè)新的分支參考starfield或palworld的寫法即可。保持更新定期執(zhí)行g(shù)it pull拉到最新代碼游戲支持列表和容器解析邏輯都在持續(xù)補(bǔ)充。XGP-save-extractor 把 XGP 存檔遷移中最繁瑣、最易出錯(cuò)的環(huán)節(jié)壓縮成了一條命令配合備份 ZIP 與目標(biāo)平臺(tái)實(shí)測換設(shè)備或換平臺(tái)的進(jìn)度保留就變得可控了?!久赓M(fèi)下載鏈接】XGP-save-extractorPython script to extract savefiles out of Xbox Game Pass for PC games項(xiàng)目地址: https://gitcode.com/gh_mirrors/xg/XGP-save-extractor創(chuàng)作聲明:本文部分內(nèi)容由AI輔助生成(AIGC),僅供參考