flomo-add

# 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） ```bash # 在项目主路径下执行 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） ```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/ # 预留 ```