ToothFairyAI_Public/tf_code
1
0
Fork 0
mirror of https://gitea.toothfairyai.com/ToothFairyAI/tf_code.git synced 2026-04-25 01:54:49 +00:00
Code Issues Packages Projects Releases Wiki Activity

fix(docs): locale translations for nav elements and headings

Browse Source
This commit is contained in:
Adam
2026-02-11 18:51:27 -06:00
parent 8eea53a41e
commit aea68c386a
484 changed files with 12718 additions and 11212 deletions
Download Patch File Download Diff File Expand all files Collapse all files

265
packages/web/src/content/docs/zh-tw/config.mdx
View File

@@ -1,15 +1,15 @@
---
title: 配置
description: 使用 opencode JSON 配置。
title: 設定
description: 使用 opencode JSON 設定。
---
您可以使用 JSON 配置文件配置 opencode。
您可以使用 JSON 設定檔設定 opencode。
---
## 格式
opencode 支持 **JSON** 和 **JSONC**（帶註釋的 JSON）格式。
opencode 支援 **JSON** 和 **JSONC**（帶註解的 JSON）格式。
```jsonc title="opencode.jsonc"
{
@@ -23,47 +23,46 @@ opencode 支持 **JSON** 和 **JSONC**（帶註釋的 JSON）格式。
---
## 地點
## 位置
您可以將配置放置在幾個不同的位置，它們有一個
不同的優先順序。
您可以將設定放置在幾個不同的位置，它們有一個不同的優先順序。
:::note
配置文件**合併在一起**，而不是替換。
設定檔**合併在一起**，而不是取代。
:::
配置文件被合併在一起，而不是被替換。以下配置位置的設置被合併。僅當密鑰衝突時，後面的配置才會覆蓋前面的配置。保留所有配置中的非衝突設置。
設定檔被合併在一起，而不是被取代。以下設定位置的設定被合併。僅當鍵值衝突時，後面的設定才會覆寫前面的設定。保留所有設定中的非衝突設定。
例如，如果您的全局配置設置`theme: "opencode"`和`autoupdate: true`，並且您的項目配置設置`model: "anthropic/claude-sonnet-4-5"`，則最終配置將包括所有三個設置。
例如，如果您的全域設定設定 `theme: "opencode"` 和 `autoupdate: true`，並且您的專案設定設定 `model: "anthropic/claude-sonnet-4-5"`，則最終設定將包括所有三個設定。
---
### 優先順序
配置源按以下順序加載（後面的源覆蓋前面的源）：
設定來源按以下順序載入（後面的來源覆寫前面的來源）：
1. **遠程配置**（來自`.well-known/opencode`）-組織默認值
2. **全局配置** (`~/.config/opencode/opencode.json`) - 用戶首選項
3. **自定義配置** (`OPENCODE_CONFIG` env var) - 自定義覆蓋
4. **項目配置**（項目中的`opencode.json`）- 項目特定的設置
5. **`.opencode` 目錄** - 代理、命令、插件
6. **內聯配置** (`OPENCODE_CONFIG_CONTENT` env var) - 運行時覆蓋
1. **遠端設定**（來自 `.well-known/opencode`）- 組織預設值
2. **全域設定** (`~/.config/opencode/opencode.json`) - 使用者偏好設定
3. **自定義設定** (`OPENCODE_CONFIG` env var) - 自定義覆寫
4. **專案設定**（專案中的 `opencode.json`）- 專案特定的設定
5. **`.opencode` 目錄** - 代理、指令、外掛
6. **內聯設定** (`OPENCODE_CONFIG_CONTENT` env var) - 執行時覆寫
這意味著項目配置可以覆蓋全局默認值，全局配置可以覆蓋遠程組織默認值。
這意味著專案設定可以覆寫全域預設值，全域設定可以覆寫遠端組織預設值。
:::note
`.opencode` 和`~/.config/opencode` 目錄對子目錄使用**複數名稱**：`agents/`、`commands/`、`modes/`、`plugins/`、`skills/`、`tools/` 和`themes/`。為了向後兼容，還支持單數名稱（例如`agent/`）。
`.opencode` 和 `~/.config/opencode` 目錄對子目錄使用**複數名稱**：`agents/`、`commands/`、`modes/`、`plugins/`、`skills/`、`tools/` 和 `themes/`。為了向後相容，也支援單數名稱（例如 `agent/`）。
:::
---
### 遠程
### 遠端
組織可以通過 `.well-known/opencode` 端點提供默認配置。當您向支持它的提供商進行身份驗證時，會自動獲取該信息。
組織可以透過 `.well-known/opencode` 端點提供預設設定。當您向支援它的供應商進行身分驗證時，會自動取得該資訊。
首先加載遠程配置，作為基礎層。所有其他配置源（全局、項目）都可以覆蓋這些默認值。
首先載入遠端設定，作為基礎層。所有其他設定來源（全域、專案）都可以覆寫這些預設值。
例如，如果您的組織提供默認禁用的 MCP 服務器：
例如，如果您的組織提供預設禁用的 MCP 伺服器：
```json title="Remote config from .well-known/opencode"
{
@@ -77,7 +76,7 @@ opencode 支持 **JSON** 和 **JSONC**（帶註釋的 JSON）格式。
}
```
您可以在本地配置中啟用特定服務器：
您可以在本地設定中啟用特定伺服器：
```json title="opencode.json"
{
@@ -93,60 +92,57 @@ opencode 支持 **JSON** 和 **JSONC**（帶註釋的 JSON）格式。
---
### 全球的
### 全域
將全局 opencode 配置放在 `~/.config/opencode/opencode.json` 中。使用全局配置來實現用戶範圍的首選項，例如主題、提供商或按鍵綁定。
將全域 opencode 設定放在 `~/.config/opencode/opencode.json` 中。使用全域設定來實現使用者範圍的偏好設定，例如主題、供應商或按鍵綁定。
全局配置覆蓋遠程組織默認值。
全域設定覆寫遠端組織預設值。
---
### 每個項目
### 每個專案
在項目根目錄中添加`opencode.json`。項目配置在標準配置文件中具有最高優先級 - 它覆蓋全局配置和遠程配置。
在專案根目錄中新增 `opencode.json`。專案設定在標準設定檔中具有最高優先級 - 它覆寫全域設定和遠端設定。
:::tip
將項目特定配置放在項目的根目錄中。
將專案特定設定放在專案的根目錄中。
:::
當 opencode 啟動時，它會在當前目錄中查找配置文件或遍歷到最近的 Git 目錄。
當 opencode 啟動時，它會在當前目錄中尋找設定檔或遍歷到最近的 Git 目錄。
這也可以安全地簽入 Git 並使用與全局模式相同的模式。
這也可以安全地簽入 Git 並使用與全域模式相同的模式。
---
### 自定義路徑
使用 `OPENCODE_CONFIG` 環境變量指定自定義配置文件路徑。
使用 `OPENCODE_CONFIG` 環境變數指定自定義設定檔路徑。
```bash
export OPENCODE_CONFIG=/path/to/my/custom-config.json
opencode run "Hello world"
```
自定義配置按優先順序在全局配置和項目配置之間加載。
自定義設定按優先順序在全域設定和專案設定之間載入。
---
### 自定義目錄
使用`OPENCODE_CONFIG_DIR`指定自定義配置目錄
環境變量。將在該目錄中搜索代理、命令、
模式和插件就像標準`.opencode`目錄一樣，並且應該
遵循相同的結構。
使用 `OPENCODE_CONFIG_DIR` 環境變數指定自定義設定目錄。將在該目錄中搜尋代理、指令、模式和外掛，就像標準 `.opencode` 目錄一樣，並且應該遵循相同的結構。
```bash
export OPENCODE_CONFIG_DIR=/path/to/my/config-directory
opencode run "Hello world"
```
自定義目錄在全局配置和`.opencode`目錄之後加載，因此它**可以覆蓋**它們的設置。
自定義目錄在全域設定和 `.opencode` 目錄之後載入，因此它**可以覆寫**它們的設定。
---
## 模式
## 架構
配置文件具有在 [**`opencode.ai/config.json`**](https://opencode.ai/config.json) 中定義的架構。
設定檔具有在 [**`opencode.ai/config.json`**](https://opencode.ai/config.json) 中定義的架構。
您的編輯器應該能夠根據架構進行驗證和自動完成。
@@ -154,7 +150,7 @@ opencode run "Hello world"
### TUI
您可以通過 `tui` 選項配置特定於 TUI 的設置。
您可以透過 `tui` 選項設定特定於 TUI 的設定。
```json title="opencode.json"
{
@@ -171,17 +167,17 @@ opencode run "Hello world"
可用選項：
- `scroll_acceleration.enabled` - 啟用 macOS 風格的滾動加速。 **優先於`scroll_speed`。 **
- `scroll_speed` - 自定義滾動速度倍增（默認值：`3`，最小值：`1`）。如果`scroll_acceleration.enabled` 是`true`，則忽略。
- `diff_style` - 控制差異渲染。 `"auto"` 適應terminal寬度，`"stacked"` 始終顯示單列。
- `scroll_acceleration.enabled` - 啟用 macOS 風格的捲動加速。 **優先於 `scroll_speed`。**
- `scroll_speed` - 自定義捲動速度倍數（預設值：`3`，最小值：`1`）。如果 `scroll_acceleration.enabled` 是 `true`，則忽略。
- `diff_style` - 控制差異顯示。 `"auto"` 適應終端機寬度，`"stacked"` 始終顯示單列。
[在此處了解有關使用 TUI 的更多信息](/docs/tui)。
[在此處了解有關使用 TUI 的更多資訊](/docs/tui)。
---
### 伺服器
您可以通過`opencode serve` 選項為`opencode web` 和`server` 命令配置服務器設置。
您可以透過 `opencode serve` 選項為 `opencode web` 和 `server` 指令設定伺服器設定。
```json title="opencode.json"
{
@@ -198,19 +194,19 @@ opencode run "Hello world"
可用選項：
- `port` - 監聽的端口。
- `hostname` - 要監聽的主機名。當`mdns`啟用且未設置主機名時，默認為`0.0.0.0`。
- `mdns` - 啟用 mDNS 服務發現。這允許網絡上的其他設備發現您的 opencode 服務器。
- `mdnsDomain` - mDNS 服務的自定義域名。默認為`opencode.local`。對於在同一網絡上運行多個實例很有用。
- `cors` - 從基於瀏覽器的客戶端使用 HTTP 服務器時允許 CORS 的其他來源。值必須是完整來源（方案+主機+可選端口），例如`https://app.example.com`。
- `port` - 監聽的連接埠。
- `hostname` - 要監聽的主機名稱。當 `mdns` 啟用且未設定主機名稱時，預設為 `0.0.0.0`。
- `mdns` - 啟用 mDNS 服務探索。這允許網路上的其他設備發現您的 opencode 伺服器。
- `mdnsDomain` - mDNS 服務的自定義網域名稱。預設為 `opencode.local`。對於在同一網路上執行多個實例很有用。
- `cors` - 從基於瀏覽器的客戶端使用 HTTP 伺服器時允許 CORS 的其他來源。值必須是完整來源（通訊協定+主機+可選連接埠），例如 `https://app.example.com`。
[在此處了解有關服務器的更多信息](/docs/server)。
[在此處了解有關伺服器的更多資訊](/docs/server)。
---
### 工具
您可以通過 `tools` 選項管理LLM可以使用的工具。
您可以透過 `tools` 選項管理 LLM 可以使用的工具。
```json title="opencode.json"
{
@@ -222,13 +218,13 @@ opencode run "Hello world"
}
```
[在此處了解有關工具的更多信息](/docs/tools)。
[在此處了解有關工具的更多資訊](/docs/tools)。
---
### 型號
### 模型
您可以通過 `provider`、`model` 和 `small_model` 選項來配置要在 opencode 配置中使用的提供商和模型。
您可以透過 `provider`、`model` 和 `small_model` 選項來設定要在 opencode 設定中使用的供應商和模型。
```json title="opencode.json"
{
@@ -239,9 +235,9 @@ opencode run "Hello world"
}
```
`small_model` 選項為標題生成等輕量級任務配置單獨的模型。默認情況下，如果您的提供商可以提供更便宜的模型，opencode 會嘗試使用更便宜的模型，否則它會回退到您的主模型。
`small_model` 選項為標題生成等輕量級任務設定單獨的模型。預設情況下，如果您的供應商可以提供更便宜的模型，opencode 會嘗試使用更便宜的模型，否則它會退回到您的主模型。
提供者選項可以包括`timeout`和`setCacheKey`：
供應商選項可以包括 `timeout` 和 `setCacheKey`：
```json title="opencode.json"
{
@@ -257,20 +253,20 @@ opencode run "Hello world"
}
```
- `timeout` - 請求超時以毫秒為單位（默認值：300000）。設置為 `false` 以禁用。
- `setCacheKey` - 確保始終為指定的提供者設置緩存密鑰。
- `timeout` - 請求超時以毫秒為單位（預設值：300000）。設定為 `false` 以禁用。
- `setCacheKey` - 確保始終為指定的供應商設定快取金鑰。
您還可以配置[本地模型](/docs/models#local)。 [了解更多](/docs/models)。
您也可以設定 [本地模型](/docs/models#local)。 [了解更多](/docs/models)。
---
#### 特定於提供商的選項
#### 特定於供應商的選項
某些提供商支持除通用`timeout` 和`apiKey` 設置之外的其他配置選項。
某些供應商支援除通用 `timeout` 和 `apiKey` 設定之外的其他設定選項。
##### 亞馬遜基岩
##### Amazon Bedrock
Amazon Bedrock 支持 AWS 特定配置：
Amazon Bedrock 支援 AWS 特定設定：
```json title="opencode.json"
{
@@ -287,21 +283,21 @@ Amazon Bedrock 支持 AWS 特定配置：
}
```
- `region` - Bedrock 的 AWS 區域（默認為 `AWS_REGION` env var 或 `us-east-1`）
- `profile` - 來自 `~/.aws/credentials` 的 AWS 命名配置文件（默認為 `AWS_PROFILE` env var）
- `endpoint` - VPC terminal節點的自定義terminal節點 URL。這是使用 AWS 特定術語的通用 `baseURL` 選項的別名。如果兩者都指定，`endpoint` 優先。
- `region` - Bedrock 的 AWS 區域（預設為 `AWS_REGION` env var 或 `us-east-1`）
- `profile` - 來自 `~/.aws/credentials` 的 AWS 命名設定檔（預設為 `AWS_PROFILE` env var）
- `endpoint` - VPC 終端節點的自定義終端節點 URL。這是使用 AWS 特定術語的通用 `baseURL` 選項的別名。如果兩者都指定，`endpoint` 優先。
:::note
承載令牌（`AWS_BEARER_TOKEN_BEDROCK` 或`/connect`）優先於基於配置文件的身份驗證。詳情請參閱[認證優先級](/docs/providers#authentication-precedence)。
Bearer Token (`AWS_BEARER_TOKEN_BEDROCK` 或 `/connect`) 優先於基於設定檔的身分驗證。詳情請參閱 [認證優先級](/docs/providers#authentication-precedence)。
:::
[了解有關 Amazon Bedrock 配置的更多信息](/docs/providers#amazon-bedrock)。
[了解有關 Amazon Bedrock 設定的更多資訊](/docs/providers#amazon-bedrock)。
---
### 主題
您可以通過 `theme` 選項在 opencode 配置中配置要使用的主題。
您可以透過 `theme` 選項在 opencode 設定中設定要使用的主題。
```json title="opencode.json"
{
@@ -314,9 +310,9 @@ Amazon Bedrock 支持 AWS 特定配置：
---
### Agents
### 代理
您可以通過 `agent` 選項為特定任務配置專用代理。
您可以透過 `agent` 選項為特定任務設定專用代理。
```jsonc title="opencode.jsonc"
{
@@ -336,13 +332,13 @@ Amazon Bedrock 支持 AWS 特定配置：
}
```
您還可以使用 `~/.config/opencode/agents/` 或 `.opencode/agents/` 中的 markdown 文件定義代理。 [在這裡了解更多](/docs/agents)。
您也可以使用 `~/.config/opencode/agents/` 或 `.opencode/agents/` 中的 markdown 檔案定義代理。 [在這裡了解更多](/docs/agents)。
---
### 默認代理
### 預設代理
您可以使用 `default_agent` 選項設置默認代理。當沒有明確指定時，這將確定使用哪個代理。
您可以使用 `default_agent` 選項設定預設代理。當沒有明確指定時，這將決定使用哪個代理。
```json title="opencode.json"
{
@@ -351,15 +347,15 @@ Amazon Bedrock 支持 AWS 特定配置：
}
```
默認代理必須是主代理（而不是子代理）。這可以是內置代理，例如`"build"`或`"plan"`，或者您定義的[定制代理](/docs/agents)。如果指定的代理不存在或者是子代理，opencode 將回退到 `"build"` 並發出警告。
預設代理必須是主代理（而不是子代理）。這可以是內建代理，例如 `"build"` 或 `"plan"`，或者您定義的 [自定義代理](/docs/agents)。如果指定的代理不存在或者是子代理，opencode 將退回到 `"build"` 並發出警告。
此設置適用於所有介面：TUI、CLI (`opencode run`)、桌面應用程式和 GitHub Action。
此設定適用於所有介面：TUI、CLI (`opencode run`)、桌面應用程式和 GitHub Action。
---
### 分享
您可以通過`share`選項配置[分享](/docs/share)功能。
您可以透過 `share` 選項設定 [分享](/docs/share) 功能。
```json title="opencode.json"
{
@@ -370,17 +366,17 @@ Amazon Bedrock 支持 AWS 特定配置：
這需要：
- `"manual"` - 允許通過命令手動共享（默認）
- `"manual"` - 允許透過指令手動分享（預設）
- `"auto"` - 自動分享新對話
- `"disabled"` - 完全禁用共享
- `"disabled"` - 完全禁用分享
默認情況下，共享設置為手動模式，您需要使用 `/share` 命令顯式共享對話。
預設情況下，分享設定為手動模式，您需要使用 `/share` 指令明確分享對話。
---
### 命令
### 指令
您可以通過`command`選項為重複任務配置自定義命令。
您可以透過 `command` 選項為重複任務設定自定義指令。
```jsonc title="opencode.jsonc"
{
@@ -400,13 +396,13 @@ Amazon Bedrock 支持 AWS 特定配置：
}
```
您還可以使用 `~/.config/opencode/commands/` 或 `.opencode/commands/` 中的 Markdown 文件定義命令。 [在這裡了解更多](/docs/commands)。
您也可以使用 `~/.config/opencode/commands/` 或 `.opencode/commands/` 中的 Markdown 檔案定義指令。 [在這裡了解更多](/docs/commands)。
---
### 按鍵綁定
您可以通過 `keybinds` 選項自定義您的按鍵綁定。
您可以透過 `keybinds` 選項自定義您的按鍵綁定。
```json title="opencode.json"
{
@@ -430,14 +426,14 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup
}
```
如果您不想更新但希望在新版本可用時收到通知，請將`autoupdate` 設置為`"notify"`。
請注意，這僅在未使用 Homebrew 等包管理器安裝時才有效。
如果您不想更新但希望在新版本可用時收到通知，請將 `autoupdate` 設定為 `"notify"`。
請注意，這僅在未使用 Homebrew 等套件管理器安裝時才有效。
---
### 格式化程序
### 格式化程式
您可以通過`formatter`選項配置程式碼格式化程序。
您可以透過 `formatter` 選項設定程式碼格式化程式。
```json title="opencode.json"
{
@@ -457,15 +453,15 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup
}
```
[在此處了解有關格式化程序的更多信息](/docs/formatters)。
[在此處了解有關格式化程式的更多資訊](/docs/formatters)。
---
### 權限
默認情況下，opencode **允許所有操作**，無需明確批准。您可以使用`permission` 選項更改此設置。
預設情況下，opencode **允許所有操作**，無需明確批准。您可以使用 `permission` 選項更改此設定。
例如，要確保 `edit` 和 `bash` 工具需要用戶批准：
例如，要確保 `edit` 和 `bash` 工具需要使用者批准：
```json title="opencode.json"
{
@@ -477,13 +473,13 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup
}
```
[在此處了解有關權限的更多信息](/docs/permissions)。
[在此處了解有關權限的更多資訊](/docs/permissions)。
---
### 壓實
### 壓縮
您可以通過 `compaction` 選項控制上下文壓縮行為。
您可以透過 `compaction` 選項控制上下文壓縮行為。
```json title="opencode.json"
{
@@ -495,14 +491,14 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup
}
```
- `auto` - 當上下文已滿時自動壓縮會話（默認值：`true`）。
- `prune` - 刪除舊工具輸出以保存令牌（默認值：`true`）。
- `auto` - 當上下文已滿時自動壓縮工作階段（預設值：`true`）。
- `prune` - 刪除舊工具輸出以節省 tokens（預設值：`true`）。
---
### 守望者
### 觀察者 (Watcher)
您可以通過`watcher`選項配置文件觀察器忽略模式。
您可以透過 `watcher` 選項設定檔案觀察器忽略模式。
```json title="opencode.json"
{
@@ -513,13 +509,13 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup
}
```
模式遵循 glob 語法。使用它可以從文件監視中排除嘈雜的目錄。
模式遵循 glob 語法。使用它可以從檔案監視中排除嘈雜的目錄。
---
### MCP服務器
### MCP 伺服器
您可以通過 `mcp` 選項配置要使用的 MCP 服務器。
您可以透過 `mcp` 選項設定要使用的 MCP 伺服器。
```json title="opencode.json"
{
@@ -532,11 +528,11 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup
---
### 插件
### 外掛
[插件](/docs/plugins) 使用自定義工具、掛鉤和集成擴展 opencode。
[外掛](/docs/plugins) 使用自定義工具、掛鉤和整合擴展 opencode。
將插件文件放置在`.opencode/plugins/` 或`~/.config/opencode/plugins/` 中。您還可以通過 `plugin` 選項從 npm 加載插件。
將外掛檔案放置在 `.opencode/plugins/` 或 `~/.config/opencode/plugins/` 中。您也可以透過 `plugin` 選項從 npm 載入外掛。
```json title="opencode.json"
{
@@ -549,9 +545,9 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup
---
### 指示
### 指示 (Instructions)
您可以通過 `instructions` 選項配置您正在使用的型號的說明。
您可以透過 `instructions` 選項設定您正在使用的模型的指示。
```json title="opencode.json"
{
@@ -560,14 +556,13 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup
}
```
這需要指令文件的路徑和全局模式數組。 [了解更多
關於規則在這裡](/docs/rules)。
這需要指示檔案的路徑和全域模式陣列。 [了解更多關於規則在這裡](/docs/rules)。
---
### 殘疾服務提供者
### 禁用供應商
您可以通過 `disabled_providers` 選項禁用自動加載的提供商。當您想要阻止加載某些提供商（即使其憑據可用）時，這非常有用。
您可以透過 `disabled_providers` 選項禁用自動載入的供應商。當您想要阻止載入某些供應商（即使其憑證可用）時，這非常有用。
```json title="opencode.json"
{
@@ -577,20 +572,20 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup
```
:::note
`disabled_providers` 優先於`enabled_providers`。
`disabled_providers` 優先於 `enabled_providers`。
:::
`disabled_providers` 選項接受提供者 ID 數組。當提供者被禁用時：
`disabled_providers` 選項接受供應商 ID 陣列。當供應商被禁用時：
- 即使設置了環境變量也不會加載。
- 即使通過 `/connect` 命令配置 API 密鑰，也不會加載它。
- 提供商的型號不會出現在型號選擇列表中。
- 即使設定了環境變數也不會載入。
- 即使透過 `/connect` 指令設定 API 金鑰，也不會載入它。
- 供應商的模型不會出現在模型選擇列表中。
---
### 啟用的提供商
### 啟用的供應商
您可以通過 `enabled_providers` 選項指定提供商的允許列表。設置後，僅啟用指定的提供商，所有其他提供商將被忽略。
您可以透過 `enabled_providers` 選項指定供應商的允許清單。設定後，僅啟用指定的供應商，所有其他供應商將被忽略。
```json title="opencode.json"
{
@@ -599,13 +594,13 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup
}
```
當您想要限制 opencode 僅使用特定的提供商而不是一一禁用它們時，這非常有用。
當您想要限制 opencode 僅使用特定的供應商而不是一一禁用它們時，這非常有用。
:::note
`disabled_providers` 優先於`enabled_providers`。
`disabled_providers` 優先於 `enabled_providers`。
:::
如果某個提供商同時出現在`enabled_providers` 和`disabled_providers` 中，則`disabled_providers` 優先考慮向後兼容性。
如果某個供應商同時出現在 `enabled_providers` 和 `disabled_providers` 中，則 `disabled_providers` 優先考慮向後相容性。
---
@@ -626,15 +621,15 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup
---
## 變量
## 變數
您可以在配置文件中使用變量替換來引用環境變量和文件內容。
您可以在設定檔中使用變數替換來引用環境變數和檔案內容。
---
### 環境變量
### 環境變數
使用`{env:VARIABLE_NAME}`替換環境變量：
使用 `{env:VARIABLE_NAME}` 替換環境變數：
```json title="opencode.json"
{
@@ -651,13 +646,13 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup
}
```
如果未設置環境變量，它將被替換為空字符串。
如果未設定環境變數，它將被替換為空字串。
---
### 文件
### 檔案
使用 `{file:path/to/file}` 替換文件的內容：
使用 `{file:path/to/file}` 替換檔案的內容：
```json title="opencode.json"
{
@@ -673,13 +668,13 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup
}
```
文件路徑可以是：
檔案路徑可以是：
- 相對於配置文件目錄
- 相對於設定檔目錄
- 或者以 `/` 或 `~` 開頭的絕對路徑
這些對於：
- 將 API 密鑰等敏感數據保存在單獨的文件中。
- 包含大型指令文件，而不會弄亂您的配置。
- 跨多個配置文件共享通用配置片段。
- 將 API 金鑰等敏感數據保存在單獨的檔案中。
- 包含大型指示檔案，而不會弄亂您的設定。
- 跨多個設定檔共享通用設定片段。