侧边栏提示「需要先安装桌面程序」「还没和桌面配对」或「无法连接桌面程序」#
插件要连上桌面程序才能填写。按提示处理：
| 提示 | 处理 |
|---|---|
| 需要先安装桌面程序 | 从下载页安装桌面程序，然后重启浏览器 |
| 还没和桌面配对 | 点「复制扩展 ID」，粘贴到桌面程序「设置 → 浏览器连接」 |
| 无法连接桌面程序 | 确认桌面程序已打开；刚装完插件的话，重启浏览器 |
仍然连不上时，打开桌面程序「设置 → 浏览器连接」查看缺少哪一步，或在扩展页重新加载插件。
常见问题
没找到答案，可以在 QQ 群 1121142517 提问，或提交 GitHub Issue。
AI 接口地址（API URL）应该填写到哪一层？#
在桌面程序「设置 → AI 设置」里填服务商提供的 Base URL 即可。以 /v1 等版本号结尾的地址会自动补全 /chat/completions，完整端点则原样使用。
https://api.openai.com/v1推荐https://api.openai.com/v1/chat/completions也可以https://example.com/api路径不完整，请求会失败
只填域名时按 /v1/chat/completions 补全；服务商路径不同的，以其文档为准。
Key 请填在「API Key」一栏，不要写进地址。建议使用 https:// 地址。
AI 一直在等待，或者提示网络错误、超时#
等待超过 90 秒时，侧边栏会显示慢响应提醒，可以点「取消 AI 等待（保留本地匹配）」。排查顺序：
- 检查接口地址是否正确，前后有无空格。
- 确认当前网络能访问该接口。国内通常无法直连
api.openai.com，请换用可访问的服务商。 - 展开侧边栏的「填写诊断」，查看失败类别和各阶段耗时。
取消后，服务商可能仍会计费。
AI 请求失败，各种提示分别是什么原因？#
服务商返回了错误。提示后附带的英文是服务商的原始信息，可以一起参考：
| 提示 | 常见原因 |
|---|---|
| API Key 无效或无权访问该模型 | Key 填错、已失效，或账户没有该模型的权限（401） |
| AI 账户余额不足 | 服务商账户欠费（402） |
| AI 接口或模型未找到 | 接口地址不对，或模型名写错、服务商没有这个模型（404） |
| AI 请求过于频繁 | 触发限流，或额度用完（429） |
| AI 请求格式或模型配置无效 | 模型参数有误，或接口不兼容 OpenAI Chat Completions（400） |
| AI 服务暂时不可用 | 服务商或中转故障（5xx），稍后再试 |
「填写诊断」不含 Key 和简历内容，可以直接截图反馈。
提示 AI 返回格式错误#
模型返回的内容不符合要求的 JSON 格式，小模型较常出现。此时会保留本地匹配的结果，显示为部分完成。换用 gpt-4o-mini 或更强的模型即可。
部分字段没有填写，或填写的内容不正确#
日期、学历、证件类型、政治面貌、城市地区、级联下拉和多段经历，各网站写法差异很大，容易漏填或填错。
- 点网页里没填上的输入框，再点侧边栏对应的字段。
- 输入框已有内容时，用字段右侧的按钮：「添加」插入到光标处，「替换」覆盖整个输入框，「删除」只删这一个字段。
- 「简历字段」页可以搜索全部字段。
密码、验证码和文件上传不会自动填写。遇到完全填不了的网站，欢迎提交兼容性反馈，截图请遮挡个人信息。
Excel 模板导入失败#
在桌面程序「简历」页导入，请检查：
- 格式为
.xlsx或 UTF-8 编码的.csv，只读取第一个工作表。 - 第一行是表头，前三列依次为「一级分类 / 字段名 / 值」。
- 每一行的「字段名」都有内容。
只要有一行缺少「字段名」，整个文件都不会导入。提示会列出出错的行号，补全后重新导入。如果提示「共 N 行缺少字段名」，多半是第二列整体错位了。
从 0.4.0 及更早版本升级，原来的模板和 AI 配置怎么办？#
0.4.1 起数据保存在桌面程序，旧版插件里的数据会迁移过去：
- 先安装并连接桌面程序，再升级插件。商店版已经自动升级的，旧数据仍保留在插件里。
- 连接后，桌面程序切到「简历」页，列出待导入的内容。
- 点「导入到桌面」。桌面已有「我的信息」时，选择保留哪一份。
- 导入完成后，插件删除本地的旧数据。
点了「不导入」，之后可以在插件状态页（侧边栏底部「插件状态」）重新发送。超过 24 KB 或超过 25 个的模板无法迁移，可在插件状态页下载为 CSV 再导入；AI 配置迁移失败时，旧 Key 也可以在插件状态页复制。
安装桌面程序时系统提示「无法验证开发者」或被拦截#
安装包暂未签名，首次打开会被系统拦截：
- Windows：SmartScreen 弹窗中点「更多信息 → 仍要运行」。
- macOS：右键点 DMG 选「打开」，把 App 拖进「应用程序」；首次启动再右键点 App 选「打开」。新版 macOS 需在「系统设置 → 隐私与安全性」中点「仍要打开」。
请勿执行 xattr -dr com.apple.quarantine 或关闭系统安全设置。每个安装包都附有 .sha256 校验文件，核对方法见安装与升级说明。
软件是否收费？AI 接口是否需要付费？#
软件免费开源，没有内购，源码在 GitHub 上。
AI 费用由你选的服务商收取，单次填表消耗很少，用低价模型基本可以忽略。不配置 AI 也能导入 Excel 模板、点选字段填写和管理投递记录。
简历数据会被上传到哪里？#
简历、「我的信息」、投递记录和 AI 设置保存在本机，API Key 保存在系统凭据库。软件没有服务器，作者拿不到任何数据。
数据目录：Windows %LOCALAPPDATA%\ResumePro，macOS ~/Library/Application Support/ResumePro。
使用 AI 功能时，相关内容会发送到你配置的服务商，包括 AI 解析简历时提取的文字。介意的话可以使用本地部署的模型。详见隐私政策。
怎么升级到新版本？#
- 商店版插件：自动更新。
- 手动安装的插件：下载新 zip 覆盖原文件夹，在
chrome://extensions点「重新加载」，再刷新网申页面。 - 桌面程序：直接安装新版，数据保留。
Resume Pro Desktop 测试版用户请按改名升级说明操作。
支持哪些系统和浏览器？#
桌面程序支持 macOS（Apple 芯片）和 Windows（x64），暂无 Intel Mac 版本。
浏览器支持 Chrome 和 Edge 116 及以上。其他 Chromium 内核浏览器未经测试，Firefox 和 Safari 不支持。chrome:// 等浏览器内部页面无法填写。