博客转Kindle

抓取博客/文章网站内容，编译成带有封面的EPUB文件，并发送到Kindle。

快速开始

# 1. Fetch essays from a supported site
uv run scripts/fetch_blog.py --site paulgraham --output ./pg-essays

# 2. Generate cover (uses Nano Banana Pro)
# See nano-banana-pro skill for cover generation

# 3. Compile to EPUB with cover
uv run scripts/compile_epub.py --input ./pg-essays --cover ./cover.png --output essays.epub

# 4. Send to Kindle
uv run scripts/send_to_kindle.py --file essays.epub --kindle-email user@kindle.com

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

1. 抓取- 从博客下载所有文章/帖子
2. 生成封面- 通过Nano Banana Pro技能创建封面图（切勿跳过）
3. 编译- 将所有内容与封面合并成EPUB文件
4. 发送- 通过电子邮件发送到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/:

• {站点}-last-fetch.json- 最后抓取时间戳，文章数量
• {站点}-sent.json- 已发送文章ID列表

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

手动工作流（无脚本）

如果脚本不可用，请遵循此模式：

1. 抓取: 使用curl获取归档页面 → 解析文章链接 → 抓取每篇文章 → 转换为markdown格式
2. 合并: 将markdown文件与YAML前置元数据（标题、作者）拼接
3. 封面: 通过Nano Banana Pro生成
4. 转换:pandoc combined.md -o output.epub --epub-cover-image=cover.png --toc
5. 发送：带有附件的AppleScript Mail.app

查看references/manual-workflow.md以获取详细步骤。