在 DeepSeek Harness 中接入 WanAPIs

接入步骤

1. 1

   创建一把 API Key

   在 WanAPIs 控制台注册,到「API 密钥」页创建一个 sk- 开头的 Key,分组用 default。建议给 Harness 单独建一把:控制台的日志和用量按 Key 分开统计,能一眼看出这个智能体花了多少。

2. 2

   添加 WanAPIs 为模型提供商

   打开 Harness 的 设置 → 模型 → 添加模型提供商,切到「自定义模型 API」,按下面填。Provider ID 用小写的 wanapis:建好后基本不能改,后面配置文件里用到的密钥名 WANAPIS_API_KEY 也是从它派生的。API 地址只填到 /v1,不要写 /chat/completions,Harness 会自己补上。

   设置 → 模型 → 添加模型提供商 → 自定义模型 API

   Provider ID: wanapis
   显示名称:    WanAPIs
   API 地址:    https://api.wanapis.com/v1
   API 协议:    OpenAI Chat Completions
   API 密钥:    sk-xxx

3. 3

   获取可用模型:先「取消全选」,再勾 deepseek-v4.1-flash

   点表单里的「获取可用模型」,会弹出 WanAPIs 上你能用的全部模型,而且默认全部勾选,有两百多个。先点「取消全选」,在搜索框输入 deepseek,只勾 deepseek-v4.1-flash,再点「添加所选」。其他想用的模型(比如 gpt-5.6-sol、claude-opus-5)也在这里一起勾上。列表按 Key 的分组过滤,如果 Key 不在 default 分组,可能找不到 deepseek-v4.1-flash,点表单里的「添加模型」手动填模型 ID 也一样能用。

   

4. 4

   把上下文窗口设成 1000000,创建提供商

   点模型那一行右边的「›」展开模型选项,「上下文窗口」填 1000000。不填的话 Harness 按 26 万上下文估算,长会话会被它提前截断,提示已达输出上限。「最大输出 token 数」留空即可。最后点「创建提供商」。

   

5. 5

   打开思考强度:在配置文件里声明档位

   Harness 不会从接口识别 DeepSeek 的思考档位,界面里也没有这个设置。不声明的话,模型选择器里只有「模型」,没有「推理等级」。打开 设置 → 右上角「打开配置文件」(Web 版的文件在 ~/.dsh/profiles/web/cordis.patch.yml),找到上一步自动写进去的 llm-pi-ai 那一段,在 wanapis 下加一行 reasoning,在 deepseek-v4.1-flash 下加 compat 和 reasoningEfforts,也就是下面标了「新增」的几行。缩进要用空格,改之前可以先复制一份备份。

   ~/.dsh/profiles/web/cordis.patch.yml

   - id: llm-pi-ai
     name: "@deepseek-ai/dsh-llm-pi-ai"
     config:
       providers:
         wanapis:
           reasoning: high               # 新增:新会话默认用哪一档
           displayName: WanAPIs
           apiKeyEnv: WANAPIS_API_KEY
           api: openai-completions
           baseURL: https://api.wanapis.com/v1
           models:
             - id: deepseek-v4.1-flash
               name: deepseek-v4.1-flash
               contextWindow: 1000000
               compat:                   # 新增
                 thinkingFormat: deepseek  # 新增:没有这行,选 Off 也照样思考
               reasoningEfforts:         # 新增
                 off:                    # 新增
                 low: low                # 新增
                 high: high              # 新增
                 max: max                # 新增

6. 6

   在模型选择器里切换思考档位

   保存后 Harness 会自动重新加载配置,实测不用重启;没变化就重启一次。之后在输入框右下角的模型选择器里,「推理等级」可以选 Off / Low / High / Max。Off 是完全不思考,最快也最省;日常写代码用 High;难题用 Max。DeepSeek 只有 low、high、max 三档,medium 之类的效果和 high 一样,所以给这四个选项就够了。

   

7. 7

   让联网搜索也走 WanAPIs

   Harness 的网页搜索插件不走聊天用的模型,而是自己直连 DeepSeek 官方,去找 DEEPSEEK_API_KEY;只配了 WanAPIs 的话,一搜就报 no API key for "DEEPSEEK_API_KEY"。在同一个配置文件末尾加上下面这段即可。apiKeyEnv 填 WANAPIS_API_KEY,复用第 2 步存好的 Key,不用再填一遍;如果你的 Provider ID 不是 wanapis,就照抄 llm-pi-ai 那段里 apiKeyEnv 的值。model 必须是 deepseek-v4.1-flash-1017,换成别的模型名,在我们这边不会真正执行搜索。

   ~/.dsh/profiles/web/cordis.patch.yml(加在文件末尾)

   - id: web-search-deepseek
     config:
       baseURL: https://api.wanapis.com/v1
       apiKeyEnv: WANAPIS_API_KEY
       model: deepseek-v4.1-flash-1017

8. 8

   在「插件 → 网页搜索」里确认

   打开左侧栏的 插件 → 网页搜索:「接口地址」显示 https://api.wanapis.com/v1(标着「已覆盖」),API Key 旁显示「已配置密钥」,就说明生效了。这个页面只有 API Key、接口地址和单次请求最多搜索次数,没有「模型」这一项,所以模型只能写在配置文件里。

   

9. 9

   试一次联网搜索,留意费用

   新开一个会话,问一个需要查资料的问题。回答里带来源链接,就是搜索真的执行了。每次搜索约 ¥0.1(搜索费约 ¥0.091,加上 token)。注意 Agent 回答一个开放问题时可能连续搜好几次:我们实测一个宽泛的问题搜了 7 次,约 ¥0.7。想省钱就在提问里写「只搜一次」。控制台日志里,每次搜索都是一条单独的 deepseek-v4.1-flash-1017 记录。

   

10. 10

    成本:长会话靠缓存省很多

    deepseek-v4.1-flash 在默认分组是 输入 ¥0.50 / 输出 ¥4.00(每百万 token)。编码智能体的特点是同一段上下文被反复发送,而命中缓存的输入按 8% 计费,实际付费的主要是新增部分,所以别被「上下文很长」吓到,真正贵的是输出。先让它做一件小事,到控制台「使用日志」页确认请求到了 WanAPIs、模型名对、扣费正常,再放开用。

    默认分组单价(元 / 百万 token)

    deepseek-v4.1-flash    输入 0.50   输出 4.00   命中缓存的输入按 8% 计
    gpt-5.6-sol            输入 5.00   输出 30.00
    claude-opus-5          输入 5.00   输出 25.00

已知限制

• 实测的是 Harness 0.2.0-rc.2 的 Web 版(dsh web)。桌面版没有实测,菜单文字可能略有不同,配置文件格式相同。
• 思考档位和联网搜索的模型只能写在配置文件里,界面上没有对应的设置项。
• 联网搜索只能用 deepseek-v4.1-flash-1017,其他模型名在我们这边不会真正执行搜索。
• 「网页获取」(打开网页正文)是 Harness 在你电脑上直接访问网页,不经过 WanAPIs,也不收费。
• Harness 还在预览阶段(0.2),配置格式以后可能变化;遇到对不上的地方,以 Harness 当前版本为准。

常见问题