inspector

注入到任意 64 位 Windows 进程的通用运行时调试工具。DLL 在目标进程内启动一个 TCP 服务（绑定 0.0.0.0:37651，同机或远端均可连），通过一个 tab-separated line 协议对外暴露 Cheat Engine 风格的调试能力；MCP 桥则把这些能力转成 50 个 Claude tools。

---

1. 概述

设计原则：

• 零项目耦合：DLL / MCP 都不依赖任何特定游戏结构。
• 有状态：扫描会话、snapshot、watcher、structure 定义在 DLL 里常驻，MCP 调用不会在中途重建。
• 协议极简：每次请求一行 tab 分隔的文本，响应一个 JSON envelope {ok, command, text}。

---

2. 目录结构

inspector/
├── README.md                      # 本文
├── dll/
│   ├── CMakeLists.txt
│   ├── toolchain-mingw-w64.cmake
│   ├── include/inspector/
│   │   ├── types.hpp              # u8..f64 基础类型
│   │   ├── formatting.hpp         # 解析 / hex / JSON 小工具
│   │   ├── memory_view.hpp        # SEH 保护的本地内存读
│   │   ├── service_util.hpp       # 区域枚举 / PE 解析
│   │   ├── service.hpp            # Service 公共 API
│   │   └── server.hpp
│   ├── src/
│   │   ├── dllmain.cpp / server.cpp
│   │   ├── service.cpp            # 分发 + watcher 线程
│   │   ├── service_memory.cpp     # 内存读写 / patch / hexview / pointer_chain
│   │   ├── service_scan.cpp       # 所有 scan_* / find_code_refs / pointer_path
│   │   ├── service_snapshot.cpp   # snapshot_*
│   │   ├── service_watch.cpp      # watch_* + event 队列
│   │   ├── service_dissect.cpp    # dissect / compare / compare_many / infer
│   │   ├── service_struct.cpp     # CE structure 会话
│   │   ├── service_module.cpp     # modules / module_info / resolve_symbol
│   │   ├── service_disasm.cpp     # Zydis 反汇编
│   │   └── service_thread.cpp     # thread_list / thread_context
│   └── thirdparty/zydis/
└── mcp/
    └── server.py

---

3. 编译

依赖：MinGW-w64（brew install mingw-w64）+ CMake ≥ 3.24。

cd inspector/dll
mkdir build && cd build
cmake -DCMAKE_TOOLCHAIN_FILE=../toolchain-mingw-w64.cmake -DCMAKE_BUILD_TYPE=Release ..
cmake --build . --parallel
# 产物: build/inspector.dll  (约 15 MB，静态链接 Zydis/Zycore/libstdc++)

在 Windows 本地直接用 MSVC 也可以；CMakeLists 在 MSVC 下会启用 /W4 /permissive- /utf-8。

---

4. 注入与启动

1. 把 inspector.dll 注入目标进程（手动注入器 / DLL injector / LoadLibrary 均可）。

2. DllMain → DLL_PROCESS_ATTACH 会：

   • 调 AllocConsole() 拉一个控制台窗口用于日志；
   • 绑定 0.0.0.0:37651 + 启动 accept 线程；
   • 启动 20 Hz 的 watcher 轮询线程。

3. 控制台里看到：

   inspector (generic memory / CE-style debug)
   pid         = ...
   host module = 0x00007FF7...
   wire port   = 0.0.0.0:37651
   [inspector] server started