1.3.9 是原生架构重建前最后一个版本。 当前候选版重点改进设置界面、输入、连接与 Foundation Sunshine 协作；完整变更和已知限制见 1.3.9 RC2 更新说明。

• 设置支持搜索具体选项；剪贴板同步入口位于 设置 → 串流 → 剪贴板。
• 视频设置提供独立的 10-bit SDR 选项；Metal 专用调节仅在选择 Metal 渲染器时显示。
• DualSense 提供远端触控板和 Mac 风格模式，支持长按 Options 切换；支持轻点、自然滚动和双指手势。
• 关于与更新页接入 Sparkle，采用 GitHub 优先、同版本 CNB 下载镜像回退；测试版使用独立更新渠道。
• USB 转发、主机文件和动态 HDR 的可用范围与限制以更新说明为准，需要对应的系统、硬件和主机配置支持。

• 原生 macOS 客户端 — AppKit / SwiftUI 界面、Apple Silicon / Intel 双支持、深色模式与双语界面
• 完整串流能力 — 自定义分辨率与帧率、AV1 / HEVC / H.264 解码、HDR、10-bit SDR、YUV 4:4:4、MetalFX / VT 增强与自动码率
• 多渲染链路 — 提供 原生渲染器、Metal 渲染器 与 兼容渲染器；原生渲染器 为默认推荐选项，Metal 渲染器 提供更深的 HDR / 色彩调节
• 剪贴板支持 — 配合 Foundation Sunshine，支持文本与单张图片的双向复制粘贴，并按串流窗口焦点自动接管当前会话
• 输入与控制增强 — 支持以 CoreHID 为核心的低延迟、高回报率鼠标输入链路，带来更直接、更细腻的相对移动响应；自由鼠标模式可无缝切换到其他屏幕继续操作，锁定鼠标模式更适合游戏与持续相对移动场景，并提供可自定义串流快捷键与手柄增强
• DualSense / DS5 — 按键、摇杆、扳机、震动、灯光、电量与动作输入，以及主机触控板 / Mac 风格触控板两种模式
• 视音频体验升级 — 采用更低延迟的 Core Audio 本地播放链路，支持多通道接收与播放，以及客户端侧音效增强、EQ 调节与麦克风链路增强
• 连接与稳定性 — 每台主机独立连接方式、自定义端口 / IPv6 / 域名、性能浮窗、诊断日志、AWDL 稳定性辅助

💡 麦克风、YUV 4:4:4、部分输入与音频增强能力更适合配合 Foundation Sunshine 使用。

1.3.9 RC2 为预发布版本，请从发布页手动下载安装；应用内自动更新渠道正在部署。

• 从 Releases 下载最新版本
• 发布页提供三种安装包：universal、arm64、x86_64
• 如果你不清楚它们之间的区别，默认推荐下载 universal

以下截图来自 1.3.8；1.3.9 的设置页面已重新设计。

主机列表	应用列表

性能浮窗	连接管理

串流中遮罩	连接错误

视频设置	串流设置

• 支持自定义分辨率、帧率、远端分辨率与远端帧率覆盖
• 视频协商覆盖 AV1 / HEVC / H.264、HDR、YUV 4:4:4 与自动码率调节
• 提供 原生渲染器 / Metal 渲染器 / 兼容渲染器 三条视频呈现链路
• 原生渲染器 面向最低延迟与最高默认色准；Metal 渲染器 面向更深的 HDR 与色彩调节；兼容渲染器 面向旧系统和异常恢复

• 设置 → 视频 → 10-bit SDR 可独立请求 10-bit SDR，不需要通过开启 HDR 间接请求；主机与解码器需支持相应 10-bit 格式
• macOS 上 HDR10+ 支持受限：当前公共 API 和呈现链路不能保证完整保留动态元数据，可能使用基础 HDR 输出
• Dolby Vision 8.1/8.4 提供能力探测、适配与安全回退，最终输出受系统、硬件和显示链路约束；HDR Vivid 当前不可用
• HDR 传输函数支持 HLG / PQ / Auto，并提供更贴近当前显示器的客户端侧 HDR 呈现策略
• Metal 渲染器 支持 HDR 元数据来源、本机显示器 HDR 配置、亮度参数、光学输出倍率、HLG 观看环境、EDR 策略与色调映射策略
• 画质增强链路支持 VT 低延迟超分、VT 高质量超分、MetalFX 与 基础缩放
• VT 低延迟插帧 也已接入到 Metal 视频链路中，用于高刷新率显示器下的画面节奏增强

• 默认音频链路使用更贴近 Core Audio 的低延迟本地播放路径
• 支持 2ch / 5.1 / 7.1 / 7.1.4 多通道音频接收、协商与本地播放
• 当输出设备本身支持多通道时，优先保留真实多通道播放；当输出设备为耳机或 2.0 / 2.1 音箱时，可切换 音效增强
• 音效增强 面向耳机与立体声设备提供客户端侧 EQ、空间感、音场与预设调节
• 配合支持相关能力的 Foundation Sunshine 时，可使用增强后的麦克风 uplink 与更完整的多通道协商路径

• 鼠标模式默认：自由鼠标
• 鼠标驱动默认：Automatic
• Automatic 顺序：CoreHID → HID → MFI

• 锁定鼠标：更适合游戏、FPS、需要持续相对移动的场景
• 自由鼠标：更适合远控、多屏切换与桌面应用操作，可无缝切换到其他显示器继续使用

• CoreHID 负责更低延迟、更高回报率的相对鼠标输入体验，让鼠标操作更直接、更细腻，也更适合追求灵敏度与稳定操控的场景
• 支持本地光标、指针速度、左右键交换、反转滚动与 CoreHID 报告率上限
• 滚轮链路按来源拆分为 物理滚轮、改写 / 平滑滚轮 与 触控板 三类独立策略
• 物理滚轮支持自动、高精度、分段等模式，并可独立调节距离、速度与尾迹过滤

• 键盘链路支持常用 Windows 快捷键翻译、自定义快捷键翻译规则与 Moonlight 自定义串流快捷键
• 手柄链路支持多手柄、震动、Guide 模拟与手柄模拟鼠标
• 鼠标、键盘、手柄设置页已经按使用场景重整，常用输入选项更集中

DS5 可通过蓝牙或 USB 连接 Mac，由客户端向支持相应能力的 Foundation Sunshine 发送输入并接收反馈。

在 设置 → 控制器 选择 DualSense 触控板模式。开启 长按 Options 切换触控板模式 后，串流中长按 DS5 的 Options 键约 2 秒，即可在两种触控板模式之间切换。游戏按键、摇杆和扳机继续作为手柄输入。

主机还需支持 PlayStation 虚拟控制器及对应反馈能力。蓝牙、USB 和不同主机版本的增强触觉效果可能不同；普通手柄输入不要求启用 USB 映射。

以下 Moonlight 自定义串流快捷键支持在 设置 → 键盘与鼠标 中调整：

💡 这里列的是 Moonlight 自定义串流快捷键；标准 macOS 快捷键如 ⌘W、⌃⌘F 不在此表内。

在 设置 → 串流 → 剪贴板 开启同步，并在 Foundation Sunshine 主机端启用剪贴板。支持文本与单张 PNG 图片的双向复制粘贴；当前前台串流窗口接管同步会话。该功能不等同于文件传输。

设置 → 显示与 HDR 提供目标显示器、虚拟显示器（VDD）、屏幕模式和显示参数。可按应用保存显示配置，连接或重连时交给 Foundation Sunshine 应用；VDD 需要主机驱动及对应能力已启用。

• 设置 → USB 映射 将所选本机 USB 设备转发给主机，串流停止时释放转发；主机必须支持并启用 USB 转发。
• 设置 → 主机文件 访问 Foundation Sunshine 共享的远端目录，当前为只读。Finder 挂载要求支持相应 App Group 的签名版本。
• 这些入口会展示主机能力及不可用原因。USB 映射和主机文件属于实验性能力，具体可用范围以主机与系统条件为准。

设置 → 应用与诊断 提供性能数据与报告导出，可查看接收、解码、呈现帧率、1% low、网络和帧呈现抖动、丢帧及音频欠载。

• 每台主机支持独立连接方式管理
• 支持自定义端口、IPv6 与域名连接
• 提供性能浮窗、连接警告与输入诊断
• 同时提供原始日志与浓缩日志，便于排障
• 提供 AWDL 稳定性辅助项、自动重连与超时恢复能力

设置 → 关于与更新 展示应用版本并提供检查更新入口。更新优先使用 GitHub，下载失败时可尝试同版本的 CNB 镜像，并由 Sparkle 验证更新包签名。

当前 1.3.9 RC2 请从发布页手动下载安装，应用内更新源正在部署。测试版更新渠道与稳定版分开。

从 Releases 下载最新 .dmg。

⚠️ 此应用当前未做 Apple 公证。若 macOS 提示“MoonlightEnhanced.app 已损坏”或阻止打开，通常是 Gatekeeper 拦截未公证应用，并不一定代表文件真的损坏。

首次启动建议按这个顺序尝试：

1. 右键应用，选择“打开”
2. 前往 系统设置 → 隐私与安全性，选择“仍要打开”
3. 若仍被拦截，执行： xattr -dr com.apple.quarantine /Applications/MoonlightEnhanced.app

git clone --recursive https://github.com/skyhua0224/moonlight-macos-enhanced.git
cd moonlight-macos-enhanced

curl -L -o xcframeworks.zip "https://github.com/coofdy/moonlight-mobile-deps/releases/download/latest/moonlight-apple-xcframeworks.zip"
unzip -o xcframeworks.zip -d xcframeworks/

然后：

1. 用 Xcode 打开 Moonlight.xcodeproj
2. 在 Signing & Capabilities 中改成你自己的 Team
3. 按需修改 Bundle Identifier
4. 选择 Moonlight for macOS scheme 后运行

提交 Bug 时建议包含：

• macOS 版本
• 机型 / 芯片类型
• 主机端软件及版本
• 是否使用了 Mos、BetterMouse、SteerMouse 等第三方鼠标工具
• 复现步骤
• 日志或截图

若是输入 / 滚轮 / 鼠标问题，建议附带：

• 设置 → App → Debug Log 导出的日志
• 你使用的是 自由鼠标 还是 锁定鼠标
• 你使用的是 Automatic / CoreHID / HID / MFI 中哪条路径

欢迎提交 Issue 和 PR。建议：

• 保持中英文用户文案同步
• 提交前至少验证核心串流与输入路径
• PR 描述优先写用户可感知变化，而不是只贴 commit 标题

• 📧 Email: dev@sky-hua.xyz
• 💬 Telegram: @skyhua
• 🐧 QQ: 2110591491
• 🔗 GitHub Issues: 提交 Issue

完整致谢、上游来源与生态参考请见 ACKNOWLEDGEMENTS.md。

• 直接代码基础：moonlight-macos、moonlight-ios、moonlight-common-c
• 功能与行为参考：moonlight-qt、qiin2333/moonlight-qt
• 主机端生态参考：Sunshine、foundation-sunshine
• 输入与滚轮体验参考：Mos、Mouser

本项目采用 GPLv3 许可证。