讓 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 外掛,絕不濫發。