service.xpcool.com

xpcool/service.xpcool.com

Fork 0

Commit Graph

Author	SHA1	Message	Date
夏犀麟	d0a084b80e	feat(wallpaper): 平台配置脱敏回显 + 图库元字段补齐 Some checks failed Build and Deploy (service.xpcool.com) / build-and-deploy (push) Failing after 28s Details 后台做完界面才发现的两个接口缺口： 1) 平台配置不回显 → 用户只改一个开关，defaultQuery / purity / baseUrl 会被一起清空（SaveSource 只对 apiKey/apiSecret 做了"留空即保留"）。现在 Sources() 返回脱敏后的 config（凭据一律置空，是否已设置由 HasApiKey 表达），前台接口不下发该字段 —— toAPISource 加 withConfig 开关，公开接口没必要泄露自建反代地址等内部信息。 2) Item 缺 enabled / sort / remark → 后台列表无法显示启用状态，编辑抽屉也拿不到当前值。补齐字段并在 library.toItem 中填充，开源平台条目保持默认值（这三个字段对前台无意义）。另抽出 sanitizeSourceConfig 统一处理凭据抹除，避免以后再加配置项时漏抹。	2026-09-14 01:48:23 +08:00
夏犀麟	582485ba2b	feat(wallpaper): 壁纸模块后端（开源平台插件 + 自建图库 + 前后台接口）需求：前台壁纸站支持切换到开源壁纸平台，并能展示后台上传的自家图库，保留原有「浏览器实时生成」能力（扩展而非替换），PC / 移动双端一致。设计要点（受服务器 5M 出口带宽约束）： - 开源平台图片一律走官方 CDN 直链，后端只代理元数据，零带宽消耗。 - 自建图库落盘到 /data/www/wallpaper，由 nginx 的 /wallpaper/ 直出， Go 服务不参与传图；三档尺寸（480 缩略 / 1920 预览 / 原图仅供下载）。 - 内存缓存平台响应（Bing 1h、搜索类 10min），避免撞第三方配额。内容： - 平台插件：Bing 每日一图、Picsum、Unsplash、Pexels、Wallhaven。新增平台 = 写一个 provider_xxx.go 并在 allProviders() 加一行，刻意不用 init() 自注册，避免隐式副作用。所有适配器支持 config.baseUrl 覆盖，用于绕开 DNS 污染（实测 wallhaven.cc 解析到境外无关 IP）。 - 自建图库：上传（MD5 秒传去重 / 尺寸前置校验 / 失败清理孤儿文件）、元信息编辑、删除、统计；随机取图用「数总数 → 随机偏移」而非 ORDER BY RAND()。 - 接口：open 组 4 个（sources / list / random / download-track）， admin 组 8 个（list / upload / save / delete / stats / source.list\|save\|test）。全部 POST 且 URL 无参数，符合工作空间接口规范；上传走 multipart 例外。 - 安全：purity 默认锁死 SFW；apiKey 只回传布尔不回传明文；保存时留空表示保留旧值；open 组错误信息对外脱敏。 - 配置：clientMaxBodySize 提到 64M（gf 默认 8M 会截断 20MB 原图）； wallpaper.root / baseUrl 支持环境变量注入并在占位符未替换时兜底。依赖：golang.org/x/image@v0.23.0（仅用于缩略图缩放，保持 go 1.23.0 不变）。	2026-09-14 01:39:09 +08:00

Author

SHA1

Message

Date

夏犀麟

d0a084b80e

feat(wallpaper): 平台配置脱敏回显 + 图库元字段补齐

Build and Deploy (service.xpcool.com) / build-and-deploy (push) Failing after 28s

Details

后台做完界面才发现的两个接口缺口：

1) 平台配置不回显 → 用户只改一个开关，defaultQuery / purity / baseUrl
   会被一起清空（SaveSource 只对 apiKey/apiSecret 做了"留空即保留"）。
   现在 Sources() 返回脱敏后的 config（凭据一律置空，是否已设置由
   HasApiKey 表达），前台接口不下发该字段 —— toAPISource 加 withConfig
   开关，公开接口没必要泄露自建反代地址等内部信息。

2) Item 缺 enabled / sort / remark → 后台列表无法显示启用状态，
   编辑抽屉也拿不到当前值。补齐字段并在 library.toItem 中填充，
   开源平台条目保持默认值（这三个字段对前台无意义）。

另抽出 sanitizeSourceConfig 统一处理凭据抹除，避免以后再加配置项时漏抹。

2026-09-14 01:48:23 +08:00

夏犀麟

582485ba2b

feat(wallpaper): 壁纸模块后端（开源平台插件 + 自建图库 + 前后台接口）

需求：前台壁纸站支持切换到开源壁纸平台，并能展示后台上传的自家图库，
保留原有「浏览器实时生成」能力（扩展而非替换），PC / 移动双端一致。

设计要点（受服务器 5M 出口带宽约束）：
- 开源平台图片一律走官方 CDN 直链，后端只代理元数据，零带宽消耗。
- 自建图库落盘到 /data/www/wallpaper，由 nginx 的 /wallpaper/ 直出，
  Go 服务不参与传图；三档尺寸（480 缩略 / 1920 预览 / 原图仅供下载）。
- 内存缓存平台响应（Bing 1h、搜索类 10min），避免撞第三方配额。

内容：
- 平台插件：Bing 每日一图、Picsum、Unsplash、Pexels、Wallhaven。
  新增平台 = 写一个 provider_xxx.go 并在 allProviders() 加一行，
  刻意不用 init() 自注册，避免隐式副作用。所有适配器支持 config.baseUrl
  覆盖，用于绕开 DNS 污染（实测 wallhaven.cc 解析到境外无关 IP）。
- 自建图库：上传（MD5 秒传去重 / 尺寸前置校验 / 失败清理孤儿文件）、
  元信息编辑、删除、统计；随机取图用「数总数 → 随机偏移」而非 ORDER BY RAND()。
- 接口：open 组 4 个（sources / list / random / download-track），
  admin 组 8 个（list / upload / save / delete / stats / source.list|save|test）。
  全部 POST 且 URL 无参数，符合工作空间接口规范；上传走 multipart 例外。
- 安全：purity 默认锁死 SFW；apiKey 只回传布尔不回传明文；
  保存时留空表示保留旧值；open 组错误信息对外脱敏。
- 配置：clientMaxBodySize 提到 64M（gf 默认 8M 会截断 20MB 原图）；
  wallpaper.root / baseUrl 支持环境变量注入并在占位符未替换时兜底。

依赖：golang.org/x/image@v0.23.0（仅用于缩略图缩放，保持 go 1.23.0 不变）。

2026-09-14 01:39:09 +08:00

2 Commits