让 dsh 用上 WSL:两条路线,逐帧实录 + 插件直连

路线 A 跟着一段 Kali WSL 直播实录走完全程——apt 换源、nvm 装 Node、npm 换镜像、首启排错;路线 B 是 dsh-wsl-workspace 插件(★69):一条命令,WSL 里什么都不装。

最近更新: 2026-10-06

Windows Terminal 里的 Kali 终端在备份 sources.list 后对 kali-rolling 执行 apt update,正在下载 InRelease 元数据和 21.6 MB 的 Packages,为 DeepSeek Harness 的 WSL 安装做准备
实录里的第一段终端操作:备份源、换镜像、apt update。

「Windows 上的 dsh 怎么用上 Linux 工具」有两个诚实的答案。路线 A 在 WSL 发行版里装一个 DeepSeek Harness(dsh)——本页跟着一段直播实录逐帧走完:改 apt 源、用 nvm 装 Node 24、把 npm 换成镜像源、熬过第一次慢启动,最后停在跑起来的 Web UI。路线 B 在 WSL 里什么都不装:dsh-wsl-workspace 插件让你已有的 Windows dsh 直接在 GUI 里添加 WSL 工作区。

下面十帧画面全部来自同一段屏幕实录,每张截图都能深链回原视频的精确秒数。如果你用的根本不是 Windows,dsh 在 Linux 上也能原生安装——无需 WSL 的同一套流程,逐步说明在 DeepSeek Harness Linux 安装教程

TL;DR

  • ▸先选路线:Windows 已装 dsh → 路线 B,装 dsh-wsl-workspace 插件(一条命令,侧栏出现 W 按钮直接加 WSL 工作区);全新环境或想要 Linux 原生的 dsh → 路线 A,照下面实录走。
  • ▸路线 A 的名字陷阱:Kali 仓库里 apt install dsh 装到的是 dancer's shell,完全是另一个程序。DeepSeek Harness 走 npm,包名 @deepseek-ai/dsh,底层是 nvm 装的 Node.js 24。
  • ▸实录里共换了三处镜像:apt 的 sources.list、下载 Node 用的 NVM_NODEJS_ORG_MIRROR、装包用的 npm config set registry——全部指向 npmmirror 或清华镜像。
  • ▸第一次 npx -y @deepseek-ai/dsh web 要下载几十 MB,转圈 1–5 分钟都正常;第一项排查是 npm config get registry 看镜像源生效没有。

路线 A:在 WSL 里装 dsh,逐步实录

路线 A · 准备:计划、apt 换源与 dsh 名字陷阱

  1. 1

    先有一份写出来的计划,再开终端

    实录开场是 chat.deepseek.com 里一个名为「WSL安装dsh指南」的会话,任何终端操作之前先写好了全程规划:因为 dsh 通过 npm 安装,WSL 发行版得先备好编译工具链和 Node.js——sudo apt update、装 build-essential 和 python3,再用 nvm 装 Node 24,用 node -v 和 npm -v 验证。无论你用 AI 重新生成这样一份计划还是自己写,把它摆在眼前,后面每一步都有对照清单。

    $sudo apt update
    $sudo apt install -y build-essential python3
    DeepSeek 会话「WSL安装dsh指南」列出 apt update 加 build-essential、python3 的前置依赖,以及用 nvm v0.39.7 安装 Node 24 供 dsh 使用的完整命令
    一条命令都没跑之前,全程路线已经写在屏幕上——前置依赖在前,nvm 装 Node 24。看实录 1:00
  2. 2

    备份 apt 源、换镜像、apt update

    第一段终端实操发生在 Windows Terminal 里的 Kali(kali-rolling):先把 /etc/apt/sources.list 备份成 sources.list.bak,再替换镜像行——指南会话直接给出一条覆写成清华源的命令,连编辑器都不用——然后跑 apt update。帧里能看到真实输出:kali-rolling InRelease 和 21.6 MB 的 Packages 正在下载。同一段实录还有个小提醒:这个精简版 Kali 镜像连 nano 都没有,第一次 sudo nano 直接「command not found」,补了个 apt install -y nano 才完事。

    $sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak
    $sudo nano /etc/apt/sources.list
    $apt update
    $apt install -y nano
    root 身份的 Kali shell 用 sudo cp 把 /etc/apt/sources.list 备份成 sources.list.bak,为 dsh 的 WSL 安装修改 apt 镜像做准备
    先备份再改——nano 不在的话,apt install -y nano 补上。看实录 5:10
  3. 3

    名字陷阱:Kali 仓库的 dsh 是 dancer's shell

    实录进行到一半,指南会话给出了全文最有价值的一条警告:在 Kali 上跑 apt install -y dsh,装到的是 dancer's shell——一个分布式 shell 工具,画面上的选项表里列着 -m 这类参数和 /etc/dsh/machines.list 文件。它只是碰巧同名,和 DeepSeek Harness 完全是两个东西。这一步无论做什么,发行版仓库里都没有 DeepSeek Harness;这一帧的内容里,只有 apt update 属于你的 dsh 准备工作。

    $apt update
    DeepSeek 指南页解释 Kali 的 apt dsh 包其实是 dancer's shell,附带 -m 到 -M 的选项表,以及换源之后继续执行的 apt update
    全实录最有价值的一条警告:那个 apt 里的 dsh 是另一个程序。看实录 7:00
  4. 4

    卸掉装错的 dsh,改走 npm 路线

    指南的补充说明把修复讲得很直白:用 apt remove -y dsh 卸掉误装的包,然后按 Node.js + npm 的流程去装 @deepseek-ai/dsh。同一段话还点明了你最终要跑的启动命令——dsh web,DeepSeek Harness 的 Web 服务——把它和那个冒牌货彻底区分开。从这一帧起,实录里的每条命令都指向 npm 包。

    $apt remove -y dsh
    dancer's shell 选项表下方的指南文字,建议用 apt remove -y dsh 卸载,并改走 Node.js 加 npm 安装 DeepSeek Harness 的 @deepseek-ai/dsh 包
    一次卸载之后,计划正式转向 npm 路线——并点明 dsh web 才是启动命令。看实录 8:40

路线 A · nvm 装 Node 24、npm 换镜像与启动命令

  1. 5

    装 nvm——顺便看一个镜像当场翻车

    curl 就位后,实录把 nvm v0.39.7 的安装脚本用管道喂给 bash。GitHub 这一路成功——「Downloading nvm as script to '/root/.nvm'」——但同一帧里紧接着的一次 gitee 镜像重试返回了「No such file or directory」:镜像可用性以小时为单位变化,备好退路不是可选项。source ~/.bashrc 把 nvm 载入当前 shell,nvm -v 应输出 0.39.7。

    $curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
    $source ~/.bashrc
    $nvm -v
    Kali 终端把 GitHub 上的 nvm v0.39.7 安装脚本用管道喂给 bash 安装 nvm,下方可见失败的 gitee 镜像重试和 source ~/.bashrc
    实录的真实感在这里:GitHub 通了,gitee 没通。看实录 10:20
  2. 6

    nvm install 24——换上 Node 镜像再装

    nvm install 24 先直连 nodejs.org,下载在 1–2% 爬行后被 Ctrl+C 掐断,nvm 留下一句「Version '24' does not exist」——别名还没有东西可指。接下来帧里给出修复:export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node,然后重新 install——画面甚至拍到 nvm 先清掉一个校验不符的本地缓存再从 npmmirror 干净重下。最后 nvm alias default 24,让新 shell 默认落在 Node 24 上。

    $nvm install 24
    $export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
    $nvm alias default 24
    nvm install 24 的输出在清掉校验不符的缓存后从 nodejs.org 切到 npmmirror.com/mirrors/node,正以 23% 的进度下载 node v24.21.0
    nodejs.org 慢,Ctrl+C,export 换 npmmirror 镜像——然后一泻千里。看实录 11:40
  3. 7

    验证 Node、换 npm 源、启动

    指南第五步和第六步收拢全线:node -v 现在应显示 v24.x.x(旁边 npm -v),用 npm config set registry https://registry.npmmirror.com 把包镜像指到 npmmirror,然后用 npx -y @deepseek-ai/dsh web 启动服务。指南还给了 Node 下载的清华镜像备选,并且说了句实话:两个镜像哪个快用哪个。

    $node -v
    $npm -v
    $npm config set registry https://registry.npmmirror.com
    $npx -y @deepseek-ai/dsh web
    指南第五、六步展示 WSL 装 dsh 的收尾:node -v 与 npm -v 验证、npm config set registry 指向 npmmirror,以及 npx -y @deepseek-ai/dsh web 启动命令
    验证、换 npm 源,启动就是一行 npx。看实录 13:00

首次启动、排错与跑起来的界面

  1. 8

    第一次启动:转圈几分钟是正常的

    npx 首次运行要把 @deepseek-ai/dsh 包和依赖全部下载——几十 MB 起步——所以实录里操作者问「是不是要等一会儿」时,指南的回答是肯定句,还给了量化的判断:一直转圈没有报错,1–5 分钟都正常;超过 5 分钟没动静,Ctrl+C 中断再排查。第一项检查:新开一个终端跑 npm config get registry,必须输出 npmmirror 地址,不是就重新设置。

    $npm config get registry
    $npm config set registry https://registry.npmmirror.com
    DeepSeek 指南回复首次 dsh web 启动卡住的问题:转圈一到五分钟都正常,并用 npm config get registry 作为第一项镜像检查
    等待本身就是一个步骤——有时间预算,也有第一项检查。看实录 13:35
  2. 9

    全局安装,然后 dsh web

    指南给了个比盯着 npx 转圈更稳的办法:npm install -g @deepseek-ai/dsh --registry=https://registry.npmmirror.com 让同一场下载显示真正的进度条,装完用裸命令 dsh web 启动服务。如果卡在某个依赖,指南的最后一招是加 --verbose 看详细日志。

    $npm install -g @deepseek-ai/dsh --registry=https://registry.npmmirror.com
    $dsh web
    指南排查块执行 npm install -g @deepseek-ai/dsh 并带 npmmirror registry 参数,随后是 dsh web 启动命令和针对依赖卡住的 --verbose 提示
    真进度条胜过转圈:先全局安装,再 dsh web。看实录 14:10
  3. 10

    Web UI 跑起来了——dsh 从此住在 WSL 里

    实录停在你想到达的地方:DeepSeek Harness 的 Web UI 在浏览器里渲染出来——侧栏是工作区,标准模式,选中的是 DeepSeek-V41-Flash。从这一刻起,会话在 WSL 发行版里以真实的 Linux 路径执行,完整的 Linux 工具链就在你熟悉的那个聊天框背后。

    WSL 安装完成后跑起来的 DeepSeek Harness Web UI:工作区侧栏、标准模式选择器和 DeepSeek-V41-Flash 模型出现在「探索未至之境」启动页上
    终点线:dsh 自己的 Web UI,从此住在 WSL 里。看实录 15:00

路线 B:dsh-wsl-workspace 插件——WSL 里不装 dsh

如果 Windows 上已经有能跑的 dsh,社区插件 dsh-wsl-workspace(★69,MIT,2026-10-06 实核)是更短的路:README 原话是「无缝的 WSL 工作区使用体验,无需在 WSL 之中再安装一个 dsh」。三条命令任选其一执行,然后重启 dsh web——你的 WSL 发行版里什么都不会被安装。

$dsh plugin --profile web add dsh-wsl-workspace
$dsh plugin --profile web add https://github.com/dsh-wsl-workspace-maintainers/dsh-wsl-workspace
$dsh plugin --profile web add D:\path\to\dsh-wsl-workspace

重启后侧栏底部 Settings 旁边会多一个 W 按钮,点开「Add WSL workspace」对话框:从已安装的发行版里选一个,浏览或输入一个绝对 Linux 路径(Check 按钮负责验证),可选填一个 Linux 用户名,然后 Create & open。新会话里 bash 工具在发行版内部执行,Windows 文件仍可通过 /mnt/<盘符> 访问——而且 WSL 本身就是隔离边界,因为 Windows ACL 沙箱包不住 wsl.exe。

那到底选哪条?已有一套能用的 Windows dsh、只缺 Linux 工具——选 B,一条命令对整条实录流水线。机器全新,或想让 dsh 本体活在 Linux 里、Windows 侧不留东西——选 A。还有第三种变体给 preset 用户:yukitakasama/dsh-wsl-preset(★2)装的是「wsl」agent preset,不是工作区提供器。

dsh 与 WSL:常见问题

Windows 遇上 Linux 时,人们真实会问的问题。

dsh 怎么装进 WSL?

按实录走:备好编译工具(sudo apt update,然后 sudo apt install -y build-essential python3),用 nvm 装 Node 24 并把 NVM_NODEJS_ORG_MIRROR 指到快的镜像,npm config set registry https://registry.npmmirror.com,然后 npx -y @deepseek-ai/dsh web 启动——或 npm install -g @deepseek-ai/dsh 全局安装后跑 dsh web。记住名字陷阱:在 Kali 上 apt install dsh 装到的是 dancer's shell,不是 DeepSeek Harness。

dsh 需要 WSL 吗?

不需要。Windows 上 dsh 原生就能跑——Node.js、npm、3080 端口的 Web UI,全程 PowerShell,我们的 Windows 安装指南讲的就是这条路。WSL 的价值只在你想要真正的 Linux 工具链——bash、apt、Linux 路径——挂在会话后面时才成立。而那个目标用插件路线 B 也能达成,不必在 WSL 里再装第二个 dsh。

WSL 里装哪个发行版?

实录用的是 Kali(kali-rolling),照样跑到了最终界面;它参照的指南文本以 Ubuntu 举例,两者都行——关键是基于 apt 的发行版,路线 A 再加一个 Node.js 24。到路线 B 这里问题更小:dsh-wsl-workspace 的对话框会列出你已装的发行版,选一个即可。官方没有推荐发行版;「实录用了 Kali」是如实陈述,不是推荐。

dsh-wsl-workspace 插件是干嘛的?

它给你已有的 Windows dsh 添加 WSL 工作区:会话的 bash 在发行版里执行、读写 Linux 路径,而 WSL 里不需要任何 dsh(仓库描述,2026-10-06 实核;★69,MIT)。安装并重启 dsh web 后,Settings 旁的 W 按钮打开 Add WSL workspace 对话框:选发行版、验证一个 Linux 路径、可选设置 Linux 用户名,然后 Create & open。同一个会话里 Windows 文件在 /mnt/<盘符> 下仍然可达。

Windows 和 WSL 之间怎么互访文件?

从 WSL 里看,Windows 盘挂在 /mnt/<盘符>——/mnt/c/Users/... 在两条路线下都好用,插件 README 对它的会话也是这么写的。从 Windows 看,发行版的文件通过 \wsl.localhost\<发行版> 网络共享访问。两个事实源共同的提醒:构建尽量待在目标文件系统里做,反复跨边界是慢路径。

为什么不直接 apt install dsh?

因为在 Kali 仓库里这个名字属于 dancer's shell——就是实录指南选项表里那个带 -m/-a 参数和 machines.list 的分布式 shell 工具。实录当场踩中,用 apt remove -y dsh 修复后才切到 npm 包 @deepseek-ai/dsh。同样携带 dancer's shell 包的发行版都有这个撞名问题,所以看到一个眼熟的名字,先查清楚这个包装的到底是什么。

相关指南

同一个 Windows–Linux 决定的另外几面。

来源与署名

十帧画面全部来自上面这段屏幕实录,已裁掉直播互动面板、浏览器边框和任务栏,主播左下角头像做了模糊处理。路线 B 的命令逐字引自 dsh-wsl-workspace 的 README,所有仓库事实于 2026-10-06 通过 GitHub API 实核。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。