conf

type APITokenConfig struct {
	Enabled     bool `mapstructure:"enabled" json:"enabled"`             // 默认 true
	PerKeyQPS   int  `mapstructure:"per_key_qps" json:"per_key_qps"`     // 默认 20；显式 0 = 不限
	PerKeyBurst int  `mapstructure:"per_key_burst" json:"per_key_burst"` // 默认 0 = 2×QPS
}

type AdminConfig struct {
	// LogRetentionDays 审计/传输日志保留天数（0 = 永久）。env: PB_ADMIN_LOG_RETENTION_DAYS
	LogRetentionDays int `mapstructure:"log_retention_days"`
	// PickupDetailRetentionDays **取件明细**保留天数（0 = 永久）。
	// env: PB_ADMIN_PICKUP_DETAIL_RETENTION_DAYS
	//
	// 为什么与 LogRetentionDays 分开（2026-10-24）：取件计次记录表同时承担两个角色
	// ——①「同一令牌不重复计次」的去重键（令牌过期后即可丢）；② owner 侧「取件历史」
	// 的逐条明细（IP / 时间 / 交付面）⇒ ②的留存需求**远长于**①。
	// 此前两者共用一个「令牌 TTL + 1h」的清理窗口 ⇒ **owner 看到的明细最多只存在
	// 1 小时**（第二天打开取件历史，明细全空）⇒ 「逐条取件历史」形同虚设。
	PickupDetailRetentionDays int `mapstructure:"pickup_detail_retention_days"`
}

type AppConfig struct {
	Name        string `mapstructure:"name"`
	Version     string `mapstructure:"version"`
	Description string `mapstructure:"description"`
	DataPath    string `mapstructure:"datapath"`
	Production  bool   `mapstructure:"production"`
}

type AppConfiguration struct {
	Server        ServerConfig        `mapstructure:"server"`
	Database      DatabaseConfig      `mapstructure:"database"`
	Redis         RedisConfig         `mapstructure:"redis"`
	Log           LogConfig           `mapstructure:"log"`
	App           AppConfig           `mapstructure:"app"`
	User          UserConfig          `mapstructure:"user"`
	Upload        UploadConfig        `mapstructure:"upload"`
	Transfer      TransferConfig      `mapstructure:"transfer"`
	Download      DownloadConfig      `mapstructure:"download"`
	Storage       StorageConfig       `mapstructure:"storage"`
	UI            UIConfig            `mapstructure:"ui"`
	Observability ObservabilityConfig `mapstructure:"observability"`
	Security      SecurityConfig      `mapstructure:"security"`
	RateLimit     RateLimitSettings   `mapstructure:"rate_limit"`
	Notify        NotifyConfig        `mapstructure:"notify"`
	MCP           MCPConfig           `mapstructure:"mcp"`
	Moderation    ModerationConfig    `mapstructure:"moderation"`
	Admin         AdminConfig         `mapstructure:"admin"`
	Federation    FederationConfig    `mapstructure:"federation"`
	Deployment    DeploymentConfig    `mapstructure:"deployment"`
}

type AzureBlobConfig struct {
	Account   string `mapstructure:"account" json:"account"`
	Container string `mapstructure:"container" json:"container"`
	// Key 共享密钥（account key）；SAS 非空时忽略
	Key string `mapstructure:"key" json:"key"`
	// SAS 容器级或账户级 SAS token（以 ? 开头的查询串）
	SAS      string `mapstructure:"sas" json:"sas"`
	Endpoint string `mapstructure:"endpoint" json:"endpoint"` // 可选；Azurite/主权云（缺省 https://<account>.blob.core.windows.net）
	Root     string `mapstructure:"root" json:"root"`
}

type BarkConfig struct {
	ServerURL string `mapstructure:"server_url" json:"server_url"` // env: PB_BARK_SERVER_URL
	DeviceKey string `mapstructure:"device_key" json:"device_key"` // env: PB_BARK_DEVICE_KEY
}

type CORSConfig struct {
	AllowOrigins     []string `mapstructure:"allow_origins"`     // 可信来源列表，env: PB_CORS_ALLOW_ORIGINS（逗号分隔）
	AllowCredentials bool     `mapstructure:"allow_credentials"` // 是否允许携带凭证
	// EnableHSTS 三态（2026-10-08 加固）：nil（未配置）= 生产模式默认开/开发默认关；
	// 显式 true/false 恒以配置为准（自签证书等特殊拓扑的逃生开关）。
	// env: PB_ENABLE_HSTS
	EnableHSTS *bool `mapstructure:"enable_hsts"`
}

type ClamAVConfig struct {
	Enabled        bool   `mapstructure:"enabled"`         // env: PB_MODERATION_CLAMAV_ENABLED
	Addr           string `mapstructure:"addr"`            // 默认 localhost:3310；env: PB_MODERATION_CLAMAV_ADDR
	TimeoutSeconds int    `mapstructure:"timeout_seconds"` // 单文件扫描超时，默认 60
	MaxScanBytes   int64  `mapstructure:"max_scan_bytes"`  // 超过跳过扫描，默认 512MB
}

type CloudStorageConfig struct {
	Region    string `mapstructure:"region" json:"region"` // 厂商地域，如 ap-guangzhou / cn-hangzhou
	Bucket    string `mapstructure:"bucket" json:"bucket"`
	AccessKey string `mapstructure:"access_key" json:"access_key"`
	SecretKey string `mapstructure:"secret_key" json:"secret_key"`
	Endpoint  string `mapstructure:"endpoint" json:"endpoint"`     // 空 = 按厂商+Region 推导
	UseSSL    *bool  `mapstructure:"use_ssl" json:"use_ssl"`       // 缺省 true
	PathStyle *bool  `mapstructure:"path_style" json:"path_style"` // 缺省 false（各厂商均为 virtual-host 风格）
}

type DatabaseConfig struct {
	Driver      string `mapstructure:"driver"` // sqlite, mysql, postgres
	DBName      string `mapstructure:"db_name"`
	Host        string `mapstructure:"host"`
	Port        int    `mapstructure:"port"`
	User        string `mapstructure:"user"`
	Password    string `mapstructure:"password"`
	AutoMigrate bool   `mapstructure:"auto_migrate"` // true=GORM AutoMigrate(开发友好,默认); false=版本化迁移(migrations/)
	Migrate     bool   `mapstructure:"migrate"`      // 启动时执行版本化迁移(企业级)。与 AutoMigrate 可共存：先 migrate 后 AutoMigrate 兜底
}

type DeploymentConfig struct {
	// Mode standalone(默认) | public | admin。env: PB_DEPLOY_MODE
	Mode string `mapstructure:"mode"`
}

type DownloadConfig struct {
	DownloadTimeout int  `mapstructure:"download_timeout" json:"download_timeout"`
	RequireLogin    bool `mapstructure:"require_login" json:"require_login"`
	// S3DirectDownload s3 直下：存储后端为 s3 且开启时，文件下载 302 到短时效
	// 预签名 GET URL（下载流量不经过服务器）。env: PB_DOWNLOAD_S3_DIRECT
	S3DirectDownload bool `mapstructure:"s3_direct_download" json:"s3_direct_download"`
	// PresignPolicy 直传策略：everyone=所有人可直传 / authenticated=仅登录用户 /
	// disabled=完全关闭直传（全部走服务器中转）。空串=未设置，按 everyone 处理。
	// 旧开关 presign_anonymous_enabled 已退役（2026-10-26）：存量库该键的语义
	// （false⇒仅登录用户）已并入本字段，迁移由启动期数据迁移完成。
	PresignPolicy string `mapstructure:"presign_policy" json:"presign_policy"`
	// PresignExpireSeconds 直传签名时效（秒）。0=默认 600；钳位 60..3600。
	PresignExpireSeconds int `mapstructure:"presign_expire_seconds" json:"presign_expire_seconds"`
	// PresignThresholdMB 前端直传阈值（MB）。0=默认 100；经 /api/config 下发。
	PresignThresholdMB int `mapstructure:"presign_threshold_mb" json:"presign_threshold_mb"`
	// CodeCaseInsensitive 分享码/自定义口令查询是否不区分大小写（6 位取件码字符表
	// 全大写、天然不敏感，不受此开关影响）。指针三态：nil=未设置（默认不区分，
	// 口播/手抄场景更友好）。开启时自定义口令创建同步按折叠查重，失败锁定键同步
	// 归一。经 /api/config 以下发 codeCaseInsensitive 供前端提示联动。
	CodeCaseInsensitive *bool `mapstructure:"code_case_insensitive" json:"code_case_insensitive"`
}

type DownloadTokenConfig struct {
	Enabled         bool `mapstructure:"enabled"`          // 默认 true
	ValiditySeconds int  `mapstructure:"validity_seconds"` // 令牌有效期，默认 1000s（对齐上游）
}

type FTPConfig struct {
	Host     string `mapstructure:"host" json:"host"` // host[:port]（port 缺省 21）
	Username string `mapstructure:"username" json:"username"`
	Password string `mapstructure:"password" json:"password"`
	// TLS "true" = 显式 FTPS（AUTH TLS）
	TLS string `mapstructure:"tls" json:"tls"`
	// Root 远端子目录（所有对象挂其下；目录需已存在或可创建）
	Root string `mapstructure:"root" json:"root"`
}

type FederationConfig struct {
	// Enabled 总开关（默认 false）。env: PB_FEDERATION_ENABLED
	Enabled bool `mapstructure:"enabled" json:"enabled"`
	// RegistryURL 联邦注册中心基址，如 http://p2p:12346；支持逗号分隔多主备
	// （写路径全推、读路径依次 failover）。env: PB_FEDERATION_REGISTRY_URL
	RegistryURL string `mapstructure:"registry_url" json:"registry_url"`
	// PublicURL 本站对外可达基址（公告给取件方直连下载用；必须公网/局域网可达，
	// 一般与 server.base_url 一致）。env: PB_FEDERATION_PUBLIC_URL
	PublicURL string `mapstructure:"public_url" json:"public_url"`
	// NodeKeyPath 节点身份密钥（Ed25519 seed hex, 0600），首次启动自动生成。
	// 缺失/损坏会重新生成=联邦身份更换。env: PB_FEDERATION_NODE_KEY_PATH
	NodeKeyPath string `mapstructure:"node_key_path" json:"node_key_path"`
	// AnnounceMinEntropyBits 口令公告熵门槛（位），低于此熵的口令不出站
	// （6 位数字取件码默认只在本站有效，防 registry 侧枚举）。0=默认 40。
	// json 标签随 SystemConfig.p2p 段在线读写（2026-10-14 对称节点 P1）。
	AnnounceMinEntropyBits int `mapstructure:"announce_min_entropy_bits" json:"announce_min_entropy_bits"`
	// DeliveryPeers 可投递对端（联邦前台化，2026-11-01；跨站投递）。
	//
	// 双向登记才允许投递：A 柜登记 B ⇒ A 能往 B 投；B 柜登记 A ⇒ B 才认 A
	// 的铸槽位请求（口令即权限）。
	//
	// ⚠️ 段内含**共享口令明文** ⇒ 管理台不回显（只显示是否已配 + 名称）；
	// json 标签随 SystemConfig.p2p 段在线读写（同 AnnounceMinEntropyBits）。
	DeliveryPeers []FederationDeliveryPeer `mapstructure:"delivery_peers" json:"delivery_peers"`
	// Sync 联邦邀请定时同步（core#32）：周期把待推口令送给已配置对端。
	//
	// 默认零行为（Enabled=false ⇒ 不跑）——定时是手动推送的补充，不是替代。
	// 字段形状与 app/config 的 p2p 段一致（同一段在线读写）。
	Sync FederationSyncConfig `mapstructure:"sync" json:"sync"`
}

type FederationDeliveryPeer struct {
	// URL 对方柜基址（如 http://10.10.30.253:12345）。scheme 限 http/https。
	URL string `mapstructure:"url" json:"url"`
	// Token 共享口令 bearer（A 柜调 B 柜铸槽位时带上；B 柜比对登记对端的口令）。
	Token string `mapstructure:"token" json:"token"`
	// Name 前台展示名（如「张三的柜子」；访客在投递结果里看到）。
	Name string `mapstructure:"name" json:"name"`
	// AllowPrivate 允许该对端落在私网（自托管常态：对方柜常在局域网）。
	//
	// ⚠️ **按对端粒度**开，**不动**全局 security.ssrf.allow_private_networks
	//（全局开关一开 = 所有出站点位都放行私网 ⇒ 面太大）。
	AllowPrivate bool `mapstructure:"allow_private" json:"allow_private"`
}

type FederationSyncConfig struct {
	// Enabled 是否启用定时同步（默认 false ⇒ 零行为）。
	Enabled bool `mapstructure:"enabled" json:"enabled"`
	// IntervalSeconds 同步周期（秒）。0 = 缺省 10min；小于 60 按 60 夹。
	IntervalSeconds int `mapstructure:"interval_seconds" json:"interval_seconds"`
	// Targets 已配置的对端站点（条目形状见 FederationSyncTarget）。
	Targets []FederationSyncTarget `mapstructure:"targets" json:"targets"`
	// Codes 待推送的邀请口令（XXXX-XXXX-XXXX）。
	Codes []string `mapstructure:"codes" json:"codes"`
}

type FederationSyncTarget struct {
	// URL 对端站基址（如 https://box.example.com）。scheme 限 http/https。
	URL string `mapstructure:"url" json:"url"`
	// AllowPrivate 允许该对端落在私网（按对端粒度；见类型注释）。
	AllowPrivate bool `mapstructure:"allow_private" json:"allow_private"`
}

type HDFSConfig struct {
	// Endpoint WebHDFS 根地址，如 http://namenode:9870
	Endpoint string `mapstructure:"endpoint" json:"endpoint"`
	// User HDFS 代理用户（doAs）
	User string `mapstructure:"user" json:"user"`
	// Kerberos/Token 认证为扩展点（当前支持无认证/简单代理用户）
	Root string `mapstructure:"root" json:"root"`
}

type LocalImportConfig struct {
	Enabled bool     `mapstructure:"enabled" json:"enabled"` // env: PB_LOCAL_IMPORT_ENABLED
	Roots   []string `mapstructure:"roots" json:"roots"`     // 允许导入的绝对目录白名单；env: PB_LOCAL_IMPORT_ROOTS（逗号分隔）
}

type LockoutConfig struct {
	Enabled       bool `mapstructure:"enabled"`        // 默认 true
	MaxAttempts   int  `mapstructure:"max_attempts"`   // 窗口内最大失败次数，默认 10
	WindowSeconds int  `mapstructure:"window_seconds"` // 计数窗口，默认 300s
	LockSeconds   int  `mapstructure:"lock_seconds"`   // 触发后锁定时长，默认 600s
}

type LogConfig struct {
	Level      string `mapstructure:"level"`
	Filename   string `mapstructure:"filename"`
	MaxSize    int    `mapstructure:"max_size"`
	MaxBackups int    `mapstructure:"max_backups"`
	MaxAge     int    `mapstructure:"max_age"`
	Compress   bool   `mapstructure:"compress"`
}

type MCPConfig struct {
	// Enabled 默认 true（认证已强制，无暴露风险）。env: PB_MCP_ENABLED
	Enabled bool `mapstructure:"enabled"`
	// AllowGuest 访客快速分享（2026-10-12，对标上游 v2.8 MCP quick share 并超出）：
	// true 时 /api/v1/mcp 不再强制管理员 JWT——游客仅 share_text/share_file
	// （与网页匿名寄件同链路、同限流、同审核/白名单），登录用户 += create_request_code/
	// preview_share，管理员 = 全量工具。默认 false（维持管理员专属）。
	// env: PB_MCP_ALLOW_GUEST
	AllowGuest bool `mapstructure:"allow_guest"`
	// MaxFileSize MCP 单文件上传/下载上限（字节）。默认 6MB——base64 膨胀 4/3 后
	// 约 8MB，低于默认请求体上限（max(10MB, upload.max_file_size)）；
	// 调大超过请求体上限时须同步调大 upload.max_file_size。env: PB_MCP_MAX_FILE_SIZE
	MaxFileSize int64 `mapstructure:"max_file_size"`
}

type MetricsConfig struct {
	Enabled bool   `mapstructure:"enabled"`
	Path    string `mapstructure:"path"` // 指标暴露路径，默认 /metrics
}

type ModerationConfig struct {
	// Enabled 审核钩子总开关（默认 false；env: PB_MODERATION_ENABLED）
	Enabled bool `mapstructure:"enabled"`
	// BlockedWords 敏感词表（子串匹配、大小写不敏感；env: PB_MODERATION_BLOCKED_WORDS，逗号分隔）
	BlockedWords []string `mapstructure:"blocked_words"`
	// BlockAction 命中处置策略：reject（默认，直接拒绝）| pending（建分享后置待审，进管理端队列）
	BlockAction string `mapstructure:"block_action"`
	// ClamAV 文件病毒扫描（clamd INSTREAM；启用后文件侧审核由扫描器接管）
	ClamAV ClamAVConfig `mapstructure:"clamav"`
}

type NotifyConfig struct {
	// WebhookURL 外部推送地址：notify.created 事件以 JSON POST 推送（空 = 禁用）。
	// env: PB_WEBHOOK_URL
	WebhookURL string `mapstructure:"webhook_url" json:"webhook_url"`
	// SMTP 邮件通知（站内信创建后对登记邮箱异步补发；空 host = 禁用）
	SMTP SMTPConfig `mapstructure:"smtp" json:"smtp"`
	// Telegram 推送渠道（bot_token + chat_id 均非空 = 启用；缺省空 = 禁用）
	Telegram TelegramConfig `mapstructure:"telegram" json:"telegram"`
	// Bark 推送渠道（server_url + device_key 均非空 = 启用；缺省空 = 禁用）
	Bark BarkConfig `mapstructure:"bark" json:"bark"`
}

type OIDCConfig struct {
	Enabled          bool   `mapstructure:"enabled" json:"enabled"`                     // env: PB_OIDC_ENABLED
	Issuer           string `mapstructure:"issuer" json:"issuer"`                       // env: PB_OIDC_ISSUER
	ClientID         string `mapstructure:"client_id" json:"client_id"`                 // env: PB_OIDC_CLIENT_ID
	ClientSecret     string `mapstructure:"client_secret" json:"client_secret"`         // env: PB_OIDC_CLIENT_SECRET
	Scopes           string `mapstructure:"scopes" json:"scopes"`                       // 默认 "openid profile email"；env: PB_OIDC_SCOPES
	FrontendCallback string `mapstructure:"frontend_callback" json:"frontend_callback"` // 默认 /#/oidc/callback
}

type ObservabilityConfig struct {
	Metrics MetricsConfig `mapstructure:"metrics"`
}

type OneDriveConfig struct {
	ClientID     string `mapstructure:"client_id" json:"client_id"`
	ClientSecret string `mapstructure:"client_secret" json:"client_secret"`
	// RefreshToken 一次性授权获得，长期有效（轮换由服务端自动处理）
	RefreshToken string `mapstructure:"refresh_token" json:"refresh_token"`
	// Tenant common（个人+组织）或具体租户/消费者域
	Tenant string `mapstructure:"tenant" json:"tenant"` // 缺省 common
	// DriveID 缺省 me/drive；站点/共享库填对应 drive id
	DriveID string `mapstructure:"drive_id" json:"drive_id"`
	Root    string `mapstructure:"root" json:"root"`
}

type RateLimitSettings struct {
	Enabled      *bool `mapstructure:"enabled"`
	GlobalQPS    int   `mapstructure:"global_qps"`
	UploadQPS    int   `mapstructure:"upload_qps"`
	DownloadQPS  int   `mapstructure:"download_qps"`
	LoginQPS     int   `mapstructure:"login_qps"`
	Burst        int   `mapstructure:"burst"`
	BlockSeconds int   `mapstructure:"block_seconds"`
	UseRedis     bool  `mapstructure:"use_redis"` // true=Redis 分布式计数（多实例共享），Redis 不可用自动回退内存
}

type RedisConfig struct {
	Host     string `mapstructure:"host"`
	Port     int    `mapstructure:"port"`
	Password string `mapstructure:"password"`
	DB       int    `mapstructure:"db"`
}

type S3Config struct {
	Endpoint  string `mapstructure:"endpoint" json:"endpoint"`
	Region    string `mapstructure:"region" json:"region"`
	Bucket    string `mapstructure:"bucket" json:"bucket"`
	AccessKey string `mapstructure:"access_key" json:"access_key"`
	SecretKey string `mapstructure:"secret_key" json:"secret_key"`
	UseSSL    bool   `mapstructure:"use_ssl" json:"use_ssl"`
	PathStyle bool   `mapstructure:"path_style" json:"path_style"`
}

type SFTPConfig struct {
	Host     string `mapstructure:"host" json:"host"` // host[:port]（port 缺省 22）
	Username string `mapstructure:"username" json:"username"`
	Password string `mapstructure:"password" json:"password"`
	// PrivateKey PEM 私钥内容（多行，env 注入友好）
	PrivateKey string `mapstructure:"private_key" json:"private_key"`
	// HostKey 可选；known_hosts 行或 base64 主机公钥（配置后严格校验，缺省宽松）
	HostKey string `mapstructure:"host_key" json:"host_key"`
	Root    string `mapstructure:"root" json:"root"`
}

type SMTPConfig struct {
	Host     string `mapstructure:"host" json:"host"`         // env: PB_SMTP_HOST
	Port     int    `mapstructure:"port" json:"port"`         // 465=隐式 TLS；25/587=STARTTLS；env: PB_SMTP_PORT
	Username string `mapstructure:"username" json:"username"` // env: PB_SMTP_USERNAME
	Password string `mapstructure:"password" json:"password"` // env: PB_SMTP_PASSWORD
	From     string `mapstructure:"from" json:"from"`         // 发件地址，空 = 取 Username；env: PB_SMTP_FROM
}

type SSRFConfig struct {
	// AllowPrivateNetworks 是否允许 s3/webdav 端点指向私网地址。
	// 默认 false（阻止内网探测）；局域网 MinIO/WebDAV（飞牛 NAS）部署需显式开启。
	AllowPrivateNetworks bool `mapstructure:"allow_private_networks"`
}

type SecurityConfig struct {
	CORS           CORSConfig          `mapstructure:"cors"`
	TrustedProxies []string            `mapstructure:"trusted_proxies"` // 可信代理 CIDR 列表，如 ["10.0.0.0/8","173.245.48.0/20"]
	DownloadToken  DownloadTokenConfig `mapstructure:"download_token"`
	Lockout        LockoutConfig       `mapstructure:"lockout"`
	SSRF           SSRFConfig          `mapstructure:"ssrf"`
	APIToken       APITokenConfig      `mapstructure:"api_token"`
	OIDC           OIDCConfig          `mapstructure:"oidc"`
}

type ServerConfig struct {
	Host    string `mapstructure:"host"`
	Port    int    `mapstructure:"port"`
	Mode    string `mapstructure:"mode"`     // debug, release, test
	BaseURL string `mapstructure:"base_url"` // 对外可访问的基础 URL（用于生成分享链接等）
}

type StorageConfig struct {
	Type        string `mapstructure:"type" json:"type"` // local, s3, oss, cos, bos, ks3, obs, webdav
	StoragePath string `mapstructure:"storage_path" json:"storage_path"`
	// Quota 站点级全局存储配额（字节，0=不限）。统计口径=存活 file_codes 尺寸合计；
	// 全通道统一闸口（直传/分片完成/预签名完成/本地导入/多文件）。env: PB_STORAGE_QUOTA
	Quota     int64               `mapstructure:"quota" json:"quota"`
	S3        *S3Config           `mapstructure:"s3" json:"s3"`
	WebDAV    *WebDAVConfig       `mapstructure:"webdav" json:"webdav"`
	FTP       *FTPConfig          `mapstructure:"ftp" json:"ftp"`
	SFTP      *SFTPConfig         `mapstructure:"sftp" json:"sftp"`
	AzureBlob *AzureBlobConfig    `mapstructure:"azureblob" json:"azureblob"`
	HDFS      *HDFSConfig         `mapstructure:"hdfs" json:"hdfs"`
	OneDrive  *OneDriveConfig     `mapstructure:"onedrive" json:"onedrive"`
	OSS       *CloudStorageConfig `mapstructure:"oss" json:"oss"`
	COS       *CloudStorageConfig `mapstructure:"cos" json:"cos"`
	BOS       *CloudStorageConfig `mapstructure:"bos" json:"bos"`
	KS3       *CloudStorageConfig `mapstructure:"ks3" json:"ks3"`
	OBS       *CloudStorageConfig `mapstructure:"obs" json:"obs"`
}

type TelegramConfig struct {
	BotToken string `mapstructure:"bot_token" json:"bot_token"` // env: PB_TELEGRAM_BOT_TOKEN
	ChatID   string `mapstructure:"chat_id" json:"chat_id"`     // env: PB_TELEGRAM_CHAT_ID
}

type TransferConfig struct {
	// MaxCount 单分享可取件次数上限（expire_style=count 的 expire_value 上限；0 = 不限）。
	MaxCount int `mapstructure:"max_count" json:"max_count"`
	// ExpireDefault 站点默认过期天数（创建分享未指定过期参数时生效）。
	ExpireDefault int `mapstructure:"expire_default" json:"expire_default"`
}

type UIConfig struct {
	RobotsText string `mapstructure:"robots_text" json:"robots_text"`
	// ShowAdminAddr 缺省（nil/未配置）= 展示页脚管理入口；显式 false 才隐藏。
	ShowAdminAddr *bool  `mapstructure:"show_admin_addr" json:"show_admin_addr"`
	Background    string `mapstructure:"background" json:"background"`
	AccentColor   string `mapstructure:"accent_color" json:"accent_color"`
	// ExposeOpenAPI 是否公开 /openapi.json（默认 true，前端 /api-docs 页依赖）；
	// 生产部署可置 false 收缩端点清单侦察面（env: PB_UI_EXPOSE_OPENAPI）。
	ExposeOpenAPI bool `mapstructure:"expose_openapi" json:"expose_openapi"`
	// AdminPath 自定义管理后台入口路径段（hash 路由，缺省 admin；env: PB_UI_ADMIN_PATH）。
	// 仅入口混淆（SPA 须知路径才能路由，会随公开配置下发）——防误触与批量扫描，
	// 不构成安全边界，安全靠登录鉴权。非法字符/超长自动回退 admin。
	AdminPath string `mapstructure:"admin_path" json:"admin_path"`
}

type UploadConfig struct {
	OpenUpload   bool  `mapstructure:"open_upload" json:"open_upload"`
	UploadSize   int64 `mapstructure:"upload_size" json:"upload_size"`
	EnableChunk  bool  `mapstructure:"enable_chunk" json:"enable_chunk"`
	ChunkSize    int64 `mapstructure:"chunk_size" json:"chunk_size"`
	RequireLogin bool  `mapstructure:"require_login" json:"require_login"`
	// TextMaxBytes 文本分享大小上限（字节）。<=0 时用默认 222KB（对齐上游）。
	TextMaxBytes int64 `mapstructure:"text_max_bytes" json:"text_max_bytes"`
	// AllowedExtensions 扩展名白名单（如 [".jpg",".png",".pdf"]）。
	// 非空时白名单优先：未命中的扩展名直接拒绝；空 = 黑名单模式。
	AllowedExtensions []string `mapstructure:"allowed_extensions" json:"allowed_extensions"`
	// BlockedExtensions 扩展名黑名单（如 [".exe",".bat"]）。
	// 非空时覆盖内置默认黑名单；空 = 使用内置默认（可执行文件类）。
	BlockedExtensions []string `mapstructure:"blocked_extensions" json:"blocked_extensions"`
	// EnableMagicCheck 是否启用魔数校验（默认 true）。
	EnableMagicCheck bool `mapstructure:"enable_magic_check" json:"enable_magic_check"`
	// MagicCheckSkipExts 魔数检查豁免扩展名**追加项**（如 [".fpk",".ipk"]）。
	// 内置事实性豁免（.appimage/.run/.bin/无扩展名等，见 pkg/utils/magic.go）
	// 恒生效，本字段只做补充；要禁传某类文件用 BlockedExtensions（永远优先）。
	MagicCheckSkipExts []string `mapstructure:"magic_check_skip_extensions" json:"magic_check_skip_extensions"`
	// AllowedExpireStyles 允许用户选择的过期样式
	// （minute/hour/day/week/month/year/forever/count —— count =「按取件次数」，
	// 2026-10-22 补入：此前注释漏了它，合法集合以 pkg/utils.AllExpireStyles 为准）。
	// 空 = 全部允许；管理员可裁剪（对标上游白名单裁剪能力）。
	AllowedExpireStyles []string `mapstructure:"allowed_expire_styles" json:"allowed_expire_styles"`
	// MaxSaveSecondsCap 全局过期时间上限（秒），0 = 不限（对标上游 max_save_seconds）。
	MaxSaveSecondsCap int64 `mapstructure:"max_save_seconds_cap" json:"max_save_seconds_cap"`
	// MaxFileSize 单个文件大小上限（字节），适用于分片/预签名/匿名登记等
	// "整文件"语义的通道；0 = 不限。upload_size 是"单请求体"上限，两者语义不同
	// （回归：分片 init 曾误用 upload_size，48MB 文件被 10MB 单请求限制拦截）。
	MaxFileSize int64 `mapstructure:"max_file_size" json:"max_file_size"`
	// AnonymousDailyCount 匿名上传 per-IP 日配额（次数），0 = 不限。
	// 仅约束匿名请求（登录用户走存储配额）；Redis 可用时多实例共享计数。
	AnonymousDailyCount int64 `mapstructure:"anonymous_daily_count" json:"anonymous_daily_count"`
	// AnonymousDailyBytes 匿名上传 per-IP 日配额（字节），0 = 不限。
	AnonymousDailyBytes int64 `mapstructure:"anonymous_daily_bytes" json:"anonymous_daily_bytes"`
	// LocalImport NAS 本地文件免上传导入（P3：服务器本地白名单目录内的文件
	// 直接登记为分享，服务端拷贝入存储；默认关闭）
	LocalImport LocalImportConfig `mapstructure:"local_import" json:"local_import"`
}

type UserConfig struct {
	AllowUserRegistration bool   `mapstructure:"allow_user_registration"`
	UserUploadSize        int64  `mapstructure:"user_upload_size"`
	UserStorageQuota      int64  `mapstructure:"user_storage_quota"`
	SessionExpiryHours    int    `mapstructure:"session_expiry_hours"`
	JWTSecret             string `mapstructure:"jwt_secret"`
}

type WebDAVConfig struct {
	Endpoint string `mapstructure:"endpoint" json:"endpoint"`
	Username string `mapstructure:"username" json:"username"`
	Password string `mapstructure:"password" json:"password"`
}