Chrome · Load unpacked
开发者模式安装指南
从下载 ZIP 到选择网页权限、完成登录和配对，按下面步骤操作。第一次安装通常需要 3–5 分钟。
下载 ZIP，并解压到固定目录
Chrome 不能直接加载 ZIP。解压后的文件夹也不能在安装后删除。
- 点击下方按钮下载当前安装包。
- 在“文档”或其他长期保留的位置创建固定文件夹，例如
ez4ielts-browser-companion。 - 把 ZIP 解压到这个文件夹，确认里面直接能看到 manifest.json。
不要选择 ZIP 文件，也不要选择包着插件文件夹的上一级目录。正确目录的第一层必须包含 manifest.json、popup.html 和 options.html。
打开 Chrome 扩展管理页
Chrome 不允许普通网页直接替你打开内部设置页，需要在地址栏手动进入。
chrome://extensions复制后粘贴到 Chrome 地址栏并按回车。不要粘贴到 Google 搜索框。
开启右上角的“开发者模式”
开关打开后，页面左上方会出现“加载已解压的扩展程序”按钮。
Chrome 可能提醒开发者模式扩展需要谨慎使用。这是手动安装包的正常提示；请只安装从 ez4ielts.com 下载并核对过来源的文件。
点击“加载已解压的扩展程序”
在文件选择器中选中包含 manifest.json 的固定文件夹。
选择文件夹并确认后，扩展管理页会出现ez4ielts · 学鸭卡片，状态应为“已启用”。
如果 Chrome 报告找不到 manifest，通常是选中了错误层级。返回文件夹，继续进入一层，直到第一层能看到 manifest.json。
Learner-initiated ez4ielts companion
固定扩展，先选择网页权限，再完成登录配对
安装只把扩展加入 Chrome；首次设置会先让你选择所有普通网页或逐站点授权。
固定到工具栏
点击 Chrome 右上角拼图按钮，在“ez4ielts · 学鸭”旁点击固定图标。
选择网页权限范围
安装后自动打开的设置页会先显示“允许在所有普通网页使用”。点击后由 Chrome 请求 HTTP/HTTPS 网页权限；如果拒绝，也可以选择“仅在我选择的网站使用”。
登录并确认当前账号
在设置页选择“登录并连接 ez4ielts”。已有账号可直接登录；新账号注册目前仍需邀请码，安装包本身无需申请。 扩展会打开 ez4ielts 的安全确认页。完成登录并确认设备后，扩展会自动连接，无需复制令牌；每个浏览器都要单独确认。
开启需要的学习功能
查词、保存和学鸭功能默认全部关闭。按需开启并保存；如果你选择逐站点授权，再添加目标站点并接受 Chrome 权限弹窗。
选择模型（可选）
配对后可在设置页选择服务端公开的模型选项，默认使用“自动”。模型目录和后台映射更新不需要重新安装扩展。
开启 Chrome 偏好同步（可选）
每台设备都要单独开启，并确保 Chrome 同步功能已开启。它只同步模型选择和翻译目标语言，不会同步扩展安装、ez4ielts 登录状态、网页权限、允许网站或学习内容。
“所有普通网页”只包括 HTTP/HTTPS 页面，不包括 Chrome 内部页、Chrome Web Store、file:// 和其他受保护页面。全站权限本身不会自动上传网页内容；逐站点模式仍按协议和主机申请，子域名需要单独添加。
验证安装是否完成
用一个普通 HTTPS 网页做最小检查，确认扩展、账号和站点权限都已经生效。
如果页面助手仍未出现，先查看设置页中的功能同意项和网页权限范围，再进入本页末尾的排障部分。
没有自动更新
新版本需要手动覆盖并重新加载
- 1从下载页获取新 ZIP，确认版本或 SHA-256 已变化。
- 2关闭正在使用的扩展弹窗和侧栏，解压新包。
- 3用新文件覆盖原来的固定目录，不要改成另一个路径，也不要多套一层文件夹。
- 4打开 chrome://extensions，在扩展卡片上点击“重新加载”，再核对版本。
保持同一个绝对路径有助于维持 unpacked 扩展 ID 和本地设置。开发者模式版本不会自行替换文件，也不会通过同一个 Chrome 账号同步安装到其他浏览器。设置页里的可选 Chrome 偏好同步只传递模型选择和翻译目标语言；每台设备仍需单独开启，也不会同步登录状态或网页权限。
Troubleshooting
常见问题
提示 Manifest 文件缺失或不可读取
你选择了 ZIP、上一级目录或解压不完整。选择第一层直接包含 manifest.json 的文件夹；必要时重新下载并解压。
看不到“加载已解压的扩展程序”按钮
确认 chrome://extensions 页面右上角“开发者模式”开关已打开。
扩展装好了，但网页里没有学鸭
先确认设置页已允许所有普通网页；如果你选择逐站点授权，再添加当前站点并接受 Chrome 权限弹窗。随后开启相应同意项。内部页、Web Store 和 file:// 页面不支持。
配对时出现 401 或 403
401 通常表示设备令牌失效，需要重新登录和配对；403 表示当前账号没有对应访问权限。可前往支持中心查看处理方式。
另一台电脑登录了同一个 Chrome 账号，为什么没有插件
Load unpacked 不参与 Chrome 扩展商店同步。请在每台电脑分别下载、安装和配对。两台设备使用相同扩展 ID 且 Chrome 同步功能已开启时，可以各自在设置页开启 Chrome 偏好同步，只同步模型选择和翻译目标语言；它不会同步安装、登录或网页权限。已同步到 ez4ielts 账号的学习数据仍可在账号侧使用。