前言¶
在 DeepSeek Harness(DSH)里做复杂编码任务时,父会话往往希望把一块独立工作交给另一个「会改文件、会跑命令」的智能体,只拿回最终结论,而不是把子进程里的工具流水和 stderr 全部灌进主对话。官方已有与 Codex、Claude Code 同形态的子智能体;若你希望后端是 Google 的 Antigravity CLI(agy),并借助已登录的 Antigravity 订阅使用 Gemini 4 Argon(gemini-4-argon-low/medium/high),而不单独配置 Gemini API Key,就需要一条从 DSH 调用 agy 的接缝。
下面介绍社区插件 dsh-subagent-antigravity(维护者 PipeDream941,分类:工作流)。它在 DSH 中注册 subagent_antigravity 工具,以一次性子进程方式驱动官方 agy,在父工作区内完成编码类委托。
这是什么¶
dsh-subagent-antigravity 是 DSH 的 Antigravity 子智能体插件:父会话调用 subagent_antigravity({ description, prompt }),经 ctx.subagents 的 antigravity 提供方拉起 agy --print --output-format stream-json,解析 NDJSON 事件后只把最终答案返回父对话。形态与 subagent_codex、subagent_claude_code 一致,后端为 Antigravity。
插件为社区作品,与 Google 无隶属关系;Antigravity CLI 为 Google 官方 CLI,本插件仅从 DSH 侧驱动它。npm 包名 dsh-subagent-antigravity,当前资料中的版本为 0.1.0,许可证 MIT。
为何需要 Antigravity 而不是 Gemini CLI¶
资料中说明:Gemini CLI 0.64 仍止于 gemini-3.8-flash / gemini-3.1-pro-preview 等;Gemini 4 并非公开 API 模型,相关支持请求仍在进行中。Gemini 4 Argon 目前通过 Antigravity 向 Google AI Pro / Ultra 订阅用户提供,可用 agy models 查看本账号可用模型。若要在 DSH 里「像调用 Codex 一样」使用 Gemini 4,应走 Antigravity CLI;Gemini CLI 路线由兄弟插件 dsh-subagent-gemini 覆盖,待 Google 在 CLI 侧提供 Gemini 4 后再对齐。
工作原理(概要)¶
一次委托 = 一个新进程、一轮交互、仅最终答案:
- 父会话(DeepSeek 模型)调用工具
subagent_antigravity。 - DSH 子智能体接缝(
ctx.subagents,本插件注册antigravity)。 - 运行层 spawn
agy,解析init/step_update/result等 NDJSON,保留最终答案。 agy在父进程 cwd、你的 Antigravity 登录与订阅下使用其自带能力(文件、终端、浏览器、MCP 等)。- 子智能体的推理与工具细节不进入父对话;失败时返回固定阶段/类别诊断,而非原始 stderr 或凭据。
环境与依赖¶
| 依赖 | 要求 |
|---|---|
| DeepSeek Harness | 0.2.1-rc.2 系列(ctx.subagents + @deepseek-ai/dsh-tool-subagent) |
| Node.js | ^22.19.0 或 >=24 |
Google Antigravity CLI (agy) |
官方 CLI,1.4+;agy --version 需有输出 |
| Antigravity 账号 | 通过 Antigravity 应用或 CLI 登录(Gemini 4 Argon 需 AI Pro / Ultra 订阅) |
先安装官方 CLI 并确认版本与模型列表:
# macOS / Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash
# Windows (PowerShell)
# irm https://antigravity.google/cli/install.ps1 | iex
agy --version # 资料期望 1.4.2+
agy models # 列出本账号可用模型(含 gemini-4-argon-*)
本地 Antigravity 表面共享登录态;若应用已登录,agy 通常可直接使用,否则运行一次 agy 完成 Google 登录。企业场景可使用 AGY_ADC_AUTH=true 配合 gcloud auth application-default login,或 GEMINI_API_KEY 模式(资料注明:API Key 本身若无权限则无法使用 Gemini 4)。
安装与启用¶
插件市场(推荐): 在 DSH 插件市场中搜索 dsh-subagent-antigravity,安装并启用。
命令行:
dsh plugin --profile desktop add dsh-subagent-antigravity
随后在对应 profile 的 package.json 的 dsh.profile.bundles 中加入该包并重启(或等待 profile 重新组合):
"dsh": {
"profile": {
"bundles": ["…", "dsh-subagent-antigravity"]
}
}
启用后,各 agent 可见全局工具 subagent_antigravity;已在运行的会话会在下一次请求时加载。
DSH 生态理念是「一切皆插件」;社区目录站点(如 skillhub.cn)为独立收录,与 DeepSeek / 幻方无官方从属关系,本文不将其描述为官方应用商店。
典型用法¶
工具调用示例(prompt 须自包含,子智能体看不到父会话历史):
{
"name": "subagent_antigravity",
"arguments": {
"description": "Fix login timeout",
"prompt": "In the workspace, raise the login request timeout from 5s to 15s, run the related tests, and reply only with what you changed and the test result."
}
}
description:约 3–5 个词的 task 名称。prompt:完整任务说明。
配置项¶
在 profile patch 中覆盖 subagent-antigravity 条目的 config:
| 字段 | 默认 | 含义 |
|---|---|---|
providerName |
antigravity |
在 ctx.subagents 上注册的名称 |
command |
空(自动探测) | agy 路径;空则在 PATH、~/.local/bin 等常见位置查找 |
model |
gemini-4-argon-medium |
固定模型;以 agy models 为准 |
effort |
空 | low / medium / high / xhigh / max |
mode |
空 | accept-edits / auto / plan(只读) |
skipPermissions |
true |
为 true 时传 --dangerously-skip-permissions,无人值守可写可跑 |
sandbox |
false |
是否传 --sandbox |
timeoutMs |
900000(15 分钟) |
单次委托总时限 |
disposeGraceMs |
5000 |
SIGTERM 后 SIGKILL 宽限 |
env |
{} |
额外子进程环境变量 |
extraArgs |
[] |
额外 CLI 参数 |
只读委托示例(Gemini 4 Argon High + plan 模式):
- id: subagent-antigravity
config:
model: gemini-4-argon-high
mode: plan
skipPermissions: false
安全与权限¶
默认 skipPermissions: true 表示子进程可在无人工确认的情况下改文件、跑命令,适合可信工作区;完成后应自行 git diff 审查。只读场景使用 mode: plan 且 skipPermissions: false;无头模式下无法弹窗,写操作会被拒绝并报告 permission 类失败。子进程与父进程隔离:DSH 会从父环境剥离类凭据变量,仅转发 config.env 中声明的项。资料称插件不采集遥测、不读写 Antigravity 登录凭据,登录由 CLI 自行管理。
故障排查(节选)¶
| 现象 | 处理 |
|---|---|
Antigravity CLI (agy) was not found |
执行官方安装脚本并确认 agy --version |
诊断 category: auth |
未完成登录:运行 agy 并完成 Google 登录 |
诊断 category: permission |
无头无法确认:保持 skipPermissions: true 或使用 mode: plan |
诊断 category: quota |
当前账号对该模型配额或限速用尽 |
诊断 category: timeout |
增大 timeoutMs 或拆分任务 |
在插件源码目录可运行 npm run smoke 做一次真实 agy 小请求自检(资料描述为期望 PONG)。
适用场景与注意¶
适合已在 DSH 0.2.1-rc.2 系列上使用子智能体接缝、且本机已安装并登录 Antigravity CLI 的开发者:需要把一块编码工作外包给 agy(含 Gemini 4 Argon 与其它订阅模型),又希望父会话界面保持简洁。
安装前请自行查看 GitHub 源码与 MIT 许可证;插件以当前 DSH 进程权限运行子进程,默认允许无人值守写盘与执行命令,仅在可信仓库中使用。单元测试与开发细节见仓库 README(如 npm test、34 个用例等)。
链接¶
- 社区目录页:https://www.skillhub.cn/plugins/PipeDream941/dsh-subagent-antigravity
- 源码与文档:https://github.com/PipeDream941/dsh-subagent-antigravity
经过上面的步骤,父会话即可在 DSH 内通过 subagent_antigravity 调用官方 agy,在订阅范围内使用 Gemini 4 Argon 等模型完成一次性编码委托,并将结果收敛为最终答案返回主对话。