反射笔记技能

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

设置

1. 请在以下地址创建OAuth凭证https://reflect.app/developer/oauth
2. 通过该界面生成访问令牌
3. 设置环境变量：

   export REFLECT_TOKEN="your-access-token"
   export REFLECT_GRAPH_ID="your-graph-id"  # Find via: 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": "Your text here",
    "transform_type": "list-append",
    "date": "2026-01-25",          # optional, defaults to today
    "list_name": "[[List Name]]"   # optional, append to specific list
  }'

创建笔记

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进行常见操作：

# Append to daily note
./scripts/reflect.sh daily "Remember to review PR #6"

# Append to specific list in daily note  
./scripts/reflect.sh daily "Buy milk" "[[Shopping]]"

# Create a new note
./scripts/reflect.sh note "Meeting Notes" "# Standup\n\n- Discussed X\n- Action item: Y"

# Save a link
./scripts/reflect.sh link "https://example.com" "Example Site" "Great resource"

使用场景

• 捕获待办事项从聊天 → 追加到每日笔记
• 保存有趣的链接在对话中提到的
• 创建会议笔记或摘要
• 同步提醒事项到 Reflect 以持久化
• 反向链接到列表例如[[想法]]或 [[项目名称]]限制

无法读取笔记内容

• （端到端加密）仅限追加
• — 无法编辑或删除现有内容无搜索功能
• — 无法查询现有笔记— can't query existing notes