MemoryScanner:基于 Qt 框架的内存搜索工具项目

a simple memory scanner

Branch1Tags1
FilesLast commitLast update
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago

MyMemoryScanner - 内存搜索工具(Qt GUI版)

一个图形界面内存搜索工具,支持在目标进程中搜索和定位数据。

项目结构

MyMemoryScanner/
├── CMakeLists.txt          # CMake 构建脚本
├── MyMemoryScanner.pro     # Qt Creator 项目文件
├── README.md               # 项目说明文档
│
├── src/                    # 源代码目录
│   ├── main.cpp            # 程序入口
│   │
│   ├── core/               # 核心功能模块(后端)
│   │   ├── MemoryEngine.h  # 内存搜索引擎类定义
│   │   ├── MemoryEngine.cpp# 内存搜索核心实现
│   │   ├── ProcessHelper.h # 进程辅助工具类定义
│   │   ├── ProcessHelper.cpp# 进程枚举和查找实现
│   │   └── Utils.cpp       # 工具函数实现
│   │
│   └── ui/                 # 用户界面模块(前端)
│       ├── MainWindow.h    # 主窗口类定义
│       └── MainWindow.cpp  # 主窗口逻辑实现
│
└── include/                # 头文件目录
    └── Utils.h             # 通用工具函数头文件

功能特性

  • ✅ 首次搜索:在整个进程内存空间中搜索指定数值
  • ✅ 精确搜索:在上次搜索结果中继续筛选,逐步缩小范围
  • ✅ 进程选择:支持通过PID或进程名称选择目标进程
  • ✅ 地址查看:显示所有候选地址及其当前值
  • ✅ 地址读取:读取指定内存地址的值

依赖要求

  • Qt 5.x 或 Qt 6.x(需要 Core 和 Widgets 模块)
  • CMake 3.10 或更高版本
  • C++11 兼容的编译器(MSVC、GCC、Clang)

编译方法

使用 CMake

mkdir build
cd build
cmake ..
cmake --build .

编译后的可执行文件在 build/bin/ 目录下。

注意:CMake 会自动查找 Qt 库。如果找不到,请设置 Qt5_DIR 或 Qt6_DIR 环境变量指向 Qt 安装目录。

使用 Qt Creator

  1. 打开 MyMemoryScanner.pro
  2. 选择构建套件(Kit,需要包含 Qt)
  3. 点击"构建"按钮

使用方法

  1. 运行程序:双击运行编译后的可执行文件(Windows 下为 .exe)
  2. 选择目标进程:
    • 在进程选择下拉框中输入进程名称或PID
    • 或从下拉列表中选择进程
    • 点击"刷新"按钮更新进程列表
    • 点击"选择"按钮确认选择
  3. 首次搜索:
    • 在搜索数值输入框中输入要搜索的整数值
    • 点击"首次搜索"按钮,程序会在整个进程内存中搜索
  4. 精确搜索:
    • 在目标进程中改变该数值(例如游戏中的血量、分数等)
    • 在搜索数值输入框中输入新的数值
    • 点击"精确搜索"按钮,程序会在上次结果中筛选
  5. 重复筛选:重复步骤4,逐步缩小范围直到找到目标地址
  6. 查看结果:
    • 搜索结果会显示在结果列表中
    • 双击结果项可以将地址复制到地址读取框
    • 在地址读取框中输入地址,点击"读取"可以查看该地址的当前值
  7. 重置搜索:点击"重置"按钮可以清空搜索结果,重新开始搜索

注意事项

  • ⚠️ 需要管理员权限才能访问某些进程的内存
  • ⚠️ 仅支持搜索 32 位整数(int,4字节)
  • ⚠️ 内存地址可能会在程序运行时改变

代码架构说明

核心模块(core/)

  • MemoryEngine: 封装了所有内存操作的核心类

    • 打开/关闭进程句柄
    • 执行首次搜索和精确搜索
    • 管理候选地址列表
    • 读取内存值
  • ProcessHelper: 进程相关的辅助功能

    • 枚举系统进程
    • 根据名称查找进程
    • 获取进程信息

界面模块(ui/)

  • MainWindow: Qt 图形用户界面
    • 进程选择下拉框和刷新功能
    • 搜索输入框和搜索按钮
    • 结果显示列表,支持双击复制地址
    • 地址读取功能
    • 实时显示搜索状态和结果数量

工具模块(include/)

  • Utils: 通用工具函数
    • 地址格式转换
    • 字符串处理

设计理念

  • 前后端分离:GUI界面层和核心逻辑分离,代码结构清晰
  • 封装底层API:将Windows API封装成易用的类
  • 清晰的注释:所有代码都有详细的中文注释,便于学习
  • 现代化GUI:使用Qt框架提供友好的图形界面
  • 实时反馈:搜索过程中显示进度,结果实时更新

未来扩展

Introduction

a simple memory scanner

Customize your domain