本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-agy

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-agy

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• OAuth login: one-click sign-in via browser OAuth callback, with headless
• Two management surfaces: web and CLI, either one works, core features are
• Multi-account pool: encrypted account store, usage-aware account
• Quota dashboard: only active when DSH Web is running; append /agy to
• CLI: dsh-agy login|status|import|verify|logout works standalone, with or

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后怎么开始用？

在 DSH Web profile 中安装插件后启动 dsh web，浏览器访问 http://127.0.0.1:3080/agy，点击 Login with Google 完成 OAuth 授权即可；CLI 路径则执行 npx dsh-agy login（默认浏览器模式，--headless 可走粘贴 URL 模式）。

装好插件但 /agy 页面没出来？

插件只把 /agy 路由注册到本机环回地址（127.0.0.1/localhost/::1），非环回绑定会被主动拒绝注册；如果走的是远程 DSH Web，本机是看不到这个页面的，需要换成本机 dsh web。

多个 Google 账号怎么切换？

账号信息以 AES-256-GCM 加密形式存到 ~/.dsh/agy-accounts.json，主密钥在 ~/.dsh/.credentials.yaml 的 AGY_MASTER_KEY 里；最多支持 10 个账号，CLI 的 dsh-agy status / dsh-agy verify 可批量查看与轮换。

遇到 429 限流会怎样？

插件按四个子类处理：软限流（Retry-After<3s）立即重试同账号；按分钟限流进入最多 30 分钟冷却；quota exhausted 进入最多 24 小时冷却；其他未识别的指数退避；冷却到达后会自动切到下一个可用账号。

为什么 Antigravity 用不了图片理解？

部分模型（gpt-oss-120b-medium、gemini-2.5-flash）在 catalog 中标记为文本-only，模型清单会把它们的输入模态限制为 text；其他模型默认支持图片，遇到上游拒绝时会上游返回 400 而不是静默丢弃。

想换自己的 OAuth 应用怎么办？

设置环境变量 AGY_CLIENT_ID（必要时再设置 AGY_CLIENT_SECRET），插件会在请求时优先读取环境变量；未设置时使用嵌入在 Antigravity 桌面客户端里的公开凭证。

想彻底关掉这个插件？

设置 DSH_AGY_DISABLE=1，插件会跳过所有注册（provider + /agy 路由），CLI 也会拒绝执行；之后用 dsh plugin --profile web remove dsh-agy 即可卸载。

插件默认就是灰产行为吗？

默认会做设备指纹（每次请求随机 UA/SDK Client/ideType + 每个账号持久 deviceId/sessionToken），并启用多账号轮换；如果只想固定身份跑，可设置 DSH_AGY_FINGERPRINT_MODE=stable。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明
• Node: >=20.18.1
• Platforms: 跨平台

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则