Antigravity 直连 LingK9999/dsh-antigravity-direct

dsh-antigravity-direct

dsh-antigravity-direct 是本地直连代理核心插件，专为 DeepSeek Harness (DSH) 打造。

它在本地启动高性能回环代理服务（默认 127.0.0.1:8790），把标准 OpenAI /v1/chat/completions 与 /v1/models 协议无缝转换成 Google Antigravity（Cloud Code PA）的内部协议，让 DSH 能以原生级体验调用 Gemini 3.8 / 3.5 / 3.1、Claude 4.6 (Thinking) 与 GPT-OSS 等最新高配云端模型。

✨ 核心特性

- 🌈 主要面向小说文章写作：
- 支持在智能体对话框、文档中正常读写任何文本文字，不会被异常原因截断、报错。
- 通过多层注入提示词，经测试正常文章撰写基本无文字限制。
- 不建议用于复杂代码工程，已确认某些工具指令调用会触发中断。
- 🔄 OpenAI 协议双向无缝转接：
- 标准 OpenAI /v1/chat/completions（流式/非流式）⇄ Google Antigravity generateContent / streamGenerateContent。
- 完整适配流式思考过程（Reasoning/Thinking Stream）、多模态图文输入（Vision）与原生工具调用（Function Calling / Tools）。
- ⚡ 最新模型列表自动发现与一键同步 (v0.4.0 重磅)：
- 本地代理开放 OpenAI 标准 /v1/models 端点，实时拉取 Google Antigravity 官方最新可用模型清单。
- 精确解析模型上下文字符窗口（最高 1,000,000 Token）、单次生成上限与思考预算参数。
- 在 DSH 设置面板提供 「⚡ 一键同步至 DSH 选择器」，智能把最新模型写入 Web 与 Desktop 配置档配置，聊天界面即可直接下拉切换任意最新模型！
- 🛡️ 长上下文、代码编写与复杂工具调用的高可用断联防御 (v0.4.0 优化)：
- 工具语法白名单与严谨匹配：基于当前会话实际声明的工具动态校验，彻底杜绝编写代码时把普通代码块（如 package.json、Markdown、Python 代码字典等）误判为工具调用，导致正文截断断联。
- 流式心跳注入保活：上游长时间思考或网络间歇期，持续向下游客户端注入静默空增量（Empty Delta），防止客户端因读超时而意外断联。
- 历史工具超大写入参数自动瘦身：检测到历史多轮对话中存在超大代码文件写入等巨型参数时自动瘦身截断，大幅降低请求体积，避免触发上游政策网关负载限制与 502 错误。
- 底层网络代理连接池强化：HttpsProxyAgent 启用 keepAlive: true、长达 300 秒空闲保活与 64 并发连接复用，告别 TCP 死锁。
- 路径降级与政策误判防护：自动净化 Tool Result 中的绝对路径，避免上游政策审查层误判为外部文件载入攻击。
- 📊 双模型池额度可视化仪表盘：
- 在 DSH 设置面板「Antigravity 直连」中提供原生 UI。
- 独立监控 GEMINI 模型池 与 CLAUDE / GPT 模型池。
- 实时展示 5 小时会话限额与每周限额的双重进度条、剩余百分比、相对刷新时间及精准重置时刻。
- 🌐 网络代理运行时热切换：
- 面板内置「网络代理设置 (HTTP / HTTPS Proxy)」卡片。
- 支持免重启动态保存与切换代理地址（默认 http://127.0.0.1:7890，留空即走直连）。
- 内置即时端点连通性测试与延迟探测。
- 👥 多账号管理与无缝切换：
- 支持多 Google 账号 OAuth 凭据轮换与状态持久化。
- 支持在 Web 界面一键发起 OAuth 登录授权或移除失效账号。

📦 支持的部分模型矩阵

通过插件内置的模型发现机制，上游可用模型均可动态同步。常见模型如下：

| 模型 ID | 展示名称 | 上下文窗口 | 最大输出 Token | 核心特性 |
| gemini-3.8-flash-high | Gemini 3.8 Flash (High) | 1,048,576 | 65,536 | 极速响应、深度推理、100万超大上下文、多模态 |
| gemini-3.8-flash-medium | Gemini 3.8 Flash (Medium) | 1,048,576 | 65,536 | 平衡推理速度与输出深度 |
| gemini-3.8-flash-low | Gemini 3.8 Flash (Low) | 1,048,576 | 65,536 | 极速日常对话与代码生成 |
| claude-sonnet-4-6 | Claude Sonnet 4.6 (Thinking) | 250,000 | 64,000 | 顶级代码架构、复杂重构、自带思考过程 |
| claude-opus-4-6-thinking | Claude Opus 4.6 (Thinking) | 250,000 | 64,000 | 极致长程逻辑、文学创作与深度思考 |
| gpt-oss-120b-medium | GPT-OSS 120B (Medium) | 131,072 | 32,768 | 开源大模型标杆、通用问答与代码推理 |
| gemini-2.5-pro | Gemini 2.5 Pro | 1,048,576 | 65,535 | 经典高精度专业模型、多模态解析 |
| gemini-3-flash-agent | Gemini 3.5 Flash (High) | 1,048,576 | 65,536 | 专用于智能体工具链编排的模型 |

🚀 安装指引

⚠️ 关于 DSH 桌面端安装的重要提示：在 DSH 官方桌面客户端（Electron 架构）中，desktop profile 受官方内核独占保护。在终端里直接运行 dsh plugin --profile desktop add ... 会被内核闸门拦截并报错： error: profile "desktop" is managed exclusively by the Electron application 因此，请按你的使用环境选择下面对应的安装方式：

方式一：DSH Desktop 桌面端一键安装（推荐）

1. 克隆或下载本仓库代码到本地任意目录：
git clone https://github.com/LingK9999/dsh-antigravity-direct.git

2. 进入目录，直接运行内置的一键安装脚本：
cd dsh-antigravity-direct
powershell -ExecutionPolicy Bypass -File .\install.ps1

脚本会自动完成插件目录部署、依赖同步与 profile bundles 注册。完成后重启 DSH Desktop 即可生效。

方式二：DSH 客户端「插件市场 / 设置页」安装

如果你的客户端装了 dshmarket（插件市场），或支持在图形界面安装插件：
1. 打开 DSH 界面中的 「设置」→「插件」（或 DSH 插件市场）。
2. 在搜索或安装框中填入本仓库名： github:LingK9999/dsh-antigravity-direct

3. 点击安装并重启 DSH。

方式三：命令行 Web Profile 安装（适用于 dsh web 纯网页端用户）

如果你在终端通过 dsh web 启动，用的是非桌面端环境：

dsh plugin --profile web add github:LingK9999/dsh-antigravity-direct

⚙️ 模型配置与自动同步

方式一：面板一键同步（最简推荐）

插件启动后，进入 DSH 左侧 「设置」→「Antigravity 直连」：
1. 查看当前检测到的上游可用模型列表。
2. 点击 「⚡ 一键同步至 DSH 选择器」 按钮。
3. 插件会自动更新你的配置文件（支持 Desktop 与 Web Profile），无需手动编辑 YAML，聊天窗口即刻可直接切换使用！

方式二：手动配置 Provider

如果需要手动定义模型或定制参数，可以在 ~/.dsh/profiles/<profile>/cordis.patch.yml 中找到 llm-pi-ai 插件的 config.providers 节点，添加以下配置：

antigravity:
displayName: Antigravity直连 apiKeyEnv: GEMINI_API_KEY api: openai-completions baseURL: http://127.0.0.1:8790/v1 models:
- id: gemini-3.8-flash-high
name: Gemini 3.8 Flash (High)
contextWindow: 1048576
maxTokens: 65536
input: [text, image]
reasoningEfforts:
low: low
medium: medium
high: high
compat:
supportsDeveloperRole: false
supportsReasoningEffort: true
thinkingFormat: openai
thinkingTokenBudgetField: thinking_token_budget
- id: claude-sonnet-4-6
name: Claude Sonnet 4.6 (Thinking)
contextWindow: 250000
maxTokens: 64000
input: [text, image]
reasoningEfforts:
low: low
medium: medium
high: high
compat:
supportsDeveloperRole: false
supportsReasoningEffort: true
thinkingFormat: openai
thinkingTokenBudgetField: thinking_token_budget

(完整范例见仓库内的 provider-config-snippet.yml)

🔑 账号凭据导入与登录

插件默认自动扫描以下目录下的 OAuth 凭据文件（含有 refresh_token 的 JSON）：
- 默认目录：~/.dsh/credentials/antigravity/*.json
- 自定义环境变量：可通过 AG_CREDS_DIR 指定凭据文件夹，或通过 AG_CREDS 指定单凭据文件。

同时，你也可以在 DSH 设置页内点击 「添加账号（Google 登录）」，走浏览器 OAuth 流程直接完成凭据绑定。

🛠️ 高级环境变量

| 变量名 | 说明 | 默认值 |
| AG_PORT | 本地回环代理端口 | 8790 |
| AG_PROXY | 向上游发起请求时使用的 HTTP/SOCKS 代理 | http://127.0.0.1:7890 |
| AG_CREDS_DIR | 自定义凭据目录 | ~/.dsh/credentials/antigravity |
| AG_BASE | 上游 Antigravity 端点 | https://daily-cloudcode-pa.googleapis.com |

📂 目录结构

dsh-antigravity-direct/
├── client.js # 浏览器端 UI 面板（模型列表与一键同步、双模型池额度仪表盘、网络代理配置、账号管理） ├── cordis.patch.yml # Cordis 服务注入清单 ├── index.js # 插件入口（生命周期管理、本地 RPC 通道挂载） ├── install.ps1 # 桌面端一键安装脚本（自动处理 Electron desktop profile 写入） ├── package.json # 插件清单与元数据定义 (v0.4.0) ├── provider-config-snippet.yml# Provider 快捷配置模板（含思考能力参数） ├── sanitize-rules.json # 政策审查防御与改写规则 ├── LICENSE # MIT 开源授权协议 ├── README.md # 说明文档 └── lib/ ├── proxy-core.js # 直连代理核心（协议转接、/v1/models 发现、长文本/工具流断联防御、Token 刷新） └── vendor/ # 纯净内置依赖包

📄 License

本项目采用 MIT License 开源授权。