跳到主要内容

浏览器扩展

把网页图片或视频保存到 Serpent 资源库,支持批量下载、右键保存和拖拽保存。支持 Chrome / Edge(Chromium)与 Firefox。

媒体由浏览器侧下载(携带 Cookie 与页面 Referer)再上传到本机 Serpent,有助于访问需要登录的媒体,也可绕过部分防盗链限制;个别网站仍可能拒绝下载。只要 Serpent 在运行且已打开资源库,扩展即可连接(本机 127.0.0.1),无远程服务器。

安装​

扩展尚未上架浏览器商店,需要手动安装。所有安装文件在扩展发布页下载,按浏览器选择对应文件。

Chrome / Edge​

  1. 到扩展发布页下载 serpent-extension-<版本>.zip,解压到固定文件夹(例如「文档/Serpent-extension」),文件夹内需直接包含 manifest.json。
  2. 打开 chrome://extensions(Edge 为 edge://extensions),开启右上角「开发者模式」。
  3. 点击「加载已解压的扩展程序」,选择解压出的文件夹。

Firefox​

  1. 到扩展发布页下载 Firefox 的 zip 包(当前 v0.1.5 为 serpent-extension-firefox-v0.1.5.zip),解压到固定文件夹。
  2. 打开 about:debugging →「此 Firefox」→「临时加载附加组件…」,选择解压目录中的 manifest.json。
  3. 这是临时加载的扩展,退出 Firefox 后会被移除;重新启动 Firefox 后需再次加载 manifest.json。

更新​

  • Chrome / Edge:到发布页下载新版本 zip → 解压覆盖 → 在 chrome://extensions 扩展卡片上点「刷新」(或移除后重新加载)。
  • Firefox:到发布页下载新版 Firefox zip → 解压后在 about:debugging 中再次加载 manifest.json。

使用​

  1. 启动 Serpent 并打开一个资源库。
  2. 扩展工具栏图标在已连接时会变为彩色;未连接时保持灰色。
  3. 右键保存:在网页图片或视频上右键 →「保存到 Serpent」→ 选择目标文件夹(最近保存/浏览 → 分割线 → 全部一级目录,子文件夹可逐级展开)。
  4. 拖拽保存:拖拽图片时自动展开树状保存菜单——悬停有子文件夹的目录右侧 › 进入下一级;左侧 ‹ 返回;面板外松开或 Esc 退出。
  5. 保存过程中页面会出现「正在保存到 Serpent」气泡反馈。

批量下载​

打开扩展的批量面板,从当前页面收集图片和视频候选;可按格式、最短边筛选,再选择要保存的媒体和目标文件夹。

启用「监测新媒体」后,扩展会检测页面后续加载的图片和视频并加入候选列表。它不会自动滚动页面,也不会自动开始下载;由你筛选、选择后再保存。

穿透保存​

「穿透保存」默认开启。扩展会优先保存原图或原视频;找不到可用版本时回退到当前网页预览。你可以在选项页随时关闭此功能。

选项页​

右键扩展图标 → 选项,可开关:

  • 通知(保存结果系统通知)
  • 保存后聚焦 Serpent 应用
  • 保存后在资源库中显示该资产
  • 拖拽网页图片/视频时的树状保存菜单
  • 穿透保存(默认开启;找不到可用原图或原视频时回退到当前预览)

常见问题​

保存时提示「无法连接 Serpent」

确认 Serpent 桌面应用已启动并打开了资源库。扩展图标变灰 = 未连接;变彩 = 已连接。

保存时提示「forbidden origin」(403)

旧版扩展会遇到此问题(服务器只放行 Chrome 扩展来源)。更新到 0.1.1 及以上版本即可(已支持 Firefox 的 moz-extension:// 来源)。

保存时提示「下载失败:HTTP 403」

该站点(或其图床)启用了 Referer 防盗链,但尚未加入扩展的防盗链支持列表(当前内置微博 sinaimg.cn)。请把站点反馈给扩展开发者,加入支持列表后即可保存。

保存后库里没看到图片

检查选项页「保存后在资源库中显示该资产」是否开启,并确认保存时选择的目标文件夹。

Firefox 无法从「从文件安装附加组件」安装下载的 zip

当前 v0.1.5 提供的是临时加载 zip,不是签名 XPI。解压后打开 about:debugging →「此 Firefox」→「临时加载附加组件…」,选择其中的 manifest.json。

扩展能访问所有网站吗?安全吗?

扩展请求了「访问所有网站」权限,这是保存任意网页图片/视频所必需的。扩展只连接本机 Serpent(127.0.0.1 固定端口),不向任何远程服务器发送数据。代码开源(MIT)。

隐私​

  • 扩展不收集、不上传任何个人数据。
  • 保存动作由你主动发起;媒体文件直接上传到你本机的 Serpent 应用。
  • 仅保存的记录(最近使用的文件夹)存放在浏览器本地 storage 中。