前言¶
DeepSeek Harness（DSH）把对话、工具调用和模型路由统一在一个客户端里。若你已经在本地使用 Google Antigravity 的 agy CLI，常见做法是单独开终端跑 agy，再把输出手动贴回 DSH，会话上下文和 token 统计也难以对齐。
dsh-agy-link 由社区维护者 amlyczz 开发，通过调用本机未修改的 agy 进程，把 Antigravity 模型注册为 DSH 的一个模型提供方。你在 /model 里选模型即可对话，流式输出、思考过程、工具活动与用量统计会映射到 DSH 原生界面。
这是什么¶
dsh-agy-link 是 DSH 社区插件，npm 包名为 dsh-agy-link，当前版本 0.4.20，MIT 许可证。它在 SkillHub 目录中归类为「模型推理」。
插件不直接请求远程 API，而是为每一轮对话启动独立的 agy -p --output-format stream-json 子进程，解析 NDJSON 事件流后写入 DSH 协议。DSH 会话与 agy 原生会话通过 --conversation 绑定，由 agy 管理完整历史，每轮只发送增量。
核心功能¶
多账号池化与轮换¶
支持在 DSH 内添加多个 Google 账号。除主账号沿用系统默认凭证外，备用账号在插件私有目录下建立独立 HOME 沙箱，凭证相互隔离。
当当前账号触发 429 限流、5 小时滚动额度或 7 天周额度耗尽时，调度器会按顺序切换到池中下一个可用账号。Gemini 与 Claude / GPT-OSS 等模型族的速率限制独立计算，某一族进入冷却不影响其他族继续调用。
官方双 Bucket 配额监控¶
插件后台轮询 Antigravity 官方接口 v1internal:retrieveUserQuotaSummary，在控制台展示 5 小时滚动额度与 7 天周额度的进度条和重置倒计时，可按模型展开明细。
GUI 内 OAuth 登录¶
点击「添加账号」会调起系统浏览器完成 Google 授权，本地回环监听自动捕获凭证，无需手动复制粘贴授权码。也可在输入框执行 /agy auth 为主账号发起登录。
流式输出与工具映射¶
文本、thinking 折叠段和工具活动均映射到 DSH 流协议。agy 执行的终端命令（run_command）和文件修改（inline diff）以 DSH 原生卡片渲染。输入、输出、思考与缓存读取 token 计入 DSH 用量统计。
其他能力¶
- 在 DSH 模型配置中注册
antigravity提供方，通过/model切换 Gemini、Claude、GPT-OSS 等模型。 - 每个账号可单独配置 HTTP(S) / SOCKS 代理，隔离 IP 出口。
- 支持多模态图片传入，自动落盘并通过
--add-dir授权给 agy。 - 提供
agy_ask辅助工具，允许其他 DSH 模型把单次任务委托给 Antigravity。 - 顶部栏
AGY (n)徽标可打开管理控制台，查看账号池、配额与代理状态。 /agy快捷命令族：status、auth、models、mode、effort、workspace、clear、doctor、help。
前置要求¶
安装前确认以下环境：
| 前置项 | 说明 |
|---|---|
| 系统网络代理 | Google Antigravity 与 OAuth 需访问 oauth2.googleapis.com、cloudcode-pa.googleapis.com 等域名。国内网络通常需开启 TUN 模式或设置代理环境变量。 |
| DeepSeek Harness | 用 dsh --version 验证已安装。 |
| Node.js ≥ 24 | 用 node --version 验证。 |
Google Antigravity agy CLI |
按 Google 官方安装文档 安装，agy --version 能输出版本号即可。尚未登录也可先装插件，再在 GUI 内完成授权。 |
安装与启用¶
下面介绍安装步骤。插件以 npm 包发布，面向 DSH Web 配置档（--profile web）。
- 若终端未被系统代理自动接管，先设置代理环境变量（端口按本地代理软件实际值替换）：
export HTTPS_PROXY=http://127.0.0.1:7890 HTTP_PROXY=http://127.0.0.1:7890 ALL_PROXY=socks5://127.0.0.1:7890
- 安装插件：
dsh plugin --profile web add dsh-agy-link
升级到最新版：
dsh plugin --profile web add dsh-agy-link@latest --registry https://registry.npmjs.org
- 启动 DSH Web GUI，在输入框检查状态：
/agy status
典型用法¶
添加账号并选择模型¶
经过上面的安装步骤后，可用两种方式登录：
- 方式 A：点击顶部导航栏
AGY (n)徽标，再点「添加账号」，在浏览器完成 Google 授权。 - 方式 B：在输入框执行
/agy auth为主账号发起登录。
随后在 /model 选择器里挑选 Antigravity 模型，即可开始对话。
常用配置项¶
插件配置可在 /plugin、设置面板或环境变量中调整：
| 键名 | 环境变量 | 默认值 | 作用 |
|---|---|---|---|
enabled |
DSH_AGY_ENABLED |
true |
插件主开关 |
agyBin |
DSH_AGY_BIN |
自动探测 | 显式指定 agy 二进制路径 |
permissionMode |
DSH_AGY_MODE |
skip |
权限模式：skip / plan / accept-edits |
defaultModel |
DSH_AGY_DEFAULT_MODEL |
agy 默认 | 默认模型 slug |
defaultEffort |
DSH_AGY_DEFAULT_EFFORT |
模型默认 | 思考预算：low / medium / high |
timeoutMs |
DSH_AGY_TIMEOUT_MS |
600000 |
单轮活跃看门狗超时（毫秒） |
workspaceRoot |
DSH_AGY_WORKSPACE_ROOT |
会话 cwd | agy 工作区根目录 |
进入「设置 → Antigravity」，或在账号卡片上点「代理」，可为单个账号配置专属代理 URL，例如 http://127.0.0.1:7890。
适用场景与注意¶
适合已在本地安装 agy CLI、希望在 DSH 统一界面里使用 Antigravity 订阅额度的开发者。若你持有多个 Google 账号并需要自动轮换与配额可视化，多账号池化是主要价值点。
使用前请注意：
- 插件以当前
dsh进程的权限运行，会启动子进程、读写凭证与工作区文件。安装前应查看 GitHub 源码 与 MIT 许可证，确认可接受其行为范围。 - 使用需遵循 Google Antigravity 服务条款；插件仅桥接本机官方
agy，不修改其二进制。 - SkillHub 是 DSH 社区独立目录站点，与 DeepSeek / 幻方无官方从属关系。
链接¶
- SkillHub 目录页：https://www.skillhub.cn/plugins/amlyczz/dsh-agy-link
- GitHub 仓库：https://github.com/amlyczz/dsh-agy-link
- npm 包：https://www.npmjs.com/package/dsh-agy-link
dsh-agy-link 把 Antigravity 的 CLI 能力接入 DSH 模型路由，省去终端与 GUI 之间来回切换。若你已在用 agy 且希望对话、工具卡片和 token 统计留在同一客户端，可按上文步骤安装试用。
