将 flomo 所有记录 memo 同步/备份到本地 Markdown 文件的工具。使用 scripts/flomo-sync.py 脚本通过 flomo API 拉取 memo,支持增量同步、附件下载、多文件输出。当用户需要备份 flomo、同步 flomo memo 到本地、导出 flomo 笔记为 Markdown 时使用。
将 flomo 所有 memo 增量同步为本地 Markdown 文件。
执行本技能前,必须先明确并拿到以下入参:
.flomo.config,避免在对话中明文暴露)INLINECODE2 必须基于“当前项目主路径”传入绝对路径,禁止使用相对路径(如 ./output、../backup)。
CODEBLOCK0
在项目主路径下创建 .flomo.config,并包含 token=<access_token>。
安全建议(强烈推荐):
.flomo.config 保存 token,不要在对话中直接粘贴 token,避免泄露给 LLM。python scripts/flomo-sync.py(自动从 .flomo.config 读取)。.flomo.config 格式说明key=value;以 # 开头的行为注释;空行忽略。token=<access_token>;支持带或不带 Bearer 前缀,例如:token=1023456|AA000000ABCDEFGHIJKHLMNOP000000000000000
- token=Bearer 1023456|AA000000ABCDEFGHIJKHLMNOP000000000000000
F12 → Network → 点击任意请求 → Headers → 复制 Authorization 的值(形如 Bearer 1023456|...)。备用:Application → Local Storage → me → 复制 access_token。url= 供 flomo-add 使用(与 flomo-add 共用一配置文件)。CODEBLOCK1
文档规范要求:执行同步时必须传
--dir且使用绝对路径。实现层面为兼容保留兜底:未传--dir时,默认写入当前执行目录。
CODEBLOCK2
| 参数 | 说明 | 默认值 |
|---|---|---|
| INLINECODE25 | flomo access_token(可从 .flomo.config 读取)。支持 Bearer <token> 格式 | — |
| INLINECODE28 |
--after YYYY-MM-DD | 仅拉取该日期后更新的 memo | 自动读取 .flomo.lock |
| --no-download | 不下载附件,保留远程 URL | 否(默认下载) |
每条 memo 生成独立 .md 文件,命名格式为 {日期}_{标签}_{内容前6字}_{slug}.md:
CODEBLOCK3
脚本自动维护 .flomo.lock 文件,记录上次同步的最大 updated_at 时间戳。下次运行时自动从该时间点(减 1 天容错)开始拉取,无需手动指定 --after。
sign 错误:token 无效或过期,重新从浏览器获取请先登录:未传入 token 或 token 不完整.png/.jpg/.gif 等)以  嵌入,音频(.m4a/.mp3 等)以 [name](path) 链接;加 --no-download 保留原始远程 URLCODEBLOCK4
运行后会在输出目录产生:
CODEBLOCK5
该技能支持在以下平台通过对话安装:
帮我安装 SkillHub 和 flomo-sync-1776420039 技能
设置 SkillHub 为我的优先技能安装源,然后帮我安装 flomo-sync-1776420039 技能
skillhub install flomo-sync-1776420039
文件大小: 11.02 KB | 发布时间: 2026-4-17 20:10