⭐⭐⭐ Spring Boot 项目实战	⭐⭐⭐ Spring Cloud 项目实战
《Dubbo 实现原理与源码解析 —— 精品合集》	《Netty 实现原理与源码解析 —— 精品合集》
《Spring 实现原理与源码解析 —— 精品合集》	《MyBatis 实现原理与源码解析 —— 精品合集》
《Spring MVC 实现原理与源码解析 —— 精品合集》	《数据库实体设计合集》
《Spring Boot 实现原理与源码解析 —— 精品合集》	《Java 面试题 + Java 学习指南》

摘要: 原创出处 http://www.iocoder.cn/Fight/Star-98k-kaiyuanjiyu-AI-de-Markdown-bijiyingyong-notegen/ 「芋道源码」欢迎转载，保留摘要，谢谢！

🙂🙂🙂关注微信公众号：【芋道源码】有福利：

RocketMQ / MyCAT / Sharding-JDBC 所有源码分析文章列表

RocketMQ / MyCAT / Sharding-JDBC 中文注释源码 GitHub 地址

您对于源码的疑问每条留言都将得到认真回复。甚至不知道如何读源码也可以请教噢。

新的源码解析文章实时收到通知。每周更新一篇左右。

认真的源码交流微信群。

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

我相信看到这篇文章的同学，大多数都不缺笔记工具——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，期望它让你愿意”先甩”——能做到这点，已经赢了一半。