核心用法
flomo-via-app 是一个面向 macOS 用户的命令行工具,专注于将碎片化笔记快速投递至 flomo(浮墨笔记)收件箱。其核心工作流分为两层:
1. URL Scheme 主通道:直接调用 flomo://create 唤起本地应用,瞬时完成笔记创建,支持文本(最多5000字符)及最多9张网络图片。
2. Webhook 降级通道:当本地应用不可用或处于远程SSH环境时,自动切换为 HTTP POST 至 flomo 服务器,确保高可用性。
用户通过 ./scripts/flomo_send.sh "内容" "#标签" 即可一键投递,支持管道输入、剪贴板内容,标签以 # 前缀自动识别。
显著优点
- 双通道可靠性:URL Scheme 与 Webhook 互补,覆盖本地与远程场景
- 轻量无依赖:纯 Bash 脚本实现,仅需
curl与标准 Unix 工具 - 快速捕获:契合 Zettelkasten 卡片笔记法的「随时记录」理念
- 标签原生支持:自动解析
#tag格式,与 flomo 生态无缝融合 - 配置隔离:
.env文件管理凭据,避免污染全局环境
潜在缺点与局限性
- 会员门槛:URL Scheme 与 Webhook 功能均需 flomo PRO 付费订阅
- 平台限制:URL Scheme 仅限 macOS;Linux/Windows 用户只能依赖 Webhook
- 图片限制:Webhook 通道不支持图片上传,仅 URL Scheme 可带图
- 字符限制:单条内容硬上限 5000 字符(编码前)
- 网络依赖:Webhook 降级通道需公网可达,无离线缓存机制
- 配置前置:首次使用必须运行
./scripts/configure.sh交互式配置,对自动化场景不够友好
适合人群
- 已订阅 flomo PRO 的 macOS 重度用户
- 习惯终端/命令行工作流的开发者、写作者
- 需要跨本地与远程服务器统一笔记入口的技术人员
- 追求「输入阻力最小化」的快速捕获践行者
常规风险
- 凭据泄露:Webhook Token 存储于本地
.env文件,若误提交至 Git 仓库可能导致笔记数据暴露 - 网络明文传输:Webhook 调用为 HTTPS,但 Token 仍存在于请求头,需确保设备端安全
- 内容截断:超长内容(>5000字符)静默截断,可能造成信息丢失
- 回退依赖:若 URL Scheme 失败且 Webhook 未配置,笔记将丢失且无持久化队列