安装与启动

零基础友好：什么是 npx、Windows / macOS / Linux 安装 Node.js，以及启动 DeepSeek Harness 的完整步骤

这一页假设你从零开始。如果你已经熟悉 Node.js，可以直接跳到启动 Web UI。

安装前：两个概念

Node.js 是一个在本机运行 JavaScript 程序的运行时。DeepSeek Harness 就是一个 Node.js 程序，所以电脑上必须先装好它。它和 Chrome 等浏览器一样由你主动安装，是一个普通的桌面软件/系统包。

npx 是 Node.js 自带的命令，作用是**「临时下载并运行一个 npm 包，用完不残留安装」**：

npm 是 Node.js 的包管理器（相当于「应用商店」）；
npx @deepseek-ai/dsh web 的意思是：去 npm 仓库取来 @deepseek-ai/dsh 这个包，并运行它的 web 入口；
你不需要先用 npm install 手动安装 dsh——npx 会替你处理下载与缓存；
首次运行时它还会初始化 web profile 并下载一批依赖，所以第一次启动明显较慢（需要网络）；之后 npx 复用缓存，启动会快很多。

命令找不到？

如果终端提示 npx 不是内部或外部命令（Windows）或 command not found（macOS/Linux），说明 Node.js 还没装好，或安装后没有重开终端。先完成下面的安装步骤。

要求版本 ^22.19 或 >=24。按你的系统选择：

方式 A（推荐）：官网安装包

方式 B：winget

winget install OpenJS.NodeJS.LTS

验证安装：重开终端后运行

node --version

输出形如 v24.x.x 或 v22.19.x 及以上即为成功。

npx @deepseek-ai/dsh web

默认地址为 **http://127.0.0.1:3080**。启动成功后，命令会打印可访问的地址；看到 web profile 初始化与依赖下载的日志是正常的首次现象。

保持这个终端窗口开着（关掉它就关掉了服务），然后用浏览器打开上面的地址。

不需要浏览器时，用 headless 模式跑一次性任务：

dsh --profile headless "总结这个仓库并指出主要模块"

headless 模式需要先配置模型 API 密钥（环境变量 DEEPSEEK_API_KEY，可选 DEEPSEEK_BASE_URL）。

适合想跟随最新开发或参与贡献的用户：

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

dsh 启动器只解析自己的参数，其余参数会传给被启动的应用：

命令	作用
`dsh --profile <name>`	启动 `$DSH_HOME/profiles/<name>` 下的 profile
`dsh --profile headless "job"`	运行一次全新的持久化会话，打印最终回答后退出
`dsh web`	`--profile web` 的别名
`dsh plugin --profile <name> <pnpm 参数>`	在 profile 目录中转发给 pnpm 管理插件
`dsh --dump-default-config` / `--dump-config`	不启动，打印默认/组合后的配置树

例如 dsh --profile web --port 8080 中的 --port 属于 web 应用；dsh --help 打印的是启动器自身的帮助。

核对安装来源

「deepseek-harness」一词在官方发布前已被第三方项目使用。请确认你安装/克隆的是官方组织 deepseek-ai 的仓库与 npm scope @deepseek-ai 的包，谨防同名项目混淆。供应链与许可证边界见安全与合规。