核心用法
flomo-via-app 是一款面向 macOS 用户的命令行工具,实现向 flomo(浮墨笔记)快速投递内容的双通道机制:
1. 主通道:调用 flomo:// URL Scheme 直接唤起 flomo 客户端,实现本地瞬时写入
2. 降级通道:当本地应用不可用(未安装、SSH 远程环境、自动化脚本)时,自动 fallback 至 HTTP Webhook API 投递
安装后需运行 ./scripts/configure.sh 交互式配置 PRO 用户的 Webhook Token,随后即可通过 ./scripts/flomo_send.sh "内容" "#标签" 一键发笔记。
显著优点
- 可靠性设计:双通道自动切换,本地/云端/远程场景全覆盖
- 标签原生支持:
#标签格式自动解析,契合 flomo 标签体系 - 多端兼容:支持管道输入、剪贴板内容、
pbpaste集成 - 轻量化:纯 Shell 脚本实现,零额外依赖(仅需 curl)
潜在局限
- 平台锁定:URL Scheme 仅限 macOS;Linux/Windows 用户只能依赖 Webhook
- 功能受限:Webhook 不支持图片上传(仅文本),图片需用 URL Scheme 且限制 9 张
- 会员门槛:URL Scheme 与 Webhook 均需 flomo PRO 订阅
- 内容上限:单条笔记 5000 字符(URL 编码前)
适合人群
- macOS 重度用户,追求「秒级」捕捉灵感的知识工作者
- 已订阅 flomo PRO,需要自动化/脚本化笔记入站的效率极客
- 常在终端、SSH 远程服务器工作,希望无缝同步想法的开发者
常规风险
- Token 泄露:Webhook Token 若暴露在公开仓库或环境变量中,可导致笔记被恶意写入;建议配置脚本将
.env加入.gitignore - 降级静默失败:URL Scheme 失败时虽自动 fallback,但用户可能 unaware 实际走网络通道,敏感内容存在意外外传风险
- 编码边界:超长内容或特殊 Unicode 需依赖 Python3 进行 URL 编码,若系统无 Python3 可能投递失败