Antigravity ACP for DSH
在 DSH 里使用 Antigravity 模型，工具仍交给 DSH。
接入 Google 官方 Antigravity ACP agent，在同一个对话界面选择模型、查看额度、预热连接。
快速开始 · 功能预览 · 功能亮点 · 配置参考 · 排障 · 更新记录
> 0.1.25：修复冷启动时登录 / 预热握手超时（新增 handshakeTimeoutMs，默认 120 秒），默认开启预热并显示启动进度。类型检查、33 个文件 / 515 项测试与构建通过；真实 Desktop GUI 与跨平台验收尚未完成。查看本次更新与限制。上一版 0.1.24 的并发池、模型发现与图片输入见更新记录。
> 0.1.31 · 一轮可靠性加固：额度 HTTP 取数补超时（挂起的请求不再让药丸永久停在读取中）、401/403 重试改按状态码判断、非法代理不再让插件装载失败、恢复会话失败归还磁盘 claim、单条畸形 JSON-RPC 帧只丢弃不再判死整条链路、zip 解压加压缩炸弹上限。本地类型检查、38 个文件 / 658 项测试与构建通过。发布不代表本机安装已更新。查看更新与生效边界
快速开始
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 的校验、审批与执行。
额度或 AI Credits 没有显示？ ACP 连接与 CLI 登录是两条链路。额度查询优先使用已登录的官方 agy，AI Credits 仅从 CLI 读取；ACP 登录成功不代表 CLI 也已登录。登录态与数据来源
功能预览
左：模型选择器旁的额度药丸，展开后按额度组显示窗口与剩余百分比。右：设置页的连接状态、分阶段耗时与模型管理。画面来自当前 src/client.js 的真实组件，数字与套餐名均为虚构。
功能亮点
多个对话，不再共用一个待审批回合
默认按需启动最多 2 个独立 worker，可配置为 1–4 个。一个会话等待工具审批时，其它会话可使用空闲 worker；同一工具回合的结果仍回到原 worker。容量用满后排队，支持取消，默认等待上限 120 秒，主对话优先于排队中的后台标题。
这不是无限并发，也不保证上游账户额度随 worker 数增加。并发与续轮边界
先连接、拿目录，再开始聊天
设置页区分 立即预热 与 连接 / 登录 ACP：前者准备连接但不创建会话，后者验证会话并读取模型目录，两者都不发送聊天 prompt。目录使用缓存即时显示，支持主动刷新；模型列表按模型逐项控制是否出现在 DSH 选择器、默认思考档位、显示名与官方 ID 映射。
模型家族与思考强度分开：选择家族，再由 DSH 的思考强度菜单路由到官方对应档位。不硬编码账号应当拥有的模型清单。模型与请求项映射
图片传给模型，不只传一段文字说明
在 宿主附件服务可用且上游声明 image capability 时，当前消息、历史消息和工具返回的图片通过真实图片内容传入。支持 PNG、JPEG、WebP 与 GIF；只读取宿主附件，不自行抓取图片 URL。已被宿主卸载的图片会明确说明未发送像素。
这是输入能力，不包含图片生成、音频或视频；真实图片识别效果尚未实机验收。多模态限制
额度、余额与连接状态，就在对话旁
- 额度药丸：随当前模型切换对应额度组；展开查看三个组的窗口、剩余百分比、重置时间与缓存状态。上游未单列 Argon 组时使用 Gemini 共享额度，不误报未知。
- AI Credits：与套餐额度独立展示、独立缓存与报错；未知不是零，不会自动开启 Credits 付费回退。
- 预热与诊断：药丸可直接预热；设置页集中连接与模型管理，高级配置及连接阶段、排队、进程复用和耗时按需展开。额度与余额只保留在药丸，不再在设置页重复展示。
- 设置不丢草稿：后台刷新保留未保存字段，外部冲突明确提示；遵守宿主只读状态。
它如何工作
flowchart LR
D[DSH 对话] --> A[本插件 LlmAdapter / worker 池]
A -->|stdio · ACP v1| G[官方 Antigravity agent]
G -->|私有 loopback MCP| B[本插件工具桥]
B -->|挂起调用| T[DSH 校验 / 审批 / 执行]
T -->|工具结果回填原 prompt| B
B --> G
本包是 Host + Web Client bundle：Host 注册模型 provider、管理官方进程和工具桥，Client 提供设置页与额度药丸。不修改 DSH Core，也不把官方 CLI 包装成聊天接口；CLI 仅用于只读模型目录、额度与余额查询。
它不是直接的 Gemini 模型 API。 默认情况下同一 DSH 对话会复用同一个 ACP 会话，在输入前缀与上一步输出一致时，后续回合只发送新增消息，未变化的上下文去重，变化内容仍发送，历史由官方 agent 自己持有；历史被压缩、回退或编辑，或模型、系统提示、工具目录变化时自动重建会话并全量重放一次（reuseSessions=false 可回到每轮重放）。工具续轮仍在同一个 prompt 内完成。角色消息、采样控制、延迟与计费不能视为和原生 API 相同。
使用前，先知道这些边界
| 边界 | 当前行为 |
|---|---|
| 工具与权限 | AGY 内置工具、ACP fs / terminal 关闭；只允许已识别的私有桥请求进入 DSH，allow_once 不等于绕过 DSH 审批。协议约束不是 OS 沙箱。 |
| 登录材料 | 插件可能读取 CLI 登录文件，并为官方 ACP 写入 / 更新本机凭据文件；这些文件不是加密凭据库，Windows 访问保护依赖目录 ACL。 |
| 官方程序 | 按需从 https://dl.google.com 下载，拒绝重定向并检查 ZIP 路径；官方未提供校验和，不宣称签名验证通过。默认 server 版本为 1.4.0，不跟随 registry 自动升级。 |
| 模型参数 | reasoningEffort 映射官方档位；maxTokens 忽略；显式 temperature / stop 记录警告并忽略，值不生效。 |
| 数据可信度 | 缓存、失败、缺字段和未知分别标记；额度与余额仅供参考，不是计费依据。 |
| 版本与测试 | 宽 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 是两个独立版本 |
| 当前源码本地验证 | 类型检查、38 个文件 / 658 项测试、构建；本机安装另行核验 |
| 尚未覆盖 | 0.1.31 安装后的 Desktop GUI、真实上游生成与图片识别、非 Windows 实机 |
宿主附件服务是可选依赖，缺少时仍可文本聊天，但不声明图片能力。安装准入、开发类型检查和真实运行兼容性分别看待。完整声明与验证方法
文档导航
| 你想做什么 | 文档 |
|---|---|
| 安装、连接、查看额度或排查错误 | 使用与技术参考 |
| 调整并发、超时、模型、代理或二进制位置 | 完整配置与环境变量 |
| 查看 0.1.24 更新、迁移注意与剩余限制 | 更新记录 |
| 构建、测试、打包或维护 npm 发布流程 | 开发、验证与发布 |
许可与反馈
本插件采用 MIT License。Google Antigravity 官方程序是独立下载的第三方软件，不随本包再分发；本插件并非 Google 官方产品。
遇到问题请提交 Issue，附插件版本、实际 DSH Core 版本、操作系统、操作步骤和已脱敏错误码。不要附 token、Cookie、完整 OAuth URL、代理密码或凭据文件。
