DeepSeek Harness 安装:三种方式怎么选
核验于 2026-10-31dsh 0.2.1-rc.5版本说明
先做一个判断
dsh(DeepSeek Harness)由 DeepSeek 开源,是把 AI 模型、工具、插件和本机工作目录接在一起运行的程序。装 dsh 就是把这套程序放到自己的机器上跑起来。第一步只是选一种安装方式:三种安装方式不是新旧关系,而是三种使用场景。
如果你是第一次用 dsh,选桌面版:桌面版把 Node、Web UI 和服务进程打包在一起,省掉自己安装 Node、自己启动服务进程这两步。
三种方式对比
| 安装方式 | 适合谁 | 装之前要准备什么、之后怎么升级 |
|---|---|---|
| 桌面版 | 不写代码、不想管 Node | 要 API Key;升级时重新下载安装包 |
| npx | 有 Node 的开发者、服务器 | 要 Node、网络、API Key;升级时重跑 npx |
| 源码 | 插件开发者、贡献者 | 要 Node、pnpm、Git;升级时 git pull 后重新构建 |
三种方式的核验程度不一样:npx 的启动、401 鉴权(服务端拒绝没带 token 的请求)与端口占用已实测;桌面版只核验了下载地址与文件大小;源码安装按官方 README 核对,未实测。
共同前置:API Key 与网络
三件事在三种方式里都一样:
- 一个 DeepSeek API Key:API Key 是一串用来调用 DeepSeek 模型的访问口令,在 DeepSeek 开放平台 创建。Key 保存在本机的配置文件里,不要提交到 Git 仓库。
- 能访问安装源:安装源就是安装包和依赖所在的网站。桌面版访问
download.deepseek.com,npx 与源码访问 npm registry 或 GitHub。 - 一个工作目录:dsh 把工作目录当作默认的读写位置。第一次启动之后,你还要在界面里选一次工作区。
安装成功的三个标志
你要按顺序做完下面三步,不要跳过其中任何一步:
- 页面能打开。 桌面版启动时会自动打开浏览器;npx 要用启动日志里带
token的完整地址访问。 - 设置 → 模型里能看到 DeepSeek 卡片。 在卡片里填入 API Key 并保存。
- 选工作区,新建会话,发一句话。 没有选工作区时,界面上的输入框不可用。
浏览器显示 401 不等于安装失败。
dsh web默认对不带 token 的裸地址http://127.0.0.1:3080/返回 401,必须使用启动时打印的?token=...地址。原因见 npx 安装。