使用 DeepSeek Harness 配合 CometAPI

使用本指南运行 DeepSeek Harness 配合 CometAPI 使用。DeepSeek Harness 从 $DSH_HOME/settings.yaml 加载自定义模型提供商，该路径默认为 ~/.dsh/settings.yaml。本页面中的配置已使用 @deepseek-ai/dsh@0.1.0-rc.8 验证。每条路由均使用一个代表性模型完成了流式文本轮次和文件读取工具循环。此范围并不意味着每个 CometAPI 模型都接受每种 API 格式。

DeepSeek Harness 目前处于开发者预览阶段，可能会引入破坏性变更。遵循本指南时，请固定使用已测试的软件包版本，并在升级前查阅上游发行说明。

官方参考资料：

先决条件

Node.js 和 npm
拥有有效 API 密钥的 CometAPI 账户，该密钥来自控制台
对于计划使用的每种 API 格式，均需从 CometAPI 模型页面获取一个模型 ID

了解提供商路由

api 值用于选择传输格式。baseURL 截止于 Harness 附加的操作路径之前。

提供商 ID	`api` 值	`baseURL`	请求路径
`cometapi-chat`	`openai-completions`	`https://api.cometapi.com/v1`	`/v1/chat/completions`
`cometapi-responses`	`openai-responses`	`https://api.cometapi.com/v1`	`/v1/responses`
`cometapi-messages`	`anthropic-messages`	`https://api.cometapi.com`	`/v1/messages`

分别替换每个 your-model-id 值。选择一个接受其提供商条目 API 格式的模型。

配置提供程序

确认已测试的 Harness 版本

在配置 Harness 前，确认已固定的软件包版本：

npx @deepseek-ai/dsh@0.1.0-rc.8 --version

该命令应输出 0.1.0-rc.8。

设置您的 CometAPI API 密钥

在启动 Harness 前，将您的密钥存储在 COMETAPI_KEY 中：

read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
export COMETAPI_KEY

在每个启动 Harness 的 shell 会话中设置该变量。请勿将 API 密钥提交到版本控制系统。

添加 CometAPI 提供程序

创建 $DSH_HOME/settings.yaml。如果该文件已有 llm-pi-ai 部分，请将这些提供程序条目合并到其现有的 providers 映射中：

llm-pi-ai:
  providers:
    cometapi-chat:
      displayName: CometAPI Chat Completions
      apiKeyEnv: COMETAPI_KEY
      api: openai-completions
      baseURL: https://api.cometapi.com/v1
      models:
        - id: your-model-id
    cometapi-responses:
      displayName: CometAPI Responses
      apiKeyEnv: COMETAPI_KEY
      api: openai-responses
      baseURL: https://api.cometapi.com/v1
      models:
        - id: your-model-id
    cometapi-messages:
      displayName: CometAPI Anthropic Messages
      apiKeyEnv: COMETAPI_KEY
      api: anthropic-messages
      baseURL: https://api.cometapi.com
      models:
        - id: your-model-id

agent-default-model:
  provider: cometapi-responses
  model: your-model-id

该示例默认选择响应提供程序。更改 agent-default-model.provider 和 agent-default-model.model 以选择其他已配置的条目。如果您更喜欢使用 Web UI，请在导出 COMETAPI_KEY 后启动它，然后使用其模型设置添加或编辑提供程序条目，并选择默认模型：

npx @deepseek-ai/dsh@0.1.0-rc.8 web

默认本地地址为 http://127.0.0.1:3080。若要匹配本指南中的路由名称和基础 URL，直接使用 YAML 仍是最佳方式。

验证文本轮次

从您希望 Harness 使用的项目目录运行一次性无头任务：

npx @deepseek-ai/dsh@0.1.0-rc.8 \
  --profile headless \
  "Reply exactly with: COMETAPI_DSH_OK"

成功运行会输出 COMETAPI_DSH_OK。要检查其他提供程序，请更新 agent-default-model 并再次运行该命令。

验证文件工具使用

创建一个临时哨兵文件，然后要求 Harness 使用文件工具读取它：

printf 'COMETAPI_DSH_TOOL_OK\n' > /tmp/cometapi-dsh-sentinel.txt
npx @deepseek-ai/dsh@0.1.0-rc.8 \
  --profile headless \
  "Read /tmp/cometapi-dsh-sentinel.txt with a file tool, then reply with only its contents."

确认最终答案为 COMETAPI_DSH_TOOL_OK。仅在您接受 Harness 访问文件、进程和网络的工作区中运行它。

可选路由

Harness 有一个名为 google 的内置提供程序路由。以下配置将该路由指向 CometAPI，因此它会替换该路由原生的 Google 端点，而不是添加第二个 Google 路由。将此条目合并到 llm-pi-ai.providers，然后在 agent-default-model 中选择它：

llm-pi-ai:
  providers:
    google:
      displayName: CometAPI Google generateContent
      apiKeyEnv: COMETAPI_KEY
      baseURL: https://api.cometapi.com/v1beta
      models:
        - id: your-model-id

agent-default-model:
  provider: google
  model: your-model-id

请勿向此条目添加 api 字段。内置的 google 路由会保留其原生 Google 协议，并使用 /v1beta/models/{model}:streamGenerateContent?alt=sse 身份验证向 x-goog-api-key 发送流式输出（Streaming）请求。

故障排除

Harness 报告缺少 API 密钥

确认在启动 Harness 的同一 shell 中已设置 COMETAPI_KEY。更改环境变量后重启 Harness。

Harness 未显示已配置的模型

确认 $DSH_HOME/settings.yaml 是有效的 YAML，provider 位于 llm-pi-ai.providers 下，且模型列在该 provider 的 models 下。默认的 DSH_HOME 是 ~/.dsh。

聊天补全或响应使用了错误的路径

将 https://api.cometapi.com/v1 用作 baseURL。不要追加 /chat/completions 或 /responses；Harness 会追加操作路径。

Anthropic 消息返回路径错误

将不含 https://api.cometapi.com 的 /v1 用作 Messages baseURL。Anthropic 适配器会追加 /v1/messages。

Google 生成了重复的 v1beta 路径

请严格使用 https://api.cometapi.com/v1beta。不要追加模型路径，也不要向内置 api 路由添加 google 字段。

某个模型在一个 provider 上可用，但在另一个 provider 上不可用

模型可用性和接受的 API 格式可能不同。请为每个 provider 条目选择模型，而不要假定同一模型适用于全部四种格式。

升级后配置停止工作

DeepSeek Harness 处于开发者预览阶段。请恢复到 @deepseek-ai/dsh@0.1.0-rc.8，然后在将配置调整到其他版本之前查看上游变更。

概览

AI 编码智能体

AI 智能体

AI 聊天客户端

翻译与语言

自动化平台

可观测性与评估

AI 框架

使用 DeepSeek Harness 配合 CometAPI

先决条件

了解提供商路由

配置提供程序

可选路由

故障排除

相关资源

​先决条件

​了解提供商路由

​配置提供程序

​可选路由

​故障排除

​相关资源

先决条件

了解提供商路由

配置提供程序

可选路由

故障排除

相关资源