Initial GoWallpaper implementation

2026-07-31 21:25:56 +08:00
commit 1a4bb858f3
18 changed files with 1432 additions and 0 deletions
@@ -0,0 +1,69 @@
+# 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
+```
+
+缓存索引记录历史顺序和当前位置。程序退出后不会清空缓存。