weread-to-flomo
Use this skill to move WeRead highlights/notes into flomo safely.
Default workflow
- 1. Export WeRead notes into local Markdown files first.
- Set
FLOMO_WEBHOOK and WEREAD_COOKIE via environment variables or config files outside the skill package. - Choose one sync scope:
-
today: only today's new entries
-
date: entries from a specified day
-
all: full migration
- 4. Use local state tracking to avoid duplicate pushes.
- Run
--dry-run before the first real sync or before a bulk migration. - Prefer
today or date mode when the user already has historical reading notes in flomo.
Modes
1. Sync today's new entries
CODEBLOCK0
2. Sync a specified date
CODEBLOCK1
3. Full migration
CODEBLOCK2
Sync scopes
- -
today: sync only entries whose WeRead timestamp falls on the current Asia/Shanghai day. - INLINECODE9 : sync only entries from
--date YYYY-MM-DD. - INLINECODE11 : migrate all exported entries.
Tag template
Default output:
CODEBLOCK3
Override with:
CODEBLOCK4
State and dedup
- - State file defaults to
.weread-flomo-state.json under the WeRead export directory. - Dedup uses
bookmark:<id> / review:<id>. - Re-running the same scope only sends unsent entries.
Notes
- - Keep webhook/cookie outside the skill directory.
- Dry-run on first use.
- If the user already manually copied many old notes into flomo, prefer
today or date mode before all.
References
- - Read
references/formatting.md when adjusting output structure or tag conventions. - Read
references/publishing.md when preparing the skill for ClawHub publication.
weread-to-flomo
使用此技能将微信读书的划线/笔记安全地导入 flomo。
默认工作流程
- 1. 先将微信读书笔记导出为本地 Markdown 文件。
- 通过环境变量或技能包外部的配置文件设置 FLOMOWEBHOOK 和 WEREADCOOKIE。
- 选择同步范围：
- today：仅同步今日新增条目
- date：同步指定日期的条目
- all：完整迁移
- 4. 使用本地状态追踪避免重复推送。
- 在首次真实同步或批量迁移前运行 --dry-run。
- 当用户已在 flomo 中有历史阅读笔记时，优先使用 today 或 date 模式。
模式
1. 同步今日新增条目
bash
python3 ./scripts/wereadtoflomo.py --weread-dir /path/to/weread --mode today --flomo-webhook $FLOMO_WEBHOOK --dry-run
python3 ./scripts/wereadtoflomo.py --weread-dir /path/to/weread --mode today --flomo-webhook $FLOMO_WEBHOOK
2. 同步指定日期
bash
python3 ./scripts/wereadtoflomo.py --weread-dir /path/to/weread --mode date --date 2026-03-26 --flomo-webhook $FLOMO_WEBHOOK
3. 完整迁移
bash
python3 ./scripts/wereadtoflomo.py --weread-dir /path/to/weread --mode all --flomo-webhook $FLOMO_WEBHOOK
同步范围
- - today：仅同步微信读书时间戳属于当前亚洲/上海时区日期的条目。
- date：仅同步 --date YYYY-MM-DD 指定日期的条目。
- all：迁移所有已导出的条目。
标签模板
默认输出：
text
内容正文
#02读书 #02读书/「书名」
可通过以下命令覆盖：
bash
--tag-prefix 02_读书
状态与去重
- - 状态文件默认为微信读书导出目录下的 .weread-flomo-state.json。
- 去重使用 bookmark: / review:。
- 重新运行相同范围仅发送未发送的条目。
注意事项
- - 将 webhook/cookie 保存在技能目录之外。
- 首次使用时先进行 dry-run。
- 如果用户已手动将大量旧笔记复制到 flomo，在运行 all 模式前优先使用 today 或 date 模式。
参考
- - 调整输出结构或标签规范时，请阅读 references/formatting.md。
- 准备将技能发布到 ClawHub 时，请阅读 references/publishing.md。
