Antigravity 主模型 dannndouglas/dsh-antigravity-acp

dsh-antigravity-acp

把 Google Antigravity 账号用作 DeepSeek Harness 里的主模型，搭配 DSH 自有的工具，走 Google 官方 ACP 服务器。不需要 API key。

在 DSH 里安装，然后聊天。 插件会下载官方服务器、发现模型、为新会话选中 Antigravity，并自动接上 DSH 的工具。不用装二进制、不用设环境变量、不用写配置文件、不用配 MCP、也不用在终端登录。需要的话，官方服务器会在你发第一条消息时打开 Google 的浏览器登录页；批准后对话继续。

0.3 版新增私有 MCP 桥。Antigravity 请求某个工具，DSH 按常规权限校验、执行工具、返回真实结果。文件、命令和已安装的扩展工具都走 DSH 这条执行路径。

Português · 架构 ·真实验证 · 研究

安装

需要 Node.js >=22.19。支持 DSH 0.2.0-rc.2 和 0.2.1-alpha.1。
包会使用宿主对应的服务，不需要版本豁免。已在 Windows x64 上配合 Google 服务器 1.3.0 测试；fake-server CI 覆盖 Windows、Linux 和 macOS。
自动下载支持这三种操作系统的 x64 和 arm64。

在 DSH 的插件管理器里，用仓库 URL 安装：

https://github.com/dannndouglas/dsh-antigravity-acp

用终端安装：

dsh plugin --profile web add git+https://github.com/dannndouglas/dsh-antigravity-acp.git

打开配置档，发一条消息。在 DSH Desktop 里安装或更新后，要完全退出 DSH 再重新打开：宿主还开着的时候，即使已安装的包已经显示新版本，它也可能继续用旧的插件模块。没有更新按钮时想更新，就删掉插件、用同一个仓库 URL 再装一次，然后完全退出并重开 DSH。不需要改配置。
包 bundle 会挂载服务商和默认模型。配置档/会话里显式保存的选择仍按 DSH 的常规优先级生效。你可以在普通模型选择器里挑任意已公布的模型。

构建好的 dist 已提交，所以用 Git 安装不需要编译器。包使用宿主的 llm 和 subprocess 服务，不用改 DSH 核心，也不用改全局安装。开发用检出：

npm ci
npm run check
npm pack
dsh plugin --profile web add /absolute/path/to/dsh-antigravity-acp-0.3.3.tgz

工具怎么工作

DSH primary provider → ACP v1 / stdio → official agy_acp_server → Google
↑
private loopback MCP bridge
↓
DSH permissions and tool execution

工具 schema 会自动导出到桥。校验通过的 MCP 请求会变成普通的 DSH 工具调用块，沿用原来的名称和参数。DSH 智能体循环执行它的时候，MCP 请求保持挂起。后续 DSH 生成会返回匹配的工具结果，并继续执行同一个 ACP 提示词。支持并行调用、顺序工具轮次、失败和权限拒绝。被拒绝的操作会一直保持拒绝状态；插件不会尝试绕过。

ACP 原生的工具通知绝不会在 DSH 中重新执行。桥接调用通过官方服务器的 MCP 元数据识别。只允许访问此桥接的权限，每个请求一次；实际的工具执行仍归 DSH。桥接之外的原生 Antigravity 工具会触发取消并抛出明确错误。YOLO 模式、客户端文件系统和客户端终端能力保持关闭。官方可执行文件本身就是智能体，因此这些协议护栏不是操作系统沙箱，无法撤销在通知之前就已执行的原生操作。

DSH 仍是历史记录的权威。独立轮次从完整的 DSH 上下文开始。0.3.3 版本还允许不带工具的请求借用已就绪的服务器进程。第一个此类请求可以占用仍为空的模型发现会话一次，避免重复启动进程和创建会话。之后的独立轮次会收到全新的 ACP 会话；工具轮次始终获得自己的 MCP 桥接。最多两个已完成的进程保持就绪五分钟，然后关闭。取消、错误和流提前终止会丢弃受影响的进程。这是自动的；无需额外设置。每个版本两个真实的 Flash Low 样本测得，发现之后第一个不带工具的请求，0.3.2 中首次输出文本耗时 18–21 秒，而 0.3.3 候选版本为 8.7–9.2 秒。这些样本量很小，不构成延迟保证。冷启动、全新会话、模型选择和 Google 的生成时间仍可能更久。参见计时记录。

只有未完成的工具往返会保留 ACP 状态。上下文/模型/目录变更会丢弃过期的交互。工具轮次使用单独托管的进程，允许并发聊天以及来自子代理工具的提供商调用。DSH 正在运行工具或等待批准时，取消仍然有效。

自动服务器与登录

完整、未经修改的服务器归档直接从 dl.google.com 获取，使用来自官方 ACP Registry的固定 1.3.0 URL。所有同级运行时文件都会保留。缓存在 $DSH_HOME/cache/antigravity-acp 下，DSH 之外则为 ~/.cache/dsh-antigravity-acp。完整的缓存会被复用；不完整/损坏的下载会自动重试。下载需要常规 HTTPS 验证，拒绝重定向，并校验 ZIP 路径/类型/大小。Registry 不提供校验和；不会杜撰厂商签名。Google 二进制文件不捆绑也不重新分发。没有 postinstall 脚本。

OAuth 仅使用官方服务器公布的 oauth-personal 方法。插件从不读取、复制或存储账户凭据。模型发现不在后台打开登录浏览器。模型与后端网络请求由官方可执行文件负责；插件不使用任何私有的 Google 模型端点。

可选设置

默认值无需改动。高级配置档补丁针对已有行：

- id: llm-antigravity-acp
config:
toolPolicy: bridge
timeoutMs: 600000
toolTimeoutMs: 900000

| 选项 | 默认值 | 含义 |
| provider | antigravity-acp | DSH 服务商路由 |
| command | 空 | 先查找已有服务器，再自动下载 |
| autoInstall | true | 缺失时自动准备 Google 服务器 |
| installTimeoutMs | 180000 | 下载与解压的截止时间 |
| args | [] | 额外 argv；绝不按 shell 文本解析 |
| auth | oauth-personal | 官方认证方式 |
| defaultModel | 空 | 服务器公布的精确 ID；留空则用服务器默认值 |
| models | [] | 额外 ID，使用前先校验 |
| toolPolicy | bridge | 自动启用 DSH MCP 桥接；text-only 省略工具；reject 拒绝工具 schema |
| timeoutMs | 600000 | 模型活跃阶段的截止时间，工具执行期间暂停计时 |
| toolTimeoutMs | 900000 | 等待 DSH 工具结果或审批的截止时间 |
| maxActiveToolSessions | 16 | 并发未完成工具轮次的上限 |
| idleProcessTimeoutMs | 300000 | 轮次之间最多保留两个已完成的服务器进程待用 |
| requestTimeoutMs | 30000 | 协议建立与配置的截止时间 |
| authTimeoutMs | 600000 | 官方浏览器授权的截止时间 |
| cancelGraceMs | 1500 | 发送 ACP cancel 的时限 |
| disposeGraceMs | 3000 | 受管进程 EOF 的宽限时间 |
| maxSessionsPerProcess | 100 | ACP 会话之间回收保留进程的阈值 |

查找顺序：command、AGY_ACP_BIN、PATH、已知用户目录、自动安装。显式覆盖优先级最高；路径损坏会明确报错。
Linux 使用 Registry 的 uid 启动标志。没有账号选择界面。

可选诊断命令：dsh-antigravity-acp status、doctor、probe、login、logout。status/doctor 绝不会发起交互式登录。logout 会影响服务端的共享账号状态，绝不会自动运行。独立命令行需要 DSH 可选的 subprocess-local peer；插件激活使用 ctx.subprocess。

剩余协议限制

- 文本与推理流。二进制图像/音频输入尚未实现。DSH 必须为这条文本路由投影附件；非文本的工具结果块以 JSON 元数据发送，不解引用文件字节。
- 系统指令会序列化进 ACP 的用户提示词。官方智能体自身的系统指令仍然保留；ACP 不是原始模型 API。
- temperature、maxTokens、stop 和显式 reasoningEffort 会以 UNSUPPORTED_OPTION 失败。请选择已公布的模型变体来指定其推理档位。
- usage_update 衡量上下文占用。可计费 token 数与未知的上下文容量不会凭空编造。
- 没有持久化的 ACP 恢复。重启或更换服务商会从保存的 DSH 历史重建。部分流式传输的请求绝不会自动重放。
- 限制：256 个活跃工具定义，每个定义 128 KiB，MCP 请求体 1 MiB，每轮 64 个并发待处理调用。不支持的 schema 会显式失败。

故障排查

| 代码 | 操作 |
| ACP_INSTALL_FAILED | 检查网络连通性/可用磁盘空间后重试 |
| ACP_AUTH_REQUIRED | 在首条消息时完成官方浏览器授权 |
| ACP_INVALID_MODEL | 选择 doctor/model picker 公布的精确 ID |
| ACP_MCP_UNSUPPORTED | 使用支持 HTTP MCP 能力的官方服务器 |
| ACP_NATIVE_TOOLS_UNSUPPORTED | 仅使用 DSH bridge 工具重试；原生智能体活动已取消 |
| ACP_TOOL_RESULTS_MISSING | 从保存的 DSH 历史重试；某个工具结果缺失/重复 |
| ACP_TOOL_TIMEOUT | 在截止时间内完成审批/执行，或增大 toolTimeoutMs |
| ACP_TOOL_CATALOG_INVALID | 修正所报告工具的 JSON schema/名称 |
| ACP_SESSION_LIMIT | 完成/取消现有轮次，或提高 maxActiveToolSessions |
| ACP_TIMEOUT / ACP_DISCONNECTED | 重试以重新连接；检查服务器连通性 |
| ACP_TEARDOWN_FAILED | 重启配置档；无法验证托管清理 |
| UNSUPPORTED_OPTION | 移除不支持的采样设置，或投影二进制输入 |
远程错误和 stderr 会被清空，不记录账号或认证数据。本地 MCP bearer token 是临时的，绝不写入日志，也和 OAuth 凭据无关。

验证

npm run check
npm run format:check
npm audit --omit=dev
npm pack --dry-run
node scripts/smoke-real.mjs
node scripts/smoke-tools-real.mjs

真实冒烟测试需要手动开启，会消耗账号配额，绝不在 CI 里运行。假服务器覆盖传输、安装器、流式传输、生命周期和工具续接。这份验证记录区分了真实安装的 DSH 检查和协议测试。MIT；第三方声明。独立社区插件，与 Google 或 DeepSeek 无隶属关系。