[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-105419":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":16,"stars30d":16,"stars90d":15,"forks30d":15,"starsTrendScore":17,"compositeScore":18,"rankGlobal":9,"rankLanguage":9,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":9,"pushedAt":9,"updatedAt":24,"readmeContent":25,"aiSummary":9,"trendingCount":15,"starSnapshotCount":15,"syncStatus":16,"lastSyncTime":26,"discoverSource":27},105419,"dump-tool","tcmmm\u002Fdump-tool","tcmmm","il2cpp Dump 翻译工作台 - Unity il2cpp 游戏逆向辅助工具",null,"Python",63,21,61,1,0,2,6,45.17,"MIT License",false,"main",true,[],"2026-11-01 00:16:22","# dump工具 · il2cpp Dump 翻译工作台\n\n> 一款用于**浏览 \u002F 中文翻译 \u002F 搜索** Il2CppDumper 生成的 `dump.cs` 的桌面软件，\n> 并集成 Hook 代码生成、Frida 调试、GG 脚本、IDA 命名脚本、ADB 手机调试与 MCP 接入能力。\n> 让 Unity il2cpp 游戏的逆向分析、安全研究与自有游戏调试从\"对着天书查地址\"变成\"点一下就出模板\"。\n\n---\n\n## ✨ 功能特性\n\n### 浏览与翻译\n- **加载 dump.cs**：支持拖拽打开，55MB 大文件首开约 10 秒，二次打开走 `.dcache` 缓存秒开\n- **中文翻译**：类 \u002F 方法 \u002F 字段逐词翻译，附带 Unity 生命周期、基类角色等大白话解释\n- **结构树**：`分组 → DLL → 用途分类 → 类` 四层可折叠浏览\n- **用途分类**：19 类自动归类（界面UI \u002F 战斗技能 \u002F 角色移动 \u002F 背包物品 \u002F 网络通信…）\n- **类详情**：中文释义 + 用途 + 基类角色 + 字段（含内存偏移）+ 属性 + 方法（含 RVA 地址）\n\n### 搜索与定位\n- **全局搜索**：同时搜类名 \u002F 方法名 \u002F 中文 \u002F 分类名（`Ctrl + K` 快速聚焦）\n- **地址反查**：输入 `0xABC1234` 这类地址 → 自动定位到 类.方法 并跳转高亮（GG\u002FFrida\u002F崩溃日志地址都能反查）\n- **基类跳转**：详情页显示继承链面包屑，每级可点击直达；自定义类型字段也是链接\n- **字符串搜索**：配合 `stringliteral.json` 搜索游戏全部文本，命中给出 metadata 偏移\n\n### 代码生成（核心生产力）\n- **Hook 代码生成**：四标签切换 —— 精简模板 \u002F 完整示例（双平台可编译）\u002F Frida JS（免编译调试）\u002F 按名解析（游戏更新免改码），一键复制\n- **Frida 批量追踪**：整类或全部收藏方法生成一个追踪脚本，运行时打印调用、参数解码、返回值（ARM64 寄存器自动映射，il2cpp 字符串自动解码）\n- **Hook 工程脚手架**：生成完整 Android NDK\u002FCMake 工程 zip（`hook_main.cpp` + `offsets.h` + `il2cpp_api.h` + `CMakeLists.txt` + `build.sh` + README），解压、克隆 Dobby、`bash build.sh` 三步出 so\n- **GG 脚本生成**：一键生成 GameGuardian Lua 读写骨架，弹窗预览 + 复制 + 导出 `.lua`\n- **GG 通用探测器**：生成不绑定类的通用 lua，手机上任意地址粘进去即读出对象类名、基址换算 RVA、对象头部 hexdump\n- **IDA 命名脚本**：导出单类 \u002F 全部收藏，在 IDA 里跑脚本自动重命名函数 + 加中文注释\n\n### 跨版本维护\n- **版本对比**：选新版 dump.cs，自动输出新增\u002F删除类与方法、RVA 漂移、收藏项受影响清单，可导出全量 md 报告\n- **Hook 迁移**：版本对比后，粘贴老 hook 代码 → RVA 一键重写成新版地址（只改能对应到旧 dump 方法表的 0x 常量，掩码\u002F魔数等无关常量原样保留）\n- **收藏**：类\u002F方法点 ☆ 收藏，跨会话保存，在版本对比中优先标注变化\n\n### 设备调试\n- **ADB 手机调试**：工具栏 ADB 直接连接手机（USB\u002FWiFi）—— 从已装游戏一键提取 il2cpp 材料、扫描 Unity 游戏、推送脚本、Frida 调试、logcat、shell 终端\n- **Frida 内嵌运行**：Hook 弹窗「ADB 调试运行」一键把 Frida 版脚本丢到手机上跑（自动 spawn\u002Fattach，运行日志实时打印在弹窗内嵌日志区，可随时停止\u002F清空）\n\n### MCP 接入（让 AI 助手直接操作）\n- 提供 30 个 MCP 工具，WorkBuddy \u002F Claude 等 AI 助手可直接查询 dump、生成 Hook、操作手机\n- 详见 [使用说明.md](使用说明.md) 第七节\n\n---\n\n## 🚀 快速开始\n\n提供三种使用方式，按需选择：\n\n| 方式 | 适合人群 | 说明 |\n|------|---------|------|\n| **下载 exe** | 普通用户 | 从 [Releases](..\u002F..\u002Freleases) 下载 `dump工具.exe`（GUI）和\u002F或 `dump工具-mcp.exe`（MCP 服务），双击即可运行，无需 Python |\n| **源码运行** | 开发者 \u002F 贡献者 | 克隆本仓库，用本机 Python 环境运行（见下方） |\n| **自行打包** | 需要定制构建 | 用 PyInstaller 自行打包成 exe（见\"构建\"一节） |\n\n### 源码运行\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Ftcmmm\u002Fdump-tool.git\ncd dump-tool\n\n# 依赖（按需安装，核心 GUI 只需以下库）\npip install PySide6   # 或 PySide2 \u002F PyQt5\u002F6，任选其一\n\n# 启动\npython dump_gui.py\n# 或双击 启动工具.bat\n```\n\n### frida-server（使用 Frida 相关功能时需要）\n\n本仓库**不含** frida-server 二进制（体积较大）。如需使用 Frida 调试 \u002F 批量追踪功能：\n\n1. 前往 [frida releases](https:\u002F\u002Fgithub.com\u002Ffrida\u002Ffrida\u002Freleases) 下载对应版本（认准 `android-arm64` 或你设备的架构）\n2. 重命名为 `frida-server-\u003Cversion>-arm64` 放到本程序目录，或自行通过 ADB 推送到手机\n3. 详见 [手游Hook详细教程.md](手游Hook详细教程.md) 6.2 节\n\n---\n\n## 🛠 构建（自行打包 exe）\n\n使用 PyInstaller 打包，配置文件见 `dump工具.spec`（GUI 版）和 `dump工具-mcp.spec`（MCP 版）：\n\n```bash\npip install pyinstaller\npyinstaller dump工具.spec          # 产出 dist\u002Fdump工具.exe\npyinstaller dump工具-mcp.spec      # 产出 dist\u002Fdump工具-mcp.exe\n```\n\n> 注：`dump_gui.py` 体积较大（单文件集成全部 GUI 逻辑），首次打包耗时属正常现象。\n\n---\n\n## 📁 项目结构\n\n```\ndump-tool\u002F\n├── dump_gui.py                 # GUI 主程序（核心，集成全部界面逻辑）\n├── adb_kit.py                  # ADB 连接 \u002F 设备操作工具集\n├── mcp_entry.py                # MCP 服务入口\n├── frontend\u002F                    # 内嵌 Web 前端资源（ADB 调试面板等）\n├── 启动工具.bat                 # Windows 源码运行启动脚本\n├── dump工具.spec                # PyInstaller GUI 打包配置\n├── dump工具-mcp.spec            # PyInstaller MCP 打包配置\n├── example_hook_pause_get_base.c # Hook 示例代码（含基址获取完整实现）\n├── adb_config.example.json      # ADB 配置示例模板（复制为 _adb_config.json 使用）\n├── 使用说明.md                  # 完整功能使用说明（22 项功能详解）\n├── 手游Hook详细教程.md          # 从 dump.cs 到 hook 跑起来的完整教程\n├── README.md\n├── LICENSE\n├── CONTRIBUTING.md\n└── .gitignore\n```\n\n---\n\n## 🤝 贡献\n\n欢迎提交 Pull Request！无论是修 bug、加功能、改翻译、补文档都欢迎。\n\n- 贡献流程与规范见 [CONTRIBUTING.md](CONTRIBUTING.md)\n- 新功能请先开 Issue 讨论设计方向，避免重复劳动\n\n---\n\n## 📜 许可证\n\n本项目基于 [MIT License](LICENSE) 开源，可自由使用、修改、分发。\n\n---\n\n## ⚖️ 合规与免责声明\n\n本工具面向 **il2cpp \u002F Unity 运行机制学习、自有游戏调试、单机游戏安全研究**。\n\n- 修改**联网竞技游戏**可能违反游戏用户协议，轻则封号，重则触及法律红线（破坏计算机信息系统）\n- 商业级反外挂系统（如 TP\u002FACE 等）不在本工具对抗范围，也不应被用于对抗\n- 传播外挂、代做外挂在国内有明确入罪案例，请勿触碰\n- 作者不对工具被用于任何违规用途承担责任，使用者需自行承担相应后果\n\n详见 [手游Hook详细教程.md](手游Hook详细教程.md) 第十节\"合规与边界\"。\n","2026-10-31 04:26:44","CREATED_QUERY"]