JadeAI

AI 驱动的智能简历生成器

拖拽编辑、实时 AI 优化、50 套专业模板、多格式导出，轻松打造高质量简历。

English

交流群

扫码加入交流群，获取使用帮助与最新动态：

加入飞书群

最近更新

v0.3.4 · 主题色系统与配色切换

• 引入语义化 --brand-* CSS token，下线全站 60+ 文件硬编码 pink-*
• 用户菜单新增主题色切换器，三套预设：薄荷（默认）、经典蓝、玫粉
• SSR 安全的防闪烁初始化；老版本 localStorage 值自动迁移
• 简历主题编辑器新增「薄荷」预设
• 导出通道（PDF / HTML / DOCX）统一读取 src/lib/brand-constants.ts

v0.3.3 · 移动端体验 & 面试报告稳定性

• 模板预览及预览/分享页新增移动端底部操作栏
• 修复移动端滚动：画布/预览根节点改用 h-full
• 面试报告生成稳定性提升

v0.3.2 · 运行时环境变量

• 移除所有 NEXT_PUBLIC_* 构建时变量，改为运行时读取

v0.3.1 · 认证运行时开关

• NEXT_PUBLIC_AUTH_ENABLED 改为运行时变量 AUTH_ENABLED

截图展示

模板画廊	简历编辑器

AI 填充简历	AI 图片简历解析

AI 优化	AI 语法检查

语法一键修复	JD 匹配分析

多格式导出	创建分享链接

简历分享页	AI 职业照生成

二维码模块

新建面试	模拟面试

面试列表	面试报告

部署视频

在 Bilibili 观看完整部署教程：

前往 Bilibili 观看 →

功能特性

简历编辑

• 拖拽编辑器 — 可视化拖拽排列简历模块与条目
• 行内编辑 — 点击任意字段，直接在画布上编辑
• 50 套专业模板 — 经典、现代、极简、创意、ATS 友好、时间线、北欧风、瑞士风等多种风格
• 主题定制 — 颜色、字体、间距、页边距实时预览调整
• 撤销 / 重做 — 完整编辑历史（最多 50 步）
• 自动保存 — 可配置保存间隔（0.3s–5s），支持手动保存
• Markdown 支持 — 在文本字段中使用 Markdown 语法排版内容（例如 **加粗** 可显示粗体文字）

Markdown 格式支持

以下简历模块支持 Markdown 语法：

支持的语法：

**加粗文字**    → 粗体
`代码文字`      → 行内代码
- 列表项        → 无序列表

技能、证书、个人信息等字段暂不支持 Markdown。

AI 能力

• AI 聊天助手 — 编辑器内集成对话式 AI，支持多会话和持久化历史
• AI 一键生成简历 — 输入职位、经验、技能，自动生成完整简历
• 简历解析 — 上传已有 PDF 或图片，AI 自动提取全部内容
• JD 匹配分析 — 对比简历与职位描述：关键词匹配、ATS 评分、改进建议
• 求职信生成 — 基于简历和 JD 的 AI 定制求职信，可选语气（正式 / 友好 / 自信）
• 语法与写作检查 — 检测弱动词、模糊描述和语法问题，返回质量评分
• 多语言翻译 — 支持 10 种语言互译，保留专业术语原文
• 灵活 AI 供应商 — 支持 OpenAI、Anthropic 及自定义 API 端点；用户在应用内自行配置密钥

模拟面试

• JD 岗位面试模拟 — 粘贴 JD，AI 按顺序扮演不同面试官进行模拟面试
• 6 种预设面试官 — HR 面、技术面、场景面、行为面、项目深挖、Leader 面，各有独特性格和提问风格
• 自定义面试官 — 创建自定义面试官，设定考察维度和风格
• 智能追问 — AI 根据回答质量自适应追问，回答不到位会深入追问
• 面试控制 — 跳过问题、请求提示、标记复习、暂停/继续
• 详细报告 — 逐题评分、能力雷达图、改进建议与推荐资源
• 历史对比 — 追踪评分趋势和能力维度变化
• 报告导出 — 支持 PDF 和 Markdown 格式导出

导出与分享

• 多格式导出 — PDF（Puppeteer + Chromium）、智能一页 PDF（自动适配单页）、DOCX、HTML、TXT、JSON
• JSON 导入 — 导入之前导出的 JSON 文件还原或创建简历；编辑器内覆盖当前简历，仪表盘创建新简历
• 链接分享 — 基于 Token 的分享链接，支持密码保护
• 浏览统计 — 追踪分享简历的查看次数

简历管理

• 多简历仪表盘 — 网格和列表视图、搜索、排序（按日期、名称）
• JSON 导入创建 — 在仪表盘直接通过 JSON 文件创建新简历
• 复制与重命名 — 快捷简历管理操作
• 新手引导 — 交互式分步引导，帮助新用户快速上手

其他

• 双语界面 — 完整的中文（zh）和英文（en）界面
• 暗色模式 — 浅色、深色、跟随系统三种主题
• 灵活认证 — Google OAuth 或浏览器指纹（零配置即用）
• 双数据库 — SQLite（默认，零配置）或 PostgreSQL

技术栈

快速开始

Docker 部署（推荐）

# 先生成一个密钥
openssl rand -base64 32

docker run -d -p 3000:3000 \
  -e AUTH_SECRET=<你生成的密钥> \
  -v jadeai-data:/app/data \
  twwch/jadeai:latest

打开 http://localhost:3000。首次启动自动完成数据库迁移和数据初始化。

AUTH_SECRET 为必填项，用于会话加密。通过 openssl rand -base64 32 生成。

AI 配置： 无需服务端 AI 环境变量。每位用户在应用内的 设置 > AI 中自行配置 API Key、Base URL 和模型。

使用 PostgreSQL

docker run -d -p 3000:3000 \
  -e AUTH_SECRET=<你生成的密钥> \
  -e DB_TYPE=postgresql \
  -e DATABASE_URL=postgresql://user:pass@host:5432/jadeai \
  twwch/jadeai:latest

使用 Google OAuth 登录

docker run -d -p 3000:3000 \
  -e AUTH_ENABLED=true \
  -e AUTH_SECRET=your-secret \
  -e GOOGLE_CLIENT_ID=xxx \
  -e GOOGLE_CLIENT_SECRET=xxx \
  -v jadeai-data:/app/data \
  twwch/jadeai:latest

本地开发

环境要求

• Node.js 18+
• pnpm 9+

安装

git clone https://github.com/twwch/JadeAI.git
cd JadeAI

pnpm install
cp .env.example .env.local

配置环境变量

编辑 .env.local：

# 数据库（默认 SQLite，无需额外配置）
DB_TYPE=sqlite

# 认证（默认指纹模式，无需额外配置）
AUTH_ENABLED=false

AI 配置： 无需服务端环境变量。每位用户在应用内的 设置 > AI 中自行配置 API Key、Base URL 和模型。

查看 .env.example 了解所有可用选项（Google OAuth、PostgreSQL 等）。

初始化数据库并启动

# 生成并执行迁移
pnpm db:generate
pnpm db:migrate

# （可选）填充示例数据
pnpm db:seed

# 启动开发服务器
pnpm dev

打开 http://localhost:3000。

环境变量

常用命令

项目结构

src/
├── app/                        # Next.js App Router
│   ├── [locale]/               # 国际化路由 (/zh/..., /en/...)
│   │   ├── dashboard/          # 简历列表与管理
│   │   ├── editor/[id]/        # 简历编辑器
│   │   ├── preview/[id]/       # 全屏预览
│   │   ├── templates/          # 模板画廊
│   │   └── share/[token]/      # 公开分享简历查看
│   └── api/
│       ├── ai/                 # AI 接口
│       │   ├── chat/           #   流式对话 + 工具调用
│       │   ├── generate-resume/#   AI 生成简历
│       │   ├── jd-analysis/    #   JD 匹配分析
│       │   ├── grammar-check/  #   语法与写作检查
│       │   ├── cover-letter/   #   求职信生成
│       │   ├── translate/      #   简历翻译
│       │   └── models/         #   可用 AI 模型列表
│       ├── resume/             # 简历 CRUD、导出、解析、分享
│       ├── share/              # 公开分享访问
│       ├── user/               # 用户信息与设置
│       └── auth/               # NextAuth 认证
├── components/
│   ├── ui/                     # shadcn/ui 基础组件
│   ├── editor/                 # 编辑器画布、区块、字段、弹窗
│   ├── ai/                     # AI 对话面板与气泡
│   ├── preview/templates/      # 50 套简历模板
│   ├── dashboard/              # 仪表盘卡片、网格、弹窗
│   └── layout/                 # 头部、主题、语言切换
├── lib/
│   ├── db/                     # Schema、仓库、迁移、适配器
│   ├── auth/                   # 认证配置
│   └── ai/                     # AI 提示词、工具、模型配置
├── hooks/                      # 自定义 React Hooks（7 个）
├── stores/                     # Zustand 状态仓库（简历、编辑器、设置、UI、引导）
└── types/                      # TypeScript 类型定义

模板列表

JadeAI 内置 50 套专业设计模板，覆盖多种风格和行业需求：

查看全部 50 套模板

API 参考

查看全部 API 端点

简历

分享

AI

用户

参与贡献

欢迎贡献代码！请按照以下步骤：

1. Fork 本仓库
2. 创建功能分支：git checkout -b feat/your-feature
3. 提交更改：git commit -m 'feat: add your feature'
4. 推送分支：git push origin feat/your-feature
5. 提交 Pull Request

常见问题

AI 配置是如何工作的？

JadeAI 不需要在服务端配置 AI API 密钥。每位用户在应用内的 设置 > AI 中自行配置 AI 供应商（OpenAI、Anthropic 或自定义端点）、API Key 和模型。API 密钥仅存储在浏览器的 localStorage 中，不会发送到服务端存储。

可以在 SQLite 和 PostgreSQL 之间切换吗？

可以。通过 DB_TYPE 环境变量设置为 sqlite 或 postgresql。SQLite 是默认选项，零配置即可使用。使用 PostgreSQL 时需额外设置 DATABASE_URL。注意：数据不会在两种数据库之间自动迁移。

不使用 OAuth 时认证如何工作？

当 AUTH_ENABLED=false（默认）时，JadeAI 使用 FingerprintJS 进行浏览器指纹识别。系统为每个浏览器生成唯一的指纹 ID 作为用户标识。无需登录界面 — 用户可以直接开始创建简历。

PDF 导出是如何实现的？

PDF 导出使用 Puppeteer Core + @sparticuz/chromium。50 套模板各有独立的服务端导出处理器，将简历渲染为高保真 PDF。同时支持 DOCX、HTML、TXT 和 JSON 格式导出。

Star History

许可证

Apache License 2.0