user-guide.md

# 使用指南

本指南面向在本机使用 ResumeForge 的求职者。安装、启动和版本升级分别见
[README](../README.md#-快速开始) 与 [升级与数据安全](upgrading.md)。

ResumeForge 的推荐流程是：维护完整个人资料 → 录入目标岗位 → 生成或编写岗位版简历 →
预览、微调和导出。AI 生成、岗位需求解读、岗位化建议和求职助手需要配置模型；岗位和资料
的粘贴识别优先使用已配置的模型做结构化抽取，未配置模型或模型不可用时才退回本地规则，因此始终可离线运行。

## 启动与平台

- **Windows**：在项目根目录双击 `start.cmd`，它会准备依赖、启动前后端并打开浏览器；关闭应用后再次双击即可启动。
- **macOS**：在项目根目录双击 `start.command`，做的事情与 Windows 完全相同（准备运行时 → 建虚拟环境 →
  装依赖 → 启动前后端 → 打开浏览器）。停止用 `stop.command`，更新用 `update.command`。
  - **不需要预装任何东西**：缺少的 Python 与 Node.js 会以**便携版**下载并解压到 `runtime/tools/`，
    **不写 `/usr/local`、不需要管理员密码、不碰 Homebrew / nvm**；删掉项目目录就等于卸载干净。
  - Python 版本窗口是 3.11 ~ 3.13，Node.js 需要 20.19.0 或更新版本——两者都缺时启动器会自己准备。
  - **第一次双击可能被系统拦下**：macOS 会拦住所有"从网上下载、未经 Apple 签名"的程序，提示
    「无法打开，因为 Apple 无法检查它是否包含恶意软件」。这不是代码问题。任选一种处置，**只需一次**：
    在 Finder 里**右键点 `start.command` → 打开**再点一次「打开」；或在「终端」里进入项目目录执行
    `xattr -dr com.apple.quarantine .`。
  - **也可以装桌面安装包（.dmg，v1.0.1 起提供）**：到 Release 页面下载对应架构的 dmg（目前为 x64；Apple Silicon
    机型经 Rosetta 2 运行），双击安装后从「应用程序」打开。安装包未签名，首次打开需右键 →「打开」，或在终端执行
    `xattr -dr com.apple.quarantine /Applications/ResumeForge.app`；用户数据在 `~/Library/Application Support/ResumeForge/`，
    覆盖安装不会丢。首次启动会在线装配 Python 运行时（需联网，数分钟）。
  - 双击**没反应**时（某些解压工具会丢掉可执行位），在「终端」里进入项目目录执行 `bash start.command`，
    效果与双击一致。想换端口或不开浏览器：`bash scripts/macos/start.sh --backend-port 8010 --frontend-port 5180 --no-browser`。
- **Linux**：目前没有一键启动器，按 [升级与数据安全](upgrading.md) 分别启动后端与前端：后端使用
  `.venv/bin/python -m uvicorn app.main:app --port 8000`，前端在 `frontend` 目录运行 `npm run dev`，然后打开
  `http://localhost:5173`。
- **应用内更新**：设置里的「软件更新」可以检查、下载并显示进度；Windows 下载完成后可确认「重启并安装」，应用会在原路径
  覆盖程序文件并自动重启。**安装目录里还有一个双击入口**：Windows 是 `ResumeForge.exe` 旁边的 `update.cmd`，
  双击即检查（已是最新会明确提示；应用正在运行时不会再开第二个实例）；macOS 的 `update.command` 打开发布页，
  由你下载新的 dmg 覆盖安装。`data/`、`.env`、`runtime/` 和数据库备份不会被更新包覆盖。macOS 源码包用 `update.command`
  做同样的事（只替换程序文件，数据一样不动）；macOS 安装版（dmg）用户下载新 dmg 覆盖安装即可（数据在用户目录，不随之覆盖）。
  **不要把 Windows 的自动覆盖安装承诺给 macOS / Linux**。
  若卡片提示状态读取失败，先点 **重试读取状态**；状态尚不能确认时，下载安装按钮会暂时停用，避免沿用过期的“已下载”状态。

## 界面导览

| 入口       | 主要用途                                                                                                                        |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------- |
| 首页       | 报出「接下来做什么」的待办、快捷入口，以及统计、最近岗位和简历；可跨岗位与简历记录搜索                                          |
| 岗位广场   | 录入、筛选和管理岗位，从岗位发起简历制作、需求解读与 AI 对比选岗；也能打开「备选岗位」                                    |
| 收藏夹     | 集中查看收藏的岗位和简历                                                                                                        |
| 简历中心   | 查看 AI 生成或用户编写的历史版本，编辑、收藏和导出                                                                              |
| 投递台     | 自动采集岗位、做岗位匹配度分析并把确认的岗位排队自动投递                                                                        |
| 求职进度   | 一家公司一个岗位一条记录，跟进「已投递 → 面试 → Offer」；可从邮件通知识别                                                       |
| 求职统计   | 按转化与卡点 / 时间与节奏 / 渠道与去向 / 简历与健康度四块汇总关键数字的看板，一眼看清整体进展                                   |
| 模拟面试   | 设定面试官后逐轮作答，结束后查看评分报告与改进建议；同页还有「题库」「面经」                                                    |
| 求职助手   | 多轮求职问答，按需关联项目数据、附件或公开搜索摘要；消息可引用、删除，会话可导出；任意页面都可从「投投」悬浮球打开              |
| 我的资料   | 13 个板块 + 当前方案；横向切换简历资料与网申资料，前者用于生成简历，后者补充网申填表专用信息                            |
| 资料箱     | 存放证书、作品、面经、复盘、链接、笔记等零散材料                                                                                |
| 知识库     | 沉淀愿意反复看的成文笔记（面经总结 / 简历技巧 / 求职策略等），带分类、标签与 Markdown 预览                                      |
| 工作台     | 「技能」与「简历模板」两页：自制技能、复制或导入简历模板并实时预览；可上传多张参考图片 / PDF / DOCX，识别后先预览微调再保存 |
| 事实台账   | 逐条确认哪些话可以对外说：原始事实、承担程度、个人边界与核实状态                                                                |
| 回收站     | 删除的岗位、备选岗位、简历、投递、台账、资料、会话、内推、提醒、面经、分享包、网申填充记录都在这里恢复或彻底删除                |
| 设置       | 按「AI 模型 / 数据 / 应用」分页配置：模型与联网搜索、数据集备份、版本更新                                                       |
| 使用指南   | 左侧导航底部的常驻入口；首次打开网站时也会自动显示一次                                                                          |
| 当前数据集 | 页头右上角的圆角标签，显示**当前数据集名**；点一下直接打开菜单切换数据集                                                        |
| 用户头像   | 页头右上角的圆形头像，取自「我的资料」里**当前启用的那张照片**；没有照片时显示姓名首字                                          |
| 开源仓库   | **页头**（「退出」左边）的 GitHub 图标，点开是源码与 Issue 页面                                                                  |

导航顺序按**使用顺序**排（找岗位 → 做简历 → 投递跟进 → 面试准备 → 我的数据 → 系统），
收藏夹紧跟岗位广场（同属"找岗位"），我的资料排在资料箱 / 工作台之前，事实台账与设置同属低频的系统入口。
分组只靠顺序表达，界面上没有额外的分隔标题。

想再精简一些：**设置 → 应用 → 「界面与导航」** 里能把侧栏里用不上的模块逐个关掉，卡片标题栏的
**恢复默认显示** 一键还原。隐藏**只是收起入口**——不删数据、也不禁止直接访问那个页面（地址栏输网址
照样能打开），而且你正在浏览某个隐藏页面时它仍会出现在侧栏里；首页、岗位广场、简历中心、我的资料、
投递台与设置**始终保留**，不用担心把自己关在外面。

**不会用 GitHub？** 打不开 Release 页面、不知道点哪个文件时，把仓库地址
`https://github.com/magicapple123/ResumeForge` 发给任意 AI 助手（ChatGPT / DeepSeek / 豆包…），
说一句「我想用这个软件，请一步步教我怎么装」即可；已经下载好的压缩包也可以直接交给 AI，
让它带你解压并指出该双击哪个文件。

首次引导的完成状态只保存在当前浏览器的 `localStorage`，不会写入业务数据库。关闭后不会再次
自动弹出，仍可随时从左侧导航重新打开。

页头**数据集下拉的左侧**还有模型切换下拉：显示当前「使用中」的记录名与模型，展开可切换
（所有数据集立刻生效）。一条配置记录都没有时不显示——先去设置里保存一条。**单击是切换，
双击只测连接**：在某一条上双击会当场跑一次连通性测试，显示「连接正常（123ms）」或失败原因，
不会把当前配置切走、下拉也不收起——想先确认这条配置还能用又不想改现状时用它。

页头还有一组**主题图标**：太阳（浅色）、月亮（深色）、显示器（跟随系统）。当前档用实心图标，
点一下立即生效，刷新页面或切换数据集后保持。深色**只作用于应用界面**（页头、侧栏、卡片、弹窗），
简历预览、导出 PDF 与打印结果仍是白纸——那是要投出去的东西。
原来页头的放大镜图标已移除，**⌘/Ctrl+K** 仍可在任何页面唤起全站搜索。搜索是一个
**浮层**：没有遮罩、不锁滚动，页面照常可以点、可以滚；点浮层外面或按 Esc 就关掉，打开时输入框
已经在焦点上，输入关键词后↑↓选择、回车跳转。

页头的 **退出** 会同时停止前端与后端进程，页面上所有功能随之停止；下次使用请在项目目录
重新运行 `start.cmd`。

## 0. 通用操作：拖拽导入与右键菜单

- **窄屏导航**：窗口小于 768px 时，点「打开导航」选择页面，选择后抽屉自动收起；
  「我的空间」、当前数据集和头像仍在页头，使用指南也可以从导航抽屉底部打开。
- **键盘操作**：页面首个 Tab 焦点是「跳到主要内容」，回车后进入正文；菜单使用方向键选择、回车进入，
  弹窗用 Esc 关闭。页面切换会更新浏览器标签标题，并向读屏器播报页面名称。
- **快捷键**：`Ctrl/⌘+K` 搜索（跳到首页并聚焦搜索框）、`Ctrl/⌘+S` 保存当前编辑、`Ctrl/⌘+Z` 撤回、
  `Ctrl/⌘+Shift+Z`（或 `⌘+Y` / `Ctrl+Y`）恢复、`Ctrl/⌘+J` 开关投投助手、`Ctrl/⌘+Alt+N` 在岗位广场新建岗位。
  撤回/恢复在「我的资料」与简历微调弹窗里**跨字段**生效；焦点在输入框内时 `Ctrl+Z` 仍是浏览器原生的逐字撤销。
  组合键可在「设置 → 应用 → 快捷键」逐条改键、解绑或恢复默认（解绑后显示「未绑定」，刷新后仍然保持；浏览器保留的组合与已被占用的组合会被拒绝）。
- **资料与知识编辑**：资料箱和知识库编辑弹窗支持 `Ctrl+S` / `⌘+S` 或 `Ctrl+Enter` / `⌘+Enter` 保存；
  正文里的普通回车仍是换行。知识标题为空时会在字段下提示并定位，已经填写的正文保留；保存进行中不重复提交。
- **读取失败**：页面会持续显示错误和「重试」，重试保留当前搜索、分类和分页条件；读取失败不会显示成「没有数据」。
- **动态效果**：如果系统启用了「减少动态效果」，界面过渡会随之减少。

- **拖拽导入**：所有导入入口都支持把文件从资源管理器**直接拖进对应区域**——岗位识别、备选岗位截图、
  资料箱附件、简历照片、助手附件、技能包、简历模板 HTML、数据集备份包，
  拖拽区贴着对应的按钮或区域。不支持的类型会弹出提示，不会静默忽略。
- **右键菜单**：岗位卡片、简历卡片、资料卡片、助手会话、助手消息、工作台里的模板列表都支持
  在整行/整块上点右键唤出与「更多」相同的操作清单（包括编辑与删除），不必去找行尾的小按钮；
  列表与历史记录条目的右键菜单里还有「**批量选择**」，进入多选后统一勾选、统一删除
  （首次使用会有一条只出现一次的「右键可批量操作」轻提示）。
- **日期与行操作**：投递日期、发布日期、核实日期、内推提交日期等日期字段改为**日历点选**；岗位、简历、内推、提醒、面经等列表的行编辑 / 删除收进「更多操作」下拉菜单（右键也能唤起同一份清单）。资料里的出生日期与经历日期用年 / 月 / 日下拉，年份可选到今年 +5，打开时默认从今年开始，已选的更远年份仍会保留。

## 1. 配置大模型（可选）

进入 **设置**。页面分成 **AI 模型 / 数据 / 应用** 三个标签页，各自只装同一类设置。
模型配置集中在 **AI 模型** 页的「大模型 API 配置（所有数据集共用）」区块：已保存的配置以**记录卡片**列出，
点 **新建配置**（或记录卡「···」菜单里的 **编辑**）会在弹窗中打开同一份配置表单；
点记录卡本体可以查看该配置的只读详情。**数据**（数据集备份与切换）和 **应用**（版本更新）
两页不需要进入编辑态就能直接用。
配置表单较长（包括展开「高级调整」时），请在弹窗正文中滚动查看；底部测试、取消和保存操作保持可见。

「应用」页里的 **投投悬浮球** 卡片控制全局助手入口，默认开启。打开后，任意页面都会保留一颗轻量的
浅蓝悬浮球：单击打开投投对话卡片、**双击打开投投剪贴板**，静置后会贴边收起并露出"探头张望"的姿态，
鼠标移入或键盘聚焦会回来；
它还会偶尔给出一条简短的求职 / 简历技巧提示——不想要这些提示时，用同一张卡片里的 **提示标语** 开关关掉即可，
不影响悬浮球的其它功能。悬浮球支持吸附到浏览器上、下、左、右四条边框；连续快速划过它，它会露出被抚摸般
满足的表情；简历预览弹窗等任何覆盖层打开时它都保持可用。投投与侧栏求职助手使用相同的模型、工具和数据权限，
但聊天记录单独保存；浮窗只提供联网搜索和思考强度控制。关闭后只隐藏入口，不影响求职助手页面、历史会话或助手工具。

如果只手动管理岗位、维护资料或自行编写简历，可以跳过本节；使用 AI 生成、岗位需求解读、
岗位化建议或求职助手前需要先保存可用配置。

**所有数据集共用这一套配置。** 在「秋招」和「社招」之间切换时，不需要每换一次重填地址、模型和
API Key；也可以直接在**页头数据集下拉的左侧**切换当前使用中的记录，不必进设置页。记录与「使用中」的那一条都存在数据目录的 `global_settings.json`（密钥加密）；这个文件
**不进备份包**，所以导出时会同时把当前生效配置双写一份到数据集快照里，换机器导入后仍能用。
升级后第一次打开这一页，该数据集原有的配置记录与当前生效配置会自动迁到全局（旧表保留不删）。

### 新建与切换配置

点 **新建配置** 打开弹窗：从“快速预设”选择 DeepSeek、豆包、Kimi、OpenAI 或 Ollama，
会自动填写对应的 `Base URL` 和默认模型名称。云服务按要求填写 API Key；无需鉴权的本地兼容服务
可以留空。按需调整创意度、超时时间和最大输出 Token（填 0 表示不限制，由服务商决定上限），
再给这份配置起个名字（如「DeepSeek 校招」），点 **保存记录**。

新保存的配置**不会立即抢占**——点记录卡上的 **使用** 才会切过去，带「使用中」标记的就是
当前生效的那一条（所有数据集一起切）。编辑「使用中」的记录并保存，等于直接改了当前配置；
删除「使用中」的记录会自动落到剩下的第一条，删光则回到数据集里的旧配置（页面会提示
「当前沿用本数据集旧配置，保存后将升级为全局配置」）。

弹窗底部也有 **测试连接**：用表单当前填的内容发一次真实请求，结果直接显示在弹窗里；
记录卡上的 **测试连接** 则始终用该记录已保存的配置发探针。
探针最多生成 64 个 Token；对已知默认开启思考的模型（如 DeepSeek）会显式关闭思考，
不改动已保存的配置。只有收到非空正文才显示成功，空回复会提示当前配置暂不可用。
DeepSeek 新预设使用模型列表中的 `deepseek-flash`；已有的 `deepseek-v4-flash` 兼容别名仍可保留，
也可通过 **获取可用模型** 按当前账号更新名称。

### 使用自定义模型

快速预设里有两项不是具体服务商，区别只在**选中时做什么**：

- **自定义模型（OpenAI 兼容）**：保留当前填的内容，只把"当前用的是哪个厂商"改成自定义。
  已经填好接口信息、只是不想挂在某个厂商名下时用它。
- **纯手动配置（不套用任何预设）**：把 `Base URL` 和模型名称**清空**，从空白开始填。
  API Key 不会被清掉。走中转站、公司网关这类地址时，先选它再填更省事。

选择其中任一项后填写：

- `Base URL`：服务根地址（例如以 `/v1` 结尾的地址）或完整的 `/chat/completions` 地址；
- 模型名称：服务商实际接受的模型标识，不是页面上的营销名称（弹窗里可以点 **获取可用模型**
  按当前账号拉取列表；如果服务商不支持模型列表接口或请求失败，可按提示重试，也可以按官方文档手动填写）；
- API Key：云服务按服务商要求填写；无需鉴权的本地兼容服务可以留空；
- 创意度、超时时间和最大输出 Token：控制输出稳定性、等待时长和单次回复上限。

编辑已有配置时，API Key 留空表示沿用该记录保存的密钥；点击 **获取可用模型** 会使用这份记录的密钥，
无需先保存表单。新配置则使用弹窗当前输入的 Base URL 和 API Key。获取到列表后选择 **使用** 会回填模型名，
也可继续手动修改；模型列表为空时，现有模型名称不会被清除。

接口协议有两种可选。默认的 **OpenAI 兼容（Chat Completions）** 适用于绝大多数服务商，也是
「快速预设」里除 Claude 之外所有条目的协议。要直连 Claude 官方接口则选 **Anthropic 原生（Messages）**：
这一协议下 system 是独立字段，`Base URL` 填 `https://api.anthropic.com/v1`——本应用会在这个地址
后面接 `/messages`，所以 `/v1` 不能省。「快速预设」里的「Claude（Anthropic 原生协议）」会把地址、
模型名和协议一次填好。

选错协议的典型表现是连接测试报 404 或 400：地址看着没问题，但请求打到了对方不存在的路径上。
Gemini 等其他服务的原生协议仍需服务商或本地网关提供 OpenAI 兼容端点。远程地址必须使用 HTTPS，
HTTP 只允许本机回环地址。图片输入是否可用取决于模型和服务商的实际兼容能力。

「高级调整」可展开配置 Top P / Top K、惩罚项、随机种子、停止词和思考参数形态；弹窗正文独立滚动，
标题与底部测试、取消、保存操作会保持可见。思考模式与强度也可在表单中配置；不确定参数是否被服务商支持时，
可留空让服务商使用默认值。

配置以记录形式保存在本机 SQLite 数据库（Windows 上经系统 DPAPI 加密）。读取记录的普通接口
只返回脱敏占位符：编辑弹窗里密钥留空即沿用原密钥，详情弹窗也只显示「已配置」而不显示密钥本体。
模型调用仍会把任务所需内容发送到所选服务商，请先确认其数据政策。

## 1.5 首页：从这里知道"我该做什么"

首页不只是几个计数卡。它按"**能推动你下一步动作**"来组织：

- **接下来做什么**：只列**待办**，不列"你已经做了多少"——概览页上真正能推动人的只有前者。
  目前会点名三类：还没核实的事实台账条目、投递队列里排着还没投的岗位、超过一周没有任何更新的
  进行中投递。每一条都带数字和去处，点一下就到那件事本身。三类都清空时会明确告诉你"眼下没有
  待办"，而不是留一片空白。
- **近期提醒**：首页也会展示快到点的日历提醒，并按**紧急度分色**——逾期 / 24 小时内 / 3 天内三档，
  一眼看出哪件最急（设置里可关掉「打开应用时弹出提醒」）。
- **快捷入口**：按"你要做的事"而不是按菜单名组织，共 7 个去处——岗位广场 / 简历中心 / 投递台 /
  求职进度 / 模拟面试 / 求职统计 / 数据集与设置；近期提醒卡片下方还内嵌一张**紧凑月历**。
- **全局搜索**：一个框同时搜岗位（岗位名、公司、城市）、简历记录，以及**内推、提醒、面经、事实台账、
  资料箱、技能**。关键词按**原样**匹配——`%`、`_` 这类符号是普通字符（不会被当通配符），
  中文按子串命中，英文不区分大小写；搜索框会去掉你输入的首尾空格（粘贴时常带一个尾空格），
  接口本身不做这一步（前后空格在 API 口径里是关键词的一部分）。
- **最近动态**：最近岗位、最近生成的简历，以及已经投出去的那几个。

首页没有任何只在首页才有的操作——它只做"把你送到该去的地方"。

## 2. 完善个人资料

“我的资料”默认是只读状态。点击 **编辑资料** 后才可修改字段，全部板块共用一个
**保存全部资料** 按钮。查看时各板块默认展开，页头的 **全部展开 / 全部收起** 可以一键开关；
进入编辑态后所有板块自动全部展开。

页头标题区有 **「当前方案」下拉** 与 **「管理方案」**，页头右侧还有 **「资料设置」**：当前方案决定生成、
新建简历和网申读取哪些板块。编辑资料时不能切换当前方案（先保存或取消）；切换后「我的资料」只显示该方案
包含的板块，板块清单怎么配见下面的「方案：决定本次包含哪些板块」。

每个板块都能单独**显示 / 隐藏**：隐藏 = 从当前方案板块清单里移出（因此也不参与生成、导出与网申），
显示 = 加回；资料页顶部的「已隐藏的板块（N）」清单可以随时恢复（查看态也能点）。基本信息参与
网申，恒在首位，不提供隐藏。字段录入区已改为响应式多列：单行文本宽屏 3 列、中屏 2 列、窄屏 1 列，
多行文本与日期占整行；查看态与编辑态一致。

资料页现在分成两个横向可切换的板块：**简历资料** 与 **网申资料**。默认打开简历资料；切换到
网申资料后只看到一个统一的 **「网申资料」** 模块，集中填写简历资料中没有的补充信息，
包括原有证件、家庭等字段以及新增网申字段。两块资料共用页头的编辑、取消和保存流程；
切换标签不会丢掉另一板块尚未保存的编辑内容。**生成简历只读取简历资料**；网申填表
合并读取简历资料的基础信息与网申资料的补充信息，不用重复抄写学校、单位等字段。
网申资料区的字段、分组与填写方式见后面的 6.6 网申资料一节；两块资料共用同一套编辑与保存流程，
切换标签不会丢掉另一块尚未保存的内容。简历基础信息会在网申填表时自动合并读取，不会修改原简历资料。

板块的**默认顺序**是：基本信息 → 教育经历 → 实习/工作经历 → 项目经历 → 专业技能 → 校园经历 →
荣誉奖项 → 个人总结 / 自我评价 → 学术成果 → 科研项目 → 知识产权 → 证书资质 → 语言能力；自建板块排在
最后。这个顺序既是资料页的阅读顺序，也是生成简历时的板块顺序（你在资料页调过的顺序，生成时默认沿用）。
基本信息恒在首位，不能拖到别处。

编辑资料时拖动板块标题上的排序手柄，或用键盘上下方向键调整先后，保存后长期生效；拖动时所有大卡片一起
折叠成紧凑条（包括没被拖的那几张），被拖的卡片跟着指针走，松手或取消后恢复展开并回到该卡片位置。
板块里的小条目（比如多条实习/工作经历）也可以拖动排序，多条板块最多 200 条；不想拖时还可以用板块标题旁的
**上移 / 下移** 按钮，或条目上的 **上移这一条 / 下移这一条**。

### 13 个板块：资料库现在按什么组织

新版的「我的资料」把全部简历内容收进 **13 个板块**，每个板块下有系统预置的默认字段；
默认字段不能改名或删除，但可以隐藏，也可以自己加自定义字段。全局顺序即下面表格的顺序，可拖动调整
（基本信息恒首位，自建板块排在最后）。

| # | 板块 | 形态 | 默认字段（顺序即展示顺序） |
| --- | --- | --- | --- |
| 1 | 基本信息 | 单例 | 姓名、性别、出生年月、手机、邮箱、城市、意向城市、求职意向、个人主页、GitHub、照片、作品集链接、政治面貌、驾照、到岗时间 |
| 2 | 教育经历 | 多条 | 学校、专业、学历、学习形式、学位类型、院系、开始时间、结束时间、绩点、成绩排名、导师、研究方向、主修课程、在校成果 |
| 3 | 实习/工作经历 | 多条 | 公司/机构、职位/角色、开始时间、结束时间、工作内容、团队规模、工作类型 |
| 4 | 项目经历 | 多条 | 项目名称、角色、开始时间、结束时间、技术栈、项目描述、亮点、项目规模、公开链接、成果类型 |
| 5 | 专业技能 | 多条 | 技能名称、熟练度、技能分类 |
| 6 | 校园经历 | 多条 | 组织、角色、开始时间、结束时间、经历描述、活动类型 |
| 7 | 荣誉奖项 | 多条 | 奖项名称、获奖时间、奖项说明、颁发机构、奖项级别、获奖比例 |
| 8 | 个人总结/自我评价 | 单例 | 正文 |
| 9 | 学术成果 | 多条 | 标题、成果类型、我的署名位次、作者、期刊/会议、年份、状态、链接、备注、DOI、卷期页码 |
| 10 | 科研项目 | 多条 | 项目名称、担任角色、所属机构、项目级别、开始时间、结束时间、项目描述、项目成果、经费 |
| 11 | 知识产权 | 多条 | 名称、成果类型、发明人、发明人位次、专利号、状态、申请日期、授权日期、链接、国家/地区 |
| 12 | 证书资质 | 多条 | 证书名称、证书类型、颁发机构、签发日期、到期日期、状态、备注、证书编号、核验链接 |
| 13 | 语言能力 | 多条 | 语言、水平/等级、证书、分数、取得时间 |

这一版同时做了三处改名与几处字段调整：**论文发表 → 学术成果**、**专利 → 知识产权**、
**资格证照 → 证书资质**；教育经历不再有 CET4/CET6（四六级分数录到「语言能力」），专业技能不再有
证书 / 成绩 / 取得时间；语言能力从专业技能拆回独立板块（制作台里也是独立页签，2026-10 起不再并入专业技能）。新增作品集链接、政治面貌、驾照、到岗时间、
成绩排名、导师、研究方向、团队规模、项目规模、技能分类、活动类型、获奖比例、成果类型、我的署名位次、
项目级别、发明人位次、证书类型等字段。旧数据不搬家，需要时手动重填（见下面的升级说明）。

**单例与多条**：基本信息、个人总结只有一条，其余板块可以有多条（最多 200 条），可增删、可拖动排序。
**保存是合并语义**：一次只提交你改过的字段，未提交的字段（包括已隐藏、已删除自定义字段的旧值）
保留原值；只有显式清空才算删除。删条目、删自定义字段、删自建板块都会进回收站，可恢复。

**证书编号只保存在本地**：填写后也**不会**进入模型输入、网申取数或简历纸面，
只随本机数据库与备份走。

### 字段去向：每个字段在纸面上放哪

简历上的每个字段（系统默认字段与自定义字段）都是一条**可以单独摆放的内容**，位置就是它的
「纸面位置」，一共六种：

| 位置 | 在纸面的哪里 | 常见内容 |
| --- | --- | --- |
| **标题行** | 条目最上面一行，左侧黑色加粗 | 学校 / 专业、公司 / 职位、项目名、奖项名、论文题目 |
| **元信息** | 条目头右侧（或下一行），灰色 | 起止时间、学历、机构、状态、专利号、期刊 / 年份 |
| **正文前灰字** | 正文之前的灰色短字段组 | 绩点、核心课程 |
| **正文** | 黑色正文块（要点或段落） | 工作内容、项目描述、在校成果、项目成果、个人总结 |
| **正文后灰字** | 正文之后的灰色短字段组 | 学习形式、技术栈、团队规模、证书详情等 |
| **隐藏** | 不上纸面 | 暂时不想展示、但要保留数据的内容 |

- **默认位置由字段目录决定**：新建简历、AI 生成与「从资料填入」都按默认位置落位；落下之后，
  在制作台里可以把字段**逐条拖到任意位置**，拖过就按你的来。
- **自定义字段**：添加时可以选「纸面位置」（可选「按字段类型自动」：短字段默认「正文后灰字」、
  多行文本默认「正文」），之后在制作台里同样能改；勾了「仅素材」的字段只用于生成与网申填表、不上纸面。
- **换位置不改资料**：纸面位置存在这一份简历里；在制作台拖字段不会改「我的资料」，反过来改资料
  也不会自己移动已有简历的字段（要按新资料出纸面请重新生成或重新填入）。
- **页眉（基本信息）另有自己的一套位置**：姓名行 / 姓名旁小字 / 求职意向行 / 联系方式行 / 照片 / 隐藏。
  制作台的「基本信息」里，每个页眉字段都是一枚 **chip**，交互与正文条目一致：单击选中、双击（或 F2）展开编辑、
  右键隐藏 / 删除、拖拽（或用方向键 ←→ 换位置组、↑↓ 组内换序、Esc 回滚）。添加字段的下拉里还有
  **自定义页眉字段**——起的名字会连同值一起印在纸面上（如「微信：xxx」），不是只有一个裸值。
- **照片是一枚缩略图 chip**：展开后有 **更换 / 裁剪 / 移除** 三个动作。裁剪支持自由 / 1:1 / 3:4 / 4:5 四档比例
  加缩放与水平 / 垂直微调，确认后写出新图（原图仍在资料照片库，可重新裁）。

各板块的默认位置（未设置过的简历按此排；在制作台里都还能再改）：

| 板块 | 标题行 | 元信息 | 正文前灰字 | 正文后灰字 | 正文 |
| --- | --- | --- | --- | --- | --- |
| 教育经历 | 学校、专业 | 学历、起止时间 | 绩点、主修课程 | 学习形式、学位类型、院系、成绩排名、导师、研究方向 | 在校成果 |
| 实习/工作经历 | 公司、职位 | 起止时间 | — | 团队规模、工作类型 | 工作内容 |
| 项目经历 | 项目名称 | 角色、起止时间 | — | 项目规模、技术栈、成果类型、公开链接 | 项目描述、亮点 |
| 校园经历 | 组织、角色 | 起止时间 | — | 活动类型 | 经历描述 |
| 荣誉奖项 | 奖项名称 | 获奖时间 | — | 颁发机构、奖项级别、获奖比例 | 奖项说明 |
| 学术成果 | 标题 | 期刊 / 会议、年份、状态 | — | 作者、成果类型、署名位次、卷期页码、DOI、链接、备注 | — |
| 科研项目 | 项目名称、担任角色 | 所属机构、起止时间 | — | 项目级别、经费 | 项目描述、项目成果 |
| 知识产权 | 名称 | 专利号、国家 / 地区、状态 | — | 发明人、申请日期、授权日期、链接；成果类型 / 发明人位次（仅素材） | — |
| 证书资质 | 证书名称 | 颁发机构、状态 | — | 证书类型、签发日期、到期日期、核验链接、备注 | — |
| 专业技能 | — | — | — | 技能分类 | 技能名称（熟练度在括号里） |
| 语言能力 | — | — | — | 取得时间 | 语言（水平 / 证书 / 分数在括号里） |
| 个人总结 | — | — | — | — | 正文 |
| 自建板块 | — | — | — | 其余字段（按各自默认位置，多数在正文后灰字） | 主文本（默认段落） |

### 判定规则：同一段经历只填一处

资料页顶部的 **填写规则** 入口（以及各板块的「不知道怎么分？查看填写规则」）会打开下面这张表。
它就是「同一段经历只填一个板块」的判定表——不是建议，是判定口径：同一段经历填进两个板块，
纸面上就会重复出现两次。

| 素材特征 | 该填哪里 |
| --- | --- |
| 有劳动合同、有薪资、有上级 | 实习/工作经历 |
| 校内组织、社团、学生会任职 | 校园经历 |
| 志愿服务、社会实践、公益项目 | 校园经历（活动类型选志愿服务/社会实践） |
| 产出物是论文、著作、研究报告 | 学术成果 |
| 有基金、立项、课题编号、导师课题组 | 科研项目 |
| 有可交付的产品、代码仓库、设计稿 | 项目经历 |
| 竞赛获奖、荣誉称号、奖学金 | 荣誉奖项 |
| 资格考试、职业认证、执业资格 | 证书资质 |
| 语言考试成绩（CET/雅思/托福/JLPT/德福） | 语言能力 |
| 专利、软件著作权 | 知识产权 |

**总则：同一段经历只填一个地方。** 不要为了显得丰富在两处重复录入。

**培训与课程怎么记**：系统没有内置培训板块——可在项目经历或教育经历下添加自定义字段（如学时、
培训机构），或自建一个「培训与课程」板块。这是有意的取舍，不是遗漏；旧版补充事实里的培训数据仍在
本地与备份里，但不再有录入入口。

### 方案：决定本次包含哪些板块

「方案」是一份**板块清单**：一个方案记住名称与“勾选了哪些板块”，**不复制任何资料**。
所以你在任何方案里改资料，其它方案立刻看到同一份内容；不存在"每个方案一份副本"，也不存在方案内覆盖值。

- **当前方案**：页头「当前方案」下拉切换。它决定**此后**的新建简历、生成简历和网申读取哪些板块；
  已经生成/保存的简历、正在编辑的草稿不因切换而改变。编辑资料时不能切换方案，先保存或取消。
- **管理方案**：页头「管理方案」打开同一个「方案与板块」弹层：新建方案、编辑方案（名称 + 板块清单）、删除方案，
  以及把某个方案设为当前方案。默认方案恒存在、不能删除（可以编辑）；最多 20 个方案。
- **资料设置**：页头「资料设置」打开的是同一个弹层，顶部两个页签 **方案 / 板块与字段** 统管
  方案、板块与字段（板块行右侧的齿轮进入该板块的字段设置）。底部不再放「板块与字段 / 关闭」这类按钮，
  关闭用右上角 ×；单卡右侧的齿轮、当前方案旁的「管理方案」都照常可用，走的是同一份设置。
- **新建方案默认隐藏全部板块**（基本信息除外）：方案列表或「板块与字段」里打开某个板块的
  「在资料页显示」后，它才出现在资料页；非编辑态创建方案会自动切到新方案，编辑态先保存或取消再切。
- **基本信息始终包含**且排在首位，不能从任何方案移出；其它板块按需勾选。资料页顶部的
  「已隐藏的板块（N）」不用进方案弹层就能逐项恢复。
- **只减不增**：方案只会把资料**排除**在本次之外，不会让不该外发的内容多出来——证书编号、身份证号这类
  红线无论选哪个方案都不外发；助手、岗位匹配、审阅等不按方案取数的功能仍读全部资料。
- 删掉的方案会提示并给出撤销；删除当前方案时自动回落到默认方案，页面上会留一条提示，点 **知道了** 即可确认。
- 生成弹窗与新建面板里会显示只读的 **本次使用：{方案名称}（{N} 个板块）** 摘要，用来核对这次到底带上了哪些板块。

### 字段始终显示；不想参与就用「隐藏」

字段**不再默认折叠**：进入编辑态就能看到当前方案里的全部可见字段，不再有「更多字段 /
收起更多字段」这一层（2026-10 用户反馈：折叠功能没有必要，不想看的字段直接隐藏即可）。

| 维度 | 用户隐藏 |
| --- | --- |
| 谁设置 | 你在「字段设置」里主动设置 |
| 界面 | 完全不显示，只在「已隐藏字段」清单里可见并可 **恢复显示** |
| 参与 AI 与纸面 | **不参与**：不进模型、不出现在导出 |
| 数据 | 值仍保留在库里，恢复后重新出现 |

拿不准时就去板块底部的「已隐藏 N 个字段」入口看一眼——被隐藏的字段只收纳在那里，
点「恢复显示」即可回来。

板块也有一层「在资料页显示」开关，它管的是**当前方案板块清单**：隐藏后整块板块都不显示、也
不参与生成/导出/网申；恢复显示后，这块板块里各个字段各自的隐藏/收起状态仍然保留。

### 自建板块与自定义字段

- **自建板块**：「资料设置」→「板块与字段」→「自建板块」区可 **新建板块**（名称 1–40 字，形态固定为
  多条），新建后自动加入当前方案、排在 13 个系统板块之后。自建板块在资料页的标题旁带一个
  **「自建」** 小标记，和系统板块一眼分清。自建板块可 **改名**、可 **删除这个板块**
  （删除只影响显示，条目与内容保留、可在回收站恢复；同名重新创建不会关联旧内容）。
- **自定义字段**：每个板块（含 **基本信息**）标题栏右侧的齿轮都能进「字段设置」，里面可以 **添加字段**
  （单行文本 / 多行文本 / 日期文本，每个板块最多 20 个），并可改名、删除或调整顺序；系统默认字段只能
  **隐藏** / **恢复显示**，不能改名或删除。
- **添加时就能选去向**：每个板块标题栏的齿轮 →「字段设置」→「自定义字段」卡片里添加字段（单行文本 /
  多行文本 / 日期文本），行尾可选 **「纸面位置」**（按字段类型自动 / 标题行 / 元信息 / 正文前灰字 / 正文 /
  正文后灰字 / 不上纸面）；选「按字段类型自动」时单行文本与日期默认**正文后灰字**、多行文本默认**正文**。
  已有字段在行下方的「修改纸面位置」里随时改；系统内置字段显示**只读**的位置标签（由字段目录决定）。
- **仅素材**：添加或编辑字段时打开「仅素材字段（不上纸面）」后，位置固定为「不上纸面」，这个字段只用于
  AI 生成素材与网申填表，并显示红字「不上纸面，只用于 AI 生成与网申填表」；资料页与制作台的
  「本份简历结构 / 添加字段」都会显示「仅素材」徽标。
- **字段就是内容，不再拼标签行**：自定义字段在简历里和系统字段完全同权——每条简历里它是一条独立内容，
  有自己的纸面位置，可以拖动、排序、隐藏、放进正文；不会再以「标签：值」塞进描述或正文，
  也不会随描述被 AI 改写而需要事后补回。
- **自建板块上纸面**：自建板块在简历上**独立成一栏**（标题就是板块名），排在 13 个系统板块之后；
  它的条目与系统板块同构：主文本默认放正文，其余字段按各自默认位置（多数在正文后灰字）排列，
  之后都可以在制作台里拖到任意位置。
- **新建 / 编辑简历里的格式**：自建板块与系统板块用同一种录入格式——板块名只读（来自当前方案，
  旧简历退回正文里的标题）、字段按定义渲染成固定字段表单；没有字段定义时只显示一个「内容」字段。

### 升级后旧资料：不显示，但仍在本地与备份里

新版使用新的资料模型，旧版的资料表与补充事实**不再显示在新界面、也不再进入生成 / 新建 / 网申的取数**。
但数据不会被删除：旧表原样保留在本地数据库里，继续完整进备份；旧补充事实在回收站里仍能看到与恢复。

用含旧资料的库升级后打开「我的资料」，页面顶部会出现说明条：

- **打开备份**：跳到「设置 → 数据」，可导出/查看当前数据集的备份包；
- **开始填写**：进入编辑态，从零录入新资料；
- 说明条**不阻断任何操作**，新模型录入第一份有效内容后自然消失。

想找回旧内容时，从升级前的自动备份（`backend/data/backups/`）或你自己导出的备份包里取出后，
在新界面手动重填即可；系统不提供、也不会自动搬运旧数据。

### 职业场景：本窗口的建议，不是账号角色

页头的 **职业场景** 是一个可选的组合：职业阶段、使用目的、当前就业状态、目标行业（最多 5 个）、
目标职能、合作形式、内容语言、使用地区、偏好栏目与表达偏好。内置"在校与应届、职场发展、跨行转岗、
自由职业、科研学术、职业回归、资深管理"等快捷场景，也可以保存自己的组合；初次使用可以直接跳过。

要分清两件事：

- **切换 / 编辑职业场景**：只改这个窗口的引导与建议，**不会**改个人资料、岗位、已有简历、投递准入、
  网申资料、模型设置，也不会重启后台任务；不影响任何其他窗口。
- **用于本次生成**：在生成简历的弹窗里显式开启并选中场景后，服务端才会把允许的维度裁剪成一段
  表达建议交给模型，并**冻结一份快照**写进生成记录。默认关闭；姓名、联系方式永远不随场景发送，
  当前就业状态**默认也不发送**，需要单独勾选。

历史简历不会因为你现在换了场景而改变；换一种表达请创建新的变体或重新生成一份。生成记录里会写明
"本次采用的职业场景"，只是说明，不会印到简历纸面上。

**政治面貌、驾照与到岗时间**是「基本信息」里的新增字段，出生年月可以只填年份。

**GitHub 主页、个人主页与作品集链接**录在「基本信息」里（没有可以不填）：生成简历时 GitHub 与个人主页
会作为独立字段渲染在简历页眉的联系方式区；作品集链接只作展示，**不参与防虚构核对**。

可以逐项填写，也可以使用“粘贴识别”导入一大段个人经历文本。已配置模型时，原文会发送给你选择的
模型服务商，用结构化 Prompt 抽取分区和字段，每条结果都要能在原文中找到依据；未配置模型或模型
失败时自动退回本地规则。
识别只回填可编辑草稿，不会直接覆盖已保存资料；请重点核对组织、角色、日期和经历边界。编辑状态下可拖动大板块，
也可折叠内容后调整同一板块内的教育、工作、校园或项目条目顺序。

识别弹窗里也可以直接**贴截图或选文档**：在输入框里按 Ctrl+V，或点 **添加截图或文档** 选本地文件
（最多 4 个，单个 ≤ 2 MB、合计 ≤ 5 MB；支持截图与 pdf/docx 简历文档）。图片、文档与粘贴的文本
可以一起提交，三边都参与识别。图片识别的行为、限制与核对要求和岗位那两处完全一致，
详见 [用截图或文档识别](#用截图或文档识别)。

### 事实台账：每条能说出去的话，都要回到一个出处

侧栏 **事实台账** 解决的是另一个问题：资料库记的是**发生过什么**，
台账记的是一条条**能对外说的主张**。每条写清四件事：

| 字段     | 作用                                               |
| -------- | -------------------------------------------------- |
| 原始事实 | 照实写、不包装。它是之后核对一切表述的基准         |
| 简历表述 | 准备写进简历的版本。**不得比原始事实更强**         |
| 承担程度 | 参与 / 负责模块 / 主导方案或交付 / 项目负责人      |
| 个人边界 | 团队做了什么、你做了什么——面试时最容易被追问的地方 |

**核实状态决定用途**，不是决定好坏：

- **已确认** —— 可以作为事实写进正式简历；
- **待确认** —— 只能进草稿，且必须保留 `【待补：…】` 占位符；
- **已过期** —— 内容会随时间变化（在读年级、论文在投状态、Star 数），更新前不作为最新事实；
- **不采用** —— 保留原因供复盘，不进入对外材料。

保存时有一条硬规则：**「已确认」的主张里不允许出现 `【待补】` 这类标记**——两件事不能同时
为真。反过来，"强主张没填面试细节""已确认却没写个人边界"这类只是**建议**，会随条目一起显示，
不会拦住你保存。

**从资料生成**：粘贴一段经历、项目说明或获奖情况，系统会拆成若干条草稿（每条都带它自己的
原始事实摘录），你逐条核对、就地改标题和简历表述，确认后再保存。草稿一律以「待确认」入库，
因为模型抽出来的只是候选。没有配置模型时会按段落本地切分，不做任何改写。

**三条接合点**（这是台账真正的用处）：

1. **生成简历时**，只有「已确认」的条目会作为事实基线交给模型；未确认的说法会被列成
   "禁止使用"，且承担程度与个人边界会约束表述强度（"参与"不会被写成"主导"）。
   台账为空时，生成行为与没有这个功能时完全一致。
2. **导出简历时**，正文里还留着 `【待补：…】` 之类标记的会被拦下，并指出**具体在哪一节**。
   这是为了避免把一份还写着"待补"的 PDF 投出去。弹窗里可以选 **仍要导出草稿**（四种格式与
   浏览器打印都一样）——拦下不等于堵死。
3. **求职助手**可以读台账、帮你新建条目或补充内容，但**改不了核实状态**：一条主张能不能
   进正式简历，必须由你自己判断。

### 面试深挖：这条主张我讲不讲得清？

台账页头、与「新建条目」并列的 **开始深挖** 会**就地弹出参数弹窗**（不跳页）：弹窗预填你在台账里勾选的主张（只留已确认的，并提示「已忽略 N 条未确认的条目」），确认「开始深挖（N 条主张 · M 题）」后才进入 `/claims/drill` 把已确认条目逐条压力测试——不是考八股，而是回答"这条主张我到底讲得清吗、哪里还站不住"。没选任何已确认主张时按钮不可点，后端收到空列表也会返回 422。

深挖是**独立页面**，页头的 **返回事实台账** 可以随时回到台账（浏览器后退也行）。

与「模拟面试」的分工写在页面顶部：模拟面试按轮数推进、结束时给四维度评分报告；**深挖不评总分**，
用证据状态说话。界面和接口里都不会出现任何分数。

**每道题的评分标准在你看到问题之前就定下来**，之后不因答得流利而放宽：

| 契约里的项         | 作用                                     |
| ------------------ | ---------------------------------------- |
| 想验证什么         | 这道题的意图                             |
| 必须讲到           | 必须听到哪些证据才算过，问完之前就写好了 |
| 出现这些就该被追问 | 描述空泛时追问的触发条件                 |
| 可以结束的条件     | 什么时候这题算问完                       |

这份契约在整个会话期间**对你可见**（题卡下方可展开）——它在衡量你，你有权看到它。藏起来才会
让人怀疑"是不是看人下菜碟"。

**证据状态**代替分数：

- **已验证** —— 必要证据都讲到了；
- **部分验证** —— 讲到了一部分，还有明确缺口；
- **未验证** —— 没能提供最低限度的事实；
- **存在矛盾** —— 与台账或前文对不上。

状态**只能凭新证据前进**：答得比上次流利但没说出新事实，不会升级；发现矛盾则会把"已验证"打回原形。
另外，模型说"这次算过了"却**列不出任何证据**时，一律不判成「已验证」——那种"过了"没有任何依据。

**两种反馈方式**（开场时选）：

- **真实模拟**（默认）—— 每题后不念判定，结束时统一复盘。念了会让人按判分标准答题，而不像真面试。
  判定仍如实记录，只是不主动展示。
- **训练模式** —— 每题后立刻给一段简短反馈。

结束后出一份**「该去补什么」的清单**：哪些讲得清、哪些还站不住，行动项落到**补事实 / 补知识 /
降表述**三选一；另有**复练队列**——只收部分验证、未验证、存在矛盾的主张，点「出一道」会**换一个角度**
出新题（变体题 / 反事实题 / 故障题 / 证据题 / 压缩表达）。**复练不重复原题**，因为把上次的答案背一遍
不算会了；出的题不计入本场记录，只给你自己练。

求职助手可以读你的深挖记录帮你复盘（`list_drill_sessions` / `get_drill_report`），但**开不了新的深挖**
——每道题的标准要先按你的主张锁定，而且需要你自己逐轮作答。

### 简历照片：存多张，选一张

资料页的「简历照片」面板可以保存多张照片（最多 8 张，JPG/PNG/WebP、每张 ≤ 5 MB）。
面板上**只显示正在使用的那一张**，备选照片收在 **照片库** 里：

- 点面板上的 **照片库** 打开弹窗，点其中一张即可把它设为**简历照片**，当前使用的那张会标上「使用中」；
- 上传第一张时会自动成为使用中的那张；
- 删除使用中的照片后会自动接替下一张，全部删完则简历不再带照片；
- 照片只保存在本机数据库，不会发送给模型。

### 资料箱：放还没整理进简历的材料

左侧导航的 **资料箱** 用来收留"以后可能用得上、但现在还没写进简历"的东西：证书、作品说明、
链接、笔记、实习/校园材料。每条资料可以带标题、分类、正文、链接、备注与附件（图片最多 2 张，
文本文件最多 4 个；PDF/Word 请把文字粘贴进正文，程序不保存原始文件）。

资料箱的用途不只是归档：求职助手可以读取这里的条目，所以"帮我把这段经历记下来，之后写简历用"
是有地方落的。分类可以自己输入新名字，检索支持关键词与分类筛选。**点卡片任意位置即可看详情**：
正文全文、备注与附件清单（图片直接显示缩略图）都在右侧抽屉里，卡片上只保留三行摘要。

所有存进简历通的文件都会自动留一份**副本**：在资料箱新增的「文件副本」页签里可以集中查看——
图片和 PDF 可以直接预览，其它类型可以一键调用系统程序打开。副本统一保存在应用数据目录的
`user_files/` 文件夹里（按内容去重），随数据集切换或迁移自动重建；删除文件同样在这个页签里操作。

### 知识库：沉淀愿意反复看的成文笔记

左侧导航 **知识库**（在「资料箱」之后）放的是**已经整理成文、愿意反复查阅**的内容：面经总结、
简历技巧、求职策略、面试问答、公司信息、行业知识等。它与资料箱的分工是——资料箱放**零散材料**
（证书、链接、还没成文的笔记），知识库放**成文笔记**。

每条知识带**标题、分类、标签与 Markdown 正文**，支持：

- **搜索与筛选**：按标题/正文关键词搜，也能按分类、标签筛选；
- **Markdown 预览**：正文用与求职助手同一套渲染展示，标题、列表、代码块、表格都能正常显示；
- **新增 / 编辑 / 删除**：删除走回收站软删除，删错了还能去「回收站」恢复；
- **点卡片读全文**：卡片上只显示正文的前三行，点一下就能在弹窗里读完 Markdown 全文。

求职助手也能检索与增改知识库——说"把这段记进知识库""改一下这条知识"即可，它会调用对应的工具
（新增的知识会标注来源为「助手录入」，方便你在知识库里溯源）。

### 通用简历：不针对任何岗位的一份

岗位版简历是从资料里**按 JD 筛出来**的。如果你还在看方向、想先准备一份通用的，或者要投的岗位说不清
属于哪一类，就用**通用简历**：它不关联任何岗位、不按岗位方向筛选，但**按当前方案读取资料**——当前方案
排除的板块不会带进这份简历。

入口有两处：**简历中心**页头的 **AI 生成**（让模型写一份通用简历）与 **新建简历**（从头手写，弹窗标题
「从头编写通用简历」）。手写时会先按当前方案把资料**预填**进表单，编辑器的页签也只按当前方案显示：
当前方案有的板块（即使还没内容）才有输入框，当前方案没有的板块不显示；正文里已有内容的板块始终保留。
打开期间在另一个窗口改资料或切换方案，这个界面会自动同步；如果已经有未保存修改，不会静默覆盖，而是提示你
选「用最新资料覆盖」或「保留当前编辑」。保存的只是这份简历，不会回写资料；不调用模型就不需要 API Key。

新建界面的**板块顺序默认跟随「我的资料」**：在资料页把项目经历拖到教育经历前面，新开的简历也会是项目在前。
编辑器顶部有「顺序」按钮，可在保存前逐个上移 / 下移，或点「与资料顺序同步」一键恢复成资料顺序。
**AI 生成**的配置页也有同一个「顺序」入口；这里定下的顺序会随生成请求保存到这份简历。

新建界面里每个字段 chip 都可以直接点击展开编辑。底部还有 **「清空所有内容」**：板块和页眉字段结构会保留，
条目与字段值清空，适合从一张白纸开始填；清空前会二次确认。

通用简历可以有多份、各自命名，也可以随时重命名（列表里的铅笔按钮）或删除。它们同时出现在
**简历中心**，那里会把它们标成「通用简历」并显示求职意向，导出方式与岗位简历完全一样；之后切换当前方案
不会改变已生成 / 已保存的简历内容。

建议尽量维护完整的事实资料库，而不是只录入某一个岗位需要的内容：

- 基本信息与简历照片；
- 教育经历和核心课程；
- 工作或实习经历；
- 校园经历；
- 项目经历；
- 技能和获奖情况。

每条教育、工作、校园或项目经历都可导入 UTF-8 Markdown/TXT 总结文件，也可直接输入总结
正文。系统保存的是文件名与文本内容，不依赖原文件路径；生成岗位版简历时会从中选择相关
片段。资料照片始终留在本机，只在模型生成完成后加入预览和 HTML 打印内容。

## 3. 录入和管理岗位

在 **岗位广场** 点击 **手动添加**，可以使用两种方式建立岗位：

### 手动填写

直接填写岗位名称、公司、地点、岗位类型、职责、任职要求、其他招聘信息、发布时间和投递
链接。岗位名称与岗位描述是保存所需的基本信息。

### 粘贴完整招聘信息

在弹窗顶部粘贴招聘原文后点击 **识别并填充**。已配置模型时，原文会发送给你选择的模型服务商，
用结构化 Prompt 抽取岗位、公司、地点、薪资、类型、发布时间、投递链接、岗位职责、任职要求和其他
招聘信息；模型输出只接受原文可验证的内容，某个字段在原文中找不到依据时改用本地规则的结果。未配置
模型或模型不可用时，全部字段由本地规则解析。**岗位录入与识别本身不访问招聘网站**（自动采集与自动投递是另一条链路，见第 6 节），保存前仍须核对草稿和警告。

识别完成后，输入框下方会**常驻一枚来源标记**（「AI 识别」或「本地规则」），鼠标悬停会说明这个来源
意味着什么。它不会随提示条一起消失——两者可信度不同，AI 识别的字段逐条校验过能在你给的内容里找到
出处，本地规则只是按模式匹配，需要更仔细地核对。来源是对**这一次识别**而言的：改动粘贴的文本后标记
会撤掉，直到再次识别。

#### 一次粘贴多份招聘信息

把一段含多份招聘信息的材料（招聘网站整段复制、群里的聊天记录、一次选中的多张截图与文档）粘进来点
**识别并填充**，如果里面不止一份，界面会切到**确认面板**：每份显示岗位名、公司、地点、薪资与原文摘要，
并默认全部勾选。

- 取消勾选不想保存的那些，点 **保存勾选的 N 份为岗位** 一次性入库；
- 想改字段就先点某一份的 **单独编辑**，它会填进表单，改完保存这一份；
- 点 **返回修改原文** 回到文本再识别一次。

拆分规则：优先由模型按"公司 + 岗位"的组合切分，每份必须给出一段**原样复制的原文**作为字段锚点，
所以不会出现"把 A 公司的要求写进 B 公司"的情况；没有可用模型时退回本地规则，按分隔线（`---`）、
序号小标题（`岗位1：`）或第二个公司标签切分。**切不出来就当作一份**，不会硬拆。

#### 用截图或文档识别

招聘信息常常只有一张图（海报、群里转发的截图、别人发来的 JD 长图），手里的简历也常常是
别人给你导出的 PDF 或 Word。在上面那个文本框里直接按 **Ctrl+V** 就能把剪贴板里的截图贴进来
（配合 Win+Shift+S 截图最顺手），也可以点 **添加截图或文档** 选择本地文件。一次最多 4 个、
单个不超过 2 MB、合计不超过 5 MB：

- **图片**：PNG/JPEG/WebP/GIF/BMP/TIFF，贴进来的图会显示成缩略图，**点缩略图可以放大看**（同一次
  贴进来的多张图可左右切换、滚轮缩放），可以逐个删除。BMP、TIFF
  由后端转成 PNG 再交给模型，所以截图工具或扫描仪导出的原始文件可以直接用（TIFF 在浏览器里
  渲染不出来，所以只显示文件名）。
- **文档**：PDF、DOCX。PDF 旁边有 **预览**，点了在**当前页面的弹层里**看这份文件的**首页图**——
  图由后端当场渲染，不是浏览器插件也不是新标签页（早先那种把文件当网页打开的做法已被 Chrome/Edge
  禁止，等于点了没反应）。预览只回答"我传的是这份文件吗"，所以只渲染首页，不占你几十秒 CPU；
  Word 不支持预览，只显示图标、文件名与体积，鼠标悬停会说明这一
  点。文字由后端在**本机**提取，原始文件不会上传给模型，也不需要多模态模型
  （扫描版 PDF 例外，见下文）；
  提取出的文字会和粘贴的文本合并后一起识别——所以**没配置模型时，文档也能被本地规则解析出
  一部分字段**，而截图做不到这一点。
- 图片、文档和粘贴的文本**可以同时给**，三边的内容都会参与识别。

几个需要知道的点：

- **识别图片需要模型支持图片输入。** 不支持时不会报错，而是退回本地规则并提示「可能是当前模型
  不支持图片输入（需要多模态模型）」——本地规则读不了图片，所以这种情况下表单不会被填入内容，
  可以到 **设置** 里换一个支持图片的模型再试。完全没配置模型时也会有明确提示。
- **图片识别的核对要求和文本识别不同。** 文本识别是把模型给出的字段逐字回对到你粘贴的原文；
  图片没有原文，只能先让模型把图里的文字抄录一遍，再要求字段出现在它自己的抄录里。这能拦住
  "凭空编字段"，但拦不住"模型把幻觉写进抄录"。所以识别结果上方有一个默认收起的
  **「查看模型识别到的原文」**，展开就能看到模型到底读到了什么，请对照截图核对后再保存。
  文档走的是文本那条路（提取出的文字就是原文），核对要求与粘贴文本相同。
- **扫描版（图片型）PDF 会自动转成图片识别。** 整页都是图片的 PDF（扫描仪导出、拍照转 PDF）
  没有文字层，现在会自动把页面转为图片走 AI 视觉识别——与截图上传同一条路径、同一份体积预算，
  **单份最多转换 8 页**，核对要求与图片识别相同。带密码的 PDF 需要先解除保护。
- 一张图里如果有多条招聘信息（例如岗位列表页的截图），识别会以内容最完整的那一条为准，
  不会把几条拼成一条不存在的记录。

粘贴或截图识别结果只是草稿。请确认：

1. 岗位名、公司和工作地点没有混入岗位编号或页面导航文字；
2. 岗位职责与任职要求分区正确；
3. 招聘发布时间确实来自“发布”语义，而不是网页更新时间；
4. 投递链接属于预期的用人单位官网，岗位仍在有效期内；
5. 福利、团队介绍、部门、岗位 ID 和申请流程等内容是否进入“其他招聘信息”。

岗位保存后可以添加备注、收藏、修改投递状态，也可先点击 **选择** 再批量设置状态或删除。
岗位详情支持需求解读、AI 生成简历、自行编写简历、查看关联简历和咨询求职助手。
岗位列表的岗位名旁有「采集 / 手动」角标，一眼区分是投递台自动采集来的还是手动添加的；筛选条里的
**来源** 下拉可以只显示其中一类。鼠标悬停岗位标题还能看到它的导入时间。

### CSV 导入与导出

岗位可以整批搬进搬出：

- **全选所有页**：进入选择模式后，除了表头的全选（当前页），工具条上还有
  **全选全部岗位（共 N 个）**——按当前筛选把所有页的岗位一键勾选，后面的批量操作
  对全部勾选生效（批量操作一次最多 500 个，超了会提示先用筛选缩小范围）。
- **导出**：进入选择模式勾选岗位（工具条里会出现 **导出 CSV**），导出一份 UTF-8 的 CSV
  文件（Excel 双击打开不乱码），文件名自带导出时间（`岗位列表-20261012-103000.csv`）；
  列名与**手动添加岗位表单的字段名一致**（岗位名称、公司名称、工作地点、薪资范围、
  岗位类型、状态、投递链接、发布时间、岗位描述、任职要求、其他招聘信息、来源、备注、收藏），
  每条岗位恰好一行（字段内的换行会折叠成空格，Excel 里不会把表格撑散）；
- **导入**：点筛选条右侧的 **导入 CSV**，可以一次选好或拖入**多个**文件（最多 10 个、合计不超过
  2000 行；超了会提示"请分批导入"而不是悄悄截断），也可以直接在这块区域按 **Ctrl+V** 粘贴从表格里
  复制的内容。系统先解析出**预览**——哪些行能进、哪些行有问题（带**文件名与文件行号**和原因，直接在
  Excel 里就能定位改掉）、哪些行与已有岗位重复会被跳过；预览还会按文件列出各自的可导入 / 重复 /
  错误条数，**一个文件坏了只标它自己**，其余文件照样可以导入。确认无误后再点 **确认导入** 才真正入库，
  提交时按每批 500 行自动拆分，每批的导入与失败条数会累加报给你；某批请求失败会停下并告诉你已经导入
  了多少、卡在第几批。表头支持别名（旧版导出的"标题 / 公司 / 地点 / 薪资"或"职位描述"这类老列名都认），
  UTF-8 与 GBK 编码都能读。
- 导出的文件不改列名就能原样导回，适合换机迁移或跟别人互拷岗位清单。

### 备选岗位：先收下，之后再核对

岗位广场的 **备选岗位** 是一个中转站：看到感兴趣但来不及整理的招聘信息时，把文本粘贴
进去、或上传招聘截图（最多 4 张），先存着。表单里可以顺手留一条**岗位链接**（选填，导入岗位时
会预填投递链接）。等有空了：

- 点「导入到岗位」会打开正式的岗位表单并预填原文，保存后这条备选标记为「已导入 #id」，还会
  保留在列表里，方便回看它变成了哪个岗位；
- **CSV 导入/导出**：抽屉里的 **导入 CSV** 上传文件（同样支持多选 / 拖拽 / 粘贴、逐文件账目与
  500 行一批，与岗位广场 CSV 同一套规则），勾选候选后工具条里 **导出 CSV** 把勾选的候选带出来；
  文件名自带导出时间；
- **全选**：工具条里既有「全选本页」，也有 **全选全部（共 N 条）**——按当前筛选跨页勾选
  全部候选（批量操作一次最多 500 条）；
- 也可以直接让求职助手"把这条备选导入正式岗位"，它会调用同一套流程（重复导入不会产生第二份）。

### 岗位备注里的图片与来源

添加岗位时可以在备注下方再放两张图片（招聘截图、内推码等，每张 ≤ 2 MB），列表里显示图片数量，
岗位详情的备注区可以放大查看。

「来源」是一个**独立的可编辑字段**（表单里"来源（选填）"一栏）：没有填写时系统会按这次的录入
方式预填（粘贴文本识别 / 图片识别 / 文档识别，从备选岗位导入、助手录入也各有标注），
之后你可以随时修改或清空它，备注正文只保存你自己写的内容。岗位详情的「信息来源」与「来源」
两栏也能直接看到。这条记录只为你自己回溯用。

### 补齐详情：把空的岗位描述补回来

采集有时只拿到岗位标题、没拿到详情页（早期"详情页抓不到"的问题现已修复），这些岗位的岗位描述
会是空的。而采集按投递链接去重，**重新采集会直接跳过它们**，所以需要单独补：在 **岗位广场**
点 **补齐详情**，它会按岗位重新打开详情页、只补岗位描述。

- 这个按钮**只在当页存在岗位描述为空的岗位时才出现**——没有需要补的岗位时它不会在那里。
- 用 **选择** 模式勾选几条再点，就只补勾选的那些；不勾选则补当前这页里所有 JD 为空的岗位。
- **只补空**：已经有描述的岗位一律跳过，不会覆盖你自己改过的内容；在回收站里的岗位也不会被补。
- 补是一个后台任务，**进度、暂停、停止都在「投递台 → 自动采集」的任务面板里**看，别在岗位广场干等。
- 一次最多补 200 条（补详情要逐个打开页面，很慢），超过请分批；某条仍然抓不到时会如实告诉你
  "仍然抓不到"，不会假装补上了。

### 排序与「恢复默认排序」

- **默认按导入时间倒序**（最近导入的在前），此时任何列都不显示排序箭头、表头也没有灰底——
  这是列表接口不带参数时的行为，不是你选过的排序。
- 点 **岗位** / **公司** 列头按名称排序：中文按**拼音**、英文按字母、数字按大小
  （第 2 版在第 10 版之前，不会出现 U 开头的永远第一）。简历中心的「标题 A→Z / 公司 A→Z /
  岗位 A→Z」用的是同一套规则。
- 点 **发布时间** 列按 `posted_at` 排序；没有填发布时间、或填的是「3 天前」这类解析不出日期的
  文本时，按导入时间参与排序，不会整批甩到最前面。
- 工具栏末尾的 **恢复默认排序** 随时可回到「最近导入在前」，并回到第 1 页；默认态下按钮是灰的。
- **排序不进 URL**：离开岗位广场（去简历中心、设置等）再回来，排序已恢复默认；带 `sort`/`order`
  的旧链接也按默认排序打开。

## 4. 制作、编辑和导出简历

> **本阶段收尾已补齐**：分页面板的**页面概览 / 获取分页报告**、来源核对里的**建立 / 解除来源关联与采纳写回**、
> 双语版本的**「在工作台查看这份译文」**只读预览。制作台左栏同时按 v2 模型重组为「模板 / 版面 / 样式」三组，
> 条目/字段排版并入「本份简历结构」页签；旧「板块顺序」控件与「简历结构示例」弹窗已删除（顺序改在结构页签顶部的「顺序」按钮里上下移）。

**版面诊断**：简历预览上方会显示"正文占了页面的百分之多少"，以及该按什么顺序改。

| 结论            | 含义                                     |
| --------------- | ---------------------------------------- |
| 合适            | 单页占用 82%~96%，既不留大片空白也不拥挤 |
| 偏满            | 超过 96%，改两个字就可能溢出一行         |
| 偏空 / 明显太空 | 低于 82% / 60%，页面下方空着一块         |
| 超出所选页数    | 按当前排版设置需要更多页                  |

多页简历另看**末页**：末页低于 70% 说明最后一张几乎是空的，把内容前移或减少页数会更好看。

建议固定按 **重排 → 结构 → 间距/字号 → 精简内容 → 扩页** 的顺序给。这个顺序本身就是规则：先让人调间距、调不好再让人删内容等于让人白改一轮；反过来先说"精简内容"，用户又可能删掉本来放得下的经历。所以只有前面几步都不够时才会提到下一步。

**自动一页**：内容塞不下时（结论是「超出所选页数」）面板上才会出现这个按钮。它按「页边距 → 区块间距 → 行高 → 字号」逐档收紧，**每试一档量一次，够放下就停**——不会一步把字号缩到最小。字号最多缩到 11px（≈8pt），这是打印可读性的下限；面板上会提前写明这个下限，不让你按了才知道。这个下限只约束**自动一页**：手动滑块可以拖到 5px（见下面的「字号」），自动一页不会替你把字缩到那么小——要更小只能你自己动手。

排版参数已经收到最紧还是放不下时，它会**如实告诉你**"只能精简内容或增加页数"，而不是假装成功。自动一页试出来的方案只写进**这一份简历**，不会去改你在「工作台」里做的版式——那个是共用的，而自动一页的结果只对当前这份内容成立。

**长 CV（最多 10 页）同样可用**：文档模式切到长 CV、篇幅上限设 5 页或更多时，版面诊断与自动一页按 1–10 页校验，不会因为普通模式的 3 页上限被判成无效请求。

### 通用简历：简历中心的「AI 生成」

简历中心页头的 **AI 生成** 不绑定岗位，生成一份 **通用简历**：按**当前方案**读取资料库（不按岗位方向
筛选，但当前方案排除的板块整块不参与），适合方向未定、跨行业投递或"先有一份能改的底稿"。页头的
**新建简历** 仍是手写入口（弹窗标题「从头编写通用简历」），两者都出现在简历中心，导出方式一致。

新建简历与「从资料填充」的候选同样跟随当前方案：只出现参与板块的条目，新建简历的页签、**页签名与每个
板块的可见字段**也按当前方案投影生成（资料里隐藏的字段不出现，自建板块显示你起的名字，如「22333」，语言能力是独立页签）；资料
修改或切换方案后（包括在另一个窗口操作）会自动刷新，见上面的「通用简历」。这份编辑器视图会在**创建简历时
冻结**：此后修改方案只影响新建的简历，已保存简历的板块与字段不变（不会出现"保存一次就跳回当前方案"）。
R-34 的正文保留规则照旧——切换方案不会把已有正文藏掉。生成弹窗顶部会显示只读的
「本次使用：{方案名称}（{N} 个板块）」。

**已保存简历的「本次使用」与重新生成提示**：打开一份已保存简历的详情，元信息区会显示它保存时使用的
「本次使用：{方案名称}（{N} 个板块）」，鼠标悬停或用键盘聚焦可以看到具体包含的板块名；如果那个方案后来被
删除，仍会按快照显示当时的方案名称与字段，并标注「方案已删除」。在你修改资料条目、切换当前方案或改动板块 /
自定义字段定义之后，简历详情会显示「资料或方案定义已更新 / 已保存简历不会自动变化，需重新生成才会体现在
纸面上」——这是提示，不是自动改动：已保存的简历正文不会自己变，要按新资料出纸面请重新生成一份。

生成弹窗里可以显式选择 **文档模式**：

- **普通简历**（默认）：1–3 页 A4；
- **长 CV**：最多 10 页，适合科研、项目制或资深经历较多的人。**长 CV 只是页数策略，不会自动切换**；
  篇幅超上限时会如实提示并按上限截断，不会自动缩小字号——想压进更少页请改页数、行距或页边距。

弹窗里的 **职业场景（用于本次生成）** 默认关闭：打开并选中场景后，会显示"本次会发送的维度"，
就业状态需要单独勾选才会发送；关闭时生成请求与旧版本完全一致。生成开始后即使用户切换页头场景，
本次任务也只用创建时冻结的快照。

从岗位详情选择以下一种方式：

- **用 AI 生成简历**：按岗位要求从完整资料和相关总结中筛选事实，可选择是否美化拓展及轻度、
  均衡、深度三个级别；美化不应改变姓名、组织、角色、日期和其他结构事实。
  生成结果统一采用「强动作动词 + 方法 + 结果」的短要点（每条 30 字左右、同一段经历或项目
  最多 6 条，个人总结 2-3 句），并去掉口语、套话和"赋能/抓手/闭环"这类黑话——生成后系统还会
  本机检查一遍，命中黑话会自动改写一次，仍存在时会在结果上提示你。把"参与"写成"主导"这种
  **升格职责范围的改写不会发生**，也不会为了凑 JD 关键词写入你没有的技能。
  生成前还可以定三件与内容无关的事：
  - **最大篇幅**：1-3 页 A4，默认 1 页；这个数字会翻译成"整份简历控制在多少字、每段留几条要点"
    写进生成要求。
  - **字号**：拖动滑块在 **5-18px** 之间调整，步进 **0.1px**，读数保留一位小数；滑块左右两端的
    「缩小 / 放大」按钮每点一次 ±0.1px，到边界自动禁用。默认标准（14px），只影响排版密度。小于 8px 时
    读数旁会提示「打印可能看不清」（5px 在 A4 上约 3.75pt，是"再小就没有打印意义"的界线）。落库时
    记成"档位 + 精细系数"，所以已有简历不受影响。
  - **模板**：经典 / 现代 / 精简 / 优雅 / 技术 / 极简六套，随时可以在预览里换；选择器打开就是每套模板
    的真实效果，不必先盲选名字再看。
    另外有 **补充要求（选填）**：用一句话说明你的偏好，例如"突出性能优化经历""不要出现'负责…'
    这类空泛表述"。它只影响表达方向，不会改变事实锚定、篇幅上限与防虚构规则。

**生成在后台进行，弹窗可以随时关掉。** 点击 **开始生成** 后，任务交给后端后台线程执行，
弹窗里只显示阶段条与实时计数：**整理资料 → 筛选资料 → 调用模型生成 → 校验修复 → 完成**，
外加一句「已接收多少字」。这里**刻意没有百分比**——模型是逐字流式输出的，后端无法预知总长度，
任何百分比都只能靠猜，一个"看起来精确、其实是编的"百分比比没有进度更误导人。生成期间：

- 想继续看进度就留在弹窗里，阶段条和字数会随进度更新；
- 也可以**直接关闭弹窗**（点弹窗的 ✕ 或「后台继续」）——任务不会被取消，会在后台继续跑，
  完成后会弹出 **「简历已生成」** 提醒，并写明已自动保存到简历中心，去简历中心就能继续微调或导出；
- 想真正中断，点弹窗里的 **取消生成**。取消后**不会保存任何半成品简历**，已经写入的内容一并作废；
- 连点两次「开始生成」不会产生两份任务或两份简历：后端发现已有任务在跑时会直接拒绝并提示等待。

生成完成后进入预览，仍可换模板、调页数与字号——这些只重新渲染同一份内容，不重新调用模型。

- **自行编写简历**：从个人资料预填统一的简历编辑器，并在旁边保留岗位职责、要求、技能和
  其他信息，用户自行取舍和修改，不调用大模型。宽屏下这两栏**各自独立滚动**（改到简历末尾时
  右侧岗位要求仍停在原处），窄屏则回到单列 + 「查看岗位要求」折叠面板。
  **「新建简历」弹窗已使用与制作台相同的新编辑器**：三区卡 + 字段位置，打开时初始内容整份来自
  当前方案投影（只含参与板块与可见字段；自建板块显示你起的名字）。
  **中栏顶部的「从资料填入」菜单**点开后才拉取当前方案投影：候选按来源（source）去重，选中后只补
  空字段——你手写过的内容一字不动；资料页改过或切换方案后再点开会重新取候选。需要新条目时用
  板块自己的「添加…」按钮。菜单顶部有搜索框（按标题 / 说明 / 板块过滤，没命中的词给空态）、头部显示
  「N 项可添加」；分组标题在滚动时吸附，条目带缩进并在右侧标出板块来源灰字，popup 高度不超过 60vh。
  资料里的**学习形式、学位类型、院系、成绩排名、导师、研究方向、团队规模、工作类型、项目规模、成果类型、
  技能分类、活动类型、颁发机构、奖项级别、获奖比例、我的署名位次、项目级别、基金/资助、证书类型**等字段，
  在简历编辑器里也都有输入框：手写新建、从资料填入或 AI 生成后都可以在简历里直接改；每个字段按自己的
  **纸面位置**出现在标题行 / 元信息 / 正文前后灰字 / 正文，也可以在制作台里拖到别的位置（空值不出现）。
  **从岗位详情进入「自行编写简历」时同样按当前方案预填资料**，只把求职意向覆盖成岗位名。
  校验失败后的定位仍会滚到目标字段。

简历预览按所选篇幅显示（1-3 张 A4）。拖动「字号」滑块会实时缩放预览，松手后自动保存并重新渲染。
可使用滚轮缩放，放大后按住纸面拖动。预览是**只读**的：要改内容请点「手动调整」，
或在编辑器里选中一段文字后右键「AI 润色」。已保存简历可以按需生成岗位化修改建议，
建议只供参考，不会自动覆盖正文。「从资料填入」菜单的候选与资料页的当前方案同源：
资料改动或切换方案后会跟着刷新；切换方案只会影响之后能填进空字段的候选，已经写进这份简历的正文不会被删掉。

**AI 修改 / 重新生成**：简历预览底部（已保存的简历）有「AI 修改 / 重新生成」入口——

- 填了修改要求（≤2000 字）时**只修改你提出的部分**，其余内容逐字保留；修改只能基于简历已有
  事实或你在要求里给出的信息，模型不会虚构新经历；
- 留空则**整体重新生成**：事实口径不变，表达与结构重新方案织；
- 修订**直接更新当前这条简历**（不新建记录）并刷新预览；姓名、照片与联系方式不进模型、由代码
  强制回填；修订前建议先「下载 JSON」或用版本对比留底，不满意可再修订或手动调整回来。

「岗位优化建议」弹窗里的每条建议新增**采纳并修改**按钮：按这条建议修订简历（同样只改它涉及的
内容），成功后预览立即刷新。

它和「质量检测」一样**先说明、你点了才生成**：打开弹窗先看到说明卡（要读什么、大概 10–60 秒、
能不能走开），点「开始生成」才真的调用模型。生成中显示已用时，并可以**关掉窗口**让它在后台继续
（常驻通知里能取消），也可以点「取消生成」当场中止——**关窗口不等于取消**。完成后回来重新
打开弹窗直接看到结果，不会重复调用模型；「重新生成建议」会先问你一句再覆盖当前建议；简历内容
改过之后旧建议会自动清空，避免你对着旧正文点「采纳」。

**为什么是这样一份简历（生成说明）**：AI 生成的简历在预览里有一个折叠说明，讲清楚岗位信号、
候选资料的组成、哪些内容因交集不足没有进入生成、以及事实约束是什么——全部由确定性数据拼装，
不是模型自己写的理由。预览顶部还会把提示分成两组：「疑似虚构，请核对」只包含真正的核对项；
「这些资料内容没有写进这份简历」是岗位导向筛选的正常结果，以中性清单列出，每组附
**「AI 补上这段」**按钮（预填修订指令，只新增不改其余）与「打开手动调整」。

**GitHub 主页 / 个人主页**：资料里填写的 GitHub 主页与个人主页会在生成时提供给模型，并作为
独立字段渲染在简历页眉的联系方式区；也可以在「手动调整」→「基本信息」里直接填写或修改。
它们只作展示，不参与防虚构核对。

**页边距可以只调某一边**：打开「简历制作台」，排版参数里的「分边调整页边距」**默认是展开的**，
四条滑杆分别对应上 / 右 / 下 / 左（范围 0–26mm，拖到 0 就是正文贴着纸边）；点「分边调整页边距」
可以收起，再点一次重新展开。只有被单独改过的那一边才出现 ↺，点它——或者双击边名——这一边就回到
统一值；没出现 ↺ 的边跟着统一页边距走。**分边只在「简历制作台」里有**：生成前的配置页与预览
工具栏只保留一个总页边距，四边分开调需要的那一列纵向空间在那里放不下。

**「简历制作台」把改内容、调参数、看版面放在同一屏**：点预览下方那一排动作里的「简历制作台」，
打开的是三栏——左边是模板、版式、排版参数（多出「层次与间距」与「外观」两组：区块间距、条目间距、
姓名大小、小节标题大小，以及强调色、正文颜色、辅助文字颜色、分隔线颜色）。条目间距只作用于预览、
HTML 与下载的 PDF；导出的 Word 用自身的条目排版模型，不跟随这一项，其余参数三处一致；中间是简历
内容编辑器，右边是按原始尺寸显示的版面。改完一句措辞点「保存内容」，右边立刻按新内容重排，窗口不会
关；中栏还有没保存的改动时，底部「手动调整」会先禁用，避免两个编辑器同时改一份稿子。屏幕窄到放不下
三栏时中间一栏收进「编辑内容」抽屉；再窄时左栏也收进「排版参数」抽屉，画布独占一屏。两个按钮都在
弹窗顶部那条动作条上（在「导出」左边），点开就能改，关掉就回到看版面——**内容编辑在任何宽度下都可达**，
不需要先退出制作台再走「手动调整」。

**改参数时预览不会跳回原样**：在左栏调字号、行距、页边距或条目排版，右边预览会按新设置重排，
但你之前的**缩放大小和滚动位置会保留**——放大到的比例不会被打回"一页完整"，滚到的位置也不会被
顶回页首，可以边调边对照同一处。只有点缩放条上的「适应页面」才会回到整页比例。

**左栏和内容栏都能拖宽，也能一键恢复默认宽度**：两条分隔条分别在参数栏右缘与内容栏右缘，把指针移到
分隔线上会变成左右箭头，按住拖动即可改宽（参数栏 360–640px、内容栏 380–760px；双击分隔条复位）。
拖动只改本机的栏宽偏好，不写进简历、不影响导出；拖动时会按"预览至少要放得下一张 A4"预留画布宽度，
所以窗口越窄可拖的范围越小。左栏的六个页签在窄栏里会换行显示（不会省略成半截），拖宽之后又回到一行。想回到默认宽度，点顶部
动作条上的「恢复默认列宽」——它把参数栏与内容栏一起复位；两栏/单栏（窄窗口）形态没有可拖的栅格，
因此动作条上不出现这颗按钮。

**调过头了，每个参数右侧有一颗 ↺，把它退回"刚打开这份简历时"的值**：改过哪一项，那一格原来写「随模板」
的位置就变成一颗小箭头按钮，点一下只恢复这一项，其它参数原样保留。它与"双击参数名恢复默认"是两件事
——双击是**删掉你的设定、回到模板或版式的默认值**；而 ↺ 回到的是**你打开这份简历时看到的那个值**（哪怕
它本身就是上次手调过的）。改名、切换模板、保存之后再进来，基线就是保存后的那一版。这颗按钮只在「简历
制作台」左栏出现，预览工具栏与生成前的配置页没有它。

**需要强调某几个字时，用正文输入框上方文本工具区的「加粗」**：它把选区写成行内标记，HTML / PDF / Word 都按粗体渲染（PDF 没有斜体字形，斜体入口已移除）。整段文字的字重不再单列开关；颜色、行距、缩进、项目符号、对齐、字距这类局部排版走字段右键「调整排版」浮层。

**内容塞不下时不用重新生成**：预览上方会醒目提示"按当前设置约需 N 页（上限 M 页）"，并写明"还多出约多少"。
字号、行距、页边距**严格按你在排版栏里设定的值渲染**——应用不会为了让内容挤进页数上限而自动缩小字号
（那样滑杆上的 18px 与纸面上的 18px 就对不上了）。放不下时请从这三条里选一条：增加页数、收紧排版
（「版面诊断」里的「自动一页」会逐档收紧并把新参数写回滑杆，你能看见它改了什么）、精简内容。
选 2 / 3 页时，预览是**几张 A4 上下摞着**（页脚下方标注"第几页 / 共几页"，
往下滚就能看下一页）；**任何页数上限都不会多排一页**——放不下的内容直接截断、不显示（草稿与
精确都是），提示里会写明"超出上限的部分不会显示"，先收紧排版或增加页数才能看全。这里的多页是**按 A4 高度切分的近似分页**（预览上会明确标注）；
要看真实分页，把预览工具栏第一行切到**「精确」**——那显示的是导出引擎排出的同一份 PDF，与点「导出」
下载到的文件逐点相同，页数也照它报；超限时它同样会给出"按当前设置约需 N 页（上限 M 页）"的提示。
**制作台里还没点「保存」的正文也会进精确预览**（改完一句直接切「精确」就能看到，不用先保存）：
这种情况下 PDF 底部会注明"这份预览含还没保存的修改，导出前请先保存"——预览按你眼前的草稿排，
而下载仍按数据库里已保存的那一版，先保存一次两边就完全一致。
同时仍提供「增加到 N 页」「改为小字号」两个按钮——它们只是按新参数
重新渲染同一份内容，不会再次调用模型。换成新
模板、调页数或拖动字号滑块也会写回这条简历记录，下次从简历中心打开时的排版设置与这次一致。
**板块顺序与字号系数同样如此**：生成界面里的板块顺序默认跟随「我的资料」的板块顺序（你调过资料
顺序就直接按那份排），配置页的「顺序」面板可以逐个上移 / 下移或点「与资料顺序同步」；改过的顺序和字号会随这条简历一起保存——之后再从简历中心编辑、
预览或导出，看到的都是你调过的那一份，不必每次重调。制作台与生成界面的「板块顺序」列表只列出这份
简历里**真的有内容**的板块（与纸面一致）；自建板块固定排在系统板块之后、只读列出，不参与上下移。
早期没有这条记录的简历继续用内置默认顺序，外观不会因为这次升级而变化。

每次保存都会在简历中心形成独立记录，并标明“AI 生成”或“用户编写”。
删除不需要的简历时，确认弹层的按钮会明确写成「删除这份简历 / 先不删」——删除只把记录移入回收站，
之后可以在「回收站」里恢复。一个岗位可以关联多份
简历，岗位详情可查看全部对应版本，简历详情也可返回关联岗位。

简历中心的每条简历都可加一条**备注**（悬停查看全文、详情弹窗里可编辑），用来标记“这份是哪一版 /
投给谁”等用途；列表还支持按**收藏 / 有无岗位 / 岗位**筛选。按岗位筛选时列表只保留该岗位的简历、
页码回到第 1 页，并把这个岗位写进地址栏（`?job_id=`）——存成书签或从别处用这个链接打开会自动回填
岗位名；岗位已不存在时降级显示 `#id`，筛选仍然生效。点清除只去掉岗位这一项，关键词与「有无岗位」
不受影响。

简历中心的**搜索框边输边搜**：输入停顿约 0.35 秒自动生效，按回车立即生效，清空后立即恢复全部记录；
每次应用搜索都会回到第 1 页，排序、岗位关联等其它筛选条件不会被搜索覆盖。

**简历中心的排序和岗位广场是同一套操作**：点「简历标题 / 目标岗位 / 创建时间 / 最近修改」四个列头
之一排序，第一次升序、再点降序、第三次取消并回到默认（最近修改在前）；默认状态下任何列都不显示
箭头。筛选栏右侧的 **恢复默认排序** 随时可回到默认并回到第 1 页，默认态下按钮是灰的。与岗位广场
不同的一点：简历的排序会写进地址栏（`?sort=`），刷新页面或把链接发给别人时保持同一顺序；链接里的
旧值（例如以前的「按公司」）会安全地回到默认，不会报错。


### 撤销与恢复：每一步都能退回去

制作台左栏的「历史」页签把这次打开以来的操作列成两组：**已进行**与**可恢复**。内容修改、排版调整、结构操作
各记一步；连续输入会合并成一步（停顿一下再输入就是新的一步），不会因为每敲一个字就多十条记录。

- **撤销 / 恢复**：只走一步，等价于把文档退回到上一步或再往前走一步；
- **点一步看摘要**：点某一步只切换预览，显示它当时的「姓名 · 条目数 · 页数」，**不会**直接把文档跳到那里——
  真正的回退永远由「撤销」执行，避免误触出现不可逆结果；
- 历史跟着这次制作台打开的过程走；关掉再打开，从当前状态重新开始记录。

### 局部排版：只改某一个字段

制作台左栏「样式」组负责整份简历的**字体字号、字距行距、页边距与外观颜色**；按字段 / 角色的局部排版在中栏字段上**右键 →「调整排版」**打开浮层：

- **作用范围自动推断**：点哪个字段就调哪个角色（正文 / 灰字 / 日期与元信息等），不需要先选「整条 / 条目头 / 正文 / 灰字」；
- **浮层里可改**：颜色、行距、缩进、项目符号、对齐、字距；日期与元信息字段另有「日期位置」（日期靠右 / 日期紧随标题）；
- **整条也能调**：在条目标题行或左栏结构树的条目行右键 →「排版整条…」，打开同一个浮层，作用范围固定为这一整条（写入这一条的对象级覆盖）；
- **没设过的属性跟随模板**：每行右侧的来源胶囊写明这一项来自哪里（「来自模板」「已调整」等）；点旁边的 ↺ 或双击参数名，只把这一项**恢复继承**，其它设置不动；
- **字号、加粗与段前段后不在此处**：字号与间距统一由左栏「样式」组的字体字号 / 间距控制；
- 改完随简历一起保存：HTML、PDF、Word 按同一份局部设置渲染；日期位置与元信息加粗在精确 PDF 里同样生效。

### 条目字段的位置与顺序

字段级的位置（标题行 / 元信息 / 正文前灰字 / 正文 / 正文后灰字 / 隐藏）与顺序在「本份简历结构」页签里调：

- 结构树选中条目后，下方「灰色短字段顺序」按**正文前 / 正文后**分组，组内顺序就是纸面顺序；每行「前 / 后」开关换组，↑↓ 只在组内移动（组首 / 组尾按钮置灰）；
- 右侧纸面会在约 1 秒内跟随新顺序刷新，不需要切页签或重开制作台；
- 字段的隐藏 / 显示用结构树行内按钮或右键菜单，隐藏区可一键「显示」回原位置。



**看不懂参数时，直接看真实画布对照**：v1 的「简历结构示例」示意弹窗已删除——现在中栏画布就是这份简历的
真实排版，改哪一项都能即时看到纸面变化；结构页签与画布点选联动，比示意图更准确。

### 联系方式换行：整字段不拆行

页眉的联系方式默认**每个字段整体不拆行、字段之间自动换行**——长网址不会再被从中间截成两行。
制作台左栏「版面」组里有「联系方式换行」下拉，可以指定在哪个字段前**强制换行**
（例如让个人主页单独另起一行）。这项设置随这份简历保存，草稿预览、精确预览 PDF、Word 与 HTML
导出读同一份取值；旧简历没有这项设置时就是默认行为（不强制换行、每个字段整体不拆行），外观不变。

### 条目字段位置：标题行 / 元信息 / 正文前灰字 / 正文后灰字 / 正文 / 隐藏

制作台中栏里每个条目是一张**三区卡**：上面是「标题与元信息」，中间是「灰色短字段」（分正文前 /
正文后两组），下面是「正文」。卡片里的每一块内容都是一个字段，把字段拖到别的区就会改变它的位置；
展开字段后也能在「字段位置」下拉里直接选（六个位置都在里面）：

- **拖到「标题与元信息」**：标题行的字段在纸面左侧加粗，元信息的字段在右侧或下一行、灰色；
- **拖到「正文前」/「正文后」**：进入条目正文前后的灰色短字段组；
- **拖到「正文」**：成为正文块（要点或段落），可以在字段菜单里切换**正文样式**（要点 / 段落），
  也能选择是否带「标签：」前缀；
- **隐藏**：内容保留、不上纸面；在结构面板的「隐藏」分组或字段菜单里随时恢复。

拖拽有键盘等价物：选中字段后按方向键移动、回车确认、Esc 取消；放不下的位置会明确提示（例如把标题类
字段拖进正文块），不会静默丢掉内容。

点一个字段 chip 会展开它下方的编辑器；**再点同一个 chip 收起**，键盘用户也可以按 Esc 收起。
展开 / 收起只影响中栏，不会改纸面内容。

字段 chip 上不再放隐藏/删除按钮：**在字段上点右键**（键盘用 Shift+F10 或菜单键）可以看到
「隐藏字段 / 显示字段 / 移除字段」；展开后的编辑器也不再重复放一组。右键字段不会打开字段编辑器。

**条目操作也在右键菜单里**：在条目标题行（或左栏「本份简历结构」页签的条目行）点右键，可以看到
「排版整条… ｜ 上移条目 / 下移条目 / 复制条目 ｜ 隐藏条目 / 移除条目」六项；「排版整条…」打开的是
与字段「调整排版」同一个浮层，区别只在作用范围**固定为这一整条**（浮层里不再让你选范围）。

字段隐藏后再从右键菜单选显示，会回到**隐藏前的位置**（不是一律回到正文后灰字）；隐藏前的位置会随文档保存，
下次打开继续生效。

**标题布局三选一**：条目卡顶部可以切换「左右」（标题左、元信息右，默认）/「上下」（标题一行、元信息
下一行）/「元信息在上」（元信息一行、标题在下）。长元信息会换行显示，不会自动缩小字号。

**行内板块（专业技能 / 语言能力）每条一行**：每条技能 / 每种语言在编辑器里各占一行，行内有正文与
灰色补充信息，行头可上移 / 下移 / 隐藏 / 移除；选中一行后可在行内继续「添加字段」。底部「添加专业技能 /
添加语言能力」会按字段目录预填常用字段并自动选中新行。

### 条目字段排版：列数、对齐与间距

正文前后的灰色短字段可以按**板块**或**单条条目**调排版：

- **列数**：一行 1–3 个字段；设了「独占整行」的字段会单独占一行；
- **对齐方式**：「等宽列」时同一个条目的所有行共用一个网格、跨行严格对齐；「按内容」时按字段宽度顺排、
  用「 · 」连接；
- **列间距**：按字号倍数调（0–8），换字号或模板时比例不变；面板会直接给出换算（例如「4.00 倍字宽 ≈ 56px」），
  三列且每列已被挤到 60px 以下时会提示调小间距或改用两列；
- **列宽**（两列以上）：按列填百分比，合计必须是 100%，不等于 100 时「应用列宽」是禁用的；「恢复等宽」回到平分；
- **逐间隔**（两列以上）：相邻两列可以各填一个间距，不填就统一用上面的「列间距」；
- **顺序**：字段在卡里的先后就是纸面上的先后，拖动即可改；
- **显示标签**：每个灰色字段可以选显示「标签：值」或只显示值。

调整作用于「整个板块」或「只这一条」：选中某一条后改的只作用于它，没改过的项继续继承板块默认；
点「恢复默认排版」把该板块还原，单条的覆盖可以点「跟随板块」恢复继承。这些设置随这份简历保存，
HTML / PDF / Word / Markdown 四种格式用同一份结果（分页、字体、链接呈现按格式各自处理）。

**行内板块（专业技能 / 语言能力）与单段板块（个人总结）不按条目排版**：它们没有条目级的标题/日期与
分页落点，选中这类板块时面板不再显示条目级控件，只保留板块选择器与字段检查器，并写明原因。

### 字符级样式：斜体与链接

正文工具区有「斜体」「链接」：选中一段文字再点即可。**HTML 导出**里的链接可点击（仅 http/https/mailto；其它协议按普通文字保留）；**Word** 里斜体是真斜体、链接显示成「文字 (URL)」；**PDF** 斜体按近似（不倾斜但文字完整）、链接是可见 URL 文本；Markdown 保留标记、纯文本只留文字。没闭合的星号或非法链接会原样留在正文里，不会被悄悄吞掉。

### 页面概览与分页报告

「版面」组的分页面板下方是**页面概览**：点「获取分页报告」后，后端按**真实 PDF 同一条渲染管线**排一遍，
显示实际页数、末页占用、溢出截断、手动断页落点与注意事项；版式或正文改动后点「重新获取」即可。
没有报告时如实显示空态，不画假页。

PDF 与 Word 会把板块标题连同后续内容整段预留、要点整条预留，减少标题或某句要点孤零零落在页首/页尾；
草稿预览不显示真实分页，以精确预览 / 导出为准。

### 分页控制：分区与条目从新页开始

内容多、又不想让某个板块或某条经历从半页中间开始时，用制作台左栏「版面 → 分页」安排断页：

- **分区级**：在「版面 → 分页」给整个板块开「从新页开始」或「整块不跨页」；
- **条目级**：先切到「本份简历结构」页签，选中一条经历后，在「条目字段排版」下方的「这一条的断页」开「从新页开始」或「整块不跨页」；行内板块（技能 / 语言）与单段板块（个人总结）不按条目排版，因此不显示这组控件；
- 已设置的断页会汇总在分页面板顶部的「已设置断页」条里：点一条可跳到对应位置，点 ✕ 可只清掉这一条；「恢复自然分页」清掉板块级断页，条目级断页仍由结构页签管理；
- 分页面板顶部有「切到精确预览」按钮：断页只在精确预览与导出里真正生效，草稿预览是连续流；
- 这些设置落在这一份简历的文档布局里（随简历保存），HTML / PDF / Word 用同一套口径；
- **草稿预览看不到真实分页**：草稿是按 A4 高度切的连续流，不是分页媒体，**不会画假分页线**；
  想看实际断页请把预览切到「精确」，或直接导出 PDF——那才是导出引擎排出来的同一份版面；
- 断页意图不解除页数上限：超出上限的内容仍会被截断并提示，先收紧排版或增加页数。

分页面板里的「页面概览 + 获取分页报告」可核对真实分页（见上一节）；已设置的断页与不跨页选项都保存在简历里，可随时关闭。

### 表达资产库：收藏、检索、插入

制作台左栏「表达资产库」页签把好用的表达存成可复用资产：

- **收藏有两个入口**：页签头部的「收藏当前要点」与正文要点右键菜单里的「收藏当前要点」；没选中要点时头部按钮是禁用的，悬停会说明「先在左侧选中一个要点」。也可以直接在资产页签手工新建；条目可标注类型（成果 / 方法 / 结果 / 总结）、语言与岗位标签；
- **检索**：按关键词（正文与岗位标签）、类型、语言、岗位标签筛选，可切换排序（最近使用 / 用的次数 / 收藏时间）；
- **插入**：选中要插入的位置后一键插入——服务端生成**新的对象身份**，不会和原条目共用 id；插入成功后会自动选中这条新内容（与结构树 / 编辑器的选中状态同源），插入后仍可继续手改，也可以随时删掉；
- **卡片与动作**：卡片元信息读出「类型：方法 · 语言：未标注 · 来源：手工收藏 · 已用于 N 份简历」，列表计数是「共 N 条资产」；复制 / 编辑 / 删除收在卡片右侧的「⋯」菜单里（Enter 打开、方向键选择、Esc 关闭）。插入按钮在未选中位置时禁用并说明原因，卡片下方不再常驻提示；
- **删除可撤销**：删除只是进回收站（表达资产是回收站的一类），Toast 里 5 秒内可点「撤销」恢复；
- 资产只存在本机、随数据集走，不会自动外发；插图（照片等）不在资产正文内。
### 保存冲突：两个窗口都改过同一份简历

在「简历制作台」里保存时，如果这份简历已经在别的窗口（或另一个标签页）改过，保存**不会直接覆盖**，而是先让你三选一：

- **用最新的**：放弃本地这次改动，换成服务端最新那一版；
- **比较差异**：并排看「你的版本」和「服务端最新」，确认后再决定；
- **另存副本**：把本地这版另存成一份新简历（标题带「（副本）」），原简历保持别人改过的那版。

选完才继续；失败时改动会留着，可以直接重试，不会丢掉你刚写的内容。

### 本份简历结构：按位置查看、排序、隐藏与锁定

制作台左栏顶部有「排版参数 / 本份简历结构 / 双语版本 / 表达资产库 / 来源核对 / 历史」页签（后几个按宿主是否挂载显示；本份简历结构就是原来的「文档大纲」，历史见上文「撤销与恢复」）。结构树按
**页 / 栏 → 板块 → 条目 → 位置分组** 展示，位置分组就是标题行 / 元信息 / 正文前灰字 / 正文 /
正文后灰字 / 隐藏：

- **新建板块（仅本份简历）**：中栏页签条末尾的「+」打开输入框，建好即出现在末尾并选中，结构树同步；
  它只属于这份简历——「我的资料」里不会多出这个板块，「从资料填入」也不会包含它；保存后重开仍在；
- **删除自建板块**：在页签上点右键可删（系统板块不提供删除，只能隐藏或改标题），删错了 Ctrl+Z 能撤销；

- 拖动或键盘移动条目、条目内的字段与要点，顺序与纸面、导出同步；**拖动时结构树与右侧预览会实时按新
  顺序重排**（只预览、不写库、不进历史），松手才记一步历史，拖到行外松开则取消；拖动中目标行带滞回、
  被拖行自身不参与命中，不会因为预览换位而反复跳动，松手提交的顺序与最后看到的预览一致；
- **跨位置分组拖动**字段即可改变它在纸面上的位置——等同于在中栏把字段拖进另一个区；
- 顶部可以**搜索**板块、条目与字段：结果高亮、↑↓ 选择、Enter 定位、Esc 清除；点「在纸面定位」会把
  右侧画布滚到那一处，从纸面点选也会反向选中结构树里的对应行；**列表值（核心课程、技术栈等）与作者署名同样可点**，
  点击后中栏会切到对应字段；
- **复制**条目会生成新的对象身份，复制出来的条目与原条目互不影响；
- **隐藏**只影响正式导出（PDF / Word / HTML / Markdown / 纯文本），编辑态仍保留原文；结构树里可随时再显示；
- **锁内容**后 AI 与翻译不能改正文，但仍可调排版；**锁排版**后正文能改，但排版参数不会被自动化改写。

顶栏还有一个折叠开关和一个「顺序」按钮：

- **折叠开关**（图标与名字随状态切）：全展开时它叫「收起全部」（向上箭头），点一次把整棵树收成板块列表，
  再点一次它变成「展开全部」（向下箭头）回到全展开。**只有一个开关**，不再有「收起所有条目」这种中间档；
- **顺序**（交换图标）：打开板块顺序列表，逐项上移 / 下移即可调整板块先后；点「与资料顺序同步」把顺序恢复成「我的资料」里的板块顺序。改完立即反映到纸面与导出。

树的最上方是一行 **基本信息**（括号里是字段数），展开后按纸面顺序列出姓名、姓名旁小字、求职意向、
联系方式、照片等页眉字段——它们不再按位置各占一行。

连选条目（多选批量排版用）：**按住 Shift 点条目**，从上次点击的那条到这一条的整段都会选中（行左侧出现
一条竖色条）；也可以按 **Shift + ↓ / ↑** 逐条扩展。不按 Shift 的普通点击会清空已选。

选中结构树里的一项，纸面对应位置会同步高亮；点「在纸面定位」可以直接滚到那一处。

### 科研简历：学术成果、科研项目与知识产权

制作台中栏有三栏科研内容，字段与纸面一一对应：

- **学术成果**：标题、成果类型、我的署名位次、作者及顺序（署名顺序就是纸面顺序）、期刊 / 会议、年份、
  状态、DOI / 链接、备注、卷期页码。状态严格区分「已发表 / 已接收 / 出版中 / 在投 / 预印本 / 其他」——
  **在投不会被显示成已发表**。
- **科研项目**：项目名称、本人角色、所属机构、项目级别、起止时间、项目描述、成果与经费。
- **知识产权**：名称、成果类型（含软件著作权）、发明人及位次、专利号、国家 / 地区、状态、申请 / 授权日与链接。

空着的栏位不会写进内容；隐藏的条目不会出现在任何导出里。DOI 与链接只有 http(s) 地址会变成可点链接，
其它内容按纯文字保存。证书资质与语言能力在资料页录入；语言能力在简历里是**独立栏目**（制作台左栏
同样有独立的「语言能力」页签），按“语言（水平 · 证书 · 分数）”展示，例如“英语（CET-6 · 550）”，
取得时间作为行尾说明；不会再混进「专业技能」。旧简历里已经并进技能的语言条目不迁移、保持原样。

自建板块在简历上**独立成一栏**（标题就是板块名），排在 13 个系统板块之后；它的条目与系统板块同构：
主文本默认放正文，其余字段按各自默认位置排列（多数在正文后灰字），制作台里都可以再拖到任意位置。

### 长 CV：最多 10 页

**制作台左栏「排版参数」顶部有「文档模式」**（仅已有记录的简历显示；新简历在生成弹窗里选）：
普通简历 1–3 页、长 CV 上限 10 页；切回普通简历时若当前页数超过 3 页，会自动夹到 3 页并提示你。
「版面」组的「篇幅上限」（1 / 2 / 3 页）决定这份简历本次的篇幅上限，预览与导出同口径（同一键不再有第二个入口）。

切模式保存的是这份简历自己的设置；两份语言版本各自保存模板、版式与页数，互不连带。

### 按条件优化版面

「版面诊断」卡下方新增「按条件优化版面」：先声明约束，再让它在你允许的范围内收紧排版。

- **约束**：不动字号 / 最小页边距（mm）/ 目标篇幅（1–2 页）；
- **候选**：最多 3 个有差异方案，每个写明改了哪些排版参数、减少多少溢出、预计页数、可读性影响分级；
- **应用**：把候选里的数值写回左栏滑杆——你能看见它改了什么，也可以继续手调；
- **无方案时**：会说明原因（锁定的条件把候选排除了 / 已收到最紧 / 试过仍放不下），**不会偷偷缩字号**。
- **内容精简候选**：除版式参数外还会生成内容层候选——合并重复条目、删除重复要点、合并短要点；有岗位信号时建议精简低相关要点。每个候选列出具体改动与影响，先看差异、逐项确认才写入（进历史可撤销）。

### 来源核对与事实锁：这条内容从哪来

制作台左栏「来源核对」页签回答两个问题：这段话来自哪条资料、关联是否还最新。

- **关联覆盖**：顶部显示已关联 / 总数与未关联条数；选中一条内容后，只列出与它相关的对象及关联状态。
- **来源链**：列出这份简历引用的来源（标题 / 类型 / 当前指纹 / 是否过期 / 最新修订摘要）；
  **未关联就明说「未建立来源关联」**——旧记录不会按文字相似度猜来源。
- **事实锁**：锁定姓名 / 机构 / 时间 / 数字 / 职责边界。AI 改写想动这些值时会被服务端拒绝，
  并**逐条列出「锁定值 → 当前值」和原因**；锁只约束 AI，你自己手动编辑不受限。
- **无法定位的旧关联**：旧记录里只存了旧路径、当前正文里找不到对应内容时，顶部会提示
  「有 N 条旧关联无法定位」，逐条列出来源与旧路径，并解释原因。这里**不会自动猜**目标：
  你可以「删除旧关联」，或先在列表里选中要关联的块、再点「重新关联」把这条来源接到选中块
  （新关联建立后那条失效旧行会被删掉）。


### 建立来源关联与采纳写回

左栏「来源核对」里可以：查看数据集内已有来源并**给选中内容建立关联**、选择关联到哪一版；没有合适来源时可在弹窗下方新建来源——填**来源类型**（事实台账 / 资料箱 / 岗位 / 个人资料 / 手工登记）、标题、可选的**来源引用**（如 `claim_record:12`，填了同一类型 + 同一引用会复用那条来源）与可选的**来源原文**（只参与指纹与修订判断，来源表不存全文）。来源更新后，「采纳」会把来源正文写回目标块——写入前先展示可编辑文本，确认才提交；版本过期、事实锁/正文锁命中、来源修订已变都会明确报错（不会静默覆盖），成功后只改目标块并记一步历史。手工来源不保存正文，界面会说明并让你粘贴要采纳的文本。

### 检查简历：内容 / 排版 / 产物三层

制作台顶部动作条的「检查简历」把三层检查收在一张清单里：

- **内容**：联系方式缺失、待补标记、日期矛盾等；
- **排版**：超页、被截断内容、字号过小、标题落单、字体缺字等；
- **产物**：实际导出的 PDF / Word 的文本是否完整、抽取顺序是否合理。

问题按「必须解决 / 需核对 / 排版建议」分级，每条给位置与修复入口；修改后再点「重新检查」即可复检。检查是**只读**的，不会改动你的简历。

### 专业视图：缩放、页导航、辅助线与照片裁剪

预览与制作台右栏画布的工具条提供：

- **缩放**：整页 / 适宽 / 100%，也可以手动放大缩小。**制作台默认按宽度适应画布**（纸宽不超出右栏；草稿与精确各自记住自己的缩放，不会互相继承）；只有你点「原始尺寸」或放大后才需要左右拖动，且横向滚动只发生在纸面层，不会被整列裁掉。
- **页导航**：上一页 / 下一页，页码可直接输入；
- **辅助线**：页边距线、列边界、基线、段落边界，只显示在编辑画布上，**不会进入导出**；
- **照片裁剪**：拖取景框决定照片显示哪一块，可锁比例、调取景大小与位置；**原图不会被覆盖**，随时可以「恢复原图」；裁剪参数随这份简历保存，HTML / PDF / Word 按同一份参数派生裁剪；移除照片时空位自动收回。**没有设置裁剪时按原图比例展示**，不会被模板强制裁成正方形或拉伸变形。
- **灰度校样**：按黑白打印效果显示纸面，只影响预览、不改你的颜色设置；旁边「打印检查」会实测对比度并提示风险；
- **命令面板**：动作条「命令」或 Cmd/Ctrl+Shift+P 打开，可搜索保存、导出、切模板、缩放等操作；
- **工作区预设**：全部面板 / 内容撰写 / 精细排版 / 投递检查，只切换面板可见性，不改变文档内容。

### 字段语言：只改纸面固定文案

在制作台左栏「版面」组里（文档模式之后），有一项 **字段语言**：中文 / English。

它改的是**纸面上固定的那些字**：

- 七个正文小节标题（Summary / Education / Experience / Campus Activities / Projects / Skills / Honors & Awards）；
- 字段前缀（Objective / GPA / Rank / Core Courses / Tech Stack）；
- 列表之间的分隔符（`,` 而不是 `、`）、技能等级的括号（半角而不是全角）。

它**不改**什么：

- **正文一个字都不翻。** 你写的个人总结、经历、项目描述原样输出——切到英文不会让中文描述变成英文，也不会重新调用模型（要把正文翻成另一语言，用下一节的「双语版本」）；
- 不影响生成阶段：AI 生成时用哪种语言写，和你在这里选的语言是两件事；
- 不是全局设置，也不是模板的一部分：**语言属于这一份简历**。同一个人可以有一份中文版和一份英文版，各记各的。

旧简历默认是中文：**不动这一项的话，导出与预览与升级前逐字不变**；切到 English 之后才会出现英文标题。切换之后：

- 整份排版设置会重新排一遍——「精确」预览会重排（英文标题比中文长或短，行数与页数都可能变），导出与预览同步；
- 五条产物一起跟随：服务端 PDF、Word、HTML、Markdown、纯文本，不会出现"PDF 是英文标题、Markdown 还是中文"；
- 这个选择随简历保存，下次从简历中心打开还是那一份语言。

**导出后标题还是中文？** 先看左栏「版面」组的「字段语言」是不是停在「中文」——它默认就是中文，新简历不会自动判断。若那里已经是 English、导出的文件里却仍有中文标题，把**简历 id 与导出格式**一并反馈，那是缺陷而不是设置问题。

### 命名版本与岗位变体（制作台顶部「版本」）

制作台顶部动作条的「版本」（弹窗标题「版本与变体」，两个页签：命名版本 / 岗位变体）会把这份简历的
**内容 + 排版 + 关联岗位**存成一份命名快照，适合「投递前留一份」「导师改完再留一份」这类需要事后对照的节点。

- **创建**：点「创建版本」，版本名称可留空（按时间自动命名为「版本 2026-11-01 21:22:57」这类），变化摘要留空时服务端按上一版自动生成行数摘要。
- **冻结**：给已定稿 / 已投递的版本加「已冻结」标记。**它只是标记**——版本内容本来就不可变，冻结不改变导出行为。
- **比较**：点某个版本的「比较」默认与**上一版**比，逐字段列出「旧值 → 新值」（新增 / 修改 / 删除三态），不再展示原始 JSON；弹窗内容限高、标题与页签吸顶，滚到底也能看到页签。
- **恢复**：点「恢复这个版本」并就地确认。恢复会**生成一个新的当前版本**（revision 前进），历史版本、已投递记录与交付存档都不会被改写；
  如果这份简历刚在别的窗口被保存过，会提示版本冲突，先「刷新版本列表」再重试，不会默默覆盖别人的修改。

**岗位变体**是同一份简历的「岗位定制副本」：派生后内容与排版独立编辑，改变体不会动当前简历。
换岗位时用「选择性同步」：勾选要同步的变体和要带过去的内容路径，只有这些路径会被写入，其它岗位定制（措辞、删除的条目等）保持原样。

**创建入口只有一个**：「岗位变体」页签顶部用 Segmented 二选一——「从当前简历派生」或「从职业场景派生」，点「创建变体」；名称可留空（按时间自动命名）。场景模式选一个已保存场景或快捷场景——这会先创建一条**独立变体**（源简历零写入），并记录本次场景。
随后对这条变体点「生成场景候选」：服务端用受控修订服务按场景表达偏好改写候选，**只返回候选、不落库**；
页面会列出候选差异。你点「采纳到这条变体」后才写入这条变体，源简历仍然不变。如果这条变体在别的窗口
被改过、或场景在候选生成后被改名/改配置，采纳会明确提示冲突并拒绝覆盖，需要刷新后重新生成。

**和「交付存档」的区别**：命名版本是**可继续编辑的草稿快照**；交付存档记录的是「当时导出 / 投递了什么」，用于事后核对，不能拿来继续编辑。

### 变体独立排版与按变体导出

岗位变体可以有自己的排版：在变体里打开「独立排版」，页数、字号等覆盖只作用于该变体（显示「继承 / 独立」，可一键恢复继承）。导出或导出前核对时选择某个变体，会按该变体的内容与排版取快照，不会改动当前简历，也不推进当前版本。

### 双语版本与术语表：把正文翻成另一语言

先分清两个「语言」：

- 左栏「版面」组里的**「字段语言」**只决定纸面上的固定文案（小节标题、字段名）用中文还是英文，**不翻译正文**（要翻译正文用双语版）；
- **「双语版本」**（制作台左栏页签）才是把正文按字段翻译成另一语言的独立版本。

用法：

1. 打开制作台左栏的「双语版本」，选一个语言变体（每个变体是独立记录，有自己的模板、页数、字号，互不影响）；
2. 左右对照原文与译文；点「生成翻译」按字段给出候选译文——**候选只预览、不写库**，关掉就丢，需要时重新生成；
   照片这类非文本字段（以及 storage 里的图片 data URL）不会出现在字段对照里，避免把 base64 当正文显示；
3. 逐项勾选要采纳的字段，点「采纳选中」：只写进**这个语言变体**，不改你当前的中文简历，也不改其它岗位变体；
4. 人名、公司名、技能这类固定译法先记进**术语表**：术语是数据集级、所有简历共享；锁定的术语在翻译结果里必须逐字出现；
5. 术语删错了去回收站恢复（术语表在回收站里）；事实锁（姓名、机构、时间、数字、职责边界等）保护的字段保持原文，
   并在候选里明确标出「这条含事实锁内容，不能由翻译覆盖」，不会静默丢掉。

生成候选会把整份简历的可译段分批送给模型（不是一段一次），通常几十秒内返回；等待期间按钮显示
「正在生成翻译候选」，请求的等待上限已放宽，不会在 15 秒时误报超时，**不要重复点击**（重新点会重新
生成一遍）。

限制：目标语言目前只有中文 / 英文；采纳单次最多 200 条路径、单条文本最多 20000 字，任一项失败整批不落库；候选不落库，关闭或刷新后需要重新生成。

**本批的边界**：采纳只写你选中的**语言变体**，不会替换当前主稿、也不推进简历 revision；「在工作台查看这份译文」按钮本批是只读预览入口的占位（点了不会切换主稿），挑译文请看对照里的预览或导出该变体。

### 简历写作增强（选中文字 → 右键）

编辑简历时，**选中一段文字 → 右键 →「写作增强」**，弹窗里就能做四种**写作增强**
（一段文本进、一段文本出；没有选中文字时菜单里没有这一项，它需要先知道你在改哪份简历）：

- **STAR 量化改写**：把"负责后端开发"改写成"情境 → 任务 → 行动 → 结果"并尽量量化。可以**挂一条
  事实台账主张**作为「事实边界」——改写不会越过你的个人边界（例如不会把"参与"改成"主导"）。
- **话术生成器**：同一段事实一次生成**简历版 / STAR 版 / 面试口述版**三种表达。
- **多风格润色**：大厂严谨 / 简洁技术 / 应届校园。
- **中英互译**：忠实原意，数字 / 日期 / 术语不篡改。

这些变换依赖已配置的模型，**没有配置时会明确提示、不做本地降级**（不伪造结果）。结果是**回填**：
写回你刚才选中的那一段，不满意直接关掉、原文一字不动。右键落在不可编辑的位置（没有可写目标）时，
动作会变成「复制」——那种情况下"回填到哪里"没有答案。另有**版本差异对比**：任选两份简历看三态
差异（新增 / 删除 / 不变），**纯本地计算、不调用模型**。

### 全局 AI 润色：选中一段文字就能改

上面四种写作增强都绑在简历的某个字段上。要改的位置不在简历里（岗位备注、投递用语、助手输入框、
网申的自填内容……），或者只想动其中**一句话**时，用**全局 AI 润色**：

1. 在任意输入框（含多行文本框）里**选中一段文字**，然后**右键**——指针旁会出现菜单：剪切、复制、
   粘贴、全选；可编辑区域里还会多出 **「写作增强」**（打开简历详情时才有）与 **「AI 润色」**。
   只选中文字不会自动弹按钮；没选中文字时右键仍是浏览器原生菜单。
2. 点「AI 润色」，卡片里显示你选中的原文，并写一句要求（可以留空）：例如"更简洁""突出成果""改成 STAR 结构"。
3. 点「开始改写」，结果在卡片里可直接微调。满意了点「替换选中」写回原来的位置，不满意点「取消」
   或「重新改写」。

约束与边界：

- **只发送你选中的这一段文字**（最多 4000 字），不发送整份简历，也不带字段上下文；模型不知道它来自
  哪份简历。
- 改写**不新增事实**：数字、日期、公司、学校、专有名词不会被编进去或改掉，只调整语气、长度与结构。
- 密码框、只读字段、下拉搜索框里不会出现「AI 润色」项；普通段落的右键菜单只有剪切 / 复制 /
  粘贴 / 全选，不会出现 AI。页面也可以给某个区域加 `data-ai-polish-ignore` 声明"这里不要弹菜单"。
- 没配置模型时，卡片会直接给出「去设置配置模型」的入口，并且**不会发出任何请求**。
- 字段有字数上限时，放不下的改写会明确提示"请缩短后再替换"，不会静默截断。

### 质量与合规检查

保存前可以跑一遍**质量与合规检查**，把"这份简历投出去会不会踩坑"拆成几类：

- **查重 / 敏感词**：本机确定性规则，不调用模型；
- **夸大风险 / 面试深挖风险点**：联动事实台账——能说多强由「承担程度 / 个人边界」约束，越界的
  表述会被点出（例如"负责"写成了"主导"）；
- **合规校验**：保密 / NDA / 违规表述等红线；
- **ATS 本地检测**：只做格式 / 关键词覆盖 / 信息位置三类**静态规则检查**，带明确免责——它不是
  招聘系统的真实解析结果，仅供参考。除总分外它还会给出**三个分项分**（格式 / 关键词 / 位置）与
  **关键词覆盖率**，命中词按出现次数排序显示（`词 ×N`），每条问题都带一句具体改进建议；简历**关联了
  岗位**时，打开检测会把该岗位的描述与要求**自动填进 JD 输入框**（只填不跑检测，可以改写或清空；
  清空后不会又给你填回来），读不到就给一行提示并可点 **重新载入关联岗位 JD**；也能 **复制改进清单**
  把标题与建议整段拷走。

**它不会自己开跑**：打开质量检测先看到的是一张说明卡——要查哪五类、AI 增强会发什么、预计多久
（本地规则通常 1–3 秒，开启 AI 增强一般十几秒、最长 45 秒后自动降级）。点 **开始扫描** 才发请求，
这也是"只是打开预览看一眼"不再白白等一次模型的原因。

扫描中面板会显示已用时和「可以关闭此窗口，扫描会继续」：点 **取消** 可以停掉，直接关掉面板也不会
中断——扫描在后台继续，会有一条带「取消」按钮的常驻通知；完成时提示「共 N 条风险点」，
失败也会明确通知你。关掉面板再打开会直接显示上次结果（不重新请求）；如果这期间简历内容改过，
面板会提示「简历内容已修改，建议重新扫描」。

说明卡上有一个 **AI 增强**开关（只有在你配置了模型时才出现），它管的是"要不要让模型也复核一遍"：

- **开启**（默认）：会把你已配置的模型拿来复核——只发送**遮罩后的正文**（姓名 / 电话 / 邮箱 /
  公司 / 学校 / 项目名会被替换成 `***`，正文里的邮箱、链接、内嵌图片也会被抹掉），事实台账**只发
  条数、类别、承担程度这类结构信息，不发送条目原文**（客户名 / 对接人 / 内部编号这类内容不会出站）；
- **关闭**：只跑上面这些本地规则，**完全不联网**；开关状态会记住，下次打开还是你选的那样；
- 模型没配好、调用超过 45 秒或返回畸形内容时，会自动降级为"只用本地规则"并在面板上说明原因
  （超时会明确写"AI 增强超时"），不会让你一直对着转圈。

### 对象批注：离线分享包里的逐条意见

生成**可评论**的「离线分享包」后，分享包详情里会多出「对象批注」区：

- **查看**：每条批注显示状态（待解决 / 已解决 / 已失联 / 已忽略）、批注人、时间、正文与被批注的原文；
- **处理**：「标记已解决」「忽略这条」；已解决的可以「重新打开」；
- **失联**：如果被批注的对象后来被删除或改过，批注会标成「已失联」，**不会**自动挂到同位置的另一条内容上；
  必须点「重新关联」并从当前文档里显式选一个对象，或直接忽略；
- **导入回传**：点「导入回传批注」选择收件人交回的 `annotations.json`；前端先校验格式并指出「第几条、哪个字段」，
  通过后交给服务端做完整校验；重复导入按批注编号去重，不会覆盖已解决状态；
- **导出评审包**：下载 zip（HTML/PDF + `annotations.json` 模板 + 说明），发给别人逐条批注。

隐私上：批注只存在本机数据库与分享包目录，**不会进入**投递用的 HTML / PDF / Word / Markdown / 纯文本 / 交付 JSON，
也不会自动外发。分享包是生成那一刻的只读快照，源简历之后再改不影响已发出的包。

### 导出：格式、水印与脱敏

导出只有一个入口：页面底部的「导出」按钮（在「离线分享」同一行的最后一格）打开统一面板。
面板里只剩三块：**格式**（含「包含照片」）、**水印**、**脱敏**——页数、字号、行距、页边距这些**排版参数**
不在面板里改，它们统一由预览工具栏决定，导出直接跟随你眼前的预览。

制作台的导出弹窗顶部有一个**「导出形式」**：

- **交付包**（默认）：把勾选的格式一起打包成一个压缩包，可以再勾「归档原件」；
- **单独文件**：多选格式后逐个串行导出，进度会显示「正在导出 2/3：Word」；某个格式失败时会停下，
  并说明「已完成 1/3，Word 失败：原因」，不会静默跳过。
  选「单独文件」时「归档原件」不可用——归档只属于交付包。

四种带版面的格式（HTML / PDF / Word / Markdown）都由**服务端同一份排版结果**渲染：哪些字段、放在标题行
还是正文后灰字、正文的先后顺序，四种格式**同一套字段、同一顺序**——不会出现"预览里有 GitHub、导出的
Word 里没有"。它们的差别只在本格式不擅长的地方（分页取整、字体、链接呈现等）。

- **PDF**：勾选 PDF 后导出的就是后端直出文件，由后端用系统中文字体排版生成，不经过浏览器打印窗口。
  前提是系统里能找到中文字体（Windows/macOS/Linux 的常见字体都在查找范围内）；找不到时面板里会提示
  改用「浏览器打印」。它**遵循你眼前的预览**：页数、字号（含无级滑块那一位小数）、行距、页边距与
  区块间距都按当前预览的取值渲染——**不需要先在预览里点「保存」**，预览里调过、没保存也能导出一致的文件。
  内容超出所选页数时**不会自动缩小字号**：按页数上限截断并如实提示（要全看请加页数或收紧排版参数）；
- **浏览器打印**：面板里选「浏览器打印」，排版设置与预览一致，适合需要自己调整打印边距时；打印 / 另存为 PDF 的分页以浏览器为准，可能与屏幕近似分页略有不同；
- **HTML**：包含本地简历照片，可在浏览器中打印或另存为 A4 PDF；字段位置与预览一致；
- **Word（docx）**：保留排版设置的 Word 文档，可继续编辑；按与预览同一份字段位置排版——条目头
  「标题左、元信息右」用右制表位，正文前后的灰字段按列排成无框表格，正文要点 / 段落按同一份结果输出。
  Word 里的**照片是「浮于文字上方」**的浮动图片
  （不是嵌入型）：嵌入型会让照片独占一行、把姓名整体下推，页头比预览高一截、分页也跟着错位；
  浮动之后照片贴在版心边缘、不占行高，页头高度与预览一致。照片在左的模板（如「优雅」）也会贴着左边。
  **底色块也跟着走**：现代模板的浅绿页头与绿色标题带、技术模板的实心标题块、经典模板的标题左竖条，
  在 Word 里都会以「段落底纹 + 边框」的形式出现（Word 没有 CSS 的 `background`，这是唯一能表达色块的手段）。
  一处差别如实说明：**Word 的色块画不出圆角**——预览里标题带的圆角在 Word 里是直角色带，其余配色、
  位置与预览一致。**页眉联系方式**（手机 / 邮箱 / 城市 / 出生年 / GitHub 主页 / 个人主页）与预览
  同字段、同顺序、同文案，不会再出现"预览里有 GitHub、导出的 Word 里没有"；强制换行设置也一并生效。

导出默认只进浏览器的下载目录。想要一份落到固定位置的存档，到 **设置 → 「数据」页签 → 「保存位置」**
指定一个文件夹：由后端本机原生选择器选定并校验后，从本机前端导出简历会**同时在该文件夹落盘一份**（目录不存在或不可写会在保存设置
时就提示，不会等到导出才发现）。路径由本机选择器直接交给后端持久化，不接受客户端手工提交路径；远程/跨站导出请求会被拒绝。

导出时还有三个可选动作：

- **自定义水印**：HTML 用半透明覆盖层、PDF 用叠加、Word 写进页眉；纯文本与 JSON 没有版面概念，
  请求加水印会得到明确报错。
- **一键隐私脱敏**：把姓名 / 电话 / 邮箱 / 公司 / 学校等敏感字段替换成占位符后导出，分享前
  不必手工逐处改。
- **离线分享包**：把一份简历打包成脱敏 HTML/PDF + 只读快照 + 评论回传文件 + 本地 token，可选
  「只读」或「可评论」。发出去的是**脱敏后的内容**、不含真实敏感信息；收件人回传的评论可以导回。
  生成成功后可以直接**打开它所在的文件夹**，并附有"把哪个文件发给别人、别人怎么用"的使用说明。
  - 分享包的**内容**存在数据库里（跟着数据集与备份一起走），渲染出来的 HTML/PDF/JSON 落在
    `data/share_packages/<id>/`。所以换数据集、或从备份恢复到另一台机器之后，**点「下载」会按
    库里的快照自动重新渲染出来**，不需要你重新生成一次；「打开目录」也会先补齐，不会给你一个
    空文件夹。重新渲染的内容与原来逐字一致，**脱敏程度也与你当初的选择一致**（当初没勾脱敏的
    字段不会在这里被自作主张地抹掉）。
  - 唯一的例外是 `comments.md`：那是收件人写进来、回传给你的内容，数据库里没有第二份。它丢了
    就是丢了，应用**不会**拿一个空白模板冒充它——下载它会如实报「文件不存在」。

四种带版面格式（HTML / PDF / Word / Markdown）的**字段与顺序完全一致**，因为它们消费的是服务端同一份
排版结果；差异只在版式层（例如分页、字体、链接呈现）。与草稿预览、精确预览的页数与关键视觉要素也保持
同一套口径：行距、页边距、区块间距来自所选**模板**的默认值，你在「版式」里设过的值会覆盖它；内容放不下时
**不会自动缩小字号**——PDF 按页数上限截断并标记溢出，Word 只标记溢出、内容不丢，草稿与 HTML 如实提示需要
更多页，任何格式都不会替你缩小字号。技能标签那类**带底色的小框**在打印时也会保留（浏览器
默认不打印背景图形，应用已显式要求保留），直出 PDF 里同样会画成带底色的圆角标签。

因此，同一份简历的「直出 PDF」观感可能与**早先版本导出**的不一样（行距更贴合预览，页数也可能变化）
——这是把 PDF 对齐到与预览同一套口径的正常结果，不是内容被改动。

Markdown 是文本流：灰字段逐行「标签：值」，正文要点用「- 」；纯文本由它去掉标记；JSON 直接输出新版
文档结构（含每条内容的纸面位置与版式），适合结构化备份或后续处理。三者除照片外**字段是完整的**
（照片放进纯文本 / 结构导出没有意义）——姓名、性别、出生年、联系方式、个人总结、教育、经历、项目、
校园活动、技能、奖项一个都不少。

### 简历中心的多选与批量导出

简历中心支持**多选**：在任意一条简历上右键选「批量选择」进入多选，或用行首的勾选框。进入后工具条会出现
**全选全部简历（共 N 个）**、**批量操作** 与 **退出选择**；**批量操作** 下拉里是 **批量删除** 与
**批量导出** 两项，多选状态下**整行右键**也是这两项（不再混入单行的编辑/删除）。

**批量导出** 会按「设置 → 外观与交互 → 批量操作 → 批量导出简历」这张卡里的参数（版式、字号、页数、
语言、导出格式）把选中的简历打成一个 zip，一次最多 50 份。生成与导出是**两套独立参数**，改一张不会
影响另一张。设置卡没有保存按钮：改动后自动保存；第一次打开卡片时会用默认值启用一次——没启用时点
批量导出（或岗位广场的批量 AI 生成简历）会先弹「去设置」，服务端也会拒绝未配置的请求。某一份简历
正文里还留着 `【待补：…】` 之类的未完成标记时，这一份会被跳过，其余照常导出，完成提示里会写明
跳过了几份、为什么。

### 收起左侧导航

左侧导航在宽屏下比原来略宽（216px），品牌区右上角新增 **收起侧栏** 按钮：收起后只剩图标，
点击后出现的 **展开侧栏** 按钮在页头左侧。窄屏（≤1092）本来就会自动折叠成图标栏，不再显示手动切换；
你的选择会记在本机，下次打开保持。

## 5. 收藏、岗位解读与求职助手

岗位和简历都可以点击星形按钮收藏，“收藏夹”会分页集中显示两类内容。取消收藏只改变收藏
状态，不会删除原岗位或简历。鼠标悬停在收藏的岗位标题上可以看到它的导入时间。

“岗位需求解读”只把当前招聘原文发送给设置中的模型，用于生成需求总结、原文证据和通用准备
建议；它不读取个人资料，也不会修改岗位。它先说明再生成：打开弹窗先看到「这一步在做什么、
大概多久」，点「开始生成」才真的调用模型；生成中显示「已生成 N 秒」。

生成过程中有两条不同的出路，别混：

- **取消**：真的中断这次生成，服务端在约 0.4 秒内检测到断连就停下，**结果不会保存**（这次
  的 token 不白烧），弹窗回到「开始生成」的初始态，可以再点一次。
- **后台继续**：关闭弹窗但连接不断，任务在后台跑完并写入缓存，完成后弹通知并响一声（任务面板
  里也能取消）。直接点弹窗的 ✕ 或按 Esc 等同于「后台继续」，不会丢结果。

正在跑的解读会以 chip 形式常驻在页头下方的任务条里（「岗位解读 · 公司 · 岗位」+ 已运行时长 +
查看 / 取消），换到别的页面也还在；点「查看」跳到该岗位并自动打开解读弹窗。生成结果按岗位缓存，
下次打开弹窗直接显示，不会重复调用模型；「重新生成」才会覆盖当前这份并重新计费。


求职助手支持多轮历史、Markdown、表格、可点击链接、文本/图片/文档附件以及可选的联网搜索摘要。
附件可以直接从剪贴板**粘贴截图**（Ctrl+V），也可以点「附件」按钮选文件；贴着图的那条消息发出后，
紧接的下一句追问里这张图会再带上一次，所以"这个岗位匹配吗 → 那我简历该怎么改"能接得上，
再往后的追问就不再重复发送了（省用量）。
每条消息都带发送时间，输入框右侧可以调「思考强度」（对支持思考模式的模型生效，不支持的会被忽略）。
开启思考后，回复下方会出现默认折叠的「思考过程」面板，点开即可查看模型的推理过程，历史消息里也能回看。
内容由你所用的**模型服务商**提供，本应用只做展示。生成过程中实时看到的是完整内容，回答结束后保存与回看的
版本会按存储上限（20000 字符）截断，超过时注明「只保留了前一部分」，所以极长的思考在结束后可能看起来比
实时短了一些。
首次进入且没有任何会话时，会自动创建一条带引导内容的默认对话，说明这个助手能做什么、怎么用。

### 投投悬浮球：随时问助手

在其它页面遇到简历、岗位、投递或面试问题时，不必先回侧栏找入口，点击「投投」即可打开独立对话卡片。
它会先打招呼说明自己能做什么，并根据正在进行的助手请求显示思考、完成或出错状态；请求失败时会保留错误表情，
直到你再次打开或发起下一次请求。悬浮球可以用鼠标拖到上 / 下 / 左 / 右边框，也支持键盘聚焦、Enter 和 Space。

**双击悬浮球打开「投投剪贴板」**（单击仍是打开助手，因此单击会有约 0.3 秒的短暂等待）：把自我介绍、
项目描述、联系方式这类要反复粘贴的资料存成片段（最多 50 条），每条一键复制到系统剪贴板，支持新增 /
编辑 / 删除。片段只保存在本机浏览器的 localStorage 里，不上传；清理浏览器数据或换浏览器会丢失。

对话框和整页助手是同一套能力，同样可以**直接粘贴截图**（Ctrl+V）或点「附件」选文件；历史记录按钮在卡片
标题栏，打开后点空白处或按 Esc 即可收起。卡片可以按住顶部的窄条把手拖到屏幕任意位置（不会拖出视口）；
再次从悬浮球打开时，卡片会重新出现在悬浮球旁边（按球的当前位置与贴边方向计算）；空闲久一点它会眨眨眼，
长时间没人理就缩到屏幕边缘打瞌睡（飘着 Zzz），动一下鼠标或点它就会醒过来；用鼠标连续快速划过它，
它会露出被抚摸般满足的表情。

悬浮球的主动提示只提供短小的通用建议，不会读取或展示姓名、电话、邮箱等个人资料；想减少打扰时，去
**设置 → 应用 → 投投悬浮球** 关闭「提示标语」即可——关掉之后，除了不再弹提示语，也不会再在
「我的资料」页提示你去改资料，悬浮球的其余功能不受影响。

停在「我的资料」页时，球旁会升起一张「去改资料」小卡片（点它等同于点页头的 **编辑资料**）。卡片上的
**×** 关掉后，本次停在这一页期间它不再出现；离开这个页面再回来会重新提醒一次。

投投助手会优先查阅简历通本地产品文档回答“功能在哪里、怎么用、有什么限制”等问题；文档没有覆盖时会明确说明，
不会用旧记忆或无关联网结果冒充答案。敏感设置、API Key、照片、网申专用资料与网申填充真实值仍不会提供给助手。

历史会话的「⋮」菜单（也可以直接右键那条会话）提供：置顶、收藏、复制分享链接、重命名、
在新对话中继续、移动到分组、复制会话 ID、归档与删除。几点说明：

- **复制分享链接**得到的是本机应用内的深链（`/assistant?conversation=<会话 id>`），在这台电脑上
  打开就能回到那段对话，不是可发给别人的公网链接；
- **在新对话中继续**会把最近 10 条消息复制到一段新会话（附件只保留文件名提示），用来"从这里分叉"；
- **移动到分组**只是给会话归类，侧栏按分组展示，不影响对话内容；
- **归档**会把会话收进「已归档」筛选，并自动取消置顶；

每条消息**整块右键**（或点行尾的「更多」）可以：**引用这条继续问**、复制内容、删除这条消息。
删除单条后，引用过它的提问仍然保留引用内容——引用存的是当时的快照，不会因为原消息没了而变成空白。
回答下方的参考来源、附件和助手做过的操作也都在消息块里。

要一次删掉几条，右键任意一条消息选 **批量选择**：每条消息左侧出现勾选框，勾好之后在消息列表上方的
一行工具条上点 **删除所选**，确认后一次删完（一次最多 200 条，走的是批量接口，中途失败不会删一半）。
多选期间不弹右键菜单（引用、复制此时用不上）；点「退出多选」或换一条会话即恢复原样。

助手默认读取当前数据集里的**脱敏个人资料**，不再需要勾选「使用我的资料」；岗位和简历仍可在发送前主动选择关联。
这些上下文与受限的已完成历史保存在本地 SQLite，并随数据库备份一起保留。个人资料上下文会移除姓名、电话、邮箱和照片，
关联简历只移除照片，因此简历正文中的姓名和联系方式仍可能发送给模型。

助手还能**直接操作项目里的数据**：它会在你需要时查询岗位、简历、资料箱、个人资料、内推、提醒、
面经、题库历史、复盘历史、知识库、求职进度、求职统计与分享包，也能按你的要求新增或修改岗位、备选岗位、
资料箱条目、技能（含知识文件）、**简历版式**、个人资料的基础字段（姓名、电话、城市、
求职意向、个人总结等）、**知识库条目**和**求职进度记录**，还可以**新增一条日历提醒**、调整某份简历的模板、页数与字号。
它**不能**改模板（完整 HTML）——那类改动请到「工作台」里自己编辑。回答之前它会先拿到
**本地的日期、时间与星期**——深夜提问时它会提醒你早点休息。工具集还包括：**投递失败诊断**
（汇总投递记录里的失败原因，帮你找「为什么投不进去」）、**查询版式**（列出内置与自制的版式参数）、
**新增面经与内推记录**、把**提醒标记为已完成**、给简历**收藏与备注**——口头交代一句就能让它代办。几点需要知道：

- **实事求是：不知道就说不知道，绝不编造。** 涉及你数据的结论（"我有几个岗位 / 提醒 / 内推 / 面经 /
  知识"）它会先调用工具查证再回答，不会凭印象或凭猜；工具没查到的不会脑补。
- **只在你明确要求时才写入。** 只是让它分析、评价或给建议时，它不会顺手改动数据。
- **它没有任何删除能力。** 需要删除岗位或简历时，请到对应页面操作。
- **求职进度可以查、新增和修改。** 修改前要先确认记录 id；要删除记录时，请到「求职进度」页或「回收站」操作。
- **结构化条目（教育经历 / 工作经历 / 校园经历 / 项目 / 技能 / 奖项）它只能「追加一条」**，最典型的场景是把资料箱里的材料整理进个人资料（"把那条实习材料整理进我的经历"）。改动或删掉**已有**条目仍要到「我的资料」页面操作。追加成功后建议去页面核对一遍。
- 每次操作都会记在回复里的「助手做了什么（N）」中：**默认折叠**，但折叠标题上直接写明「改动了 N 项」或「N 项失败」，
  所以不必展开也能一眼看出它有没有动你的数据；展开后能看到每条明细，点「前往查看」可以跳到对应页面核对。
  历史对话里同样能看到助手当时做了什么。
- 如果你的模型服务商不支持工具调用，助手会自动退化成普通对话，功能不受影响。

### 技能：让助手按你的要求作答

技能是给助手加的一套自定义要求，用来固定你反复交代的偏好。它有两种形态：

- **只有提示词**：一个 `.md` 文件，正文就是要求，例如"帮我改简历时先用 STAR 结构拆解，再逐条指出问题"。
- **提示词 + 知识包**：一个 `.zip`，里面放一份提示词和多份资料，例如面试题库、写作模板、目标岗位的行业术语表。

想自己写一个技能时，到 **工作台**（左侧导航）：点「新建技能」填名称、适用场景、提示词，
需要参考资料再加知识文件；页面上有「技能是什么 / 工作台怎么用」的说明和三个可直接改用的模板
（简历要点精炼、面试问题预测、岗位匹配分析）。已有的技能点名称就能看到提示词全文并就地修改——
从设置页的技能列表点进去只能看（那一页不提供改动，新建 / 导入 / 启用停用 / 删除都在工作台）。
也可以直接让求职助手帮你建：说「把这个规范记进技能里」，
它会调用 create_skill / update_skill，把提示词与知识文件一并写入（知识文件有单文件、总量与数量上限）。

在 **工作台 → 技能 → 导入技能** 里也可以直接导入文件。`.md` 的正文就是提示词，文件名（或开头的
`---` frontmatter）作为技能名称；`.zip` 需要**有且只有一份**提示词文件——优先用 `SKILL.md`，
其余 `.md` / `.txt` 都当作知识文件：

```
面试模拟官.zip
├── SKILL.md          # 开头写上 name 与 description，正文是提示词
├── 常见题型.md
└── STAR 模板.txt
```

导入后的技能默认启用，可以随时在列表里关掉。需要知道的几点：

- **同名导入会覆盖更新**，提示词和知识文件整体替换，启用状态保留，方便反复调整同一份技能。
- **知识文件不会一次性塞进对话。** 助手只在需要时自己去读相关片段，所以一包几十页的资料不会挤占上下文。
- **技能里的提示词是"要求"，知识文件是"资料"。** 助手会照提示词作答，但知识文件里的文字与岗位描述
  同级，属于参考内容——即使资料里写着"忽略之前的指令"，也不会被当成命令执行。
- 启用过多、提示词过长的技能会超出长度预算：此时被截断或被跳过的技能会在助手的系统提示里点名说明，
  界面上不会悄悄少加载。
- 技能只影响助手，不会改变岗位、简历和资料的任何数据。
- **正在生效的技能会显示在助手页头**（点它直接回到工作台管理）；一个都没启用时，新会话的引导区
  会提示这个功能的存在，用过之后就不再出现。

图片附件会在点击发送后立即显示在当前用户消息中，聊天记录中的图片以缩略图展示，点击缩略图
可查看大图。文档附件显示为带图标的文件名（pdf/docx 各一种图标），与图片一样可以放进同一条
消息。附件预览不会改变附件发送限制，也不会把个人资料中的照片自动加入对话。

打开输入框下方的 **联网搜索** 后，助手会先用你的问题自动搜一次（作为开场资料），再拿到一个搜索
工具，能自己决定搜什么、换关键词多搜几次；命中的来源会累积收进回答下方的「参考来源（N）」里，点标题即可
在新标签页打开原网页。关掉开关时搜索工具不会被下发，助手不会联网。

如果问题是在问 **ResumeForge / 简历通自身**（例如「简历通怎么在 macOS 上使用」「简历预览按钮在哪里」），
即使打开联网搜索也会跳过公开搜索，直接依据本地使用指南、能力地图和当前应用数据回答，避免被同名产品或无关简历文章带偏。

**一轮回答最多搜 3 次**，这个数字包含开头那次自动搜索——也就是说助手自己还能再搜 2 次。用完
之后工具会明确告诉它"次数已用完"，它会基于已有结果作答并说明信息可能不完整，而不是静默失败。

搜索本身在 **设置 → 联网搜索** 里配置，和上面那个开关是两件事：开关决定"这一次要不要联网"，
设置决定"联网时怎么搜"。

- **搜索来源**：Bing 与 DuckDuckGo 开箱可用，可同时勾选，结果会并发查询后合并去重；SearXNG
  需要填自己的实例地址（公共实例经常限流，所以不预置默认值）。至少要留一个来源。
- **SearXNG 实例地址**：例如 `http://localhost:8080`，必须以 `http://` 或 `https://` 开头。
  不选 SearXNG 来源时可以留空。
- **抓取正文的条数**：默认「只取摘要」，助手只能读到搜索结果的标题、URL 和摘要。改成抓前 1~3 条
  之后，应用会打开排序最靠前的那几条结果页读取正文，助手能拿到更完整的内容（例如招聘页里的
  任职要求全文）。代价是每次搜索更慢，也可能被站点拒绝；被拒绝时那条结果就只剩摘要，不影响
  其余结果。
- **每次返回的结果条数**：1~15 条，默认 8 条。条数越多占用模型的上下文越多。

如果某次搜索什么都没搜到，界面上会说明原因，助手也不会声称自己获得了资料。用人单位官网与招聘页
会排在第三方平台之前。所有招聘信息都应在投递前回到用人单位官网核验。

## 数据、备份与隐私

### 外发预览与模型用量

设置页有两块与「发出去什么、花了多少」有关的内容：

- **外发预览**：调用模型或其它服务之前，先把这次要发的东西摆出来——目标服务、资料类别、附件类型、
  已排除字段、是否抓取正文，以及正文本身。确认后才真正发出；**预览正文只存在本次响应与内存里**，
  不写本地存储、不输出到日志，关掉就丢。
- **模型用量**：按任务 / 模型汇总调用数、token 与耗时；**未知 token 显示「未知」而不是 0**；
  没配置单价时不估算费用；只统计数字与枚举，不保存提示词或正文。


岗位、资料、照片、简历、收藏、助手历史和模型配置默认保存在
`backend/data/resume_forge.db`。可选服务端环境变量位于 `backend/.env`。两者均被 Git 忽略，
但数据库包含个人信息和 API Key，不应提交、分享或放入公开日志。

**隐私与数据主权**：数据只存本机，应用没有账号体系、没有埋点上报，AI 只在你主动调用时
把必要内容发给**你自己配置的**模型服务商。逐条承诺见「设置 → 数据 → 隐私与数据主权」卡片；
导出与彻底删除的路径也在那里。遇到问题时，「设置 → 应用 → 帮助与诊断」可以一键导出
脱敏诊断包（只有运行事件、系统信息与近期日志尾部；桌面版还会带上桌面壳自己的两份日志，
**不含简历数据与密钥**），连同问题
一起发出来能省掉大半来回。

**自动备份与更新前快照**：应用会在后台按间隔（默认每周）自动快照当前数据库到
`backend/data/auto-backups/`（保留最近 5 份，可在 `backend/.env` 调整或关闭）；更新程序在覆盖
文件之前也会先把数据快照到 `backend/data/pre-update/`（保留 3 份）。它们是兜底保险，
**不替代**你自己定期导出备份包的习惯。

要如实理解"受保护"的范围：**自动备份只是数据库快照，不含附件文件与自定义字体**（"我的文件"
磁盘副本、内推备注图片、`data/fonts/` 里的字体），更不是整机灾备。换电脑、丢硬盘时，自动快照
只能救回数据库本身；资料箱附件、内推图片与字体要靠**手动导出备份包**（导出时会连同该数据集
引用到的附件、全部自定义字体与全局模型配置一起打包，恢复时自动落回并逐文件校验）。设置页
备份状态卡上标注的"受保护"，指的就是"数据库快照这条底线是好的"。它现在有三个需要分开读的
状态：**「受保护」**= 最近成功过、没有连续失败、且当前目录里确实有一份可读的 `.db` 快照；
**「快照缺失」**= 成功记录还在，但当前找不到快照文件（被手工清理、被同步盘挪走等），需要重新
备份一次；**「无法确认」**= 快照目录读不了（权限、路径断开），此时**不能**当成"没有备份"，
先检查磁盘权限。连续失败、超过间隔未成功分别显示「保护中断」「已到期未备份」。
另外，轮转淘汰的旧快照会先移入 `auto-backups/<数据集>/.trash/`（保留最近 5 份）而不是直接删除，
刚轮转完就后悔还有补救窗口。

**新用户的一键体验**：首次启动的引导弹窗里有「载入示例数据体验」——会新建一个独立的
「体验示例」数据集（主数据不受影响，随时可在设置里整份删除），写入一个示例岗位与一份
示例简历，载入后首页就有内容可以点开了。

### 回收站：删除不等于销毁

删除**不会**立刻抹掉数据。岗位、简历记录、投递记录、事实台账条目、资料箱材料、助手会话、
内推、提醒、面经、分享包和网申填充记录被删除后都会先进入侧栏的 **回收站**，那里可以一键恢复
（在条目上**右键**选「批量选择」或用多选框勾选后，可**一次性恢复 / 彻底删除**）：

- **恢复**是安全的，点一下就回来（连同它与岗位等对象的关联关系一起，原样恢复）。
- **彻底删除**才是真正的销毁，会**再确认一次**并说明后果；只有已经在回收站里的内容才能被彻底删除，
  所以界面上不存在"点一下就没了"的路径。
- **清空回收站**会删掉里面全部内容，同样需要确认，并会告诉你要删多少条。
- 回收站里的内容**不会**出现在其它任何地方：各自的列表、首页统计、全局搜索、求职助手的工具调用，
  以及投递台自动挑选简历时都看不见它。所以删除之后不会遇到"删了但首页上还有"这种半成品状态。

有两个刻意的例外，都是为了不让你丢掉东西：

- **自动采集的去重会把回收站里的岗位视为"已存在"**。否则"删掉 → 再采集一次"会造出第二条同一岗位，
  而你以为自己只是删了一条。这时任务文案会明确说"其中 N 条在「回收站」里"——想重新收进来，
  先去回收站恢复或彻底删除它。
- **在投递台勾选导入候选岗位时**，如果同名岗位在回收站里，既不会新建第二条、也不会擅自把它恢复，
  而是提示你去回收站处理。

### 数据集：多份数据与备份

照片、助手图片附件和历史兼容字段都以文本形式存在同一个数据库里，所以**一份数据集就是一整份
本地数据**，不需要另外拷贝目录。在 **设置 → 数据集** 里管理（想就地再开一份时，用**页头的数据集
下拉**底部的「新建数据集…」：取个名字立即创建，创建完会问你是否马上切过去，选「稍后」就不切）：

- **导出当前数据集**：点「导出」会先让你确认**文件名**，默认是 `<数据集名>-<时间戳>.zip`
  （可以改成中文名，非法字符会被替换成 `-`，扩展名自动补 `.zip`）。确认后下载到浏览器的
  下载目录（具体位置由浏览器的下载设置决定）。导出的是那一刻的一致快照，之后新录入的数据
  不包含在内。
  **它只带走当前这一份数据集**——如果你列表里还有别的好几份，它们不在包里。
  默认**包含**大模型 API Key，可在导出前取消勾选（见下方「需要留意」）。包里同时会带上
  **全部自定义字体**（`data/fonts/`）与全局模型配置；字体目录为空时包格式不变，老版本仍可读。
  导出成功后如果数据目录里还有既没进包、也不属于登录态/缓存/日志这类可重建产物的顶层项，
  提示会补一句「另有 N 项（X MB）未纳入备份」，明细在包内 `manifest.json` 的 `uncovered` 段
  ——它只是把范围说清楚，不阻断导出。
- **导出全部数据集**：列表里**不止一份**时，这个按钮才会出现，同样可以先改下载名（默认
  `全部数据集-<时间戳>.zip`）。它把当前这份**加上其余每一份**装进同一个备份包，适合"换电脑 / 重装"这类要把整摊子搬走的场景。包里的每一份都会做与你
  手动导出一份时**完全相同的**处理（含按勾选决定是否剥离大模型 API Key）。
- **导入备份为新数据集**：选中一个之前导出的 zip，它会变成列表里的一份**新数据集**；如果这个
  包是"导出全部数据集"产生的，包里随行的其余几份也会各变成一份新数据集（**用全新的标识**，
  不会覆盖你本机已有的同名数据），名字沿用包里的，方便你认。导入
  **不会改动你当前正在使用的数据**，所以选错文件也没有损失。
  导出方勾选过「包含 API Key」的包，导入成功后会如实提示密钥已一并恢复。
  - **自定义字体**（格式 6 起的包）：恢复进本机字体目录，提示里会说恢复了几份、有几份因为
    本机已有同名文件而保留本机版本；`fonts/names.json` 只补缺失的显示名，`active.json` 只在
    本机还没有选择时采用。字体没能完全恢复**不会**让数据集导入失败，也不会把这份备份标成
    "不完整"——它只影响 PDF 导出的字形。
  - 整包是**要么全成、要么不动**：包里任何一份数据集有问题，整包会被拒收并说明是哪一份，
    不会只恢复一半、留几份半截的数据集在列表里。
  - **附件同样先检查、后落盘**：包里的附件（"我的文件"副本、内推备注图）会在写入前逐个核对
    存在性与校验和，并检查与你本机已有文件是否冲突。附件缺失、内容与清单不符、或与本机同名
    文件内容不同时，**整次导入会被拒绝**并说明原因——**你本机的原文件一个字都不会被改**。
    拒绝后应用会问你是否"跳过有问题的附件继续导入"：选择跳过只导入数据库内容，被跳过的附件
    会在提示里逐条列出，这份备份会被明确标注为**不完整**。
  - **导出时也会如实提示**：包里有附件缺失、或文件内容与数据库登记的校验和不符时，导出的
    提示会说"这份备份不完整"，不会让你以为拿到了一份完整备份。
- **新建空白数据集**：不导备份、从零建一份**空白数据集**，用于给另一个求职方向单独开一套记录。
- **切换**：把整个应用切到某份数据集，岗位、个人资料、简历、收藏和助手会话都会变成那份数据
  里的内容。切换后页面会自动刷新。
- **重命名 / 删除**：名称只用于在列表里区分。删除会把文件移到 `data/datasets/.trash/`，
  需要时可以手动找回；正在使用的那份不能删除。

### 投递存档（交付记录）

每次投递、手工关联进度、或导出时显式留档，都会冻结一份**交付快照**（当时的简历正文 + 排版设置 +
导出参数）。在简历详情的「投递记录」里，每条记录旁都有 **下载存档**：

- 有导出产物的记录（投递台 / 导出留档）：按存档里的内容与实际参数**重新生成**一份同样的文件；
  重新生成每次可能略有差异（例如 HTML 里的随机串），界面会说明这一点，并给出**原始文件的
  校验和**，你可以自己比对；
- 只有内容快照的记录（手工关联）：下载当时冻结的**简历内容 JSON**；
- 原简历删掉之后，这些存档仍然可以打开下载（证据不依赖简历存活）；旧版本留下的、没有参数
  快照的记录会明确提示"不可还原"，不会假装能重放出同一份文件。

每条记录上还会显示 8 位的内容指纹（`content_sha256`）——同一次投递的证据就是这个指纹。

如果原简历已经进入回收站或被彻底删除，仍可在**简历中心 → 交付存档**按标题、公司、岗位和来源分页查找历史记录；
这个入口不要求你记住 `delivery_id`。存档下载会按冻结内容和参数重新生成文件，不能承诺与当初下载的文件字节完全一致。
源简历的 purge 不会自动删除不可变交付快照、附件副本或备份文件，清除这些副本需要按运维手册分别处理。

### 手动备份与存储占用

- **手动备份**（设置 → 数据 → 「手动备份」）：数据库升级、手工备份会留在
  `backend/data/backups/` 目录，这份清单把每份快照的文件名、体积和快照时间列出来。
  不需要时可以**逐份确认后移除**——它只会被移到 `backups/.trash/`，随时能在文件管理器里
  找回来；没有自动清理，也不提供"全部删除"。
- **存储占用**（设置 → 数据 → 「存储占用」）：数据目录各分项（数据库、备份、附件副本、
  浏览器用户目录等）的磁盘占用与文件数，只统计体积、不读取文件内容。占用大的目录
  （如投递浏览器的用户目录）属于正常现象，这里不提供任何清理动作。
- **「清理旧文件」的范围**：只覆盖 `backups/`、`backups/.trash/`、`auto-backups/` 与
  `runtime/logs`、`logs`，其中 `backups/` 里**按修改时间最近的 3 份永远不进清单**（避免把
  你明天可能还要用的最新备份移走）。`share_packages/`、`exports/`、`captures/`、
  `browser-profile/`、`restore/`、`pre-update/` **不在扫描范围**，这些目录需要时请自行在
  文件管理器里清理。清理从不硬删：文件被移到 `.cleanup-trash/<时间戳>/` 并按原相对路径归档，
  该目录目前不会自动过期，确认无误后可自行删除。

需要留意：

- **分享包在换数据集或恢复备份后会自动重新生成那几份文件。** 分享包的**正文快照存在数据库里**
  （随备份一起走），而渲染好的 HTML/PDF/JSON 落在 `data/share_packages/<id>/`（不随备份走）。
  换数据集或恢复之后点「下载」，应用会按库里的快照把它们重新渲染出来，不需要你重新生成一次。
  重新渲染使用数据库里的快照和实际参数；**排版设置**优先沿用原简历的那一套，原简历已被删除时退回默认排版设置，
  生成的文件字节不保证与之前完全一致。
  唯一例外是 `comments.md`：那是收件人写进来、回传给你的内容，数据库里没有第二份，丢了就是
  丢了，应用**不会**拿一个空白模板冒充它——下载它会如实报「文件不存在」。

- **备份默认包含全局模型配置与 API Key。** 设置 → 数据里只有一个开关
  「**备份中包含全局模型配置与 API Key（所有已保存记录）**」，默认勾选：包里会多一段
  `global_llm.json`（记录名、端点、模型与非密钥参数，以及「使用中」是哪条），API Key 也一并按
  **本机存储的形态**写入（Windows 上是系统加密形态、绑定当前用户与这台电脑，换电脑恢复时解不开就按
  未配置处理；macOS/Linux 上密钥以明文随包）；包格式随之升到 **格式 5**，用旧版本导入会明确提示
  先升级，不会静默丢配置。取消勾选则配置与密钥都不带，包内没有该段、格式号与旧版一致。
- **导入时按「只补不覆盖」合并**：没有同名记录就新增；同名但本地是空壳（地址和模型都没填）就用包里
  的补全；同名且本地已有内容则保留本地，并在提示里报「跳过 M 条同名」；只有本地没有可用配置时才采纳
  包里的「使用中」。无论是否带密钥，切到一份从备份导入的数据集后，都建议到 **大模型配置** 检查
  API Key 并测试连接；其余配置、岗位、简历和会话都在数据里。恢复后可以在**页头数据集下拉的左侧**
  直接切换使用中的记录，不必进设置页。
- 每份数据集都是一个完整的数据库副本，会占用与数据库同等大小的磁盘空间；列表里会显示大小。
- 有正在进行的 AI 请求（例如简历生成中）时切换会失败并提示稍后重试——这是为了避免那次请求的
  结果被写进刚切过去的数据集里。
- `backend/data/backups/` 里还留着数据库迁移前的自动备份，**该目录不会自动清理**，确认不再需要
  回滚后可以手动删除较早的文件。

### 简历与版式（工作台）

简历的外观由两件独立的事决定，在 **工作台 → 版式** 里管理：

- **模板**决定长什么样（配色、字体、标题样式）。内置 6 种：经典 / 现代 / 精简 / 优雅 / 极简 / 学术。
  已经用过「技术 / 社论 / 分栏」的旧简历仍按原模板渲染，外观不变，只是新建时不再提供这三套。
- **版式**决定排得多密（行高、页边距、区块间距、强调色、字号系数）。内置标准 / 紧凑 / 舒展 /
  单色强调四个预设，也可以自制。

两者可以自由组合，"优雅模板 + 紧凑版式"是完全正常的用法。生成简历前和预览时都能随时切换；
切换只**重新渲染**，不会重新调用模型，所以内容不会变、也不额外花钱。

**选模板即见效果**：生成弹窗与预览工具栏里的「模板」按钮会打开模板一览，每个模板都用**内置示例内容**
真实渲染一页缩略图——预览只回答"这个模板长什么样"，不读你的简历（既不会为一份大简历反复排版，也不会
让你分不清"这是模板的效果还是我内容的效果"）；要看自己的内容，制作台右栏会实时预览当前正文——**包括还没保存的改动**。缩略图会带上
你当前的版式与字号系数，点「用这个模板」直接选用（选中即应用，不需要另外确认）——选择模板与查看效果是
同一步，不必先盲选名字、再单独点开看效果。

**在这个界面里切字号档位，改的是当前这份简历**：选完立刻重排（制作台右栏同步变化），保存后跟这份简历
走。作用范围只有**当前这份**与之后新建的简历——已保存的其它简历各自的字号不会被追溯修改。

**自制版式**：在「版式」区点 **自制版式**，只填参数（留空表示沿用模板自身的设置），
不用写代码。想"压进一页"时这是最快的办法。

**也可以让求职助手代劳**：点「版式」卡片标题栏的 **找求职助手制作**（版式行内还有
「找助手改这个模板」），会跳到助手页并**预填一句提问**（只预填、不会自动发送，你可以改完再发），
助手据此新建或修改版式。助手改的始终是参数，不会去写模板的 HTML 与视觉配置——这是有意为之：
模型长篇写 HTML 容易出错，保存前还会被清洗掉脚本与外链，可能拿到"看起来生成了、其实不对"的结果。

注意：助手**只能改参数，清除不了已经设过的参数**——比如"帮我不要那个强调色"它做不到，把某一项去掉
要到工作台里改。这是"只改你提到的项、其余原样保留"这一策略的必然结果（也是为防止一次误改就把你
调好的其它参数一起冲掉）。

版本说明（2026-11）：工作台里的 **自制模板**（**复制为新模板**、**导入 HTML**、**导入参考模板**）
已经下线——要写 HTML/CSS 才能改的模板对多数人成本过高，真正想调的密度、间距与配色都在「版式」里。
**已经存在的自制模板与引用它们的旧简历不受影响**：仍按原样渲染、仍随备份一起迁移，只是不能再新建或编辑。

版式名不能与内置或已有版式重名；删除一个自制版式后，用过它的简历会退回默认版式，简历内容不受影响。

### 检查并更新应用

设置 → **应用** 页的 **软件更新** 可以直接对比本地版本与 GitHub 上的最新发布。发现新版本后，可以在应用内下载，
查看下载进度，选择「后台下载」，下载完成后再确认「重启并安装」。当前应用内覆盖安装只支持 Windows；macOS 请用项目根目录的
`update.command`（等价于 Windows 的 `update.cmd`），Linux 请按本机的手动升级流程操作。`update.cmd` / `update.command`
都可以用于手动更新：

- 从 Git 克隆的目录走 `git pull --ff-only`，再同步前后端依赖；
- 从压缩包安装的目录会下载最新源码并覆盖程序文件，`data/`、`.env`、`runtime/`、虚拟环境与
  前端依赖目录一律不动；
- **手动更新会先停掉还在运行的简历通**（按 `runtime/` 里的进程记录校验 PID、启动时间与命令行，
  对不上就不动）。同步依赖要删掉 `frontend/node_modules` 重装、还要覆盖 `backend/.venv` 里的文件，
  运行中的实例会锁住这些文件——不停掉的话 `npm ci` 会以 `EPERM` 失败。应用内安装本来就会先等
  应用退出，这一步是给手动双击 `update.cmd` 补上的；
- 想先看它准备做什么：Windows 用 `powershell -File scripts\Update-ResumeForge.ps1 -DryRun`，
  macOS 用 `bash scripts/macos/update.sh --dry-run`。

更新不会动数据：应用内安装、`update.cmd` 与 `update.command` 都只替换程序文件，`data/`、`.env`、`runtime/` 与前端依赖目录会保留；数据库迁移在下次启动时自动执行，迁移前仍会写一份 `backend/data/backups/` 备份。

**更新成没成，以"现在跑的是哪个版本"为准。** 更新完打开界面时会如实告诉你结果：真的换了新版本才提示「已更新」，没起来就明确说失败了、并把原因和日志位置（`runtime/update.log`）写出来——不会像以前那样无论成败都弹一句"已更新"。更新失败最常见的原因是还有进程占着依赖目录（应用没关干净，或杀毒软件）：**双击 `stop.cmd` 关掉应用再更新一次**即可；也可以直接用 `update.cmd` 手动更新。
**旧版本导出的备份可以在新版本上导入**（导入时会自动把旧结构升级到当前版本），反过来则不行——
来自更新版本的备份会提示"请先升级应用再导入"，这是有意的保护。

更新代码前也可以先运行数据库备份脚本；详细的 Git 更新、压缩包升级、迁移和回滚方法见
[升级与数据安全](upgrading.md)。模型调用和助手联网搜索的完整边界见
[安全政策](../SECURITY.md)。

### 退出应用

页头的 **退出** 会把前端与后端进程都停掉（后端先按启动记录停掉 Vite，再自己优雅退出），
页面切成"已退出"并告诉你如何重新启动。它有二次确认——退出会中断正在生成的回复，也会让正在打开的
页面失去后端。浏览器不允许脚本关闭"不是自己打开的"标签页，所以退出后请顺手关掉它；页面上的遮罩
会盖住整个界面，不必担心误操作。

不想退出、只想关掉浏览器标签页时直接关掉即可，前后端会继续在后台运行，下次打开页面还是原来的
状态。同一台电脑上重复运行 `start.cmd`（macOS 上是 `start.command`）不会起第二个后端：启动器检测到已在运行就会跳过。

### 卸载

Windows 用项目根目录的 `uninstall.cmd` 把应用从这台电脑上清掉。它**默认保留你的数据**：

- 删除启动器生成的东西——`backend\.venv`、`frontend\node_modules`、`frontend\dist`、`runtime\`
  以及各类缓存目录；
- **保留** `backend\data`（数据库，含岗位、简历、资料、助手对话）与 `backend\.env`；
- **不会删源码和文档**——它是个卸载器，不是"删掉我的仓库"按钮。想让整个目录消失，跑完之后自己删。

想连数据一起清掉，用 `uninstall.cmd -Purge`；它会先把要删的东西列出来，再要求你手动输入 `YES`
确认（普通卸载同样要确认一次）。加 `-Yes` 可以跳过询问，供脚本调用。

它只在自己的项目目录里工作：放在别处运行时会直接报错退出，不会误删。清理后想重新用，双击
`start.cmd` 会从头装一遍依赖。

**macOS 不需要卸载脚本**：这个项目从不往项目目录之外写任何东西（便携版运行时、虚拟环境、
依赖目录都在项目里），**直接删掉整个文件夹就是干净卸载**。想留个底的话，先到
设置 → 数据 → 导出当前数据集，再把文件夹拖进废纸篓。

## 6. 岗位匹配分析与自动投递

左侧导航 **投递台** 把「自动采集 → 挑选导入 → 匹配分析 → 排队投递」串成一条链路。采集先把岗位放进**备选岗位暂存区**、由你挑出要留的再导入岗位广场；匹配分析与投递读写的都是岗位广场里已经存在的岗位。采集与投递是本项目里**少数会主动访问招聘网站**的功能，且只有在你显式触发时才会运行。

投递台顶部常驻一行 **「当前招聘网站：……」**，告诉你现在对接的是哪个招聘网站。目前只支持 BOSS 直聘，后续会陆续增加；新增招聘网站后这一行会自动变，不需要你做任何设置。

### 自动采集岗位

在「投递台 → 自动采集」里填好关键词与城市（至少填一个），可选在「按招聘网站的条件筛」里选求职类型、薪资、经验、学历等站点自己的筛选条件，点 **开始采集**。多个关键词会逐个搜索，并在整批范围内按岗位去重；城市可以直接填“北京”“杭州”等名称，应用会把它解析成 BOSS 使用的城市编码。无法识别的城市会在开始抓取前明确报错，不会把中文名当成编码继续请求。

**采集在后台跑，切页面不会打断它**：批次由后端线程执行，你切到首页、简历中心或任何其他页面都不影响它继续采集；回到投递台时进度面板照样在（顶部显示"已处理 N / M"与该批次的状态），随时可以**暂停 / 继续 / 停止**。批次结束时，无论你当时在哪个页面都会收到一条通知（点击跳回投递台）；浏览器标签在后台时还会尽力发一条系统桌面通知（仅在系统已授予通知权限时，应用不会主动弹权限框）。

#### 按招聘网站的条件筛

采集条件里有一整块 **「按招聘网站的条件筛」**，对应招聘网站筛选栏里的那几格：**求职类型 / 薪资待遇 / 工作经验 / 学历要求 / 公司行业 / 公司规模 / 融资阶段**。这是条件过滤的**唯一一层**：招聘网站在搜索时就替你筛掉了，比"采回来再按岗位字段本地筛"更准、也少翻很多页。

- **选项清单读自招聘网站本身，不是应用写死的**。写死的一份在站点改编码之后会**静默筛错**——你以为按「本科」筛了，实际发出去的是另一个编码。清单有三条来源并按可信度自动降级：**你的登录会话**（读页面上真实的筛选栏，最准）→ **全网通用清单**（免登录就能拿到的那份）→ **内置快照**（联网失败时的离线兜底）。当前用的是哪一份，界面上用彩色标签如实标出。
- **「求职类型」的选项因人而异**，所以它必须读你的登录态。实测：学生账号能看到「不限 / 全职 / 兼职 / **实习**」，未登录时只能拿到「不限 / 全职 / 兼职」。想让选项齐全，请先启动投递专用浏览器；没启动时应用会明确告诉你"当前是全网通用清单，够用但不一定全"。
- **编码用之前逐个校验**。采集开始前，应用会拿当次读到的清单核对每一个选项：核对不过的**不会发给招聘网站**，而是在结果上方标为「未能生效」。旧编码在网站看来同样"合法"，发出去会静默筛错，那比不筛更糟。
- **「测试是否生效」按钮**：点一下，应用会在真实招聘网站页面上逐项检查你当前选的条件现在能不能选到，并逐项给出「已生效 / 未生效」的结论——怀疑某个条件没起作用时，先点它。
- 想重新读取清单（例如你刚在浏览器里登录、或怀疑站点改版了），点那一块的 **重新读取** 即可。

**「开始采集」旁边有一个默认不勾选的复选框「保存本次抓到的站点原文（用于排查解析问题）」**。它只在排查"抓不到 / 解析不出来"时用：勾上后，本次采集会把**搜索与详情两个接口的响应原文**存到本机 `backend/data/captures/<站点>/` 下（每份一个 JSON，含接口路径、抓取时间和响应体）。它**默认关闭**、每次采集都要你**显式勾选**；存下来的只是站点返回的内容、**不含你的登录凭据**（接口地址只保留 path、丢掉查询参数，也不记录请求头与 Cookie），并且只落在本机、**不进仓库、不进备份**。不勾选时不会创建任何目录或文件。

**采集不会直接往岗位广场里塞东西**：采到的岗位先陈列在「本次采集结果」里，你勾选要留下的、点 **导入选中的岗位** 才收进岗位广场（来源标注为「岗位采集」）。采集条件（关键词 + 城市）本来就宽，噪声是常态——把"挑"这一步留给你，比让你事后去岗位广场一条条删要省事。没勾选的会留在备选岗位里，之后还能回来挑。

采集完成后不必自己找下一步：结果面板上方就写着「采集 → 挑选 → 导入 → 投递队列」的流程与每一步在哪个页签；任务文案也会直接告诉你"已暂存 N 个岗位，去「本次采集结果」勾选"。同一批次完成时结果会自动刷新，切换到另一次采集会清空上一批的勾选，避免误导入旧候选。

- **每一次采集都有记录**：「投递台 → 采集记录」按时间倒序列出每次采集的条件与结果（已暂存 / 重复 / 失败原因），展开就能看那一次采到了哪些岗位，也可以在那里直接挑着导入。
- **筛掉不等于没采到**：如果采到的岗位全被筛掉，任务文案说的是"都不符合你填的筛选条件"，而不是"没有找到匹配的岗位"——后者会让你去改关键词，而问题其实出在筛选条件上。
- **去重是双向的**：已经在岗位广场里的岗位不会被重复采集；已经在暂存区里的也不会再存一份（否则你勾一次就会重复导入一次）。重复的会记进"跳过"计数里。
- 导入后的岗位就是你熟悉的普通岗位，可在岗位广场里照常筛选、解读与制作简历。采集优先读招聘网站自己的接口数据，所以存下来的**岗位描述是完整版**（页面上有时只显示摘要），并且会按小标题把「岗位描述」与「任职要求」分开存；薪资也按你在页面上看到的写法保存（如 `20-40K`、`300-800元/天`）。
- **采到 0 个岗位时，请区分两种情况**：如果页面确实加载出来了、只是关键词没搜到，任务会正常完成并说明「没有找到匹配的岗位」，换个关键词或放宽城市再试即可；如果接口返回参数错误、页面结构变化、详情页要求登录或出现验证码，任务会**明确失败**并给出诊断信息。登录与验证码不会再被吞掉并伪装成「成功但岗位描述为空」，请先在专用浏览器里处理后重试。
- **招聘网站改版时会醒目提示，而不是让你自己发现**：如果最近几次采集**反复读不出岗位页面**（选择器失效），或者**采集完成了、却普遍读不出岗位描述**，投递台顶部的「当前招聘网站」会出现一条 **「站点可能已改版」** 的提示。它照后端的判据分三层说清：**发生了什么**（读不出岗位页面 / 读不出岗位详情）、**我们的推测**（站点**可能**改版了——是推测，不是结论）、**你该怎么做**（先重试一次；如果一直这样，请到项目仓库反馈，并把「采集记录」里这一次批次一并附上）。它**基于最近 5 次采集**判断，**只有 1 次记录时不报警**；而**需要登录、验证码、网络超时、真的没搜到**这些**不算**改版——它们是环境或你这边的问题，单独处理即可。健康站点不会显示这条提示。

### 岗位匹配度分析

在岗位详情里点 **匹配度分析**。它会读取你的**个人资料与简历**，逐条对照招聘要求给出五类结论：**已匹配 / 表达缺口 / 证据不足 / 真实缺口 / 待确认**，并附一条投递建议。结果随岗位保存，投递台据此决定哪些岗位需要你额外确认。

读的是哪一份资料？**「我的资料」里当前选中的方案，且不含你设为隐藏的字段**。换了方案之后新发起的分析会自动跟随新方案；**已经生成的结果不会被改写**——它们各自冻结了生成时的快照。助手、简历建议与审阅预检也遵循同一条口径（2026-10-28 起统一）。

五类结论之外还会附一个 **0–100 的「参考分」** 和五个分项（技能覆盖 / 年限 / 项目相关度 / 硬性门槛 / JD 关键词覆盖）。参考分是**本地规则估算**、仅供展示与自我评估：它**不参与投递准入**——「能投 / 需确认 / 不投」仍只由五类结论决定，分数旁固定带免责说明（不代表真实 ATS 解析结果或投递成功概率）。信号缺失时给中性分（50）而不是把"没信息"误报成"不匹配"，所以低分不等于你不合适——先看五类结论里具体缺什么。

它和只读招聘原文的 **岗位需求解读** 不是一回事：解读回答「岗位要什么」，匹配分析回答「你够不够」。两者互不影响，结论本身都不带百分比（匹配分析五类结论之后的「参考分」是展示辅助，不参与投递准入）。分析依据过期或岗位要求改动后，可以按需重新生成。

### AI 对比选岗（多个岗位横向比较）

在 **岗位广场** 点 **选择**，勾选 **2–12 个**岗位后点 **AI 对比选岗**，在设置视图里点 **开始对比**。它会先逐个岗位核对匹配情况，再把这些岗位放在一起排出**适合程度**（第 1 名到第 N 名），并说明每个名次的原因与需要注意的短板——回答的是「这几个岗位里哪个更适合我、为什么」，而不只是"每个岗位各自够不够"。

排序来自**相对比较**，不出现百分比或评分；参考分仍只作展示、不参与排序，也不参与投递准入。分析在**后台**进行：可以随时取消，也可以关掉窗口先去忙别的（切到其他页面任务会继续，完成时弹出通知），回到面板会自动接上进度。未配置模型时会明确显示**本地降级**结果（按参考分排序、理由只复述已有结论），单个岗位失败也不会吞掉同批其它结果。

每批结果会自动保存。点击岗位广场的 **分析记录**，可按时间回看完整快照（带「横向对比 / 匹配度分析」标签）；历史记录模式只读，不会误显示「重新分析」按钮。想重新分析时重新选择岗位后再发起一批即可。

### 多选后的批量操作

选择模式下，工具条上的 **批量操作** 下拉（以及选中行的**右键菜单**）提供六件事：**匹配度分析、岗位需求解读、AI 生成简历、加入投递队列、导出 CSV、批量删除**。

它们都是**逐个执行你原本要一个个点的单项动作**，不会把结果合成一份：生成简历会给每个岗位各生成一份，解读会给每个岗位各存一份解读，匹配度分析仍是逐岗位结论；只有 **AI 对比选岗** 才是"放在一起比较"的那一个入口。生成简历与岗位解读会**串行**逐个跑（一次只打一次模型），进度显示在工具条上，可以「当前岗位完成后停止」；跑完会弹出完成通知（成功 / 失败各多少）。导出 CSV 一次导出所选岗位；加入队列沿用批量入队（含来源校验与二次确认）；批量删除仍是软删，可在 Toast 里撤销。

### 加入队列并投递

「投递台 → 投递队列」页顶部常驻一段流程说明，写清了三件事：**岗位从哪进来**（岗位广场的岗位详情 → 加入投递台，或自动采集导入后同一个入口）、**在这里要做什么**（核对准入结论、逐条编辑招呼语与使用的简历）、**什么时候才真的投出去**（勾选后点「开始投递」之前不会打开任何招聘网站）。队列为空时页面会直接告诉你先去哪一步。

点击队列里的**岗位名**可以打开详情抽屉，看完整的招呼语、准入结论、排队序号、使用的简历与加入队列的时间；表头的「操作」与右侧按钮同侧对齐，竖屏窄窗口下不会再挤成一团。队列长了以后：顶部可以**按状态 / 准入筛选**（筛选只影响列表显示，准入告警与投递范围仍按全部数据判断）；**「全选队列」**会跨页勾选当前筛选结果里的全部可投岗位，配合**「移出所选」**批量清理；计数条随时显示队列总数与已选数量。列表每页 10 条，分页形态与岗位广场一致。

1. 在岗位详情点 **加入投递台**。命中**真实缺口**（硬性条件明确不满足）的岗位默认显示为「不投」，需要你逐条确认才能进队；**证据不足 / 待确认**的岗位也必须逐条确认。

- **只有「来源在招聘网站内」的岗位能自动投递**：投递台是靠招聘网站的页面动作完成投递的，所以它要求岗位的来源或**投递链接**能归属到某个已支持的站点（目前是 BOSS 直聘）。手动录入、两者都指不到站点的岗位，详情里的「加入投递台」是**灰的**，并在按钮上方写明原因与出路——把它的「投递链接」改成该岗位在招聘网站上的地址即可（改完就能自动投递），或者直接点「前往投递」/到原渠道自行投递。这不是"必须用采集"：手动录入但贴了招聘网站投递链接的岗位照常可以投。

2. 在「投递台 → 队列」里预览并修改招呼语。BOSS 当前走站内「立即沟通 / 继续沟通」，使用账号自己的在线资料，因此没有为这个岗位生成本地岗位版简历也可以执行；如果以后某个站点表单确实要求附件，再由该站点单独声明必须有简历。
3. 先在页面顶部启动 **投递专用浏览器**：它是一个**独立窗口**，启动后会**直接打开招聘网站首页**，请在那里**自己扫码登录**一次。**登录由你在自己的浏览器里完成，应用不保存你的账号密码，也不读取或保存登录 Cookie。** 如果你把这个标签页关掉或跳到了别处，点 **打开招聘网站** 即可找回登录页，不用重启浏览器。想换一个浏览器来跑这个窗口，去「投递设置」里的 **投递台使用的浏览器** 选：自动（优先 Chrome）/ Chrome / Edge / 自定义路径；改完立即生效，不用重启应用。**明确选了某一个浏览器它就只找那一个**——没装会直接告诉你，不会偷偷换成另一个。
4. 点 **开始投递**。BOSS 流程会等待聊天输入框出现，兼容普通文本框与 `contenteditable`，填写招呼语后点击真实的发送按钮，并在本人消息出现或站点给出成功提示后才记为成功。执行中逐岗位显示状态（待投递 / 进行中 / 成功 / 失败 / 已跳过）和「已处理 N/M」计数，**暂停 / 继续 / 停止**按钮常驻；连续失败会自动熔断。进度与历史记录里的时间会把后端 UTC 转为当前电脑的本地时间。

- **对从未沟通过的岗位，BOSS 会先自己发出一条招呼语**（2026-09-21 在真实会话里确认）：打开打招呼对话框时，招聘网站会自动发出**你在站点里配置的那句默认招呼语**，应用写的招呼语作为**紧接着的第二条**发出。所以 HR 会连着收到两条，第一条是站点发的、**不受本应用控制**。想改第一条的内容，去招聘网站自己的设置里改；本应用能保证的只有第二条。
- 消息发出去之后可以在招聘网站自己的聊天页看到，投递记录里的「招呼语」也逐字保存了应用实际发出的那句。

### 投递设置逐项说明

「投递台 → 投递设置」里的每一项都**真的会生效**，各自管什么：

| 设置                                                     | 作用                                                                                                                                                                                                                                                                                 |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **岗位间隔（秒）** + **随机抖动（秒）**                  | 投完一条后等多久再投下一条。实际等待 = 间隔 + 0~抖动的随机值；**抖动是为了让节奏不像机器**。注意这个等待是"上一条结束→下一条开始"，所以两条记录的开始时间之差会比间隔略大（中间还夹着上一条本身的耗时）。                                                                            |
| **单批上限**                                             | 一次「开始投递」最多投几个。队列里有 20 条、单批上限填 3，这一批就只投 3 条，**其余的原样留在队列里**，下一批再投。                                                                                                                                                                  |
| **每日上限（成功数）**                                   | 当天累计成功投出多少条之后就不再投了。达到上限时：还没开始时直接拒绝并说明；投到一半达到的，剩余岗位标为已跳过。只计成功，失败的次数不占额度。                                                                                                                                       |
| **连续失败熔断阈值**                                     | 连着失败这么多次就自动暂停并醒目提示，避免在一个失效的页面上把整批都耗光。                                                                                                                                                                                                           |
| **默认招呼语**                                           | 队列条目没单独写招呼语时用它。写进投递记录的是**实际发出去的那句**。                                                                                                                                                                                                                 |
| **同公司只投一个岗位**                                   | 开着时，**同一批**里同一家公司的多个岗位只投最先的那一个，后面的标为「已跳过」并在明细里写明跳过原因。**作用域是单批**：下一批再遇到这家公司仍然会投。判断用的是归一化后的公司名（忽略空格与大小写），**而且"投过"包含失败的那次**——失败可能发生在确认环节，招呼语其实已经发出去了。 |
| **默认允许「真实缺口」岗位直接入队**                     | 关着时，命中"硬性条件明确不满足"的岗位必须逐条确认才能进队列。                                                                                                                                                                                                                       |
| **当前招聘网站** / **投递台使用的浏览器** / **调试端口** | 见上面第 3 条。                                                                                                                                                                                                                                                                      |

### 投递记录与失败诊断

「投递台 → 投递记录」按**投递批次**分组列出每一次投递的结果：一次「开始投递」投出的多个岗位折叠成一组，组头写明批次号、时间与这次投递自己的统计（成功/失败/跳过），**点击组头展开**看组内每条记录；可按结果筛选、搜索岗位/公司（筛选作用在记录上，没有命中记录的批次不出现）、对单条失败重投。失败会按原因分类（页面结构变化、需要登录、遇到验证码、招呼语缺失、网络超时、简历上传失败、岗位来源不支持等），失败详情里有当时的页面地址与标题，点「详情」在右侧抽屉看完整信息。**遇到验证码或安全验证时不会尝试绕过，会如实记为失败并请你手动处理。**

失败列是**三层**：分类 Tag + 稳定子码（如 `site_changed` / `render_timeout` / `login_required`）+ 诊断摘要。工具栏的失败分类筛选同时作用于组头统计与展开后的明细行；组头右侧给出「只重试这 N 条」（按当前筛选批量重投，自动去重岗位，岗位已被删的记录会明确拒绝）。点「详情」的抽屉按「发生了什么 / 在哪一步 / 你该怎么做」三段排，建议随子码变化（页面改版 → 反馈诊断；加载超时 → 稍后重试；需要登录 → 重新登录；资料不足 → 补资料）。

**投递记录可以删**：单条删（行内删除）、整批删（组头的「删除本批」），都要二次确认，删掉进**回收站**可恢复。

⚠️ **删了就真没了**——删掉的投递记录**不再计入求职统计，也不再计入每日投递上限**。所以删掉几条成功的记录之后，「今天还能投几个」会跟着变多，这是有意的：回收站里的内容不出现在任何统计里（见「回收站」一节）。想反悔就去回收站恢复，恢复后重新计入。**对已删的记录点「重投」会提示找不到**，不会把它悄悄复活。

**投递进行中可以随便切页面**：投递由后端在后台执行，切到首页、简历中心或其他任何页面都不会打断它；批次结束时（无论成功、停止还是失败）会弹出**全局通知**——在应用的任何页面都能收到，点击即可跳回投递台，系统通知权限已开启时还会同时发一条桌面通知。

### 内推管理

投递台的 **内推** 页签记录的是**你通过人脉拿到的推荐机会**——内推人、联系方式、关系、渠道这些只有
人脉才有，与"投递台替你发出的申请"是两件事。每条内推还可以记**内推码**与**备注图片**（如内推海报
截图），列表按状态分色一眼区分「进行中 / 已投递 / 已关闭 / 无效」。内推成功落到求职进度后，它会统计
**内推转化率**：口径由关联的求职进度派生，进入「面试」及以上才算转化（写入时不接受手填"已转化"，
避免在表里手算第二份口径）；状态还是「active / submitted」的内推才算转化率分母。列表里的每条记录
**点一下卡片**（或点行尾的「详情」）会在右侧打开详情，看得到联系方式、关系、渠道、内推码、投递日期
与备注图的完整大图——列表里只放得下摘要，这些细节不必再进编辑表单才看得到。

### 隐私边界

- 采集与投递只会访问你显式触发的那一次，不会在后台自动运行；投递专用浏览器使用独立的数据目录，与你的日常浏览器互不干扰。
- **应用不收集、不保存招聘网站的账号密码**；登录凭据只存在于这个独立浏览器窗口里。
- 投递链路的日志不会记录你的账号密码或登录凭据；对外分享日志前仍应自行核对。
- **网申填表的资料值只在本机流转**：读取页面、匹配、填充都发生在你本机的浏览器里，取值一律在本地完成，**你的资料值不会因为"填表"这件事发给任何第三方**。开了「未识别字段智能辅助」之后，发给大模型的只有**页面上本来就有的控件文字**（标签、占位符、下拉选项、邻近文字）与**字段名**（"证件号码"这四个字，不是证件号码本身）——详见 6.5 的「认不出来时让 AI 帮一把」。助手读资料的字段白名单里也没有这些网申专用字段。
- **网申「填充记录」含真实值，但只存本机**：它记下你填进别人页面的实际内容（证件号、手机号、亲属信息），因为"事后能核对"正是它存在的理由。这些记录只存在本机数据库里，**不进分享包、不进简历导出**；助手默认**读不到它**——一旦读得到，这些值会随你的提问进入对话上下文并发往模型服务商，与上面「只发字段名、不发值」的边界直接冲突。如果你确实想让助手帮你回看"当时填了什么"，可以在 **设置 → 「AI 模型」页签 → 「助手放宽模式」** 显式开启（开启前有明确告知）；关闭时助手依旧读不到。回看与删除都在「网申填表 → 填充记录」里做，删掉进回收站。导出或分享你的数据库文件前请自行核对。
- **「网申资料」同样只在本机、且只在填表时用**：你在「我的资料 → 网申资料」里填的档案所在地、紧急联系人、父母工作单位、身高视力等**不会进入简历**（生成简历不读这一区），**不会发给模型**，**助手也读不到**。它们只在「网申填表」把值写进你自己打开的页面时被用到，取值全程在本地完成。
  填表时「学到的」那些（见 6.6 的「填表时学到的」）走的是同一张表、同一套边界：
  **只存本机**，同样不进简历、不进分享包、助手读不到。区别只在于这张表会**随填表自动增长**，
  所以界面上给每一条标出来源、留了改档位与删除的入口——你随时能把它收回去。

## 6.5 网申填表

有些公司不走招聘平台，而是自建一套网申系统（腾讯校招、华为招聘那类）：姓名、国家地区、
证件、手机、邮箱、教育经历一页页填下来，换一家公司又要从头来一遍。侧栏 **网申填表**
（在「投递台」之后）就是把这一步自动化。

简历侧的取数**按当前方案**：当前方案没勾选的板块整块不参与；网申专用项（证件、籍贯、家庭信息等）
**不受方案过滤**，任何方案下都能取。

### 怎么用

1. **启动浏览器**。网申有独立的专用浏览器，不覆盖投递台或该浏览器已打开的其他网页；如果已经有目标网址，会直接打开目标页，不会先闪出空白页，也不会重复启动多个相同窗口。可以在启动按钮旁输入目标网址直接新开页面，网址记录可选择或删除。你也可以在岗位详情点「前往投递」打开目标页面。登录态由浏览器自己记着，应用不读也不存；手动关闭后点 **刷新状态** 检查。
2. **在专用浏览器里打开目标公司的网申页面**，停在要填的那一步。悬浮球只出现在这个专用浏览器网页内，不会遮住简历通主界面；每个页面各有独立的悬浮开关，可分别决定是否启用「智能逐项填表」，默认开启——**打开浏览器或页面时即自动开启**，不需要手动再点。悬浮球是专用浏览器专用的吉祥物「**历历**」（静态形象）：单击切换实时填表开关，关闭后悬浮球仍保留但会变成灰色，输入框聚焦不再弹提示卡；**双击**展开/收起菜单，按住左键即可拖到合适位置；菜单里除了「自动填写当前页面」，还有一个「**问历历**」折叠区，可以直接向求职助手提问（需先在设置里配置模型服务），不必切回主界面。
3. 回到本页点 **「读取当前表单」**。程序读的是**当前标签页**上的输入框，只读不写。
4. **核对映射**。表格里逐条列出「哪个字段 → 填到页面上的哪个框 → 填什么值」：
   - 值可以直接改；
   - 不想填的那条，把左边的勾去掉；
   - 标着 **需确认** 的说明有另一个控件也沾边，请留意；
   - 标着 **冲突** 的说明页面上已经有值了，**默认不勾**——那可能是你上一轮填了一半的草稿。
   - 日期写进「YYYY-MM-DD」这类文本框时按页面的写法来：原样、带分隔符、只有年月就只写年月，
     **缺的部分不编**；页面明确要完整日期时才把缺的日补成 1 号，并在那一行注明让你核对。
   - **下拉、单选、复选、日期控件不会出现在这张表里**——它们的值该由你在页面上点选，
     工具不代劳（见下面「它不会做什么」的第一条）。它们会出现在「不会自动填」那一栏。
5. 点 **「填充到页面」**，然后回到浏览器窗口逐项核对。结果会显示**成功填写数 / 页面可读取表单框总数**的成功率，同时列出识别并尝试填写的数量。

**这一页读到的东西和当前填写进度不会因为你去补资料而丢。** 当前应用标签页会临时保存这次读取、
预览、勾选、手改值、填充结果和 AI 开关，所以你点「我的资料」再回来，或刷新当前标签页，都会继续
刚才的状态。浏览器窗口被直接关闭也不会清掉这份草稿；重新启动后可以继续。普通离开、切页和关掉
受控浏览器都不会结束会话，只有点击页头的 **结束本次填写** 才会停止监听、关闭受控浏览器并清理
这次草稿。但**直接关掉受控浏览器窗口会让「智能逐项填表」的实时会话自动结束**（界面给一条中性
提示，不会一直显示「运行中」等你手动停）；这份草稿仍会保留，重新启动浏览器可以继续。

（读取的表单有 **15 分钟**时效。超过之后再回来会如实告诉你"这次读取的表单已经过期，请重新
点「读取当前表单」"，不会给你一个空页面。）

**换一个浏览器来填。** 页头的「浏览器设置」可以选 **自动 / Google Chrome / Microsoft Edge /
自定义路径**——与「投递台 → 投递设置」是**同一份浏览器类型配置**（但窗口和登录态彼此隔离），
所以在这里改了对投递台也生效，反之亦然。指定某一个就只找那一个，没装会直接提示，
**不会静默换一个**。换过浏览器要点「关闭浏览器」再「启动浏览器」才生效——设置只改配置，
它不负责起停。

> **页头那三个按钮各管一件事，不重合**：**启动 / 关闭浏览器**只管进程的起停；
> **浏览器设置**只改配置；**刷新状态**只是立刻重查一次（平时它会在上一次探测完成后自动安排下一次）。
> 任何一个在跑的时候，另外几个是禁用的——避免"关闭还没回来又点了启动"这种交错。

### 填充记录：每次填完留一条痕

填完一张长表，事后想确认"我当时到底填了什么、有几个没成、为什么"时，看页面底部的
**「填充记录」**：每次点「填充到页面」留一笔，记下时间、页面地址与标题、每个框认成什么
字段、**最终填了什么值**、成功 / 待确认 / 失败各几项；点开看逐条明细，以及填完后页面的
快照（当时页面上每个框是什么样）。

- **模式不同，粒度不同**：「填充到页面」每次落一条；「智能逐项填表」是**一个会话汇总成
  一条**（从开启到关掉算一次），不是每填一个框落一条。
- **可以删**。单条删除，删掉进**回收站**，可恢复；彻底删除在回收站里做。
- ⚠️ **记录里含真实值（证件号、手机号、亲属信息），只存本机**，不会进分享包、不会进简历
  导出，助手也读不到它。对外分享你的数据库文件前请自行核对。

### 出现问题时怎么提供排障信息

网申填表页页头的 **「导出诊断」** 会下载一份脱敏 JSON。它包含应用版本、请求编号、实时填表
启停、读取 / 识别 / 填充数量、成功与失败计数以及前端请求错误等信息；不会包含简历内容、
表单实际值、密码、Cookie 或 API Key。请把这份诊断文件与问题截图一起提供。必要时再附上
runtime/backend.stderr.log 的相关时间段；日志中同样不要手工补写个人资料或密钥。

### 它不会做什么

这几条是刻意的，不是还没做：

- **不会替你提交。** 填完就结束，提交必须你自己点。整个界面上没有"提交"按钮。
- **不会自动填"点选类"控件——只往文本类控件里写值。** 下拉框、单选、复选、日期控件，
  以及点开才是弹层的自定义选择器，一律不自动填，会如实列进「不会自动填」并写明
  "需要你自己点选"——**不假装**。这类里最常见的是**可搜索下拉**：学校、专业、意向城市
  这些框看着像个输入框（框架把 `<input>` 摆在里面），其实必须点开列表选一个才算数；
  只读的省 / 市 / 区级联框、日期选择器同理。理由有两条：
  这些框的值是**你的选择**（性别、学历、意向城市、日期），不是从资料里抄一行字；而且
  程序往只读展示框里写值，常常是"看着填上了、组件内部状态一点没变"，表单交上去还是空的。
  （旧版边界是"事实类照填、只挡表态类"，2026-10-05 收成了现在这条。）

  **例外：放宽模式（默认关闭）。** 在网申填表页顶部或「设置 → 应用 → 网申填表 · 放宽模式」
  显式开启后，其中一部分选择权交回给你：除点选类控件若能匹配到资料值时尝试**代点**外，
  未被普通规则识别的文本框也会按字段标签、别名与页面上下文匹配（包括网申资料中的自定义字段）。
  选项按严格口径解析、点选后回读核对，失败会如实写明原因；同意 / 声明类勾选仍**绝不
  静默代勾**，它们以「需你确认」行出现（默认不勾，你勾选后才代点），实时面板里则是
  「帮我勾选：{字段名}」按钮，点按即视为你本人确认。低置信度文本匹配标成「需确认」、默认不勾；
  只有核对后由你勾选才写入。**日期选择器与文件上传在任何情况下
  仍不代做。** 第二轮放宽把代点范围再扩了一步：**弹层类选择器支持多值代选**（如意向城市
  最多选 3 个），且要**全部命中才动手**——只要有一个值匹配不上就整体放弃、仍列成需要你
  自己点选；「没有…」「无…」这类陈述性声明与同意 / 声明勾选**同等待遇**，进「需你确认」
  清单，不静默代勾；程序认得出是点选控件、但你的资料里没有对应值时，会如实标成
  「资料里还没有」，让你先补资料或自己点选。开启前界面有风险提示：存在选错可能，填完请核对。

- **不会填密码和验证码。** 密码框连读都不读，验证码在清单里标为「需你手动填」。
- **不会替你表态、也不会替你陈述事实。** 同意条款（「我已阅读并同意隐私政策」）代勾等于
  替你做出法律意义上的同意；「无实习经历」「至今」是在陈述你的经历状况；「是否服从调剂」
  是在表态。这几类会在清单里**各自写明理由**（例如"涉及「我已阅读」的确认项，需要你本人
  勾选"），不由程序落笔，AI 那条路同样不例外。
- **不会覆盖你已经填过的内容**（除非你自己在预览里勾上它）。
- **不会替你上传简历附件**——附件选择框只能你自己选文件。
- **不会填"别人的"信息**：紧急联系人、父母、推荐人这些栏目，程序认得出它不是你的资料，会明确列出来让你自己填。
- **认不出的框就如实说认不出**，不会硬猜一个值填进去。开了「未识别字段智能辅助」时它会交给
  模型认一下，但**模型只回一个字段名，不参与取值**，而且认出来的行会标上「AI 建议」并
  **默认不勾选**。

### 也可以「智能逐项填表」

上面那套是"整页读一遍、列成表让你勾"。还有一种更贴近手动填表的方式：**开启「智能逐项填表」
之后回到浏览器窗口，点到哪个文本、邮箱或多行输入框，就在框旁边冒出一个提示**，写着这个框该填什么、值是什么，
你点「填入」才真的写进去。浏览器启动后它默认开启；点到日期控件时面板会直接告诉你"这个需要你自己点选"
（它看着像输入框，不说明一句容易被当成没反应）；单选框、复选框、下拉框和附件框不会弹这个面板——
**而且你点到它们时，上一个框留下的面板会收掉**，不会让你对着一个单选框看"将填入：姓名=张三"。
面板有关闭按钮，可以拖动位置，分组更清楚，宽度更大，资料清单支持分组跳转与折叠、模糊搜索。
点击「记住这条」时，默认先显示「网申资料 · 自定义」，其他已有网申字段折叠在分组里；你可以直接
修改字段名、搜索并选择保存位置，统一按通用档位也用颜色区分。

什么时候用它：

- **想逐项核对**，而不是一次性铺开一张表；
- **页面上那些"请选择"的自定义下拉**——整页模式填不进去，但这个模式会告诉你**该选什么**，
  你在下拉里自己选一下就行（程序不替你点开）；
- **程序认不出来的框**——点面板上的「换个资料…」，从你填过的全部资料里自己挑一条
  （见下一节）；

它和整页模式的区别在于：**不做预先快照**。整页模式读的是"你按下按钮那一刻"的页面，如果
表单是联动的（选了国家、省份才加载），后面的框可能已经对不上了；这个模式是点哪个框、当场
匹配哪个框，所以不受影响。

### 认不出来的时候：点「换个资料…」自己挑

面板上除了推荐的那一条，还有一个 **「换个资料…」**。点开就是简历通里**我的资料与网申资料的全部信息**，
包括基本信息、教育经历、实习/工作、校园经历、项目、专业技能、荣誉奖项、网申资料和已有自定义字段，
按板块列出来（身份信息 / 联系方式 / 教育经历 1 / 实习工作 2…）。

资料一多，只会在面板里上下翻是最难找的，所以这一屏给了几个帮手：

- **顶上「可能是这几个」**——程序按**你此刻点在哪个框**，从你的资料里挑出最像的几条压在
  最上面。多数情况下第一屏就是答案，不用滚也不用搜。**它不会替你把别的藏起来**：
  挑剩下的全在下面的完整清单里，一条都没少——所以它挑错一条，代价只是多看一眼；
- **板块跳转条**（搜索框下面那排）——每个板块一个按钮，带这一区的条数，**点一下直接跳过去**。
  同一类的多条资料**聚在一块**：「荣誉奖项 1 / 2 / 3」只占一张卡片，点它展开成三个成员，再点成员
  才跳过去（单条的板块还是老样子，一张卡片就是它自己）。板块多时整条**默认折成一行**，上面写着
  "多少个板块、多少条"，点一下才摊开；摊开后它自己也是**限高可滚**的，最多占掉资料面板的一半——
  它挂在搜索框下面不随内容滚走，所以"跳转条很长"和"下面的资料看得见"必须同时成立。
  板块多的时候它是**换行铺开**的，不会横向滚出去（横向滚着找板块，和纵向滚着找条目一样累）；
- **每个板块可折叠**——点板块标题就折起来，只看你要找的那几个板块（搜索时临时展开命中的板块，清空搜索后恢复原来的折叠状态）；
- **搜索**——搜"手机"、"学校"、"实习"都能滤，支持模糊搜索；结果上方会写**命中几条**，
  一条都没有时会直说，不会留一片空白；
- **每条都带「填入」按钮**，也可以直接点整行。字段名或内容过长时会**单行截断**，
  鼠标停上去能看到完整的那一条。

**键盘也能用**：`Tab` 到某一行按回车就是填入，板块标题按回车折叠，搜索框里按 `Esc` 收起整屏。

**点哪一条就填哪一条，不依赖程序认不认得出这个框。** 三种情况下特别有用：

- **它没认出来**（面板上写着"没认出来这个框要填什么"）——直接自己挑；
- **它认错了**——不用去改资料，从清单里挑对的那条覆盖掉就行；
- **第二个区块**——填完第一条实习/项目/获奖，页面上再"添加"一条时，清单里挑对应的
  那一条（"实习/工作 2"）即可，程序不需要知道页面在问第几条。

展开之后**不会自己收回去**：连着几个框都想自己挑时，不用每次再点一下。换到别的框时搜索词
会清空（不然滤过的列表会让人困惑），但清单本身还开着。在搜索框里按 `Esc` 收起。

**面板上那条推荐一样不给「填入」按钮的**：验证码、同意条款、"无实习经历"这类声明项、以及
紧急联系人等他人信息——面板只会说明原因。（上面清单里的「填入」是另一回事：那是**你自己
的资料**，挑哪条由你决定。）

关掉之后，浏览器页面上的监听和提示面板会**整个撤掉**，不会在页面上留东西。

### 认不出来时让 AI 帮一把

字段匹配是一套通用规则（标签、占位符、`autocomplete` 属性、邻近文字…），**不针对任何一家
公司写死**。所以遇到这张表特有的栏目——「导师姓名」「实验室名称」「研究方向」这种——规则
会认不出来，如实列进「没认出来」。

**开着「未识别字段智能辅助」时，这些框会交给你在「设置」里配置的模型认一次。** 开关在
「网申填表」页，**默认开**；没配过模型时它是灰的，并会告诉你先去「设置」填 Base URL 与模型名。

三条边界值得你知道：

- **只有规则认不出的框才问模型。** 认得出的直接给答案，一次调用都不花；**认得出、只是你
  资料里还没填**的框也不会问（去「我的资料」补一下就好）。
- **模型只回"这个框是哪个字段"，不回值。** 它能选的只有你资料里已有的那些字段名，值、下拉
  选项、日期格式全部在本地决定。所以**它造不出一个不存在的值**——能错的只有"选错字段"，
  而那在预览表里一眼就能看出来。
- **发给模型的不含你的任何资料内容**：只有页面上本来就有的控件文字，加上字段名的清单。

界面上怎么看：

- **整页模式**：AI 认出来的行进到「将填入」表里，标着蓝色 **「AI 建议」**，并且**默认不勾选**
  ——规则命中至少证明页面上有字对上了，AI 命中可能只是根据上下文推的。想全采纳，点
  「全选 AI 建议」。
- **智能逐项填表**：面板上会标「AI 建议」，并且可能**列出两三条候选**，每条自带「填入」按钮，
  挑对的那条点一下就行。模型说"这几个字段都不像"时，仍然只有「换个资料…」那条路。

**模型挂了不影响使用**：它会退回原来的行为，认不出的框照旧列出来，你仍然可以用
「换个资料…」自己挑。另外每个页面**最多问 30 次**（同一个框来回点只算一次），到顶会如实
告诉你"次数已用完"。

### 实习 / 项目 / 获奖的重复区块

网申表单普遍把实习、项目、获奖做成**「可添加多条」的区块**（每条一组同名输入框，旁边一个
「添加」）。现在读取表单时会识别区块标题和序号：**「实习经历-2」只会匹配资料里的第 2 条
实习经历**，不会再把第一条误称为第二条；项目、校园经历、教育经历和获奖信息也按同样规则处理。

程序不会替你点「添加」生成新行——点那个按钮是在改页面，性质不只是填值。你可以先在页面上
自己添加需要的条数，再重新点「读取当前表单」；只要页面显示了对应序号，程序就会按序填入对应资料。
「智能逐项填表」也会携带当前区块的类型和序号，点击第二组控件时可以从完整资料清单中选择
「实习/工作 2」等对应记录。

**成对的日期会标「需确认」。** 区块里的「起止时间」是两个长得完全一样的日期框，程序按页面
顺序判断哪个是开始、哪个是结束，并如实标出来请你核对一眼。

### 填不上的时候

页面下方「页面还要求这些」把没填的分成三块，各自的出路不同：

| 分块           | 意思                                     | 怎么办                                   |
| -------------- | ---------------------------------------- | ---------------------------------------- |
| 资料里还没有   | 程序认得出这是什么字段，但你资料里是空的 | 点「去我的资料补上」，下次读取就能填了   |
| 需要你自己动手 | 验证码、简历附件、他人信息               | 在页面上自己填，这些不会自动填           |
| 没认出来       | 认不出这个框要什么                       | 自己填；这类冷门字段后续会由 AI 辅助识别 |

### 几个常见疑问

- **为什么读了半天说"没有可填的字段"？** 多半是页面还没走到填表那一步（比如停在登录页或岗位列表页），或者表单在一个还没展开的折叠区里。先把页面走到要填的那一步再读。
- **为什么某个下拉框没填上？** 联动下拉（先选国家、省份才会加载）需要上一级先有值。程序遇到这种会明确说"这是联动下拉，请先选上一级"，不会硬填一个。
- **填完发现填错格了怎么办？** 直接在页面上改——程序不覆盖你已经改过的内容。
- **"待确认"是什么意思？** 值写下去了，但回读页面时对不上（有些表单的输入由前端框架接管，值看着在、内部状态没更新）。这类会单独列出来，请到窗口里确认一眼。

## 6.6 「网申资料」：给网申表单单独准备的那一区

在 **我的资料** 页面切换到横向标签 **网申资料**，即可看到统一的网申资料卡片。

网申专用字段（国家/地区、籍贯、证件类型与号码、出生日期、手机区号、政治面貌、家庭信息、期望薪资等）集中在这里，**只用于网申填表、不进入简历导出**。

**与简历资料重叠的字段怎么取值**：政治面貌、导师、研究方向在「简历资料」里也有对应字段（政治面貌在基本信息，导师与研究方向在教育经历），出生年月与出生日期互为近似。默认口径是**单值字段共用一份值**：在资料页改政治面貌，网申随后读到的就是新值；导师 / 研究方向按**最近一段教育经历**取值，为空时回落到这里填的网申单值，并在界面上标明来源。两处不会各存一份互不同步的副本。

**为什么单独一区，而不并进上面的资料表单：** 网申表单问的东西**比简历多得多**，而且很多是
简历上从不出现的——学号、培养方式、专业排名与总人数、档案所在地与报到证抬头、紧急联系人、
父母工作单位、入党时间、身高视力、可到岗时间、招聘信息来源、内推码……

（**QQ 号与微信号在「基本信息」卡片里**——它们属于简历资料，不在这一区重复一份。）

这些放进简历资料里会污染简历（简历上不该有身高和父母工作单位），所以它们**存在另一处**：

- **只给「网申填表」用**。生成简历时**不读这里的内容**——这是这一区存在的全部意义。
  （这条不只是承诺：简历生成的取数函数 `build_profile_prompt_data` 是**白名单**，
  这一区和「网申专用资料」卡片里的字段都不在名单上。）
- **求职助手也读不到**（和上面「网申专用资料」同一条边界）。
- **只存本机**，不进分享包、不进简历导出。

### 分了哪几组

| 分组             | 典型栏目                                                                 | 哪类企业会问                                                   |
| ---------------- | ------------------------------------------------------------------------ | -------------------------------------------------------------- |
| 学籍与档案       | 学号、培养方式、学制、专业排名与总人数、第二专业、档案所在地、报到证抬头 | 校招普遍问学号；国企、事业单位、选调生问档案与派遣             |
| 语言与证书       | 其他语种等级、计算机等级、职业资格证                                     | 证书在国企、银行、外企加分                                     |
| 家庭与紧急联系人 | 紧急联系人及关系电话、父母姓名与工作单位、家庭住址邮编                   | 国企、银行、公务员（政审、背调、亲属回避）                     |
| 党团信息         | 入党/入团时间、所在党支部                                                | 国企、事业单位、选调生、公务员                                 |
| 身体情况         | 身高、体重、视力、既往病史                                               | 部分国企、公务员、军队文职（有体检标准）                       |
| 意向与到岗       | 可到岗时间、期望年薪、招聘信息来源/内推码                                | 几乎所有网申都会问                                             |
| 其他补充         | 个人特长、兴趣爱好                                                       | 各类表单的收尾栏目                                             |

家庭、党团、健康等项目可能含他人信息或健康隐私；界面不再逐条显示「只存本机」标签，
而是在「网申资料」卡片的说明中统一提示隐私边界，避免把每个字段都挤成醒目的标签。

### 怎么填

点页头「**编辑资料**」，切换到「**网申资料**」标签后填写，完成后点「**保存全部资料**」——
和简历资料是同一个按钮（保存时会连着两块资料一起提交）。切换标签不会清掉另一块里尚未保存的内容。

教育经历补充保留排名、校区、GPA 基数和特殊情况等补充项；「是否境外教育」「是否统招」「是否最高学历」「是否辅修」
不再作为网申资料字段。所有资料日期统一保存为 `YYYY`、`YYYY-MM` 或 `YYYY-MM-DD`，
可以只选年、只选年月，也可以选完整年月日；结束时间还可以选择「至今」。

**查看态只显示你填过的项**，空的整组不出现——否则一屏空标签，反而找不到自己填过什么。
编辑态可以在卡片底部输入字段名称，点 **添加** 后填写值；这个字段会作为「自定义字段」保存，
下次可在「换个资料…」里找到。

### 把网申页面上的一屏栏目粘进来

编辑态下页头有「**粘贴文本识别**」：把网申页面上那一屏栏目整段复制粘贴进来
（也可以给截图、上传 PDF / Word），程序会按「网申资料」的字段目录逐条归位。

- **认得出的栏目直接填好**（按目录里的字段名归位，不按你粘贴的顺序瞎猜）；
- **目录外的新栏目不会自己长出来**：它们先列成带「新增字段」标记的待确认项，**默认不勾选**，
  你勾哪几条才新增哪几条——识别可以猜，但你的字段清单不该被猜出来；
- 结果是一张**可原地修改的清单**，看过、改过、点「确认填入 N 项」才写进草稿（还没保存，
  仍要点「保存全部资料」）；
- 识别过程中主按钮会变成「**取消识别**」，随时可取消；取消不是失败，不会弹错误，原文还在，
  可以直接再来一次。

已有的自定义字段在编辑态还可以点 **修改名称** 或 **删除**。修改名称只改显示名，不会丢掉已保存的值；
删除后点「保存全部资料」，它会同时从「网申资料」和目标浏览器的实时识别目录中移除。
删除确认条**就在你点的那一行下面**（含受影响条目数与回收站说明），不再钻到卡片最底部。

### 填表时学到的：不用你手动录

有些栏目你只在填某家公司的网申时才想得起来（「招聘信息来源」「内推码」）。
每次填完表都回来手动录一遍太麻烦，所以**简历通会主动问你要不要记住**。有两个入口：

**入口一：填完表的汇总提示（批量模式）。** 填完一次表，如果这一轮填进去的字段里有
**简历通里本来没有**的，页面会弹一条汇总提示——「本次填的 N 项简历通里没有，要记住下次
自动填吗？」。**默认全勾、默认「通用」**，你可以在弹窗里取消其中几条，也可以逐条换档位。

**入口二：每个框旁边的「记住这条」（「智能逐项填表」模式）。** 在这个模式里，面板上
「填入」的旁边还有一个「记住这条」——**当场就能记**，不用等填完。它默认不会再弹大型确认框：
如果「网申资料」里已经有这个字段，就直接更新它；没有就按当前表单字段名新增一条自定义字段。
面板会在旁边用小字提示实际保存位置，你之后仍可在资料页修改。它同样支持**认得出、但简历通里
还没填**的框（比如规则认出了「研究方向」、而你资料里是空的）。

> **它只写「网申资料」，碰不到「我的资料」。** 这一条是刻意的，不是还没做：简历资料会被
> 生成进简历正文，在网申页面上顺手按一下就改掉自己简历里的内容，代价太大。要补简历资料，
> 请到「我的资料」自己改——那里有完整的表单和确认。

记住的目录字段下次会按字段识别结果直接参与填表；自定义字段也会保存在「网申资料」里。
普通模式下，自定义字段标签与唯一预设字段标签/同义词完全对应时可复用；开启放宽模式后，文本框
还会按字段自述、别名与附近上下文尝试匹配。候选不唯一、字段区块不符或资料值为空时不猜；放宽匹配
只靠弱上下文的放宽文本匹配会标记为低置信度、「需确认」且默认不勾选；你核对后可以手动勾选。无法匹配的字段仍可在
「换个资料…」中搜索后手动填入。

**资料复用**：网申资料现在统一按通用资料参与填表；历史记录里的「场景 / 本次」标记只为兼容旧数据，读取时会自动归一为通用，不需要再为每家公司选择档位。

| 档位         | 下次填表时                                         |
| ------------ | -------------------------------------------------- |
| **通用**     | 自动预填。网申资料中的所有已保存值都按通用资料使用 |
| **历史档位** | 旧数据读取时自动归一为通用，不再让用户选择         |

**记住之后在哪里看、怎么改：** 就在上面这张「网申资料」卡片里。学到的那些带一个
**「填表时学到的」**紫色标记，点开可以看到它的来源；档位随时可改，
**清空那一格就等于删掉它**——删掉后下次填表会重新问你，这是你反悔的出口。

**AI 认出来的会单独标「AI 认的」**：填表时可以开「AI 字段识别辅助」，由它判断某个框
是什么字段。它比规则更可能认错，所以这类值在弹窗和列表里都单独标出来，让你核对时多一分怀疑。

#### 清单外的自定义字段

上一段说的都是**预设清单里**的栏目（学号、身高、紧急联系人……）。但你也可能碰到清单里
根本没有的框（某家特有的「导师姓名」「意向事业部」）。这种也能记：按下「记住这条」，它会被
存成一条**自定义字段**，在「网申资料」里带一个**「自定义字段」**青色标记。

如果程序识别错了字段名，可以在侧栏「记住这条」里直接改字段名，再选择更新已有的网申资料字段或新增到自定义；
之后也可以回到「我的资料 → 网申资料」继续修改或删除。这里不会直接修改会进入简历正文的「我的资料」。

**要说清楚它的能力边界**——它和清单里的字段不一样：

- ✅ **存得下**、在「网申资料」里**看得见**、**能自己填**、填表时能在「换个资料…」里**搜到**；
- ✅ **放宽模式下可参与受约束的标签/上下文匹配**，批量预览、逐框建议和悬浮球快捷填充共用同一匹配器；
  字段区块与记录序号可判定时按序配对。
- ⚠️ 匹配仍可能出错。结果会标记低置信度并要求你核对；同等候选、他人信息、已填写控件和安全否决项
  不会被强行猜填。普通模式保持保守，仅支持唯一精确标签对应。

批量预览、「智能逐项填表」和悬浮球「自动填写当前页面」都采用同一套放宽匹配规则；已有预设字段值
优先。自定义字段的别名就是你保存的显示名称，无需另加“我的资料”字段。无法唯一判断的自定义项仍可
在「换个资料…」里搜索并手动填入。

> 如果你发现某个自定义字段其实很常用、值得自动填，可以把它加进预设清单——那是改
> `backend/app/services/webform/fields.py` 里的一张常量表，加一行就行（详见维护手册）。

**不会学的东西：**

- **简历资料里的字段**（姓名、手机号、学校……）永不会被"学"进来。它们要么已经在简历通里
  （不需要学），要么该去「我的资料」补。学习**只服务「网申资料」这一区的字段**。
  这条不只是"界面上不提供"：程序里**根本没有能改简历资料的那段代码**，所以哪怕页面被篡改、
  伪造了一个目标，也落不下去。
- **密码、验证码、他人信息**走的是"永不自动填"那条线，根本进不了学习这一步。

**边界不变**：学来的和手动录的一样，**只存本机、不进简历、不进分享包、助手读不到**。
唯一不同的是这张表会**自己长大**——所以来源标记和档位开关是这个功能的安全阀，
不是装饰：手滑记住了一个错误的值，你得能一眼看到它、改掉它、删掉它。

## 7. 求职进度

侧栏 **求职进度**（在「投递台」之后）回答的是另一个问题：**投出去之后，对方走到哪一步了**。
投递台记录的是动作，这一页记录的是结果。

一家公司一个岗位只有**一条记录**，它走这样一条线：

```
已投递 → 筛选中 → 测评/笔试 → 面试 → Offer
```

另有 **已结束**（拒信、流程终止）和 **待确认**（材料里说不清楚）两个状态，它们不在这条主线上。

### 记录从哪来

- **投递台投成功的岗位会自动记一条「已投递」**，不用手工再录一遍。
- **从通知导入**：把招聘邮件、短信或站内通知的内容粘进来，也支持按 Ctrl+V 贴截图或上传
  pdf/docx（与岗位识别同一条链路，一次最多 4 个文件）。识别出来后是**预览**——每条写明
  「新增记录 / 更新进度 / 已是最新，未改动」以及**原因**，你勾选确认之后才会写入。
  关闭或取消预览不会写任何数据。
- **手动添加**：自己填公司、岗位、状态和日期。
- **渠道与关联（选填）**：编辑表单里可以选**投递渠道**（内推 / 官网 / 招聘平台 / 猎头等，
  不确定就保留「未知」——它不会替你猜），还可以把这条进度**关联到资料库里的一个岗位**；
  关联后岗位详情能看到这条进度。渠道是"从哪投的"，和"记录怎么进系统的"（记录来源）是两回事。

### 状态变化的留痕与统计

从 RF-18 起，**每一次状态变化都会留一条事件**（什么时候、来源、原来什么状态、变成什么状态、
是否经过你确认），拒信也留——事件是追加的，终态不会抹掉"曾经到过面试"这样的历史。功能上线
**之前**的旧记录没有事件，也不会被回填或猜测，统计页会如实说明覆盖率。

### 合并规则（两条是硬性的）

1. **状态只会前进，拒信除外。** 乱序粘贴一封三个月前的「申请已收到」，不会把已经在面试的
   进度打回去，界面会说明「这条通知更早，保留现有进度」。收到拒信则直接覆盖当前状态。
2. **普通自动回执不会被读成面试或 Offer。** 「感谢投递」「简历已收到」只会记成「已投递」；
   材料里说不清楚的一律标成「待确认」，等你自己判断。识别不出来时宁可不给结论，也不给一个
   看起来笃定、实际是猜的状态。

合并按**归一化后的「公司 + 岗位」**匹配——去空白、统一大小写、全角转半角。**只做这几件事**：
再加"去掉「有限公司」后缀"之类的规则会把「示例科技」和「示例科技有限公司」合并到一起，
而错误合并比留两条重复更难收拾。

### 看什么

- 顶部五个数字：总数、进行中、本月投递、Offer、已结束。
- **漏斗条**每一级都可以点，点一下就是按那一级筛选。
- 每条记录上的**下一步与截止日期**过了会标红——秋招最容易漏的就是"9 月 20 日前确认面试时间"
  这类带 deadline 的事。
- 「依据」那一行是这条状态从哪句话看出来的原文摘录，方便你核对识别得对不对。
- **导出**：按当前筛选导出 CSV（带 BOM，Excel 直接打开不乱码）或 JSON。
- **日历提醒**（页内「提醒」面板）：给某条进度、某次面试或内推设一个到点提醒，支持**列表 / 月历**两种视图切换（月历按日期把提醒聚合到格子里），按时间升序排
  "接下来要做什么"；过了时间会标出来，不会默默消失。**月历里点任意一天的小方格，会弹出那一天的完整安排**（标题、类型、状态、时间与备注）——首页「近期提醒」切到月历时行为完全一致。首页也会展示近期提醒并按**紧急度分色**
  （逾期 / 24 小时内 / 3 天内）；不想每次启动都弹，去「设置 → 应用」里关掉「打开应用时弹出提醒」。

侧栏另有一个 **求职统计**（在「求职进度」之后），按四个主题分组：

- **转化与卡点**：六阶段漏斗，以及"进行中 / 超过 7 天没有更新 / 没有下一步"三个数。
  注意「超过 7 天没有更新」指进行中且 7 天内**没有任何改动**——改一条备注也算更新，
  所以它不等于"面试卡住了"。
- **时间与节奏**：月度投递趋势（可选**近 1 / 3 / 6 个月 / 1 年**）、周内投递分布、
  「最近 7 / 30 天新增」，以及待办提醒按紧急度分档。
- **渠道与去向**：内推转化率与内推状态分布、投递最多的公司，以及记录来源。
- **真实时间线**：基于状态变化留痕的**阶段转化**与**阶段耗时**（RF-18）。每张卡都写明
  分子 / 分母（"到下一阶段 2 / 到过本阶段 4 条记录"），样本少于 5 条会亮"仅供参考"徽标；
  **只用事件记录功能上线之后真实发生过的状态变化**——更早的历史记录不回填、不猜测，
  会如实说明"有几条早于事件记录功能，无阶段数据"。它只描述过去，不预测任何"用了会更好"。
- **简历与健康度**：简历份数、带一致性提醒与带【待补】的份数、待确认主张、投递关联简历的覆盖率。

**有一件事必须知道**：月度趋势与周内分布只统计**填了「投递日期」**的记录。投递台的自动记录
会自己填今天，手动添加的记录需要你自己填（表单里有一键「填今天」）。没填的记录不会被算成 0，
统计页会点名"有几条未填、未计入"，补上日期即可。

它是**总览**，不替代这一页逐条跟进。

## 8. 模拟面试

左侧导航 **模拟面试** 是"有固定流程的角色扮演"：面试官按你设定的类型、难度与轮数提问，逐轮点评
并追问，结束后给出一份评分报告。它与 **求职助手** 的分工是——助手随问随答，模拟面试按流程走并出分。

### 开一场面试

1. **关联材料**：岗位与简历**两侧各选一种来源**——「从我的记录选」（岗位库里的岗位 / 简历中心的简历）或「导入文件」。岗位侧吃 PDF / TXT 的 JD（本地抽文本，10 MB 内），简历侧吃截图（走视觉模型逐字抄录）；导入成功会显示文件名与字数，识别不出来会明确提示。材料存成这场面试的快照，之后把原记录删掉也不影响这场面试；
2. **面试类型**：技术面 / 项目深挖 / 行为面（STAR）/ HR 面 / 综合面 / 案例分析 / 英语面试 / 压力面；
3. **难度**与**面试官风格**（严谨专业 / 温和引导 / 持续追问 / 压力质询）；
4. **轮数**：3-12 轮，默认 6 轮；轮数由程序控制，界面上"第 N/6 轮"是准确的；
   也可以打开 **自动轮数**——面试官按你的表现在 3–9 轮之间判断何时收尾（表现好多追问、
   没可问的按时收束），界面上只显示"第 N 轮"，不提前剧透还剩几题，更接近真实面试的不可预期；
5. **考察重点**与**自定义面试官人设**（选填）：例如"某大厂后端团队负责人，喜欢追问性能指标与故障处理细节"。

### 作答与复盘

- 一次只问一个问题；答完后面试官先给**80 字以内的点评**（好在哪、最值得改的一点），再问下一题。
- 答不上来可以直接写"不知道"，面试官会给这类问题的回答思路，然后继续问下一个。
- 达到计划轮数会自动收尾（自动轮数模式下由面试官按表现收尾，最迟第 9 轮强制结束）；也可以随时点 **结束并出报告** 提前结束。
- 报告包含总分、四个维度（技术/专业能力、表达与结构、岗位匹配度、应变与深度）的评分与依据、
  做得好的地方、可改进的具体建议和一段总评。
- 点 **把这场面试存进资料箱** 会把问答记录与报告整理成一份 Markdown 存进资料箱的「面试复盘」
  分类；之后可以让求职助手读它、总结薄弱点、生成改进计划。
- 报告下方还有一块 **追问** 区：面试结束后想就某个回答再深挖时用它。**追问不占正式轮次，也不计入评分报告**——追问两轮、关掉页面再回来继续，轮次读数与报告都不会变。追问区支持「停止追问」收起输入框、之后可「继续追问」重新打开；收起后直接调接口会被拒绝（409）。

模型调用失败时报告会写明原因，问答记录仍然保留，可以存进资料箱或重新开一场。面试记录与报告
都存在本机数据库，`DELETE` 只删除记录本身。

同一页还有两个面试相关的页签：

- **题库**：按关联岗位与资料生成 **基础 / 项目深挖 / 反问 HR** 三类个性化题目，适合提前自测；
  也能给**单题生成详细参考答案**，先自测再对照。生成出的题库可以**保存成历史**，之后回看或删除。
- **面试全流程**：把真实面试中被问到的问题录进来，让 AI 分析你的回答与岗位匹配度，再**反向优化
  简历**；面试中收集到的题目和心得可以沉淀进 **面经**（页内「面经」页签），下次回看。全流程的
  复盘也可以**保存成历史**，随时回看或删除。

## 下载后被提示「有风险」怎么办

- 压缩包里**没有任何可执行文件**（没有 `.exe` / `.msi` / `.dll`），解压出来是源码、启动脚本与文档。
- 首次启动会联网下载 Python 与 Node.js 的**便携版**（放在项目自己的 `runtime/` 里，不装进系统）——
  "下载并执行运行时"是杀毒软件启发式规则会关注的行为，也是唯一可能触发提示的地方。
  下载走官方地址 HTTPS，并校验官方 SHA256 摘要后才使用；终端里全程可见。
- 想核对文件有没有被动过：每次发布都随包附带 `.sha256` 校验文件，Windows 用
  `Get-FileHash <文件> -Algorithm SHA256`，macOS / Linux 用 `shasum -a 256 <文件>`，对一下即可。
- **不要**为了安装而关闭杀毒软件或加白名单。先核对摘要；若一致仍被拦截，把文件名与日志发到
  Issues 或群里——那是需要修的问题。

## 常见问题排查

### 窄窗口找不到侧栏，或者列表提示加载失败

窄窗口使用「打开导航」，原侧栏收进抽屉；「我的资料」、资料箱、知识库和收藏夹等入口在页头「我的空间」。
回收站分类较多时，在分类栏内横向滚动即可。宽表格只在表格区域内横向滚动，不必缩小整页。
列表显示错误时先检查本地后端是否运行，再点「重试」；筛选和编辑草稿无需重新填写。
「我的资料」读取失败时会暂停编辑与保存入口，重试读回原资料后再编辑即可。
如果是弹窗保存失败，先按提示处理原因再保存，关闭弹窗前可以复制正文留存。

### 「我的资料」里的板块不见了，或新建简历没有某个板块

先看资料页顶部的「已隐藏的板块（N）」：板块的隐藏 = 从当前方案板块清单移出，隐藏后整块不显示、
也不参与生成 / 导出 / 网申；点「显示」即可恢复。当前方案只剩基本信息时，页面会直接给出这个清单入口。
新建简历的页签跟随当前方案：当前方案没有的板块不会显示输入框，切到包含它的方案再打开即可；正文里已经有
内容的板块会始终保留。如果是在另一个窗口刚改过资料，打开着的界面会自动刷新；出现「我的资料已更新」
提示时，按需选择「用最新资料覆盖」或「保留当前编辑」即可。

### 添加自定义字段时提示「内容已在其他窗口修改」

这是旧版本的必现误报（字段设置把板块定义的 revision 当成工作区 revision 传给后端），已修复：
现在只有资料工作区真的在别处被改过、revision 不一致时才会提示。遇到提示时按提示刷新页面比较后
重试即可，已保存的内容不会丢。

下面列的是常见现象与对应处理。如果你想**把报错或疑问直接抛给任意 AI 来排障**，先让它读 [docs/ai-troubleshooting.md](ai-troubleshooting.md)——那份文件规定了 AI 必须先读哪些文件来"动态发现功能"、要遵守哪些硬性约束、以及按什么路径排查，能避免它凭记忆硬答。

### 双击 stop.cmd / stop.command 没反应，服务还在跑

先确认双击的是**当前这份代码目录**里的停止脚本（不是旧解压目录里的）。停止时会先按启动记录
找进程；没有启动记录时（例如实例是被别的窗口或脚本直接拉起的、记录文件被清理过、或刚启动还没就绪）
会按「端口 + 启动命令特征 + 健康检查」识别当前的简历通再停；健康检查暂时不可用、但进程确实来自
当前项目目录时也会停（先等几秒），其他程序一律不碰。如果输出「没有发现正在运行的后端」，说明它确实
已经退出，或占用默认端口的不是简历通（可按提示里的端口用任务管理器、或 `lsof -nP -iTCP:8005 -sTCP:LISTEN`
查看）；「前端没有需要停止的独立进程」是正常现象——发布包默认由后端同源提供页面，本来就没有单独的 Vite 进程。

### 不会用 GitHub，或者根本装不上

GitHub 的 Release 页面对不写代码的人来说是一道真门槛。**把这份工作交给 AI 就行**：

1. 把仓库地址 `https://github.com/magicapple123/ResumeForge` 发给任意 AI 助手（ChatGPT、DeepSeek、
   豆包、Claude 都行），说一句「我想用这个软件，请一步步教我怎么装」；
2. 已经下载好压缩包的话更简单：**直接把 zip 文件拖进对话**，让它带你解压、并指出该双击哪个文件
   （Windows 是 `start.cmd`，macOS 是 `start.command`）；
3. 也可以让它先读 [docs/ai-troubleshooting.md](ai-troubleshooting.md)，那是专门写给 AI 的排障入口；
4. 项目交流群里（群号见 [README](../README.md)）也放了安装包，GitHub 下载慢时可以直接从群里取。

### macOS：双击 start.command 没反应，或提示「无法打开」

先分清是两种情况：

- **提示「无法打开，因为 Apple 无法检查它是否包含恶意软件」**：这是 macOS 对"从网上下载、未经
  Apple 签名"的程序的标准拦截，不是代码问题。**右键点 `start.command` → 选「打开」**，再在弹窗里
  点一次「打开」，只需一次；或者在「终端」里进入项目目录执行 `xattr -dr com.apple.quarantine .`。
- **双击完全没反应**（连弹窗都没有）：多半是解压工具丢掉了可执行位。在「终端」里进入项目目录后执行
  `bash start.command`，效果与双击完全一致。

另外两种情况容易被误认成"卡住了"：**首次启动会下载便携版 Python 与 Node.js（合计约 70 MB）**，
然后再装几百个前端依赖，慢是正常的，窗口里会逐步打印进度；**端口被占**则会明确报出是哪个端口、
被谁占着（`lsof -nP -iTCP:8005 -sTCP:LISTEN`），换端口即可：
`bash scripts/macos/start.sh --backend-port 8010 --frontend-port 5180`。

### 桌面安装版：启动失败时该怎么办

装好的桌面版（Windows `Setup.exe` / macOS `dmg`）如果启动过程中后端没能起来，会在启动画面上
停住并弹出一个对话框，给两个按钮：

- **打开日志目录**：直接打开存放诊断日志的文件夹，里面有 `desktop-main.log`（桌面壳每一步的判断）
  与 `desktop-backend.log`（后端自己的输出，含报错栈），可整份提供给维护者；
- **退出**：这一次启动确实已经失败，两个按钮都会关掉应用——不必在托盘里找它，也不用担心它
  还在后台占着端口（同一个应用只允许一个实例，卡住的进程会让下一次双击打不开）。

日志的位置在用户目录下，常见路径是 `%LOCALAPPDATA%\ResumeForge\runtime\logs`（Windows）与
`~/Library/Application Support/ResumeForge/runtime/logs`（macOS）。**能正常打开应用时**也可以从
「设置 → 应用 → 帮助与诊断」导出诊断包，里面会自动带上这两个文件——上一次启动就算失败了，
这一次打开时导出也能把上一次的证据带出来。

### macOS：启动失败，想看看到底哪一步出错了

启动器失败时会把**日志的最后几行直接打印在窗口里**，窗口也不会自动关闭，可以从容读完再截图。
完整日志在 `runtime/backend.stderr.log` 与 `runtime/frontend.stderr.log`。手工排查顺序与 Windows 一致：

```bash
bash scripts/macos/start.sh --no-browser      # 不开浏览器，专心看输出
bash scripts/macos/stop.sh                    # 收尾，清掉这次的进程
```

### 求职统计里的投递趋势 / 周内分布是空的

这两张图按**投递日期**统计，而日期是要填的：投递台的自动记录会自己填今天，**手动添加的记录
不会**（刻意不预填——补录三周前的投递时，替你填今天会把那条记录钉在错误的月份上）。统计页会
点明"有 N 条未填投递日期、未计入"；去「求职进度」编辑那几条记录、点一下表单里的「填今天」，
或直接填真实日期，图就会亮起来。**只填了日期的记录才进这两张图**，其余统计（漏斗、转化率、
进行中、公司榜）不受影响。

### 网申填表：读取后没找到可填的字段 / 某个下拉没填上

**读取后一片空白**，先确认浏览器窗口里停的是**要填的那一步**——停在登录页、岗位列表页，
或者表单还在折叠区里没展开，读到的自然都是登录框和导航控件。走到填表那一步再读一次。

专用浏览器里的悬浮球展开后，点「**自动填写当前页面**」是主界面「读取当前表单 → 核对后填充」的快捷入口：
它会在后台读取当前页，复用同一套字段匹配、日期转换与冲突保护，按识别到的安全字段逐项写入，并在球旁显示进度、
完成或失败原因；它不会代替你提交表单，页面里已经有内容的字段默认不覆盖。页面同时出现多个相邻候选标签、
无法确定当前框属于姓名还是手机号时，程序会留空并提示你核对，不会按标签长度猜测。
放宽模式下，精确控件标签或能按数量和页面顺序配对的重复经历可自动填写；只靠弱上下文得到的低置信度候选
会标成「需确认」、默认不勾，须由你核对后再勾选。自定义字段用「网申资料」中保存的标签参与同一匹配流程。
填表过程中对岗位要求、某个字段该填什么有疑问时，展开菜单里的「问历历」可以直接提问，历历会给出简短的
定性回答（不给匹配度百分比，也不会替你提交或索要凭据）。

**某个下拉框没填上**，先看它是哪一种：原生联动下拉如果页面声明了联动关系，程序会在父级选中后
等待并重新读取当前选项，再按目标页面的 `value` 匹配；如果它仍没有对应选项，会如实说明。自定义
弹层/省市区级联组件不能靠直接写 `.value` 生效，程序会提示你自己点选；选完后再「读取当前表单」
（开启放宽模式后程序会尝试代点其中可匹配的下拉，见上文「例外：放宽模式」）。

**标着「冲突」的行没被填**是刻意的：页面上已经有值了，程序默认不覆盖你可能填了一半的草稿。
确实要用资料里的值，自己在预览里把那一行勾上。

**标着「待确认」**说明值写下去了、但回读页面时对不上——有些表单的输入由前端框架接管，
值看着在、内部状态没更新。程序会先自动重试（最多两轮；重试前先看一眼页面现状：值已经在就判
成功、已被别的值占住就不覆盖、单选已勾上就不再点），仍对不上的连同原因一起列在填充结果里。
这类请到窗口里亲眼确认一眼，必要时手动改。

**「未识别字段智能辅助」是灰的**，说明还没配置大模型。到 **设置 → 大模型配置** 填好
`Base URL` 与模型名并保存，开关就能用了。

**开着 AI 但认不出的框还是没进「将填入」**，看它落在哪一栏：

- 还在「没认出来」——模型也说这些字段都不像（面板上会写原因）。点「换个资料…」自己挑。
- 在「资料里还没有」——**AI 认出来了**，只是你资料里没填这一项。点「去我的资料补上」。
- 提示"页面上的选项没有对应的值"——AI 认出来了、资料里也有，但这个下拉框里没有那一项
  （常见于公司把"学历"分成自己的几档）。在页面上自己选一下。

**内推码等「本次」档位的值没有出现在整页模式**是预期行为：它不参与整页批量预填；在「智能逐项填表」里，识别到对应字段时仍会作为候选显示，需你手动点「填入」。

**提示"问 AI 的次数已用完"**：每个页面最多问 30 次，防止在一个长表单上无节制地花钱。同一个框
来回点只算一次。关掉再开一次「智能逐项填表」会重新计数。

**面板挡住了别的字段**：按住面板空白处拖走即可。拖开之后它仍然跟着输入框走——记住的是相对
那个框的偏移，不是固定坐标。

### 自定义模型连接失败

确认模型标识正确、服务需要鉴权时 API Key 有效，且远程地址使用 HTTPS。
`Base URL` 不应包含账号、密码、查询参数或 URL 片段。先在设置页测试当前表单，再保存配置。
报 404 或 400 时先看「接口协议」是否与服务商匹配：走 OpenAI 兼容接口的服务商要选「OpenAI 兼容」，
直连 Claude 官方接口要选「Anthropic 原生」并把 `Base URL` 填成 `https://api.anthropic.com/v1`。
如果提示「模型没有返回正文」，说明请求有响应但没有可用答案，不能据此判断配置可用。
先获取当前账号的可用模型并核对名称；若模型无法关闭思考，换一个支持短回复的模型再测。

### 识别后的字段不准确

保留招聘原文，先核对职责和要求的章节标题，再手动修正草稿。不同网站可能把岗位编号、部门、
城市和发布日期压缩在同一行，规则无法确认的字段宁可留空也不应猜测。

用截图识别遇到问题时，先展开结果上方的 **「查看模型识别到的原文」**：如果模型把「技术栈」看成了别的字，
或把页面导航文字也抄了进来，多半是截图本身的问题——换成清晰、只框住招聘正文的截图再试，
通常比手工纠正更快。

### 截图识别提示「当前模型不支持图片输入」

说明所选模型只接受文本。到 **设置 → 大模型配置** 换一个支持图片输入（多模态）的模型再试；
此时表单不会被填入任何内容，但之前手填的字段也不会被清空。若提示的是「未配置大模型」，
按上一节完成配置即可。图片本身的限制是单个 2 MB、合计 5 MB——手机拍的招聘展架照片容易超限，
截图一般远小于这个体积。

### 上传图片提示「内容与扩展名不符」

说明这个文件的**名字和真实内容不是一回事**：Windows 只看扩展名，所以浏览器会把它报成 `image/jpeg`，但系统读到的字节并不是 JPEG。最常见的原因是图片站按浏览器偏好返回了 WebP（另存下来名字仍叫 `.jpeg`），也可能是文件被改过名。

**这类文件不用改名，直接上传即可**：系统会按内容判定真实格式并照常识别，附件上会附一句「文件实际是 WebP，已按真实格式处理」告诉你发生了什么。只有在真实格式**不受支持**时才会被拒绝，此时提示里会写明真实格式和处理办法：

- HEIC/HEIF：先在手机、系统相册或图片工具里导出为 JPEG。
- AVIF：先导出为 PNG 或 JPEG。
- 「也识别不出它的实际格式」：文件可能已损坏或被截断，重新导出一次。
- 「实际看起来是 PDF / ZIP 压缩包」：那是一份文档，改名为 `.pdf` / `.docx` 后按文档上传。

（个人照片是唯一的例外：**设置里的简历照片仍要求扩展名与内容一致**，遇到这种情况请先另存为 PNG/JPEG/WebP。）

### 上传的文档没有被识别出内容

先看提示文案：

- **「没有从这份文件里提取到文字」**：这份 PDF 是扫描件或纯图片文件，没有文字层。它会自动
  把页面转为图片走 AI 视觉识别（与截图上传同路径，单份最多 8 页；需要多模态模型）。
- **「文件有密码保护」**：先解除 PDF 密码（用阅读器另存为一份不加密的副本）。
- **「文件不是有效的 docx」**：文件其实是旧版 `.doc`，或者扩展名被改过。用 Word 另存为
  `.docx` 或 PDF 后重新上传。
- **「文档内容较长，本次只识别了前一部分」**：文档文字超过了一次识别的上限，把剩下的内容
  复制成文本粘贴进输入框再识别一次即可。

文档识别不需要模型也能工作（文字在本机提取，本地规则照样解析），所以「未配置大模型」时
文档仍会参与识别，只是准确性低于 AI 识别。

### AI 功能提示未配置或输出中断

回到设置页测试当前配置。最大输出 Token 默认就是「不限制」（由服务商决定上限）；若你手动设过
上限、又出现输出过长，可适当增加该值，或勾选「不限制」交由服务商决定上限——「不限制」并非真的
无限，部分服务商的默认值可能比手动设置的值更小。推理型模型会把
思考过程计入输出预算，预算偏紧时正文可能被挤空，这种情况优先考虑「不限制」或更大的值。网络或
模型响应较慢时可增加超时时间；这些参数都会影响成本或等待时间，不会提升模型本身的能力。

**已知限制：原生 Anthropic 接口 + 思考强度 + 多轮工具调用。** 若把 `api_style` 设为 anthropic，
又开着**助手页的**「思考强度」，而一次回答里模型需要**先调用工具、再基于结果继续回答**（多轮工具），
第二轮请求可能被服务端以 HTTP 400 拒绝（界面提示「请求格式错误」）。原因是官方要求开启扩展思考时把
上一轮的思考块原样回传给下一轮，这一步当前尚未实现。遇到时把「思考强度」调回「关闭」再试，或改用
OpenAI 兼容协议的服务商即可；只回答、不调用工具时不受影响。设置页的「思考模式」也走扩展思考，但
它作用于**不使用工具**的那些调用（简历生成、岗位解析等），所以不受这条限制。

### 预览显示一页，打印／导出却多出一页，或者技能标签的小框不见了？

这两个问题都已经修好，原因也值得说明，免得你再怀疑是自己哪里操作错了：

- **多出一页**：以前有两层"让它看起来更小"的处理——给内容加一层 `transform: scale()`（只改变**看起来**
  的大小，不改变排版参数，而打印与导出按当前排版设置分页），以及按比例压小字号。后者更隐蔽：滑杆上是 18px，
  纸面上却是 9px，你调的参数与看到的结果对不上。现在两层都去掉了：字号、行距、页边距一律按你设定的值
  渲染，装不下只会**如实提示并截断超出上限的部分**，不再替你缩小字号。
- **小框不见了**：浏览器**默认不打印背景图形**，而技能标签的底色属于背景；应用已显式要求保留，
  **不需要**你去打印对话框里勾选「背景图形」。「导出 → PDF」由服务端导出引擎生成（不经过浏览器），
  标签同样按同样的比例画成带底色的圆角框。

另外，选 2 / 3 页时预览会把纸面**竖向摞成多张 A4**（每张页脚下方标着"第几页 / 共几页"），往下滚
就能逐页看；内容超出上限时**不会多排一页**，超出的部分直接不显示（草稿与精确同一口径）。它是**估算**，
不是真实分页——真实页数切到预览工具栏的**「精确」**就能看到（那正是导出引擎排出的 PDF），也可以
「浏览器打印」或「导出 → PDF」为准；打印 / 另存为 PDF 的分页受浏览器
`@media print` 的 `break-inside: avoid` 影响，可能与屏幕近似分页略有不同。两者对不上时，请以
「精确」或「导出」的结果为基准做对比，并把模板名与页数设置一起告诉我们。

### 下载的 PDF 看起来和预览不太一样？

以前确实会：直出 PDF 是后端**另一套排版引擎**，而它的行距、页边距、区块间距一度是写死在引擎里的，
既不读你在「版式」里的设置，也不看你选的模板——于是除 classic 之外的模板（modern /
elegant / technical…）行距会与预览差上一截，看起来更挤。现在这三项都改成**与预览同源**：默认取
所选模板的版式，你在「版式」里设过的 `line_height` / `page_padding` / `section_gap` 会覆盖
它；内容超出所选页数时**不会自动缩小字号**，而是按页数上限截断并如实提示"内容超出"。

需要注意：因为对齐了口径，**同一份简历的 PDF 外观会与早先版本导出的不同，页数也可能变化**——这是
正常结果，不是内容被改动。

### 点「下载 PDF」提示找不到中文字体

服务端生成 PDF 需要系统中文字体：Windows（微软雅黑/黑体/宋体）、macOS（PingFang）、
Linux（Noto CJK/文泉驿）的内置字体都在查找范围内。精简过的 Linux 环境可能一个都没有，这时：

- 用「导出 → 浏览器打印」，排版设置与预览完全一致；
- 或者设置环境变量 `RESUMEFORGE_PDF_FONT` 指向一个中文 TTF/TTC 字体文件后再启动后端。

### 想用指定字体排版简历

在「设置 → 应用 → 简历字体」里选一款字体。**内置的思源黑体按需下载**：点「下载」联网拉一份
（约 32MB，不占安装包体积；由 Adobe 发布，采用 SIL Open Font License 1.1，个人与商业文档均可免费使用），
下完会自动设为当前字体，也可以稍后在列表里点「设为当前」重新选它。下载中会显示进度、可以关掉设置页
（不会中断）；失败时界面会给出原因，点「重试」再试一次即可。字体**上传入口已下线**，升级前导入过的
字体仍在列表里，继续可用、可改名、可删除。**点字体名可以先预览**：
弹窗里用这款字渲染姓名、经历与中英数字示例，确认字形合适再点「设为当前」。删除收在每行的「···」菜单里
（带二次确认；字体文件是**直接删掉**的，不进回收站、界面上也没有恢复入口，正在用它的简历会回到系统字体）。
设置页写的是「用于预览、HTML 与 PDF」——三者用的是同一款字体：服务端按正文实际用到的字符做子集化后内嵌进预览与
导出的 HTML（一份十几 MB 的中文字体子集后通常只剩几十 KB，不会把整份字体塞进文件），所以离线打开导出的
HTML 也是同一字形，PDF 同样沿用它。没有可用字体时按系统字体渲染；字体文件损坏或子集化失败会自动退回系统
字体并照常渲染，不会让预览或导出失败。

**有不止一款字体时，还能让每一份简历各用各的**：预览工具栏（以及生成前的排版栏）里有一个「**字体**」下拉，
选中哪一款就只对**这一份简历**生效，下拉里的每个选项都用它自己的字形显示，挑的时候直接看效果。
还没下载的内置字体在下拉里是**灰的**（标着「未下载」），旁边写明去哪里下载——选中它没有意义，
因为磁盘上还没有那个文件。三个可用状态要说清：

- **没设过**（早先创建的简历）→ 跟随设置里那个「当前字体」，外观不会因为升级而变；
- **选了某一款** → 这份简历就用它；
- **「系统字体（不使用自定义字体）」** → 这份简历明确不用自定义字体。它与"没设过"不是同一件事，
  所以是一个能被选中的值，而不是"清空"。

字体只影响**预览、导出 HTML 与下载的 PDF**；Word 与 Markdown 不跟着变（它们的字体由打开它的软件决定）。
另外，这份简历选的字体文件如果后来被删掉了，它会自动退回"跟随当前字体"，不会打不开或导不出。

### 我删掉的东西还能找回来吗？

能。删除只是把内容移进侧栏的「回收站」，不会真的消失——在回收站里点「恢复」它就原样回来
（连同它与岗位等对象的关联关系）。只有你在回收站里点「彻底删除」（会再确认一次、并说明后果）
才会真正抹掉。回收站还能按类型筛选，并显示每条的删除时间，方便你找"前几天删掉的那个"。

两个常见疑问：

- **删掉之后，首页统计和搜索里为什么立刻就没有了？** 这是有意的：回收站里的内容不会出现在
  其它任何页面，否则你会看到"删了但统计里还有"这种自相矛盾的状态。
- **删掉的岗位，采集时会再收进来吗？** 不会。去重把回收站里的岗位也算"已存在"，任务文案会说
  "其中 N 条在「回收站」里"；想重新收进来，先去回收站恢复它（或彻底删除后再采）。

### 「补充事实」去哪了？

新版用 13 个板块统一收资料，**补充事实模块已下线**：论文 / 科研项目 / 专利 / 资格证照 / 语言能力
分别对应资料页的 **学术成果 / 科研项目 / 知识产权 / 证书资质 / 语言能力** 板块。旧补充事实的数据仍在
本地数据库与备份里，回收站里也能看到与恢复，但不再进入新的生成 / 新建 / 网申取数。培训与课程不再有内置
录入入口，需要时可在项目经历或教育经历下加自定义字段，或自建一个「培训与课程」板块。

### 升级后打开「我的资料」为什么是空的？

2026-10 的资料模型换代只加表、不迁移旧数据：旧版资料（旧的板块表与补充事实）**仍在本地数据库与备份里**，
但新资料页不再显示它们。这时页面顶部会出现说明条——点 **打开备份** 去「设置 → 数据」导出或查看备份，
或点 **开始填写** 从零录入新资料。旧资料不会因为升级被删除；需要旧内容时，从备份包里取出后手动重填即可。
新资料录入第一份有效内容后，这条提示会自然消失。

### 打开旧简历时提示「旧简历已转换」是什么意思？

旧简历保存的仍是旧版内容结构。打开时应用会**自动把它整理成新版字段结构**——只在内存里转换、不写库，
转换后**文字与条目都不会少**，只是纸面上的字段位置可能略有变化。提示条里：

- **查看转换摘要**：看这次识别了多少字段、保留了多少行原文、有没有警告或空板块；
- **收起提示**：先关掉，只隐藏本次会话（下次打开这份简历还会提示）；
- 直接编辑并保存：保存后这份简历就是新版结构，以后打开不再提示。

转换**只发生在你打开这份简历时**，应用不会批量改写你的资料库。

### 字段为什么没有出现在纸面上？

字段没印到纸上通常是三种情况之一，处理入口也不同：

- 在**制作台**里把字段的位置设成了「隐藏」：数据还在文档里，随时可以拖回标题行 / 元信息 / 正文前后灰字 / 正文；
- 它是**仅素材**字段（在「我的资料」的字段设置里勾了「仅素材」）：只用于 AI 生成与网申填表，本来就不上纸面；
- 你在「我的资料」里把这个字段**用户隐藏**了：它不参与生成与导出，但值保留、可随时恢复显示。

前两种在简历里改，第三种在资料页改。见上文「自建板块与自定义字段」与制作台的「条目字段位置」。

### 「文档大纲」去哪了？

它已改名为 **「本份简历结构」**：制作台左栏顶部在「排版参数」与「本份简历结构」之间切换。内容仍是
同一棵树——按板块列条目与要点，可排序、复制、隐藏、锁定；新增的是**按位置分组**（标题行 / 元信息 /
正文前灰字 / 正文 / 正文后灰字 / 隐藏），把字段拖到别的分组即可改变它在纸面上的去向；搜索、从纸面
定位后恢复滚动位置等能力照旧。

### 旧版本导出的备份能在新版本导入吗？

可以。导入时会先把备份里的数据库升级到当前版本再校验，所以旧备份（只要 revision 仍在迁移链上）
都能恢复；反过来，来自更新版本的备份会被拒绝并提示"请先升级应用再导入"，避免用旧代码打开新结构
导致数据损坏。备份包默认**包含**大模型 API Key（导出前可取消勾选剔除）：Windows 上存的是绑定当前
用户与机器的密文，换台电脑恢复后仍需重新填写并测试连接；非 Windows 上是明文，因此备份文件要当作
和数据库同级的敏感文件保管。

### 「自动采集」会抓取哪些内容？筛选条件都生效吗？

采集会访问招聘网站的搜索页，按关键词和城市翻页抓取岗位列表，**先放进备选岗位暂存区**（投递台的
「本次采集结果」）。你在那里勾选要留下的、点「导入选中的岗位」，它们才进入岗位广场并标注来源为
「岗位采集」。多个关键词逐个搜索并跨关键词去重；城市名会先转换成 BOSS 的城市编码，无法识别时明确报错。
关键词、城市和翻页由站点直接生效。**「按招聘网站的条件筛」那一块（求职类型 / 薪资待遇 / 工作经验 /
学历要求 / 公司行业 / 公司规模 / 融资阶段）也是站点直接生效的**：它们就是招聘网站筛选栏里的那几格，
选项清单读自网站本身并标明来源（你的登录会话 / 全网通用清单 / 内置快照），用之前会逐个校验编码，
对不上的不会发出去、而是标为「未能生效」。而「我的薪资 / 经验 / 学历」是**采集后按岗位字段筛的**，
筛掉多少会如实写在结果上方，没写这些字段的岗位会保留下来。采集只在你点「开始采集」后运行，
不会在后台自动抓取。

### 采集/投递跑到一半，我切到别的页面了，会中断吗？

不会。批次由**后端线程**执行，前端页面只是"看进度"的那只眼睛——切页、刷新、甚至关掉浏览器标签
都不影响它继续跑。回到「投递台」时，页面顶部的进度面板会接着显示当前批次（已处理 N / M、当前步骤、
以及**暂停 / 继续 / 停止**三个按钮），采集过程中随时可以暂停，暂停期间进度真的不会往前走。
批次进入终态（完成 / 失败 / 停止）时，无论你在哪个页面都会收到一条通知，点击跳回投递台。

### 采集跑完了，为什么没有弹通知？

通知的触发条件是"本会话里见过它进行中、随后它结束"。两种情况不会弹，都是刻意的：
**应用刚启动时那批早已结束的采集**（没有"完成"这个事件可报），以及**你在任务结束后才打开应用**。
另外，系统级桌面通知需要浏览器已授予通知权限；没授予时只有应用内通知，应用不会主动弹权限框。

采集时应用会优先读取招聘网站自己的接口数据，因此存下来的**岗位描述是完整版**、并且会按小标题把
「岗位描述」与「任职要求」分开存；薪资写法与你页面上看到的一致。个别情况下接口读不到，应用会退回
解析页面内容，岗位仍然可以导入（只是描述可能缺失），两种方式采集到的岗位对后续的匹配分析、简历
制作没有区别。

### 采集完了，岗位广场里怎么没有？

这是**有意为之**：采集把岗位放进「投递台 → 自动采集 → 本次采集结果」，要你勾选后再点
「导入选中的岗位」才会进岗位广场。采集条件本来就宽，采到的不一定都想要；把这步留给你，
比事后再去岗位广场一条条删省事。没勾选的会留在备选岗位里，随时能回来挑。

如果连「本次采集结果」里也是空的，看任务文案：说「没有找到匹配的岗位」就是关键词太窄；
说「已存在」就是采到的岗位都已经在库里了。

### 投递队列里「开始投递」为什么点不动？

三种情况：队列为空、队列里没有「待投递」状态的条目（已投出或已跳过的不能重复投）、或者已有一个投递批次正在跑。队列为空时页面上方的流程说明写了怎么把岗位加进来（岗位广场 → 岗位详情 → 加入投递台）；条目都不是「待投递」时，先刷新队列看最新状态；有批次在跑时，先在上方进度条里暂停或停止。

### 手动录入的岗位为什么加不进投递队列？

因为投递台是**在招聘网站页面上**完成投递的，所以它只接「来源或投递链接能归属到已支持站点」的岗位（目前是 BOSS 直聘）。纯手动录入、又没填招聘网站投递链接的岗位，详情里的「加入投递台」是灰的，旁边会写明原因；把它的**投递链接**改成该岗位在招聘网站上的地址，就能照常自动投递了——**不需要**非得用自动采集。若队列里还有一条早先加进去的这类岗位（那时还没有这个限制），它会在「岗位」列标红**来源不支持**、勾选框是灰的，按「开始投递」投整个队列时会被先拦下并点名；点它的「更多操作 → 移出队列」清掉，或只勾选要投的那几个再开始。

### 在 BOSS 上投递，为什么聊天里出现两条消息？

第一条是 **BOSS 平台的默认问候**：只要在 BOSS 上建立会话，平台就会自动发出一条开场白——这是 BOSS 自己的产品行为，任何外部工具都关不掉它。第二条才是**投递台帮你发送的招呼语**（「投递设置」里配置的那句）。投递台对每个岗位只发送一次招呼语，不会重复发送；看到两条消息不是把招呼语发了两遍。

### 模板预览里的示例简历是谁的？

那不是你的数据，也不是给你的简历——它是**排版示例**，用来让每个模板在没有内容时也能看到标题层级、条目间距与技能标签的排布。示例内容的岗位（市场运营）与技能（活动策划、Excel 等）是**通用示例**，与你的行业无关；生成你自己的简历时不会用到它，导出也不会带进去。

### 以前采集的岗位没有岗位描述，怎么办？

这多半是早期采集时详情页抓不到留下的（该问题已修复，但**已经入库的那几条修不了**——采集按投递
链接去重，重新采集会直接跳过它们）。去 **岗位广场** 点 **补齐详情**：它会重新打开这些岗位的详情页、
只补岗位描述。按钮只在当页有 JD 为空的岗位时出现；补的过程是一个后台任务，**进度和暂停/停止在
「投递台 → 自动采集」里看**。它只补空、不会覆盖你已经改过的内容，也不会碰回收站里的岗位；一次最多
200 条。个别岗位页面已下线时会仍然补不到，任务会如实说明"仍然抓不到"。

### 投递台提示「站点可能改版」，或采集完成了却读不出岗位描述？

这是**站点改版**的早期信号，不是你的操作问题。招聘网站改了页面结构后，采集可能**悄悄**出问题：任务还显示"采集完成"，却只能采到岗位列表、读不出岗位名或抓不到岗位描述（JD 为空）。投递台顶部的「当前招聘网站」在**连续几次**出现这种情况时会显示一条 **「站点可能已改版」** 的提示。

它的判据完全在后端，**基于最近 5 次采集**：只有 1 次记录时**不会报警**；**需要登录、验证码、网络超时、真的没搜到**这些**不算**改版——它们是环境或你这边的问题，单独处理即可（见上面几条）。提示里会写清**发生了什么**、**我们的推测**（站点**可能**改版了）以及**下一步**：**先重试一次**；如果一直这样，请到项目仓库反馈，并把 **「投递台 → 采集记录」里最近这一次批次**一并附上——维护者靠它更新站点的选择器。已经入库的空 JD 可以用岗位广场的 **补齐详情** 补回来。

### 采集抓不到东西 / 想帮忙改进解析时，怎么把站点原文给我？

当站点改版导致"采集完成却读不出岗位或详情"时，只凭一句"抓不到"维护者很难定位——他需要**站点接口真实的响应原文**。为此采集面板提供了一个开关：

1. 在「投递台 → 自动采集」里，勾选「开始采集」旁边的 **「保存本次抓到的站点原文（用于排查解析问题）」**（默认不勾），再点 **开始采集**，按平常的方式采集一次。
2. 采集结束后，任务文案会告诉你**本次存了几份、存在哪个目录**。文件就在本机 `backend/data/captures/<站点>/` 下（每份是一个 JSON）。
3. 把该目录里的 JSON 文件发到项目仓库的反馈里即可。它们**只包含站点返回的内容**（搜索与详情两个接口）与接口的 path，**不含你的登录凭据、请求头或 Cookie**，也**不会**被自动上传到任何地方。

这个开关**默认关闭**、每次采集都要你**显式勾选**；不勾选时不会创建任何目录或文件。样例只写在本机、**不进仓库、不进备份**，你也可以随时自行删除该目录。

### 投递台会自动帮我投简历吗？会上传我的什么信息？

只有你在投递台里把岗位排进队列、启动投递专用浏览器并点「开始投递」之后，它才会逐条自动投递。
目前只支持 BOSS 直聘，投递动作是站内「立即沟通 / 继续沟通」：应用填写你确认过的招呼语并发送，
使用的是 BOSS 账号自己的在线资料，不会因为缺少本地岗位版简历就直接跳过。投递专用浏览器是独立窗口，
**登录由你在窗口里自己完成，应用不保存招聘网站的密码或 Cookie**。遇到验证码或安全验证不会尝试绕过，
会明确失败并请你手动处理。

### 为什么提示需要先启动「投递专用浏览器」？

采集和投递都要通过一个由应用单独拉起的浏览器窗口来完成，它使用独立的数据目录、不会碰你的日常
浏览器。请先在「投递台」页面顶部点启动——**这个窗口启动时会直接打开招聘网站首页**，你就在那一页
扫码登录一次，然后再开始采集或投递。

如果启动后看到的是一张空白页，或你把标签页关掉、跳到了别处，点旁边的 **打开招聘网站** 即可重新
打开登录页，不用关掉浏览器重来。
新版升级后如专用窗口仍来自上一会话，请手动关闭这个旧专用窗口，再从应用重新启动，让新的本机调试安全参数生效；不要关闭日常浏览器。如果提示“浏览器已启动，但入口网页暂时无法打开”，窗口已经可用，检查网络后重试 **打开招聘网站** 即可。

想换浏览器跑这个窗口，去「投递设置 → 投递台使用的浏览器」选择：**自动（优先 Chrome）** 会优先用
Chrome、没装才回退 Edge；**Chrome / Edge** 表示只用这一个，**系统里没装会直接报错**而不会改用另一个
（你选了 Chrome 却启动 Edge 显然不是你想要的）；**自定义路径** 用于绿色版或非默认安装位置。选完立即
生效。

### 重启应用后，浏览器明明开着却提示「未启动」？

不该再出现了。投递专用浏览器是一个**独立的进程**：登录态存在它自己的专用目录里，**应用退出时也不会
去关它**，所以你关掉应用再打开，那个窗口通常还在。应用判断"它在不在跑"看的是**调试端口通不通**，
不是"这个窗口是不是我这次启动的"，所以重启后它照样显示「运行中」，采集和投递都能直接用，不必重新
启动、也不必重新登录。（只有真的没有窗口在跑时才会提示「未启动」。）

### 为什么「关闭浏览器」按钮是灰的？

因为那个窗口**不是本次运行启动的**——应用重启时会丢掉它的进程句柄。应用只关自己启动的窗口，**不会
按进程号去猜**（那有可能误关你自己的浏览器），所以这种窗口要你自己关掉。这**不影响使用**：状态照样
是「运行中」，采集、投递、打开招聘网站都正常，只是"关闭"这一步交给你。页面上会写明这一点。

### 提示「没有找到 Google Chrome / Microsoft Edge」怎么办？

这说明你在「投递设置」里把浏览器指定成了某一个（Chrome 或 Edge），但系统里没找到它。三种处理方式：
装上那个浏览器、把设置改回 **自动**（会自动回退另一个）、或改用 **自定义路径** 并填入浏览器可执行
文件的完整路径（必须是真实存在的文件）。**应用不会在你明确选了某个浏览器时静默换成另一个。**

### 采集明明没成功，却显示「共新增 0 个岗位」？

不会了。现在的行为是：**真的没搜到**（页面加载完成、只是关键词太窄）会正常完成并提示「没有找到
匹配的岗位」；**抓不到**（页面结构变化、需要登录、加载超时等）会让任务**明确失败**并给出诊断信息
——当前地址、页面标题、匹配到的控件数、期望控件。请把这段诊断反馈给维护者，用来更新站点选择器。
把"什么都没做"伪装成"完成"是被专门修掉的缺陷。

### 采集报「页面没有切换到目标地址」，但浏览器里岗位明明已经加载出来了？

这是**旧版本**的缺陷，现在不会了。原因是判定"页面是否已切到目标页"时要求地址与代码拼出来的目标
**一字不差**，而招聘站会把地址规范化（补默认参数、调换参数顺序、`/job` 跳成 `/jobs`），于是每一次
正常导航都被判成"还没切过去"，等满超时后报出这句话——而页面其实早就渲染好了。

现在的判定改成**"目标地址里的每个查询参数都在当前地址里取到相同的值"**：既容忍站点的规范化，
又仍然拦得住"还停在上一页"（`page=1` 与 `page=2` 的路径一模一样，只看路径会把翻页读成上一页）。
同时采集改成**逐级降级**：接口响应 → 卡片结构 → 只按岗位链接兜底，任一环拿到岗位就算成功；只有
三条路都拿不到时才会失败，且失败一定带诊断。

如果仍然失败，请把诊断里的**当前地址 / 页面标题 / 匹配到的控件数**发出来——那是收敛选择器的唯一依据。

### 采集/投递会不会开出一堆标签页？

不会。采集与投递全程**复用同一个标签页**导航，不会每采一页或每投一个岗位就新开一个标签页。

### 自动一页按了没反应，或者还是放不下？

三种可能，按概率排：

1. **内容确实太多了。** 一页 A4 大约能放 700~900 个汉字，超得太多时收到最紧也装不下——这时面板会明确说"排版参数已经收到最紧"，并建议精简内容或加页。
2. **排版参数已经到下限了。** 页边距 12mm、行高 1.4、字号 12px 是最紧的一组；如果你之前已经手动调到这些值，自动一页就没有可收的了，按钮也不会出现。
3. **那一档量出来还是超高。** 这是正常行为：它会继续试下一档。面板上会显示"正在试第 N/M 档：xxx"，试完十几档需要一两秒。

如果按完之后**预览变了但导出的 PDF 没变**，那是个缺陷，请反馈——预览、导出 HTML 和服务端 PDF 走的是同一份排版设置，三者应该始终一致。

### 保存时提示「这份简历已在别处被修改」怎么办？

说明同一份简历在另一个窗口或标签页里被改过，直接保存会覆盖那边的改动。按需要三选一：

- 想保留别人刚改的那版：点 **用最新的**（本地这次未保存的改动会丢，可以先「另存副本」留底）；
- 想先看差异：点 **比较差异**，确认后再决定；
- 两边都要：点 **另存副本**，本地这份会存成标题带「（副本）」的新简历。

### 「检查简历」面板在哪、会改我的简历吗？

在「简历制作台」顶部动作条上，点「检查简历」。它是**只读**的：只列问题、给位置与修复入口，不会自动改稿；修完再点「重新检查」复检。

### 辅助线、灰度校样会不会被导出？

不会。辅助线（页边距线 / 列边界 / 基线 / 段落边界）与灰度校样都只是**编辑画布上的覆盖层**，用来核对版面与黑白打印效果；它们不会进入任何导出的 PDF / Word / HTML。灰度校样也不会改动你的颜色设置。

### 撤销能退多少步？关掉制作台还有吗？

制作台左栏「历史」记录的是这次打开制作台以来的操作（内容、排版、结构各一步，连续输入合并成一步）。
点「撤销」一步步退回去，「恢复」再往前走；关掉制作台后从当前状态重新开始记录，历史不会跨窗口保留。

### 局部排版会影响别的段落吗？

不会。「调整排版」是按**你右键的那个字段**生效的对象级覆盖：改这一条的正文不会动别的条目；没单独设过的属性跟随模板，来源胶囊写明来自哪里，可逐项恢复继承。
整份简历的字体字号、行距、页边距与外观颜色在制作台左栏「样式」组；字段的位置与顺序在「本份简历结构」页签。

### 分页设置在草稿预览里为什么看不到？

草稿预览是按 A4 高度切的连续流，不是真正的分页媒体，所以手动断页在草稿里不显示、也不会画假分页线。
要看真实断页请切到「精确」（显示导出引擎排出的同一份 PDF），或直接导出 PDF。

分页控制可用：制作台左栏「版面 → 分页」按板块设置；条目级断页在「本份简历结构」选中条目后设置。面板里的「页面概览」点「获取分页报告」即按真实 PDF 同一条管线测量真实分页。

### 从表达资产插入的内容，会在资产改动后自动更新吗？

不会。插入时会在简历里生成**新的对象身份**，它和资产是两份独立内容；之后改资产不会回写已插入的简历，
反之也不会。要更新就用新资产再插入一次，或直接改简历里的那段。

### 对象批注会出现在导出的简历里吗？

不会。批注只存在本机数据库与分享包目录，不会进入投递用的 HTML / PDF / Word / Markdown / 纯文本 / 交付 JSON，
也不会自动外发；它只用于评审阶段逐条沟通。

### 采纳翻译会改掉我现在的中文简历吗？

不会。采纳只写入选中的**语言变体**；当前语言简历、其它岗位变体与已投递记录都不动。

### 翻译候选关掉后再打开还在吗？

不在。候选不落库，只用于预览与逐项采纳；重新打开「双语版本」需要再点一次「生成翻译」。

### 术语表删错了能恢复吗？

能。术语删除走回收站，可在回收站恢复。注意术语是**数据集级**、所有简历共享，删除前先确认它是否影响其它简历的译法。

### 命名版本能删除或改名吗？

不能。命名版本是不可变快照，只支持「冻结 / 解冻」标记；想换名字就再存一份。这样已投递记录始终对得上历史版本。

### 恢复旧版本会覆盖我现在的内容吗？

不会覆盖历史。恢复会把那份快照写成**新的当前版本**（revision 前进），历史版本和已投递记录保持不变；
如果当前简历刚被别的窗口改过，会先提示冲突，刷新版本列表后再恢复。

### 长 CV 切回普通简历，页数为什么会变？

普通简历上限是 3 页。从长 CV（最多 10 页）切回普通模式时，超过 3 页的页数会被自动夹到 3 页并给出提示——
这是模式本身的规则，不是丢内容；放不下的部分会按超页规则截断显示，先收紧排版或精简内容。

### 按条件优化版面为什么有时没有方案？

常见三种原因：① 「不动字号」加上「最小页边距」把所有候选都排除了；② 排版参数已经收到最紧，没有可再收紧的项；
③ 候选都试过仍放不下。界面会明确说是哪一种，不会假装成功，也不会偷偷把字号缩小——要更紧凑请手动调字号滑杆。

### 科研栏里的「在投」会被当成已发表吗？

不会。发表状态严格按你选的值显示与导出，「在投 / 预印本」不会被提升成「已发表」；导出与纸面读的是同一份内容。

### 内容显示「未建立来源关联」怎么办？

说明这条内容还没有绑定资料。旧记录不会按文字相似度自动猜来源（猜错比没有更糟）；在「来源核对」页签选中这条内容，点「建立来源关联」即可选择或新建来源。若顶部提示「有 N 条旧关联无法定位」，那是旧路径在当前正文里已经找不到对应内容——按提示删除旧关联，或选中目标块后点「重新关联」。

### AI 改写为什么被拒绝，还列出几个值？

这些值被「事实锁」保护（姓名 / 机构 / 时间 / 数字 / 职责边界）。服务端会拒绝这次改写并逐条列出「锁定值 → 想改成的值」与原因；
锁只约束 AI，你自己手动编辑不受限。确实要让 AI 改，先在事实锁面板解除对应锁定。

### 外发预览里的正文会被保存吗？

不会。预览正文只存在于本次响应与内存，不写 localStorage / sessionStorage、不写日志，关掉即丢；真正发送由你确认后才发生。

### 字号系数调了，HTML 里为什么看不出来？

不会了。此前「字号系数」只作用于服务端生成的 PDF，HTML 预览里毫无反应；现在它在渲染前就把系数乘进基准字号，所以预览、导出 HTML 和 PDF 三处一致。

需要知道的是：这一项**只有一个入口**（渲染前预乘基准字号），界面上的 CSS 覆盖里没有第二条路。这是刻意的——给两条路会叠乘，界面上调 1.1 会实得 1.21 倍，而这种偏差只有拿尺子量才看得出来。

### 岗位匹配度分析和「岗位需求解读」有什么区别？

「岗位需求解读」只读招聘原文，回答「岗位要什么」；「匹配度分析」会读取你的个人资料与简历，回答
「你够不够」，并给出已匹配 / 表达缺口 / 证据不足 / 真实缺口 / 待确认五类结论。两者都只在你点击后
才生成，结论本身都不带百分比；匹配分析另附 0–100 的「匹配度参考分」，仅作展示辅助、不参与投递准入
（见下一条 FAQ）。

### 「AI 对比选岗」和「匹配度分析」有什么区别？

「匹配度分析」一次看**一个**岗位，回答"这个岗位我够不够"；「AI 对比选岗」一次看**一批**岗位，
回答"这几个里哪个更适合我、为什么"，并给出名次与理由。它内部仍会先逐个岗位核对匹配情况，
所以不需要你先手动跑一遍匹配度分析。批量操作里的「匹配度分析」则是把单岗分析**逐个**跑一遍，
不会合成一份比较结论。

### AI 读我的资料时，读的是哪一份？

读的是「我的资料」里**当前选中的方案**，并且**不包含你设为隐藏的字段**——助手、岗位匹配、
AI 对比选岗、简历建议与审阅预检都是这一条口径。切换方案后，**新发起**的任务会自动跟随新方案；
**已经生成**的结论 / 简历不会被改写，它们各自保留了生成时的资料快照。

### 导出简历时说「还有未完成标记」不给导，怎么办？

说明简历正文里还留着 `【待补：…】`、`【待确认】`、`【待补充】`、`【待核实】` 这类标记——它们
是"这里还没写完"的意思，跟着 PDF 一起投出去就难看了。提示里会指出**具体在哪一节**，去「简历中心」
编辑那份简历，把内容补齐或把标记删掉即可。

只想导出一份草稿自查、并不打算投出去时，在弹窗里选 **仍要导出草稿** 即可；选 **我去改简历**
就什么都不下载。**只有这四种带方括号的写法会被拦下**，正文里正常出现的"待补充说明"之类不会被误伤。

### 事实台账为空，会影响我生成简历吗？

不会。台账为空时不会往生成提示词里加任何东西，生成行为与没有这个功能时完全一致——只有你确认过的
条目才会作为事实基线参与生成。换句话说，台账是"你不维护它就不生效"的东西，不会突然改变已有简历
的结果。

### 求职进度里同一条出现两遍怎么办？

正常情况下不会：记录按「公司 + 岗位」合并，同一组合只有一条。如果你确实看到两条，多半是公司名写
法不同（例如一条写「示例科技」、另一条写「示例科技有限公司」）——应用**刻意不去掉这类后缀**，
因为把两家真实存在的不同公司合并到一起，比留两条重复更难收拾。手工删掉或改名其中一条即可。

### 为什么粘贴旧邮件后进度没有变化？

因为**状态只会前进**。如果那封邮件说的是比当前更早的阶段（比如已经是「面试」了，又导入一封
「申请已收到」），应用会保留较新的结论，并在预览里写明「这条通知更早，保留现有进度」。
这是有意的：否则整理一次邮箱就会把进度冲回三个月前。只有**拒信**会无条件覆盖当前状态。

### 「从通知导入」说没有识别出记录，为什么？

识别需要材料里**同时**出现公司名和岗位名——缺一个就不知道该并到哪一条记录上，猜出来的进度
比没有进度更糟。常见原因是邮件里只写了"您的申请"没有写岗位，或者只截到了正文的一部分。
可以补上完整的邮件正文再试，或者直接点「添加进度」手动填。另外，没配置大模型时会用本地关键词
匹配，判断比较粗；配置模型后识别质量会明显更好。

### 匹配度参考分可信吗？

参考分是**本地规则估算**的 0–100 分，只用于帮你感知"差多少"，**不是任何权威评分**。它**不参与
投递准入**——「能投 / 需确认 / 不投」仍只由五类匹配结论决定，分数旁固定带免责说明（不代表真实
ATS 解析结果或投递成功概率）。信号缺失时给中性分（50）而不是把"没信息"误报成"不匹配"，所以低分
不一定等于你不合适——先看五类结论里具体缺什么。

### ATS 本地检测的结果代表真实招聘系统吗？

不代表。ATS 检测只在本机做**静态规则检查**（格式风险 / JD 关键词覆盖 / 信息位置三类），用于自查
常见格式与关键词问题，**不连接、也不模拟任何真实招聘系统的解析**，结果仅供参考、不构成通过保证。

### 质量检测为什么不再自动跑？关掉面板后扫描还在继续吗？

打开质量检测先看到的是一张说明卡（查哪几类、AI 增强会发什么、预计多久），点 **开始扫描** 才真正
发请求——这样"只是打开预览看一眼"不会再白等一次模型。关掉面板**不会中断**扫描：它会继续在后台跑，
会有一条带「取消」的常驻通知，完成时提示「共 N 条风险点」，失败也会通知；回来再打开面板看到的
是上次结果，不会重新请求，简历内容改过则会提示「建议重新扫描」。开着 AI 增强时最多等 45 秒，超时会
自动降级为纯本地规则的结果并写明"AI 增强超时"，不会一直转圈。

### 「岗位优化建议」为什么打开后没开始生成？关掉窗口会白跑吗？

打开弹窗先看到的是一张说明卡（要读这份简历与岗位 JD、大概 10–60 秒），点 **开始生成** 才真的调用
模型——打开看一眼不再消耗一次模型调用。生成中关掉窗口**不会中止**：它在后台继续，有带「取消」
的常驻通知，完成/失败都会提示，回来再打开直接看到这次结果、不会重新请求。真要中止请点「取消生成」
（关窗口不是取消）。「重新生成建议」会先确认再覆盖；简历内容改过则旧建议自动清空，避免对着旧正文点
「采纳」。

### ATS 检测里的 JD 是从哪来的？清空后为什么又出现了？

简历关联了岗位时，打开 ATS 检测会自动把该岗位的描述与要求填进 JD 输入框，**只填不跑检测**。你可以
改写、也可以清空——同一个岗位在整个页面生命周期里只自动填一次，清空后不会再填回来；确实想恢复就点
**重新载入关联岗位 JD**。没关联岗位时不会读取任何岗位，也不显示这个按钮。

### 一键脱敏或离线分享会泄露我的隐私吗？

一键脱敏与离线分享包都**基于脱敏后的内容生成**，姓名 / 电话 / 邮箱 / 公司 / 学校等会被替换成
占位符，照片不进入分享产物；分享包里的 token 只是本地的离线校验码、不做在线鉴权。请仍按常识
核对导出物：不同字段的脱敏口径可在界面逐项勾选，确认后再发出。

### 助手能替我查什么、改什么？

助手可以查**真实状态**：当前简历几页、有没有溢出、断页从哪一段开始、分页报告入口在哪（制作台左栏「版面」→「获取分页报告」→「页面概览」）、预检结果、命名版本与岗位变体列表，以及按路径读单条内容。写操作（改字段、加条目、重排板块、设条目排版）一律**先出「待确认改动」卡片与「改动预览」**，点「确认执行」才写库——未确认时简历 revision 不变；确认后 revision 前进并自动留一条「助手修改前…」命名版本，可在制作台「版本」里恢复，点「拒绝」则库不动。

### 求职助手会不会一本正经地胡说八道？

系统提示给助手立了「实事求是」这条**最高优先级**的行为准则：**不知道就说不知道，绝不编造事实、
数据、菜单入口或"某个功能存不存在"的说法**。凡是涉及你数据的结论（"我有几个岗位 / 提醒 / 内推 /
面经 / 知识"），它都必须先调用工具查证再回答，不会凭印象或凭猜；工具没查到的不会脑补。它也只在
**你明确要求时**才写入或修改数据，写完会如实说明改了什么。当然，助手输出最终仍由你选择的模型
服务商生成，涉及投递、隐私等重要结论时，仍建议回到对应页面核验。

### 投投悬浮球找不到或不想使用怎么办？

先到 **设置 → 应用 → 投投悬浮球** 确认开关是否开启。开启后它可能因为静置而贴到浏览器边缘，
把鼠标移到边缘、用 Tab 聚焦，或直接按键盘上的 Enter / Space 都可以唤醒；拖动后它会吸附到最近的
上 / 下 / 左 / 右边缘。静置一会儿它会偶尔眨眼，再久一点会缩在边缘打瞌睡（飘着 Zzz），点一下或把
鼠标移上去就醒。关闭悬浮球不会关闭求职助手，也不会删除会话、资料或历史记录。

### 截图粘贴不进对话框怎么办？

助手（含投投浮窗）的输入框支持 **Ctrl+V 粘贴截图**，但它只认剪贴板里的**图片本身**。在资源管理器里
复制一个文件时，剪贴板里放的是文件路径而不是位图，粘不进对话——这种情况请点输入框下方的「附件」按钮
选文件。粘贴和选文件走同一套校验：最多 4 个，单个 ≤ 2 MB、合计 ≤ 5 MB，图片限 png / jpg / webp /
gif / bmp / tif（bmp / tif 会在本机转成 png 再发给模型）。

### 知识库 / 题库历史 / 复盘历史删错了怎么办？

这几类内容删除时都走**软删除**：先移进侧栏「回收站」，在那里可以一键恢复；只有「彻底删除」才会
真正抹掉（且有二次确认）。所以删错了先去回收站找，不用慌。