# 求职计 Career Gambit 使用指南

> AI 驱动的一站式求职备战平台 —— 从岗位分析到面试通关，全链路覆盖

***

## 目录

1. [快速开始](#1-快速开始)
2. [个人仓库](#2-个人仓库)
3. [岗位拆解](#3-岗位拆解)
4. [沟通助手](#4-沟通助手)
5. [简历定制](#5-简历定制)
6. [面试备战](#6-面试备战)
7. [投递看板](#7-投递看板)
8. [AI 助手](#8-ai-助手)
9. [API 设置](#9-api-设置)
10. [岗位关联机制](#10-岗位关联机制)
11. [数据导出与隐私](#11-数据导出与隐私)
12. [快捷键与小技巧](#12-快捷键与小技巧)

***

## 1. 快速开始

### 注册与登录

1. 点击右上角「请登录以同步云端」按钮
2. 输入邮箱和密码登录，或点击底部「还没有账户？立即注册」
3. 注册成功后即可直接登录，暂无需确认邮件
4. 登录成功后，数据自动同步到云端

### 修改密码

- **方式一**：点击右上角用户名 → 展开「登录密码」→ 输入新密码 + 确认密码 → 保存
- **方式二**：联系开发者，开发者将在 Supabase 后台发送密码重置邮件 → 点击邮件中的链接 → 页面自动弹出重置密码弹窗

### 首次使用建议流程

```
① API 设置 → 配置你的 AI 接口（必须先做，否则 AI 功能无法使用）
② 个人仓库 → 录入你的教育背景、工作经历、项目经验等素材
③ 投递看板 → 新建岗位记录
④ 关联岗位 → 在岗位拆解/沟通助手/简历定制/面试备战页面关联具体岗位
⑤ 逐模块使用 → 岗位拆解 → 沟通助手 → 简历定制 → 面试备战
```

***

## 2. 个人仓库

> 你的求职素材中心，所有模块的数据源头

### 功能说明

个人仓库是 Career Gambit 的**数据基石**，简历定制、沟通助手、面试备战等模块都会从这里提取你的背景信息与人物画像。

### 分类管理

- 系统预设了常见分类（教育背景、工作经历、项目经验等）
- 点击「+ 添加分类」创建自定义分类
- 每个分类下可添加多个内容条目

### 内容条目

每个条目包含：

- **标题**：条目名称（如「XX公司产品经理实习」）
- **副标题**：补充说明（如「2023.06 - 2024.03」）
- **详细内容**：具体描述
- **标签**：关键词标记，方便检索
- **自定义字段**：可添加任意键值对（如「薪资范围：15-20K」）

### 💡 使用技巧

- **越详细越好**：AI 生成简历和面试答案时，会从个人仓库提取信息。素材越丰富，生成内容越精准
- **自由笔记模式**：个人仓库采用灵活的笔记式存储，支持完全自定义分类与内容。无论是成文的经历描述，还是零碎的灵感片段，都可以随时记录，AI 会从这些信息中构建你的人物画像
- **善用标签**：给条目打上技能标签（如「Python」「项目管理」），沟通助手会自动提取这些标签
- **分类即简历板块**：个人仓库的分类会自动映射为简历的板块结构，建议按「个人信息 → 工作经历 → 教育背景 → 项目经历 → 技能特长」组织

### 导出

支持 Word / PDF / Markdown / JSON 四种格式导出

***

## 3. 岗位拆解

> AI 帮你读懂 JD，精准评估匹配度

### 三种输入方式

| 方式           | 适用场景           | 说明              |
| ------------ | -------------- | --------------- |
| **文字输入**     | 已有 JD 文本       | 直接粘贴岗位描述        |
| **URL 抓取**   | 招聘网站链接         | 输入网址，系统自动抓取页面内容 |
| **PDF/图片上传** | 截图或 PDF 格式的 JD | 系统使用 OCR 自动提取文字 |

### 分析结果

点击「立即深度解析」后，AI 会生成：

1. **原文与翻译对比**：将 JD 中的专业术语、行业黑话翻译成通俗解读
2. **匹配度评估**：基于你的个人仓库信息，评估你与岗位的匹配程度
3. **优势与劣势分析**：明确你的竞争力和需要补强的方向
4. **AI 战略建议**：包含差距分析、补齐方案、学习资源推荐、技能提升路径、面试话术补救策略

### 💡 使用技巧

- **先关联岗位再分析**：关联岗位后，分析结果会自动保存到该岗位记录，方便后续查看
- **可编辑 JD 原文**：分析前可以修改抓取到的文本，去除无关信息，提高分析精准度
- **单个条目可重新生成**：对不满意的翻译条目，点击刷新图标单独重新生成
- **战略建议是金矿**：AI 战略建议中的「面试话术补救策略」可以直接用于面试准备

***

## 4. 沟通助手

> AI 帮你写求职信、沟通话术、跟进邮件

### 配置项

| 配置         | 选项                 | 说明                  |
| ---------- | ------------------ | ------------------- |
| **语气预设**   | 专业正式 / 亲和务实 / 直截了当 | 决定文案的整体风格           |
| **核心技能标签** | 从个人仓库自动提取          | 选择你想突出的技能亮点         |
| **补充说明**   | 自由输入               | 补充 AI 需要知道的特殊信息     |
| **结尾行动指令** | 多种预设选项             | 如「期待您的回复」「方便时电话沟通」等 |

### 操作流程

1. 选择语气预设
2. 勾选核心技能标签（AI 会整合为 3-5 个要点）
3. 输入补充说明（可选）
4. 选择结尾行动指令
5. 点击「合成文案」
6. 生成后可手动编辑，也可点击「润色优化」让 AI 优化
7. 一键复制使用

### 💡 使用技巧

- **关联岗位后效果更好**：关联岗位后，AI 会结合 JD 信息生成更有针对性的文案
- **核心技能选 3-5 个**：太多会分散重点，太少显得单薄
- **补充说明很关键**：比如「我是转行选手，需要强调学习能力」，AI 会据此调整文案策略
- **润色 ≠ 重写**：润色只优化语言表达，不会改变内容结构

***

## 5. 简历定制

> 三种模式，总有一款适合你

### 模式选择

| 模式       | 适合人群       | 核心逻辑                  |
| -------- | ---------- | --------------------- |
| **空白组装** | 从零开始写简历    | AI 从个人仓库提取内容，按结构化模板生成 |
| **导入对比** | 已有简历，想优化   | 导入现有简历，AI 逐段或全篇优化     |
| **借壳重构** | 想模仿优秀简历的结构 | 上传参考简历，AI 用你的经历替换内容   |

### 空白组装

1. 系统自动从个人仓库同步分类为简历板块
2. 可输入「自定义指令」影响 AI 生成（如「突出管理经验」「控制在一页内」）
3. 点击「开始组装」→ AI 生成简历 HTML 预览
4. 「润色优化」仅对当前预览内容进行语言优化，不重新获取数据

### 导入对比

1. 在左侧文本框粘贴或导入你的简历
2. 选中左侧「我的简历」文本中的任意段落
3. 三个 AI 操作按钮：
   - **「针对局部修改」**：对选中段落结合个人仓库和岗位 JD 进行适度改写
   - **「全篇深度润色」**：对整篇简历进行深度优化，结合个人仓库和岗位 JD 洞察
   - **「确认应用修改」**：将 AI 改写后的内容应用到左侧文本
4. 左侧「我的简历」文本框为最终导出源

### 借壳重构

1. 选择输入方式：文本粘贴 / PDF 上传 / 图片上传
2. 上传参考简历（可以是别人的优秀简历）
3. AI 分析参考简历的叙事逻辑和表达风格
4. 用你个人仓库的真实经历替换模板内容
5. 两个操作按钮：
   - **「开始重构」**：执行借壳重构，生成重构预览
   - **「发送到左侧」**：将重构结果发送到「我的简历」Tab
6. 「我的简历」Tab 为最终导出源（非右侧预览区）

### 💡 使用技巧

- **借壳重构是杀手锏**：找到目标岗位的优秀简历作为参考，AI 会帮你「穿上它的壳，填上你的肉」
- **自定义指令很有用**：试试输入「用数据量化成果」「减少形容词，多用动词」等指令
- **组装和润色是独立的**：组装会重新从个人仓库获取数据，润色只优化现有内容
- **预览区可以交互**：导入对比模式下，选中左侧文本后会出现 AI 操作按钮
- **OCR 推荐用 Vision 模型**：上传图片或 PDF 时，建议使用支持 Vision 能力的 AI 模型进行文字识别，识别准确率更高

***

## 6. 面试备战

> AI 出题 + AI 答题 + AI 模拟面试，三位一体

### 三个子视图

| Tab      | 功能         | 数据范围      |
| -------- | ---------- | --------- |
| **岗位备战** | 为特定岗位生成面试题 | 跟随岗位（关联时） |
| **原子题库** | 管理所有面试题和答案 | 全局（不跟随岗位） |
| **模拟面试** | AI 全真模拟面试  | 根据模式决定    |

### 岗位备战流程

1. 关联岗位后，点击「一键生成/刷新预测」
2. AI 生成面试问题，按分类组织
3. 批量待筛选区显示两部分：
   - **库中已存在**：原子题库中已有的题目（标记为「库中已存在」）
   - **AI 新生成**：原子题库以外的新题目
4. 点击问题卡片 → 移入「待撰写区」
5. 在待撰写区编辑答案或使用 AI 生成答案
6. 点击「确认为本岗定稿」→ 移入「已完成定稿区」

### 原子题库

- **分类管理**：8 个预设分类 + 自定义分类
  - 预设分类：自我认知 / 过往经历 / 求职动机 / 岗位匹配 / 能力考验 / 未来规划 / 行业认知 / 反向提问
  - 点击「自定义分类」按钮添加新分类
- **多版本答案**：每个问题支持多个答案版本，可添加/切换/删除
- **AI 生成答案**：AI 会根据个人仓库信息模仿你的说话方式来写面试回答，并根据题目类型自动选择回答结构（经历型用 STAR 法则、动机型用叙事式、认知型用观点式等），回答长度也会根据题目性质自动调整

### 模拟面试

#### 两种模式

| 模式          | 说明          | 题目来源                  |
| ----------- | ----------- | --------------------- |
| **全真面试竞技场** | 模拟真实面试，题目随机 | 岗位定稿题（关联时）或原子题库（未关联时） |
| **专项重点突破**  | 聚焦单分类深度训练   | 选定维度的题目               |

#### 面试流程

```
选择模式 → 选择维度（专项模式）→ 设置题数和抽取规则
→ AI 开场白（语音朗读）→ 逐题作答 → AI 评估是否追问
→ 追问环节 → 面试结束
```

#### 语音输入

系统自动选择最佳语音输入方式：

1. **首选**：浏览器语音识别（Chrome/Edge，需网络）
2. **备选**：Whisper API 语音转写（需 AI 接口支持）
3. **兜底**：手动打字输入

#### 💡 使用技巧

- **自我介绍永远排第一**：如果题目中包含自我介绍类问题，系统会自动将其排在第一位
- **AI 会追问**：AI 判断你的回答值得深挖时会自动追问，追问内容可以添加到原子题库或岗位待撰写
- **均匀分布 vs 随机抽取**：均匀分布确保每个分类都有题目，随机抽取更接近真实面试
- **专项训练维度选择页**：显示每个分类的实际可用题目数，帮你做出选择
- **追问也能加题库**：面试中遇到好的追问，点击「添加到原子题库」按钮（会变色反馈）

***

## 7. 投递看板

> 管理所有投递记录，一站式查看岗位详情

### 岗位记录管理

- **添加记录**：点击「手动录入岗位」填写公司名和岗位名
- **编辑**：直接点击公司名或岗位名进行行内编辑
- **删除**：点击删除图标，删除会即时同步到云端
- **投递上限**：已登录普通用户最多 10 条

### 状态跟踪

6 种投递状态：投递中 → 面试中 → 已沟通 → 意图中 → 已 offer → 已拒绝

### 岗位详情中心

点击岗位卡片的「进入该岗位编辑环境」图标，进入岗位详情中心，可以：

- 查看/编辑 JD 快照
- 查看分析结果
- 查看沟通文案
- 查看简历定制
- 查看面试备战

### AI 洞察

- 基于投递数据进行多维度分析
- 输入：个人仓库信息 + 投递数据统计 + 岗位 JD 和复盘笔记
- 提供投递策略建议、成功率分析、面试失败原因等

### 模块化导出

1. 点击岗位卡片的「模块化导出」按钮
2. 选择要导出的模块（岗位拆解 / 沟通文案 / 简历 / 面试题库）
3. 面试题库可按分类维度筛选
4. 选择格式（Word / PDF / Markdown / JSON）
5. 生成导出

### 💡 使用技巧

- **先建岗位再关联**：在投递看板新建岗位后，到其他模块关联该岗位，数据自动流转
- **JD 快照很重要**：添加岗位时粘贴 JD，后续岗位拆解可以直接使用
- **保存按钮**：登录后，修改数据会出现「有未保存的更改」提示，记得点击保存同步到云端

***

## 8. AI 助手

> 随时唤起的 AI 对话伙伴

### 打开方式

- 点击侧边栏底部的「AI 助手」按钮
- 快捷键：`Ctrl + K` 或 `Ctrl + J`（Mac 上为 `Cmd + K` / `Cmd + J`）

### 面板操作

| 操作   | 方法                 |
| ---- | ------------------ |
| 移动位置 | 拖拽标题栏              |
| 调整大小 | 拖拽右下角              |
| 发送消息 | 输入后按 `Enter`       |
| 换行   | `Shift + Enter`    |
| 粘贴图片 | `Ctrl + V` 或点击上传按钮 |
| 复制回复 | 点击回复内容下方的复制按钮      |
| 清空对话 | 点击垃圾桶图标            |

### 💡 使用技巧

- **图片识别**：粘贴面试题截图、JD 截图等，AI 可以识别并回答
- **多轮对话**：AI 会记住最近 10 条对话历史，可以追问
- **随时唤起**：在任何页面按 `Ctrl+K` 快速打开，不用切换页面

***

## 9. API 设置

> 配置你的 AI 引擎，所有 AI 功能的前提

### 配置项

| 字段     | 说明         | 示例                           |
| ------ | ---------- | ---------------------------- |
| 节点名称   | 自定义配置名     | 「我的 DeepSeek」                |
| API 域名 | 接口基础地址     | `https://api.deepseek.com`   |
| 接口类型   | 协议类型       | OpenAI(通用) / Gemini / Claude |
| API 路径 | 接口路径       | `/v1/chat/completions`       |
| API 密钥 | 你的 API Key | `sk-xxx...`                  |
| 模型名称   | 模型标识符      | `deepseek-chat`              |

### 接口类型说明

| 类型             | 能否直连官方 | 说明                                  |
| -------------- | ------ | ----------------------------------- |
| **OpenAI(通用)** | ✅ 可以   | 兼容所有 OpenAI 格式的 API（DeepSeek、通义千问等） |
| **Gemini**     | ❌ 需代理  | 需通过支持 OpenAI 兼容格式的代理服务              |
| **Claude**     | ❌ 需代理  | 需通过支持 OpenAI 兼容格式的代理服务              |

### 操作流程

1. 填写配置信息
2. 点击「开始连接」测试
3. 连接成功后显示绿色指示灯
4. 点击「保存配置」持久化

### 历史配置

- 点击「历史配置」查看所有已保存的配置
- 可快速切换不同配置
- 可删除不需要的配置

### 💡 使用技巧

- **保存多个配置**：不同场景用不同模型（如日常用普通模型，OCR 识别需用到 Vision 模型，语音面试时用支持 Whisper 的接口）
- **连接测试很重要**：保存前先测试，确保 API 可用

***

## 10. 岗位关联机制

> Career Gambit 的核心设计，让数据按岗位隔离流转

### 什么是岗位关联？

岗位关联是将当前工作状态绑定到某个具体投递记录的机制。关联后：

- 所有模块的数据自动保存到该岗位
- 切换岗位时自动加载对应数据
- 退出关联时数据重置为默认值

### 如何关联

1. 在投递看板新建岗位记录
2. 在任意功能页面顶部点击「关联岗位」按钮
3. 从下拉列表选择目标岗位
4. 关联成功后显示「公司名 - 岗位名」标签

### 数据流转

```
关联岗位 → 从 JobRecord 加载该岗位的专属数据 → 各模块 State 更新
         → 操作数据 → 自动保存到 localStorage
         → 点击保存 → 同步到 Supabase + 写回 JobRecord

退出关联 → 各模块 State 重置为默认值 → 不影响已保存的岗位数据

重新关联 → 从 JobRecord 重新加载 → 恢复该岗位的专属数据
```

### 💡 使用技巧

- **不关联也能用**：未关联岗位时，所有模块仍可正常使用（临时模式），数据存 localStorage
- **关联后再分析效果更好**：岗位拆解、沟通助手、简历定制关联岗位后，AI 会结合 JD 信息
- **面试备战关联后更精准**：关联岗位后，AI 生成的面试问题会针对该岗位的 JD
- **个人仓库不受岗位影响**：个人仓库是全局数据，不跟随岗位变化
- **临时模式注意**：临时模式下数据存在 localStorage，如果想回到初始状态可以清空浏览器 localStorage

***

## 11. 数据导出与隐私

### 导出方式

| 方式     | 入口            | 格式                     | 范围        |
| ------ | ------------- | ---------------------- | --------- |
| 模块独立导出 | 各模块页面的导出按钮    | Word/PDF/Markdown/JSON | 当前模块数据    |
| 模块化导出  | 投递看板 → 模块化导出  | Word/PDF/Markdown/JSON | 选中模块（按岗位） |
| 全量导出   | API 设置 → 数据控制 | Markdown               | 所有数据      |

### 全量导出结构

```
# Career Gambit 全量数据导出
├── 一、个人仓库（所有分类和条目）
├── 二、原子题库（所有问题和答案版本）
├── 三、求职加油站（励志语录）
├── 四、公司A - 岗位名1
│   ├── 岗位拆解
│   ├── 沟通助手
│   ├── 简历定制
│   └── 面试备战
├── 五、公司B - 岗位名2
│   └── ...
```

### 数据安全

- **双层存储**：localStorage（离线兜底）+ Supabase（云端同步，AES 加密）
- **API Key 加密**：API 密钥在 Supabase 中使用 AES 加密存储
- **RLS 行级安全**：Supabase 表启用行级安全策略，用户只能访问自己的数据
- **物理销毁**：可在 API 设置页面一键销毁所有云端数据（不可恢复，覆盖 19 张表）

### 💡 使用技巧

- **定期全量导出**：建议重要数据做好全量导出备份
- **面试前模块化导出**：面试前用模块化导出，只导出该岗位的面试题库，打印随身携带
- **销毁前先导出**：物理销毁不可恢复，务必先全量导出备份

***

## 12. 快捷键与小技巧

### 键盘快捷键

| 快捷键             | 功能               |
| --------------- | ---------------- |
| `Ctrl/Cmd + K`  | 打开/关闭 AI 助手      |
| `Ctrl/Cmd + J`  | 打开/关闭 AI 助手      |
| `Enter`         | AI 助手发送消息        |
| `Shift + Enter` | AI 助手换行          |
| `Ctrl + V`      | AI 助手粘贴图片        |
| `Enter`         | UserBar 保存用户名/密码 |
| `Escape`        | UserBar 取消编辑     |
| `Enter`         | 求职加油站添加语录        |

### 隐藏功能

| 功能            | 位置        | 说明                                          |
| ------------- | --------- | ------------------------------------------- |
| **求职加油站**     | 右下角橙色闪电按钮 | 随机励志语录，点击齿轮可自定义添加/删除语录                      |
| **未保存更改提示**   | 各模块顶部     | 有更改时显示琥珀色脉冲提示，已同步显示绿色                       |
| **面试追问加题库**   | 模拟面试追问后   | 点击「添加到原子题库」按钮会变色反馈                          |
| **JD 单条重新生成** | 岗位拆解页面    | 对不满意的翻译条目点击刷新图标单独重生成                        |
| **简历预览区交互**   | 导入对比模式    | 选中左侧文本后出现 AI 操作按钮（针对局部修改 / 全篇深度润色 / 确认应用修改） |
| **投递记录行内编辑**  | 投递看板      | 直接点击公司名/岗位名即可编辑                             |

### 最佳实践

1. **先配 API，再做事**：API 设置是所有 AI 功能的前提
2. **个人仓库要充实**：素材越丰富，AI 生成越精准；信息不怕零碎，AI 会从碎片中构建完整画像
3. **善用岗位关联**：关联后数据自动流转，避免重复操作
4. **多版本答案**：面试答案写多个版本，根据岗位选择最合适的定稿
5. **借壳重构找好参考**：参考简历的质量直接决定输出质量
6. **定期保存到云端**：看到「有未保存的更改」提示时及时保存

***

*Career Gambit —— 让每一次求职都有备而来*