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,39 +1,39 @@
---
title: Web
description: 在瀏覽器中使用 opencode。
description: 在瀏覽器中使用 OpenCode。
---
opencode 可以在瀏覽器中作為 Web 應用程式執行,無需終端機即可提供同樣強大的 AI 程式碼體驗。
OpenCode 可以作為 Web 應用程式在瀏覽器中執行,無需終端機即可獲得同樣強大的 AI 碼體驗。
![opencode Web - 新工作階段](../../../assets/web/web-homepage-new-session.png)
![OpenCode Web - New Session](../../../assets/web/web-homepage-new-session.png)
## 入門
## 快速開始
透過執行以下指令啟動 Web 介面:
執行以下指令啟動 Web 介面:
```bash
opencode web
```
在 `127.0.0.1` 上啟動一個具有隨機可用連接埠的本地伺服器,並自動在預設瀏覽器中打開 opencode。
在 `127.0.0.1` 上啟動一個本地伺服器,使用隨機可用連接埠,並自動在預設瀏覽器中開啟 OpenCode。
:::caution
如果未設定 `OPENCODE_SERVER_PASSWORD`,伺服器將不安全。這對於本地使用來說很好,但應該針對網路存取進行設定
如果未設定 `OPENCODE_SERVER_PASSWORD`,伺服器將沒有安全保護。本地使用沒有問題,但在網路存取時應當設定密碼
:::
:::tip[Windows 使用者]
獲得最佳體驗,從 [WSL](/docs/windows-wsl) 而不是 PowerShell 執行 `opencode web`。這確保正確的檔案系統存取和終端機整合。
為獲得最佳體驗,建議從 [WSL](/docs/windows-wsl) 而 PowerShell 執行 `opencode web`。這可以確保正確的檔案系統存取和終端機整合。
:::
---
## 配置
## 設定
可以使用命令列旗標或[設定檔](/docs/config) 中配置 Web 伺服器。
可以透過命令列旗標或[設定檔](/docs/config)來設定 Web 伺服器。
### 連接埠
預設情況下,opencode 選擇一個可用連接埠。可以指定一個連接埠:
預設情況下,OpenCode 選擇一個可用連接埠。你也可以指定連接埠:
```bash
opencode web --port 4096
@@ -41,13 +41,13 @@ opencode web --port 4096
### 主機名稱
預設情況下,伺服器綁定到 `127.0.0.1`(僅限 localhost)。要使 opencode 在您的網路可存取:
預設情況下,伺服器繫結到 `127.0.0.1`(僅限本地存取)。要使 OpenCode 在網路可存取:
```bash
opencode web --hostname 0.0.0.0
```
使用 `0.0.0.0` 時,opencode 顯示本地位址和網路位址:
使用 `0.0.0.0` 時,OpenCode 會同時顯示本地位址和網路位址:
```
Local access: http://localhost:4096
@@ -56,15 +56,15 @@ opencode web --hostname 0.0.0.0
### mDNS 探索
啟用 mDNS 以使您的伺服器在本地網路上可探索:
啟用 mDNS 可以讓你的伺服器在本地網路中被自動探索:
```bash
opencode web --mdns
```
這會自動將主機名稱設定為 `0.0.0.0` 並將伺服器廣播為 `opencode.local`。
這會自動將主機名稱設定為 `0.0.0.0`並將伺服器廣播為 `opencode.local`。
可以自定義 mDNS 網域名稱在同一網路執行多個實例:
可以自 mDNS 網域名稱,以便在同一網路執行多個實例:
```bash
opencode web --mdns --mdns-domain myproject.local
@@ -72,7 +72,7 @@ opencode web --mdns --mdns-domain myproject.local
### CORS
允許 CORS 的其他域(對於自定義前端有用
要為 CORS 新增額外的允許網域(適用於自訂前端
```bash
opencode web --cors https://example.com
@@ -80,53 +80,53 @@ opencode web --cors https://example.com
### 身分驗證
要保護存取,請使用 `OPENCODE_SERVER_PASSWORD` 環境變數設定密碼:
要保護伺服器存取,可以透過 `OPENCODE_SERVER_PASSWORD` 環境變數設定密碼:
```bash
OPENCODE_SERVER_PASSWORD=secret opencode web
```
使用者名稱預設為 `opencode`可以使用 `OPENCODE_SERVER_USERNAME` 進行更改。
使用者名稱預設為 `opencode`,可以透過 `OPENCODE_SERVER_USERNAME` 進行更改。
---
## 使用 Web 介面
啟動後Web 介面提供對 opencode 工作階段的存取。
啟動後Web 介面提供對 OpenCode 工作階段的存取。
### 工作階段
主頁查看和管理的工作階段。可以查看活動工作階段並開始新工作階段。
主頁查看和管理的工作階段。可以查看進行中的工作階段,也可以建立新的工作階段。
![opencode Web - 活動工作階段](../../../assets/web/web-homepage-active-session.png)
![OpenCode Web - Active Session](../../../assets/web/web-homepage-active-session.png)
### 伺服器狀態
擊「查看伺服器」可查看連接的伺服器及其狀態。
擊「See Servers」可查看已連線的伺服器及其狀態。
![opencode Web - 查看伺服器](../../../assets/web/web-homepage-see-servers.png)
![OpenCode Web - See Servers](../../../assets/web/web-homepage-see-servers.png)
---
## 連接終端機
可以將終端機 TUI 連接到正在執行的 Web 伺服器:
可以將終端機 TUI 連接到正在執行的 Web 伺服器:
```bash
# Start the web server
# 啟動 Web 伺服器
opencode web --port 4096
# In another terminal, attach the TUI
# 在另一個終端機中連接 TUI
opencode attach http://localhost:4096
```
允許您同時使用 Web 介面和終端機,共享相同的工作階段和狀態。
樣你就可以同時使用 Web 介面和終端機,共享相同的工作階段和狀態。
---
## 設定檔
您還可以在 `opencode.json` 設定檔中配置伺服器設定
你也可以在 `opencode.json` 設定檔中設定伺服器選項
```json
{
@@ -139,4 +139,4 @@ opencode attach http://localhost:4096
}
```
命令列旗標優先於設定檔設定。
命令列旗標優先順序高於設定檔中的設定。