WeRead2Flomo

同步微信读书划线到 Flomo | AI 智能摘要 | Telegram 通知 | GitHub Actions 自动化

📸 点击查看运行效果

---

功能一览

功能	说明
📝 自动同步	定时同步微信读书划线到 Flomo，增量去重
🤖 AI 智能摘要	为长划线自动生成一句话概述
🏷️ AI 智能标签	自动提取主题，生成精准标签
🎨 多模板系统	简洁/标准/详细三种模板 + 自定义
📬 Telegram 通知	同步完成后推送详细报告
🍪 Cookie Cloud	自动同步浏览器 Cookie，无需手动更新
⏱️ GitHub Actions	每天自动运行，无需本地部署

📖 功能详细说明和使用场景：FEATURES.md

---

🚀 快速开始

方式一：GitHub Actions 自动化（推荐）

无需本地环境，Fork 后配置即用，每天自动同步。

1. Fork 本仓库

2. 配置 Secrets

进入你 Fork 后的仓库 → Settings → Secrets and variables → Actions，添加：

Secret	必填	说明
CC_URL	是	Cookie Cloud 服务器地址
CC_ID	是	Cookie Cloud UUID
CC_PASSWORD	是	Cookie Cloud 密码
FLOMO_API	是	Flomo API 地址
AI_API_KEY	否	AI API Key（开启 AI 摘要/标签）
TELEGRAM_BOT_TOKEN	否	Telegram Bot Token（开启通知）
TELEGRAM_CHAT_ID	否	Telegram Chat ID（开启通知）

不使用 Cookie Cloud？也可以用 WEREAD_COOKIE 代替前三项，详见 Cookie 配置指南

3. 启用 Actions

进入 Actions 标签页 → 启用工作流 → 完成！

每天北京时间 08:00 自动同步，也可手动触发：Actions → Run workflow

📖 详细教程：GitHub Actions 配置指南

方式二：本地运行

git clone https://github.com/blessonism/weread2flomo.git
cd weread2flomo
pip install -r requirements.txt
cp .env.example .env  # 编辑 .env 填入配置
python sync.py

📖 完整本地部署教程：快速开始指南

---

⚙️ 配置速查

配置优先级：环境变量（.env）> config.yaml > 默认值

必填配置

配置项	环境变量	说明
微信读书认证	CC_URL + CC_ID + CC_PASSWORD 或 WEREAD_COOKIE	Cookie Cloud（推荐）或手动 Cookie
Flomo API	FLOMO_API	Flomo 官方 API 地址

AI 功能（可选）

配置项	环境变量	说明
API 密钥	AI_API_KEY	OpenAI 格式的 API Key
API 地址	AI_API_BASE	支持所有 OpenAI 兼容服务
模型名称	AI_MODEL	如 gpt-5、claude-4.5-sonnet 等
启用摘要	-	config.yaml 中 ai.enable_summary: true
启用标签	-	config.yaml 中 tags.enable_ai_tags: true

Telegram 通知（可选）

每次同步完成后，自动推送报告到 Telegram，包含同步数量、书籍详情、AI 统计等。

配置项	环境变量	说明
Bot Token	TELEGRAM_BOT_TOKEN	通过 @BotFather 创建 Bot 获取
Chat ID	TELEGRAM_CHAT_ID	通过 @userinfobot 获取
启用开关	-	config.yaml 中 notification.telegram.enabled: true
自定义 API	TELEGRAM_API_BASE	默认 https://api.telegram.org，支持反代

同步配置（可选）

配置项	环境变量	默认值	说明
时间限制	SYNC_DAYS_LIMIT	100	只同步最近 N 天的划线
最大数量	SYNC_MAX_HIGHLIGHTS	50	每次最多同步 N 条
同步笔记	SYNC_REVIEWS	true	是否同步笔记

📖 完整配置文档：CONFIG_GUIDE.md

---

❓ 常见问题

Cookie 怎么获取？会过期吗？

推荐使用 Cookie Cloud 自动同步，无需手动操作。详见 Cookie Cloud 配置指南。

手动获取：浏览器登录 weread.qq.com → F12 开发者工具 → Application → Cookies。有效期较短，需定期更新。

GitHub Actions 没有运行 / 运行失败？

• 仓库 60 天无活动会被 GitHub 自动禁用 → Actions 页面重新启用
• 检查 Settings → Actions → Workflow permissions 设为 Read and write permissions
• 检查所有必填 Secrets 是否配置正确
• 定时任务可能有 5 分钟 ~ 2 小时延迟，属正常现象

有的划线没有同步？

1. Flomo API 每日限制 100 次
2. 检查 days_limit 时间范围设置
3. 已同步过的不会重复（查看 synced_bookmarks.json）
4. Cookie 可能已过期

Telegram 通知收不到？

1. 检查 TELEGRAM_BOT_TOKEN 和 TELEGRAM_CHAT_ID 是否正确
2. config.yaml 中 notification.telegram.enabled 需为 true
3. 首次使用需先向 Bot 发送一条消息激活对话
4. 网络问题可通过 TELEGRAM_API_BASE 配置反代

📖 更多问题：完整 FAQ

---

📖 了解更多

文档	说明
功能特性详解	模板示例、AI 功能、使用场景、高级用法
完整配置指南	所有配置项详细说明
Cookie Cloud 指南	Cookie Cloud 安装和配置教程
GitHub Actions 指南	自动化部署详细步骤、Cron 表达式
Secrets 配置指南	GitHub Secrets 配置方法
快速开始（中文）	完整的本地部署教程

---

🙏 致谢

• weread2notion - 微信读书同步方案参考
• Flomo - 优秀的笔记工具
• Cookie Cloud - Cookie 同步方案

---

👥 贡献

欢迎贡献代码、报告问题或提出建议！

• 🐛 报告 Bug · 💡 功能建议 · 🔧 提交 PR

---

📄 许可证

MIT License

---

⭐ 如果这个项目对你有帮助，请给个 Star 支持一下！