使用教程

1. 安装部署

AntiMicroX 提供 Windows 安装包、便携版以及多种 Linux 安装方式。本节将分别介绍各平台的安装步骤。

Windows 安装

1. 访问 下载中心，点击"立即下载"按钮，扫描二维码或直接获取 antimicrox-3.6.1-AMD64.exe。
2. 双击安装包，按向导完成安装。默认安装路径为 C:\Program Files\AntiMicroX\。
3. 安装完成后，开始菜单中可找到 AntiMicroX 快捷方式。也可选择便携版 .zip，解压后直接运行 antimicrox.exe。
4. 首次启动时，Windows SmartScreen 可能提示未识别应用，点击"更多信息"→"仍要运行"即可。

Linux 安装

Linux 推荐使用 Flatpak 安装，自动解决依赖问题：

# 安装 Flatpak（如尚未安装）
sudo apt install flatpak    # Ubuntu/Debian
sudo dnf install flatpak    # Fedora

# 添加 Flathub 仓库
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# 安装 AntiMicroX
flatpak install flathub io.github.antimicrox.antimicrox

# 运行
flatpak run io.github.antimicrox.antimicrox

如不使用 Flatpak，也可下载原生包：

# Ubuntu / Debian (.deb)
wget https://github.com/AntiMicroX/antimicrox/releases/latest/download/antimicrox-3.6.1-AMD64.deb
sudo dpkg -i antimicrox-3.6.1-AMD64.deb
sudo apt install -f  # 解决缺失依赖

# AppImage（免安装）
chmod +x antimicrox-3.6.1-x86_64.AppImage
./antimicrox-3.6.1-x86_64.AppImage

2. 连接手柄

AntiMicroX 启动后会自动扫描已连接的手柄设备。无论是 USB 直连、蓝牙配对还是 2.4G 无线接收器，只要操作系统能识别，AntiMicroX 就能使用。

USB 连接

1. 使用数据线将手柄连接至电脑 USB 端口。
2. 启动 AntiMicroX，主界面顶部会自动出现手柄选项卡（如 "Controller 1"）。
3. 按下手柄任意按键，对应位置会高亮显示，确认识别成功。

蓝牙连接

1. 打开手柄蓝牙配对模式（Xbox：按住 Pair 按钮；PS：同时按住 Share + PS 按钮；Switch Pro：按住 Pair 按钮）。
2. 在系统蓝牙设置中搜索并配对设备。
3. 启动 AntiMicroX，手柄会自动被识别。

3. 首次按键映射

完成手柄连接后，下面以"将 A 键映射为键盘空格键"为例，演示完整的映射流程。

1. 在主界面顶部选择对应手柄选项卡。
2. 在手柄示意图上单击 A 按键，弹出映射编辑窗口。
3. 在编辑窗口中，单击键盘上的空格键。窗口会显示 Space 已绑定。
4. 点击"Apply"或关闭窗口保存映射。
5. 勾选界面顶部的"启用"复选框，映射即刻生效。
6. 打开任意文本编辑器，按下手柄 A 键，应看到空格被输入。

映射支持多种目标类型：

• 键盘按键：任意单键，包括功能键、方向键、修饰键。
• 鼠标按键：左/右/中键以及侧键（X1/X2）。
• 鼠标滚轮：上/下/左/右滚动。
• 组合键：如 Ctrl+C，多个键同时按下。
• 按键序列：依次按下多个键，可设置间隔。
• 脚本命令：触发预定义的 Lua 脚本。

4. 摇杆配置

摇杆是手柄映射中最灵活的部分。AntiMicroX 支持将摇杆映射为模拟鼠标、八方向数字键、或混合模式。

摇杆映射为鼠标

1. 单击手柄示意图上的左摇杆区域。
2. 在映射窗口选择"Mouse Cursor"选项卡。
3. 设置以下参数：

• 死区 (Dead Zone)：建议 10-25%，消除摇杆漂移。
• 灵敏度 (Sensitivity)：默认 1.0，可调至 0.5-2.0。
• 加速曲线：线性 / 二次 / 指数，影响推杆幅度与鼠标速度的关系。
• 最大速度：摇杆推到底时鼠标每秒移动的像素数。

摇杆映射为方向键

适用于复古游戏或仅支持键盘方向键的应用：

1. 单击摇杆区域。
2. 选择"Eight Way Directional"选项卡。
3. 分别设置上/下/左/右、四个对角线方向对应的键盘按键。
4. 调整死区，避免轻触摇杆误触发。

5. 宏与脚本

AntiMicroX 内置 Lua 风格脚本引擎，可编写复杂的按键序列、状态机和条件逻辑。这是其超越 Joy2Key 等基础工具的核心能力。

简单宏：一键三连击

-- 一键发出三连击左键
for i = 1, 3 do
  mousePress(1)
  sleep(50)
  mouseRelease(1)
  sleep(100)
end

组合键序列：Ctrl+C → Alt+Tab → Ctrl+V

keyPress("ctrl")
keyPress("c")
keyRelease("c")
keyRelease("ctrl")
sleep(200)

keyPress("alt")
keyPress("tab")
keyRelease("tab")
keyRelease("alt")
sleep(500)

keyPress("ctrl")
keyPress("v")
keyRelease("v")
keyRelease("ctrl")

条件逻辑：根据摇杆方向选择技能

local stickX = getStickX(0)  -- 左摇杆 X 轴值
local stickY = getStickY(0)  -- 左摇杆 Y 轴值

if stickY < -0.5 then
  -- 推向上方，释放技能 1
  pressKey("1")
elseif stickY > 0.5 then
  -- 推向下方，释放技能 2
  pressKey("2")
elseif stickX < -0.5 then
  -- 推向左方，释放技能 3
  pressKey("3")
elseif stickX > 0.5 then
  -- 推向右方，释放技能 4
  pressKey("4")
end

6. 多配置集管理

AntiMicroX 支持为同一手柄创建多个配置集（Set），每个 Set 拥有独立的映射关系，便于在不同游戏/应用之间快速切换。

创建新配置集

1. 主界面底部可见一行"Set"按钮，默认显示 Set 1。
2. 点击"Set 2"切换到第二个配置集（初始为空）。
3. 为新配置集配置映射关系。
4. 重复以上步骤创建更多 Set。

切换配置集

切换方式有三种：

• 手动点击：直接点击底部的 Set 按钮。
• 热键切换：在某一 Set 中映射手柄按键为 setSwitch(N) 脚本，按该键切换到 Set N。
• 自动加载：在设置中开启"Application Profile Switching"，可指定当前激活窗口自动应用对应配置。

保存与分享

配置集保存为 .amgp 文件（XML 格式）。可分享给其他用户、上传至社区、纳入版本控制。Linux 与 Windows 共享同一文件格式，跨平台导入无需转换。

7. 常见问题排查

手柄未被识别

• Windows：检查设备管理器中手柄是否正常显示，尝试更换 USB 端口。
• Linux：执行 lsusb 或 jstest /dev/input/js0 验证手柄已被系统识别。
• 蓝牙手柄：确认配对成功，必要时取消配对重新配对。

映射不生效

• 确认顶部"启用"复选框已勾选。
• 检查是否使用了管理员权限运行（Windows）/ root 权限运行（Linux），这可能导致权限冲突。
• 关闭其他手柄映射软件（如 Joy2Key、Xpadder、Steam 同时运行可能冲突）。

摇杆移动有延迟

• 降低鼠标移动的最大速度参数。
• 检查死区设置，过高的死区会导致小幅推杆无响应。
• 更新显卡驱动，部分老驱动影响输入轮询速率。