ReadMeABook文件组织指南:自定义路径模板与Seeding策略深度配置
ReadMeABook文件组织指南:自定义路径模板与Seeding策略深度配置
ReadMeABook 是一款功能完整的有声书(Audiobook)自动请求与下载引擎,专为 Plex 与 Audiobookshelf 用户打造。它会自动完成"请求书籍 → 搜索索引器 → 下载种子 → 文件组织 → 媒体库导入"的全流程。本指南面向新手,带你快速掌握两大核心配置:自定义路径模板(决定有声书在媒体库中的目录结构)与 Seeding 策略(控制种子保留时长与自动清理规则),让你的有声书库既整洁又符合分享礼仪。
一、为什么需要配置文件组织路径?
当你请求一本有声书后,ReadMeABook 不会把文件扔进一个杂乱的下载目录。下载完成后,它会自动执行一套标准整理流程:
- 从下载目录复制(不是移动)文件到媒体目录,原文件保留用于 Seeding
- 写入元数据标签(标题、作者、朗读者、ASIN),大幅提升 Plex 匹配准确率
- 格式转换:把
.mp4等 Plex 不识别的扩展名改名为.m4b - 触发媒体库扫描,新书立即出现在你的 Plex / Audiobookshelf 中
💡 上图就是文件组织生效后的效果——每本书都被归入统一目录结构,媒体库扫描后整齐上架。
这套流程的详细设计可参考官方文档 file-organization.md,核心实现在 organize-files.processor.ts 中。
二、自定义路径模板:7 个变量让目录随心布局
2.1 可用变量速查表
路径模板存放在管理后台的 Paths 设置页(配置项 audiobook_path_template,默认值为 {author}/{title} {asin})。你可以自由组合以下 7 个变量:
| 变量 | 含义 | 示例输出 |
|---|---|---|
{author} |
书籍作者 | Douglas Adams |
{title} |
书名 | The Hitchhiker's Guide to the Galaxy |
{narrator} |
朗读者 | Stephen Fry |
{year} |
出版年份 | 2005 |
{asin} |
Audible ASIN 编号 | B0009JKV9W |
{series} |
所属系列名 | The Mistborn Saga |
{seriesPart} |
系列中第几部 | 1 |
缺少值的可选变量(如没有朗读者信息)会被自动省略,不会留下空文件夹。
2.2 三种常用模板示例
| 模板 | 实际生成路径 |
|---|---|
{author}/{title} {asin} |
Douglas Adams/The Hitchhiker's Guide to the Galaxy B0009JKV9W/ |
{author}/{title} ({year}) |
Douglas Adams/The Hitchhiker's Guide to the Galaxy (2005)/ |
{series} {seriesPart} - {title}(推荐系列党) |
The Mistborn Saga 1 - Mistborn The Final Empire/ |
2.3 条件语法:让路径更聪明
模板支持"条件块"写法——用花括号把变量和文字包起来,只有变量有值时才会显示这段文字:
{Book seriesPart - }{author}/{title}
- 有系列信息 →
Book 1 - Brandon Sanderson/Mistborn The Final Empire - 无系列信息 →
Brandon Sanderson/Mistborn The Final Empire(整块被移除)
2.4 配置步骤与实时预览
- 登录管理后台,进入 Settings → Paths 标签页
- 在 "Audiobook Organization Template" 输入框填写模板(有专用电子书模板可点 "Match Audiobook" 一键同步)
- 下方实时预览区会立即用 3 本示例书展示效果,非法字符(
<>:"/\|?*)会即时报错 - 打开 "Rename files during organization" 可再套一层文件命名模板(如
{title}),多文件章节 MP3 会自动追加- 1、- 2序号 - 点击底部 Test Paths 按钮验证下载目录与媒体目录可读写
模板引擎的变量替换、校验与预览逻辑集中在 path-template.util.ts,UI 实现在 PathsTab.tsx 中。
📌 在管理后台首页,你还能通过 "Active Downloads" 面板观察下载进度,配合 "Scheduled Jobs" 页面查看种子清理任务的执行记录。
三、Seeding 策略深度配置:时间与种子率双重门槛
3.1 在哪里配置?
Seeding 规则按索引器(Indexer)单独设置,在 Settings → Prowlarr/Indexers 的索引器配置弹窗中,有两个关键输入项(见 IndexerConfigModalTorrentFields.tsx):
- Seeding Time (minutes):种子保留时长。填
0表示无限保留、永不自动清理 - Ratio Limit:上传/下载比值下限(如
2.0表示需完成 2 倍上传量)。0表示不要求
两条规则采用 AND 逻辑:都设置时必须同时满足;其中一条为 0 则只按另一条判断;两条都为 0 时文件将永久保留。
3.2 自动清理如何工作?
定时任务 cleanup_seeded_torrents 默认每 30 分钟运行一次,核心逻辑在 cleanup-seeded-torrents.processor.ts:
- 找出所有状态为
available(已入媒体库)的完成请求 - 向下载客户端(qBittorrent 等)查询该种子的实际 seeding_time 与 ratio
- 两项门槛都达标后,才删除种子和原始文件——媒体库中的副本早已复制好,不受影响
- 未达标则跳过,下个周期继续检查
3.3 共享 Torrent 保护机制 ⚠️
一个容易踩坑的场景:你删除某本书后又重新请求了它。此时两条请求记录指向同一个种子哈希(同一份文件)。清理任务在删除前会先检查:
是否还有其他活跃的请求正在使用这个种子?如果有 → 只删除旧的数据库记录,保留种子文件,避免把正在合并章节的原始文件删掉。
这个安全检查让 Seeding 策略可以放心大胆地配置,不用担心误删。
🔥 小提示:上图的 BookDate 是 RMAB 的 AI 推荐功能,右滑卡片即可发起请求,书籍随后走"下载 → 组织 → Seeding → 清理"的完整自动化链路。
四、新手最佳实践清单
| 场景 | 路径模板建议 | Seeding 建议 |
|---|---|---|
| 刚入门,求稳 | 默认 {author}/{title} {asin} |
全部填 0,先不自动清理 |
| Plex 用户 | {author}/{title} ({year}) |
开启元数据标签 + 格式转换(默认已开) |
| 系列收藏控 | {series} {seriesPart} - {title} |
私有索引器:Ratio 2.0 + 时长 4320 分钟(3天) |
| 想省硬盘空间 | 任意模板 | 私有源设低门槛(如 6 小时),公开源设 Ratio 要求 |
注意事项:
- 路径模板只作用于新下载的文件,不会重命名已有的媒体库文件
- 模板必须是相对路径,使用正斜杠
/,不支持绝对路径 - Usenet(NZB)下载没有 Seeding 概念,清理任务会自动跳过
五、相关文档与源码速查
- 文件组织系统设计:file-organization.md
- 路径模板引擎说明:PATH_TEMPLATE_README.md
- 定时任务与清理策略:scheduler.md
- 下载客户端配置:download-clients.md
- 设置页完整说明:settings-pages.md
- 文件组织入口:organize-files.processor.ts
- 清理任务实现:cleanup-seeded-torrents.processor.ts
掌握路径模板与 Seeding 策略后,ReadMeABook 就能在"自动囤书"和"硬盘容量"之间找到完美平衡,让每本有声书都物归原位。


