flomo-via-app

核心用法

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 是一款面向 flomo（浮墨笔记）用户的命令行工具型 skill，主打「双通道可靠投递」机制。用户可通过 ./scripts/flomo_send.sh 脚本将文字笔记、标签、链接等内容一键发送至 flomo 收件箱。核心交互极简：安装后先运行 ./scripts/configure.sh 配置 webhook，随后即可用单行命令完成记录。

显著优点

1. 双通道冗余设计：优先尝试本地 URL Scheme（flomo://create）直接唤起 App，失败自动降级至 webhook HTTP POST，确保在无 App 环境（如 SSH 远程服务器）也能正常工作。
2. 标签原生支持：内容中 #tag 格式会被 flomo 自动识别，无需额外参数。
3. 零依赖轻量实现：仅依赖系统自带的 curl 与 python3，无第三方包管理风险。
4. 配置灵活安全：支持 .env 本地隔离（默认 600 权限）或 shell 环境变量两种方式，符合最小权限原则。
5. 多输入源兼容：支持直接传参、管道 stdin、剪贴板 pbpaste 等典型 Unix 工作流。

潜在缺点与局限性

• PRO 会员门槛：URL Scheme 与 webhook 功能均需 flomo PRO 订阅，免费用户无法使用。
• 平台限制：URL Scheme 仅 macOS 有效；跨平台（Linux/Windows）场景只能依赖 webhook。
• 内容长度上限：单条笔记内容（URL 编码前）限 5000 字符，图片支持仅限 URL Scheme 且最多 9 张，webhook 不支持图片。
• 网络依赖：webhook 降级模式下需访问 flomoapp.com 服务器，对离线或网络隔离环境不友好。

适合人群

• 已订阅 flomo PRO 的 macOS 深度用户，习惯命令行/Alfred/Raycast 等效率工具链。
• 需要在远程服务器、CI/CD 流水线或 SSH 会话中自动记录日志/快照的技术工作者。
• 追求「最小阻力记录」的卡片笔记法实践者，希望将碎片信息快速汇入 flomo 每日回顾流。

常规风险

• 外部 API 泄露风险：Webhook token 若误提交至公共代码仓库，可能被他人滥用向用户 flomo 账户灌入垃圾内容（token 仅具备写入权限，无读取/删除权限）。
• URL Scheme 注入：虽脚本对 content 进行 URL 编码，但若直接手动构造 open 命令且未妥善处理特殊字符，仍存在潜在解析异常。
• 配置残留：configure.sh 提供写入 ~/.zshrc 等选项，若用户选择此方式且后续卸载 skill，需手动清理环境变量。

整体而言，该 skill 设计简洁、意图透明，是 flomo 生态中值得信赖的命令行增强工具。