让 dsh 用上 WSL:两条路线,逐帧实录 + 插件直连
路线 A 跟着一段 Kali WSL 直播实录走完全程——apt 换源、nvm 装 Node、npm 换镜像、首启排错;路线 B 是 dsh-wsl-workspace 插件(★69):一条命令,WSL 里什么都不装。
最近更新: 2026-10-06

「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
先有一份写出来的计划,再开终端
实录开场是 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
一条命令都没跑之前,全程路线已经写在屏幕上——前置依赖在前,nvm 装 Node 24。看实录 1:00 - 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
先备份再改——nano 不在的话,apt install -y nano 补上。看实录 5:10 - 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
全实录最有价值的一条警告:那个 apt 里的 dsh 是另一个程序。看实录 7:00 - 4
卸掉装错的 dsh,改走 npm 路线
指南的补充说明把修复讲得很直白:用 apt remove -y dsh 卸掉误装的包,然后按 Node.js + npm 的流程去装 @deepseek-ai/dsh。同一段话还点明了你最终要跑的启动命令——dsh web,DeepSeek Harness 的 Web 服务——把它和那个冒牌货彻底区分开。从这一帧起,实录里的每条命令都指向 npm 包。
$apt remove -y dsh
一次卸载之后,计划正式转向 npm 路线——并点明 dsh web 才是启动命令。看实录 8:40
路线 A · nvm 装 Node 24、npm 换镜像与启动命令
- 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
实录的真实感在这里:GitHub 通了,gitee 没通。看实录 10:20 - 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
nodejs.org 慢,Ctrl+C,export 换 npmmirror 镜像——然后一泻千里。看实录 11:40 - 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
验证、换 npm 源,启动就是一行 npx。看实录 13:00
首次启动、排错与跑起来的界面
- 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
等待本身就是一个步骤——有时间预算,也有第一项检查。看实录 13:35 - 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
真进度条胜过转圈:先全局安装,再 dsh web。看实录 14:10 - 10
Web UI 跑起来了——dsh 从此住在 WSL 里
实录停在你想到达的地方:DeepSeek Harness 的 Web UI 在浏览器里渲染出来——侧栏是工作区,标准模式,选中的是 DeepSeek-V41-Flash。从这一刻起,会话在 WSL 发行版里以真实的 Linux 路径执行,完整的 Linux 工具链就在你熟悉的那个聊天框背后。

终点线: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 发行版里什么都不会被安装。
重启后侧栏底部 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 决定的另外几面。
DeepSeek Harness Windows 安装教程
10 步实机截图安装教程:Node.js、npm 全局安装、3080 端口的 Web UI、API key,Win10/11 免 WSL。
阅读指南DeepSeek Harness Linux 安装教程
逐帧核对的 Linux 安装教程:Node.js、一条 npx 命令、服务商配置,另附 Windows 用户的 WSL 章节。
阅读指南安全地安装插件
dsh 里“安装插件”到底发生什么,附一套第三方代码审查清单。
阅读指南手机远程控制 dsh
ngrok 内网穿透把 Web UI 挂上公网,在外面用手机连回家里的 Agent,免装 App,实测截图逐步对照。
阅读指南来源与署名
十帧画面全部来自上面这段屏幕实录,已裁掉直播互动面板、浏览器边框和任务栏,主播左下角头像做了模糊处理。路线 B 的命令逐字引自 dsh-wsl-workspace 的 README,所有仓库事实于 2026-10-06 通过 GitHub API 实核。
