DeepSeek Harness 与 WorkBuddy：两个国产客户端的接法

DeepSeek Harness 通过内置 llm-pi-ai 插件声明 provider（api 三选一、地址填站点根）；WorkBuddy 在「自定义供应商」里填站点根地址与令牌，走 OpenAI 兼容的 /chat/completions。

更新于 2026-11-14 · SageLib 团队 · 标签：deepseek-harness、workbuddy、agent

结论要点

dsh 的 api 可选 openai-completions / openai-responses / anthropic-messages
WorkBuddy 只支持 OpenAI 兼容协议
两家的地址都填站点根，不要带 /openai 或 /v1

两家都支持自定义供应商，区别是配置载体不同。

DeepSeek Harness（dsh）

设置 → 模型 → 自定义模型 API：

字段	填什么
Provider ID	唯一标识，如 `sagelib`
API 地址	站点根 `https://api.sagelib.com`
API 协议	`openai-completions` / `openai-responses` / `anthropic-messages` 三选一
API 密钥	控制台令牌
模型目录	「获取可用模型」自动拉取，或手动加模型标识

配置文件在 ~/.dsh/profiles/<profile>/cordis.patch.yml，关键片段：

- id: llm-pi-ai
  config:
    providers:
      sagelib:
        displayName: "SageLib AI 边缘网关"
        apiKeyEnv: SAGELIB_API_KEY
        api: openai-completions
        baseURL: "https://api.sagelib.com"
        models:
          - id: claude-sonnet-5-5

WorkBuddy

设置 → 模型 → 添加模型，「供应商」选自定义：

字段	填什么
Base URL / API 地址	站点根 `https://api.sagelib.com`
API Key	控制台令牌
模型	模型广场里的模型标识

WorkBuddy 只支持 OpenAI 兼容协议，所以模型必须声明 /chat/completions。

验证

发一句话，再到控制台「用量日志」确认调用出现；看不到就对照接入报错排查。

参考来源

OpenAI Chat Completions API

常见问题

dsh 里选哪种 api？

看模型声明了哪些端点：只有 /chat/completions 选 openai-completions，有 /responses 选 openai-responses，有 /messages 选 anthropic-messages。

配置里为什么用 apiKeyEnv 而不是直接写密钥？

dsh 用环境变量名做凭据引用，密钥放在进程环境变量或凭据文件里，避免写进配置。