Win10 下安装使用 DeepSeek Harness

• 由于本人水平有限，难免出现错漏，敬请批评改正。
• 更多精彩内容，可点击进入我的个人主页查看。

引言

DeepSeek Harness（简称 dsh）是 DeepSeek AI 开发的一款开源 Agent 工具，采用“万物皆插件”（Everything is a Plugin）的架构设计，基于 Cordis 框架构建。目前该项目仍处于开发者预览版阶段，迭代速度较快，可能存在兼容性破坏的变更。

本文将详细介绍在 Windows 10 系统上通过 npm 命令行安装和使用 DeepSeek Harness 的完整流程，并涵盖常见问题的处理方法。

准备工作：安装 Node.js

DeepSeek Harness 基于 Node.js 运行，因此需要先配置好 Node.js 环境。

下载 Node.js

访问 Node.js 官网，下载 Windows 安装包（推荐选择 LTS 版本）。

安装 Node.js

双击运行下载的安装程序，一路点击“Next”即可完成安装。安装程序会自动将 Node.js 和 npm（Node 包管理器）添加到系统环境变量中。

验证安装

打开命令提示符（CMD）或 PowerShell，输入以下命令验证环境是否配置成功：

node --version
npm --version

如果都能成功输出版本号，说明环境准备就绪。

4. （可选）配置国内镜像源

如果下载 npm 包速度较慢，可以配置国内镜像源加速：

npm config set registry https://registry.npmmirror.com/

安装方式：通过 npm 命令行安装

命令行方式适合大多数用户，以下提供三种途径，可根据需求选择。

快速启动（推荐）

无需安装，一条命令即可启动 Web 界面，适合临时使用或快速体验：

npx @deepseek-ai/dsh web

首次运行会自动下载所需包，启动后终端会显示访问地址，默认为 http://127.0.0.1:3080。

全局安装

适合频繁使用，安装后可以通过 dsh 命令快速启动：

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

从源码运行

适合需要查看或修改源码的开发者：

# 1. 克隆仓库
git clone https://github.com/deepseek-ai/deepseek-harness.git

# 2. 进入目录
cd deepseek-harness

# 3. 安装 pnpm（如果尚未安装）
npm install -g pnpm

# 4. 安装依赖
pnpm install

# 5. 构建项目
pnpm run build

# 6. 启动 Web 界面
pnpm dsh web

验证安装与使用

启动成功后，在浏览器中打开 http://127.0.0.1:3080 即可访问 DeepSeek Harness 的 Web 界面。

插件安装示例

DeepSeek Harness 的核心特色是插件化架构。安装插件可以使用以下命令：

npx @deepseek-ai/dsh plugin --profile web add <插件路径或GitHub地址>

插件开发者可以为自己的仓库添加 dsh-plugin 标签以便于被社区发现。

常见问题处理

npm 废弃包警告

在安装过程中，可能会看到类似以下警告：

npm warn deprecated node-domexception@1.0.0: Use your platform's native DOMException instead

原因：node-domexception 是一个早期的第三方补丁包，用于在旧版 Node.js 中提供 DOMException 标准错误类型。从 Node.js 17 版本开始，DOMException 已成为 Node.js 的原生内置对象，不再需要此补丁包。

处理方式：此警告完全不影响 DeepSeek Harness 的正常使用，无需任何操作。只要 Node.js 版本是 18 或更高，程序会自动使用系统原生的 DOMException。

程序文件存储位置

通过 npx @deepseek-ai/dsh web 命令运行的程序文件，会被下载并存储在 npm 的缓存目录中：

%LocalAppData%\npm-cache\_npx

可以把这个路径复制到文件资源管理器的地址栏直接访问。_npx 文件夹里通常有许多以哈希值命名的子文件夹，@deepseek-ai/dsh 的源文件就在其中的某一个里。

如需查看 npm 缓存根目录的精确路径，可运行：

npm config get cache

注意：npx 的设计理念是“用完即走”，因此它不会像传统软件那样将文件永久安装在系统里。但用户使用过程中产生的配置、会话等数据，通常会存储在用户目录下（如 ~/.deep-seek-harness-mcp 或类似文件夹）。

启动后无法访问

如果启动后浏览器无法打开 http://127.0.0.1:3080，请检查：

1. 终端是否显示 [INFO] Server is running on http://127.0.0.1:3080 的提示
2. 端口 3080 是否被其他程序占用（可尝试更换端口）
3. 防火墙是否阻止了 Node.js 的网络访问

网络下载慢

如遇 npm 包下载缓慢，可参考上文配置国内镜像源。

结语

DeepSeek Harness 作为 DeepSeek AI 推出的开源 Agent 工具，其“万物皆插件”的架构设计为开发者提供了极大的灵活性和扩展性。目前虽然仍处于开发者预览版阶段，但已经可以通过 npm 命令轻松上手体验。

对于普通用户，推荐使用 npx 快速启动命令，无需安装即可体验；对于开发者，建议全局安装或从源码运行，便于后续的插件开发和定制。希望本文能帮助你在 Windows 10 上顺利完成 DeepSeek Harness 的安装与使用。

参考

[1] https://github.com/deepseek-ai/deepseek-harness.git
[2] https://www.deepseek.com
[3] https://platform.deepseek.com
[4] https://nodejs.org/zh-cn/download