用途:这是一个独立的导出技能,将本地 flomo 桌面端数据转换为按时间分组的 Markdown 文件,供 AI/NotebookLM 阅读;同时生成含 direct_count 和 total_count 的 tag-stats.md 标签统计。它不用于交互式「查找并编辑单条笔记」的 CRUD 请求。
主要能力:默认从本地 flomo 桌面登录状态读取数据(非导出的 HTML),按月拆分、使用 {{user}}_{{range}} 文件名、附件模式为 placeholder。支持自定义日期范围、拆分粒度(如 quarter)、文件名模板和附件处理方式。标签从 Markdown 正文按 #tag 语法重新提取,统计按每条笔记去重。
使用方式:先设置脚本路径: SKILL_ROOT="${CODEX_HOME:-$HOME/.codex}/skills/flomo-memo-to-markdown" SCRIPT="$SKILL_ROOT/scripts/flomo_to_nblm.py"
示例: python3 "$SCRIPT" python3 "$SCRIPT" --preview-only python3 "$SCRIPT" --split quarter --asset-mode copy
前置条件:flomo.app 曾在该 Mac 登录;本地存储位于 ~/Library/Containers/com.flomoapp.m/... 下;如使用本地源需能访问 flomo API。
附件模式:placeholder(默认)追加附件路径行、不复制文件;ignore 完全忽略附件;copy 下载签名附件 URL 到输出目录下的 assets/ 并重写 Markdown 引用。
输出行为:默认输出解压后的 Markdown 文件,导出模式还会写入 tag-stats.md;--preview-only 仅执行解析、过滤、分组和标签统计;--word-limit 视为字符数阈值。
限制:本地 API 读取失败时会快速失败并立即返回错误,不回退到缓存的导出文件;除用户明确要求处理存档外,不请求导出的 HTML。仅在会实质影响执行时才追问,如自定义日期范围、不同拆分粒度、自定义文件名模板、复制附件或明确忽略附件、本地桌面认证缺失或损坏。
其他信息(如具体收费、平台支持范围、效果评估)暂未提供。