DeepSeek Harness 插件介绍：godd6366/dsh-sub2api

前言¶

DeepSeek Harness (DSH) 通过插件系统扩展功能。sub2api 是一个将订阅额度转化为 OpenAI 兼容端口的网关，每个 API Key 绑定一个组，组决定平台（OpenAI/Claude/Grok）和可用模型。

本文介绍的 godd6366/dsh-sub2api 插件将 sub2api 网关接入 DSH，使其作为模型提供商。它将 OpenAI、Claude 和 Grok 的路由统一在单一基础 URL 后，并提供模型发现、用量查询和设置页面。

核心功能¶

多路由支持：支持 sub2api-openai、sub2api-claude、sub2api-grok 三个提供者路由，共享单一基础 URL。
流式对话：支持 SSE 流式输出、工具调用、推理增量和 Token 用量统计。
模型发现：通过 GET {baseURL}/v1/models 一键获取模型列表，与网关分组完全匹配。
推理强度调整：支持调整 reasoning effort（如 none/low/medium/high/xhigh/max），配置项从 models.dev 获取。
用量查询：通过 GET {baseURL}/v1/usage 查看配额、余额和订阅窗口。
图片生成：支持选择生成模型，保存至工作区并返回内联附件。
标准化配置：配置存储在 llm-sub2api: 区段，密钥通过凭证服务或环境变量管理。
提供商图标：内置 LobeHub 的 SVG 图标。

安装¶

此插件依赖 DeepSeek Harness 0.1.2-rc.1 或更高版本。安装命令如下：

dsh plugin --profile web add @godd6366/dsh-sub2api

安装后，路由由 dsh-llm-pi-ai 服务，插件负责将设置转换为 llm-pi-ai: 配置文件。注意：dsh-client-runtime 不再是必需依赖。

配置与使用¶

基础配置¶

在 DeepSeek Harness 中进入 Settings → Sub2API 模型，或直接编辑 $DSH_HOME/settings.yaml：

llm-sub2api:
  baseURL: http://localhost:8080
  providers:
    openai:
      apiKeyEnv: SUB2API_OPENAI_API_KEY
      models:
        - id: gpt-5.6-sol
    claude:
      apiKeyEnv: SUB2API_CLAUDE_API_KEY
    grok:
      apiKeyEnv: SUB2API_GROK_API_KEY

密钥管理¶

将 API Key 存储在凭证服务（Web 界面 Models 页面写入）或环境变量中（例如 SUB2API_OPENAI_API_KEY）。
路由激活条件：当平台配置了 Key 且至少有一个模型时，路由激活；清除 Key 或空模型列表将注销路由。

高级设置：端点覆盖¶

若网关未原生支持某协议，可在配置中强制指定 api 字段（无设置页控制）：

llm-sub2api:
  providers:
    openai:
      apiKeyEnv: SUB2API_OPENAI_API_KEY
      api: openai-responses  # 可选: openai-completions / openai-responses / anthropic-messages
      models:
        - id: gpt-5.6-sol

常用操作¶

获取模型：点击设置页面的“获取模型”按钮，自动执行 GET {baseURL}/v1/models。
查看用量：点击“查看用量”按钮，执行 GET {baseURL}/v1/usage。
图片生成：使用 generate_image 工具，保存图片到工作区。

注意事项¶

版本要求：必须使用 DSH 0.1.2-rc.1 或更高版本。
后端依赖：路由由 dsh-llm-pi-ai 服务，插件仅在启动时进行防御性检查（确保 assistant.usage 存在）。
输入模态：若模型未声明 image 输入模态，DSH 将拒绝发送图片。

总结¶

godd6366/dsh-sub2api 是连接 sub2api 网关与 DeepSeek Harness 的桥梁。它通过标准化配置，将多提供商的路由统一管理，适合需要在 DSH 中整合多个订阅源的开发者。

源码：https://github.com/GodD6366/dsh-sub2api
目录：https://www.skillhub.cn/plugins/GodD6366/dsh-sub2api