三步跑起 magic-resume:AI 简历编辑器本地部署与一键导出 PDF 实战
【免费下载链接】magic-resumefree online AI resume editor，the only official website is https://magicv.art项目地址: https://gitcode.com/GitHub_Trending/ma/magic-resume
你的简历今晚就要发出去,但项目经历读起来像机翻,Word 里怎么排都超出一页。magic-resume 是一个免费开源的 AI 简历编辑器,让你在线创建简历:实时预览、多套模板、AI 润色与语法检查、一键导出 PDF,数据默认只存在你自己浏览器里。它适合今晚就想把简历改完、又不想依赖某个收费 SaaS 的人。
第一步:三组命令完成部署,第一次打开编辑器
先准备一个 Node.js 环境(仓库锁定 pnpm 10,建议用 corepack 或装好 pnpm 10)。然后把项目拉下来跑起来:
git clone https://gitcode.com/GitHub_Trending/ma/magic-resume cd magic-resume pnpm install pnpm dev浏览器打开http://localhost:3000,就能看到编辑器首页。界面默认是中文,右上角可以切到 English。
不想折腾 Node 环境的话,直接走 Docker,一条命令:
docker compose up -d它会构建镜像、后台启动容器,同样映射到 3000 端口。两种方式二选一即可,不需要同时跑。
可能卡住的点:如果你用npm install报错,先换成 pnpm,依赖是按 pnpm 锁定的;如果端口被占用,改一下vite.config.ts里或docker-compose.yml中的 3000 映射再试。
接进你的工作流:配好模型密钥,把润色流程跑一遍
跑起来之后,真正干活分四步:
- 配模型。进仪表盘的设置页,填一个模型服务的 API Key 即可,支持 DeepSeek、豆包、OpenAI、Gemini 四家。其中 DeepSeek 填 Key 就能用;豆包和 Gemini 还需要填模型 ID;走 OpenAI 兼容接口则要额外填 endpoint 和模型名。密钥保存在本地,不会上传到别处。
- 写内容。在工作台里填基本信息、教育、经历、项目等板块,右侧实时预览,左边改一个字右边立刻变。
- 让 AI 动手。选中一段描述点"润色",把机翻腔的段落重写成人话;再用语法检查,把错漏标出来逐条改。
- 收尾导出。从九套模板(现代、经典、瑞士风等)里挑一套,开启自动一页纸控制篇幅,然后一键导出 PDF 投递。
可能卡住的点:AI 调用失败时,九成是模型 ID 或 endpoint 没配对齐——对照设置页的校验提示补全再试;调用走的是服务端代理转发,本地开发时确保pnpm dev还在运行,别只开了浏览器缓存页面。
验证效果:确认数据在哪里、导出长什么样
改完之后,用三件事确认这套工具靠不靠谱:
- 数据去向:简历内容存在你的浏览器本地存储里,没有账号体系,不联网不提交,关掉页面数据也在,换浏览器则需要自行迁移。
- 导出质量:导出走浏览器本地渲染,所见即所得,PDF 里的分页、字体、配色和预览一致,自动一页纸开启后不会莫名多出一页。
- 授权边界:代码基于 Apache 2.0 开源,但带商业限制——个人非商业使用(比如做自己的简历)免费;如果把它包装成 SaaS 或商用产品,需要先拿商业授权,细则在 LICENSE 里。
从"打开编辑器"到"拿到一份一页纸 PDF",整条链路都在你自己的机器上闭环,模型密钥和简历内容都不经过第三方。
想继续看路线图(更多模板、Markdown 导入、在线托管)或部署细节,直接读 README.zh-CN.md 就够了,里面有构建打包和 Docker 的完整说明。
【免费下载链接】magic-resumefree online AI resume editor，the only official website is https://magicv.art项目地址: https://gitcode.com/GitHub_Trending/ma/magic-resume
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
