[其他] 11.8k Star 开源 AI 笔记 NoteGen：内置 RAG 碎片自动整理成 Markdown

研发记笔记的真痛点：不是没工具，是"先记什么后整理什么"

看到这篇文章的同学，大多数人可能都不缺笔记工具——Obsidian / Notion / Logseq / 印象笔记 / Apple 备忘录，少则装了一两个，多则四五个全装齐了。

但你回头看看自己的笔记库——是不是大多数页面都长这样：

• 标题写了一半「TODO 整理 redis 内存」
• 一段截屏丢在那里没配文字
• 一个 GitHub 链接被复制下来等"有空再读"
• 一段会议碎话——"小明说要用 X 方案，记得明天问产品"

研发笔记的真痛点从来不是没工具——是「先记什么、后整理什么」这个动作链断了。当你想认真做一份"Redis 大 key 排查指南"的时候，你脑子里那 30 个碎片素材根本拼不起来——它们散在截图文件夹、Slack 历史、浏览器收藏夹、各种 App 草稿里。

最近撞到一个开源工具——它干的就是这件事：先把碎片往里甩，AI 帮你拼成正经笔记。它叫 NoteGen（项目代号也写作 note-gen）。

截至本文发稿 GitHub Star 11.8k+——比刚开源那阵涨了 20%，桌面端覆盖 macOS / Windows / Linux、移动端 Android / iOS（TestFlight）也都跟上了。

仓库地址：https://github.com/codexu/note-gen ｜ 官网：https://notegen.top/cn

NoteGen 怎么解决：把"先甩 → 再整理"拆成两个动作

NoteGen 的官方一句话定位是："capture first, organize later, and let AI turn fragments into readable notes" ——先抓后整理，让 AI 把碎片拼成可读的笔记（来自官方 README）。

它把整个产品拆成两层：

• 抓取层（Capture）：截图、文本、网页摘录、图片识别、剪贴板抓取。这一层的目标是让你完全不思考"该不该记"——丢进去再说。
• 整理层（Organize）：在编辑器里跟 AI 对话——「把这周关于 Redis 的所有碎片整理成一篇大 key 排查 SOP」。AI 帮你跨碎片综合、去重、补结构、加大纲，输出标准 Markdown。

它不绑定云端——所有原始笔记是 Markdown 文件，存在本地。这点至关重要：万一 NoteGen 哪天停更，你的笔记直接拿别的 Markdown 编辑器（Obsidian / Typora）就能继续读，没有迁移成本。

横向对比：Obsidian / Notion / Logseq vs NoteGen

笔记软件这个赛道太卷，先把 NoteGen 放到生态里看清楚位置：

工具	核心理念	AI 整合	存储	致命短板
Obsidian	双链笔记（PKM）	插件凑（要装 Smart Composer 等）	本地 Markdown	AI 是后装的，整合不深
Notion	块编辑 + 数据库	内置 Notion AI（订阅制）	云端为主	数据不在本地，国内访问偶发卡
Logseq	大纲 + 双链	弱	本地 Markdown	移动端体验拉跨
NoteGen	碎片抓取 + AI 重组	原生集成、自带 RAG	本地 Markdown + 多端同步	起步晚，社区还小

NoteGen 的差异化生态位很清楚——它不是 Obsidian 的对手（Obsidian 强调网状思维），它是给那种"先记一堆乱七八糟、后面再来整理"型选手的。

如果你日常笔记 80% 都是"截图 + 一句话备注 + 等以后整理"，NoteGen 比 Obsidian 顺手；如果你有时间慢慢做双链，Obsidian 仍然是更深的工具。

研发能用它干啥：5 个真实场景

按使用频率从高到低：

场景 1：技术学习中的"碎片→读书笔记"（最高频）

读 Spring Boot 官方文档（https://docs.spring.io/spring-boot/）的 Auto-configuration 章节，碰到一段不懂的——截图丢进 NoteGen，一句话备注「这里的 condition 评估顺序不对」。一周后攒了 8-10 个截图碎片，让 AI：「把所有关于 Auto-configuration 的碎片整理成一篇 SOP」——它会综合、去重、补结构，输出一份能直接发到团队的 Markdown 文档。

场景 2：源码阅读笔记

读 RocketMQ 源码的时候，每读到一个关键类（BrokerController / MessageStore / IndexFile）就在 NoteGen 开一个 Markdown，截一段图、画一段调用链伪代码、丢一段疑问。读完整个源码后让 AI：「把这些碎片整理成一份从 producer.send() 一路到磁盘落盘的完整链路文档」。

场景 3：会议碎记 → 周报输出

开周会的时候只甩三种东西：① 一句话「小明要用 X 方案」；② 一张白板截图；③ 一个未完成 TODO「问产品 Y」。周五前让 AI：「把这周所有会议碎记整理成周报，按【已完成 / 进行中 / 阻塞 / 待跟进】分类」——周报 5 分钟搞定。

场景 4：生产事故复盘的"边吵架边记"

线上炸了的时候——TraceID、jstack 截图、Arthas 输出、群里的对话片段——全部第一时间丢进一个 NoteGen note，不要停下来想结构。事故处理完，让 AI：「按【现象 / 真凶 / 修法 / 预防】整理一份事故复盘」。

场景 5：跟读 GitHub 项目 / 选型调研

调研选型时——读 5 个候选库的 README，每个库截一些关键截图、贴几段官方原话、写几句吐槽。最后让 AI：「对比这 5 个库，按性能 / 上手成本 / 社区 / 致命短板给我一张选型表」——比手动写决策矩阵省至少 1 小时。

底层观察：NoteGen 真正帮你省时间的地方，不是"打字快了"——是「让你愿意先甩碎片」。原本你不会记的那些一闪而过的零碎想法，现在因为"反正 AI 会帮我整理"这个心理预期，愿意往里丢了——这才是它的真价值。

接入 AI 模型：自带 Key 还是接到自家网关？

NoteGen 没绑定单一模型——你可以接 OpenAI、Claude、DeepSeek、SiliconFlow，也支持 MCP 协议接入更多 Agent 工具（来自官方 README）。

研发同学接入时常见两种姿态：

• 自带 Key 直接接 OpenAI / Claude / DeepSeek：上手最快，直接在 NoteGen 设置里填 https://api.openai.com/v1 + OPENAI_API_KEY；
• 接到自家 AI 网关：如果团队已经有一套 OpenAI 兼容的 AI 网关——比如 yudao-cloud 的 AI 模块或公司内部统一的 LiteLLM 网关——把 base_url 指向网关 + 填团队发的 token 就行——走团队额度、统一记账、不用每个人各自申请 Key。

yudao-cloud 仓库：https://github.com/YunaiV/yudao-cloud
LiteLLM 仓库：https://github.com/BerriAI/litellm

⚠️ 注意：NoteGen 默认用 GPL-3.0 协议——团队内部用没问题；如果你想把 NoteGen 改造后做商业产品——先看 GPL-3.0 协议条款（https://www.gnu.org/licenses/gpl-3.0.html）——衍生作品要开源。

🔒 隐私边界要清楚：原始 Markdown 笔记全程存本地 OK，但 AI 整理时内容仍会发给你配置的模型——和你平时用 ChatGPT / Cursor 是一样的性质。敏感会议记录、生产事故复盘、客户合同 / 财报这类内容——建议：① 先脱敏（手动改名 / 改数字）再让 AI 整理；② 或者把 base_url 指向公司私有模型 / yudao-cloud AI 模块网关——别直接走 OpenAI / Claude / DeepSeek 公有云 API。这一条做好——NoteGen 才真正适合做"研发工作笔记主仓库"。

真实边界：用之前要知道的 3 件事

按破坏力从高到低：

边界 1：移动端还是 Alpha（最常见）

桌面端 Beta、移动端 Alpha——iOS 走 TestFlight，Android 也是抢鲜版。重要笔记别只放在手机端，等正式版稳定再说。

边界 2：原始素材跨设备同步要自己接

NoteGen 支持 GitHub / Gitee / GitLab / S3 / WebDAV 同步——这步你得自己配。不像 Notion 这种 SaaS 默认就同步好，研发同学自配 WebDAV 还能接受，普通用户会被劝退。

边界 3：AI 调用成本要算账（高级场景）

如果你 500 个截图碎片让 AI 整理，单次 prompt 可能消耗几万 token——按 Claude Sonnet 算下来一次几块钱。重度使用建议接 DeepSeek（https://www.deepseek.com/）/ SiliconFlow（https://siliconflow.cn/）这类性价比高的国产模型，单次成本能压到几毛。

我的判断

笔记软件这个赛道，Obsidian 抢走的是"喜欢双链 + 慢慢织网"的一波人，Notion 抢走的是"喜欢块编辑 + 数据库"的一波人——剩下还有一大片「我就是想丢碎片，整理这事 AI 来吧」的人没人接住。

NoteGen 接住的就是这群人。

研发同学的真实场景大半属于这一类——学的东西太多、记的太碎、整理得太晚。装一个试试，别期望它替代 Obsidian / Notion，期望它让你愿意"先甩"——能做到这点，已经赢了一半。

仓库地址：https://github.com/codexu/note-gen ｜ 官网：https://notegen.top/cn

如果你也在找这类效率工具的深度评测，云栈社区还有更多开源项目实战分享。