项目概览
Magic Resume 是一款开源的在线 AI 简历编辑器,由开发者 Siyue 创建并维护。它提供所见即所得的编辑体验,左侧编辑内容,右侧实时预览最终效果。所有简历数据存储在浏览器 localStorage,不上传服务器,从根本上解决隐私问题。内置 AI 辅助写作,支持 Gemini、DeepSeek、豆包等多个大模型,可进行内容润色、语法检查和简历导入。基于 TanStack Start、Tiptap v3、Zustand 等现代技术栈构建,支持多套模板和深色模式。PDF 导出时自动调整字号和间距,确保简历恰好一页。采用 Apache 2.0 开源协议,个人使用免费,商业使用需单独授权。支持 Docker 一键部署,无需数据库和后端。
解决什么问题
传统简历制作方式存在多种痛点:使用 Word/WPS 等文档工具排版耗时,跨平台排版不一致,调间距常导致多出一页;LaTeX/Overleaf 排版精确但学习曲线陡峭,编译循环慢,中文支持需额外配置;在线平台如超级简历、Canva 操作简便、模板多,但数据存储在云端存在隐私风险,高级功能需付费;设计工具如 Figma/Sketch 设计自由度高,但需要设计基础,不便批量修改,无法直接导出 PDF。Magic Resume 旨在统一在线编辑器的流畅体验、本地存储的隐私安全和 AI 辅助的智能能力。
工作方式
Magic Resume 基于 TanStack Start(React 全栈框架)构建,使用 Tiptap v3 作为核心富文本编辑引擎,每个简历模块(教育经历、工作经验、技能等)是独立的 Tiptap 编辑实例。内容变更通过 ProseMirror 事务机制更新,onChange 事件触发 Zustand 状态更新,再由 Zustand 驱动预览区重新渲染。所有简历数据通过 Zustand 的 persist 中间件自动保存到浏览器 localStorage。PDF 导出时,系统读取 Zustand 中的简历数据,根据选中的主题模板生成 HTML 结构,应用 Tailwind CSS 样式,通过浏览器的打印 API 或专用 PDF 库生成 PDF,并自动调整字号和间距确保简历恰好一页。AI 辅助功能通过后端代理(如 Cloudflare Workers)调用 LLM API,支持 Gemini、DeepSeek、豆包等模型,用户可自定义选择。
核心能力
- 所见即所得:左右分栏布局,编辑区与预览区实时同步
- 数据本地化:所有简历数据存储在浏览器 localStorage,不上传服务器
- AI 原生集成:内置 AI 润色、语法检查、简历导入,支持多模型切换
- 自动单页适配:PDF 导出时自动调整字号和间距,确保简历恰好一页
- 多模板主题:支持多套简历模板和深色模式,一键切换
- 多格式导入:支持 PDF 和 Markdown 导入简历
- Docker 一键部署:无需数据库和后端,docker compose up -d 即可部署
- 模板系统可扩展:模板是独立的 React 组件,可开发自定义模板
使用前需要了解
- AI 整理 · 本地测试,未经人工复核;依据历史报告节选,不代表当前产品状态。
- Magic Resume 仅限浏览器使用,没有桌面客户端,必须联网打开网页(部署后可离线)。模板数量相比商业平台有限,仍在增长中。不支持多人同时编辑一份简历,没有协作功能。localStorage 有容量限制(通常 5-10MB),不适合管理几十份以上简历。无移动端编辑,响应式设计用于查看,编辑体验仍以桌面为主。AI 功能依赖外部 API,如果 LLM 服务不可用,AI 润色和导入功能将失效。PDF 导出基于浏览器打印 API,在不同浏览器上可能有细微差异。Apache 2.0 源码开源,但商业使用需单独授权。不适合需要 ATS 友好格式的企业 HR、需要多人协作编辑的招聘团队、需要批量生成简历的招聘场景,以及对 PDF 输出格式有严格要求(如政府标准格式)的场景。

