1.DeepSeek Harness 概述
DeepSeek Harness（简称 DSH）是DeepSeek于2026 年8月推出的开源 AI 智能体（Agent）运行时框架 ，当前处于开发者预览阶段。官方给出核心定义公式：Agent = Model + Harness------ 模型是智能体的 "大脑"，负责思考与决策；Harness 则是智能体的 "执行底座"，负责连接真实环境、调度工具、管理会话与驱动任务循环，让大模型从纯对话机器人升级为可自主完成复杂任务的执行体。
2.核心设计理念
1. 一切皆插件（Everything is a plugin）
这是 Harness 最核心的架构原则。从模型适配、工具能力、会话管理、任务执行循环到前端交互界面，所有功能都以插件形式存在，不存在不可替换的特权核心。开发者仅通过配置即可选择、替换或扩展任意能力，无需修改框架底层源码。
2. 每次运行全可追溯（Every run is traceable）
所有模型请求、工具调用、执行结果与中间状态都会完整写入会话日志，支持任务轨迹查看、断点续做、任务分叉、历史搜索与过程回放，便于调试、审计与问题定位。
框架所有能力均以插件形式提供，主要插件类别包括：
- 模型适配器：内置 DeepSeek V4-Pro / V4-Flash 原生适配，支持扩展兼容 OpenAI 接口协议的其他模型
- 工具插件：文件读写编辑、Shell 命令执行、网页搜索、本地文件检索等
- 能力插件：Skills 技能包、任务计划管理、子 Agent 调度、工作流编排
- 基础设施插件：会话存储、沙箱环境、任务调度、权限控制
- 界面插件：Web 图形界面、终端 TUI、Headless 无头运行模式
3.下载安装教程
项目源码基于 MIT 协议开源，核心仓库为：
https://www.deepseek.com/harness/
win+R cmd窗口 输入：
npx @deepseek-ai/dsh web在执行这行命令之前，首先要确保你的电脑已经安装了 Node.js 环境，没有的话去 Node 官网 下载安装包，傻瓜式安装就行。
Node官网：
https://nodejs.org/zh-cn
1.Node.js 环境验证
验证 Node.js 环境最直接的方式是通过命令行查看版本号，操作全平台通用，步骤如下：
第一步：打开命令行终端
- Windows ：按下
Win + R，输入cmd后回车；或右键开始菜单选择「终端」「PowerShell」。 - macOS ：按下
Command + 空格，搜索「终端」并打开。 - Linux ：通常按
Ctrl + Alt + T快速调出终端。
第二步：执行验证命令
在终端中分别输入以下两条命令，每条输完按回车：
bash
node -vbash
npm -v第三步：判断结果
-
环境正常 会输出版本号，例如：
plaintext
v22.11.0 10.9.0只要
node -v能正常输出版本号，就说明 Node.js 已安装且环境变量生效；npm是 Node.js 自带的包管理器，通常会随 Node 一起安装。
-
环境异常 / 未安装 提示类似：
- Windows：
'node' 不是内部或外部命令，也不是可运行的程序 - macOS/Linux：
command not found: node说明系统未安装 Node.js，或安装后未配置环境变量、终端未重启。
- Windows：
稍等一会儿，你会看到终端输出了一个网址，打开它就能进入到 DeepSeek Harness 的 Web 界面
配置密钥就可以使用。
