PS4PKGTool 安装与配置完整教程:.NET 10 环境下 PS4 PKG 管理工具 5 步快速部署 + 常见问题解答
PS4PKGTool 安装与配置完整教程:.NET 10 环境下 PS4 PKG 管理工具 5 步快速部署 + 常见问题解答
PS4PKGTool 是一款专为 Windows 设计的 PS4 PKG 管理工具,可用来集中管理你的 PS4 PKG 游戏库:扫描加载、分组查看、重命名、合并补丁、提取文件、安装到 shadPS4,还能集成资源浏览器与文件资源管理器。本教程带你在 .NET 10 环境下从零完成安装与基础配置,新手也能快速上手。
一、先认识 PS4PKGTool 能做什么
在动手之前,花 30 秒了解它能帮你解决什么问题,配置起来会更清晰:
| 能力 | 说明 |
|---|---|
| 📚 库管理 | 拖拽 PKG 文件夹进窗口即可加载,支持按标题 / Title ID / 类别 / 系统版本分组 |
| 🔍 文件查看 | 查看 param.sfo、奖杯列表、文件条目,无需完整解压即可浏览提取 |
| 🔧 任务队列 | 完整提取、合并 PKG、转换 FFPFSC、安装到 shadPS4 统一入队执行 |
| 🗂 资源预览 | 图片、文本、音频元数据、Unity / Unreal 包内容、十六进制回退预览 |
| 🖱 资源管理器集成 | 为 .pkg 文件右键添加重命名、校验、提取、安装菜单 |
⚠️ 重要提示:PS4PKGTool 不是免费获取 PS4 游戏的工具,它用于管理你已经拥有的 PKG 文件。
更多功能详见项目说明 README.md。
二、安装前的环境要求(必看)
在部署前先确认你的电脑满足以下条件,可避免 90% 的报错。
| 项目 | 要求 | 说明 |
|---|---|---|
| 操作系统 | Windows 10 / 11 | 应用为 net10.0-windows 的 WinExe,仅支持 Windows |
| .NET 版本 | .NET 10 | 程序基于 .NET 10 构建 |
| 运行方式 | 已安装 .NET 10 运行时 或 自包含发布包 | 见下方「运行时 vs 自包含」 |
| 磁盘空间 | 约 100 MB+ | 视你管理的 PKG 库大小而定 |
项目工程文件 PS4PKGTool/PS4PKGTool.csproj 明确声明了目标框架:
<TargetFramework>net10.0-windows</TargetFramework>
<OutputType>WinExe</OutputType>
<UseWindowsForms>true</UseWindowsForms>
📌 运行时 vs 自包含
项目的 Release 发布采用 SelfContained=false(框架依赖模式)+ PublishSingleFile=true(单文件发布)。也就是说:
- 默认发布包:体积小,但你的电脑需要已安装 .NET 10 Desktop Runtime;
- 如果你希望免装运行时,可改用自包含发布(
--self-contained),但体积会明显变大。
新手建议:直接安装 .NET 10 桌面运行时,再运行程序即可。
三、方式一:直接运行发布版(推荐新手,最快)
如果你只是想用、不想碰代码,这是最简单的路径:
- 下载最新发布包:从项目的 Release 页面获取最新安装包(见 README.md 的 Download 部分)。
- 解压到固定目录:建议解压到
D:\PS4PKGTool这类短路径、非中文、非只读目录(如不要放在受控的 Program Files)。 - 安装 .NET 10 运行时(若发布包不是自包含版本)。
- 双击
PS4 PKG Tool.exe启动,进入「首次启动配置」流程。
💡 为什么建议短路径?程序在提取 PKG 时会创建临时工作目录,过深的长路径容易触发
MAX_PATH限制,参考 Helper.cs。
四、方式二:从源码构建(适合开发者 / 二次开发)
前提:已安装 Visual Studio 2022+(带 .NET 桌面开发工作负载)或 .NET 10 SDK,并处于 Windows 系统。
1)克隆仓库
git clone https://gitcode.com/gh_mirrors/ps/PS4PKGTool
cd PS4PKGTool
2)了解解决方案结构
解决方案 PS4PKGTool.sln 包含 3 个项目:
- PS4PKGTool/PS4PKGTool.csproj —— 主程序(Windows Forms 界面)
- PS4PKGTool.Core/PS4PKGTool.Core.csproj —— 核心逻辑(任务工厂、PKG 元数据、提取服务)
- PS4PKGTool.Assets/PS4PKGTool.Assets.csproj —— 游戏资源检测 / 导出(图片、音频、Unity/Unreal 包)
3)拉取并构建 2 个依赖仓库(关键,易踩坑)
主程序通过相对路径引用了两个同级的兄弟仓库,它们不在本仓库内,必须单独准备:
- DarkUI:界面控件库,路径
..\..\DarkUI\DarkUI\bin\Release\net10.0-windows\DarkUI.dll - OrbisPkgTool:原生 C# PKG 操作库,路径
..\..\OrbisPkgTool\OrbisPkgTool\OrbisPkgTool.csproj
对应引用见 PS4PKGTool.csproj。
⚠️ 常见报错:如果缺少这两个仓库,构建时会提示找不到
DarkUI.dll或OrbisPkgTool。请务必把它们的目录放在与PS4PKGTool同一父目录下,并先构建DarkUI的 Release 版本。
4)构建 / 发布
# 普通构建(Debug 运行)
dotnet build PS4PKGTool/PS4PKGTool.csproj -c Release
# 单文件发布到 dist 目录(框架依赖,需已装 .NET 10 运行时)
dotnet publish PS4PKGTool/PS4PKGTool.csproj -c Release -o dist
发布配置会输出 win-x64 单文件,参考 PS4PKGTool.csproj。
五、首次启动:3 选 1 加载方式
第一次运行 PS4 PKG Tool.exe 时,程序会自动创建配置目录,并弹出启动选择框,让你选择如何加载 PKG 库(逻辑见 Program.cs):
| 选项 | 适用场景 |
|---|---|
| Load Manifest(加载清单) | 上次已扫描过、存在有效清单缓存,秒开 |
| Scan Directory(扫描目录) | 首次使用或清单失效,重新扫描 PKG 文件夹 |
| Launch Empty(空载启动) | 先打开界面,稍后手动拖入文件夹 |
新手推荐流程:
- 选择 Scan Directory;
- 在弹出的目录选择框中,指定一个存放
.pkg文件的文件夹; - 可选开启「递归扫描」子文件夹;
- 完成后即可在分组列表中查看你的 PKG 库。
后续再次启动,若存在有效清单,选 Load Manifest 即可「扫描一次、每次秒开」。
六、常用配置项速览(Program Settings)
所有配置集中在 Program Settings 界面,主要项(数据结构见 AppSettings.cs):
- PKG 目录与扫描:
PkgDirectories(PKG 存放目录)、ScanRecursive(是否递归子目录)。 - 列显示:可分别开关 Title ID / Content ID / 地区 / 最低固件 / 版本 / 类型 / 类别 / 大小 / 位置等列。
- 颜色标签:
PkgColorLabel及各类 PKG 的前 / 背景色,便于视觉区分 Game / Patch / Addon / App。 - 重命名格式:
RenameCustomName自定义命名格式。 - 官方更新下载:
OfficialUpdateDownloadDirectory指定下载目录。 - shadPS4 相关:兼容列开关、执行路径、游戏安装目录等。
- 文件资源管理器集成:安装 / 移除
.pkg右键菜单(写入HKCU,无需管理员权限)。
设置文件在哪里?
PS4PKGTool 采用便携式设计:所有配置都保存在可执行文件同目录下的 AppData\Settings.conf,而非系统的 %APPDATA%。
PS4PKGTool\
├─ PS4 PKG Tool.exe
└─ AppData\
├─ Settings.conf ← 全部配置(每行一个键值)
├─ PS4PKGToolLog.txt ← 运行日志
├─ ps5bc.json ← PS5 兼容数据缓存
└─ backport.json ← 回退标签缓存
这一设计定义在 SettingsManager.cs 与 Helper.cs。
💡 好处:把整个文件夹拷走或备份,设置、缓存、反馈历史一起打包带走。若你曾从旧版升级,程序会自动把
%APPDATA%\PS4PKGTool里的旧配置回迁到便携目录(见 Program.cs)。
七、常见问题解答(FAQ)
Q1:双击没反应 / 提示缺少 .NET,怎么办?
程序基于 .NET 10。请安装 .NET 10 Desktop Runtime。命令行可执行 dotnet --list-runtimes 检查是否已含 Microsoft.WindowsDesktop.App 10.x。
Q2:从源码构建时报「找不到 DarkUI.dll / OrbisPkgTool」?
这两个是独立仓库,需与 PS4PKGTool 放在同一父目录,且先构建 DarkUI 的 Release 版本。参见上文「从源码构建 · 第 3 步」。
Q3:程序崩溃后想排查问题,日志在哪?
- 运行日志:
AppData\PS4PKGToolLog.txt; - 崩溃堆栈:优先写入可执行目录旁的
crash.log,若目录不可写会回退到%TEMP%\PS4PKGTool-crash.log(逻辑见 Program.cs)。把这两个文件提供给作者能加快定位。
Q4:想用「Send PKG to PS4」远程安装,需要准备什么?
该功能仅兼容可运行 Flatz's Remote Package Installer 的 PS4 固件。需要:
- 在程序设置中填写本机与 PS4 的 IP;
- 安装 Node.js 与
http-server模块(若工具内安装失败,可手动执行npm install http-server -g)。
Q5:生成的 PKG / 合并的补丁安全吗?
自 v1.8.0 起,PKG 操作使用原生 C# 的 OrbisPkgTool 库。官方说明这些产物属实验性质,未经越狱 PS4 实测,请保留原包、自行评估风险(见 README.md 的 OrbisPkgTool Library 部分)。
Q6:如何把 PS4PKGTool 设为 .pkg 的默认打开程序?
右键 .pkg → Open with → Choose another app → 选择 PS4 PKG Tool(或手动指定 PS4 PKG Tool.exe)→ 勾选「始终使用」即可。
八、写在最后
至此,你已经在 .NET 10 环境下完成了 PS4PKGTool 的部署与基础配置:
- ✅ 明确了环境要求与「运行时 vs 自包含」的区别;
- ✅ 掌握了「直接运行」与「源码构建」两条部署路径;
- ✅ 学会了首次启动的 3 选 1 加载与常用配置;
- ✅ 搞清楚了便携式
AppData\Settings.conf配置机制与日志位置。
接下来,试着把你的 PKG 库拖进窗口,体验分组浏览、重命名与合并补丁吧。如果遇到新的报错,优先翻一下 AppData 里的日志文件,往往是第一手线索。
完整功能清单、shadPS4 使用指南与资源查看器说明,可继续参考 README.md。