wenzetan/dsh-llm-newapi
40最近提交 2026年8月15日
dsh-llm-newapi DSH 插件
dsh-llm-newapi 将 NewAPI 网关集成到 DeepSeek Harness (DSH) 中作为 LLM 提供商路由。它在 DSH Web 面板中提供专用设置页面，用于配置 API 密钥、基础 URL 和获取可用模型。该插件会自动过滤非聊天模型（如 embedding、rerank），并支持通过 settings.yaml 热重载。
如何安装 dsh-llm-newapi DSH 插件
dsh plugin --profile web add dsh-llm-newapi复制不会执行命令。安装 dsh-llm-newapi DSH 插件前请核对仓库和版本。
dsh-llm-newapi DSH 插件数据来源
dsh-llm-newapi DSH 插件快照日期：2026年8月16日
discovered
dsh-llm-newapi DSH 插件能做什么
- 实现 NewAPI（兼容 OpenAI 的聊天完成和模型列表）的 LlmAdapter 接口。
- Web 设置页面：提供“获取模型信息”按钮，用于填充模型目录、API 密钥输入和 baseURL 配置。
- 自动过滤 embedding/rerank/ranker 模型，可通过 modelExcludePatterns 配置。
- 参数匹配引擎：内置供应商提示，支持 providerHints 配置以匹配官方模型条目。
- 支持稳定版和预发布版安装渠道（npm 和 GitHub），可手动锁定版本。
- 配置热重载：通过 cordis.yml 和 settings.yaml 配置，凭证存储在 DSH 凭证服务中。
dsh-llm-newapi DSH 插件适合哪些场景
- 将 DSH 连接到自托管的 NewAPI 网关以使用 LLM 完成功能。
- 使用兼容 OpenAI API 格式的第三方服务（如自定义代理、聚合服务）。
- 通过统一配置的单个网关测试和比较不同 LLM 模型。
- 在 DSH 中管理多个 LLM 提供商路由，用自定义提供商补充内置提供商。
dsh-llm-newapi DSH 插件适合谁
- 需要添加自定义 LLM 提供商（超出官方提供范围）的 DSH 用户。
- 管理 DSH 实例并需要集成私有或第三方兼容 OpenAI API 的开发者或管理员。
dsh-llm-newapi DSH 插件的限制
- 需要运行中的 NewAPI 兼容网关（OpenAI API 格式，带 /v1 前缀）。
- API 密钥只能通过 Web 设置页面配置；由于凭证服务设计，不支持环境变量。
- 插件仍处于早期开发阶段（v0.8.x），版本间可能存在破坏性变更。
- 模型发现和配置是手动的；上游模型变化时需要手动刷新模型列表。
dsh-llm-newapi DSH 插件的仓库 README 摘录
以下文字摘自 dsh-llm-newapi DSH 插件的上游仓库 wenzetan/dsh-llm-newapi 的 README，版权归原作者，仅作引用。
**English** | [中文](README.zh-CN.md) An LLM provider plugin that adds **NewAPI** to [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh). **Zero modifications to dsh itself.** - Provider route id: `newapi` - Display name: `NewAPI` - Shape: LLM Provider plugin — implements the `LlmAdapter` seam from `@deepseek-ai/dsh-llm`; NewAPI is an OpenAI-compatible gateway (`POST {baseURL}/chat/completions`, `GET {baseURL}/models`, baseURL includes `/v1`) - Dual-face structure: host side (adapter + model discovery) + browser side (a "NewAPI" settings page in the dsh web settings panel, including "Fetch model info") Design decisions and trade-off analysis live in [DESIGN.md](DESIGN.md); reference implementation: `deepseek-harness/packages/llm/llm-deepseek`. ## Installation (dsh ≥ 0.1.0-rc) ### Release channels and version selection The project uses a **dual release channel**. Install from the **npm registry** (default) or a **versioned tag**; never from the `main` branch HEAD: | Channel | Version shape | Install reference | When to use | |---|---|---|---| | **Stable (recommended)** | `vX.Y.Z` | `dsh plugin --profile web add dsh-llm-newapi` (npm `latest`) or `github:wen
阅读完整 README仓库许可: MIT
dsh-llm-newapi DSH 插件常见问题
dsh-llm-newapi 是什么？
dsh-llm-newapi 是 DeepSeek Harness (DSH) 的一个插件，用于添加对 NewAPI（兼容 OpenAI 的网关）的支持。它允许你在 DSH 中使用任何实现 OpenAI 聊天完成 API 的后端（如本地代理、聚合服务）作为提供商。插件包含一个 DSH Web 界面中的设置页面，用于配置和模型发现。
如何安装 dsh-llm-newapi？
使用 DSH CLI 命令：`dsh plugin --profile web add dsh-llm-newapi`。这会安装来自 npm 的最新稳定版。如需预发布版本，请附加 `@next`。安装后，你需要在 profile 的 package.json 中将 `"dsh-llm-newapi"` 添加到 `dsh.profile.bundles` 数组，然后重启 DSH web。有关其他方法，如 GitHub 简写或 tarball，请参阅 README。
如何配置 NewAPI 插件？
安装后，DSH Web 面板中会出现一个“NewAPI”设置页面。填写 API 密钥和网关基础 URL（包括 `/v1`，例如 `http://gw.local:3000/v1`）。点击“获取模型信息”拉取模型列表，然后选择要使用的聊天模型。你也可以通过 `cordis.yml` 或 `settings.yaml` 进行高级配置，如 `modelExcludePatterns` 和 `providerHints`。配置支持热重载，无需重启。
这个插件可以和任何兼容 OpenAI 的 API 一起使用吗？
可以，只要该 API 遵循 OpenAI 聊天完成格式（`POST /v1/chat/completions`）并提供 `GET /v1/models` 端点。该插件设计用于任何实现这些端点的网关。但请注意，API 密钥必须通过 Web 设置页面输入，而不是环境变量，这是 DSH 凭证服务的设计要求。
如何更新 dsh-llm-newapi 到最新版本？
运行 `dsh plugin --profile web update dsh-llm-newapi` 更新到最新稳定版。如果要切换到特定版本，请使用带版本标签的 `add` 命令，例如 `dsh plugin --profile web add dsh-llm-newapi@1.0.0`。更新后可能需要重启 DSH web。插件的发布渠道在 README 中有说明：稳定版（latest）和预发布版（next）。