接入Deepseek harness

如何接入deepseek-harness

前置准备

1. 环境安装 dsh，启动 web 界面

# node版本建议 ≥22
npx @deepseek-ai/dsh web

访问地址默认：http://127.0.0.1:3080

1. 获取apibee.cn凭证信息

• BaseURL：https://apibee.cn/v1（不要额外拼接路径，末尾保留/v1）

• API‑Key：apibee 平台生成的sk‑xxxx密钥

• 模型 ID：必须与 apibee 后台配置的模型标识完全一致，示例：deepseek‑v4‑pro、deepseek‑flash

1. 网络校验：运行 dsh 的机器可访问apibee.cn；apibee 后台上游已正确配置 DeepSeek 官方接口。

方式 1：WebUI 可视化添加自定义提供商（推荐）

1. 打开 dsh web 页面，左下角【设置】→【模型】

2. 点击添加自定义提供方

DSH

1. 表单填写：

表格

2. 点击【创建提供方】保存配置

3. 返回对话页面，右下角模型下拉框，选择apibee‑gate下对应的 DeepSeek 模型。

功能验证

1. 普通对话测试：发送消息确认能正常返回回答。

2. Agent 工具调用测试：发送指令：读取当前目录下的文件列表，观察 Agent 是否触发工具调用执行操作。

如果只会文字回复，不执行工具，说明 apibee 中转过滤了 tools 参数，需要去 apibee 后台调整上游参数透传设置。

方式 2：修改 settings.yaml 配置（服务器 / 无界面部署）

配置文件路径：

• 默认路径：~/.dsh/settings.yaml

• 自定义路径：环境变量DSH_HOME指定目录

写入配置片段：

providers:
  apibee-gate:
    api: openai-completions
    baseURL: "https://apibee.cn/v1"
    # 明文密钥（本地测试使用，生产环境不建议）
    apiKey: "sk-你的apibee密钥"
    # ✅生产安全写法：注释上面apiKey，改用环境变量读取
    # apiKeyEnv: APIBEE_API_KEY
    models:
      - id: deepseek-v4-pro
      - id: deepseek-flash

【可选】设置Agent默认使用apibee中转的模型
agent-default-model:
  provider: apibee-gate
  model: deepseek-v4-pro

安全启动方式（生产环境，密钥放环境变量）

导出环境变量，不写明文到yaml
export APIBEE_API_KEY="sk-你的apibee密钥"
npx @deepseek-ai/dsh web

修改 yaml 后必须重启 dsh 服务配置才生效。

常见报错排查

1. 401 Unauthorized：apibee 的 sk 密钥错误；或者 apibee 上游 DeepSeek 密钥过期 / 余额耗尽。

2. 404 Not Found：baseURL 写错，确认是https://apibee.cn/v1，不要多写或者少写路径。

1. 连接超时：运行 dsh 的服务器 / 本地网络访问不到apibee.cn域名。

2. 模型下拉列表找不到模型：yaml 缩进错误；models 数组没有正确填写模型 id。

3. 工具调用中途报错解析失败：apibee 改写 / 截断 tool_call 返回的 JSON 结构，关闭中转的 “内容改写、优化提示词” 类功能。

浏览全部教程