--- title: "DeepSeek Harness 是什么？官方 DSH 项目与能力边界" seo_title: "DeepSeek Harness 是什么？官方 DSH 项目与能力边界" description: "解释 DeepSeek Harness（DSH）是什么、官方仓库在哪里、它与 DeepSeek 模型有什么区别，以及 npm 默认版与 GitHub 预发布版的当前状态。" canonical: https://52dsh.com/tutorials/what-is-deepseek-harness/ authors: ["52DSH 编辑部"] audience: [] outcomes: [] prerequisites: [] difficulty: beginner estimated_action_time: null next_steps: null published_at: 2026-08-18 updated_at: 2026-09-10 verified_on: 2026-09-10 maintenance_status: community verification_level: source_reviewed risk_level: low dsh_version: 0.1.5-rc.1 plugin_id: null tutorial_kind: null related_plugin_url: null --- # DeepSeek Harness 是什么？官方 DSH 项目与能力边界 解释 DeepSeek Harness（DSH）是什么、官方仓库在哪里、它与 DeepSeek 模型有什么区别，以及 npm 默认版与 GitHub 预发布版的当前状态。 ## 当前基线与首次验证 2026-09-10 复核：默认精确版本为 `0.1.5-rc.1`，仍为候选版；官方 Node 范围为 `^22.19.0 || >=24.0.0`。本文命令依据[固定 CLI](https://github.com/deepseek-ai/deepseek-harness/blob/183f08e9c6dde7e36cd2318eaee70b0da08fb35e/apps/cli/reference/README.zh.md)审阅，未执行安装或真实模型调用。 新会话默认模型为 `deepseek-flash`，已有显式模型配置优先，不需要为跟随教程覆盖原设置。先在模型页确认实际 Provider 和模型，再做无敏感信息的简单任务；上传文件不代表已被读取。已有环境请先看[升级与回退](/tutorials/dsh-update-uninstall/)和[新版专题](/tutorials/deepseek-harness-0-1-5-rc-1/)。 ## 一句话答案 DeepSeek Harness（命令名 `dsh`，简称 DSH）是 DeepSeek AI 开源的 Agent Harness。它不是一个新的 DeepSeek 大模型，而是负责把模型 Provider、工具、工作区、权限、会话、插件和用户界面组合成可运行 Agent 的软件框架。官方项目只有 [DeepSeek AI 的 `deepseek-harness` 仓库](https://github.com/deepseek-ai/deepseek-harness)；52DSH 是独立中文社区，不是 DeepSeek Harness 官网，也不代表官方提供支持或背书。 本文在 2026-09-10 重新核对官方 Release、固定提交和 npm 分发状态。普通用户当前通过 npm 默认安装的是 `0.1.5-rc.1`；GitHub 最新为 `0.1.5-rc.1` 候选预发布版，精确包已发布到 npm。本文项目定义与入门路径依据 rc.1 固定源码，属于源码审阅，未运行实测。 ## 官方入口在哪里 | 入口 | 用途 | 判断方式 | |---|---|---| | [DeepSeek Harness 官方 GitHub](https://github.com/deepseek-ai/deepseek-harness) | 查看源码、Release、Issue 和官方说明 | 仓库所有者必须是 `deepseek-ai` | | [npm：`@deepseek-ai/dsh`](https://www.npmjs.com/package/@deepseek-ai/dsh) | 查看普通安装命令实际获得的分发版本 | 以 npm dist-tag 为准，不根据 GitHub 名称猜测 | | [GitHub v0.1.3-alpha.1 Release](https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.3-alpha.1) | 了解本文复核时的最新预发布变化 | 页面应显示 Pre-release，不等于稳定版 | | [52DSH 中文知识库](/) | 阅读中文教程、插件资料和排障内容 | 独立社区内容，关键事实继续链接第一方来源 | 搜索“DeepSeek Harness 官网”时，项目的第一方入口是官方 GitHub 仓库和其中列出的官方资料。第三方中文站、插件目录和教程可以帮助理解与操作，但不能替代 Release、固定源码和 npm 元数据。 ## 当前应该看哪个版本 | 通道 | 2026-09-10 状态 | 阅读方式 | |---|---|---| | npm latest／next | `0.1.5-rc.1` | 默认安装分发，仍为候选版 | | GitHub 预发布 | `0.1.5-rc.1` | 与 npm 默认版一致，仍需核对 V3、插件和回退边界 | | 52DSH 文章与插件 | 各自标注适用版本 | 旧文章没有因通道变化自动完成新版验证 | 最新变化见[0.1.5-rc.1 更新与升级判断](/tutorials/deepseek-harness-0-1-5-rc-1/)。此前 [alpha.5 升级修复](/tutorials/deepseek-harness-0-1-2-alpha-5/)和 [alpha.3 SQLite Session 风险](/tutorials/deepseek-harness-0-1-2-alpha-3/)保留历史事实；实际操作仍由[更新与回退指南](/tutorials/dsh-update-uninstall/)承接。 ## Harness 在这里是什么意思 “Harness”可以理解为把模型能力约束并接入真实工作环境的一套运行框架。模型负责理解和生成，Harness 负责准备系统提示、注册工具、发送请求、执行工具、记录结果、保存会话并应用权限策略。 因此，安装 DSH 不等于下载一个 DeepSeek 模型，也不意味着推理一定发生在本机。具体模型来自你选择的 Provider；费用、日志和数据处理方式也要按 Provider 分别判断。DSH 提供的是 Agent 的运行、扩展和交互层。 ## DSH 能做什么 依据 `0.1.5-rc.1` 的官方 README、CLI 参考和架构文档，DSH 可以把以下能力组合进 Agent： - 选择模型 Provider 和凭据； - 在已选择的 workspace 中读取或修改文件； - 注册并调用命令、搜索和其他工具； - 保存 Session、事件与运行上下文； - 通过插件、Profile 和 Bundle 组合能力； - 通过 Web UI 进行交互，或使用 Headless Profile 运行一次性任务； - 按配置把任务委派给子 Agent Provider。 官方提供的 Web UI 快速启动命令是： ```bash npx @deepseek-ai/dsh web ``` 查询时 npm 默认分发为 `0.1.5-rc.1`；本地安装与缓存仍需单独核对，默认监听 `http://127.0.0.1:3080`。第一次操作请使用[安装 DeepSeek Harness 并启动 Web UI](/tutorials/deepseek-harness-install-web-ui/)；不要把 GitHub 预发布版名称自行拼进安装命令。 ## 为什么官方强调“一切皆插件” DSH 由 Cordis 驱动。模型适配器、工具注册表、Session、Agent Loop、Web 应用和权限策略都通过插件树组合，而不是全部固定在单一核心中。Profile 描述一次具体启动要加载哪些配置，Bundle 则把一组可复用能力组合起来。 这种设计使 Web、Headless、不同 Provider 和不同工具集可以共享基础能力，又保持各自的配置和运行边界。它也意味着“插件已经被收录”不等于“插件已经安全认证”：第三方包的来源、许可证、版本、构建脚本、文件与网络权限仍需单独审核。更完整的内部关系见[DeepSeek Harness 架构解析](/tutorials/deepseek-harness-architecture/)和[DSH 插件、Skills 与 MCP 的能力边界](/plugins/skills-mcp-boundary/)。 ## 它和 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 中文入门](/tutorials/dsh-complete-guide/) | | 安装并启动 Web UI | [安装 DeepSeek Harness 并启动 DSH Web UI](/tutorials/deepseek-harness-install-web-ui/) | | 配置模型和 API Key | [配置 DSH 模型、API Key 与 Provider](/tutorials/deepseek-harness-model-provider/) | | 查找和安装插件 | [安装和管理 DeepSeek Harness 插件](/plugins/dsh-plugin-profile-guide/) | | 理解权限边界 | [DSH 权限与沙箱指南](/tutorials/dsh-permissions-sandbox/) | | 查看最新预发布变化 | [0.1.3-alpha.1 变化与获取条件](/tutorials/deepseek-harness-0-1-3-alpha-1/) | 如果只需要一个判断：先使用 npm 默认分发和对应版本教程；只有明确需要预发布功能，并且准备好隔离 Profile、测试工作区和回退路径时，再评估 alpha 版本。 ## 原始来源 - https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.5-rc.1 - https://github.com/deepseek-ai/deepseek-harness/blob/183f08e9c6dde7e36cd2318eaee70b0da08fb35e/README.zh.md - https://github.com/deepseek-ai/deepseek-harness/blob/183f08e9c6dde7e36cd2318eaee70b0da08fb35e/package.json - https://github.com/deepseek-ai/deepseek-harness/blob/183f08e9c6dde7e36cd2318eaee70b0da08fb35e/apps/cli/reference/README.zh.md - https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.3-alpha.1 - https://github.com/deepseek-ai/deepseek-harness/blob/183f08e9c6dde7e36cd2318eaee70b0da08fb35e/package.json - https://github.com/deepseek-ai/deepseek-harness - https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.1-rc.2 - https://github.com/deepseek-ai/deepseek-harness/blob/183f08e9c6dde7e36cd2318eaee70b0da08fb35e/README.zh.md - https://github.com/deepseek-ai/deepseek-harness/blob/183f08e9c6dde7e36cd2318eaee70b0da08fb35e/docs/architecture.zh.md - https://github.com/deepseek-ai/deepseek-harness/blob/183f08e9c6dde7e36cd2318eaee70b0da08fb35e/apps/cli/reference/README.zh.md - https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.2-alpha.1 - https://github.com/deepseek-ai/deepseek-harness/compare/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e...cd5ef8148158c3a752a658978873241fdf8e2bbc - https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.2-alpha.3 - https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.2-alpha.5 - https://github.com/deepseek-ai/deepseek-harness/commit/dd6322d604e00eec1ba5e0c8541159906a21094a - https://www.npmjs.com/package/@deepseek-ai/dsh