magpie-gemini-web

工具调用默认开启，图片输入默认关闭。可通过命令行修改插件配置：

# 开启图片输入（对两个 Provider 生效）
magpie plugin options magpie-gemini-web '{"allowImages":true}'

# 为 AI Studio 配置代理
magpie plugin options magpie-gemini-web '{"studio":{"proxy":"http://127.0.0.1:7890"}}'

配置代理访问 Google：

• AI Studio：推荐在本地管理页设置。打开额度卡片「管理页」一行里的地址（默认 http://127.0.0.1:2048），用户名 magpie，密码是数据目录 config.json 里的 adminPassword；保存代理后在管理页重启服务即可生效，之后插件重启后端也不会覆盖它。
  • 也可以用上表的 studio.proxy 或环境变量 AI_STUDIO_PROXY，它们优先于管理页里保存的代理。改了要重启本地服务才生效（npm run studio:stop，下一次请求会自动启动）。
  • 都没设置时，后端自动使用 HTTPS_PROXY 环境变量或系统代理（Windows 的「代理」设置）。
  • Magpie 里给 ai-studio 设置的供应商代理不会传给本地后端，请用上面两种方式之一设置。
  • 额度卡片的「代理出口」一行会显示后端当前实际使用的代理、它来自哪里，以及新设置是否还要重启才生效；登录 Google 时的说明、登录失败的提示和 npm run studio:status 也会显示。
  • 监听地址、API Key、管理员账号等由插件管理，在管理页修改不会生效。
• Gemini Web：后端不读取 HTTP_PROXY，请打开本地管理面板 http://127.0.0.1:8083/admin 在代理池中添加（登录口令为数据目录 secrets.json 中的 adminToken）。
  • 注意：配置代理池后，新添加的账号需先发送一次请求以绑定代理，再通过「添加本地后端里已有的 Google 账号」重新添加，才能正常读取邮箱和用量（不支持通过 SOCKS 代理读取用量）。

连接自建后端： 如果你自己运行了 gemini-web2api-go 或 AIStudio2API，登录时选择 「连接已有后端 / 连接已有 AIStudio2API」，填入以 /v1 结尾的地址和对应的 API Key 即可。

刷新模型列表： 升级插件后，可执行 magpie provider models gemini-web 刷新模型列表。

当插件报错提示运行命令时，直接复制报错中的完整命令执行即可。在插件目录下也可使用：

安全与数据目录：

• 两个后端均只监听 127.0.0.1，Cookie 与登录态仅保存在本机，Magpie 仅保存本地生成的随机 API Key。
• Gemini Web 数据目录：~/.local/share/magpie-gemini-web（可通过 GEMINI_WEB_DATA_DIR 修改），日志位于 backend.log。支持 macOS、Linux、Windows（x64 / arm64）。
• AI Studio 数据目录：~/.local/share/magpie-ai-studio（可通过 AI_STUDIO_DATA_DIR 修改），日志位于 backend.log（超 10 MB 下次启动自动轮转）。默认使用 2048 端口，被占用时自动顺延并记录在 config.json。支持 macOS、Linux（x64 / arm64）与 Windows x64。
• 插件将请求并发限制为 1，但仍无法完全排除 Google 账号风控风险，请自行评估使用。

AI Studio 升级与模型范围：

• 插件固定使用经过 SHA-256 校验的 v0.2.13-magpie.1（基于上游 v0.2.13），通过升级插件更新后端。同基线或更旧的官方托管后端在下次管理启动时自动升级，保留账号、端口与登录凭据。
• 托管后端已在 macOS、Linux、Windows 统一禁用在线更新：管理页提示“请通过 Magpie 插件升级”，更新接口返回 HTTP 403，检查更新也不会访问 GitHub。用户自行连接的外部服务不受影响。补丁和可复现构建流程见 docs/studio-release.md。
• Unix 的 package/ 仍尽力设置为 0555，作为额外的文件保护；权限设置失败不阻断服务，在线更新的禁用也不依赖该权限。若要手动删除数据目录来重置，请先停止服务，再运行 chmod -R u+w "<数据目录>/package" 恢复可写权限，然后删除；将 <数据目录> 替换为实际路径。
• 若自行更新到更新版或定制版，插件会提示版本冲突，并提供带正确 --data-dir 的 stop、install、start 命令。停止时会找回更新后的监听进程 PID，并核对可执行文件路径；无法核实身份就不会发送终止信号。HTTP 端口关闭但进程尚未退出时，插件不会重装或启动第二个进程。
• 已停止但文件被替换的后端会从校验通过的固定版本安装包恢复；校验失败不会启动替换文件。安装会保留账号和运行数据文件，但不保证旧版本能读取新版迁移过的数据。手动降级前先停止服务并备份整个数据目录（包括 auth/、runtime/requests.db 等）；已知发生数据迁移时应升级插件以匹配新版后端。
• AI Studio 后端基础请求期限为 30 分钟；插件默认单次响应等待／流空闲超时也是 30 分钟（仍可用 studio.requestTimeoutMs 调整）。这允许非流式长回复在服务端完整收集；后端卡死时也可能等满 30 分钟，且单 worker 会拖住后续请求。可主动取消请求或设置更短的等待时间，但较短期限可能中断正常长回复。上游自动续写的期限按其规则计算。
• 已核对本机 Magpie v0.1.1285（d783df46）源码：插件请求走 Provider.Do → plugin.Fetch → loader.fetch，绕过普通 HTTP transport 的 10 分钟响应头限制；此插件生成路径没有发现更短的固定总超时。网关 5 分钟 IdleTimeout 仅针对请求之间的空闲连接。客户端或反向代理仍可设置更短期限；这不是一次实等 30 分钟的端到端验证。
• 模型列表过滤 -build / assistant_route 模型：这类模型附带 Build 写代码助手的系统提示词，不作为普通 Agent 模型提供。升级后可执行 magpie provider models ai-studio 刷新列表。

Gemini Web 优化后端升级与回退：

• 插件默认使用本仓库发布的 4.22.0-magpie.1（基于上游 v4.22.0 集成 XSRF 缓存、请求取消传播、工具调用提前收尾与 Argon 校验补丁）。
• 旧版升级：插件不会打断运行中的后端。先停止旧进程（PID 见数据目录 backend.pid），下次启动 Magpie 或发请求时会自动更新二进制并保留原有配置与账号。
• 回退官方版 / 恢复优化版（停止后端后在插件目录执行）：

  npm run backend:install:upstream  # 回退并固定使用官方 v4.22.0
  npm run backend:install           # 恢复默认优化版

• 源码复现构建与发布流程见 docs/backend-release.md。

macOS 原生 Task（实验性）： macOS 用户登录 Gemini Web 时会额外看到「macOS 原生 Task（实验性）」选项，通过本机 Gemini.app 的原生 Task 通道调用 gemini-task-argon（原生 Function Calling）。当前处于 Alpha 阶段，需预先完成本机配置，详见 native-task/README.md。