# @anthonyhaussman/opencode-agy-auth 中文文档

规范地址：https://npmcn.com/package/%40anthonyhaussman/opencode-agy-auth/

版本：1\.5\.1
npm 元数据更新时间：2026-11-05T12:15:57.894Z
中文译文更新时间：2026-11-06T06:36:06.532Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40anthonyhaussman/opencode-agy-auth
原文对照：https://npmcn.com/package/%40anthonyhaussman/opencode-agy-auth/?lang=original
项目主页：https://github.com/anthonyhaussman/opencode-agy-auth#readme
源码仓库：https://github.com/anthonyhaussman/opencode-agy-auth

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.4 MB，59 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- 首次发布：2026-06-11T05:30:38.393Z
- 最新版本发布：2026-11-05T12:15:57.495Z
- 近 30 天下载量：6618（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：209（近 12 个月 209 个）

## 中文简介

[![npm version](https://img.shields.io/npm/v/@anthonyhaussman/opencode-agy-auth)](https://www.npmjs.com/package/@anthonyhaussman/opencode-agy-auth) \[![npm downloads](https://img.shields.io/npm/dw/@anthonyhaussman/opencode-agy-auth)\[(\][https://www.npmjs.com/ (中文(简体) )](https://www.npmjs.com/)

## 安装

```sh
npm install @anthonyhaussman/opencode-agy-auth
```

也可以使用：`pnpm add @anthonyhaussman/opencode-agy-auth`、`yarn add @anthonyhaussman/opencode-agy-auth`、`bun add @anthonyhaussman/opencode-agy-auth`

## README

# OpenCode 反重力 CLI Auth 插件

[![npm version](https://img.shields.io/npm/v/@anthonyhaussman/opencode-agy-auth)](https://www.npmjs.com/package/@anthonyhaussman/opencode-agy-auth) [![npm downloads](https://img.shields.io/npm/dw/@anthonyhaussman/opencode-agy-auth)](https://www.npmjs.com/package/@anthonyhaussman/opencode-agy-auth) [![CI](https://github.com/anthonyhaussman/opencode-agy-auth/actions/workflows/ci.yml/badge.svg)](https://github.com/anthonyhaussman/opencode-agy-auth/actions/workflows/ci.yml) [![License](https://img.shields.io/github/license/anthonyhaussman/opencode-agy-auth)](https://github.com/anthonyhaussman/opencode-agy-auth/blob/main/LICENSE) [![GitHub stars](https://img.shields.io/github/stars/anthonyhaussman/opencode-agy-auth?style=social)](https://github.com/anthonyhaussman/opencode-agy-auth)

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

## 特征

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

## 安装

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

```bash
npm install @anthonyhaussman/opencode-agy-auth
```

## 配置

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

```json
{
  "$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`](https://github.com/slkiser/opencode-quota),用于在状态栏或界面中直接显示配额信息的 OpenCode 插件.

跟着 [Google AGY 快速设置指南](https://github.com/slkiser/opencode-quota/blob/main/docs/readme/providers.md#google-agy-quick-setup) 让他们在一起.

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

```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`:

```ts
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.  **本地构建插件**数字 : 清除寄存器、安装依赖性并构建源代码:
    
    ```bash
    npm install
    npm run build
    ```
    
2.  **配置使用本地构建的 OpenCode**数字 : 在要测试插件的目标工程中,打开您的 `opencode.json` (或 `~/.config/opencode/opencode.json` ),并在插件中添加绝对本地路径:
    
    ```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](https://opencode.ai/v2/docs) 通过双相兼容的架构从框出:

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

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

## 释放前频道

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

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

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

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

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

## 恒星历史支持( S)

如果此插件在 OpenCode 平滑器中保存了您的时间或使用 Antigravity 模型制作, 请考虑给寄存器一个恒星 [GitHub 图像](https://github.com/anthonyhaussman/opencode-agy-auth) - 它帮助别人发现项目.

## 常见问题

### @anthonyhaussman/opencode-agy-auth 是什么？

\[\[\(\]https://www\.npmjs\.com/ \(中文\(简体\) \)

### 如何安装 @anthonyhaussman/opencode-agy-auth？

在项目目录运行 npm install @anthonyhaussman/opencode-agy-auth，或使用 pnpm add / yarn add / bun add。

### @anthonyhaussman/opencode-agy-auth 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @anthonyhaussman/opencode-agy-auth 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @anthonyhaussman/opencode-agy-auth 可以商用吗？

@anthonyhaussman/opencode-agy-auth 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @anthonyhaussman/opencode-agy-auth 的下载量有多少？

根据 npm 官方下载统计，@anthonyhaussman/opencode-agy-auth 在 2026/10/06 – 2026/11/04 这 30 天内被下载 6,618 次，日均约 221 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @anthonyhaussman/opencode-agy-auth 还在维护吗？

最新版本 1\.5\.1 发布于 2026/11/05（今天）；至今共发布 209 个版本，其中过去 12 个月发布了 209 个；首次发布于 2026/06/11。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。