Lunar 6.7.11 修复说明：Sync Mode 在 MacBook Air 与 iMac 上改用 nits 同步

桌面应用【免费下载链接】LunarIntelligent adaptive brightness for your external monitors项目地址https://gitcode.com/gh_mirrors/lu/Lunar点击查看免费下载Lunar 6.7.11 是一个针对Sync Mode同步模式的定向修复版本。此次更新修复了 Apple Silicon MacBook Air 与 iMac 上Sync Mode 未按 nits亮度单位进行同步的问题。本文将结合该版本 Release Notes 与仓库源码说明问题成因、修复机制、相关配置与排查方法。背景什么是 Sync ModeLunar 内置多种自适应亮度模式Sync Mode 是其中之一其核心思路是跟随一台源显示器Source Display的亮度同步调整其他外接显示器的亮度。例如当你在 MacBook 内置屏幕上调高亮度时外接显示器会随之同步变亮。在源码中Sync Mode 通过AdaptiveModeKey.sync标识其单例SyncMode.shared负责同步逻辑参见 Lunar/Modes/AdaptiveMode.swift 中的模式枚举与SyncMode.shared引用。Sync Mode 的源显示器选择逻辑位于 Lunar/Utils/DisplayController.swiftlet externalSource displays.filter { !$0.isBuiltin $0.isSource !$0.blackout } if let source externalSource.first(where: { $0.hasAmbientLightAdaptiveBrightness }) ?? externalSource.first(where: { $0.isNative }) ?? externalSource.first { return source } if let d displays.first(where: \.isBuiltin), d.isSource, !d.blackout { return d }即优先选择支持环境光自适应亮度hasAmbientLightAdaptiveBrightness的外接显示器其次选择原生native显示器最后可回退到内置屏幕。问题描述MacBook Air 与 iMac 未使用 nits 同步本版本修复的核心 bug 是Fix Sync Mode not using nits on MacBook Air and iMac (Apple Silicon only)在 Apple Silicon 的 MacBook Air 与 iMac 上Sync Mode 此前未按 nits尼特进行同步。为什么要按 nits 同步nitscd/m²是显示器亮度的绝对物理单位。macOS 中内置屏幕的亮度调节范围通常为 0500 nits部分支持 XDR 的机型可达 1600 nits而不同外接显示器的亮度范围各异。若仅按 0100 的百分比直接映射不同显示器的亮度曲线不一致同步效果会失真。Lunar 为此实现了 SDR 亮度与 nits 的双向换算函数位于 Lunar/Data/Display.swiftfunc sdrBrightnessToNits(_ brightness: Double, maxNits: Double) - Double { guard brightness 0 else { return 0 } if brightness 0.5 { return brightness * 2 * 140 } let t (brightness - 0.5) / 0.5 return 140 * pow(maxNits / 140, t) } func nitsToSdrBrightness(_ nits: Double, maxNits: Double) - Double { guard nits 0 else { return 0 } if nits 140 { return nits / 280 } return 0.5 0.5 * Foundation.log(nits / 140) / Foundation.log(maxNits / 140) }该换算基于 macOS 的 SDR 亮度曲线00.5 为线性段0140 nits0.51.0 为对数段140 nits 至 maxNits。这正是 Sync Mode 按 nits 同步的数学基础。修复机制isUsingNits() 与 nits 读取nits 读取链路在 Apple Silicon 上Lunar 通过 AppleNativeControl.swift 读取并推算 nits。核心逻辑在updateNits()第 L206-L247 行if display.enhanced, let maxHardwareNits display.maxHardwareNits, display.xdrBrightness 0 { nits display.xdrBrightness.d.map(from: (0, 1), to: (maxNits, maxHardwareNits)) } else { var brightness: Float 0.0 DisplayServicesGetLinearBrightness(display.id, brightness) nits maxNits * brightness.d }即通过DisplayServicesGetLinearBrightness获取线性亮度再乘以显示器的最大 nitsmaxNits得到当前 nits。若显示器处于增强XDR模式则基于xdrBrightness在 SDR 上限与硬件上限之间映射。isUsingNits() 的判定作用SyncMode.isUsingNits()用于判定当前是否按 nits 同步。代码库中该判定用于以下关键位置Lunar/SwiftUIViews/DisplayRowView.swiftnitsText()在SyncMode.isUsingNits()成立时显示显示器当前 nits 数值display.nits。Lunar/SwiftUIViews/NitsTextField.swift当syncMode SyncMode.isUsingNits()时显示可编辑的 min/max nits 输入框。Lunar/Data/Display.swift在isUserAdjusting()中当处于 Sync Mode 且isUsingNits()成立时通过nitsBrightnessMappingSaver/nitsContrastMappingSaver判断用户是否正在调整。本次修复正是让 MacBook Air 与 iMac 上的 Sync Mode 正确进入 nits 同步路径从而在 UI 中显示 nits、并基于 nits 做插值映射。相关配置syncNits 与 min/max nitssyncNits 开关syncNits是 Sync Mode 是否按 nits 同步的默认开关定义于 Lunar/Data/DataStore.swift.syncNits,其缓存键与发布者分别位于 DataStore.swift 第 802 行 与 第 935 行cacheKey(.syncNits) let syncNitsPublisher pub(.syncNits)UI 层通过Default(.syncNits)读取该设置见 Lunar/SwiftUIViews/UsefulInfo.swift。minNits / maxNits 的约束nits 同步依赖显示器的 min/max nits 数值其约束逻辑位于 Lunar/Data/Display.swiftminNits必须满足minNits maxNits minNits 0否则被钳制为 0 或maxNits - 1。maxNits必须满足maxNits minNits maxNits 0 maxNits 3000超过 3000 会被钳制回旧值。用户可通过 NitsTextField.swift 中的输入框自定义 min/max nits修改后通过display.minNits nits/display.maxNits nits持久化并触发nitsEditPublisher通知重算映射。源码中的插值映射Sync Mode 按 nits 同步时会将源显示器的 nits 映射到目标显示器的亮度百分比。相关映射定义于 Lunar/Data/Display.swiftfunc recomputeNitsMapping() { nitsToPercentageMapping Self.LUX_TO_NITS.sorted(by: { $0.key $1.key }).map { k, v in AutoLearnMapping(source: k, target: nitsToPercentage(v, minNits: minNits, maxNits: userMaxNits ?? maxNits) * 100) } }其中nitsToPercentage结合用户自定义的userMinNits/userMaxNits若未设置则回退到minNits/maxNits将 nits 转换为 0100 的亮度百分比。相关限制与边界条件仅 Apple Silicon本次修复标注为 Apple Silicon only。从源码看nits 相关的读取与显示逻辑大量使用#if arch(arm64)条件编译AppleNativeControl.swift 的updateNits()整体包裹于#if arch(arm64)。DisplayRowView.swift 的nitsText()同样仅在 arm64 下启用。Display.swift 中isUsingNits()分支也带#if arch(arm64)。因此Intel Mac 上 Sync Mode 仍按百分比0100同步nits 同步路径仅在 Apple Silicon 生效。禁用亮度观察器时的回退若disableBrightnessObservers为真设置见 DataStore.swiftLunar 无法通过系统回调监听亮度变化此时 Display.swift 的startBrightnessContrastRefreshers()会改用 2 秒间隔的Repeater轮询读取亮度Sync Mode 的同步仍可进行但响应存在延迟。合盖Clamshell模式的处理在 Clamshell 模式下Sync Mode 会自动切回 Manual Mode相关逻辑位于 DisplayController.swiftfunc disableAdaptiveInClamshellMode() { if adaptiveModeKey .sync { disabledAdaptiveInClamshellMode true disable() } }即检测到合盖时禁用 Sync Mode开盖后重新启用。如何验证与排查确认机型与模式仅 Apple Silicon MacMacBook Air / iMac在 Sync Mode 下生效。可查看 Lunar/Data/Display.swift 的isActiveSyncSource判断当前显示器是否为活动源。查看 nits 显示在 Sync Mode 下若修复生效显示行中会显示当前 nits 数值见 DisplayRowView.swift。调整 min/max nits通过 NitsTextField.swift 的弹窗自定义显示器的 min/max nits 值优化映射精度。检查设置确认syncNitsDataStore.swift为开启状态且未误开disableBrightnessObserversDataStore.swift。小结Lunar 6.7.11 通过让 Sync Mode 在 MacBook Air 与 iMacApple Silicon上正确走 nits 同步路径统一了内置屏与外接屏的亮度感知。nits 同步以 sdrBrightnessToNits 的 SDR 亮度曲线换算为基础配合syncNits开关、minNits/maxNits配置与 AutoLearnMapping 插值映射实现了更贴近人眼感知的跨屏亮度同步。赞分享桌面应用【免费下载链接】LunarIntelligent adaptive brightness for your external monitors项目地址https://gitcode.com/gh_mirrors/lu/Lunar点击查看免费下载相关推荐Lunar 6.7.5 技术解读Sync Mode 亮度同步平滑化、OSD 与 Full Range 稳定性修复Lunar 6.7.5 技术解读Sync Mode 亮度同步平滑化、OSD 与 Full Range 稳定性修复 本文以 Lunar 开源仓库的版本说明文档桌面应用Lunar 6.0.0 Beta 1 深度解析Apple Silicon EDID 修复、真实 Nits 同步模式与全新的 lunar edid 命令行Lunar 6.0.0 Beta 1 深度解析Apple Silicon EDID 修复、真实 Nits 同步模式与全新的 lunar edid 命令行 本篇桌面应用Lunar 5.9.3 修复解析无线传感器、Sync Mode 轮询、Apple 显示器亮度同步与快捷指令的八项源码级修复Lunar 5.9.3 修复解析无线传感器、Sync Mode 轮询、Apple 显示器亮度同步与快捷指令的八项源码级修复 Lunar 是一款为 macOS桌面应用上一篇GhostESP设备端OTA全解固件校验、回滚保护与SD卡更新背后的4重防护下一篇DGX Spark集群踩坑一次解决spark-vllm-docker故障排查与常见问题完整清单OOM、卡死、加载慢创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考