MacroHID 2.1.0 正式版

MacroHID 2.1.0 正式版

发布日期：2026-10-22。版本号为 2.1.0，Git 标签为 v2.1.0。本次将此前的 2.1.0 测试版更新为正式版，对比基线为上一正式版 v2.0.2。

2026-10-23 更新发行文件：修复向右拖动停靠分隔条后，动作面板卡片超出窗口、右侧内容被裁掉的问题；同时修正右侧分隔条双击重置的目标列。版本号保持 2.1.0，重新下载本页安装包或便携包即可获取修复。

拖拽导入与关闭流程

• 支持从资源管理器将一个或多个 .mcrx、.xml、.lua、.xmbcs、.mq、.txt、.json 文件拖入主界面，复用现有的格式识别、批量导入及子宏关联处理。
• 在宏库内拖入时保存到当前文件夹；在宏库管理页拖入时进入所选宏库并导入。忽略目录、重复路径及不支持的文件类型。
• 增加管理员运行时的 Windows Shell 文件接收通道。
• 修复退出清理完成过快时，在窗口关闭事件中再次关闭窗口引发异常的问题。关闭提示中选择退出后，自动停止播放、等待保存并退出，无需再次点击。

播放版本与界面

• 独立的播放版本对话框支持选择历史版本的播放实现；精度控制按卡片分组展示。
• 整合测试版中的热键启动延迟、SendInput 耗时补偿、Raw Input 热键检测、核心选择和系统延迟检查改进。
• 统一主题提示、对话框、输入校验与状态显示。
• 停靠分隔条使用统一的缩放逻辑，保持中间区域自适应；新增左右拖动、双击重置，以及三种语言下 320～900 宽度的动作面板布局回归检查。

Max（抢占）精度档

• 「精度控制 → 精度模式」新增 Max（抢占）：在极限档的基础上，两个播放线程以 TimeCritical 运行在 RealTime 优先级进程中，启用 MMCSS 关键级，绑定到最安静的两个核心，所有等待都改为纯自旋。Max 热键待命时线程也保持自旋，首个输入不必等线程唤醒。
• 两个线程同时自旋到截止时刻，谁先到谁发送（无锁竞速），一个核被中断时另一个照常准时发送。
• 代价：监听和播放期间占满两个 CPU 核心，游戏帧率可能下降。只在当前播放版本下生效，选旧版本时按它自己的极限档播放。
• 实测（假输入，8 轮交替）：
  • 10ms 间隔：最大迟到中位从 17µs 降到 2µs，最差从 671µs 降到 173µs。
  • 热键到首个 SendInput：P50 从 112µs 降到 69µs，P90 从 161µs 降到 115µs，P99 从 256µs 降到 197µs。
• 电源保护：屏幕关闭或变暗、睡眠和现代待机期间，以及唤醒后 2 分钟内，Max 自动退回极限档的做法（不自旋、不竞速、不待命自旋），并恢复进程优先级。起因：本机在一次测试中，退出现代待机 67 秒后蓝屏（0x9F，AMD 音频协处理器驱动没能完成电源切换）。当时是 8 个核以最高优先级持续自旋，比 Max 激进得多，但 Max 也可能在待机前后撞上同样的问题。

播放期间禁止垃圾回收

• 极致、极限（含 Max）档下，单轮写下的时长不超过设定秒数（默认 120 秒）的宏，播放时不做 .NET 垃圾回收，避免按热键到第一下、循环衔接和条件监控时偶尔多出几毫秒的停顿。发键的原生线程本来就不受影响。
• 禁止状态在第一批按键交出去之后才进入，不会挡在第一下前面。
• 循环播放时，只在一轮最后一批之后、下一轮开始之前回收，不会打断一轮的中途。
• 新增「高级设置」（左侧「全局运行」，在「宏基础控制」下面），可调：
  • 单轮不超过多少秒（填 0 关闭）；
  • 预留内存（默认 32MB）；
  • 离下一轮至少还有多少毫秒才回收（默认 3ms）；
  • 预留内存用掉多少才回收（默认 50%）；
  • 禁止状态失效后是否重新进入；
  • 条件监控运行时是否也允许回收。
• 一轮用超预留内存时，.NET 会自己退出禁止状态并照常回收，内存不会失控。
• 带条件分支、跳转、子宏调用的宏走托管控制流，这次还没有接入，照常回收。

未验证与已知问题

• 没有用真实按键在游戏中做端到端测试。Max 和禁止 GC 都只用假输入测过。
• 禁止 GC 还没有在 MacroStudio 里做开关对照，改善幅度未量化。
• 全系统停顿的复查结论（更正了之前的说法）写在 docs/precision-architecture.md 第 9 节。
• 本地托管测试 424 项通过，包含拖入文件的筛选、实际入库、目标文件夹及中文路径解码回归。尚未手工验收资源管理器跨权限拖拽和关闭交互。

下载 MacroHID-Setup-x64.exe 或 MacroHID-Portable-x64.zip，需要 .NET 8 Desktop Runtime x64。发行文件附带 SHA256SUMS.txt；本地另生成包含运行时的 artifacts/local-run/MacroStudio/MacroStudio.exe，需保留同目录依赖文件。完整代码对比：v2.0.2...v2.1.0。

MacroHID 2.0.4 测试版

MacroHID 2.0.4 测试版

发布日期：2026-10-18。版本号为 2.0.4，Git 标签为 v2.0.4，作为 GitHub 预发布（测试版）提供。对比基线为测试版 v2.0.3。

播放版本切换器

• 播放版本有了单独的窗口：左侧「全局运行」里新增「播放版本」按钮，标签显示当前版本（旧版本为橙色）。窗口左边是版本列表，右边逐条列出所选版本改了什么。可选 2.0.4（当前）、2.0.2、2.0.1、2.0.0、1.6.0、1.5.0、1.4.1、1.3.0 / 1.4.0、1.2.0。
• 「精度控制」改为「精度模式」「热键与发送」「CPU 核心」三张卡片，说明文字精简，不再需要滚动。
• 旧版本运行的是当时的原始代码，不是在新代码里模拟。每个旧版本的播放代码（Core、Runtime、原生引擎）从对应的 git 标签原样取出，编译成独立的程序集和原生库，放在 MacroStudio\legacy\ 下。宏的解析、计时、原生引擎、条件监视、子宏调用，以及热键的切换、按住、单次逻辑都由所选版本自己的代码执行，当时的问题也一并保留。
  • 1.3.0 与 1.4.0 的播放代码完全相同，合为一项。
  • 发布前用脚本把每个快照与标签逐个文件比对，确认一致。唯一的改动是 1.2.0–1.6.0 中一处标明的外部卡片接入点（3 处），以及 1.6.0 补上了当时未提交进 git 的同一个 WinDivert 驱动。
• 新功能保留：
  • 所选旧版本没有的效果卡片（断网、弱网、限速、调时、锁帧、YSR/KY3/Fufu 帧率、窗口激活），在它的时间线运行到这一步时由当前版本执行，运行结束时由当前版本恢复。
  • 测核、核心选择器、系统延迟检查始终使用当前版本，选出的核心掩码按所选版本当时的方式使用。
  • 界面、宏库、热键检测保持当前版本。
• 旧设置文件中的「精度代数」会自动迁移为对应的播放版本。
• 2.0.3 中的「1.6.0 精度代数」模拟已由真正的 1.6.0 代码取代。

并行卡片移除，同一时间只运行一个宏

• 动作面板中不再有并行卡片。旧宏里已有的并行卡片仍能打开和编辑，但开始监听或运行时会提示删除（所有播放版本都适用）。
• 一个宏正在运行或停止时，其他宏的热键会被忽略，「立即运行」也会被拒绝。正在运行的宏自己的热键照常能停止它，强制停止键照常有效。

未验证与已知问题

• 没有用真实按键在游戏中做端到端测试。每个旧版本都用不发送按键的宏验证过：单次运行、切换循环开始与停止、按住循环松开即停止，以及外部效果卡片的接入。
• GitHub 上 1.3.0 的安装包是 2026-09-21 重新上传的，代码接近 1.4.0；9 月上旬的中间构建没有对应的标签，未包含在内。
• 等文字卡片在 1.6.0 之前的版本中无法使用。宏里有这类卡片时，开始运行会提示改选更新的版本。
• 「热键启动对齐」「SendInput 耗时补偿」只对当前版本生效。
• 托管测试 422 项通过，原生调度回归测试通过。

下载 MacroHID-Setup-x64.exe 或 MacroHID-Portable-x64.zip，需要 .NET 8 Desktop Runtime x64。完整代码对比：v2.0.3...v2.0.4。

MacroHID 2.0.3 测试版

MacroHID 2.0.3 测试版

发布日期：2026-10-17。版本号为 2.0.3，Git 标签为 v2.0.3，作为 GitHub 预发布（测试版）提供。对比基线为正式版 v2.0.2，仅列出该版本之后的实际变化。

精度版本

• 「精度控制」新增「精度版本」下拉：最新（默认）、2.0.2、2.0.x、1.6.0。只影响下一次运行，旧设置文件按「最新」读取。
• 「最新」：按键时长从发送调用开始时起算，慢的按下调用不再把释放推后；可选 SendInput 耗时补偿（默认开启，仅最新）。
• 选择「1.6.0」现在会还原 1.6.0 的完整定时方式，不再只是切换原生引擎：
  • 托管播放线程：极限/极致下线程 TimeCritical，进程 High（极致为 RealTime），MMCSS Pro Audio，极致绑到抖动最低的核，运行期间不做垃圾回收；
  • 等待参数回到 1.6.0（最后自旋 250/800/2000µs，极致最后 2ms 纯自旋）；
  • 整次播放在核心掩码内运行，极致带掩码时在掩码内重新测核；
  • 每次运行都尝试原生引擎，不依赖预热是否成功；
  • 原生一个按键调用一次 SendInput，选核只看截止迟到，不排除嘈杂核；
  • 条件轮询使用运行的精度与更高优先级。
    这一档占用更高，系统繁忙时可能影响其他程序。不属于定时的功能改动（调用带条件的子宏、子宏内取色等）不随版本切换。

启动延迟与调度

• 启动时按所选档位预热原生工作线程，并预热真实的原生播放分支：冷启动首次热键中位数约 2ms → 约 0.25ms。
• 可选「热键启动对齐」：首轮以热键回调时刻加固定提前量为起点，热键到首次 SendInput 的时间变为恒定值。
• 原生调度器：完成事件复用、提交只唤醒所属线程；相对鼠标移动与按键批次的系统调用更少；组合键等待改用高精度定时器。
• 测核增加停顿探针，自动避开中断密集的核心；「精度控制 > 系统延迟检查」显示每个核的检查结果（默认开启避开嘈杂核）。
• 可选用 Raw Input 检测热键（默认仍为低级键盘钩子）。

界面

• 对话框统一布局与输入校验，主题化消息框；浅色/深色主题色调统一；三种语言字符串补齐。

未验证与已知问题

• 本版没有用真实按键在游戏中做端到端测量；「1.6.0」档的还原效果只用假输入与进程/线程状态核对过。
• 托管测试 419 项通过，原生调度回归测试通过。

下载 MacroHID-Setup-x64.exe 或 MacroHID-Portable-x64.zip，需要 .NET 8 Desktop Runtime x64。完整代码对比：v2.0.2...v2.0.3。

MacroHID 2.0.2 正式版

MacroHID 2.0.2 正式版

发布日期：2026-10-15。版本号为 2.0.2，Git 标签为 v2.0.2。对比基线为测试版 v2.0.1，仅列出该版本之后的实际变化；v2.0.1 的内容一并包含在本正式版中。

修复

• 修复「宏基础控制」对话框点击「确定」后，默认间隔、组合键间隔、强制停止键和关闭按钮的修改不生效、重新打开又变回默认值的问题。原因是确认后从面板重新读取设置时只保留了部分字段，其余字段被默认值覆盖并写入 MacroStudioRuntimeSettings.json；现在以完整设置为底，只更新精度与核心掩码。

播放与循环

• 循环宏末尾的等待不再被丢弃。此前没有激活条件的「按下、抬起、等待 N」循环实际周期约为 10ms（按键间隔保持时长），而不是写下的 N；现在周期等于写下的总时长。每轮开始时间以上一轮起点加总时长为准，已经落后时从当前时刻开始，不追赶补发。
• 默认间隔（同一按键按下与抬起之间无延迟时的保持时间）只推迟这一次抬起，不再推迟整条时间线。「点击、等待 50、点击」不再变成相隔 60ms。同一按键再次按下会等待它自己尚未发出的抬起，其他按键不受影响。
• 组合键间隔保持原行为：之后的动作随之后移，避免「Ctrl+A、点击」变成「Ctrl+点击」。
• 播放执行器与托管控制流运行器使用同一套循环周期规则。

诊断

• 在 WorkerStart 与 PlanReady 之间增加三个追踪阶段，仅用于测量，不改变行为。

未验证与已知问题

• 本版没有重新测量热键到目标接收的端到端延迟，v2.0.0 的性能数据不能直接套用。
• 「宏基础控制」修复的回归测试检查的是源码结构，未做自动化界面点击验证。
• 工作区中尚未提交的原生调度改动（SharedPlaybackScheduler.inl、SchedulerTests.cpp）不包含在本版内。

下载 MacroHID-Setup-x64.exe 或 MacroHID-Portable-x64.zip，需要 .NET 8 Desktop Runtime x64。完整代码对比：v2.0.1...v2.0.2。

MacroHID 2.0.1 测试版

MacroHID 2.0.1 测试版

发布日期：2026-10-14。版本号为 2.0.1，Git 标签为 v2.0.1，作为 GitHub 预发布（测试版）提供。对比基线为 v2.0.0，仅列出该版本之后的实际变化。

热键入口与启动

• 前台进程名按 (窗口, 进程 ID) 缓存，热键路径每次仍重新读取前台窗口，过滤语义不变。
• 低抖动热键处于待命状态时，保持计时器分辨率请求并关闭进程电源节流，热键解除或程序退出时恢复。
• 输入安全计划随预备计划缓存；运行开始日志移到交接给执行线程之后，缩短热键到首次输入的同步段。
• 应用启动时在低优先级后台线程做一次约 40ms 的路径预热，针对冷启动首次热键的 JIT 耗时。预热不调用 Prepare，不触碰原生引擎和所选核心，界面不显示预热产生的后端与运行状态；日志每次启动会多出几行 macro=(path warm-up) 的开始/结束记录。

诊断工具（默认关闭）

• MACROHID_HOOK_SELFTIME=1：记录钩子回调自耗时，释放时写日志。
• MACROHID_BATCH_TRACE=1：原生逐批追踪，MhpGetBatchTrace 导出。托管侧互操作与 CSV 导出尚未接入。
• 调度基准输出增加样本数、P99.9、最大值及超阈比例。

未包含与未验证

• 评估后不实施或撤回：把热键处理移出钩子线程（2.2）、定向唤醒（3.1）；自旋窗口衰减（3.2）未实施。依据见 阶段计划。
• 本版没有重新测量真实热键到目标接收的端到端数字，也没有对上述三项启动/热键入口改动做冷启动首样本的交替对照。v2.0.0 的性能数据不能直接套用到本版。
• 0.1–1.5ms 的调度尖峰尚未归因。托管测试 394 项通过。

下载 MacroHID-Setup-x64.exe 或 MacroHID-Portable-x64.zip，需要 .NET 8 Desktop Runtime x64。完整代码对比：v2.0.0...v2.0.1。

MacroHID 2.0 正式版

MacroHID 2.0.0 正式版

发布日期：2026-10-14。版本号为 2.0.0，Git 标签为 v2.0.0。对比基线为 GitHub 远端 v1.6.0 / 9d9ad8b，仅列出该版本之后的实际变化。

调度与播放

• 原生播放采用共享批次调度与预备工作线程，等待和输入提交不再占用整段计划的队列锁；保留批次顺序、键鼠按住时长和组合键保持时间。
• 单宏均衡档及极密集极限批次使用连续执行路径；预计算组合键边界并复用诊断工作区。间隔较大的极限批次保留两线程救援。
• 初次准备线程时预配置优先级、MMCSS 和亲和性；空闲阻塞等待时保留配置，减少孤立热键的重复准备。热键专用线程采用 AboveNormal，不提升整个进程至实时优先级。
• 重整播放控制器的取消、异步释放、关闭与运行状态生命周期；播放使用启动快照，改动宏库不会修改已开始的运行。
• 复用托管播放工作线程，对子宏及并行分支进行资源管理；改进条件动作准备缓存、重复评估缓存和清理行为。
• 增加原生队列、首次提交、异常批次等诊断，以及真实热键到独立接收进程的测试工具。实验中尾部退化的两项调度改写已撤回，不包含在本次发行中。

条件识别与编辑器

• 截图缓冲采用 BGRA 数据视图和租约管理，减少颜色转换、哈希及模板匹配路径的分配与复制。
• 改善条件监视缓存、动作计划复用和识别取消行为，保留原条件成立和触发语义。
• 调整动作面板、序列与条件动作显示，改善关联控件的缩放、提示、编辑响应和 JSON 更新。
• 宏库访问增加同步保护，监听准备及宏调用依赖使用一致快照。
• 补充带注释 JSON 的使用说明。// 注释读取能力在 1.6.0 已存在，本次不将它算作新增格式能力；可视化保存和导出仍不会保留注释。

YSR 锁帧动作与日志

• 增加 YSR 开启/恢复帧率动作，兼容旧切换动作。
• 统一运行日志、异常和锁帧诊断至 %APPDATA%\MacroHID\log，增加“打开日志”入口、异步写入、轮转与保留策略。

性能验证

以下是发布前同一执行实现的本机测量。版本号更新后进行了构建与功能回归，不将这些历史样本称为重新测量。

• 固定两个核心、五轮、每方案十万事件的单宏极限档假输入对照：最大迟到从 1,230.4µs 降至 893.4µs，合并 P99.9 为 2.7µs。五轮中四轮最大值改善，一轮退化；不能视为稳定最大值保证。
• 最终执行实现完成 30 次物理 F8 到独立 Win32 接收窗口：中位 3.461ms，最大 8.708ms。30 个物理样本不足估计 P99/P99.9。
• Win32/WPF 各 2,000 次自动热键实际输入接收，中位分别为 4.336/4.589ms，最大为 10.455/16.680ms。合计 4,030 次最终实现接收均成功，无丢失或重复。
• 物理测量从低层钩子入口计时，未覆盖机械开关、USB 传输、游戏动作与显示器响应；独立探针未覆盖完整主窗口进程筛选路线。
• 发行前托管功能回归、原生调度回归及帧时间比较器检查通过；逐项结果见发行验证记录。

以上数据来自一台 Windows 11 / Ryzen 9 7945HX 电脑。极限档持续自旋有明显 CPU 成本；未承诺跨设备表现、游戏帧时间或微秒级端到端。测量方法与更差的探索结果也保留在 实测报告。

打包与兼容性

• 一键生成安装包、便携包和自带 .NET 运行库的本地版；固定输出到 artifacts/packages 和 artifacts/local-run。
• 使用独立 staging 目录构建，成功后替换；旧产物保留备份，替换失败尝试回滚。便携包使用可移动的根目录启动脚本。
• 安装包和便携包均附带最新原生播放 DLL、Windows OCR 组件；发行提供 SHA256SUMS.txt。CI 增加原生回归与帧时间比较器检查，并更新发行文件上传路径。
• 保留已有宏库及用户配置路径，兼容既有宏格式和锁帧动作别名；未知解帧器版本不自动修改。

下载 MacroHID-Setup-x64.exe 或 MacroHID-Portable-x64.zip。两者需要 .NET 8 Desktop Runtime x64；源码打包生成的本地版自带运行库。安装步骤见 安装说明，构建方法见 打包说明。

完整代码对比：v1.6.0...v2.0.0。

本次发布检查

• Release 解决方案构建成功，388 项主程序测试通过。
• 原生调度回归通过，帧时间比较器 3 项测试通过，独立锁帧工具回归通过。
• 发行文件附带 SHA-256 校验值；原生 DLL 与性能测试版本一致。
• 本地可执行文件版本为 2.0.0.0，产品版本为 2.0.0。

MacroHID 1.6

MacroHID 1.6.0

新增与改进

• 完善断网、内置弱网、NetLimiter 限速、RTSS 锁帧、时间偏移及后台窗口相关动作。
• 加强播放输入释放与强制停止保护。
• 隔离多宏网络和锁帧效果，避免其他播放结束时清除当前效果。
• 修复弱网积压延迟、锁帧备份丢失和系统校时后的时间恢复问题。
• 防火墙与效果恢复错误明确报告；卡片参数增加范围与空值校验。
• 卡片打开聚焦第一个文本框，Enter 确认、Alt+Enter 换行；优化关闭窗口选项布局。
• 更新宏管理、录入、条件序列及相关操作说明。

下载与运行

• MacroHID-1.6.0-Setup-x64.exe：安装包。
• MacroHID-1.6.0-Portable-x64.zip：完整解压后运行根目录 MacroStudio 快捷方式。

Windows 10/11 x64，需要 .NET 8 Desktop Runtime x64。断网与内置弱网需要管理员权限及 WinDivert 驱动许可；RTSS 与 NetLimiter 引擎需要各自软件运行。

348 项自动测试通过。真实网络、RTSS 和目标应用兼容性仍需按使用环境验证。发布包未签名，安全软件可能要求手动确认。

MacroHID 1.5.0

MacroHID 1.5.0 正式版

MacroHID 1.5.0 是当前正式版。本版本补上选核窗口的逐核结果、自动勾选和按延迟排序。

主要变化

• 选择核心的列表改成深色主题，每行直接显示该核的最大延迟。测试过程中标出正在测量的逻辑核。
• 增加全选、全不选。测试结束后按最大延迟从低到高排序，未测量的核排在后面。
• 填写数量后点「自动选择」，按延迟从低到高勾选这么多个核。优先不同物理核，还有其他核可选时跳过逻辑核 0；物理核不够时再按延迟补上同核的超线程。
• 便携包根目录的 MacroStudio 快捷方式直接指向包内的 MacroStudio\MacroStudio.exe。

验证

• dotnet run --project tests\MacroHid.Core.Tests\MacroHid.Core.Tests.csproj --configuration Release：325 项测试通过

版本信息

• .NET assembly/package version：1.5.0
• Installer AppVersion：1.5.0
• Git tag：v1.5.0

MacroHID 1.4.1

MacroHID 1.4.1 正式版

MacroHID 1.4.1 是当前正式版。本版本把极限档位的选核交给用户勾选，并只在程序或目标进程刚启动时自动测量一次。

主要变化

• 宏库「全局运行」增加「选择核心」。列表显示逻辑核、物理核、性能核或能效核，以及同一物理核上的其他逻辑核。默认勾选性能核，不含逻辑核 0。
• 「测试」只测量勾选的核，并显示挑中的播放核和最大延迟。确定后写入极限核心掩码。播放或停止过程中不会开始测量。
• 极限模式启动时测一次。填了进程名的库在该进程第一次出现时再测一次，进程保持运行期间不重复。播放调用本身不再做全机扫描。
• 已安装过 MacroHID 时，安装程序仍显示目录页，并预填上次的安装路径。

验证

• dotnet run --project tests\MacroHid.Core.Tests\MacroHid.Core.Tests.csproj --configuration Release：324 项测试通过

版本信息

• .NET assembly/package version：1.4.1
• Installer AppVersion：1.4.1
• Git tag：v1.4.1

1.4.0

MacroHID 1.4.0

当前正式版。新增耕地机导入导出、取色全局热键、宏库路径栏，以及探险器拖拽滚轮投放。

下载

• MacroHID-Setup-x64.exe：安装包
• MacroHID-Portable-x64.zip：便携包，解压后双击根目录 MacroStudio 快捷方式（或 MacroStudio.cmd）

安装前请准备 Windows x64 的 .NET 8 Desktop Runtime。

若安装被 Windows 拦住

从 GitHub 下载后请先右键文件 → 属性 → 解除锁定，再运行。若出现 Error 4551 / 「应用程序控制策略已阻止此文件」，改用便携包，或按仓库 安装说明 处理。

使用说明见仓库 README。