工具与高级

元数据、下载器和一次性维护工具。

元数据

刮削配置里打开 保存元数据 后，结果会出现在 元数据 页，可搜索、编辑、删除。

导入

• JSON：在元数据页粘贴或上传，支持单个对象或数组
• NFO 文件夹：在 工具 里指定目录，选择「忽略已有」或「强制更新」

字段

必填：number（番号）、actor（演员）、title（片名）、cover（封面）。

手动上传封面只会更新关联图片，不会改原始 cover 字段值。

Transmission

在 服务设置 填写 RPC 地址、用户名、密码，并配置路径映射：

• 路径映射源 — Transmission 里的下载路径（容器内路径）
• 路径映射目标 — Bonita / 宿主机看到的同一位置

启用后，删除或清理记录时如果源文件被删，会尝试删除匹配的 torrent。

工具页

工具	用途
导入元数据	从含 NFO 的文件夹导入
同步 Emby 观看历史	见 媒体服务
同步转移记录路径	任务改源路径后，批量替换历史记录前缀，并更新 ExtraInfo
清理文件与记录	清掉实际文件已不存在的记录，以及已删除超过 7 天的关联种子；「立即删除」会马上删，而不是等宽限期

代理

服务设置 → 代理 作用于刮削等出站请求。HTTP / HTTPS 代理地址分别填写，打开启用后保存。

计划中的能力

推送通知（Telegram、微信等）和 AI 推荐仍在规划，界面里尚未提供。

注意事项

• 改配置前建议备份 /app/backend/data（至少 db.sqlite3）
• FIRST_SUPERUSER_* 只在首次建库生效
• YAML 配置优先于环境变量；两边都写时以 config.yaml 为准