DeepSeek Harness
Everything is a plugin · Cordis 内核
截至 2026-11-09,DeepSeek Harness(简称 dsh)是 DeepSeek AI 官方开源的 agent harness(MIT 协议),也就是包在模型外面、负责调度、工具和上下文的那一层。当前版本 0.2.2-rc.1(2026-11-04 发布,pre-release),需要 Node.js 24.9 或更新版本。运行 npx @deepseek-ai/dsh web,再到 Settings → Models → Custom model API 填入自己的 API key 和 Base URL,就能开始用。Agent = Model + Harness,这是 DeepSeek 自己的壳,不是随便一个 pip 适配器。
更新于 2026-11-10
一把 key 调 Claude、GPT 与国产模型,把本文的做法直接跑起来。
- 按 token 计费,实时单价见 /models
- 支付宝、微信支付、信用卡、加密货币均可付款
- 充值后自助开通、立刻生效
要点
@deepseek-ai/dsh web
Web UI 默认 127.0.0.1:3080,需要 Node.js 24.9 或更新版本。或 clone + pnpm。
插件内核
挂载、依赖、事件。
官方跑分模式
官网写作 bash + str_replace_editor;0.2.2-rc.1 的界面说明是终端 + 图片读取 + 上下文压缩。Flash 0731 changelog 的跑分脚注用的就是它。
预览警告
README:会有破坏性变更。
dsh 是什么
dsh 是 DeepSeek AI 官方的开源项目(GitHub:deepseek-ai/deepseek-harness,仓库创建于 2026-08-13),采用「一切皆插件」架构,由 Cordis 驱动;除 dsh web 外,还有 headless、acp、sdk 等启动方式。0.2.2-rc.1 起界面新增日语、西班牙语、法语、德语、俄语和巴西葡萄牙语。5 月招聘写 Model + Harness = Agent,对标 Claude Code / Cursor / Codex。8 月开发者预览就是这条线落地。
为什么在热
注意与 PyPI 上第三方的「deepseek-harness」协议包装区分开:官方项目在 GitHub 组织 deepseek-ai 下,仓库名 deepseek-harness。社区插件通常打 dsh-plugin 这个 topic。
时间线
公开招 Code Harness。
Flash 0731 changelog 点名即将发布的 Harness Minimal。
dsh 开发者预览 + Cordis 站点。
已确认 vs 小心
已确认
按 0.2.2-rc.1 与官网核对:预览版、MIT 开源;四种模式——标准、PTC(英文官网写作 Code)、极简、创造;模型看到的内容写入只追加的会话日志,可在 Trajectory 视图按来源查看;DeepSeek changelog 的跑分脚注(极简模式 + max 档)。
小心
上手前先知道三点:dsh 处于 developer preview,README 写明会有不兼容变更;它与 Claude Code 的功能范围并不对等;软件本身按 MIT 开源,模型 token 另按用量付费。
怎么选
需要复现 DeepSeek 官方跑分
照 DeepSeek changelog 写的设置:极简模式(Minimal)+ max 档 + temperature=1.0 + topp=0.95。
需要日常编码 agent
日常任务用标准模式;批量调用工具、再筛选汇总结果的任务用 PTC 模式;记得它仍是预览版。也可以继续用 Claude Code / OpenCode。
安装并接上自己的 API
截至 2026-11-09,按 0.2.2-rc.1 官方文档:1)装 Node.js 24.9 或更新版本;2)运行 npx @deepseek-ai/dsh web,默认在 http://127.0.0.1:3080 打开 Web UI(SSH 启动只打印地址,加 --no-open 则不自动开浏览器);3)进入 Settings → Models → Add model provider,把卡片切到 Custom model API,填小写的 Provider ID(建好后不可改)、Base URL、API protocol、API key,并至少添加一个模型 ID;4)保存后在模型选择器里选模型,改动下一次请求就生效,不用重启。API protocol 有 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 三种,一个 provider 只对应一种协议,网关两种都支持就建两个 provider。配置写入 $DSH_HOME/profiles/web/cordis.patch.yml(字段 api、baseURL、apiKeyEnv),key 存在 $DSH_HOME/.credentials.yaml。想从源码运行:git clone github.com/deepseek-ai/deepseek-harness,再依次 pnpm install、pnpm run build、pnpm dsh web。官网 deepseek.com/harness 另提供 macOS(Apple 芯片)和 Windows(64 位)桌面端下载。
在 QCode 上
dsh 用你自己的 API key:一把 QCode key 就能在 dsh 里同时用 DeepSeek / GLM / Kimi / Qwen / GPT(OpenAI 兼容)和 Claude(Anthropic 兼容),按 token 计费,各模型单价见 /models;不想包月,按量包见 /pay-as-you-go。建两个 provider:OpenAI Chat Completions 的 Base URL 填 https://api.qcode.cc/openai/v1,接 GPT 以及 GLM、Kimi、DeepSeek、Qwen(例如 gpt-6-sol、deepseek-v4-pro、glm-5.3、kimi-k3、qwen3.8-max,国产型号 ID 需手动添加);Anthropic Messages 的 Base URL 填 https://api.qcode.cc/api,接 Claude(例如 claude-sonnet-5)。Claude 走 Anthropic 协议,Base URL 末尾不加 /,模型 ID 逐字照 /models 填写。QCode /models 目录截至 2026-11-09 列有 deepseek-v4-flash、deepseek-v4-pro 与 deepseek-v4.1-flash,可像 OpenAI 或 Anthropic 兼容端点一样配置给 dsh。逐步配置、验证命令和排错表见 https://docs.qcode.cc/docs/ide/deepseek-harness。
常见问题
DeepSeek Harness 是什么?
DeepSeek Harness(dsh)是 DeepSeek AI 官方开源的 agent harness(仓库 deepseek-ai/deepseek-harness,MIT 协议)。它是软件,不是模型:负责调度、工具和上下文,模型 API 另外接。用 npx @deepseek-ai/dsh web 启动网页版,官网也提供桌面端。官方定位是开发者预览,README 写明会有不兼容变更。
Cordis 是什么?
Cordis 是 dsh 底层的插件内核(github.com/cordiverse/cordis):dsh 采用「一切皆插件」架构,工具、技能和界面都可以用插件扩展。官网介绍可以安装现有插件,也可以在创造模式(Creator mode)里通过对话让 Agent 写插件;社区插件通常打 dsh-plugin 这个 topic。
极简模式(Minimal)是做什么的?
用来测模型本身:0.2.2-rc.1 的界面说明是,极简模式只给 Agent 终端和图片读取工具,并带上下文压缩,适合测试和对比基础表现。DeepSeek 2026-07-31 与 2026-08-21 的 changelog 写明,Code Agent 类跑分以它为框架,配 max 档、topp=0.95、temperature=1.0。给模型打分,不是给全家桶打分。
dsh 能接 OpenAI 兼容或 Anthropic 兼容的第三方 API 吗?
能。Settings → Models → Add model provider → Custom model API 就是给中转服务、公司网关、自建服务器或目录里没有的模型服务商用的,协议可选 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages。软件本身按 MIT 开源,模型 API 另按 token 付费。以 QCode 为例:GPT 与国产模型填 https://api.qcode.cc/openai/v1,Claude 填 https://api.qcode.cc/api,用同一把 key。
dsh 能替代 Claude Code 吗?
同一品类,但成熟度还是预览版:官方 Web UI 指南写明,dsh 的 Agent 能读写工作区文件、运行命令、分派子任务并维护计划;README 同时提醒会有不兼容变更。换之前可以先在自己的项目里并行试用,同一把 QCode key 在 Claude Code 和 dsh 里都能用。
DeepSeek Harness 和 harness engineering 是什么关系?
是概念与实现的关系:harness engineering 讲的是 harness 这个通用概念——模型之外那一层调度、工具和上下文管理,站内的 /harness-engineering-guide 有完整介绍;dsh 是 DeepSeek 官方给出的具体实现。
来源
官网 harness 页;GitHub;0731/0813/0821 changelog;npm @deepseek-ai/dsh;GitHub docs/user/guide/providers.md;GitHub 0.2.2-rc.1 源码(Web UI 模式名称);docs.qcode.cc。
相关
加密货币充值指南
9 种币、56 条网络,0 平台手续费购买 AI 编程 API 额度。
依据 DeepSeek 官方仓库、文档与 changelog 整理的独立指南;dsh 为预览版软件,以你安装的版本为准。