dsh-subagent-antigravity:在 DSH 中把 Google Antigravity CLI 当作一次性编码子智能体

前言

在 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 后再对齐。

工作原理(概要)

一次委托 = 一个新进程、一轮交互、仅最终答案:

  1. 父会话(DeepSeek 模型)调用工具 subagent_antigravity。
  2. DSH 子智能体接缝(ctx.subagents,本插件注册 antigravity)。
  3. 运行层 spawn agy,解析 init / step_update / result 等 NDJSON,保留最终答案。
  4. agy 在父进程 cwd、你的 Antigravity 登录与订阅下使用其自带能力(文件、终端、浏览器、MCP 等)。
  5. 子智能体的推理与工具细节不进入父对话;失败时返回固定阶段/类别诊断,而非原始 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 等模型完成一次性编码委托,并将结果收敛为最终答案返回主对话。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜