- 全项目版本号统一：v3.x 迭代号（26.9/26.9/26.9/26.9 及裸 v2/v3）→ 26.9， 覆盖 Go 注释 / 文档 / openapi.yaml / README×4 / 前端源码（80+ 处） - v31_test.go 更名 custom_code_test.go；TestV2AccessorDefaults → TestKVAccessorDefaults - docs/api/00-overview.md 更新日志合并为单条 26.9 条目（修复错位拼接） - .goreleaser.yaml 头部注释与实际一致（Pro 2.18.1 / GITEA_TOKEN / semver tag 要求） - CI：release-image.yml → ci.yml，仅保留 vet+test 门禁； 镜像发布移交 GoReleaser Pro（原 build-push 的 tag 校验与 26.9 版本方案冲突，历史 9 次失败） - 前端重建：server/web/dist 与 web-embed 同步（docs 文案嵌入更新）
This commit is contained in:
@@ -28,7 +28,7 @@ const (
|
||||
)
|
||||
|
||||
// DefaultLogoURL / DefaultFaviconURL 默认 Logo 与 favicon（需求 ⑤）：
|
||||
// v2 起默认改用前端打包的本地资源（web/src/assets/brand/logo.svg + favicon.png，
|
||||
// 26.9 起默认改用前端打包的本地资源（web/src/assets/brand/logo.svg + favicon.png，
|
||||
// 经 Vite 产出 /assets/logo-*.svg 与 /assets/favicon-*.png）。此处留空，
|
||||
// GET /api/v1/config 下发空值时前端 displayLogoUrl/displayFaviconUrl 回落到本地打包资源；
|
||||
// 管理端仍可设置任意 URL 全站替换。
|
||||
@@ -62,7 +62,7 @@ func defaults() map[string]any {
|
||||
"file_storage": "local",
|
||||
"storage_path": "",
|
||||
"storageLimit": 0,
|
||||
// v3：存储引擎运行时可配（热切换）；空=沿用 Env.StorageEngine 启动值
|
||||
// 26.9：存储引擎运行时可配（热切换）；空=沿用 Env.StorageEngine 启动值
|
||||
"storage_engine": "",
|
||||
"site_domain": "",
|
||||
"upload_rate": "0",
|
||||
@@ -78,7 +78,7 @@ func defaults() map[string]any {
|
||||
// 需求 ⑤：默认 Logo 与 favicon（空 = 前端使用打包的本地资源）
|
||||
"logo_url": DefaultLogoURL,
|
||||
"favicon_url": DefaultFaviconURL,
|
||||
// 需求 ①：背景图（v2 新增 background_url；background 为参考实现既有键，保留兼容）
|
||||
// 需求 ①：背景图（26.9 新增 background_url；background 为参考实现既有键，保留兼容）
|
||||
"background": "",
|
||||
"background_url": "",
|
||||
// 需求 ②：页脚自定义内容与备案号
|
||||
@@ -280,7 +280,7 @@ func (c *Config) GetBool(key string) bool {
|
||||
}
|
||||
|
||||
// GetStringSlice 取字符串切片配置。
|
||||
// UploadRate 上传带宽字节/秒（v3.2，0=不限速）。
|
||||
// UploadRate 上传带宽字节/秒（26.9，0=不限速）。
|
||||
func (c *Config) UploadRate() int {
|
||||
v := c.GetInt(KeyUploadRate)
|
||||
if v < 0 {
|
||||
@@ -289,7 +289,7 @@ func (c *Config) UploadRate() int {
|
||||
return v
|
||||
}
|
||||
|
||||
// DownloadRate 下载带宽字节/秒（v3.2，0=不限速）。
|
||||
// DownloadRate 下载带宽字节/秒（26.9，0=不限速）。
|
||||
func (c *Config) DownloadRate() int {
|
||||
v := c.GetInt(KeyDownloadRate)
|
||||
if v < 0 {
|
||||
@@ -298,7 +298,7 @@ func (c *Config) DownloadRate() int {
|
||||
return v
|
||||
}
|
||||
|
||||
// SiteDomain 站点对外域名（v3.1）：空=分享链接用当前访问地址。
|
||||
// SiteDomain 站点对外域名（26.9）：空=分享链接用当前访问地址。
|
||||
func (c *Config) SiteDomain() string {
|
||||
return strings.TrimRight(strings.TrimSpace(c.GetString("site_domain")), "/")
|
||||
}
|
||||
@@ -421,7 +421,7 @@ func (c *Config) AdminSessionExpireSeconds() int {
|
||||
}
|
||||
|
||||
// Engine 当前存储引擎。
|
||||
// Engine 返回当前存储引擎名：KV storage_engine 优先（v3 运行时可改），
|
||||
// Engine 返回当前存储引擎名：KV storage_engine 优先（26.9 运行时可改），
|
||||
// 空（未设置/历史数据）回落启动值 Env.StorageEngine（env 校验过的 local|s3|webdav）。
|
||||
// 枚举校验内联（避免 config→storage 反向依赖）。
|
||||
func (c *Config) Engine() string {
|
||||
|
||||
@@ -1,36 +1,36 @@
|
||||
// Package config — schema.go 定义 v2 新增配置键（KV）schema：
|
||||
// Package config — schema.go 定义 26.9 新增配置键（KV）schema：
|
||||
// 键名常量、类型、默认值与取值边界。管理与 API 层（t2）按下表读写与校验，
|
||||
// 文档（t4）按本表生成说明。键名除参考实现既有 camelCase 键外，
|
||||
// v2 新增键统一 snake_case。
|
||||
// 26.9 新增键统一 snake_case。
|
||||
package config
|
||||
|
||||
// —— v2 新增/沿用键名常量（单一事实来源；settings 包会 re-export）——
|
||||
// 命名规则：v2 新增键 snake_case；与参考实现对齐的既有键保持原拼写。
|
||||
// —— 26.9 新增/沿用键名常量（单一事实来源；settings 包会 re-export）——
|
||||
// 命名规则：26.9 新增键 snake_case；与参考实现对齐的既有键保持原拼写。
|
||||
const (
|
||||
// 需求 ①：背景图
|
||||
KeyBackground = "background" // 参考实现既有键（v1 兼容保留）
|
||||
KeyBackgroundURL = "background_url" // v2 新增：背景图 URL 或上传后的访问地址（空=默认主题）
|
||||
KeyBackgroundURL = "background_url" // 26.9 新增：背景图 URL 或上传后的访问地址（空=默认主题）
|
||||
// 需求 ②：页脚
|
||||
KeyFooterText = "footer_text" // v2 新增：页脚自定义内容（纯文本或受控 HTML 片段）
|
||||
KeyFooterBeian = "footer_beian" // v2 新增：备案号（如 京ICP备2024xxxxxx号-1）
|
||||
KeyFooterText = "footer_text" // 26.9 新增：页脚自定义内容（纯文本或受控 HTML 片段）
|
||||
KeyFooterBeian = "footer_beian" // 26.9 新增：备案号（如 京ICP备2024xxxxxx号-1）
|
||||
// 需求 ③：系统通知
|
||||
KeyNotifyEnabled = "notify_enabled" // v2 新增：通知开关，1 开启 / 0 关闭
|
||||
KeyNotifyEnabled = "notify_enabled" // 26.9 新增：通知开关，1 开启 / 0 关闭
|
||||
KeyNotifyTitle = "notify_title" // 既有键：通知标题
|
||||
KeyNotifyContent = "notify_content" // 既有键：通知内容（允许 <a> 等受控 HTML）
|
||||
// 需求 ④：保存策略（上传页动态读取并在范围内选择）
|
||||
KeyMaxSaveSeconds = "max_save_seconds" // 既有键：最长保存秒数，0=不限制（仅受默认 7 天兜底）
|
||||
KeyMaxSaveCount = "max_save_count" // v2 新增：单次分享最大可取（保存）次数上限，0=不限制
|
||||
KeyMaxSaveCount = "max_save_count" // 26.9 新增：单次分享最大可取（保存）次数上限，0=不限制
|
||||
KeyExpireStyle = "expireStyle" // 既有键：允许的过期方式白名单
|
||||
// 需求 ④：上传频率限制（既有键，对齐参考 ip_limit["upload"]）
|
||||
KeyUploadCount = "uploadCount" // 窗口内允许上传次数
|
||||
KeyUploadMinute = "uploadMinute" // 频率窗口（分钟）
|
||||
// 需求 ④⑩：存储策略（最大文件大小/允许类型/总容量）
|
||||
KeyUploadSize = "uploadSize" // 既有键：单文件上限（字节），参考实现语义
|
||||
KeyMaxFileSize = "max_file_size" // v2 新增：存储策略-单文件上限（字节），0=回落 uploadSize
|
||||
KeyMaxFileSize = "max_file_size" // 26.9 新增：存储策略-单文件上限（字节），0=回落 uploadSize
|
||||
KeyAllowedTypes = "allowed_file_types" // 既有键：允许类型白名单（"*" 不限制）
|
||||
KeyStorageLimit = "storageLimit" // 既有键：站点总容量（字节），0=不限制
|
||||
KeyOpenUpload = "openUpload" // 既有键：游客上传开关
|
||||
// v3：存储引擎运行时可配（热切换；file_storage 为参考既有键保留兼容）
|
||||
// 26.9：存储引擎运行时可配（热切换；file_storage 为参考既有键保留兼容）
|
||||
KeyStorageEngine = "storage_engine" // 当前存储引擎：local|s3|webdav
|
||||
KeySiteDomain = "site_domain" // 站点对外域名（空=分享链接用当前地址）
|
||||
KeyUploadRate = "upload_rate" // 上传带宽字节/秒（0=不限速）
|
||||
@@ -66,7 +66,7 @@ type KVSchemaEntry struct {
|
||||
Description string // 中文说明
|
||||
}
|
||||
|
||||
// KVSchema v2 全量配置键 schema 表（含既有策略键，供管理端/文档/AI 校验）。
|
||||
// KVSchema 26.9 全量配置键 schema 表（含既有策略键，供管理端/文档/AI 校验）。
|
||||
// 注意：Default 与 config defaults() 逐一对应（schema_test 保证）。
|
||||
func KVSchema() []KVSchemaEntry {
|
||||
return []KVSchemaEntry{
|
||||
@@ -92,7 +92,7 @@ func KVSchema() []KVSchemaEntry {
|
||||
{KeyAllowedTypes, "[]string", []string{"*"}, -1, -1, "允许上传类型白名单（\"*\" 不限制）"},
|
||||
{KeyStorageLimit, "int64", int64(0), 0, -1, "站点总容量（字节），0=不限制"},
|
||||
{KeyOpenUpload, "int", 1, 0, 1, "游客上传开关：1 开 / 0 需管理员登录"},
|
||||
// —— v3 存储引擎（热切换；引擎参数键沿用 defaults() 既有键，管理端经 config get/update 读写）——
|
||||
// —— 26.9 存储引擎（热切换；引擎参数键沿用 defaults() 既有键，管理端经 config get/update 读写）——
|
||||
{KeyStorageEngine, "string", "", 0, 16, "当前存储引擎：local|s3|webdav（热切换，健康检查通过才生效；空=回落启动值 FCB_STORAGE_ENGINE）"},
|
||||
{KeySiteDomain, "string", "", 0, 256, "站点对外域名（http(s)://host[:port]，不带路径；空=分享链接用当前访问地址）"},
|
||||
{KeyUploadRate, "int64", "0", 0, 1073741824, "上传带宽字节/秒（0=不限速；范围 0~1 GiB/s）"},
|
||||
|
||||
@@ -35,7 +35,7 @@ func TestKVSchemaNoDuplicates(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// TestV2NewKeysPresent v2 新增键必须在 schema 与 defaults 中同时存在。
|
||||
// TestV2NewKeysPresent 26.9 新增键必须在 schema 与 defaults 中同时存在。
|
||||
func TestV2NewKeysPresent(t *testing.T) {
|
||||
def := defaults()
|
||||
newKeys := []string{
|
||||
@@ -44,13 +44,13 @@ func TestV2NewKeysPresent(t *testing.T) {
|
||||
}
|
||||
for _, k := range newKeys {
|
||||
if _, ok := def[k]; !ok {
|
||||
t.Fatalf("v2 新键 %q 缺少默认值", k)
|
||||
t.Fatalf("26.9 新键 %q 缺少默认值", k)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// TestV2AccessorDefaults v2 便捷访问器默认语义。
|
||||
func TestV2AccessorDefaults(t *testing.T) {
|
||||
// TestKVAccessorDefaults 26.9 便捷访问器默认语义。
|
||||
func TestKVAccessorDefaults(t *testing.T) {
|
||||
t.Setenv("FCB_DB_DRIVER", "sqlite")
|
||||
t.Setenv("FCB_DB_DSN", "")
|
||||
c, err := New()
|
||||
|
||||
Reference in New Issue
Block a user