先找到与你看到的现象对应的一节。排查时保留错误提示和发生时间，仍无法解决可通过支持邮箱反馈。
安装失败或找不到加载按钮
提示 Manifest 文件缺失或不可读取
最常见原因是选中了 ZIP、上一级目录，或安装包没有完整解压。请选择第一层直接包含
manifest.json 的文件夹。必要时重新下载并解压，参照正确目录结构。
没有“加载已解压的扩展程序”按钮
手动在 Chrome 地址栏打开
chrome://extensions，确认右上角“开发者模式”已开启，再查找页面左上方的加载按钮。
安装好了，网页里没有助手
-
检查网页类型。Chrome 内部页、Chrome Web Store 和
file://页面不支持。换到普通 HTTPS 网页再试。 -
检查扩展开关。在
chrome://extensions中确认“ez4ielts · 学鸭”处于已启用状态。 - 检查网页权限。打开扩展设置，确认允许所有普通网页；如果选择逐站点授权，添加当前站点并接受 Chrome 权限弹窗。
- 检查子域名。逐站点授权按“协议 + 主机”申请，子域名需要单独授权，端口不单独区分。
- 检查功能同意项。确认需要的查词、保存或学鸭同意项已开启。
- 在网页中重试。授权后会尝试立即启用；如页面刚好在跳转，刷新后重新选中文字。
权限设置的完整说明见首次使用：网页权限。
设备未连接，或出现 401 / 403
- 尚未配对
- 在扩展设置中点击“登录并连接 ez4ielts”，在打开的网页登录并确认当前账号，等待自动连接。无需复制令牌。
- 401：设备凭据失效
- 设备凭据可能已经失效、过期或撤销。重新登录并完成设备配对。
- 403：账号没有对应权限
- 当前账号没有对应访问权限。扩展会保留凭据供问题恢复，不会静默切换到另一个网页登录账号。确认账号是否正确，再联系支持说明错误。
在另一台浏览器登录同一个账号，不会替当前浏览器完成设备配对。每个浏览器都要单独确认。
待同步事件一直没有减少
先确认网络能访问 ez4ielts 主站，然后在扩展设置中点击“立即同步”，查看上次同步状态。
- 账号不匹配
- 队列属于另一个账号。需要保留这些事件时，请切回原账号后同步；如果决定不再保留，可以清空队列。
- 旧版队列归属待确认
- 需要你明确确认当前账号拥有这些旧事件。确认归属后再继续同步。
- 等待重试
- 服务端暂时失败，扩展会按退避计划继续尝试。记下状态和发生时间，持续未恢复时提交问题。
另一台电脑没有扩展或偏好
开发者模式的“加载已解压”安装不参与 Chrome 扩展商店同步。请在每台电脑分别下载安装、连接账号并设置网页权限。
如果缺少的是模型选择或翻译目标语言，请检查：
- 两台设备都已开启 Chrome 同步，并使用同一个 Chrome 账号。
- 两份扩展使用相同扩展 ID。
- 每台设备的扩展设置中都开启了“Chrome 偏好同步”。
偏好同步只传递模型选择和翻译目标语言，不会同步扩展安装、ez4ielts 登录、网页权限、允许网站或学习内容。已同步到 ez4ielts 账号的学习数据仍可在账号侧使用。
提示有新版，但版本没变
更新提醒只通知你有新版本。请从官网下载新 ZIP，覆盖原来的固定文件夹，再到
chrome://extensions 点击“重新加载”。具体步骤见手动更新指南。
仍然无法解决
前往联系支持，按清单整理版本、时间、配对与同步状态，以及可公开的复现步骤。