前言¶
DeepSeek Harness (DSH) 生态强调插件化，旨在将具体能力封装为可插拔模块。在配置 LLM 网关时，开发者通常需要手动处理路由、模型发现和 API Key 管理。gateway-config 插件通过 Web 设置面板和 Host 工具，解决了将任何 OpenAI 兼容网关（即支持 GET /models 端点）直接作为提供者接入 DSH 的需求。
插件概览¶
- 名称：gateway-config
- 定位：DSH web profile 和 TapSVC 模型配置插件
- 所有者：iceprosurface
- 类别：模型推理
- License：MIT
- Stars：1
核心功能¶
该插件提供了以下能力：
- Host 工具：提供
gateway_configure命令行工具。 - Web 设置面板：提供 LLM 网关配置 界面，支持中英文本地化。
- 模型发现：通过
GET /models接口自动发现网关支持的模型，并进行非聊天模型的过滤。 - 能力映射：支持按模型配置推理努力级别（reasoning-effort）以及文本/图像输入能力。
- 凭据管理：每个路由仅管理一个凭据，存储格式为
<ROUTE>_API_KEY（例如CINDY_API_KEY），这些凭据存储在 DSH 本地管理的凭据中，不会写入本仓库。 - OpenAI Codex 支持：针对
openai-codex提供商，支持原生 ChatGPT OAuth 登录，并自动通过 pi-ai 刷新访问令牌。 - Provider 固定预设：提供固定的预设路由（如 Cindy, Sub2API, Generic 等），不支持动态创建路由。
安装与启用¶
这是一个插件包，需安装到现有的 DSH profile 中。
dsh plugin --profile web add https://github.com/iceprosurface/dsh-gateway-config.git
如果 DSH 版本要求使用 Git URL 格式，请使用：
dsh plugin --profile web add git+https://github.com/iceprosurface/dsh-gateway-config.git
安装后，如果插件条目未自动同步，需在 $DSH_HOME/profiles/web/cordis.patch.yml 中添加：
- insert:
- id: gateway-config
name: gateway-config
最后重启 DSH web 进程即可。
典型用法¶
1. Web 界面配置¶
- 打开 LLM 网关配置 面板。
- 从下拉列表中选择网关类型（例如 Cindy, Sub2API, Generic 或其他 OpenAI 兼容的公共厂商）。
- 填写 Base URL（网关的 OpenAI 兼容根路径，通常以
/v1结尾）。 - 点击 拉取模型，系统将列出支持的聊天模型。
- 勾选需要启用的模型，并标记一个默认模型。
- 点击 写入配置。此时 API Key 会自动填入 DSH 本地凭据中，无需在界面再次输入。
2. OpenAI Codex OAuth 登录¶
- 在网关选择器中选择
openai-codex。 - 点击 Sign in to ChatGPT。
- 浏览器将打开授权页面，完成回调后，DSH 会将授权存储为
llm-pi-ai/openai-codex。 - 之后即可像普通网关一样发现并导入模型。
3. 命令行使用¶
通过 Host 工具直接调用：
gateway_configure(apiKey?, baseURL?, route, displayName, defaultModel?)
参数说明：
* route：必填，路由名称（如 cindy）。
* baseURL：网关基础地址。
* apiKey：API 密钥。
* displayName：显示名称。
* defaultModel：默认模型名称。
注意：对于 openai-codex，在 OAuth 登录完成后，apiKey 和 baseURL 可省略。
注意事项¶
- 安全性：插件以当前 DSH 进程权限运行。请勿将 API Key、私有网关地址、凭据文件、个人 DSH 设置、会话数据或运行时数据库提交到本仓库。
- Provider 限制：插件仅提供固定预设的 Provider，不支持手动创建临时路由。
- 凭据存储：所有密钥均由 DSH 本地管理，不会写入本代码仓库。
结语¶
gateway-config 插件通过标准化的 OpenAI GET /models 接口和可视化的配置界面，降低了接入各类 LLM 网关的门槛。对于需要管理多个私有或公共网关的开发者，这是一个简洁且安全的配置方案。
