# agy-next 中文文档

规范地址：https://npmcn.com/package/agy-next/

版本：1\.1\.0
npm 元数据更新时间：2026-11-03T00:03:44.560Z
中文译文更新时间：2026-11-03T04:52:21.802Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/agy-next
原文对照：https://npmcn.com/package/agy-next/?lang=original
项目主页：https://github.com/kizaki-R/Antigravity-Next-for-DSH#readme
源码仓库：https://github.com/kizaki-R/Antigravity-Next-for-DSH

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

- 包体积（解压后）：1.5 MB，65 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：0 个
- peer 依赖：@deepseek-ai/dsh-llm 0\.1\.5-rc\.1 \|\| ^0\.2\.0-rc\.1 \|\| ^0\.2\.1-rc\.1，@deepseek-ai/dsh-timeout 0\.1\.5-rc\.1 \|\| ^0\.2\.0-rc\.1 \|\| ^0\.2\.1-rc\.1，@deepseek-ai/schemastery \>=3\.18\.0，@deepseek-ai/dsh-home-paths 0\.1\.5-rc\.1 \|\| ^0\.2\.0-rc\.1 \|\| ^0\.2\.1-rc\.1，@deepseek-ai/dsh-host-webserver 0\.1\.5-rc\.1 \|\| ^0\.2\.0-rc\.1 \|\| ^0\.2\.1-rc\.1
- 首次发布：2026-11-01T20:50:05.716Z
- 最新版本发布：2026-11-03T00:03:44.387Z
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

DeepSeek Harness的反重力提供商-需要官方本地安装的反重力应用程序

## 安装

```sh
npm install agy-next
```

也可以使用：`pnpm add agy-next`、`yarn add agy-next`、`bun add agy-next`

## README

# Antigravity Next for DSH

![Antigravity Next for DSH 橫幅](https://npmcn.com/package/agy-next/assets/banner-zh-TW.png)

[![CI](https://github.com/kizaki-R/Antigravity-Next-for-DSH/actions/workflows/ci.yml/badge.svg)](https://github.com/kizaki-R/Antigravity-Next-for-DSH/actions/workflows/ci.yml) [![Version](https://img.shields.io/badge/version-1.0.1-blue.svg)](https://npmcn.com/package/agy-next/package.json) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://npmcn.com/package/agy-next/LICENSE) [![DeepSeek Harness](https://img.shields.io/badge/DSH-0.1.5%20~%200.2.x-orange.svg)](https://deepseek.com/harness/)

[English](https://npmcn.com/package/agy-next/README.md) | [繁體中文](https://npmcn.com/package/agy-next/README.zh-TW.md) | [简体中文](https://npmcn.com/package/agy-next/README.zh-CN.md)

非官方的 [DeepSeek Harness](https://deepseek.com/harness/)（DSH）模型供應商外掛。將本機安裝的官方 Google Antigravity / Cloud Code Assist 整合至 DSH 的 Agent 核心架構中，註冊提供者識別碼為 `agy-next`。

> **免責聲明：** 本專案為非官方本地整合，與 Google 或 DeepSeek 均無任何隸屬、認可或官方支援關係。使用者須具備合法 Google 帳號授權，並於本機安裝官方 Antigravity 應用程式。

* * *

## 功能特點

-   **免手動配置 GCP**：直接從本機安裝的官方 Antigravity 解析 OAuth client，不需要在 Google Cloud Console 建立專案或金鑰。
-   **多帳號輪替池**：可加入多組 Google 帳號並設定安全閾值；當前帳號額度用盡時，自動切換至備用帳號接續對話。
-   **即時額度監控面板**：在設定頁顯示 Gemini、Claude 與 Gemini 4 Argon 的每週及 5 小時額度條與重設倒數。
-   **思考強度檔位調節**：支援推理思考強度（Low、Medium、High，適用於 Gemini 4 Argon、Gemini 3.8 Flash 與 Claude 系列）。
-   **本機安全儲存**：客戶端探索僅讀取檔案，不會執行官方 App。Token 僅存於本機 `<DSH_HOME>/storages/agy-next-oauth.json`，不上傳任何金鑰。

* * *

## 系統需求

1.  **DeepSeek Harness**：版本 `0.1.5` ～ `0.2.x`（完整相容至最新 `0.2.1` 系列），Node.js `>=20`。
2.  **官方 Antigravity 桌面程式**：已安裝於 Windows 或 macOS（Linux 支援進行中）。可至[官方網站](https://antigravity.google/product/antigravity-2)下載（_使用外掛時該程式不需保持啟動_）。
3.  **Google 帳號**：可正常完成瀏覽器 OAuth 授權，並擁有 Gemini / Cloud Code Assist 存取權限。

* * *

## 安裝指南

### 方式一：DSH 介面安裝（推薦）

1.  開啟 DSH 側邊欄的 **「插件」→「+ 添加插件」**。
2.  在輸入框貼上 GitHub 倉庫網址：
    
    ```text
    https://github.com/kizaki-R/Antigravity-Next-for-DSH
    ```
    
    _（待 npm 發布後，亦可直接輸入 `agy-next`）。_
3.  點選 **「安裝」**，完成後重新啟動 DSH。

### 方式二：本機開發模式（CLI / Link）

從本地原始碼進行開發測試：

```bash
# 於 DSH profile 註冊本機連結
dsh plugin --profile <profile> add link:/absolute/path/to/agy-next
```

確認該 profile 的 `dsh.profile.bundles` 已包含 `agy-next`，隨後重新啟動 DSH。

* * *

## 快速上手

### 1\. 登入帳號

在 DSH 中開啟 **「設定」→「AGY-Next」**：

1.  **檢查狀態**：確認頁面偵測到本機 Antigravity 安裝路徑。
2.  **新增帳號**：點選 **「登入 / 新增帳號」**，瀏覽器會開啟 Google 官方授權頁面。
3.  授權後帳號即進入帳號池，並顯示各模型額度狀態。

_CLI 備用指令：_

```bash
npm run login              # 登入新帳號
npm run login -- --status  # 檢視目前作用帳號與額度
npm run login -- --force   # 強制重新授權
npm run login -- --logout  # 清除已存憑證
```

### 2\. 自訂安裝路徑

若 Antigravity 安裝在非標準路徑，在啟動 DSH 前設定環境變數即可：

```powershell
# PowerShell
$env:AGY_NEXT_INSTALL_PATH = 'C:\Custom\Path\To\Antigravity'
```

* * *

## 進階設定

若需調整連線參數，可在 profile 的 `cordis.yml` 中覆寫：

```yaml
- id: agy-next
  name: agy-next
  config:
    credentialPath: ""               # 預設為 <DSH_HOME>/storages/agy-next-oauth.json
    streamIdleTimeoutMs: 300000      # 串流閒置超時保護（毫秒，預設 5 分鐘）
    discoveryTimeoutMs: 8000         # 本機 client 探索超時（毫秒）
    projectCacheTtlMs: 1800000       # 專案 metadata 快取存活時間（毫秒，30 分鐘）
    runtimeModel: ""                 # 選填：固定指定後端模型 ID
```

* * *

## 支援模型矩陣

| 模型家族 | 代表型號 | 上下文長度 | 特性支援 |
| --- | --- | --- | --- |
| **Gemini 4 Argon** | `gemini-4-argon` | 1M tokens | Low / Medium / High 思考檔位、5 小時與每週額度獨立監控 |
| **Gemini 3 / 2.5** | `gemini-3.8-flash`、`gemini-3-flash`、`gemini-2.5-pro`、`gemini-2.5-flash` | 1M tokens | 高速多模態串流輸出、工具調用 |
| **Claude 系列** | `claude-sonnet-5-5`、`claude-opus-5-5`、`claude-opus-4-6`、`claude-sonnet-4-6` | 1M tokens | 整合 Cloud Code Assist 之 Claude 執行環境 |
| **開源大模型** | `gpt-oss-120b` | 128k tokens | 大參數開源權重推理 |

* * *

## 開發與測試

於 `agy-next/` 目錄下執行離線測試：

```bash
npm run check        # 檢查全數 40 支模組語法
npm test             # 執行離線回歸測試（21 項 fixture 隔離驗證）
npm run test:peers   # 嚴格主機 peers 契約測試（需設定 AGY_PEER_ROOT）
```

執行 peers 契約測試時，指定主機依賴路徑：

```powershell
$env:AGY_PEER_ROOT = 'C:\path\to\dsh\node_modules'
npm run test:peers
```

* * *

## 安全設計

-   **不內嵌密鑰**：代碼庫不包含任何 Google Client ID 或 Client Secret，全部由本機應用程式資源即時解析。
-   **儲存隔離**：憑證儲存在 DSH 專屬的 `agy-next-oauth.json`，不讀取或更動官方 Antigravity 的內部資料庫。
-   **墓碑機制（Tombstone）**：登出所有帳號時寫入標記為 `loggedOut: true` 的空清冊，防止舊版設定自動回補舊帳號。

* * *

## 授權條款

本專案採用 [MIT](https://npmcn.com/package/agy-next/LICENSE) 條款開源 © [Kizaki](https://github.com/kizaki-R)

## 常见问题

### agy-next 是什么？

DeepSeek Harness的反重力提供商-需要官方本地安装的反重力应用程序

### 如何安装 agy-next？

在项目目录运行 npm install agy-next，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/dsh-llm（0\.1\.5-rc\.1 \|\| ^0\.2\.0-rc\.1 \|\| ^0\.2\.1-rc\.1）、@deepseek-ai/dsh-timeout（0\.1\.5-rc\.1 \|\| ^0\.2\.0-rc\.1 \|\| ^0\.2\.1-rc\.1）、@deepseek-ai/schemastery（\>=3\.18\.0）、@deepseek-ai/dsh-home-paths（0\.1\.5-rc\.1 \|\| ^0\.2\.0-rc\.1 \|\| ^0\.2\.1-rc\.1）、@deepseek-ai/dsh-host-webserver（0\.1\.5-rc\.1 \|\| ^0\.2\.0-rc\.1 \|\| ^0\.2\.1-rc\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 agy-next-login，可以用 npx agy-next-login 直接运行。

### agy-next 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/agy-next 是否存在。

### agy-next 支持 ESM 还是 CommonJS？

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

### agy-next 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### agy-next 可以商用吗？

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

### agy-next 还在维护吗？

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