前言¶
DeepSeek Harness (DSH) 採用插件化架構，任何新功能都通過插件引入。當工作流需要同時利用 Windows 的圖形界面、文件系統和網絡環境，以及 WSL 的 Linux 原生能力（如容器、編譯環境）時，直接在單一環境中部署會帶來兼容性挑戰。dsh-wsl-kit 是一個用於解決這一問題的 meta-repo，它將 DSH 智能體駐留在 WSL 中，同時提供 Windows 瀏覽器的聊天界面，並處理跨操作系統的路徑、剪貼板、文件打開和網絡請求。
它是什麼¶
這是一個 meta-repo，包含文檔、安裝腳本和 cordis.patch.yml。它本身不包含插件運行時。
install.sh 腳本負責將 Daily、GitHub、LLM 和 Full 插件套件加載到 DSH 的 web 配置中。聊天界面運行在 Windows 瀏覽器上，而智能體核心和工具鏈則運行在 WSL 內部。此外，該倉庫還包含一套 Linux 本地能力插件（如推理、媒體處理、只讀 DevOps 工具）的鏈接腳本，以及 IM、Obsidian 和 Jev 等可選插件。
核心功能¶
該套件主要提供以下能力：
- 跨 OS 操作支持：通過 Daily 套件，智能體可以執行跨操作系統的操作，包括路徑映射、剪貼板讀寫、默認瀏覽器調用、文件打開、網絡請求和啓動進程。
- 分離式架構：Windows 端僅提供 UI 和交互層，代理核心與工具執行環境（WSL）完全隔離，確保 Linux 原生工具（如
tmux、git、docker）能直接調用。 - 可選插件生態：
- IM 插件：支持飛書、企業微信、釘釘、QQ、Slack、Discord、Telegram 等即時通訊工具的接入。
- Obsidian 插件：實現 WSL 代理與 Windows NTFS 倉庫的雙向交互。
- Jev 插件：提供系統級問答能力。
- Linux 本地能力：通過鏈接 Linux 插件，智能體可訪問本地 LLM 推理服務（Ollama、llama.cpp、vLLM）、媒體文件、搜索、機密管理以及只讀的 DevOps 工具集。
安裝與啓用¶
在使用前，請確保 DeepSeek Harness (dsh) 版本不低於 0.1.2。
- 安裝主套件：
進入 WSL 環境，克隆倉庫並運行安裝腳本，或使用 DSH 插件管理命令。
bash install.sh
或者，如果只需要特定插件，可以使用：
dsh plugin add <plugin-repo-url>
- 鏈接 Linux 本地能力插件：
主套件安裝腳本不包含 Linux 本地能力插件。需要手動運行鏈接腳本將這些插件加載到 DSH 中：
bash scripts/link-linux-plugins.sh
- 安裝可選插件：
若需 IM、Obsidian 或 Jev 等功能，需單獨安裝對應的插件倉庫。
架構與訪問¶
該套件運行在 DSH 的 web 模式下，界面與代理運行在兩個不同的端口。
- Windows UI：運行在端口 3081。訪問時需要附加一次性
?token=參數（直接訪問 3081 會返回 401）。端口 3080 爲 WSL 專用，僅供代理內部使用。 - 插件映射差異：有三個插件在 npm 上的發佈名稱與其倉庫名稱不同，安裝時需注意：
- 倉庫
dsh-wsl-tray-> npm 包名dsh-wsl-tray-launcher - 倉庫
dsh-wsl-expose-> npm 包名dsh-wsl-portproxy - 倉庫
dsh-wsl-workspace-> npm 包名dsh-wsl-workspace-check
- 倉庫
注意事項¶
- 包描述與安裝限制：倉庫中的
package.json描述了目標插件集（31 個插件）的配置，但由於 pnpm 的限制（不允許在github:依賴中嵌套github:依賴），該 bundle 目前無法直接通過pnpm add安裝。必須使用install.sh或dsh plugin add逐個安裝。 - 運行時：該插件不包含運行時，需要確保系統已正確安裝 DSH。
- 權限與安全：Linux 本地能力插件（如 DevOps 工具）通常以 WSL 用戶的權限運行，使用時需注意權限配置。
