@neurocode-ai/web 1.18.8

package/src/content/docs/zh-tw/models.mdx

@@ -0,0 +1,222 @@
+---
+title: 模型
+description: 設定 LLM 提供商和模型。
+---
+
+OpenCode 使用 [AI SDK](https://ai-sdk.dev/) 和 [Models.dev](https://models.dev) 支援 **75+ LLM 提供商**，並支援執行本地模型。
+
+---
+
+## 提供商
+
+大多數熱門提供商已預設預先載入。如果您透過 `/connect` 指令新增了提供商的憑證，它們將在您啟動 OpenCode 時自動可用。
+
+了解更多關於[提供商](/docs/providers)的資訊。
+
+---
+
+## 選擇模型
+
+設定好提供商後，您可以透過輸入以下指令來選擇想要使用的模型：
+
+```bash frame="none"
+/models
+```
+
+---
+
+## 推薦模型
+
+市面上有非常多的模型，每週都有新模型發布。
+
+:::tip
+建議使用我們推薦的模型。
+:::
+
+然而，真正擅長程式碼生成和工具呼叫的模型只有少數幾個。
+
+以下是與 OpenCode 配合良好的幾個模型，排名不分先後（此列表並非詳盡無遺，也不一定是最新的）：
+
+- GPT 5.2
+- GPT 5.1 Codex
+- Claude Opus 4.5
+- Claude Sonnet 4.5
+- Minimax M2.1
+- Gemini 3 Pro
+
+---
+
+## 設定預設模型
+
+要將某個模型設為預設模型，可以在 OpenCode 設定中設定 `model` 欄位。
+
+```json title="opencode.json" {3}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "model": "lmstudio/google/gemma-3n-e4b"
+}
+```
+
+這裡完整的 ID 格式為 `provider_id/model_id`。例如，如果您使用 [OpenCode Zen](/docs/zen)，則 GPT 5.1 Codex 對應的值為 `opencode/gpt-5.1-codex`。
+
+如果您設定了[自訂提供商](/docs/providers#custom)，`provider_id` 是設定中 `provider` 部分的鍵名，`model_id` 是 `provider.models` 中的鍵名。
+
+---
+
+## 設定模型
+
+您可以透過設定檔全域設定模型的選項。
+
+```jsonc title="opencode.jsonc" {7-12,19-24}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "openai": {
+      "models": {
+        "gpt-5": {
+          "options": {
+            "reasoningEffort": "high",
+            "textVerbosity": "low",
+            "reasoningSummary": "auto",
+            "include": ["reasoning.encrypted_content"],
+          },
+        },
+      },
+    },
+    "anthropic": {
+      "models": {
+        "claude-sonnet-4-5-20250929": {
+          "options": {
+            "thinking": {
+              "type": "enabled",
+              "budgetTokens": 16000,
+            },
+          },
+        },
+      },
+    },
+  },
+}
+```
+
+這裡我們為兩個內建模型設定了全域選項：透過 `openai` 提供商存取的 `gpt-5`，以及透過 `anthropic` 提供商存取的 `claude-sonnet-4-20250514`。
+內建的提供商和模型名稱可以在 [Models.dev](https://models.dev) 上查閱。
+
+您還可以為使用中的任何代理設定這些選項。代理設定會覆寫此處的全域選項。[了解更多](/docs/agents/#additional)。
+
+您也可以定義擴展內建變體的自訂變體。變體允許您為同一個模型設定不同的選項，而無需建立重複的項目：
+
+```jsonc title="opencode.jsonc" {6-21}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "opencode": {
+      "models": {
+        "gpt-5": {
+          "variants": {
+            "high": {
+              "reasoningEffort": "high",
+              "textVerbosity": "low",
+              "reasoningSummary": "auto",
+            },
+            "low": {
+              "reasoningEffort": "low",
+              "textVerbosity": "low",
+              "reasoningSummary": "auto",
+            },
+          },
+        },
+      },
+    },
+  },
+}
+```
+
+---
+
+## 變體
+
+許多模型支援具有不同設定的多種變體。OpenCode 為熱門提供商內建了預設變體。
+
+### 內建變體
+
+OpenCode 為許多提供商提供了預設變體：
+
+**Anthropic**：
+
+- `high` - 高思考預算（預設）
+- `max` - 最大思考預算
+
+**OpenAI**：
+
+因模型而異，但大致如下：
+
+- `none` - 無推理
+- `minimal` - 極少推理
+- `low` - 低推理
+- `medium` - 中等推理
+- `high` - 高推理
+- `xhigh` - 超高推理
+
+**Google**：
+
+- `low` - 較低推理/Token 預算
+- `high` - 較高推理/Token 預算
+
+:::tip
+此列表並不全面，許多其他提供商也有內建的預設變體。
+:::
+
+### 自訂變體
+
+您可以覆寫現有變體或新增自己的變體：
+
+```jsonc title="opencode.jsonc" {7-18}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "openai": {
+      "models": {
+        "gpt-5": {
+          "variants": {
+            "thinking": {
+              "reasoningEffort": "high",
+              "textVerbosity": "low",
+            },
+            "fast": {
+              "disabled": true,
+            },
+          },
+        },
+      },
+    },
+  },
+}
+```
+
+### 切換變體
+
+使用快捷鍵 `variant_cycle` 可以快速在變體之間切換。[了解更多](/docs/keybinds)。
+
+---
+
+## 載入模型
+
+OpenCode 啟動時，會按以下優先順序載入模型：
+
+1. `--model` 或 `-m` 命令列旗標。格式與設定檔中相同：`provider_id/model_id`。
+
+2. OpenCode 設定中的 model 欄位。
+
+   ```json title="opencode.json"
+   {
+     "$schema": "https://opencode.ai/config.json",
+     "model": "anthropic/claude-sonnet-4-20250514"
+   }
+   ```
+
+   格式為 `provider/model`。
+
+3. 上次使用的模型。
+
+4. 按內部優先順序排列的第一個可用模型。

package/src/content/docs/zh-tw/network.mdx

@@ -0,0 +1,57 @@
+---
+title: 網路
+description: 設定代理伺服器和自訂憑證。
+---
+
+OpenCode 支援標準代理環境變數和自訂憑證，適用於企業網路環境。
+
+---
+
+## 代理伺服器
+
+OpenCode 遵循標準代理環境變數。
+
+```bash
+# HTTPS proxy (recommended)
+export HTTPS_PROXY=https://proxy.example.com:8080
+
+# HTTP proxy (if HTTPS not available)
+export HTTP_PROXY=http://proxy.example.com:8080
+
+# Bypass proxy for local server (required)
+export NO_PROXY=localhost,127.0.0.1
+```
+
+:::caution
+TUI 與本地 HTTP 伺服器進行通訊。您必須為此連線繞過代理，以防止路由迴圈。
+:::
+
+您可以使用 [CLI 旗標](/docs/cli#run)來設定伺服器的連接埠和主機名稱。
+
+---
+
+### 身分驗證
+
+如果您的代理需要基本身分驗證，請在 URL 中包含憑證。
+
+```bash
+export HTTPS_PROXY=http://username:password@proxy.example.com:8080
+```
+
+:::caution
+避免將密碼寫死在程式碼中。請使用環境變數或安全的憑證儲存方式。
+:::
+
+對於需要進階身分驗證（如 NTLM 或 Kerberos）的代理，建議使用支援相應身分驗證方式的 LLM 閘道。
+
+---
+
+## 自訂憑證
+
+如果您的企業使用自訂 CA 進行 HTTPS 連線，請設定 OpenCode 以信任這些憑證。
+
+```bash
+export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem
+```
+
+此設定同時適用於代理連線和直接 API 存取。

package/src/content/docs/zh-tw/permissions.mdx

@@ -0,0 +1,235 @@
+---
+title: 權限
+description: 控制哪些操作需要審批才能執行。
+---
+
+OpenCode 使用 `permission` 設定來決定某個操作是否應自動執行、提示您審批，還是被阻止。
+
+從 `v1.1.1` 開始，舊版 `tools` 布林設定已被廢棄，並已合併到 `permission` 中。舊版 `tools` 設定仍然支援，以保持向後相容。
+
+---
+
+## 操作
+
+每條權限規則解析為以下之一：
+
+- `"allow"` — 無需審批直接執行
+- `"ask"` — 提示審批
+- `"deny"` — 阻止該操作
+
+---
+
+## 設定
+
+您可以全域設定權限（使用 `*`），並覆寫特定工具的權限。
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "*": "ask",
+    "bash": "allow",
+    "edit": "deny"
+  }
+}
+```
+
+您還可以一次性設定所有權限：
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": "allow"
+}
+```
+
+---
+
+## 細粒度規則（物件語法）
+
+對於大多數權限，您可以使用物件來根據工具輸入套用不同的操作。
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "bash": {
+      "*": "ask",
+      "git *": "allow",
+      "npm *": "allow",
+      "rm *": "deny",
+      "grep *": "allow"
+    },
+    "edit": {
+      "*": "deny",
+      "packages/web/src/content/docs/*.mdx": "allow"
+    }
+  }
+}
+```
+
+規則透過模式比對進行評估，**最後比對的規則優先**。常見做法是將萬用的 `"*"` 規則放在最前面，更具體的規則放在後面。
+
+### 萬用字元
+
+權限模式使用簡單的萬用字元比對：
+
+- `*` 比對零個或多個任意字元
+- `?` 精確比對一個字元
+- 所有其他字元按字面值比對
+
+### 主目錄展開
+
+您可以在模式開頭使用 `~` 或 `$HOME` 來參照您的主目錄。這對於 [`external_directory`](#外部目錄) 規則特別有用。
+
+- `~/projects/*` -> `/Users/username/projects/*`
+- `$HOME/projects/*` -> `/Users/username/projects/*`
+- `~` -> `/Users/username`
+
+### 外部目錄
+
+使用 `external_directory` 允許工具呼叫存取 OpenCode 啟動時工作目錄之外的路徑。這適用於任何接受路徑作為輸入的工具（例如 `read`、`edit`、`glob`、`grep` 以及許多 `bash` 指令）。
+
+主目錄展開（如 `~/...`）僅影響模式的書寫方式。它不會將外部路徑納入當前工作空間，因此工作目錄之外的路徑仍然必須透過 `external_directory` 來允許。
+
+例如，以下設定允許存取 `~/projects/personal/` 下的所有內容：
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "external_directory": {
+      "~/projects/personal/**": "allow"
+    }
+  }
+}
+```
+
+此處允許的任何目錄都會繼承與當前工作空間相同的預設值。由於 [`read` 預設為 `allow`](#預設值)，`external_directory` 下的項目也允許讀取，除非另行覆寫。當需要在這些路徑中限制某個工具時，請新增顯式規則，例如在保留讀取的同時阻止編輯：
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "external_directory": {
+      "~/projects/personal/**": "allow"
+    },
+    "edit": {
+      "~/projects/personal/**": "deny"
+    }
+  }
+}
+```
+
+請將列表限定在受信任的路徑上，並根據需要為其他工具（例如 `bash`）疊加額外的允許或拒絕規則。
+
+---
+
+## 可用權限
+
+OpenCode 的權限以工具名稱為鍵，外加幾個安全防護項：
+
+- `read` — 讀取檔案（比對檔案路徑）
+- `edit` — 所有檔案修改（涵蓋 `edit`、`write`、`patch`）
+- `glob` — 檔案萬用字元比對（比對萬用字元模式）
+- `grep` — 內容搜尋（比對正規表示式模式）
+- `bash` — 執行 shell 指令（比對解析後的指令，如 `git status --porcelain`）
+- `task` — 啟動子代理（比對子代理類型）
+- `skill` — 載入技能（比對技能名稱）
+- `lsp` — 執行 LSP 查詢（目前不支援細粒度設定）
+- `webfetch` — 擷取 URL（比對 URL）
+- `websearch` — 網頁搜尋（比對查詢內容）
+- `external_directory` — 當工具存取專案工作目錄之外的路徑時觸發
+- `doom_loop` — 當同一工具呼叫以相同輸入重複 3 次時觸發
+
+---
+
+## 預設值
+
+如果您未指定任何設定，OpenCode 將使用寬鬆的預設值：
+
+- 大多數權限預設為 `"allow"`。
+- `doom_loop` 和 `external_directory` 預設為 `"ask"`。
+- `read` 為 `"allow"`，但 `.env` 檔案預設被拒絕：
+
+```json title="opencode.json"
+{
+  "permission": {
+    "read": {
+      "*": "allow",
+      "*.env": "deny",
+      "*.env.*": "deny",
+      "*.env.example": "allow"
+    }
+  }
+}
+```
+
+---
+
+## "Ask"的作用
+
+當 OpenCode 提示審批時，介面提供三種選擇：
+
+- `once` — 僅批准本次請求
+- `always` — 批准與建議模式比對的後續請求（在當前 OpenCode 工作階段的剩餘時間內有效）
+- `reject` — 拒絕請求
+
+`always` 所批准的模式集合由工具提供（例如，bash 審批通常會將安全的指令前綴如 `git status*` 加入白名單）。
+
+---
+
+## 代理
+
+您可以為每個代理單獨覆寫權限。代理權限會與全域設定合併，且代理規則優先。[了解更多](/docs/agents#permissions)關於代理權限的內容。
+
+:::note
+有關更詳細的模式比對範例，請參閱上方的[細粒度規則（物件語法）](#細粒度規則物件語法)部分。
+:::
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "bash": {
+      "*": "ask",
+      "git *": "allow",
+      "git commit *": "deny",
+      "git push *": "deny",
+      "grep *": "allow"
+    }
+  },
+  "agent": {
+    "build": {
+      "permission": {
+        "bash": {
+          "*": "ask",
+          "git *": "allow",
+          "git commit *": "ask",
+          "git push *": "deny",
+          "grep *": "allow"
+        }
+      }
+    }
+  }
+}
+```
+
+您還可以在 Markdown 中設定代理權限：
+
+```markdown title="~/.config/opencode/agents/review.md"
+---
+description: Code review without edits
+mode: subagent
+permission:
+  edit: deny
+  bash: ask
+  webfetch: deny
+---
+
+Only analyze code and suggest changes.
+```
+
+:::tip
+對帶參數的指令使用模式比對。`"grep *"` 允許執行 `grep pattern file.txt`，而單獨的 `"grep"` 則會阻止它。像 `git status` 這樣的指令適用於預設行為，但在傳遞參數時需要顯式權限（如 `"git status *"`）。
+:::