flomo-add

向 flomo 新增一条 memo（单条写入）。

前置入参要求（必须）

执行本技能前，必须先明确并拿到以下入参：

• 当前项目主路径（绝对路径），例如 /Users/xxx/project-name
• memo 文本内容（即本次要写入 flomo 的 content）

必须在“当前项目主路径”下存在 .flomo.config，并且包含 url=。

配置（必须）

在项目主路径下创建 .flomo.config，并包含 url=。

.flomo.config 格式说明

• 通用规则：一行一个 key=value；以 # 开头的行为注释；空行忽略。
• flomo-add 所需：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/   # 预留