前言¶
在 DeepSeek Harness（DSH）里接大模型，常见做法是各家用各自的 API Key 或专属 CLI。若你已经有 Google Antigravity 订阅，又希望 Agent 能直接选 Gemini、带推理档位，并在对话里用 Google Search grounding 或分析工作区里的图音视频与 PDF，就需要一条和 Antigravity 一致的登录与配额路径。
下面介绍社区插件 dsh-gemini-antigravity-auth（安装名 gemini-dsh）。它通过 Google OAuth 接入 Antigravity，无需单独配置 Gemini API Key；模型列表与账号侧额度展示与 Google 账号绑定，并扩展了若干可供 Agent 调用的工具。
这是什么¶
dsh-gemini-antigravity-auth 是由维护者 Battiatus 发布的 DSH 插件，分类为模型推理。插件在 DSH 的模型选择器里增加经 Google Antigravity OAuth 可用的 Gemini 等模型；同一订阅下若账号还包含 Claude 或 GPT-OSS，列表中会按 Google 在登录时返回的名称展示。
许可协议为 MIT（以 GitHub 仓库说明为准）。当前 package 版本为 0.4.0，运行环境要求 Node.js >= 22。插件仅依赖 Node.js，无额外第三方依赖包。
项目地址：GitHub — Battiatus/dsh-gemini-antigravity-auth。社区目录页：SkillHub — dsh-gemini-antigravity-auth。
说明：该插件不是 Google 或 DeepSeek 官方产品；README 明确提示第三方使用 Antigravity 登录存在账号风险，需自行权衡。
核心功能¶
登录与模型¶
- 在设置页或命令
/agy login完成 Google 登录，无需复制 API Key。 - 模型选择器展示当前 Google 账号可用的 Antigravity 模型（名称以登录时从账号读取为准）。
- 按模型族提供 Low / Medium / High 推理档位，档位会传到 Google 的 thinking budget，对话中可见模型推理行为。
- 支持多个 Google 账号：添加、切换、移除，并可查看各账号按模型组（Gemini、Claude、GPT、Argon 等）的 5 小时与周限额，展示方式与 Antigravity 一致。
Agent 工具¶
| 工具名 | 作用 |
|---|---|
agy_web_search |
Google Search grounding，返回答案与来源 |
agy_media |
分析工作区中的图片、音频、视频或 PDF（约 36 MB 以内） |
agy_image |
按描述生成图片，或编辑工作区最多 5 张图片（使用账号提供的图像模型，README 称 Nano Banana） |
多模态与可靠性¶
- 消息附件中的图片、音频、视频、PDF 可直接送给 Gemini。
- 调用失败时会刷新失效 token 并重试；服务端繁忙会重试；额度用尽会提示重置时间。
- 可在设置中单独开关 Gemini 模型、联网搜索、媒体分析，并隐藏不用的模型。
- 与 DSH 工具体系兼容：完整 tool calling，并对 Gemini 不接受的 schema 做适配（遇 400 与 tool schema 相关错误时，README 建议更新插件）。
令牌与配置存储¶
令牌仅保存在本机 ~/.dsh/agy-multimodal/accounts.json（权限 0600），界面不展示。访问类设置存放在同目录下的 settings.json。
安装与启用¶
先关闭 DeepSeek Harness，再执行官方 README 中的安装命令：
dsh plugin --profile desktop add gemini-dsh
然后重新启动 DeepSeek Harness。
若从应用内插件界面安装，可粘贴完整地址：
git+https://github.com/Battiatus/dsh-gemini-antigravity-auth.git
终端提示 dsh: command not found 时，CLI 位于应用自带的 runtime/cli/bin 目录，例如 macOS 为：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh"
Windows 与 Linux 则在 DeepSeek Harness 安装目录下的 resources/runtime/cli/bin/。可为其他 DSH 配置档更换 --profile（如 web、tui）。
更新：
dsh plugin --profile desktop update gemini-dsh
卸载：
dsh plugin --profile desktop remove gemini-dsh
安装前建议自行查看仓库源码与 MIT 许可证。插件以当前 DSH 进程权限运行，OAuth 令牌写在用户主目录下上述路径中。
典型用法¶
首次登录¶
- 打开 Settings › Antigravity，点击 Sign in with Google（或输入
/agy login）。 - 在浏览器中选择 Google 账号并授权。若未自动打开页面，可点击 Open Google sign-in。
- 在模型选择器中选择 Antigravity 模型并开始对话。
在另一台设备上使用 DSH（如服务器上的 Web 版、手机或其他 PC）时：授权后浏览器可能跳转到本机 localhost:51121 且无法加载。将地址栏完整 URL 复制到 Open Google sign-in 下方的输入框，或执行：
/agy login <address>
OAuth 回调监听在运行 DSH 的机器上的 127.0.0.1:51121（Google 为该客户端要求的端口）。若端口被其他 Antigravity 工具占用，同样可用粘贴回调地址的方式完成登录。
/agy 命令¶
| 命令 | 说明 |
|---|---|
/agy login |
添加 Google 账号，显示登录链接 |
/agy login <address> |
用另一设备授权后的回调地址完成登录 |
/agy status |
列出账号，当前活跃账号以 ● 标记 |
/agy use <email> |
切换活跃账号 |
/agy logout [email] |
移除账号（默认移除当前活跃账号） |
经过上面的步骤，Agent 在具备工具权限时即可调用 agy_web_search、agy_media、agy_image，与用户消息中的多模态附件一并由 Gemini 处理。
适用场景与注意¶
适合谁： 已有 Google Antigravity 订阅、希望在 DSH 桌面（或其他 profile）里统一选模型、管理多账号配额，并让 Agent 具备 Google 搜索 grounding 与工作区多媒体分析的开发者。
网络与证书： 若设置页出现 fetch 失败、证书错误或没有模型（README 提到 Windows 或公司网络较常见），需检查 VPN、防火墙；若 DNS 或 hosts 将 cloudcode-pa.googleapis.com 指到本机，插件会尝试仅为 Antigravity 相关主机解析真实地址。公司代理可在启动 DSH 前设置 HTTPS_PROXY，例如 http://proxy.company:8080。
风险与合规： README 写明 Google 曾对以第三方工具方式使用 Antigravity 登录的账号采取过停用措施，非官方集成，使用需自担风险。
DSH 生态强调「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，本文仅介绍该开源插件自身能力。
结尾¶
dsh-gemini-antigravity-auth 把 Antigravity 的 Google 登录、多账号额度与 Gemini 多模态能力收敛进 DSH：一条 OAuth 链路、一组模型与推理档位，外加搜索、媒体与图像三类 Agent 工具。若你要在 Harness 里复用现有 Antigravity 订阅而不是再维护一套 Gemini API Key，可按 README 安装 gemini-dsh 并完成 Settings › Antigravity 登录。
- 目录页：https://www.skillhub.cn/plugins/Battiatus/dsh-gemini-antigravity-auth
- 源码与文档：https://github.com/Battiatus/dsh-gemini-antigravity-auth
