PyMemoryEditor

一个纯 Python 库（基于 ctypes），让你只需几行 Python 代码即可检查、修改和搜索任意正在运行的进程的内存 — 在 Windows、Linux 和 macOS 上实现 Cheat Engine 工作流程！

直接通过 Python 读取、写入和扫描任意进程的内存。
一个统一的 API。三大操作系统。无需 C 编译器。无需原生构建步骤。

支持 🪟 Windows · 🐧 Linux · 🍎 macOS — 32 位和 64 位。

在运行中的游戏中修改数值 · 检查程序的实时状态 · 直接从 RAM 中采集数据。

安装

pip install PyMemoryEditor

若还需安装附带的 GUI 应用（Cheat Engine 风格的扫描器），请使用 app 附加组件：

pip install "PyMemoryEditor[app]"
pymemoryeditor

如需在大型进程上获得更快的扫描速度，可添加 speed 附加组件。它会引入 NumPy 并自动对数值扫描比较循环进行向量化 — 在选择性扫描中速度提升约 10–30 倍：

pip install "PyMemoryEditor[speed]"

📖 完整指南请参阅 Read the Docs。

实际演示

from PyMemoryEditor import OpenProcess

with OpenProcess(name="game.exe") as process:

    # Scan the whole process for every address holding the value 100.
    for address in process.search_by_value(int, value=100):
        print(f"Found at 0x{address:X}")

    # Read the current value, then write a new one back.
    current = process.read_int(address)
    process.write_int(address, current + 500)

就这么简单 — 用三行代码即可读取、写入或扫描另一个进程，而且每个平台上的用法完全一样。

功能一览

🐍 Python 库

用几行 Python 代码即可完全控制另一个进程的内存：

• ✅ 读写数值（int、float、bool、str、bytes）
• 🔍 数值扫描，支持八种比较模式
• 🎯 特征码扫描（IDA 风格的 AOB 与正则表达式）
• 🔗 指针链 + 实时 RemotePointer 句柄
• 🧭 指针扫描 — 查找可绕过 ASLR 的静态指针
• 🗺️ 内存映射、模块、线程
• 🧱 分配与释放远程内存（Windows / macOS）

🖥️ 附带的 GUI 应用

库的全部功能 — 无需编写任何代码：

• ⚡ 零配置 — 附加到进程后即可在几秒内开始扫描
• 🧲 精炼流程 — 首次扫描 → 后续扫描，带实时可视化反馈
• 📋 作弊表 — 即时冻结/写入数值，支持 JSON 导入/导出
• 🔬 十六进制查看器 — 浏览原始内存并内联写回
• 🧩 指针扫描界面 — 只需几次点击即可跨会话扫描、导出和重新扫描
• 🎨 一键访问 — 所有功能触手可及，无需代码

📖 文档

完整文档位于 pymemoryeditor.readthedocs.io — 涵盖安装、Cheat Engine 工作流程、每个方法与参数、GUI 应用指南、平台说明与故障排查。

快速导航：

可以用它构建什么？

• 🎮 游戏修改与速通工具 — 经典的 Cheat Engine 用例。
• 🔬 调试与内省 — 无需附加调试器即可检查实时状态。
• 📊 可观测性工具 — 对正在运行的进程中的变量进行采样以用于遥测。
• 🔐 安全与逆向工程研究 — 仅限你拥有或获授权测试的系统。
• 🎓 学习 — 附带的应用程序是了解内存扫描原理的绝佳教学工具。

[!NOTE] 负责任地使用。 PyMemoryEditor 通过操作系统级 API 与其他进程交互。 请仅将其用于你拥有或已获明确许可检查的进程。

🤝 贡献

非常欢迎提交 Pull Request、Bug 报告和功能建议。请阅读 CONTRIBUTING.md 了解开发环境配置、测试布局以及 需要注意的少量平台相关特殊问题。

如果 PyMemoryEditor 对你的项目有帮助，请为仓库点个 ⭐ — 这是支持 本项目工作并帮助更多人发现这个库的最简单方式。

许可证

基于 MIT 许可证 发布 — 可免费用于个人和商业用途。