名称： reflect
描述： 向每日笔记追加内容并在 Reflect 中创建笔记。用于捕捉想法、待办事项或将信息同步到知识图谱。
主页： https://reflect.app

Reflect 笔记技能

Reflect 是一款网络化笔记应用。笔记采用端到端加密，因此其 API 是仅追加的——我们可以写入，但无法读取笔记内容。

设置步骤

1. 在 https://reflect.app/developer/oauth 创建 OAuth 凭证。
2. 从该界面生成访问令牌。
3. 设置环境变量：
   bash export REFLECT_TOKEN="你的访问令牌" export REFLECT_GRAPH_ID="你的图谱ID" # 通过以下命令查找：curl -H "Authorization: Bearer $REFLECT_TOKEN" https://reflect.app/api/graphs

或者，将凭证存储在 1Password 中，并在 scripts/reflect.sh 脚本中更新你的保险库/项目路径。

功能概览

1. 追加到每日笔记 — 向当天的笔记（或指定日期）添加内容。
2. 创建新笔记 — 创建包含主题和 Markdown 内容的独立笔记。
3. 创建链接 — 保存带有高亮内容的书签。
4. 获取链接/书籍 — 检索已保存的链接和书籍。

API 参考

基础 URL: https://reflect.app/api
认证方式: Authorization: Bearer <access_token>

追加到每日笔记

curl -X PUT "https://reflect.app/api/graphs/$REFLECT_GRAPH_ID/daily-notes" \
  -H "Authorization: Bearer $REFLECT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "你的文本",
    "transform_type": "list-append",
    "date": "2026-01-25",          # 可选，默认为今天
    "list_name": "[[列表名称]]"   # 可选，追加到特定列表
  }'

创建笔记

curl -X POST "https://reflect.app/api/graphs/$REFLECT_GRAPH_ID/notes" \
  -H "Authorization: Bearer $REFLECT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "笔记标题",
    "content_markdown": "# 标题\n\n内容...",
    "pinned": false
  }'

创建链接

curl -X POST "https://reflect.app/api/graphs/$REFLECT_GRAPH_ID/links" \
  -H "Authorization: Bearer $REFLECT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "title": "页面标题",
    "description": "可选描述",
    "highlights": ["引用1", "引用2"]
  }'

获取链接

curl "https://reflect.app/api/graphs/$REFLECT_GRAPH_ID/links" \
  -H "Authorization: Bearer $REFLECT_TOKEN"

辅助脚本

使用 scripts/reflect.sh 执行常见操作：

# 追加到每日笔记
./scripts/reflect.sh daily "记得审阅 PR #6"

# 追加到每日笔记的特定列表
./scripts/reflect.sh daily "买牛奶" "[[购物]]"

# 创建新笔记
./scripts/reflect.sh note "会议记录" "# 站会\n\n- 讨论了 X\n- 行动项：Y"

# 保存链接
./scripts/reflect.sh link "https://example.com" "示例网站" "优质资源"

使用场景

• 捕捉待办事项：从聊天记录中提取并追加到每日笔记。
• 保存有趣链接：保存对话中提到的链接。
• 创建会议记录或摘要。
• 同步提醒事项到 Reflect 以实现持久化存储。
• 反向链接到列表，例如 [[想法]] 或 [[项目名称]]。

限制

• 无法读取笔记内容（端到端加密）。
• 仅追加 — 无法编辑或删除现有内容。
• 无法搜索 — 无法查询现有笔记。