BuildRelativeCloudPlayURL 构造相对的云盘播放 API 路径。

Create inserts a new client.

Delete removes a STRM record (soft-delete).

NewApiConfigHandler 创建 API 配置处理器。

NewDownloadClientService is the constructor.

NewQBitClient builds a fresh client. A blank URL intentionally stays blank: an unconfigured downloader must fail closed instead of silently trying a l

OrganizeMedia moves a single media file into the target library directory. It auto-detects whether the media is a movie or TV episode based on the par

OrganizeResultNeedsVisibilitySync reports whether a just-finished organize should make sure destination files exist in the DB. New/replaced files alwa

Save inserts or updates a sign-in row.

SetKickedByUser marks every device for a user as kicked/un-kicked.

UserIsProtectedAccount reports whether a user is protected from destructive Bot/device-policy operations.

── 兑换码 ────────────────────────────────────────────────────────────────── generateCode creates a random redemption code of the given kind. durationDay

str safely extracts a string from an interface{} loaded from JSON.

stripHTML 移除 HTML 标签。

titleCaseWords upper-cases the first letter of each ASCII word; CJK and other non-ASCII leading characters are left untouched. Roman numerals (ii, iii

AnyEnabled reports whether at least one provider can run.

Compute builds a fresh snapshot.

Configure rotates the client to a new endpoint and re-auths next call.

Create persists a new site.

Effective returns the permission set the React UI should consume. Admins skip the table entirely and get a synthetic all-grant row.

FindByUserID returns the permission record for a user, or (nil, nil) when absent.

FindUser 用 ID 查用户，用于 /Users/Me 与 /Users/{id}。

GetUserID extracts the user ID from the Gin context.

GetUserTier extracts the user tier from the Gin context.

History returns the operations issued by the user, by walking the transcripts and filtering on OperationID. This is bounded to recent rows so the admi

IsCloudType reports whether typ is a cloud-disk provider.

IssueExternalPlaybackToken signs a short-lived, media-scoped JWT for URLs that are handed to third-party players. It must not be accepted as a reusabl

LatestItems 最近添加，全库或指定库。

NewInternalHTTPClient builds an HTTP client for LAN / Docker-internal services such as qBittorrent, Transmission and Aria2. These endpoints are usuall

NewMTeamAdapter 创建 MTeam 适配器。

Open initialises the configured GORM database. database.type=auto chooses PostgreSQL when database.dsn is present and otherwise falls back to SQLite.

RecordPlayback marks a device as actively playing and runs the concurrent playback anti-share check. Call from playback-progress reporting.

ServeFile streams the file backing the given media ID using http.ServeContent so HEAD / Range / If-Modified-Since are handled for free. When the medi

UserDefaultMediaVisibility is the visibility policy used by clients that cannot pass a web play-profile token, notably Emby/Jellyfin-compatible apps.

applyRenewal renews a user account and clears any expiry-related suspension.

channelSubscribes returns true when the channel's Events list contains the event, or when the list is the legacy empty/"all events" value.

─── 辅助函数 ──────────────────────────────────────────────────────────────── doRequestJSON 执行 JSON 请求。

embyItemImageHandler 把 /Items/{id}/Images/Primary 等请求直接输出为图片。 Emby 客户端缓存图片 URL 时经常不会继续携带 token；如果重定向到受保护的 api/img 会变成 401，所以这里复用 ImageProxy 但不再走 /api