配置参考
媒体库分页 API
GET /api/animes 保持原有完整 JSON 数组响应。客户端可使用 GET /api/animes?page=1&limit=N&before=ID 按 ID 倒序读取精简媒体库卡片：limit 默认为 30，范围为 1–100；省略 before 从最新记录开始，后续请求使用响应中的 next_before。响应为 { "items": [...], "next_before": ID }，next_before 为 0 表示没有后续页。卡片字段为 id、title、season、cover、meta_name、meta_name_cn 和 summary；封面为服务端相对路径。非法分页大小或游标返回 HTTP 400。
配置方式与优先级
环境变量提供启动值，网页可编辑的对应设置保存到数据库后优先于环境变量。修改 Compose 环境变量需重建容器；仅重启不会更新环境变量，也不会覆盖数据库中的旧选择。
设置页统一保存下载器、媒体库、代理、同步周期、账户等设置。媒体库目录发生变化时先检测写入，失败整份设置不保存。下载目录、数据库路径及内置下载器端口等启动参数不在网页中修改。
首次向导沿用部署默认值；完整环境账户可跳过向导。代理输入留空沿用部署代理，关闭已有代理请在初始化后的设置页操作。通用、飞牛及 Windows 安装步骤分别见对应安装文档。
基础环境变量
| 变量 | 默认值 | 说明 |
|---|---|---|
DB_PATH | Linux /data/auto-anime.db；Windows 程序同级 data/auto-anime.db | SQLite 路径，一个数据库只运行一个实例 |
DOWNLOAD_DIR | 默认数据目录下 downloads | 默认下载/归档目录，媒体库留空时使用 |
LIBRARY_DIR | Windows 程序同级 media\；其它平台空 | 媒体根目录（番剧文件夹的父目录）；飞牛模板显式设为 /media，Windows 清空界面设置时回退下载目录 |
COVERS_DIR | 数据库同级 covers | 本地封面缓存 |
PORT | 8000 | HTTP 监听端口；桌面模式仅回环，服务模式不限定回环 |
DOWNLOAD_MODE | Windows 与容器 native；其它源码 direct | 内置 BT 下载器；数据库值优先 |
POLL_MINUTES | 30 | RSS 同步间隔，分钟，最小 5 |
DOWNLOADER_POLL_SECONDS | 10 | 下载器轮询间隔，秒，最小 5 |
KEEP_SOURCE_FILES | true | 归档成功后保留下载器源文件做种 |
PROXY_URL | 空 | 显式出站代理，留空直连 |
BANGUMI_ENABLED | true | 仅值为 true 时开启自动元数据获取；关闭可用 false |
BANGUMI_API | https://api.bgm.tv | Bangumi API 根地址 |
AGGREGATE_SEARCH_URL | https://search.115415.xyz | 聚合服务 HTTPS 根地址；自建可覆盖，显式空值禁用；仅回环地址可用 HTTP，不在网页设置中修改 |
AGGREGATE_SEARCH_TOKEN | 空；默认公共服务无需令牌 | 自建私有服务需至少 32 字符，仅后端持有；兼容已有 Windows 加密凭据，显式空值禁用凭据回退但不禁用默认公共服务 |
WEB_USER / WEB_PASSWORD | 空 | 同时配置启用认证，缺一项不算完整账户 |
WEBHOOK_URL | 空 | 事件 JSON POST 接收地址 |
UPDATE_CHECK | 1 | 0 / false / off / no 关闭联网版本检查和一键更新 |
UPDATE_SOURCE | 空 | 默认发布仓库，也可填仓库标识、GitHub 地址或自建前缀 |
GITHUB_TOKEN | 空 | 可选 GitHub API 令牌，提高额度或读取私有仓库 |
UPDATE_PROXY | 空 | 更新流量专用代理，留空沿用 PROXY_URL |
Linux 源码运行同样默认 /data，不是 backend/data；普通用户开发应显式设置独立目录。Windows 可执行文件默认程序同级 data（媒体库默认同级的 media），go run / go test 退回当前工作目录。程序打印实际数据库、下载、封面与媒体库路径。早期盘根数据不自动迁移，继续使用需显式配置旧路径。Windows 上的存储位置只接受盘符路径或 UNC 共享，/vol1/... 这类容器路径会被拒绝，已在数据库里的旧值会在启动日志提示。
Docker Compose 专用的 /install 部署配置页只在容器/Linux 提供；Windows 上返回 404，设置页不显示入口。
在线聚合搜索
默认公共服务当前启用 mikan,dmhy,acgrip,nyaasi,bangumi-moe 五个来源，新增来源无需升级客户端。自建部署须在 Jackett 中配置并验证来源，再设置服务端 JACKETT_INDEXERS；不要把该变量配置在 NAS 客户端。ACG.RIP 使用 TV 分类，其余来源使用动漫分类，适配与实时可用性见在线聚合搜索服务。
资源列表提供标题关键词、来源、字幕组 / 发布组和清晰度组合筛选，无需新增环境变量。选项来自完整返回结果，未知字幕组或清晰度可单独选择；切换番剧或重新加载资源时重置，不持久化，也不影响订阅匹配规则或服务端结果上限。
「搜索」先查询 Bangumi，返回最多 8 个番剧候选，不要求配置 RSS。所有平台默认使用 https://search.115415.xyz 公共服务，无需令牌或额外凭据文件；用户展开条目才由 NAS 后端发送 Bangumi ID 到独立服务，结果显示在该条目下面。服务器会收到请求者 IP 和条目 ID，公共服务受限流与上游可用性约束。设置 AGGREGATE_SEARCH_URL 为空可禁用；改用自建私有地址时仍需配置至少 32 字符的 AGGREGATE_SEARCH_TOKEN。Windows 未设置令牌变量时继续兼容程序同级 secrets/aggregate-token.dpapi，文件缺失或无法解密时回退到默认公共访问；已有凭据不会发送到其他地址，也不随安装包或 JSON 备份分发。显式空令牌不再禁用默认公共服务，应使用空地址禁用。启动变量更改后需重建容器或重启程序，不会写入数据库。自动元数据开关 BANGUMI_ENABLED 不禁用此用户主动搜索。
在线端使用 Jackett 聚合明确启用的来源，按 InfoHash 去重、保留来源；不把名称匹配当作已验证的季度或资源归属，所有结果需人工核对。可复制磁力、打开来源页，或确认「订阅此版本」后持续追更；搜索本身不自动创建订阅或下载。NAS 请求沿用 PROXY_URL，拒绝向非回环明文 HTTP 发送令牌，不跟随重定向；上游失败不回传包含密钥的原始错误。来源条款、鉴权、缓存、限流、隐私、独立 Compose 部署及服务端变量见在线聚合搜索服务。
下载模式
| 值 | 用途 |
|---|---|
native | 进程内纯 Go BT 引擎；容器镜像与 Windows 默认，无需 qBittorrent |
direct | HTTP(S) 文件，磁力和种子进入等待下载器状态 |
qbittorrent | 外部 qBittorrent WebUI API |
aria2 | 外部 Aria2 JSON-RPC |
transmission | 外部 Transmission RPC |
切换默认模式只影响后续提交，已有任务按原下载器身份跟踪。旧版「内置 qBittorrent」（builtin）已移除：设置接口不再接受该值，环境变量 DOWNLOAD_MODE=builtin 或数据库里的遗留值在配置合并后只在本进程回退为 native，不改写已存配置，数据库中的有效模式仍优先于环境变量；原 builtin 下载器目录（数据库同级 qbittorrent/）不再使用，启动恢复会把旧的 builtin 活跃/暂停任务标记为失败（提示重新提交、保留源文件），用户可改用当前下载方式重新提交。
内置 BT 下载器（默认）
| 变量 | 默认值 | 说明 |
|---|---|---|
NATIVE_BT_DATA_DIR | 数据库同级 bt | 会话库 session.db 与源文件根目录 |
NATIVE_BT_PORT | 6881 | BT 监听起始端口（TCP） |
NATIVE_BT_PORT_RANGE | 10 | 监听端口数量，1–100；限制同时驻留的 BT 任务数，不限制累计任务数 |
NATIVE_DHT_PORT | 同 NATIVE_BT_PORT | DHT UDP 端口 |
Windows 未设置 DOWNLOAD_MODE 时默认 native，容器镜像用 DOWNLOAD_MODE=native 显式指定，源码运行仍是 direct。BT 流量直连，不套用 PROXY_URL；种子文件名会在开始写文件前校验，拒绝 ..、反斜杠、盘符和 Windows 保留名。新任务源文件在数据目录的 bt/downloads/<infohash-条目ID>/（Windows 为 data\bt\downloads\，容器为 /data/bt/downloads/），相同种子的不同条目独立下载和控制；旧 <infohash> 目录继续兼容，不自动搬迁。归档后默认保留做种，关闭 KEEP_SOURCE_FILES 后释放会话状态，再按安全条件清理源文件，避免旧完成状态误用到重新创建的文件。
暂停保留任务身份与续传信息；取消/移除记录会释放会话和端口，但不删除源文件。端口不足时，已暂停任务和已归档的做种任务可卸载到 session.db，源文件不变；活动下载不会被挤出，超出容量的新任务等待端口。暂停任务继续时从会话恢复，不必重新访问种子 URL。被卸载的历史做种不会在本轮运行中自动抢回端口，下次启动会在容量允许时恢复。旧版若多个条目共用同一任务，独立暂停/继续会被拒绝并提示移除重复记录（保留媒体）；存在已暂停共用条目时，后台轮询也不会自动重启该任务。
分片选择保留稀有分片优先、慢连接补偿与尾段重复请求限制，使用单次扫描代替每次全量排序，减少 CPU 与临时内存开销；相同优先级分片的选择顺序可能变化。不新增性能开关，不改变并发、端口、缓存或存储目录默认值，也不迁移既有数据；外部下载器与直链不受此优化影响。分片调度基准不代表公网下载速度，缺少做种者或受带宽、磁盘限制时不保证提速。
外部下载器
| 下载器 | 地址与认证 | 下载器路径 → 本服务可读路径 |
|---|---|---|
| qBittorrent | QBIT_URL、QBIT_USER、QBIT_PASSWORD | QBIT_SAVE_PATH → QBIT_LOCAL_DIR |
| Aria2 | ARIA2_URL、可选 ARIA2_TOKEN | ARIA2_DIR → ARIA2_LOCAL_DIR |
| Transmission | TRANSMISSION_URL、TRANSMISSION_USER、TRANSMISSION_PASSWORD | TRANSMISSION_DOWNLOAD_DIR → TRANSMISSION_LOCAL_DIR |
地址与认证默认空。在网页填写或通过环境配置。地址必须能从服务所在容器访问；容器的 127.0.0.1 不是另一个容器或 NAS。
两个容器必须挂载同一批文件，同名路径不足以证明映射正确。例如 NAS /volume1/downloads 在下载器中挂到 /downloads，在 Auto-Anime 中挂到 /source-downloads：
# 添加到 Auto-Anime 原有 volumes 中
volumes:
- ./docker-data:/data
- /volume1/downloads:/source-downloads
# 添加到 environment 中
# QBIT_SAVE_PATH: /downloads
# QBIT_LOCAL_DIR: /source-downloads归档媒体库与源目录映射是两回事。映射错误会使下载完成后无法归档；修正后再核对任务与文件。外部下载器的会话和源文件由用户另行持久化、备份。
存储位置与目录映射
实际归档优先使用番剧记录中的存储位置；没有指定时使用 <LIBRARY_DIR>/<规范番名>，媒体库留空则使用 <DOWNLOAD_DIR>/<规范番名>。
订阅保存位置填根目录，保存时转换成该番剧文件夹并写入番剧记录；番剧存储位置填完整番剧文件夹。同一番剧共用位置，因此不是“订阅路径始终优先于手动番剧设置”的两套独立层级。保存订阅且位置变化时可更新番剧位置；同步只填空，不覆盖现有设置。清空订阅位置只回收仍与该订阅旧落点相同的值，不清除其他手动位置。
所有标题路径经过安全规范化，不能用番名逃出所选目录。识别单集使用 Season XX 子目录；无明确单集编号保留原名或合集布局。改变默认根目录、订阅路径或番名不自动迁移旧媒体。
Docker 内填写容器路径，NAS 文件夹必须先映射。例如 /volume1/media/anime:/media 后网页填 /media。保存目录时会检查 overlay 容器挂载表，未映射则提示；读不到挂载表、Windows 或非 overlay 环境不能当作已经完成 NAS 挂载确认。挂载提示不替代写权限、剩余空间或实机下载检查。
首次向导仅检测部署根目录；登录后的设置页可检测填写的目录。检测创建、写入、同步并删除临时文件，不创建缺失目录，不添加挂载，也不移动媒体。
做种与源文件清理
新归档且保留源文件的任务会持久化登记自动清理：媒体成功归档后继续做种，达到结束条件才移除下载器任务，绝不删除源文件或归档文件，无需新增配置。内置 BT 以累计上传量达到完整资源大小（分享率 1）为结束条件；Aria2 等待 complete（做种已结束）；qBittorrent 等待上传停止且达到其分享率或做种时间限制（继承全局限制时读取全局策略）；Transmission 等待完整下载、停止且 isFinished=true。无限做种或无法确认结束条件时保留任务。
自动清理仅操作本服务本轮版本归档登记的单个任务；旧归档任务不批量追删。请求失败自动重试，任务身份、连接/路径映射发生变化、任务被其他条目共用或归档文件不可访问时不操作。删除记录后源文件仍占空间，需要时由用户另行清理。内置任务因端口压力被卸载时保留待处理登记，端口空闲后恢复做种，不把卸载视为做种完成。
每轮先查询活动下载，再处理历史做种清理；清理网络请求共用 2 秒预算，并复用本轮登录会话。同一下载器出错后跳过本轮剩余清理，登记保留并轮换检查顺序，避免慢任务长期挡住后续任务。
KEEP_SOURCE_FILES=true 默认保留下载器源文件，再复制归档，请预留两份空间。设为 false 后，只在媒体归档及数据库提交成功后停止对应任务并清理本次普通源文件，不批量清理已有条目。直链没有独立做种副本，不受该开关影响。
清理队列持久化并重试；重新开启取消尚未处理的清理，不恢复已删文件。支持内置/外部 qBittorrent、Aria2、Transmission；外部模式需明确源目录映射。超出映射、与归档重叠、文件被替换、任务共用或连接发生变化时保护源文件。不会递归删除目录或控制文件，任务记录可能保留。关闭做种仍需满足归档时的空间需求。
网络与元数据
默认不读取系统代理，显式直连。PROXY_URL 支持 http、https、socks5、socks5h。
- 统一代理用于 RSS、HTTP(S) 文件/种子、HTTP tracker、Bangumi、Webhook 和更新；更新可用专用代理覆盖。
- 下载器 RPC / WebUI 与 UDP tracker 始终直连；BT 流量由下载器自己的设置决定。
- 代理凭据展示脱敏，保存未变地址保留凭据，更换地址不沿用旧凭据，清空恢复直连。
- 元数据不可达不阻塞基础下载；封面本地缓存，手动绑定与纠正优先于自动匹配。
资源可用性探测只看 tracker，未实现 DHT 探测，不保证资源一定可下载。管理页面的脚本、样式、图标不从公共 CDN 加载。
Windows 与飞牛桌面的圆角矩形应用图标随各自程序/FPK 提供，无需配置；不改变默认目录或网页横版 Logo。更换飞牛图标需要升级 FPK，而不是只更新容器镜像；Windows 需要完全退出旧程序再启动新版本，任务栏固定项可能需要重新固定以刷新缓存。
网页专有设置与接口兼容
番剧库默认显示信息卡片、按最近收录排序，可切换海报墙；星期筛选与工具栏采用紧凑布局，手机端自动换行。星期选中背景平滑滑动，遵循系统「减少动态效果」设置；无需新增配置，不改变存储目录或已有接口。
| 设置 | 规则 |
|---|---|
| 最大同时下载数 | 默认 2，1–32，在最近条目的下载控制中修改 |
| 自动清理空番 | 默认关闭，按页面提示使用，不等同删除媒体 |
| 管理员账户 | 修改用户名需同时设新密码；改密撤销会话 |
| 每周更新日 | 0 自动，1–7 手动；自动读取放送星期，缺失时用每日放送表，已获取缓存 7 天、未获取次日重试；播放结束早于今天归入已完结。Bangumi 收藏在每次同步后由后台逐个补全，已完结条目缓存 30 天 |
| 订阅季数条件 | season_filter=0 不限、-1 仅未标明、1–999 指定季；allow_unknown_season=false 默认 |
订阅季数条件与归档季号独立，旧库自动迁移为不限，旧备份缺字段按默认恢复。使用流程见使用指南，不需要新增环境变量。
订阅弹窗的「筛选规则」默认收起，摘要显示当前季数与是否设置关键词；季数选择「不限季数」「仅季数未标明」或「指定季数」（1–999）。「来源与保存位置」同样默认收起，保存位置留空仍使用媒体库目录（未设置时使用下载目录），归档结构仍为 <根目录>/<番剧名>/Season XX/…。仅调整表单展示，不改变接口、已有订阅或自动下载默认值。
包含和排除关键词统一英文大小写、简繁文字与全角英数字（ＡＩ / AI、１０８０ｐ / 1080p），不改写已存规则或原始资源标题；包含词须全部命中，排除词任一命中即排除。全角折叠也适用于已有规则，原先仅因英数字宽度不同而未命中的词现在会命中；不折叠标点或推断别名。
旧的 RSS 搜索模式、搜索模板设置及 /api/discover/sources、/api/discover/search 接口已移除。数据库中遗留的 discover_search_template 不再读取或使用；不删除已有 RSS 订阅、历史条目或媒体，既有 RSS 的分页兼容保留。可从搜索结果「订阅此版本」通过在线服务持续追更，也可在「订阅管理」手动添加实际 RSS；请自行确认来源条款与内容授权。
聚合订阅沿用现有订阅、定时同步、暂停、下载和 JSON 备份接口，不新增环境变量或数据库字段。feeds.url 保存不含凭据的 aggregate://subject/<Bangumi ID>?group=...&language=...&quality=...&season=...&title=... 选择规则；只向管理员配置的聚合服务发送条目 ID，不按该地址访问任意主机。番名、字幕组、清晰度和识别出的字幕语言采用简繁/宽度/大小写规范化后的精确比较，未识别出的字段只匹配同样未识别的资源；标题季号严格匹配，未标明只接收未标明版本。普通关键词与季数条件可进一步收窄，不能扩大原选定版本。默认自动下载开启，保存前可关闭；默认集数偏移为 0，保留原始集号，不以不完整搜索结果推断起始集。重复选择同一版本打开已有订阅。JSON 备份包含规则但不包含聚合令牌，恢复目标需单独配置服务；含聚合订阅的备份需用支持此功能的版本恢复。
聚合服务每站每个名称查询最多读取 100 条，合并最多返回 300 条。仅达到这些条数上限时，订阅同步已返回且符合版本规则的资源并正常更新同步时间、清除旧错误；搜索与订阅预览仍提示结果可能不完整，不据此推断集数偏移。部分来源查询失败、网络错误或其他未知警告仍报告同步失败，已成功读取的匹配资源保留。此处理兼容现有在线 API，无需同步升级在线服务；不放大读取预算，不承诺补齐早期资源。
Bangumi 收藏同步
收藏同步同时更新 Bangumi 社区评分，封面显示一位小数；该分数不是账号的个人打分，未评分不显示数字。展开已绑定或云端收藏的详情时，按需从公共条目接口读取简介、放送日期、正篇集数、评分人数及排名，不创建本地番剧或改写绑定。资料请求沿用 BANGUMI_API 和统一代理，单次超时 15 秒、响应上限 2 MB、此详情接口最多 4 个并发请求；每次打开重新获取，浏览器不缓存，资源状态轮询不重复请求 Bangumi 详情。关闭或切换详情会取消旧资料请求；资料失败可单独重试，不阻塞本地资源查询和下载。旧收藏缓存的评分会在下次成功同步后补齐，也可在设置中手动同步。
默认未连接。在「设置 → 网络与同步」填写从 Bangumi 获取的个人 Access Token，验证成功后立即同步动画的「想看、在看、看过、搁置、抛弃」五种收藏状态与封面，之后启动时及每 30 分钟同步一次，也可在该设置页手动同步。收藏直接并入番剧库的卡片和海报墙，参与名称搜索、排序和资源范围筛选；收藏状态筛选提供五种状态、「全部收藏状态」和「未关联收藏」。已绑定同一 Bangumi 条目的本地番剧不重复显示，只增加收藏状态标签，保留本地资源和管理操作。点击番剧先展开详情，展示收藏状态、已保存资源和下载状态，再由用户选择播放、下载已有资源，或点击「找资源并选择下载」搜索。仅检查应用内关联的番剧及资源记录，不扫描磁盘上的其他文件；查询失败时提示重试，不将失败视为没有本地资源。仅云端收藏的条目不提供本地番剧的编辑、批量合并或删除操作；未获取放送星期时归入「待补充」。列表仅保存最近一次成功结果；分页或网络失败时保留旧列表并提示。支持代理，使用 BANGUMI_API 配置的 API 地址。旧版想看缓存暂按「想看」显示，缺封面时显示占位图，下次成功同步后更新状态和封面。
同步为单向只读：以 Bangumi 为收藏状态来源，不回写远端收藏，不同步逐集观看进度，不自动订阅、停订或下载。远端状态变化在下次成功同步后更新；移除收藏只移除云端条目或本地番剧上的收藏标签，不删除本地番剧、订阅或媒体。「找资源」进入「搜索」查询 Bangumi 条目，展开后的候选资源依赖管理员配置的在线聚合服务，不自动创建订阅。解除连接会清除本地令牌和收藏缓存，不删除订阅或媒体。令牌保存在数据库中，不进入设置接口或 JSON 备份；数据库备份包含令牌，需妥善保护。列表上限为 10000 条，超出时保留旧列表并报告失败。
搜索读取有预算，不保证完整历史：普通 RSS 最多 20 页、1000 条，是否有历史页取决于来源提供的分页信息；保留已知 RSS 格式的分页兼容，但不作为内置搜索源。季数扩展共享 60 秒、20 页、1000 条与 32 MiB，单页最多 8 MiB；原词最多 1 页，季标记变体各最多 3 页、各限时 12 秒，余量用于番名搜索。失败和达到上限时保留成功结果并提示不完整。
GET /api/items 默认仍返回最多 100 条数组；page=1 返回 {items,next_before}，下一页传 before，0 表示结束；q、status、group 用于服务端筛选。手动同步使用 POST /api/sync/<订阅ID>。
脚本可使用管理员 HTTP Basic Auth。登录与 Basic Auth 共用失败限流：连续 5 次失败锁定 15 分钟，429 表示限流；同一反向代理后可能共享额度。健康接口 /api/health 公开但不返回私人配置。新密码使用 bcrypt，旧哈希登录后升级；旧程序不支持新哈希，回退前恢复相应数据库备份。
Webhook 事件为 new_item、download_submitted、download_saved、download_failed，不等于多渠道通知中心或可靠事件队列。
更新源
默认源是项目 GitHub Release；发布工作流将默认仓库注入程序，fork 自行发布使用自己的仓库。本地可用 UPDATE_SOURCE 覆盖。发布程序启动后检查，之后每 6 小时复查；检查不可达不阻塞下载。
自建更新源：把
UPDATE_SOURCE设为前缀（例如https://dl.example.com/auto-anime），服务读取<前缀>/latest.json：json{ "version": "1.2.0", "notes": "更新说明", "published_at": "2026-01-01T00:00:00Z", "html_url": "https://example.com/releases/1.2.0", "assets": { "linux-amd64": "https://dl.example.com/auto-anime/auto-anime-1.2.0-linux-amd64", "linux-arm64": "https://dl.example.com/auto-anime/auto-anime-1.2.0-linux-arm64", "sha256": "更新包的 SHA-256 十六进制值" } }也可以把
sha256写成<更新包地址>.sha256，内容按sha256sum的「哈希 文件名」格式。校验：优先使用更新源提供的 SHA-256；GitHub 源缺少校验文件时只接受直接来自配置仓库地址的下载，自建更新源没有校验值会拒绝更新。
如果更新源已声明校验文件，但文件请求失败、内容无效或不包含当前平台附件的校验值，会中止更新并允许重试，不降级为无校验安装。
版本说明纯文本展示，浏览器可忽略某版本。不同部署的更新与备份操作见维护指南。
兼容旧部署
旧内置 Aria2 已移除，EMBEDDED_ARIA2、EMBEDDED_ARIA2_PORT、ARIA2_PATH、ARIA2_BT_TRACKER 不再生效，外部 Aria2 继续支持。旧配置、分片与媒体保留；能确认属于旧私有实例且不能继续运行的未完成任务标记失败，手动重试提交到当前下载器，不迁移 GID 或旧分片。
旧 Windows 盘根数据、Docker 数据卷和已有存储位置不会自动搬迁。升级与回退前停止实例并备份，不要以重新初始化代替数据恢复。
Docker 部署的更新行为
此内容统一维护在维护与备份，包括非 root 飞牛运行副本、只读目录和 dev 构建限制。
集数偏移
新建 RSS 未指定 episode_offset（或传 null）时，首次成功同步按关键词及季数条件过滤后的最小数字集数计算 1 - 最小集数，并持久化固定值。例如：[00] → +1，[12] → -11，[01] → 0。预览接口返回同样的 episode_offset；弹窗预览自动带入结果，保存时可改成整数（-9999～9999），0 表示不调整。编辑仅影响后续新增条目，不改原始标题、不修改已有条目或搬动归档文件。
计算使用当前来源实际读到的列表，不依赖 Bangumi；滚动 RSS 可能不含首集，需核对预览并手动填 0 或正确偏移。空列表等待后续同步；读取中断时不推断、不写入条目。混合番剧或不同季无法统一推断时固定为 0，不做跨番剧/跨季编号。合集及无法解析的特殊集数保持原样。OPML 新导入订阅也在首次同步推断。
合集和特别篇不参与最小数字集数计算，但其可识别番名、季号仍参与一致性校验；不能因忽略非数字集数而给混合 RSS 套用单一偏移。
升级已有订阅的偏移保持 0，不因缺少早期 RSS 重新编号。JSON v4 备份保存偏移（null 表示等待首次推断）；恢复 v1～v3 旧备份按 0 兼容，备份不恢复历史条目、任务或媒体。
集齐自动停订
默认自动检查，无需新增环境变量。启用 Bangumi 元数据时，后台获取 eps（Wiki 正篇话数，不用包含特别篇的 total_episodes 章节记录数）；资料与分季查询缓存 7 天。订阅当前规则对应唯一番剧、唯一归档季号，且该季第 1～N 集均为「已保存」、归档文件存在且非空时，设置 enabled=false，显示「已集齐」及停订原因。同番同季其他订阅已归档的集数也可补齐，重复版本只算一集；已发送、下载中、合集目录和 SP 不充当正篇集数。
不同季按番名与明确季号单独查询 Bangumi，不替换番剧库现有封面或手动绑定；同季优先使用已绑定条目的总数。元数据失败、总数为 0、季号不符或匹配歧义时保持订阅启用，不阻塞 RSS 与下载。若 Bangumi 使用副标题而无可识别季标记，可在番剧库手动绑定对应条目并核对归档季号；无法确认时不承诺自动停订。
纠正番剧搜索词后，旧自动匹配的总集数立即失效，按新搜索词重新获取；手动绑定的 Bangumi 条目仍优先。旧版无匹配键且存在自定义搜索词的资料也按不确定处理，不据此停订。
集齐检查在下载器轮询、归档完成后及 RSS 同步前运行，重启后仍会补查；不会删除任何任务或文件，也不取消已经排队的资源。已集齐订阅的「立即同步」不会重新获取；可手动启用，但集齐条件仍成立时下次检查会再次停订。要补缺集，应先核对/纠正条目的番剧、季集或失效文件。JSON 备份保留禁用状态，不保存停订原因与元数据缓存，恢复后重新查询；不恢复历史下载或媒体。
维护者发布流程
见维护者发布说明，包含版本标签、匿名镜像验证与 FPK 分发条件。自 v0.0.2 起正式 FPK 自带同版本 x86-64 镜像，安装无需访问 GHCR，仍需预装飞牛 Docker；Compose 和手工在线包仍需拉取镜像。
本页同步自仓库 docs/CONFIGURATION.md