如何用番茄小说下载器Tomato-Novel-Downloader的 --update 自动追更本地书籍？非交互模式完整指南（Kindle自动更新场景）

如何用番茄小说下载器Tomato-Novel-Downloader的 --update 自动追更本地书籍非交互模式完整指南Kindle自动更新场景【免费下载链接】Tomato-Novel-Downloader番茄小说下载器不精简版项目地址: https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader番茄小说下载器 Tomato-Novel-Downloader 的--update参数是专为自动化场景设计的非交互模式只需一行命令就能让已下载过的本地书籍自动检查并补齐最新章节全程无需任何手动输入。这让它在Kindle 自动更新、定时任务批量追更等场景下非常实用。本文将带你快速掌握--update非交互模式的使用步骤、执行原理和定时任务配置方法。为什么需要 --update 非交互模式番茄小说下载器默认提供 TUI 图形界面和 Web UI适合手动下载新书。但如果你希望每天/每小时自动追更本地已有的连载小说例如自动推送到 Kindle 阅读交互式界面就成了障碍。--update模式专为解决这个问题而生✅零交互命令执行后直接开始更新不等待任何按键或输入✅断点续传只下载缺失的最新章节已下载章节自动跳过✅遵循全局配置自动读取config.yml中的保存路径、输出格式等下载设置✅适合脚本配合 cron、Windows 计划任务即可实现无人值守追更 出于防滥用考虑CLI 已禁用--download新建下载能力--update只允许更新本地已存在下载记录的书籍逻辑见 src/main.rs。前提条件先用 Web UI / TUI 完成首次下载--update不能凭空下载新书——程序会先在保存目录中查找该书的状态文件夹含status.json找不到就会拒绝执行并提示你改用 Web UI / TUI 完成首次下载。⚠️ 注意同一张图不能重复引用请忽略此行——实际使用时只需记住新书必须先在界面里下载过一次之后才能交给--update追更。判断逻辑源码可参考 src/ui/noui/download.rs。正确的工作流是首次用 Web UI--server或 TUI 搜索并下载目标小说记下该书的book_id一串长数字之后所有追更操作都交给--update book_id一条命令开始追更--update 用法详解基本命令格式Tomato-Novel-Downloader.exe --update book_id示例WindowsTomato-Novel-Downloader.exe --update 7318247498772674083Linux / macOS 下同理将可执行文件名替换为你的二进制路径即可。命令参数定义见 src/main.rs。快速查找 book_id 的两种方法方法一看本地保存目录——书籍状态文件夹通常以book_id或book_id_书名命名文件夹名开头的数字就是 book_id方法二从分享链接中提取——番茄/长读分享链接里的book_id...或/page/...后的数字均可被程序自动解析解析逻辑见 src/base_system/book_id.rs三个常用组合参数参数作用典型场景--retry-failed非交互模式下对失败章节额外重试一次网络不稳的定时任务--data-dir 路径指定数据目录config.yml和日志所在目录Docker 部署 / 集中管理配置--debug输出调试日志排查更新失败原因Kindle 追更推荐组合Tomato-Novel-Downloader --update 7318247498772674083 --retry-failed非交互模式到底做了什么执行--update后程序按以下流程运行全程无交互校验本地记录在config.yml配置的默认保存路径save_path留空时为当前目录下查找该书的状态文件夹拉取远端目录对比线上章节数与本地记录统计新增章节与失败章节断点续传下载非交互模式固定使用续传策略Resume只下载缺失/失败章节已存在的章节直接跳过收尾生成补齐段评缓存重新生成 EPUB/TXT 等最终产物若开启了有声小说生成已存在的章节音频也会自动跳过输出结果打印书名、章节数、成功/失败统计与保存路径进程以退出码结束——脚本可通过退出码判断是否成功核心流程实现位于 src/ui/noui/download.rs更新扫描逻辑位于 src/base_system/novel_updates.rs。Kindle 自动更新实战配置定时任务Linux / macOS使用 cron 每小时追更# 编辑 crontab crontab -e # 每小时整点追更日志追加到文件 0 * * * * /opt/tomato/Tomato-Novel-Downloader --update 7318247498772674083 --retry-failed /var/log/tomato-update.log 21下载完成后可用 rsync / Syncthing 等工具把save_path下的 EPUB 同步到 Kindle 同步目录即可实现番茄更新 → 自动下载 → 自动进 Kindle的完整链路。Windows使用计划任务PowerShell 一行创建schtasks /create /tn TomatoAutoUpdate /tr C:\Tools\Tomato-Novel-Downloader.exe --update 7318247498772674083 --retry-failed /sc hourlyDocker 环境小贴士Web UI 镜像也支持直接以--update参数运行一次性任务配合--data-dir挂载持久化配置docker run --rm -v /host/data:/data my-tomato-image --data-dir /data --update 7318247498772674083常见问题与避坑指南Q1提示CLI 模式仅支持更新本地已有小说怎么办说明该book_id在保存路径下没有下载记录。请先用 Web UI 或 TUI 完成首次下载再使用--update。Q2为什么下载了但书的内容没变化非交互模式是续传逻辑若远端没有新章节程序会提示没有需要下载的章节仅执行收尾生成属正常现象。Q3更新失败了怎么排查加上--debug重跑一次并查看logs目录下的日志偶发失败可加--retry-failed让程序自动重试一次。Q4能不能用--update同时更新多本书每次命令只接受一个book_id脚本里写个循环即可for id in 7318247498772674083 7423591956359416856; do ./Tomato-Novel-Downloader --update $id --retry-failed done小结--update book_id是番茄小说下载器面向自动化场景的非交互追更模式一行命令、零输入前提是书籍已通过 Web UI / TUI 完成首次下载配合--retry-failed与定时任务cron / 计划任务即可轻松实现Kindle 自动更新等无人值守场景遇到问题用--debug查看调试日志快速定位原因现在就可以打开终端用你手上任意一本连载小说试一试感受睡一觉起来书已自动追更的体验吧【免费下载链接】Tomato-Novel-Downloader番茄小说下载器不精简版项目地址: https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考