一、环境准备

​技术栈要求

  • ​前端框架：需安装 ​Next.js​（基于React）、Tailwind CSS​（样式库）、Zustand​（状态管理）。

  • ​后端服务：支持 ​Vercel 部署或 ​腾讯云Serverless​（用于API交互）。

  • ​AI服务依赖：集成 ​DeepSeek V3 和 ​豆包大模型​（需配置API密钥）。

  • ​操作系统：推荐 ​Linux/Windows/macOS，需预装 Node.js（≥v16）和 npm/yarn 包管理工具。

​数据安全配置

  • ​本地存储：确保项目配置中启用本地存储模式，所有简历数据默认保存在用户设备，不依赖云端数据库。

  • ​隐私保护：若需自定义存储路径，可在 config.json 中设置 localStoragePath 参数。

​二、代码获取与配置

​克隆开源仓库

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

项目地址见GitHub仓库。

​安装依赖

npm install  # 或使用 yarn install

需确保安装以下核心包：

  • @motion（动画库）

  • react-router-dom（路由管理）

  • file-saver（PDF导出支持）

​配置AI服务

在 .env 文件中添加AI模型的API密钥：

DEEPSEEK_API_KEY=your_api_key_here
DOUBAN_MODEL_KEY=your_douban_key_here

​三、本地运行与调试

​启动开发服务器

npm run dev

访问 http://localhost:3000 进入编辑器界面。
实时预览功能已默认启用，编辑内容自动同步。

​自定义主题

修改 src/styles/theme.css 文件，调整颜色、间距等参数：

:root {
  --primary-color: #2d8cf0; /* 主色调 */
  --spacing-unit: 1rem;    /* 间距单位 */
}

支持模块顺序调整，通过拖拽组件实现。

​四、部署到生产环境

​Vercel部署（推荐）​

  • 登录 Vercel 控制台，导入项目仓库。

  • 配置构建命令为 npm run build，输出目录设为 out。

  • 添加环境变量（同本地 .env 配置）。

​腾讯云Serverless部署

  • 安装 Serverless Framework：

    npm install -g serverless

  • 创建 serverless.yml 配置文件，指定函数路由与资源限制。

​五、常见问题处理

  • ​AI润色功能失效：检查API密钥是否有效，或更换为其他模型（如网页9提到的备用配置）。

  • ​PDF导出异常：确保 file-saver 和 html2canvas 依赖已正确安装。

  • ​多设备同步问题：通过导出JSON配置文件实现跨设备迁移（路径：设置 → 导出配置）。

​六、扩展功能（可选）​

​添加第三方模板

将自定义模板文件放入 public/templates 目录，格式参考现有模板。

​集成企业API

在 src/api 目录下新增接口文件，调用企业用户系统或招聘平台数据。

​参考文档