前言¶
DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」。对于希望接入 SenseNova API 的开发者，通常需要手动处理路由注册、模型列表获取以及多账号的限流问题。alaxrpg/dsh-sensenova-provider 插件提供了一个官方 DSH 路由之外的解决方案，它注册了 sensenova 路由，集成了实时模型目录、OpenAI 兼容的流式接口，并实现了多账号 API Key 的自动轮转与 Web 界面管理。
核心功能¶
- 路由注册：在 DSH 中注册
sensenova提供者路由（显示名称：SenseNova）。 - 实时模型目录：通过
GET {apiBase}/v1/models获取 SenseNova 的可用模型列表。 - OpenAI 兼容流式输出：支持标准的
POST {apiBase}/v1/chat/completions(SSE) 请求。 - 多账号自动轮转：在单一共享 Base URL 下管理多个 API Key，自动处理限流：
429 Too Many Requests：进入冷却期（尊重Retry-After，默认 60s）。401 Unauthorized：禁用该 Key，直到凭证更新。- Key 耗尽：报错
RATE_LIMIT或INVALID_CREDENTIAL。 - Web 设置页面：提供模型页卡片与独立设置区域。
环境要求¶
- DSH host 版本：
>= 0.1.2-alpha.3(Alpha 线)。 - Node.js 版本：
>= 22。
安装与启用¶
使用官方 CLI 安装插件：
dsh plugin --profile <name> add dsh-sensenova-provider
也可以从本地路径安装：
dsh plugin --profile <name> add ./dsh-sensenova-provider
配置说明¶
安装后，插件会在设置中增加 llm-sensenova 区域。默认配置如下：
- API Base：https://token.sensenova.cn/v1。
- 默认凭证环境变量：SENSENOVA_API_KEY。
配置字段详情：
| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
apiBase |
string | https://token.sensenova.cn/v1 |
所有账号共享的基础 URL。 |
apiKeyEnv |
credential-ref | SENSENOVA_API_KEY |
默认账号凭证引用。 |
accounts[] |
array | [] |
额外账号列表，格式为 { id, label, apiKeyEnv }。 |
activeAccount |
string | "" |
指定首选账号 ID（空字符串表示自动选择第一个可用账号）。 |
API Key 通过 DSH 凭证服务存储，不会直接发送给模型。
使用方式¶
- 在 DSH 的 Models 页面选择 SenseNova 提供者。
- 填入配置的 Base URL 和 API Key。
- 插件将自动加载模型列表并支持流式对话。
注意事项¶
- 非官方插件：此插件由社区开发者维护，非 DeepSeek 官方出品。
- 运行时依赖：运行时导入接口是
@deepseek-ai/dsh-llm的稳定子集。 - ToolCallId：符号定义在本地
src/brand.ts中，不与核心库直接依赖。
总结¶
该插件通过将 SenseNova 的接入流程标准化，解决了多账号管理中的限流痛点，适合需要在 DSH 中稳定使用 SenseNova 服务的开发者。
