dsh-gemini-subscription

v0.1.5

Published

a month ago

DSH provider plugin for Gemini & Antigravity access through a Google Gemini subscription.

0High
0Medium
0Low

leon_ming_008

DSH AGY Subscription (dsh-gemini-subscription)

English Documentation | 简体中文

让 DSH（DeepSeek Harness）通过 Google Antigravity / Gemini 订阅使用 Google 官方 Gemini 系列模型的插件。

插件注册 gemini-subscription Provider（显示名 “Antigravity（AGY 订阅）”），以当前 Host 用户的 Google OAuth 登录态访问模型，并在设置页展示账号信息、连接状态与实时订阅配额。支持 Windows、macOS 与 Linux。

功能特性

1. 登录与凭据存储

原生 Antigravity 授权链：使用 Google 官方公开客户端凭据，基于 Authorization Code + PKCE（S256）完成安全登录，默认使用 51121 回环端口，无需用户手动申请或填写 Client ID / Secret，开箱即用；
完备权限范围 (Scopes)：全量覆盖 cloud-platform、userinfo.email、userinfo.profile、cclog 以及 experimentsandconfigs；
安全跨平台凭据管理：
- Windows：使用 CurrentUser DPAPI 加密存储；
- macOS：使用系统登录钥匙串（Keychain）加密存储；
- Linux：使用当前用户私有的 0600 权限安全文件存储；
- 自动同步镜像至 ~/.dsh/gemini-subscription-token.json；
静默续期与重试：Token 过期前自动在后台刷新，遭遇 401 Unauthorized 时自动强制刷新令牌并静默重试一次。

2. 模型接入与协议对齐

原生 v1internal 协议：直接对接 Antigravity 原生 API 端点（v1internal:streamGenerateContent?alt=sse），完美对齐 Antigravity runtime 请求包装与 User-Agent 规范；
双端点高可用路由：全链路采用 Daily 优先 (daily-cloudcode-pa.googleapis.com) → Prod 兜底 (cloudcode-pa.googleapis.com) 的生产级故障转移策略；
深度思考与多模态：原生支持 Gemini 3.7 / 3.6 / 3.5 / 3.1 系列与 Claude 4.6 的 Thinking 深度思考过程（thought: true）、多模态图片输入与工具调用（Tool Calling）；
工具调用与环境自适应：原样转发 DSH 暴露的工具 Schema，命令工具自适应兼容 pwsh、powershell、bash 与 sh。

3. 实时配额与额度看板

真实订阅配额：通过 v1internal:retrieveUserQuotaSummary 实时获取各分组（Gemini Models、Claude and GPT Models）的真实可用额度与刷新重置时间；
拒绝虚假占位：若服务端未提供配额字段，如实展示提示，绝不编造虚假 0% 或 100% 占位；对话生成完成后自动触发缓存失效刷新。

4. 前端设置与交互

独立 AGY 设置页：展示 Google 账号（邮箱、昵称、头像）、套餐类型（Tier）、关联项目 ID（Project ID）、凭据存储状态与网络延迟测试；
多模型配额卡片：直观展示各分组与周期（Weekly / Five Hour）剩余/已用进度条与本地化刷新时间；
Composer 快捷用量徽标：在对话输入框右侧显示当前选中模型的实时剩余额度；
上下文窗口档位：支持 272K（默认）、512K 与 1M 三档可调上下文。

模型目录

插件对齐 AGY CLI 官方模型列表，内置以下基准模型：

提示：自动过滤 chat_20706、tab_flash_lite_preview 等内部补全调试模型。

环境要求

操作系统：Windows 10/11、macOS (12+) 或 Linux；
- Windows：需提供 PowerShell 以支持 CurrentUser DPAPI；
- Linux：Host 用户需具备 ~/.dsh 目录写权限（强制 0700 目录与 0600 权限凭据）；
运行环境：Node.js >= 18；
宿主程序：已安装并可运行 DeepSeek Harness (DSH)。

安装

方式 1：通过 DSH 插件系统添加（推荐）

# 全局安装了 dsh 时
dsh plugin --profile web add dsh-gemini-subscription

# 或使用 npx
npx @deepseek-ai/dsh plugin --profile web add dsh-gemini-subscription

方式 2：本地开发与源码链接（Link）

# 1. 克隆项目
git clone https://github.com/928886540/dsh-gemini-subscription.git
cd dsh-gemini-subscription

# 2. 安装依赖并构建
pnpm install
pnpm run build

# 3. 链接到 DSH Web Profile (Windows PowerShell)
npx @deepseek-ai/dsh plugin --profile web add "link:D:\apiWorkSpace\dsh-gemini-subscription"

# 3. 链接到 DSH Web Profile (Linux / macOS)
npx @deepseek-ai/dsh plugin --profile web add "link:/path/to/dsh-gemini-subscription"

使用指南

启动或重启 DSH（dsh web）；
点击左侧导航栏 设置 → AGY 订阅；
点击 “使用 Google 登录 (Sign in with Google)”，浏览器将自动弹出 Google 授权页面；
在浏览器中完成账号授权并关闭页面，回到 DSH 点击 “测试连接延迟” 确认服务畅通；
在对话输入框上方的模型下拉菜单中，选择 “Antigravity（AGY 订阅）” 及其下的 Gemini 模型即可畅快对话！

安全边界

凭据零泄露：OAuth 令牌（Access Token / Refresh Token）仅经过本机加密存储或受保护文件，严禁且绝不会进入浏览器前端、前端 LocalStorage、settings.yaml 或系统控制台日志；
回环监听保障：OAuth 本地回调服务仅监听 127.0.0.1:51121，设置 5 分钟安全超时，授权完成后立即关闭回环端口；
受控 API 通信：仅向 Google 官方 OAuth 端点（oauth2.googleapis.com）与 Antigravity API 端点（*.cloudcode-pa.googleapis.com）发起请求；
跨平台隔离：Windows DPAPI 限制仅限当前登录用户解密；Linux 凭据文件采用所有者独占的 0600 文件权限。

插件路由

插件所有后端接口均以 /api/gemini-subscription 为统一前缀：

开发与验证

# 类型检查
pnpm run typecheck

# 运行完整单元测试套件 (25 tests)
pnpm test

# 生产环境双端构建 (Host ESM + Client CJS)
pnpm run build

故障排查