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

This commit is contained in:
Adam
2026-02-11 18:51:50 -06:00
parent 8eea53a41e
commit aea68c386a
484 changed files with 12718 additions and 11212 deletions
+39 -39
View File
@@ -1,29 +1,29 @@
---
title: 規則
description: 設置opencode的自定義指令。
description: 設定 opencode 的自定義指令。
---
您可以通過創建 `AGENTS.md` 文件來提供 opencode 的自定義指令。這和Cursor的規則類似。它包含將包含在 LLM 上下文中的說明,以便為您的特定項目自定義其行為。
您可以透過建立 `AGENTS.md` 檔案來提供 opencode 的自定義指令。這和 Cursor 的規則類似。它包含將包含在 LLM 上下文中的說明,以便為您的特定專案自定義其行為。
---
## 初始化
要創建新的`AGENTS.md`文件,您可以在opencode中運行`/init`命令。
要建立新的 `AGENTS.md` 檔案,您可以在 opencode 中執行 `/init` 指令。
:::tip
您應該將項目的 `AGENTS.md` 文件提交到 Git。
您應該將專案的 `AGENTS.md` 檔案提交到 Git。
:::
這將掃描您的項目及其所有內容,以了解該項目的內容並生成一個 `AGENTS.md` 文件。這有助於 opencode 更好地導航項目。
這將掃描您的專案及其所有內容,以了解該專案的內容並生成一個 `AGENTS.md` 檔案。這有助於 opencode 更好地導覽專案。
如果您有現有的 `AGENTS.md` 文件,這將嘗試添加到其中。
如果您有現有的 `AGENTS.md` 檔案,這將嘗試添加到其中。
---
## 例子
## 範例
您也可以手動創建此文件。以下是您可以放入 `AGENTS.md` 文件中的一些內容的示例。
您也可以手動建立此檔案。以下是您可以放入 `AGENTS.md` 檔案中的一些內容的範例。
```markdown title="AGENTS.md"
# SST v3 Monorepo Project
@@ -48,33 +48,33 @@ This is an SST v3 monorepo with TypeScript. The project uses bun workspaces for
- Import shared modules using workspace names: `@my-app/core/example`
```
我們在此處添加特定於項目的說明,這將在您的團隊中共享。
我們在此處添加特定於專案的說明,這將在您的團隊中共享。
---
## 類型
opencode 還支持從多個位置讀取 `AGENTS.md` 文件。這有不同的目的。
opencode 還支援從多個位置讀取 `AGENTS.md` 檔案。這有不同的目的。
### 專案
將 `AGENTS.md` 放置在項目根目錄中以獲取特定於項目的規則。這些僅適用於您在此目錄或其子目錄中工作時。
將 `AGENTS.md` 放置在專案根目錄中以獲取特定於專案的規則。這些僅適用於您在此目錄或其子目錄中工作時。
### 全球的
### 全域
您還可以在 `~/.config/opencode/AGENTS.md` 文件中包含全局規則。這適用於所有opencode會話。
您還可以在 `~/.config/opencode/AGENTS.md` 檔案中包含全域規則。這適用於所有 opencode 工作階段。
由於這未提交給 Git 或與您的團隊共享,因此我們建議使用它來指定 LLM 應遵循的任何個人規則。
### 克勞德程式碼兼容性
### Claude Code 相容性
對於從 Claude Code 遷移的用戶,opencode 支持 Claude Code 的文件約定作為後備:
對於從 Claude Code 遷移的使用者,opencode 支援 Claude Code 的檔案慣例作為備援:
- **項目規則**:項目目錄中的`CLAUDE.md`(如果`AGENTS.md`不存在則使用)
- **全局規則**:`~/.claude/CLAUDE.md`(如果不存在`~/.config/opencode/AGENTS.md`則使用)
- **技能**:`~/.claude/skills/` — 詳情請參閱[代理技巧](/docs/skills/)
- **專案規則**:專案目錄中的 `CLAUDE.md`(如果 `AGENTS.md` 不存在則使用)
- **全域規則**:`~/.claude/CLAUDE.md`(如果不存在 `~/.config/opencode/AGENTS.md` 則使用)
- **技能**:`~/.claude/skills/` — 詳情請參閱 [代理技能](/docs/skills/)
要禁用 Claude Code 兼容性,請設置以下環境變量之一:
要禁用 Claude Code 相容性,請設定以下環境變數之一:
```bash
export OPENCODE_DISABLE_CLAUDE_CODE=1 # Disable all .claude support
@@ -84,23 +84,23 @@ export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills
---
## 優先級
## 優先順序
當 opencode 啟動時,它會按以下順序查找規則文件:
當 opencode 啟動時,它會按以下順序尋找規則檔案:
1. **本地文件**,從當前目錄向上遍歷(`AGENTS.md`,`CLAUDE.md`)
2. **全局文件** `~/.config/opencode/AGENTS.md`
3. **克勞德程式碼文件**位於`~/.claude/CLAUDE.md`(除非禁用)
1. **本地檔案**,從當前目錄向上遍歷 (`AGENTS.md`,`CLAUDE.md`)
2. **全域檔案** `~/.config/opencode/AGENTS.md`
3. **Claude Code 檔案** 位於 `~/.claude/CLAUDE.md`(除非禁用)
第一個匹配的文件在每個類別中獲勝。例如,如果您同時擁有`AGENTS.md` 和`CLAUDE.md`,則僅使用`AGENTS.md`。同樣,`~/.config/opencode/AGENTS.md` 優先於`~/.claude/CLAUDE.md`。
第一個匹配的檔案在每個類別中獲勝。例如,如果您同時擁有 `AGENTS.md` 和 `CLAUDE.md`,則僅使用 `AGENTS.md`。同樣,`~/.config/opencode/AGENTS.md` 優先於 `~/.claude/CLAUDE.md`。
---
## 定制說明
## 自定義指令
您可以在 `opencode.json` 或全局 `~/.config/opencode/opencode.json` 中指定自定義指令文件。這允許您和您的團隊重用現有規則,而不必將它們複製到 AGENTS.md。
您可以在 `opencode.json` 或全域 `~/.config/opencode/opencode.json` 中指定自定義指令檔案。這允許您和您的團隊重複使用現有規則,而不必將它們複製到 AGENTS.md。
例子:
範例:
```json title="opencode.json"
{
@@ -109,7 +109,7 @@ export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills
}
```
您還可以使用遠程 URL 從 Web 加載說明。
您還可以使用遠端 URL 從 Web 載入指令。
```json title="opencode.json"
{
@@ -118,19 +118,19 @@ export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills
}
```
遠程指令的獲取有 5 秒的超時時間。
遠端指令的獲取有 5 秒的超時時間。
所有說明文件均與您的`AGENTS.md` 文件合併。
所有指令檔案均與您的 `AGENTS.md` 檔案合併。
---
## 引用外部文件
## 引用外部檔案
雖然 opencode 不會自動解析 `AGENTS.md` 中的文件引用,但您可以通過兩種方式實現類似的功能:
雖然 opencode 不會自動解析 `AGENTS.md` 中的檔案引用,但您可以透過兩種方式實現類似的功能:
### 使用 opencode.json
推薦的方法是在`instructions`中使用`opencode.json`字段:
推薦的方法是在 `instructions` 中使用 `opencode.json` 欄位:
```json title="opencode.json"
{
@@ -141,7 +141,7 @@ export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills
### AGENTS.md 中的手動說明
您可以通過在 `AGENTS.md` 中提供明確的指令來教 opencode 讀取外部文件。這是一個實際的例子:
您可以透過在 `AGENTS.md` 中提供明確的指令來教 opencode 讀取外部檔案。這是一個實際的範例:
```markdown title="AGENTS.md"
# TypeScript Project Rules
@@ -170,11 +170,11 @@ Read the following file immediately as it's relevant to all workflows: @rules/ge
這種方法允許您:
- 創建模塊化、可重用的規則文件
- 通過符號連結或 git 子模塊在項目之間共享規則
- 建立模組化、可重複使用的規則檔案
- 透過符號連結或 git 子模組在專案之間共享規則
- 保持 AGENTS.md 簡潔,同時參考詳細指南
- 確保 opencode 僅在特定任務需要時加載文件
- 確保 opencode 僅在特定任務需要時載入檔案
:::tip
對於 monorepos 或具有共享標準的項目,使用 `opencode.json` 和 glob 模式(如 `packages/*/AGENTS.md`)比手動指令更易於維護。
對於 Monorepos 或具有共享標準的專案,使用 `opencode.json` 和 glob 模式(如 `packages/*/AGENTS.md`)比手動指令更易於維護。
:::