NoteGen：5步构建跨端AI笔记应用

项目概述

NoteGen 是一款专注于记录和写作的跨端 AI笔记应用，基于 Tauri（跨平台桌面应用开发框架）构建，旨在通过 AI 赋能帮助用户高效捕捉、整理和拓展碎片化知识。该应用融合了现代前端技术与 AI 能力，提供流畅的跨设备使用体验，特别适合需要频繁记录灵感、整理学习资料的知识工作者。

---

核心特性

📋 智能记录体验

• 支持文本、图片、语音等多模态输入，AI 自动分类整理
• 内置 Markdown 编辑器，支持公式、图表等专业内容创作

⚙️ 跨平台同步

• 基于 Tauri 框架实现 Windows/macOS/Linux 全平台支持
• 支持本地存储与云端备份，确保数据安全

🧠 AI 增强功能

• 集成 OpenAI 协议模型，提供智能摘要、翻译、润色等辅助写作工具
• 上下文感知的内容推荐，帮助用户拓展思路

---

环境准备

🔍 技术栈概览

技术名称	用途	版本要求
Node.js	JavaScript 运行环境	v18.0.0+
Tauri 2	跨平台桌面应用框架	v2.0.0+
Next.js	React 服务端渲染框架	v15.0.0+
shadcn-ui	UI 组件库	v0.8.0+
Tailwind CSS	实用优先 CSS 框架	v3.3.0+
TypeScript	强类型 JavaScript 扩展	v5.0.0+

⚠️ 系统要求

• 内存：至少 4GB RAM
• 磁盘空间：1GB 可用空间
• 网络：需联网获取依赖和 AI 服务

---

分步部署

1. 基础环境配置

# 检查 Node.js 版本（需 v18+）
node -v  # 示例输出：v20.10.0

# 安装 pnpm 包管理器（推荐）
npm install -g pnpm
pnpm -v  # 验证安装成功

验证方式：命令行输出对应版本号，无错误提示

2. 源码获取

# 克隆项目仓库
git clone https://gitcode.com/GitHub_Trending/no/note-gen
cd note-gen  # 进入项目目录

3. 依赖管理

# 安装项目依赖
pnpm install  # 替代 npm install，速度更快

# 生成 Tauri 绑定（首次运行需执行）
pnpm tauri dev --build  # 构建并验证依赖完整性

⚠️ 避坑指南：若依赖安装失败，尝试删除 node_modules 和 pnpm-lock.yaml 后重新执行 pnpm install

4. 配置参数

创建 .env.local 文件并添加以下配置：

# 基础配置（必填）
NEXT_PUBLIC_APP_NAME="NoteGen"           # 应用名称
NEXT_PUBLIC_API_ENDPOINT="http://localhost:3001"  # API 服务地址

# AI 服务配置（可选）
NEXT_PUBLIC_AI_MODEL="gpt-3.5-turbo"     # 支持 gpt-3.5-turbo/gpt-4
NEXT_PUBLIC_AI_TIMEOUT=30000             # 请求超时时间（毫秒）

# 存储配置（可选）
NEXT_PUBLIC_STORAGE_TYPE="local"         # 存储类型：local/webdav

验证方式：执行 cat .env.local 确认配置内容无误

5. 启动验证

# 开发模式启动
pnpm dev  # 同时启动 Next.js 前端和 Tauri 桌面应用

# 构建生产版本（可选）
pnpm build  # 生成可分发的应用程序包

验证方式：

• 开发模式：浏览器自动打开 http://localhost:3000，桌面应用窗口同时启动
• 检查日志：终端无红色错误信息，出现 ready in X ms 提示

---

部署排障

常见问题及解决方法

1. 端口占用错误
   Error: listen EADDRINUSE: address already in use :::3000
   ⚙️ 解决：执行 lsof -i :3000 找到占用进程，使用 kill -9 <PID> 终止后重试

2. Tauri 构建失败
   error: failed to run custom build command for tauri-sys v0.27.0
   ⚙️ 解决：安装系统依赖

   # Ubuntu/Debian
   sudo apt install libwebkit2gtk-4.0-dev build-essential
   # macOS (需安装 Xcode 命令行工具)
   xcode-select --install
   

3. AI 功能无响应
   ⚙️ 解决：检查 .env.local 中 API 地址是否正确，网络是否可访问 AI 服务端点

4. 依赖冲突
   peer dependency conflict
   ⚙️ 解决：使用 pnpm why <package> 查找冲突包，手动安装指定版本：pnpm add <package>@x.y.z

5. 应用启动白屏
   ⚙️ 解决：删除 .next 和 src-tauri/target 目录后重新执行 pnpm dev