@neurocode-ai/web 1.18.8

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

@@ -0,0 +1,369 @@
+---
+title: 主題
+description: 選擇內建主題或定義您自己的主題。
+---
+
+透過 OpenCode，您可以從多個內建主題中進行選擇，使用能自動適配終端機主題的主題，或者定義您自己的自訂主題。
+
+預設情況下，OpenCode 使用我們自己的 `opencode` 主題。
+
+---
+
+## 終端機要求
+
+為了使主題能夠正確顯示完整的調色盤，您的終端機必須支援**真彩色**（24 位元色）。大多數現代終端機預設支援此功能，但您可能需要手動啟用：
+
+- **檢查支援情況**：執行 `echo $COLORTERM` — 輸出應為 `truecolor` 或 `24bit`
+- **啟用真彩色**：在您的 shell 設定檔中設定環境變數 `COLORTERM=truecolor`
+- **終端機相容性**：確保您的終端機模擬器支援 24 位元色（大多數現代終端機如 iTerm2、Alacritty、Kitty、Windows Terminal 以及較新版本的 GNOME Terminal 均已支援）
+
+如果沒有真彩色支援，主題可能會出現色彩精度下降的情況，或者回退到最接近的 256 色近似值。
+
+---
+
+## 內建主題
+
+OpenCode 自帶多個內建主題。
+
+| 名稱                   | 描述                                                                |
+| ---------------------- | ------------------------------------------------------------------- |
+| `system`               | 自動適配終端機的背景顏色                                            |
+| `tokyonight`           | 基於 [Tokyonight](https://github.com/folke/tokyonight.nvim) 主題    |
+| `everforest`           | 基於 [Everforest](https://github.com/sainnhe/everforest) 主題       |
+| `ayu`                  | 基於 [Ayu](https://github.com/ayu-theme) 暗色主題                   |
+| `catppuccin`           | 基於 [Catppuccin](https://github.com/catppuccin) 主題               |
+| `catppuccin-macchiato` | 基於 [Catppuccin](https://github.com/catppuccin) 主題               |
+| `gruvbox`              | 基於 [Gruvbox](https://github.com/morhetz/gruvbox) 主題             |
+| `kanagawa`             | 基於 [Kanagawa](https://github.com/rebelot/kanagawa.nvim) 主題      |
+| `nord`                 | 基於 [Nord](https://github.com/nordtheme/nord) 主題                 |
+| `matrix`               | 駭客風格的黑底綠字主題                                              |
+| `one-dark`             | 基於 [Atom One](https://github.com/Th3Whit3Wolf/one-nvim) Dark 主題 |
+
+我們還在不斷新增更多主題。
+
+---
+
+## 系統主題
+
+`system` 主題旨在自動適配您終端機的配色方案。與使用固定顏色的傳統主題不同，_system_ 主題具有以下特點：
+
+- **產生灰階色階**：根據終端機的背景顏色建立自訂灰階色階，確保最佳對比度。
+- **使用 ANSI 顏色**：利用標準 ANSI 顏色（0-15）進行語法高亮和 UI 元素渲染，遵循終端機的調色盤設定。
+- **保留終端機預設值**：將文字和背景顏色設為 `none`，以保持終端機的原生外觀。
+
+系統主題適合以下使用者：
+
+- 希望 OpenCode 與終端機的外觀保持一致
+- 使用了自訂終端機配色方案
+- 偏好所有終端機應用程式擁有統一的視覺風格
+
+---
+
+## 使用主題
+
+您可以透過 `/theme` 指令調出主題選擇介面來選擇主題，也可以在 `tui.json` 中直接指定。
+
+```json title="tui.json" {3}
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "theme": "tokyonight"
+}
+```
+
+---
+
+## 自訂主題
+
+OpenCode 支援靈活的基於 JSON 的主題系統，讓使用者可以輕鬆建立和自訂主題。
+
+---
+
+### 層級優先順序
+
+主題按以下順序從多個目錄載入，後面的目錄會覆蓋前面的目錄：
+
+1. **內建主題** — 嵌入在二進位檔案中
+2. **使用者設定目錄** — 定義在 `~/.config/opencode/themes/*.json` 或 `$XDG_CONFIG_HOME/opencode/themes/*.json`
+3. **專案根目錄** — 定義在 `<project-root>/.opencode/themes/*.json`
+4. **當前工作目錄** — 定義在 `./.opencode/themes/*.json`
+
+如果多個目錄包含同名主題，將使用優先順序較高的目錄中的主題。
+
+---
+
+### 建立主題
+
+要建立自訂主題，請在上述任一主題目錄中建立一個 JSON 檔案。
+
+建立使用者級主題：
+
+```bash no-frame
+mkdir -p ~/.config/opencode/themes
+vim ~/.config/opencode/themes/my-theme.json
+```
+
+建立專案級主題：
+
+```bash no-frame
+mkdir -p .opencode/themes
+vim .opencode/themes/my-theme.json
+```
+
+---
+
+### JSON 格式
+
+主題使用靈活的 JSON 格式，支援以下特性：
+
+- **十六進位顏色**：`"#ffffff"`
+- **ANSI 顏色**：`3`（0-255）
+- **顏色參考**：`"primary"` 或自訂定義的顏色名
+- **深色/淺色變體**：`{"dark": "#000", "light": "#fff"}`
+- **無顏色**：`"none"` — 使用終端機的預設顏色或透明背景
+
+---
+
+### 顏色定義
+
+`defs` 部分是選填的，它允許您定義可在主題中重複引用的可重複使用顏色。
+
+---
+
+### 終端機預設值
+
+特殊值 `"none"` 可用於任何顏色屬性，以繼承終端機的預設顏色。這在建立需要與終端機配色方案無縫融合的主題時特別有用：
+
+- `"text": "none"` — 使用終端機的預設前景色
+- `"background": "none"` — 使用終端機的預設背景色
+
+---
+
+### 範例
+
+以下是一個自訂主題的完整範例：
+
+```json title="my-theme.json"
+{
+  "$schema": "https://opencode.ai/theme.json",
+  "defs": {
+    "nord0": "#2E3440",
+    "nord1": "#3B4252",
+    "nord2": "#434C5E",
+    "nord3": "#4C566A",
+    "nord4": "#D8DEE9",
+    "nord5": "#E5E9F0",
+    "nord6": "#ECEFF4",
+    "nord7": "#8FBCBB",
+    "nord8": "#88C0D0",
+    "nord9": "#81A1C1",
+    "nord10": "#5E81AC",
+    "nord11": "#BF616A",
+    "nord12": "#D08770",
+    "nord13": "#EBCB8B",
+    "nord14": "#A3BE8C",
+    "nord15": "#B48EAD"
+  },
+  "theme": {
+    "primary": {
+      "dark": "nord8",
+      "light": "nord10"
+    },
+    "secondary": {
+      "dark": "nord9",
+      "light": "nord9"
+    },
+    "accent": {
+      "dark": "nord7",
+      "light": "nord7"
+    },
+    "error": {
+      "dark": "nord11",
+      "light": "nord11"
+    },
+    "warning": {
+      "dark": "nord12",
+      "light": "nord12"
+    },
+    "success": {
+      "dark": "nord14",
+      "light": "nord14"
+    },
+    "info": {
+      "dark": "nord8",
+      "light": "nord10"
+    },
+    "text": {
+      "dark": "nord4",
+      "light": "nord0"
+    },
+    "textMuted": {
+      "dark": "nord3",
+      "light": "nord1"
+    },
+    "background": {
+      "dark": "nord0",
+      "light": "nord6"
+    },
+    "backgroundPanel": {
+      "dark": "nord1",
+      "light": "nord5"
+    },
+    "backgroundElement": {
+      "dark": "nord1",
+      "light": "nord4"
+    },
+    "border": {
+      "dark": "nord2",
+      "light": "nord3"
+    },
+    "borderActive": {
+      "dark": "nord3",
+      "light": "nord2"
+    },
+    "borderSubtle": {
+      "dark": "nord2",
+      "light": "nord3"
+    },
+    "diffAdded": {
+      "dark": "nord14",
+      "light": "nord14"
+    },
+    "diffRemoved": {
+      "dark": "nord11",
+      "light": "nord11"
+    },
+    "diffContext": {
+      "dark": "nord3",
+      "light": "nord3"
+    },
+    "diffHunkHeader": {
+      "dark": "nord3",
+      "light": "nord3"
+    },
+    "diffHighlightAdded": {
+      "dark": "nord14",
+      "light": "nord14"
+    },
+    "diffHighlightRemoved": {
+      "dark": "nord11",
+      "light": "nord11"
+    },
+    "diffAddedBg": {
+      "dark": "#3B4252",
+      "light": "#E5E9F0"
+    },
+    "diffRemovedBg": {
+      "dark": "#3B4252",
+      "light": "#E5E9F0"
+    },
+    "diffContextBg": {
+      "dark": "nord1",
+      "light": "nord5"
+    },
+    "diffLineNumber": {
+      "dark": "nord2",
+      "light": "nord4"
+    },
+    "diffAddedLineNumberBg": {
+      "dark": "#3B4252",
+      "light": "#E5E9F0"
+    },
+    "diffRemovedLineNumberBg": {
+      "dark": "#3B4252",
+      "light": "#E5E9F0"
+    },
+    "markdownText": {
+      "dark": "nord4",
+      "light": "nord0"
+    },
+    "markdownHeading": {
+      "dark": "nord8",
+      "light": "nord10"
+    },
+    "markdownLink": {
+      "dark": "nord9",
+      "light": "nord9"
+    },
+    "markdownLinkText": {
+      "dark": "nord7",
+      "light": "nord7"
+    },
+    "markdownCode": {
+      "dark": "nord14",
+      "light": "nord14"
+    },
+    "markdownBlockQuote": {
+      "dark": "nord3",
+      "light": "nord3"
+    },
+    "markdownEmph": {
+      "dark": "nord12",
+      "light": "nord12"
+    },
+    "markdownStrong": {
+      "dark": "nord13",
+      "light": "nord13"
+    },
+    "markdownHorizontalRule": {
+      "dark": "nord3",
+      "light": "nord3"
+    },
+    "markdownListItem": {
+      "dark": "nord8",
+      "light": "nord10"
+    },
+    "markdownListEnumeration": {
+      "dark": "nord7",
+      "light": "nord7"
+    },
+    "markdownImage": {
+      "dark": "nord9",
+      "light": "nord9"
+    },
+    "markdownImageText": {
+      "dark": "nord7",
+      "light": "nord7"
+    },
+    "markdownCodeBlock": {
+      "dark": "nord4",
+      "light": "nord0"
+    },
+    "syntaxComment": {
+      "dark": "nord3",
+      "light": "nord3"
+    },
+    "syntaxKeyword": {
+      "dark": "nord9",
+      "light": "nord9"
+    },
+    "syntaxFunction": {
+      "dark": "nord8",
+      "light": "nord8"
+    },
+    "syntaxVariable": {
+      "dark": "nord7",
+      "light": "nord7"
+    },
+    "syntaxString": {
+      "dark": "nord14",
+      "light": "nord14"
+    },
+    "syntaxNumber": {
+      "dark": "nord15",
+      "light": "nord15"
+    },
+    "syntaxType": {
+      "dark": "nord7",
+      "light": "nord7"
+    },
+    "syntaxOperator": {
+      "dark": "nord9",
+      "light": "nord9"
+    },
+    "syntaxPunctuation": {
+      "dark": "nord4",
+      "light": "nord0"
+    }
+  }
+}
+```

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

@@ -0,0 +1,341 @@
+---
+title: 工具
+description: 管理 LLM 可以使用的工具。
+---
+
+工具允許 LLM 在您的程式碼庫中執行操作。OpenCode 自帶一組內建工具，您也可以透過[自訂工具](/docs/custom-tools)或 [MCP 伺服器](/docs/mcp-servers)來擴充它。
+
+預設情況下，所有工具都是**啟用**的，且無需權限即可執行。您可以透過[權限](/docs/permissions)來控制工具的行為。
+
+---
+
+## 設定
+
+使用 `permission` 欄位來控制工具行為。您可以對每個工具設定允許、拒絕或需要審批。
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "edit": "deny",
+    "bash": "ask",
+    "webfetch": "allow"
+  }
+}
+```
+
+您還可以使用萬用字元同時控制多個工具。例如，要求某個 MCP 伺服器的所有工具都需要審批：
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "mymcp_*": "ask"
+  }
+}
+```
+
+[了解更多](/docs/permissions)關於設定權限的內容。
+
+---
+
+## 內建工具
+
+以下是 OpenCode 中所有可用的內建工具。
+
+---
+
+### bash
+
+在專案環境中執行 shell 指令。
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "bash": "allow"
+  }
+}
+```
+
+該工具允許 LLM 執行終端機指令，例如 `npm install`、`git status` 或其他任何 shell 指令。
+
+---
+
+### edit
+
+透過精確的字串替換來修改現有檔案。
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "edit": "allow"
+  }
+}
+```
+
+該工具透過替換精確匹配的文字來對檔案進行編輯。這是 LLM 修改程式碼的主要方式。
+
+---
+
+### write
+
+建立新檔案或覆蓋現有檔案。
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "edit": "allow"
+  }
+}
+```
+
+使用此工具允許 LLM 建立新檔案。如果檔案已存在，則會覆蓋現有檔案。
+
+:::note
+`write` 工具由 `edit` 權限控制，該權限涵蓋所有檔案修改操作（`edit`、`write`、`patch`）。
+:::
+
+---
+
+### read
+
+讀取程式碼庫中的檔案內容。
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "read": "allow"
+  }
+}
+```
+
+該工具讀取檔案並回傳其內容。它支援對大檔案讀取指定行範圍。
+
+---
+
+### grep
+
+使用正規表示式搜尋檔案內容。
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "grep": "allow"
+  }
+}
+```
+
+在程式碼庫中快速搜尋內容。支援完整的正規表示式語法和檔案模式過濾。
+
+---
+
+### glob
+
+透過模式匹配查找檔案。
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "glob": "allow"
+  }
+}
+```
+
+使用 `**/*.js` 或 `src/**/*.ts` 等 glob 模式搜尋檔案。回傳按修改時間排序的匹配檔案路徑。
+
+---
+
+### lsp（實驗性）
+
+與已設定的 LSP 伺服器互動，取得程式碼智慧功能，如定義跳轉、參考查找、懸停資訊和呼叫階層結構。
+
+:::note
+該工具僅在設定 `OPENCODE_EXPERIMENTAL_LSP_TOOL=true`（或 `OPENCODE_EXPERIMENTAL=true`）時可用。
+:::
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "lsp": "allow"
+  }
+}
+```
+
+支援的操作包括 `goToDefinition`、`findReferences`、`hover`、`documentSymbol`、`workspaceSymbol`、`goToImplementation`、`prepareCallHierarchy`、`incomingCalls` 和 `outgoingCalls`。
+
+要設定專案可用的 LSP 伺服器，請參閱 [LSP 伺服器](/docs/lsp)。
+
+---
+
+### patch
+
+對檔案套用補丁。
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "edit": "allow"
+  }
+}
+```
+
+該工具將補丁檔案套用到您的程式碼庫中。適用於套用來自各種來源的 diff 和補丁。
+
+:::note
+`patch` 工具由 `edit` 權限控制，該權限涵蓋所有檔案修改操作（`edit`、`write`、`patch`）。
+:::
+
+---
+
+### skill
+
+載入一個[技能](/docs/skills)（即 `SKILL.md` 檔案）並在對話中回傳其內容。
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "skill": "allow"
+  }
+}
+```
+
+---
+
+### todowrite
+
+在編碼工作階段中管理待辦事項清單。
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "todowrite": "allow"
+  }
+}
+```
+
+建立和更新任務清單以追蹤複雜操作的進度。LLM 使用此工具來組織多步驟任務。
+
+:::note
+該工具預設對子代理停用，但您可以手動啟用。[了解更多](/docs/agents/#permissions)
+:::
+
+---
+
+### webfetch
+
+擷取網頁內容。
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "webfetch": "allow"
+  }
+}
+```
+
+允許 LLM 擷取並讀取網頁內容。適用於查閱文件或研究線上資源。
+
+---
+
+### websearch
+
+在網路上搜尋資訊。
+
+:::note
+該工具僅在使用 OpenCode 供應商時，或當 `OPENCODE_ENABLE_EXA` 環境變數設定為任意真值（例如 `true` 或 `1`）時可用。
+
+在啟動 OpenCode 時啟用：
+
+```bash
+OPENCODE_ENABLE_EXA=1 opencode
+```
+
+:::
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "websearch": "allow"
+  }
+}
+```
+
+使用 Exa AI 進行網路搜尋以查找相關資訊。適用於研究主題、了解時事動態或取得超出訓練資料截止日期的資訊。
+
+無需 API 金鑰——該工具無需身分驗證即可直接連接到 Exa AI 的託管 MCP 服務。
+
+:::tip
+當您需要查找資訊（發現）時使用 `websearch`，當您需要從特定 URL 擷取內容（檢索）時使用 `webfetch`。
+:::
+
+---
+
+### question
+
+在執行過程中向使用者提問。
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "question": "allow"
+  }
+}
+```
+
+該工具允許 LLM 在執行任務期間向使用者提問。適用於以下場景：
+
+- 收集使用者偏好或需求
+- 釐清模糊的指令
+- 取得實作方案的決策
+- 提供方向選擇的選項
+
+每個問題包含標題、問題正文和選項清單。使用者可以從提供的選項中選擇，也可以輸入自訂答案。當有多個問題時，使用者可以在提交所有答案之前在各問題之間切換瀏覽。
+
+---
+
+## 自訂工具
+
+自訂工具允許您定義 LLM 可以呼叫的自訂函式。這些函式在您的設定檔中定義，可以執行任意程式碼。
+
+[了解更多](/docs/custom-tools)關於建立自訂工具的內容。
+
+---
+
+## MCP 伺服器
+
+MCP（Model Context Protocol）伺服器允許您整合外部工具和服務，包括資料庫存取、API 整合和第三方服務。
+
+[了解更多](/docs/mcp-servers)關於設定 MCP 伺服器的內容。
+
+---
+
+## 內部機制
+
+在內部，`grep` 和 `glob` 等工具底層使用 [ripgrep](https://github.com/BurntSushi/ripgrep)。預設情況下，ripgrep 遵循 `.gitignore` 中的模式，這意味著 `.gitignore` 中列出的檔案和目錄將被排除在搜尋和列表結果之外。
+
+---
+
+### 忽略模式
+
+要包含通常會被忽略的檔案，請在專案根目錄下建立一個 `.ignore` 檔案。該檔案可以明確允許某些路徑。
+
+```text title=".ignore"
+!node_modules/
+!dist/
+!build/
+```
+
+例如，這個 `.ignore` 檔案允許 ripgrep 在 `node_modules/`、`dist/` 和 `build/` 目錄中進行搜尋，即使它們已在 `.gitignore` 中列出。