dsh-antigravity-oauth

Readme

# DeepSeek Harness Antigravity OAuth

将 Google Antigravity 账号中的 Gemini 模型接入
[DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harness/)，作为原生 LLM provider 使用。

- Provider ID：`antigravity`
- 运行方式：DSH Web profile 插件
- 认证方式：Google OAuth，本机保存 refresh token

> [!WARNING]
> 本插件调用 Antigravity 的非公开内部 API，不是 Google 官方 Gemini API 集成。使用它可能违反
> Google 服务条款，也可能导致账号受限或封禁。请自行评估风险，不要使用重要账号。Google 或
> Antigravity 的协议变更可能随时使插件失效。

## 免责声明

本项目及其作者与 Google、DeepSeek 或 Antigravity 官方没有隶属、授权或赞助关系。

本插件仅供学习和技术研究使用。用户须自行确认其所在地区的法律法规、Google 服务条款以及相关账号政策，并自行承担使用本插件产生的全部风险，包括但不限于账号限制、服务中断、数据丢失或其他损失。

本项目调用的接口属于非公开接口，作者不保证其长期可用性、稳定性或兼容性，也不承诺为因接口变化、账号策略变化或第三方服务故障导致的问题提供修复。

请勿将 OAuth callback URL、authorization code、access token、refresh token 或其他敏感信息提交到 issue、日志、截图或公开仓库。

## 功能

- Gemini 文本生成、thinking 和 tool calls/results
- 流式响应、usage、abort、自动刷新 token 和失败重试
- Web UI 设置页直接唤起 Google 登录，并自动接收 OAuth callback
- Models 设置页删除/恢复 provider
- Antigravity 设置页退出登录并删除本机 OAuth 凭据

当前不支持图像/PDF 输入和多账号轮换；图像模型不会注册到模型选择器。

## 模型

当前注册的模型 ID：

```text
antigravity-gemini-3.7-flash
antigravity-gemini-3.6-flash
antigravity-gemini-3.5-flash
antigravity-gemini-3.1-pro
```

`*-pro` 支持 `low` 和 `high` reasoning effort；其他模型支持 `low`、`medium` 和 `high`。

## 兼容性

- Node.js 20 或更高版本
- `@deepseek-ai/dsh@0.1.0-rc.6` 开发/验证版本
- OAuth 和 transport 由 [cortexkit/antigravity-auth](https://github.com/cortexkit/antigravity-auth)
  提供

## 安装

### 使用预构建包

打开 [GitHub Releases](https://github.com/Eridani075/deepseek-harness-antigravity-oauth/releases/latest)，
在 Assets 中下载 `dsh-antigravity-oauth-*.tgz`，然后安装下载的文件：

```bash
dsh plugin --profile web add "/absolute/path/to/dsh-antigravity-oauth-VERSION.tgz"
dsh --profile web --dump-config
```

### 从源码构建

在项目目录执行：

```bash
npm ci
npm run check
npm run pack
```

产物位于 `artifacts/`。安装生成的 tarball：

```bash
dsh plugin --profile web add "/absolute/path/to/artifacts/dsh-antigravity-oauth-VERSION.tgz"
dsh --profile web --dump-config
```

`--dump-config` 输出中应出现 `dsh-antigravity-oauth` bundle 和
`llm-antigravity-oauth` 条目。安装或升级插件后，重启已经运行的 DSH Web 服务再刷新浏览器；
不要在已有服务占用 `127.0.0.1:3080` 时重复启动第二个 `dsh web`。

安装时 `pnpm` 可能提示缺少 DSH peer dependencies，以及 `hono`、`arctic`。DSH peer 由宿主提供，
`hono` 和 `arctic` 不在本插件使用的 OAuth/transport 路径中；只要 bundle 能正常加载，就不需要
为了消除提示而重复安装这些依赖到 profile。

## 登录

### Web UI

打开 DSH Web UI 的 Settings → Antigravity，点击「登录 Google」并完成授权。插件会在 DSH Host
侧监听本机 OAuth callback 并自动保存凭据，正常情况下不需要手动复制 code。浏览器阻止新标签页时，
页面会提供一次性的「打开授权页面」按钮。

### CLI

```bash
dsh plugin --profile web exec dsh-antigravity-login
```

CLI 会监听 `127.0.0.1:51121` 并打印 Google OAuth URL。授权完成后 callback 会自动交给 CLI；如果
自动 callback 失败，可以粘贴完整 callback URL 或 authorization code。

凭据默认保存到：

```text
${DSH_HOME:-~/.dsh}/antigravity-oauth.json
```

可以通过 `DSH_ANTIGRAVITY_AUTH_FILE` 指定其他路径。POSIX 系统上的凭据文件权限会设置为 `0600`。

## Provider 和凭据管理

登录后，在模型选择器中选择 `antigravity` provider 和上面的模型 ID。

### 删除或恢复 provider

Settings → Models 中的 Google Antigravity provider 使用 DSH 原生 Delete 操作：

- Delete 会移除 provider 配置并停用 adapter，但保留 OAuth 凭据文件。
- Settings → Antigravity 中的「启用提供商」可以恢复 provider，无需重新登录。

### 退出登录

Settings → Antigravity →「退出登录」会删除本机 OAuth 凭据文件，但不会撤销 Google 账号侧的应用
授权。重新使用模型前需要再次登录。

## 故障排查

### 模型没有出现在模型选择器

确认插件安装到当前使用的 profile，并检查：

```bash
dsh --profile web --dump-config
```

确认输出包含 `dsh-antigravity-oauth` 和 `llm-antigravity-oauth` 后，重启 DSH Web 服务并重新打开
Settings → Models。

### `EADDRINUSE: 127.0.0.1:3080`

已有 DSH Web 服务正在运行。刷新已有页面即可；需要加载新插件版本时，重启旧服务后再打开，
不要并行启动第二个 `dsh web`。

### `EADDRINUSE: 127.0.0.1:51121`

退出旧的 `dsh-antigravity-login`，确认 OAuth callback 端口释放后再重试。

### `User location is not supported for the API use`

这是 Google 对请求出口地区的限制。请使用 Google 支持地区的代理出口。Antigravity core 会读取
`HTTPS_PROXY`、`ALL_PROXY` 和 `NO_PROXY`，例如：

```bash
HTTPS_PROXY=http://127.0.0.1:7890 \
NO_PROXY=127.0.0.1,localhost \
dsh web
```

### OAuth 或模型请求出现 `fetch failed`

检查 DSH Host 能否访问 Google OAuth 和 Antigravity endpoint，再检查代理、证书和网络出口。
不要把 OAuth callback URL、authorization code、access token 或 refresh token 提交到 issue。

## 开发

```bash
npm ci
npm run check
```

主要模块：

- `src/adapter.ts`：DSH LLM 消息与 Antigravity Gemini 请求/SSE 的转换。
- `src/auth.ts`：凭据文件读写、权限设置和 access token 刷新。
- `src/web-auth.ts`、`src/client.tsx`：Web UI OAuth 服务和设置页。
- `src/login.ts`、`src/oauth-callback.ts`：CLI 登录和本机 callback server。

## 发布本地构建包

更新 `package.json` 版本后执行：

```bash
npm run check
npm run pack
```

tarball 会写入 `artifacts/`；该目录中的 `*.tgz` 已被 `.gitignore` 忽略。发布到 GitHub 时，建议
将 tarball 作为 GitHub Release 附件，而不是提交到源码仓库。

## License

MIT