ResolutionAutomation：跨设备分辨率智能适配工具完全指南

2026-04-07 11:55:34作者：咎竹峻Karen

1. 核心价值：突破设备差异的流媒体体验优化器

解决多设备分辨率适配难题，实现主机与客户端显示参数无缝同步。

ResolutionAutomation作为Moonlight流媒体用户的专用工具，核心价值在于消除不同设备间的显示差异。当客户端与主机显示器宽高比不同时，传统流媒体会出现画面拉伸或黑边问题，而该工具通过实时调整主机分辨率，确保画面始终以最佳比例呈现。超采样功能（像给低清图片智能补像素）则进一步提升画质，使小屏设备也能享受高清细节。

2. 环境配置指南：构建稳定运行基础

确保系统环境满足工具运行条件，完成必要的前置设置。

2.1 系统兼容要求

操作系统：Windows 10/11 64位版本
Sunshine服务：0.21.0或更高版本（需通过官方渠道验证版本兼容性）

2.2 终端环境配置

🔧 打开设置 > 系统 > 开发者选项 > 终端 🔧 将"默认终端应用程序"从"让Windows决定"改为"Windows控制台主机" 🔧 重启所有终端窗口使设置生效

⚠️ Windows 11用户必须执行此步骤，否则会出现隐藏控制台导致脚本失效的问题。

2.3 项目部署规范

🔧 下载项目到固定目录（建议路径：C:\Program Files\ResolutionAutomation） 🔧 右键解压文件夹，确保文件夹名称不含中文和特殊字符 🔧 验证文件夹权限：右键属性 > 安全 > 确认当前用户有读写权限

3. 操作流程：3步实现无缝流媒体体验

从安装到使用的完整流程，确保工具正确集成到流媒体工作流。

3.1 安装部署

🔧 双击运行Install.bat，同意用户账户控制提示 🔧 等待命令行窗口显示"安装完成"提示 🔧 验证Sunshine服务已自动重启（可在服务管理器中确认）

3.2 启动使用

🔧 在Moonlight客户端选择任意应用启动流媒体 🔧 工具将自动激活并调整主机分辨率 🔧 结束流媒体后，系统会在120秒内恢复原始显示设置

3.3 卸载清理

🔧 双击运行Uninstall.bat 🔧 确认删除注册表项和服务配置 🔧 重启电脑完成残留文件清理

4. 工作原理：5阶段自动化流程解析

触发启动 → 当Sunshine检测到流媒体请求时激活脚本
信息采集 → 读取客户端分辨率、刷新率等环境变量
决策判断 → 比对overrides.txt规则决定是否应用分辨率转换
执行调整 → 通过Windows API修改显示设置（包含刷新率适配）
恢复机制 → 监控流媒体状态，超时无活动则还原原始配置

5. 深度定制：从基础配置到高级策略

根据使用场景调整工具行为，满足个性化需求。

5.1 基础参数配置

settings.json核心配置项：

{
  "debugMode": false,          // 错误时设为true启用详细日志
  "gracePeriod": 120,          // 单位：秒，范围5-300
  "startupDelay": 5,           // 单位：秒，建议3-10
  "preferredResolution": {
    "width": 1920,
    "height": 1080,
    "refresh": 60,
    "enabled": false           // true时优先使用此分辨率
  }
}

错误配置对比：

// 错误示例：refresh值超出显示器支持范围
{
  "preferredResolution": {
    "width": 1920,
    "height": 1080,
    "refresh": 144,            // 若显示器仅支持60Hz会导致设置失败
    "enabled": true
  }
}