PS4PKGTool快速上手:5分钟搭建你的PS4 PKG管理工作流
PS4PKGTool快速上手:5分钟搭建你的PS4 PKG管理工作流
📦 PS4PKGTool(PS4 PKG Tool)是一款 Windows 上的 PS4 PKG 管理工具,帮助你管理整个 PKG 库:扫描与分组浏览、批量重命名整理、PKG 信息查看、合并与提取,以及一键安装到 shadPS4 模拟器。本文带你用 5 分钟搭建一套完整的 PS4 PKG 管理工作流。
一、PS4PKGTool 是什么?功能一览
PS4PKGTool 把"PKG 收藏管理"这件事做成了图形化应用,核心能力包括四大块:
| 功能模块 | 能做什么 | 对应源码位置 |
|---|---|---|
| 📚 库管理 | 清单缓存快速启动、拖拽加载 PKG 文件夹、按标题/地区/类型分组 | Main.cs |
| 🔍 查看器 | 查看 param.sfo、奖杯列表、文件条目,预览图片/文本/音频/Unity 与 Unreal 资源 | MiniPkgViewerForm.cs |
| ⚙️ 操作与任务队列 | 合并、完整提取、PKG 转 FFPFSC、安装到 shadPS4,任务自动排队且重启不丢失 | Main.Tasks.cs |
| 🎮 shadPS4 集成 | 管理模拟器内核、安装游戏库、备份存档、启动诊断 | Shadps4Manager.cs |
完整功能说明可参考项目文档 README.md。
二、安装与首次启动:5分钟上手步骤
1. 环境准备
- Windows 系统
- .NET 10 运行时(已发布版通常无需额外安装)
💡 也可以从源码构建:
git clone https://gitcode.com/gh_mirrors/ps/PS4PKGTool,然后在解决方案 PS4PKGTool.sln 中用dotnet publish生成单文件可执行程序。
2. 首次启动的选择
启动程序后,会弹出 Manifest Loader 启动提示窗(ManifestLoaderPrompt.cs),根据你的 PKG 库状态提供三个选项:
- Load from Manifest — 用上次扫描的清单缓存,秒开库(推荐)
- Scan from Directory — 从已配置的目录重新扫描 PKG
- Launch Empty — 空窗启动,稍后再导入
这是 PS4PKGTool "快速启动"的关键:首次扫描一次,之后每次打开都基于清单缓存直接加载,几千个 PKG 也能瞬间呈现。
三、建立 PKG 库:拖拽即入库
- 把存放
.pkg文件的文件夹(支持多个)直接拖拽到主窗口即可完成加载 - 在列表视图中按需切换分组方式:按 Title / Title ID / Category / System Version / PKG Type 组织
- 使用筛选栏按类别(Game、Patch、Addon、App)过滤,或直接按文件名、标题、ID 搜索
✅ 小技巧:勾选 scan_recursive 相关选项后,嵌套子目录里的 PKG 也会被扫描到(可在 Program Settings.cs 中调整)。
四、常用操作速览:重命名、合并、提取
✏️ 一键重命名
PKG 文件通常长得像 NPXS00103_00-0000000000000000.pkg,难以辨认。PS4PKGTool 支持:
- 按安装优先级批量重命名(基础包、更新、DLC 一目了然)
- 使用命名预设或自定义格式(设置项
rename_custom_format)
🧩 合并 PKG
选中一个基础 PKG 和它的更新 PKG,即可 Merge PKG 合并成一个完整游戏包,方便传输与安装。
📦 完整提取
无需手动解压,勾选多个 PKG 加入任务队列即可 Full Extract 出全部文件;也可以只浏览部分文件而不做全量提取。
五、任务队列:自动排队,重启不丢失
PS4PKGTool 的所有耗时操作都走统一的 Tasks 队列(实现见 TaskQueueService.cs 与 PackageTaskFactory.cs):
| 任务类型 | 说明 |
|---|---|
| Full Extract | 完整提取 PKG 内容,支持多 PKG |
| Merge PKG | 基础包 + 更新包合并 |
| PKG → FFPFSC | 实验性功能,转换为 PS5 的 FFPFSC 镜像 |
| Install to shadPS4 | 安装到 shadPS4,自动保证"基础包先于更新包"执行顺序 |
队列支持自动或手动处理,任务状态会持久化(task-queue.json)——关闭程序再打开,未完成的队列依然保留。
六、进阶工作流:shadPS4 安装 + 资源管理器右键
🎮 把 PKG 装进 shadPS4 模拟器的最短路径
- 打开
Tools>shadPS4 Manager,在 Builds 页安装托管内核与启动器 - 在列表里选中基础游戏 PKG 及对应更新 PKG,选择 Install to shadPS4
- 任务队列会自动按"基础包 → 更新包"顺序安装
- 回到 shadPS4 Manager 的 Games 页启动游戏;Saves 页可创建/恢复存档备份
🖱️ 文件资源管理器右键集成
无需管理员权限:在 Program Settings > File Explorer Integration > Install Integration 一键安装后,右键 .pkg 文件即可执行:
- 多种格式重命名、复制 Title / Title ID / Content ID
- Validate PKG 校验、Extract PKG 提取、Install to shadPS4
命令路由逻辑见 ShellCommandRouter.cs。想双击单个 PKG 快速查看?把 PS4 PKG Tool 设为 .pkg 默认打开程序,即可进入独立的 Mini PKG Viewer。
七、常用设置速查表
| 设置项 | 作用 |
|---|---|
pkg_directories |
库扫描目录列表 |
scan_recursive |
是否递归扫描子目录 |
rename_custom_format |
自定义重命名格式 |
official_update_download_directory |
官方更新 PKG 的下载目录 |
theme_index / Theme |
界面主题(启动时自动恢复,见 Program.cs) |
shadps4_check |
是否显示 shadPS4 兼容状态列 |
写在最后
从"一堆看不清名字的大文件"到"分组清晰、随时合并提取、一键进 shadPS4"的有序 PKG 库,只需要拖入文件夹 + 配置任务队列这两步。🚀
下一步建议:先为每个 PKG 目录做一次完整扫描生成清单,日常使用就走 Manifest 快速启动;批量操作全部丢进 Tasks 队列,让它后台自动排队执行。
更多功能细节(奖杯查看、资源预览、官方更新下载、Excel 导出等)可查阅 README.md。