{"id":28615790,"url":"https://github.com/linmoqc/magic-resume","last_synced_at":"2025-09-08T03:46:47.832Z","repository":{"id":297809382,"uuid":"997317989","full_name":"LinMoQC/Magic-Resume","owner":"LinMoQC","description":"Magic Resume 是一个由 AI 驱动的智能简历优化器。它基于 Next.js 构建，旨在帮助用户根据目标岗位（JD）的要求，智能地分析、优化个人简历，并提供专业建议。","archived":false,"fork":false,"pushed_at":"2025-07-09T09:38:26.000Z","size":5933,"stargazers_count":21,"open_issues_count":2,"forks_count":5,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-08-06T11:15:01.551Z","etag":null,"topics":["ai","langchain","langgraph-js","next","react","typescript"],"latest_commit_sha":null,"homepage":"https://magic-resume.cn","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LinMoQC.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-06T10:20:49.000Z","updated_at":"2025-08-03T04:03:40.000Z","dependencies_parsed_at":"2025-06-07T16:39:11.188Z","dependency_job_id":"f81fe9b3-65d9-43ff-8fb2-7d638d8842f4","html_url":"https://github.com/LinMoQC/Magic-Resume","commit_stats":null,"previous_names":["linmoqc/magic-resume"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/LinMoQC/Magic-Resume","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LinMoQC%2FMagic-Resume","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LinMoQC%2FMagic-Resume/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LinMoQC%2FMagic-Resume/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LinMoQC%2FMagic-Resume/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LinMoQC","download_url":"https://codeload.github.com/LinMoQC/Magic-Resume/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LinMoQC%2FMagic-Resume/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274130201,"owners_count":25227270,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-08T02:00:09.813Z","response_time":121,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","langchain","langgraph-js","next","react","typescript"],"created_at":"2025-06-12T02:10:06.218Z","updated_at":"2025-09-08T03:46:47.806Z","avatar_url":"https://github.com/LinMoQC.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg width=\"455\" alt=\"Magic Resume Logo\" src=\"./public/magic-resume-logo.png\"\u003e\n  \n  \u003cp\u003e\u003cstrong\u003eAI 驱动的现代化简历构建器\u003c/strong\u003e\u003c/p\u003e\n  \n  [![License](https://img.shields.io/github/license/LinMoQC/Magic-Resume?style=flat-square)](https://github.com/LinMoQC/Magic-Resume/blob/master/LICENSE) [![Stars](https://img.shields.io/github/stars/LinMoQC/Magic-Resume?style=flat-square)](https://github.com/LinMoQC/Magic-Resume/stargazers) [![Forks](https://img.shields.io/github/forks/LinMoQC/Magic-Resume?style=flat-square)](https://github.com/LinMoQC/Magic-Resume/network/members) [![Issues](https://img.shields.io/github/issues/LinMoQC/Magic-Resume?style=flat-square)](https://github.com/LinMoQC/Magic-Resume/issues)\n\u003c/div\u003e\n\n---\n\n## 🌟 项目简介\n\n**Magic Resume** 是一款现代化的 AI 驱动简历构建器，采用 Next.js 14 构建。它不仅提供直观的在线编辑体验，还能根据目标职位智能优化简历内容，让您的求职之路更加顺畅。\n\n### ✨ 核心特性\n\n- 🎨 **可视化模板自定义** - 22种精美字体 + 实时颜色/布局调整\n- 🤖 **AI 智能优化** - 根据 JD 自动优化简历内容和匹配度\n- 📊 **专业分析报告** - Lighthouse 风格的简历健康度分析\n- 🌐 **完整国际化** - 中英文界面无缝切换\n- 💾 **本地存储优先** - 数据安全，支持多格式导出\n- 🎯 **实时预览** - 所见即所得的编辑体验\n\n---\n\n## 🏗️ 技术架构\n\n\u003cdiv align=\"center\"\u003e\n\n| 分类 | 技术栈 |\n|------|-------|\n| **前端框架** | Next.js 14 · React 18 · TypeScript |\n| **UI 设计** | Tailwind CSS · Radix UI · shadcn/ui · Framer Motion |\n| **AI 能力** | OpenAI API · Tavily Search · LangChain |\n| **用户认证** | Clerk · NextAuth (可选) |\n| **第三方集成** | GitHub API · 后端服务支持 |\n| **状态管理** | Zustand · Immer |\n| **富文本** | Tiptap Editor · Dnd Kit |\n| **工具链** | ESLint · Husky · Zod |\n\n\u003c/div\u003e\n\n## 📁 项目结构\n\n```\nresume/\n├── src/\n│   ├── app/                    # Next.js App Router\n│   │   ├── dashboard/          # 仪表盘页面\n│   │   ├── components/         # 全局组件\n│   │   └── globals.css         # 全局样式\n│   ├── templates/              # 简历模板系统\n│   │   ├── config/             # 模板配置\n│   │   ├── templateLayout/     # 布局组件\n│   │   ├── TemplateCustomizer/ # 自定义器组件\n│   │   └── renderer/           # 渲染引擎\n│   ├── lib/                    # 工具库\n│   ├── store/                  # 状态管理\n│   ├── locales/                # 国际化\n│   └── prompts/                # AI 提示词\n└── public/                     # 静态资源\n```\n\n## 🚀 快速开始\n\n### 📦 安装与配置\n\n```bash\n# 1. 克隆项目\ngit clone https://github.com/LinMoQC/Magic-Resume.git\ncd Magic-Resume\n\n# 2. 安装依赖\nnpm install\n\n# 3. 配置环境变量\ncp .env.local.example .env.local\n# 编辑 .env.local 填入您的密钥\n```\n\n### 🔑 环境变量配置\n\n创建 `.env.local` 文件进行配置：\n\n```bash\n# 必需配置\nNEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_xxx\nCLERK_SECRET_KEY=sk_test_xxx\n\n# 可选配置 - Google Analytics\nNEXT_PUBLIC_GA_ID=G-XXXXXXXXXX\n```\n\n**核心配置项：**\n\n| 配置类别 | 必需性 | 说明 |\n|---------|-------|------|\n| **Clerk 认证** | ✅ 必需 | 用户登录注册系统 |\n| **Google Analytics** | ⚙️ 可选 | 网站流量分析 |\n| **后端服务** | ⚙️ 可选 | 完整后端支持 |\n\n### 🏃‍♂️ 运行项目\n\n```bash\n# 开发环境\nnpm run dev\n\n# 生产构建\nnpm run build \u0026\u0026 npm run start\n\n# 代码检查\nnpm run lint\n```\n\n打开 [http://localhost:3000](http://localhost:3000) 开始使用！\n\n### 🔧 详细配置指南\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e📋 Clerk 用户认证配置 (必需)\u003c/strong\u003e\u003c/summary\u003e\n\n1. 访问 [Clerk.com](https://clerk.com/) 注册账号\n2. 创建新应用，选择认证方式\n3. 在 Dashboard → API Keys 获取密钥：\n   ```env\n   NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_xxx\n   CLERK_SECRET_KEY=sk_test_xxx\n   ```\n4. 配置重定向URL（可选）\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🤖 AI 功能配置 (可选)\u003c/strong\u003e\u003c/summary\u003e\n\n**OpenAI API** - 简历智能优化\n1. 访问 [OpenAI Platform](https://platform.openai.com/) \n2. 创建 API 密钥\n3. 配置：`OPENAI_API_KEY=sk-xxx`\n\n**Tavily API** - 智能搜索增强\n1. 访问 [Tavily.com](https://tavily.com/)\n2. 注册并获取 API 密钥\n3. 配置：`TAVILY_API_KEY=tvly-xxx`\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e📱 GitHub 集成 (可选)\u003c/strong\u003e\u003c/summary\u003e\n\n用于从 GitHub 导入项目数据：\n1. 访问 [GitHub Settings → Tokens](https://github.com/settings/tokens)\n2. 生成 Personal Access Token\n3. 配置：`GITHUB_TOKEN=ghp-xxx`\n4. 权限选择：`repo`, `user:email`\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🚀 后端服务配置 (可选)\u003c/strong\u003e\u003c/summary\u003e\n\n如需使用完整后端功能：\n1. 启动后端服务（通常在端口 8000）\n2. 配置后端地址：`BACKEND_URL=http://127.0.0.1:8000`\n3. 启用后端：`NEXT_PUBLIC_IF_USE_BACKEND=true`\n4. 详见后端项目的部署文档\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e📊 Google Analytics 配置 (可选)\u003c/strong\u003e\u003c/summary\u003e\n\n**网站流量分析** - 了解用户行为和网站性能\n1. 访问 [Google Analytics](https://analytics.google.com/)\n2. 创建账户和媒体资源\n3. 获取测量ID：`NEXT_PUBLIC_GA_ID=G-XXXXXXXXXX`\n\n**隐私保护特性**：\n- 仅在生产环境启用\n- 其他用户部署时不会影响您的数据\n- 支持自定义事件追踪\n\n详细配置请参考：[ANALYTICS_SETUP.md](./ANALYTICS_SETUP.md)\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🔐 认证系统配置\u003c/strong\u003e\u003c/summary\u003e\n\n**Clerk (推荐)** - 现代认证方案\n- 完整的用户管理界面\n- 多种登录方式支持\n\n**NextAuth (可选)** - 传统认证方案  \n- 配置：`NEXTAUTH_URL` 和 `NEXTAUTH_SECRET`\n- 适用于自定义认证需求\n\n\u003c/details\u003e\n\n## 💡 功能特性详解\n\n### 🎨 模板自定义系统\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n**颜色主题**\n- 5种快速主题切换\n- 6种详细颜色配置\n- 实时预览效果\n\n**字体系统**  \n- 22种精选字体\n- 包含现代、手写、科技感字体\n- 6级字体大小调节\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n**布局控制**\n- 容器宽度调整 (600-1000px)\n- 内边距和间距设置\n- 文本行高和字符间距\n- 段落和章节间距\n\n**实时保存**\n- 自动保存配置差异\n- 减少90%存储空间\n- 完整的撤销/重做\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### 🤖 AI 智能功能\n\n| 功能 | 技术支持 | 描述 |\n|-----|---------|------|\n| **智能优化** | OpenAI GPT | 根据 JD 自动优化简历内容 |\n| **健康分析** | AI 分析引擎 | Lighthouse 风格的专业分析 |\n| **引导创建** | 对话式 AI | AI 对话式简历生成 |\n| **智能搜索** | Tavily API | 增强的网络搜索能力 |\n| **GitHub 集成** | GitHub API | 自动导入项目经历 |\n\n## 📸 产品预览\n\n\u003cdiv align=\"center\"\u003e\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\" width=\"50%\"\u003e\u003cstrong\u003e🎨 模板自定义\u003c/strong\u003e\u003c/td\u003e\n    \u003ctd align=\"center\" width=\"50%\"\u003e\u003cstrong\u003e🤖 AI 智能优化\u003c/strong\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=\"./public/magic-resume-preview.png\" alt=\"模板自定义\" style=\"border-radius: 8px;\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"./public/magic-resume-optimize.png\" alt=\"AI 智能优化\" style=\"border-radius: 8px;\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003cstrong\u003e💬 AI 对话助手\u003c/strong\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cstrong\u003e🎯 文本选择优化\u003c/strong\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=\"./public/magic-resume-chat.png\" alt=\"AI 对话助手\" style=\"border-radius: 8px;\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"./public/magic-resume-select.png\" alt=\"智能模板选择\" style=\"border-radius: 8px;\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003cstrong\u003e📊 专业分析\u003c/strong\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cstrong\u003e📱 多端适配\u003c/strong\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=\"./public/magic-resume-analysis.png\" alt=\"专业分析\" style=\"border-radius: 8px;\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"./public/magic-resume-import.png\" alt=\"多端适配\" style=\"border-radius: 8px;\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\u003c/div\u003e\n\n---\n\n## 🤝 参与贡献\n\n我们欢迎所有形式的贡献！无论是新功能、Bug 修复、文档改进还是问题反馈。\n\n### 📋 贡献指南\n\n1. **Fork 项目** 并创建您的功能分支\n2. **提交变更** 并编写清晰的 commit 信息  \n3. **推送到分支** 并创建 Pull Request\n4. **等待审核** 我们会尽快回复\n\n```bash\ngit checkout -b feature/amazing-feature\ngit commit -m 'feat: 添加某个很棒的功能'\ngit push origin feature/amazing-feature\n```\n\n### 💻 贡献者\n\n感谢所有为 Magic Resume 做出贡献的开发者！\n\n\u003ca href=\"https://github.com/LinMoQC/Magic-Resume/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=LinMoQC/Magic-Resume\" alt=\"contributors\" /\u003e\n\u003c/a\u003e\n\n---\n\n## 📈 Star History\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://star-history.com/#LinMoQC/Magic-Resume\u0026Date\"\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=LinMoQC/Magic-Resume\u0026type=Date\u0026theme=dark\" /\u003e\n      \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=LinMoQC/Magic-Resume\u0026type=Date\" /\u003e\n      \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=LinMoQC/Magic-Resume\u0026type=Date\" /\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n---\n\n## 📄 开源协议\n\n本项目基于 [MIT License](LICENSE) 开源协议。\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003e如果这个项目对您有帮助，请考虑给我们一个 ⭐\u003c/p\u003e\n  \u003cp\u003eMade with ❤️ by Magic Resume Team\u003c/p\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinmoqc%2Fmagic-resume","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flinmoqc%2Fmagic-resume","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinmoqc%2Fmagic-resume/lists"}