MIT 原生 DSH 外掛,面向 Windows+WSL:GUI 註冊 WSL 工作區、發行版內有狀態 bash、9P 檔案工具含沙箱圍欄、發行版內 grep/glob,以及可選 `wsl_terminal` 回應互動提示。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-20
授權條款
MIT
01它能幫你完成什麼?
在本機 WSL 發行版內用 DeepSeek Harness 代理讀寫 Linux 專案檔案
在所選發行版執行 bash,並對 Linux 路徑進行 `read`/`write`/`edit`,無需在 WSL 內再裝 `dsh`
在 Windows 上用 WSL 開發、希望 DSH 的 shell 與檔案工具依 Linux 路徑運作的使用者
在 WSL 工作區工作階段中按需存取 Windows 端檔案
bash 仍在發行版內執行,Windows 路徑透過 /mnt/c 等磁碟掛載路徑呈現給模型
程式碼在 WSL、但仍需參照 Windows 資源或設定的開發者
從 DSH Web 介面註冊含路徑驗證的 WSL 工作區
點選「Create & open」後開啟新工作階段,模型看見 Linux 路徑,模式選擇器會落到對應 WSL 變體
習慣在 GUI 新增工作區、不只限 Windows 原生資料夾的 DSH Web 使用者
02如何將外掛接入 DeepSeek Harness?
先決條件
- Windows 主機上至少有一個本機 WSL 發行版(README 經 `wsl.exe` 與 /mnt 磁碟掛載 路由工具)
- 可執行 `dsh plugin --profile web add` 並能重新啟動 `dsh web` 的 DSH Web 環境
安裝步驟
- 01
任選一種安裝方式:執行 `dsh plugin --profile web add dsh-wsl-workspace`,或加入 GitHub 儲存庫 URL,或加入本機複製路徑(README 列出三種)
$ dsh plugin --profile web add dsh-wsl-workspace
- 02
安裝外掛後重新啟動 `dsh web`
$ dsh web
- 03
在工作區點 W 按鈕或選 Add WSL workspace,選發行版,填絕對 Linux 路徑(可用 Check 驗證),可選填 Linux 使用者名稱,再按 Create & open
驗證整合成功
- 重新啟動 `dsh web` 後,工作區標題列在新增工作區控制項右側會出現 W 按鈕
03DSH 整合程度與能力邊界
以 `dsh plugin --profile web add` 安裝 Cordis 外掛;Web GUI 工作區標題列會出現 W 按鈕,所建 WSL 工作區會把 bash 與檔案工具導向所選的本機 WSL 發行版。
Web GUI 的 WSL 工作區精靈
所選 WSL 發行版、絕對 Linux 工作區路徑、可選 Linux 使用者名稱→綁定 WSL 的工作區工作階段,模型脈絡內為 Linux 路徑
將各工作區使用者名稱寫入 DSH home 下的 wsl-workspaces.json發行版內的有狀態 bash
針對所設定 Linux 使用者的 shell 指令(留空則用發行版預設使用者,常為 `root`)→來自 WSL 內長駐 bash 的標準輸出/錯誤與結束碼
建立並維持 `wsl.exe` bash 程序;`cd`、環境變數與背景工作會在多次呼叫間保留以 Linux 端權限執行,不受 Windows ACL 沙箱包裹經 WSL 9P 共用區的檔案讀寫
供 `read`、`write`、`edit` 使用的 Linux 路徑→WSL 端看到的檔案內容與編輯結果;側邊欄位址維持 Linux 形式
走 Windows 端 WSL 9P 共用,工作區使用者名稱欄位不改變檔案工具身分`write`/`edit` 仍依主機 `ctx.sandboxPolicy` 與 `writableRoots` 圍欄發行版內的 grep 與 glob
Linux 目錄樹下的搜尋模式與路徑→由 WSL 內 GNU grep/find 產生、格式接近 ripgrep 的 grep 輸出與依修改時間排序的 glob 清單
在發行版內搜尋而非 9P 共用;grep 不讀取 `.gitignore`互動式終端入口(`wsl_terminal`)
面向需要 TTY 的程式(sudo 密碼、ssh 指紋、編輯器等)之 open/send/read/signal/close 操作→由代理鍵入的 PTY 終端 I/O;按鍵內容會進入對話紀錄
沿用主機 PTY 登錄表並指向本外掛 relay;任何鍵入(含密碼)都會寫入對話紀錄
04適合誰?何時不該用?
適合
- 在 Windows 上用 WSL 開發、希望 DSH 的 shell 與檔案工具依 Linux 路徑運作的使用者
- 程式碼在 WSL、但仍需參照 Windows 資源或設定的開發者
- 習慣在 GUI 新增工作區、不只限 Windows 原生資料夾的 DSH Web 使用者
不適合
- 面向具本機 WSL 的 Windows 主機:bash 與搜尋經 `wsl.exe` 在發行版內執行,Windows 檔案以 /mnt 磁碟掛載 形式出現。
- bash 在 Linux 核心端以所設定使用者的發行版權限執行;Windows ACL 沙箱無法包裹 `wsl.exe`,DSH 檔案策略不適用於 bash 指令。
- 檔案工具走 Windows 端 WSL 9P 共用,`write`/`edit` 仍受主機 `writableRoots` 沙箱約束;符號連結解析後,指向工作區外的寫入會在 `workspace-write` 下遭拒。
- 僅 `dsh.compatibility.dshReleases` 所列 DSH 版本經隔離實例驗證;其他版本可能可用但未驗證,主機若不暴露任一受支援 API 世代會在執行時明確失敗。
05相容性、維護與安全提醒
- 面向具本機 WSL 的 Windows 主機:bash 與搜尋經 `wsl.exe` 在發行版內執行,Windows 檔案以 /mnt 磁碟掛載 形式出現。
- bash 在 Linux 核心端以所設定使用者的發行版權限執行;Windows ACL 沙箱無法包裹 `wsl.exe`,DSH 檔案策略不適用於 bash 指令。
- 檔案工具走 Windows 端 WSL 9P 共用,`write`/`edit` 仍受主機 `writableRoots` 沙箱約束;符號連結解析後,指向工作區外的寫入會在 `workspace-write` 下遭拒。
- 僅 `dsh.compatibility.dshReleases` 所列 DSH 版本經隔離實例驗證;其他版本可能可用但未驗證,主機若不暴露任一受支援 API 世代會在執行時明確失敗。
- 各工作區可選 Linux 使用者名稱保存在 Windows 主機的 DSH home 下的 wsl-workspaces.json。
MIT · 最近推送 2026-11-07 · 發行版 v0.7.13
06常見問題
需要在 WSL 裡面再裝 DSH 嗎?
不需要。README 載明 WSL 內無需安裝任何東西:在 Windows 端裝外掛,在 GUI 選發行版即可,工作階段會把 bash 與檔案工具導向該發行版。
bash 權限和檔案工具有何不同?
bash 在 WSL 內以設定的 Linux 使用者執行,可在發行版內任意讀寫;Windows ACL 沙箱無法包裹 `wsl.exe`,DSH 檔案策略不約束 bash。檔案 `read`/`write`/`edit` 經 Windows 端 9P 共用,仍受 `writableRoots` 沙箱圍欄。
支援哪些 DSH 版本?
README 列出在隔離實例驗證過的版本(與 `package.json` 的 `dsh.compatibility.dshReleases` 一致)。表外版本可能可用但未驗證;主機若不暴露任一受支援 API 世代會明確失敗。
WSL 工作區能存取 Windows 檔案嗎?
可以。bash 仍在發行版內,Windows 檔案透過 /mnt/c 等磁碟掛載路徑存取。外掛亦會把部分 Linux 側邊欄位址轉回 Windows UNC 以便預覽。
可選使用者名稱是做什麼的?
決定 bash 以哪個 Linux 使用者執行(等同為 `wsl.exe -u` 指定 Linux 使用者)。不改變檔案工具(始終走 9P)。使用者名稱存在 DSH home 下的 wsl-workspaces.json;刪除項目或重建工作區可還原發行版預設使用者。
07相關的 DSH 工作流程
ds-harness-remote
作者 liguobao
基於 DeepSeek Harness 外掛機制構建的遠端訪問方案,通過低延遲、端到端加密的 P2P 網路,支援使用 PC、移動端 和 Web 隨時訪問本地裝置上的DSH 、CodeX、Cursor、Claude Code等工作區。 (Built on DeepSeek Harness plugins, this low-latency, end-to-end encrypted P2P solution lets PC, mobile, and web clients access local DSH, Codex, Cursor, and Claude Code workspaces.)
dsh-windows-mcp
作者 hellohub1212
DeepSeek Harness Windows 桌面自動化外掛,將 CursorTouch/Windows-MCP 接入內建 MCP 客戶端橋接。提供預設關閉的 Computer Use 開關和應用內依賴安裝器。
dsh-desktop
作者 anywhere-labs
為 DeepSeek Harness (DSH) 外掛生態打造的現代化桌面端解決方案。萬物皆「外掛」,桌面本身也是「外掛」。
dsh-go
作者 ccch1mneyyy
dsh-go — DeepSeek Harness 裝進口袋:手機本機執行,也能遙控你的電腦。
08資料與來源
Add a WSL workspace from the DeepSeek Harness web GUI and run the whole agent session — bash commands and file reads/wri…
Nothing needs to be installed inside WSL.
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-20。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
