DeepSeek Harness 接入

在 DeepSeek Harness（dsh）里添加 Orbis 自定义服务，填对模型 ID，关掉会把 Key 发往官方的内置搜索。

用「自定义服务」接入，模型 ID 填 Orbis 的，关掉内置联网搜索。

本文只讲 Orbis 配置与排错。下载安装、工作区和首次文件任务见 DeepSeek Harness 入门图文教程。

DeepSeek Harness（命令 dsh）默认按 DeepSeek 官方设置工作。直接把 DeepSeek 卡片的地址改成 Orbis，聊天会因为模型名不同而失败，联网搜索还会把你的 Orbis Key 发到 DeepSeek 官方。按下面三步配置即可避开。

本文按 dsh 0.1.5 的界面与文档整理。dsh 仍是开发者预览版，菜单名称可能随版本变化，以你看到的界面为准。

1. 准备 Key 和模型 ID

打开 DeepSeek V4.1 Flash 或 DeepSeek V4 Pro 模型页，选一条线路，为它创建 Key。Key 决定线路：只有属于这条线路的 Key 才会走这条线路。
记下模型 ID。Orbis 的 DeepSeek 模型 ID 与 DeepSeek 官方不同：

模型	Orbis 模型 ID	不要填（DeepSeek 官方名）
DeepSeek V4.1 Flash	`deepseek-v4.1-flash`	`deepseek-flash`
DeepSeek V4 Pro	`deepseek-v4-pro-0813`	`deepseek-v4-pro`

模型页右侧「模型 ID」一栏始终是准确值；以后新增模型时以模型页为准。

2. 添加 Orbis 自定义服务

在 dsh 网页界面打开 Settings → Models → Add custom provider，按下表填写：

字段	填写
Provider ID	`orbis`（小写，保存后不能修改）
Display name	`Orbis`
Base URL	`https://api.orbiorbi.com/v1`
API protocol	`openai-completions`
Credential	你的 Orbis Key
Models	手动添加第 1 步的模型 ID，例如 `deepseek-v4.1-flash`

保存后，在会话里把模型切换到 orbis 下的模型。

不要在内置 DeepSeek 卡片里填 Orbis Key，也不要只设置 DEEPSEEK_BASE_URL：内置路由会发送 DeepSeek 官方模型名，Orbis 会返回「无可用渠道」。

用配置文件（可选）

习惯改文件的读者，可以在 dsh 的配置文件中写入同样的内容。新版本位于 $DSH_HOME/profiles/web/cordis.patch.yml，早期版本为 $DSH_HOME/settings.yaml；所在位置和外层结构以你的版本文档为准，服务本身的字段如下：

orbis:
  api: openai-completions
  baseURL: https://api.orbiorbi.com/v1
  apiKeyEnv: ORBIS_API_KEY
  compat:
    thinkingFormat: deepseek
    supportsDeveloperRole: false
    maxTokensField: max_tokens
  models:
    - id: deepseek-v4.1-flash
      input: [text, image]
    - id: deepseek-v4-pro-0813

thinkingFormat: deepseek：让「思考」开关按 DeepSeek 的方式发送。自定义服务不一定能自动识别这是 DeepSeek 模型，切换思考强度报 400 时先检查这一项。
input: [text, image]：只给支持图片输入的模型加。DeepSeek V4.1 Flash 支持图片，V4 Pro 只支持文本。
启动前设置环境变量 ORBIS_API_KEY，Key 不写进文件。

3. 关闭内置联网搜索

dsh 的内置搜索插件固定请求 DeepSeek 官方地址，不跟随你配置的 Base URL，却会带上同一个 Key。结果是聊天正常、一搜索就报 401，并且 你的 Orbis Key 被发送到了 DeepSeek 官方。

在 Settings → Plugins → Web search 中关闭内置搜索，或在配置文件中禁用 web-search-deepseek。需要联网搜索时，改用不依赖 DeepSeek 官方地址的第三方搜索插件。

如果之前已经按官方方式配置并触发过搜索，Key 可能已经发往 DeepSeek。到 API 密钥停用这枚 Key 并新建一枚，同时更新 dsh 里的 Key。

4. 确认接通

免费自检：用 Key 请求 GET https://api.orbiorbi.com/v1/models，列表里应有你填写的模型 ID。返回 401 时检查 Key 是否有效；没有这个模型时检查 Key 绑定线路与模型权限。
在 dsh 新建会话，发一句话。
到使用日志查看是否出现这次调用。

常见报错

你看到的报错	原因	怎么改
`分组 … 下模型 deepseek-flash 无可用渠道` / `model_not_found`	用了 DeepSeek 官方模型名，或 Key 所属线路没有这个模型	按第 1 步改用 Orbis 模型 ID，确认 Key 属于该模型的线路
`UNKNOWN_MODEL`	dsh 的自定义服务里没有添加这个模型	在 Orbis 服务的 Models 中添加该模型 ID
`MISSING_CREDENTIAL`	没有保存 Key，或引用的环境变量未设置	在 Models 页重新保存 Key，或设置环境变量后重启 dsh
「获取可用模型」返回 401	Key 无效	检查 Key；也可以直接手动填写模型 ID
搜索时报 `Authentication Fails, Your api key … is invalid`	内置搜索把 Key 发到了 DeepSeek 官方	按第 3 步关闭内置搜索，并更换 Key
切换思考强度后报 400	思考参数格式不对	在服务的 compat 中设置 `thinkingFormat: deepseek`
发送图片被拒	模型未声明图片输入，或模型本身不支持图片	只给 V4.1 Flash 加 `input: [text, image]`

正常回答后，再让它读取练习目录的小文件，核对工具记录。一次文字回复不代表所有工具均兼容；测试请求会消耗 API 额度。

仍然无法接通？带上模型 ID、线路名称和脱敏报错联系我们。安装、会话与文件练习见完整图文教程。