灵感速记，双通道无忧同步

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

基本信息

• 技能名称?flomo-via-app
• 中文名称?灵感速记，双通道无忧同步
• 作者?qiantao1001
• 分类?效率
• 版本?v1.0.8
• 标签?productivity, content-media, automation, api, macos

使用方法

使用说明
核心用法
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 单通道