青松简历

简体中文  |  English

模块化在线简历编辑器 · 所见即所得 · 本地导出 · 云端同步 · AI 辅助

🌐 在线预览

简介

青松简历（EasyResume） 是一款面向求职者的在线简历编辑器。支持模块化编辑与实时画布预览，无需登录即可本地编辑与导出；登录后可云端同步、分享链接，并接入 AI 润色、评分与对话改稿。

✨ 功能概览

编辑与排版

• 模块化简历：个人信息、工作经历、项目、教育、技能、证书等
• 画布实时预览，拖拽网格布局（react-grid-layout）
• Quill 富文本编辑，HTML 经 DOMPurify 安全处理
• 多模板、主题色、字体、页边距等全局样式
• 中英文界面（next-intl）

导出

AI 能力

账号与云端

• GitHub / QQ 登录（NextAuth）
• 云端简历同步与多份管理（Cloudflare Workers + D1）
• 分享链接（只读预览）
• 运维后台（/zh/admin）：用户与简历管理

🛠️ 技术栈

💻 环境要求

• Node.js ≥ 18.17
• PDF（高质量）：生产环境需 Chromium（PUPPETEER_EXECUTABLE_PATH 或默认 /usr/bin/chromium-browser）
• 云端同步（可选）：本地 cf-api Worker 或已部署的 Worker URL

🚀 快速开始

git clone https://github.com/QdabuliuQ/easy-resume.git
cd easy-resume
npm install

cp .env.local.example .env.local
# 按需填写 AI Key；云同步再填 AUTH_* / CF_API_* / ADMIN_*

npm run dev

本地访问：http://localhost:3000/zh/edit（端口以终端输出为准）。

云端 API 本地联调

另开终端：

cd cf-api
cp .dev.vars.example .dev.vars
npm install
npx wrangler d1 execute easy-resume --local --file=./schema.sql   # 首次
npx wrangler dev --local --port 8787

根目录 .env.local：

CF_API_BASE_URL=http://127.0.0.1:8787
CF_API_SECRET=与.dev.vars相同
ADMIN_SECRET=与.dev.vars相同

详见 cf-api/README.md。

生产构建

npm run build
npm run start   # 端口 3010

📜 常用脚本

🔐 环境变量

在项目根目录创建 .env.local（勿提交密钥）。完整注释见 .env.local.example。

AI

登录 + 云端 + 后台

部署

📂 目录结构

src/
  app/              # App Router：页面、API
  views/edit/       # 编辑器主界面
  views/admin/      # 运维后台
  modules/          # 简历模块渲染（预览画布）
  components/       # 通用组件
  mobx/             # 全局状态
  lib/              # 工具（导出、AI、字体等）
  json/             # 默认简历与模板
cf-api/             # Cloudflare Workers + D1
public/fonts/       # 简历字体
tests/              # Vitest

🔒 部署与安全

Cloudflare 路由（重要）

• 禁止：主站 resume.qdabuliuq.cn/api/* → Worker（会导致登录 404）
• 正确：主站 Nginx 全部反代到 Next :3010；Worker 用独立域名（如 api.resume.qdabuliuq.cn）

安全要点

• 浏览器只访问主站；CF_API_SECRET / ADMIN_SECRET 不下发前端
• Next 从 session 注入 uid，再带 X-CF-Key 调 CF
• CF 直连无密钥 → 401
• 后台登录有失败次数限制

🐳 Docker

docker-compose up -d

访问：http://localhost:3010/zh

📄 许可

MIT