SaveEditors/xecli

# XeCLI [](https://github.com/SaveEditors/xecli) [](https://www.gnu.org/licenses/gpl-3.0) [](https://dotnet.microsoft.com/) [](https://github.com/SaveEditors/xecli) XeCLI 是一个为 Xbox 360 RGH/JTAG 主机实时操作设计的终端优先工具套件。它将 XBDM、JRPC2、FTP、XEX 工具、内存检查、模块控制、截图、Ghidra 无头自动化以及 Games on Demand 转换功能整合到一个 CLI 和一个发布包中。 仓库名称和产品名称均为 `XeCLI`。安装后的终端命令为 `rgh`。 由 [Pew7s](https://www.se7ensins.com/members/pepe-le-pew.527865/) 创建。

Support our work? Buy us a coffee!

## 文档 - [Wiki 首页](wiki/Home.md) - [命令参考](wiki/Commands.md) - [CLI 帮助输出](wiki/CLI-Help.md) - [新手指南](wiki/Beginner-Guide.md) - [硬件与系统控制](wiki/Hardware-and-System.md) - [XNotify](wiki/XNotify.md) - [Avatar 物品集](wiki/Avatar-Item-Collection.md) - [进阶指南](wiki/Advanced-Guide.md) - [已发布的文档站点](https://saveeditors.github.io/xecli/wiki/Home.html) ## 发布更新日志 ### v1.0.1 Avatar 更新 - 通过 `rgh avatar games`、`rgh avatar items`、`rgh avatar choose`、`rgh avatar browse`、`rgh avatar install` 和 `rgh avatar apply` 增加了对托管和本地 `Avatar-Item-Collection` 的支持。 - 增加了终端和 Windows 选择器流程用于 Avatar 物品选择，支持当前用户所有权补丁、缓存下载和多物品进度条。 - 增加了硬件和会话控制，包括登录状态、LED 预设、风扇命令、光驱托盘控制、关机、原生弹出消息以及感知标题的伪造助手。 - 扩展了 Wiki，增加了 [硬件与系统控制](wiki/Hardware-and-System.md)、[XNotify](wiki/XNotify.md) 和 [Avatar 物品集](wiki/Avatar-Item-Collection.md)，并优化了公开文档的措辞。 - 将 `rgh install` 重构为真正的安装程序流程，支持安装路径选择、PATH 注册、更清晰的首次设置以及安装后的主机发现提示。 - 修复了当前用户的命令注册问题，使基于 PATH 的安装直接解析到 `rgh.exe`，而不再依赖脆弱的包装器优先路径。 - 在仓库根目录增加了 `xbdm.xex`、`XDRPC.xex` 和 `JRPC2.xex` 的直接副本，并在新手指南中链接它们以供单独下载/使用。 ### v1.0.0 初始发布 - 发布了第一个公开的 XeCLI 版本，包含 `rgh` 命令、XBDM 发现、主机状态、模块检查、内存检查、线程控制和调试助手。 - 增加了 JRPC2 助手，用于 Title ID、温度、通知、CPU Key、主板和仪表板查询，以及基于 FTP 的文件、存档、内容和插件工作流。 - 增加了 XEX 转储、字符串提取、Ghidra 无头集成、ISO 到 GOD 转换，以及发布包中捆绑的 Title ID 数据库。 - 发布了初始 Wiki 集，包括 [首页](wiki/Home.md)、[命令参考](wiki/Commands.md)、[CLI 帮助输出](wiki/CLI-Help.md)、[新手指南](wiki/Beginner-Guide.md)、[进阶指南](wiki/Advanced-Guide.md) 和 [故障排除](wiki/Troubleshooting.md)。 ## 界面预览 顶级帮助：  实时状态：  ## 为什么选择 XeCLI XeCLI 专为三类工作设计： - 日常主机工作流：发现、连接管理、状态、FTP、插件控制和游戏启动。 - 逆向工程工作流：模块列表、内存读写、线程上下文、断点、XEX 转储、字符串和 Ghidra 导出。 - 工具集成工作流：JSON 输出、捆绑的元数据，以及来自脚本或配套应用的基于命令的稳定编排。 它旨在用一致的命令界面取代分散的一次性主机实用程序，该界面既可交互使用，也可编写脚本。 ## 包含内容 仓库和发布包包括： - CLI 源代码和托管项目依赖项。 - XeCLI 工作流中使用的通用主机端 `.xex` 依赖文件。 - 捆绑的 Title ID 数据库。 - Avatar 物品浏览和安装工作流，支持本地 `Avatar-Item-Collection` 语料库或 GitHub 托管的集合，带有缓存下载和进度条。 - Ghidra 辅助脚本。 - Wiki 文档和面向发布的 README 内容。 捆绑资产： - `xbdm.xex` - `XDRPC.xex` - `JRPC2.xex` - `src/Xbox360.Remote.Cli/ConsoleDependencies/xbdm.xex` - `src/Xbox360.Remote.Cli/ConsoleDependencies/XDRPC.xex` - `src/Xbox360.Remote.Cli/ConsoleDependencies/JRPC2.xex` - `src/Xbox360.Remote.Cli/Assets/xbox360_gamelist.csv` - `src/Xbox360.Remote.Cli/Assets/xbox360_titleids.txt` - `src/Xbox360.Remote.Cli/ghidra_scripts/DecompileAllToC.java` 在发布时，这些资产会被复制到发布输出中，以便包保持自包含。托管的 Avatar 语料库本身独立存在于 [SaveEditors/Avatar-Item-Collection](https://github.com/SaveEditors/Avatar-Item-Collection)。 ## 主机必须提供的条件 XeCLI 在仓库和发布包中附带了预期的主机端插件负载，以便用户可以部署该工具构建和测试时所用的确切版本： - `xbdm.xex` - `JRPC2.xex` - `XDRPC.xex` 目标主机仍需启用这些服务才能使用相关功能： - XBDM 用于主机控制、模块枚举、内存访问、线程、断点、截图和文件系统命令。 - JRPC2 用于 CPU Key、温度、Title ID、仪表板版本、主板类型、通知、登录助手、LED 控制和通用 RPC。 - FTP 服务用于基于 FTP 的文件浏览、存档管理、内容管理和 DashLaunch 插件编辑。 ## 功能摘要 核心主机工作流： - 主机发现和保存的默认目标定位。 - 快速 `status`、`ping`、`profiles` 和 `title` 查询。 - 登录状态检查，输出 Gamertag 和 XUID。 - 光圈 LED 控制，显示缓存状态。 - 手动风扇命令分发和可选的 SMC 版本探测。 - 启动和重启控制，带有可选的主机端成功通知。 实时检查和调试： - 模块列表、信息、转储、加载、卸载和待定验证。 - 内存转储、十六进制转储、peek、poke、监视、字符串和模式搜索，可选冻结写入。 - 线程列表、上下文、挂起和恢复。 - 调试停止/运行、代码断点、数据断点和实时调试事件监视。 文件和内容工作流： - XBDM 文件系统访问和 FTP 访问。 - 存档列表、提取和注入。 - 已安装内容清单和删除。 - DashLaunch 插件列表和槽位管理。 XEX 和分析工作流： - 转储活动的 XEX。 - 从本地文件、FTP 或运行中的标题提取 XEX 字符串。 - 运行 Ghidra 无头分析并反编译导出函数。 - 验证反编译输出中是否存在错误指令占位符。 打包和自动化： - ISO 到 Games on Demand 转换。 - 文件夹监视器，用于无人值守的 ISO 处理。 - 适合自动化的命令输出 JSON。 - 基于命令的 Avatar 浏览、远程托管下载和主机端 Avatar 物品安装。 - 捆绑的 Title ID 数据库，其他工具可直接使用。 ## Avatar 物品集 XeCLI 现在在同一安装管道之上暴露了两条面向用户的 Avatar 选择路径： - `rgh avatar choose` 用于终端优先的游戏和物品选择器 - `rgh avatar browse` 用于 Windows 选择器，支持标题搜索、物品过滤和多选 两者都接入 `rgh avatar install` 所使用的相同所有权补丁和安装流程。 该流程同样适用于： - 本地 `Avatar-Item-Collection` 语料库 - GitHub 托管的集合，带有本地缓存和验证下载 远程浏览示例： ``` rgh avatar library show rgh avatar games --remote --search "Black Ops" rgh avatar items --remote --titleid 415608C3 --limit 10 rgh avatar choose --remote --search "Black Ops" --current-user rgh avatar browse --remote rgh avatar install --remote --titleid 415608C3 --all --current-user ``` 多物品安装会显示进度条和每个物品的传输状态，因此大型游戏包在下载和上传过程中保持可见。托管语料库位于 [SaveEditors/Avatar-Item-Collection](https://github.com/SaveEditors/Avatar-Item-Collection)。 ## 安装 ### 发布包 下载发布归档文件，解压缩，然后运行 `rgh.exe`。 发布内容： - `rgh.exe` - 捆绑在 `rgh.exe` 旁的原生 .NET 运行时文件 - `ConsoleDependencies/` - `Assets/` - `ghidra_scripts/` 发布包是针对 `win-x64` 的自包含程序。它不需要在目标 PC 上单独安装 .NET 运行时。 对于首次安装，在解压后的发布文件夹中打开终端并运行： ``` .\rgh.exe install ``` 安装程序现在将引导您完成： - 安装范围：当前用户或所有用户 - 安装目录选择 - 新终端的可选 PATH 注册 - 设置后的静默主机发现扫描 如果在安装后发现主机，XeCLI 可以立即询问是否连接，然后在检测到的目标上运行 `rgh status`。 安装完成后，打开一个新的终端并正常使用 `rgh`。 手动安装命令： ``` .\rgh.exe install rgh install rgh install --path C:\Tools\XeCLI rgh install --machine ``` ### 从源代码构建 ``` git clone https://github.com/SaveEditors/xecli cd XeCLI dotnet build -c Release dotnet run --project src/Xbox360.Remote.Cli -- --help ``` 源代码构建需要 .NET 10 SDK/运行时。此要求不适用于发布的 `win-x64` 发布归档。 ## 快速入门 推荐的首次运行： ``` .\rgh.exe install ``` 设置完成后，XeCLI 可以静默发现主机并提供立即连接。如果您跳过该提示，请使用下面的手动发现路径。 手动发现和选择： ``` rgh start ``` 如果您已经知道目标地址： ``` rgh target --set rgh ftp target --set --user --pass ``` 检查主机： ``` rgh ping rgh status rgh status --quick rgh title ``` 检查实时状态： ``` rgh modules list rgh modules info --name Aurora.xex rgh mem hexdump --addr 0x30000000 --size 0x40 rgh screenshot --out .\screen.bmp ``` 操作存档、内容和插件： ``` rgh save list --titleid FFFE07D1 --device Hdd1 rgh content list --device Hdd1 --show-types rgh plugin list ``` 运行分析工作流： ``` rgh xex dump --out .\title.xex rgh xex strings --running --unicode --min 6 rgh ghidra decompile --running --out .\decomp ``` ## 活动标题解析 不带参数的 `rgh title` 从已连接的主机解析当前活动的标题。 示例： ``` rgh title rgh title --json rgh title 415608C3 rgh title 415608C3 2B7302D6 ``` 当运行的 XEX 是仪表板替代品或自制软件外壳时，XeCLI 可以优先使用基于路径的回退名称（例如 `Aurora`），同时单独显示捆绑的数据库条目。 ## 模块加载与卸载 支持实时模块卸载，并针对实时模块列表进行了验证。模块加载更为微妙：某些插件栈和模块并非在每台主机上都能安全热加载。 支持的命令： ``` rgh modules load --path Hdd:\HvP2.xex rgh modules unload --name HvP2.xex --force rgh modules pending ``` 对于加载过程中会触发重启或断开连接的模块，请使用： ``` rgh modules load --path Hdd:\HvP2.xex --system --reboot-expected ``` 然后，在主机返回后： ``` rgh modules pending ``` 该流程会在 XeCLI 配置中保留待定验证，并在重启后确认最终的模块状态。 ## 捆绑的 Title ID 数据库 XeCLI 在仓库和发布的版本中包含其 Title ID 数据。它不会在运行时从互联网获取标题元数据。 主要文件： - `src/Xbox360.Remote.Cli/Assets/xbox360_gamelist.csv` - `src/Xbox360.Remote.Cli/Assets/xbox360_titleids.txt` 可选的本地扩展文件： - `%APPDATA%\XeCLI\titleids.local.csv` 捆绑的数据不仅对 CLI 本身有用。其他工具可以复用它来： - 将 Title ID 解析为可读名称。 - 匹配特定媒体变体。 - 标记存档、转储、截图和报告。 - 丰富启动器、仪表板、修改器和存档编辑器的内容。 ## 配置 主配置文件： - `%APPDATA%\XeCLI\config.json` 缓存目录： - `%LOCALAPPDATA%\XeCLI\cache` 配置存储如下项目： - 默认 XBDM 目标。 - 默认 FTP 目标和凭据。 - 通知图标预设。 - Ghidra 路径配置。 - 需要重启后验证的待定模块操作。 ## 发布布局 源代码仓库旨在保持整洁： - 源代码位于 `src/` 下 - 文档位于 `README.md` 和 `wiki/` 下 - 不提交运行时转储或捕获到仓库 - 发布文档中不包含特定于机器的路径 发布工件应在仓库根目录之外构建，以便发布输出、转储、截图和冒烟测试文件不会污染源代码树。 ## 文档地图 从这里开始： - `wiki/Home.md` - `wiki/ner-Guide.md` - `wiki/Commands.md` 深入参考： - `wiki/Advanced-Guide.md` - `wiki/Frameworks.md` - `wiki/Title-ID-Database.md` - `wiki/Integrations.md` - `wiki/Troubleshooting.md` - `wiki/FAQ.md` ## 安全说明 XeCLI 既包含安全的操作命令，也包含可能使正在运行的标题或主机会话不稳定的命令。 请谨慎对待以下领域： - `mem poke` - `mem search --freeze` - `debug break` 和 `debug databreak` - `modules unload --force` - `modules load --system` - `reboot` - 内容和存档删除命令 如果某个命令预期会触发重启或断开连接，XeCLI 应明确说明。在适当的情况下使用待定验证流程，而不是假设操作已完全清除。 ## 许可证 GPLv3

标签：FTP客户端, Games on Demand, Ghidra集成, HTTP工具, JRPC2, JTAG, RGH, XBDM, Xbox 360, XEX转储, 主机破解, 云资产清单, 内存检查, 存档修改, 开发工具包, 截图, 模块控制, 游戏作弊, 游戏黑客, 逆向工程