1
安装并固定
从 Chrome 应用商店安装 ExamPilot，并将图标固定到浏览器工具栏。
三步开始使用
首次使用只需安装扩展、添加 API 配置，然后在任意网页上开始截图识别。
2
填写模型配置
输入 API 地址、模型名称与 API Key，选择匹配的接口模式后保存。
3
截图并分析
点击“全屏”或“区域”，等待状态栏显示“识别完成”即可查看结果。
使用前准备你需要一个支持图片输入的视觉模型 API。ExamPilot 不提供模型额度，也不会代管你的 API Key。
安装扩展
推荐直接从 Chrome 应用商店安装。开发者也可以构建项目后加载 dist/chrome/。
1
打开扩展商店
进入 ExamPilot 商店页面，点击“添加至 Chrome”，并在浏览器确认窗口中完成安装。
2
固定到工具栏
点击浏览器右上角的扩展按钮，在 ExamPilot 旁点击固定图标。之后点击 ExamPilot 图标即可在当前网页呼出面板。
3
确认面板出现
打开任意普通网页后点击扩展图标，右下角会出现悬浮面板。双击页面空白区域可以快速显示或隐藏面板。
面板没有出现？Chrome 内置页面、扩展商店页面和部分受保护页面不允许注入扩展脚本。请切换到普通 HTTPS 网页后重试。
配置视觉模型
点击面板右下角的 ⚙️，添加你的 API 配置。API 地址必须使用 HTTPS。
配置示例
以下展示 OpenAI 兼容接口最常见的填写方式。
我的视觉模型
https://api.example.com/v1/chat/completions
vision-model-name
••••••••••••••••
Chat Completions
◆
首次访问需要授权
保存配置或开始识别时，ExamPilot 会检查 API 域名权限。如果尚未授权，当前页面会显示授权弹层。
按域名授权扩展只申请你正在使用的 API 域名，不会在安装时申请访问所有网站。配置与 API Key 存储在本地浏览器中。
选择正确的接口模式
接口模式决定请求体和响应解析方式。请以 API 服务商文档中的接口路径与格式为准。
Chat Completions
适用于 /v1/chat/completions 及多数 OpenAI 兼容视觉接口。
Responses API
适用于 OpenAI 风格的 /v1/responses 接口与对应输出结构。
Anthropic
适用于 /v1/messages，图片会按 Anthropic 的 base64 格式发送。
格式不属于以上三种？选择“自定义模板”，自行定义 Headers、Body 和响应文本提取规则。
开始截图识别
根据页面内容选择“全屏”或“区域”。区域识别通常更快，也能减少无关内容对模型判断的干扰。
截取当前视口
全屏识别
截取浏览器当前可见区域，适合内容集中、题目完整显示在一屏内的页面。
- 点击“全屏”后面板会暂时隐藏
- 长页面只会截取当前可见视口
区域识别
点击“区域”后按住鼠标拖拽，只选择题目和必要的上下文，再松开鼠标开始分析。
- 按 ESC 可退出区域选择
- 尽量包含完整题干、选项和图表
面板操作速查
状态提示识别过程通常依次显示“截图中 → 裁剪中（区域模式）→ AI 识别中 → 识别完成”。
迁移与备份配置
在 ⚙️ 设置的“配置迁移”中，可以把常用模型设置带到另一台设备，或在修改前留一份本地备份。
↓ 导出配置
点击后浏览器会下载 exampilot-settings-YYYY-MM-DD.json。文件包含全部模型配置、当前选中项、自定义提示词和界面透明度。
↑ 导入配置
选择 ExamPilot JSON 备份并确认后，扩展会校验文件内容，再替换当前浏览器中的全部配置、提示词与透明度。
备份包含未加密的 API Key请只保存在可信设备和私密位置，不要分享、上传到公共网盘链接或提交到代码仓库。导入后首次使用新 API 域名时仍需重新授权。
面板位置单独保存在本机拖动迷你 ⚡ 按钮后，位置会自动保存并适配窗口尺寸；面板位置与 API 域名授权不会写入导出文件。
高级配置
当服务商需要额外参数时，可以使用 JSON 覆盖；请求结构完全不同则使用自定义模板。
Headers / Body JSON 覆盖
对象会递归合并，数组与基础类型会替换默认值；字段设置为 null 可删除默认字段。
Body JSON 示例
{
"temperature": 0.2,
"max_tokens": 2048,
"stream": false
}自定义模板占位符
常用占位符包括 {{model}}、{{apiKey}}、{{apiKeyBearer}}、{{prompt}}、{{imageUrl}}、{{imageBase64}} 与 {{imageMimeType}}。
Headers 模板示例
{
"Content-Type": "application/json",
"Authorization": "{{apiKeyBearer}}"
}检查请求预览发送前展开“请求预览”，确认 URL、Headers、Body 和图片字段符合服务商文档，尤其不要把 API Key 放进不必要的字段。
常见问题
优先检查 API 地址、接口模式、模型是否支持图片输入，以及 API 域名是否已授权。
点击扩展图标后没有出现面板
请确认当前是普通网页，而不是 chrome:// 页面、Chrome 应用商店或浏览器内置 PDF 页面。刷新普通网页后再次点击扩展图标。
提示需要 API 域名权限
在当前网页弹出的 ExamPilot 授权框中点击授权。权限仅针对配置 URL 对应的 HTTPS 域名；如果修改了 API 域名，需要重新授权。
接口返回 401、403 或模型不存在
401 通常表示 API Key 无效，403 可能是权限或区域限制，模型不存在则需要核对模型名称。请使用请求预览与服务商文档逐项对照。
提示 CORS 或网络请求失败
确认 API URL 使用 HTTPS、域名已授权，并且服务商允许浏览器扩展访问。部分仅面向服务器端的接口即使授权后仍可能拒绝浏览器请求。
答案不完整或没有识别到题目
优先使用区域识别，并完整框选题干、选项、图表和必要上下文。也可以在设置中优化自定义提示词，要求模型给出答案、步骤和简短解释。
截图和 API Key 会上传到哪里？
截图只会发送到你配置的 API 地址，API Key 与配置保存在 Chrome 本地存储。ExamPilot 本身不提供中转服务。详情请查看隐私政策。
导入配置后为什么仍然提示域名授权？
导出文件只包含模型配置、提示词和透明度，不包含 Chrome 授予扩展的 API 域名权限。换设备或浏览器后，首次使用每个 API 域名时需要重新授权。
导出的配置文件可以分享吗？
不建议。备份是可读的 JSON，其中包含 API Key 以及自定义请求内容。请把它当作密码文件保管；如发生泄露，请立即在 API 服务商处撤销或轮换密钥。
准备好开始了吗？
安装扩展，添加你的视觉模型配置，然后在网页中一键分析。