告别分辨率烦恼：Moonlight流媒体分辨率自动匹配工具轻松上手指南

一、为什么需要分辨率自动化工具？

当你使用Moonlight进行游戏或桌面流媒体时，是否遇到过画面拉伸变形、模糊不清的问题？这通常是因为主机与客户端设备的分辨率不匹配造成的。特别是当你用手机、平板等移动设备连接电脑时，不同的屏幕比例往往让流媒体体验大打折扣。

ResolutionAutomation正是为解决这一痛点而生的工具。它就像一位"分辨率管家"，在你开始流媒体时自动调整主机分辨率，结束后又恢复原样，让你专注于内容本身，无需手动切换设置。

二、快速了解系统要求

使用前请确保你的设备满足以下条件：

• 操作系统：Windows系统（兼容Windows 10及以上版本）
• 流媒体服务：Sunshine 0.21.0或更高版本
• 权限要求：管理员权限（用于修改系统分辨率设置）

三、安装前的小准备

Windows 11用户特别设置

Windows 11的终端设置可能会影响脚本运行，需要简单调整：

1. 打开"设置 > 系统 > 开发者选项"
2. 找到"终端"设置区域
3. 将"默认终端应用程序"从"让Windows决定"改为"Windows控制台主机"
4. 关闭设置窗口，更改将自动生效

文件夹安置建议

这个工具对"住址"很敏感，建议：

• 选择一个你不会轻易移动的位置存放项目文件夹
• 避免放在桌面或"下载"文件夹（这些位置经常被清理）
• 如果确实需要移动文件夹，只需重新运行安装程序即可

四、三步完成安装与卸载

安装流程

1. 将下载的项目文件夹放在固定位置
2. 双击运行"Install.bat"文件
3. 当系统请求管理员权限时点击"是"

💡 提示：安装过程会自动配置Sunshine，无需手动干预

卸载流程

1. 找到项目文件夹
2. 双击运行"Uninstall.bat"
3. 等待脚本完成清理工作

五、工具如何工作？

想象ResolutionAutomation是一位智能助手，它的工作流程如下：

1. 启动阶段：当你通过Sunshine启动流媒体时，工具自动激活
2. 信息收集：读取客户端设备的分辨率、刷新率等信息
3. 调整阶段：将主机分辨率调整为与客户端匹配的最佳设置
4. 监控阶段：持续监测流媒体状态
5. 恢复阶段：当流媒体结束或暂停超过2分钟，恢复原始分辨率

六、个性化配置指南

基础设置（settings.json）

打开项目文件夹中的"settings.json"文件，可以自定义这些功能：

{
  "debugMode": false,      // true=启用详细日志，便于排障
  "gracePeriod": 120,      // 流媒体结束后的等待秒数（默认120秒）
  "startupDelay": 5        // 脚本启动延迟秒数（给系统准备时间）
}

首选分辨率设置

如果你希望流媒体结束后主机总是回到特定分辨率，可以这样配置：

"preferredResolution": {
  "width": 1920,           // 宽度像素
  "height": 1080,          // 高度像素
  "refresh": 60,           // 刷新率
  "enabled": true          // true=启用此功能
}

智能分辨率覆盖

针对不同设备设置不同分辨率，格式为"客户端分辨率=主机分辨率"：

"overrides": [
  "1280x720x60=1920x1080x60",  // 手机连接时提升主机分辨率
  "2560x1440x144=3840x2160x60"  // 高刷新率显示器降频以获得更高分辨率
]

七、解决常见问题

冷启动后无法工作？

这是Windows API的限制，解决方法很简单：

1. 先用Moonlight连接"桌面"应用
2. 正常结束会话
3. 重新连接需要的应用

分辨率不匹配？

确保：

• 客户端分辨率已添加到主机的显示设置中
• 使用NVIDIA控制面板或CRU工具添加自定义分辨率
• 重启电脑后再次尝试

安装后无反应？

检查：

• 文件夹是否被移动（重新安装即可）
• 是否以管理员权限运行安装程序
• Sunshine版本是否满足要求

八、高级功能探索

10位深度支持

对于HDR内容爱好者，可以尝试启用10位深度支持：

1. 确保已在Moonlight中启用HDR流媒体
2. 分辨率设置会自动调整刷新率以支持10位色彩
3. 这一功能特别适合观看HDR电影或玩支持HDR的游戏

九、使用场景示例

场景1：手机流媒体优化

当用手机（1080x2340）连接主机时：

"overrides": ["1080x2340x60=1920x1080x60"]

这样设置可以避免画面拉伸，同时保持清晰画质

场景2：低带宽环境

网络状况不佳时，降低主机分辨率以减少带宽占用：

"overrides": ["1920x1080x60=1280x720x30"]

场景3：超采样体验

高端显卡用户可以尝试超采样提升画质：

"overrides": ["1920x1080x60=3840x2160x60"]

让1080P的客户端享受4K渲染的画质细节

十、开始使用

1. 访问项目仓库获取最新版本
2. 按本文指南完成安装配置
3. 启动Moonlight体验自动分辨率匹配

从此告别手动调整分辨率的繁琐，让每一次流媒体体验都恰到好处！