跳到內容

Windows (WSL)

透過 WSL 在 Windows 上執行 Vikasit Code 以獲得最佳體驗。

雖然 Vikasit Code 可以直接在 Windows 上執行,但我們推薦使用 Windows Subsystem for Linux (WSL) 以獲得最佳體驗。WSL 提供了一個 Linux 環境,能夠與 Vikasit Code 的各項功能無縫配合。


安裝設定

  1. 安裝 WSL

    如果尚未安裝,請參照 Microsoft 官方指南安裝 WSL

  2. 在 WSL 中安裝 Vikasit Code

    WSL 設定完成後,開啟 WSL 終端機,使用任一安裝方式安裝 Vikasit Code。

    Terminal window
    curl -fsSL https://opencode.ai/install | bash
  3. 從 WSL 中使用 Vikasit Code

    導航到你的專案目錄(透過 /mnt/c//mnt/d/ 等路徑存取 Windows 檔案),然後執行 Vikasit Code。

    Terminal window
    cd /mnt/c/Users/YourName/project
    vikasit

桌面應用程式 + WSL 伺服器

如果你希望使用 Vikasit Code 桌面應用程式,同時在 WSL 中執行伺服器:

  1. 在 WSL 中啟動伺服器,新增 --hostname 0.0.0.0 以允許外部連線:

    Terminal window
    vikasit serve --hostname 0.0.0.0 --port 4096
  2. 在桌面應用程式中連線到 http://localhost:4096

Terminal window
VIKASIT_SERVER_PASSWORD=your-password vikasit serve --hostname 0.0.0.0

Web 客戶端 + WSL

要在 Windows 上獲得最佳的 Web 體驗:

  1. 在 WSL 終端機中執行 vikasit web,而非在 PowerShell 中執行:

    Terminal window
    vikasit web --hostname 0.0.0.0
  2. 在 Windows 瀏覽器中存取 http://localhost:<port>(Vikasit Code 會輸出該 URL)

從 WSL 中執行 vikasit web 可確保正確的檔案系統存取和終端機整合,同時仍可透過 Windows 瀏覽器進行存取。


存取 Windows 檔案

WSL 可以透過 /mnt/ 目錄存取你的所有 Windows 檔案:

  • C: 磁碟 → /mnt/c/
  • D: 磁碟 → /mnt/d/
  • 其他磁碟以此類推…

範例:

Terminal window
cd /mnt/c/Users/YourName/Documents/project
vikasit

使用技巧

  • 對於儲存在 Windows 磁碟上的專案,在 WSL 中執行 Vikasit Code 即可無縫存取檔案
  • 搭配 VS Code 的 WSL 擴充套件 使用 Vikasit Code,打造一體化的開發工作流程
  • Vikasit Code 的設定和工作階段資料儲存在 WSL 環境中的 ~/.local/share/opencode/