d0a084b80e
Some checks failed
Build and Deploy (service.xpcool.com) / build-and-deploy (push) Failing after 28s
后台做完界面才发现的两个接口缺口： 1) 平台配置不回显 → 用户只改一个开关，defaultQuery / purity / baseUrl 会被一起清空（SaveSource 只对 apiKey/apiSecret 做了"留空即保留"）。 现在 Sources() 返回脱敏后的 config（凭据一律置空，是否已设置由 HasApiKey 表达），前台接口不下发该字段 —— toAPISource 加 withConfig 开关，公开接口没必要泄露自建反代地址等内部信息。 2) Item 缺 enabled / sort / remark → 后台列表无法显示启用状态， 编辑抽屉也拿不到当前值。补齐字段并在 library.toItem 中填充， 开源平台条目保持默认值（这三个字段对前台无意义）。 另抽出 sanitizeSourceConfig 统一处理凭据抹除，避免以后再加配置项时漏抹。
132 lines
5.9 KiB
Go
132 lines
5.9 KiB
Go
// Package dto 壁纸模块的数据传输对象。
|
||
//
|
||
// 设计要点：**把「开源平台」和「自建图库」两种来源统一成同一个输出形状
|
||
// （WallpaperItem）**，前端拿到的东西长得一模一样 —— 分页、渲染、下载、
|
||
// 全屏都只需要一套代码。来源差异只在后端消化。
|
||
package dto
|
||
|
||
// WallpaperItem 是壁纸模块对外的统一输出条目。
|
||
//
|
||
// 无论图片来自开源平台还是自建图库，都填这个结构：
|
||
// - FromOpen=true 时 Id 为平台内 id（用于下载上报），Url 指向平台 CDN；
|
||
// - FromOpen=false 时 Id 为库内主键，Url 指向本站 nginx 直出的原图。
|
||
type WallpaperItem struct {
|
||
// ---- 通用 ----
|
||
Id string `json:"id"`
|
||
Title string `json:"title"`
|
||
Width int `json:"width"`
|
||
Height int `json:"height"`
|
||
Orientation int `json:"orientation"` // 0未知 1横版 2竖版 3方形
|
||
// ---- 三档图片地址 ----
|
||
// Thumb 用于列表网格、Preview 用于全屏展示、Full 用于下载。
|
||
// 自建图库这三者分别是 480px 缩略图 / 长边 1920 预览图 / 原图；
|
||
// 开源平台则取各平台 CDN 提供的对应尺寸，没有的就退回上一档。
|
||
ThumbUrl string `json:"thumbUrl"`
|
||
PreviewUrl string `json:"previewUrl"`
|
||
FullUrl string `json:"fullUrl"`
|
||
// ---- 归属 ----
|
||
Source string `json:"source"` // 平台编码，自建图库固定为 "mine"
|
||
SourceName string `json:"sourceName"` // 平台显示名，用于界面标注
|
||
FromOpen bool `json:"fromOpen"` // true=开源平台 false=自建图库
|
||
// ---- 版权信息（自建图库留空）----
|
||
Author string `json:"author"`
|
||
AuthorUrl string `json:"authorUrl"`
|
||
PageUrl string `json:"pageUrl"` // 平台详情页，用于「查看原页面」
|
||
License string `json:"license"` // 许可说明，如 "Unsplash License"
|
||
// ---- 自建图库专有 ----
|
||
Tags string `json:"tags"`
|
||
Category string `json:"category"`
|
||
Filesize int64 `json:"filesize"`
|
||
// Enabled / Sort / Remark 只有自建图库有值（开源平台条目恒为默认值），
|
||
// 后台列表要显示启用状态并支持就地编辑，前台不关心这三个字段。
|
||
Enabled int `json:"enabled"`
|
||
Sort int `json:"sort"`
|
||
Remark string `json:"remark"`
|
||
CreatedAt string `json:"createdAt"`
|
||
}
|
||
|
||
// WallpaperSourceInfo 是开源平台的可用性描述，供前端渲染平台切换器。
|
||
//
|
||
// Enabled 与 Configured 要分开看：前者是用户的开关，后者是凭据是否齐备。
|
||
// 两者都为真时 Available 才为真 —— 前端据此把平台置灰并给出 Hint，
|
||
// 而不是点了没反应。
|
||
type WallpaperSourceInfo struct {
|
||
Code string `json:"code"`
|
||
Name string `json:"name"`
|
||
Enabled int `json:"enabled"`
|
||
Sort int `json:"sort"`
|
||
Configured bool `json:"configured"`
|
||
Available bool `json:"available"`
|
||
Hint string `json:"hint"` // 不可用原因，可用时为空
|
||
Remark string `json:"remark"`
|
||
// Config 是脱敏后的平台配置，供后台编辑界面回显。
|
||
// apiKey / apiSecret 一律置空不回传明文，是否已设置由 HasApiKey 表达；
|
||
// 界面上留空提交即表示「不修改已保存的 Key」。
|
||
// 前台接口不下发本字段（避免暴露自建反代地址等内部信息）。
|
||
Config *WallpaperSourceConfig `json:"config"`
|
||
// Config 是脱敏后的配置（apiKey 只回传是否已设置，不回传明文）。
|
||
HasApiKey bool `json:"hasApiKey"`
|
||
}
|
||
|
||
// WallpaperSourceConfig 对应 wallpaper_source.config 字段的 JSON。
|
||
//
|
||
// 全部字段可选：缺失即用该平台的默认值。解析失败不报错、回退全默认，
|
||
// 避免一个平台的脏配置拖垮整个来源列表。
|
||
type WallpaperSourceConfig struct {
|
||
// ApiKey / ApiSecret 平台凭据。Bing 与 Picsum 不需要。
|
||
ApiKey string `json:"apiKey"`
|
||
ApiSecret string `json:"apiSecret"`
|
||
// DefaultQuery 默认搜索词，用户没传关键词时用。
|
||
DefaultQuery string `json:"defaultQuery"`
|
||
// Purity 分级过滤（Wallhaven）：sfw / sketchy / nsfw。默认只放 sfw。
|
||
Purity string `json:"purity"`
|
||
// Categories 分类（Wallhaven）：general/anime/people 的组合，逗号分隔。
|
||
Categories string `json:"categories"`
|
||
// BaseUrl 可选覆盖平台接口地址（便于自建反代或走镜像）。
|
||
BaseUrl string `json:"baseUrl"`
|
||
}
|
||
|
||
// WallpaperSourceSaveInput 是后台保存开源平台配置的入参。
|
||
type WallpaperSourceSaveInput struct {
|
||
Code string `json:"code"`
|
||
Name string `json:"name"`
|
||
Enabled int `json:"enabled"`
|
||
Sort int `json:"sort"`
|
||
Remark string `json:"remark"`
|
||
// Config 是 dto.WallpaperSourceConfig 的 JSON 字符串。
|
||
// 其中 apiKey 允许留空 —— 留空表示「不修改已保存的 Key」，
|
||
// 这样后台就不必把密钥明文回传到前端再原样传回来。
|
||
Config string `json:"config"`
|
||
}
|
||
|
||
// WallpaperQuery 是列表查询条件，开源平台与自建图库共用。
|
||
type WallpaperQuery struct {
|
||
Source string // 平台编码；"mine" 表示自建图库
|
||
Query string // 搜索词（自建图库匹配标题/标签/分类）
|
||
Orientation int // 0不限 1横版 2竖版 3方形
|
||
Tag string // 标签（仅自建图库）
|
||
Page int
|
||
Size int
|
||
}
|
||
|
||
// WallpaperSaveInput 是后台编辑壁纸元数据的入参（不含文件本身）。
|
||
type WallpaperSaveInput struct {
|
||
Id uint64 `json:"id"`
|
||
Title string `json:"title"`
|
||
Tags string `json:"tags"`
|
||
Category string `json:"category"`
|
||
Enabled int `json:"enabled"`
|
||
Sort int `json:"sort"`
|
||
Remark string `json:"remark"`
|
||
}
|
||
|
||
// WallpaperStat 是图库概览统计。
|
||
type WallpaperStat struct {
|
||
Total int `json:"total"` // 总数
|
||
Enabled int `json:"enabled"` // 启用数
|
||
Disabled int `json:"disabled"` // 停用数
|
||
Portrait int `json:"portrait"` // 竖版数
|
||
Landscape int `json:"landscape"` // 横版数
|
||
TotalBytes int64 `json:"totalBytes"` // 原图占用字节
|
||
}
|