核心用法
flomo-send 是一款面向 flomo PRO 用户的命令行速记工具,提供双重投递机制:优先通过 macOS URL Scheme 唤起本地 flomo 应用实现毫秒级本地写入,若检测到应用未安装或 open 命令失败则自动降级至 Webhook API 云端投递。安装后需运行 ./scripts/configure.sh 完成交互式配置(PRO 账户验证、Webhook Token 录入、.env 持久化存储),之后即可通过 ./scripts/flomo_send.sh "内容" "#标签1 #标签2" 快速捕获灵感。
脚本支持多输入源:直接参数、管道输入 echo "text" | ./scripts/flomo_send.sh、剪贴板调用 pbpaste。标签自动识别 #tagname 格式,内容上限 5000 字符(URL 编码前)。高级场景可通过裸 open "flomo://create?..." 发送图片(最多 9 张公开 URL),但主脚本仅支持文本。
显著优点
- 双通道可靠性:URL Scheme 的即时性与 Webhook 的跨平台稳健性结合,覆盖本地速记与远程 SSH 场景
- 零摩擦配置:
configure.sh交互引导降低 PRO Webhook 门槛,.env隔离环境变量避免污染全局 shell - 标签原生兼容:自动解析 flomo 标准标签语法,无需额外格式化
- 多输入适配:参数、管道、剪贴板全支持,契合开发者自动化脚本集成需求
潜在缺点与局限
- 付费门槛:URL Scheme 与 Webhook 功能强制依赖 flomo PRO 会员,免费用户无法使用
- 平台锁定:URL Scheme 仅限 macOS;Linux/Windows 纯用户只能依赖 Webhook,体验降级
- 图片支持割裂:主脚本不支持图片,需手动构造 URL Scheme 且要求图片为公开 URL(隐私敏感图片无法直接发送)
- 环境变量依赖:Webhook 模式要求
curl与FLOMO_WEBHOOK_TOKEN预配置,未配置时脚本中断而非静默降级 - 字符编码风险:虽声称自动 UTF-8 编码,但依赖 Python3 作为回退,精简环境可能出错
适合人群
- 已订阅 flomo PRO 的 macOS 深度用户,追求"想到即记"的极客工作流
- 需在 SSH 远程服务器或 CI/CD 流水线中自动归档日志/摘要的开发者
- 习惯终端操作、使用 Raycast/Alfred 等启动器自定义速记快捷指令的效率工具爱好者
常规风险
- Token 泄露:Webhook Token 存储于明文
.env文件,若仓库误提交至 GitHub 可导致笔记内容被恶意推送 - 内容截断:5000 字符上限无前置校验,超长内容可能被静默截断或 API 拒绝
- 网络隐私:Webhook 模式强制走 flomo 服务器,敏感笔记内容暴露于第三方云端
- 依赖单点故障:flomo 服务或 PRO 会员状态变动将直接瘫痪整个工作流