- name
- flomo-add
- description
- 通过 Python requests 向 flomo webhook URL 新增一条 memo。使用 scripts/flomo-add.py 从 .flomo.config 读取 url 并发起 POST 请求，支持在 macOS 与 Windows 环境下添加 flomo 笔记。用户需要快速新增 flomo 记录、写入临时想法、或自动化写入单条 memo 时使用。
flomo-add
向 flomo 新增一条 memo（单条写入）。
前置入参要求（必须）
执行本技能前，必须先明确并拿到以下入参：
- 当前项目主路径（绝对路径），例如
/Users/xxx/project-name - memo 文本内容（即本次要写入 flomo 的
content）
必须在“当前项目主路径”下存在 .flomo.config，并且包含 url=<flomo webhook url>。
配置（必须）
在项目主路径下创建 .flomo.config，并包含 url=<flomo webhook url>。
.flomo.config 格式说明
- 通用规则：一行一个
key=value；以#开头的行为注释；空行忽略。 - flomo-add 所需：
url=<flomo webhook url>
示例：url=https://flomoapp.com/iwh/M000000/abcdefg0000000000000000000000000/ 该 URL 需在 flomo 的「扩展中心 & API」中生成并妥善保管。
- 同一文件可同时包含
token=供 flomo-sync 使用（与 flomo-sync 共用一配置文件）。
快速开始
1) 使用 Python 脚本（推荐，内部调用 requests）
# 在项目主路径下执行
python skills/flomo-add/scripts/flomo-add.py --content "Hello, #flomo https://flomoapp.com"可选参数：
--config：指定配置文件路径（默认.flomo.config）--url：临时覆盖配置里的url--dry-run：只打印将发送的请求信息，不真正发送
2) 直接使用 curl（macOS / Linux）
curl -X POST "https://flomoapp.com/iwh/M000000/abcdefg0000000000000000000000000/" \
-H "Content-Type: application/json" \
--data-binary '{"content":"Hello, #flomo https://flomoapp.com"}'3) 直接使用 curl（Windows PowerShell）
$url = "https://flomoapp.com/iwh/M000000/abcdefg0000000000000000000000000/"
$body = '{"content":"Hello, #flomo https://flomoapp.com"}'
curl.exe -X POST $url -H "Content-Type: application/json" --data-binary $body预期行为
- 成功时：返回 flomo API 响应并退出码为 0
- 失败时：脚本打印错误原因（缺少配置、requests 依赖缺失、HTTP 失败等）并退出非 0
文件说明
skills/flomo-add/
├── SKILL.md
├── scripts/
│ └── flomo-add.py
└── assets/ # 预留