从安装到精通：note-gen全平台部署与基础设置完全指南

最新推荐文章于 2025-09-15 08:25:46 发布
原创 最新推荐文章于 2025-09-15 08:25:46 发布 · 1.1k 阅读 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

从安装到精通：note-gen全平台部署与基础设置完全指南

【免费下载链接】note-gen 一款专注于记录和写作的跨端 AI 笔记应用。 【免费下载链接】note-gen 项目地址: https://gitcode.com/GitHub_Trending/no/note-gen

项目简介

note-gen是一款专注于记录和写作的跨端AI笔记应用，基于Tauri2框架开发，支持Windows、macOS、Linux、iOS和Android多平台。应用采用原生Markdown格式存储文件，结合AI能力实现智能记录与写作辅助，同时提供多设备数据同步功能，满足碎片化知识管理需求。

核心特性

  • 轻量级设计：安装包仅20MB，无广告无捆绑软件
  • 全平台支持：Windows/macOS/Linux桌面端，iOS/Android移动端
  • AI增强功能：支持ChatGPT、Gemini、Ollama等多模型集成
  • Markdown原生：纯文本存储，格式兼容所有标准Markdown编辑器
  • 多端同步：支持GitHub、WebDAV等多种同步方案
  • 丰富编辑功能：实时预览、版本控制、图片托管、思维导图等

环境准备

系统要求

操作系统最低配置推荐配置
WindowsWindows 10+，4GB RAMWindows 11，8GB RAM
macOSmacOS 10.15+macOS 12+，Apple Silicon
LinuxUbuntu 20.04+，4GB RAMUbuntu 22.04+，8GB RAM
AndroidAndroid 8.0+Android 10.0+
iOSiOS 13.0+iOS 15.0+

依赖环境

  • Node.js 18.x+
  • Rust 1.75+（仅源码构建需要）
  • Git
  • PNPM包管理器

安装指南

预编译版本安装

Windows
  1. 访问发布页面
  2. 下载最新版本的note-gen_x.x.x_windows_x64.msi安装包
  3. 双击安装包，按照向导完成安装
  4. 安装完成后在开始菜单找到"NoteGen"启动
macOS
  1. 下载最新版本的note-gen_x.x.x_macos_aarch64.dmg（Apple Silicon）或x86_64.dmg（Intel）
  2. 打开DMG文件，将NoteGen拖入应用程序文件夹
  3. 首次启动时按住Control键点击应用，选择"打开"以绕过系统安全限制
Linux

Debian/Ubuntu：

wget https://gitcode.com/GitHub_Trending/no/note-gen/releases/download/v0.20.3/note-gen_0.20.3_amd64.deb
sudo dpkg -i note-gen_0.20.3_amd64.deb

Fedora/RHEL：

wget https://gitcode.com/GitHub_Trending/no/note-gen/releases/download/v0.20.3/note-gen-0.20.3-x86_64.rpm
sudo rpm -i note-gen-0.20.3-x86_64.rpm

源码编译安装

  1. 克隆仓库：
git clone https://gitcode.com/GitHub_Trending/no/note-gen
cd note-gen
  1. 安装依赖：
pnpm install
  1. 开发环境运行：
pnpm tauri dev
  1. 构建安装包：
pnpm tauri build

构建完成后，安装包将生成在src-tauri/target/release/bundle目录下。

基础配置向导

首次启动设置

应用首次启动后，将引导完成以下基础配置：

  1. 语言选择：支持中文、英文等多语言界面
  2. 工作区设置：选择本地存储目录（默认路径：~/note-gen/article）
  3. 主题设置：浅色/深色模式选择
  4. 同步配置：可选配置GitHub或WebDAV同步

工作区配置

工作区是存储Markdown文件的根目录，支持自定义路径和多工作区切换：

  1. 打开设置界面（快捷键Ctrl+,或Cmd+,）
  2. 进入"文件"设置页面
  3. 点击"选择工作区"按钮，选择本地目录
  4. 工作区切换会自动重新加载文件列表

提示：建议将工作区设置在云同步目录（如OneDrive、Dropbox）以实现跨设备文件同步。

快捷键配置

note-gen支持丰富的快捷键操作，可在"设置>快捷键"中自定义：

功能默认快捷键
新建笔记Ctrl+N / Cmd+N
保存笔记Ctrl+S / Cmd+S
搜索Ctrl+F / Cmd+F
全局搜索Ctrl+Shift+F / Cmd+Shift+F
格式化文档Ctrl+Shift+I / Cmd+Shift+I
AI续写Alt+C / Option+C

数据同步方案

GitHub同步

  1. 在GitHub创建私人仓库（推荐名称：note-gen-sync）
  2. 获取个人访问令牌：
  3. 在note-gen设置中：
    • 进入"同步>GitHub"页面
    • 粘贴访问令牌
    • 应用会自动创建必要的仓库结构
  4. 启用自动同步：设置同步间隔（10秒-30分钟）

WebDAV同步

适用于支持WebDAV协议的存储服务（如坚果云、Nextcloud）：

  1. 进入"同步>WebDAV"设置页面
  2. 填写服务器信息：
    • 服务器URL：如https://dav.jianguoyun.com/dav/note-gen
    • 用户名/密码：WebDAV服务的登录凭据
    • 远程路径：存储文件的远程目录
  3. 点击"测试连接"验证配置
  4. 使用"同步到WebDAV"和"从WebDAV同步"按钮手动触发同步

本地备份

定期本地备份可防止数据丢失：

  1. 进入"备份与同步>本地备份"页面
  2. 点击"导出备份"按钮，选择保存位置
  3. 备份文件格式为ZIP，包含所有笔记和配置
  4. 恢复时点击"导入备份"，选择之前保存的ZIP文件

建议：开启自动备份功能，设置每周备份并保留最近5个备份文件。

AI功能配置

模型接入

note-gen支持多种AI模型接入，包括OpenAI、Gemini、Ollama等：

  1. 进入"AI>模型管理"页面
  2. 点击"添加模型"按钮
  3. 选择模型类型并填写配置信息：
模型类型配置参数示例值
OpenAIAPI密钥、模型名称sk-xxx, gpt-4o
GeminiAPI密钥、模型名称AIzaSyxxx, gemini-pro
Ollama基础URL、模型名称http://localhost:11434, llama3
  1. 点击"测试连接"验证配置是否生效

RAG配置

检索增强生成（RAG）功能可让AI基于你的笔记内容回答问题：

  1. 进入"AI>RAG设置"页面
  2. 选择嵌入模型（如text-embedding-3-small）
  3. 选择重排序模型（如bge-reranker-base）
  4. 启用"自动索引"功能，应用会定期更新笔记向量索引

图片理解配置

配置图片理解模型以实现截图OCR和图片内容描述：

  1. 进入"AI>图片处理"页面
  2. 选择图片理解模型（如gpt-4o-vision）
  3. 配置识别语言和描述长度限制
  4. 启用"剪贴板图片自动识别"功能

编辑器高级功能

编辑模式

note-gen提供多种编辑模式满足不同需求：

  • 所见即所得模式：实时渲染Markdown格式
  • 分屏预览模式：左侧编辑右侧预览
  • 专注模式：隐藏工具栏和侧边栏，专注写作
  • 打字机模式：光标始终保持在屏幕中央

通过编辑器顶部工具栏切换编辑模式，或使用快捷键Ctrl+Shift+M循环切换。

图片管理

支持多种图片处理方式：

  1. 本地图片：直接拖放图片到编辑器，自动保存到工作区assets目录
  2. 图片托管：配置GitHub、SMMS等图床服务：
    • 进入"设置>图片托管"页面
    • 选择托管服务并填写API信息
    • 启用"自动上传"后，粘贴的图片将自动上传并转换为链接

高级编辑功能

  • 思维导图：使用Mermaid语法创建思维导图 mermaid

  • 版本历史：查看文件修改历史并恢复之前版本（快捷键Ctrl+Shift+H）

  • 代码块：支持语法高亮和一键复制

  • 表格编辑：可视化表格编辑工具，支持合并单元格等复杂操作

故障排除

常见问题解决

问题解决方案
同步失败检查网络连接，验证访问令牌权限，查看同步日志
AI无响应检查API密钥有效性，测试网络连接，确认模型服务可用
编辑器卡顿关闭大型文档的实时预览，清理缓存，更新显卡驱动
启动失败删除配置文件（~/.note-gen/store.json），以安全模式启动

日志查看

应用日志可帮助诊断问题：

  1. 打开设置页面
  2. 进入"高级>开发者选项"
  3. 点击"查看日志"按钮
  4. 日志文件路径：~/.note-gen/logs

获取支持

如果遇到无法解决的问题，可通过以下方式获取支持：

  • 项目讨论区：应用内"帮助>反馈问题"
  • 邮件支持：support@notegen.app
  • 社区群组：应用内"帮助>加入社区"

高级技巧

自定义主题

通过CSS自定义编辑器样式：

  1. 创建~/.note-gen/custom.css文件
  2. 添加自定义样式，例如： 
    /* 修改代码块样式 */
.vditor-code-block {
  font-family: "Fira Code", monospace;
  font-size: 14px;
}

/* 修改表格样式 */
table {
  border-collapse: collapse;
  width: 100%;
}
td, th {
  border: 1px solid #ddd;
  padding: 8px;
}
  3. 在设置中启用"自定义CSS"

工作流自动化

利用快捷键和自动操作提升效率：

  1. 快速记录：设置全局快捷键，一键调出快速记录窗口
  2. 模板应用：创建常用文档模板，通过命令面板快速插入
  3. 标签管理：使用#标签分类笔记，通过#标签名快速搜索
  4. 自动同步：设置编辑暂停10秒后自动同步，减少手动操作

多设备协作

实现多设备无缝协作：

  1. 在所有设备上配置相同的同步服务
  2. 启用"实时同步"功能
  3. 使用"最近编辑"视图查看跨设备编辑的文件
  4. 利用"版本历史"解决文件冲突

总结与展望

note-gen通过轻量级设计、多平台支持和AI增强功能，为知识工作者提供了高效的笔记解决方案。从碎片化记录到深度写作，从本地存储到多端同步，note-gen致力于简化知识管理流程，让用户专注于内容创作本身。

未来版本将重点提升以下功能：

  • 移动端离线编辑能力增强
  • 多人协作编辑功能
  • 更多AI模型集成（如Claude、通义千问等）
  • 增强的数据分析和知识图谱功能

通过持续优化和社区反馈，note-gen将不断进化，成为连接知识与创意的强大工具。

附录：命令行参考

命令描述
note-gen --help显示帮助信息
note-gen --version显示版本信息
note-gen --new创建新笔记
note-gen --open <path>打开指定笔记
note-gen --sync强制同步数据

【免费下载链接】note-gen 一款专注于记录和写作的跨端 AI 笔记应用。 【免费下载链接】note-gen 项目地址: https://gitcode.com/GitHub_Trending/no/note-gen

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值