codexu/note-gen · 上手攻略
- 仓库：codexu/note-gen
- 链接：https://github.com/codexu/note-gen
- 分类：ai（AI 笔记 · 本地优先）
- 作者：Tom
- 更新：2026-08-27
是什么
NoteGen 是一款本地优先的 Markdown AI 笔记应用，核心理念是"先捕获，后整理"——把灵感、语音、图片、链接等各种碎片先一股脑存下来，回头再挑选素材组织成结构化笔记。它不是要替代你的 Markdown 编辑器，而是给普通 Markdown 文件加上 AI 聚合、智能搜索和知识库的能力。
GitHub Stars：12685（数据截至 2026-08，工作队列标记）。
解决什么问题
日常记录中最大的痛苦是"还没整理就已经忘了"。微信文章、播客片段、语音灵感、截图——这些东西散落在不同 App 里，时间一久就找不到了。NoteGen 的解法是：
- Capture（捕获）阶段：随手记，不用分类，不用起标题，先存下来。
- Organize（整理）阶段：按标签/时间/类型筛选相关记录，交给 AI 按模板聚合成一篇 Markdown。
- Write（写作）阶段：在 Tiptap 编辑器里继续改写，输出纯 Markdown 文件，可以扔进 Git 或任何编辑器。
NoteGen 还带 AI Chat（问答）、Agent 模式（替你操作笔记文件）、知识库（向量检索 + 全文搜索）、MCP 服务器（让 AI 工具直接操作你的笔记）和 Canvas 白板（画流程图/思维导图）。
快速安装
桌面端（推荐）
| 平台 | 状态 | 下载地址 |
|---|---|---|
| Windows | Beta | https://notegen.top/en/download |
| macOS（Apple Silicon / Intel） | Beta | https://notegen.top/en/download |
| Linux（AppImage / DEB / RPM） | Beta | https://notegen.top/en/download |
| Android | Alpha（ARM64） | https://notegen.top/en/download |
| iOS | Alpha（TestFlight） | https://testflight.apple.com/join/8KjFRTCq |
也可从 GitHub Releases 下载最新安装包：
https://github.com/codexu/note-gen/releases/latest
AI 模型配置（非必须，但建议）
NoteGen 内置了免费模型额度。如需接入自己的模型（支持 OpenAI 兼容接口）：
- Settings → Model Configuration
- 添加 Provider（OpenAI / Claude / Gemini / Kimi / GLM / DeepSeek 等）
- 分别配置主模型、补全模型、写作模型、Embedding 模型和知识库模型
注意：国内用户可使用 SiliconFlow、302.AI、Infostar 等平台获取低价 OpenAI 兼容 Key（详见 GitHub 主页赞助商）。
核心用法
1. 快速捕获记录
打开 Record 面板，支持创建以下类型的记录：
- 文本记录：直接输入文字想法
- 语音记录：录音转文字（需要配置 TTS/ASR 模型）
- 截图/图片：内置 OCR 识别（需要视觉模型）
- 链接：保存 URL，自动抓取页面摘要
- 文件附件：直接挂文件
- TODO：记录待办事项
所有记录支持标签、时间筛选和类型筛选。
2. 将记录组织成笔记
- 在 Record 面板筛选/选中相关记录
- 选择内置模板（会议纪要、研究报告、文章、总结）或自定义描述需求
- AI 将选中文本聚合成一篇结构化 Markdown
- 在编辑器里继续改写
3. Markdown 编辑器
内置 Tiptap 编辑器，支持：
- 表格、任务列表、代码块（语法高亮）、数学公式（Mermaid/KaTeX）
- 多级标题、大纲视图
- 图片插入、附件链接
- 源码模式 / 所见即所得切换
- 全局搜索替换
4. AI Chat 与 Agent
- Chat：基于当前笔记/知识库回答问题，支持引用溯源
- Agent（需审批）：AI 读取/修改笔记、文件夹、标签、记录和记忆，操作前需用户确认
5. 知识库（Knowledge Base）
# 知识库支持向量检索 + 全文搜索
# 配置 embedding 模型（在 Settings → Model Configuration）
# 可用笔记、记录或整个知识库作为对话上下文
6. MCP 服务器（桌面端）
NoteGen 可以作为 MCP Server 被 AI 工具调用，在 Settings → MCP 中开启后，可让 Cursor、Windsurf、Claude Code 等工具直接读写你的笔记。
7. 多设备同步
支持以下同步服务（Settings → Sync）：
| 服务 | 类型 |
|---|---|
| GitHub / GitLab / Gitee / Gitea | Git |
| S3 兼容存储 | 对象存储 |
| WebDAV | 文件同步 |
所有笔记以纯 Markdown 文件存储，同步后可用任意编辑器打开，不依赖 NoteGen 格式。
典型适用场景
- 会议记录：会中实时录语音/截图 → 会后选记录 → AI 整理成会议纪要
- 读书/研究：保存零散的链接、截图和想法 → 定期聚合成研究笔记
- 周报撰写：按周收集工作记录 → 聚合成结构化周报
- 多工具切换者：在 Notion/Obsidian/Notability 间来回横跳，想统一到 Markdown 生态
- 本地优先隐私党：笔记存在本地，通过 Git/S3 同步，不上传到任何云服务
坑与注意
- iOS/Android 端功能受限：部分 AI 功能（尤其是 Agent 模式和 MCP 服务器）仅桌面端支持，移动端主要是捕获+阅读。
- AI 功能需要 API Key：内置免费额度有限，长期使用建议配置自己的 OpenAI 兼容 Key。
- 模型配置分散：主模型、补全、写作、Embedding、Rerank 需要分别配置，初次配置稍繁琐。
- 同步需要自建：官方不提供官方云同步，Git/S3/WebDAV 需要用户自己搭建，Git 同步可能产生冲突（建议单人使用或多设备错开时间）。
- 中文语音识别：依赖 ASR 模型，NoteGen 本身不内置中文 ASR，需要额外配置。
- License：GPLv3，对商业闭源项目有传染风险，如需集成到商业产品请注意。
与同类对比
| 工具 | 本地优先 | AI 聚合 | 纯 Markdown | MCP 支持 | 适合人群 |
|---|---|---|---|---|---|
| NoteGen | ✅ | ✅ 记录→笔记 | ✅ | ✅ | 需要 AI 辅助整理碎片信息的写作者 |
| Obsidian | ✅ | ⚪ 插件实现 | ✅ | ⚪ | 知识图谱深度用户 |
| Logseq | ✅ | ⚪ 插件实现 | ✅ | ⚪ | 大纲/双向链接爱好者 |
| Notion | ❌ | ⚪ | ❌ | ❌ | 团队协作优先 |
NoteGen 的差异化在于记录级别的捕获 + AI 聚合 + 纯 Markdown 输出三合一，而不是单纯做笔记或单纯做 AI。
一句话推荐结论
如果你受够了"收集了一堆素材却懒得整理"的死循环，NoteGen 的"先随手记、AI 帮你串"工作流值得一试——尤其是配合 OpenAI 兼容 Key 使用，体验最完整。
参考来源
- GitHub README：https://github.com/codexu/note-gen
- 官方文档：https://notegen.top/en/docs
- 下载页面：https://notegen.top/en/download
- GitHub Releases：https://github.com/codexu/note-gen/releases/latest