企业官网建设流程全解析

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-gen

NoteGen 是一款本地优先的 AI 笔记应用，基于 Tauri 2 开发。你先把语音、截图、链接随手记下来，再让 AI 把它们整理成结构化的 Markdown 笔记。文件就是纯文本，Windows、macOS、Linux、iOS、Android 都能用。这篇指南带你走完安装、写第一篇笔记、配同步、接 AI 模型、查故障的全流程。

安装：先花 30 秒决定下载还是构建

大多数人直接下现成的安装包就够了。只有两种情况才需要自己编译：你想跟 dev 分支的最新改动，或者你想改代码。

如果你的机器落在最低要求附近，建议至少按推荐配置走。Tauri 应用不吃内存，但预览大文档和跑本地 OCR 时内存会波动。

按系统走最快的路

Windows：去项目发布页下载.msi安装包，双击后跟着向导走，装完在开始菜单里找 NoteGen 启动。全程不到一分钟。

macOS：下载.dmg，Apple Silicon 选 aarch64，Intel 选 x86_64。打开镜像后把 NoteGen 拖进"应用程序"。首次启动如果被系统拦下，右键点应用图标选"打开"确认一次即可，之后就能正常双击启动。

Linux：发行版不同，包格式不同。Debian/Ubuntu 系下.deb，装的时候只需要一条命令：

sudo dpkg -i notegen_*.deb

Fedora/RHEL 系下.rpm，用rpm或dnf装上就行。AppImage 格式适合不想动系统包管理的场景，下载后加执行权限直接跑。

Android：下载 APK 直接安装。目前是 Alpha 阶段，只支持 ARM64 设备。

iOS：走 TestFlight 内测通道，按项目发布说明里的邀请加入。Alpha 阶段，更新节奏快，遇到闪退可以等下个版本。

源码构建只要三条命令

环境里要提前备好 Node.js 18+、PNPM 和 Rust 1.75+（Rust 只在构建时需要）。拿到仓库后：

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+,）。进去先定三件事：

• 语言：中文、英文、日文、德文、巴西葡萄牙文、繁体中文都支持。
• 主题：浅色、深色，或在系统切换时跟随系统。
• 快捷键：在"设置 → 快捷键"里改。几个常用默认值记一下：新建笔记Ctrl+N、保存Ctrl+S、搜索Ctrl+F、全局搜索Ctrl+Shift+F、AI 续写Alt+C。全部可覆盖。

编辑模式：挑一个顺手的

编辑器顶部工具栏可以切模式，Ctrl+Shift+M循环切换：

• 所见即所得：输入时直接渲染，最接近 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 这类），设好识别语言和描述长度上限。

打开"剪贴板图片自动识别"后，你复制的截图进应用就会自动转成文字描述，配合记录功能，"看到就存、存了能搜"这个闭环就通了。

排错：出问题先按这个顺序查

大部分故障落在下面这张表里。先对号，再看日志。

日志在哪，求助去哪找

同步日志、操作日志都落在应用数据目录，在设置的开发者选项里可以直接打开开发者工具看控制台输出。

还解决不了时的求助路径，按顺序来：项目讨论区提问（把系统、版本、复现步骤写全）→ 应用内"帮助 → 反馈问题"提交 → 关注后续版本，Alpha/Beta 阶段的不少问题下个版本就修了。

进阶：按自己的口味改，让它更快

装好能写之后，下面这些是把 NoteGen 用顺的加分项。

自定义 CSS：把编辑器改成你要的样子

在应用数据目录建一个custom.css，写普通 CSS 就能覆盖编辑器样式——换代码块字体、调表格边框、改主题色都可行。然后在设置里打开"自定义 CSS"开关，刷新即生效。不用动源码，换主题等于换皮肤。

效率工作流与多设备协作

几个高频组合：

• 全局快捷键快速记录：给记录功能绑一个全局热键，任何界面按一下就弹出输入框，想到什么存什么，不打断当前工作。
• 模板 + 标签：把周报、会议纪要做成模板，命令面板里直接插；记录随手打#标签，之后按标签筛选整理。
• 多设备：所有设备配同一个同步服务（GitHub 或 WebDAV），同步间隔调短一点。两边同时改同一文件时，用"最近编辑"视图核对，再靠版本历史（Ctrl+Shift+H）回滚或合并。

命令行：程序实际能接什么

说点实话：这套应用没有--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