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 提供更的文件系统性能、完整的终端支持,以及与 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 终端使用任一[安装方式](/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 提供更好的文件系统性能、完整的终端支持,以及与 openco
## 桌面应用 + 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
在 Windows 上获得最佳 Web 体验:
在 Windows 上获得最佳 Web 体验:
1. **在 WSL 终端中运行 `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` 可确保正确的文件系统访问和终端集成,同时仍可 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
为了获得更流畅的体验,建议将仓库克隆或复制到 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/`