模型 / 数据集
codexu/note-gen avatar
codexu/note-gen

NoteGen:把碎片先存下来,再让 AI 帮你整理成 Markdown 笔记

项目速览:一款跨平台的 Markdown AI 笔记软件。这是为了确保有用的碎片在你有时间把它们变成完整的东西之前不会消失。

12,806 个 Star969 个 ForkTypeScriptGPL-3.0

秒懂

它是什么?
NoteGen 是一款本地优先的 Markdown 笔记应用,核心思路是「先捕获,后整理」。它把零散的想法、截图、录音和链接先存下来,之后再用 AI 按模板整理成结构化笔记。适合那些收集素材多、但没时间立刻成文的人。
适合谁用?
NoteGen 适合那些经常收集零散信息,但缺乏时间立刻整理成文的人。它把捕获和整理分开,让素材先安全落地,再在空闲时用 AI 辅助成稿。
能商用吗?
可以,但有条件。GPL-3.0 是 copyleft 许可证:如果你分发包含它的软件,就必须以同一许可证公开该软件的源代码。只在内部运行、不对外分发,则不会触发这项义务。
还在维护吗?
在维护。仓库最近一次提交在 2 天前。
用什么语言写的?
主要是 TypeScript(依据 GitHub 的语言统计)。

以上回答依据项目的 GitHub 数据(最近同步于 2026年9月15日)和我们的分析,不构成法律意见。

开源项目深度解析

它解决的是「来不及整理」的问题

很多人记录笔记的痛点不是没有工具,而是灵感出现时来不及选文件夹、起标题、定结构。NoteGen 的定位很明确:把捕获和整理拆成两个阶段。你可以先存一条语音、一张截图、一个链接,或者一段文字,不打断当前思路。之后有空了,再从记录里筛选相关条目,让 AI 帮你组织成一篇 Markdown 笔记。这个流程和传统笔记软件不一样,传统工具通常要求你一开始就决定笔记的存放位置和格式。NoteGen 的设计是让素材先落地,再慢慢加工。它面向的是经常收集碎片信息的人,比如开会时随手记几条、逛网页时存几个链接、拍几张白板照片的人。

工作流程:四步从碎片到成稿

README 给出了一个清晰的四步流程。第一步是捕获,保存想法、录音、截图、图片、链接、文件或待办事项。第二步是选择素材,按标签、时间或类型过滤记录,勾选属于同一主题的条目。第三步是整理,选择一个模板,或者用自然语言描述你想写什么,NoteGen 会把选中的素材组织成摘要、报告、文章或其他 Markdown 结构。第四步是继续写作,在编辑器中审阅草稿,调整结构,补充细节。这个流程的关键在于,AI 只是中间环节,最终输出是普通 Markdown 文件,你随时可以手动修改。

本地优先,但同步和 AI 依赖外部服务

NoteGen 强调本地优先,笔记文件就是你选择的文件夹里的普通 Markdown 文件。你可以用其他编辑器打开,放进 Git 管理,或者直接移动文件,不需要导出。这一点对注重数据控制权的用户很友好。但要注意,AI 功能需要连接你配置的模型提供商,比如 OpenAI 兼容接口或各种模型服务。同步功能也依赖外部服务,支持 GitHub、GitLab、Gitee、Gitea、S3 兼容存储和 WebDAV。这意味着,虽然笔记本身是本地文件,但如果你要用同步,数据会经过第三方服务器。如果你要用 AI 整理,内容也会发送到模型服务。所以「本地优先」不等于「完全离线」。

AI 功能不是全自动,而是可配置的助手

NoteGen 的 AI 功能覆盖多个场景:整理选中记录、续写、缩短、扩写、重写、翻译、问答、搜索本地素材、生成图表,甚至 Agent 长任务。你可以为不同任务配置不同模型,比如聊天用一个模型,写作用另一个,嵌入和图像识别又用别的。这种灵活性意味着你可以按需付费,不必为所有功能使用同一个高价模型。但这也带来一个门槛:你需要自己准备 API Key,并理解不同模型的能力差异。README 提到可以配置 embedding 和 rerank 模型,用于构建知识库和混合检索。这些功能对技术用户友好,但对普通用户来说,配置成本不低。

知识库与检索:把笔记变成可查的资产

除了编辑器,NoteGen 还提供知识库功能。它可以从你的文件中构建可搜索的知识库,结合语义检索和本地文本搜索。这意味着你可以用笔记、一组记录或整个知识库作为对话上下文,而不必把内容复制到提示词里。它还支持向量索引、混合检索、长期记忆、可复用提示词、MCP 服务器和可安装的 Skills。这些高级功能让 NoteGen 不只是笔记工具,更像一个个人知识管理平台。但注意,这些功能大多需要配置外部模型服务,尤其是 embedding 和 rerank 模型。如果你的模型服务不稳定,检索质量会受影响。

画布功能:用视觉方式整理素材

NoteGen 还包含一个画布工作区,适合处理适合视觉化理解的素材。你可以创建流程图、思维导图、时间线、手绘草图、数据图表,以及从笔记内容生成的图表。画布元素在创建后仍然可以编辑,包括 AI 建议的内容。这个功能让 NoteGen 不只是文本编辑器,还能处理一些结构化的视觉输出。不过,画布是否支持多人协作,README 没有提及。如果你需要团队实时协作,可能需要另找工具。画布功能目前处于什么成熟度,文档也没有详细说明。

上手成本与平台支持

安装 NoteGen 很简单,从官网或 GitHub Releases 下载对应平台的安装包即可。Windows、macOS、Linux 都是 Beta 状态,Android 是 Alpha(仅 ARM64),iOS 是 Alpha(通过 TestFlight)。这意味着桌面端基本可用,移动端还不太成熟。启动后你需要选择一个工作区,也就是存放 Markdown 文件的文件夹。然后可以添加第一条记录或直接创建笔记。使用 AI 功能前,需要配置一个 AI 提供商。README 明确说,你不需要在写第一条笔记前配置所有功能。所以你可以先本地使用,等需要 AI 时再接入模型。

局限性与替代方案

NoteGen 的 Beta 状态意味着可能存在稳定性问题,尤其是移动端。Alpha 版本的 Android 和 iOS 可能缺少关键功能,比如同步或 AI 整理。另一个局限是,AI 整理的质量取决于你选择的模型和模板,如果模型不够好,生成的笔记可能结构混乱,需要大量手动修改。此外,同步配置对普通用户不友好,需要理解 Git 或 WebDAV 的概念。如果你不想折腾这些,可以考虑 Obsidian,它同样基于本地 Markdown 文件,但同步和 AI 插件生态更成熟。Obsidian 的同步需要付费服务或第三方插件,但核心编辑器更稳定。NoteGen 的优势在于把捕获流程内置,而 Obsidian 更依赖你手动组织文件夹和标签。另一个替代方案是 Joplin,它也是本地优先、支持 Markdown,但 AI 功能不如 NoteGen 丰富。

编辑结论

NoteGen 适合那些经常收集零散信息,但缺乏时间立刻整理成文的人。它把捕获和整理分开,让素材先安全落地,再在空闲时用 AI 辅助成稿。不适合希望 AI 全自动生成最终笔记、不愿手动选择素材和审查输出的用户。也不适合对数据隐私极度敏感、完全不想让任何内容经过第三方模型服务的用户,因为 AI 功能需要连接外部模型提供商。在采用前,你应该先验证三件事:第一,你常用的同步服务(GitHub、WebDAV 等)是否被支持,配置是否顺畅;第二,你偏好的 AI 模型能否在设置中正常接入,尤其是 embedding 和 rerank 模型是否可用;第三,在 Windows、macOS 或 Linux 的 Beta 版本上,编辑器对中文输入和 Markdown 渲染是否有明显问题。NoteGen 的核心理念是让笔记保持为普通 Markdown 文件,这一点值得肯定,但 AI 整理的质量和同步的稳定性,只有在你实际使用后才能判断。

官方来源

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
社区笔记

社区笔记