v1.3.3

v1.3.3

修复

• 启动时同时释放 x64 + x86 DLL。之前只释放 x64，导致首次跨位数注入时报
  "x86 DLL 未内嵌也未编译"；资源提取、内存快照、查看/修改也都被这道闸门
  挡住。现在 exe 启动时把两份 DLL 都校验并写到磁盘。
• dll_for_arch("x86") 在内嵌可用但磁盘缺文件时自动落盘，避开「自检时
  还没用到 x86」与「真正用的时候才落盘」之间的时序问题。

新增

• 设备访问面板（lsof 视角）。在 GUI 进程表选中目标后点「刷新」，会枚举目标
  进程打开的句柄，按 Win32 对象类型归到中文大类（文件 / 管道 / 设备 / 网络
  / 注册表 / 同步 / 进程/线程 / 内存 / GUI / Other），每条带句柄值、类型、
  对象名、访问掩码。
• CLI 子命令 SuperInject handles <pid>，支持 --category 过滤分类、
  --name-contains 按对象名过滤、--limit 限条数。
• MCP 工具 list_handles（read 档，授权会话可直接调用）。

使用前必读

本工具仅供开发人员调试程序使用，严禁滥用，违规使用者后果自负。

• 只能用于你自己拥有、或已获得明确授权的目标进程；
• 严禁用于绕过软件的授权 / 保护机制；
• 未经授权对第三方进程注入 DLL 可能违反当地法律与服务条款，由此产生的一切后果由使用者自行承担。

验证情况

windows runner 上用 MSVC 构建注入端 DLL（x64 + x86），并在真实 Windows 进程里跑集成测试：注入、内存读写、冻结、快照对比、断点、资源导出、卸载、重新注入。打包产物另外跑一遍全链路自检。

设备访问面板的句柄枚举在 Windows 真实机器上验证；macOS 单元测试覆盖分类逻辑与协议层。

界面交互、句柄枚举的完整覆盖（设备 / 命名管道 / 注册表键 / 同步对象）需要你在真机上确认。

Full Changelog: v1.3.1...v1.3.3

v1.3.2

v1.3.2

修复

• 自动更新弹窗：release notes 过长时，按钮会被挤出可视区、弹窗无法关闭。
  现在日志支持滚动，左上角加了 × 关闭按钮。

使用前必读

本工具仅供开发人员调试程序使用，严禁滥用，违规使用者后果自负。

• 只能用于你自己拥有、或已获得明确授权的目标进程；
• 严禁用于绕过软件的授权 / 保护机制；
• 未经授权对第三方进程注入 DLL 可能违反当地法律与服务条款，由此产生的一切后果由使用者自行承担。

v1.3.1

v1.3.1 hotfix

按 image 路径查进程

• CLI / GUI / MCP 三层都加上了按进程映像路径过滤。CLI 用
  SuperInject list --path "C:\\Windows\\System32"；GUI 进程表
  面板加了一个 "按映像路径搜索" 输入框（与原有的按名搜索并列）；
  MCP 工具 list_processes 也新增 path / arch 参数。
• 新增按父目录查找：controller.find_in_dir(parent)，匹配
  C:\\Windows\\System32 这种父目录时不会误中含同样子串的
  文件名。
• 进程列表也可以按位数过滤：x64 / x86。

x86 架构进程注入（GUI 入口补齐）

v1.3.0 已经在 DLL 层编了 x86 版本，并且 test_x86_injection_on_syswow64_ping
在 Windows runner 上跑通了。这次把 GUI 入口补齐：进程面板加了
"位数" 下拉，注入按钮按用户选的目标位数走；CLI / MCP 之前的
--arch / arch 参数已经接好。

修复

• 控制器里 resolve_targets 在 macOS 上的单元测试一直 fail，
  最后定位是内层循环 for p_l, pids in path_lookup.items() 跟
  函数参数 pids 同名，导致外层 for p in pids 看到的是
  shadow 之后的值（最后一项的 pid 列表）。修法是重命名为
  hit_pids。详细在 docs/notes.md 第二十二章。

本版新增

• 内存快照 / diff：给进程内存拍快照，之后对比两份找出哪些内存页变了，改动一两个字节也能定位。
• 硬件断点：在指定地址下断点，可设执行 / 读 / 写触发。命中时带回当时的 CPU 寄存器和栈内容。
• MCP 支持：把调试能力开放给 AI Agent（Claude Desktop、Cursor 等）。默认什么都不给，先在界面里授权，限定能操作哪些进程、允许哪几档能力、多久过期。没授权的工具 Agent 看不到，硬调也只会被拒。
• 授权面板：界面顶部显示 MCP 授权状态，可以授权、撤销、复制 Agent 端配置。
• 免 UAC 连接：界面里启用 MCP 服务后，Agent 通过 launcher 连接，不用每次点 UAC。
• 一键写配置：可以直接把配置写进 Claude Desktop 或 Cursor，写入前备份原文件，只改本工具自己那一项。

使用前必读

本工具仅供开发人员调试程序使用，严禁滥用，违规使用者后果自负。

• 只能用于你自己拥有、或已获得明确授权的目标进程；
• 严禁用于绕过软件的授权 / 保护机制；
• 未经授权对第三方进程注入 DLL 可能违反当地法律与服务条款，由此产生的一切后果由使用者自行承担。

Full Changelog: v1.3.0...v1.3.1

v1.3.0

本版新增

• 内存快照 / diff：给进程内存拍快照，之后对比两份找出哪些内存页变了，改动一两个字节也能定位。
• 硬件断点：在指定地址下断点，可设执行 / 读 / 写触发。命中时带回当时的 CPU 寄存器和栈内容。
• MCP 支持：把调试能力开放给 AI Agent（Claude Desktop、Cursor 等）。默认什么都不给，先在界面里授权，限定能操作哪些进程、允许哪几档能力、多久过期。没授权的工具 Agent 看不到，硬调也只会被拒。
• 授权面板：界面顶部显示 MCP 授权状态，可以授权、撤销、复制 Agent 端配置。
• 免 UAC 连接：界面里启用 MCP 服务后，Agent 通过 launcher 连接，不用每次点 UAC。
• 一键写配置：可以直接把配置写进 Claude Desktop 或 Cursor，写入前备份原文件，只改本工具自己那一项。

使用前必读

本工具仅供开发人员调试程序使用，严禁滥用，违规使用者后果自负。

• 只能用于你自己拥有、或已获得明确授权的目标进程；
• 严禁用于绕过软件的授权 / 保护机制；
• 未经授权对第三方进程注入 DLL 可能违反当地法律与服务条款，由此产生的一切后果由使用者自行承担。

Full Changelog: v1.2.0...v1.3.0

SuperInject v1.2.0 (Pre-release)

本版新增

• 崩溃转储：DLL 在 DllMain 注册未处理异常过滤器 + 向量化异常处理器，目标进程崩溃时把堆栈写到 %TEMP%\SuperInject\<pid>\dump-<tick>.dmp，并落同名 .json 元数据。控制器在通道断开后扫描目录合成 event:crash，CLI 用 events --follow 持续监听、dumps --open 直接打开目录。
• 事件流：被注入进程可主动推 type=event:* 帧（不参与命令响应匹配），崩溃转储等通知都走这条通路。
• 模块符号解析：info 命令可附每模块导出表，新增 exports 命令按基址或模块名查单个模块，自写 PE 解析不依赖 dbghelp。superinject.symbols 提供 module+0x123 / module!symbol+0x42 反查。
• 线程级冻结：threads 列目标进程所有线程（含 tid / 状态 / WaitReason / SuspendCount），thread-suspend / thread-resume 单独挂起一个线程。
• 代码 patch (trampoline)：patch-inject 在目标地址写 5 字节跳转到一个 RWX 跳板执行你的 shellcode 然后跳回，patch-list / patch-revert / patch-clear 管理已注入 patch（上限 32 条/进程）。
• CLI 新增 10 个子命令：events / dumps / exports / threads / thread-suspend / thread-resume / patch-inject / patch-list / patch-revert / patch-clear。

⚠️ 使用前必读

本工具仅供开发人员调试程序使用，严禁滥用，违规使用者后果自负！

• 只能用于你自己拥有、或已获得明确授权的目标进程；
• 严禁用于绕过软件的授权 / 保护机制；
• 未经授权对第三方进程注入 DLL 可能违反当地法律与服务条款，由此产生的一切后果由使用者自行承担。

本版验证情况

本仓库 windows runner 上 MSVC 构建注入端 DLL，与 CI 集成测试是同一份。

• pytest tests/test_integration_windows.py 在 windows-latest 真实注入 ping.exe，覆盖注入 / 内存读写 / 冻结（含 SuspendCount 验证）/ 资源导出 / 卸载 / 重新注入 / 跨位数注入；
• SuperInject.exe --self-test 跑本页下载的打包产物；
• info 命令默认不附带导出表（避免对 cold-start 目标做 PE 解析触发保护崩溃），需要时显式传 --exports-budget N。

Full Changelog: v1.1.0...v1.2.0

v1.1.0

本版新增

命令行模式
进程按路径搜索
x86 应用注入
PE 导出表偏移修复

⚠️ 使用前必读

本工具仅供开发人员调试程序使用，严禁滥用，违规使用者后果自负！

• 只能用于你自己拥有、或已获得明确授权的目标进程；
• 严禁用于绕过软件的授权 / 保护机制；
• 未经授权对第三方进程注入 DLL 可能违反当地法律与服务条款，
  由此产生的一切后果由使用者自行承担。

Full Changelog: v1.0.3...v1.1.0

v1.0.3

⚠️ 使用前必读

本工具仅供开发人员调试程序使用，严禁滥用，违规使用者后果自负！

• 只能用于你自己拥有、或已获得明确授权的目标进程；
• 严禁用于绕过软件的授权 / 保护机制；
• 未经授权对第三方进程注入 DLL 可能违反当地法律与服务条款，
  由此产生的一切后果由使用者自行承担。

本版验证情况

注入端 DLL 由 MSVC 在本仓库的 windows runner 上构建，与集成测试跑的是同一份。

CI 在 windows-latest 上完成了两层真实验证：

1. pytest tests/test_integration_windows.py —— 真实注入 ping.exe，
   覆盖注入检查 / 内存搜索与读写（含只读页改写）/ 冻结与解除（核实线程挂起状态）/
   资源提取 / 卸载 / 重新注入 / 自我终止；
2. SuperInject.exe --self-test —— 直接跑本页下载的打包产物，
   用内嵌 DLL 走一遍完整链路，报告见该次 CI 运行的 self-test-report 工件。

Full Changelog: v1.0.2...v1.0.3

v1.0.2

⚠️ 使用前必读

本工具仅供开发人员调试程序使用，严禁滥用，违规使用者后果自负！

• 只能用于你自己拥有、或已获得明确授权的目标进程；
• 严禁用于绕过软件的授权 / 保护机制；
• 未经授权对第三方进程注入 DLL 可能违反当地法律与服务条款，
  由此产生的一切后果由使用者自行承担。

本版验证情况

CI 在 windows-latest 上完成了两层真实验证：

1. pytest tests/test_integration_windows.py —— 真实注入 ping.exe，
   覆盖注入检查 / 内存搜索与读写（含只读页改写）/ 冻结与解除（核实线程挂起状态）/
   资源提取 / 卸载 / 重新注入 / 自我终止；
2. SuperInject.exe --self-test —— 直接跑本页下载的打包产物，
   用内嵌 DLL 走一遍完整链路，报告见该次 CI 运行的 self-test-report 工件。

Full Changelog: v1.0.1...v1.0.2

v1.0.1

⚠️ 使用前必读

本工具仅供开发人员调试程序使用，严禁滥用，违规使用者后果自负！

• 只能用于你自己拥有、或已获得明确授权的目标进程；
• 严禁用于绕过软件的授权 / 保护机制；
• 未经授权对第三方进程注入 DLL 可能违反当地法律与服务条款，
  由此产生的一切后果由使用者自行承担。

本版验证情况

CI 在 windows-latest 上完成了两层真实验证：

1. pytest tests/test_integration_windows.py —— 真实注入 ping.exe，
   覆盖注入检查 / 内存搜索与读写（含只读页改写）/ 冻结与解除（核实线程挂起状态）/
   资源提取 / 卸载 / 重新注入 / 自我终止；
2. SuperInject.exe --self-test —— 直接跑本页下载的打包产物，
   用内嵌 DLL 走一遍完整链路，报告见该次 CI 运行的 self-test-report 工件。

Full Changelog: https://github.com/Mofan2020/SuperInject/commits/v1.0.1