# resumeforge

**Repository Path**: artdong/resumeforge

## Basic Information

- **Project Name**: resumeforge
- **Description**: resumeforge
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-23
- **Last Updated**: 2026-08-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ResumeForge

ResumeForge 是一个面向求职者的专业简历优化工作台，支持选择不同 AI 引擎分析简历，识别表达和岗位匹配问题，并生成更有说服力的优化版本。

## 技术栈

- Next.js 16 + React 19 + TypeScript
- Tailwind CSS 4 + 自定义 CSS 视觉层
- Next.js Route Handler + Zod
- Drizzle ORM + PostgreSQL（可选配置）
- OpenAI / DeepSeek 服务端 Provider Adapter

## 本地运行

```bash
npm install
cp .env.example .env.local
npm run dev
```

不配置 API Key 时，分析接口会返回明确标记的演示结果，方便先体验完整流程。配置 `OPENAI_API_KEY` 或 `DEEPSEEK_API_KEY` 后，`/api/analyze` 会在服务端调用对应模型并校验结构化返回结果。页面的 AI 配置也支持覆盖 API Key、模型名称、Base URL 和上游协议；目前兼容 Responses API 与 Chat Completions，本地 OpenAI-compatible 服务可以不设置 API Key。

## 当前能力

工作台包含模型切换、PDF / DOCX / TXT 服务端文本提取、简历文本粘贴、目标岗位、分析 loading、评分、重点发现、原始/优化稿切换、复制全文和导出优化稿。扫描版 PDF 仍需要后续接入 OCR；对象存储与异步 Worker 的配置入口已保留。

## 浏览器插件

项目保留原有 Web 应用，同时新增 `extension/` 作为 Chrome Manifest V3 插件入口。插件复用 `ResumeWorkbench` 前端组件，并通过可配置的 Web 服务地址调用现有 `/api/parse` 和 `/api/analyze` 后端能力。

本地开发流程：

```bash
# 1. 启动 Web 后端与 Web 版
npm run dev

# 2. 构建插件
npm run extension:build
```

然后打开 Chrome 的 `chrome://extensions`，启用开发者模式，选择“加载已解压的扩展程序”，目录选择 `dist/extension`。弹窗默认连接 `http://localhost:3000`；部署后可在插件顶部的“服务地址”改成线上域名。

普通插件弹窗受 Chrome 尺寸限制，适合快速导入和启动分析。需要更大的工作区时，点击插件顶部的“打开新标签”，会在新的浏览器标签页中打开与 Web 版一致的完整 ResumeForge 工作台；也可以点“侧边栏”在 Chrome Side Panel 中打开可停靠工作台。

生产部署时，如果插件调用线上 Web API，请在服务端配置允许来源，例如：

```bash
RESUMEFORGE_ALLOWED_ORIGINS=chrome-extension://你的扩展ID,https://你的站点域名
```

插件支持读取当前网页选中文本并导入工作台。由于文件解析和 AI 调用继续留在 Next.js 服务端，API Key 不需要打包进插件。需要用户自带 Key 时，可继续使用工作台里的“AI 配置”。