NoteGen 完全教程:先记录、后整理的 AI Markdown 笔记应用

大多数笔记软件都有一个隐含假设:你记录的时候就该想好标题、目录和结构。可现实是,灵感、会议要点、待读链接出现的时候,你根本没时间整理——先开目录、想标题,想法早凉了。NoteGen 反着来:它的口号是「Capture first. Organize later.(先记录,后整理)」,先把碎片无压力地存下来,之后再让 AI 帮你把同一主题的记录整理成一篇结构完整的 Markdown 笔记。

NoteGen 是国产开发者 codexu 的开源项目(GPL-3.0,GitHub 约 1.3 万 star,更新非常活跃),基于 Tauri + Next.js 构建,本地优先:所有笔记就是你自己工作区里的普通 Markdown 文件,不绑任何云端格式。本文从下载安装开始,完整讲一遍它该怎么用:记录流、编辑器、AI 配置与整理、知识库(LLM Wiki + RAG)、多端同步与自建服务,最后谈适用人群与注意事项。

一、下载与安装

NoteGen 覆盖桌面与移动全平台,从官网 notegen.top 或 GitHub Releases 下载:

  • Windows:安装包(Beta)
  • macOS:区分 Apple Silicon 与 Intel 两个版本(Beta)
  • Linux:AppImage、DEB、RPM 三种包(Beta)
  • Android:APK 安装包(Alpha,仅 ARM64)
  • iOS:通过 TestFlight 加入测试(Alpha)

桌面端是主力,功能最完整;移动端定位是随手记录的入口(碎片先记到手机上,回到电脑再整理),这与它的产品哲学正好对应。安装后第一次启动只需要做一件事:选择工作区——一个本地文件夹,今后所有笔记都以 .md 文件的形式存放在里面。这个目录你可以放在本地硬盘、NAS 映射盘或任何同步盘里,后文的同步章节会讲官方的几种方案。

二、核心工作流:记录 → 选择 → 整理 → 成稿

NoteGen 把「记笔记」拆成两个阶段,理解这条主线,其余功能都是围绕它展开的。

第 1 步:随手记录(Capture)

记录入口刻意做得毫无负担,不用选目录、不用起标题。可以记的内容包括:一句话想法、语音录音、截图、图片、网页链接、文件、待办事项。浏览器里看到好文章,先用官方剪藏扩展(note-gen-clipper)把选中文字、图片或链接一键存进来;开会时先录音加截两张图,其余的会后再说。每条记录自动带上时间和标签维度,先攒着。

三个入口建议优先用熟:一是桌面端的快速记录,想法冒出来时随手敲一句、贴一张截图就走,不切换上下文;二是手机端记录,通勤、排队时的灵感和语音先落在手机上,开了同步后回到电脑自动汇合;三是浏览器剪藏,把「稍后阅读」从收藏夹(大多数人的收藏夹是只进不出的)改成真的会进入整理流的记录。记录阶段唯一值得做的动作是顺手打一个粗粒度标签(如 #工作、#学习、#项目名),这是后面筛选整理的抓手,除此之外什么都不用管。

第 2 步:选择素材(Select)

要成文时,按标签、时间、类型把相关记录筛出来,勾选属于同一主题的那些。比如「本周所有打了 #项目A 标签的记录」「今天会议的录音+截图」。

第 3 步:AI 整理(Organize)

选好素材后,挑一个模板(或直接用一句话描述你想要的形态),NoteGen 调用你配置的大模型,把碎片整理成一篇结构化的 Markdown:会议记录变会议纪要、链接堆变调研笔记、一周记录变周报。整理提示可以这样写:

把选中的记录整理成一篇会议纪要,包含:
1. 会议结论(先说结论)
2. 讨论要点(按议题分小节)
3. 待办事项(用任务列表,注明负责人)
语气正式,删掉口语和重复内容,截图用一句话说明内容后以图片形式插入对应位置。

第 4 步:继续写作(Keep writing)

生成的稿子直接进编辑器,你在它基础上改结构、补细节、换成自己的话。它不是「AI 替你写完」,而是帮你把最耗时的「从碎片到初稿」这一步做掉。成稿就是一篇普通 Markdown,大致长这样:

# 项目 A 周会纪要(2026-11-21) ## 结论 - 灰度发布时间推迟到下周二,先补齐回滚脚本 - 数据库迁移方案采用方案 B ## 待办 - [ ] 张三:补齐回滚脚本(周一前) - [ ] 李四:输出迁移演练报告 ## 讨论要点 ### 性能压测结果 ……

三、编辑器:一个合格的 Markdown 工作台

抛开 AI,NoteGen 本身也是一个功能完整的 Markdown 编辑器,日常写作不依赖 AI 也能用:

  • 语法支持:表格、任务列表、代码块、数学公式、图表(Mermaid 类)、文档大纲
  • 双模式:Markdown 源码模式与可视化编辑模式可切换,源码党和所见即所得党都照顾到
  • 编辑辅助:查找替换、图片与附件管理、文件间链接与引用
  • 产出:导出与打印、文件历史版本、工作区管理

最重要的一点是数据形态:笔记就是工作区里的 .md 文件,你随时可以用任何其他编辑器打开、放进 Git 管理、打包搬走,不存在「导出即降级」的锁定问题。NoteGen 是在这些文件之上叠加记录、AI、搜索和整理能力,而不是取代文件本身。对运维和开发来说,这意味着笔记可以顺手纳入自己的 Git 仓库和备份体系。

另外它还内置了画布(Canvas):流程图、思维导图、时间线、手绘、数据图表都能建,适合用图表达的材料;AI 生成的图表也不是死图,创建之后仍然可以继续编辑。

四、配置 AI:按用途分模型

NoteGen 的 AI 能力全部走你自己配置的模型服务。在设置里添加服务商(填入接口地址与 API Key,可接各家云端模型与 OpenAI 兼容接口),然后按用途分别指定模型,这是它设计得比较专业的地方:

  • 对话/整理模型:主力,负责整理记录、问答、Agent 模式,建议用能力强的
  • 写作模型:续写、缩写、扩写、改写、翻译等文本加工
  • 嵌入模型(Embedding):给知识库做向量检索用(见第五节)
  • 视觉/OCR 模型:识别图片内容、提取截图里的文字
  • 语音模型:把录音记录转成文字,语音记录靠它进入整理流

分开配的好处是成本与效果可控:整理和问答用旗舰模型,OCR、转写、嵌入这些「工序型」任务用便宜快速的小模型即可。配好之后,AI 能做的事包括:把选中记录整理成文、对选中文本续写/缩写/扩写/改写/翻译、就笔记与记录内容提问、根据笔记生成图表,以及用 Agent 模式处理多步骤的长任务。所有 AI 产出都落回可编辑的文本,最终保留什么由你决定。

进阶玩家还可以玩三样东西:长期记忆(让 AI 记住你的偏好与背景)、可复用提示词(把常用整理模板存下来)、MCP 服务与可安装 Skills(给 Agent 模式扩展外部工具与固定工作流)。

五、知识库:LLM Wiki + RAG

笔记攒多了之后,NoteGen 提供两种「让旧资料活起来」的机制,解决的问题不同,建议分开理解:

  • LLM Wiki:用对话模型把你选定的笔记、记录、画布提炼成一组可编辑的主题 Wiki 页(摘要页+专题页,带原文引用链接可回溯出处)。首次生成后,源材料变化时 Wiki 会随之更新——相当于一个自动维护的知识综述层。适合「我写过很多零散笔记,想要一份随时最新的主题总览」
  • RAG 向量检索:单独开启后,用嵌入模型给原始材料建向量索引,提问时按语义(而不是关键词)找回相关原文,再交给模型作答;关键词与模糊搜索同时存在,还可加 reranker 重排提高精度。适合「资料太多记不住在哪,直接问」

Agent 模式回答问题时可以同时引用 Wiki 页与 RAG 找回的原文,相当于先看综述、再查原文。对个人知识管理来说,这套组合的意义是:记录时不用为「将来怎么找」焦虑,碎片尽管记,检索和综述交给工具。

六、同步:四条路线,按你的偏好选

本地优先不等于不能多端。NoteGen 在 设置 → 同步 里提供四类方案(各平台可用项略有差异):

  • 官方同步(Beta):注册同一账号,桌面与移动端自动同步工作区文件、附件与部分个人数据。最省事,适合不想折腾的人
  • 自建同步服务:官方同步服务本身也是开源的(note-gen-server 仓库),可以部署在自己的服务器上,账号与数据都握在自己手里——这是运维用户最值得看的一条路线
  • 第三方存储:GitHub、GitLab、Gitee、Gitea(把笔记仓库当同步介质,顺带白嫖版本历史)、S3 兼容对象存储、WebDAV(如坚果云、NAS 自建 WebDAV)
  • 云盘文件夹:把工作区直接放在 iCloud/OneDrive/同步盘目录里,借现成同步盘完成多端一致

选型建议:怕麻烦用官方同步;数据敏感、自有服务器用自建服务或 WebDAV/Git;已经在用 Git 管配置的人,把笔记仓放 Gitea/GitHub 是最顺手的。无论选哪条,都建议再保留一份本地备份(NoteGen 支持不开云同步的本地备份),同步不是备份——同步会把误删也同步过去,备份才是后悔药。

七、典型使用场景

  • 会议工作流:会上只管录音+截图,会后勾选记录一键成纪要,待办直接落成任务列表
  • 调研与学习:一周内随手存链接和摘录,周末按标签筛选整理成一篇调研笔记,再让 LLM Wiki 把它沉淀进主题页
  • 周报/月报:日常工作记录打好项目标签,到期按时间+标签筛选生成初稿,比翻聊天记录拼凑快得多
  • 运维值班记录:故障处理过程随手记(命令输出截图、告警链接、处理步骤),事后整理成复盘文档,长期积累还能进知识库供下次故障时 RAG 检索
  • 个人知识库:读书笔记、剪藏文章、灵感碎片持续进入,靠 Wiki+RAG 解决「记过但找不到」

以周报为例,筛选出本周记录后的整理提示词可以这样写,出来的稿子基本只需要改数字和措辞:

根据选中的本周工作记录,生成一份周报,要求:
- 按项目分组,每组先一句话总结进展,再列关键事项
- 单独一节「问题与风险」,只写记录里提到的问题,不要推测
- 单独一节「下周计划」,从记录里的待办和未完成事项推导
- 删除闲聊、重复表述,总长度控制在 800 字以内

这类模板建议存成「可复用提示词」(第四节提到过),下次一键套用。会议纪要、复盘、调研综述各存一个模板,NoteGen 的整理环节就从「每次想提示词」变成「选模板点按钮」,这是它从尝鲜变日用的关键一步。

八、与同类工具的定位差异

免得读者纠结选型,把 NoteGen 和几个常见工具的定位差异说清楚:

  • 对比 Obsidian:同为本地 Markdown,Obsidian 强在插件生态与双链图谱,适合愿意精心维护知识体系的人;NoteGen 强在「记录→AI 成稿」这条流水线和开箱即用的 AI/同步,适合没时间维护体系、只想让碎片自动成文的人
  • 对比 Logseq:Logseq 是大纲+块引用范式,适合日记流与任务管理;NoteGen 是文档范式,长文成稿更顺手
  • 对比语雀/Notion:云端协作与数据库视图是它们的强项,但数据在云端、私有化与离线受限;NoteGen 是本地优先、单人知识管理取向,团队实时协作不是它的菜
  • 对比 flomo 等轻笔记:轻笔记止步于「记」,NoteGen 多了「整理成文+知识库」这后半程

一句话:你的痛点若是「记得多、整理难、找不回」,NoteGen 对症;若是「多人协作写文档」,它不是为此设计的。

九、注意事项

  • 成熟度:桌面端为 Beta、移动端为 Alpha,迭代很快(仓库近 2000 次提交、170 多个版本),尝鲜没问题,但重要资料请保持备份习惯,别把唯一副本压在任何单一工具上——好在它的数据就是普通 .md 文件,最坏情况换个编辑器即可打开
  • AI 效果取决于模型:整理质量、问答准确度与所配模型强相关,且使用云端模型时,被整理的记录内容会发送到对应服务商,涉密材料建议配本地/自建模型或干脆不用 AI 整理
  • 先建习惯,再开功能:不要一上来就配齐 Wiki、RAG、MCP 全部功能。先把「随手记」这个动作跑顺,两周后自然会想整理,届时再配 AI 与同步也不迟
  • 许可证:GPL-3.0 开源,个人使用无限制;二次开发分发需遵守 GPL 条款

十、小结

NoteGen 值得一试的理由很具体:它把笔记的门槛降到了「先记下来再说」,又用 AI 把最痛苦的整理环节接了过去,同时坚持本地 Markdown 文件不锁定数据。适合记录量大、碎片多、又懒得维护目录体系的人,尤其是会议、调研、值班这类「过程杂、产出要成文」的工作流。如果你正在 Obsidian、Logseq、语雀之间犹豫,可以把 NoteGen 装上跑一周——它是否合手,取决于你缺的到底是编辑器,还是一个不打断思路的记录入口。

发表回复

后才能评论