Lunar：macOS 外接显示器亮度与色彩控制工具 #

Lunar 是什么？ #

Lunar 是一款专为 macOS 打造的外接显示器亮度控制软件，被官方称为"控制显示器亮度的标杆级应用（The defacto app for controlling monitor brightness）"。它通过 DDC（Display Data Channel）协议向显示器发送真实的亮度、对比度、音量与输入源指令，而不是像部分同类工具那样在屏幕上叠加一层黑色遮罩来"假装"调暗。

对于同时使用 MacBook 与外接显示器、Studio Display、Pro Display XDR 的用户而言，Lunar 解决了 macOS 原生无法统一调节第三方显示器亮度的长期痛点：亮度键、音量键、输入源热键都能直接作用于外接屏幕，还能借助环境光传感器、日出日落时间、时钟排程实现自动亮度调节，并可在深夜把亮度压到 0% 以下。软件适配 Apple Silicon 与 Intel 机型，免费版已覆盖核心功能，Pro 版提供高级自动化与硬件解锁能力。

Lunar 有哪些亮点特色？ #

• DDC 真实亮度控制：Lunar 通过 DDC 协议直接向显示器发送"设置亮度为 30%"这类指令，而非叠加黑色遮罩模拟变暗。官方强调这种方式能保持更接近真实的色彩还原、降低功耗，并减少背光溢光（backlight bleeding）现象，在 Apple Silicon 机型上同样有效。
• Apple 显示器原生支持：对于 Studio Display、Pro Display XDR、LG UltraFine for Mac、Thunderbolt Display、LED Cinema（USB 连接时）等 Apple 生态显示器，Lunar 调用 macOS Display Services 中隐藏的原生实现，提供平滑的亮度过渡效果。
• 键盘全权接管：沿用 Mac 用户熟悉的按键逻辑——亮度键一次性调节所有显示器亮度，音量键调节当前活动显示器音量，还可为 HDMI / DisplayPort / USB-C 输入源切换设置专属热键；亮度键可配置为只调节光标所在的那块屏幕。
• XDR 亮度解锁：2021 年及以后的 MacBook Pro 与 Pro Display XDR 面板峰值可达 1600 尼特，但 macOS 默认将其限制在约 500 尼特。Lunar Pro 可解除这一上限，让用户在户外强光下正常工作。
• 零下亮度调暗（Sub-zero Dimming）：多数显示器即使调到 0% 依然偏亮，Lunar 允许在归零后继续按亮度减键，将亮度压到屏幕标称下限以下，适合深夜写代码或加班赶稿的场景。
• 多种自适应模式：Sync Mode 把 MacBook 的自适应亮度同步到所有外接显示器；Sensor Mode 借助外部无线环境光传感器为 Mac mini、合盖 MacBook 甚至黑苹果提供自动亮度；Location Mode 与 Clock Mode 则分别依据太阳位置和预设时间表自动切换亮度与对比度。
• 黑屏与专注工具集：Auto BlackOut 可在接入外接显示器时自动关闭 MacBook 内屏（键盘、触控板、Touch ID、摄像头、扬声器仍可用）；BlackOut 可用单个热键选择性关闭任意屏幕；FaceLight 在视频通话时把显示器变成一块高亮暖白补光板。
• 自动化与命令行扩展：支持 macOS 快捷指令（Shortcuts）与 Lunar CLI 命令行工具，可在快捷指令或终端中执行亮度、输入源、DDC / Apple Native / Gamma 开关等操作，方便构建自定义工作流。此外还提供 Network Control，可通过网络控制同一局域网内的其他 Mac 显示器。
• DDC 失效时的兜底方案：当显示器固件不接受 DDC 指令时，Lunar 可回退到基于 Gamma 表的软件调光（Gamma Tables），并可针对单台显示器单独开关 DDC、Network、Apple Native 与 Gamma 控制方式。

免费下载 Lunar #

以下为官方提供的 macOS 安装包，点击链接即可下载。

说明：Lunar 提供 14 天免费试用，试用结束后可继续使用免费版功能；解锁全部 Pro 功能需购买终身授权（官方标价 23 美元）。

Lunar 如何使用？ #

1. 首次启动与授权：从"应用程序"文件夹打开 Lunar，按提示授予辅助功能（Accessibility）权限，否则无法接管亮度键与热键。菜单栏会出现 Lunar 图标，所有显示器会列在菜单中。
2. 基础亮度与音量调节：直接按 Mac 键盘上的亮度键即可调节全部显示器亮度，音量键调节当前活动显示器音量。若希望只调节光标所在屏幕，可在偏好设置中切换该行为。
3. 切换控制模式：在每台显示器的设置面板中可分别启用或关闭 DDC、Apple Native、Gamma、Network 等控制方式。遇到显示器不响应 DDC 时，可关闭 Hardware (DDC) controls，让 Lunar 回退到 Gamma 软件调光。
4. 配置自适应亮度：在 Sync Mode（同步 MacBook 自适应亮度）、Sensor Mode（外接环境光传感器）、Location Mode（跟随太阳位置）、Clock Mode（按时间表）中选择适合自己的模式，可设置 5 组时间计划与过渡方式（立即、提前 30 分钟、全程渐变）。
5. 设置热键与自动化：在 Hotkeys 页面配置输入源切换、BlackOut、FaceLight 等热键（默认 BlackOut 为 Control+Command+6，FaceLight 为 Control+Command+5），也可在"快捷指令"App 中调用 Lunar 动作，或用 lunar 命令行批量控制。
6. 零下亮度体验：亮度降到 0% 后继续按亮度减键，即可进入 Sub-zero Dimming 区间，适合夜间使用。

Lunar 的常见问题？ #

显示器在特定颜色下闪烁怎么办？ 官方 FAQ 指出，这通常由显示器固件缺陷或损坏的色彩配置文件引起。可尝试在系统设置中更换另一个色彩配置文件；Lunar 本身不会造成硬件损坏，因此若显示器此前没有隐藏问题，该现象一般可修复。

MacBook 屏幕黑屏、无法登录怎么办？ 极少数情况下，色彩配置文件异常会导致 MacBook 黑屏且看不到登录界面。若手边有另一台显示器，可通过终端删除 com.apple.windowserver.displays.plist、ColorSync 显示器配置文件并执行 sudo nvram -c 后重启；若只有本机屏幕，可进入恢复模式挂载 Data 卷后执行类似清理命令，或尝试用 VoiceOver（Command + F5）盲操登录。官方说明这是 macOS 色彩配置文件逻辑的问题，有无 Lunar 都可能发生。

显示器黑屏、无信号或反复开关机怎么办？ 先退出 Lunar、拔掉显示器电源再重新插上。常见原因是 macOS Gamma API 的已知缺陷或显示器固件对 DDC 指令响应不良。可尝试改用默认色彩配置文件、关闭 HDR 兼容性变通方案，或在高级设置中开启"唤醒后延迟 DDC"；仍无法解决时，可完全禁用 DDC 改用 Gamma 调光（代价是无法调节音量和输入源，且只能降低亮度）。

待机唤醒后亮度控制被锁定怎么办？ 这是 macOS 或显示器侧的偶发问题：唤醒后显示器的 DDC 端口在 macOS I/O Registry 中不可见，亮度控件上会出现锁图标。官方给出的解决办法是重启 Lunar，并在热键页面配置了"立即重启"热键以便快速恢复。

按亮度键或音量键没有反应怎么办？ 部分显示器根本不接受 DDC 指令。官方列出的常见原因包括：2018 款 Mac mini 的内置 HDMI 口会无故拦截 DDC 请求（改用雷雳口 + USB-C 转 HDMI 线或雷雳扩展坞可解决）、部分显示器在使用 HDMI 转 USB-C 线时 DDC 被屏蔽（改用 DisplayPort 连接可解决）。此外，三星 M7/M9/G7/G9、部分智能显示器以及一些型号的色彩配置文件冲突也可能导致控制失败。

Lunar 会不会留下后台进程或守护服务？ 不会。官方 FAQ 明确说明该应用没有任何守护进程或后台服务。若只想让它停止工作，关闭"登录时启动"并退出应用即可。

Lunar 如何安装？ #

Lunar 仅支持 macOS，官方要求 macOS 11 及以上版本（v6.11.0 起要求 macOS 12 或更新），并原生适配 Apple Silicon 与 Intel 芯片。

1. 从上方下载表格获取 Lunar-6.11.1.dmg 安装包。
2. 双击打开 .dmg 镜像文件。
3. 将 Lunar 图标拖拽到"应用程序"（Applications）文件夹中。
4. 打开"应用程序"并启动 Lunar，首次运行时在系统提示中允许该应用运行。
5. 按引导授予辅助功能权限（系统设置 → 隐私与安全性 → 辅助功能），使 Lunar 能够接管亮度键与热键。
6. 在菜单栏点击 Lunar 图标，即可看到已连接的显示器列表并开始调节。

注意事项：

• Lunar 不需要安装任何内核扩展或后台服务。
• 若使用 M1 / M2 的 MacBook 并希望外接两台以上显示器，官方文档建议配合 DisplayLink 适配器（M1 Pro / Max 机型无需此适配器）。
• 官方说明 v6.11.0 很可能是最后一个 v6 版本，v7 将重写整个亮度控制引擎与界面，并放弃对 Intel 机型和 macOS 14.0 以下系统的支持。

Lunar 如何卸载？ #

Lunar 没有常驻守护进程，卸载方式干净直接。若只想让它停止运行，在偏好设置中关闭"登录时启动"并退出应用即可；若要彻底卸载，可选择以下任一方式：

方式一：使用 brew（推荐给命令行用户）

brew uninstall --cask --force --zap lunar

方式二：使用 AppCleaner 或 PearCleaner 等卸载工具

1. 下载并打开 AppCleaner 或 PearCleaner。
2. 将"应用程序"文件夹中的 Lunar 拖入工具窗口。
3. 确认删除所有关联文件。

方式三：使用启动台（macOS Tahoe 26 之前的版本）

1. 从程序坞或聚焦搜索打开"启动台"。
2. 输入 Lunar 找到该应用。
3. 按住 ⌥ Option 键，点击应用图标上的 x 按钮完成卸载。

卸载后如仍残留偏好设置文件，可手动检查 ~/Library/Preferences/ 与 ~/Library/Application Support/ 下与 Lunar 相关的目录并删除。