DeepSeek Harness 安装与 Web UI 启动指南

最短安装方式

DeepSeek Harness 官方当前推荐通过 npx 启动 Web UI，不要求先全局安装 DSH：

npx @deepseek-ai/dsh web

启动成功后访问 http://127.0.0.1:3080。本文适用于官方源码版本 0.1.0-rc.5；DSH 是 Developer Preview，若未来版本改变命令，应以官方 README 为准。

检查 Node.js 版本

根包声明的 Node.js 范围不是笼统的“Node 22+”，而是 ^22.19.0 || >=24.0.0。执行：

node --version
npx --version

符合条件的例子包括 Node 22.19.0 及之后的 22.x，以及 Node 24 或更高版本。Node 23 不在官方声明范围内。版本不符合时先切换 Node，再处理 DSH 错误，否则容易把运行时问题误判成项目故障。

选择启动目录

在准备作为默认 workspace 根目录的项目目录中运行启动命令：

cd /path/to/your-project
npx @deepseek-ai/dsh web

Windows PowerShell、macOS 和 Linux 的核心命令一致，路径写法按各自终端调整。启动目录提供默认工作区位置，但新的 Web UI 仍要求你在界面中添加并选中 workspace；没有选中时输入区可能不可用。

验证 Web UI

浏览器打开 http://127.0.0.1:3080，然后依次验证：页面能加载；Settings → Models 可用；能添加并选择测试 workspace；输入区变为可用；配置模型后能完成只读任务。

输入框不可用时看工作区未选择修复；地址打不开且终端提示端口冲突时看3080 端口占用修复。

修改端口

默认 3080 已被占用时，可以指定另一个本地端口：

npx @deepseek-ai/dsh web --port 8080

然后访问 http://127.0.0.1:8080。官方 CLI 当前有意拒绝 --host 0.0.0.0，因此不能把普通 Web 框架的监听参数直接套用到 DSH。--trusted-host 增加的是浏览器 API 接受的具名 authority，并不等价于开放监听地址。

从源码运行

需要参与开发或审计源码时，官方步骤是：

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

源码运行需要 pnpm；普通 npx 快速启动与插件管理不是同一个流程。CLI 的插件管理命令会把参数转发给 pnpm，因此准备安装第三方插件时也必须保证 pnpm 在 PATH 中。

安装完成后做什么

继续按DeepSeek Harness 中文入门配置模型和第一次任务。API Key、Provider 或模型 ID 有问题时，进入模型与 Provider 配置指南。

不要把“Web UI 打开”当作完整验收。真正的完成条件是：版本符合、模型路由有效、工作区明确、任务结果可验证，并且没有把凭据或敏感目录暴露给不必要的工具。