Esta página todavía está disponible solo en chino. La navegación y los menús ya aparecen en español.

配置 DeepSeek Harness

DeepSeek Harness（dsh）支持自定义 OpenAI-compatible Provider，可以通过 Chat Completions 协议调用 InOneAPI。DeepSeek Harness 目前处于 developer preview，官方可能发布不兼容变更；升级后应重新核对配置。

安装并启动

安装 Node.js 后可直接运行：

npx @deepseek-ai/dsh web

默认 Web UI 地址为 http://127.0.0.1:3080。如果在远程主机运行，使用 --no-open，并通过安全的 SSH 端口转发访问，不要直接暴露管理端口。

通过界面添加 Provider

打开 Settings → Models → Add a custom provider，填写：

字段值
Provider IDinoneapi
Display nameInOneAPI
Base URLhttps://api.inoneapi.com/v1
API protocolopenai-completions
API keyInOneAPI 项目 Key
Model模型详情页中的 YOUR_MODEL_ID

模型详情页优先提供上述界面向导，无需手写凭据文件。向导将凭据保存在 $DSH_HOME/.credentials.yaml，配置仅引用凭据。保存后在模型选择器中选择 inoneapi 下的模型，并新建会话；已经发起请求的会话可能继续使用原模型。模型探测失败不一定表示请求不可用；可以手动添加模型 ID。

可选：使用配置文件

也可以编辑 $DSH_HOME/settings.yaml；默认 DSH_HOME 为 ~/.dsh：

llm-pi-ai:
  providers:
    inoneapi:
      displayName: InOneAPI
      apiKeyEnv: INONEAPI_API_KEY
      api: openai-completions
      baseURL: https://api.inoneapi.com/v1
      models:
        - id: "YOUR_MODEL_ID"
          name: "YOUR_MODEL_ID"

将凭据写入 ~/.dsh/.env，不要写进 settings.yaml：

INONEAPI_API_KEY=ioa_sk_...
chmod 600 ~/.dsh/.env

配置会在下一次请求时重新读取，一般不需要重启。

模型能力声明

手工添加的模型默认按纯文本模型处理。如果模型确实支持图片输入，可显式声明：

llm-pi-ai:
  providers:
    inoneapi:
      apiKeyEnv: INONEAPI_API_KEY
      api: openai-completions
      baseURL: https://api.inoneapi.com/v1
      models:
        - id: "YOUR_MODEL_ID"
          input: [text, image]

只有在模型详情明确支持对应能力时才添加声明；配置不会自动验证上游是否接受图片。

验证与排障

新建会话，执行短任务并检查 InOneAPI Trace。常见问题：

  • MISSING_CREDENTIAL 或 401：检查 INONEAPI_API_KEY 和 .env 文件位置。
  • UNKNOWN_MODEL 或 404：手动添加准确的模型 ID，并检查项目模型白名单。
  • 模型列表为空：直接录入模型 ID；模型发现只是便利功能。
  • 推理模型参数被拒绝：先删除自定义 reasoning 声明，使用端点默认行为，再按 Harness 官方兼容字段逐项调整。

DeepSeek Harness 的插件和 shell 能在本机执行操作。为其使用独立 Key、有限预算和最小模型范围，同时保留其自身的沙箱与审批设置。

CC Switch 当前 Provider 导入协议未列出 DeepSeek Harness，因此不提供导入按钮。

官方参考：DeepSeek Harness 模型配置。

DeepSeek Harness · Documentación · InOneAPI