Jonah-Wu23/dsh-agy-safe

dsh-agy-safe

Antigravity CLI 模型提供商插件

DeepSeek Harness 的本地 Antigravity CLI 无头会话接入层

30 秒了解 ·
核心特性 ·
架构设计 ·
快速上手 ·
仓库结构 ·
许可协议

30 秒了解

dsh-agy-safe 将本机已登录的 Antigravity CLI（agy）无头会话接入 DeepSeek Harness，作为一级模型提供方。主对话与子代理均可调用该提供方，保持一致的流式生成与工具分发体验。

插件只复用你自己账号在本机登录的官方 Antigravity CLI 会话，凭据与用量均归属本人账号，合规地在 dsh 中使用自己的 Antigravity 额度，不涉及任何共享账号或第三方中转。

插件为本地 CLI 提供面向 Harness 平台的适配能力：

- 无头会话桥接：以子进程管道连接 agy 的流式交互，由 Harness 统一驱动智能体循环。
- 子代理支持：主对话与子代理均可选用 agy 模型，共享同一会话桥与工具分发链路。
- 工具调用适配：向模型注入工具契约，解析结构化标记并回传执行结果。
- 历史指纹管理：维护会话哈希链，检测上下文分叉并按需重放完整历史。
- TPS 计量准确：会话级用量差分剔除隐藏思考，流式速度按可见输出真实核算。
- 系统终端唤起：设置界面提供凭据引导，调用原生终端完成登录交互。

核心特性

| 维度 | 原生 HTTP 提供商 | dsh-agy-safe |
| --- | --- | --- |
| 认证机制 | 依赖远程 API Key | 复用本机 CLI 登录态 |
| 运行位置 | 远端模型服务 | 本地沙盒子进程 |
| 工具分发 | 平台原生支持 | 结构化标记解析与双向转换 |
| 会话维护 | 无状态 HTTP 往返 | 常驻长连接结合哈希分叉重建 |

主对话可直接调起 agy 子代理，右侧任务管理器实时展示子代理状态与所用模型：

主对话调起 agy 子代理

架构设计

插件采用模块化分层架构，适配 DeepSeek Harness 生态：

┌─────────────────────────────────────────────┐
│ DSH Agent Runtime / Subagents / Web UI      │  上层应用：模型选择与智能体调用回路
├─────────────────────────────────────────────┤
│ AgyAdapter (LlmAdapter 实现)                │  适配核心：统一模型流式分发与用量统计
├─────────────────────────────────────────────┤
│ ToolCallProtocol / TranscriptFlattener      │  协议解析：结构化工具标记与历史指纹链
├─────────────────────────────────────────────┤
│ AgySessionManager / ChildProcess Pool       │  进程管理：进程生命周期与异常重放
├─────────────────────────────────────────────┤
│ Antigravity CLI (agy 1.1.26)                │  底层模型：本地无头流式会话
└─────────────────────────────────────────────┘

运行流程

1. 会话解析：接收生成请求后，系统比对传入消息与常驻进程的历史哈希链。
2. 增量调度：历史前缀一致时仅发送增量输入；若发生上下文分叉，系统重置子进程并重放完整记录。
3. 输出转换：逐行解析输出事件，将文本增量与工具调用请求转换为标准数据块。
4. 状态反馈：任务完成时按会话级用量基线折算本轮输入输出与思考 token，向调用方提供终止状态。

快速上手

兼容性：插件适配 dsh v0.1.2-rc.1 的 Web 界面，运行环境需具备 Node.js 20 及更高版本。

一行命令安装

在 DeepSeek Harness 环境中执行安装命令：

dsh plugin --profile web add dsh-agy-safe

发布到 npm 的包里已含编译产物 lib/（npm publish 经 prepare 自动构建），单条命令即可安装，无需其他配置。

如需使用本地源码路径联调：

dsh plugin --profile web add
本地仓库与 github: 源不包含 lib/（构建产物不入库）：github: 安装依赖 pnpm 执行 prepare 构建，若 pnpm 提示忽略了 dsh-agy-safe 的构建脚本，需在 profile 的 pnpm-workspace.yaml 的 allowBuilds 中放行（dsh-agy-safe@0.1.0: true）后重新安装。

安装完成后重新启动服务：

dsh web

安装官方 Antigravity CLI（首次使用）

插件复用本机已登录的 Antigravity CLI（agy）会话，首次使用前请先从官方源下载安装 CLI（PowerShell）：

irm https://antigravity.google/cli/install.ps1 | iex

安装完成后在终端运行 agy --version 确认可用，再进入下面的登录配置。

登录与凭据配置

1. 打开 Web 控制面板，进入「设置」中的「Antigravity CLI」专页。
2. 点击「打开登录终端」按钮，系统会调起桌面终端运行登录命令。
3. 完成登录后，点击「验证登录凭据」确认会话状态。
4. 在模型列表中选择 agy 分组下的模型即可开始交互。

设置专页提供安装状态检测、凭据目录探测、登录终端唤起与凭据验证：

Antigravity CLI 设置专页

模型列表中的 Antigravity CLI 分组，收录 Gemini、Claude、GPT-OSS 等可用模型：

模型列表中的 Antigravity CLI 分组

仓库结构

| 目录与文件 | 说明 |
| --- | --- |
| src/adapter.ts | 继承 LlmAdapter，实现模型路由与流式转换。 |
| src/session.ts | 维护子进程池，处理分叉检测与生命周期。 |
| src/tool-protocol.ts | 增量状态机，处理工具调用标记的语法解析。 |
| src/flatten.ts | 历史消息压平与状态哈希计算。 |
| src/models.ts | 模型目录定义与思考等级映射。 |
| src/chunks.ts | 进程事件流到 Harness 数据块的格式映射。 |
| src/usage.ts | 会话级用量差分基线，折算本轮增量 token。 |
| src/login.ts | 原生终端唤起与凭据可用性探测。 |
| src/client.ts | 前端设置面板的交互组件。 |
| scripts/ | 真实 agy 联调工具：用量语义探针与增量上报验证。 |
| test/ | 面向协议状态机与纯函数的单元测试套件。 |

参与项目

欢迎提交 Issue 或 Pull Request。本地运行测试命令：

npm test

许可协议

本项目采用 MIT License 开源许可协议。版权所有 © 2026 Jonah Wu。