NoteGen：本地优先的 Markdown 记录与 AI 整理应用
NoteGen 是一款本地优先（local-first）的 Markdown 应用，主张“先记录、后整理”：先把灵感、语音、截图、链接、文件、待办等零散信息快速保存，再按标签、时间或类型筛选素材，交给 AI 整理成结构化的 Markdown 笔记。笔记以普通 Markdown 文件保存在用户自选的 workspace 中，可被其它编辑器打开、纳入 Git 或自由迁移；项目同时提供知识库检索、画布、MCP、Skills 与多平台同步能力，采用 GPL-3.0 许可证开源。
社区作者 · zZz
它解决什么问题
项目定位
NoteGen 的口号是“Capture first. Organize later.”（先记录，后整理）。它面向的核心痛点是：一个想法可能始于一句话、一段录音、一张截图或一个还没来得及读的链接，而用户在保存它之前不应该被迫先决定标题、文件夹和结构。
因此 NoteGen 把“记录”和“整理”拆成两个环节：先按信息原本的样子保存；之后再挑选彼此相关的记录，交给 AI 整理成结构化的 Markdown 笔记；最后在编辑器中复查、补充自己的思考并继续写作。项目明确表示，目标不是让 AI 替你写完一切，而是让有用的碎片在你把它变成完整内容之前不要消失。
配图 1 展示了 NoteGen 在桌面端与移动端的界面形态。
工作流（来源明确给出的四步）
- 记录当下发生的事：趁记忆新鲜时保存想法、录音、截图、图片、链接、文件或待办。
- 选择素材：按标签、时间或类型过滤记录，勾选应当归到一起的条目。
- 整理记录：选择一个模板，或直接描述你想写什么；NoteGen 可以把选中的素材整理成摘要、报告、文章或其它 Markdown 结构。
- 继续写作：在编辑器中审阅草稿，调整结构、补充细节，并用自己的语言接着写。
实际使用示例（来源列举）
- 记录会议片段并附上两张截图，事后整理成会议纪要。
- 一周内保存链接和阅读片段，之后整理成一份研究笔记。
- 按标签筛选近期记录，制作周报，无需在多个应用之间来回翻找。
- 围绕某个主题收集图片和文档，再以这些材料作为上下文进行提问。
围绕 Markdown 文件构建
用户写下的笔记始终是保存在自选 workspace 中的普通 Markdown 文件。你可以用 NoteGen 编辑，也可以用其它 Markdown 编辑器打开，放进 Git 管理，或直接移动文件，而不需要从私有格式中导出。NoteGen 是在这些文件之上增加记录、AI、搜索与整理能力，而不是取代它们。
编辑器支持：
- 表格、任务列表、代码块、数学公式、图表与文档大纲
- Markdown 源码模式与可视化编辑
- 查找与替换
- 图片、附件、链接与文件引用
- 导出与打印工具
- 文件历史与 workspace 管理
AI 能力
NoteGen 连接用户自行配置的 AI 提供商与模型，可以分别使用不同模型处理对话、写作、嵌入（embeddings）、图像识别、OCR 与音频。AI 可用于：
- 把选中的记录整理成结构化笔记
- 对已有文本续写、缩写、扩写、改写或翻译
- 针对笔记、记录、图片与知识库内容提问
- 在回答前先检索本地材料
- 根据笔记生成图表与图形
- 通过 Agent 模式处理较长的任务
AI 是工作流的一部分，但结果始终可编辑，由用户决定保留什么。
检索与复用
笔记写完之后仍应继续有用。NoteGen 可以从你的文件中构建可搜索的知识库，并把语义检索与本地文本搜索结合起来。用户可以把一条笔记、一组记录或整个知识库作为对话上下文，而不必把全部内容复制进新的提示词。高级工作流还支持：
- 向量索引与混合检索
- 可配置的 embedding 与 reranking 模型
- 长期记忆与可复用提示词
- MCP 服务器
- 可安装的 Skills
- 用于操作笔记与文件的 Agent 工具
画布工作区
NoteGen 内置面向可视化素材的画布，可创建与编辑：流程图、思维导图、时间线、手绘、数据图表，以及由笔记内容生成的示意图。画布元素创建后仍可编辑，包括 AI 建议的内容。
同步方式
笔记首先存储在本地；需要跨设备时，可通过用户已有的服务同步。支持的选项包括 GitHub、GitLab、Gitee、Gitea、S3 兼容存储与 WebDAV。也可以不开启云同步，只保留本地备份。
相关仓库
- note-gen-docs：官网、双语文档与下载页。
- note-gen-server：同步服务与账号管理，支持自托管。
- note-gen-clipper：浏览器扩展，用于把选中文本、图片与页面链接保存到 NoteGen。
- note-gen-plugin-sdk：用于开发 NoteGen 插件的 TypeScript API、项目脚手架、CLI 与测试工具。
- note-gen-plugins：官方插件源码与插件市场发布工具。
社区与致谢
项目欢迎贡献代码，提 PR 前需阅读贡献指南；也可以报告缺陷、提出改进建议、参与讨论或浏览开放的 PR。配图 4 为 NoteGen 贡献者头像墙，配图 5 显示项目获得 HelloGitHub 推荐。NoteGen 使用 BrowserStack 进行测试，并获得 SiliconFlow 的模型服务支持，以及七牛云、302.AI、算力云（ShengSuanYun）、Gitee AI、Netlify、Skywork 等服务支持。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
准备
- 确认你的设备属于已支持的平台：Windows、macOS、Linux 为 Beta，Android（ARM64）与 iOS 为 Alpha。
- 准备一个用于存放 Markdown 文件的本地 workspace 目录（可稍后在应用内选择）。
- 准备 AI 提供商信息（可选）：只有在需要使用 AI 功能时才需要配置，不配置也可以先写第一条笔记。
来源说明：“你不必在写第一条笔记之前配置好每一个功能。”
下载与安装
来源给出的下载入口按平台区分：
- Windows（Beta）：Download for Windows。
- macOS（Beta）：Download for Apple Silicon 或 Intel 两个版本。
- Linux（Beta）：AppImage、DEB 或 RPM。
- Android（Alpha · ARM64）：下载 APK。
- iOS（Alpha）：通过 TestFlight 加入测试。
如上述入口不可用，可使用备用镜像：GitHub Releases（View the latest GitHub Release）。
安装时按所下载的包类型执行：Windows/macOS 运行安装包或应用包；Linux 选择 AppImage 直接运行，或安装 DEB / RPM 包；Android 安装 APK；iOS 通过 TestFlight 安装。
首次运行
- 下载适用于你平台的 NoteGen。
- 为 Markdown 文件选择一个 workspace。
- 添加第一条记录，或直接创建一条笔记。
- 当需要使用 AI 功能时，再配置 AI 提供商。
- 阅读官方文档，了解同步、知识库、MCP、Skills 与高级设置。
后续可选配置
- 同步：GitHub、GitLab、Gitee、Gitea、S3 兼容存储、WebDAV；也可只做本地备份而不启用云同步。
- 知识库：构建可搜索知识库，配置 embedding 与 reranking 模型，使用向量索引与混合检索。
- 扩展能力：配置 MCP 服务器、安装 Skills、使用 Agent 工具。
- 浏览器采集：安装 note-gen-clipper 浏览器扩展，把选中文本、图片与页面链接保存到 NoteGen。
- 自托管同步：使用 note-gen-server 提供的同步服务与账号管理。
- 插件开发：使用 note-gen-plugin-sdk（TypeScript API、项目脚手架、CLI 与测试工具），官方插件源码与发布工具见 note-gen-plugins。
常见问题与注意事项
- 数据存放位置：笔记是保存在你选择的 workspace 中的普通 Markdown 文件，可用其它 Markdown 编辑器打开、放入 Git 或直接迁移，无需从私有格式导出。
- 是否需要先配置 AI：不需要，未配置 AI 提供商也可先记录与书写；AI 仅在需要整理、续写、翻译、问答等能力时启用。
- 不同模型的分工：对话、写作、嵌入、图像识别、OCR 与音频可以分别配置不同模型。
- 版本状态：Windows/macOS/Linux 为 Beta，Android 与 iOS 为 Alpha，来源未给出各平台最低系统版本与硬件要求，相关最低运行配置待核验。
- 贡献方式：提交 PR 前请先阅读贡献指南，也可通过报告缺陷、提出建议、参与讨论或浏览开放 PR 参与。
