
NoteGen 安装配置完整指南从装好到用上 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-genNoteGen 是一款本地优先的 AI 笔记应用基于 Tauri 2 开发。你先把语音、截图、链接随手记下来再让 AI 把它们整理成结构化的 Markdown 笔记。文件就是纯文本Windows、macOS、Linux、iOS、Android 都能用。这篇指南带你走完安装、写第一篇笔记、配同步、接 AI 模型、查故障的全流程。安装先花 30 秒决定下载还是构建大多数人直接下现成的安装包就够了。只有两种情况才需要自己编译你想跟 dev 分支的最新改动或者你想改代码。系统最低要求推荐配置WindowsWindows 104GB 内存Windows 118GB 内存macOS10.1312Apple SiliconLinuxUbuntu 20.044GB 内存22.048GB 内存Android8.0ARM6410.0iOS13.015.0如果你的机器落在最低要求附近建议至少按推荐配置走。Tauri 应用不吃内存但预览大文档和跑本地 OCR 时内存会波动。按系统走最快的路Windows去项目发布页下载.msi安装包双击后跟着向导走装完在开始菜单里找 NoteGen 启动。全程不到一分钟。macOS下载.dmgApple Silicon 选 aarch64Intel 选 x86_64。打开镜像后把 NoteGen 拖进应用程序。首次启动如果被系统拦下右键点应用图标选打开确认一次即可之后就能正常双击启动。Linux发行版不同包格式不同。Debian/Ubuntu 系下.deb装的时候只需要一条命令sudo dpkg -i notegen_*.debFedora/RHEL 系下.rpm用rpm或dnf装上就行。AppImage 格式适合不想动系统包管理的场景下载后加执行权限直接跑。Android下载 APK 直接安装。目前是 Alpha 阶段只支持 ARM64 设备。iOS走 TestFlight 内测通道按项目发布说明里的邀请加入。Alpha 阶段更新节奏快遇到闪退可以等下个版本。源码构建只要三条命令环境里要提前备好 Node.js 18、PNPM 和 Rust 1.75Rust 只在构建时需要。拿到仓库后git clone https://gitcode.com/GitHub_Trending/no/note-gen cd note-gen pnpm install依赖装好后开发模式用这条命令会起一个热更新的窗口改代码秒生效pnpm tauri dev打正式安装包用这条产物在src-tauri/target/release/bundle目录里pnpm tauri build第一次启动从空目录到第一篇笔记首次启动不用急着配 AI。应用能先帮你把文件存下来AI 是后面再开的开关。先决定文件存在哪工作区工作区就是存 Markdown 文件的根目录。不动它的话文件放在应用数据目录下的article文件夹里你随时可以在设置 → 文件里换成任意本地目录。两个实用判断想让文件出现在别的软件里比如你用 VS Code 也想打开这些笔记选自己看得见的目录。想省掉手动同步把目录选在 OneDrive、Dropbox 这类云盘同步文件夹里文件本身就能跟着账号走。切换工作区后应用会重新加载文件列表旧目录里的文件不会被删除别担心。主题、语言、快捷键三分钟设完设置入口是Ctrl,macOS 是Cmd,。进去先定三件事语言中文、英文、日文、德文、巴西葡萄牙文、繁体中文都支持。主题浅色、深色或在系统切换时跟随系统。快捷键在设置 → 快捷键里改。几个常用默认值记一下新建笔记CtrlN、保存CtrlS、搜索CtrlF、全局搜索CtrlShiftF、AI 续写AltC。全部可覆盖。编辑模式挑一个顺手的编辑器顶部工具栏可以切模式CtrlShiftM循环切换所见即所得输入时直接渲染最接近 Word 的体验。分屏预览左边写右边看成品。专注模式藏掉工具栏和侧边栏适合长文。打字机模式光标停在屏幕中间往上翻不会跳。日常写短记用所见即所得写长文切专注模式。习惯写源码的人在源码模式里用纯 Markdown 也行。同步让笔记跟人走挑一种就行同步解决的是换台设备还能看见笔记的问题。NoteGen 本地存文件同步层只是把文件复制到别处三种路子各适合不同的人。GitHub 同步最稳的一条路适合所有开发者。它的本质是把工作区当一个 Git 仓库推到一个私人仓库里相关逻辑在 src/lib/sync/github.ts所以你能拿到每次同步的历史版本天然带版本控制。配置四步在 GitHub 建一个私有仓库 → 生成个人访问令牌勾上repo权限→ 在设置 → 同步 → GitHub里粘贴令牌 → 点测试通过后应用会自动建好仓库结构。然后设一个自动同步间隔10 秒到 30 分钟之间写多少存多少。代价是你得有 GitHub 账号令牌要保管好。WebDAV手里已有坚果云或 Nextcloud 的人如果你已经在用支持 WebDAV 的服务坚果云、Nextcloud、群晖走这条最省事不用再申请新账号新令牌。进设置 → 同步 → WebDAV填服务器 URL、用户名密码、远程目录点测试连接验证再用同步到远程和从远程同步两个按钮手动推拉。取舍很直白WebDAV 没有版本历史冲突处理不如 Git 细但它复用你现有的服务和额度零新增成本。本地备份上不了云也别丢前两种都嫌麻烦或者环境根本连不了外网就用本地备份。进设置 → 备份与同步点导出备份得到一个包含所有笔记和配置的压缩包存到另一块盘或U盘。恢复时点导入备份选文件即可。建议开自动备份周期设成每周保留最近 5 份。它不能替代云端同步但能兜住误删和磁盘坏了这两种最常见的事故。AI帮你写、帮你查、帮你看图AI 功能全部由你自己配的模型驱动不预置任何服务。三类模型各司其职对话/写作用主模型检索用嵌入和重排序模型看图用多模态模型同一个供应商可以全包也可以混搭。帮你写接入你的第一个模型进设置 → AI → 模型管理点添加模型按供应商填配置。常见三种OpenAI 兼容接口填 API 密钥、模型名如 gpt-4o自建网关、Ollama、DeepSeek 都走这个入口。Gemini填 API 密钥和模型名。Ollama填本地地址默认http://localhost:11434和模型名全程离线。填完点测试连接通了再用。给写作、快速补全、知识库分别指定模型是推荐做法——长文用强模型高频小补全用便宜快的模型费用能压下来一截。帮你查让 AI 翻你自己的笔记这条主线是 RAG检索增强生成。开启后应用会把你的笔记做成向量索引提问时先检索相关内容再让模型作答答案有出处不用你把上下文手动贴进对话框索引与检索的核心逻辑在 src/lib/rag.ts。两步配置给检索环节选一个嵌入模型如 text-embedding-3-small再选一个重排序模型提高命中质量然后打开自动索引笔记变更后索引定期更新。之后在对话里引用某篇笔记、某条记录或整个知识库作为上下文提问即可。帮你看图图片理解与 OCR截图里是张表格、一张白板、一段报错贴进对话就能让多模态模型直接解读。进设置 → AI → 图片处理指定一个支持视觉的模型如 gpt-4o 这类设好识别语言和描述长度上限。打开剪贴板图片自动识别后你复制的截图进应用就会自动转成文字描述配合记录功能看到就存、存了能搜这个闭环就通了。排错出问题先按这个顺序查大部分故障落在下面这张表里。先对号再看日志。症状先查什么同步不动了令牌是否过期、权限是否够网络能否到服务器同步设置页里的同步日志存在应用数据的sync_logs.json最多留 100 条AI 没反应密钥是否有效测试连接是否通过本地 Ollama 是否真的在跑大文档卡切到源码模式、关掉实时预览文档过大时分文件启动异常设置存在应用数据目录的store.json里把它移走再启动相当于重置反复出现就用设置里的删除本地数据库重建索引日志在哪求助去哪找同步日志、操作日志都落在应用数据目录在设置的开发者选项里可以直接打开开发者工具看控制台输出。还解决不了时的求助路径按顺序来项目讨论区提问把系统、版本、复现步骤写全→ 应用内帮助 → 反馈问题提交 → 关注后续版本Alpha/Beta 阶段的不少问题下个版本就修了。进阶按自己的口味改让它更快装好能写之后下面这些是把 NoteGen 用顺的加分项。自定义 CSS把编辑器改成你要的样子在应用数据目录建一个custom.css写普通 CSS 就能覆盖编辑器样式——换代码块字体、调表格边框、改主题色都可行。然后在设置里打开自定义 CSS开关刷新即生效。不用动源码换主题等于换皮肤。效率工作流与多设备协作几个高频组合全局快捷键快速记录给记录功能绑一个全局热键任何界面按一下就弹出输入框想到什么存什么不打断当前工作。模板 标签把周报、会议纪要做成模板命令面板里直接插记录随手打#标签之后按标签筛选整理。多设备所有设备配同一个同步服务GitHub 或 WebDAV同步间隔调短一点。两边同时改同一文件时用最近编辑视图核对再靠版本历史CtrlShiftH回滚或合并。命令行程序实际能接什么说点实话这套应用没有--new、--sync之类的命令行开关。它真正支持的是文件关联——在启动命令后直接跟一个 Markdown 文件路径应用会打开并定位到这篇笔记这个行为由 src-tauri/src/file_open.rs 处理双击.md文件走的是同一条通道。所以命令行场景就两个把某篇笔记直接丢给应用打开以及你自己构建时用的pnpm tauri dev/pnpm tauri build。其余操作都在应用内完成。收尾NoteGen 把先记下来和整理成文拆开用 AI 缩短两者之间的距离同时文件始终是你自己的纯文本——不绑定任何厂商格式换工具零成本。下一步如果你只用了一两个功能值得把 RAG 和自动同步都配起来前者决定它懂不懂你的笔记后者决定它跑不跑得远。【免费下载链接】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),仅供参考