【免费下载链接】ReadMeABookFully Featured audiobook request and downloading engine to bring audiobooks up to speed with the modern automation standards项目地址https://gitcode.com/gh_mirrors/re/ReadMeABook点击查看免费下载ReadMeABook 是一款全自动有声书请求与下载引擎而它的E-book Sidecar电子书旁挂功能更进一步每当一本有声书下载入库系统会顺手从 Shadow LibraryAnnas Archive或 Prowlarr Indexer 搜索并下载对应的 EPUB/PDF 电子书与有声书放在一起让你一次请求、两份收藏。本文将带你快速完成配置与理解其工作原理。什么是旁挂Sidecar 工作机制传统流程里下载一本有声书和找一本电子书是两件独立的事。ReadMeABook 的 Sidecar 机制把二者绑定为父子请求有声书请求是父请求电子书请求是子请求type: ebook拥有独立的进度、状态和错误处理有声书文件整理完成后系统自动创建电子书请求全程不阻塞有声书流程电子书下载成功后文件会被复制到有声书所在目录命名为[书名] - [作者].epub请求状态进入downloaded终态界面上电子书请求带有醒目的橙色徽标方便与有声书区分。两种电子书来源Shadow Library 与 Indexer 搜索Sidecar 支持两类来源按优先级依次尝试详见 ebook-sidecar.md1️⃣ Annas ArchiveShadow Library直连 HTTP优先用ASIN 精确搜索如asin:B09TWSRMCB找不到再退化为书名 作者标题搜索通过 MD5 详情页获取 Slow Download 直链由 direct-download.processor.ts 完成下载并跟踪进度该站点有 Cloudflare 防护可选配置FlareSolverr无头浏览器代理来绕过。2️⃣ Indexer Search通过 Prowlarr当 Annas Archive 未启用或无结果时系统通过 Prowlarr 搜索电子书分类默认7020 Books/EBook结果按电子书专用评分算法排序标题/作者匹配 60 分、格式匹配 10 分、体积质量 15 分、做种数 15 分超过 20 MB 的文件会被直接过滤复用有声书的 download-torrent.processor.ts经 qBittorrent种子或 SABnzbdUsenet下载且下载后保留做种尊重你的做种限制。快速配置三步开启 E-book Sidecar配置入口位于Admin → Settings → E-book Sidecar标签页EbookTab.tsx共三个区域第 1 步Annas Archive 区域配置项默认值说明ebook_annas_archive_enabledfalse启用 Shadow Library 直连下载ebook_sidecar_base_urlhttps://annas-archive.gl镜像地址可自行更换ebook_sidecar_flaresolverr_url空可选FlareSolverr 代理地址第 2 步Indexer Search 区域开启ebook_indexer_search_enabled开关即可各 Indexer 的电子书分类在Settings → Indexers → 编辑 Indexer → EBook 标签中按 Indexer 单独配置。第 3 步通用设置配置项默认值说明ebook_sidecar_preferred_formatepub首选格式EPUB / PDF / MOBI / AZW3 / Anyebook_auto_grab_enabledtrue有声书下载后自动创建电子书请求ebook_kindle_fix_enabledfalse对 EPUB 应用 Kindle 兼容性修复仅 EPUB 格式可见 提示未启用任何来源时自动抓取会自动关闭但管理端的手动 Fetch Ebook 按钮依然可用适合只按需取书的场景。FlareSolverr 快速部署可选用于绕过 Cloudflaredocker run -d --name flaresolverr -p 8191:8191 ghcr.io/flaresolverr/flaresolverr:latest然后在 Sidecar 设置中填入http://localhost:8191。首次请求约 5–10 秒之后每页 2–5 秒整本书约 15–30 秒。自动抓取与兜底机制错过的书会自动补上Sidecar 不只是下载时顺手抓一下还内置了多层保险自动创建有声书整理完成即生成电子书请求状态流转为pending → searching → downloading → processing → downloaded每日兜底任务find_missing_ebooks计划任务默认每日午夜会扫描最多 50 个downloaded/available状态的有声书对缺失电子书的自动补抓覆盖竞态条件、Indexer 短暂故障、Goodreads/Hardcover 同步导入等场景重试上限每本书最多自动重试 5 次计数器为Request.ebookAutoRetryCount超过后停止自动重试但仍可手动抓取手动入口在有声书详情弹窗中点击Fetch Ebook按钮或调用POST /api/audiobooks/[asin]/fetch-ebookfetch-ebook/route.ts即使该书是库外导入的孤儿有声书也支持。失败时请求进入awaiting_search等待重试且绝不影响有声书本身的入库——这是 Sidecar 设计上的非阻塞原则。Kindle 用户福利EPUB 兼容性自动修复如果你选择 EPUB 作为首选格式可以额外开启Kindle fix开关。它会在文件入库前epub-fixer.ts自动完成四项修复为缺失的文件补充 UTF-8 XML 声明移除导致 Kindle 超链接失效的#body/#bodymatter锚点片段校验dc:language语言代码不符合 Amazon KDP 规范时回退为en清除没有src属性的游离img标签。修复过程先写入临时文件再入库原始下载文件保持完整这对需要继续做种的种子文件很重要且即使修复失败也不会中断流程。常见限制与注意事项仅支持英文书Annas Archive 标题搜索使用英文过滤条件⚠️同名书风险标题搜索对常见书名可能匹配到错误的书建议优先走 ASIN 精确匹配️删除行为删除电子书请求只移除.epub/.pdf等电子书文件不会删除书名目录、有声书文件或后台库条目格式识别从种子标题判断格式可能不精确超过 20 MB 的结果会被视为非电子书过滤掉。延伸阅读Sidecar 完整技术文档设置页配置说明计划任务与调度器文件整理系统核心源码search-ebook.processor.ts、file-organizer.ts、RequestCard.tsx一句话总结开启 E-book Sidecar 后ReadMeABook 就能在你听有声书的同时自动把对应电子书旁挂进书库——读、听两份收藏一次请求全部搞定。赞分享【免费下载链接】ReadMeABookFully Featured audiobook request and downloading engine to bring audiobooks up to speed with the modern automation standards项目地址https://gitcode.com/gh_mirrors/re/ReadMeABook点击查看免费下载相关推荐Perlego电子书PDF下载器使用指南Perlego电子书PDF下载器使用指南 Perlego电子书PDF下载器是一款专为数字阅读爱好者设计的工具能够帮助用户从Perlego平台高效获取已购买的电Rectangle电子书完整指南PDF下载与阅读Rectangle电子书完整指南PDF下载与阅读 引言为什么macOS窗口管理需要Rectangle 你是否还在为macOS系统中窗口管理的低效而烦恼频桌面应用Perlego电子书PDF快速下载完整指南想要将Perlego平台上的电子书转换为PDF格式进行离线阅读吗Perlego PDF下载器正是你需要的工具本文将详细介绍这款开源工具的使用方法帮助你轻松创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 ReadMeABook电子书Sidecar：EPUB/PDF旁挂下载与Shadow Library集成指南
【免费下载链接】ReadMeABookFully Featured audiobook request and downloading engine to bring audiobooks up to speed with the modern automation standards项目地址https://gitcode.com/gh_mirrors/re/ReadMeABook点击查看免费下载ReadMeABook 是一款全自动有声书请求与下载引擎而它的E-book Sidecar电子书旁挂功能更进一步每当一本有声书下载入库系统会顺手从 Shadow LibraryAnnas Archive或 Prowlarr Indexer 搜索并下载对应的 EPUB/PDF 电子书与有声书放在一起让你一次请求、两份收藏。本文将带你快速完成配置与理解其工作原理。什么是旁挂Sidecar 工作机制传统流程里下载一本有声书和找一本电子书是两件独立的事。ReadMeABook 的 Sidecar 机制把二者绑定为父子请求有声书请求是父请求电子书请求是子请求type: ebook拥有独立的进度、状态和错误处理有声书文件整理完成后系统自动创建电子书请求全程不阻塞有声书流程电子书下载成功后文件会被复制到有声书所在目录命名为[书名] - [作者].epub请求状态进入downloaded终态界面上电子书请求带有醒目的橙色徽标方便与有声书区分。两种电子书来源Shadow Library 与 Indexer 搜索Sidecar 支持两类来源按优先级依次尝试详见 ebook-sidecar.md1️⃣ Annas ArchiveShadow Library直连 HTTP优先用ASIN 精确搜索如asin:B09TWSRMCB找不到再退化为书名 作者标题搜索通过 MD5 详情页获取 Slow Download 直链由 direct-download.processor.ts 完成下载并跟踪进度该站点有 Cloudflare 防护可选配置FlareSolverr无头浏览器代理来绕过。2️⃣ Indexer Search通过 Prowlarr当 Annas Archive 未启用或无结果时系统通过 Prowlarr 搜索电子书分类默认7020 Books/EBook结果按电子书专用评分算法排序标题/作者匹配 60 分、格式匹配 10 分、体积质量 15 分、做种数 15 分超过 20 MB 的文件会被直接过滤复用有声书的 download-torrent.processor.ts经 qBittorrent种子或 SABnzbdUsenet下载且下载后保留做种尊重你的做种限制。快速配置三步开启 E-book Sidecar配置入口位于Admin → Settings → E-book Sidecar标签页EbookTab.tsx共三个区域第 1 步Annas Archive 区域配置项默认值说明ebook_annas_archive_enabledfalse启用 Shadow Library 直连下载ebook_sidecar_base_urlhttps://annas-archive.gl镜像地址可自行更换ebook_sidecar_flaresolverr_url空可选FlareSolverr 代理地址第 2 步Indexer Search 区域开启ebook_indexer_search_enabled开关即可各 Indexer 的电子书分类在Settings → Indexers → 编辑 Indexer → EBook 标签中按 Indexer 单独配置。第 3 步通用设置配置项默认值说明ebook_sidecar_preferred_formatepub首选格式EPUB / PDF / MOBI / AZW3 / Anyebook_auto_grab_enabledtrue有声书下载后自动创建电子书请求ebook_kindle_fix_enabledfalse对 EPUB 应用 Kindle 兼容性修复仅 EPUB 格式可见 提示未启用任何来源时自动抓取会自动关闭但管理端的手动 Fetch Ebook 按钮依然可用适合只按需取书的场景。FlareSolverr 快速部署可选用于绕过 Cloudflaredocker run -d --name flaresolverr -p 8191:8191 ghcr.io/flaresolverr/flaresolverr:latest然后在 Sidecar 设置中填入http://localhost:8191。首次请求约 5–10 秒之后每页 2–5 秒整本书约 15–30 秒。自动抓取与兜底机制错过的书会自动补上Sidecar 不只是下载时顺手抓一下还内置了多层保险自动创建有声书整理完成即生成电子书请求状态流转为pending → searching → downloading → processing → downloaded每日兜底任务find_missing_ebooks计划任务默认每日午夜会扫描最多 50 个downloaded/available状态的有声书对缺失电子书的自动补抓覆盖竞态条件、Indexer 短暂故障、Goodreads/Hardcover 同步导入等场景重试上限每本书最多自动重试 5 次计数器为Request.ebookAutoRetryCount超过后停止自动重试但仍可手动抓取手动入口在有声书详情弹窗中点击Fetch Ebook按钮或调用POST /api/audiobooks/[asin]/fetch-ebookfetch-ebook/route.ts即使该书是库外导入的孤儿有声书也支持。失败时请求进入awaiting_search等待重试且绝不影响有声书本身的入库——这是 Sidecar 设计上的非阻塞原则。Kindle 用户福利EPUB 兼容性自动修复如果你选择 EPUB 作为首选格式可以额外开启Kindle fix开关。它会在文件入库前epub-fixer.ts自动完成四项修复为缺失的文件补充 UTF-8 XML 声明移除导致 Kindle 超链接失效的#body/#bodymatter锚点片段校验dc:language语言代码不符合 Amazon KDP 规范时回退为en清除没有src属性的游离img标签。修复过程先写入临时文件再入库原始下载文件保持完整这对需要继续做种的种子文件很重要且即使修复失败也不会中断流程。常见限制与注意事项仅支持英文书Annas Archive 标题搜索使用英文过滤条件⚠️同名书风险标题搜索对常见书名可能匹配到错误的书建议优先走 ASIN 精确匹配️删除行为删除电子书请求只移除.epub/.pdf等电子书文件不会删除书名目录、有声书文件或后台库条目格式识别从种子标题判断格式可能不精确超过 20 MB 的结果会被视为非电子书过滤掉。延伸阅读Sidecar 完整技术文档设置页配置说明计划任务与调度器文件整理系统核心源码search-ebook.processor.ts、file-organizer.ts、RequestCard.tsx一句话总结开启 E-book Sidecar 后ReadMeABook 就能在你听有声书的同时自动把对应电子书旁挂进书库——读、听两份收藏一次请求全部搞定。赞分享【免费下载链接】ReadMeABookFully Featured audiobook request and downloading engine to bring audiobooks up to speed with the modern automation standards项目地址https://gitcode.com/gh_mirrors/re/ReadMeABook点击查看免费下载相关推荐Perlego电子书PDF下载器使用指南Perlego电子书PDF下载器使用指南 Perlego电子书PDF下载器是一款专为数字阅读爱好者设计的工具能够帮助用户从Perlego平台高效获取已购买的电Rectangle电子书完整指南PDF下载与阅读Rectangle电子书完整指南PDF下载与阅读 引言为什么macOS窗口管理需要Rectangle 你是否还在为macOS系统中窗口管理的低效而烦恼频桌面应用Perlego电子书PDF快速下载完整指南想要将Perlego平台上的电子书转换为PDF格式进行离线阅读吗Perlego PDF下载器正是你需要的工具本文将详细介绍这款开源工具的使用方法帮助你轻松创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考