名称： blinko
描述： 通过 REST API 管理 Blinko 笔记（创建/列出/删除笔记，管理标签/分类）。当用户提到“blinko …”、希望保存笔记到 Blinko、列出/搜索近期笔记、重新标记笔记或进行清理/整理时使用。需要 BLINKO_API_KEY。

Blinko

将 Blinko 作为笔记的唯一可信来源。

设置（一次性）

环境变量（可在 Gateway 环境中设置）：
- BLINKO_API_KEY（必需）
- BLINKO_BASE_URL（可选；默认值为 https://blinko.exemple.com）

核心工作流

1) 创建笔记

当用户说类似以下内容时：
- “blinko: …”
- “note: …”

创建笔记，包含：
- Markdown 正文
- 在末尾以井号标签形式添加标签（遵循用户的分类约束）

2) 列出/搜索笔记

如果用户询问“liste mes notes”或“cherche …”，调用列表端点并显示：
- 笔记 ID
- 首行/标题
- 主要标签（如有）

3) 标签规则（用户约束）

• 最多 7 个顶级标签。
• 每条笔记：选择 1 个顶级标签 + 最多 0–2 个子标签。
• 子标签语法：#Tech/dev。

4) 破坏性操作（删除/清理）

在执行以下操作前，务必明确确认（“OK vas-y”）：
- 删除笔记
- 删除标签

批量操作可使用辅助脚本。

辅助脚本

scripts/blinko.py 封装了 API 调用。

示例：

# 列出笔记
BLINKO_API_KEY=... ./scripts/blinko.py list --page 1 --size 20

# 创建笔记
BLINKO_API_KEY=... ./scripts/blinko.py create --title "测试" --content "你好" --tags "#Inbox #Todo/à-faire"

# 删除笔记（破坏性操作）
BLINKO_API_KEY=... ./scripts/blinko.py delete --yes 123 124

参考

端点速查表请见 references/blinko_api.md。

GitHub

https://github.com/Vellis59/openclaw-skill-blinko