flomo-via-app

📝 灵感速记,双通道无忧同步

🥥5总安装量 2评分人数 2
100% 的用户推荐

基于 flomo 官方 Webhook API 的笔记快速记录工具,支持 URL Scheme 与 webhook 双通道发送,实现 macOS 端灵感即时捕获与云端同步。

A

基本安全,请在特定环境下使用

  • 来自可信组织或认证账号,需要结合权限范围判断
  • ✅ 敏感信息妥善处理:webhook token 存储于 600 权限的 `.env` 文件或环境变量,不硬编码、不输出日志
  • ✅ 输入安全验证:内容非空检查、5000 字符长度限制、Python3 json 模块安全构建 payload
  • ✅ 网络通信加密:仅通过 HTTPS 与 flomo 官方服务器通信,无中间人攻击风险
  • ✅ 最小权限原则:仅请求网络访问与 skill 目录文件读写,无特权操作需求
  • ⚠️ 命令注入低风险:虽采用 sed/Python3 转义机制,但用户输入仍建议避免直接拼接特殊 shell 字符

使用说明

核心用法

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 单通道

flomo-via-app 内容

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