ANTICATER 原生版 1.0

ANTICATER 桌面音量旋钮配置工具的 macOS 原生版本，首个正式发布版。

在原版 app 的基础上二次开发，功能与协议与其保持一致，代码使用 Swift + SwiftUI 重新实现，不包含原版的任何源码或二进制文件。原版为 x86_64 单架构 Qt 程序，在 Apple Silicon 设备上需经 Rosetta 2 运行；本版本为原生 arm64，并按 macOS 平台惯例重新设计了界面。

功能

• 配置旋钮的五个物理动作：左旋转、右旋转、按压、长按左旋、长按右旋
• 每个动作支持单个按键、组合键、多媒体、鼠标划屏、Procreate 预设五类功能
• 灯效切换、菜单栏常驻、开机自启
• 修改先暂存于编辑区，提交前可放弃；写入后自动回读校验，未写入成功的项目会明确列出
• 数据线热插拔后自动重连，未提交的修改保留在编辑区

环境要求

macOS 13 或更高版本。修改配置需连接 USB 数据线，蓝牙侧为独立的 HID 设备，不提供配置接口。配置保存在旋钮固件中，设置完成后无需保持本软件运行。

安装

下载 ANTICATER-for-Mac-1.0.dmg，将应用拖入「应用程序」。

应用为 ad-hoc 签名，未经公证，首次打开会被 Gatekeeper 拦截。请右键点击图标并选择「打开」，在系统提示框中再次点击「打开」；直接双击无法通过。

运行不需要「输入监控」等隐私权限。

说明

设备协议无公开文档，本项目的实现基于对自有设备通信过程的观察。部分编号为推断结果，并非全部经过验证，代码注释中逐条标注了各项来源。其中 Procreate 预设的 31 个键码经过验证，而键码与名称的对应关系为推断结果，仅首尾两条经过独立验证，使用时建议以键码为准。详见 README。

本项目未实现固件升级或刷写功能。

许可

PolyForm Noncommercial License 1.0.0，仅供非商业使用。

本项目为非官方实现，与 ANTICATER 厂商无隶属关系，亦未获得其认可。