DeepSeek Harness 安装教程：npx 一行命令 + 源码构建
DeepSeek Harness（dsh）是 2026 年 8 月发布的 v0.1 开发者预览版。对一个刚开源的项目来说，它的安装出奇地简单：前置条件只有 Node.js，之后一行命令就能在本地启动 Web UI。本文整理两种安装方式和常见问题。
环境要求
- Node.js：官方开发文档要求 22.19 及以上的 22.x 版本，或 24 及以上版本（具体以官方 README 为准）；
- npm：随 Node.js 自带，用于 npx 方式；
- pnpm：源码构建方式需要，可用
npm install -g pnpm安装； - 网络：需要能访问 npm 仓库（国内网络不稳定时可切换镜像源）。
DeepSeek Harness 当前处于开发者预览阶段，官方明确提示迭代很快、会存在破坏性兼容变更。尝鲜、学习、二次开发没问题，生产环境请谨慎并锁定版本。
方法一：npx 一行命令（尝鲜首选）
安装好 Node.js 后，在终端执行：
npx @deepseek-ai/dsh web首次运行 npx 会自动下载 @deepseek-ai/dsh 包。命令启动 Web UI 后，用浏览器打开默认地址：
http://127.0.0.1:3080看到黑色鲸鱼主题的界面即代表启动成功。
方法二：从源码构建（想改插件 / 读源码）
需要 Node.js 与 pnpm。依次执行：
# 克隆官方仓库git clone https://github.com/deepseek-ai/deepseek-harness.git
# 进入目录cd deepseek-harness
# 安装依赖pnpm install
# 构建pnpm run build
# 启动 Web UIpnpm dsh web同样在浏览器打开 http://127.0.0.1:3080。
按模式启动（可选）
dsh 支持通过 profile 指定运行模式，不同模式默认加载不同的插件组合：
| 模式 | 适用场景 |
|---|---|
| 标准模式 | 日常 Agent 任务，工具集合较完整 |
| 极简模式 | 模型基准测试，只保留 Shell 与文件编辑 |
| PTC 模式 | 程序化工具调用，批量 / 顺序型任务 |
| 创造模式 | 在内存中试验插件、组合新运行模式 |
具体 profile 名称与命令行参数以官方 README 为准：deepseek-ai/deepseek-harness。
常见问题排查
npx 卡住 / 下载很慢
九成是网络问题。可以切换到国内 npm 镜像源后重试：
npm config set registry https://registry.npmmirror.com或者直接改用上面的源码构建方式。
报 Node 版本错误
先确认版本符合要求：node -v。建议使用 Node.js 22.19+（22.x）或 24+。
端口被占用
默认端口是 3080。若被其他程序占用，检查并释放端口，或按官方文档指定其他端口启动。
启动后需要配置模型吗
需要。Harness 本身按 MIT 协议免费开源，但作为 Agent 运行层，实际干活时仍要接入可用的模型服务（官方默认使用方式需按官方说明配置）。具体接入方式见官方文档。
本站为独立信息站点，与 DeepSeek 官方无隶属关系。安装细节请以官方 README 与文档的最新版本为准。