DeepSeek Harness 插件

weijiafu14/dsh-agy-native

Star 数 ★ 1 下载量(近 30 天) 296 分类 模型与账号接入 收录于 2026-11-20 npm dsh-agy-native

基于本机官方 agy acp --stdio 的 Google AI Pro/Ultra 订阅原生 LlmAdapter:回环 Streamable-HTTP 一级 MCP 工具桥(25ms 微批并行聚合)、带独立标题槽的粘性常驻会话池、ReplayEnvelope 上下文增量同步、原生图片输入及 dsh-agy-native doctor 环境诊断。

安装

# npm 包(预构建)

dsh plugin --profile web add dsh-agy-native

# Release 预构建包

dsh plugin --profile web add "https://github.com/weijiafu14/dsh-agy-native/releases/download/v0.1.0/dsh-agy-native-0.1.0.tgz"

# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)

dsh plugin --profile web add github:weijiafu14/dsh-agy-native

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。

README

English | 安全与合规边界说明

面向 DeepSeek Harness (dsh) 的零风控原生 Antigravity ACP 模型适配器 —— 通过本机官方签名的 agy CLI (agy acp --stdio) 安全接入 Google AI Pro / Ultra 订阅。

一张图看懂 DSH 与 AGY 协同原理


为什么需要 dsh-agy-native?

在 DeepSeek Harness 中接入 Google AI Pro / Ultra 会员额度时,以往两类方案各有痛点:

  1. 第三方 OAuth 直连代理风险极高:私自提取 OAuth Client ID 直连 cloudcode-pa.googleapis.com 会撞上 Google 网关的实时系统提示词指纹扫描与遥测信封校验(先返回无 Retry-After 的假 429 RESOURCE_EXHAUSTED,重试即升级为 403 TOS_VIOLATION「两振出局」封禁)。
  2. 简单命令行包装 (agy -p) 或粗糙套壳体验割裂:-p 单次调用会把工具执行吞在 agy 内部,导致 DSH 审批策略、子代理编排以及 dsh-context-os 上下文系统全部失效;而懒加载 MCP 桥接又会出现 call_mcp_tool 套娃、2 KB 输出被强行截断、10 分钟断连失忆、历史消息改写即冷重启等严重问题。

dsh-agy-native 从协议底层彻底解决了上述全部问题:

  • 死守保号红线(100% 官方二进制出网 + 零 systemInstruction 污染 + 首轮熔断保护):包内零第三方 OAuth 客户端凭据、零私自发包逻辑;所有模型流量 100% 由本机官方签名的 agy 二进制通过标准 ACP (agy acp --stdio) 发出,绝不开启 excludeDefaultComponents: true 且绝不向 systemInstruction 注入第三方 Agent 身份提示词(彻底避开 Cloud Code 边缘网关针对第三方系统提示词的假 429 拦截);内置上游 429/403 第 1 次即刻熔断器(立刻下发 session/cancel 阻断 agy 内置 8 次重试风暴并向 DSH 抛出不可重试错误),同时自动剥离环境变量中的 GEMINI_API_KEY / GOOGLE_API_KEY 防止误扣按量计费额度。
  • 一级原生工具直连 (eagerMcpServers):在 127.0.0.1:0 启动带 192-bit 随机令牌鉴权的 Streamable-HTTP MCP 反向桥,配合 enabledTools: [] + eagerMcpServers: ['dsh'] 关闭 agy 内置工具、将 DSH 工具作为一级原生工具直接挂载,彻底告别 call_mcp_tool 绕路与 2 KB 截断,并自动清洗 agy 注入的 toolSummary 字段以兼容严格 Schema。
  • 微批并发工具聚合:在同一微批窗口(默认 25ms)内自动合并多个并发 tools/call 请求,一次性生成多条 ToolCallBlock 交由 DSH 并行执行。
  • 常驻 Worker 池 + Context OS 无损协同:
    • 默认 60 分钟空闲回收(可设 0 永不回收),告别 10 分钟断连失忆;
    • 辅助请求(如自动生成会话标题 session-title-llm)自动隔离至独立 #auxSlot,绝不阻塞或驱逐正在进行的主对话;
    • 基于 DSH 原生 ReplayEnvelope 记录回合锚点:即使 dsh-context-os 通过 surfaceOp: 'replace' 动态改写了前置上下文块,也不会打断热会话,而是将变更的上下文面增量同步给模型。
  • 全模型家族、思考档位与多模态支持:自动发现订阅账号下的全部模型与思考等级(涵盖 Gemini 4 Neon 含 xhigh、Gemini 4 Carbon、Gemini 4 Argon、Gemini 4 Hydrogen 含 xhigh、Gemini 3.8 Flash、Claude Opus 5.5、Claude Sonnet 5.5、Orchestrator 等),原生支持 DSH 图片块 (ImageBlock) 直传、流式思考块 (reasoning) 展示与精确的 TokenUsage 拆分统计,且使用 32 MiB JSON-RPC 帧缓冲(无 256 KiB 模型目录溢出或 56 KiB 输入截断限制)。

dsh-agy-native 整体技术架构图


环境准备

  1. Node.js >= 22.13.0
  2. 已安装官方 Antigravity CLI (agy)(例如 ~/.local/bin/agy)并完成订阅登录:
    agy login
    
  3. 一键运行零 Token 消耗的环境与模型池诊断:
    npx dsh-agy-native doctor
    

安装与启用

方式一:通过 npm / DSH 插件命令安装

# 安装到 Web GUI Profile
dsh plugin --profile web add -w dsh-agy-native

# 或安装到 TUI / Headless CLI Profile
dsh plugin --profile tui add -w dsh-agy-native
dsh plugin --profile headless add -w dsh-agy-native

方式二:从本地源码构建安装

git clone https://github.com/weijiafu14/dsh-agy-native.git
cd dsh-agy-native
npm install
npm test
npm pack
dsh plugin --profile web add -w ./dsh-agy-native-0.1.0.tgz

安装后在 DSH 模型选择器中选择 Antigravity (Google AI Ultra / Pro),即可自由切换模型(如 Gemini 4 Carbon、Gemini 4 Hydrogen)及推理档位(Low / Medium / High / XHigh)。


插件配置项(支持 DSH Web 设置页热更新)

配置项 默认值 说明
providerId "agy-acp" 注册到 DSH ctx.llm 的 Provider 路由 ID。
providerName "Antigravity (AGY ACP)" 显示名称(探测到订阅等级后会自动显示为 Antigravity (Google AI Ultra) 等)。
agyPath "" 官方 agy 可执行文件路径;留空自动从 AGY_BIN、~/.local/bin/agy、PATH 及标准安装目录发现。
poolSize 2 最大并发常驻对话 Worker 数(1–8)。
idleMinutes 60 空闲 Worker 回收分钟数(设为 0 则常驻不回收)。
batchWindowMs 25 并发 MCP 工具调用的微批聚合窗口(毫秒)。
maxToolOutputBytes 180000 单次工具输出返回给 agy 的 UTF-8 安全字节上限(防多字节截断乱码)。
resumeSessions true Worker 重启后优先尝试 session/load 恢复会话,失败时自动回退至保留完整工具历史的结构化重放。
forwardContextUpdates true 当 dsh-context-os 等插件更新历史 developer 上下文面时,以增量方式同步而不重置热会话。

开源许可证

MIT

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。