LLM 网关配置iceprosurface/dsh-gateway-config

gateway-config

一个 DSH 插件，用于将任何兼容 OpenAI 的 LLM 网关（任何提供 GET /models 的端点）配置为 provider —— 每个网关一条 provider 路由，多个网关可并存。

它提供什么

- 宿主工具：gateway_configure
- Web 设置面板：LLM 网关配置
- 通过 GET /models 发现网关模型，并过滤非聊天模型
- 按模型配置推理强度映射
- 按模型配置文本/图像输入能力映射
- 每条路由一个托管凭据（_API_KEY，例如 CINDY_API_KEY）
- 为 openai-codex provider 提供原生 ChatGPT OAuth，包括通过 pi-ai 自动刷新访问令牌
- 根据 DSH 界面语言环境提供英文和简体中文本地化设置 UI

Provider 是固定预设；不会创建临时路由。任何符合 OpenAI GET /models 形态（DSH 发现机制读取的事实标准）的服务都可以使用：

- cindy（Cindy）、sub2api（Sub2API）—— 私有网关；地址从不存放在此仓库中。宿主工具从 CINDY_BASE_URL / SUB2API_BASE_URL 读取它们；Web 面板会记住每条路由的最后地址。
- generic（通用）—— 任何其他兼容 OpenAI 的端点；提供其基础 URL（GATEWAY_BASE_URL 环境变量或面板的 Base URL 字段）。
- 具有兼容 OpenAI API 的公共厂商开箱即用，自带其文档中的基础 URL：deepseek、moonshot（Kimi）、zhipu（GLM）、qwen、openrouter、siliconflow、xai（Grok）。
- openai-codex（OpenAI Codex / ChatGPT）使用原生 pi-ai provider 和 OAuth 传输。它不需要也不接受自定义 Base URL 或 API key。

安装到现有 DSH profile

此仓库是一个插件包。它不会替换或包含完整的 DSH home。

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 进程。

配置网关

打开 LLM Gateway / LLM 网关配置。从 provider 下拉菜单中选择一个网关（Cindy、Sub2API、Generic 或某个公共厂商），如果未预填，请填写 Base URL（网关的兼容 OpenAI 根地址，例如以 /v1 结尾），然后点击 拉取模型：支持聊天的模型会以复选框形式列出；勾选要保留的模型，并将其中一个单选按钮标记为默认模型，然后点击 写入配置。密钥存储在 DSH 本地托管凭据中，绝不会写入此仓库。之后，将密钥留空；插件会复用 _API_KEY。

对于 OpenAI Codex，请选择 openai-codex 并点击 Sign in to ChatGPT。该
授权页面会在单独的浏览器窗口中打开。回调完成后，DSH 会将授权存储为 llm-pi-ai/openai-codex；令牌永远不会返回到设置 UI，pi-ai 会在需要时刷新它们。然后像往常一样发现并导入模型。

主机端等价写法：

gateway_configure(apiKey?, baseURL?, route, displayName, defaultModel?)

在设置页面中完成 OAuth 登录后，对于 route: "openai-codex"，apiKey 和 baseURL 会被省略。

开发

- lib/index.js：主机端工具
- lib/client.js：Web 端设置面板

node --check lib/index.js
node --check lib/oauth-remote.js
node --check lib/client.js

安全

切勿提交 API 密钥、你认为私密的网关地址、凭据文件、个人 DSH 设置、会话、附件、生成的依赖项或运行时数据库。

许可证

MIT