Mac 游戏工具箱：macOS 游戏辅助工具箱

项目简介

Mac 游戏工具箱是一款原生 SwiftUI macOS 应用，用于集中管理常见的 Mac 游戏辅助操作。当前版本为 4.0.3，兼容 Intel Mac 与 Apple Silicon Mac，要求 macOS 14 或更高版本。项目以 GPL-3.0 协议开源。

应用采用统一的两栏侧边栏，把游戏性能、存储维护、ClickFlow、AppDrop 与帮助页面收纳在一起，显示语言和更新检查在统一的“设置”页面中管理。

主要功能

• MetalHUD：全局开启或关闭 MetalHUD，或通过最近 App 启动台仅为选定 App 的本次启动启用。可从访达拖入 .app 或通过文件选择器添加，支持 Steam 等自定义目录，并可保存参数预设，下次开启游戏时应用；也可为 CrossOver 容器写入 MetalHUD 参数，或为已连接的 iOS 设备上的游戏开启。
• ClickFlow 1.0.1：内置连点器、鼠标宏与组合宏；支持通过实验性 XInput 代理为 CrossOver 游戏回放手柄宏，并提供按游戏安装、诊断、备份与安全恢复。接受首次使用声明后可用全局快捷键调用，数据与独立版 ClickFlow 完全隔离。
• 磁盘管理：把磁盘挂载到指定路径，保存按 UUID 关联的预设，并自动或手动恢复上次挂载。单盘操作只作用于当前详情磁盘，批量模式在可用磁盘列表下集中显示勾选数量与批量按钮，并校验目标路径、报告失败与回滚结果。
• 存储维护：一键清理缓存日志，默认只清理用户缓存与用户日志，也可关闭敏感文件排除执行完整高风险清理。
• 进程与启动辅助：自动检测 CrossOver/Wine 进程，支持手动搜索、常用进程，以及三个模式独立保存的五档进程优先级；按 10、15 或 20 秒可选等待时间辅助启动 HoYoGames，任务结束或取消时恢复 hosts 配置；还可在 HoYoGames 页面切换 Steam Deck 主机名模式。
• AppDrop：心愿单、今日降价、历史低价与价格设置，支持 App Store 链接、关键词搜索、17 个商店区域、.wishdrop 导入导出、价格历史与降价通知；数据存放在独立的 ~/Library/Application Support/MacGameToolbox/AppDrop 目录，支持简体中文、繁体中文、英文、日语、韩语、德语、法语、西班牙语和葡萄牙语。
• 其他：导出诊断信息、Mac 游戏与 CrossOver 教程入口、启动时检查更新或手动检查 GitHub 更新。

安装与使用

从 4.0.3 Release 下载 MacGameToolbox-4.0.3.dmg，将应用拖入 Applications。同一个 Universal 安装包同时包含 x86_64 与 arm64，无需按芯片分别下载。应用必须从 /Applications/Mac 游戏工具箱.app 运行。

从源码构建需要 Swift 6、Xcode 16 或兼容版本以及 Xcode Command Line Tools：

./Scripts/build-release.sh

若 macOS 阻止应用启动，可在“系统设置 > 隐私与安全性”中允许打开，或用以下命令移除下载隔离属性：

sudo xattr -dr com.apple.quarantine "/Applications/Mac 游戏工具箱.app"

首次使用需要系统权限的功能时，macOS 会注册随应用提供的特权辅助服务；AppDrop 后台检查使用单独的登录项，仅在用户主动开启后注册，可在“系统设置 > 通用 > 登录项与扩展”中允许。

视频教程：哔哩哔哩 · YouTube

注意事项

• 安装包使用 Apple Development 身份签名，未经过 Apple 公证；Release 同时提供 SHA256SUMS 与 VERIFICATION.md。
• 自定义挂载或恢复默认挂载会影响磁盘上的运行程序与文件访问，执行前请停止相关读写，核对磁盘、目标路径及确认清单；旧磁盘预设没有 UUID 时需先关联。
• 缓存与日志清理不可撤销，可能导致登录状态、游戏缓存和诊断日志丢失，执行前请退出游戏并备份重要数据。
• ClickFlow 的全局输入功能需单独授予“辅助功能”和“输入监控”权限；CrossOver XInput 代理不是系统级虚拟手柄，部分反作弊、DirectInput、Raw HID 等游戏可能拒绝或绕过该代理。
• Steam Deck 模式只用于兼容性测试，不能保证绕过或兼容任何游戏的反作弊机制，请遵守游戏服务条款。
• 本项目不是 Apple、CodeWeavers、HoYoverse 或 Valve 的官方产品，相关名称和商标归各自权利人所有。

本作品整理自 GitHub 开源项目 aiwentongxue/mac-gaming-toolbox，原作者 @aiwentongxue，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。