前言¶
在 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
