DeepSeek Harness 安装:三种方式怎么选

核验于 2026-10-31dsh 0.2.1-rc.5版本说明

先做一个判断

dsh(DeepSeek Harness)由 DeepSeek 开源,是把 AI 模型、工具、插件和本机工作目录接在一起运行的程序。装 dsh 就是把这套程序放到自己的机器上跑起来。第一步只是选一种安装方式:三种安装方式不是新旧关系,而是三种使用场景。

  • 不想碰命令行,只想有个能用的界面 → 桌面版
  • 在服务器、SSH 或脚本里跑,或者只想临时试 → npx
  • 要改源码、开发插件、跟最新提交 → 源码

如果你是第一次用 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 与网络

三件事在三种方式里都一样:

  1. 一个 DeepSeek API Key:API Key 是一串用来调用 DeepSeek 模型的访问口令,在 DeepSeek 开放平台 创建。Key 保存在本机的配置文件里,不要提交到 Git 仓库。
  2. 能访问安装源:安装源就是安装包和依赖所在的网站。桌面版访问 download.deepseek.com,npx 与源码访问 npm registry 或 GitHub。
  3. 一个工作目录:dsh 把工作目录当作默认的读写位置。第一次启动之后,你还要在界面里选一次工作区。

安装成功的三个标志

你要按顺序做完下面三步,不要跳过其中任何一步:

  1. 页面能打开。 桌面版启动时会自动打开浏览器;npx 要用启动日志里带 token 的完整地址访问。
  2. 设置 → 模型里能看到 DeepSeek 卡片。 在卡片里填入 API Key 并保存。
  3. 选工作区,新建会话,发一句话。 没有选工作区时,界面上的输入框不可用。

浏览器显示 401 不等于安装失败。 dsh web 默认对不带 token 的裸地址 http://127.0.0.1:3080/ 返回 401,必须使用启动时打印的 ?token=... 地址。原因见 npx 安装。

下一步