内核级洞察。
AI 级生产力。

1. 点击上方“下载完整使用包”，下载 MemScanner-Complete.zip 后完整解压。
2. 确认包含 MemScanner.apk、MemScanner.kpm、MCP 压缩包与 使用说明.html 四个文件。
3. 将 APK 与 KPM 传到手机；MCP 压缩包需在 Windows x64 电脑上单独解压，不要只复制其中的 exe。
4. 用浏览器打开 使用说明.html。仅在手机端使用时，可跳过 MCP 相关步骤。

MemScanner.kpm 即旧版教程中的 Kernel_Hack.kpm，直接加载即可，无需改名。

支持的 KPM 加载方案

• APatch：使用 APatch 支持的内核，并确认 KPM 功能可用。
• SukiSU / SukiSU Ultra：使用支持 KPM 的内核及配套管理器。已验证组合：小米 · Android 16 · SukiSU，其他机型以实际加载结果为准。
• Magisk / KernelSU + KPatch-Next：需安装 KPatch-Next 模块后才能加载 .kpm；仅安装 Magisk 无法加载。

适配 95% 的 Root 机型。加载前请先确认管理器中的 KPM 功能可用。

1. 加载 KPM：把 MemScanner.kpm 放到手机，在 KPM/KPModule 管理入口选择加载，确认加载成功。它不是 Magisk 模块，不能按 ZIP 刷入。
2. 安装 APK：允许可信安装来源后安装 MemScanner.apk，打开并注册/登录。安装后可收回安装来源权限。
3. 授予权限：授予悬浮窗权限并启动悬浮球；首次绑定进程时，在 Root 管理器中授权 MemScanner。建议允许其后台运行与自启动，并关闭电池优化。
4. 只读验证：选择测试应用进程 → 设置数据类型与内存区域 → 搜索已知数值 → 在应用中改变该数值 → 再次筛选 → 回读确认。
5. 开始调试：确认目标地址后，再使用断点、调用栈、反汇编或 Trace。修改前记录原值，写入后回读，调试结束后恢复原值。

手机重启后，请重新确认模块已加载、账号已登录且后台在线。目标进程重启后 PID 与内存地址会变化，需重新搜索定位。

1. 在电脑上完整解压 MCP 压缩包，确保 memscanner-mcp.exe 与 _internal 文件夹位于同一目录。MCP 为 Windows x64 程序，无需安装 Python。
2. 修改前先备份 AI 客户端的配置文件，保留原有模型与其他 MCP 配置。OpenCode 全局配置通常位于 %USERPROFILE%\.config\opencode\opencode.json，也可能是 .jsonc 或项目级配置。
3. 将 command 设为 exe 的实际路径；如已有 memscanner 条目，直接替换，不要重复添加。OpenCode 使用数组形式的 command 与 environment 字段，Claude Desktop 使用 mcpServers 与 env 字段。
4. 在手机上生成新配对码，填入 MEMSCANNER_PAIR_CODE 并保存。首次配对时只启动一个 MCP 实例。
5. 完全退出并重启 AI 客户端，确认 memscanner 工具已加载，再让 AI 读取当前状态进行验证。首次连接时不要直接写入内存。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "memscanner": {
      "type": "local",
      "command": ["C:\\Tools\\MemScanner\\MCP\\memscanner-mcp\\memscanner-mcp.exe"],
      "environment": {"MEMSCANNER_PAIR_CODE": "PAIR_CODE"},
      "enabled": true,
      "timeout": 700000
    }
  }
}

以上为最小可用示例，已有配置时只需合并 memscanner 条目。新版 OpenCode（mcp.servers 格式）与 Claude Desktop 的配置见完整版说明，两种格式的字段不可混用。

凭据默认保存在 %USERPROFILE%\.memscanner-mcp\credentials.json；如设置了 MEMSCANNER_CREDENTIALS，则以该路径为准。请勿分享或上传凭据文件。

首次验证指令

请使用 MemScanner 读取当前工作台状态，确认手机在线。不执行搜索、写入、断点、Trace 或 Shell；失败时给出原始错误。

手机与电脑无需处于同一局域网，但均需联网。多台设备在线时需指定目标设备。耗时较长的任务受 AI 客户端超时设置影响，等待期间请勿重复发起。

• Failed to get tools：表示 AI 客户端未能获取工具列表，不一定是配对码错误。请查看 MCP 日志（stderr），区分配对、登录、服务端与网络问题。
• 配对码无效或过期：生成后请尽快使用，并确保没有旧配置或其他实例占用。若立即使用仍被拒绝，请记录错误信息与时间并联系维护者，不要公开配对码。
• 新配对码仍提示登录失效：MCP 可能仍在使用旧凭据。关闭所有 MCP 实例，备份并移除 credentials.json（注意自定义路径），再生成新配对码。
• 缺少 DLL / 无法运行：确认系统为 Windows x64、已完整解压且 _internal 目录完整，不要在压缩包内直接运行。
• 设备离线：检查手机的登录状态、网络与后台运行。MCP 能启动不代表手机在线。
• 更新与卸载：先停止任务、清除断点并停止 Trace，再替换模块或 MCP 目录；更新后用只读操作验证。

反馈问题时，请提供机型、系统与内核版本、管理器版本、操作步骤和原始错误信息。提交前请隐去邮箱、配对码、令牌等敏感信息，不要上传完整的 AI 配置文件。