OpenCode 反重力 CLI Auth 插件

一个 打开代码 能够与 Antigravity CLI 进行无缝交互的认证插件(agy)通过勾入其认证,配额检索,以及动态模型取取取层.

特征

• OAuth 2.0 整合:使用Antigravity的OAuth流进行认证.
• 动态模式检索: 根据用户级别和当前分配获取可用的模型.
• 配额追踪: 输入 agy_quota 用于直接检查使用限制的工具.
• 交通模拟: 保持背景心跳 agy 服务器.
• 双开码兼容性: 原生支持OpenCode v1 (XQ 1.18.29)和OpenCode v2两出框而未突破更改.

安装

从 npm 安装插件( 或开发时直接使用本地文件配置) :

npm install @anthonyhaussman/opencode-agy-auth

配置

更新您的 OpenCode 配置文件( 通常情况下) opencode.json 在您的项目或全球 ~/.config/opencode/opencode.json)注册插件并指定您的 Google Cloud 项目ID .

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@anthonyhaussman/opencode-agy-auth"],
  "provider": {
    "google-agy": {
      "options": {
        "projectId": "your-google-cloud-project-id"
      }
    }
  }
}

默认情况下,插件会注册一个专门的提供者ID与 agy。 。 。 . 您可以切换您的活跃的 OpenCode 提供者 agy 或者让插件向您现有的会话注入认证.

环境变量

如果您在对反重力有特定要求的环境中运行 OpenCode, 您可以使用下列环境变量 :

• OPENCODE_AGY_PROJECT_ID: 手动指定您的 Google Cloud 项目 ID .
• OPENCODE_AGY_AUTH_PROXY: 如果访问公司防火墙后面的认证端点, 则定义代理 .
• OPENCODE_AGY_ENDPOINT: 覆盖默认的内部 daily-cloudcode-pa.googleapis.com API端点.
• OPENCODE_AGY_VERBOSE_LOGS: 设定为 "1" 以启用 API 调用和响应的动词诊断日志.

使用量

一旦安装和配置,OpenCode在与符合条件的模型互动时会自动对Antigravity CLI进行认证. 如果没有活动会话, 您将被提示完成 OAuth 登录 .

此外,您还可以在 OpenCode 提示中直接使用斜线命令检查您的配额 :

• /agyquota - 典型细节视图 显示每个模型变体的剩余符号、进度栏和重置定时器。 需要个人桶全部分解时使用.
• /agyquotasummary - 高级别分组观点。 按模范家庭汇总显示每周和5小时的限制。 在所有模型中快速地概述您的备抵时使用.

你也可以自然地问:

"我目前的配额是多少?" "给我看看我的配额摘要"

伴奏插件 : opencode-quota

此寄存器与 opencode-quota,用于在状态栏或界面中直接显示配额信息的 OpenCode 插件.

跟着 Google AGY 快速设置指南 让他们在一起.

要同时使用两个插件, 请在您的 opencode.json数字 :

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": [
    "@anthonyhaussman/opencode-agy-auth",
    "opencode-quota"
  ],
  "provider": {
    "google-agy": {
      "options": {
        "projectId": "your-google-cloud-project-id"
      }
    }
  }
}

当使用在一起, opencode-quota 无缝可视化的模型的费率限制和配额 google-agy。 。 。 .

磁盘持久性

插件坚持转动状态并重试-冷却数据到磁盘中,使其能活过OpenCode重启. 文件存储在 ~/.config/opencode/ (或 %APPDATA%\opencode\ 视窗上 :

• antigravity-turn-states.json 24小时TTL和5秒节的写作使用原子tmp+重名.
• 继续通过 CooldownStore 具有相同的原子-写作模式.

两种存储在运行时初始化懒散 - 导入时没有读取文件系统 .

diskEnabled 参数

TurnStateTracker 接受一个 diskEnabled 构造器参数(默认为 true:

import { TurnStateTracker } from "@anthonyhaussman/opencode-agy-auth/sdk/request/turn-state-tracker";

// Disk persistence enabled (default)
const tracker = new TurnStateTracker(true);

// Memory-only mode - no filesystem reads or writes
const tracker = new TurnStateTracker(false);

何时 diskEnabled 实值 false,跟踪器完全在记忆中运行。 所有状态在进程退出时丢失 。 这在磁盘访问不可用或不可取的受限制环境(容器,只读文件系统)中有用.

如果磁盘初始化在运行时失败(permission 错误,损坏文件等),插件会自动倒回只存储模式并日志出警告. 正常使用不需要配置 - 磁盘粘度在框外工作 .

本地测试

要在本地测试和开发插件, 在发布前使用 OpenCode :

1. 本地构建插件数字 : 清除寄存器、安装依赖性并构建源代码:

   npm install
   npm run build
   

2. 配置使用本地构建的 OpenCode数字 : 在要测试插件的目标工程中,打开您的 opencode.json (或 ~/.config/opencode/opencode.json ),并在插件中添加绝对本地路径:

   {
     "$schema": "https://opencode.ai/config.json",
     "plugin": ["/absolute/path/to/opencode-agy-auth"]
   }
   

   注意: OpenCode 也支持将插件文件直接丢入 .opencode/plugins/ 文件夹.

3. 校验插件数字 : 在目标项目中启动 OpenCode 。 OpenCode 将自动解析并加载本地插件目录 。 您可以通过运行测试您的更改 npm run build 在插件目录中并重新启动您的 OpenCode 会话.

OpenCode 运行时兼容性

插件在本地支持 OpenCode v1 (\\ 1.18.29) 和 打开代码 v2 通过双相兼容的架构从框出:

• 打开代码 v1:通过 server(options) 与自定义的 OAuth 流和提供者设置相接.
• 打开代码 v2: 已装入 Plugin.define 编号 : setup(ctx) 与本土目录转换,AI SDK钩,会话截取,和PKCE OAuth集成.

不需要特殊旗帜或配置 - 插件自动检测运行时间 .

释放前频道

为了在正式发布前测试出血尖端特征或即将发生的变化,配置 @alpha 分发标签 :

npm install @anthonyhaussman/opencode-agy-auth@alpha

或直接配置在您的 opencode.json数字 :

{
  "plugin": ["@anthonyhaussman/opencode-agy-auth@alpha"]
}

[尖叫声] 不稳定性警告编号: @alpha 释放包含实验特征和活性开发建设. 它可能在会话认证和模型请求中不稳定或造成中断. 只用于测试和开发。 为日常工作,使用稳定放行.

恒星历史支持( S)

如果此插件在 OpenCode 平滑器中保存了您的时间或使用 Antigravity 模型制作, 请考虑给寄存器一个恒星 GitHub 图像 - 它帮助别人发现项目.