models

package
v1.0.0-rc.54 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 8, 2026 License: MIT Imports: 15 Imported by: 0

Documentation

Index

Constants

View Source
const (
	AssistantEntryWeb     = "web"
	AssistantEntryApp     = "app"
	AssistantEntryChatOps = "chatops"
)

AI 助手(路线图 M19)会话的入口。

View Source
const (
	AssistantRoleUser      = "user"
	AssistantRoleAssistant = "assistant"
	AssistantRoleTool      = "tool"
	AssistantRoleNotice    = "notice"
)

AI 助手消息的角色。notice 是 pt-tools 自己写的提示(出错、已停止),不交给模型。

View Source
const (
	AssistantConfirmPending  = "pending"
	AssistantConfirmApproved = "approved"
	AssistantConfirmDenied   = "denied"
	AssistantConfirmExpired  = "expired"
)

AI 助手待确认操作的状态:pending 只能经条件更新变成后面三种之一,变了就不再改。

View Source
const (
	AssistantAttachImage = "image"
	AssistantAttachText  = "text"
)

AI 助手附件的种类。

View Source
const (
	BrushTorrentActive  = "active"
	BrushTorrentRemoved = "removed"
	// BrushTorrentGone 表示种子已经不在下载器里了(被人手动删掉,或被低空间紧急清理删掉),不是刷流删的。
	BrushTorrentGone = "gone"
)

刷流种子的状态。active 之外都是终态。

View Source
const (
	BrushRunSchedule = "schedule"
	BrushRunManual   = "manual"
)

刷流运行的触发方式。

View Source
const (
	BrushRunRunning = "running"
	BrushRunOK      = "ok"
	// BrushRunPartial 是这一轮跑完了,但有个别种子下载、推送、删除或记录失败
	BrushRunPartial = "partial"
	BrushRunFailed  = "failed"
	// BrushRunInterrupted 是这一轮没跑完进程就退出了(重启时补记)
	BrushRunInterrupted = "interrupted"
)

刷流运行的结果。

View Source
const (
	MinIntervalMinutes     int32 = 5    // 最小间隔时间(分钟)
	DefaultIntervalMinutes int32 = 10   // 默认间隔时间(分钟)
	MaxIntervalMinutes     int32 = 1440 // 最大间隔时间(分钟)
)

间隔时间常量

View Source
const (
	MinConcurrency     int32 = 1  // 最小并发数
	DefaultConcurrency int32 = 3  // 默认并发数
	MaxConcurrency     int32 = 10 // 最大并发数
)

并发数常量

View Source
const (
	DefaultPeerRatioMaxSL       = 30.0
	MinPeerRatioMaxSL           = 1.0
	DefaultPeerRatioIntervalMin = 10
	MinPeerRatioIntervalMin     = 5
)
View Source
const (
	CookieCloudDefaultIntervalHours = 24
	CookieCloudMinIntervalHours     = 1
	CookieCloudMaxIntervalHours     = 168
)

CookieCloud 同步的取值范围。

View Source
const (
	// FreeWatchWatching 在等:后台定时读种子现在的优惠,免费了就推送
	FreeWatchWatching = "watching"
	// FreeWatchPushed 已推送(或下载器里已经有这个种子)
	FreeWatchPushed = "pushed"
	// FreeWatchExpired 等到期了还没免费
	FreeWatchExpired = "expired"
	// FreeWatchCanceled 用户取消了
	FreeWatchCanceled = "canceled"
	// FreeWatchFailed 连续几次读不到种子的优惠,不再等
	FreeWatchFailed = "failed"
)

等免费的状态。

View Source
const (
	DBFile  = "torrents.db"
	WorkDir = ".pt-tools"
)
View Source
const (
	MediaWordBlock   = "block"   // 屏蔽:从标题与副标题里去掉
	MediaWordReplace = "replace" // 替换:换成另一段文字
	MediaWordOffset  = "offset"  // 集数偏移:标题或副标题匹配时,集数加上偏移量(可为负)
)

识别词的种类。

View Source
const (
	MediaKindMovie = "movie"
	MediaKindTV    = "tv"
)

媒体库的种类。

View Source
const (
	MediaModeHardlink = "hardlink"
	MediaModeCopy     = "copy"
	MediaModeSymlink  = "symlink"
	MediaModeMove     = "move"
	// MediaModeExisting 是导入已有媒体库时记下的文件:导入时就在库里,不是 pt-tools 放进去的(源与目标是同一个文件)。
	// 只出现在整理记录里,不能选作整理方式
	MediaModeExisting = "existing"
)

整理方式。空串当作硬链接。

View Source
const (
	MediaServerEmby     = "emby"
	MediaServerJellyfin = "jellyfin"
	MediaServerPlex     = "plex"

	// MediaRefreshPath 只通知整理到的目录(空串也是这个);MediaRefreshLibrary 刷新整个媒体库。
	MediaRefreshPath    = "path"
	MediaRefreshLibrary = "library"
)

媒体服务器的种类与刷新方式。

View Source
const (
	MediaTransferDone    = "done"
	MediaTransferFailed  = "failed"
	MediaTransferSkipped = "skipped"
	// MediaTransferRemoved 是库里的文件已经删掉的记录(删除记录时连文件一起删,或种子连数据删掉后清理了入库链接)
	MediaTransferRemoved = "removed"

	MediaTriggerAuto   = "auto"
	MediaTriggerScan   = "scan"
	MediaTriggerManual = "manual"
	// MediaTriggerWatch 是目录监控发现的(不是下载器里的种子)
	MediaTriggerWatch = "watch"
	// MediaTriggerImport 是导入已有媒体库时记下的(见 MediaModeExisting)
	MediaTriggerImport = "import"
)

整理记录的状态与触发方式。

View Source
const (
	// MediaFailRecognize 是没识别出来(没填 TMDB Key、TMDB 上没有可靠的匹配、取不到条目详情)
	MediaFailRecognize = "recognize"
	// MediaFailLibrary 是没有媒体库、媒体库不对(类型、命名模板、二级分类)
	MediaFailLibrary = "library"
	// MediaFailPath 是 pt-tools 里找不到文件,要加路径映射
	MediaFailPath = "path"
	// MediaFailFilesystem 是跨文件系统、没有权限这类文件系统的问题
	MediaFailFilesystem = "filesystem"
	// MediaFailExists 是目标位置已经有别的文件
	MediaFailExists = "exists"
	// MediaFailSource 是源文件不在了
	MediaFailSource = "source"
	// MediaFailDisc 是整理不了的原盘与镜像(剧集原盘、几张原盘、剧集里的 ISO 等)
	MediaFailDisc = "disc"
	// MediaFailOther 是其他
	MediaFailOther = "other"
)

失败与跳过的整理记录的分类(FailKind)。整理成的记录为空;升级前的失败、跳过记录也为空,当作其他。

View Source
const (
	MediaScrapeOK = "ok"
	// MediaScrapePartial 是有的文件没写成、或有来源出错(用了 TMDB 的),ScrapeNote 写明
	MediaScrapePartial = "partial"
	// MediaScrapeFailed 是出了错、什么也没写成
	MediaScrapeFailed = "failed"
)

刮削的结果(整理记录的 ScrapeStatus)。空串是没刮削过(媒体库关着刮削,或升级前整理的)。

View Source
const (
	MediaServerItemMovie   = "movie"
	MediaServerItemSeries  = "series"
	MediaServerItemEpisode = "episode"
)

媒体服务器索引里一项的种类。

View Source
const (
	// MediaIssueServerRemoved 是 pt-tools 整理过的一项在媒体服务器里没有了(索引同步时发现)
	MediaIssueServerRemoved = "server_removed"
	// MediaIssueLibraryMissing 是整理记录在库里的文件不见了(M7 的巡检)
	MediaIssueLibraryMissing = "library_missing"

	MediaIssueOpen      = "open"
	MediaIssueResolved  = "resolved"
	MediaIssueDismissed = "dismissed"
)

待处理问题的种类与状态。

View Source
const (
	// MediaSubActive 在找资源:主动搜索,RSS 里的种子也会拿来对。
	MediaSubActive = "active"
	// MediaSubPaused 暂停:不搜索,也不接 RSS。
	MediaSubPaused = "paused"
	// MediaSubPending 待确认:豆瓣想看建的、设成要先确认的订阅,确认后才开始找。
	MediaSubPending = "pending"
	// MediaSubDone 完成:电影入了库,或剧集这一季都入了库(开着洗版时要达到目标质量)。
	MediaSubDone = "done"
)

订阅的状态。

View Source
const (
	MediaSubFromManual  = "manual"
	MediaSubFromExplore = "explore"
	MediaSubFromDouban  = "douban"
	MediaSubFromChatOps = "chatops"
	// MediaSubFromApp 是经 App API(M12)建的订阅
	MediaSubFromApp = "app"
	// MediaSubFromServarr 是 Seerr 经 Servarr 兼容入口(媒体中心 M10)建的订阅
	MediaSubFromServarr = "servarr"
)

订阅从哪里建的。

View Source
const (
	MediaPrefPrefer  = "prefer"
	MediaPrefRequire = "require"
	MediaPrefAvoid   = "avoid"
)

质量档案里「要不要」的取值:空串不限,prefer 优先,require 必须有,avoid 尽量不要(只用于 HDR)。

View Source
const (
	MediaSubTorrentDownloading = "downloading"
	MediaSubTorrentDone        = "done"
	MediaSubTorrentFailed      = "failed"
	// MediaSubTorrentReplaced 是洗版换成更好的版本以后,旧的那个
	MediaSubTorrentReplaced = "replaced"
)

订阅下载的种子的状态。

View Source
const (
	MediaUpgradeKeep   = "keep"
	MediaUpgradeDelete = "delete"
)

洗版以后旧种子怎么办。

View Source
const (
	MediaScheduleAirtime   = "airtime"
	MediaScheduleDaily     = "daily"
	MediaScheduleEveryDays = "every_days"
	MediaScheduleWeekly    = "weekly"
	MediaScheduleMonthly   = "monthly"
	// MediaScheduleInterval 是每隔一段时间(分钟)搜一次,从上次搜索算起
	MediaScheduleInterval = "interval"
	// MediaScheduleCron 是按 cron 表达式(分 时 日 月 星期)
	MediaScheduleCron = "cron"
)

追剧主动搜索的定时方式(MediaSubscription.ScheduleKind)。空串是沿用设置里的全局间隔。

View Source
const (
	MediaEpisodeUpcoming = "upcoming"
	MediaEpisodeMissing  = "missing"
	// MediaEpisodeWaitingVersion 是播出很久了还没有锁住的那个版本(仍算缺的)
	MediaEpisodeWaitingVersion = "waiting_version"
	MediaEpisodeDownloading    = "downloading"
	MediaEpisodeLibrary        = "library"
	MediaEpisodeSkipped        = "skipped"
)

追剧台账里一集的状态。

View Source
const (
	MediaEpisodeFromLibrary      = "library"
	MediaEpisodeFromSubscription = "subscription"
	MediaEpisodeFromDownloader   = "downloader"
	// MediaEpisodeFromServer 是整理记录里没有、开了「算作已入库」的媒体服务器里有(Ref 是「服务器编号:条目编号」)
	MediaEpisodeFromServer = "server"
)

台账里一集的状态从哪里来的。

View Source
const (
	// MediaEpisodeRuleTMDB 是标题里的 E{n} 就是 TMDB 的第 n 集
	MediaEpisodeRuleTMDB = "tmdb"
	// MediaEpisodeRulePeriodPart 是标题里的 E{n}(与 Part)是第 n 期(上、下),按 TMDB 的集名找
	MediaEpisodeRulePeriodPart = "period_part"
	// MediaEpisodeRuleDate 是按标题里的日期找那天播出的集
	MediaEpisodeRuleDate = "date"
	// MediaEpisodeRuleOffset 是 TMDB 的集号 = 标题里的集号 + Offset
	MediaEpisodeRuleOffset = "offset"
)

集号规则(MediaEpisodeRule.Mode):种子标题里的集号怎么对到 TMDB 的集。

View Source
const (
	MediaRuleFromAuto   = "auto"
	MediaRuleFromManual = "manual"
	MediaRuleFromAI     = "ai"
)

集号规则的来源。

View Source
const (
	MediaRunCreate   = "create"
	MediaRunSchedule = "schedule"
	MediaRunRSS      = "rss"
	MediaRunManual   = "manual"
	MediaRunAI       = "ai"
)

追剧运行是怎么开始的。

View Source
const (
	MediaRunOK      = "ok"
	MediaRunNothing = "nothing"
	MediaRunWaiting = "waiting"
	MediaRunFailed  = "failed"
	MediaRunPartial = "partial"
	// MediaRunChanged 是手动改动的记录(改设置、跳过一集、换版本、集号规则),不是一次搜索
	MediaRunChanged = "changed"
)

追剧运行的结果。

View Source
const (
	MediaDoubanSubscribed = "subscribed"
	MediaDoubanUnmatched  = "unmatched"
	// MediaDoubanRemoved 是建的订阅被用户删掉了(不会再建回来)
	MediaDoubanRemoved = "removed"
)

豆瓣想看里条目的处理结果。

View Source
const (
	MonitorNotifyPending = "pending"
	MonitorNotifySent    = "sent"
	MonitorNotifyFailed  = "failed"
)
View Source
const (
	JobKindTransfer = ""
	JobKindReseed   = "reseed"
)

转移任务的种类:转移做种(从源移除)与辅种(源与目标是同一台下载器,不移除任何种子)。

View Source
const (
	ReseedNotifyOff     = "off"
	ReseedNotifyAlways  = "always"
	ReseedNotifyChanges = "changes"
)

每轮结果推送。

View Source
const (
	ReseedSitesAll      = "all"
	ReseedSitesSelected = "selected"
)

辅种的站点范围。

View Source
const (
	ReseedDefaultIntervalHours    = 12
	ReseedMinIntervalHours        = 1
	ReseedMaxIntervalHours        = 168
	ReseedDefaultMaxPerSitePerDay = 20
	ReseedMaxPerSitePerDay        = 500
	// ReseedSidTTL 是 sid_sha1 的有效期。
	ReseedSidTTL = 7 * 24 * time.Hour
	// ReseedRetryAfter 是暂时失败(下载不到种子等)之后多久再试。
	ReseedRetryAfter = 7 * 24 * time.Hour
	// ReseedDefaultIYUUMinInterval 是没设置时两次请求 IYUU 之间至少隔几秒。
	ReseedDefaultIYUUMinInterval = 3
	ReseedMaxIYUUMinInterval     = 300
	ReseedMaxIYUUCallsPerDay     = 10000
	// ReseedMaxIYUUCooldown 是一次限流最多冷却多久(IYUU 给的重置时间离谱时不照它等)。
	ReseedMaxIYUUCooldown = 24 * time.Hour
)

辅种设置的默认值与范围。

View Source
const (
	IYUUEndpointSites  = "sites"
	IYUUEndpointReport = "report"
	IYUUEndpointQuery  = "query"
)

IYUU 的接口(请求计数按它分)。

View Source
const (
	// ReseedQueued 是已经建成辅种任务,结果看任务的状态。
	ReseedQueued = "queued"
	// ReseedFailed 是下载种子、核对 info hash 或文件列表失败;同一对不再尝试。
	ReseedFailed = "failed"
	// ReseedGone 是站点上已经没有这个种子(删了,IYUU 的索引里还有):同一对不再尝试,也不算失败。
	ReseedGone = "gone"
	// 下面几个是清除已结束的辅种任务时,写进记录里的任务结果(任务失败的记为 ReseedFailed)。
	ReseedDone       = "done"
	ReseedRolledBack = "rolled_back"
	ReseedCanceled   = "canceled"
)

辅种记录的结果。

View Source
const (
	ReseedTriggerSchedule = "schedule"
	ReseedTriggerManual   = "manual"
	// ReseedTriggerRetry 是在记录里勾选重试(不查 IYUU,只重试选中的记录)
	ReseedTriggerRetry = "retry"
	// ReseedTriggerContinue 是接着一轮没跑完的往下查
	ReseedTriggerContinue = "continue"
)

辅种轮次的触发方式。

View Source
const (
	ReseedRunRunning = "running"
	ReseedRunPaused  = "paused"
	ReseedRunOK      = "ok"
	// ReseedRunPartial 是这一轮跑完了,但有下载器读不到、查询 IYUU 出错之类的问题
	ReseedRunPartial = "partial"
	// ReseedRunStopped 是被停止(手动停止、暂停太久自动停止、运行中换了 token)
	ReseedRunStopped = "stopped"
	// ReseedRunLimited 是超时、IYUU 限流或到了每天的请求上限而提前停下
	ReseedRunLimited = "limited"
	// ReseedRunFailed 是未能开始(没有 token、没有站点等)
	ReseedRunFailed = "failed"
	// ReseedRunInterrupted 是 pt-tools 退出时这一轮还没跑完(启动时补记)
	ReseedRunInterrupted = "interrupted"
)

辅种轮次的状态。

View Source
const (
	ReseedRunKeep    = 500
	ReseedRunKeepFor = 180 * 24 * time.Hour
)

轮次记录的保留:最近 500 条、不超过 180 天。

View Source
const (
	// ReseedAttemptRunning 是正在尝试(写入时);pt-tools 退出时留下的,启动时改成 interrupted
	ReseedAttemptRunning = "running"
	// ReseedAttemptCreated 是建成了辅种任务(与任务在同一个事务里写)
	ReseedAttemptCreated = "created"
	// ReseedAttemptFailed 是站点不可用、下载失败、info hash 或文件列表对不上、建任务失败
	ReseedAttemptFailed = "failed"
	// ReseedAttemptGone 是站点上已经没有这个种子
	ReseedAttemptGone = "gone"
	// ReseedAttemptActive 是种子下载、核对过了,但这个 info hash 已有进行中的任务(统计里算跳过)
	ReseedAttemptActive = "active"
	// ReseedAttemptInterrupted 是这一轮被停止、超时或 pt-tools 退出打断了(不改辅种记录,以后照常再试)
	ReseedAttemptInterrupted = "interrupted"
)

辅种尝试的结局。

View Source
const (
	// ServarrKindMovie 的 ExternalID 是电影订阅的编号(Radarr 的 movie id)
	ServarrKindMovie = "movie"
	// ServarrKindSeries 的 ExternalID 是剧集的 TMDB 编号(Sonarr 的 series id)
	ServarrKindSeries = "series"
)

标签挂在哪种条目上。

View Source
const (
	AttendanceTriggerAuto   = "auto"
	AttendanceTriggerManual = "manual"
)

一次签到尝试是怎么触发的。

View Source
const (
	AttendanceResultSigned      = "signed"
	AttendanceResultAlready     = "already"
	AttendanceResultRetry       = "retry"
	AttendanceResultFailed      = "failed"
	AttendanceResultUnsupported = "unsupported"
)

一次签到尝试的结果。retry 是这次没成、之后还会再试;failed 是当天不再试(或者手动签到失败)。

View Source
const (
	AttendanceMethodDirect    = "direct"
	AttendanceMethodAICaptcha = "ai_captcha"
	AttendanceMethodAIQuiz    = "ai_quiz"
)

签到用的方式:直接签到,或者借助 AI 识别验证码、答题。

View Source
const (
	AttendancePending     = "pending"
	AttendanceSigned      = "signed"
	AttendanceAlready     = "already"
	AttendanceFailed      = "failed"
	AttendanceUnsupported = "unsupported"
)

每日签到的状态。pending 之外都是当天的最终结果,不再请求站点。

View Source
const (
	DefaultBanThresholdDays = 30
	DefaultRemindBeforeDays = 10
)
View Source
const (
	// TransferPending 是刚建好、还没拿到种子文件的任务。
	TransferPending = "pending"
	// TransferExported 是种子文件已经拿到,等着加入目标下载器。
	TransferExported = "exported"
	// TransferAdding 是正在把种子暂停加入目标:先记下这个状态再推送,进程在推送途中退出时,
	// 重启后按目标里有没有这个种子决定继续还是重推。
	TransferAdding = "adding"
	// TransferChecking 是已经暂停加入目标、正在校验数据。
	TransferChecking = "checking"
	// TransferVerified 是目标校验到了 100%,接下来恢复目标、从源移除。
	TransferVerified = "verified"
	// TransferDone 是目标已经开始做种、源里的种子已移除(数据保留)。
	TransferDone = "source_removed"
	// TransferRolledBack 是校验没到 100% 或超时:目标里的种子已移除(数据保留),源不动。
	TransferRolledBack = "rolled_back"
	// TransferFailed 是加入目标之前就失败了(拿不到种子文件、目标已有这个种子、闸门拒绝等),源不动。
	TransferFailed = "failed"
	// TransferCanceled 是用户在加入目标之前取消的任务。
	TransferCanceled = "canceled"
)

转移做种任务的状态。TransferStateFinal 为真的是终态。

View Source
const (
	TransferRuleDefaultMaxPerRun   = 10
	TransferRuleDefaultIntervalMin = 60
	TransferRuleMinIntervalMin     = 10
	TransferRuleMaxPerRun          = 100
)

定时规则的默认值与范围。

View Source
const AppMetaLastStartedVersion = "last_started_version"

AppMetaLastStartedVersion 是上次正常启动(运行时初始化走完)的程序版本。

View Source
const AttendanceEventRetention = 90 * 24 * time.Hour

AttendanceEventRetention 是签到事件留多久,更早的每天清一次。

View Source
const BrushTagAll = "pt-tools-brush"

BrushTagAll 是所有刷流种子都带的标签,方便在下载器里认出刷流种子。归属不按它认:自动删种、做种竞争度按刷流记录 (BrushRepository.ActiveHashesOn)认刷流任务正在管的种子,交还以后的种子即使还带着它,也按自动删种的规则处理。

View Source
const CurrentSchemaVersion = 17

当前数据库架构版本 每次添加新的迁移时递增此值

View Source
const DefaultFilterMode = FilterModeAutoFree

DefaultFilterMode is the fallback when neither RSS nor Global specifies one.

View Source
const KeepTag = "pt-tools-keep"

KeepTag 是「保留」标签:带它的种子,自动删种(含紧急清理与免费到期兜底)、做种竞争度、免费结束时的删除、刷流删种都不删。 网页「下载器」页的种子列表一键加上或去掉;也可以在下载器里自己打,或者把 RSS 的标签填成它。

View Source
const MediaAdoptedSitePrefix = "downloader:"

MediaAdoptedSitePrefix 是追剧认领的下载器里的种子的站点名前缀(后面是下载器编号)。

View Source
const ReseedAttemptKeepFor = 5 * 366 * 24 * time.Hour

ReseedAttemptKeepFor 是尝试行的保留时间(统计的自定义范围最长 5 年)。

View Source
const ReseedTag = "pt-tools-reseed"

ReseedTag 是辅种加进下载器时带上的标签:恢复、回滚、收尾前确认目标里的种子带着它,证明是辅种加的。

View Source
const TransferTag = "pt-tools-transfer"

TransferTag 是转移做种加入目标时带上的标签:恢复、回滚、收尾前都要确认目标里的种子带着它, 证明是这次转移加的,不去动用户自己加的同一个种子。

Variables

View Source
var EncryptedColumns = []EncryptedColumn{
	{"site_settings", "cookie_encrypted"},
	{"notification_conf", "config_json"},
	{"cloak_settings", "token_encrypted"},
	{"media_libraries", "csf_key_encrypted"},
	{"nas_sources", "secret_encrypted"},
	{"nas_sources", "extra_encrypted"},
}

EncryptedColumns 列出以 AES-GCM 密文保存的列(站点 Cookie、通知配置、CloakBrowser 令牌、ChineseSubFinder 的 API Key、 NAS 监控来源的密钥与刷新出的凭据):非空即说明库里有用某个密钥 加密过的数据。启动检查(core 的 checkGeneratedSecretKey)与备份校验(internal/backup)用同一份清单。

View Source
var ErrBrushTaskNotFound = errors.New("刷流任务不存在")

ErrBrushTaskNotFound 表示任务不存在。

View Source
var ErrBrushTorrentTaken = errors.New("这个种子已经由别的刷流任务加入")

ErrBrushTorrentTaken 表示这个站点种子已经由别的刷流任务加入过(site_name + torrent_id 唯一)。

View Source
var ExampleRSSPatterns = []string{
	"springxxx.xxx",
	"hdsky.xxx",
	"rss.m-team.xxx",
	"example.com",
	"xxx.xxx",
}

ExampleRSSPatterns 示例 RSS URL 的特征模式 包含这些模式的 URL 被认为是示例配置

View Source
var FreeLevelAliases = map[string][]string{
	"FREE":       {"FREE"},
	"2XFREE":     {"2XFREE", "_2X_FREE", "2X FREE"},
	"PERCENT_50": {"PERCENT_50", "50%"},
	"PERCENT_30": {"PERCENT_30", "30%"},
	"PERCENT_70": {"PERCENT_70", "70%"},
	"2XUP":       {"2XUP", "_2X_UP", "2X"},
	"2X50":       {"2X50", "_2X_PERCENT_50", "2X50%"},

	"NONE": {"NONE", "NORMAL", ""},
}

FreeLevelAliases 把一个规范优惠档映射到库里可能出现过的全部拼法(大写形式)。

MediaFailKinds 是所有的失败分类,按页面上的顺序。

View Source
var SiteLoginPresets = map[string]SiteLoginPreset{
	"mteam": {
		BanThresholdDays: DefaultBanThresholdDays,
		RemindBeforeDays: DefaultRemindBeforeDays,
		Notes:            "M-Team default inactivity reminder policy; fallback 30/10 until site-specific source is confirmed.",
	},
}

TransferActiveStates 是未结束的状态(同一个种子同一时间只能有一个这样的任务)。

Functions

func ApplyPresetIfMissing added in v0.35.0

func ApplyPresetIfMissing(siteName string) (banThresholdDays, remindBeforeDays int, hasPreset bool)

func BrushTaskTag

func BrushTaskTag(taskID uint) string

BrushTaskTag 是某个刷流任务专属的标签,删种只处理带这个标签、且有 BrushTorrent 记录的种子。

func CanonicalFreeLevel added in v0.48.0

func CanonicalFreeLevel(raw string) string

CanonicalFreeLevel 把任意一种拼法收敛到规范档名。 认不出来的原样返回(大写去空白),调用方据此仍能做等值匹配而不是静默放行。

func FreeLevelQueryValues added in v0.48.0

func FreeLevelQueryValues(raw string) []string

FreeLevelQueryValues 返回筛某一档时应当匹配的全部存库拼法(大写)。 未知档位返回它自己,查询照样成立,只是命中为空。

func GetLatestMigrationCompletedAt added in v0.35.0

func GetLatestMigrationCompletedAt(db *gorm.DB) (time.Time, bool)

GetLatestMigrationCompletedAt returns the newest recorded migration completion timestamp; ok=false if table or rows are absent.

func IsExampleURL added in v0.2.0

func IsExampleURL(url string) bool

IsExampleURL 检查 URL 是否为示例 URL

func IsPlaceholderRSSHost

func IsPlaceholderRSSHost(host string) bool

IsPlaceholderRSSHost 判断 RSS 地址的主机是不是示例里的占位地址(hdsky.xxx、springxxx.xxx、rss.m-team.xxx 这类, 顶级域都是 xxx):照着示例填、忘了换成真实链接的 RSS 永远取不到,不去请求它。 只看 .xxx 结尾(没有一个内置站点在 .xxx 顶级域上);example.com 这类不算,测试与文档里常拿它当真实地址用。

func JobOwnerTag

func JobOwnerTag(kind string) string

JobOwnerTag 是这一种任务加进下载器时带上的通用标签(显示与分类用)。

func JobTag

func JobTag(kind string, id uint) string

JobTag 是任务 id 加进下载器时带上的独有标签(如 pt-tools-reseed-12):通用标签谁都能加,证明不了种子是这个任务加的。

func MapTransferPath

func MapTransferPath(maps []DownloaderPathMap, src string) (string, bool)

MapTransferPath 把源下载器里的路径换算成目标下载器里的路径:取最长的匹配前缀(按路径分段匹配, /data 不匹配 /database);没有匹配时原样返回,第二个返回值为 false。 Windows 路径(盘符或 \\ 开头)不区分大小写,/ 与 \ 都认;Unix 路径区分大小写。 前缀两边一个是 Windows 路径、一个是 Unix 路径时,余下部分的分隔符换成目标的写法。

func MarkBroadcastSent added in v0.35.0

func MarkBroadcastSent(db *gorm.DB, schemaVersion int) error

MarkBroadcastSent flips BroadcastSent=true for the given schema version.

func MigrateExampleRSS added in v0.2.0

func MigrateExampleRSS(db *gorm.DB) error

MigrateExampleRSS 迁移旧版本的示例 RSS 配置 将 URL 包含示例模式的 RSS 订阅标记为 IsExample=true

func ReadAppMeta

func ReadAppMeta(db *gorm.DB, key string) (string, error)

ReadAppMeta 用原生 SQL 读一项。表还不存在(升级前备份在 AutoMigrate 之前调用)或没有这一项时返回空串。

func ReseedRunEndedEarly

func ReseedRunEndedEarly(status string) bool

ReseedRunEndedEarly 报告这一轮是不是提前停下的(可以接着往下查)。

func ReseedSiteModeOf

func ReseedSiteModeOf(mode string, siteNames []string) string

ReseedSiteModeOf 是设置里生效的站点范围:SiteMode 为空(旧数据)时,名单为空是全部,不为空是只算名单。 siteNames 是解出来的名单。

func SaveNasSetting

func SaveNasSetting(db *gorm.DB, s NasSetting) error

SaveNasSetting 写「NAS 监控」的设置(只有 id=1 一行)。

func SyncSitesFromRegistry added in v0.2.0

func SyncSitesFromRegistry(db *gorm.DB, registeredSites []RegisteredSite) error

SyncSitesFromRegistry 从注册表同步站点到数据库 每次应用启动时调用,确保数据库中包含所有注册的站点 保留用户配置(cookie/api_key/enabled),不删除任何用户数据

func TableExists

func TableExists(db *gorm.DB, table string) (bool, error)

TableExists 用 sqlite_master 查一张表在不在(AutoMigrate 之前也能用)。

func TransferStateFinal

func TransferStateFinal(state string) bool

TransferStateFinal 报告状态是不是终态。

func UpsertMigrationState added in v0.35.0

func UpsertMigrationState(db *gorm.DB, schemaVersion int, completedAt time.Time) error

UpsertMigrationState writes (or updates) the row for schemaVersion. Idempotent.

func WriteAppMeta

func WriteAppMeta(db *gorm.DB, key, value string) error

WriteAppMeta 写一项,已有就更新。

Types

type APIResponse

type APIResponse[T ResType] struct {
	Message string `json:"message"`
	Data    T      `json:"data"`
	Code    any    `json:"code"`
}

type APIToken

type APIToken struct {
	ID   uint   `gorm:"primaryKey" json:"id"`
	Name string `gorm:"size:64;not null;default:''" json:"name"`
	// SecretHash 是 secret 的 SHA-256(十六进制)
	SecretHash string `gorm:"size:64;not null;default:''" json:"-"`
	// Scopes 是空格分隔的权限范围(app:read app:write 等)
	Scopes     string     `gorm:"size:255;not null;default:''" json:"-"`
	ExpiresAt  *time.Time `json:"expires_at,omitempty"`
	LastUsedAt *time.Time `json:"last_used_at,omitempty"`
	CreatedBy  string     `gorm:"size:64;not null;default:''" json:"created_by"`
	CreatedAt  time.Time  `json:"created_at"`
}

APIToken 是给 App、MCP 与 qB 兼容入口用的 API 令牌(路线图 M12)。令牌是 `ptt_<id>_<secret>`:明文只在新建时给一次, 库里只存 secret 的 SHA-256。撤销就是删掉这一行,立即生效。

func (APIToken) TableName

func (APIToken) TableName() string

type ActionAudit added in v0.31.0

type ActionAudit struct {
	ID                 uint      `gorm:"primaryKey" json:"id"`
	NotificationConfID uint      `gorm:"not null;index:idx_action_audit_conf_user_time,priority:1" json:"notification_conf_id"`
	ChannelType        string    `gorm:"size:32;not null" json:"channel_type"`
	ChannelUserID      string    `gorm:"size:128;not null;index:idx_action_audit_conf_user_time,priority:2" json:"channel_user_id"`
	Command            string    `gorm:"size:64;not null;index:idx_action_audit_command" json:"command"`
	ArgsJSON           string    `gorm:"type:text" json:"args_json"`
	Result             string    `gorm:"size:32;not null" json:"result"`
	LatencyMs          int64     `gorm:"default:0" json:"latency_ms"`
	CreatedAt          time.Time `gorm:"index:idx_action_audit_conf_user_time,priority:3,sort:desc" json:"created_at"`
}

ActionAudit 命令执行审计日志,Result 取值如 "ok" / "denied" / "error"。 复合索引 (notification_conf_id, channel_user_id, created_at) 用于按用户分页倒序查询。

func (ActionAudit) TableName added in v0.31.0

func (ActionAudit) TableName() string

type AdminUser added in v0.1.0

type AdminUser struct {
	ID           uint   `gorm:"primaryKey"`
	Username     string `gorm:"uniqueIndex;size:64"`
	PasswordHash string `gorm:"size:255"`
	CreatedAt    time.Time
	UpdatedAt    time.Time
}

Admin 用户(单用户登录)

type AppMeta

type AppMeta struct {
	Key       string `gorm:"primaryKey;size:64"`
	Value     string `gorm:"type:text"`
	UpdatedAt time.Time
}

AppMeta 是程序自己的键值记录(app_meta 表),现在只有「上次正常启动的程序版本」一项。 SchemaVersion.AppVersion 只在跑编号迁移时写,代表不了上次运行的版本,升级前备份靠这一项判断换没换版本。

func (AppMeta) TableName

func (AppMeta) TableName() string

type AssistantAttachment

type AssistantAttachment struct {
	ID             uint   `gorm:"primaryKey"`
	Owner          string `gorm:"size:64;not null;default:'';index"`
	ConversationID uint   `gorm:"not null;default:0;index"`
	MessageID      uint   `gorm:"not null;default:0;index"`
	Name           string `gorm:"size:255;not null;default:''"`
	MIME           string `gorm:"column:mime;size:64;not null;default:''"`
	// Kind 是 image 或 text
	Kind string `gorm:"size:8;not null;default:''"`
	// Size 是上传的文件大小(字节)
	Size      int64  `gorm:"not null;default:0"`
	Data      []byte `gorm:"type:blob"`
	CreatedAt time.Time
}

AssistantAttachment 是用户随消息发的附件:图片原样存,文本文件存脱敏以后的内容(交给模型的就是这一份)。 MessageID 为 0 的是传了还没发的,只有上传的属主能看、能删,一天以后清掉;发出去以后跟着会话删。

func (AssistantAttachment) TableName

func (AssistantAttachment) TableName() string

TableName 指定表名。

type AssistantConfirmation

type AssistantConfirmation struct {
	ID             uint   `gorm:"primaryKey"`
	ConversationID uint   `gorm:"not null;default:0;index"`
	RunID          string `gorm:"size:32;not null;default:''"`
	ToolCallID     string `gorm:"size:128;not null;default:''"`
	ToolName       string `gorm:"size:64;not null;default:''"`
	// Arguments 是规范化脱敏以后的参数(JSON),确认后按它调用工具
	Arguments string `gorm:"type:text;not null;default:''"`
	// Preview 是建这条记录以前写工具给的预览(mcp.Preview 的 JSON:改以前、改以后与影响),没有时为空
	Preview string `gorm:"type:text;not null;default:''"`
	Status  string `gorm:"size:16;not null;default:'';index"`
	// DecidedBy 是谁定的:属主,或者 timeout、cancel、restart、shutdown
	DecidedBy string `gorm:"size:64;not null;default:''"`
	DecidedAt *time.Time
	ExpiresAt time.Time
	CreatedAt time.Time
}

AssistantConfirmation 是一个等人确认的写操作。结论只经 WHERE status='pending' 的条件更新得出,改到一行的才算数。

func (AssistantConfirmation) TableName

func (AssistantConfirmation) TableName() string

TableName 指定表名。

type AssistantConversation

type AssistantConversation struct {
	ID    uint   `gorm:"primaryKey"`
	Owner string `gorm:"size:64;not null;default:'';index"`
	Entry string `gorm:"size:16;not null;default:''"`
	Title string `gorm:"size:128;not null;default:''"`
	// Summary 是压缩以后前面那段对话的摘要(脱敏以后的);SummaryUntil 是摘要到哪条消息为止(含),
	// 交给模型的历史从它后面开始,摘要放在系统提示里。都是零值时没有压缩过
	Summary      string `gorm:"type:text;not null;default:''"`
	SummaryUntil uint   `gorm:"not null;default:0"`
	CreatedAt    time.Time
	UpdatedAt    time.Time `gorm:"index"`
}

AssistantConversation 是一个会话。Owner 是带命名空间的属主(web:<用户名>、token:<编号>、device:<编号>、chatops:<绑定编号>), 查询一律按属主过滤。

func (AssistantConversation) TableName

func (AssistantConversation) TableName() string

TableName 指定表名。

type AssistantMessage

type AssistantMessage struct {
	ID             uint   `gorm:"primaryKey"`
	ConversationID uint   `gorm:"not null;default:0;index"`
	RunID          string `gorm:"size:32;not null;default:''"`
	Role           string `gorm:"size:16;not null;default:''"`
	Content        string `gorm:"type:text;not null;default:''"`
	// Reasoning 是模型的推理内容(思考过程):网页与 App 上脱敏以后给人看;ReasoningField 为空时还要回传给模型
	// (DeepSeek 等的思考模式带工具时要求回传)
	Reasoning string `gorm:"type:text;not null;default:''"`
	// ReasoningField 是推理内容从哪儿来的:空是 reasoning_content 字段;reasoning 是同名字段(OpenRouter、Groq、Ollama 等),
	// think 是正文开头的 <think>…</think>。后两种只给人看、不回传:不认 reasoning_content 的服务会拒绝整个请求
	ReasoningField string `gorm:"size:16;not null;default:''"`
	// Model、Effort 是这一轮的模型与推理等级:用户消息是发的时候选的,助手消息是实际请求的;空的是设置里的模型、不指定推理等级
	Model  string `gorm:"size:128;not null;default:''"`
	Effort string `gorm:"size:16;not null;default:''"`
	// ToolCalls 是助手消息里的工具调用(JSON 数组:编号、工具名、规范化脱敏以后的参数)
	ToolCalls  string `gorm:"type:text;not null;default:''"`
	ToolName   string `gorm:"size:64;not null;default:''"`
	ToolCallID string `gorm:"size:128;not null;default:''"`
	IsError    bool   `gorm:"not null;default:false"`
	// PromptTokens、CompletionTokens 是生成这条消息的那次模型调用用掉的 token(服务商报的;没报时为 0)。
	// 助手消息是这一步的请求;压缩时那条提示记的是写摘要的那次调用
	PromptTokens     int64 `gorm:"not null;default:0"`
	CompletionTokens int64 `gorm:"not null;default:0"`
	CreatedAt        time.Time
}

AssistantMessage 是会话里的一条消息,按 ID 排序。文字与工具参数都是脱敏以后的;工具结果来自 App API(本来就不带凭证)。

func (AssistantMessage) TableName

func (AssistantMessage) TableName() string

TableName 指定表名。

type AssistantSetting

type AssistantSetting struct {
	ID      uint `gorm:"primaryKey"`
	Enabled bool `gorm:"not null;default:false"`
	// Provider 是界面上选的服务商预设(deepseek、openai、custom 等),只给界面用
	Provider string `gorm:"size:32;not null;default:''"`
	// BaseURL 是 OpenAI 兼容接口的地址(到 /chat/completions 之前)
	BaseURL         string `gorm:"size:512;not null;default:''"`
	Model           string `gorm:"size:128;not null;default:''"`
	APIKeyEncrypted string `gorm:"type:text;not null;default:''"`
	ProxyEncrypted  string `gorm:"type:text;not null;default:''"`
	// ChatOps 为真时,通知渠道里的非命令消息交给助手
	ChatOps  bool `gorm:"column:chat_ops;not null;default:false"`
	MaxSteps int  `gorm:"not null;default:0"`
	// ConfirmMinutes 是待确认操作等几分钟
	ConfirmMinutes int `gorm:"not null;default:0"`
	// RetentionDays 是会话保留几天,0 表示不清理
	RetentionDays int `gorm:"not null;default:0"`
	// ContextWindow 是模型的上下文窗口(token),0 表示自动(按服务商的模型列表与内置的表)
	ContextWindow int `gorm:"not null;default:0"`
	// CompactPercent 是上下文用到窗口的百分之几时自动压缩,0 表示默认(80)
	CompactPercent int `gorm:"not null;default:0"`
	// AutoCompactOff 为真时不自动压缩(零值是开着)
	AutoCompactOff bool `gorm:"not null;default:false"`
	// 语音输入:Voltip 本机服务(OpenAI 兼容的 /audio/transcriptions)的地址、访问令牌(加密存)、模型与识别语言。
	// 地址与令牌都有时对话页上才有麦克风按钮
	VoiceBaseURL        string `gorm:"size:512;not null;default:''"`
	VoiceTokenEncrypted string `gorm:"type:text;not null;default:''"`
	VoiceModel          string `gorm:"size:128;not null;default:''"`
	VoiceLanguage       string `gorm:"size:16;not null;default:''"`
	UpdatedAt           time.Time
}

AssistantSetting 是 AI 助手的设置,只有一行(ID 为 1);没有这一行时按默认值(关闭)。列的默认值一律是零值。

func (AssistantSetting) TableName

func (AssistantSetting) TableName() string

TableName 指定表名。

type BackupSetting

type BackupSetting struct {
	ID      uint `gorm:"primaryKey"`
	Enabled bool `gorm:"not null"`
	// Time 是每天定时备份的时刻(HH:MM,本地时间)
	Time string `gorm:"size:5;not null"`
	// Keep 是定时备份保留几份(1–60)
	Keep int `gorm:"not null"`
	// Dir 是备份目录,空串表示默认的 <数据目录>/backups
	Dir           string `gorm:"type:text"`
	IncludeSecret bool   `gorm:"not null"`
	// ScheduledDay 是最近一次做过定时备份(不论成败)的日期(YYYY-MM-DD),同一天只做一次
	ScheduledDay string `gorm:"size:10"`

	// 最近一次备份(任何原因)的结果:LastError 为空表示成功
	LastAt     *time.Time
	LastReason string `gorm:"size:16"`
	LastName   string `gorm:"type:text"`
	LastError  string `gorm:"type:text"`
	// LastOKAt 是最近一次成功备份的时间(首页「备份几天没成功」用)
	LastOKAt *time.Time

	// 最近一次启动时恢复的结果:RestoreError 为空表示换上了,换下来的原文件在 RestoreDir
	RestoreAt    *time.Time
	RestoreName  string `gorm:"type:text"`
	RestoreDir   string `gorm:"type:text"`
	RestoreError string `gorm:"type:text"`

	UpdatedAt time.Time
}

BackupSetting 是全局设置里的「备份」与最近一次备份、恢复的结果。只有一行(id=1),没有这一行时按默认 (开着、每天 04:30、保留 7 份、默认目录、带上密钥)。读写只经 core.ConfigStore。

布尔列故意不带 gorm 的 default:gorm 建行时会跳过零值字段、改用数据库默认值,用户关掉的开关会被存成开着。

func (BackupSetting) TableName

func (BackupSetting) TableName() string

type BotToken added in v0.31.0

type BotToken struct {
	ID              uint       `gorm:"primaryKey" json:"id"`
	Kind            string     `gorm:"size:16;not null;index:idx_bot_token_kind" json:"kind"`
	CodeOrTokenHash string     `gorm:"size:255;not null;index:idx_bot_token_hash" json:"-"`
	Scope           string     `gorm:"size:255;default:''" json:"scope"`
	ExpiresAt       *time.Time `gorm:"index:idx_bot_token_expires" json:"expires_at"`
	UsedAt          *time.Time `json:"used_at"`
	CreatedBy       string     `gorm:"size:64" json:"created_by"`
	CreatedAt       time.Time  `json:"created_at"`
}

BotToken 鉴权用 token / 8-char bind code 的持久化记录。 Kind 取值如 "bind_code" / "bearer";CodeOrTokenHash 为 bcrypt hash。

func (BotToken) TableName added in v0.31.0

func (BotToken) TableName() string

type BrushDailyStat

type BrushDailyStat struct {
	ID          uint   `gorm:"primaryKey" json:"id"`
	TaskID      uint   `gorm:"not null;uniqueIndex:idx_brush_stat_task_day,priority:1" json:"task_id"`
	Day         string `gorm:"size:10;not null;uniqueIndex:idx_brush_stat_task_day,priority:2;index" json:"day"`
	Uploaded    int64  `gorm:"not null;default:0" json:"uploaded"`
	Downloaded  int64  `gorm:"not null;default:0" json:"downloaded"`
	Added       int    `gorm:"not null;default:0" json:"added"`
	AddedBytes  int64  `gorm:"not null;default:0" json:"added_bytes"`
	Removed     int    `gorm:"not null;default:0" json:"removed"`
	LastUpdated time.Time
}

BrushDailyStat 是刷流任务每天的收益:(task_id, day) 唯一;上传、下载是当天采样差值的累加。

type BrushRepository

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

BrushRepository 封装刷流相关表的读写。

func NewBrushRepository

func NewBrushRepository(db *gorm.DB) *BrushRepository

func (*BrushRepository) ActiveHashesOn

func (r *BrushRepository) ActiveHashesOn(dlID uint) (map[string]bool, error)

ActiveHashesOn 返回下载器 dlID 上刷流任务正在管的种子(info hash,小写)。自动删种据此把它们留给刷流自己的删种规则。

func (*BrushRepository) ActiveTorrents

func (r *BrushRepository) ActiveTorrents(taskID uint) ([]BrushTorrent, error)

ActiveTorrents 返回任务名下仍在做的种子。

func (*BrushRepository) CountActive

func (r *BrushRepository) CountActive(taskID uint) (int64, error)

CountActive 返回任务名下仍在做的种子数。

func (*BrushRepository) DailyStats

func (r *BrushRepository) DailyStats(taskID uint, fromDay, toDay string) ([]BrushDailyStat, error)

DailyStats 返回 [fromDay, toDay] 的每日统计;taskID 为 0 时返回全部任务。

func (*BrushRepository) DeleteTask

func (r *BrushRepository) DeleteTask(id uint) error

DeleteTask 删除任务和它的统计、采样、种子与运行记录。下载器里的种子不动。

func (*BrushRepository) EndActiveByHash

func (r *BrushRepository) EndActiveByHash(dlID uint, hash, reason string, at time.Time) (int, error)

EndActiveByHash 把下载器 dlID 上这个种子仍在做的刷流记录都交还给用户(gone,终态:刷流不再管它,也不会再加回来),返回交还了几条。 网页点「保留」时在同一次操作里调用,不等刷流下一轮发现标签。

func (*BrushRepository) FinishRun

func (r *BrushRepository) FinishRun(run *BrushRun) error

FinishRun 补上一轮运行的结果、计数与步骤。

func (*BrushRepository) GetTask

func (r *BrushRepository) GetTask(id uint) (*BrushTask, error)

func (*BrushRepository) IsActive

func (r *BrushRepository) IsActive(id uint) (bool, error)

IsActive 报告这条刷流记录现在是不是仍在做:刷流删种在删除锁里用它复查,一轮开头读进内存的记录可能已经被交还。

func (*BrushRepository) ListRuns

func (r *BrushRepository) ListRuns(taskID uint, limit, offset int) ([]BrushRun, int64, error)

ListRuns 分页列出任务的运行记录,新的在前;同时给出总条数。

func (*BrushRepository) ListTasks

func (r *BrushRepository) ListTasks() ([]BrushTask, error)

func (*BrushRepository) ListTorrents

func (r *BrushRepository) ListTorrents(taskID uint, state string, page, pageSize int) ([]BrushTorrent, int64, error)

ListTorrents 分页列出任务的种子;state 为空时列全部,新的在前。

func (*BrushRepository) MarkEnded

func (r *BrushRepository) MarkEnded(bt *BrushTorrent, state, reason string, at time.Time, day string) error

MarkEnded 把种子记为终态(removed 或 gone);removed 时计入当天的删除数。

func (*BrushRepository) MarkInterruptedRuns

func (r *BrushRepository) MarkInterruptedRuns(before, at time.Time) (int64, error)

MarkInterruptedRuns 把 before 以前开始、还写着「进行中」的运行记成没跑完(启动时调用:上一个进程在一轮中途退出了)。 before 取这个进程的刷流监控建好的时刻,这个进程里刚开始的一轮不受影响。

func (*BrushRepository) MarkRun

func (r *BrushRepository) MarkRun(id uint, at time.Time, result, lastErr string) error

MarkRun 记下一轮运行的时间、结果摘要与错误(错误为空表示这一轮正常)。

func (*BrushRepository) PruneRuns

func (r *BrushRepository) PruneRuns(before time.Time, keepPerTask int) (int64, error)

PruneRuns 删掉 before 以前开始的运行记录,并且每个任务只留最新的 keepPerTask 条;返回删掉的行数。 时间按时刻比较(julianday),不按文本,存的时区不同也不会差几个小时。

func (*BrushRepository) PruneSamples

func (r *BrushRepository) PruneSamples(before time.Time) (int64, error)

PruneSamples 删掉 before 之前的采样;返回删掉的行数。

func (*BrushRepository) RecordAdded

func (r *BrushRepository) RecordAdded(bt *BrushTorrent, day string) error

RecordAdded 记下一个推送成功的种子,并把当天的加入数与体积记进统计。同一任务同一 hash 已有记录时不重复记; 这个站点种子已经归别的任务时返回 ErrBrushTorrentTaken(调用方应撤回刚加的这一份)。

func (*BrushRepository) RecordSample

func (r *BrushRepository) RecordSample(bt *BrushTorrent, sample BrushTorrentSample, progress, ratio float64, seedingSec int64, loc *time.Location) error

RecordSample 写一次采样,更新种子的最近状态,并把与上次采样的差值(只计正数)累加到每日统计里。 差值按时间比例分摊到它跨过的每一天(loc 是分天的时区):23:55 与次日 00:05 之间的量不会全记到次日。 第一次采样从加入时刻算起:推送前下载器里没有这个种子,累计值本身就是这段时间的量。

func (*BrushRepository) SamplesSince

func (r *BrushRepository) SamplesSince(brushTorrentID uint, since time.Time) ([]BrushTorrentSample, error)

SamplesSince 返回种子在 since 及之后的采样(按时间升序),外加 since 之前最近的一条(作为窗口起点)。

func (*BrushRepository) SaveTask

func (r *BrushRepository) SaveTask(task *BrushTask) error

SaveTask 新建(ID 为 0)或整行更新一个任务的配置;运行状态列(last_*)由 MarkRun 单独写,这里不覆盖。

func (*BrushRepository) SeenSiteTorrentIDs

func (r *BrushRepository) SeenSiteTorrentIDs(siteName string) (map[string]bool, error)

SeenSiteTorrentIDs 返回所有刷流任务在这个站点推送过的种子 ID(不论哪个任务、现在什么状态): 同一个站点种子不会被两个任务各加一份(两份会争用同一条 TorrentInfo 记录)。

func (*BrushRepository) StartRun

func (r *BrushRepository) StartRun(taskID uint, trigger string, at time.Time) (*BrushRun, error)

StartRun 写一条进行中的运行记录(进程中途退出时也看得到这一轮开始过)。

func (*BrushRepository) TaskTotals

func (r *BrushRepository) TaskTotals() (map[uint]BrushDailyStat, error)

TaskTotals 返回每个任务累计的上传与下载(全部日期)。

type BrushRun

type BrushRun struct {
	ID         uint       `gorm:"primaryKey" json:"id"`
	TaskID     uint       `gorm:"not null;index" json:"task_id"`
	Trigger    string     `gorm:"size:16;not null;default:''" json:"trigger"`
	StartedAt  time.Time  `gorm:"not null;index" json:"started_at"`
	FinishedAt *time.Time `json:"finished_at,omitempty"`
	Status     string     `gorm:"size:16;not null;default:''" json:"status"`
	Summary    string     `gorm:"size:1024;not null;default:''" json:"summary"`
	Error      string     `gorm:"size:1024;not null;default:''" json:"error"`
	Listed     int        `gorm:"not null;default:0" json:"listed"`
	Eligible   int        `gorm:"not null;default:0" json:"eligible"`
	Added      int        `gorm:"not null;default:0" json:"added"`
	Removed    int        `gorm:"not null;default:0" json:"removed"`
	Gone       int        `gorm:"not null;default:0" json:"gone"`
	// Steps 是这一轮的步骤(BrushRunStep 的 JSON 数组,最多 16 KiB;超出时后面的不记,StepsTruncated 为真)
	Steps          string `gorm:"type:text;not null;default:''" json:"-"`
	StepsTruncated bool   `gorm:"not null;default:false" json:"steps_truncated"`
}

BrushRun 是刷流任务的一轮运行(定时或手动「立即运行」):先写一条进行中的记录,跑完再补上结果与步骤。 每个任务保留最近 500 条,且不超过 14 天(见 scheduler 的 brushRunKeep*)。

func (BrushRun) StepList

func (r BrushRun) StepList() []BrushRunStep

StepList 解出这一轮的步骤;没有记下或解不开时为空。

func (BrushRun) TableName

func (BrushRun) TableName() string

type BrushRunStep

type BrushRunStep struct {
	Kind string `json:"kind"`
	Text string `json:"text"`
}

BrushRunStep 是一轮运行里的一步:Kind 是种类(list、reject、add、remove、gone、skip、stop、error、info),Text 给人看。

type BrushTask

type BrushTask struct {
	ID           uint   `gorm:"primaryKey" json:"id"`
	Name         string `gorm:"size:64;not null;uniqueIndex" json:"name"`
	Enabled      bool   `gorm:"not null;default:false" json:"enabled"`
	SiteName     string `gorm:"size:64;not null;index" json:"site_name"`
	DownloaderID uint   `gorm:"not null" json:"downloader_id"`
	SavePath     string `gorm:"size:512;default:''" json:"save_path"`
	Category     string `gorm:"size:128;default:''" json:"category"`
	// Tags 是用户额外加的标签(逗号分隔);站点名、pt-tools-brush 和任务标签总会带上。
	Tags        string `gorm:"size:256;default:''" json:"tags"`
	IntervalMin int    `gorm:"not null;default:0" json:"interval_min"`
	// Section 是读哪个分区的种子列表,只对 M-Team:normal 综合区、adult 成人区、all 两个都读;空值等于 normal。
	// 别的站点保存为空。
	Section string `gorm:"size:16;default:''" json:"section"`

	// 入场条件
	// Discounts 是允许的优惠类型(逗号分隔的 DiscountLevel,如 FREE,2XFREE);为空时只收免费(FREE、2XFREE)。
	Discounts        string  `gorm:"size:128;default:''" json:"discounts"`
	MinFreeRemainMin int     `gorm:"not null;default:0" json:"min_free_remain_min"`
	MinSizeGB        float64 `gorm:"not null;default:0" json:"min_size_gb"`
	MaxSizeGB        float64 `gorm:"not null;default:0" json:"max_size_gb"`
	MaxSeeders       int     `gorm:"not null;default:0" json:"max_seeders"`
	MinLeechers      int     `gorm:"not null;default:0" json:"min_leechers"`
	MaxPublishAgeMin int     `gorm:"not null;default:0" json:"max_publish_age_min"`
	ExcludeHR        bool    `gorm:"not null;default:false" json:"exclude_hr"`
	// IncludeKeywords / ExcludeKeywords 按行或逗号分隔,大小写不敏感地匹配标题与副标题。
	IncludeKeywords string `gorm:"size:1024;default:''" json:"include_keywords"`
	ExcludeKeywords string `gorm:"size:1024;default:''" json:"exclude_keywords"`

	// 限额
	MaxDownloading     int     `gorm:"not null;default:0" json:"max_downloading"`
	MaxTotalSizeGB     float64 `gorm:"not null;default:0" json:"max_total_size_gb"`
	MaxDailyDownloadGB float64 `gorm:"not null;default:0" json:"max_daily_download_gb"`

	// 删种规则(任一条满足即删)
	RemoveSeedTimeH float64 `gorm:"not null;default:0" json:"remove_seed_time_h"`
	RemoveRatio     float64 `gorm:"not null;default:0" json:"remove_ratio"`
	// RemoveLowSpeedKBs 与 RemoveLowSpeedWindowMin 一起用:已完成的种子最近 N 分钟的平均上传速度低于阈值时删。
	RemoveLowSpeedKBs           float64 `gorm:"not null;default:0" json:"remove_low_speed_kbs"`
	RemoveLowSpeedWindowMin     int     `gorm:"not null;default:0" json:"remove_low_speed_window_min"`
	RemoveInactiveH             float64 `gorm:"not null;default:0" json:"remove_inactive_h"`
	RemoveFreeExpiredIncomplete bool    `gorm:"not null;default:false" json:"remove_free_expired_incomplete"`
	RemoveWithData              bool    `gorm:"not null;default:false" json:"remove_with_data"`

	LastRunAt  *time.Time `json:"last_run_at,omitempty"`
	LastError  string     `gorm:"size:1024;default:''" json:"last_error"`
	LastResult string     `gorm:"size:512;default:''" json:"last_result"`
	CreatedAt  time.Time  `json:"created_at"`
	UpdatedAt  time.Time  `json:"updated_at"`
}

BrushTask 是一个刷流任务:从一个站点的免费列表里按入场条件挑种子推给一个下载器,再按删种规则删掉。 默认关闭。时长、体积的 0 一律表示「不限」。 列的默认值一律是零值:GORM 新建时会把零值换成 default,非零的默认值会让关掉的开关(如删种不删文件)存成打开; 新任务的默认取值在前端表单里。

func (BrushTask) TagList

func (t BrushTask) TagList() []string

TagList 返回推送时给种子打的全部标签:站点名、pt-tools-brush、任务标签,再加用户标签(去重、保持顺序)。

type BrushTorrent

type BrushTorrent struct {
	ID       uint   `gorm:"primaryKey" json:"id"`
	TaskID   uint   `gorm:"not null;uniqueIndex:idx_brush_task_hash,priority:1;index" json:"task_id"`
	InfoHash string `gorm:"size:64;not null;uniqueIndex:idx_brush_task_hash,priority:2" json:"info_hash"`
	// (site_name, torrent_id) 唯一:同一个站点种子只由一个刷流任务加入一次(删掉之后也不再加回来)
	SiteName  string `gorm:"size:64;not null;uniqueIndex:idx_brush_site_torrent,priority:1" json:"site_name"`
	TorrentID string `gorm:"size:128;not null;uniqueIndex:idx_brush_site_torrent,priority:2" json:"torrent_id"`
	Title     string `gorm:"size:512;default:''" json:"title"`
	SizeBytes int64  `gorm:"not null;default:0" json:"size_bytes"`
	// Discount 是推送时的优惠类型(DiscountLevel)。
	Discount     string     `gorm:"size:16;default:''" json:"discount"`
	FreeEndAt    *time.Time `json:"free_end_at,omitempty"`
	HasHR        bool       `gorm:"not null;default:false" json:"has_hr"`
	HRSeedTimeH  int        `gorm:"not null;default:0" json:"hr_seed_time_h"`
	DownloaderID uint       `gorm:"not null" json:"downloader_id"`
	State        string     `gorm:"size:16;not null;default:'active';index" json:"state"`
	AddedAt      time.Time  `gorm:"not null" json:"added_at"`
	RemovedAt    *time.Time `json:"removed_at,omitempty"`
	RemoveReason string     `gorm:"size:256;default:''" json:"remove_reason"`

	// 最近一次采样时下载器报告的累计值,用于算每天的增量。
	Uploaded       int64      `gorm:"not null;default:0" json:"uploaded"`
	Downloaded     int64      `gorm:"not null;default:0" json:"downloaded"`
	Progress       float64    `gorm:"not null;default:0" json:"progress"`
	Ratio          float64    `gorm:"not null;default:0" json:"ratio"`
	SeedingTimeSec int64      `gorm:"not null;default:0" json:"seeding_time_sec"`
	LastActivityAt *time.Time `json:"last_activity_at,omitempty"`
	LastSampleAt   *time.Time `json:"last_sample_at,omitempty"`
}

BrushTorrent 是刷流任务推送过的一个种子;(task_id, info_hash) 唯一。

type BrushTorrentSample

type BrushTorrentSample struct {
	ID             uint      `gorm:"primaryKey" json:"id"`
	BrushTorrentID uint      `gorm:"not null;index:idx_brush_sample_torrent_at,priority:1" json:"brush_torrent_id"`
	At             time.Time `gorm:"not null;index:idx_brush_sample_torrent_at,priority:2;index" json:"at"`
	Uploaded       int64     `gorm:"not null" json:"uploaded"`
	Downloaded     int64     `gorm:"not null" json:"downloaded"`
}

BrushTorrentSample 是一次采样:种子在下载器里的累计上传、下载量。只为算「最近 N 分钟的平均上传速度」保留, 超过最长窗口的旧行定期删掉。

type ChannelBinding added in v0.31.0

type ChannelBinding struct {
	ID                 uint       `gorm:"primaryKey" json:"id"`
	NotificationConfID uint       `gorm:"not null;index:idx_channel_binding_conf_user,priority:1" json:"notification_conf_id"`
	ChannelType        string     `gorm:"size:32;not null;index:idx_channel_binding_type" json:"channel_type"`
	ChannelUserID      string     `gorm:"size:128;not null;index:idx_channel_binding_conf_user,priority:2" json:"channel_user_id"`
	PtAdmin            bool       `gorm:"default:false" json:"pt_admin"`
	Allowed            bool       `gorm:"default:false" json:"allowed"`
	Label              string     `gorm:"size:128" json:"label"`
	ReplyLang          string     `gorm:"size:16;default:''" json:"reply_lang"`
	CreatedAt          time.Time  `json:"created_at"`
	LastActiveAt       *time.Time `json:"last_active_at"`
}

ChannelBinding 渠道用户与 NotificationConf 的绑定关系。 PtAdmin 标记该用户是否为管理员;Allowed 表示是否在白名单内。

func (ChannelBinding) TableName added in v0.31.0

func (ChannelBinding) TableName() string

type CloakSettings added in v0.35.0

type CloakSettings struct {
	ID             uint   `gorm:"primaryKey" json:"id"`
	Endpoint       string `gorm:"size:512" json:"endpoint"`
	TokenEncrypted string `gorm:"size:1024" json:"-"` // 永远不出现在 JSON
	// ProfileID 是登录探测后备使用的 CloakBrowser profile;与 Endpoint、Token 三项齐全才启用后备。
	ProfileID string    `gorm:"size:128" json:"profile_id"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

CloakSettings 持久化 CloakBrowser-Manager 接入信息(v2)。 单行表(约定 ID=1)。Token 仅以 AES-GCM 密文形式落库, 字段名 `TokenEncrypted` 与 SiteSetting.CookieEncrypted 保持一致。

type Config added in v0.1.0

type Config struct {
	Global SettingsGlobal           `json:"global"`
	Qbit   QbitSettings             `json:"qbit"`
	Sites  map[SiteGroup]SiteConfig `json:"sites"`
}

type CookieCloudSetting

type CookieCloudSetting struct {
	ID uint `gorm:"primaryKey" json:"id"`
	// ServerURL 是 CookieCloud 服务地址,UUID 是浏览器扩展里的用户 KEY。
	ServerURL string `gorm:"size:512;default:''" json:"server_url"`
	UUID      string `gorm:"size:128;default:''" json:"uuid"`
	// PasswordEncrypted 是加密后的端对端加密密码;接口只返回是否已设置。密码只在本机解密用,不发给 CookieCloud 服务。
	PasswordEncrypted string `gorm:"type:text;default:''" json:"-"`
	// AutoSync 打开后按间隔把有变化的 Cookie 写进已启用的站点。
	AutoSync bool `gorm:"not null;default:false" json:"auto_sync"`
	// IntervalHours 是定时同步的间隔(0 时按 CookieCloudDefaultIntervalHours)。
	IntervalHours int        `gorm:"not null;default:0" json:"interval_hours"`
	LastSyncAt    *time.Time `json:"last_sync_at,omitempty"`
	// LastResult 是上一次同步的一句话结果(不含 Cookie 内容)。
	LastResult string    `gorm:"type:text;default:''" json:"last_result"`
	UpdatedAt  time.Time `json:"updated_at"`
}

CookieCloudSetting 是从自建 CookieCloud 服务导入站点 Cookie 的设置(只有一行,ID 为 1)。默认不定时同步;列的默认值一律是零值。

func (CookieCloudSetting) TableName

func (CookieCloudSetting) TableName() string

TableName 指定表名。

type DiscountType

type DiscountType string

DiscountType 定义优惠类型

const (
	DISCOUNT_NONE        DiscountType = "none"
	DISCOUNT_FREE        DiscountType = "free"
	DISCOUNT_TWO_X       DiscountType = "2x"
	DISCOUNT_TWO_X_FREE  DiscountType = "2xfree"
	DISCOUNT_THIRTY      DiscountType = "30%"
	DISCOUNT_FIFTY       DiscountType = "50%"
	DISCOUNT_TWO_X_FIFTY DiscountType = "2x50%"
	DISCOUNT_CUSTOM      DiscountType = "custom"
)

type DownloaderDirectory added in v0.2.0

type DownloaderDirectory struct {
	ID           uint      `gorm:"primaryKey" json:"id"`
	DownloaderID uint      `gorm:"index;not null" json:"downloader_id"` // 关联的下载器ID
	Path         string    `gorm:"size:512;not null" json:"path"`       // 目录路径
	Alias        string    `gorm:"size:128" json:"alias"`               // 目录别名(用于显示)
	IsDefault    bool      `json:"is_default"`                          // 是否为默认目录
	CreatedAt    time.Time `json:"created_at"`
	UpdatedAt    time.Time `json:"updated_at"`
}

DownloaderDirectory 下载器目录配置 用于设置下载器的多个下载目录及其别名

func (DownloaderDirectory) TableName added in v0.2.0

func (DownloaderDirectory) TableName() string

TableName 指定表名

type DownloaderPathMap

type DownloaderPathMap struct {
	ID                 uint      `gorm:"primaryKey" json:"id"`
	SourceDownloaderID uint      `gorm:"not null;uniqueIndex:idx_downloader_path_map" json:"source_downloader_id"`
	TargetDownloaderID uint      `gorm:"not null;uniqueIndex:idx_downloader_path_map" json:"target_downloader_id"`
	SourcePrefix       string    `gorm:"size:512;not null;uniqueIndex:idx_downloader_path_map" json:"source_prefix"`
	TargetPrefix       string    `gorm:"size:512;not null" json:"target_prefix"`
	CreatedAt          time.Time `json:"created_at"`
	UpdatedAt          time.Time `json:"updated_at"`
}

DownloaderPathMap 是两个下载器之间的路径对应:源下载器看到的 SourcePrefix,在目标下载器里是 TargetPrefix。 换算时取最长的匹配前缀;没有匹配时路径不变。

func (DownloaderPathMap) TableName

func (DownloaderPathMap) TableName() string

TableName 指定表名。

type DownloaderSetting added in v0.2.0

type DownloaderSetting struct {
	ID          uint      `gorm:"primaryKey" json:"id"`
	Name        string    `gorm:"uniqueIndex;size:64;not null" json:"name"`
	Type        string    `gorm:"size:32;not null" json:"type"` // qbittorrent, transmission
	URL         string    `gorm:"size:512;not null" json:"url"`
	Username    string    `gorm:"size:128" json:"username"`
	Password    string    `gorm:"size:256" json:"password"`
	IsDefault   bool      `json:"is_default"`
	Enabled     bool      `json:"enabled"`
	AutoStart   bool      `json:"auto_start"`                              // 推送种子后自动开始下载
	ExtraConfig string    `gorm:"type:text" json:"extra_config,omitempty"` // JSON格式的额外配置
	CreatedAt   time.Time `json:"created_at"`
	UpdatedAt   time.Time `json:"updated_at"`
}

DownloaderSetting 下载器设置

func (DownloaderSetting) TableName added in v0.2.0

func (DownloaderSetting) TableName() string

TableName 指定表名

type EncryptedColumn

type EncryptedColumn struct {
	Table, Column string
}

EncryptedColumn 是一个以 AES-GCM 密文保存的列。

type FaviconCache added in v0.2.0

type FaviconCache struct {
	ID          uint      `gorm:"primaryKey" json:"id"`
	SiteID      string    `gorm:"uniqueIndex;size:64;not null" json:"site_id"` // 站点标识,如 "hdsky", "mteam"
	SiteName    string    `gorm:"size:128" json:"site_name"`                   // 站点名称
	FaviconURL  string    `gorm:"size:512" json:"favicon_url"`                 // 原始 favicon URL
	Data        []byte    `gorm:"type:blob" json:"-"`                          // 图标二进制数据
	ContentType string    `gorm:"size:64" json:"content_type"`                 // MIME 类型
	ETag        string    `gorm:"size:128" json:"etag"`                        // 用于缓存验证
	LastFetched time.Time `json:"last_fetched"`                                // 最后获取时间
	CreatedAt   time.Time `json:"created_at"`
	UpdatedAt   time.Time `json:"updated_at"`
}

FaviconCache 站点图标缓存(存储在数据库中)

type FilterMode added in v0.25.0

type FilterMode string

FilterMode controls which download channels are active for an RSS feed.

const (
	// FilterModeAutoFree enables both the free auto-download channel and
	// the filter-rule channel. This preserves pre-v0.25 behavior and is the default.
	FilterModeAutoFree FilterMode = "auto_free"
	// FilterModeFilterOnly disables the free auto-download channel; only torrents
	// matching an associated filter rule are downloaded.
	FilterModeFilterOnly FilterMode = "filter_only"
	// FilterModeFreeOnly disables the filter-rule channel; only free torrents
	// that can be finished in time are downloaded (ignores associated rules).
	FilterModeFreeOnly FilterMode = "free_only"
)

func NormalizeFilterMode added in v0.25.0

func NormalizeFilterMode(m FilterMode) FilterMode

NormalizeFilterMode returns a validated FilterMode, falling back to DefaultFilterMode when the input is empty or unrecognized.

type FilterRule added in v0.2.0

type FilterRule struct {
	ID          uint        `gorm:"primaryKey" json:"id"`
	Name        string      `gorm:"size:128;not null" json:"name"`
	Pattern     string      `gorm:"size:512;not null" json:"pattern"`
	PatternType PatternType `gorm:"size:16;not null;default:'keyword'" json:"pattern_type"`
	MatchField  MatchField  `gorm:"size:16;not null;default:'both'" json:"match_field"`
	RequireFree bool        `gorm:"default:true" json:"require_free"`
	MinSizeGB   int         `gorm:"default:0" json:"min_size_gb"`
	MaxSizeGB   int         `gorm:"default:0" json:"max_size_gb"`
	Enabled     bool        `gorm:"default:true" json:"enabled"`
	SiteID      *uint       `gorm:"index" json:"site_id"`
	RSSID       *uint       `gorm:"index" json:"rss_id"`
	Priority    int         `gorm:"default:100" json:"priority"`
	// Purpose 区分规则用途:
	//   "download" — 仅用于下载(默认,向后兼容空值)
	//   "notify"   — 仅用于通知(filtered 模式)
	//   "both"     — 下载与通知都使用
	Purpose   string    `gorm:"column:purpose;not null;default:'download'" json:"purpose"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

FilterRule represents a user-defined filter rule for RSS items.

func (*FilterRule) MatchesSize added in v0.25.0

func (r *FilterRule) MatchesSize(sizeGB float64) bool

MatchesSize reports whether the torrent size (in GB) satisfies this rule's optional MinSizeGB / MaxSizeGB bounds. Zero on either side means "no bound". The rule's bounds can only narrow the global TorrentSizeGB; never widen it.

func (FilterRule) TableName added in v0.2.0

func (FilterRule) TableName() string

TableName returns the table name for FilterRule.

type FilterRuleDB added in v0.2.0

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

FilterRuleDB provides database operations for FilterRule.

func NewFilterRuleDB added in v0.2.0

func NewFilterRuleDB(db *TorrentDB) *FilterRuleDB

NewFilterRuleDB creates a new FilterRuleDB.

func (*FilterRuleDB) Create added in v0.2.0

func (f *FilterRuleDB) Create(rule *FilterRule) error

Create creates a new filter rule.

func (*FilterRuleDB) Delete added in v0.2.0

func (f *FilterRuleDB) Delete(id uint) error

Delete deletes a filter rule by ID.

func (*FilterRuleDB) Exists added in v0.2.0

func (f *FilterRuleDB) Exists(name string) (bool, error)

Exists checks if a filter rule with the given name exists.

func (*FilterRuleDB) ExistsExcluding added in v0.2.0

func (f *FilterRuleDB) ExistsExcluding(name string, excludeID uint) (bool, error)

ExistsExcluding checks if a filter rule with the given name exists, excluding a specific ID.

func (*FilterRuleDB) GetAll added in v0.2.0

func (f *FilterRuleDB) GetAll() ([]FilterRule, error)

GetAll retrieves all filter rules.

func (*FilterRuleDB) GetByID added in v0.2.0

func (f *FilterRuleDB) GetByID(id uint) (*FilterRule, error)

GetByID retrieves a filter rule by ID.

func (*FilterRuleDB) GetByRSSID added in v0.2.0

func (f *FilterRuleDB) GetByRSSID(rssID uint) ([]FilterRule, error)

GetByRSSID retrieves filter rules for a specific RSS subscription.

func (*FilterRuleDB) GetBySiteID added in v0.2.0

func (f *FilterRuleDB) GetBySiteID(siteID uint) ([]FilterRule, error)

GetBySiteID retrieves filter rules for a specific site.

func (*FilterRuleDB) GetEnabled added in v0.2.0

func (f *FilterRuleDB) GetEnabled() ([]FilterRule, error)

GetEnabled retrieves all enabled filter rules ordered by priority.

func (*FilterRuleDB) Update added in v0.2.0

func (f *FilterRuleDB) Update(rule *FilterRule) error

Update updates an existing filter rule.

type FreeDownChecker

type FreeDownChecker interface {
	IsFree() bool
	CanbeFinished(logger *zap.SugaredLogger, enabled bool, speedLimit, sizeLimitGB int) bool
	GetFreeEndTime() *time.Time
	GetFreeLevel() string
}

type FreeWatch

type FreeWatch struct {
	ID        uint   `gorm:"primaryKey" json:"id"`
	SiteName  string `gorm:"size:64;not null;index:idx_free_watch_torrent" json:"site_name"`
	TorrentID string `gorm:"size:128;not null;index:idx_free_watch_torrent" json:"torrent_id"`
	Title     string `gorm:"size:512;not null;default:''" json:"title"`
	Subtitle  string `gorm:"size:512;not null;default:''" json:"subtitle"`
	SizeBytes int64  `gorm:"not null;default:0" json:"size_bytes"`
	// HasHR、HRSeedTimeH 是建立时知道的 H&R 要求:推送时写进种子记录,自动清理的 H&R 保护要用
	HasHR       bool `gorm:"not null;default:false" json:"has_hr"`
	HRSeedTimeH int  `gorm:"not null;default:0" json:"hr_seed_time_h"`
	// 推送到哪里,同推送弹窗
	DownloaderID uint   `gorm:"not null;default:0" json:"downloader_id"`
	SavePath     string `gorm:"size:1024;not null;default:''" json:"save_path"`
	Category     string `gorm:"size:128;not null;default:''" json:"category"`
	Tags         string `gorm:"size:255;not null;default:''" json:"tags"`
	// MediaType、TMDBID、Season 是按条目搜索里建的带上的条目:推送时写进种子记录,整理入库按它整理;没有时为空与 0
	MediaType string `gorm:"size:8;not null;default:''" json:"media_type"`
	TMDBID    int    `gorm:"column:tmdb_id;not null;default:0" json:"tmdb_id"`
	Season    int    `gorm:"not null;default:0" json:"season"`
	Status    string `gorm:"size:16;not null;default:'';index" json:"status"`
	// NextCheckAt 是下一次读优惠的时间(只对在等的有意义)
	NextCheckAt *time.Time `gorm:"index" json:"next_check_at,omitempty"`
	LastCheckAt *time.Time `json:"last_check_at,omitempty"`
	// CheckCount 是读过几次;Failures 是连续读不到的次数(读到一次就清零)
	CheckCount int       `gorm:"not null;default:0" json:"check_count"`
	Failures   int       `gorm:"not null;default:0" json:"failures"`
	ExpiresAt  time.Time `gorm:"not null" json:"expires_at"`
	// InfoHash 是推送成功以后的种子哈希
	InfoHash string `gorm:"size:64;not null;default:''" json:"info_hash"`
	// Message 是最近一次检查的结果说明
	Message   string    `gorm:"size:1024;not null;default:''" json:"message"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

FreeWatch 是一个「等免费再下」:记下要推送的下载器与路径,免费了才推。同一个种子同一时间只有一条在等(watching)。 列的默认值一律是零值(GORM 新建时会把零值换成 default)。

func (FreeWatch) TableName

func (FreeWatch) TableName() string

type MCPSetting

type MCPSetting struct {
	ID      uint `gorm:"primaryKey" json:"-"`
	Enabled bool `gorm:"not null;default:false" json:"enabled"`
	// Path 是 MCP 的地址路径(/mcp 这样,以 / 开头、末尾不带 /)
	Path      string    `gorm:"size:128;not null;default:'/mcp'" json:"path"`
	UpdatedAt time.Time `json:"updated_at"`
}

MCPSetting 是 MCP 接入的设置(只有 ID 1 一行):开关与地址的路径。关着时外部的 AI 客户端连不上(内置 AI 助手在进程内 调工具,不受它影响)。升级上来第一次启动时,已经有带 MCP 权限的令牌就记成开着,免得已经接好的客户端断掉。

func (MCPSetting) TableName

func (MCPSetting) TableName() string

type MTTorrentDetail

type MTTorrentDetail struct {
	ID               string     `json:"id"`
	CreatedDate      string     `json:"createdDate"`
	LastModifiedDate string     `json:"lastModifiedDate"`
	Name             string     `json:"name"`
	SmallDescr       string     `json:"smallDescr"`
	IMDb             string     `json:"imdb"`
	IMDbRating       *string    `json:"imdbRating"`
	Douban           string     `json:"douban"`
	DoubanRating     *string    `json:"doubanRating"`
	DmmCode          string     `json:"dmmCode"`
	Author           any        `json:"author"`
	Category         string     `json:"category"`
	Source           string     `json:"source"`
	Medium           any        `json:"medium"`
	Standard         string     `json:"standard"`
	VideoCodec       string     `json:"videoCodec"`
	AudioCodec       string     `json:"audioCodec"`
	Team             string     `json:"team"`
	Processing       any        `json:"processing"`
	Countries        []string   `json:"countries"`
	NumFiles         string     `json:"numfiles"`
	Size             string     `json:"size"`
	Tags             string     `json:"tags"`
	Labels           string     `json:"labels"`
	MsUp             string     `json:"msUp"`
	Anonymous        bool       `json:"anonymous"`
	InfoHash         any        `json:"infoHash"`
	Status           *Status    `json:"status"`
	EditedBy         any        `json:"editedBy"`
	EditDate         any        `json:"editDate"`
	Collection       bool       `json:"collection"`
	InRss            bool       `json:"inRss"`
	CanVote          bool       `json:"canVote"`
	ImageList        any        `json:"imageList"`
	ResetBox         any        `json:"resetBox"`
	OriginFileName   string     `json:"originFileName"`
	Descr            string     `json:"descr"`
	Nfo              any        `json:"nfo"`
	MediaInfo        string     `json:"mediainfo"`
	CIDs             any        `json:"cids"`
	AIDs             any        `json:"aids"`
	ShowcaseList     []Showcase `json:"showcaseList"`
	TagList          []any      `json:"tagList"`
	Scope            string     `json:"scope"`
	ScopeTeams       []any      `json:"scopeTeams"`
	Thanked          bool       `json:"thanked"`
	Rewarded         bool       `json:"rewarded"`
}

func (MTTorrentDetail) CanbeFinished

func (t MTTorrentDetail) CanbeFinished(logger *zap.SugaredLogger, enabled bool, speedLimit, sizeLimitGB int) bool

func (MTTorrentDetail) GetFreeEndTime

func (t MTTorrentDetail) GetFreeEndTime() *time.Time

func (MTTorrentDetail) GetFreeLevel added in v0.0.6

func (t MTTorrentDetail) GetFreeLevel() string

func (MTTorrentDetail) GetName added in v0.2.0

func (t MTTorrentDetail) GetName() string

GetName 获取种子名称(返回中文名 Name)

func (MTTorrentDetail) GetSizeBytes added in v0.25.0

func (t MTTorrentDetail) GetSizeBytes() int64

GetSizeBytes 获取种子大小(字节);解析失败时返回 0。

func (MTTorrentDetail) GetSubTitle added in v0.2.0

func (t MTTorrentDetail) GetSubTitle() string

GetSubTitle 获取副标题(返回 SmallDescr)

func (MTTorrentDetail) IsFree

func (t MTTorrentDetail) IsFree() bool

type MatchField added in v0.2.0

type MatchField string

MatchField represents which fields to match against.

const (
	// MatchFieldTitle matches only against the title field.
	MatchFieldTitle MatchField = "title"
	// MatchFieldTag matches only against the tag field.
	MatchFieldTag MatchField = "tag"
	// MatchFieldBoth matches against both title and tag fields (default).
	MatchFieldBoth MatchField = "both"
)

type MediaCache

type MediaCache struct {
	Key       string    `gorm:"primaryKey;size:255" json:"key"`
	Value     string    `gorm:"type:text;not null;default:''" json:"value"`
	ExpiresAt time.Time `gorm:"index" json:"expires_at"`
}

MediaCache 是 TMDB 响应的缓存,到期后不再使用。

func (MediaCache) TableName

func (MediaCache) TableName() string

type MediaDoubanItem

type MediaDoubanItem struct {
	ID             uint      `gorm:"primaryKey" json:"id"`
	SourceID       uint      `gorm:"not null;uniqueIndex:idx_media_douban_item" json:"source_id"`
	DoubanID       string    `gorm:"column:douban_id;size:16;not null;uniqueIndex:idx_media_douban_item" json:"douban_id"`
	Title          string    `gorm:"size:255;not null;default:''" json:"title"`
	Year           int       `gorm:"not null;default:0" json:"year"`
	MediaType      string    `gorm:"size:8;not null;default:''" json:"media_type"`
	TMDBID         int       `gorm:"column:tmdb_id;not null;default:0" json:"tmdb_id"`
	SubscriptionID uint      `gorm:"not null;default:0" json:"subscription_id"`
	Status         string    `gorm:"size:16;not null;default:''" json:"status"`
	CreatedAt      time.Time `json:"created_at"`
	UpdatedAt      time.Time `json:"updated_at"`
}

MediaDoubanItem 是豆瓣想看里见过的条目:建过订阅的不再建(用户删掉订阅也不会再建回来), 没找到对应 TMDB 条目的也记下,不每次都去搜。

func (MediaDoubanItem) TableName

func (MediaDoubanItem) TableName() string

type MediaDoubanSource

type MediaDoubanSource struct {
	ID     uint   `gorm:"primaryKey" json:"id"`
	UserID string `gorm:"size:64;not null;default:'';uniqueIndex" json:"user_id"`
	// Name 是界面上显示的名字(可以不填)
	Name    string `gorm:"size:64;not null;default:''" json:"name"`
	Enabled bool   `gorm:"not null;default:false" json:"enabled"`
	// Confirm 为真时建出的订阅先是待确认
	Confirm     bool       `gorm:"not null;default:false" json:"confirm"`
	ProfileID   uint       `gorm:"not null;default:0" json:"profile_id"`
	LastFetchAt *time.Time `json:"last_fetch_at,omitempty"`
	NextFetchAt *time.Time `gorm:"index" json:"next_fetch_at,omitempty"`
	// Failures 是连续失败的次数;到 3 次标成异常,并发一次通知(Notified 记下发过了)
	Failures  int       `gorm:"not null;default:0" json:"failures"`
	LastError string    `gorm:"size:1024;not null;default:''" json:"last_error"`
	Abnormal  bool      `gorm:"not null;default:false" json:"abnormal"`
	Notified  bool      `gorm:"not null;default:false" json:"-"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

MediaDoubanSource 是一个豆瓣用户的想看:定时拉取公开的 RSS,给「想看」的电影与剧集建订阅。

func (MediaDoubanSource) TableName

func (MediaDoubanSource) TableName() string

type MediaEpisodeRule

type MediaEpisodeRule struct {
	ID             uint      `gorm:"primaryKey" json:"id"`
	SubscriptionID uint      `gorm:"not null;uniqueIndex:idx_media_episode_rule" json:"subscription_id"`
	Group          string    `gorm:"column:group_name;size:64;not null;default:'';uniqueIndex:idx_media_episode_rule" json:"group"`
	Mode           string    `gorm:"size:16;not null;default:''" json:"mode"`
	Offset         int       `gorm:"not null;default:0" json:"offset"`
	Source         string    `gorm:"size:16;not null;default:''" json:"source"`
	Note           string    `gorm:"size:255;not null;default:''" json:"note"`
	CreatedAt      time.Time `json:"created_at"`
	UpdatedAt      time.Time `json:"updated_at"`
}

MediaEpisodeRule 是一个追剧对一个制作组(空 = 所有组)的集号规则。

func (MediaEpisodeRule) TableName

func (MediaEpisodeRule) TableName() string

type MediaIssue

type MediaIssue struct {
	ID           uint       `gorm:"primaryKey" json:"id"`
	Kind         string     `gorm:"size:32;not null;uniqueIndex:idx_media_issue,priority:1" json:"kind"`
	Status       string     `gorm:"size:16;not null;default:'';index" json:"status"`
	ServerID     uint       `gorm:"not null;default:0;uniqueIndex:idx_media_issue,priority:2" json:"server_id"`
	ServerItemID string     `gorm:"size:64;not null;default:'';uniqueIndex:idx_media_issue,priority:3" json:"server_item_id"`
	HistoryID    uint       `gorm:"not null;default:0;uniqueIndex:idx_media_issue,priority:4" json:"history_id"`
	MediaType    string     `gorm:"size:8;not null;default:'';index:idx_media_issue_item,priority:1" json:"media_type"`
	TMDBID       int        `gorm:"column:tmdb_id;not null;default:0;index:idx_media_issue_item,priority:2" json:"tmdb_id"`
	Season       int        `gorm:"not null;default:0" json:"season"`
	Episode      int        `gorm:"not null;default:0" json:"episode"`
	Title        string     `gorm:"size:255;not null;default:''" json:"title"`
	Detail       string     `gorm:"size:1024;not null;default:''" json:"detail"`
	CreatedAt    time.Time  `json:"created_at"`
	UpdatedAt    time.Time  `json:"updated_at"`
	ResolvedAt   *time.Time `json:"resolved_at,omitempty"`
}

MediaIssue 是一个待处理问题。唯一键是(种类、服务器、服务器里的那一项、整理记录),不适用的列写 0 或空串: server_removed 按服务器里的那一项认(HistoryID 为 0),library_missing 按整理记录认(服务器两列为 0 与空串)。 同一个问题重复发现不会多一行:又出现了改成 resolved,之后又发生改回 open,用户忽略的(dismissed)在问题消失以前保持。

func (MediaIssue) TableName

func (MediaIssue) TableName() string

type MediaLibrary

type MediaLibrary struct {
	ID   uint   `gorm:"primaryKey" json:"id"`
	Name string `gorm:"size:64;not null;default:'';uniqueIndex" json:"name"`
	Kind string `gorm:"size:8;not null;default:''" json:"kind"`
	// Anime 为真时只收 TMDB 类型里有「动画」的条目;同类型里没有这种库时,动画也进普通的库
	Anime bool `gorm:"not null;default:false" json:"anime"`
	// Path 是 pt-tools 里看到的库目录(绝对路径)
	Path string `gorm:"size:1024;not null;default:''" json:"path"`
	// Template 是命名模板(text/template,不写扩展名);空串用默认模板
	Template        string `gorm:"size:1024;not null;default:''" json:"template"`
	Mode            string `gorm:"size:16;not null;default:''" json:"mode"`
	Scrape          bool   `gorm:"not null;default:false" json:"scrape"`
	ScrapeOverwrite bool   `gorm:"not null;default:false" json:"scrape_overwrite"`
	// ScrapeItems 是刮削要写的内容(逗号分隔,见 scrape.AllItems);空串是默认的那几项(Logo 以外都写)
	ScrapeItems string `gorm:"size:128;not null;default:''" json:"-"`
	// ScrapeImageLang 是海报与 Logo 优先用的语言:空串用 TMDB 给的那张;zh、en、ja;none 是没有文字的
	ScrapeImageLang string `gorm:"size:8;not null;default:''" json:"scrape_image_lang"`
	// ScrapeSource 是旧版本的「简介与评分」:空串用 TMDB 的;douban 用豆瓣的(找不到时用 TMDB 的)。ScrapeSources 为空时还按它
	ScrapeSource string `gorm:"size:16;not null;default:''" json:"scrape_source"`
	// ScrapeSources 是每一项的数据来源(JSON,见 metadata.Sources:简介、评分、每一集、图片);空串是都用 TMDB 的
	ScrapeSources string `gorm:"size:256;not null;default:''" json:"-"`
	// ClassifyDir 为真时按二级分类(MediaOrganizeSetting.ClassifyRules)放进库目录下的分类目录
	ClassifyDir bool `gorm:"not null;default:false" json:"classify_dir"`
	// OverwriteMode 是目标位置已经有 pt-tools 之前放进库的同一部(同一集)的旧版本时怎么办:空串不替换,larger 新文件更大时替换
	OverwriteMode string `gorm:"size:16;not null;default:''" json:"overwrite_mode"`
	// ScrapeActorZh 为真时刮削的演员名用 TMDB 上的中文译名(前 15 位,没有译名的用原名)
	ScrapeActorZh bool `gorm:"not null;default:false" json:"scrape_actor_zh"`
	// ScrapeFill 为真时每周对刮削结果是部分成功或失败的记录补刮一次,ScrapeFilledAt 是上一次补刮的时间
	ScrapeFill     bool       `gorm:"not null;default:false" json:"scrape_fill"`
	ScrapeFilledAt *time.Time `json:"scrape_filled_at,omitempty"`
	// SiteSubtitles 为真时整理出新视频以后到站点上取字幕:种子里没有字幕、种子是从支持的站点(NexusPHP)推送的时
	SiteSubtitles bool `gorm:"not null;default:false" json:"site_subtitles"`
	// CSFURL 是 ChineseSubFinder 的地址(空串是不用);CSFKeyEncrypted 是它的 API Key(加密保存、只写不读);
	// CSFPath 是 ChineseSubFinder 里看到的这个库的目录(空串是和 Path 一样)。整理出新视频以后交给它下载字幕
	CSFURL          string `gorm:"column:csf_url;size:512;not null;default:''" json:"csf_url"`
	CSFKeyEncrypted string `gorm:"column:csf_key_encrypted;type:text;not null;default:''" json:"-"`
	CSFPath         string `gorm:"column:csf_path;size:1024;not null;default:''" json:"csf_path"`
	// 下面四项是新建订阅时带出的下载设置:网页与 App 的编辑页在新建时把它们填进表单,服务器在保存与推送订阅时都不补,
	// 已有的订阅也不跟着变。DownloadDownloaderID 是推到哪个下载器(0 是不指定);DownloadSavePath 是下载器里看到的保存目录(不是库目录);
	// DownloadCategory、DownloadTags 是分类与标签(标签逗号分开)。都可以空着
	DownloadDownloaderID uint      `gorm:"not null;default:0" json:"download_downloader_id"`
	DownloadSavePath     string    `gorm:"size:1024;not null;default:''" json:"download_save_path"`
	DownloadCategory     string    `gorm:"size:128;not null;default:''" json:"download_category"`
	DownloadTags         string    `gorm:"size:255;not null;default:''" json:"download_tags"`
	Enabled              bool      `gorm:"not null;default:false" json:"enabled"`
	CreatedAt            time.Time `json:"created_at"`
	UpdatedAt            time.Time `json:"updated_at"`
}

MediaLibrary 是一个媒体库:一类条目(电影或剧集,可以只收动画)整理到哪个目录、怎么命名、怎么整理、要不要刮削。 列的默认值一律是零值(GORM 新建时会把零值换成 default)。

func ChooseLibrary

func ChooseLibrary(libs []MediaLibrary, kind string, anime bool) *MediaLibrary

ChooseLibrary 在 libs 里给 kind 类型的条目选媒体库:同类型、启用的库里取第一个;条目是动画(anime)时优先取只收动画的库, 同类型里没有这种库时进普通的库;只收动画的库不收别的条目。都没有时返回 nil。返回的是 libs 里的那一项。 整理(媒体库选「自动」时)与新建订阅(编辑页写「自动」会整理进哪个库)共用,两边选的是同一个库。

func (MediaLibrary) TableName

func (MediaLibrary) TableName() string

type MediaOrganizeSetting

type MediaOrganizeSetting struct {
	ID uint `gorm:"primaryKey" json:"id"`
	// AutoEnabled:pt-tools 推送的种子下载完成后自动整理。AutoSince 是打开的时间,只整理之后完成的种子
	AutoEnabled bool       `gorm:"not null;default:false" json:"auto_enabled"`
	AutoSince   *time.Time `json:"auto_since,omitempty"`
	// ScanEnabled:按范围定期扫描下载器里已完成的种子(不是 pt-tools 推送的也整理)
	ScanEnabled     bool `gorm:"not null;default:false" json:"scan_enabled"`
	ScanIntervalMin int  `gorm:"not null;default:0" json:"scan_interval_min"`
	// 范围:下载器 ID(JSON 数组)、分类与标签(逗号分隔)、保存路径前缀(换行分隔);空的一项不限制
	ScopeDownloaders string `gorm:"type:text;not null;default:''" json:"-"`
	ScopeCategories  string `gorm:"size:1024;not null;default:''" json:"-"`
	ScopeTags        string `gorm:"size:1024;not null;default:''" json:"-"`
	ScopeSavePaths   string `gorm:"type:text;not null;default:''" json:"-"`
	// MinVideoMB 是视频文件的最小体积(MB),更小的当作样片跳过;0 用默认值
	MinVideoMB int `gorm:"not null;default:0" json:"min_video_mb"`
	// NotifyChannels 是入库通知发往的通道 ID(JSON 数组);空的不通知
	NotifyChannels string `gorm:"type:text;not null;default:''" json:"-"`
	// DeleteLinksOnRemove:种子连数据一起删掉后,把从它整理出的硬链接与软链接也删掉(复制的文件不删)
	DeleteLinksOnRemove bool `gorm:"not null;default:false" json:"delete_links_on_remove"`
	// WatchIntervalMin 是目录监控扫描的间隔(分钟);0 用默认值
	WatchIntervalMin int `gorm:"not null;default:0" json:"watch_interval_min"`
	// WatchRealtimeOff 是关掉了实时目录监控(默认开着,存反过来的,零值就是开)
	WatchRealtimeOff bool `gorm:"not null;default:false" json:"-"`
	// ClassifyRules 是二级分类的规则(JSON,见 organize.ClassifyRules);空串是没有规则
	ClassifyRules string    `gorm:"type:text;not null;default:''" json:"-"`
	UpdatedAt     time.Time `json:"updated_at"`
}

MediaOrganizeSetting 是整理入库的设置(只有一行,ID 为 1)。

func (MediaOrganizeSetting) TableName

func (MediaOrganizeSetting) TableName() string

type MediaOverride

type MediaOverride struct {
	ID  uint   `gorm:"primaryKey" json:"id"`
	Key string `gorm:"size:255;not null;uniqueIndex" json:"key"`
	// AltKey 是用中文名算出的别名(有英文名时 Key 用英文名):副标题里有没有中文名都能命中
	AltKey    string    `gorm:"size:255;not null;default:'';index" json:"alt_key"`
	Label     string    `gorm:"size:255;not null;default:''" json:"label"`
	TMDBID    int       `gorm:"column:tmdb_id;not null;default:0" json:"tmdb_id"`
	MediaType string    `gorm:"size:8;not null;default:''" json:"media_type"`
	Title     string    `gorm:"size:255;not null;default:''" json:"title"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

MediaOverride 是手动纠正:解析结果相同(类型、名字,电影另加年份)的标题固定识别成这个 TMDB 条目。

func (MediaOverride) TableName

func (MediaOverride) TableName() string

type MediaPathMap

type MediaPathMap struct {
	ID               uint      `gorm:"primaryKey" json:"id"`
	DownloaderID     uint      `gorm:"not null;uniqueIndex:idx_media_path_map" json:"downloader_id"`
	DownloaderPrefix string    `gorm:"size:512;not null;uniqueIndex:idx_media_path_map" json:"downloader_prefix"`
	LocalPrefix      string    `gorm:"size:512;not null;default:''" json:"local_prefix"`
	CreatedAt        time.Time `json:"created_at"`
	UpdatedAt        time.Time `json:"updated_at"`
}

MediaPathMap 把下载器里看到的路径换成 pt-tools 里看到的路径(pt-tools 在容器里时两边的挂载点不同)。 换算时取最长的匹配前缀;没有匹配时路径不变。

func (MediaPathMap) TableName

func (MediaPathMap) TableName() string

type MediaQualityProfile

type MediaQualityProfile struct {
	ID          uint   `gorm:"primaryKey" json:"id"`
	Name        string `gorm:"size:64;not null;default:'';uniqueIndex" json:"name"`
	Resolutions string `gorm:"type:text;not null;default:''" json:"-"`
	Sources     string `gorm:"type:text;not null;default:''" json:"-"`
	Codecs      string `gorm:"type:text;not null;default:''" json:"-"`
	// Remux、HDR、ChineseSubs、Free 是空串 / prefer / require(HDR 还有 avoid)
	Remux       string `gorm:"size:16;not null;default:''" json:"remux"`
	HDR         string `gorm:"column:hdr;size:16;not null;default:''" json:"hdr"`
	ChineseSubs string `gorm:"size:16;not null;default:''" json:"chinese_subs"`
	Free        string `gorm:"size:16;not null;default:''" json:"free"`
	// Groups 是偏好的制作组(JSON 数组)
	Groups string `gorm:"type:text;not null;default:''" json:"-"`
	// MinSizeGB、MaxSizeGB 是体积区间(0 不限):电影按整部算,剧集按每集算
	MinSizeGB  float64   `gorm:"not null;default:0" json:"min_size_gb"`
	MaxSizeGB  float64   `gorm:"not null;default:0" json:"max_size_gb"`
	MinSeeders int       `gorm:"not null;default:0" json:"min_seeders"`
	ExcludeHR  bool      `gorm:"column:exclude_hr;not null;default:false" json:"exclude_hr"`
	CreatedAt  time.Time `json:"created_at"`
	UpdatedAt  time.Time `json:"updated_at"`
}

MediaQualityProfile 是质量档案:订阅按它挑资源、打分。列表字段是 JSON 数组,按偏好从高到低排,空数组不限; 取值用 internal/media/meta 解析出的写法(2160p、BluRay、WEB-DL、H.265 等)。

func (MediaQualityProfile) TableName

func (MediaQualityProfile) TableName() string

type MediaReplaceJournal

type MediaReplaceJournal struct {
	ID uint `gorm:"primaryKey"`
	// OldID 是被换掉的整理记录
	OldID uint `gorm:"not null;default:0"`
	// Source 与 Mode 是新文件的源文件与整理方式
	Source string `gorm:"size:2048;not null;default:''"`
	Mode   string `gorm:"size:16;not null;default:''"`
	Target string `gorm:"size:2048;not null;default:''"`
	Temp   string `gorm:"size:2048;not null;default:''"`
	// TempID 是放好的临时文件的文件编号(新文件放到 Target 以后还是它)
	TempID string `gorm:"size:64;not null;default:''"`
	Backup string `gorm:"size:2048;not null;default:''"`
	// BackupID 是挪到 Backup 的旧文件的文件编号(确认过是旧记录放的那个以后记下),收尾时只删编号还对得上的
	BackupID string `gorm:"size:64;not null;default:''"`
	// Subs 是新文件的字幕(JSON 数组,每项 source、target):旧字幕删掉以后才放,收尾时放好并记进新记录
	Subs      string    `gorm:"type:text;not null;default:''"`
	Committed bool      `gorm:"not null;default:false"`
	CreatedAt time.Time `json:"created_at"`
}

MediaReplaceJournal 是一次进行中的「同名文件替换」(覆盖策略):新文件先放在 Temp,旧文件挪到 Backup, 新文件放到 Target 以后与两条整理记录在同一个事务里写好并标成 Committed,收尾删掉 Backup 后删掉这一行。 中途 pt-tools 退出了,下次启动时按它恢复:没写好记录的撤回(旧文件放回原处),写好了的收尾。

func (MediaReplaceJournal) TableName

func (MediaReplaceJournal) TableName() string

type MediaServer

type MediaServer struct {
	ID             uint       `gorm:"primaryKey" json:"id"`
	Name           string     `gorm:"size:64;not null;default:'';uniqueIndex" json:"name"`
	Kind           string     `gorm:"size:16;not null;default:''" json:"kind"`
	URL            string     `gorm:"size:512;not null;default:''" json:"url"`
	TokenEncrypted string     `gorm:"type:text;not null;default:''" json:"-"`
	Enabled        bool       `gorm:"not null;default:false" json:"enabled"`
	RefreshMode    string     `gorm:"size:16;not null;default:''" json:"refresh_mode"`
	LocalPrefix    string     `gorm:"size:512;not null;default:''" json:"local_prefix"`
	ServerPrefix   string     `gorm:"size:512;not null;default:''" json:"server_prefix"`
	LastError      string     `gorm:"size:1024;not null;default:''" json:"last_error"`
	LastRefreshAt  *time.Time `json:"last_refresh_at,omitempty"`
	// PlayURL 是打开链接用的地址(浏览器能打开的那个);空串用 URL
	PlayURL string `gorm:"size:512;not null;default:''" json:"play_url"`
	// ServerUID 是服务器自己的编号(Emby、Jellyfin 的 Id,Plex 的 machineIdentifier):拼打开链接,认出换了一台服务器
	ServerUID string `gorm:"column:server_uid;size:64;not null;default:''" json:"-"`
	// IndexOff 为真时不同步索引(默认同步,存反过来的,零值就是开);IndexHours 是同步间隔(小时),0 用默认值
	IndexOff   bool `gorm:"not null;default:false" json:"-"`
	IndexHours int  `gorm:"not null;default:0" json:"-"`
	// IndexedAt 是上一次同步成功的时间,IndexError 是最近一次同步失败的原因(成功时清空),后面三个是同步到的条目数
	IndexedAt     *time.Time `json:"indexed_at,omitempty"`
	IndexError    string     `gorm:"size:1024;not null;default:''" json:"index_error"`
	IndexMovies   int        `gorm:"not null;default:0" json:"index_movies"`
	IndexSeries   int        `gorm:"not null;default:0" json:"index_series"`
	IndexEpisodes int        `gorm:"not null;default:0" json:"index_episodes"`
	// CountLibrary 为真时追剧把这台服务器里有的集算作已入库(整理记录里没有的也算)
	CountLibrary bool `gorm:"not null;default:false" json:"count_library"`
	// ResumeUserID、ResumeUserName 是继续观看用的用户(Emby、Jellyfin);空串不取继续观看
	ResumeUserID   string `gorm:"size:64;not null;default:''" json:"resume_user_id"`
	ResumeUserName string `gorm:"size:128;not null;default:''" json:"resume_user_name"`
	// WebhookTokenHash 是 Webhook 令牌的 SHA-256(十六进制,令牌本身不存);空串没开 Webhook。
	// WebhookAt、WebhookEvent 是最近一次收到的时间与事件
	WebhookTokenHash string     `gorm:"size:64;not null;default:''" json:"-"`
	WebhookAt        *time.Time `json:"webhook_at,omitempty"`
	WebhookEvent     string     `gorm:"size:64;not null;default:''" json:"webhook_event"`
	// PlaybackChannels 是播放通知发往的通道 ID(JSON 数组);空的不发
	PlaybackChannels string    `gorm:"type:text;not null;default:''" json:"-"`
	CreatedAt        time.Time `json:"created_at"`
	UpdatedAt        time.Time `json:"updated_at"`
}

MediaServer 是整理完后要通知的媒体服务器。Token(Emby、Jellyfin 的 API Key 或 Plex 的 Token)加密保存、只写不读。 LocalPrefix → ServerPrefix 把 pt-tools 里的路径换成媒体服务器里看到的路径,两边一样时都留空。 索引(见 internal/media/serverindex)按 IndexHours 定期把服务器里的电影、剧与集记进 media_server_items。

func (MediaServer) TableName

func (MediaServer) TableName() string

type MediaServerItem

type MediaServerItem struct {
	ID           uint   `gorm:"primaryKey" json:"-"`
	ServerID     uint   `gorm:"not null;uniqueIndex:idx_media_server_item,priority:1;index:idx_media_server_item_series,priority:1" json:"server_id"`
	ItemID       string `gorm:"size:64;not null;uniqueIndex:idx_media_server_item,priority:2" json:"item_id"`
	Kind         string `gorm:"size:8;not null;default:'';index:idx_media_server_item_tmdb,priority:1" json:"kind"`
	SeriesItemID string `gorm:"size:64;not null;default:'';index:idx_media_server_item_series,priority:2" json:"series_item_id"`
	TMDBID       int    `gorm:"column:tmdb_id;not null;default:0;index:idx_media_server_item_tmdb,priority:2" json:"tmdb_id"`
	IMDbID       string `gorm:"column:imdb_id;size:16;not null;default:''" json:"imdb_id"`
	TVDBID       string `gorm:"column:tvdb_id;size:16;not null;default:''" json:"tvdb_id"`
	Season       int    `gorm:"not null;default:0" json:"season"`
	Episode      int    `gorm:"not null;default:0" json:"episode"`
	// EpisodeEnd 是一个文件里的最后一集(两集合一时);只有一集时为 0
	EpisodeEnd int        `gorm:"not null;default:0" json:"episode_end"`
	Title      string     `gorm:"size:255;not null;default:''" json:"title"`
	Year       int        `gorm:"not null;default:0" json:"year"`
	Path       string     `gorm:"size:1024;not null;default:''" json:"path"`
	LocalPath  string     `gorm:"size:1024;not null;default:''" json:"local_path"`
	AddedAt    *time.Time `json:"added_at,omitempty"`
	// SyncedAt 是这一行最后一次按服务器的数据写入的时间(新增、变了、又出现)
	SyncedAt  time.Time  `json:"synced_at"`
	RemovedAt *time.Time `gorm:"index" json:"removed_at,omitempty"`
}

MediaServerItem 是媒体服务器索引里的一项:一部电影、一部剧,或剧的一集。由同步全量写入(见 internal/media/serverindex)。 集的 TMDBID、IMDbID、TVDBID 是所在剧的编号(集自己的编号用不上);LocalPath 是按服务器的路径前缀换成的 pt-tools 里的路径, 换不了时为空。RemovedAt 为空表示服务器里还有;不为空是同步时发现服务器里没有了(删除标记,90 天后才删行)。

func (MediaServerItem) TableName

func (MediaServerItem) TableName() string

type MediaSetting

type MediaSetting struct {
	ID               uint   `gorm:"primaryKey" json:"id"`
	TMDBKeyEncrypted string `gorm:"type:text;default:''" json:"-"`
	Language         string `gorm:"size:16;default:''" json:"language"`
	ProxyEncrypted   string `gorm:"type:text;default:''" json:"-"`
	// FanartKeyEncrypted、OMDbKeyEncrypted 是刮削用的 Fanart.tv(项目的 Key)与 OMDb 的 API Key(加密保存,只写不读);
	// 空的不用这个来源。FanartClientKeyEncrypted 是 Fanart.tv 的个人 Key(可选,和项目的 Key 一起发)
	FanartKeyEncrypted       string `gorm:"type:text;default:''" json:"-"`
	FanartClientKeyEncrypted string `gorm:"type:text;default:''" json:"-"`
	OMDbKeyEncrypted         string `gorm:"column:omdb_key_encrypted;type:text;default:''" json:"-"`
	// APIBaseURL、ImageBaseURL 是换掉的 TMDB 接口地址与图片地址(镜像或自建中转),空 = 官方地址
	APIBaseURL   string    `gorm:"size:512;default:''" json:"api_base_url"`
	ImageBaseURL string    `gorm:"size:512;default:''" json:"image_base_url"`
	UpdatedAt    time.Time `json:"updated_at"`
}

MediaSetting 是媒体识别的设置(只有一行,ID 为 1)。TMDB 的 API Key 加密保存、只写不读; 代理地址可能带用户名密码,也加密保存,为空时用环境变量里的代理(与站点请求相同)。

func (MediaSetting) TableName

func (MediaSetting) TableName() string

type MediaSubscribeSetting

type MediaSubscribeSetting struct {
	ID uint `gorm:"primaryKey" json:"-"`
	// Enabled 是总开关:关掉时不搜索、不接 RSS、不拉豆瓣
	Enabled bool `gorm:"not null;default:false" json:"enabled"`
	// SearchIntervalHours 是每个订阅主动搜索的间隔(最少 6 小时),每次另加最多 30 分钟的随机偏移
	SearchIntervalHours int `gorm:"not null;default:0" json:"search_interval_hours"`
	// SearchSkipSites 是不参与主动搜索的站点(JSON 数组;RSS 里的种子照样对)
	SearchSkipSites     string `gorm:"type:text;not null;default:''" json:"-"`
	DefaultProfileID    uint   `gorm:"not null;default:0" json:"default_profile_id"`
	DefaultDownloaderID uint   `gorm:"not null;default:0" json:"default_downloader_id"`
	// NotifyChannels 是下载了订阅的资源时发通知的通道(JSON 数组)
	NotifyChannels string `gorm:"type:text;not null;default:''" json:"-"`
	// UpgradeOld 是洗版以后旧种子怎么办:keep(空串也是)继续做种,delete 连数据删掉
	UpgradeOld string `gorm:"size:16;not null;default:''" json:"upgrade_old"`
	// TodayEnabled 为真时每天 TodayTime(HH:MM,空的按 09:00)把今天播出的集推送到 TodayChannels(JSON 数组;空的用 NotifyChannels)
	TodayEnabled  bool   `gorm:"not null;default:false" json:"today_enabled"`
	TodayTime     string `gorm:"size:5;not null;default:''" json:"today_time"`
	TodayChannels string `gorm:"type:text;not null;default:''" json:"-"`
	// SubdirEnabled 为真时订阅推送的种子放进按 SubdirTemplate(空的按 {title} ({year}))起名的一级子目录(见 subscribe.subdirName)
	SubdirEnabled  bool   `gorm:"not null;default:false" json:"subdir_enabled"`
	SubdirTemplate string `gorm:"size:255;not null;default:''" json:"subdir_template"`
	// AIReviewEnabled 为真时推送订阅的候选以前让 AI 助手的模型复核;AIReviewScope 是 name(空串也是,只复核按名字对上的)或 all
	AIReviewEnabled bool      `gorm:"column:ai_review_enabled;not null;default:false" json:"ai_review_enabled"`
	AIReviewScope   string    `gorm:"column:ai_review_scope;size:8;not null;default:''" json:"ai_review_scope"`
	UpdatedAt       time.Time `json:"updated_at"`
}

MediaSubscribeSetting 是订阅的设置,只有一行(ID 为 1)。

func (MediaSubscribeSetting) TableName

func (MediaSubscribeSetting) TableName() string

type MediaSubscription

type MediaSubscription struct {
	ID            uint   `gorm:"primaryKey" json:"id"`
	MediaType     string `gorm:"size:8;not null;default:'';uniqueIndex:idx_media_sub" json:"media_type"`
	TMDBID        int    `gorm:"column:tmdb_id;not null;default:0;uniqueIndex:idx_media_sub" json:"tmdb_id"`
	Season        int    `gorm:"not null;default:0;uniqueIndex:idx_media_sub" json:"season"`
	Title         string `gorm:"size:255;not null;default:''" json:"title"`
	OriginalTitle string `gorm:"size:255;not null;default:''" json:"original_title"`
	Year          int    `gorm:"not null;default:0" json:"year"`
	// Aliases 是对种子标题时用的其他名字(JSON 数组:英文名与 TMDB 别名)
	Aliases    string `gorm:"type:text;not null;default:''" json:"-"`
	IMDbID     string `gorm:"column:imdb_id;size:16;not null;default:''" json:"imdb_id"`
	PosterPath string `gorm:"size:255;not null;default:''" json:"poster_path"`
	// ProfileID 为 0 时用设置里的默认档案
	ProfileID uint `gorm:"not null;default:0" json:"profile_id"`
	// Sites 是只在这些站点找(JSON 数组,空 = 所有启用的站点)
	Sites string `gorm:"type:text;not null;default:''" json:"-"`
	// DownloaderID 为 0 时用设置里的默认下载器,再没有时用 pt-tools 的默认下载器
	DownloaderID uint   `gorm:"not null;default:0" json:"downloader_id"`
	Category     string `gorm:"size:128;not null;default:''" json:"category"`
	Tags         string `gorm:"size:255;not null;default:''" json:"tags"`
	SavePath     string `gorm:"size:1024;not null;default:''" json:"save_path"`
	Status       string `gorm:"size:16;not null;default:'';index" json:"status"`
	// IncludeKeywords、ExcludeKeywords 是对种子标题(连同副标题)的包含词与排除词:按行或逗号分开,不分大小写,
	// 空格、点、下划线当作一样;有包含词时至少含一个才要,含任何一个排除词的不要。空串不限
	IncludeKeywords string `gorm:"size:1024;not null;default:''" json:"include_keywords"`
	ExcludeKeywords string `gorm:"size:1024;not null;default:''" json:"exclude_keywords"`
	// Upgrade 是洗版:下载过以后还接着找分数更高的,档案里排第一的分辨率与来源都达到才停
	Upgrade  bool   `gorm:"not null;default:false" json:"upgrade"`
	Source   string `gorm:"size:16;not null;default:''" json:"source"`
	DoubanID string `gorm:"column:douban_id;size:16;not null;default:''" json:"douban_id"`
	// TotalEpisodes 是这一季的集数(来自 TMDB),电影为 0
	TotalEpisodes int        `gorm:"not null;default:0" json:"total_episodes"`
	LastSearchAt  *time.Time `json:"last_search_at,omitempty"`
	NextSearchAt  *time.Time `gorm:"index" json:"next_search_at,omitempty"`
	// Message 是最近一次搜索或下载的结果说明
	Message string `gorm:"size:1024;not null;default:''" json:"message"`

	// ScheduleKind 是主动搜索的定时方式(MediaSchedule*);空串沿用设置里的全局间隔
	ScheduleKind string `gorm:"size:16;not null;default:''" json:"-"`
	// ScheduleAt 是时刻(HH:MM);按播出时间时是当地的播出时刻(TMDB 只有日期),空串按 20:00
	ScheduleAt string `gorm:"size:5;not null;default:''" json:"-"`
	// ScheduleEvery 是每隔几天(1–30)
	ScheduleEvery int `gorm:"not null;default:0" json:"-"`
	// ScheduleDays 是每周的星期几(0–6,0 是星期日)或每月的几号(1–31,短月按月末),JSON 数组
	ScheduleDays string `gorm:"type:text;not null;default:''" json:"-"`
	// ScheduleIntervalMinutes 是按间隔时每隔几分钟搜一次(30 分钟到 7 天)
	ScheduleIntervalMinutes int `gorm:"not null;default:0" json:"-"`
	// ScheduleCron 是按 cron 表达式时的表达式(一条或几条,用「; 」分开)
	ScheduleCron string `gorm:"size:512;not null;default:''" json:"-"`
	// AirDelayHours、AirRetryHours、AirWindowDays 用在按播出时间:播出后多久开始搜(0 = 2 小时)、
	// 没找到时隔多久再搜(0 = 6 小时)、播出后几天里集中重试(0 = 7 天)
	AirDelayHours int `gorm:"not null;default:0" json:"-"`
	AirRetryHours int `gorm:"not null;default:0" json:"-"`
	AirWindowDays int `gorm:"not null;default:0" json:"-"`
	// StartEpisode 是从第几集开始追(0 与 1 都是整季)
	StartEpisode int `gorm:"not null;default:0" json:"start_episode"`
	// TotalEpisodesManual 为真时 TotalEpisodes 以用户填的为准,不再按 TMDB 改
	TotalEpisodesManual bool `gorm:"not null;default:false" json:"total_episodes_manual"`
	// LockVersion 是版本锁:开着时只要和已有版本同一个制作组、同一个分辨率的;LockGroup、LockResolution 是锁住的版本
	LockVersion    bool   `gorm:"not null;default:false" json:"lock_version"`
	LockGroup      string `gorm:"size:64;not null;default:''" json:"lock_group"`
	LockResolution string `gorm:"size:16;not null;default:''" json:"lock_resolution"`
	// LockFromNext 为真时锁住的版本是用户清掉的:不再按库里已有的文件定,下一个推送成功的版本成为新锁(写锁时清掉)
	LockFromNext bool `gorm:"not null;default:false" json:"-"`
	// SeenVersions 是最近一次搜索找到的、能补上缺的集的版本(JSON,见 subscribe.SeenVersions):「修改」里改锁时给用户选
	SeenVersions string `gorm:"type:text;not null;default:''" json:"-"`
	// FollowNextSeason 为真时这一季完成以后自动给下一季建追剧;NextSeasonID 是已经建好的那个
	FollowNextSeason bool `gorm:"not null;default:false" json:"follow_next_season"`
	NextSeasonID     uint `gorm:"not null;default:0" json:"next_season_id"`
	// LibraryID 是整理进哪个媒体库(0 按类型自动选)
	LibraryID uint `gorm:"not null;default:0" json:"library_id"`
	// EpisodeGroupID 是种子按 TMDB 的哪个剧集组写季集(剧集;空串是按 TMDB 默认的季集):对种子与整理入库时先把
	// (第几组,组里第几集)换成默认的季集,见 internal/media/epgroup
	EpisodeGroupID string `gorm:"size:32;not null;default:''" json:"episode_group_id"`
	// CompletedAt 是变成完成的时间
	CompletedAt *time.Time `json:"completed_at,omitempty"`
	// LastRunID 是最近一次运行记录
	LastRunID uint `gorm:"not null;default:0" json:"last_run_id"`

	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

MediaSubscription 是一个订阅:一部电影,或剧集的一季。同一个条目的同一季只有一个订阅。

func (MediaSubscription) TableName

func (MediaSubscription) TableName() string

type MediaSubscriptionEpisode

type MediaSubscriptionEpisode struct {
	ID             uint   `gorm:"primaryKey" json:"-"`
	SubscriptionID uint   `gorm:"not null;uniqueIndex:idx_media_sub_episode" json:"subscription_id"`
	Episode        int    `gorm:"not null;uniqueIndex:idx_media_sub_episode" json:"episode"`
	AirDate        string `gorm:"size:10;not null;default:''" json:"air_date"`
	Name           string `gorm:"size:255;not null;default:''" json:"name"`
	State          string `gorm:"size:16;not null;default:''" json:"state"`
	Source         string `gorm:"size:16;not null;default:''" json:"source"`
	// Ref 是状态的出处:整理记录编号、订阅种子记录编号
	Ref               string `gorm:"size:64;not null;default:''" json:"ref"`
	VersionGroup      string `gorm:"size:64;not null;default:''" json:"version_group"`
	VersionResolution string `gorm:"size:16;not null;default:''" json:"version_resolution"`
	ManualSkip        bool   `gorm:"not null;default:false" json:"manual_skip"`
	ManualUnlock      bool   `gorm:"not null;default:false" json:"manual_unlock"`
	// VersionSeen 是在站点上找到过的这一集锁住的版本(写法同版本锁的说明,例如 MWeb 2160p):找到过的不算等版本——
	// 没下载成是下载的问题,按缺的接着找。版本锁改了以后对不上,重新算
	VersionSeen string `gorm:"size:128;not null;default:''" json:"-"`
	// WaitingSince 是开始等锁住的版本的时间;WaitingNotifiedAt 是最近一次提醒的时间
	WaitingSince      *time.Time `json:"waiting_since,omitempty"`
	WaitingNotifiedAt *time.Time `json:"-"`
	UpdatedAt         time.Time  `json:"updated_at"`
}

MediaSubscriptionEpisode 是追剧台账里的一集:由入库记录、订阅的种子与下载器里的种子合成,只由重建台账写; ManualSkip(不要这一集)与 ManualUnlock(这一集不受版本锁限制)只由用户的操作写,重建时保留。

func (MediaSubscriptionEpisode) TableName

func (MediaSubscriptionEpisode) TableName() string

type MediaSubscriptionRun

type MediaSubscriptionRun struct {
	ID             uint       `gorm:"primaryKey" json:"id"`
	SubscriptionID uint       `gorm:"not null;index" json:"subscription_id"`
	Trigger        string     `gorm:"size:16;not null;default:''" json:"trigger"`
	StartedAt      time.Time  `gorm:"index" json:"started_at"`
	FinishedAt     *time.Time `json:"finished_at,omitempty"`
	Status         string     `gorm:"size:16;not null;default:''" json:"status"`
	Summary        string     `gorm:"size:1024;not null;default:''" json:"summary"`
	// Steps 是这次运行的步骤(JSON 数组,最多 16 KiB;超出时截断,StepsTruncated 为真)
	Steps          string `gorm:"type:text;not null;default:''" json:"-"`
	StepsTruncated bool   `gorm:"not null;default:false" json:"steps_truncated"`
}

MediaSubscriptionRun 是追剧(与订阅)的一次运行:一次主动搜索、RSS 命中、建立或手动搜索。 每个订阅保留最近 100 条,且不超过 90 天。

func (MediaSubscriptionRun) TableName

func (MediaSubscriptionRun) TableName() string

type MediaSubscriptionTorrent

type MediaSubscriptionTorrent struct {
	ID             uint   `gorm:"primaryKey" json:"id"`
	SubscriptionID uint   `gorm:"not null;uniqueIndex:idx_media_sub_torrent" json:"subscription_id"`
	SiteName       string `gorm:"size:64;not null;uniqueIndex:idx_media_sub_torrent" json:"site_name"`
	TorrentID      string `gorm:"size:128;not null;uniqueIndex:idx_media_sub_torrent" json:"torrent_id"`
	InfoHash       string `gorm:"size:64;not null;default:'';index" json:"info_hash"`
	Title          string `gorm:"size:512;not null;default:''" json:"title"`
	// Subtitle 是站点上的副标题:洗版时按现在的档案重算分数要用(中字写在副标题里)
	Subtitle string `gorm:"size:512;not null;default:''" json:"subtitle"`
	// Score 是推送时按当时的档案打的分(档案改过以后比较版本时重算,不用这个)
	Score int `gorm:"not null;default:0" json:"score"`
	// Episode、EpisodeEnd 是种子里的集(剧集,单集时 EpisodeEnd 为 0);整季包 Complete 为真
	Episode    int  `gorm:"not null;default:0" json:"episode"`
	EpisodeEnd int  `gorm:"not null;default:0" json:"episode_end"`
	Complete   bool `gorm:"not null;default:false" json:"complete"`
	// CoveredEpisodes 是整季包推送以后按种子的文件列表核对出的集(JSON 数组);为空时按 Episode、EpisodeEnd、Complete 算
	CoveredEpisodes string `gorm:"type:text;not null;default:''" json:"-"`
	SizeBytes       int64  `gorm:"not null;default:0" json:"size_bytes"`
	DownloaderID    uint   `gorm:"not null;default:0" json:"downloader_id"`
	// HasHR 是推送时知道的 H&R 要求(站点整站有,或者这个种子有):洗版删旧种子时留着做种
	HasHR bool `gorm:"not null;default:false" json:"has_hr"`
	// Adopted 是推送时下载器里已经有这个种子(不是订阅加进去的):洗版时不删
	Adopted   bool      `gorm:"not null;default:false" json:"adopted"`
	Status    string    `gorm:"size:16;not null;default:'';index" json:"status"`
	Message   string    `gorm:"size:1024;not null;default:''" json:"message"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

MediaSubscriptionTorrent 是订阅下载的一个种子:同一个订阅里同一个站点的同一个种子只记一次。 追剧认领的下载器里别处加的种子没有站点与种子编号:SiteName 是 MediaAdoptedSitePrefix 加下载器编号,TorrentID 是 info hash。

func (MediaSubscriptionTorrent) TableName

func (MediaSubscriptionTorrent) TableName() string

type MediaTorrentBlock

type MediaTorrentBlock struct {
	ID        uint   `gorm:"primaryKey" json:"id"`
	SiteName  string `gorm:"size:64;not null;uniqueIndex:idx_media_torrent_block" json:"site_name"`
	TorrentID string `gorm:"size:128;not null;uniqueIndex:idx_media_torrent_block" json:"torrent_id"`
	MediaType string `gorm:"size:8;not null;default:'';uniqueIndex:idx_media_torrent_block" json:"media_type"`
	TMDBID    int    `gorm:"column:tmdb_id;not null;default:0;uniqueIndex:idx_media_torrent_block;index" json:"tmdb_id"`
	// Season 是剧集的季;电影与对所有条目生效的是 0
	Season int `gorm:"not null;default:0;uniqueIndex:idx_media_torrent_block" json:"season"`
	// MediaTitle 是拉黑时条目的名字(列表里写作用于哪个条目)
	MediaTitle string `gorm:"size:255;not null;default:''" json:"media_title"`
	// Title 是拉黑时种子的标题(站点上删了以后列表里还看得出是哪个)
	Title string `gorm:"size:512;not null;default:''" json:"title"`
	// Reason 是用户写的原因,可以为空
	Reason    string    `gorm:"size:255;not null;default:''" json:"reason"`
	CreatedAt time.Time `json:"created_at"`
}

MediaTorrentBlock 是拉黑的一个种子(站点上的种子编号):订阅不再选它,按条目搜索把它标成已拉黑。 按条目存,不按订阅编号:删了订阅再建,拉黑仍然有效。TMDBID 为 0(MediaType 为空、Season 为 0)的对所有条目生效 (关键字搜索里拉黑的)。同一个种子对同一个条目只有一行。

func (MediaTorrentBlock) TableName

func (MediaTorrentBlock) TableName() string

type MediaTransferHistory

type MediaTransferHistory struct {
	ID             uint   `gorm:"primaryKey" json:"id"`
	DownloaderID   uint   `gorm:"not null;default:0;index" json:"downloader_id"`
	DownloaderName string `gorm:"size:64;not null;default:''" json:"downloader_name"`
	// WatchDirID 是目录监控的目录(MediaWatchDir):不为 0 时这条不是下载器里的种子,DownloaderID 为 0,TorrentName 是目录下那一项的名字
	WatchDirID  uint   `gorm:"not null;default:0;index" json:"watch_dir_id"`
	InfoHash    string `gorm:"size:64;not null;default:'';index" json:"info_hash"`
	TaskID      string `gorm:"size:128;not null;default:''" json:"task_id"`
	TorrentName string `gorm:"size:512;not null;default:''" json:"torrent_name"`
	LibraryID   uint   `gorm:"not null;default:0;index" json:"library_id"`
	SourcePath  string `gorm:"size:2048;not null;uniqueIndex" json:"source_path"`
	// SaveRoot 是整理时种子保存目录在 pt-tools 里的路径:清理入库链接前确认它还在(下载目录没挂载时不清理)
	SaveRoot   string `gorm:"size:2048;not null;default:''" json:"-"`
	TargetPath string `gorm:"size:2048;not null;default:''" json:"target_path"`
	// Extras 是一起整理的字幕与刮削写的文件(JSON 数组,带文件编号):删除库里的文件时只删这些
	Extras string `gorm:"type:text;not null;default:''" json:"-"`
	Mode   string `gorm:"size:16;not null;default:''" json:"mode"`
	// ChosenMode 是手动整理时选的整理方式(空串是跟媒体库):重试按它整理,Mode 是实际用的方式
	ChosenMode string `gorm:"size:16;not null;default:''" json:"chosen_mode"`
	MediaType  string `gorm:"size:8;not null;default:''" json:"media_type"`
	TMDBID     int    `gorm:"column:tmdb_id;not null;default:0" json:"tmdb_id"`
	Title      string `gorm:"size:255;not null;default:''" json:"title"`
	Year       int    `gorm:"not null;default:0" json:"year"`
	Season     int    `gorm:"not null;default:0" json:"season"`
	Episode    int    `gorm:"not null;default:0" json:"episode"`
	EpisodeEnd int    `gorm:"not null;default:0" json:"episode_end"`
	Size       int64  `gorm:"not null;default:0" json:"size"`
	Status     string `gorm:"size:16;not null;default:'';index" json:"status"`
	Message    string `gorm:"size:1024;not null;default:''" json:"message"`
	// FailKind 是失败与跳过的分类(MediaFailRecognize 等);整理成的为空,升级前的失败、跳过记录也为空(当作其他)
	FailKind string `gorm:"size:16;not null;default:''" json:"fail_kind"`
	Attempts int    `gorm:"not null;default:0" json:"attempts"`
	// NextRetryAt 是失败后下次自动重试的时间;为空的不自动重试(例如没识别出来,要先纠正)
	NextRetryAt *time.Time `gorm:"index" json:"next_retry_at,omitempty"`
	// TargetFileID 是整理出的文件的设备号与 inode(Windows 是卷序列号与文件索引),删除库里的文件前用它确认还是这个文件
	TargetFileID string `gorm:"size:64;not null;default:''" json:"-"`
	// SourceFileID 是整理时源文件的编号(同 TargetFileID 的格式):目录监控按它认同一个位置上是不是换成了另一个文件。
	// 下载器的种子不记(种子按 info hash 认)
	SourceFileID string `gorm:"size:64;not null;default:''" json:"-"`
	// RootPath 是整理时算剧集目录、电影有没有自己的目录的起点:库目录,按二级分类放进子目录时是分类目录(重新刮削用)。
	// 升级前的记录为空
	RootPath string `gorm:"size:2048;not null;default:''" json:"-"`
	// ScrapeStatus 是上一次刮削的结果(MediaScrapeOK 等),ScrapeNote 是出的问题与说明,ScrapedAt 是刮削的时间
	ScrapeStatus string     `gorm:"size:16;not null;default:''" json:"scrape_status"`
	ScrapeNote   string     `gorm:"size:1024;not null;default:''" json:"scrape_note"`
	ScrapedAt    *time.Time `json:"scraped_at,omitempty"`
	Trigger      string     `gorm:"size:16;not null;default:''" json:"trigger"`
	// MatchSource 是条目从哪来:manual(手动指定)、history(沿用之前整理用的)、subscription(订阅的)、push(推送时说明的),
	// 或者媒体识别的来源(纠正、IMDb 编号、搜索等)。升级前的记录为空
	MatchSource string `gorm:"size:16;not null;default:''" json:"match_source"`
	// KeepLinks 是在条目详情里删除时选了留着库里的文件、种子连数据删掉了:打开了「删种时一并删除入库链接」也不删这条的入库链接。
	// 同一个源文件重新整理时清掉
	KeepLinks bool      `gorm:"not null;default:false" json:"-"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

MediaTransferHistory 是一个视频文件的整理记录。源文件(pt-tools 里的路径)唯一:同一个文件只整理一次, 同一事件重复到达或几种触发方式碰到一起都不会重复整理。字幕跟着视频一起整理,目标路径记在 Extras 里。

func (MediaTransferHistory) TableName

func (MediaTransferHistory) TableName() string

type MediaWatchDir

type MediaWatchDir struct {
	ID uint `gorm:"primaryKey" json:"id"`
	// Path 是 pt-tools 里看到的目录(绝对路径)
	Path      string    `gorm:"size:1024;not null;uniqueIndex" json:"path"`
	Enabled   bool      `gorm:"not null;default:false" json:"enabled"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

MediaWatchDir 是监控的目录:放进来的视频(不是下载器里的种子,例如手动拷进来、别的工具下载的)按媒体库整理。 目录下的每一项(一个文件,或一个文件夹)当作一个种子:名字用来识别,里面的视频按媒体库的方式整理。

func (MediaWatchDir) TableName

func (MediaWatchDir) TableName() string

type MediaWordRule

type MediaWordRule struct {
	ID          uint      `gorm:"primaryKey" json:"id"`
	Kind        string    `gorm:"size:16;not null;default:''" json:"kind"`
	Pattern     string    `gorm:"size:256;not null;default:''" json:"pattern"`
	Replacement string    `gorm:"size:256;not null;default:''" json:"replacement"`
	Offset      int       `gorm:"not null;default:0" json:"offset"`
	IsRegex     bool      `gorm:"not null;default:false" json:"is_regex"`
	Enabled     bool      `gorm:"not null;default:false" json:"enabled"`
	Note        string    `gorm:"size:256;not null;default:''" json:"note"`
	CreatedAt   time.Time `json:"created_at"`
	UpdatedAt   time.Time `json:"updated_at"`
}

MediaWordRule 是识别词:解析标题之前按顺序套用(集数偏移在解析之后加上)。列的默认值一律是零值。

func (MediaWordRule) TableName

func (MediaWordRule) TableName() string

type Migration added in v0.2.0

type Migration struct {
	Version     int
	Description string
	Up          MigrationFunc
}

Migration 迁移定义

type MigrationFunc added in v0.2.0

type MigrationFunc func(db *gorm.DB) error

MigrationFunc 迁移函数类型

type MigrationState added in v0.35.0

type MigrationState struct {
	ID            uint      `gorm:"primaryKey" json:"id"`
	SchemaVersion int       `gorm:"uniqueIndex;not null" json:"schema_version"`
	CompletedAt   time.Time `gorm:"not null;index" json:"completed_at"`
	BroadcastSent bool      `gorm:"not null;default:false" json:"broadcast_sent"`
	CreatedAt     time.Time `json:"created_at"`
	UpdatedAt     time.Time `json:"updated_at"`
}

MigrationState records post-migration runtime metadata. One row per schema version.

func GetMigrationState added in v0.35.0

func GetMigrationState(db *gorm.DB, schemaVersion int) (*MigrationState, bool)

GetMigrationState returns the row for schemaVersion, or (nil, false) if missing.

type MonitorNotificationLog

type MonitorNotificationLog struct {
	ID                 uint       `gorm:"primaryKey;autoIncrement" json:"id"`
	Source             string     `gorm:"size:32;not null;uniqueIndex:idx_monitor_notify_dedup,priority:1" json:"source"`
	Subject            string     `gorm:"size:64;not null;uniqueIndex:idx_monitor_notify_dedup,priority:2" json:"subject"`
	Kind               string     `gorm:"size:32;not null;uniqueIndex:idx_monitor_notify_dedup,priority:3" json:"kind"`
	EventKey           string     `gorm:"size:128;not null;uniqueIndex:idx_monitor_notify_dedup,priority:4" json:"event_key"`
	NotificationConfID uint       `gorm:"not null;uniqueIndex:idx_monitor_notify_dedup,priority:5" json:"notification_conf_id"`
	BypassQuiet        bool       `gorm:"not null;default:false" json:"bypass_quiet"`
	Result             string     `gorm:"size:16;not null;default:'pending';index:idx_monitor_notify_pending,priority:1" json:"result"`
	Attempts           int        `gorm:"not null;default:0" json:"attempts"`
	NextRetryAt        time.Time  `gorm:"index:idx_monitor_notify_pending,priority:2" json:"next_retry_at"`
	LastError          string     `gorm:"size:1024;default:''" json:"last_error,omitempty"`
	PayloadJSON        string     `gorm:"type:text" json:"payload_json,omitempty"`
	DeliveredAt        *time.Time `json:"delivered_at,omitempty"`
	CreatedAt          time.Time  `json:"created_at"`
	UpdatedAt          time.Time  `json:"updated_at"`
}

MonitorNotificationLog 记录后台监控(登录提醒、战报等)的每条通知在每个通道上的投递。

决定发送时按目标通道各写一行,(source, subject, kind, event_key, notification_conf_id) 唯一, 同一决策重做不会重复发送。投递器按 next_retry_at 取到期的 pending 行,经 live 通道同步发送, 是这些通知唯一的重试者;通道处于静默时段时把 next_retry_at 顺延到静默结束。 时间一律以 UTC 写入,next_retry_at 的字符串比较才有序。

type NasSetting

type NasSetting struct {
	ID           uint   `gorm:"primaryKey"`
	LocalEnabled bool   `gorm:"not null"`
	HomeSource   string `gorm:"size:32"`
	UpdatedAt    time.Time
}

NasSetting 是「NAS 监控」的设置,只有一行(id=1);没有这一行时按默认:本机来源开着、首页自动选来源。 HomeSource 是首页显示哪个来源:""(自动:第一个启用的来源,没有时本机)、"local" 或来源的编号。

func GetNasSetting

func GetNasSetting(db *gorm.DB) (NasSetting, error)

GetNasSetting 读「NAS 监控」的设置;没有这一行时给默认(本机来源开着、首页自动选来源)。

func (NasSetting) TableName

func (NasSetting) TableName() string

type NasSource

type NasSource struct {
	ID              uint   `gorm:"primaryKey"`
	Name            string `gorm:"size:64;not null"`
	Kind            string `gorm:"size:16;not null"`
	Enabled         bool   `gorm:"not null"`
	URL             string `gorm:"column:url;type:text;not null"`
	Username        string `gorm:"size:128"`
	SecretEncrypted string `gorm:"column:secret_encrypted;type:text"`
	ExtraEncrypted  string `gorm:"column:extra_encrypted;type:text"`
	TLSPinSHA256    string `gorm:"column:tls_pin_sha256;size:64"`
	InsecureAck     bool   `gorm:"column:insecure_ack;not null"`
	Revision        int64  `gorm:"not null"`
	CreatedAt       time.Time
	UpdatedAt       time.Time
}

NasSource 是「NAS 监控」里的一个来源(首页 NAS 概览 H2):TrueNAS、Glances、群晖、飞牛。本机来源不在这张表里, 它的开关在 NasSetting。读写只经 web 的 /api/nas* 与 cmd 的 nas_wiring.go。

SecretEncrypted 是 API Key 或密码,ExtraEncrypted 是来源刷新出的长期凭据(群晖的设备令牌、飞牛的 token,JSON), 都是 AES-GCM 密文(与站点 Cookie 同一把密钥),接口只回有没有。TLSPinSHA256 是用户确认信任的证书指纹(小写十六进制, 空表示只按系统根证书校验);InsecureAck 是用户确认过明文 http 连接的风险。Revision 每次保存加一:采集器按它判断 设置变没变,写回刷新的凭据时也只在它没变时写,免得盖掉用户刚改的设置。

布尔列故意不带 gorm 的 default:gorm 建行时会跳过零值字段、改用数据库默认值,用户关掉的开关会被存成开着。

func (NasSource) TableName

func (NasSource) TableName() string

type NotificationConf added in v0.31.0

type NotificationConf struct {
	ID          uint   `gorm:"primaryKey" json:"id"`
	ChannelType string `gorm:"size:32;not null;index:idx_notification_conf_type" json:"channel_type"`
	Name        string `gorm:"size:128;not null" json:"name"`
	ConfigJSON  string `gorm:"type:text" json:"-"`
	Enabled     bool   `gorm:"default:true;index:idx_notification_conf_enabled" json:"enabled"`
	// QuietHoursStart / QuietHoursEnd 控制静默时段,格式 "HH:MM";空字符串表示无静默。
	// 若 start > end(如 "22:00"–"08:00")表示窗口跨越午夜。
	QuietHoursStart string    `gorm:"column:quiet_hours_start;default:''" json:"quiet_hours_start"`
	QuietHoursEnd   string    `gorm:"column:quiet_hours_end;default:''" json:"quiet_hours_end"`
	CreatedAt       time.Time `json:"created_at"`
	UpdatedAt       time.Time `json:"updated_at"`
}

NotificationConf 通知通道配置(Telegram / QQ / Webhook / WeCom 等)。 ConfigJSON 由 internal/crypto AES-GCM 加密后存入,本层仅原样存取字符串。

func (NotificationConf) TableName added in v0.31.0

func (NotificationConf) TableName() string

TableName 强制单数表名,避免 GORM 默认复数化与项目命名风格不一致。

type NotificationOutbox added in v0.31.0

type NotificationOutbox struct {
	ID                 uint       `gorm:"primaryKey" json:"id"`
	NotificationConfID uint       `gorm:"not null;index:idx_notification_outbox_conf" json:"notification_conf_id"`
	PayloadJSON        string     `gorm:"type:text;not null" json:"payload_json"`
	Status             string     `gorm:"size:16;not null;default:'pending';index:idx_notification_outbox_status_retry,priority:1" json:"status"`
	RetryCount         int        `gorm:"default:0" json:"retry_count"`
	NextRetryAt        time.Time  `gorm:"index:idx_notification_outbox_status_retry,priority:2" json:"next_retry_at"`
	CreatedAt          time.Time  `json:"created_at"`
	SentAt             *time.Time `json:"sent_at"`
	ErrorMsg           string     `gorm:"size:1024;default:''" json:"error_msg"`
}

NotificationOutbox 离线投递队列。Status 取值:pending / sent / failed / dead。 复合索引 (status, next_retry_at) 用于 worker 高效扫描待发送记录。

func (NotificationOutbox) TableName added in v0.31.0

func (NotificationOutbox) TableName() string

type NotificationTemplate

type NotificationTemplate struct {
	EventType string    `gorm:"primaryKey;size:64" json:"event_type"`
	Title     string    `gorm:"type:text;not null;default:''" json:"title"`
	Text      string    `gorm:"type:text;not null;default:''" json:"text"`
	UpdatedAt time.Time `json:"updated_at"`
}

NotificationTemplate 是一种事件的全局消息模板(Go 模板,所有通知通道共用)。 Title、Text 空着的一项用内置文字;某种事件没有这一行就全用内置文字。

func (NotificationTemplate) TableName

func (NotificationTemplate) TableName() string

TableName 指定表名。

type PHPTorrentInfo

type PHPTorrentInfo struct {
	Title     string       // 种子标题
	SubTitle  string       // 副标题/标签
	TorrentID string       // 种子 ID
	Discount  DiscountType // 优惠类型
	EndTime   time.Time    // 优惠结束时间
	SizeMB    float64      // 种子大小,单位为 MB
	Seeders   int          // 做种人数
	Leechers  int          // 下载人数
	Completed float64      // 最大完成百分比
	HR        bool         // 是否为 HR(Hit & Run)
}

PHPTorrentInfo 定义种子信息结构

func (PHPTorrentInfo) CanbeFinished

func (p PHPTorrentInfo) CanbeFinished(logger *zap.SugaredLogger, enabled bool, speedLimit, sizeLimitGB int) bool

func (PHPTorrentInfo) GetFreeEndTime

func (p PHPTorrentInfo) GetFreeEndTime() *time.Time

func (PHPTorrentInfo) GetFreeLevel added in v0.0.6

func (p PHPTorrentInfo) GetFreeLevel() string

func (PHPTorrentInfo) GetName added in v0.2.0

func (p PHPTorrentInfo) GetName() string

GetName 获取种子名称

func (PHPTorrentInfo) GetSizeBytes added in v0.25.0

func (p PHPTorrentInfo) GetSizeBytes() int64

GetSizeBytes 获取种子大小(字节),由 SizeMB 换算得到。

func (PHPTorrentInfo) GetSubTitle added in v0.2.0

func (p PHPTorrentInfo) GetSubTitle() string

GetSubTitle 获取副标题

func (PHPTorrentInfo) IsFree

func (p PHPTorrentInfo) IsFree() bool

type PatternType added in v0.2.0

type PatternType string

PatternType represents the type of pattern matching to use.

const (
	// PatternKeyword matches if the title contains the keyword (case-insensitive).
	PatternKeyword PatternType = "keyword"
	// PatternWildcard uses * and ? wildcards for matching.
	PatternWildcard PatternType = "wildcard"
	// PatternRegex uses regular expressions for matching.
	PatternRegex PatternType = "regex"
)

type PromotionRule

type PromotionRule struct {
	Categories  []string `json:"categories"`
	CreatedDate string   `json:"createdDate"`
	Discount    string   `json:"discount"`
}

type QbitCompatSetting

type QbitCompatSetting struct {
	ID uint `gorm:"primaryKey" json:"-"`
	// DownloaderID 是兼容入口背后的下载器;0 表示默认下载器
	DownloaderID uint `gorm:"not null;default:0" json:"downloader_id"`
	// FullControl 打开后,写接口能动下载器里的全部种子;关着时只动经兼容入口加的
	FullControl bool `gorm:"not null;default:false" json:"full_control"`
	// ListenAddr 是在网页上设的监听地址(host:port);空串是不开。启动参数 --qbit-compat-addr 或环境变量
	// PT_QBIT_COMPAT_ADDR 给了地址时用那个,这里的不管用
	ListenAddr string `gorm:"size:128;not null;default:''" json:"listen_addr"`
	// Categories 是客户端用 createCategory 建的分类(JSON:名字 → 保存目录);加种子时没给目录就用它
	Categories string `gorm:"type:text;not null;default:''" json:"-"`
	// Tags 是客户端用 createTags 建的标签(JSON 数组)
	Tags      string    `gorm:"type:text;not null;default:''" json:"-"`
	UpdatedAt time.Time `json:"updated_at"`
}

QbitCompatSetting 是 qB 兼容入口的设置(只有 ID 1 一行,路线图 M13)。监听地址不在这里:它是启动参数。

func (QbitCompatSetting) TableName

func (QbitCompatSetting) TableName() string

type QbitCompatTorrent

type QbitCompatTorrent struct {
	ID           uint      `gorm:"primaryKey"`
	DownloaderID uint      `gorm:"not null;uniqueIndex:idx_qbit_compat_owner"`
	InfoHash     string    `gorm:"size:64;not null;uniqueIndex:idx_qbit_compat_owner"`
	AddedAt      int64     `gorm:"not null;default:0"`
	CreatedAt    time.Time `gorm:"not null"`
}

QbitCompatTorrent 记下经 qB 兼容入口加进下载器的种子:没打开完全控制时,写接口只动这些。 只在种子确实加进下载器(不是原来就在)以后才记,经兼容入口删掉时一起删。 AddedAt 是加完以后在下载器里看到它时、下载器给的添加时间:只认添加时间一样的那一个(删掉以后从别处加回来的时间不一样)。 加完以后看不到它、或者下载器不给添加时间时不记这一条。

func (QbitCompatTorrent) TableName

func (QbitCompatTorrent) TableName() string

type QbitSettings added in v0.1.0

type QbitSettings struct {
	ID        uint      `gorm:"primaryKey" json:"id"`
	Enabled   bool      `json:"enabled"`
	URL       string    `gorm:"not null" json:"url"`
	User      string    `gorm:"not null" json:"user"`
	Password  string    `gorm:"not null" json:"password"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

qBittorrent 设置

type RSSConfig added in v0.1.0

type RSSConfig struct {
	ID              uint       `json:"id"`
	Name            string     `json:"name"`
	URL             string     `json:"url"`
	Category        string     `json:"category"`
	Tag             string     `json:"tag"`
	IntervalMinutes int32      `json:"interval_minutes"` // RSS 执行间隔(分钟),0 表示使用全局设置
	Concurrency     int32      `json:"concurrency"`      // 并发数,0 表示使用全局设置
	DownloadSubPath string     `json:"download_sub_path"`
	DownloadPath    string     `json:"download_path"`   // 下载器中下载任务的目标下载路径(可选)
	DownloaderID    *uint      `json:"downloader_id"`   // 指定下载器,nil 表示使用默认下载器
	FilterRuleIDs   []uint     `json:"filter_rule_ids"` // 关联的过滤规则 ID 列表
	IsExample       bool       `json:"is_example"`      // 是否为示例配置,示例配置不会被执行
	PauseOnFreeEnd  bool       `json:"pause_on_free_end"`
	FreeEndDelete   bool       `json:"free_end_delete"` // 免费结束时删除而不是暂停,只在 PauseOnFreeEnd 为真时有意义
	FilterMode      FilterMode `json:"filter_mode"`     // 空字符串表示使用全局 DefaultFilterMode

	NotifyMode              string `json:"notify_mode"`
	NotifyConfIDs           string `json:"notify_conf_ids"`
	MaxNotificationsPerHour int    `json:"max_notifications_per_hour"`
}

Runtime-friendly structures for API usage and scheduler/config load

func (*RSSConfig) GetEffectiveConcurrency added in v0.2.0

func (r *RSSConfig) GetEffectiveConcurrency(globalSettings *SettingsGlobal) int32

GetEffectiveConcurrency 获取有效的并发数 优先级:RSS 配置 > 全局配置 > 默认值

func (*RSSConfig) GetEffectiveDownloadPath added in v0.2.0

func (r *RSSConfig) GetEffectiveDownloadPath() string

GetEffectiveDownloadPath 获取有效的下载路径 如果 RSS 配置了 DownloadPath 则使用,否则返回空字符串(使用下载器默认路径)

func (*RSSConfig) GetEffectiveFilterMode added in v0.25.0

func (r *RSSConfig) GetEffectiveFilterMode(globalSettings *SettingsGlobal) FilterMode

GetEffectiveFilterMode resolves the filter mode using the RSS > Global > Default priority. RSS-level value takes precedence; empty falls through to the global default; unknown values also fall back to DefaultFilterMode via NormalizeFilterMode.

func (*RSSConfig) GetEffectiveIntervalMinutes added in v0.2.0

func (r *RSSConfig) GetEffectiveIntervalMinutes(globalSettings *SettingsGlobal) int32

GetEffectiveIntervalMinutes 获取有效的间隔时间 优先级:RSS 配置 > 全局配置 > 默认值

func (*RSSConfig) HasCustomDownloadPath added in v0.2.0

func (r *RSSConfig) HasCustomDownloadPath() bool

HasCustomDownloadPath 检查是否配置了自定义下载路径

func (*RSSConfig) ShouldSkip added in v0.2.0

func (r *RSSConfig) ShouldSkip() bool

ShouldSkip 判断是否应该跳过此 RSS 配置 示例配置或 URL 为空的配置应该被跳过

type RSSFilterAssociation added in v0.2.0

type RSSFilterAssociation struct {
	ID           uint      `gorm:"primaryKey" json:"id"`
	RSSID        uint      `gorm:"uniqueIndex:idx_rss_filter;not null" json:"rss_id"`
	FilterRuleID uint      `gorm:"uniqueIndex:idx_rss_filter;not null" json:"filter_rule_id"`
	CreatedAt    time.Time `json:"created_at"`
}

RSSFilterAssociation represents a many-to-many relationship between RSS subscriptions and filter rules.

func (RSSFilterAssociation) TableName added in v0.2.0

func (RSSFilterAssociation) TableName() string

TableName returns the table name for RSSFilterAssociation.

type RSSFilterAssociationDB added in v0.2.0

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

RSSFilterAssociationDB provides database operations for RSSFilterAssociation.

func NewRSSFilterAssociationDB added in v0.2.0

func NewRSSFilterAssociationDB(db *gorm.DB) *RSSFilterAssociationDB

NewRSSFilterAssociationDB creates a new RSSFilterAssociationDB.

func (*RSSFilterAssociationDB) Create added in v0.2.0

Create creates a new RSS-filter association.

func (*RSSFilterAssociationDB) DeleteByFilterRuleID added in v0.2.0

func (r *RSSFilterAssociationDB) DeleteByFilterRuleID(filterRuleID uint) error

DeleteByFilterRuleID deletes all associations for a filter rule.

func (*RSSFilterAssociationDB) DeleteByRSSID added in v0.2.0

func (r *RSSFilterAssociationDB) DeleteByRSSID(rssID uint) error

DeleteByRSSID deletes all associations for an RSS subscription.

func (*RSSFilterAssociationDB) Exists added in v0.2.0

func (r *RSSFilterAssociationDB) Exists(rssID, filterRuleID uint) (bool, error)

Exists checks if an association exists.

func (*RSSFilterAssociationDB) FilterRuleIDsByRSS

func (r *RSSFilterAssociationDB) FilterRuleIDsByRSS() (map[uint][]uint, error)

FilterRuleIDsByRSS 一次读出全部关联,按 RSS 编号分组(每组的顺序与 GetByRSSID 相同)。

func (*RSSFilterAssociationDB) GetByFilterRuleID added in v0.2.0

func (r *RSSFilterAssociationDB) GetByFilterRuleID(filterRuleID uint) ([]uint, error)

GetByFilterRuleID retrieves all RSS IDs associated with a filter rule.

func (*RSSFilterAssociationDB) GetByRSSID added in v0.2.0

func (r *RSSFilterAssociationDB) GetByRSSID(rssID uint) ([]uint, error)

GetByRSSID retrieves all filter rule IDs associated with an RSS subscription.

func (*RSSFilterAssociationDB) GetFilterRuleIDsForRSS added in v0.2.0

func (r *RSSFilterAssociationDB) GetFilterRuleIDsForRSS(rssID uint) ([]uint, error)

GetFilterRuleIDsForRSS is an alias for GetByRSSID for better readability.

func (*RSSFilterAssociationDB) GetFilterRulesForRSS added in v0.2.0

func (r *RSSFilterAssociationDB) GetFilterRulesForRSS(rssID uint) ([]FilterRule, error)

GetFilterRulesForRSS retrieves all filter rules associated with an RSS subscription.

func (*RSSFilterAssociationDB) HasAssociations added in v0.2.0

func (r *RSSFilterAssociationDB) HasAssociations(rssID uint) (bool, error)

HasAssociations checks if an RSS subscription has any filter rule associations.

func (*RSSFilterAssociationDB) SetFilterRulesForRSS added in v0.2.0

func (r *RSSFilterAssociationDB) SetFilterRulesForRSS(rssID uint, filterRuleIDs []uint) error

SetFilterRulesForRSS sets the filter rules for an RSS subscription (replaces all existing associations).

type RSSNotificationLog added in v0.31.0

type RSSNotificationLog struct {
	ID                  uint       `gorm:"primaryKey;autoIncrement" json:"id"`
	RSSID               uint       `` /* 132-byte string literal not displayed */
	SiteName            string     `gorm:"column:site_name;not null;uniqueIndex:idx_rss_notify_dedup,priority:2" json:"site_name"`
	TorrentID           string     `gorm:"column:torrent_id;not null;uniqueIndex:idx_rss_notify_dedup,priority:3" json:"torrent_id"`
	NotifyKind          string     `gorm:"column:notify_kind;not null;uniqueIndex:idx_rss_notify_dedup,priority:4" json:"notify_kind"`
	NotificationConfID  uint       `gorm:"column:notification_conf_id;not null;uniqueIndex:idx_rss_notify_dedup,priority:5" json:"notification_conf_id"`
	MatchedFilterRuleID *uint      `gorm:"column:matched_filter_rule_id" json:"matched_filter_rule_id,omitempty"`
	Result              string     `gorm:"not null;index:idx_rss_notify_pending,priority:1" json:"result"`
	Attempts            int        `gorm:"default:0" json:"attempts"`
	NextRetryAt         *time.Time `gorm:"column:next_retry_at;index:idx_rss_notify_pending,priority:2" json:"next_retry_at,omitempty"`
	LastError           string     `gorm:"default:''" json:"last_error,omitempty"`
	PayloadJSON         string     `gorm:"column:payload_json" json:"payload_json,omitempty"`
	DeliveredAt         *time.Time `gorm:"column:delivered_at" json:"delivered_at,omitempty"`
	CreatedAt           time.Time  `gorm:"index:idx_rss_notify_rss_throttle,priority:2" json:"created_at"`
	UpdatedAt           time.Time  `json:"updated_at"`
}

RSSNotificationLog records every (rss_id, torrent_id, notify_kind, conf_id) notification attempt. Acts as the durable record AND the idempotency guard (via the unique index idx_rss_notify_dedup).

result values: 'sent' | 'failed' | 'suppressed' | 'pending' | 'throttled'

  • 'sent' — accepted by NotificationService.Push (note: may have fallen back to outbox internally; not strictly equal to "delivered to user")
  • 'failed' — Push returned an error
  • 'suppressed' — overshadowed by a later 'filtered' notification for the same (rss_id, site_name, torrent_id)
  • 'pending' — queued but not yet attempted (S3 retry worker uses this)
  • 'throttled' — rejected because RSS hit max_notifications_per_hour

func (RSSNotificationLog) TableName added in v0.31.0

func (RSSNotificationLog) TableName() string

type RSSSubscription added in v0.1.0

type RSSSubscription struct {
	ID              uint       `gorm:"primaryKey" json:"id"`
	SiteID          uint       `gorm:"index" json:"site_id"`
	Name            string     `gorm:"size:128;not null" json:"name"`
	URL             string     `gorm:"size:1024;not null" json:"url"`
	Category        string     `gorm:"size:128" json:"category"`
	Tag             string     `gorm:"size:128" json:"tag"`
	IntervalMinutes int32      `gorm:"check:interval_minutes >= 1" json:"interval_minutes"` // RSS 执行间隔(分钟),0 表示使用全局设置
	Concurrency     int32      `json:"concurrency"`                                         // 并发数,0 表示使用全局设置
	DownloadSubPath string     `gorm:"size:256" json:"download_sub_path"`
	DownloadPath    string     `gorm:"size:512" json:"download_path"` // 下载器中下载任务的目标下载路径(可选)
	DownloaderID    *uint      `gorm:"index" json:"downloader_id"`    // 指定下载器,nil 表示使用默认下载器
	IsExample       bool       `json:"is_example"`                    // 是否为示例配置,示例配置不会被执行
	PauseOnFreeEnd  bool       `gorm:"default:false" json:"pause_on_free_end"`
	FreeEndDelete   bool       `gorm:"default:false" json:"free_end_delete"`  // 免费结束时删除而不是暂停:只在 PauseOnFreeEnd 为真时有意义,推送时写进种子记录
	FilterMode      FilterMode `gorm:"size:16;default:''" json:"filter_mode"` // 空字符串表示使用全局 DefaultFilterMode

	NotifyMode              string `gorm:"column:notify_mode;default:''" json:"notify_mode"`
	NotifyConfIDs           string `gorm:"column:notify_conf_ids;default:'[]'" json:"notify_conf_ids"`
	MaxNotificationsPerHour int    `gorm:"column:max_notifications_per_hour;default:100" json:"max_notifications_per_hour"`

	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

RSS 订阅

type RegisteredSite added in v0.2.0

type RegisteredSite struct {
	ID             string
	Name           string
	AuthMethod     string // "cookie" 或 "api_key"
	DefaultBaseURL string
	APIUrls        []string // API URL 列表,用于轮换(如 mTorrent 站点)
}

RegisteredSite 表示从注册表获取的站点信息

type RemoteDevice

type RemoteDevice struct {
	ID   uint   `gorm:"primaryKey"`
	Name string `gorm:"size:64;not null;default:''"`
	// PublicKey 是设备的 X25519 公钥(base64url);同一把公钥同时只能有一台没撤销的设备
	PublicKey string `gorm:"size:64;not null;default:'';index"`
	// Scopes 是空格分隔的权限范围(app:read,或 app:read app:write)
	Scopes      string `gorm:"size:64;not null;default:''"`
	CreatedAt   time.Time
	LastSeenAt  *time.Time
	LastSeenVia string     `gorm:"size:16;not null;default:''"`
	RevokedAt   *time.Time `gorm:"index"`
}

RemoteDevice 是配对过的设备。撤销只写 RevokedAt,记录留着(审计里的设备编号还对得上),撤销以后才能删掉记录。

func (RemoteDevice) TableName

func (RemoteDevice) TableName() string

TableName 指定表名。

type RemoteSetting

type RemoteSetting struct {
	ID      uint `gorm:"primaryKey"`
	Enabled bool `gorm:"not null;default:false"`
	// RelaysJSON 是 relay 地址(ws:// 或 wss://)的 JSON 数组
	RelaysJSON string `gorm:"type:text;default:''"`
	// DirectURL 是 App 直连这台 pt-tools 用的地址(http:// 或 https://,可以带反向代理的子路径),空 = 配对链接里不带
	DirectURL string `gorm:"size:512;default:''"`
	// RelayDisabled 为真时不用任何 relay(只直连)。为假而 RelaysJSON 为空时用构建时内置的托管 relay
	RelayDisabled bool `gorm:"not null;default:false"`
	// HostKeysEncrypted 是加密后的主机密钥(Ed25519 与 X25519 的私钥)。第一次打开远程访问时生成,轮换时整个换掉
	HostKeysEncrypted string `gorm:"type:text;default:''"`
	UpdatedAt         time.Time
}

RemoteSetting 是远程访问(路线图 M15)的设置,只有一行(ID 为 1)。默认关闭;列的默认值一律是零值。

func (RemoteSetting) TableName

func (RemoteSetting) TableName() string

TableName 指定表名。

type ReseedAttempt

type ReseedAttempt struct {
	ID         uint       `gorm:"primaryKey" json:"id"`
	RunID      *uint      `gorm:"index" json:"run_id,omitempty"`
	StartedAt  time.Time  `gorm:"not null;index;index:idx_reseed_attempt_site_at,priority:2" json:"started_at"`
	FinishedAt *time.Time `json:"finished_at,omitempty"`
	SiteName   string     `gorm:"size:64;not null;index:idx_reseed_attempt_site_at,priority:1" json:"site_name"`
	InfoHash   string     `gorm:"size:64;not null" json:"info_hash"`
	TorrentID  string     `gorm:"size:128;not null;default:''" json:"torrent_id"`
	Name       string     `gorm:"size:512;not null;default:''" json:"name"`
	// DownloaderID 是原种子所在、辅种要加入的下载器
	DownloaderID  uint       `gorm:"not null;default:0" json:"downloader_id"`
	Outcome       string     `gorm:"size:16;not null;index" json:"outcome"`
	Message       string     `gorm:"size:1024;not null;default:''" json:"message"`
	JobID         *uint      `gorm:"index" json:"job_id,omitempty"`
	JobState      string     `gorm:"size:32;not null;default:''" json:"job_state,omitempty"`
	JobFinishedAt *time.Time `gorm:"index" json:"job_finished_at,omitempty"`
	// Backfilled 是升级时按旧的辅种记录补的(v15)
	Backfilled bool `gorm:"not null;default:false;index" json:"backfilled"`
}

ReseedAttempt 是一次辅种尝试,只追加:开始下载种子文件之前写入(从这一刻起占今天这个站点的名额),结束时写结局。 每站每天的名额、轮次里的尝试与统计都按它算;删除或重试辅种记录不改它。 JobState、JobFinishedAt 只在清除已结束的辅种任务时(同一个事务)从任务抄过来,任务还在时看任务表。

func (ReseedAttempt) TableName

func (ReseedAttempt) TableName() string

TableName 指定表名。

type ReseedDailySkip

type ReseedDailySkip struct {
	ID       uint   `gorm:"primaryKey" json:"-"`
	Day      string `gorm:"size:10;not null;uniqueIndex:idx_reseed_skip_day_site" json:"day"`
	SiteName string `gorm:"size:64;not null;default:'';uniqueIndex:idx_reseed_skip_day_site" json:"site_name"`
	// Present 是下载器里已经有,Tried 是已经尝试过,DailyLimit 是今天这个站点已经加满,NotSelected 是站点不在辅种范围
	Present     int `gorm:"not null;default:0" json:"present"`
	Tried       int `gorm:"not null;default:0" json:"tried"`
	DailyLimit  int `gorm:"not null;default:0" json:"daily_limit"`
	NotSelected int `gorm:"not null;default:0" json:"not_selected"`
}

ReseedDailySkip 是每天每个站点在下载以前就跳过的个数(按原因)。每一轮都会重新查一遍,同一个种子在每一轮都算一次。 SiteName 为空串的是 IYUU 那边、不在辅种范围的站点。Day 是进程时区的 YYYY-MM-DD;一轮按站点累计,结束时写一次。 「已有进行中的任务」与「站点已删除」是下载以后才知道的,记在尝试行里,不在这里。

func (ReseedDailySkip) TableName

func (ReseedDailySkip) TableName() string

TableName 指定表名。

type ReseedIYUUDaily

type ReseedIYUUDaily struct {
	ID          uint       `gorm:"primaryKey" json:"-"`
	Day         string     `gorm:"size:10;not null;uniqueIndex:idx_reseed_iyuu_day_ep" json:"day"`
	Endpoint    string     `gorm:"size:16;not null;uniqueIndex:idx_reseed_iyuu_day_ep" json:"endpoint"`
	Calls       int        `gorm:"not null;default:0" json:"calls"`
	OK          int        `gorm:"column:ok;not null;default:0" json:"ok"`
	RateLimited int        `gorm:"not null;default:0" json:"rate_limited"`
	Failed      int        `gorm:"not null;default:0" json:"failed"`
	Hashes      int        `gorm:"not null;default:0" json:"hashes"`
	LastAt      *time.Time `json:"last_at,omitempty"`
}

ReseedIYUUDaily 是每天每个 IYUU 接口的请求计数(Day 是进程时区的 YYYY-MM-DD)。 Calls = OK + RateLimited + Failed;Hashes 是查询的 info hash 数(只有 query 有)。

func (ReseedIYUUDaily) TableName

func (ReseedIYUUDaily) TableName() string

TableName 指定表名。

type ReseedRecord

type ReseedRecord struct {
	ID       uint   `gorm:"primaryKey" json:"id"`
	InfoHash string `gorm:"size:64;not null;uniqueIndex:idx_reseed_hash_site" json:"info_hash"`
	SiteName string `gorm:"size:64;not null;uniqueIndex:idx_reseed_hash_site;index" json:"site_name"`
	// TorrentID 是站内种子 ID;SourceHash 是下载器里那个数据相同的种子。
	TorrentID    string `gorm:"size:128;default:''" json:"torrent_id"`
	SourceHash   string `gorm:"size:64;default:''" json:"source_hash"`
	DownloaderID uint   `gorm:"not null;default:0" json:"downloader_id"`
	Name         string `gorm:"size:512;default:''" json:"name"`
	State        string `gorm:"size:32;not null;index" json:"state"`
	Message      string `gorm:"size:1024;default:''" json:"message"`
	// Retryable 表示这次失败是暂时的(站点不可用、下载种子失败),过了 ReseedRetryAfter 可以再试;核对没通过的不再试。
	Retryable bool      `gorm:"not null;default:false" json:"retryable"`
	JobID     *uint     `gorm:"index" json:"job_id,omitempty"`
	CreatedAt time.Time `gorm:"index" json:"created_at"`
	UpdatedAt time.Time `gorm:"index" json:"updated_at"`
}

ReseedRecord 记下对某个站点某个种子(info hash)的一次辅种尝试,同一对只尝试一次。

func (ReseedRecord) TableName

func (ReseedRecord) TableName() string

TableName 指定表名。

type ReseedRun

type ReseedRun struct {
	ID         uint       `gorm:"primaryKey" json:"id"`
	Trigger    string     `gorm:"size:16;not null;default:''" json:"trigger"`
	StartedAt  time.Time  `gorm:"not null;index" json:"started_at"`
	FinishedAt *time.Time `json:"finished_at,omitempty"`
	Status     string     `gorm:"size:16;not null;default:'';index" json:"status"`
	Summary    string     `gorm:"size:1024;not null;default:''" json:"summary"`
	Error      string     `gorm:"size:1024;not null;default:''" json:"error"`
	// 计数:读到的下载器、查询的种子(重试轮次是选中的记录数)、IYUU 查询的批数与完成的批数、候选与各个结果
	Downloaders int `gorm:"not null;default:0" json:"downloaders"`
	Hashes      int `gorm:"not null;default:0" json:"hashes"`
	Batches     int `gorm:"not null;default:0" json:"batches"`
	BatchesDone int `gorm:"not null;default:0" json:"batches_done"`
	Candidates  int `gorm:"not null;default:0" json:"candidates"`
	Created     int `gorm:"not null;default:0" json:"created"`
	Failed      int `gorm:"not null;default:0" json:"failed"`
	Gone        int `gorm:"not null;default:0" json:"gone"`
	Interrupted int `gorm:"not null;default:0" json:"interrupted"`
	Skipped     int `gorm:"not null;default:0" json:"skipped"`
	// SkippedDetail 是跳过的原因与个数(JSON 对象)
	SkippedDetail string `gorm:"type:text;not null;default:''" json:"-"`
	IYUUCalls     int    `gorm:"column:iyuu_calls;not null;default:0" json:"iyuu_calls"`
	// After 是这一轮从哪个 info hash 之后开始查(空串是从头);Cursor 是最后一个完整处理完的批的最后一个 info hash(一批都没处理完时为空)。
	After         string `gorm:"size:64;not null;default:''" json:"-"`
	Cursor        string `gorm:"size:64;not null;default:''" json:"-"`
	ContinuedFrom *uint  `json:"continued_from,omitempty"`
	// PausedAt 是这一次暂停的开始时间(暂停中才有);PausedSeconds 是已经暂停过的总秒数
	PausedAt      *time.Time `json:"paused_at,omitempty"`
	PausedSeconds int        `gorm:"not null;default:0" json:"paused_seconds"`
	// Steps 是这一轮的步骤(ReseedRunStep 的 JSON 数组,最多 16 KiB;超出时后面的不记,StepsTruncated 为真)
	Steps          string `gorm:"type:text;not null;default:''" json:"-"`
	StepsTruncated bool   `gorm:"not null;default:false" json:"steps_truncated"`
}

ReseedRun 是一轮辅种(定时、立即运行、继续或重试):开始时写一行,跑完补上结果、计数与步骤。 保留最近 ReseedRunKeep 条且不超过 ReseedRunKeepFor。

func (ReseedRun) TableName

func (ReseedRun) TableName() string

TableName 指定表名。

type ReseedRunStep

type ReseedRunStep struct {
	Kind string `json:"kind"`
	Text string `json:"text"`
}

ReseedRunStep 是一轮里的一步:Kind 是种类(list、query、add、fail、gone、stop、error、info),Text 给人看。

type ReseedSetting

type ReseedSetting struct {
	ID      uint `gorm:"primaryKey" json:"id"`
	Enabled bool `gorm:"not null;default:false" json:"enabled"`
	// TokenEncrypted 是加密后的 IYUU token;接口只返回是否已设置。
	TokenEncrypted string `gorm:"type:text;default:''" json:"-"`
	// IntervalHours 是定时运行的间隔(0 时按 ReseedDefaultIntervalHours)。
	IntervalHours int `gorm:"not null;default:0" json:"interval_hours"`
	// DownloaderIDs 是参与辅种的下载器(JSON 数组,空表示全部启用的下载器)。
	DownloaderIDs string `gorm:"type:text;default:''" json:"-"`
	// SiteNames 是允许辅种的站点(JSON 数组);SiteMode 为 ReseedSitesSelected 时只辅种这些站点。
	SiteNames string `gorm:"type:text;default:''" json:"-"`
	// SiteMode 是站点范围:ReseedSitesAll(全部已配置、IYUU 也支持的站点,以后新配置的也算)或 ReseedSitesSelected(只算 SiteNames)。
	// 旧数据为空串:SiteNames 为空时是全部,不为空时只算 SiteNames(见 ReseedSiteModeOf)。
	SiteMode string `gorm:"size:16;not null;default:''" json:"-"`
	// MaxPerSitePerDay 是每个站点每天最多加几个辅种(0 时按 ReseedDefaultMaxPerSitePerDay)。
	MaxPerSitePerDay int `gorm:"not null;default:0" json:"max_per_site_per_day"`
	// SidSha1 是 IYUU 的 reportExisting 返回的站点哈希,SidKey 是当时报告的站点 sid 列表;7 天内站点没变时复用。
	SidSha1   string     `gorm:"size:128;default:''" json:"-"`
	SidKey    string     `gorm:"type:text;default:''" json:"-"`
	SidAt     *time.Time `json:"-"`
	LastRunAt *time.Time `json:"last_run_at,omitempty"`
	// LastResult 是上一轮的一句话结果。
	LastResult string `gorm:"type:text;default:''" json:"last_result"`
	// IYUUMinIntervalSeconds 是两次请求 IYUU 之间至少隔几秒:NULL 是没设置、按 ReseedDefaultIYUUMinInterval;0 是不隔。
	IYUUMinIntervalSeconds *int `gorm:"column:iyuu_min_interval_seconds" json:"-"`
	// IYUUMaxCallsPerDay 是每天最多请求 IYUU 几次,0 是不限。
	IYUUMaxCallsPerDay int `gorm:"column:iyuu_max_calls_per_day;not null;default:0" json:"-"`
	// IYUUCooldownUntil 是 IYUU 限流以后冷却到什么时候:这之前不发请求、不跑定时轮次。
	IYUUCooldownUntil *time.Time `gorm:"column:iyuu_cooldown_until" json:"-"`
	// IYUULastLimit 是最近一次限流的情况(JSON)。
	IYUULastLimit string `gorm:"column:iyuu_last_limit;type:text;default:''" json:"-"`
	// NotifyMode 是每轮结果推送:ReseedNotifyOff(空串也是关闭)、ReseedNotifyAlways(每一轮)、ReseedNotifyChanges(只在有变化时)。
	NotifyMode string `gorm:"size:16;not null;default:''" json:"-"`
	// NotifyChannelIDs 是接收每轮结果的通知通道(JSON 数组);推送开着时至少一个,不沿用「空表示全部通道」。
	NotifyChannelIDs string `gorm:"type:text;default:''" json:"-"`
	// DailyReport 为 true 时每日战报里加一行今天的辅种。
	DailyReport bool      `gorm:"not null;default:false" json:"-"`
	UpdatedAt   time.Time `json:"updated_at"`
}

ReseedSetting 是 IYUU 辅种的设置(只有一行,ID 为 1)。默认关闭;列的默认值一律是零值。

func (ReseedSetting) TableName

func (ReseedSetting) TableName() string

TableName 指定表名。

type SchemaManager added in v0.2.0

type SchemaManager struct {

	// BackupTable 在迁移改表前把整张表存一份;fromVer、toVer 是这一步迁移的版本,写进备份文件名
	BackupTable   func(db *gorm.DB, table string, fromVer, toVer int) (path string, err error)
	EncryptCookie func(plain string) (cipher string, err error)
	DecryptCookie func(cipher string) (plain string, err error)
	// contains filtered or unexported fields
}

SchemaManager 架构版本管理器

func NewSchemaManager added in v0.2.0

func NewSchemaManager(db *gorm.DB, appVersion string) *SchemaManager

NewSchemaManager 创建架构版本管理器

func NewSchemaManagerWithHooks added in v0.35.0

func NewSchemaManagerWithHooks(
	db *gorm.DB,
	appVersion string,
	backupFn func(db *gorm.DB, table string, fromVer, toVer int) (path string, err error),
	encryptFn func(plain string) (cipher string, err error),
	decryptFn func(cipher string) (plain string, err error),
) *SchemaManager

func (*SchemaManager) EnsureSchemaVersionTable added in v0.2.0

func (sm *SchemaManager) EnsureSchemaVersionTable() error

EnsureSchemaVersionTable 确保版本表存在

func (*SchemaManager) GetCurrentVersion added in v0.2.0

func (sm *SchemaManager) GetCurrentVersion() (int, error)

GetCurrentVersion 获取当前数据库架构版本

func (*SchemaManager) RecordVersion added in v0.2.0

func (sm *SchemaManager) RecordVersion(version int, description string) error

RecordVersion 记录版本

func (*SchemaManager) RunMigrations added in v0.2.0

func (sm *SchemaManager) RunMigrations() error

RunMigrations 运行所有待执行的迁移

type SchemaVersion added in v0.2.0

type SchemaVersion struct {
	ID          uint      `gorm:"primaryKey" json:"id"`
	Version     int       `gorm:"uniqueIndex;not null" json:"version"` // 架构版本号
	Description string    `gorm:"size:255" json:"description"`         // 版本描述
	AppliedAt   time.Time `gorm:"not null" json:"applied_at"`          // 应用时间
	AppVersion  string    `gorm:"size:64" json:"app_version"`          // 应用版本
}

SchemaVersion 数据库架构版本表 用于跟踪数据库迁移状态

type ServarrTag

type ServarrTag struct {
	ID        uint      `gorm:"primaryKey" json:"id"`
	Label     string    `gorm:"size:128;not null;default:'';uniqueIndex" json:"label"`
	CreatedAt time.Time `json:"created_at"`
}

ServarrTag 是一个标签(Radarr 与 Sonarr 共用编号)。

func (ServarrTag) TableName

func (ServarrTag) TableName() string
type ServarrTagLink struct {
	ID         uint   `gorm:"primaryKey" json:"id"`
	Kind       string `gorm:"size:8;not null;default:'';uniqueIndex:idx_servarr_tag_link" json:"kind"`
	ExternalID uint   `gorm:"not null;default:0;uniqueIndex:idx_servarr_tag_link" json:"external_id"`
	TagID      uint   `gorm:"not null;default:0;uniqueIndex:idx_servarr_tag_link;index" json:"tag_id"`
}

ServarrTagLink 是一个条目挂着的一个标签。

func (ServarrTagLink) TableName

func (ServarrTagLink) TableName() string

type SettingsGlobal added in v0.1.0

type SettingsGlobal struct {
	ID                     uint   `gorm:"primaryKey" json:"id"`
	DefaultIntervalMinutes int32  `json:"default_interval_minutes" gorm:"default:10"` // 默认 RSS 执行间隔(分钟)
	DefaultConcurrency     int32  `json:"default_concurrency" gorm:"default:3"`       // 默认并发数
	DefaultEnabled         bool   `json:"default_enabled"`
	DownloadDir            string `gorm:"not null" json:"download_dir"`
	DownloadLimitEnabled   bool   `json:"download_limit_enabled"`
	DownloadSpeedLimit     int    `json:"download_speed_limit"`
	TorrentSizeGB          int    `json:"torrent_size_gb"`
	TorrentMinSizeGB       int    `json:"torrent_min_size_gb"` // 全局最小种子大小(GB),0 = 无下限
	MinFreeMinutes         int    `json:"min_free_minutes" gorm:"default:30"`
	AutoStart              bool   `json:"auto_start"`
	RetainHours            int    `json:"retain_hours" gorm:"default:24"`
	MaxRetry               int    `json:"max_retry" gorm:"default:3"`

	// 自动删种
	CleanupEnabled        bool    `json:"cleanup_enabled" gorm:"default:false"`
	CleanupIntervalMin    int     `json:"cleanup_interval_min" gorm:"default:30"`
	CleanupScope          string  `json:"cleanup_scope" gorm:"size:16;default:'database'"`
	CleanupScopeTags      string  `json:"cleanup_scope_tags" gorm:"size:256"`
	CleanupRemoveData     bool    `json:"cleanup_remove_data" gorm:"default:true"`
	CleanupConditionMode  string  `json:"cleanup_condition_mode" gorm:"size:8;default:'or'"`
	CleanupMaxSeedTimeH   int     `json:"cleanup_max_seed_time_h" gorm:"default:0"`
	CleanupMinRatio       float64 `json:"cleanup_min_ratio" gorm:"default:0"`
	CleanupMaxInactiveH   int     `json:"cleanup_max_inactive_h" gorm:"default:0"`
	CleanupSlowSeedTimeH  int     `json:"cleanup_slow_seed_time_h" gorm:"default:0"`
	CleanupSlowMaxRatio   float64 `json:"cleanup_slow_max_ratio" gorm:"default:0"`
	CleanupDelFreeExpired bool    `json:"cleanup_del_free_expired" gorm:"default:true"`
	CleanupDiskProtect    bool    `json:"cleanup_disk_protect" gorm:"default:true"`
	CleanupMinDiskSpaceGB float64 `json:"cleanup_min_disk_space_gb" gorm:"default:50"`
	// CleanupEmergency 是空间低于下限时紧急清理(自动删种按优先级多挑种子删、推送遇到空间不足时提前开始一轮检查);
	// 只在 CleanupDiskProtect 开着时起作用。v16 以前没有这个开关,紧急清理跟着磁盘空间保护一起开
	CleanupEmergency   bool   `json:"cleanup_emergency" gorm:"default:true"`
	CleanupProtectDL   bool   `json:"cleanup_protect_dl" gorm:"default:false"`
	CleanupProtectHR   bool   `json:"cleanup_protect_hr" gorm:"default:true"`
	CleanupMinRetainH  int    `json:"cleanup_min_retain_h" gorm:"default:24"`
	CleanupProtectTags string `json:"cleanup_protect_tags" gorm:"size:256"`

	// 免费结束自动删除:v17 起不再生效,免费结束时删除还是暂停每条 RSS 自己选(RSSSubscription.FreeEndDelete)。
	// 列留着升级前的值,只给迁移换算与回退到旧版用,保存全局设置时不改它
	AutoDeleteOnFreeEnd bool `json:"auto_delete_on_free_end" gorm:"default:false"`

	// 免费期结束前提前处理的安全余量(分钟)。>0 时暂停/删除提前 N 分钟触发,规避删除延迟与
	// tracker 汇报滞后导致的超额下载量;0 = 到点处理(旧行为)。生效范围 [0,60]。
	FreeEndAdvanceMinutes int `json:"free_end_advance_minutes" gorm:"default:0"`

	// 默认下载模式(RSS 级别可 override)
	DefaultFilterMode FilterMode `json:"default_filter_mode" gorm:"size:16;default:'auto_free'"`

	// 做种竞争度:自动删种的一条删除条件(v16 以前是单独的监控),跟着自动删种的检查间隔。
	// PeerRatioRemoveData 为真时超标的种子删除(连不连数据跟着 CleanupRemoveData),否则只暂停。
	// PeerRatioIntervalMin 是原来竞争度监控的检查间隔:新版不再读写,只在 v16 迁移时换算成自动删种的间隔
	PeerRatioEnabled     bool    `json:"peer_ratio_enabled" gorm:"default:false"`
	PeerRatioMaxSL       float64 `json:"peer_ratio_max_sl" gorm:"default:30.0"` // Seeder/Leecher 比值上限
	PeerRatioIntervalMin int     `json:"peer_ratio_interval_min" gorm:"default:10"`
	PeerRatioRemoveData  bool    `json:"peer_ratio_remove_data" gorm:"default:false"`

	// 每日签到时间窗(HH:MM,进程时区):各站每天在窗口内随机取一个时刻签到。
	// 只经 ConfigStore.SaveAttendanceWindow 写;SaveGlobalSettings 不改这两列。
	AttendanceWindowStart string `json:"attendance_window_start" gorm:"size:5;default:'08:00'"`
	AttendanceWindowEnd   string `json:"attendance_window_end" gorm:"size:5;default:'10:00'"`
	// AttendanceAIEnabled 让 AI 过签到的验证码与答题(HDSky、OpenCD 识别验证码,CHDBits、52PT 答题),默认关闭。
	// AttendanceVisionModel 是识别验证码用的模型(要能看图,用 AI 助手的服务商与 Key),空时用 AI 助手的模型。
	// 只经 ConfigStore.SaveAttendanceAI 写;SaveGlobalSettings 不改这两列。
	AttendanceAIEnabled   bool   `json:"attendance_ai_enabled" gorm:"default:false"`
	AttendanceVisionModel string `json:"attendance_vision_model" gorm:"size:128"`
	// AttendanceNotifyEnabled 每天所有站点签完后推一条签到结果,默认开(以前一直推给所有启用的通道);
	// AttendanceNotifyChannelIDs 是推到哪些通知通道(JSON 数组),空表示所有启用的通道。
	// 只经 ConfigStore.SaveAttendanceNotify 写;SaveGlobalSettings 不改这两列。
	AttendanceNotifyEnabled    bool   `json:"attendance_notify_enabled" gorm:"default:true"`
	AttendanceNotifyChannelIDs string `json:"attendance_notify_channel_ids" gorm:"size:512;default:'[]'"`

	// 每日战报:每天在设定时刻(HH:MM,进程时区)加上本安装固定的偏移后,把当天的数据增量发到选定的通道。
	// 只经 ConfigStore.SaveDailyReportSettings 写;SaveGlobalSettings 不改这几列。
	DailyReportEnabled    bool   `json:"daily_report_enabled" gorm:"default:false"`
	DailyReportTime       string `json:"daily_report_time" gorm:"size:5;default:'22:00'"`
	DailyReportChannelIDs string `json:"daily_report_channel_ids" gorm:"size:512;default:'[]'"`
	// DailyReportScope 是统计范围:previous_day(前一天整天,默认,已有的安装加列时也是它)或 today(当天截至发送时刻)。
	DailyReportScope string `json:"daily_report_scope" gorm:"size:16;default:'previous_day'"`
	// DailyReportOffsetSeconds 是本安装固定的 1–600 秒偏移,首次用到时随机分配;0 表示还没分配。
	// 各安装错开发送时刻,不在同一分钟一起打通知接口。
	DailyReportOffsetSeconds int `json:"-" gorm:"default:0"`

	// 下载器助手的失效种子定时扫描:只通知、不删种。只经 ConfigStore.SaveDeadTorrentScanSettings 写。
	// 间隔为 0 时按 24 小时。列的默认值都是零值(GORM 新建时会把零值换成 default)。
	DeadTorrentScanEnabled    bool   `json:"dead_torrent_scan_enabled" gorm:"default:false"`
	DeadTorrentScanIntervalH  int    `json:"dead_torrent_scan_interval_h" gorm:"default:0"`
	DeadTorrentScanChannelIDs string `json:"dead_torrent_scan_channel_ids" gorm:"size:512;default:''"`

	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

全局设置

func (*SettingsGlobal) GetEffectiveConcurrency added in v0.2.0

func (s *SettingsGlobal) GetEffectiveConcurrency() int32

GetEffectiveConcurrency 获取有效的并发数(带默认值和边界检查)

func (*SettingsGlobal) GetEffectiveIntervalMinutes added in v0.2.0

func (s *SettingsGlobal) GetEffectiveIntervalMinutes() int32

GetEffectiveIntervalMinutes 获取有效的间隔时间(带默认值和边界检查)

func (*SettingsGlobal) GetEffectivePeerRatioIntervalMin added in v0.23.0

func (s *SettingsGlobal) GetEffectivePeerRatioIntervalMin() int

func (*SettingsGlobal) GetEffectivePeerRatioMaxSL added in v0.23.0

func (s *SettingsGlobal) GetEffectivePeerRatioMaxSL() float64

type Showcase

type Showcase struct {
	CreatedDate      string     `json:"createdDate"`
	LastModifiedDate string     `json:"lastModifiedDate"`
	ID               string     `json:"id"`
	Collection       bool       `json:"collection"`
	UserID           string     `json:"userid"`
	Username         string     `json:"username"`
	CnTitle          string     `json:"cntitle"`
	EnTitle          string     `json:"entitle"`
	Note             string     `json:"note"`
	Pic              string     `json:"pic"`
	Pic1             string     `json:"pic1"`
	Pic2             string     `json:"pic2"`
	Count            string     `json:"count"`
	Size             string     `json:"size"`
	View             string     `json:"view"`
	Statistics       Statistics `json:"statistics"`
}

type SiteAttendanceEvent

type SiteAttendanceEvent struct {
	ID       uint   `gorm:"primaryKey;autoIncrement" json:"id"`
	SiteName string `gorm:"size:64;not null;index:idx_attendance_event_day,priority:2" json:"site_name"`
	Day      string `gorm:"size:10;not null;index:idx_attendance_event_day,priority:1" json:"day"`
	Trigger  string `gorm:"size:16;not null;default:'auto'" json:"trigger"`
	Result   string `gorm:"size:16;not null;default:''" json:"result"`
	Method   string `gorm:"size:16;not null;default:'direct'" json:"method"`
	// AIModel 是这次签到调的模型(没调 AI 时为空)
	AIModel string `gorm:"size:128;not null;default:''" json:"ai_model,omitempty"`
	// AICalls 是模型回了几次(认错验证码换一张再认时不止一次)
	AICalls          int       `gorm:"not null;default:0" json:"ai_calls"`
	PromptTokens     int64     `gorm:"not null;default:0" json:"prompt_tokens"`
	CompletionTokens int64     `gorm:"not null;default:0" json:"completion_tokens"`
	DurationMs       int64     `gorm:"not null;default:0" json:"duration_ms"`
	Message          string    `gorm:"size:512;not null;default:''" json:"message,omitempty"`
	Error            string    `gorm:"size:1024;not null;default:''" json:"error,omitempty"`
	StartedAt        time.Time `gorm:"index" json:"started_at"`
	FinishedAt       time.Time `json:"finished_at"`
}

SiteAttendanceEvent 是一次签到尝试(定时或手动各一行),给「签到详情」看当天每个站点怎么签的: 结果、直接签还是借助 AI、AI 调了几次、用掉多少 token。Day 与 SiteAttendanceLog 的同一天对应;时间一律是 UTC。

func (SiteAttendanceEvent) TableName

func (SiteAttendanceEvent) TableName() string

TableName 指定表名。

type SiteAttendanceLog

type SiteAttendanceLog struct {
	ID            uint       `gorm:"primaryKey;autoIncrement" json:"id"`
	SiteName      string     `gorm:"size:64;not null;uniqueIndex:idx_site_attendance_day,priority:1" json:"site_name"`
	Day           string     `gorm:"size:10;not null;uniqueIndex:idx_site_attendance_day,priority:2" json:"day"`
	Status        string     `gorm:"size:16;not null;default:'pending'" json:"status"`
	Attempts      int        `gorm:"not null;default:0" json:"attempts"`
	ScheduledAt   time.Time  `json:"scheduled_at"`
	NextAttemptAt *time.Time `json:"next_attempt_at,omitempty"`
	LastAttemptAt *time.Time `json:"last_attempt_at,omitempty"`
	Message       string     `gorm:"size:512;default:''" json:"message,omitempty"`
	LastError     string     `gorm:"size:1024;default:''" json:"last_error,omitempty"`
	CreatedAt     time.Time  `json:"created_at"`
	UpdatedAt     time.Time  `json:"updated_at"`
}

SiteAttendanceLog 记录每个站点每天的签到,(site_name, day) 唯一,一天一行。 Day 是进程时区(Docker 的 TZ)的日期 YYYY-MM-DD;时间列一律以 UTC 写入。

func (SiteAttendanceLog) Done

func (l SiteAttendanceLog) Done() bool

Done 报告当天的签到是否已有最终结果。

type SiteAttendanceRepository

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

func NewSiteAttendanceRepository

func NewSiteAttendanceRepository(db *gorm.DB) *SiteAttendanceRepository

func (*SiteAttendanceRepository) AddEvent

AddEvent 记一次签到尝试。

func (*SiteAttendanceRepository) EnsureDay

EnsureDay 在当天还没有记录时按 row 建行;已有行时什么也不改,所以一天的计划时间只定一次。

func (*SiteAttendanceRepository) GetDay

func (r *SiteAttendanceRepository) GetDay(siteName, day string) (*SiteAttendanceLog, error)

GetDay 返回某站某天的签到记录,没有时返回 gorm.ErrRecordNotFound。

func (*SiteAttendanceRepository) ListDay

ListDay 返回某天所有站点的签到记录,按站点名排序。

func (*SiteAttendanceRepository) ListEvents

func (r *SiteAttendanceRepository) ListEvents(day string) ([]SiteAttendanceEvent, error)

ListEvents 返回某天所有站点的签到尝试,按站点名、开始时间排序。

func (*SiteAttendanceRepository) ListRange

func (r *SiteAttendanceRepository) ListRange(fromDay, toDay string) ([]SiteAttendanceLog, error)

ListRange 返回 [fromDay, toDay] 之间(含两端,YYYY-MM-DD)所有站点的签到记录,按日期倒序、站点名排序。

func (*SiteAttendanceRepository) PurgeEventsBefore

func (r *SiteAttendanceRepository) PurgeEventsBefore(before time.Time) (int64, error)

PurgeEventsBefore 删掉 before 以前开始的签到事件,返回删了几行。按时刻比较(julianday),不按文本。

func (*SiteAttendanceRepository) UpdateDay

func (r *SiteAttendanceRepository) UpdateDay(siteName, day string, columns map[string]any) error

UpdateDay 只写给出的列。

type SiteConfig added in v0.1.0

type SiteConfig struct {
	Enabled           *bool       `json:"enabled"`
	AuthMethod        string      `json:"auth_method"`
	Cookie            string      `json:"cookie"`
	APIKey            string      `json:"api_key"`
	APIUrl            string      `json:"api_url"`
	Passkey           string      `json:"passkey"`
	UploadLimitKBs    int         `json:"upload_limit_kbs"`
	DownloadLimitKBs  int         `json:"download_limit_kbs"`
	SeedingCapacityGB float64     `json:"seeding_capacity_gb"`
	HRSeedTimeH       int         `json:"hr_seed_time_h"`
	RSS               []RSSConfig `json:"rss"`
}

type SiteData added in v0.6.0

type SiteData struct {
	Name            string
	DisplayName     string
	BaseURL         string
	Enabled         bool
	AuthMethod      string
	Cookie          string
	CookieEncrypted string
	APIKey          string
	APIURL          string
	Passkey         string
	DownloaderID    *uint
	ParserConfig    string
	IsBuiltin       bool
	TemplateID      *uint
}

SiteData 站点数据(用于创建/更新)

type SiteGroup

type SiteGroup string

type SiteLoginPreset added in v0.35.0

type SiteLoginPreset struct {
	BanThresholdDays   int
	RemindBeforeDays   int
	ProbeJitterSeconds int
	Notes              string
}

type SiteLoginState added in v0.35.0

type SiteLoginState struct {
	ID                       uint       `gorm:"primaryKey" json:"id"`
	SiteName                 string     `gorm:"uniqueIndex;size:64;not null" json:"site_name"`
	LastLoginAt              *time.Time `json:"last_login_at"`
	LastAccessAt             *time.Time `json:"last_access_at"`
	LastVisitAt              *time.Time `json:"last_visit_at"`
	LastProbeAt              *time.Time `json:"last_probe_at"`
	LastProbeStatus          string     `gorm:"size:32" json:"last_probe_status"`
	LastProbeError           string     `gorm:"type:text" json:"last_probe_error"`
	ConsecutiveProbeFailures int        `json:"consecutive_probe_failures"`
	ProbeJitterSeconds       int        `json:"probe_jitter_seconds"`
	BanThresholdDays         int        `gorm:"default:30" json:"ban_threshold_days"`
	RemindBeforeDays         int        `gorm:"default:10" json:"remind_before_days"`
	ReminderCron             string     `gorm:"size:64;default:'0 10,22 * * *'" json:"reminder_cron"`
	NotificationChannelIDs   string     `gorm:"type:text" json:"notification_channel_ids"`
	LastReminderTier         string     `gorm:"size:16;default:'none'" json:"last_reminder_tier"`
	LastReminderSentAt       *time.Time `json:"last_reminder_sent_at"`
	ApiLastLoginAt           *time.Time `json:"api_last_login_at,omitempty"`
	CookieLastLoginAt        *time.Time `json:"cookie_last_login_at,omitempty"`
	ProbeMode                string     `gorm:"size:16;default:'auto'" json:"probe_mode"`
	LastConsistencyCheck     string     `gorm:"size:32;default:''" json:"last_consistency_check"`

	// 以下列由各自唯一的写者维护(见 scheduler/login_reminder_monitor.go 顶部的写者表)。
	// NextProbeAt 是下一次定时探测的时间;LastProbeStartedAt 是最近一次探测开始(取锁并重读配置之前)的时间,
	// 与 ProbeRequestedAt 一起判断「凭证更新后是否还欠一次探测」。
	NextProbeAt        *time.Time `json:"next_probe_at,omitempty"`
	LastProbeStartedAt *time.Time `json:"last_probe_started_at,omitempty"`
	ProbeRequestedAt   *time.Time `json:"probe_requested_at,omitempty"`
	// FirstFailureAt 是当前失败连续段的开始时间,探测成功时清空;LastSuccessAt 是最近一次成功探测的时间。
	FirstFailureAt *time.Time `json:"first_failure_at,omitempty"`
	LastSuccessAt  *time.Time `json:"last_success_at,omitempty"`
	// LastFailureNotifiedAt 是当前失败连续段最近一次发出失败提醒的时间,恢复提醒发出后清空。
	LastFailureNotifiedAt *time.Time `json:"last_failure_notified_at,omitempty"`
	// AccessStaleSince:探测成功但站点返回的 last_access 超过 48 小时没有前进时写入,前进后清空。
	AccessStaleSince *time.Time `json:"access_stale_since,omitempty"`

	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

func DefaultSiteLoginState

func DefaultSiteLoginState(siteName string) SiteLoginState

DefaultSiteLoginState 返回新站点登录状态行的默认值。

type SiteLoginStateRepository added in v0.35.0

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

func NewSiteLoginStateRepository added in v0.35.0

func NewSiteLoginStateRepository(db *gorm.DB) *SiteLoginStateRepository

func (*SiteLoginStateRepository) ClampLastVisit added in v0.35.0

func (r *SiteLoginStateRepository) ClampLastVisit(siteName string, ts, now time.Time) error

ClampLastVisit 记录浏览器扩展上报的访问时间:晚于 now 的按 now 记,早于已记录值的忽略(只前进不后退)。 比较在 Go 里做:历史数据可能以本地时区存储,SQLite 按字符串比较时间会排错序。

func (*SiteLoginStateRepository) EnsureLoginStateRow

func (r *SiteLoginStateRepository) EnsureLoginStateRow(defaults SiteLoginState) error

EnsureLoginStateRow 在缺行时按 defaults 建行,已有行时什么也不改。 用 ON CONFLICT DO NOTHING,两个写者同时建行也不会报唯一约束冲突。

func (*SiteLoginStateRepository) GetLoginState added in v0.35.0

func (r *SiteLoginStateRepository) GetLoginState(siteName string) (*SiteLoginState, error)

func (*SiteLoginStateRepository) IncrProbeFailures added in v0.35.0

func (r *SiteLoginStateRepository) IncrProbeFailures(siteName string) error

func (*SiteLoginStateRepository) ListLoginStates added in v0.35.0

func (r *SiteLoginStateRepository) ListLoginStates(enabledOnly bool) ([]SiteLoginState, error)

func (*SiteLoginStateRepository) ResetProbeFailures added in v0.35.0

func (r *SiteLoginStateRepository) ResetProbeFailures(siteName string) error

func (*SiteLoginStateRepository) UpdateColumns

func (r *SiteLoginStateRepository) UpdateColumns(siteName string, columns map[string]any) error

UpdateColumns 只写给出的列(键为列名),不读不改其他列。

func (*SiteLoginStateRepository) UpdateProbeResult added in v0.35.0

func (r *SiteLoginStateRepository) UpdateProbeResult(siteName, status string, lastLogin, lastAccess *time.Time, probeErr error) error

func (*SiteLoginStateRepository) UpsertLoginState added in v0.35.0

func (r *SiteLoginStateRepository) UpsertLoginState(siteName string, fields map[string]any) error

UpsertLoginState 只更新 fields 里给出的列(键为字段名,见 loginStateFieldColumns),缺行时先按默认值建行。 不整行写回,所以不会覆盖探测、提醒循环在此期间写入的列。

type SiteProxySetting

type SiteProxySetting struct {
	ID      uint `gorm:"primaryKey" json:"-"`
	Enabled bool `gorm:"not null;default:false" json:"enabled"`
	// ProxyEncrypted 是加密后的代理地址(可能带用户名密码)
	ProxyEncrypted string `gorm:"type:text" json:"-"`
	// Mode 是 all(全部站点)、include(只有选中的)或 exclude(除了选中的)
	Mode string `gorm:"size:16;not null;default:'all'" json:"mode"`
	// SitesJSON 是选中站点 ID 的 JSON 数组(规范化后的小写 ID)
	SitesJSON string    `gorm:"type:text" json:"-"`
	UpdatedAt time.Time `json:"updated_at"`
}

SiteProxySetting 是全局设置里的「站点代理」:哪些站点的请求经哪个代理发出。只有一行(id=1),没有这一行表示关闭。 读写只经 core.ConfigStore(代理地址在那里加解密)。

func (SiteProxySetting) TableName

func (SiteProxySetting) TableName() string

type SiteRateLimit added in v0.8.0

type SiteRateLimit struct {
	SiteID       string    `gorm:"primaryKey;size:64" json:"site_id"`
	WindowStart  time.Time `gorm:"not null" json:"window_start"`   // 当前窗口开始时间
	RequestCount int       `gorm:"default:0" json:"request_count"` // 当前窗口内请求数
	UpdatedAt    time.Time `gorm:"autoUpdateTime" json:"updated_at"`
}

SiteRateLimit 站点速率限制记录 每个站点一行,使用滑动窗口算法持久化请求计数

func (SiteRateLimit) TableName added in v0.8.0

func (SiteRateLimit) TableName() string

TableName 指定表名

type SiteRepository added in v0.6.0

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

SiteRepository 站点数据库操作封装

func NewSiteRepository added in v0.6.0

func NewSiteRepository(db *gorm.DB) *SiteRepository

func (*SiteRepository) BatchUpdateSiteDownloader added in v0.6.0

func (r *SiteRepository) BatchUpdateSiteDownloader(siteIDs []uint, downloaderID uint) (int64, error)

func (*SiteRepository) CreateSite added in v0.6.0

func (r *SiteRepository) CreateSite(data SiteData) (uint, error)

func (*SiteRepository) DeleteSite added in v0.6.0

func (r *SiteRepository) DeleteSite(name string) error

func (*SiteRepository) GetSiteByID added in v0.6.0

func (r *SiteRepository) GetSiteByID(id uint) (*SiteSetting, error)

func (*SiteRepository) GetSiteByName added in v0.6.0

func (r *SiteRepository) GetSiteByName(name string) (*SiteSetting, error)

func (*SiteRepository) ListEnabledSites added in v0.6.0

func (r *SiteRepository) ListEnabledSites() ([]SiteSetting, error)

func (*SiteRepository) ListSites added in v0.6.0

func (r *SiteRepository) ListSites() ([]SiteSetting, error)

func (*SiteRepository) SiteExistsByName added in v0.6.0

func (r *SiteRepository) SiteExistsByName(name string) (bool, error)

func (*SiteRepository) UpdateSiteCredentials added in v0.6.0

func (r *SiteRepository) UpdateSiteCredentials(name string, enabled *bool, authMethod, cookie, apiKey, apiURL, passkey string) error

func (*SiteRepository) UpdateSiteDownloader added in v0.6.0

func (r *SiteRepository) UpdateSiteDownloader(name string, downloaderID *uint) error

func (*SiteRepository) UpdateSiteDownloaderByID added in v0.6.0

func (r *SiteRepository) UpdateSiteDownloaderByID(siteID uint, downloaderID *uint) error

type SiteSetting added in v0.1.0

type SiteSetting struct {
	ID                uint    `gorm:"primaryKey" json:"id"`
	Name              string  `gorm:"uniqueIndex;size:64;not null" json:"name"`
	DisplayName       string  `gorm:"size:128" json:"display_name"`
	BaseURL           string  `gorm:"size:512" json:"base_url"`
	Enabled           bool    `json:"enabled"`
	AuthMethod        string  `gorm:"size:16;not null" json:"auth_method"`
	Cookie            string  `gorm:"size:2048" json:"cookie,omitempty"`
	CookieEncrypted   string  `gorm:"type:text" json:"cookie_encrypted,omitempty"`
	APIKey            string  `gorm:"size:512" json:"api_key,omitempty"`
	APIUrl            string  `gorm:"size:512" json:"api_url,omitempty"`
	APIUrls           string  `gorm:"size:2048" json:"api_urls,omitempty"`
	Passkey           string  `gorm:"size:512" json:"passkey,omitempty"`
	DownloaderID      *uint   `gorm:"index" json:"downloader_id,omitempty"`
	ParserConfig      string  `gorm:"type:text" json:"parser_config,omitempty"`
	UploadLimitKBs    int     `gorm:"default:0" json:"upload_limit_kbs"`
	DownloadLimitKBs  int     `gorm:"default:0" json:"download_limit_kbs"`
	SeedingCapacityGB float64 `gorm:"default:0" json:"seeding_capacity_gb"` // 单站点刷流容量上限(GB),0=不限制 (#405)
	// HRSeedTimeH 是用户填的 H&R 做种要求(小时):站点定义里没有 H&R 做种时长时用它(#727),0=未填
	HRSeedTimeH       int       `gorm:"default:0" json:"hr_seed_time_h"`
	AttendanceEnabled bool      `gorm:"default:false" json:"attendance_enabled"` // 每日自动签到,默认关闭;只经 ConfigStore.SetSiteAttendanceEnabled 写
	IsBuiltin         bool      `json:"is_builtin"`
	TemplateID        *uint     `gorm:"index" json:"template_id,omitempty"`
	CreatedAt         time.Time `json:"created_at"`
	UpdatedAt         time.Time `json:"updated_at"`
}

SiteSetting 站点设置(统一表,合并原 DynamicSiteSetting)

type SiteTemplate added in v0.2.0

type SiteTemplate struct {
	ID           uint      `gorm:"primaryKey" json:"id"`
	Name         string    `gorm:"uniqueIndex;size:64;not null" json:"name"`
	DisplayName  string    `gorm:"size:128" json:"display_name"`
	BaseURL      string    `gorm:"size:512;not null" json:"base_url"`
	AuthMethod   string    `gorm:"size:16;not null" json:"auth_method"` // cookie, api_key
	ParserConfig string    `gorm:"type:text" json:"parser_config"`      // JSON格式的解析器配置
	Description  string    `gorm:"size:1024" json:"description"`
	Version      string    `gorm:"size:32" json:"version"`
	Author       string    `gorm:"size:64" json:"author"`
	CreatedAt    time.Time `json:"created_at"`
	UpdatedAt    time.Time `json:"updated_at"`
}

SiteTemplate 站点模板 用于导入/导出站点配置(不包含敏感信息)

func (*SiteTemplate) FromExport added in v0.2.0

func (t *SiteTemplate) FromExport(export *SiteTemplateExport) error

FromExport 从导出格式创建

func (SiteTemplate) TableName added in v0.2.0

func (SiteTemplate) TableName() string

TableName 指定表名

func (*SiteTemplate) ToExport added in v0.2.0

func (t *SiteTemplate) ToExport() *SiteTemplateExport

ToExport 转换为导出格式

type SiteTemplateExport added in v0.2.0

type SiteTemplateExport struct {
	Name         string          `json:"name"`
	DisplayName  string          `json:"display_name"`
	BaseURL      string          `json:"base_url"`
	AuthMethod   string          `json:"auth_method"`
	ParserConfig json.RawMessage `json:"parser_config,omitempty"`
	Description  string          `json:"description,omitempty"`
	Version      string          `json:"version,omitempty"`
	Author       string          `json:"author,omitempty"`
}

SiteTemplateExport 导出格式(不包含数据库字段)

type Statistics

type Statistics struct {
	CreatedDate      string `json:"createdDate"`
	LastModifiedDate string `json:"lastModifiedDate"`
	ID               string `json:"id"`
	Day              string `json:"day"`
	Week             string `json:"week"`
	Month            string `json:"month"`
	Year             string `json:"year"`
	DayClick         string `json:"dayClick"`
	WeekClick        string `json:"weekClick"`
	MonthClick       string `json:"monthClick"`
	YearClick        string `json:"yearClick"`
}

type Status

type Status struct {
	ID               string         `json:"id"`
	CreatedDate      string         `json:"createdDate"`
	LastModifiedDate string         `json:"lastModifiedDate"`
	PickType         string         `json:"pickType"`
	ToppingLevel     string         `json:"toppingLevel"`
	ToppingEndTime   string         `json:"toppingEndTime"`
	Discount         string         `json:"discount"`
	DiscountEndTime  string         `json:"discountEndTime"`
	TimesCompleted   string         `json:"timesCompleted"`
	Comments         string         `json:"comments"`
	LastAction       string         `json:"lastAction"`
	LastSeederAction string         `json:"lastSeederAction"`
	Views            string         `json:"views"`
	Hits             string         `json:"hits"`
	Support          string         `json:"support"`
	Oppose           string         `json:"oppose"`
	Status           string         `json:"status"`
	Seeders          string         `json:"seeders"`
	Leechers         string         `json:"leechers"`
	Banned           bool           `json:"banned"`
	Visible          bool           `json:"visible"`
	PromotionRule    *PromotionRule `json:"promotionRule"`
	MallSingleFree   any            `json:"mallSingleFree"`
}

type TorrentDB

type TorrentDB struct {
	DB *gorm.DB
}

TorrentDB 封装数据库操作

func NewDB

func NewDB(gormLg zapgorm2.Logger) (*TorrentDB, error)

NewDB 初始化并返回 TorrentDB

func NewDBWithVersion added in v0.2.0

func NewDBWithVersion(gormLg zapgorm2.Logger, appVersion string) (*TorrentDB, error)

NewDBWithVersion 初始化并返回 TorrentDB(带应用版本)

func NewDBWithVersionAndHooks added in v0.35.0

func NewDBWithVersionAndHooks(
	gormLg zapgorm2.Logger,
	appVersion string,
	backupFn func(db *gorm.DB, table string, fromVer, toVer int) (path string, err error),
	encryptFn func(plain string) (cipher string, err error),
	decryptFn func(cipher string) (plain string, err error),
	beforeMigrate func(db *gorm.DB) error,
) (*TorrentDB, error)

NewDBWithVersionAndHooks 打开数据库并迁移。beforeMigrate 在设置好 WAL 之后、AutoMigrate 与编号迁移之前调用 (升级前备份用);它返回的错误只记日志,不阻止打开数据库。

func (*TorrentDB) DeleteTorrent

func (t *TorrentDB) DeleteTorrent(torrentHash string) error

DeleteTorrent 删除种子信息

func (*TorrentDB) GetAllTorrents

func (t *TorrentDB) GetAllTorrents() ([]TorrentInfo, error)

GetAllTorrents 查询所有种子信息

func (*TorrentDB) GetTorrentBySiteAndHash

func (t *TorrentDB) GetTorrentBySiteAndHash(siteName, torrentHash string) (*TorrentInfo, error)

GetTorrentBySiteAndHash 根据 SiteName 和 TorrentHash 查询种子信息

func (*TorrentDB) GetTorrentBySiteAndID

func (t *TorrentDB) GetTorrentBySiteAndID(siteName, torrentID string) (*TorrentInfo, error)

GetTorrentBySiteAndID 根据 SiteName 和 TorrentID 查询种子信息

func (*TorrentDB) UpdateTorrentStatus

func (t *TorrentDB) UpdateTorrentStatus(torrentHash string, isDownloaded, isPushed bool, pushTime *time.Time) error

UpdateTorrentStatus 更新种子状态

func (*TorrentDB) UpsertTorrent

func (t *TorrentDB) UpsertTorrent(torrent *TorrentInfo) error

UpsertTorrent 插入或更新种子信息

func (*TorrentDB) WithTransaction

func (t *TorrentDB) WithTransaction(fn func(tx *gorm.DB) error) error

WithTransaction 使用事务

func (*TorrentDB) WithTransactionContext added in v0.10.0

func (t *TorrentDB) WithTransactionContext(ctx context.Context, fn func(tx *gorm.DB) error) error

WithTransactionContext 使用事务(支持 context)

type TorrentInfo

type TorrentInfo struct {
	ID             uint       `gorm:"primaryKey" json:"id"`
	SiteName       string     `gorm:"uniqueIndex:idx_site_torrent" json:"siteName"`
	TorrentID      string     `gorm:"uniqueIndex:idx_site_torrent" json:"torrentId"`
	TorrentHash    *string    `gorm:"index" json:"torrentHash"`
	IsFree         bool       `gorm:"default:false" json:"isFree"`
	IsDownloaded   bool       `gorm:"default:false" json:"isDownloaded"`
	IsPushed       *bool      `gorm:"default:null" json:"isPushed"`
	IsSkipped      bool       `gorm:"default:false" json:"isSkipped"`
	FreeLevel      string     `gorm:"default:'normal'" json:"freeLevel"`
	FreeEndTime    *time.Time `gorm:"default:null" json:"freeEndTime"`
	PushTime       *time.Time `gorm:"default:null" json:"pushTime"`
	Title          string     `gorm:"default:''" json:"title"`
	Category       string     `gorm:"default:''" json:"category"`
	Tag            string     `gorm:"default:''" json:"tag"`
	CreatedAt      time.Time  `json:"createdAt"`
	UpdatedAt      time.Time  `json:"updatedAt"`
	IsExpired      bool       `gorm:"default:false" json:"isExpired"`
	LastCheckTime  *time.Time `gorm:"default:null" json:"lastCheckTime"`
	RetryCount     int        `gorm:"default:0" json:"retryCount"`
	LastError      string     `gorm:"default:''" json:"lastError"`
	DownloadSource string     `gorm:"size:32;default:'free_download'" json:"downloadSource"` // free_download or filter_rule
	FilterRuleID   *uint      `gorm:"index" json:"filterRuleId"`                             // ID of the matched filter rule
	// PushedFilterRuleID 是把这个种子推进下载器的 RSS 过滤规则(推送时记下,之后不改)。FilterRuleID 是 RSS 最近一次判断命中的
	// 规则,每轮刷新;规则命中数按它统计已推送的种子(「这条规则真的下过几个」)
	PushedFilterRuleID *uint `gorm:"default:null" json:"pushedFilterRuleId"`

	// 免费结束管理相关字段
	DownloaderID     *uint      `gorm:"index" json:"downloaderId"`                // 推送到的下载器 ID
	DownloaderName   string     `gorm:"size:64;default:''" json:"downloaderName"` // 下载器名称(冗余存储便于查询)
	CompletedAt      *time.Time `gorm:"default:null" json:"completedAt"`          // 下载完成时间
	IsPausedBySystem bool       `gorm:"default:false" json:"isPausedBySystem"`    // 是否被系统自动暂停
	PauseOnFreeEnd   bool       `gorm:"default:false" json:"pauseOnFreeEnd"`      // 免费结束时是否暂停(来自 RSS 配置)
	FreeEndDelete    bool       `gorm:"default:false" json:"freeEndDelete"`       // 免费结束时删除而不是暂停(推送时按 RSS 的选择写下)
	PausedAt         *time.Time `gorm:"default:null" json:"pausedAt"`             // 系统暂停时间
	PauseReason      string     `gorm:"size:256;default:''" json:"pauseReason"`   // 暂停原因
	IsCompleted      bool       `gorm:"default:false;index" json:"isCompleted"`   // 下载是否已完成
	Progress         float64    `gorm:"default:0" json:"progress"`                // 下载进度 (0-100)
	TorrentSize      int64      `gorm:"default:0" json:"torrentSize"`             // 种子大小(字节)
	DownloaderTaskID string     `gorm:"size:128;default:''" json:"downloaderTaskId"`
	HasHR            bool       `gorm:"default:false" json:"hasHR"`
	HRSeedTimeH      int        `gorm:"default:0" json:"hrSeedTimeH"` // 下载器中的任务 ID(用于暂停/删除操作)
	CheckCount       int        `gorm:"default:0" json:"checkCount"`  // 进度检查次数
	Seeders          int        `gorm:"default:0" json:"seeders"`
	Leechers         int        `gorm:"default:0" json:"leechers"`
	// PeerPauseOverridden 是做种竞争度暂停过、用户又手动开始了的种子(在下载器里或「暂停任务」页):
	// 自动删种的竞争度不再暂停它,其他删除条件照常
	PeerPauseOverridden bool `gorm:"default:false" json:"peerPauseOverridden"`
	// IMDbID、DoubanID 是站点给的外部编号(详情页或接口里有时才有),媒体识别优先用它们
	IMDbID   string `gorm:"column:imdb_id;size:16;default:''" json:"imdbId"`
	DoubanID string `gorm:"column:douban_id;size:16;default:''" json:"doubanId"`
	// MediaType、TMDBID、MediaSeason 是推送时说明的条目(订阅推送、网页上按条目推送时写;RSS、刷流、辅种、qB 兼容入口不写):
	// 整理入库没有手动指定、之前也没整理过、不是订阅的种子时按它整理,不再识别。空串与 0 是不知道
	MediaType   string `gorm:"column:media_type;size:8;default:''" json:"mediaType"`
	TMDBID      int    `gorm:"column:tmdb_id;default:0" json:"tmdbId"`
	MediaSeason int    `gorm:"column:media_season;default:0" json:"mediaSeason"`

	// 免费资格(docs/design/free-expiry-safety.md):每次读到站点详情都按规范快照整套写入。
	// FreeValidity 是 not_free / free_until / free_permanent / unknown;空串是还没按新规则验证过的旧记录。
	FreeValidity     string     `gorm:"size:16;default:''" json:"freeValidity"`
	FreeVerifiedAt   *time.Time `gorm:"default:null" json:"freeVerifiedAt"`         // 最近一次成功读到资格的时间
	FreeStatusSource string     `gorm:"size:32;default:''" json:"freeStatusSource"` // base / promotion_rule / mall_single_free / adapter / legacy
	FreeStatusError  string     `gorm:"size:256;default:''" json:"freeStatusError"` // 读取资格时的问题(结束时间无法解析等),不含原始响应
	// DetailID 是取站点详情用的种子编号(从 RSS 条目链接里取,不含密钥);推送前重新验证资格时用
	DetailID string `gorm:"size:64;default:''" json:"detailId"`
	// SourceRSSID 是这个种子的所有者 RSS:第一次决定下载(进入暂存)的那条。其他 RSS 不改它的策略字段,也不处理它的暂存文件
	SourceRSSID *uint `gorm:"column:source_rss_id;index" json:"sourceRssId"`
	// RequireFree 是入场是否以免费为前提(免费通道、要求免费的过滤规则、要求免费的订阅与刷流)
	RequireFree bool `gorm:"default:false" json:"requireFree"`

	// 免费结束暂停的执行记录:计划时间(结束时间减提前量)、实际发出请求的时间;确认暂停的时间是 PausedAt。
	PausePlannedAt   *time.Time `gorm:"default:null" json:"pausePlannedAt"`
	PauseRequestedAt *time.Time `gorm:"default:null" json:"pauseRequestedAt"`
	// FreeEndFailures 是到期处理连续失败的次数(与推送重试的 RetryCount 分开);FreeEndAlertedAt 是已经告警的时间
	FreeEndFailures  int        `gorm:"default:0" json:"freeEndFailures"`
	FreeEndAlertedAt *time.Time `gorm:"default:null" json:"freeEndAlertedAt"`
	// PushPendingAt 是承诺到期暂停的推送在加入下载器之前写下的标记:加入后补记账成功才清掉。
	// 还留着标记说明加入后记账失败了,对账时按下载器与哈希找回任务、补记账(任务保持暂停,不自动开始)
	PushPendingAt *time.Time `gorm:"default:null" json:"pushPendingAt"`
	// FreeEndedAt 是已推送、原来免费的种子后来读到「不免费」时记下的免费结束时间(不晚于读到的时间)。
	// 刷新资格会把 is_free、free_end_time 改成当前事实;自动删种的「免费到期未完成删除」靠它认出免费已经结束
	FreeEndedAt *time.Time `gorm:"default:null" json:"freeEndedAt"`
}

TorrentInfo 表示种子信息

func (*TorrentInfo) GetExpired added in v0.0.10

func (t *TorrentInfo) GetExpired() bool

type TorrentInfoArchive added in v0.3.0

type TorrentInfoArchive struct {
	ID                 uint       `gorm:"primaryKey" json:"id"`
	OriginalID         uint       `gorm:"index" json:"originalId"`
	SiteName           string     `gorm:"index" json:"siteName"`
	TorrentID          string     `gorm:"index" json:"torrentId"`
	TorrentHash        *string    `gorm:"index" json:"torrentHash"`
	IsFree             bool       `json:"isFree"`
	IsDownloaded       bool       `json:"isDownloaded"`
	IsPushed           *bool      `json:"isPushed"`
	IsSkipped          bool       `json:"isSkipped"`
	FreeLevel          string     `json:"freeLevel"`
	FreeEndTime        *time.Time `json:"freeEndTime"`
	PushTime           *time.Time `json:"pushTime"`
	Title              string     `json:"title"`
	Category           string     `json:"category"`
	Tag                string     `json:"tag"`
	OriginalCreatedAt  time.Time  `json:"originalCreatedAt"`
	OriginalUpdatedAt  time.Time  `json:"originalUpdatedAt"`
	IsExpired          bool       `json:"isExpired"`
	LastCheckTime      *time.Time `json:"lastCheckTime"`
	RetryCount         int        `json:"retryCount"`
	LastError          string     `json:"lastError"`
	DownloadSource     string     `json:"downloadSource"`
	FilterRuleID       *uint      `json:"filterRuleId"`
	PushedFilterRuleID *uint      `json:"pushedFilterRuleId"`
	DownloaderID       *uint      `json:"downloaderId"`
	DownloaderName     string     `json:"downloaderName"`
	CompletedAt        *time.Time `json:"completedAt"`
	IsPausedBySystem   bool       `json:"isPausedBySystem"`
	PauseOnFreeEnd     bool       `json:"pauseOnFreeEnd"`
	PausedAt           *time.Time `json:"pausedAt"`
	PauseReason        string     `json:"pauseReason"`
	IsCompleted        bool       `json:"isCompleted"`
	Progress           float64    `json:"progress"`
	TorrentSize        int64      `json:"torrentSize"`
	DownloaderTaskID   string     `json:"downloaderTaskId"`
	HasHR              bool       `json:"hasHR"`
	HRSeedTimeH        int        `json:"hrSeedTimeH"`
	CheckCount         int        `json:"checkCount"`
	IMDbID             string     `gorm:"column:imdb_id;size:16;default:''" json:"imdbId"`
	DoubanID           string     `gorm:"column:douban_id;size:16;default:''" json:"doubanId"`
	// 推送时说明的条目(同 TorrentInfo):归档以后种子照样在下载器里做种,整理入库照样按它整理
	MediaType   string `gorm:"column:media_type;size:8;default:''" json:"mediaType"`
	TMDBID      int    `gorm:"column:tmdb_id;default:0" json:"tmdbId"`
	MediaSeason int    `gorm:"column:media_season;default:0" json:"mediaSeason"`
	// 免费资格、归属与暂停记录:与 TorrentInfo 同名的列,归档时原样复制
	FreeValidity     string     `gorm:"size:16;default:''" json:"freeValidity"`
	FreeVerifiedAt   *time.Time `json:"freeVerifiedAt"`
	FreeStatusSource string     `gorm:"size:32;default:''" json:"freeStatusSource"`
	FreeStatusError  string     `gorm:"size:256;default:''" json:"freeStatusError"`
	SourceRSSID      *uint      `gorm:"column:source_rss_id" json:"sourceRssId"`
	RequireFree      bool       `json:"requireFree"`
	PausePlannedAt   *time.Time `json:"pausePlannedAt"`
	PauseRequestedAt *time.Time `json:"pauseRequestedAt"`
	FreeEndFailures  int        `json:"freeEndFailures"`
	FreeEndAlertedAt *time.Time `json:"freeEndAlertedAt"`
	DetailID         string     `gorm:"size:64;default:''" json:"detailId"`
	PushPendingAt    *time.Time `json:"pushPendingAt"`
	FreeEndedAt      *time.Time `json:"freeEndedAt"`
	ArchivedAt       time.Time  `gorm:"autoCreateTime" json:"archivedAt"`
}

TorrentInfoArchive 种子信息归档表(存储超过保留期的记录)

type TorrentMetadata added in v0.2.0

type TorrentMetadata interface {
	// GetName 获取种子名称(优先返回中文名)
	GetName() string
	// GetSubTitle 获取副标题/标签信息
	GetSubTitle() string
	// GetSizeBytes 获取种子大小(字节),用于过滤规则的大小匹配
	GetSizeBytes() int64
}

TorrentMetadata 统一的种子元数据接口 用于获取种子的标题、副标题等信息,便于过滤规则匹配

type TorrentTransferJob

type TorrentTransferJob struct {
	ID uint `gorm:"primaryKey" json:"id"`
	// Kind 是任务种类:空串是转移做种,reseed 是辅种(源与目标是同一台下载器,不移除任何种子)。
	Kind               string `gorm:"size:16;not null;default:'';index" json:"kind"`
	SourceDownloaderID uint   `gorm:"not null;index" json:"source_downloader_id"`
	TargetDownloaderID uint   `gorm:"not null;index" json:"target_downloader_id"`
	InfoHash           string `gorm:"size:64;not null;index" json:"info_hash"`
	Name               string `gorm:"size:512;default:''" json:"name"`
	TotalSize          int64  `gorm:"not null;default:0" json:"total_size"`
	// SiteName 与 TorrentID 来自 pt-tools 的种子记录;没有记录时 SiteName 按 tracker 认出,TorrentID 为空。
	SiteName       string `gorm:"size:64;default:''" json:"site_name"`
	TorrentID      string `gorm:"size:128;default:''" json:"torrent_id"`
	SourceSavePath string `gorm:"size:1024;default:''" json:"source_save_path"`
	TargetSavePath string `gorm:"size:1024;default:''" json:"target_save_path"`
	Category       string `gorm:"size:128;default:''" json:"category"`
	Tags           string `gorm:"size:512;default:''" json:"tags"`
	// OwnerTag 是加入目标时带上的这个任务独有的标签(JobTag),恢复、校验、回滚、收尾前用它确认目标里的种子是这个任务加的;
	// 加入之前写进库,任务结束后从下载器里去掉。空串是早期版本建的任务,按这一种任务的通用标签认。
	OwnerTag string `gorm:"size:64;not null;default:''" json:"-"`
	State    string `gorm:"size:32;not null;index" json:"state"`
	Message  string `gorm:"size:1024;default:''" json:"message"`
	// Progress 是最近一次看到的目标校验进度(0–1)。
	Progress float64 `gorm:"not null;default:0" json:"progress"`
	// RecheckIssued 表示已经让目标下载器开始校验。
	RecheckIssued bool `gorm:"not null;default:false" json:"recheck_issued"`
	// TorrentData 是导出的种子文件;任务结束时清空。
	TorrentData []byte `gorm:"type:blob" json:"-"`
	RuleID      *uint  `gorm:"index" json:"rule_id,omitempty"`
	// CheckStartedAt 是加入目标的时间;Deadline 是校验时限。
	CheckStartedAt *time.Time `json:"check_started_at,omitempty"`
	Deadline       *time.Time `json:"deadline,omitempty"`
	FinishedAt     *time.Time `json:"finished_at,omitempty"`
	CreatedAt      time.Time  `json:"created_at"`
	UpdatedAt      time.Time  `json:"updated_at"`
}

TorrentTransferJob 是把一个种子从源下载器转移到目标下载器的任务:导出种子 → 暂停加入目标(数据路径按映射换算) → 校验到 100% → 恢复目标 → 从源移除(不删数据)。状态持久化,进程重启后接着做。 列的默认值一律是零值(GORM 新建时会把零值换成 default)。

func (TorrentTransferJob) TableName

func (TorrentTransferJob) TableName() string

TableName 指定表名。

type TransferRule

type TransferRule struct {
	ID                 uint   `gorm:"primaryKey" json:"id"`
	Name               string `gorm:"size:64;not null;uniqueIndex" json:"name"`
	Enabled            bool   `gorm:"not null;default:false" json:"enabled"`
	SourceDownloaderID uint   `gorm:"not null" json:"source_downloader_id"`
	TargetDownloaderID uint   `gorm:"not null" json:"target_downloader_id"`
	// Category 是分类等于;Tag 是标签里含有(大小写不敏感);SiteName 是 pt-tools 记录的站点或按 tracker 认出的站点。
	Category        string `gorm:"size:128;default:''" json:"category"`
	Tag             string `gorm:"size:128;default:''" json:"tag"`
	SiteName        string `gorm:"size:64;default:''" json:"site_name"`
	MinSeedingHours int    `gorm:"not null;default:0" json:"min_seeding_hours"`
	// MaxPerRun 是每一轮最多建几个任务(0 时按 TransferRuleDefaultMaxPerRun)。
	MaxPerRun int `gorm:"not null;default:0" json:"max_per_run"`
	// IntervalMin 是运行间隔(分钟,0 时按 TransferRuleDefaultIntervalMin)。
	IntervalMin int        `gorm:"not null;default:0" json:"interval_min"`
	LastRunAt   *time.Time `json:"last_run_at,omitempty"`
	LastResult  string     `gorm:"size:512;default:''" json:"last_result"`
	CreatedAt   time.Time  `json:"created_at"`
	UpdatedAt   time.Time  `json:"updated_at"`
}

TransferRule 是定时转移规则:按间隔把源下载器里符合条件、已经做完种的种子建成转移任务。默认关闭。 条件为空或 0 表示不限。

func (TransferRule) TableName

func (TransferRule) TableName() string

TableName 指定表名。

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL