前言¶

在 DSH 里接入 Google 官方 Antigravity ACP agent，可以让同一个对话界面同时选择模型、查看额度、预热连接，同时保持工具调用在 DSH 的校验与审批流程中完成。这把 Antigravity 的推理能力与 DSH 的工具生态连接起来，而不改变 DSH Core 的核心逻辑。

插件定位¶

Antigravity ACP for DSH 是一个 Host + Web Client bundle。Host 负责注册模型 provider、管理官方进程和工具桥，Client 提供设置页与额度药丸。它通过 stdio 与 ACP v1 协议连接官方 Antigravity agent，再用私有 loopback MCP 桥将工具调用挂起给 DSH 处理，结果回填给 agent。它不是直接的 Gemini 模型 API，而是将 Antigravity agent 纳入 DSH 的对话与工具体系。

安装与启用¶

使用示例 Profile 安装：

dsh plugin --profile web add dsh-bundle-antigravity-host

web 是示例 Profile，请替换为实际目标。DSH NEXT Desktop 使用目标桌面壳提供的 DSH Desktop CLI；不要用独立 npm 公共 CLI 管理保留的 desktop Profile。

安装后按部署方式重载或重启，让 Host 与 Client 一起生效；只刷新页面不保证 Host 已升级。

打开「设置 → Antigravity ACP」：
- 需要代理时先配置并保存，再点击 连接 / 登录 ACP。
- 插件优先复用已有 ACP 登录态，或导入本机已登录的官方 CLI 登录态；必要时才进入官方浏览器授权。
- 成功建会话后读取模型目录，不需要先发送聊天。

选择模型，开始对话：提供商名称为 Antigravity (ACP)，路由 ID 为 antigravity-acp。模型选择器左侧会出现额度药丸和预热按钮；工具调用继续走 DSH 的校验、审批与执行。

核心功能¶

• 多会话并发与排队：默认按需启动最多 2 个独立 worker，可配置为 1–4 个。一个会话等待工具审批时，其它会话可使用空闲 worker；同一工具回合的结果仍回到原 worker。容量用满后排队，支持取消，默认等待上限 120 秒，主对话优先于排队中的后台标题。

• 先连接、再聊天：设置页区分 立即预热 与 连接 / 登录 ACP。前者准备连接但不创建会话，后者验证会话并读取模型目录。两者都不发送聊天 prompt。目录使用缓存即时显示，支持主动刷新、选择默认模型或手填模型 ID；目录外 ID 明确标记为未验证。模型家族与思考强度分开：选择家族，再由 DSH 的思考强度菜单路由到官方对应档位。

• 图片输入能力：在宿主附件服务可用且上游声明 image capability 时，当前消息、历史消息和工具返回的图片通过真实图片内容传入。支持 PNG、JPEG、WebP 与 GIF；只读取宿主附件，不自行抓取图片 URL。已被宿主卸载的图片会明确说明未发送像素。这是输入能力，不包含图片生成、音频或视频。

• 额度与连接状态：模型选择器旁的额度药丸会随当前模型切换对应额度组；展开可查看三个组的窗口、剩余百分比、重置时间与缓存状态。上游未单列 Argon 组时使用 Gemini 共享额度，不误报未知。AI Credits 与套餐额度独立展示、独立缓存与报错；未知不是零，不会自动开启 Credits 付费回退。药丸可直接预热；设置页集中连接与模型管理，高级配置及连接阶段、排队、进程复用和耗时按需展开。额度与余额只保留在药丸，不再在设置页重复展示。

• 设置不丢草稿：后台刷新保留未保存字段，外部冲突明确提示；遵守宿主只读状态。

配置与边界¶

• 模型参数：reasoningEffort 映射官方档位；maxTokens 忽略；显式 temperature / stop 记录警告并忽略，值不生效。

• 工具与权限：AGY 内置工具、ACP fs / terminal 关闭；只允许已识别的私有桥请求进入 DSH，allow_once 不等于绕过 DSH 审批。协议约束不是 OS 沙箱。

• 登录材料：插件可能读取 CLI 登录文件，并为官方 ACP 写入 / 更新本机凭据文件；这些文件不是加密凭据库，Windows 访问保护依赖目录 ACL。

• 官方程序：按需从 https://dl.google.com 下载，拒绝重定向并检查 ZIP 路径；官方未提供校验和，不宣称签名验证通过。默认 server 版本为 1.4.0，不跟随 registry 自动升级。

• 数据可信度：缓存、失败、缺字段和未知分别标记；额度与余额仅供参考，不是计费依据。

• 版本与测试：宽 peer 范围是安装条件，不是全部 Core / 平台版本实机兼容证明；隔离测试不替代真实账号与 GUI 验收。

• 宿主附件服务是可选依赖，缺少时仍可文本聊天，但不声明图片能力。

兼容性与验证范围¶

• Node.js：>=22.19

• DSH Core peer 范围：>=0.2.0-rc.1 <0.2.1-0 || >=0.2.1-0 <0.3.0-0，适用于所声明的三个 dsh-* peer

• 开发契约基准：dsh-llm / dsh-subprocess / dsh-typert-protocol / dsh-attachment 0.2.1-alpha.4，Cordis 4.0.5-alpha.2

• 上游协议：ACP v1；SDK 1.4.0 与默认 server 1.4.0 是两个独立版本

• 当前源码本地验证：类型检查、36 个文件 / 617 项测试、构建；本机安装另行核验

• 尚未覆盖：0.1.28 安装后的 Desktop GUI、真实上游生成与图片识别、非 Windows 实机

适用场景与注意¶

适合希望在 DSH 里使用 Antigravity 模型，同时继续使用 DSH 的工具校验、审批与执行流程的场景。

注意：插件以当前 dsh 进程权限运行。安装前应检查源码与许可证。Google Antigravity 官方程序是独立下载的第三方软件，不随本包再分发；本插件并非 Google 官方产品。

总结¶

Antigravity ACP for DSH 提供了一套将 Antigravity agent 纳入 DSH 对话与工具体系的方案。它通过 stdio 与 ACP v1 协议连接官方 agent，用私有 loopback MCP 桥将工具调用交给 DSH 处理，并在对话旁展示额度与连接状态。如果你想在 DSH 中使用 Antigravity 模型并保持工具调用在 DSH 流程中，可以考虑这个插件。

• 插件目录页：https://www.skillhub.cn/plugins/KouzakiUmi/dsh-antigravity-acp
• GitHub 仓库：https://github.com/KouzakiUmi/dsh-antigravity-acp