Reflect 笔记技能

Reflect 是一款联网笔记应用。所有笔记均采用端到端加密（E2E encrypted），因此其 API 是仅追加（append-only）的——我们可写入内容，但无法读取笔记正文。

配置步骤

1. 在 https://reflect.app/developer/oauth 创建 OAuth 凭据
2. 通过该界面生成访问令牌（access token）
3. 设置环境变量：

   export REFLECT_TOKEN="your-access-token"
   export REFLECT_GRAPH_ID="your-graph-id"  # 可通过以下命令获取：curl -H "Authorization: Bearer $REFLECT_TOKEN" https://reflect.app/api/graphs
   

或将其存储于 1Password 中，并在 scripts/reflect.sh 中更新对应的保险库（vault）/条目（item）路径。

支持的功能

1. 向每日笔记追加内容——向今日笔记（或指定日期的笔记）添加条目
2. 创建新笔记——创建独立笔记，包含标题（subject）与 Markdown 格式正文
3. 创建链接——保存书签并附带高亮摘录（highlights）
4. 获取已保存的链接/书籍——检索已保存的链接和书籍列表

API 参考文档

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

向每日笔记追加内容

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": "Your text here",
    "transform_type": "list-append",
    "date": "2026-01-25",          # 可选，不填则默认为当天
    "list_name": "[[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": "Note Title",
    "content_markdown": "# Heading\n\nContent here...",
    "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": "Page Title",
    "description": "Optional description",
    "highlights": ["Quote 1", "Quote 2"]
  }'

获取链接列表

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

辅助脚本

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

# 向每日笔记追加内容
./scripts/reflect.sh daily "Remember to review PR #6"

# 向每日笔记中的指定列表追加内容  
./scripts/reflect.sh daily "Buy milk" "[[Shopping]]"

# 创建新笔记
./scripts/reflect.sh note "Meeting Notes" "# Standup\n\n- Discussed X\n- Action item: Y"

# 保存链接
./scripts/reflect.sh link "https://example.com" "Example Site" "Great resource"

典型应用场景

• 捕获待办事项：从聊天中提取 todo → 追加至每日笔记
• 保存有趣链接：将对话中提及的网页链接存入 Reflect
• 撰写会议纪要 或内容摘要
• 同步提醒事项 至 Reflect 实现持久化存储
• 反向链接至各类列表，例如 [[Ideas]] 或 [[Project Name]]

限制条件

• 无法读取笔记内容（因启用端到端加密）
• 仅支持追加操作——不可编辑或删除已有内容
• 不支持搜索功能——无法查询已存在的笔记