安装与启动

优先推荐免终端的 DSH Desktop；也提供 Windows / macOS / Linux 安装 Node.js 与启动官方 DeepSeek Harness 的完整步骤

这一页假设你从零开始。想免装 Node.js、免输终端命令时，先选择桌面版；需要自动化、headless 或跟随官方 CLI 时，再继续下方的官方路径。

优先推荐：DSH Desktop（免终端）

适用于 Windows、macOS 与 Linux 的社区原生桌面版；内置运行时并承载未修改的官方 DeepSeek Harness。

DSH Desktop 适合希望打开桌面应用就开始使用的人：它随应用提供 Node.js 运行时，因此不必先安装 Node.js、pnpm，也不必保持终端窗口运行。下载与你的系统匹配的安装包后，按应用内引导配置模型即可。

何时选择哪一种？

优先选 Desktop：想要图形化桌面体验、免终端，或希望由应用管理 Harness 进程。
继续官方 CLI / Web UI：需要脚本、CI、SSH/headless、实验最新上游版本，或想完全自行控制 Node.js 与 profile。

DSH Desktop 是独立社区项目，不是 DeepSeek 官方产品。安装前请阅读对应发布说明并核对校验值；它所承载的 Harness 版本及兼容性以桌面版发布说明为准。

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**。当前版本在本机启动 dsh web 时通常会自动打开默认浏览器；SSH 或编辑器转发场景只会打印主机地址。加上 --no-open 可禁止自动打开。看到 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 的包，谨防同名项目混淆。供应链与许可证边界见安全与合规。