开发者预览 · MIT 开源 · 2026-08

DeepSeek Harness:让模型在真实环境里持续干活

DeepSeek Harness(dsh)不是新的聊天模型,而是开源 Agent 运行层。模型负责思考,Harness 负责工具、会话、沙箱与可回放日志。公式很简单:Agent = 模型 + Harness。

页面更新于 2026-08-18 · 依据官方开发者预览公开信息整理

DeepSeek Harness 是什么?

先分清「模型」和「Harness」,再决定你要装哪一层。

Agent = 模型 + Harness

模型是灵魂:负责推理、拆任务、决定下一步。

Harness 是手脚与现场:理解环境、调用工具,并在真实仓库里连续工作。

DeepSeek Harness 是 DeepSeek 于 2026 年 8 月面向全球开发者放出的 Agent 运行基础设施(开发者预览)。源码以 MIT 协议开放,npm 包名为 @deepseek-ai/dsh,仓库地址在 GitHub 的 deepseek-ai/deepseek-harness。

它解决的不是「再发一个会聊天的模型」,而是:模型已经会推理,如何在真实目录里改文件、跑命令、调工具、记日志,并在失败后恢复。没有 Harness,你多半停在对话框;有了 Harness,模型才能在受控边界里连续执行。

官方口号是「一切皆插件」。默认路径仍需配置 DeepSeek API Key。Web UI 可以免费打开,真正跑 Agent 会产生模型调用费用。当前属于 v0.1 系列预览,核心插件与 API 可能出现破坏性变更。

谁适合用 DeepSeek Harness?

和本站网页版对话不是同一类入口,按任务选工具。

  • 要在仓库里跑编码 Agent

    需要读改文件、执行 Shell、检索网页,并让模型连续完成多步工程任务。

  • 要做插件或自定义 preset

    希望在不改 Harness 主干的前提下,替换模型、工具、沙箱或 UI,组装自己的 Agent。

  • 只想打开浏览器聊天

    不必安装 Node.js。请用本站 DeepSeek 网页版入口,直接与 DeepSeek-V4 对话。

架构要点:一切皆插件

DeepSeek Harness 基于 Cordis。内核只管加载与依赖,具体能力全部由插件提供。

  1. 01

    Cordis 内核

    只负责插件的挂载、卸载和依赖关系,不把 Agent 业务写进主干,避免一改能力就要分叉整仓。

  2. 02

    能力都是插件

    模型适配器、工具、技能、会话、沙箱、存储、循环、调度和界面均可作为插件组合,通过服务与事件协作。

  3. 03

    配置层重组

    开发者无需改 Harness 源码,即可在配置层选择、替换或扩展任一能力,按场景组装 Agent。

四种运行模式

同一套插件内核,默认加载不同组合,覆盖日常编码、程序化调工具、基准测试和自定义 preset。

标准模式

功能完整的编码 Agent。

支持文件编辑、Shell、文件与网页检索、Skills、计划、目标、子代理和工作流,适合日常仓库任务。

PTC 模式

用一段代码组合多轮工具调用。

具备标准模式能力,并通过 Code Mode SDK 呈现工具,让模型用 TypeScript 程序编排多步操作。

极简模式

最小工具面,便于基准测试。

通常只保留持久 bash 与文件编辑(str_replace_editor),用来观察模型在最小化环境中的表现。

创造模式

检查运行时并创作自定义 preset。

用于查看当前插件、在内存中试验 Cordis 插件,并组合出新的运行模式。

每一次运行都有迹可循

会话按仅追加事件流记录,恢复、分叉、检索与回放共用同一份日志。

  • 系统提示词、思维链、工具调用与结果会写入会话日志

  • 子 Agent 调度与每一次上下文注入可按来源查看

  • Trajectory 视图帮助你审计模型看见了什么、做了什么

  • 高风险操作应配合权限与审批,而不是把仓库裸交给模型

开始使用

快速体验或从源码安装

需要本机已安装 Node.js。版本要求以官方仓库 README 为准。

快速体验

安装 Node.js 后,可通过 npx 启动 Web UI。默认在本机 3080 端口打开:http://127.0.0.1:3080

$ npx @deepseek-ai/dsh web

源码安装

获取完整项目源码,并按照仓库说明完成安装(pnpm install、pnpm run build、pnpm dsh web)。

$ git clone https://github.com/deepseek-ai/deepseek-harness

配置 API Key 与模型

在界面中配置 DeepSeek API Key,并选择 DeepSeek-V4-Flash 或 DeepSeek-V4-Pro。建议先用 Flash 试跑。

指定工作区与权限

选好仓库目录,收紧文件与命令权限后再下发任务。预览阶段命令与配置可能变化,请以仓库文档为准。

网页对话和 Harness 有什么不同?

本站 DeepSeek 网页版解决「打开就能聊」;Harness 解决「在仓库里连续执行」。

网页对话和 Harness 有什么不同?
对比项 DeepSeek 网页版对话 DeepSeek Harness
你在找什么 免安装在线对话入口 本机 / 源码级 Agent 运行层
典型用户 学习、办公、写作、问答 开发者、做 Agent 与插件的人
能否改仓库文件 以对话为主 可在权限范围内读写文件、跑命令
如何开始 浏览器打开本站入口 npx 启动 Web UI 或克隆源码

DeepSeek Harness 常见问题

关于开源协议、费用、模型选择与网页版差异。

DeepSeek Harness 是官方新模型吗?

不是。它是 DeepSeek 开源的 Agent 运行框架(Harness),用来连接模型、工具、会话与界面。聊天与推理能力仍来自 DeepSeek-V4 等模型。

DeepSeek Harness 免费吗?

框架源码按 MIT 协议开源,可免费获取。运行 Agent 通常要调用 DeepSeek API,会产生 token 费用。以官方定价和你的密钥余额为准。

和本站 DeepSeek 网页版是一回事吗?

不是。网页版面向打开浏览器即对话;Harness 面向开发者在真实环境里跑编码 Agent。需要聊天请用本站入口,需要改代码、跑工具请用 Harness。

用 Harness 必须本机部署大模型吗?

不必。公开文档的常见路径是使用 DeepSeek 云端 API。你需要 Node.js、API Key 和浏览器,不必须自备 GPU。

现在能用于生产环境吗?

官方标明开发者预览,并提示会有兼容性破坏变更。适合学习、试验与插件开发;生产接入请自行评估稳定性,并锁定你验证过的版本。

dsh 是什么?怎么启动?

dsh 是 DeepSeek Harness 的常用缩写与 CLI 名。安装 Node.js 后执行 npx @deepseek-ai/dsh web,默认在 http://127.0.0.1:3080 打开 Web UI。

先分清场景,再选入口

要立刻对话,打开 DeepSeek 网页版;要在仓库里跑 Agent,使用官方 DeepSeek Harness。

本页由 DeepSeek-V4 站点根据 DeepSeek 官方 Harness 页面与 GitHub 仓库公开信息整理,便于检索与对照,并非 DeepSeek 官方站点。安装、配置与兼容性以官方文档和仓库 README 为准。