DeepSeek Harness 怎么安装?从 npx 一键运行到源码构建
安装与快速上手发布于 2026-08-14作者: DSH-Plugin 插件中心
DeepSeek HarnessDSH安装npx构建
DeepSeek Harness 的安装方式主要有两种:用 npx 一键运行 Web UI,或从源码克隆构建。本文给出两种方式的完整命令、前置要求(Node.js 18+)和启动后的访问地址。
DeepSeek Harness 最快捷的安装方式是 npx @deepseek-ai/dsh web 一键运行,启动后默认在 http://127.0.0.1:3080 打开 Web UI。
前置要求
运行 DeepSeek Harness 需要 Node.js 18 及以上版本。 如果打算走源码构建,建议同时安装 pnpm 作为包管理器。
方式一:npx 一键运行(最快)
一条命令就能把 DSH 跑起来,适合快速体验。
bash
npx @deepseek-ai/dsh web
执行后,Web UI 默认开在 http://127.0.0.1:3080,直接用浏览器访问即可(来源)。
方式二:源码构建(适合二次开发)
想调试或改代码,就从源码克隆构建。
bash
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
构建完成后同样通过 pnpm dsh web 启动 Web UI(来源)。
装插件
DSH 启动后,用 dsh plugin --profile web add 安装插件,框架会自动加载并注册插件能力。
bash
dsh plugin --profile web add <插件包名或地址>
具体每个插件的安装命令,到 dsh-plugin.org 插件中心 里查看对应插件详情页,复制它的安装命令即可。
注意事项
- 开发者预览阶段:DSH 迭代快,安装命令和插件接口可能变化,以官方文档为准。
- 版本兼容:插件通常标注了兼容的 DSH 版本(如 rc.6),安装前先确认版本匹配。
- 网络环境:源码构建需要能访问 GitHub 和 npm registry。
常见问题
DeepSeek Harness 安装需要什么前置环境?
需要 Node.js 18 及以上,建议同时装好 pnpm(源码构建时会用到)。
npx 一键运行和源码构建有什么区别?
npx 方式最快,适合快速体验;源码构建适合二次开发和调试,能拿到最新代码。
启动后 Web UI 在哪里访问?
默认在本地 http://127.0.0.1:3080 打开。
来源
- DeepSeek Harness 官方文档 - Quickstart· deepseek-harness
- deepseek-ai/deepseek-harness· GitHub