当前位置：首页 > news >正文

Windows-Auto-Night-Mode配置文件详解：理解JSON设置结构

news 2026/8/7 23:16:06

Windows-Auto-Night-Mode配置文件详解：理解JSON设置结构

配置文件核心结构概述

Windows-Auto-Night-Mode的配置系统基于JSON格式，其核心定义位于AutoDarkModeLib/Configs/AdmConfig.cs。该文件定义了应用程序的所有可配置参数，采用分层结构设计，主要包含全局开关、时间设置、组件配置和高级选项四大模块。配置文件加载时会被序列化为AdmConfig类实例，通过修改JSON文件或使用图形界面均可调整这些参数。

全局基础设置

自动切换总开关

{ "AutoThemeSwitchingEnabled": true, "Governor": "Default" }

AutoThemeSwitchingEnabled: 主开关，控制整个自动切换功能的启用状态
Governor: 切换策略选择，默认值为"Default"，可根据日出日落时间或自定义规则切换

时间配置模块

时间设置是自动切换的基础，相关代码定义如下：

public DateTime Sunrise { get; set; } = new DateTime(DateTime.Now.Year, DateTime.Now.Month, DateTime.Now.Day, 7, 0, 0); public DateTime Sunset { get; set; } = new DateTime(DateTime.Now.Year, DateTime.Now.Month, DateTime.Now.Day, 20, 0, 0);

对应的JSON结构：

{ "Sunrise": "0001-01-01T07:00:00", "Sunset": "0001-01-01T20:00:00", "Location": { "Enabled": true, "UseGeolocatorService": true, "SunsetOffsetMin": 0, "SunriseOffsetMin": 0, "CustomLat": 39.9042, "CustomLon": 116.4074 } }

Location.Enabled: 启用地理位置服务自动计算日出日落时间
CustomLat/Lon: 手动指定经纬度坐标，在禁用地理位置服务时生效
*OffsetMin: 时间偏移量，单位分钟，可微调日出日落时间

组件开关与配置

应用采用模块化设计，每个功能组件可独立启用和配置。所有组件配置均继承自BaseSettings或BaseSettingsEnabled泛型类，位于AutoDarkModeLib/ComponentSettings/目录下。

系统主题切换组件

{ "SystemSwitch": { "Enabled": true, "Settings": { "DarkThemePath": "C:\\Windows\\Resources\\Themes\\dark.theme", "LightThemePath": "C:\\Windows\\Resources\\Themes\\light.theme", "MonitorActiveTheme": true } } }

Enabled: 组件启用状态
DarkThemePath/LightThemePath: 自定义主题文件路径
MonitorActiveTheme: 监控系统主题变化并同步配置

壁纸切换组件

{ "WallpaperSwitch": { "Enabled": true, "Settings": { "DarkWallpaperPath": "C:\\Pictures\\wallpaper_dark.jpg", "LightWallpaperPath": "C:\\Pictures\\wallpaper_light.jpg", "Fit": "Fill" } } }

该组件允许为明暗模式分别设置不同壁纸，支持多种显示模式（填充、适应、拉伸等），相关实现可参考SwitchComponents/Base/WallpaperSwitch.cs。

其他核心组件

应用切换：AppsSwitchSettings控制特定应用的主题适配
光标切换：CursorSwitchSettings管理明暗模式下的光标样式
颜色调整：ColorizationSwitchSettings配置系统颜色方案

高级配置选项

性能优化设置

{ "GPUMonitoring": { "Enabled": true, "Threshold": 30, "Samples": 3 }, "ProcessBlockList": { "Enabled": true, "ProcessNames": ["Photoshop.exe", "PremierePro.exe"] } }

GPUMonitoring: 当GPU使用率超过阈值（默认30%）时暂停主题切换
ProcessBlockList: 进程黑名单，运行指定进程时暂停切换

通知与交互设置

{ "Notifications": { "OnAutoThemeSwitching": true, "OnSkipNextSwitch": true }, "AutoSwitchNotify": { "Enabled": true, "GracePeriodMinutes": 5 }, "Hotkeys": { "Enabled": true, "ForceLight": "Ctrl+Alt+L", "ForceDark": "Ctrl+Alt+D", "ToggleTheme": "Ctrl+Alt+T" } }