返回目錄

dsh-wsl-workspace

精選清單收錄維護狀態: 活躍

dsh-wsl-workspace-maintainers/dsh-wsl-workspace

WSL workspace support for DeepSeek Harness——無縫的 WSL 工作區使用體驗,無需在 WSL 之中再安裝一個dsh,安裝該外掛後在 GUI 裡直接新增 WSL 工作區即可。WSL workspace support for DeepSeek Harness — Enjoy a seamless WSL workspace experience without needing to install dsh inside WSL. Once this plugin is installed, you can directly add a WSL workspace right from the GUI.

前往 GitHub
$ dsh plugin --profile web add dsh-wsl-workspace

124

星數

22

Fork

JavaScript

語言

MIT

授權條款

2026-08-14

建立於

2026-11-07

最近推送

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 環境

安裝步驟

  1. 01

    任選一種安裝方式:執行 `dsh plugin --profile web add dsh-wsl-workspace`,或加入 GitHub 儲存庫 URL,或加入本機複製路徑(README 列出三種)

    $ dsh plugin --profile web add dsh-wsl-workspace

  2. 02

    安裝外掛後重新啟動 `dsh web`

    $ dsh web

  3. 03

    在工作區點 W 按鈕或選 Add WSL workspace,選發行版,填絕對 Linux 路徑(可用 Check 驗證),可選填 Linux 使用者名稱,再按 Create & open

驗證整合成功

  • 重新啟動 `dsh web` 後,工作區標題列在新增工作區控制項右側會出現 W 按鈕

03DSH 整合程度與能力邊界

DSH 整合原生執行環境

以 `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。
2026-08-142026-11-07v0.7.13

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;刪除項目或重建工作區可還原發行版預設使用者。

08資料與來源

  • 作者聲明github.com11c424c42a17…

    Add a WSL workspace from the DeepSeek Harness web GUI and run the whole agent session — bash commands and file reads/wri…

  • 作者聲明github.com11c424c42a17…

    Nothing needs to be installed inside WSL.

此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-20。發現錯誤?提交更正。

🏆

最佳 DeepSeek Harness 外掛

從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。