# DeepSeek Harness 系统介绍

## 一、发布经过及时间线

DeepSeek Harness（简称 dsh）是深度求索（DeepSeek）公司推出并开源的一款智能体运行时框架，其核心设计理念为“一切皆插件”，基于 Cordis 插件系统构建，官方将其定义为 “Model + Harness = Agent”。

该项目于 2026 年 5 月立项，目标是开发 DeepSeek 自己的代码工具。从 6 月 10 日第一条提交到 8 月 13 日公开，64 天里完成了 12293 次提交，附带 683 篇设计笔记。

**关键发布时间线：**

| 时间 | 事件 |
|------|------|
| 2026 年 5 月 | 项目在 DeepSeek 内部立项 |
| 2026 年 6 月 10 日 | 首次代码提交 |
| 2026 年 8 月 13 日 | v0.1 开发者预览版正式开源，MIT 协议，GitHub 上线 |
| 2026 年 8 月 14 日 | Star 数突破 5 万 |
| 2026 年 8 月 18 日 | Star 数达 14.9 万，Fork 数达 1.5 万 |
| 2026 年 8 月 20 日 | 发布 v0.1.0-rc.8，新增多模态能力等 14 项更新 |
| 2026 年 8 月 27 日 | GitHub Star 数达 202,536 |
| 2026 年 9 月 10 日 | 发布 v0.1.5，与 DeepSeek V4.1 Flash 模型深度结合 |
| 2026 年 9 月 29 日 | v0.2 预览版发布，提供开箱即用的 macOS 和 Windows 桌面端安装包 |
| 2026 年 10 月 3 日 | 发布 v0.2.1-alpha.1，新增实验性 Claude Code Mods 兼容层 |

2026 年 8 月 15 日，国家超算互联网宣布上线 DeepSeek Harness；同日，腾讯 QQ 官方宣布 QQ Bot 机器人接入该框架。

## 二、GitHub Star 数

DeepSeek Harness 开源后获得了爆发式的社区关注：

- **发布半小时内**：GitHub 星数破万
- **发布 48 小时内**：突破 10 万
- **截至 2026 年 8 月 27 日**：Star 数达 202,536
- **2026 年 9 月 29 日快照**：约 238,831 Stars，Fork 数 28,691
- **截至 2026 年 10 月初**：Star 数突破 **24.3 万**

据 GitHub API 数据，约 243,800 的 Star 数使 Harness 成为 GitHub 上最受关注的 Agent 项目之一。DeepSeek 还报告约 60% 的 Harness 用户运行第三方插件，并计划推出官方插件市场。

## 三、部署环境要求

### 3.1 命令行 / Web UI 版

| 依赖项 | 要求 | 说明 |
|--------|------|------|
| **操作系统** | Windows 10+、macOS 10.15+ 或主流 Linux（x64/arm64） | 跨平台支持 |
| **Node.js** | `^22.19.0 \|\| >=24.0.0`（仓库 engines 硬要求） | 建议使用 v24 系列 |
| **pnpm** | 11.7.0（源码安装时需要） | 建议通过 Corepack 启用 |
| **Git** | 2.26+ | 用于安装仓库钩子 |
| **API Key** | DeepSeek 或其他兼容提供方的密钥 | 可选但强烈建议 |
| **硬件** | 普通笔记本即可运行 | 建议单独准备练习目录作为工作区 |

### 3.2 官方桌面版

桌面版将完整 Web 应用、Host 和运行时打包在客户端中，**普通用户不需要预装 Node.js 或 pnpm**。

| 平台 | 系统要求 | 安装包格式 |
|------|----------|------------|
| **macOS** | macOS 13+（Apple Silicon / arm64） | DMG（约 353 MB） |
| **Windows** | Windows 10+（x64） | EXE（约 276 MB） |

> **注意**：官方桌面版暂不支持 Intel 芯片的 Mac，Intel Mac 用户需使用命令行 Web UI 方式。

## 四、命令行安装及配置步骤

### 4.1 快速体验（推荐首次使用）

确保 Node.js 版本满足要求后，在终端执行一条命令即可启动：

```bash
npx @deepseek-ai/dsh web
```

首次运行会下载相关包，终端会输出本地地址，默认是 `http://127.0.0.1:3080`，浏览器打开即可开始配置。如只想启动服务、不自动打开浏览器（例如在远程机器上），可加 `--no-open`：

```bash
npx @deepseek-ai/dsh web --no-open
```

### 4.2 全局安装（长期使用推荐）

```bash
npm install -g @deepseek-ai/dsh
dsh web
```

全局安装后系统全局可用 `dsh` 命令，不需要每次通过 npx 拉取。

### 4.3 源码安装（需要二次开发或跟进 main 分支时）

```bash
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
```

安装流程简图如下：

```text
┌──────────────────────────────────────────────────────────┐
│          DeepSeek Harness 命令行安装流程                   │
├──────────────────────────────────────────────────────────┤
│                                                          │
│  ① 安装 Node.js (^22.19.0 || >=24.0.0)                  │
│       ↓                                                  │
│  ② 执行安装命令                                          │
│     npx @deepseek-ai/dsh web                            │
│       ↓                                                  │
│  ③ 终端输出地址 http://127.0.0.1:3080                   │
│       ↓                                                  │
│  ④ 浏览器打开 → Settings → Models 填入 API Key          │
│       ↓                                                  │
│  ⑤ 选择工作区目录 → 开始使用                            │
│                                                          │
└──────────────────────────────────────────────────────────┘
```

### 4.4 安装后配置

1. **配置模型**：打开 `Settings → Models`，填入 API Key 并保存
2. **选择工作区**：选择或添加一个工作区目录，Agent 将在授权范围内操作
3. **选择运行模式**：根据任务复杂度选择标准、PTC、极简或创造模式

### 4.5 四种预设运行模式

DeepSeek Harness 内置四种预设模式，适应不同场景：

| 模式 | 说明 | 适用场景 |
|------|------|----------|
| **标准模式** | 工具齐全，含文件操作、Shell、搜索、子任务委派 | 日常开发调试 |
| **PTC 模式** | 通过 TypeScript 编排任务，可控性强 | 复杂流水线自动化 |
| **极简模式** | 仅保留 Shell 和文件编辑 | 基准评测 |
| **创造模式** | 内存型插件实验环境 | 快速测试自研插件 |

## 五、桌面版安装及配置步骤

### 5.1 macOS 安装

**第一步**：确认 Mac 芯片和系统版本。点击屏幕左上角苹果菜单 → “关于本机”，芯片应显示 Apple M 系列，系统版本需达到 macOS 13 或以上。

**第二步**：从 DeepSeek 官方下载页（https://www.deepseek.com/harness/）下载 `dsh-latest-macos-arm64.dmg`。双击 DMG 文件，按提示将 DeepSeek Harness 拖入“应用程序”目录。

**第三步**：从“应用程序”目录打开 DeepSeek Harness。首次启动时 macOS 可能请求文件夹等系统权限，按需授权即可。

**第四步**（可选）：打开应用菜单中的“管理 dsh 命令…”，安装命令行入口。macOS 默认在 `/usr/local/bin/dsh` 创建链接。

### 5.2 Windows 安装

**第一步**：确认系统为 Windows 10 或更高版本，64 位安装包可在“设置 → 系统 → 系统信息”中查看系统类型。

**第二步**：从官方下载页选择 Windows 版本，下载 `dsh-latest-windows-x64.exe`。运行安装程序，按界面提示完成安装。

**第三步**：双击桌面图标启动。Launcher 会启动 Harness 并在服务准备好后自动打开本地界面。

**第四步**：首次进入后创建默认工作区，也可选择已有项目目录。桌面端默认端口为 19387，自带 Python 与 Node 运行时。

### 5.3 桌面版首次使用向导

登录DeepSeek Harness时现阶段还有6元赠金，见下图：
![image.png](https://developer.qcloudimg.com/http-save/yehe-12805308/b5bf67d3b305179955c388d5183f2e81.png)

*图：桌面版首次启动时的场景选择界面（来源：IT之家）*

向导提供以下选择：**办公与创作**（编辑文档、整理数据、制作演示文稿）或**代码与开发**（修改代码、调试问题、运行命令、管理项目文件）。

### 5.4 桌面版核心特性

- **零依赖**：内置 Node.js 运行时和 npm CLI，目标机器无需安装任何环境
- **一键启动**：双击即启 `dsh web`，优先复用上次端口
- **双形态**：便携版（免安装、可放 U 盘）+ 安装版（桌面/开始菜单快捷方式）
- **深色玻璃无边框窗口**：自绘标题栏、Win11 圆角，关闭默认隐藏到系统托盘
- **崩溃自愈**：坏插件自动修复、坏配置自动重建、内核崩溃原地重启

## 六、架构与插件生态

DeepSeek Harness 的核心设计是“一切皆插件”，整个框架由约 220 个小型 npm 包拼装而成，所有组件地位平等，不存在不可替换的特权核心。模型适配器、工具注册表、技能集、会话管理器、执行沙箱、持久化存储、Agent 思考循环、任务调度器、前端 UI 界面全部封装为独立插件。

**五层架构概览：**

```text
┌──────────────────────────────────────────────────────┐
│  第 1 层：启动组装 — Profile / Bundle / Patch 决定插件组合 │
├──────────────────────────────────────────────────────┤
│  第 2 层：接入方式 — 浏览器 / SDK / CLI / ACP / Webhook  │
├──────────────────────────────────────────────────────┤
│  第 3 层：核心运行时 — 模型、工具、策略推进任务循环       │
├──────────────────────────────────────────────────────┤
│  第 4 层：可替换能力 — 读什么、执行什么、委派什么         │
├──────────────────────────────────────────────────────┤
│  第 5 层：数据与支撑 — 会话恢复、回放、查询、审计         │
└──────────────────────────────────────────────────────┘
```

截至 2026 年 8 月，在 GitHub 上以“dsh-plugin”为标签的公开仓库已超过 700 个，社区开发了超过 5100 个插件。

**插件市场界面：**

![dsh-market 插件市场界面](https://developer.qcloudimg.com/http-save/yehe-12805308/360762d1871d42f530985b3517343b4c.png)

*图：插件市场界面——设置页内支持搜索、分类筛选、一键安装（来源：dsh-market 项目）*

插件市场推荐安装 `dsh-market`，安装命令为：

```bash
dsh plugin --profile web add dshmarket
```

安装后在 `Settings → Plugin Market` 中可浏览、搜索、一键安装社区插件。

---

**参考来源汇总**：以上信息综合自百度百科 DeepSeek Harness 词条、腾讯云开发者社区部署教程、阿里云开发者社区安装指南、IT 之家桌面版报道等公开资料。由于项目仍处于开发者预览阶段，官方明确提示会有破坏性变更，建议以 GitHub 官方仓库最新文档为准。
> 如需查看更多界面截图，可访问 DeepSeek Harness 官网（https://www.deepseek.com/harness/）或 GitHub 仓库的 README 页面。

DeepSeek Harness（简称 dsh）是深度求索（DeepSeek）公司推出并开源的一款智能体运行时框架，其核心设计理念为“一切皆插件”，基于 Cordis 插件系统构建，官方将其定义为 “Model + Harness = Agent”。

DeepSeek Harness学习笔记1

人工智能

开发工具

后端

DeepSeekHarness是深度求索开源的智能体运行时框架，以“一切皆插件”为核心理念，基于Cordis构建，官方定位为“Model+Harness=Agent”。该项目自2026年6月立项至8月开源，GitHub Star数迅速突破24万，成为最受关注的Agent项目。支持命令行与桌面端部署，内置四种运行模式，拥有超5100个社区插件，提供跨平台、零依赖的安装体验，适合开发与办公自动化场景。

代码解释

TypeScript 

智能体

DeepSeek

Windows

Cordis

Python

GitHub

MacOS

Agent

Linux

pnpm

快速部署LLM、AI绘画等应用,助你玩转AIGC！


2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

DeepSeekHarness是深度求索开源的智能体运行时框架，以“一切皆插件”为核心理念，基于Cordis构建，官方定位为“Model+Harness=Agent”。该项目自2026年6月立项至8月开源，GitHub Star数迅速突破24万，成为最受关注的Agent项目。支持命令行与桌面端部署，内置四种运行模式，拥...

DeepSeek Harness学习笔记1-腾讯云开发者社区-腾讯云

DeepSeek Harness学习笔记1

DeepSeek Harness学习笔记1

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐