DeepSeek Harness介绍和安装教程 | 水鱼之家-博客 WATERFISH-BLOG

什么是DeepSeek Harness

DeepSeek Harness（简称dsh）是 DeepSeek AI 于2026年8月开源的 AI Agent 运行框架。它遵循 “一切皆插件” 的设计理念，将模型、工具、会话管理、沙箱等所有能力都以插件形式组合，可以自由替换和扩展它给大模型装上了“手”和“脚”，让AI不仅能对话，还能真正操作你的电脑，比如读写文件、执行命令、运行测试，直至完成一整套复杂任务

DeepSeek不再仅仅满足于提供可调用的模型API，而是开始构建一个能吸引开发者的平台和生态。这是一个更具战略价值的上层入口，让DeepSeek的模型能直接接入文件系统、终端等，执行连续的编程任务，使其从一个“思考者”进化为能“动手”的Agent

如何安装DSH

环境准备

操作系统：Windows 10+、macOS 10.15+ 或主流 Linux 发行版（x64/arm64）

Node.js：必须安装 v22.19 或更高版本。前往 nodejs.org 下载

包管理器(可选)：如果选择从源码安装，需要pnpm，可以通过 npm install -g pnpm 命令安装。

Python(可选)：如果使用Python SDK，需要Python 3.10+ python.org

Git(可选)：如果选择从源码安装或使用Python SDK，需要安装Git git-scm.com

API Key：一个大模型的API密钥

安装与启动

DeepSeek Harness 提供了多种安装方式，根据实际需求选择

方式一：快速体验

确保已安装 Node.js (v22+)

打开终端，运行以下命令下载：

如果网络不通，可以使用镜像源

可能会显示

输入”y”，回车继续

等待命令执行完毕，在浏览器中打开 http://localhost:3080 访问。

注意：关闭终端后，服务也会停止。如果需要固定版本或离线使用，可以全局安装：npm install -g @deepseek-ai/dsh，若权限不足，请使用 sudo（Linux/macOS）或以管理员身份运行终端（Windows），然后直接运行 dsh web。

方式二：从源码安装

需要修改配置、进行二次开发或阅读源码

克隆仓库：

构建启动：

方式三：安装Python SDK

可以在Python代码中调用DSH的能力

创建并激活虚拟环境（推荐）： Linux/macOS

Windows

安装SDK：

注意：通过Python SDK安装的运行时不需要系统单独安装Node.js

桌面版应用安装（社区）

将 DeepSeek Harness 打包成独立的桌面程序，无需手动配置 Node.js 环境。

注意：社区版本不是官方的安装方式

社区 xiincs 维护的 DeepSeek Harness Desktop：GitHub 链接

初步设置DSH

安装完后访问http://localhost:3080

会提示添加密钥，如果想添加其他提供商的密钥可以先跳过

添加其他提供商的API密钥可以前往“设置-模型-添加提供商/添加自定义提供商”

到这里，你成功安装了DSH，下面开始使用吧！