AI 驱动的现代化简历构建器
Magic Resume 是一款现代化的 AI 驱动简历构建器，采用 Next.js 14 构建。它不仅提供直观的在线编辑体验，还能根据目标职位智能优化简历内容，让您的求职之路更加顺畅。
- 🎨 可视化模板自定义 - 22种精美字体 + 实时颜色/布局调整
- 🤖 AI 智能优化 - 根据 JD 自动优化简历内容和匹配度
- 📊 专业分析报告 - Lighthouse 风格的简历健康度分析
- 🌐 完整国际化 - 中英文界面无缝切换
- 💾 本地存储优先 - 数据安全，支持多格式导出
- 🎯 实时预览 - 所见即所得的编辑体验
| 分类 | 技术栈 |
|---|---|
| 前端框架 | Next.js 14 · React 18 · TypeScript |
| UI 设计 | Tailwind CSS · Radix UI · shadcn/ui · Framer Motion |
| AI 能力 | OpenAI API · Tavily Search · LangChain |
| 用户认证 | Clerk · NextAuth (可选) |
| 第三方集成 | GitHub API · 后端服务支持 |
| 状态管理 | Zustand · Immer |
| 富文本 | Tiptap Editor · Dnd Kit |
| 工具链 | ESLint · Husky · Zod |
resume/
├── src/
│ ├── app/ # Next.js App Router
│ │ ├── dashboard/ # 仪表盘页面
│ │ ├── components/ # 全局组件
│ │ └── globals.css # 全局样式
│ ├── templates/ # 简历模板系统
│ │ ├── config/ # 模板配置
│ │ ├── templateLayout/ # 布局组件
│ │ ├── TemplateCustomizer/ # 自定义器组件
│ │ └── renderer/ # 渲染引擎
│ ├── lib/ # 工具库
│ ├── store/ # 状态管理
│ ├── locales/ # 国际化
│ └── prompts/ # AI 提示词
└── public/ # 静态资源
# 1. 克隆项目
git clone https://github.com/LinMoQC/Magic-Resume.git
cd Magic-Resume
# 2. 安装依赖
npm install
# 3. 配置环境变量
cp .env.local.example .env.local
# 编辑 .env.local 填入您的密钥创建 .env.local 文件进行配置：
# 必需配置
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_xxx
CLERK_SECRET_KEY=sk_test_xxx
# 可选配置 - Google Analytics
NEXT_PUBLIC_GA_ID=G-XXXXXXXXXX核心配置项：
| 配置类别 | 必需性 | 说明 |
|---|---|---|
| Clerk 认证 | ✅ 必需 | 用户登录注册系统 |
| Google Analytics | ⚙️ 可选 | 网站流量分析 |
| 后端服务 | ⚙️ 可选 | 完整后端支持 |
# 开发环境
npm run dev
# 生产构建
npm run build && npm run start
# 代码检查
npm run lint打开 http://localhost:3000 开始使用！
📋 Clerk 用户认证配置 (必需)
- 访问 Clerk.com 注册账号
- 创建新应用，选择认证方式
- 在 Dashboard → API Keys 获取密钥：
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_xxx CLERK_SECRET_KEY=sk_test_xxx
- 配置重定向URL（可选）
🤖 AI 功能配置 (可选)
OpenAI API - 简历智能优化
- 访问 OpenAI Platform
- 创建 API 密钥
- 配置：
OPENAI_API_KEY=sk-xxx
Tavily API - 智能搜索增强
- 访问 Tavily.com
- 注册并获取 API 密钥
- 配置：
TAVILY_API_KEY=tvly-xxx
📱 GitHub 集成 (可选)
用于从 GitHub 导入项目数据：
- 访问 GitHub Settings → Tokens
- 生成 Personal Access Token
- 配置：
GITHUB_TOKEN=ghp-xxx - 权限选择：
repo,user:email
🚀 后端服务配置 (可选)
如需使用完整后端功能：
- 启动后端服务（通常在端口 8000）
- 配置后端地址：
BACKEND_URL=http://127.0.0.1:8000 - 启用后端：
NEXT_PUBLIC_IF_USE_BACKEND=true - 详见后端项目的部署文档
📊 Google Analytics 配置 (可选)
网站流量分析 - 了解用户行为和网站性能
- 访问 Google Analytics
- 创建账户和媒体资源
- 获取测量ID：
NEXT_PUBLIC_GA_ID=G-XXXXXXXXXX
隐私保护特性：
- 仅在生产环境启用
- 其他用户部署时不会影响您的数据
- 支持自定义事件追踪
详细配置请参考：ANALYTICS_SETUP.md
🔐 认证系统配置
Clerk (推荐) - 现代认证方案
- 完整的用户管理界面
- 多种登录方式支持
NextAuth (可选) - 传统认证方案
- 配置：
NEXTAUTH_URL和NEXTAUTH_SECRET - 适用于自定义认证需求
|
颜色主题
字体系统
|
布局控制
实时保存
|
| 功能 | 技术支持 | 描述 |
|---|---|---|
| 智能优化 | OpenAI GPT | 根据 JD 自动优化简历内容 |
| 健康分析 | AI 分析引擎 | Lighthouse 风格的专业分析 |
| 引导创建 | 对话式 AI | AI 对话式简历生成 |
| 智能搜索 | Tavily API | 增强的网络搜索能力 |
| GitHub 集成 | GitHub API | 自动导入项目经历 |
| 🎨 模板自定义 | 🤖 AI 智能优化 |
 |
 |
| 💬 AI 对话助手 | 🎯 文本选择优化 |
 |
 |
| 📊 专业分析 | 📱 多端适配 |
 |
 |
我们欢迎所有形式的贡献！无论是新功能、Bug 修复、文档改进还是问题反馈。
- Fork 项目 并创建您的功能分支
- 提交变更 并编写清晰的 commit 信息
- 推送到分支 并创建 Pull Request
- 等待审核 我们会尽快回复
git checkout -b feature/amazing-feature
git commit -m 'feat: 添加某个很棒的功能'
git push origin feature/amazing-feature感谢所有为 Magic Resume 做出贡献的开发者！
本项目基于 MIT License 开源协议。
如果这个项目对您有帮助，请考虑给我们一个 ⭐
Made with ❤️ by Magic Resume Team