CHERRY Utility菜单栏常驻
电量一眼可见。切换配置档、灯效、亮度和颜色不用打开窗口，关掉主窗口也一直在。
1
安装并连接键盘
下载 DMG，把 CHERRY Utility 拖进「应用程序」文件夹后打开。用 USB 线连接键盘，并把键盘拨到有线模式。
- 插上后自动识别，菜单栏出现键帽图标和电量。
- 无线模式下只能读取接收器的基础信息；写入配置和升级固件需要有线连接。
1.2.1最新版本 · 支持应用内自动更新
在 Mac 上，
在 Mac 上，
好好设置你的 CHERRY 键盘
灯效、配置档、按键测试与固件升级——官方驱动只有 Windows 版，现在 Mac 上也有了。原生 macOS 应用，常驻菜单栏，随手切换灯光。
下载命令行工具 cherryzip · 4.3 MB · 解压后放进 PATH 中的目录即可使用
或用 Homebrewbrew install --cask 0xfeedface1993/tap/cherry-utility
功能
官方驱动能做的常用设置，
在 Mac 上一个不少
所有修改都通过键盘自己的配置协议写入，拔下键盘接到其他电脑上同样生效。
灯光与配置档
3 个板载配置档逐项编辑：11 种灯效、亮度、速度、颜色和休眠。修改先放在草稿里，确认后才写入。
本地预设
把喜欢的灯光存成预设，载入任意配置档；导出 .cherryprofile 文件，分享给其他 Mac。
按键测试
在真实键位图上实时显示按下与已测按键，包括旋钮；统计最多同时按下的键数和事件间隔。
固件升级
直接使用 CHERRY 官方升级包：校验 MD5 与 CRC 后通过 USB 刷写，键盘重启后读回核对。
快捷指令与 Spotlight
10 个动作：读取状态和电量、切换配置档、调灯效 / 亮度 / 颜色 / 休眠、载入预设。可以放进快捷指令自动化，也能在 Spotlight 里直接输入「切换配置档」运行。
命令行 cherry
cherry status、cherry set --effect 呼吸，写进脚本就能用。可以单独下载；应用在运行时经由它执行，没运行时直接连接键盘。
AI 助手（MCP）
cherry mcp 让 Claude Code、Claude Desktop 等 AI 客户端读取和设置键盘。在「设置 › 自动化」里一键添加到 Claude Desktop；不提供固件操作。
本地优先，不收集数据
没有账号、没有统计上报。诊断记录只保存在本机，由你决定是否导出分享。
使用示例
三分钟上手
从安装到写入第一个灯效配置，跟着下面的步骤做就行。
2
在菜单栏随手切换灯光
点一下菜单栏的键帽图标：切换配置档 1 / 2 / 3，选择灯效，拖动亮度和速度，点一个颜色——改动立即生效。
- 已保存的预设可以一键载入当前配置档。
- 主窗口关掉后，菜单栏图标仍然在。
3
精细编辑配置档，确认后写入
打开主窗口的「灯光与配置档」，点选要编辑的配置档。修改过的项目会标上橙点，底部提示还有几项没写入。
- 点「写入键盘」或按 ⌘S 写入；不满意就点「放弃」。
- 写入时只发送改动的字段，写完会读回核对。
4
测试每一个按键
打开「按键测试」，第一次使用时按提示在「系统设置 › 隐私与安全性 › 输入监控」中允许 CHERRY Utility，然后逐个按键。
- 测过的键变绿，按住的键高亮，旋钮也能测。
- 打开「屏蔽本应用快捷键」，测试时不会误触 ⌘Q 等快捷键。
5
升级到最新固件
「固件升级」会对比键盘当前版本和 CHERRY 官方目录中的最新版本。下载并校验升级包后点「开始升级」，大约 30 秒。
- 升级期间保持有线连接，不要拔线或让 Mac 睡眠。
- 完成后键盘会重启，应用会读回 CRC 确认固件写入正确。
自动化
用快捷指令、终端或 AI 助手
控制键盘
三个入口与菜单栏共用同一套校验和写入逻辑，改完立即同步到菜单栏；固件操作不对自动化开放。
支持设备
已适配的键盘
PIXIU 75 已在真机验证；其余型号按 CHERRY 官方驱动中的数据适配，只写入官方驱动同样会写的字段，尚未在真机上验证。固件刷写目前只支持 PIXIU 75 系列，其他型号请使用官方升级程序。
型号可用功能状态
MX PIXIU 75全部功能：灯光、配置档、预设、按键测试、固件升级真机验证
MX PIXIU 75 宝可梦版全部功能：灯光、配置档、预设、按键测试、固件升级按驱动适配
无线 RGB 键盘与 2.4G 接收器PIXIU 98 / 99、MX 8.3 / 10.1、MX 3.0S / 8.2 TKL 无线版等：灯光、配置档、预设、电量、按键测试按驱动适配
有线 RGB / 单色键盘MX BOARD 3.0S / 2.0S / 1.0 / 10.0、G80-3000S 等：灯光、配置档、预设、按键测试按驱动适配
无背光键盘MX BOARD 3.0S / 2.0S / 1.0 NBL、G80-3000S NBL 等：切换配置档、按键测试按驱动适配
其他 CHERRY 设备显示 USB / HID 基本信息只读
本应用是独立开发的非官方工具，与 CHERRY 无关联。写入配置和刷写固件都存在风险，请在了解后果的前提下使用；修改固件的「自定义固件」是实验性功能，默认隐藏。
开源
源代码在 GitHub 上
CHERRY Utility 以 MIT 许可证开源：Swift 6、SwiftUI 与 TCA，六边形架构，内置模拟键盘，不接键盘也能运行和测试。
你的型号能不能用、遇到了问题、想要新功能，都欢迎在 GitHub 上告诉我们。
0xfeedface1993 /cherry-utility-macPublic
给 Mac 用户的 CHERRY 键盘工具（非官方）：灯效、配置档、按键测试、固件升级，以及快捷指令、命令行和 MCP 自动化。
macosswiftuikeyboardapp-intentsmcp
App组合根与 App Intents
Packages/CherryKit协议、适配器、命令行与 MCP
Docs使用指南与开发者文档
Website本站源码
SwiftMIT License
更新日志
版本历史
应用会自动检查更新，也可以在「设置 › 更新」中手动检查。
1.2.1
- 菜单栏面板在写入设置时不再改变高度，切换灯效和配置档更流畅，高刷新率显示器上的掉帧明显减少。
1.2.0
- 快捷指令与 Spotlight：新增 10 个动作（读取状态与电量、切换配置档、设置灯效 / 亮度 / 速度 / 颜色 / 休眠、载入预设），可以放进快捷指令自动化，也能在 Spotlight 里直接运行。
- 命令行工具 cherry：可以在官网单独下载；CHERRY Utility 运行时经由它执行，没运行时直接连接键盘。
- cherry mcp：让 Claude Code、Claude Desktop 等 AI 客户端读取和设置键盘，不提供固件操作。
- 新增「设置 › 自动化」：命令行与 MCP 的开关和调用记录，一键安装 cherry、添加到 Claude Desktop。
- 修复关掉「启动时显示主窗口」后点程序坞图标打不开主窗口；Finder 与 Spotlight 里显示为「CHERRY Utility」。
- 自动化调用更省资源：写入不再重绘菜单栏图标，cherry mcp 空闲时不再占用 CPU。
1.1.0
- 支持更多 CHERRY 键盘：按官方驱动数据适配 MX BOARD、G80、PIXIU 98 / 99、MX 8.3 / 10.1 等有线、无线键盘和 2.4G 接收器，界面只显示该型号支持的功能。
- PIXIU 75 以外的型号尚未在真机上验证；固件刷写仍只支持 PIXIU 75 系列，其他型号会说明如何用官方程序升级。
- 实验性「自定义固件」新增 PIXIU 75 宝可梦版（0102）。
- 修改灯效和休眠时只写入改动的字节。
1.0.1
- 安装盘加入安装引导背景：把 CHERRY Utility 拖到「应用程序」即可完成安装。
- 应用内更新的对话框和「上次检查」时间改为中文显示。
- 提示信息改为整句朗读，VoiceOver 下更易理解。
1.0.0
- 首个公开版本：菜单栏常驻、设备概览、灯光与配置档、本地预设、按键测试与固件升级。
- 全新界面设计，支持浅色与深色模式。
- 内置 Sparkle 自动更新，更新包使用 EdDSA 签名并经过 Apple 公证。
- 自定义固件改为实验性功能，默认隐藏，可在「设置 › 实验性功能」中开启。
常见问题
你可能想知道
这是 CHERRY 官方软件吗？
不是。这是一个独立开发的非官方工具，给使用 Mac 的 CHERRY 键盘用户。它通过与官方 Windows 驱动相同的 USB 配置协议工作，但与 CHERRY 没有任何关联，也不代表 CHERRY。
为什么需要「输入监控」权限？
只有「按键测试」需要它：macOS 要求应用获得这个权限才能读取键盘发出的按键报文。应用不会记录或上传按键内容。不使用按键测试时可以不授权。
升级固件安全吗？
升级使用 CHERRY 官方发布的升级包。刷写前会校验文件 MD5 与固件 CRC，并确认升级包与键盘型号匹配；刷写后读回 CRC 核对。过程中请保持有线连接，不要拔线。应用内升级目前只支持 PIXIU 75 系列，其他型号的升级方式会在「固件升级」页说明。
「自定义固件」是什么？
它可以在原厂固件上修改部分行为，例如固定 F 区的功能键逻辑，目前适用于 PIXIU 75 与 PIXIU 75 宝可梦版。这是实验性功能，默认隐藏，需要在「设置 › 实验性功能」中确认风险后才会出现，并且随时可以恢复原厂固件。
能用快捷指令、命令行或 AI 控制键盘吗？
可以，见上面的「自动化」。快捷指令的动作在编辑器右侧的「App › CHERRY Utility」里（应用要放在「应用程序」文件夹中），把几个动作串起来时，在动作的选项里关掉「运行时显示」。命令行工具 cherry 可以在本页单独下载；应用没在运行时 cherry 直接连接键盘，这时需要在「系统设置 › 隐私与安全性 › 输入监控」里允许运行它的终端。Claude 等 AI 客户端使用 cherry mcp。命令行与 MCP 都可以在「设置 › 自动化」里分别关掉。完整说明见使用文档。
源代码在哪里？可以参与开发吗？
源代码在 GitHub，以 MIT 许可证开源。欢迎提 issue 反馈问题、告诉我们你的型号能不能用，也欢迎提交 pull request；构建与测试方法见开发者文档。
应用怎么更新？
应用内置 Sparkle 自动更新：每天检查一次本站的更新源，新版本经过 EdDSA 签名和 Apple 公证后才会被安装。你也可以随时从本页面下载最新版本覆盖安装。
会收集我的数据吗？
不会。应用没有账号和统计上报，只在检查固件和应用更新时访问网络。诊断记录只保存在本机（默认 7 天、最多 32 MB），只有你手动导出后才会离开这台 Mac。
下载 CHERRY Utility for Mac
版本 1.2.1 · macOS 15.0 及以上 · 通用二进制
Homebrewbrew install --cask 0xfeedface1993/tap/cherry-utilitybrew install --cask 0xfeedface1993/tap/cherry-cli