DeepSeek Harness

DeepSeek Harness（dsh）是 DeepSeek AI 开源的 Agent Harness。把 ApiGo 注册为自定义 llm-pi-ai provider 后，Harness 即可使用 ApiGo Key、模型目录、用量控制与调用日志。

DeepSeek Harness 当前仍处于 Developer Preview，后续可能出现不兼容变更。

前置条件

• 已安装 Node.js
• 已在 工作空间 → API Keys 创建 ApiGo API Key
• 已从 模型目录 确认当前可用的模型 slug

1. 保存 ApiGo Key

创建 ~/.dsh/.credentials.yaml：

APIGO_API_KEY: sk-apg-...

限制 Harness 目录与凭据文件的访问权限：

chmod 700 ~/.dsh
chmod 600 ~/.dsh/.credentials.yaml

不要把 Key 写入 settings.yaml、项目文件、Shell 历史或 Git。这里的 APIGO_API_KEY 是下一步 provider 配置通过 apiKeyEnv 引用的凭据名称。

2. 注册 ApiGo provider

创建或编辑 ~/.dsh/settings.yaml：

ui-onboarding:
  welcomeNoticeVersion: 2026-08-13.1
agent-presets:
  default: code
llm-pi-ai:
  providers:
    apigo:
      displayName: apigo
      apiKeyEnv: APIGO_API_KEY
      api: openai-completions
      baseURL: https://api.apigo.ai/v1
      models:
        - id: deepseek-v4-flash
          name: deepseek-v4-flash
        - id: deepseek-v4-pro
          name: deepseek-v4-pro
agent-default-model:
  provider: apigo
  model: deepseek-v4-flash

这段配置是必要前置条件：ApiGo 在 Harness 中是一条自定义 provider 路由。仅设置 DEEPSEEK_BASE_URL 会继续使用原生 deepseek-official 路由，并不会选中 ApiGo provider。

模型必须使用 ApiGo 当前目录中的精确 slug。切换模型时，同时更新 provider 的 models 列表与 agent-default-model.model。

3. 启动 Harness

启动 Web UI：

npx @deepseek-ai/dsh web

打开 http://127.0.0.1:3080，新建会话，并确认当前 provider 与模型显示为 apigo / deepseek-v4-flash。

也可以用 Headless 模式做一次终端验证：

npx @deepseek-ai/dsh --profile headless \
  'Reply with exactly APIGO_HARNESS_OK and nothing else.'

配置成功时会输出：

APIGO_HARNESS_OK

随后到 工作空间 → Call Logs 核对请求。

配置速查

常见问题

相关资源

• DeepSeek Harness 官方仓库
• ApiGo 模型目录
• ApiGo 快速开始