reflect-open

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

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

开源 free 办公效率

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1495

维护状态活跃

是否开源是

定价模式 free

项目预览

项目数据

分类办公效率

开发团队team-reflect

所属国家

官网地址

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

定价模式free

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

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

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

GitHub 星标★ 1495

30天Star增速

HF 下载量

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

最近更新2026-09-30 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-01

浏览次数0

Star 增长趋势

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

正在加载星标数据…

使用教程

难度：入门约 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、转录服务均为可选项，不配置也能正常做本地笔记。

核心亮点

笔记以本地 Markdown 文件保存，数据完全自主可控，不依赖云端账号
原生面向 AI agent 设计，可被自动化工具直接读写和整理
支持双向链接与知识网络组织，适合构建个人知识库

不足之处

项目仍处早期，功能完整度和稳定性与成熟商业笔记软件有差距
生态与插件体系尚小，agent 集成的实际可用性需自行验证

适用场景

开发者用 AI 助手自动整理每日工作日志并生成关联笔记
注重隐私的用户在本地维护可版本控制的个人知识库
团队用 Markdown 笔记配合自动化脚本做轻量知识沉淀

替代项目

Obsidian、Logseq

项目介绍

reflect-open 是办公效率领域的开源项目，由 team-reflect 开发，是 2026 年新上线的项目。

在全站 13,465 个收录项目中，它的 GitHub 星标数（1,495）位列前 30%，在办公效率分类中处于中上游。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-30。开源免费，需自行部署。

它主要面向的使用场景是：开发者用AI助手自动整理每日工作日志并生成关联笔记。同类可对比的替代方案包括 Obsidian、Logseq。

上一篇：univer-workspace

下一篇：opensync