Magic Resume：开源本地在线简历编辑器，支持AI润色与无水印PDF导出

AI新闻 AI铺子 1小时前

一、Magic Resume是什么

Magic Resume（魔方简历）是一款开源、注重用户隐私的在线简历编辑器，项目主打数据本地存储，无需注册账号，全部简历内容保存在浏览器本地，不会上传至服务端。支持在线编辑简历、多套模板切换、无水印PDF导出，同时可接入大模型API实现AI简历润色校对。个人非商业场景可以直接免费使用，支持本地运行、Docker私有化部署，适合个人制作简历以及技术人员二次研究改造。

Magic Resume（图1）

二、功能特色

隐私优先编辑能力
数据存储在浏览器LocalStorage，无需登录注册，关闭页面内容不会丢失，简历原始数据不上传第三方服务器，保障个人求职信息安全。
简历编辑与预览
双向实时预览，模块化简历编辑，内置Tiptap富文本编辑器，支持文本格式化调整；提供多套简历模板，支持自定义主题配色，适配深色、浅色模式，页面支持移动端自适应查看。
文件导出能力
无水印高清PDF导出，统一白底PDF渲染，同时支持Markdown格式导出简历文件。
AI辅助简历能力
集成Gemini大模型能力，用户自行填入API密钥即可使用，支持简历内容润色、文本校对、简历导入改写。
部署扩展能力
支持源码本地运行、Docker容器部署，兼容Cloudflare Workers云部署，方便私有化内网部署使用。

三、技术细节

项目整体基于TypeScript开发，核心前端框架为TanStack Start，状态管理使用Zustand，UI组件库采用shadcn/ui，样式框架为Tailwind CSS，富文本编辑依赖Tiptap，页面交互动画使用Framer Motion，图标库选用Lucide。

数据持久化：浏览器LocalStorage本地存储，不依赖后端数据库；
AI实现：前端直接调用Gemini开放API，密钥由用户自行配置，服务端不中转用户密钥；
导出PDF：前端浏览器端完成PDF生成，无需后端生成服务；
部署方式：支持pnpm源码启动、Docker Compose容器一键部署、Cloudflare Workers静态部署；
开源协议：Apache‑2.0协议，商用场景需要获取官方商业授权，个人非商用不受限制。

四、应用场景

个人求职：普通求职者快速制作、修改简历，导出无水印PDF投递岗位，保护个人简历信息不被平台收集。
内网私有化使用：企业、培训机构内网部署简历编辑服务，不对外公网暴露，用于学员、内部人员简历制作。
技术学习研究：前端开发者学习富文本编辑器、PDF前端导出、本地存储、AI接口前端调用相关技术。
线下教学场景：学校计算机、就业指导课程，部署开源简历工具给学生练习简历撰写。

Magic Resume（图2）

五、使用方法

在线直接使用

访问项目公开演示地址，无需安装软件，浏览器打开即可，直接开始编辑简历，编辑内容自动本地保存，完成后导出PDF或Markdown文件。

本地源码部署

# 克隆仓库
git clone https://github.com/JOYCEQL/magic-resume.git
cd magic-resume
# 安装依赖，推荐pnpm
pnpm install
# 启动本地开发服务
pnpm dev

启动完成后浏览器访问 http://localhost:3000 即可使用；执行pnpm build可以完成项目生产打包。

Docker容器部署

项目目录内，直接执行命令：

docker compose up -d

容器后台启动，访问对应服务器地址即可使用私有化实例。

AI功能使用：进入设置，填入自己的Gemini API密钥，保存后即可开启AI润色、校对功能。

六、竞品对比

对比项	Magic Resume	FlowUs简历	超级简历(Wondercv)
开源属性	完全开源，支持私有化部署	闭源SaaS，不支持私有化部署	闭源商业软件，无开源版本
数据存储方式	浏览器本地LocalStorage，不上传服务器	云端服务器存储简历数据	简历数据存储在厂商云端服务器
账号要求	无需注册登录	需要登录账号	强制注册登录账号
导出能力	无水印PDF、Markdown导出	PDF导出存在水印限制	免费版PDF带平台水印
AI能力	用户自行配置大模型API密钥	内置平台封装AI能力	内置平台封装AI简历优化
部署能力	源码、Docker、Cloudflare Workers部署	仅官方在线网页使用	仅官方网页、客户端使用

七、常见问题解答

Q：Magic Resume生成的简历数据会被项目作者收集吗？

A：不会。简历全部数据保存在浏览器本地LocalStorage，正常使用场景下不会把简历内容发送给项目服务端，AI功能为前端直接调用用户自己配置的大模型接口。

Q：是否可以直接拿来做对外收费SaaS服务？

A：不可以。虽然源码使用Apache‑2.0开源协议，但项目附加商用约束，任何商业化对外提供服务，不管是否修改代码，都需要联系作者获取商业授权。

Q：AI功能必须使用Gemini吗，能不能接入其他大模型？

A：当前版本原生仅适配Gemini API，暂不支持直接切换其他大模型，需要其他模型能力需要自行修改源码进行二次开发。

Q：浏览器清除缓存后，简历文件会丢失吗？

A：会丢失。LocalStorage跟随浏览器缓存，清理浏览器缓存、无痕模式关闭页面会造成简历数据丢失。重要简历建议编辑完成后及时导出PDF/Markdown做备份。

Q：Docker部署完成之后访问空白页面是什么原因？

A：检查容器端口映射，确认3000端口没有被其他程序占用；同时确认浏览器没有插件拦截静态资源，可查看浏览器控制台排查资源加载异常。

八、相关链接

GitHub仓库：https://github.com/JOYCEQL/magic‑resume

九、总结

Magic Resume是一款以隐私保护为核心的开源简历编辑器，摆脱传统简历工具强制注册、云端存储个人求职信息、导出带水印的痛点，兼顾在线编辑、多模板、AI简历辅助与多种私有化部署方案，个人用户可以零成本制作简历，开发者可以研究前端富文本、前端PDF导出相关技术，企业使用则需要遵守项目的商业授权约定。