diff --git a/infra/console.ts b/infra/console.ts index 5abffb555..4e5a14b04 100644 --- a/infra/console.ts +++ b/infra/console.ts @@ -166,14 +166,10 @@ const bucketNew = new sst.cloudflare.Bucket("ZenDataNew") const AWS_SES_ACCESS_KEY_ID = new sst.Secret("AWS_SES_ACCESS_KEY_ID") const AWS_SES_SECRET_ACCESS_KEY = new sst.Secret("AWS_SES_SECRET_ACCESS_KEY") -let logProcessor -if ($app.stage === "production" || $app.stage === "frank") { - const HONEYCOMB_API_KEY = new sst.Secret("HONEYCOMB_API_KEY") - logProcessor = new sst.cloudflare.Worker("LogProcessor", { - handler: "packages/console/function/src/log-processor.ts", - link: [HONEYCOMB_API_KEY], - }) -} +const logProcessor = new sst.cloudflare.Worker("LogProcessor", { + handler: "packages/console/function/src/log-processor.ts", + link: [new sst.Secret("HONEYCOMB_API_KEY")], +}) new sst.cloudflare.x.SolidStart("Console", { domain, @@ -211,7 +207,7 @@ new sst.cloudflare.x.SolidStart("Console", { transform: { worker: { placement: { mode: "smart" }, - tailConsumers: logProcessor ? [{ service: logProcessor.nodes.worker.scriptName }] : [], + tailConsumers: [{ service: logProcessor.nodes.worker.scriptName }], }, }, }, diff --git a/packages/app/e2e/sidebar/sidebar-popover-actions.spec.ts b/packages/app/e2e/sidebar/sidebar-popover-actions.spec.ts new file mode 100644 index 000000000..e37f94f3a --- /dev/null +++ b/packages/app/e2e/sidebar/sidebar-popover-actions.spec.ts @@ -0,0 +1,36 @@ +import { test, expect } from "../fixtures" +import { closeSidebar, hoverSessionItem } from "../actions" +import { projectSwitchSelector, sessionItemSelector } from "../selectors" + +test("collapsed sidebar popover stays open when archiving a session", async ({ page, slug, sdk, gotoSession }) => { + const stamp = Date.now() + + const one = await sdk.session.create({ title: `e2e sidebar popover archive 1 ${stamp}` }).then((r) => r.data) + const two = await sdk.session.create({ title: `e2e sidebar popover archive 2 ${stamp}` }).then((r) => r.data) + + if (!one?.id) throw new Error("Session create did not return an id") + if (!two?.id) throw new Error("Session create did not return an id") + + try { + await gotoSession(one.id) + await closeSidebar(page) + + const project = page.locator(projectSwitchSelector(slug)).first() + await expect(project).toBeVisible() + await project.hover() + + await expect(page.locator(sessionItemSelector(one.id)).first()).toBeVisible() + await expect(page.locator(sessionItemSelector(two.id)).first()).toBeVisible() + + const item = await hoverSessionItem(page, one.id) + await item + .getByRole("button", { name: /archive/i }) + .first() + .click() + + await expect(page.locator(sessionItemSelector(two.id)).first()).toBeVisible() + } finally { + await sdk.session.delete({ sessionID: one.id }).catch(() => undefined) + await sdk.session.delete({ sessionID: two.id }).catch(() => undefined) + } +}) diff --git a/packages/app/src/components/session/session-header.tsx b/packages/app/src/components/session/session-header.tsx index 18b607b96..94b843666 100644 --- a/packages/app/src/components/session/session-header.tsx +++ b/packages/app/src/components/session/session-header.tsx @@ -166,6 +166,7 @@ export function SessionHeader() { }) const [prefs, setPrefs] = persisted(Persist.global("open.app"), createStore({ app: "finder" as OpenApp })) + const [menu, setMenu] = createStore({ open: false }) const canOpen = createMemo(() => platform.platform === "desktop" && !!platform.openPath && server.isLocal()) const current = createMemo(() => options().find((o) => o.id === prefs.app) ?? options()[0]) @@ -355,7 +356,12 @@ export function SessionHeader() { Open
-Agent[] |
@@ -169,7 +169,7 @@ const agents = await client.app.agents()
### Progetto
-| Metodo | Descrizione | Response |
+| Metodo | Descrizione | Risposta |
| ------------------- | ----------------- | --------------------------------------------- |
| `project.list()` | Elenca i progetti | Project[] |
| `project.current()` | Progetto corrente | Project |
@@ -190,7 +190,7 @@ const currentProject = await client.project.current()
### Path
-| Metodo | Descrizione | Response |
+| Metodo | Descrizione | Risposta |
| ------------ | ----------------- | ---------------------------------------- |
| `path.get()` | Percorso corrente | Path |
@@ -207,7 +207,7 @@ const pathInfo = await client.path.get()
### Config
-| Metodo | Descrizione | Response |
+| Metodo | Descrizione | Risposta |
| -------------------- | --------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `config.get()` | Ottieni info config | Config |
| `config.providers()` | Elenca provider e modelli default | `{ providers: `Provider[]`, default: { [key: string]: string } }` |
@@ -283,7 +283,7 @@ await client.session.prompt({
### File
-| Metodo | Descrizione | Response |
+| Metodo | Descrizione | Risposta |
| ------------------------- | ------------------------------- | ------------------------------------------------------------------------------------------- |
| `find.text({ query })` | Cerca testo nei file | Array of match objects with `path`, `lines`, `line_number`, `absolute_offset`, `submatches` |
| `find.files({ query })` | Trova file e directory per nome | `string[]` (paths) |
@@ -324,7 +324,7 @@ const content = await client.file.read({
### TUI
-| Metodo | Descrizione | Response |
+| Metodo | Descrizione | Risposta |
| ------------------------------ | -------------------------- | --------- |
| `tui.appendPrompt({ body })` | Aggiunge testo al prompt | `boolean` |
| `tui.openHelp()` | Apre la finestra help | `boolean` |
@@ -355,7 +355,7 @@ await client.tui.showToast({
### Autenticazione
-| Metodo | Descrizione | Response |
+| Metodo | Descrizione | Risposta |
| ------------------- | ------------------------ | --------- |
| `auth.set({ ... })` | Imposta credenziali auth | `boolean` |
@@ -374,7 +374,7 @@ await client.auth.set({
### Eventi
-| Metodo | Descrizione | Response |
+| Metodo | Descrizione | Risposta |
| ------------------- | ---------------------------- | ---------------------------- |
| `event.subscribe()` | Stream di server-sent events | Stream di server-sent events |
diff --git a/packages/web/src/content/docs/it/troubleshooting.mdx b/packages/web/src/content/docs/it/troubleshooting.mdx
index 8105f7d3c..81c01ec37 100644
--- a/packages/web/src/content/docs/it/troubleshooting.mdx
+++ b/packages/web/src/content/docs/it/troubleshooting.mdx
@@ -269,7 +269,7 @@ Questo forzera opencode a scaricare le versioni piu recenti dei pacchetti provid
---
-### Copy/paste not working on Linux
+### Copia/incolla non funziona su Linux
Su Linux e necessario avere installata una delle seguenti utility per gli appunti affinche copia/incolla funzioni:
diff --git a/packages/web/src/content/docs/ja/1-0.mdx b/packages/web/src/content/docs/ja/1-0.mdx
index 1d56ede2c..ff8747bf5 100644
--- a/packages/web/src/content/docs/ja/1-0.mdx
+++ b/packages/web/src/content/docs/ja/1-0.mdx
@@ -46,22 +46,22 @@ $ kilo upgrade 0.15.31
### キーバインドの名前が変更されました
-- メッセージを元に戻す -> メッセージを元に戻す
-- スイッチエージェント -> エージェントサイクル
-- スイッチ*エージェント*リバース -> エージェント*サイクル*リバース
-- スイッチモード -> エージェントサイクル
-- スイッチモードリバース -> エージェントサイクルリバース
+- messages_revert -> messages_undo
+- switch_agent -> agent_cycle
+- switch_agent_reverse -> agent_cycle_reverse
+- switch_mode -> agent_cycle
+- switch_mode_reverse -> agent_cycle_reverse
### キーバインドが削除されました
-- メッセージ*レイアウト*トグル
-- メッセージ\_次
-- メッセージ\_前
+- messages_layout_toggle
+- messages_next
+- messages_previous
- file_diff_toggle
-- ファイル検索
-- ファイル\_閉じる
-- ファイルリスト
-- アプリヘルプ
-- プロジェクト初期化
-- ツールの詳細
-- 思考ブロック
+- file_search
+- file_close
+- file_list
+- app_help
+- project_init
+- tool_details
+- thinking_blocks
diff --git a/packages/web/src/content/docs/ja/acp.mdx b/packages/web/src/content/docs/ja/acp.mdx
index 40a15c27e..8d7607798 100644
--- a/packages/web/src/content/docs/ja/acp.mdx
+++ b/packages/web/src/content/docs/ja/acp.mdx
@@ -22,7 +22,7 @@ ACP 経由で Kilo を使用するには、`opencode acp` コマンドを実行
---
-### ゼッド
+### Zed
[Zed](https://zed.dev) 構成 (`~/.config/zed/settings.json`) に追加します。
@@ -68,7 +68,7 @@ ACP 経由で Kilo を使用するには、`opencode acp` コマンドを実行
### JetBrains IDE
-[documentation](https://www.jetbrains.com/help/ai-assistant/acp.html):] に従って、[JetBrains IDE](https://www.jetbrains.com/) acp.json] に追加します。
+[documentation](https://www.jetbrains.com/help/ai-assistant/acp.html) に従って、[JetBrains IDE](https://www.jetbrains.com/) acp.json に追加します:
```json title="acp.json"
{
@@ -85,7 +85,7 @@ ACP 経由で Kilo を使用するには、`opencode acp` コマンドを実行
---
-### アバンテ.nvim
+### Avante.nvim
[Avante.nvim](https://github.com/yetone/avante.nvim) 設定に追加:
@@ -137,7 +137,7 @@ require("codecompanion").setup({
この構成は、Kilo をチャットの ACP エージェントとして使用するように CodeCompanion をセットアップします。
-環境変数 (`OPENCODE_API_KEY` など) を渡す必要がある場合、詳細については、CodeCompanion.nvim ドキュメントの「アダプターの構成: 環境変数 ](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key)」を参照してください。
+環境変数 (`OPENCODE_API_KEY` など) を渡す必要がある場合、詳細については、CodeCompanion.nvim ドキュメントの「[アダプターの構成: 環境変数](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key)」を参照してください。
## サポート
diff --git a/packages/web/src/content/docs/ja/agents.mdx b/packages/web/src/content/docs/ja/agents.mdx
index 699d4d167..60b794888 100644
--- a/packages/web/src/content/docs/ja/agents.mdx
+++ b/packages/web/src/content/docs/ja/agents.mdx
@@ -8,7 +8,7 @@ description: 特殊なエージェントを構成して使用します。
:::tip
プラン エージェントを使用すると、コードを変更せずにコードを分析し、提案を確認できます。
:::
-You メンションを使用してエージェントを呼び出すこともできます。
+You can switch between agents during a session or invoke them with the `@` mention.
---
@@ -25,8 +25,7 @@ Kilo には 2 種類のエージェントがあります。プライマリエー
:::tip
**Tab** キーを使用して、セッション中にプライマリ エージェントを切り替えることができます。
:::
-Kilo には、**Build** と **Plan** という 2 つの組み込みプライマリ エージェントが付属しています。良い
-以下を見てください。
+Kilo には、**Build** と **Plan** という 2 つの組み込みプライマリ エージェントが付属しています。これらについて以下で説明します。
---
@@ -68,7 +67,7 @@ _モード_: `primary`
### 一般的な使用
-_モード_: `primary`
+_モード_: `subagent`
複雑な質問を調査し、複数ステップのタスクを実行するための汎用エージェント。完全なツール アクセス権 (todo を除く) があるため、必要に応じてファイルを変更できます。これを使用して、複数の作業単位を並行して実行します。
@@ -76,7 +75,7 @@ _モード_: `primary`
### 探索を使用する
-_モード_: `primary`
+_モード_: `subagent`
コードベースを探索するための高速な読み取り専用エージェント。ファイルを変更できません。これは、パターンでファイルをすばやく検索したり、コードでキーワードを検索したり、コードベースに関する質問に答えたりする必要がある場合に使用します。
@@ -539,7 +538,7 @@ Only analyze code and suggest changes.
### 隠れた
-`hidden: true` を使用して、`@` オートコンプリート メニューからサブエージェントを非表示にします。他のエージェントによってタスク ツールを介してプログラム的にのみ呼び出す必要がある内部サブエージェントに役立ちます。
+`@` を使用して、`hidden: true` オートコンプリート メニューからサブエージェントを非表示にします。他のエージェントによってタスク ツールを介してプログラム的にのみ呼び出す必要がある内部サブエージェントに役立ちます。
```json title="opencode.json"
{
diff --git a/packages/web/src/content/docs/ja/cli.mdx b/packages/web/src/content/docs/ja/cli.mdx
index 61dfe9b32..403bc2fb9 100644
--- a/packages/web/src/content/docs/ja/cli.mdx
+++ b/packages/web/src/content/docs/ja/cli.mdx
@@ -19,7 +19,7 @@ opencode run "Explain how closures work in JavaScript"
---
-### トゥイ
+### tui
Kilo terminal ユーザー インターフェイスを開始します。
@@ -27,18 +27,18 @@ Kilo terminal ユーザー インターフェイスを開始します。
opencode [project]
```
-#### フラグ
+#### Flags
-| 旗 | ショート | 説明 |
-| ------------ | -------- | --------------------------------------------------------------------- |
-| `--continue` | `-c` | 最後のセッションを続行 |
-| `--fork` | | 続行時にセッションをフォーク (`--continue` または `--session` と併用) |
-| `--session` | `-s` | 続行するセッション ID |
-| `--prompt` | | 使用のプロンプト |
-| `--model` | `-m` | プロバイダー/モデルの形式で使用するモデル |
-| `--agent` | | 使用するエージェント |
-| `--port` | | リッスンするポート |
-| `--hostname` | | リッスンするホスト名 |
+| Flag | Short | Description |
+| ------------ | ----------- | ---------------------------------------------------------- |
+| `--continue` | `-c` | 最後のセッションを続行 |
+| `--session` | | 続行時にセッションをフォーク (`-s` または `--fork` と併用) |
+| `--continue` | `--session` | 続行するセッション ID |
+| `--prompt` | | 使用のプロンプト |
+| `--model` | `-m` | プロバイダー/モデルの形式で使用するモデル |
+| `--agent` | | 使用するエージェント |
+| `--port` | | リッスンするポート |
+| `--hostname` | | リッスンするホスト名 |
---
@@ -48,7 +48,7 @@ Kilo CLI には次のコマンドもあります。
---
-### エージェント
+### agent
Kilo のエージェントを管理します。
@@ -58,7 +58,7 @@ opencode agent [command]
---
-### 付ける
+### attach
`serve` または `web` コマンドを使用して起動された、すでに実行中の Kilo バックエンド サーバーにterminal を接続します。
@@ -76,16 +76,16 @@ opencode web --port 4096 --hostname 0.0.0.0
opencode attach http://10.20.30.40:4096
```
-#### フラグ
+#### Flags
-| 旗 | ショート | 説明 |
-| ----------- | -------- | ------------------------------ |
-| `--dir` | | TUI を開始する作業ディレクトリ |
-| `--session` | `-s` | 続行するセッション ID |
+| Flag | Short | Description |
+| ----------- | ----- | ------------------------------ |
+| `--dir` | | TUI を開始する作業ディレクトリ |
+| `--session` | `-s` | 続行するセッション ID |
---
-#### 作成する
+#### create
カスタム構成で新しいエージェントを作成します。
@@ -97,7 +97,7 @@ opencode agent create
---
-#### リスト
+#### list
利用可能なエージェントをすべてリストします。
@@ -107,7 +107,7 @@ opencode agent list
---
-### 認証
+### auth
プロバイダーの資格情報とログインを管理するコマンド。
@@ -117,7 +117,7 @@ kilo auth [command]
---
-#### ログイン
+#### login
Kilo は [Models.dev](https://models.dev) のプロバイダー リストを利用しているため、`kilo auth login` を使用して、使用したいプロバイダーの API キーを構成できます。これは`~/.local/share/opencode/auth.json`に保存されます。
@@ -129,7 +129,7 @@ Kilo が起動すると、認証情報ファイルからプロバイダーがロ
---
-#### リスト
+#### list
認証情報ファイルに保存されているすべての認証されたプロバイダーをリストします。
@@ -145,7 +145,7 @@ kilo auth ls
---
-#### ログアウト
+#### logout
資格情報ファイルからプロバイダーをクリアすることで、プロバイダーからログアウトします。
@@ -155,7 +155,7 @@ kilo auth logout
---
-### GitHub
+### github
リポジトリ自動化のための GitHub エージェントを管理します。
@@ -165,7 +165,7 @@ opencode github [command]
---
-#### インストール
+#### install
GitHub エージェントをリポジトリにインストールします。
@@ -177,7 +177,7 @@ opencode github install
---
-#### 走る
+#### run
GitHub エージェントを実行します。これは通常、GitHub Actions で使用されます。
@@ -185,9 +185,9 @@ GitHub エージェントを実行します。これは通常、GitHub Actions
opencode github run
```
-##### フラグ
+##### Flags
-| 旗 | 説明 |
+| Flag | Description |
| --------- | --------------------------------------------------- |
| `--event` | エージェントを実行するための GitHub モック イベント |
| `--token` | GitHub個人アクセストークン |
@@ -204,7 +204,7 @@ opencode mcp [command]
---
-#### 追加
+#### add
MCP サーバーを構成に追加します。
@@ -216,7 +216,7 @@ opencode mcp add
---
-#### リスト
+#### list
構成されているすべての MCP サーバーとその接続ステータスをリストします。
@@ -232,7 +232,7 @@ opencode mcp ls
---
-#### 認証
+#### auth
OAuth 対応の MCP サーバーで認証します。
@@ -256,7 +256,7 @@ opencode mcp auth ls
---
-#### ログアウト
+#### logout
MCP サーバーの OAuth 資格情報を削除します。
@@ -266,7 +266,7 @@ opencode mcp logout [name]
---
-#### デバッグ
+#### debug
MCP サーバーの OAuth 接続の問題をデバッグします。
@@ -276,7 +276,7 @@ opencode mcp debug Message`, parts: `Part[]`}` |
| `session.prompt({ path, body })` | prompt 메시지 보내기 | `body.noReply: true` 반환 UserMessage (콘텍스트 전용). 기본 반환 AssistantMessage 에 AI 응답 |
| `session.command({ path, body })` | 세션으로 명령을 전송 | `{ info: `AssistantMessage`, parts: `Part[]`}` |
-| `session.shell({ path, body })` | 쉘 명령을 실행 | AssistantMessage |
+| `session.shell({ path, body })` | shell 명령을 실행 | AssistantMessage |
| `session.revert({ path, body })` | 메시지 다시 변환 | Session |
| `session.unrevert({ path })` | 통일된 메시지 | 반품 Session |
| `postSessionByIdPermissionsByPermissionId({ path, body })` | 허가 요청 대응 | 반품 `boolean` |
diff --git a/packages/web/src/content/docs/ko/server.mdx b/packages/web/src/content/docs/ko/server.mdx
index 2bddecfe2..74eeb145d 100644
--- a/packages/web/src/content/docs/ko/server.mdx
+++ b/packages/web/src/content/docs/ko/server.mdx
@@ -177,7 +177,7 @@ opencode 서버는 다음과 같은 API를 노출합니다.
| `GET` | `/session/:id/message/:messageID` | 메시지 보내기 | `{ info: `Message`, parts: `Part[]`}` |
| `POST` | `/session/:id/prompt_async` | 비동기적으로 메시지 보내기 | 몸: `/session/:id/message`와 동일, `204 No Content`를 반환 |
| `POST` | `/session/:id/command` | 슬래시 명령어 실행 | 본체: `{ messageID?, agent?, model?, command, arguments }`, 반환 `{ info: `Message`, parts: `Part[]`}` |
-| `POST` | `/session/:id/shell` | 쉘 명령 실행 | 체: `{ agent, model?, command }`, 반환 `{ info: `Message`, parts: `Part[]`}` |
+| `POST` | `/session/:id/shell` | shell 명령 실행 | 체: `{ agent, model?, command }`, 반환 `{ info: `Message`, parts: `Part[]`}` |
---
diff --git a/packages/web/src/content/docs/ko/skills.mdx b/packages/web/src/content/docs/ko/skills.mdx
index 28964692a..36cab78c2 100644
--- a/packages/web/src/content/docs/ko/skills.mdx
+++ b/packages/web/src/content/docs/ko/skills.mdx
@@ -25,7 +25,7 @@ opencode 이 위치를 검색:
## 발견의 이해
Project-local paths의 경우, opencode는 git worktree에 도달 할 때까지 현재 작업 디렉토리에서 걷습니다.
-그것은 `.opencode/`에 있는 어떤 어울리는 `skills/*/SKILL.md` 및 어떤 어울리는 `.claude/skills/*/SKILL.md` 또는 `.agents/skills/*/SKILL.md`를 방법 적재합니다.
+그것은 `skills/*/SKILL.md`에 있는 어떤 어울리는 `.opencode/` 및 어떤 어울리는 `.claude/skills/*/SKILL.md` 또는 `.agents/skills/*/SKILL.md`를 방법 적재합니다.
세계적인 정의는 또한 `~/.config/opencode/skills/*/SKILL.md`, `~/.claude/skills/*/SKILL.md` 및 `~/.agents/skills/*/SKILL.md`에서 적재됩니다.
diff --git a/packages/web/src/content/docs/ko/themes.mdx b/packages/web/src/content/docs/ko/themes.mdx
index 0854c6816..3c406d50a 100644
--- a/packages/web/src/content/docs/ko/themes.mdx
+++ b/packages/web/src/content/docs/ko/themes.mdx
@@ -15,7 +15,7 @@ opencode를 사용하면 여러 내장 테마 중 하나에서 선택할 수 있
-**체크 지원**: `echo $COLORTERM` - 그것은 `truecolor` 또는 `24bit`를 출력해야 합니다
-- ** truecolor 사용 가능**: 쉘 프로파일에서 환경 변수 `COLORTERM=truecolor`를 설정
+- ** truecolor 사용 가능**: shell 프로파일에서 환경 변수 `COLORTERM=truecolor`를 설정
- **Terminal 호환성 **: terminal 에뮬레이터 지원 24 비트 색상 (iTerm2, Alacritty, Kitty, Windows Terminal 및 GNOME Terminal의 최신 버전)
truecolor 지원 없이, 테마는 감소된 색깔 정확도로 나타날지도 모릅니다 또는 가장 가까운 256 색깔 대류로 뒤떨어질지도 모릅니다.
diff --git a/packages/web/src/content/docs/ko/tools.mdx b/packages/web/src/content/docs/ko/tools.mdx
index ba538b047..015cac488 100644
--- a/packages/web/src/content/docs/ko/tools.mdx
+++ b/packages/web/src/content/docs/ko/tools.mdx
@@ -47,7 +47,7 @@ description: Manage the tools an LLM can use.
###### bash
-프로젝트 환경에서 쉘 명령을 실행합니다.
+프로젝트 환경에서 shell 명령을 실행합니다.
```json title="opencode.json" {4}
{
@@ -58,7 +58,7 @@ description: Manage the tools an LLM can use.
}
```
-이 도구는 `npm install`, `git status` 또는 다른 쉘 명령과 같은 terminal 명령을 실행하는 LLM을 허용합니다.
+이 도구는 `npm install`, `git status` 또는 다른 shell 명령과 같은 terminal 명령을 실행하는 LLM을 허용합니다.
---
diff --git a/packages/web/src/content/docs/ko/troubleshooting.mdx b/packages/web/src/content/docs/ko/troubleshooting.mdx
index ec4c6afed..05447a739 100644
--- a/packages/web/src/content/docs/ko/troubleshooting.mdx
+++ b/packages/web/src/content/docs/ko/troubleshooting.mdx
@@ -47,7 +47,7 @@ opencode 데스크톱은 배경에서 로컬 opencode 서버 (`opencode-cli` sid
- 완전히 종료하고 앱을 다시 시작.
- 앱이 오류 화면을 보여 주면 ** Restart**를 클릭하고 오류 세부 정보를 복사합니다.
-- macOS만: `opencode` 메뉴 -> **웹뷰 **(UI가 공백/frozen인 경우).
+- macOS만: `Kilo` 메뉴 -> **웹뷰 **(UI가 공백/frozen인 경우).
---
diff --git a/packages/web/src/content/docs/ko/tui.mdx b/packages/web/src/content/docs/ko/tui.mdx
index cebea16a7..cc3a1c06c 100644
--- a/packages/web/src/content/docs/ko/tui.mdx
+++ b/packages/web/src/content/docs/ko/tui.mdx
@@ -45,7 +45,7 @@ How is auth handled in @packages/functions/src/api/index.ts?
## Bash 명령
-`!`를 사용하여 쉘 명령을 실행합니다.
+`!`를 사용하여 shell 명령을 실행합니다.
```bash frame="none"
!ls -la
@@ -301,7 +301,7 @@ Unshare 현재 세션. [더 알아보기](/docs/share#un-sharing).
export EDITOR="code --wait"
```
-영원한 만들기 위하여, 당신의 포탄 단면도에 이것을 추가하십시오;
+영원한 만들기 위하여, 당신의 shell 프로파일에 이것을 추가하십시오;
`~/.bashrc`, `~/.zshrc`, 등.
Message`, parts: `Part[]`}[]` |
| `session.message({ path })` | Obter detalhes da mensagem | Retorna `{ info: `Message`, parts: `Part[]`}` |
-| `session.prompt({ path, body })` | Enviar mensagem de prompt | `body.noReply: true` retorna UserMessage (apenas contexto). O padrão retorna AssistantMessage com resposta da IA |
+| `session.prompt({ path, body })` | Enviar mensagem de prompt | `body.noReply: true` retorna UserMessage (apenas contexto). O padrão retorna AssistantMessage com resposta da AI |
| `session.command({ path, body })` | Enviar comando para a sessão | Retorna `{ info: `AssistantMessage`, parts: `Part[]`}` |
| `session.shell({ path, body })` | Executar um comando shell | Retorna AssistantMessage |
| `session.revert({ path, body })` | Reverter uma mensagem | Retorna Session |
@@ -253,28 +253,28 @@ const { providers, default: defaults } = await client.config.providers()
#### Exemplos
```javascript
-// Criar e gerenciar sessões
+// Create and manage sessions
const session = await client.session.create({
- body: { title: "Minha sessão" },
+ body: { title: "My session" },
})
const sessions = await client.session.list()
-// Enviar uma mensagem de prompt
+// Send a prompt message
const result = await client.session.prompt({
path: { id: session.id },
body: {
model: { providerID: "anthropic", modelID: "claude-3-5-sonnet-20241022" },
- parts: [{ type: "text", text: "Olá!" }],
+ parts: [{ type: "text", text: "Hello!" }],
},
})
-// Injetar contexto sem acionar resposta da IA (útil para plugins)
+// Inject context without triggering AI response (useful for plugins)
await client.session.prompt({
path: { id: session.id },
body: {
noReply: true,
- parts: [{ type: "text", text: "Você é um assistente útil." }],
+ parts: [{ type: "text", text: "You are a helpful assistant." }],
},
})
```
@@ -302,7 +302,7 @@ await client.session.prompt({
#### Exemplos
```javascript
-// Pesquisar e ler arquivos
+// Search and read files
const textResults = await client.find.text({
query: { pattern: "function.*opencode" },
})
@@ -341,13 +341,13 @@ const content = await client.file.read({
#### Exemplos
```javascript
-// Controlar a interface TUI
+// Control TUI interface
await client.tui.appendPrompt({
- body: { text: "Adicione isso ao prompt" },
+ body: { text: "Add this to prompt" },
})
await client.tui.showToast({
- body: { message: "Tarefa concluída", variant: "success" },
+ body: { message: "Task completed", variant: "success" },
})
```
@@ -366,7 +366,7 @@ await client.tui.showToast({
```javascript
await client.auth.set({
path: { id: "anthropic" },
- body: { type: "api", key: "sua-chave-api" },
+ body: { type: "api", key: "your-api-key" },
})
```
@@ -383,9 +383,9 @@ await client.auth.set({
#### Exemplos
```javascript
-// Ouvir eventos em tempo real
+// Listen to real-time events
const events = await client.event.subscribe()
for await (const event of events.stream) {
- console.log("Evento:", event.type, event.properties)
+ console.log("Event:", event.type, event.properties)
}
```
diff --git a/packages/web/src/content/docs/pt-br/server.mdx b/packages/web/src/content/docs/pt-br/server.mdx
index 7a18a4416..e152bd84f 100644
--- a/packages/web/src/content/docs/pt-br/server.mdx
+++ b/packages/web/src/content/docs/pt-br/server.mdx
@@ -13,7 +13,7 @@ O comando `kilo serve` executa um servidor HTTP sem cabeça que expõe um endpoi
### Uso
```bash
-kilo serve [--port ตัวแทน[] |
@@ -169,7 +169,7 @@ const agents = await client.app.agents()
### โครงการ
-| วิธี | คำอธิบาย | การตอบสนอง |
+| Method | คำอธิบาย | การตอบสนอง |
| ------------------- | ------------------------ | --------------------------------------------- |
| `project.list()` | แสดงรายการโครงการทั้งหมด | Project[] |
| `project.current()` | รับโครงการปัจจุบัน | Project |
@@ -190,7 +190,7 @@ const currentProject = await client.project.current()
### เส้นทาง
-| วิธี | คำอธิบาย | การตอบสนอง |
+| Method | คำอธิบาย | การตอบสนอง |
| ------------ | ------------------ | ---------------------------------------- |
| `path.get()` | รับเส้นทางปัจจุบัน | Path |
@@ -207,7 +207,7 @@ const pathInfo = await client.path.get()
### การกำหนดค่า
-| วิธี | คำอธิบาย | การตอบสนอง |
+| Method | คำอธิบาย | การตอบสนอง |
| -------------------- | ----------------------------------- | --------------------------------------------------------------------------------------------------------- |
| `config.get()` | รับข้อมูลการกำหนดค่า | กำหนดค่า |
| `config.providers()` | ผู้ให้บริการรายชื่อและโมเดลเริ่มต้น | `{ providers: `ผู้ให้บริการ[]`, default: { [key: string]: string } }` |
@@ -226,7 +226,7 @@ const { providers, default: defaults } = await client.config.providers()
### เซสชัน
-| วิธี | คำอธิบาย | หมายเหตุ |
+| Method | คำอธิบาย | หมายเหตุ |
| ---------------------------------------------------------- | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `session.list()` | แสดงรายการเซสชัน | ส่งคืน เซสชัน[] |
| `session.get({ path })` | รับเซสชัน | ส่งคืน เซสชัน |
@@ -283,7 +283,7 @@ await client.session.prompt({
### ไฟล์
-| วิธี | คำอธิบาย | การตอบสนอง |
+| Method | คำอธิบาย | การตอบสนอง |
| ------------------------- | ------------------------------ | ----------------------------------------------------------------------------------------- |
| `find.text({ query })` | ค้นหาข้อความในไฟล์ | อาร์เรย์ของวัตถุที่ตรงกับ `path`, `lines`, `line_number`, `absolute_offset`, `submatches` |
| `find.files({ query })` | ค้นหาไฟล์และไดเร็กทอรีตามชื่อ | `string[]` (paths) |
@@ -324,7 +324,7 @@ const content = await client.file.read({
### TUI
-| วิธี | คำอธิบาย | การตอบสนอง |
+| Method | คำอธิบาย | การตอบสนอง |
| ------------------------------ | ------------------------------ | ---------- |
| `tui.appendPrompt({ body })` | เพิ่มข้อความต่อท้ายข้อความแจ้ง | `boolean` |
| `tui.openHelp()` | เปิดกล่องโต้ตอบความช่วยเหลือ | `boolean` |
@@ -355,7 +355,7 @@ await client.tui.showToast({
### การรับรองความถูกต้อง
-| วิธี | คำอธิบาย | การตอบสนอง |
+| Method | คำอธิบาย | การตอบสนอง |
| ------------------- | ----------------------------------------- | ---------- |
| `auth.set({ ... })` | ตั้งค่าข้อมูลประจำตัวการรับรองความถูกต้อง | `boolean` |
@@ -374,7 +374,7 @@ await client.auth.set({
### กิจกรรม
-| วิธี | คำอธิบาย | การตอบสนอง |
+| Method | คำอธิบาย | การตอบสนอง |
| ------------------- | ------------------------------- | ------------------------------- |
| `event.subscribe()` | สตรีมเหตุการณ์ที่เซิร์ฟเวอร์ส่ง | สตรีมเหตุการณ์ที่เซิร์ฟเวอร์ส่ง |
diff --git a/packages/web/src/content/docs/th/server.mdx b/packages/web/src/content/docs/th/server.mdx
index 9c3dce9e6..6688dc585 100644
--- a/packages/web/src/content/docs/th/server.mdx
+++ b/packages/web/src/content/docs/th/server.mdx
@@ -18,7 +18,7 @@ kilo serve [--port Project[] |
-| `GET` | `/project/current` | รับโครงการปัจจุบัน | Project |
+| Method | เส้นทาง | คำอธิบาย | การตอบสนอง |
+| ------ | ------------------ | ------------------------ | --------------------------------------------- |
+| `GET` | `/project` | แสดงรายการโครงการทั้งหมด | Project[] |
+| `GET` | `/project/current` | รับโครงการปัจจุบัน | Project |
---
### เส้นทาง & VCS
-| วิธี | เส้นทาง | คำอธิบาย | การตอบสนอง |
-| ----- | ------- | ----------------------------------- | ------------------------------------------- |
-| `GET` | `/path` | รับเส้นทางปัจจุบัน | Path |
-| `GET` | `/vcs` | รับข้อมูล VCS สำหรับโครงการปัจจุบัน | VcsInfo |
+| Method | เส้นทาง | คำอธิบาย | การตอบสนอง |
+| ------ | ------- | ----------------------------------- | ------------------------------------------- |
+| `GET` | `/path` | รับเส้นทางปัจจุบัน | Path |
+| `GET` | `/vcs` | รับข้อมูล VCS สำหรับโครงการปัจจุบัน | VcsInfo |
---
### ตัวอย่าง
-| วิธี | เส้นทาง | คำอธิบาย | การตอบสนอง |
+| Method | เส้นทาง | คำอธิบาย | การตอบสนอง |
| ------ | ------------------- | ---------------------- | ---------- |
| `POST` | `/instance/dispose` | กำจัดอินสแตนซ์ปัจจุบัน | `boolean` |
@@ -124,7 +124,7 @@ http://กำหนดค่า |
| `PATCH` | `/config` | อัปเดตการกำหนดค่า | กำหนดค่า |
@@ -134,7 +134,7 @@ http://เซสชัน[] |
| `POST` | `/session` | สร้างเซสชันใหม่ | body: `{ parentID?, title? }` ส่งคืน เซสชัน |
@@ -170,7 +170,7 @@ http://Command[] |
+| Method | เส้นทาง | คำอธิบาย | การตอบสนอง |
+| ------ | ---------- | ----------------------- | --------------------------------------------- |
+| `GET` | `/command` | แสดงรายการคำสั่งทั้งหมด | Command[] |
---
### ไฟล์
-| วิธี | เส้นทาง | คำอธิบาย | การตอบสนอง |
-| ----- | ------------------------ | ------------------------------ | ----------------------------------------------------------------------------------------- |
-| `GET` | `/find?pattern=` | ค้นหาไฟล์และไดเร็กทอรีตามชื่อ | `string[]` (paths) | -| `GET` | `/find/symbol?query=` | ค้นหาสัญลักษณ์พื้นที่ทำงาน |Symbol[]| -| `GET` | `/file?path=` | แสดงรายการไฟล์และไดเร็กทอรี | FileNode[]| -| `GET` | `/file/content?path=` | อ่านไฟล์ |
เนื้อหาไฟล์| -| `GET` | `/file/status` | รับสถานะสำหรับไฟล์ที่ถูกติดตาม |File[]| +| Method | เส้นทาง | คำอธิบาย | การตอบสนอง | +| ------ | ------------------------ | ------------------------------ | ----------------------------------------------------------------------------------------- | +| `GET` | `/find?pattern=` | ค้นหาข้อความในไฟล์ | อาร์เรย์ของวัตถุที่ตรงกับ `path`, `lines`, `line_number`, `absolute_offset`, `submatches` | +| `GET` | `/find/file?query= ` | ค้นหาไฟล์และไดเร็กทอรีตามชื่อ | `string[]` (paths) | +| `GET` | `/find/symbol?query=` | ค้นหาสัญลักษณ์พื้นที่ทำงาน |Symbol[]| +| `GET` | `/file?path=` | แสดงรายการไฟล์และไดเร็กทอรี | FileNode[]| +| `GET` | `/file/content?path=` | อ่านไฟล์ |
เนื้อหาไฟล์| +| `GET` | `/file/status` | รับสถานะสำหรับไฟล์ที่ถูกติดตาม |File[]| #### `/find/file` พารามิเตอร์การสืบค้น @@ -212,16 +212,16 @@ http://: /doc ### เครื่องมือ (ทดลอง) -| วิธี | เส้นทาง | คำอธิบาย | การตอบสนอง | -| ----- | ------------------------------------------- | ----------------------------------------------- | ---------------------------------------------------- | -| `GET` | `/experimental/tool/ids` | แสดงรายการรหัสเครื่องมือทั้งหมด | รหัสเครื่องมือ| -| `GET` | `/experimental/tool?provider=&model=
` | แสดงรายการเครื่องมือที่มีสกีมา JSON สำหรับโมเดล | รายการเครื่องมือ| +| Method | เส้นทาง | คำอธิบาย | การตอบสนอง | +| ------ | ------------------------------------------- | ----------------------------------------------- | ---------------------------------------------------- | +| `GET` | `/experimental/tool/ids` | แสดงรายการรหัสเครื่องมือทั้งหมด |รหัสเครื่องมือ| +| `GET` | `/experimental/tool?provider=&model=
` | แสดงรายการเครื่องมือที่มีสกีมา JSON สำหรับโมเดล | รายการเครื่องมือ| --- ### LSP, ฟอร์แมตเตอร์ & MCP -| วิธี | เส้นทาง | คำอธิบาย | การตอบสนอง | +| Method | เส้นทาง | คำอธิบาย | การตอบสนอง | | ------ | ------------ | ------------------------------- | -------------------------------------------------------- | | `GET` | `/lsp` | รับ LSP สถานะเซิร์ฟเวอร์ |LSPStatus[]| | `GET` | `/formatter` | รับสถานะฟอร์แมตเตอร์ |FormatterStatus[]| @@ -232,15 +232,15 @@ http://: /doc ### ตัวแทน -| วิธี | เส้นทาง | คำอธิบาย | การตอบสนอง | -| ----- | -------- | ----------------------------- | -------------------------------------------- | -| `GET` | `/agent` | รายชื่อตัวแทนที่มีอยู่ทั้งหมด | ตัวแทน[]| +| Method | เส้นทาง | คำอธิบาย | การตอบสนอง | +| ------ | -------- | ----------------------------- | -------------------------------------------- | +| `GET` | `/agent` | รายชื่อตัวแทนที่มีอยู่ทั้งหมด |ตัวแทน[]| --- ### การบันทึก -| วิธี | เส้นทาง | คำอธิบาย | การตอบสนอง | +| Method | เส้นทาง | คำอธิบาย | การตอบสนอง | | ------ | ------- | ------------------------------------------------------------------ | ---------- | | `POST` | `/log` | เขียนรายการบันทึก เนื้อความ: `{ service, level, message, extra? }` | `boolean` | @@ -248,7 +248,7 @@ http://: /doc ### TUI -| วิธี | เส้นทาง | คำอธิบาย | การตอบสนอง | +| Method | เส้นทาง | คำอธิบาย | การตอบสนอง | | ------ | ----------------------- | ----------------------------------------------- | --------------- | | `POST` | `/tui/append-prompt` | เพิ่มข้อความต่อท้ายข้อความแจ้ง | `boolean` | | `POST` | `/tui/open-help` | เปิดกล่องโต้ตอบความช่วยเหลือ | `boolean` | @@ -266,22 +266,22 @@ http:// : /doc ### การรับรองความถูกต้อง -| วิธี | เส้นทาง | คำอธิบาย | การตอบสนอง | -| ----- | ----------- | --------------------------------------------------------------------------------- | ---------- | -| `PUT` | `/auth/:id` | ตั้งค่าข้อมูลประจำตัวการรับรองความถูกต้อง เนื้อความต้องตรงกับสคีมาของผู้ให้บริการ | `boolean` | +| Method | เส้นทาง | คำอธิบาย | การตอบสนอง | +| ------ | ----------- | --------------------------------------------------------------------------------- | ---------- | +| `PUT` | `/auth/:id` | ตั้งค่าข้อมูลประจำตัวการรับรองความถูกต้อง เนื้อความต้องตรงกับสคีมาของผู้ให้บริการ | `boolean` | --- ### กิจกรรม -| วิธี | เส้นทาง | คำอธิบาย | การตอบสนอง | -| ----- | -------- | ---------------------------------------------------------------------------- | ------------------------------- | -| `GET` | `/event` | สตรีมเหตุการณ์ที่เซิร์ฟเวอร์ส่ง งานแรกคือ `server.connected` จากนั้นงานรถบัส | สตรีมเหตุการณ์ที่เซิร์ฟเวอร์ส่ง | +| Method | เส้นทาง | คำอธิบาย | การตอบสนอง | +| ------ | -------- | ---------------------------------------------------------------------------- | ------------------------------- | +| `GET` | `/event` | สตรีมเหตุการณ์ที่เซิร์ฟเวอร์ส่ง งานแรกคือ `server.connected` จากนั้นงานรถบัส | สตรีมเหตุการณ์ที่เซิร์ฟเวอร์ส่ง | --- ### เอกสาร -| วิธี | เส้นทาง | คำอธิบาย | การตอบสนอง | -| ----- | ------- | --------------------------- | ---------------------------------- | -| `GET` | `/doc` | ข้อมูลจำเพาะของ OpenAPI 3.1 | HTML หน้าพร้อมข้อมูลจำเพาะ OpenAPI | +| Method | เส้นทาง | คำอธิบาย | การตอบสนอง | +| ------ | ------- | --------------------------- | ---------------------------------- | +| `GET` | `/doc` | ข้อมูลจำเพาะของ OpenAPI 3.1 | HTML หน้าพร้อมข้อมูลจำเพาะ OpenAPI | diff --git a/packages/web/src/content/docs/th/share.mdx b/packages/web/src/content/docs/th/share.mdx index 211ca48b9..7ed98fcd2 100644 --- a/packages/web/src/content/docs/th/share.mdx +++ b/packages/web/src/content/docs/th/share.mdx @@ -27,7 +27,7 @@ Kilo รองรับโหมดการแชร์สามโหมดท --- -### คู่มือ (ค่าเริ่มต้น) +### Manual (ค่าเริ่มต้น) ตามค่าเริ่มต้น Kilo จะใช้โหมดการแชร์ด้วยตนเอง เซสชันจะไม่ถูกแชร์โดยอัตโนมัติ แต่คุณสามารถแชร์ได้ด้วยตนเองโดยใช้คำสั่ง `/share`: @@ -63,7 +63,7 @@ Kilo รองรับโหมดการแชร์สามโหมดท --- -### พิการ +### Disabled คุณสามารถปิดการแชร์ทั้งหมดได้โดยตั้งค่าตัวเลือก `share` เป็น `"disabled"` ใน [ไฟล์กำหนดค่า](/docs/config): diff --git a/packages/web/src/content/docs/th/skills.mdx b/packages/web/src/content/docs/th/skills.mdx index 9b8dd5f9a..163442982 100644 --- a/packages/web/src/content/docs/th/skills.mdx +++ b/packages/web/src/content/docs/th/skills.mdx @@ -1,5 +1,5 @@ --- -title: “ทักษะตัวแทน” +title: Agent Skills description: "กำหนดพฤติกรรมที่นำมาใช้ซ้ำได้ผ่านคำจำกัดความ SKILL.md" --- @@ -100,7 +100,7 @@ Ask clarifying questions if the target versioning scheme is unclear. --- -## รู้จักคำอธิบายเครื่องมือ +## Tool Description Discovery Kilo แสดงรายการทักษะที่มีอยู่ในคำอธิบายเครื่องมือ `skill` แต่ละรายการจะมีชื่อทักษะและคำอธิบาย: @@ -122,7 +122,7 @@ skill({ name: "git-release" }) --- -## กำหนดค่าสิทธิ์ +## Configure Permissions ควบคุมว่าตัวแทนทักษะใดสามารถเข้าถึงโดยใช้สิทธิ์ตามรูปแบบใน `opencode.json`: @@ -149,7 +149,7 @@ skill({ name: "git-release" }) --- -## แทนที่ต่อตัวแทน +## Override per Agent ให้สิทธิ์แก่ตัวแทนเฉพาะเจาะจงที่แตกต่างจากค่าเริ่มต้นทั่วไป diff --git a/packages/web/src/content/docs/th/themes.mdx b/packages/web/src/content/docs/th/themes.mdx index 1d7b61acb..f81868868 100644 --- a/packages/web/src/content/docs/th/themes.mdx +++ b/packages/web/src/content/docs/th/themes.mdx @@ -34,7 +34,7 @@ Kilo มาพร้อมกับธีมในตัวหลายธีม | `catppuccin` | อิงตามธีม [Catppuccin](https://github.com/catppuccin) | | `catppuccin-macchiato` | อิงตามธีม [Catppuccin](https://github.com/catppuccin) | | `gruvbox` | อิงตามธีม [Gruvbox](https://github.com/morhetz/gruvbox) | -| `kanagawa` | อิงตามธีมของ [คานากาว่า](https://github.com/rebelot/kanagawa.nvim) | +| `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 | diff --git a/packages/web/src/content/docs/th/tools.mdx b/packages/web/src/content/docs/th/tools.mdx index 61fdd307c..1211e477f 100644 --- a/packages/web/src/content/docs/th/tools.mdx +++ b/packages/web/src/content/docs/th/tools.mdx @@ -168,7 +168,7 @@ description: จัดการเครื่องมือที่ LLM ส --- -### lsp (ทดลอง) +### lsp (Experimental) โต้ตอบกับเซิร์ฟเวอร์ LSP ที่กำหนดค่าของคุณเพื่อรับฟีเจอร์อัจฉริยะด้านโค้ด เช่น คำจำกัดความ การอ้างอิง ข้อมูลโฮเวอร์ และลำดับชั้นการโทร diff --git a/packages/web/src/content/docs/th/troubleshooting.mdx b/packages/web/src/content/docs/th/troubleshooting.mdx index fa7e16e49..9a8143bdc 100644 --- a/packages/web/src/content/docs/th/troubleshooting.mdx +++ b/packages/web/src/content/docs/th/troubleshooting.mdx @@ -99,7 +99,7 @@ Kilo ยังสามารถโหลดปลั๊กอินในเค --- -### Fix server connection issues +### แก้ไขปัญหาการเชื่อมต่อเซิร์ฟเวอร์ Kilo Desktop สามารถเริ่มต้นเซิร์ฟเวอร์ภายในเครื่องของตนเองได้ (ค่าเริ่มต้น) หรือเชื่อมต่อกับเซิร์ฟเวอร์ URL ที่คุณกำหนดค่าไว้ @@ -121,7 +121,7 @@ Kilo Desktop สามารถเริ่มต้นเซิร์ฟเว --- -### Linux: ปัญหา Wayland / X11 +### Linux: Wayland / X11 issues บน Linux การตั้งค่า Wayland บางอย่างอาจทำให้เกิดหน้าต่างว่างหรือข้อผิดพลาดของตัวประกอบ @@ -130,7 +130,7 @@ Kilo Desktop สามารถเริ่มต้นเซิร์ฟเว --- -### Windows: รันไทม์ WebView2 +### Windows: WebView2 Runtime บน Windows Kilo Desktop ต้องใช้ Microsoft Edge **WebView2 Runtime** หากแอปเปิดเป็นหน้าต่างว่างหรือไม่เริ่มทำงาน ให้ติดตั้ง/update WebView2 แล้วลองอีกครั้ง @@ -231,7 +231,7 @@ Kilo Desktop จะแสดงการแจ้งเตือนของร --- -### ผู้ให้บริการInitError +### ProviderInitError หากคุณพบ ProviderInitError คุณอาจมีการกำหนดค่าที่ไม่ถูกต้องหรือเสียหาย @@ -250,7 +250,7 @@ Kilo Desktop จะแสดงการแจ้งเตือนของร --- -### ปัญหา AI_APICallError และแพ็คเกจผู้ให้บริการ +### AI_APICallError and provider package issues หากคุณพบข้อผิดพลาดในการโทร API อาจเนื่องมาจากแพ็คเกจผู้ให้บริการที่ล้าสมัย opencode จะติดตั้งแพ็คเกจของผู้ให้บริการแบบไดนามิก (OpenAI, Anthropic, Google ฯลฯ) ตามความจำเป็น และแคชไว้ในเครื่อง diff --git a/packages/web/src/content/docs/th/tui.mdx b/packages/web/src/content/docs/th/tui.mdx index 709485088..8384bf65b 100644 --- a/packages/web/src/content/docs/th/tui.mdx +++ b/packages/web/src/content/docs/th/tui.mdx @@ -43,7 +43,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -## คำสั่งทุบตี +## bash commands เริ่มข้อความด้วย `!` เพื่อรันคำสั่ง shell @@ -386,5 +386,5 @@ How is auth handled in @packages/functions/src/api/index.ts? สลับว่าจะให้ชื่อผู้ใช้ของคุณปรากฏในข้อความแชทหรือไม่ เข้าถึงสิ่งนี้ผ่าน: -- จานคำสั่ง: ค้นหา "ชื่อผู้ใช้" หรือ "ซ่อนชื่อผู้ใช้" +- Command Palette: ค้นหา "ชื่อผู้ใช้" หรือ "ซ่อนชื่อผู้ใช้" - การตั้งค่าจะคงอยู่โดยอัตโนมัติและจะถูกจดจำตลอดเซสชัน TUI diff --git a/packages/web/src/content/docs/th/web.mdx b/packages/web/src/content/docs/th/web.mdx index 0d813e086..cc3f42eda 100644 --- a/packages/web/src/content/docs/th/web.mdx +++ b/packages/web/src/content/docs/th/web.mdx @@ -31,7 +31,7 @@ opencode web คุณสามารถกำหนดค่าเว็บเซิร์ฟเวอร์ได้โดยใช้แฟล็กบรรทัดคำสั่งหรือใน [ไฟล์กำหนดค่า](/docs/config) -### ท่าเรือ +### Port ตามค่าเริ่มต้น Kilo จะเลือกพอร์ตที่พร้อมใช้งาน คุณสามารถระบุพอร์ต: diff --git a/packages/web/src/content/docs/th/zen.mdx b/packages/web/src/content/docs/th/zen.mdx index be1686f43..1c03f6b71 100644 --- a/packages/web/src/content/docs/th/zen.mdx +++ b/packages/web/src/content/docs/th/zen.mdx @@ -19,7 +19,7 @@ Zen ทำงานเหมือนกับผู้ให้บริกา --- -## พื้นหลัง +## ภูมิหลัง มีหลายรุ่นครับ แต่มีเพียงไม่กี่รุ่นเท่านั้น โมเดลเหล่านี้ทำงานได้ดีในฐานะตัวแทนการเข้ารหัส นอกจากนี้ผู้ให้บริการส่วนใหญ่ก็มี @@ -62,37 +62,37 @@ OpenCode Zen ทำงานเหมือนกับผู้ให้บร คุณยังสามารถเข้าถึงโมเดลของเราผ่านทางจุดสิ้นสุด API ต่อไปนี้ -| แบบอย่าง | รหัสรุ่น | จุดสิ้นสุด | แพ็คเกจ AI SDK | -| ---------------------- | ---------------------- | -------------------------------------------------- | --------------------------- | -| GPT 5.2 | GPT-5.2 | `https://opencode.ai/zen/v1/responses` | `@ai-sdk/openai` | -| GPT 5.2 โคเด็กซ์ | gpt-5.2-codex | `https://opencode.ai/zen/v1/responses` | `@ai-sdk/openai` | -| GPT 5.1 | GPT-5.1 | `https://opencode.ai/zen/v1/responses` | `@ai-sdk/openai` | -| GPT 5.1 โคเด็กซ์ | gpt-5.1-codex | `https://opencode.ai/zen/v1/responses` | `@ai-sdk/openai` | -| GPT 5.1 โคเด็กซ์สูงสุด | gpt-5.1-codex-สูงสุด | `https://opencode.ai/zen/v1/responses` | `@ai-sdk/openai` | -| GPT 5.1 โคเด็กซ์มินิ | gpt-5.1-codex-mini.php | `https://opencode.ai/zen/v1/responses` | `@ai-sdk/openai` | -| GPT 5 | GPT-5 | `https://opencode.ai/zen/v1/responses` | `@ai-sdk/openai` | -| GPT 5 โคเด็กซ์ | gpt-5-codex | `https://opencode.ai/zen/v1/responses` | `@ai-sdk/openai` | -| GPT 5นาโน | gpt-5-นาโน | `https://opencode.ai/zen/v1/responses` | `@ai-sdk/openai` | -| คล็อด ซอนเน็ต 4.5 | คลอด-โคลง-4-5 | `https://opencode.ai/zen/v1/messages` | `@ai-sdk/anthropic` | -| คลอดด์ ซอนเน็ต 4 | คลอด-โคลง-4 | `https://opencode.ai/zen/v1/messages` | `@ai-sdk/anthropic` | -| คล็อด ไฮกุ 4.5 | คลอดด์-ไฮกุ-4-5 | `https://opencode.ai/zen/v1/messages` | `@ai-sdk/anthropic` | -| คล็อด ไฮกุ 3.5 | คลอด-3-5-ไฮกุ | `https://opencode.ai/zen/v1/messages` | `@ai-sdk/anthropic` | -| คลอดด์บทประพันธ์ 4.6 | คลอด-บทประพันธ์-4-6 | `https://opencode.ai/zen/v1/messages` | `@ai-sdk/anthropic` | -| คลอดด์บทประพันธ์ 4.5 | คลอด-บทประพันธ์-4-5 | `https://opencode.ai/zen/v1/messages` | `@ai-sdk/anthropic` | -| คลอดด์บทประพันธ์ 4.1 | คลอด-บทประพันธ์-4-1 | `https://opencode.ai/zen/v1/messages` | `@ai-sdk/anthropic` | -| เจมินี่ 3 โปร | ราศีเมถุน-3-โปร | `https://opencode.ai/zen/v1/models/gemini-3-pro` | `@ai-sdk/google` | -| ราศีเมถุน 3 แฟลช | ราศีเมถุน-3-flash | `https://opencode.ai/zen/v1/models/gemini-3-flash` | `@ai-sdk/google` | -| มินิแม็กซ์ M2.1 | มินิแม็กซ์-m2.1 | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | -| MiniMax M2.1 ฟรี | minimax-m2.1-ฟรี | `https://opencode.ai/zen/v1/messages` | `@ai-sdk/anthropic` | -| GLM 4.7 | glm-4.7 | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | -| GLM 4.7 ฟรี | ปราศจาก glm-4.7 | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | -| GLM 4.6 | glm-4.6 | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | -| คิมิ K2.5 | คิมิ-k2.5 | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | -| Kimi K2.5 ฟรี | คิมิ-k2.5-ฟรี | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | -| คิมิ K2 กำลังคิด | kimi-k2-คิด | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | -| คิมิ K2 | คิมิ-k2 | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | -| คิวเวน3 โคเดอร์ 480B | qwen3-coder | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | -| บิ๊กดอง | ดองใหญ่ | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | +| Model | Model ID | Endpoint | แพ็คเกจ AI SDK | +| ------------------ | ------------------ | -------------------------------------------------- | --------------------------- | +| GPT 5.2 | GPT-5.2 | `https://opencode.ai/zen/v1/responses` | `@ai-sdk/openai` | +| GPT 5.2 Codex | gpt-5.2-codex | `https://opencode.ai/zen/v1/responses` | `@ai-sdk/openai` | +| GPT 5.1 | GPT-5.1 | `https://opencode.ai/zen/v1/responses` | `@ai-sdk/openai` | +| GPT 5.1 Codex | gpt-5.1-codex | `https://opencode.ai/zen/v1/responses` | `@ai-sdk/openai` | +| GPT 5.1 Codex Max | gpt-5.1-codex-max | `https://opencode.ai/zen/v1/responses` | `@ai-sdk/openai` | +| GPT 5.1 Codex Mini | gpt-5.1-codex-mini | `https://opencode.ai/zen/v1/responses` | `@ai-sdk/openai` | +| GPT 5 | GPT-5 | `https://opencode.ai/zen/v1/responses` | `@ai-sdk/openai` | +| GPT 5 Codex | gpt-5-codex | `https://opencode.ai/zen/v1/responses` | `@ai-sdk/openai` | +| GPT 5 Nano | gpt-5-nano | `https://opencode.ai/zen/v1/responses` | `@ai-sdk/openai` | +| Claude Sonnet 4.5 | claude-sonnet-4-5 | `https://opencode.ai/zen/v1/messages` | `@ai-sdk/anthropic` | +| Claude Sonnet 4 | claude-sonnet-4 | `https://opencode.ai/zen/v1/messages` | `@ai-sdk/anthropic` | +| Claude Haiku 4.5 | claude-haiku-4-5 | `https://opencode.ai/zen/v1/messages` | `@ai-sdk/anthropic` | +| Claude Haiku 3.5 | claude-haiku-3-5 | `https://opencode.ai/zen/v1/messages` | `@ai-sdk/anthropic` | +| Claude Opus 4.6 | claude-opus-4-6 | `https://opencode.ai/zen/v1/messages` | `@ai-sdk/anthropic` | +| Claude Opus 4.5 | claude-opus-4-5 | `https://opencode.ai/zen/v1/messages` | `@ai-sdk/anthropic` | +| Claude Opus 4.1 | claude-opus-4-1 | `https://opencode.ai/zen/v1/messages` | `@ai-sdk/anthropic` | +| Gemini 3 Pro | gemini-3-pro | `https://opencode.ai/zen/v1/models/gemini-3-pro` | `@ai-sdk/google` | +| Gemini 3 Flash | gemini-3-flash | `https://opencode.ai/zen/v1/models/gemini-3-flash` | `@ai-sdk/google` | +| MiniMax M2.1 | minimax-m2.1 | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | +| MiniMax M2.1 Free | minimax-m2.1-free | `https://opencode.ai/zen/v1/messages` | `@ai-sdk/anthropic` | +| GLM 4.7 | glm-4.7 | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | +| GLM 4.7 Free | glm-4.7-free | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | +| GLM 4.6 | glm-4.6 | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | +| Kimi K2.5 | kimi-k2.5 | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | +| Kimi K2.5 Free | kimi-k2.5-free | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | +| Kimi K2 Thinking | kimi-k2-thinking | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | +| Kimi K2 | kimi-k2 | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | +| Qwen3 Coder 480B | qwen3-coder | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | +| Big Pickle | big-pickle | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | [model id](/docs/config/#models) ในการกำหนดค่า Kilo ของคุณ ใช้รูปแบบ `opencode/ ` ตัวอย่างเช่น สำหรับ GPT 5.2 Codex คุณจะต้อง @@ -114,7 +114,7 @@ https://opencode.ai/zen/v1/models เราสนับสนุนรูปแบบการจ่ายเงินตามการใช้งาน ด้านล่างนี้คือราคา **ต่อโทเค็น 1M** -| แบบอย่าง | ป้อนข้อมูล | เอาท์พุต | แคชอ่าน | เขียนในแคช | +| Model | ป้อนข้อมูล | เอาท์พุต | แคชอ่าน | เขียนในแคช | | --------------------------------------- | ------------ | ------------ | ------------- | ---------- | | บิ๊กดอง | ฟรี | ฟรี | ฟรี | - | | MiniMax M2.1 ฟรี | ฟรี | ฟรี | ฟรี | - | diff --git a/packages/web/src/content/docs/tr/1-0.mdx b/packages/web/src/content/docs/tr/1-0.mdx index 4283f52e7..913484b88 100644 --- a/packages/web/src/content/docs/tr/1-0.mdx +++ b/packages/web/src/content/docs/tr/1-0.mdx @@ -36,7 +36,7 @@ Oturum geçmişi daha sıkıştırılmıştır ve yalnızca düzenleme ve bash a Neredeyse onun içinden aktığı bir komut çubuğu ekledik. Her şeyi görmek için ctrl+p tuşlarına basın. -Yararlı bilgileri içeren bir kayıt kenarı sürüklenebilir (değiştirilebilir). +Yararlı bilgileri içeren bir oturum kenar çubuğu eklendi (açılıp kapanabilir). Kimsenin gerçekten çalıştığından emin olmadığımız bazı şeyleri kaldırabildik. Önemli bir şeyin eksik olması durumunda lütfen bir konuyu açın; biz de hızla geri ekleyelim. diff --git a/packages/web/src/content/docs/tr/agents.mdx b/packages/web/src/content/docs/tr/agents.mdx index 219f34c33..85df99c77 100644 --- a/packages/web/src/content/docs/tr/agents.mdx +++ b/packages/web/src/content/docs/tr/agents.mdx @@ -1,15 +1,15 @@ --- -title: Temsilciler -description: Özel araçları yapılandırın ve kullanın. +title: Agents +description: Özel agent'ları yapılandırın ve kullanın. --- -Aracılar, belirli görevler ve iş akışları için yapılandırılabilen uzmanlaşmış yapay zeka asistanlarıdır. Özel istemler, modeller ve araç erişimiyle odaklanmış araçlar oluşturmanıza olanak tanır. +Agent'lar, belirli görevler ve iş akışları için yapılandırılabilen uzmanlaşmış AI asistanlarıdır. Özel prompt'lar, modeller ve araç erişimiyle odaklanmış araçlar oluşturmanıza olanak tanır. :::tip -Herhangi bir kod değişikliği yapmadan kodu analiz etmek ve önerileri gözden geçirmek için plan aracısını kullanın. +Herhangi bir kod değişikliği yapmadan kodu analiz etmek ve önerileri gözden geçirmek için Plan agent'ını kullanın. ::: -Bir oturum sırasında temsilciler arasında geçiş yapabilir veya onları `@` ifadesi ile çağırabilirsiniz. +Bir oturum sırasında agent'lar arasında geçiş yapabilir veya onları `@` ifadesi ile çağırabilirsiniz. --- @@ -19,124 +19,124 @@ opencode'da iki tür aracı vardır; birincil ajanlar ve alt ajanlar. --- -### Birincil ajanlar +### Primary agent'lar -Birincil aracılar, doğrudan etkileşim kurduğunuz ana yardımcılardır. **Sekme** tuşunu veya yapılandırılmış `switch_agent` tuş atamanızı kullanarak bunlar arasında geçiş yapabilirsiniz. Bu temsilciler ana görüşmenizi yönetir. Araç erişimi, izinler aracılığıyla yapılandırılır; örneğin, Plan kısıtlıyken Build'de tüm araçlar etkindir. +Primary agent'lar, doğrudan etkileşim kurduğunuz ana yardımcılardır. **Sekme** tuşunu veya yapılandırılmış `switch_agent` tuş atamanızı kullanarak bunlar arasında geçiş yapabilirsiniz. Bu agent'lar ana görüşmenizi yönetir. Araç erişimi, izinler aracılığıyla yapılandırılır; örneğin, Plan kısıtlıyken Build'de tüm araçlar etkindir. :::tip -Bir oturum sırasında birincil aracılar arasında geçiş yapmak için **Sekme** tuşunu kullanabilirsiniz. +Bir oturum sırasında primary agent'lar arasında geçiş yapmak için **Sekme** tuşunu kullanabilirsiniz. ::: -opencode, **Build** ve **Plan** olmak üzere iki yerleşik birincil aracıyla birlikte gelir. Kuyu +opencode, **Build** ve **Plan** olmak üzere iki yerleşik primary agent ile birlikte gelir. Kuyu aşağıdakilere bakın. --- -### Subagents +### Subagent'lar -Alt temsilciler, birincil aracıların belirli görevler için çağırabileceği uzman yardımcılardır. Ayrıca mesajlarınızda **@ bahsederek** bunları manuel olarak da çağırabilirsiniz. +Subagent'lar, primary agent'ların belirli görevler için çağırabileceği uzman yardımcılardır. Ayrıca mesajlarınızda **@ bahsederek** bunları manuel olarak da çağırabilirsiniz. -opencode, **Genel** ve **Keşfet** olmak üzere iki yerleşik alt aracıyla birlikte gelir. Buna aşağıda bakacağız. +opencode, **General** ve **Explore** olmak üzere iki yerleşik subagent ile birlikte gelir. Buna aşağıda bakacağız. --- -## Yerleşik +## Built-in -opencode iki yerleşik birincil aracı ve iki yerleşik alt aracıyla birlikte gelir. +opencode iki yerleşik primary agent ve iki yerleşik subagent ile birlikte gelir. --- -### Derlemeyi kullan +### Build'i kullan _Mode_: `primary` -Build, tüm araçların etkin olduğu **varsayılan** birincil aracıdır. Bu, dosya işlemlerine ve sistem komutlarına tam erişime ihtiyaç duyduğunuz geliştirme çalışmaları için standart aracıdır. +Build, tüm araçların etkin olduğu **varsayılan** primary agent'tır. Bu, dosya işlemlerine ve sistem komutlarına tam erişime ihtiyaç duyduğunuz geliştirme çalışmaları için standart agent'tır. --- -### Planı kullan +### Plan'ı kullan -_Mod_: `primary` +_Mode_: `primary` -Planlama ve analiz için tasarlanmış kısıtlı bir aracı. Size daha fazla kontrol sağlamak ve istenmeyen değişiklikleri önlemek için bir izin sistemi kullanıyoruz. +Planlama ve analiz için tasarlanmış kısıtlı bir agent. Size daha fazla kontrol sağlamak ve istenmeyen değişiklikleri önlemek için bir izin sistemi kullanıyoruz. Varsayılan olarak aşağıdakilerin tümü `ask` olarak ayarlanmıştır: - `file edits`: Tüm yazmalar, yamalar ve düzenler - `bash`: Tüm bash komutları -Bu aracı, LLM'ın kodu analiz etmesini, değişiklik önermesini veya kod tabanınızda herhangi bir gerçek değişiklik yapmadan plan oluşturmasını istediğinizde kullanışlıdır. +Bu agent, LLM'ın kodu analiz etmesini, değişiklik önermesini veya kod tabanınızda herhangi bir gerçek değişiklik yapmadan plan oluşturmasını istediğinizde kullanışlıdır. --- -### Genel kullan +### General'ı kullan _Mode_: `subagent` -Karmaşık soruları araştırmak ve çok adımlı görevleri yürütmek için genel amaçlı bir aracı. Tam araç erişimine sahiptir (yapılacaklar hariç), böylece gerektiğinde dosya değişiklikleri yapabilir. Birden fazla iş birimini paralel olarak çalıştırmak için bunu kullanın. +Karmaşık soruları araştırmak ve çok adımlı görevleri yürütmek için genel amaçlı bir agent. Tam araç erişimine sahiptir (yapılacaklar hariç), böylece gerektiğinde dosya değişiklikleri yapabilir. Birden fazla iş birimini paralel olarak çalıştırmak için bunu kullanın. --- -### Keşfet'i kullan +### Explore'u kullan -_Mod_: `subagent` +_Mode_: `subagent` -Kod tabanlarını keşfetmeye yönelik hızlı, salt okunur bir aracı. Dosyalar değiştirilemiyor. Dosyaları kalıplara göre hızla bulmanız, anahtar sözcükler için kod aramanız veya kod tabanıyla ilgili soruları yanıtlamanız gerektiğinde bunu kullanın. +Kod tabanlarını keşfetmeye yönelik hızlı, salt okunur bir agent. Dosyalar değiştirilemiyor. Dosyaları kalıplara göre hızla bulmanız, anahtar sözcükler için kod aramanız veya kod tabanıyla ilgili soruları yanıtlamanız gerektiğinde bunu kullanın. --- -### Sıkıştırmayı kullanın +### Compact'i kullan _Mode_: `primary` -Uzun bağlamı daha küçük bir özete sıkıştıran gizli sistem aracısı. Gerektiğinde otomatik olarak çalışır ve kullanıcı arayüzünde seçilemez. +Uzun bağlamı daha küçük bir özete sıkıştıran gizli sistem agent'ı. Gerektiğinde otomatik olarak çalışır ve kullanıcı arayüzünde seçilemez. --- -### Başlığı kullan - -_Mod_: `primary` - -Kısa oturum başlıkları oluşturan gizli sistem aracısı. Otomatik olarak çalışır ve kullanıcı arayüzünde seçilemez. - ---- - -### Özeti kullan +### Title'ı kullan _Mode_: `primary` -Oturum özetleri oluşturan gizli sistem aracısı. Otomatik olarak çalışır ve kullanıcı arayüzünde seçilemez. +Kısa oturum başlıkları oluşturan gizli sistem agent'ı. Otomatik olarak çalışır ve kullanıcı arayüzünde seçilemez. + +--- + +### Summary'yi kullan + +_Mode_: `primary` + +Oturum özetleri oluşturan gizli sistem agent'ı. Otomatik olarak çalışır ve kullanıcı arayüzünde seçilemez. --- ## Kullanım -1. Birincil aracılar için, oturum sırasında bunlar arasında geçiş yapmak için **Sekme** tuşunu kullanın. Yapılandırılmış `switch_agent` tuş bağınızı da kullanabilirsiniz. +1. Primary agent'lar için, oturum sırasında bunlar arasında geçiş yapmak için **Sekme** tuşunu kullanın. Yapılandırılmış `switch_agent` tuş bağınızı da kullanabilirsiniz. -2. Alt aracılar çağrılabilir: - - Açıklamalarına göre özel görevler için birincil temsilciler tarafından **otomatik olarak**. - - Mesajınızda bir alt temsilciden **@ bahsederek** manuel olarak. Örneğin. +2. Subagent'lar çağrılabilir: + - Açıklamalarına göre özel görevler için primary agent'lar tarafından **otomatik olarak**. + - Mesajınızda bir subagent'tan **@ bahsederek** manuel olarak. Örneğin. ```txt frame="none" @general help me search for this function ``` -3. **Oturumlar arasında gezinme**: Alt aracılar kendi alt oturumlarını oluşturduğunda, aşağıdakileri kullanarak ana oturum ile tüm alt oturumlar arasında gezinebilirsiniz: +3. **Oturumlar arasında gezinme**: Subagent'lar kendi alt oturumlarını oluşturduğunda, aşağıdakileri kullanarak ana oturum ile tüm alt oturumlar arasında gezinebilirsiniz: - **\ +Right** (veya yapılandırılmış `session_child_cycle` tuş atamanız) ebeveyn → çocuk1 → çocuk2 → ... → ebeveyn arasında ileri doğru geçiş yapmak için - **\ +Left** (veya yapılandırılmış `session_child_cycle_reverse` tuş atamanız) ebeveyn ← çocuk1 ← çocuk2 ← ... ← ebeveyn arasında geriye doğru geçiş yapmak için - Bu, ana görüşme ile özel alt temsilci çalışması arasında sorunsuz bir şekilde geçiş yapmanıza olanak tanır. + Bu, ana görüşme ile özel subagent çalışması arasında sorunsuz bir şekilde geçiş yapmanıza olanak tanır. --- ## Yapılandır -Yerleşik aracıları özelleştirebilir veya yapılandırma yoluyla kendinizinkini oluşturabilirsiniz. Aracılar iki şekilde yapılandırılabilir: +Yerleşik agent'ları özelleştirebilir veya yapılandırma yoluyla kendinizinkini oluşturabilirsiniz. Agent'lar iki şekilde yapılandırılabilir: --- ### JSON -Aracıları `opencode.json` yapılandırma dosyanızda yapılandırın: +Agent'ları `opencode.json` yapılandırma dosyanızda yapılandırın: ```json title="opencode.json" { @@ -179,7 +179,7 @@ Aracıları `opencode.json` yapılandırma dosyanızda yapılandırın: ### Markdown -Ayrıca aracıları işaretleme dosyalarını kullanarak da tanımlayabilirsiniz. Bunları şuraya yerleştirin: +Ayrıca agent'ları Markdown dosyalarını kullanarak da tanımlayabilirsiniz. Bunları şuraya yerleştirin: - Global: `~/.config/opencode/agents/` - Per-project: `.opencode/agents/` @@ -206,7 +206,7 @@ You are in code review mode. Focus on: Provide constructive feedback without making direct changes. ``` -Markdown dosyasının adı aracının adı olur. Örneğin, `review.md` bir `review` aracısı oluşturur. +Markdown dosyasının adı agent'ın adı olur. Örneğin, `review.md` bir `review` agent'ı oluşturur. --- @@ -216,9 +216,9 @@ Bu yapılandırma seçeneklerine ayrıntılı olarak bakalım. --- -### Tanım +### Description -Aracının ne yaptığına ve ne zaman kullanılacağına ilişkin kısa bir açıklama sağlamak için `description` seçeneğini kullanın. +Agent'ın ne yaptığına ve ne zaman kullanılacağına ilişkin kısa bir açıklama sağlamak için `description` seçeneğini kullanın. ```json title="opencode.json" { @@ -234,7 +234,7 @@ Bu **gerekli** bir yapılandırma seçeneğidir. --- -### Sıcaklık +### Temperature LLM'nin yanıtlarının rastgeleliğini ve yaratıcılığını `temperature` yapılandırmasıyla kontrol edin. @@ -283,9 +283,9 @@ Sıcaklık belirtilmezse opencode modeline özgü varsayılanları kullanır; ç ### Max steps -Bir aracının yalnızca metinle yanıt vermeye zorlanmadan önce gerçekleştirebileceği maksimum aracı yineleme sayısını kontrol edin. Bu, maliyetleri kontrol etmek isteyen kullanıcıların aracılık eylemlerine bir sınır koymasına olanak tanır. +Bir agent'ın yalnızca metinle yanıt vermeye zorlanmadan önce gerçekleştirebileceği maksimum agent yineleme sayısını kontrol edin. Bu, maliyetleri kontrol etmek isteyen kullanıcıların agent eylemlerine bir sınır koymasına olanak tanır. -Bu ayarlanmazsa, model durmayı seçene veya kullanıcı oturumu kesene kadar aracı yinelemeye devam edecektir. +Bu ayarlanmazsa, model durmayı seçene veya kullanıcı oturumu kesene kadar agent yinelemeye devam edecektir. ```json title="opencode.json" { @@ -299,7 +299,7 @@ Bu ayarlanmazsa, model durmayı seçene veya kullanıcı oturumu kesene kadar ar } ``` -Sınıra ulaşıldığında, aracı, işinin özeti ve önerilen kalan görevlerin bir özetiyle yanıt vermesi talimatını veren özel bir sistem istemi alır. +Sınıra ulaşıldığında, agent, işinin özeti ve önerilen kalan görevlerin bir özetiyle yanıt vermesi talimatını veren özel bir sistem prompt'u alır. :::caution Eski `maxSteps` alanı kullanımdan kaldırıldı. Bunun yerine `steps` kullanın. @@ -307,9 +307,9 @@ Eski `maxSteps` alanı kullanımdan kaldırıldı. Bunun yerine `steps` kullanı --- -### Devre dışı bırakmak +### Disable -Aracıyı devre dışı bırakmak için `true` olarak ayarlayın. +Agent'ı devre dışı bırakmak için `true` olarak ayarlayın. ```json title="opencode.json" { @@ -323,9 +323,9 @@ Aracıyı devre dışı bırakmak için `true` olarak ayarlayın. --- -### Çabuk +### Prompt -Bu aracı için `prompt` yapılandırmasıyla özel bir sistem bilgi istemi dosyası belirtin. Bilgi istemi dosyası, aracının amacına özel talimatlar içermelidir. +Bu agent için `prompt` yapılandırmasıyla özel bir sistem prompt dosyası belirtin. Prompt dosyası, agent'ın amacına özel talimatlar içermelidir. ```json title="opencode.json" { @@ -341,12 +341,12 @@ Bu yol, yapılandırma dosyasının bulunduğu yere göredir. Yani bu hem global --- -### Modeli +### Model -Bu aracın kodu geçersiz için `model` ayarını kullanın. Farklı bölümler için optimize edilmiş farklı modelleri kullanmak için kullanışlıdır. Örneğin planlama için daha hızlı bir model, uygulama için daha yetenekli bir model. +Bu agent'ın kodu geçersiz için `model` ayarını kullanın. Farklı bölümler için optimize edilmiş farklı modelleri kullanmak için kullanışlıdır. Örneğin planlama için daha hızlı bir model, uygulama için daha yetenekli bir model. :::tip -Bir model belirtmezseniz, birincil araçlar [model globally configured](/docs/config#models)'yi kullanırken alt araçlar, alt aracı çağıran birincil aracın kullanıcı adını kullanır. +Bir model belirtmezseniz, primary agent'lar [model globally configured](/docs/config#models)'yi kullanırken subagent'lar, subagent'ı çağıran primary agent'ın kullanıcı adını kullanır. ::: ```json title="opencode.json" @@ -365,7 +365,7 @@ opencode hesabınızdaki model kimliğini `provider/model-id` biçimini kullanı ### Tools -`tools` yapılandırmasıyla bu aracıda hangi araçların mevcut olduğunu kontrol edin. Belirli araçları `true` veya `false` olarak ayarlayarak etkinleştirebilir veya devre dışı bırakabilirsiniz. +`tools` yapılandırmasıyla bu agent'ta hangi araçların mevcut olduğunu kontrol edin. Belirli araçları `true` veya `false` olarak ayarlayarak etkinleştirebilir veya devre dışı bırakabilirsiniz. ```json title="opencode.json" {3-6,9-12} { @@ -386,7 +386,7 @@ opencode hesabınızdaki model kimliğini `provider/model-id` biçimini kullanı ``` :::note -Aracıya özgü yapılandırma, genel yapılandırmayı geçersiz kılar. +Agent'a özgü yapılandırma, genel yapılandırmayı geçersiz kılar. ::: Aynı anda birden fazla aracı kontrol etmek için joker karakterleri de kullanabilirsiniz. Örneğin, bir MCP sunucusundaki tüm araçları devre dışı bırakmak için: @@ -410,13 +410,13 @@ Aynı anda birden fazla aracı kontrol etmek için joker karakterleri de kullana --- -### İzinler +### Permissions -Bir aracının gerçekleştirebileceği eylemleri yönetmek için izinleri yapılandırabilirsiniz. Şu anda `edit`, `bash` ve `webfetch` araçlarının izinleri şu şekilde yapılandırılabilir: +Bir agent'ın gerçekleştirebileceği eylemleri yönetmek için izinleri yapılandırabilirsiniz. Şu anda `edit`, `bash` ve `webfetch` araçlarının izinleri şu şekilde yapılandırılabilir: -- `"ask"` — Aracı çalıştırmadan önce onay iste +- `"ask"` — Agent çalıştırmadan önce onay iste - `"allow"` — Onay olmadan tüm işlemlere izin ver -- `"deny"` — Aracı devre dışı bırakır +- `"deny"` — Agent'ı devre dışı bırakır ```json title="opencode.json" { @@ -427,7 +427,7 @@ Bir aracının gerçekleştirebileceği eylemleri yönetmek için izinleri yapı } ``` -Bu izinleri aracı başına geçersiz kılabilirsiniz. +Bu izinleri agent başına geçersiz kılabilirsiniz. ```json title="opencode.json" {3-5,8-10} { @@ -445,7 +445,7 @@ Bu izinleri aracı başına geçersiz kılabilirsiniz. } ``` -İzinleri Markdown aracılarında da ayarlayabilirsiniz. +İzinleri Markdown agent'larında da ayarlayabilirsiniz. ```markdown title="~/.config/opencode/agents/review.md" --- @@ -524,7 +524,7 @@ Son eşleşen kural öncelikli olduğundan, `*` joker karakterini ilk sıraya ve ### Mode -Aracının modunu `mode` yapılandırmasıyla kontrol edin. `mode` seçeneği aracının nasıl kullanılabileceğini belirlemek için kullanılır. +Agent'ın modunu `mode` yapılandırmasıyla kontrol edin. `mode` seçeneği agent'ın nasıl kullanılabileceğini belirlemek için kullanılır. ```json title="opencode.json" { @@ -540,9 +540,9 @@ Aracının modunu `mode` yapılandırmasıyla kontrol edin. `mode` seçeneği ar --- -### Gizlenmiş +### Hidden -`@` otomatik tamamlama menüsünden bir alt aracıyı `hidden: true` ile gizleyin. Yalnızca diğer aracılar tarafından Görev aracı aracılığıyla programlı olarak çağrılması gereken dahili alt aracılar için kullanışlıdır. +`@` otomatik tamamlama menüsünden bir subagent'ı `hidden: true` ile gizleyin. Yalnızca diğer agent'lar tarafından Task aracı aracılığıyla programlı olarak çağrılması gereken dahili subagent'lar için kullanışlıdır. ```json title="opencode.json" { @@ -555,17 +555,17 @@ Aracının modunu `mode` yapılandırmasıyla kontrol edin. `mode` seçeneği ar } ``` -Bu yalnızca otomatik menüdeki kullanıcının görünümlerinin etkileri. İzinler izin vermesine, gizli araçlar modeli tarafından Görev aracı aracılığıyla çağrılmaya devam edilebilir. +Bu yalnızca otomatik menüdeki kullanıcının görünümlerinin etkileri. İzinler izin vermesine, gizli agent'lar modeli tarafından Task aracı aracılığıyla çağrılmaya devam edilebilir. :::note -Yalnızca `mode: subagent` acenteleri için geçerlidir. +Yalnızca `mode: subagent` agent'ları için geçerlidir. ::: --- ### Task permissions -`permission.task` ile bir aracının Görev aracı aracılığıyla hangi alt aracıları çağırabileceğini kontrol edin. Esnek eşleştirme için küresel desenleri kullanır. +`permission.task` ile bir agent'ın Task aracı aracılığıyla hangi subagent'ları çağırabileceğini kontrol edin. Esnek eşleştirme için küresel desenleri kullanır. ```json title="opencode.json" { @@ -584,21 +584,21 @@ Yalnızca `mode: subagent` acenteleri için geçerlidir. } ``` -`deny` olarak ayarlandığında, alt aracı Görev aracı açıklamasından tamamen kaldırılır, böylece model onu çağırmaya çalışmaz. +`deny` olarak ayarlandığında, subagent Task aracı açıklamasından tamamen kaldırılır, böylece model onu çağırmaya çalışmaz. :::tip Kurallar sırayla değerlendirilir ve **son eşleşen kural kazanır**. Yukarıdaki örnekte `orchestrator-planner`, hem `*` (reddet) hem de `orchestrator-*` (izin ver) ile eşleşir, ancak `orchestrator-*`, `*`'den sonra geldiğinden sonuç `allow` olur. ::: :::tip -Kullanıcılar, aracının görev izinleri bunu reddetse bile, her zaman herhangi bir alt aracıyı `@` otomatik tamamlama menüsü aracılığıyla doğrudan çağırabilir. +Kullanıcılar, agent'ın görev izinleri bunu reddetse bile, her zaman herhangi bir subagent'ı `@` otomatik tamamlama menüsü aracılığıyla doğrudan çağırabilir. ::: --- -### Renk +### Color -Aracının kullanıcı arayüzündeki görsel görünümünü `color` seçeneğiyle özelleştirin. Bu, aracının arayüzde nasıl göründüğünü etkiler. +Agent'ın kullanıcı arayüzündeki görsel görünümünü `color` seçeneğiyle özelleştirin. Bu, agent'ın arayüzde nasıl göründüğünü etkiler. cebeli bir onaltılık renk (ör. `#FF5733`) veya tema rengini kullanın: `primary`, `secondary`, `accent`, `success`, `warning`, `error`, `info`. @@ -635,9 +635,9 @@ Değerler 0,0 ile 1,0 arasında değişir. Düşük değerler daha odaklıdır, --- -### Ek olarak +### Additional -Temsilci yapılandırmanızdaki düzenlemeleriniz diğer seçenekler, model seçenekleri olarak **doğrudan sağlayıcıya** iletilecektir. Bu, sağlayıcıya özgü özelliklerin ve serbest bırakılmasını sağlar. +Agent yapılandırmanızdaki düzenlemeleriniz diğer seçenekler, model seçenekleri olarak **doğrudan sağlayıcıya** iletilecektir. Bu, sağlayıcıya özgü özelliklerin ve serbest bırakılmasını sağlar. Örneğin OpenAI'nin akıl yürütme modelleriyle akıl yürütme çabasını kontrol edebilirsiniz: @@ -662,9 +662,9 @@ Mevcut modellerin listesini görmek için `opencode models` komutunu çalıştı --- -## Temsilci oluştur +## Create agents -Aşağıdaki komutu kullanarak yeni aracılar oluşturabilirsiniz: +Aşağıdaki komutu kullanarak yeni agent'lar oluşturabilirsiniz: ```bash opencode agent create @@ -672,37 +672,37 @@ opencode agent create Bu etkileşimli komut şunları sağlayacaktır: -1. Temsilciyi nereye kaydedeceğinizi sorun; küresel veya projeye özel. -2. Temsilcinin ne yapması gerektiğinin açıklaması. -3. Uygun bir sistem istemi ve tanımlayıcı oluşturun. -4. Aracının hangi araçlara erişebileceğini seçmenize izin verin. -5. Son olarak aracı yapılandırmasıyla bir işaretleme dosyası oluşturun. +1. Agent'ı nereye kaydedeceğinizi sorun; küresel veya projeye özel. +2. Agent'ın ne yapması gerektiğinin açıklaması. +3. Uygun bir sistem prompt'u ve tanımlayıcı oluşturun. +4. Agent'ın hangi araçlara erişebileceğini seçmenize izin verin. +5. Son olarak agent yapılandırmasıyla bir Markdown dosyası oluşturun. --- -## Kullanım durumları +## Use cases -Farklı aracılara yönelik bazı yaygın kullanım durumları aşağıda verilmiştir. +Farklı agent'lara yönelik bazı yaygın kullanım durumları aşağıda verilmiştir. -- **Yapı aracısı**: Tüm araçların etkinleştirildiği tam geliştirme çalışması -- **Plan aracısı**: Değişiklik yapmadan analiz ve planlama -- **İnceleme aracısı**: Salt okunur erişim ve belgeleme araçlarıyla kod incelemesi -- **Hata ayıklama aracısı**: Bash ve okuma araçları etkinken araştırmaya odaklanmıştır -- **Dokümanlar aracısı**: Dosya işlemleriyle ancak sistem komutları olmadan belge yazma +- **Build agent**: Tüm araçların etkinleştirildiği tam geliştirme çalışması +- **Plan agent**: Değişiklik yapmadan analiz ve planlama +- **Review agent**: Salt okunur erişim ve belgeleme araçlarıyla kod incelemesi +- **Debug agent**: Bash ve okuma araçları etkinken araştırmaya odaklanmıştır +- **Docs agent**: Dosya işlemleriyle ancak sistem komutları olmadan belge yazma --- ## Examples -Yararlı bulabileceğiniz bazı örnek aracıları burada bulabilirsiniz. +Yararlı bulabileceğiniz bazı örnek agent'ları burada bulabilirsiniz. :::tip -Paylaşmak istediğiniz bir temsilciniz var mı? [Submit a PR](https://github.com/Kilo-Org/kilo). +Paylaşmak istediğiniz bir agent'ınız var mı? [Submit a PR](https://github.com/Kilo-Org/kilo). ::: --- -### Dokümantasyon temsilcisi +### Documentation agent ```markdown title="~/.config/opencode/agents/docs-writer.md" --- diff --git a/packages/web/src/content/docs/tr/cli.mdx b/packages/web/src/content/docs/tr/cli.mdx index f3d1a9f5c..7ac384532 100644 --- a/packages/web/src/content/docs/tr/cli.mdx +++ b/packages/web/src/content/docs/tr/cli.mdx @@ -69,10 +69,10 @@ opencode attach [url] Bu, TUI öğesinin uzak bir opencode arka ucuyla kullanılmasına olanak tanır. Örneğin: ```bash -# Web/mobil erişim için backend sunucusunu başlat +# Start the backend server for web/mobile access opencode web --port 4096 --hostname 0.0.0.0 -# Başka bir terminalde çalışan backend'e TUI ile bağlan +# In another terminal, attach the TUI to the running backend opencode attach http://10.20.30.40:4096 ``` @@ -326,10 +326,10 @@ opencode run Explain the use of context in Go Ayrıca, her çalıştırmada MCP sunucusunun soğuk önyükleme sürelerini önlemek için çalışan bir `kilo serve` örneğine de ekleyebilirsiniz: ```bash -# Bir terminalde headless sunucuyu başlat +# Start a headless server in one terminal kilo serve -# Başka bir terminalde buna bağlanan komutları çalıştır +# In another terminal, run commands that attach to it opencode run --attach http://localhost:4096 "Explain async/await in JavaScript" ``` diff --git a/packages/web/src/content/docs/tr/formatters.mdx b/packages/web/src/content/docs/tr/formatters.mdx index d530dd6cc..3063fb45d 100644 --- a/packages/web/src/content/docs/tr/formatters.mdx +++ b/packages/web/src/content/docs/tr/formatters.mdx @@ -35,10 +35,10 @@ opencode, popüler diller ve çerçeveler için çeşitli yerleşik biçimlendir | nixfmt | .nix | `nixfmt` komutu mevcut | | shfmt | .sh, .bash | `shfmt` komutu mevcut | | pint | .php | `laravel/pint` dependency in `composer.json` | -| oxfmt (Deneysel) | .js, .jsx, .ts, .tsx | `package.json` içindeki `oxfmt` bağımlılığı ve [experimental env variable flag](/docs/cli/#experimental) | +| oxfmt (Deneysel) | .js, .jsx, .ts, .tsx | `oxfmt` içindeki `package.json` bağımlılığı ve [experimental env variable flag](/docs/cli/#experimental) | | ormolu | .hs | `ormolu` komutu mevcut | -Yani eğer projenizin `package.json` dosyasında `prettier` varsa, opencode bunu otomatik olarak kullanacaktır. +Yani eğer projenizin `prettier` dosyasında `package.json` varsa, opencode bunu otomatik olarak kullanacaktır. --- diff --git a/packages/web/src/content/docs/tr/github.mdx b/packages/web/src/content/docs/tr/github.mdx index 995ac2aab..fdeda4103 100644 --- a/packages/web/src/content/docs/tr/github.mdx +++ b/packages/web/src/content/docs/tr/github.mdx @@ -37,7 +37,7 @@ Veya manuel olarak ayarlayabilirsiniz. 2. **İş akışını ekleyin** - Aşağıdaki iş akışı dosyasını deponuzdaki `.github/workflows/opencode.yml`'a ekleyin. `env`'de uygun `model` ve gerekli API anahtarlarını ayarladığınızdan emin olun. + Aşağıdaki iş akışı dosyasını deponuzdaki `.github/workflows/opencode.yml`'a ekleyin. `model`'de uygun `env` ve gerekli API anahtarlarını ayarladığınızdan emin olun. ```yml title=".github/workflows/opencode.yml" {24,26} name: opencode diff --git a/packages/web/src/content/docs/tr/index.mdx b/packages/web/src/content/docs/tr/index.mdx index 31cfc0f91..5bb45a619 100644 --- a/packages/web/src/content/docs/tr/index.mdx +++ b/packages/web/src/content/docs/tr/index.mdx @@ -7,7 +7,7 @@ import { Tabs, TabItem } from "@astrojs/starlight/components" import config from "../../../../config.mjs" export const console = config.console -[**opencode**](/) açık kaynaklı bir AI kodlama aracısıdır. Terminal tabanlı bir arayüz, masaüstü uygulaması veya IDE uzantısı olarak mevcuttur. +[**opencode**](/) açık kaynaklı bir AI coding agent'ıdır. Terminal tabanlı bir arayüz, masaüstü uygulaması veya IDE uzantısı olarak mevcuttur.  @@ -79,7 +79,7 @@ Ayrıca aşağıdaki komutlarla da yükleyebilirsiniz: brew install anomalyco/tap/opencode ``` - > En güncel sürümler için opencode dokunuşunu kullanmanızı öneririz. Resmi `brew install opencode` formülü Homebrew ekibi tarafından korunur ve daha sık güncellenir. + > En güncel sürümler için opencode tap'ini kullanmanızı öneririz. Resmi `brew install opencode` formülü Homebrew ekibi tarafından korunur ve daha sık güncellenir. - **Paru'yu Arch Linux'ta kullanma** @@ -93,13 +93,13 @@ Ayrıca aşağıdaki komutlarla da yükleyebilirsiniz: Windows'ta en iyi deneyim için [Windows Subsystem for Linux (WSL)](/docs/windows-wsl) kullanılmasını öneririz. Daha iyi performans ve opencode'un özellikleriyle tam uyumluluğu sağlar. ::: -- **Çikolata Kullanımı** +- **Chocolatey Kullanımı** ```bash choco install opencode ``` -- **Kepçe Kullanımı** +- **Scoop Kullanımı** ```bash scoop install opencode @@ -134,8 +134,7 @@ opencode'un Bun kullanılarak Windows'a yüklenmesine yönelik destek şu anda d opencode ile herhangi bir LLM sağlayıcısının API anahtarlarını yapılandırarak kullanabilirsiniz. LLM sağlayıcılarını kullanmaya yeni başlıyorsanız, [OpenCode Zen](/docs/zen) kullanmanızı öneririz. -opencode tarafından test edilmiş ve doğrulanmış modellerin seçilmiş bir listesidir -team. +opencode team tarafından test edilmiş ve doğrulanmış modellerin seçilmiş bir listesidir. 1. TUI'de `/connect` komutunu çalıştırın, opencode'u seçin ve [kilo.ai/auth](https://kilo.ai/auth)'ye gidin. @@ -207,7 +206,7 @@ Projedeki dosyaları bulanık aramak için `@` tuşunu kullanın. ::: ```txt frame="none" "@packages/functions/src/api/index.ts" -@packages/functions/src/api/index.ts dosyasında authentication nasıl ele alınıyor? +How is authentication handled in @packages/functions/src/api/index.ts ``` Kod tabanının üzerinde çalışmadığınız bir kısmı varsa bu yararlı olur. @@ -232,9 +231,9 @@ opencode'dan projenize yeni özellikler eklemesini isteyebilirsiniz. Yine de ön Şimdi ne yapmasını istediğimizi anlatalım. ```txt frame="none" - Bir kullanıcı not sildiğinde, veritabanında bu notu silinmiş olarak işaretleyelim. - Ardından yakın zamanda silinen tüm notları gösteren bir ekran oluşturalım. - Bu ekrandan kullanıcı notu geri alabilsin veya kalıcı olarak silebilsin. + When a user deletes a note, we'd like to flag it as deleted in the database. + Then create a screen that shows all the recently deleted notes. + From this screen, the user can undelete a note or permanently delete it. ``` opencode'un isteğinizi anlaması için yeterli ayrıntı verin. @@ -249,8 +248,8 @@ opencode'dan projenize yeni özellikler eklemesini isteyebilirsiniz. Yine de ön Size bir plan sunduğunda ona geri bildirimde bulunabilir veya daha fazla ayrıntı ekleyebilirsiniz. ```txt frame="none" - Bu yeni ekranı daha önce kullandığım bir tasarıma göre yapmak istiyoruz. - [Image #1] Bu görsele bakıp referans al. + We'd like to design this new screen using a design I've used before. + [Image #1] Take a look at this image and use it as a reference. ``` :::tip @@ -271,7 +270,7 @@ opencode'dan projenize yeni özellikler eklemesini isteyebilirsiniz. Yine de ön Ardından değişiklikleri yapmasını isteyin. ```bash frame="none" - Harika görünüyor, şimdi değişiklikleri yap. + Sounds good! Go ahead and make the changes. ``` --- @@ -281,9 +280,9 @@ opencode'dan projenize yeni özellikler eklemesini isteyebilirsiniz. Yine de ön Daha basit değişikliklerde, önce planı incelemeden opencode'dan doğrudan değişiklik yapmasını isteyebilirsiniz. ```txt frame="none" "@packages/functions/src/settings.ts" "@packages/functions/src/notes.ts" -/settings route'una authentication eklememiz gerekiyor. -@packages/functions/src/notes.ts içindeki /notes route'unda bunun nasıl yapıldığına bak -ve aynı mantığı @packages/functions/src/settings.ts içinde uygula. +We need to add authentication to the /settings route. Take a look at how this is +handled in the /notes route in @packages/functions/src/notes.ts and implement +the same logic in @packages/functions/src/settings.ts ``` opencode'un doğru değişiklikleri yapması için yeterli ayrıntı verdiğinizden emin olun. @@ -295,7 +294,7 @@ opencode'un doğru değişiklikleri yapması için yeterli ayrıntı verdiğiniz Diyelim ki opencode'dan bazı değişiklikler yapmasını istediniz. ```txt frame="none" "@packages/functions/src/api/index.ts" -@packages/functions/src/api/index.ts içindeki fonksiyonu refactor edebilir misin? +Can you refactor the function in @packages/functions/src/api/index.ts? ``` Ama istediğinin bu olmadığını anlıyorsun. Değişiklikleri **geri alabilirsiniz** @@ -308,7 +307,7 @@ Ama istediğinin bu olmadığını anlıyorsun. Değişiklikleri **geri alabilir opencode değişiklikleri geri alır ve orijinal mesajınızı tekrar gösterir. ```txt frame="none" "@packages/functions/src/api/index.ts" -@packages/functions/src/api/index.ts içindeki fonksiyonu refactor edebilir misin? +Can you refactor the function in @packages/functions/src/api/index.ts? ``` Buradan komut isteminde ince ayar yapabilir ve opencode'dan tekrar denemesini isteyebilirsiniz. diff --git a/packages/web/src/content/docs/tr/lsp.mdx b/packages/web/src/content/docs/tr/lsp.mdx index 083f23333..7cadb9863 100644 --- a/packages/web/src/content/docs/tr/lsp.mdx +++ b/packages/web/src/content/docs/tr/lsp.mdx @@ -182,7 +182,7 @@ Komutu ve dosya uzantılarını belirterek özel LSP sunucuları ekleyebilirsini PHP Intelephense, bir lisans anahtarı aracılığıyla premium özellikler sunar. Anahtarı (yalnızca) şu adresteki bir metin dosyasına yerleştirerek bir lisans anahtarı sağlayabilirsiniz: -- MacOS/Linux'ta: `$HOME/intelephense/licence.txt` -- Windows'ta: `%USERPROFILE%/intelephense/licence.txt` +- MacOS/Linux'ta: `$HOME/intelephense/license.txt` +- Windows'ta: `%USERPROFILE%/intelephense/license.txt` Dosya, ek içerik olmadan yalnızca lisans anahtarını içermelidir. diff --git a/packages/web/src/content/docs/tr/models.mdx b/packages/web/src/content/docs/tr/models.mdx index cc84c7acf..ff38b12cc 100644 --- a/packages/web/src/content/docs/tr/models.mdx +++ b/packages/web/src/content/docs/tr/models.mdx @@ -100,7 +100,7 @@ Bir modelin seçeneklerini genel olarak yapılandırma aracılığıyla yapılan } ``` -Burada iki yerleşik model için genel ayarları yapılandırıyoruz: `openai` sağlayıcısı aracılığıyla erişildiğinde `gpt-5` ve `anthropic` sağlayıcısı aracılığıyla erişildiğinde `claude-sonnet-4-20250514`. +Burada iki yerleşik model için genel ayarları yapılandırıyoruz: `gpt-5` sağlayıcısı aracılığıyla erişildiğinde `openai` ve `claude-sonnet-4-20250514` sağlayıcısı aracılığıyla erişildiğinde `anthropic`. Yerleşik sağlayıcı ve model adları [Models.dev](https://models.dev) adresinde bulunabilir. Bu seçenekleri kullandığınız tüm aracılar için de yapılandırabilirsiniz. Aracı yapılandırması burada tüm genel seçenekleri geçersiz kılar. [Daha fazla bilgi](/docs/agents/#additional). diff --git a/packages/web/src/content/docs/tr/plugins.mdx b/packages/web/src/content/docs/tr/plugins.mdx index df6ef343c..6c7be9070 100644 --- a/packages/web/src/content/docs/tr/plugins.mdx +++ b/packages/web/src/content/docs/tr/plugins.mdx @@ -312,7 +312,7 @@ export const CustomToolsPlugin: Plugin = async (ctx) => { ### Günlüğe kaydetme -Yapılandırılmış günlük kaydı için `console.log` yerine `client.app.log()` kullanın: +Yapılandırılmış günlük kaydı için `client.app.log()` yerine `console.log` kullanın: ```ts title=".opencode/plugins/my-plugin.ts" export const MyPlugin = async ({ client }) => { diff --git a/packages/web/src/content/docs/tr/rules.mdx b/packages/web/src/content/docs/tr/rules.mdx index d9573059f..91104acaf 100644 --- a/packages/web/src/content/docs/tr/rules.mdx +++ b/packages/web/src/content/docs/tr/rules.mdx @@ -130,7 +130,7 @@ Opencode, `AGENTS.md`'daki dosya referanslarını otomatik olarak ayrıştırmas ### opencode.json'u kullanma -Önerilen yaklaşım, `opencode.json`'deki `instructions` alanını kullanmaktır: +Önerilen yaklaşım, `instructions`'deki `opencode.json` alanını kullanmaktır: ```json title="opencode.json" { diff --git a/packages/web/src/content/docs/tr/skills.mdx b/packages/web/src/content/docs/tr/skills.mdx index 4765b12e6..7077ed129 100644 --- a/packages/web/src/content/docs/tr/skills.mdx +++ b/packages/web/src/content/docs/tr/skills.mdx @@ -25,7 +25,7 @@ opencode su konumlari tarar: ## Kesfi anlayin Proje yerel yollarinda opencode, mevcut calisma dizininizden baslayip git worktree kokune kadar yukari cikar. -Bu sirada `.opencode/` altindaki eslesen `skills/*/SKILL.md` dosyalarini ve `.claude/skills/*/SKILL.md` ya da `.agents/skills/*/SKILL.md` dosyalarini yukler. +Bu sirada `skills/*/SKILL.md` altindaki eslesen `.opencode/` dosyalarini ve `.claude/skills/*/SKILL.md` ya da `.agents/skills/*/SKILL.md` dosyalarini yukler. Genel tanimlar da `~/.config/opencode/skills/*/SKILL.md`, `~/.claude/skills/*/SKILL.md` ve `~/.agents/skills/*/SKILL.md` yollarindan yuklenir. diff --git a/packages/web/src/content/docs/tr/tools.mdx b/packages/web/src/content/docs/tr/tools.mdx index 5e9fff069..fc4acb7d7 100644 --- a/packages/web/src/content/docs/tr/tools.mdx +++ b/packages/web/src/content/docs/tr/tools.mdx @@ -376,4 +376,4 @@ Normalde yok sayilan dosyalari dahil etmek icin proje kokunde bir `.ignore` dosy !build/ ``` -Ornegin bu `.ignore` dosyasi, `.gitignore` icinde olsalar bile ripgrep'in `node_modules/`, `dist/` ve `build/` dizinlerinde arama yapmasina izin verir. +Ornegin bu `.ignore` dosyasi, `node_modules/` icinde olsalar bile ripgrep'in `dist/`, `build/` ve `.gitignore` dizinlerinde arama yapmasina izin verir. diff --git a/packages/web/src/content/docs/tr/troubleshooting.mdx b/packages/web/src/content/docs/tr/troubleshooting.mdx index d591b7f27..9a9aa4ace 100644 --- a/packages/web/src/content/docs/tr/troubleshooting.mdx +++ b/packages/web/src/content/docs/tr/troubleshooting.mdx @@ -277,7 +277,7 @@ Linux kullanicilarinin kopyala/yapistir ozelliginin calismasi icin asagidaki pan ```bash apt install -y xclip -# veya +# or apt install -y xsel ``` @@ -291,7 +291,7 @@ apt install -y wl-clipboard ```bash apt install -y xvfb -# ve su komutlari calistirin: +# and run: Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 & export DISPLAY=:99.0 ``` diff --git a/packages/web/src/content/docs/tr/tui.mdx b/packages/web/src/content/docs/tr/tui.mdx index d8df79418..545c82c6c 100644 --- a/packages/web/src/content/docs/tr/tui.mdx +++ b/packages/web/src/content/docs/tr/tui.mdx @@ -22,7 +22,7 @@ opencode /path/to/project TUI icinde bir mesaj yazarak istem gonderebilirsiniz. ```text -Kod tabani icin hizli bir ozet ver. +Give me a quick summary of the codebase. ``` --- @@ -36,7 +36,7 @@ Mesajlarinizda dosyalara referans vermek icin `@` kullanabilirsiniz. ::: ```text "@packages/functions/src/api/index.ts" -@packages/functions/src/api/index.ts dosyasinda kimlik dogrulama nasil ele alinmis? +How is auth handled in @packages/functions/src/api/index.ts? ``` Dosya icerigi otomatik olarak konusmaya eklenir. @@ -45,7 +45,7 @@ Dosya icerigi otomatik olarak konusmaya eklenir. ## Bash komutlari -Bir mesaji `!` ile baslatarak kabuk komutu calistirin. +Bir mesaji `!` ile baslatarak shell komutu calistirin. ```bash frame="none" !ls -la @@ -290,12 +290,12 @@ Mevcut oturumun paylasimini kaldirir. [Daha fazla bilgi](/docs/share#paylasimi-k ```bash - # nano veya vim ornegi + # Example for nano or vim export EDITOR=nano export EDITOR=vim - # VS Code, Cursor, VSCodium, Windsurf, Zed vb. GUI editorler icin - # --wait ekleyin + # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc. + # include --wait export EDITOR="code --wait" ``` @@ -308,8 +308,8 @@ Mevcut oturumun paylasimini kaldirir. [Daha fazla bilgi](/docs/share#paylasimi-k ```bash set EDITOR=notepad - # VS Code, Cursor, VSCodium, Windsurf, Zed vb. GUI editorler icin - # --wait ekleyin + # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc. + # include --wait set EDITOR=code --wait ``` @@ -321,8 +321,8 @@ Mevcut oturumun paylasimini kaldirir. [Daha fazla bilgi](/docs/share#paylasimi-k ```powershell $env:EDITOR = "notepad" - # VS Code, Cursor, VSCodium, Windsurf, Zed vb. GUI editorler icin - # --wait ekleyin + # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc. + # include --wait $env:EDITOR = "code --wait" ``` diff --git a/packages/web/src/content/docs/tr/web.mdx b/packages/web/src/content/docs/tr/web.mdx index 31cfd071d..ea36c9d80 100644 --- a/packages/web/src/content/docs/tr/web.mdx +++ b/packages/web/src/content/docs/tr/web.mdx @@ -113,10 +113,10 @@ Bağlı sunucuları ve durumlarını görüntülemek için "Sunucuları Gör" se Çalışan bir web sunucusuna bir terminal TUI'si ekleyebilirsiniz: ```bash -# Web sunucusunu başlat +# Start the web server opencode web --port 4096 -# Başka bir terminalde TUI ile bağlan +# In another terminal, attach the TUI opencode attach http://localhost:4096 ``` diff --git a/packages/web/src/content/docs/zh-cn/1-0.mdx b/packages/web/src/content/docs/zh-cn/1-0.mdx index 4d9f69e34..c249b2bb3 100644 --- a/packages/web/src/content/docs/zh-cn/1-0.mdx +++ b/packages/web/src/content/docs/zh-cn/1-0.mdx @@ -1,28 +1,28 @@ --- -title: 遷移到 1.0 -description: opencode 1.0 中的添加内容。 +title: 迁移到 1.0 +description: opencode 1.0 中的新增内容。 --- -opencode 1.0完全重写了TUI。 +opencode 1.0 完全重写了 TUI。 -我们从存在的性能和功能问题的基于 go+bubbletea 的 TUI 迁移到使用 zig+solidjs 编写的内部框架 (OpenTUI)。 +我们从存在性能和功能问题的基于 go+bubbletea 的 TUI 迁移到使用 zig+solidjs 编写的内部框架 (OpenTUI)。 -新的 TUI 的工作方式与旧的 TUI 类似,因为它连接到相同的opencode服务器。 +新的 TUI 的工作方式与旧的 TUI 类似,因为它连接到相同的 opencode 服务器。 --- -## 升級中 +## 升级中 -如果您当前正在使用以前的版本,则不应自动升級到 1.0 +如果您当前正在使用以前的版本,则不应自动升级到 1.0 版本。然而,一些旧版本的 opencode 总是获取最新版本。 -要手动升級,请運行 +要手动升级,请运行 ```bash $ kilo upgrade 1.0.0 ``` -要降级回0.x,请运行 +要降级回 0.x,请运行 ```bash $ kilo upgrade 0.15.31 @@ -30,21 +30,21 @@ $ kilo upgrade 0.15.31 --- -## 用戶體驗變化 +## 用户体验变化 会话历史记录更加压缩,仅显示编辑和 bash 工具的完整详细信息。 -我们添加了一个命令栏,几乎所有内容都通过了它。按 ctrl+p 可以在任意上下文中调出它并查看您可以执行的所有操作。 +我们添加了一个命令栏,几乎所有内容都通过它。按 ctrl+p 可以在任意上下文中调出它并查看您可以执行的所有操作。 -添加了包含有用信息的会话側邊欄(可以切換)。 +添加了包含有用信息的会话侧边栏(可以切换)。 -我们删除了一些我们不確定是否有人實際使用的功能。如果缺少重要內容,请提出問題,我们会盡快将其添加回來。 +我们删除了一些我们不确定是否有人实际使用的功能。如果缺少重要内容,请提出 issue,我们会尽快将其添加回来。 --- -## 重大變化 +## 重大变化 -### 按鍵綁定已重命名 +### 按键绑定已重命名 - messages_revert -> messages_undo - switch_agent -> agent_cycle @@ -52,16 +52,16 @@ $ kilo upgrade 0.15.31 - switch_mode -> agent_cycle - switch_mode_reverse -> agent_cycle_reverse -### 按鍵綁定已移除 +### 按键绑定已移除 -- 消息佈局切換 +- 消息布局切换 - 下一条消息 - 上一条消息 -- 文件差異切換 +- 文件差异切换 - 文件搜索 - 文件关闭 - 文件列表 -- 应用程序幫助 -- 項目初始化 -- 工具詳細信息 -- 思維塊 +- 应用程序帮助 +- 项目初始化 +- 工具详细信息 +- 思维块 diff --git a/packages/web/src/content/docs/zh-cn/acp.mdx b/packages/web/src/content/docs/zh-cn/acp.mdx index 69f4526b3..4035d084d 100644 --- a/packages/web/src/content/docs/zh-cn/acp.mdx +++ b/packages/web/src/content/docs/zh-cn/acp.mdx @@ -3,10 +3,10 @@ title: ACP 支持 description: 在任何 ACP 兼容编辑器中使用 opencode。 --- -opencode 支持[代理客户端协议](https://agentclientprotocol.com) 或 (ACP),允许您直接在兼容的编辑器和 IDE 中使用它。 +opencode 支持 [Agent Client Protocol](https://agentclientprotocol.com) (ACP),允许您直接在兼容的编辑器和 IDE 中使用它。 :::tip -有关支持 ACP 的编辑器和工具的列表,请查看[非加太进度进度报告](https://zed.dev/blog/acp-progress-report#available-now)。 +有关支持 ACP 的编辑器和工具的列表,请查看 [Zed ACP progress report](https://zed.dev/blog/acp-progress-report#available-now)。 ::: ACP 是一种开放协议,用于标准化代码编辑器和 AI 编码代理之间的通信。 @@ -23,9 +23,9 @@ ACP 是一种开放协议,用于标准化代码编辑器和 AI 编码代理之 --- -### 澤德 +### Zed -添加到您的[泽德](https://zed.dev)配置(`~/.config/zed/settings.json`): +添加到您的 [Zed](https://zed.dev) 配置 (`~/.config/zed/settings.json`): ```json title="~/.config/zed/settings.json" { @@ -40,7 +40,7 @@ ACP 是一种开放协议,用于标准化代码编辑器和 AI 编码代理之 要打开它,请使用 **命令面板** 中的 `agent: new thread` 操作。 -您还可以通过编辑`keymap.json`来绑定键盘快捷键: +您还可以通过编辑 `keymap.json` 来绑定键盘快捷键: ```json title="keymap.json" [ @@ -69,7 +69,7 @@ ACP 是一种开放协议,用于标准化代码编辑器和 AI 编码代理之 ### JetBrains IDE -根据[文件](https://www.jetbrains.com/help/ai-assistant/acp.html)添加到你的[JetBrains IDE](https://www.jetbrains.com/) acp.json]: +根据 [docs](https://www.jetbrains.com/help/ai-assistant/acp.html) 添加到你的 [JetBrains IDE](https://www.jetbrains.com/) `acp.json`: ```json title="acp.json" { @@ -82,13 +82,13 @@ ACP 是一种开放协议,用于标准化代码编辑器和 AI 编码代理之 } ``` -要打开它,请在 AI Chat 代理选择器中使用新的“opencode”代理。 +要打开它,请在 AI Chat 代理选择器中使用新的 "opencode" 代理。 --- -### 前衛 +### Avante.nvim -添加到您的[前卫](https://github.com/yetone/avante.nvim)配置: +添加到您的 [Avante.nvim](https://github.com/yetone/avante.nvim) 配置: ```lua { @@ -101,7 +101,7 @@ ACP 是一种开放协议,用于标准化代码编辑器和 AI 编码代理之 } ``` -如果需要傳遞環境變量: +如果需要传递环境变量: ```lua {6-8} { @@ -119,7 +119,7 @@ ACP 是一种开放协议,用于标准化代码编辑器和 AI 编码代理之 --- -### 代码合作者.nvim +### CodeCompanion.nvim 相当于 opencode 网关 [CodeCompanion.nvim](https://github.com/olimorris/codecompanion.nvim) 中的 ACP 代理,接下来将以下内容添加到 Neovim 配置中: @@ -136,9 +136,9 @@ require("codecompanion").setup({ }) ``` -此配置将 CodeCompanion 设置为使用 opencode 作为聊天的 ACP 代理。 +此配置将 CodeCompanion.nvim 设置为使用 opencode 作为聊天的 ACP 代理。 -如果您需要交付环境变量(如 `OPENCODE_API_KEY`),请参阅 CodeCompanion.nvim 文档中的 [配置充电器:环境变量Z](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) 了解完整信息。 +如果您需要传递环境变量(如 `OPENCODE_API_KEY`),请参阅 CodeCompanion.nvim 文档中的 [Configuration: Adapters](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) 了解完整信息。 ## 支持 @@ -149,8 +149,8 @@ opencode 通过 ACP 的工作方式与在终端中的工作方式相同。支持 ::: - 内置工具(文件操作、终端命令等) -- 自定義工具和斜杠命令 +- 自定义工具和斜杠命令 - 在 opencode 配置中配置的 MCP 服务器 - `AGENTS.md` 的项目特定规则 - 自定义程序和 linter -- 代理和权限系統 +- 代理和权限系统 diff --git a/packages/web/src/content/docs/zh-cn/agents.mdx b/packages/web/src/content/docs/zh-cn/agents.mdx index d531022f4..5b3dc7746 100644 --- a/packages/web/src/content/docs/zh-cn/agents.mdx +++ b/packages/web/src/content/docs/zh-cn/agents.mdx @@ -1,65 +1,65 @@ --- -title: 代理商 -description: 配置和使用专門的代理。 +title: Agents +description: 配置和使用专门的代理。 --- -代理是专門的人工智能助手,可以針对特定任务和工作流程進行配置。它們允许您创建具有自定義提示、模型和工具访问权限的专用工具。 +代理是专门的人工智能助手,可以针对特定任务和工作流程进行配置。它们允许您创建具有自定义提示、模型和工具访问权限的专用工具。 :::tip -使用計劃代理來分析代碼并审查建議,而無需進行任何代碼更改。 +使用 Plan 代理来分析代码并审查建议,而无需进行任何代码更改。 ::: -您可以在会话期間在代理之間切換,或使用 `@` 提及來调用它們。 +您可以在会话期间在代理之间切换,或使用 `@` 提及来调用它们。 --- -## 類型 +## 类型 -opencode有两种类型的代理;主代理和次代理。 +Kilo 有两种类型的代理;主代理和子代理。 --- -### 主要代理 +### Primary 代理 -主要代理是与您直接交互的主要助手。您可以使用 **Tab** 键或您配置的 `switch_agent` 键绑定循环浏览它们。这些代理处理您的主要对话。工具访问是通过权限配置的 - 例如,“构建”启用了所有工具,而“计划”则受到限制。 +Primary 代理是与您直接交互的主要助手。您可以使用 **Tab** 键或您配置的 `switch_agent` 键绑定循环浏览它们。这些代理处理您的主要对话。工具访问是通过权限配置的 - 例如,“Build”启用了所有工具,而“Plan”则受到限制。 :::tip -您可以在会话期间使用 **Tab** 键在主要代理之间进行切换。 +您可以在会话期间使用 **Tab** 键在 Primary 代理之间进行切换。 ::: -opencode附带两个内置的主要代理:**Build** 和 **Plan**。地 +Kilo 附带两个内置的 Primary 代理:**Build** 和 **Plan**。 看看下面这些。 --- -### 子代理 +### Subagents (子代理) -子代理是主要代理可以调用來执行特定任务的专業助手。您还可以通过在消息中**@提及**它們來手动调用它們。 +Subagents (子代理) 是 Primary 代理可以调用来执行特定任务的专业助手。您还可以通过在消息中 **@提及** 它们来手动调用它们。 -opencode附带两个内置子代理:**General** 和 **Explore**。我们将在下面看看这个。 +Kilo 附带两个内置子代理:**General** 和 **Explore**。我们将在下面看看这个。 --- -## 內建 +## 内置 -opencode附带两个内置主代理和两个内置子代理。 +Kilo 附带两个内置主代理和两个内置子代理。 --- -### 使用構建 +### 使用 Build _模式_:`primary` -構建是启用所有工具的**默認**主要代理。这是用于需要完全访问文件操作和系統命令的開發工作的標準代理。 +Build 是启用所有工具的 **默认** Primary 代理。这是用于需要完全访问文件操作和系统命令的开发工作的标准代理。 --- -### 使用計劃 +### 使用 Plan _模式_:`primary` -专为規劃和分析而設計的受限代理。我们使用权限系統为您提供更多控制并防止意外更改。 -默认情况下,以下所有项均设置为`ask`: +专为规划和分析而设计的受限代理。我们使用权限系统为您提供更多控制并防止意外更改。 +默认情况下,以下所有项均设置为 `ask`: - `file edits`:所有书写、修复和编辑 - `bash`:所有 bash 命令 @@ -68,7 +68,7 @@ _模式_:`primary` --- -### 使用一般 +### 使用 General _模式_:`subagent` @@ -76,15 +76,15 @@ _模式_:`subagent` --- -### 使用探索 +### 使用 Explore _模式_:`subagent` -用于探索代碼庫的快速只讀代理。无法修改文件。当您需要按模式快速查找文件、搜索代碼中的關鍵字或回答有關代碼庫的問題時,请使用此功能。 +用于探索代码库的快速只读代理。无法修改文件。当您需要按模式快速查找文件、搜索代码中的关键字或回答有关代码库的问题时,请使用此功能。 --- -### 使用壓實 +### 使用 Compact _模式_:`primary` @@ -92,7 +92,7 @@ _模式_:`primary` --- -### 使用標題 +### 使用 Title _模式_:`primary` @@ -100,7 +100,7 @@ _模式_:`primary` --- -### 使用總結 +### 使用 Summary _模式_:`primary` @@ -110,27 +110,27 @@ _模式_:`primary` ## 用法 -1. 对于主要代理,请在会话期间使用 **Tab** 键循环浏览它们。您还可以使用配置的 `switch_agent` 键绑定。 +1. 对于 Primary 代理,请在会话期间使用 **Tab** 键循环浏览它们。您还可以使用配置的 `switch_agent` 键绑定。 2. 可以调用子代理: - - **自动**由主要代理根據其描述执行专門任务。 - - 通过在消息中**@提及**子代理手动進行。例如。 + - **自动**由 Primary 代理根据其描述执行专门任务。 + - 通过在消息中 **@提及** 子代理手动进行。例如。 ```txt frame="none" @general help me search for this function ``` -3. **会话之间导航**:当子代理创建自己的子会话時,您可以使用以下命令在父会话和所有子会话之间导航: - - **\ +Right**(或您配置的 `session_child_cycle` 鍵綁定)向前循環父級 → 子級 1 → 子級 2 → ... → 父級 - - **\ +Left**(或您配置的 `session_child_cycle_reverse` 鍵綁定)向後循環父級 ← 子級 1 ← 子級 2 ← ... ← 父級 +3. **会话之间导航**:当子代理创建自己的子会话时,您可以使用以下命令在父会话和所有子会话之间导航: + - **\ +Right**(或您配置的 `session_child_cycle` 键绑定)向前循环父级 → 子级 1 → 子级 2 → ... → 父级 + - **\ +Left**(或您配置的 `session_child_cycle_reverse` 键绑定)向后循环父级 ← 子级 1 ← 子级 2 ← ... ← 父级 - 这使您可以在主要对话和专門的子代理工作之間無縫切換。 + 这使您可以在主要对话和专门的子代理工作之间无缝切换。 --- ## 配置 -您可以自定義内置代理或通过配置创建您自己的代理。可以通过两种方式配置代理: +您也可以自定义内置代理或通过配置创建您自己的代理。可以通过两种方式配置代理: --- @@ -181,7 +181,7 @@ _模式_:`primary` 您还可以使用 Markdown 文件定义代理。将它们放入: -- 全球:`~/.config/opencode/agents/` +- 全局:`~/.config/opencode/agents/` - 每个项目:`.opencode/agents/` ```markdown title="~/.config/opencode/agents/review.md" @@ -206,13 +206,13 @@ You are in code review mode. Focus on: Provide constructive feedback without making direct changes. ``` -Markdown 文件名成为代理名称。例如,`review.md` 创建`review` 代理。 +Markdown 文件名成为代理名称。例如,`review.md` 创建 `review` 代理。 --- -## 選項 +## 选项 -讓我们詳細看看这些配置選項。 +让我们详细看看这些配置选项。 --- @@ -230,15 +230,15 @@ Markdown 文件名成为代理名称。例如,`review.md` 创建`review` 代 } ``` -这是一个**必需的**配置選項。 +这是一个 **必需的** 配置选项。 --- -### 溫度 +### 温度 使用 `temperature` 配置控制 LLM 响应的随机性和创意。 -較低的值使響应更加集中和確定,而較高的值则增加创建力和可變性。 +较低的值使响应更加集中和确定,而较高的值则增加创造力和可变性。 ```json title="opencode.json" { @@ -277,15 +277,15 @@ Markdown 文件名成为代理名称。例如,`review.md` 创建`review` 代 } ``` -如果未指定温度,opencode 将使用特定于模型的默认值;大多数模型通常为 0,Qwen 模型为 0.55。 +如果未指定温度,Kilo 将使用特定于模型的默认值;大多数模型通常为 0,Qwen 模型为 0.55。 --- -### 最大步數 +### 最大步数 -控制代理在被迫仅使用文本響应之前可以执行的最大代理迭代次數。这允许希望控制成本的用戶对代理操作设置限制。 +控制代理在被迫仅使用文本响应之前可以执行的最大代理迭代次数。这允许希望控制成本的用户对代理操作设置限制。 -如果未设置,代理将繼續迭代,直到模型选择停止或用戶中斷会话。 +如果未设置,代理将继续迭代,直到模型选择停止或用户中断会话。 ```json title="opencode.json" { @@ -299,17 +299,17 @@ Markdown 文件名成为代理名称。例如,`review.md` 创建`review` 代 } ``` -当達到限制時,代理会收到特殊的系統提示,指示其響应其工作摘要和建議的剩餘任务。 +当达到限制时,代理会收到特殊的系统提示,指示其响应其工作摘要和建议的剩余任务。 :::caution -旧版 `maxSteps` 字段已废弃。请改用`steps`。 +旧版 `maxSteps` 字段已废弃。请改用 `steps`。 ::: --- ### 禁用 -设置为`true`以取消代理。 +设置为 `true` 以取消代理。 ```json title="opencode.json" { @@ -323,7 +323,7 @@ Markdown 文件名成为代理名称。例如,`review.md` 创建`review` 代 --- -### 迅速的 +### 提示 使用 `prompt` 配置为代理指定自定义系统提示文件。提示文件应包含特定于代理目的的说明。 @@ -337,7 +337,7 @@ Markdown 文件名成为代理名称。例如,`review.md` 创建`review` 代 } ``` -该路径相对于文件所在位置的配置。因此,这适用于全局 opencode 配置和项目特定配置。 +该路径相对于文件所在位置的配置。因此,这适用于全局 Kilo 配置和项目特定配置。 --- @@ -346,7 +346,7 @@ Markdown 文件名成为代理名称。例如,`review.md` 创建`review` 代 使用 `model` 配置此代理的模型。对于使用针对不同任务优化的不同模型很有帮助。例如,更快的规划模型、更强大的实施模型。 :::tip -如果您不指定模型,主代理将使用[全局配置的模型](/docs/config#models),而子代理将使用调用子代理的主代理的模型。 +如果您不指定模型,Primary 代理将使用 [全局配置的模型](/docs/config#models),而子代理将使用调用子代理的 Primary 代理的模型。 ::: ```json title="opencode.json" @@ -359,7 +359,7 @@ Markdown 文件名成为代理名称。例如,`review.md` 创建`review` 代 } ``` -opencode配置中的模型ID使用格式`provider/model-id`。例如,如果您使用[OpenCode Zen](/docs/zen),则您将使用`opencode/gpt-5.1-codex`来表示GPT 5.1 Codex。 +Kilo 配置中的模型 ID 使用格式 `provider/model-id`。例如,如果您使用 [OpenCode Zen](/docs/zen),则您将使用 `opencode/gpt-5.1-codex` 来表示 GPT 5.1 Codex。 --- @@ -482,7 +482,7 @@ Only analyze code and suggest changes. } ``` -这可以採用全局模式。 +这可以采用全局模式。 ```json title="opencode.json" {7} { @@ -499,7 +499,7 @@ Only analyze code and suggest changes. } ``` -您还可以使用`*`通配符來管理所有命令的权限。 +您还可以使用 `*` 通配符来管理所有命令的权限。 由于最后一个匹配规则优先,因此将 `*` 通配符放在前面,将特定规则放在后面。 ```json title="opencode.json" {8} @@ -524,7 +524,7 @@ Only analyze code and suggest changes. ### 模式 -使用`mode` 配置控制代理的模式。 `mode` 选项用于确定如何使用代理。 +使用 `mode` 配置控制代理的模式。 `mode` 选项用于确定如何使用代理。 ```json title="opencode.json" { @@ -536,13 +536,13 @@ Only analyze code and suggest changes. } ``` -`mode` 选项可设置为`primary`、`subagent` 或`all`。如果未指定`mode`,则默认为`all`。 +`mode` 选项可设置为 `primary`、`subagent` 或 `all`。如果未指定 `mode`,则默认为 `all`。 --- -### 隱 +### 隐藏 -使用`hidden: true`从`@`自动完成菜单隐藏子代理。对于只能由其他代理通过任务工具以编程方式调用的内部子代理很有帮助。 +使用 `hidden: true` 从 `@` 自动完成菜单隐藏子代理。对于只能由其他代理通过任务工具以编程方式调用的内部子代理很有帮助。 ```json title="opencode.json" { @@ -558,14 +558,14 @@ Only analyze code and suggest changes. 这仅影响自动完成菜单中的用户可见性。如果权限允许,模型仍然可以通过任务工具调用隐藏代理。 :::note -仅适用于`mode: subagent`代理。 +仅适用于 `mode: subagent` 代理。 ::: --- ### 任务权限 -使用`permission.task`控制代理可以通过任务工具调用哪些子代理。使用glob模式进行灵活匹配。 +使用 `permission.task` 控制代理可以通过任务工具调用哪些子代理。使用 glob 模式进行灵活匹配。 ```json title="opencode.json" { @@ -584,23 +584,23 @@ Only analyze code and suggest changes. } ``` -当设置为`deny`时,子代理社区任务工具描述中因此完全删除,模型不会尝试调用它。 +当设置为 `deny` 时,子代理社区任务工具描述中因此完全删除,模型不会尝试调用它。 :::tip -规则按顺序评估,**最后匹配的规则触发**。在上面的示例中,`orchestrator-planner` 匹配`*`(拒绝)和`orchestrator-*`(允许),但由于`orchestrator-*` 位于`*` 之后,因此结果为`allow`。 +规则按顺序评估,**最后匹配的规则触发**。在上面的示例中,`orchestrator-planner` 匹配 `*`(拒绝)和 `orchestrator-*`(允许),但由于 `orchestrator-*` 位于 `*` 之后,因此结果为 `allow`。 ::: :::tip -用戶始終可以通过 `@` 自动完成菜单直接调用任何子代理,即使代理的任务权限会拒絕它。 +用户始终可以通过 `@` 自动完成菜单直接调用任何子代理,即使代理的任务权限会拒绝它。 ::: --- -### 顏色 +### 颜色 -在UI中的界面外观中使用`color`选项自定义代理。这会影响代理在界面中的显示方式。 +在 UI 中的界面外观中使用 `color` 选项自定义代理。这会影响代理在界面中的显示方式。 -使用有效的十六进制颜色(例如`#FF5733`)或主题颜色:`primary`、`secondary`、`accent`、`success`、`warning`、`error`、`info`。 +使用有效的十六进制颜色(例如 `#FF5733`)或主题颜色:`primary`、`secondary`、`accent`、`success`、`warning`、`error`、`info`。 ```json title="opencode.json" { @@ -617,7 +617,7 @@ Only analyze code and suggest changes. --- -### 顶P +### Top P 使用 `top_p` 选项控制响应多样性。控制随机性的温度替代方案。 @@ -631,13 +631,13 @@ Only analyze code and suggest changes. } ``` -值范围從 0.0 到 1.0。較低的值更加集中,較高的值更加多樣化。 +值范围从 0.0 到 1.0。较低的值更加集中,较高的值更加多样化。 --- -### 額外的 +### 其他 -您在代理配置中指定的任何其他選項都将作为模型選項**直接**傳遞給提供商。这允许您使用特定于提供商的功能和參數。 +您在代理配置中指定的任何其他选项都将作为模型选项 **直接** 传递给提供商。这允许您使用特定于提供商的功能和参数。 例如,使用 OpenAI 的推理模型,您可以控制推理工作: @@ -654,7 +654,7 @@ Only analyze code and suggest changes. } ``` -这些附加選項是特定于模型和提供商的。检查提供商的文档以获取可用參數。 +这些附加选项是特定于模型和提供商的。检查提供商的文档以获取可用参数。 :::tip 运行 `opencode models` 查看可用模型的列表。 @@ -672,37 +672,37 @@ opencode agent create 此交互式命令将: -1. 詢問代理保存在哪裡;全局或特定項目。 -2. 描述代理应该做什麼。 -3. 生成適当的系統提示和標識符。 -4. 讓您选择代理可以访问哪些工具。 -5. 最后,使用代理配置创建一个markdown文件。 +1. 询问代理保存在哪里;全局或特定项目。 +2. 描述代理应该做什么。 +3. 生成适当的系统提示和标识符。 +4. 让您选择代理可以访问哪些工具。 +5. 最后,使用代理配置创建一个 markdown 文件。 --- ## 使用案例 -以下是不同代理的一些常見用例。 +以下是不同代理的一些常见用例。 -- **構建代理**:启用所有工具的完整開發工作 -- **規劃代理**:分析規劃,不做改動 -- **审查代理**:具有隻讀访问权限和文档工具的代碼审查 -- **调试代理**:专注于启用bash和读取工具的调查 -- **文档代理**:使用文件操作但不使用系統命令的文档編寫 +- **Build Agent**:启用所有工具的完整开发工作 +- **Plan Agent**:分析规划,不做改动 +- **Review Agent**:具有只读访问权限和文档工具的代码审查 +- **Debug Agent**:专注于启用 bash 和读取工具的调查 +- **Docs Agent**:使用文件操作但不使用系统命令的文档编写 --- ## 示例 -以下是一些您可能会覺得有用的示例代理。 +以下是一些您可能会觉得有用的示例代理。 :::tip -您有想要分享的经纪人吗? [提交 PR](https://github.com/Kilo-Org/kilo)。 +您有想要分享的代理吗? [提交 PR](https://github.com/Kilo-Org/kilo)。 ::: --- -### 文件代理 +### 文档代理 ```markdown title="~/.config/opencode/agents/docs-writer.md" --- @@ -724,7 +724,7 @@ Focus on: --- -### 安全審核員 +### 安全审计员 ```markdown title="~/.config/opencode/agents/security-auditor.md" --- diff --git a/packages/web/src/content/docs/zh-cn/cli.mdx b/packages/web/src/content/docs/zh-cn/cli.mdx index 9408016ac..e918253f6 100644 --- a/packages/web/src/content/docs/zh-cn/cli.mdx +++ b/packages/web/src/content/docs/zh-cn/cli.mdx @@ -1,17 +1,17 @@ --- -title: 命令行界面 +title: CLI description: opencode CLI 选项和命令。 --- import { Tabs, TabItem } from "@astrojs/starlight/components" -默认情况下,opencode CLI 在不带任何参数运行时启动[途径易](/docs/tui)。 +默认情况下,opencode CLI 在不带任何参数运行时启动 [TUI](/docs/tui)。 ```bash opencode ``` -但它也接受允许本页记录的命令。这您以Smashing方式与opencode交互。 +但它也接受本页记录的命令。这允许您以编程方式与 opencode 交互。 ```bash opencode run "Explain how closures work in JavaScript" @@ -19,36 +19,36 @@ opencode run "Explain how closures work in JavaScript" --- -### 推 +### tui -启动opencode用户终端界面。 +启动 opencode 终端用户界面。 ```bash opencode [project] ``` -#### 旗幟 +#### Flags -| 旗幟 | 短 | 描述 | -| ------------ | ---- | --------------------------------------------------------- | -| `--continue` | `-c` | 继续上期 | -| `--session` | `-s` | 会话 ID 继续 | -| `--fork` | | 继续时分叉会话(与 `--continue` 或 `--session` 一起使用) | -| `--prompt` | | 提示使用 | -| `--model` | `-m` | 以提供商/模型形式使用的模型 | -| `--agent` | | 代理使用 | -| `--port` | | 监听端口 | -| `--hostname` | | 监听的主机名 | +| Flag | Short | Description | +| ------------ | ----- | --------------------------------------------------------- | +| `--continue` | `-c` | 继续上一个会话 | +| `--session` | `-s` | 继续的会话 ID | +| `--fork` | | 继续时分叉会话(与 `--continue` 或 `--session` 一起使用) | +| `--prompt` | | 使用的提示 | +| `--model` | `-m` | 使用的模型 (provider/model) | +| `--agent` | | 使用的代理 | +| `--port` | | 监听端口 | +| `--hostname` | | 监听的主机名 | --- -## 命令 +## Commands opencode CLI 还具有以下命令。 --- -### 代理人 +### agent 管理 opencode 代理。 @@ -58,15 +58,15 @@ opencode agent [command] --- -### 附 +### attach -将终端通过 `serve` 或 `web` 命令启动已运行的 opencode 耳机服务器。 +将终端附加到通过 `serve` 或 `web` 命令启动的已运行 opencode 后端服务器。 ```bash opencode attach [url] ``` -这允许将 TUI 与远程 opencode 钱包一起使用。例如: +这允许将 TUI 与远程 opencode 后端一起使用。例如: ```bash # Start the backend server for web/mobile access @@ -76,28 +76,28 @@ opencode web --port 4096 --hostname 0.0.0.0 opencode attach http://10.20.30.40:4096 ``` -#### 旗幟 +#### Flags -| 旗幟 | 短 | 描述 | -| ----------- | ---- | ------------------- | -| `--dir` | | 启动 TUI 的工作目录 | -| `--session` | `-s` | 会话 ID 继续 | +| Flag | Short | Description | +| ----------- | ----- | ------------------- | +| `--dir` | | 启动 TUI 的工作目录 | +| `--session` | `-s` | 继续的会话 ID | --- -#### 创建 +#### create -使用自定義配置创建新代理。 +使用自定义配置创建新代理。 ```bash opencode agent create ``` -此命令将指導您使用自定義系統提示和工具配置创建新代理。 +此命令将指导您使用自定义系统提示和工具配置创建新代理。 --- -#### 列表 +#### list 列出所有可用的代理。 @@ -107,9 +107,9 @@ opencode agent list --- -### 授權 +### auth -用于管理提供商的憑據和登錄的命令。 +用于管理提供商的凭据和登录的命令。 ```bash kilo auth [command] @@ -117,27 +117,27 @@ kilo auth [command] --- -#### 登录 +#### login -opencode 由 [Models.dev](https://models.dev) 上的模型列表提供支持,因此您可以使用 `kilo auth login` 来为您想要使用的任何模型配置 API 按键。它存储在 `~/.local/share/opencode/auth.json` 中。 +opencode 由 [Models.dev](https://models.dev) 上的提供商列表支持,因此您可以使用 `kilo auth login` 来为您想要使用的任何提供商配置 API 密钥。它存储在 `~/.local/share/opencode/auth.json` 中。 ```bash kilo auth login ``` -当opencode启动时,它会从auth 文件加载提供商。如果您的环境中定义了任何按键或项目中的`.env`文件。 +当 opencode 启动时,它会从凭据文件加载提供商。以及如果在您的环境或项目中的 `.env` 文件中定义了任何密钥。 --- -#### 列表 +#### list -列出憑證文件中存儲的所有經过身份验证的提供商。 +列出凭据文件中存储的所有经过身份验证的提供商。 ```bash kilo auth list ``` -或者簡短的版本。 +或者简短的版本。 ```bash kilo auth ls @@ -145,9 +145,9 @@ kilo auth ls --- -#### 註銷 +#### logout -通过從憑據文件中清除提供商,将您從提供商中註銷。 +通过从凭据文件中清除提供商,将您从提供商中注销。 ```bash kilo auth logout @@ -165,7 +165,7 @@ opencode github [command] --- -#### 安装 +#### install 在您的存储库中安装 GitHub 代理。 @@ -177,7 +177,7 @@ opencode github install --- -#### 跑步 +#### run 运行 GitHub 代理。这通常用在 GitHub Actions 中。 @@ -185,18 +185,18 @@ opencode github install opencode github run ``` -##### 旗幟 +##### Flags -| 旗幟 | 描述 | +| Flag | Description | | --------- | ------------------------------ | | `--event` | 用于运行代理的 GitHub 模拟事件 | -| `--token` | GitHub 个人访问Tokens | +| `--token` | GitHub 个人访问 Token | --- -### MCP +### mcp -管理模型上下文協議服務器。 +管理模型上下文协议 (MCP) 服务器。 ```bash opencode mcp [command] @@ -204,7 +204,7 @@ opencode mcp [command] --- -#### 添加 +#### add 将 MCP 服务器添加到您的配置中。 @@ -216,7 +216,7 @@ opencode mcp add --- -#### 列表 +#### list 列出所有已配置的 MCP 服务器及其连接状态。 @@ -224,7 +224,7 @@ opencode mcp add opencode mcp list ``` -或者使用簡短版本。 +或者使用简短版本。 ```bash opencode mcp ls @@ -232,7 +232,7 @@ opencode mcp ls --- -#### 授權 +#### auth 使用启用 OAuth 的 MCP 服务器进行身份验证。 @@ -242,13 +242,13 @@ opencode mcp auth [name] 如果您不提供服务器名称,系统将提示您从可用的支持 OAuth 的服务器中进行选择。 -您还可以开始支持 OAuth 的及其服务器身份验证状态。 +您还可以列出支持 OAuth 的服务器及其身份验证状态。 ```bash opencode mcp auth list ``` -或者使用簡短版本。 +或者使用简短版本。 ```bash opencode mcp auth ls @@ -256,9 +256,9 @@ opencode mcp auth ls --- -#### 註銷 +#### logout -删除 MCP 服务器的 OAuth 工具。 +删除 MCP 服务器的 OAuth 凭据。 ```bash opencode mcp logout [name] @@ -266,9 +266,9 @@ opencode mcp logout [name] --- -#### 偵錯 +#### debug -调试MCP服务器的OAuth连接问题。 +调试 MCP 服务器的 OAuth 连接问题。 ```bash opencode mcp debug @@ -276,7 +276,7 @@ opencode mcp debug --- -### 模型 +### models 列出已配置提供商的所有可用模型。 @@ -286,22 +286,22 @@ opencode models [provider] 此命令以 `provider/model` 格式显示您配置的提供商中可用的所有模型。 -这对于确定[你的配置](/docs/config/)中使用的意图模型名称很有帮助。 +这对于确定 [你的配置](/docs/config/) 中使用的确切模型名称很有帮助。 -您可以选择提供项目ID并按该提供项目筛选模型。 +您可以选择提供提供商 ID 并按该提供商筛选模型。 ```bash opencode models anthropic ``` -#### 旗幟 +#### Flags -| 旗幟 | 描述 | +| Flag | Description | | ----------- | ---------------------------------------- | | `--refresh` | 从 models.dev 刷新模型缓存 | | `--verbose` | 使用更详细的模型输出(包括成本等元数据) | -使用`--refresh`标志来更新服务器的模型列表。当新模型已添加到提供商并且您希望在opencode中查看它们时,这非常有用。 +使用 `--refresh` 标志来更新服务器的模型列表。当新模型已添加到提供商并且您希望在 opencode 中查看它们时,这非常有用。 ```bash opencode models --refresh @@ -309,7 +309,7 @@ opencode models --refresh --- -### 跑步 +### run 通过直接传递提示以非交互模式运行 opencode。 @@ -323,7 +323,7 @@ opencode run [message..] opencode run Explain the use of context in Go ``` -您还可以添加到正在运行的`kilo serve`实例,会员每次运行时MCP服务器冷启动时间: +您还可以附加到正在运行的 `kilo serve` 实例,以避免每次运行时 MCP 服务器冷启动时间: ```bash # Start a headless server in one terminal @@ -333,38 +333,38 @@ kilo serve opencode run --attach http://localhost:4096 "Explain async/await in JavaScript" ``` -#### 旗幟 +#### Flags -| 旗幟 | 短 | 描述 | -| ------------ | ---- | --------------------------------------------------------------- | -| `--command` | | 要运行的命令,使用消息作为参数 | -| `--continue` | `-c` | 继续上期 | -| `--session` | `-s` | 会话 ID 继续 | -| `--fork` | | 继续时分叉会话(与 `--continue` 或 `--session` 一起使用) | -| `--share` | | 分享会议 | -| `--model` | `-m` | 以提供商/模型形式使用的模型 | -| `--agent` | | 代理使用 | -| `--file` | `-f` | 要附加到消息的文件 | -| `--format` | | 格式:默认(格式化)或json(原始JSON事件) | -| `--title` | | 会话标题(如果未提供值,则使用断断的提示) | -| `--attach` | | 连接到正在运行的 opencode 服务器(例如,http://localhost:4096) | -| `--port` | | 本地服务器的端口(默认为随机端口) | +| Flag | Short | Description | +| ------------ | ----- | --------------------------------------------------------------- | +| `--command` | | 要运行的命令,使用消息作为参数 | +| `--continue` | `-c` | 继续上一个会话 | +| `--session` | `-s` | 继续的会话 ID | +| `--fork` | | 继续时分叉会话(与 `--continue` 或 `--session` 一起使用) | +| `--share` | | 分享会话 | +| `--model` | `-m` | 使用的模型 (provider/model) | +| `--agent` | | 使用的代理 | +| `--file` | `-f` | 要附加到消息的文件 | +| `--format` | | 格式:default(格式化)或 json(原始 JSON 事件) | +| `--title` | | 会话标题(如果未提供值,则使用截断的提示) | +| `--attach` | | 连接到正在运行的 opencode 服务器(例如,http://localhost:4096) | +| `--port` | | 本地服务器的端口(默认为随机端口) | --- -### 服務 +### serve -启动无头opencode服务器以进行API访问。查看[服务器文档](/docs/server)以获取完整的HTTP 接口。 +启动无头 opencode 服务器以进行 API 访问。查看 [服务器文档](/docs/server) 以获取完整的 HTTP 接口。 ```bash kilo serve ``` -这将启动一个 HTTP 服务器,该服务器提供对 opencode 功能的 API 访问,并占用 TUI 接口。设置 `OPENCODE_SERVER_PASSWORD` 以启用 HTTP 基本身份验证(用户名默认为 `opencode`)。 +这将启动一个 HTTP 服务器,该服务器提供对 opencode 功能的 API 访问,无需 TUI 界面。设置 `OPENCODE_SERVER_PASSWORD` 以启用 HTTP 基本身份验证(用户名默认为 `opencode`)。 -#### 旗幟 +#### Flags -| 旗幟 | 描述 | +| Flag | Description | | ------------ | ------------------------ | | `--port` | 监听端口 | | `--hostname` | 监听的主机名 | @@ -373,7 +373,7 @@ kilo serve --- -### 会话 +### session 管理 opencode 会话。 @@ -383,7 +383,7 @@ opencode session [command] --- -#### 列表 +#### list 列出所有 opencode 会话。 @@ -391,37 +391,37 @@ opencode session [command] opencode session list ``` -##### 旗幟 +##### Flags -| 旗幟 | 短 | 描述 | -| ------------- | ---- | ------------------------------ | -| `--max-count` | `-n` | 限制为最近的 N 个会话 | -| `--format` | | 输出格式:table 或 json(table) | +| Flag | Short | Description | +| ------------- | ----- | ------------------------------ | +| `--max-count` | `-n` | 限制为最近的 N 个会话 | +| `--format` | | 输出格式:table 或 json(table) | --- -### 統計數據 +### stats -显示opencode会话的Tokens使用情况和成本统计信息。 +显示 opencode 会话的 Token 使用情况和成本统计信息。 ```bash opencode stats ``` -#### 旗幟 +#### Flags -| 旗幟 | 描述 | +| Flag | Description | | ----------- | -------------------------------------------------------- | -| `--days` | 显示过去N天(所有时间)的统计数据 | +| `--days` | 显示过去 N 天(所有时间)的统计数据 | | `--tools` | 显示工具数量(全部) | -| `--models` | 隐藏显示模型使用情况解读(默认)。输入一个数字来显示前 N | +| `--models` | 显示模型使用情况细分(默认隐藏)。输入一个数字来显示前 N | | `--project` | 按项目过滤(所有项目,空字符串:当前项目) | --- -### 出口 +### export -将会话数据导出为JSON。 +将会话数据导出为 JSON。 ```bash opencode export [sessionID] @@ -431,7 +431,7 @@ opencode export [sessionID] --- -### 進口 +### import 从 JSON 文件或 opencode 共享 URL 导入会话数据。 @@ -448,19 +448,19 @@ opencode import https://opncd.ai/s/abc123 --- -### 網絡 +### web -使用Web界面启动无头opencode服务器。 +使用 Web 界面启动无头 opencode 服务器。 ```bash opencode web ``` -这将启动HTTP服务器并打开Web浏览器以通过Web界面访问opencode。设置`OPENCODE_SERVER_PASSWORD`以启用HTTP基本身份验证(用户名默认为`opencode`)。 +这将启动 HTTP 服务器并打开 Web 浏览器以通过 Web 界面访问 opencode。设置 `OPENCODE_SERVER_PASSWORD` 以启用 HTTP 基本身份验证(用户名默认为 `opencode`)。 -#### 旗幟 +#### Flags -| 旗幟 | 描述 | +| Flag | Description | | ------------ | ------------------------ | | `--port` | 监听端口 | | `--hostname` | 监听的主机名 | @@ -469,19 +469,19 @@ opencode web --- -### 丙烯酰胺 +### acp -启动ACP(代理客户端协议)服务器。 +启动 ACP (Agent Client Protocol) 服务器。 ```bash opencode acp ``` -此启动一个ACP服务器,该服务器使用nd-JSON通过stdin/stdout进行通信命令。 +此命令启动一个 ACP 服务器,该服务器使用 nd-JSON 通过 stdin/stdout 进行通信。 -#### 旗幟 +#### Flags -| 旗幟 | 描述 | +| Flag | Description | | ------------ | ------------ | | `--cwd` | 工作目录 | | `--port` | 监听端口 | @@ -489,26 +489,26 @@ opencode acp --- -### 解除安装 +### uninstall -卸载opencode并删除所有相关文件。 +卸载 opencode 并删除所有相关文件。 ```bash opencode uninstall ``` -#### 旗幟 +#### Flags -| 旗幟 | 短 | 描述 | -| --------------- | ---- | -------------------------------- | -| `--keep-config` | `-c` | 保留配置文件 | -| `--keep-data` | `-d` | 保留会话数据和快照 | -| `--dry-run` | | 在显示不删除的情况下将删除的内容 | -| `--force` | `-f` | 跳过确认提示 | +| Flag | Short | Description | +| --------------- | ----- | ---------------------------- | +| `--keep-config` | `-c` | 保留配置文件 | +| `--keep-data` | `-d` | 保留会话数据和快照 | +| `--dry-run` | | 显示将删除的内容但不实际删除 | +| `--force` | `-f` | 跳过确认提示 | --- -### 升級 +### upgrade 将 opencode 更新到最新版本或特定版本。 @@ -516,88 +516,88 @@ opencode uninstall kilo upgrade [target] ``` -升級到最新版本。 +升级到最新版本。 ```bash kilo upgrade ``` -升級到特定版本。 +升级到特定版本。 ```bash kilo upgrade v0.1.48 ``` -#### 旗幟 +#### Flags -| 旗幟 | 短 | 描述 | -| ---------- | ---- | ------------------------------------------ | -| `--method` | `-m` | 使用的安装方法;卷曲、npm、pnpm、bun、brew | +| Flag | Short | Description | +| ---------- | ----- | ------------------------------------------ | +| `--method` | `-m` | 使用的安装方法;curl, npm, pnpm, bun, brew | --- -## 全球旗幟 +## Global Flags -opencode CLI采用以下全局标志。 +opencode CLI 接受以下全局标志。 -| 旗幟 | 短 | 描述 | -| -------------- | ---- | ---------------------------------- | -| `--help` | `-h` | 显示帮助 | -| `--version` | `-v` | 打印版本号 | -| `--print-logs` | | 将日志打印到stderr | -| `--log-level` | | 日志级别(调试、信息、警告、错误) | +| Flag | Short | Description | +| -------------- | ----- | ----------------------------------- | +| `--help` | `-h` | 显示帮助 | +| `--version` | `-v` | 打印版本号 | +| `--print-logs` | | 将日志打印到 stderr | +| `--log-level` | | 日志级别 (DEBUG, INFO, WARN, ERROR) | --- -## 環境變量 +## Environment variables -可以使用环境变量配置opencode。 +可以使用环境变量配置 opencode。 -| 變量 | 類型 | 描述 | -| ------------------------------------- | ------ | ---------------------------------------- | -| `OPENCODE_AUTO_SHARE` | 布尔 | 自动共享会话 | -| `OPENCODE_GIT_BASH_PATH` | 字符串 | Windows 上 Git Bash 可执行文件的路径 | -| `OPENCODE_CONFIG` | 字符串 | 配置文件路径 | -| `OPENCODE_CONFIG_DIR` | 字符串 | 配置目录的路径 | -| `OPENCODE_CONFIG_CONTENT` | 字符串 | 内联 json 配置内容 | -| `OPENCODE_DISABLE_AUTOUPDATE` | 布尔 | 取消自动更新检查 | -| `OPENCODE_DISABLE_PRUNE` | 布尔 | 取消数据的裁剪 | -| `OPENCODE_DISABLE_TERMINAL_TITLE` | 布尔 | 取消自动终端标题更新 | -| `OPENCODE_PERMISSION` | 字符串 | 内联 json 权限配置 | -| `OPENCODE_DISABLE_DEFAULT_PLUGINS` | 布尔 | 取消默认插件 | -| `OPENCODE_DISABLE_LSP_DOWNLOAD` | 布尔 | 禁用自动 LSP 服务器下载 | -| `OPENCODE_ENABLE_EXPERIMENTAL_MODELS` | 布尔 | 制作实验模型 | -| `OPENCODE_DISABLE_AUTOCOMPACT` | 布尔 | 取消自动上下文压缩 | -| `OPENCODE_DISABLE_CLAUDE_CODE` | 布尔 | 禁止从 `.claude` 读取(提示+技巧) | -| `OPENCODE_DISABLE_CLAUDE_CODE_PROMPT` | 布尔 | 禁用读取`~/.claude/CLAUDE.md` | -| `OPENCODE_DISABLE_CLAUDE_CODE_SKILLS` | 布尔 | 禁用加载`.claude/skills` | -| `OPENCODE_DISABLE_MODELS_FETCH` | 布尔 | 禁止从远程源获取模型 | -| `OPENCODE_FAKE_VCS` | 字符串 | 用于测试目的的假 VCS 成立 | -| `OPENCODE_DISABLE_FILETIME_CHECK` | 布尔 | 取消文件时间检查以进行优化 | -| `OPENCODE_CLIENT` | 字符串 | 客户端标识符(默认为`cli`) | -| `OPENCODE_ENABLE_EXA` | 布尔 | 启用 Exa 网络搜索工具 | -| `OPENCODE_SERVER_PASSWORD` | 字符串 | 为 `serve`/`web` 赠送基本身份验证 | -| `OPENCODE_SERVER_USERNAME` | 字符串 | 覆盖基本身份验证用户名(默认`opencode`) | -| `OPENCODE_MODELS_URL` | 字符串 | 用于获取模型配置的自定义 URL | +| Variable | Type | Description | +| ------------------------------------- | ------- | ----------------------------------------- | +| `OPENCODE_AUTO_SHARE` | boolean | 自动共享会话 | +| `OPENCODE_GIT_BASH_PATH` | string | Windows 上 Git Bash 可执行文件的路径 | +| `OPENCODE_CONFIG` | string | 配置文件路径 | +| `OPENCODE_CONFIG_DIR` | string | 配置目录的路径 | +| `OPENCODE_CONFIG_CONTENT` | string | 内联 json 配置内容 | +| `OPENCODE_DISABLE_AUTOUPDATE` | boolean | 禁用自动更新检查 | +| `OPENCODE_DISABLE_PRUNE` | boolean | 禁用数据的修剪 | +| `OPENCODE_DISABLE_TERMINAL_TITLE` | boolean | 禁用自动终端标题更新 | +| `OPENCODE_PERMISSION` | string | 内联 json 权限配置 | +| `OPENCODE_DISABLE_DEFAULT_PLUGINS` | boolean | 禁用默认插件 | +| `OPENCODE_DISABLE_LSP_DOWNLOAD` | boolean | 禁用自动 LSP 服务器下载 | +| `OPENCODE_ENABLE_EXPERIMENTAL_MODELS` | boolean | 启用实验模型 | +| `OPENCODE_DISABLE_AUTOCOMPACT` | boolean | 禁用自动上下文压缩 | +| `OPENCODE_DISABLE_CLAUDE_CODE` | boolean | 禁用从 `.claude` 读取(提示+技能) | +| `OPENCODE_DISABLE_CLAUDE_CODE_PROMPT` | boolean | 禁用读取 `~/.claude/CLAUDE.md` | +| `OPENCODE_DISABLE_CLAUDE_CODE_SKILLS` | boolean | 禁用加载 `.claude/skills` | +| `OPENCODE_DISABLE_MODELS_FETCH` | boolean | 禁用从远程源获取模型 | +| `OPENCODE_FAKE_VCS` | string | 用于测试目的的伪造 VCS | +| `OPENCODE_DISABLE_FILETIME_CHECK` | boolean | 禁用文件时间检查以进行优化 | +| `OPENCODE_CLIENT` | string | 客户端标识符(默认为 `cli`) | +| `OPENCODE_ENABLE_EXA` | boolean | 启用 Exa 网络搜索工具 | +| `OPENCODE_SERVER_PASSWORD` | string | 为 `serve`/`web` 启用基本身份验证 | +| `OPENCODE_SERVER_USERNAME` | string | 覆盖基本身份验证用户名(默认 `opencode`) | +| `OPENCODE_MODELS_URL` | string | 用于获取模型配置的自定义 URL | --- -### 實驗性的 +### Experimental -这些環境變量启用可能会更改或删除的實驗性功能。 +这些环境变量启用可能会更改或删除的实验性功能。 -| 變量 | 類型 | 描述 | -| ----------------------------------------------- | ---- | ----------------------------------- | -| `OPENCODE_EXPERIMENTAL` | 布尔 | 实现所有实验性功能 | -| `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | 布尔 | 添加图标发现 | -| `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | 布尔 | 在 TUI 中禁用选择时复制 | -| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | 数量 | bash 命令的默认超时(以毫秒为单位) | -| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | 数量 | LLM 响应的最大输出Tokens | -| `OPENCODE_EXPERIMENTAL_FILEWATCHER` | 布尔 | 为整个目录启用文件观察器 | -| `OPENCODE_EXPERIMENTAL_OXFMT` | 布尔 | 启用 oxfmt 清理程序 | -| `OPENCODE_EXPERIMENTAL_LSP_TOOL` | 布尔 | 实现实验性 LSP 工具 | -| `OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER` | 布尔 | 禁用文件观察器 | -| `OPENCODE_EXPERIMENTAL_EXA` | 布尔 | 实现实验性Exa功能 | -| `OPENCODE_EXPERIMENTAL_LSP_TY` | 布尔 | 实现实验性 LSP 类型检查 | -| `OPENCODE_EXPERIMENTAL_MARKDOWN` | 布尔 | 实现实验性 Markdown 功能 | -| `OPENCODE_EXPERIMENTAL_PLAN_MODE` | 布尔 | 启用计划模式 | +| Variable | Type | Description | +| ----------------------------------------------- | ------- | ----------------------------------- | +| `OPENCODE_EXPERIMENTAL` | boolean | 启用所有实验性功能 | +| `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | boolean | 启用图标发现 | +| `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | boolean | 在 TUI 中禁用选择时复制 | +| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | number | bash 命令的默认超时(以毫秒为单位) | +| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | number | LLM 响应的最大输出 Token | +| `OPENCODE_EXPERIMENTAL_FILEWATCHER` | boolean | 为整个目录启用文件观察器 | +| `OPENCODE_EXPERIMENTAL_OXFMT` | boolean | 启用 oxfmt 格式化程序 | +| `OPENCODE_EXPERIMENTAL_LSP_TOOL` | boolean | 启用实验性 LSP 工具 | +| `OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER` | boolean | 禁用文件观察器 | +| `OPENCODE_EXPERIMENTAL_EXA` | boolean | 启用实验性 Exa 功能 | +| `OPENCODE_EXPERIMENTAL_LSP_TY` | boolean | 启用实验性 LSP 类型检查 | +| `OPENCODE_EXPERIMENTAL_MARKDOWN` | boolean | 启用实验性 Markdown 功能 | +| `OPENCODE_EXPERIMENTAL_PLAN_MODE` | boolean | 启用计划模式 | diff --git a/packages/web/src/content/docs/zh-cn/commands.mdx b/packages/web/src/content/docs/zh-cn/commands.mdx index 296fd2631..626ae459b 100644 --- a/packages/web/src/content/docs/zh-cn/commands.mdx +++ b/packages/web/src/content/docs/zh-cn/commands.mdx @@ -1,5 +1,5 @@ --- -title: 命令 +title: Commands description: 为重复任务创建自定义命令。 --- @@ -9,15 +9,15 @@ description: 为重复任务创建自定义命令。 /my-command ``` -除了`/init`、`/undo`、`/redo`、`/share`、`/help`等内置命令之外,还有自定义命令。 [了解更多](/docs/tui#commands)。 +除了 `/init`、`/undo`、`/redo`、`/share`、`/help` 等内置命令之外,还有自定义命令。 [了解更多](/docs/tui#commands)。 --- ## 创建命令文件 -在`commands/`目录中创建markdown文件来定义自定义命令。 +在 `commands/` 目录中创建 markdown 文件来定义自定义命令。 -创建`.opencode/commands/test.md`: +创建 `.opencode/commands/test.md`: ```md title=".opencode/commands/test.md" --- @@ -32,7 +32,7 @@ Focus on the failing tests and suggest fixes. frontmatter 定义命令属性。内容成为模板。 -通过鍵入 `/` 後跟命令名称來使用该命令。 +通过键入 `/` 后跟命令名称来使用该命令。 ```bash frame="none" "/test" @@ -79,7 +79,7 @@ frontmatter 定义命令属性。内容成为模板。 您还可以使用 Markdown 文件定义命令。将它们放入: -- 全球:`~/.config/opencode/commands/` +- 全局:`~/.config/opencode/commands/` - 每个项目:`.opencode/commands/` ```markdown title="~/.config/opencode/commands/test.md" @@ -94,7 +94,7 @@ Focus on the failing tests and suggest fixes. ``` Markdown 文件名成为命令名。例如,`test.md` 让 -你運行: +你运行: ```bash frame="none" /test @@ -104,13 +104,13 @@ Markdown 文件名成为命令名。例如,`test.md` 让 ## 提示配置 -自定義命令的提示支持幾个特殊的佔位符和語法。 +自定义命令的提示支持几个特殊的占位符和语法。 --- -### 論據 +### Arguments -使用`$ARGUMENTS`占位符将参数提交给命令。 +使用 `$ARGUMENTS` 占位符将参数提交给命令。 ```md title=".opencode/commands/component.md" --- @@ -121,7 +121,7 @@ Create a new React component named $ARGUMENTS with TypeScript support. Include proper typing and basic structure. ``` -使用參數運行命令: +使用参数运行命令: ```bash frame="none" /component Button @@ -129,11 +129,11 @@ Include proper typing and basic structure. `$ARGUMENTS` 将替换为 `Button`。 -您还可以使用位置參數访问各个參數: +您还可以使用位置参数访问各个参数: -- `$1` - 第一个參數 -- `$2` - 第二个參數 -- `$3` - 第三个參數 +- `$1` - 第一个参数 +- `$2` - 第二个参数 +- `$3` - 第三个参数 - 等等... 例如: @@ -147,7 +147,7 @@ Create a file named $1 in the directory $2 with the following content: $3 ``` -運行命令: +运行命令: ```bash frame="none" /create-file config.json src "{ \"key\": \"value\" }" @@ -161,11 +161,11 @@ with the following content: $3 --- -### 外殼輸出 +### Shell Output -使用 _!`command`_ 将 [bash命令](/docs/tui#bash-commands) 输出注入到提示符中。 +使用 _!`command`_ 将 [bash 命令](/docs/tui#bash-commands) 输出注入到提示符中。 -例如,要创建分析測試覆盖率的自定義命令: +例如,要创建分析测试覆盖率的自定义命令: ```md title=".opencode/commands/analyze-coverage.md" --- @@ -191,13 +191,13 @@ Recent git commits: Review these changes and suggest any improvements. ``` -命令在項目的根目录中運行,其輸出成为提示的一部分。 +命令在项目的根目录中运行,其输出成为提示的一部分。 --- -### 文件參考 +### File Reference -使用 `@` 後跟文件名将文件包含在命令中。 +使用 `@` 后跟文件名将文件包含在命令中。 ```md title=".opencode/commands/review-component.md" --- @@ -208,17 +208,17 @@ Review the component in @src/components/Button.tsx. Check for performance issues and suggest improvements. ``` -文件內容会自动包含在提示中。 +文件内容会自动包含在提示中。 --- -## 選項 +## 选项 -讓我们詳細看看配置選項。 +让我们详细看看配置选项。 --- -### 模板 +### template `template` 选项定义执行命令时将发送到 LLM 的提示。 @@ -232,11 +232,11 @@ Check for performance issues and suggest improvements. } ``` -这是一个**必需的**配置選項。 +这是一个 **必需的** 配置选项。 --- -### 描述 +### description 使用 `description` 选项提供命令功能的简要描述。 @@ -254,11 +254,11 @@ Check for performance issues and suggest improvements. --- -### 代理人 +### agent -使用`agent`配置选择指定哪个[代理人](/docs/agents)应执行此命令。 -如果是 [子代理](/docs/agents/#subagents) 该命令将默认触发子代理调用。 -要取消此行为,则将`subtask`设置为`false`。 +使用 `agent` 配置选择指定哪个 [Agent](/docs/agents) 应执行此命令。 +如果是 [Subagents](/docs/agents/#subagents) 该命令将默认触发子代理调用。 +要取消此行为,则将 `subtask` 设置为 `false`。 ```json title="opencode.json" { @@ -270,15 +270,15 @@ Check for performance issues and suggest improvements. } ``` -这是一个**可選**配置選項。如果未指定,则默認为您当前的代理。 +这是一个 **可选** 配置选项。如果未指定,则默认为您当前的代理。 --- -### 子任务 +### subtask -使用`subtask`布尔值强制命令触发[子代理](/docs/agents/#subagents)调用。 -如果您希望命令不污染您的主要上下文并且将**強制**代理充当子代理,那麼这非常有用, -即使`mode`在[代理人](/docs/agents)配置上设置为`primary`。 +使用 `subtask` 布尔值强制命令触发 [Subagents](/docs/agents/#subagents) 调用。 +如果您希望命令不污染您的主要上下文并且将 **强制** 代理充当子代理,那么这非常有用, +即使 `mode` 在 [Agent](/docs/agents) 配置上设置为 `primary`。 ```json title="opencode.json" { @@ -290,11 +290,11 @@ Check for performance issues and suggest improvements. } ``` -这是一个**可選**配置選項。 +这是一个 **可选** 配置选项。 --- -### 模型 +### model 使用 `model` 配置覆盖此命令的默认模型。 @@ -308,16 +308,16 @@ Check for performance issues and suggest improvements. } ``` -这是一个**可選**配置選項。 +这是一个 **可选** 配置选项。 --- -## 內建 +## 内置 -opencode包含`/init`、`/undo`、`/redo`、`/share`、`/help`等内置命令;【了解更多](/docs/tui#commands)。 +opencode 包含 `/init`、`/undo`、`/redo`、`/share`、`/help` 等内置命令;[了解更多](/docs/tui#commands)。 :::note -自定義命令可以覆盖内置命令。 +自定义命令可以覆盖内置命令。 ::: -如果您定義同名的自定義命令,它将覆盖内置命令。 +如果您定义同名的自定义命令,它将覆盖内置命令。 diff --git a/packages/web/src/content/docs/zh-cn/config.mdx b/packages/web/src/content/docs/zh-cn/config.mdx index 9bc3afa97..bae9e3a95 100644 --- a/packages/web/src/content/docs/zh-cn/config.mdx +++ b/packages/web/src/content/docs/zh-cn/config.mdx @@ -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`)- 项目特定的设置 +1. **Remote config** (来自 `.well-known/opencode`) - 组织默认值 +2. **Global config** (`~/.config/opencode/opencode.json`) - 用户首选项 +3. **Custom config** (`OPENCODE_CONFIG` env var) - 自定义覆盖 +4. **Project config** (项目中的 `opencode.json`) - 项目特定的设置 5. **`.opencode` 目录** - 代理、命令、插件 -6. **内联配置** (`OPENCODE_CONFIG_CONTENT` env var) - 运行时覆盖 +6. **Inline config** (`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/`)。 ::: --- -### 偏僻的 +### Remote 组织可以通过 `.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,29 +92,29 @@ opencode 支持 **JSON** 和 **JSONC**(带注释的 JSON)格式。 --- -### 全球的 +### Global 将全局 opencode 配置放在 `~/.config/opencode/opencode.json` 中。使用全局配置来实现用户范围的首选项,例如主题、提供商或按键绑定。 -全局配置覆盖遠程組織默認值。 +全局配置覆盖远程组织默认值。 --- -### 每个項目 +### Per Project -在项目根目录中添加`opencode.json`。项目配置在标准配置文件中具有最高优先级 - 它覆盖全局配置和远程配置。 +在项目根目录中添加 `opencode.json`。项目配置在标准配置文件中具有最高优先级 - 它覆盖全局配置和远程配置。 :::tip -将項目特定配置放在項目的根目录中。 +将项目特定配置放在项目的根目录中。 ::: -当opencode启动时,它会在当前目录中查找配置文件或打开到最近的Git目录。 +当 opencode 启动时,它会在当前目录中查找配置文件或向上遍历到最近的 Git 目录。 -这也可以安全地签入 Git 并使用与全局模式相同的模式。 +这也可以安全地签入 Git 并使用与全局模式相同的架构。 --- -### 自定義路徑 +### Custom Path 使用 `OPENCODE_CONFIG` 环境变量指定自定义配置文件路径。 @@ -124,35 +123,32 @@ export OPENCODE_CONFIG=/path/to/my/custom-config.json opencode run "Hello world" ``` -自定義配置按优先顺序在全局配置和項目配置之間加載。 +自定义配置按优先顺序在全局配置和项目配置之间加载。 --- -### 自定義目录 +### Custom Directory -使用`OPENCODE_CONFIG_DIR`指定自定义配置目录 -環境變量。将在该目录中搜索代理、命令、 -模式和插件类似于标准`.opencode`目录一样,并且应该 -遵循相同的結構。 +使用 `OPENCODE_CONFIG_DIR` 环境变量指定自定义配置目录。将在该目录中搜索代理、命令、模式和插件,就像标准 `.opencode` 目录一样,并且应该遵循相同的结构。 ```bash export OPENCODE_CONFIG_DIR=/path/to/my/config-directory opencode run "Hello world" ``` -自定义目录在全局配置和`.opencode`目录加载后,因此**可以覆盖**它们的设置。 +自定义目录在全局配置和 `.opencode` 目录加载后,因此 **可以覆盖** 它们的设置。 --- ## 模式 -配置文件具有在 [**`kilo.ai/config.json`**](https://kilo.ai/config.json) 中配置的架构。 +配置文件具有在 [**`kilo.ai/config.json`**](https://kilo.ai/config.json) 中定义的架构。 -您的编辑器应该能夠根據架構進行驗證和自动完成。 +您的编辑器应该能够根据架构进行验证和自动完成。 --- -### 途易 +### TUI 您可以通过 `tui` 选项配置特定于 TUI 的设置。 @@ -169,19 +165,19 @@ opencode run "Hello world" } ``` -可用選項: +可用选项: -- `scroll_acceleration.enabled` - 启用 macOS 风格的滚动加速。 **优先于`scroll_speed`。 ** -- `scroll_speed` - 自定义滚动速度倍增(默认值:`3`,简单:`1`)。如果`scroll_acceleration.enabled`是`true`,则忽略。 -- `diff_style` - 控制差异渲染。 `"auto"` 适应宽度,`"stacked"` 始终显示单列。 +- `scroll_acceleration.enabled` - 启用 macOS 风格的滚动加速。 **优先于 `scroll_speed`。** +- `scroll_speed` - 自定义滚动速度倍增(默认值:`3`,最小值:`1`)。如果 `scroll_acceleration.enabled` 是 `true`,则忽略。 +- `diff_style` - 控制差异渲染。 `"auto"` 适应终端宽度,`"stacked"` 始终显示单列。 [在此处了解有关使用 TUI 的更多信息](/docs/tui)。 --- -### 服务器 +### Server -您可以通过`server` 选项为`kilo serve` 和`opencode web` 命令配置服务器设置。 +您可以通过 `kilo serve` 选项为 `opencode web` 和 `server` 命令配置服务器设置。 ```json title="opencode.json" { @@ -196,21 +192,21 @@ opencode run "Hello world" } ``` -可用選項: +可用选项: -- Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try again later.That’s all we know. -- Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try again later.That’s all we know. +- `port` - 监听端口。 +- `hostname` - 监听的主机名。当 `mdns` 启用且未设置主机名时,默认为 `0.0.0.0`。 - `mdns` - 启用 mDNS 服务发现。这允许网络上的其他设备发现您的 opencode 服务器。 - `mdnsDomain` - mDNS 服务的自定义域名。默认为 `opencode.local`。对于在同一个网络上运行多个实例很有帮助。 -- `cors` - 从基于浏览器的客户端使用 HTTP 服务器时允许 CORS 的其他来源。值必须是完整来源(方案+主机+任选端口),例如 `https://app.example.com`。 +- `cors` - 从基于浏览器的客户端使用 HTTP 服务器时允许 CORS 的其他来源。值必须是完整来源(协议+主机+可选端口),例如 `https://app.example.com`。 [在此处了解有关服务器的更多信息](/docs/server)。 --- -### 工具 +### Tools -您可以通过 `tools` 选项管理LLM可以使用的工具。 +您可以通过 `tools` 选项管理 LLM 可以使用的工具。 ```json title="opencode.json" { @@ -226,9 +222,9 @@ opencode run "Hello world" --- -### 模型 +### Models -您可以通过 `provider`、`model` 和 `small_model` 选项来配置要在 opencode 配置中使用的提供的程序和模型。 +您可以通过 `provider`、`model` 和 `small_model` 选项来配置要在 opencode 配置中使用的提供商和模型。 ```json title="opencode.json" { @@ -241,7 +237,7 @@ opencode run "Hello world" `small_model` 选项为标题生成等轻量级任务配置单独的模型。默认情况下,如果您的提供商可以提供更便宜的模型,opencode 会尝试使用更便宜的模型,否则它会退回到您的主模型。 -提供商选项可以包括`timeout`和`setCacheKey`: +提供商选项可以包括 `timeout` 和 `setCacheKey`: ```json title="opencode.json" { @@ -258,17 +254,17 @@ opencode run "Hello world" ``` - `timeout` - 请求超时以毫秒为单位(默认值:300000)。设置为 `false` 以禁用。 -- `setCacheKey` -确保始终为指定的提供商设置存储硬盘。 +- `setCacheKey` - 确保始终为指定的提供商设置缓存键。 -您还可以配置[本地模型](/docs/models#local)。[了解更多](/docs/models)。 +您还可以配置 [本地模型](/docs/models#local)。[了解更多](/docs/models)。 --- -#### 特定于提供商的選項 +#### 特定于提供商的选项 有些提供商支持除通用 `timeout` 和 `apiKey` 之外的其他配置选项。 -##### 亞馬遜基岩 +##### Amazon Bedrock Amazon Bedrock 支持 AWS 特定配置: @@ -292,16 +288,16 @@ Amazon Bedrock 支持 AWS 特定配置: - `endpoint` - VPC 终端节点的自定义节点 URL。这是使用 AWS 特定术语的通用 `baseURL` 选项的别名。如果两者都指定,`endpoint` 优先。 :::note -承载Tokens(`AWS_BEARER_TOKEN_BEDROCK` 或`/connect`)优先于基于配置文件的身份验证。详情请参见【认证优先级](/docs/providers#authentication-precedence)。 +Bearer Tokens (`AWS_BEARER_TOKEN_BEDROCK` 或 `/connect`) 优先于基于配置文件的身份验证。详情请参见 [身份验证优先级](/docs/providers#authentication-precedence)。 ::: [了解有关 Amazon Bedrock 配置的更多信息](/docs/providers#amazon-bedrock)。 --- -### 主题 +### Theme -您可以通过 opencode 配置中配置中的 `theme` 选项要使用的主题。 +您可以通过 opencode 配置中的 `theme` 选项配置要使用的主题。 ```json title="opencode.json" { @@ -314,7 +310,7 @@ Amazon Bedrock 支持 AWS 特定配置: --- -### 代理商 +### Agents 您可以通过 `agent` 选项为特定任务配置专用代理。 @@ -340,9 +336,9 @@ Amazon Bedrock 支持 AWS 特定配置: --- -### 默認代理 +### Default Agent -您可以使用 `default_agent` 选项默认设置代理。当没有明确指定时,这将确定使用哪个代理。 +您可以使用 `default_agent` 选项设置默认代理。当没有明确指定时,这将确定使用哪个代理。 ```json title="opencode.json" { @@ -351,15 +347,15 @@ Amazon Bedrock 支持 AWS 特定配置: } ``` -Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try again later.That’s all we know. +默认代理必须是 Primary 代理(不是 Subagent)。这可以是内置代理(如 `"build"` 或 `"plan"`),也可以是您定义的 [Custom Agent](/docs/agents)。如果指定的代理不存在或者是子代理,opencode 将回退到 `"build"` 并发出警告。 此设置适用于所有界面:TUI、CLI (`opencode run`)、桌面应用程序和 GitHub Action。 --- -### 分享 +### Share -您可以通过`share`选项配置[分享](/docs/share)功能。 +您可以通过 `share` 选项配置 [分享](/docs/share) 功能。 ```json title="opencode.json" { @@ -370,7 +366,7 @@ Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try 这需要: -- Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try again later.That’s all we know. +- `"manual"` - 允许通过命令手动共享(默认) - `"auto"` - 自动分享新对话 - `"disabled"` - 完全禁用共享 @@ -378,9 +374,9 @@ Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try --- -### 命令 +### Command -您可以通过`command`选项为重复任务配置自定义命令。 +您可以通过 `command` 选项为重复任务配置自定义命令。 ```jsonc title="opencode.jsonc" { @@ -404,7 +400,7 @@ Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try --- -### 按鍵綁定 +### Keybinds 您可以通过 `keybinds` 选项自定义您的按键绑定。 @@ -419,9 +415,9 @@ Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try --- -### 自动更新 +### Autoupdate -opencode 将在启动时自动下载任何新的更新。您可以使用 `autoupdate` 选项取消此功能。 +opencode 将在启动时自动下载任何新的更新。您可以使用 `autoupdate` 选项禁用此功能。 ```json title="opencode.json" { @@ -430,14 +426,14 @@ opencode 将在启动时自动下载任何新的更新。您可以使用 `autoup } ``` -如果您不想更新但希望在新版本可用时收到通知,则需将`autoupdate`设置为`"notify"`。 +如果您不想更新但希望在新版本可用时收到通知,则需将 `autoupdate` 设置为 `"notify"`。 请注意,这仅在未使用 Homebrew 等包管理器安装时才有效。 --- -### 格式化程序 +### Formatters -您可以通过`formatter`选项配置代码初始化程序。 +您可以通过 `formatter` 选项配置代码格式化程序。 ```json title="opencode.json" { @@ -457,11 +453,11 @@ opencode 将在启动时自动下载任何新的更新。您可以使用 `autoup } ``` -Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try again later.That’s all we know. +[在这里了解有关格式化程序的更多信息](/docs/formatters)。 --- -### 权限 +### Permissions 默认情况下,opencode **允许所有操作**,无需明确批准。您可以使用 `permission` 选项更改此设置。 @@ -481,7 +477,7 @@ Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try --- -### 壓實 +### Compaction 您可以通过 `compaction` 选项控制上下文压缩行为。 @@ -495,14 +491,14 @@ Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try } ``` -- Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try again later.That’s all we know. -- `prune` - 删除旧工具以输出保存Tokens(默认值:`true`)。 +- `auto` - 当上下文已满时自动压缩会话(默认值:`true`)。 +- `prune` - 删除旧工具输出以保存 Tokens(默认值:`true`)。 --- -### 守望者 +### Watcher -您可以通过`watcher`选项配置文件观察器忽略模式。 +您可以通过 `watcher` 选项配置文件观察器忽略模式。 ```json title="opencode.json" { @@ -513,11 +509,11 @@ Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try } ``` -模式遵循 glob 语法。使用它可以从文件监视中排除杂的目录。 +模式遵循 glob 语法。使用它可以从文件监视中排除嘈杂的目录。 --- -### MCP服务器 +### MCP Servers 您可以通过 `mcp` 选项配置要使用的 MCP 服务器。 @@ -532,11 +528,11 @@ Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try --- -### 插件 +### Plugins -[插件](/docs/plugins) 使用自定义工具、挂钩和集成扩展 opencode。 +[Plugins](/docs/plugins) 使用自定义工具、挂钩和集成扩展 opencode。 -将插件文件放置在`.opencode/plugins/` 或`~/.config/opencode/plugins/` 中。您还可以通过 `plugin` 选项从 npm 加载插件。 +将插件文件放置在 `.opencode/plugins/` 或 `~/.config/opencode/plugins/` 中。您还可以通过 `plugin` 选项从 npm 加载插件。 ```json title="opencode.json" { @@ -549,7 +545,7 @@ Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try --- -### 指示 +### Instructions 您可以通过 `instructions` 选项配置您正在使用的模型的说明。 @@ -560,14 +556,13 @@ Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try } ``` -这需要指令文件的路徑和全局模式數組。 [了解更多 -关于规则在这里](/docs/rules)。 +这需要指令文件的路径和 glob 模式数组。 [在此处了解有关规则的更多信息](/docs/rules)。 --- -### 殘疾服務提供商 +### Disabled Providers -您可以通过 `disabled_providers` 选项取消自动加载的提供商。当您想要阻止加载某些提供商(即使其可用)时,这非常有用。 +您可以通过 `disabled_providers` 选项禁用自动加载的提供商。当您想要阻止加载某些提供商(即使其凭据可用)时,这非常有用。 ```json title="opencode.json" { @@ -577,20 +572,20 @@ Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try ``` :::note -`disabled_providers` 优先于`enabled_providers`。 +`disabled_providers` 优先于 `enabled_providers`。 ::: -`disabled_providers` 选项接受提供商 ID 内存。当提供商被取消时: +`disabled_providers` 选项接受提供商 ID 数组。当提供商被禁用时: -- 即使设置了環境變量也不会加載。 -- 即使通过`/connect`命令配置API钥匙,也不会加载它。 -- 提供商的模型不会出現在模型选择列表中。 +- 即使设置了环境变量也不会加载。 +- 即使通过 `/connect` 命令配置 API 密钥,也不会加载它。 +- 提供商的模型不会出现在模型选择列表中。 --- -### 启用的提供商 +### Enabled Providers -Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try again later.That’s all we know. +您可以通过 `enabled_providers` 选项指定允许的提供商列表。设置后,仅启用指定的提供商,所有其他提供商将被忽略。 ```json title="opencode.json" { @@ -599,17 +594,17 @@ Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try } ``` -当您想要限制 opencode 仅使用特定的提供商而不是一一禁止它们时,这非常有用。 +当您想要限制 opencode 仅使用特定的提供商而不是逐一禁用它们时,这非常有用。 :::note -`disabled_providers` 优先于`enabled_providers`。 +`disabled_providers` 优先于 `enabled_providers`。 ::: -如果有人提供商同时出现在`enabled_providers`和`disabled_providers`中,则`disabled_providers`优先考虑一致性。 +如果提供商同时出现在 `enabled_providers` 和 `disabled_providers` 中,则 `disabled_providers` 优先以保持一致性。 --- -### 實驗性的 +### Experimental `experimental` 键包含正在积极开发的选项。 @@ -621,20 +616,20 @@ Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try ``` :::caution -實驗選項不穩定。它們可能会更改或被删除,恕不另行通知。 +实验选项不稳定。它们可能会更改或被删除,恕不另行通知。 ::: --- -## 變量 +## Variables -您可以在配置文件中使用變量替換來引用環境變量和文件內容。 +您可以在配置文件中使用变量替换来引用环境变量和文件内容。 --- -### 環境變量 +### Env Vars -使用`{env:VARIABLE_NAME}`替换环境变量: +使用 `{env:VARIABLE_NAME}` 替换环境变量: ```json title="opencode.json" { @@ -651,11 +646,11 @@ Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try } ``` -如果未设置環境變量,它将被替換为空字符串。 +如果未设置环境变量,它将被替换为空字符串。 --- -### 文件 +### Files 使用 `{file:path/to/file}` 替换文件的内容: @@ -673,13 +668,13 @@ Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try } ``` -文件路徑可以是: +文件路径可以是: - 相对于配置文件目录 -- 或者以 `/` 或 `~` 開頭的絕对路徑 +- 或者以 `/` 或 `~` 开头的绝对路径 这些对于: -- 将API等敏感数据保存在单独的文件中。 -- 包含大型指令文件,而不会弄亂您的配置。 +- 将 API 密钥等敏感数据保存在单独的文件中。 +- 包含大型指令文件,而不会弄乱您的配置。 - 跨多个配置文件共享通用配置片段。 diff --git a/packages/web/src/content/docs/zh-cn/custom-tools.mdx b/packages/web/src/content/docs/zh-cn/custom-tools.mdx index 132a9d514..503b1e1df 100644 --- a/packages/web/src/content/docs/zh-cn/custom-tools.mdx +++ b/packages/web/src/content/docs/zh-cn/custom-tools.mdx @@ -1,9 +1,9 @@ --- -title: 定制工具 -description: 创建法學碩士可以在opencode中调用的工具。 +title: 自定义工具 +description: 创建 LLM 可以在 opencode 中调用的工具。 --- -自定义工具是您创建的函数,LLM 可以在对话期间调用。它们与 opencode 的[内置工具](/docs/tools) 一起工作,例如 `read`、`write` 和 `bash`。 +自定义工具是您创建的函数,LLM 可以在对话期间调用。它们与 opencode 的 [Built-in Tools](/docs/tools) 一起工作,例如 `read`、`write` 和 `bash`。 --- @@ -13,16 +13,16 @@ description: 创建法學碩士可以在opencode中调用的工具。 --- -### 地點 +### Location -它們可以定義为: +它们可以定义为: - 通过将它们放在项目的 `.opencode/tools/` 目录中来本地进行。 - 或者在全局范围内,将它们放在 `~/.config/opencode/tools/` 中。 --- -### 結構 +### Structure 创建工具最简单的方法是使用 `tool()` 帮助程序,它提供类型安全和验证。 @@ -41,13 +41,13 @@ export default tool({ }) ``` -**文件名**成为**工具名称**。以上创建了一个 `database` 工具。 +**文件名** 成为 **工具名称**。以上创建了一个 `database` 工具。 --- #### 每个文件多个工具 -您还可以從單个文件導出多个工具。每个導出都会成为**一个單獨的工具**,名称为**` _ `**: +您还可以从单个文件导出多个工具。每个导出都会成为 **一个单独的工具**,名称为 **` _ `**: ```ts title=".opencode/tools/math.ts" import { tool } from "@opencode-ai/plugin" @@ -79,9 +79,9 @@ export const multiply = tool({ --- -### 論據 +### Arguments -您可以使用`tool.schema`(即[佐德](https://zod.dev))来定义参数类型。 +您可以使用 `tool.schema`(即 [Zod](https://zod.dev))来定义参数类型。 ```ts "tool.schema" args: { @@ -89,7 +89,7 @@ args: { } ``` -您还可以直接导入[佐德](https://zod.dev)并返回一个普通对象: +您还可以直接导入 [Zod](https://zod.dev) 并返回一个普通对象: ```ts {6} import { z } from "zod" @@ -108,9 +108,9 @@ export default { --- -### 情境 +### Context -工具接收有關当前会话的上下文: +工具接收有关当前会话的上下文: ```ts title=".opencode/tools/project.ts" {8} import { tool } from "@opencode-ai/plugin" @@ -133,7 +133,7 @@ export default tool({ ## 示例 -### 用Python编写一个工具 +### 使用 Python 编写工具 您可以使用任何您想要的语言编写工具。下面是一个使用 Python 将两个数字相加的示例。 @@ -147,7 +147,7 @@ b = int(sys.argv[2]) print(a + b) ``` -然後创建调用它的工具定義: +然后创建调用它的工具定义: ```ts title=".opencode/tools/python-add.ts" {10} import { tool } from "@opencode-ai/plugin" diff --git a/packages/web/src/content/docs/zh-cn/ecosystem.mdx b/packages/web/src/content/docs/zh-cn/ecosystem.mdx index c2ba60cb1..a44ee90a0 100644 --- a/packages/web/src/content/docs/zh-cn/ecosystem.mdx +++ b/packages/web/src/content/docs/zh-cn/ecosystem.mdx @@ -1,5 +1,5 @@ --- -title: 生態系統 +title: Ecosystem description: 使用 opencode 构建的项目和集成。 --- @@ -9,68 +9,68 @@ description: 使用 opencode 构建的项目和集成。 想要将您的 opencode 相关项目添加到此列表中吗?提交 PR。 ::: -您还可以查看[awesome-opencode](https://github.com/awesome-opencode/awesome-opencode)和[opencode.cafe](https://opencode.cafe),这是一个聚合生态系统和社区的社区。 +您还可以查看 [awesome-opencode](https://github.com/awesome-opencode/awesome-opencode) 和 [opencode.cafe](https://opencode.cafe),这是一个聚合生态系统和社区的社区。 --- -## 插件 +## Plugins -| 名称 | 描述 | -| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | -| [opencode-daytona](https://github.com/jamesmurdza/daytona/blob/main/guides/typescript/opencode/README.md) | 在隔离的 Daytona 沙箱中自动运行 opencode 会话,并使用 git 同步和实时预览 | -| [opencode-helicone-session](https://github.com/H2Shami/opencode-helicone-session) | 自动注入 Helicone 会话标头以进行请求包 | -| [opencode-type-inject](https://github.com/nick-vi/opencode-type-inject) | 使用查找工具将 TypeScript/Svelte 类型自动注入到文件读取中 | -| [opencode-openai-codex-auth](https://github.com/numman-ali/opencode-openai-codex-auth) | 使用您的 ChatGPT Plus 或 Pro 订阅而不是 API 积分 | -| [opencode-gemini-auth](https://github.com/jenslys/opencode-gemini-auth) | 使用您现有的 Gemini 计划而不是 API 设备 | -| [opencode-antigravity-auth](https://github.com/NoeFabris/opencode-antigravity-auth) | 使用反重力的免费模型代替API | -| [opencode-devcontainers](https://github.com/athal7/opencode-devcontainers) | 具有浅克隆和自动分配端口的多分支开发容器隔离 | -| [opencode-google-antigravity-auth](https://github.com/shekohex/opencode-google-antigravity-auth) | Google Antigravity OAuth 插件,支持 Google 搜索和更强大的 API 处理 | -| [opencode-dynamic-context-pruning](https://github.com/Tarquinen/opencode-dynamic-context-pruning) | 通过修剪过时的工具输出来优化代币使用 | -| [opencode-websearch-cited](https://github.com/ghoulr/opencode-websearch-cited.git) | 为具有Google接地风格的受支持增加本机网络搜索支持 | -| [opencode-pty](https://github.com/shekohex/opencode-pty.git) | 使AI代理能够在PTY中运行后台进程,末端发送其交互输入。 | -| [opencode-shell-strategy](https://github.com/JRedeker/opencode-shell-strategy) | 非吸引力 shell 命令说明 - 阻止依赖 TTY 的操作挂起 | -| [opencode-wakatime](https://github.com/angristan/opencode-wakatime) | 使用 Wakatime 跟踪 opencode 使用情况 | -| [opencode-md-table-formatter](https://github.com/franlol/opencode-md-table-formatter/tree/main) | 清理LLM生成的降价表 | -| [opencode-morph-fast-apply](https://github.com/JRedeker/opencode-morph-fast-apply) | 使用Morph Fast Apply API和取消编辑标记将代码编辑速度提高10倍 | -| [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) | 后台代理、预构建的LSP/AST/MCP工具、精选代理、兼容Claude代码 | -| [opencode-notificator](https://github.com/panta82/opencode-notificator) | opencode 会话的桌面通知和声音警报 | -| [opencode-notifier](https://github.com/mohak34/opencode-notifier) | 针对权限、完成和错误事件的桌面通知和声音警报 | -| [opencode-zellij-namer](https://github.com/24601/opencode-zellij-namer) | 基于 opencode 上下文的 AI 支持的自动 Zellij 会话命名 | -| [opencode-skillful](https://github.com/zenobi-us/opencode-skillful) | 允许opencode代理通过技能发现和注入失败延迟加载提示 | -| [opencode-supermemory](https://github.com/supermemoryai/opencode-supermemory) | 使用超级内存跨会话持久内存 | -| [@plannotator/opencode](https://github.com/backnotprop/plannotator/tree/main/apps/opencode-plugin) | 具有視覺註釋和私人/離線共享的交互式計劃审查 | -| [@openspoon/subtask2](https://github.com/spoons-and-mirrors/subtask2) | 将opencode/命令扩展为具有精細流程控制的強大編排系統 | -| [opencode-scheduler](https://github.com/different-ai/opencode-scheduler) | 使用带 cron 语法的 launchd (Mac) 或 systemd (Linux) 安排重复作业 | -| [micode](https://github.com/vtemian/micode) | 塑造头脑风暴 → 计划 → 实施具有会议连续性的工作流程 | -| [octto](https://github.com/vtemian/octto) | 用于通过多问题形式进行AI头痛风暴的交互式浏览器UI | -| [opencode-background-agents](https://github.com/kdcokenny/opencode-background-agents) | 具有异步委托和上下文持久性的Claude Code风格后台代理 | -| [opencode-notify](https://github.com/kdcokenny/opencode-notify) | opencode 的本机操作系统通知 – 了解任务何时完成 | -| [opencode-workspace](https://github.com/kdcokenny/opencode-workspace) | 一堆多代理编排工具 – 16个,组件一次安装 | -| [opencode-worktree](https://github.com/kdcokenny/opencode-worktree) | opencode 的零难度 git 工作树 | +| 名称 | 描述 | +| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | +| [opencode-daytona](https://github.com/jamesmurdza/daytona/blob/main/guides/typescript/opencode/README.md) | 在隔离的 Daytona 沙箱中自动运行 opencode 会话,并使用 git 同步和实时预览 | +| [opencode-helicone-session](https://github.com/H2Shami/opencode-helicone-session) | 自动注入 Helicone 会话标头以进行请求包 | +| [opencode-type-inject](https://github.com/nick-vi/opencode-type-inject) | 使用查找工具将 TypeScript/Svelte 类型自动注入到文件读取中 | +| [opencode-openai-codex-auth](https://github.com/numman-ali/opencode-openai-codex-auth) | 使用您的 ChatGPT Plus 或 Pro 订阅而不是 API 积分 | +| [opencode-gemini-auth](https://github.com/jenslys/opencode-gemini-auth) | 使用您现有的 Gemini 计划而不是 API 密钥 | +| [opencode-antigravity-auth](https://github.com/NoeFabris/opencode-antigravity-auth) | 使用 Antigravity 的免费模型代替 API | +| [opencode-devcontainers](https://github.com/athal7/opencode-devcontainers) | 具有浅克隆和自动分配端口的多分支开发容器隔离 | +| [opencode-google-antigravity-auth](https://github.com/shekohex/opencode-google-antigravity-auth) | Google Antigravity OAuth 插件,支持 Google 搜索和更强大的 API 处理 | +| [opencode-dynamic-context-pruning](https://github.com/Tarquinen/opencode-dynamic-context-pruning) | 通过修剪过时的工具输出来优化 token 使用 | +| [opencode-websearch-cited](https://github.com/ghoulr/opencode-websearch-cited.git) | 为具有 Google 接地风格的受支持增加本机网络搜索支持 | +| [opencode-pty](https://github.com/shekohex/opencode-pty.git) | 使 AI 代理能够在 PTY 中运行后台进程,末端发送其交互输入。 | +| [opencode-shell-strategy](https://github.com/JRedeker/opencode-shell-strategy) | Non-interactive shell command instructions - prevent TTY-dependent operations from hanging | +| [opencode-wakatime](https://github.com/angristan/opencode-wakatime) | 使用 Wakatime 跟踪 opencode 使用情况 | +| [opencode-md-table-formatter](https://github.com/franlol/opencode-md-table-formatter/tree/main) | 清理 LLM 生成的 markdown 表 | +| [opencode-morph-fast-apply](https://github.com/JRedeker/opencode-morph-fast-apply) | 使用 Morph Fast Apply API 和取消编辑标记将代码编辑速度提高 10 倍 | +| [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) | 后台代理、预构建的 LSP/AST/MCP 工具、精选代理、兼容 Claude Code | +| [opencode-notificator](https://github.com/panta82/opencode-notificator) | opencode 会话的桌面通知和声音警报 | +| [opencode-notifier](https://github.com/mohak34/opencode-notifier) | 针对权限、完成和错误事件的桌面通知和声音警报 | +| [opencode-zellij-namer](https://github.com/24601/opencode-zellij-namer) | 基于 opencode 上下文的 AI 支持的自动 Zellij 会话命名 | +| [opencode-skillful](https://github.com/zenobi-us/opencode-skillful) | 允许 opencode 代理通过技能发现和注入失败延迟加载提示 | +| [opencode-supermemory](https://github.com/supermemoryai/opencode-supermemory) | 使用 Supermemory 跨会话持久内存 | +| [@plannotator/opencode](https://github.com/backnotprop/plannotator/tree/main/apps/opencode-plugin) | 具有视觉注释和私人/离线共享的交互式计划审查 | +| [@openspoon/subtask2](https://github.com/spoons-and-mirrors/subtask2) | 将 opencode/命令扩展为具有精细流程控制的强大编排系统 | +| [opencode-scheduler](https://github.com/different-ai/opencode-scheduler) | 使用带 cron 语法的 launchd (Mac) 或 systemd (Linux) 安排重复作业 | +| [micode](https://github.com/vtemian/micode) | 塑造头脑风暴 → 计划 → 实施具有会议连续性的工作流程 | +| [octto](https://github.com/vtemian/octto) | 用于通过多问题形式进行 AI 头脑风暴的交互式浏览器 UI | +| [opencode-background-agents](https://github.com/kdcokenny/opencode-background-agents) | 具有异步委托和上下文持久性的 Claude Code 风格后台代理 | +| [opencode-notify](https://github.com/kdcokenny/opencode-notify) | opencode 的本机操作系统通知 – 了解任务何时完成 | +| [opencode-workspace](https://github.com/kdcokenny/opencode-workspace) | 一堆多代理编排工具 – 16个,组件一次安装 | +| [opencode-worktree](https://github.com/kdcokenny/opencode-worktree) | opencode 的零难度 git 工作树 | --- -## 专案 +## Projects | 名称 | 描述 | | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------- | | [kimaki](https://github.com/remorses/kimaki) | 用于控制 opencode 会话的 Discord 机器人,基于 SDK 构建 | | [opencode.nvim](https://github.com/NickvanDyke/opencode.nvim) | Neovim 插件,用于编辑器采集提示,基于 API 构建 | -| [portal](https://github.com/hosenur/portal) | 通过Tailscale/VPN实现opencode的移动优先Web UI | +| [portal](https://github.com/hosenur/portal) | 通过 Tailscale/VPN 实现 opencode 的移动优先 Web UI | | [opencode plugin template](https://github.com/zenobi-us/opencode-plugin-template/) | 用于构建 opencode 插件的模板 | | [opencode.nvim](https://github.com/sudo-tee/opencode.nvim) | Neovim opencode 前端 - 基于终端的 AI 编码代理 | | [ai-sdk-provider-opencode-sdk](https://github.com/ben-vargas/ai-sdk-provider-opencode-sdk) | Vercel AI SDK 提供商,用于通过 @opencode-ai/sdk 使用 opencode | | [OpenChamber](https://github.com/btriapitsyn/openchamber) | opencode 的 Web/桌面应用程序和 VS Code 扩展 | | [Kilo-Obsidian](https://github.com/mtymek/opencode-obsidian) | 在 Obsidian 的 UI 中嵌入 opencode 的 Obsidian 插件 | | [OpenWork](https://github.com/different-ai/openwork) | Claude Cowork 的替代开源方案,由 opencode 提供支持 | -| [ocx](https://github.com/kdcokenny/ocx) | opencode扩展管理器具有可移植、隔离的配置文件。 | +| [ocx](https://github.com/kdcokenny/ocx) | opencode 扩展管理器具有可移植、隔离的配置文件。 | | [CodeNomad](https://github.com/NeuralNomadsAI/CodeNomad) | opencode 的桌面、Web、移动和远程客户端应用程序 | --- -## 代理商 +## Agents | 名称 | 描述 | | ----------------------------------------------------------------- | ---------------------------------------- | -| [Agentic](https://github.com/Cluster444/agentic) | 用于格式化开发的定价人工智能代理和命令] | +| [Agentic](https://github.com/Cluster444/agentic) | 用于格式化开发的 Agentic AI 代理和命令 | | [opencode-agents](https://github.com/darrenhinde/opencode-agents) | 用于增强工作流程的配置、提示、代理和插件 | diff --git a/packages/web/src/content/docs/zh-cn/enterprise.mdx b/packages/web/src/content/docs/zh-cn/enterprise.mdx index 067d5aa0d..73be4e7f0 100644 --- a/packages/web/src/content/docs/zh-cn/enterprise.mdx +++ b/packages/web/src/content/docs/zh-cn/enterprise.mdx @@ -1,5 +1,5 @@ --- -title: 企業 +title: Enterprise description: 在您的组织中安全地使用 opencode。 --- @@ -12,25 +12,24 @@ opencode Enterprise 适用于希望确保其代码和数据永远不会离开其 opencode 不存储您的任何代码或上下文数据。 ::: -要开始使用opencode Enterprise: +要开始使用 opencode Enterprise: -1. 与您的團隊進行内部試驗。 -2. **聯繫我们**討論定價和實施選項。 +1. 与您的团队进行内部试用。 +2. **联系我们** 讨论定价和实施选项。 --- -## 審判 +## 试用 opencode 是开源的,不存储您的任何代码或上下文数据,因此您的开发人员只需 [开始吧](/docs/) 并进行试用。 --- -### 數據處理 +### 数据处理 -**opencode 不会存储您的代码或上下文数据。 **所有处理都在本地进行或通过直接 API 调用您的 AI 提供商。 +**opencode 不会存储您的代码或上下文数据。** 所有处理都在本地进行或通过直接 API 调用您的 AI 提供商。 -这意味著只要您使用您信任的提供商或内部提供商 -AI网关,您可以安全使用opencode。 +这意味着只要您使用您信任的提供商或内部 AI 网关,您就可以安全使用 opencode。 这里唯一需要注意的是可选的 `/share` 功能。 @@ -38,11 +37,11 @@ AI网关,您可以安全使用opencode。 #### 分享对话 -如果启用用户 `/share` 功能,对话和关联的数据将被发送到我们用于在 kilo.ai 上托管这些共享页面的服务。 +如果用户启用 `/share` 功能,对话和关联的数据将被发送到我们用于在 kilo.ai 上托管这些共享页面的服务。 -数据当前通过我们的CDN边缘网络提供服务,并缓存在用户附近的边缘。 +数据当前通过我们的 CDN 边缘网络提供服务,并缓存在用户附近的边缘。 -我们建議您在試用時禁用此功能。 +我们建议您在试用时禁用此功能。 ```json title="opencode.json" { @@ -55,27 +54,25 @@ AI网关,您可以安全使用opencode。 --- -### 代碼所有權 +### 代码所有权 -**您拥有 opencode 生成的所有代码。 ** 没有许可限制或语音报表。 +**您拥有 opencode 生成的所有代码。** 没有许可限制或所有权主张。 --- -## 定價 +## 定价 -我们对 opencode Enterprise 使用單機模型。如果您有自己的 LLM 網關,我们不会对使用的Tokens收取费用。有關定價和實施選項的更多詳細信息,请**聯繫我们**。 +我们对 opencode Enterprise 使用按席位模型。如果您有自己的 LLM 网关,我们不会对使用的 Token 收取费用。有关定价和实施选项的更多详细信息,请 **联系我们**。 --- ## 部署 -完成试验并准备好使用 opencode 后,请访问: -您的組織,您可以**聯繫我们**進行討論 -定價和實施選項。 +完成试用并准备好在您的组织中使用 opencode 后,您可以 **联系我们** 进行讨论定价和实施选项。 --- -### 中央配置 +### Central Config 我们可以将 opencode 设置为您的整个组织使用单一的中央配置。 @@ -83,88 +80,86 @@ AI网关,您可以安全使用opencode。 --- -### 單點登錄集成 +### SSO Integration -通过中央配置,opencode 可以与您组织的 SSO 提供商集成以进行身份验证。 +通过中央配置,opencode 可以与您组织的 SSO 提供商集成以进行身份验证。 这使得 opencode 能够通过现有的身份管理系统获取内部 AI 网关的凭据。 --- -### 内部AI网关 +### Internal AI Gateway 通过中央配置,opencode 还可以配置为仅使用您的内部 AI 网关。 -您还可以取消所有其他人工智能启动,确保所有请求都通过组织批准的基础设施。 +您还可以禁用所有其他 AI 提供商,确保所有请求都通过组织批准的基础设施。 --- -### 自託管 +### Self-hosting -雖然我们建議禁用共享頁面以確保您的數據永遠不会離開 -您的組織,我们还可以幫助您在您的基礎設施上自行託管它們。 +虽然我们建议禁用共享页面以确保您的数据永远不会离开您的组织,我们还可以帮助您在您的基础设施上自行托管它们。 -目前这已在我们的路線圖上。如果您有興趣,**讓我们知道**。 +目前这已在我们的路线图上。如果您有兴趣,**让我们知道**。 --- -## 常問問題 +## FAQ -什麼是 opencode Enterprise?
+什么是 opencode Enterprise?
opencode Enterprise 适用于希望确保其代码和数据永远不会离开其基础设施的组织。它可以通过使用与 SSO 和内部 AI 网关集成的集中方式配置来实现此目的。-如何開始使用 opencode Enterprise?
+如何开始使用 opencode Enterprise?
与您的团队进行内部实验即可。opencode 默认情况下不存储您的代码或上下文数据,可以轻松上手。 -然後**聯繫我们**討論定價和實施選項。 +然后 **联系我们** 讨论定价和实施选项。-企業定價如何運作?
+企业定价如何运作?
-我们提供按席位企業定價。如果您有自己的 LLM 網關,我们不会对使用的Tokens收取费用。如需了解更多详情,请**聯繫我们**,获取根據您組織的需求定制的報價。 +我们提供按席位企业定价。如果您有自己的 LLM 网关,我们不会对使用的 Token 收取费用。如需了解更多详情,请 **联系我们**,获取根据您组织的需求定制的报价。-opencode Enterprise 保證我的數據安全嗎?
+opencode Enterprise 保证我的数据安全吗?
-opencode 不存储您的代码或上下文数据。所有处理都在本地进行或通过直接 API 调用您的 AI 工作。通过中央配置和 SSO 集成,您的数据在组织的基础架构中保持安全。 +是的。opencode 不存储您的代码或上下文数据。所有处理都在本地进行或通过直接 API 调用您的 AI 提供商。通过中央配置和 SSO 集成,您的数据在组织的基础架构中保持安全。-diff --git a/packages/web/src/content/docs/zh-cn/formatters.mdx b/packages/web/src/content/docs/zh-cn/formatters.mdx index c4552ca96..715789fda 100644 --- a/packages/web/src/content/docs/zh-cn/formatters.mdx +++ b/packages/web/src/content/docs/zh-cn/formatters.mdx @@ -1,62 +1,62 @@ --- title: 格式化程序 -description: opencode 使用特定于语言的清理程序。 +description: opencode 使用特定于语言的格式化程序。 --- -使用在语言的格式化程序编写或编辑文件后,opencode会自动格式化文件。这可以确保生成的代码遵循项目的代码风格。 +使用特定于语言的格式化程序编写或编辑文件后,opencode 会自动格式化文件。这可以确保生成的代码遵循项目的代码风格。 --- -## 內建 +## Built-in -opencode附带了多个适用于流行语言和框架的内置初始化程序。下面是格式化程序、支持的文件扩展名以及所需的命令或配置选项的列表。 +opencode 附带了多个适用于流行语言和框架的内置格式化程序。下面是格式化程序、支持的文件扩展名以及所需的命令或配置选项的列表。 -| 格式化程序 | 扩展 | 要求 | -| ------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | -| 政府 | .go | `gofmt` 命令可用 | -| 混合 | .ex、.exs、.eex、.heex、.leex、.neex、.sface | `mix` 命令可用 | -| 更漂亮 | .js、.jsx、.ts、.tsx、.html、.css、.md、.json、.yaml 和 [更多的](https://prettier.io/docs/en/index.html) | 在 `package.json` 中有 `prettier` 依赖 | -| 生物群系 | .js、.jsx、.ts、.tsx、.html、.css、.md、.json、.yaml 和 [更多的](https://biomejs.dev/) | `biome.json(c)` 配置文件 | -| 之字形 | .zig、.zon | `zig` 命令可用 | -| clang 格式 | .c、.cpp、.h、.hpp、.ino 和 [更多的](https://clang.llvm.org/docs/ClangFormat.html) | `.clang-format` 配置文件 | -| 克特林特 | .kt、.kts | `ktlint` 命令可用 | -| 领子 | .py, .pyi | `ruff` 命令可通过配置 | -| 生锈 | .rs | `rustfmt` 命令可用 | -| 货物运输 | .rs | `cargo fmt` 命令可用 | -| 美丽 | .py, .pyi | `uv` 命令可用 | -| 鲁博科普 | .rb、.rake、.gemspec、.ru | `rubocop` 命令可用 | -| 标准rb | .rb、.rake、.gemspec、.ru | `standardrb` 命令可用 | -| html美化器 | .erb、.html.erb | `htmlbeautifier` 命令可用 | -| 空气 | .R | `air` 命令可用 | -| 飞镖 | .dart | `dart` 命令可用 | -| ocaml 格式 | .ml、.mli | `ocamlformat` 可用命令和 `.ocamlformat` 配置文件 | -| 地形 | .tf、.tfvars | `terraform` 命令可用 | -| 微光 | .gleam | `gleam` 命令可用 | -| 尼克斯夫MTT | .nix | `nixfmt` 命令可用 | -| sfmt | .sh、.bash | `shfmt` 命令可用 | -| 品脱 | .php | 在 `composer.json` 中有 `laravel/pint` 依赖 | -| oxfmt(实验) | .js、.jsx、.ts、.tsx | 在 `package.json` 中有 `oxfmt` 依赖并启用[实验环境变量标记](/docs/cli/#experimental) | -| 奥尔莫鲁 | .hs | `ormolu` 命令可用 | +| Formatter | Extensions | Requirements | +| -------------------- | -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | +| gofmt | .go | `gofmt` command available | +| mix | .ex, .exs, .eex, .heex, .leex, .neex, .sface | `mix` command available | +| prettier | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml, and [more](https://prettier.io/docs/en/index.html) | `prettier` dependency in `package.json` | +| biome | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml, and [more](https://biomejs.dev/) | `biome.json(c)` config file | +| zig | .zig, .zon | `zig` command available | +| clang-format | .c, .cpp, .h, .hpp, .ino, and [more](https://clang.llvm.org/docs/ClangFormat.html) | `.clang-format` config file | +| ktlint | .kt, .kts | `ktlint` command available | +| ruff | .py, .pyi | `ruff` command available with config | +| rustfmt | .rs | `rustfmt` command available | +| cargofmt | .rs | `cargo fmt` command available | +| uv | .py, .pyi | `uv` command available | +| rubocop | .rb, .rake, .gemspec, .ru | `rubocop` command available | +| standardrb | .rb, .rake, .gemspec, .ru | `standardrb` command available | +| htmlbeautifier | .erb, .html.erb | `htmlbeautifier` command available | +| air | .R | `air` command available | +| dart | .dart | `dart` command available | +| ocamlformat | .ml, .mli | `ocamlformat` command available and `.ocamlformat` config file | +| terraform | .tf, .tfvars | `terraform` command available | +| gleam | .gleam | `gleam` command available | +| nixfmt | .nix | `nixfmt` command available | +| shfmt | .sh, .bash | `shfmt` command available | +| pint | .php | `laravel/pint` dependency in `composer.json` | +| oxfmt (Experimental) | .js, .jsx, .ts, .tsx | `oxfmt` dependency in `package.json` and an [experimental env variable flag](/docs/cli/#experimental) | +| ormolu | .hs | `ormolu` command available | -因此,如果您的项目的`package.json`或`prettier`,opencode将自动使用它。 +因此,如果您的项目的 `prettier` 中有 `package.json`,opencode 将自动使用它。 --- -## 它是如何運作的 +## 它是如何工作的 -当opencode写入或编辑文件时,它: +当 opencode 写入或编辑文件时,它: -1. 根據所有启用的格式化程序检查文件扩展名。 -2. 对文件運行適当的格式化程序命令。 +1. 根据所有启用的格式化程序检查文件扩展名。 +2. 对文件运行适当的格式化程序命令。 3. 自动应用格式更改。 -此过程在後台進行,確保無需任何手动步驟即可維護您的代碼樣式。 +此过程在后台进行,确保无需任何手动步骤即可维护您的代码样式。 --- ## 配置 -您可以通过 opencode 配置中的 `formatter` 部分自定义程序。 +您可以通过 opencode 配置中的 `formatter` 部分自定义格式化程序。 ```json title="opencode.json" { @@ -65,22 +65,22 @@ opencode附带了多个适用于流行语言和框架的内置初始化程序。 } ``` -每个格式化程序配置支持以下內容: +每个格式化程序配置支持以下内容: -| 物業 | 類型 | 描述 | -| ------------- | -------- | -------------------------------- | -| `disabled` | 布尔 | 将其设置为 `true` 以取消删除程序 | -| `command` | 字符串[] | 格式化运行的命令 | -| `environment` | 对象 | 运行格式化程序时要设置的环境变量 | -| `extensions` | 字符串[] | 此整理程序应处理的文件扩展名 | +| Property | Type | Description | +| ------------- | -------- | ---------------------------------- | +| `disabled` | boolean | 将其设置为 `true` 以禁用格式化程序 | +| `command` | string[] | 格式化运行的命令 | +| `environment` | object | 运行格式化程序时要设置的环境变量 | +| `extensions` | string[] | 此格式化程序应处理的文件扩展名 | -讓我们看一些例子。 +让我们看一些例子。 --- ### 禁用格式化程序 -要全局取消**所有**清理程序,然后`formatter`设置为`false`: +要全局禁用 **所有** 格式化程序,将 `formatter` 设置为 `false`: ```json title="opencode.json" {3} { @@ -89,7 +89,7 @@ opencode附带了多个适用于流行语言和框架的内置初始化程序。 } ``` -要取消**特定**删除程序,则`disabled`设置为`true`: +要禁用 **特定** 格式化程序,将 `disabled` 设置为 `true`: ```json title="opencode.json" {5} { @@ -104,9 +104,9 @@ opencode附带了多个适用于流行语言和框架的内置初始化程序。 --- -### 自定義格式化程序 +### 自定义格式化程序 -您可以覆盖内置格式化程序或通过指定命令、環境變量和文件扩展名添加新格式化程序: +您可以覆盖内置格式化程序或通过指定命令、环境变量和文件扩展名添加新格式化程序: ```json title="opencode.json" {4-14} { diff --git a/packages/web/src/content/docs/zh-cn/github.mdx b/packages/web/src/content/docs/zh-cn/github.mdx index 6ea82fafc..30371ec5e 100644 --- a/packages/web/src/content/docs/zh-cn/github.mdx +++ b/packages/web/src/content/docs/zh-cn/github.mdx @@ -7,11 +7,11 @@ opencode 与您的 GitHub 工作流程集成。在评论中提及 `/opencode` --- -## 特徵 +## Features -- **分类问题**:要求 opencode 调查问题并向您解释。 -- **修复和实施**:要求 opencode 修复问题或实施功能。将在一个新的分支中工作并提交包含所有更改的 PR。 -- **安全**:opencode 在 GitHub 的运行器中运行。 +- **Triage issues**: 要求 opencode 调查问题并向您解释。 +- **Fix and implement**: 要求 opencode 修复问题或实施功能。将在一个新的分支中工作并提交包含所有更改的 PR。 +- **Secure**: opencode 在 GitHub 的运行器中运行。 --- @@ -27,17 +27,17 @@ opencode github install --- -### 手动设置 +### Manual Setup 或者您可以手动设置。 -1. 错误 500(服务器错误)!!1500。这是一个错误。出现错误。请稍后重试。我们只知道这些。 +1. **Install the GitHub app** - 前往[**github.com/apps/opencode-agent**](https://github.com/apps/opencode-agent)。确保它已安装在目标存储库上。 + 前往 [**github.com/apps/opencode-agent**](https://github.com/apps/opencode-agent)。确保它已安装在目标存储库上。 -2. **添加工作流程** +2. **Add the workflow** - 将以下工作流程文件添加到存储库中的`.github/workflows/opencode.yml`中。确保在`env`中设置适当的`model`和所需的API按键。 + 将以下工作流程文件添加到存储库中的 `.github/workflows/opencode.yml` 中。确保在 `model` 中设置适当的 `env` 和所需的 API 密钥。 ```yml title=".github/workflows/opencode.yml" {24,26} name: opencode @@ -73,21 +73,21 @@ opencode github install # github_token: xxxx ``` -3. 错误 500(服务器错误)!!1500。这是一个错误。出现错误。请稍后重试。我们只知道这些。 +3. **Store the API keys in secrets** - 在您的组织或项目的**设置**中,展开左侧的**秘密和变量**,然后选择**操作**。并添加所需的API钥匙。 + 在您的组织或项目的 **Settings** 中,展开左侧的 **Secrets and variables**,然后选择 **Actions**。并添加所需的 API 密钥。 --- -## 配置 +## Configuration -- `model`:与 opencode 一起使用的模型。采用 `provider/model` 格式。这是**必需的**。 +- `model`:与 opencode 一起使用的模型。采用 `provider/model` 格式。这是 **必需的**。 - `agent`:要使用的代理。必须是一级代理。如果未找到,则从配置回退到 `default_agent` 或 `"build"`。 -- `share`:是否共享opencode会话。对于公共存储库,默认为**true**。 +- `share`:是否共享 opencode 会话。对于公共存储库,默认为 **true**。 - `prompt`:可选的自定义提示以覆盖默认行为。使用它来自定义 opencode 处理请求的方式。 -- `token`:可选的 GitHub 访问Tokens,用于执行创建评论、提交更改和打开拉取请求等操作。默认情况下,opencode 使用来自 opencode GitHub 应用程序的安装访问Tokens,因此提交、评论和拉取请求显示为来自应用。 +- `token`:可选的 GitHub 访问 Token,用于执行创建评论、提交更改和打开拉取请求等操作。默认情况下,opencode 使用来自 opencode GitHub 应用程序的安装访问 Token,因此提交、评论和拉取请求显示为来自应用。 - 或者,您可以使用 GitHub Action 运行程序的[内置`GITHUB_TOKEN`](https://docs.github.com/en/actions/tutorials/authenticate-with-github_token),而无需安装 opencode GitHub 应用程序。只需确保在您的工作流程中所需的权限: + 或者,您可以使用 GitHub Action 运行程序的 [内置 `GITHUB_TOKEN`](https://docs.github.com/en/actions/tutorials/authenticate-with-github_token),而无需安装 opencode GitHub 应用程序。只需确保在您的工作流程中所需的权限: ```yaml permissions: @@ -97,26 +97,26 @@ opencode github install issues: write ``` - 错误 500(服务器错误)!!1500。这是一个错误。出现错误。请稍后重试。我们只知道这些。 + 您可以在 GitHub Actions 文档中了解有关配置工作流程的更多信息。 --- -## 支持的活动 +## Supported Events opencode 可以由以下 GitHub 事件触发: -| 事件類型 | 觸發者 | 详情 | +| Event Type | Triggered By | Details | | ----------------------------- | ---------------------------- | --------------------------------------------------------------------------------------- | | `issue_comment` | 对问题或 PR 发表评论 | 在评论中提及 `/opencode` 或 `/oc`。 opencode 读取上下文并可以创建分支、打开 PR 或回复。 | -| `pull_request_review_comment` | 对 PR 中的特定代码行进行评论 | 在检查代码时提及`/opencode` 或`/oc`。 opencode 接收文件路径、行号和 diff 上下文。 | -| `issues` | 问题已打开或已编辑 | 创建或修改问题时自动触发opencode。需要`prompt` 输入。 | +| `pull_request_review_comment` | 对 PR 中的特定代码行进行评论 | 在检查代码时提及 `/opencode` 或 `/oc`。 opencode 接收文件路径、行号和 diff 上下文。 | +| `issues` | 问题已打开或已编辑 | 创建或修改问题时自动触发 opencode。需要 `prompt` 输入。 | | `pull_request` | PR 已开启或已更新 | 当 PR 打开、同步或重新打开时自动触发 opencode。对于自动评论很有帮助。 | | `schedule` | 基于 Cron 的计划 | 按计划运行 opencode。需要 `prompt` 输入。输出进入日志和 PR(没有可评论的问题)。 | | `workflow_dispatch` | 从 GitHub UI 手动触发 | 通过“操作”选项卡触发 opencode。需要 `prompt` 输入。输出进入日志和 PR。 | -### 時間表示例 +### Schedule Example -按计划运行opencode以执行自动化任务: +按计划运行 opencode 以执行自动化任务: ```yaml title=".github/workflows/opencode-scheduled.yml" name: Scheduled Kilo Task @@ -150,13 +150,13 @@ jobs: If you find issues worth addressing, open an issue to track them. ``` -对于计划事件,`prompt` 输入是**必需的**,因为没有注释可以从中提取指令。希望计划工作流在没有用户上下文的情况下运行并进行权限检查,因此如果您 opencode 创建分支或 PR,工作流必须支持 `contents: write` 和 `pull-requests: write`。 +对于计划事件,`prompt` 输入是 **必需的**,因为没有注释可以从中提取指令。希望计划工作流在没有用户上下文的情况下运行并进行权限检查,因此如果您 opencode 创建分支或 PR,工作流必须支持 `contents: write` 和 `pull-requests: write`。 --- -### 拉取请求示例 +### Pull Request Example -或更新公关时间自动审核: +或更新 PR 时自动审核: ```yaml title=".github/workflows/opencode-review.yml" name: opencode-review @@ -191,13 +191,13 @@ jobs: - Suggest improvements ``` -对于`pull_request`事件,如果未提供`prompt`,opencode将默认审核拉取请求。 +对于 `pull_request` 事件,如果未提供 `prompt`,opencode 将默认审核拉取请求。 --- -### 問題分類示例 +### Issue Triage Example -自动分類新問題。此示例过濾超过 30 天的账户以減少垃圾郵件: +自动分类新问题。此示例过滤超过 30 天的账户以减少垃圾邮件: ```yaml title=".github/workflows/opencode-triage.yml" name: Issue Triage @@ -246,11 +246,11 @@ jobs: Otherwise, do not comment. ``` -对于 `issues` 事件,`prompt` 输入是**必需的**,因为没有注释可足以提取指令。 +对于 `issues` 事件,`prompt` 输入是 **必需的**,因为没有注释可以从中提取指令。 --- -## 自定義提示 +## Custom Prompt 覆盖默认提示,为您的工作流程自定义 opencode 的行为。 @@ -265,7 +265,7 @@ jobs: - Suggest improvements ``` -这对于执行与您的項目相关的特定审查標準、編碼標准或重點領域非常有用。 +这对于执行与您的项目相关的特定审查标准、编码标准或重点领域非常有用。 --- @@ -273,7 +273,7 @@ jobs: 以下是如何在 GitHub 中使用 opencode 的一些示例。 -- **解釋一个問題** +- **Explain an issue** 在 GitHub 问题中添加此评论。 @@ -281,9 +281,9 @@ jobs: /opencode explain this issue ``` - opencode 将阅读整个线程,包括所有评论,并回复并提供语音解释。 + opencode 将阅读整个线程,包括所有评论,并回复并提供清晰的解释。 -- **解決問題** +- **Fix an issue** 在 GitHub 问题中,说: @@ -293,7 +293,7 @@ jobs: opencode 将创建一个新分支,实施更改,并使用更改打开 PR。 -- **审查 PR 并进行更改** +- **Review PRs and make changes** 在 GitHub PR 上留下以下评论。 @@ -301,21 +301,21 @@ jobs: Delete the attachment from S3 when the note is removed /oc ``` - 错误 500(服务器错误)!!1500。这是一个错误。出现错误。请稍后重试。我们只知道这些。 + opencode 将实施请求的更改并提交到同一个 PR。 -- **查看特定代碼行** +- **Review specific code lines** - 直接在PR的“文件”选项卡中的代码行上留下评论。opencode自动检测文件、行号和差异上下文以提供准确的响应。 + 直接在 PR 的“文件”选项卡中的代码行上留下评论。opencode 自动检测文件、行号和差异上下文以提供准确的响应。 ``` [Comment on specific lines in Files tab] /oc add error handling here ``` - 错误 500(服务器错误)!!1500。这是一个错误。出现错误。请稍后重试。我们只知道这些。 - - 正在审查的確切文件 - - 具體代碼行 + 当评论特定行时,opencode 接收: + - 正在审查的确切文件 + - 具体代码行 - 周围的差异上下文 - - 行號信息 + - 行号信息 - 这允许更有針对性的请求,而無需手动指定文件路徑或行號。 + 这允许更有针对性的请求,而无需手动指定文件路径或行号。 diff --git a/packages/web/src/content/docs/zh-cn/gitlab.mdx b/packages/web/src/content/docs/zh-cn/gitlab.mdx index 71702a7cb..8e79c1f3c 100644 --- a/packages/web/src/content/docs/zh-cn/gitlab.mdx +++ b/packages/web/src/content/docs/zh-cn/gitlab.mdx @@ -9,25 +9,25 @@ opencode 通过 GitLab CI/CD 管道或与 GitLab Duo 与您的 GitLab 工作流 --- -## GitLab。 +## GitLab CI -opencode 在常规 GitLab 管道中工作。您可以将其构建为管道 [CI](https://docs.gitlab.com/ee/ci/components/) +opencode 在常规 GitLab 管道中工作。您可以将其构建为管道 [CI 组件](https://docs.gitlab.com/ee/ci/components/) 在这里,我们使用社区创建的 opencode CI/CD 组件 — [nagyv/gitlab-opencode](https://gitlab.com/nagyv/gitlab-opencode)。 --- -### 特徵 +### Features -- **每个作业使用每个自定义配置**:使用自定义配置目录配置opencode,例如`./config/#custom-directory`以启用或禁用opencode调用的功能。 -- 错误 500(服务器错误)!!1500。这是一个错误。出现错误。请稍后重试。我们只知道这些。 -- **灵活**:CI 组件支持多种输入来自定义其行为 +- **Use custom configuration per job**: 使用自定义配置目录配置 opencode,例如 `./config/#custom-directory` 以启用或禁用 opencode 调用的功能。 +- **Authentication**: Uses OIDC for secure authentication +- **Flexible**: CI 组件支持多种输入来自定义其行为 --- -### 设置 +### Setup -1. 将 opencode 身份验证 JSON 作为文件类型 CI 环境变量存储在 **设置** > **CI/CD** > **变量** 下。确保将它们标记为“隐藏和隐藏”。 +1. 将 opencode 身份验证 JSON 作为文件类型 CI 环境变量存储在 **Settings** > **CI/CD** > **Variables** 下。确保将它们标记为“隐藏和隐藏”。 2. 将以下内容添加到您的 `.gitlab-ci.yml` 文件中。 ```yaml title=".gitlab-ci.yml" @@ -44,34 +44,34 @@ opencode 在常规 GitLab 管道中工作。您可以将其构建为管道 [CI]( --- -## 亚搏体育app二人组 +## GitLab Duo opencode 与您的 GitLab 工作流程集成。 -在评论中提及`@opencode`,opencode 将在您的 GitLab CI 管道中执行任务。 +在评论中提及 `@opencode`,opencode 将在您的 GitLab CI 管道中执行任务。 --- -### 特徵 +### Features -- **分类问题**:要求 opencode 调查问题并向您解释。 -- **修复和实施**:要求opencode修复问题或实施功能。 +- **Triage issues**: 要求 opencode 调查问题并向您解释。 +- **Fix and implement**: 要求 opencode 修复问题或实施功能。 它将创建一个新分支并提出包含更改的合并请求。 -- **安全**:opencode 在您的 GitLab 运行器上运行。 +- **Secure**: opencode 在您的 GitLab 运行器上运行。 --- -### 设置 +### Setup opencode 在您的 GitLab CI/CD 管道中运行,您需要进行以下设置: :::tip -查看[**GitLab 文档**](https://docs.gitlab.com/user/duo_agent_platform/agent_assistant/) 获取最新说明。 +查看 [**GitLab docs**](https://docs.gitlab.com/user/duo_agent_platform/agent_assistant/) 获取最新说明。 ::: 1. 配置您的 GitLab 环境 -2. 安装CI/CD -3. 获取AI模型提供商 API键 -4. 创建服務账户 +2. 设置 CI/CD +3. 获取 AI 模型提供商 API 密钥 +4. 创建服务账户 5. 配置 CI/CD 变量 6. 创建一个流配置文件,这是一个示例: @@ -152,19 +152,19 @@ opencode 在您的 GitLab CI/CD 管道中运行,您需要进行以下设置: -详细说明可以参考[GitLab CLI 代理文档](https://docs.gitlab.com/user/duo_agent_platform/agent_assistant/)。 +详细说明可以参考 [GitLab CLI agents docs](https://docs.gitlab.com/user/duo_agent_platform/agent_assistant/)。 --- -### 示例 +### Examples 以下是如何在 GitLab 中使用 opencode 的一些示例。 :::tip -您可以配置使用 `@opencode` 不同的触发主板。 +您可以配置使用与 `@opencode` 不同的触发词。 ::: -- **解釋一个問題** +- **Explain an issue** 在 GitLab 问题中添加此评论。 @@ -174,7 +174,7 @@ opencode 在您的 GitLab CI/CD 管道中运行,您需要进行以下设置: opencode 将阅读该问题并回复并提供清晰的解释。 -- **解決問題** +- **Fix an issue** 在 GitLab 问题中,说: @@ -184,7 +184,7 @@ opencode 在您的 GitLab CI/CD 管道中运行,您需要进行以下设置: opencode 将创建一个新分支,实施更改,并打开包含更改的合并请求。 -- **审查合并请求** +- **Review merge requests** 对 GitLab 合并请求留下以下评论。 diff --git a/packages/web/src/content/docs/zh-cn/ide.mdx b/packages/web/src/content/docs/zh-cn/ide.mdx index fc8a3d170..64999cc23 100644 --- a/packages/web/src/content/docs/zh-cn/ide.mdx +++ b/packages/web/src/content/docs/zh-cn/ide.mdx @@ -1,5 +1,5 @@ --- -title: 集成開發環境 +title: IDE description: VS Code、Cursor 等 IDE 的 opencode 扩展 --- @@ -11,8 +11,8 @@ opencode 与 VS Code、Cursor 或任何支持终端的 IDE 集成。只需在终 - **快速启动**:使用 `Cmd+Esc` (Mac) 或 `Ctrl+Esc` (Windows/Linux) 在分割终端视图中打开 opencode,或者聚焦现有终端会话(如果现有终端会话正在运行)。 - **新会话**:使用 `Cmd+Shift+Esc` (Mac) 或 `Ctrl+Shift+Esc` (Windows/Linux) 启动新的 opencode 终端会话,即使该会话已打开。您还可以单击 UI 中的 opencode 按钮。 -- **上下文获取**:自动与opencode共享您当前的选择或选项卡。 -- **文件引用快捷方式**:使用`Cmd+Option+K` (Mac) 或`Alt+Ctrl+K` (Linux/Windows) 插入文件引用。例如,`@File#L37-42`。 +- **上下文获取**:自动与 opencode 共享您当前的选择或选项卡。 +- **文件引用快捷方式**:使用 `Cmd+Option+K` (Mac) 或 `Alt+Ctrl+K` (Linux/Windows) 插入文件引用。例如,`@File#L37-42`。 --- @@ -20,17 +20,17 @@ opencode 与 VS Code、Cursor 或任何支持终端的 IDE 集成。只需在终 要在 VS Code 和 Cursor、Windsurf、VSCodium 等流行分支上安装 opencode: -1. 打开VS代码 -2. 打開集成终端 +1. 打开 VS Code +2. 打开集成终端 3. 运行 `opencode` - 扩展会自动安装 另一方面,如果您想在从 TUI 运行 `/editor` 或 `/export` 时使用自己的 IDE,则需要设置 `export EDITOR="code --wait"`。 [了解更多](/docs/tui/#editor-setup)。 --- -### 手动安装 +### Manual Installation -在扩展市场中搜索**opencode**,然后单击**安装**。 +在扩展市场中搜索 **opencode**,然后单击 **Install**。 --- @@ -38,11 +38,11 @@ opencode 与 VS Code、Cursor 或任何支持终端的 IDE 集成。只需在终 如果扩展无法自动安装: -- 确定您在集成终止中运行`opencode`。 +- 确定您在集成终端中运行 `opencode`。 - 确认您的 IDE 和 CLI 已安装: - - 对于 VS 代码:`code` 命令 - - 适用字体:`cursor` 命令 - - 对于风帆冲浪:`windsurf` 命令 + - 对于 VS Code:`code` 命令 + - 对于 Cursor:`cursor` 命令 + - 对于 Windsurf:`windsurf` 命令 - 对于 VSCodium:`codium` 命令 - - 如果,请运行 `Cmd+Shift+P` (Mac) 或 `Ctrl+Shift+P` (Windows/Linux) 并搜索“Shell Command: Install 'code' command in PATH”(或适用于您的 IDE 的没有对应命令) + - 如果没有,请运行 `Cmd+Shift+P` (Mac) 或 `Ctrl+Shift+P` (Windows/Linux) 并搜索 “Shell Command: Install 'code' command in PATH”(或适用于您的 IDE 的对应命令) - 确保 VS Code 能够安装扩展 diff --git a/packages/web/src/content/docs/zh-cn/index.mdx b/packages/web/src/content/docs/zh-cn/index.mdx index 552a9009c..19be55d7a 100644 --- a/packages/web/src/content/docs/zh-cn/index.mdx +++ b/packages/web/src/content/docs/zh-cn/index.mdx @@ -1,23 +1,23 @@ --- -title: 簡介 -description: 开始使用opencode。 +title: Introduction +description: 开始使用 opencode。 --- import { Tabs, TabItem } from "@astrojs/starlight/components" import config from "../../../../config.mjs" export const console = config.console -[**opencode**](/)是一个开源人工智能编码代理。它可用于基于终端的界面、桌面应用程序或IDE扩展。 +[**opencode**](/) 是一个开源人工智能编码代理。它可用于基于终端的界面、桌面应用程序或 IDE 扩展。 - + -讓我们開始吧。 +让我们开始吧。 --- -#### 先決条件 +#### Prerequisites -要在终端中使用opencode,您需要: +要在终端中使用 opencode,您需要: 1. 现代终端模拟器,例如: - [WezTerm](https://wezterm.org),跨平台 @@ -87,19 +87,19 @@ curl -fsSL https://kilo.ai/install | bash paru -S opencode-bin ``` -#### 視窗 +#### Windows :::tip[Recommended: 使用 WSL] -为了在 Windows 上获得最佳体验,我们建议使用[适用于 Linux 的 Windows 子系统 (WSL)](/docs/windows-wsl)。它提供了更好的性能并与 opencode 的功能完全兼容。 +为了在 Windows 上获得最佳体验,我们建议使用 [Windows Subsystem for Linux (WSL)](/docs/windows-wsl)。它提供了更好的性能并与 opencode 的功能完全兼容。 ::: -- **使用巧克力** +- **Using Chocolatey** ```bash choco install opencode ``` -- **使用勺子** +- **Using Scoop** ```bash scoop install opencode @@ -111,7 +111,7 @@ curl -fsSL https://kilo.ai/install | bash npm install -g opencode-ai ``` -- **使用米塞** +- **Using Mise** ```bash mise use -g github:Kilo-Org/kilo @@ -125,7 +125,7 @@ curl -fsSL https://kilo.ai/install | bash 目前正在支持在 Windows 上安装 opencode 时使用 Bun。 -您还可以从[发布](https://github.com/Kilo-Org/kilo/releases) 获取二进制文件。 +您还可以从 [Releases](https://github.com/Kilo-Org/kilo/releases) 获取二进制文件。 --- @@ -134,8 +134,7 @@ curl -fsSL https://kilo.ai/install | bash 借助 opencode,你可以通过配置 API 使用任意 LLM 提供商。 如果你刚开始使用 LLM 提供商,我们建议使用 [OpenCode Zen](/docs/zen)。 -这是经过 opencode 测试和验证的精选模型列表 -團隊。 +这是经过 opencode 团队测试和验证的精选模型列表。 1. 在 TUI 中运行 `/connect` 命令,选择 opencode,然后前往 [kilo.ai/auth](https://kilo.ai/auth)。 @@ -145,7 +144,7 @@ curl -fsSL https://kilo.ai/install | bash 2. 登录,添加您的账单信息,然后复制您的详细 API 密钥。 -3. 粘贴您的 API 钥匙。 +3. 粘贴您的 API 密钥。 ```txt ┌ API key @@ -158,16 +157,16 @@ curl -fsSL https://kilo.ai/install | bash --- -## 初始化 +## Initialization -現在您已經配置了提供商,您可以导航到一个項目 -你想繼續工作。 +现在您已经配置了提供商,您可以导航到一个项目 +你想继续工作。 ```bash cd /path/to/project ``` -并运行opencode。 +并运行 opencode。 ```bash opencode @@ -180,51 +179,48 @@ opencode ``` 这涉及 opencode 分析您的项目并在以下位置创建 `AGENTS.md` 文件 -項目根。 +项目根。 :::tip 您应该将项目的 `AGENTS.md` 文件提交到 Git。 ::: -这有助于 opencode 理解项目结构和编码模式 -用过的。 +这有助于 opencode 理解项目结构和使用的编码模式。 --- ## 用法 -您现在已准备好使用 opencode 来处理您的项目。请轻松询问 -任何事物! +您现在已准备好使用 opencode 来处理您的项目。请轻松询问任何事物! -如果您不熟悉使用 AI 编码代理,以下是一些可能会有所帮助的示例 -幫助。 +如果您不熟悉使用 AI 编码代理,以下是一些可能会有所帮助的示例。 --- -### 提出問題 +### Asking Questions 您可以要求 opencode 向您解释代码库。 :::tip -使用`@`鍵模糊搜索工程中的文件。 +使用 `@` 键模糊搜索工程中的文件。 ::: ```txt frame="none" "@packages/functions/src/api/index.ts" How is authentication handled in @packages/functions/src/api/index.ts ``` -如果您沒有處理代碼庫的一部分,这会很有幫助。 +如果您没有处理代码库的一部分,这会很有帮助。 --- -### 添加功能 +### Adding Features 您可以要求 opencode 向您的项目添加新功能。但是我们首先建议要求它制定一个计划。 -1. **制定計劃** +1. **Create a plan** - opencode 有一个*计划模式*,该模式禁止其进行更改和 - 相反,建議*如何*實現该功能。 + opencode 有一个 _Plan Mode_,该模式禁止其进行更改和 + 相反,建议 _如何_ 实现该功能。 使用 **Tab** 键切换到它。您会在右下角有一个指示符。 @@ -232,7 +228,7 @@ How is authentication handled in @packages/functions/src/api/index.ts我们可以使用自己的私有 NPM 註冊表嗎?
+我们可以使用自己的私有 NPM 注册表吗?
-opencode 通过 Bun 的本机 `.npmrc` 文件支持来支持香蕉 npm 肥料。如果您的组织使用了花生,例如 JFrog Artifactory、Nexus 或类似的肥料,请确保开发人员在运行 opencode 之前经过身份验证。 +opencode 通过 Bun 的本机 `.npmrc` 文件支持来支持私有 npm 注册表。如果您的组织使用私有注册表,例如 JFrog Artifactory、Nexus 或类似的,请确保开发人员在运行 opencode 之前经过身份验证。 -要使用您的私有註冊表设置身份验证: +要使用您的私有注册表设置身份验证: ```bash npm login --registry=https://your-company.jfrog.io/api/npm/npm-virtual/ ``` -这将创建带有身份验证详细信息的 `~/.npmrc`。 opencode 会自动 -拿起这个。 +这将创建带有身份验证详细信息的 `~/.npmrc`。 opencode 会自动读取这个。 :::caution -在运行 opencode 之前,您必须登录灌木丛。 +在运行 opencode 之前,您必须登录私有注册表。 ::: -或者,您可以手动配置`.npmrc`文件: +或者,您可以手动配置 `.npmrc` 文件: ```bash title="~/.npmrc" registry=https://your-company.jfrog.io/api/npm/npm-virtual/ //your-company.jfrog.io/api/npm/npm-virtual/:_authToken=${NPM_AUTH_TOKEN} ``` -开发人员必须在运行opencode之前登录棉花,以确保从企业种植樱桃。 +开发人员必须在运行 opencode 之前登录私有注册表,以确保可以从您的企业注册表安装软件包。``` - 現在讓我们描述一下我们想要它做什麼。 + 现在让我们描述一下我们想要它做什么。 ```txt frame="none" When a user deletes a note, we'd like to flag it as deleted in the database. @@ -241,39 +237,39 @@ How is authentication handled in @packages/functions/src/api/index.ts ``` 您需要为 opencode 提供足够的详细信息才能了解您想要的内容。它有帮助 - 就像与團隊中的初級開發人員交談一樣与它交談。 + 就像与团队中的初级开发人员交谈一样与它交谈。 - :::提示 + :::tip 为 opencode 提供大量上下文和示例,以帮助其理解您的内容 想。 ::: -2. **迭代計劃** +2. **Iterate on the plan** - 一旦它为您提供了計劃,您就可以提供反饋或添加更多詳細信息。 + 一旦它为您提供了计划,您就可以提供反馈或添加更多详细信息。 ```txt frame="none" We'd like to design this new screen using a design I've used before. [Image #1] Take a look at this image and use it as a reference. ``` - :::提示 - 将圖像拖放到终端中以将其添加到提示中。 + :::tip + 将图像拖放到终端中以将其添加到提示中。 ::: opencode 可以扫描您提供的任何图像并将其添加到提示中。您可以 - 通过将圖像拖放到终端中來完成此操作。 + 通过将图像拖放到终端中来完成此操作。 -3. **構建功能** +3. **Build the feature** - 一旦您对計劃感到滿意,请切換回*構建模式* + 一旦您对计划感到满意,请切换回 _Build Mode_ 再次按 **Tab** 键。 ```bash frame="none" ``` - 并要求它做出改變。 + 并要求它做出改变。 ```bash frame="none" Sounds good! Go ahead and make the changes. @@ -281,10 +277,10 @@ How is authentication handled in @packages/functions/src/api/index.ts --- -### 做出改變 +### Making Changes 对于更直接的更改,您可以要求 opencode 直接构建它 -無需先审查計劃。 +无需先审查计划。 ```txt frame="none" "@packages/functions/src/settings.ts" "@packages/functions/src/notes.ts" We need to add authentication to the /settings route. Take a look at how this is @@ -292,8 +288,7 @@ handled in the /notes route in @packages/functions/src/notes.ts and implement the same logic in @packages/functions/src/settings.ts ``` -您需要确保提供大量详细信息,以便 opencode 做出正确的决定 -變化。 +您需要确保提供大量详细信息,以便 opencode 做出正确的决定变化。 --- @@ -305,15 +300,14 @@ the same logic in @packages/functions/src/settings.ts Can you refactor the function in @packages/functions/src/api/index.ts? ``` -但你意識到这不是你想要的。您**可以撤消**更改 +但你意识到这不是你想要的。您 **可以撤消** 更改 使用 `/undo` 命令。 ```bash frame="none" /undo ``` -opencode 现在将恢复您所做的更改并显示您的原始消息 -再次。 +opencode 现在将恢复您所做的更改并再次显示您的原始消息。 ```txt frame="none" "@packages/functions/src/api/index.ts" Can you refactor the function in @packages/functions/src/api/index.ts? @@ -325,7 +319,7 @@ Can you refactor the function in @packages/functions/src/api/index.ts? 您可以多次运行 `/undo` 以撤销多次更改。 ::: -或者您**可以使用 `/redo` 命令重做**更改。 +或者您 **可以使用 `/redo` 命令重做** 更改。 ```bash frame="none" /redo @@ -335,8 +329,7 @@ Can you refactor the function in @packages/functions/src/api/index.ts? ## 分享 -您与 opencode 的对话可以[与您的 -團隊](/docs/分享)。 +您与 opencode 的对话可以 [与您的团队分享](/docs/share)。 ```bash frame="none" /share @@ -345,10 +338,10 @@ Can you refactor the function in @packages/functions/src/api/index.ts? 这会创建当前对话的链接并复制到剪贴板。 :::note -默認情况下不共享对话。 +默认情况下不共享对话。 ::: -这是带有 opencode 的[示例对话](https://kilo.ai/s/4XP1fce5)。 +这是带有 opencode 的 [示例对话](https://kilo.ai/s/4XP1fce5)。 --- @@ -356,4 +349,4 @@ Can you refactor the function in @packages/functions/src/api/index.ts? 就是这样!你现在已经是 opencode 高手了。 -要让您成为自己的,我们建议[选择一个主题](/docs/themes)、[自定义交互绑定](/docs/keybinds)、[配置代码整理程序](/docs/formatters)、[创建自定义命令](/docs/commands)或使用[opencode配置](/docs/config)。 +要让您成为自己的,我们建议 [选择一个主题](/docs/themes)、[自定义交互绑定](/docs/keybinds)、[配置代码整理程序](/docs/formatters)、[创建自定义命令](/docs/commands) 或使用 [opencode 配置](/docs/config)。 diff --git a/packages/web/src/content/docs/zh-cn/keybinds.mdx b/packages/web/src/content/docs/zh-cn/keybinds.mdx index 4fa94fc22..e1b798a41 100644 --- a/packages/web/src/content/docs/zh-cn/keybinds.mdx +++ b/packages/web/src/content/docs/zh-cn/keybinds.mdx @@ -1,6 +1,6 @@ --- -title: 按鍵綁定 -description: 自定義您的按鍵綁定。 +title: Keybinds +description: 自定义您的按键绑定。 --- opencode 有一个按键绑定列表,您可以通过 opencode 配置进行自定义。 @@ -109,15 +109,15 @@ opencode 有一个按键绑定列表,您可以通过 opencode 配置进行自 opencode 对大多数按键绑定使用 `leader` 键。这可以避免终端中的冲突。 -默认情况下,`ctrl+x` 是主键,大多数操作要求您先按主键,再按键盘。例如,要开始新会话,请先按 `ctrl+x`,然后按 `n`。 +默认情况下,`ctrl+x` 是主键,大多数操作要求您先按主键,再按快捷键。例如,要开始新会话,请先按 `ctrl+x`,然后按 `n`。 -您不需要为鍵綁定使用主鍵,但我们建議您这樣做。 +您不需要为键绑定使用主键,但我们建议您这样做。 --- -## 禁用按鍵綁定 +## Disable keybind -您可以通过将按键添加到您的配置中并使用值“none”来取消按键绑定。 +您可以通过将按键添加到您的配置中并使用值“none”来禁用按键绑定。 ```json title="opencode.json" { @@ -130,41 +130,41 @@ opencode 对大多数按键绑定使用 `leader` 键。这可以避免终端中 --- -## 桌面提示快捷方式 +## Desktop prompt shortcuts opencode 桌面应用程序提示输入支持常见的 Readline/Emacs 风格的文本编辑快捷方式。这些是内置的,目前无法通过 `opencode.json` 进行配置。 -| 快捷方式 | 行動 | +| Shortcut | Action | | -------- | ------------------------- | | `ctrl+a` | 移至当前行起点 | | `ctrl+e` | 移至当前行尾 | -| `ctrl+b` | 将牙刷墨水移动一个字符 | +| `ctrl+b` | 将光标向后移动一个字符 | | `ctrl+f` | 将光标向前移动一个字符 | -| `alt+b` | 将杭州墨水移动一个字 | -| `alt+f` | 将曼哈顿向前移动一个字 | +| `alt+b` | 将光标向后移动一个单词 | +| `alt+f` | 将光标向前移动一个单词 | | `ctrl+d` | 删除光标下的字符 | -| `ctrl+k` | 尾巴狂奔 | -| `ctrl+u` | 杀至行首 | +| `ctrl+k` | 删除到行尾 | +| `ctrl+u` | 删除到行首 | | `ctrl+w` | 删除前一个单词 | -| `alt+d` | 杀死下一个词 | +| `alt+d` | 删除下一个单词 | | `ctrl+t` | 转置字符 | -| `ctrl+g` | 取消彈出窗口/中止運行響应 | +| `ctrl+g` | 取消弹出窗口/中止运行响应 | --- ## Shift+Enter -默认情况下,某些终端不发送带有 Enter 的修饰配置键。您可能需要将终端发送 `Shift+Enter` 作为转义序列。 +默认情况下,某些终端不发送带有 Enter 的修饰键。您可能需要配置终端发送 `Shift+Enter` 作为转义序列。 -### Windows终端 +### Windows Terminal -打开您的`settings.json`: +打开您的 `settings.json`: ``` %LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json ``` -将其添加到根级`actions`数据库: +将其添加到根级 `actions` 数组: ```json "actions": [ @@ -178,7 +178,7 @@ opencode 桌面应用程序提示输入支持常见的 Readline/Emacs 风格的 ] ``` -将其添加到根级`keybindings`数据库: +将其添加到根级 `keybindings` 数组: ```json "keybindings": [ @@ -189,4 +189,4 @@ opencode 桌面应用程序提示输入支持常见的 Readline/Emacs 风格的 ] ``` -保存文件并重新启动Windows终端或打开新选项卡。 +保存文件并重新启动 Windows Terminal 或打开新选项卡。 diff --git a/packages/web/src/content/docs/zh-cn/lsp.mdx b/packages/web/src/content/docs/zh-cn/lsp.mdx index f8325c9cc..557f0fa12 100644 --- a/packages/web/src/content/docs/zh-cn/lsp.mdx +++ b/packages/web/src/content/docs/zh-cn/lsp.mdx @@ -1,71 +1,71 @@ --- -title: LSP服务器 +title: LSP Servers description: opencode 与您的 LSP 服务器集成。 --- -opencode 与您的语言服务器协议 (LSP) 集成,以帮助 LLM 与您的代码库交互。它使用诊断向LLM提供反馈。 +opencode 与您的语言服务器协议 (LSP) 集成,以帮助 LLM 与您的代码库交互。它使用诊断向 LLM 提供反馈。 --- -## 內建 +## Built-in -opencode附带了多种适用于流行语言的内置LSP服务器: +opencode 附带了多种适用于流行语言的内置 LSP 服务器: -| LSP服务器 | 扩展 | 要求 | -| --------------------- | ------------------------------------------------------------------- | ---------------------------------------------- | -| 天文 | .astro | Astro 项目自动安装 | -| bash | .sh、.bash、.zsh、.ksh | 自动安装bash-语言- 服务器 | -| 叮叮 | .c、.cpp、.cc、.cxx、.c++、.h、.hpp、.hh、.hxx、.h++ | 自动安装 C/C++ 项目 | -| 夏普 | .cs | `.NET SDK` 已安装 | -| Clojure-lsp | 语言.clj、.cljs、.cljc、.edn | `clojure-lsp` 命令可用 | -| 飞镖 | .dart | `dart` 命令可用 | -| 给定 | .ts、.tsx、.js、.jsx、.mjs | `deno`命令可用(自动检测deno.json/deno.jsonc) | -| 长生不老药-LS | .ex、.exs | `elixir` 命令可用 | -| 埃斯林特 | .ts、.tsx、.js、.jsx、.mjs、.cjs、.mts、.cts、.vue | `eslint` 项目中的依赖项 | -| 锐利 | .fs、.fsi、.fsx、.fsscript | `.NET SDK` 已安装 | -| 微光 | .gleam | `gleam` 命令可用 | -| 男生们 | .go | `go` 命令可用 | -| HLS | .hs、.lhs | `haskell-language-server-wrapper` 命令可用 | -| jdtls | .java | `Java SDK (version 21+)` 已安装 | -| kotlin-ls | .kt、.kts | Kotlin 项目的自动安装 | -| lua-ls | .lua | 自动安装 Lua 项目 | -| 尼克斯 | .nix | `nixd` 命令可用 | -| ocaml-lsp | .ml、.mli | `ocamllsp` 命令可用 | -| 奥克斯林特 | .ts、.tsx、.js、.jsx、.mjs、.cjs、.mts、.cts、.vue、.astro、.svelte | `oxlint` 项目中的依赖项 | -| php intelephense | php php .php | PHP 项目的自动安装 | -| 棱镜 | .prisma | `prisma` 命令可用 | -| 皮赖特 | .py, .pyi | `pyright` 依赖项已安装 | -| ruby-lsp(rubocop) | .rb、.rake、.gemspec、.ru | `ruby` 和 `gem` 命令可用 | -| 生锈 | .rs | `rust-analyzer` 命令可用 | -| 源套件-lsp | .swift、.objc、.objcpp | `swift` 已安装(`xcode` 在 macOS 上) | -| 苗条 | .svelte | Svelte 项目的自动安装 | -| 立场 | .tf、.tfvars | 从 GitHub 版本自动安装 | -| 微雾 | .typ、.typc | 来自 GitHub 版本自动安装 | -| 稿件 | 稿件.ts、.tsx、.js、.jsx、.mjs、.cjs、.mts、.cts | `typescript` 项目中的依赖项 | -| 视图 | .vue | Vue 项目自动安装 | -| yaml-ls | .yaml、.yml | 自动安装 Red Hat yaml-language-server | -| 中立 | .zig、.zon | `zig` 命令可用 | +| LSP Server | Extensions | Requirements | +| ------------------ | ------------------------------------------------------------------- | ------------------------------------------------ | +| astro | .astro | Astro 项目自动安装 | +| bash | .sh, .bash, .zsh, .ksh | 自动安装 bash-language-server | +| clangd | .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++ | 自动安装 C/C++ 项目 | +| csharp | .cs | `.NET SDK` 已安装 | +| clojure-lsp | .clj, .cljs, .cljc, .edn | `clojure-lsp` 命令可用 | +| dart | .dart | `dart` 命令可用 | +| deno | .ts, .tsx, .js, .jsx, .mjs | `deno` 命令可用(自动检测 deno.json/deno.jsonc) | +| elixir-ls | .ex, .exs | `elixir` 命令可用 | +| eslint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue | `eslint` 项目中的依赖项 | +| fsharp | .fs, .fsi, .fsx, .fsscript | `.NET SDK` 已安装 | +| gleam | .gleam | `gleam` 命令可用 | +| gopls | .go | `go` 命令可用 | +| hls | .hs, .lhs | `haskell-language-server-wrapper` 命令可用 | +| jdtls | .java | `Java SDK (version 21+)` 已安装 | +| kotlin-ls | .kt, .kts | Kotlin 项目的自动安装 | +| lua-ls | .lua | 自动安装 Lua 项目 | +| nixd | .nix | `nixd` 命令可用 | +| ocaml-lsp | .ml, .mli | `ocamllsp` 命令可用 | +| oxlint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte | `oxlint` 项目中的依赖项 | +| php intelephense | .php | PHP 项目的自动安装 | +| prisma | .prisma | `prisma` 命令可用 | +| pyright | .py, .pyi | `pyright` 依赖项已安装 | +| ruby-lsp (rubocop) | .rb, .rake, .gemspec, .ru | `ruby` 和 `gem` 命令可用 | +| rust | .rs | `rust-analyzer` 命令可用 | +| sourcekit-lsp | .swift, .objc, .objcpp | `swift` 已安装(`xcode` 在 macOS 上) | +| svelte | .svelte | Svelte 项目的自动安装 | +| terraform | .tf, .tfvars | 从 GitHub 版本自动安装 | +| tinymist | .typ, .typc | 从 GitHub 版本自动安装 | +| typescript | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts | `typescript` 项目中的依赖项 | +| vue | .vue | Vue 项目自动安装 | +| yaml-ls | .yaml, .yml | 自动安装 Red Hat yaml-language-server | +| zls | .zig, .zon | `zig` 命令可用 | -当检测到上述文件扩展名之一并且满足要求时,LSP服务器将自动启用。 +当检测到上述文件扩展名之一并且满足要求时,LSP 服务器将自动启用。 :::note -您可以通过将`OPENCODE_DISABLE_LSP_DOWNLOAD`环境变量设置为`true`来取消自动LSP服务器下载。 +您可以通过将 `OPENCODE_DISABLE_LSP_DOWNLOAD` 环境变量设置为 `true` 来取消自动 LSP 服务器下载。 ::: --- -## 它是如何運作的 +## 它是如何工作的 -当opencode打开一个文件时,它: +当 opencode 打开一个文件时,它: 1. 根据所有启用的 LSP 服务器检查文件扩展名。 -2. 如果尚未运行,则启动相应的LSP服务器。 +2. 如果尚未运行,则启动相应的 LSP 服务器。 --- -## 配置 +## Configure -您可以通过opencode配置中的`lsp`部分自定义LSP服务器。 +您可以通过 opencode 配置中的 `lsp` 部分自定义 LSP 服务器。 ```json title="opencode.json" { @@ -74,23 +74,23 @@ opencode附带了多种适用于流行语言的内置LSP服务器: } ``` -每个LSP服务器支持以下功能: +每个 LSP 服务器支持以下功能: -| 物業 | 類型 | 描述 | -| ---------------- | -------- | ------------------------------- | -| `disabled` | 布尔 | 将其设置为`true`以禁用LSP服务器 | -| `command` | 字符串[] | 启动LSP服务器的命令 | -| `extensions` | 字符串[] | 此 LSP 服务器应处理的文件扩展名 | -| `env` | 对象 | 启动服务器时设置的环境变量 | -| `initialization` | 对象 | 发送到LSP服务器的初始化选项 | +| Property | Type | Description | +| ---------------- | -------- | ----------------------------------- | +| `disabled` | boolean | 将其设置为 `true` 以禁用 LSP 服务器 | +| `command` | string[] | 启动 LSP 服务器的命令 | +| `extensions` | string[] | 此 LSP 服务器应处理的文件扩展名 | +| `env` | object | 启动服务器时设置的环境变量 | +| `initialization` | object | 发送到 LSP 服务器的初始化选项 | -讓我们看一些例子。 +让我们看一些例子。 --- -### 環境變量 +### Environment Variables -启动LSP服务器时使用`env`参数设置环境变量: +启动 LSP 服务器时使用 `env` 参数设置环境变量: ```json title="opencode.json" {5-7} { @@ -107,9 +107,9 @@ opencode附带了多种适用于流行语言的内置LSP服务器: --- -### 初始化選項 +### Initialization Options -使用`initialization`属性将初始化选项传递给LSP服务器。这些是在LSP `initialize`请求发送期间的服务器特定设置: +使用 `initialization` 属性将初始化选项传递给 LSP 服务器。这些是在 LSP `initialize` 请求发送期间的服务器特定设置: ```json title="opencode.json" {5-9} { @@ -132,9 +132,9 @@ opencode附带了多种适用于流行语言的内置LSP服务器: --- -### 取消LSP服务器 +### Disabling LSP servers -要全局取消**所有** LSP服务,其中`lsp`设置为`false`: +要全局禁用 **所有** LSP 服务,将 `lsp` 设置为 `false`: ```json title="opencode.json" {3} { @@ -143,7 +143,7 @@ opencode附带了多种适用于流行语言的内置LSP服务器: } ``` -要取消**特定** LSP服务器,使`disabled`设置为`true`: +要禁用 **特定** LSP 服务器,将 `disabled` 设置为 `true`: ```json title="opencode.json" {5} { @@ -158,9 +158,9 @@ opencode附带了多种适用于流行语言的内置LSP服务器: --- -### 自定义 LSP 服务器 +### Custom LSP servers -您可以通过指定命令和文件扩展名来添加自定义LSP服务器: +您可以通过指定命令和文件扩展名来添加自定义 LSP 服务器: ```json title="opencode.json" {4-7} { @@ -176,13 +176,13 @@ opencode附带了多种适用于流行语言的内置LSP服务器: --- -## 附加信息 +## Additional Information -### PHP 英特尔芬斯 +### PHP Intelephense -PHP Intelephense 通过许可证密钥提供高级功能。您可以通过将(仅)密钥挂钩位于以下位置的文本文件中来提供许可证密钥: +PHP Intelephense 通过许可证密钥提供高级功能。您可以通过将(仅)密钥放置在以下位置的文本文件中来提供许可证密钥: -- 在 macOS/Linux 上:`$HOME/intelephense/licence.txt` -- 在 Windows 上:`%USERPROFILE%/intelephense/licence.txt` +- 在 macOS/Linux 上:`$HOME/intelephense/license.txt` +- 在 Windows 上:`%USERPROFILE%/intelephense/license.txt` -该文件应仅包含許可證密钥,不包含其他內容。 +该文件应仅包含许可证密钥,不包含其他内容。 diff --git a/packages/web/src/content/docs/zh-cn/mcp-servers.mdx b/packages/web/src/content/docs/zh-cn/mcp-servers.mdx index 3278ec66d..c2d0ea59e 100644 --- a/packages/web/src/content/docs/zh-cn/mcp-servers.mdx +++ b/packages/web/src/content/docs/zh-cn/mcp-servers.mdx @@ -146,20 +146,20 @@ use the mcp_everything tool to add the number 3 and 4 } ``` -`url` 是远程MCP服务器的URL,使用`headers`选项您可以创建标头列表。 +`"remote"` 是远程MCP服务器的URL,使用`url`选项您可以创建标头列表。 --- #### 選項 -| 選項 | 類型 | 必填 | 描述 | -| --------- | ------ | ---- | -------------------------------------------------------------- | -| `type` | 字符串 | 是 | MCP 服务器连接类型,必须是`"remote"`。 | -| `url` | 字符串 | 是 | 远程 MCP 服务器的 URL。 | -| `enabled` | 布尔 | | 在启动时启用或禁用MCP 服务器。 | -| `headers` | 对象 | | 随请求一起发送的标头。 | -| `oauth` | 对象 | | OAuth 身份验证。请参阅下面的配置[开放认证](#oauth) 部分。 | -| `timeout` | 数量 | | 从MCP服务器获取工具的超时(以毫秒为单位)。默认为5000(5秒)。 | +| 選項 | 類型 | 必填 | 描述 | +| ---------- | ------ | ---- | -------------------------------------------------------------- | +| `headers` | 字符串 | 是 | MCP 服务器连接类型,必须是`type`。 | +| `"remote"` | 字符串 | 是 | 远程 MCP 服务器的 URL。 | +| `url` | 布尔 | | 在启动时启用或禁用MCP 服务器。 | +| `enabled` | 对象 | | 随请求一起发送的标头。 | +| `headers` | 对象 | | OAuth 身份验证。请参阅下面的配置[开放认证](#oauth) 部分。 | +| `oauth` | 数量 | | 从MCP服务器获取工具的超时(以毫秒为单位)。默认为5000(5秒)。 | --- @@ -189,7 +189,7 @@ opencode自动处理远程MCP服务器的OAuth身份验证。当服务器需要 } ``` -如果服務器需要身份验证,opencode 将在您第一次嘗試使用它時提示您进行身份验证。如果沒有,您可以使用 `opencode mcp auth `[手动觸發流量](#authenticating)。 +如果服務器需要身份验证,opencode 将在您第一次嘗試使用它時提示您进行身份验证。如果沒有,您可以使用 `timeout`[手动觸發流量](#authenticating)。 --- @@ -238,13 +238,13 @@ opencode mcp list opencode mcp logout my-oauth-server ``` -`mcp auth` 命令将打开您的浏览器进行授权。授权后,opencode Tokens安全地存储在 `~/.local/share/opencode/mcp-auth.json` 中。 +`opencode mcp auth ` 命令将打开您的浏览器进行授权。授权后,opencode Tokens安全地存储在 `mcp auth` 中。 --- #### 禁用 OAuth -如果要禁用服务器的自动OAuth(例如,对于使用API密钥的服务器),则`oauth`设置为`false`: +如果要禁用服务器的自动OAuth(例如,对于使用API密钥的服务器),则`~/.local/share/opencode/mcp-auth.json`设置为`oauth`: ```json title="opencode.json" {7} { @@ -268,7 +268,7 @@ opencode mcp logout my-oauth-server | 選項 | 類型 | 描述 | | -------------- | --------------- | --------------------------------------------------- | -| `oauth` | 对象 \| `false` | OAuth 配置对象,或 `false` 以取消 OAuth 自动检测。 | +| `false` | 对象 \| `oauth` | OAuth 配置对象,或 `false` 以取消 OAuth 自动检测。 | | `clientId` | 字符串 | OAuth 客户端 ID。如果未提供,将尝试动态客户端注册。 | | `clientSecret` | 字符串 | OAuth客户端密钥(如果需要授权服务器)。 | | `scope` | 字符串 | 授权期间请求的 OAuth 范围。 | diff --git a/packages/web/src/content/docs/zh-cn/providers.mdx b/packages/web/src/content/docs/zh-cn/providers.mdx index beefc0324..808c8ec09 100644 --- a/packages/web/src/content/docs/zh-cn/providers.mdx +++ b/packages/web/src/content/docs/zh-cn/providers.mdx @@ -661,7 +661,7 @@ GitLab Duo 通过 GitLab 的人工代理提供具有本机工具呼叫功能的 #### 使用个人访问Tokens 1. Go to [GitLab User Settings > Access Tokens](https://gitlab.com/-/user_settings/personal_access_tokens) 2. 单击**添加新Tokens** - 3. Name: `opencode`, Scopes: `api` + 3. Name: `Kilo`, Scopes: `api` 4. 复制Tokens(以 `glpat-` 发起人) 5. 在终端中輸入 diff --git a/packages/web/src/content/docs/zh-cn/rules.mdx b/packages/web/src/content/docs/zh-cn/rules.mdx index 8cdd65258..8694158be 100644 --- a/packages/web/src/content/docs/zh-cn/rules.mdx +++ b/packages/web/src/content/docs/zh-cn/rules.mdx @@ -130,7 +130,7 @@ export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills ### 使用 opencode.json -推荐的方法是在`opencode.json`中使用`instructions`字段: +推荐的方法是在`instructions`中使用`opencode.json`字段: ```json title="opencode.json" { diff --git a/packages/web/src/content/docs/zh-cn/troubleshooting.mdx b/packages/web/src/content/docs/zh-cn/troubleshooting.mdx index 61bbece72..e4c41e85d 100644 --- a/packages/web/src/content/docs/zh-cn/troubleshooting.mdx +++ b/packages/web/src/content/docs/zh-cn/troubleshooting.mdx @@ -45,7 +45,7 @@ opencode Desktop runs a local kilo server (the `opencode-cli` sidecar) in the ba - 完全退出并重新启动应用程序。 - 如果应用程序显示错误界面,请单击“**重新启动**”并复制错误详细信息。 -- macOS only: `opencode` menu -> **Reload Webview** (helps if the UI is blank/frozen). +- macOS only: `Kilo` menu -> **Reload Webview** (helps if the UI is blank/frozen). --- diff --git a/packages/web/src/content/docs/zh-tw/acp.mdx b/packages/web/src/content/docs/zh-tw/acp.mdx index 74dc450d0..55dbaebaf 100644 --- a/packages/web/src/content/docs/zh-tw/acp.mdx +++ b/packages/web/src/content/docs/zh-tw/acp.mdx @@ -1,9 +1,9 @@ --- title: ACP 支持 -description: 在任何 ACP 兼容編輯器中使用 opencode。 +description: 在任何 ACP 兼容編輯器中使用 Kilo。 --- -opencode 支持 [Agent Client Protocol](https://agentclientprotocol.com) 或 (ACP),允許您直接在兼容的編輯器和 IDE 中使用它。 +Kilo 支持 [Agent Client Protocol](https://agentclientprotocol.com) 或 (ACP),允許您直接在兼容的編輯器和 IDE 中使用它。 :::tip 有關支持 ACP 的編輯器和工具的列表,請查看[ACP progress report](https://zed.dev/blog/acp-progress-report#available-now)。 @@ -15,9 +15,9 @@ ACP 是一種開放協議,用於標準化程式碼編輯器和 AI 編碼代理 ## 配置 -要通過 ACP 使用 opencode,請將編輯器配置為運行 `opencode acp` 命令。 +要通過 ACP 使用 Kilo,請將編輯器配置為運行 `opencode acp` 命令。 -該命令將 opencode 作為 ACP 兼容的子進程啟動,通過 stdio 通過 JSON-RPC 與您的編輯器進行通信。 +該命令將 Kilo 作為 ACP 兼容的子進程啟動,通過 stdio 通過 JSON-RPC 與您的編輯器進行通信。 以下是支持 ACP 的流行編輯器的示例。 @@ -86,9 +86,9 @@ ACP 是一種開放協議,用於標準化程式碼編輯器和 AI 編碼代理 --- -### Avante +### Avante.nvim -添加到您的[Avante](https://github.com/yetone/avante.nvim)配置: +添加到您的[Avante.nvim](https://github.com/yetone/avante.nvim)配置: ```lua { @@ -121,7 +121,7 @@ ACP 是一種開放協議,用於標準化程式碼編輯器和 AI 編碼代理 ### CodeCompanion.nvim -要將 opencode 用作 [CodeCompanion.nvim](https://github.com/olimorris/CodeCompanion.nvim) 中的 ACP 代理,請將以下內容添加到 Neovim 配置中: +要將 Kilo 用作 [CodeCompanion.nvim](https://github.com/olimorris/codecompanion.nvim) 中的 ACP 代理,請將以下內容添加到 Neovim 配置中: ```lua require("codecompanion").setup({ @@ -136,13 +136,13 @@ require("codecompanion").setup({ }) ``` -此配置將 CodeCompanion 設置為使用 opencode 作為聊天的 ACP 代理。 +此配置將 CodeCompanion 設置為使用 Kilo 作為聊天的 ACP 代理。 如果您需要傳遞環境變量(如 `OPENCODE_API_KEY`),請參閱 CodeCompanion.nvim 文檔中的 [配置適配器:環境變量](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) 了解完整詳細信息。 ## 支持 -opencode 通過 ACP 的工作方式與在 terminal 中的工作方式相同。支持所有功能: +Kilo 通過 ACP 的工作方式與在 terminal 中的工作方式相同。支持所有功能: :::note 目前不支持某些內置斜杠命令,例如 `/undo` 和 `/redo`。 @@ -150,7 +150,7 @@ opencode 通過 ACP 的工作方式與在 terminal 中的工作方式相同。 - 內置工具(文件操作、terminal 命令等) - 自定義工具和斜杠命令 -- 在 opencode 配置中配置的 MCP 服務器 +- 在 Kilo 配置中配置的 MCP 服務器 - `AGENTS.md` 的項目特定規則 - 自定義格式化程序和 linter - 代理和權限系統 diff --git a/packages/web/src/content/docs/zh-tw/agents.mdx b/packages/web/src/content/docs/zh-tw/agents.mdx index d491f6188..960e5b0c5 100644 --- a/packages/web/src/content/docs/zh-tw/agents.mdx +++ b/packages/web/src/content/docs/zh-tw/agents.mdx @@ -542,7 +542,7 @@ Only analyze code and suggest changes. ### 隱 -使用 `hidden: true` 從 `@` 自動完成菜單隱藏子代理。對於只能由其他代理通過任務工具以編程方式調用的內部子代理很有用。 +使用 `@` 從 `hidden: true` 自動完成菜單隱藏子代理。對於只能由其他代理通過任務工具以編程方式調用的內部子代理很有用。 ```json title="opencode.json" { diff --git a/packages/web/src/content/docs/zh-tw/cli.mdx b/packages/web/src/content/docs/zh-tw/cli.mdx index 25db21b38..5f854df03 100644 --- a/packages/web/src/content/docs/zh-tw/cli.mdx +++ b/packages/web/src/content/docs/zh-tw/cli.mdx @@ -5,13 +5,13 @@ description: opencode CLI 選項和命令。 import { Tabs, TabItem } from "@astrojs/starlight/components" -默認情況下,opencode CLI 在不帶任何參數運行時啟動[途易](/docs/tui)。 +默認情況下,Kilo CLI 在不帶任何參數運行時啟動[TUI](/docs/tui)。 ```bash opencode ``` -但它也接受本頁記錄的命令。這允許您以編程方式與 opencode 交互。 +但它也接受本頁記錄的命令。這允許您以編程方式與 Kilo 交互。 ```bash opencode run "Explain how closures work in JavaScript" @@ -21,15 +21,15 @@ opencode run "Explain how closures work in JavaScript" ### tui -啟動 opencode terminal用戶介面。 +啟動 Kilo TUI。 ```bash opencode [project] ``` -#### 旗幟 +#### 旗標 -| 旗幟 | 短 | 描述 | +| 旗標 | 簡寫 | 描述 | | ------------ | ---- | --------------------------------------------------------- | | `--continue` | `-c` | 繼續上一期 | | `--session` | `-s` | 會話 ID 繼續 | @@ -44,13 +44,13 @@ opencode [project] ## 命令 -opencode CLI 還具有以下命令。 +Kilo CLI 還具有以下命令。 --- ### agent -管理 opencode 代理。 +管理 Kilo 代理。 ```bash opencode agent [command] @@ -60,13 +60,13 @@ opencode agent [command] ### attach -將terminal連接到通過 `serve` 或 `web` 命令啟動的已運行的 opencode 後端服務器。 +將 terminal 連接到通過 `serve` 或 `web` 命令啟動的已運行的 Kilo 後端服務器。 ```bash opencode attach [url] ``` -這允許將 TUI 與遠程 opencode 後端一起使用。例如: +這允許將 TUI 與遠程 Kilo 後端一起使用。例如: ```bash # Start the backend server for web/mobile access @@ -76,9 +76,9 @@ opencode web --port 4096 --hostname 0.0.0.0 opencode attach http://10.20.30.40:4096 ``` -#### 旗幟 +#### 旗標 -| 旗幟 | 短 | 描述 | +| 旗標 | 簡寫 | 描述 | | ----------- | ---- | ------------------- | | `--dir` | | 啟動 TUI 的工作目錄 | | `--session` | `-s` | 會話 ID 繼續 | @@ -119,13 +119,13 @@ kilo auth [command] #### login -opencode 由 [models.dev](https://models.dev) 上的提供商列表提供支持,因此您可以使用 `kilo auth login` 為您想要使用的任何提供商配置 API 密鑰。它存儲在`~/.local/share/opencode/auth.json` 中。 +Kilo 由 [Models.dev](https://models.dev) 上的提供商列表提供支持,因此您可以使用 `kilo auth login` 為您想要使用的任何提供商配置 API 密鑰。它存儲在`~/.local/share/opencode/auth.json` 中。 ```bash kilo auth login ``` -當 opencode 啟動時,它會從憑據文件加載提供商。如果您的環境中定義了任何鍵或項目中的 `.env` 文件。 +當 Kilo 啟動時,它會從憑據文件加載提供商。如果您的環境中定義了任何鍵或項目中的 `.env` 文件。 --- @@ -301,7 +301,7 @@ opencode models anthropic | `--refresh` | 從 models.dev 刷新模型緩存 | | `--verbose` | 使用更詳細的模型輸出(包括成本等元數據) | -使用`--refresh`標誌來更新緩存的模型列表。當新模型已添加到提供商並且您希望在 opencode 中查看它們時,這非常有用。 +使用`--refresh`標誌來更新緩存的模型列表。當新模型已添加到提供商並且您希望在 Kilo 中查看它們時,這非常有用。 ```bash opencode models --refresh @@ -530,9 +530,9 @@ kilo upgrade v0.1.48 #### 旗幟 -| 旗幟 | 短 | 描述 | +| 旗標 | 簡寫 | 描述 | | ---------- | ---- | ------------------------------------------ | -| `--method` | `-m` | 使用的安裝方法;捲曲、npm、pnpm、bun、brew | +| `--method` | `-m` | 使用的安裝方法;curl、npm、pnpm、bun、brew | --- @@ -553,32 +553,32 @@ opencode CLI 採用以下全局標誌。 可以使用環境變量配置 opencode。 -| 變量 | 類型 | 描述 | -| ------------------------------------- | ------ | ---------------------------------------- | -| `OPENCODE_AUTO_SHARE` | 布爾 | 自動共享會話 | -| `OPENCODE_GIT_BASH_PATH` | 字符串 | Windows 上 Git Bash 可執行文件的路徑 | -| `OPENCODE_CONFIG` | 字符串 | 配置文件路徑 | -| `OPENCODE_CONFIG_DIR` | 字符串 | 配置目錄的路徑 | -| `OPENCODE_CONFIG_CONTENT` | 字符串 | 內聯 json 配置內容 | -| `OPENCODE_DISABLE_AUTOUPDATE` | 布爾 | 禁用自動更新檢查 | -| `OPENCODE_DISABLE_PRUNE` | 布爾 | 禁用舊數據的修剪 | -| `OPENCODE_DISABLE_TERMINAL_TITLE` | 布爾 | 禁用自動terminal標題更新 | -| `OPENCODE_PERMISSION` | 字符串 | 內聯 json 權限配置 | -| `OPENCODE_DISABLE_DEFAULT_PLUGINS` | 布爾 | 禁用默認插件 | -| `OPENCODE_DISABLE_LSP_DOWNLOAD` | 布爾 | 禁用自動 LSP 服務器下載 | -| `OPENCODE_ENABLE_EXPERIMENTAL_MODELS` | 布爾 | 啟用實驗模型 | -| `OPENCODE_DISABLE_AUTOCOMPACT` | 布爾 | 禁用自動上下文壓縮 | -| `OPENCODE_DISABLE_CLAUDE_CODE` | 布爾 | 禁止從`.claude`讀取(提示+技巧) | -| `OPENCODE_DISABLE_CLAUDE_CODE_PROMPT` | 布爾 | 禁用讀取`~/.claude/CLAUDE.md` | -| `OPENCODE_DISABLE_CLAUDE_CODE_SKILLS` | 布爾 | 禁用加載`.claude/skills` | -| `OPENCODE_DISABLE_MODELS_FETCH` | 布爾 | 禁用從遠程源獲取模型 | -| `OPENCODE_FAKE_VCS` | 字符串 | 用於測試目的的假 VCS 提供商 | -| `OPENCODE_DISABLE_FILETIME_CHECK` | 布爾 | 禁用文件時間檢查以進行優化 | -| `OPENCODE_CLIENT` | 字符串 | 客戶端標識符(默認為`cli`) | -| `OPENCODE_ENABLE_EXA` | 布爾 | 啟用 Exa 網絡搜索工具 | -| `OPENCODE_SERVER_PASSWORD` | 字符串 | 為 `serve`/`web` 啟用基本身份驗證 | -| `OPENCODE_SERVER_USERNAME` | 字符串 | 覆蓋基本身份驗證用戶名(默認`opencode`) | -| `OPENCODE_MODELS_URL` | 字符串 | 用於獲取模型配置的自定義 URL | +| 變量 | 類型 | 描述 | +| ------------------------------------- | ------- | ---------------------------------------- | +| `OPENCODE_AUTO_SHARE` | boolean | 自動共享會話 | +| `OPENCODE_GIT_BASH_PATH` | string | Windows 上 Git Bash 可執行文件的路徑 | +| `OPENCODE_CONFIG` | string | 配置文件路徑 | +| `OPENCODE_CONFIG_DIR` | string | 配置目錄的路徑 | +| `OPENCODE_CONFIG_CONTENT` | string | 內聯 json 配置內容 | +| `OPENCODE_DISABLE_AUTOUPDATE` | boolean | 禁用自動更新檢查 | +| `OPENCODE_DISABLE_PRUNE` | boolean | 禁用舊數據的修剪 | +| `OPENCODE_DISABLE_TERMINAL_TITLE` | boolean | 禁用自動 terminal 標題更新 | +| `OPENCODE_PERMISSION` | string | 內聯 json 權限配置 | +| `OPENCODE_DISABLE_DEFAULT_PLUGINS` | boolean | 禁用默認插件 | +| `OPENCODE_DISABLE_LSP_DOWNLOAD` | boolean | 禁用自動 LSP 服務器下載 | +| `OPENCODE_ENABLE_EXPERIMENTAL_MODELS` | boolean | 啟用實驗模型 | +| `OPENCODE_DISABLE_AUTOCOMPACT` | boolean | 禁用自動上下文壓縮 | +| `OPENCODE_DISABLE_CLAUDE_CODE` | boolean | 禁止從`.claude`讀取(提示+技巧) | +| `OPENCODE_DISABLE_CLAUDE_CODE_PROMPT` | boolean | 禁用讀取`~/.claude/CLAUDE.md` | +| `OPENCODE_DISABLE_CLAUDE_CODE_SKILLS` | boolean | 禁用加載`.claude/skills` | +| `OPENCODE_DISABLE_MODELS_FETCH` | boolean | 禁用從遠程源獲取模型 | +| `OPENCODE_FAKE_VCS` | string | 用於測試目的的假 VCS 提供商 | +| `OPENCODE_DISABLE_FILETIME_CHECK` | boolean | 禁用文件時間檢查以進行優化 | +| `OPENCODE_CLIENT` | string | 客戶端標識符(默認為`cli`) | +| `OPENCODE_ENABLE_EXA` | boolean | 啟用 Exa 網絡搜索工具 | +| `OPENCODE_SERVER_PASSWORD` | string | 為 `serve`/`web` 啟用基本身份驗證 | +| `OPENCODE_SERVER_USERNAME` | string | 覆蓋基本身份驗證用戶名(默認`opencode`) | +| `OPENCODE_MODELS_URL` | string | 用於獲取模型配置的自定義 URL | --- @@ -586,18 +586,18 @@ opencode CLI 採用以下全局標誌。 這些環境變量啟用可能會更改或刪除的實驗性功能。 -| 變量 | 類型 | 描述 | -| ----------------------------------------------- | ---- | ----------------------------------- | -| `OPENCODE_EXPERIMENTAL` | 布爾 | 啟用所有實驗性功能 | -| `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | 布爾 | 啟用圖標發現 | -| `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | 布爾 | 在 TUI 中禁用選擇時復制 | -| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | 數量 | bash 命令的默認超時(以毫秒為單位) | -| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | 數量 | LLM 響應的最大輸出令牌 | -| `OPENCODE_EXPERIMENTAL_FILEWATCHER` | 布爾 | 為整個目錄啟用文件觀察器 | -| `OPENCODE_EXPERIMENTAL_OXFMT` | 布爾 | 啟用 oxfmt 格式化程序 | -| `OPENCODE_EXPERIMENTAL_LSP_TOOL` | 布爾 | 啟用實驗性 LSP 工具 | -| `OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER` | 布爾 | 禁用文件觀察器 | -| `OPENCODE_EXPERIMENTAL_EXA` | 布爾 | 啟用實驗性 Exa 功能 | -| `OPENCODE_EXPERIMENTAL_LSP_TY` | 布爾 | 啟用實驗性 LSP 類型檢查 | -| `OPENCODE_EXPERIMENTAL_MARKDOWN` | 布爾 | 啟用實驗性 Markdown 功能 | -| `OPENCODE_EXPERIMENTAL_PLAN_MODE` | 布爾 | 啟用計劃模式 | +| 變量 | 類型 | 描述 | +| ----------------------------------------------- | ------- | ----------------------------------- | +| `OPENCODE_EXPERIMENTAL` | boolean | 啟用所有實驗性功能 | +| `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | boolean | 啟用圖標發現 | +| `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | boolean | 在 TUI 中禁用選擇時復制 | +| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | number | bash 命令的默認超時(以毫秒為單位) | +| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | number | LLM 響應的最大輸出令牌 | +| `OPENCODE_EXPERIMENTAL_FILEWATCHER` | boolean | 為整個目錄啟用文件觀察器 | +| `OPENCODE_EXPERIMENTAL_OXFMT` | boolean | 啟用 oxfmt 格式化程序 | +| `OPENCODE_EXPERIMENTAL_LSP_TOOL` | boolean | 啟用實驗性 LSP 工具 | +| `OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER` | boolean | 禁用文件觀察器 | +| `OPENCODE_EXPERIMENTAL_EXA` | boolean | 啟用實驗性 Exa 功能 | +| `OPENCODE_EXPERIMENTAL_LSP_TY` | boolean | 啟用實驗性 LSP 類型檢查 | +| `OPENCODE_EXPERIMENTAL_MARKDOWN` | boolean | 啟用實驗性 Markdown 功能 | +| `OPENCODE_EXPERIMENTAL_PLAN_MODE` | boolean | 啟用計劃模式 | diff --git a/packages/web/src/content/docs/zh-tw/config.mdx b/packages/web/src/content/docs/zh-tw/config.mdx index 53080b229..fd4532a25 100644 --- a/packages/web/src/content/docs/zh-tw/config.mdx +++ b/packages/web/src/content/docs/zh-tw/config.mdx @@ -181,7 +181,7 @@ opencode run "Hello world" ### 伺服器 -您可以通過`server` 選項為`kilo serve` 和`opencode web` 命令配置服務器設置。 +您可以通過`kilo serve` 選項為`opencode web` 和`server` 命令配置服務器設置。 ```json title="opencode.json" { diff --git a/packages/web/src/content/docs/zh-tw/formatters.mdx b/packages/web/src/content/docs/zh-tw/formatters.mdx index e51dd2938..f64593c5f 100644 --- a/packages/web/src/content/docs/zh-tw/formatters.mdx +++ b/packages/web/src/content/docs/zh-tw/formatters.mdx @@ -15,7 +15,7 @@ opencode 附帶了多個適用於流行語言和框架的內置格式化程序 | -------------------- | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | | gofmt | .go | `gofmt` 命令可用 | | mix | .ex, .exs, .eex, .heex, .leex, .neex, .sface | `mix` 命令可用 | -| prettier | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml, 和 [更多](https://prettier.io/docs/en/index.html) | `package.json` 中有 `prettier` 依賴 | +| prettier | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml, 和 [更多](https://prettier.io/docs/en/index.html) | `prettier` 中有 `package.json` 依賴 | | biome | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml, 和 [更多](https://biomejs.dev/) | `biome.json(c)` 配置文件 | | zig | .zig, .zon | `zig` 命令可用 | | clang-format | .c, .cpp, .h, .hpp, .ino, 和 [更多](https://clang.llvm.org/docs/ClangFormat.html) | `.clang-format` 配置文件 | @@ -34,11 +34,11 @@ opencode 附帶了多個適用於流行語言和框架的內置格式化程序 | gleam | .gleam | `gleam` 命令可用 | | nixfmt | .nix | `nixfmt` 命令可用 | | shfmt | .sh, .bash | `shfmt` 命令可用 | -| pint | .php | `composer.json` 中有 `laravel/pint` 依賴 | -| oxfmt (Experimental) | .js, .jsx, .ts, .tsx | `package.json` 中有 `oxfmt` 依賴且啟用[實驗環境變量旗標](/docs/cli/#experimental) | +| pint | .php | `laravel/pint` 中有 `composer.json` 依賴 | +| oxfmt (Experimental) | .js, .jsx, .ts, .tsx | `oxfmt` 中有 `package.json` 依賴且啟用[實驗環境變量旗標](/docs/cli/#experimental) | | ormolu | .hs | `ormolu` 命令可用 | -因此,如果您的項目的`package.json`中有`prettier`,opencode將自動使用它。 +因此,如果您的項目的`prettier`中有`package.json`,opencode將自動使用它。 --- diff --git a/packages/web/src/content/docs/zh-tw/github.mdx b/packages/web/src/content/docs/zh-tw/github.mdx index 6355f6095..1e65a9f4e 100644 --- a/packages/web/src/content/docs/zh-tw/github.mdx +++ b/packages/web/src/content/docs/zh-tw/github.mdx @@ -37,7 +37,7 @@ opencode github install 2. **添加工作流程** - 將以下工作流程文件添加到存儲庫中的 `.github/workflows/opencode.yml` 中。確保在`env`中設置適當的`model`和所需的API密鑰。 + 將以下工作流程文件添加到存儲庫中的 `.github/workflows/opencode.yml` 中。確保在`model`中設置適當的`env`和所需的API密鑰。 ```yml title=".github/workflows/opencode.yml" {24,26} name: opencode diff --git a/packages/web/src/content/docs/zh-tw/ide.mdx b/packages/web/src/content/docs/zh-tw/ide.mdx index fc8304aa8..79f362a7c 100644 --- a/packages/web/src/content/docs/zh-tw/ide.mdx +++ b/packages/web/src/content/docs/zh-tw/ide.mdx @@ -1,27 +1,27 @@ --- -title: 集成開發環境 -description: VS Code、Cursor 和其他 IDE 的 opencode 擴展 +title: IDE +description: VS Code、Cursor 和其他 IDE 的 Kilo 擴展 --- -opencode 與 VS Code、Cursor 或任何支持terminal的 IDE 集成。只需在 terminal中運行 `opencode` 即可開始。 +Kilo 與 VS Code、Cursor 或任何支持 terminal 的 IDE 集成。只需在 terminal 中運行 `opencode` 即可開始。 --- ## 用法 -- **快速啟動**:使用 `Cmd+Esc` (Mac) 或 `Ctrl+Esc` (Windows/Linux) 在拆分terminal視圖中打開 opencode,或者聚焦現有terminal會話(如果已有terminal會話正在運行)。 -- **新會話**:使用 `Cmd+Shift+Esc` (Mac) 或 `Ctrl+Shift+Esc` (Windows/Linux) 啟動新的 opencode terminal會話,即使該會話已打開。您還可以單擊 UI 中的 opencode 按鈕。 -- **上下文感知**:自動與 opencode 共享您當前的選擇或選項卡。 +- **快速啟動**:使用 `Cmd+Esc` (Mac) 或 `Ctrl+Esc` (Windows/Linux) 在拆分 terminal 視圖中打開 Kilo,或者聚焦現有 terminal 會話(如果已有 terminal 會話正在運行)。 +- **新會話**:使用 `Cmd+Shift+Esc` (Mac) 或 `Ctrl+Shift+Esc` (Windows/Linux) 啟動新的 Kilo terminal 會話,即使該會話已打開。您還可以單擊 UI 中的 Kilo 按鈕。 +- **上下文感知**:自動與 Kilo 共享您當前的選擇或選項卡。 - **文件引用快捷方式**:使用`Cmd+Option+K` (Mac) 或`Alt+Ctrl+K` (Linux/Windows) 插入文件引用。例如,`@File#L37-42`。 --- ## 安裝 -要在 VS Code 和 Cursor、Windsurf、VSCodium 等流行分支上安裝 opencode: +要在 VS Code 和 Cursor、Windsurf、VSCodium 等流行分支上安裝 Kilo: -1. 打開 VS 程式碼 -2. 打開集成terminal +1. 打開 VS Code +2. 打開集成 terminal 3. 運行 `opencode` - 擴展會自動安裝 另一方面,如果您想在從 TUI 運行 `/editor` 或 `/export` 時使用自己的 IDE,則需要設置 `export EDITOR="code --wait"`。 [了解更多](/docs/tui/#editor-setup)。 @@ -30,7 +30,7 @@ opencode 與 VS Code、Cursor 或任何支持terminal的 IDE 集成。只需在 ### 手動安裝 -在擴展市場中搜索 **opencode**,然後單擊 **安裝**。 +在擴展市場中搜索 **Kilo**,然後單擊 **安裝**。 --- @@ -38,11 +38,11 @@ opencode 與 VS Code、Cursor 或任何支持terminal的 IDE 集成。只需在 如果擴展無法自動安裝: -- 確保您在集成terminal中運行`opencode`。 +- 確保您在集成 terminal 中運行`opencode`。 - 確認您的 IDE 的 CLI 已安裝: - - 對於 VS 程式碼:`code` 命令 - - 對於光標:`cursor` 命令 - - 對於風帆衝浪:`windsurf` 命令 + - 對於 VS Code:`code` 命令 + - 對於 Cursor:`cursor` 命令 + - 對於 Windsurf:`windsurf` 命令 - 對於 VSCodium:`codium` 命令 - 如果沒有,請運行 `Cmd+Shift+P` (Mac) 或 `Ctrl+Shift+P` (Windows/Linux) 並蒐索“Shell Command: Install 'code' command in PATH”(或適用於您的 IDE 的等效命令) - 確保 VS Code 有權安裝擴展 diff --git a/packages/web/src/content/docs/zh-tw/index.mdx b/packages/web/src/content/docs/zh-tw/index.mdx index 38b46e8cc..fb069b215 100644 --- a/packages/web/src/content/docs/zh-tw/index.mdx +++ b/packages/web/src/content/docs/zh-tw/index.mdx @@ -7,9 +7,9 @@ import { Tabs, TabItem } from "@astrojs/starlight/components" import config from "../../../../config.mjs" export const console = config.console -[**opencode**](/) 是一個開源AI編碼代理。它可用作基於 terminal 的介面、桌面應用程式或 IDE 擴展。 +[**Kilo**](/) 是一個開源 AI 編碼代理。它可用作基於 terminal 的介面、桌面應用程式或 IDE 擴展。 - + 讓我們開始吧。 @@ -17,9 +17,9 @@ export const console = config.console #### 先決條件 -要在 terminal中使用 opencode,您需要: +要在 terminal 中使用 Kilo,您需要: -1. 現代terminal模擬器,例如: +1. 現代 terminal 模擬器,例如: - [WezTerm](https://wezterm.org),跨平台 - [Alacritty](https://alacritty.org),跨平台 - [Ghostty](https://ghostty.org),Linux 和 macOS @@ -31,7 +31,7 @@ export const console = config.console ## 安裝 -安裝 opencode 最簡單的方法是通過安裝腳本。 +安裝 Kilo 最簡單的方法是通過安裝腳本。 ```bash curl -fsSL https://kilo.ai/install | bash @@ -79,7 +79,7 @@ curl -fsSL https://kilo.ai/install | bash brew install anomalyco/tap/opencode ``` - > 我們建議使用 opencode Tap 來獲取最新版本。官方 `brew install opencode` 公式由 Homebrew 團隊維護,更新頻率較低。 + > 我們建議使用 Kilo tap 來獲取最新版本。官方 `brew install opencode` formula 由 Homebrew 團隊維護,更新頻率較低。 - **在 Arch Linux 上使用 Paru** @@ -90,7 +90,7 @@ curl -fsSL https://kilo.ai/install | bash #### Windows :::tip[Recommended: Use WSL] -為了在 Windows 上獲得最佳體驗,我們建議使用[適用於 Linux 的 Windows 子系統 (WSL)](/docs/windows-wsl)。它提供了更好的性能並與 opencode 的功能完全兼容。 +為了在 Windows 上獲得最佳體驗,我們建議使用[適用於 Linux 的 Windows 子系統 (WSL)](/docs/windows-wsl)。它提供了更好的性能並與 Kilo 的功能完全兼容。 ::: - **使用Chocolatey** @@ -123,7 +123,7 @@ curl -fsSL https://kilo.ai/install | bash docker run -it --rm ghcr.io/Kilo-Org/kilo ``` -目前正在支持使用 Bun 在 Windows 上安裝 opencode。 +目前正在支持使用 Bun 在 Windows 上安裝 Kilo。 您還可以從[Releases](https://github.com/Kilo-Org/kilo/releases) 獲取二進製文件。 @@ -131,10 +131,10 @@ curl -fsSL https://kilo.ai/install | bash ## 配置 -借助 opencode,您可以通過配置 API 密鑰來使用任何 LLM 提供商。 +借助 Kilo,您可以通過配置 API 密鑰來使用任何 LLM 提供商。 如果您不熟悉使用 LLM 提供商,我們建議使用[OpenCode Zen](/docs/zen)。 -這是經過 opencode 測試和驗證的精選模型列表 +這是經過 Kilo 測試和驗證的精選模型列表 團隊。 1. 在 TUI 中運行 `/connect` 命令,選擇 opencode,然後前往 [kilo.ai/auth](https://kilo.ai/auth)。 @@ -167,33 +167,33 @@ curl -fsSL https://kilo.ai/install | bash cd /path/to/project ``` -並運行 opencode。 +並運行 Kilo。 ```bash opencode ``` -接下來,通過運行以下命令來初始化項目的 opencode。 +接下來,通過運行以下命令來初始化項目的 Kilo。 ```bash frame="none" /init ``` -這將使 opencode 分析您的項目並在以下位置創建 `AGENTS.md` 文件 +這將使 Kilo 分析您的項目並在以下位置創建 `AGENTS.md` 文件 項目根。 :::tip 您應該將項目的 `AGENTS.md` 文件提交到 Git。 ::: -這有助於 opencode 理解項目結構和編碼模式 +這有助於 Kilo 理解項目結構和編碼模式 用過的。 --- ## 用法 -您現在已準備好使用 opencode 來處理您的項目。請隨意詢問 +您現在已準備好使用 Kilo 來處理您的項目。請隨意詢問 任何事物! 如果您不熟悉使用 AI 編碼代理,以下是一些可能會有所幫助的示例 @@ -203,7 +203,7 @@ opencode ### 提出問題 -您可以要求 opencode 向您解釋程式碼庫。 +您可以用 Kilo 向您解釋程式碼庫。 :::tip 使用`@`鍵模糊搜索工程中的文件。 @@ -219,11 +219,11 @@ How is authentication handled in @packages/functions/src/api/index.ts ### 添加功能 -您可以要求 opencode 向您的項目添加新功能。不過我們首先建議要求它制定一個計劃。 +您可以用 Kilo 向您的項目添加新功能。不過我們首先建議要求它制定一個計劃。 1. **制定計劃** - opencode 有一個*計劃模式*,該模式禁用其進行更改和 + Kilo 有一個*計劃模式*,該模式禁用其進行更改和 相反,建議*如何*實現該功能。 使用 **Tab** 鍵切換到它。您會在右下角看到一個指示符。 @@ -240,11 +240,11 @@ How is authentication handled in @packages/functions/src/api/index.ts From this screen, the user can undelete a note or permanently delete it. ``` - 您需要為 opencode 提供足夠的詳細信息以了解您想要的內容。它有幫助 + 您需要為 Kilo 提供足夠的詳細信息以了解您想要的內容。它有幫助 就像與團隊中的初級開發人員交談一樣與它交談。 :::tip - 為 opencode 提供大量上下文和示例,以幫助其理解您的內容 + 為 Kilo 提供大量上下文和示例,以幫助其理解您的內容 想。 ::: @@ -258,11 +258,11 @@ How is authentication handled in @packages/functions/src/api/index.ts ``` :::tip - 將圖像拖放到terminal中以將其添加到提示中。 + 將圖像拖放到 terminal 中以將其添加到提示中。 ::: - opencode 可以掃描您提供的任何圖像並將其添加到提示中。你可以 - 通過將圖像拖放到terminal中來完成此操作。 + Kilo 可以掃描您提供的任何圖像並將其添加到提示中。你可以 + 通過將圖像拖放到 terminal 中來完成此操作。 3. **構建功能** @@ -283,7 +283,7 @@ How is authentication handled in @packages/functions/src/api/index.ts ### 做出改變 -對於更直接的更改,您可以要求 opencode 直接構建它 +對於更直接的更改,您可以要求 Kilo 直接構建它 無需先審查計劃。 ```txt frame="none" "@packages/functions/src/settings.ts" "@packages/functions/src/notes.ts" @@ -292,14 +292,14 @@ handled in the /notes route in @packages/functions/src/notes.ts and implement the same logic in @packages/functions/src/settings.ts ``` -您需要確保提供大量詳細信息,以便 opencode 做出正確的決定 +您需要確保提供大量詳細信息,以便 Kilo 做出正確的決定 變化。 --- ### 撤消更改 -假設您要求 opencode 進行一些更改。 +假設您要求 Kilo 進行一些更改。 ```txt frame="none" "@packages/functions/src/api/index.ts" Can you refactor the function in @packages/functions/src/api/index.ts? @@ -312,14 +312,14 @@ Can you refactor the function in @packages/functions/src/api/index.ts? /undo ``` -opencode 現在將恢復您所做的更改並顯示您的原始消息 +Kilo 現在將恢復您所做的更改並顯示您的原始消息 再次。 ```txt frame="none" "@packages/functions/src/api/index.ts" Can you refactor the function in @packages/functions/src/api/index.ts? ``` -從這裡您可以調整提示並要求 opencode 重試。 +從這裡您可以調整提示並要求 Kilo 重試。 :::tip 您可以多次運行 `/undo` 以撤消多項更改。 @@ -335,7 +335,7 @@ Can you refactor the function in @packages/functions/src/api/index.ts? ## 分享 -您與 opencode 的對話可以[與您的 +您與 Kilo 的對話可以[與您的 團隊](/docs/share)。 ```bash frame="none" @@ -348,12 +348,12 @@ Can you refactor the function in @packages/functions/src/api/index.ts? 默認情況下不共享對話。 ::: -這是帶有 opencode 的[示例對話](https://kilo.ai/s/4XP1fce5)。 +這是帶有 Kilo 的[示例對話](https://kilo.ai/s/4XP1fce5)。 --- ## 定制 -就是這樣!您現在已經是使用 opencode 的專家了。 +就是這樣!您現在已經是使用 Kilo 的專家了。 -要使其成為您自己的,我們建議 [選擇一個主題](/docs/themes)、[自定義按鍵綁定](/docs/keybinds)、[配置程式碼格式化程序](/docs/formatters)、[創建自定義命令](/docs/commands) 或使用 [opencode配置](/docs/config)。 +要使其成為您自己的,我們建議 [選擇一個主題](/docs/themes)、[自定義按鍵綁定](/docs/keybinds)、[配置程式碼格式化程序](/docs/formatters)、[創建自定義命令](/docs/commands) 或使用 [Kilo 配置](/docs/config)。 diff --git a/packages/web/src/content/docs/zh-tw/lsp.mdx b/packages/web/src/content/docs/zh-tw/lsp.mdx index 6fc73779e..2dc32ad15 100644 --- a/packages/web/src/content/docs/zh-tw/lsp.mdx +++ b/packages/web/src/content/docs/zh-tw/lsp.mdx @@ -182,7 +182,7 @@ opencode 附帶了多種適用於流行語言的內置 LSP 服務器: PHP Intelephense 通過許可證密鑰提供高級功能。您可以通過將(僅)密鑰放入位於以下位置的文本文件中來提供許可證密鑰: -- 在 macOS/Linux 上:`$HOME/intelephense/licence.txt` -- 在 Windows 上:`%USERPROFILE%/intelephense/licence.txt` +- 在 macOS/Linux 上:`$HOME/intelephense/license.txt` +- 在 Windows 上:`%USERPROFILE%/intelephense/license.txt` 該文件應僅包含許可證密鑰,不包含其他內容。 diff --git a/packages/web/src/content/docs/zh-tw/models.mdx b/packages/web/src/content/docs/zh-tw/models.mdx index 30749547b..3539bd48e 100644 --- a/packages/web/src/content/docs/zh-tw/models.mdx +++ b/packages/web/src/content/docs/zh-tw/models.mdx @@ -3,13 +3,13 @@ title: 型號 description: 配置LLM提供者和模型。 --- -opencode 使用[AI SDK](https://ai-sdk.dev/) 和[models.dev](https://models.dev) 來支持**75+ LLM 提供商**,並且它支持運行本地模型。 +Kilo 使用[AI SDK](https://ai-sdk.dev/) 和[Models.dev](https://models.dev) 來支持**75+ LLM 提供商**,並且它支持運行本地模型。 --- ## 供應商 -默認情況下會預加載大多數流行的提供商。如果您已通過 `/connect` 命令添加了提供商的憑據,那麼它們將在您啟動 opencode 時可用。 +默認情況下會預加載大多數流行的提供商。如果您已通過 `/connect` 命令添加了提供商的憑據,那麼它們將在您啟動 Kilo 時可用。 了解有關[提供者](/docs/providers) 的更多信息。 @@ -35,21 +35,21 @@ opencode 使用[AI SDK](https://ai-sdk.dev/) 和[models.dev](https://models.dev) 然而,既擅長生成程式碼又擅長工具調用的只有少數。 -以下是與 opencode 配合良好的幾個模型,排名不分先後。 (這不是詳盡的列表,也不一定是最新的): +以下是與 Kilo 配合良好的幾個模型,排名不分先後。 (這不是詳盡的列表,也不一定是最新的): - GPT 5.2 -- GPT 5.1 法典 -- 近距離工作4.5 -- 克勞德十四行詩 4.5 -- 極小極大M2.1 -- 雙子座 3 專業版 +- GPT 5.1 Codex +- Claude Opus 4.5 +- Claude Sonnet 4.5 +- Minimax M2.1 +- Gemini 3 Pro --- ## 設置默認值 要將其中之一設置為默認模型,您可以在您的 -opencode配置。 +Kilo 配置。 ```json title="opencode.json" {3} { @@ -101,7 +101,7 @@ opencode配置。 ``` 在這裡,我們為兩個內置模型配置全局設置:`gpt-5`(通過 `openai` 提供商訪問時)和 `claude-sonnet-4-20250514`(通過 `anthropic` 提供商訪問時)。 -內置提供商和型號名稱可以在[models.dev](https://models.dev) 上找到。 +內置提供商和型號名稱可以在[Models.dev](https://models.dev) 上找到。 您還可以為您正在使用的任何代理配置這些選項。代理配置會覆蓋此處的所有全局選項。 [了解更多](/docs/agents/#additional)。 @@ -137,11 +137,11 @@ opencode配置。 ## 變體 -許多型號支持具有不同配置的多種變體。 opencode 附帶了流行提供商的內置默認變體。 +許多型號支持具有不同配置的多種變體。Kilo 附帶了流行提供商的內置默認變體。 ### 內置變體 -opencode 附帶了許多提供商的默認變體: +Kilo 附帶了許多提供商的默認變體: **Anthropic**: @@ -203,11 +203,11 @@ opencode 附帶了許多提供商的默認變體: ## 加載模型 -當 opencode 啟動時,它會按以下優先順序檢查模型: +當 Kilo 啟動時,它會按以下優先順序檢查模型: 1. `--model` 或 `-m` 命令行標誌。格式與配置文件中的相同:`provider_id/model_id`。 -2. opencode 配置中的模型列表。 +2. Kilo 配置中的模型列表。 ```json title="opencode.json" { diff --git a/packages/web/src/content/docs/zh-tw/providers.mdx b/packages/web/src/content/docs/zh-tw/providers.mdx index a50e62199..f42ebd34f 100644 --- a/packages/web/src/content/docs/zh-tw/providers.mdx +++ b/packages/web/src/content/docs/zh-tw/providers.mdx @@ -1,31 +1,30 @@ --- -title: 供應商 -description: 使用 opencode 中的任何 LLM 提供商。 +title: 提供商 +description: 使用 Kilo 中的任何 LLM 提供商。 --- import config from "../../../../config.mjs" export const console = config.console -opencode 使用[AI SDK](https://ai-sdk.dev/) 和[models.dev](https://models.dev) 來支持**75+ LLM 提供商**,並且它支持運行本地模型。 +Kilo 使用 [AI SDK](https://ai-sdk.dev/) 和 [Models.dev](https://models.dev) 來支持 **75+ LLM 提供商**,並且它支持運行本地模型。 要添加提供商,您需要: 1. 使用 `/connect` 命令添加提供商的 API 密鑰。 -2. 在 opencode 配置中配置提供商。 +2. 在 Kilo 配置中配置提供商。 --- -### 證書 +### 憑證 當您使用 `/connect` 命令添加提供商的 API 密鑰時,它們會被存儲 -在`~/.local/share/opencode/auth.json`。 +在 `~/.local/share/opencode/auth.json`。 --- ### 配置 -您可以通過 opencode 中的 `provider` 部分自定義提供商 -配置。 +您可以在 Kilo 配置的 `provider` 部分自定義提供商。 --- @@ -50,8 +49,8 @@ opencode 使用[AI SDK](https://ai-sdk.dev/) 和[models.dev](https://models.dev) ## OpenCode Zen -OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 -經過測試和驗證,可以與 opencode 良好配合。 [了解更多](/docs/zen)。 +OpenCode Zen 是 Kilo 團隊提供的模型列表,這些模型已被 +經過測試和驗證,可以與 Kilo 良好配合。 [了解更多](/docs/zen)。 :::tip 如果您是新手,我們建議您從 OpenCode Zen 開始。 @@ -63,7 +62,7 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 /connect ``` -2. 登錄,添加您的帳單詳細信息,然後復制您的 API 密鑰。 +2. 登錄,添加您的帳單詳細信息,然後複製您的 API 密鑰。 3. 粘貼您的 API 密鑰。 @@ -74,13 +73,13 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 └ enter ``` -4. 在 TUI 中運行 `/models` 以查看我們推薦的型號列表。 +4. 在 TUI 中運行 `/models` 以查看我們推薦的模型列表。 ```txt /models ``` -它的工作方式與 opencode 中的任何其他提供商一樣,並且完全可以選擇使用。 +它的工作方式與 Kilo 中的任何其他提供商一樣,並且完全可以選擇使用。 --- @@ -95,11 +94,11 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 --- -### 302.艾伊 +### 302.AI -1. 前往[302.AI控制台](https://302.ai/),創建一個帳戶並生成一個 API 密鑰。 +1. 前往 [302.AI 控制台](https://302.ai/),創建一個帳戶並生成一個 API 密鑰。 -2. 運行`/connect`命令並蒐索**302.AI**。 +2. 運行 `/connect` 命令並搜尋 **302.AI**。 ```txt /connect @@ -114,7 +113,7 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 └ enter ``` -4. 執行`/models`命令選擇型號。 +4. 執行 `/models` 命令選擇模型。 ```txt /models @@ -122,11 +121,11 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 --- -### 亞馬遜基岩 +### Amazon Bedrock -要將 Amazon Bedrock 與 opencode 結合使用: +要將 Amazon Bedrock 與 Kilo 結合使用: -1. 前往 Amazon Bedrock 控制台中的 **模型目錄** 並請求 +1. 前往 Amazon Bedrock 控制台中的 **Model catalog** 並請求 訪問您想要的模型。 :::tip @@ -176,9 +175,9 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 ``` **可用選項:** - - `region` - AWS 區域(例如`us-east-1`、`eu-west-1`) + - `region` - AWS 區域(例如 `us-east-1`、`eu-west-1`) - `profile` - 來自 `~/.aws/credentials` 的 AWS 命名配置文件 - - `endpoint` - VPC terminal節點的自定義terminal節點 URL(通用 `baseURL` 選項的別名) + - `endpoint` - 用於 VPC 端點的自定義端點 URL(通用 `baseURL` 選項的別名) :::tip 配置文件選項優先於環境變量。 @@ -186,7 +185,7 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 #### 高級:VPC 端點 - 如果您使用 Bedrock 的 VPC terminal節點: + 如果您使用 Bedrock 的 VPC 端點: ```json title="opencode.json" { @@ -204,33 +203,33 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 ``` :::note - `endpoint` 選項是通用 `baseURL` 選項的別名,使用 AWS 特定術語。如果同時指定`endpoint` 和`baseURL`,則`endpoint` 優先。 + `endpoint` 選項是通用 `baseURL` 選項的別名,使用 AWS 特定術語。如果同時指定 `endpoint` 和 `baseURL`,則 `endpoint` 優先。 ::: #### 認證方式 - - **`AWS_ACCESS_KEY_ID` / `AWS_SECRET_ACCESS_KEY`**:創建 IAM 用戶並在 AWS 控制台中生成訪問密鑰 - - **`AWS_PROFILE`**:使用`~/.aws/credentials` 中的命名配置文件。首先配置`aws configure --profile my-profile`或`aws sso login` + - **`AWS_ACCESS_KEY_ID` / `AWS_SECRET_ACCESS_KEY`**:創建 IAM 用戶並在 AWS Console 中生成訪問密鑰 + - **`AWS_PROFILE`**:使用 `~/.aws/credentials` 中的命名配置文件。首先配置 `aws configure --profile my-profile` 或 `aws sso login` - **`AWS_BEARER_TOKEN_BEDROCK`**:從 Amazon Bedrock 控制台生成長期 API 密鑰 - - **`AWS_WEB_IDENTITY_TOKEN_FILE` / `AWS_ROLE_ARN`**:適用於 EKS IRSA(服務賬戶的 IAM 角色)或具有 OIDC 聯合的其他 Kubernetes 環境。使用服務帳戶註釋時,這些環境變量由 Kubernetes 自動注入。 + - **`AWS_WEB_IDENTITY_TOKEN_FILE` / `AWS_ROLE_ARN`**:適用於 EKS IRSA(服務帳戶的 IAM 角色)或具有 OIDC 聯合的其他 Kubernetes 環境。使用服務帳戶註釋時,這些環境變量由 Kubernetes 自動注入。 #### 認證優先級 Amazon Bedrock 使用以下身份驗證優先級: - 1. **不記名令牌** - `AWS_BEARER_TOKEN_BEDROCK` 環境變量或來自 `/connect` 命令的令牌 - 2. **AWS 憑證鏈** - 配置文件、訪問密鑰、共享憑證、IAM 角色、Web 身份令牌 (EKS IRSA)、實例元數據 + 1. **Bearer Token** - `AWS_BEARER_TOKEN_BEDROCK` 環境變量或來自 `/connect` 命令的令牌 + 2. **AWS Credential Chain** - 配置文件、訪問密鑰、共享憑證、IAM 角色、Web 身份令牌 (EKS IRSA)、實例元數據 :::note - 設置不記名令牌(通過 `/connect` 或 `AWS_BEARER_TOKEN_BEDROCK`)時,它優先於所有 AWS 憑證方法(包括配置的配置文件)。 + 當設置 Bearer Token 時(通過 `/connect` 或 `AWS_BEARER_TOKEN_BEDROCK`),它優先於所有 AWS 憑證方法(包括配置的配置文件)。 ::: -3. 運行`/models`命令選擇所需的型號。 +3. 運行 `/models` 命令選擇所需的模型。 ```txt /models ``` :::note -對於自定義推理配置文件,請在密鑰中使用模型和提供商名稱,並將 `id` 屬性設置為 arn。這確保了正確的緩存: +對於自定義推理配置文件,請在鍵中使用模型和提供商名稱,並將 `id` 屬性設置為 arn。這確保了正確的緩存: ```json title="opencode.json" { @@ -279,34 +278,34 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 ``` :::info -[Anthropic](https://anthropic.com) 不正式支持在 opencode 中使用您的 Claude Pro/Max 訂閱。 +[Anthropic](https://anthropic.com) 不正式支持在 Kilo 中使用您的 Claude Pro/Max 訂閱。 ::: ##### 使用 API 密鑰 -如果您沒有 Pro/Max 訂閱,您還可以選擇 **創建 API 密鑰**。它還會打開您的瀏覽器並要求您登錄 Anthropic 並為您提供一個可以粘貼到terminal 中的程式碼。 +如果您沒有 Pro/Max 訂閱,您還可以選擇 **Create an API Key**。它還會打開您的瀏覽器並要求您登錄 Anthropic 並為您提供一個可以粘貼到終端機中的代碼。 -或者,如果您已有 API 密鑰,則可以選擇 **手動輸入 API 密鑰** 並將其粘貼到您的terminal中。 +或者,如果您已有 API 密鑰,則可以選擇 **Manually enter API Key** 並將其粘貼到您的終端機中。 --- -### Azure 開放AI +### Azure OpenAI :::note -如果遇到“抱歉,但我無法協助該請求”錯誤,請嘗試將 Azure 資源中的內容篩選器從 **DefaultV2** 更改為 **Default**。 +如果遇到 "I'm sorry, but I cannot assist with that request" 錯誤,請嘗試將 Azure 資源中的內容篩選器從 **DefaultV2** 更改為 **Default**。 ::: -1. 轉到 [Azure 門戶](https://portal.azure.com/) 並創建 **Azure OpenAI** 資源。你需要: - - **資源名稱**:這將成為您的 API 端點 (`https://RESOURCE_NAME.openai.azure.com/`) 的一部分 - - **API 密鑰**:來自您的資源的 `KEY 1` 或 `KEY 2` +1. 轉到 [Azure portal](https://portal.azure.com/) 並創建 **Azure OpenAI** 資源。您需要: + - **Resource name**:這將成為您的 API 端點 (`https://RESOURCE_NAME.openai.azure.com/`) 的一部分 + - **API key**:來自您的資源的 `KEY 1` 或 `KEY 2` -2. 轉到[Azure AI Foundry](https://ai.azure.com/) 並部署模型。 +2. 轉到 [Azure AI Foundry](https://ai.azure.com/) 並部署模型。 :::note - 部署名稱必須與模型名稱匹配,opencode 才能正常工作。 + 部署名稱必須與模型名稱匹配,Kilo 才能正常工作。 ::: -3. 運行 `/connect` 命令並蒐索 **Azure**。 +3. 運行 `/connect` 命令並搜尋 **Azure**。 ```txt /connect @@ -341,19 +340,19 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 --- -### Azure 認知服務 +### Azure Cognitive Services -1. 轉到 [Azure 門戶](https://portal.azure.com/) 並創建 **Azure OpenAI** 資源。你需要: - - **資源名稱**:這將成為您的 API 端點 (`https://AZURE_COGNITIVE_SERVICES_RESOURCE_NAME.cognitiveservices.azure.com/`) 的一部分 - - **API 密鑰**:來自您的資源的 `KEY 1` 或 `KEY 2` +1. 轉到 [Azure portal](https://portal.azure.com/) 並創建 **Azure OpenAI** 資源。您需要: + - **Resource name**:這將成為您的 API 端點 (`https://AZURE_COGNITIVE_SERVICES_RESOURCE_NAME.cognitiveservices.azure.com/`) 的一部分 + - **API key**:來自您的資源的 `KEY 1` 或 `KEY 2` -2. 轉到[Azure AI Foundry](https://ai.azure.com/) 並部署模型。 +2. 轉到 [Azure AI Foundry](https://ai.azure.com/) 並部署模型。 :::note - 部署名稱必須與模型名稱匹配,opencode 才能正常工作。 + 部署名稱必須與模型名稱匹配,Kilo 才能正常工作。 ::: -3. 運行 `/connect` 命令並蒐索 **Azure 認知服務**。 +3. 運行 `/connect` 命令並搜尋 **Azure Cognitive Services**。 ```txt /connect @@ -390,9 +389,9 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 ### Baseten -1. 前往[Baseten](https://app.baseten.co/),創建一個帳戶並生成一個 API 密鑰。 +1. 前往 [Baseten](https://app.baseten.co/),創建一個帳戶並生成一個 API 密鑰。 -2. 運行`/connect`命令並蒐索**Baseten**。 +2. 運行 `/connect` 命令並搜尋 **Baseten**。 ```txt /connect @@ -407,7 +406,7 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 └ enter ``` -4. 執行`/models`命令選擇型號。 +4. 執行 `/models` 命令選擇模型。 ```txt /models @@ -415,11 +414,11 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 --- -### 大腦 +### Cerebras -1. 前往[Cerebras Console](https://inference.cerebras.ai/),創建一個帳戶並生成一個 API 密鑰。 +1. 前往 [Cerebras console](https://inference.cerebras.ai/),創建一個帳戶並生成一個 API 密鑰。 -2. 運行 `/connect` 命令並蒐索 **Cerebras**。 +2. 運行 `/connect` 命令並搜尋 **Cerebras**。 ```txt /connect @@ -434,7 +433,7 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 └ enter ``` -4. 運行`/models`命令選擇型號,如*Qwen 3 Coder 480B*。 +4. 運行 `/models` 命令選擇模型,如 _Qwen 3 Coder 480B_。 ```txt /models @@ -442,20 +441,20 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 --- -### Cloudflare AI 網關 +### Cloudflare AI Gateway -Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthropic、Workers AI 等的模型。使用[統一計費](https://developers.cloudflare.com/ai-gateway/features/unified-billing/),您不需要為每個提供商提供單獨的 API 密鑰。 +Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthropic、Workers AI 等的模型。使用 [Unified Billing](https://developers.cloudflare.com/ai-gateway/features/unified-billing/),您不需要為每個提供商提供單獨的 API 密鑰。 -1. 前往[Cloudflare 儀表板](https://dash.cloudflare.com/),導航至 **AI** > **AI Gateway**,然後創建一個新網關。 +1. 前往 [Cloudflare dashboard](https://dash.cloudflare.com/),導航至 **AI** > **AI Gateway**,然後創建一個新網關。 -2. 將您的帳戶 ID 和網關 ID 設置為環境變量。 +2. 將您的 Account ID 和 Gateway ID 設置為環境變量。 ```bash title="~/.bash_profile" export CLOUDFLARE_ACCOUNT_ID=your-32-character-account-id export CLOUDFLARE_GATEWAY_ID=your-gateway-id ``` -3. 運行 `/connect` 命令並蒐索 **Cloudflare AI Gateway**。 +3. 運行 `/connect` 命令並搜尋 **Cloudflare AI Gateway**。 ```txt /connect @@ -476,13 +475,13 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro export CLOUDFLARE_API_TOKEN=your-api-token ``` -5. 執行`/models`命令選擇型號。 +5. 執行 `/models` 命令選擇模型。 ```txt /models ``` - 您還可以通過 opencode 配置添加模型。 + 您還可以通過 Kilo 配置添加模型。 ```json title="opencode.json" { @@ -500,11 +499,11 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro --- -### 皮質 +### Cortecs -1. 前往[Cortecs 控制台](https://cortecs.ai/),創建一個帳戶並生成一個 API 密鑰。 +1. 前往 [Cortecs console](https://cortecs.ai/),創建一個帳戶並生成一個 API 密鑰。 -2. 運行 `/connect` 命令並蒐索 **Cortecs**。 +2. 運行 `/connect` 命令並搜尋 **Cortecs**。 ```txt /connect @@ -519,7 +518,7 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro └ enter ``` -4. 運行`/models`命令選擇一個模型,如*Kimi K2 Instruct*。 +4. 運行 `/models` 命令選擇一個模型,如 _Kimi K2 Instruct_。 ```txt /models @@ -527,11 +526,11 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro --- -### 深度搜索 +### DeepSeek -1. 前往[DeepSeek 控制台](https://platform.deepseek.com/),創建一個帳戶,然後單擊“**創建新的 API 密鑰**”。 +1. 前往 [DeepSeek console](https://platform.deepseek.com/),創建一個帳戶,然後單擊 **Create new API key**。 -2. 運行`/connect`命令並蒐索**DeepSeek**。 +2. 運行 `/connect` 命令並搜尋 **DeepSeek**。 ```txt /connect @@ -554,11 +553,11 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro --- -### 深層基礎設施 +### Deep Infra -1. 前往[DeepInfra dashboard](https://deepinfra.com/dash),創建一個帳戶並生成一個 API 密鑰。 +1. 前往 [Deep Infra dashboard](https://deepinfra.com/dash),創建一個帳戶並生成一個 API 密鑰。 -2. 運行 `/connect` 命令並蒐索 **Deep Infra**。 +2. 運行 `/connect` 命令並搜尋 **Deep Infra**。 ```txt /connect @@ -573,7 +572,7 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro └ enter ``` -4. 執行`/models`命令選擇型號。 +4. 執行 `/models` 命令選擇模型。 ```txt /models @@ -581,17 +580,17 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro --- -### 韌體 +### Firmware -1. 前往[Firmware dashboard](https://app.firmware.ai/signup),創建一個帳戶並生成一個 API 密鑰。 +1. 前往 [Firmware dashboard](https://app.firmware.ai/signup),創建一個帳戶並生成一個 API 密鑰。 -2. 運行`/connect`命令並蒐索**固件**。 +2. 運行 `/connect` 命令並搜尋 **Firmware**。 ```txt /connect ``` -3. 輸入您的固件 API 密鑰。 +3. 輸入您的 Firmware API 密鑰。 ```txt ┌ API key @@ -600,7 +599,7 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro └ enter ``` -4. 執行`/models`命令選擇型號。 +4. 執行 `/models` 命令選擇模型。 ```txt /models @@ -608,11 +607,11 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro --- -### 煙花AI +### Fireworks AI -1. 前往[Fireworks AI 控制台](https://app.fireworks.ai/),創建一個帳戶,然後單擊“**創建 API 密鑰**”。 +1. 前往 [Fireworks AI console](https://app.fireworks.ai/),創建一個帳戶,然後單擊 **Create API Key**。 -2. 運行 `/connect` 命令並蒐索 **Fireworks AI**。 +2. 運行 `/connect` 命令並搜尋 **Fireworks AI**。 ```txt /connect @@ -627,7 +626,7 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro └ enter ``` -4. 運行`/models`命令選擇一個模型,如*Kimi K2 Instruct*。 +4. 運行 `/models` 命令選擇一個模型,如 _Kimi K2 Instruct_。 ```txt /models @@ -635,7 +634,7 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro --- -### 亞搏體育app二人組 +### GitLab Duo GitLab Duo 通過 GitLab 的 Anthropic 代理提供具有本機工具調用功能的 AI 驅動的代理聊天。 @@ -657,14 +656,14 @@ GitLab Duo 通過 GitLab 的 Anthropic 代理提供具有本機工具調用功 #### 使用 OAuth(推薦) - 選擇**OAuth**,您的瀏覽器將打開以進行授權。 + 選擇 **OAuth**,您的瀏覽器將打開以進行授權。 - #### 使用個人訪問令牌 - 1. 前往[GitLab 用戶設置 > 訪問令牌](https://gitlab.com/-/user_settings/personal_access_tokens) - 2. 單擊**添加新令牌** - 3. 名稱:`Kilo`,範圍:`api` - 4. 複製令牌(以`glpat-`開頭) - 5. 在 terminal中輸入 + #### 使用 Personal Access Token + 1. 前往 [GitLab User Settings > Access Tokens](https://gitlab.com/-/user_settings/personal_access_tokens) + 2. 單擊 **Add new token** + 3. Name:`Kilo`,Scopes:`api` + 4. 複製令牌(以 `glpat-` 開頭) + 5. 在終端機中輸入它 3. 運行 `/models` 命令以查看可用模型。 @@ -673,21 +672,20 @@ GitLab Duo 通過 GitLab 的 Anthropic 代理提供具有本機工具調用功 ``` 提供三種基於 Claude 的模型: - - **duo-chat-haiku-4-5**(默認)- 快速任務的快速響應 + - **duo-chat-haiku-4-5**(Default)- 快速任務的快速響應 - **duo-chat-sonnet-4-5** - 大多數工作流程的平衡性能 - **duo-chat-opus-4-5** - 最有能力進行複雜分析 :::note -如果您不想,也可以指定“GITLAB_TOKEN”環境變量 -將令牌存儲在 kilo auth 存儲中。 +如果您不想將令牌存儲在 Kilo auth 存儲中,也可以指定 `GITLAB_TOKEN` 環境變量。 ::: -##### 自託管 GitLab +##### Self-Hosted GitLab -:::note[compliance 筆記] -opencode 使用小型模型來執行某些 AI 任務,例如生成會話標題。 -默認情況下,它配置為使用 gpt-5-nano,由 Zen 託管。鎖定 opencode -要僅使用您自己的 GitLab 託管實例,請將以下內容添加到您的 +:::note[compliance note] +Kilo 使用小型模型來執行某些 AI 任務,例如生成會話標題。 +默認情況下,它配置為使用 gpt-5-nano,由 Zen 託管。若要鎖定 Kilo +僅使用您自己的 GitLab 託管實例,請將以下內容添加到您的 `opencode.json` 文件。還建議禁用會話共享。 ```json @@ -724,19 +722,19 @@ export GITLAB_TOKEN=glpat-... :::note 您的 GitLab 管理員必須啟用以下功能: -1. [雙代理平台](https://docs.gitlab.com/user/gitlab_duo/turn_on_off/) 用於用戶、組或實例 -2. 功能標誌(通過 Rails 控制台): +1. [Duo Agent Platform](https://docs.gitlab.com/user/gitlab_duo/turn_on_off/) 用於用戶、組或實例 +2. Feature flags(通過 Rails console): - `agent_platform_claude_code` - `third_party_agents_enabled` ::: -##### 適用於自託管實例的 OAuth +##### OAuth for Self-Hosted instances -為了使 Oauth 適用於您的自託管實例,您需要創建 -一個新的應用程式(設置→應用程式) +為了使 OAuth 適用於您的自託管實例,您需要創建 +一個新的應用程式(Settings → Applications),使用 回調 URL `http://127.0.0.1:8080/callback` 和以下範圍: -- api(代表您訪問API) +- api(代表您訪問 API) - read_user(讀取您的個人信息) - read_repository(允許對存儲庫進行只讀訪問) @@ -748,9 +746,9 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here 更多文檔請參見 [opencode-gitlab-auth](https://www.npmjs.com/package/@gitlab/opencode-gitlab-auth) 主頁。 -##### 配置 +##### Configuration -通過`opencode.json`定制: +通過 `opencode.json` 定制: ```json title="opencode.json" { @@ -769,9 +767,9 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here } ``` -##### GitLab API 工具(可選,但強烈推薦) +##### GitLab API Tools(可選,但強烈推薦) -要訪問 GitLab 工具(合併請求、問題、管道、CI/CD 等): +要訪問 GitLab 工具(merge requests、issues、pipelines、CI/CD 等): ```json title="opencode.json" { @@ -784,24 +782,22 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here --- -### GitHub 副駕駛 +### GitHub Copilot -要將 GitHub Copilot 訂閱與 opencode 結合使用: +要將 GitHub Copilot 訂閱與 Kilo 結合使用: :::note -某些型號可能需要 [Pro+ -訂閱](https://github.com/features/copilot/plans) 來使用。 - -某些模型需要在您的[GitHub Copilot 設置](https://docs.github.com/en/copilot/how-tos/use-ai-models/configure-access-to-ai-models#setup-for-individual-use) 中手動啟用。 +某些模型可能需要 [Pro+ +subscription](https://github.com/features/copilot/plans) 來使用。 ::: -1. 運行 `/connect` 命令並蒐索 GitHub Copilot。 +1. 運行 `/connect` 命令並搜尋 GitHub Copilot。 ```txt /connect ``` -2. 導航至[github.com/login/device](https://github.com/login/device) 並輸入程式碼。 +2. 導航至 [github.com/login/device](https://github.com/login/device) 並輸入代碼。 ```txt ┌ Login with GitHub Copilot @@ -813,7 +809,7 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here └ Waiting for authorization... ``` -3. 現在運行`/models`命令來選擇您想要的型號。 +3. 現在運行 `/models` 命令來選擇您想要的模型。 ```txt /models @@ -821,12 +817,12 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here --- -### 谷歌頂點AI +### Google Vertex AI -要將 Google Vertex AI 與 opencode 結合使用: +要將 Google Vertex AI 與 Kilo 結合使用: 1. 前往 Google Cloud Console 中的 **Model Garden** 並檢查 - 您所在地區提供的型號。 + 您所在地區提供的模型。 :::note 您需要有一個啟用了 Vertex AI API 的 Google Cloud 項目。 @@ -834,9 +830,9 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here 2. 設置所需的環境變量: - `GOOGLE_CLOUD_PROJECT`:您的 Google Cloud 項目 ID - - `VERTEX_LOCATION`(可選):Vertex AI 的區域(默認為`global`) + - `VERTEX_LOCATION`(可選):Vertex AI 的區域(默認為 `global`) - 身份驗證(選擇一項): - - `GOOGLE_APPLICATION_CREDENTIALS`: Path to your service account JSON key file + - `GOOGLE_APPLICATION_CREDENTIALS`:Path to your service account JSON key file - Authenticate using gcloud CLI: `gcloud auth application-default login` 在運行 opencode 時設置它們。 @@ -854,10 +850,10 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here ``` :::tip -`global` 區域無需額外成本即可提高可用性並減少錯誤。使用區域端點(例如`us-central1`)來滿足數據駐留要求。 [了解更多](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/use-partner-models#regional_and_global_endpoints) +`global` 區域無需額外成本即可提高可用性並減少錯誤。使用區域端點(例如 `us-central1`)來滿足數據駐留要求。 [了解更多](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/use-partner-models#regional_and_global_endpoints) ::: -3. 運行`/models`命令選擇所需的型號。 +3. 運行 `/models` 命令選擇所需的模型。 ```txt /models @@ -865,11 +861,11 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here --- -### 格羅克 +### Groq -1. 前往[Groq Console](https://console.groq.com/),單擊“**創建 API 密鑰**”,然後復制密鑰。 +1. 前往 [Groq console](https://console.groq.com/),單擊 **Create API Key**,然後複製密鑰。 -2. 運行`/connect`命令並蒐索Groq。 +2. 運行 `/connect` 命令並搜尋 Groq。 ```txt /connect @@ -884,7 +880,7 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here └ enter ``` -4. 運行`/models`命令選擇您想要的。 +4. 運行 `/models` 命令選擇您想要的。 ```txt /models @@ -892,19 +888,19 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here --- -### 抱臉 +### Hugging Face -[Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try again later.That’s all we know.](https://huggingface.co/docs/inference-providers) 提供對超過 17 個提供商支持的開放模型的訪問。 +[Hugging Face Inference Providers](https://huggingface.co/docs/inference-providers) 提供對超過 17 個提供商支持的開放模型的訪問。 -1. 前往[Hugging Face settings](https://huggingface.co/settings/tokens/new?ownUserPermissions=inference.serverless.write&tokenType=fineGrained) 創建一個具有調用推理提供商權限的令牌。 +1. 前往 [Hugging Face settings](https://huggingface.co/settings/tokens/new?ownUserPermissions=inference.serverless.write&tokenType=fineGrained) 創建一個具有調用 Inference Providers 權限的令牌。 -2. 運行 `/connect` 命令並蒐索 **Hugging Face**。 +2. 運行 `/connect` 命令並搜尋 **Hugging Face**。 ```txt /connect ``` -3. 輸入您的擁抱臉標記。 +3. 輸入您的 Hugging Face 令牌。 ```txt ┌ API key @@ -923,11 +919,11 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here ### Helicone -[Helicone](https://helicone.ai) 是一個 LLM 可觀察性平台,可為您的 AI 應用程式提供日誌記錄、監控和分析。 Helicone AI Gateway 根據模型自動將您的請求路由到適當的提供商。 +[Helicone](https://helicone.ai) 是一個 LLM 可觀察性平台,可為您的 AI 應用程式提供日誌記錄、監控和分析。 The Helicone AI Gateway 根據模型自動將您的請求路由到適當的提供商。 -1. 前往[Helicone](https://helicone.ai),創建一個帳戶,並從您的儀表板生成 API 密鑰。 +1. 前往 [Helicone](https://helicone.ai),創建一個帳戶,並從您的儀表板生成 API 密鑰。 -2. 運行 `/connect` 命令並蒐索 **Helicone**。 +2. 運行 `/connect` 命令並搜尋 **Helicone**。 ```txt /connect @@ -942,19 +938,19 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here └ enter ``` -4. 執行`/models`命令選擇型號。 +4. 執行 `/models` 命令選擇模型。 ```txt /models ``` -有關更多提供商和高級功能(例如緩存和速率限制),請查看[Helicone docs](https://docs.helicone.ai)。 +有關更多提供商和高級功能(例如緩存和速率限制),請查看 [Helicone documentation](https://docs.helicone.ai)。 -#### 可選配置 +#### Optional Configs -如果您發現 Helicone 的功能或模型未通過opencode自動配置,您始終可以自行配置。 +如果您發現 Helicone 的功能或模型未通過 Kilo 自動配置,您始終可以自行配置。 -這是[Helicone 的模型目錄](https://helicone.ai/models),您將需要它來獲取要添加的模型的 ID。 +這是 [Helicone's Model Directory](https://helicone.ai/models),您將需要它來獲取要添加的模型的 ID。 ```jsonc title="~/.config/opencode/opencode.jsonc" { @@ -980,7 +976,7 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here } ``` -#### 自定義標頭 +#### Custom Headers Helicone 支持緩存、用戶跟踪和會話管理等功能的自定義標頭。使用 `options.headers` 將它們添加到您的提供商配置中: @@ -1003,9 +999,9 @@ Helicone 支持緩存、用戶跟踪和會話管理等功能的自定義標頭 } ``` -##### 會話跟踪 +##### Session tracking -Helicone 的 [會議](https://docs.helicone.ai/features/sessions) 功能可讓您將相關的 LLM 請求分組在一起。使用 [opencode-helicone-session](https://github.com/H2Shami/opencode-helicone-session) 插件自動將每個 opencode 對話記錄為 Helicone 中的會話。 +Helicone 的 [Sessions](https://docs.helicone.ai/features/sessions) 功能可讓您將相關的 LLM 請求分組在一起。使用 [opencode-helicone-session](https://github.com/H2Shami/opencode-helicone-session) 插件自動將每個 Kilo 對話記錄為 Helicone 中的會話。 ```bash npm install -g opencode-helicone-session @@ -1019,24 +1015,24 @@ npm install -g opencode-helicone-session } ``` -該插件將 `Helicone-Session-Id` 和 `Helicone-Session-Name` 標頭注入您的請求中。在 Helicone 的會話頁面中,您將看到每個 opencode 對話都列為單獨的會話。 +該插件將 `Helicone-Session-Id` 和 `Helicone-Session-Name` 標頭注入您的請求中。在 Helicone 的 Sessions 頁面中,您將看到每個 Kilo 對話都列為單獨的會話。 -##### 常見 Helicone 接頭 +##### Common Helicone headers -| 標題 | 描述 | -| -------------------------- | ----------------------------------------------------- | -| `Helicone-Cache-Enabled` | 啟用響應緩存 (`true`/`false`) | -| `Helicone-User-Id` | 按用戶跟踪指標 | -| `Helicone-Property-[Name]` | 添加自定義屬性(例如`Helicone-Property-Environment`) | -| `Helicone-Prompt-Id` | 將請求與提示版本相關聯 | +| Header | Description | +| -------------------------- | ------------------------------------------------------ | +| `Helicone-Cache-Enabled` | 啟用響應緩存 (`true`/`false`) | +| `Helicone-User-Id` | 按用戶跟踪指標 | +| `Helicone-Property-[Name]` | 添加自定義屬性(例如 `Helicone-Property-Environment`) | +| `Helicone-Prompt-Id` | 將請求與提示版本相關聯 | -有關所有可用標頭,請參閱[Helicone 頭目錄](https://docs.helicone.ai/helicone-headers/header-directory)。 +有關所有可用標頭,請參閱 [Helicone Header Directory](https://docs.helicone.ai/helicone-headers/header-directory)。 --- -### 調用.cpp +### llama.cpp -您可以通過[llama.cpp 的](https://github.com/ggml-org/llama.cpp) llama-server實用程序配置opencode以使用本地模型 +您可以通過 [llama.cpp's](https://github.com/ggml-org/llama.cpp) llama-server 實用程序配置 Kilo 以使用本地模型 ```json title="opencode.json" "llama.cpp" {5, 6, 8, 10-15} { @@ -1068,17 +1064,17 @@ npm install -g opencode-helicone-session - `npm` 指定用於此提供商的包。這裡,`@ai-sdk/openai-compatible` 用於任何 OpenAI 兼容的 API。 - `name` 是 UI 中提供商的顯示名稱。 - `options.baseURL` 是本地服務器的端點。 -- `models` 是模型 ID 與其配置的映射。型號名稱將顯示在型號選擇列表中。 +- `models` 是模型 ID 與其配置的映射。模型名稱將顯示在模型選擇列表中。 --- -### IO網絡 +### IO.NET IO.NET 提供了 17 種針對各種用例進行優化的模型: -1. 前往[IO.NET console](https://ai.io.net/),創建一個帳戶並生成一個 API 密鑰。 +1. 前往 [IO.NET console](https://ai.io.net/),創建一個帳戶並生成一個 API 密鑰。 -2. 運行`/connect`命令並蒐索**IO.NET**。 +2. 運行 `/connect` 命令並搜尋 **IO.NET**。 ```txt /connect @@ -1093,7 +1089,7 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型: └ enter ``` -4. 執行`/models`命令選擇型號。 +4. 執行 `/models` 命令選擇模型。 ```txt /models @@ -1101,9 +1097,9 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型: --- -### LM工作室 +### LM Studio -您可以通過 LM Studio 配置 opencode 以使用本地模型。 +您可以通過 LM Studio 配置 Kilo 以使用本地模型。 ```json title="opencode.json" "lmstudio" {5, 6, 8, 10-14} { @@ -1131,17 +1127,17 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型: - `npm` 指定用於此提供商的包。這裡,`@ai-sdk/openai-compatible` 用於任何 OpenAI 兼容的 API。 - `name` 是 UI 中提供商的顯示名稱。 - `options.baseURL` 是本地服務器的端點。 -- `models` 是模型 ID 與其配置的映射。型號名稱將顯示在型號選擇列表中。 +- `models` 是模型 ID 與其配置的映射。模型名稱將顯示在模型選擇列表中。 --- -### 登月AI +### Moonshot AI 要使用 Moonshot AI 中的 Kimi K2: -1. 前往[Moonshot AI console](https://platform.moonshot.ai/console),創建一個帳戶,然後單擊“**創建 API 密鑰**”。 +1. 前往 [Moonshot AI console](https://platform.moonshot.ai/console),創建一個帳戶,然後單擊 **Create API key**。 -2. 運行 `/connect` 命令並蒐索 **Moonshot AI**。 +2. 運行 `/connect` 命令並搜尋 **Moonshot AI**。 ```txt /connect @@ -1156,7 +1152,7 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型: └ enter ``` -4. 運行`/models`命令選擇*Kimi K2*。 +4. 運行 `/models` 命令選擇 _Kimi K2_。 ```txt /models @@ -1164,11 +1160,11 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型: --- -### 最小最大 +### MiniMax -1. 前往[MiniMax API 控制台](https://platform.minimax.io/login),創建一個帳戶並生成一個 API 密鑰。 +1. 前往 [MiniMax API Console](https://platform.minimax.io/login),創建一個帳戶並生成一個 API 密鑰。 -2. 運行 `/connect` 命令並蒐索 **MiniMax**。 +2. 運行 `/connect` 命令並搜尋 **MiniMax**。 ```txt /connect @@ -1183,7 +1179,7 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型: └ enter ``` -4. 運行`/models`命令選擇型號,如*M2.1*。 +4. 運行 `/models` 命令選擇模型,如 _M2.1_。 ```txt /models @@ -1191,17 +1187,17 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型: --- -### Nebius 代幣工廠 +### Nebius Token Factory -1. 前往[Nebius 令牌工廠控制台](https://tokenfactory.nebius.com/),創建一個帳戶,然後單擊“**添加密鑰**”。 +1. 前往 [Nebius Token Factory console](https://tokenfactory.nebius.com/),創建一個帳戶,然後單擊 **Add Key**。 -2. 運行`/connect`命令並蒐索**Nebius令牌工廠**。 +2. 運行 `/connect` 命令並搜尋 **Nebius Token Factory**。 ```txt /connect ``` -3. 輸入您的 Nebius 令牌工廠 API 密鑰。 +3. 輸入您的 Nebius Token Factory API 密鑰。 ```txt ┌ API key @@ -1210,7 +1206,7 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型: └ enter ``` -4. 運行`/models`命令選擇一個模型,如*Kimi K2 Instruct*。 +4. 運行 `/models` 命令選擇一個模型,如 _Kimi K2 Instruct_。 ```txt /models @@ -1218,12 +1214,12 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型: --- -### 成為 +### Ollama -您可以通過 Ollama 配置 opencode 以使用本地模型。 +您可以通過 Ollama 配置 Kilo 以使用本地模型。 :::tip -Ollama 可以自動為 opencode 配置自身。詳情請參閱[Ollama 集成文檔](https://docs.ollama.com/integrations/opencode)。 +Ollama 可以自動為 Kilo 配置自身。詳情請參閱 [Ollama integration docs](https://docs.ollama.com/integrations/opencode)。 ::: ```json title="opencode.json" "ollama" {5, 6, 8, 10-14} @@ -1252,25 +1248,25 @@ Ollama 可以自動為 opencode 配置自身。詳情請參閱[Ollama 集成文 - `npm` 指定用於此提供商的包。這裡,`@ai-sdk/openai-compatible` 用於任何 OpenAI 兼容的 API。 - `name` 是 UI 中提供商的顯示名稱。 - `options.baseURL` 是本地服務器的端點。 -- `models` 是模型 ID 與其配置的映射。型號名稱將顯示在型號選擇列表中。 +- `models` 是模型 ID 與其配置的映射。模型名稱將顯示在模型選擇列表中。 :::tip -如果工具調用不起作用,請嘗試增加 Ollama 中的`num_ctx`。從 16k - 32k 左右開始。 +如果工具調用不起作用,請嘗試增加 Ollama 中的 `num_ctx`。從 16k - 32k 左右開始。 ::: --- -### 奧拉馬雲 +### Ollama Cloud -要將 Ollama Cloud 與 opencode 結合使用: +要將 Ollama Cloud 與 Kilo 結合使用: -1. 前往[https://llama.com/](https://ollama.com/) 並登錄或創建帳戶。 +1. 前往 [https://ollama.com/](https://ollama.com/) 並登錄或創建帳戶。 -2. 導航到 **設置** > **密鑰**,然後單擊 **添加 API 密鑰** 以生成新的 API 密鑰。 +2. 導航到 **Settings** > **Keys**,然後單擊 **Add API Key** 以生成新的 API 密鑰。 -3. 複製 API 密鑰以在 opencode 中使用。 +3. 複製 API 密鑰以在 Kilo 中使用。 -4. 運行 `/connect` 命令並蒐索 **Ollama Cloud**。 +4. 運行 `/connect` 命令並搜尋 **Ollama Cloud**。 ```txt /connect @@ -1285,13 +1281,13 @@ Ollama 可以自動為 opencode 配置自身。詳情請參閱[Ollama 集成文 └ enter ``` -6. **重要**:在opencode中使用雲模型之前,必須將模型信息拉取到本地: +6. **Important**:在 Kilo 中使用雲模型之前,您必須將模型信息拉取到本地: ```bash ollama pull gpt-oss:20b-cloud ``` -7. 運行 `/models` 命令以選擇您的 Ollama Cloud 型號。 +7. 運行 `/models` 命令以選擇您的 Ollama Cloud 模型。 ```txt /models @@ -1299,9 +1295,9 @@ Ollama 可以自動為 opencode 配置自身。詳情請參閱[Ollama 集成文 --- -### 開放AI +### OpenAI -我們建議註冊[ChatGPT Plus 或 Pro](https://chatgpt.com/pricing)。 +我們建議註冊 [ChatGPT Plus or Pro](https://chatgpt.com/pricing)。 1. 註冊後,運行 `/connect` 命令並選擇 OpenAI。 @@ -1328,23 +1324,23 @@ Ollama 可以自動為 opencode 配置自身。詳情請參閱[Ollama 集成文 ##### 使用 API 密鑰 -如果您已有 API 密鑰,可以選擇 **手動輸入 API 密鑰** 並將其粘貼到您的terminal中。 +如果您已有 API 密鑰,可以選擇 **Manually enter API Key** 並將其粘貼到您的終端機中。 --- ### OpenCode Zen -OpenCode Zen 是 opencode 團隊提供的經過測試和驗證的模型列表。 [了解更多](/docs/zen)。 +OpenCode Zen 是 Kilo 團隊提供的經過測試和驗證的模型列表。 [了解更多](/docs/zen)。 -1. 登錄 **OpenCode Zen** 並單擊 **創建 API 密鑰**。 +1. 登錄 **OpenCode Zen** 並單擊 **Create API Key**。 -2. 運行 `/connect` 命令並蒐索 **OpenCode Zen**。 +2. 運行 `/connect` 命令並搜尋 **OpenCode Zen**。 ```txt /connect ``` -3. 輸入您的 opencode API 密鑰。 +3. 輸入您的 Kilo API 密鑰。 ```txt ┌ API key @@ -1353,7 +1349,7 @@ OpenCode Zen 是 opencode 團隊提供的經過測試和驗證的模型列表。 └ enter ``` -4. 運行`/models`命令選擇型號,如*Qwen 3 Coder 480B*。 +4. 運行 `/models` 命令選擇模型,如 _Qwen 3 Coder 480B_。 ```txt /models @@ -1361,11 +1357,11 @@ OpenCode Zen 是 opencode 團隊提供的經過測試和驗證的模型列表。 --- -### 開放路由器 +### OpenRouter -1. 前往[OpenRouter dashboard](https://openrouter.ai/settings/keys),單擊“**創建 API 密鑰**”,然後復制密鑰。 +1. 前往 [OpenRouter dashboard](https://openrouter.ai/settings/keys),單擊 **Create API Key**,然後複製密鑰。 -2. 運行`/connect`命令並蒐索OpenRouter。 +2. 運行 `/connect` 命令並搜尋 OpenRouter。 ```txt /connect @@ -1380,13 +1376,13 @@ OpenCode Zen 是 opencode 團隊提供的經過測試和驗證的模型列表。 └ enter ``` -4. OpenRouter默認預加載了多種型號,運行`/models`命令選擇您想要的型號。 +4. 許多 OpenRouter 模型是默認預加載的,運行 `/models` 命令選擇您想要的模型。 ```txt /models ``` - 您還可以通過 opencode 配置添加其他模型。 + 您還可以通過 Kilo 配置添加其他模型。 ```json title="opencode.json" {6} { @@ -1401,7 +1397,7 @@ OpenCode Zen 是 opencode 團隊提供的經過測試和驗證的模型列表。 } ``` -5. 您還可以通過 opencode 配置自定義它們。這是指定提供商的示例 +5. 您還可以通過 Kilo 配置自定義它們。這是指定提供商的示例 ```json title="opencode.json" { @@ -1425,17 +1421,17 @@ OpenCode Zen 是 opencode 團隊提供的經過測試和驗證的模型列表。 --- -### SAPAI核心 +### SAP AI Core SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、Meta、Mistral 和 AI21 的 40 多個模型的訪問。 -1. 轉到[SAP BTP 駕駛艙](https://account.hana.ondemand.com/),導航到 SAP AI Core 服務實例,然後創建服務密鑰。 +1. 轉到您的 [SAP BTP Cockpit](https://account.hana.ondemand.com/),導航到您的 SAP AI Core 服務實例,然後創建一個服務密鑰。 :::tip - 服務密鑰是一個包含`clientid`、`clientsecret`、`url` 和`serviceurls.AI_API_URL` 的JSON 對象。您可以在 BTP Cockpit 的 **服務** > **實例和訂閱** 下找到您的 AI Core 實例。 + 服務密鑰是一個包含 `clientid`、`clientsecret`、`url` 和 `serviceurls.AI_API_URL` 的 JSON 對象。您可以在 BTP Cockpit 的 **Services** > **Instances and Subscriptions** 下找到您的 AI Core 實例。 ::: -2. 運行 `/connect` 命令並蒐索 **SAP AI Core**。 +2. 運行 `/connect` 命令並搜尋 **SAP AI Core**。 ```txt /connect @@ -1450,7 +1446,7 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M └ enter ``` - 或者設置`AICORE_SERVICE_KEY`環境變量: + 或者設置 `AICORE_SERVICE_KEY` 環境變量: ```bash AICORE_SERVICE_KEY='{"clientid":"...","clientsecret":"...","url":"...","serviceurls":{"AI_API_URL":"..."}}' opencode @@ -1472,7 +1468,7 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M 這些設置是可選的,應根據您的 SAP AI Core 設置進行配置。 ::: -5. 運行 `/models` 命令從 40 多個可用型號中進行選擇。 +5. 運行 `/models` 命令從 40 多個可用模型中進行選擇。 ```txt /models @@ -1480,11 +1476,11 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M --- -### OVHcloud AI 端點 +### OVHcloud AI Endpoints -1. 前往[OVH雲面板](https://ovh.com/manager)。導航到 `Public Cloud` 部分,`AI & Machine Learning` > `AI Endpoints`,然後在 `API Keys` 選項卡中單擊 **創建新的 API 密鑰**。 +1. 前往 [OVHcloud panel](https://ovh.com/manager)。導航到 `Public Cloud` 部分,`AI & Machine Learning` > `AI Endpoints`,然後在 `API Keys` 選項卡中單擊 **Create a new API key**。 -2. 運行 `/connect` 命令並蒐索 **OVHcloud AI Endpoints**。 +2. 運行 `/connect` 命令並搜尋 **OVHcloud AI Endpoints**。 ```txt /connect @@ -1499,7 +1495,7 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M └ enter ``` -4. 運行`/models`命令選擇型號,如*gpt-oss-120b*。 +4. 運行 `/models` 命令選擇模型,如 _gpt-oss-120b_。 ```txt /models @@ -1507,13 +1503,13 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M --- -### 斯卡威 +### Scaleway -要將 [Scaleway 生成 API](https://www.scaleway.com/en/docs/generative-apis/) 與 opencode 一起使用: +要將 [Scaleway Generative APIs](https://www.scaleway.com/en/docs/generative-apis/) 與 Kilo 一起使用: -1. 前往[Scaleway 控制台 IAM 設置](https://console.scaleway.com/iam/api-keys) 生成新的 API 密鑰。 +1. 前往 [Scaleway Console IAM settings](https://console.scaleway.com/iam/api-keys) 生成新的 API 密鑰。 -2. 運行 `/connect` 命令並蒐索 **Scaleway**。 +2. 運行 `/connect` 命令並搜尋 **Scaleway**。 ```txt /connect @@ -1528,7 +1524,7 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M └ enter ``` -4. 運行`/models`命令選擇模型,如*devstral-2-123b-instruct-2512*或*gpt-oss-120b*。 +4. 運行 `/models` 命令選擇模型,如 _devstral-2-123b-instruct-2512_ 或 _gpt-oss-120b_。 ```txt /models @@ -1536,11 +1532,11 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M --- -### 一起AI +### Together AI -1. 前往[Together AI console](https://api.together.ai),創建一個帳戶,然後單擊“**添加密鑰**”。 +1. 前往 [Together AI console](https://api.together.ai),創建一個帳戶,然後單擊 **Add Key**。 -2. 運行 `/connect` 命令並蒐索 **Together AI**。 +2. 運行 `/connect` 命令並搜尋 **Together AI**。 ```txt /connect @@ -1555,7 +1551,7 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M └ enter ``` -4. 運行`/models`命令選擇一個模型,如*Kimi K2 Instruct*。 +4. 運行 `/models` 命令選擇一個模型,如 _Kimi K2 Instruct_。 ```txt /models @@ -1563,11 +1559,11 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M --- -### 威尼斯AI +### Venice AI -1. 前往[Venice AI console](https://venice.ai),創建一個帳戶並生成一個 API 密鑰。 +1. 前往 [Venice AI console](https://venice.ai),創建一個帳戶並生成一個 API 密鑰。 -2. 運行`/connect`命令並蒐索**Venice AI**。 +2. 運行 `/connect` 命令並搜尋 **Venice AI**。 ```txt /connect @@ -1582,7 +1578,7 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M └ enter ``` -4. 運行`/models`命令選擇型號,如*Llama 3.3 70B*。 +4. 運行 `/models` 命令選擇模型,如 _Llama 3.3 70B_。 ```txt /models @@ -1590,13 +1586,13 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M --- -### VercelAI網關 +### Vercel AI Gateway -Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、Google、xAI 等的模型。型號按標價提供,不加價。 +Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、Google、xAI 等的模型。模型按標價提供,不加價。 -1. 前往[Vercel dashboard](https://vercel.com/),導航至 **AI Gateway** 選項卡,然後單擊 **API 密鑰** 以創建新的 API 密鑰。 +1. 前往 [Vercel dashboard](https://vercel.com/),導航至 **AI Gateway** 選項卡,然後單擊 **API keys** 以創建新的 API 密鑰。 -2. 運行 `/connect` 命令並蒐索 **Vercel AI Gateway**。 +2. 運行 `/connect` 命令並搜尋 **Vercel AI Gateway**。 ```txt /connect @@ -1611,13 +1607,13 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G └ enter ``` -4. 執行`/models`命令選擇型號。 +4. 執行 `/models` 命令選擇模型。 ```txt /models ``` -您還可以通過 opencode 配置自定義模型。以下是指定提供者路由順序的示例。 +您還可以通過 Kilo 配置自定義模型。以下是指定提供者路由順序的示例。 ```json title="opencode.json" { @@ -1638,19 +1634,19 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G 一些有用的路由選項: -| 選項 | 描述 | -| ------------------- | ---------------------------- | -| `order` | 提供者嘗試順序 | -| `only` | 限制特定提供商 | -| `zeroDataRetention` | 僅使用零數據保留政策的提供商 | +| Option | Description | +| ------------------- | ---------------------------------------------------- | +| `order` | Provider sequence to try | +| `only` | Restrict to specific providers | +| `zeroDataRetention` | Only use providers with zero data retention policies | --- -### 人工智慧 +### xAI -1. 前往[xAI控制台](https://console.x.ai/),創建一個帳戶並生成一個 API 密鑰。 +1. 前往 [xAI console](https://console.x.ai/),創建一個帳戶並生成一個 API 密鑰。 -2. 運行`/connect`命令並蒐索**xAI**。 +2. 運行 `/connect` 命令並搜尋 **xAI**。 ```txt /connect @@ -1665,7 +1661,7 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G └ enter ``` -4. 運行`/models`命令選擇一個模型,如*Grok Beta*。 +4. 運行 `/models` 命令選擇一個模型,如 _Grok Beta_。 ```txt /models @@ -1673,17 +1669,17 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G --- -### 扎艾 +### Z.AI -1. 前往[Z.AI API控制台](https://z.ai/manage-apikey/apikey-list),創建一個帳戶,然後單擊“**創建新的 API 密鑰**”。 +1. 前往 [Z.AI API console](https://z.ai/manage-apikey/apikey-list),創建一個帳戶,然後單擊 **Create a new API key**。 -2. 運行`/connect`命令並蒐索**Z.AI**。 +2. 運行 `/connect` 命令並搜尋 **Z.AI**。 ```txt /connect ``` - 如果您訂閱了 **GLM 編碼計劃**,請選擇 **Z.AI 編碼計劃**。 + 如果您訂閱了 **GLM Coding Plan**,請選擇 **Z.AI Coding Plan**。 3. 輸入您的 Z.AI API 密鑰。 @@ -1694,7 +1690,7 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G └ enter ``` -4. 運行`/models`命令選擇*GLM-4.7*等模型。 +4. 運行 `/models` 命令選擇 _GLM-4.7_ 等模型。 ```txt /models @@ -1702,11 +1698,11 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G --- -### 多路復用器 +### ZenMux -1. 前往[ZenMux 儀表板](https://zenmux.ai/settings/keys),單擊“**創建 API 密鑰**”,然後復制密鑰。 +1. 前往 [ZenMux dashboard](https://zenmux.ai/settings/keys),單擊 **Create API Key**,然後複製密鑰。 -2. 運行`/connect`命令並蒐索ZenMux。 +2. 運行 `/connect` 命令並搜尋 ZenMux。 ```txt /connect @@ -1727,7 +1723,7 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G /models ``` - 您還可以通過 opencode 配置添加其他模型。 + 您還可以通過 Kilo 配置添加其他模型。 ```json title="opencode.json" {6} { @@ -1744,15 +1740,15 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G --- -## 定制提供商 +## Custom provider -要添加 `/connect` 命令中未列出的任何 **OpenAI 兼容** 提供商: +要添加 `/connect` 命令中未列出的任何 **OpenAI-compatible** 提供商: :::tip -您可以將任何與 OpenAI 兼容的提供商與 opencode 結合使用。大多數現代AI提供商都提供與 OpenAI 兼容的 API。 +您可以將任何與 OpenAI 兼容的提供商與 Kilo 結合使用。大多數現代 AI 提供商都提供與 OpenAI 兼容的 API。 ::: -1. 運行 `/connect` 命令並向下滾動到 **其他**。 +1. 運行 `/connect` 命令並向下滾動到 **Other**。 ```bash $ /connect @@ -1819,8 +1815,8 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G 以下是配置選項: - **npm**:要使用的 AI SDK 包,`@ai-sdk/openai-compatible` 用於 OpenAI 兼容提供商 - - **名稱**:UI 中的顯示名稱。 - - **型號**:可用型號。 + - **name**:UI 中的顯示名稱。 + - **models**:可用模型。 - **options.baseURL**:API 端點 URL。 - **options.apiKey**:如果不使用身份驗證,可以選擇設置 API 密鑰。 - **options.headers**:可選擇設置自定義標頭。 @@ -1831,9 +1827,9 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G --- -##### 例子 +##### Example -以下是設置`apiKey`、`headers` 和模型`limit` 選項的示例。 +以下是設置 `apiKey`、`headers` 和模型 `limit` 選項的示例。 ```json title="opencode.json" {9,11,17-20} { @@ -1865,25 +1861,25 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G 配置詳情: -- **apiKey**:使用`env`變量語法[了解更多](/docs/config#env-vars)設置。 -- ** headers **:隨每個請求發送的自定義標頭。 +- **apiKey**:使用 `env` 變量語法 [了解更多](/docs/config#env-vars) 設置。 +- **headers**:隨每個請求發送的自定義標頭。 - **limit.context**:模型接受的最大輸入標記。 - **limit.output**:模型可以生成的最大令牌。 -`limit` 字段允許 opencode 了解您還剩下多少上下文。標準提供商會自動從 models.dev 中提取這些內容。 +`limit` 字段允許 Kilo 了解您還剩下多少上下文。標準提供商會自動從 models.dev 中提取這些內容。 --- -## 故障排除 +## Troubleshooting 如果您在配置提供商時遇到問題,請檢查以下內容: -1. **檢查身份驗證設置**:運行 `kilo auth list` 以查看憑據是否 +1. **Check the auth setup**:運行 `kilo auth list` 以查看憑據是否 提供商的配置已添加到您的配置中。 這不適用於 Amazon Bedrock 等依賴環境變量進行身份驗證的提供商。 -2. 對於自定義提供商,請檢查 opencode 配置並: - - 確保 `/connect` 命令中使用的提供商 ID 與 opencode 配置中的 ID 匹配。 +2. 對於自定義提供商,請檢查 Kilo 配置並: + - 確保 `/connect` 命令中使用的提供商 ID 與 Kilo 配置中的 ID 匹配。 - 正確的 npm 包用於提供商。例如,對 Cerebras 使用 `@ai-sdk/cerebras`。對於所有其他 OpenAI 兼容提供商,請使用 `@ai-sdk/openai-compatible`。 - 檢查 `options.baseURL` 字段中使用了正確的 API 端點。 diff --git a/packages/web/src/content/docs/zh-tw/rules.mdx b/packages/web/src/content/docs/zh-tw/rules.mdx index 79e653572..c0f272a5d 100644 --- a/packages/web/src/content/docs/zh-tw/rules.mdx +++ b/packages/web/src/content/docs/zh-tw/rules.mdx @@ -130,7 +130,7 @@ export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills ### 使用 opencode.json -推薦的方法是在`opencode.json`中使用`instructions`字段: +推薦的方法是在`instructions`中使用`opencode.json`字段: ```json title="opencode.json" { diff --git a/packages/web/src/content/docs/zh-tw/skills.mdx b/packages/web/src/content/docs/zh-tw/skills.mdx index 977d0c76e..eb608fb0b 100644 --- a/packages/web/src/content/docs/zh-tw/skills.mdx +++ b/packages/web/src/content/docs/zh-tw/skills.mdx @@ -25,7 +25,7 @@ opencode 搜索這些位置: ## 了解發現 對於項目本地路徑,opencode 將從當前工作目錄開始,直到到達 git 工作樹。 -它加載 `.opencode/` 中任何匹配的 `skills/*/SKILL.md` 以及一路上任何匹配的 `.claude/skills/*/SKILL.md` 或 `.agents/skills/*/SKILL.md`。 +它加載 `skills/*/SKILL.md` 中任何匹配的 `.opencode/` 以及一路上任何匹配的 `.claude/skills/*/SKILL.md` 或 `.agents/skills/*/SKILL.md`。 全局定義也從`~/.config/opencode/skills/*/SKILL.md`、`~/.claude/skills/*/SKILL.md` 和`~/.agents/skills/*/SKILL.md` 加載。 diff --git a/packages/web/src/content/docs/zh-tw/troubleshooting.mdx b/packages/web/src/content/docs/zh-tw/troubleshooting.mdx index bdc9b8bbf..fd4bd0468 100644 --- a/packages/web/src/content/docs/zh-tw/troubleshooting.mdx +++ b/packages/web/src/content/docs/zh-tw/troubleshooting.mdx @@ -45,7 +45,7 @@ opencode Desktop 在後台運行本地 opencode 服務器(`opencode-cli` sidec - 完全退出並重新啟動應用程式。 - 如果應用程式顯示錯誤屏幕,請單擊“**重新啟動**”並複制錯誤詳細信息。 -- 僅限 macOS:`opencode` 菜單 -> **重新加載 Webview**(如果 UI 為空白/凍結,則有幫助)。 +- 僅限 macOS:`Kilo` 菜單 -> **重新加載 Webview**(如果 UI 為空白/凍結,則有幫助)。 --- diff --git a/packages/web/src/content/docs/zh-tw/tui.mdx b/packages/web/src/content/docs/zh-tw/tui.mdx index bb004191a..19c23f2e8 100644 --- a/packages/web/src/content/docs/zh-tw/tui.mdx +++ b/packages/web/src/content/docs/zh-tw/tui.mdx @@ -1,13 +1,13 @@ --- -title: 途易 -description: 使用 opencode terminal用戶介面。 +title: TUI +description: 使用 Kilo terminal 用戶介面。 --- import { Tabs, TabItem } from "@astrojs/starlight/components" -opencode 提供了一個交互式terminal介面或 TUI,供您與LLM一起處理項目。 +Kilo 提供了一個交互式 terminal 介面或 TUI,供您與 LLM 一起處理項目。 -運行 opencode 會啟動當前目錄的 TUI。 +運行 Kilo 會啟動當前目錄的 TUI。 ```bash opencode @@ -43,7 +43,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -## bash 命令 +## Bash 命令 以 `!` 開始一條消息以運行 shell 命令。 @@ -57,7 +57,7 @@ How is auth handled in @packages/functions/src/api/index.ts? ## 命令 -使用 opencode TUI 時,您可以鍵入 `/` 後跟命令名稱來快速執行操作。例如: +使用 Kilo TUI 時,您可以鍵入 `/` 後跟命令名稱來快速執行操作。例如: ```bash frame="none" /help @@ -71,7 +71,7 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` ### connect -將提供商添加到 opencode。允許您從可用的提供商中進行選擇並添加其 API 密鑰。 +將提供商添加到 Kilo。允許您從可用的提供商中進行選擇並添加其 API 密鑰。 ```bash frame="none" /connect @@ -117,7 +117,7 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` ### exit -退出 opencode。 _別名_:`/quit`、`/q` +退出 Kilo。 _別名_:`/quit`、`/q` ```bash frame="none" /exit @@ -336,12 +336,12 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` 流行的編輯器選項包括: -- `code` - Visual Studio 程式碼 -- `cursor` - 光標 -- `windsurf` - 風帆衝浪 +- `code` - Visual Studio Code +- `cursor` - Cursor +- `windsurf` - Windsurf - `nvim` - Neovim 編輯器 -- `vim` - 我來編輯了 -- `nano` - 納米編輯器 +- `vim` - Vim 編輯器 +- `nano` - Nano 編輯器 - `notepad` - Windows 記事本 - `subl` - Sublime Text @@ -355,7 +355,7 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` ## 配置 -您可以通過 opencode 配置文件自定義 TUI 行為。 +您可以通過 Kilo 配置文件自定義 TUI 行為。 ```json title="opencode.json" { diff --git a/packages/web/src/content/i18n/de.json b/packages/web/src/content/i18n/de.json index d382ba227..004f503fd 100644 --- a/packages/web/src/content/i18n/de.json +++ b/packages/web/src/content/i18n/de.json @@ -1,13 +1,13 @@ { - "app.head.titleSuffix": "AI-Coding-Agent für das terminal", + "app.head.titleSuffix": "AI-Coding-Agent für das Terminal", "app.header.home": "Startseite", "app.header.docs": "Dokumentation", "app.footer.issueLink": "Einen Fehler gefunden? Eröffne ein Issue", "app.footer.discordLink": "Tritt unserer Discord-Community bei", - "app.lander.hero.title": "Der AI-Coding-Agent für das terminal.", + "app.lander.hero.title": "Der AI-Coding-Agent für das Terminal.", "app.lander.cta.getStarted": "Loslegen", "app.lander.features.native_tui.title": "Native TUI", - "app.lander.features.native_tui.description": "Eine reaktionsschnelle, native, anpassbare terminal UI.", + "app.lander.features.native_tui.description": "Eine reaktionsschnelle, native, anpassbare Terminal-UI.", "app.lander.features.lsp_enabled.title": "LSP aktiviert", "app.lander.features.lsp_enabled.description": "Lädt automatisch die passenden LSPs für das LLM.", "app.lander.features.multi_session.title": "Mehrere Sitzungen", @@ -25,7 +25,7 @@ "app.lander.images.vscode.alt": "opencode in VS Code", "app.lander.images.github.caption": "opencode in GitHub", "app.lander.images.github.alt": "opencode in GitHub", - "share.meta_description": "opencode - Der AI-Coding-Agent für das terminal.", + "share.meta_description": "opencode - Der AI-Coding-Agent für das Terminal.", "share.not_found": "Nicht gefunden", "share.link_to_message": "Link zu dieser Nachricht", "share.copied": "Kopiert!", diff --git a/packages/web/src/content/i18n/fr.json b/packages/web/src/content/i18n/fr.json index 92052c75b..942beeb06 100644 --- a/packages/web/src/content/i18n/fr.json +++ b/packages/web/src/content/i18n/fr.json @@ -1,10 +1,10 @@ { - "app.head.titleSuffix": "Agent IA de code conçu pour le terminal", + "app.head.titleSuffix": "Agent AI de code conçu pour le terminal", "app.header.home": "Accueil", "app.header.docs": "Docs", "app.footer.issueLink": "Vous avez trouvé un bug ? Ouvrez une issue", "app.footer.discordLink": "Rejoignez notre communauté Discord", - "app.lander.hero.title": "L'agent de codage IA conçu pour le terminal.", + "app.lander.hero.title": "L'agent de codage AI conçu pour le terminal.", "app.lander.cta.getStarted": "Commencer", "app.lander.features.native_tui.title": "TUI natif", "app.lander.features.native_tui.description": "Une interface terminal native, réactive et personnalisable.", @@ -25,7 +25,7 @@ "app.lander.images.vscode.alt": "opencode dans VS Code", "app.lander.images.github.caption": "opencode dans GitHub", "app.lander.images.github.alt": "opencode dans GitHub", - "share.meta_description": "opencode - Agent IA de code conçu pour le terminal.", + "share.meta_description": "opencode - Agent AI de code conçu pour le terminal.", "share.not_found": "Pas trouvé", "share.link_to_message": "Lien vers ce message", "share.copied": "Copié!", diff --git a/packages/web/src/content/i18n/nb.json b/packages/web/src/content/i18n/nb.json index 8818d39c5..370ca7160 100644 --- a/packages/web/src/content/i18n/nb.json +++ b/packages/web/src/content/i18n/nb.json @@ -67,8 +67,8 @@ "share.creating_plan": "Oppretter plan", "share.completing_plan": "Fullfører plan", "share.updating_plan": "Oppdaterer plan", - "share.match_one": "kamp", - "share.match_other": "kamper", + "share.match_one": "treff", + "share.match_other": "treff", "share.result_one": "resultat", "share.result_other": "resultater", "share.debug_key": "Nøkkel" diff --git a/packages/web/src/content/i18n/tr.json b/packages/web/src/content/i18n/tr.json index 29db1e674..2b6fd9c83 100644 --- a/packages/web/src/content/i18n/tr.json +++ b/packages/web/src/content/i18n/tr.json @@ -1,5 +1,5 @@ { - "app.head.titleSuffix": "Terminal için üretilmiş AI kodlama aracı", + "app.head.titleSuffix": "Terminal için üretilmiş AI coding agent", "app.header.home": "Ana sayfa", "app.header.docs": "Dokümanlar", "app.footer.issueLink": "Bir hata mı buldunuz? Issue açın", diff --git a/packages/web/src/content/i18n/zh-TW.json b/packages/web/src/content/i18n/zh-TW.json index 391e3f71f..7dfd1334c 100644 --- a/packages/web/src/content/i18n/zh-TW.json +++ b/packages/web/src/content/i18n/zh-TW.json @@ -19,13 +19,13 @@ "app.lander.features.use_any_model.title": "使用任何模型", "app.lander.features.use_any_model.prefix": "透過以下方式支援 75+ LLM 提供商", "app.lander.features.use_any_model.suffix": "包括本地模型。", - "app.lander.images.tui.caption": "opencode TUI(tokyonight 主題)", - "app.lander.images.tui.alt": "opencode TUI(tokyonight 主題)", - "app.lander.images.vscode.caption": "opencode 在 VS Code 中", - "app.lander.images.vscode.alt": "opencode 在 VS Code 中", - "app.lander.images.github.caption": "opencode 在 GitHub 中", - "app.lander.images.github.alt": "opencode 在 GitHub 中", - "share.meta_description": "opencode - 為 terminal 打造的 AI 編碼代理。", + "app.lander.images.tui.caption": "OpenCode TUI(tokyonight 主題)", + "app.lander.images.tui.alt": "OpenCode TUI(tokyonight 主題)", + "app.lander.images.vscode.caption": "OpenCode 在 VS Code 中", + "app.lander.images.vscode.alt": "OpenCode 在 VS Code 中", + "app.lander.images.github.caption": "OpenCode 在 GitHub 中", + "app.lander.images.github.alt": "OpenCode 在 GitHub 中", + "share.meta_description": "OpenCode - 為 terminal 打造的 AI 編碼代理。", "share.not_found": "未找到", "share.link_to_message": "連結到此訊息", "share.copied": "複製了!", @@ -53,8 +53,8 @@ "share.error_id_not_found": "未找到 ID", "share.error_api_url_not_found": "API URL 未找到", "share.error_connection_failed": "連線失敗", - "share.opencode_version": "opencode 版本", - "share.opencode_name": "opencode", + "share.opencode_version": "OpenCode 版本", + "share.opencode_name": "OpenCode", "share.models": "模型", "share.cost": "成本", "share.input_tokens": "輸入 Token",