生命不息,折腾不止。DeepSeek Harness(dsh)是 DeepSeek 官方出的插件化 Agent 框架,虽然名字带 DeepSeek,但它是「一切皆插件」——通过自定义 provider,Claude、GPT、Gemini、DeepSeek 全都能接进来,一个工具想用哪个切哪个。再配个中转站,按量付费还便宜。

一、DeepSeek Harness 是什么

DeepSeek Harness(dsh)是 DeepSeek AI 开源的一个 Agent 框架,核心设计是「一切皆插件」,底层基于 Cordis 架构。你在本地跑一个 Web UI,让 AI Agent 读写项目文件、执行命令、分解任务、维护计划,可以理解为「本地版 AI 编程助手」。

它最值钱的一点:不锁死 DeepSeek。原生支持「自定义 provider」,任何 OpenAI 兼容的接口都能接进来,等于一个框架吃下所有主流模型。

二、两个真正的好处:多模型 + 便宜

1. 一个工具,用遍所有模型

Harness 里可以同时配多个 provider——Claude 一个、GPT 一个、Gemini 一个、DeepSeek 一个。写代码用 Claude、跑推理用 DeepSeek、多模态用 Gemini,同一个工作流里随意切换,不用装一堆客户端。

2. 按量付费,比官方便宜

中转站把 Claude、GPT、Gemini、DeepSeek 这些官方接口转成人民币按量付费的 OpenAI 兼容接口:

  • 不用绑海外信用卡、不用买官方订阅,充几块钱就能试;
  • 按 token 计费,用多少花多少,比官方订阅/按刀计费灵活太多。

对想一次试遍各家模型的开发者来说,这是成本最低的玩法。

三、安装 Harness

先装好 Node.js,一条命令启动:

1
npx @deepseek-ai/dsh web

Web UI 默认跑在 http://127.0.0.1:3080(本地自动开浏览器;SSH 环境加 --no-open)。

四、接入中转站(核心步骤)

  1. 打开 Settings → Models
  2. Add a custom provider(不是 Add provider,那个是官方目录)
  3. 按下面填写:
    • Provider ID:小写、唯一,比如 claudegptgeminideepseek(想接几个模型就建几个)
    • Display name:随意,比如「Aklibk · Claude」
    • Base URLhttps://ai.aklibk.com/v1
    • API protocol:选 OpenAI Completions
    • API key:中转站后台生成的令牌(同一个 key 通吃所有模型)
    • Model:按需填,例如 claude-sonnet-4-5gpt-4ogemini-2.5-prodeepseek-chat,以中转站后台模型列表为准
  4. 保存即可,不用重启服务,下一条请求就生效。

中转站里一个 API key 就能调用全部模型,所以你只需要建多个 provider(区分模型),共用同一个 Base URL 和 key 就行。

五、(进阶)用配置文件批量配

不想点 UI,直接改 $DSH_HOME/settings.yaml,一次配齐多个模型:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
llm-pi-ai:
providers:
claude:
apiKeyEnv: AKLIBK_API_KEY
api: openai-completions
baseURL: https://ai.aklibk.com/v1
models:
- id: claude-sonnet-4-5
gpt:
apiKeyEnv: AKLIBK_API_KEY
api: openai-completions
baseURL: https://ai.aklibk.com/v1
models:
- id: gpt-4o
deepseek:
apiKeyEnv: AKLIBK_API_KEY
api: openai-completions
baseURL: https://ai.aklibk.com/v1
models:
- id: deepseek-chat
- id: deepseek-reasoner

Key 存在 $DSH_HOME/.credentials.yaml,settings 里只留引用。

六、常见问题

  • 模型列表拉不到:Base URL 或协议填错了,确认是 https://ai.aklibk.com/v1 + OpenAI Completions
  • 请求 401:API key 没填对,去中转站后台重新复制令牌;
  • 某模型报错:确认中转站开了这条线,换个模型 ID 试。

七、写在最后

DeepSeek Harness + 中转站,是「一个框架玩转所有主流模型」最省心的组合。中转站我平时用 ai.aklibk.com,Claude、GPT、Gemini、DeepSeek 全系都有,人民币按量付费、注册即用,想试哪家切哪家,成本还低。

生命不息,折腾不止。后续继续分享 DeepSeek Harness 写插件、跑多 Agent 协作的玩法。