ReadMeABook文件组织指南:自定义路径模板与Seeding策略深度配置

原创2026-10-16 16:45:161,420 阅读

ReadMeABook文件组织指南:自定义路径模板与Seeding策略深度配置

ReadMeABook 是一款功能完整的有声书(Audiobook)自动请求与下载引擎,专为 Plex 与 Audiobookshelf 用户打造。它会自动完成"请求书籍 → 搜索索引器 → 下载种子 → 文件组织 → 媒体库导入"的全流程。本指南面向新手,带你快速掌握两大核心配置:自定义路径模板(决定有声书在媒体库中的目录结构)与 Seeding 策略(控制种子保留时长与自动清理规则),让你的有声书库既整洁又符合分享礼仪。

一、为什么需要配置文件组织路径?

当你请求一本有声书后,ReadMeABook 不会把文件扔进一个杂乱的下载目录。下载完成后,它会自动执行一套标准整理流程:

  1. 从下载目录复制(不是移动)文件到媒体目录,原文件保留用于 Seeding
  2. 写入元数据标签(标题、作者、朗读者、ASIN),大幅提升 Plex 匹配准确率
  3. 格式转换:把 .mp4 等 Plex 不识别的扩展名改名为 .m4b
  4. 触发媒体库扫描,新书立即出现在你的 Plex / Audiobookshelf 中

ReadMeABook有声书媒体库首页:文件组织后的书籍封面网格展示

💡 上图就是文件组织生效后的效果——每本书都被归入统一目录结构,媒体库扫描后整齐上架。

这套流程的详细设计可参考官方文档 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 配置步骤与实时预览

  1. 登录管理后台,进入 Settings → Paths 标签页
  2. 在 "Audiobook Organization Template" 输入框填写模板(有专用电子书模板可点 "Match Audiobook" 一键同步)
  3. 下方实时预览区会立即用 3 本示例书展示效果,非法字符(<>:"/\|?*)会即时报错
  4. 打开 "Rename files during organization" 可再套一层文件命名模板(如 {title}),多文件章节 MP3 会自动追加 - 1、- 2 序号
  5. 点击底部 Test Paths 按钮验证下载目录与媒体目录可读写

模板引擎的变量替换、校验与预览逻辑集中在 path-template.util.ts,UI 实现在 PathsTab.tsx 中。

ReadMeABook管理后台仪表盘:查看活跃下载与请求状态以管理Seeding清理

📌 在管理后台首页,你还能通过 "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:

  1. 找出所有状态为 available(已入媒体库)的完成请求
  2. 向下载客户端(qBittorrent 等)查询该种子的实际 seeding_time 与 ratio
  3. 两项门槛都达标后,才删除种子和原始文件——媒体库中的副本早已复制好,不受影响
  4. 未达标则跳过,下个周期继续检查

3.3 共享 Torrent 保护机制 ⚠️

一个容易踩坑的场景:你删除某本书后又重新请求了它。此时两条请求记录指向同一个种子哈希(同一份文件)。清理任务在删除前会先检查:

是否还有其他活跃的请求正在使用这个种子?如果有 → 只删除旧的数据库记录,保留种子文件,避免把正在合并章节的原始文件删掉。

这个安全检查让 Seeding 策略可以放心大胆地配置,不用担心误删。

ReadMeABook的BookDate AI推荐界面:右滑即可请求有声书进入下载流程

🔥 小提示:上图的 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 概念,清理任务会自动跳过

五、相关文档与源码速查

掌握路径模板与 Seeding 策略后,ReadMeABook 就能在"自动囤书"和"硬盘容量"之间找到完美平衡,让每本有声书都物归原位。

登录后查看全文
ReadMeABook