浏览器 Agent：安装与版本
「浏览器 Agent」指 PicPuck Chrome 扩展。它让 PicPuck 能在你本机的 Chrome 里 驱动即梦、剪映小云雀、Google Gemini 等官方网页 完成填词、挂参考图、点生成等操作，相当于在浏览器里多了一只「机械臂」。
为什么需要它
- 抢跑网页端能力：不少最强模型会先在厂商自己的网站上开放，API 往往晚很多；扩展走的是 你已登录的官网页面，不依赖 PicPuck 是否已对接同一模型的 API。
- 积分规则：扩展在 官网账号 下产生的消耗，走厂商自己的计费/权益；不会扣你的 PicPuck 积分（与站内安装页说明一致）。PicPuck 侧其它直连模型的能力仍按站内规则计费。
- 与拍摄、出图的关系：部分步骤会检测扩展是否已安装、版本是否匹配；未就绪时站内通常会提示你打开 扩展安装页 或升级。
安装前准备
- 使用 Google Chrome。
- 在 Chrome 里 提前登录 你需要用的 即梦 / 剪映小云雀 / Gemini 等账号（与站内安装页「准备工作」一致）。
- 安装完成后 不要删除或移动 解压出来的扩展文件夹，否则扩展会失效。
如何安装（推荐：解压加载）
与控制台里的 PicPuck Extension 安装页 步骤一致（从项目内或顶栏等入口打开该页即可）：
- 下载 zip：在安装页点击下载按钮；文件名与版本以 该页展示为准（与当前熔炉要求的扩展版本一致，请勿依赖外部手写版本号）。
- 解压到固定目录（例如 Windows 下单独建文件夹存放解压后的整包内容）。
- 打开
chrome://extensions/，开启右上角 开发者模式。 - 点击 加载已解压的扩展程序，选中解压后的文件夹（选到包含
manifest.json的那一层）。 - 确认列表中出现 PicPuck，且开关为开启状态。
备用方式：若你熟悉 Git，也可克隆扩展源码仓库后同样用「加载已解压的扩展程序」指向仓库根目录（与安装页「GitHub 源码」说明一致）。Chrome 应用商店版本若未来上线，以安装页更新为准。
版本不匹配怎么办
当扩展版本 低于或与熔炉要求不一致 时，站内可能提示「版本过低/不匹配」并引导你打开安装页。请 重新下载该页提供的 zip，按上一节覆盖安装或重新加载解压目录，直到安装页所写的 要求版本 与扩展管理里显示的版本一致。
常见问题
点击生成后没反应？
先确认扩展已开启、未被浏览器禁用；再确认对应 官网已登录；仍异常时可尝试刷新 PicPuck 页面后重试。
提示装好了但仍报未安装？
检查是否开错 Chrome 配置文件、或企业策略禁止了未上架扩展；可尝试在 同一用户配置 下只保留一个 PicPuck 安装。
下载 zip 404？
属于站点运维与 CI 产物问题：需保证主站已按部署说明提供扩展静态路径（此问题由管理员排查，用户侧可稍后再试或联系支持）。