前言¶
DeepSeek Harness（DSH）把模型与工具能力做成可插拔组件。实际开发里，很多人并不是直连某一家官方 API，而是通过 New API、one-api、LiteLLM、自建的 OpenAI 兼容反代等「网关」转发请求。每换一个网关就要改 base URL、换一套模型列表认知，多个网关并存时还容易在模型选择器里撞 id。
下面介绍的 dsh-ai-gateway-provider（维护者 zenVibeCoding，GitHub：zenVibeCoding/dsh-ai-gateway-provider）按协议探测网关能力，而不是维护一份固定厂商白名单：能响应 /v1/models 与 /v1/chat/completions 的网关都可以接入；已知后端类型还可展示额度信息。
这是什么¶
npm 包名与安装名均为 dsh-ai-gateway-provider。插件分类属于「模型推理」。简介原文为：Any OpenAI-compatible gateway for DeepSeek Harness: probe, save, manage models; known backends report quota.
一句话定位：把任意 OpenAI 兼容 AI 网关接到 DSH，在同一处完成探测、保存、模型管理与（部分后端的）额度查看；对话可走 OpenAI、Anthropic 或 Gemini 等 wire protocol（由网关与模型配置决定）。
核心功能¶
以下能力均来自项目 README 与 package.json 描述。
保存前先探测¶
只有在你填入的地址与 token 下，网关能列出模型时才会写入配置。URL 错误或 token 失效会在保存阶段被拒绝，而不是等到第一次发消息才失败。
多网关并存¶
每个已保存的网关注册为独立的 provider 路由，无需在全局「切换当前网关」。模型选择器按网关名称分组；两个网关提供相同 model id 时也不会互相覆盖。路由 id 持久化：第一个网关保留 legacy 路由 ai-gateway，后续为 ai-gateway-<slug>，以便 0.7.0 之前的对话仍能解析到当时使用的网关。
模型管理¶
可按网关拉取模型列表；对未出现在列表中的模型可手动添加；可编辑名称、上游映射、上下文窗口、输出上限、输入模态、推理档位、wire protocol，并隐藏不需要的模型。模型表可按厂商分组（可折叠，也可关闭分组），组内带「已测 / 可用」计数。
隐藏与搁置¶
可隐藏单个模型或整组厂商（选择器里灰显，再次点击可恢复）；隐藏不会把「自动网关」变成固定列表。网关卡片上的「眼睛」按钮可把该网关从对话模型选择器里藏起来，地址、token、模型设置与历史解析仍保留；隐藏期间不请求额度，测试连接、模型测试、编辑与能力页仍可用。
模型测试¶
支持单模型或批量测试：每个模型发一次极小请求、限制输出，错误会归类（无上游通道、无效 token、限流、超时等）。
额度¶
New API、LiteLLM、one-api 家族等已知后端会报告 quota；其它网关无额度接口时不展示，也不报错。
网关身份展示¶
通道可显示站点 favicon、声明名称（页面标题或后端自报名）、版本、支持的 chat 协议等；未知网关用中性图标。
支持的 backend 识别（仅影响图标与额度接口）¶
| Backend | 识别方式 | 额度 |
|---|---|---|
| New API / one-api / done-hub / one-hub / Veloera / VoAPI | GET /api/status |
GET /api/usage/token/ |
| LiteLLM | GET /key/info |
key budget（spend / max_budget） |
| CLIProxyAPI | GET / 横幅含 CLI Proxy API Server |
无 |
| 其它 OpenAI 兼容 | GET /v1/models |
无 |
单模型 wire protocol 包括 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages、Gemini；由网关 supported_endpoint_types 决定，模型编辑器可覆盖。
设置页性能¶
打开设置页不会立刻拉全量模型目录；切换 tab 或长时间停留也不会向每个网关 fan-out 模型列表。模型列表在打开某个网关时按需加载。
安装与启用¶
环境要求（来自 package.json）：
- DSH：
>=0.2.1-rc.1且<0.3.0-0 - Node：
>=22.19.0 - 许可证：MIT
README 正文以 0.7.0 为描述版本；npm 实际发布版本以 npm view dsh-ai-gateway-provider version 为准（编写 README 时该命令曾报告 0.6.0，以你安装时查询结果为准）。
在 DeepSeek Harness 中：Settings → Plugins，按包名安装：
dsh-ai-gateway-provider
插件在 DSH 进程权限下运行。安装前建议阅读 GitHub 仓库 源码与 LICENSE，确认符合你的安全与合规要求。
典型用法¶
添加或编辑网关¶
- 进入 Settings → AI Gateway → Add gateway。新建时焦点在地址栏。
- 地址为合法
http(s)URL 后，地址栏内会出现 Fetch info。该步骤只读公开端点（如/api/status、首页、favicon），不发送 token、不调用模型；用于预览网关类型、版本、站点标题、建议名称与图标。 - 建议名称仅在名称栏为空时填入；已手填的名称不会被覆盖。
- 填写 token，点 Test connection 查看模型数量，再 Save。保存时仍会用真实 token 探测；Fetch info 不能代替保存校验。
Token 存放在 DSH credential store，不会写入配置文件，也不会回传到页面。
在对话里选模型¶
不存在「当前激活网关」的全局概念；旧配置里的 activeChannel 会被忽略。列表里点击某行只是查看该网关详情与 Model capabilities 页，不影响其它网关是否在 chat 中可用。新对话在模型选择器里像其它 provider 一样选模型；之后每条对话各自记住所选模型。
隐藏网关¶
在网关卡片上使用眼睛按钮，可从对话模型选择器隐藏；再按一次恢复。删除配置需使用卡片上的删除操作。
适用场景与注意¶
适合谁： 已通过一个或多个 OpenAI 兼容网关聚合模型、需要在 DSH 里同时保留多网关路由、并做模型列表编辑、隐藏、批量连通性测试的用户；使用 New API / LiteLLM / one-api 等并希望在看板里顺带看额度的场景。
注意：
- 插件不识别「厂商品牌」才能工作；识别只影响图标与额度 API。任何满足 OpenAI 兼容探测的网关均可尝试接入。
- 社区目录页 skillhub.cn 上的条目 与 GitHub 为独立信息源；DSH 生态强调「一切皆插件」，该目录站点与 DeepSeek / 幻方无官方从属关系，本文不将其表述为官方应用商店。
- 截图与部分 UI 说明可能早于当前 npm 版本，以实际安装版本行为为准。
结尾¶
dsh-ai-gateway-provider 把「按协议探测 + 多网关路由 + per-gateway 模型管理」收进 DSH 插件，减少为每个反代单独写 provider 适配的成本。进一步了解可访问目录页 https://www.skillhub.cn/plugins/zenVibeCoding/dsh-ai-gateway-provider 与仓库 https://github.com/zenVibeCoding/dsh-ai-gateway-provider。
