Reflect Notes

# Reflect Notes Skill

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

## 设置

1. 在 https://reflect.app/developer/oauth 创建 OAuth 凭证 2. 在该界面生成访问令牌（access token） 3. 设置环境变量： ```bash 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 中，并使用你的 vault/item 路径更新 `scripts/reflect.sh`。

## 我们能做什么

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

## API 参考

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

### 追加到每日笔记

```bash 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 }' ```

### 创建笔记

```bash 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 }' ```

### 创建链接

```bash 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"] }' ```

### 获取链接

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

## 辅助脚本

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

```bash # 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" ```

## 使用场景

- **从聊天中捕获待办事项**（todos）→ 追加到每日笔记 - **保存对话中提到的有趣链接** - **创建会议记录**或摘要 - **同步提醒**至 Reflect 以确保持久化 - **反向链接**到列表（如 `[[Ideas]]` 或 `[[Project Name]]`）

## 限制

- **无法读取笔记内容**（端到端加密） - **仅追加（Append-only）**——无法编辑或删除现有内容 - **无搜索功能**——无法查询现有笔记