从下载，到你的第一条 AI 调试指令。

01 / 下载压缩包，从这里开始

1. 在 MemScanner 下载页点击“下载完整使用包”，等待浏览器完成 MemScanner-Complete.zip 的下载。手机和电脑看到的是同一个下载文件。
2. 如果下载失败或文件大小明显异常，请重新下载。不要把未完成的 .crdownload、.part 文件改名当作安装包使用。
3. 在电脑上右键压缩包，选择“全部解压缩”；手机上使用系统文件管理器或可信解压工具，先解压到一个独立文件夹。不要在压缩包预览窗口中直接运行程序。
4. 解压后确认恰好包含下列四个文件。先打开本说明，再按顺序操作。

MemScanner.apk
MemScanner.kpm
memscanner-mcp-windows-x64-prototype.zip
使用说明.html

只使用手机端时不必配置 MCP；希望 AI 操作手机时，先完成手机端准备，再做电脑配对。APK 不安装到 Windows，MCP EXE 不在 Android 上运行。

可选：核对下载完整性

页面下载区提供 SHA-256。在 Windows PowerShell 中可执行：

Get-FileHash -Algorithm SHA256 -LiteralPath "$HOME\Downloads\MemScanner-Complete.zip"

下载目录不同就替换实际路径；把输出与下载页提供的值核对。哈希一致说明下载字节一致，不等于对所有设备的兼容性保证。不要仅凭文件名相同判断版本。

02 / 手机环境：必须满足什么？

最重要的条件是：ARM64 Android 手机 + Root + 真正可加载本模块的 KPM 环境 + 网络。只有 Root 权限，或只装了一个管理器 APK，并不代表 KPM 已经可用。

选择适合设备的 KPM 路线

还没有 Root / KPM？先做好准备

1. 核实具体机型、地区版本、系统版本和当前内核是否支持官方 Bootloader 解锁及所选加载器。不要仅凭品牌、Android 版本或“别人同品牌能用”判断。
2. 备份手机重要数据。Bootloader 解锁通常会清空数据，Root/刷入可能影响系统更新、完整性检查、保修或设备安全机制。
3. 准备与你当前固件版本匹配的原始镜像和恢复方案，先读完加载器官方安装文档。不要下载不明来源、其他型号或其他固件版本的补丁镜像。
4. 按选定加载器的官方流程完成安装，再确认 Root 和 KPM 状态。本说明不提供跨机型通用刷机命令；不同方案对 boot / init_boot 等镜像的要求不相同，不能套用。
5. 遇到不兼容或无法恢复的步骤应先停止，不要反复加载内核模块碰运气。建议先在有恢复手段的开发测试机上验证。

原厂系统、解锁 BL 后是不是就一定能用？

不一定。部分受支持机型可以在原厂系统上准备环境，不必为 MemScanner 自编内核；但能解锁 BL 只是可能的前置条件。Root 是否可用、KPM 加载器适配、内核配置（上游要求包含 CONFIG_KALLSYMS=y）和模块兼容性都要分别成立。厂商解锁政策会变，不提供“某品牌一定能／一定不能”的保证。

硬件相关参数通常由软件与加载环境处理，普通用户无需手动填写页大小或地址位宽；自动处理不代表所有内核组合均已测试。内核版本范围以所用加载器当前官方说明为准，不只看版本数字。

这一节完成标志：手机能正常 Root，KPM 管理器可用，并已确认有恢复方案与网络连接。

03 / 在手机加载 MemScanner.kpm

1. 把解压出的 MemScanner.kpm 复制到手机易查找的文件夹，如“下载/MemScanner”。传输方式可用 USB 文件传输或可信的局域网工具；初次使用无需 ADB。
2. 打开你已经安装并适配好的 KPM 管理器。进入明确标注KPM / KPModule / 内核模块的入口，不是普通 Magisk 模块安装页。
3. 选择“加载/安装模块”一类操作，选中 MemScanner.kpm。按管理器提示授权或确认；界面名称可能随版本不同。
4. 等待管理器显示加载成功，再到模块列表确认该模块处于已加载/启用状态。如果提示版本、符号、签名或内核不兼容，保留错误文本，先解决加载器兼容问题。
5. 若管理器要求重启或支持持久加载，按其官方流程完成。不要默认重启后模块一定还在；重启后再次核对模块状态。

使用 Magisk/KernelSU + KPatch-Next 时，先按 KPatch-Next-Module 上游文档准备独立 KPM 环境，再从其 KPM 管理入口加载本模块。它不是把本包 .kpm 当 ZIP 直接安装进 Magisk。该路线与本模块组合仍需实测。

完成标志：KPM 管理器明确显示模块加载成功，没有待处理的错误。

04 / 安装客户端、登录并授予权限

1. 在手机文件管理器打开 MemScanner.apk。如系统要求，给你正在使用的浏览器/文件管理器授予“允许安装未知应用”权限，再确认安装。只安装可信来源文件；安装后可收回这个安装来源权限。
2. 打开 MemScanner，按界面注册或登录。账号认证需要手机联网；先确保时间日期正确、网络能正常访问服务。
3. 按主页入口打开悬浮窗/显示在其他应用上层权限。仅授予你信任的应用；不需要为了悬浮窗随意开启无关辅助功能。
4. 确认内核模块已加载，点击“启动悬浮窗”。出现悬浮球后，点击它打开工作台。
5. 首次绑定进程或请求相关能力时，在 APatch/SukiSU/当前 Root 管理器里允许 MemScanner 的 Root 请求。如果没有弹窗，到管理器的超级用户/授权列表检查是否拒绝或受限。
6. 需要长时间运行或 AI 连接时，按手机系统设置允许后台运行、自启动，酌情加入电池优化白名单；小米等系统可能需要单独设置。锁屏、断网或省电限制仍可能断开连接。

登录后检查主页连接状态。使用 AI 时保持手机应用与所需工作台在线；电脑和手机不必同一局域网，但双方都要能访问服务。常规使用无需手机监听端口，也无需 adb forward。

若更新安装提示签名冲突，不要为了解决问题立即卸载并丢失数据。先确认来源与签名，备份需要保存的分析记录；只有明确接受重装影响后再处理。

完成标志：客户端已登录、悬浮窗能正常显示、Root 已允许、KPM 模块已加载。

05 / 第一次在手机上分析

先在自有或已获授权的测试应用验证只读流程，再进行修改调试。可以选你编写的测试程序中已知的计数值，不要从系统关键进程开始。

1. 绑定目标：在搜索页按包名或 PID 选择进程。目标有主进程与子进程时，确认当前数值实际属于哪一个，不要只凭列表第一个进程决定。
2. 选择类型：整数可从 DWORD 开始，浮点值按实际情况选择 FLOAT/DOUBLE；不同数据类型解释相同字节可能得到不同数值。
3. 选择区域：按测试目标选内存区域。初次可使用合理的常见区域，范围过宽会更慢；不知道类型/区域时先读取说明和逐步缩小，不要把零结果直接当作软件故障。
4. 首次搜索：输入测试应用当前显示的已知值，选择精确或合适条件。等待任务完成，不要在未完成时连续触发同一个长任务。
5. 变化再筛：回到测试应用，让该值发生已知变化，再以新值或“变了/增加/减少”等条件再筛，直到得到较小候选集。
6. 读取与确认：在结果或内存页查看地址与当前值，观察应用操作是否与候选同步。保存项可能依赖进程生命周期；重启目标后不要直接使用旧绝对地址。
7. 按需深入：需要定位访问来源时，使用断点/观察点捕获现场，查看调用栈、反汇编与 Trace，再由 AI 解释函数。是否可用取决于当前版本、设备与账号权限。

修改调试前，先留回退值

记录原值、类型和目标，在明确授权的测试范围中执行修改，然后立即回读并观察程序行为。验证完成恢复原值或重启测试应用。写入、断点与指令追踪都不是无风险操作，不要把“工具支持”理解为“任意地址都安全可写”。

四项辅助工具怎么用

• 特征码搜索：在已知范围用字节模式与通配符定位特征；先确认编码与范围，再把命中作为候选。
• 字符串搜索：从测试应用中的可读文本寻找数据线索，注意编码、生命周期和重复文本。
• 内存快照：在明确范围保存前后状态，用差异比对观察一次操作引起的变化；快照比对不是自动证明因果关系。
• 指针扫描：对确认过的目标寻找引用路径，按需要保存并在重启后复核，不把单次命中当成永久稳定链。

完成标志：至少完成一次“已知值搜索 → 数值变化 → 再筛 → 回读确认”的只读闭环。

06 / 电脑准备：把 MCP ZIP 再解压一次

本包 MCP 产物仅为 Windows x64 桌面程序。不直接适用于 macOS、Linux 或 Android；其他平台要使用对应平台的产物。电脑不需要 Root，也不需要另外安装 Python。AI 客户端本身须支持启动本地 stdio MCP，且使用支持工具调用的模型。

1. 把 memscanner-mcp-windows-x64-prototype.zip 复制到 Windows 电脑。
2. 右键“全部解压缩”，解压到固定目录。例如选择 C:\Tools\MemScanner\MCP。
3. 解压后应得到 memscanner-mcp 文件夹。里面至少有 memscanner-mcp.exe 和 _internal 文件夹，两者必须保持同级且完整。
4. 在资源管理器中定位实际 exe，可以按 Shift 后右键“复制为路径”，确认没有遗漏或重复的外层文件夹。
5. 不要只把 exe 拖到桌面，不要在 ZIP 内直接运行，不要放在每次清理会删除的临时目录，也不要让任意其他用户可写该程序目录。

C:\Tools\MemScanner\MCP\
└─ memscanner-mcp\
   ├─ memscanner-mcp.exe
   └─ _internal\
      └─ ……配套依赖文件……

双击 exe 没有界面、停着等待输入，不等于失败：它是供 AI 客户端通过标准输入输出启动的连接器。不要给它加 --help、不要配置成网页 URL、不要替换成浏览器打开。

本分发文件名仍含 prototype，不表示已做所有系统/杀软环境认证。安全软件若拦截，先核对来源与文件完整性，查看拦截详情；不要为了运行而关闭整机安全防护。

07 / 接入 OpenCode：路径、配置、配对

先准备，最后再生成配对码

先完成 exe 解压和配置文件定位，再在手机生成一次性配对码。配对码有时效且不能重复使用；生成后尽快填入，并只让一个新 MCP 实例先启动。不要把同一个码同时发给多个电脑/客户端。

1. 在 OpenCode 打开 MCP/配置入口，或定位当前用户配置目录。Windows 常见全局配置是 %USERPROFILE%\.config\opencode\opencode.json，也可能使用 opencode.jsonc；项目配置可能覆盖全局。编辑实际生效的文件，不要同时新建多份互相覆盖的配置。
2. 先备份配置。保留原模型、其他 MCP、权限和插件设置；已有 memscanner 时替换该条目，不新增同名 JSON 键，也不要遗留旧的直连版本。
3. 按客户端当前版本使用下面相应格式。OpenCode 使用 environment，不是 Claude 的 env；command 必须是数组。
4. 在手机 MemScanner 主页点击“生成 MCP 配对码”，把配置中的 PAIR_CODE 换成新码。本文不提供可共享的真实配对码。
5. 保存配置，完整退出 OpenCode（含托盘）再启动，或按该版本明确支持的 MCP 重连方式重新连接。只开新聊天不一定重载配置。
6. 查看 MCP 列表中的 memscanner 是否已连接、是否出现工具，然后按第 09 节做只读验证。

格式 A：现有桌面版常用的兼容格式

适用于配置中已经使用 mcp.memscanner、enabled 和整数毫秒 timeout 的版本。下面是可解析的完整最小示例；已有配置时只合并对应条目。

{
  "$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
    }
  }
}

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "memscanner": {
        "type": "local",
        "command": [
          "C:\\Tools\\MemScanner\\MCP\\memscanner-mcp\\memscanner-mcp.exe"
        ],
        "environment": {
          "MEMSCANNER_PAIR_CODE": "PAIR_CODE"
        },
        "disabled": false,
        "timeout": {
          "startup": 90000,
          "catalog": 90000,
          "execution": 700000
        }
      }
    }
  }
}

首次成功后：去掉一次性配对码

连接器默认把当前电脑自己的刷新凭据存到 %USERPROFILE%\.memscanner-mcp\credentials.json。首次确认成功后，可以删掉 MEMSCANNER_PAIR_CODE 这一项；environment 可留 {}。之后启动通过持久凭据恢复连接，不必每次生成配对码。

若你的现有配置已经设置了 MEMSCANNER_CREDENTIALS，凭据就在那个自定义路径，不是上面的默认位置。不要随意更换路径，否则可能看起来像未配对。不要在 JSON 中写 %USERPROFILE% 指望所有客户端都会自动展开；确需自定义时填写实际的用户私有绝对路径。

完成标志：OpenCode 的 memscanner 显示已连接，可列出工具；完全重启后仍能连接，不需要重复用已消耗的配对码。

08 / Claude Desktop 等其他客户端

只要客户端支持本地 stdio MCP，就可以配置本机连接器。不是把 EXE 上传到网页聊天框，也不是填远程 HTTP MCP 地址。客户端支持范围、配置入口、权限和长任务超时各不相同。

Claude Desktop：mcpServers + env

1. 打开 Claude Desktop 的 MCP/开发者配置入口，备份现有配置。具体文件位置以当前版本设置页为准。
2. 添加下面的 memscanner 服务，替换实际 EXE 路径。这里用 env，不要把 OpenCode 的 environment 原封不动搬过来。
3. 手机生成新的配对码后填入，完整退出客户端再启动。每个新控制端应完成自己的配对；不要在两台电脑间复制正在轮换的凭据文件。

{
  "mcpServers": {
    "memscanner": {
      "command": "C:\\Tools\\MemScanner\\MCP\\memscanner-mcp\\memscanner-mcp.exe",
      "env": {
        "MEMSCANNER_PAIR_CODE": "PAIR_CODE"
      }
    }
  }
}

Cursor 或其他支持本地 MCP 的客户端：选择“本地/stdio”，使用同一个 EXE 绝对路径，并在其指定的环境变量字段填入配对码。仅在它明确采用 mcpServers 结构时才使用上面的 JSON。工具被禁用、需要用户确认或模型不支持工具调用时，先在该客户端开启所需能力，不要改连接器来绕过权限。

09 / 配对成功后，怎么让 AI 真正工作？

先做无副作用的连接验证

保持手机登录、联网，先让 AI 读取工具目录或工作台状态；不要求 AI 猜地址或马上写内存。可以直接发送：

请使用 MemScanner 读取当前工作台状态，确认手机是否在线。
不要搜索、写入内存、设置断点、启动 Trace 或执行 Shell。
如果失败，请给我工具返回的完整错误，而不是猜测原因。

若工具列表能显示，但读取状态提示设备离线，说明“电脑连接器已连接”和“手机在线”是两件事。先恢复手机网络、登录和后台连接，不必盲目重装 EXE。

多台手机在线时，明确选择目标

如果服务提示多台设备、无法自动选择，在服务配置的环境变量里增加 MEMSCANNER_DEVICE，填入该服务所识别的目标设备 ID。不要猜它等于包名、PID 或 ADB 序列号。只在线一台时通常可省略。

给 AI 的第一项开发任务

我要分析自己开发的测试应用。先确认目标进程，读取当前状态。
根据我提供的数值和变化规律做搜索与再筛，并解释每一步结果。
只读阶段先不要改值、下断或启动执行追踪，等我确认后再继续。

确认目标后，再分阶段推进完整闭环

1. 搜索：给 AI 测试应用、当前数值、类型或变化规律，要求先确认候选再继续。
2. 下断：在你确认的测试地址上捕获访问现场，等待一次事件；结束后移除不再需要的观察点。
3. 调用栈追踪：关联触发点与函数调用路径，保留上下文，避免把不同线程/不同命中混在一起。
4. 代码反汇编与 Trace：从已确认的代码位置查看指令，需要时在明确范围内追踪。长任务不要因等待就重复启动；完成后停止追踪。
5. AI 还原伪代码：让 AI 结合指令、寄存器和调用栈整理可读逻辑。
6. 识别函数功能：要求区分已观察事实与推测，不把伪代码当成原始源码或已证明的结论。
7. 内存修改调试：先记录原值与范围，确认后修改、立即回读并观察结果，验证完恢复原值或重启测试进程。

超时、网络与隐私

连接器的单次工具超时默认较长；OpenCode 示例用 700000 毫秒为宿主留足等待时间。其他客户端若有独立工具超时，也需要按其设置调整。延长超时不能修复不通的网络，也不代表任务已执行成功。正常使用不必手机和电脑同网，不需要开放监听端口；公司代理等环境应单独验证，不能通过关闭 TLS 校验解决。

配对码与 credentials.json 都是敏感信息。不要贴进公开截图、网页示例、共享下载包或 AI 提示词。客户端配置仅需自行保留你的值，本文示例均为 PAIR_CODE 占位符。

10 / 遇到问题，按这个顺序排查

先分清五层：文件与路径 → 手机 Root/KPM → 登录网络 → MCP 进程与配对 → 具体工具任务。不要把所有问题都归结为“重装”或“配对码错误”。

向维护者反馈时，提供什么？

• 手机型号、Android 版本、内核版本、Root/KPM 管理器及版本、模块是否加载成功。
• 问题发生时间、停在哪一步、最小复现流程和完整错误文本。
• 电脑系统、AI 客户端版本、实际 exe 路径是否存在、是否完整解压、是否使用代理。
• 打码：邮箱、配对码、令牌、凭据文件内容、业务敏感内存、密钥与其他隐私。不要整份上传包含其他服务 API Key 的客户端配置。

11 / 更新、退出与移除

更新时

1. 结束当前分析任务，按需要保存记录，移除不再需要的断点并停止 Trace。
2. 完整退出 AI 客户端后再替换 Windows MCP 目录，保留配套文件结构；路径变化时同步修改配置。
3. 手机 APK 更新与 KPM 替换按对应管理器要求操作，先备份原文件和恢复手段，不在长任务运行中替换内核模块。
4. 更新完成重新核对登录、模块、悬浮窗与一次只读 MCP 调用。旧绝对地址和旧进程 PID 不应直接沿用。

不再使用时

先停止调试任务、关闭悬浮窗，再按 KPM 管理器说明移除或停用模块；客户端可在系统中卸载。电脑端禁用/移除对应 MCP 配置后重启 AI 客户端，再删除其程序目录。若希望移除本机配对，按账号/设备管理功能撤销控制端，并自行处理对应凭据；不把删除本机文件等同于服务端撤销。

12 / 完成清单与官方参考资料

• 完整包已解压，四个文件齐全；电脑 MCP ZIP 已再次解压。
• 手机 Android 8.0+，实际支持 arm64-v8a，Root 与 KPM 环境分别可用。
• MemScanner.kpm 已加载成功，没有加载同功能旧版造成冲突。
• APK 已登录、网络正常，悬浮窗与 Root 权限允许。
• 已完成一次测试应用只读搜索/再筛/回读。
• AI 客户端配置使用真实 EXE 路径，名称为 memscanner，没有重复旧条目。
• 新配对码只用于首次连接；重启仍可连接，凭据仅在本人私有目录。
• 需要 AI 写入、断点或 Trace 前，明确目标与范围并准备回退值。

参考资料

本说明参考软件文档、用户提供的真机环境信息，以及以下上游官方资料。外部页面可能更新；刷入与兼容要求以你选用版本的最新说明为准。“加载器支持 KPM”不等于“本包模块在该组合上已经全部实测”。

• APatch 官方：https://apatch.dev/；安装：https://apatch.dev/install.html。
• SukiSU Ultra 官方仓库：https://github.com/SukiSU-Ultra/SukiSU-Ultra。
• KPatch-Next：https://github.com/KernelSU-Next/KPatch-Next；Magisk/KernelSU 配套模块：https://github.com/KernelSU-Next/KPatch-Next-Module。
• OpenCode MCP：https://opencode.ai/docs/mcp-servers/；配置 Schema：https://opencode.ai/config.json。