魔方简历

定义

魔方简历（Magic Resume）是一款在浏览器中运行的开源在线简历编辑器，使用者不必注册账号或登录，就能创建、修改、预览并导出自己的简历^[2]。它把内容填写与版式排版分开处理，用户只负责录入经历与技能，分页、对齐一类的工作交给页面完成^[4]。工具把编辑区与预览区并排放在同一页面，改动之后可以直接观察排版结果，从而减少反复调整文档格式所花的时间^[5]。

项目由开发者 SiYue 以 JOYCEQL 账号在 GitHub 上开源并持续维护，源码采用 Apache 2.0 协议，并附带额外的使用限制^[1][6]。除作者提供的在线版本之外，项目也支持使用者自行搭建部署^[7]。

原理

编辑器把用户录入的内容保存在浏览器本地，编辑区与预览区共用同一份数据，改动会立即反映到预览画面中，项目同时提供自动保存功能，使用者无须手动提交^[6][8]。2.0 版本的技术栈以 TanStack Start 为核心，配合 TypeScript、Tiptap 富文本编辑器、Tailwind CSS 与 Zustand 状态管理实现^[6]。

AI 润色与语法检查依靠调用外部 大语言模型 完成。使用者需要自行填写所选服务商的接口密钥，可用对象包括 DeepSeek、豆包、Gemini 以及 OpenAI 等主流模型^[9][3]。

flowchart LR

A[录入个人信息与经历] --> B[浏览器本地存储]

B --> C[模板渲染与实时预览]

B --> D[导出 PDF、JSON、Markdown]

B --> E[按需调用自备密钥的模型润色文本]

发展历程

2025 年 2 月 2 日，作者在 V2EX 发帖公开介绍这一项目，称其为免费在线简历编辑器，并说明当时已集成 DeepSeek V3 与豆包提供润色和文本诊断^[10]。初版基于 Next.js 构建，界面组件取自 Shadcn/ui，动画效果由 Motion 实现^[11]。

同一阶段项目提供 3 套简历模板，支持主题色、间距、字段顺序与模块顺序的自定义，并可导出 PDF 文件^[11]。2025 年 2 月 13 日，作者在回帖中确认已支持 Docker 部署^[10]。2025 年 3 月 6 日，工具导航站新媒派收录了这一工具^[2]。

2026 年，项目发布 2.0 版本并完成框架重构，由 Next.js 迁移到 TanStack Start^[3]。新版本把模板扩充到 7 套以上，并加入旧简历 PDF 的智能导入、多语言界面、自动一页纸与移动端工作台等能力^[3][1]。2.0 之后项目继续以版本迭代的方式更新^[12]。

截至 2026 年 8 月，该项目在 GitHub 上获得的星标数已超过 1 万^[12]。

应用

它的主要用途是求职简历的制作与修改，也常见于校园招聘、实习申请和留学申请等需要提交个人材料的情形^[2]。工具导航站的介绍把适用人群概括为求职者、应届毕业生以及准备转换工作的职场人士^[13]。

使用方式主要有两种：直接访问作者提供的在线版本，或者借助 Docker 把项目部署到自己的服务器上，后一种方式可以让简历数据不必离开本地环境^[3]。此外已有第三方开发者在其代码基础上做了二次开发^[14]。

局限

模板数量偏少、定制能力主要依赖预设模板，是使用反馈中较常被提到的不足，功能本身也相对简单，未必能满足需求复杂的使用者^[4]。

AI 润色与语法检查需要使用者自行准备模型接口密钥并承担相应费用，未作配置时只能使用基础编辑与导出功能^[9]。

简历数据默认只保存在浏览器本地，更换设备或浏览器之后原有内容不会自动同步，需要依靠导出的文件另行备份；作者把在线简历托管列在尚未完成的路线图当中^[6][13]。

源码虽然以 Apache 2.0 协议发布，但附加条款禁止未经授权的商业使用，将其作为服务面向公众提供，或者用于企业商业运营，都需要另行取得授权^[6]。

社区中也有使用者反馈，调整字体与行距时页面出现卡顿，导出环节曾遇到接口报错^[15]。

参见

• 开源软件 —— 魔方简历以开源方式发布，个人可以免费使用其源码。

• 大语言模型 —— 该工具的文本润色与语法检查依赖外部大模型完成。

• DeepSeek —— 魔方简历早期即集成并使用的大模型之一。

• Docker —— 用于把该工具部署在自有服务器上的一种方式。

• 可移植文档格式 —— 简历导出时使用的主要文件格式之一。