DeepSeek Harness 是什么?官方 DSH 项目与能力边界

解释 DeepSeek Harness(DSH)是什么、官方仓库在哪里、它与 DeepSeek 模型有什么区别,以及 npm 默认版与 GitHub 预发布版的当前状态。

社区整理已复核原始来源
DSH
0.2.2-rc.1
系统
Windows / macOS / Linux
风险
low
本页目录(10)

当前基线与首次验证

2026-11-11 复核:npm 默认精确版本为 0.2.2-rc.1,仍为候选版,要求 Node.js ≥24.9.0。本文依据固定 README(外部链接,在新标签页打开)、架构文档(外部链接,在新标签页打开)和 CLI 参考(外部链接,在新标签页打开)审阅,没有执行安装或真实模型调用。(2026-09-10 的上一次复核基于 0.1.5-rc.1,当时 Node 范围是 ^22.19.0 || >=24.0.0。)

新会话默认模型为 deepseek-flash,已有显式模型配置优先,不需要为跟随教程覆盖原设置。先在模型页确认实际 Provider 和模型,再做无敏感信息的简单任务。已有环境请先看升级与回退和 0.2 系列版本总览。不想安装 Node.js,可以用官方桌面端(macOS Apple Silicon 与 Windows x64)。

一句话答案

DeepSeek Harness(命令名 dsh,简称 DSH)是 DeepSeek AI 开源的 Agent Harness。它不是一个新的 DeepSeek 大模型,而是负责把模型 Provider、工具、工作区、权限、会话、插件和用户界面组合成可运行 Agent 的软件框架。官方项目的源码在 DeepSeek AI 的 deepseek-harness 仓库(外部链接,在新标签页打开),另有官方文档站、产品页和 X 账号,完整清单见官方渠道;52DSH 是独立中文社区,不是 DeepSeek Harness 官网,也不代表官方提供支持或背书。

本文在 2026-11-11 重新核对官方 Release、固定提交和 npm 分发状态。普通用户当前通过 npm 默认安装的是 0.2.2-rc.1;GitHub 最新为 0.2.2-rc.2 候选预发布版,精确包尚未发布到 npm。本文项目定义与入门路径依据 0.2.2-rc.1 固定源码,属于源码审阅,未运行实测。

官方入口在哪里

入口用途判断方式
DeepSeek Harness 官方 GitHub(外部链接,在新标签页打开)查看源码、Release、Issue 和官方说明仓库所有者必须是 deepseek-ai
npm:@deepseek-ai/dsh(外部链接,在新标签页打开)查看普通安装命令实际获得的分发版本以 npm dist-tag 为准,不根据 GitHub 名称猜测
官方文档站(外部链接,在新标签页打开)用户与开发者文档由官方仓库 README 链接;页面未标注对应版本
官方产品页(外部链接,在新标签页打开)桌面端下载、隐私政策与使用条款由官方仓库 homepage 字段指向
GitHub v0.2.2-rc.2 Release(外部链接,在新标签页打开)了解本文复核时的最新预发布变化页面应显示 Pre-release,不等于稳定版
52DSH 中文知识库阅读中文教程、插件资料和排障内容独立社区内容,关键事实继续链接第一方来源

搜索“DeepSeek Harness 官网”时,项目的第一方入口是官方 GitHub 仓库、官方产品页和仓库 README 列出的官方资料;官方 X 账号是 @DeepSeekHarness。第三方中文站、插件目录和教程可以帮助理解与操作,但不能替代 Release、固定源码和 npm 元数据。

当前应该看哪个版本

通道2026-11-11 状态阅读方式
npm latest/next0.2.2-rc.1默认安装分发,仍为候选版;要求 Node.js ≥24.9.0
GitHub 预发布0.2.2-rc.2(11-11)只在 GitHub 发布,npm 尚未发布;默认网页搜索、归档清理工作树和 AgentTeam 有变化,见 0.2 系列总览
52DSH 文章与插件各自标注适用版本旧文章没有因通道变化自动完成新版验证

当前升级判断见0.2.2-rc.1 默认版本升级检查。本页下方的功能概述已按 0.2.2-rc.1(2026-11-11)复核;0.1.5-rc.1 更新说明、alpha.5 升级修复和 alpha.3 SQLite Session 风险保留历史事实;实际操作仍由更新与回退指南承接。

Harness 在这里是什么意思

“Harness”可以理解为把模型能力约束并接入真实工作环境的一套运行框架。模型负责理解和生成,Harness 负责准备系统提示、注册工具、发送请求、执行工具、记录结果、保存会话并应用权限策略。

因此,安装 DSH 不等于下载一个 DeepSeek 模型,也不意味着推理一定发生在本机。具体模型来自你选择的 Provider;费用、日志和数据处理方式也要按 Provider 分别判断。使用 DeepSeek 官方模型 API 时,DSH 默认会把会话日志上传给 DeepSeek,可以在“设置 → 通用”中关闭,见入门教程。DSH 提供的是 Agent 的运行、扩展和交互层。

DSH 能做什么

依据 0.2.2-rc.1 的官方 README、CLI 参考和架构文档,DSH 可以把以下能力组合进 Agent:

  • 选择模型 Provider 和凭据;
  • 在已选择的 workspace 中读取或修改文件;
  • 注册并调用命令、搜索和其他工具;
  • 保存 Session、事件与运行上下文;
  • 通过插件、Profile 和 Bundle 组合能力;
  • 通过 Web UI 或官方桌面端进行交互,或使用 Headless Profile 运行一次性任务;
  • 通过 sdk、acp 等 Profile 和官方 SDK 嵌入其他程序;
  • 按配置把任务委派给子 Agent Provider。

官方提供的 Web UI 快速启动命令是:

npx @deepseek-ai/dsh web

2026-11-11 查询时 npm 默认分发为 0.2.2-rc.1,它要求 Node.js ≥24.9.0(固定根包(外部链接,在新标签页打开)),Node 22 不再受支持;本地安装与缓存仍需单独核对,默认监听 http://127.0.0.1:3080。为让操作和教程对得上,建议使用固定版本 npx @deepseek-ai/[email protected] web。第一次操作请使用安装 DeepSeek Harness 并启动 Web UI;不要把 GitHub 预发布版名称自行拼进安装命令。

为什么官方强调“一切皆插件”

DSH 由 Cordis 驱动。模型适配器、工具注册表、Session、Agent Loop、Web 应用和权限策略都通过插件树组合,而不是全部固定在单一核心中。Profile 描述一次具体启动要加载哪些配置,Bundle 则把一组可复用能力组合起来。

这种设计使 Web、Headless、不同 Provider 和不同工具集可以共享基础能力,又保持各自的配置和运行边界。它也意味着“插件已经被收录”不等于“插件已经安全认证”:第三方包的来源、许可证、版本、构建脚本、文件与网络权限仍需单独审核。更完整的内部关系见DeepSeek Harness 架构解析和DSH 插件、Skills 与 MCP 的能力边界。

它和 DeepSeek 模型有什么区别

名称主要角色需要单独判断的事项
DeepSeek 模型/API生成文本、推理和提出工具调用模型版本、费用、数据处理与服务可用性
DeepSeek Harness组织模型、工具、会话、权限与界面DSH 版本、Profile、工作区和运行权限
Provider向 DSH 提供具体模型和凭据路由API Key、端点、区域、日志和计费
Plugin/Bundle向 DSH 添加能力或组合配置包来源、兼容版本、构建脚本和权限
Skill 或 MCP Server提供说明资源或外部工具能力运行位置、数据流、凭据和维护责任

DSH 可以接入 DeepSeek Provider,也可以按配置接入其他 Provider。项目使用 MIT 许可证不代表每个模型、API、插件或外部服务都采用相同条款。

当前阶段有什么限制

官方仍把 DeepSeek Harness 标为 Developer Preview,并提醒未来可能出现破坏兼容性的变化。这意味着:

  • 命令、配置结构和插件兼容性可能变化;
  • GitHub 预发布版与 npm 默认安装版本可能暂时不一致;
  • 教程必须标注版本和复核日期,不能把源码审阅写成运行实测;
  • 关键工作区需要先备份并使用最小权限;
  • 第三方插件、MCP Server 和外部工具必须分别评估供应链、凭据与数据流风险。

下一步从哪里开始

你的目标推荐入口
第一次了解和完成任务DeepSeek Harness 中文入门
安装并启动 Web UI安装 DeepSeek Harness 并启动 DSH Web UI
配置模型和 API Key配置 DSH 模型、API Key 与 Provider
查找和安装插件安装和管理 DeepSeek Harness 插件
理解权限边界DSH 权限与沙箱指南
查看 0.2 系列变化DSH 0.2 系列版本总览
不装 Node.js 直接使用DSH 桌面端安装与使用

如果只需要一个判断:先使用 npm 默认分发和对应版本教程;只有明确需要预发布功能,并且准备好隔离 Profile、测试工作区和回退路径时,再评估 GitHub 预发布版。

来源与维护信息

本文根据以下原始资料整理。版本变化后,请以官方资料和页面标注的验证日期为准。

完成当前任务后

按结果继续,不要停在文章末尾