核心用法
flomo-send 是一款专为浮墨笔记(flomo)用户设计的本地化内容采集工具,采用「双通道」架构实现笔记的快速投递。用户可通过 ./scripts/flomo_send.sh 命令行工具,配合文本内容与支持 #标签 的格式,将笔记即时发送至 flomo 收件箱。工具首先尝试通过 flomo:// URL Scheme 唤醒本地应用实现零延迟投递;当检测到应用未安装或唤起失败时,自动无缝切换至 Webhook API 模式,通过 HTTPS 请求将内容同步至云端。支持从命令行参数、剪贴板(pbpaste)或管道(stdin)多种方式输入内容,满足不同的自动化工作流需求。
显著优点
可靠性保障:独创的双通道冗余机制确保在各种环境下都能成功记录,无论是本地 macOS 环境还是远程 SSH 会话,均不会因应用状态导致内容丢失。隐私与效率兼顾:作为本地 Bash 脚本执行,无需安装繁重运行时,仅依赖系统自带的 curl 与可选的 python3,数据直传 flomo 服务器无中间商。灵活的内容处理:原生支持多行文本、Markdown 格式与哈希标签自动解析,最大支持 5000 字符的富内容输入;配合 Unix 哲学,可轻松与 Alfred、Raycast 或其他自动化工具链集成。配置安全:通过 ./scripts/configure.sh 交互式配置向导,将敏感 Webhook Token 以 600 权限存储于本地 .env 文件,避免硬编码风险。
潜在缺点与局限性
会员门槛:核心功能(Webhook API 与 URL Scheme)强制要求 flomo PRO 付费会员资格,免费用户无法使用。平台限制:URL Scheme 方案仅限 macOS 且需安装桌面客户端,Windows 或纯移动端用户仅能依赖 Webhook 模式。媒体内容限制:脚本当前仅支持纯文本传输,图片等多媒体内容需手动构造 URL Scheme 且要求图片为公网可访问 URL,操作门槛较高。来源可信度:作为 T3 级个人开发者项目,虽代码开源透明,但建议用户在使用前及后续更新时进行代码审查,避免供应链风险。
适合的目标群体
本 Skill 最适合flomo 重度知识管理用户,特别是习惯使用命令行、追求极致输入效率的开发者与文字工作者。对于构建个人知识库(PKM)自动化工作流的用户,如希望将浏览器剪贴板、RSS 阅读器或日志系统自动归档至 flomo 的高级用户,该工具提供了不可或缺的桥梁。同时,适合需要在远程服务器或无 GUI 环境下记录想法的运维人员与研究人员。
使用风险与注意事项
网络依赖性:Webhook 回退模式依赖互联网连接,完全离线环境下功能受限。凭证管理:用户需妥善保管 Webhook Token,虽脚本已设置文件权限保护,但仍需避免将 .env 文件误提交至公共代码仓库。内容审查:笔记内容将通过 HTTPS 发送至 flomo 第三方服务器,虽加密传输但用户应知晓数据出境(至 flomo 云服务)的事实。长期维护:作为社区项目,存在维护停滞或 API 变更导致功能失效的可能,建议关注上游更新。