如何快速上手 NoteGen：新手 5 步完成本地 AI 笔记应用的安装与部署

如何快速上手 NoteGen新手 5 步完成本地 AI 笔记应用的安装与部署【免费下载链接】note-genCapture first. Organize later. A local-first Markdown app that turns scattered records into clear notes with AI.项目地址: https://gitcode.com/GitHub_Trending/no/note-gen开会时冒出的想法、随手截的图、来不及读的链接往往在散场后就找不回来了。NoteGen 就是来解决这件事的一款本地优先的 AI Markdown 笔记应用先把碎片记下来再用 AI 把它们整理成结构清晰的笔记。这篇指南带你从环境检查到跑通本地开发环境全程不超过 5 分钟。项目速览一句话定位本地优先、以 Markdown 文件为底座的跨平台记录与写作工具用 AI 把碎片记录整理成笔记。核心能力多形态记录文本、录音、截图、链接、AI 整理与续写润色、知识库检索RAG、画布白板流程图 / 思维导图 / 时间线、多平台同步GitHub、GitLab、Gitee、Gitea、S3、WebDAV。主语言TypeScript桌面端外壳为 RustTauri 2。技术栈一览技术 / 框架版本在项目里的作用Tauri 22.x跨平台桌面壳Windows / macOS / Linux / 移动端Rust 编写Next.js15.x前端应用框架App Router Turbopack 开发模式React19.x界面渲染Tailwind CSS shadcn/uiTailwind 4样式体系与组件库TipTap / CodeMirror3.x / 6.xMarkdown 可视化编辑与源码编辑Zustand5.x前端状态管理笔记、聊天、同步等 store 见 src/stores/Mermaid / xyflow/react11.x / 12.x画布工作区的图表与流程编辑OpenAI SDK4.x接入 OpenAI 兼容协议的任意模型服务开始前的环境检查NoteGen 是「Next.js 前端 Tauri 桌面壳」的结构所以依赖分两层Node 生态负责前端Rust 工具链负责打包桌面端。只跑 Web 开发模式可以暂时没有 Rust但建议一次装齐。先确认工具链版本是否符合要求node -v # 建议 Node.js 18LTS 版本最稳 pnpm -v # 项目使用 pnpm 管理依赖建议 8 git --version # 任意近期版本即可 rustc --version # 跑 pnpm tauri dev 需要 Rust 工具链如果pnpm或rustc报 command not found分别用npm install -g pnpm和官方 Rust 安装脚本补齐再回到上一步复查。快速上手第 1 步把仓库克隆到本地代码是一切的前提。克隆下来后你拥有完整的源码、配置模板和桌面端工程src-tauri/git clone https://gitcode.com/GitHub_Trending/no/note-gen cd note-gen第 2 步用 pnpm 安装依赖项目锁文件是pnpm-lock.yaml且 Tauri 的beforeDevCommand也写死调用pnpm dev所以请用 pnpm 而不是 npm 装依赖避免锁文件不一致带来的构建偏差pnpm install安装完成后会自动执行 Tauri 的原生依赖初始化首次运行耗时较长属正常现象。第 3 步启动 Web 开发服务器先只启动前端确认整条前端链路Next.js Tailwind 各编辑组件都正常再考虑加桌面壳。这一步不需要任何密钥配置能立刻看到界面pnpm dev注意开发端口不是常见的 3000而是固定为 3456——这个值同时写在 package.json 的dev脚本和 src-tauri/tauri.conf.json 的devUrl里。第 4 步可选启动 Tauri 桌面端想在真实的桌面窗口里调试系统托盘、全局快捷键、文件关联等能力都在这一层用 Tauri CLI 启动。它会自动复用第 3 步的前端服务pnpm tauri dev第 5 步配置 AI 模型可延后NoteGen 是本地优先应用不配置任何模型也能完整使用记录、编辑、搜索功能。等需要 AI 整理笔记时再进入应用内「设置 → AI」添加模型服务即可无需改代码或环境变量。配置要点API 密钥在哪里配NoteGen 的模型接入走 OpenAI 兼容协议密钥通过应用设置界面填入不落盘到代码库。仓库的 config/provider-templates.json 预置了 SiliconFlow、阿里云百炼、Kimi、智谱 GLM、MiniMax 等服务商模板界面上选择后只需粘贴自己的 Key 和对应baseURL即可分别为聊天、嵌入Embedding、OCR 等任务指定不同模型。唯一可能用到的环境变量前端代码几乎不依赖环境变量仅 src/lib/sync/onedrive.ts 中读取NEXT_PUBLIC_MICROSOFT_CLIENT_ID用于 OneDrive 同步且有内置默认值兜底。除非你要替换成自己注册的 Microsoft 应用否则不必创建.env.local。端口开发端口 3456 被前端脚本与 Tauri 配置共同引用若需修改请同时更新package.json与src-tauri/tauri.conf.json两处否则桌面端会连不上前端。运行与验证启动后浏览器打开http://localhost:3456判断成功的标志终端输出 Next.js ready 信息浏览器加载出 NoteGen 主界面侧边栏 文件区 AI 聊天面板。随后选一个本地目录作为 Markdown 工作区新建一条记录即完成首次闭环验证。两个常见坑端口冲突3456 已被占用时终端会直接报错用pnpm dev -- -p 3457临时换端口Tauri 场景需同步改devUrl。误用 npm 装依赖npm 不会读取 pnpm 的overrides如lezer/common版本锁定可能出现编辑器解析异常的报错重装前务必先npm i -g pnpm改用 pnpm。常用命令速查命令用途pnpm dev启动 Web 开发服务器端口 3456pnpm tauri dev启动 Tauri 桌面端开发pnpm build生产构建Turbopack 清理 source mappnpm start运行生产构建产物pnpm lintNext.js 代码检查下一步建议跑通后阅读仓库内的 README.zh-CN.md了解知识库、同步与 Skills 的完整玩法多语言文案位于 messages/界面组件集中在 src/components/便于继续深入。【免费下载链接】note-genCapture first. Organize later. A local-first Markdown app that turns scattered records into clear notes with AI.项目地址: https://gitcode.com/GitHub_Trending/no/note-gen创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考