server

type Authenticator interface {
	// Middleware 解析凭据并注入 context，但不强制要求已认证。
	Middleware(next http.Handler) http.Handler
	// CSRF 校验非安全方法的 CSRF 令牌。
	CSRF(next http.Handler) http.Handler
}

type Options struct {
	Logger *slog.Logger
	// Authenticator 为 nil 时不挂载鉴权中间件，仅用于测试路由骨架。
	Authenticator Authenticator
	// ClientIP 为 nil 时不解析转发头，一律使用直连地址。
	ClientIP *httpx.ClientIPResolver
	// Version 写入 OpenAPI 文档的 info.version。
	Version string
	// MaxBodySize 是普通请求体的字节上限，0 表示用默认值。
	MaxBodySize int64
	// MaxUploadSize 是 multipart 请求体的字节上限，0 表示用默认值。
	MaxUploadSize int64
	// UploadsDir 非空时把该目录以静态文件形式挂在 /uploads 下，供本地存储的附件访问。
	UploadsDir string
	// FallbackRootToConsole 为真时把根路径重定向到 Console。
	//
	// 仅供没有装配主题模块的场景（路由骨架测试、未来的纯 API 模式）使用：
	// 正常运行时根路径是访客前台，由 theme 模块接管。
	FallbackRootToConsole bool
	// InstallRedirect 非空时（首次安装向导模式）把站点入口重定向到该地址。
	//
	// 站长此时打开浏览器应当看到安装向导，而不是一个登不进去的登录页。
	// 拦的只是入口，/console/assets/* 照常提供 —— 向导自己也跑在这个 SPA 里。
	InstallRedirect string
}

type Server struct {
	// contains filtered or unexported fields
}