Magic Resume 是一个现代化的在线简历编辑器，让创建专业简历变得简单有趣。基于 Next.js 和 Motion 构建，支持实时预览和自定义主题。

• 🚀 基于 Next.js 14+ 构建
• 💫 流畅的动画效果 (Motion)
• 🎨 自定义主题支持
• 🌙 深色模式
• 📤 导出为 PDF
• 🔄 实时预览
• 💾 自动保存
• 🔒 硬盘级存储

• Next.js 14+
• TypeScript
• Motion
• Tiptap
• Tailwind CSS
• Zustand
• Shadcn/ui
• Lucide Icons

1. 克隆项目

git clone git@github.com:JOYCEQL/magic-resume.git
cd magic-resume

2. 安装依赖

pnpm install

3. 启动开发服务器

pnpm dev

如需保留运行日志，使用：

pnpm dev:log

日志默认写入 log/ 目录（文件名形如 dev-YYYYMMDD-HHMMSS.log）。

⚠️ 当前版本的聊天/生成和 OCR 服务均固定使用服务器侧 server/ai-credentials.json 配置（OpenAI / MinerU），浏览器不会保存或发送任何 API Key。

4. 打开浏览器访问 http://localhost:3000

pnpm build

你可以一键部署自己的 Magic Resume 实例：

详细部署指南请查看：Vercel 部署文档

项目已配置完整的 Vercel API 支持：

• 普通 API：60 秒超时，1024 MB 内存
• AI 生成 API：300 秒超时，3008 MB 内存（需 Pro 计划）
• OCR 解析 API：300 秒超时，3008 MB 内存（需 Pro 计划）
• CORS 支持：已配置跨域访问头
• 香港区域：优化中国大陆访问速度

注意：AI 和 OCR 功能需要 Vercel Pro 计划以获得足够的超时时间和内存。免费计划限制为 10 秒超时。

1. 确保你已经安装了 Docker 和 Docker Compose

2. 在项目根目录运行：

docker compose up -d

这将会：

• 自动构建应用镜像
• 在后台启动容器

最新版本的 Magic Resume 已经发布在 Docker Hub：

Docker Hub

docker pull siyueqingchen/magic-resume:main

1. 复制 server/ai-credentials.example.json 为 server/ai-credentials.json（该文件已加入 .gitignore，不会被提交）。
2. 在该 JSON 中按 provider 填写 apiKey、apiEndpoint、userToken 等字段，可同时为 OpenAI / DeepSeek / 豆包 / MinerU 配置默认模型与额外参数。
3. 重启 pnpm dev 或部署服务；在「AI 服务配置」里选择“使用服务器内置密钥”后，请勿在浏览器输入 API Key，后端路由会自动读取此文件（若缺省则回退到环境变量）。

要使用 MinerU 作为 OCR 引擎，请完成如下配置：

1. 在 MinerU 控制台的 API Token 页面 复制 API Token（Bearer）。如账号同时给出 “用户 token”，可选填以满足自建或私有部署场景。
2. 在项目根目录的 .env.local 中新增（MINERU_USER_TOKEN 可选）：

   MINERU_API_KEY=你的_bearer_token
   # MINERU_USER_TOKEN=你的_user_token
   # 如需自定义域名，可设置：
   # MINERU_API_BASE_URL=https://mineru.net/api/v4

3. 重新启动 pnpm dev，打开「AI 服务配置」页，将 OCR Provider 选择为 MinerU OCR。若使用服务器内置密钥，可在 server/ai-credentials.json 的 mineru 条目中至少填写 apiKey，userToken 视需要补充。

MinerU 会返回结构化 Markdown 与 ZIP 结果，服务端会自动轮询任务、下载 full.md 或 content_list.json 并将文本灌入简历。

本项目采用 Apache 2.0 协议，但有一些自定义的部分 - 查看 LICENSE 了解详情

• AI 辅助编写
• 多语言支持
• 支持更多简历模板
• 更多格式导出
• 自定义模型
• 智能一页
• 导入 PDF, Markdown 等
• 在线简历托管

可以通过以下方式关注最新动态:

• 作者：SiYue
• X: @GuangzhouY81070
• Discord: 欢迎加入群组 https://discord.gg/9mWgZrW3VN
• 用户群：加微信 qingchensiyue
• 邮箱：18806723365@163.com
• 项目主页：https://github.com/JOYCEQL/magic-resume

项目接口成本现正在持续上升中，如果对你有所帮助，可以赞赏作者，支持开源～