mirror of
https://gitea.toothfairyai.com/ToothFairyAI/tf_code.git
synced 2026-04-24 01:24:44 +00:00
fix(docs): translations
This commit is contained in:
Adam
@@ -3,7 +3,7 @@ title: 故障排除
|
||||
description: 常見問題以及如何解決它們。
|
||||
---
|
||||
|
||||
要調試 OpenCode 問題，請首先檢查其存儲在磁盤上的日誌和本地數據。
|
||||
要調試 opencode 問題，請首先檢查其存儲在磁盤上的日誌和本地數據。
|
||||
|
||||
---
|
||||
|
||||
@@ -39,13 +39,13 @@ opencode 將會話數據和其他應用程序數據存儲在磁盤上：
|
||||
|
||||
## 桌面應用程序
|
||||
|
||||
OpenCode Desktop 在後台運行本地 OpenCode 服務器（`opencode-cli` sidecar）。大多數問題是由行為不當的插件、損壞的緩存或錯誤的服務器設置引起的。
|
||||
opencode Desktop 在後台運行本地 opencode 服務器（`opencode-cli` sidecar）。大多數問題是由行為不當的插件、損壞的緩存或錯誤的服務器設置引起的。
|
||||
|
||||
### 快速檢查
|
||||
|
||||
- 完全退出並重新啟動應用程序。
|
||||
- 如果應用程序顯示錯誤屏幕，請單擊“**重新啟動**”並複制錯誤詳細信息。
|
||||
- 僅限 macOS：`OpenCode` 菜單 -> **重新加載 Webview**（如果 UI 為空白/凍結，則有幫助）。
|
||||
- 僅限 macOS：`opencode` 菜單 -> **重新加載 Webview**（如果 UI 為空白/凍結，則有幫助）。
|
||||
|
||||
---
|
||||
|
||||
@@ -72,7 +72,7 @@ OpenCode Desktop 在後台運行本地 OpenCode 服務器（`opencode-cli` sidec
|
||||
|
||||
#### 檢查插件目錄
|
||||
|
||||
OpenCode 還可以從磁盤加載本地插件。暫時將它們移開（或重命名文件夾）並重新啟動桌面應用程序：
|
||||
opencode 還可以從磁盤加載本地插件。暫時將它們移開（或重命名文件夾）並重新啟動桌面應用程序：
|
||||
|
||||
- **全局插件**
|
||||
- **macOS/Linux**：`~/.config/opencode/plugins/`
|
||||
@@ -86,22 +86,22 @@ OpenCode 還可以從磁盤加載本地插件。暫時將它們移開（或重
|
||||
|
||||
### 清除緩存
|
||||
|
||||
如果禁用插件沒有幫助（或者插件安裝被卡住），請清除緩存，以便 OpenCode 可以重建它。
|
||||
如果禁用插件沒有幫助（或者插件安裝被卡住），請清除緩存，以便 opencode 可以重建它。
|
||||
|
||||
1. 完全退出 OpenCode Desktop。
|
||||
1. 完全退出 opencode Desktop。
|
||||
2. 刪除緩存目錄：
|
||||
|
||||
- **macOS**：Finder -> `Cmd+Shift+G` -> 粘貼`~/.cache/opencode`
|
||||
- **Linux**：刪除`~/.cache/opencode`（或運行`rm -rf ~/.cache/opencode`）
|
||||
- **Windows**：按`WIN+R`並粘貼`%USERPROFILE%\.cache\opencode`
|
||||
|
||||
3. 重新啟動 OpenCode 桌面。
|
||||
3. 重新啟動 opencode 桌面。
|
||||
|
||||
---
|
||||
|
||||
### 修復服務器連接問題
|
||||
|
||||
OpenCode Desktop 可以啟動自己的本地服務器（默認）或連接到您配置的服務器 URL。
|
||||
opencode Desktop 可以啟動自己的本地服務器（默認）或連接到您配置的服務器 URL。
|
||||
|
||||
如果您看到 **“連接失敗”** 對話框（或者應用程序永遠無法通過啟動屏幕），請檢查自定義服務器 URL。
|
||||
|
||||
@@ -132,21 +132,21 @@ OpenCode Desktop 可以啟動自己的本地服務器（默認）或連接到您
|
||||
|
||||
### Windows：WebView2 運行時
|
||||
|
||||
在 Windows 上，OpenCode Desktop 需要 Microsoft Edge **WebView2 運行時**。如果應用程序打開為空白窗口或無法啟動，請安裝/更新 WebView2，然後重試。
|
||||
在 Windows 上，opencode Desktop 需要 Microsoft Edge **WebView2 運行時**。如果應用程序打開為空白窗口或無法啟動，請安裝/更新 WebView2，然後重試。
|
||||
|
||||
---
|
||||
|
||||
### Windows：一般性能問題
|
||||
|
||||
如果您在 Windows 上遇到性能緩慢、文件訪問問題或終端問題，請嘗試使用[WSL（適用於 Linux 的 Windows 子系統）](/docs/windows-wsl)。 WSL 提供了一個可以與 OpenCode 功能更加無縫協作的 Linux 環境。
|
||||
如果您在 Windows 上遇到性能緩慢、文件訪問問題或終端問題，請嘗試使用[WSL（適用於 Linux 的 Windows 子系統）](/docs/windows-wsl)。 WSL 提供了一個可以與 opencode 功能更加無縫協作的 Linux 環境。
|
||||
|
||||
---
|
||||
|
||||
### 通知不顯示
|
||||
|
||||
OpenCode Desktop 僅在以下情況下顯示系統通知：
|
||||
opencode Desktop 僅在以下情況下顯示系統通知：
|
||||
|
||||
- 在您的操作系統設置中啟用 OpenCode 通知，並且
|
||||
- 在您的操作系統設置中啟用 opencode 通知，並且
|
||||
- 應用程序窗口未聚焦。
|
||||
|
||||
---
|
||||
@@ -155,8 +155,8 @@ OpenCode Desktop 僅在以下情況下顯示系統通知：
|
||||
|
||||
如果應用程序無法啟動並且您無法從 UI 內部清除設置，請重置桌面應用程序的保存狀態。
|
||||
|
||||
1. 退出 OpenCode Desktop。
|
||||
2. 查找並刪除這些文件（它們位於 OpenCode Desktop 應用程序數據目錄中）：
|
||||
1. 退出 opencode Desktop。
|
||||
2. 查找並刪除這些文件（它們位於 opencode Desktop 應用程序數據目錄中）：
|
||||
|
||||
- `opencode.settings.dat`（桌面默認服務器 URL）
|
||||
- `opencode.global.dat` 和 `opencode.workspace.*.dat`（UI 狀態，如最近的服務器/項目）
|
||||
@@ -171,7 +171,7 @@ OpenCode Desktop 僅在以下情況下顯示系統通知：
|
||||
|
||||
## 尋求幫助
|
||||
|
||||
如果您遇到 OpenCode 問題：
|
||||
如果您遇到 opencode 問題：
|
||||
|
||||
1. **在 GitHub 上報告問題**
|
||||
|
||||
@@ -195,7 +195,7 @@ OpenCode Desktop 僅在以下情況下顯示系統通知：
|
||||
|
||||
---
|
||||
|
||||
### OpenCode 無法啟動
|
||||
### opencode 無法啟動
|
||||
|
||||
1. 檢查日誌中是否有錯誤消息
|
||||
2. 嘗試使用 `--print-logs` 運行以查看終端中的輸出
|
||||
|
||||
Reference in New Issue
Block a user