Axiomate

在 macOS 上安装

macOS 平台通过下载发行包手动安装。由于发行包未经 Apple 公证，安装时需运行随包提供的 install.command 脚本以解除系统拦截。

系统需求

  • 操作系统：macOS 12.3 (Monterey) 及以上
  • 处理器架构：Apple Silicon（M 系列芯片）
  • 必需依赖：Git（由 Xcode 命令行工具提供，安装脚本可自动安装）
  • 可选依赖：Python 3.12+（部分技能为 Python 脚本，按需安装）
  • 网络：若系统缺少 Xcode 命令行工具，安装脚本需联网下载安装

安装步骤

  1. 从下载页获取 macOS 发行包，文件名形如 axiomate-<版本>-darwin-arm64.zip，解压至长期保留的目录（例如 ~/Applications）。解压后会得到一个包含 axiomate 可执行文件与 install.command 脚本的目录。

  2. 运行安装脚本。在 Finder 中进入解压出的目录，双击 install.command（或在终端中执行 ./install.command）。

    首次运行 install.command 时，可能因解压丢失执行权限或发行包未公证而被系统拦截，macOS 甚至可能提示「无法验证是否包含恶意软件」。这是因为发行包尚未做 Apple 付费签名与公证，而非脚本真的有病毒——脚本只做解除隔离、重签名、加入 PATH 等本地操作，内容公开可查，可放心运行。遇到拦截，按下面两种方式处理即可：

    • 打开「终端」，执行以下命令为脚本补上执行权限并运行（把路径换成你实际的解压目录）：

      chmod +x ~/Downloads/axiomate-<版本>-darwin-arm64/install.command && ~/Downloads/axiomate-<版本>-darwin-arm64/install.command

    • 在 Finder 中右键点击该文件并选择「打开」，在弹窗中再次确认；或在「系统设置 → 隐私与安全性」中点击「仍要打开」，解除拦截后再双击脚本运行。

    脚本会尽量一站式完成：

    • 检测 Xcode 命令行工具；缺失时在征得同意后自动安装（会附带提供 Git，可能需要输入管理员密码，下载较大、耗时较长）
    • 解除下载隔离标记（quarantine）
    • 为可执行文件添加执行权限
    • 对二进制进行本地重签名，避免出现 killed: 9
    • 将该目录加入 PATH

Axiomate 仍处于测试阶段，升级到新版本后若遇到旧数据不兼容的异常，可删除旧的 ~/.axiomate/ 目录与 ~/.axiomate.json 配置文件清空旧数据。删除前如其中有重要内容（如 skills、模型配置等），请先备份。

系统权限

Computer Use（桌面自动化）、截屏、麦克风等功能依赖 macOS 的隐私权限。这些权限无法由脚本自动授予，需你手动开启——install.command 会在结束时为你打开对应的系统设置面板。

首次使用相关功能时，macOS 也会弹窗请求，可按提示前往「系统设置 → 隐私与安全性」中开启：

  • 辅助功能（Accessibility）
  • 屏幕录制（Screen Recording）
  • 麦克风（Microphone）

在对应列表中添加并勾选你的终端或 axiomate 即可。

验证

打开一个新的终端（让 PATH 生效）并执行：

axiomate --help

正常输出帮助信息即表示安装成功。接下来配置模型即可开始使用。

卸载

macOS 版为手动安装，卸载也手动完成：

  1. 删除解压出的安装目录（例如 ~/Applications/axiomate-<版本>-darwin-arm64）。
  2. 移除安装时写入的 PATH。编辑 ~/.zshrc（或 ~/.bashrc），删除标有 # Added by Axiomate installer 的那行，然后重开终端。
  3. 可选：在「系统设置 → 隐私与安全性」的「辅助功能」「屏幕录制」「麦克风」列表中移除 axiomate 条目。
  4. 可选：删除个人数据 ~/.axiomate.json 与 ~/.axiomate/（如需彻底清理）。

~/.zshrc、~/.axiomate 等以点号开头的文件在 Finder 中默认隐藏。在用户主目录下按 Command + Shift + .（句点）即可切换显示隐藏文件，随后用「文本编辑」打开 ~/.zshrc 删除对应行，或将 ~/.axiomate 等拖入废纸篓即可。

注：Computer Use（桌面自动化）依赖 ScreenCaptureKit（屏幕采集）与 CoreGraphics（事件注入）框架，其中 ScreenCaptureKit 要求 macOS 12.3 及以上，因此最低系统版本定为 12.3。