前言¶
DeepSeek Harness(DSH)支持通过插件扩展模型推理能力。dsh-tool-antigravity 是一个面向 Antigravity 模型路由和图像生成的插件。它解决了在 DSH 环境中处理 Google OAuth 2.0 认证、长文本流式传输性能以及图像生成与编辑的痛点,提供了一套集成化的解决方案。
这是什么¶
dsh-tool-antigravity 是一个高性能、精简的 Antigravity 能力包插件,旨在为 DeepSeek Harness 提供:
* 私有化的 Google OAuth 2.0 PKCE 认证与多模型 LLM 路由支持。
* 基于 Nano Banana 2 的图像生成与迭代编辑能力。
* 优化的网络传输与内存管理机制。
该插件由 Jaylor-Wang 维护,遵循 MIT 许可证,是一个社区驱动的个人研究能力包。
核心功能¶
插件提供了以下核心能力:
-
高性能网络与连接管理
- TLS 连接池与会话恢复:内置 HTTP/1.1 Keep-Alive 和 TLS 会话恢复,减少握手开销,降低首字节延迟(TTFT)。
- 滑动窗口缓冲 SSE 解析器:直接在二进制块上定位分隔符,减少字符串拼接和 V8 堆内存分配,缓解长时间推理时的 GC 压力。
- 细粒度思考预算:支持在 Gemini 和 Claude 模型上配置 Low/Medium/High 三档推理强度,或使用 Dynamic/Fixed Effort。
-
图像生成与编辑
- Nano Banana 2 引擎:提供
generate_image(图像生成与编辑)和list_images(会话内图片检索)工具。 - 多代理图像卸载:支持严格的传输负载预算(总传输限制 12MB,单图限制 4MP/1MB),并可通过
IMAGE_OFFLOAD_REQUIRED_CODE透明协商客户端卸载。
- Nano Banana 2 引擎:提供
-
认证与可视化管理
- Google OAuth 2.0 PKCE:支持标准化的 PKCE 流程进行身份验证。
- Web 交互面板:提供配额可视化、实时登录状态查看及图像生成参数配置界面。
安装与启用¶
推荐使用 DSH 插件 CLI 进行安装。
# 添加插件到当前 Web 配置文件
dsh plugin --profile web add dsh-tool-antigravity
安装完成后,需在 DSH 的配置文件中注册插件条目,以便正确加载 antigravity-auth 和 antigravity-image 服务。
典型用法¶
插件提供了终端命令和 Web 界面两种操作方式。
1. 认证管理
在 DSH 的终端或聊天提示符中输入以下命令:
/antigravity-auth login # 启动 Google OAuth 2.0 PKCE 登录
/antigravity-auth status # 查看当前认证状态、掩码邮箱和项目 ID
/antigravity-auth logout # 丢弃凭证并撤销令牌
/antigravity-auth cancel # 取消正在进行的登录尝试
2. 图像生成
在支持工具调用的场景中,调用 generate_image 和 list_images 接口。
3. Web 客户端配置
在 DSH Web 客户端中,可通过「Antigravity Auth Settings」卡片查看登录状态,通过「Quota Visualizer」监控配额(支持 5 小时和周重置窗口),并在「Image Generation Card」中设置默认图像模型和批次大小。
适用场景与注意¶
适用场景:
* 需要使用 Antigravity 系列模型(如 Gemini 3.x 系列、Claude 4.6 Thinking)进行复杂推理的开发者。
* 需要在 DSH 生态中集成图像生成能力(Nano Banana 2)进行多模态交互的研究者。
注意事项:
1. 非官方性质:这是一个社区驱动的插件,仅供个人研究和教育目的,使用时请务必遵守相关平台的服务条款。
2. 权限与安全:
* 插件在主机进程权限下运行,凭证存储在主机端安全存储中,绝不会被转发到前端 UI、日志或命令事件中。
* 严格回环保护:RPC 端点默认拒绝访问,除非 Web 服务显式绑定到 127.0.0.1。
* 路径防护:文件引用经过目录遍历检查,防止媒体路径逃逸。
3. 合规性:安装前建议检查源码与许可证,确保符合本地安全合规要求。
结尾¶
dsh-tool-antigravity 为 DeepSeek Harness 增强了 Antigravity 模型路由与 Nano Banana 2 图像生成能力。通过优化的连接池、细粒度的推理预算控制以及安全的认证机制,它降低了集成复杂度并提升了性能表现。
- GitHub 仓库: https://github.com/Jaylor-Wang/dsh-tool-antigravity
- 社区目录: https://www.skillhub.cn/plugins/Jaylor-Wang/dsh-tool-antigravity