| 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 自动化扩展。
