前言¶

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