raccoonBK / dsh-byok

dsh-byok

让 DeepSeek Harness (DSH) 支持任意 OpenAI 兼容模型供应商，自带 key，一键切换，并且支持 HTTP/SOCKS5 代理。

DeepSeek 涨价了？切到更便宜的供应商。国内访问不了？走代理。

为什么需要这个

DSH 官方内置了 DeepSeek 模型，但 DeepSeek API 涨价之后，用户需要一个出口：

• 切到更便宜的模型（阿里云百炼、Gemini、本地 Ollama 等）
• 接入公司内部中转站 / API 网关（OpenRouter、PackyCode、ZetaAPI 等）
• 用自己的 key（BYOK），不暴露给 DSH 官方

DSH 官方其实已经内置了一个 llm-pi-ai 插件做多供应商 BYOK。dsh-byok 跟它的区别，在于补上官方没做的两块：

1. 代理：官方两个 adapter 都没有 per-provider 的代理配置，Node 原生 fetch 只认 HTTP(S)_PROXY 环境变量，SOCKS5 完全不支持。dsh-byok 支持 http/https/socks5 代理，且按供应商单独配置。
2. 极简透传：不依赖 pi-ai 那套会拖一堆 SDK 的重型依赖，只做 OpenAI Chat Completions 的 direct-fetch + SSE 透传，代码短到可以通读、可以信任。

快速开始

npm install dsh-byok

在 DSH 的插件配置里加：

plugins:
  byok:
    proxy:
      http: http://127.0.0.1:7890
      https: http://127.0.0.1:7890
      # socks5: socks5://127.0.0.1:7890
    providers:
      openrouter:
        baseURL: https://openrouter.ai/api/v1
        apiKey: ${OPENROUTER_API_KEY}
      gemini:
        baseURL: https://generativelanguage.googleapis.com/v1beta/openai
        apiKey: ${GEMINI_API_KEY}

完事。DSH 的模型选择器里直接选。

配置说明

每个供应商支持：

字段	说明
baseURL	端点 base URL，/chat/completions 自动拼接
apiKey	直填 key，或用 ${ENV_VAR} 引用环境变量
models	手动声明模型列表（字符串数组），可选
proxy	该供应商专属代理，覆盖全局

代理支持三种协议，socks5 优先级最高：

proxy:
  http: http://127.0.0.1:7890     # HTTP 目标走这个
  https: http://127.0.0.1:7890    # HTTPS 目标走这个
  socks5: socks5://127.0.0.1:7890 # 配置后所有目标都走 SOCKS5

本地地址（localhost / 127.0.0.1）自动直连，不走代理，所以本地 Ollama 无需单独关代理。

常见供应商示例

plugins:
  byok:
    proxy:
      socks5: socks5://127.0.0.1:7890
    providers:
      # 中转站：一个 key 搞定所有模型
      openrouter:
        baseURL: https://openrouter.ai/api/v1
        apiKey: ${OPENROUTER_API_KEY}

      # 阿里云百炼
      bailian:
        baseURL: https://dashscope.aliyuncs.com/compatible-mode/v1
        apiKey: ${BAILIAN_API_KEY}
        models: [qwen3-235b, qwen-max]

      # 本地 Ollama（不走代理，key 填任意值）
      local:
        baseURL: http://localhost:11434/v1
        apiKey: ollama
        models: [llama3.3]

      # Gemini 官方 OpenAI 兼容端点
      gemini:
        baseURL: https://generativelanguage.googleapis.com/v1beta/openai
        apiKey: ${GEMINI_API_KEY}

当前限制

• 纯文本透传，暂不支持图片（vision）
• 不做 DeepSeek 私有协议（thinking / reasoning_effort / reasoning_content passback）——用 DeepSeek 中转站请用官方 llm-deepseek
• 模型列表默认手动声明，/models 自动拉取后续再加

License

MIT