前言¶
DeepSeek Harness (DSH) 采用微内核架构，插件化是其核心特性。在本地部署大模型时，管理多渠道订阅（如 Google Antigravity、OpenAI Codex）往往需要编写复杂的代理脚本。此插件提供了一个本地化的可视化控制台，基于拥有 52k+ Stars 的开源内核 CLIProxyAPI，将上述渠道反代为标准的 OpenAI 兼容接口，并深度集成至 DSH 生态。
它提供集环境部署、多渠道 OAuth 授权、多账号智能轮换池、5 小时与 7 天周额度大盘、自适应出海网络代理与上下文智能调优于一体的完整图形化控制中枢。
核心功能¶
插件主要解决多渠道订阅管理、额度监控与网络代理配置三个问题。
多渠道模型反代¶
网关支持将多个上游渠道统一转换为标准 OpenAI 协议接口，供 DSH 及其他兼容客户端调用。
* Google Antigravity 通道：支持 Gemini 3.8 Flash (262k/1M)、Claude Sonnet 4.6/Opus 4.6 等模型。
* OpenAI Codex 通道：支持 GPT-5.6 系列及 o1 系列推理模型。
* ZCode / 智谱 BigModel 通道：内置驱动，自动解密本地凭据文件。支持 GLM-5.3 等模型，支持流式 reasoning_content 与 tool_calls。注意：该通道依赖客户端指纹，无法在纯服务端复刻免费额度通道。
多账号轮换与故障转移¶
- 负载均衡：多个账号按 Round-Robin 轮流调度，扩充可用并发。
- 无缝接力：当某一账号触碰 5 小时限流或偶发 429 时，网关在毫秒级平滑切换至可用账号，前端任务不中断。
额度监控看板¶
提供精确的 5 小时滚动窗口与 7 天周额度监控。
* 高精指标：直连官方后端 API 计算。
* 倒计时预测：显示额度回满时间点。
* 状态胶囊：翠绿（>40%）、黄色（15%~40%）、红色（<15%）。
SWR 极速响应与代理优化¶
- SWR 机制：内存级缓存，打开面板 0~1ms 瞬时直出，后台 45s 异步预热。
- 智能代理：自动探测环境变量、注册表、本地端口（如 7890/7892），解决 TUN 虚拟网卡 Fake-IP 模式下的长对话握手超时问题。
安装与启用¶
插件通过 DSH CLI 进行安装。
- 安装插件
执行以下命令将插件添加至指定 profile：
dsh plugin --profile web add dsh-plugin-ai-gateway
或在插件工程根目录使用内置脚本：
node tools/install-into-profile.mjs --profile web
- 重启服务
安装后需要重启 DSH Web 进程以加载插件：
node tools/restart-web.mjs --yes
配置与使用¶
安装并重启后，需在浏览器中完成账号接入。
- 打开 DSH Web 界面。
- 导航至左侧 「设置 → AI 聚合网关」。
- 点击
➕ 登录 Google 账号或➕ 登录 Codex 账号，在弹出的链接中完成一次性 OAuth 授权。 - 授权成功后，点击下方 「一键接入」，插件会自动将网关配置及安全密钥写入 DSH。
安全设计¶
插件在设计上侧重于本地化与安全性。
- 本地绑定：默认严格绑定
127.0.0.1，拒绝局域网暴露。 - 密钥分离：API Key 与管理密钥完全独立生成，API Key 持久化存储于 DSH 专属凭据区，主配置仅保留引用。
- 同源防护：前端管理接口强制校验
Origin，拦截跨站请求（CSRF）。 - 自愈机制：内置 60 秒看门狗，意外断线自动拉起，DSH 退出时自动清理子进程。
依赖与注意事项¶
- 运行环境：依赖 Node.js >= 22.5。
- ZCode 限制：ZCode 通道依赖客户端指纹（如 User-Agent、X-Title 等），无法在纯服务端复刻其官方免费额度通道，日常使用请依赖计费通道。
- 插件权限：插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。
链接¶
- 插件目录：https://www.skillhub.cn/plugins/huguangyu666/dsh-plugin-ai-gateway
- GitHub 仓库：https://github.com/huguangyu666/dsh-plugin-ai-gateway
