壁纸更换器
从 HTTP API 自动拉取壁纸并设置为 Windows 桌面背景，支持托盘常驻和桌面右键菜单。
功能
- 托盘程序常驻，右键菜单手动/自动刷新壁纸
- 桌面右键菜单「刷新壁纸」一键更换
- 支持 API 直接返回图片二进制或 JSON 含图片 URL 两种模式
- 可配置填充方式（填充/适应/拉伸/平铺/居中）
- 可配置缓存目录及最大缓存数量
- 可开关换壁纸后气泡通知
- 单实例运行，重复启动弹窗提示
- 首次运行自动创建配置和目录
使用
# 运行托盘程序
python main.py
# 右键菜单刷新
python main.py --refresh
# 安装桌面右键菜单（首次需要，从托盘菜单操作）
右键托盘 → 安装右键菜单
编译为 .exe
使用 Nuitka 打包：
powershell -ExecutionPolicy Bypass -File build.ps1
产物：dist/WallpaperChanger.dist/WallpaperChanger.exe（独立目录模式，含 exe + 依赖库）
- 双击运行 → 启动托盘
WallpaperChanger.exe --refresh→ 拉取并设置壁纸后退出（右键菜单用）- 首次运行在同目录下自动创建
config.json、cache/、logs/、assets/
配置
config.json 字段说明：
| 路径 | 类型 | 默认值 | 说明 |
|---|---|---|---|
api.url |
string | — | 壁纸 API 地址 |
api.mode |
string | direct |
direct 返回图片二进制 / json 返回 JSON |
api.json_image_field |
string | url |
JSON 模式下图片 URL 的字段名 |
api.timeout |
int | 30 |
请求超时秒数 |
wallpaper.fill_style |
string | fill |
fill/fit/stretch/tile/center |
wallpaper.cache_dir |
string | ./cache |
壁纸缓存目录 |
wallpaper.max_cache_files |
int | 10 |
最大缓存文件数 |
wallpaper.show_notification |
bool | true |
换壁纸后是否弹气泡通知 |
auto_refresh.enabled |
bool | false |
是否开启定时自动刷新 |
auto_refresh.interval_minutes |
int | 10 |
自动刷新间隔分钟数 |
依赖
- Python 3.12+
- requests, pystray, Pillow