flomo-send

📝 双通道极速记录浮墨笔记

基于 flomo 官方 API 的双通道笔记采集工具,支持 URL Scheme 与 Webhook 自动回退,确保灵感记录零丢失,需 PRO 会员。

收藏
2.3k
安装
538
版本
v1.0.0
CLS 安全性认证2026-05-15
点击查看完整报告 >

使用说明

核心用法

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 变更导致功能失效的可能,建议关注上游更新。

安全解读

核心用法

flomo-send 是一款专为 macOS 设计的 flomo 浮墨笔记快捷发送工具,采用双通道策略确保笔记投递成功率。用户可通过 Bash 脚本 ./scripts/flomo_send.sh 快速发送文字笔记,支持标签自动解析、多行文本及 stdin 管道输入。

主要工作模式:

  • 主通道(URL Scheme):调用 flomo://create 直接唤起本地应用,瞬时投递、体验最佳
  • 降级通道(Webhook API):当本地应用不可用时,自动通过 HTTPS POST 发送至 flomo 服务器

首次使用必须运行 ./scripts/configure.sh 完成交互式配置,支持将 Webhook Token 保存至本地 .env 文件(权限 600)或全局 shell 配置文件。

显著优点

  • 可靠性高:双通道自动降级,网络受限或 SSH 远程环境仍能正常工作
  • 配置灵活:支持环境变量、本地配置文件多种方式,敏感信息隔离存储
  • 工作流友好:与 macOS 剪贴板(pbpaste)、管道命令无缝集成
  • 代码简洁:纯 Bash 实现,零外部依赖,仅调用系统 curl

潜在局限

  • 会员门槛:URL Scheme 和 Webhook 功能均需 flomo PRO 订阅
  • 平台限制:URL Scheme 仅支持 macOS,Webhook 方案跨平台但需手动配置
  • 功能边界:脚本暂不支持图片发送,需直接使用 URL Scheme;单条笔记 5000 字符上限
  • 来源风险:T3 级个人开发者维护(qiantao1001),非知名组织背书

适合人群

  • 重度 flomo 用户,追求「秒记」效率的知识工作者
  • 经常在终端/远程服务器工作的开发者、运维人员
  • 习惯命令行自动化、希望集成至个人工作流的效率爱好者
  • 已订阅 flomo PRO 的 macOS 用户

常规风险

  • 笔记内容经 HTTPS 传输至 flomo 第三方服务器,需信任 flomo 隐私政策
  • 配置脚本可选修改 shell 配置文件,存在敏感信息误写入全局配置的风险(建议优先使用本地 .env 方案)
  • Webhook Token 若泄露,他人可向用户 inbox 发送内容,需妥善保管

flomo-send 内容

references文件夹
scripts文件夹
手动下载zip · 9.4 kB
api.mdtext/markdown
请选择文件