前言¶
DeepSeek Harness（DSH）的思路是「一切皆插件」。在 DSH 中接入 Google Antigravity（agy）时，常见工作包括 OAuth 登录、多账号管理、限流后的账号轮换、设备指纹和代理设置。dsh-agy 把这些能力封装为插件，提供 Web 和 CLI 两种管理方式。
下面按安装、用法和注意事项介绍。
这是什么¶
dsh-agy 是 chaos-03x 维护的 Google Antigravity（agy）DeepSeek Harness 插件，许可证为 MIT。它提供 OAuth 认证、多账号池、429 轮换、设备指纹，并支持 CLI 与 Web 管理。
核心功能¶
- OAuth 登录：支持浏览器回调、headless 粘贴 URL 和 credential blob 通道。
- Web 与 CLI：两种管理界面，核心功能一致。
- 多账号池：加密账号存储、用量感知选择、限流自动轮换、按账号冷却和按账号设备指纹。
- DSH Web 运行时：可在
/agy面板做登录、账号管理、按模型配额、模型测试、凭据导入导出和指纹管理。 - CLI：可在有或没有 harness 的独立环境运行。
- 代理：每个账号可单独配置代理。
- 环境变量：可禁用插件、切换指纹模式、设置后台健康检查间隔。
安装与启用¶
Web 方式¶
先安装插件到 DSH 的 web profile：
dsh plugin --profile web add dsh-agy
再启动 DSH Web：
dsh web
打开 /agy 面板：
http://127.0.0.1:3080/agy
点击 “Login with Google”，完成 OAuth 授权。
CLI 方式¶
如果不需要全局安装，可以直接运行：
npx dsh-agy login
npx dsh-agy status
也可以全局安装：
npm install -g dsh-agy
之后使用：
dsh-agy login
dsh-agy status
dsh-agy verify
dsh-agy health
dsh-agy import <file>
dsh-agy logout
典型用法¶
账号代理¶
每个账号可以单独配置代理：
dsh-agy proxy set --index 0 --proxy <url>
dsh-agy proxy clear --index 0
dsh-agy proxy test --index 0
per-account proxy 会忽略 NO_PROXY。代理不可达时会跳过账号并清除 affinity；loopback 地址强制直连。
限流与错误处理¶
429 响应会按类型处理：
soft_rate_limit：立即重试。rate_limited：冷却并切换账号。quota_exhausted：冷却至真实重置时间。unknown：指数退避。
401 / 403 会把账号标记为需重新认证。
风险控制¶
DSH_AGY_DISABLE=1 是 kill switch：插件不注册 provider 和 /agy 路由，且 CLI 拒绝运行。
卸载¶
如不再使用 Web 插件：
dsh plugin --profile web remove dsh-agy
如不再使用全局 CLI：
npm uninstall -g dsh-agy
适用场景与注意¶
适合需要在 DSH 中管理 agy 多账号、使用 Web 面板或 CLI 的开发者。
使用注意：
1、插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
2、Quota dashboard 仅在 DSH Web 运行时激活。
3、删除本地文件不会撤销 Google 端授权；refresh token 在过期或手动撤销前仍有效。
4、本地开发路径要求 Node >= 22，package.json engines 要求 node >=20.18.1；最低运行要求需按实际环境确认。
5、社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
获取项目¶
目录页：https://www.skillhub.cn/plugins/chaos-03x/dsh-agy
GitHub：https://github.com/chaos-03x/dsh-agy
