青松简历

简体中文  |  English

AI 简历编辑器 | 快捷编辑 · 数据安全 · 本地存储备份 · AI 协助

基于 Next.js 14（App Router） 的在线简历编辑器：可视化编排模块、富文本编辑、拖拽布局，并支持通过 Puppeteer 导出 PDF / PNG。

🌐 在线预览

✨ 功能概览

• 简历模块编辑（个人信息、工作经历、项目、教育、技能、证书等）
• 画布预览与网格布局（react-grid-layout）
• Quill 富文本与 HTML 安全处理（DOMPurify）
• 服务端渲染简历 HTML，PDF/PNG 导出 API
• AI 相关能力，支持 AI 润色优化

🛠️ 技术栈

💻 环境要求

• Node.js ≥ 18.17（见 package.json engines）
• PDF/PNG：生产环境需可用的 Chromium；默认期望可执行文件为 /usr/bin/chromium-browser，或通过环境变量指定（见下表）

🚀 快速开始

npm install
# 若出现 React / Next  peer 依赖冲突，可使用：
# npm install --legacy-peer-deps

npm run dev

开发服务器默认由 Next 分配端口；本地访问路径形如：http://localhost:3000/zh/edit（端口以终端输出为准）。

生产构建与启动：

npm run build
npm run start

start 脚本固定监听 3010 端口。

📜 常用脚本

🔐 环境变量

在项目根目录创建 .env.local（勿提交密钥到仓库）。可参考 .env.local.example。

本地开发

PUPPETEER_EXECUTABLE_PATH 示例：

部署专用

以下变量仅在服务器部署时需要配置：

可选（启用 AI 评分限流与缓存时需配置，见 .env.local.example）：

📂 目录结构（摘要）

src/
  app/           # App Router：页面、Layout、API Routes（pdf/png/version/chat 等）
  components/    # 通用组件
  views/edit/    # 编辑器主界面（画布、侧栏、头部等）
  modules/       # 简历各模块渲染与类型
  mobx/          # 全局状态
  lib/           # Puppeteer、字体、API 转发等工具
  utils/         # 通用工具函数
  json/          # 默认简历与模板数据
public/          # 静态资源（含字体等）
middleware.ts    # Next.js 中间件

🐳 Docker 部署

docker-compose up -d

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