reflect-open

本地存 Markdown，让 AI 帮你写和整理笔记

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署办公效率 🍴 复刻 143 🐛 待处理 117 👀 关注 6

GitHub ↗

GitHub 星标 ★ 1622

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源免费，需自行部署

项目预览

reflect-open 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类办公效率

开发团队team-reflect

GitHubhttps://github.com/team-reflect/reflect-open

定价模式🏷️完全免费

价格说明开源免费，需自行部署

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型agent,markdown,note-taking

GitHub 星标★ 1622

上线时间2026-06-09 00:00:00

代码更新2026-11-14

仓库体积97.0 MB

本站数据更新2026-11-15

维护状态活跃

收录时间2026-10-01

浏览次数2

项目介绍

reflect-open 是笔记软件 Reflect 的开源重写版，定位为本地优先、对 AI agent 友好的 Markdown 笔记应用。它解决的核心问题是：传统云笔记把数据锁在服务商服务器上，且难以被自动化工具直接读写。reflect-open 把笔记以纯 Markdown 文件形式保存在本地，同时提供面向 agent 的接口，让 AI 助手可以像人一样创建、检索、链接和整理笔记。核心能力包括双向链接与知识图谱式组织、本地文件存储带来的数据自主权、Markdown 原生编辑体验，以及为自动化工作流预留的 agent 集成能力。技术栈为 TypeScript，适合注重隐私、希望用 AI 增强个人知识管理的开发者和效率用户。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-10-01 · 当前星标 ★ 1622

技术标签

agent markdown note-taking

使用教程

难度：入门约 10 分钟部署方式：本地安装 7 步

环境要求

一台 Mac 电脑（Apple silicon M 系列或 Intel 芯片，按机型选择对应安装包）
可选：OpenAI / Anthropic / Google / OpenRouter 其中一家的 API Key，用于 ⌘J 的 AI 问答
可选：iCloud Drive 账号，或一个 git / GitHub 远程仓库，用于笔记同步与版本备份
可选：安装了 Chrome 浏览器，用于网页剪藏扩展
可选：iOS 设备加入 TestFlight 以安装 iOS 测试版

安装与启动步骤

1下载 Mac 应用

打开 releases 页面，按机型下载安装包：Apple 芯片选 Reflect_aarch64.dmg，Intel 选 Reflect_x86_64.dmg；想用测试版可换 updater-beta 标签下的 Beta 包。
2选择笔记文件夹

首次打开应用后指定一个本地文件夹作为笔记库，笔记会以纯 Markdown 文件保存在这里，不需要 Reflect 账号，应用也不会把笔记存成专有数据库。
3安装 iOS 测试版

在 iPhone 上通过 README 给出的 TestFlight 链接加入测试，iOS 版与 Mac 版共用同一套纯文件笔记图和同步方式。
4安装 Chrome 扩展

在 Chrome 应用商店添加 Reflect Capture 扩展，之后可保存当前页面、选中文字、截图以及可选的整页文本。
5配置 AI 密钥

如需要 ⌘J 的问答功能，在应用内填入自己申请的 OpenAI、Anthropic、Google 或 OpenRouter 密钥；回答会标注引用的来源笔记。
6配置同步方式

可选。用 iCloud Drive 做文件同步，或把笔记文件夹接入 git 仓库 / GitHub 远程做版本化备份，均由用户自己连接。
7试用 CLI 命令

应用附带 CLI，可查看今日笔记和搜索笔记内容（README 片段中仅完整给出这两个子命令）。
```
reflect today
reflect search
```

关键配置

配置项	必填	说明	示例
`笔记文件夹路径`	是	笔记以 Markdown 文件形式存放的位置，由用户自行选择	`/Users/yourname/Notes`
`AI 提供商 API Key`	否	开启 ⌘J 问答，支持 OpenAI、Anthropic、Google、OpenRouter	`sk-xxxxxxxx`
`private: true`	否	写在笔记 frontmatter 中，将该笔记内容排除在 AI 等外部服务之外	`private: true`
`git 远程仓库地址`	否	用 git / GitHub 做笔记的版本化备份与同步	`https://github.com/yourname/notes.git`

如何确认成功

应用打开后直接显示今天的日记笔记；按 ⌘K 能搜到已有笔记、反链和标签，说明笔记库已正确加载。

常见问题

Q：需要注册 Reflect 账号吗？

A：不需要。应用不要求 Reflect 账号，笔记存放在你自己选择的文件夹里，AI、转录、iCloud、GitHub 等服务都由你直接连接。

Q：AI 问答要额外付费或自带密钥吗？

A：要自带密钥。⌘J 的问答通过用户提供的 OpenAI、Anthropic、Google 或 OpenRouter 密钥工作，费用由对应服务商结算。

Q：怎么让某些笔记不被 AI 读取？

A：在该笔记的 frontmatter 中加上 private: true，其内容就会被排除在 AI 及其他外部服务之外。

Q：笔记会不会被锁成专有数据库？

A：不会。笔记就是普通 Markdown 文件，搜索和反链在本地完成，不依赖应用专属数据库，可随时用其他工具打开。

Q：iPhone 上怎么用？

A：通过 README 中的 TestFlight 链接加入 iOS 测试版，它与 Mac 版使用相同的纯文件笔记图和同步选项。

注意事项

README 节选中只给出了 Mac 应用、iOS 测试版和 Chrome 扩展的安装方式，从源码构建的细节没有展开，需要时请自行查看仓库的 building-from-source 章节。
安装包已签名、公证，并通过 GitHub Releases 自动更新，可放心从官方 releases 页面下载。
CLI 在节选里被截断，只有 reflect today 和 reflect search 是完整可见的，其余子命令请以仓库文档为准。
同步服务（iCloud、git/GitHub）和 AI、转录服务均为可选项，不配置也能正常做本地笔记。