User Manual Chinese

用户与技术手册 — XGDTool (v1.4.0)

English · Italiano · Español · Français · Deutsch · Português · 简体中文

---

1. 项目概述

XGDTool（由 Ashnar2602 维护的高性能分支，基于 WiredOpposite 的原版工具）是一款专为 初代 Xbox 与 Xbox 360 游戏光盘镜像打造的统一格式转换、校验与解包工具。

官方提供三大运行平台：

• XGDTool-GUI (Windows)：具备深色主题、拖拽排队管理、非破坏性镜像校验以及 Windows 资源管理器右键菜单集成的图形界面程序。
• XGDTool-CLI (Windows)：轻量、无外部依赖的独立命令行程序，适用于终端批处理与自动化脚本。
• XGDTool-Android (Android 8.0+)：采用 Material 3 深色界面的原生移动应用，搭载 Zero-Copy 存储引擎与前台后台转换服务，支持 7 种语言。

---

2. Windows 图形界面指南 (XGDTool-GUI)

2.1 任务队列与拖拽操作

1. 启动 XGDTool-GUI.exe。
2. 将任意 .iso、.xiso、.cso、.cci、.zar 文件或游戏文件夹拖入窗口。
3. 也可通过界面上的 添加文件 或 添加文件夹 按钮手动选取。
4. 队列中将显示每个任务的路径、容量与当前状态。

2.2 目标格式选择

• XISO：标准 Xbox / Xbox 360 净化光盘镜像，适合光盘刻录或模拟器。
• GoD (Games on Demand)：Xbox 360 专用的免盘数据包格式（00007000），适用于 RGH / JTAG 破解主机直接通过硬盘运行。
• ZAR (ZArchive)：多线程并发 Zstandard 压缩格式，适合 Xenia Canary 模拟器与长期归档。
• CSO：基于 LZ4 的分块压缩光盘镜像。
• CCI：专为初代 Xbox 模拟器优化的 LZ4 分块压缩格式。
• 提取文件夹：直接提取 ISO 镜像内部的所有文件与目录。

2.3 镜像诊断与完整性校验 (Verify Image)

• 单击 Verify Image（校验镜像） 按钮即可对选定镜像执行只读诊断分析。
• 自动检测光盘几何属性（XGD2 / XGD3、换层点 Layerbreak）、AVL 文件系统结构、Title ID、Media ID、游戏标题，并在内存中并发计算 CRC32、MD5 与 SHA-1 校验码。

2.4 参数设置与偏好项

• 智能重命名 ([<TitleID>] <GameName>)：转换时自动按照 Xbox 标准命名规则生成文件或文件夹名称。
• 生成 .dvd 文件：自动生成包含换层点（如 XGD2 的 1913760，XGD3 的 2133520）的刻录引导文件。
• 完全擦除填充 (Full Scrubbing)：在内存缓冲区中直接将未使用的数据扇区置零，避免多余的物理磁盘寻道。
• 校验码计算：在数据写入磁盘的过程中利用流水线同时完成哈希计算，无后续磁盘回读开销（0 秒耗时）。
• Windows 右键菜单集成：点击 注册右键菜单 即可将 XGDTool 添加到 Windows 资源管理器的右键快捷操作中。

---

3. 命令行工具使用指南 (XGDTool-CLI)

3.1 命令语法

XGDTool-CLI.exe [选项] <输入路径> [输出路径]

3.2 参数选项列表

参数	参数值	说明
--xiso	无	转换为 ISO / XISO 镜像格式
--god	无	转换为 Games on Demand (GoD) 容器包
--zar	无	转换为 ZArchive (Zstandard) 压缩格式
--cso	无	转换为 CSO (LZ4) 格式
--cci	无	转换为 CCI (LZ4) 格式
--extract	无	将光盘镜像内部文件直接提取至文件夹
--verify	无	执行非破坏性镜像完整性诊断与头部校验
--smart-rename	无	自动重命名为 [<TitleID>] <GameName> 格式
--threads	<数值>	并行压缩的工作线程数（默认：CPU 逻辑核心数）
--level	<1-6>	ZAR 归档的 Zstandard 压缩等级（默认：2）
--dvd	无	生成包含换层点的 .dvd 引导文件
--full-scrub	无	清理所有填充扇区并置零
--checksum	无	写入时同步计算 CRC32、MD5 与 SHA-1 哈希值
--register-shell	无	在 Windows 资源管理器中注册右键关联菜单
--unregister-shell	无	注销右键关联菜单
-h, --help	无	显示帮助信息并退出

3.3 常用命令示例

1. 对光盘镜像进行非破坏性诊断分析：

   XGDTool-CLI.exe --verify "D:\Games\Halo_Reach.iso"

2. 将 ISO 转换为 Xbox 360 RGH 专用的 GoD 格式：

   XGDTool-CLI.exe --god "D:\Games\Halo_Reach.iso" "E:\Content\0000000000000000"

3. 转换为 ZAR 压缩包并自动重命名：

   XGDTool-CLI.exe --zar --level 3 --smart-rename "D:\Games\Gears_of_War.iso" "D:\Emulators\Xenia"

4. 注册 Windows 资源管理器右键快捷菜单：

   XGDTool-CLI.exe --register-shell

---

4. Android 移动端说明 (XGDTool-Android)

• Zero-Copy 直读直写存储架构：通过 MANAGE_EXTERNAL_STORAGE 权限直接读写真实存储路径，免除 15–20 GB 的内部缓存重复写入。
• ARMv8 硬件指令级 CRC32：使用原生 __crc32d 汇编指令，在现代 ARM64 手机上实现 15–20 GB/s 的超高哈希计算速度。
• 前台系统服务：转换任务在带有常驻通知的前台服务中运行，即使手机锁屏或切换后台也不会被系统意外终止。
• 保持屏幕常亮选项：可在批量处理时防止设备进入深度休眠。

---

5. 格式与模拟器兼容性参考

格式	文件扩展名	推荐模拟器或硬件	说明
ISO / XISO	.iso	初代 Xbox、Xbox 360 原机、Xemu、Xenia	无压缩光盘镜像
GoD	00007000	Xbox 360 RGH/JTAG、Aurora、FreestyleDash	免盘启动数据包
ZAR	.zar	Xenia Canary、Cemu	高压缩率 Zstd 归档（读取速度约 2 GB/s）
CSO	.cso	Xbox 模拟器、Xemu	快速 LZ4 分块压缩镜像
CCI	.cci	初代 Xbox 模拟器	专有 LZ4 块分配格式
Extract	文件夹	Aurora、FreestyleDash、初代 Xbox 仪表盘	散装游戏文件

---

6. 常见问题解答

• 校验计算是否增加转换耗时？：增加耗时为 0.0 秒。所有哈希运算均在数据写入磁盘的同时于内存流水线中并行完成。
• 为什么右键菜单没有显示？：请以终端运行一次 XGDTool-CLI.exe --register-shell，或在图形界面设置中点击“注册右键菜单”。