| name | novel-import-tomato-reference |
| description | 用于处理番茄小说、Tomato Novel Downloader、免费小说 epub、下载器结果导入、epub 转 Markdown、以及把外部小说素材整理到当前小说 Project Workspace 的 reference/tomato/ 供后续拆书分析。 |
novel-import-tomato-reference:番茄小说导入
用于把番茄小说免费作品的本地素材整理成当前小说 Project Workspace 下的外部参考资料。第一版只做“导入 + 转换”,不承诺自动搜索或首次下载新书。
边界
- 默认输出到当前小说 Project Workspace 的
reference/tomato/。
- 不写入
manuscript/,避免把外部小说素材混进原创正文。
- 只处理本地 epub 或 Tomato Novel Downloader 已下载出的结构化目录。
- 当前下载器 exe 的非交互能力只适合更新已有本地记录;首次搜索和首次下载需要走 Web UI/TUI。
- 不要把搜索、评论、段评全量抓取描述成已完成能力;这些是后续扩展方向。
CLI
脚本位置:
bun assets/workspace/.nbook/agent/skills/novel-import-tomato-reference/scripts/tomato-novel.ts --help
常用命令:
bun assets/workspace/.nbook/agent/skills/novel-import-tomato-reference/scripts/tomato-novel.ts import-epub "C:\path\book.epub" --workspace "current-novel"
bun assets/workspace/.nbook/agent/skills/novel-import-tomato-reference/scripts/tomato-novel.ts import-download "C:\path\downloaded-book-dir" --workspace "current-novel"
默认参数:
--out reference/tomato:写入 workspace 内的外部参考资料目录。
--force:允许覆盖已有同名导入目录;默认拒绝覆盖。
--keep-raw:额外复制原始 epub、status.json 或 downloaded_chapters.jsonl 到 raw/。
--exe:覆盖 Tomato Novel Downloader exe 路径。默认使用 C:\Users\notnotype\Downloads\TomatoNovelDownloader-Win64-v2.4.9.exe。
工作流
- 确认当前小说 Project Workspace。Agent cwd 是 Workspace Root
workspace/,执行脚本时 --workspace 优先传当前项目目录名,例如 current-novel;手工从仓库根执行时可以传 workspace/current-novel。
- 如果用户给的是
.epub,运行 import-epub。
- 如果用户给的是下载器目录,且目录内有
status.json 或 downloaded_chapters.jsonl,运行 import-download。
- 导入后检查
metadata.json、chapters/、full.md 和 images/ 是否生成。
- 需要拆书时,把
reference/tomato/{book}/full.md 或单章文件作为参考输入,再按拆书流程提炼结构,不直接把原文搬进 manuscript/。
下载器封装
serve 只启动下载器 Web UI,供用户手动搜索和首次下载:
bun assets/workspace/.nbook/agent/skills/novel-import-tomato-reference/scripts/tomato-novel.ts serve --data-dir "C:\path\tomato-data"
update <book-id> 只更新下载器已经记录过的本地小说:
bun assets/workspace/.nbook/agent/skills/novel-import-tomato-reference/scripts/tomato-novel.ts update 7410970999107095577 --data-dir "C:\path\tomato-data"
如果用户要全站搜索、评论、段评或正文抓取,先说明第一版 CLI 尚未实现,再建议后续基于下载器源码/API 或 Web UI 自动化扩展。