主要功能
Bonita 围绕「整理片库」和「同步媒体服务」这两件事工作。下面按实际界面说明各功能。
整理与入库
转移任务
在 任务配置 里为每个片库建一条任务：指定源文件夹、输出文件夹、内容类型（电影 / 剧集）和操作方式。
- 硬链接（推荐）— 不占双倍空间，源文件和输出指向同一份数据
- 软链接 / 移动 / 复制 — 按磁盘和目录布局选择
任务可以只处理某个子目录，也可以整库执行。开启 自动监视 后，源目录里出现新视频会自动跑这条任务；完整任务结束时还会触发 Emby 媒体库扫描。
转移记录
记录 页面列出每次转移的源路径、目标路径、状态和番号。可以：
- 忽略某条（下次不再转移）
- 指定剧集季/集、顶层文件夹
- 为刮削指定番号、来源、URL、是否裁剪海报、部次和标签
- 删除记录（默认删转移后的文件；勾选强制删除会连源文件一起删）
刮削与元数据
刮削由任务触发，使用 scrapinglib 支持的站点。
- 自定义命名规则、目录规则、水印、额外剧照
- 勾选 保存元数据 后，结果会出现在 元数据 页面，下次刮削可直接复用
- 支持手动编辑、从 JSON 导入、从带 NFO 的文件夹导入
- 必填字段：番号、演员、标题、封面。上传封面只会更新关联图片，不会改掉原始
cover字段
观影记录与媒体项
媒体项 展示从 Emby 同步过来（以及本地创建）的电影、剧集、视频。可以按类型、观看状态、收藏、是否有番号筛选，也可以手动增改。
同步规则简述：
- 默认从 Emby 拉到 Bonita 时，已看 / 收藏只会「补上」，不会把 Bonita 里已有的状态抹掉
- 需要覆盖时，在工具里勾选 强制更新
- 回写 Emby 时，默认把 Bonita 的已看 / 收藏推过去（电影、剧集、番号视频）
更完整的流程见 媒体服务。
Emby 集成
在 服务设置 填入 Emby 地址、用户名和 API Key，即可：
- Webhook — 播放完成、标记已看/未看、收藏、新媒体入库时实时同步
- 定时全量同步 — 默认约 15 分钟跑一次，防止漏事件
- 手动同步 — 在 工具 里选择方向后立即执行
- 合集 — 以 Bonita 为准维护成员，再回写 Emby
- 媒体库扫描 — 转移任务开启自动监视并跑完后，会请求 Emby 刷新片库
Jellyfin 在设置页有连接项，观看记录与合集同步目前以 Emby 为主。
合集
合集 页从 Emby 搜索并加入要同步的合集。之后：
- 从服务器拉取：只新增成员，不会在 Bonita 里删掉已有项
- 在 Bonita 里增删成员
- 回写服务器：把当前成员列表推到 Emby
本地媒体项不会因为移出合集而被删除。
工具与下载器
工具 页面提供：
- 从 NFO 文件夹导入元数据
- 同步 Emby 观看历史
- 批量替换转移记录的路径前缀（改源目录后用）
- 清理已经不存在的文件对应的记录，以及超过 7 天的关联种子
关联 Transmission 后，删除/清理记录时如果源文件被删，会尝试删掉匹配的 torrent。需要配置路径映射：Transmission 容器内路径 → Bonita 看到的路径。