项目文件夹
安装
brew install --cask mactools
也可从 GitHub Releases 下载。需要 macOS 14 或更高版本;部分插件需要更新的系统或兼容硬件。
打开 MacTools,在「设置 → 插件市场」中安装工具,再按习惯整理菜单栏面板。系统权限按需申请。
更新与 Nightly 构建
MacTools 会自动检查应用更新。通过 Homebrew 更新:
brew update
brew upgrade --cask --greedy mactools
可从 nightly-* 预发布 下载 MacTools-Nightly.dmg,体验开发中功能。Nightly 使用独立的偏好设置和插件,可与稳定版共存,适合测试使用;硬件控制仍作用于同一台 Mac。
按你的习惯组合
快速找到并执行操作
在命令面板中搜索操作、设置、工作流和插件。MacTools 内按 ⌘K,或设置全局快捷键随时呼出。常用操作也能通过操作网格、键盘快捷键、鼠标映射和触控板手势执行,并与 Apple 快捷指令、已存脚本和 Run Link 配合使用。
日常所需,按需取用
| 分类 | 主要功能 |
|---|---|
| 截图与剪贴板 | 截图标注、文字与二维码识别、贴图、滚动截图、区域录屏;本地加密剪贴板历史、文本片段和粘贴队列。 |
| 窗口与工作区 | 窗口切换与布局、应用启动台、台前调度、Finder 右键工具。 |
| 键盘、鼠标与触控板 | 输入映射、手势、应用快捷键、滚动调节、模拟中键、自动输入。 |
| 显示与外观 | 亮度与分辨率、Sidecar、原彩显示、夜览、隐藏刘海、菜单栏图标与程序坞管理。 |
| 音频与电源 | 系统、麦克风、应用和显示器音量;阻止休眠、风扇控制、充电上限、锁屏、睡眠和关机。 |
| 监控与日历 | 系统状态、设备电量、活动统计、AI 用量、网络检测,或将电量、Wi-Fi 与音量合并为一个可调尺寸的菜单栏图标,支持电量百分比、状态颜色、细分网络状态与蓝牙音频标记;日历与近期日程。 |
| 清理与维护 | 可视化浏览磁盘占用,将文件移到废纸篓前先审查大文件与文件夹,查看缓存、开发工具、应用数据与 IM 聊天工具的存储占用,磁盘与 Xcode 清理、Homebrew 与启动项管理、推出磁盘、清空废纸篓、退出应用、修复隔离应用、系统软重启、屏幕键盘清洁模式。 |
| 工具与配置 | 划词翻译、划词运行可编辑的 AI 提示词模板、Cloudflare R2 上传、zsh 编辑、Siri、可重复应用的 Mac 设置配置方案。 |
截图支持 macOS 14+;区域录屏和应用音量需要 macOS 15+。硬件控制取决于设备支持,详见功能指南。
带走你的配置: 导入、导出偏好设置,保留本地备份,或通过云盘及共享文件夹同步支持的设置。应用支持 12 种语言,默认跟随系统。
终端中的 mactools
通过脚本或本地 AI Agent 发现操作、检查可用性并执行支持的操作,提供 JSON 输出、超时与取消。
CLI 目前是面向 Apple 芯片 Mac 的 Nightly 实验性功能。在支持的 Nightly 版本中,前往「设置 → 通用 → 命令行」安装并启用集成。Nightly 命令名为 mactools-nightly,普通稳定版尚未开放托管安装。
mactools-nightly doctor --json
mactools-nightly actions list --json
用 actions describe <id> 和 actions availability <id> 检查列表返回的操作,再通过 actions run <id> 执行。目前仅支持符合安全、后台、自动、可移植要求的无参数操作,暂不支持类型化参数和已存预设。
CLI 安装指南 · AI Agent 使用指南 · URL API
参与贡献
欢迎反馈问题、改进翻译、提出插件想法或提交 PR。Swift 6 / SwiftUI / AppKit 开发环境与流程见 CONTRIBUTING.zh-CN.md,插件开发见本地插件指南。
隐私与许可
优先本地处理,不包含维护者运营的分析或广告服务。联网功能与系统权限说明见隐私政策。
采用 GPL-3.0-only 许可证。许可范围与第三方声明列明依赖、素材和致谢。








