Saltar al contenido principal
A

dsh-antigravity-acp

angusggsimid/dsh-antigravity-acp

Gemini through the official Antigravity ACP server, with tools executed locally over a reverse tunnel. The default model is Gemini 3.8 Flash, and a route can use any model id that agy accepts.

Instalar

dsh plugin --profile web add github:angusggsimid/dsh-antigravity-acp

README

Antigravity ACP

English

DeepSeek Harness 插件。用官方 Antigravity CLI(agy acp)把 Gemini 接进 DSH。发往 Google 的请求由官方进程发出。读文件、跑命令这些工具仍在运行 DSH 的这台机器上执行。

默认模型是 Gemini 3.8 Flash。Antigravity CLI 在那台机器上接受哪个模型 id,就在路线的 modelId 里写哪个。换模型不换隧道,也不换工具路径。

选中这个模型时,设置页和输入框旁会显示订阅额度里的 5 小时窗口和每周窗口。

本机连到远端的官方客户端

一条插件,三条路线

请求怎么走

一条插件,多条路线

代码在 antigravity-acp/。仓库根目录的 package.json 指向这个目录,所以按仓库地址安装即可。本机开发仍可 link: 到该目录。

它会动到什么

装上之后,这个插件会:

  • 通过 SSH 在你自己的远端机器上启动 agy acp。
  • 在本机开一个 MCP 服务,并用反向隧道把远端的工具调用送回来。
  • 在远端准备一个隔离的 agy 家目录,并写入一个不带内置文件和终端工具的 agent。

它不会替你登录 Google,也不会把主机、密钥或端口写进仓库。这些都在你本机的配置文件里。

它做什么

  • 在模型列表里提供一条 Gemini 路线,默认是 Gemini 3.8 Flash。同一份插件可以登记多条路线,每条路线是一个 modelId、一台远端机器、一个登录。
  • 多个 DSH 会话可以同时使用这个模型。每个 ACP 会话有自己的 worker。
  • 断线或空闲之后,优先恢复原来的 ACP 会话,而不是整段重放。
  • 工具被退回 unknown tool 时,下一轮自动换一个新的 ACP 会话:先确认反向隧道可通,再把当前对话重放进去。每个会话最多重建两次,之后照常失败并报错,不会无限重连。
  • 远端转发端口被上一次 DSH 留下的会话占用时,自动换一个远端端口重连,并让受影响的会话重建。需要固定端口时在该路线写 remotePort。
  • 设置里有一节「Antigravity 订阅」;输入框在选中 Gemini 时显示剩余额度。

拓展

路线写在本机配置里,不写进仓库。聊天、工具回传和额度展示都走同一段代码:加一条路线不会分出第二套插件。设置页按路线各显示一行额度,输入框只显示当前选中的那一条。某条路线没有额度桥时,聊天不受影响。

它不做什么

  • 不伪装成别的客户端,也不复刻 Gemini 的 HTTP 接口。
  • 不从 ACP 对话里读取 5 小时 / 每周额度。ACP 只返回这一轮的 token。额度来自一条单独的本地 HTTP 桥,没有这条桥时聊天仍然可用。
  • 不在这里管理云端账号。登录在远端的 agy 里完成。
  • 包名是 dsh-antigravity-acp,已经去掉 private,但还没有发布到 npm。从 GitHub 地址安装不依赖 npm。

使用前要有的东西

  • DeepSeek Harness。
  • 一台能运行官方 agy 的机器,以及从本机到它的 SSH。
  • 远端的 agy 已经登录 Google AI Pro / Antigravity。
  • 只有在要显示额度时,才需要那条本地 HTTP 桥,以及 DSH 凭据库里对应的钥匙。
  • 建议在那台机器上跑一次 scripts/server-guard.sh:加 swap、限制日志,并每分钟自动处理一次(回收无主 worker、内存不足时结束最大的 worker、sshd 不应答时重启它)。理由和做法见 docs/ops/server.md。没装也能用,但那台机器内存见底时会连同 SSH 一起卡死。

安装

按仓库地址安装,把下面这一行加进 profile 的 dependencies,并把 dsh-antigravity-acp 加进 dsh.profile.bundles:

"dsh-antigravity-acp": "github:angusggsimid/dsh-antigravity-acp"

命令行等价于 dsh plugin --profile <profile> add github:angusggsimid/dsh-antigravity-acp。桌面版的 profile 名是 desktop,不是 web。装完后重新加载 DSH。Host 侧的改动只刷新页面不够。

本机改代码时,仍把依赖指到克隆下来的 antigravity-acp/ 目录:

{
  "dsh": {
    "profile": {
      "bundles": ["dsh-antigravity-acp"]
    }
  },
  "dependencies": {
    "dsh-antigravity-acp": "link:/absolute/path/to/dsh-antigravity-acp/antigravity-acp"
  }
}

然后在 profile 目录安装依赖,再重新加载 DSH。Host 侧的改动需要重新加载插件,只刷新页面不够。

配置

复制 antigravity-acp.local.example.json 为 ~/.dsh/antigravity-acp.local.json,填上你自己的 SSH 主机、私钥路径,以及可选的额度桥。同名环境变量会覆盖这个文件。

仓库里没有默认主机,也没有默认端口。字段说明见 docs/configuration.md。

开发

cd antigravity-acp
npm test

npm test 使用本地 mock,不连接远端,也不消耗额度。npm run test:real 会连你配置好的真实 agy acp。

文档

文档内容
docs/setup.md怎样复现整套路线,不含任何一台机器的秘密
docs/architecture.md现在的结构
docs/configuration.md本机配置和环境变量
docs/decisions.md已经定下来的取舍
docs/publishing.md公开仓库时守住的边界
docs/ops/server.md远端机器上要装的东西,以及本机额度隧道的看护
docs/history/migration-plan.md最初的改造计划,其中一部分已被后来的决定取代

许可证

MIT

Plugins relacionados