用途:在 Mac 本地已登录 flomo 的前提下,通过脚本快速访问 flomo 数据,避免使用 Chrome 界面自动化。适合按关键词、标签或时间范围检索备忘,回顾近期想法,导出月度 Markdown 与标签统计,以及创建或编辑纯文本备忘。
主要能力:query 用于直接检索,支持关键词、标签、日期范围和条数限制,返回结果含 slug 与 flomo 备忘 URL;summarize 用于“最近在想什么”类回顾,输出备忘数量、热门标签与支撑备忘;export-monthly 每月输出一个 Markdown 文件并生成 tag-stats.md;tags 返回现有标签及层级、父标签与计数;create 创建纯文本备忘;edit 按 slug 或 memo_id 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" summarize --days 30;python3 "$SCRIPT" export-monthly;python3 "$SCRIPT" tags --roots-only --limit 20;python3 "$SCRIPT" create --content "测试 memo #codex/demo";也支持通过 --stdin 输入内容,edit 支持 --slug 或 --url。写备忘时应先查看现有标签体系,复用已有标签,优先 1 至 4 个成熟标签,只有无接近标签时才新建并说明原因。
限制:flomo 不渲染 Markdown,内容需用纯文本,例如用「」或全大写代替加粗,用 • 或 1. 代替列表,禁止复选框与待办列表。前提是此前在 Mac 上登录过 flomo、本地存储存在且本地认证可用;若登录状态缺失或损坏,应改用 flomo-web-crud。该技能不删除备忘,不通过实时 Web UI 操作。仅当用户明确要求时才创建或编辑,总结应视为备忘中的模式而非诊断,不应持久化额外原始转储。具体授权范围、价格与平台支持等未在资料中说明。