PowerToys MouseJump 的 DSC 配置模块用声明式配置管理激活快捷键与屏幕缩略预览【免费下载链接】PowerToysMicrosoft PowerToys is a collection of utilities that supercharge productivity and customization on Windows项目地址: https://gitcode.com/GitHub_Trending/po/PowerToys本文基于 PowerToys 仓库中的 DSC 模块参考文档 MouseJump.md系统讲解Microsoft.PowerToys/MouseJumpSettings这一 DSC v3 配置资源的两个核心属性ActivationShortcut与ThumbnailSize、三种典型配置方式PowerShell 直连PowerToys.DSC.exe、dsc config set、winget configure并结合 SettingsResource.cs、MouseJumpProperties.cs 等源码说明配置项在系统内真实的落地形式与默认值来源。读完后你可以将 Mouse Jump 的快捷键与缩略图策略纳入自动化部署脚本DSC / WinGet 配置文档实现对大屏或多显示器环境的批量配置。一、模块定位Mouse Jump 是什么DSC 资源做什么Mouse Jump 是 PowerToys 中的鼠标辅助工具激活后会显示所有显示器的微型缩略预览你可以把鼠标光标快速跳转到预览中的任意位置。这在单台超大显示器或多显示器环境下尤其有用——原本需要长距离拖动鼠标的操作可以一步完成。PowerToys 的 DSC 层为这类设置提供了程序化入口。MouseJumpDSC 模块的职责是管理 Mouse Jump 的配置状态文档的 Synopsis 概括为Manages configuration for the Mouse Jump utility, which enables quick navigation across large or multiple displays.在 DSC v3 体系中该模块暴露的资源类型为Microsoft.PowerToys/MouseJumpSettings。从源码结构看SettingsResource.cs 中明确登记了模块映射{ nameof(ModuleType.MouseJump), CreateModuleFunctionDataMouseJumpSettings },也就是说所有针对--module MouseJump的get/set/test/export操作最终都路由到MouseJumpSettings这个设置模型上由它负责读写 PowerToys 的模块配置settings.json中MouseJump节点。二、可配置属性详解文档定义了MouseJump模块支持的两个可配置属性ActivationShortcut激活快捷键与ThumbnailSize缩略图大小。两者的结构、默认值如下。2.1 ActivationShortcut激活快捷键设置 Mouse Jump 的激活键盘快捷键。类型object属性字段类型说明winbooleanWindows 键修饰符ctrlbooleanCtrl 键修饰符altbooleanAlt 键修饰符shiftbooleanShift 键修饰符codeinteger虚拟键码Virtual key codekeystring键名默认值WinShiftD这个默认值可以直接在源码中得到印证。MouseJumpProperties.cs 中定义了[CmdConfigureIgnore] public HotkeySettings DefaultActivationShortcut new HotkeySettings(true, false, false, true, 0x44);构造函数参数依次对应wintrue, ctrlfalse, altfalse, shifttrue虚拟键码0x44即字母D——恰好就是文档声明的默认值WinShiftD。同时MouseJumpSettings.cs 中通过GetAllHotkeyAccessors()把该快捷键暴露为唯一的热键访问器并带有回退逻辑当设置为空时取DefaultActivationShortcut即WinShiftD作为兜底保证快捷键始终有效new HotkeyAccessor( () Properties.ActivationShortcut, value Properties.ActivationShortcut value ?? Properties.DefaultActivationShortcut, MouseUtils_MouseJump_ActivationShortcut),这意味着通过 DSC 修改ActivationShortcut后设置界面与快捷键注册逻辑都会读取同一份数据不会出现配置改了但 UI 不变的分裂状态。2.2 ThumbnailSize缩略预览大小设置屏幕缩略预览图的大小。类型string允许值值效果small更小的缩略图性能表现更好medium大小与性能平衡large更大的缩略图可视性更好默认值medium需要结合当前仓库源码说明一个实现细节在 MouseJumpThumbnailSize.cs 中thumbnail_size实际被序列化为一个{width, height}的对象默认尺寸为1600x1200并支持1600x1200这类宽x高的命令行表示形式public MouseJumpThumbnailSize() { Width 1600; Height 1200; }从源码结构看文档中的small/medium/large是对应预设档位最终写入配置文件的是具体的宽高数值medium档位与默认对象初始化后的尺寸相对应。因此在使用 DSC 配置时可以按文档使用档位字符串若直接编辑原始settings.json则看到的是thumbnail_size: { width, height }形式的数值。三、三种配置方式与完整示例文档给出了五组示例覆盖了三类调用方式。以下完整保留其形态并补充解读。3.1 方式一PowerShell 直连PowerToys.DSC.exe直接执行适用于已经安装 PowerToys、希望就地修改配置的场景。核心流程是构造 PowerShell 哈希表 →ConvertTo-Json压缩为 JSON → 通过--input传入PowerToys.DSC.exe set。示例 1修改激活快捷键$config { settings { properties { ActivationShortcut { win $true ctrl $false alt $false shift $true code 68 key D } } name MouseJump version 1.0 } } | ConvertTo-Json -Depth 10 -Compress PowerToys.DSC.exe set --resource settings --module MouseJump --input $config注意几点code 68是D的十进制虚拟键码0x44 68与key D冗余表达同一个键命令参数--resource settings与 SettingsResource.cs 中的ResourceName settings常量一致--module MouseJump对应ModuleType.MouseJumpset操作的执行语义在源码中有明确定义SetState 会先读取当前状态、计算差异diff只有当期望状态与当前状态不一致时才会真正写入并输出写入后的完整状态与 diff JSON。示例 5为大型 / 高 DPI 显示器配置大缩略图$config { settings { properties { ThumbnailSize large } name MouseJump version 1.0 } } | ConvertTo-Json -Depth 10 -Compress PowerToys.DSC.exe set --resource settings --module MouseJump --input $config一个值得注意的版本细节文档示例中均使用version 1.0而 MouseJumpSettings.cs 的UpgradeSettingsConfiguration()会把1.0配置自动升级到1.1——1.1版本新增了预览样式相关字段preview_type、background_color_1/2、border_thickness、border_color、border_3d_depth、border_padding、bezel_thickness、bezel_color、bezel_3d_depth、screen_margin、screen_color_1/2默认采用 Bezelled带边框样式。因此用1.0提交配置是安全的系统会自动补齐新字段的默认值并回写版本号无需在 DSC 文档中显式写出这些样式字段。3.2 方式二dsc config set DSC v3 配置文档YAML适用于把配置纳入 DSC 声明式工作流、可版本化管理的场景。命令统一为dsc config set --file 文件文档遵循 DSC v3 的document.jsonschema。示例 2设置较大缩略图dsc config set --file mousejump-size.dsc.yaml# mousejump-size.dsc.yaml $schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json resources: - name: Configure Mouse Jump thumbnail type: Microsoft.PowerToys/MouseJumpSettings properties: settings: properties: ThumbnailSize: large name: MouseJump version: 1.0示例 4性能优先配置小缩略图dsc config set --file mousejump-performance.dsc.yaml# mousejump-performance.dsc.yaml $schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json resources: - name: Performance-optimized Mouse Jump type: Microsoft.PowerToys/MouseJumpSettings properties: settings: properties: ThumbnailSize: small name: MouseJump version: 1.0两个 YAML 文档结构一致差异仅在ThumbnailSize的档位large追求可视性small追求性能可按硬件条件取舍。3.3 方式三winget configure一站式安装 配置适用于全新机器批量部署同一个 WinGet 配置文档里先安装 PowerToys再应用 Mouse Jump 配置。示例 3安装并配置winget configure winget-mousejump.yaml# winget-mousejump.yaml $schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2023/08/config/document.json metadata: winget: processor: dscv3 resources: - name: Install PowerToys type: Microsoft.WinGet.DSC/WinGetPackage properties: id: Microsoft.PowerToys source: winget - name: Configure Mouse Jump type: Microsoft.PowerToys/MouseJumpSettings properties: settings: properties: ThumbnailSize: medium name: MouseJump version: 1.0关键点在于metadata.winget.processor: dscv3——它告诉 WinGet 配置处理器把Microsoft.PowerToys/*类型的资源交给 DSC v3 协议执行第一个WinGetPackage资源负责安装包第二个MouseJumpSettings资源在包就绪后生效。DSC 资源的方法绑定set/test带--input、get/export走 stdin、schema输出 JSON Schema可以从 SettingsResource.cs 的GenerateManifest中直接看到set与test均声明了stateAndDiff: true即执行后同时返回状态与差异结果。四、典型使用场景文档归纳了两类典型部署场景均只调整ThumbnailSize档位。4.1 多显示器工作站跨多台显示器高效导航时使用平衡档mediumresources: - name: Multi-monitor configuration type: Microsoft.PowerToys/MouseJumpSettings properties: settings: properties: ThumbnailSize: medium name: MouseJump version: 1.04.2 大型显示器超宽屏或 4K 显示器上用large让缩略预览更容易看清目标位置resources: - name: Large display configuration type: Microsoft.PowerToys/MouseJumpSettings properties: settings: properties: ThumbnailSize: large name: MouseJump version: 1.0这两段片段可以原样并入 3.2 节或 3.3 节的配置文档中作为多显示器 / 大屏机型的策略模板。五、适用前提与限制结合仓库现状使用本文配置方式时需注意资源归属MouseJump 的设置通过settings资源按--module MouseJump寻址对应 SettingsResource.cs 中的ResourceName settings常量DSC 文档中的资源类型则写作Microsoft.PowerToys/MouseJumpSettings两者是同一入口的 CLI 形态与 DSC v3 文档形态配置版本提交version: 1.0即可1.1的预览样式字段边框、边框条、屏幕填充色等会在升级逻辑中自动补齐默认值见 UpgradeSettingsConfiguration不支持的模块对照SettingsResource.cs 的注释列出了刻意排除在 DSC 管理之外的模块MouseWithoutBorders、PowerLauncher、NewPlusMouseJump 不在其中其配置可安全地导出/导入生效验证set/test操作会在输出中回显最终状态与 diff JSON可用test命令在部署后校验实际状态是否与期望文档一致。六、相关文档Settings Resourcesettings 资源总览PowerToys DSC OverviewDSC 集成总览FindMyMouse 模块同为鼠标定位辅助工具实现代码可进一步查阅DSC settings 资源、MouseJump 设置模型、MouseJump 属性定义、缩略图尺寸模型以及设置界面中的 MouseJumpPanel.xaml。【免费下载链接】PowerToysMicrosoft PowerToys is a collection of utilities that supercharge productivity and customization on Windows项目地址: https://gitcode.com/GitHub_Trending/po/PowerToys创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考