<div align="center">

OpResume

免登录、高颜值的在线简历生成器 — 数据仅本地存储，无泄漏风险，随时导出

<a href="https://linux.do" alt="LINUX DO"><img src="https://shorturl.at/ggSqS" /></a>

简体中文 | English

👉 即刻开始

<img src="docs/images/mockup1.png" alt="OpResume Preview" width="800" /> </div>

✨ 核心特性

🎨 专业的排版引擎

• 多维度外观控制：页边距、模块间距、行间距自由滑动调节，告别 Word 排版地狱。
• 多套经典模板：内置 4+ 套经过严格筛选的行业经典模板（涵盖大厂 ATS 风格、外企单栏风等），一键无缝切换。
• 主题配色定制：8+ 款精心调配的预设主题色，适应不同行业的视觉调性。
• 自动智能分页：内容超出 A4 纸范围时自动视觉分页，并带有现代化的悬浮页码指示器。

🚀 极致的用户体验

• 所见即所得：侧边栏抽屉式表单编辑，主画布实时渲染预览。
• 隐私保护模式：一键开启“打码模式”，自动隐藏姓名、手机、邮箱等敏感信息，方便简历在社区分享与 Review。
• 丝滑拖拽排序：基于 @dnd-kit，工作经历、项目描述等模块内的条目均可自由拖拽调整顺序。
• 富文本与智能推算：基于 Tiptap 的富文本编辑器支持加粗、列表与链接；系统还会根据生日和入职时间自动推算年龄与工作年限。

🔒 数据安全与导出

• 免登录零上传：所有数据仅存储在浏览器 localStorage 中，无后端、无数据库，隐私完全由你掌控。
• JSON 导入/导出：一键导出完整简历配置为 JSON 文件，方便备份、迁移或跨设备使用；支持导入已有配置快速恢复。
• 原生 PDF 导出：基于浏览器原生 window.print() 实现高保真导出，文字可选中复制，ATS 友好。

---

🚀 快速开始

环境要求

• Node.js >= 18
• npm >= 8

安装与运行

# 1. 克隆项目
git clone https://github.com/oopooa/opresume.git
cd opresume

# 2. 安装依赖
npm install

# 3. 启动开发服务器
npm run dev

浏览器访问 http://localhost:5173，即可开始编辑属于你的完美简历。

构建与部署

# 构建生产版本
npm run build

# 预览构建结果
npm run preview

---

🏗️ 技术栈

| 类别 | 选型 | |------|------| | 基础框架 | React 18 + Vite 5 + TS 5 | | UI 与样式 | Tailwind CSS 3 + shadcn/ui | | 状态管理 | Zustand 5 | | 富文本编辑 | Tiptap 3 | | 拖拽交互 | @dnd-kit | | 国际化 | react-i18next |

---

🗺️ 产品规划

• [x] 简历 JSON 数据导出导入
• [x] 富文本编辑器
• [x] 模块拖拽排序
• [x] 双栏布局与模块分区拖拽
• [x] 模板切换功能
• [x] 自定义排版功能
• [x] 智能分页（单栏模板）
• [x] 隐私打码模式
• [x] 国际化多语言支持
• [ ] AI 导入简历
• [ ] AI 简历评分与诊断
• [ ] 多份简历管理
• [ ] 智能一页
• [ ] 更多模板

---

📁 项目结构

src/
├── components/
│   ├── Resume/            # 简历渲染核心引擎
│   │   ├── templates/     # 🌟 多套模板（基于自动注册机制）
│   │   └── modules/       # 基础模块渲染（经历、教育、技能等）
│   ├── Editor/            # 侧边栏抽屉与动态表单
│   ├── Toolbar/           # 顶部工具栏（外观控制/导出）
│   └── ui/                # shadcn/ui 基础组件库
├── store/                 # Zustand 状态切片
├── services/              # 纯本地的 IO 操作（加载/保存/迁移数据）
├── hooks/                 # 自定义 Hooks（分页计算、打码逻辑等）
└── types/                 # 全局 TypeScript 接口定义

---

📄 许可证

本项目基于 MIT 协议 开源。欢迎 Fork、提交 PR 或提 Issue 探讨！