前言¶

DSH 通过插件扩展功能。如果需要在 DSH Web 中使用 Google Antigravity / Cloud Code Assist 作为模型来源，需要的是一个能注册 provider、完成 Google OAuth、显示配额信息，并能在 DSH 模型选择器中直接选择的 Web 插件。

下面介绍 dsh-antigravity 的能力、安装方式和典型用法。

这是什么¶

dsh-antigravity 是 LiZhenNet 维护的一个 DSH Web 插件，采用 MIT 许可证。

它在 DSH 的 provider route antigravity 下注册一个 DSH LlmAdapter，并直接对接 Cloud Code Assist streaming API。登录、配额展示和模型选择都在 DSH 的 Web 设置页中完成。

需要说明的是，这是一个非官方集成，项目未与 Google 关联，也未被 Google 背书。只应使用你有权访问的账号和服务。

核心功能¶

下面介绍已核实的几项能力。

• 在 provider route antigravity 下注册 DSH LlmAdapter。
• 支持 Google OAuth 登录。
• OAuth 凭证存储在 DSH home 下：

$DSH_HOME/storages/antigravity-oauth.json

• 直接对接 Cloud Code Assist streaming API。
• Web 设置页支持英文和简体中文。
• 设置页可以显示账号信息、按模型 family 分组的配额、重置时间，以及模型选择器选项。
• 每个模型旁边会显示实时剩余配额百分比。
• 插件会启动 loopback OAuth callback server：

http://localhost:51121/oauth-callback

• 当 Web 服务无法打开浏览器时，可以使用终端登录 helper。
• 插件会在可用时通过 live fetchAvailableModels catalog 将 public model IDs 解析为 runtime model IDs，并提供 static routing fallbacks。
• 模型选择器可以启用或禁用单个模型，启用的模型会排在列表顶部。

包声明的 Node 要求是：

node >=20

包中声明的可选 peer dependencies 包括：

@deepseek-ai/dsh-home-paths
@deepseek-ai/dsh-host-webserver
@deepseek-ai/dsh-llm
@deepseek-ai/dsh-timeout

安装与启用¶

从 GitHub 安装¶

先执行下面命令，将插件安装到 DSH Web profile：

dsh plugin --profile web add github:LiZhenNet/dsh-antigravity

安装完成后，插件会作为 DSH Web 插件挂载，并提供浏览器设置页入口。

从本地 release tarball 安装¶

如果你已有本地打包产物，可以按下面步骤操作：

npm run pack:dist
dsh plugin --profile web add ./dist/dsh-antigravity-0.0.4.tgz

第一条命令用于生成本地 tarball，第二条命令将该 tarball 安装到 DSH Web profile。

当前 DSH 版本不支持 dsh plugin add 时¶

如果你的 DSH 版本还不支持 dsh plugin add，可以手动将 dsh-antigravity 复制到 Web profile 的 node_modules 目录：

$DSH_HOME/profiles/web/node_modules/

然后在 profile 的 cordis.patch.yml 中加入该插件条目，并重启 DSH：

dsh web

典型用法¶

登录¶

打开 DSH Web 的 Settings > Antigravity，点击 Login。

这一步会开始 Google OAuth 流程。登录完成后，设置页会显示账号信息、按模型 family 分组的配额、重置时间，以及模型选择器选项。

选择 provider¶

登录后，在 DSH 的 model picker 中选择 Antigravity provider。

管理模型¶

在 Settings > Antigravity 中，可以使用模型选择器启用或禁用单个模型。

启用后的模型会优先显示在列表顶部，并且每个模型旁边会显示实时剩余配额百分比。

Web 无法打开浏览器时¶

如果你所在环境中的 Web 服务无法打开浏览器，可以在同一台机器上运行终端登录 helper：

node "$DSH_HOME/profiles/web/node_modules/dsh-antigravity/bin/antigravity-login.mjs"

登录完成后，凭证会写入：

$DSH_HOME/storages/antigravity-oauth.json

这个文件包含 access token 和 refresh token，需要保持私有，不要提交、泄露或复制到不可信环境。

适用场景与注意¶

适合以下情况：

• 你在使用 DSH Web。
• 你希望把 Google Antigravity / Cloud Code Assist 作为 DSH 的 provider 使用。
• 你需要在设置页查看账号信息、配额、重置时间和模型选择。
• 你需要在 Web 无法打开浏览器的环境中完成登录。

使用前需要注意：

• 这是非官方集成，不代表 Google 官方应用或官方支持。
• 只能用于你有权访问的账号和服务。
• 凭证文件包含访问令牌和刷新令牌，应严格保护 $DSH_HOME/storages/antigravity-oauth.json。
• 插件会以当前 DSH 进程的权限运行。安装前应检查源码、许可证和依赖。
• 本项目使用 MIT 许可证，并声明 node >=20。

结尾¶

dsh-antigravity 的价值在于把 Google Antigravity / Cloud Code Assist 以 DSH Web 插件的方式接入 DSH，使开发者可以在 DSH 中完成登录、选择 provider、查看配额并管理可用模型。

已核实资料未提供目录页链接；GitHub 地址如下：

https://github.com/LiZhenNet/dsh-antigravity