flomo-local-api

用途

flomo-local-api 用于在本地桌面登录状态可用时，快速访问用户的 flomo 笔记。它通过本地认证与 flomo API 完成查询、总结、导出、创建和编辑操作，不依赖 Chrome UI 自动化，因此速度更快。

主要能力

查询：按关键词、标签、日期范围或最近时间窗口检索笔记，默认按创建时间从新到旧返回，结果包含 slug 与对应的 flomo 笔记 URL。
总结：针对“最近在想什么”“最近状态如何”等反思类请求，返回笔记数量、热门标签与支撑笔记。
按月导出：生成每月一个 Markdown 文件以及 tag-stats.md 标签统计文件。
标签查询：读取现有标签体系，返回标签、深度、父标签、直接计数与总计数，支持按最小总计数过滤成熟标签。
创建笔记：从本地认证快速创建纯文本笔记，支持通过 stdin 输入，也支持 --html 模式。
编辑笔记：通过 slug 或 flomo 笔记 URL（如 https://v.flomoapp.com/mine/?memo_id=...）更新已有笔记的文本内容，并保留原有附件与置顶状态。
附件元数据：在查询或按月导出时使用 --include-files，可返回或渲染图片与附件的元数据，包括图片 URL 与缩略图 URL。

使用方式

脚本路径从当前环境设置，而非硬编码用户目录：

SKILL_ROOT="${CODEX_HOME:-$HOME/.codex}/skills/flomo-local-api"
SCRIPT="$SKILL_ROOT/scripts/flomo_local_api.py"

常用命令示例：

python3 "$SCRIPT" query --keyword "openclaw" --limit 10
python3 "$SCRIPT" query --tag "Proj/mf" --days 30
python3 "$SCRIPT" query --start-date 2026-03-01 --end-date 2026-03-11 --format markdown
python3 "$SCRIPT" query --limit 5 --sort newest
python3 "$SCRIPT" query --keyword "截图" --limit 5 --include-files --format json
python3 "$SCRIPT" summarize --days 30
python3 "$SCRIPT" export-monthly
python3 "$SCRIPT" export-monthly --include-files --output-dir ~/download/flomo-markdown-export-monthly-with-images
python3 "$SCRIPT" tags --roots-only --limit 20
python3 "$SCRIPT" tags --query "agent" --limit 20 --min-total-count 2
python3 "$SCRIPT" create --content "测试 memo #codex/demo"
python3 "$SCRIPT" edit --slug "MTIzMDgzNzgz" --content "更新后的 memo 内容 #codex/demo"
python3 "$SCRIPT" edit --url "https://v.flomoapp.com/mine/?memo_id=MTIzMDgzNzgz" --content "更新后的 memo 内容 #codex/demo"

创建带加粗标题的笔记时，使用 --html 模式：

cat <<'EOF' | python3 "$SCRIPT" create --stdin --html
<p><strong>Memo title</strong></p><p>Memo body in plain paragraphs.</p><p>#area/ai/agent/skill</p>
EOF

适用场景

用户要求按关键词、标签或时间范围搜索 flomo 笔记。
用户询问笔记中是否包含图片或附件，或希望在读取/导出结果中包含图片 URL。
用户想知道最近在思考什么。
用户需要按月 Markdown 导出或标签统计。
用户希望在不使用 Chrome UI 自动化的情况下创建简单笔记。
用户希望通过 slug 或 flomo 笔记 URL 编辑已有文本笔记，而不打开 Web UI。
用户希望比 Chrome UI 自动化更快地查询。
用户希望在创建前先草拟一条符合现有 flomo 标签体系的笔记。

限制

不用于删除笔记。
不用于通过实时 Web UI 操作。
本地桌面登录状态缺失或损坏、且无法通过本地认证完成请求时不可用。
写入路径不上传新附件；--include-files 仅用于读取与导出，不表示可以上传、删除、OCR 或重写附件文件。
edit 仅用于文本更新，保留当前附件与置顶状态，不管理附件。
创建与编辑笔记时，默认要求复用用户已有标签体系，目标是在至少 95% 的写笔记场景中复用现有标签；仅在找不到接近的现有标签时才可引入至多一个新标签，并需向用户简要说明原因。
默认要求为新笔记添加简洁标题，并以加粗形式呈现；flomo 不渲染 Markdown 语法（如 bold、- [ ] 复选框、# 标题），加粗标题需使用 CLI 的 --html 模式并用 <strong>...</strong> 包裹。
正文建议使用纯段落，列表仅在自然可读时使用简单换行或 • 符号，不使用复选框或待办列表。
批量打标签时，若用户未指定数量，默认每条笔记 3 个标签。
标签查询默认预算为 3 次查找：1 次仅根标签扫描、1 次聚焦实体/主题查找、1 次可选消歧查找；超出需有明确理由。
结构化输出如 tag_decision.json 中，selected_tags 使用不带 # 的原始标签字符串；draft.md 中的话题标签必须与 selected_tags 加 # 后完全对应。
仅在用户明确要求创建新笔记时使用 create；仅在用户明确要求修改已有笔记时使用 edit。
不随意发明新标签，写入前先用 tags 检查现有标签。
不从此技能删除 flomo 笔记。

技能介绍

用途

主要能力

使用方式

适用场景

限制