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