docs: improve zh-cn and zh-tw documentation translations (#13942)
This commit is contained in:
@@ -1,37 +1,37 @@
|
||||
---
|
||||
title: Windows (WSL)
|
||||
description: 在 Windows 透過 WSL 使用 opencode。
|
||||
description: 透過 WSL 在 Windows 上執行 OpenCode 以獲得最佳體驗。
|
||||
---
|
||||
|
||||
import { Steps } from "@astrojs/starlight/components"
|
||||
|
||||
雖然 opencode 可以直接在 Windows 上執行,但為了獲得最佳體驗,我們建議使用 [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install)。WSL 提供了可與 opencode 功能順暢配合的 Linux 環境。
|
||||
雖然 OpenCode 可以直接在 Windows 上執行,但我們推薦使用 [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) 以獲得最佳體驗。WSL 提供了一個 Linux 環境,能夠與 OpenCode 的各項功能無縫配合。
|
||||
|
||||
:::tip[為什麼要用 WSL?]
|
||||
WSL 提供更好的檔案系統效能、完整的terminal支援,以及與 opencode 依賴之開發工具的相容性。
|
||||
:::tip[為什麼選擇 WSL?]
|
||||
WSL 提供更出色的檔案系統效能、完整的終端機支援,以及與 OpenCode 所依賴的開發工具的良好相容性。
|
||||
:::
|
||||
|
||||
---
|
||||
|
||||
## 設定
|
||||
## 安裝設定
|
||||
|
||||
<Steps>
|
||||
|
||||
1. **安裝 WSL**
|
||||
|
||||
如果你尚未安裝,請依照 Microsoft 官方指南[安裝 WSL](https://learn.microsoft.com/en-us/windows/wsl/install)。
|
||||
如果尚未安裝,請參照 Microsoft 官方指南[安裝 WSL](https://learn.microsoft.com/en-us/windows/wsl/install)。
|
||||
|
||||
2. **在 WSL 中安裝 opencode**
|
||||
2. **在 WSL 中安裝 OpenCode**
|
||||
|
||||
完成 WSL 設定後,打開 WSL terminal,並使用其中一種[安裝方式](/docs/)安裝 opencode。
|
||||
WSL 設定完成後,開啟 WSL 終端機,使用任一[安裝方式](/docs/)安裝 OpenCode。
|
||||
|
||||
```bash
|
||||
curl -fsSL https://opencode.ai/install | bash
|
||||
```
|
||||
|
||||
3. **從 WSL 使用 opencode**
|
||||
3. **從 WSL 中使用 OpenCode**
|
||||
|
||||
移動到你的專案目錄(可透過 `/mnt/c/`、`/mnt/d/` 等路徑存取 Windows 檔案),然後執行 opencode。
|
||||
導航到你的專案目錄(透過 `/mnt/c/`、`/mnt/d/` 等路徑存取 Windows 檔案),然後執行 OpenCode。
|
||||
|
||||
```bash
|
||||
cd /mnt/c/Users/YourName/project
|
||||
@@ -44,54 +44,53 @@ WSL 提供更好的檔案系統效能、完整的terminal支援,以及與 open
|
||||
|
||||
## 桌面應用程式 + WSL 伺服器
|
||||
|
||||
如果你偏好使用 opencode 桌面應用程式,但希望在 WSL 內執行伺服器:
|
||||
如果你希望使用 OpenCode 桌面應用程式,同時在 WSL 中執行伺服器:
|
||||
|
||||
1. **在 WSL 中啟動伺服器**,並使用 `--hostname 0.0.0.0` 允許外部連線:
|
||||
1. **在 WSL 中啟動伺服器**,新增 `--hostname 0.0.0.0` 以允許外部連線:
|
||||
|
||||
```bash
|
||||
opencode serve --hostname 0.0.0.0 --port 4096
|
||||
```
|
||||
|
||||
2. **將桌面應用程式連線到** `http://localhost:4096`
|
||||
2. **在桌面應用程式中連線到** `http://localhost:4096`
|
||||
|
||||
:::note
|
||||
若你的環境中 `localhost` 無法使用,請改用 WSL 的 IP 位址連線(在 WSL 執行:`hostname -I`),並使用 `http://<wsl-ip>:4096`。
|
||||
如果 `localhost` 在你的環境中無法使用,請改用 WSL 的 IP 位址進行連線(在 WSL 中執行:`hostname -I`),使用 `http://<wsl-ip>:4096`。
|
||||
:::
|
||||
|
||||
:::caution
|
||||
使用 `--hostname 0.0.0.0` 時,請設定 `OPENCODE_SERVER_PASSWORD` 來保護伺服器。
|
||||
使用 `--hostname 0.0.0.0` 時,請設定 `OPENCODE_SERVER_PASSWORD` 以保護伺服器安全。
|
||||
:::
|
||||
|
||||
```bash
|
||||
OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
---
|
||||
|
||||
## Web 用戶端 + WSL
|
||||
## Web 客戶端 + WSL
|
||||
|
||||
在 Windows 上取得最佳 Web 體驗:
|
||||
要在 Windows 上獲得最佳的 Web 體驗:
|
||||
|
||||
1. **請在 WSL terminal執行 `opencode web`**,而不是在 PowerShell 執行:
|
||||
1. **在 WSL 終端機中執行 `opencode web`**,而非在 PowerShell 中執行:
|
||||
|
||||
```bash
|
||||
opencode web --hostname 0.0.0.0
|
||||
```
|
||||
|
||||
2. **在 Windows 瀏覽器中開啟** `http://localhost:<port>`(opencode 會輸出該 URL)
|
||||
2. **在 Windows 瀏覽器中存取** `http://localhost:<port>`(OpenCode 會輸出該 URL)
|
||||
|
||||
從 WSL 執行 `opencode web` 可確保正確的檔案系統存取與terminal整合,同時仍可由 Windows 瀏覽器使用。
|
||||
從 WSL 中執行 `opencode web` 可確保正確的檔案系統存取和終端機整合,同時仍可透過 Windows 瀏覽器進行存取。
|
||||
|
||||
---
|
||||
|
||||
## 存取 Windows 檔案
|
||||
|
||||
WSL 可透過 `/mnt/` 目錄存取你所有的 Windows 檔案:
|
||||
WSL 可以透過 `/mnt/` 目錄存取你的所有 Windows 檔案:
|
||||
|
||||
- `C:` drive → `/mnt/c/`
|
||||
- `D:` drive → `/mnt/d/`
|
||||
- 其他磁碟機也相同
|
||||
- `C:` 磁碟 → `/mnt/c/`
|
||||
- `D:` 磁碟 → `/mnt/d/`
|
||||
- 其他磁碟以此類推...
|
||||
|
||||
範例:
|
||||
|
||||
@@ -101,13 +100,13 @@ opencode
|
||||
```
|
||||
|
||||
:::tip
|
||||
為了更流暢的使用體驗,建議將你的儲存庫 clone 或複製到 WSL 檔案系統(例如 `~/code/`)中,再從那裡執行 opencode。
|
||||
為了獲得更流暢的體驗,建議將儲存庫克隆或複製到 WSL 檔案系統中(例如 `~/code/` 目錄下),然後在該位置執行 OpenCode。
|
||||
:::
|
||||
|
||||
---
|
||||
|
||||
## 提示
|
||||
## 使用技巧
|
||||
|
||||
- 即使專案存放在 Windows 磁碟機上,也建議在 WSL 中執行 opencode,檔案存取會更順暢
|
||||
- 可將 opencode 與 VS Code 的 [WSL 擴充套件](https://code.visualstudio.com/docs/remote/wsl)搭配使用,建立整合式開發流程
|
||||
- opencode 的設定與工作階段會儲存在 WSL 環境中的 `~/.local/share/opencode/`
|
||||
- 對於儲存在 Windows 磁碟上的專案,在 WSL 中執行 OpenCode 即可無縫存取檔案
|
||||
- 搭配 VS Code 的 [WSL 擴充套件](https://code.visualstudio.com/docs/remote/wsl) 使用 OpenCode,打造一體化的開發工作流程
|
||||
- OpenCode 的設定和工作階段資料儲存在 WSL 環境中的 `~/.local/share/opencode/`
|
||||
|
||||
Reference in New Issue
Block a user