前言¶

DeepSeek Harness（DSH）的主 Agent 在自己的工具循环里完成大部分工作。若希望某段自包含任务在 Google Antigravity 的原生 Agent 循环里执行——由 ACP 负责推理、文件读写、命令与工具，而 DSH 只负责派发、进程生命周期和结果回传——需要在 Profile 里挂载对应的 subagent 提供方。官方仓库提供了 Codex 形态的参考实现；社区维护的 @ashenjyy/dsh-subagent-antigravity 按同一分层，对接 Google Antigravity ACP Server 1.4.3，面向 DSH 0.2.1-rc.3。下面介绍它是什么、如何安装，以及首次使用前必须完成的认证配置。

这是什么¶

@ashenjyy/dsh-subagent-antigravity 由维护者 AshenJyy 发布，在 SkillHub 插件目录 中归类为工作流。它是社区插件，不是 DeepSeek 或 Google 的官方集成；也不调用 agy --print、不操纵 Antigravity App 界面，更不会把模型接进 DSH 的 Agent 循环代替原生执行。

每次委派会启动全新的 ACP Server 与配套原生 harness，创建一个会话、发送一轮自包含文本任务，然后由 Antigravity 自行完成工具循环。DSH 侧注册一个提供方实例和全局工具 subagent_antigravity，负责子进程、取消与结果通知。实现架构对齐官方 @deepseek-ai/dsh-subagent-codex。

核心功能¶

1. 一次性原生委派：每任务一个原生进程、一个新会话、单轮文本输入；不池化、不恢复会话、不支持追加输入。
2. 可选认证与模型策略：支持 native、oauth-personal、oauth-business、gemini-api-key、agent-platform、gateway 等 authMethod；可选固定 model、effort（ACP thinking_level），省略时使用原生默认值。公开 Bundle 不限定模型或 effort；配置失败不会回退到其他模型或后端。
3. 全局工具：启用 Bundle 后暴露 subagent_antigravity。父 Agent 委派后先得到 child ID，执行在后台继续，最终通知父 Agent；结果以 ACP 助手文本为主，推理与工具日志不进入父上下文。
4. Windows x64 完整发行包（0.2.1）：Release 中的 ashenjyy-dsh-subagent-antigravity-0.2.1-win32-x64.tgz 已内置 ACP 1.4.3 运行时，正常安装无需再跑 dsh-antigravity-install。

安装与启用¶

先从 GitHub Releases 下载 ashenjyy-dsh-subagent-antigravity-0.2.1-win32-x64.tgz。完整包带 os/cpu 约束，避免装到错误平台；仍需要 DSH 依赖和本机可用的认证配置，不包含账号或凭据。请使用本仓库发行包，避免与其他同名 npm 包混淆。

在 CLI 中选中实际使用的 Profile（示例为 web），用绝对路径添加本地 Bundle：

dsh plugin --profile web add /absolute/path/to/the-release-package.tgz

运行时已位于包内 native/1.4.3/win32-x64/，一般省略 Provider 的 runtimeDir 即可。启用后 DSH 若提示重启请重启；仅启用插件不会启动原生进程。

package.json 要求 Node >= 22 与 dsh 0.2.1-rc.3。许可证为 MIT（Google 运行时另有 NOTICE 声明）。

认证（首次使用前必做）¶

安装插件不会自动打开登录页；0.2.1 也没有专门的登录按钮。 首次 OAuth 或切换认证方式时，应先执行安装包自带的认证命令（路径不在 PATH 时可用 node .../lib/auth-cli.js）：

dsh-antigravity-auth --method oauth-personal --gemini-home /absolute/path/to/your-acp-home

命令只做 initialize 与显式方法的 authenticate，不建会话、不发送 prompt；成功也不等于后续模型调用一定可用。Provider 中应保存与 CLI 一致的 authMethod、geminiHome 等字段。个人 OAuth 在 DSH 中可写成：

- id: subagent-antigravity
  config:
    authMethod: oauth-personal

Agent Platform 使用 ADC 时，除 gcloud auth application-default login 外，还应在 Provider 中配置 gcpProject、gcpLocation，必要时 adcPath（须为 DSH 子进程可读的文件绝对路径）。API Key 类方式通过 Provider 的 env 提供 GEMINI_API_KEY 或 GOOGLE_API_KEY，不要把密钥写入命令行或公开仓库。

更多字段见 README 配置表：startupTimeoutMs 默认 90000，permissionMode 默认 deny（或 allow-once 允许受支持的普通工具单次审批）等。

典型用法¶

Bundle 启用后，Host 会注册 subagent_antigravity 工具（provider: antigravity）。父 Agent 在认证与可选模型配置就绪后，通过该工具把自包含文本任务交给 Antigravity；工作目录与任务内容由委派载荷决定，子 Agent 不继承父对话与 DSH 工具。

委派行为要点（来自文档「你会得到什么」）：

• 原生会话就绪后，工具先返回 child ID，执行异步进行，DSH 再向父 Agent 通知终态。
• 结果包含助手文本、停止原因与可选安全诊断；取消不会回滚已发生的文件或外部修改。
• 本外部提供方不支持 DSH 深度强制、输出 schema、agentPreset 或 agentOptions；需保留 maxDepth: provider-managed。

需要同一 Profile 内多套模型或 effort 时，应挂载多个 Provider 实例并配置不同工具名，因为模型与 effort 固定在 Provider 实例上，不是每次工具调用的动态参数。

适用场景与注意¶

适合：已在 DSH 0.2.1-rc.3 上运行主 Agent，希望把独立、单轮、文本化的编码或调研任务交给 Antigravity 原生能力，且能接受每次任务单独起进程的开销。

不适合或需知限制：

• 当前完整发行包面向 Windows x64；其他平台仅见发行元数据，文档注明未运行验证。
• 固定兼容 DSH 0.2.1-rc.3、ACP runtime 1.4.3、ACP v1；升级 DSH 或 ACP 需重新核对。
• OAuth 过期或缺失时，委派仍可能触发浏览器流程，受 startupTimeoutMs 约束。
• App 或 agy 的登录不保证 ACP 可用；ACP 与 DSH 使用独立凭据存储。
• 插件以当前 DSH 进程权限运行子进程；安装前应阅读 GitHub 源码 与 MIT 许可证，自行评估凭据与环境变量暴露范围。SkillHub 目录为社区站点，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-subagent-antigravity 把 DSH 的 subagent 委派链接到真实的 Antigravity ACP 运行时：DSH 管派发与进程，Antigravity 管推理与工具。按 Release 完整包安装、完成显式认证配置后，即可通过 subagent_antigravity 在工作流中接入原生 Antigravity。

• 插件目录：https://www.skillhub.cn/plugins/AshenJyy/dsh-subagent-antigravity
• 源码与文档：https://github.com/AshenJyy/dsh-subagent-antigravity