JOYCEQL/magic-resume

它是什么

Magic Resume 是一个在线简历编辑器。它是一个 Web 应用，你可以在浏览器中编写、编辑和美化专业简历，并实时预览。

核心功能（来自 README）

实时预览 — 边输入边查看更改
自定义主题 — 更改简历的外观
深色模式 — 深色配色方案选项
导出为 PDF — 将完成的简历下载为 PDF
自动保存 — 你的工作会自动保存
本地存储 — 数据保存在你的浏览器中，而不是服务器上
响应式设计 — 适用于不同屏幕尺寸
流畅动画 — 由 Framer Motion 驱动
AI 辅助写作 — 列为已完成的路由图项目
多语言支持 — 列为已完成
导入 PDF、Markdown 等 — 列为已完成
自定义模型 — 列为已完成
自动单页 — 列为已完成

技术栈

该项目使用以下技术构建：TanStack Start（React 框架）、TypeScript、Motion（动画库）、Tiptap（富文本编辑器）、Tailwind CSS（样式）、Zustand（状态管理）、Shadcn/ui（UI 组件）和 Lucide Icons。

如何在本地运行

克隆仓库：git clone git@github.com:JOYCEQL/magic-resume.git
安装依赖：pnpm install
启动开发服务器：pnpm dev
在浏览器中打开 http://localhost:3000

部署选项

Docker Compose：在项目根目录运行 docker compose up -d 以构建并启动容器中的应用。
Cloudflare Workers：支持（使用原生 fetch，无需代理）。
Node.js/Docker：如果你的区域无法直接访问 AI 提供商（OpenAI、Gemini、Anthropic），你可以设置 AI_PROXY_URL 或 HTTPS_PROXY/HTTP_PROXY 环境变量。DeepSeek、Qwen 和 Doubao 始终使用直接连接。

可选的 AI 提供商：OrcaRouter

你可以选择 OrcaRouter 作为 AI 提供商。要使用它，你需要通过 README 中的推荐链接注册，然后使用 OrcaRouter 登录或输入你自己的 API 密钥。README 指出这是一个合作伙伴推荐链接 — Magic Resume 可能会从推荐注册的合格使用中赚取佣金。其他 AI 提供商仍然可用。

还有一个可选的 VITE_ORCA_APP_ID 构建时变量，用于应用使用归因。它是一个公共应用标识符（不是密钥），必须在构建时设置 — 在运行中的容器上设置无效。

许可证和使用限制

源代码在 Apache 2.0 下发布，并带有额外的非商业限制：

免费供个人使用 — 学习、制作自己的简历等。
禁止商业用途 — 不允许付费服务（SaaS/PaaS）、企业商业运营、转售或二次商业开发，即使你修改了代码。

路由图状态

已完成： AI 辅助写作、多语言支持、更多导出格式、导入 PDF/Markdown、自定义模型、自动单页。

尚未完成： 更多简历模板、在线简历托管。

项目详情

作者： Siyue
联系方式： X (@GuangzhouY81070)、Discord 社区、电子邮件 (18806723365@163.com)
主页： https://github.com/JOYCEQL/magic-resume
赞助者： 列出两位 — @yj147 和 @someone1128

备注

README 包含星标历史图表和 Trendshift 徽章，表明该项目有一定的社区关注度。
README 没有详细描述简历编辑器本身的工作原理（例如，具体的编辑交互），也没有列出定价、托管演示 URL 或详细的 API 文档。