前言¶
在 DSH 中做智能體任務時，一個常見需求是調用本機已有的命令行 coding agent，而不是每次手動開終端、複製結果、再回貼到會話裏。下面介紹 @dsh-external/dsh-subagent-antigravity：它把 Google Antigravity CLI（agy）作爲 DSH subagent 接入，不需要 Gemini API key，使用已有的 Antigravity login。
DSH 的插件機制強調「一切皆插件」。這個條目來自社區目錄，社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。
這是什麼¶
@dsh-external/dsh-subagent-antigravity 是一個 DSH 插件，由 ZEM17 維護，許可證爲 MIT。它的作用是：在 DSH 會話中讓模型把自包含任務委託給本機 agy 執行，並把結果帶回當前會話。
它不要求配置 Gemini API key。agy 通過 Antigravity login 完成鑑權，插件本身負責任務發起、後續對話、任務列表、取消和登錄窗口。
核心功能¶
| 工具/能力 | 說明 |
|---|---|
antigravity |
發起新的自包含任務，返回一個 task key |
antigravity_followup |
使用上一次調用返回的 task key 繼續同一會話 |
antigravity_tasks |
列出運行中和最近結束的任務；任務 key 記錄在 ~/.dsh/agy-conversations.json，可跨 DSH 重啓恢復 |
antigravity_cancel |
根據運行中任務的 task key 取消任務 |
antigravity_login |
打開交互式 agy 登錄窗口；認證失敗時也會自動打開 |
| 圖片分析 | 在提示詞中給出圖片路徑，例如 C:\projects\design\mockup.png |
| 長任務 | 可讓模型使用 background: true，保持進度可見，並接入 DSH job controls（例如 job_output / job_kill） |
| 可選配置 | 支持模型、effort、超時、權限、sandbox、proxy、工作區目錄、環境變量和額外參數 |
安裝與啓用¶
- 安裝
agy。Windows 下可使用：
irm https://antigravity.google/cli/install.ps1 | iex
插件會按 PATH、AGY_BIN、%LOCALAPPDATA%\agy\bin、~/.local/bin、~/.gemini/bin、~/go/bin 的順序查找可執行文件。
- 登錄一次
agy：
agy
完成 sign-in。後續如果碰到 authentication required，插件會自動打開登錄窗口，也可調用 antigravity_login。
-
準備 DeepSeek Harness，並使用 standard web profile。該 profile 會帶
dsh-subagent、dsh-subprocess、dsh-tools、dsh-jobs。 -
安裝插件：
dsh plugin --profile web add github:ZEM17/dsh-subagent-agy
安裝完成後無需重啓 DSH。會話中的模型就可以使用上面的 antigravity 工具。
典型用法¶
發起任務時，可以直接描述目標路徑和期望結果：
Use agy to rewrite the README of
D:\projects\my-projectand list the changes.用 antigravity 優化這個項目的頁面
圖片分析是把圖片路徑放進提示詞：
Use agy to describe this image:
C:\projects\design\mockup.png用 antigravity 識別這張圖片：
C:\projects\screenshots\ui.png
如果圖片不在當前會話工作區內，需要把目錄放進工具的 dirs 參數，或寫入 addDirs 配置。
長任務可以這樣要求：
- 對耗時任務，讓模型使用
background: true，並保持進度可見。 - 需要繼續時，告訴模型使用上一次返回的
taskkey。 - 需要找回任務時，讓模型使用
antigravity_tasks列出運行中和最近結束的任務。 - 需要停止時，讓模型使用
antigravity_cancel並傳入運行中任務的taskkey。
可選配置¶
以下配置項都可選。可放在插件設置中，例如 $DSH_HOME/settings.yaml：
dsh-subagent-antigravity:
model: gemini-3.1-pro-high
effort: high
printTimeoutMs: 300000
backgroundTimeoutMs: 3600000
skipPermissions: true
sandbox: false
addDirs: []
proxy: ""
env: {}
extraArgs: []
常用字段含義：
| 字段 | 默認示例 | 說明 |
|---|---|---|
model |
'' |
傳給 agy 的模型標識；留空表示使用 agy 默認模型，可用 agy models 查看 |
effort |
'' |
可選 low、medium、high；留空表示不傳 |
printTimeoutMs |
300000 |
前臺運行的上限，單位爲毫秒 |
backgroundTimeoutMs |
3600000 |
後臺運行的上限，單位爲毫秒 |
skipPermissions |
true |
自動批准 agy 工具調用 |
sandbox |
false |
控制 agy 的 sandbox 相關限制 |
addDirs |
[] |
添加到 agy 工作區的絕對目錄；目標在工作區外時需要 |
proxy |
"" |
代理 URL；會回退到 AGY_PROXY 環境變量，再回退到 ~/.dsh/agy-proxy.txt |
env |
{} |
環境變量覆蓋 |
extraArgs |
[] |
追加到生成參數後面的原始參數 |
注意與排錯¶
- 插件以當前 DSH 進程權限運行。安裝前建議檢查源碼和許可證；該插件許可證爲 MIT。
skipPermissions默認是true，會自動批准agy工具調用。使用前應確認任務目標目錄、文件範圍和你信任的agy登錄狀態。- 任務目標在會話工作區外時，需要把目標目錄放進
dirs參數或addDirs配置。 - 遇到
authentication required：在彈出的登錄窗口完成 sign-in，或調用antigravity_login，再重試。 - 遇到
User location is not supported：設置proxy配置，或寫入~/.dsh/agy-proxy.txt。 - 遇到
timeout waiting for response：調高printTimeoutMs/backgroundTimeoutMs，或改用background: true。
鏈接¶
- 社區目錄頁：
https://www.skillhub.cn/plugins/ZEM17/dsh-subagent-agy - GitHub 倉庫：
https://github.com/ZEM17/dsh-subagent-agy
