# offerPilog

**Repository Path**: helloningdog/offer-pilog

## Basic Information

- **Project Name**: offerPilog
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-10-27
- **Last Updated**: 2026-10-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OfferPilot · 求职副驾

从前端转 AI Agent 的第一个真实产品：读简历、对 JD、补信息、改表达。

**完整学习与实现手册 → [工程.md](./工程.md)**

## 当前进度

| 里程碑 | 内容 | 状态 |
| --- | --- | --- |
| M0 | 流式聊天骨架（Next.js + AI SDK + DeepSeek） | ✅ 已实现 |
| M1 | 工具调用：读简历、算匹配度 | ⬜ 待实现 |
| M2 | RAG：岗位能力知识库 + 引用 | ⬜ 待实现 |
| M3 | LangGraph 编排 + 人工介入（补问后恢复） | ⬜ 待实现 |
| M4 | 评测、可观测、部署 | ⬜ 待实现 |

## 技术栈（实测于 2026-10）

| 层 | 选型 | 版本 |
| --- | --- | --- |
| 框架 | Next.js（App Router + Turbopack） | 16.4.3 |
| UI | React + Tailwind CSS 4 | 19.3.0 / 4.3.3 |
| AI 交互 | Vercel AI SDK | ai 7.0.154 / @ai-sdk/react 4.0.158 |
| 模型 | DeepSeek（OpenAI 兼容） | @ai-sdk/deepseek 3.0.74 |
| 校验 | zod | 4.6.7 |
| 编排（M3） | LangGraph.js | 1.5.3 |

## 快速开始

```bash
pnpm install
cp .env.example .env.local   # Windows: Copy-Item .env.example .env.local
# 编辑 .env.local，填入 DEEPSEEK_API_KEY
# Key 本身自带 sk- 前缀，模板里的那个 sk- 要替换掉，别粘成 sk-sk-...
pnpm dev
```

打开 http://localhost:3000 ，随便问一句，能看到文字逐字出现就说明 M0 通过。

## 目录

```
app/
  page.tsx              # 聊天页（客户端组件）
  api/chat/route.ts     # 流式接口：服务端持有 API Key
  layout.tsx
lib/
  prompts.ts            # 系统提示词
data/
  resumes/              # 简历文件（工具读取）
  knowledge/            # 知识库原文（M2 建索引）
```

## 命令

```bash
pnpm dev      # 开发
pnpm build    # 生产构建（Next 16 不再在 build 时跑 lint）
pnpm lint     # ESLint
pnpm start    # 跑生产构建
```