flomo-add

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

前置入参要求（必须）

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

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

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

配置（必须）

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

.flomo.config 格式说明

• - 通用规则：一行一个 key=value；以 # 开头的行为注释；空行忽略。
• flomo-add 所需：url=

• - 同一文件可同时包含 token= 供 flomo-sync 使用（与 flomo-sync 共用一配置文件）。

快速开始

1) 使用 Python 脚本（推荐，内部调用 requests）

bash

在项目主路径下执行

可选参数：

• - --config：指定配置文件路径（默认 .flomo.config）
• --url：临时覆盖配置里的 url
• --dry-run：只打印将发送的请求信息，不真正发送

2) 直接使用 curl（macOS / Linux）

bash
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）

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

文件说明

text
skills/flomo-add/
├── SKILL.md
├── scripts/
│ └── flomo-add.py
└── assets/ # 预留