Reflect：本地优先 Markdown 笔记应用

项目简介

Reflect 是一款开源笔记应用，核心理念是「笔记就是文件」。它把一个笔记文件夹称为 graph，里面是普通的 Markdown 文件和附件，可以直接查看、备份、同步，或用任何 Markdown 编辑器打开。应用本身在文件之上提供搜索、反向链接、标签和相关笔记等能力，而不是把笔记锁进只属于应用的数据库。

无需 Reflect 账号，笔记存放在你指定的文件夹里；AI 提供商、转录、iCloud、GitHub 或其他 git 远端等可选服务，都由用户自己直接连接。

主要功能

• 每日笔记：打开应用即进入今天的笔记，快速记录默认写在这里。
• Wiki 链接与反向链接：输入 [[ 即可链接其他笔记，每篇笔记会显示有哪些笔记链接到它。
• 本地搜索：⌘K 可搜索笔记、反向链接和标签，也可以在本地开启可选的语义搜索。
• Ask your notes：⌘J 通过用户自己提供的 OpenAI、Anthropic、Google 或 OpenRouter 密钥查询笔记，回答会标注引用的来源笔记。
• 私密笔记：在笔记中写 private: true，即可让其内容不进入 AI 及其他外部服务。
• 语音备忘：录音后通过已配置的转录服务写入当日笔记。
• 浏览器采集：Chrome 扩展可以保存当前页面、选中文字、截图和页面正文。
• 同步方式：用 iCloud Drive 做文件同步，或用 git / GitHub 做带版本历史的备份，也支持任意 SSH git 远端。
• 命令行：提供 reflect today、reflect search、reflect show，方便脚本和 agent 调用。

笔记目录结构大致如下：

my-graph/
├── daily/2026-06-12.md     # 按日期命名的每日笔记
├── notes/some-title.md     # 按标题命名的其他笔记
├── assets/                 # 图片与附件
└── audio-memos/            # 录音与转录文本

安装与使用

1. Mac 应用：从 Releases 下载对应安装包，构建已签名、公证并通过 GitHub Releases 自动更新：
   • 稳定版：Apple silicon（M 系列） · Universal（Intel 与 Apple silicon）
   • Beta 版：Apple silicon（M 系列） · Universal（Intel 与 Apple silicon）
2. iOS Beta：通过 TestFlight 参与，与 Mac 版使用相同的纯文件 graph 和同步方式。
3. Windows 与 Linux：各版本包含未签名的构建，详见 docs/distribution.md。
4. Chrome 扩展：在 Chrome 应用商店安装 Reflect Capture。

跨设备同步时，可以把 graph 建在 iCloud Drive 的同步文件夹中（如 iCloud Drive/ReflectGraph）；需要版本化备份时，在应用内连接 GitHub 或添加任意 SSH git 远端。

从源码构建需要 Rust 工具链、Node.js 与 pnpm 10、Xcode Command Line Tools：

git clone https://github.com/team-reflect/reflect-open.git
cd reflect-open
corepack enable
pnpm install
pnpm tauri dev

仓库是 pnpm / Turborepo 单仓结构，包含 apps/desktop、apps/cli、apps/extension、apps/native-host 以及 packages/core、packages/db 等目录。

注意事项

• 项目目前处于 beta 阶段，当前重心是 Mac 应用、iOS 伴生端、浏览器采集、本地优先数据模型与同步可靠性。
• Android 和插件 API 暂不在计划范围内。
• 默认情况下笔记内容只留在本机，只有在配置了服务提供商、连接 git 远端或使用平台同步服务后才会发生外部请求。
• 非 macOS 平台的构建未签名，使用时可能需要手动放行。
• 项目基于 MIT 许可证开源。

---

本作品整理自 GitHub 开源项目 team-reflect/reflect-open，原作者 @team-reflect，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。