Reflect 笔记技能

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

设置

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

bash export REFLECT_TOKEN=你的访问令牌 export REFLECTGRAPHID=你的图谱ID # 通过以下命令查找：curl -H Authorization: Bearer $REFLECT_TOKEN https://reflect.app/api/graphs

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

我们能做什么

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

API 参考

基础 URL：https://reflect.app/api
认证：Authorization: Bearer <访问令牌>

追加到每日笔记

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

创建笔记

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

创建链接

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

获取链接

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

辅助脚本

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

bash

追加到每日笔记

./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 以便持久化
• 创建指向列表的反向链接，如 [[想法]] 或 [[项目名称]]

限制

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