TransferMode 表示整理时文件的转移方式。

AIConfig 配置可选的 LLM 提供者。

AIService talks to an OpenAI-compatible chat-completions endpoint.

AIStatus is returned to the UI for connection-state display.

APIConfig stores third-party data-source configuration. The api_key column is encrypted with AES-GCM (see internal/service/crypto.go) so an SQLite lea

Update upserts a single provider's config. An empty patch.APIKey leaves the existing key untouched; pass "<clear>" sentinel to wipe it.

APIConfigService coordinates third-party API key storage.

─── Response Helpers ───────────────────────────────────────────────────────── APIResponse 统一 API 响应格式。

AccessLog 是结构化审计跟踪条目。存储在 SQLite 中供管理活动面板使用。

AccessLogRepository persists model.AccessLog records.

ActiveJob is the JSON shape exposed to the React Tasks panel.

AdapterTypeInfo 描述下载客户端类型信息。

ApiConfig 存储第三方 API 密钥和配置信息。 APIKey 字段在 JSON 序列化时隐藏（json:"-"），通过加密存储。

ApiConfigConfig API 配置相关设置。

ApiConfigHandler API 配置 HTTP 处理。

ApiConfigRepository persists model.ApiConfig records.

ApiConfigService 负责第三方 API 配置的 CRUD 和加密管理。

ApiProvider 定义支持的 API 提供者列表。

AppConfig 保存运行时应用参数。

Aria2Adapter 是 Aria2 的 DownloadAdapter 实现。

Artwork is the high-res image set returned by Fanart.tv.

AssistantMessage is one entry in an AssistantSession transcript. Role is "user" | "assistant" | "system". The optional OperationID links a message t

AssistantRepository persists model.AssistantSession + AssistantMessage records.

AssistantService coordinates AssistantSession + AssistantMessage rows against the underlying AIService.

AssistantSession groups a multi-turn chat with the AI assistant.

AuditService is the only sanctioned writer for the access_logs table.

AuthService handles registration, login, and JWT issuance.

BackgroundTask is the compact, operator-facing shape shown on the live tasks page. It tracks long-running work that is not represented by a download o

BackupInfo describes one stored backup file.

BackupService manages database backups.

BangumiProvider talks to https://api.bgm.tv.

BarkProvider 通过 Bark 推送通知到 iOS 设备。 Bark API 文档: https://github.com/Finb/bark-server

Base 嵌入每个域实体共享的字段: - ID: UUID v4 字符串主键 - CreatedAt / UpdatedAt: 由 GORM 管理 - DeletedAt: 软删除（查询自动过滤）

Breakdown is what /api/storage returns.

CacheConfig 控制磁盘转码/刮削缓存。

ChannelInput is the shape accepted by Create / Update. Config is a generic map; it gets serialised to JSON before being persisted.

ChatTurn is one message in a multi-turn assistant transcript.

Claims is the JWT payload we issue.

Claims 是 JWT 载荷（复制自 middleware 以避免循环导入）。

ClientChannel SSE 客户端通道包装器。

CloudMountInfo is the canonical identity of a mounted cloud library. ScanDir is the provider id/path used for listing. DisplayDir is a hierarchical pa

CloudScanStatus is the operator-facing state for long-running cloud scans.

Config 是根配置聚合。

Container 持有在启动时初始化的每个服务。Handler 接收指向它的指针并选择相关字段。

Container 是所有 repositories 的注册表，注入到 services 中。

ContainerStat counts media items per container (mp4 / mkv / …).

CryptoService wraps an AES-GCM cipher derived from a stable per-install secret (the JWT secret).

─── Custom RSS 适配器 ─────────────────────────────────────────────────────── CustomRSSAdapter 自定义 RSS 源适配器。

DLNADevice is the public projection of a discovered renderer.

DLNAService discovers UPnP MediaRenderer devices and casts media to them.

DatabaseConfig 配置 GORM 数据库。默认 auto： Docker Compose 主线会注入 PostgreSQL DSN；裸机/旧部署没有 DSN 时回退 SQLite。

DeviceService implements device/session tracking and the two decoupled enforcement policies requested by the operator: ① 防共享: too many concurrent pl

DirectLink is a resolved playback target.