note-gen 上手指南：3步装好你的跨平台 AI Markdown 笔记

note-gen 上手指南：3步装好你的跨平台 AI Markdown 笔记

【免费下载链接】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

note-gen 是一款本地优先的跨平台 AI 笔记应用：你的笔记就是硬盘上一堆普通的 Markdown 文件，Windows、macOS、Linux、iOS、Android 共用同一份数据。它替你解决的是一个很具体的问题——想法、截图、语音刚冒出来时先存下来，之后让 AI 把这些碎片整理成一篇读得下去的笔记，而不是强迫你在记录前先想好标题和目录。

这款跨平台 AI 笔记工具适合谁

先对号入座，看看它是不是为你这种用法准备的。

• 通勤碎片记录：地铁上手机弹出个灵感，或者会议里截了两张图、录了半段语音，全部先扔进"记录"区，不分类、不命名。晚上回家按标签筛出来，一键整理成结构化笔记。
• 长文写作：平时攒的链接和摘录是原材料，写作时引用它们当上下文，让 AI 续写、扩写、翻译，产出的草稿仍然是一篇你能随意删改的 .md 文档。
• 多端随时续写：电脑上写了一半的文档，切到平板继续改。因为文件本质是 Markdown，换任何标准编辑器打开都不会被格式绑架。

这三类场景的共同点是：记录与整理分离。note-gen 把"存"和"写"拆成了两个动作，这是它和传统笔记应用最大的区别。

最短路径装到电脑

这一节只回答一件事：最快怎么把 note-gen 装到你手上。它很轻量，普通电脑、普通手机都跑得动，不用担心配置不够。

• Windows：到官网下载页拿最新版本的 .msi 安装包，双击跑完向导即可。
• macOS：下载 .dmg（Apple Silicon 和 Intel 各有一版），把 NoteGen 拖进"应用程序"。首次启动若被系统拦，Control 键点击图标选"打开"放行。
• Linux：按发行版选 AppImage、DEB 或 RPM；Debian/Ubuntu 系一条dpkg -i就能装上。
• 移动端：Android 提供 ARM64 的 APK 直接安装；iOS 走 TestFlight 测试渠道。

想从源码跑？git clone https://gitcode.com/GitHub_Trending/no/note-gen后执行pnpm install再pnpm tauri dev即可，桌面端 Rust 代码在 src-tauri/src/，需要 Rust 工具链，普通用户不必折腾这一步。当前仓库版本为 0.36.0，装完可在"关于"页核对。

首启五分钟设置：把工作区指对位置

打开应用后，引导流程会依次问语言、工作区、主题，全程不超过五分钟。真正值得花心思的只有一个：工作区指到哪。

工作区就是你所有 Markdown 文件的根目录。默认位置是应用数据目录下的 article 子目录，例如 Linux/macOS 上的~/note-gen/article。想自定义的话，用Ctrl+,（macOS 是Cmd+,）打开设置，进"文件"页点"选择工作区"换目录，切换后文件列表会自动重载。

一个实用建议：直接把工作区设在云盘同步目录（OneDrive、坚果云之类）下，多设备同步就顺带解决了，不用再单独配同步服务。主题选深色浅色随意，之后随时能改。

note-gen 同步设置：三条路线怎么选

如果你不放心云盘方案，或者需要在没网的地方备份，note-gen 提供了三条官方路线，按你的身份挑一条就行。

• GitHub 路线——适合已经在用 Git 的人。创建一个私人仓库，在"设置 > 同步 > GitHub"里填入带repo权限的个人访问令牌，应用会自动建好仓库结构，还能顺便拿到完整的文件版本历史。
• WebDAV 路线——适合坚果云、Nextcloud 用户。填服务器地址和凭据后点"测试连接"，通了就能手动或定时同步。
• 本地备份路线——适合完全不想上云的人。在"备份与同步"页导出 ZIP 备份（含笔记和配置），换机器时导入即可。

我推荐的组合是：GitHub 自动同步为主 + 每月手动导一次 ZIP 备份，日常省心，极端情况也有兜底。相关实现可以翻 src/lib/sync/ 看，支持 GitHub、GitLab、Gitea、WebDAV、S3 等多种后端。

note-gen AI 配置三步走

AI 能力不配模型就用不了，但配置本身不复杂，按"接入模型 → 基于笔记问答 → 图片理解"三步递进即可。

第一步：接入模型。进"设置 > AI > 模型管理"，点"添加模型"，填完点"测试连接"确认生效。聊天、写作、嵌入、OCR 可以各用各的模型。

第二步：开 RAG 问答。进"AI > RAG 设置"，选嵌入模型（如 text-embedding-3-small）和重排序模型（如 bge-reranker-base），打开"自动索引"。之后对话时可以直接引用某篇笔记或整个知识库当上下文，AI 会先检索本地材料再回答，而不是凭空气猜。

第三步：图片理解。在"AI > 图片处理"里指定一个视觉模型，截图 OCR 和图片描述就都通了；顺手打开"剪贴板图片自动识别"，粘贴截图的瞬间就出文字。

编辑器效率工具箱

写起来顺手不顺手，就看这个箱子里的工具你用了几个：

• 编辑模式：所见即所得、分屏预览、专注模式、打字机模式四种，工具栏上随时切。长文写作切专注模式，工具栏和侧边栏全部收起。
• 图片托管：在"设置 > 图片托管"接上 GitHub、SMMS、S3 或 PicGo 等图床，粘贴的图片自动上传转链接，笔记文件里只剩 URL，不拖垮目录体积。
• 思维导图：正文里写 Mermaid mindmap 语法，或者直接用画布工作区拖流程图、时间线、图表，AI 生成的画布元素依然可编辑，不会变成一张死图。
• 版本历史：Ctrl+Shift+H调出文件的修改历史，写砸了随时回滚。
• 表格编辑：可视化编辑表格，合并单元格这类操作不用手写 Markdown 管道符。

卡住了怎么办：高频问题的排查思路

出问题时别慌，按"现象 → 先查什么 → 日志在哪看"三步走，大部分问题自己就能定位。日志统一入口：设置页找"高级 > 开发者选项 > 查看日志"，文件在~/.note-gen/logs。

• 同步失败：先查网络是否正常、访问令牌权限是否还有效（GitHub 令牌会过期），再看同步日志里的报错码，多数是令牌 scope 不够或仓库名冲突。
• AI 无响应：先用"测试连接"确认密钥有效、模型服务可达；本地 Ollama 则确认服务真的在11434端口跑着。连接测试都过不了，问题在服务端不在应用。
• 启动异常/打不开：通常是本地配置损坏，把应用数据目录里的store.json挪走再启动，能进应用就逐项重配；进不去就带着日志文件去提 issue。
• 编辑器卡顿：超长文档先关掉实时预览试试，还不行就更新显卡驱动、清理缓存。

进阶玩家再来看

基础流程跑通后，这些能让效率再上一档：

• 在应用数据目录建custom.css并在设置里启用自定义 CSS，改代码块字体、表格边框都行。
• 全局快捷键调出快速记录窗口：文字记录默认Control+Shift+T、截图Control+Shift+S、链接Control+Shift+L（源码定义在 src/config/shortcut.ts），可在"设置 > 快捷键"改。
• 建几个常用模板，通过命令面板一键插入；用 #标签 给记录分类，筛选时直接#标签名搜索。
• 多设备协作：所有设备配同一套同步服务，打开"实时同步"，冲突时靠版本历史兜底。

把它带走

note-gen 的设计很克制：本地 Markdown 打底，记录先行、整理在后，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