博客转 Kindle

抓取博客/散文网站内容，生成带封面图的 EPUB 文件，并推送至 Kindle 设备。

快速开始

# 1. 从受支持的网站获取散文
uv run scripts/fetch_blog.py --site paulgraham --output ./pg-essays

# 2. 生成封面（使用 Nano Banana Pro）
# 封面生成详见 nano-banana-pro 技能说明

# 3. 编译为带封面的 EPUB
uv run scripts/compile_epub.py --input ./pg-essays --cover ./cover.png --output essays.epub

# 4. 发送至 Kindle
uv run scripts/send_to_kindle.py --file essays.epub --kindle-email user@kindle.com

工作流（必须严格按此顺序执行）

1. 抓取（Fetch） —— 下载博客全部散文/文章
2. 生成封面（Generate Cover） —— 通过 nano-banana-pro 技能生成封面图（不可跳过）
3. 编译（Compile） —— 将内容与封面合并为 EPUB 文件（封面需嵌入）
4. 发送（Send） —— 邮件发送至 Kindle 地址

⚠️ 发送前务必生成并嵌入封面。 禁止在无封面情况下发送。

已支持网站

对于未列出的网站，请使用 --site custom --url 参数。

封面生成

使用 nano-banana-pro 技能生成封面。提示词模板如下：

Book cover for '[Author Name]: [Subtitle]'. 
Minimalist design with elegant typography. 
[Brand color] accent. Clean white/cream background. 
Simple geometric or abstract motif related to [topic].
Professional literary feel. No photos, no faces.
Portrait orientation book cover dimensions.

建议以 2K 分辨率生成，兼顾画质与文件体积。

Kindle 推送

默认 Kindle 地址（Simon）：simonpilkington74_8oVjpj@kindle.com

通过 AppleScript 调用 Mail.app 发送邮件。请确保：

• 发件邮箱已在 Kindle 的“已批准的发件人列表”中
• 附件大小不超过 50MB（EPUB 格式压缩效果良好）

状态追踪

状态文件存储于 ~/.clawdbot/state/blog-kindle/ 目录下：

• {site}-last-fetch.json —— 上次抓取时间戳及文章数量
• {site}-sent.json —— 已发送文章 ID 列表

可用于增量更新（仅抓取新增文章）。

手动工作流（不依赖脚本）

若脚本不可用，请按以下流程操作：

1. 抓取（Fetch）：使用 curl 获取归档页 → 解析文章链接 → 逐条抓取 → 转换为 Markdown
2. 合并（Combine）：拼接 Markdown 内容，并添加 YAML 前置元数据（含 title、author 字段）
3. 封面（Cover）：通过 nano-banana-pro 生成封面
4. 转换（Convert）：pandoc combined.md -o output.epub --epub-cover-image=cover.png --toc
5. 发送（Send）：通过 AppleScript 调用 Mail.app 并附加文件发送

详细步骤参见 references/manual-workflow.md。