DeepSeek Harness 配置指南

DeepSeek Harness (DSH) 是 DeepSeek 推出的面向智能体工程与开发者的原生 Agent 客户端及工具套件。通过自定义提供商接入 BBToken（https://bbtoken.boywe.cn），无需担心额度与网络波动，即可直接调度高并发的 deepSeek-V4-flash、bbqwen3.8-flash-next 等模型底座。

📸 配置界面参考

⚡ 核心参数速查

📖 方式一：客户端图形界面配置（推荐）

第一步：进入模型设置面板

1. 启动 DeepSeek Harness 客户端。
2. 点击界面左下角的 「⚙ 设置」 图标。
3. 在弹出的设置浮窗左侧栏中，选择 「模型」（位于「通用设置」下方）。

第二步：编辑或新增提供商

1. 在右侧主面板中，找到现有提供商卡片进行编辑，或滑动到最底部点击 「+ 添加模型提供商」。
2. API 密钥：在输入框中粘贴你的 BBToken 密钥（形如 sk-xxxxxxxx）。
3. 点击展开 「自定义设置」 折叠栏：
   • 显示名称：填入 BBToken；
   • API 地址：填入 https://bbtoken.boywe.cn/v1；
   • API 协议：点击下拉框，选择 OpenAI Chat Completions。

第三步：配置模型目录

在「模型目录（已自定义模型目录）」区域：

1. 点击下方的 「+ 添加模型」 按钮。
2. 在新增的模型行中，分别填写模型 ID（左框）与显示名称（右框）：
   • deepSeek-V4-flash ➔ deepSeek-V4-flash (或别名 bbtoken-DeepSeek-V4-Flash)
   • bbqwen3.8-flash-next ➔ bbqwen3.8-flash-next
   • glm-4.7-flash ➔ glm-4.7-flash
   • nanbeige4.2 ➔ nanbeige4.2
3. 检查填写无误后，点击右下角的 「保存」 按钮。

第四步：选择模型并启动 Agent 会话

1. 关闭设置窗口回到主界面，点击左侧导航栏中的 「+ 新会话」 或进入现有 AGENT 对话。
2. 在输入框右下角（发送按钮旁）的模型下拉选择器中，展开并点击刚刚配置的模型（如 deepSeek-V4-flash）。
3. 发送一条消息即可开启高并发、低延迟的智能体交互！

💻 方式二：配置文件直接修改 (cordis.patch.yml)

如果你习惯使用代码配置或批量分发设置，可在设置弹窗右上角点击 「打开配置文件」，或直接编辑本地配置文件：

• Windows 路径：
  %USERPROFILE%\.dsh\profiles\web\cordis.patch.yml
• macOS / Linux 路径：
  ~/.dsh/profiles/web/cordis.patch.yml

在 config.providers 节点中增加或修改 BBToken 配置：

- id: llm-pi-ai
  name: "@deepseek-ai/dsh-llm-pi-ai"
  config:
    providers:
      bbtoken:
        displayName: BBToken
        apiKeyEnv: BBTOKEN_API_KEY
        api: openai-completions
        baseURL: https://bbtoken.boywe.cn/v1
        models:
          - id: deepSeek-V4-flash
            name: deepSeek-V4-flash
          - id: bbqwen3.8-flash-next
            name: bbqwen3.8-flash-next
          - id: glm-4.7-flash
            name: glm-4.7-flash
          - id: nanbeige4.2
            name: nanbeige4.2
- id: agent-default-model
  name: "@deepseek-ai/dsh-agent-default-model"
  config:
    provider: bbtoken
    model: deepSeek-V4-flash

保存配置文件后重启 DeepSeek Harness 即可生效。

🛑 常见避坑排错