wode25500/dsh-wsl：WSL 橋接插件介紹

DeepSeek Harness（DSH）的理念是“一切皆插件”。在 Windows 環境下，智能體需要調用 WSL 執行 Linux 命令、管理發行版或轉換路徑。下面介紹一個橋接插件，它將 WSL 的能力直接暴露爲 DSH 原生工具。

這是一個 WSL (Windows Subsystem for Linux) 的 DeepSeek Harness (dsh) 橋接插件，由 WODE25500 維護。它允許智能體在 WSL 中運行 Linux 命令、管理發行版、轉換 Windows ↔ WSL 路徑，並實現跨系統複製文件。

核心功能¶

插件提供 5 個原生 DSH 工具：

• wsl_run：在 WSL 中執行 Linux 命令。
• wsl_distro_list：列出已安裝的發行版及其狀態。
• wsl_status：檢查 WSL 系統狀態與警告信息。
• wsl_path_convert：在 Windows 和 WSL 路徑之間進行轉換。
• wsl_copy：跨系統複製文件。

其他特性包括：

• 自動編碼處理：自動處理 WSL 的 UTF-16LE 輸出編碼，解決管道輸出亂碼問題。
• 發行版管理：支持發行版指定與默認發行版配置。
• 路徑轉換：封裝 wslpath，提供可靠的路徑轉換能力。
• 配置與兼容性：支持 Schemastery 配置 + bundle patch 層，以及明確的錯誤處理。

安裝與啓用¶

在 DSH 的 bundle profile 中添加以下配置：

- insert:
    - id: wsl
      name: './src/index.js'
      config:
        wslPath: wsl
        defaultDistro: Ubuntu
        timeoutMs: 120000

典型用法¶

安裝後，可以直接調用上述工具。例如：

1. 使用 wsl_status 查看 WSL 狀態。
2. 使用 wsl_run 跑 python3 --version。

注意事項¶

• 環境依賴：如果虛擬化未啓用，WSL2 無法啓動，命令會返回 HCS_E_SERVICE_NOT_AVAILABLE。這是環境問題，非插件 bug。
• 命令語義：wsl_run 使用 sh -lc 語義，不適用於交互式輸入或 TUI 程序。
• 編碼兼容：WSL 輸出編碼混合（UTF-8 中文錯誤 + UTF-16 正文），插件已做雙重解碼兜底。

該插件爲 DSH 提供了與 WSL 交互的標準化入口。欲瞭解更多細節，請查看插件目錄或 GitHub 倉庫。