NoteGen：让 Markdown 笔记与 AI 共舞的跨平台工具

先捕获，再整理：一位开发者的灵感管理哲学

清晨通勤的路上，你突然想到一个绝妙的创业点子；深夜调试代码时，某行逻辑让你灵光一现——这些稍纵即逝的灵感，如果只能用微信对话框草草记录，回头早已淹没在几百条消息的洪流里。NoteGen 正是为解决这一痛点而生：它倡导「先捕获，后整理」（Capture first, organize later）的笔记哲学，让你在灵感迸发的瞬间快速记录，随后再交给 AI 助手帮你归纳整理成结构化的 Markdown 文档。

图1：NoteGen 主界面，支持 Markdown 富文本编辑与 AI 对话协作

NoteGen 的开发者 codexu（GitHub @35381655）是一位深耕笔记工具领域的独立开发者。他发现市面上的笔记应用要么过于简陋（纯文本编辑器），要么过于臃肿（Notion、Obsidian 的功能堆砌），而他真正需要的，是一款既保留 Markdown 纯粹性、又具备 AI 辅助整理能力、还能跨平台同步的轻量级工具。于是 NoteGen 诞生了。

核心技术架构：Tauri + Next.js 的精妙组合

NoteGen 在技术选型上不走寻常路。它没有选择 Electron（内存占用大、启动慢），也没有选择纯原生开发（开发效率低），而是采用了 Tauri 2.0 + Next.js 15 + React 19 + Tailwind CSS 4 的组合。这种架构的好处在于：Next.js 负责所有 UI 渲染和业务逻辑，Rust 后端通过 Tauri 插件系统提供系统级能力（文件系统、剪贴板、系统快捷键、自动启动等），两者通过 IPC 通信，各司其职。

具体来说，Tauri 后端集成了大量插件：

• tauri-plugin-fs / tauri-plugin-store：本地文件系统的读写和配置存储
• tauri-plugin-clipboard-manager：剪贴板监控，监听系统剪贴板内容变化
• tauri-plugin-global-shortcut：全局快捷键注册（Windows/Linux/macOS）
• tauri-plugin-sql（SQLite）：笔记元数据和 RAG 向量数据库的存储
• tauri-plugin-http：支持代理和 SOCKS5 的 HTTP 请求
• tauri-plugin-dialog：原生文件选择/保存对话框
• reqwest（Rust HTTP 客户端）：支持 WebDAV 同步协议
• jieba-rs：中文分词（TextRank 算法），用于笔记内容的关键词提取
• Windows OCR（Windows 专有）：集成 Windows.Media.Ocr 引擎，支持截图文字识别

前端则基于 TipTap 3.19（ProseMirror 的 React 封装）构建富文本编辑器，支持 Markdown 语法高亮、代码块（通过 lowlight）、数学公式（@tiptap/extension-mathematics）、Mermaid 图表、表格等高级功能。编辑器还内置了 slash command 面板、浮动工具栏、拖拽手柄等交互优化。

AI Agent 系统：让 AI 真正「动手」操作笔记

NoteGen 最核心的创新在于它的 Agent 系统。传统 AI 笔记工具只能让你复制粘贴 AI 生成的内容，而 NoteGen 的 Agent 可以直接在笔记编辑器里「动手」操作。

工具注册与调用

NoteGen 内置了一个完整的 Agent 工具注册体系，定义在 src/lib/agent/tools/ 下：

• editor-tools：在编辑器中执行插入、替换、删除、追加等操作
• mark-tools：管理标签（Tag）、收藏（Mark）系统
• folder-tools：创建、移动、删除文件夹
• note-tools：笔记级别的 CRUD 操作
• canvas-tools：画布视图的操作
• memory-tools：调用记忆上下文服务
• attachment-tools：附件管理
• web-tools：网页搜索（需配置 API Key）
• chat-tools：对话管理

每个工具都有风险等级标注（MUTATING_TOOL_RISKS），涉及编辑器写入、文件操作等高风险操作时需要用户二次确认（AgentPermissionEngine）。

上下文管理与多轮对话

AgentContextManager 负责维护对话上下文，追踪 AgentStep（每轮 Agent 思考+执行的完整单元）和 ToolCall（每次工具调用）。最大支持 30 轮对话（ABSOLUTE_MAX_MODEL_ROUNDS），防止无限循环。如果连续 2 轮 AI 没有产生进展（MAX_CONSECUTIVE_NO_PROGRESS_ROUNDS），会自动终止。

RAG（检索增强生成）

NoteGen 内置了完整的 RAG pipeline：

1. 用户笔记通过 jieba-rs 中文分词 + TextRank 算法提取关键词
2. 文本块通过 embedding 模型向量化，存入 SQLite 向量数据库
3. 对话时，Agent 从向量库中检索相关笔记片段，作为上下文注入 prompt
4. 通过 getRagAgentPolicy 注入 RAG 策略，控制检索行为

RAG 设置页面支持配置 embedding 模型参数。

MCP（Model Context Protocol）支持

NoteGen 原生支持 MCP 协议，可以连接外部 AI 能力扩展。在 src-tauri/src/mcp_runtime.rs 中实现了完整的 MCP Runtime，用户可以在设置中添加 MCP 服务器（如 Claude Desktop 的扩展工具），NoteGen 会自动将 MCP 工具目录注入 Agent 工具集。这意味着 NoteGen 的 AI 能力是开放的、可扩展的。

多平台同步：从 WebDAV 到 Git

NoteGen 的同步功能非常全面：

• WebDAV：支持自建 WebDAV 服务器（如群晖、坚果云、Nextcloud）
• GitHub / Gitee / GitLab：直接连接 Git 仓库作为笔记存储后端
• S3 兼容存储：支持任意 S3 协议的对象存储
• Gitea：对 Gitea 平台有专项优化

同步采用冲突检测机制，当本地与远程不一致时会弹出冲突解决对话框，支持手动选择保留版本或对比合并。

隐私与安全：数据主权完全属于用户

NoteGen 的隐私设计理念非常明确：你的笔记永远属于你自己。所有笔记数据默认存储在本地文件系统（AppData/Local/NoteGen），无需注册账号，无需云端同步（除非你主动配置）。AI 对话数据默认不上传（除非使用云端 LLM API），用户可完全自托管 AI 模型。

对于企业用户，NoteGen 支持本地部署，完全离线使用，数据不出内网。

局限与争议

1. AI 能力依赖 API Key：NoteGen 本身是笔记工具，AI 能力需要用户自行配置 LLM API（OpenAI、Claude、SiliconFlow 等）。纯本地使用只能当普通 Markdown 编辑器。
2. Tauri 编译门槛：虽然有预编译安装包，但从源码编译需要 Rust 工具链，对非开发者用户有一定门槛。
3. 功能复杂度过高：NoteGen 的功能极其丰富（Agent、RAG、MCP、同步、OCR、画布……），新用户的学习曲线较陡。
4. License 争议：NoteGen 采用 GPL-3.0 开源，但核心 AI 功能通过云服务（SiliconFlow 合作）提供，存在一定的开源协议争议——GPL-3.0 要求修改版本的源码也必须开源，但云端 API 调用是否构成「修改」仍有争议。

总结与趋势

NoteGen 是目前 GitHub 上 Star 数最高的 AI 笔记应用之一（12,345★），代表了「AI + 本地优先 + Markdown」这一细分赛道的标杆方向。它展示了一个趋势：未来的笔记工具不是 AI 的载体，而是 AI 的工作台——AI 不是在笔记里生成文字，而是直接操作笔记里的内容。

如果你需要一个功能强大的本地 Markdown 编辑器，同时希望 AI 能真正帮你整理笔记而非仅仅生成文字，NoteGen 值得一试。如果你追求极简，纯粹的 Typora 或 VS Code 可能更合适。

---

技术关键词：Tauri 2.0 · Next.js 15 · React 19 · TipTap 3 · RAG · MCP · WebDAV · SQLite向量库 · jieba-rs · Windows OCR · Rust IPC