docs: improve zh-cn and zh-tw documentation translations (#13942)

This commit is contained in:
chenmi
2026-02-17 20:06:39 +08:00
committed by GitHub
parent 8d0a303af4
commit 4fd3141ab5
68 changed files with 4624 additions and 4518 deletions

View File

@@ -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/`