DeepSeek Harness · 开发者预览版

DeepSeek Harness 一切皆插件 · Agent 运行时

模型是 Agent 的灵魂,Harness 让 Agent 理解环境、使用工具,并在真实场景中持续工作。DeepSeek Harness(dsh)已开源:先打开 DeepSeek 网页版与 DeepSeek-V4 对话验证任务,再按需在本地用插件组合完整 Agent。

MIT

开源协议

DeepSeek Harness 商用友好

插件

一切皆插件

模型到 UI 均可替换

4

运行模式

标准 / PTC / 极简 / 创造

V4

DeepSeek-V4

先网页版验证再本地跑

Agent = Model + Harness

Harness 让 DeepSeek Agent 在真实场景持续工作

DeepSeek-V4 提供推理与对话;DeepSeek Harness 提供环境、工具与可追踪运行。两者叠加,才是可落地的 Agent。

Cordis 内核

Cordis 只负责插件的加载、卸载与依赖,不承载 Agent 的具体能力。DeepSeek Harness 把「能做什么」全部交给插件。

DeepSeek Harness Cordis

插件提供能力

模型、工具、技能、会话、沙箱、存储、循环、调度、UI 等所有 Agent 能力均由插件提供,并通过 Cordis 服务与事件彼此协作。

DeepSeek 一切皆插件

配置层自由组合

开发者无需改 DeepSeek Harness 源码,即可在配置层选择、替换或扩展任一能力,快速试验适合 DeepSeek-V4 的工具组合。

DeepSeek Harness 可组合
DeepSeek Harness 核心能力

六项能力,定义开源 Agent 运行时

面向 Harness 开发者的预览版:开源、可替换、可追踪。适合与 DeepSeek 网页版、DeepSeek-V4 组成「对话验证 + 本地执行」工作流。

一切皆插件

DeepSeek Harness 基于 Cordis 插件系统。模型适配、工具注册、会话日志、Agent 循环乃至 UI 都是插件,可在配置中自由替换。

DeepSeek Harness 插件

运行有迹可循

模型看到的一切写入仅追加会话日志:系统提示、思维链、工具调用与结果、子 Agent 调度与上下文注入。Trajectory 视图按来源回放。

DeepSeek Trajectory

四种运行模式

标准模式提供完整工具;PTC(Code)模式用生成代码编排多步调用;极简模式用于基准测试;创造模式用于试验插件并创作新 preset。

DeepSeek Harness 模式

与 DeepSeek-V4 互补

DeepSeek 网页版适合先把任务说清楚、对比 Pro / Flash;Harness 适合把同一任务放到带沙箱与工具的本地 Agent 中连续执行。

DeepSeek-V4 Agent

Web UI 一键拉起

安装 Node.js 后执行 npx @deepseek-ai/dsh web,默认打开本地 Web UI(127.0.0.1:3080)。源码安装可用 pnpm 构建后运行同一命令。

DeepSeek dsh web

开放插件生态

为插件仓库添加 GitHub topic「dsh-plugin」便于发现。核心插件与 API 仍在迭代,官方明确提示将出现破坏性变更。

dsh-plugin 生态
DeepSeek Harness 速览

开发者预览版,你需要记住的事实

信息来自 DeepSeek 官方介绍页与 GitHub 仓库 README,便于检索 DeepSeek Harness / dsh 相关问题。

dsh

命令行名称

DeepSeek Harness 的 CLI 与包名线索:npx @deepseek-ai/dsh web

Cordis

插件内核

只管理加载 / 卸载 / 依赖,Agent 能力全部由插件提供

MIT

开源许可

官方仓库 deepseek-ai/deepseek-harness 以 MIT 协议开放源代码

4

内置模式

标准、PTC(Code)、极简、创造,覆盖编码 Agent 到基准测试

3080

默认 Web 端口

npx 启动后本地 Web UI 默认监听 127.0.0.1:3080

预览

开发者预览

面向全球 Harness 开发者测试,核心插件与 API 持续迭代

插件

模型也可替换

含模型适配与 UI

日志

仅追加会话

恢复 / 分叉 / 回放同源

V4

DeepSeek-V4

网页版先验证意图

开源

GitHub 同步

Discussions 收集反馈

DeepSeek Harness 仍处于开发者预览,官方强调将出现破坏兼容性的变更。生产系统请勿盲目锁定版本;对话与方案验证可先使用本站 DeepSeek 网页版。

先在 DeepSeek 网页版把任务说清楚

DeepSeek Harness 适合本地 Agent 执行;意图、提示词与 DeepSeek-V4 效果,建议先在网页版验证。

DeepSeek Harness 运行模式

四种模式,覆盖从基准测试到自定义 Agent

无需改源码即可切换模式。详细对比与适用场景见「运行模式」子页。

标准模式

功能完整的编码 Agent:文件编辑、Shell、文件与网页检索、Skills、计划、目标、子代理和工作流。适合日常研发任务。

DeepSeek Harness 标准模式

PTC / Code 模式

具备标准模式全部能力,并通过 Code Mode SDK 呈现工具,让模型用一个 TypeScript 程序组合多步操作,减少来回工具调用。

DeepSeek PTC Code Mode

极简模式

仅提供持久 bash 与 str_replace_editor 的双工具编码 Agent,用于最小化环境下的模型基准测试(含 DeepSeek-V4 相关评测场景)。

DeepSeek Harness 极简模式

创造模式

用于创建自定义 Agent preset:具备标准模式能力,并提供运行时检查、内存中试验 Cordis 插件,以及 preset 创作指导。

DeepSeek Harness 创造模式

运行模式

设计思路

一切皆插件,每一次运行都有迹可循

这是 DeepSeek 官方对 Harness 的核心表述,也是检索「DeepSeek Harness 是什么」时最该记住的三点。

01

一切皆插件

DeepSeek Harness 基于 Cordis 插件系统构建。模型、工具、技能、会话、沙箱、存储、循环、调度、UI 均由插件提供,并通过服务与事件协作。开发者不必 fork 源码即可在配置层重组能力。

02

每一次运行都有迹可循

系统提示词、思维链、工具调用与结果、子 Agent 调度、每一次上下文注入,都会写入仅追加会话日志。恢复、分叉、检索与回放共享同一份事件流,Trajectory 视图可按来源检查。

03

多种运行模式

标准模式给完整工具组合;PTC 模式用模型生成的代码串联多轮工具;极简模式只留 shell 与文件编辑,服务评测;创造模式检查运行时、试验插件并组合新模式。

快速体验

本地拉起 Web UI,或从源码安装

以下命令来自官方文档,供开发者对照。若你想先确认任务表述与 DeepSeek-V4 效果,建议从本站 DeepSeek 网页版开始对话。

快速体验

安装 Node.js 后,可通过 npx 启动 Web UI。

npx @deepseek-ai/dsh web

源码安装

获取完整项目源码,并按照仓库说明完成安装。

git clone https://github.com/deepseek-ai/deepseek-harness
DeepSeek Harness FAQ

关于 DeepSeek Harness 的常见疑问

它和 DeepSeek 网页版、DeepSeek-V4 是什么关系?能否用于生产?以下按官方口径整理。

01 DeepSeek Harness 是什么?

DeepSeek Harness(命令名 dsh)是 DeepSeek AI 开源的 Agent 运行时(agent harness)。它让模型理解环境、调用工具,并在真实场景中持续工作。架构口号是「一切皆插件」,内核为 Cordis。

02 Harness 和 DeepSeek 网页版、DeepSeek-V4 有何不同?

DeepSeek 网页版与 DeepSeek-V4 解决「对话、推理、长上下文」;Harness 解决「工具、沙箱、会话日志、可替换运行时」。推荐路径:先在网页版把任务说清楚,再按需用 dsh 在本地跑带工具的 Agent。

03 现在能用于生产环境吗?

官方定位为开发者预览,并明确警告将出现破坏兼容性的变更。适合试验插件、评测与学习架构,不适合把关键生产系统钉死在当前版本。

04 如何最快体验 DeepSeek Harness?

安装 Node.js 后运行 npx @deepseek-ai/dsh web,默认打开 http://127.0.0.1:3080。也可 git clone 官方仓库后按 README 用 pnpm 安装构建。想先对话验证,请用本站「立即体验」进入 DeepSeek 网页版。

05 Cordis 是什么?

Cordis 是 DeepSeek Harness 使用的插件内核,负责插件加载、卸载与依赖。Agent 的模型、工具、UI 等具体能力不在内核里,而在插件中,通过服务与事件协作。

06 PTC 模式和 Code 模式是一回事吗?

官方中文页称 PTC 模式,英文页称 Code mode:都指用模型生成的一段代码(经 Code Mode SDK)组合多轮工具调用,同时保留标准模式能力。

07 极简模式有什么用?

极简模式只保留持久 bash 与 str_replace_editor,用于最小化环境的模型基准测试。公开评测说明中,DeepSeek-V4-Flash 的部分 Code Agent 分数与极简模式框架相关。

08 如何发布社区插件?

在插件仓库添加 GitHub topic「dsh-plugin」便于被发现。反馈与缺陷建议走官方 GitHub Discussions。核心插件与基础 API 仍会持续迭代。

09 会话可以回放吗?

可以。模型看到的提示、思维链、工具结果与子 Agent 调度都会写入仅追加日志。恢复、分叉、检索与回放共用同一事件流,可在 Trajectory 视图按来源查看。

10 必须改源码才能换模型或工具吗?

不必。官方强调开发者无需改动 DeepSeek Harness 源码,即可在配置层选择、替换或扩展任一能力,包括模型适配与 UI。

11 开源协议是什么?

官方仓库以 MIT 协议开源,第三方依赖见仓库内 THIRD_PARTY_NOTICES。商用前请自行阅读许可证与预览版免责声明。

12 不会装本地环境时怎么先用 DeepSeek?

先打开本站 DeepSeek 网页版,与 DeepSeek-V4 直接对话,确认提示词与任务拆解;需要本地工具与沙箱时,再安装 Node.js 运行 dsh。两条路径互补,并不互相替代。

DeepSeek-V4 + Harness,从对话到可执行 Agent

网页版验证思路,Harness 组合插件与工具。从本站一键跳转 DeepSeek 网页版开始。