70 lines
2.1 KiB
Markdown
70 lines
2.1 KiB
Markdown
# GoWallpaper
|
||
|
||
GoWallpaper 是一个仅面向 Windows 的轻量托盘壁纸切换工具。它通过 HTTP GET 请求随机图片 API，将响应图片缓存到程序同目录，并支持手动刷新、定时刷新以及缓存历史前后切换。
|
||
|
||
## 功能
|
||
|
||
- 启动后隐藏到 Windows 托盘并显示运行提示
|
||
- 托盘菜单手动刷新壁纸
|
||
- 上一张、下一张缓存壁纸
|
||
- 可开关并自定义间隔的自动切换
|
||
- 可配置最大缓存数量
|
||
- 保持系统壁纸样式，或选择填充、适应、拉伸、平铺、居中、跨区
|
||
- 当前用户开机自动启动
|
||
- 命名互斥体阻止多开
|
||
- 首次运行自动创建 `config.json` 和 `cache` 目录
|
||
|
||
## API 要求
|
||
|
||
API 必须支持公开的 HTTP GET 请求，并直接在响应体中返回 JPEG、PNG、GIF 或 WebP 图片。程序允许标准 HTTP 重定向，单张图片最大 50 MB。
|
||
|
||
首次运行时 API 地址为空，程序会自动打开设置窗口。也可以退出程序后直接编辑同目录下的 `config.json`：
|
||
|
||
```json
|
||
{
|
||
"api_url": "https://example.com/random-image",
|
||
"auto_change_enabled": false,
|
||
"interval_minutes": 30,
|
||
"max_cache_count": 10,
|
||
"wallpaper_style": "keep",
|
||
"start_with_windows": false
|
||
}
|
||
```
|
||
|
||
`wallpaper_style` 可使用 `keep`、`fill`、`fit`、`stretch`、`tile`、`center` 或 `span`。
|
||
|
||
## 构建
|
||
|
||
需要 Go 1.25 或兼容版本，以及 `rsrc`：
|
||
|
||
```powershell
|
||
go install github.com/akavel/rsrc@latest
|
||
```
|
||
|
||
项目统一通过 `build.ps1` 执行格式化、测试和构建，禁止绕过脚本直接执行编译命令：
|
||
|
||
```powershell
|
||
# 格式化、测试并构建 dist/GoWallpaper.exe
|
||
.\build.ps1
|
||
|
||
# 仅格式化和测试
|
||
.\build.ps1 -TestOnly
|
||
|
||
# 清理构建产物
|
||
.\build.ps1 -Clean
|
||
```
|
||
|
||
构建完成后请将 `GoWallpaper.exe` 放在普通可写目录中运行。由于配置及缓存严格保存在程序同目录，不建议放入 `Program Files` 等通常需要管理员权限的目录。
|
||
|
||
## 运行文件
|
||
|
||
```text
|
||
GoWallpaper.exe
|
||
config.json
|
||
cache/
|
||
index.json
|
||
20260731_120000_000000000.jpg
|
||
```
|
||
|
||
缓存索引记录历史顺序和当前位置。程序退出后不会清空缓存。
|