核心用法
flomo-via-app 是一款面向 flomo(浮墨笔记)用户的快捷记录工具,采用"双通道策略"确保笔记发送的高可靠性。主要使用方式包括:通过 ./scripts/flomo_send.sh 命令行脚本发送文本笔记(支持标签 #tag 格式),或直接调用 flomo://create URL Scheme 唤起本地应用。首次使用需运行 ./scripts/configure.sh 配置 flomo PRO 的 webhook token,支持环境变量与 .env 文件两种持久化存储方案。
脚本具备智能降级机制:优先尝试 URL Scheme 唤起本地 flomo 应用实现即时本地写入;若应用未安装或调用失败,自动回退至 webhook API 通过 HTTPS 将内容推送至云端。支持多行文本、剪贴板内容、管道输入等多种数据来源,满足命令行工作流、SSH 远程会话等场景需求。
显著优点
1. 可靠性设计:双通道冗余策略确保笔记不丢失,本地应用与云端 API 互为备份
2. 极简交互:单行命令即可完成记录,标签自动解析,符合 flomo "快速捕获"的产品哲学
3. 配置友好:交互式配置脚本降低上手门槛,敏感信息采用 600 权限文件保护
4. 场景覆盖广:支持本地开发、远程服务器、自动化脚本等多元环境
5. 安全实现:Python3 json 模块构建 payload,避免命令注入;HTTPS 传输保障数据安全
潜在缺点与局限性
- 平台限制:URL Scheme 仅支持 macOS,Windows/Linux 用户仅能依赖 webhook 通道
- 功能边界:脚本层仅支持纯文本,图片发送需直接使用 URL Scheme 并满足公开 URL、9 张上限等约束
- 会员门槛:核心功能依赖 flomo PRO 订阅,免费用户无法使用
- 内容限制:单条笔记 5000 字符上限,长内容需手动拆分
- 网络依赖:webhook 回退模式需外网连通,内网环境可能失效
适合的目标群体
- flomo PRO 付费用户:已具备 webhook 使用权限,追求效率最大化
- macOS 命令行用户:开发者、研究员、文字工作者等习惯终端操作的人群
- 自动化工作流构建者:希望将笔记捕获集成到脚本、Alfred、Raycast 等工具链的用户
- 跨设备记录需求者:需要在远程服务器、SSH 会话中同步灵感的场景
使用风险
- 配置泄露风险:
.env文件若被误提交至 Git 仓库可能导致 webhook token 暴露,建议配合.gitignore使用 - 网络超时风险:webhook 调用依赖 flomo 服务端稳定性,弱网环境下可能出现延迟或失败
- 字符编码边缘情况:虽内置 UTF-8 处理,但极端特殊字符仍可能引发转义异常
- 版本兼容性:flomo 应用需 v1.5+ 才支持 URL Scheme,旧版本用户仅能使用 webhook 单通道