From aea68c386a4f64cf718c3eeee9dffec8409ee6b0 Mon Sep 17 00:00:00 2001 From: Adam <2363879+adamdotdevin@users.noreply.github.com> Date: Wed, 11 Feb 2026 18:51:27 -0600 Subject: [PATCH] fix(docs): locale translations for nav elements and headings --- packages/web/src/content/docs/bs/acp.mdx | 4 +- packages/web/src/content/docs/bs/agents.mdx | 60 +- packages/web/src/content/docs/bs/cli.mdx | 267 ++++--- packages/web/src/content/docs/bs/commands.mdx | 16 +- packages/web/src/content/docs/bs/config.mdx | 99 ++- .../web/src/content/docs/bs/custom-tools.mdx | 4 +- .../web/src/content/docs/bs/enterprise.mdx | 24 +- .../web/src/content/docs/bs/formatters.mdx | 6 +- packages/web/src/content/docs/bs/github.mdx | 4 +- packages/web/src/content/docs/bs/gitlab.mdx | 6 +- packages/web/src/content/docs/bs/ide.mdx | 2 +- packages/web/src/content/docs/bs/index.mdx | 108 ++- packages/web/src/content/docs/bs/keybinds.mdx | 49 +- packages/web/src/content/docs/bs/lsp.mdx | 4 +- .../web/src/content/docs/bs/mcp-servers.mdx | 14 +- packages/web/src/content/docs/bs/models.mdx | 8 +- packages/web/src/content/docs/bs/modes.mdx | 6 +- packages/web/src/content/docs/bs/network.mdx | 2 +- .../web/src/content/docs/bs/permissions.mdx | 4 +- packages/web/src/content/docs/bs/plugins.mdx | 24 +- .../web/src/content/docs/bs/providers.mdx | 14 +- packages/web/src/content/docs/bs/rules.mdx | 6 +- packages/web/src/content/docs/bs/sdk.mdx | 46 +- packages/web/src/content/docs/bs/server.mdx | 60 +- packages/web/src/content/docs/bs/share.mdx | 10 +- packages/web/src/content/docs/bs/skills.mdx | 18 +- packages/web/src/content/docs/bs/themes.mdx | 12 +- packages/web/src/content/docs/bs/tools.mdx | 14 +- .../src/content/docs/bs/troubleshooting.mdx | 30 +- packages/web/src/content/docs/bs/tui.mdx | 8 +- packages/web/src/content/docs/bs/web.mdx | 4 +- .../web/src/content/docs/bs/windows-wsl.mdx | 10 +- packages/web/src/content/docs/bs/zen.mdx | 2 +- packages/web/src/content/docs/da/acp.mdx | 6 +- packages/web/src/content/docs/da/agents.mdx | 58 +- packages/web/src/content/docs/da/cli.mdx | 26 +- packages/web/src/content/docs/da/commands.mdx | 16 +- packages/web/src/content/docs/da/config.mdx | 48 +- .../web/src/content/docs/da/ecosystem.mdx | 2 +- .../web/src/content/docs/da/enterprise.mdx | 6 +- .../web/src/content/docs/da/formatters.mdx | 4 +- packages/web/src/content/docs/da/github.mdx | 6 +- packages/web/src/content/docs/da/index.mdx | 12 +- packages/web/src/content/docs/da/keybinds.mdx | 6 +- packages/web/src/content/docs/da/lsp.mdx | 6 +- .../web/src/content/docs/da/mcp-servers.mdx | 30 +- packages/web/src/content/docs/da/models.mdx | 6 +- packages/web/src/content/docs/da/modes.mdx | 14 +- packages/web/src/content/docs/da/network.mdx | 2 +- packages/web/src/content/docs/da/plugins.mdx | 26 +- .../web/src/content/docs/da/providers.mdx | 742 +++++++++-------- packages/web/src/content/docs/da/rules.mdx | 18 +- packages/web/src/content/docs/da/sdk.mdx | 20 +- packages/web/src/content/docs/da/server.mdx | 276 +++---- packages/web/src/content/docs/da/share.mdx | 16 +- packages/web/src/content/docs/da/skills.mdx | 22 +- packages/web/src/content/docs/da/themes.mdx | 12 +- packages/web/src/content/docs/da/tools.mdx | 16 +- .../src/content/docs/da/troubleshooting.mdx | 218 ++--- packages/web/src/content/docs/da/tui.mdx | 71 +- packages/web/src/content/docs/da/web.mdx | 2 +- packages/web/src/content/docs/da/zen.mdx | 250 +++--- packages/web/src/content/docs/de/acp.mdx | 6 +- packages/web/src/content/docs/de/agents.mdx | 68 +- packages/web/src/content/docs/de/cli.mdx | 38 +- packages/web/src/content/docs/de/commands.mdx | 16 +- packages/web/src/content/docs/de/config.mdx | 65 +- .../web/src/content/docs/de/custom-tools.mdx | 18 +- .../web/src/content/docs/de/ecosystem.mdx | 4 +- .../web/src/content/docs/de/enterprise.mdx | 18 +- .../web/src/content/docs/de/formatters.mdx | 6 +- packages/web/src/content/docs/de/github.mdx | 10 +- packages/web/src/content/docs/de/gitlab.mdx | 14 +- packages/web/src/content/docs/de/ide.mdx | 2 +- packages/web/src/content/docs/de/index.mdx | 41 +- packages/web/src/content/docs/de/keybinds.mdx | 6 +- packages/web/src/content/docs/de/lsp.mdx | 8 +- .../web/src/content/docs/de/mcp-servers.mdx | 22 +- packages/web/src/content/docs/de/models.mdx | 14 +- packages/web/src/content/docs/de/modes.mdx | 14 +- packages/web/src/content/docs/de/network.mdx | 4 +- .../web/src/content/docs/de/permissions.mdx | 22 +- packages/web/src/content/docs/de/plugins.mdx | 37 +- .../web/src/content/docs/de/providers.mdx | 14 +- packages/web/src/content/docs/de/rules.mdx | 12 +- packages/web/src/content/docs/de/sdk.mdx | 26 +- packages/web/src/content/docs/de/server.mdx | 36 +- packages/web/src/content/docs/de/share.mdx | 20 +- packages/web/src/content/docs/de/skills.mdx | 24 +- packages/web/src/content/docs/de/themes.mdx | 12 +- packages/web/src/content/docs/de/tools.mdx | 12 +- .../src/content/docs/de/troubleshooting.mdx | 44 +- packages/web/src/content/docs/de/tui.mdx | 14 +- .../web/src/content/docs/de/windows-wsl.mdx | 6 +- packages/web/src/content/docs/de/zen.mdx | 22 +- packages/web/src/content/docs/es/acp.mdx | 4 +- packages/web/src/content/docs/es/agents.mdx | 58 +- packages/web/src/content/docs/es/cli.mdx | 60 +- packages/web/src/content/docs/es/commands.mdx | 6 +- packages/web/src/content/docs/es/config.mdx | 14 +- .../web/src/content/docs/es/custom-tools.mdx | 2 +- .../web/src/content/docs/es/enterprise.mdx | 2 +- .../web/src/content/docs/es/formatters.mdx | 44 +- packages/web/src/content/docs/es/github.mdx | 4 +- packages/web/src/content/docs/es/gitlab.mdx | 4 +- packages/web/src/content/docs/es/ide.mdx | 2 +- packages/web/src/content/docs/es/index.mdx | 21 +- packages/web/src/content/docs/es/keybinds.mdx | 12 +- packages/web/src/content/docs/es/lsp.mdx | 16 +- .../web/src/content/docs/es/mcp-servers.mdx | 12 +- packages/web/src/content/docs/es/models.mdx | 6 +- packages/web/src/content/docs/es/modes.mdx | 22 +- packages/web/src/content/docs/es/network.mdx | 4 +- packages/web/src/content/docs/es/plugins.mdx | 24 +- .../web/src/content/docs/es/providers.mdx | 49 +- packages/web/src/content/docs/es/rules.mdx | 8 +- packages/web/src/content/docs/es/sdk.mdx | 4 +- packages/web/src/content/docs/es/server.mdx | 40 +- packages/web/src/content/docs/es/share.mdx | 2 +- packages/web/src/content/docs/es/skills.mdx | 6 +- packages/web/src/content/docs/es/themes.mdx | 6 +- packages/web/src/content/docs/es/tools.mdx | 8 +- .../src/content/docs/es/troubleshooting.mdx | 2 +- packages/web/src/content/docs/es/tui.mdx | 32 +- packages/web/src/content/docs/es/web.mdx | 4 +- .../web/src/content/docs/es/windows-wsl.mdx | 22 +- packages/web/src/content/docs/es/zen.mdx | 6 +- packages/web/src/content/docs/fr/acp.mdx | 26 +- packages/web/src/content/docs/fr/agents.mdx | 134 ++-- packages/web/src/content/docs/fr/cli.mdx | 168 ++-- packages/web/src/content/docs/fr/commands.mdx | 51 +- packages/web/src/content/docs/fr/config.mdx | 90 +-- .../web/src/content/docs/fr/custom-tools.mdx | 22 +- .../web/src/content/docs/fr/ecosystem.mdx | 84 +- .../web/src/content/docs/fr/enterprise.mdx | 31 +- .../web/src/content/docs/fr/formatters.mdx | 22 +- packages/web/src/content/docs/fr/github.mdx | 86 +- packages/web/src/content/docs/fr/gitlab.mdx | 48 +- packages/web/src/content/docs/fr/ide.mdx | 18 +- packages/web/src/content/docs/fr/index.mdx | 134 ++-- packages/web/src/content/docs/fr/keybinds.mdx | 20 +- packages/web/src/content/docs/fr/lsp.mdx | 54 +- .../web/src/content/docs/fr/mcp-servers.mdx | 472 ++++++++++- packages/web/src/content/docs/fr/models.mdx | 39 +- packages/web/src/content/docs/fr/modes.mdx | 48 +- packages/web/src/content/docs/fr/network.mdx | 6 +- .../web/src/content/docs/fr/permissions.mdx | 34 +- packages/web/src/content/docs/fr/plugins.mdx | 53 +- packages/web/src/content/docs/fr/tui.mdx | 32 +- packages/web/src/content/docs/fr/web.mdx | 4 +- packages/web/src/content/docs/it/acp.mdx | 6 +- packages/web/src/content/docs/it/agents.mdx | 99 ++- packages/web/src/content/docs/it/cli.mdx | 64 +- packages/web/src/content/docs/it/commands.mdx | 8 +- packages/web/src/content/docs/it/config.mdx | 13 +- .../web/src/content/docs/it/custom-tools.mdx | 6 +- .../web/src/content/docs/it/enterprise.mdx | 22 +- .../web/src/content/docs/it/formatters.mdx | 10 +- packages/web/src/content/docs/it/github.mdx | 2 +- packages/web/src/content/docs/it/gitlab.mdx | 8 +- packages/web/src/content/docs/it/index.mdx | 2 +- packages/web/src/content/docs/it/models.mdx | 14 +- packages/web/src/content/docs/it/modes.mdx | 8 +- .../web/src/content/docs/it/providers.mdx | 2 +- packages/web/src/content/docs/it/server.mdx | 2 +- packages/web/src/content/docs/it/skills.mdx | 22 +- packages/web/src/content/docs/it/tools.mdx | 2 +- packages/web/src/content/docs/it/tui.mdx | 2 +- packages/web/src/content/docs/ja/acp.mdx | 22 +- packages/web/src/content/docs/ja/agents.mdx | 114 +-- packages/web/src/content/docs/ja/cli.mdx | 150 ++-- packages/web/src/content/docs/ja/commands.mdx | 46 +- packages/web/src/content/docs/ja/config.mdx | 109 ++- .../web/src/content/docs/ja/custom-tools.mdx | 18 +- .../web/src/content/docs/ja/ecosystem.mdx | 74 +- .../web/src/content/docs/ja/enterprise.mdx | 62 +- .../web/src/content/docs/ja/formatters.mdx | 12 +- packages/web/src/content/docs/ja/github.mdx | 42 +- packages/web/src/content/docs/ja/gitlab.mdx | 26 +- packages/web/src/content/docs/ja/ide.mdx | 18 +- packages/web/src/content/docs/ja/index.mdx | 66 +- packages/web/src/content/docs/ja/keybinds.mdx | 10 +- packages/web/src/content/docs/ja/lsp.mdx | 16 +- .../web/src/content/docs/ja/mcp-servers.mdx | 480 ++++++++++- packages/web/src/content/docs/ja/models.mdx | 27 +- packages/web/src/content/docs/ja/modes.mdx | 61 +- packages/web/src/content/docs/ja/network.mdx | 10 +- .../web/src/content/docs/ja/permissions.mdx | 77 +- packages/web/src/content/docs/ja/plugins.mdx | 50 +- .../web/src/content/docs/ja/providers.mdx | 186 +++-- packages/web/src/content/docs/ja/rules.mdx | 52 +- packages/web/src/content/docs/ja/sdk.mdx | 56 +- packages/web/src/content/docs/ja/server.mdx | 280 ++++--- packages/web/src/content/docs/ja/share.mdx | 12 +- packages/web/src/content/docs/ja/skills.mdx | 42 +- packages/web/src/content/docs/ja/themes.mdx | 330 +++++++- packages/web/src/content/docs/ja/tools.mdx | 62 +- .../src/content/docs/ja/troubleshooting.mdx | 86 +- packages/web/src/content/docs/ja/tui.mdx | 57 +- packages/web/src/content/docs/ja/web.mdx | 37 +- .../web/src/content/docs/ja/windows-wsl.mdx | 17 +- packages/web/src/content/docs/ja/zen.mdx | 35 +- packages/web/src/content/docs/ko/acp.mdx | 14 +- packages/web/src/content/docs/ko/agents.mdx | 220 ++--- packages/web/src/content/docs/ko/cli.mdx | 32 +- packages/web/src/content/docs/ko/commands.mdx | 18 +- packages/web/src/content/docs/ko/config.mdx | 258 +++--- .../web/src/content/docs/ko/custom-tools.mdx | 10 +- .../web/src/content/docs/ko/ecosystem.mdx | 4 +- .../web/src/content/docs/ko/enterprise.mdx | 16 +- .../web/src/content/docs/ko/formatters.mdx | 78 +- packages/web/src/content/docs/ko/github.mdx | 53 +- packages/web/src/content/docs/ko/gitlab.mdx | 26 +- packages/web/src/content/docs/ko/ide.mdx | 10 +- packages/web/src/content/docs/ko/index.mdx | 12 +- packages/web/src/content/docs/ko/keybinds.mdx | 18 +- packages/web/src/content/docs/ko/lsp.mdx | 124 +-- .../web/src/content/docs/ko/mcp-servers.mdx | 42 +- packages/web/src/content/docs/ko/models.mdx | 40 +- packages/web/src/content/docs/ko/modes.mdx | 44 +- packages/web/src/content/docs/ko/network.mdx | 4 +- .../web/src/content/docs/ko/permissions.mdx | 16 +- packages/web/src/content/docs/ko/plugins.mdx | 26 +- .../web/src/content/docs/ko/providers.mdx | 365 +++++---- packages/web/src/content/docs/ko/rules.mdx | 12 +- packages/web/src/content/docs/ko/sdk.mdx | 60 +- packages/web/src/content/docs/ko/server.mdx | 24 +- packages/web/src/content/docs/ko/share.mdx | 10 +- packages/web/src/content/docs/ko/skills.mdx | 24 +- packages/web/src/content/docs/ko/themes.mdx | 12 +- packages/web/src/content/docs/ko/tools.mdx | 28 +- .../src/content/docs/ko/troubleshooting.mdx | 38 +- packages/web/src/content/docs/ko/tui.mdx | 38 +- packages/web/src/content/docs/ko/web.mdx | 6 +- packages/web/src/content/docs/ko/zen.mdx | 4 +- packages/web/src/content/docs/nb/acp.mdx | 14 +- packages/web/src/content/docs/nb/agents.mdx | 46 +- packages/web/src/content/docs/nb/cli.mdx | 62 +- packages/web/src/content/docs/nb/commands.mdx | 10 +- packages/web/src/content/docs/nb/config.mdx | 66 +- .../web/src/content/docs/nb/custom-tools.mdx | 8 +- .../web/src/content/docs/nb/ecosystem.mdx | 22 +- .../web/src/content/docs/nb/enterprise.mdx | 22 +- .../web/src/content/docs/nb/formatters.mdx | 92 +-- packages/web/src/content/docs/nb/github.mdx | 54 +- packages/web/src/content/docs/nb/gitlab.mdx | 32 +- packages/web/src/content/docs/nb/ide.mdx | 4 +- packages/web/src/content/docs/nb/index.mdx | 51 +- packages/web/src/content/docs/nb/keybinds.mdx | 22 +- packages/web/src/content/docs/nb/lsp.mdx | 40 +- .../web/src/content/docs/nb/mcp-servers.mdx | 137 +++- packages/web/src/content/docs/nb/models.mdx | 6 +- packages/web/src/content/docs/nb/modes.mdx | 279 +------ packages/web/src/content/docs/nb/network.mdx | 14 +- .../web/src/content/docs/nb/permissions.mdx | 14 +- packages/web/src/content/docs/nb/plugins.mdx | 22 +- .../web/src/content/docs/nb/providers.mdx | 28 +- packages/web/src/content/docs/nb/rules.mdx | 16 +- packages/web/src/content/docs/nb/sdk.mdx | 146 ++-- packages/web/src/content/docs/nb/server.mdx | 140 ++-- packages/web/src/content/docs/nb/share.mdx | 4 +- packages/web/src/content/docs/nb/skills.mdx | 28 +- packages/web/src/content/docs/nb/themes.mdx | 18 +- packages/web/src/content/docs/nb/tools.mdx | 16 +- .../src/content/docs/nb/troubleshooting.mdx | 97 +-- packages/web/src/content/docs/nb/tui.mdx | 68 +- packages/web/src/content/docs/nb/web.mdx | 51 +- .../web/src/content/docs/nb/windows-wsl.mdx | 6 +- packages/web/src/content/docs/nb/zen.mdx | 16 +- packages/web/src/content/docs/pl/acp.mdx | 60 +- packages/web/src/content/docs/pl/agents.mdx | 253 +++--- packages/web/src/content/docs/pl/cli.mdx | 340 ++++---- packages/web/src/content/docs/pl/commands.mdx | 102 +-- packages/web/src/content/docs/pl/config.mdx | 287 ++++--- .../web/src/content/docs/pl/custom-tools.mdx | 4 +- .../web/src/content/docs/pl/formatters.mdx | 92 +-- packages/web/src/content/docs/pl/index.mdx | 104 ++- packages/web/src/content/docs/pl/lsp.mdx | 122 +-- packages/web/src/content/docs/pl/models.mdx | 2 +- packages/web/src/content/docs/pl/modes.mdx | 10 +- .../web/src/content/docs/pl/providers.mdx | 16 +- packages/web/src/content/docs/pl/rules.mdx | 14 +- packages/web/src/content/docs/pl/sdk.mdx | 156 ++-- packages/web/src/content/docs/pl/server.mdx | 38 +- packages/web/src/content/docs/pl/share.mdx | 28 +- packages/web/src/content/docs/pl/skills.mdx | 60 +- packages/web/src/content/docs/pl/themes.mdx | 34 +- packages/web/src/content/docs/pl/tools.mdx | 76 +- .../src/content/docs/pl/troubleshooting.mdx | 70 +- packages/web/src/content/docs/pl/tui.mdx | 2 +- packages/web/src/content/docs/pl/web.mdx | 16 +- packages/web/src/content/docs/pl/zen.mdx | 30 +- packages/web/src/content/docs/pt-br/acp.mdx | 14 +- .../web/src/content/docs/pt-br/agents.mdx | 84 +- packages/web/src/content/docs/pt-br/cli.mdx | 38 +- .../web/src/content/docs/pt-br/commands.mdx | 62 +- .../web/src/content/docs/pt-br/config.mdx | 20 +- .../src/content/docs/pt-br/custom-tools.mdx | 42 +- .../web/src/content/docs/pt-br/ecosystem.mdx | 12 +- .../web/src/content/docs/pt-br/enterprise.mdx | 34 +- .../web/src/content/docs/pt-br/formatters.mdx | 10 +- .../web/src/content/docs/pt-br/github.mdx | 78 +- .../web/src/content/docs/pt-br/gitlab.mdx | 60 +- packages/web/src/content/docs/pt-br/ide.mdx | 10 +- packages/web/src/content/docs/pt-br/index.mdx | 24 +- .../web/src/content/docs/pt-br/keybinds.mdx | 4 +- packages/web/src/content/docs/pt-br/lsp.mdx | 10 +- .../src/content/docs/pt-br/mcp-servers.mdx | 6 +- .../web/src/content/docs/pt-br/models.mdx | 8 +- packages/web/src/content/docs/pt-br/modes.mdx | 12 +- .../web/src/content/docs/pt-br/network.mdx | 6 +- .../src/content/docs/pt-br/permissions.mdx | 2 +- .../web/src/content/docs/pt-br/plugins.mdx | 8 +- .../web/src/content/docs/pt-br/providers.mdx | 71 +- packages/web/src/content/docs/pt-br/tools.mdx | 2 +- .../content/docs/pt-br/troubleshooting.mdx | 34 +- packages/web/src/content/docs/pt-br/tui.mdx | 22 +- packages/web/src/content/docs/pt-br/web.mdx | 6 +- .../src/content/docs/pt-br/windows-wsl.mdx | 30 +- packages/web/src/content/docs/pt-br/zen.mdx | 38 +- packages/web/src/content/docs/ru/acp.mdx | 6 +- packages/web/src/content/docs/ru/agents.mdx | 41 +- packages/web/src/content/docs/ru/cli.mdx | 6 +- packages/web/src/content/docs/ru/commands.mdx | 10 +- packages/web/src/content/docs/ru/config.mdx | 38 +- .../web/src/content/docs/ru/custom-tools.mdx | 2 +- .../web/src/content/docs/ru/ecosystem.mdx | 2 +- .../web/src/content/docs/ru/enterprise.mdx | 14 +- .../web/src/content/docs/ru/formatters.mdx | 14 +- packages/web/src/content/docs/ru/github.mdx | 36 +- packages/web/src/content/docs/ru/gitlab.mdx | 18 +- packages/web/src/content/docs/ru/ide.mdx | 8 +- packages/web/src/content/docs/ru/index.mdx | 23 +- packages/web/src/content/docs/ru/keybinds.mdx | 22 +- packages/web/src/content/docs/ru/lsp.mdx | 74 +- .../web/src/content/docs/ru/mcp-servers.mdx | 56 +- packages/web/src/content/docs/ru/models.mdx | 28 +- packages/web/src/content/docs/ru/modes.mdx | 12 +- packages/web/src/content/docs/ru/network.mdx | 2 +- .../web/src/content/docs/ru/permissions.mdx | 4 +- packages/web/src/content/docs/ru/plugins.mdx | 6 +- .../web/src/content/docs/ru/providers.mdx | 11 +- packages/web/src/content/docs/ru/rules.mdx | 4 +- packages/web/src/content/docs/ru/sdk.mdx | 2 +- packages/web/src/content/docs/ru/server.mdx | 2 +- packages/web/src/content/docs/ru/share.mdx | 4 +- packages/web/src/content/docs/ru/skills.mdx | 8 +- packages/web/src/content/docs/ru/themes.mdx | 8 +- packages/web/src/content/docs/ru/tools.mdx | 4 +- .../src/content/docs/ru/troubleshooting.mdx | 6 +- packages/web/src/content/docs/ru/tui.mdx | 38 +- packages/web/src/content/docs/ru/web.mdx | 4 +- packages/web/src/content/docs/ru/zen.mdx | 80 +- packages/web/src/content/docs/th/acp.mdx | 16 +- packages/web/src/content/docs/th/agents.mdx | 263 +++--- packages/web/src/content/docs/th/cli.mdx | 329 ++++---- packages/web/src/content/docs/th/commands.mdx | 111 ++- packages/web/src/content/docs/th/config.mdx | 24 +- .../web/src/content/docs/th/enterprise.mdx | 10 +- packages/web/src/content/docs/th/keybinds.mdx | 4 +- .../web/src/content/docs/th/mcp-servers.mdx | 4 +- packages/web/src/content/docs/th/models.mdx | 38 +- packages/web/src/content/docs/th/modes.mdx | 6 +- packages/web/src/content/docs/th/network.mdx | 4 +- packages/web/src/content/docs/th/plugins.mdx | 4 +- .../web/src/content/docs/th/providers.mdx | 54 +- packages/web/src/content/docs/th/rules.mdx | 2 +- packages/web/src/content/docs/th/server.mdx | 2 +- packages/web/src/content/docs/th/share.mdx | 2 +- packages/web/src/content/docs/th/skills.mdx | 8 +- packages/web/src/content/docs/th/tools.mdx | 2 +- .../src/content/docs/th/troubleshooting.mdx | 6 +- packages/web/src/content/docs/th/tui.mdx | 2 +- packages/web/src/content/docs/th/web.mdx | 2 +- packages/web/src/content/docs/th/zen.mdx | 2 +- packages/web/src/content/docs/tr/acp.mdx | 28 +- packages/web/src/content/docs/tr/agents.mdx | 755 ++++++++++++++++-- packages/web/src/content/docs/tr/cli.mdx | 42 +- packages/web/src/content/docs/tr/commands.mdx | 12 +- packages/web/src/content/docs/tr/config.mdx | 68 +- .../web/src/content/docs/tr/custom-tools.mdx | 10 +- .../web/src/content/docs/tr/ecosystem.mdx | 4 +- .../web/src/content/docs/tr/enterprise.mdx | 34 +- .../web/src/content/docs/tr/formatters.mdx | 60 +- packages/web/src/content/docs/tr/github.mdx | 24 +- packages/web/src/content/docs/tr/gitlab.mdx | 28 +- packages/web/src/content/docs/tr/index.mdx | 37 +- packages/web/src/content/docs/tr/keybinds.mdx | 4 +- packages/web/src/content/docs/tr/lsp.mdx | 12 +- .../web/src/content/docs/tr/mcp-servers.mdx | 26 +- packages/web/src/content/docs/tr/models.mdx | 8 +- packages/web/src/content/docs/tr/modes.mdx | 64 +- packages/web/src/content/docs/tr/network.mdx | 4 +- .../web/src/content/docs/tr/permissions.mdx | 34 +- packages/web/src/content/docs/tr/plugins.mdx | 44 +- .../web/src/content/docs/tr/providers.mdx | 130 +-- packages/web/src/content/docs/tr/sdk.mdx | 232 +++--- packages/web/src/content/docs/tr/server.mdx | 298 +++---- packages/web/src/content/docs/tr/themes.mdx | 120 +-- packages/web/src/content/docs/tr/tools.mdx | 122 +-- .../src/content/docs/tr/troubleshooting.mdx | 32 +- packages/web/src/content/docs/tr/web.mdx | 2 +- .../web/src/content/docs/tr/windows-wsl.mdx | 8 +- packages/web/src/content/docs/zh-cn/acp.mdx | 2 +- .../web/src/content/docs/zh-cn/agents.mdx | 20 +- packages/web/src/content/docs/zh-cn/cli.mdx | 142 ++-- .../web/src/content/docs/zh-cn/commands.mdx | 8 +- .../web/src/content/docs/zh-cn/config.mdx | 56 +- .../src/content/docs/zh-cn/custom-tools.mdx | 8 +- .../web/src/content/docs/zh-cn/ecosystem.mdx | 72 +- .../web/src/content/docs/zh-cn/enterprise.mdx | 24 +- .../web/src/content/docs/zh-cn/formatters.mdx | 6 +- .../web/src/content/docs/zh-cn/github.mdx | 18 +- .../web/src/content/docs/zh-cn/gitlab.mdx | 10 +- packages/web/src/content/docs/zh-cn/ide.mdx | 2 +- packages/web/src/content/docs/zh-cn/index.mdx | 30 +- .../web/src/content/docs/zh-cn/keybinds.mdx | 10 +- packages/web/src/content/docs/zh-cn/lsp.mdx | 20 +- .../src/content/docs/zh-cn/mcp-servers.mdx | 34 +- .../web/src/content/docs/zh-cn/models.mdx | 14 +- packages/web/src/content/docs/zh-cn/modes.mdx | 20 +- .../web/src/content/docs/zh-cn/network.mdx | 8 +- .../src/content/docs/zh-cn/permissions.mdx | 8 +- .../web/src/content/docs/zh-cn/plugins.mdx | 34 +- .../web/src/content/docs/zh-cn/providers.mdx | 80 +- packages/web/src/content/docs/zh-cn/rules.mdx | 10 +- packages/web/src/content/docs/zh-cn/sdk.mdx | 28 +- .../web/src/content/docs/zh-cn/server.mdx | 18 +- packages/web/src/content/docs/zh-cn/share.mdx | 2 +- .../web/src/content/docs/zh-cn/skills.mdx | 12 +- .../web/src/content/docs/zh-cn/themes.mdx | 12 +- .../content/docs/zh-cn/troubleshooting.mdx | 8 +- packages/web/src/content/docs/zh-cn/tui.mdx | 10 +- packages/web/src/content/docs/zh-cn/web.mdx | 4 +- packages/web/src/content/docs/zh-cn/zen.mdx | 8 +- packages/web/src/content/docs/zh-tw/acp.mdx | 52 +- .../web/src/content/docs/zh-tw/agents.mdx | 229 +++--- packages/web/src/content/docs/zh-tw/cli.mdx | 332 ++++---- .../web/src/content/docs/zh-tw/commands.mdx | 117 ++- .../web/src/content/docs/zh-tw/config.mdx | 265 +++--- .../src/content/docs/zh-tw/custom-tools.mdx | 50 +- .../web/src/content/docs/zh-tw/ecosystem.mdx | 102 +-- .../web/src/content/docs/zh-tw/enterprise.mdx | 87 +- .../web/src/content/docs/zh-tw/formatters.mdx | 102 +-- .../web/src/content/docs/zh-tw/github.mdx | 112 +-- .../web/src/content/docs/zh-tw/gitlab.mdx | 70 +- packages/web/src/content/docs/zh-tw/ide.mdx | 40 +- packages/web/src/content/docs/zh-tw/index.mdx | 132 ++- .../web/src/content/docs/zh-tw/keybinds.mdx | 52 +- packages/web/src/content/docs/zh-tw/lsp.mdx | 132 +-- .../src/content/docs/zh-tw/mcp-servers.mdx | 166 ++-- .../web/src/content/docs/zh-tw/models.mdx | 72 +- packages/web/src/content/docs/zh-tw/modes.mdx | 124 +-- .../web/src/content/docs/zh-tw/network.mdx | 26 +- .../src/content/docs/zh-tw/permissions.mdx | 84 +- .../web/src/content/docs/zh-tw/plugins.mdx | 136 ++-- .../web/src/content/docs/zh-tw/providers.mdx | 579 +++++++------- packages/web/src/content/docs/zh-tw/rules.mdx | 78 +- packages/web/src/content/docs/zh-tw/sdk.mdx | 194 ++--- .../web/src/content/docs/zh-tw/server.mdx | 240 +++--- packages/web/src/content/docs/zh-tw/share.mdx | 50 +- .../web/src/content/docs/zh-tw/skills.mdx | 90 +-- .../web/src/content/docs/zh-tw/themes.mdx | 112 +-- packages/web/src/content/docs/zh-tw/tools.mdx | 110 +-- .../content/docs/zh-tw/troubleshooting.mdx | 184 ++--- packages/web/src/content/docs/zh-tw/tui.mdx | 100 +-- packages/web/src/content/docs/zh-tw/web.mdx | 70 +- packages/web/src/content/docs/zh-tw/zen.mdx | 112 +-- packages/web/src/content/i18n/bs.json | 62 +- packages/web/src/content/i18n/da.json | 16 +- packages/web/src/content/i18n/de.json | 16 +- packages/web/src/content/i18n/es.json | 20 +- packages/web/src/content/i18n/fr.json | 14 +- packages/web/src/content/i18n/it.json | 22 +- packages/web/src/content/i18n/ja.json | 16 +- packages/web/src/content/i18n/ko.json | 14 +- packages/web/src/content/i18n/nb.json | 6 +- packages/web/src/content/i18n/pl.json | 10 +- packages/web/src/content/i18n/pt-BR.json | 14 +- packages/web/src/content/i18n/ru.json | 14 +- packages/web/src/content/i18n/th.json | 6 +- packages/web/src/content/i18n/tr.json | 14 +- packages/web/src/content/i18n/zh-CN.json | 6 +- packages/web/src/content/i18n/zh-TW.json | 38 +- 484 files changed, 12718 insertions(+), 11212 deletions(-) diff --git a/packages/web/src/content/docs/bs/acp.mdx b/packages/web/src/content/docs/bs/acp.mdx index 8da0a2122..a2b2707c8 100644 --- a/packages/web/src/content/docs/bs/acp.mdx +++ b/packages/web/src/content/docs/bs/acp.mdx @@ -13,7 +13,7 @@ ACP je otvoreni protokol koji standardizira komunikaciju između uređivača kod --- -## Konfiguriši +## Konfiguracija Da biste koristili OpenCode putem ACP-a, konfigurirajte svoj uređivač da pokrene naredbu `opencode acp`. @@ -140,7 +140,7 @@ Ova konfiguracija postavlja CodeCompanion da koristi OpenCode kao ACP chat agent Ako trebate proslijediti varijable okruženja (kao što je `OPENCODE_API_KEY`), pogledajte [Configuring Adapters: Environment Variables](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) u dokumentaciji CodeCompanion.nvim. -## Podrška +## Podržane funkcije OpenCode radi isto kroz ACP kao i u terminalu. Podržane su sve funkcije: diff --git a/packages/web/src/content/docs/bs/agents.mdx b/packages/web/src/content/docs/bs/agents.mdx index 1b98f3419..8ff674ae6 100644 --- a/packages/web/src/content/docs/bs/agents.mdx +++ b/packages/web/src/content/docs/bs/agents.mdx @@ -15,7 +15,7 @@ Možete se prebacivati ​​između agenata tokom sesije ili ih pozvati spominj ## Vrste -Postoje dvije vrste agenata u OpenCode; primarni agenti i podagenti. +Postoje dvije vrste agenata u OpenCode: primarni agenti i podagenti. --- @@ -45,17 +45,17 @@ OpenCode dolazi sa dva ugrađena primarna agenta i dva ugrađena subagenta. --- -### Koristi build +### Build agent -_Mode_: `primary` +_Režim_: `primary` Build je **podrazumevani** primarni agent sa svim omogućenim alatima. Ovo je standardni agent za razvojni rad gdje vam je potreban pun pristup operacijama datoteka i sistemskim komandama. --- -### Koristi plan +### Plan agent -_Mode_: `primary` +_Režim_: `primary` Ograničeni agent dizajniran za planiranje i analizu. Koristimo sistem dozvola kako bismo vam pružili veću kontrolu i spriječili neželjene promjene. Prema zadanim postavkama, sve sljedeće je postavljeno na `ask`: @@ -67,47 +67,47 @@ Ovaj agent je koristan kada želite da LLM analizira kod, predloži promjene ili --- -### Koristi general +### General agent -_Mode_: `subagent` +_Režim_: `subagent` Agent opće namjene za istraživanje složenih pitanja i izvršavanje zadataka u više koraka. Ima potpuni pristup alatima (osim todo), tako da može mijenjati fajlove kada je to potrebno. Koristite ovo za paralelno pokretanje više jedinica rada. --- -### Koristi explore +### Explore agent -_Mode_: `subagent` +_Režim_: `subagent` Brzi agent samo za čitanje za istraživanje kodnih baza. Nije moguće mijenjati fajlove. Koristite ovo kada trebate brzo pronaći datoteke po uzorku, pretražiti kod za ključne riječi ili odgovoriti na pitanja o bazi kodova. --- -### Koristi compaction +### Compaction agent -_Mode_: `primary` +_Režim_: `primary` Skriveni sistemski agent koji sažima dugi kontekst u manji sažetak. Pokreće se automatski kada je potrebno i ne može se odabrati u korisničkom interfejsu. --- -### Koristi title +### Title agent -_Mode_: `primary` +_Režim_: `primary` Skriveni sistemski agent koji generiše kratke naslove sesija. Pokreće se automatski i ne može se odabrati u korisničkom interfejsu. --- -### Koristi summary +### Summary agent -_Mode_: `primary` +_Režim_: `primary` Skriveni sistemski agent koji kreira sažetke sesije. Pokreće se automatski i ne može se odabrati u korisničkom interfejsu. --- -## Upotreba +## Korištenje 1. Za primarne agente, koristite taster **Tab** za kretanje kroz njih tokom sesije. Također možete koristiti svoju konfiguriranu vezu tipke `switch_agent`. @@ -215,7 +215,7 @@ Pogledajmo ove opcije konfiguracije detaljno. --- -### Description +### Opis Koristite opciju `description` da pružite kratak opis onoga što agent radi i kada ga koristiti. @@ -233,7 +233,7 @@ Ovo je **obavezna** opcija konfiguracije. --- -### Temperature +### Temperatura Kontrolišite slučajnost i kreativnost odgovora LLM-a pomoću `temperature` konfiguracije. @@ -280,7 +280,7 @@ Ako temperatura nije navedena, OpenCode koristi standardne postavke specifične --- -### Max steps +### Maksimalan broj koraka Kontrolirajte maksimalni broj iteracija agenta koje agent može izvesti prije nego što bude prisiljen da odgovori samo tekstom. Ovo omogućava korisnicima koji žele kontrolirati troškove da postave ograničenje na akcije agenta. @@ -306,7 +306,7 @@ Naslijeđeno polje `maxSteps` je zastarjelo. Umjesto toga koristite `steps`. --- -### Disable +### Onemogućavanje Postavite na `true` da onemogućite agenta. @@ -322,7 +322,7 @@ Postavite na `true` da onemogućite agenta. --- -### Prompt +### Upit Navedite prilagođenu sistemsku prompt datoteku za ovog agenta sa `prompt` konfiguracijom. Datoteka s promptom treba da sadrži upute specifične za svrhu agenta. @@ -362,7 +362,7 @@ ID modela u vašoj OpenCode konfiguraciji koristi format `provider/model-id`. Na --- -### Tools +### Alati Kontrolirajte koji su alati dostupni u ovom agentu koristeći konfiguraciju `tools`. Možete omogućiti ili onemogućiti određene alate tako što ćete ih postaviti na `true` ili `false`. @@ -409,7 +409,7 @@ Također možete koristiti zamjenske znakove za kontrolu više alata odjednom. N --- -### Permissions +### Dozvole Možete konfigurirati dozvole za upravljanje radnjama koje agent može poduzeti. Trenutno se dozvole za alate `edit`, `bash` i `webfetch` mogu konfigurirati na: @@ -521,7 +521,7 @@ Budući da posljednje podudarno pravilo ima prednost, prvo postavite zamjenski z --- -### Mode +### Način rada Kontrolirajte način rada agenta koristeći konfiguraciju `mode`. Opcija `mode` se koristi da specificira kako se agent može koristiti. @@ -539,7 +539,7 @@ Opcija `mode` se može postaviti na `primary`, `subagent` ili `all`. Ako `mode` --- -### Hidden +### Skriveno Sakrij podagenta iz `@` menija za automatsko dovršavanje sa `hidden: true`. Korisno za interne podagente koje bi drugi agenti trebali programski pozvati samo preko Task alata. @@ -562,7 +562,7 @@ Odnosi se samo na `mode: subagent` agente. --- -### Task permissions +### Dozvole zadataka Kontrolirajte koje podagente agent može pozvati preko Task alata sa `permission.task`. Koristi glob uzorke za fleksibilno uparivanje. @@ -595,7 +595,7 @@ Korisnici uvijek mogu pozvati bilo kojeg subagenta direktno preko `@` menija za --- -### Color +### Boja Prilagodite vizualni izgled agenta u korisničkom sučelju s opcijom `color`. Ovo utiče na to kako se agent pojavljuje u interfejsu. @@ -634,7 +634,7 @@ Vrijednosti se kreću od 0.0 do 1.0. Niže vrijednosti su više fokusirane, viš --- -### Additional +### Dodatno Sve druge opcije koje navedete u konfiguraciji agenta će biti **direktno proslijeđene** dobavljaču kao opcije modela. Ovo vam omogućava da koristite karakteristike i parametre specifične za provajdera. @@ -661,7 +661,7 @@ Pokrenite `opencode models` da vidite listu dostupnih modela. --- -## Kreirajte agente +## Kreiranje agenata Možete kreirati nove agente koristeći sljedeću naredbu: @@ -679,7 +679,7 @@ Ova interaktivna komanda će: --- -## Slučajevi upotrebe +## Primjeri upotrebe Evo nekoliko uobičajenih slučajeva upotrebe različitih agenata. diff --git a/packages/web/src/content/docs/bs/cli.mdx b/packages/web/src/content/docs/bs/cli.mdx index 4f4f7b899..049b43497 100644 --- a/packages/web/src/content/docs/bs/cli.mdx +++ b/packages/web/src/content/docs/bs/cli.mdx @@ -11,7 +11,7 @@ OpenCode CLI po defaultu pokreće [TUI](/docs/tui) kada se pokrene bez ikakvih a opencode ``` -Ali takođe prihvata komande kao što je dokumentovano na ovoj stranici. Ovo vam omogućava programsku interakciju sa OpenCode. +Ali takođe prihvata naredbe kao što je dokumentovano na ovoj stranici. Ovo vam omogućava programsku interakciju sa OpenCode. ```bash opencode run "Explain how closures work in JavaScript" @@ -21,36 +21,36 @@ opencode run "Explain how closures work in JavaScript" ### tui -Pokrenite korisnički interfejs OpenCode terminala. +Pokrenite OpenCode terminalski korisnički interfejs. ```bash opencode [project] ``` -#### Zastave +#### Opcije -| Zastava | Kratko | Opis | +| Opcija | Kratko | Opis | | ------------ | ------ | ------------------------------------------------------------------------ | | `--continue` | `-c` | Nastavite posljednju sesiju | | `--session` | `-s` | ID sesije za nastavak | | `--fork` | | Forkujte sesiju pri nastavku (koristiti sa `--continue` ili `--session`) | -| `--prompt` | | Uputstvo za upotrebu | -| `--model` | `-m` | Model za korištenje u obliku dobavljača/modela | +| `--prompt` | | Prompt za upotrebu | +| `--model` | `-m` | Model za korištenje u obliku provider/model | | `--agent` | | Agent za korištenje | -| `--port` | | Port za slušanje na | -| `--hostname` | | Slušajte ime hosta | +| `--port` | | Port na kojem treba slušati | +| `--hostname` | | Hostname na kojem treba slušati | --- -## Commands +## Naredbe -OpenCode CLI takođe ima sledeće komande. +OpenCode CLI takođe ima sljedeće naredbe. --- ### agent -Upravljajte agentima za OpenCode. +Upravljajte OpenCode agentima. ```bash opencode agent [command] @@ -60,13 +60,13 @@ opencode agent [command] ### attach -Priključite terminal na već pokrenut OpenCode backend server pokrenut putem `serve` ili `web` komandi. +Priključite terminal na već pokrenut OpenCode backend server pokrenut putem `serve` ili `web` naredbi. ```bash opencode attach [url] ``` -Ovo omogućava korištenje TUI-ja sa udaljenim OpenCode backend-om. na primjer: +Ovo omogućava korištenje TUI-ja sa udaljenim OpenCode backend-om. Na primjer: ```bash # Start the backend server for web/mobile access @@ -76,11 +76,11 @@ opencode web --port 4096 --hostname 0.0.0.0 opencode attach http://10.20.30.40:4096 ``` -#### Zastave +#### Opcije -| Zastava | Kratko | Opis | +| Opcija | Kratko | Opis | | ----------- | ------ | ------------------------------------ | -| `--dir` | | Radni direktorij za pokretanje TUI u | +| `--dir` | | Radni direktorij za pokretanje TUI-a | | `--session` | `-s` | ID sesije za nastavak | --- @@ -93,7 +93,7 @@ Kreirajte novog agenta s prilagođenom konfiguracijom. opencode agent create ``` -Ova komanda će vas voditi kroz kreiranje novog agenta sa prilagođenim sistemskim promptom i konfiguracijom alata. +Ova naredba će vas voditi kroz kreiranje novog agenta sa prilagođenim sistemskim promptom i konfiguracijom alata. --- @@ -131,7 +131,7 @@ Kada se OpenCode pokrene, učitava dobavljače iz datoteke vjerodajnica. I ako p #### list -Navodi sve autentifikovane dobavljače pohranjene u datoteci akreditiva. +Navodi sve autentifikovane dobavljače pohranjene u datoteci vjerodajnica. ```bash opencode auth list @@ -157,7 +157,7 @@ opencode auth logout ### github -Upravljajte GitHub agentom za automatizaciju spremišta. +Upravljajte GitHub agentom za automatizaciju repozitorija. ```bash opencode github [command] @@ -167,7 +167,7 @@ opencode github [command] #### install -Instalirajte GitHub agenta u svoje spremište. +Instalirajte GitHub agenta u svoj repozitorij. ```bash opencode github install @@ -179,24 +179,24 @@ Ovo postavlja neophodni tok rada GitHub Actions i vodi vas kroz proces konfigura #### run -Pokrenite GitHub agent. Ovo se obično koristi u GitHub akcijama. +Pokrenite GitHub agent. Ovo se obično koristi u GitHub Actions. ```bash opencode github run ``` -##### Zastave +##### Opcije -| Zastava | Opis | -| --------- | -------------------------------------------- | -| `--event` | GitHub lažni događaj za pokretanje agenta za | -| `--token` | GitHub token ličnog pristupa | +| Opcija | Opis | +| --------- | -------------------------------------- | +| `--event` | GitHub mock event za pokretanje agenta | +| `--token` | GitHub Personal Access Token | --- ### mcp -Upravljajte serverima protokola konteksta modela. +Upravljajte Model Context Protocol (MCP) serverima. ```bash opencode mcp [command] @@ -212,7 +212,7 @@ Dodajte MCP server svojoj konfiguraciji. opencode mcp add ``` -Ova komanda će vas voditi kroz dodavanje lokalnog ili udaljenog MCP servera. +Ova naredba će vas voditi kroz dodavanje lokalnog ili udaljenog MCP servera. --- @@ -241,7 +241,7 @@ opencode mcp auth [name] ``` Ako ne navedete ime servera, od vas će biti zatraženo da izaberete neki od dostupnih servera koji podržavaju OAuth. -Također možete navesti servere koji podržavaju OAuth i njihov status provjere autentičnosti. +Također možete navesti servere koji podržavaju OAuth i njihov status autentifikacije. ```bash opencode mcp auth list @@ -267,7 +267,7 @@ opencode mcp logout [name] #### debug -Otklanjanje grešaka OAuth veze sa MCP serverom. +Otklanjanje grešaka (debug) OAuth veze sa MCP serverom. ```bash opencode mcp debug @@ -291,11 +291,11 @@ Opciono možete proslijediti ID provajdera za filtriranje modela po tom dobavlja opencode models anthropic ``` -#### Zastave +#### Opcije -| Zastava | Opis | +| Opcija | Opis | | ----------- | ------------------------------------------------------------------------ | -| `--refresh` | Osvježite predmemoriju modela sa models.dev | +| `--refresh` | Osvježite keš modela sa models.dev | | `--verbose` | Koristite detaljniji izlaz modela (uključuje metapodatke poput troškova) | Koristite `--refresh` zastavicu da ažurirate keširanu listu modela. Ovo je korisno kada su novi modeli dodani provajderu i želite da ih vidite u OpenCode. @@ -308,13 +308,13 @@ opencode models --refresh ### run -Pokrenite opencode u neinteraktivnom modu tako što ćete direktno proslijediti prompt. +Pokrenite OpenCode u neinteraktivnom modu tako što ćete direktno proslijediti prompt. ```bash opencode run [message..] ``` -Ovo je korisno za skriptiranje, automatizaciju ili kada želite brz odgovor bez pokretanja punog TUI-ja. Na primjer. +Ovo je korisno za skriptiranje, automatizaciju ili kada želite brz odgovor bez pokretanja punog TUI-ja. Na primjer: ```bash "opencode run" opencode run Explain the use of context in Go @@ -330,11 +330,11 @@ opencode serve opencode run --attach http://localhost:4096 "Explain async/await in JavaScript" ``` -#### Zastave +#### Opcije -| Zastava | Kratko | Opis | +| Opcija | Kratko | Opis | | ------------ | ------ | ------------------------------------------------------------------------ | -| `--command` | | Naredba za pokretanje, koristite poruku za args | +| `--command` | | Naredba za pokretanje, koristite poruku za argumente | | `--continue` | `-c` | Nastavite posljednju sesiju | | `--session` | `-s` | ID sesije za nastavak | | `--fork` | | Forkujte sesiju pri nastavku (koristiti sa `--continue` ili `--session`) | @@ -344,29 +344,29 @@ opencode run --attach http://localhost:4096 "Explain async/await in JavaScript" | `--file` | `-f` | Fajlovi koje treba priložiti poruci | | `--format` | | Format: default (formatiran) ili json (sirovi JSON događaji) | | `--title` | | Naslov sesije (koristi skraćeni prompt ako nije navedena vrijednost) | -| `--attach` | | Priključite na pokrenuti opencode server (npr. http://localhost:4096) | +| `--attach` | | Priključite na pokrenuti OpenCode server (npr. http://localhost:4096) | | `--port` | | Port za lokalni server (zadano na nasumični port) | --- ### serve -Pokrenite OpenCode server bez glave za pristup API-ju. Pogledajte [server docs](/docs/server) za kompletan HTTP interfejs. +Pokrenite OpenCode headless server za API pristup. Pogledajte [server docs](/docs/server) za kompletan HTTP interfejs. ```bash opencode serve ``` -Ovo pokreće HTTP server koji pruža API pristup funkcionalnosti otvorenog koda bez TUI interfejsa. Postavite `OPENCODE_SERVER_PASSWORD` da omogućite HTTP osnovnu auth (korisničko ime je zadano na `opencode`). +Ovo pokreće HTTP server koji pruža API pristup funkcionalnosti OpenCode-a bez TUI interfejsa. Postavite `OPENCODE_SERVER_PASSWORD` da omogućite HTTP osnovnu auth (korisničko ime je zadano na `opencode`). -#### Zastave +#### Opcije -| Zastava | Opis | -| ------------ | ---------------------------------------------------- | -| `--port` | Port za slušanje na | -| `--hostname` | Ime hosta za slušanje | -| `--mdns` | Omogući mDNS otkrivanje | -| `--cors` | Dodatni izvor(a) pretraživača koji dozvoljavaju CORS | +| Opcija | Opis | +| ------------ | ----------------------------------------------------- | +| `--port` | Port na kojem treba slušati | +| `--hostname` | Hostname na kojem treba slušati | +| `--mdns` | Omogući mDNS otkrivanje | +| `--cors` | Dodatni origin(i) pretraživača koji dozvoljavaju CORS | --- @@ -388,12 +388,12 @@ Navedite sve OpenCode sesije. opencode session list ``` -##### Zastave +##### Opcije -| Zastava | Kratko | Opis | -| ------------- | ------ | ----------------------------------------- | -| `--max-count` | `-n` | Ograničenje na N najnovijih sesija | -| `--format` | | Izlazni format: tablica ili json (tabela) | +| Opcija | Kratko | Opis | +| ------------- | ------ | -------------------------------------- | +| `--max-count` | `-n` | Ograničenje na N najnovijih sesija | +| `--format` | | Izlazni format: table ili json (table) | --- @@ -405,14 +405,14 @@ Prikaži statistiku upotrebe tokena i troškova za vaše OpenCode sesije. opencode stats ``` -#### Zastave +#### Opcije -| Zastava | Opis | -| ----------- | ----------------------------------------------------------------------------------------------------------- | -| `--days` | Prikaži statistiku za zadnjih N dana (sva vremena) | -| `--tools` | Broj alata za prikaz (svi) | -| `--models` | Prikaži raščlambu korištenja modela (skriveno prema zadanim postavkama). Proslijedite broj za prikaz vrha N | -| `--project` | Filtriraj po projektu (svi projekti, prazan niz: trenutni projekt) | +| Opcija | Opis | +| ----------- | ---------------------------------------------------------------------------------------------------------- | +| `--days` | Prikaži statistiku za zadnjih N dana (sva vremena) | +| `--tools` | Broj alata za prikaz (svi) | +| `--models` | Prikaži raščlambu korištenja modela (skriveno prema zadanim postavkama). Proslijedite broj za prikaz top N | +| `--project` | Filtriraj po projektu (svi projekti, prazan niz: trenutni projekt) | --- @@ -447,22 +447,22 @@ opencode import https://opncd.ai/s/abc123 ### web -Pokrenite OpenCode server bez glave sa web interfejsom. +Pokrenite OpenCode headless server sa web interfejsom. ```bash opencode web ``` -Ovo pokreće HTTP server i otvara web pretraživač za pristup OpenCode preko web interfejsa. Postavite `OPENCODE_SERVER_PASSWORD` da omogućite HTTP osnovnu auth (korisničko ime je zadano na `opencode`). +Ovo pokreće HTTP server i otvara web pretraživač za pristup OpenCode-u preko web interfejsa. Postavite `OPENCODE_SERVER_PASSWORD` da omogućite HTTP osnovnu auth (korisničko ime je zadano na `opencode`). -#### Zastave +#### Opcije -| Zastava | Opis | -| ------------ | ---------------------------------------------------- | -| `--port` | Port za slušanje na | -| `--hostname` | Ime hosta za slušanje | -| `--mdns` | Omogući mDNS otkrivanje | -| `--cors` | Dodatni izvor(a) pretraživača koji dozvoljavaju CORS | +| Opcija | Opis | +| ------------ | ----------------------------------------------------- | +| `--port` | Port na kojem treba slušati | +| `--hostname` | Hostname na kojem treba slušati | +| `--mdns` | Omogući mDNS otkrivanje | +| `--cors` | Dodatni origin(i) pretraživača koji dozvoljavaju CORS | --- @@ -474,15 +474,15 @@ Pokrenite ACP (Agent Client Protocol) server. opencode acp ``` -Ova komanda pokreće ACP server koji komunicira preko stdin/stdout koristeći nd-JSON. +Ova naredba pokreće ACP server koji komunicira preko stdin/stdout koristeći nd-JSON. -#### Zastave +#### Opcije -| Zastava | Opis | -| ------------ | ------------------- | -| `--cwd` | Radni imenik | -| `--port` | Port za slušanje na | -| `--hostname` | Slušajte ime hosta | +| Opcija | Opis | +| ------------ | --------------------------- | +| `--cwd` | Radni direktorij | +| `--port` | Port na kojem treba slušati | +| `--hostname` | Hostname na kojem slušati | --- @@ -494,12 +494,12 @@ Deinstalirajte OpenCode i uklonite sve povezane datoteke. opencode uninstall ``` -#### Zastave +#### Opcije -| Zastava | Kratko | Opis | +| Opcija | Kratko | Opis | | --------------- | ------ | --------------------------------------------- | -| `--keep-config` | `-c` | Čuvajte konfiguracijske datoteke | -| `--keep-data` | `-d` | Čuvajte podatke i snimke sesije | +| `--keep-config` | `-c` | Sačuvajte konfiguracijske datoteke | +| `--keep-data` | `-d` | Sačuvajte podatke i snimke sesije | | `--dry-run` | | Pokažite šta bi bilo uklonjeno bez uklanjanja | | `--force` | `-f` | Preskoči upite za potvrdu | @@ -507,7 +507,7 @@ opencode uninstall ### upgrade -Ažurira opencode na najnoviju verziju ili određenu verziju. +Ažurira OpenCode na najnoviju verziju ili određenu verziju. ```bash opencode upgrade [target] @@ -525,73 +525,76 @@ Za nadogradnju na određenu verziju. opencode upgrade v0.1.48 ``` -#### Zastave +#### Opcije -| Zastava | Kratko | Opis | +| Opcija | Kratko | Opis | | ---------- | ------ | ------------------------------------------------------- | | `--method` | `-m` | Korišteni način instalacije; curl, npm, pnpm, bun, brew | --- -## Globalne zastave +## Globalne opcije -CLI otvorenog koda uzima sljedeće globalne zastavice. -| Zastava | Kratko | Opis -|-------------- | ----- | ------------------------------------ | -| `--help` | `-h` | Prikaži pomoć | -| `--version` | `-v` | Odštampaj broj verzije | -| `--print-logs` | | Ispis zapisnika u stderr | -| `--log-level` | | Nivo dnevnika (DEBUG, INFO, WARN, ERROR) | +OpenCode CLI prihvata sljedeće globalne zastavice. + +| Opcija | Kratko | Opis | +| -------------- | ------ | ----------------------------------------- | +| `--help` | `-h` | Prikaži pomoć | +| `--version` | `-v` | Ispiši broj verzije | +| `--print-logs` | | Ispis logova u stderr | +| `--log-level` | | Nivo logovanja (DEBUG, INFO, WARN, ERROR) | --- ## Varijable okruženja OpenCode se može konfigurirati pomoću varijabli okruženja. -| Varijabilna | Vrsta | Opis -|------------------------------------- | ------- | ------------------------------------------------- | -| `OPENCODE_AUTO_SHARE` | boolean | Automatski dijeli sesije | -| `OPENCODE_GIT_BASH_PATH` | string | Putanja do Git Bash izvršne datoteke na Windows | -| `OPENCODE_CONFIG` | string | Put do konfiguracionog fajla | -| `OPENCODE_CONFIG_DIR` | string | Put do konfiguracijskog direktorija | -| `OPENCODE_CONFIG_CONTENT` | string | Inline json konfiguracijski sadržaj | -| `OPENCODE_DISABLE_AUTOUPDATE` | boolean | Onemogući automatske provjere ažuriranja | -| `OPENCODE_DISABLE_PRUNE` | boolean | Onemogući orezivanje starih podataka | -| `OPENCODE_DISABLE_TERMINAL_TITLE` | boolean | Onemogući automatsko ažuriranje naslova terminala | -| `OPENCODE_PERMISSION` | string | Umetnuta json konfiguracija dozvola | -| `OPENCODE_DISABLE_DEFAULT_PLUGINS` | boolean | Onemogući podrazumevane dodatke | -| `OPENCODE_DISABLE_LSP_DOWNLOAD` | boolean | Onemogući automatsko preuzimanje LSP servera | -| `OPENCODE_ENABLE_EXPERIMENTAL_MODELS` | boolean | Omogući eksperimentalne modele | -| `OPENCODE_DISABLE_AUTOCOMPACT` | boolean | Onemogući automatsko sažimanje konteksta | -| `OPENCODE_DISABLE_CLAUDE_CODE` | boolean | Onemogući čitanje sa `.claude` (prompt + vještine) | -| `OPENCODE_DISABLE_CLAUDE_CODE_PROMPT` | boolean | Onemogući čitanje `~/.claude/CLAUDE.md` | -| `OPENCODE_DISABLE_CLAUDE_CODE_SKILLS` | boolean | Onemogući učitavanje `.claude/skills` | -| `OPENCODE_DISABLE_MODELS_FETCH` | boolean | Onemogući dohvaćanje modela iz udaljenih izvora | -| `OPENCODE_FAKE_VCS` | string | Lažni VCS provajder za potrebe testiranja | -| `OPENCODE_DISABLE_FILETIME_CHECK` | boolean | Onemogući provjeru vremena datoteke radi optimizacije | -| `OPENCODE_CLIENT` | string | Identifikator klijenta (zadano na `cli`) | -| `OPENCODE_ENABLE_EXA` | boolean | Omogući Exa alate za web pretraživanje | -| `OPENCODE_SERVER_PASSWORD` | string | Omogući osnovnu autorizaciju za `serve`/`web` | -| `OPENCODE_SERVER_USERNAME` | string | Poništi osnovno korisničko ime autentifikacije (zadano `opencode`) | -| `OPENCODE_MODELS_URL` | string | Prilagođeni URL za dohvaćanje konfiguracije modela | + +| Varijabla | Tip | Opis | +| ------------------------------------- | ------- | ------------------------------------------------------------------ | +| `OPENCODE_AUTO_SHARE` | boolean | Automatski dijeli sesije | +| `OPENCODE_GIT_BASH_PATH` | string | Putanja do Git Bash izvršne datoteke na Windows-u | +| `OPENCODE_CONFIG` | string | Putanja do konfiguracijskog fajla | +| `OPENCODE_CONFIG_DIR` | string | Putanja do konfiguracijskog direktorija | +| `OPENCODE_CONFIG_CONTENT` | string | Inline json konfiguracijski sadržaj | +| `OPENCODE_DISABLE_AUTOUPDATE` | boolean | Onemogući automatske provjere ažuriranja | +| `OPENCODE_DISABLE_PRUNE` | boolean | Onemogući brisanje (pruning) starih podataka | +| `OPENCODE_DISABLE_TERMINAL_TITLE` | boolean | Onemogući automatsko ažuriranje naslova terminala | +| `OPENCODE_PERMISSION` | string | Inline json konfiguracija dozvola | +| `OPENCODE_DISABLE_DEFAULT_PLUGINS` | boolean | Onemogući podrazumijevane dodatke (plugins) | +| `OPENCODE_DISABLE_LSP_DOWNLOAD` | boolean | Onemogući automatsko preuzimanje LSP servera | +| `OPENCODE_ENABLE_EXPERIMENTAL_MODELS` | boolean | Omogući eksperimentalne modele | +| `OPENCODE_DISABLE_AUTOCOMPACT` | boolean | Onemogući automatsko sažimanje konteksta | +| `OPENCODE_DISABLE_CLAUDE_CODE` | boolean | Onemogući čitanje iz `.claude` (prompt + vještine) | +| `OPENCODE_DISABLE_CLAUDE_CODE_PROMPT` | boolean | Onemogući čitanje `~/.claude/CLAUDE.md` | +| `OPENCODE_DISABLE_CLAUDE_CODE_SKILLS` | boolean | Onemogući učitavanje `.claude/skills` | +| `OPENCODE_DISABLE_MODELS_FETCH` | boolean | Onemogući dohvaćanje modela iz udaljenih izvora | +| `OPENCODE_FAKE_VCS` | string | Lažni VCS provajder za potrebe testiranja | +| `OPENCODE_DISABLE_FILETIME_CHECK` | boolean | Onemogući provjeru vremena datoteke radi optimizacije | +| `OPENCODE_CLIENT` | string | Identifikator klijenta (zadano na `cli`) | +| `OPENCODE_ENABLE_EXA` | boolean | Omogući Exa alate za web pretraživanje | +| `OPENCODE_SERVER_PASSWORD` | string | Omogući osnovnu autentifikaciju za `serve`/`web` | +| `OPENCODE_SERVER_USERNAME` | string | Poništi osnovno korisničko ime autentifikacije (zadano `opencode`) | +| `OPENCODE_MODELS_URL` | string | Prilagođeni URL za dohvaćanje konfiguracije modela | --- ### Eksperimentalno Ove varijable okruženja omogućavaju eksperimentalne karakteristike koje se mogu promijeniti ili ukloniti. -| Varijabilna | Vrsta | Opis -|----------------------------------------------- | ------- | --------------------------------------- | -| `OPENCODE_EXPERIMENTAL` | boolean | Omogući sve eksperimentalne funkcije | -| `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | boolean | Omogući otkrivanje ikona | -| `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | boolean | Onemogući kopiranje pri odabiru u TUI | -| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | broj | Zadano vremensko ograničenje za bash komande u ms | -| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | broj | Maksimalni izlazni tokeni za LLM odgovore | -| `OPENCODE_EXPERIMENTAL_FILEWATCHER` | boolean | Omogući praćenje datoteka za cijeli dir | -| `OPENCODE_EXPERIMENTAL_OXFMT` | boolean | Omogući oxfmt formatter | -| `OPENCODE_EXPERIMENTAL_LSP_TOOL` | boolean | Omogući eksperimentalni LSP alat | -| `OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER` | boolean | Onemogući praćenje datoteka | -| `OPENCODE_EXPERIMENTAL_EXA` | boolean | Omogući eksperimentalne Exa funkcije | -| `OPENCODE_EXPERIMENTAL_LSP_TY` | boolean | Omogući eksperimentalnu provjeru tipa LSP | -| `OPENCODE_EXPERIMENTAL_MARKDOWN` | boolean | Omogući eksperimentalne Markdown funkcije | -| `OPENCODE_EXPERIMENTAL_PLAN_MODE` | boolean | Omogući režim plana | + +| Varijabla | Tip | Opis | +| ----------------------------------------------- | ------- | ------------------------------------------------- | +| `OPENCODE_EXPERIMENTAL` | boolean | Omogući sve eksperimentalne funkcije | +| `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | boolean | Omogući otkrivanje ikona | +| `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | boolean | Onemogući kopiranje pri odabiru u TUI | +| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | number | Zadano vremensko ograničenje za bash naredbe u ms | +| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | number | Maksimalni izlazni tokeni za LLM odgovore | +| `OPENCODE_EXPERIMENTAL_FILEWATCHER` | boolean | Omogući praćenje datoteka za cijeli direktorij | +| `OPENCODE_EXPERIMENTAL_OXFMT` | boolean | Omogući oxfmt formatter | +| `OPENCODE_EXPERIMENTAL_LSP_TOOL` | boolean | Omogući eksperimentalni LSP alat | +| `OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER` | boolean | Onemogući praćenje datoteka | +| `OPENCODE_EXPERIMENTAL_EXA` | boolean | Omogući eksperimentalne Exa funkcije | +| `OPENCODE_EXPERIMENTAL_LSP_TY` | boolean | Omogući eksperimentalnu provjeru tipa LSP | +| `OPENCODE_EXPERIMENTAL_MARKDOWN` | boolean | Omogući eksperimentalne Markdown funkcije | +| `OPENCODE_EXPERIMENTAL_PLAN_MODE` | boolean | Omogući Plan mod | diff --git a/packages/web/src/content/docs/bs/commands.mdx b/packages/web/src/content/docs/bs/commands.mdx index c4cdc7a55..388a4504b 100644 --- a/packages/web/src/content/docs/bs/commands.mdx +++ b/packages/web/src/content/docs/bs/commands.mdx @@ -13,7 +13,7 @@ Prilagođene komande su dodatak ugrađenim komandama kao što su `/init`, `/undo --- -## Kreirajte komandne fajlove +## Kreiranje datoteka naredbi Kreirajte markdown fajlove u direktorijumu `commands/` da definišete prilagođene komande. Kreiraj `.opencode/commands/test.md`: @@ -38,7 +38,7 @@ Koristite komandu tako što ćete upisati `/` nakon čega slijedi naziv komande. --- -## Konfiguriši +## Konfiguracija Možete dodati prilagođene komande kroz OpenCode konfiguraciju ili kreiranjem markdown datoteka u direktoriju `commands/`. @@ -99,7 +99,7 @@ Ime markdown datoteke postaje ime naredbe. Na primjer, `test.md` vam omogućava --- -## Prompt config +## Konfiguracija upita Promptovi za prilagođene komande podržavaju nekoliko posebnih čuvara mjesta i sintakse. @@ -190,7 +190,7 @@ Naredbe se pokreću u korijenskom direktoriju vašeg projekta i njihov izlaz pos --- -### Reference fajlova +### Reference datoteka Uključite datoteke u svoju naredbu koristeći `@` nakon čega slijedi naziv datoteke. @@ -213,7 +213,7 @@ Pogledajmo detaljno opcije konfiguracije. --- -### Template +### Šablon Opcija `template` definira prompt koji će biti poslan LLM-u kada se naredba izvrši. @@ -269,7 +269,7 @@ Ovo je **opciona** opcija konfiguracije. Ako nije navedeno, podrazumevano je va --- -### Subtask +### Podzadatak Koristite `subtask` boolean da prisilite naredbu da pokrene [subagent](/docs/agents/#subagents) pozivanje. Ovo je korisno ako želite da naredba ne zagađuje vaš primarni kontekst i da će **primorati** agenta da djeluje kao subagent, @@ -307,9 +307,9 @@ Ovo je **opciona** opcija konfiguracije. --- -## Ugrađene +## Ugrađene naredbe -opencode uključuje nekoliko ugrađenih naredbi kao što su `/init`, `/undo`, `/redo`, `/share`, `/help`; [saznaj više](/docs/tui#commands). +OpenCode uključuje nekoliko ugrađenih naredbi kao što su `/init`, `/undo`, `/redo`, `/share`, `/help`; [saznaj više](/docs/tui#commands). :::note Prilagođene komande mogu nadjačati ugrađene komande. ::: diff --git a/packages/web/src/content/docs/bs/config.mdx b/packages/web/src/content/docs/bs/config.mdx index ed79f9f7b..3e20f1890 100644 --- a/packages/web/src/content/docs/bs/config.mdx +++ b/packages/web/src/content/docs/bs/config.mdx @@ -1,5 +1,5 @@ --- -title: Config +title: Konfiguracija description: Korištenje OpenCode JSON konfiguracije. --- @@ -25,10 +25,10 @@ OpenCode podržava i **JSON** i **JSONC** (JSON sa komentarima) formate. ## Lokacije -Možete postaviti svoju konfiguraciju na nekoliko različitih lokacija i one imaju a -drugačiji redosled prioriteta. +Možete postaviti svoju konfiguraciju na nekoliko različitih lokacija i one imaju drugačiji redoslijed prioriteta. + :::note -Konfiguracijski fajlovi su **spojeni zajedno**, a ne zamijenjeni. +Konfiguracijski fajlovi se **spajaju**, ne zamjenjuju. ::: Konfiguracijski fajlovi se spajaju, ne zamjenjuju. Kombiniraju se postavke sa sljedećih konfiguracijskih lokacija. Kasnije konfiguracije poništavaju prethodne samo za konfliktne ključeve. Nekonfliktne postavke iz svih konfiguracija su sačuvane. Na primjer, ako vaša globalna konfiguracija postavlja `theme: "opencode"` i `autoupdate: true`, a vaša projektna konfiguracija postavlja `model: "anthropic/claude-sonnet-4-5"`, konačna konfiguracija će uključivati ​​sve tri postavke. @@ -39,12 +39,13 @@ Na primjer, ako vaša globalna konfiguracija postavlja `theme: "opencode"` i `au Izvori konfiguracije se učitavaju ovim redoslijedom (kasniji izvori poništavaju ranije): -1. **Udaljena konfiguracija** (od `.well-known/opencode`) - organizacione postavke +1. **Udaljena konfiguracija** (od `.well-known/opencode`) - organizacijske postavke 2. **Globalna konfiguracija** (`~/.config/opencode/opencode.json`) - korisničke postavke -3. **Prilagođena konfiguracija** (`OPENCODE_CONFIG` env var) - prilagođena zaobilaženja +3. **Prilagođena konfiguracija** (`OPENCODE_CONFIG` env var) - prilagođena preinačenja 4. **Konfiguracija projekta** (`opencode.json` u projektu) - postavke specifične za projekat 5. **`.opencode` direktoriji** - agenti, komande, dodaci -6. **Inline config** (`OPENCODE_CONFIG_CONTENT` env var) - runtime nadjačava +6. **Inline konfiguracija** (`OPENCODE_CONFIG_CONTENT` env var) - runtime preinačenja + To znači da konfiguracije projekta mogu nadjačati globalne zadane postavke, a globalne konfiguracije mogu nadjačati postavke udaljene organizacije. :::note Direktoriji `.opencode` i `~/.config/opencode` koriste **imena u množini** za poddirektorije: `agents/`, `commands/`, `modes/`, `plugins/`, `skills/`, `tools/` i `themes/`. Pojedinačna imena (npr. `agent/`) su također podržana za kompatibilnost unatrag. @@ -52,9 +53,9 @@ Izvori konfiguracije se učitavaju ovim redoslijedom (kasniji izvori poništavaj --- -### Daljinski +### Udaljeno (Remote) -Organizacije mogu pružiti zadanu konfiguraciju preko `.well-known/opencode` krajnje točke. Ovo se automatski preuzima kada se autentifikujete kod provajdera koji to podržava. +Organizacije mogu pružiti zadanu konfiguraciju preko `.well-known/opencode` krajnje tačke. Ovo se automatski preuzima kada se autentifikujete kod provajdera koji to podržava. Prvo se učitava udaljena konfiguracija koja služi kao osnovni sloj. Svi ostali izvori konfiguracije (globalni, projektni) mogu nadjačati ove zadane postavke. Na primjer, ako vaša organizacija nudi MCP servere koji su po defaultu onemogućeni: @@ -86,14 +87,14 @@ Možete omogućiti određene servere u vašoj lokalnoj konfiguraciji: --- -### Global +### Globalno Postavite svoju globalnu OpenCode konfiguraciju u `~/.config/opencode/opencode.json`. Koristite globalnu konfiguraciju za korisničke preferencije kao što su teme, provajderi ili veze tipki. Globalna konfiguracija poništava zadane postavke udaljene organizacije. --- -### Project +### Projekt Dodajte `opencode.json` u korijen projekta. Konfiguracija projekta ima najveći prioritet među standardnim konfiguracijskim datotekama - ona nadjačava globalne i udaljene konfiguracije. :::tip @@ -104,7 +105,7 @@ Ovo je također sigurno provjeriti u Git i koristi istu shemu kao globalna. --- -### Custom config +### Prilagođena konfiguracija Navedite prilagođenu putanju konfiguracijske datoteke koristeći varijablu okruženja `OPENCODE_CONFIG`. @@ -117,12 +118,9 @@ Prilagođena konfiguracija se učitava između globalne i projektne konfiguracij --- -### Custom directory +### Prilagođeni direktorij -Navedite prilagođeni konfiguracijski direktorij koristeći `OPENCODE_CONFIG_DIR` -varijabla okruženja. U ovom direktoriju će se tražiti agenti, komande, -modove i dodatke baš kao standardni `.opencode` direktorij, i trebali bi -prate istu strukturu. +Navedite prilagođeni konfiguracijski direktorij koristeći `OPENCODE_CONFIG_DIR` varijablu okruženja. U ovom direktoriju će se tražiti agenti, komande, modovi i dodaci baš kao standardni `.opencode` direktorij, i trebali bi pratiti istu strukturu. ```bash export OPENCODE_CONFIG_DIR=/path/to/my/config-directory @@ -133,10 +131,10 @@ Prilagođeni direktorij se učitava nakon direktorija globalne konfiguracije i ` --- -## Shema +## Šema Konfiguracijski fajl ima šemu koja je definirana u [**`opencode.ai/config.json`**](https://opencode.ai/config.json). -Vaš uređivač bi trebao biti u mogućnosti da potvrdi i autodovršava na osnovu šeme. +Vaš editor bi trebao biti u mogućnosti da validira i autodovršava na osnovu šeme. --- @@ -162,13 +160,13 @@ Dostupne opcije: - `scroll_acceleration.enabled` - Omogući ubrzanje skrolovanja u macOS stilu. **Ima prednost nad `scroll_speed`.** - `scroll_speed` - Prilagođeni množitelj brzine pomicanja (podrazumevano: `3`, minimalno: `1`). Zanemareno ako je `scroll_acceleration.enabled` `true`. - `diff_style` - Kontrola prikaza razlike. `"auto"` se prilagođava širini terminala, `"stacked"` uvijek prikazuje jednu kolonu. - [Ovdje saznajte više o korištenju TUI](/docs/tui). + [Saznajte više o korištenju TUI](/docs/tui) ovdje. --- ### Server -Možete konfigurirati postavke servera za komande `opencode serve` i `opencode web` putem opcije `server`. +Možete konfigurirati postavke servera za naredbe `opencode serve` i `opencode web` putem opcije `server`. ```json title="opencode.json" { @@ -186,15 +184,15 @@ Možete konfigurirati postavke servera za komande `opencode serve` i `opencode w Dostupne opcije: - `port` - Port za slušanje. -- `hostname` - Ime hosta za slušanje. Kada je `mdns` omogućen i nije postavljeno ime hosta, podrazumevano je `0.0.0.0`. -- `mdns` - Omogući otkrivanje mDNS usluge. Ovo omogućava drugim uređajima na mreži da otkriju vaš OpenCode server. -- `mdnsDomain` - Prilagođeno ime domene za mDNS uslugu. Zadano je `opencode.local`. Korisno za pokretanje više instanci na istoj mreži. -- `cors` - Dodatni izvori koji omogućavaju CORS kada koristite HTTP server iz klijenta baziranog na pretraživaču. Vrijednosti moraju biti punog porijekla (šema + host + opcijski port), npr. `https://app.example.com`. +- `hostname` - Hostname za slušanje. Kada je `mdns` omogućen i nije postavljeno ime hosta, podrazumevano je `0.0.0.0`. +- `mdns` - Omogući mDNS otkrivanje servisa. Ovo omogućava drugim uređajima na mreži da otkriju vaš OpenCode server. +- `mdnsDomain` - Prilagođeno ime domene za mDNS servis. Zadano je `opencode.local`. Korisno za pokretanje više instanci na istoj mreži. +- `cors` - Dodatni origini koji omogućavaju CORS kada koristite HTTP server iz klijenta baziranog na pretraživaču. Vrijednosti moraju biti puni origin (shema + host + opcijski port), npr. `https://app.example.com`. [Saznajte više o serveru](/docs/server) ovdje. --- -### Tools +### Alati Možete upravljati alatima koje LLM može koristiti putem opcije `tools`. @@ -244,7 +242,7 @@ Opcije provajdera mogu uključivati ​​`timeout` i `setCacheKey`: - `timeout` - Vrijeme čekanja zahtjeva u milisekundama (podrazumevano: 300000). Postavite na `false` da onemogućite. - `setCacheKey` - Osigurajte da je ključ keš memorije uvijek postavljen za određenog provajdera. - Također možete konfigurirati [lokalni modeli](/docs/models#local). [Saznajte više](/docs/models). + Također možete konfigurirati [lokalne modele](/docs/models#local). [Saznajte više](/docs/models). --- @@ -272,8 +270,8 @@ Amazon Bedrock podržava konfiguraciju specifičnu za AWS: ``` - `region` - AWS regija za Bedrock (zadano na `AWS_REGION` env var ili `us-east-1`) -- `profile` - AWS imenovan profil od `~/.aws/credentials` (podrazumevano na `AWS_PROFILE` env var) -- `endpoint` - URL prilagođene krajnje tačke za VPC krajnje tačke. Ovo je pseudonim za generičku opciju `baseURL` koristeći terminologiju specifičnu za AWS. Ako su oba navedena, `endpoint` ima prednost. +- `profile` - AWS imenovani profil iz `~/.aws/credentials` (zadano na `AWS_PROFILE` env var) +- `endpoint` - URL prilagođene krajnje tačke za VPC krajnje tačke. Ovo je alias za generičku opciju `baseURL` koristeći terminologiju specifičnu za AWS. Ako su oba navedena, `endpoint` ima prednost. :::note Tokeni nosioca (`AWS_BEARER_TOKEN_BEDROCK` ili `/connect`) imaju prednost nad autentifikacijom zasnovanom na profilu. Pogledajte [prednost autentifikacije](/docs/providers#authentication-precedence) za detalje. ::: @@ -281,7 +279,7 @@ Amazon Bedrock podržava konfiguraciju specifičnu za AWS: --- -### Theme +### Tema Možete konfigurirati temu koju želite koristiti u svojoj OpenCode konfiguraciji putem opcije `theme`. @@ -333,7 +331,7 @@ Možete postaviti zadanog agenta koristeći opciju `default_agent`. Ovo određuj } ``` -Zadani agent mora biti primarni agent (ne podagent). Ovo može biti ugrađeni agent kao što je `"build"` ili `"plan"`, ili [prilagođeni agent](/docs/agents) koji ste definirali. Ako navedeni agent ne postoji ili je subagent, OpenCode će se vratiti na `"build"` s upozorenjem. +Zadani agent mora biti primarni agent (ne podagent). Ovo može biti ugrađeni agent kao što je `"build"` ili `"plan"`, ili [prilagođeni agent](/docs/agents) koji ste definirali. Ako navedeni agent ne postoji ili je podagent, OpenCode će se vratiti na `"build"` s upozorenjem. Ova postavka se primjenjuje na sva sučelja: TUI, CLI (`opencode run`), desktop aplikaciju i GitHub Action. --- @@ -349,18 +347,18 @@ Možete konfigurirati funkciju [share](/docs/share) putem opcije `share`. } ``` -Ovo traje: +Ovo prihvata: -- `"manual"` - Dozvoli ručno dijeljenje putem komandi (podrazumevano) +- `"manual"` - Dozvoli ručno dijeljenje putem naredbi (podrazumevano) - `"auto"` - Automatski dijelite nove razgovore - `"disabled"` - Onemogući dijeljenje u potpunosti Podrazumevano, dijeljenje je postavljeno na ručni način rada gdje trebate eksplicitno dijeliti razgovore pomoću naredbe `/share`. --- -### Command +### Naredbe -Možete konfigurirati prilagođene komande za ponavljanje zadataka putem opcije `command`. +Možete konfigurirati prilagođene naredbe za ponavljanje zadataka putem opcije `command`. ```jsonc title="opencode.jsonc" { @@ -380,13 +378,13 @@ Možete konfigurirati prilagođene komande za ponavljanje zadataka putem opcije } ``` -Također možete definirati komande koristeći markdown fajlove u `~/.config/opencode/commands/` ili `.opencode/commands/`. [Saznajte više ovdje](/docs/commands). +Također možete definirati naredbe koristeći markdown fajlove u `~/.config/opencode/commands/` ili `.opencode/commands/`. [Saznajte više ovdje](/docs/commands). --- -### Keybinds +### Prečice tipki -Možete prilagoditi svoje veze ključeva putem opcije `keybinds`. +Možete prilagoditi svoje veze tipki putem opcije `keybinds`. ```json title="opencode.json" { @@ -415,7 +413,7 @@ Imajte na umu da ovo funkcionira samo ako nije instalirano pomoću upravitelja p --- -### Formatters +### Formateri Možete konfigurirati formatere koda putem opcije `formatter`. @@ -437,13 +435,13 @@ Možete konfigurirati formatere koda putem opcije `formatter`. } ``` -[Saznajte više o formatterima](/docs/formatters) ovdje. +[Saznajte više o formaterima](/docs/formatters) ovdje. --- ### Dozvole -Prema zadanim postavkama, opencode **dopušta sve operacije** bez potrebe za eksplicitnim dopuštenjem. Ovo možete promijeniti koristeći opciju `permission`. +Prema zadanim postavkama, OpenCode **dopušta sve operacije** bez potrebe za eksplicitnim dopuštenjem. Ovo možete promijeniti koristeći opciju `permission`. Na primjer, da osigurate da alati `edit` i `bash` zahtijevaju odobrenje korisnika: ```json title="opencode.json" @@ -456,11 +454,11 @@ Na primjer, da osigurate da alati `edit` i `bash` zahtijevaju odobrenje korisnik } ``` -[Ovdje saznajte više o ](/docs/permissions) dozvolama. +[Saznajte više o dozvolama](/docs/permissions) ovdje. --- -### Compaction +### Sažimanje Možete kontrolirati ponašanje sažimanja konteksta putem opcije `compaction`. @@ -479,7 +477,7 @@ Možete kontrolirati ponašanje sažimanja konteksta putem opcije `compaction`. --- -### Watcher +### Promatrač (Watcher) Možete konfigurirati obrasce ignoriranja promatrača datoteka putem opcije `watcher`. @@ -511,7 +509,7 @@ Možete konfigurirati MCP servere koje želite koristiti putem opcije `mcp`. --- -### Extras +### Dodaci [Plugins](/docs/plugins) proširuju OpenCode sa prilagođenim alatima, kukicama i integracijama. Postavite datoteke dodataka u `.opencode/plugins/` ili `~/.config/opencode/plugins/`. Također možete učitati dodatke iz npm-a preko opcije `plugin`. @@ -538,8 +536,7 @@ Možete konfigurirati upute za model koji koristite putem opcije `instructions`. } ``` -Ovo uzima niz putanja i uzoraka globusa do datoteka instrukcija. [Saznajte više -o pravilima ovdje](/docs/rules). +Ovo uzima niz putanja i glob uzoraka do datoteka instrukcija. [Saznajte više o pravilima ovdje](/docs/rules). --- @@ -560,7 +557,7 @@ Možete onemogućiti dobavljače koji se automatski učitavaju preko opcije `dis Opcija `disabled_providers` prihvata niz ID-ova provajdera. Kada je provajder onemogućen: - Neće se učitati čak i ako su varijable okruženja postavljene. -- Neće se učitati čak i ako su API ključevi konfigurirani putem `/connect` komande. +- Neće se učitati čak i ako su API ključevi konfigurirani putem `/connect` naredbe. - Modeli dobavljača se neće pojaviti na listi za odabir modela. --- @@ -576,7 +573,7 @@ Možete odrediti listu dozvoljenih dobavljača putem opcije `enabled_providers`. } ``` -Ovo je korisno kada želite da ograničite OpenCode da koristi samo određene provajdere umesto da ih onemogućavate jednog po jednog. +Ovo je korisno kada želite da ograničite OpenCode da koristi samo određene provajdere umjesto da ih onemogućavate jednog po jednog. :::note `disabled_providers` ima prioritet nad `enabled_providers`. ::: @@ -607,7 +604,7 @@ Možete koristiti zamjenu varijabli u vašim konfiguracijskim datotekama da bist --- -### Env vars +### Varijable okruženja Koristite `{env:VARIABLE_NAME}` za zamjenu varijabli okruženja: @@ -630,7 +627,7 @@ Ako varijabla okruženja nije postavljena, bit će zamijenjena praznim nizom. --- -### Fajlovi +### Datoteke Koristite `{file:path/to/file}` da zamijenite sadržaj fajla: diff --git a/packages/web/src/content/docs/bs/custom-tools.mdx b/packages/web/src/content/docs/bs/custom-tools.mdx index 81fa9ea8c..e452ce6a5 100644 --- a/packages/web/src/content/docs/bs/custom-tools.mdx +++ b/packages/web/src/content/docs/bs/custom-tools.mdx @@ -1,5 +1,5 @@ --- -title: Custom Tools +title: Prilagođeni alati description: Kreirajte alate koje LLM može pozvati u otvorenom kodu. --- @@ -133,7 +133,7 @@ Koristite `context.worktree` za korijen git radnog stabla. ## Primjeri -### Napišite alat u Python-u +### Pisanje alata u Python-u Možete pisati svoje alate na bilo kom jeziku koji želite. Evo primjera koji zbraja dva broja koristeći Python. Prvo kreirajte alat kao Python skriptu: diff --git a/packages/web/src/content/docs/bs/enterprise.mdx b/packages/web/src/content/docs/bs/enterprise.mdx index a817ddafb..5851498ae 100644 --- a/packages/web/src/content/docs/bs/enterprise.mdx +++ b/packages/web/src/content/docs/bs/enterprise.mdx @@ -1,5 +1,5 @@ --- -title: Enterprise +title: Za preduzeća description: Sigurno korištenje OpenCode u vašoj organizaciji. --- @@ -19,7 +19,7 @@ Da započnete s OpenCode Enterprise: --- -## Trial +## Proba OpenCode je otvorenog koda i ne pohranjuje vaš kod niti kontekstualne podatke, tako da vaši developeri mogu jednostavno [započeti](/docs/) i provesti probu. @@ -60,19 +60,19 @@ Preporučujemo da ovo onemogućite tokom probe. --- -## Pricing +## Cijene Koristimo model naplate po sjedištu za OpenCode Enterprise. Ako imate vlastiti LLM gateway, ne naplaćujemo korištene tokene. Za više detalja o cijenama i opcijama implementacije, **kontaktirajte nas**. --- -## Deployment +## Postavljanje Nakon što završite probni period i spremni ste koristiti OpenCode u svojoj organizaciji, možete **kontaktirati nas** da razgovaramo o cijenama i opcijama implementacije. --- -### Central Config +### Centralna konfiguracija Možemo postaviti OpenCode da koristi jednu centralnu konfiguraciju za cijelu organizaciju. @@ -96,7 +96,7 @@ Također možete onemogućiti sve druge AI provajdere, čime osiguravate da svi --- -### Self-hosting +### Samostalno hostovanje Iako preporučujemo onemogućavanje share stranica kako biste osigurali da podaci nikada ne napuštaju vašu organizaciju, možemo vam pomoći i da ih samostalno hostujete na vlastitoj infrastrukturi. @@ -104,17 +104,17 @@ Ovo je trenutno na našoj mapi puta. Ako ste zainteresovani, **j --- -## FAQ +## Često postavljana pitanja
-What is OpenCode Enterprise? +Šta je OpenCode Enterprise? OpenCode Enterprise je za organizacije koje žele osigurati da njihov kod i podaci nikada ne napuštaju njihovu infrastrukturu. To omogućava centralizovana konfiguracija koja se integriše s vašim SSO-om i internim AI gateway-om.
-How do I get started with OpenCode Enterprise? +Kako započeti s OpenCode Enterprise? Jednostavno započnite internu probu sa svojim timom. OpenCode po defaultu ne pohranjuje vaš kod ni kontekstualne podatke, što olakšava početak. @@ -123,21 +123,21 @@ Zatim **kontaktirajte nas** da razgovaramo o cijenama i opci
-How does enterprise pricing work? +Kako funkcionišu enterprise cijene? Nudimo enterprise cijene po sjedištu. Ako imate vlastiti LLM gateway, ne naplaćujemo korištene tokene. Za više detalja, **kontaktirajte nas** za prilagođenu ponudu prema potrebama vaše organizacije.
-Is my data secure with OpenCode Enterprise? +Jesu li moji podaci sigurni uz OpenCode Enterprise? Da. OpenCode ne pohranjuje vaš kod niti kontekstualne podatke. Sva obrada se odvija lokalno ili putem direktnih API poziva vašem AI provajderu. Uz centralnu konfiguraciju i SSO integraciju, vaši podaci ostaju sigurni unutar infrastrukture vaše organizacije.
-Can we use our own private NPM registry? +Možemo li koristiti vlastiti privatni NPM registar? OpenCode podržava privatne npm registre kroz Bunovu izvornu podršku za `.npmrc` datoteku. Ako vaša organizacija koristi privatni registar, kao što je JFrog Artifactory, Nexus ili slično, osigurajte da su developeri autentifikovani prije pokretanja OpenCode. diff --git a/packages/web/src/content/docs/bs/formatters.mdx b/packages/web/src/content/docs/bs/formatters.mdx index 015d20d80..1b70e0906 100644 --- a/packages/web/src/content/docs/bs/formatters.mdx +++ b/packages/web/src/content/docs/bs/formatters.mdx @@ -1,5 +1,5 @@ --- -title: Formatters +title: Formateri description: OpenCode koristi formatere specifične za jezik. --- @@ -7,7 +7,7 @@ OpenCode automatski formatira datoteke nakon što su napisane ili uređene pomo --- -## Ugrađeno +## Ugrađeni OpenCode dolazi sa nekoliko ugrađenih formatera za popularne jezike i okvire. Ispod je lista formatera, podržanih ekstenzija datoteka i naredbi ili opcija konfiguracije koje su mu potrebne. | Formatter | Ekstenzije | Zahtjevi @@ -49,7 +49,7 @@ Kada OpenCode piše ili uređuje datoteku, on: --- -## Konfiguriši +## Konfiguracija Možete prilagoditi formatere kroz `formatter` odjeljak u vašoj OpenCode konfiguraciji. diff --git a/packages/web/src/content/docs/bs/github.mdx b/packages/web/src/content/docs/bs/github.mdx index ff31be8e3..5946b3442 100644 --- a/packages/web/src/content/docs/bs/github.mdx +++ b/packages/web/src/content/docs/bs/github.mdx @@ -7,7 +7,7 @@ OpenCode se integriše sa vašim GitHub tokovom rada. Spomenite `/opencode` ili --- -## Karakteristike +## Funkcije - **Problemi trijaže**: Zamolite OpenCode da ispita problem i objasni vam ga. - **Popravi i implementiraj**: Zamolite OpenCode da popravi problem ili implementira funkciju. I radit će u novoj poslovnici i dostavljati PR sa svim promjenama. @@ -244,7 +244,7 @@ Za `issues` događaje, `prompt` unos je **potreban** jer nema komentara za izvla --- -## Prilagođene upite +## Prilagođeni upiti Zaobiđite zadani prompt da biste prilagodili ponašanje OpenCode za vaš tok posla. diff --git a/packages/web/src/content/docs/bs/gitlab.mdx b/packages/web/src/content/docs/bs/gitlab.mdx index aea7cbf8f..a819ef5fd 100644 --- a/packages/web/src/content/docs/bs/gitlab.mdx +++ b/packages/web/src/content/docs/bs/gitlab.mdx @@ -15,7 +15,7 @@ Ovdje koristimo CI/CD komponentu kreiranu u zajednici za OpenCode — [nagyv/git --- -### Karakteristike +### Funkcije - **Koristite prilagođenu konfiguraciju po poslu**: Konfigurirajte OpenCode s prilagođenim konfiguracijskim direktorijem, na primjer `./config/#custom-directory` da omogućite ili onemogućite funkcionalnost po OpenCode pozivanju. - **Minimalno podešavanje**: CI komponenta postavlja OpenCode u pozadini, samo trebate kreirati OpenCode konfiguraciju i početnu prompt. @@ -49,7 +49,7 @@ Spomenite `@opencode` u komentaru i OpenCode će izvršiti zadatke unutar vašeg --- -### Karakteristike +### Funkcije - **Problemi trijaže**: Zamolite OpenCode da ispita problem i objasni vam ga. - **Popravi i implementiraj**: Zamolite OpenCode da popravi problem ili implementira funkciju. @@ -74,7 +74,7 @@ Pogledajte [**GitLab dokumente**](https://docs.gitlab.com/user/duo_agent_platfor
- Flow configuration + Konfiguracija toka ```yaml image: node:22-slim diff --git a/packages/web/src/content/docs/bs/ide.mdx b/packages/web/src/content/docs/bs/ide.mdx index 07af96dcd..a455b91ee 100644 --- a/packages/web/src/content/docs/bs/ide.mdx +++ b/packages/web/src/content/docs/bs/ide.mdx @@ -7,7 +7,7 @@ OpenCode se integriše sa VS kodom, Cursor-om ili bilo kojim IDE-om koji podrža --- -## Upotreba +## Korištenje - **Brzo pokretanje**: Koristite `Cmd+Esc` (Mac) ili `Ctrl+Esc` (Windows/Linux) da otvorite OpenCode u prikazu podijeljenog terminala ili fokusirajte postojeću terminalsku sesiju ako je već pokrenuta. - **Nova sesija**: Koristite `Cmd+Shift+Esc` (Mac) ili `Ctrl+Shift+Esc` (Windows/Linux) da započnete novu OpenCode terminalsku sesiju, čak i ako je ona već otvorena. Takođe možete kliknuti na dugme OpenCode u korisničkom sučelju. diff --git a/packages/web/src/content/docs/bs/index.mdx b/packages/web/src/content/docs/bs/index.mdx index 5eff901ef..5d21e994f 100644 --- a/packages/web/src/content/docs/bs/index.mdx +++ b/packages/web/src/content/docs/bs/index.mdx @@ -1,13 +1,13 @@ --- -title: Intro -description: Započnite s OpenCode. +title: Uvod +description: Započnite sa OpenCode. --- import { Tabs, TabItem } from "@astrojs/starlight/components" import config from "../../../../config.mjs" export const console = config.console -[**OpenCode**](/) je agent za AI kodiranje otvorenog koda. Dostupan je kao interfejs baziran na terminalu, desktop aplikacija ili IDE ekstenzija. +[**OpenCode**](/) je AI agent za kodiranje otvorenog koda. Dostupan je kao interfejs baziran na terminalu, desktop aplikacija ili IDE ekstenzija. ![OpenCode TUI sa opencode temom](../../../assets/lander/screenshot.png) Hajde da počnemo. @@ -18,17 +18,17 @@ Hajde da počnemo. Da biste koristili OpenCode u svom terminalu, trebat će vam: 1. Moderan emulator terminala kao što su: - - [WezTerm](https://wezterm.org), multi-platforma - - [Alacritty](https://alacritty.org), više platforma + - [WezTerm](https://wezterm.org), više platformi + - [Alacritty](https://alacritty.org), više platformi - [Ghostty](https://ghostty.org), Linux i macOS - [Kitty](https://sw.kovidgoyal.net/kitty/), Linux i macOS 2. API ključevi za LLM provajdere koje želite koristiti. --- -## Instaliraj +## Instalacija -Najlakši način za instaliranje OpenCode je putem instalacione skripte. +Najlakši način za instaliranje OpenCode je putem instalacijske skripte. ```bash curl -fsSL https://opencode.ai/install | bash @@ -36,7 +36,7 @@ curl -fsSL https://opencode.ai/install | bash Također ga možete instalirati pomoću sljedećih naredbi: -- **Korišćenje Node.js** +- **Korištenje Node.js** @@ -70,7 +70,7 @@ Također ga možete instalirati pomoću sljedećih naredbi: -- **Korišćenje Homebrew-a na macOS-u i Linux-u** +- **Korištenje Homebrew-a na macOS-u i Linux-u** ```bash brew install anomalyco/tap/opencode @@ -78,7 +78,7 @@ Također ga možete instalirati pomoću sljedećih naredbi: > Preporučujemo korištenje OpenCode tap za najnovija izdanja. Službenu formulu `brew install opencode` održava Homebrew tim i ažurira se rjeđe. -- **Korišćenje Parua na Arch Linuxu** +- **Korištenje Parua na Arch Linuxu** ```bash paru -S opencode-bin @@ -87,16 +87,16 @@ Također ga možete instalirati pomoću sljedećih naredbi: #### Windows :::tip[Preporučeno: Koristite WSL] -Za najbolje iskustvo na Windows-u preporučujemo korištenje [Windows Subsystem for Linux (WSL)](/docs/windows-wsl). Pruža bolje performanse i potpunu kompatibilnost sa OpenCode karakteristikama. +Za najbolje iskustvo na Windows-u preporučujemo korištenje [Windows Subsystem for Linux (WSL)](/docs/windows-wsl). Pruža bolje performanse i potpunu kompatibilnost sa OpenCode funkcijama. ::: -- **Upotreba Chocolatey-a** +- **Korištenje Chocolatey-a** ```bash choco install opencode ``` -- **Upotreba Scoop-a** +- **Korištenje Scoop-a** ```bash scoop install opencode @@ -108,13 +108,13 @@ Za najbolje iskustvo na Windows-u preporučujemo korištenje [Windows Subsystem npm install -g opencode-ai ``` -- **Korišćenje Mise** +- **Korištenje Mise** ```bash mise use -g github:anomalyco/opencode ``` -- **Korišćenje Dockera** +- **Korištenje Dockera** ```bash docker run -it --rm ghcr.io/anomalyco/opencode @@ -125,12 +125,11 @@ Također možete preuzeti binarnu datoteku iz [Releases](https://github.com/anom --- -## Konfiguriši +## Konfiguracija Uz OpenCode možete koristiti bilo kojeg LLM provajdera tako što ćete konfigurirati njihove API ključeve. Ako ste tek počeli koristiti LLM provajdere, preporučujemo korištenje [OpenCode Zen](/docs/zen). -To je kurirana lista modela koji su testirani i verifikovani od strane OpenCode -tim. +To je kurirana lista modela koji su testirani i verifikovani od strane OpenCode tima. 1. Pokrenite naredbu `/connect` u TUI-u, odaberite opencode i idite na [opencode.ai/auth](https://opencode.ai/auth). @@ -152,10 +151,9 @@ Alternativno, možete odabrati jednog od drugih provajdera. [Saznajte više](/do --- -## Inicijaliziraj +## Inicijalizacija -Sada kada ste konfigurisali provajdera, možete se kretati do projekta koji -na čemu želite da radite. +Sada kada ste konfigurisali provajdera, možete se kretati do projekta na kojem želite raditi. ```bash cd /path/to/project @@ -173,26 +171,22 @@ Zatim inicijalizirajte OpenCode za projekat pokretanjem sljedeće naredbe. /init ``` -Ovo će omogućiti OpenCode da analizira vaš projekat i kreira `AGENTS.md` fajl u njemu -korijen projekta. +Ovo će omogućiti OpenCode da analizira vaš projekat i kreira `AGENTS.md` fajl u korijenu projekta. :::tip -Trebali biste urezati datoteku `AGENTS.md` vašeg projekta u Git. +Trebali biste komitovati datoteku `AGENTS.md` vašeg projekta u Git. ::: -Ovo pomaže OpenCode da razumije strukturu projekta i obrasce kodiranja -korišteno. +Ovo pomaže OpenCode da razumije strukturu projekta i obrasce kodiranja koji se koriste. --- -## Upotreba +## Korištenje -Sada ste spremni da koristite OpenCode za rad na svom projektu. Slobodno pitajte -bilo šta! -Ako ste novi u korištenju agenta za AI kodiranje, evo nekoliko primjera koji bi mogli -pomoć. +Sada ste spremni da koristite OpenCode za rad na svom projektu. Slobodno pitajte bilo šta! +Ako ste novi u korištenju agenta za AI kodiranje, evo nekoliko primjera koji bi mogli pomoći. --- -### Postavljajte pitanja +### Postavljanje pitanja Možete zamoliti OpenCode da vam objasni kodnu bazu. :::tip @@ -207,13 +201,12 @@ Ovo je korisno ako postoji dio kodne baze na kojem niste radili. --- -### Dodajte karakteristike +### Dodavanje funkcija Možete zamoliti OpenCode da vašem projektu doda nove funkcije. Iako preporučujemo da ga prvo zamolite da napravi plan. 1. **Kreirajte plan** - OpenCode ima _Plan mod_ koji onemogućuje njegovu sposobnost da pravi promjene i - umjesto toga predložite _kako_ će implementirati ovu funkciju. + OpenCode ima _Plan mod_ koji onemogućuje njegovu sposobnost da pravi promjene i umjesto toga predlaže _kako_ će implementirati ovu funkciju. Prebacite se na njega pomoću tipke **Tab**. Vidjet ćete indikator za ovo u donjem desnom uglu. ```bash frame="none" title="Switch to Plan mode" @@ -223,35 +216,31 @@ Možete zamoliti OpenCode da vašem projektu doda nove funkcije. Iako preporuču Hajde sada da opišemo šta želimo da uradi. ```txt frame="none" - 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. + 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. ``` -Želite da date OpenCode dovoljno detalja da razumete šta želite. Pomaže -da razgovarate s njim kao da razgovarate sa mlađim programerom u svom timu. +Želite da date OpenCode dovoljno detalja da razumije šta želite. Pomaže da razgovarate s njim kao da razgovarate sa mlađim programerom u svom timu. :::tip -Dajte OpenCode dosta konteksta i primjera koji će mu pomoći da razumije šta vi -želim. +Dajte OpenCode dosta konteksta i primjera koji će mu pomoći da razumije šta vi želite. ::: 2. **Ponovite plan** Kada vam da plan, možete mu dati povratne informacije ili dodati više detalja. ```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. + 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 Prevucite i ispustite slike u terminal da biste ih dodali u prompt. ::: -OpenCode može skenirati sve slike koje mu date i dodati ih u prompt. Možeš -učinite to povlačenjem i ispuštanjem slike u terminal. +OpenCode može skenirati sve slike koje mu date i dodati ih u prompt. Možete to učiniti povlačenjem i ispuštanjem slike u terminal. 3. **Izgradite funkciju** - Kada se osjećate ugodno s planom, vratite se na _Build mode_ do - ponovnim pritiskom na taster **Tab**. + Kada se osjećate ugodno s planom, vratite se na _Build mode_ ponovnim pritiskom na taster **Tab**. ```bash frame="none" @@ -265,10 +254,9 @@ I tražeći od njega da napravi promjene. --- -### Napravite promjene +### Pravljenje izmjena -Za jednostavnije promjene, možete zamoliti OpenCode da ga direktno izgradi -bez potrebe da prvo pregledate plan. +Za jednostavnije promjene, možete zamoliti OpenCode da ga direktno izgradi bez potrebe da prvo pregledate plan. ```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 @@ -276,12 +264,11 @@ handled in the /notes route in @packages/functions/src/notes.ts and implement the same logic in @packages/functions/src/settings.ts ``` -Želite da budete sigurni da ste pružili dobru količinu detalja kako bi OpenCode bio ispravan -promjene. +Želite da budete sigurni da ste pružili dobru količinu detalja kako bi OpenCode napravio ispravne promjene. --- -### Poništi promjene +### Poništavanje izmjena Recimo da tražite od OpenCode da izvrši neke promjene. @@ -289,15 +276,13 @@ Recimo da tražite od OpenCode da izvrši neke promjene. Can you refactor the function in @packages/functions/src/api/index.ts? ``` -Ali shvatate da to nije ono što ste želeli. Možete **poništiti** promjene -koristeći naredbu `/undo`. +Ali shvatate da to nije ono što ste željeli. Možete **poništiti** promjene koristeći naredbu `/undo`. ```bash frame="none" /undo ``` -OpenCode će sada poništiti promjene koje ste napravili i prikazati vašu originalnu poruku -opet. +OpenCode će sada poništiti promjene koje ste napravili i ponovo prikazati vašu originalnu poruku. ```txt frame="none" "@packages/functions/src/api/index.ts" Can you refactor the function in @packages/functions/src/api/index.ts? @@ -315,10 +300,9 @@ Ili **možete ponoviti** promjene koristeći naredbu `/redo`. --- -## Dijeli +## Dijeljenje -Razgovore koje imate sa OpenCode možete [dijeliti sa vašim -tim](/docs/share). +Razgovore koje imate sa OpenCode možete [dijeliti sa vašim timom](/docs/share). ```bash frame="none" /share @@ -332,7 +316,7 @@ Evo [primjer razgovora](https://opencode.ai/s/4XP1fce5) sa OpenCode. --- -## Prilagodi +## Prilagođavanje I to je to! Sada ste profesionalac u korištenju OpenCode. Da biste to učinili svojim, preporučujemo [odabir teme](/docs/themes), [prilagođavanje povezivanja tipki](/docs/keybinds), [konfiguriranje formatera koda](/docs/formatters), [kreiranje prilagođenih komandi](/docs/commands), ili igranje sa [OpenCode config](/docs/config). diff --git a/packages/web/src/content/docs/bs/keybinds.mdx b/packages/web/src/content/docs/bs/keybinds.mdx index 3efc240c1..f35dd3852 100644 --- a/packages/web/src/content/docs/bs/keybinds.mdx +++ b/packages/web/src/content/docs/bs/keybinds.mdx @@ -1,9 +1,9 @@ --- -title: Keybinds -description: Prilagodite svoje veze dugmadi. +title: Prečice tipki +description: Prilagodite svoje veze tipki. --- -OpenCode ima listu veza ključeva koje možete prilagoditi preko OpenCode konfiguracije. +OpenCode ima listu veza tipki koje možete prilagoditi preko OpenCode konfiguracije. ```json title="opencode.json" { @@ -105,15 +105,15 @@ OpenCode ima listu veza ključeva koje možete prilagoditi preko OpenCode konfig --- -## Leader key +## Leader tipka -OpenCode koristi `leader` ključ za većinu povezivanja tipki. Ovo izbjegava sukobe u vašem terminalu. -Prema zadanim postavkama, `ctrl+x` je vodeći taster i većina radnji zahtijeva da prvo pritisnete vodeći taster, a zatim i prečicu. Na primjer, da biste započeli novu sesiju, prvo pritisnite `ctrl+x`, a zatim pritisnite `n`. -Ne morate koristiti vodeći ključ za svoje veze tipki, ali preporučujemo da to učinite. +OpenCode koristi `leader` (vodeću) tipku za većinu povezivanja tipki. Ovo izbjegava sukobe u vašem terminalu. +Prema zadanim postavkama, `ctrl+x` je vodeća tipka i većina radnji zahtijeva da prvo pritisnete vodeću tipku, a zatim i prečicu. Na primjer, da biste započeli novu sesiju, prvo pritisnite `ctrl+x`, a zatim pritisnite `n`. +Ne morate koristiti vodeću tipku za svoje veze tipki, ali preporučujemo da to učinite. --- -## Onemogući povezivanje tastera +## Onemogućavanje prečica tipki Možete onemogućiti spajanje tipki dodavanjem ključa u svoju konfiguraciju s vrijednošću "none". @@ -130,21 +130,22 @@ Možete onemogućiti spajanje tipki dodavanjem ključa u svoju konfiguraciju s v ## Prečice za radnu površinu -Unos prompta aplikacije OpenCode za desktop podržava uobičajene prečice u stilu Readline/Emacs za uređivanje teksta. Oni su ugrađeni i trenutno se ne mogu konfigurirati putem `opencode.json`. -| Prečica | Akcija -|-------- | ---------------------------------------- | -| `ctrl+a` | Prelazak na početak tekućeg reda | -| `ctrl+e` | Prelazak na kraj trenutnog reda | -| `ctrl+b` | Pomeri kursor za jedan znak unazad | -| `ctrl+f` | Pomicanje kursora naprijed za jedan znak | -| `alt+b` | Pomeri kursor za jednu reč unazad | -| `alt+f` | Pomeri kursor za jednu reč unapred | -| `ctrl+d` | Izbriši znak ispod kursora | -| `ctrl+k` | Kill do kraja reda | -| `ctrl+u` | Kill do početka reda | -| `ctrl+w` | Kill prethodnu riječ | -| `alt+d` | Kill sljedeću riječ | -| `ctrl+t` | Transponirajte znakove | +Unos prompta aplikacije OpenCode za desktop podržava uobičajene prečice u stilu Readline/Emacs za uređivanje teksta. One su ugrađene i trenutno se ne mogu konfigurirati putem `opencode.json`. + +| Prečica | Akcija | +| -------- | ------------------------------------------------ | +| `ctrl+a` | Prelazak na početak trenutnog reda | +| `ctrl+e` | Prelazak na kraj trenutnog reda | +| `ctrl+b` | Pomjeri kursor za jedan znak unazad | +| `ctrl+f` | Pomicanje kursora naprijed za jedan znak | +| `alt+b` | Pomjeri kursor za jednu riječ unazad | +| `alt+f` | Pomjeri kursor za jednu riječ unaprijed | +| `ctrl+d` | Izbriši znak ispod kursora | +| `ctrl+k` | Kill do kraja reda | +| `ctrl+u` | Kill do početka reda | +| `ctrl+w` | Kill prethodnu riječ | +| `alt+d` | Kill sljedeću riječ | +| `ctrl+t` | Transponirajte znakove | | `ctrl+g` | Otkaži iskakanje / poništi odgovor na pokretanje | --- @@ -153,7 +154,7 @@ Unos prompta aplikacije OpenCode za desktop podržava uobičajene prečice u sti Neki terminali ne šalju modifikatorske tipke sa Enter prema zadanim postavkama. Možda ćete trebati konfigurirati svoj terminal da pošalje `Shift+Enter` kao escape sekvencu. -### Windows terminal +### Windows Terminal Otvorite svoj `settings.json` na: diff --git a/packages/web/src/content/docs/bs/lsp.mdx b/packages/web/src/content/docs/bs/lsp.mdx index 1eebd1fc2..463d9a0ad 100644 --- a/packages/web/src/content/docs/bs/lsp.mdx +++ b/packages/web/src/content/docs/bs/lsp.mdx @@ -5,7 +5,7 @@ description: OpenCode se integriše sa vašim LSP serverima. OpenCode se integriše sa vašim Language Server Protocol (LSP) serverima kako bi pomogao LLM-u u interakciji s kodnom bazom. Koristi dijagnostiku za slanje povratnih informacija modelu. -## Ugrađeno +## Ugrađeni OpenCode dolazi sa nekoliko ugrađenih LSP servera za popularne jezike: | LSP server | Ekstenzije | Zahtjevi @@ -58,7 +58,7 @@ Kada opencode otvori fajl, on: --- -## Konfiguriši +## Konfiguracija Možete prilagoditi LSP servere kroz `lsp` odjeljak u vašoj opencode konfiguraciji. diff --git a/packages/web/src/content/docs/bs/mcp-servers.mdx b/packages/web/src/content/docs/bs/mcp-servers.mdx index 693efc2dd..b516bcec0 100644 --- a/packages/web/src/content/docs/bs/mcp-servers.mdx +++ b/packages/web/src/content/docs/bs/mcp-servers.mdx @@ -8,7 +8,7 @@ Jednom dodani, MCP alati su automatski dostupni LLM-u zajedno sa ugrađenim alat --- -#### Upozorenja +#### Upozorenje Kada koristite MCP server, on dodaje u kontekst. Ovo se može brzo zbrojiti ako imate puno alata. Stoga preporučujemo da pazite koje MCP servere koristite. :::tip @@ -17,7 +17,7 @@ MCP serveri dodaju vaš kontekst, tako da želite da budete pažljivi s tim koje Određeni MCP serveri, poput GitHub MCP servera, mogu dodati mnogo tokena i lako premašiti limit konteksta. -## Omogući +## Omogućavanje Možete definirati MCP servere u vašoj [OpenCode Config](https://opencode.ai/docs/config/) pod `mcp`. Dodajte svaki MCP sa jedinstvenim imenom. Možete se pozvati na taj MCP po imenu kada tražite LLM. @@ -38,7 +38,7 @@ Možete definirati MCP servere u vašoj [OpenCode Config](https://opencode.ai/do Također možete onemogućiti server postavljanjem `enabled` na `false`. To je korisno kada ga želite privremeno isključiti bez uklanjanja iz konfiguracije. -### Poništavanje daljinskih zadanih postavki +### Poništavanje udaljenih zadanih postavki Organizacije mogu obezbijediti zadane MCP servere preko svoje krajnje tačke `.well-known/opencode`. Ovi serveri mogu biti onemogućeni prema zadanim postavkama, omogućavajući korisnicima da se odluče za one koji su im potrebni. Da omogućite određeni server iz udaljene konfiguracije vaše organizacije, dodajte ga u svoju lokalnu konfiguraciju sa `enabled: true`: @@ -115,7 +115,7 @@ Ovdje su sve opcije za konfiguriranje lokalnog MCP servera. --- -## Daljinski +## Udaljeno Dodajte udaljene MCP servere postavljanjem `type` na `"remote"`. @@ -178,7 +178,7 @@ Za većinu MCP servera sa omogućenim OAuthom nije potrebna posebna konfiguracij Ako server zahtijeva autentifikaciju, OpenCode će vas tražiti prijavu pri prvom korištenju. Ako se to ne desi, možete [ručno pokrenuti tok](#authenticating) naredbom `opencode mcp auth `. -### Prethodno registrovano +### Prethodno registrirano Ako imate klijentske vjerodajnice od dobavljača MCP servera, možete ih konfigurirati: @@ -269,11 +269,11 @@ opencode mcp debug my-oauth-server Komanda `mcp debug` prikazuje trenutni auth status, testira HTTP povezanost i pokušava OAuth discovery flow. -## Manage +## Upravljanje Vaši MCP serveri su dostupni kao alati u OpenCode, zajedno s ugrađenim alatima. Možete njima upravljati kroz OpenCode konfiguraciju kao i bilo kojim drugim alatom. -### Global +### Globalno To znači da ih možete omogućiti ili onemogućiti globalno. diff --git a/packages/web/src/content/docs/bs/models.mdx b/packages/web/src/content/docs/bs/models.mdx index 9ad9f96ed..b6099740b 100644 --- a/packages/web/src/content/docs/bs/models.mdx +++ b/packages/web/src/content/docs/bs/models.mdx @@ -12,7 +12,7 @@ Saznajte više o [providers](/docs/providers). --- -## Odaberite model +## Odabir modela Nakon što konfigurirate svog provajdera, možete odabrati model koji želite upisivanjem: @@ -41,7 +41,7 @@ Evo nekoliko modela koji dobro rade sa OpenCode, bez posebnog redosleda. (Ovo ni --- -## Postavite zadano +## Postavljanje zadanog Da postavite jedan od ovih kao zadani model, možete postaviti ključ `model` u svom OpenCode config. @@ -58,7 +58,7 @@ Ako ste konfigurirali [prilagođenog provajdera](/docs/providers#custom), `provi --- -## Konfigurišite modele +## Konfiguracija modela Možete globalno konfigurirati opcije modela kroz config. @@ -180,7 +180,7 @@ Možete nadjačati postojeće varijante ili dodati svoje: } ``` -### Cycle variants +### Kruženje kroz varijante Koristite keybind `variant_cycle` za brzo prebacivanje između varijanti. [Saznajte više](/docs/keybinds). diff --git a/packages/web/src/content/docs/bs/modes.mdx b/packages/web/src/content/docs/bs/modes.mdx index 1be564878..9cff5d584 100644 --- a/packages/web/src/content/docs/bs/modes.mdx +++ b/packages/web/src/content/docs/bs/modes.mdx @@ -15,7 +15,7 @@ Možete se prebacivati ​​između režima tokom sesije ili ih konfigurisati u --- -## Ugrađeno +## Ugrađeni opencode dolazi sa dva ugrađena načina rada. @@ -42,7 +42,7 @@ Vidi također: [Formatters](/docs/formatters) za informacije o konfiguraciji for --- -## Konfiguriši +## Konfiguracija Možete prilagoditi ugrađene načine rada ili kreirati vlastite kroz konfiguraciju. Modovi se mogu konfigurirati na dva načina: @@ -166,7 +166,7 @@ Vrijednosti temperature obično se kreću od 0,0 do 1,0: Ako temperatura nije navedena, opencode koristi podrazumijevane postavke specifične za model (obično 0 za većinu modela i 0.55 za Qwen modele). -### Prompt +### Upit Navedite prilagođenu sistemsku datoteku prompta za ovaj način rada s konfiguracijom `prompt`. Datoteka s promptom treba da sadrži upute specifične za svrhu načina rada. diff --git a/packages/web/src/content/docs/bs/network.mdx b/packages/web/src/content/docs/bs/network.mdx index 7c926b8fc..aa2133284 100644 --- a/packages/web/src/content/docs/bs/network.mdx +++ b/packages/web/src/content/docs/bs/network.mdx @@ -5,7 +5,7 @@ description: Konfigurirajte proksije i prilagođene certifikate. OpenCode podržava standardne proxy varijable okruženja i prilagođene certifikate za enterprise mrežna okruženja. -## Proxy +## Proksi OpenCode poštuje standardne varijable proxy okruženja. diff --git a/packages/web/src/content/docs/bs/permissions.mdx b/packages/web/src/content/docs/bs/permissions.mdx index 7f657a6b9..8b2061ee0 100644 --- a/packages/web/src/content/docs/bs/permissions.mdx +++ b/packages/web/src/content/docs/bs/permissions.mdx @@ -141,7 +141,7 @@ Dozvole OpenCode su označene imenom alata, plus nekoliko sigurnosnih mjera: --- -## Defaults +## Zadane postavke Ako ništa ne navedete, OpenCode počinje od dozvoljenih zadanih vrijednosti: @@ -164,7 +164,7 @@ Ako ništa ne navedete, OpenCode počinje od dozvoljenih zadanih vrijednosti: --- -## Šta radi “Ask”. +## Šta radi “Ask” Kada OpenCode zatraži odobrenje, korisničko sučelje nudi tri ishoda: diff --git a/packages/web/src/content/docs/bs/plugins.mdx b/packages/web/src/content/docs/bs/plugins.mdx index bd526f8e6..9b7e9f12b 100644 --- a/packages/web/src/content/docs/bs/plugins.mdx +++ b/packages/web/src/content/docs/bs/plugins.mdx @@ -1,5 +1,5 @@ --- -title: Plugins +title: Dodaci description: Napišite vlastite dodatke za proširenje OpenCode. --- @@ -8,7 +8,7 @@ Za primjere, pogledajte [plugins](/docs/ecosystem#plugins) kreirane od strane za --- -## Koristite dodatak +## Korištenje dodatka Postoje dva načina za učitavanje dodataka. @@ -22,7 +22,7 @@ Postavite JavaScript ili TypeScript datoteke u direktorij dodataka. --- -### Od npm +### Iz npm-a Navedite npm pakete u vašoj konfiguracijskoj datoteci. @@ -45,7 +45,7 @@ Pregledajte dostupne dodatke u [ecosystem](/docs/ecosystem#plugins). --- -### Učitaj redoslijed +### Redoslijed učitavanja Dodaci se učitavaju iz svih izvora i svi zakačnjaci rade u nizu. Redoslijed učitavanja je: @@ -57,7 +57,7 @@ Dodaci se učitavaju iz svih izvora i svi zakačnjaci rade u nizu. Redoslijed u --- -## Kreirajte dodatak +## Kreiranje dodatka Dodatak je **JavaScript/TypeScript modul** koji izvozi jedan ili više dodataka funkcije. Svaka funkcija prima objekt konteksta i vraća hooks objekt. @@ -154,14 +154,14 @@ Dodaci se mogu pretplatiti na događaje kao što je prikazano ispod u odjeljku P - `lsp.client.diagnostics` - `lsp.updated` -#### Poruka Događaji +#### Događaji poruka - `message.part.removed` - `message.part.updated` - `message.removed` - `message.updated` -#### Događaji dozvole +#### Događaji dozvola - `permission.asked` - `permission.replied` @@ -189,7 +189,7 @@ Dodaci se mogu pretplatiti na događaje kao što je prikazano ispod u odjeljku P - `shell.env` -#### Alat Događaji +#### Događaji alata - `tool.execute.after` - `tool.execute.before` @@ -206,7 +206,7 @@ Dodaci se mogu pretplatiti na događaje kao što je prikazano ispod u odjeljku P Evo nekoliko primjera dodataka koje možete koristiti za proširenje OpenCode. -### Šalji obavještenja +### Slanje obavještenja Pošaljite obavještenja kada se dogode određeni događaji: @@ -248,7 +248,7 @@ export const EnvProtection = async ({ project, client, $, directory, worktree }) --- -### Ubacite varijable okruženja +### Ubacivanje varijabli okruženja Ubacite varijable okruženja u sva izvršavanja ljuske (AI alati i korisnički terminali): @@ -299,7 +299,7 @@ Pomoćnik `tool` kreira prilagođeni alat koji opencode može pozvati. Uzima fun --- -### Logging +### Bilježenje Koristite `client.app.log()` umjesto `console.log` za strukturirano bilježenje: @@ -318,7 +318,7 @@ export const MyPlugin = async ({ client }) => { Nivoi su: `debug`, `info`, `warn`, `error`. Pogledajte [SDK dokumentaciju](https://opencode.ai/docs/sdk) za detalje. -### Kuke za sabijanje +### Kuke za sažimanje Prilagodite kontekst uključen kada se sesija zbije: diff --git a/packages/web/src/content/docs/bs/providers.mdx b/packages/web/src/content/docs/bs/providers.mdx index 6e0d38acc..2415cda27 100644 --- a/packages/web/src/content/docs/bs/providers.mdx +++ b/packages/web/src/content/docs/bs/providers.mdx @@ -15,14 +15,14 @@ Za dodavanje provajdera potrebno je: --- -### Akreditacije +### Vjerodajnice Kada dodate API ključeve dobavljača sa naredbom `/connect`, oni se pohranjuju u `~/.local/share/opencode/auth.json`. --- -### Config +### Konfiguracija Možete prilagoditi dobavljače putem odjeljka `provider` u vašem OpenCode config. @@ -84,7 +84,7 @@ Radi kao i svaki drugi provajder u OpenCode i potpuno je opcionalan za korišten --- -## Directory +## Direktorij Pogledajmo neke od provajdera detaljno. Ako želite dodati provajdera na listu, slobodno otvori PR. @@ -135,7 +135,7 @@ Da biste koristili Amazon Bedrock s OpenCode: 2. **Konfigurirajte autentifikaciju** koristeći jedan od sljedećih metoda: - #### Varijable okruženja (brzi početak) + #### Varijable okruženja (Brzi početak) Postavite jednu od ovih varijabli okruženja dok pokrećete opencode: @@ -157,7 +157,7 @@ Ili ih dodajte na svoj bash profil: export AWS_REGION=us-east-1 ``` -#### Konfiguracijski fajl (preporučeno) +#### Konfiguracijski fajl (Preporučeno) Za konfiguraciju specifičnu za projekat ili trajnu konfiguraciju, koristite `opencode.json`: @@ -689,7 +689,7 @@ da pohrani token u opencode auth memoriju. ##### Samostalni GitLab -:::note[compliance note] +:::note[Napomena o usklađenosti] OpenCode koristi mali model za neke AI zadatke kao što je generiranje naslova sesije. Podrazumevano je konfigurisan da koristi gpt-5-nano, a hostuje ga Zen. Da zaključate OpenCode da biste koristili samo svoju vlastitu instancu koju hostuje GitLab, dodajte sljedeće u svoju @@ -1889,7 +1889,7 @@ Ako imate problema s konfiguracijom provajdera, provjerite sljedeće: Ovo se ne odnosi na dobavljače kao što je Amazon Bedrock, koji se oslanjaju na varijable okruženja za svoju autentifikaciju. -2. Za prilagođene provajdere, provjerite konfiguraciju otvorenog koda i: +2. Za prilagođene provajdere, provjerite OpenCode konfiguraciju i: - Uvjerite se da ID provajdera korišten u naredbi `/connect` odgovara ID-u u vašoj opencode konfiguraciji. - Za provajdera se koristi pravi npm paket. Na primjer, koristite `@ai-sdk/cerebras` za Cerebras. A za sve ostale OpenAI kompatibilne provajdere, koristite `@ai-sdk/openai-compatible`. - Provjerite da li se ispravna krajnja tačka API-ja koristi u polju `options.baseURL`. diff --git a/packages/web/src/content/docs/bs/rules.mdx b/packages/web/src/content/docs/bs/rules.mdx index 0d2e2c8f4..3d186a045 100644 --- a/packages/web/src/content/docs/bs/rules.mdx +++ b/packages/web/src/content/docs/bs/rules.mdx @@ -96,7 +96,7 @@ Prva pronadena datoteka pobjeduje u svakoj kategoriji. Na primjer, ako imate i ` --- -## Prilagodena uputstva +## Prilagođena uputstva Mozete navesti prilagodene datoteke uputstava u `opencode.json` ili globalnom `~/.config/opencode/opencode.json`. Tako vi i tim ponovo koristite postojeca pravila bez dupliranja u AGENTS.md. @@ -128,7 +128,7 @@ Sve datoteke uputstava se kombinuju sa vasim `AGENTS.md` datotekama. Iako opencode ne parsira automatski reference datoteka u `AGENTS.md`, slicno ponasanje mozete dobiti na dva nacina: -### Koristenje opencode.json +### Korištenje opencode.json Preporuceni pristup je da koristite `instructions` polje u `opencode.json`: @@ -139,7 +139,7 @@ Preporuceni pristup je da koristite `instructions` polje u `opencode.json`: } ``` -### Rucna uputstva u AGENTS.md +### Ručna uputstva u AGENTS.md Mozete nauciti opencode da cita eksterne datoteke tako sto cete dati eksplicitna uputstva u `AGENTS.md`. Evo prakticnog primjera: diff --git a/packages/web/src/content/docs/bs/sdk.mdx b/packages/web/src/content/docs/bs/sdk.mdx index f6ee20c9c..fe6ab4ef1 100644 --- a/packages/web/src/content/docs/bs/sdk.mdx +++ b/packages/web/src/content/docs/bs/sdk.mdx @@ -13,7 +13,7 @@ Koristite ga za izradu integracija i programsko upravljanje opencode-om. --- -## Install +## Instalacija Instalirajte SDK sa npm-a: @@ -23,7 +23,7 @@ npm install @opencode-ai/sdk --- -## Create client +## Kreiranje klijenta Kreirajte instancu opencode: @@ -35,7 +35,7 @@ const { client } = await createOpencode() Ovo pokrece i server i klijent -#### Options +#### Opcije | Opcija | Tip | Opis | Default | | ---------- | ------------- | ----------------------------- | ----------- | @@ -47,7 +47,7 @@ Ovo pokrece i server i klijent --- -## Config +## Konfiguracija Mozete proslijediti konfiguracijski objekat za prilagodavanje ponasanja. Instanca i dalje ucitava `opencode.json`, ali konfiguraciju mozete nadjacati ili dodati inline: @@ -67,7 +67,7 @@ console.log(`Server running at ${opencode.server.url}`) opencode.server.close() ``` -## Client only +## Samo klijent Ako vec imate pokrenutu opencode instancu, mozete napraviti klijentsku instancu i povezati se na nju: @@ -79,7 +79,7 @@ const client = createOpencodeClient({ }) ``` -#### Options +#### Opcije | Opcija | Tip | Opis | Default | | --------------- | ---------- | --------------------------------- | ----------------------- | @@ -91,7 +91,7 @@ const client = createOpencodeClient({ --- -## Types +## Tipovi SDK ukljucuje TypeScript definicije za sve API tipove. Uvezite ih direktno: @@ -103,7 +103,7 @@ Svi tipovi su generisani iz OpenAPI specifikacije servera i dostupni u ] [--hostname ] [--cors ] ``` -#### Options +#### Opcije | Zastava | Opis | Default | | --------------- | ----------------------------------- | ---------------- | @@ -34,7 +34,7 @@ opencode serve --cors http://localhost:5173 --cors https://app.example.com --- -### Authentication +### Autentifikacija Postavite `OPENCODE_SERVER_PASSWORD` da zastitite server HTTP basic auth mehanizmom. Korisnicko ime je po defaultu `opencode`, ili postavite `OPENCODE_SERVER_USERNAME` za nadjacavanje. Ovo vazi i za `opencode serve` i za `opencode web`. @@ -44,7 +44,7 @@ OPENCODE_SERVER_PASSWORD=your-password opencode serve --- -### How it works +### Kako radi Kada pokrenete `opencode`, pokrecu se TUI i server. TUI je klijent koji komunicira sa serverom. Server izlaže OpenAPI 3.1 spec endpoint koji se koristi i za generisanje [SDK-a](/docs/sdk). @@ -58,7 +58,7 @@ Mozete pokrenuti `opencode serve` da startate standalone server. Ako je opencode --- -#### Connect to an existing server +#### Povezivanje na postojeći server Kada pokrenete TUI, port i hostname se nasumicno dodijele. Umjesto toga, mozete zadati `--hostname` i `--port` [zastave](/docs/cli), pa se povezati na taj server. @@ -66,7 +66,7 @@ Endpoint [`/tui`](#tui) mozete koristiti za upravljanje TUI-jem kroz server. Na --- -## Spec +## Specifikacija Server objavljuje OpenAPI 3.1 specifikaciju koju mozete vidjeti na: @@ -78,13 +78,13 @@ Na primjer, `http://localhost:4096/doc`. Koristite specifikaciju da generisete k --- -## APIs +## API-ji opencode server izlaže sljedece API-je. --- -### Global +### Globalno | Metoda | Putanja | Opis | Odgovor | | ------ | ---------------- | ------------------------------ | ------------------------------------ | @@ -93,7 +93,7 @@ opencode server izlaže sljedece API-je. --- -### Project +### Projekt | Metoda | Putanja | Opis | Odgovor | | ------ | ------------------ | ----------------------- | --------------------------------------------- | @@ -102,7 +102,7 @@ opencode server izlaže sljedece API-je. --- -### Path & VCS +### Putanja i VCS | Metoda | Putanja | Opis | Odgovor | | ------ | ------- | ------------------------------------ | ------------------------------------------- | @@ -111,7 +111,7 @@ opencode server izlaže sljedece API-je. --- -### Instance +### Instanca | Metoda | Putanja | Opis | Odgovor | | ------ | ------------------- | ---------------------------- | --------- | @@ -119,7 +119,7 @@ opencode server izlaže sljedece API-je. --- -### Config +### Konfiguracija | Metoda | Putanja | Opis | Odgovor | | ------- | ------------------- | --------------------------------- | ---------------------------------------------------------------------------------------- | @@ -129,7 +129,7 @@ opencode server izlaže sljedece API-je. --- -### Provider +### Provajder | Metoda | Putanja | Opis | Odgovor | | ------ | -------------------------------- | ------------------------------------ | ----------------------------------------------------------------------------------- | @@ -140,7 +140,7 @@ opencode server izlaže sljedece API-je. --- -### Sessions +### Sesije | Metoda | Putanja | Opis | Napomene | | -------- | ---------------------------------------- | ------------------------------------- | ---------------------------------------------------------------------------------- | @@ -165,7 +165,7 @@ opencode server izlaže sljedece API-je. --- -### Messages +### Poruke | Metoda | Putanja | Opis | Napomene | | ------ | --------------------------------- | --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -178,7 +178,7 @@ opencode server izlaže sljedece API-je. --- -### Commands +### Naredbe | Metoda | Putanja | Opis | Odgovor | | ------ | ---------- | ----------------- | --------------------------------------------- | @@ -186,7 +186,7 @@ opencode server izlaže sljedece API-je. --- -### Files +### Datoteke | Metoda | Putanja | Opis | Odgovor | | ------ | ------------------------ | ---------------------------------- | ------------------------------------------------------------------------------------------- | @@ -197,17 +197,17 @@ opencode server izlaže sljedece API-je. | `GET` | `/file/content?path=

` | Read a file | FileContent | | `GET` | `/file/status` | Get status for tracked files | File[] | -#### `/find/file` query parameters +#### `/find/file` parametri upita -- `query` (required) — search string (fuzzy match) -- `type` (optional) — limit results to `"file"` or `"directory"` -- `directory` (optional) — override the project root for the search -- `limit` (optional) — max results (1–200) -- `dirs` (optional) — legacy flag (`"false"` returns only files) +- `query` (obavezno) — niz za pretragu (fuzzy podudaranje) +- `type` (opcionalno) — ograniči rezultate na `"file"` ili `"directory"` +- `directory` (opcionalno) — nadjačaj korijen projekta za pretragu +- `limit` (opcionalno) — maksimalni rezultati (1–200) +- `dirs` (opcionalno) — zastarjela zastavica (`"false"` vraća samo datoteke) --- -### Tools (Experimental) +### Alati (Eksperimentalno) | Metoda | Putanja | Opis | Odgovor | | ------ | ------------------------------------------- | ---------------------------------------- | -------------------------------------------- | @@ -216,7 +216,7 @@ opencode server izlaže sljedece API-je. --- -### LSP, Formatters & MCP +### LSP, Formateri & MCP | Metoda | Putanja | Opis | Odgovor | | ------ | ------------ | -------------------------- | -------------------------------------------------------- | @@ -227,7 +227,7 @@ opencode server izlaže sljedece API-je. --- -### Agents +### Agenti | Metoda | Putanja | Opis | Odgovor | | ------ | -------- | ------------------------- | ------------------------------------------- | @@ -235,7 +235,7 @@ opencode server izlaže sljedece API-je. --- -### Logging +### Bilježenje | Metoda | Putanja | Opis | Odgovor | | ------ | ------- | ------------------------------------------------------------ | --------- | @@ -261,7 +261,7 @@ opencode server izlaže sljedece API-je. --- -### Auth +### Autentifikacija | Metoda | Putanja | Opis | Odgovor | | ------ | ----------- | --------------------------------------------------------------- | --------- | @@ -269,7 +269,7 @@ opencode server izlaže sljedece API-je. --- -### Events +### Događaji | Metoda | Putanja | Opis | Odgovor | | ------ | -------- | ----------------------------------------------------------------------------- | ------------------------- | @@ -277,7 +277,7 @@ opencode server izlaže sljedece API-je. --- -### Docs +### Dokumentacija | Metoda | Putanja | Opis | Odgovor | | ------ | ------- | ------------------------- | --------------------------- | diff --git a/packages/web/src/content/docs/bs/share.mdx b/packages/web/src/content/docs/bs/share.mdx index 43959d16b..a15e15074 100644 --- a/packages/web/src/content/docs/bs/share.mdx +++ b/packages/web/src/content/docs/bs/share.mdx @@ -21,13 +21,13 @@ Kada podijelite razgovor, OpenCode: --- -## Sharing +## Dijeljenje OpenCode podrzava tri nacina dijeljenja koji odreduju kako se razgovori dijele: --- -### Manual (default) +### Ručno (zadano) Po defaultu, OpenCode koristi rucni nacin dijeljenja. Sesije se ne dijele automatski, ali ih mozete rucno podijeliti komandom `/share`: @@ -48,7 +48,7 @@ Da eksplicitno postavite rucni nacin u [config datoteci](/docs/config): --- -### Auto-share +### Automatsko dijeljenje Mozete ukljuciti automatsko dijeljenje za sve nove razgovore tako sto `share` postavite na `"auto"` u [config datoteci](/docs/config): @@ -63,7 +63,7 @@ Kada je auto-share ukljucen, svaki novi razgovor se automatski dijeli i kreira s --- -### Disabled +### Onemogućeno Dijeljenje mozete potpuno iskljuciti tako sto `share` postavite na `"disabled"` u [config datoteci](/docs/config): @@ -96,7 +96,7 @@ Imajte na umu nekoliko stvari prije dijeljenja razgovora. --- -### Cuvanje podataka +### Čuvanje podataka Dijeljeni razgovori ostaju dostupni dok ih eksplicitno ne uklonite iz dijeljenja. Ovo ukljucuje: diff --git a/packages/web/src/content/docs/bs/skills.mdx b/packages/web/src/content/docs/bs/skills.mdx index 3c5b21cde..655dc9d10 100644 --- a/packages/web/src/content/docs/bs/skills.mdx +++ b/packages/web/src/content/docs/bs/skills.mdx @@ -1,5 +1,5 @@ --- -title: "Skills agenata" +title: Vještine agenata description: "Definisite ponasanje koje se moze ponovo koristiti" --- @@ -31,7 +31,7 @@ Globalne definicije se takoder ucitavaju iz `~/.config/opencode/skills/*/SKILL.m --- -## Napisite frontmatter +## Pisanje frontmatter-a Svaki `SKILL.md` mora poceti YAML frontmatter-om. Prepoznaju se samo ova polja: @@ -64,14 +64,14 @@ Ekvivalentni regex: --- -## Pratite pravila duzine +## Pravila dužine `description` mora imati 1-1024 karaktera. Neka bude dovoljno precizan da agent moze pravilno odabrati. --- -## Koristite primjer +## Primjer Kreirajte `.opencode/skills/git-release/SKILL.md` ovako: @@ -100,7 +100,7 @@ Ask clarifying questions if the target versioning scheme is unclear. --- -## Prepoznajte opis alata +## Opis alata OpenCode navodi dostupne skills u opisu `skill` alata. Svaki unos sadrzi naziv i opis skill-a: @@ -122,7 +122,7 @@ skill({ name: "git-release" }) --- -## Konfigurisite dozvole +## Konfiguracija dozvola Kontrolisite kojim skills agenti mogu pristupiti pomocu dozvola baziranih na obrascima u `opencode.json`: @@ -149,7 +149,7 @@ Obrasci podrzavaju wildcard znakove: `internal-*` poklapa `internal-docs`, `inte --- -## Nadjacajte po agentu +## Nadjačavanje po agentu Dajte odredenim agentima drugacije dozvole od globalnih defaulta. @@ -181,7 +181,7 @@ permission: --- -## Iskljucite skill alat +## Isključivanje skill alata Potpuno iskljucite skills za agente koji ih ne bi trebali koristiti: @@ -212,7 +212,7 @@ Kada je iskljuceno, sekcija `` se potpuno izostavlja. --- -## Rjesavanje problema s ucitavanjem +## Rješavanje problema s učitavanjem Ako se skill ne pojavi: diff --git a/packages/web/src/content/docs/bs/themes.mdx b/packages/web/src/content/docs/bs/themes.mdx index 0364e1b31..a513e5a20 100644 --- a/packages/web/src/content/docs/bs/themes.mdx +++ b/packages/web/src/content/docs/bs/themes.mdx @@ -21,7 +21,7 @@ Bez truecolor podrske, teme mogu imati slabiju preciznost boja ili pasti na najb --- -## Ugradene teme +## Ugrađene teme OpenCode dolazi sa vise ugradenih tema. @@ -59,7 +59,7 @@ System tema je za korisnike koji: --- -## Koristenje teme +## Korištenje teme Temu mozete izabrati preko selektora tema komandom `/theme`. Mozete je navesti i u [configu](/docs/config). @@ -72,7 +72,7 @@ Temu mozete izabrati preko selektora tema komandom `/theme`. Mozete je navesti i --- -## Prilagodene teme +## Prilagođene teme OpenCode podrzava fleksibilan sistem tema baziran na JSON-u koji olaksava kreiranje i prilagodavanje tema. @@ -111,7 +111,7 @@ vim .opencode/themes/my-theme.json --- -### JSON format +### JSON struktura Teme koriste fleksibilan JSON format koji podrzava: @@ -129,7 +129,7 @@ Sekcija `defs` je opcionalna i omogucava da definisete boje koje se mogu ponovo --- -### Terminalski defaulti +### Terminalske zadane vrijednosti Specijalna vrijednost `"none"` moze se koristiti za bilo koju boju da naslijedi defaultnu boju terminala. Ovo je korisno za teme koje se prirodno uklapaju u semu boja terminala: @@ -138,7 +138,7 @@ Specijalna vrijednost `"none"` moze se koristiti za bilo koju boju da naslijedi --- -### Example +### Primjer Evo primjera prilagodene teme: diff --git a/packages/web/src/content/docs/bs/tools.mdx b/packages/web/src/content/docs/bs/tools.mdx index 752158fe8..cef02ddda 100644 --- a/packages/web/src/content/docs/bs/tools.mdx +++ b/packages/web/src/content/docs/bs/tools.mdx @@ -9,7 +9,7 @@ Po defaultu su svi alati **ukljuceni** i ne traze dozvolu za pokretanje. Ponasan --- -## Configure +## Konfiguracija Koristite polje `permission` za kontrolu ponasanja alata. Za svaki alat mozete postaviti allow, deny ili ask. @@ -39,7 +39,7 @@ Mozete koristiti i wildcard obrasce da kontrolisete vise alata odjednom. Na prim --- -## Built-in +## Ugrađeni Ovo su svi ugradeni alati dostupni u OpenCode. @@ -168,7 +168,7 @@ Ovaj alat ispisuje sadrzaj direktorija. Prihvata glob obrasce za filtriranje rez --- -### lsp (experimental) +### lsp (eksperimentalno) Komunicira sa konfigurisanim LSP serverima za funkcije inteligencije koda kao definicije, reference, hover info i hijerarhija poziva. @@ -344,7 +344,7 @@ Svako pitanje ukljucuje naslov, tekst pitanja i listu opcija. Korisnici mogu iza --- -## Custom tools +## Prilagođeni alati Custom tools vam omogucavaju da definisete vlastite funkcije koje LLM moze pozivati. Definisu se u config datoteci i mogu izvrsavati proizvoljan kod. @@ -352,7 +352,7 @@ Custom tools vam omogucavaju da definisete vlastite funkcije koje LLM moze poziv --- -## MCP servers +## MCP serveri MCP (Model Context Protocol) serveri omogucavaju integraciju eksternih alata i servisa. Ovo ukljucuje pristup bazama, API integracije i third-party servise. @@ -360,13 +360,13 @@ MCP (Model Context Protocol) serveri omogucavaju integraciju eksternih alata i s --- -## Internals +## Interno Interno, alati kao `grep`, `glob` i `list` koriste [ripgrep](https://github.com/BurntSushi/ripgrep). Po defaultu, ripgrep postuje `.gitignore` obrasce, pa se fajlovi i direktoriji iz `.gitignore` izostavljaju iz pretraga i listinga. --- -### Ignore patterns +### Obrasci ignorisanja Da ukljucite fajlove koji bi inace bili ignorisani, kreirajte `.ignore` datoteku u korijenu projekta. Ova datoteka moze eksplicitno dozvoliti odredene putanje. diff --git a/packages/web/src/content/docs/bs/troubleshooting.mdx b/packages/web/src/content/docs/bs/troubleshooting.mdx index a2975d8db..7dff4b24c 100644 --- a/packages/web/src/content/docs/bs/troubleshooting.mdx +++ b/packages/web/src/content/docs/bs/troubleshooting.mdx @@ -7,7 +7,7 @@ Da biste otklonili probleme s OpenCode, počnite provjeravanjem dnevnika i lokal --- -## Logovi +## Dnevnici Log fajlovi se pišu na: @@ -20,9 +20,9 @@ Možete postaviti nivo dnevnika pomoću opcije komandne linije `--log-level` da --- -## Skladištenje +## Pohrana -opencode pohranjuje podatke o sesiji i druge podatke aplikacije na disku na: +OpenCode pohranjuje podatke o sesiji i druge podatke aplikacije na disku na: - **macOS/Linux**: `~/.local/share/opencode/` - **Windows**: Pritisnite `WIN+R` i zalijepite `%USERPROFILE%\.local\share\opencode` @@ -49,7 +49,7 @@ OpenCode Desktop pokreće lokalni OpenCode server (`opencode-cli` sidecar) u poz --- -### Onemogući dodatke +### Onemogućavanje dodataka Ako se desktop aplikacija ruši pri pokretanju, visi ili se čudno ponaša, počnite s onemogućavanjem dodataka. @@ -70,7 +70,7 @@ Ako imate konfigurirane dodatke, privremeno ih onemogućite uklanjanjem ključa } ``` -#### Provjerite imenike dodataka +#### Provjera direktorija dodataka OpenCode također može učitati lokalne dodatke s diska. Privremeno ih maknite s puta (ili preimenujte folder) i ponovo pokrenite desktop aplikaciju: @@ -84,7 +84,7 @@ Ako aplikacija ponovo počne raditi, ponovo omogućite dodatke jedan po jedan ka --- -### Očisti keš memoriju +### Brisanje keš memorije Ako onemogućavanje dodataka ne pomogne (ili se instalacija dodatka zaglavila), obrišite keš memoriju kako bi ga OpenCode mogao ponovo izgraditi. @@ -99,7 +99,7 @@ Ako onemogućavanje dodataka ne pomogne (ili se instalacija dodatka zaglavila), --- -### Popravite probleme sa vezom na serveru +### Rješavanje problema sa vezom na serveru OpenCode Desktop može ili pokrenuti svoj lokalni server (podrazumevano) ili se povezati na URL servera koji ste konfigurisali. @@ -130,7 +130,7 @@ Na Linuxu, neka podešavanja Waylanda mogu uzrokovati prazne prozore ili greške --- -### Windows: WebView2 runtime +### Windows: WebView2 izvršno okruženje Na Windows-u, OpenCode Desktop zahtijeva Microsoft Edge **WebView2 Runtime**. Ako se aplikacija otvori u praznom prozoru ili se ne pokrene, instalirajte/ažurirajte WebView2 i pokušajte ponovo. @@ -151,7 +151,7 @@ OpenCode Desktop prikazuje sistemska obavještenja samo kada: --- -### Poništi pohranu desktop aplikacija (posljednje rješenje) +### Resetovanje pohrane desktop aplikacije Ako se aplikacija ne pokrene i ne možete izbrisati postavke unutar korisničkog sučelja, resetirajte spremljeno stanje desktop aplikacije. @@ -169,7 +169,7 @@ Da brzo pronađete direktorij: --- -## Dobivanje pomoći +## Traženje pomoći Ako imate problema s OpenCode: @@ -195,7 +195,7 @@ Evo nekih uobičajenih problema i kako ih riješiti. --- -### OpenCode se neće pokrenuti +### OpenCode se ne pokreće 1. Provjerite dnevnike za poruke o greškama 2. Pokušajte pokrenuti sa `--print-logs` da vidite izlaz u terminalu @@ -252,7 +252,7 @@ Na Windows-u pritisnite `WIN+R` i izbrišite: `%USERPROFILE%\.local\share\openco ### AI_APICallError i problemi sa paketom dobavljača -Ako naiđete na greške API poziva, to može biti zbog zastarjelih paketa dobavljača. opencode dinamički instalira pakete dobavljača (OpenAI, Anthropic, Google, itd.) po potrebi i kešira ih lokalno. +Ako naiđete na greške API poziva, to može biti zbog zastarjelih paketa dobavljača. OpenCode dinamički instalira pakete dobavljača (OpenAI, Anthropic, Google, itd.) po potrebi i kešira ih lokalno. Da biste riješili probleme s paketom dobavljača: @@ -264,9 +264,9 @@ Da biste riješili probleme s paketom dobavljača: Na Windows-u pritisnite `WIN+R` i izbrišite: `%USERPROFILE%\.cache\opencode` -2. Ponovo pokrenite opencode da ponovo instalirate najnovije pakete dobavljača +2. Ponovo pokrenite OpenCode da ponovo instalirate najnovije pakete dobavljača -Ovo će prisiliti opencode da preuzme najnovije verzije paketa dobavljača, što često rješava probleme kompatibilnosti s parametrima modela i promjenama API-ja. +Ovo će prisiliti OpenCode da preuzme najnovije verzije paketa dobavljača, što često rješava probleme kompatibilnosti s parametrima modela i promjenama API-ja. --- @@ -297,4 +297,4 @@ Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 & export DISPLAY=:99.0 ``` -opencode će otkriti da li koristite Wayland i preferirate `wl-clipboard`, u suprotnom će pokušati pronaći alate međuspremnika po redoslijedu: `xclip` i `xsel`. +OpenCode će otkriti da li koristite Wayland i preferirate `wl-clipboard`, u suprotnom će pokušati pronaći alate međuspremnika po redoslijedu: `xclip` i `xsel`. diff --git a/packages/web/src/content/docs/bs/tui.mdx b/packages/web/src/content/docs/bs/tui.mdx index 0c80fdf77..96b075aa1 100644 --- a/packages/web/src/content/docs/bs/tui.mdx +++ b/packages/web/src/content/docs/bs/tui.mdx @@ -27,7 +27,7 @@ Give me a quick summary of the codebase. --- -## Reference fajlova +## Reference datoteka Možete referencirati datoteke u svojim porukama koristeći `@`. Ovo vrši nejasnu pretragu datoteka u trenutnom radnom direktoriju. @@ -43,7 +43,7 @@ Sadržaj datoteke se automatski dodaje u razgovor. --- -## Bash komande +## Bash naredbe Započnite poruku sa `!` da pokrenete komandu ljuske. @@ -55,7 +55,7 @@ Izlaz naredbe se dodaje u razgovor kao rezultat alata. --- -## Komande +## Naredbe Kada koristite OpenCode TUI, možete upisati `/` nakon čega slijedi ime komande da biste brzo izvršili radnje. na primjer: @@ -356,7 +356,7 @@ Nekim uređivačima su potrebni argumenti komandne linije da bi se pokrenuli u n --- -## Konfiguriši +## Konfiguracija Možete prilagoditi TUI ponašanje putem vašeg OpenCode konfiguracionog fajla. diff --git a/packages/web/src/content/docs/bs/web.mdx b/packages/web/src/content/docs/bs/web.mdx index 8b6481cb3..6110162a9 100644 --- a/packages/web/src/content/docs/bs/web.mdx +++ b/packages/web/src/content/docs/bs/web.mdx @@ -21,7 +21,7 @@ Ovo pokreće lokalni server na `127.0.0.1` sa nasumičnim dostupnim portom i aut Ako `OPENCODE_SERVER_PASSWORD` nije postavljen, server će biti nezaštićen. Ovo je u redu za lokalnu upotrebu, ali bi trebalo biti postavljeno za pristup mreži. ::: -:::tip[Windows Users] +:::tip[Windows korisnici] Za najbolje iskustvo, pokrenite `opencode web` iz [WSL](/docs/windows-wsl) umjesto PowerShell-a. Ovo osigurava pravilan pristup sistemu datoteka i integraciju terminala. ::: @@ -54,7 +54,7 @@ Kada koristite `0.0.0.0`, OpenCode će prikazati i lokalne i mrežne adrese: Network access: http://192.168.1.100:4096 ``` -### mDNS Discovery +### mDNS Otkrivanje Omogućite mDNS kako bi vaš server bio vidljiv na lokalnoj mreži: diff --git a/packages/web/src/content/docs/bs/windows-wsl.mdx b/packages/web/src/content/docs/bs/windows-wsl.mdx index cace9c182..04d62a531 100644 --- a/packages/web/src/content/docs/bs/windows-wsl.mdx +++ b/packages/web/src/content/docs/bs/windows-wsl.mdx @@ -7,13 +7,13 @@ import { Steps } from "@astrojs/starlight/components" Iako OpenCode moze raditi direktno na Windowsu, preporucujemo [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) za najbolje iskustvo. WSL daje Linux okruzenje koje glatko radi sa OpenCode funkcijama. -:::tip[Why WSL?] +:::tip[Zašto WSL?] WSL nudi bolje performanse fajl sistema, punu terminalsku podrsku i kompatibilnost s razvojnim alatima na koje se OpenCode oslanja. ::: --- -## Setup +## Postavljanje @@ -42,7 +42,7 @@ WSL nudi bolje performanse fajl sistema, punu terminalsku podrsku i kompatibilno --- -## Desktop App + WSL Server +## Desktop aplikacija + WSL Server Ako preferirate OpenCode Desktop aplikaciju, ali zelite da server radi u WSL-u: @@ -69,7 +69,7 @@ OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0 --- -## Web Client + WSL +## Web klijent + WSL Za najbolje web iskustvo na Windowsu: @@ -106,7 +106,7 @@ Za najgladje iskustvo, razmislite da klonirate/kopirate repo u WSL fajl sistem ( --- -## Tips +## Savjeti - Drzite OpenCode u WSL-u za projekte na Windows diskovima - pristup fajlovima je jednostavan - Koristite VS Code [WSL ekstenziju](https://code.visualstudio.com/docs/remote/wsl) uz OpenCode za integrisan tok rada diff --git a/packages/web/src/content/docs/bs/zen.mdx b/packages/web/src/content/docs/bs/zen.mdx index 6488f7ac3..f97333708 100644 --- a/packages/web/src/content/docs/bs/zen.mdx +++ b/packages/web/src/content/docs/bs/zen.mdx @@ -89,7 +89,7 @@ Nasim modelima mozete pristupiti i preko sljedecih API endpointa. --- -### Models +### Modeli Pun spisak dostupnih modela i metapodataka mozete preuzeti na: diff --git a/packages/web/src/content/docs/da/acp.mdx b/packages/web/src/content/docs/da/acp.mdx index 9288d772d..06cdc89c4 100644 --- a/packages/web/src/content/docs/da/acp.mdx +++ b/packages/web/src/content/docs/da/acp.mdx @@ -1,5 +1,5 @@ --- -title: ACP support +title: ACP-understøttelse description: Brug OpenCode i enhver ACP-kompatibel editor. --- @@ -13,7 +13,7 @@ ACP er en åben protokol, der standardiserer kommunikation mellem kodeeditorer o --- -## Konfigurer +## Konfiguration For at bruge OpenCode via ACP, konfigurer din editor til at køre kommandoen `opencode acp`. @@ -140,7 +140,7 @@ Denne konfiguration sætter CodeCompanion til at bruge OpenCode som ACP-agent ti Hvis du har brug for at sende miljøvariabler (som `OPENCODE_API_KEY`), henvises til [Konfiguration af adaptere: Miljøvariabler](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) i CodeCompanion.nvim-dokumentationen for alle detaljer. -## Support +## Understøttelse OpenCode fungerer på samme måde via ACP som i terminalen. Alle funktioner understøtter: diff --git a/packages/web/src/content/docs/da/agents.mdx b/packages/web/src/content/docs/da/agents.mdx index c9f4a590f..6ab2e7c39 100644 --- a/packages/web/src/content/docs/da/agents.mdx +++ b/packages/web/src/content/docs/da/agents.mdx @@ -1,5 +1,5 @@ --- -title: Agent +title: Agenter description: Konfigurer og brug specialiserede agenter. --- @@ -13,13 +13,13 @@ Du kan skifte mellem agenter under en session eller kalde dem med `@`-omtalen. --- -## Skriver +## Typer Der er to typer agenter i OpenCode; primære agenter og subagenter. --- -### Primære agent +### Primær agent Primære agenter er de vigtigste assistenter, du interagerer direkte med. Du kan bladre gennem dem ved at bruge **Tab**-tasten eller din konfigurerede `switch_agent`-tastebinding. Disse agenter håndterer din hovedsamtale. Værktøjsadgang konfigureres via tilladelser - for eksempel har Build alle aktiveret, mens Plan er begrænset. @@ -40,13 +40,13 @@ OpenCode leveres med to indbyggede underagenter, **Generelt** og **Udforsk**. Vi --- -## Indbygget +## Indbyggede OpenCode leveres med to indbyggede primære agenter og to indbyggede subagenter. --- -### Brug bygge +### Build-agenten _Tilstand_: `primary` @@ -54,7 +54,7 @@ Byg er den **standard** primære agent med alle aktiveret. Dette er standardagen --- -### Brug plan +### Plan-agenten _Tilstand_: `primary` @@ -68,7 +68,7 @@ Denne agent er nyttig, når du vil have LLM til at analysere kode, foreslå ænd --- -### Brug generelt +### General-agenten _Tilstand_: `subagent` @@ -76,7 +76,7 @@ En agent til generelt formål at undersøge komplekse spørgsmål og udføre opg --- -### Brug udforsk +### Explore-agenten _Tilstand_: `subagent` @@ -84,7 +84,7 @@ En hurtig, skrivebeskyttet agent til at udforske kodebaser. Kan ikke ændre file --- -### Brug komprimering +### Compact-agenten _Tilstand_: `primary` @@ -92,7 +92,7 @@ Skjult systemagent, der komprimerer lang kontekst til et mindre resumé. Det kø --- -### Brug titel +### Title-agenten _Tilstand_: `primary` @@ -100,7 +100,7 @@ Skjult systemagent, der genererer korte sessionstitler. Den kører automatisk og --- -### Brug CV +### Resume-agenten _Tilstand_: `primary` @@ -108,7 +108,7 @@ Skjult systemagent, der opretter sessionsoversigter. Den kører automatisk og ka --- -## Brug +## Anvendelse 1. For primære agenter skal du bruge tasten **Tab** til at bladre gennem dem under en session. Du kan også bruge din konfigurerede `switch_agent` nøglebinding. @@ -128,7 +128,7 @@ Skjult systemagent, der opretter sessionsoversigter. Den kører automatisk og ka --- -## Konfigurer +## Konfiguration Du kan tilpasse de indbyggede agenter eller oprette dine egne gennem konfiguration. Agenter kan konfigureres på følgende måder: @@ -216,7 +216,7 @@ Lad os se nærmere på disse konfigurationsmuligheder. --- -### Beskrivelse +### Beskrivelse (`description`) Brug indstillingen `description` til at give en kort beskrivelse af, hvad agenten gør, og hvornår den skal bruges. @@ -234,7 +234,7 @@ Dette er en **påkrævet** konfigurationsindstilling. --- -### Temperatur +### Temperatur (`temperature`) Styr tilfældigheden og kreativiteten af ​​​​LLMs svar med `temperature`-konfigurationen. @@ -281,7 +281,7 @@ Hvis ingen temperatur er angivet, bruger OpenCode modelspecifikke standardindsti --- -### Maks. skridt +### Trin (`steps`) Kontrollerer det maksimale antal agent-gentagelser, som en agent kan udføre, før han bliver tvunget til kun at svare med tekst. Dette giver brugere, der ønsker at kontrollere, mulighed for at sætte en grænse for agenthandlinger. @@ -307,7 +307,7 @@ Det gamle `maxSteps`-felt er forældet. Brug `steps` i stedet. --- -### Deaktiver +### Deaktivering (`disable`) Indstil til `true` for at deaktivere agenten. @@ -323,7 +323,7 @@ Indstil til `true` for at deaktivere agenten. --- -### Spørg +### Prompt (`prompt`) Angiv en brugerdefineret systempromptfil for denne agent med `prompt`-konfigurationen. Promptfilen skal indeholde instruktioner, der er specifikke for agentens formål. @@ -341,7 +341,7 @@ Denne sti er i forhold til, hvor konfigurationsfilen er placeret. Så dette virk --- -### Model +### Model (`model`) Brug `model`-konfigurationen til at tilsidesætte modeller for denne agent. Nyttigt til brug af forskellige modeller optimeret til forskellige opgaver. For eksempel en hurtigere model til planlægning, en dygtig model til implementering. @@ -363,7 +363,7 @@ Model-id'et i din OpenCode-konfiguration brugerformatet `provider/model-id`. For --- -### Værktøjer +### Værktøjer (`tools`) Kontroller, hvilke værktøjer der er tilgængelige i denne agent med `tools`-konfigurationen. Du kan aktivere eller deaktivere specifikke redskaber ved at indstille dem til `true` eller `false`. @@ -410,7 +410,7 @@ Du kan også bruge jokertegn til at styre flere værktøjer på én gang. For ek --- -### Tilladelser +### Tilladelser (`permission`) Du kan konfigurere tilladelser til at administrere, hvilke handlinger og agenter kan udføre. I øjeblikket kan tilladelserne til værktøjerne `edit`, `bash` og `webfetch` konfigureres til: @@ -522,7 +522,7 @@ Da den sidste matchningsregel har forrang, skal du sætte jokertegnet `*` først --- -### Tilstand +### Tilstand (`mode`) Styr agentens tilstand med `mode`-konfigurationen. Indstillingen `mode` bruges til at bestemme, hvordan agenten kan bruges. @@ -540,7 +540,7 @@ Indstillingen `mode` kan indstilles til `primary`, `subagent` eller `all`. Hvis --- -### Skjult +### Skjult (`hidden`) Skjul en underagent fra `@` autofuldførelsesmenuen med `hidden: true`. Nyttigt for interne underagenter, der kun bør startes programmatisk af andre agenter via opgaveværktøjet. @@ -563,7 +563,7 @@ Gælder kun for `mode: subagent`-agent. --- -### Opgavetilladelser +### Opgavetilladelser (`permission.task`) Kontroller, hvilke subagenter en agent kan påkalde via opgaveværktøjet med `permission.task`. Bruger glob-mønstre til fleksibel matchning. @@ -596,7 +596,7 @@ Brugere kan altid påkalde enhver underagent direkte via `@` autofuldførelsesme --- -### Farve +### Farve (`color`) Tilpas agentens visuelle udseende i brugergrænsefladen med muligheden `color`. Dette påvirker, hvordan agenter vises i grænsefladen. @@ -662,7 +662,7 @@ Kør `opencode models` for at se en liste over de tilgængelige modeller. --- -## Opret agent +## Oprettelse af agent Du kan oprette nye agenter ved hjælp af følgende kommando: @@ -680,7 +680,7 @@ Denne interaktive kommando vil: --- -## Use cases +## Anvendelsesmuligheder Her er nogle almindelige use cases for forskellige agenter. @@ -702,7 +702,7 @@ Har du en agent, du gerne vil dele? [Send en PR](https://github.com/anomalyco/op --- -### Dokumentationsagent +### Dokumentations-agent ```markdown title="~/.config/opencode/agents/docs-writer.md" --- @@ -724,7 +724,7 @@ Focus on: --- -### Sikkerhedsrevisor +### Sikkerheds-agent ```markdown title="~/.config/opencode/agents/security-auditor.md" --- diff --git a/packages/web/src/content/docs/da/cli.mdx b/packages/web/src/content/docs/da/cli.mdx index 80361852a..c29559df2 100644 --- a/packages/web/src/content/docs/da/cli.mdx +++ b/packages/web/src/content/docs/da/cli.mdx @@ -27,7 +27,7 @@ Start OpenCode terminalbrugergrænsefladen. opencode [project] ``` -#### Flags +#### Flag | Flag | Kort | Beskrivelse | | ------------ | ---- | ---------------------------------------------------------------------------- | @@ -76,7 +76,7 @@ opencode web --port 4096 --hostname 0.0.0.0 opencode attach http://10.20.30.40:4096 ``` -#### Flags +#### Flag | Flag | Kort | Beskrivelse | | ----------- | ---- | -------------------------------- | @@ -185,7 +185,7 @@ Kør GitHub-agenten. Dette bruges typisk i GitHub Actions. opencode github run ``` -##### Flags +##### Flag | Flag | Beskrivelse | | --------- | ---------------------------------------------- | @@ -294,7 +294,7 @@ Du kan eventuelt videregive et udbyder-id for at filtrere modeller efter den udb opencode models anthropic ``` -#### Flags +#### Flag | Flag | Beskrivelse | | ----------- | ----------------------------------------------------------------------- | @@ -333,7 +333,7 @@ opencode serve opencode run --attach http://localhost:4096 "Explain async/await in JavaScript" ``` -#### Flags +#### Flag | Flag | Kort | Beskrivelse | | ------------ | ---- | ----------------------------------------------------------------------------------- | @@ -362,7 +362,7 @@ opencode serve Dette starter en HTTP-server, der giver API-adgang til opencode-funktionalitet uden TUI-grænsefladen. Indstil `OPENCODE_SERVER_PASSWORD` for at aktivere HTTP grundlæggende godkendelse (brugernavn er standard til `opencode`). -#### Flags +#### Flag | Flag | Beskrivelse | | ------------ | ------------------------------------------------ | @@ -391,7 +391,7 @@ Liste over alle OpenCode sessioner. opencode session list ``` -##### Flags +##### Flag | Flag | Kort | Beskrivelse | | ------------- | ---- | -------------------------------------- | @@ -408,7 +408,7 @@ Vis tokenbrug og omkostningsstatistikker for dine OpenCode-sessioner. opencode stats ``` -#### Flags +#### Flag | Flag | Beskrivelse | | ----------- | --------------------------------------------------------------------------- | @@ -458,7 +458,7 @@ opencode web Dette starter en HTTP-server og åbner en webbrowser for at få adgang til OpenCode via en webgrænseflade. Indstil `OPENCODE_SERVER_PASSWORD` for at aktivere HTTP grundlæggende godkendelse (brugernavn er standard til `opencode`). -#### Flags +#### Flag | Flag | Beskrivelse | | ------------ | ------------------------------------------------ | @@ -479,7 +479,7 @@ opencode acp Denne kommando starter en ACP-server, der kommunikerer via stdin/stdout ved hjælp af nd-JSON. -#### Flags +#### Flag | Flag | Beskrivelse | | ------------ | --------------------- | @@ -497,7 +497,7 @@ Afinstaller OpenCode og fjern alle relaterede filer. opencode uninstall ``` -#### Flags +#### Flag | Flag | Kort | Beskrivelse | | --------------- | ---- | ------------------------------------------------ | @@ -536,7 +536,7 @@ opencode upgrade v0.1.48 --- -## Globalt flag +## Globale flag opencode CLI tager følgende globale flag. @@ -582,7 +582,7 @@ OpenCode kan konfigureres ved hjælp af miljøvariabler. --- -### Flags +### Flag Disse miljøvariabler muliggør eksperimentelle funktioner, der kan ændres eller fjernes. diff --git a/packages/web/src/content/docs/da/commands.mdx b/packages/web/src/content/docs/da/commands.mdx index 89a02082c..1b624b57a 100644 --- a/packages/web/src/content/docs/da/commands.mdx +++ b/packages/web/src/content/docs/da/commands.mdx @@ -13,7 +13,7 @@ Brugerdefinerede kommandoer er ud over de indbyggede kommandoer som `/init`, `/u --- -## Opret kommandofiler +## Oprettelse af kommandofiler Opret markdown-filer i mappen `commands/` for at definere brugerdefinerede kommandoer. @@ -40,7 +40,7 @@ Brug kommandoen ved at skrive `/` efterfulgt af kommandonavnet. --- -## Konfigurer +## Konfiguration Du kan tilføje brugerdefinerede kommandoer gennem OpenCode-konfigurationen eller ved at oprette markdown-filer i `commands/`-mappen. @@ -102,7 +102,7 @@ du løber: --- -## Spørg config +## Prompt-konfiguration Spørgsmålene til de brugerdefinerede kommandoer understøtter flere specielle pladsholdere og syntaks. @@ -195,7 +195,7 @@ Kommandoer kører i dit projekts rodmappe, og deres output bliver en del af prom --- -### Filreferencer +### Fil-referencer Inkluder filer i din kommando ved hjælp af `@` efterfulgt af filnavnet. @@ -218,7 +218,7 @@ Lad os se nærmere på konfigurationsmulighederne. --- -### Skabelon +### Skabelon (`template`) Indstillingen `template` definerer den prompt, der sendes til LLM, når kommandoen udføres. @@ -236,7 +236,7 @@ Dette er en **påkrævet** konfigurationsindstilling. --- -### Beskrivelse +### Beskrivelse (`description`) Brug indstillingen `description` til at give en kort beskrivelse af, hvad kommandoen gør. @@ -274,7 +274,7 @@ Dette er en **valgfri** konfigurationsindstilling. Hvis det ikke er angivet, er --- -### Underopgave +### Underopgave (`subtask`) Brug `subtask` boolean til at tvinge kommandoen til at udløse en [subagent](/docs/agents/#subagents) påkaldelse. Dette er nyttigt, hvis du ønsker, at kommandoen ikke skal forurene din primære kontekst og vil **tvinge** agenten til at fungere som en underagent, @@ -312,7 +312,7 @@ Dette er en **valgfri** konfigurationsindstilling. --- -## Indbygget +## Indbyggede kommandoer opencode indeholder flere indbyggede kommandoer som `/init`, `/undo`, `/redo`, `/share`, `/help`; [learn more](/docs/tui#commands). diff --git a/packages/web/src/content/docs/da/config.mdx b/packages/web/src/content/docs/da/config.mdx index fd859b7b7..5b45f8b04 100644 --- a/packages/web/src/content/docs/da/config.mdx +++ b/packages/web/src/content/docs/da/config.mdx @@ -1,5 +1,5 @@ --- -title: Konfig +title: Konfiguration description: Ved at bruge OpenCode JSON konfig. --- @@ -23,7 +23,7 @@ OpenCode understøtter både **JSON** og **JSONC** (JSON med kommentarer) format --- -## Steder +## Placeringer Du kan placere din konfiguration et par forskellige steder, og de har en forskellig rækkefølge. @@ -101,7 +101,7 @@ Global config tilsidesætter eksterne organisatoriske standarder. --- -### Pr. projekt +### Projekt-niveau Tilføj `opencode.json` i dit projektrod. Project config har den højeste forrang blandt standard config-filer - den tilsidesætter både globale og eksterne config. @@ -128,7 +128,7 @@ Brugerdefineret konfigurationsindlæses mellem globale konfigurationer og projek --- -### Brugerdefineret bibliotek +### Brugerdefineret mappe Angiv en brugerdefineret konfigurationsmappe ved hjælp af `OPENCODE_CONFIG_DIR` miljøvariabel. Dette kort vil blive søgt efter agenter, kommandoer, @@ -208,7 +208,7 @@ Tilgængelige muligheder: --- -### Værktøjer +### Værktøjer (`tools`) Du kan administrere de værktøjer, en LLM kan bruge, gennem indstillingen `tools`. @@ -226,7 +226,7 @@ Du kan administrere de værktøjer, en LLM kan bruge, gennem indstillingen `tool --- -### Modeller +### Modeller (`models`) Du kan konfigurere de udbydere og modeller, du vil bruge i din OpenCode-konfiguration, gennem mulighederne `provider`, `model` og `small_model`. @@ -299,7 +299,7 @@ Bearer tokens (`AWS_BEARER_TOKEN_BEDROCK` eller `/connect`) har forrang over pro --- -### Temaer +### Temaer (`themes`) Du kan konfigurere det tema, du vil bruge i din OpenCode-konfiguration, gennem indstillingen `theme`. @@ -340,7 +340,7 @@ Du kan også definere agenter ved at bruge markdown-filer i `~/.config/opencode/ --- -### Standardagent +### Standardagent (`default_agent`) Du kan indstille standardagenten ved at bruge indstillingen `default_agent`. Dette bestemmer, hvilken agent der bruges, når ingen er eksplicit angivet. @@ -357,7 +357,7 @@ Denne indstilling gælder på tværs af alle grænseflader: TUI, CLI (`opencode --- -### Deling +### Deling (`share`) Du kan konfigurere funktionen [share](/docs/share) gennem indstillingen `share`. @@ -378,7 +378,7 @@ Som standard er deling indstillet til manuel tilstand, hvor du eksplicit skal de --- -### Kommandoer +### Kommandoer (`command`) Du kan konfigurere brugerdefinerede kommandoer til gentagne opgaver gennem indstillingen `command`. @@ -404,7 +404,7 @@ Du kan også definere kommandoer ved hjælp af markdown-filer i `~/.config/openc --- -### Nøglebindinger +### Tastebindinger (`keybinds`) Du kan tilpasse dine nøglebindinger gennem indstillingen `keybinds`. @@ -419,7 +419,7 @@ Du kan tilpasse dine nøglebindinger gennem indstillingen `keybinds`. --- -### Autoopdatering +### Auto-opdatering (`autoupdate`) OpenCode vil automatisk downloade alle nye opdateringer, når den starter op. Du kan deaktivere dette med indstillingen `autoupdate`. @@ -435,7 +435,7 @@ Bemærk, at dette kun virker, hvis det ikke blev installeret ved hjælp af en pa --- -### Formatere +### Formater (`formatter`) Du kan konfigurere kodeformatere gennem indstillingen `formatter`. @@ -461,7 +461,7 @@ Du kan konfigurere kodeformatere gennem indstillingen `formatter`. --- -### Tilladelser +### Tilladelse (`permission`) Som standard opencode **tillader alle operationer** uden at kræve eksplicit godkendelse. Du kan ændre dette ved at bruge indstillingen `permission`. @@ -481,7 +481,7 @@ For at sikre, at værktøjerne `edit` og `bash` for eksempel kræver brugergodke --- -### Komprimering +### Komprimering (`compaction`) Du kan styre kontekstkomprimeringsadfærd gennem indstillingen `compaction`. @@ -500,7 +500,7 @@ Du kan styre kontekstkomprimeringsadfærd gennem indstillingen `compaction`. --- -### Watcher +### Overvågning (`watcher`) Du kan konfigurere ignoreringsmønstre for filovervåger gennem indstillingen `watcher`. @@ -517,7 +517,7 @@ Mønstre følger glob-syntaks. Brug dette til at udelukke støjende mapper fra f --- -### MCP servere +### MCP Du kan konfigurere MCP-servere, som du vil bruge, gennem indstillingen `mcp`. @@ -532,7 +532,7 @@ Du kan konfigurere MCP-servere, som du vil bruge, gennem indstillingen `mcp`. --- -### Plugins +### Plugin [Plugins](/docs/plugins) udvide OpenCode med brugerdefinerede værktøjer, kroge og integrationer. @@ -549,7 +549,7 @@ Placer plugin-filer i `.opencode/plugins/` eller `~/.config/opencode/plugins/`. --- -### Instruktioner +### Instruktioner (`instructions`) Du kan konfigurere brugervejledningen til den model, du kan gennem indstillingen `instructions`. @@ -565,7 +565,7 @@ om regler her](/docs/rules). --- -### Deaktiverede udbydere +### Deaktiverede udbydere (`disabled_providers`) Du kan deaktivere udbydere, der indlæses automatisk gennem `disabled_providers`-indstillingen. Dette er nyttigt, når du vil forhindre visse udbydere i at blive indlæst, deres legitimationsoplysninger er tilgængelige. @@ -588,7 +588,7 @@ Indstillingen `disabled_providers` accepterer en række udbyder-id'er. Når en u --- -### Aktiverede udbydere +### Aktiverede udbydere (`enabled_providers`) Du kan angive en tilladelsesliste over udbydere gennem muligheden `enabled_providers`. Når den er indstillet, vil kun de angivne udbydere blive aktiveret, og alle andre vil blive ignoreret. @@ -609,7 +609,7 @@ Hvis en udbyder optræder i både `enabled_providers` og `disabled_providers`, h --- -### Eksperimentel +### Eksperimentel (`experimental`) Nøglen `experimental` indeholder muligheder, der er under aktiv udvikling. @@ -626,13 +626,13 @@ Eksperimentelle muligheder er ikke stabile. De kan ændres eller fjernes uden va --- -## Variabel +## Variabler Du kan bruge variabelsubstitution i dine konfigurationsfiler til at referere til miljøvariabler og filindhold. --- -### Env vars +### Miljøvariabler Brug `{env:VARIABLE_NAME}` til at erstatte miljøvariabler: diff --git a/packages/web/src/content/docs/da/ecosystem.mdx b/packages/web/src/content/docs/da/ecosystem.mdx index 84b051df2..8da7e42d1 100644 --- a/packages/web/src/content/docs/da/ecosystem.mdx +++ b/packages/web/src/content/docs/da/ecosystem.mdx @@ -68,7 +68,7 @@ Du kan også tjekke [awesome-opencode](https://github.com/awesome-opencode/aweso --- -## Agent +## Agenter | Navn | Beskrivelse | | ----------------------------------------------------------------- | ------------------------------------------------------------------------- | diff --git a/packages/web/src/content/docs/da/enterprise.mdx b/packages/web/src/content/docs/da/enterprise.mdx index 7ea9bfef3..6228c5c91 100644 --- a/packages/web/src/content/docs/da/enterprise.mdx +++ b/packages/web/src/content/docs/da/enterprise.mdx @@ -19,7 +19,7 @@ Sådan kommer du i gang med OpenCode Enterprise: --- -## Prøve +## Prøveperiode OpenCode er open source og gemmer ingen af ​​din kode eller kontekstdata, så dine udviklere kan simpelthen [get started](/docs/) og udføre en prøveversion. @@ -75,7 +75,7 @@ prissætning og implementeringsmuligheder. --- -### Central Config +### Central konfiguration Vi kan konfigurere OpenCode til at bruge en enkelt central konfiguration for hele din organisation. @@ -99,7 +99,7 @@ Du kan også deaktivere alle andre AI-udbydere og sikre, at alle anmodninger gå --- -### Self-hosting +### Selv-hosting Selvom vi anbefaler at deaktivere delesiderne for at sikre, at dine data aldrig forsvinder din organisation, kan vi også hjælpe dig med at selv hoste dem på din infrastruktur. diff --git a/packages/web/src/content/docs/da/formatters.mdx b/packages/web/src/content/docs/da/formatters.mdx index 9cf0833b6..09ff611a6 100644 --- a/packages/web/src/content/docs/da/formatters.mdx +++ b/packages/web/src/content/docs/da/formatters.mdx @@ -7,7 +7,7 @@ OpenCode formaterer automatisk filer, efter de er skrevet eller redigeret ved hj --- -## Indbygget +## Indbyggede OpenCode leveres med flere indbyggede formatere til populære sprog og rammer. Nedenfor er en liste over de formatere, understøttede filtypenavne og kommandoer eller konfigurationsmuligheder, der har brug for. @@ -54,7 +54,7 @@ Denne proces sker i baggrunden, hvilket sikrer, at dine kodestile vedligeholdes --- -## Konfigurer +## Konfiguration Du kan tilpasse formatere gennem afsnittet `formatter` i din OpenCode-konfiguration. diff --git a/packages/web/src/content/docs/da/github.mdx b/packages/web/src/content/docs/da/github.mdx index b71c11b12..cffe85f13 100644 --- a/packages/web/src/content/docs/da/github.mdx +++ b/packages/web/src/content/docs/da/github.mdx @@ -114,7 +114,7 @@ OpenCode kan udløses af følgende GitHub hændelser: | `schedule` | Cron-baseret tidsplan | Kør OpenCode efter en tidsplan. Kræver `prompt` input. Output går til logfiler og PR'er (intet problem ved kommentere). | | `workflow_dispatch` | Manuel trigger fra GitHub UI | Udløs OpenCode efter behov via fanen Handlinger. Kræver `prompt` input. Output går til logfiler og PR'er. | -### Skema Eksempel +### Tidsplan eksempel Kør OpenCode efter en tidsplan for at udføre automatiske opgaver: @@ -154,7 +154,7 @@ For planlagte begivenheder er `prompt` input **påkrævet**, da der ikke er noge --- -### Pull Request Eksempel +### Pull Request eksempel Gennemgå automatisk PR'er, når de åbnes eller opdateres: @@ -195,7 +195,7 @@ For `pull_request` hændelser, hvis der ikke er angivet nogen `prompt`, vil Open --- -### Issues Triage Eksempel +### Issues Triage eksempel Triage automatisk nye problemer. Dette eksempel filtrerer til konti ældre end 30 dage for at reducere spam: diff --git a/packages/web/src/content/docs/da/index.mdx b/packages/web/src/content/docs/da/index.mdx index dca8a93ae..b2623b93d 100644 --- a/packages/web/src/content/docs/da/index.mdx +++ b/packages/web/src/content/docs/da/index.mdx @@ -1,5 +1,5 @@ --- -title: Intro +title: Introduktion description: Kom godt i gang med OpenCode. --- @@ -29,7 +29,7 @@ For at bruge OpenCode i din terminal skal du bruge: --- -## Installationsprogram +## Installation Den nemmeste måde at installere OpenCode på er gennem installationsscriptet. @@ -129,7 +129,7 @@ Du kan også få fat i binæren fra [Releases](https://github.com/anomalyco/open --- -## Konfigurer +## Konfiguration Med OpenCode kan du bruge enhver LLM udbyder ved at konfigurere deres API-nøgler. @@ -158,7 +158,7 @@ Alternativt kan du vælge en af ​​de andre udbydere. [Læs mere](/docs/provi --- -## Initialiser +## Initialisering Nu hvor du har konfigureret en udbyder, kan du navigere til et projekt, der du vil arbejde på. @@ -333,7 +333,7 @@ Eller du **kan gentage** ændringerne ved hjælp af kommandoen `/redo`. --- -## Del +## Deling De samtaler, du har med OpenCode, kan [deles med din team](/docs/share). @@ -352,7 +352,7 @@ Her er en [eksempelsamtale](https://opencode.ai/s/4XP1fce5) med OpenCode. --- -## Tilpas +## Tilpasning Og det er det! Du er nu en professionel i at bruge OpenCode. diff --git a/packages/web/src/content/docs/da/keybinds.mdx b/packages/web/src/content/docs/da/keybinds.mdx index ce774cedc..2da3ff942 100644 --- a/packages/web/src/content/docs/da/keybinds.mdx +++ b/packages/web/src/content/docs/da/keybinds.mdx @@ -1,5 +1,5 @@ --- -title: Nøglebind +title: Tastebindinger description: Tilpas dine nøglebindinger. --- @@ -105,7 +105,7 @@ OpenCode har en liste over nøglebindinger, som du kan tilpasse gennem OpenCode- --- -## Ledernøgle +## Ledertast OpenCode bruger en `leader` nøgle til de fleste smagsbindinger. Dette undgår konflikter i din terminal. @@ -115,7 +115,7 @@ Du behøver ikke bruge en ledernøgle til dine nøglebindinger, men vi anbefaler --- -## Deaktiver smagsbinding +## Deaktiver tastebinding Du kan deaktivere en nøglebinding ved at tilføje nøglen til din konfiguration med værdien "ingen". diff --git a/packages/web/src/content/docs/da/lsp.mdx b/packages/web/src/content/docs/da/lsp.mdx index b9c832809..b0e0d3537 100644 --- a/packages/web/src/content/docs/da/lsp.mdx +++ b/packages/web/src/content/docs/da/lsp.mdx @@ -1,5 +1,5 @@ --- -title: LSP Servere +title: LSP-servere description: OpenCode integreres med dine LSP-servere. --- @@ -7,7 +7,7 @@ OpenCode integreres med Language Server Protocol (LSP) for at hjælpe LLM med at --- -## Indbygget +## Indbyggede OpenCode leveres med flere indbyggede LSP-servere til populære sprog: @@ -63,7 +63,7 @@ Når opencode åbner en fil, vil den: --- -## Konfigurer +## Konfiguration Du kan tilpasse LSP-servere gennem sektionen `lsp` i din opencode-konfiguration. diff --git a/packages/web/src/content/docs/da/mcp-servers.mdx b/packages/web/src/content/docs/da/mcp-servers.mdx index 995ebabe5..fa356131b 100644 --- a/packages/web/src/content/docs/da/mcp-servers.mdx +++ b/packages/web/src/content/docs/da/mcp-servers.mdx @@ -1,5 +1,5 @@ --- -title: MCP servere +title: MCP-servere description: Tilføj lokale og eksterne MCP værktøjer. --- @@ -9,7 +9,7 @@ Når de er tilføjet, er MCP automatisk tilgængelig for LLM sammen med indbygge --- -#### Caveats +#### Forbehold Når du bruger en MCP-server, føjes den til konteksten. Dette kan hurtigt stige, hvis du har mange værktøjer. Så vi anbefaler at være forsigtig med hvilke MCP-servere du bruger. @@ -21,7 +21,7 @@ Visse MCP-servere, som GitHub MCP-servere, har en tendens til at tilføje mange --- -## Aktiver +## Aktivering Du kan definere MCP-servere i din [OpenCode Config](https://opencode.ai/docs/config/) under `mcp`. Tilføj hver MCP med et unikt navn. Du kan henvise til denne MCP ved navn, når du spørger LLM. @@ -44,7 +44,7 @@ Du kan også deaktivere en server ved at indstille `enabled` til `false`. Dette --- -### Overriding remote defaults +### Tilsidesættelse af eksterne standarder Organisationer kan levere standard MCP-servere via deres `.well-known/opencode`-slutpunkt. Disse servere kan være deaktiveret som standard, hvilket giver brugerne mulighed for at tilmelde sig dem, de har brug for. @@ -112,7 +112,7 @@ use the mcp_everything tool to add the number 3 and 4 --- -#### Options +#### Indstillinger Her er alle muligheder for at konfigurere en lokal MCP-server. @@ -126,7 +126,7 @@ Her er alle muligheder for at konfigurere en lokal MCP-server. --- -## Remote +## Ekstern Tilføj ekstern MCP-server ved at indstille `type` til `"remote"`. @@ -150,7 +150,7 @@ Tilføj ekstern MCP-server ved at indstille `type` til `"remote"`. --- -#### Options +#### Indstillinger | Mulighed | Skriv | Påkrævet | Beskrivelse | | --------- | ------- | -------- | ------------------------------------------------------------------------------------ | @@ -173,7 +173,7 @@ OpenCode håndterer automatisk OAuth-godkendelse for eksterne MCP-servere. Når --- -### Automatic +### Automatisk For de fleste OAuth-aktiverede MCP-servere kræver ingen speciel konfiguration. Bare konfigureret fjernserver: @@ -193,7 +193,7 @@ Hvis serveren kræver godkendelse, vil OpenCode bede dig om at godkende, når du --- -### Pre-registered +### Forhåndsregistreret Hvis du har klientlegitimationsoplysninger fra MCP-serverudbyderen, kan du konfigurere dem: @@ -216,7 +216,7 @@ Hvis du har klientlegitimationsoplysninger fra MCP-serverudbyderen, kan du konfi --- -### Authenticating +### Godkendelse Du kan manuelt udløse godkendelse eller administrere legitimationsoplysninger. @@ -242,7 +242,7 @@ Kommandoen `mcp auth` åbner din browser for godkendelse. Når du har godkendt, --- -#### Disabling OAuth +#### Deaktivering af OAuth Hvis du vil deaktivere automatisk OAuth for en server (f.eks. for servere, der bruger API-nøgler i stedet), skal du indstille `oauth` til `false`: @@ -264,7 +264,7 @@ Hvis du vil deaktivere automatisk OAuth for en server (f.eks. for servere, der b --- -#### OAuth Options +#### OAuth-indstillinger | Mulighed | Skriv | Beskrivelse | | -------------- | --------------- | ----------------------------------------------------------------------------------------- | @@ -273,7 +273,7 @@ Hvis du vil deaktivere automatisk OAuth for en server (f.eks. for servere, der b | `clientSecret` | String | OAuth-klienthemmelighed, hvis det kræves af autorisationsserveren. | | `scope` | String | OAuth-omfang at anmode om under godkendelse. | -#### Debugging +#### Fejlfinding Hvis en ekstern MCP-server ikke kan godkendes, kan du diagnosticere problemer med: @@ -289,7 +289,7 @@ Kommandoen `mcp debug` viser den aktuelle godkendelsesstatus, tester HTTP-forbin --- -## Administrator +## Administration Dine MCPs er tilgængelige som værktøjer i **TK\_** sammen med indbyggede værktøjer. Så du kan administrere dem gennem OpenCode-konfigurationen som ethvert andet værktøj. @@ -375,7 +375,7 @@ Hvis du har et stort antal MCP-servere, vil du måske kun aktivere dem pr. agent --- -#### Glob patterns +#### Glob-mønstre Glob-mønsteret bruger simple regex-globing-mønstre: diff --git a/packages/web/src/content/docs/da/models.mdx b/packages/web/src/content/docs/da/models.mdx index c929173fe..7bacdd9f2 100644 --- a/packages/web/src/content/docs/da/models.mdx +++ b/packages/web/src/content/docs/da/models.mdx @@ -64,7 +64,7 @@ Hvis du har konfigureret en [custom provider](/docs/providers#custom), er `provi --- -## Konfigurer modeller +## Konfiguration af modeller Du kan konfigurere en models muligheder globalt gennem konfigurationen. @@ -195,13 +195,13 @@ Du kan tilsidesætte eksisterende varianter eller tilføje dine egne: } ``` -### Cyklusvarianter +### Skift varianter Brug tastebindingen `variant_cycle` til hurtigt at skifte mellem varianter. [Learn more](/docs/keybinds). --- -## Indlæser modeller +## Indlæsning af modeller Når OpenCode starter op, søger den efter modeller i følgende prioriterede rækkefølge: diff --git a/packages/web/src/content/docs/da/modes.mdx b/packages/web/src/content/docs/da/modes.mdx index e6cb4b39f..40a5303f2 100644 --- a/packages/web/src/content/docs/da/modes.mdx +++ b/packages/web/src/content/docs/da/modes.mdx @@ -17,7 +17,7 @@ Du kan skifte mellem tilstande under en session eller konfigurere dem i din konf --- -## Indbygget +## Indbyggede opencode leveres med to indbyggede tilstande. @@ -42,7 +42,7 @@ Denne tilstand er nyttig, når du vil have AI til at analysere kode, foreslå æ --- -## Skifter +## Skift Du kan skifte mellem tilstande under en session ved at bruge _Tab_-tasten. Eller din konfigurerede `switch_mode` nøglebinding. @@ -50,11 +50,11 @@ Se også: [Formatters](/docs/formatters) for information om konfiguration af kod --- -## Konfigurer +## Konfiguration Du kan tilpasse de indbyggede tilstande eller oprette dine egne gennem konfiguration. Tilstande kan konfigureres på to måder: -### JSON Konfiguration +### JSON-konfiguration Konfigurer tilstande i din `opencode.json`-konfigurationsfil: @@ -177,7 +177,7 @@ Hvis der ikke er angivet nogen temperatur, bruger opencode modelspecifikke stand --- -### Spørg +### Prompt Angiv en brugerdefineret systempromptfil for denne tilstand med `prompt`-konfigurationen. Promptfilen skal indeholde instruktioner, der er specifikke for tilstandens formål. @@ -245,7 +245,7 @@ Her er alle de værktøjer, der kan styres gennem tilstandskonfigurationen. Du kan oprette dine egne brugerdefinerede tilstande ved at tilføje dem til konfigurationen. Her er eksempler, der bruger begge tilgange: -### Bruger JSON konfiguration +### Brug af JSON-konfiguration ```json title="opencode.json" {4-14} { @@ -318,7 +318,7 @@ Priorities: --- -### Use cases +### Brugsscenarier Her er nogle almindelige brugstilfælde for forskellige tilstande. diff --git a/packages/web/src/content/docs/da/network.mdx b/packages/web/src/content/docs/da/network.mdx index 6218a9b86..a94868908 100644 --- a/packages/web/src/content/docs/da/network.mdx +++ b/packages/web/src/content/docs/da/network.mdx @@ -30,7 +30,7 @@ Du kan konfigurere serverens port og værtsnavn ved hjælp af [CLI flags](/docs/ --- -### Godkend +### Godkendelse Hvis din proxy kræver grundlæggende godkendelse, skal du inkludere legitimationsoplysninger i URL. diff --git a/packages/web/src/content/docs/da/plugins.mdx b/packages/web/src/content/docs/da/plugins.mdx index 689abdff0..a8532d599 100644 --- a/packages/web/src/content/docs/da/plugins.mdx +++ b/packages/web/src/content/docs/da/plugins.mdx @@ -9,7 +9,7 @@ For eksempler, tjek [plugins](/docs/ecosystem#plugins) oprettet af fællesskabet --- -## Brug et plugin +## Brug af plugin Der er to måder at indlæse plugins på. @@ -43,7 +43,7 @@ Gennemse tilgængelige plugins i [ecosystem](/docs/ecosystem#plugins). --- -### Hvordan plugins installeres +### Installation af plugins **npm plugins** installeres automatisk ved hjælp af Bun ved opstart. Pakker og deres afhængigheder cachelagres i `~/.cache/opencode/node_modules/`. @@ -51,7 +51,7 @@ Gennemse tilgængelige plugins i [ecosystem](/docs/ecosystem#plugins). --- -### Indlæs rækkefølge +### Indlæsningsrækkefølge Plugins indlæses fra alle kilder, og alle hooks kører i rækkefølge. Indlæsningsrækkefølgen er: @@ -64,7 +64,7 @@ Dublerede npm-pakker med samme navn og version indlæses én gang. Et lokalt plu --- -## Opret et plugin +## Oprettelse af plugin Et plugin er et **JavaScript/TypeScript modul**, der eksporterer et eller flere plugin funktioner. Hver funktion modtager et kontekstobjekt og returnerer et hooks-objekt. @@ -156,7 +156,7 @@ Plugins kan abonnere på begivenheder som vist nedenfor i afsnittet Eksempler. H - `installation.updated` -#### LSP Begivenheder +#### LSP-hændelser - `lsp.client.diagnostics` - `lsp.updated` @@ -168,7 +168,7 @@ Plugins kan abonnere på begivenheder som vist nedenfor i afsnittet Eksempler. H - `message.removed` - `message.updated` -#### Tilladelsesbegivenheder +#### Tilladelseshændelser - `permission.asked` - `permission.replied` @@ -177,7 +177,7 @@ Plugins kan abonnere på begivenheder som vist nedenfor i afsnittet Eksempler. H - `server.connected` -#### Sessionsbegivenheder +#### Sessionshændelser - `session.created` - `session.compacted` @@ -188,20 +188,20 @@ Plugins kan abonnere på begivenheder som vist nedenfor i afsnittet Eksempler. H - `session.status` - `session.updated` -#### Todo-begivenheder +#### Todo-hændelser - `todo.updated` -#### Shell-begivenheder +#### Shell-hændelser - `shell.env` -#### Værktøjsbegivenheder +#### Værktøjshændelser - `tool.execute.after` - `tool.execute.before` -#### TUI Begivenheder +#### TUI-hændelser - `tui.prompt.append` - `tui.command.execute` @@ -240,7 +240,7 @@ Hvis du bruger OpenCode desktop-appen, kan den sende systemmeddelelser automatis --- -###.env-beskyttelse +### .env-beskyttelse Undgå opencode i at læse `.env` filer: @@ -331,7 +331,7 @@ Niveauer: `debug`, `info`, `warn`, `error`. Se [SDK documentation](https://openc --- -### Komprimeringskroge +### Komprimerings-hooks Tilpas konteksten inkluderet, når en session komprimeres: diff --git a/packages/web/src/content/docs/da/providers.mdx b/packages/web/src/content/docs/da/providers.mdx index 396ffbe51..829ae4613 100644 --- a/packages/web/src/content/docs/da/providers.mdx +++ b/packages/web/src/content/docs/da/providers.mdx @@ -1,37 +1,35 @@ --- -title: Leverandører -description: Bruge en hvilken som helst LLM-leverandør i OpenCode. +title: Udbydere +description: Brug en hvilken som helst LLM-udbyder i OpenCode. --- import config from "../../../../config.mjs" export const console = config.console -OpenCode bruger [AI SDK](https://ai-sdk.dev/) og [Models.dev](https://models.dev) for at støtte **75+ LLM leverandører** og den støtter kjøring av lokale modeller. +OpenCode bruger [AI SDK](https://ai-sdk.dev/) og [Models.dev](https://models.dev) til at understøtte **75+ LLM-udbydere** og understøtter kørsel af lokale modeller. -For at tilføje til en leverandør må du: +For at tilføje en udbyder skal du: -1. Legg til API-nøklene for leverandøren ved at bruge kommandoen `/connect`. -2. Konfigurer leverandøren i OpenCode-konfigurasjonen. +1. Tilføje API-nøglerne for udbyderen ved at bruge kommandoen `/connect`. +2. Konfigurere udbyderen i OpenCode-konfigurationen. --- -### Legitimasjon +### Legitimationsoplysninger -Når du tilføjer til en leverandørs API-nøkler med `/connect`-kommandoen, lagres de -i `~/.local/share/opencode/auth.json`. +Når du tilføjer en udbyders API-nøgler med `/connect`-kommandoen, gemmes de i `~/.local/share/opencode/auth.json`. --- -### Konfig +### Konfiguration -Du kan tilpasse leverandørene gjennom `provider`-delen i OpenCode -konfig. +Du kan tilpasse udbyderne gennem `provider`-delen i OpenCode-konfigurationen. --- #### Base URL -Du kan tilpasse basen URL for enhver leverandør ved at angi alternativet `baseURL`. Dette er nyttig når du bruger proxy-tjenester eller tilpassede endepunkter. +Du kan tilpasse base URL for enhver udbyder ved at angive muligheden `baseURL`. Dette er nyttigt, når du bruger proxy-tjenester eller tilpassede endpoints. ```json title="opencode.json" {6} { @@ -50,22 +48,21 @@ Du kan tilpasse basen URL for enhver leverandør ved at angi alternativet `baseU ## OpenCode Zen -OpenCode Zen er en liste over modeller levert av OpenCode-teamet som har vært -testet og verifisert for at fungere godt med OpenCode. [Finn ut mer](/docs/zen). +OpenCode Zen er en liste over modeller leveret af OpenCode-teamet, som er blevet testet og verificeret til at fungere godt med OpenCode. [Læs mere](/docs/zen). :::tip Hvis du er ny, anbefaler vi at starte med OpenCode Zen. ::: -1. Kjør kommandoen `/connect` i TUI, velg opencode og gå til [opencode.ai/auth](https://opencode.ai/auth). +1. Kør kommandoen `/connect` i TUI, vælg opencode og gå til [opencode.ai/auth](https://opencode.ai/auth). ```txt /connect ``` -2. Logg på, tilføj til faktureringsdetaljene dine og kopier API-nøgleen. +2. Log ind, tilføj dine faktureringsoplysninger og kopier API-nøglen. -3. Lim inn API-nøgleen. +3. Indsæt API-nøglen. ```txt ┌ API key @@ -74,38 +71,37 @@ Hvis du er ny, anbefaler vi at starte med OpenCode Zen. └ enter ``` -4. Kjør `/models` i TUI for at se listen over modeller vi anbefaler. +4. Kør `/models` i TUI for at se listen over modeller, vi anbefaler. ```txt /models ``` -Det fungerer som alle andre leverandører i OpenCode og er helt valgfritt at bruge. +Det fungerer som alle andre udbydere i OpenCode og er helt valgfrit at bruge. --- ## Katalog -La oss se på nogle av leverandørene i detalj. Hvis du vil tilføje til en leverandør til -liste, åpne gjerne en PR. +Lad os se på nogle af udbyderne i detaljer. Hvis du vil tilføje en udbyder til listen, er du velkommen til at åbne en PR. :::note -Ser du ikke en leverandør her? Send inn en PR. +Ser du ikke en udbyder her? Indsend en PR. ::: --- ### 302.AI -1. Gå over til [302.AI-konsollen](https://302.ai/), opret en konto og generer en API-nøgle. +1. Gå til [302.AI-konsollen](https://302.ai/), opret en konto og generer en API-nøgle. -2. Kjør kommandoen `/connect` og søk etter **302.AI**. +2. Kør kommandoen `/connect` og søg efter **302.AI**. ```txt /connect ``` -3. Skriv inn 302.AI API-nøgleen. +3. Indtast 302.AI API-nøglen. ```txt ┌ API key @@ -114,7 +110,7 @@ Ser du ikke en leverandør her? Send inn en PR. └ enter ``` -4. Kjør kommandoen `/models` for at velge en modell. +4. Kør kommandoen `/models` for at vælge en model. ```txt /models @@ -122,22 +118,21 @@ Ser du ikke en leverandør her? Send inn en PR. --- -### Amazonas grunnfjell +### Amazon Bedrock -Slik bruger du Amazon Bedrock med OpenCode: +Sådan bruger du Amazon Bedrock med OpenCode: -1. Gå over til **modellkatalogen** i Amazon Bedrock-konsollen og be om - tilgang til modellene du ønsker. +1. Gå til **modelkataloget** i Amazon Bedrock-konsollen og anmod om adgang til de modeller, du ønsker. :::tip - Du må ha tilgang til modellen du ønsker i Amazon Bedrock. + Du skal have adgang til modellen du ønsker i Amazon Bedrock. ::: -2. **Konfigurer autentisering** ved at bruge en av følgende metoder: +2. **Konfigurer godkendelse** ved at bruge en af følgende metoder: #### Miljøvariabler (hurtigstart) - Angi en av disse miljøvariablene mens du kjører opencode: + Angiv en af disse miljøvariabler, mens du kører opencode: ```bash # Option 1: Using AWS access keys @@ -150,16 +145,16 @@ Slik bruger du Amazon Bedrock med OpenCode: AWS_BEARER_TOKEN_BEDROCK=XXX opencode ``` - Eller tilføj dem til bash-profilen din: + Eller tilføj dem til din bash-profil: ```bash title="~/.bash_profile" export AWS_PROFILE=my-dev-profile export AWS_REGION=us-east-1 ``` - #### Konfigurasjonsfil (anbefalt) + #### Konfigurationsfil (anbefalet) - For prosjektspesifikk eller vedvarende konfigurasjon, brug `opencode.json`: + For projektspecifik eller vedvarende konfiguration, brug `opencode.json`: ```json title="opencode.json" { @@ -175,18 +170,18 @@ Slik bruger du Amazon Bedrock med OpenCode: } ``` - **Tilgjengelige alternativer:** + **Tilgængelige muligheder:** - `region` - AWS region (f.eks. `us-east-1`, `eu-west-1`) - - `profile` - AWS navngitt profil fra `~/.aws/credentials` - - `endpoint` - Egendefinert endepunkt URL for VPC endepunkter (alias for generisk `baseURL`-alternativ) + - `profile` - AWS navngivet profil fra `~/.aws/credentials` + - `endpoint` - Brugerdefineret endpoint URL for VPC endpoints (alias for generisk `baseURL`-mulighed) :::tip - Alternativer for konfigurasjonsfil har forrang over miljøvariabler. + Konfigurationsfil-muligheder har forrang over miljøvariabler. ::: - #### Avansert: VPC Sluttpunkter + #### Avanceret: VPC Endpoints - Hvis du bruger VPC endepunkter for Berggrunn: + Hvis du bruger VPC endpoints for Bedrock: ```json title="opencode.json" { @@ -204,33 +199,33 @@ Slik bruger du Amazon Bedrock med OpenCode: ``` :::note - Alternativet `endpoint` er et alias for det generiske alternativet `baseURL`, ved at bruge AWS-spesifikk terminologi. Hvis både `endpoint` og `baseURL` er spesifisert, har `endpoint` forrang. + Muligheden `endpoint` er et alias for den generiske mulighed `baseURL`, der bruger AWS-specifik terminologi. Hvis både `endpoint` og `baseURL` er specificeret, har `endpoint` forrang. ::: - #### Autentiseringsmetoder - - **`AWS_ACCESS_KEY_ID` / `AWS_SECRET_ACCESS_KEY`**: Opret en IAM-bruger og generer tilgangsnøkler i AWS-konsollen - - **`AWS_PROFILE`**: Brug navngitte profiler fra `~/.aws/credentials`. Konfigurer først med `aws configure --profile my-profile` eller `aws sso login` - - **`AWS_BEARER_TOKEN_BEDROCK`**: Generer langsiktige API-nøkler fra Amazon Bedrock-konsollen - - **`AWS_WEB_IDENTITY_TOKEN_FILE` / `AWS_ROLE_ARN`**: For EKS IRSA (IAM roller for tjenestekontoer) eller andre Kubernetes-miljøer med OIDC føderasjon. Disse miljøvariablene injiseres automatisk av Kubernetes når du bruger tjenestekontokommentarer. + #### Godkendelsesmetoder + - **`AWS_ACCESS_KEY_ID` / `AWS_SECRET_ACCESS_KEY`**: Opret en IAM-bruger og generer adgangsnøgler i AWS-konsollen + - **`AWS_PROFILE`**: Brug navngivne profiler fra `~/.aws/credentials`. Konfigurer først med `aws configure --profile my-profile` eller `aws sso login` + - **`AWS_BEARER_TOKEN_BEDROCK`**: Generer langsigtede API-nøgler fra Amazon Bedrock-konsollen + - **`AWS_WEB_IDENTITY_TOKEN_FILE` / `AWS_ROLE_ARN`**: For EKS IRSA (IAM roller for tjenestekonti) eller andre Kubernetes-miljøer med OIDC føderation. Disse miljøvariabler injiceres automatisk af Kubernetes, når du bruger tjenestekontokommentarer. - #### Autentiseringsprioritet + #### Godkendelsesprioritet - Amazon Bedrock bruger følgende autentiseringsprioritet: + Amazon Bedrock bruger følgende godkendelsesprioritet: 1. **Bearer Token** - `AWS_BEARER_TOKEN_BEDROCK` miljøvariabel eller token fra kommandoen `/connect` - 2. **AWS legitimasjonskjede** - profil, tilgangsnøkler, delt legitimasjon, IAM roller, nettidentitetstokener (EKS IRSA), forekomstmetadata + 2. **AWS legitimationskæde** - profil, adgangsnøgler, delte legitimationsoplysninger, IAM roller, webidentitetstokens (EKS IRSA), instansmetadata :::note - Når et bærertoken er angitt (via `/connect` eller `AWS_BEARER_TOKEN_BEDROCK`), har det forrang over alle AWS legitimasjonsmetoder inkludert konfigurerte profiler. + Når et bearer token er angivet (via `/connect` eller `AWS_BEARER_TOKEN_BEDROCK`), har det forrang over alle AWS godkendelsesmetoder inklusiv konfigurerede profiler. ::: -3. Kjør kommandoen `/models` for at velge modellen du ønsker. +3. Kør kommandoen `/models` for at vælge den model, du ønsker. ```txt /models ``` :::note -For egendefinerte slutningsprofiler, brug modellen og leverandørnavnet i nøkkelen og sett egenskapen `id` til arn. Dette sikrer korrekt caching: +For brugerdefinerede inferensprofiler, brug modellen og udbydernavnet i nøglen og sæt egenskaben `id` til arn. Dette sikrer korrekt caching: ```json title="opencode.json" { @@ -252,16 +247,15 @@ For egendefinerte slutningsprofiler, brug modellen og leverandørnavnet i nøkke --- -### Antropisk +### Anthropic -1. Når du har registrert deg, kjør kommandoen `/connect` og velg Antropisk. +1. Når du har registreret dig, kør kommandoen `/connect` og vælg Anthropic. ```txt /connect ``` -2. Her kan du velge alternativet **Claude Pro/Max** og det vil åpne nettleseren din - og ber deg om at autentisere. +2. Her kan du vælge muligheden **Claude Pro/Max**, og det vil åbne din browser og bede dig om at godkende. ```txt ┌ Select auth method @@ -272,47 +266,47 @@ For egendefinerte slutningsprofiler, brug modellen og leverandørnavnet i nøkke └ ``` -3. Nå skal alle de antropiske modellene være tilgængelige når du bruger kommandoen `/models`. +3. Nu skal alle de Anthropiske modeller være tilgængelige, når du bruger kommandoen `/models`. ```txt /models ``` :::info -Å bruge Claude Pro/Max-abonnementet ditt i OpenCode støttes ikke offisielt av [Anthropic](https://anthropic.com). +At bruge dit Claude Pro/Max-abonnement i OpenCode understøttes ikke officielt af [Anthropic](https://anthropic.com). ::: -##### Bruge API-tastene +##### Brug API-nøgler -Du kan også velge **Opret en API-nøgle** hvis du ikke har et Pro/Max-abonnement. Den åpner også nettleseren din og ber deg logge på Anthropic og gi deg en kode du kan lime inn i terminalen din. +Du kan også vælge **Create an API Key**, hvis du ikke har et Pro/Max-abonnement. Det åbner også din browser og beder dig logge på Anthropic og giver dig en kode, du kan indsætte i din terminal. -Eller hvis du allerede har en API-nøgle, kan du velge **Angi API-nøgle manuelt** og lime den inn i terminalen. +Eller hvis du allerede har en API-nøgle, kan du vælge **Manually enter API Key** og indsætte den i terminalen. --- ### Azure OpenAI :::note -Hvis du støter på «Beklager, men jeg kan ikke hjelpe med den forespørselen»-feil, kan du prøve at endre innholdsfilteret fra **DefaultV2** til **Default** i Azure-ressursen. +Hvis du støder på "Beklager, men jeg kan ikke hjælpe med den anmodning"-fejl, kan du prøve at ændre indholdsfilteret fra **DefaultV2** til **Default** i Azure-ressourcen. ::: -1. Gå over til [Azure-portalen](https://portal.azure.com/) og lag en **Azure OpenAI**-ressurs. Du trenger: - - **Ressursnavn**: Dette blir en del av API-endepunktet (`https://RESOURCE_NAME.openai.azure.com/`) - - **API-nøgle**: Enten `KEY 1` eller `KEY 2` fra ressursen din +1. Gå til [Azure-portalen](https://portal.azure.com/) og opret en **Azure OpenAI**-ressource. Du skal bruge: + - **Ressourcenavn**: Dette bliver en del af API-endpointet (`https://RESOURCE_NAME.openai.azure.com/`) + - **API-nøgle**: Enten `KEY 1` eller `KEY 2` fra din ressource -2. Gå til [Azure AI Foundry](https://ai.azure.com/) og distribuer en modell. +2. Gå til [Azure AI Foundry](https://ai.azure.com/) og distribuer en model. :::note - Distribusjonsnavnet må samsvare med modellnavnet for at opencode skal fungere skikkelig. + Distributionsnavnet skal matche modelnavnet for at opencode skal fungere korrekt. ::: -3. Kjør kommandoen `/connect` og søk etter **Azure**. +3. Kør kommandoen `/connect` og søg efter **Azure**. ```txt /connect ``` -4. Skriv inn API-nøgleen. +4. Indtast API-nøglen. ```txt ┌ API key @@ -321,19 +315,19 @@ Hvis du støter på «Beklager, men jeg kan ikke hjelpe med den forespørselen» └ enter ``` -5. Angi ressursnavnet ditt som en miljøvariabel: +5. Angiv dit ressourcenavn som en miljøvariabel: ```bash AZURE_RESOURCE_NAME=XXX opencode ``` - Eller tilføj den til bash-profilen din: + Eller tilføj den til din bash-profil: ```bash title="~/.bash_profile" export AZURE_RESOURCE_NAME=XXX ``` -6. Kjør kommandoen `/models` for at velge den distribuerte modellen. +6. Kør kommandoen `/models` for at vælge den distribuerede model. ```txt /models @@ -343,23 +337,23 @@ Hvis du støter på «Beklager, men jeg kan ikke hjelpe med den forespørselen» ### Azure Cognitive Services -1. Gå over til [Azure-portalen](https://portal.azure.com/) og lag en **Azure OpenAI**-ressurs. Du trenger: - - **Ressursnavn**: Dette blir en del av API-endepunktet (`https://AZURE_COGNITIVE_SERVICES_RESOURCE_NAME.cognitiveservices.azure.com/`) - - **API-nøgle**: Enten `KEY 1` eller `KEY 2` fra ressursen din +1. Gå til [Azure-portalen](https://portal.azure.com/) og opret en **Azure OpenAI**-ressource. Du skal bruge: + - **Ressourcenavn**: Dette bliver en del af API-endpointet (`https://AZURE_COGNITIVE_SERVICES_RESOURCE_NAME.cognitiveservices.azure.com/`) + - **API-nøgle**: Enten `KEY 1` eller `KEY 2` fra din ressource -2. Gå til [Azure AI Foundry](https://ai.azure.com/) og distribuer en modell. +2. Gå til [Azure AI Foundry](https://ai.azure.com/) og distribuer en model. :::note - Distribusjonsnavnet må samsvare med modellnavnet for at opencode skal fungere skikkelig. + Distributionsnavnet skal matche modelnavnet for at opencode skal fungere korrekt. ::: -3. Kjør kommandoen `/connect` og søk etter **Azure Cognitive Services**. +3. Kør kommandoen `/connect` og søg efter **Azure Cognitive Services**. ```txt /connect ``` -4. Skriv inn API-nøgleen. +4. Indtast API-nøglen. ```txt ┌ API key @@ -368,19 +362,19 @@ Hvis du støter på «Beklager, men jeg kan ikke hjelpe med den forespørselen» └ enter ``` -5. Angi ressursnavnet ditt som en miljøvariabel: +5. Angiv dit ressourcenavn som en miljøvariabel: ```bash AZURE_COGNITIVE_SERVICES_RESOURCE_NAME=XXX opencode ``` - Eller tilføj den til bash-profilen din: + Eller tilføj den til din bash-profil: ```bash title="~/.bash_profile" export AZURE_COGNITIVE_SERVICES_RESOURCE_NAME=XXX ``` -6. Kjør kommandoen `/models` for at velge den distribuerte modellen. +6. Kør kommandoen `/models` for at vælge den distribuerede model. ```txt /models @@ -390,15 +384,15 @@ Hvis du støter på «Beklager, men jeg kan ikke hjelpe med den forespørselen» ### Baseten -1. Gå over til [Baseten](https://app.baseten.co/), opret en konto og generer en API-nøgle. +1. Gå til [Baseten](https://app.baseten.co/), opret en konto og generer en API-nøgle. -2. Kjør kommandoen `/connect` og søk etter **Baseten**. +2. Kør kommandoen `/connect` og søg efter **Baseten**. ```txt /connect ``` -3. Skriv inn din Baseten API-nøgle. +3. Indtast din Baseten API-nøgle. ```txt ┌ API key @@ -407,7 +401,7 @@ Hvis du støter på «Beklager, men jeg kan ikke hjelpe med den forespørselen» └ enter ``` -4. Kjør kommandoen `/models` for at velge en modell. +4. Kør kommandoen `/models` for at vælge en model. ```txt /models @@ -417,15 +411,15 @@ Hvis du støter på «Beklager, men jeg kan ikke hjelpe med den forespørselen» ### Cerebras -1. Gå over til [Cerebras-konsollen](https://inference.cerebras.ai/), opret en konto og generer en API-nøgle. +1. Gå til [Cerebras-konsollen](https://inference.cerebras.ai/), opret en konto og generer en API-nøgle. -2. Kjør kommandoen `/connect` og søk etter **Cerebras**. +2. Kør kommandoen `/connect` og søg efter **Cerebras**. ```txt /connect ``` -3. Skriv inn Cerebras API-nøgleen. +3. Indtast Cerebras API-nøglen. ```txt ┌ API key @@ -434,7 +428,7 @@ Hvis du støter på «Beklager, men jeg kan ikke hjelpe med den forespørselen» └ enter ``` -4. Kjør kommandoen `/models` for at velge en modell som _Qwen 3 Coder 480B_. +4. Kør kommandoen `/models` for at vælge en model som _Qwen 3 Coder 480B_. ```txt /models @@ -444,24 +438,24 @@ Hvis du støter på «Beklager, men jeg kan ikke hjelpe med den forespørselen» ### Cloudflare AI Gateway -Cloudflare AI Gateway lar deg få tilgang til modeller fra OpenAI, Anthropic, Workers AI og mer gjennom et enhetlig endepunkt. Med [Unified Billing](https://developers.cloudflare.com/ai-gateway/features/unified-billing/) trenger du ikke separate API-nøkler for hver leverandør. +Cloudflare AI Gateway lader dig få adgang til modeller fra OpenAI, Anthropic, Workers AI og flere gennem et samlet endpoint. Med [Unified Billing](https://developers.cloudflare.com/ai-gateway/features/unified-billing/) behøver du ikke separate API-nøgler for hver udbyder. -1. Gå over til [Cloudflare-dashbordet](https://dash.cloudflare.com/), naviger til **AI** > **AI Gateway**, og lag en ny gateway. +1. Gå til [Cloudflare-dashboardet](https://dash.cloudflare.com/), naviger til **AI** > **AI Gateway**, og opret en ny gateway. -2. Angi konto ID og gateway ID som miljøvariabler. +2. Angiv konto-ID og gateway-ID som miljøvariabler. ```bash title="~/.bash_profile" export CLOUDFLARE_ACCOUNT_ID=your-32-character-account-id export CLOUDFLARE_GATEWAY_ID=your-gateway-id ``` -3. Kjør kommandoen `/connect` og søk etter **Cloudflare AI Gateway**. +3. Kør kommandoen `/connect` og søg efter **Cloudflare AI Gateway**. ```txt /connect ``` -4. Skriv inn Cloudflare API-tokenet ditt. +4. Indtast din Cloudflare API-token. ```txt ┌ API key @@ -470,19 +464,19 @@ Cloudflare AI Gateway lar deg få tilgang til modeller fra OpenAI, Anthropic, Wo └ enter ``` - Eller angi den som en miljøvariabel. + Eller angiv den som en miljøvariabel. ```bash title="~/.bash_profile" export CLOUDFLARE_API_TOKEN=your-api-token ``` -5. Kjør kommandoen `/models` for at velge en modell. +5. Kør kommandoen `/models` for at vælge en model. ```txt /models ``` - Du kan også tilføje til modeller gjennom opencode-konfigurasjonen. + Du kan også tilføje modeller gennem opencode-konfigurationen. ```json title="opencode.json" { @@ -502,15 +496,15 @@ Cloudflare AI Gateway lar deg få tilgang til modeller fra OpenAI, Anthropic, Wo ### Cortecs -1. Gå over til [Cortecs-konsollen](https://cortecs.ai/), opret en konto og generer en API-nøgle. +1. Gå til [Cortecs-konsollen](https://cortecs.ai/), opret en konto og generer en API-nøgle. -2. Kjør kommandoen `/connect` og søk etter **Cortecs**. +2. Kør kommandoen `/connect` og søg efter **Cortecs**. ```txt /connect ``` -3. Skriv inn Cortecs API-nøgleen. +3. Indtast Cortecs API-nøglen. ```txt ┌ API key @@ -519,7 +513,7 @@ Cloudflare AI Gateway lar deg få tilgang til modeller fra OpenAI, Anthropic, Wo └ enter ``` -4. Kjør kommandoen `/models` for at velge en modell som _Kimi K2 Instruct_. +4. Kør kommandoen `/models` for at vælge en model som _Kimi K2 Instruct_. ```txt /models @@ -529,15 +523,15 @@ Cloudflare AI Gateway lar deg få tilgang til modeller fra OpenAI, Anthropic, Wo ### DeepSeek -1. Gå over til [DeepSeek-konsollen](https://platform.deepseek.com/), opret en konto og klikk på **Opret ny API-nøgle**. +1. Gå til [DeepSeek-konsollen](https://platform.deepseek.com/), opret en konto og klik på **Create API Key**. -2. Kjør kommandoen `/connect` og søk etter **DeepSeek**. +2. Kør kommandoen `/connect` og søg efter **DeepSeek**. ```txt /connect ``` -3. Skriv inn DeepSeek API-nøgleen. +3. Indtast DeepSeek API-nøglen. ```txt ┌ API key @@ -546,7 +540,7 @@ Cloudflare AI Gateway lar deg få tilgang til modeller fra OpenAI, Anthropic, Wo └ enter ``` -4. Kjør kommandoen `/models` for at velge en DeepSeek-modell som _DeepSeek Reasoner_. +4. Kør kommandoen `/models` for at vælge en DeepSeek-model som _DeepSeek Reasoner_. ```txt /models @@ -556,15 +550,15 @@ Cloudflare AI Gateway lar deg få tilgang til modeller fra OpenAI, Anthropic, Wo ### Deep Infra -1. Gå over til [Deep Infra-dashbordet](https://deepinfra.com/dash), opret en konto og generer en API-nøgle. +1. Gå til [Deep Infra-dashboardet](https://deepinfra.com/dash), opret en konto og generer en API-nøgle. -2. Kjør kommandoen `/connect` og søk etter **Deep Infra**. +2. Kør kommandoen `/connect` og søg efter **Deep Infra**. ```txt /connect ``` -3. Skriv inn Deep Infra API-nøgleen. +3. Indtast Deep Infra API-nøglen. ```txt ┌ API key @@ -573,7 +567,7 @@ Cloudflare AI Gateway lar deg få tilgang til modeller fra OpenAI, Anthropic, Wo └ enter ``` -4. Kjør kommandoen `/models` for at velge en modell. +4. Kør kommandoen `/models` for at vælge en model. ```txt /models @@ -581,17 +575,17 @@ Cloudflare AI Gateway lar deg få tilgang til modeller fra OpenAI, Anthropic, Wo --- -### Fastvare +### Firmware -1. Gå over til [Firmware dashboard](https://app.firmware.ai/signup), opret en konto og generer en API-nøgle. +1. Gå til [Firmware dashboard](https://app.firmware.ai/signup), opret en konto og generer en API-nøgle. -2. Kjør kommandoen `/connect` og søk etter **Firmware**. +2. Kør kommandoen `/connect` og søg efter **Firmware**. ```txt /connect ``` -3. Skriv inn firmware API-nøgleen. +3. Indtast firmware API-nøglen. ```txt ┌ API key @@ -600,7 +594,7 @@ Cloudflare AI Gateway lar deg få tilgang til modeller fra OpenAI, Anthropic, Wo └ enter ``` -4. Kjør kommandoen `/models` for at velge en modell. +4. Kør kommandoen `/models` for at vælge en model. ```txt /models @@ -608,17 +602,17 @@ Cloudflare AI Gateway lar deg få tilgang til modeller fra OpenAI, Anthropic, Wo --- -### Fyrverkeri AI +### Fireworks AI -1. Gå over til [Fireworks AI-konsollen](https://app.fireworks.ai/), opret en konto og klikk på **Create API Key**. +1. Gå til [Fireworks AI-konsollen](https://app.fireworks.ai/), opret en konto og klik på **Create API Key**. -2. Kjør kommandoen `/connect` og søk etter **Fireworks AI**. +2. Kør kommandoen `/connect` og søg efter **Fireworks AI**. ```txt /connect ``` -3. Skriv inn Fireworks AI API-nøgleen. +3. Indtast Fireworks AI API-nøglen. ```txt ┌ API key @@ -627,7 +621,7 @@ Cloudflare AI Gateway lar deg få tilgang til modeller fra OpenAI, Anthropic, Wo └ enter ``` -4. Kjør kommandoen `/models` for at velge en modell som _Kimi K2 Instruct_. +4. Kør kommandoen `/models` for at vælge en model som _Kimi K2 Instruct_. ```txt /models @@ -637,15 +631,15 @@ Cloudflare AI Gateway lar deg få tilgang til modeller fra OpenAI, Anthropic, Wo ### GitLab Duo -GitLab Duo gir AI-drevet agentchat med native verktøyoppringingsfunksjoner gjennom GitLabs antropiske proxy. +GitLab Duo giver AI-drevet agentchat med native værktøjskaldsfunktioner gennem GitLabs anthropiske proxy. -1. Kjør kommandoen `/connect` og velg GitLab. +1. Kør kommandoen `/connect` og vælg GitLab. ```txt /connect ``` -2. Velg autentiseringsmetoden din: +2. Vælg din godkendelsesmetode: ```txt ┌ Select auth method @@ -655,40 +649,40 @@ GitLab Duo gir AI-drevet agentchat med native verktøyoppringingsfunksjoner gjen └ ``` - #### Bruge OAuth (anbefalt) + #### Brug OAuth (anbefalet) - Velg **OAuth** og nettleseren din åpnes for autorisasjon. + Vælg **OAuth** og din browser åbner for autorisation. - #### Bruger personlig tilgangstoken + #### Brug personlig adgangstoken 1. Gå til [GitLab User Settings > Access Tokens](https://gitlab.com/-/user_settings/personal_access_tokens) - 2. Klikk på **Legg til nytt token** + 2. Klik på **Add new token** 3. Navn: `OpenCode`, omfang: `api` 4. Kopier tokenet (starter med `glpat-`) - 5. Skriv den inn i terminalen + 5. Indtast den i terminalen -3. Kjør kommandoen `/models` for at se tilgængelige modeller. +3. Kør kommandoen `/models` for at se tilgængelige modeller. ```txt /models ``` - Tre Claude-baserte modeller er tilgængelige: - - **duo-chat-haiku-4-5** (standard) - Raske svar for raske oppgaver - - **duo-chat-sonnet-4-5** - Balansert ytelse for de fleste arbeidsflyter - - **duo-chat-opus-4-5** - Mest egnet for kompleks analyse + Tre Claude-baserede modeller er tilgængelige: + - **duo-chat-haiku-4-5** (standard) - Hurtige svar til hurtige opgaver + - **duo-chat-sonnet-4-5** - Balanceret ydeevne til de fleste arbejdsgange + - **duo-chat-opus-4-5** - Mest egnet til kompleks analyse :::note -Du kan også spesifisere 'GITLAB_TOKEN' miljøvariabel hvis du ikke vil -for at lagre token i opencode auth-lagring. +Du kan også specificere 'GITLAB_TOKEN' miljøvariabel, hvis du ikke vil +gemme tokenet i opencode auth-lagring. ::: ##### Selvhostet GitLab -:::note[compliance note] -OpenCode bruger en liten modell for nogle AI oppgaver som at generere sessiontittelen. -Den er konfigurert til at bruge gpt-5-nano som standard, hostet av Zen. For at låse OpenCode -for kun at bruge din egen GitLab-hostede forekomst, tilføj til følgende i din -`opencode.json` fil. Det anbefales også at deaktivere sessiondeling. +:::note[overholdelsesbemærkning] +OpenCode bruger en lille model til nogle AI-opgaver som at generere sessionstitlen. +Den er konfigureret til at bruge gpt-5-nano som standard, hostet af Zen. For at låse OpenCode +til kun at bruge din egen GitLab-hostede instans, tilføj følgende i din +`opencode.json` fil. Det anbefales også at deaktivere sessionsdeling. ```json { @@ -700,20 +694,20 @@ for kun at bruge din egen GitLab-hostede forekomst, tilføj til følgende i din ::: -For selvhostede GitLab-forekomster: +For selvhostede GitLab-instanser: ```bash export GITLAB_INSTANCE_URL=https://gitlab.company.com export GITLAB_TOKEN=glpat-... ``` -Hvis forekomsten din kjører en brugerdefineret AI-gateway: +Hvis din instans kører en brugerdefineret AI-gateway: ```bash GITLAB_AI_GATEWAY_URL=https://ai-gateway.company.com ``` -Eller tilføj til bash-profilen din: +Eller tilføj til din bash-profil: ```bash title="~/.bash_profile" export GITLAB_INSTANCE_URL=https://gitlab.company.com @@ -722,35 +716,35 @@ export GITLAB_TOKEN=glpat-... ``` :::note -GitLab-administratoren din må aktivere følgende: +Din GitLab-administrator skal aktivere følgende: -1. [Duo Agent Platform](https://docs.gitlab.com/user/gitlab_duo/turn_on_off/) for brugeren, gruppen eller forekomsten -2. Funksjonsflagg (via Rails-konsollen): +1. [Duo Agent Platform](https://docs.gitlab.com/user/gitlab_duo/turn_on_off/) for brugeren, gruppen eller instansen +2. Funktionsflag (via Rails-konsollen): - `agent_platform_claude_code` - `third_party_agents_enabled` ::: -##### OAuth for selvvertsbaserte forekomster +##### OAuth for selvhostede instanser -For at få Oauth til at fungere for din selvhostede forekomst, må du oprete -en ny applikasjon (Innstillinger → Programmer) med +For at få Oauth til at fungere for din selvhostede instans, skal du oprette +en ny applikation (Indstillinger → Applikationer) med callback URL `http://127.0.0.1:8080/callback` og følgende omfang: -- api (Få tilgang til API på dine vegne) -- read_user (Les din personlige informasjon) -- read_repository (tillater skrivebeskyttet tilgang til depotet) +- api (Få adgang til API på dine vegne) +- read_user (Læs din personlige information) +- read_repository (tillader skrivebeskyttet adgang til depotet) -Utsett deretter applikasjonen ID som miljøvariabel: +Udsæt derefter applikations-ID som miljøvariabel: ```bash export GITLAB_OAUTH_CLIENT_ID=your_application_id_here ``` -Mer dokumentasjon på [opencode-gitlab-auth](https://www.npmjs.com/package/@gitlab/opencode-gitlab-auth) hjemmeside. +Mere dokumentation på [opencode-gitlab-auth](https://www.npmjs.com/package/@gitlab/opencode-gitlab-auth) hjemmesiden. -##### Konfigurasjon +##### Konfiguration -Tilpass gjennom `opencode.json`: +Tilpas gennem `opencode.json`: ```json title="opencode.json" { @@ -769,9 +763,9 @@ Tilpass gjennom `opencode.json`: } ``` -##### GitLab API Verktøy (valgfritt, men sterkt anbefalt) +##### GitLab API-værktøjer (valgfrit, men stærkt anbefalet) -For at få tilgang til GitLab-verktøy (sammenslåingsforespørsler, problemer, pipelines, CI/CD, etc.): +For at få adgang til GitLab-værktøjer (merge requests, problemer, pipelines, CI/CD, etc.): ```json title="opencode.json" { @@ -780,28 +774,28 @@ For at få tilgang til GitLab-verktøy (sammenslåingsforespørsler, problemer, } ``` -Denne plugin-en gir omfattende GitLab-repository-administrasjonsfunksjoner, inkludert MR-anmeldelser, problemsporing, pipeline-overvåking og mer. +Denne plugin giver omfattende GitLab-repository-administrationsfunktioner, inklusiv MR-anmeldelser, problemsporing, pipeline-overvågning og mere. --- ### GitHub Copilot -Slik bruger du GitHub Copilot-abonnementet med OpenCode: +Sådan bruger du GitHub Copilot-abonnementet med OpenCode: :::note -Nogle modeller kan trenge en [Pro+ +Nogle modeller kan kræve et [Pro+ abonnement](https://github.com/features/copilot/plans) at bruge. -Nogle modeller må aktiveres manuelt i [GitHub Copilot-innstillingene](https://docs.github.com/en/copilot/how-tos/use-ai-models/configure-access-to-ai-models#setup-for-individual-use). +Nogle modeller skal aktiveres manuelt i [GitHub Copilot-indstillingerne](https://docs.github.com/en/copilot/how-tos/use-ai-models/configure-access-to-ai-models#setup-for-individual-use). ::: -1. Kjør kommandoen `/connect` og søk etter GitHub Copilot. +1. Kør kommandoen `/connect` og søg efter GitHub Copilot. ```txt /connect ``` -2. Naviger til [github.com/login/device](https://github.com/login/device) og skriv inn koden. +2. Naviger til [github.com/login/device](https://github.com/login/device) og indtast koden. ```txt ┌ Login with GitHub Copilot @@ -810,10 +804,10 @@ Nogle modeller må aktiveres manuelt i [GitHub Copilot-innstillingene](https://d │ │ Enter code: 8F43-6FCF │ - └ Waiting for authorization... + │ Waiting for authorization... ``` -3. Kjør nå kommandoen `/models` for at velge modellen du ønsker. +3. Kør nu kommandoen `/models` for at vælge modellen du ønsker. ```txt /models @@ -823,29 +817,29 @@ Nogle modeller må aktiveres manuelt i [GitHub Copilot-innstillingene](https://d ### Google Vertex AI -Slik bruger du Google Vertex AI med OpenCode: +Sådan bruger du Google Vertex AI med OpenCode: -1. Gå over til **Model Garden** i Google Cloud Console og tjek +1. Gå til **Model Garden** i Google Cloud Console og tjek modeller tilgængelig i din region. :::note - Du må ha et Google Cloud-prosjekt med Vertex AI API aktivert. + Du skal have et Google Cloud-projekt med Vertex AI API aktiveret. ::: -2. Angi de nødvendige miljøvariablene: - - `GOOGLE_CLOUD_PROJECT`: Google Cloud-prosjektet ditt ID - - `VERTEX_LOCATION` (valgfritt): Regionen for verteks AI (standard til `global`) - - Autentisering (velg en): - - `GOOGLE_APPLICATION_CREDENTIALS`: Bane til tjenestekontoen JSON nøkkelfil - - Autentiser med gcloud CLI: `gcloud auth application-default login` +2. Angiv de nødvendige miljøvariabler: + - `GOOGLE_CLOUD_PROJECT`: Dit Google Cloud-projekt ID + - `VERTEX_LOCATION` (valgfrit): Regionen for Vertex AI (standard til `global`) + - Godkendelse (vælg en): + - `GOOGLE_APPLICATION_CREDENTIALS`: Sti til tjenestekontoens JSON-nøglefil + - Godkend med gcloud CLI: `gcloud auth application-default login` - Sett dem mens du kjører opencode. + Sæt dem mens du kører opencode. ```bash GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json GOOGLE_CLOUD_PROJECT=your-project-id opencode ``` - Eller tilføj dem til på bash-profilen din. + Eller tilføj dem til din bash-profil. ```bash title="~/.bash_profile" export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json @@ -854,10 +848,10 @@ Slik bruger du Google Vertex AI med OpenCode: ``` :::tip -`global`-regionen forbedrer tilgængeligheten og reduserer feil uten ekstra kostnad. Brug regionale endepunkter (f.eks. `us-central1`) for krav til dataopphold. [Finn ut mer](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/use-partner-models#regional_and_global_endpoints) +`global`-regionen forbedrer tilgængeligheden og reducerer fejl uden ekstra omkostninger. Brug regionale endpoints (f.eks. `us-central1`) for krav til dataophold. [Læs mere](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/use-partner-models#regional_and_global_endpoints) ::: -3. Kjør kommandoen `/models` for at velge modellen du ønsker. +3. Kør kommandoen `/models` for at vælge modellen du ønsker. ```txt /models @@ -867,15 +861,15 @@ Slik bruger du Google Vertex AI med OpenCode: ### Groq -1. Gå over til [Groq-konsollen](https://console.groq.com/), klikk på **Create API Key**, og kopier nøkkelen. +1. Gå til [Groq-konsollen](https://console.groq.com/), klik på **Create API Key**, og kopier nøglen. -2. Kjør kommandoen `/connect` og søk etter Groq. +2. Kør kommandoen `/connect` og søg efter Groq. ```txt /connect ``` -3. Skriv inn API-nøgleen for leverandøren. +3. Indtast API-nøglen for udbyderen. ```txt ┌ API key @@ -884,7 +878,7 @@ Slik bruger du Google Vertex AI med OpenCode: └ enter ``` -4. Kjør kommandoen `/models` for at velge den du ønsker. +4. Kør kommandoen `/models` for at vælge den du ønsker. ```txt /models @@ -892,19 +886,19 @@ Slik bruger du Google Vertex AI med OpenCode: --- -### Klemmer ansikt +### Hugging Face -[Hugging Face Inference Providers](https://huggingface.co/docs/inference-providers) gir tilgang til åpne modeller som støttes av 17+ leverandører. +[Hugging Face Inference Providers](https://huggingface.co/docs/inference-providers) giver adgang til åbne modeller som støttes af 17+ udbydere. -1. Gå over til [Hugging Face-innstillinger](https://huggingface.co/settings/tokens/new?ownUserPermissions=inference.serverless.write&tokenType=fineGrained) for at oprete et token med tillatelse til at ringe til inferensleverandører. +1. Gå til [Hugging Face-indstillinger](https://huggingface.co/settings/tokens/new?ownUserPermissions=inference.serverless.write&tokenType=fineGrained) for at oprette et token med tilladelse til at kalde inferensudbydere. -2. Kjør kommandoen `/connect` og søk etter **Hugging Face**. +2. Kør kommandoen `/connect` og søg efter **Hugging Face**. ```txt /connect ``` -3. Skriv inn ditt Hugging Face-token. +3. Indtast dit Hugging Face-token. ```txt ┌ API key @@ -913,7 +907,7 @@ Slik bruger du Google Vertex AI med OpenCode: └ enter ``` -4. Kjør kommandoen `/models` for at velge en modell som _Kimi-K2-Instruct_ eller _GLM-4.6_. +4. Kør kommandoen `/models` for at vælge en model som _Kimi-K2-Instruct_ eller _GLM-4.6_. ```txt /models @@ -921,19 +915,19 @@ Slik bruger du Google Vertex AI med OpenCode: --- -### Helikon +### Helicone -[Helicone](https://helicone.ai) er en LLM observerbarhetsplattform som gir logging, overvåking og analyser for AI-applikasjonene dine. Helicone AI Gateway ruter forespørslene dine til riktig leverandør automatisk basert på modellen. +[Helicone](https://helicone.ai) er en LLM observerbarhedsplatform som giver logning, overvågning og analyser for dine AI-applikationer. Helicone AI Gateway ruter dine anmodninger til den rigtige udbyder automatisk baseret på modellen. -1. Gå over til [Helicone](https://helicone.ai), opret en konto og generer en API-nøgle fra dashbordet. +1. Gå til [Helicone](https://helicone.ai), opret en konto og generer en API-nøgle fra dashboardet. -2. Kjør kommandoen `/connect` og søk etter **Helicone**. +2. Kør kommandoen `/connect` og søg efter **Helicone**. ```txt /connect ``` -3. Skriv inn Helicone API-nøgleen. +3. Indtast Helicone API-nøglen. ```txt ┌ API key @@ -942,19 +936,19 @@ Slik bruger du Google Vertex AI med OpenCode: └ enter ``` -4. Kjør kommandoen `/models` for at velge en modell. +4. Kør kommandoen `/models` for at vælge en model. ```txt /models ``` -For flere leverandører og avanserte funksjoner som bufring og hastighetsbegrensning, tjek [Helicone-dokumentasjonen](https://docs.helicone.ai). +For flere udbydere og avancerede funktioner som caching og hastighedsbegrænsning, tjek [Helicone-dokumentationen](https://docs.helicone.ai). -#### Valgfrie konfigurasjoner +#### Valgfrie konfigurationer -I tilfelle du ser en funksjon eller modell fra Helicone som ikke konfigureres automatisk gjennom opencode, kan du alltid konfigurere den selv. +I tilfælde af at du ser en funktion eller model fra Helicone som ikke konfigureres automatisk gennem opencode, kan du altid konfigurere den selv. -Her er [Helicone's Model Directory](https://helicone.ai/models), du trenger denne for at hente ID-ene til modellene du vil tilføje til. +Her er [Helicone's Model Directory](https://helicone.ai/models), du skal bruge denne for at hente ID'erne til de modeller du vil tilføje. ```jsonc title="~/.config/opencode/opencode.jsonc" { @@ -980,9 +974,9 @@ Her er [Helicone's Model Directory](https://helicone.ai/models), du trenger denn } ``` -#### Egendefinerte topptekster +#### Brugerdefinerede headers -Helicone støtter tilpassede overskrifter for funksjoner som bufring, brugersporing og sessionadministrasjon. Legg dem til leverandørkonfigurasjonen din ved at bruge `options.headers`: +Helicone understøtter tilpassede headers for funktioner som caching, brugersporing og sessionsadministration. Læg dem til din udbyderkonfiguration ved at bruge `options.headers`: ```jsonc title="~/.config/opencode/opencode.jsonc" { @@ -1003,15 +997,15 @@ Helicone støtter tilpassede overskrifter for funksjoner som bufring, brugerspor } ``` -##### Sesjonssporing +##### Sessionssporing -Helicones [Sessions](https://docs.helicone.ai/features/sessions) funksjon lar deg gruppere relaterte LLM forespørsler sammen. Brug [opencode-helicone-session](https://github.com/H2Shami/opencode-helicone-session) plugin for automatisk at logge hver OpenCode-samtale som en session i Helicone. +Helicones [Sessions](https://docs.helicone.ai/features/sessions) funktion lader dig gruppe relaterede LLM anmodninger sammen. Brug [opencode-helicone-session](https://github.com/H2Shami/opencode-helicone-session) plugin for automatisk at logge hver OpenCode-samtale som en session i Helicone. ```bash npm install -g opencode-helicone-session ``` -Legg den til i konfigurasjonen din. +Tilføj den til din konfiguration. ```json title="opencode.json" { @@ -1019,24 +1013,24 @@ Legg den til i konfigurasjonen din. } ``` -Programtiltilføjet injiserer `Helicone-Session-Id` og `Helicone-Session-Name` overskrifter i forespørslene dine. På Helicones Sessions-side vil du se hver OpenCode-samtale oppført som en separat session. +Programmatisk injicerer `Helicone-Session-Id` og `Helicone-Session-Name` headers i dine anmodninger. På Helicones Sessions-side vil du se hver OpenCode-samtale opført som en separat session. -##### Vanlige helikonhoder +##### Almindelige Helicone-headers -| Overskrift | Beskrivelse | -| -------------------------- | -------------------------------------------------------------------------- | -| `Helicone-Cache-Enabled` | Aktiver responsbufring (`true`/`false`) | -| `Helicone-User-Id` | Spor beregninger etter bruger | -| `Helicone-Property-[Name]` | Legg til egendefinerte egenskaper (f.eks. `Helicone-Property-Environment`) | -| `Helicone-Prompt-Id` | Knytt forespørsler til spørsmålsversioner | +| Header | Beskrivelse | +| -------------------------- | ------------------------------------------------------------------------- | +| `Helicone-Cache-Enabled` | Aktiver respons-caching (`true`/`false`) | +| `Helicone-User-Id` | Spor beregninger efter bruger | +| `Helicone-Property-[Name]` | Tilføj egendefinerede egenskaber (f.eks. `Helicone-Property-Environment`) | +| `Helicone-Prompt-Id` | Knyt anmodninger til prompt-versioner | -Se [Helicone Header Directory](https://docs.helicone.ai/helicone-headers/header-directory) for alle tilgængelige overskrifter. +Se [Helicone Header Directory](https://docs.helicone.ai/helicone-headers/header-directory) for alle tilgængelige headers. --- -### lama.cpp +### llama.cpp -Du kan konfigurere opencode for at bruge lokale modeller gjennom [llama.cpps](https://github.com/ggml-org/llama.cpp) lama-server-verktøy +Du kan konfigurere opencode til at bruge lokale modeller gennem [llama.cpps](https://github.com/ggml-org/llama.cpp) llama-server-værktøj ```json title="opencode.json" "llama.cpp" {5, 6, 8, 10-15} { @@ -1062,29 +1056,29 @@ Du kan konfigurere opencode for at bruge lokale modeller gjennom [llama.cpps](ht } ``` -I dette eksemplet: +I dette eksempel: -- `llama.cpp` er den tilpassede leverandøren ID. Dette kan være hvilken som helst streng du vil. -- `npm` spesifiserer pakken som skal bruges for denne leverandøren. Her bruges `@ai-sdk/openai-compatible` for enhver OpenAI-kompatibel API. -- `name` er visningsnavnet for leverandøren i UI. -- `options.baseURL` er endepunktet for den lokale serveren. -- `models` er et kart over modell-ID-er til deres konfigurasjoner. Modellnavnet vil vises i modellvalglisten. +- `llama.cpp` er den tilpassede udbyder ID. Dette kan være hvilken som helst streng du vil. +- `npm` specificerer pakken som skal bruges for denne udbyder. Her bruges `@ai-sdk/openai-compatible` for enhver OpenAI-kompatibel API. +- `name` er visningsnavnet for udbyderen i UI. +- `options.baseURL` er endpointet for den lokale server. +- `models` er et kort over model-ID'er til deres konfigurationer. Modelnavnet vil vises i modelvalglisten. --- ### IO.NET -IO.NET tilbyr 17 modeller optimert for ulike brugstilfeller: +IO.NET tilbyder 17 modeller optimeret for forskellige brugstilfælde: -1. Gå over til [IO.NET-konsollen](https://ai.io.net/), opret en konto og generer en API-nøgle. +1. Gå til [IO.NET-konsollen](https://ai.io.net/), opret en konto og generer en API-nøgle. -2. Kjør kommandoen `/connect` og søk etter **IO.NET**. +2. Kør kommandoen `/connect` og søg efter **IO.NET**. ```txt /connect ``` -3. Skriv inn nøkkelen IO.NET API. +3. Indtast nøglen IO.NET API. ```txt ┌ API key @@ -1093,7 +1087,7 @@ IO.NET tilbyr 17 modeller optimert for ulike brugstilfeller: └ enter ``` -4. Kjør kommandoen `/models` for at velge en modell. +4. Kør kommandoen `/models` for at vælge en model. ```txt /models @@ -1103,7 +1097,7 @@ IO.NET tilbyr 17 modeller optimert for ulike brugstilfeller: ### LM Studio -Du kan konfigurere opencode for at bruge lokale modeller gjennom LM Studio. +Du kan konfigurere opencode til at bruge lokale modeller gennem LM Studio. ```json title="opencode.json" "lmstudio" {5, 6, 8, 10-14} { @@ -1125,29 +1119,29 @@ Du kan konfigurere opencode for at bruge lokale modeller gjennom LM Studio. } ``` -I dette eksemplet: +I dette eksempel: -- `lmstudio` er den tilpassede leverandøren ID. Dette kan være hvilken som helst streng du vil. -- `npm` spesifiserer pakken som skal bruges for denne leverandøren. Her bruges `@ai-sdk/openai-compatible` for enhver OpenAI-kompatibel API. -- `name` er visningsnavnet for leverandøren i UI. -- `options.baseURL` er endepunktet for den lokale serveren. -- `models` er et kart over modell-ID-er til deres konfigurasjoner. Modellnavnet vil vises i modellvalglisten. +- `lmstudio` er den tilpassede udbyder ID. Dette kan være hvilken som helst streng du vil. +- `npm` specificerer pakken som skal bruges for denne udbyder. Her bruges `@ai-sdk/openai-compatible` for enhver OpenAI-kompatibel API. +- `name` er visningsnavnet for udbyderen i UI. +- `options.baseURL` er endpointet for den lokale server. +- `models` er et kort over model-ID'er til deres konfigurationer. Modelnavnet vil vises i modelvalglisten. --- -### Måneskudd AI +### Moonshot AI -Slik bruger du Kimi K2 fra Moonshot AI: +Sådan bruger du Kimi K2 fra Moonshot AI: -1. Gå over til [Moonshot AI-konsollen](https://platform.moonshot.ai/console), opret en konto og klikk på **Opret API-nøgle**. +1. Gå til [Moonshot AI-konsollen](https://platform.moonshot.ai/console), opret en konto og klik på **Create API Key**. -2. Kjør kommandoen `/connect` og søk etter **Moonshot AI**. +2. Kør kommandoen `/connect` og søg efter **Moonshot AI**. ```txt /connect ``` -3. Skriv inn Moonshot API-nøgleen. +3. Indtast Moonshot API-nøglen. ```txt ┌ API key @@ -1156,7 +1150,7 @@ Slik bruger du Kimi K2 fra Moonshot AI: └ enter ``` -4. Kjør kommandoen `/models` for at velge _Kimi K2_. +4. Kør kommandoen `/models` for at vælge _Kimi K2_. ```txt /models @@ -1166,15 +1160,15 @@ Slik bruger du Kimi K2 fra Moonshot AI: ### MiniMax -1. Gå over til [MiniMax API-konsollen](https://platform.minimax.io/login), opret en konto og generer en API-nøgle. +1. Gå til [MiniMax API-konsollen](https://platform.minimax.io/login), opret en konto og generer en API-nøgle. -2. Kjør kommandoen `/connect` og søk etter **MiniMax**. +2. Kør kommandoen `/connect` og søg efter **MiniMax**. ```txt /connect ``` -3. Skriv inn MiniMax API-nøgleen. +3. Indtast MiniMax API-nøglen. ```txt ┌ API key @@ -1183,7 +1177,7 @@ Slik bruger du Kimi K2 fra Moonshot AI: └ enter ``` -4. Kjør kommandoen `/models` for at velge en modell som _M2.1_. +4. Kør kommandoen `/models` for at vælge en model som _M2.1_. ```txt /models @@ -1193,15 +1187,15 @@ Slik bruger du Kimi K2 fra Moonshot AI: ### Nebius Token Factory -1. Gå over til [Nebius Token Factory-konsollen](https://tokenfactory.nebius.com/), opret en konto og klikk på **Legg til nøkkel**. +1. Gå til [Nebius Token Factory-konsollen](https://tokenfactory.nebius.com/), opret en konto og klik på **Add Key**. -2. Kjør kommandoen `/connect` og søk etter **Nebius Token Factory**. +2. Kør kommandoen `/connect` og søg efter **Nebius Token Factory**. ```txt /connect ``` -3. Skriv inn Nebius Token Factory API-nøgleen. +3. Indtast Nebius Token Factory API-nøglen. ```txt ┌ API key @@ -1210,7 +1204,7 @@ Slik bruger du Kimi K2 fra Moonshot AI: └ enter ``` -4. Kjør kommandoen `/models` for at velge en modell som _Kimi K2 Instruct_. +4. Kør kommandoen `/models` for at vælge en model som _Kimi K2 Instruct_. ```txt /models @@ -1220,10 +1214,10 @@ Slik bruger du Kimi K2 fra Moonshot AI: ### Ollama -Du kan konfigurere opencode for at bruge lokale modeller gjennom Ollama. +Du kan konfigurere opencode til at bruge lokale modeller gennem Ollama. :::tip -Ollama kan automatisk konfigurere seg selv for OpenCode. Se [Ollama-integrasjonsdokumentene](https://docs.ollama.com/integrations/opencode) for detaljer. +Ollama kan automatisk konfigurere sig selv for OpenCode. Se [Ollama-integrationsdokumenterne](https://docs.ollama.com/integrations/opencode) for detaljer. ::: ```json title="opencode.json" "ollama" {5, 6, 8, 10-14} @@ -1246,37 +1240,37 @@ Ollama kan automatisk konfigurere seg selv for OpenCode. Se [Ollama-integrasjons } ``` -I dette eksemplet: +I dette eksempel: -- `ollama` er den tilpassede leverandøren ID. Dette kan være hvilken som helst streng du vil. -- `npm` spesifiserer pakken som skal bruges for denne leverandøren. Her bruges `@ai-sdk/openai-compatible` for enhver OpenAI-kompatibel API. -- `name` er visningsnavnet for leverandøren i UI. -- `options.baseURL` er endepunktet for den lokale serveren. -- `models` er et kart over modell-ID-er til deres konfigurasjoner. Modellnavnet vil vises i modellvalglisten. +- `ollama` er den tilpassede udbyder ID. Dette kan være hvilken som helst streng du vil. +- `npm` specificerer pakken som skal bruges for denne udbyder. Her bruges `@ai-sdk/openai-compatible` for enhver OpenAI-kompatibel API. +- `name` er visningsnavnet for udbyderen i UI. +- `options.baseURL` er endpointet for den lokale server. +- `models` er et kort over model-ID'er til deres konfigurationer. Modelnavnet vil vises i modelvalglisten. :::tip -Hvis verktøykall ikke fungerer, prøv at øke `num_ctx` i Ollama. Start rundt 16k - 32k. +Hvis værktøjskald ikke fungerer, prøv at øge `num_ctx` i Ollama. Start omkring 16k - 32k. ::: --- ### Ollama Cloud -Slik bruger du Ollama Cloud med OpenCode: +Sådan bruger du Ollama Cloud med OpenCode: -1. Gå over til [https://ollama.com/](https://ollama.com/) og logg på eller opret en konto. +1. Gå til [https://ollama.com/](https://ollama.com/) og log på eller opret en konto. -2. Naviger til **Innstillinger** > **Nøkler** og klikk på **Legg til API-nøgle** for at generere en ny API-nøgle. +2. Naviger til **Settings** > **Keys** og klik på **Add API Key** for at generere en ny API-nøgle. -3. Kopier API-nøgleen for brug i OpenCode. +3. Kopier API-nøglen til brug i OpenCode. -4. Kjør kommandoen `/connect` og søk etter **Ollama Cloud**. +4. Kør kommandoen `/connect` og søg efter **Ollama Cloud**. ```txt /connect ``` -5. Skriv inn din Ollama Cloud API-nøgle. +5. Indtast din Ollama Cloud API-nøgle. ```txt ┌ API key @@ -1285,13 +1279,13 @@ Slik bruger du Ollama Cloud med OpenCode: └ enter ``` -6. **Viktig**: Før du bruger skymodeller i OpenCode, må du hente modellinformasjonen lokalt: +6. **Vigtigt**: Før du bruger skymodeller i OpenCode, skal du hente modelinformationen lokalt: ```bash ollama pull gpt-oss:20b-cloud ``` -7. Kjør kommandoen `/models` for at velge din Ollama Cloud-modell. +7. Kør kommandoen `/models` for at vælge din Ollama Cloud-model. ```txt /models @@ -1301,16 +1295,16 @@ Slik bruger du Ollama Cloud med OpenCode: ### OpenAI -Vi anbefaler at du registrerer deg for [ChatGPT Plus eller Pro](https://chatgpt.com/pricing). +Vi anbefaler at du registrerer dig for [ChatGPT Plus eller Pro](https://chatgpt.com/pricing). -1. Når du har registrert deg, kjør kommandoen `/connect` og velg OpenAI. +1. Når du har registreret dig, kør kommandoen `/connect` og vælg OpenAI. ```txt /connect ``` -2. Her kan du velge alternativet **ChatGPT Plus/Pro** og det åpner nettleseren din - og ber deg om at autentisere. +2. Her kan du vælge muligheden **ChatGPT Plus/Pro** og det åbner din browser + og beder dig om at godkende. ```txt ┌ Select auth method @@ -1320,31 +1314,31 @@ Vi anbefaler at du registrerer deg for [ChatGPT Plus eller Pro](https://chatgpt. └ ``` -3. Nå skal alle OpenAI-modellene være tilgængelige når du bruger kommandoen `/models`. +3. Nu skal alle OpenAI-modellerne være tilgængelige, når du bruger kommandoen `/models`. ```txt /models ``` -##### Bruge API-tastene +##### Brug API-nøgler -Hvis du allerede har en API-nøgle, kan du velge **Angi API-nøgle manuelt** og lime den inn i terminalen. +Hvis du allerede har en API-nøgle, kan du vælge **Manually enter API Key** og indsætte den i terminalen. --- ### OpenCode Zen -OpenCode Zen er en liste over testede og verifiserte modeller levert av OpenCode-teamet. [Finn ut mer](/docs/zen). +OpenCode Zen er en liste over testede og verificerede modeller leveret af OpenCode-teamet. [Læs mere](/docs/zen). -1. Logg på **OpenCode Zen** og klikk på **Create API Key**. +1. Log på **OpenCode Zen** og klik på **Create API Key**. -2. Kjør kommandoen `/connect` og søk etter **OpenCode Zen**. +2. Kør kommandoen `/connect` og søg efter **OpenCode Zen**. ```txt /connect ``` -3. Skriv inn OpenCode API-nøgleen. +3. Indtast OpenCode API-nøglen. ```txt ┌ API key @@ -1353,7 +1347,7 @@ OpenCode Zen er en liste over testede og verifiserte modeller levert av OpenCode └ enter ``` -4. Kjør kommandoen `/models` for at velge en modell som _Qwen 3 Coder 480B_. +4. Kør kommandoen `/models` for at vælge en model som _Qwen 3 Coder 480B_. ```txt /models @@ -1363,15 +1357,15 @@ OpenCode Zen er en liste over testede og verifiserte modeller levert av OpenCode ### OpenRouter -1. Gå over til [OpenRouter-dashbordet](https://openrouter.ai/settings/keys), klikk på **Create API Key**, og kopier nøkkelen. +1. Gå til [OpenRouter-dashboardet](https://openrouter.ai/settings/keys), klik på **Create API Key**, og kopier nøglen. -2. Kjør kommandoen `/connect` og søk etter OpenRouter. +2. Kør kommandoen `/connect` og søg efter OpenRouter. ```txt /connect ``` -3. Skriv inn API-nøgleen for leverandøren. +3. Indtast API-nøglen for udbyderen. ```txt ┌ API key @@ -1380,13 +1374,13 @@ OpenCode Zen er en liste over testede og verifiserte modeller levert av OpenCode └ enter ``` -4. Mange OpenRouter-modeller er forhåndslastet som standard, kjør kommandoen `/models` for at velge den du ønsker. +4. Mange OpenRouter-modeller er forudindlæst som standard, kør kommandoen `/models` for at vælge den du ønsker. ```txt /models ``` - Du kan også tilføje til flere modeller gjennom opencode-konfigurasjonen. + Du kan også tilføje flere modeller gennem opencode-konfigurationen. ```json title="opencode.json" {6} { @@ -1401,7 +1395,7 @@ OpenCode Zen er en liste over testede og verifiserte modeller levert av OpenCode } ``` -5. Du kan også tilpasse dem gjennom opencode-konfigurasjonen. Her er et eksempel på at spesifisere en leverandør +5. Du kan også tilpasse dem gennem opencode-konfigurationen. Her er et eksempel på at specificere en udbyder ```json title="opencode.json" { @@ -1425,23 +1419,23 @@ OpenCode Zen er en liste over testede og verifiserte modeller levert av OpenCode --- -### SAP AI Kjerne +### SAP AI Core -SAP AI Core gir tilgang til 40+ modeller fra OpenAI, Anthropic, Google, Amazon, Meta, Mistral og AI21 gjennom en enhetlig plattform. +SAP AI Core giver adgang til 40+ modeller fra OpenAI, Anthropic, Google, Amazon, Meta, Mistral og AI21 gennem en samlet platform. -1. Gå til din [SAP BTP Cockpit](https://account.hana.ondemand.com/), naviger til din SAP AI kjernetjenesteforekomst, og lag en tjenestenøkkel. +1. Gå til din [SAP BTP Cockpit](https://account.hana.ondemand.com/), naviger til din SAP AI kerne-tjenesteinstans, og opret en tjenestenøgle. :::tip - Tjenestenøkkelen er et JSON-objekt som inneholder `clientid`, `clientsecret`, `url` og `serviceurls.AI_API_URL`. Du finner AI kjerneforekomsten din under **Tjenester** > **Forekomster og abonnementer** i BTP cockpiten. + Tjenestenøglen er et JSON-objekt som indeholder `clientid`, `clientsecret`, `url` og `serviceurls.AI_API_URL`. Du finder din AI-kerneinstans under **Services** > **Instances and Subscriptions** i BTP cockpittet. ::: -2. Kjør kommandoen `/connect` og søk etter **SAP AI Core**. +2. Kør kommandoen `/connect` og søg efter **SAP AI Core**. ```txt /connect ``` -3. Skriv inn tjenestenøkkelen JSON. +3. Indtast tjenestenøglen JSON. ```txt ┌ Service key @@ -1450,29 +1444,29 @@ SAP AI Core gir tilgang til 40+ modeller fra OpenAI, Anthropic, Google, Amazon, └ enter ``` - Eller angi miljøvariabelen `AICORE_SERVICE_KEY`: + Eller angiv miljøvariablen `AICORE_SERVICE_KEY`: ```bash AICORE_SERVICE_KEY='{"clientid":"...","clientsecret":"...","url":"...","serviceurls":{"AI_API_URL":"..."}}' opencode ``` - Eller tilføj den til bash-profilen din: + Eller tilføj den til din bash-profil: ```bash title="~/.bash_profile" export AICORE_SERVICE_KEY='{"clientid":"...","clientsecret":"...","url":"...","serviceurls":{"AI_API_URL":"..."}}' ``` -4. Angi eventuelt distribusjon ID og ressursgruppe: +4. Angiv eventuelt deployment-ID og ressourcegruppe: ```bash AICORE_DEPLOYMENT_ID=your-deployment-id AICORE_RESOURCE_GROUP=your-resource-group opencode ``` :::note - Disse innstillingene er valgfrie og bør konfigureres i henhold til SAP AI kjerneoppsettet. + Disse indstillinger er valgfrie og bør konfigureres i henhold til SAP AI kerne-opsætningen. ::: -5. Kjør kommandoen `/models` for at velge fra 40+ tilgængelige modeller. +5. Kør kommandoen `/models` for at vælge fra 40+ tilgængelige modeller. ```txt /models @@ -1480,17 +1474,17 @@ SAP AI Core gir tilgang til 40+ modeller fra OpenAI, Anthropic, Google, Amazon, --- -### OVHcloud AI endepunkter +### OVHcloud AI Endpoints -1. Gå over til [OVHcloud-panelet](https://ovh.com/manager). Naviger til `Public Cloud`-delen, `AI & Machine Learning` > `AI Endpoints` og i `API Keys`-fanen klikker du på **Opret en ny API-nøgle**. +1. Gå til [OVHcloud-panelet](https://ovh.com/manager). Naviger til `Public Cloud`-delen, `AI & Machine Learning` > `AI Endpoints` og i `API Keys`-fanen klikker du på **Opret en ny API-nøgle**. -2. Kjør kommandoen `/connect` og søk etter **OVHcloud AI endepunkter**. +2. Kør kommandoen `/connect` og søg efter **OVHcloud AI Endpoints**. ```txt /connect ``` -3. Skriv inn OVHcloud AI Endpoints API-nøgle. +3. Indtast OVHcloud AI Endpoints API-nøgle. ```txt ┌ API key @@ -1499,7 +1493,7 @@ SAP AI Core gir tilgang til 40+ modeller fra OpenAI, Anthropic, Google, Amazon, └ enter ``` -4. Kjør kommandoen `/models` for at velge en modell som _gpt-oss-120b_. +4. Kør kommandoen `/models` for at vælge en model som _gpt-oss-120b_. ```txt /models @@ -1509,17 +1503,17 @@ SAP AI Core gir tilgang til 40+ modeller fra OpenAI, Anthropic, Google, Amazon, ### Scaleway -Slik bruger du [Scaleway Generative APIs](https://www.scaleway.com/en/docs/generative-apis/) med OpenCode: +Sådan bruger du [Scaleway Generative APIs](https://www.scaleway.com/en/docs/generative-apis/) med OpenCode: -1. Gå over til [Scaleway Console IAM innstillinger](https://console.scaleway.com/iam/api-keys) for at generere en ny API-nøgle. +1. Gå til [Scaleway Console IAM indstillinger](https://console.scaleway.com/iam/api-keys) for at generere en ny API-nøgle. -2. Kjør kommandoen `/connect` og søk etter **Scaleway**. +2. Kør kommandoen `/connect` og søg efter **Scaleway**. ```txt /connect ``` -3. Skriv inn Scaleway API-nøgleen. +3. Indtast Scaleway API-nøglen. ```txt ┌ API key @@ -1528,7 +1522,7 @@ Slik bruger du [Scaleway Generative APIs](https://www.scaleway.com/en/docs/gener └ enter ``` -4. Kjør kommandoen `/models` for at velge en modell som _devstral-2-123b-instruct-2512_ eller _gpt-oss-120b_. +4. Kør kommandoen `/models` for at vælge en model som _devstral-2-123b-instruct-2512_ eller _gpt-oss-120b_. ```txt /models @@ -1536,17 +1530,17 @@ Slik bruger du [Scaleway Generative APIs](https://www.scaleway.com/en/docs/gener --- -### Sammen AI +### Together AI -1. Gå over til [Together AI-konsollen](https://api.together.ai), opret en konto og klikk på **Legg til nøkkel**. +1. Gå til [Together AI-konsollen](https://api.together.ai), opret en konto og klik på **Add Key**. -2. Kjør kommandoen `/connect` og søk etter **Together AI**. +2. Kør kommandoen `/connect` og søg efter **Together AI**. ```txt /connect ``` -3. Skriv inn Together AI API-nøgleen. +3. Indtast Together AI API-nøglen. ```txt ┌ API key @@ -1555,7 +1549,7 @@ Slik bruger du [Scaleway Generative APIs](https://www.scaleway.com/en/docs/gener └ enter ``` -4. Kjør kommandoen `/models` for at velge en modell som _Kimi K2 Instruct_. +4. Kør kommandoen `/models` for at vælge en model som _Kimi K2 Instruct_. ```txt /models @@ -1563,17 +1557,17 @@ Slik bruger du [Scaleway Generative APIs](https://www.scaleway.com/en/docs/gener --- -### Venezia AI +### Venice AI -1. Gå over til [Venezia AI-konsollen](https://venice.ai), opret en konto og generer en API-nøgle. +1. Gå til [Venice AI-konsollen](https://venice.ai), opret en konto og generer en API-nøgle. -2. Kjør kommandoen `/connect` og søk etter **Venezia AI**. +2. Kør kommandoen `/connect` og søg efter **Venice AI**. ```txt /connect ``` -3. Skriv inn Venezia AI API-nøgleen. +3. Indtast Venice AI API-nøglen. ```txt ┌ API key @@ -1582,7 +1576,7 @@ Slik bruger du [Scaleway Generative APIs](https://www.scaleway.com/en/docs/gener └ enter ``` -4. Kjør kommandoen `/models` for at velge en modell som _Llama 3.3 70B_. +4. Kør kommandoen `/models` for at vælge en model som _Llama 3.3 70B_. ```txt /models @@ -1592,17 +1586,17 @@ Slik bruger du [Scaleway Generative APIs](https://www.scaleway.com/en/docs/gener ### Vercel AI Gateway -Vercel AI Gateway lar deg få tilgang til modeller fra OpenAI, Anthropic, Google, xAI og mer gjennom et enhetlig endepunkt. Modeller tilbys til listepris uten påslag. +Vercel AI Gateway lader dig få adgang til modeller fra OpenAI, Anthropic, Google, xAI og mere gennem et samlet endpoint. Modeller tilbydes til listepris uden påslag. -1. Gå over til [Vercel dashboard](https://vercel.com/), naviger til fanen **AI Gateway**, og klikk på **API nøkler** for at oprete en ny API-nøgle. +1. Gå til [Vercel dashboard](https://vercel.com/), naviger til fanen **AI Gateway**, og klik på **API Keys** for at oprette en ny API-nøgle. -2. Kjør kommandoen `/connect` og søk etter **Vercel AI Gateway**. +2. Kør kommandoen `/connect` og søg efter **Vercel AI Gateway**. ```txt /connect ``` -3. Skriv inn Vercel AI Gateway API-nøgle. +3. Indtast Vercel AI Gateway API-nøgle. ```txt ┌ API key @@ -1611,13 +1605,13 @@ Vercel AI Gateway lar deg få tilgang til modeller fra OpenAI, Anthropic, Google └ enter ``` -4. Kjør kommandoen `/models` for at velge en modell. +4. Kør kommandoen `/models` for at vælge en model. ```txt /models ``` -Du kan også tilpasse modeller gjennom opencode-konfigurasjonen. Her er et eksempel på spesifisering av leverandørrutingsrekkefølge. +Du kan også tilpasse modeller gennem opencode-konfigurationen. Her er et eksempel på specificering af udbyder-rutingsrækkefølge. ```json title="opencode.json" { @@ -1638,25 +1632,25 @@ Du kan også tilpasse modeller gjennom opencode-konfigurasjonen. Her er et eksem Nogle nyttige rutealternativer: -| Alternativ | Beskrivelse | -| ------------------- | ------------------------------------------------------------- | -| `order` | Providersekvens for at prøve | -| `only` | Begrens til spesifikke leverandører | -| `zeroDataRetention` | Brug kun leverandører med null retningslinjer for datalagring | +| Alternativ | Beskrivelse | +| ------------------- | -------------------------------------------------------- | +| `order` | Providersekvens for at prøve | +| `only` | Begræns til specifikke udbydere | +| `zeroDataRetention` | Brug kun udbydere med nul retningslinjer for datalagring | --- ### xAI -1. Gå over til [xAI-konsollen](https://console.x.ai/), opret en konto og generer en API-nøgle. +1. Gå til [xAI-konsollen](https://console.x.ai/), opret en konto og generer en API-nøgle. -2. Kjør kommandoen `/connect` og søk etter **xAI**. +2. Kør kommandoen `/connect` og søg efter **xAI**. ```txt /connect ``` -3. Skriv inn xAI API-nøgleen. +3. Indtast xAI API-nøglen. ```txt ┌ API key @@ -1665,7 +1659,7 @@ Nogle nyttige rutealternativer: └ enter ``` -4. Kjør kommandoen `/models` for at velge en modell som _Grok Beta_. +4. Kør kommandoen `/models` for at vælge en model som _Grok Beta_. ```txt /models @@ -1675,17 +1669,17 @@ Nogle nyttige rutealternativer: ### Z.AI -1. Gå over til [Z.AI API-konsollen](https://z.ai/manage-apikey/apikey-list), opret en konto og klikk på **Opret en ny API-nøgle**. +1. Gå til [Z.AI API-konsollen](https://z.ai/manage-apikey/apikey-list), opret en konto og klik på **Create new API Key**. -2. Kjør kommandoen `/connect` og søk etter **Z.AI**. +2. Kør kommandoen `/connect` og søg efter **Z.AI**. ```txt /connect ``` - Hvis du abonnerer på **GLM Coding Plan**, velg **Z.AI Coding Plan**. + Hvis du abonnerer på **GLM Coding Plan**, vælg **Z.AI Coding Plan**. -3. Skriv inn Z.AI API-nøgleen. +3. Indtast Z.AI API-nøglen. ```txt ┌ API key @@ -1694,7 +1688,7 @@ Nogle nyttige rutealternativer: └ enter ``` -4. Kjør kommandoen `/models` for at velge en modell som _GLM-4.7_. +4. Kør kommandoen `/models` for at vælge en model som _GLM-4.7_. ```txt /models @@ -1704,15 +1698,15 @@ Nogle nyttige rutealternativer: ### ZenMux -1. Gå over til [ZenMux-dashbordet](https://zenmux.ai/settings/keys), klikk på **Create API Key**, og kopier nøkkelen. +1. Gå til [ZenMux-dashboardet](https://zenmux.ai/settings/keys), klik på **Create API Key**, og kopier nøglen. -2. Kjør kommandoen `/connect` og søk etter ZenMux. +2. Kør kommandoen `/connect` og søg efter ZenMux. ```txt /connect ``` -3. Skriv inn API-nøgleen for leverandøren. +3. Indtast API-nøglen for udbyderen. ```txt ┌ API key @@ -1721,13 +1715,13 @@ Nogle nyttige rutealternativer: └ enter ``` -4. Mange ZenMux-modeller er forhåndslastet som standard, kjør kommandoen `/models` for at velge den du ønsker. +4. Mange ZenMux-modeller er forudindlæst som standard, kør kommandoen `/models` for at vælge den du ønsker. ```txt /models ``` - Du kan også tilføje til flere modeller gjennom opencode-konfigurasjonen. + Du kan også tilføje flere modeller gennem opencode-konfigurationen. ```json title="opencode.json" {6} { @@ -1744,15 +1738,15 @@ Nogle nyttige rutealternativer: --- -## Egendefinert leverandør +## Brugerdefineret udbyder -Slik tilføjer du til en **OpenAI-kompatibel**-leverandør som ikke er oppført i `/connect`-kommandoen: +Sådan tilføjer du en **OpenAI-kompatibel** udbyder som ikke er opført i `/connect`-kommandoen: :::tip -Du kan bruge hvilken som helst OpenAI-kompatibel leverandør med opencode. De fleste moderne AI-leverandører tilbyr OpenAI-kompatible APIer. +Du kan bruge hvilken som helst OpenAI-kompatibel udbyder med opencode. De fleste moderne AI-udbydere tilbyder OpenAI-kompatible API'er. ::: -1. Kjør kommandoen `/connect` og rull ned til **Annet**. +1. Kør kommandoen `/connect` og rul ned til **Other**. ```bash $ /connect @@ -1765,7 +1759,7 @@ Du kan bruge hvilken som helst OpenAI-kompatibel leverandør med opencode. De fl └ ``` -2. Skriv inn en unik ID for leverandøren. +2. Indtast et unikt ID for udbyderen. ```bash $ /connect @@ -1778,10 +1772,10 @@ Du kan bruge hvilken som helst OpenAI-kompatibel leverandør med opencode. De fl ``` :::note - Velg en minneverdig ID, du vil bruge denne i konfigurasjonsfilen din. + Vælg et mindeværdigt ID, du vil bruge dette i din konfigurationsfil. ::: -3. Skriv inn API-nøgleen for leverandøren. +3. Indtast API-nøglen for udbyderen. ```bash $ /connect @@ -1795,7 +1789,7 @@ Du kan bruge hvilken som helst OpenAI-kompatibel leverandør med opencode. De fl └ ``` -4. Opret eller opdater `opencode.json`-filen i prosjektkatalogen: +4. Opret eller opdater `opencode.json`-filen i projektkataloget: ```json title="opencode.json" ""myprovider"" {5-15} { @@ -1817,23 +1811,23 @@ Du kan bruge hvilken som helst OpenAI-kompatibel leverandør med opencode. De fl } ``` - Her er konfigurasjonsalternativene: - - **npm**: AI SDK pakke at bruge, `@ai-sdk/openai-compatible` for OpenAI-kompatible leverandører - - **navn**: Visningsnavn i UI. - - **modeller**: Tilgjengelige modeller. - - **options.baseURL**: API endepunkt URL. - - **options.apiKey**: Angi API-nøgleen hvis du ikke bruger auth. - - **options.headers**: Angi egendefinerte overskrifter. + Her er konfigurationsmulighederne: + - **npm**: AI SDK pakke at bruge, `@ai-sdk/openai-compatible` for OpenAI-kompatible udbydere + - **name**: Visningsnavn i UI. + - **models**: Tilgængelige modeller. + - **options.baseURL**: API endpoint URL. + - **options.apiKey**: Angiv API-nøglen hvis du ikke bruger auth. + - **options.headers**: Angiv egendefinerede headers. - Mer om de avanserte alternativene i eksemplet nedenfor. + Mere om de avancerede muligheder i eksemplet nedenfor. -5. Kjør kommandoen `/models` og din egendefinerte leverandør og modeller vil vises i utvalgslisten. +5. Kør kommandoen `/models` og din egendefinerede udbyder og modeller vil vises i udvalgslisten. --- ##### Eksempel -Her er et eksempel på innstilling av alternativene `apiKey`, `headers` og modell `limit`. +Her er et eksempel på indstilling af mulighederne `apiKey`, `headers` og model `limit`. ```json title="opencode.json" {9,11,17-20} { @@ -1863,27 +1857,27 @@ Her er et eksempel på innstilling av alternativene `apiKey`, `headers` og model } ``` -Konfigurasjonsdetaljer: +Konfigurationsdetaljer: -- **apiKey**: Angi med `env` variabel syntaks, [finn ut mer](/docs/config#env-vars). -- **overskrifter**: Egendefinerte overskrifter sendt med hver forespørsel. -- **limit.context**: Maksimalt inndatatoken som modellen godtar. -- **limit.output**: Maksimalt antall tokens modellen kan generere. +- **apiKey**: Angiv med `env` variabel syntaks, [læs mere](/docs/config#env-vars). +- **headers**: Egendefinerede headers sendt med hver anmodning. +- **limit.context**: Maksimalt input-tokens som modellen accepterer. +- **limit.output**: Maksimalt antal tokens modellen kan generere. -`limit`-feltene lar OpenCode forstå hvor mye kontekst du har igjen. Standardleverandører henter disse automatisk fra models.dev. +`limit`-felterne lader OpenCode forstå hvor meget kontekst du har tilbage. Standardudbydere henter disse automatisk fra models.dev. --- -## Feilsøking +## Fejlfinding -Hvis du har problemer med at konfigurere en leverandør, tjek følgende: +Hvis du har problemer med at konfigurere en udbyder, tjek følgende: -1. **Tjek autentiseringsoppsettet**: Kjør `opencode auth list` for at se om legitimasjonen - for leverandøren tilføjes til konfigurasjonen din. +1. **Tjek godkendelsesopsætningen**: Kør `opencode auth list` for at se om legitimationsoplysningerne + for udbyderen er tilføjet til din konfiguration. - Dette gjelder ikke leverandører som Amazon Bedrock, som er avhengige av miljøvariabler for godkjenning. + Dette gælder ikke udbydere som Amazon Bedrock, som er afhængige af miljøvariabler for godkendelse. -2. For tilpassede leverandører, tjek opencode-konfigurasjonen og: - - Sørg for at leverandøren ID som bruges i `/connect`-kommandoen samsvarer med ID i opencode-konfigurasjonen. - – Den riktige npm-pakken bruges for leverandøren. Brug for eksempel `@ai-sdk/cerebras` for Cerebras. Og for alle andre OpenAI-kompatible leverandører, brug `@ai-sdk/openai-compatible`. - - Kontroller at riktig API-endepunkt er brugt i `options.baseURL`-feltet. +2. For tilpassede udbydere, tjek opencode-konfigurationen og: + - Sørg for at udbyderens ID som bruges i `/connect`-kommandoen matcher ID i opencode-konfigurationen. + - Den rigtige npm-pakke bruges for udbyderen. Brug for eksempel `@ai-sdk/cerebras` for Cerebras. Og for alle andre OpenAI-kompatible udbydere, brug `@ai-sdk/openai-compatible`. + - Kontroller at korrekt API-endpoint er brugt i `options.baseURL`-feltet. diff --git a/packages/web/src/content/docs/da/rules.mdx b/packages/web/src/content/docs/da/rules.mdx index b7b0ffcb2..8c7ccac9e 100644 --- a/packages/web/src/content/docs/da/rules.mdx +++ b/packages/web/src/content/docs/da/rules.mdx @@ -1,13 +1,13 @@ --- title: Regler -description: Set custom instructions for opencode. +description: Angiv tilpassede instruktioner til opencode. --- Du kan gi tilpassede instruksjoner for at OpenCode ved at oprete en `AGENTS.md`-fil. Dette ligner på Cursors regler. Den inneholder instruksjoner som vil bli inkludert i LLMs kontekst for at tilpasse oppførselen til ditt spesifikke prosjekt. --- -## Initialiser +## Initialisering For at lage en ny `AGENTS.md` fil, kan du kjøre kommandoen `/init` i opencode. @@ -56,7 +56,7 @@ Vi tilføjer til prosjektspesifikke instruksjoner her, og dette vil bli delt på opencode støtter også lesing av `AGENTS.md`-filen fra flere steder. Og dette tjener forskjellige formål. -### Prosjekt +### Projekt Plasser en `AGENTS.md` i prosjektroten for prosjektspesifikke regler. Disse gjelder kun når du arbeider i denne katalogen eller dens underkataloger. @@ -66,7 +66,7 @@ Du kan også ha globale regler i en `~/.config/opencode/AGENTS.md`-fil. Dette bl Siden dette ikke er forpliktet til Git eller delt med teamet ditt, anbefaler vi at bruge dette til at spesifisere eventuelle personlige regler som LLM bør følge. -### Claude-kodekompatibilitet +### Claude Code-kompatibilitet For brugere som migrerer fra Claude Code, støtter OpenCode Claude Codes filkonvensjoner som fallbacks: @@ -84,7 +84,7 @@ export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills --- -## Forrang +## Prioritet Når opencode starter, ser den etter regelfiler i denne rekkefølgen: @@ -96,7 +96,7 @@ Den første matchende filen vinner i hver kategori. For eksempel, hvis du har b --- -## Egendefinerte instruksjoner +## Brugerdefinerede instruktioner Du kan spesifisere egendefinerte instruksjonsfiler i din `opencode.json` eller den globale `~/.config/opencode/opencode.json`. Dette lar deg og teamet ditt gjenbruge eksisterende regler i stedet for at måtte duplisere dem til AGENTS.md. @@ -124,11 +124,11 @@ Alle instruksjonsfilene er kombinert med `AGENTS.md`-filene dine. --- -## Refererer til eksterne filer +## Reference til eksterne filer Selv om opencode ikke automatisk analyserer filreferanser i `AGENTS.md`, kan du oppnå lignende funksjonalitet på to måter: -### Bruger opencode.json +### Brug af opencode.json Den anbefalte tilnærmingen er at bruge feltet `instructions` i `opencode.json`: @@ -139,7 +139,7 @@ Den anbefalte tilnærmingen er at bruge feltet `instructions` i `opencode.json`: } ``` -### Manuelle instruksjoner i AGENTS.md +### Manuelle instruktioner i AGENTS.md Du kan lære opencode at lese eksterne filer ved at gi eksplisitte instruksjoner i `AGENTS.md`. Her er et praktisk eksempel: diff --git a/packages/web/src/content/docs/da/sdk.mdx b/packages/web/src/content/docs/da/sdk.mdx index d467b5407..3feff27b3 100644 --- a/packages/web/src/content/docs/da/sdk.mdx +++ b/packages/web/src/content/docs/da/sdk.mdx @@ -13,7 +13,7 @@ Brug den til at bygge integrasjoner og kontrollere opencode programmatisk. --- -## Installer +## Installation Installer SDK fra npm: @@ -35,7 +35,7 @@ const { client } = await createOpencode() Dette starter både en server og en klient -#### Alternativer +#### Indstillinger | Alternativ | Skriv | Beskrivelse | Standard | | ---------- | ------------- | -------------------------------- | ----------- | @@ -79,7 +79,7 @@ const client = createOpencodeClient({ }) ``` -#### Alternativer +#### Indstillinger | Alternativ | Skriv inn | Beskrivelse | Standard | | --------------- | ---------- | ---------------------------------- | ----------------------- | @@ -103,7 +103,7 @@ Alle typer er generert fra serverens OpenAPI-spesifikasjon og tilgængelig i ] [--hostname ] [--cors ] ``` -#### Alternativer +#### Indstillinger -| Flagg | Beskrivelse | Standard | -| --------------- | ----------------------------------------------- | ---------------- | -| `--port` | Port at lytte på | `4096` | -| `--hostname` | Vertsnavn at lytte på | `127.0.0.1` | -| `--mdns` | Aktiver mDNS-oppdagelse | `false` | -| `--mdns-domain` | Egendefinert domenenavn for mDNS-tjeneste | `opencode.local` | -| `--cors` | Ytterligere nettleseropprinnelse for at tillate | `[]` | +| Flag | Beskrivelse | Standard | +| --------------- | -------------------------------------------- | ---------------- | +| `--port` | Port at lytte på | `4096` | +| `--hostname` | Værtsnavn at lytte på | `127.0.0.1` | +| `--mdns` | Aktiver mDNS-opdagelse | `false` | +| `--mdns-domain` | Brugerdefineret domænenavn for mDNS-tjeneste | `opencode.local` | +| `--cors` | Yderligere browseroprindelse for at tillade | `[]` | -`--cors` kan passeres flere ganger: +`--cors` kan angives flere gange: ```bash opencode serve --cors http://localhost:5173 --cors https://app.example.com @@ -34,9 +34,9 @@ opencode serve --cors http://localhost:5173 --cors https://app.example.com --- -### Autentisering +### Godkendelse -Sett `OPENCODE_SERVER_PASSWORD` for at beskytte serveren med HTTP grunntilføjende autentisering. Brugernavnet er standard til `opencode`, eller sett `OPENCODE_SERVER_USERNAME` for at overstyre det. Dette gjelder både `opencode serve` og `opencode web`. +Indstil `OPENCODE_SERVER_PASSWORD` for at beskytte serveren med HTTP grundlæggende godkendelse. Brugernavnet er som standard `opencode`, eller indstil `OPENCODE_SERVER_USERNAME` for at tilsidesætte det. Dette gælder både `opencode serve` og `opencode web`. ```bash OPENCODE_SERVER_PASSWORD=your-password opencode serve @@ -44,46 +44,46 @@ OPENCODE_SERVER_PASSWORD=your-password opencode serve --- -### Slik fungerer det +### Sådan fungerer det -Når du kjører `opencode` starter den en TUI og en server. Der TUI er -klient som snakker med serveren. Serveren viser en OpenAPI 3.1-spesifikasjon -endepunkt. Dette endepunktet bruges også til at generere en [SDK](/docs/sdk). +Når du kører `opencode` starter den en TUI og en server. Hvor TUI er +klient som taler med serveren. Serveren viser en OpenAPI 3.1-specifikation +endpoint. Dette endpoint bruges også til at generere en [SDK](/docs/sdk). :::tip -Brug opencode-serveren til at samhandle med opencode programmatisk. +Brug opencode-serveren til at interagere med opencode programmatisk. ::: -Denne arkitekturen lar opencode støtte flere klienter og lar deg samhandle med opencode programmatisk. +Denne arkitektur lader opencode understøtte flere klienter og lader dig interagere med opencode programmatisk. -Du kan kjøre `opencode serve` for at starte en frittstående server. Hvis du har -opencode TUI kjører, vil `opencode serve` starte en ny server. +Du kan køre `opencode serve` for at starte en selvstændig server. Hvis du har +opencode TUI kørende, vil `opencode serve` starte en ny server. --- -#### Koble til en eksisterende server +#### Opret forbindelse til en eksisterende server -Når du starter TUI, tildeler den tilfeldig en port og vertsnavn. Du kan i stedet sende inn `--hostname` og `--port` [flagg](/docs/cli). Brug deretter denne til at koble til serveren. +Når du starter TUI, tildeler den tilfældigt en port og et værtsnavn. Du kan i stedet sende `--hostname` og `--port` [flagene](/docs/cli). Brug derefter disse til at forbinde til serveren. -[`/tui`](#tui) endepunktet kan bruges til at kjøre TUI gjennom serveren. Du kan for eksempel forhåndsutfylle eller kjøre en forespørsel. Dette oppsettet bruges av OpenCode [IDE](/docs/ide) plugins. +[`/tui`](#tui) endpointet kan bruges til at køre TUI gennem serveren. Du kan for eksempel forududfylde eller køre en forespørgsel. Denne opsætning bruges af OpenCode [IDE](/docs/ide) plugins. --- -## Spes +## Specifikation -Serveren publiserer en OpenAPI 3.1-spesifikasjon som kan vises på: +Serveren publicerer en OpenAPI 3.1-specifikation som kan vises på: ``` http://:/doc ``` -For eksempel `http://localhost:4096/doc`. Brug spesifikasjonen til at generere klienter eller inspisere forespørsels- og svartyper. Eller se den i en Swagger-utforsker. +For eksempel `http://localhost:4096/doc`. Brug specifikationen til at generere klienter eller inspicere forespørgsels- og svartyper. Eller se den i en Swagger-utforsker. --- -## APIer +## API'er -OpenCode-serveren viser følgende APIer. +OpenCode-serveren viser følgende API'er. --- @@ -91,142 +91,142 @@ OpenCode-serveren viser følgende APIer. | Metode | Sti | Beskrivelse | Svar | | ------ | ---------------- | -------------------------------- | ------------------------------------ | -| `GET` | `/global/health` | Få serverhelse og versjon | `{ healthy: true, version: string }` | -| `GET` | `/global/event` | Få globale hendelser (SSE strøm) | Eventstrøm | +| `GET` | `/global/health` | Få serverhelbred og version | `{ healthy: true, version: string }` | +| `GET` | `/global/event` | Få globale hændelser (SSE strøm) | Eventstrøm | --- -### Prosjekt +### Projekt -| Metode | Sti | Beskrivelse | Svar | -| ------ | ------------------ | --------------------------- | ---------------------------------------------- | -| `GET` | `/project` | Liste over alle prosjekter | Prosjekt[] | -| `GET` | `/project/current` | Få det nåværende prosjektet | Prosjekt | +| Metode | Sti | Beskrivelse | Svar | +| ------ | ------------------ | ------------------------- | --------------------------------------------- | +| `GET` | `/project` | Liste over alle projekter | Project[] | +| `GET` | `/project/current` | Få det nuværende projekt | Project | --- -### Bane og VCS +### Sti og VCS -| Metode | Sti | Beskrivelse | Svar | -| ------ | ------- | ---------------------------------- | ------------------------------------------- | -| `GET` | `/path` | Få nuværende bane | Path | -| `GET` | `/vcs` | Få VCS info for nuværende prosjekt | VcsInfo | +| Metode | Sti | Beskrivelse | Svar | +| ------ | ------- | --------------------------------- | ------------------------------------------- | +| `GET` | `/path` | Få nuværende sti | Path | +| `GET` | `/vcs` | Få VCS info for nuværende projekt | VcsInfo | --- -### Forekomst +### Instans | Metode | Sti | Beskrivelse | Svar | | ------ | ------------------- | ------------------------ | --------- | -| `POST` | `/instance/dispose` | Kast nuværende forekomst | `boolean` | +| `POST` | `/instance/dispose` | Kassér nuværende instans | `boolean` | --- -### Konfig +### Konfiguration -| Metode | Sti | Beskrivelse | Svar | -| ------- | ------------------- | -------------------------------------- | ---------------------------------------------------------------------------------------- | -| `GET` | `/config` | Få konfigurasjonsinformasjon | Config | -| `PATCH` | `/config` | Opdater konfigurasjon | Config | -| `GET` | `/config/providers` | Liste leverandører og standardmodeller | `{ providers: `Provider[]`, default: { [key: string]: string } }` | +| Metode | Sti | Beskrivelse | Svar | +| ------- | ------------------- | ---------------------------------- | ---------------------------------------------------------------------------------------- | +| `GET` | `/config` | Få konfigurationsinformation | Config | +| `PATCH` | `/config` | Opdater konfiguration | Config | +| `GET` | `/config/providers` | Liste udbydere og standardmodeller | `{ providers: `Provider[]`, default: { [key: string]: string } }` | --- -### Leverandør +### Udbyder -| Metode | Sti | Beskrivelse | Svar | -| ------ | -------------------------------- | ------------------------------------------ | ----------------------------------------------------------------------------------- | -| `GET` | `/provider` | Liste alle leverandører | `{ all: `Provider[]`, default: {...}, connected: string[] }` | -| `GET` | `/provider/auth` | Få leverandørautentiseringsmetoder | `{ [providerID: string]: `ProviderAuthMethod[]` }` | -| `POST` | `/provider/{id}/oauth/authorize` | Autoriser en leverandør ved at bruge OAuth | ProviderAuthAuthorization | -| `POST` | `/provider/{id}/oauth/callback` | Håndtere OAuth-callback for en leverandør | `boolean` | +| Metode | Sti | Beskrivelse | Svar | +| ------ | -------------------------------- | --------------------------------------- | ----------------------------------------------------------------------------------- | +| `GET` | `/provider` | Liste alle udbydere | `{ all: `Provider[]`, default: {...}, connected: string[] }` | +| `GET` | `/provider/auth` | Få udbydergodkendelsesmetoder | `{ [providerID: string]: `ProviderAuthMethod[]` }` | +| `POST` | `/provider/{id}/oauth/authorize` | Autoriser en udbyder ved at bruge OAuth | ProviderAuthAuthorization | +| `POST` | `/provider/{id}/oauth/callback` | Håndter OAuth-callback for en udbyder | `boolean` | --- -### sessioner +### Sessioner -| Metode | Sti | Beskrivelse | Noter | -| -------- | ---------------------------------------- | ------------------------------------------- | ------------------------------------------------------------------------------------- | -| `GET` | `/session` | Liste alle sessioner | Returnerer Session[] | -| `POST` | `/session` | Opret en ny session | body: `{ parentID?, title? }`, returnerer Session | -| `GET` | `/session/status` | Få sessionstatus for alle sessioner | Returnerer `{ [sessionID: string]: `SessionStatus` }` | -| `GET` | `/session/:id` | Få sessiondetaljer | Returnerer Session | -| `DELETE` | `/session/:id` | Slett en session og alle dens data | Returnerer `boolean` | -| `PATCH` | `/session/:id` | Opdater sessionegenskaper | body: `{ title? }`, returnerer Session | -| `GET` | `/session/:id/children` | Få en sessions barnesessioner | Returnerer Session[] | -| `GET` | `/session/:id/todo` | Få to-doslisten for en session | Returnerer Todo[] | -| `POST` | `/session/:id/init` | Analyser appen og lag `AGENTS.md` | body: `{ messageID, providerID, modelID }`, returnerer `boolean` | -| `POST` | `/session/:id/fork` | Fork en eksisterende session ved en melding | body: `{ messageID? }`, returnerer Session | -| `POST` | `/session/:id/abort` | Avbryt en løpesession | Returnerer `boolean` | -| `POST` | `/session/:id/share` | Del en session | Returnerer Session | -| `DELETE` | `/session/:id/share` | Slutt at dele en session | Returnerer Session | -| `GET` | `/session/:id/diff` | Få diff for denne sessionen | spørring: `messageID?`, returnerer FileDiff[] | -| `POST` | `/session/:id/summarize` | Oppsummer sessionen | body: `{ providerID, modelID }`, returnerer `boolean` | -| `POST` | `/session/:id/revert` | Tilbakestill en melding | body: `{ messageID, partID? }`, returnerer `boolean` | -| `POST` | `/session/:id/unrevert` | Gjenopret alle nulstillete meldinger | Returnerer `boolean` | -| `POST` | `/session/:id/permissions/:permissionID` | Svar på en tillatelsesforespørsel | body: `{ response, remember? }`, returnerer `boolean` | +| Metode | Sti | Beskrivelse | Noter | +| -------- | ---------------------------------------- | ------------------------------------------ | ------------------------------------------------------------------------------------- | +| `GET` | `/session` | Liste alle sessioner | Returnerer Session[] | +| `POST` | `/session` | Opret en ny session | body: `{ parentID?, title? }`, returnerer Session | +| `GET` | `/session/status` | Få sessionstatus for alle sessioner | Returnerer `{ [sessionID: string]: `SessionStatus` }` | +| `GET` | `/session/:id` | Få sessiondetaljer | Returnerer Session | +| `DELETE` | `/session/:id` | Slet en session og alle dens data | Returnerer `boolean` | +| `PATCH` | `/session/:id` | Opdater sessionegenskaber | body: `{ title? }`, returnerer Session | +| `GET` | `/session/:id/children` | Få en sessions undersessioner | Returnerer Session[] | +| `GET` | `/session/:id/todo` | Få to-do-listen for en session | Returnerer Todo[] | +| `POST` | `/session/:id/init` | Analyser appen og lav `AGENTS.md` | body: `{ messageID, providerID, modelID }`, returnerer `boolean` | +| `POST` | `/session/:id/fork` | Fork en eksisterende session ved en besked | body: `{ messageID? }`, returnerer Session | +| `POST` | `/session/:id/abort` | Afbryd en kørende session | Returnerer `boolean` | +| `POST` | `/session/:id/share` | Del en session | Returnerer Session | +| `DELETE` | `/session/:id/share` | Stop med at dele en session | Returnerer Session | +| `GET` | `/session/:id/diff` | Få diff for denne session | query: `messageID?`, returnerer FileDiff[] | +| `POST` | `/session/:id/summarize` | Opsummér sessionen | body: `{ providerID, modelID }`, returnerer `boolean` | +| `POST` | `/session/:id/revert` | Tilbagestil en besked | body: `{ messageID, partID? }`, returnerer `boolean` | +| `POST` | `/session/:id/unrevert` | Gendan alle nulstillede beskeder | Returnerer `boolean` | +| `POST` | `/session/:id/permissions/:permissionID` | Svar på en tilladelsesforespørgsel | body: `{ response, remember? }`, returnerer `boolean` | --- -### Meldinger +### Beskeder -| Metode | Sti | Beskrivelse | Noter | -| ------ | --------------------------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `GET` | `/session/:id/message` | Liste meldinger i en session | spørring: `limit?`, returnerer `{ info: `Message`, parts: `Part[]`}[]` | -| `POST` | `/session/:id/message` | Send en melding og vent på svar | body: `{ messageID?, model?, agent?, noReply?, system?, tools?, parts }`, returnerer `{ info: `Message`, parts: `Part[]`}` | -| `GET` | `/session/:id/message/:messageID` | Få meldingsdetaljer | Returnerer `{ info: `Message`, parts: `Part[]`}` | -| `POST` | `/session/:id/prompt_async` | Send en melding asynkront (ingen vent) | body: samme som `/session/:id/message`, returnerer `204 No Content` | -| `POST` | `/session/:id/command` | Utfør en skråstrek-kommando | body: `{ messageID?, agent?, model?, command, arguments }`, returnerer `{ info: `Message`, parts: `Part[]`}` | -| `POST` | `/session/:id/shell` | Kjør en shell-kommando | body: `{ agent, model?, command }`, returnerer `{ info: `Message`, parts: `Part[]`}` | +| Metode | Sti | Beskrivelse | Noter | +| ------ | --------------------------------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `GET` | `/session/:id/message` | Liste beskeder i en session | query: `limit?`, returnerer `{ info: `Message`, parts: `Part[]`}[]` | +| `POST` | `/session/:id/message` | Send en besked og vent på svar | body: `{ messageID?, model?, agent?, noReply?, system?, tools?, parts }`, returnerer `{ info: `Message`, parts: `Part[]`}` | +| `GET` | `/session/:id/message/:messageID` | Få beskeddetaljer | Returnerer `{ info: `Message`, parts: `Part[]`}` | +| `POST` | `/session/:id/prompt_async` | Send en besked asynkront (ingen vent) | body: samme som `/session/:id/message`, returnerer `204 No Content` | +| `POST` | `/session/:id/command` | Udfør en skråstregskommando | body: `{ messageID?, agent?, model?, command, arguments }`, returnerer `{ info: `Message`, parts: `Part[]`}` | +| `POST` | `/session/:id/shell` | Kør en shell-kommando | body: `{ agent, model?, command }`, returnerer `{ info: `Message`, parts: `Part[]`}` | --- ### Kommandoer -| Metode | Sti | Beskrivelse | Svar | -| ------ | ---------- | --------------------- | ---------------------------------------------- | -| `GET` | `/command` | Liste alle kommandoer | Kommando[] | +| Metode | Sti | Beskrivelse | Svar | +| ------ | ---------- | --------------------- | --------------------------------------------- | +| `GET` | `/command` | Liste alle kommandoer | Command[] | --- ### Filer -| Metode | Sti | Beskrivelse | Svar | -| ------ | ------------------------ | ---------------------------------- | ------------------------------------------------------------------------------------------ | -| `GET` | `/find?pattern=` | Søk etter tekst i filer | En rekke matchobjekter med `path`, `lines`, `line_number`, `absolute_offset`, `submatches` | -| `GET` | `/find/file?query=` | Finn filer og kataloger etter navn | `string[]` (baner) | -| `GET` | `/find/symbol?query=` | Finn arbeidsområdesymboler | Symbol[] | -| `GET` | `/file?path=` | Liste filer og kataloger | FilNode[] | -| `GET` | `/file/content?path=

` | Les en fil | Filinnhold | -| `GET` | `/file/status` | Få status for sporede filer | Fil[] | +| Metode | Sti | Beskrivelse | Svar | +| ------ | ------------------------ | ------------------------------- | ------------------------------------------------------------------------------------------ | +| `GET` | `/find?pattern=` | Søg efter tekst i filer | En række matchobjekter med `path`, `lines`, `line_number`, `absolute_offset`, `submatches` | +| `GET` | `/find/file?query=` | Find filer og mapper efter navn | `string[]` (stier) | +| `GET` | `/find/symbol?query=` | Find arbejdsområdesymboler | Symbol[] | +| `GET` | `/file?path=` | Liste filer og mapper | FileNode[] | +| `GET` | `/file/content?path=

` | Læs en fil | FileContent | +| `GET` | `/file/status` | Få status for sporede filer | File[] | -#### `/find/file` spørringsparametere +#### /find/file forespørgselsparametre -- `query` (obligatorisk) - søkestreng (uklar samsvar) -- `type` (valgfritt) - begrense resultatene til `"file"` eller `"directory"` -- `directory` (valgfritt) — overstyr prosjektroten for søket -- `limit` (valgfritt) - maks. resultater (1–200) -- `dirs` (valgfritt) - eldre flagg (`"false"` returnerer kun filer) +- `query` (obligatorisk) - søgestreng (fuzzy match) +- `type` (valgfrit) - begræns resultaterne til `"file"` eller `"directory"` +- `directory` (valgfrit) — overstyr projektroden for søget +- `limit` (valgfrit) - maks. resultater (1–200) +- `dirs` (valgfrit) - ældre flag (`"false"` returnerer kun filer) --- -### Verktøy (eksperimentelt) +### Værktøjer (eksperimentelt) -| Metode | Sti | Beskrivelse | Svar | -| ------ | ------------------------------------------- | -------------------------------------------- | -------------------------------------------- | -| `GET` | `/experimental/tool/ids` | Vis alle verktøy-ID-er | ToolIDs | -| `GET` | `/experimental/tool?provider=

&model=` | List verktøy med JSON-skjemaer for en modell | ToolList | +| Metode | Sti | Beskrivelse | Svar | +| ------ | ------------------------------------------- | --------------------------------------------- | -------------------------------------------- | +| `GET` | `/experimental/tool/ids` | Vis alle værktøjs-ID'er | ToolIDs | +| `GET` | `/experimental/tool?provider=

&model=` | Liste værktøjer med JSON-skemaer for en model | ToolList | --- ### LSP, formattere og MCP -| Metode | Sti | Beskrivelse | Svar | -| ------ | ------------ | ---------------------------- | -------------------------------------------------------- | -| `GET` | `/lsp` | Få LSP serverstatus | LSPStatus[] | -| `GET` | `/formatter` | Få formateringsstatus | FormatterStatus[] | -| `GET` | `/mcp` | Få MCP serverstatus | `{ [name: string]: `MCPStatus` }` | -| `POST` | `/mcp` | Legg til MCP server dynamisk | body: `{ name, config }`, returnerer MCP statusobjekt | +| Metode | Sti | Beskrivelse | Svar | +| ------ | ------------ | -------------------------- | -------------------------------------------------------- | +| `GET` | `/lsp` | Få LSP serverstatus | LSPStatus[] | +| `GET` | `/formatter` | Få formateringsstatus | FormatterStatus[] | +| `GET` | `/mcp` | Få MCP serverstatus | `{ [name: string]: `MCPStatus` }` | +| `POST` | `/mcp` | Tilføj MCP server dynamisk | body: `{ name, config }`, returnerer MCP statusobjekt | --- @@ -238,11 +238,11 @@ OpenCode-serveren viser følgende APIer. --- -### Logging +### Logning -| Metode | Sti | Beskrivelse | Svar | -| ------ | ------ | --------------------------------------------------------------------- | --------- | -| `POST` | `/log` | Skriv loggoppføring. Brødtekst: `{ service, level, message, extra? }` | `boolean` | +| Metode | Sti | Beskrivelse | Svar | +| ------ | ------ | ---------------------------------------------------------- | --------- | +| `POST` | `/log` | Skriv logpost. Body: `{ service, level, message, extra? }` | `boolean` | --- @@ -250,38 +250,38 @@ OpenCode-serveren viser følgende APIer. | Metode | Sti | Beskrivelse | Svar | | ------ | ----------------------- | ------------------------------------------- | -------------------------- | -| `POST` | `/tui/append-prompt` | Legg til tekst i ledeteksten | `boolean` | -| `POST` | `/tui/open-help` | Åpne hjelpedialogen | `boolean` | -| `POST` | `/tui/open-sessions` | Åpne sessionvelgeren | `boolean` | -| `POST` | `/tui/open-themes` | Åpne temavelgeren | `boolean` | -| `POST` | `/tui/open-models` | Åpne modellvelgeren | `boolean` | -| `POST` | `/tui/submit-prompt` | Send inn nuværende ledetekst | `boolean` | -| `POST` | `/tui/clear-prompt` | Fjern ledeteksten | `boolean` | -| `POST` | `/tui/execute-command` | Utfør en kommando (`{ command }`) | `boolean` | +| `POST` | `/tui/append-prompt` | Tilføj tekst til prompten | `boolean` | +| `POST` | `/tui/open-help` | Åbn hjælp-dialogen | `boolean` | +| `POST` | `/tui/open-sessions` | Åbn sessionsvælgeren | `boolean` | +| `POST` | `/tui/open-themes` | Åbn temavælgeren | `boolean` | +| `POST` | `/tui/open-models` | Åbn modelvælgeren | `boolean` | +| `POST` | `/tui/submit-prompt` | Indsend nuværende prompt | `boolean` | +| `POST` | `/tui/clear-prompt` | Ryd prompten | `boolean` | +| `POST` | `/tui/execute-command` | Udfør en kommando (`{ command }`) | `boolean` | | `POST` | `/tui/show-toast` | Vis toast (`{ title?, message, variant }`) | `boolean` | -| `GET` | `/tui/control/next` | Vent på neste kontrollforespørsel | Kontrollforespørselsobjekt | -| `POST` | `/tui/control/response` | Svar på en kontrollforespørsel (`{ body }`) | `boolean` | +| `GET` | `/tui/control/next` | Vent på næste kontrolforespørgsel | Kontrolforespørgselsobjekt | +| `POST` | `/tui/control/response` | Svar på en kontrolforespørgsel (`{ body }`) | `boolean` | --- -### Auth +### Godkendelse -| Metode | Sti | Beskrivelse | Svar | -| ------ | ----------- | --------------------------------------------------------------------------- | --------- | -| `PUT` | `/auth/:id` | Angi autentiseringslegitimasjon. Brødtekst må samsvare med leverandørskjema | `boolean` | +| Metode | Sti | Beskrivelse | Svar | +| ------ | ----------- | ------------------------------------------------------------ | --------- | +| `PUT` | `/auth/:id` | Angiv godkendelsesoplysninger. Body skal matche udbyderskema | `boolean` | --- -### Hendelser +### Hændelser -| Metode | Sti | Beskrivelse | Svar | -| ------ | -------- | -------------------------------------------------------------------------------------------------- | ------------------------------ | -| `GET` | `/event` | Server-sendte hendelsesstrøm. Første arrangement er `server.connected`, deretter bussarrangementer | Server-sendte hendelser stream | +| Metode | Sti | Beskrivelse | Svar | +| ------ | -------- | ----------------------------------------------------------------------------------------- | --------------------------- | +| `GET` | `/event` | Server-sendt hændelsesstrøm. Første hændelse er `server.connected`, derefter bushændelser | Server-sendt hændelsesstrøm | --- -### Dokumenter +### Dokumentation | Metode | Sti | Beskrivelse | Svar | | ------ | ------ | ------------------------- | ----------------------------------- | -| `GET` | `/doc` | OpenAPI 3.1-spesifikasjon | HTML side med OpenAPI-spesifikasjon | +| `GET` | `/doc` | OpenAPI 3.1-specifikation | HTML side med OpenAPI-specifikation | diff --git a/packages/web/src/content/docs/da/share.mdx b/packages/web/src/content/docs/da/share.mdx index 8a5024e43..1ac2094ca 100644 --- a/packages/web/src/content/docs/da/share.mdx +++ b/packages/web/src/content/docs/da/share.mdx @@ -1,5 +1,5 @@ --- -title: Dele +title: Deling description: Del dine OpenCode-samtaler. --- @@ -11,7 +11,7 @@ Delte samtaler er offentlig tilgængelige for alle med linken. --- -## Slik fungerer det +## Sådan fungerer det Når du deler en samtale, OpenCode: @@ -21,13 +21,13 @@ Når du deler en samtale, OpenCode: --- -## Deling +## Tilstande OpenCode støtter tre delingsmoduser som kontrollerer hvordan samtaler deles: --- -### Manuell (standard) +### Manuel (standard) Som standard bruger OpenCode manuell delingsmodus. Sessioner deles ikke automatisk, men du kan dele dem manuelt ved at bruge kommandoen `/share`: @@ -63,7 +63,7 @@ Med automatisk deling aktivert, vil hver nye samtale automatisk bli delt og en k --- -### Deaktivert +### Deaktiveret Du kan deaktivere deling helt ved at sette alternativet `share` til `"disabled"` i [konfigurasjonsfilen](/docs/config): @@ -78,7 +78,7 @@ For at håndheve dette på tvers av teamet ditt for et gitt prosjekt, tilføj de --- -## Opphev deling +## Ophæv deling Slik slutter du at dele en samtale og fjerner den fra offentlig tilgang: @@ -90,7 +90,7 @@ Dette vil fjerne delelinken og slette dataene knyttet til samtalen. --- -## Personvern +## Privatliv Det er et par ting du må huske på når du deler en samtale. @@ -117,7 +117,7 @@ inkluderer: --- -## For bedrifter +## For virksomheder For bedriftsimplementeringer kan delingsfunksjonen være: diff --git a/packages/web/src/content/docs/da/skills.mdx b/packages/web/src/content/docs/da/skills.mdx index f3f20e53d..83badb3bf 100644 --- a/packages/web/src/content/docs/da/skills.mdx +++ b/packages/web/src/content/docs/da/skills.mdx @@ -1,5 +1,5 @@ --- -title: "Agentferdigheter" +title: "Agentfærdigheder" description: "Definer gjenbrugbar atferd via SKILL.md-definisjoner" --- @@ -8,7 +8,7 @@ Ferdigheter lastes inn på forespørsel via det opprinnelige `skill`-verktøyet --- -## Plasser filer +## Placer filer Opret én mappe per ferdighetsnavn og tilføj inn en `SKILL.md` i den. OpenCode søker etter disse stedene: @@ -22,7 +22,7 @@ OpenCode søker etter disse stedene: --- -## Forstå oppdagelsen +## Forstå opdagelsen For prosjektlokale stier går OpenCode opp fra din nåværende arbejdskatalog til den når git-arbeidstreet. Den laster alle matchende `skills/*/SKILL.md` i `.opencode/` og alle matchende `.claude/skills/*/SKILL.md` eller `.agents/skills/*/SKILL.md` underveis. @@ -31,7 +31,7 @@ Globale definisjoner lastes også inn fra `~/.config/opencode/skills/*/SKILL.md` --- -## Skriv frontmaterie +## Skriv frontmatter Hver `SKILL.md` må starte med YAML frontmatter. Bare disse feltene gjenkjennes: @@ -46,7 +46,7 @@ Ukjente frontmatter-felter ignoreres. --- -## Bekreft navn +## Bekræft navn `name` må: @@ -64,7 +64,7 @@ Ekvivalent regulært uttrykk: --- -## Følg lengdereglene +## Følg længdereglerne `description` må bestå av 1-1024 tegn. Hold det spesifikt nok til at agenten kan velge riktig. @@ -100,7 +100,7 @@ Ask clarifying questions if the target versioning scheme is unclear. --- -## Gjenkjenne verktøybeskrivelsen +## Genkend værktøjsbeskrivelsen OpenCode viser tilgængelige ferdigheter i `skill` verktøybeskrivelsen. Hver oppføring inneholder ferdighetsnavnet og beskrivelsen: @@ -122,7 +122,7 @@ skill({ name: "git-release" }) --- -## Konfigurer tillatelser +## Konfigurer tilladelser Kontroller hvilke ferdigheter agenter har tilgang til ved at bruge mønsterbaserte tillatelser i `opencode.json`: @@ -149,7 +149,7 @@ Mønstre støtter jokertegn: `internal-*` samsvarer med `internal-docs`, `intern --- -## Overstyring per agent +## Tilsidesættelse pr. agent Gi spesifikke agenter andre tillatelser enn de globale standardinnstillingene. @@ -181,7 +181,7 @@ permission: --- -## Deaktiver ferdighetsverktøyet +## Deaktiver færdighedsværktøjet Deaktiver ferdigheter fullstendig for agenter som ikke bør bruge dem: @@ -212,7 +212,7 @@ Når den er deaktivert, blir ``-delen utelatt helt. --- -## Feilsøk lasting +## Fejlfind indlæsning Hvis en ferdighet ikke vises: diff --git a/packages/web/src/content/docs/da/themes.mdx b/packages/web/src/content/docs/da/themes.mdx index 527a08691..533bef30e 100644 --- a/packages/web/src/content/docs/da/themes.mdx +++ b/packages/web/src/content/docs/da/themes.mdx @@ -21,7 +21,7 @@ Uden truecolor-støtte kan temaer vises med redusert farvenøjagtighed eller fal --- -## Innebygde temaer +## Indbyggede temaer OpenCode kommer med flere innebygde temaer. @@ -59,7 +59,7 @@ Systemtemaet er for brugere som: --- -## Bruge et tema +## Brug et tema Du kan velge et tema ved at hente frem temavalg med kommandoen `/theme`. Eller du kan spesifisere det i [config](/docs/config). @@ -72,7 +72,7 @@ Du kan velge et tema ved at hente frem temavalg med kommandoen `/theme`. Eller d --- -## Egendefinerte temaer +## Brugerdefinerede temaer OpenCode støtter et fleksibelt JSON-basert temasystem som lar brugere enkelt lage og tilpasse temaer. @@ -91,7 +91,7 @@ Hvis flere kataloger inneholder et tema med samme navn, vil temaet fra katalogen --- -### Oprete et tema +### Oprettelse af et tema For at lage et brugerdefineret tema, lag en JSON-fil i en av temakatalogene. @@ -111,7 +111,7 @@ vim .opencode/themes/my-theme.json --- -### JSON format +### JSON-format Temaer bruger et fleksibelt JSON-format med støtte for: @@ -123,7 +123,7 @@ Temaer bruger et fleksibelt JSON-format med støtte for: --- -### Farvedefinisjoner +### Farvedefinitioner `defs`-delen er valgfri, og den lar deg definere gjenbrugbare farver som kan refereres til i temaet. diff --git a/packages/web/src/content/docs/da/tools.mdx b/packages/web/src/content/docs/da/tools.mdx index 1a4e26919..2b8b20b15 100644 --- a/packages/web/src/content/docs/da/tools.mdx +++ b/packages/web/src/content/docs/da/tools.mdx @@ -1,6 +1,6 @@ --- -title: Verktøy -description: Administrer verktøyene en LLM kan bruge. +title: Værktøjer +description: Administrer de værktøjer, en LLM kan bruge. --- Verktøy lar LLM utføre handlinger i kodebasen din. OpenCode kommer med et sett med innebygde verktøy, men du kan utvide det med [egendefinerte verktøy](/docs/custom-tools) eller [MCP servere](/docs/mcp-servers). @@ -9,7 +9,7 @@ Som standard er alle verktøy **aktivert** og trenger ikke tillatelse for at kj --- -## Konfigurer +## Konfiguration Brug feltet `permission` for at kontrollere verktøyets oppførsel. Du kan tillate, avslå eller kreve godkjenning for hvert verktøy. @@ -39,7 +39,7 @@ Du kan også bruge jokertegn for at kontrollere flere verktøy samtidig. For eks --- -## Innebygd +## Indbyggede Her er alle de innebygde verktøyene som er tilgængelige i OpenCode. @@ -344,7 +344,7 @@ Hvert spørsmål inkluderer en overskrift, spørsmålsteksten og en liste over a --- -## Egendefinerte verktøy +## Brugerdefinerede værktøjer Egendefinerte verktøy lar deg definere dine egne funksjoner som LLM kan kalle. Disse er definert i konfigurasjonsfilen din og kan kjøre vilkårlig kode. @@ -352,7 +352,7 @@ Egendefinerte verktøy lar deg definere dine egne funksjoner som LLM kan kalle. --- -## MCP servere +## MCP-servere MCP (Model Context Protocol) servere lar deg integrere eksterne verktøy og tjenester. Dette inkluderer databasetilgang, API-integrasjoner og tredjepartstjenester. @@ -360,13 +360,13 @@ MCP (Model Context Protocol) servere lar deg integrere eksterne verktøy og tjen --- -## Internaler +## Interne Internt bruger verktøy som `grep`, `glob` og `list` [ripgrep](https://github.com/BurntSushi/ripgrep) under panseret. Som standard respekterer ripgrep `.gitignore`-mønstre, noe som betyr at filer og kataloger som er oppført i `.gitignore` vil bli ekskludert fra søk og lister. --- -### Ignore patterns +### Ignoreringsmønstre For at inkludere filer som normalt vil bli ignorert, lag en `.ignore`-fil i prosjektroten. Denne filen kan eksplisitt tillate visse stier. diff --git a/packages/web/src/content/docs/da/troubleshooting.mdx b/packages/web/src/content/docs/da/troubleshooting.mdx index 381a5bb8e..475c81f9f 100644 --- a/packages/web/src/content/docs/da/troubleshooting.mdx +++ b/packages/web/src/content/docs/da/troubleshooting.mdx @@ -1,67 +1,67 @@ --- -title: Feilsøking -description: Vanlige problemer og hvordan de kan løses. +title: Fejlfinding +description: Almindelige problemer, og hvordan de løses. --- -For at feilsøke problemer med OpenCode, start med at tjeke loggene og lokale data den lagrer på disken. +For at fejlfinde problemer med OpenCode, start med at tjekke logfilerne og de lokale data, den gemmer på disken. --- -## Logger +## Logfiler -Loggfiler skrives til: +Logfiler skrives til: - **macOS/Linux**: `~/.local/share/opencode/log/` -- **Windows**: Trykk `WIN+R` og lim inn `%USERPROFILE%\.local\share\opencode\log` +- **Windows**: Tryk `WIN+R` og indsæt `%USERPROFILE%\.local\share\opencode\log` -Loggfiler navngis med tidsstempler (f.eks. `2025-01-09T123456.log`) og de siste 10 loggfilene beholdes. +Logfiler navngives med tidsstempler (f.eks. `2025-01-09T123456.log`) og de sidste 10 logfiler beholdes. -Du kan angi loggnivået med kommandolinjealternativet `--log-level` for at få mer detaljert feilsøkingsinformasjon. For eksempel `opencode --log-level DEBUG`. +Du kan angive logniveauet med kommandolinjeflaget `--log-level` for at få mere detaljeret fejlfindingsinformation. For eksempel `opencode --log-level DEBUG`. --- ## Lagring -opencode lagrer sessiondata og andre applikasjonsdata på disken på: +opencode gemmer sessionsdata og andre applikationsdata på disken på: - **macOS/Linux**: `~/.local/share/opencode/` -- **Windows**: Trykk `WIN+R` og lim inn `%USERPROFILE%\.local\share\opencode` +- **Windows**: Tryk `WIN+R` og indsæt `%USERPROFILE%\.local\share\opencode` -Denne katalogen inneholder: +Denne mappe indeholder: -- `auth.json` - Autentiseringsdata som API-nøkler, OAuth-tokens -- `log/` - Applikasjonslogger -- `project/` - Prosjektspesifikke data som session- og meldingsdata - - Hvis prosjektet er innenfor en Git-repo, lagres det i `.//storage/` - - Hvis det ikke er en Git-repo, lagres det i `./global/storage/` +- `auth.json` - Godkendelsesdata som API-nøgler, OAuth-tokens +- `log/` - Applikationslogs +- `project/` - Projektspecifikke data som sessions- og beskeddata + - Hvis projektet er inden for et Git-repo, gemmes det i `.//storage/` + - Hvis det ikke er et Git-repo, gemmes det i `./global/storage/` --- ## Desktop-app -OpenCode Desktop kjører en lokal OpenCode-server (`opencode-cli` sidevognen) i bakgrunnen. De fleste problemene er forårsaket av en plugin som fungerer dårlig, en ødelagt cache eller en dårlig serverinnstilling. +OpenCode Desktop kører en lokal OpenCode-server (`opencode-cli` sidevognen) i baggrunden. De fleste problemer er forårsaget af et plugin, der fungerer dårligt, en ødelagt cache eller en dårlig serverindstilling. -### Raske tjeker +### Hurtige tjek -- Avslutt og start appen på nytt. -- Hvis appen viser en feilskjerm, klikker du på **Start på nytt** og kopierer feildetaljene. -- Bare macOS: `OpenCode`-meny -> **Last nettvisning på nytt** (hjelper hvis UI er tom/frosset). +- Afslut og start appen på ny. +- Hvis appen viser en fejlskærm, klikker du på **Start på ny** og kopierer fejldetaljerne. +- Kun macOS: `OpenCode`-menu -> **Genindlæs webvisning** (hjælper hvis UI er tom/frosset). --- ### Deaktiver plugins -Hvis skrivebordsappen krasjer ved oppstart, henger eller oppfører seg merkelig, start med at deaktivere plugins. +Hvis skrivebordsappen går ned ved opstart, hænger eller opfører sig mærkeligt, start med at deaktivere plugins. -#### Tjek den globale konfigurasjonen +#### Tjek den globale konfiguration -Åpne den globale konfigurasjonsfilen og se etter en `plugin`-nøkkel. +Åbn den globale konfigurationsfil og se efter en `plugin`-nøgle. - **macOS/Linux**: `~/.config/opencode/opencode.jsonc` (eller `~/.config/opencode/opencode.json`) -- **macOS/Linux** (eldre installasjoner): `~/.local/share/opencode/opencode.jsonc` -- **Windows**: Trykk `WIN+R` og lim inn `%USERPROFILE%\.config\opencode\opencode.jsonc` +- **macOS/Linux** (ældre installationer): `~/.local/share/opencode/opencode.jsonc` +- **Windows**: Tryk `WIN+R` og indsæt `%USERPROFILE%\.config\opencode\opencode.jsonc` -Hvis du har konfigurert plugins, deaktiver dem midlertidig ved at fjerne nøkkelen eller sette den til en tom matrise: +Hvis du har konfigureret plugins, deaktiver dem midlertidigt ved at fjerne nøglen eller sætte den til et tomt array: ```jsonc { @@ -70,156 +70,156 @@ Hvis du har konfigurert plugins, deaktiver dem midlertidig ved at fjerne nøkkel } ``` -#### Tjek plugin-kataloger +#### Tjek plugin-mapper -OpenCode kan også laste lokale plugins fra disken. Flytt disse midlertidig ut av veien (eller gi nytt navn til mappen) og start skrivebordsappen på nytt: +OpenCode kan også indlæse lokale plugins fra disken. Flyt disse midlertidigt væk (eller giv mappen nyt navn) og start skrivebordsappen på ny: - **Globale plugins** - **macOS/Linux**: `~/.config/opencode/plugins/` - - **Windows**: Trykk `WIN+R` og lim inn `%USERPROFILE%\.config\opencode\plugins` -- **Prosjektplugins** (bare hvis du bruger konfigurasjon per prosjekt) + - **Windows**: Tryk `WIN+R` og indsæt `%USERPROFILE%\.config\opencode\plugins` +- **Projektplugins** (kun hvis du bruger konfiguration per projekt) - `/.opencode/plugins/` -Hvis appen begynner at fungere igjen, aktiverer du plugins én om gangen for at finne ut hvilken som forårsaker problemet. +Hvis appen begynder at fungere igen, aktiverer du plugins én ad gangen for at finde ud af, hvilken som forårsager problemet. --- -### Tøm hurtigbufferen +### Ryd cachen -Hvis deaktivering av plugins ikke hjelper (eller en plugin-installasjon sitter fast), tøm hurtigbufferen slik at OpenCode kan gjenoppbygge den. +Hvis deaktivering af plugins ikke hjælper (eller en plugin-installation sidder fast), tøm cachen så OpenCode kan genopbygge den. -1. Avslutt OpenCode Desktop helt. -2. Slett hurtigbufferkatalogen: +1. Afslut OpenCode Desktop helt. +2. Slet cache-mappen: -- **macOS**: Finder -> `Cmd+Shift+G` -> lim inn `~/.cache/opencode` -- **Linux**: slett `~/.cache/opencode` (eller kjør `rm -rf ~/.cache/opencode`) -- **Windows**: Trykk `WIN+R` og lim inn `%USERPROFILE%\.cache\opencode` +- **macOS**: Finder -> `Cmd+Shift+G` -> indsæt `~/.cache/opencode` +- **Linux**: slet `~/.cache/opencode` (eller kør `rm -rf ~/.cache/opencode`) +- **Windows**: Tryk `WIN+R` og indsæt `%USERPROFILE%\.cache\opencode` -3. Start OpenCode Desktop på nytt. +3. Start OpenCode Desktop på ny. --- -### Løs problemer med servertilkobling +### Løs problemer med serverforbindelse -OpenCode Desktop kan enten starte sin egen lokale server (standard) eller koble til en server URL du har konfigurert. +OpenCode Desktop kan enten starte sin egen lokale server (standard) eller forbinde til en server URL, du har konfigureret. -Hvis du ser en **"Tilkobling mislyktes"**-dialogboks (eller appen kommer aldri forbi splash-skjermen), se etter en brugerdefineret server URL. +Hvis du ser en **"Forbindelse mislykkedes"**-dialogboks (eller appen kommer aldrig forbi splash-skærmen), se efter en brugerdefineret server URL. -#### Slett standardserveren for skrivebordet URL +#### Slet standardserveren for skrivebordet URL -Fra startskjermen klikker du på servernavnet (med statusprikken) for at åpne servervelgeren. I delen **Standardserver** klikker du på **Slett**. +Fra startskærmen klikker du på servernavnet (med statusprikken) for at åbne servervælgeren. I delen **Standardserver** klikker du på **Slet**. -#### Fjern `server.port` / `server.hostname` fra konfigurasjonen din +#### Fjern `server.port` / `server.hostname` fra din konfiguration -Hvis `opencode.json(c)` inneholder en `server`-del, fjern den midlertidig og start skrivebordsappen på nytt. +Hvis `opencode.json(c)` indeholder en `server`-del, fjern den midlertidigt og start skrivebordsappen på ny. #### Tjek miljøvariabler -Hvis du har `OPENCODE_PORT` satt i miljøet ditt, vil skrivebordsappen prøve at bruge den porten for den lokale serveren. +Hvis du har `OPENCODE_PORT` sat i dit miljø, vil skrivebordsappen prøve at bruge den port for den lokale server. -- Deaktiver `OPENCODE_PORT` (eller velg en ledig port) og start på nytt. +- Deaktiver `OPENCODE_PORT` (eller vælg en ledig port) og start på ny. --- -### Linux: Wayland / X11 problemer +### Linux: Wayland / X11-problemer -På Linux kan nogle Wayland-oppsett forårsake tomme vinduer eller kompositorfeil. +På Linux kan nogle Wayland-opsætninger forårsage tomme vinduer eller kompositorfejl. -- Hvis du er på Wayland og appen er tom/krasj, prøv at starte med `OC_ALLOW_WAYLAND=1`. -- Hvis det gør ting verre, fjern det og prøv at starte under en X11-session i stedet. +- Hvis du er på Wayland og appen er tom/crasher, prøv at starte med `OC_ALLOW_WAYLAND=1`. +- Hvis det gør ting værre, fjern det og prøv at starte under en X11-session i stedet. --- -### Windows: WebView2 kjøretid +### Windows: WebView2-runtime -På Windows krever OpenCode Desktop Microsoft Edge **WebView2 Runtime**. Hvis appen åpnes i et tomt vindu eller ikke starter, installer/opdater WebView2 og prøv igjen. +På Windows kræver OpenCode Desktop Microsoft Edge **WebView2 Runtime**. Hvis appen åbnes i et tomt vindue eller ikke starter, installer/opdater WebView2 og prøv igen. --- -### Windows: Generelle ytelsesproblemer +### Windows: Generelle ydeevneproblemer -Hvis du opplever treg ytelse, problemer med filtilgang eller terminalproblemer på Windows, kan du prøve at bruge [WSL (Windows Subsystem for Linux)](/docs/windows-wsl). WSL gir et Linux-miljø som fungerer mer sømløst med funksjonene til OpenCode. +Hvis du oplever langsom ydeevne, problemer med filadgang eller terminalproblemer på Windows, kan du prøve at bruge [WSL (Windows Subsystem for Linux)](/docs/windows-wsl). WSL giver et Linux-miljø som fungerer mere sømløst med funktionerne i OpenCode. --- -### Varsler vises ikke +### Meddelelser vises ikke -OpenCode Desktop viser bare systemvarsler når: +OpenCode Desktop viser kun systemvarsler når: -- varsler er aktivert for OpenCode i OS-innstillingene dine, og -- appvinduet er ikke fokusert. +- varsler er aktiveret for OpenCode i dine OS-indstillinger, og +- appvinduet ikke er fokuseret. --- -### Tilbakestill skrivebordsapplagring (siste utvei) +### Nulstil desktop-applagring (sidste udvej) -Hvis appen ikke starter og du ikke kan slette innstillingene fra UI, nulstil skrivebordsappens lagrede tilstand. +Hvis appen ikke starter og du ikke kan slette indstillingerne fra UI, nulstil skrivebordsappens gemte tilstand. -1. Avslutt OpenCode Desktop. -2. Finn og slett disse filene (de finnes i OpenCode Desktop-appens datakatalog): +1. Afslut OpenCode Desktop. +2. Find og slet disse filer (de findes i OpenCode Desktop-appens datamappe): -- `opencode.settings.dat` (stasjonær standardserver URL) -- `opencode.global.dat` og `opencode.workspace.*.dat` (UI tilstand som nylige servere/prosjekter) +- `opencode.settings.dat` (skrivebordsstandardserver URL) +- `opencode.global.dat` og `opencode.workspace.*.dat` (UI tilstand som nylige servere/projekter) -Slik finner du katalogen raskt: +Sådan finder du mappen hurtigt: -- **macOS**: Finder -> `Cmd+Shift+G` -> `~/Library/Application Support` (søk deretter etter filnavnene ovenfor) -- **Linux**: søk under `~/.local/share` etter filnavnene ovenfor -- **Windows**: Trykk `WIN+R` -> `%APPDATA%` (søk deretter etter filnavnene ovenfor) +- **macOS**: Finder -> `Cmd+Shift+G` -> `~/Library/Application Support` (søg derefter efter filnavnene ovenfor) +- **Linux**: søg under `~/.local/share` efter filnavnene ovenfor +- **Windows**: Tryk `WIN+R` -> `%APPDATA%` (søg derefter efter filnavnene ovenfor) --- -## Får hjelp +## Få hjælp -Hvis du opplever problemer med OpenCode: +Hvis du oplever problemer med OpenCode: 1. **Rapporter problemer på GitHub** - Den beste måten at rapportere feil eller be om funksjoner på er gjennom vårt GitHub-lager: + Den bedste måde at rapportere fejl eller bede om funktioner på er gennem vores GitHub-repo: [**github.com/anomalyco/opencode/issues**](https://github.com/anomalyco/opencode/issues) - Før du opreter et nytt problem, søk i eksisterende problemer for at se om problemet ditt allerede er rapportert. + Før du opretter et nyt issue, søg i eksisterende issues for at se om dit problem allerede er rapporteret. -2. **Bli med i vår Discord** +2. **Bliv en del af vores Discord** - For sanntidshjelp og fellesskapsdiskusjon, bli med i vår Discord-server: + For hjælp i realtid og fællesskabsdiskussion, bliv en del af vores Discord-server: [**opencode.ai/discord**](https://opencode.ai/discord) --- -## Vanlige problemer +## Almindelige problemer -Her er nogle vanlige problemer og hvordan du kan løse dem. +Her er nogle almindelige problemer og hvordan du kan løse dem. --- ### OpenCode vil ikke starte -1. Tjek loggene for feilmeldinger -2. Prøv at kjøre med `--print-logs` for at se utdata i terminalen -3. Sørg for at du har den nyeste versjonen med `opencode upgrade` +1. Tjek logfilerne for fejlmeddelelser +2. Prøv at køre med `--print-logs` for at se output i terminalen +3. Sørg for at du har den nyeste version med `opencode upgrade` --- -### Autentiseringsproblemer +### Godkendelsesproblemer -1. Prøv at autentisere på nytt med kommandoen `/connect` i TUI -2. Tjek at API-nøklene dine er gyldige -3. Sørg for at nettverket ditt tillater tilkoblinger til leverandørens API +1. Prøv at godkende på ny med kommandoen `/connect` i TUI +2. Tjek at dine API-nøgler er gyldige +3. Sørg for at dit netværk tillader forbindelser til udbyderens API --- ### Modellen er ikke tilgængelig -1. Tjek at du har autentisert deg med leverandøren -2. Kontroller at modellnavnet i konfigurasjonen er riktig -3. Nogle modeller kan kreve spesifikk tilgang eller abonnement +1. Tjek at du har godkendt dig med udbyderen +2. Kontroller at modelnavnet i konfigurationen er rigtigt +3. Nogle modeller kan kræve specifik adgang eller abonnement -Hvis du støter på `ProviderModelNotFoundError` er du mest sannsynlig feil -refererer til en modell et sted. -Modeller skal refereres slik: `/` +Hvis du støder på `ProviderModelNotFoundError` refererer du mest sandsynligt forkert +til en model et sted. +Modeller skal refereres sådan: `/` Eksempler: @@ -227,52 +227,52 @@ Eksempler: - `openrouter/google/gemini-2.5-flash` - `opencode/kimi-k2` -For at finne ut hvilke modeller du har tilgang til, kjør `opencode models` +For at finde ud af hvilke modeller du har adgang til, kør `opencode models` --- ### ProviderInitError -Hvis du støter på en ProviderInitError, har du sannsynligvis en ugyldig eller ødelagt konfigurasjon. +Hvis du støder på en ProviderInitError, har du sandsynligvis en ugyldig eller ødelagt konfiguration. For at løse dette: -1. Kontroller først at leverandøren din er riktig konfigurert ved at følge [leverandørveiledningen](/docs/providers) -2. Hvis problemet vedvarer, prøv at tømme den lagrede konfigurasjonen: +1. Kontroller først at din udbyder er rigtigt konfigureret ved at følge [udbydervejledningen](/docs/providers) +2. Hvis problemet vedvarer, prøv at tømme den gemte konfiguration: ```bash rm -rf ~/.local/share/opencode ``` - På Windows, trykk `WIN+R` og slett: `%USERPROFILE%\.local\share\opencode` + På Windows, tryk `WIN+R` og slet: `%USERPROFILE%\.local\share\opencode` -3. Autentiser på nytt med leverandøren din ved at bruge kommandoen `/connect` i TUI. +3. Godkend på ny med din udbyder ved at bruge kommandoen `/connect` i TUI. --- -### AI_APICallError og leverandørpakkeproblemer +### AI_APICallError og udbyderpakkeproblemer -Hvis du støter på API anropsfeil, kan dette skyldes utdaterte leverandørpakker. opencode installerer dynamisk leverandørpakker (OpenAI, Anthropic, Google, etc.) etter behov og cacher dem lokalt. +Hvis du støder på API-kaldsfejl, kan dette skyldes forældede udbyderpakker. opencode installerer dynamisk udbyderpakker (OpenAI, Anthropic, Google, etc.) efter behov og cacher dem lokalt. -For at løse problemer med leverandørpakke: +For at løse problemer med udbyderpakke: -1. Tøm leverandørens pakkebuffer: +1. Tøm udbyderens pakkecache: ```bash rm -rf ~/.cache/opencode ``` - På Windows, trykk `WIN+R` og slett: `%USERPROFILE%\.cache\opencode` + På Windows, tryk `WIN+R` og slet: `%USERPROFILE%\.cache\opencode` -2. Start opencode på nytt for at installere de nyeste leverandørpakkene på nytt +2. Start opencode på ny for at installere de nyeste udbyderpakker på ny -Dette vil tvinge opencode til at laste ned de nyeste versjonene av leverandørpakkene, som ofte løser kompatibilitetsproblemer med modellparametere og API endringer. +Dette vil tvinge opencode til at downloade de nyeste versioner af udbyderpakkerne, som ofte løser kompatibilitetsproblemer med modelparametre og API-ændringer. --- -### Kopier/lim inn fungerer ikke på Linux +### Kopier/indsæt virker ikke på Linux -Linux-brugere må ha ett av følgende utklippstavleverktøy installert for at kopier/lim inn-funksjonalitet skal fungere: +Linux-brugere skal have et af følgende udklipsholderværktøjer installeret for at kopier/indsæt-funktionalitet skal fungere: **For X11-systemer:** @@ -288,7 +288,7 @@ apt install -y xsel apt install -y wl-clipboard ``` -**For hodeløse miljøer:** +**For hovedløse miljøer:** ```bash apt install -y xvfb @@ -297,4 +297,4 @@ Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 & export DISPLAY=:99.0 ``` -opencode vil oppdage om du bruger Wayland og foretrekker `wl-clipboard`, ellers vil den prøve at finne utklippstavleverktøy i rekkefølgen: `xclip` og `xsel`. +opencode vil opdage om du bruger Wayland og foretrække `wl-clipboard`, ellers vil den prøve at finde udklipsholderværktøjer i rækkefølgen: `xclip` og `xsel`. diff --git a/packages/web/src/content/docs/da/tui.mdx b/packages/web/src/content/docs/da/tui.mdx index b8a62e407..21cdbe320 100644 --- a/packages/web/src/content/docs/da/tui.mdx +++ b/packages/web/src/content/docs/da/tui.mdx @@ -1,13 +1,13 @@ --- title: TUI -description: Bruge OpenCode-terminalbrugergrænsefladeet. +description: Brug af OpenCode-terminalbrugergrænsefladen. --- import { Tabs, TabItem } from "@astrojs/starlight/components" -OpenCode gir et interaktivt terminalgrænseflade eller TUI for at jobbe med prosjektene dine med en LLM. +OpenCode giver en interaktiv terminalgrænseflade eller TUI til at arbejde med dine projekter med en LLM. -Å køre OpenCode starter TUI for nuværende mappe. +At køre OpenCode starter TUI for den nuværende mappe. ```bash opencode @@ -29,10 +29,10 @@ Give me a quick summary of the codebase. ## Filreferencer -Du kan referere til filer i dine meddelelser med `@`. Det laver en fuzzy filsøgning i det nuværende arbejdsmappe. +Du kan referere til filer i dine beskeder med `@`. Det laver en fuzzy filsøgning i den nuværende arbejdsmappe. :::tip -Du kan også bruge `@` til at referere til filer i dine meddelelser. +Du kan også bruge `@` til at referere til filer i dine beskeder. ::: ```text "@packages/functions/src/api/index.ts" @@ -51,19 +51,19 @@ Start en besked med `!` for at køre en shell-kommando. !ls -la ``` -Outputtet fra kommandoen tilføjes til samtalen som et værktøjresultat. +Outputtet fra kommandoen tilføjes til samtalen som et værktøjsresultat. --- ## Kommandoer -Når du bruger OpenCode TUI, kan du skrive `/` etterfulgt av et kommandonavn for raskt at utføre handlinger. For eksempel: +Når du bruger OpenCode TUI, kan du skrive `/` efterfulgt af et kommandonavn for hurtigt at udføre handlinger. For eksempel: ```bash frame="none" /help ``` -De fleste kommandoer har også genvejstast som bruger `ctrl+x` som Leader-tast, der `ctrl+x` er standard Leader-tast. [Læs mere](/docs/keybinds). +De fleste kommandoer har også genvejstaster som bruger `ctrl+x` som Leader-tast, hvor `ctrl+x` er standard Leader-tast. [Læs mere](/docs/keybinds). Her er alle tilgængelige skråstregskommandoer: @@ -71,7 +71,7 @@ Her er alle tilgængelige skråstregskommandoer: ### connect -Tilføj en leverandør til OpenCode. Lar deg velge fra tilgængelige leverandører og tilføje til deres API-nøgler. +Tilføj en udbyder til OpenCode. Lader dig vælge fra tilgængelige udbydere og tilføje deres API-nøgler. ```bash frame="none" /connect @@ -93,7 +93,7 @@ Komprimer nuværende session. _Alias_: `/summarize` ### details -Veksle værktøjutførelsesdetaljer. +Skift visning af værktøjsudførelsesdetaljer. ```bash frame="none" /details @@ -105,7 +105,7 @@ Veksle værktøjutførelsesdetaljer. ### editor -Åbn eksternt redigeringsprogram for at skrive beskeder. Bruger redigeringsprogrammet i miljøvariabelen `EDITOR`. [Læs mere](#editor-setup). +Åbn eksternt redigeringsprogram for at skrive beskeder. Bruger redigeringsprogrammet i miljøvariablen `EDITOR`. [Læs mere](#editor-setup). ```bash frame="none" /editor @@ -129,7 +129,7 @@ Afslut OpenCode. _Aliaser_: `/quit`, `/q` ### export -Eksporter nuværende samtale til Markdown og åpne i standardredigeringsprogrammet. Bruger redigeringsprogrammet i miljøvariabelen `EDITOR`. [Læs mere](#editor-setup). +Eksporter nuværende samtale til Markdown og åbn i standardredigeringsprogrammet. Bruger redigeringsprogrammet i miljøvariablen `EDITOR`. [Læs mere](#editor-setup). ```bash frame="none" /export @@ -189,14 +189,13 @@ Start en ny session. _Alias_: `/clear` ### redo -Gentag en tidligere fortrudt besked. Kun tilgængelig etter brug av `/undo`. +Gentag en tidligere fortrudt besked. Kun tilgængelig efter brug af `/undo`. :::tip -Eventuelle filændringer vil også bli genoprettet. +Eventuelle filændringer vil også blive genoprettet. ::: -Internt bruger dette Git til at administrere filændringerne. Så dit prosjekt **må -være et Git-depot**. +Internt bruger dette Git til at administrere filændringerne. Så dit projekt **skal være et Git-depot**. ```bash frame="none" /redo @@ -208,7 +207,7 @@ være et Git-depot**. ### sessions -List opp og bytt mellom sessioner. _Aliaser_: `/resume`, `/continue` +List og skift mellem sessioner. _Aliaser_: `/resume`, `/continue` ```bash frame="none" /sessions @@ -244,10 +243,10 @@ Liste over tilgængelige temaer. ### thinking -Veksle mellom synligheten av tenke-/resonneringsblokker i samtalen. Når den er aktiveret, kan du se modellens resonneringsprosess for modeller som støtter utvidet tenkning. +Skift synligheden af tænke-/ræsonneringsblokke i samtalen. Når den er aktiveret, kan du se modellens ræsonneringsproces for modeller, som understøtter udvidet tænkning. :::note -Denne kommandoen kontrollerer bare om tenkeblokker **vises** - den aktiverer eller deaktiverer ikke modellens resonneringsmuligheter. For at veksle mellom faktiske resonneringsmuligheter, brug `ctrl+t` for at bla gennem modellvarianter. +Denne kommando kontrollerer bare om tænkeblokke **vises** - den aktiverer eller deaktiverer ikke modellens ræsonneringsmuligheder. For at skifte mellem faktiske ræsonneringsmuligheder, brug `ctrl+t` for at bladre gennem modelvarianter. ::: ```bash frame="none" @@ -258,14 +257,13 @@ Denne kommandoen kontrollerer bare om tenkeblokker **vises** - den aktiverer ell ### undo -Angre siste besked i samtalen. Fjerner den siste brugerbeskeden, alle påfølgende svar og eventuelle filændringer. +Fortryd sidste besked i samtalen. Fjerner den sidste brugerbesked, alle efterfølgende svar og eventuelle filændringer. :::tip -Eventuelle filændringer vil også bli nullstillet. +Eventuelle filændringer vil også blive nulstillet. ::: -Internt bruger dette Git til at administrere filændringerne. Så dit prosjekt **må -være et Git-depot**. +Internt bruger dette Git til at administrere filændringerne. Så dit projekt **skal være et Git-depot**. ```bash frame="none" /undo @@ -277,7 +275,7 @@ være et Git-depot**. ### unshare -Ophæv deling av nuværende session. [Læs mere](/docs/share#un-sharing). +Ophæv deling af nuværende session. [Læs mere](/docs/share#un-sharing). ```bash frame="none" /unshare @@ -287,7 +285,7 @@ Ophæv deling av nuværende session. [Læs mere](/docs/share#un-sharing). ## Opsætning af editor -Både kommandoerne `/editor` og `/export` bruger editoren som er spesifisert i miljøvariabelen `EDITOR`. +Både kommandoerne `/editor` og `/export` bruger editoren som er specificeret i miljøvariablen `EDITOR`. @@ -301,7 +299,7 @@ Både kommandoerne `/editor` og `/export` bruger editoren som er spesifisert i m export EDITOR="code --wait" ``` - For at gøre det permanent, tilføj dette til i shellprofilen din; + For at gøre det permanent, tilføj dette til din shellprofil; `~/.bashrc`, `~/.zshrc` osv. @@ -315,8 +313,7 @@ Både kommandoerne `/editor` og `/export` bruger editoren som er spesifisert i m set EDITOR=code --wait ``` - For at gøre det permanent, brug **Systemegenskaber** > **Miljø - Variabler**. + For at gøre det permanent, brug **Systemegenskaber** > **Miljøvariabler**. @@ -329,7 +326,7 @@ Både kommandoerne `/editor` og `/export` bruger editoren som er spesifisert i m $env:EDITOR = "code --wait" ``` - For at gøre det permanent, tilføj dette til i PowerShell-profilen din. + For at gøre det permanent, tilføj dette til din PowerShell-profil. @@ -346,10 +343,10 @@ Populære redigeringsalternativer inkluderer: - `subl` - Sublime Text :::note -Nogle editorer som VS Code må startes med flaget `--wait`. +Nogle editorer som VS Code skal startes med flaget `--wait`. ::: -Nogle editorer kræver kommandolinjeargumenter for at køre i blokeringstilstand. `--wait`-flaget gør at redigeringsprocessen blokeres til den lukkes. +Nogle editorer kræver kommandolinjeargumenter for at køre i blokeringstilstand. `--wait`-flaget gør at redigeringsprocessen blokeres indtil den lukkes. --- @@ -371,20 +368,20 @@ Du kan tilpasse TUI-adfærden gennem OpenCode-konfigurationsfilen. ### Indstillinger -- `scroll_acceleration` - Aktiver rulleacceleration i macOS-stil for jævn, naturlig rulning. Når aktiveret, øger rullehastigheden med raske rullebevægelser og forblir presis for langsommere bevægelser. **Denne indstillingen har forrang over `scroll_speed` og tilsidesætter den når den er aktiveret.** -- `scroll_speed` - Styrer hvor raskt TUI ruller når du bruger rullekommandoer (minimum: `1`). Standard er `3`. **Bemærk: Dette ignoreres hvis `scroll_acceleration.enabled` er sat til `true`.** +- `scroll_acceleration` - Aktiver rulleacceleration i macOS-stil for jævn, naturlig rulning. Når aktiveret, øger rullehastigheden med hurtige rullebevægelser og forbliver præcis for langsommere bevægelser. **Denne indstilling har forrang over `scroll_speed` og tilsidesætter den, når den er aktiveret.** +- `scroll_speed` - Styrer hvor hurtigt TUI ruller, når du bruger rullekommandoer (minimum: `1`). Standard er `3`. **Bemærk: Dette ignoreres hvis `scroll_acceleration.enabled` er sat til `true`.** --- ## Tilpasning -Du kan tilpasse forskellige aspekter av TUI-visningen ved at bruge kommandopaletten (`ctrl+x h` eller `/help`). Disse indstillingene gemmes ved omstarter. +Du kan tilpasse forskellige aspekter af TUI-visningen ved at bruge kommandopaletten (`ctrl+x h` eller `/help`). Disse indstillinger gemmes ved genstart. --- -#### Username display +#### Visning af brugernavn -Veksle om brugernavnet dit vises i chat-beskeder. Få adgang til dette gennem: +Skift om dit brugernavn vises i chat-beskeder. Få adgang til dette gennem: - Kommandopalet: Søg efter "brugernavn" eller "skjul brugernavn" -- Innstillingen gemmes automatisk og vil bli husket over TUI sessioner +- Indstillingen gemmes automatisk og vil blive husket over TUI-sessioner diff --git a/packages/web/src/content/docs/da/web.mdx b/packages/web/src/content/docs/da/web.mdx index 931fffa34..889045ca2 100644 --- a/packages/web/src/content/docs/da/web.mdx +++ b/packages/web/src/content/docs/da/web.mdx @@ -21,7 +21,7 @@ Dette starter en lokal server på `127.0.0.1` med en tilfældig tilgængelig por Hvis `OPENCODE_SERVER_PASSWORD` ikke er indstillet, vil serveren være usikret. Dette er fint til lokal brug, men bør indstilles til netværksadgang. ::: -:::tip[Windows Users] +:::tip[Windows-brugere] For den bedste oplevelse skal du køre `opencode web` fra [WSL](/docs/windows-wsl) i stedet for PowerShell. Dette sikrer korrekt filsystemadgang og terminalintegration. ::: diff --git a/packages/web/src/content/docs/da/zen.mdx b/packages/web/src/content/docs/da/zen.mdx index 34d6b49ee..128583ad7 100644 --- a/packages/web/src/content/docs/da/zen.mdx +++ b/packages/web/src/content/docs/da/zen.mdx @@ -1,77 +1,77 @@ --- title: Zen -description: Utvalgt liste over modeller levert av OpenCode. +description: Udvalgt liste over modeller leveret af OpenCode. --- import config from "../../../../config.mjs" export const console = config.console export const email = `mailto:${config.email}` -OpenCode Zen er en liste over testede og verifiserte modeller levert av OpenCode-teamet. +OpenCode Zen er en liste over testede og verificerede modeller leveret af OpenCode-teamet. :::note -OpenCode Zen er for øyeblikket i beta. +OpenCode Zen er i øjeblikket i beta. ::: -Zen fungerer som alle andre leverandører i OpenCode. Du logger på OpenCode Zen og får -din API-nøgle. Den er **helt valgfri** og du trenger ikke bruge den for at bruge den +Zen fungerer som alle andre udbydere i OpenCode. Du logger på OpenCode Zen og får +din API-nøgle. Den er **helt valgfri** og du behøver ikke bruge den for at bruge OpenCode. --- -## Bakgrunn +## Baggrund -Det er et stort antall modeller der ute, men bare nogle få av dem -disse modellene fungerer godt som kodeagenter. I tiltilføj er de fleste tilbydere -konfigurert veldig annerledes; slik at du får veldig forskjellig ytelse og kvalitet. +Der er et stort antal modeller derude, men kun få af dem +fungerer godt som kodeagenter. Derudover er de fleste udbydere +konfigureret meget forskelligt, så du får meget forskellig ydeevne og kvalitet. :::tip -Vi testet en utvalgt gruppe modeller og leverandører som fungerer godt med OpenCode. +Vi testede en udvalgt gruppe modeller og udbydere, der fungerer godt med OpenCode. ::: -Så hvis du bruger en modell gjennom noe som OpenRouter, kan du aldri bli det -sikker på om du får den beste versjonen av modellen du ønsker. +Så hvis du bruger en model gennem noget som OpenRouter, kan du aldrig være +sikker på, om du får den bedste version af modellen, du ønsker. For at fikse dette gjorde vi et par ting: -1. Vi testet en utvalgt gruppe modeller og snakket med teamene deres om hvordan - best kjøre dem. -2. Vi samarbeidet deretter med nogle få leverandører for at sikre at disse ble servert - riktig. -3. Til slutt benchmarket vi kombinasjonen av modell/leverandør og kom frem - med en liste som vi har lyst til at anbefale. +1. Vi testede en udvalgt gruppe modeller og talte med deres teams om, hvordan + man bedst kører dem. +2. Vi samarbejdede derefter med nogle få udbydere for at sikre, at disse blev serveret + korrekt. +3. Til sidst benchmarkede vi kombinationen af model/udbyder og kom frem + til en liste, som vi har lyst til at anbefale. -OpenCode Zen er en AI gateway som gir deg tilgang til disse modellene. +OpenCode Zen er en AI gateway, der giver dig adgang til disse modeller. --- -## Slik fungerer det +## Sådan fungerer det -OpenCode Zen fungerer som alle andre leverandører i OpenCode. +OpenCode Zen fungerer som alle andre udbydere i OpenCode. -1. Du logger på **OpenCode Zen**, tilføj til fakturering - detaljer, og kopier API-nøgleen. -2. Du kjører kommandoen `/connect` i TUI, velger OpenCode Zen og limer inn API-nøgleen. -3. Kjør `/models` i TUI for at se listen over modeller vi anbefaler. +1. Du logger på **OpenCode Zen**, tilføjer faktureringsoplysninger + og kopierer API-nøglen. +2. Du kører kommandoen `/connect` i TUI, vælger OpenCode Zen og indsætter API-nøglen. +3. Kør `/models` i TUI for at se listen over modeller, vi anbefaler. -Du belastes per forespørsel, og du kan tilføje til kreditt på kontoen din. +Du opkræves per anmodning, og du kan tilføje kredit til din konto. --- -## Endepunkter +## Endpoints -Du kan også få tilgang til modellene våre gjennom følgende API-endepunkter. +Du kan også få adgang til vores modeller gennem følgende API-endpoints. -| Modell | Modell ID | Endepunkt | AI SDK Pakke | +| Model | Model ID | Endpoint | AI SDK Pakke | | ------------------- | ------------------ | -------------------------------------------------- | --------------------------- | | GPT 5.2 | gpt-5.2 | `https://opencode.ai/zen/v1/responses` | `@ai-sdk/openai` | -| GPT 5.2 Codex | gpt-5.2-kodeks | `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-kodeks | `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-kodeks | `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-sonnett-4-5 | `https://opencode.ai/zen/v1/messages` | `@ai-sdk/anthropic` | | Claude Sonnet 4 | claude-sonnett-4 | `https://opencode.ai/zen/v1/messages` | `@ai-sdk/anthropic` | @@ -83,20 +83,20 @@ Du kan også få tilgang til modellene våre gjennom følgende API-endepunkter. | 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 Gratis | minimax-m2.1-fri | `https://opencode.ai/zen/v1/messages` | `@ai-sdk/anthropic` | +| MiniMax M2.1 Gratis | 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 Gratis | glm-4.7-fri | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | +| GLM 4.7 Gratis | 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 Gratis | kimi-k2.5-fri | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | -| Kimi K2 Tenker | kimi-k2-tenking | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | +| Kimi K2.5 Gratis | kimi-k2.5-free | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | +| Kimi K2 Tenker | 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-koder 480B | qwen3-koder | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | -| Stor sylteagurk | stor sylteagurk | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | +| Qwen3-koder 480B | qwen3-coder | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | +| Stor sylteagurk | big-pickle | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | -[modell-id](/docs/config/#models) i OpenCode-konfigurasjonen +[model-id](/docs/config/#models) i OpenCode-konfigurationen bruger formatet `opencode/`. For eksempel, for GPT 5.2 Codex, ville du -brug `opencode/gpt-5.2-codex` i konfigurasjonen din. +bruge `opencode/gpt-5.2-codex` i din konfiguration. --- @@ -112,143 +112,143 @@ https://opencode.ai/zen/v1/models ## Priser -Vi støtter en pay-as-you-go-modell. Nedenfor er prisene **per 1 million tokens**. +Vi støtter en pay-as-you-go-model. Nedenfor er priserne **per 1 million tokens**. -| Modell | Inngang | Utgang | Bufret Les | Bufret skriv | -| --------------------------------- | ------- | ------ | ---------- | ------------ | -| Stor sylteagurk | Gratis | Gratis | Gratis | - | -| MiniMax M2.1 Gratis | Gratis | Gratis | Gratis | - | -| MiniMax M2.1 | $0,30 | $1,20 | $0,10 | - | -| GLM 4.7 Gratis | Gratis | Gratis | Gratis | - | -| GLM 4.7 | $0,60 | $2,20 | $0,10 | - | -| GLM 4.6 | $0,60 | $2,20 | $0,10 | - | -| Kimi K2.5 Gratis | Gratis | Gratis | Gratis | - | -| Kimi K2.5 | $0,60 | $3,00 | $0,08 | - | -| Kimi K2 Tenker | $0,40 | $2,50 | - | - | -| Kimi K2 | $0,40 | $2,50 | - | - | -| Qwen3-koder 480B | $0,45 | $1,50 | - | - | -| Claude Sonnet 4.5 (≤ 200K tokens) | $3,00 | $15,00 | $0,30 | $3,75 | -| Claude Sonnet 4.5 (> 200K tokens) | $6,00 | $22,50 | $0,60 | $7,50 | -| Claude Sonnet 4 (≤ 200K tokens) | $3,00 | $15,00 | $0,30 | $3,75 | -| Claude Sonnet 4 (> 200K tokens) | $6,00 | $22,50 | $0,60 | $7,50 | -| Claude Haiku 4.5 | $1,00 | $5,00 | $0,10 | $1,25 | -| Claude Haiku 3.5 | $0,80 | $4,00 | $0,08 | $1,00 | -| Claude Opus 4.6 (≤ 200K tokens) | $5,00 | $25,00 | $0,50 | $6,25 | -| Claude Opus 4.6 (> 200K tokens) | $10,00 | $37,50 | $1,00 | $12,50 | -| Claude Opus 4.5 | $5,00 | $25,00 | $0,50 | $6,25 | -| Claude Opus 4.1 | $15,00 | $75,00 | $1,50 | $18,75 | -| Gemini 3 Pro (≤ 200K tokens) | $2,00 | $12,00 | $0,20 | - | -| Gemini 3 Pro (> 200K tokens) | $4,00 | $18,00 | $0,40 | - | -| Gemini 3 Flash | $0,50 | $3,00 | $0,05 | - | -| GPT 5.2 | $1,75 | $14,00 | $0,175 | - | -| GPT 5.2 Codex | $1,75 | $14,00 | $0,175 | - | -| GPT 5.1 | $1,07 | $8,50 | $0,107 | - | -| GPT 5.1 Codex | $1,07 | $8,50 | $0,107 | - | -| GPT 5.1 Codex Max | $1,25 | $10,00 | $0,125 | - | -| GPT 5.1 Codex Mini | $0,25 | $2,00 | $0,025 | - | -| GPT 5 | $1,07 | $8,50 | $0,107 | - | -| GPT 5 Codex | $1,07 | $8,50 | $0,107 | - | -| GPT 5 Nano | Gratis | Gratis | Gratis | - | +| Model | Input | Output | Cached Læs | Cached Skriv | +| --------------------------------- | ------ | ------ | ---------- | ------------ | +| Stor sylteagurk | Gratis | Gratis | Gratis | - | +| MiniMax M2.1 Gratis | Gratis | Gratis | Gratis | - | +| MiniMax M2.1 | $0,30 | $1,20 | $0,10 | - | +| GLM 4.7 Gratis | Gratis | Gratis | Gratis | - | +| GLM 4.7 | $0,60 | $2,20 | $0,10 | - | +| GLM 4.6 | $0,60 | $2,20 | $0,10 | - | +| Kimi K2.5 Gratis | Gratis | Gratis | Gratis | - | +| Kimi K2.5 | $0,60 | $3,00 | $0,08 | - | +| Kimi K2 Tenker | $0,40 | $2,50 | - | - | +| Kimi K2 | $0,40 | $2,50 | - | - | +| Qwen3-koder 480B | $0,45 | $1,50 | - | - | +| Claude Sonnet 4.5 (≤ 200K tokens) | $3,00 | $15,00 | $0,30 | $3,75 | +| Claude Sonnet 4.5 (> 200K tokens) | $6,00 | $22,50 | $0,60 | $7,50 | +| Claude Sonnet 4 (≤ 200K tokens) | $3,00 | $15,00 | $0,30 | $3,75 | +| Claude Sonnet 4 (> 200K tokens) | $6,00 | $22,50 | $0,60 | $7,50 | +| Claude Haiku 4.5 | $1,00 | $5,00 | $0,10 | $1,25 | +| Claude Haiku 3.5 | $0,80 | $4,00 | $0,08 | $1,00 | +| Claude Opus 4.6 (≤ 200K tokens) | $5,00 | $25,00 | $0,50 | $6,25 | +| Claude Opus 4.6 (> 200K tokens) | $10,00 | $37,50 | $1,00 | $12,50 | +| Claude Opus 4.5 | $5,00 | $25,00 | $0,50 | $6,25 | +| Claude Opus 4.1 | $15,00 | $75,00 | $1,50 | $18,75 | +| Gemini 3 Pro (≤ 200K tokens) | $2,00 | $12,00 | $0,20 | - | +| Gemini 3 Pro (> 200K tokens) | $4,00 | $18,00 | $0,40 | - | +| Gemini 3 Flash | $0,50 | $3,00 | $0,05 | - | +| GPT 5.2 | $1,75 | $14,00 | $0,175 | - | +| GPT 5.2 Codex | $1,75 | $14,00 | $0,175 | - | +| GPT 5.1 | $1,07 | $8,50 | $0,107 | - | +| GPT 5.1 Codex | $1,07 | $8,50 | $0,107 | - | +| GPT 5.1 Codex Max | $1,25 | $10,00 | $0,125 | - | +| GPT 5.1 Codex Mini | $0,25 | $2,00 | $0,025 | - | +| GPT 5 | $1,07 | $8,50 | $0,107 | - | +| GPT 5 Codex | $1,07 | $8,50 | $0,107 | - | +| GPT 5 Nano | Gratis | Gratis | Gratis | - | -Du tilføjer kanskje merke til _Claude Haiku 3.5_ i brugshistorikken din. Dette er en [lavprismodell](/docs/config/#models) som bruges til at generere titlene på sessionene dine. +Du bemærker måske _Claude Haiku 3.5_ i din brugshistorik. Dette er en [lavprismodel](/docs/config/#models), som bruges til at generere titlerne på dine sessioner. :::note -Kredittkortgebyrer overføres til kostpris (4,4 % + $0,30 per transaksjon); vi belaster ikke noe utover det. +Kreditkortgebyrer overføres til kostpris (4,4 % + $0,30 per transaktion); vi opkræver ikke noget udover det. ::: -De gratis modellene: +De gratis modeller: -- GLM 4.7 Free er tilgængelig på OpenCode i en begrænset periode. Teamet bruger denne tiden til at samle tilbagemeldinger og forbedre modellen. -- Kimi K2.5 Gratis er tilgængelig på OpenCode i en begrænset periode. Teamet bruger denne tiden til at samle tilbagemeldinger og forbedre modellen. -- MiniMax M2.1 Free er tilgængelig på OpenCode i en begrænset periode. Teamet bruger denne tiden til at samle tilbagemeldinger og forbedre modellen. -- Big Pickle er en stealth-modell som er gratis på OpenCode i en begrænset periode. Teamet bruger denne tiden til at samle tilbagemeldinger og forbedre modellen. +- GLM 4.7 Gratis er tilgængelig på OpenCode i en begrænset periode. Teamet bruger denne tid til at samle feedback og forbedre modellen. +- Kimi K2.5 Gratis er tilgængelig på OpenCode i en begrænset periode. Teamet bruger denne tid til at samle feedback og forbedre modellen. +- MiniMax M2.1 Gratis er tilgængelig på OpenCode i en begrænset periode. Teamet bruger denne tid til at samle feedback og forbedre modellen. +- Stor sylteagurk er en stealth-model som er gratis på OpenCode i en begrænset periode. Teamet bruger denne tid til at samle feedback og forbedre modellen. -Contact us if you have any questions. +Kontakt os hvis du har spørgsmål. --- -### Last inn automatisk +### Automatisk opfyldning -Hvis saldoen din går under $5, vil Zen automatisk laste inn $20 på nytt. +Hvis din saldo går under $5, vil Zen automatisk laste $20 ind på nytt. -Du kan endre beløpet for automatisk påfylling. Du kan også deaktivere automatisk reload helt. +Du kan ændre beløbet for automatisk påfyldning. Du kan også deaktivere automatisk genindlæsning helt. --- -### Månedlige grenser +### Månedlige grænser -Du kan også angi en månedlig brugsgrense for hele arbeidsområdet og for hver -medlem av teamet ditt. +Du kan også angive en månedlig brugsgrænse for hele arbejdsområdet og for hvert +medlem af dit team. -La oss for eksempel si at du setter en månedlig brugsgrense til $20, Zen vil ikke bruge -mer enn $20 på en måned. Men hvis du har automatisk reload aktivert, kan Zen ende opp -belaster deg mer enn $20 hvis saldoen din går under $5. +Lad os for eksempel sige, at du sætter en månedlig brugsgrænse til $20, Zen vil ikke bruge +mere end $20 på en måned. Men hvis du har automatisk genindlæsning aktiveret, kan Zen ende med +at opkræve dig mere end $20, hvis din saldo går under $5. --- -## Personvern +## Privatliv -Alle våre modeller er vert i US. Leverandørene våre følger en nulloppbevaringspolicy og bruger ikke dataene dine til modellopplæring, med følgende unntak: +Alle vores modeller er hostet i USA. Vores udbydere følger en nul-opbevaringspolitik og bruger ikke dine data til modeltræning, med følgende undtagelser: -- Big Pickle: I løpet av gratisperioden kan innsamlede data bruges til at forbedre modellen. -- GLM 4.7 Gratis: I løpet av gratisperioden kan innsamlede data bruges til at forbedre modellen. -- Kimi K2.5 Gratis: I løpet av gratisperioden kan innsamlede data bruges til at forbedre modellen. -- MiniMax M2.1 Gratis: I løpet av gratisperioden kan innsamlede data bruges til at forbedre modellen. -- OpenAI APIer: Forespørsler oppbevares i 30 dager i samsvar med [OpenAIs datapolicyer](https://platform.openai.com/docs/guides/your-data). -- Anthropic APIer: Forespørsler oppbevares i 30 dager i samsvar med [Anthropics datapolicyer](https://docs.anthropic.com/en/docs/claude-code/data-usage). +- Stor sylteagurk: I løbet af gratisperioden kan indsamlede data bruges til at forbedre modellen. +- GLM 4.7 Gratis: I løbet af gratisperioden kan indsamlede data bruges til at forbedre modellen. +- Kimi K2.5 Gratis: I løbet af gratisperioden kan indsamlede data bruges til at forbedre modellen. +- MiniMax M2.1 Gratis: I løbet af gratisperioden kan indsamlede data bruges til at forbedre modellen. +- OpenAI API'er: Anmodninger opbevares i 30 dage i overensstemmelse med [OpenAIs datapolitikker](https://platform.openai.com/docs/guides/your-data). +- Anthropic API'er: Anmodninger opbevares i 30 dage i overensstemmelse med [Anthropics datapolitikker](https://docs.anthropic.com/en/docs/claude-code/data-usage). --- -## For lag +## For teams -Zen fungerer også utmerket for team. Du kan invitere lagkamerater, tildele roller, kuratere -modellene laget ditt bruger, og mer. +Zen fungerer også fremragende for teams. Du kan invitere holdkammerater, tildele roller, kuratere +de modeller dit hold bruger, og mere. :::note -Arbeidsområder er for øyeblikket gratis for team som en del av betaversjonen. +Arbejdsområder er i øjeblikket gratis for teams som en del af betaversionen. ::: -Å administrere arbeidsområdet ditt er for øyeblikket gratis for team som en del av betaversjonen. Det blir vi -deler mer informasjon om prisene snart. +At administrere dit arbejdsområde er i øjeblikket gratis for teams som en del af betaversionen. Vi vil +dele mere information om priserne snart. --- ### Roller -Du kan invitere lagkamerater til arbeidsområdet ditt og tildele roller: +Du kan invitere holdkammerater til dit arbejdsområde og tildele roller: -- **Admin**: Administrer modeller, medlemmer, API-nøkler og fakturering -- **Medlem**: Administrer kun sine egne API-nøkler +- **Admin**: Administrer modeller, medlemmer, API-nøgler og fakturering +- **Medlem**: Administrer kun sine egne API-nøgler -Administratorer kan også sette månedlige forbrugsgrenser for hvert medlem for at holde kostnadene under kontroll. +Administratorer kan også sætte månedlige forbrugsgrænser for hvert medlem for at holde omkostningerne under kontrol. --- -### Modelltilgang +### Modeladgang -Administratorer kan aktivere eller deaktivere spesifikke modeller for arbeidsområdet. Forespørsler til en deaktivert modell vil returnere en feil. +Administratorer kan aktivere eller deaktivere specifikke modeller for arbejdsområdet. Anmodninger til en deaktiveret model vil returnere en fejl. -Dette er nyttig for tilfeller der du ønsker at deaktivere brugen av en modell som -samler inn data. +Dette er nyttigt for tilfælde, hvor du ønsker at deaktivere brugen af en model, som +samler ind data. --- -### Ta med egen nøkkel +### Medbring din egen nøgle -Du kan bruge dine egne OpenAI- eller Anthropic API-nøkler mens du fortsatt har tilgang til andre modeller i Zen. +Du kan bruge dine egne OpenAI- eller Anthropic API-nøgler, mens du stadig har adgang til andre modeller i Zen. -Når du bruger dine egne nøkler, faktureres tokens direkte av leverandøren, ikke av Zen. +Når du bruger dine egne nøgler, faktureres tokens direkte af udbyderen, ikke af Zen. -For eksempel kan organisasjonen din allerede ha en nøkkel for OpenAI eller Anthropic -og du vil bruge det i stedet for det Zen gir. +For eksempel kan din organisation allerede have en nøgle for OpenAI eller Anthropic +og du vil bruge det i stedet for det Zen giver. --- ## Mål -Vi opretet OpenCode Zen for at: +Vi oprettede OpenCode Zen for at: -1. **Benchmark** de beste modellene/leverandørene for kodingsagenter. -2. Ha tilgang til alternativene for **høyeste kvalitet** og ikke nedgrader ytelsen eller rute til billigere leverandører. -3. Gi videre eventuelle **prisfall** ved at selge til kostpris; så den eneste markeringen er at dekke behandlingsgebyrene våre. -4. Ha **ingen låsing** ved at la deg bruge den med en hvilken som helst annen kodeagent. Og la deg alltid bruge en hvilken som helst annen leverandør med OpenCode også. +1. **Benchmarke** de bedste modeller/udbydere for kodningsagenter. +2. Have adgang til mulighederne for **højeste kvalitet** og ikke nedgradere ydeevnen eller rute til billigere udbydere. +3. Give videre eventuelle **prisfald** ved at sælge til kostpris; så den eneste mark-up er for at dække vores behandlingsgebyrer. +4. Have **ingen fastlåsning** ved at lade dig bruge den med en hvilken som helst anden kodeagent. Og lade dig altid bruge en hvilken som helst anden udbyder med OpenCode også. diff --git a/packages/web/src/content/docs/de/acp.mdx b/packages/web/src/content/docs/de/acp.mdx index 00b6743cb..d63a13c52 100644 --- a/packages/web/src/content/docs/de/acp.mdx +++ b/packages/web/src/content/docs/de/acp.mdx @@ -13,7 +13,7 @@ ACP ist ein offenes Protokoll, das die Kommunikation zwischen Code-Editoren und --- -## Konfigurieren +## Konfiguration Um OpenCode über ACP zu verwenden, konfigurieren Sie Ihren Editor für die Ausführung des Befehls `opencode acp`. @@ -69,7 +69,7 @@ Sie können auch eine Tastenkombination binden, indem Sie Ihren `keymap.json` be ### JetBrains IDEs -Fügen Sie zu Ihrem [JetBrains IDE](https://www.jetbrains.com/) acp.json gemäß [documentation](https://www.jetbrains.com/help/ai-assistant/acp.html) hinzu: +Fügen Sie zu Ihrem [JetBrains IDE](https://www.jetbrains.com/) acp.json gemäß [Dokumentation](https://www.jetbrains.com/help/ai-assistant/acp.html) hinzu: ```json title="acp.json" { @@ -140,7 +140,7 @@ Diese Konfiguration richtet CodeCompanion so ein, dass OpenCode als ACP-Agent f Wenn Sie Umgebungsvariablen (wie `OPENCODE_API_KEY`) übergeben müssen, finden Sie ausführliche Informationen zu [Configuring Adapters: Environment Variables](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) in der Dokumentation zu CodeCompanion.nvim. -## Support +## Unterstützung OpenCode funktioniert über ACP genauso wie im Terminal. Alle Funktionen werden unterstützt: diff --git a/packages/web/src/content/docs/de/agents.mdx b/packages/web/src/content/docs/de/agents.mdx index bf69bafd3..289b113cf 100644 --- a/packages/web/src/content/docs/de/agents.mdx +++ b/packages/web/src/content/docs/de/agents.mdx @@ -28,25 +28,11 @@ Sie können die **Tabulatortaste** verwenden, um während einer Sitzung zwischen ::: OpenCode verfügt über zwei integrierte Primäragenten: **Build** und **Plan**. Auch -Schauen Sie sich diese unten an. +Schauen wir uns diese unten an. --- -### Subagenten - -Unteragenten sind spezialisierte Assistenten, die Primäragenten für bestimmte Aufgaben aufrufen können. Sie können sie auch manuell aufrufen, indem Sie sie in Ihren Nachrichten **@erwähnen**. - -OpenCode verfügt über zwei integrierte Subagenten: **General** und **Explore**. Wir werden uns das weiter unten ansehen. - ---- - -## Eingebaut - -OpenCode verfügt über zwei integrierte Primäragenten und zwei integrierte Subagenten. - ---- - -### Use Build +### Build _Modus_: `primary` @@ -54,7 +40,7 @@ Build ist der **Standard**-Primäragent mit allen aktivierten Tools. Dies ist de --- -### Use Plan +### Plan _Modus_: `primary` @@ -68,7 +54,7 @@ Dieser Agent ist nützlich, wenn Sie möchten, dass LLM Code analysiert, Änderu --- -### Use General +### General _Modus_: `subagent` @@ -76,7 +62,7 @@ Ein Allzweckagent zur Recherche komplexerer Fragen und zur Ausführung mehrstufi --- -### Use Explore +### Explore _Modus_: `subagent` @@ -84,7 +70,7 @@ Ein schneller, schreibgeschützter Agent zum Erkunden von Codebasen. Dateien kö --- -### Use Compaction +### Compaction _Modus_: `primary` @@ -92,7 +78,7 @@ Versteckter Systemagent, der lange Kontext in einer kleineren Zusammenfassung ko --- -### Use Title +### Title _Modus_: `primary` @@ -100,7 +86,7 @@ Versteckter Systemagent, der kurze Sitzungstitel generiert. Es läuft automatisc --- -### Use Summary +### Summary _Modus_: `primary` @@ -121,14 +107,14 @@ Versteckter Systemagent, der Sitzungszusammenfassungen erstellt. Es läuft autom ``` 3. **Navigation zwischen Sitzungen**: Wenn Subagenten ihre eigenen untergeordneten Sitzungen erstellen, können Sie zwischen der übergeordneten Sitzung und allen untergeordneten Sitzungen sorgfältig handeln, indem Sie Folgendes verwenden: - - **\+Rechts** (oder Ihre konfigurierte `session_child_cycle`-Tastenkombination), um vorwärts durch Eltern → Kind1 → Kind2 → ... → Eltern zu blättern - - **\+Links** (oder Ihre konfigurierte `session_child_cycle_reverse`-Tastenkombination), um rückwärts durch übergeordnetes Element ← untergeordnetes Element1 ← untergeordnetes Element2 ← ... ← übergeordnetes Element zu blättern + - **\+Rechts** (oder Ihre konfigurierte `session_child_cycle`-Tastenkombination), um vorwärts durch Parent → Child1 → Child2 → ... → Parent zu blättern + - **\+Links** (oder Ihre konfigurierte `session_child_cycle_reverse`-Tastenkombination), um rückwärts durch Parent ← Child1 ← Child2 ← ... ← Parent zu blättern Dadurch können Sie nahtlos zwischen der Hauptkonversation und der spezialisierten Subagentenarbeit wechseln. --- -## Konfigurieren +## Konfiguration Sie können die integrierten Agenten anpassen oder über die Konfiguration eigene erstellen. Agenten können auf zwei Arten konfiguriert werden: @@ -210,9 +196,9 @@ Der Name der Markdown-Datei wird zum Agentennamen. Beispielsweise erstellte `rev --- -## Options +## Optionen -Schauen Sie sich diese Konfigurationsmöglichkeiten im Detail an. +Schauen wir uns diese Konfigurationsmöglichkeiten im Detail an. --- @@ -234,7 +220,7 @@ Dies ist eine **erforderliche** Konfigurationsoption. --- -### Temperature +### Temperatur Steuern Sie die Zufälligkeit und Kreativität der Antworten von LLM mit der `temperature`-Konfiguration. @@ -281,7 +267,7 @@ Wenn keine Temperatur angegeben ist, verwendet OpenCode modellspezifische Standa --- -### Maximale Schritte +### Schritte Steuern Sie die maximale Anzahl an Agenteniterationen, die ein Agent durchführen kann, bevor er gezwungen wird, nur mit Text zu antworten. Dadurch können Benutzer, die die Kosten kontrollieren möchten, ein Limit für Agentenaktionen festlegen. @@ -307,7 +293,7 @@ Das alte Feld `maxSteps` ist veraltet. Verwenden Sie stattdessen `steps`. --- -### Disable +### Deaktivieren Auf `true` setzen, um den Agenten zu deaktivieren. @@ -363,7 +349,7 @@ Die Modell-ID in Ihrer OpenCode-Konfiguration verwendet das Format `provider/mod --- -### Tools +### Werkzeuge Steuern Sie mit der `tools`-Konfiguration, welche Tools in diesem Agent verfügbar sind. Sie können bestimmte Tools aktivieren oder deaktivieren, indem Sie sie auf `true` oder `false` setzen. @@ -410,7 +396,7 @@ Sie können Platzhalter auch verwenden, um mehrere Werkzeuge gleichzeitig zu ste --- -### Permissions +### Berechtigungen Sie können Berechtigungen konfigurieren, um zu verwalten, welche Aktionen ein Agent ausführen kann. Derzeit können die Berechtigungen für die Tools `edit`, `bash` und `webfetch` wie folgt konfiguriert werden: @@ -522,7 +508,7 @@ Da die letzte übereinstimmende Regel Vorrang hat, setzen Sie zuerst den Platzha --- -### Mode +### Modus Steuern Sie den Modus des Agenten mit der `mode`-Konfiguration. Mit der Option `mode` wird festgelegt, wie der Agent verwendet werden kann. @@ -540,7 +526,7 @@ Die Option `mode` kann auf `primary`, `subagent` oder `all` gesetzt werden. Wenn --- -### Hidden +### Versteckt Verstecken Sie einen Subagenten im Autovervollständigungsmenü `@` mit `hidden: true`. Nützlich für interne Subagenten, die nur programmgesteuert von anderen Agenten über das Task-Tool aufgerufen werden sollten. @@ -563,7 +549,7 @@ Gilt nur für `mode: subagent`-Agenten. --- -### Aufgabenberechtigungen +### Task-Berechtigungen Steuern Sie, welche Subagenten ein Agent über das Task-Tool mit `permission.task` aufrufen kann. Verwendet Glob-Muster für eine flexible Zuordnung. @@ -596,11 +582,11 @@ Benutzer können jeden Subagenten immer direkt über das Autovervollständigungs --- -### Color +### Farbe Passen Sie das visuelle Erscheinungsbild des Agenten im UI mit der Option `color` an. Dies wirkt sich darauf aus, wie der Agent in der Benutzeroberfläche angezeigt wird. -Verwenden Sie eine gültige Hex-Farbe (e.g., `#FF5733`) oder Themenfarbe: `primary`, `secondary`, `accent`, `success`, `warning`, `error`, `info`. +Verwenden Sie eine gültige Hex-Farbe (z. B. `#FF5733`) oder Themenfarbe: `primary`, `secondary`, `accent`, `success`, `warning`, `error`, `info`. ```json title="opencode.json" { @@ -635,7 +621,7 @@ Die Werte reichen von 0.0 bis 1.0. Niedrigere Werte sind fokussierter, höhere W --- -### Additional +### Zusätzliche Optionen Alle anderen Optionen, die Sie in Ihrer Agentenkonfiguration angeben, werden als Modelloptionen **direkt** an den Anbieter weitergeleitet. Dadurch können Sie anbieterspezifische Funktionen und Parameter nutzen. @@ -662,7 +648,7 @@ Führen Sie `opencode models` aus, um eine Liste der verfügbaren Modelle anzubi --- -## Erstellen Sie Agenten +## Agenten erstellen Mit dem folgenden Befehl können Sie neue Agenten erstellen: @@ -692,12 +678,12 @@ Hier sind einige häufige Anwendungsfälle für verschiedene Agenten. --- -## Examples +## Beispiele Hier sind einige Beispielagenten, die für Sie nützlich sein könnten. :::tip -Haben Sie einen Agenten, den Sie gerne teilen möchten? [Submit a PR](https://github.com/anomalyco/opencode). +Haben Sie einen Agenten, den Sie gerne teilen möchten? [Reichen Sie einen PR ein](https://github.com/anomalyco/opencode). ::: --- diff --git a/packages/web/src/content/docs/de/cli.mdx b/packages/web/src/content/docs/de/cli.mdx index 26b0379c5..650e75d31 100644 --- a/packages/web/src/content/docs/de/cli.mdx +++ b/packages/web/src/content/docs/de/cli.mdx @@ -27,7 +27,7 @@ Starten Sie die Terminalbenutzeroberfläche OpenCode. opencode [project] ``` -#### Flags +#### Optionen | Flag | Kurz | Beschreibung | | ------------ | ---- | ---------------------------------------------------------------------- | @@ -76,7 +76,7 @@ opencode web --port 4096 --hostname 0.0.0.0 opencode attach http://10.20.30.40:4096 ``` -#### Flags +#### Optionen | Flag | Kurz | Beschreibung | | ----------- | ---- | ----------------------------------------- | @@ -185,7 +185,7 @@ Führen Sie den GitHub-Agenten aus. Dies wird normalerweise in GitHub-Aktionen v opencode github run ``` -##### Flags +##### Optionen | Flag | Beschreibung | | --------- | --------------------------------------------------- | @@ -294,7 +294,7 @@ Sie können optional eine Anbieter-ID übergeben, um Modelle nach diesem Anbiete opencode models anthropic ``` -#### Flags +#### Optionen | Flag | Beschreibung | | ----------- | ------------------------------------------------------------------------------------- | @@ -317,7 +317,7 @@ Führen Sie OpenCode im nicht interaktiven Modus aus, indem Sie direkt eine Eing opencode run [message..] ``` -Dies ist nützlich für die Skripterstellung, die Automatisierung oder wenn Sie eine schnelle Antwort wünschen, ohne das vollständige TUI zu starten. Zum Beispiel. +Dies ist nützlich für die Skripterstellung, die Automatisierung oder wenn Sie eine schnelle Antwort wünschen, ohne das vollständige TUI zu starten. Zum Beispiel: ```bash "opencode run" opencode run Explain the use of context in Go @@ -333,11 +333,11 @@ opencode serve opencode run --attach http://localhost:4096 "Explain async/await in JavaScript" ``` -#### Flags +#### Optionen | Flag | Kurz | Beschreibung | | ------------ | ---- | --------------------------------------------------------------------------------------------------- | -| `--command` | | Der auszuführende Befehl, Nachricht für Argumente verwenden | +| `--command` | | Der auszuführende Befehl, Argumente als Nachricht verwenden | | `--continue` | `-c` | Setzen Sie die letzte Sitzung fort | | `--session` | `-s` | Session-ID zum Fortfahren | | `--fork` | | Sitzung beim Fortsetzen verzweigen (mit `--continue` oder `--session` verwenden) | @@ -362,7 +362,7 @@ opencode serve Dadurch wird ein HTTP-Server gestartet, der API-Zugriff auf OpenCode-Funktionalität ohne die TUI-Schnittstelle bietet. Legen Sie `OPENCODE_SERVER_PASSWORD` fest, um die HTTP-Basisauthentifizierung zu aktivieren (Benutzername ist standardmäßig `opencode`). -#### Flags +#### Optionen | Flag | Beschreibung | | ------------ | ----------------------------------------------- | @@ -391,7 +391,7 @@ Listen Sie alle OpenCode-Sitzungen auf. opencode session list ``` -##### Flags +##### Optionen | Flag | Kurz | Beschreibung | | ------------- | ---- | ---------------------------------------- | @@ -408,7 +408,7 @@ Zeigen Sie Token-Nutzungs- und Kostenstatistiken für Ihre OpenCode-Sitzungen an opencode stats ``` -#### Flags +#### Optionen | Flag | Beschreibung | | ----------- | ------------------------------------------------------------------------------------------------------------------------------ | @@ -458,7 +458,7 @@ opencode web Dadurch wird ein HTTP-Server gestartet und ein Webbrowser geöffnet, um über eine Webschnittstelle auf OpenCode zuzugreifen. Legen Sie `OPENCODE_SERVER_PASSWORD` fest, um die HTTP-Basisauthentifizierung zu aktivieren (Benutzername ist standardmäßig `opencode`). -#### Flags +#### Optionen | Flag | Beschreibung | | ------------ | ----------------------------------------------- | @@ -479,7 +479,7 @@ opencode acp Dieser Befehl startet einen ACP-Server, der über stdin/stdout unter Verwendung von nd-JSON kommuniziert. -#### Flags +#### Optionen | Flag | Beschreibung | | ------------ | -------------------- | @@ -497,7 +497,7 @@ Deinstallieren Sie OpenCode und entfernen Sie alle zugehörigen Dateien. opencode uninstall ``` -#### Flags +#### Optionen | Flag | Kurz | Beschreibung | | --------------- | ---- | --------------------------------------------------- | @@ -516,7 +516,7 @@ Aktualisiert OpenCode auf die neueste Version oder eine bestimmte Version. opencode upgrade [target] ``` -Um auf die neueste Version zu aktualisieren. +Um auf die neueste Version zu aktualisieren: ```bash opencode upgrade @@ -528,11 +528,11 @@ Um auf eine bestimmte Version zu aktualisieren. opencode upgrade v0.1.48 ``` -#### Flags +#### Optionen -| Flag | Kurz | Beschreibung | -| ---------- | ---- | --------------------------------------------------------------- | -| `--method` | `-m` | Die verwendete Installationsmethode; curl, npm, pnpm, bun, brew | +| Flag | Kurz | Beschreibung | +| ---------- | ---- | ------------------------------------------------------------------- | +| `--method` | `-m` | Die zu verwendende Installationsmethode; curl, npm, pnpm, bun, brew | --- @@ -582,7 +582,7 @@ OpenCode kann mithilfe von Umgebungsvariablen konfiguriert werden. --- -### Experimental +### Experimentell Diese Umgebungsvariablen ermöglichen experimentelle Funktionen, die sich ändern oder entfernt werden können. diff --git a/packages/web/src/content/docs/de/commands.mdx b/packages/web/src/content/docs/de/commands.mdx index c1510bd9f..5c795fba0 100644 --- a/packages/web/src/content/docs/de/commands.mdx +++ b/packages/web/src/content/docs/de/commands.mdx @@ -9,7 +9,7 @@ Mit benutzerdefinierten Befehlen können Sie eine Eingabeaufforderung angeben, d /my-command ``` -Benutzerdefinierte Befehle gibt es zusätzlich zu den integrierten Befehlen wie `/init`, `/undo`, `/redo`, `/share`, `/help`. [Learn more](/docs/tui#commands). +Benutzerdefinierte Befehle gibt es zusätzlich zu den integrierten Befehlen wie `/init`, `/undo`, `/redo`, `/share`, `/help`. [Mehr erfahren](/docs/tui#commands). --- @@ -40,7 +40,7 @@ Verwenden Sie den Befehl, indem Sie `/` folgen vom Befehlsnamen eingeben. --- -## Konfigurieren +## Konfiguration Sie können benutzerdefinierte Befehle über die OpenCode-Konfiguration hinzufügen oder indem Sie Markdown-Dateien im Verzeichnis `commands/` erstellen. @@ -108,7 +108,7 @@ Die Eingabeaufforderungen für die benutzerdefinierten Befehle unterstützen meh --- -### Arguments +### Argumente Übergeben Sie Argumente an Befehle mithilfe des Platzhalters `$ARGUMENTS`. @@ -212,7 +212,7 @@ Der Dateiinhalt wird automatisch in die Eingabeaufforderung einbezogen. --- -## Options +## Optionen Schauen wir uns die Konfigurationsmöglichkeiten im Detail an. @@ -236,7 +236,7 @@ Dies ist eine **erforderliche** Konfigurationsoption. --- -### Beschreibung +### Description Verwenden Sie die Option `description`, um eine kurze Beschreibung der Funktion des Befehls bereitzustellen. @@ -294,7 +294,7 @@ Dies ist eine **optionale** Konfigurationsoption. --- -### Modell +### Model Verwenden Sie die `model`-Konfiguration, um das Standardmodell für diesen Befehl zu überschreiben. @@ -312,9 +312,9 @@ Dies ist eine **optionale** Konfigurationsoption. --- -## Eingebaut +## Integriert -OpenCode enthält mehrere integrierte Befehle wie `/init`, `/undo`, `/redo`, `/share`, `/help`; [learn more](/docs/tui#commands). +OpenCode enthält mehrere integrierte Befehle wie `/init`, `/undo`, `/redo`, `/share`, `/help`; [mehr erfahren](/docs/tui#commands). :::note Benutzerdefinierte Befehle können integrierte Befehle überschreiben. diff --git a/packages/web/src/content/docs/de/config.mdx b/packages/web/src/content/docs/de/config.mdx index a30bde980..0a2040be7 100644 --- a/packages/web/src/content/docs/de/config.mdx +++ b/packages/web/src/content/docs/de/config.mdx @@ -1,5 +1,5 @@ --- -title: Konfig +title: Konfiguration description: Verwenden Sie die Konfiguration OpenCode JSON. --- @@ -23,7 +23,7 @@ OpenCode unterstützt die Formate **JSON** und **JSONC** (JSON mit Kommentaren). --- -## Locations +## Speicherorte Sie können Ihre Konfiguration an verschiedenen Orten platzieren und sie haben eine andere Rangfolge. @@ -52,7 +52,7 @@ Konfigurationsquellen werden in dieser Reihenfolge geladen (spätere Quellen üb Dies bedeutet, dass Projektkonfigurationen globale Standardeinstellungen überschreiben können und globale Konfigurationen Remote-Organisationsstandards überschreiben können. :::note -Die Verzeichnisse `.opencode` und `~/.config/opencode` verwenden **Pluralnamen** für Unterverzeichnisse: `agents/`, `commands/`, `modes/`, `plugins/`, `skills/`, `tools/` und `themes/`. Aus Gründen der Abwärtskompatibilität werden auch einzelne Namen (e.g., `agent/`) unterstützt. +Die Verzeichnisse `.opencode` und `~/.config/opencode` verwenden **Pluralnamen** für Unterverzeichnisse: `agents/`, `commands/`, `modes/`, `plugins/`, `skills/`, `tools/` und `themes/`. Aus Gründen der Abwärtskompatibilität werden auch einzelne Namen (z. B. `agent/`) unterstützt. ::: --- @@ -175,7 +175,7 @@ Verfügbare Optionen: - `scroll_speed` – Benutzerdefinierter Scrollgeschwindigkeitsmultiplikator (Standard: `3`, Minimum: `1`). Wird ignoriert, wenn `scroll_acceleration.enabled` gleich `true` ist. - `diff_style` – Steuern Sie das Diff-Rendering. `"auto"` passt sich der Terminalbreite an, `"stacked"` zeigt immer eine einzelne Spalte an. -[Learn more about using the TUI here](/docs/tui). +[Erfahren Sie hier mehr über die Verwendung der TUI](/docs/tui). --- @@ -204,11 +204,11 @@ Verfügbare Optionen: - `mdnsDomain` – Benutzerdefinierter Domänenname für den mDNS-Dienst. Standardmäßig ist `opencode.local`. Nützlich für die Ausführung mehrerer Instanzen im selben Netzwerk. - `cors` – Zusätzliche Ursprünge, um CORS zu ermöglichen, wenn der HTTP-Server von einem browserbasierten Client aus verwendet wird. Die Werte müssen vollständige Ursprünge haben (Schema + Host + optionaler Port), z. B. `https://app.example.com`. -[Learn more about the server here](/docs/server). +[Erfahren Sie hier mehr über den Server](/docs/server). --- -### Tools +### Werkzeuge Sie können die Tools, die ein LLM verwenden kann, über die Option `tools` verwalten. @@ -222,11 +222,11 @@ Sie können die Tools, die ein LLM verwenden kann, über die Option `tools` verw } ``` -[Learn more about tools here](/docs/tools). +[Erfahren Sie hier mehr über Tools](/docs/tools). --- -### Models +### Modelle Sie können die Anbieter und Modelle, die Sie in Ihrer OpenCode-Konfiguration verwenden möchten, über die Optionen `provider`, `model` und `small_model` konfigurieren. @@ -260,7 +260,7 @@ Zu den Anbieteroptionen können `timeout` und `setCacheKey` gehören: - `timeout` – Anforderungszeitlimit in Millisekunden (Standard: 300000). Zum Deaktivieren auf `false` setzen. - `setCacheKey` – Stellen Sie sicher, dass immer ein Cache-Schlüssel für den angegebenen Anbieter festgelegt ist. -Sie können auch [local models](/docs/models#local) konfigurieren. [Learn more](/docs/models). +Sie können auch [lokale Modelle](/docs/models#local) konfigurieren. [Mehr erfahren](/docs/models). --- @@ -292,14 +292,14 @@ Amazon Bedrock unterstützt AWS-spezifische Konfigurationen: - `endpoint` – Benutzerdefinierter Endpunkt URL für VPC-Endpunkte. Dies ist ein Alias ​​​​für die generische Option `baseURL` unter Verwendung der AWS-spezifischen Terminologie. Wenn beide angegeben sind, hat `endpoint` Vorrang. :::note -Inhabertoken (`AWS_BEARER_TOKEN_BEDROCK` oder `/connect`) haben Vorrang vor der profilbasierten Authentifizierung. Weitere Informationen finden Sie unter [authentication precedence](/docs/providers#authentication-precedence). +Inhabertoken (`AWS_BEARER_TOKEN_BEDROCK` oder `/connect`) haben Vorrang vor der profilbasierten Authentifizierung. Weitere Informationen finden Sie unter [Authentifizierungs-Rangfolge](/docs/providers#authentication-precedence). ::: -[Learn more about Amazon Bedrock configuration](/docs/providers#amazon-bedrock). +[Erfahren Sie mehr über die Amazon Bedrock-Konfiguration](/docs/providers#amazon-bedrock). --- -### Themes +### Themen Sie können das Thema, das Sie in Ihrer OpenCode-Konfiguration verwenden möchten, über die Option `theme` konfigurieren. @@ -310,11 +310,11 @@ Sie können das Thema, das Sie in Ihrer OpenCode-Konfiguration verwenden möchte } ``` -[Learn more here](/docs/themes). +[Mehr erfahren](/docs/themes). --- -### Agents +### Agenten Über die Option `agent` können Sie spezielle Agenten für bestimmte Aufgaben konfigurieren. @@ -336,7 +336,7 @@ Sie können das Thema, das Sie in Ihrer OpenCode-Konfiguration verwenden möchte } ``` -Sie können Agenten auch mithilfe von Markdown-Dateien in `~/.config/opencode/agents/` oder `.opencode/agents/` definieren. [Learn more here](/docs/agents). +Sie können Agenten auch mithilfe von Markdown-Dateien in `~/.config/opencode/agents/` oder `.opencode/agents/` definieren. [Mehr erfahren](/docs/agents). --- @@ -357,7 +357,7 @@ Diese Einstellung gilt für alle Schnittstellen: TUI, CLI (`opencode run`), Desk --- -### Sharing +### Teilen Sie können die Funktion [share](/docs/share) über die Option `share` konfigurieren. @@ -400,11 +400,11 @@ Sie können benutzerdefinierte Befehle für sich wiederholende Aufgaben über di } ``` -Sie können Befehle auch mithilfe von Markdown-Dateien in `~/.config/opencode/commands/` oder `.opencode/commands/` definieren. [Learn more here](/docs/commands). +Sie können Befehle auch mithilfe von Markdown-Dateien in `~/.config/opencode/commands/` oder `.opencode/commands/` definieren. [Mehr erfahren](/docs/commands). --- -### Keybinds +### Tastenkombinationen Sie können Ihre Tastenkombinationen über die Option `keybinds` anpassen. @@ -415,11 +415,11 @@ Sie können Ihre Tastenkombinationen über die Option `keybinds` anpassen. } ``` -[Learn more here](/docs/keybinds). +[Mehr erfahren](/docs/keybinds). --- -### Autoupdate +### Automatisches Update OpenCode lädt beim Start automatisch alle neuen Updates herunter. Sie können dies mit der Option `autoupdate` deaktivieren. @@ -435,7 +435,7 @@ Beachten Sie, dass dies nur funktioniert, wenn es nicht mit einem Paketmanager w --- -### Formatters +### Formatierer Sie können Codeformatierer über die Option `formatter` konfigurieren. @@ -457,11 +457,11 @@ Sie können Codeformatierer über die Option `formatter` konfigurieren. } ``` -[Learn more about formatters here](/docs/formatters). +[Erfahren Sie hier mehr über Formatierer](/docs/formatters). --- -### Permissions +### Berechtigungen OpenCode erlaubt standardmäßig alle Vorgänge, ohne dass eine ausdrückliche Genehmigung erforderlich ist. Sie können dies mit der Option `permission` ändern. @@ -477,11 +477,11 @@ Um beispielsweise sicherzustellen, dass die Tools `edit` und `bash` eine Benutze } ``` -[Learn more about permissions here](/docs/permissions). +[Erfahren Sie hier mehr über Berechtigungen](/docs/permissions). --- -### Compaction +### Komprimierung Sie können das Verhalten der Kontextkomprimierung über die Option `compaction` steuern. @@ -500,7 +500,7 @@ Sie können das Verhalten der Kontextkomprimierung über die Option `compaction` --- -### Watcher +### Dateiüberwachung Sie können Datei-Watcher-Ignoriermuster über die Option `watcher` konfigurieren. @@ -517,7 +517,7 @@ Muster folgen der Glob-Syntax. Verwenden Sie diese Option, um verrauschte Verzei --- -### MCP Server +### MCP Sie können den MCP-Server, den Sie verwenden möchten, über die Option `mcp` konfigurieren. @@ -528,7 +528,7 @@ Sie können den MCP-Server, den Sie verwenden möchten, über die Option `mcp` k } ``` -[Learn more here](/docs/mcp-servers). +[Mehr erfahren](/docs/mcp-servers). --- @@ -545,11 +545,11 @@ Platzieren Sie Ihre Plugin-Dateien in `.opencode/plugins/` oder `~/.config/openc } ``` -[Learn more here](/docs/plugins). +[Mehr erfahren](/docs/plugins). --- -### Instructions +### Anweisungen Sie können die Anweisungen für das von Ihnen verwendete Modell über die Option `instructions` konfigurieren. @@ -560,8 +560,7 @@ Sie können die Anweisungen für das von Ihnen verwendete Modell über die Optio } ``` -Dies erfordert eine Reihe von Pfaden und Glob-Mustern zu Anweisungsdateien. [Erfahren Sie mehr -über Regeln hier](/docs/rules). +Dies erfordert eine Reihe von Pfaden und Glob-Mustern zu Anweisungsdateien. [Erfahren Sie hier mehr über Regeln](/docs/rules). --- @@ -609,7 +608,7 @@ Wenn ein Anbieter sowohl in `enabled_providers` als auch in `disabled_providers` --- -### Experimental +### Experimentell Der Schlüssel `experimental` enthält Optionen, die sich in der aktiven Entwicklung befinden. diff --git a/packages/web/src/content/docs/de/custom-tools.mdx b/packages/web/src/content/docs/de/custom-tools.mdx index 1af535db6..a6dfd64d5 100644 --- a/packages/web/src/content/docs/de/custom-tools.mdx +++ b/packages/web/src/content/docs/de/custom-tools.mdx @@ -1,5 +1,5 @@ --- -title: Benutzerdefinierte Werkzeuge +title: Benutzerdefinierte Tools description: Erstellen Sie Tools, die der LLM in OpenCode aufrufen kann. --- @@ -7,13 +7,13 @@ Benutzerdefinierte Tools sind von Ihnen erstellte Funktionen, die der LLM währe --- -## Ein Werkzeug erstellen +## Ein Tool erstellen -Werkzeuge werden als **TypeScript**- oder **JavaScript**-Dateien definiert. Die Werkzeugdefinition kann jedoch Skripte aufrufen, die in **jeder Sprache** geschrieben sind – TypeScript oder JavaScript wird nur für die Werkzeugdefinition selbst verwendet. +Tools werden als **TypeScript**- oder **JavaScript**-Dateien definiert. Die Tooldefinition kann jedoch Skripte aufrufen, die in **jeder Sprache** geschrieben sind – TypeScript oder JavaScript wird nur für die Tooldefinition selbst verwendet. --- -### Location +### Speicherort Sie können wie folgt definiert werden: @@ -22,7 +22,7 @@ Sie können wie folgt definiert werden: --- -### Structure +### Struktur Der einfachste Weg, Tools zu erstellen, ist die Verwendung des `tool()`-Helfers, der Typsicherheit und Validierung bietet. @@ -79,7 +79,7 @@ Dadurch werden zwei Tools erstellt: `math_add` und `math_multiply`. --- -### Arguments +### Argumente Sie können `tool.schema` verwenden, was nur [Zod](https://zod.dev) ist, um Argumenttypen zu definieren. @@ -108,7 +108,7 @@ export default { --- -### Context +### Kontext Tools erhalten Kontext zur aktuellen Sitzung: @@ -131,9 +131,9 @@ Verwenden Sie `context.worktree` für das Stammverzeichnis des Git-Arbeitsbaums. --- -## Examples +## Beispiele -### Schreiben Sie ein Tool in Python +### Ein Tool in Python schreiben Sie können Ihre Tools in jeder gewünschten Sprache schreiben. Hier ist ein Beispiel, das mit Python zwei Zahlen addiert. diff --git a/packages/web/src/content/docs/de/ecosystem.mdx b/packages/web/src/content/docs/de/ecosystem.mdx index 98b810730..ea1bc589a 100644 --- a/packages/web/src/content/docs/de/ecosystem.mdx +++ b/packages/web/src/content/docs/de/ecosystem.mdx @@ -50,7 +50,7 @@ Sie können sich auch [awesome-opencode](https://github.com/awesome-opencode/awe --- -## Projects +## Projekte | Name | Beschreibung | | ------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------- | @@ -68,7 +68,7 @@ Sie können sich auch [awesome-opencode](https://github.com/awesome-opencode/awe --- -## Agents +## Agenten | Name | Beschreibung | | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | diff --git a/packages/web/src/content/docs/de/enterprise.mdx b/packages/web/src/content/docs/de/enterprise.mdx index adb0f05f5..a01c71ae6 100644 --- a/packages/web/src/content/docs/de/enterprise.mdx +++ b/packages/web/src/content/docs/de/enterprise.mdx @@ -19,7 +19,7 @@ So starten Sie mit OpenCode Enterprise: --- -## Trial +## Testphase OpenCode ist Open Source und speichert keine Ihrer Code- oder Kontextdaten, sodass Ihr Entwickler einfach [get started](/docs/) und eine Testversion durchführen kann. @@ -61,13 +61,13 @@ Wir empfehlen Ihnen, dies für Ihre Testversion zu deaktivieren. --- -## Pricing +## Preise Für OpenCode Enterprise verwenden wir ein Pro-Sitz-Modell. Wenn Sie über ein eigenes LLM-Gateway verfügen, berechnen wir keine Gebühren für die verwendeten Token. Für weitere Informationen zu Preisen und Implementierungsoptionen **kontaktieren Sie uns**. --- -## Deployment +## Bereitstellung Sobald Sie Ihre Testversion abgeschlossen haben und bereit sind, OpenCode unter zu verwenden Für Ihre Organisation können Sie **uns kontaktieren**, um dies zu besprechen @@ -99,7 +99,7 @@ Sie können auch alle anderen AI-Anbieter deaktivieren und so sicherstellen, das --- -### Self-hosting +### Self-Hosting Wir empfehlen jedoch, die Freigabeseiten zu deaktivieren, um sicherzustellen, dass Ihre Daten niemals verloren gehen In Ihrer Organisation können wir Ihnen auch dabei helfen, sie selbst in Ihrer Infrastruktur zu hosten. @@ -111,14 +111,14 @@ Dies steht derzeit auf unserer Roadmap. Wenn Sie Interesse haben, ** -

What is OpenCode Enterprise? +Was ist OpenCode Enterprise? OpenCode Enterprise ist für Organisationen gedacht, die sicherstellen möchten, dass ihr Code und ihre Daten niemals ihre Infrastruktur verlassen. Dies kann durch die Verwendung einer zentralen Konfiguration erreicht werden, die in Ihr SSO- und internes AI-Gateway integriert ist.
-How do I get started with OpenCode Enterprise? +Wie fange ich mit OpenCode Enterprise an? Beginnen Sie einfach mit einem internen Test mit Ihrem Team. OpenCode speichert standardmäßig weder Ihren Code noch Ihre Kontextdaten, was den Einstieg erleichtert. @@ -127,21 +127,21 @@ Dann **kontaktieren Sie uns**, um Preise und Implementierung
-How does enterprise pricing work? +Wie funktioniert die Preisgestaltung für Unternehmen? Wir bieten Enterprise-Preise pro Sitzplatz an. Wenn Sie über ein eigenes LLM-Gateway verfügen, berechnen wir keine Gebühren für die verwendeten Token. Für weitere Informationen **kontaktieren Sie uns** für ein individuelles Angebot, das auf die Bedürfnisse Ihrer Organisation zugeschnitten ist.
-Is my data secure with OpenCode Enterprise? +Sind meine Daten bei OpenCode Enterprise sicher? Ja. OpenCode speichert Ihren Code oder Ihre Kontextdaten nicht. Die gesamte Verarbeitung erfolgt lokal oder durch direkte API-Anrufe an Ihren AI-Anbieter. Dank zentraler Konfiguration und SSO-Integration bleiben Ihre Daten innerhalb der Infrastruktur Ihres Unternehmens sicher.
-Can we use our own private NPM registry? +Können wir unsere eigene private NPM-Registry verwenden? OpenCode unterstützt private NPM-Registrierungen durch Buns native `.npmrc`-Dateiunterstützung. Wenn Ihre Organisation eine private Registrierung wie JFrog Artifactory, Nexus oder ähnliches verwendet, stellen Sie sicher, dass der Entwickler authentifiziert ist, bevor Sie OpenCode ausführen. diff --git a/packages/web/src/content/docs/de/formatters.mdx b/packages/web/src/content/docs/de/formatters.mdx index 3cdf6450d..f953f16cb 100644 --- a/packages/web/src/content/docs/de/formatters.mdx +++ b/packages/web/src/content/docs/de/formatters.mdx @@ -7,7 +7,7 @@ OpenCode formatiert Dateien automatisch, nachdem sie mit sprachspezifischen Form --- -## Eingebaut +## Integriert OpenCode verfügt über mehrere integrierte Formatierer für gängige Sprachen und Frameworks. Nachfolgend finden Sie eine Liste der Formatierer, unterstützten Dateierweiterungen und benötigten Befehle oder Konfigurationsoptionen. @@ -42,7 +42,7 @@ Wenn Ihr Projekt auch `prettier` in Ihrem `package.json` hat, wird OpenCode auto --- -## Wie es funktioniert +## Funktionsweise Wenn OpenCode eine Datei schreibt oder bearbeitet, geschieht Folgendes: @@ -54,7 +54,7 @@ Dieser Prozess findet im Hintergrund statt und stellt sicher, dass Ihr Codestile --- -## Konfigurieren +## Konfiguration Sie können Formatierer über den Abschnitt `formatter` in Ihrer OpenCode-Konfiguration anpassen. diff --git a/packages/web/src/content/docs/de/github.mdx b/packages/web/src/content/docs/de/github.mdx index d084cdb28..71881c333 100644 --- a/packages/web/src/content/docs/de/github.mdx +++ b/packages/web/src/content/docs/de/github.mdx @@ -7,7 +7,7 @@ OpenCode lässt sich in Ihren GitHub-Workflow integrieren. Erwähnen Sie `/openc --- -## Features +## Funktionen - **Issue Triage**: Bitten Sie OpenCode, ein Problem zu untersuchen und es Ihnen zu erklären. - **Reparieren und implementieren**: Bitten Sie OpenCode, ein Problem zu beheben oder eine Funktion zu implementieren. Und es funktioniert in einem neuen Branch und sendet ein PR mit allen Änderungen. @@ -79,7 +79,7 @@ Oder Sie können es manuell einrichten. --- -## Configuration +## Konfiguration - `model`: Das mit OpenCode zu verwendende Modell. Nimmt das Format `provider/model` an. Dies ist **erforderlich**. - `agent`: Der zu verwendende Agent. Muss ein Hauptagent sein. Fällt aus der Konfiguration auf `default_agent` oder `"build"` zurück, wenn es nicht gefunden wird. @@ -195,7 +195,7 @@ Wenn für `pull_request`-Ereignisse kein `prompt` bereitgestellt wird, überprü --- -### Beispiel für eine Issue Triage +### Beispiel für eine Issue-Triage Neue Probleme automatisch selektieren. In diesem Beispiel wird nach Konten gefiltert, die älter als 30 Tage sind, um Spam zu reduzieren: @@ -250,7 +250,7 @@ Für `issues`-Ereignisse ist die Eingabe `prompt` **erforderlich**, da es keinen --- -## Benutzerdefinierte Eingabeaufforderungen +## Benutzerdefinierte Prompts Überschreiben Sie die Standardaufforderung, um das Verhalten von OpenCode für Ihren Workflow anzupassen. @@ -269,7 +269,7 @@ Dies ist nützlich, um bestimmte Prüfkriterien, Kodierungsstandards oder Schwer --- -## Examples +## Beispiele Hier sind einige Beispiele, wie Sie OpenCode in GitHub verwenden können. diff --git a/packages/web/src/content/docs/de/gitlab.mdx b/packages/web/src/content/docs/de/gitlab.mdx index 56cc7f35f..28289d4fb 100644 --- a/packages/web/src/content/docs/de/gitlab.mdx +++ b/packages/web/src/content/docs/de/gitlab.mdx @@ -17,7 +17,7 @@ Hier verwenden wir eine von der Community erstellte CI/CD-Komponente für OpenCo --- -### Features +### Funktionen - **Benutzerdefinierte Konfiguration pro Job verwenden**: Konfigurieren Sie OpenCode mit einem benutzerdefinierten Konfigurationsverzeichnis, zum Beispiel `./config/#custom-directory`, um die Funktionalität pro OpenCode-Aufruf zu aktivieren oder zu deaktivieren. - **Minimale Einrichtung**: Die CI-Komponente richtet OpenCode im Hintergrund ein. Sie müssen lediglich die OpenCode-Konfiguration und die erste Eingabeaufforderung erstellen. @@ -25,7 +25,7 @@ Hier verwenden wir eine von der Community erstellte CI/CD-Komponente für OpenCo --- -### Setup +### Einrichtung 1. Speichern Sie Ihre OpenCode-Authentifizierung JSON als Umgebungsvariablen vom Dateityp CI unter **Einstellungen** > **CI/CD** > **Variablen**. Stellen Sie sicher, dass Sie sie als „Maskiert und ausgeblendet“ markieren. 2. Fügen Sie Folgendes zu Ihrer `.gitlab-ci.yml`-Datei hinzu. @@ -35,7 +35,7 @@ Hier verwenden wir eine von der Community erstellte CI/CD-Komponente für OpenCo - component: $CI_SERVER_FQDN/nagyv/gitlab-opencode/opencode@2 inputs: config_dir: ${CI_PROJECT_DIR}/opencode-config - auth_json: $OPENCODE_AUTH_JSON # The variable name for your OpenCode authentication JSON + auth_json: $OPENCODE_AUTH_JSON # Die variable name für ihre OpenCode authentifizierung JSON command: optional-custom-command message: "Your prompt here" ``` @@ -51,7 +51,7 @@ Erwähnen Sie `@opencode` in einem Kommentar und OpenCode führt Aufgaben innerh --- -### Features +### Funktionen - **Issue Triage**: Bitten Sie OpenCode, ein Problem zu untersuchen und es Ihnen zu erklären. - **Reparieren und implementieren**: Bitten Sie OpenCode, ein Problem zu beheben oder eine Funktion zu implementieren. @@ -60,7 +60,7 @@ Erwähnen Sie `@opencode` in einem Kommentar und OpenCode führt Aufgaben innerh --- -### Setup +### Einrichtung OpenCode wird in Ihrer GitLab CI/CD-Pipeline ausgeführt. Folgendes müssen Sie zum Einrichten benötigen: @@ -77,7 +77,7 @@ Aktuelle Anweisungen finden Sie im [**GitLab docs**](https://docs.gitlab.com/use
- Flow configuration + Flow-Konfiguration ```yaml image: node:22-slim @@ -156,7 +156,7 @@ Ausführliche Anweisungen finden Sie unter [GitLab CLI agents docs](https://docs --- -### Examples +### Beispiele Hier sind einige Beispiele, wie Sie OpenCode in GitLab verwenden können. diff --git a/packages/web/src/content/docs/de/ide.mdx b/packages/web/src/content/docs/de/ide.mdx index 5f1275b73..dcc282395 100644 --- a/packages/web/src/content/docs/de/ide.mdx +++ b/packages/web/src/content/docs/de/ide.mdx @@ -34,7 +34,7 @@ Suchen Sie im Extension Marketplace nach **OpenCode** und klicken Sie auf **Inst --- -### Troubleshooting +### Fehlerbehebung Wenn die Erweiterung nicht automatisch installiert werden kann: diff --git a/packages/web/src/content/docs/de/index.mdx b/packages/web/src/content/docs/de/index.mdx index 1fe23e998..e1337254d 100644 --- a/packages/web/src/content/docs/de/index.mdx +++ b/packages/web/src/content/docs/de/index.mdx @@ -29,7 +29,7 @@ Um OpenCode in Ihrem Terminal verwenden zu können, benötigen Sie: --- -## Installieren +## Installation Der einfachste Weg, OpenCode zu installieren, ist über das Installationsskript. @@ -129,7 +129,7 @@ Sie können die Binärdatei auch aus [Releases](https://github.com/anomalyco/ope --- -## Konfigurieren +## Konfiguration Mit OpenCode können Sie jeden LLM-Anbieter verwenden, indem Sie dessen API-Schlüssel konfigurieren. @@ -157,10 +157,10 @@ Alternativ können Sie auch einen der anderen Anbieter auswählen. [Mehr erfahre --- -## Initialize +## Initialisierung Nachdem Sie nun einen Anbieter konfiguriert haben, können Sie zu einem Projekt navigieren -an dem du arbeiten möchtest. +an dem Sie arbeiten möchten. ```bash cd /path/to/project @@ -185,21 +185,20 @@ Sie sollten die `AGENTS.md`-Datei Ihres Projekts an Git übergeben. ::: Dies hilft OpenCode, die Projektstruktur und die Codierungsmuster zu verstehen -used. +die verwendet werden. --- ## Verwendung -Sie können nun OpenCode verwenden, um an Ihrem Projekt zu arbeiten. Fragen Sie ruhig danach -anything! +Sie können nun OpenCode verwenden, um an Ihrem Projekt zu arbeiten. Fragen Sie ruhig nach +allem! -Wenn Sie mit der Verwendung eines AI-Codierungsagenten noch nicht vertraut sind, finden Sie hier einige Beispiele, die hilfreich sein könnten -help. +Wenn Sie mit der Verwendung eines AI-Codierungsagenten noch nicht vertraut sind, finden Sie hier einige Beispiele, die hilfreich sein könnten. --- -### Stellen Sie Fragen +### Fragen stellen Sie können OpenCode bitten, Ihnen die Codebasis zu erklären. @@ -226,7 +225,7 @@ Sie können OpenCode bitten, Ihrem Projekt neue Funktionen hinzuzufügen. Wir em Wechseln Sie mit der **Tabulatortaste** dorthin. In der unteren rechten Ecke sehen Sie einen Indikator dafür. - ```bash frame="none" title="Switch to Plan mode" + ```bash frame="none" title="In den Plan-Modus wechseln" ``` @@ -242,11 +241,11 @@ Sie können OpenCode bitten, Ihrem Projekt neue Funktionen hinzuzufügen. Wir em mit ihm zu sprechen, als ob Sie mit einem Junior-Entwickler in Ihrem Team sprechen würden. :::tip - Geben Sie OpenCode reichlich Kontext und Beispiele, damit es versteht, was Sie möchten - want. + Geben Sie OpenCode reichlich Kontext und Beispiele, damit es versteht, was Sie + wollen. ::: -2. **Den Plan wiederholen** +2. **Den Plan überarbeiten** Sobald Sie einen Plan erhalten, können Sie ihm Feedback geben oder weitere Details hinzufügen. @@ -279,7 +278,7 @@ Sie können OpenCode bitten, Ihrem Projekt neue Funktionen hinzuzufügen. Wir em --- -### Nehmen Sie Änderungen vor +### Änderungen vornehmen Für einfachere Änderungen können Sie OpenCode bitten, es direkt zu erstellen ohne den Plan vorher überprüfen zu müssen. @@ -290,8 +289,8 @@ handled in the /notes route in @packages/functions/src/notes.ts and implement the same logic in @packages/functions/src/settings.ts ``` -Sie möchten sicherstellen, dass Sie viele Details bereitstellen, damit OpenCode das Richtige tut -changes. +Sie möchten sicherstellen, dass Sie viele Details bereitstellen, damit OpenCode die richtigen +Änderungen vornimmt. --- @@ -310,8 +309,8 @@ mit dem Befehl `/undo`. /undo ``` -OpenCode macht nun die von Ihnen vorgenommenen Änderungen rückgängig und zeigt Ihre ursprüngliche Nachricht an -again. +OpenCode macht nun die von Ihnen vorgenommenen Änderungen rückgängig und zeigt Ihre ursprüngliche Nachricht +wieder an. ```txt frame="none" "@packages/functions/src/api/index.ts" Can you refactor the function in @packages/functions/src/api/index.ts? @@ -349,8 +348,8 @@ Hier ist ein [Beispielgespräch](https://opencode.ai/s/4XP1fce5) mit OpenCode. --- -## Anpassen +## Anpassung Und das ist es! Sie sind jetzt ein Profi im Umgang mit OpenCode. -Um es zu Ihrem eigenen zu machen, empfehlen wir [ein Theme auszuwaehlen](/docs/themes), [Keybinds anzupassen](/docs/keybinds), [Code-Formatter zu konfigurieren](/docs/formatters), [eigene Commands zu erstellen](/docs/commands) oder mit der [OpenCode-Konfiguration](/docs/config) zu experimentieren. +Um es zu Ihrem eigenen zu machen, empfehlen wir [ein Theme auszuwählen](/docs/themes), [Keybinds anzupassen](/docs/keybinds), [Code-Formatter zu konfigurieren](/docs/formatters), [eigene Commands zu erstellen](/docs/commands) oder mit der [OpenCode-Konfiguration](/docs/config) zu experimentieren. diff --git a/packages/web/src/content/docs/de/keybinds.mdx b/packages/web/src/content/docs/de/keybinds.mdx index 0e0a7d9d9..d57580080 100644 --- a/packages/web/src/content/docs/de/keybinds.mdx +++ b/packages/web/src/content/docs/de/keybinds.mdx @@ -130,7 +130,7 @@ Sie können eine Keybind deaktivieren, indem Sie den Schlüssel mit dem Wert „ --- -## Verknüpfungen zur Desktop-Eingabeaufforderung +## Desktop-Prompt-Shortcuts Die Eingabeaufforderungseingabe der OpenCode-Desktop-App unterstützt gängige Readline/Emacs-style-Verknüpfungen zum Bearbeiten von Text. Diese sind integriert und derzeit nicht über `opencode.json` konfigurierbar. @@ -152,11 +152,11 @@ Die Eingabeaufforderungseingabe der OpenCode-Desktop-App unterstützt gängige R --- -## Umschalt+Eingabetaste +## Shift+Enter Einige Terminals senden standardmäßig keine Zusatztasten mit der Eingabetaste. Möglicherweise müssen Sie Ihr Terminal so konfigurieren, dass es `Shift+Enter` als Escape-Sequenz sendet. -### Windows-Terminal +### Windows Terminal Öffnen Sie Ihr `settings.json` unter: diff --git a/packages/web/src/content/docs/de/lsp.mdx b/packages/web/src/content/docs/de/lsp.mdx index e592fe781..60f8316c6 100644 --- a/packages/web/src/content/docs/de/lsp.mdx +++ b/packages/web/src/content/docs/de/lsp.mdx @@ -7,7 +7,7 @@ OpenCode lässt sich in Ihr Language Server Protocol (LSP) integrieren, um die I --- -## Eingebaut +## Integriert OpenCode verfügt über mehrere integrierte LSP-Server für gängige Sprachen: @@ -54,7 +54,7 @@ Sie können LSP-Server-Downloads automatisch deaktivieren, indem Sie die Umgebun --- -## Wie es funktioniert +## Funktionsweise Wenn OpenCode eine Datei öffnet, geschieht Folgendes: @@ -63,7 +63,7 @@ Wenn OpenCode eine Datei öffnet, geschieht Folgendes: --- -## Konfigurieren +## Konfiguration Sie können LSP-Server über den Abschnitt `lsp` in Ihrer OpenCode-Konfiguration anpassen. @@ -178,7 +178,7 @@ Sie können einen benutzerdefinierten LSP-Server hinzufügen, indem Sie den Befe ## Weitere Informationen -### PHP Intelepense +### PHP Intelephense PHP Intelepense bietet Premium-Funktionen über einen Lizenzschlüssel. Sie können einen Lizenzschlüssel bereitstellen, indem Sie (nur) den Schlüssel in eine Textdatei einfügen unter: diff --git a/packages/web/src/content/docs/de/mcp-servers.mdx b/packages/web/src/content/docs/de/mcp-servers.mdx index e84424e6e..d53ae00f7 100644 --- a/packages/web/src/content/docs/de/mcp-servers.mdx +++ b/packages/web/src/content/docs/de/mcp-servers.mdx @@ -9,7 +9,7 @@ Nach dem Hinzufügen stehen MCP-Tools automatisch neben den integrierten Tools f --- -#### Caveats +#### Hinweise Wenn Sie einen MCP-Server verwenden, wird dieser zum Kontext hinzugefügt. Wenn Sie viele Werkzeuge haben, können Sie das schnell zusammenfassen. Wir empfehlen daher, vorsichtig zu sein, welchen MCP-Server Sie verwenden. @@ -21,7 +21,7 @@ Bestimmte MCP-Server, wie der GitHub-Server MCP, neigen dazu, viele Token hinzuz --- -## Enable +## Aktivierung Sie können den MCP-Server in Ihrem [OpenCode Config](https://opencode.ai/docs/config/) unter `mcp` definieren. Fügen Sie jedem MCP einen eindeutigen Namen hinzu. Sie können bei der Eingabe von LLM namentlich auf diesen MCP verweisen. @@ -67,7 +67,7 @@ Ihre lokalen Konfigurationswerte überschreiben die Remote-Standardwerte. Weiter --- -## Local +## Lokal Fügen Sie lokale MCP-Server mit `type` bis `"local"` innerhalb des MCP-Objekts hinzu. @@ -112,7 +112,7 @@ use the mcp_everything tool to add the number 3 and 4 --- -#### Options +#### Optionen Hier finden Sie alle Optionen zum Konfigurieren eines lokalen MCP-Servers. @@ -150,7 +150,7 @@ Der `url` ist der URL des Remote-Servers MCP und mit der Option `headers` könne --- -#### Options +#### Optionen | Option | Geben Sie | ein Erforderlich | Beschreibung | | --------- | --------------- | ---------------- | -------------------------------------------------------------------------------------------- | @@ -173,7 +173,7 @@ OpenCode übernimmt automatisch die OAuth-Authentifizierung für Remote-MCP-Serv --- -### Automatic +### Automatisch Für die meisten OAuth-fähigen MCP-Server ist keine spezielle Konfiguration erforderlich. Konfigurieren Sie einfach den Remote-Server: @@ -193,7 +193,7 @@ Wenn der Server eine Authentifizierung erfordert, werden Sie von OpenCode beim e --- -### Pre-registered +### Vorregistriert Wenn Sie über Client-Anmeldeinformationen vom Serveranbieter MCP verfügen, können Sie diese konfigurieren: @@ -216,7 +216,7 @@ Wenn Sie über Client-Anmeldeinformationen vom Serveranbieter MCP verfügen, kö --- -### Authenticating +### Authentifizieren Sie können die Authentifizierung manuell auslösen oder Anmeldeinformationen verwalten. @@ -289,7 +289,7 @@ Der Befehl `mcp debug` zeigt den aktuellen Authentifizierungsstatus an, testet d --- -## Manage +## Verwaltung Ihre MCPs sind neben integrierten Tools auch als Tools in OpenCode verfügbar. Sie können sie also wie jedes andere Tool über die OpenCode-Konfiguration verwalten. @@ -394,7 +394,7 @@ MCP-Servertools werden mit dem Servernamen als Präfix registriert. Um alle Tool --- -## Examples +## Beispiele Nachfolgend finden Sie Beispiele einiger gängiger MCP-Server. Sie können ein PR einreichen, wenn Sie einen anderen Server dokumentieren möchten. @@ -482,7 +482,7 @@ When you need to search docs, use `context7` tools. --- -### Grep von Vercel +### Grep by Vercel Fügen Sie den Server [Grep by Vercel](https://grep.app) MCP hinzu, um Codefragmente auf GitHub zu durchsuchen. diff --git a/packages/web/src/content/docs/de/models.mdx b/packages/web/src/content/docs/de/models.mdx index c605f451a..075296c48 100644 --- a/packages/web/src/content/docs/de/models.mdx +++ b/packages/web/src/content/docs/de/models.mdx @@ -7,7 +7,7 @@ OpenCode verwendet [AI SDK](https://ai-sdk.dev/) und [Models.dev](https://models --- -## Providers +## Anbieter Die meisten gängigen Anbieter sind standardmäßig vorinstalliert. Wenn Sie die Anmeldeinformationen für einen Anbieter über den Befehl `/connect` hinzugefügt haben, sind diese verfügbar, wenn Sie OpenCode starten. @@ -15,7 +15,7 @@ Erfahren Sie mehr über [providers](/docs/providers). --- -## Wählen Sie ein Modell aus +## Modell auswählen Sobald Sie Ihren Anbieter konfiguriert haben, können Sie das gewünschte Modell auswählen, indem Sie Folgendes eingeben: @@ -46,7 +46,7 @@ Hier sind mehrere Modelle, die gut mit OpenCode funktionieren, in keiner bestimm --- -## Legen Sie einen Standard fest +## Standard festlegen Um eines davon als Standardmodell festzulegen, können Sie den Schlüssel `model` in Ihrem festlegen OpenCode config. @@ -135,15 +135,15 @@ Sie können auch benutzerdefinierte Varianten definieren, die integrierte Varian --- -## Variants +## Varianten Viele Modelle unterstützen mehrere Varianten mit unterschiedlichen Konfigurationen. OpenCode wird mit integrierten Standardvarianten für beliebte Anbieter ausgeliefert. -### Einbauvarianten +### Integrierte Varianten OpenCode wird für viele Anbieter mit Standardvarianten ausgeliefert: -**Anthropisch**: +**Anthropic**: - `high` – Budget für hohes Denken (Standard) - `max` – Maximales Denkbudget @@ -195,7 +195,7 @@ Sie können vorhandene Varianten überschreiben oder eigene hinzufügen: } ``` -### Zyklusvarianten +### Varianten durchwechseln Verwenden Sie die Tastenkombination `variant_cycle`, um schnell zwischen Varianten zu wechseln. [Learn more](/docs/keybinds). diff --git a/packages/web/src/content/docs/de/modes.mdx b/packages/web/src/content/docs/de/modes.mdx index b6620a692..b0d939307 100644 --- a/packages/web/src/content/docs/de/modes.mdx +++ b/packages/web/src/content/docs/de/modes.mdx @@ -17,7 +17,7 @@ Sie können während einer Sitzung zwischen den Modi wechseln oder diese in Ihre --- -## Built-in +## Integriert OpenCode verfügt über zwei integrierte Modi. @@ -42,7 +42,7 @@ Dieser Modus ist nützlich, wenn Sie möchten, dass AI Code analysiert, Änderun --- -## Switching +## Wechseln Sie können während einer Sitzung mit der _Tab_-Taste zwischen den Modi wechseln. Oder Ihre konfigurierte `switch_mode`-Tastenkombination. @@ -50,11 +50,11 @@ Siehe auch: [Formatters](/docs/formatters) für Informationen zur Codeformatieru --- -## Configure +## Konfiguration Sie können die integrierten Modi anpassen oder über die Konfiguration eigene erstellen. Modi können auf zwei Arten konfiguriert werden: -### JSON Konfiguration +### JSON-Konfiguration Konfigurieren Sie Modi in Ihrer `opencode.json`-Konfigurationsdatei: @@ -132,7 +132,7 @@ Verwenden Sie die `model`-Konfiguration, um das Standardmodell für diesen Modus --- -### Temperature +### Temperatur Steuern Sie die Zufälligkeit und Kreativität der Antworten von AI mit der `temperature`-Konfiguration. Niedrigere Werte machen die Antworten fokussierter und deterministischer, während höhere Werte die Kreativität und Variabilität steigern. @@ -196,7 +196,7 @@ sowohl die globale OpenCode-Konfiguration als auch die projektspezifische Konfig --- -### Tools +### Werkzeuge Steuern Sie mit der `tools`-Konfiguration, welche Tools in diesem Modus verfügbar sind. Sie können bestimmte Tools aktivieren oder deaktivieren, indem Sie sie auf `true` oder `false` setzen. @@ -221,7 +221,7 @@ Wenn keine Tools angegeben sind, sind alle Tools standardmäßig aktiviert. --- -#### Verfügbare Werkzeuge +#### Verfügbare Tools Hier sind alle Tools aufgeführt, die über den Konfigurationsmodus gesteuert werden können. diff --git a/packages/web/src/content/docs/de/network.mdx b/packages/web/src/content/docs/de/network.mdx index 5bbd92fbe..34d2e5bd0 100644 --- a/packages/web/src/content/docs/de/network.mdx +++ b/packages/web/src/content/docs/de/network.mdx @@ -9,7 +9,7 @@ OpenCode unterstützt Standard-Proxy-Umgebungsvariablen und benutzerdefinierte Z ## Proxy -OpenCode respects standard proxy environment variables. +OpenCode respektiert Standard-Proxy-Umgebungsvariablen. ```bash # HTTPS proxy (recommended) @@ -30,7 +30,7 @@ Sie können den Port und den Hostnamen des Servers mit [CLI flags](/docs/cli#run --- -### Authenticate +### Authentifizierung Wenn Ihr Proxy eine Basisauthentifizierung erfordert, geben Sie Anmeldeinformationen in URL ein. diff --git a/packages/web/src/content/docs/de/permissions.mdx b/packages/web/src/content/docs/de/permissions.mdx index 9cac6a616..0fb23831a 100644 --- a/packages/web/src/content/docs/de/permissions.mdx +++ b/packages/web/src/content/docs/de/permissions.mdx @@ -9,17 +9,17 @@ Ab `v1.1.1` ist die alte boolesche Konfiguration `tools` veraltet und wurde in ` --- -## Actions +## Aktionen Jede Berechtigungsregel wird zu einem der folgenden aufgelöst: - `"allow"` – ohne Genehmigung ausführen -- `"ask"` — prompt for approval +- `"ask"` — um Genehmigung bitten - `"deny"` – Aktion blockieren --- -## Configuration +## Konfiguration Sie können Berechtigungen global festlegen (mit `*`) und bestimmte Tools überschreiben. @@ -70,7 +70,7 @@ Bei den meisten Berechtigungen können Sie ein Objekt verwenden, um basierend au Regeln werden nach Musterübereinstimmung ausgewertet, wobei die **letzte übereinstimmende Regel gewinnt**. Ein gängiges Muster besteht darin, zuerst die Catch-All-Regel `"*"` und danach spezifischere Regeln zu platzieren. -### Wildcards +### Platzhalter Berechtigungsmuster verwenden einen einfachen Platzhalterabgleich: @@ -127,7 +127,7 @@ Konzentrieren Sie sich in der Liste auf vertrauenswürdige Pfade und fügen Sie ## Verfügbare Berechtigungen -OpenCode permissions are keyed by tool name, plus a couple of safety guards: +OpenCode-Berechtigungen basieren auf Tool-Namen sowie einigen Sicherheitsvorkehrungen: - `read` – eine Datei lesen (entspricht dem Dateipfad) - `edit` – alle Dateiänderungen (umfasst `edit`, `write`, `patch`, `multiedit`) @@ -137,8 +137,8 @@ OpenCode permissions are keyed by tool name, plus a couple of safety guards: - `bash` – Ausführen von Shell-Befehlen (entspricht analysierten Befehlen wie `git status --porcelain`) - `task` – Subagenten starten (entspricht dem Subagententyp) - `skill` – Laden einer Fertigkeit (entspricht dem Fertigkeitsnamen) -- `lsp` — running LSP queries (currently non-granular) -- `todoread`, `todowrite` – reading/updating die Aufgabenliste +- `lsp` – Ausführen von LSP-Abfragen (derzeit nicht granular) +- `todoread`, `todowrite` – lesen/aktualisieren der Aufgabenliste - `webfetch` – Abrufen eines URL (entspricht dem URL) - `websearch`, `codesearch` – web/code Suche (entspricht der Abfrage) - `external_directory` – wird ausgelöst, wenn ein Tool Pfade außerhalb des Projektarbeitsverzeichnisses berührt @@ -146,13 +146,13 @@ OpenCode permissions are keyed by tool name, plus a couple of safety guards: --- -## Defaults +## Standardwerte Wenn Sie nichts angeben, beginnt OpenCode mit zulässigen Standardeinstellungen: - Die meisten Berechtigungen sind standardmäßig auf `"allow"` eingestellt. - `doom_loop` und `external_directory` sind standardmäßig `"ask"`. -- `read` is `"allow"`, but `.env` files are denied by default: +- `read` ist `"allow"`, aber `.env`-Dateien werden standardmäßig verweigert: ```json title="opencode.json" { @@ -173,7 +173,7 @@ Wenn Sie nichts angeben, beginnt OpenCode mit zulässigen Standardeinstellungen: Wenn OpenCode zur Genehmigung auffordert, bietet UI drei Ergebnisse: -- `once` — approve just this request +- `once` – nur diese Anfrage genehmigen - `always` – zukünftige Anfragen genehmigen, die den vorgeschlagenen Mustern entsprechen (für den Rest der aktuellen OpenCode-Sitzung) - `reject` – die Anfrage ablehnen @@ -181,7 +181,7 @@ Der Satz von Mustern, die `always` genehmigen würde, wird vom Tool bereitgestel --- -## Agents +## Agenten Sie können Berechtigungen pro Agent überschreiben. Agentenberechtigungen werden mit der globalen Konfiguration zusammengeführt und Agentenregeln haben Vorrang. [Learn more](/docs/agents#permissions) über Agentenberechtigungen. diff --git a/packages/web/src/content/docs/de/plugins.mdx b/packages/web/src/content/docs/de/plugins.mdx index 00f83c47f..57fcdbba6 100644 --- a/packages/web/src/content/docs/de/plugins.mdx +++ b/packages/web/src/content/docs/de/plugins.mdx @@ -9,7 +9,7 @@ Beispiele finden Sie im von der Community erstellten [plugins](/docs/ecosystem#p --- -## Verwenden Sie ein Plugin +## Plugins verwenden Es gibt zwei Möglichkeiten, Plugins zu laden. @@ -43,7 +43,7 @@ Durchsuchen Sie die verfügbaren Plugins im [ecosystem](/docs/ecosystem#plugins) --- -### Wie Plugins installiert werden +### Plugin-Installation **NPM-Plugins** werden beim Start automatisch mit Bun installiert. Pakete und ihre Abhängigkeiten werden in `~/.cache/opencode/node_modules/` zwischengespeichert. @@ -51,7 +51,7 @@ Durchsuchen Sie die verfügbaren Plugins im [ecosystem](/docs/ecosystem#plugins) --- -### Auftrag laden +### Ladereihenfolge Plugins werden aus allen Quellen geladen und alle Hooks werden nacheinander ausgeführt. Die Ladereihenfolge lautet: @@ -64,14 +64,13 @@ Doppelte npm-Pakete mit demselben Namen und derselben Version werden einmal gela --- -## Erstellen Sie ein Plugin +## Plugins erstellen -A plugin is a **JavaScript/TypeScript module** that exports one or more plugin -Funktionen. Jede Funktion empfängt ein Kontextobjekt und gibt ein Hooks-Objekt zurück. +Ein Plugin ist ein **JavaScript/TypeScript-Modul**, das eine oder mehrere Plugin-Funktionen exportiert. Jede Funktion empfängt ein Kontextobjekt und gibt ein Hooks-Objekt zurück. --- -### Dependencies +### Abhängigkeiten Lokale Plugins und benutzerdefinierte Tools können externe npm-Pakete verwenden. Fügen Sie Ihrem Konfigurationsverzeichnis ein `package.json` mit den benötigten Abhängigkeiten hinzu. @@ -123,7 +122,7 @@ Die Plugin-Funktion erhält: --- -### TypeScript support +### TypeScript-Unterstützung Für TypeScript-Plugins können Sie Typen aus dem Plugin-Paket importieren: @@ -139,7 +138,7 @@ export const MyPlugin: Plugin = async ({ project, client, $, directory, worktree --- -### Events +### Ereignisse Plugins können Ereignisse abonnieren, wie unten im Abschnitt „Beispiele“ gezeigt. Hier finden Sie eine Liste der verschiedenen verfügbaren Veranstaltungen. @@ -156,7 +155,7 @@ Plugins können Ereignisse abonnieren, wie unten im Abschnitt „Beispiele“ ge - `installation.updated` -#### LSP Ereignisse +#### LSP-Ereignisse - `lsp.client.diagnostics` - `lsp.updated` @@ -188,11 +187,11 @@ Plugins können Ereignisse abonnieren, wie unten im Abschnitt „Beispiele“ ge - `session.status` - `session.updated` -#### Todo-Events +#### Todo-Ereignisse - `todo.updated` -#### Shell-Events +#### Shell-Ereignisse - `shell.env` @@ -201,7 +200,7 @@ Plugins können Ereignisse abonnieren, wie unten im Abschnitt „Beispiele“ ge - `tool.execute.after` - `tool.execute.before` -#### TUI Ereignisse +#### TUI-Ereignisse - `tui.prompt.append` - `tui.command.execute` @@ -209,13 +208,13 @@ Plugins können Ereignisse abonnieren, wie unten im Abschnitt „Beispiele“ ge --- -## Examples +## Beispiele Hier sind einige Beispiele für Plugins, mit denen Sie OpenCode erweitern können. --- -### Senden Sie Benachrichtigungen +### Benachrichtigungen senden Senden Sie Benachrichtigungen, wenn bestimmte Ereignisse eintreten: @@ -240,7 +239,7 @@ Wenn Sie die OpenCode-Desktop-App verwenden, kann diese automatisch Systembenach --- -### .env protection +### .env-Schutz Verhindern Sie, dass OpenCode `.env`-Dateien liest: @@ -275,7 +274,7 @@ export const InjectEnvPlugin = async () => { --- -### Benutzerdefinierte Werkzeuge +### Benutzerdefinierte Tools Plugins können OpenCode auch benutzerdefinierte Tools hinzufügen: @@ -310,7 +309,7 @@ Ihre benutzerdefinierten Tools stehen neben den integrierten Tools für OpenCode --- -### Logging +### Protokollierung Verwenden Sie `client.app.log()` anstelle von `console.log` für die strukturierte Protokollierung: @@ -331,7 +330,7 @@ Ebenen: `debug`, `info`, `warn`, `error`. Weitere Informationen finden Sie unter --- -### Verdichtungshaken +### Compaction-Hooks Passen Sie den Kontext an, der beim Komprimieren einer Sitzung einbezogen wird: diff --git a/packages/web/src/content/docs/de/providers.mdx b/packages/web/src/content/docs/de/providers.mdx index 34c0660e2..d72ac5af3 100644 --- a/packages/web/src/content/docs/de/providers.mdx +++ b/packages/web/src/content/docs/de/providers.mdx @@ -15,14 +15,14 @@ Um einen Anbieter hinzuzufügen, müssen Sie: --- -### Credentials +### Anmeldeinformationen Wenn Sie die API-Schlüssel eines Anbieters mit dem Befehl `/connect` hinzufügen, werden diese gespeichert in `~/.local/share/opencode/auth.json`. --- -### Config +### Konfiguration Sie können die Anbieter über den Abschnitt `provider` in Ihrem OpenCode anpassen config. @@ -84,7 +84,7 @@ Es funktioniert wie jeder andere Anbieter in OpenCode und ist völlig optional. --- -## Directory +## Verzeichnis Schauen wir uns einige der Anbieter im Detail an. Wenn Sie einen Anbieter hinzufügen möchten Liste, zögern Sie nicht, ein PR zu öffnen. @@ -684,7 +684,7 @@ um das Token im OpenCode-Authentifizierungsspeicher zu speichern. ##### Selbstgehostetes GitLab -:::note[compliance note] +:::note[Compliance-Hinweis] OpenCode verwendet ein kleines Modell für einige AI-Aufgaben wie das Generieren des Sitzungstitels. Es ist standardmäßig für die Verwendung von gpt-5-nano konfiguriert und wird von Zen gehostet. Zum Sperren von OpenCode Um nur Ihre eigene von GitLab gehostete Instanz zu verwenden, fügen Sie Folgendes zu Ihrer hinzu @@ -748,7 +748,7 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here Weitere Dokumentation auf der [opencode-gitlab-auth](https://www.npmjs.com/package/@gitlab/opencode-gitlab-auth)-Homepage. -##### Configuration +##### Konfiguration Anpassen über `opencode.json`: @@ -1831,7 +1831,7 @@ Sie können jeden OpenAI-kompatiblen Anbieter mit OpenCode verwenden. Die meiste --- -##### Example +##### Beispiel Hier ist ein Beispiel für die Einstellung der Optionen `apiKey`, `headers` und Modell `limit`. @@ -1874,7 +1874,7 @@ Mithilfe der `limit`-Felder kann OpenCode erkennen, wie viel Kontext Sie noch ha --- -## Troubleshooting +## Fehlerbehebung Wenn Sie Probleme beim Konfigurieren eines Anbieters haben, überprüfen Sie Folgendes: diff --git a/packages/web/src/content/docs/de/rules.mdx b/packages/web/src/content/docs/de/rules.mdx index 1bce9ffd3..ef446d09b 100644 --- a/packages/web/src/content/docs/de/rules.mdx +++ b/packages/web/src/content/docs/de/rules.mdx @@ -1,5 +1,5 @@ --- -title: Rules +title: Regeln description: Lege eigene Anweisungen fuer opencode fest. --- @@ -8,7 +8,7 @@ Das ist aehnlich zu den Regeln in Cursor und wird direkt in den LLM-Kontext gela --- -## Initialisieren +## Initialisierung Um eine neue `AGENTS.md` zu erstellen, fuehre in opencode den Befehl `/init` aus. @@ -23,7 +23,7 @@ Wenn bereits eine `AGENTS.md` existiert, versucht opencode sie zu erweitern. --- -## Example +## Beispiel Du kannst die Datei auch manuell anlegen. Hier ist ein Beispiel, was in einer `AGENTS.md` stehen kann. @@ -60,7 +60,7 @@ Hier hinterlegst du projektspezifische Regeln, die dein Team gemeinsam nutzt. opencode kann `AGENTS.md` aus mehreren Orten lesen. Die Orte haben unterschiedliche Zwecke. -### Project +### Projekt Lege eine `AGENTS.md` im Projekt-Root ab, um projektspezifische Regeln zu definieren. Diese gelten nur in diesem Verzeichnis und seinen Unterordnern. @@ -72,7 +72,7 @@ Diese gelten in allen opencode-Sitzungen. Da diese Datei nicht in Git landet und nicht mit dem Team geteilt wird, eignet sie sich fuer persoenliche Regeln. -### Claude Code Compatibility +### Claude Code-Kompatibilität Wenn du von Claude Code kommst, unterstuetzt OpenCode dessen Dateikonventionen als Fallback: @@ -90,7 +90,7 @@ export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills --- -## Precedence +## Rangfolge Beim Start sucht opencode in dieser Reihenfolge nach Regeldateien: diff --git a/packages/web/src/content/docs/de/sdk.mdx b/packages/web/src/content/docs/de/sdk.mdx index 9610cdf2b..21791db05 100644 --- a/packages/web/src/content/docs/de/sdk.mdx +++ b/packages/web/src/content/docs/de/sdk.mdx @@ -13,7 +13,7 @@ Damit kannst du Integrationen bauen und opencode programmatisch steuern. --- -## Install +## Installation Installiere das SDK ueber npm: @@ -80,7 +80,7 @@ const client = createOpencodeClient({ }) ``` -#### Options +#### Optionen | Option | Type | Description | Default | | --------------- | ---------- | -------------------------------- | ----------------------- | @@ -105,7 +105,7 @@ Alle Typen werden aus der OpenAPI-Spezifikation des Servers generiert und sind i --- -## Errors +## Fehler Das SDK kann Fehler werfen, die du abfangen und behandeln kannst: @@ -133,7 +133,7 @@ Das SDK stellt alle Server-APIs ueber einen typsicheren Client bereit. --- -#### Examples +#### Beispiele ```javascript const health = await client.global.health() @@ -151,7 +151,7 @@ console.log(health.data.version) --- -#### Examples +#### Beispiele ```javascript // Write a log entry @@ -178,7 +178,7 @@ const agents = await client.app.agents() --- -#### Examples +#### Beispiele ```javascript // List all projects @@ -198,7 +198,7 @@ const currentProject = await client.project.current() --- -#### Examples +#### Beispiele ```javascript // Get current path information @@ -216,7 +216,7 @@ const pathInfo = await client.path.get() --- -#### Examples +#### Beispiele ```javascript const config = await client.config.get() @@ -252,7 +252,7 @@ const { providers, default: defaults } = await client.config.providers() --- -#### Examples +#### Beispiele ```javascript // Create and manage sessions @@ -301,7 +301,7 @@ await client.session.prompt({ --- -#### Examples +#### Beispiele ```javascript // Search and read files @@ -340,7 +340,7 @@ const content = await client.file.read({ --- -#### Examples +#### Beispiele ```javascript // Control TUI interface @@ -363,7 +363,7 @@ await client.tui.showToast({ --- -#### Examples +#### Beispiele ```javascript await client.auth.set({ @@ -382,7 +382,7 @@ await client.auth.set({ --- -#### Examples +#### Beispiele ```javascript // Listen to real-time events diff --git a/packages/web/src/content/docs/de/server.mdx b/packages/web/src/content/docs/de/server.mdx index a8a3112c6..dd4a565fa 100644 --- a/packages/web/src/content/docs/de/server.mdx +++ b/packages/web/src/content/docs/de/server.mdx @@ -118,7 +118,7 @@ Der opencode-Server stellt folgende APIs bereit. --- -### Instance +### Instanz | Method | Path | Description | Response | | ------ | ------------------- | ---------------------------- | --------- | @@ -126,7 +126,7 @@ Der opencode-Server stellt folgende APIs bereit. --- -### Config +### Konfiguration | Method | Path | Description | Response | | ------- | ------------------- | --------------------------------- | ---------------------------------------------------------------------------------------- | @@ -136,7 +136,7 @@ Der opencode-Server stellt folgende APIs bereit. --- -### Provider +### Anbieter | Method | Path | Description | Response | | ------ | -------------------------------- | ------------------------------------ | ----------------------------------------------------------------------------------- | @@ -147,7 +147,7 @@ Der opencode-Server stellt folgende APIs bereit. --- -### Sessions +### Sitzungen | Method | Path | Description | Notes | | -------- | ---------------------------------------- | ------------------------------------- | ---------------------------------------------------------------------------------- | @@ -172,7 +172,7 @@ Der opencode-Server stellt folgende APIs bereit. --- -### Messages +### Nachrichten | Method | Path | Description | Notes | | ------ | --------------------------------- | --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -185,7 +185,7 @@ Der opencode-Server stellt folgende APIs bereit. --- -### Commands +### Befehle | Method | Path | Description | Response | | ------ | ---------- | ----------------- | --------------------------------------------- | @@ -193,7 +193,7 @@ Der opencode-Server stellt folgende APIs bereit. --- -### Files +### Dateien | Method | Path | Description | Response | | ------ | ------------------------ | ---------------------------------- | ------------------------------------------------------------------------------------------- | @@ -204,17 +204,17 @@ Der opencode-Server stellt folgende APIs bereit. | `GET` | `/file/content?path=

` | Read a file | FileContent | | `GET` | `/file/status` | Get status for tracked files | File[] | -#### `/find/file` query parameters +#### `/find/file` Abfrageparameter -- `query` (required) — search string (fuzzy match) -- `type` (optional) — limit results to `"file"` or `"directory"` -- `directory` (optional) — override the project root for the search -- `limit` (optional) — max results (1–200) -- `dirs` (optional) — legacy flag (`"false"` returns only files) +- `query` (erforderlich) — Suchbegriff (Fuzzy-Suche) +- `type` (optional) — Ergebnisse auf `"file"` oder `"directory"` beschränken +- `directory` (optional) — Projektstammverzeichnis für die Suche überschreiben +- `limit` (optional) — Maximale Ergebnisse (1–200) +- `dirs` (optional) — Legacy-Flag (`"false"` gibt nur Dateien zurück) --- -### Tools (Experimental) +### Werkzeuge (Experimentell) | Method | Path | Description | Response | | ------ | ------------------------------------------- | ---------------------------------------- | -------------------------------------------- | @@ -223,7 +223,7 @@ Der opencode-Server stellt folgende APIs bereit. --- -### LSP, Formatters & MCP +### LSP, Formatierer & MCP | Method | Path | Description | Response | | ------ | ------------ | -------------------------- | -------------------------------------------------------- | @@ -234,7 +234,7 @@ Der opencode-Server stellt folgende APIs bereit. --- -### Agents +### Agenten | Method | Path | Description | Response | | ------ | -------- | ------------------------- | ------------------------------------------- | @@ -268,7 +268,7 @@ Der opencode-Server stellt folgende APIs bereit. --- -### Auth +### Authentifizierung | Method | Path | Description | Response | | ------ | ----------- | --------------------------------------------------------------- | --------- | @@ -284,7 +284,7 @@ Der opencode-Server stellt folgende APIs bereit. --- -### Docs +### Dokumentation | Method | Path | Description | Response | | ------ | ------ | ------------------------- | --------------------------- | diff --git a/packages/web/src/content/docs/de/share.mdx b/packages/web/src/content/docs/de/share.mdx index fe95a2bed..99fad2109 100644 --- a/packages/web/src/content/docs/de/share.mdx +++ b/packages/web/src/content/docs/de/share.mdx @@ -1,5 +1,5 @@ --- -title: Share +title: Teilen description: Teile OpenCode-Unterhaltungen per oeffentlichem Link. --- @@ -12,7 +12,7 @@ Geteilte Unterhaltungen sind fuer alle mit dem Link oeffentlich zugaenglich. --- -## How it works +## Funktionsweise Wenn du eine Unterhaltung teilst, macht OpenCode Folgendes: @@ -22,13 +22,13 @@ Wenn du eine Unterhaltung teilst, macht OpenCode Folgendes: --- -## Sharing +## Teilen OpenCode hat drei Modi, die das Teilen steuern: --- -### Manual (default) +### Manuell (Standard) Standardmaessig nutzt OpenCode den manuellen Modus. Sitzungen werden nicht automatisch geteilt, du kannst sie aber mit `/share` veroeffentlichen: @@ -50,7 +50,7 @@ Um den manuellen Modus explizit in der [Konfiguration](/docs/config) zu setzen: --- -### Auto-share +### Auto-Share Du kannst automatisches Teilen fuer neue Unterhaltungen aktivieren, indem du in der [Konfiguration](/docs/config) `share` auf `"auto"` setzt: @@ -65,7 +65,7 @@ Mit aktiviertem Auto-Share wird jede neue Unterhaltung automatisch geteilt und e --- -### Disabled +### Deaktiviert Du kannst Teilen komplett deaktivieren, indem du in der [Konfiguration](/docs/config) `share` auf `"disabled"` setzt: @@ -92,13 +92,13 @@ Dadurch wird der Share-Link entfernt und die zugehoerigen Daten werden geloescht --- -## Privacy +## Datenschutz Beim Teilen solltest du ein paar Punkte beachten. --- -### Data retention +### Datenaufbewahrung Geteilte Unterhaltungen bleiben veroeffentlicht, bis du sie explizit aufhebst. Das umfasst: @@ -109,7 +109,7 @@ Das umfasst: --- -### Recommendations +### Empfehlungen - Teile nur Unterhaltungen ohne sensible Informationen. - Pruefe Inhalte vor dem Teilen. @@ -119,7 +119,7 @@ Das umfasst: --- -## For enterprises +## Für Unternehmen In Enterprise-Umgebungen kann die Share-Funktion: diff --git a/packages/web/src/content/docs/de/skills.mdx b/packages/web/src/content/docs/de/skills.mdx index ec36837a1..63dbb126b 100644 --- a/packages/web/src/content/docs/de/skills.mdx +++ b/packages/web/src/content/docs/de/skills.mdx @@ -1,5 +1,5 @@ --- -title: "Agent Skills" +title: Agenten-Skills description: "Definiere wiederverwendbares Verhalten ueber SKILL.md" --- @@ -8,7 +8,7 @@ Sie werden bei Bedarf ueber das native `skill`-Tool geladen, wenn ein Agent sie --- -## Place files +## Dateien platzieren Erstelle pro Skill-Namen einen Ordner und lege dort eine `SKILL.md` ab. OpenCode sucht in folgenden Pfaden: @@ -22,7 +22,7 @@ OpenCode sucht in folgenden Pfaden: --- -## Understand discovery +## Discovery verstehen Bei projektlokalen Pfaden laeuft OpenCode vom aktuellen Verzeichnis nach oben bis zum Git-Worktree. Dabei werden passende `skills/*/SKILL.md` in `.opencode/` sowie passende Dateien unter `.claude/skills/*/SKILL.md` und `.agents/skills/*/SKILL.md` geladen. @@ -31,7 +31,7 @@ Globale Definitionen kommen zusaetzlich aus `~/.config/opencode/skills/*/SKILL.m --- -## Write frontmatter +## Frontmatter schreiben Jede `SKILL.md` muss mit YAML-Frontmatter beginnen. Nur diese Felder werden ausgewertet: @@ -46,7 +46,7 @@ Unbekannte Frontmatter-Felder werden ignoriert. --- -## Validate names +## Namen validieren `name` muss: @@ -64,14 +64,14 @@ Entsprechender Regex: --- -## Follow length rules +## Längenregeln beachten `description` muss 1-1024 Zeichen lang sein. Formuliere sie so konkret, dass Agenten den Skill eindeutig auswaehlen koennen. --- -## Use an example +## Beispiel verwenden Erstelle `.opencode/skills/git-release/SKILL.md` zum Beispiel so: @@ -100,7 +100,7 @@ Ask clarifying questions if the target versioning scheme is unclear. --- -## Recognize tool description +## Tool-Beschreibung erkennen OpenCode listet verfuegbare Skills in der Beschreibung des `skill`-Tools. Jeder Eintrag enthaelt Namen und Beschreibung: @@ -122,7 +122,7 @@ skill({ name: "git-release" }) --- -## Configure permissions +## Berechtigungen konfigurieren Steuere in `opencode.json` per Muster, auf welche Skills Agenten zugreifen duerfen: @@ -149,7 +149,7 @@ Muster unterstuetzen Wildcards: `internal-*` passt z. B. auf `internal-docs` ode --- -## Override per agent +## Pro Agent überschreiben Du kannst einzelnen Agenten andere Berechtigungen als die globalen Defaults geben. @@ -181,7 +181,7 @@ permission: --- -## Disable the skill tool +## Skill-Tool deaktivieren Deaktiviere Skills komplett fuer Agenten, die sie nicht nutzen sollen: @@ -212,7 +212,7 @@ Wenn deaktiviert, wird der Abschnitt `` komplett weggelassen. --- -## Troubleshoot loading +## Fehlerbehebung beim Laden Wenn ein Skill nicht auftaucht: diff --git a/packages/web/src/content/docs/de/themes.mdx b/packages/web/src/content/docs/de/themes.mdx index 8681caa76..b97816801 100644 --- a/packages/web/src/content/docs/de/themes.mdx +++ b/packages/web/src/content/docs/de/themes.mdx @@ -81,7 +81,7 @@ Damit lassen sich Themes einfach erstellen und anpassen. --- -### Hierarchy +### Hierarchie Themes are loaded from multiple directories in the following order where later directories override earlier ones: @@ -94,7 +94,7 @@ If multiple directories contain a theme with the same name, the theme from the d --- -### Creating a theme +### Theme erstellen To create a custom theme, create a JSON file in one of the theme directories. @@ -114,7 +114,7 @@ vim .opencode/themes/my-theme.json --- -### JSON format +### JSON-Format Themes use a flexible JSON format with support for: @@ -126,13 +126,13 @@ Themes use a flexible JSON format with support for: --- -### Color definitions +### Farbdefinitionen The `defs` section is optional and it allows you to define reusable colors that can be referenced in the theme. --- -### Terminal defaults +### Terminal-Standardwerte The special value `"none"` can be used for any color to inherit the terminal's default color. This is particularly useful for creating themes that blend seamlessly with your terminal's color scheme: @@ -141,7 +141,7 @@ The special value `"none"` can be used for any color to inherit the terminal's d --- -### Example +### Beispiel Here's an example of a custom theme: diff --git a/packages/web/src/content/docs/de/tools.mdx b/packages/web/src/content/docs/de/tools.mdx index 33ebb72b8..b7a41d87b 100644 --- a/packages/web/src/content/docs/de/tools.mdx +++ b/packages/web/src/content/docs/de/tools.mdx @@ -11,7 +11,7 @@ Das Verhalten steuerst du ueber [Berechtigungen](/docs/permissions). --- -## Configure +## Konfiguration Nutze das Feld `permission`, um Tool-Verhalten zu steuern. Pro Tool kannst du erlauben, verbieten oder eine Rueckfrage verlangen. @@ -43,7 +43,7 @@ Zum Beispiel, um fuer alle Tools eines MCP-Servers eine Freigabe zu verlangen: --- -## Built-in +## Eingebaut Hier sind alle in OpenCode verfuegbaren eingebauten Tools. @@ -351,7 +351,7 @@ Each question includes a header, the question text, and a list of options. Users --- -## Custom tools +## Benutzerdefinierte Tools Mit Custom Tools definierst du eigene Funktionen, die das LLM aufrufen kann. Sie werden in der Konfigurationsdatei definiert und koennen beliebigen Code ausfuehren. @@ -360,7 +360,7 @@ Sie werden in der Konfigurationsdatei definiert und koennen beliebigen Code ausf --- -## MCP servers +## MCP-Server MCP-Server (Model Context Protocol) binden externe Tools und Dienste ein. Dazu gehoeren Datenbanken, API-Integrationen und Drittanbieter-Services. @@ -369,14 +369,14 @@ Dazu gehoeren Datenbanken, API-Integrationen und Drittanbieter-Services. --- -## Internals +## Interna Intern verwenden Tools wie `grep`, `glob` und `list` [ripgrep](https://github.com/BurntSushi/ripgrep). Standardmaessig beachtet ripgrep `.gitignore`, daher werden dort aufgefuehrte Dateien und Ordner nicht durchsucht. --- -### Ignore patterns +### Ignorier-Muster Wenn du normalerweise ignorierte Dateien einschliessen willst, lege im Projekt-Root eine `.ignore`-Datei an. Dort kannst du Pfade explizit erlauben. diff --git a/packages/web/src/content/docs/de/troubleshooting.mdx b/packages/web/src/content/docs/de/troubleshooting.mdx index 3bca3a35d..076200cbd 100644 --- a/packages/web/src/content/docs/de/troubleshooting.mdx +++ b/packages/web/src/content/docs/de/troubleshooting.mdx @@ -1,5 +1,5 @@ --- -title: Troubleshooting +title: Fehlerbehebung description: Haeufige Probleme und schnelle Loesungen. --- @@ -20,7 +20,7 @@ Mit `--log-level` bekommst du detailliertere Diagnoseinfos, z. B. `opencode --lo --- -## Storage +## Speicher opencode speichert Sitzungs- und App-Daten auf der Festplatte unter: @@ -37,12 +37,12 @@ Dieses Verzeichnis enthaelt: --- -## Desktop app +## Desktop-App OpenCode Desktop startet im Hintergrund einen lokalen OpenCode-Server (`opencode-cli`-Sidecar). Viele Probleme kommen von fehlerhaften Plugins, kaputtem Cache oder falschen Server-Einstellungen. -### Quick checks +### Schnellchecks - App komplett beenden und neu starten - Bei Fehlerbildschirm **Restart** klicken und Details kopieren @@ -50,11 +50,11 @@ Viele Probleme kommen von fehlerhaften Plugins, kaputtem Cache oder falschen Ser --- -### Disable plugins +### Plugins deaktivieren If the desktop app is crashing on launch, hanging, or behaving strangely, start by disabling plugins. -#### Check the global config +#### Globale Konfiguration prüfen Open your global config file and look for a `plugin` key. @@ -71,7 +71,7 @@ If you have plugins configured, temporarily disable them by removing the key or } ``` -#### Check plugin directories +#### Plugin-Verzeichnisse prüfen OpenCode can also load local plugins from disk. Temporarily move these out of the way (or rename the folder) and restart the desktop app: @@ -85,7 +85,7 @@ If the app starts working again, re-enable plugins one at a time to find which o --- -### Clear the cache +### Cache leeren If disabling plugins doesn't help (or a plugin install is stuck), clear the cache so OpenCode can rebuild it. @@ -100,21 +100,21 @@ If disabling plugins doesn't help (or a plugin install is stuck), clear the cach --- -### Fix server connection issues +### Server-Verbindungsprobleme beheben OpenCode Desktop can either start its own local server (default) or connect to a server URL you configured. If you see a **"Connection Failed"** dialog (or the app never gets past the splash screen), check for a custom server URL. -#### Clear the desktop default server URL +#### Desktop-Standard-Server-URL löschen From the Home screen, click the server name (with the status dot) to open the Server picker. In the **Default server** section, click **Clear**. -#### Remove `server.port` / `server.hostname` from your config +#### `server.port` / `server.hostname` aus Konfiguration entfernen If your `opencode.json(c)` contains a `server` section, temporarily remove it and restart the desktop app. -#### Check environment variables +#### Umgebungsvariablen prüfen If you have `OPENCODE_PORT` set in your environment, the desktop app will try to use that port for the local server. @@ -122,7 +122,7 @@ If you have `OPENCODE_PORT` set in your environment, the desktop app will try to --- -### Linux: Wayland / X11 issues +### Linux: Wayland / X11-Probleme On Linux, some Wayland setups can cause blank windows or compositor errors. @@ -131,19 +131,19 @@ On Linux, some Wayland setups can cause blank windows or compositor errors. --- -### Windows: WebView2 runtime +### Windows: WebView2-Laufzeit On Windows, OpenCode Desktop requires the Microsoft Edge **WebView2 Runtime**. If the app opens to a blank window or won't start, install/update WebView2 and try again. --- -### Windows: General performance issues +### Windows: Allgemeine Performance-Probleme If you're experiencing slow performance, file access issues, or terminal problems on Windows, try using [WSL (Windows Subsystem for Linux)](/docs/windows-wsl). WSL provides a Linux environment that works more seamlessly with OpenCode's features. --- -### Notifications not showing +### Benachrichtigungen werden nicht angezeigt OpenCode Desktop only shows system notifications when: @@ -152,7 +152,7 @@ OpenCode Desktop only shows system notifications when: --- -### Reset desktop app storage (last resort) +### Desktop-App-Speicher zurücksetzen (letzter Ausweg) If the app won't start and you can't clear settings from inside the UI, reset the desktop app's saved state. @@ -196,7 +196,7 @@ Hier sind typische Fehlerbilder und wie du sie loest. --- -### OpenCode won't start +### OpenCode startet nicht 1. Check the logs for error messages 2. Try running with `--print-logs` to see output in the terminal @@ -204,7 +204,7 @@ Hier sind typische Fehlerbilder und wie du sie loest. --- -### Authentication issues +### Authentifizierungsprobleme 1. Try re-authenticating with the `/connect` command in the TUI 2. Check that your API keys are valid @@ -212,7 +212,7 @@ Hier sind typische Fehlerbilder und wie du sie loest. --- -### Model not available +### Modell nicht verfügbar 1. Check that you've authenticated with the provider 2. Verify the model name in your config is correct @@ -251,7 +251,7 @@ To resolve this: --- -### AI_APICallError and provider package issues +### AI_APICallError und Provider-Paket-Probleme If you encounter API call errors, this may be due to outdated provider packages. opencode dynamically installs provider packages (OpenAI, Anthropic, Google, etc.) as needed and caches them locally. @@ -271,7 +271,7 @@ This will force opencode to download the most recent versions of provider packag --- -### Copy/paste not working on Linux +### Copy/Paste funktioniert nicht unter Linux Linux users need to have one of the following clipboard utilities installed for copy/paste functionality to work: diff --git a/packages/web/src/content/docs/de/tui.mdx b/packages/web/src/content/docs/de/tui.mdx index 7f3c69a50..ebd16fa76 100644 --- a/packages/web/src/content/docs/de/tui.mdx +++ b/packages/web/src/content/docs/de/tui.mdx @@ -44,7 +44,7 @@ Der Dateiinhalt wird automatisch zur Unterhaltung hinzugefuegt. --- -## Bash commands +## Bash-Befehle Beginne eine Nachricht mit `!`, um einen Shell-Befehl auszufuehren. @@ -56,7 +56,7 @@ Die Ausgabe landet als Tool-Ergebnis in der Unterhaltung. --- -## Commands +## Befehle In der OpenCode-TUI kannst du `/` plus Befehlsnamen eingeben, um Aktionen schnell auszufuehren. Zum Beispiel: @@ -288,7 +288,7 @@ Unshare current session. [Learn more](/docs/share#un-sharing). --- -## Editor setup +## Editor-Einrichtung Both the `/editor` and `/export` commands use the editor specified in your `EDITOR` environment variable. @@ -356,7 +356,7 @@ Some editors need command-line arguments to run in blocking mode. The `--wait` f --- -## Configure +## Konfiguration You can customize TUI behavior through your OpenCode config file. @@ -372,20 +372,20 @@ You can customize TUI behavior through your OpenCode config file. } ``` -### Options +### Optionen - `scroll_acceleration` - Enable macOS-style scroll acceleration for smooth, natural scrolling. When enabled, scroll speed increases with rapid scrolling gestures and stays precise for slower movements. **This setting takes precedence over `scroll_speed` and overrides it when enabled.** - `scroll_speed` - Controls how fast the TUI scrolls when using scroll commands (minimum: `1`). Defaults to `3`. **Note: This is ignored if `scroll_acceleration.enabled` is set to `true`.** --- -## Customization +## Anpassung You can customize various aspects of the TUI view using the command palette (`ctrl+x h` or `/help`). These settings persist across restarts. --- -#### Username display +#### Benutzername-Anzeige Toggle whether your username appears in chat messages. Access this through: diff --git a/packages/web/src/content/docs/de/windows-wsl.mdx b/packages/web/src/content/docs/de/windows-wsl.mdx index 3194e004c..29c4d1f73 100644 --- a/packages/web/src/content/docs/de/windows-wsl.mdx +++ b/packages/web/src/content/docs/de/windows-wsl.mdx @@ -14,7 +14,7 @@ WSL bietet bessere Dateisystem-Performance, vollstaendige Terminal-Unterstuetzun --- -## Setup +## Einrichtung @@ -43,7 +43,7 @@ WSL bietet bessere Dateisystem-Performance, vollstaendige Terminal-Unterstuetzun --- -## Desktop App + WSL Server +## Desktop-App + WSL-Server Wenn du die OpenCode-Desktop-App nutzen willst, den Server aber in WSL betreiben moechtest: @@ -70,7 +70,7 @@ OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0 --- -## Web Client + WSL +## Web-Client + WSL Fuer die beste Web-Erfahrung unter Windows: diff --git a/packages/web/src/content/docs/de/zen.mdx b/packages/web/src/content/docs/de/zen.mdx index a12239ecf..f52ed5f36 100644 --- a/packages/web/src/content/docs/de/zen.mdx +++ b/packages/web/src/content/docs/de/zen.mdx @@ -18,7 +18,7 @@ Du meldest dich bei OpenCode Zen an, holst dir deinen API-Key und nutzt ihn opti --- -## Background +## Hintergrund Es gibt sehr viele Modelle, aber nur ein Teil davon eignet sich wirklich gut als Coding-Agent. Ausserdem konfigurieren Provider Modelle sehr unterschiedlich, was die Qualitaet stark beeinflusst. @@ -39,7 +39,7 @@ OpenCode Zen ist ein AI-Gateway, das dir Zugriff auf genau diese Modelle gibt. --- -## How it works +## Funktionsweise OpenCode Zen funktioniert wie jeder andere Provider in OpenCode. @@ -51,7 +51,7 @@ Abgerechnet wird pro Anfrage, Guthaben kannst du jederzeit aufladen. --- -## Endpoints +## Endpunkte Du kannst unsere Modelle auch ueber die folgenden API-Endpunkte aufrufen. @@ -102,7 +102,7 @@ https://opencode.ai/zen/v1/models --- -## Pricing +## Preisgestaltung Wir nutzen ein Pay-as-you-go-Modell. Unten siehst du die Preise **pro 1 Mio. Tokens**. @@ -169,7 +169,7 @@ Du kannst den Betrag anpassen oder Auto-Reload komplett deaktivieren. --- -### Monthly limits +### Monatslimits Du kannst monatliche Limits fuer den gesamten Workspace und pro Teammitglied festlegen. @@ -178,7 +178,7 @@ Mit aktiviertem Auto-Reload kann die Abrechnung dennoch darueber liegen, falls d --- -## Privacy +## Datenschutz Alle Modelle werden in den USA gehostet. Unsere Provider arbeiten grundsaetzlich mit Zero-Retention und nutzen deine Daten nicht zum Training, mit folgenden Ausnahmen: @@ -192,7 +192,7 @@ Unsere Provider arbeiten grundsaetzlich mit Zero-Retention und nutzen deine Date --- -## For Teams +## Für Teams Zen eignet sich auch gut fuer Teams. Du kannst Mitglieder einladen, Rollen vergeben und den Modellzugriff fuer dein Team steuern. @@ -206,7 +206,7 @@ Details zur spaeteren Preisgestaltung folgen. --- -### Roles +### Rollen Du kannst Teammitglieder einladen und Rollen vergeben: @@ -217,7 +217,7 @@ Admins koennen zusaetzlich monatliche Ausgabenlimits pro Mitglied setzen. --- -### Model access +### Modellzugriff Admins koennen einzelne Modelle fuer den Workspace aktivieren oder deaktivieren. Anfragen an deaktivierte Modelle liefern einen Fehler. @@ -226,7 +226,7 @@ Das ist hilfreich, wenn bestimmte datenverarbeitende Modelle ausgeschlossen werd --- -### Bring your own key +### Eigenen Key mitbringen Du kannst eigene OpenAI- oder Anthropic-API-Keys verwenden und trotzdem andere Zen-Modelle nutzen. @@ -237,7 +237,7 @@ and you want to use that instead of the one that Zen provides. --- -## Goals +## Ziele Wir haben OpenCode Zen entwickelt, um: diff --git a/packages/web/src/content/docs/es/acp.mdx b/packages/web/src/content/docs/es/acp.mdx index d5f31b555..6cc14669a 100644 --- a/packages/web/src/content/docs/es/acp.mdx +++ b/packages/web/src/content/docs/es/acp.mdx @@ -13,7 +13,7 @@ ACP es un protocolo abierto que estandariza la comunicación entre editores de c --- -## Configurar +## Configuración Para usar OpenCode a través de ACP, configure su editor para ejecutar el comando `opencode acp`. @@ -140,7 +140,7 @@ Esta configuración configura CodeCompanion para usar OpenCode como agente ACP p Si necesita pasar variables de entorno (como `OPENCODE_API_KEY`), consulte [Configuración de adaptadores: variables de entorno](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) en la documentación de CodeCompanion.nvim para obtener detalles completos. -## Apoyo +## Soporte OpenCode funciona igual a través de ACP que en la terminal. Todas las funciones son compatibles: diff --git a/packages/web/src/content/docs/es/agents.mdx b/packages/web/src/content/docs/es/agents.mdx index cec6514a0..0b2736ac3 100644 --- a/packages/web/src/content/docs/es/agents.mdx +++ b/packages/web/src/content/docs/es/agents.mdx @@ -40,13 +40,13 @@ OpenCode viene con dos subagentes integrados, **General** y **Explore**. Veremos --- -## Built-in +## Integrados OpenCode viene con dos agentes primarios integrados y dos subagentes integrados. --- -### Use build +### Build _Modo_: `primary` @@ -54,7 +54,7 @@ Build es el agente principal **predeterminado** con todas las herramientas habil --- -### Use plan +### Plan _Modo_: `primary` @@ -68,7 +68,7 @@ Este agente es útil cuando desea que LLM analice código, sugiera cambios o cre --- -### Use general +### General _Modo_: `subagent` @@ -76,7 +76,7 @@ Un agente de uso general para investigar preguntas complejas y ejecutar tareas d --- -### Use explore +### Explore _Modo_: `subagent` @@ -84,7 +84,7 @@ Un agente rápido y de solo lectura para explorar bases de código. No se pueden --- -### Use compaction +### Compactación _Modo_: `primary` @@ -92,7 +92,7 @@ Agente de sistema oculto que compacta un contexto largo en un resumen más peque --- -### Use title +### Título _Modo_: `primary` @@ -100,7 +100,7 @@ Agente del sistema oculto que genera títulos de sesión cortos. Se ejecuta auto --- -### Use summary +### Resumen _Modo_: `primary` @@ -128,7 +128,7 @@ Agente del sistema oculto que crea resúmenes de sesiones. Se ejecuta automátic --- -## Configurar +## Configuración Puede personalizar los agentes integrados o crear los suyos propios mediante la configuración. Los agentes se pueden configurar de dos maneras: @@ -216,7 +216,7 @@ Veamos estas opciones de configuración en detalle. --- -### Description +### Descripción Utilice la opción `description` para proporcionar una breve descripción de lo que hace el agente y cuándo usarlo. @@ -234,7 +234,7 @@ Esta es una opción de configuración **obligatoria**. --- -### Temperature +### Temperatura Controle la aleatoriedad y la creatividad de las respuestas de LLM con la configuración `temperature`. @@ -281,7 +281,7 @@ Si no se especifica ninguna temperatura, OpenCode utiliza valores predeterminado --- -### Max steps +### Pasos máximos Controle la cantidad máxima de iteraciones agentes que un agente puede realizar antes de verse obligado a responder solo con texto. Esto permite a los usuarios que desean controlar los costos establecer un límite a las acciones de agencia. @@ -307,7 +307,7 @@ El campo heredado `maxSteps` está en desuso. Utilice `steps` en su lugar. --- -### Disable +### Deshabilitar Establezca en `true` para deshabilitar el agente. @@ -323,7 +323,7 @@ Establezca en `true` para deshabilitar el agente. --- -### Prompt +### Indicación Especifique un archivo de aviso del sistema personalizado para este agente con la configuración `prompt`. El archivo de aviso debe contener instrucciones específicas para el propósito del agente. @@ -341,7 +341,7 @@ Esta ruta es relativa a donde se encuentra el archivo de configuración. Entonce --- -### Model +### Modelo Utilice la configuración `model` para anular el modelo de este agente. Útil para utilizar diferentes modelos optimizados para diferentes tareas. Por ejemplo, un modelo más rápido de planificación, un modelo más capaz de implementación. @@ -363,7 +363,7 @@ El ID del modelo en su configuración OpenCode usa el formato `provider/model-id --- -### Tools +### Herramientas Controle qué herramientas están disponibles en este agente con la configuración `tools`. Puede habilitar o deshabilitar herramientas específicas configurándolas en `true` o `false`. @@ -410,7 +410,7 @@ También puedes utilizar comodines para controlar varias herramientas a la vez. --- -### Permissions +### Permisos Puede configurar permisos para administrar qué acciones puede realizar un agente. Actualmente, los permisos para las herramientas `edit`, `bash` y `webfetch` se pueden configurar para: @@ -522,7 +522,7 @@ Dado que la última regla de coincidencia tiene prioridad, coloque el comodín ` --- -### Mode +### Modo Controle el modo del agente con la configuración `mode`. La opción `mode` se utiliza para determinar cómo se puede utilizar el agente. @@ -540,7 +540,7 @@ La opción `mode` se puede configurar en `primary`, `subagent` o `all`. Si no se --- -### Hidden +### Oculto Oculte un subagente del menú de autocompletar `@` con `hidden: true`. Útil para subagentes internos que solo deben ser invocados mediante programación por otros agentes a través de la herramienta Tarea. @@ -563,7 +563,7 @@ Sólo aplica para agentes `mode: subagent`. --- -### Task permissions +### Permisos de tarea Controle qué subagentes puede invocar un agente a través de la herramienta Tarea con `permission.task`. Utiliza patrones globales para una combinación flexible. @@ -635,7 +635,7 @@ Los valores oscilan entre 0,0 y 1,0. Los valores más bajos están más enfocado --- -### Additional +### Adicional Cualquier otra opción que especifique en la configuración de su agente se **pasará directamente** al proveedor como opciones de modelo. Esto le permite utilizar funciones y parámetros específicos del proveedor. @@ -662,7 +662,7 @@ Ejecute `opencode models` para ver una lista de los modelos disponibles. --- -## Create agents +## Crear agentes Puede crear nuevos agentes usando el siguiente comando: @@ -684,11 +684,11 @@ Este comando interactivo: A continuación se muestran algunos casos de uso comunes para diferentes agentes. -- **Build agent**: trabajo de desarrollo completo con todas las herramientas habilitadas -- **Plan agent**: Análisis y planificación sin realizar cambios -- **Review agent**: revisión de código con acceso de solo lectura más herramientas de documentación -- **Debug agent**: centrado en la investigación con bash y herramientas de lectura habilitadas -- **Docs agent**: escritura de documentación con operaciones de archivos pero sin comandos del sistema. +- **Agente Build**: trabajo de desarrollo completo con todas las herramientas habilitadas +- **Agente Plan**: Análisis y planificación sin realizar cambios +- **Agente Review**: revisión de código con acceso de solo lectura más herramientas de documentación +- **Agente Debug**: centrado en la investigación con bash y herramientas de lectura habilitadas +- **Agente Docs**: escritura de documentación con operaciones de archivos pero sin comandos del sistema. --- @@ -702,7 +702,7 @@ A continuación se muestran algunos agentes de ejemplo que pueden resultarle út --- -### Documentation agent +### Agente de documentación ```markdown title="~/.config/opencode/agents/docs-writer.md" --- @@ -724,7 +724,7 @@ Focus on: --- -### Security auditor +### Auditor de seguridad ```markdown title="~/.config/opencode/agents/security-auditor.md" --- diff --git a/packages/web/src/content/docs/es/cli.mdx b/packages/web/src/content/docs/es/cli.mdx index f4c5c889f..705da0de4 100644 --- a/packages/web/src/content/docs/es/cli.mdx +++ b/packages/web/src/content/docs/es/cli.mdx @@ -1,11 +1,11 @@ --- title: CLI -description: OpenCode CLI opciones y comandos. +description: Opciones y comandos de la CLI de OpenCode. --- import { Tabs, TabItem } from "@astrojs/starlight/components" -El OpenCode CLI de forma predeterminada inicia el [TUI](/docs/tui) cuando se ejecuta sin ningún argumento. +La CLI de OpenCode de forma predeterminada inicia el [TUI](/docs/tui) cuando se ejecuta sin ningún argumento. ```bash opencode @@ -27,9 +27,9 @@ Inicie la interfaz de usuario del terminal OpenCode. opencode [project] ``` -#### Flags +#### Opciones -| Flag | Short | Description | +| Opción | Corta | Descripción | | ------------ | ----- | --------------------------------------------------------------------- | | `--continue` | `-c` | Continuar la última sesión | | `--session` | `-s` | ID de sesión para continuar | @@ -44,7 +44,7 @@ opencode [project] ## Comandos -El OpenCode CLI también tiene los siguientes comandos. +La CLI de OpenCode también tiene los siguientes comandos. --- @@ -76,9 +76,9 @@ opencode web --port 4096 --hostname 0.0.0.0 opencode attach http://10.20.30.40:4096 ``` -#### Flags +#### Opciones -| Flag | Short | Description | +| Opción | Corta | Descripción | | ----------- | ----- | ----------------------------------------- | | `--dir` | | Directorio de trabajo para iniciar TUI en | | `--session` | `-s` | ID de sesión para continuar | @@ -185,9 +185,9 @@ Ejecute el agente GitHub. Esto se usa normalmente en acciones GitHub. opencode github run ``` -##### Flags +##### Opciones -| Flag | Description | +| Opción | Descripción | | --------- | ---------------------------------------------- | | `--event` | GitHub evento simulado para ejecutar el agente | | `--token` | GitHub token de acceso personal | @@ -294,9 +294,9 @@ Opcionalmente, puede pasar un ID de proveedor para filtrar modelos por ese prove opencode models anthropic ``` -#### Flags +#### Opciones -| Flag | Description | +| Opción | Descripción | | ----------- | --------------------------------------------------------------------------- | | `--refresh` | Actualizar la caché de modelos desde models.dev | | `--verbose` | Utilice una salida del modelo más detallada (incluye metadatos como costos) | @@ -333,9 +333,9 @@ opencode serve opencode run --attach http://localhost:4096 "Explain async/await in JavaScript" ``` -#### Flags +#### Opciones -| Flag | Short | Description | +| Opción | Corta | Descripción | | ------------ | ----- | ----------------------------------------------------------------------------------- | | `--command` | | El comando a ejecutar, use mensaje para args | | `--continue` | `-c` | Continuar la última sesión | @@ -362,9 +362,9 @@ opencode serve Esto inicia un servidor HTTP que proporciona acceso API a la funcionalidad opencode sin la interfaz TUI. Configure `OPENCODE_SERVER_PASSWORD` para habilitar la autenticación básica HTTP (el nombre de usuario predeterminado es `opencode`). -#### Banderas +#### Opciones -| Bandera | Descripción | +| Opción | Descripción | | ------------ | ---------------------------------------------------- | | `--port` | Puerto para escuchar | | `--hostname` | Nombre de host para escuchar | @@ -391,9 +391,9 @@ Enumere todas las sesiones OpenCode. opencode session list ``` -##### Flags +##### Opciones -| Flag | Short | Description | +| Opción | Corta | Descripción | | ------------- | ----- | --------------------------------------- | | `--max-count` | `-n` | Limitar a N sesiones más recientes | | `--format` | | Formato de salida: tabla o json (tabla) | @@ -408,9 +408,9 @@ Muestre el uso de tokens y las estadísticas de costos para sus sesiones OpenCod opencode stats ``` -#### Flags +#### Opciones -| Flag | Description | +| Opción | Descripción | | ----------- | ------------------------------------------------------------------------------------------------------------------------ | | `--days` | Mostrar estadísticas de los últimos N días (todo el tiempo) | | `--tools` | Número de herramientas para mostrar (todas) | @@ -458,9 +458,9 @@ opencode web Esto inicia un servidor HTTP y abre un navegador web para acceder a OpenCode a través de una interfaz web. Configure `OPENCODE_SERVER_PASSWORD` para habilitar la autenticación básica HTTP (el nombre de usuario predeterminado es `opencode`). -#### Banderas +#### Opciones -| Bandera | Descripción | +| Opción | Descripción | | ------------ | ---------------------------------------------------- | | `--port` | Puerto para escuchar | | `--hostname` | Nombre de host para escuchar | @@ -479,9 +479,9 @@ opencode acp Este comando inicia un servidor ACP que se comunica a través de stdin/stdout usando nd-JSON. -#### Flags +#### Opciones -| Flag | Description | +| Opción | Descripción | | ------------ | ---------------------------- | | `--cwd` | Directorio de trabajo | | `--port` | Puerto para escuchar | @@ -497,9 +497,9 @@ Desinstale OpenCode y elimine todos los archivos relacionados. opencode uninstall ``` -#### Flags +#### Opciones -| Flag | Short | Description | +| Opción | Corta | Descripción | | --------------- | ----- | ----------------------------------------- | | `--keep-config` | `-c` | Mantener archivos de configuración | | `--keep-data` | `-d` | Conservar datos de sesión e instantáneas | @@ -528,19 +528,19 @@ Para actualizar a una versión específica. opencode upgrade v0.1.48 ``` -#### Banderas +#### Opciones -| Bandera | Corto | Descripción | +| Opción | Corta | Descripción | | ---------- | ----- | ------------------------------------------------------------------- | | `--method` | `-m` | El método de instalación que se utilizó; curl, npm, pnpm, bun, brew | --- -## Global Flags +## Opciones globales -El opencode CLI toma las siguientes banderas globales. +La CLI de OpenCode toma las siguientes banderas globales. -| Bandera | Corto | Descripción | +| Opción | Corta | Descripción | | -------------- | ----- | -------------------------------------------- | | `--help` | `-h` | Mostrar ayuda | | `--version` | `-v` | Número de versión de impresión | diff --git a/packages/web/src/content/docs/es/commands.mdx b/packages/web/src/content/docs/es/commands.mdx index 0abfa3904..68b9da1cf 100644 --- a/packages/web/src/content/docs/es/commands.mdx +++ b/packages/web/src/content/docs/es/commands.mdx @@ -40,7 +40,7 @@ Utilice el comando escribiendo `/` seguido del nombre del comando. --- -## Configurar +## Configuración Puede agregar comandos personalizados a través de la configuración OpenCode o creando archivos de Markdown en el directorio `commands/`. @@ -102,7 +102,7 @@ que lo ejecutes: --- -## Configuración rápida +## Configuración de indicaciones Las indicaciones para los comandos personalizados admiten varios marcadores de posición y sintaxis especiales. @@ -312,7 +312,7 @@ Esta es una opción de configuración **opcional**. --- -## Incorporado +## Integrados opencode incluye varios comandos integrados como `/init`, `/undo`, `/redo`, `/share`, `/help`; [más información](/docs/tui#commands). diff --git a/packages/web/src/content/docs/es/config.mdx b/packages/web/src/content/docs/es/config.mdx index 515962efe..c6142e699 100644 --- a/packages/web/src/content/docs/es/config.mdx +++ b/packages/web/src/content/docs/es/config.mdx @@ -1,5 +1,5 @@ --- -title: configuración +title: Configuración description: Usando la configuración OpenCode JSON. --- @@ -357,7 +357,7 @@ Esta configuración se aplica en todas las interfaces: TUI, CLI (`opencode run`) --- -### Intercambio +### Compartir Puede configurar la función [compartir](/docs/share) a través de la opción `share`. @@ -404,7 +404,7 @@ También puede definir comandos utilizando archivos de Markdown en `~/.config/op --- -### combinaciones de teclas +### Atajos de teclado Puede personalizar sus combinaciones de teclas a través de la opción `keybinds`. @@ -500,7 +500,7 @@ Puede controlar el comportamiento de compactación del contexto a través de la --- -### Vigilante +### Observador Puede configurar patrones de ignorancia del observador de archivos a través de la opción `watcher`. @@ -517,7 +517,7 @@ Los patrones siguen la sintaxis global. Utilice esto para excluir directorios ru --- -### MCP servidores +### Servidores MCP Puede configurar los servidores MCP que desee utilizar a través de la opción `mcp`. @@ -626,13 +626,13 @@ Las opciones experimentales no son estables. Pueden cambiar o eliminarse sin pre --- -##Variables +## Variables Puede utilizar la sustitución de variables en sus archivos de configuración para hacer referencia a variables de entorno y contenidos de archivos. --- -### Variables ambientales +### Variables de entorno Utilice `{env:VARIABLE_NAME}` para sustituir variables de entorno: diff --git a/packages/web/src/content/docs/es/custom-tools.mdx b/packages/web/src/content/docs/es/custom-tools.mdx index 9d173987b..76188e184 100644 --- a/packages/web/src/content/docs/es/custom-tools.mdx +++ b/packages/web/src/content/docs/es/custom-tools.mdx @@ -7,7 +7,7 @@ Las herramientas personalizadas son funciones que usted crea y que el LLM puede --- -## Creando una herramienta +## Crear una herramienta Las herramientas se definen como archivos **TypeScript** o **JavaScript**. Sin embargo, la definición de la herramienta puede invocar secuencias de comandos escritas en **cualquier idioma**: TypeScript o JavaScript solo se utilizan para la definición de la herramienta en sí. diff --git a/packages/web/src/content/docs/es/enterprise.mdx b/packages/web/src/content/docs/es/enterprise.mdx index 4516b637d..787ff095a 100644 --- a/packages/web/src/content/docs/es/enterprise.mdx +++ b/packages/web/src/content/docs/es/enterprise.mdx @@ -19,7 +19,7 @@ Para comenzar con OpenCode Enterprise: --- -## Ensayo +## Prueba OpenCode es de código abierto y no almacena ningún código ni datos de contexto, por lo que sus desarrolladores pueden simplemente [comenzar](/docs/) y realizar una prueba. diff --git a/packages/web/src/content/docs/es/formatters.mdx b/packages/web/src/content/docs/es/formatters.mdx index 9e83174f0..f09ef9252 100644 --- a/packages/web/src/content/docs/es/formatters.mdx +++ b/packages/web/src/content/docs/es/formatters.mdx @@ -7,34 +7,34 @@ OpenCode formatea automáticamente los archivos después de escribirlos o editar --- -## Incorporado +## Integrados OpenCode viene con varios formateadores integrados para lenguajes y marcos populares. A continuación se muestra una lista de los formateadores, las extensiones de archivo compatibles y los comandos u opciones de configuración que necesita. | Formateador | Extensiones | Requisitos | | -------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | -| gobierno | .ir | Comando `gofmt` disponible | -| mezclar | .ex, .exs, .eex, .heex, .leex, .neex, .sface | Comando `mix` disponible | -| más bonita | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml y [más](https://prettier.io/docs/en/index.html) | dependencia `prettier` en `package.json` | -| bioma | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml y [más](https://biomejs.dev/) | `biome.json(c)` archivo de configuración | -| zigzag | .zig, .zon | Comando `zig` disponible | -| formato clang | .c, .cpp, .h, .hpp, .ino y [más](https://clang.llvm.org/docs/ClangFormat.html) | `.clang-format` archivo de configuración | -| klint | .kt, .kts | Comando `ktlint` disponible | -| gorguera | .py, .pyi | Comando `ruff` disponible con configuración | -| óxido | .rs | Comando `rustfmt` disponible | -| cargafmt | .rs | Comando `cargo fmt` disponible | -| ultravioleta | .py, .pyi | Comando `uv` disponible | +| gofmt | .go | Comando `gofmt` disponible | +| mix | .ex, .exs, .eex, .heex, .leex, .neex, .sface | Comando `mix` disponible | +| prettier | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml y [más](https://prettier.io/docs/en/index.html) | dependencia `prettier` en `package.json` | +| biome | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml y [más](https://biomejs.dev/) | `biome.json(c)` archivo de configuración | +| zig | .zig, .zon | Comando `zig` disponible | +| clang-format | .c, .cpp, .h, .hpp, .ino y [más](https://clang.llvm.org/docs/ClangFormat.html) | `.clang-format` archivo de configuración | +| ktlint | .kt, .kts | Comando `ktlint` disponible | +| ruff | .py, .pyi | Comando `ruff` disponible con configuración | +| rustfmt | .rs | Comando `rustfmt` disponible | +| cargo fmt | .rs | Comando `cargo fmt` disponible | +| uv | .py, .pyi | Comando `uv` disponible | | rubocop | .rb, .rake, .gemspec, .ru | Comando `rubocop` disponible | -| estándarrb | .rb, .rake, .gemspec, .ru | Comando `standardrb` disponible | -| embellecedor html | .erb, .html.erb | Comando `htmlbeautifier` disponible | -| aire | .R | Comando `air` disponible | -| dardo | .dardo | Comando `dart` disponible | -| formato ocaml | .ml, .mli | Comando `ocamlformat` disponible y archivo de configuración `.ocamlformat` | -| terraformar | .tf, .tfvars | Comando `terraform` disponible | -| brillo | .brillo | Comando `gleam` disponible | +| standardrb | .rb, .rake, .gemspec, .ru | Comando `standardrb` disponible | +| htmlbeautifier | .erb, .html.erb | Comando `htmlbeautifier` disponible | +| air | .R | Comando `air` disponible | +| dart | .dart | Comando `dart` disponible | +| ocamlformat | .ml, .mli | Comando `ocamlformat` disponible y archivo de configuración `.ocamlformat` | +| terraform | .tf, .tfvars | Comando `terraform` disponible | +| gleam | .gleam | Comando `gleam` disponible | | nixfmt | .nix | Comando `nixfmt` disponible | | shfmt | .sh, .bash | Comando `shfmt` disponible | -| pinta | .php | dependencia `laravel/pint` en `composer.json` | +| pint | .php | dependencia `laravel/pint` en `composer.json` | | oxfmt (Experimental) | .js, .jsx, .ts, .tsx | Dependencia de `oxfmt` en `package.json` y un [indicador de variable de entorno experimental](/docs/cli/#experimental) | | ormolu | .hs | Comando `ormolu` disponible | @@ -44,7 +44,7 @@ Entonces, si su proyecto tiene `prettier` en su `package.json`, OpenCode lo usar ## Cómo funciona -Cuando OpenCode escribe o edita un archivo,: +Cuando OpenCode escribe o edita un archivo: 1. Comprueba la extensión del archivo con todos los formateadores habilitados. 2. Ejecuta el comando de formateo apropiado en el archivo. @@ -54,7 +54,7 @@ Este proceso ocurre en segundo plano, lo que garantiza que los estilos de su có --- -## Configurar +## Configuración Puede personalizar los formateadores a través de la sección `formatter` en su configuración OpenCode. diff --git a/packages/web/src/content/docs/es/github.mdx b/packages/web/src/content/docs/es/github.mdx index b1b974ec2..57375a8d7 100644 --- a/packages/web/src/content/docs/es/github.mdx +++ b/packages/web/src/content/docs/es/github.mdx @@ -9,7 +9,7 @@ OpenCode se integra con su flujo de trabajo GitHub. Mencione `/opencode` o `/oc` ## Características -- **Problemas de clasificación**: Pídele a OpenCode que investigue un problema y te lo explique. +- **Clasificación de problemas**: Pídele a OpenCode que investigue un problema y te lo explique. - **Reparar e implementar**: pídale a OpenCode que solucione un problema o implemente una función. Y funcionará en una nueva sucursal y enviará un PR con todos los cambios. - **Seguro**: OpenCode se ejecuta dentro de los corredores de tu GitHub. @@ -250,7 +250,7 @@ Para eventos `issues`, la entrada `prompt` es **obligatoria** ya que no hay ning --- -## Avisos personalizados +## Indicaciones personalizadas Anule el mensaje predeterminado para personalizar el comportamiento de OpenCode para su flujo de trabajo. diff --git a/packages/web/src/content/docs/es/gitlab.mdx b/packages/web/src/content/docs/es/gitlab.mdx index 337f702fd..a8e4baa90 100644 --- a/packages/web/src/content/docs/es/gitlab.mdx +++ b/packages/web/src/content/docs/es/gitlab.mdx @@ -44,7 +44,7 @@ Para obtener más entradas y casos de uso, [consulte los documentos](https://git --- -## GitLab Dúo +## GitLab Duo OpenCode se integra con su flujo de trabajo GitLab. Mencione `@opencode` en un comentario y OpenCode ejecutará tareas dentro de su canal de CI GitLab. @@ -53,7 +53,7 @@ Mencione `@opencode` en un comentario y OpenCode ejecutará tareas dentro de su ### Características -- **Problemas de clasificación**: Pídele a OpenCode que investigue un problema y te lo explique. +- **Clasificación de problemas**: Pídele a OpenCode que investigue un problema y te lo explique. - **Reparar e implementar**: pídale a OpenCode que solucione un problema o implemente una función. Creará una nueva rama y generará una solicitud de fusión con los cambios. - **Seguro**: OpenCode se ejecuta en tus corredores GitLab. diff --git a/packages/web/src/content/docs/es/ide.mdx b/packages/web/src/content/docs/es/ide.mdx index 1568ec617..ba40f77ef 100644 --- a/packages/web/src/content/docs/es/ide.mdx +++ b/packages/web/src/content/docs/es/ide.mdx @@ -44,5 +44,5 @@ Si la extensión no se instala automáticamente: - Para cursor: comando `cursor` - Para Windsurf: comando `windsurf` - Para VSCodium: comando `codium` - - Si no, ejecute `Cmd+Shift+P` (Mac) o `Ctrl+Shift+P` (Windows/Linux) y busque "Comando Shell: Instalar comando 'código' en RUTA" (o el equivalente para su IDE) + - Si no, ejecute `Cmd+Shift+P` (Mac) o `Ctrl+Shift+P` (Windows/Linux) y busque "Shell Command: Install 'code' command in PATH" (o el equivalente para su IDE) - Asegúrese de que VS Code tenga permiso para instalar extensiones. diff --git a/packages/web/src/content/docs/es/index.mdx b/packages/web/src/content/docs/es/index.mdx index 03821c99f..fa8c40c7f 100644 --- a/packages/web/src/content/docs/es/index.mdx +++ b/packages/web/src/content/docs/es/index.mdx @@ -25,7 +25,7 @@ Para usar OpenCode en su terminal, necesitará: - [Ghostty](https://ghostty.org), Linux y macOS - [Kitty](https://sw.kovidgoyal.net/kitty/), Linux y macOS -2. API claves para los LLM proveedores que desea utilizar. +2. Claves API para los LLM proveedores que desea utilizar. --- @@ -90,7 +90,7 @@ También puedes instalarlo con los siguientes comandos: #### Windows :::tip[Recomendado: Usar WSL] -Para obtener la mejor experiencia en Windows, recomendamos utilizar [Subsistema Windows para Linux (WSL)](/docs/windows-wsl). Proporciona un mejor rendimiento y compatibilidad total con las funciones de OpenCode. +Para obtener la mejor experiencia en Windows, recomendamos utilizar [Windows Subsystem for Linux (WSL)](/docs/windows-wsl). Proporciona un mejor rendimiento y compatibilidad total con las funciones de OpenCode. ::: - **Usando Chocolatey** @@ -129,13 +129,12 @@ También puede obtener el binario de [Versiones](https://github.com/anomalyco/op --- -## Configurar +## Configuración Con OpenCode puedes usar cualquier proveedor LLM configurando sus claves API. Si es nuevo en el uso de proveedores LLM, le recomendamos usar [OpenCode Zen](/docs/zen). -Es una lista seleccionada de modelos que han sido probados y verificados por OpenCode -equipo. +Es una lista seleccionada de modelos que han sido probados y verificados por el equipo de OpenCode. 1. Ejecute el comando `/connect` en TUI, seleccione opencode y diríjase a [opencode.ai/auth](https://opencode.ai/auth). @@ -191,9 +190,9 @@ usado. --- -## Uso +## Usar -Ahora está listo para usar OpenCode para trabajar en su proyecto. No dudes en preguntarlo +Ahora está listo para usar OpenCode para trabajar en su proyecto. No dudes en preguntarle ¡cualquier cosa! Si es nuevo en el uso de un agente de codificación de IA, aquí hay algunos ejemplos que podrían @@ -223,7 +222,7 @@ Puede pedirle a OpenCode que agregue nuevas funciones a su proyecto. Aunque prim 1. **Crea un plan** - OpenCode tiene un _Plan mode_ que desactiva su capacidad para realizar cambios y + OpenCode tiene un _Modo Plan_ que desactiva su capacidad para realizar cambios y en su lugar, sugiera _cómo_ implementará la función. Cambie a él usando la tecla **Tab**. Verás un indicador para esto en la esquina inferior derecha. @@ -243,7 +242,7 @@ Puede pedirle a OpenCode que agregue nuevas funciones a su proyecto. Aunque prim Quiere darle a OpenCode suficientes detalles para entender lo que quiere. ayuda hablar con él como si estuviera hablando con un desarrollador junior de su equipo. - :::consejo + :::tip Dale a OpenCode mucho contexto y ejemplos para ayudarlo a comprender lo que desear. ::: @@ -257,7 +256,7 @@ Puede pedirle a OpenCode que agregue nuevas funciones a su proyecto. Aunque prim [Image #1] Take a look at this image and use it as a reference. ``` - :::consejo + :::tip Arrastre y suelte imágenes en la terminal para agregarlas al mensaje. ::: @@ -266,7 +265,7 @@ Puede pedirle a OpenCode que agregue nuevas funciones a su proyecto. Aunque prim 3. **Crea la función** - Una vez que se sienta cómodo con el plan, vuelva al _Build mode_ + Una vez que se sienta cómodo con el plan, vuelva al _Modo Build_ presionando la tecla **Tab** nuevamente. ```bash frame="none" diff --git a/packages/web/src/content/docs/es/keybinds.mdx b/packages/web/src/content/docs/es/keybinds.mdx index 0d1a6ae61..7ce014f0a 100644 --- a/packages/web/src/content/docs/es/keybinds.mdx +++ b/packages/web/src/content/docs/es/keybinds.mdx @@ -1,5 +1,5 @@ --- -title: combinaciones de teclas +title: Combinaciones de teclas description: Personaliza tus combinaciones de teclas. --- @@ -105,7 +105,7 @@ OpenCode tiene una lista de combinaciones de teclas que puede personalizar a tra --- -## Tecla de líder +## Tecla líder OpenCode usa una tecla `leader` para la mayoría de las combinaciones de teclas. Esto evita conflictos en tu terminal. @@ -143,10 +143,10 @@ La entrada de solicitud de la aplicación de escritorio OpenCode admite atajos c | `alt+b` | Mover el cursor hacia atrás una palabra | | `alt+f` | Mover el cursor hacia adelante una palabra | | `ctrl+d` | Eliminar carácter debajo del cursor | -| `ctrl+k` | Matar hasta el final de la línea | -| `ctrl+u` | Matar al inicio de la línea | -| `ctrl+w` | Matar palabra anterior | -| `alt+d` | Mata la siguiente palabra | +| `ctrl+k` | Borrar hasta el final de la línea | +| `ctrl+u` | Borrar al inicio de la línea | +| `ctrl+w` | Borrar palabra anterior | +| `alt+d` | Borrar la siguiente palabra | | `ctrl+t` | Transponer caracteres | | `ctrl+g` | Cancelar ventanas emergentes/abortar la respuesta en ejecución | diff --git a/packages/web/src/content/docs/es/lsp.mdx b/packages/web/src/content/docs/es/lsp.mdx index a5007f4c2..fc741ca89 100644 --- a/packages/web/src/content/docs/es/lsp.mdx +++ b/packages/web/src/content/docs/es/lsp.mdx @@ -1,5 +1,5 @@ --- -title: LSP Servidores +title: Servidores LSP description: OpenCode se integra con sus servidores LSP. --- @@ -7,11 +7,11 @@ OpenCode se integra con su protocolo de servidor de idiomas (LSP) para ayudar a --- -## Incorporado +## Incorporados OpenCode viene con varios servidores LSP integrados para idiomas populares: -| LSP Servidor | Extensiones | Requisitos | +| Servidor LSP | Extensiones | Requisitos | | ------------------ | ------------------------------------------------------------------- | ------------------------------------------------------------------------ | | astro | .astro | Autoinstalaciones para proyectos Astro | | bash | .sh, .bash, .zsh, .ksh | Autoinstala el servidor en lenguaje bash | @@ -56,14 +56,14 @@ Puede deshabilitar las descargas automáticas del servidor LSP configurando la v ## Cómo funciona -Cuando opencode abre un archivo,: +Cuando opencode abre un archivo: 1. Comprueba la extensión del archivo con todos los servidores LSP habilitados. 2. Inicia el servidor LSP apropiado si aún no se está ejecutando. --- -## Configurar +## Configuración Puede personalizar los servidores LSP a través de la sección `lsp` en su configuración opencode. @@ -178,11 +178,11 @@ Puede agregar servidores LSP personalizados especificando el comando y las exten ## Información adicional -### PHP Intelefense +### PHP Intelephense PHP Intelephense ofrece funciones premium a través de una clave de licencia. Puede proporcionar una clave de licencia colocando (únicamente) la clave en un archivo de texto en: -- El macOS/Linux: `$HOME/intelephense/license.txt` -- El Windows: `%USERPROFILE%/intelephense/license.txt` +- En macOS/Linux: `$HOME/intelephense/license.txt` +- En Windows: `%USERPROFILE%/intelephense/license.txt` El archivo debe contener sólo la clave de licencia sin contenido adicional. diff --git a/packages/web/src/content/docs/es/mcp-servers.mdx b/packages/web/src/content/docs/es/mcp-servers.mdx index 5a5b10ef6..3b1cabac3 100644 --- a/packages/web/src/content/docs/es/mcp-servers.mdx +++ b/packages/web/src/content/docs/es/mcp-servers.mdx @@ -21,7 +21,7 @@ Ciertos servidores MCP, como el servidor GitHub MCP, tienden a agregar muchos to --- -## Permitir +## Habilitar Puede definir servidores MCP en su [OpenCode Config](https://opencode.ai/docs/config/) en `mcp`. Agregue cada MCP con un nombre único. Puede referirse a ese MCP por su nombre cuando solicite el LLM. @@ -67,7 +67,7 @@ Los valores de configuración local anulan los valores predeterminados remotos. --- -## Local +## Locales Agregue servidores MCP locales usando `type` a `"local"` dentro del objeto MCP. @@ -264,7 +264,7 @@ Si desea deshabilitar el OAuth automático para un servidor (por ejemplo, para s --- -#### OAuth Opciones +#### Opciones de OAuth | Opción | Tipo | Descripción | | -------------- | --------------- | -------------------------------------------------------------------------------------------- | @@ -400,7 +400,7 @@ A continuación se muestran ejemplos de algunos servidores MCP comunes. Puede en --- -### centinela +### sentry Agregue el [servidor Sentry MCP](https://mcp.sentry.dev) para interactuar con sus proyectos y problemas Sentry. @@ -433,7 +433,7 @@ Show me the latest unresolved issues in my project. use sentry --- -### Contexto7 +### Context7 Agregue el [servidor Context7 MCP](https://github.com/upstash/context7) para buscar en los documentos. @@ -482,7 +482,7 @@ When you need to search docs, use `context7` tools. --- -### Grep de Vercel +### Grep by Vercel Agregue el servidor [Grep by Vercel](https://grep.app) MCP para buscar fragmentos de código en GitHub. diff --git a/packages/web/src/content/docs/es/models.mdx b/packages/web/src/content/docs/es/models.mdx index 310097a23..a722fa0a8 100644 --- a/packages/web/src/content/docs/es/models.mdx +++ b/packages/web/src/content/docs/es/models.mdx @@ -15,7 +15,7 @@ Obtenga más información sobre [proveedores](/docs/providers). --- -## Selecciona un modelo +## Seleccionar un modelo Una vez que hayas configurado tu proveedor podrás seleccionar el modelo que desees escribiendo: @@ -195,13 +195,13 @@ Puede anular las variantes existentes o agregar las suyas propias: } ``` -### Variantes de ciclo +### Alternar variantes Utilice la combinación de teclas `variant_cycle` para cambiar rápidamente entre variantes. [Más información](/docs/keybinds). --- -## Cargando modelos +## Carga de modelos Cuando se inicia OpenCode, busca modelos en el siguiente orden de prioridad: diff --git a/packages/web/src/content/docs/es/modes.mdx b/packages/web/src/content/docs/es/modes.mdx index 92986c9c1..c57e8e6a9 100644 --- a/packages/web/src/content/docs/es/modes.mdx +++ b/packages/web/src/content/docs/es/modes.mdx @@ -17,19 +17,19 @@ Puede cambiar entre modos durante una sesión o configurarlos en su archivo de c --- -## Incorporado +## Integrados opencode viene con dos modos integrados. --- -### Construir +### Modo Build Build es el modo **predeterminado** con todas las herramientas habilitadas. Este es el modo estándar para el trabajo de desarrollo en el que necesita acceso completo a las operaciones de archivos y a los comandos del sistema. --- -### Plan +### Modo Plan Un modo restringido diseñado para la planificación y el análisis. En el modo de plan, las siguientes herramientas están deshabilitadas de forma predeterminada: @@ -42,7 +42,7 @@ Este modo es útil cuando desea que la IA analice código, sugiera cambios o cre --- -## Cambio +## Cambiar de modo Puede cambiar entre modos durante una sesión usando la tecla _Tab_. O su combinación de teclas `switch_mode` configurada. @@ -50,11 +50,11 @@ Consulte también: [Formateadores](/docs/formatters) para obtener información s --- -## Configurar +## Configuración Puede personalizar los modos integrados o crear los suyos propios mediante la configuración. Los modos se pueden configurar de dos maneras: -### JSON Configuración +### Configuración JSON Configure los modos en su archivo de configuración `opencode.json`: @@ -177,7 +177,7 @@ Si no se especifica ninguna temperatura, opencode utiliza valores predeterminado --- -### Inmediato +### Indicación Especifique un archivo de aviso del sistema personalizado para este modo con la configuración `prompt`. El archivo de aviso debe contener instrucciones específicas para el propósito del modo. @@ -322,10 +322,10 @@ Priorities: A continuación se muestran algunos casos de uso comunes para diferentes modos. -- **Modo de compilación**: trabajo de desarrollo completo con todas las herramientas habilitadas -- **Modo Planificación**: Análisis y planificación sin realizar cambios -- **Modo de revisión**: revisión de código con acceso de solo lectura más herramientas de documentación -- **Modo de depuración**: centrado en la investigación con bash y herramientas de lectura habilitadas +- **Modo Build**: trabajo de desarrollo completo con todas las herramientas habilitadas +- **Modo Plan**: Análisis y planificación sin realizar cambios +- **Modo Review**: revisión de código con acceso de solo lectura más herramientas de documentación +- **Modo Debug**: centrado en la investigación con bash y herramientas de lectura habilitadas - **Modo Docs**: escritura de documentacion con operaciones de archivos pero sin comandos del sistema También puede encontrar que diferentes modelos son buenos para diferentes casos de uso. diff --git a/packages/web/src/content/docs/es/network.mdx b/packages/web/src/content/docs/es/network.mdx index 9382fd06b..f5b6e1130 100644 --- a/packages/web/src/content/docs/es/network.mdx +++ b/packages/web/src/content/docs/es/network.mdx @@ -7,7 +7,7 @@ OpenCode admite variables de entorno de proxy estándar y certificados personali --- -## apoderado +## Proxy OpenCode respeta las variables de entorno de proxy estándar. @@ -30,7 +30,7 @@ Puede configurar el puerto y el nombre de host del servidor usando [CLI flags](/ --- -### Autenticar +### Autenticación Si su proxy requiere autenticación básica, incluya las credenciales en la URL. diff --git a/packages/web/src/content/docs/es/plugins.mdx b/packages/web/src/content/docs/es/plugins.mdx index 31bbe9d40..904821bdb 100644 --- a/packages/web/src/content/docs/es/plugins.mdx +++ b/packages/web/src/content/docs/es/plugins.mdx @@ -9,13 +9,13 @@ Para ver ejemplos, consulte los [complementos](/docs/ecosystem#plugins) creados --- -## Usa un complemento +## Usar un complemento Hay dos formas de cargar complementos. --- -### De archivos locales +### Desde archivos locales Coloque los archivos JavaScript o TypeScript en el directorio del complemento. @@ -26,7 +26,7 @@ Los archivos en estos directorios se cargan automáticamente al inicio. --- -### De npm +### Desde npm Especifique paquetes npm en su archivo de configuración. @@ -51,7 +51,7 @@ Los **complementos npm** se instalan automáticamente usando Bun al inicio. Los --- -### Cargar orden +### Orden de carga Los complementos se cargan desde todas las fuentes y todos los enlaces se ejecutan en secuencia. El orden de carga es: @@ -123,7 +123,7 @@ La función del complemento recibe: --- -### TypeScript soporte +### Soporte TypeScript Para los complementos TypeScript, puede importar tipos desde el paquete de complementos: @@ -156,7 +156,7 @@ Los complementos pueden suscribirse a eventos como se ve a continuación en la s - `installation.updated` -#### LSP Eventos +#### Eventos LSP - `lsp.client.diagnostics` - `lsp.updated` @@ -188,11 +188,11 @@ Los complementos pueden suscribirse a eventos como se ve a continuación en la s - `session.status` - `session.updated` -#### Todo Eventos +#### Eventos de Todo - `todo.updated` -#### Eventos Shell +#### Eventos de Shell - `shell.env` @@ -201,7 +201,7 @@ Los complementos pueden suscribirse a eventos como se ve a continuación en la s - `tool.execute.after` - `tool.execute.before` -#### TUI Eventos +#### Eventos TUI - `tui.prompt.append` - `tui.command.execute` @@ -240,7 +240,7 @@ Si está utilizando la aplicación de escritorio OpenCode, puede enviar notifica --- -### protección .env +### Protección .env Evite que opencode lea archivos `.env`: @@ -331,7 +331,7 @@ Niveles: `debug`, `info`, `warn`, `error`. Consulte la [documentación del SDK]( --- -### Ganchos de compactación +### Hooks de compactación Personalice el contexto incluido cuando se compacta una sesión: @@ -355,7 +355,7 @@ Include any state that should persist across compaction: } ``` -El gancho `experimental.session.compacting` se activa antes de que LLM genere un resumen de continuación. Úselo para inyectar contexto específico del dominio que el mensaje de compactación predeterminado omitiría. +El hook `experimental.session.compacting` se activa antes de que LLM genere un resumen de continuación. Úselo para inyectar contexto específico del dominio que el mensaje de compactación predeterminado omitiría. También puede reemplazar completamente el mensaje de compactación configurando `output.prompt`: diff --git a/packages/web/src/content/docs/es/providers.mdx b/packages/web/src/content/docs/es/providers.mdx index 37fc4745f..8d8661253 100644 --- a/packages/web/src/content/docs/es/providers.mdx +++ b/packages/web/src/content/docs/es/providers.mdx @@ -290,7 +290,7 @@ O si ya tienes una clave API, puedes seleccionar **Ingresar manualmente la clave --- -### Azul OpenAI +### Azure OpenAI :::note Si encuentra errores del tipo "Lo siento, pero no puedo ayudar con esa solicitud", intente cambiar el filtro de contenido de **DefaultV2** a **Default** en su recurso de Azure. @@ -527,7 +527,7 @@ Cloudflare AI Gateway le permite acceder a modelos de OpenAI, Anthropic, Workers --- -### Búsqueda profunda +### DeepSeek 1. Dirígete a la [consola de DeepSeek](https://platform.deepseek.com/), crea una cuenta y haz clic en **Crear nueva clave API**. @@ -554,7 +554,7 @@ Cloudflare AI Gateway le permite acceder a modelos de OpenAI, Anthropic, Workers --- -### Infraestructura profunda +### Deep Infra 1. Dirígete al [panel de Deep Infra](https://deepinfra.com/dash), crea una cuenta y genera una clave API. @@ -608,7 +608,7 @@ Cloudflare AI Gateway le permite acceder a modelos de OpenAI, Anthropic, Workers --- -### Fuegos artificiales AI +### Fireworks AI 1. Dirígete a la [Consola de Fireworks AI](https://app.fireworks.ai/), crea una cuenta y haz clic en **Crear clave API**. @@ -635,7 +635,7 @@ Cloudflare AI Gateway le permite acceder a modelos de OpenAI, Anthropic, Workers --- -### GitLab Dúo +### GitLab Duo GitLab Duo proporciona chat agente basado en IA con capacidades de llamada de herramientas nativas a través del proxy Anthropic de GitLab. @@ -652,6 +652,7 @@ GitLab Duo proporciona chat agente basado en IA con capacidades de llamada de he │ │ OAuth (Recommended) │ Personal Access Token + │ └ ``` @@ -769,7 +770,7 @@ Personalizar a través de `opencode.json`: } ``` -##### GitLab API Herramientas (opcionales, pero muy recomendables) +##### Herramientas de API de GitLab (opcionales, pero muy recomendables) Para acceder a herramientas GitLab (solicitudes de fusión, problemas, canalizaciones, CI/CD, etc.): @@ -784,7 +785,7 @@ Este complemento proporciona capacidades integrales de administración del repos --- -### GitHub Copiloto +### GitHub Copilot Para utilizar su suscripción GitHub Copilot con opencode: @@ -810,6 +811,7 @@ Algunos modelos deben habilitarse manualmente en su [GitHub configuración del c │ │ Enter code: 8F43-6FCF │ + │ └ Waiting for authorization... ``` @@ -821,14 +823,14 @@ Algunos modelos deben habilitarse manualmente en su [GitHub configuración del c --- -### IA de vértice de Google +### Google Vertex AI Para utilizar Google Vertex AI con OpenCode: 1. Dirígete a **Model Garden** en Google Cloud Console y verifica el Modelos disponibles en su región. - :::nota + :::note Debes tener un proyecto de Google Cloud con Vertex AI API habilitado. ::: @@ -921,7 +923,7 @@ La región `global` mejora la disponibilidad y reduce los errores sin costo adic --- -### Helicón +### Helicone [Helicone](https://helicone.ai) es una plataforma de observabilidad LLM que proporciona registro, monitoreo y análisis para sus aplicaciones de IA. Helicone AI Gateway enruta sus solicitudes al proveedor apropiado automáticamente según el modelo. @@ -1101,7 +1103,7 @@ IO.NET ofrece 17 modelos optimizados para varios casos de uso: --- -### Estudio LM +### LM Studio Puede configurar opencode para usar modelos locales a través de LM Studio. @@ -1135,7 +1137,7 @@ En este ejemplo: --- -### IA disparada a la luna +### Moonshot AI Para usar Kimi K2 de Moonshot AI: @@ -1164,7 +1166,7 @@ Para usar Kimi K2 de Moonshot AI: --- -### Minimáx. +### MiniMax 1. Dirígete a la [Consola MiniMax API](https://platform.minimax.io/login), crea una cuenta y genera una clave API. @@ -1191,7 +1193,7 @@ Para usar Kimi K2 de Moonshot AI: --- -### Fábrica de tokens Nebius +### Nebius Token Factory 1. Dirígete a la [consola de Nebius Token Factory](https://tokenfactory.nebius.com/), crea una cuenta y haz clic en **Agregar clave**. @@ -1317,6 +1319,7 @@ Recomendamos registrarse en [ChatGPT Plus o Pro](https://chatgpt.com/pricing). │ │ ChatGPT Plus/Pro │ Manually enter API Key + │ └ ``` @@ -1361,7 +1364,7 @@ OpenCode Zen es una lista de modelos probados y verificados proporcionada por el --- -### Enrutador abierto +### OpenRouter 1. Dirígete al [panel de OpenRouter](https://openrouter.ai/settings/keys), haz clic en **Crear clave API** y copia la clave. @@ -1425,7 +1428,7 @@ OpenCode Zen es una lista de modelos probados y verificados proporcionada por el --- -### Núcleo de IA de SAP +### SAP AI Core SAP AI Core brinda acceso a más de 40 modelos de OpenAI, Anthropic, Google, Amazon, Meta, Mistral y AI21 a través de una plataforma unificada. @@ -1468,7 +1471,7 @@ SAP AI Core brinda acceso a más de 40 modelos de OpenAI, Anthropic, Google, Ama AICORE_DEPLOYMENT_ID=your-deployment-id AICORE_RESOURCE_GROUP=your-resource-group opencode ``` - :::nota + :::note Estas configuraciones son opcionales y deben configurarse de acuerdo con su configuración de SAP AI Core. ::: @@ -1480,7 +1483,7 @@ SAP AI Core brinda acceso a más de 40 modelos de OpenAI, Anthropic, Google, Ama --- -### Puntos finales de IA de OVHcloud +### OVHcloud AI Endpoints 1. Dirígete al [panel de OVHcloud](https://ovh.com/manager). Navegue a la sección `Public Cloud`, `AI & Machine Learning` > `AI Endpoints` y en la pestaña `API Keys`, haga clic en **Crear una nueva clave API**. @@ -1507,7 +1510,7 @@ SAP AI Core brinda acceso a más de 40 modelos de OpenAI, Anthropic, Google, Ama --- -### Escala +### Scaleway Para utilizar [API generativas de Scaleway](https://www.scaleway.com/en/docs/generative-apis/) con OpenCode: @@ -1536,7 +1539,7 @@ Para utilizar [API generativas de Scaleway](https://www.scaleway.com/en/docs/gen --- -### Juntos IA +### Together AI 1. Dirígete a la [consola de Together AI](https://api.together.ai), crea una cuenta y haz clic en **Agregar clave**. @@ -1563,7 +1566,7 @@ Para utilizar [API generativas de Scaleway](https://www.scaleway.com/en/docs/gen --- -### Venecia AI +### Venice AI 1. Dirígete a la [consola de Venice AI](https://venice.ai), crea una cuenta y genera una clave API. @@ -1573,7 +1576,7 @@ Para utilizar [API generativas de Scaleway](https://www.scaleway.com/en/docs/gen /connect ``` -3. Ingrese su clave Venecia AI API. +3. Ingrese su clave Venice AI API. ```txt ┌ API key @@ -1777,7 +1780,7 @@ Puede utilizar cualquier proveedor compatible con OpenAI con opencode. La mayor └ ``` - :::nota + :::note Elija una identificación memorable, la usará en su archivo de configuración. ::: diff --git a/packages/web/src/content/docs/es/rules.mdx b/packages/web/src/content/docs/es/rules.mdx index 11a41a66d..6f429a803 100644 --- a/packages/web/src/content/docs/es/rules.mdx +++ b/packages/web/src/content/docs/es/rules.mdx @@ -1,5 +1,5 @@ --- -title: Normas +title: Reglas description: Establezca instrucciones personalizadas para opencode. --- @@ -66,7 +66,7 @@ También puedes tener reglas globales en un archivo `~/.config/opencode/AGENTS.m Dado que esto no está comprometido con Git ni se comparte con su equipo, recomendamos usarlo para especificar las reglas personales que debe seguir LLM. -### Compatibilidad del código Claude +### Compatibilidad con Claude Code Para los usuarios que migran desde Claude Code, OpenCode admite las convenciones de archivos de Claude Code como alternativas: @@ -90,7 +90,7 @@ Cuando se inicia opencode, busca archivos de reglas en este orden: 1. **Archivos locales** atravesando desde el directorio actual (`AGENTS.md`, `CLAUDE.md`) 2. **Archivo global** en `~/.config/opencode/AGENTS.md` -3. **Archivo de Código Claude** en `~/.claude/CLAUDE.md` (a menos que esté deshabilitado) +3. **Archivo de Claude Code** en `~/.claude/CLAUDE.md` (a menos que esté deshabilitado) El primer archivo coincidente gana en cada categoría. Por ejemplo, si tiene `AGENTS.md` y `CLAUDE.md`, solo se usa `AGENTS.md`. De manera similar, `~/.config/opencode/AGENTS.md` tiene prioridad sobre `~/.claude/CLAUDE.md`. @@ -128,7 +128,7 @@ Todos los archivos de instrucciones se combinan con sus archivos `AGENTS.md`. Si bien opencode no analiza automáticamente las referencias de archivos en `AGENTS.md`, puedes lograr una funcionalidad similar de dos maneras: -### Usando opencode.json +### Usar opencode.json El enfoque recomendado es utilizar el campo `instructions` en `opencode.json`: diff --git a/packages/web/src/content/docs/es/sdk.mdx b/packages/web/src/content/docs/es/sdk.mdx index e7006ecc4..d1282b95e 100644 --- a/packages/web/src/content/docs/es/sdk.mdx +++ b/packages/web/src/content/docs/es/sdk.mdx @@ -188,7 +188,7 @@ const currentProject = await client.project.current() --- -### Camino +### Ruta | Método | Descripción | Respuesta | | ------------ | ------------------- | ---------------------------------------- | @@ -230,7 +230,7 @@ const { providers, default: defaults } = await client.config.providers() | ---------------------------------------------------------- | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `session.list()` | Listar sesiones | Devuelve Session[] | | `session.get({ path })` | Obtener sesión | Devuelve Session | -| `session.children({ path })` | Listar sesiones infantiles | Devuelve Session[] | +| `session.children({ path })` | Listar sesiones secundarias | Devuelve Session[] | | `session.create({ body })` | Crear sesión | Devuelve Session | | `session.delete({ path })` | Eliminar sesión | Devuelve `boolean` | | `session.update({ path, body })` | Actualizar propiedades de sesión | Devuelve Session | diff --git a/packages/web/src/content/docs/es/server.mdx b/packages/web/src/content/docs/es/server.mdx index 08cc9d361..c3ce97421 100644 --- a/packages/web/src/content/docs/es/server.mdx +++ b/packages/web/src/content/docs/es/server.mdx @@ -89,7 +89,7 @@ El servidor opencode expone las siguientes API. ### Global -| Método | Camino | Descripción | Respuesta | +| Método | Ruta | Descripción | Respuesta | | ------ | ---------------- | ------------------------------------------- | ------------------------------------ | | `GET` | `/global/health` | Obtener el estado y la versión del servidor | `{ healthy: true, version: string }` | | `GET` | `/global/event` | Obtenga eventos globales (transmisión SSE) | Flujo de eventos | @@ -98,7 +98,7 @@ El servidor opencode expone las siguientes API. ### Proyecto -| Método | Camino | Descripción | Respuesta | +| Método | Ruta | Descripción | Respuesta | | ------ | ------------------ | -------------------------- | --------------------------------------------- | | `GET` | `/project` | Listar todos los proyectos | Project[] | | `GET` | `/project/current` | Obtener el proyecto actual | Project | @@ -107,7 +107,7 @@ El servidor opencode expone las siguientes API. ### Ruta y VCS -| Método | Camino | Descripción | Respuesta | +| Método | Ruta | Descripción | Respuesta | | ------ | ------- | -------------------------------------------------- | ------------------------------------------- | | `GET` | `/path` | Obtener la ruta actual | Path | | `GET` | `/vcs` | Obtenga información de VCS para el proyecto actual | VcsInfo | @@ -116,7 +116,7 @@ El servidor opencode expone las siguientes API. ### Instancia -| Método | Camino | Descripción | Respuesta | +| Método | Ruta | Descripción | Respuesta | | ------ | ------------------- | ---------------------------- | --------- | | `POST` | `/instance/dispose` | Eliminar la instancia actual | `boolean` | @@ -124,7 +124,7 @@ El servidor opencode expone las siguientes API. ### Configuración -| Método | Camino | Descripción | Respuesta | +| Método | Ruta | Descripción | Respuesta | | ------- | ------------------- | ---------------------------------------------- | ----------------------------------------------------------------------------------------- | | `GET` | `/config` | Obtener información de configuración | Config | | `PATCH` | `/config` | Actualizar configuración | Config | @@ -134,7 +134,7 @@ El servidor opencode expone las siguientes API. ### Proveedor -| Método | Camino | Descripción | Respuesta | +| Método | Ruta | Descripción | Respuesta | | ------ | -------------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------ | | `GET` | `/provider` | Listar todos los proveedores | `{ all: `Proveedor[]`, default: {...}, connected: string[] }` | | `GET` | `/provider/auth` | Obtener métodos de autenticación de proveedores | `{ [providerID: string]: `ProviderAuthMethod[]` }` | @@ -145,7 +145,7 @@ El servidor opencode expone las siguientes API. ### Sesiones -| Método | Camino | Descripción | Notas | +| Método | Ruta | Descripción | Notas | | -------- | ---------------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------- | | `GET` | `/session` | Listar todas las sesiones | Devuelve Session[] | | `POST` | `/session` | Crear una nueva sesión | cuerpo: `{ parentID?, title? }`, devuelve Session | @@ -170,7 +170,7 @@ El servidor opencode expone las siguientes API. ### Mensajes -| Método | Camino | Descripción | Notas | +| Método | Ruta | Descripción | Notas | | ------ | --------------------------------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `GET` | `/session/:id/message` | Listar mensajes en una sesión | consulta: `limit?`, devuelve `{ info: `Mensaje`, parts: `Parte[]`}[]` | | `POST` | `/session/:id/message` | Envía un mensaje y espera respuesta | cuerpo: `{ messageID?, model?, agent?, noReply?, system?, tools?, parts }`, devuelve `{ info: `Mensaje`, parts: `Parte[]`}` | @@ -183,7 +183,7 @@ El servidor opencode expone las siguientes API. ### Comandos -| Método | Camino | Descripción | Respuesta | +| Método | Ruta | Descripción | Respuesta | | ------ | ---------- | ------------------------- | --------------------------------------------- | | `GET` | `/command` | Listar todos los comandos | Command[] | @@ -191,7 +191,7 @@ El servidor opencode expone las siguientes API. ### Archivos -| Método | Camino | Descripción | Respuesta | +| Método | Ruta | Descripción | Respuesta | | ------ | ------------------------ | -------------------------------------------- | -------------------------------------------------------------------------------------------------- | | `GET` | `/find?pattern=` | Buscar texto en archivos | Matriz de objetos coincidentes con `path`, `lines`, `line_number`, `absolute_offset`, `submatches` | | `GET` | `/find/file?query=` | Buscar archivos y directorios por nombre | `string[]` (caminos) | @@ -200,7 +200,7 @@ El servidor opencode expone las siguientes API. | `GET` | `/file/content?path=

` | Leer un archivo | FileContent | | `GET` | `/file/status` | Obtener el estado de los archivos rastreados | File[] | -#### `/find/file` parámetros de consulta +#### Parámetros de consulta de /find/file - `query` (obligatorio) — cadena de búsqueda (coincidencia aproximada) - `type` (opcional): limita los resultados a `"file"` o `"directory"` @@ -212,7 +212,7 @@ El servidor opencode expone las siguientes API. ### Herramientas (experimentales) -| Método | Camino | Descripción | Respuesta | +| Método | Ruta | Descripción | Respuesta | | ------ | ------------------------------------------- | ---------------------------------------------------- | -------------------------------------------- | | `GET` | `/experimental/tool/ids` | Listar todos los ID de herramientas | ToolIDs | | `GET` | `/experimental/tool?provider=

&model=` | Listar herramientas con esquemas JSON para un modelo | ToolList | @@ -221,7 +221,7 @@ El servidor opencode expone las siguientes API. ### LSP, formateadores y MCP -| Método | Camino | Descripción | Respuesta | +| Método | Ruta | Descripción | Respuesta | | ------ | ------------ | ------------------------------------- | --------------------------------------------------------- | | `GET` | `/lsp` | Obtener el estado del servidor LSP | LSPStatus[] | | `GET` | `/formatter` | Obtener estado del formateador | FormatterStatus[] | @@ -232,7 +232,7 @@ El servidor opencode expone las siguientes API. ### Agentes -| Método | Camino | Descripción | Respuesta | +| Método | Ruta | Descripción | Respuesta | | ------ | -------- | ------------------------------------ | ------------------------------------------- | | `GET` | `/agent` | Listar todos los agentes disponibles | Agent[] | @@ -240,7 +240,7 @@ El servidor opencode expone las siguientes API. ### Registro -| Método | Camino | Descripción | Respuesta | +| Método | Ruta | Descripción | Respuesta | | ------ | ------ | --------------------------------------------------------------------------- | --------- | | `POST` | `/log` | Escribir entrada de registro. Cuerpo: `{ service, level, message, extra? }` | `boolean` | @@ -248,7 +248,7 @@ El servidor opencode expone las siguientes API. ### TUI -| Método | Camino | Descripción | Respuesta | +| Método | Ruta | Descripción | Respuesta | | ------ | ----------------------- | ------------------------------------------------- | ------------------------------ | | `POST` | `/tui/append-prompt` | Agregar texto al mensaje | `boolean` | | `POST` | `/tui/open-help` | Abra el cuadro de diálogo de ayuda | `boolean` | @@ -266,7 +266,7 @@ El servidor opencode expone las siguientes API. ### Autenticación -| Método | Camino | Descripción | Respuesta | +| Método | Ruta | Descripción | Respuesta | | ------ | ----------- | ----------------------------------------------------------------------------------------------- | --------- | | `PUT` | `/auth/:id` | Establecer credenciales de autenticación. El cuerpo debe coincidir con el esquema del proveedor | `boolean` | @@ -274,14 +274,14 @@ El servidor opencode expone las siguientes API. ### Eventos -| Método | Camino | Descripción | Respuesta | +| Método | Ruta | Descripción | Respuesta | | ------ | -------- | ------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | | `GET` | `/event` | Transmisión de eventos enviados por el servidor. El primer evento es `server.connected`, luego eventos de bus | Transmisión de eventos enviados por el servidor | --- -### Docs +### Documentación -| Método | Camino | Descripción | Respuesta | +| Método | Ruta | Descripción | Respuesta | | ------ | ------ | -------------------------- | -------------------------------------- | | `GET` | `/doc` | Especificación OpenAPI 3.1 | Página HTML con especificación OpenAPI | diff --git a/packages/web/src/content/docs/es/share.mdx b/packages/web/src/content/docs/es/share.mdx index 3129b4bec..e1c62a031 100644 --- a/packages/web/src/content/docs/es/share.mdx +++ b/packages/web/src/content/docs/es/share.mdx @@ -21,7 +21,7 @@ Cuando compartes una conversación, OpenCode: --- -## Intercambio +## Uso compartido OpenCode admite tres modos de compartir que controlan cómo se comparten las conversaciones: diff --git a/packages/web/src/content/docs/es/skills.mdx b/packages/web/src/content/docs/es/skills.mdx index 99ed564d4..46f7bc24f 100644 --- a/packages/web/src/content/docs/es/skills.mdx +++ b/packages/web/src/content/docs/es/skills.mdx @@ -31,7 +31,7 @@ Las definiciones globales también se cargan desde `~/.config/opencode/skills/*/ --- -## Escribe la introducción +## Escribir la introducción Cada `SKILL.md` debe comenzar con el frontmatter de YAML. Sólo se reconocen estos campos: @@ -64,14 +64,14 @@ expresión regular equivalente: --- -## Siga las reglas de longitud +## Seguir las reglas de longitud `description` debe tener entre 1 y 1024 caracteres. Manténgalo lo suficientemente específico para que el agente elija correctamente. --- -## Usa un ejemplo +## Usar un ejemplo Crea `.opencode/skills/git-release/SKILL.md` así: diff --git a/packages/web/src/content/docs/es/themes.mdx b/packages/web/src/content/docs/es/themes.mdx index b56314daa..d7c742626 100644 --- a/packages/web/src/content/docs/es/themes.mdx +++ b/packages/web/src/content/docs/es/themes.mdx @@ -59,7 +59,7 @@ El tema del sistema es para usuarios que: --- -## Usando un tema +## Usar un tema Puede seleccionar un tema abriendo la selección de tema con el comando `/theme`. O puede especificarlo en su [config](/docs/config). @@ -91,7 +91,7 @@ Si varios directorios contienen un tema con el mismo nombre, se utilizará el te --- -### Creando un tema +### Crear un tema Para crear un tema personalizado, cree un archivo JSON en uno de los directorios de temas. @@ -111,7 +111,7 @@ vim .opencode/themes/my-theme.json --- -### formato JSON +### Formato JSON Los temas utilizan un formato JSON flexible compatible con: diff --git a/packages/web/src/content/docs/es/tools.mdx b/packages/web/src/content/docs/es/tools.mdx index 6a29527ad..69f134046 100644 --- a/packages/web/src/content/docs/es/tools.mdx +++ b/packages/web/src/content/docs/es/tools.mdx @@ -9,7 +9,7 @@ De forma predeterminada, todas las herramientas están **habilitadas** y no nece --- -## Configurar +## Configuración Utilice el campo `permission` para controlar el comportamiento de la herramienta. Puede permitir, denegar o exigir aprobación para cada herramienta. @@ -39,7 +39,7 @@ También puedes utilizar comodines para controlar varias herramientas a la vez. --- -## Incorporado +## Integradas Aquí están todas las herramientas integradas disponibles en OpenCode. @@ -134,7 +134,7 @@ Búsqueda rápida de contenido en su base de código. Admite sintaxis de expresi --- -### globo +### glob Encuentre archivos por coincidencia de patrones. @@ -352,7 +352,7 @@ Las herramientas personalizadas le permiten definir sus propias funciones a las --- -## MCP servidores +## Servidores MCP Los servidores MCP (Model Context Protocol) le permiten integrar herramientas y servicios externos. Esto incluye acceso a bases de datos, integraciones API y servicios de terceros. diff --git a/packages/web/src/content/docs/es/troubleshooting.mdx b/packages/web/src/content/docs/es/troubleshooting.mdx index 109f6eba5..19f41bd68 100644 --- a/packages/web/src/content/docs/es/troubleshooting.mdx +++ b/packages/web/src/content/docs/es/troubleshooting.mdx @@ -169,7 +169,7 @@ Para encontrar el directorio rápidamente: --- -## Obteniendo ayuda +## Obtener ayuda Si tiene problemas con OpenCode: diff --git a/packages/web/src/content/docs/es/tui.mdx b/packages/web/src/content/docs/es/tui.mdx index ae68955ea..ba7430f50 100644 --- a/packages/web/src/content/docs/es/tui.mdx +++ b/packages/web/src/content/docs/es/tui.mdx @@ -69,7 +69,7 @@ Aquí están todos los comandos de barra diagonal disponibles: --- -### conectar +### connect Agregue un proveedor a OpenCode. Le permite seleccionar entre proveedores disponibles y agregar sus claves API. @@ -79,7 +79,7 @@ Agregue un proveedor a OpenCode. Le permite seleccionar entre proveedores dispon --- -### compacto +### compact Compacta la sesión actual. _Alias_: `/summarize` @@ -91,7 +91,7 @@ Compacta la sesión actual. _Alias_: `/summarize` --- -### detalles +### details Alternar detalles de ejecución de la herramienta. @@ -115,7 +115,7 @@ Abra un editor externo para redactar mensajes. Utiliza el editor configurado en --- -### salida +### exit Salga de OpenCode. _Alias_: `/quit`, `/q` @@ -127,7 +127,7 @@ Salga de OpenCode. _Alias_: `/quit`, `/q` --- -### exportar +### export Exporte la conversación actual a Markdown y ábrala en su editor predeterminado. Utiliza el editor configurado en su variable de entorno `EDITOR`. [Más información](#editor-setup). @@ -139,7 +139,7 @@ Exporte la conversación actual a Markdown y ábrala en su editor predeterminado --- -### ayuda +### help Muestra el cuadro de diálogo de ayuda. @@ -151,7 +151,7 @@ Muestra el cuadro de diálogo de ayuda. --- -### inicio +### init Cree o actualice el archivo `AGENTS.md`. [Más información](/docs/rules). @@ -163,7 +163,7 @@ Cree o actualice el archivo `AGENTS.md`. [Más información](/docs/rules). --- -### modelos +### models Listar modelos disponibles. @@ -175,7 +175,7 @@ Listar modelos disponibles. --- -### nuevo +### new Iniciar una nueva sesión. _Alias_: `/clear` @@ -187,7 +187,7 @@ Iniciar una nueva sesión. _Alias_: `/clear` --- -### rehacer +### redo Rehacer un mensaje previamente deshecho. Solo disponible después de usar `/undo`. @@ -206,7 +206,7 @@ ser un repositorio Git**. --- -### sesiones +### sessions Enumere y cambie entre sesiones. _Alias_: `/resume`, `/continue` @@ -218,7 +218,7 @@ Enumere y cambie entre sesiones. _Alias_: `/resume`, `/continue` --- -### compartir +### share Compartir la sesión actual. [Más información](/docs/share). @@ -230,7 +230,7 @@ Compartir la sesión actual. [Más información](/docs/share). --- -### temas +### theme Listar temas disponibles. @@ -242,7 +242,7 @@ Listar temas disponibles. --- -### pensamiento +### thinking Alterna la visibilidad de los bloques de pensamiento/razonamiento en la conversación. Cuando está habilitado, puede ver el proceso de razonamiento del modelo para los modelos que admiten el pensamiento extendido. @@ -256,7 +256,7 @@ Este comando solo controla si se **muestran** los bloques de pensamiento; no hab --- -### deshacer +### undo Deshacer el último mensaje de la conversación. Elimina el mensaje de usuario más reciente, todas las respuestas posteriores y cualquier cambio de archivo. @@ -275,7 +275,7 @@ ser un repositorio Git**. --- -### dejar de compartir +### unshare Dejar de compartir la sesión actual. [Más información](/docs/share#un-sharing). diff --git a/packages/web/src/content/docs/es/web.mdx b/packages/web/src/content/docs/es/web.mdx index a741c2f4a..b5a2ad8fa 100644 --- a/packages/web/src/content/docs/es/web.mdx +++ b/packages/web/src/content/docs/es/web.mdx @@ -7,7 +7,7 @@ OpenCode puede ejecutarse como una aplicación web en su navegador, brindando la ![OpenCode Web - Nueva sesión](../../../assets/web/web-homepage-new-session.png) -## Empezando +## Empezar Inicie la interfaz web ejecutando: @@ -90,7 +90,7 @@ El nombre de usuario predeterminado es `opencode` pero se puede cambiar con `OPE --- -## Uso de la interfaz web +## Usar la interfaz web Una vez iniciada, la interfaz web proporciona acceso a sus sesiones OpenCode. diff --git a/packages/web/src/content/docs/es/windows-wsl.mdx b/packages/web/src/content/docs/es/windows-wsl.mdx index d2e682798..eea984348 100644 --- a/packages/web/src/content/docs/es/windows-wsl.mdx +++ b/packages/web/src/content/docs/es/windows-wsl.mdx @@ -7,23 +7,23 @@ import { Steps } from "@astrojs/starlight/components" Aunque OpenCode puede ejecutarse directamente en Windows, recomendamos usar [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) para obtener la mejor experiencia. WSL ofrece un entorno Linux que funciona perfectamente con las funciones de OpenCode. -:::tip[Por que WSL?] +:::tip[¿Por qué WSL?] WSL ofrece mejor rendimiento del sistema de archivos, soporte completo de terminal y compatibilidad con las herramientas de desarrollo de las que depende OpenCode. ::: --- -## Configuracion +## Configuración 1. **Instala WSL** - Si aun no lo hiciste, [instala WSL](https://learn.microsoft.com/en-us/windows/wsl/install) usando la guia oficial de Microsoft. + Si aún no lo hiciste, [instala WSL](https://learn.microsoft.com/en-us/windows/wsl/install) usando la guía oficial de Microsoft. 2. **Instala OpenCode en WSL** - Cuando WSL este listo, abre tu terminal de WSL e instala OpenCode con uno de los [metodos de instalacion](/docs/). + Cuando WSL esté listo, abre tu terminal de WSL e instala OpenCode con uno de los [métodos de instalación](/docs/). ```bash curl -fsSL https://opencode.ai/install | bash @@ -42,7 +42,7 @@ WSL ofrece mejor rendimiento del sistema de archivos, soporte completo de termin --- -## Aplicacion de escritorio + servidor WSL +## Aplicación de escritorio + servidor WSL Si prefieres usar la app de escritorio de OpenCode pero quieres ejecutar el servidor en WSL: @@ -55,7 +55,7 @@ Si prefieres usar la app de escritorio de OpenCode pero quieres ejecutar el serv 2. **Conecta la app de escritorio** a `http://localhost:4096` :::note -Si `localhost` no funciona en tu configuracion, conectate usando la direccion IP de WSL (desde WSL: `hostname -I`) y usa `http://:4096`. +Si `localhost` no funciona en tu configuración, conéctate usando la dirección IP de WSL (desde WSL: `hostname -I`) y usa `http://:4096`. ::: :::caution @@ -81,7 +81,7 @@ Para obtener la mejor experiencia web en Windows: 2. **Accede desde tu navegador de Windows** en `http://localhost:` (OpenCode muestra la URL) -Ejecutar `opencode web` desde WSL garantiza acceso correcto al sistema de archivos e integracion con la terminal, manteniendolo accesible desde tu navegador de Windows. +Ejecutar `opencode web` desde WSL garantiza acceso correcto al sistema de archivos e integración con la terminal, manteniéndolo accesible desde tu navegador de Windows. --- @@ -91,7 +91,7 @@ WSL puede acceder a todos tus archivos de Windows mediante el directorio `/mnt/` - Unidad `C:` → `/mnt/c/` - Unidad `D:` → `/mnt/d/` -- Y asi sucesivamente... +- Y así sucesivamente... Ejemplo: @@ -101,7 +101,7 @@ opencode ``` :::tip -Para una experiencia mas fluida, considera clonar o copiar tu repo al sistema de archivos de WSL (por ejemplo en `~/code/`) y ejecutar OpenCode ahi. +Para una experiencia más fluida, considera clonar o copiar tu repo al sistema de archivos de WSL (por ejemplo en `~/code/`) y ejecutar OpenCode ahí. ::: --- @@ -109,5 +109,5 @@ Para una experiencia mas fluida, considera clonar o copiar tu repo al sistema de ## Consejos - Ejecuta OpenCode en WSL para proyectos guardados en unidades de Windows: el acceso a archivos es transparente -- Usa la [extension WSL de VS Code](https://code.visualstudio.com/docs/remote/wsl) junto con OpenCode para un flujo de desarrollo integrado -- Tu configuracion y tus sesiones de OpenCode se guardan dentro del entorno WSL en `~/.local/share/opencode/` +- Usa la [extensión WSL de VS Code](https://code.visualstudio.com/docs/remote/wsl) junto con OpenCode para un flujo de desarrollo integrado +- Tu configuración y tus sesiones de OpenCode se guardan dentro del entorno WSL en `~/.local/share/opencode/` diff --git a/packages/web/src/content/docs/es/zen.mdx b/packages/web/src/content/docs/es/zen.mdx index 1dc7125b9..10847b452 100644 --- a/packages/web/src/content/docs/es/zen.mdx +++ b/packages/web/src/content/docs/es/zen.mdx @@ -1,5 +1,5 @@ --- -title: zen +title: Zen description: Lista seleccionada de modelos proporcionada por OpenCode. --- @@ -18,7 +18,7 @@ tu API key. Es **completamente opcional** y no necesitas usarlo para usar OpenCo --- -## Fondo +## Contexto Hay una gran cantidad de modelos, pero solo unos pocos funcionan bien como agentes de coding. Ademas, la mayoria de proveedores se configura de forma diferente, asi que el rendimiento y la calidad varian mucho. @@ -231,7 +231,7 @@ recopila datos. --- -### Trae tu propia API key +### Trae tu propia clave API Puedes usar tus propias API keys de OpenAI o Anthropic mientras accedes a otros modelos en Zen. diff --git a/packages/web/src/content/docs/fr/acp.mdx b/packages/web/src/content/docs/fr/acp.mdx index d23d10359..81254d479 100644 --- a/packages/web/src/content/docs/fr/acp.mdx +++ b/packages/web/src/content/docs/fr/acp.mdx @@ -1,9 +1,9 @@ --- -title: ACP Assistance +title: Support ACP description: Utilisez OpenCode dans n’importe quel éditeur compatible ACP. --- -OpenCode prend en charge le [Agent Client Protocol](https://agentclientprotocol.com) ou (ACP), vous permettant de l'utiliser directement dans les éditeurs et IDE compatibles. +OpenCode prend en charge le [Agent Client Protocol](https://agentclientprotocol.com) (ACP), vous permettant de l'utiliser directement dans les éditeurs et IDE compatibles. :::tip Pour obtenir une liste des éditeurs et des outils prenant en charge ACP, consultez le [ACP progress report](https://zed.dev/blog/acp-progress-report#available-now). @@ -13,11 +13,11 @@ ACP est un protocole ouvert qui standardise la communication entre les éditeurs --- -## Configurer +## Configuration Pour utiliser OpenCode via ACP, configurez votre éditeur pour exécuter la commande `opencode acp`. -La commande démarre OpenCode en tant que sous-processus compatible ACP qui communique avec votre éditeur via JSON-RPC via stdio. +La commande démarre OpenCode en tant que sous-processus compatible ACP qui communique avec votre éditeur via JSON-RPC sur stdio. Vous trouverez ci-dessous des exemples d'éditeurs populaires prenant en charge ACP. @@ -25,7 +25,7 @@ Vous trouverez ci-dessous des exemples d'éditeurs populaires prenant en charge ### Zed -Ajoutez à votre configuration [Zed](https://zed.dev) (`~/.config/zed/settings.json`) : +Ajoutez à votre configuration [Zed](https://zed.dev) (`~/.config/zed/settings.json`) : ```json title="~/.config/zed/settings.json" { @@ -40,7 +40,7 @@ Ajoutez à votre configuration [Zed](https://zed.dev) (`~/.config/zed/settings.j Pour l'ouvrir, utilisez l'action `agent: new thread` dans la **Palette de commandes**. -Vous pouvez également associer un raccourci clavier en modifiant votre `keymap.json` : +Vous pouvez également associer un raccourci clavier en modifiant votre `keymap.json` : ```json title="keymap.json" [ @@ -69,7 +69,7 @@ Vous pouvez également associer un raccourci clavier en modifiant votre `keymap. ### IDE JetBrains -Ajoutez à votre [JetBrains IDE](https://www.jetbrains.com/) acp.json conformément à la [documentation](https://www.jetbrains.com/help/ai-assistant/acp.html) : +Ajoutez `acp.json` à votre [IDE JetBrains](https://www.jetbrains.com/) conformément à la [documentation](https://www.jetbrains.com/help/ai-assistant/acp.html) : ```json title="acp.json" { @@ -88,7 +88,7 @@ Pour l'ouvrir, utilisez le nouvel agent « OpenCode » dans le sélecteur d'agen ### Avante.nvim -Ajoutez à votre configuration [Avante.nvim](https://github.com/yetone/avante.nvim) : +Ajoutez à votre configuration [Avante.nvim](https://github.com/yetone/avante.nvim) : ```lua { @@ -101,7 +101,7 @@ Ajoutez à votre configuration [Avante.nvim](https://github.com/yetone/avante.nv } ``` -Si vous devez transmettre des variables d'environnement : +Si vous devez transmettre des variables d'environnement : ```lua {6-8} { @@ -121,7 +121,7 @@ Si vous devez transmettre des variables d'environnement : ### CodeCompanion.nvim -Pour utiliser OpenCode comme agent ACP dans [CodeCompanion.nvim](https://github.com/olimorris/codecompanion.nvim), ajoutez ce qui suit à votre configuration Neovim : +Pour utiliser OpenCode comme agent ACP dans [CodeCompanion.nvim](https://github.com/olimorris/codecompanion.nvim), ajoutez ce qui suit à votre configuration Neovim : ```lua require("codecompanion").setup({ @@ -138,11 +138,11 @@ require("codecompanion").setup({ Cette configuration configure CodeCompanion pour utiliser OpenCode comme agent ACP pour le chat. -Si vous devez transmettre des variables d'environnement (comme `OPENCODE_API_KEY`), reportez-vous à [Configuration des adaptateurs : variables d'environnement ](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) dans la documentation CodeCompanion.nvim pour plus de détails. +Si vous devez transmettre des variables d'environnement (comme `OPENCODE_API_KEY`), reportez-vous à [Configuring Adapters: Environment Variables](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) dans la documentation CodeCompanion.nvim pour plus de détails. -## Soutien +## Prise en charge -OpenCode fonctionne de la même manière via ACP que dans le terminal. Toutes les fonctionnalités sont prises en charge : +OpenCode fonctionne de la même manière via ACP que dans le terminal. Toutes les fonctionnalités sont prises en charge : :::note Certaines commandes slash intégrées telles que `/undo` et `/redo` ne sont actuellement pas prises en charge. diff --git a/packages/web/src/content/docs/fr/agents.mdx b/packages/web/src/content/docs/fr/agents.mdx index 13ab9c389..b18d33539 100644 --- a/packages/web/src/content/docs/fr/agents.mdx +++ b/packages/web/src/content/docs/fr/agents.mdx @@ -3,7 +3,7 @@ title: Agents description: Configurez et utilisez des agents spécialisés. --- -Les agents sont des assistants IA spécialisés qui peuvent être configurés pour des tâches et des flux de travail spécifiques. Ils vous permettent de créer des outils ciblés avec des invites, des modèles et un accès aux outils personnalisés. +Les agents sont des assistants IA spécialisés qui peuvent être configurés pour des tâches et des flux de travail spécifiques. Ils vous permettent de créer des outils ciblés avec des prompts, des modèles et un accès aux outils personnalisés. :::tip Utilisez l'agent de plan pour analyser le code et examiner les suggestions sans apporter de modifications au code. @@ -15,68 +15,68 @@ Vous pouvez basculer entre les agents au cours d'une session ou les appeler avec ## Types -Il existe deux types d'agents dans OpenCode ; agents primaires et sous-agents. +Il existe deux types d'agents dans OpenCode ; agents primaires et sous-agents. --- ### Agents primaires -Les agents principaux sont les principaux assistants avec lesquels vous interagissez directement. Vous pouvez les parcourir à l'aide de la touche **Tab** ou de votre combinaison de touches `switch_agent` configurée. Ces agents gèrent votre conversation principale. L'accès aux outils est configuré via les autorisations : par exemple, Build a tous les outils activés tandis que Plan est restreint. +Les agents primaires sont les principaux assistants avec lesquels vous interagissez directement. Vous pouvez les parcourir à l'aide de la touche **Tab** ou de votre combinaison de touches `switch_agent` configurée. Ces agents gèrent votre conversation principale. L'accès aux outils est configuré via les autorisations : par exemple, Build a tous les outils activés tandis que Plan est restreint. :::tip -Vous pouvez utiliser la touche **Tab** pour basculer entre les agents principaux au cours d'une session. +Vous pouvez utiliser la touche **Tab** pour basculer entre les agents primaires au cours d'une session. ::: -OpenCode est livré avec deux agents principaux intégrés, **Build** et **Plan**. Bien -regardez-les ci-dessous. +OpenCode est livré avec deux agents primaires intégrés, **Build** et **Plan**. +Nous les verrons ci-dessous. --- ### Sous-agents -Les sous-agents sont des assistants spécialisés que les agents principaux peuvent appeler pour des tâches spécifiques. Vous pouvez également les invoquer manuellement en **@ les mentionnant** dans vos messages. +Les sous-agents sont des assistants spécialisés que les agents primaires peuvent appeler pour des tâches spécifiques. Vous pouvez également les invoquer manuellement en **@ les mentionnant** dans vos messages. -OpenCode est livré avec deux sous-agents intégrés, **Général** et **Explore**. Nous verrons cela ci-dessous. +OpenCode est livré avec deux sous-agents intégrés, **General** et **Explore**. Nous verrons cela ci-dessous. --- -## Intégré +## Agents intégrés -OpenCode est livré avec deux agents principaux intégrés et deux sous-agents intégrés. +OpenCode est livré avec deux agents primaires intégrés et deux sous-agents intégrés. --- -### Utiliser Build +### Agent Build _Mode_ : `primary` -Build est l'agent principal **par défaut** avec tous les outils activés. Il s'agit de l'agent standard pour les travaux de développement où vous avez besoin d'un accès complet aux opérations sur les fichiers et aux commandes système. +Build est l'agent primaire **par défaut** avec tous les outils activés. Il s'agit de l'agent standard pour les travaux de développement où vous avez besoin d'un accès complet aux opérations sur les fichiers et aux commandes système. --- -### Utiliser Plan +### Agent Plan _Mode_ : `primary` Un agent restreint conçu pour la planification et l'analyse. Nous utilisons un système d'autorisation pour vous donner plus de contrôle et empêcher toute modification involontaire. -Par défaut, tous les éléments suivants sont définis sur `ask` : +Par défaut, tous les éléments suivants sont définis sur `ask` : -- `file edits` : toutes les écritures, correctifs et modifications -- `bash` : toutes les commandes bash +- `file edits` : toutes les écritures, correctifs et modifications +- `bash` : toutes les commandes bash -Cet agent est utile lorsque vous souhaitez que LLM analyse le code, suggère des modifications ou crée des plans sans apporter de modifications réelles à votre base de code. +Cet agent est utile lorsque vous souhaitez que le LLM analyse le code, suggère des modifications ou crée des plans sans apporter de modifications réelles à votre base de code. --- -### Utiliser General +### Agent General _Mode_ : `subagent` -Un agent polyvalent pour rechercher des questions complexes et exécuter des tâches en plusieurs étapes. Dispose d'un accès complet aux outils (sauf todo), il peut donc apporter des modifications aux fichiers en cas de besoin. Utilisez-le pour exécuter plusieurs unités de travail en parallèle. +Un agent polyvalent pour traiter des questions complexes et exécuter des tâches en plusieurs étapes. Dispose d'un accès complet aux outils (sauf todo), il peut donc apporter des modifications aux fichiers en cas de besoin. Utilisez-le pour exécuter plusieurs unités de travail en parallèle. --- -### Utiliser Explore +### Agent Explore _Mode_ : `subagent` @@ -84,7 +84,7 @@ Un agent rapide en lecture seule pour explorer les bases de code. Impossible de --- -### Utiliser Compaction +### Agent Compaction _Mode_ : `primary` @@ -92,7 +92,7 @@ Agent système caché qui compacte un contexte long en un résumé plus petit. I --- -### Utiliser Title +### Agent Title _Mode_ : `primary` @@ -100,7 +100,7 @@ Agent système caché qui génère des titres de session courts. Il s'exécute a --- -### Utiliser Summary +### Agent Summary _Mode_ : `primary` @@ -108,19 +108,19 @@ Agent système caché qui crée des résumés de session. Il s'exécute automati --- -## Usage +## Utilisation -1. Pour les agents principaux, utilisez la touche **Tab** pour les parcourir au cours d'une session. Vous pouvez également utiliser votre raccourci clavier `switch_agent` configuré. +1. Pour les agents primaires, utilisez la touche **Tab** pour les parcourir au cours d'une session. Vous pouvez également utiliser votre raccourci clavier `switch_agent` configuré. -2. Les sous-agents peuvent être invoqués : - - **Automatiquement** par les agents principaux pour des tâches spécialisées en fonction de leurs descriptions. - - Manuellement en **@ mentionnant** un sous-agent dans votre message. Par exemple. +2. Les sous-agents peuvent être invoqués : + - **Automatiquement** par les agents primaires pour des tâches spécialisées en fonction de leurs descriptions. + - Manuellement en **@ mentionnant** un sous-agent dans votre message. Par exemple : ```txt frame="none" @general help me search for this function ``` -3. **Navigation entre les sessions** : lorsque les sous-agents créent leurs propres sessions enfants, vous pouvez naviguer entre la session parent et toutes les sessions enfants en utilisant : +3. **Navigation entre les sessions** : lorsque les sous-agents créent leurs propres sessions enfants, vous pouvez naviguer entre la session parent et toutes les sessions enfants en utilisant : - **\+Right** (ou votre combinaison de touches `session_child_cycle` configurée) pour avancer via parent → enfant1 → enfant2 → ... → parent - **\+Left** (ou votre combinaison de touches `session_child_cycle_reverse` configurée) pour revenir en arrière dans parent ← enfant1 ← enfant2 ← ... ← parent @@ -128,15 +128,15 @@ Cela vous permet de basculer en toute transparence entre la conversation princip --- -## Configurer +## Configuration -Vous pouvez personnaliser les agents intégrés ou créer les vôtres via la configuration. Les agents peuvent être configurés de deux manières : +Vous pouvez personnaliser les agents intégrés ou créer les vôtres via la configuration. Les agents peuvent être configurés de deux manières : --- ### JSON -Configurez les agents dans votre fichier de configuration `opencode.json` : +Configurez les agents dans votre fichier de configuration `opencode.json` : ```json title="opencode.json" { @@ -179,10 +179,10 @@ Configurez les agents dans votre fichier de configuration `opencode.json` : ### Markdown -Vous pouvez également définir des agents à l'aide de fichiers markdown. Placez-les dans : +Vous pouvez également définir des agents à l'aide de fichiers markdown. Placez-les dans : - Global : `~/.config/opencode/agents/` -- Par projet : `.opencode/agents/` +- Par projet : `.opencode/agents/` ```markdown title="~/.config/opencode/agents/review.md" --- @@ -253,11 +253,11 @@ Des valeurs faibles rendent les réponses plus ciblées et déterministes, tandi } ``` -Les valeurs de température varient généralement de 0,0 à 1,0 : +Les valeurs de température varient généralement de 0,0 à 1,0 : -- **0,0-0,2** : réponses très ciblées et déterministes, idéales pour l'analyse et la planification du code -- **0,3-0,5** : réponses équilibrées avec une certaine créativité, idéales pour les tâches de développement générales -- **0,6-1,0** : réponses plus créatives et variées, utiles pour le brainstorming et l'exploration +- **0,0-0,2** : réponses très ciblées et déterministes, idéales pour l'analyse et la planification du code +- **0,3-0,5** : réponses équilibrées avec une certaine créativité, idéales pour les tâches de développement générales +- **0,6-1,0** : réponses plus créatives et variées, utiles pour le brainstorming et l'exploration ```json title="opencode.json" { @@ -277,13 +277,13 @@ Les valeurs de température varient généralement de 0,0 à 1,0 : } ``` -Si aucune température n'est spécifiée, OpenCode utilise les valeurs par défaut spécifiques au modèle ; généralement 0 pour la plupart des modèles, 0,55 pour les modèles Qwen. +Si aucune température n'est spécifiée, OpenCode utilise les valeurs par défaut spécifiques au modèle ; généralement 0 pour la plupart des modèles, 0,55 pour les modèles Qwen. --- -### Pas maximum +### Étapes maximum -Contrôlez le nombre maximum d'itérations agents qu'un agent peut effectuer avant d'être obligé de répondre avec du texte uniquement. Cela permet aux utilisateurs qui souhaitent contrôler les coûts de fixer une limite aux actions agents. +Contrôlez le nombre maximum d'itérations que l'agent peut effectuer avant d'être obligé de répondre avec du texte uniquement. Cela permet aux utilisateurs qui souhaitent contrôler les coûts de fixer une limite aux actions agents. Si cela n'est pas défini, l'agent continuera à itérer jusqu'à ce que le modèle choisisse de s'arrêter ou que l'utilisateur interrompe la session. @@ -299,7 +299,7 @@ Si cela n'est pas défini, l'agent continuera à itérer jusqu'à ce que le mod } ``` -Lorsque la limite est atteinte, l'agent reçoit une invite système spéciale lui demandant de répondre avec un résumé de son travail et des tâches restantes recommandées. +Lorsque la limite est atteinte, l'agent reçoit un prompt système spécial lui demandant de répondre avec un résumé de son travail et des tâches restantes recommandées. :::caution L’ancien champ `maxSteps` est obsolète. Utilisez plutôt `steps`. @@ -323,9 +323,9 @@ Définissez sur `true` pour désactiver l'agent. --- -### Prompt +### Invite -Spécifiez un fichier d'invite système personnalisé pour cet agent avec la configuration `prompt`. Le fichier d'invite doit contenir des instructions spécifiques à l'objectif de l'agent. +Spécifiez un fichier de prompt système personnalisé pour cet agent avec la configuration `prompt`. Le fichier de prompt doit contenir des instructions spécifiques à l'objectif de l'agent. ```json title="opencode.json" { @@ -346,7 +346,7 @@ Ce chemin est relatif à l'emplacement du fichier de configuration. Cela fonctio Utilisez la configuration `model` pour remplacer le modèle de cet agent. Utile pour utiliser différents modèles optimisés pour différentes tâches. Par exemple, un modèle de planification plus rapide, un modèle de mise en œuvre plus performant. :::tip -Si vous ne spécifiez pas de modèle, les agents principaux utilisent le [modèle globalement configuré](/docs/config#models) tandis que les sous-agents utiliseront le modèle de l'agent principal qui a appelé le sous-agent. +Si vous ne spécifiez pas de modèle, les agents primaires utilisent le [modèle globalement configuré](/docs/config#models) tandis que les sous-agents utiliseront le modèle de l'agent primaire qui a appelé le sous-agent. ::: ```json title="opencode.json" @@ -389,7 +389,7 @@ Contrôlez quels outils sont disponibles dans cet agent avec la configuration `t La configuration spécifique à l'agent remplace la configuration globale. ::: -Vous pouvez également utiliser des caractères génériques pour contrôler plusieurs outils à la fois. Par exemple, pour désactiver tous les outils d'un serveur MCP : +Vous pouvez également utiliser des caractères génériques pour contrôler plusieurs outils à la fois. Par exemple, pour désactiver tous les outils d'un serveur MCP : ```json title="opencode.json" { @@ -412,11 +412,11 @@ Vous pouvez également utiliser des caractères génériques pour contrôler plu ### Autorisations -Vous pouvez configurer des autorisations pour gérer les actions qu'un agent peut effectuer. Actuellement, les autorisations pour les outils `edit`, `bash` et `webfetch` peuvent être configurées pour : +Vous pouvez configurer des autorisations pour gérer les actions qu'un agent peut effectuer. Actuellement, les autorisations pour les outils `edit`, `bash` et `webfetch` peuvent être configurées pour : - `"ask"` — Demander l'approbation avant d'exécuter l'outil - `"allow"` — Autoriser toutes les opérations sans approbation -- `"deny"` – Désactiver l'outil +- `"deny"` – Désactiver l'outil ```json title="opencode.json" { @@ -482,7 +482,7 @@ Vous pouvez définir des autorisations pour des commandes bash spécifiques. } ``` -Cela peut prendre un modèle global. +Cela peut prendre un pattern glob. ```json title="opencode.json" {7} { @@ -540,7 +540,7 @@ L'option `mode` peut être définie sur `primary`, `subagent` ou `all`. Si aucun --- -### Caché +### Masqué Masquez un sous-agent du menu de saisie semi-automatique `@` avec `hidden: true`. Utile pour les sous-agents internes qui ne doivent être invoqués que par programme par d'autres agents via l'outil Tâche. @@ -565,7 +565,7 @@ S'applique uniquement aux agents `mode: subagent`. ### Autorisations de tâches -Contrôlez quels sous-agents un agent peut appeler via l'outil Tâche avec `permission.task`. Utilise des modèles globaux pour une correspondance flexible. +Contrôlez quels sous-agents un agent peut appeler via l'outil Tâche avec `permission.task`. Utilise des patterns glob pour une correspondance flexible. ```json title="opencode.json" { @@ -600,7 +600,7 @@ Les utilisateurs peuvent toujours appeler n'importe quel sous-agent directement Personnalisez l'apparence visuelle de l'agent dans l'interface utilisateur avec l'option `color`. Cela affecte la façon dont l'agent apparaît dans l'interface. -Utilisez une couleur hexadécimale valide (par exemple, `#FF5733`) ou une couleur de thème : `primary`, `secondary`, `accent`, `success`, `warning`, `error`, `info`. +Utilisez une couleur hexadécimale valide (par exemple, `#FF5733`) ou une couleur de thème : `primary`, `secondary`, `accent`, `success`, `warning`, `error`, `info`. ```json title="opencode.json" { @@ -635,11 +635,11 @@ Les valeurs vont de 0,0 à 1,0. Les valeurs inférieures sont plus ciblées, les --- -### Supplémentaire +### Options supplémentaires Toutes les autres options que vous spécifiez dans la configuration de votre agent seront **transmises directement** au fournisseur en tant qu'options de modèle. Cela vous permet d'utiliser des fonctionnalités et des paramètres spécifiques au fournisseur. -Par exemple, avec les modèles de raisonnement de OpenAI, vous pouvez contrôler l'effort de raisonnement : +Par exemple, avec les modèles de raisonnement d'OpenAI, vous pouvez contrôler l'effort de raisonnement : ```json title="opencode.json" {6,7} { @@ -662,21 +662,21 @@ Exécutez `opencode models` pour voir une liste des modèles disponibles. --- -## Créer des agents +## Création d'agents -Vous pouvez créer de nouveaux agents à l'aide de la commande suivante : +Vous pouvez créer de nouveaux agents à l'aide de la commande suivante : ```bash opencode agent create ``` -Cette commande interactive va : +Cette commande interactive va : -1. Demandez où enregistrer l'agent ; global ou spécifique à un projet. -2. Description de ce que l'agent doit faire. -3. Générez une invite système et un identifiant appropriés. -4. Vous permet de sélectionner les outils auxquels l'agent peut accéder. -5. Enfin, créez un fichier markdown avec la configuration de l'agent. +1. Demander où enregistrer l'agent ; global ou spécifique à un projet. +2. Demander une description de ce que l'agent doit faire. +3. Générer un prompt système et un identifiant appropriés. +4. Vous permettre de sélectionner les outils auxquels l'agent peut accéder. +5. Enfin, créer un fichier markdown avec la configuration de l'agent. --- @@ -684,11 +684,11 @@ Cette commande interactive va : Voici quelques cas d’utilisation courants pour différents agents. -- **Agent de build** : travail de développement complet avec tous les outils activés -- **Agent de plan** : analyse et planification sans apporter de modifications -- **Agent de révision** : révision de code avec accès en lecture seule et outils de documentation -- **Agent de débogage** : axé sur l'investigation avec les outils bash et read activés -- **Agent Docs** : écriture de documentation avec des opérations sur les fichiers mais pas de commandes système +- **Agent de build** : travail de développement complet avec tous les outils activés +- **Agent de plan** : analyse et planification sans apporter de modifications +- **Agent de révision** : révision de code avec accès en lecture seule et outils de documentation +- **Agent de débogage** : axé sur l'investigation avec les outils bash et read activés +- **Agent Docs** : écriture de documentation avec des opérations sur les fichiers mais pas de commandes système --- diff --git a/packages/web/src/content/docs/fr/cli.mdx b/packages/web/src/content/docs/fr/cli.mdx index 53ce851cc..8773d941f 100644 --- a/packages/web/src/content/docs/fr/cli.mdx +++ b/packages/web/src/content/docs/fr/cli.mdx @@ -1,6 +1,6 @@ --- title: CLI -description: Options et commandes CLI OpenCode. +description: Options et commandes de la CLI OpenCode. --- import { Tabs, TabItem } from "@astrojs/starlight/components" @@ -11,7 +11,7 @@ La CLI OpenCode démarre par défaut le [TUI](/docs/tui) lorsqu'il est exécuté opencode ``` -Mais il accepte également les commandes documentées sur cette page. Cela vous permet d'interagir avec OpenCode par programme. +Mais elle accepte également les commandes documentées sur cette page. Cela vous permet d'interagir avec OpenCode par programme. ```bash opencode run "Explain how closures work in JavaScript" @@ -27,18 +27,18 @@ Démarrez l’interface utilisateur du terminal OpenCode. opencode [project] ``` -#### Drapeaux +#### Options -| Drapeau | Court | Descriptif | +| Option | Court | Description | | ------------ | ----- | ----------------------------------------------------------------------------- | -| `--continue` | `-c` | Continuer la dernière séance | +| `--continue` | `-c` | Continuer la dernière session | | `--session` | `-s` | ID de session pour continuer | | `--fork` | | Forker la session en continuant (à utiliser avec `--continue` ou `--session`) | -| `--prompt` | | Invite à utiliser | +| `--prompt` | | Prompt à utiliser | | `--model` | `-m` | Modèle à utiliser sous forme de fournisseur/modèle | | `--agent` | | Agent à utiliser | -| `--port` | | Port à écouter sur | -| `--hostname` | | Nom d'hôte sur lequel écouter | +| `--port` | | Port d'écoute | +| `--hostname` | | Nom d'hôte d'écoute | --- @@ -66,7 +66,7 @@ Attachez un terminal à un serveur backend OpenCode déjà en cours d'exécution opencode attach [url] ``` -Cela permet d'utiliser le TUI avec un backend OpenCode distant. Par exemple: +Cela permet d'utiliser le TUI avec un backend OpenCode distant. Par exemple : ```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 ``` -#### Drapeaux +#### Options -| Drapeau | Court | Descriptif | +| Option | Court | Description | | ----------- | ----- | ---------------------------------------------- | | `--dir` | | Répertoire de travail dans lequel démarrer TUI | | `--session` | `-s` | ID de session pour continuer | @@ -93,13 +93,13 @@ Créez un nouvel agent avec une configuration personnalisée. opencode agent create ``` -Cette commande vous guidera dans la création d'un nouvel agent avec une invite système personnalisée et une configuration d'outil. +Cette commande vous guidera dans la création d'un nouvel agent avec un prompt système personnalisé et une configuration d'outils. --- #### list -Répertoriez tous les agents disponibles. +Liste tous les agents disponibles. ```bash opencode agent list @@ -125,13 +125,13 @@ OpenCode est alimenté par la liste des fournisseurs sur [Models.dev](https://mo opencode auth login ``` -Lorsque OpenCode démarre, il charge les fournisseurs à partir du fichier d'informations d'identification. Et s'il y a des clés définies dans vos environnements ou un fichier `.env` dans votre projet. +Lorsque OpenCode démarre, il charge les fournisseurs à partir du fichier d'informations d'identification, ainsi que les clés définies dans vos environnements ou un fichier `.env` dans votre projet. --- #### list -Répertorie tous les fournisseurs authentifiés tels qu'ils sont stockés dans le fichier d'informations d'identification. +Liste tous les fournisseurs authentifiés tels qu'ils sont stockés dans le fichier d'informations d'identification. ```bash opencode auth list @@ -157,7 +157,7 @@ opencode auth logout ### github -Gérez l'agent GitHub pour l'automatisation du référentiel. +Gérez l'agent GitHub pour l'automatisation du dépôt. ```bash opencode github [command] @@ -167,7 +167,7 @@ opencode github [command] #### install -Installez l'agent GitHub dans votre référentiel. +Installez l'agent GitHub dans votre dépôt. ```bash opencode github install @@ -185,9 +185,9 @@ Exécutez l'agent GitHub. Ceci est généralement utilisé dans les GitHub Actio opencode github run ``` -##### Drapeaux +##### Options -| Drapeau | Descriptif | +| Option | Description | | --------- | ---------------------------------------------------- | | `--event` | Événement simulé GitHub pour lequel exécuter l'agent | | `--token` | Jeton d'accès personnel GitHub | @@ -218,7 +218,7 @@ Cette commande vous guidera dans l’ajout d’un serveur MCP local ou distant. #### list -Répertoriez tous les serveurs MCP configurés et leur état de connexion. +Liste tous les serveurs MCP configurés et leur état de connexion. ```bash opencode mcp list @@ -278,7 +278,7 @@ opencode mcp debug ### models -Répertoriez tous les modèles disponibles auprès des fournisseurs configurés. +Liste tous les modèles disponibles auprès des fournisseurs configurés. ```bash opencode models [provider] @@ -294,14 +294,14 @@ Vous pouvez éventuellement transmettre un ID de fournisseur pour filtrer les mo opencode models anthropic ``` -#### Drapeaux +#### Options -| Drapeau | Descriptif | +| Option | Description | | ----------- | ------------------------------------------------------------------------------------------ | | `--refresh` | Actualisez le cache des modèles à partir de models.dev | | `--verbose` | Utiliser une sortie de modèle plus détaillée (inclut des métadonnées telles que les coûts) | -Utilisez l'indicateur `--refresh` pour mettre à jour la liste des modèles mis en cache. Ceci est utile lorsque de nouveaux modèles ont été ajoutés à un fournisseur et que vous souhaitez les voir dans OpenCode. +Utilisez l'option `--refresh` pour mettre à jour la liste des modèles mis en cache. Ceci est utile lorsque de nouveaux modèles ont été ajoutés à un fournisseur et que vous souhaitez les voir dans OpenCode. ```bash opencode models --refresh @@ -311,19 +311,19 @@ opencode models --refresh ### run -Exécutez opencode en mode non interactif en transmettant directement une invite. +Exécutez opencode en mode non interactif en transmettant directement un prompt. ```bash opencode run [message..] ``` -Ceci est utile pour les scripts, l'automatisation ou lorsque vous souhaitez une réponse rapide sans lancer le TUI complet. Par exemple. +Ceci est utile pour les scripts, l'automatisation ou lorsque vous souhaitez une réponse rapide sans lancer le TUI complet. Par exemple : ```bash "opencode run" opencode run Explain the use of context in Go ``` -Vous pouvez également vous connecter à une instance `opencode serve` en cours d'exécution pour éviter les temps de démarrage à froid du serveur MCP à chaque exécution : +Vous pouvez également vous connecter à une instance `opencode serve` en cours d'exécution pour éviter les temps de démarrage à froid du serveur MCP à chaque exécution : ```bash # Start a headless server in one terminal @@ -333,20 +333,20 @@ opencode serve opencode run --attach http://localhost:4096 "Explain async/await in JavaScript" ``` -#### Drapeaux +#### Options -| Drapeau | Court | Descriptif | +| Option | Court | Description | | ------------ | ----- | ---------------------------------------------------------------------------------------------- | -| `--command` | | La commande à exécuter, utilisez message pour args | -| `--continue` | `-c` | Continuer la dernière séance | +| `--command` | | La commande à exécuter, utilisez le message pour les arguments | +| `--continue` | `-c` | Continuer la dernière session | | `--session` | `-s` | ID de session pour continuer | | `--fork` | | Forker la session en continuant (à utiliser avec `--continue` ou `--session`) | -| `--share` | | Partager la séance | +| `--share` | | Partager la session | | `--model` | `-m` | Modèle à utiliser sous forme de fournisseur/modèle | | `--agent` | | Agent à utiliser | | `--file` | `-f` | Fichier(s) à joindre au message | -| `--format` | | Format : par défaut (formaté) ou json (événements JSON bruts) | -| `--title` | | Titre de la session (utilise une invite tronquée si aucune valeur n'est fournie) | +| `--format` | | Format : par défaut (formaté) ou json (événements JSON bruts) | +| `--title` | | Titre de la session (utilise un prompt tronqué si aucune valeur n'est fournie) | | `--attach` | | Connectez-vous à un serveur opencode en cours d'exécution (par exemple, http://localhost:4096) | | `--port` | | Port du serveur local (port aléatoire par défaut) | @@ -354,20 +354,20 @@ opencode run --attach http://localhost:4096 "Explain async/await in JavaScript" ### serve -Démarrez un serveur OpenCode sans tête pour un accès API. Consultez le [serveur docs](/docs/server) pour l'interface complète HTTP. +Démarrez un serveur OpenCode sans interface graphique pour un accès API. Consultez le [serveur docs](/docs/server) pour l'interface complète HTTP. ```bash opencode serve ``` -Cela démarre un serveur HTTP qui fournit à API un accès à la fonctionnalité opencode sans l'interface TUI. Définissez `OPENCODE_SERVER_PASSWORD` pour activer l'authentification de base HTTP (le nom d'utilisateur par défaut est `opencode`). +Cela démarre un serveur HTTP qui fournit un accès API aux fonctionnalités d'OpenCode sans l'interface TUI. Définissez `OPENCODE_SERVER_PASSWORD` pour activer l'authentification de base HTTP (le nom d'utilisateur par défaut est `opencode`). -#### Drapeaux +#### Options -| Drapeau | Descriptif | +| Option | Description | | ------------ | ---------------------------------------------------------- | -| `--port` | Port à écouter sur | -| `--hostname` | Nom d'hôte sur lequel écouter | +| `--port` | Port d'écoute | +| `--hostname` | Nom d'hôte d'écoute | | `--mdns` | Activer la découverte mDNS | | `--cors` | Origines de navigateur supplémentaires pour autoriser CORS | @@ -385,18 +385,18 @@ opencode session [command] #### list -Répertoriez toutes les sessions OpenCode. +Liste toutes les sessions OpenCode. ```bash opencode session list ``` -##### Drapeaux +##### Options -| Drapeau | Court | Descriptif | +| Option | Court | Description | | ------------- | ----- | -------------------------------------------- | | `--max-count` | `-n` | Limiter aux N sessions les plus récentes | -| `--format` | | Format de sortie : tableau ou json (tableau) | +| `--format` | | Format de sortie : tableau ou json (tableau) | --- @@ -408,20 +408,20 @@ Affichez les statistiques d'utilisation et de coût des jetons pour vos sessions opencode stats ``` -#### Drapeaux +#### Options -| Drapeau | Descriptif | -| ----------- | ------------------------------------------------------------------------------------------------------------------- | -| `--days` | Afficher les statistiques des N derniers jours (tous les temps) | -| `--tools` | Nombre d'outils à afficher (tous) | -| `--models` | Afficher la répartition de l'utilisation du modèle (masqué par défaut). Passez un numéro pour afficher le premier N | -| `--project` | Filtrer par projet (tous les projets, chaîne vide : projet en cours) | +| Option | Description | +| ----------- | --------------------------------------------------------------------------------------------------------------------- | +| `--days` | Afficher les statistiques des N derniers jours (depuis le début) | +| `--tools` | Nombre d'outils à afficher (tous) | +| `--models` | Afficher la répartition de l'utilisation du modèle (masqué par défaut). Passez un numéro pour afficher les N premiers | +| `--project` | Filtrer par projet (tous les projets, chaîne vide : projet actuel) | --- ### export -Exportez les données de session sous JSON. +Exportez les données de session au format JSON. ```bash opencode export [sessionID] @@ -433,13 +433,13 @@ Si vous ne fournissez pas d'ID de session, vous serez invité à sélectionner p ### import -Importez les données de session à partir d'un fichier JSON ou d'un partage OpenCode URL. +Importez les données de session à partir d'un fichier JSON ou d'une URL de partage OpenCode. ```bash opencode import ``` -Vous pouvez importer à partir d'un fichier local ou d'un partage OpenCode URL. +Vous pouvez importer à partir d'un fichier local ou d'une URL de partage OpenCode. ```bash opencode import session.json @@ -450,7 +450,7 @@ opencode import https://opncd.ai/s/abc123 ### web -Démarrez un serveur OpenCode sans tête avec une interface Web. +Démarrez un serveur OpenCode sans interface graphique avec une interface Web. ```bash opencode web @@ -458,12 +458,12 @@ opencode web Cela démarre un serveur HTTP et ouvre un navigateur Web pour accéder à OpenCode via une interface Web. Définissez `OPENCODE_SERVER_PASSWORD` pour activer l'authentification de base HTTP (le nom d'utilisateur par défaut est `opencode`). -#### Drapeaux +#### Options -| Drapeau | Descriptif | +| Option | Description | | ------------ | ---------------------------------------------------------- | -| `--port` | Port à écouter sur | -| `--hostname` | Nom d'hôte sur lequel écouter | +| `--port` | Port d'écoute | +| `--hostname` | Nom d'hôte d'écoute | | `--mdns` | Activer la découverte mDNS | | `--cors` | Origines de navigateur supplémentaires pour autoriser CORS | @@ -479,13 +479,13 @@ opencode acp Cette commande démarre un serveur ACP qui communique via stdin/stdout en utilisant nd-JSON. -#### Drapeaux +#### Options -| Drapeau | Descriptif | -| ------------ | ----------------------------- | -| `--cwd` | Répertoire de travail | -| `--port` | Port à écouter sur | -| `--hostname` | Nom d'hôte sur lequel écouter | +| Option | Description | +| ------------ | --------------------- | +| `--cwd` | Répertoire de travail | +| `--port` | Port d'écoute | +| `--hostname` | Nom d'hôte d'écoute | --- @@ -497,9 +497,9 @@ Désinstallez OpenCode et supprimez tous les fichiers associés. opencode uninstall ``` -#### Drapeaux +#### Options -| Drapeau | Court | Descriptif | +| Option | Court | Description | | --------------- | ----- | --------------------------------------------------- | | `--keep-config` | `-c` | Conserver les fichiers de configuration | | `--keep-data` | `-d` | Conserver les données de session et les instantanés | @@ -528,24 +528,24 @@ Pour passer à une version spécifique. opencode upgrade v0.1.48 ``` -#### Drapeaux +#### Options -| Drapeau | Court | Descriptif | +| Option | Court | Description | | ---------- | ----- | --------------------------------------------------------------- | -| `--method` | `-m` | La méthode d'installation utilisée ; curl, npm, pnpm, bun, brew | +| `--method` | `-m` | La méthode d'installation utilisée ; curl, npm, pnpm, bun, brew | --- -## Drapeaux globaux +## Options globales -La CLI opencode prend les indicateurs globaux suivants. +La CLI opencode prend les flags globaux suivants. -| Drapeau | Court | Descriptif | -| -------------- | ----- | --------------------------------------------------- | -| `--help` | `-h` | Afficher l'aide | -| `--version` | `-v` | Imprimer le numéro de version | -| `--print-logs` | | Imprimer les journaux sur stderr | -| `--log-level` | | Niveau de journalisation (DEBUG, INFO, WARN, ERROR) | +| Option | Court | Description | +| -------------- | ----- | ---------------------------------------- | +| `--help` | `-h` | Afficher l'aide | +| `--version` | `-v` | Afficher le numéro de version | +| `--print-logs` | | Afficher les logs sur stderr | +| `--log-level` | | Niveau de log (DEBUG, INFO, WARN, ERROR) | --- @@ -553,7 +553,7 @@ La CLI opencode prend les indicateurs globaux suivants. OpenCode peut être configuré à l'aide de variables d'environnement. -| Variables | Type | Descriptif | +| Variables | Type | Description | | ------------------------------------- | ------- | --------------------------------------------------------------------------------- | | `OPENCODE_AUTO_SHARE` | booléen | Partager automatiquement des sessions | | `OPENCODE_GIT_BASH_PATH` | chaîne | Chemin vers l'exécutable Git Bash sur Windows | @@ -561,14 +561,14 @@ OpenCode peut être configuré à l'aide de variables d'environnement. | `OPENCODE_CONFIG_DIR` | chaîne | Chemin d'accès au répertoire de configuration | | `OPENCODE_CONFIG_CONTENT` | chaîne | Contenu de configuration JSON en ligne | | `OPENCODE_DISABLE_AUTOUPDATE` | booléen | Désactiver les vérifications automatiques des mises à jour | -| `OPENCODE_DISABLE_PRUNE` | booléen | Désactiver l'élagage des anciennes données | +| `OPENCODE_DISABLE_PRUNE` | booléen | Désactiver le nettoyage des anciennes données | | `OPENCODE_DISABLE_TERMINAL_TITLE` | booléen | Désactiver les mises à jour automatiques des titres du terminal | | `OPENCODE_PERMISSION` | chaîne | Configuration des autorisations JSON intégrées | | `OPENCODE_DISABLE_DEFAULT_PLUGINS` | booléen | Désactiver les plugins par défaut | | `OPENCODE_DISABLE_LSP_DOWNLOAD` | booléen | Désactiver les téléchargements automatiques du serveur LSP | | `OPENCODE_ENABLE_EXPERIMENTAL_MODELS` | booléen | Activer les modèles expérimentaux | | `OPENCODE_DISABLE_AUTOCOMPACT` | booléen | Désactiver le compactage automatique du contexte | -| `OPENCODE_DISABLE_CLAUDE_CODE` | booléen | Désactiver la lecture de `.claude` (invite + compétences) | +| `OPENCODE_DISABLE_CLAUDE_CODE` | booléen | Désactiver la lecture de `.claude` (prompt + compétences) | | `OPENCODE_DISABLE_CLAUDE_CODE_PROMPT` | booléen | Désactiver la lecture `~/.claude/CLAUDE.md` | | `OPENCODE_DISABLE_CLAUDE_CODE_SKILLS` | booléen | Désactiver le chargement de `.claude/skills` | | `OPENCODE_DISABLE_MODELS_FETCH` | booléen | Désactiver la récupération de modèles à partir de sources distantes | @@ -586,18 +586,18 @@ OpenCode peut être configuré à l'aide de variables d'environnement. Ces variables d'environnement activent des fonctionnalités expérimentales qui peuvent être modifiées ou supprimées. -| Variables | Type | Descriptif | +| Variables | Type | Description | | ----------------------------------------------- | ------- | --------------------------------------------------------------- | | `OPENCODE_EXPERIMENTAL` | booléen | Activer toutes les fonctionnalités expérimentales | | `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | booléen | Activer la découverte d'icônes | | `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | booléen | Désactiver la copie lors de la sélection dans TUI | -| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | numéro | Délai d'expiration par défaut pour les commandes bash dans ms | +| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | numéro | Délai d'expiration par défaut pour les commandes bash en ms | | `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | numéro | Nombre maximum de jetons de sortie pour les réponses LLM | | `OPENCODE_EXPERIMENTAL_FILEWATCHER` | booléen | Activer l'observateur de fichiers pour l'ensemble du répertoire | | `OPENCODE_EXPERIMENTAL_OXFMT` | booléen | Activer le formateur oxfmt | | `OPENCODE_EXPERIMENTAL_LSP_TOOL` | booléen | Activer l'outil expérimental LSP | | `OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER` | booléen | Désactiver l'observateur de fichiers | | `OPENCODE_EXPERIMENTAL_EXA` | booléen | Activer les fonctionnalités Exa expérimentales | -| `OPENCODE_EXPERIMENTAL_LSP_TY` | booléen | Activer la vérification expérimentale du type LSP | +| `OPENCODE_EXPERIMENTAL_LSP_TY` | booléen | Activer la vérification expérimentale de type LSP | | `OPENCODE_EXPERIMENTAL_MARKDOWN` | booléen | Activer les fonctionnalités Markdown expérimentales | | `OPENCODE_EXPERIMENTAL_PLAN_MODE` | booléen | Activer le mode plan | diff --git a/packages/web/src/content/docs/fr/commands.mdx b/packages/web/src/content/docs/fr/commands.mdx index cb7e667ad..71e03342e 100644 --- a/packages/web/src/content/docs/fr/commands.mdx +++ b/packages/web/src/content/docs/fr/commands.mdx @@ -3,7 +3,7 @@ title: Commandes description: Créez des commandes personnalisées pour les tâches répétitives. --- -Les commandes personnalisées vous permettent de spécifier une invite que vous souhaitez exécuter lorsque cette commande est exécutée dans TUI. +Les commandes personnalisées vous permettent de spécifier un prompt que vous souhaitez exécuter lorsque cette commande est exécutée dans le TUI. ```bash frame="none" /my-command @@ -17,7 +17,7 @@ Les commandes personnalisées s'ajoutent aux commandes intégrées telles que `/ Créez des fichiers markdown dans le répertoire `commands/` pour définir des commandes personnalisées. -Créez `.opencode/commands/test.md` : +Créez `.opencode/commands/test.md` : ```md title=".opencode/commands/test.md" --- @@ -30,7 +30,7 @@ Run the full test suite with coverage report and show any failures. Focus on the failing tests and suggest fixes. ``` -Le frontmatter définit les propriétés de la commande. Le contenu devient le modèle. +Le frontmatter définit les propriétés de la commande. Le contenu devient le modèle (template). Utilisez la commande en tapant `/` suivi du nom de la commande. @@ -40,7 +40,7 @@ Utilisez la commande en tapant `/` suivi du nom de la commande. --- -## Configurer +## Configuration Vous pouvez ajouter des commandes personnalisées via la configuration OpenCode ou en créant des fichiers markdown dans le répertoire `commands/`. @@ -48,7 +48,7 @@ Vous pouvez ajouter des commandes personnalisées via la configuration OpenCode ### JSON -Utilisez l'option `command` dans votre OpenCode [config](/docs/config) : +Utilisez l'option `command` dans votre OpenCode [config](/docs/config) : ```json title="opencode.jsonc" {4-12} { @@ -67,7 +67,7 @@ Utilisez l'option `command` dans votre OpenCode [config](/docs/config) : } ``` -Vous pouvez maintenant exécuter cette commande dans TUI : +Vous pouvez maintenant exécuter cette commande dans le TUI : ```bash frame="none" /test @@ -77,10 +77,10 @@ Vous pouvez maintenant exécuter cette commande dans TUI : ### Markdown -Vous pouvez également définir des commandes à l'aide de fichiers markdown. Placez-les dans : +Vous pouvez également définir des commandes à l'aide de fichiers markdown. Placez-les dans : - Global : `~/.config/opencode/commands/` -- Par projet : `.opencode/commands/` +- Par projet : `.opencode/commands/` ```markdown title="~/.config/opencode/commands/test.md" --- @@ -93,8 +93,7 @@ Run the full test suite with coverage report and show any failures. Focus on the failing tests and suggest fixes. ``` -Le nom du fichier markdown devient le nom de la commande. Par exemple, `test.md` permet -tu cours : +Le nom du fichier markdown devient le nom de la commande. Par exemple, `test.md` permet d'exécuter : ```bash frame="none" /test @@ -104,7 +103,7 @@ tu cours : ## Configuration rapide -Les invites pour les commandes personnalisées prennent en charge plusieurs espaces réservés et syntaxes spéciaux. +Les prompts pour les commandes personnalisées prennent en charge plusieurs espaces réservés et syntaxes spéciaux. --- @@ -121,7 +120,7 @@ Create a new React component named $ARGUMENTS with TypeScript support. Include proper typing and basic structure. ``` -Exécutez la commande avec des arguments : +Exécutez la commande avec des arguments : ```bash frame="none" /component Button @@ -129,7 +128,7 @@ Exécutez la commande avec des arguments : Et `$ARGUMENTS` sera remplacé par `Button`. -Vous pouvez également accéder à des arguments individuels à l'aide de paramètres de position : +Vous pouvez également accéder à des arguments individuels à l'aide de paramètres de position : - `$1` - Premier argument - `$2` - Deuxième argument @@ -147,13 +146,13 @@ Create a file named $1 in the directory $2 with the following content: $3 ``` -Exécutez la commande : +Exécutez la commande : ```bash frame="none" /create-file config.json src "{ \"key\": \"value\" }" ``` -Celui-ci remplace : +Celui-ci remplace : - `$1` avec `config.json` - `$2` avec `src` @@ -163,9 +162,9 @@ Celui-ci remplace : ### Sortie du shell -Utilisez _!`command`_ pour injecter la sortie [bash command](/docs/tui#bash-commands) dans votre invite. +Utilisez _!`command`_ pour injecter la sortie [bash command](/docs/tui#bash-commands) dans votre prompt. -Par exemple, pour créer une commande personnalisée qui analyse la couverture des tests : +Par exemple, pour créer une commande personnalisée qui analyse la couverture des tests : ```md title=".opencode/commands/analyze-coverage.md" --- @@ -178,7 +177,7 @@ Here are the current test results: Based on these results, suggest improvements to increase coverage. ``` -Ou pour consulter les modifications récentes : +Ou pour consulter les modifications récentes : ```md title=".opencode/commands/review-changes.md" --- @@ -191,7 +190,7 @@ Recent git commits: Review these changes and suggest any improvements. ``` -Les commandes s'exécutent dans le répertoire racine de votre projet et leur sortie fait partie de l'invite. +Les commandes s'exécutent dans le répertoire racine de votre projet et leur sortie fait partie du prompt. --- @@ -208,7 +207,7 @@ Review the component in @src/components/Button.tsx. Check for performance issues and suggest improvements. ``` -Le contenu du fichier est automatiquement inclus dans l’invite. +Le contenu du fichier est automatiquement inclus dans le prompt. --- @@ -220,7 +219,7 @@ Examinons les options de configuration en détail. ### Template -L'option `template` définit l'invite qui sera envoyée au LLM lors de l'exécution de la commande. +L'option `template` définit le prompt qui sera envoyé au LLM lors de l'exécution de la commande. ```json title="opencode.json" { @@ -274,9 +273,9 @@ Il s'agit d'une option de configuration **facultative**. S’il n’est pas spé --- -### Subtask +### Sous-tâche -Utilisez le booléen `subtask` pour forcer la commande à déclencher un invocation de [subagent](/docs/agents/#subagents). +Utilisez le booléen `subtask` pour forcer la commande à déclencher une invocation de [subagent](/docs/agents/#subagents). Ceci est utile si vous souhaitez que la commande ne pollue pas votre contexte principal et **force** l'agent à agir en tant que sous-agent, même si `mode` est défini sur `primary` dans la configuration [agent](/docs/agents). @@ -294,7 +293,7 @@ Il s'agit d'une option de configuration **facultative**. --- -### Model +### Modèle Utilisez la configuration `model` pour remplacer le modèle par défaut pour cette commande. @@ -312,9 +311,9 @@ Il s'agit d'une option de configuration **facultative**. --- -## Intégré +## Commandes intégrées -opencode comprend plusieurs commandes intégrées comme `/init`, `/undo`, `/redo`, `/share`, `/help` ; [en savoir plus](/docs/tui#commands). +opencode comprend plusieurs commandes intégrées comme `/init`, `/undo`, `/redo`, `/share`, `/help` ; [en savoir plus](/docs/tui#commands). :::note Les commandes personnalisées peuvent remplacer les commandes intégrées. diff --git a/packages/web/src/content/docs/fr/config.mdx b/packages/web/src/content/docs/fr/config.mdx index 2bfcb98fe..8c0d15e18 100644 --- a/packages/web/src/content/docs/fr/config.mdx +++ b/packages/web/src/content/docs/fr/config.mdx @@ -1,6 +1,6 @@ --- title: Configuration -description: En utilisant la configuration OpenCode JSON. +description: Utilisation de la configuration JSON OpenCode. --- Vous pouvez configurer OpenCode à l'aide d'un fichier de configuration JSON. @@ -40,30 +40,30 @@ Par exemple, si votre configuration globale définit `theme: "opencode"` et `aut ### Ordre de priorité -Les sources de configuration sont chargées dans cet ordre (les sources ultérieures remplacent les précédentes) : +Les sources de configuration sont chargées dans cet ordre (les sources ultérieures remplacent les précédentes) : -1. **Configuration à distance** (à partir de `.well-known/opencode`) - paramètres par défaut de l'organisation +1. **Configuration distante** (à partir de `.well-known/opencode`) - paramètres par défaut de l'organisation 2. **Configuration globale** (`~/.config/opencode/opencode.json`) - préférences utilisateur 3. **Configuration personnalisée** (`OPENCODE_CONFIG` env var) - remplacements personnalisés 4. **Configuration du projet** (`opencode.json` dans le projet) - paramètres spécifiques au projet -5. **`.opencode` répertoires** - agents, commandes, plugins +5. **Répertoires `.opencode`** - agents, commandes, plugins 6. **Configuration en ligne** (`OPENCODE_CONFIG_CONTENT` env var) - remplacements d'exécution Cela signifie que les configurations de projet peuvent remplacer les valeurs par défaut globales, et que les configurations globales peuvent remplacer les valeurs par défaut de l'organisation distante. :::note -Les répertoires `.opencode` et `~/.config/opencode` utilisent des **noms au pluriel** pour les sous-répertoires : `agents/`, `commands/`, `modes/`, `plugins/`, `skills/`, `tools/` et `themes/`. Les noms singuliers (par exemple, `agent/`) sont également pris en charge pour une compatibilité ascendante. +Les répertoires `.opencode` et `~/.config/opencode` utilisent des **noms au pluriel** pour les sous-répertoires : `agents/`, `commands/`, `modes/`, `plugins/`, `skills/`, `tools/` et `themes/`. Les noms singuliers (par exemple, `agent/`) sont également pris en charge pour une compatibilité ascendante. ::: --- -### Remote +### Configuration distante Les organisations peuvent fournir une configuration par défaut via le point de terminaison `.well-known/opencode`. Ceci est récupéré automatiquement lorsque vous vous authentifiez auprès d’un fournisseur qui le prend en charge. La configuration distante est chargée en premier, servant de couche de base. Toutes les autres sources de configuration (globales, projet) peuvent remplacer ces valeurs par défaut. -Par exemple, si votre organisation fournit des serveurs MCP qui sont désactivés par défaut : +Par exemple, si votre organisation fournit des serveurs MCP qui sont désactivés par défaut : ```json title="Remote config from .well-known/opencode" { @@ -77,7 +77,7 @@ Par exemple, si votre organisation fournit des serveurs MCP qui sont désactivé } ``` -Vous pouvez activer des serveurs spécifiques dans votre configuration locale : +Vous pouvez activer des serveurs spécifiques dans votre configuration locale : ```json title="opencode.json" { @@ -93,7 +93,7 @@ Vous pouvez activer des serveurs spécifiques dans votre configuration locale : --- -### Global +### Globale Placez votre configuration globale OpenCode dans `~/.config/opencode/opencode.json`. Utilisez la configuration globale pour les préférences de l'utilisateur telles que les thèmes, les fournisseurs ou les raccourcis clavier. @@ -103,7 +103,7 @@ La configuration globale remplace les paramètres par défaut de l'organisation ### Par projet -Ajoutez `opencode.json` à la racine de votre projet. La configuration du projet a la priorité la plus élevée parmi les fichiers de configuration standard : elle remplace les configurations globales et distantes. +Ajoutez `opencode.json` à la racine de votre projet. La configuration du projet a la priorité la plus élevée parmi les fichiers de configuration standard : elle remplace les configurations globales et distantes. :::tip Placez la configuration spécifique au projet à la racine de votre projet. @@ -130,10 +130,7 @@ La configuration personnalisée est chargée entre les configurations globales e ### Répertoire personnalisé -Spécifiez un répertoire de configuration personnalisé à l'aide de `OPENCODE_CONFIG_DIR` -variable d'environnement. Ce répertoire sera recherché pour les agents, les commandes, -modes et plugins tout comme le répertoire standard `.opencode`, et devrait -suivent la même structure. +Spécifiez un répertoire de configuration personnalisé à l'aide de `OPENCODE_CONFIG_DIR` variable d'environnement. Ce répertoire sera recherché pour les agents, les commandes, modes et plugins tout comme le répertoire standard `.opencode`, et devrait suivre la même structure. ```bash export OPENCODE_CONFIG_DIR=/path/to/my/config-directory @@ -169,7 +166,7 @@ Vous pouvez configurer les paramètres spécifiques à TUI via l'option `tui`. } ``` -Options disponibles : +Options disponibles : - `scroll_acceleration.enabled` - Active l'accélération de défilement de style macOS. **A priorité sur `scroll_speed`.** - `scroll_speed` - Multiplicateur de vitesse de défilement personnalisé (par défaut : `3`, minimum : `1`). Ignoré si `scroll_acceleration.enabled` est `true`. @@ -196,10 +193,10 @@ Vous pouvez configurer les paramètres du serveur pour les commandes `opencode s } ``` -Options disponibles : +Options disponibles : -- `port` - Port sur lequel écouter. -- `hostname` - Nom d'hôte sur lequel écouter. Lorsque `mdns` est activé et qu'aucun nom d'hôte n'est défini, la valeur par défaut est `0.0.0.0`. +- `port` - Port d'écoute. +- `hostname` - Nom d'hôte d'écoute. Lorsque `mdns` est activé et qu'aucun nom d'hôte n'est défini, la valeur par défaut est `0.0.0.0`. - `mdns` - Activer la découverte du service mDNS. Cela permet à d'autres appareils du réseau de découvrir votre serveur OpenCode. - `mdnsDomain` - Nom de domaine personnalisé pour le service mDNS. La valeur par défaut est `opencode.local`. Utile pour exécuter plusieurs instances sur le même réseau. - `cors` - Origines supplémentaires pour autoriser CORS lors de l'utilisation du serveur HTTP à partir d'un client basé sur un navigateur. Les valeurs doivent être des origines complètes (schéma + hôte + port facultatif), par exemple `https://app.example.com`. @@ -241,7 +238,7 @@ Vous pouvez configurer les fournisseurs et les modèles que vous souhaitez utili L'option `small_model` configure un modèle distinct pour les tâches légères comme la génération de titres. Par défaut, OpenCode essaie d'utiliser un modèle moins cher s'il est disponible auprès de votre fournisseur, sinon il revient à votre modèle principal. -Les options du fournisseur peuvent inclure `timeout` et `setCacheKey` : +Les options du fournisseur peuvent inclure `timeout` et `setCacheKey` : ```json title="opencode.json" { @@ -257,7 +254,7 @@ Les options du fournisseur peuvent inclure `timeout` et `setCacheKey` : } ``` -- `timeout` - Délai d'expiration de la demande en millisecondes (par défaut : 300 000). Réglez sur `false` pour désactiver. +- `timeout` - Délai d'expiration de la demande en millisecondes (par défaut : 300 000). Réglez sur `false` pour désactiver. - `setCacheKey` - Assurez-vous qu'une clé de cache est toujours définie pour le fournisseur désigné. Vous pouvez également configurer [modèles locaux](/docs/models#local). [En savoir plus](/docs/models). @@ -270,7 +267,7 @@ Certains fournisseurs prennent en charge des options de configuration supplémen ##### Amazon Bedrock -Amazon Bedrock prend en charge la configuration spécifique à AWS : +Amazon Bedrock prend en charge la configuration spécifique à AWS : ```json title="opencode.json" { @@ -353,7 +350,7 @@ Vous pouvez définir l'agent par défaut à l'aide de l'option `default_agent`. L'agent par défaut doit être un agent principal (et non un sous-agent). Il peut s'agir d'un agent intégré tel que `"build"` ou `"plan"`, ou d'un [agent personnalisé](/docs/agents) que vous avez défini. Si l'agent spécifié n'existe pas ou est un sous-agent, OpenCode reviendra à `"build"` avec un avertissement. -Ce paramètre s'applique à toutes les interfaces : TUI, CLI (`opencode run`), application de bureau et GitHub Action. +Ce paramètre s'applique à toutes les interfaces : TUI, CLI (`opencode run`), application de bureau et GitHub Action. --- @@ -368,11 +365,11 @@ Vous pouvez configurer la fonctionnalité [share](/docs/share) via l'option `sha } ``` -Cela prend : +Elle accepte : -- `"manual"` - Autoriser le partage manuel via des commandes (par défaut) -- `"auto"` – Partager automatiquement de nouvelles conversations -- `"disabled"` – Désactiver complètement le partage +- `"manual"` – Autoriser le partage manuel via des commandes (par défaut) +- `"auto"` – Partager automatiquement de nouvelles conversations +- `"disabled"` – Désactiver complètement le partage Par défaut, le partage est défini en mode manuel où vous devez partager explicitement les conversations à l'aide de la commande `/share`. @@ -465,7 +462,7 @@ Vous pouvez configurer les formateurs de code via l'option `formatter`. Par défaut, opencode **autorise toutes les opérations** sans nécessiter d'approbation explicite. Vous pouvez modifier cela en utilisant l'option `permission`. -Par exemple, pour garantir que les outils `edit` et `bash` nécessitent l'approbation de l'utilisateur : +Par exemple, pour garantir que les outils `edit` et `bash` nécessitent l'approbation de l'utilisateur : ```json title="opencode.json" { @@ -481,7 +478,7 @@ Par exemple, pour garantir que les outils `edit` et `bash` nécessitent l'approb --- -### Compaction +### Compactage Vous pouvez contrôler le comportement de compactage du contexte via l'option `compaction`. @@ -495,12 +492,12 @@ Vous pouvez contrôler le comportement de compactage du contexte via l'option `c } ``` -- `auto` - Compacte automatiquement la session lorsque le contexte est plein (par défaut : `true`). -- `prune` - Supprimez les anciennes sorties de l'outil pour enregistrer les jetons (par défaut : `true`). +- `auto` - Compacte automatiquement la session lorsque le contexte est plein (par défaut : `true`). +- `prune` - Supprimez les anciennes sorties de l'outil pour économiser des tokens (par défaut : `true`). --- -### Watcher +### Observateur Vous pouvez configurer les modèles d'ignorance de l'observateur de fichiers via l'option `watcher`. @@ -513,7 +510,7 @@ Vous pouvez configurer les modèles d'ignorance de l'observateur de fichiers via } ``` -Les modèles suivent la syntaxe globale. Utilisez ceci pour exclure les répertoires bruyants de la surveillance des fichiers. +Les modèles suivent la syntaxe glob. Utilisez ceci pour exclure les répertoires bruyants de la surveillance des fichiers. --- @@ -532,7 +529,7 @@ Vous pouvez configurer les serveurs MCP que vous souhaitez utiliser via l'option --- -### Plugins +### Extensions [Plugins](/docs/plugins) étendent OpenCode avec des outils, des hooks et des intégrations personnalisés. @@ -560,12 +557,11 @@ Vous pouvez configurer les instructions pour le modèle que vous utilisez via l' } ``` -Cela prend un tableau de chemins et de modèles globaux vers les fichiers d'instructions. [Apprendre encore plus -à propos des règles ici](/docs/rules). +Cela prend un tableau de chemins et de modèles globaux vers les fichiers d'instructions. [En savoir plus sur les règles ici](/docs/rules). --- -### Disabled Providers +### Fournisseurs désactivés Vous pouvez désactiver les fournisseurs chargés automatiquement via l'option `disabled_providers`. Ceci est utile lorsque vous souhaitez empêcher le chargement de certains fournisseurs même si leurs informations d'identification sont disponibles. @@ -580,7 +576,7 @@ Vous pouvez désactiver les fournisseurs chargés automatiquement via l'option ` Le `disabled_providers` est prioritaire sur `enabled_providers`. ::: -L'option `disabled_providers` accepte un tableau d'ID de fournisseur. Lorsqu'un fournisseur est désactivé : +L'option `disabled_providers` accepte un tableau d'ID de fournisseur. Lorsqu'un fournisseur est désactivé : - Il ne sera pas chargé même si des variables d'environnement sont définies. - Il ne sera pas chargé même si les clés API sont configurées via la commande `/connect`. @@ -588,7 +584,7 @@ L'option `disabled_providers` accepte un tableau d'ID de fournisseur. Lorsqu'un --- -### Enabled Providers +### Fournisseurs activés Vous pouvez spécifier une liste autorisée de fournisseurs via l'option `enabled_providers`. Une fois défini, seuls les fournisseurs spécifiés seront activés et tous les autres seront ignorés. @@ -621,7 +617,7 @@ La clé `experimental` contient des options en cours de développement actif. ``` :::caution -Les options expérimentales ne sont pas stables. Ils peuvent changer ou être supprimés sans préavis. +Les options expérimentales ne sont pas stables. Elles peuvent changer ou être supprimées sans préavis. ::: --- @@ -632,9 +628,9 @@ Vous pouvez utiliser la substitution de variables dans vos fichiers de configura --- -### Vars d'environnement +### Variables d'environnement -Utilisez `{env:VARIABLE_NAME}` pour remplacer les variables d'environnement : +Utilisez `{env:VARIABLE_NAME}` pour remplacer les variables d'environnement : ```json title="opencode.json" { @@ -657,7 +653,7 @@ Si la variable d'environnement n'est pas définie, elle sera remplacée par une ### Fichiers -Utilisez `{file:path/to/file}` pour remplacer le contenu d'un fichier : +Utilisez `{file:path/to/file}` pour remplacer le contenu d'un fichier : ```json title="opencode.json" { @@ -673,13 +669,13 @@ Utilisez `{file:path/to/file}` pour remplacer le contenu d'un fichier : } ``` -Les chemins de fichiers peuvent être : +Les chemins de fichiers peuvent être : -- Par rapport au répertoire du fichier de configuration +- Relatifs au répertoire du fichier de configuration - Ou des chemins absolus commençant par `/` ou `~` -Ceux-ci sont utiles pour : +Elles sont utiles pour : - Conserver les données sensibles telles que les clés API dans des fichiers séparés. -- Y compris de gros fichiers d'instructions sans encombrer votre configuration. -- Partage d'extraits de configuration communs sur plusieurs fichiers de configuration. +- Inclure de gros fichiers d'instructions sans encombrer votre configuration. +- Partager des extraits de configuration communs sur plusieurs fichiers de configuration. diff --git a/packages/web/src/content/docs/fr/custom-tools.mdx b/packages/web/src/content/docs/fr/custom-tools.mdx index c0d63e54d..2753f0e32 100644 --- a/packages/web/src/content/docs/fr/custom-tools.mdx +++ b/packages/web/src/content/docs/fr/custom-tools.mdx @@ -1,6 +1,6 @@ --- title: Outils personnalisés -description: Créez des outils que LLM peut appeler dans opencode. +description: Créez des outils que le LLM peut appeler dans opencode. --- Les outils personnalisés sont des fonctions que vous créez et que le LLM peut appeler pendant les conversations. Ils fonctionnent avec les [outils intégrés](/docs/tools) de opencode comme `read`, `write` et `bash`. @@ -9,7 +9,7 @@ Les outils personnalisés sont des fonctions que vous créez et que le LLM peut ## Création d'un outil -Les outils sont définis sous forme de fichiers **TypeScript** ou **JavaScript**. Cependant, la définition de l'outil peut appeler des scripts écrits dans **n'importe quel langage** : TypeScript ou JavaScript n'est utilisé que pour la définition de l'outil elle-même. +Les outils sont définis sous forme de fichiers **TypeScript** ou **JavaScript**. Cependant, la définition de l'outil peut appeler des scripts écrits dans **n'importe quel langage** : TypeScript ou JavaScript n'est utilisé que pour la définition de l'outil elle-même. --- @@ -24,7 +24,7 @@ Ils peuvent être définis : ### Structure -Le moyen le plus simple de créer des outils consiste à utiliser l'assistant `tool()` qui fournit la sécurité et la validation du type. +Le moyen le plus simple de créer des outils est d'utiliser l'assistant `tool()` qui fournit la sécurité et la validation de type. ```ts title=".opencode/tools/database.ts" {1} import { tool } from "@opencode-ai/plugin" @@ -47,7 +47,7 @@ Le **nom de fichier** devient le **nom de l'outil**. Ce qui précède crée un o #### Plusieurs outils par fichier -Vous pouvez également exporter plusieurs outils à partir d'un seul fichier. Chaque exportation devient **un outil distinct** portant le nom **`_`** : +Vous pouvez également exporter plusieurs outils à partir d'un seul fichier. Chaque exportation devient **un outil distinct** portant le nom **`_`** : ```ts title=".opencode/tools/math.ts" import { tool } from "@opencode-ai/plugin" @@ -75,7 +75,7 @@ export const multiply = tool({ }) ``` -Cela crée deux outils : `math_add` et `math_multiply`. +Cela crée deux outils : `math_add` et `math_multiply`. --- @@ -89,7 +89,7 @@ args: { } ``` -Vous pouvez également importer [Zod](https://zod.dev) directement et renvoyer un objet simple : +Vous pouvez également importer [Zod](https://zod.dev) directement et renvoyer un objet simple : ```ts {6} import { z } from "zod" @@ -110,7 +110,7 @@ export default { ### Contexte -Les outils reçoivent du contexte sur la session en cours : +Les outils reçoivent le contexte de la session en cours : ```ts title=".opencode/tools/project.ts" {8} import { tool } from "@opencode-ai/plugin" @@ -127,7 +127,7 @@ export default tool({ ``` Utilisez `context.directory` pour le répertoire de travail de la session. -Utilisez `context.worktree` pour la racine de git worktree. +Utilisez `context.worktree` pour la racine du worktree git. --- @@ -135,9 +135,9 @@ Utilisez `context.worktree` pour la racine de git worktree. ### Écrire un outil en Python -Vous pouvez écrire vos outils dans la langue de votre choix. Voici un exemple qui ajoute deux nombres à l'aide de Python. +Vous pouvez écrire vos outils dans le langage de votre choix. Voici un exemple qui ajoute deux nombres à l'aide de Python. -Tout d'abord, créez l'outil en tant que script Python : +Tout d'abord, créez l'outil en tant que script Python : ```python title=".opencode/tools/add.py" import sys @@ -147,7 +147,7 @@ b = int(sys.argv[2]) print(a + b) ``` -Créez ensuite la définition d'outil qui l'invoque : +Créez ensuite la définition d'outil qui l'invoque : ```ts title=".opencode/tools/python-add.ts" {10} import { tool } from "@opencode-ai/plugin" diff --git a/packages/web/src/content/docs/fr/ecosystem.mdx b/packages/web/src/content/docs/fr/ecosystem.mdx index 7ec695079..dd74e1f7b 100644 --- a/packages/web/src/content/docs/fr/ecosystem.mdx +++ b/packages/web/src/content/docs/fr/ecosystem.mdx @@ -6,57 +6,57 @@ description: Projets et intégrations construits avec OpenCode. Une collection de projets communautaires construits sur OpenCode. :::note -Vous souhaitez ajouter votre projet lié à OpenCode à cette liste ? Soumettez un PR. +Vous souhaitez ajouter votre projet lié à OpenCode à cette liste ? Soumettez un PR. ::: -Vous pouvez également consulter [awesome-opencode](https://github.com/awesome-opencode/awesome-opencode) et [opencode.cafe](https://opencode.cafe), une communauté qui regroupe l'écosystème et la communauté. +Vous pouvez également consulter [awesome-opencode](https://github.com/awesome-opencode/awesome-opencode) et [opencode.cafe](https://opencode.cafe), une communauté qui regroupe l'écosystème OpenCode. --- -## Plugins +## Extensions -| Nom | Descriptif | -| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | -| [opencode-daytona](https://github.com/jamesmurdza/daytona/blob/main/guides/typescript/opencode/README.md) | Exécutez automatiquement des sessions OpenCode dans des sandbox Daytona isolés avec synchronisation git et aperçus en direct | -| [opencode-helicone-session](https://github.com/H2Shami/opencode-helicone-session) | Injecter automatiquement les en-têtes de session Helicone pour le regroupement des requêtes | -| [opencode-type-inject](https://github.com/nick-vi/opencode-type-inject) | Injectez automatiquement les types TypeScript/Svelte dans les lectures de fichiers avec des outils de recherche | -| [opencode-openai-codex-auth](https://github.com/numman-ali/opencode-openai-codex-auth) | Utilisez votre abonnement ChatGPT Plus/Pro au lieu de crédits API | -| [opencode-gemini-auth](https://github.com/jenslys/opencode-gemini-auth) | Utilisez votre forfait Gemini existant au lieu de la facturation API | -| [opencode-antigravity-auth](https://github.com/NoeFabris/opencode-antigravity-auth) | Utilisez les modèles gratuits d'Antigravity au lieu de la facturation API | -| [opencode-devcontainers](https://github.com/athal7/opencode-devcontainers) | Isolation de conteneur de développement multibranche avec clones superficiels et ports attribués automatiquement | -| [opencode-google-antigravity-auth](https://github.com/shekohex/opencode-google-antigravity-auth) | Plugin Google Antigravity OAuth, avec prise en charge de la recherche Google et gestion API plus robuste | -| [opencode-dynamic-context-pruning](https://github.com/Tarquinen/opencode-dynamic-context-pruning) | Optimisez l'utilisation des jetons en éliminant les sorties d'outils obsolètes | -| [opencode-websearch-cited](https://github.com/ghoulr/opencode-websearch-cited.git) | Ajoutez la prise en charge native de la recherche Web pour les fournisseurs pris en charge avec le style ancré par Google | -| [opencode-pty](https://github.com/shekohex/opencode-pty.git) | Permet aux agents IA d'exécuter des processus en arrière-plan dans un PTY et de leur envoyer des entrées interactives. | -| [opencode-shell-strategy](https://github.com/JRedeker/opencode-shell-strategy) | Instructions pour les commandes shell non interactives - empêche les blocages des opérations dépendantes du TTY | -| [opencode-wakatime](https://github.com/angristan/opencode-wakatime) | Suivez l'utilisation de OpenCode avec Wakatime | -| [opencode-md-table-formatter](https://github.com/franlol/opencode-md-table-formatter/tree/main) | Nettoyer les tableaux Markdown produits par les LLM | -| [opencode-morph-fast-apply](https://github.com/JRedeker/opencode-morph-fast-apply) | Édition de code 10 fois plus rapide avec Morph Fast Apply API et les marqueurs d'édition différée | -| [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) | Agents d'arrière-plan, outils LSP/AST/MCP prédéfinis, agents sélectionnés, compatibles Claude Code | -| [opencode-notificator](https://github.com/panta82/opencode-notificator) | Notifications de bureau et alertes sonores pour les sessions OpenCode | -| [opencode-notifier](https://github.com/mohak34/opencode-notifier) | Notifications sur le bureau et alertes sonores pour les événements d'autorisation, d'achèvement et d'erreur | -| [opencode-zellij-namer](https://github.com/24601/opencode-zellij-namer) | Dénomination automatique de session Zellij basée sur l'IA basée sur le contexte OpenCode | -| [opencode-skillful](https://github.com/zenobi-us/opencode-skillful) | Autoriser les agents OpenCode à charger paresseusement les invites à la demande grâce à la découverte et à l'injection de compétences | -| [opencode-supermemory](https://github.com/supermemoryai/opencode-supermemory) | Mémoire persistante entre les sessions utilisant Supermemory | -| [@plannotator/opencode](https://github.com/backnotprop/plannotator/tree/main/apps/opencode-plugin) | Révision interactive du plan avec annotation visuelle et partage privé/hors ligne | -| [@openspoon/subtask2](https://github.com/spoons-and-mirrors/subtask2) | Étendez opencode /commands dans un système d'orchestration puissant avec contrôle de flux granulaire | -| [opencode-scheduler](https://github.com/different-ai/opencode-scheduler) | Planifiez des tâches récurrentes à l'aide de launchd (Mac) ou systemd (Linux) avec la syntaxe cron | -| [micode](https://github.com/vtemian/micode) | Brainstorming structuré → Planifier → Mettre en œuvre un workflow avec continuité de session | -| [octto](https://github.com/vtemian/octto) | Interface utilisateur de navigateur interactive pour le brainstorming IA avec des formulaires multi-questions | -| [opencode-background-agents](https://github.com/kdcokenny/opencode-background-agents) | Agents d'arrière-plan de style Claude Code avec délégation asynchrone et persistance du contexte | -| [opencode-notify](https://github.com/kdcokenny/opencode-notify) | Notifications natives du système d'exploitation pour OpenCode – savoir quand les tâches sont terminées | -| [opencode-workspace](https://github.com/kdcokenny/opencode-workspace) | Harness d'orchestration multi-agent prêt à l'emploi - 16 composants, une installation | -| [opencode-worktree](https://github.com/kdcokenny/opencode-worktree) | Arbres de travail Git sans friction pour OpenCode | +| Nom | Description | +| --------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | +| [opencode-daytona](https://github.com/jamesmurdza/daytona/blob/main/guides/typescript/opencode/README.md) | Exécute automatiquement des sessions OpenCode dans des environnements sandbox Daytona isolés avec synchronisation git et prévisualisations en direct | +| [opencode-helicone-session](https://github.com/H2Shami/opencode-helicone-session) | Injecte automatiquement les en-têtes de session Helicone pour le regroupement des requêtes | +| [opencode-type-inject](https://github.com/nick-vi/opencode-type-inject) | Injecte automatiquement les types TypeScript/Svelte dans les lectures de fichiers avec des outils de recherche | +| [opencode-openai-codex-auth](https://github.com/numman-ali/opencode-openai-codex-auth) | Utilise votre abonnement ChatGPT Plus/Pro au lieu de crédits API | +| [opencode-gemini-auth](https://github.com/jenslys/opencode-gemini-auth) | Utilise votre forfait Gemini existant au lieu de la facturation API | +| [opencode-antigravity-auth](https://github.com/NoeFabris/opencode-antigravity-auth) | Utilise les modèles gratuits d'Antigravity au lieu de la facturation API | +| [opencode-devcontainers](https://github.com/athal7/opencode-devcontainers) | Isolation de conteneur de développement multibranche avec clones superficiels et ports attribués automatiquement | +| [opencode-google-antigravity-auth](https://github.com/shekohex/opencode-google-antigravity-auth) | Plugin Google Antigravity OAuth, avec support de la recherche Google et gestion API plus robuste | +| [opencode-dynamic-context-pruning](https://github.com/Tarquinen/opencode-dynamic-context-pruning) | Optimise l'utilisation des jetons en éliminant les sorties d'outils obsolètes | +| [opencode-websearch-cited](https://github.com/ghoulr/opencode-websearch-cited.git) | Ajoute le support natif de la recherche Web pour les fournisseurs pris en charge avec le style ancré par Google | +| [opencode-pty](https://github.com/shekohex/opencode-pty.git) | Permet aux agents IA d'exécuter des processus en arrière-plan dans un PTY et de leur envoyer des entrées interactives. | +| [opencode-shell-strategy](https://github.com/JRedeker/opencode-shell-strategy) | Instructions pour les commandes shell non interactives - empêche les blocages des opérations dépendantes du TTY | +| [opencode-wakatime](https://github.com/angristan/opencode-wakatime) | Suit l'utilisation de OpenCode avec Wakatime | +| [opencode-md-table-formatter](https://github.com/franlol/opencode-md-table-formatter/tree/main) | Nettoie les tableaux Markdown produits par les LLM | +| [opencode-morph-fast-apply](https://github.com/JRedeker/opencode-morph-fast-apply) | Édition de code 10 fois plus rapide avec Morph Fast Apply API et les marqueurs d'édition différée | +| [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) | Agents d'arrière-plan, outils LSP/AST/MCP prédéfinis, agents sélectionnés, compatibles Claude Code | +| [opencode-notificator](https://github.com/panta82/opencode-notificator) | Notifications de bureau et alertes sonores pour les sessions OpenCode | +| [opencode-notifier](https://github.com/mohak34/opencode-notifier) | Notifications sur le bureau et alertes sonores pour les événements d'autorisation, d'achèvement et d'erreur | +| [opencode-zellij-namer](https://github.com/24601/opencode-zellij-namer) | Dénomination automatique de session Zellij basée sur l'IA et le contexte OpenCode | +| [opencode-skillful](https://github.com/zenobi-us/opencode-skillful) | Autorise les agents OpenCode à charger paresseusement les prompts à la demande grâce à la découverte et à l'injection de compétences | +| [opencode-supermemory](https://github.com/supermemoryai/opencode-supermemory) | Mémoire persistante entre les sessions utilisant Supermemory | +| [@plannotator/opencode](https://github.com/backnotprop/plannotator/tree/main/apps/opencode-plugin) | Révision interactive du plan avec annotation visuelle et partage privé/hors ligne | +| [@openspoon/subtask2](https://github.com/spoons-and-mirrors/subtask2) | Étend les commandes /commands d'opencode dans un système d'orchestration puissant avec contrôle de flux granulaire | +| [opencode-scheduler](https://github.com/different-ai/opencode-scheduler) | Planifie des tâches récurrentes à l'aide de launchd (Mac) ou systemd (Linux) avec la syntaxe cron | +| [micode](https://github.com/vtemian/micode) | Workflow structuré Brainstorming → Planifier → Mettre en œuvre avec continuité de session | +| [octto](https://github.com/vtemian/octto) | Interface utilisateur de navigateur interactive pour le brainstorming IA avec des formulaires multi-questions | +| [opencode-background-agents](https://github.com/kdcokenny/opencode-background-agents) | Agents d'arrière-plan de style Claude Code avec délégation asynchrone et persistance du contexte | +| [opencode-notify](https://github.com/kdcokenny/opencode-notify) | Notifications natives du système d'exploitation pour OpenCode – savoir quand les tâches sont terminées | +| [opencode-workspace](https://github.com/kdcokenny/opencode-workspace) | Harness d'orchestration multi-agent prêt à l'emploi - 16 composants, une installation | +| [opencode-worktree](https://github.com/kdcokenny/opencode-worktree) | Arbres de travail Git sans friction pour OpenCode | --- ## Projets -| Nom | Descriptif | +| Nom | Description | | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ | | [kimaki](https://github.com/remorses/kimaki) | Bot Discord pour contrôler les sessions OpenCode, construit sur le SDK | -| [opencode.nvim](https://github.com/NickvanDyke/opencode.nvim) | Plugin Neovim pour les invites compatibles avec l'éditeur, construit sur API | -| [portal](https://github.com/hosenur/portal) | Interface utilisateur Web axée sur les mobiles pour OpenCode sur Tailscale/VPN | +| [opencode.nvim](https://github.com/NickvanDyke/opencode.nvim) | Plugin Neovim pour les prompts compatibles avec l'éditeur, construit sur l'API | +| [portal](https://github.com/hosenur/portal) | Interface utilisateur Web axée sur le mobile pour OpenCode sur Tailscale/VPN | | [opencode plugin template](https://github.com/zenobi-us/opencode-plugin-template/) | Modèle pour créer des plugins OpenCode | | [opencode.nvim](https://github.com/sudo-tee/opencode.nvim) | Frontend Neovim pour opencode - un agent de codage d'IA basé sur un terminal | | [ai-sdk-provider-opencode-sdk](https://github.com/ben-vargas/ai-sdk-provider-opencode-sdk) | Fournisseur Vercel AI SDK pour l'utilisation de OpenCode via @opencode-ai/sdk | @@ -70,7 +70,7 @@ Vous pouvez également consulter [awesome-opencode](https://github.com/awesome-o ## Agents -| Nom | Descriptif | -| ----------------------------------------------------------------- | ------------------------------------------------------------------------------ | -| [Agentic](https://github.com/Cluster444/agentic) | Agents et commandes d'IA modulaires pour un développement structuré | -| [opencode-agents](https://github.com/darrenhinde/opencode-agents) | Configurations, invites, agents et plug-ins pour des flux de travail améliorés | +| Nom | Description | +| ----------------------------------------------------------------- | ----------------------------------------------------------------------------- | +| [Agentic](https://github.com/Cluster444/agentic) | Agents et commandes d'IA modulaires pour un développement structuré | +| [opencode-agents](https://github.com/darrenhinde/opencode-agents) | Configurations, prompts, agents et plugins pour des flux de travail améliorés | diff --git a/packages/web/src/content/docs/fr/enterprise.mdx b/packages/web/src/content/docs/fr/enterprise.mdx index b34bc7dbe..659fc3e7c 100644 --- a/packages/web/src/content/docs/fr/enterprise.mdx +++ b/packages/web/src/content/docs/fr/enterprise.mdx @@ -6,13 +6,13 @@ description: Utiliser OpenCode en toute sécurité dans votre organisation. import config from "../../../../config.mjs" export const email = `mailto:${config.email}` -OpenCode Enterprise est destiné aux organisations qui souhaitent s'assurer que leur code et leurs données ne quittent jamais leur infrastructure. Il peut le faire en utilisant une configuration centralisée qui s'intègre à votre SSO et à votre passerelle IA interne. +OpenCode Enterprise est destiné aux organisations qui souhaitent s'assurer que leur code et leurs données ne quittent jamais leur infrastructure. Cela est possible grâce à une configuration centralisée qui s'intègre à votre SSO et à votre passerelle IA interne. :::note OpenCode ne stocke aucune de vos données de code ou de contexte. ::: -Pour démarrer avec OpenCode Enterprise : +Pour démarrer avec OpenCode Enterprise : 1. Faites un essai en interne avec votre équipe. 2. **Contactez-nous** pour discuter des options de tarification et de mise en œuvre. @@ -29,8 +29,7 @@ OpenCode est open source et ne stocke aucune de vos données de code ou de conte **OpenCode ne stocke pas votre code ni vos données contextuelles.** Tous les traitements s'effectuent localement ou via des appels API directs à votre fournisseur d'IA. -Cela signifie que tant que vous faites appel à un fournisseur de confiance ou à un -Passerelle AI, vous pouvez utiliser OpenCode en toute sécurité. +Cela signifie que tant que vous faites appel à un fournisseur de confiance ou à une passerelle IA, vous pouvez utiliser OpenCode en toute sécurité. La seule mise en garde ici concerne la fonctionnalité facultative `/share`. @@ -69,9 +68,7 @@ Nous utilisons un modèle par siège pour OpenCode Enterprise. Si vous disposez ## Déploiement -Une fois que vous avez terminé votre essai et que vous êtes prêt à utiliser OpenCode à -votre organisation, vous pouvez **nous contacter** pour en discuter -options de tarification et de mise en œuvre. +Une fois que vous avez terminé votre essai et que vous êtes prêt à utiliser OpenCode à votre organisation, vous pouvez **nous contacter** pour discuter des options de tarification et de mise en œuvre. --- @@ -91,7 +88,7 @@ Cela permet à OpenCode d'obtenir les informations d'identification de votre pas --- -### AI Gateway interne +### Passerelle IA interne Avec la configuration centrale, OpenCode peut également être configuré pour utiliser uniquement votre passerelle IA interne. @@ -101,8 +98,7 @@ Vous pouvez également désactiver tous les autres fournisseurs d'IA, en vous as ### Auto-hébergement -Bien que nous vous recommandons de désactiver les pages de partage pour garantir que vos données ne quittent jamais -votre organisation, nous pouvons également vous aider à les auto-héberger sur votre infrastructure. +Bien que nous vous recommandons de désactiver les pages de partage pour garantir que vos données ne quittent jamais votre organisation, nous pouvons également vous aider à les auto-héberger sur votre infrastructure. Ceci est actuellement sur notre feuille de route. Si vous êtes intéressé, **faites-le-nous savoir**. @@ -111,14 +107,14 @@ Ceci est actuellement sur notre feuille de route. Si vous êtes intéressé, **< ## FAQ

-Qu’est-ce que OpenCode Entreprise ? +Qu’est-ce que OpenCode Entreprise ? OpenCode Enterprise est destiné aux organisations qui souhaitent s'assurer que leur code et leurs données ne quittent jamais leur infrastructure. Il peut le faire en utilisant une configuration centralisée qui s'intègre à votre SSO et à votre passerelle IA interne.
-Comment démarrer avec OpenCode Enterprise ? +Comment démarrer avec OpenCode Enterprise ? Commencez simplement par un essai interne avec votre équipe. OpenCode par défaut ne stocke pas votre code ni vos données contextuelles, ce qui facilite le démarrage. @@ -134,31 +130,30 @@ Nous proposons des tarifs d'entreprise par siège. Si vous disposez de votre pro
-Mes données sont-elles sécurisées avec OpenCode Enterprise ? +Mes données sont-elles sécurisées avec OpenCode Enterprise ? Oui. OpenCode ne stocke pas votre code ni vos données contextuelles. Tout le traitement s'effectue localement ou via des appels API directs à votre fournisseur d'IA. Grâce à la configuration centrale et à l'intégration SSO, vos données restent sécurisées au sein de l'infrastructure de votre organisation.
-Pouvons-nous utiliser notre propre registre privé NPM ? +Pouvons-nous utiliser notre propre registre privé NPM ? OpenCode prend en charge les registres npm privés via la prise en charge native des fichiers `.npmrc` de Bun. Si votre organisation utilise un registre privé, tel que JFrog Artifactory, Nexus ou similaire, assurez-vous que les développeurs sont authentifiés avant d'exécuter OpenCode. -Pour configurer l'authentification avec votre registre privé : +Pour configurer l'authentification avec votre registre privé : ```bash npm login --registry=https://your-company.jfrog.io/api/npm/npm-virtual/ ``` -Cela crée `~/.npmrc` avec les détails d'authentification. OpenCode sera automatiquement -ramasse ça. +Cela crée `~/.npmrc` avec les détails d'authentification. OpenCode le détectera automatiquement. :::caution Vous devez être connecté au registre privé avant d'exécuter OpenCode. ::: -Alternativement, vous pouvez configurer manuellement un fichier `.npmrc` : +Alternativement, vous pouvez configurer manuellement un fichier `.npmrc` : ```bash title="~/.npmrc" registry=https://your-company.jfrog.io/api/npm/npm-virtual/ diff --git a/packages/web/src/content/docs/fr/formatters.mdx b/packages/web/src/content/docs/fr/formatters.mdx index 852bc7979..ef59b8108 100644 --- a/packages/web/src/content/docs/fr/formatters.mdx +++ b/packages/web/src/content/docs/fr/formatters.mdx @@ -1,17 +1,17 @@ --- title: Formateurs -description: OpenCode utilise des formateurs spécifiques à la langue. +description: OpenCode utilise des formateurs spécifiques au langage. --- -OpenCode formate automatiquement les fichiers après leur écriture ou leur modification à l'aide de formateurs spécifiques à la langue. Cela garantit que le code généré suit les styles de code de votre projet. +OpenCode formate automatiquement les fichiers après leur écriture ou leur modification à l'aide de formateurs spécifiques au langage. Cela garantit que le code généré suit les styles de code de votre projet. --- -## Intégré +## Formateurs intégrés OpenCode est livré avec plusieurs formateurs intégrés pour les langages et frameworks populaires. Vous trouverez ci-dessous une liste des formateurs, des extensions de fichiers prises en charge et des commandes ou options de configuration dont il a besoin. -| Formateur | Rallonges | Exigences | +| Formateur | Extensions | Prérequis | | -------------------- | ------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------- | | gofmt | .go | Commande `gofmt` disponible | | mix | .ex, .exs, .eex, .heex, .leex, .neex, .sface | Commande `mix` disponible | @@ -44,7 +44,7 @@ Ainsi, si votre projet a `prettier` dans votre `package.json`, OpenCode l'utilis ## Comment ça marche -Lorsque OpenCode écrit ou modifie un fichier, il : +Lorsque OpenCode écrit ou modifie un fichier, il : 1. Vérifie l'extension du fichier par rapport à tous les formateurs activés. 2. Exécute la commande de formatage appropriée sur le fichier. @@ -54,7 +54,7 @@ Ce processus se déroule en arrière-plan, garantissant que vos styles de code s --- -## Configurer +## Configuration Vous pouvez personnaliser les formateurs via la section `formatter` de votre configuration OpenCode. @@ -65,9 +65,9 @@ Vous pouvez personnaliser les formateurs via la section `formatter` de votre con } ``` -Chaque configuration du formateur prend en charge les éléments suivants : +Chaque configuration du formateur prend en charge les éléments suivants : -| Propriété | Tapez | Descriptif | +| Propriété | Type | Description | | ------------- | -------- | -------------------------------------------------------------------- | | `disabled` | booléen | Définissez ceci sur `true` pour désactiver le formateur | | `command` | chaîne[] | La commande à exécuter pour le formatage | @@ -80,7 +80,7 @@ Regardons quelques exemples. ### Désactivation des formateurs -Pour désactiver **tous** les formateurs globalement, définissez `formatter` sur `false` : +Pour désactiver **tous** les formateurs globalement, définissez `formatter` sur `false` : ```json title="opencode.json" {3} { @@ -89,7 +89,7 @@ Pour désactiver **tous** les formateurs globalement, définissez `formatter` su } ``` -Pour désactiver un formateur **spécifique**, définissez `disabled` sur `true` : +Pour désactiver un formateur **spécifique**, définissez `disabled` sur `true` : ```json title="opencode.json" {5} { @@ -106,7 +106,7 @@ Pour désactiver un formateur **spécifique**, définissez `disabled` sur `true` ### Formateurs personnalisés -Vous pouvez remplacer les formateurs intégrés ou en ajouter de nouveaux en spécifiant la commande, les variables d'environnement et les extensions de fichier : +Vous pouvez remplacer les formateurs intégrés ou en ajouter de nouveaux en spécifiant la commande, les variables d'environnement et les extensions de fichier : ```json title="opencode.json" {4-14} { diff --git a/packages/web/src/content/docs/fr/github.mdx b/packages/web/src/content/docs/fr/github.mdx index f2541bdcf..968ae4d45 100644 --- a/packages/web/src/content/docs/fr/github.mdx +++ b/packages/web/src/content/docs/fr/github.mdx @@ -1,29 +1,29 @@ --- title: GitHub -description: Utilisez OpenCode dans les problèmes et les pull-requests GitHub. +description: Utilisez OpenCode dans les issues et les pull-requests GitHub. --- OpenCode s'intègre à votre flux de travail GitHub. Mentionnez `/opencode` ou `/oc` dans votre commentaire, et OpenCode exécutera des tâches dans votre runner GitHub Actions. --- -## Caractéristiques +## Fonctionnalités -- **Problèmes de triage** : demandez à OpenCode d'examiner un problème et de vous l'expliquer. -- **Réparer et implémenter** : demandez à OpenCode de résoudre un problème ou d'implémenter une fonctionnalité. Et il fonctionnera dans une nouvelle branche et soumettra un PR avec tous les changements. -- **Sécurisé** : OpenCode s'exécute à l'intérieur de vos runners GitHub. +- **Triage des issues** : demandez à OpenCode d'examiner une issue et de vous l'expliquer. +- **Correction et implémentation** : demandez à OpenCode de résoudre un problème ou d'implémenter une fonctionnalité. Il travaillera dans une nouvelle branche et soumettra une PR avec tous les changements. +- **Sécurisé** : OpenCode s'exécute à l'intérieur de vos runners GitHub. --- ## Installation -Exécutez la commande suivante dans un projet qui se trouve dans un dépôt GitHub : +Exécutez la commande suivante dans un projet qui se trouve dans un dépôt GitHub : ```bash opencode github install ``` -Cela vous guidera dans l'installation de l'application GitHub, la création du flux de travail et la configuration des secrets. +Cela vous guidera dans l'installation de l'application GitHub, la création du workflow et la configuration des secrets. --- @@ -33,11 +33,11 @@ Ou vous pouvez le configurer manuellement. 1. **Installez l'application GitHub** -Rendez-vous sur [**github.com/apps/opencode-agent**](https://github.com/apps/opencode-agent). Assurez-vous qu'il est installé sur le référentiel cible. +Rendez-vous sur [**github.com/apps/opencode-agent**](https://github.com/apps/opencode-agent). Assurez-vous qu'il est installé sur le dépôt cible. -2. **Ajouter le flux de travail** +2. **Ajouter le workflow** -Ajoutez le fichier de workflow suivant à `.github/workflows/opencode.yml` dans votre référentiel. Assurez-vous de définir les clés `model` appropriées et API requises dans `env`. +Ajoutez le fichier de workflow suivant à `.github/workflows/opencode.yml` dans votre dépôt. Assurez-vous de définir les clés `model` appropriées et les clés API requises dans `env`. ```yml title=".github/workflows/opencode.yml" {24,26} name: opencode @@ -73,21 +73,21 @@ Ajoutez le fichier de workflow suivant à `.github/workflows/opencode.yml` dans # github_token: xxxx ``` -3. **Stockez les clés API en secret** +3. **Stockez les clés API dans les secrets** -Dans les **paramètres** de votre organisation ou de votre projet, développez **Secrets et variables** sur la gauche et sélectionnez **Actions**. Et ajoutez les clés API requises. +Dans les **paramètres** de votre organisation ou de votre projet, développez **Secrets et variables** sur la gauche et sélectionnez **Actions**. Puis ajoutez les clés API requises. --- ## Configuration -- `model` : Le modèle à utiliser avec OpenCode. Prend le format `provider/model`. Ceci est **obligatoire**. -- `agent` : l'agent à utiliser. Doit être un agent principal. Revient à `default_agent` à partir de la configuration ou à `"build"` s'il n'est pas trouvé. -- `share` : s'il faut partager la session OpenCode. La valeur par défaut est **true** pour les référentiels publics. -- `prompt` : invite personnalisée facultative pour remplacer le comportement par défaut. Utilisez-le pour personnaliser la façon dont OpenCode traite les demandes. -- `token` : jeton d'accès GitHub facultatif pour effectuer des opérations telles que la création de commentaires, la validation de modifications et l'ouverture de demandes d'extraction. Par défaut, OpenCode utilise le jeton d'accès à l'installation de l'application OpenCode GitHub, de sorte que les validations, les commentaires et les demandes d'extraction apparaissent comme provenant de l'application. +- `model` : Le modèle à utiliser avec OpenCode. Prend le format `provider/model`. Ceci est **obligatoire**. +- `agent` : l'agent à utiliser. Doit être un agent primaire. Revient à `default_agent` à partir de la configuration ou à `"build"` s'il n'est pas trouvé. +- `share` : s'il faut partager la session OpenCode. La valeur par défaut est **true** pour les référentiels publics. +- `prompt` : prompt personnalisé facultatif pour remplacer le comportement par défaut. Utilisez-le pour personnaliser la façon dont OpenCode traite les demandes. +- `token` : jeton d'accès GitHub facultatif pour effectuer des opérations telles que la création de commentaires, le commit de modifications et l'ouverture de pull requests. Par défaut, OpenCode utilise le jeton d'accès à l'installation de l'application OpenCode GitHub, de sorte que les commits, les commentaires et les pull requests apparaissent comme provenant de l'application. -Vous pouvez également utiliser le `GITHUB_TOKEN`](https://docs.github.com/en/actions/tutorials/authenticate-with-github_token) intégré du runner GitHub Actions sans installer l'application OpenCode GitHub. Assurez-vous simplement d'accorder les autorisations requises dans votre flux de travail : +Vous pouvez également utiliser le `GITHUB_TOKEN`](https://docs.github.com/en/actions/tutorials/authenticate-with-github_token) intégré du runner GitHub Actions sans installer l'application OpenCode GitHub. Assurez-vous simplement d'accorder les autorisations requises dans votre workflow : ```yaml permissions: @@ -97,26 +97,26 @@ permissions: issues: write ``` -Vous pouvez également utiliser un [jetons d'accès personnels](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)(PAT) si vous préférez. +Vous pouvez également utiliser un [jeton d'accès personnel](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)(PAT) si vous préférez. --- -## Événements pris en charge +## Événements supportés -OpenCode peut être déclenché par les événements GitHub suivants : +OpenCode peut être déclenché par les événements GitHub suivants : | Type d'événement | Déclenché par | Détails | | ----------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `issue_comment` | Commenter un problème ou un PR | Mentionnez `/opencode` ou `/oc` dans votre commentaire. OpenCode lit le contexte et peut créer des branches, ouvrir des PR ou répondre. | -| `pull_request_review_comment` | Commentez des lignes de code spécifiques dans un PR | Mentionnez `/opencode` ou `/oc` lors de la révision du code. OpenCode reçoit le chemin du fichier, les numéros de ligne et le contexte de comparaison. | -| `issues` | Numéro ouvert ou modifié | Déclenchez automatiquement OpenCode lorsque des problèmes sont créés ou modifiés. Nécessite une entrée `prompt`. | -| `pull_request` | PR ouvert ou mis à jour | Déclenchez automatiquement OpenCode lorsque les PR sont ouverts, synchronisés ou rouverts. Utile pour les avis automatisés. | -| `schedule` | Planification basée sur Cron | Exécutez OpenCode selon un planning. Nécessite une entrée `prompt`. La sortie va aux journaux et aux PR (aucun problème à commenter). | +| `issue_comment` | Commentaire sur une issue ou une PR | Mentionnez `/opencode` ou `/oc` dans votre commentaire. OpenCode lit le contexte et peut créer des branches, ouvrir des PR ou répondre. | +| `pull_request_review_comment` | Commentaire sur des lignes de code spécifiques dans une PR | Mentionnez `/opencode` ou `/oc` lors de la révision du code. OpenCode reçoit le chemin du fichier, les numéros de ligne et le contexte de comparaison. | +| `issues` | Issue ouverte ou modifiée | Déclenchez automatiquement OpenCode lorsque des issues sont créées ou modifiées. Nécessite une entrée `prompt`. | +| `pull_request` | PR ouverte ou mise à jour | Déclenchez automatiquement OpenCode lorsque les PR sont ouvertes, synchronisées ou rouvertes. Utile pour les revues automatisées. | +| `schedule` | Planification basée sur Cron | Exécutez OpenCode selon un planning. Nécessite une entrée `prompt`. La sortie va aux journaux et aux PR (pas de commentaire sur les issues). | | `workflow_dispatch` | Déclenchement manuel depuis l'interface utilisateur GitHub | Déclenchez OpenCode à la demande via l'onglet Actions. Nécessite une entrée `prompt`. La sortie va aux journaux et aux PR. | -### Exemple d'horaire +### Exemple de planification -Exécutez OpenCode selon un planning pour effectuer des tâches automatisées : +Exécutez OpenCode selon un planning pour effectuer des tâches automatisées : ```yaml title=".github/workflows/opencode-scheduled.yml" name: Scheduled OpenCode Task @@ -191,13 +191,13 @@ jobs: - Suggest improvements ``` -Pour les événements `pull_request`, si aucun `prompt` n'est fourni, OpenCode examine par défaut la demande d'extraction. +Pour les événements `pull_request`, si aucun `prompt` n'est fourni, OpenCode examine par défaut la pull request. --- -### Exemple de Issue Triage +### Exemple de Triage d'Issue -Triez automatiquement les nouveaux problèmes. Cet exemple filtre les comptes datant de plus de 30 jours pour réduire le spam : +Triez automatiquement les nouvelles issues. Cet exemple filtre les comptes datant de plus de 30 jours pour réduire le spam : ```yaml title=".github/workflows/opencode-triage.yml" name: Issue Triage @@ -252,7 +252,7 @@ Pour les événements `issues`, l'entrée `prompt` est **obligatoire** car il n' ## Invites personnalisées -Remplacez l'invite par défaut pour personnaliser le comportement de OpenCode pour votre flux de travail. +Remplacez l'invite par défaut pour personnaliser le comportement de OpenCode pour votre workflow. ```yaml title=".github/workflows/opencode.yml" - uses: anomalyco/opencode/github@latest @@ -273,9 +273,9 @@ Ceci est utile pour appliquer des critères d’évaluation spécifiques, des no Voici quelques exemples de la façon dont vous pouvez utiliser OpenCode dans GitHub. -- **Expliquez un problème** +- **Expliquer une issue** -Ajoutez ce commentaire dans un numéro GitHub. +Ajoutez ce commentaire dans une issue GitHub. ``` /opencode explain this issue @@ -283,38 +283,38 @@ Ajoutez ce commentaire dans un numéro GitHub. OpenCode lira l'intégralité du fil de discussion, y compris tous les commentaires, et répondra avec une explication claire. -- **Résoudre un problème** +- **Résoudre une issue** -Dans un numéro GitHub, dites : +Dans une issue GitHub, dites : ``` /opencode fix this ``` -Et OpenCode créera une nouvelle branche, mettra en œuvre les modifications et ouvrira un PR avec les modifications. +Et OpenCode créera une nouvelle branche, mettra en œuvre les modifications et ouvrira une PR avec les modifications. - **Examinez les PR et apportez des modifications** -Laissez le commentaire suivant sur un PR GitHub. +Laissez le commentaire suivant sur une PR GitHub. ``` Delete the attachment from S3 when the note is removed /oc ``` -OpenCode mettra en œuvre la modification demandée et la validera dans le même PR. +OpenCode mettra en œuvre la modification demandée et la validera dans la même PR. -- **Revoir des lignes de code spécifiques** +- **Revue de lignes de code spécifiques** -Laissez un commentaire directement sur les lignes de code dans l'onglet "Fichiers" du PR. OpenCode détecte automatiquement le fichier, les numéros de ligne et le contexte de comparaison pour fournir des réponses précises. +Laissez un commentaire directement sur les lignes de code dans l'onglet "Fichiers" de la PR. OpenCode détecte automatiquement le fichier, les numéros de ligne et le contexte de comparaison pour fournir des réponses précises. ``` [Comment on specific lines in Files tab] /oc add error handling here ``` -Lorsqu'il commente des lignes spécifiques, OpenCode reçoit : +Lorsqu'il commente des lignes spécifiques, OpenCode reçoit : -- Le dossier exact en cours d'examen +- Le fichier exact en cours d'examen - Les lignes de code spécifiques - Le contexte différentiel environnant - Informations sur le numéro de ligne diff --git a/packages/web/src/content/docs/fr/gitlab.mdx b/packages/web/src/content/docs/fr/gitlab.mdx index 8fb312501..db4b1c1a4 100644 --- a/packages/web/src/content/docs/fr/gitlab.mdx +++ b/packages/web/src/content/docs/fr/gitlab.mdx @@ -1,6 +1,6 @@ --- title: GitLab -description: Utilisez OpenCode dans les problèmes GitLab et les demandes de fusion. +description: Utilisez OpenCode dans les issues GitLab et les merge requests. --- OpenCode s'intègre à votre flux de travail GitLab via votre pipeline CI/CD GitLab ou avec GitLab Duo. @@ -17,17 +17,17 @@ Ici, nous utilisons un composant CI/CD créé par la communauté pour OpenCode --- -### Caractéristiques +### Fonctionnalités -- **Utiliser une configuration personnalisée par tâche** : configurez OpenCode avec un répertoire de configuration personnalisé, par exemple `./config/#custom-directory` pour activer ou désactiver la fonctionnalité par appel OpenCode. -- **Configuration minimale** : le composant CI configure OpenCode en arrière-plan, il vous suffit de créer la configuration OpenCode et l'invite initiale. -- **Flexible** : le composant CI prend en charge plusieurs entrées pour personnaliser son comportement +- **Utiliser une configuration personnalisée par tâche** : configurez OpenCode avec un répertoire de configuration personnalisé, par exemple `./config/#custom-directory` pour activer ou désactiver la fonctionnalité pour chaque appel d'OpenCode. +- **Configuration minimale** : le composant CI configure OpenCode en arrière-plan, il vous suffit de créer la configuration OpenCode et le prompt initial. +- **Flexible** : le composant CI prend en charge plusieurs entrées pour personnaliser son comportement --- ### Installation -1. Stockez votre authentification OpenCode JSON en tant que variables d'environnement CI de type fichier sous **Paramètres** > **CI/CD** > **Variables**. Assurez-vous de les marquer comme « Masqués et cachés ». +1. Stockez votre authentification OpenCode JSON en tant que variables d'environnement CI de type fichier sous **Paramètres** > **CI/CD** > **Variables**. Assurez-vous de les marquer comme « Masquées et protégées ». 2. Ajoutez ce qui suit à votre fichier `.gitlab-ci.yml`. ```yaml title=".gitlab-ci.yml" @@ -40,7 +40,7 @@ Ici, nous utilisons un composant CI/CD créé par la communauté pour OpenCode message: "Your prompt here" ``` -Pour plus d'entrées et de cas d'utilisation [consultez la docs](https://gitlab.com/explore/catalog/nagyv/gitlab-opencode) pour ce composant. +Pour plus d'entrées et de cas d'utilisation [consultez la doc](https://gitlab.com/explore/catalog/nagyv/gitlab-opencode) pour ce composant. --- @@ -51,21 +51,21 @@ Mentionnez `@opencode` dans un commentaire et OpenCode exécutera les tâches au --- -### Caractéristiques +### Fonctionnalités -- **Problèmes de triage** : demandez à OpenCode d'examiner un problème et de vous l'expliquer. -- **Réparer et implémenter** : demandez à OpenCode de résoudre un problème ou d'implémenter une fonctionnalité. - Cela créera une nouvelle branche et déclenchera une demande de fusion avec les modifications. -- **Sécurisé** : OpenCode fonctionne sur vos runners GitLab. +- **Triage d'issues** : demandez à OpenCode d'examiner une issue et de vous l'expliquer. +- **Correction et implémentation** : demandez à OpenCode de résoudre une issue ou d'implémenter une fonctionnalité. + Cela créera une nouvelle branche et déclenchera une merge request avec les modifications. +- **Sécurisé** : OpenCode fonctionne sur vos runners GitLab. --- ### Installation -OpenCode s'exécute dans votre pipeline CI/CD GitLab. Voici ce dont vous aurez besoin pour le configurer : +OpenCode s'exécute dans votre pipeline CI/CD GitLab. Voici ce dont vous aurez besoin pour le configurer : :::tip -Consultez les [**GitLab docs**](https://docs.gitlab.com/user/duo_agent_platform/agent_assistant/) pour obtenir des instructions à jour. +Consultez la [**documentation GitLab**](https://docs.gitlab.com/user/duo_agent_platform/agent_assistant/) pour obtenir des instructions à jour. ::: 1. Configurez votre environnement GitLab @@ -73,7 +73,7 @@ Consultez les [**GitLab docs**](https://docs.gitlab.com/user/duo_agent_platform/ 3. Obtenez la clé API d'un fournisseur de modèles d'IA 4. Créer un compte de service 5. Configurer les variables CI/CD -6. Créez un fichier de configuration de flux, voici un exemple : +6. Créez un fichier de configuration de flux, voici un exemple :
@@ -164,32 +164,32 @@ Voici quelques exemples de la façon dont vous pouvez utiliser OpenCode dans Git Vous pouvez configurer pour utiliser une phrase de déclenchement différente de `@opencode`. ::: -- **Expliquez un problème** +- **Expliquer une issue** -Ajoutez ce commentaire dans un numéro GitLab. +Ajoutez ce commentaire dans une issue GitLab. ``` @opencode explain this issue ``` -OpenCode lira le problème et répondra avec une explication claire. +OpenCode lira l'issue et répondra avec une explication claire. -- **Résoudre un problème** +- **Résoudre une issue** -Dans un numéro GitLab, dites : +Dans une issue GitLab, dites : ``` @opencode fix this ``` -OpenCode créera une nouvelle branche, mettra en œuvre les modifications et ouvrira une demande de fusion avec les modifications. +OpenCode créera une nouvelle branche, mettra en œuvre les modifications et ouvrira une merge request avec les modifications. -- **Examiner les demandes de fusion** +- **Revue de merge request** -Laissez le commentaire suivant sur une demande de fusion GitLab. +Laissez le commentaire suivant sur une merge request GitLab. ``` @opencode review this merge request ``` -OpenCode examinera la demande de fusion et fournira des commentaires. +OpenCode examinera la merge request et fournira des commentaires. diff --git a/packages/web/src/content/docs/fr/ide.mdx b/packages/web/src/content/docs/fr/ide.mdx index 1553c5223..fc0c52619 100644 --- a/packages/web/src/content/docs/fr/ide.mdx +++ b/packages/web/src/content/docs/fr/ide.mdx @@ -7,18 +7,18 @@ OpenCode s'intègre à VS Code, Cursor ou tout IDE prenant en charge un terminal --- -## Usage +## Utilisation -- **Lancement rapide** : utilisez `Cmd+Esc` (Mac) ou `Ctrl+Esc` (Windows/Linux) pour ouvrir OpenCode dans une vue de terminal divisée, ou concentrez-vous sur une session de terminal existante si elle est déjà en cours d'exécution. -- **Nouvelle session** : utilisez `Cmd+Shift+Esc` (Mac) ou `Ctrl+Shift+Esc` (Windows/Linux) pour démarrer une nouvelle session de terminal OpenCode, même si elle est déjà ouverte. Vous pouvez également cliquer sur le bouton OpenCode dans l'interface utilisateur. -- **Conscience du contexte** : partagez automatiquement votre sélection ou onglet actuel avec OpenCode. -- **Raccourcis de référence de fichier** : utilisez `Cmd+Option+K` (Mac) ou `Alt+Ctrl+K` (Linux/Windows) pour insérer des références de fichier. Par exemple, `@File#L37-42`. +- **Lancement rapide** : utilisez `Cmd+Esc` (Mac) ou `Ctrl+Esc` (Windows/Linux) pour ouvrir OpenCode dans une vue de terminal divisée, ou focus sur une session de terminal existante si elle est déjà en cours d'exécution. +- **Nouvelle session** : utilisez `Cmd+Shift+Esc` (Mac) ou `Ctrl+Shift+Esc` (Windows/Linux) pour démarrer une nouvelle session de terminal OpenCode, même si elle est déjà ouverte. Vous pouvez également cliquer sur le bouton OpenCode dans l'interface utilisateur. +- **Contexte** : partagez automatiquement votre sélection ou onglet actuel avec OpenCode. +- **Raccourcis de référence de fichier** : utilisez `Cmd+Option+K` (Mac) ou `Alt+Ctrl+K` (Linux/Windows) pour insérer des références de fichier. Par exemple, `@File#L37-42`. --- ## Installation -Pour installer OpenCode sur VS Code et les forks populaires comme Cursor, Windsurf, VSCodium : +Pour installer OpenCode sur VS Code et les forks populaires comme Cursor, Windsurf, VSCodium : 1. Ouvrir VS Code 2. Ouvrez le terminal intégré @@ -36,13 +36,13 @@ Recherchez **OpenCode** dans Extension Marketplace et cliquez sur **Installer**. ### Dépannage -Si l'extension ne parvient pas à s'installer automatiquement : +Si l'extension ne parvient pas à s'installer automatiquement : - Assurez-vous que vous exécutez `opencode` dans le terminal intégré. -- Confirmez que la CLI de votre IDE est installée : +- Confirmez que la CLI de votre IDE est installée : - Pour VS Code : commande `code` - Pour Cursor : commande `cursor` - Pour Windsurf : commande `windsurf` - Pour VSCodium : commande `codium` - - Sinon, exécutez `Cmd+Shift+P` (Mac) ou `Ctrl+Shift+P` (Windows/Linux) et recherchez « Commande Shell : installez la commande 'code' dans PATH » (ou l'équivalent pour votre IDE) + - Sinon, exécutez `Cmd+Shift+P` (Mac) ou `Ctrl+Shift+P` (Windows/Linux) et recherchez « Shell Command: Install 'code' command in PATH » (ou l'équivalent pour votre IDE) - Assurez-vous que VS Code est autorisé à installer des extensions diff --git a/packages/web/src/content/docs/fr/index.mdx b/packages/web/src/content/docs/fr/index.mdx index 72c8dbd19..06d650de7 100644 --- a/packages/web/src/content/docs/fr/index.mdx +++ b/packages/web/src/content/docs/fr/index.mdx @@ -15,65 +15,65 @@ Commençons. --- -#### Conditions préalables +#### Prérequis -Pour utiliser OpenCode dans votre terminal, vous aurez besoin de : +Pour utiliser OpenCode dans votre terminal, vous aurez besoin de : -1. Un émulateur de terminal moderne comme : +1. Un émulateur de terminal moderne comme : - [WezTerm](https://wezterm.org), multiplateforme - [Alacritty](https://alacritty.org), multiplateforme - [Ghostty](https://ghostty.org), Linux et macOS - [Kitty](https://sw.kovidgoyal.net/kitty/), Linux et macOS -2. Clés API pour les fournisseurs LLM que vous souhaitez utiliser. +2. Clés API pour les fournisseurs de LLM que vous souhaitez utiliser. --- -## Installer +## Installation -Le moyen le plus simple d'installer OpenCode consiste à utiliser le script d'installation. +Le moyen le plus simple d'installer OpenCode est d'utiliser le script d'installation. ```bash curl -fsSL https://opencode.ai/install | bash ``` -Vous pouvez également l'installer avec les commandes suivantes : +Vous pouvez également l'installer avec les commandes suivantes : -- **En utilisant Node.js** +- **Node.js** - + ```bash npm install -g opencode-ai ``` - + - - ```bash - bun install -g opencode-ai - ``` + + ```bash + bun install -g opencode-ai + ``` - + - - ```bash - pnpm install -g opencode-ai - ``` + + ```bash + pnpm install -g opencode-ai + ``` - + - - ```bash - yarn global add opencode-ai - ``` + + ```bash + yarn global add opencode-ai + ``` -- **Utilisation de Homebrew sur macOS et Linux** +- **Via Homebrew sur macOS et Linux** ```bash brew install anomalyco/tap/opencode @@ -81,7 +81,7 @@ Vous pouvez également l'installer avec les commandes suivantes : > Nous vous recommandons d'utiliser le tap OpenCode pour les versions les plus récentes. La formule officielle `brew install opencode` est maintenue par l'équipe Homebrew et est mise à jour moins fréquemment. -- **Utilisation de Paru sur Arch Linux** +- **Via Paru sur Arch Linux** ```bash paru -S opencode-bin @@ -89,55 +89,54 @@ Vous pouvez également l'installer avec les commandes suivantes : #### Windows -:::tip[Recommandé : utilisez WSL] +:::tip[Recommandé : utilisez WSL] Pour une expérience optimale sur Windows, nous vous recommandons d'utiliser le [Windows Subsystem for Linux (WSL)](/docs/windows-wsl). Il offre de meilleures performances et une compatibilité totale avec les fonctionnalités de OpenCode. ::: -- **Utiliser Chocolatey** +- **Via Chocolatey** ```bash choco install opencode ``` -- **Utilisation de Scoop** +- **Via Scoop** ```bash scoop install opencode ``` -- **En utilisant NPM** +- **Via NPM** ```bash npm install -g opencode-ai ``` -- **Utiliser Mise** +- **Via Mise** ```bash mise use -g github:anomalyco/opencode ``` -- **En utilisant Docker** +- **Via Docker** ```bash docker run -it --rm ghcr.io/anomalyco/opencode ``` -La prise en charge de l'installation de OpenCode sur Windows à l'aide de Bun est actuellement en cours. +Le support de l'installation de OpenCode sur Windows à l'aide de Bun est actuellement en cours de développement. -Vous pouvez également récupérer le binaire dans le fichier [Releases](https://github.com/anomalyco/opencode/releases). +Vous pouvez également récupérer le binaire dans les [Releases](https://github.com/anomalyco/opencode/releases). --- -## Configurer +## Configuration -Avec OpenCode, vous pouvez utiliser n'importe quel fournisseur LLM en configurant ses clés API. +Avec OpenCode, vous pouvez utiliser n'importe quel fournisseur de LLM en configurant ses clés API. -Si vous débutez avec les fournisseurs LLM, nous vous recommandons d'utiliser [OpenCode Zen](/docs/zen). -Il s'agit d'une liste organisée de modèles qui ont été testés et vérifiés par le OpenCode -équipe. +Si vous débutez avec les fournisseurs de LLM, nous vous recommandons d'utiliser [OpenCode Zen](/docs/zen). +C'est une liste curée de modèles qui ont été testés et vérifiés par l'équipe OpenCode. -1. Exécutez la commande `/connect` dans le TUI, sélectionnez opencode et dirigez-vous vers [opencode.ai/auth](https://opencode.ai/auth). +1. Exécutez la commande `/connect` dans le TUI, sélectionnez opencode et allez sur [opencode.ai/auth](https://opencode.ai/auth). ```txt /connect @@ -158,10 +157,9 @@ Vous pouvez également sélectionner l'un des autres fournisseurs. [En savoir pl --- -## Initialiser +## Initialisation -Maintenant que vous avez configuré un fournisseur, vous pouvez accéder à un projet qui -vous voulez travailler. +Maintenant que vous avez configuré un fournisseur, vous pouvez accéder à un projet sur lequel vous voulez travailler. ```bash cd /path/to/project @@ -179,29 +177,25 @@ Ensuite, initialisez OpenCode pour le projet en exécutant la commande suivante. /init ``` -Cela permettra à OpenCode d'analyser votre projet et de créer un fichier `AGENTS.md` dans -la racine du projet. +Cela permettra à OpenCode d'analyser votre projet et de créer un fichier `AGENTS.md` à la racine du projet. :::tip Vous devez valider le fichier `AGENTS.md` de votre projet dans Git. ::: -Cela aide OpenCode à comprendre la structure du projet et les modèles de codage -utilisé. +Cela aide OpenCode à comprendre la structure du projet et les modèles de codage utilisés. --- -## Usage +## Utilisation -Vous êtes maintenant prêt à utiliser OpenCode pour travailler sur votre projet. N'hésitez pas à le demander -rien! +Vous êtes maintenant prêt à utiliser OpenCode pour travailler sur votre projet. N'hésitez pas à lui demander n'importe quoi ! -Si vous débutez dans l'utilisation d'un agent de codage IA, voici quelques exemples qui pourraient -aide. +Si vous débutez dans l'utilisation d'un agent de codage IA, voici quelques exemples qui pourraient aider. --- -### Posez des questions +### Poser des questions Vous pouvez demander à OpenCode de vous expliquer la base de code. @@ -223,8 +217,7 @@ Vous pouvez demander à OpenCode d'ajouter de nouvelles fonctionnalités à votr 1. **Créer un plan** -OpenCode dispose d'un _Mode Plan_ qui désactive sa capacité à apporter des modifications et -suggérez plutôt _comment_ il implémentera la fonctionnalité. +OpenCode dispose d'un _Mode Plan_ qui désactive sa capacité à apporter des modifications et suggère plutôt _comment_ il implémentera la fonctionnalité. Accédez-y à l'aide de la touche **Tab**. Vous verrez un indicateur à cet effet dans le coin inférieur droit. @@ -240,12 +233,10 @@ Décrivons maintenant ce que nous voulons qu'il fasse. From this screen, the user can undelete a note or permanently delete it. ``` -Vous souhaitez donner à OpenCode suffisamment de détails pour comprendre ce que vous voulez. Ça aide -pour lui parler comme si vous parliez à un développeur junior de votre équipe. +Vous souhaitez donner à OpenCode suffisamment de détails pour comprendre ce que vous voulez. Ça aide pour lui parler comme si vous parliez à un développeur junior de votre équipe. :::tip -Donnez à OpenCode beaucoup de contexte et d'exemples pour l'aider à comprendre ce que vous -vouloir. +Donnez à OpenCode beaucoup de contexte et d'exemples pour l'aider à comprendre ce que vous voulez. ::: 2. **Itérer sur le plan** @@ -258,22 +249,20 @@ Une fois qu'il vous donne un plan, vous pouvez lui faire part de vos commentaire ``` :::tip -Faites glisser et déposez des images dans le terminal pour les ajouter à l'invite. +Glissez-déposez des images dans le terminal pour les ajouter à l'invite. ::: -OpenCode peut numériser toutes les images que vous lui donnez et les ajouter à l'invite. Tu peux -faites-le en faisant glisser et en déposant une image dans le terminal. +OpenCode peut scanner toutes les images que vous lui donnez et les ajouter à l'invite. Vous pouvez le faire en glissant et en déposant une image dans le terminal. 3. **Créez la fonctionnalité** -Une fois que vous vous sentez à l'aise avec le plan, revenez au _Mode Build_ en -appuyer à nouveau sur la touche **Tab**. +Une fois que vous vous sentez à l'aise avec le plan, revenez au _Mode Build_ en appuyant à nouveau sur la touche **Tab**. ```bash frame="none" ``` -Et lui demander d'apporter les modifications. +Et demandez-lui d'apporter les modifications. ```bash frame="none" Sounds good! Go ahead and make the changes. @@ -283,8 +272,7 @@ Et lui demander d'apporter les modifications. ### Apporter des modifications -Pour des modifications plus simples, vous pouvez demander à OpenCode de le construire directement -sans avoir à revoir le plan au préalable. +Pour des modifications plus simples, vous pouvez demander à OpenCode de construire directement sans avoir à revoir le plan au préalable. ```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 +280,7 @@ handled in the /notes route in @packages/functions/src/notes.ts and implement the same logic in @packages/functions/src/settings.ts ``` -Vous voulez vous assurer de fournir une bonne quantité de détails afin que OpenCode fasse le bon choix. -changements. +Vous devez fournir suffisamment de détails pour qu'OpenCode effectue les bonnes modifications. --- @@ -305,15 +292,13 @@ Disons que vous demandez à OpenCode d'apporter quelques modifications. Can you refactor the function in @packages/functions/src/api/index.ts? ``` -Mais vous réalisez que ce n’est pas ce que vous vouliez. Vous **pouvez annuler** les modifications -à l'aide de la commande `/undo`. +Mais vous réalisez que ce n’est pas ce que vous vouliez. Vous **pouvez annuler** les modifications à l'aide de la commande `/undo`. ```bash frame="none" /undo ``` -OpenCode annulera désormais les modifications que vous avez apportées et affichera votre message d'origine -encore. +OpenCode annulera désormais les modifications que vous avez apportées et affichera votre message d'origine encore. ```txt frame="none" "@packages/functions/src/api/index.ts" Can you refactor the function in @packages/functions/src/api/index.ts? @@ -335,8 +320,7 @@ Ou vous **pouvez refaire** les modifications à l'aide de la commande `/redo`. ## Partager -Les conversations que vous avez avec OpenCode peuvent être [partagées avec votre -équipe](/docs/share). +Les conversations que vous avez avec OpenCode peuvent être [partagées avec votre équipe](/docs/share). ```bash frame="none" /share diff --git a/packages/web/src/content/docs/fr/keybinds.mdx b/packages/web/src/content/docs/fr/keybinds.mdx index d998eeb62..4ec98adfa 100644 --- a/packages/web/src/content/docs/fr/keybinds.mdx +++ b/packages/web/src/content/docs/fr/keybinds.mdx @@ -105,7 +105,7 @@ OpenCode a une liste de raccourcis clavier que vous pouvez personnaliser via la --- -## Leader key +## Touche Leader OpenCode utilise une touche `leader` pour la plupart des raccourcis clavier. Cela évite les conflits dans votre terminal. @@ -117,7 +117,7 @@ Vous n'avez pas besoin d'utiliser une touche leader pour vos raccourcis clavier, ## Désactiver le raccourci clavier -Vous pouvez désactiver un raccourci clavier en ajoutant la clé à votre configuration avec la valeur « aucun ». +Vous pouvez désactiver un raccourci clavier en ajoutant la clé à votre configuration avec la valeur `none`. ```json title="opencode.json" { @@ -130,9 +130,9 @@ Vous pouvez désactiver un raccourci clavier en ajoutant la clé à votre config --- -## Raccourcis d'invite du bureau +## Raccourcis de saisie desktop -L'entrée d'invite de l'application de bureau OpenCode prend en charge les raccourcis courants de style Readline/Emacs pour l'édition de texte. Ceux-ci sont intégrés et actuellement non configurables via `opencode.json`. +Le champ de saisie de l'application de bureau OpenCode prend en charge les raccourcis courants de style Readline/Emacs pour l'édition de texte. Ceux-ci sont intégrés et actuellement non configurables via `opencode.json`. | Raccourci | Actions | | --------- | --------------------------------------------------------- | @@ -143,10 +143,10 @@ L'entrée d'invite de l'application de bureau OpenCode prend en charge les racco | `alt+b` | Reculer le curseur d'un mot | | `alt+f` | Avancer le curseur d'un mot | | `ctrl+d` | Supprimer le caractère sous le curseur | -| `ctrl+k` | Tuer jusqu'au bout de la ligne | -| `ctrl+u` | Tuer au début de la ligne | -| `ctrl+w` | Tuer le mot précédent | -| `alt+d` | Tuer le mot suivant | +| `ctrl+k` | Couper jusqu'à la fin de la ligne | +| `ctrl+u` | Couper jusqu'au début de la ligne | +| `ctrl+w` | Couper le mot précédent | +| `alt+d` | Couper le mot suivant | | `ctrl+t` | Transposer les caractères | | `ctrl+g` | Annuler les popovers/abandonner l'exécution de la réponse | @@ -164,7 +164,7 @@ Ouvrez votre `settings.json` à : %LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json ``` -Ajoutez ceci au tableau `actions` de niveau racine : +Ajoutez ceci au tableau `actions` de niveau racine : ```json "actions": [ @@ -178,7 +178,7 @@ Ajoutez ceci au tableau `actions` de niveau racine : ] ``` -Ajoutez ceci au tableau `keybindings` de niveau racine : +Ajoutez ceci au tableau `keybindings` de niveau racine : ```json "keybindings": [ diff --git a/packages/web/src/content/docs/fr/lsp.mdx b/packages/web/src/content/docs/fr/lsp.mdx index ceeda45a8..cf2dfb618 100644 --- a/packages/web/src/content/docs/fr/lsp.mdx +++ b/packages/web/src/content/docs/fr/lsp.mdx @@ -3,19 +3,19 @@ title: Serveurs LSP description: OpenCode s'intègre à vos serveurs LSP. --- -OpenCode s'intègre à votre protocole de serveur de langue (LSP) pour aider le LLM à interagir avec votre base de code. Il utilise des diagnostics pour fournir des commentaires au LLM. +OpenCode s'intègre via le protocole LSP (Language Server Protocol) pour aider le LLM à interagir avec votre base de code. Il utilise des diagnostics pour fournir des commentaires au LLM. --- -## Intégré +## Serveurs intégrés -OpenCode est livré avec plusieurs serveurs LSP intégrés pour les langues populaires : +OpenCode est livré avec plusieurs serveurs LSP intégrés pour les langages populaires : -| Serveur LSP | Rallonges | Exigences | +| Serveur LSP | Extensions | Prérequis | | ------------------ | ------------------------------------------------------------------- | ----------------------------------------------------------------------- | -| astro | .astro | Installations automatiques pour les projets Astro | -| bash | .sh, .bash, .zsh, .ksh | Installe automatiquement le serveur bash-langage | -| clangd | .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++ | Installations automatiques pour les projets C/C++ | +| astro | .astro | Installation automatique pour les projets Astro | +| bash | .sh, .bash, .zsh, .ksh | Installe automatiquement le serveur bash-language-server | +| clangd | .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++ | Installation automatique pour les projets C/C++ | | csharp | .cs | `.NET SDK` installé | | clojure-lsp | .clj, .cljs, .cljc, .edn | Commande `clojure-lsp` disponible | | dart | .dart | Commande `dart` disponible | @@ -27,23 +27,23 @@ OpenCode est livré avec plusieurs serveurs LSP intégrés pour les langues popu | gopls | .go | Commande `go` disponible | | hls | .hs, .lhs | Commande `haskell-language-server-wrapper` disponible | | jdtls | .java | `Java SDK (version 21+)` installé | -| kotlin-ls | .kt, .kts | Installations automatiques pour les projets Kotlin | -| lua-ls | .lua | Installations automatiques pour les projets Lua | +| kotlin-ls | .kt, .kts | Installation automatique pour les projets Kotlin | +| lua-ls | .lua | Installation automatique pour les projets Lua | | nixd | .nix | Commande `nixd` disponible | | ocaml-lsp | .ml, .mli | Commande `ocamllsp` disponible | | oxlint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte | Dépendance `oxlint` dans le projet | -| php intelephense | .php | Installations automatiques pour les projets PHP | +| php intelephense | .php | Installation automatique pour les projets PHP | | prisma | .prisma | Commande `prisma` disponible | | pyright | .py, .pyi | Dépendance `pyright` installée | | ruby-lsp (rubocop) | .rb, .rake, .gemspec, .ru | Commandes `ruby` et `gem` disponibles | | rust | .rs | Commande `rust-analyzer` disponible | | sourcekit-lsp | .swift, .objc, .objcpp | `swift` installé (`xcode` sur macOS) | -| svelte | .svelte | Installations automatiques pour les projets Svelte | -| terraform | .tf, .tfvars | Installations automatiques à partir des versions GitHub | -| tinymist | .typ, .typc | Installations automatiques à partir des versions GitHub | +| svelte | .svelte | Installation automatique pour les projets Svelte | +| terraform | .tf, .tfvars | Installation automatique à partir des versions GitHub | +| tinymist | .typ, .typc | Installation automatique à partir des versions GitHub | | typescript | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts | Dépendance `typescript` dans le projet | -| vue | .vue | Installations automatiques pour les projets Vue | -| yaml-ls | .yaml, .yml | Installe automatiquement le serveur yaml-langage-Red Hat | +| vue | .vue | Installation automatique pour les projets Vue | +| yaml-ls | .yaml, .yml | Installe automatiquement le serveur yaml-language-server de Red Hat | | zls | .zig, .zon | Commande `zig` disponible | Les serveurs LSP sont automatiquement activés lorsque l'une des extensions de fichier ci-dessus est détectée et que les exigences sont remplies. @@ -56,14 +56,14 @@ Vous pouvez désactiver les téléchargements automatiques du serveur LSP en dé ## Comment ça marche -Lorsque opencode ouvre un fichier, il : +Lorsque opencode ouvre un fichier, il : 1. Vérifie l'extension du fichier par rapport à tous les serveurs LSP activés. 2. Démarre le serveur LSP approprié s'il n'est pas déjà en cours d'exécution. --- -## Configurer +## Configuration Vous pouvez personnaliser les serveurs LSP via la section `lsp` de votre configuration opencode. @@ -74,9 +74,9 @@ Vous pouvez personnaliser les serveurs LSP via la section `lsp` de votre configu } ``` -Chaque serveur LSP prend en charge les éléments suivants : +Chaque serveur LSP prend en charge les éléments suivants : -| Propriété | Tapez | Descriptif | +| Propriété | Type | Description | | ---------------- | -------- | ---------------------------------------------------------------- | | `disabled` | booléen | Définissez ceci sur `true` pour désactiver le serveur LSP | | `command` | chaîne[] | La commande pour démarrer le serveur LSP | @@ -90,7 +90,7 @@ Regardons quelques exemples. ### Variables d'environnement -Utilisez la propriété `env` pour définir les variables d'environnement lors du démarrage du serveur LSP : +Utilisez la propriété `env` pour définir les variables d'environnement lors du démarrage du serveur LSP : ```json title="opencode.json" {5-7} { @@ -109,7 +109,7 @@ Utilisez la propriété `env` pour définir les variables d'environnement lors d ### Options d'initialisation -Utilisez la propriété `initialization` pour transmettre les options d'initialisation au serveur LSP. Il s'agit de paramètres spécifiques au serveur envoyés lors de la requête LSP `initialize` : +Utilisez la propriété `initialization` pour transmettre les options d'initialisation au serveur LSP. Il s'agit de paramètres spécifiques au serveur envoyés lors de la requête LSP `initialize` : ```json title="opencode.json" {5-9} { @@ -134,7 +134,7 @@ Les options d'initialisation varient selon le serveur LSP. Consultez la document ### Désactivation des serveurs LSP -Pour désactiver **tous** les serveurs LSP dans le monde, définissez `lsp` sur `false` : +Pour désactiver **tous** les serveurs LSP globalement, définissez `lsp` sur `false` : ```json title="opencode.json" {3} { @@ -143,7 +143,7 @@ Pour désactiver **tous** les serveurs LSP dans le monde, définissez `lsp` sur } ``` -Pour désactiver un serveur LSP **spécifique**, définissez `disabled` sur `true` : +Pour désactiver un serveur LSP **spécifique**, définissez `disabled` sur `true` : ```json title="opencode.json" {5} { @@ -160,7 +160,7 @@ Pour désactiver un serveur LSP **spécifique**, définissez `disabled` sur `tru ### Serveurs LSP personnalisés -Vous pouvez ajouter des serveurs LSP personnalisés en spécifiant les extensions de commande et de fichier : +Vous pouvez ajouter des serveurs LSP personnalisés en spécifiant les extensions de commande et de fichier : ```json title="opencode.json" {4-7} { @@ -176,13 +176,13 @@ Vous pouvez ajouter des serveurs LSP personnalisés en spécifiant les extension --- -## Informations Complémentaires +## Informations supplémentaires ### PHP Intelephense PHP Intelephense offre des fonctionnalités premium via une clé de licence. Vous pouvez fournir une clé de licence en plaçant (uniquement) la clé dans un fichier texte à l'adresse : -- Le macOS/Linux : `$HOME/intelephense/license.txt` -- Le Windows : `%USERPROFILE%/intelephense/license.txt` +- macOS/Linux : `$HOME/intelephense/license.txt` +- Windows : `%USERPROFILE%/intelephense/license.txt` Le fichier doit contenir uniquement la clé de licence sans contenu supplémentaire. diff --git a/packages/web/src/content/docs/fr/mcp-servers.mdx b/packages/web/src/content/docs/fr/mcp-servers.mdx index 4c703bfa3..e1d1f24e7 100644 --- a/packages/web/src/content/docs/fr/mcp-servers.mdx +++ b/packages/web/src/content/docs/fr/mcp-servers.mdx @@ -21,7 +21,7 @@ Certains serveurs MCP, comme le serveur GitHub MCP, ont tendance à ajouter beau --- -## Activer +## Activation Vous pouvez définir des serveurs MCP dans votre [OpenCode Config](https://opencode.ai/docs/config/) sous `mcp`. Ajoutez chaque MCP avec un nom unique. Vous pouvez faire référence à ce MCP par son nom lorsque vous demandez le LLM. @@ -48,6 +48,476 @@ Vous pouvez également désactiver un serveur en définissant `enabled` sur `fal Les organisations peuvent fournir des serveurs MCP par défaut via leur point de terminaison `.well-known/opencode`. Ces serveurs peuvent être désactivés par défaut, permettant aux utilisateurs de choisir ceux dont ils ont besoin. +Pour activer un serveur spécifique à partir de la configuration distante de votre organisation, ajoutez-le à votre configuration locale avec `enabled: true` : + +```json title="opencode.json" +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "jira": { + "type": "remote", + "url": "https://jira.example.com/mcp", + "enabled": true + } + } +} +``` + +Vos valeurs de configuration locales remplacent les valeurs par défaut distantes. Voir [config precedence](/docs/config#precedence-order) pour plus de détails. + +--- + +## Local + +Ajoutez des serveurs MCP locaux en définissant `type` sur `"local"` dans l'objet MCP. + +```jsonc title="opencode.jsonc" {15} +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "my-local-mcp-server": { + "type": "local", + // Or ["bun", "x", "my-mcp-command"] + "command": ["npx", "-y", "my-mcp-command"], + "enabled": true, + "environment": { + "MY_ENV_VAR": "my_env_var_value", + }, + }, + }, +} +``` + +La commande indique comment le serveur MCP local est démarré. Vous pouvez également transmettre une liste de variables d’environnement. + +Par exemple, voici comment ajouter le serveur de test [`@modelcontextprotocol/server-everything`](https://www.npmjs.com/package/@modelcontextprotocol/server-everything) MCP. + +```jsonc title="opencode.jsonc" +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "mcp_everything": { + "type": "local", + "command": ["npx", "-y", "@modelcontextprotocol/server-everything"], + }, + }, +} +``` + +Et pour l'utiliser, je peux ajouter `use the mcp_everything tool` à mes prompts. + +```txt "mcp_everything" +use the mcp_everything tool to add the number 3 and 4 +``` + +--- + +#### Options + +Voici toutes les options pour configurer un serveur MCP local. + +| Options | Type | Obligatoire | Description | +| ------------- | ------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------- | +| `type` | Chaîne | Oui | Le type de connexion au serveur MCP doit être `"local"`. | +| `command` | Tableau | Oui | Commande et arguments pour exécuter le serveur MCP. | +| `environment` | Objet | | Variables d'environnement à définir lors de l'exécution du serveur. | +| `enabled` | Booléen | | Activez ou désactivez le serveur MCP au démarrage. | +| `timeout` | Numéro | | Délai d'expiration en ms pour la récupération des outils depuis le serveur MCP. La valeur par défaut est 5 000 (5 secondes). | + +--- + +## Distant + +Ajoutez des serveurs MCP distants en définissant `type` sur `"remote"`. + +```json title="opencode.json" +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "my-remote-mcp": { + "type": "remote", + "url": "https://my-mcp-server.com", + "enabled": true, + "headers": { + "Authorization": "Bearer MY_API_KEY" + } + } + } +} +``` + +Le champ `url` est l'URL du serveur MCP distant et l'option `headers` vous permet de transmettre des en-têtes. + +--- + +#### Options + +| Options | Type | Obligatoire | Description | +| --------- | ------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------- | +| `type` | Chaîne | Oui | Le type de connexion au serveur MCP doit être `"remote"`. | +| `url` | Chaîne | Oui | URL du serveur MCP distant. | +| `enabled` | Booléen | | Activez ou désactivez le serveur MCP au démarrage. | +| `headers` | Objet | | En-têtes à envoyer avec la demande. | +| `oauth` | Objet | | Configuration de l'authentification OAuth. Voir la section [OAuth](#oauth) ci-dessous. | +| `timeout` | Numéro | | Délai d'expiration en ms pour la récupération des outils depuis le serveur MCP. La valeur par défaut est 5 000 (5 secondes). | + +--- + +## OAuth + +OpenCode gère automatiquement l'authentification OAuth pour les serveurs MCP distants. Lorsqu'un serveur nécessite une authentification, OpenCode : + +1. Détecte la réponse 401 et lance le flux OAuth +2. Utilise **Enregistrement client dynamique (RFC 7591)** s'il est pris en charge par le serveur. +3. Stocke les jetons en toute sécurité pour les demandes futures + +--- + +### Automatique + +Pour la plupart des serveurs MCP compatibles OAuth, aucune configuration particulière n'est nécessaire. Configurez simplement le serveur distant : + +```json title="opencode.json" +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "my-oauth-server": { + "type": "remote", + "url": "https://mcp.example.com/mcp" + } + } +} +``` + +Si le serveur nécessite une authentification, OpenCode vous demandera de vous authentifier lorsque vous essayez de l'utiliser pour la première fois. Sinon, vous pouvez [déclencher manuellement le flux](#authenticating) avec `opencode mcp auth `. + +--- + +### Pré-enregistré + +Si vous disposez des informations d'identification client du fournisseur de serveur MCP, vous pouvez les configurer : + +```json title="opencode.json" {7-11} +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "my-oauth-server": { + "type": "remote", + "url": "https://mcp.example.com/mcp", + "oauth": { + "clientId": "{env:MY_MCP_CLIENT_ID}", + "clientSecret": "{env:MY_MCP_CLIENT_SECRET}", + "scope": "tools:read tools:execute" + } + } + } +} +``` + +--- + +### Authentification + +Vous pouvez déclencher manuellement l'authentification ou gérer les informations d'identification. + +Authentifiez-vous auprès d'un serveur MCP spécifique : + +```bash +opencode mcp auth my-oauth-server +``` + +Répertoriez tous les serveurs MCP et leur statut d'authentification : + +```bash +opencode mcp list +``` + +Supprimez les informations d'identification stockées : + +```bash +opencode mcp logout my-oauth-server +``` + +La commande `mcp auth` ouvrira votre navigateur pour autorisation. Après votre autorisation, OpenCode stockera les jetons en toute sécurité dans `~/.local/share/opencode/mcp-auth.json`. + +--- + +#### Désactivation d'OAuth + +Si vous souhaitez désactiver le OAuth automatique pour un serveur (par exemple, pour les serveurs qui utilisent les clés API à la place), définissez `oauth` sur `false` : + +```json title="opencode.json" {7} +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "my-api-key-server": { + "type": "remote", + "url": "https://mcp.example.com/mcp", + "oauth": false, + "headers": { + "Authorization": "Bearer {env:MY_API_KEY}" + } + } + } +} +``` + +--- + +#### Options OAuth + +| Options | Type | Description | +| -------------- | ------------- | ---------------------------------------------------------------------------------------- | +| `oauth` | Objet \| faux | Objet de configuration OAuth, ou `false` pour désactiver la détection automatique OAuth. | +| `clientId` | Chaîne | ID client OAuth. S’il n’est pas fourni, l’enregistrement dynamique du client sera tenté. | +| `clientSecret` | Chaîne | OAuth secret client, si requis par le serveur d'autorisation. | +| `scope` | Chaîne | OAuth scopes à demander lors de l'autorisation. | + +#### Débogage + +Si un serveur MCP distant ne parvient pas à s'authentifier, vous pouvez diagnostiquer les problèmes avec : + +```bash +# View auth status for all OAuth-capable servers +opencode mcp auth list + +# Debug connection and OAuth flow for a specific server +opencode mcp debug my-oauth-server +``` + +La commande `mcp debug` affiche l'état d'authentification actuel, teste la connectivité HTTP et tente le flux de découverte OAuth. + +--- + +## Gestion + +Vos MCP sont disponibles sous forme d'outils dans OpenCode, aux côtés des outils intégrés. Vous pouvez donc les gérer via la configuration OpenCode comme n'importe quel autre outil. + +--- + +### Global + +Cela signifie que vous pouvez les activer ou les désactiver globalement. + +```json title="opencode.json" {14} +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "my-mcp-foo": { + "type": "local", + "command": ["bun", "x", "my-mcp-command-foo"] + }, + "my-mcp-bar": { + "type": "local", + "command": ["bun", "x", "my-mcp-command-bar"] + } + }, + "tools": { + "my-mcp-foo": false + } +} +``` + +Nous pouvons également utiliser un modèle global pour désactiver tous les MCP correspondants. + +```json title="opencode.json" {14} +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "my-mcp-foo": { + "type": "local", + "command": ["bun", "x", "my-mcp-command-foo"] + }, + "my-mcp-bar": { + "type": "local", + "command": ["bun", "x", "my-mcp-command-bar"] + } + }, + "tools": { + "my-mcp*": false + } +} +``` + +Ici, nous utilisons le modèle global `my-mcp*` pour désactiver tous les MCP. + +--- + +### Par agent + +Si vous disposez d'un grand nombre de serveurs MCP, vous souhaiterez peut-être les activer uniquement par agent et les désactiver globalement. Pour ce faire : + +1. Désactivez-le en tant qu'outil à l'échelle mondiale. +2. Dans votre [agent config](/docs/agents#tools), activez le serveur MCP en tant qu'outil. + +```json title="opencode.json" {11, 14-18} +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "my-mcp": { + "type": "local", + "command": ["bun", "x", "my-mcp-command"], + "enabled": true + } + }, + "tools": { + "my-mcp*": false + }, + "agent": { + "my-agent": { + "tools": { + "my-mcp*": true + } + } + } +} +``` + +--- + +#### Patterns glob + +Le pattern glob utilise des modèles de globbing regex simples : + +- `*` correspond à zéro ou plusieurs caractères (par exemple, `"my-mcp*"` correspond à `my-mcp_search`, `my-mcp_list`, etc.) +- `?` correspond exactement à un caractère +- Tous les autres caractères correspondent littéralement + +:::note +Les outils serveur MCP sont enregistrés avec le nom du serveur comme préfixe, donc pour désactiver tous les outils d'un serveur, utilisez simplement : + +``` +"mymcpservername_*": false +``` + +::: + +--- + +## Exemples + +Vous trouverez ci-dessous des exemples de serveurs MCP courants. Vous pouvez soumettre un PR si vous souhaitez documenter d'autres serveurs. + +--- + +### Sentry + +Ajoutez le [serveur Sentry MCP](https://mcp.sentry.dev) pour interagir avec vos projets et problèmes Sentry. + +```json title="opencode.json" {4-8} +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "sentry": { + "type": "remote", + "url": "https://mcp.sentry.dev/mcp", + "oauth": {} + } + } +} +``` + +Après avoir ajouté la configuration, authentifiez-vous auprès de Sentry : + +```bash +opencode mcp auth sentry +``` + +Cela ouvrira une fenêtre de navigateur pour terminer le flux OAuth et connecter OpenCode à votre compte Sentry. + +Une fois authentifié, vous pouvez utiliser les outils Sentry dans vos prompts pour interroger les problèmes, les projets et les données d'erreur. + +```txt "use sentry" +Show me the latest unresolved issues in my project. use sentry +``` + +--- + +### Context7 + +Ajoutez le [Context7 MCP server](https://github.com/upstash/context7) pour effectuer une recherche dans les documents. + +```json title="opencode.json" {4-7} +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "context7": { + "type": "remote", + "url": "https://mcp.context7.com/mcp" + } + } +} +``` + +Si vous avez créé un compte gratuit, vous pouvez utiliser votre clé API et obtenir des limites de débit plus élevées. + +```json title="opencode.json" {7-9} +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "context7": { + "type": "remote", + "url": "https://mcp.context7.com/mcp", + "headers": { + "CONTEXT7_API_KEY": "{env:CONTEXT7_API_KEY}" + } + } + } +} +``` + +Ici, nous supposons que la variable d'environnement `CONTEXT7_API_KEY` est définie. + +Ajoutez `use context7` à vos prompts pour utiliser le serveur Context7 MCP. + +```txt "use context7" +Configure a Cloudflare Worker script to cache JSON API responses for five minutes. use context7 +``` + +Alternativement, vous pouvez ajouter quelque chose comme ceci à votre [AGENTS.md](/docs/rules/). + +```md title="AGENTS.md" +When you need to search docs, use `context7` tools. +``` + +--- + +### Grep by Vercel + +Ajoutez le serveur [Grep by Vercel](https://grep.app) MCP pour rechercher des extraits de code sur GitHub. + +```json title="opencode.json" {4-7} +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "gh_grep": { + "type": "remote", + "url": "https://mcp.grep.app" + } + } +} +``` + +Puisque nous avons nommé notre serveur MCP `gh_grep`, vous pouvez ajouter `use the gh_grep tool` à vos prompts pour que l'agent l'utilise. + +```txt "use the gh_grep tool" +What's the right way to set a custom domain in an SST Astro component? use the gh_grep tool +``` + +Alternativement, vous pouvez ajouter quelque chose comme ceci à votre [AGENTS.md](/docs/rules/). + +```md title="AGENTS.md" +If you are unsure how to do something, use `gh_grep` to search code examples from GitHub. +``` + +Vous pouvez également désactiver un serveur en définissant `enabled` sur `false`. Ceci est utile si vous souhaitez désactiver temporairement un serveur sans le supprimer de votre configuration. + +--- + +### Remplacement des valeurs par défaut distantes + +Les organisations peuvent fournir des serveurs MCP par défaut via leur point de terminaison `.well-known/opencode`. Ces serveurs peuvent être désactivés par défaut, permettant aux utilisateurs de choisir ceux dont ils ont besoin. + Pour activer un serveur spécifique à partir de la configuration distante de votre organisation, ajoutez-le à votre configuration locale avec `enabled: true` : ```json title="opencode.json" diff --git a/packages/web/src/content/docs/fr/models.mdx b/packages/web/src/content/docs/fr/models.mdx index 95e689ff8..6dd91435c 100644 --- a/packages/web/src/content/docs/fr/models.mdx +++ b/packages/web/src/content/docs/fr/models.mdx @@ -15,9 +15,9 @@ En savoir plus sur [fournisseurs](/docs/providers). --- -## Sélectionnez un modèle +## Sélection d'un modèle -Une fois que vous avez configuré votre fournisseur, vous pouvez sélectionner le modèle souhaité en tapant : +Une fois que vous avez configuré votre fournisseur, vous pouvez sélectionner le modèle souhaité en tapant : ```bash frame="none" /models @@ -37,8 +37,8 @@ Cependant, seuls quelques-uns d’entre eux savent à la fois générer du code Voici plusieurs modèles qui fonctionnent bien avec OpenCode, sans ordre particulier. (Cette liste n’est pas exhaustive et n’est pas nécessairement à jour) : -- GPT 5.2 -- Codex GPT 5.1 +- GPT 5.2 +- Codex GPT 5.1 - Claude Opus 4.5 - Claude Sonnet 4.5 - Minimax M2.1 @@ -48,8 +48,7 @@ Voici plusieurs modèles qui fonctionnent bien avec OpenCode, sans ordre particu ## Définir une valeur par défaut -Pour définir l'un d'entre eux comme modèle par défaut, vous pouvez définir la clé `model` dans votre -OpenCode configuration. +Pour définir l'un d'entre eux comme modèle par défaut, vous pouvez définir la clé `model` dans votre configuration OpenCode. ```json title="opencode.json" {3} { @@ -64,7 +63,7 @@ Si vous avez configuré un [fournisseur personnalisé](/docs/providers#custom), --- -## Configurer les modèles +## Configuration des modèles Vous pouvez configurer globalement les options d'un modèle via le fichier config. @@ -100,12 +99,12 @@ Vous pouvez configurer globalement les options d'un modèle via le fichier confi } ``` -Ici, nous configurons les paramètres globaux pour deux modèles intégrés : `gpt-5` lorsqu'il est accessible via le fournisseur `openai` et `claude-sonnet-4-20250514` lorsqu'il est accessible via le fournisseur `anthropic`. +Ici, nous configurons les paramètres globaux pour deux modèles intégrés : `gpt-5` lorsqu'il est accessible via le fournisseur `openai` et `claude-sonnet-4-20250514` lorsqu'il est accessible via le fournisseur `anthropic`. Les noms du fournisseur intégré et des modèles peuvent être trouvés sur [Models.dev](https://models.dev). Vous pouvez également configurer ces options pour tous les agents que vous utilisez. La configuration de l'agent remplace ici toutes les options globales. [En savoir plus](/docs/agents/#additional). -Vous pouvez également définir des variantes personnalisées qui étendent celles intégrées. Les variantes vous permettent de configurer différents paramètres pour le même modèle sans créer d'entrées en double : +Vous pouvez également définir des variantes personnalisées qui étendent celles intégrées. Les variantes vous permettent de configurer différents paramètres pour le même modèle sans créer d'entrées en double : ```jsonc title="opencode.jsonc" {6-21} { @@ -139,30 +138,30 @@ Vous pouvez également définir des variantes personnalisées qui étendent cell De nombreux modèles prennent en charge plusieurs variantes avec différentes configurations. OpenCode est livré avec des variantes par défaut intégrées pour les fournisseurs populaires. -### Built-in variants +### Variantes intégrées OpenCode est livré avec des variantes par défaut pour de nombreux fournisseurs : -**Anthropic** : +**Anthropic** : - `high` - Budget de réflexion élevé (par défaut) - `max` - Budget de réflexion maximum -**OpenAI** : +**OpenAI** : -Varie selon le modèle mais en gros : +Varie selon le modèle mais en gros : - `none` - Aucun raisonnement - `minimal` - Effort de raisonnement minimal - `low` - Faible effort de raisonnement - `medium` - Effort de raisonnement moyen -- `high` – Effort de raisonnement élevé +- `high` – Effort de raisonnement élevé - `xhigh` - Effort de raisonnement très élevé **Google**: -- `low` – Budget d'effort/jetons réduit -- `high` – Budget d'effort/de jetons plus élevé +- `low` – Budget d'effort/jetons réduit +- `high` – Budget d'effort/de jetons plus élevé :::tip Cette liste n'est pas exhaustive. De nombreux autres fournisseurs ont également des paramètres par défaut intégrés. @@ -170,7 +169,7 @@ Cette liste n'est pas exhaustive. De nombreux autres fournisseurs ont également ### Variantes personnalisées -Vous pouvez remplacer les variantes existantes ou ajouter les vôtres : +Vous pouvez remplacer les variantes existantes ou ajouter les vôtres : ```jsonc title="opencode.jsonc" {7-18} { @@ -195,7 +194,7 @@ Vous pouvez remplacer les variantes existantes ou ajouter les vôtres : } ``` -### Cycle variants +### Cycle des variantes Utilisez le raccourci clavier `variant_cycle` pour basculer rapidement entre les variantes. [En savoir plus](/docs/keybinds). @@ -203,9 +202,9 @@ Utilisez le raccourci clavier `variant_cycle` pour basculer rapidement entre les ## Chargement des modèles -Lorsque OpenCode démarre, il recherche les modèles dans l'ordre de priorité suivant : +Lorsque OpenCode démarre, il recherche les modèles dans l'ordre de priorité suivant : -1. L'indicateur de ligne de commande `--model` ou `-m`. Le format est le même que dans le fichier de configuration : `provider_id/model_id`. +1. Le flag de ligne de commande `--model` ou `-m`. Le format est le même que dans le fichier de configuration : `provider_id/model_id`. 2. La liste des modèles dans la configuration OpenCode. diff --git a/packages/web/src/content/docs/fr/modes.mdx b/packages/web/src/content/docs/fr/modes.mdx index 49362c066..340ce83bd 100644 --- a/packages/web/src/content/docs/fr/modes.mdx +++ b/packages/web/src/content/docs/fr/modes.mdx @@ -4,20 +4,19 @@ description: Différents modes pour différents cas d'utilisation. --- :::caution -Les modes sont désormais configurés via l'option `agent` dans la configuration opencode. Le +Les modes sont désormais configurés via l'option `agent` dans la configuration opencode. L’option `mode` est désormais obsolète. [En savoir plus](/docs/agents). ::: -Les modes dans opencode vous permettent de personnaliser le comportement, les outils et les invites pour différents cas d'utilisation. +Les modes dans opencode vous permettent de personnaliser le comportement, les outils et les prompts pour différents cas d'utilisation. -Il est livré avec deux modes intégrés : **build** et **plan**. Vous pouvez personnaliser -ceux-ci ou configurez les vôtres via la configuration opencode. +Il est livré avec deux modes intégrés : **build** et **plan**. Vous pouvez personnaliser ceux-ci ou configurez les vôtres via la configuration opencode. Vous pouvez basculer entre les modes au cours d'une session ou les configurer dans votre fichier de configuration. --- -## Intégré +## Modes intégrés opencode est livré avec deux modes intégrés. @@ -31,7 +30,7 @@ Build est le mode **par défaut** avec tous les outils activés. Il s'agit du mo ### Plan -Un mode restreint conçu pour la planification et l’analyse. En mode plan, les outils suivants sont désactivés par défaut : +Un mode restreint conçu pour la planification et l’analyse. En mode plan, les outils suivants sont désactivés par défaut : - `write` - Impossible de créer de nouveaux fichiers - `edit` - Impossible de modifier les fichiers existants, à l'exception des fichiers situés à `.opencode/plans/*.md` pour détailler le plan lui-même @@ -42,21 +41,21 @@ Ce mode est utile lorsque vous souhaitez que l'IA analyse le code, suggère des --- -## Commutation +## Changement de mode Vous pouvez basculer entre les modes au cours d'une session à l'aide de la touche _Tab_. Ou votre raccourci clavier `switch_mode` configuré. -Voir également : [Formatters](/docs/formatters) pour plus d'informations sur la configuration du formatage du code. +Voir également : [Formatters](/docs/formatters) pour plus d'informations sur la configuration du formatage du code. --- -## Configurer +## Configuration -Vous pouvez personnaliser les modes intégrés ou créer les vôtres via la configuration. Les modes peuvent être configurés de deux manières : +Vous pouvez personnaliser les modes intégrés ou créer les vôtres via la configuration. Les modes peuvent être configurés de deux manières : ### Configuration JSON -Configurez les modes dans votre fichier de configuration `opencode.json` : +Configurez les modes dans votre fichier de configuration `opencode.json` : ```json title="opencode.json" { @@ -85,10 +84,10 @@ Configurez les modes dans votre fichier de configuration `opencode.json` : ### Configuration Markdown -Vous pouvez également définir des modes à l'aide de fichiers markdown. Placez-les dans : +Vous pouvez également définir des modes à l'aide de fichiers markdown. Placez-les dans : -- Mondial : `~/.config/opencode/modes/` -- Projet : `.opencode/modes/` +- Global : `~/.config/opencode/modes/` +- Projet : `.opencode/modes/` ```markdown title="~/.config/opencode/modes/review.md" --- @@ -149,11 +148,11 @@ Contrôlez le caractère aléatoire et la créativité des réponses de l'IA ave } ``` -Les valeurs de température varient généralement de 0,0 à 1,0 : +Les valeurs de température varient généralement de 0,0 à 1,0 : -- **0,0-0,2** : réponses très ciblées et déterministes, idéales pour l'analyse et la planification du code -- **0,3-0,5** : réponses équilibrées avec une certaine créativité, idéales pour les tâches de développement générales -- **0,6-1,0** : réponses plus créatives et variées, utiles pour le brainstorming et l'exploration +- **0,0-0,2** : réponses très ciblées et déterministes, idéales pour l'analyse et la planification du code +- **0,3-0,5** : réponses équilibrées avec une certaine créativité, idéales pour les tâches de développement générales +- **0,6-1,0** : réponses plus créatives et variées, utiles pour le brainstorming et l'exploration ```json title="opencode.json" { @@ -177,9 +176,9 @@ Si aucune température n'est spécifiée, opencode utilise les valeurs par défa --- -### Prompt +### Invite -Spécifiez un fichier d'invite système personnalisé pour ce mode avec la configuration `prompt`. Le fichier d'invite doit contenir des instructions spécifiques à l'objectif du mode. +Spécifiez un fichier de prompt système personnalisé pour ce mode avec la configuration `prompt`. Le fichier de prompt doit contenir des instructions spécifiques à l'objectif du mode. ```json title="opencode.json" { @@ -191,8 +190,7 @@ Spécifiez un fichier d'invite système personnalisé pour ce mode avec la confi } ``` -Ce chemin est relatif à l'emplacement du fichier de configuration. Donc ça marche pour -à la fois la configuration globale opencode et la configuration spécifique au projet. +Ce chemin est relatif à l'emplacement du fichier de configuration. Donc ça marche pour à la fois la configuration globale opencode et la configuration spécifique au projet. --- @@ -225,7 +223,7 @@ Si aucun outil n'est spécifié, tous les outils sont activés par défaut. Voici tous les outils pouvant être contrôlés via le mode config. -| Outil | Descriptif | +| Outil | Description | | ----------- | ------------------------------------- | | `bash` | Exécuter des commandes shell | | `edit` | Modifier des fichiers existants | @@ -243,7 +241,7 @@ Voici tous les outils pouvant être contrôlés via le mode config. ## Modes personnalisés -Vous pouvez créer vos propres modes personnalisés en les ajoutant à la configuration. Voici des exemples utilisant les deux approches : +Vous pouvez créer vos propres modes personnalisés en les ajoutant à la configuration. Voici des exemples utilisant les deux approches : ### Utilisation de la configuration JSON @@ -268,7 +266,7 @@ Vous pouvez créer vos propres modes personnalisés en les ajoutant à la config ### Utiliser des fichiers Markdown -Créez des fichiers de mode dans `.opencode/modes/` pour les modes spécifiques au projet ou `~/.config/opencode/modes/` pour les modes globaux : +Créez des fichiers de mode dans `.opencode/modes/` pour les modes spécifiques au projet ou `~/.config/opencode/modes/` pour les modes globaux : ```markdown title=".opencode/modes/debug.md" --- diff --git a/packages/web/src/content/docs/fr/network.mdx b/packages/web/src/content/docs/fr/network.mdx index 91b9ac35d..0ebafea44 100644 --- a/packages/web/src/content/docs/fr/network.mdx +++ b/packages/web/src/content/docs/fr/network.mdx @@ -30,9 +30,9 @@ Vous pouvez configurer le port et le nom d'hôte du serveur à l'aide de [CLI fl --- -### Authentication +### Authentification -Si votre proxy nécessite une authentification de base, incluez les informations d'identification dans le URL. +Si votre proxy nécessite une authentification de base, incluez les informations d'identification dans l'URL. ```bash export HTTPS_PROXY=http://username:password@proxy.example.com:8080 @@ -54,4 +54,4 @@ Si votre entreprise utilise des autorités de certification personnalisées pour export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem ``` -Cela fonctionne à la fois pour les connexions proxy et pour l'accès direct à API. +Cela fonctionne à la fois pour les connexions proxy et pour l'accès direct à l'API. diff --git a/packages/web/src/content/docs/fr/permissions.mdx b/packages/web/src/content/docs/fr/permissions.mdx index 1b9a469f6..1533987f8 100644 --- a/packages/web/src/content/docs/fr/permissions.mdx +++ b/packages/web/src/content/docs/fr/permissions.mdx @@ -9,12 +9,12 @@ Depuis `v1.1.1`, l'ancienne configuration booléenne `tools` est obsolète et a --- -## Actes +## Actions -Chaque règle d'autorisation se résout en l'une des suivantes : +Chaque règle d'autorisation se résout en l'une des suivantes : -- `"allow"` – exécuter sans approbation -- `"ask"` – demande d'approbation +- `"allow"` – exécuter sans approbation +- `"ask"` – demande d'approbation - `"deny"` — bloque l'action --- @@ -34,7 +34,7 @@ Vous pouvez définir des autorisations globalement (avec `*`) et remplacer des o } ``` -Vous pouvez également définir toutes les autorisations en même temps : +Vous pouvez également définir toutes les autorisations en même temps : ```json title="opencode.json" { @@ -47,7 +47,7 @@ Vous pouvez également définir toutes les autorisations en même temps : ## Règles granulaires (syntaxe d'objet) -Pour la plupart des autorisations, vous pouvez utiliser un objet pour appliquer différentes actions en fonction de la saisie de l'outil. +Pour la plupart des autorisations, vous pouvez utiliser un objet pour appliquer différentes actions en fonction de l'entrée de l'outil. ```json title="opencode.json" { @@ -72,7 +72,7 @@ Les règles sont évaluées par correspondance de modèle, la **dernière règle ### Caractères génériques -Les modèles d'autorisation utilisent une simple correspondance de caractères génériques : +Les modèles d'autorisation utilisent une simple correspondance de caractères génériques : - `*` correspond à zéro ou plusieurs caractères - `?` correspond exactement à un caractère @@ -90,9 +90,9 @@ Vous pouvez utiliser `~` ou `$HOME` au début d'un modèle pour référencer vot Utilisez `external_directory` pour autoriser les appels d'outils qui touchent des chemins en dehors du répertoire de travail où OpenCode a été démarré. Cela s'applique à tout outil qui prend un chemin en entrée (par exemple `read`, `edit`, `list`, `glob`, `grep` et de nombreuses commandes `bash`). -L'expansion de la maison (comme `~/...`) n'affecte que la façon dont un modèle est écrit. Cela n'intègre pas un chemin externe à l'espace de travail actuel, donc les chemins en dehors du répertoire de travail doivent toujours être autorisés via `external_directory`. +L'expansion du répertoire personnel (comme `~/...`) n'affecte que la façon dont un modèle est écrit. Cela n'intègre pas un chemin externe à l'espace de travail actuel, donc les chemins en dehors du répertoire de travail doivent toujours être autorisés via `external_directory`. -Par exemple, cela permet d'accéder à tout ce qui se trouve sous `~/projects/personal/` : +Par exemple, cela permet d'accéder à tout ce qui se trouve sous `~/projects/personal/` : ```json title="opencode.json" { @@ -105,7 +105,7 @@ Par exemple, cela permet d'accéder à tout ce qui se trouve sous `~/projects/pe } ``` -Tout répertoire autorisé ici hérite des mêmes valeurs par défaut que l'espace de travail actuel. Étant donné que [`read` est par défaut `allow`](#defaults), les lectures sont également autorisées pour les entrées sous `external_directory`, sauf dérogation. Ajoutez des règles explicites lorsqu'un outil doit être restreint dans ces chemins, comme bloquer les modifications tout en conservant les lectures : +Tout répertoire autorisé ici hérite des mêmes valeurs par défaut que l'espace de travail actuel. Étant donné que [`read` est par défaut `allow`](#defaults), les lectures sont également autorisées pour les entrées sous `external_directory`, sauf dérogation. Ajoutez des règles explicites lorsqu'un outil doit être restreint dans ces chemins, comme bloquer les modifications tout en conservant les lectures : ```json title="opencode.json" { @@ -127,7 +127,7 @@ Gardez la liste centrée sur les chemins approuvés et superposez des règles d' ## Autorisations disponibles -Les autorisations OpenCode sont classées par nom d'outil, plus quelques gardes de sécurité : +Les autorisations OpenCode sont classées par nom d'outil, plus quelques garde-fous de sécurité : - `read` — lecture d'un fichier (correspond au chemin du fichier) - `edit` — toutes les modifications de fichiers (couvre `edit`, `write`, `patch`, `multiedit`) @@ -139,7 +139,7 @@ Les autorisations OpenCode sont classées par nom d'outil, plus quelques gardes - `skill` — chargement d'une compétence (correspond au nom de la compétence) - `lsp` — exécution de requêtes LSP (actuellement non granulaires) - `todoread`, `todowrite` — lecture/mise à jour de la liste de tâches -- `webfetch` — récupérer un URL (correspond au URL) +- `webfetch` — récupérer une URL (correspond à l'URL) - `websearch`, `codesearch` — recherche Web/code (correspond à la requête) - `external_directory` - déclenché lorsqu'un outil touche des chemins en dehors du répertoire de travail du projet - `doom_loop` — déclenché lorsque le même appel d'outil se répète 3 fois avec une entrée identique @@ -148,11 +148,11 @@ Les autorisations OpenCode sont classées par nom d'outil, plus quelques gardes ## Valeurs par défaut -Si vous ne spécifiez rien, OpenCode démarre avec les valeurs par défaut permissives : +Si vous ne spécifiez rien, OpenCode démarre avec les valeurs par défaut permissives : - La plupart des autorisations sont par défaut `"allow"`. - `doom_loop` et `external_directory` sont par défaut `"ask"`. -- `read` est `"allow"`, mais les fichiers `.env` sont refusés par défaut : +- `read` est `"allow"`, mais les fichiers `.env` sont refusés par défaut : ```json title="opencode.json" { @@ -169,9 +169,9 @@ Si vous ne spécifiez rien, OpenCode démarre avec les valeurs par défaut permi --- -## Que fait « Demander » ? +## Que fait « Demander » ? -Lorsque OpenCode demande l'approbation, l'interface utilisateur propose trois résultats : +Lorsque OpenCode demande l'approbation, l'interface utilisateur propose trois résultats : - `once` — approuve uniquement cette demande - `always` — approuve les futures demandes correspondant aux modèles suggérés (pour le reste de la session OpenCode en cours) @@ -217,7 +217,7 @@ Reportez-vous à la section [Règles granulaires (syntaxe d'objet)](#granular-ru } ``` -Vous pouvez également configurer les autorisations des agents dans Markdown : +Vous pouvez également configurer les autorisations des agents dans Markdown : ```markdown title="~/.config/opencode/agents/review.md" --- diff --git a/packages/web/src/content/docs/fr/plugins.mdx b/packages/web/src/content/docs/fr/plugins.mdx index 9d4b83ea3..48cdc4d11 100644 --- a/packages/web/src/content/docs/fr/plugins.mdx +++ b/packages/web/src/content/docs/fr/plugins.mdx @@ -26,7 +26,7 @@ Les fichiers de ces répertoires sont automatiquement chargés au démarrage. --- -### De npm +### Depuis npm Spécifiez les packages npm dans votre fichier de configuration. @@ -37,7 +37,7 @@ Spécifiez les packages npm dans votre fichier de configuration. } ``` -Les packages npm standards et étendus sont pris en charge. +Les packages npm scopés et standards sont pris en charge. Parcourez les plugins disponibles dans le [ecosystem](/docs/ecosystem#plugins). @@ -53,7 +53,7 @@ Les **plugins locaux** sont chargés directement depuis le répertoire des plugi ### Ordre de chargement -Les plugins sont chargés à partir de toutes les sources et tous les hooks s'exécutent dans l'ordre. L'ordre de chargement est le suivant : +Les plugins sont chargés à partir de toutes les sources et tous les hooks s'exécutent dans l'ordre. L'ordre de chargement est le suivant : 1. Configuration globale (`~/.config/opencode/opencode.json`) 2. Configuration du projet (`opencode.json`) @@ -66,8 +66,7 @@ Les packages npm en double avec le même nom et la même version sont chargés u ## Créer un plugin -Un plugin est un **module JavaScript/TypeScript** qui exporte un ou plusieurs plugins -fonctions. Chaque fonction reçoit un objet contextuel et renvoie un objet hooks. +Un plugin est un **module JavaScript/TypeScript** qui exporte une ou plusieurs fonctions de plugin. Chaque fonction reçoit un objet contextuel et renvoie un objet hooks. --- @@ -115,17 +114,17 @@ export const MyPlugin = async ({ project, client, $, directory, worktree }) => { La fonction plugin reçoit : -- `project` : informations sur le projet actuel. -- `directory` : le répertoire de travail actuel. -- `worktree` : le chemin de l'arbre de travail git. -- `client` : un client SDK opencode pour interagir avec l'IA. -- `$` : [shell API](https://bun.com/docs/runtime/shell) de Bun pour l'exécution de commandes. +- `project` : informations sur le projet actuel. +- `directory` : le répertoire de travail actuel. +- `worktree` : le chemin de l'arbre de travail git. +- `client` : un client SDK opencode pour interagir avec l'IA. +- `$` : [shell API](https://bun.com/docs/runtime/shell) de Bun pour l'exécution de commandes. --- ### Prise en charge de TypeScript -Pour les plugins TypeScript, vous pouvez importer des types à partir du package du plugin : +Pour les plugins TypeScript, vous pouvez importer des types à partir du package du plugin : ```ts title="my-plugin.ts" {1} import type { Plugin } from "@opencode-ai/plugin" @@ -217,7 +216,7 @@ Voici quelques exemples de plugins que vous pouvez utiliser pour étendre openco ### Envoyer des notifications -Envoyez des notifications lorsque certains événements se produisent : +Envoyez des notifications lorsque certains événements se produisent : ```js title=".opencode/plugins/notification.js" export const NotificationPlugin = async ({ project, client, $, directory, worktree }) => { @@ -242,7 +241,7 @@ Si vous utilisez l'application de bureau OpenCode, elle peut envoyer automatique ### Protection .env -Empêchez opencode de lire les fichiers `.env` : +Empêchez opencode de lire les fichiers `.env` : ```javascript title=".opencode/plugins/env-protection.js" export const EnvProtection = async ({ project, client, $, directory, worktree }) => { @@ -260,7 +259,7 @@ export const EnvProtection = async ({ project, client, $, directory, worktree }) ### Injecter des variables d'environnement -Injectez des variables d'environnement dans toutes les exécutions du shell (outils d'IA et terminal utilisateur) : +Injectez des variables d'environnement dans toutes les exécutions du shell (outils d'IA et terminal utilisateur) : ```javascript title=".opencode/plugins/inject-env.js" export const InjectEnvPlugin = async () => { @@ -277,7 +276,7 @@ export const InjectEnvPlugin = async () => { ### Outils personnalisés -Les plugins peuvent également ajouter des outils personnalisés à opencode : +Les plugins peuvent également ajouter des outils personnalisés à opencode : ```ts title=".opencode/plugins/custom-tools.ts" import { type Plugin, tool } from "@opencode-ai/plugin" @@ -300,19 +299,19 @@ export const CustomToolsPlugin: Plugin = async (ctx) => { } ``` -L'assistant `tool` crée un outil personnalisé que opencode peut appeler. Il prend une fonction de schéma Zod et renvoie une définition d'outil avec : +L'assistant `tool` crée un outil personnalisé que opencode peut appeler. Il prend une fonction de schéma Zod et renvoie une définition d'outil avec : -- `description` : ce que fait l'outil -- `args` : schéma Zod pour les arguments de l'outil -- `execute` : Fonction qui s'exécute lorsque l'outil est appelé +- `description` : ce que fait l'outil +- `args` : schéma Zod pour les arguments de l'outil +- `execute` : Fonction qui s'exécute lorsque l'outil est appelé Vos outils personnalisés seront disponibles pour opencode aux côtés des outils intégrés. --- -### Enregistrement +### Journalisation -Utilisez `client.app.log()` au lieu de `console.log` pour la journalisation structurée : +Utilisez `client.app.log()` au lieu de `console.log` pour la journalisation structurée : ```ts title=".opencode/plugins/my-plugin.ts" export const MyPlugin = async ({ client }) => { @@ -327,13 +326,13 @@ export const MyPlugin = async ({ client }) => { } ``` -Niveaux : `debug`, `info`, `warn`, `error`. Voir la [documentation du SDK](https://opencode.ai/docs/sdk) pour plus de détails. +Niveaux : `debug`, `info`, `warn`, `error`. Voir la [documentation du SDK](https://opencode.ai/docs/sdk) pour plus de détails. --- -### Crochets de compactage +### Hooks de compactage -Personnalisez le contexte inclus lorsqu'une session est compactée : +Personnalisez le contexte inclus lorsqu'une session est compactée : ```ts title=".opencode/plugins/compaction.ts" import type { Plugin } from "@opencode-ai/plugin" @@ -355,9 +354,9 @@ Include any state that should persist across compaction: } ``` -Le hook `experimental.session.compacting` se déclenche avant que le LLM ne génère un résumé de continuation. Utilisez-le pour injecter un contexte spécifique au domaine que l'invite de compactage par défaut manquerait. +Le hook `experimental.session.compacting` se déclenche avant que le LLM ne génère un résumé de continuation. Utilisez-le pour injecter un contexte spécifique au domaine que le prompt de compactage par défaut manquerait. -Vous pouvez également remplacer entièrement l'invite de compactage en définissant `output.prompt` : +Vous pouvez également remplacer entièrement le prompt de compactage en définissant `output.prompt` : ```ts title=".opencode/plugins/custom-compaction.ts" import type { Plugin } from "@opencode-ai/plugin" @@ -382,4 +381,4 @@ Format as a structured prompt that a new agent can use to resume work. } ``` -Lorsque `output.prompt` est défini, il remplace complètement l'invite de compactage par défaut. Le tableau `output.context` est ignoré dans ce cas. +Lorsque `output.prompt` est défini, il remplace complètement le prompt de compactage par défaut. Le tableau `output.context` est ignoré dans ce cas. diff --git a/packages/web/src/content/docs/fr/tui.mdx b/packages/web/src/content/docs/fr/tui.mdx index 4edfdbe06..f9078508d 100644 --- a/packages/web/src/content/docs/fr/tui.mdx +++ b/packages/web/src/content/docs/fr/tui.mdx @@ -69,7 +69,7 @@ Voici toutes les commandes slash disponibles : --- -### connecter +### connect Ajoutez un fournisseur à OpenCode. Vous permet de sélectionner parmi les fournisseurs disponibles et d’ajouter leurs clés API. @@ -91,7 +91,7 @@ Compactez la session en cours. *Alias* : `/summarize` --- -### détails +### details Basculer les détails d'exécution de l'outil. @@ -103,7 +103,7 @@ Basculer les détails d'exécution de l'outil. --- -### éditeur +### editor Ouvrez un éditeur externe pour rédiger des messages. Utilise l'éditeur défini dans votre variable d'environnement `EDITOR`. [En savoir plus](#editor-setup). @@ -115,7 +115,7 @@ Ouvrez un éditeur externe pour rédiger des messages. Utilise l'éditeur défin --- -### sortie +### exit Quittez OpenCode. *Alias* : `/quit`, `/q` @@ -127,7 +127,7 @@ Quittez OpenCode. *Alias* : `/quit`, `/q` --- -### exporter +### export Exportez la conversation en cours vers Markdown et ouvrez-la dans votre éditeur par défaut. Utilise l'éditeur défini dans votre variable d'environnement `EDITOR`. [En savoir plus](#editor-setup). @@ -139,7 +139,7 @@ Exportez la conversation en cours vers Markdown et ouvrez-la dans votre éditeur --- -### aide +### help Afficher la boîte de dialogue d'aide. @@ -151,7 +151,7 @@ Afficher la boîte de dialogue d'aide. --- -### initialisation +### init Créez ou mettez à jour le fichier `AGENTS.md`. [En savoir plus](/docs/rules). @@ -163,7 +163,7 @@ Créez ou mettez à jour le fichier `AGENTS.md`. [En savoir plus](/docs/rules). --- -### modèles +### models Liste des modèles disponibles. @@ -175,7 +175,7 @@ Liste des modèles disponibles. --- -### nouveau +### new Démarrez une nouvelle session. *Alias* : `/clear` @@ -187,7 +187,7 @@ Démarrez une nouvelle session. *Alias* : `/clear` --- -### refaire +### redo Refaire un message précédemment annulé. Disponible uniquement après avoir utilisé `/undo`. @@ -206,7 +206,7 @@ En interne, cela utilise Git pour gérer les modifications de fichiers. Votre pr --- -### séances +### sessions Répertoriez et basculez entre les sessions. *Alias* : `/resume`, `/continue` @@ -218,7 +218,7 @@ Répertoriez et basculez entre les sessions. *Alias* : `/resume`, `/continue` --- -### partager +### share Partager la session en cours. [En savoir plus](/docs/share). @@ -230,7 +230,7 @@ Partager la session en cours. [En savoir plus](/docs/share). --- -### thèmes +### theme Répertoriez les thèmes disponibles. @@ -242,7 +242,7 @@ Répertoriez les thèmes disponibles. --- -### pensée +### thinking Activez/désactivez la visibilité des blocages de réflexion/raisonnement dans la conversation. Lorsque cette option est activée, vous pouvez voir le processus de raisonnement du modèle pour les modèles prenant en charge la réflexion étendue. @@ -256,7 +256,7 @@ Cette commande contrôle uniquement si les blocs de réflexion sont **affichés* --- -### défaire +### undo Annuler le dernier message de la conversation. Supprime le message utilisateur le plus récent, toutes les réponses ultérieures et toutes les modifications de fichier. @@ -275,7 +275,7 @@ En interne, cela utilise Git pour gérer les modifications de fichiers. Votre pr --- -### annuler le partage +### unshare Annuler le partage de la session en cours. [En savoir plus](/docs/share#un-sharing). diff --git a/packages/web/src/content/docs/fr/web.mdx b/packages/web/src/content/docs/fr/web.mdx index 2cf8e531b..c24a3095e 100644 --- a/packages/web/src/content/docs/fr/web.mdx +++ b/packages/web/src/content/docs/fr/web.mdx @@ -54,7 +54,7 @@ Lorsque vous utilisez `0.0.0.0`, OpenCode affichera les adresses locales et rés Network access: http://192.168.1.100:4096 ``` -### mDNS Découverte +### Découverte mDNS Activez mDNS pour rendre votre serveur visible sur le réseau local : @@ -94,7 +94,7 @@ Le nom d'utilisateur par défaut est `opencode` mais peut être modifié avec `O Une fois démarrée, l'interface web permet d'accéder à vos sessions OpenCode. -### Séances +### Sessions Consultez et gérez vos sessions depuis la page d'accueil. Vous pouvez voir les sessions actives et en démarrer de nouvelles. diff --git a/packages/web/src/content/docs/it/acp.mdx b/packages/web/src/content/docs/it/acp.mdx index 6a43869c0..046aba5f2 100644 --- a/packages/web/src/content/docs/it/acp.mdx +++ b/packages/web/src/content/docs/it/acp.mdx @@ -9,11 +9,11 @@ OpenCode supporta [Agent Client Protocol](https://agentclientprotocol.com) (ACP) Per una lista di editor e tool che supportano ACP, vedi l'[ACP progress report](https://zed.dev/blog/acp-progress-report#available-now). ::: -ACP e un protocollo aperto che standardizza la comunicazione tra editor di codice e agenti di coding AI. +ACP e è un protocollo aperto che standardizza la comunicazione tra editor di codice e agenti di coding AI. --- -## Configure +## Configurazione Per usare OpenCode via ACP, configura l'editor in modo che esegua il comando `opencode acp`. @@ -140,7 +140,7 @@ Questa config imposta CodeCompanion per usare OpenCode come agente ACP per la ch Se devi passare variabili d'ambiente (come `OPENCODE_API_KEY`), vedi [Configuring Adapters: Environment Variables](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) nella documentazione di CodeCompanion.nvim. -## Support +## Supporto OpenCode funziona via ACP come nel terminale. Tutte le funzionalita sono supportate: :::note diff --git a/packages/web/src/content/docs/it/agents.mdx b/packages/web/src/content/docs/it/agents.mdx index 51c287fcf..4ecc9fc2a 100644 --- a/packages/web/src/content/docs/it/agents.mdx +++ b/packages/web/src/content/docs/it/agents.mdx @@ -21,7 +21,7 @@ In OpenCode esistono due tipi di agenti: agenti primari e subagenti. ### Agenti primari -Gli agenti primari sono gli assistenti principali con cui interagisci direttamente. Puoi scorrerli usando il tasto **Tab** o la scorciatoia `switch_agent` configurata. Questi agenti gestiscono la conversazione principale. L'accesso agli strumenti si configura tramite i permessi: per esempio, Build ha tutti gli strumenti abilitati, mentre Plan e' limitato. +Gli agenti primari sono gli assistenti principali con cui interagisci direttamente. Puoi scorrerli usando il tasto **Tab** o la scorciatoia `switch_agent` configurata. Questi agenti gestiscono la conversazione principale. L'accesso agli strumenti si configura tramite i permessi: per esempio, Build ha tutti gli strumenti abilitati, mentre Plan è limitato. :::tip Puoi usare **Tab** per passare tra gli agenti primari durante una sessione. @@ -45,65 +45,65 @@ OpenCode include due agenti primari integrati e due subagenti integrati. --- -### Usa build +### Build _Mode_: `primary` -Build e' l'agente primario **predefinito** con tutti gli strumenti abilitati. E' l'agente standard per lavoro di sviluppo quando ti serve pieno accesso a operazioni sui file e comandi di sistema. +Build è l'agente primario **predefinito** con tutti gli strumenti abilitati. È l'agente standard per lavoro di sviluppo quando ti serve pieno accesso a operazioni sui file e comandi di sistema. --- -### Usa plan +### Plan _Mode_: `primary` -Un agente limitato pensato per pianificazione e analisi. Usiamo un sistema di permessi per darti piu' controllo e prevenire modifiche non intenzionali. +Un agente limitato pensato per pianificazione e analisi. Usiamo un sistema di permessi per darti più controllo e prevenire modifiche non intenzionali. Di default, tutte le seguenti sono impostate a `ask`: - `file edits`: tutte le scritture, patch ed edit - `bash`: tutti i comandi bash -Questo agente e' utile quando vuoi che l'LLM analizzi il codice, suggerisca modifiche o crei piani senza effettuare alcuna modifica reale al codebase. +Questo agente è utile quando vuoi che l'LLM analizzi il codice, suggerisca modifiche o crei piani senza effettuare alcuna modifica reale al codebase. --- -### Usa general +### General _Mode_: `subagent` -Un agente general-purpose per ricercare domande complesse ed eseguire task multi-step. Ha accesso completo agli strumenti (tranne todo), quindi puo' modificare file quando serve. Usalo per eseguire piu' unita' di lavoro in parallelo. +Un agente general-purpose per ricercare domande complesse ed eseguire task multi-step. Ha accesso completo agli strumenti (tranne todo), quindi può modificare file quando serve. Usalo per eseguire più unità di lavoro in parallelo. --- -### Usa explore +### Explore _Mode_: `subagent` -Un agente rapido in sola lettura per esplorare codebase. Non puo' modificare file. Usalo quando devi trovare rapidamente file tramite pattern, cercare nel codice per keyword o rispondere a domande sul codebase. +Un agente rapido in sola lettura per esplorare codebase. Non può modificare file. Usalo quando devi trovare rapidamente file tramite pattern, cercare nel codice per keyword o rispondere a domande sul codebase. --- -### Usa compaction +### Compaction _Mode_: `primary` -Agente di sistema nascosto che compatta contesti lunghi in un riassunto piu' piccolo. Viene eseguito automaticamente quando serve e non e' selezionabile nella UI. +Agente di sistema nascosto che compatta contesti lunghi in un riassunto più piccolo. Viene eseguito automaticamente quando serve e non è selezionabile nella UI. --- -### Usa title +### Title _Mode_: `primary` -Agente di sistema nascosto che genera titoli brevi per le sessioni. Viene eseguito automaticamente quando serve e non e' selezionabile nella UI. +Agente di sistema nascosto che genera titoli brevi per le sessioni. Viene eseguito automaticamente quando serve e non è selezionabile nella UI. --- -### Usa summary +### Summary _Mode_: `primary` -Agente di sistema nascosto che crea riassunti di sessione. Viene eseguito automaticamente quando serve e non e' selezionabile nella UI. +Agente di sistema nascosto che crea riassunti di sessione. Viene eseguito automaticamente quando serve e non è selezionabile nella UI. --- @@ -113,21 +113,20 @@ Agente di sistema nascosto che crea riassunti di sessione. Viene eseguito automa 2. I subagenti possono essere invocati: - **Automaticamente** dagli agenti primari per task specializzati in base alle loro descrizioni. - - Manualmente **menzionando con @** un subagente nel tuo messaggio. Per esempio. + - Manualmente **menzionando con @** un subagente nel tuo messaggio. Per esempio: ```txt frame="none" @general help me search for this function ``` - -3. **Navigazione tra sessioni**: quando i subagenti creano le loro child session, puoi navigare tra la sessione padre e tutte le sessioni figlie usando: + 3. **Navigazione tra sessioni**: quando i subagenti creano le loro child session, puoi navigare tra la sessione padre e tutte le sessioni figlie usando: - **\+Right** (o la scorciatoia `session_child_cycle` configurata) per ciclare in avanti tra parent → child1 → child2 → ... → parent - **\+Left** (o la scorciatoia `session_child_cycle_reverse` configurata) per ciclare indietro tra parent ← child1 ← child2 ← ... ← parent - Questo ti permette di passare senza soluzione di continuita' tra la conversazione principale e il lavoro specializzato dei subagenti. + Questo ti permette di passare senza soluzione di continuità tra la conversazione principale e il lavoro specializzato dei subagenti. --- -## Configura +## Configurazione Puoi personalizzare gli agenti integrati o crearne di tuoi tramite configurazione. Gli agenti possono essere configurati in due modi: @@ -229,15 +228,15 @@ Usa l'opzione `description` per fornire una breve descrizione di cosa fa l'agent } ``` -Questa e' un'opzione di configurazione **obbligatoria**. +Questa è un'opzione di configurazione **obbligatoria**. --- ### Temperatura -Controlla casualita' e creativita' delle risposte dell'LLM con la config `temperature`. +Controlla casualità e creatività delle risposte dell'LLM con la config `temperature`. -Valori bassi rendono le risposte piu' focalizzate e deterministiche, mentre valori alti aumentano creativita' e variabilita'. +Valori bassi rendono le risposte più focalizzate e deterministiche, mentre valori alti aumentano creatività e variabilità. ```json title="opencode.json" { @@ -255,8 +254,8 @@ Valori bassi rendono le risposte piu' focalizzate e deterministiche, mentre valo I valori di temperature tipicamente vanno da 0.0 a 1.0: - **0.0-0.2**: risposte molto focalizzate e deterministiche, ideali per analisi del codice e pianificazione -- **0.3-0.5**: risposte bilanciate con un po' di creativita', adatte a task generali di sviluppo -- **0.6-1.0**: risposte piu' creative e varie, utili per brainstorming ed esplorazione +- **0.3-0.5**: risposte bilanciate con un po' di creatività, adatte a task generali di sviluppo +- **0.6-1.0**: risposte più creative e varie, utili per brainstorming ed esplorazione ```json title="opencode.json" { @@ -282,9 +281,9 @@ Se non specifichi una temperature, OpenCode usa i default specifici del modello; ### Passi massimi -Controlla il numero massimo di iterazioni agentiche che un agente puo' eseguire prima di essere forzato a rispondere solo con testo. Questo permette a chi vuole controllare i costi di impostare un limite alle azioni agentiche. +Controlla il numero massimo di iterazioni agentiche che un agente può eseguire prima di essere forzato a rispondere solo con testo. Questo permette a chi vuole controllare i costi di impostare un limite alle azioni agentiche. -Se non e' impostato, l'agente continuera' a iterare finche' il modello sceglie di fermarsi o l'utente interrompe la sessione. +Se non è impostato, l'agente continuerà a iterare finché il modello sceglie di fermarsi o l'utente interrompe la sessione. ```json title="opencode.json" { @@ -301,12 +300,12 @@ Se non e' impostato, l'agente continuera' a iterare finche' il modello sceglie d Quando viene raggiunto il limite, l'agente riceve un system prompt speciale che lo istruisce a rispondere con un riassunto del lavoro svolto e con i task rimanenti consigliati. :::caution -Il campo legacy `maxSteps` e' deprecato. Usa `steps`. +Il campo legacy `maxSteps` è deprecato. Usa `steps`. ::: --- -### Disabilita +### Disabilitazione Imposta a `true` per disabilitare l'agente. @@ -336,13 +335,13 @@ Specifica un file di system prompt personalizzato per questo agente tramite la c } ``` -Questo path e' relativo alla posizione del file di configurazione. Quindi funziona sia per la config globale di OpenCode sia per la config specifica del progetto. +Questo path è relativo alla posizione del file di configurazione. Quindi funziona sia per la config globale di OpenCode sia per la config specifica del progetto. --- ### Modello -Usa la config `model` per sovrascrivere il modello per questo agente. Utile per usare modelli diversi ottimizzati per task diversi. Per esempio, un modello piu' veloce per la pianificazione e uno piu' capace per l'implementazione. +Usa la config `model` per sovrascrivere il modello per questo agente. Utile per usare modelli diversi ottimizzati per task diversi. Per esempio, un modello più veloce per la pianificazione e uno più capace per l'implementazione. :::tip Se non specifichi un modello, gli agenti primari usano il [modello configurato globalmente](/docs/config#models), mentre i subagenti useranno il modello dell'agente primario che li ha invocati. @@ -388,7 +387,7 @@ Controlla quali strumenti sono disponibili per questo agente tramite la config ` La configurazione specifica dell'agente sovrascrive la configurazione globale. ::: -Puoi anche usare wildcard per controllare piu' strumenti in una volta. Per esempio, per disabilitare tutti gli strumenti di un server MCP: +Puoi anche usare wildcard per controllare più strumenti in una volta. Per esempio, per disabilitare tutti gli strumenti di un server MCP: ```json title="opencode.json" { @@ -405,13 +404,13 @@ Puoi anche usare wildcard per controllare piu' strumenti in una volta. Per esemp } ``` -[Scopri di piu' sugli strumenti](/docs/tools). +[Scopri di più sugli strumenti](/docs/tools). --- ### Permessi -Puoi configurare i permessi per gestire quali azioni un agente puo' eseguire. Attualmente, i permessi per gli strumenti `edit`, `bash` e `webfetch` possono essere configurati come: +Puoi configurare i permessi per gestire quali azioni un agente può eseguire. Attualmente, i permessi per gli strumenti `edit`, `bash` e `webfetch` possono essere configurati come: - `"ask"` — chiede approvazione prima di eseguire lo strumento - `"allow"` — consente tutte le operazioni senza approvazione @@ -481,7 +480,7 @@ Puoi impostare permessi per comandi bash specifici. } ``` -Questo puo' usare un glob pattern. +Questo può usare un glob pattern. ```json title="opencode.json" {7} { @@ -517,13 +516,13 @@ Dato che l'ultima regola che corrisponde ha la precedenza, metti prima la wildca } ``` -[Scopri di piu' sui permessi](/docs/permissions). +[Scopri di più sui permessi](/docs/permissions). --- -### Modalita' +### Modalità -Controlla la modalita' dell'agente con la config `mode`. L'opzione `mode` determina come l'agente puo' essere usato. +Controlla la modalità dell'agente con la config `mode`. L'opzione `mode` determina come l'agente può essere usato. ```json title="opencode.json" { @@ -535,7 +534,7 @@ Controlla la modalita' dell'agente con la config `mode`. L'opzione `mode` determ } ``` -`mode` puo' essere `primary`, `subagent` o `all`. Se `mode` non e' specificato, il default e' `all`. +`mode` può essere `primary`, `subagent` o `all`. Se `mode` non è specificato, il default è `all`. --- @@ -554,7 +553,7 @@ Nascondi un subagente dal menu autocomplete di `@` con `hidden: true`. Utile per } ``` -Questo influisce solo sulla visibilita' per l'utente nel menu autocomplete. Gli agenti nascosti possono comunque essere invocati dal modello tramite lo strumento Task se i permessi lo consentono. +Questo influisce solo sulla visibilità per l'utente nel menu autocomplete. Gli agenti nascosti possono comunque essere invocati dal modello tramite lo strumento Task se i permessi lo consentono. :::note Si applica solo ad agenti con `mode: subagent`. @@ -564,7 +563,7 @@ Si applica solo ad agenti con `mode: subagent`. ### Permessi Task -Controlla quali subagenti un agente puo' invocare tramite lo strumento Task con `permission.task`. Usa glob pattern per un matching flessibile. +Controlla quali subagenti un agente può invocare tramite lo strumento Task con `permission.task`. Usa glob pattern per un matching flessibile. ```json title="opencode.json" { @@ -583,10 +582,10 @@ Controlla quali subagenti un agente puo' invocare tramite lo strumento Task con } ``` -Quando e' impostato a `deny`, il subagente viene rimosso interamente dalla descrizione dello strumento Task, quindi il modello non provera' a invocarlo. +Quando è impostato a `deny`, il subagente viene rimosso interamente dalla descrizione dello strumento Task, quindi il modello non proverà a invocarlo. :::tip -Le regole vengono valutate in ordine e **vince l'ultima regola che corrisponde**. Nell'esempio sopra, `orchestrator-planner` corrisponde sia a `*` (deny) sia a `orchestrator-*` (allow), ma dato che `orchestrator-*` viene dopo `*`, il risultato e' `allow`. +Le regole vengono valutate in ordine e **vince l'ultima regola che corrisponde**. Nell'esempio sopra, `orchestrator-planner` corrisponde sia a `*` (deny) sia a `orchestrator-*` (allow), ma dato che `orchestrator-*` viene dopo `*`, il risultato è `allow`. ::: :::tip @@ -618,7 +617,7 @@ Usa un colore hex valido (ad es. `#FF5733`) o un colore tema: `primary`, `second ### Top P -Controlla la diversita' delle risposte con l'opzione `top_p`. Alternativa alla temperature per controllare la casualita'. +Controlla la diversità delle risposte con l'opzione `top_p`. Alternativa alla temperature per controllare la casualità. ```json title="opencode.json" { @@ -630,13 +629,13 @@ Controlla la diversita' delle risposte con l'opzione `top_p`. Alternativa alla t } ``` -I valori vanno da 0.0 a 1.0. Valori piu' bassi sono piu' focalizzati, valori piu' alti piu' diversi. +I valori vanno da 0.0 a 1.0. Valori più bassi sono più focalizzati, valori più alti più diversi. --- ### Opzioni aggiuntive -Qualsiasi altra opzione che specifichi nella configurazione dell'agente verra' **passata direttamente** al provider come opzione del modello. Questo ti permette di usare feature e parametri specifici del provider. +Qualsiasi altra opzione che specifichi nella configurazione dell'agente verrà **passata direttamente** al provider come opzione del modello. Questo ti permette di usare feature e parametri specifici del provider. Per esempio, con i modelli di reasoning di OpenAI, puoi controllare lo sforzo di ragionamento: @@ -661,7 +660,7 @@ Esegui `opencode models` per vedere la lista dei modelli disponibili. --- -## Crea agenti +## Creazione agenti Puoi creare nuovi agenti usando il comando seguente: @@ -674,7 +673,7 @@ Questo comando interattivo: 1. Chiede dove salvare l'agente: globale o specifico del progetto. 2. Chiede una descrizione di cosa dovrebbe fare l'agente. 3. Genera un system prompt appropriato e un identificatore. -4. Ti fa selezionare a quali strumenti l'agente puo' accedere. +4. Ti fa selezionare a quali strumenti l'agente può accedere. 5. Infine, crea un file markdown con la configurazione dell'agente. --- @@ -685,7 +684,7 @@ Ecco alcuni casi d'uso comuni per agenti diversi. - **Build agent**: sviluppo completo con tutti gli strumenti abilitati - **Plan agent**: analisi e pianificazione senza apportare modifiche -- **Review agent**: code review con accesso in sola lettura piu' strumenti documentazione +- **Review agent**: code review con accesso in sola lettura più strumenti documentazione - **Debug agent**: focalizzato sull'investigazione con strumenti bash e read abilitati - **Docs agent**: scrittura documentazione con operazioni sui file ma senza comandi di sistema diff --git a/packages/web/src/content/docs/it/cli.mdx b/packages/web/src/content/docs/it/cli.mdx index f7d153327..a97bbde1c 100644 --- a/packages/web/src/content/docs/it/cli.mdx +++ b/packages/web/src/content/docs/it/cli.mdx @@ -60,7 +60,7 @@ opencode agent [command] ### attach -Collega un terminale a un backend server di OpenCode gia' in esecuzione avviato tramite i comandi `serve` o `web`. +Collega un terminale a un backend server di OpenCode già in esecuzione avviato tramite i comandi `serve` o `web`. ```bash opencode attach [url] @@ -173,7 +173,7 @@ Installa l'agente GitHub nel tuo repository. opencode github install ``` -Questo configura il workflow GitHub Actions necessario e ti guida nel processo di configurazione. [Scopri di piu'](/docs/github). +Questo configura il workflow GitHub Actions necessario e ti guida nel processo di configurazione. [Scopri di più](/docs/github). --- @@ -240,7 +240,7 @@ Autentica con un server MCP con OAuth abilitato. opencode mcp auth [name] ``` -Se non fornisci un nome server, ti verra' chiesto di selezionare tra i server OAuth-capable disponibili. +Se non fornisci un nome server, ti verrà chiesto di selezionare tra i server OAuth-capable disponibili. Puoi anche elencare i server OAuth-capable e il loro stato di autenticazione. @@ -286,7 +286,7 @@ opencode models [provider] Questo comando mostra tutti i modelli disponibili tra i provider configurati nel formato `provider/model`. -E' utile per capire l'esatto nome del modello da usare nella [config](/docs/config/). +È utile per capire l'esatto nome del modello da usare nella [config](/docs/config/). Puoi anche passare opzionalmente un ID provider per filtrare i modelli a quel provider. @@ -296,12 +296,12 @@ opencode models anthropic #### Flag -| Flag | Descrizione | -| ----------- | --------------------------------------------------- | -| `--refresh` | Aggiorna la cache modelli da models.dev | -| `--verbose` | Output piu' verboso (include metadati come i costi) | +| Flag | Descrizione | +| ----------- | -------------------------------------------------- | +| `--refresh` | Aggiorna la cache modelli da models.dev | +| `--verbose` | Output più verboso (include metadati come i costi) | -Usa `--refresh` per aggiornare l'elenco modelli in cache. E' utile quando nuovi modelli vengono aggiunti a un provider e vuoi vederli in OpenCode. +Usa `--refresh` per aggiornare l'elenco modelli in cache. È utile quando nuovi modelli vengono aggiunti a un provider e vuoi vederli in OpenCode. ```bash opencode models --refresh @@ -311,19 +311,19 @@ opencode models --refresh ### run -Esegui opencode in modalita' non interattiva passando un prompt direttamente. +Esegui opencode in modalità non interattiva passando un prompt direttamente. ```bash opencode run [message..] ``` -E' utile per scripting, automazione o quando vuoi una risposta rapida senza avviare la TUI completa. Per esempio. +È utile per scripting, automazione o quando vuoi una risposta rapida senza avviare la TUI completa. Per esempio: ```bash "opencode run" opencode run Explain the use of context in Go ``` -Puoi anche collegarti a una istanza `opencode serve` gia' in esecuzione per evitare i cold boot dei server MCP ad ogni esecuzione: +Puoi anche collegarti a una istanza `opencode serve` già in esecuzione per evitare i cold boot dei server MCP ad ogni esecuzione: ```bash # Avvia un server headless in un terminale @@ -360,7 +360,7 @@ Avvia un server OpenCode headless per accesso via API. Vedi le [server docs](/do opencode serve ``` -Avvia un server HTTP che espone accesso API alle funzionalita' di opencode senza la TUI. Imposta `OPENCODE_SERVER_PASSWORD` per abilitare HTTP basic auth (username di default `opencode`). +Avvia un server HTTP che espone accesso API alle funzionalità di opencode senza la TUI. Imposta `OPENCODE_SERVER_PASSWORD` per abilitare HTTP basic auth (username di default `opencode`). #### Flag @@ -395,7 +395,7 @@ opencode session list | Flag | Breve | Descrizione | | ------------- | ----- | ------------------------------------ | -| `--max-count` | `-n` | Limita alle N sessioni piu' recenti | +| `--max-count` | `-n` | Limita alle N sessioni più recenti | | `--format` | | Formato output: table o json (table) | --- @@ -427,7 +427,7 @@ Esporta i dati di sessione come JSON. opencode export [sessionID] ``` -Se non fornisci un ID sessione, ti verra' chiesto di selezionare tra le sessioni disponibili. +Se non fornisci un ID sessione, ti verrà chiesto di selezionare tra le sessioni disponibili. --- @@ -551,7 +551,7 @@ La CLI di opencode accetta i seguenti flag globali. ## Variabili d'ambiente -OpenCode puo' essere configurato tramite variabili d'ambiente. +OpenCode può essere configurato tramite variabili d'ambiente. | Variabile | Tipo | Descrizione | | ------------------------------------- | ------- | ----------------------------------------------------------- | @@ -584,20 +584,20 @@ OpenCode puo' essere configurato tramite variabili d'ambiente. ### Sperimentale -Queste variabili d'ambiente abilitano funzionalita' sperimentali che potrebbero cambiare o essere rimosse. +Queste variabili d'ambiente abilitano funzionalità sperimentali che potrebbero cambiare o essere rimosse. -| Variabile | Tipo | Descrizione | -| ----------------------------------------------- | ------- | ------------------------------------------- | -| `OPENCODE_EXPERIMENTAL` | boolean | Abilita tutte le funzionalita' sperimentali | -| `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | boolean | Abilita icon discovery | -| `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | boolean | Disabilita copy on select nella TUI | -| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | number | Timeout di default per comandi bash in ms | -| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | number | Massimo token di output per risposte LLM | -| `OPENCODE_EXPERIMENTAL_FILEWATCHER` | boolean | Abilita file watcher per l'intera dir | -| `OPENCODE_EXPERIMENTAL_OXFMT` | boolean | Abilita formatter oxfmt | -| `OPENCODE_EXPERIMENTAL_LSP_TOOL` | boolean | Abilita strumento LSP sperimentale | -| `OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER` | boolean | Disabilita file watcher | -| `OPENCODE_EXPERIMENTAL_EXA` | boolean | Abilita funzionalita' Exa sperimentali | -| `OPENCODE_EXPERIMENTAL_LSP_TY` | boolean | Abilita type checking LSP sperimentale | -| `OPENCODE_EXPERIMENTAL_MARKDOWN` | boolean | Abilita markdown sperimentale | -| `OPENCODE_EXPERIMENTAL_PLAN_MODE` | boolean | Abilita plan mode | +| Variabile | Tipo | Descrizione | +| ----------------------------------------------- | ------- | ------------------------------------------ | +| `OPENCODE_EXPERIMENTAL` | boolean | Abilita tutte le funzionalità sperimentali | +| `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | boolean | Abilita icon discovery | +| `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | boolean | Disabilita copy on select nella TUI | +| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | number | Timeout di default per comandi bash in ms | +| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | number | Massimo token di output per risposte LLM | +| `OPENCODE_EXPERIMENTAL_FILEWATCHER` | boolean | Abilita file watcher per l'intera dir | +| `OPENCODE_EXPERIMENTAL_OXFMT` | boolean | Abilita formatter oxfmt | +| `OPENCODE_EXPERIMENTAL_LSP_TOOL` | boolean | Abilita strumento LSP sperimentale | +| `OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER` | boolean | Disabilita file watcher | +| `OPENCODE_EXPERIMENTAL_EXA` | boolean | Abilita funzionalità Exa sperimentali | +| `OPENCODE_EXPERIMENTAL_LSP_TY` | boolean | Abilita type checking LSP sperimentale | +| `OPENCODE_EXPERIMENTAL_MARKDOWN` | boolean | Abilita markdown sperimentale | +| `OPENCODE_EXPERIMENTAL_PLAN_MODE` | boolean | Abilita plan mode | diff --git a/packages/web/src/content/docs/it/commands.mdx b/packages/web/src/content/docs/it/commands.mdx index c6f8a874a..bec4bf8de 100644 --- a/packages/web/src/content/docs/it/commands.mdx +++ b/packages/web/src/content/docs/it/commands.mdx @@ -13,7 +13,7 @@ I comandi personalizzati si aggiungono a quelli integrati come `/init`, `/undo`, --- -## Crea file di comando +## Creazione file di comando Crea file markdown nella directory `commands/` per definire comandi personalizzati. @@ -40,7 +40,7 @@ Usa il comando digitando `/` seguito dal nome del comando. --- -## Configura +## Configurazione Puoi aggiungere comandi personalizzati tramite la config di OpenCode o creando file markdown nella directory `commands/`. @@ -217,7 +217,7 @@ Vediamo le opzioni di configurazione nel dettaglio. --- -### Modello di prompt +### Template del prompt L'opzione `template` definisce il prompt che verra inviato all'LLM quando il comando viene eseguito. @@ -311,7 +311,7 @@ Questa e un'opzione di config **opzionale**. --- -## Integrati +## Comandi integrati opencode include diversi comandi integrati come `/init`, `/undo`, `/redo`, `/share`, `/help`; [scopri di piu](/docs/tui#commands). diff --git a/packages/web/src/content/docs/it/config.mdx b/packages/web/src/content/docs/it/config.mdx index 45ab64b0c..c94cc59a9 100644 --- a/packages/web/src/content/docs/it/config.mdx +++ b/packages/web/src/content/docs/it/config.mdx @@ -1,6 +1,6 @@ --- -title: Config -description: Usa la config JSON di OpenCode. +title: Configurazione +description: Usa la configurazione JSON di OpenCode. --- Puoi configurare OpenCode usando un file di configurazione JSON. @@ -56,7 +56,7 @@ Le directory `.opencode` e `~/.config/opencode` usano **nomi al plurale** per le --- -### Remota +### Configurazione remota Le organizzazioni possono fornire una configurazione predefinita tramite l'endpoint `.well-known/opencode`. Viene recuperata automaticamente quando ti autentichi con un provider che lo supporta. @@ -92,7 +92,7 @@ Puoi abilitare server specifici nella tua configurazione locale: --- -### Globale +### Configurazione globale Metti la configurazione globale di OpenCode in `~/.config/opencode/opencode.json`. Usa la configurazione globale per preferenze valide per l'utente (ad es. temi, provider o keybind). @@ -100,7 +100,7 @@ La configurazione globale sovrascrive i default remoti dell'organizzazione. --- -### Per progetto +### Configurazione di progetto Aggiungi `opencode.json` nella root del progetto. La configurazione di progetto ha la precedenza piu alta tra i file standard: sovrascrive sia la configurazione globale sia quella remota. @@ -556,8 +556,7 @@ Puoi configurare le istruzioni per il modello che stai usando tramite l'opzione } ``` -Accetta un array di percorsi e pattern glob verso file di istruzioni. [Scopri di piu -sulle regole](/docs/rules). +Accetta un array di percorsi e pattern glob verso file di istruzioni. [Scopri di piu sulle regole](/docs/rules). --- diff --git a/packages/web/src/content/docs/it/custom-tools.mdx b/packages/web/src/content/docs/it/custom-tools.mdx index 431c55996..43f69c43c 100644 --- a/packages/web/src/content/docs/it/custom-tools.mdx +++ b/packages/web/src/content/docs/it/custom-tools.mdx @@ -7,7 +7,7 @@ Gli strumenti personalizzati sono funzioni che crei e che l'LLM puo chiamare dur --- -## Crea uno strumento +## Creazione di uno strumento Gli strumenti sono definiti come file **TypeScript** o **JavaScript**. Tuttavia, la definizione dello strumento puo invocare script scritti in **qualsiasi linguaggio**: TypeScript o JavaScript vengono usati solo per la definizione in se. @@ -45,7 +45,7 @@ Il **nome del file** diventa il **nome dello strumento**. L'esempio sopra crea l --- -#### Multiple tools per file +#### Strumenti multipli per file Puoi anche esportare piu strumenti da un singolo file. Ogni export diventa **uno strumento separato** con nome **`_`**: @@ -133,7 +133,7 @@ Usa `context.worktree` per la root del worktree git. ## Esempi -### Scrivi uno strumento in Python +### Scrivere uno strumento in Python Puoi scrivere gli strumenti in qualunque linguaggio. Ecco un esempio che somma due numeri usando Python. diff --git a/packages/web/src/content/docs/it/enterprise.mdx b/packages/web/src/content/docs/it/enterprise.mdx index 25bc79146..bd142e709 100644 --- a/packages/web/src/content/docs/it/enterprise.mdx +++ b/packages/web/src/content/docs/it/enterprise.mdx @@ -19,13 +19,13 @@ Per iniziare con OpenCode Enterprise: --- -## Trial +## Prova OpenCode e open source e non memorizza alcun tuo codice o dato di contesto, quindi i tuoi sviluppatori possono semplicemente [iniziare](/docs/) e fare una prova. --- -### Data handling +### Gestione dati **OpenCode non memorizza il tuo codice o i tuoi dati di contesto.** Tutta l'elaborazione avviene in locale o tramite chiamate API dirette al tuo provider AI. @@ -35,7 +35,7 @@ L'unica eccezione e la funzione opzionale `/share`. --- -#### Sharing conversations +#### Condivisione conversazioni Se un utente abilita la funzione `/share`, la conversazione e i dati associati vengono inviati al servizio che usiamo per ospitare queste pagine di condivisione su opencode.ai. @@ -50,29 +50,29 @@ Ti consigliamo di disabilitarla durante la prova. } ``` -[Learn more about sharing](/docs/share). +[Scopri di più sulla condivisione](/docs/share). --- -### Code ownership +### Proprietà del codice **Sei proprietario di tutto il codice prodotto da OpenCode.** Non ci sono restrizioni di licenza o rivendicazioni di proprieta. --- -## Pricing +## Prezzi Usiamo un modello per-seat per OpenCode Enterprise. Se hai un tuo gateway LLM, non addebitiamo i token usati. Per maggiori dettagli su prezzi e opzioni di implementazione, **contattaci**. --- -## Deployment +## Distribuzione Quando hai completato la prova e sei pronto a usare OpenCode nella tua organizzazione, puoi **contattarci** per discutere prezzi e opzioni di implementazione. --- -### Central Config +### Configurazione centralizzata Possiamo configurare OpenCode per usare un'unica config centralizzata per tutta l'organizzazione. @@ -80,7 +80,7 @@ Questa config centralizzata puo integrarsi col provider SSO e garantisce che tut --- -### SSO integration +### Integrazione SSO Tramite la config centralizzata, OpenCode puo integrarsi col provider SSO della tua organizzazione per l'autenticazione. @@ -88,7 +88,7 @@ Questo consente a OpenCode di ottenere credenziali per il gateway AI interno tra --- -### Internal AI gateway +### Gateway AI interno Con la config centralizzata, OpenCode puo anche essere configurato per usare solo il tuo gateway AI interno. @@ -96,7 +96,7 @@ Puoi anche disabilitare tutti gli altri provider AI, assicurandoti che tutte le --- -### Self-hosting +### Hosting autonomo Anche se consigliamo di disabilitare le pagine di condivisione per assicurarti che i dati non escano mai dall'organizzazione, possiamo anche aiutarti a ospitarle sulla tua infrastruttura. diff --git a/packages/web/src/content/docs/it/formatters.mdx b/packages/web/src/content/docs/it/formatters.mdx index 1cd9c157e..b662db47e 100644 --- a/packages/web/src/content/docs/it/formatters.mdx +++ b/packages/web/src/content/docs/it/formatters.mdx @@ -7,7 +7,7 @@ OpenCode formatta automaticamente i file dopo che vengono scritti o modificati u --- -## Built-in +## Integrati OpenCode include diversi formattatori integrati per linguaggi e framework popolari. Qui sotto trovi la lista dei formattatori, delle estensioni supportate e dei comandi o opzioni di config richiesti. @@ -42,7 +42,7 @@ Quindi, se il progetto ha `prettier` in `package.json`, OpenCode lo usera automa --- -## How it works +## Come funziona Quando OpenCode scrive o modifica un file: @@ -54,7 +54,7 @@ Questo processo avviene in background, mantenendo lo stile del codice senza pass --- -## Configure +## Configurazione Puoi personalizzare i formattatori nella sezione `formatter` della config di OpenCode. @@ -78,7 +78,7 @@ Vediamo alcuni esempi. --- -### Disabling formatters +### Disabilitare i formattatori Per disabilitare **tutti** i formattatori globalmente, imposta `formatter` a `false`: @@ -104,7 +104,7 @@ Per disabilitare un formattatore **specifico**, imposta `disabled` a `true`: --- -### Custom formatters +### Formattatori personalizzati Puoi sovrascrivere i formattatori integrati o aggiungerne di nuovi specificando comando, variabili d'ambiente ed estensioni file: diff --git a/packages/web/src/content/docs/it/github.mdx b/packages/web/src/content/docs/it/github.mdx index c18ab7eb1..81bbd5933 100644 --- a/packages/web/src/content/docs/it/github.mdx +++ b/packages/web/src/content/docs/it/github.mdx @@ -7,7 +7,7 @@ OpenCode si integra nel tuo workflow GitHub. Menziona `/opencode` o `/oc` in un --- -## Funzionalita' +## Funzionalità - **Triage delle issue**: chiedi a OpenCode di indagare su una issue e spiegartela. - **Fix e implementazioni**: chiedi a OpenCode di risolvere una issue o implementare una feature. Lavorera' su un nuovo branch e inviera' una PR con tutte le modifiche. diff --git a/packages/web/src/content/docs/it/gitlab.mdx b/packages/web/src/content/docs/it/gitlab.mdx index 5b3de5c44..479f7db9e 100644 --- a/packages/web/src/content/docs/it/gitlab.mdx +++ b/packages/web/src/content/docs/it/gitlab.mdx @@ -17,7 +17,7 @@ Qui usiamo un componente CI/CD creato dalla community per OpenCode — [nagyv/gi --- -### Funzionalita' +### Funzionalità - **Configurazione personalizzata per job**: configura OpenCode con una directory di configurazione personalizzata, ad esempio `./config/#custom-directory`, per abilitare o disabilitare funzionalita' per ogni invocazione di OpenCode. - **Setup minimo**: il componente CI prepara OpenCode in background; devi solo creare la configurazione OpenCode e il prompt iniziale. @@ -25,7 +25,7 @@ Qui usiamo un componente CI/CD creato dalla community per OpenCode — [nagyv/gi --- -### Setup +### Configurazione 1. Salva il JSON di autenticazione di OpenCode come variabile d'ambiente CI di tipo File in **Settings** > **CI/CD** > **Variables**. Assicurati di marcarla come "Masked and hidden". 2. Aggiungi quanto segue al tuo file `.gitlab-ci.yml`. @@ -51,7 +51,7 @@ Menziona `@opencode` in un commento e OpenCode eseguira' i task dentro la tua pi --- -### Funzionalita' +### Funzionalità - **Triage delle issue**: chiedi a OpenCode di indagare su una issue e spiegartela. - **Fix e implementazioni**: chiedi a OpenCode di risolvere una issue o implementare una feature. @@ -60,7 +60,7 @@ Menziona `@opencode` in un commento e OpenCode eseguira' i task dentro la tua pi --- -### Setup +### Configurazione OpenCode gira nella pipeline GitLab CI/CD. Ecco cosa ti serve per configurarlo: diff --git a/packages/web/src/content/docs/it/index.mdx b/packages/web/src/content/docs/it/index.mdx index 442f27b97..685bdf0c5 100644 --- a/packages/web/src/content/docs/it/index.mdx +++ b/packages/web/src/content/docs/it/index.mdx @@ -211,7 +211,7 @@ Questo e utile se c'e una parte della codebase su cui non hai lavorato. --- -### Aggiungi funzionalita +### Aggiungi funzionalità Puoi chiedere a OpenCode di aggiungere nuove funzionalita al progetto. Pero ti consigliamo prima di chiedergli di creare un piano. diff --git a/packages/web/src/content/docs/it/models.mdx b/packages/web/src/content/docs/it/models.mdx index a1ee9a5db..7ac17115e 100644 --- a/packages/web/src/content/docs/it/models.mdx +++ b/packages/web/src/content/docs/it/models.mdx @@ -7,7 +7,7 @@ OpenCode usa [AI SDK](https://ai-sdk.dev/) e [Models.dev](https://models.dev) pe --- -## Providers +## Provider I provider piu popolari sono precaricati per impostazione predefinita. Se hai aggiunto le credenziali di un provider tramite il comando `/connect`, saranno disponibili quando avvii OpenCode. @@ -63,7 +63,7 @@ Se hai configurato un [provider personalizzato](/docs/providers#custom), `provid --- -## Configure models +## Configurazione modelli Puoi configurare globalmente le opzioni di un modello tramite la config. @@ -134,11 +134,11 @@ Puoi anche definire varianti personalizzate che estendono quelle integrate. Le v --- -## Variants +## Varianti Molti modelli supportano piu varianti con configurazioni diverse. OpenCode include varianti predefinite integrate per i provider piu comuni. -### Built-in variants +### Varianti integrate OpenCode include varianti predefinite per molti provider: @@ -167,7 +167,7 @@ Varies by model but roughly: Questa lista non e completa. Anche molti altri provider hanno default integrati. ::: -### Custom variants +### Varianti personalizzate Puoi sovrascrivere varianti esistenti o aggiungerne di tue: @@ -194,13 +194,13 @@ Puoi sovrascrivere varianti esistenti o aggiungerne di tue: } ``` -### Cycle variants +### Ciclare tra varianti Usa il keybind `variant_cycle` per passare rapidamente tra le varianti. [Scopri di piu](/docs/keybinds). --- -## Loading models +## Caricamento modelli Quando OpenCode si avvia, controlla i modelli in questo ordine di priorita: diff --git a/packages/web/src/content/docs/it/modes.mdx b/packages/web/src/content/docs/it/modes.mdx index 5b0ebe885..82e205870 100644 --- a/packages/web/src/content/docs/it/modes.mdx +++ b/packages/web/src/content/docs/it/modes.mdx @@ -1,5 +1,5 @@ --- -title: Modalita +title: Modalità description: Modalita diverse per casi d'uso diversi. --- @@ -41,7 +41,7 @@ Questa modalita e utile quando vuoi che l'AI analizzi il codice, suggerisca modi --- -## Cambiare modalita +## Cambiare modalità Puoi cambiare modalita durante una sessione usando il tasto _Tab_. In alternativa, puoi usare il keybind `switch_mode` che hai configurato. @@ -49,7 +49,7 @@ Vedi anche: [Formatter](/docs/formatters) per informazioni sulla configurazione --- -## Configura +## Configurazione Puoi personalizzare le modalita integrate o crearne di tue tramite configurazione. Le modalita si possono configurare in due modi: @@ -240,7 +240,7 @@ Ecco tutti gli strumenti che possono essere controllati tramite la configurazion --- -## Modalita personalizzate +## Modalità personalizzate Puoi creare modalita personalizzate aggiungendole alla configurazione. Ecco esempi con entrambi gli approcci: diff --git a/packages/web/src/content/docs/it/providers.mdx b/packages/web/src/content/docs/it/providers.mdx index fc9705c54..11ed9e141 100644 --- a/packages/web/src/content/docs/it/providers.mdx +++ b/packages/web/src/content/docs/it/providers.mdx @@ -1,5 +1,5 @@ --- -title: Providers +title: Provider description: Usa qualsiasi provider LLM in OpenCode. --- diff --git a/packages/web/src/content/docs/it/server.mdx b/packages/web/src/content/docs/it/server.mdx index 51f0f3b53..df66d39fd 100644 --- a/packages/web/src/content/docs/it/server.mdx +++ b/packages/web/src/content/docs/it/server.mdx @@ -129,7 +129,7 @@ Il server opencode espone le seguenti API. --- -### Provider +### Fornitori | Metodo | Path | Descrizione | Response | | ------ | -------------------------------- | ------------------------------- | ----------------------------------------------------------------------------------- | diff --git a/packages/web/src/content/docs/it/skills.mdx b/packages/web/src/content/docs/it/skills.mdx index 824ea4054..e65bdc94e 100644 --- a/packages/web/src/content/docs/it/skills.mdx +++ b/packages/web/src/content/docs/it/skills.mdx @@ -8,7 +8,7 @@ Le skill vengono caricate on-demand tramite lo strumento nativo `skill`: gli age --- -## Posiziona i file +## Posizione dei file Crea una cartella per ogni nome di skill e metti un `SKILL.md` al suo interno. OpenCode cerca in queste posizioni: @@ -22,7 +22,7 @@ OpenCode cerca in queste posizioni: --- -## Comprendere la discovery +## Discovery Per i percorsi locali al progetto, OpenCode risale dalla directory di lavoro corrente finche' non raggiunge il worktree git. Carica qualsiasi `skills/*/SKILL.md` corrispondente in `.opencode/` e qualsiasi `.claude/skills/*/SKILL.md` o `.agents/skills/*/SKILL.md` corrispondente lungo il percorso. @@ -31,7 +31,7 @@ Le definizioni globali vengono caricate anche da `~/.config/opencode/skills/*/SK --- -## Scrivi il frontmatter +## Frontmatter Ogni `SKILL.md` deve iniziare con frontmatter YAML. Sono riconosciuti solo questi campi: @@ -46,7 +46,7 @@ I campi di frontmatter sconosciuti vengono ignorati. --- -## Valida i nomi +## Validazione nomi `name` deve: @@ -64,14 +64,14 @@ Regex equivalente: --- -## Rispetta le regole di lunghezza +## Regole di lunghezza `description` deve essere lunga 1-1024 caratteri. Tieni la descrizione abbastanza specifica da permettere all'agente di scegliere correttamente. --- -## Usa un esempio +## Esempio Crea `.opencode/skills/git-release/SKILL.md` cosi': @@ -100,7 +100,7 @@ Ask clarifying questions if the target versioning scheme is unclear. --- -## Riconoscere la descrizione dello strumento +## Descrizione strumento OpenCode elenca le skill disponibili nella descrizione dello strumento `skill`. Ogni voce include il nome della skill e la descrizione: @@ -122,7 +122,7 @@ skill({ name: "git-release" }) --- -## Configura i permessi +## Permessi Controlla a quali skill gli agenti possono accedere usando permessi basati su pattern in `opencode.json`: @@ -149,7 +149,7 @@ I pattern supportano wildcard: `internal-*` corrisponde a `internal-docs`, `inte --- -## Sovrascrivi per agente +## Sovrascrittura per agente Dai ad agenti specifici permessi diversi dai default globali. @@ -181,7 +181,7 @@ permission: --- -## Disabilita lo strumento skill +## Disabilitare skill Disabilita completamente le skill per agenti che non dovrebbero usarle: @@ -212,7 +212,7 @@ Quando e' disabilitato, la sezione `` viene omessa completamen --- -## Risoluzione problemi di caricamento +## Risoluzione problemi Se una skill non compare: diff --git a/packages/web/src/content/docs/it/tools.mdx b/packages/web/src/content/docs/it/tools.mdx index 67a0640c7..afd10b331 100644 --- a/packages/web/src/content/docs/it/tools.mdx +++ b/packages/web/src/content/docs/it/tools.mdx @@ -9,7 +9,7 @@ Di default, tutti gli strumenti sono **abilitati** e non richiedono permessi per --- -## Configura +## Configurazione Usa il campo `permission` per controllare il comportamento degli strumenti. Puoi consentire, negare o richiedere approvazione per ciascuno. diff --git a/packages/web/src/content/docs/it/tui.mdx b/packages/web/src/content/docs/it/tui.mdx index f24612f46..8a09c97a3 100644 --- a/packages/web/src/content/docs/it/tui.mdx +++ b/packages/web/src/content/docs/it/tui.mdx @@ -350,7 +350,7 @@ Alcuni editor richiedono argomenti da riga di comando per funzionare in modalita --- -## Configura +## Configurazione Puoi personalizzare il comportamento della TUI tramite il file di config di OpenCode. diff --git a/packages/web/src/content/docs/ja/acp.mdx b/packages/web/src/content/docs/ja/acp.mdx index a3893824d..f7b995bf3 100644 --- a/packages/web/src/content/docs/ja/acp.mdx +++ b/packages/web/src/content/docs/ja/acp.mdx @@ -1,18 +1,18 @@ --- -title: ACPのサポート +title: ACP サポート description: ACP 互換エディターで OpenCode を使用します。 --- OpenCode は [Agent Client Protocol](https://agentclientprotocol.com) または (ACP) をサポートしているため、互換性のあるエディターや IDE で直接使用できます。 :::tip -ACP をサポートするエディターとツールのリストについては、[ACP progress report](https://zed.dev/blog/acp-progress-report#available-now). +ACP をサポートするエディターとツールのリストについては、[ACP progress report](https://zed.dev/blog/acp-progress-report#available-now) を参照してください。 ::: -ACP は、コード エディターと AI コーディング エージェント間の通信を標準化するオープン プロトコルです。 +ACP は、コードエディターと AI コーディングエージェント間の通信を標準化するオープンプロトコルです。 --- -## 設定する +## 設定 ACP 経由で OpenCode を使用するには、`opencode acp` コマンドを実行するようにエディタを設定します。 @@ -37,9 +37,9 @@ ACP 経由で OpenCode を使用するには、`opencode acp` コマンドを実 } ``` -これを開くには、**コマンド パレット**の `agent: new thread` アクションを使用します。 +これを開くには、**コマンドパレット**の `agent: new thread` アクションを使用します。 -`keymap.json` を編集してキーボード ショートカットをバインドすることもできます。 +`keymap.json` を編集してキーボードショートカットをバインドすることもできます。 ```json title="keymap.json" [ @@ -81,7 +81,7 @@ ACP 経由で OpenCode を使用するには、`opencode acp` コマンドを実 } ``` -これを開くには、AI Chat エージェント セレクターで新しい「OpenCode」エージェントを使用します。 +これを開くには、AI Chat エージェントセレクターで新しい「OpenCode」エージェントを使用します。 --- @@ -141,15 +141,15 @@ require("codecompanion").setup({ ## サポート -OpenCode は、ACP 経由でもterminal 内で動作するのと同じように動作します。すべての機能がサポートされています。 +OpenCode は、ACP 経由でもターミナル内で動作するのと同じように動作します。すべての機能がサポートされています。 :::note -`/undo` や `/redo` などの一部の組み込みスラッシュ コマンドは現在サポートされていません。 +`/undo` や `/redo` などの一部の組み込みスラッシュコマンドは現在サポートされていません。 ::: -- 組み込みツール (ファイル操作、terminalコマンドなど) +- 組み込みツール (ファイル操作、ターミナルコマンドなど) - カスタムツールとスラッシュコマンド -- OpenCode 構成で構成された MCP サーバー +- OpenCode 設定で構成された MCP サーバー - `AGENTS.md` のプロジェクト固有のルール - カスタムフォーマッタとリンター - エージェントと権限システム diff --git a/packages/web/src/content/docs/ja/agents.mdx b/packages/web/src/content/docs/ja/agents.mdx index 946d9bc41..879a43b05 100644 --- a/packages/web/src/content/docs/ja/agents.mdx +++ b/packages/web/src/content/docs/ja/agents.mdx @@ -3,12 +3,13 @@ title: エージェント description: 特殊なエージェントを構成して使用します。 --- -エージェントは、特定のタスクやワークフロー向けに構成できる特殊な AI アシスタントです。これらを使用すると、カスタム プロンプト、モデル、ツール アクセスを備えた焦点を絞ったツールを作成できます。 +エージェントは、特定のタスクやワークフロー向けに構成できる特殊な AI アシスタントです。これらを使用すると、カスタムプロンプト、モデル、ツールアクセスを備えた焦点を絞ったツールを作成できます。 :::tip -プラン エージェントを使用すると、コードを変更せずにコードを分析し、提案を確認できます。 +Plan エージェントを使用すると、コードを変更せずにコードを分析し、提案を確認できます。 ::: -You can switch between agents during a session or invoke them with the `@` mention. + +セッション中にエージェントを切り替えたり、`@` メンションでエージェントを呼び出したりできます。 --- @@ -18,40 +19,41 @@ OpenCode には 2 種類のエージェントがあります。プライマリ --- -### 主要エージェント +### プライマリエージェント -プライマリ エージェントは、直接対話する主要なアシスタントです。 **Tab** キー、または設定した `switch_agent` キーバインドを使用して、それらを切り替えることができます。これらのエージェントが主な会話を処理します。ツールへのアクセスは権限によって構成されます。たとえば、Build ではすべてのツールが有効になっていますが、Plan は制限されています。 +プライマリエージェントは、直接対話する主要なアシスタントです。 **Tab** キー、または設定した `switch_agent` キーバインドを使用して、それらを切り替えることができます。これらのエージェントが主な会話を処理します。ツールへのアクセスは権限によって構成されます。たとえば、Build ではすべてのツールが有効になっていますが、Plan は制限されています。 :::tip -**Tab** キーを使用して、セッション中にプライマリ エージェントを切り替えることができます。 +**Tab** キーを使用して、セッション中にプライマリエージェントを切り替えることができます。 ::: -OpenCode には、**Build** と **Plan** という 2 つの組み込みプライマリ エージェントが付属しています。これらについて以下で説明します。 + +OpenCode には、**Build** と **Plan** という 2 つの組み込みプライマリエージェントが付属しています。これらについて以下で説明します。 --- ### サブエージェント -サブエージェントは、プライマリ エージェントが特定のタスクのために呼び出すことができる特殊なアシスタントです。メッセージ内で **@ メンション**することで、手動で呼び出すこともできます。 +サブエージェントは、プライマリエージェントが特定のタスクのために呼び出すことができる特殊なアシスタントです。メッセージ内で **@ メンション**することで、手動で呼び出すこともできます。 OpenCode には、**General** と **Explore** という 2 つの組み込みサブエージェントが付属しています。これについては以下で見ていきます。 --- -## 内蔵 +## 組み込み -OpenCode には、2 つの組み込みプライマリ エージェントと 2 つの組み込みサブエージェントが付属しています。 +OpenCode には、2 つの組み込みプライマリエージェントと 2 つの組み込みサブエージェントが付属しています。 --- -### ビルドを使用する +### Build _モード_: `primary` -ビルドは、すべてのツールが有効になっている **デフォルト** プライマリ エージェントです。これは、ファイル操作やシステム コマンドへの完全なアクセスが必要な開発作業用の標準エージェントです。 +Build は、すべてのツールが有効になっている **デフォルト** プライマリエージェントです。これは、ファイル操作やシステムコマンドへの完全なアクセスが必要な開発作業用の標準エージェントです。 --- -### 利用プラン +### Plan _モード_: `primary` @@ -65,15 +67,15 @@ _モード_: `primary` --- -### 一般的な使用 +### General _モード_: `subagent` -複雑な質問を調査し、複数ステップのタスクを実行するための汎用エージェント。完全なツール アクセス権 (todo を除く) があるため、必要に応じてファイルを変更できます。これを使用して、複数の作業単位を並行して実行します。 +複雑な質問を調査し、複数ステップのタスクを実行するための汎用エージェント。完全なツールアクセス権 (todo を除く) があるため、必要に応じてファイルを変更できます。これを使用して、複数の作業単位を並行して実行します。 --- -### 探索を使用する +### Explore _モード_: `subagent` @@ -81,36 +83,36 @@ _モード_: `subagent` --- -### 圧縮を使用する +### Compact _モード_: `primary` -長いコンテキストを小さな要約に圧縮する隠しシステム エージェント。これは必要に応じて自動的に実行され、UI では選択できません。 +長いコンテキストを小さな要約に圧縮する隠しシステムエージェント。これは必要に応じて自動的に実行され、UI では選択できません。 --- -### タイトルを使用する +### Title _モード_: `primary` -短いセッション タイトルを生成する非表示のシステム エージェント。これは自動的に実行され、UI では選択できません。 +短いセッションタイトルを生成する非表示のシステムエージェント。これは自動的に実行され、UI では選択できません。 --- -### 使用概要 +### Summary _モード_: `primary` -セッション概要を作成する非表示のシステム エージェント。これは自動的に実行され、UI では選択できません。 +セッション概要を作成する非表示のシステムエージェント。これは自動的に実行され、UI では選択できません。 --- ## 使用法 -1. プライマリ エージェントの場合は、セッション中に **Tab** キーを使用してエージェントを切り替えます。設定した `switch_agent` キーバインドを使用することもできます。 +1. プライマリエージェントの場合は、セッション中に **Tab** キーを使用してエージェントを切り替えます。設定した `switch_agent` キーバインドを使用することもできます。 2. サブエージェントは次のように呼び出すことができます。 - - プライマリ エージェントによって、説明に基づいて特殊なタスクを **自動的に** 実行されます。 + - プライマリエージェントによって、説明に基づいて特殊なタスクを **自動的に** 実行されます。 - メッセージ内でサブエージェントを **@ メンション**することで手動で実行できます。例えば。 ```txt frame="none" @@ -125,7 +127,7 @@ _モード_: `primary` --- -## 設定する +## 設定 組み込みエージェントをカスタマイズしたり、構成を通じて独自のエージェントを作成したりできます。エージェントは次の 2 つの方法で構成できます。 @@ -133,7 +135,7 @@ _モード_: `primary` ### JSON -`opencode.json` 構成ファイルでエージェントを構成します。 +`opencode.json` 設定ファイルでエージェントを構成します。 ```json title="opencode.json" { @@ -209,7 +211,7 @@ Markdown ファイル名がエージェント名になります。たとえば ## オプション -これらの構成オプションを詳しく見てみましょう。 +これらの設定オプションを詳しく見てみましょう。 --- @@ -227,7 +229,7 @@ Markdown ファイル名がエージェント名になります。たとえば } ``` -これは**必須**の構成オプションです。 +これは**必須**の設定オプションです。 --- @@ -278,7 +280,7 @@ Markdown ファイル名がエージェント名になります。たとえば --- -### 最大ステップ数 +### ステップ数 エージェントが強制的にテキストのみで応答するまでに実行できるエージェントの反復の最大数を制御します。これにより、コストを管理したいユーザーは、エージェントのアクションに制限を設定できます。 @@ -296,7 +298,7 @@ Markdown ファイル名がエージェント名になります。たとえば } ``` -制限に達すると、エージェントは、作業の概要と推奨される残りのタスクを応答するように指示する特別なシステム プロンプトを受け取ります。 +制限に達すると、エージェントは、作業の概要と推奨される残りのタスクを応答するように指示する特別なシステムプロンプトを受け取ります。 :::caution 従来の `maxSteps` フィールドは非推奨になりました。代わりに `steps` を使用してください。 @@ -304,7 +306,7 @@ Markdown ファイル名がエージェント名になります。たとえば --- -### 無効にする +### 無効化 エージェントを無効にするには、`true` に設定します。 @@ -322,7 +324,7 @@ Markdown ファイル名がエージェント名になります。たとえば ### プロンプト -`prompt` 構成を使用して、このエージェントのカスタム システム プロンプト ファイルを指定します。プロンプト ファイルには、エージェントの目的に固有の指示が含まれている必要があります。 +`prompt` 設定を使用して、このエージェントのカスタムシステムプロンプトファイルを指定します。プロンプトファイルには、エージェントの目的に固有の指示が含まれている必要があります。 ```json title="opencode.json" { @@ -334,16 +336,16 @@ Markdown ファイル名がエージェント名になります。たとえば } ``` -このパスは、構成ファイルが配置されている場所に対する相対パスです。したがって、これはグローバルな OpenCode 構成とプロジェクト固有の構成の両方で機能します。 +このパスは、設定ファイルが配置されている場所に対する相対パスです。したがって、これはグローバルな OpenCode 設定とプロジェクト固有の設定の両方で機能します。 --- ### モデル -`model` 構成を使用して、このエージェントのモデルをオーバーライドします。さまざまなタスクに最適化されたさまざまなモデルを使用する場合に役立ちます。たとえば、計画にはより高速なモデルを、実装にはより有能なモデルを使用します。 +`model` 設定を使用して、このエージェントのモデルをオーバーライドします。さまざまなタスクに最適化されたさまざまなモデルを使用する場合に役立ちます。たとえば、計画にはより高速なモデルを、実装にはより有能なモデルを使用します。 :::tip -モデルを指定しない場合、プライマリ エージェントは [グローバルに設定されたモデル ](/docs/config#models) を使用し、サブエージェントはサブエージェントを呼び出したプライマリ エージェントのモデルを使用します。 +モデルを指定しない場合、プライマリエージェントは [グローバルに設定されたモデル](/docs/config#models) を使用し、サブエージェントはサブエージェントを呼び出したプライマリエージェントのモデルを使用します。 ::: ```json title="opencode.json" @@ -356,13 +358,13 @@ Markdown ファイル名がエージェント名になります。たとえば } ``` -OpenCode 構成内のモデル ID は、`provider/model-id` という形式を使用します。たとえば、[OpenCode Zen](/docs/zen) を使用している場合、GPT 5.1 Codex には `opencode/gpt-5.1-codex` を使用します。 +OpenCode 設定内のモデル ID は、`provider/model-id` という形式を使用します。たとえば、[OpenCode Zen](/docs/zen) を使用している場合、GPT 5.1 Codex には `opencode/gpt-5.1-codex` を使用します。 --- ### ツール -`tools` 構成を使用して、このエージェントで使用できるツールを制御します。特定のツールを `true` または `false` に設定することで、有効または無効にすることができます。 +`tools` 設定を使用して、このエージェントで使用できるツールを制御します。特定のツールを `true` または `false` に設定することで、有効または無効にすることができます。 ```json title="opencode.json" {3-6,9-12} { @@ -402,7 +404,7 @@ MCP サーバーからすべてのツールを無効にするには、次のよ } ``` -[tools](/docs/tools) について詳しくはこちらをご覧ください。 +[ツール](/docs/tools) について詳しくはこちらをご覧ください。 --- @@ -478,7 +480,7 @@ Only analyze code and suggest changes. } ``` -これにはグロブ パターンを使用できます。 +これにはグロブパターンを使用できます。 ```json title="opencode.json" {7} { @@ -536,9 +538,9 @@ Only analyze code and suggest changes. --- -### 隠れた +### 非表示 -`@` を使用して、`hidden: true` オートコンプリート メニューからサブエージェントを非表示にします。他のエージェントによってタスク ツールを介してプログラム的にのみ呼び出す必要がある内部サブエージェントに役立ちます。 +`@` を使用して、`hidden: true` オートコンプリートメニューからサブエージェントを非表示にします。他のエージェントによってタスクツールを介してプログラム的にのみ呼び出す必要がある内部サブエージェントに役立ちます。 ```json title="opencode.json" { @@ -551,7 +553,7 @@ Only analyze code and suggest changes. } ``` -これは、オートコンプリート メニューでのユーザーの表示にのみ影響します。権限が許可されていれば、非表示のエージェントをタスク ツール経由でモデルから呼び出すことができます。 +これは、オートコンプリートメニューでのユーザーの表示にのみ影響します。権限が許可されていれば、非表示のエージェントをタスクツール経由でモデルから呼び出すことができます。 :::note `mode: subagent` エージェントにのみ適用されます。 @@ -561,7 +563,7 @@ Only analyze code and suggest changes. ### タスクの権限 -`permission.task` を使用して、エージェントがタスク ツール経由でどのサブエージェントを呼び出すことができるかを制御します。柔軟なマッチングのためにグロブ パターンを使用します。 +`permission.task` を使用して、エージェントがタスクツール経由でどのサブエージェントを呼び出すことができるかを制御します。柔軟なマッチングのためにグロブパターンを使用します。 ```json title="opencode.json" { @@ -580,12 +582,12 @@ Only analyze code and suggest changes. } ``` -`deny` に設定すると、サブエージェントはタスク ツールの説明から完全に削除されるため、モデルはそれを呼び出そうとしません。 +`deny` に設定すると、サブエージェントはタスクツールの説明から完全に削除されるため、モデルはそれを呼び出そうとしません。 :::tip ルールは順番に評価され、**最後に一致したルールが優先されます**。上記の例では、`orchestrator-planner` は `*` (拒否) と `orchestrator-*` (許可) の両方に一致しますが、`orchestrator-*` は `*` の後に来るため、結果は `allow` になります。 :::tip -ユーザーは、エージェントのタスク権限が拒否する場合でも、`@` オートコンプリート メニューを介して、いつでもサブエージェントを直接呼び出すことができます。 +ユーザーは、エージェントのタスク権限が拒否する場合でも、`@` オートコンプリートメニューを介して、いつでもサブエージェントを直接呼び出すことができます。 ::: --- @@ -611,7 +613,7 @@ Only analyze code and suggest changes. --- -### トップP +### Top P `top_p` オプションで応答の多様性を制御します。ランダム性を制御するための温度の代替手段。 @@ -629,9 +631,9 @@ Only analyze code and suggest changes. --- -### 追加 +### 追加オプション -エージェント設定で指定したその他のオプションはすべて、モデル オプションとしてプロバイダーに**直接渡されます**。これにより、プロバイダー固有の機能とパラメーターを使用できるようになります。 +エージェント設定で指定したその他のオプションはすべて、モデルオプションとしてプロバイダーに**直接渡されます**。これにより、プロバイダー固有の機能とパラメーターを使用できるようになります。 たとえば、OpenAI の推論モデルを使用すると、推論の労力を制御できます。 @@ -668,9 +670,9 @@ opencode agent create 1. エージェントを保存する場所を尋ねます。グローバルまたはプロジェクト固有。 2. エージェントが行うべきことの説明。 -3. 適切なシステム プロンプトと識別子を生成します。 +3. 適切なシステムプロンプトと識別子を生成します。 4. エージェントがアクセスできるツールを選択できます。 -5. 最後に、エージェント構成を含むMarkdown ファイルを作成します。 +5. 最後に、エージェント設定を含む Markdown ファイルを作成します。 --- @@ -678,11 +680,11 @@ opencode agent create さまざまなエージェントの一般的な使用例をいくつか示します。 -- **ビルド エージェント**: すべてのツールを有効にした完全な開発作業 +- **ビルドエージェント**: すべてのツールを有効にした完全な開発作業 - **計画エージェント**: 変更を加えずに分析および計画を立てる -- **レビュー エージェント**: 読み取り専用アクセスとドキュメント ツールを備えたコード レビュー -- **デバッグ エージェント**: bash および読み取りツールを有効にして調査に重点を置きます -- **ドキュメント エージェント**: ファイル操作を使用してドキュメントを作成しますが、システム コマンドは使用しません +- **レビューエージェント**: 読み取り専用アクセスとドキュメントツールを備えたコードレビュー +- **デバッグエージェント**: bash および読み取りツールを有効にして調査に重点を置きます +- **ドキュメントエージェント**: ファイル操作を使用してドキュメントを作成しますが、システムコマンドは使用しません --- @@ -696,7 +698,7 @@ opencode agent create --- -### 文書作成エージェント +### ドキュメント作成エージェント ```markdown title="~/.config/opencode/agents/docs-writer.md" --- @@ -718,7 +720,7 @@ Focus on: --- -### セキュリティ監査人 +### セキュリティ監査エージェント ```markdown title="~/.config/opencode/agents/security-auditor.md" --- diff --git a/packages/web/src/content/docs/ja/cli.mdx b/packages/web/src/content/docs/ja/cli.mdx index 837452d61..aeae74731 100644 --- a/packages/web/src/content/docs/ja/cli.mdx +++ b/packages/web/src/content/docs/ja/cli.mdx @@ -21,15 +21,15 @@ opencode run "Explain how closures work in JavaScript" ### tui -OpenCode terminal ユーザー インターフェイスを開始します。 +OpenCode ターミナルユーザーインターフェイスを開始します。 ```bash opencode [project] ``` -#### Flags +#### フラグ -| Flag | Short | Description | +| フラグ | ショート | 説明 | | ------------ | ----------- | ---------------------------------------------------------- | | `--continue` | `-c` | 最後のセッションを続行 | | `--session` | | 続行時にセッションをフォーク (`-s` または `--fork` と併用) | @@ -60,7 +60,7 @@ opencode agent [command] ### attach -`serve` または `web` コマンドを使用して起動された、すでに実行中の OpenCode バックエンド サーバーにterminal を接続します。 +`serve` または `web` コマンドを使用して起動された、すでに実行中の OpenCode バックエンドサーバーにターミナルを接続します。 ```bash opencode attach [url] @@ -76,12 +76,12 @@ opencode web --port 4096 --hostname 0.0.0.0 opencode attach http://10.20.30.40:4096 ``` -#### Flags +#### フラグ -| Flag | Short | Description | -| ----------- | ----- | ------------------------------ | -| `--dir` | | TUI を開始する作業ディレクトリ | -| `--session` | `-s` | 続行するセッション ID | +| フラグ | ショート | 説明 | +| ----------- | -------- | ------------------------------ | +| `--dir` | | TUI を開始する作業ディレクトリ | +| `--session` | `-s` | 続行するセッション ID | --- @@ -93,7 +93,7 @@ opencode attach http://10.20.30.40:4096 opencode agent create ``` -このコマンドは、カスタム システム プロンプトとツール構成を使用して新しいエージェントを作成する手順を示します。 +このコマンドは、カスタムシステムプロンプトとツール構成を使用して新しいエージェントを作成する手順を示します。 --- @@ -119,7 +119,7 @@ opencode auth [command] #### login -OpenCode は [Models.dev](https://models.dev) のプロバイダー リストを利用しているため、`opencode auth login` を使用して、使用したいプロバイダーの API キーを構成できます。これは`~/.local/share/opencode/auth.json`に保存されます。 +OpenCode は [Models.dev](https://models.dev) のプロバイダーリストを利用しているため、`opencode auth login` を使用して、使用したいプロバイダーの API キーを構成できます。これは `~/.local/share/opencode/auth.json` に保存されます。 ```bash opencode auth login @@ -185,18 +185,18 @@ GitHub エージェントを実行します。これは通常、GitHub Actions opencode github run ``` -##### Flags +##### フラグ -| Flag | Description | +| フラグ | 説明 | | --------- | --------------------------------------------------- | | `--event` | エージェントを実行するための GitHub モック イベント | -| `--token` | GitHub個人アクセストークン | +| `--token` | GitHub 個人アクセストークン | --- ### mcp -モデル コンテキスト プロトコル サーバーを管理します。 +モデルコンテキストプロトコルサーバーを管理します。 ```bash opencode mcp [command] @@ -286,7 +286,7 @@ opencode models [provider] このコマンドは、構成されたプロバイダー全体で利用可能なすべてのモデルを `provider/model` の形式で表示します。 -これは、config](/docs/config/) で使用する正確なモデル名を把握するのに役立ちます。 +これは、[設定](/docs/config/) で使用する正確なモデル名を把握するのに役立ちます。 オプションでプロバイダー ID を渡して、そのプロバイダーによってモデルをフィルターできます。 @@ -294,14 +294,14 @@ opencode models [provider] opencode models anthropic ``` -#### Flags +#### フラグ -| Flag | Description | +| フラグ | 説明 | | ----------- | --------------------------------------------------------------- | -| `--refresh` | models.dev からモデル キャッシュを更新します。 | +| `--refresh` | models.dev からモデルキャッシュを更新します。 | | `--verbose` | より詳細なモデル出力を使用します (コストなどのメタデータを含む) | -`--refresh` フラグを使用して、キャッシュされたモデル リストを更新します。これは、新しいモデルがプロバイダーに追加され、それを OpenCode で確認したい場合に便利です。 +`--refresh` フラグを使用して、キャッシュされたモデルリストを更新します。これは、新しいモデルがプロバイダーに追加され、それを OpenCode で確認したい場合に便利です。 ```bash opencode models --refresh @@ -311,7 +311,7 @@ opencode models --refresh ### run -プロンプトを直接渡して、非対話モードでopencodeを実行します。 +プロンプトを直接渡して、非対話モードで opencode を実行します。 ```bash opencode run [message..] @@ -323,7 +323,7 @@ opencode run [message..] opencode run Explain the use of context in Go ``` -実行中の `opencode serve` インスタンスにアタッチして、実行ごとの MCP サーバーのコールド ブート時間を回避することもできます。 +実行中の `opencode serve` インスタンスにアタッチして、実行ごとの MCP サーバーのコールドブート時間を回避することもできます。 ```bash # Start a headless server in one terminal @@ -333,9 +333,9 @@ opencode serve opencode run --attach http://localhost:4096 "Explain async/await in JavaScript" ``` -#### Flags +#### フラグ -| Flag | Short | Description | +| フラグ | ショート | 説明 | | ------------ | ----------- | ----------------------------------------------------------------------------------------- | | `--command` | | 実行するコマンド。引数には message を使用します。 | | `--continue` | `-c` | 最後のセッションを続行 | @@ -347,24 +347,24 @@ opencode run --attach http://localhost:4096 "Explain async/await in JavaScript" | `--file` | `-f` | メッセージに添付するファイル | | `--format` | | 形式: デフォルト (フォーマット済み) または json (生の JSON イベント) | | `--title` | | セッションのタイトル (値が指定されていない場合は、切り詰められたプロンプトが使用されます) | -| `--attach` | | 実行中のopencodeサーバー (http://localhost:4096 など) に接続します。 | +| `--attach` | | 実行中の opencode サーバー (http://localhost:4096 など) に接続します。 | | `--port` | | ローカルサーバーのポート (デフォルトはランダムポート) | --- ### serve -API アクセスのためにヘッドレス OpenCode サーバーを起動します。完全な HTTP インターフェイスについては、[server docs](/docs/server) を確認してください。 +API アクセスのためにヘッドレス OpenCode サーバーを起動します。完全な HTTP インターフェイスについては、[サーバーのドキュメント](/docs/server) を確認してください。 ```bash opencode serve ``` -これにより、TUI インターフェイスを使用せずにopencode機能への API アクセスを提供する HTTP サーバーが起動します。 `OPENCODE_SERVER_PASSWORD` を設定して HTTP 基本認証を有効にします (ユーザー名のデフォルトは `opencode`)。 +これにより、TUI インターフェイスを使用せずに opencode 機能への API アクセスを提供する HTTP サーバーが起動します。 `OPENCODE_SERVER_PASSWORD` を設定して HTTP 基本認証を有効にします (ユーザー名のデフォルトは `opencode`)。 -#### Flags +#### フラグ -| Flag | Description | +| フラグ | 説明 | | ------------ | --------------------------------------- | | `--port` | リッスンするポート | | `--hostname` | リッスンするホスト名 | @@ -391,12 +391,12 @@ opencode session [command] opencode session list ``` -##### Flags +##### フラグ -| Flag | Short | Description | -| ------------- | ----- | ---------------------------------------- | -| `--max-count` | `-n` | 最新のセッションを N 個に制限 | -| `--format` | | 出力形式: テーブルまたは json (テーブル) | +| フラグ | ショート | 説明 | +| ------------- | -------- | ---------------------------------------- | +| `--max-count` | `-n` | 最新のセッションを N 個に制限 | +| `--format` | | 出力形式: テーブルまたは json (テーブル) | --- @@ -408,20 +408,20 @@ OpenCode セッションのトークンの使用状況とコストの統計を opencode stats ``` -#### Flags +#### フラグ -| Flag | Description | -| ----------- | --------------------------------------------------------------------------- | -| `--days` | Show stats for the last N days (all time) | -| `--tools` | Number of tools to show (all) | -| `--models` | Show model usage breakdown (hidden by default). Pass a number to show top N | -| `--project` | Filter by project (all projects, empty string: current project) | +| フラグ | 説明 | +| ----------- | ------------------------------------------------------------------------------------------ | +| `--days` | 過去 N 日間の統計を表示 (全期間) | +| `--tools` | 表示するツールの数 (すべて) | +| `--models` | モデルの使用状況の内訳を表示 (デフォルトでは非表示)。上位 N 件を表示するには数値を渡します | +| `--project` | プロジェクトでフィルタリング (全プロジェクト、空文字列: 現在のプロジェクト) | --- ### export -セッションデータをJSONとしてエクスポートします。 +セッションデータを JSON としてエクスポートします。 ```bash opencode export [sessionID] @@ -433,13 +433,13 @@ opencode export [sessionID] ### import -JSON ファイルまたは OpenCode 共有 URL からセッション データをインポートします。 +JSON ファイルまたは OpenCode 共有 URL からセッションデータをインポートします。 ```bash opencode import ``` -ローカル ファイルまたは OpenCode 共有 URL からインポートできます。 +ローカルファイルまたは OpenCode 共有 URL からインポートできます。 ```bash opencode import session.json @@ -458,9 +458,9 @@ opencode web これにより、HTTP サーバーが起動し、Web ブラウザが開き、Web インターフェイスを通じて OpenCode にアクセスします。 `OPENCODE_SERVER_PASSWORD` を設定して HTTP 基本認証を有効にします (ユーザー名のデフォルトは `opencode`)。 -#### Flags +#### フラグ -| Flag | Description | +| フラグ | 説明 | | ------------ | --------------------------------------- | | `--port` | リッスンするポート | | `--hostname` | リッスンするホスト名 | @@ -471,7 +471,7 @@ opencode web ### acp -ACP (エージェント クライアント プロトコル) サーバーを起動します。 +ACP (エージェントクライアントプロトコル) サーバーを起動します。 ```bash opencode acp @@ -479,9 +479,9 @@ opencode acp このコマンドは、nd-JSON を使用して stdin/stdout 経由で通信する ACP サーバーを起動します。 -#### Flags +#### フラグ -| Flag | Description | +| フラグ | 説明 | | ------------ | -------------------- | | `--cwd` | 作業ディレクトリ | | `--port` | リッスンするポート | @@ -497,20 +497,20 @@ OpenCode をアンインストールし、関連ファイルをすべて削除 opencode uninstall ``` -#### Flags +#### フラグ -| Flag | Short | Description | -| --------------- | ----- | ------------------------------------------- | -| `--keep-config` | `-c` | Keep configuration files | -| `--keep-data` | `-d` | Keep session data and snapshots | -| `--dry-run` | | Show what would be removed without removing | -| `--force` | `-f` | Skip confirmation prompts | +| フラグ | ショート | 説明 | +| --------------- | -------- | -------------------------------------------- | +| `--keep-config` | `-c` | 構成ファイルを保持する | +| `--keep-data` | `-d` | セッションデータとスナップショットを保持する | +| `--dry-run` | | 削除せずに削除される内容を表示する | +| `--force` | `-f` | 確認プロンプトをスキップする | --- ### upgrade -opencodeを最新バージョンまたは特定のバージョンに更新します。 +opencode を最新バージョンまたは特定のバージョンに更新します。 ```bash opencode upgrade [target] @@ -528,24 +528,24 @@ opencode upgrade opencode upgrade v0.1.48 ``` -#### Flags +#### フラグ -| Flag | Short | Description | -| ---------- | ----- | ------------------------------------------------------ | -| `--method` | `-m` | 使用されたインストール方法。curl, npm, pnpm, bun, brew | +| フラグ | ショート | 説明 | +| ---------- | -------- | ------------------------------------------------------ | +| `--method` | `-m` | 使用されたインストール方法。curl, npm, pnpm, bun, brew | --- -## Global Flags +## グローバルフラグ -opencode CLI は次のグローバル フラグを受け取ります。 +opencode CLI は次のグローバルフラグを受け取ります。 -| Flag | Short | Description | -| -------------- | ----- | -------------------------------------- | -| `--help` | `-h` | ヘルプを表示 | -| `--version` | `-v` | バージョン番号を出力 | -| `--print-logs` | | ログを標準エラー出力に出力 | -| `--log-level` | | ログ レベル (DEBUG、INFO、WARN、ERROR) | +| フラグ | ショート | 説明 | +| -------------- | -------- | ------------------------------------- | +| `--help` | `-h` | ヘルプを表示 | +| `--version` | `-v` | バージョン番号を出力 | +| `--print-logs` | | ログを標準エラー出力に出力 | +| `--log-level` | | ログレベル (DEBUG、INFO、WARN、ERROR) | --- @@ -562,7 +562,7 @@ OpenCode は環境変数を使用して構成できます。 | `OPENCODE_CONFIG_CONTENT` | 文字列 | インライン JSON 構成コンテンツ | | `OPENCODE_DISABLE_AUTOUPDATE` | ブール値 | 自動更新チェックを無効にする | | `OPENCODE_DISABLE_PRUNE` | ブール値 | 古いデータのプルーニングを無効にする | -| `OPENCODE_DISABLE_TERMINAL_TITLE` | ブール値 | terminal titleの自動更新を無効にする | +| `OPENCODE_DISABLE_TERMINAL_TITLE` | ブール値 | ターミナルタイトルの自動更新を無効にする | | `OPENCODE_PERMISSION` | 文字列 | インライン化された json 権限設定 | | `OPENCODE_DISABLE_DEFAULT_PLUGINS` | ブール値 | デフォルトのプラグインを無効にする | | `OPENCODE_DISABLE_LSP_DOWNLOAD` | ブール値 | LSP サーバーの自動ダウンロードを無効にする | @@ -571,7 +571,7 @@ OpenCode は環境変数を使用して構成できます。 | `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_DISABLE_MODELS_FETCH` | ブール値 | リモートソースからのモデルの取得を無効にする | | `OPENCODE_FAKE_VCS` | 文字列 | テスト目的の偽の VCS プロバイダー | | `OPENCODE_DISABLE_FILETIME_CHECK` | ブール値 | 最適化のためにファイル時間チェックを無効にする | | `OPENCODE_CLIENT` | 文字列 | クライアント識別子 (デフォルトは `cli`) | @@ -591,13 +591,13 @@ OpenCode は環境変数を使用して構成できます。 | `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 応答の最大Output Tokens | +| `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_LSP_TY` | ブール値 | 実験的な LSP タイプチェックを有効にする | +| `OPENCODE_EXPERIMENTAL_MARKDOWN` | ブール値 | 試験的な Markdown 機能を有効にする | | `OPENCODE_EXPERIMENTAL_PLAN_MODE` | ブール値 | プランモードを有効にする | diff --git a/packages/web/src/content/docs/ja/commands.mdx b/packages/web/src/content/docs/ja/commands.mdx index 1fe9f2f2b..bd2913a04 100644 --- a/packages/web/src/content/docs/ja/commands.mdx +++ b/packages/web/src/content/docs/ja/commands.mdx @@ -1,21 +1,21 @@ --- title: コマンド -description: 反復的なタスク用のカスタム コマンドを作成します。 +description: 反復的なタスク用のカスタムコマンドを作成します。 --- -カスタム コマンドを使用すると、TUI でコマンドを実行するときに実行するプロンプトを指定できます。 +カスタムコマンドを使用すると、TUI でコマンドを実行するときに実行するプロンプトを指定できます。 ```bash frame="none" /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` を作成します。 @@ -40,15 +40,15 @@ Focus on the failing tests and suggest fixes. --- -## 設定する +## 設定 -カスタム コマンドは、OpenCode 構成を通じて、または `commands/` ディレクトリにMarkdown ファイルを作成することによって追加できます。 +カスタムコマンドは、OpenCode 設定を通じて、または `commands/` ディレクトリに Markdown ファイルを作成することによって追加できます。 --- ### JSON -OpenCode で `command` オプションを使用します [config](/docs/config): +OpenCode [設定](/docs/config)で `command` オプションを使用します: ```json title="opencode.jsonc" {4-12} { @@ -104,7 +104,7 @@ Markdown ファイル名がコマンド名になります。たとえば、`test ## プロンプト構成 -カスタム コマンドのプロンプトは、いくつかの特別なプレースホルダーと構文をサポートしています。 +カスタムコマンドのプロンプトは、いくつかの特別なプレースホルダーと構文をサポートしています。 --- @@ -161,11 +161,11 @@ with the following content: $3 --- -### Shell 出力 +### シェル出力 -_!`command`_ を使用して、[bash command](/docs/tui#bash-commands) の出力をプロンプトに挿入します。 +_!`command`_ を使用して、[bash コマンド](/docs/tui#bash-commands) の出力をプロンプトに挿入します。 -たとえば、テスト カバレッジを分析するカスタム コマンドを作成するには、次のようにします。 +たとえば、テストカバレッジを分析するカスタムコマンドを作成するには、次のようにします。 ```md title=".opencode/commands/analyze-coverage.md" --- @@ -191,7 +191,7 @@ Recent git commits: Review these changes and suggest any improvements. ``` -コマンドはプロジェクトのルート ディレクトリで実行され、その出力はプロンプトの一部になります。 +コマンドはプロジェクトのルートディレクトリで実行され、その出力はプロンプトの一部になります。 --- @@ -214,7 +214,7 @@ Check for performance issues and suggest improvements. ## オプション -構成オプションを詳しく見てみましょう。 +設定オプションを詳しく見てみましょう。 --- @@ -232,7 +232,7 @@ Check for performance issues and suggest improvements. } ``` -これは**必須**の構成オプションです。 +これは**必須**の設定オプションです。 --- @@ -270,14 +270,14 @@ Check for performance issues and suggest improvements. } ``` -これは**オプション**の構成オプションです。指定しない場合、デフォルトで現在のエージェントが使用されます。 +これは**オプション**の設定オプションです。指定しない場合、デフォルトで現在のエージェントが使用されます。 --- ### サブタスク `subtask` ブール値を使用して、コマンドが [subagent](/docs/agents/#subagents) 呼び出しを強制的にトリガーします。 -これは、コマンドがプライマリ コンテキストを汚染せず、エージェントがサブエージェントとして動作するように**強制**する場合に便利です。 +これは、コマンドがプライマリコンテキストを汚染せず、エージェントがサブエージェントとして動作するように**強制**する場合に便利です。 [agent](/docs/agents) 設定で `mode` が `primary` に設定されている場合でも。 ```json title="opencode.json" @@ -290,13 +290,13 @@ Check for performance issues and suggest improvements. } ``` -これは**オプション**の構成オプションです。 +これは**オプション**の設定オプションです。 --- ### モデル -`model` 設定を使用して、このコマンドのデフォルト モデルをオーバーライドします。 +`model` 設定を使用して、このコマンドのデフォルトモデルをオーバーライドします。 ```json title="opencode.json" { @@ -308,15 +308,15 @@ 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/ja/config.mdx b/packages/web/src/content/docs/ja/config.mdx index 9e840bdfa..114336d43 100644 --- a/packages/web/src/content/docs/ja/config.mdx +++ b/packages/web/src/content/docs/ja/config.mdx @@ -1,9 +1,9 @@ --- -title: 構成 -description: OpenCode JSON 構成を使用します。 +title: 設定 +description: OpenCode JSON 設定を使用します。 --- -JSON 構成ファイルを使用して OpenCode を構成できます。 +JSON 設定ファイルを使用して OpenCode を構成できます。 --- @@ -23,15 +23,14 @@ OpenCode は、**JSON** と **JSONC** (コメント付きの JSON) 形式の両 --- -## 所在地 +## ファイルの場所 -構成をいくつかの異なる場所に配置できます。 -優先順位が違う。 +設定をいくつかの異なる場所に配置できます。 +優先順位が異なります。 :::note -構成ファイルは置き換えられるのではなく、**マージ**されます。 +設定ファイルは置き換えられるのではなく、**マージ**されます。設定は、次の構成場所から結合されます。後続の設定は、競合するキーに対してのみ以前の設定をオーバーライドします。すべての設定の競合しない設定は保持されます。 ::: -構成ファイルは、置き換えられるのではなく、マージされます。設定は、次の構成場所から結合されます。後続の構成は、競合するキーに対してのみ以前の構成をオーバーライドします。すべての構成の競合しない設定は保持されます。 たとえば、グローバル設定で `theme: "opencode"` と `autoupdate: true` が設定され、プロジェクト設定で `model: "anthropic/claude-sonnet-4-5"` が設定されている場合、最終的な設定には 3 つの設定がすべて含まれます。 @@ -39,16 +38,16 @@ OpenCode は、**JSON** と **JSONC** (コメント付きの JSON) 形式の両 ### 優先順位 -構成ソースは次の順序でロードされます (後のソースは前のソースをオーバーライドします)。 +設定ソースは次の順序でロードされます (後のソースは前のソースをオーバーライドします)。 1. **リモート設定** (`.well-known/opencode` から) - 組織のデフォルト 2. **グローバル設定** (`~/.config/opencode/opencode.json`) - ユーザー設定 -3. **カスタム構成** (`OPENCODE_CONFIG` 環境変数) - カスタム オーバーライド -4. **プロジェクト構成** (プロジェクト内の`opencode.json`) - プロジェクト固有の設定 +3. **カスタム設定** (`OPENCODE_CONFIG` 環境変数) - カスタムオーバーライド +4. **プロジェクト設定** (プロジェクト内の `opencode.json`) - プロジェクト固有の設定 5. **`.opencode` ディレクトリ** - エージェント、コマンド、プラグイン -6. **インライン構成** (`OPENCODE_CONFIG_CONTENT` 環境変数) - ランタイムオーバーライド +6. **インライン設定** (`OPENCODE_CONFIG_CONTENT` 環境変数) - ランタイムオーバーライド -つまり、プロジェクト構成はグローバルのデフォルトをオーバーライドでき、グローバル構成はリモート組織のデフォルトをオーバーライドできます。 +つまり、プロジェクト設定はグローバルのデフォルトをオーバーライドでき、グローバル設定はリモート組織のデフォルトをオーバーライドできます。 :::note `.opencode` および `~/.config/opencode` ディレクトリでは、サブディレクトリに **複数名** が使用されています: `agents/`、`commands/`、`modes/`、`plugins/`、`skills/`、`tools/`、および `themes/`。下位互換性のために、単数形の名前 (`agent/` など) もサポートされています。 @@ -58,9 +57,9 @@ OpenCode は、**JSON** と **JSONC** (コメント付きの JSON) 形式の両 ### リモート -組織は、`.well-known/opencode` エンドポイント経由でデフォルト構成を提供できます。これは、それをサポートするプロバイダーで認証するときに自動的に取得されます。 +組織は、`.well-known/opencode` エンドポイント経由でデフォルト設定を提供できます。これは、それをサポートするプロバイダーで認証するときに自動的に取得されます。 -リモート設定が最初にロードされ、基本層として機能します。他のすべての構成ソース (グローバル、プロジェクト) は、これらのデフォルトをオーバーライドできます。 +リモート設定が最初にロードされ、基本層として機能します。他のすべての設定ソース (グローバル、プロジェクト) は、これらのデフォルトをオーバーライドできます。 たとえば、組織がデフォルトで無効になっている MCP サーバーを提供している場合: @@ -94,7 +93,7 @@ OpenCode は、**JSON** と **JSONC** (コメント付きの JSON) 形式の両 ### グローバル -グローバル OpenCode 構成を `~/.config/opencode/opencode.json` に配置します。テーマ、プロバイダー、キーバインドなどのユーザー全体の設定にはグローバル設定を使用します。 +グローバル OpenCode 設定を `~/.config/opencode/opencode.json` に配置します。テーマ、プロバイダー、キーバインドなどのユーザー全体の設定にはグローバル設定を使用します。 グローバル設定はリモート組織のデフォルトをオーバーライドします。 @@ -102,33 +101,34 @@ OpenCode は、**JSON** と **JSONC** (コメント付きの JSON) 形式の両 ### プロジェクトごと -プロジェクトのルートに `opencode.json` を追加します。プロジェクト構成は、標準構成ファイルの中で最も高い優先順位を持ち、グローバル構成とリモート構成の両方をオーバーライドします。 +プロジェクトのルートに `opencode.json` を追加します。プロジェクト設定は、標準設定ファイルの中で最も高い優先順位を持ち、グローバル設定とリモート設定の両方をオーバーライドします。 :::tip -プロジェクト固有の構成をプロジェクトのルートに配置します。 +プロジェクト固有の設定をプロジェクトのルートに配置します。 ::: -OpenCode が起動すると、現在のディレクトリで構成ファイルを検索するか、最も近い Git ディレクトリまで移動します。 -これは Git に安全にチェックインでき、グローバル スキーマと同じスキーマを使用します。 +OpenCode が起動すると、現在のディレクトリで設定ファイルを検索するか、最も近い Git ディレクトリまで移動します。 + +これは Git に安全にチェックインでき、グローバルスキーマと同じスキーマを使用します。 --- ### カスタムパス -`OPENCODE_CONFIG` 環境変数を使用してカスタム構成ファイルのパスを指定します。 +`OPENCODE_CONFIG` 環境変数を使用してカスタム設定ファイルのパスを指定します。 ```bash export OPENCODE_CONFIG=/path/to/my/custom-config.json opencode run "Hello world" ``` -カスタム構成は、優先順位でグローバル構成とプロジェクト構成の間にロードされます。 +カスタム設定は、優先順位でグローバル設定とプロジェクト設定の間にロードされます。 --- ### カスタムディレクトリ -`OPENCODE_CONFIG_DIR` を使用してカスタム構成ディレクトリを指定します。 +`OPENCODE_CONFIG_DIR` を使用してカスタム設定ディレクトリを指定します。 環境変数。このディレクトリでは、エージェント、コマンド、 モードとプラグインは標準の `.opencode` ディレクトリと同様であり、次のようにする必要があります。 同じ構造に従います。 @@ -138,13 +138,13 @@ export OPENCODE_CONFIG_DIR=/path/to/my/config-directory opencode run "Hello world" ``` -カスタム ディレクトリはグローバル config ディレクトリと `.opencode` ディレクトリの後にロードされるため、それらの設定を**オーバーライド**できます。 +カスタムディレクトリはグローバル config ディレクトリと `.opencode` ディレクトリの後にロードされるため、それらの設定を**オーバーライド**できます。 --- ## スキーマ -構成ファイルには、[**`opencode.ai/config.json`**](https://opencode.ai/config.json). +設定ファイルには、[**`opencode.ai/config.json`**](https://opencode.ai/config.json) を使用します。 エディターはスキーマに基づいて検証し、オートコンプリートできる必要があります。 @@ -169,15 +169,15 @@ opencode run "Hello world" 利用可能なオプション: -- `scroll_acceleration.enabled` - macOS スタイルのスクロール アクセラレーションを有効にします。 **`scroll_speed` よりも優先されます。** +- `scroll_acceleration.enabled` - macOS スタイルのスクロールアクセラレーションを有効にします。 **`scroll_speed` よりも優先されます。** - `scroll_speed` - カスタムのスクロール速度乗数 (デフォルト: `3`、最小: `1`)。 `scroll_acceleration.enabled` が `true` の場合は無視されます。 -- `diff_style` - 差分レンダリングを制御します。 `"auto"` はterminal の幅に適応し、`"stacked"` は常に 1 列を表示します。 +- `diff_style` - 差分レンダリングを制御します。 `"auto"` はターミナルの幅に適応し、`"stacked"` は常に 1 列を表示します。 [TUI の使用方法の詳細については、こちら](/docs/tui) をご覧ください。 --- -### サーバ +### サーバー `opencode serve` オプションを使用して、`opencode web` および `server` コマンドのサーバー設定を構成できます。 @@ -199,7 +199,7 @@ opencode run "Hello world" - `port` - リッスンするポート。 - `hostname` - リッスンするホスト名。 `mdns` が有効でホスト名が設定されていない場合、デフォルトは `0.0.0.0` になります。 - `mdns` - mDNS サービス検出を有効にします。これにより、ネットワーク上の他のデバイスが OpenCode サーバーを検出できるようになります。 -- `mdnsDomain` - mDNS サービスのカスタム ドメイン名。デフォルトは `opencode.local` です。同じネットワーク上で複数のインスタンスを実行する場合に便利です。 +- `mdnsDomain` - mDNS サービスのカスタムドメイン名。デフォルトは `opencode.local` です。同じネットワーク上で複数のインスタンスを実行する場合に便利です。 - `cors` - ブラウザベースのクライアントから HTTP サーバーを使用するときに CORS を許可する追加のオリジン。値は完全なオリジン (スキーム + ホスト + オプションのポート) である必要があります (例: `https://app.example.com`)。 [サーバーの詳細については、こちら](/docs/server)をご覧ください。 @@ -226,7 +226,7 @@ LLM が使用できるツールは、`tools` オプションを通じて管理 ### モデル -`provider`、`model`、および `small_model` オプションを使用して、OpenCode 構成で使用するプロバイダーとモデルを構成できます。 +`provider`、`model`、および `small_model` オプションを使用して、OpenCode 設定で使用するプロバイダーとモデルを構成できます。 ```json title="opencode.json" { @@ -237,9 +237,9 @@ LLM が使用できるツールは、`tools` オプションを通じて管理 } ``` -`small_model` オプションは、タイトル生成などの軽量タスク用に別のモデルを構成します。デフォルトでは、OpenCode は、プロバイダーから安価なモデルが入手可能な場合は、より安価なモデルを使用しようとします。そうでない場合は、メイン モデルにフォールバックします。 +`small_model` オプションは、タイトル生成などの軽量タスク用に別のモデルを構成します。デフォルトでは、OpenCode は、プロバイダーから安価なモデルが入手可能な場合は、より安価なモデルを使用しようとします。そうでない場合は、メインモデルにフォールバックします。 -プロバイダー オプションには、`timeout` および `setCacheKey` を含めることができます。 +プロバイダーオプションには、`timeout` および `setCacheKey` を含めることができます。 ```json title="opencode.json" { @@ -256,7 +256,7 @@ LLM が使用できるツールは、`tools` オプションを通じて管理 ``` - `timeout` - リクエストのタイムアウト (ミリ秒単位) (デフォルト: 300000)。無効にするには、`false` に設定します。 -- `setCacheKey` - 指定されたプロバイダーに対してキャッシュ キーが常に設定されていることを確認します。 +- `setCacheKey` - 指定されたプロバイダーに対してキャッシュキーが常に設定されていることを確認します。 [ローカルモデル](/docs/models#local). [詳細はこちら](/docs/models)。 @@ -268,7 +268,7 @@ LLM が使用できるツールは、`tools` オプションを通じて管理 ##### Amazon Bedrock -Amazon Bedrock は、AWS 固有の構成をサポートしています。 +Amazon Bedrock は、AWS 固有の設定をサポートしています。 ```json title="opencode.json" { @@ -287,19 +287,19 @@ Amazon Bedrock は、AWS 固有の構成をサポートしています。 - `region` - Bedrock の AWS リージョン (デフォルトは `AWS_REGION` 環境変数または `us-east-1`) - `profile` - `~/.aws/credentials` からの AWS 名前付きプロファイル (デフォルトは `AWS_PROFILE` 環境変数) -- `endpoint` - VPC エンドポイントのカスタム エンドポイント URL。これは、AWS 固有の用語を使用した汎用 `baseURL` オプションのエイリアスです。両方を指定した場合は、`endpoint` が優先されます。 +- `endpoint` - VPC エンドポイントのカスタムエンドポイント URL。これは、AWS 固有の用語を使用した汎用 `baseURL` オプションのエイリアスです。両方を指定した場合は、`endpoint` が優先されます。 :::note ベアラー トークン (`AWS_BEARER_TOKEN_BEDROCK` または `/connect`) は、プロファイルベースの認証より優先されます。詳細については、「認証優先順位](/docs/providers#authentication-precedence)」を参照してください。 ::: -[Amazon Bedrock 構成 ](/docs/providers#amazon-bedrock) の詳細をご覧ください。 +[Amazon Bedrock 設定 ](/docs/providers#amazon-bedrock) の詳細をご覧ください。 --- ### テーマ -`theme` オプションを使用して、OpenCode 構成で使用するテーマを構成できます。 +`theme` オプションを使用して、OpenCode 設定で使用するテーマを構成できます。 ```json title="opencode.json" { @@ -334,7 +334,7 @@ Amazon Bedrock は、AWS 固有の構成をサポートしています。 } ``` -`~/.config/opencode/agents/` または `.opencode/agents/` のMarkdown ファイルを使用してエージェントを定義することもできます。 [詳細はこちら](/docs/agents)。 +`~/.config/opencode/agents/` または `.opencode/agents/` の Markdown ファイルを使用してエージェントを定義することもできます。 [詳細はこちら](/docs/agents)。 --- @@ -349,9 +349,9 @@ Amazon Bedrock は、AWS 固有の構成をサポートしています。 } ``` -デフォルトのエージェントはプライマリ エージェントである必要があります (サブエージェントではありません)。これは、`"build"` や `"plan"` のような組み込みエージェント、または定義したカスタム Agent](/docs/agents) にすることができます。指定されたエージェントが存在しないか、サブエージェントである場合、OpenCode は警告とともに `"build"` にフォールバックします。 +デフォルトのエージェントはプライマリエージェントである必要があります (サブエージェントではありません)。これは、`"build"` や `"plan"` のような組み込みエージェント、または定義した[カスタムエージェント](/docs/agents) にすることができます。指定されたエージェントが存在しないか、サブエージェントである場合、OpenCode は警告とともに `"build"` にフォールバックします。 -この設定は、TUI、CLI (`opencode run`)、デスクトップ アプリ、および GitHub Action のすべてのインターフェイスに適用されます。 +この設定は、TUI、CLI (`opencode run`)、デスクトップアプリ、および GitHub Action のすべてのインターフェイスに適用されます。 --- @@ -378,7 +378,7 @@ Amazon Bedrock は、AWS 固有の構成をサポートしています。 ### コマンド -`command` オプションを使用して、反復タスク用のカスタム コマンドを構成できます。 +`command` オプションを使用して、反復タスク用のカスタムコマンドを構成できます。 ```jsonc title="opencode.jsonc" { @@ -398,7 +398,7 @@ Amazon Bedrock は、AWS 固有の構成をサポートしています。 } ``` -`~/.config/opencode/commands/` または `.opencode/commands/` のMarkdown ファイルを使用してコマンドを定義することもできます。 [詳細はこちら](/docs/commands)。 +`~/.config/opencode/commands/` または `.opencode/commands/` の Markdown ファイルを使用してコマンドを定義することもできます。 [詳細はこちら](/docs/commands)。 --- @@ -429,13 +429,13 @@ OpenCode は起動時に新しいアップデートを自動的にダウンロ ``` 更新は必要ないが、新しいバージョンが利用可能になったときに通知を受け取りたい場合は、`autoupdate` を `"notify"` に設定します。 -これは、Homebrew などのパッケージ マネージャーを使用してインストールされていない場合にのみ機能することに注意してください。 +これは、Homebrew などのパッケージマネージャーを使用してインストールされていない場合にのみ機能することに注意してください。 --- ### フォーマッタ -`formatter` オプションを使用してコード フォーマッタを設定できます。 +`formatter` オプションを使用してコードフォーマッタを設定できます。 ```json title="opencode.json" { @@ -500,7 +500,7 @@ OpenCode は起動時に新しいアップデートを自動的にダウンロ ### ウォッチャー -`watcher` オプションを使用して、ファイル ウォッチャーの無視パターンを構成できます。 +`watcher` オプションを使用して、ファイルウォッチャーの無視パターンを構成できます。 ```json title="opencode.json" { @@ -532,9 +532,9 @@ OpenCode は起動時に新しいアップデートを自動的にダウンロ ### プラグイン -[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" { @@ -547,9 +547,9 @@ OpenCode は起動時に新しいアップデートを自動的にダウンロ --- -### 説明書 +### 指示 -`instructions` オプションを使用して、使用しているモデルの命令を構成できます。 +`instructions` オプションを使用して、使用しているモデルの指示を構成できます。 ```json title="opencode.json" { @@ -558,8 +558,7 @@ OpenCode は起動時に新しいアップデートを自動的にダウンロ } ``` -これは、命令ファイルへのパスとグロブ パターンの配列を受け取ります。 [もっと詳しく知る -ルールについてはこちら](/docs/rules)。 +これは、指示ファイルへのパスとグロブパターンの配列を受け取ります。 [ルールについて詳しくはこちら](/docs/rules)。 --- @@ -624,7 +623,7 @@ OpenCode は起動時に新しいアップデートを自動的にダウンロ ## 変数 -構成ファイル内で変数置換を使用して、環境変数とファイルの内容を参照できます。 +設定ファイル内で変数置換を使用して、環境変数とファイルの内容を参照できます。 --- @@ -669,7 +668,7 @@ OpenCode は起動時に新しいアップデートを自動的にダウンロ } ``` -ファイル パスは次のとおりです。 +ファイルパスは次のとおりです。 - 設定ファイルのディレクトリからの相対パス - または、`/` または `~` で始まる絶対パス @@ -677,5 +676,5 @@ OpenCode は起動時に新しいアップデートを自動的にダウンロ これらは次の場合に役立ちます。 - API キーなどの機密データを別のファイルに保存します。 -- 構成を乱雑にすることなく、大きな命令ファイルを含めることができます。 -- 複数の構成ファイル間で共通の構成スニペットを共有します。 +- 設定を乱雑にすることなく、大きな指示ファイルを含めることができます。 +- 複数の設定ファイル間で共通の設定スニペットを共有します。 diff --git a/packages/web/src/content/docs/ja/custom-tools.mdx b/packages/web/src/content/docs/ja/custom-tools.mdx index 9b6dbdd6b..badf50c62 100644 --- a/packages/web/src/content/docs/ja/custom-tools.mdx +++ b/packages/web/src/content/docs/ja/custom-tools.mdx @@ -1,9 +1,9 @@ --- title: カスタムツール -description: LLM がopencodeで呼び出すことができるツールを作成します。 +description: LLM が OpenCode で呼び出すことができるツールを作成します。 --- -カスタム ツールは、会話中に LLM が呼び出すことができる作成した関数です。これらは、opencode の[組み込みツール](/docs/tools) (`read`、`write`、`bash` など) と連携して動作します。 +カスタムツールは、会話中に LLM が呼び出すことができる作成した関数です。これらは、OpenCode の[組み込みツール](/docs/tools) (`read`、`write`、`bash` など) と連携して動作します。 --- @@ -13,7 +13,7 @@ description: LLM がopencodeで呼び出すことができるツールを作成 --- -### 位置 +### 場所 それらは次のように定義できます。 @@ -24,7 +24,7 @@ description: LLM がopencodeで呼び出すことができるツールを作成 ### 構造 -ツールを作成する最も簡単な方法は、タイプ セーフティと検証を提供する `tool()` ヘルパーを使用することです。 +ツールを作成する最も簡単な方法は、型安全性と検証を提供する `tool()` ヘルパーを使用することです。 ```ts title=".opencode/tools/database.ts" {1} import { tool } from "@opencode-ai/plugin" @@ -89,7 +89,7 @@ args: { } ``` -[Zod](https://zod.dev) を直接インポートしてプレーン オブジェクトを返すこともできます。 +[Zod](https://zod.dev) を直接インポートしてプレーンオブジェクトを返すこともできます。 ```ts {6} import { z } from "zod" @@ -108,7 +108,7 @@ export default { --- -### Context +### コンテキスト ツールは現在のセッションに関するコンテキストを受け取ります。 @@ -126,14 +126,14 @@ export default tool({ }) ``` -セッション作業ディレクトリには `context.directory` を使用します。 -git ワークツリー ルートには `context.worktree` を使用します。 +セッションの作業ディレクトリには `context.directory` を使用します。 +git ワークツリーのルートには `context.worktree` を使用します。 --- ## 例 -### Python でツールを作成する +### Python でのツールの作成 ツールは任意の言語で作成できます。以下は、Python を使用して 2 つの数値を加算する例です。 diff --git a/packages/web/src/content/docs/ja/ecosystem.mdx b/packages/web/src/content/docs/ja/ecosystem.mdx index f3e2fa132..479fdfbdc 100644 --- a/packages/web/src/content/docs/ja/ecosystem.mdx +++ b/packages/web/src/content/docs/ja/ecosystem.mdx @@ -3,10 +3,10 @@ title: エコシステム description: OpenCode で構築されたプロジェクトと統合。 --- -OpenCode に基づいて構築されたコミュニティ プロジェクトのコレクション。 +OpenCode に基づいて構築されたコミュニティプロジェクトのコレクション。 :::note -OpenCode 関連プロジェクトをこのリストに追加したいですか? PRを送信してください。 +OpenCode 関連プロジェクトをこのリストに追加したいですか? PR を送信してください。 ::: [awesome-opencode](https://github.com/awesome-opencode/awesome-opencode) および [opencode.cafe](https://opencode.cafe) もチェックしてください。 @@ -14,38 +14,38 @@ OpenCode 関連プロジェクトをこのリストに追加したいですか? ## プラグイン -| 名前 | 説明 | -| --------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | -| [opencode-daytona](https://github.com/jamesmurdza/daytona/blob/main/guides/typescript/opencode/README.md) | git sync とライブ プレビューを使用して、隔離された Daytona サンドボックスで OpenCode セッションを自動的に実行します。 | -| [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) | API クレジットの代わりに ChatGPT Plus/Pro サブスクリプションを使用する | -| [opencode-gemini-auth](https://github.com/jenslys/opencode-gemini-auth) | API 課金の代わりに既存の Gemini プランを使用する | -| [opencode-antigravity-auth](https://github.com/NoeFabris/opencode-antigravity-auth) | API 課金の代わりに Antigravity の無料モデルを使用する | -| [opencode-devcontainers](https://github.com/athal7/opencode-devcontainers) | 浅いクローンと自動割り当てポートを使用したマルチブランチ devcontainer の分離 | -| [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 ベースのスタイルでサポートされているプロバイダーにネイティブ Web 検索サポートを追加 | -| [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 によって生成された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) | スーパーメモリを使用したセッション間での永続メモリ | -| [@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) | launchd (Mac) または systemd (Linux) を cron 構文で使用して、定期的なジョブをスケジュールする | -| [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 のネイティブ OS 通知 – タスクがいつ完了したかを知る | -| [opencode-workspace](https://github.com/kdcokenny/opencode-workspace) | バンドルされたマルチエージェント オーケストレーション ハーネス – 16 コンポーネント、1 回のインストール | -| [opencode-worktree](https://github.com/kdcokenny/opencode-worktree) | OpenCode 用のゼロフリクション Git ワークツリー | +| 名前 | 説明 | +| --------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | +| [opencode-daytona](https://github.com/jamesmurdza/daytona/blob/main/guides/typescript/opencode/README.md) | git sync とライブプレビューを使用して、隔離された Daytona サンドボックスで OpenCode セッションを自動的に実行します。 | +| [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) | API クレジットの代わりに ChatGPT Plus/Pro サブスクリプションを使用する | +| [opencode-gemini-auth](https://github.com/jenslys/opencode-gemini-auth) | API 課金の代わりに既存の Gemini プランを使用する | +| [opencode-antigravity-auth](https://github.com/NoeFabris/opencode-antigravity-auth) | API 課金の代わりに Antigravity の無料モデルを使用する | +| [opencode-devcontainers](https://github.com/athal7/opencode-devcontainers) | 浅いクローンと自動割り当てポートを使用したマルチブランチ devcontainer の分離 | +| [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 ベースのスタイルでサポートされているプロバイダーにネイティブ Web 検索サポートを追加 | +| [opencode-pty](https://github.com/shekohex/opencode-pty.git) | AI エージェントが PTY でバックグラウンドプロセスを実行し、インタラクティブな入力を送信できるようにします。 | +| [opencode-shell-strategy](https://github.com/JRedeker/opencode-shell-strategy) | 非対話型シェルコマンドの手順 - 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 によって生成された 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) | スーパーメモリを使用したセッション間での永続メモリ | +| [@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) | launchd (Mac) または systemd (Linux) を cron 構文で使用して、定期的なジョブをスケジュールする | +| [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 のネイティブ OS 通知 – タスクがいつ完了したかを知る | +| [opencode-workspace](https://github.com/kdcokenny/opencode-workspace) | バンドルされたマルチエージェントオーケストレーションハーネス – 16 コンポーネント、1 回のインストール | +| [opencode-worktree](https://github.com/kdcokenny/opencode-worktree) | OpenCode 用のゼロフリクション Git ワークツリー | --- @@ -57,13 +57,13 @@ OpenCode 関連プロジェクトをこのリストに追加したいですか? | [opencode.nvim](https://github.com/NickvanDyke/opencode.nvim) | API に基づいて構築された、エディター対応プロンプト用の Neovim プラグイン | | [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用フロントエンド - terminal ベースの AI コーディング エージェント | +| [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) | @opencode-ai/sdk 経由で OpenCode を使用するための Vercel AI SDK プロバイダー | -| [OpenChamber](https://github.com/btriapitsyn/openchamber) | OpenCode 用の Web/デスクトップ アプリと VS Code 拡張機能 | +| [OpenChamber](https://github.com/btriapitsyn/openchamber) | OpenCode 用の Web/デスクトップアプリと VS Code 拡張機能 | | [OpenCode-Obsidian](https://github.com/mtymek/opencode-obsidian) | Obsidian の UI に OpenCode を埋め込む Obsidian プラグイン | | [OpenWork](https://github.com/different-ai/openwork) | OpenCode を利用した、Claude Cowork に代わるオープンソース | | [ocx](https://github.com/kdcokenny/ocx) | 移植可能な独立したプロファイルを備えた OpenCode 拡張機能マネージャー。 | -| [CodeNomad](https://github.com/NeuralNomadsAI/CodeNomad) | OpenCode 用のデスクトップ、Web、モバイル、およびリモート クライアント アプリ | +| [CodeNomad](https://github.com/NeuralNomadsAI/CodeNomad) | OpenCode 用のデスクトップ、Web、モバイル、およびリモートクライアントアプリ | --- diff --git a/packages/web/src/content/docs/ja/enterprise.mdx b/packages/web/src/content/docs/ja/enterprise.mdx index fdd9e1e1c..d5144072f 100644 --- a/packages/web/src/content/docs/ja/enterprise.mdx +++ b/packages/web/src/content/docs/ja/enterprise.mdx @@ -1,15 +1,15 @@ --- -title: Enterprise +title: エンタープライズ description: 組織内で OpenCode を安全に使用します。 --- import config from "../../../../config.mjs" export const email = `mailto:${config.email}` -OpenCode Enterprise は、コードとデータがインフラストラクチャから決して流出しないようにしたい組織を対象としています。これは、SSO および内部 AI ゲートウェイと統合された一元化された構成を使用することで実現できます。 +OpenCode Enterprise は、コードとデータがインフラストラクチャから決して流出しないようにしたい組織を対象としています。これは、SSO および内部 AI ゲートウェイと統合された一元化された設定を使用することで実現できます。 :::note -OpenCode は、コードやコンテキスト データを一切保存しません。 +OpenCode は、コードやコンテキストデータを一切保存しません。 ::: OpenCode Enterprise を始めるには: @@ -20,16 +20,15 @@ OpenCode Enterprise を始めるには: ## トライアル -OpenCode はオープン ソースであり、コードやコンテキスト データは一切保存されないため、開発者は簡単に [開始してトライアルを実行できます。 +OpenCode はオープンソースであり、コードやコンテキストデータは一切保存されないため、開発者は簡単に開始してトライアルを実行できます。 --- ### データの取り扱い -**OpenCode はコードやコンテキスト データを保存しません。** すべての処理はローカルで、または AI プロバイダーへの直接 API 呼び出しを通じて行われます。 +**OpenCode はコードやコンテキストデータを保存しません。** すべての処理はローカルで、または AI プロバイダーへの直接 API 呼び出しを通じて行われます。 -つまり、信頼できるプロバイダー、または内部プロバイダーを使用している限り、 -AIゲートウェイならOpenCodeを安全に利用できます。 +つまり、信頼できるプロバイダー、または内部 AI ゲートウェイを使用している限り、OpenCode を安全に利用できます。 ここでの唯一の注意点は、オプションの `/share` 機能です。 @@ -39,7 +38,7 @@ AIゲートウェイならOpenCodeを安全に利用できます。 ユーザーが `/share` 機能を有効にすると、会話とそれに関連付けられたデータが、opencode.ai でこれらの共有ページをホストするために使用されるサービスに送信されます。 -現在、データは CDN のエッジ ネットワークを通じて提供され、ユーザーの近くのエッジにキャッシュされます。 +現在、データは CDN のエッジネットワークを通じて提供され、ユーザーの近くのエッジにキャッシュされます。 試用版ではこれを無効にすることをお勧めします。 @@ -60,7 +59,7 @@ AIゲートウェイならOpenCodeを安全に利用できます。 --- -## 価格設定 +## 価格 OpenCode Enterprise ではシートごとのモデルを使用します。独自の LLM ゲートウェイをお持ちの場合、使用されたトークンに対して料金はかかりません。価格と実装オプションの詳細については、**お問い合わせください**。 @@ -68,31 +67,30 @@ OpenCode Enterprise ではシートごとのモデルを使用します。独自 ## 導入 -トライアルが完了し、OpenCode を使用する準備が整ったら、 -貴組織の場合は、**お問い合わせ**してご相談ください。 -価格設定と実装オプション。 +トライアルが完了し、OpenCode を組織で使用する準備が整ったら、 +**お問い合わせ**して価格設定と実装オプションについてご相談ください。 --- -### 中央構成 +### 中央設定 -組織全体で単一の中央構成を使用するように OpenCode をセットアップできます。 +組織全体で単一の中央設定を使用するように OpenCode をセットアップできます。 -この一元化された構成は SSO プロバイダーと統合でき、すべてのユーザーが内部 AI ゲートウェイのみにアクセスできるようにします。 +この一元化された設定は SSO プロバイダーと統合でき、すべてのユーザーが内部 AI ゲートウェイのみにアクセスできるようにします。 --- -### SSOの統合 +### SSO統合 -中央の構成を通じて、OpenCode は認証のために組織の SSO プロバイダーと統合できます。 +中央の設定を通じて、OpenCode は認証のために組織の SSO プロバイダーと統合できます。 これにより、OpenCode は既存の ID 管理システムを通じて内部 AI ゲートウェイの認証情報を取得できるようになります。 --- -### 社内AIゲートウェイ +### 内部AIゲートウェイ -中央構成を使用すると、内部 AI ゲートウェイのみを使用するように OpenCode を構成することもできます。 +中央設定を使用すると、内部 AI ゲートウェイのみを使用するように OpenCode を構成することもできます。 他のすべての AI プロバイダーを無効にして、すべてのリクエストが組織の承認されたインフラストラクチャを通過するようにすることもできます。 @@ -100,7 +98,7 @@ OpenCode Enterprise ではシートごとのモデルを使用します。独自 ### セルフホスティング -データが流出しないように共有ページを無効にすることをお勧めします +データが流出しないように共有ページを無効にすることをお勧めします。 貴社のインフラストラクチャ上でセルフホストすることもお手伝いします。 これは現在ロードマップに載っています。ご興味がございましたら、**お知らせください**。 @@ -110,41 +108,41 @@ OpenCode Enterprise ではシートごとのモデルを使用します。独自 ## よくある質問
-What is OpenCode Enterprise? +OpenCode Enterpriseとは何ですか？ -OpenCode Enterprise は、コードとデータがインフラストラクチャから決して流出しないようにしたい組織を対象としています。これは、SSO および内部 AI ゲートウェイと統合された一元化された構成を使用することで実現できます。 +OpenCode Enterprise は、コードとデータがインフラストラクチャから決して流出しないようにしたい組織を対象としています。これは、SSO および内部 AI ゲートウェイと統合された一元化された設定を使用することで実現できます。
-How do I get started with OpenCode Enterprise? +OpenCode Enterpriseを始めるにはどうすればよいですか？ -まずはチームの内部トライアルから始めてください。 OpenCode はデフォルトでコードやコンテキスト データを保存しないため、簡単に開始できます。 +まずはチームの内部トライアルから始めてください。 OpenCode はデフォルトでコードやコンテキストデータを保存しないため、簡単に開始できます。 その後、**お問い合わせ**いただき、価格や実装オプションについてご相談ください。
-How does enterprise pricing work? +エンタープライズの価格設定はどのようになっていますか？ エンタープライズ価格はシートごとに提供されます。独自の LLM ゲートウェイをお持ちの場合、使用されたトークンに対して料金はかかりません。詳細については、組織のニーズに基づいたカスタム見積もりをご希望の場合は、**お問い合わせください**。
-Is my data secure with OpenCode Enterprise? +OpenCode Enterpriseでデータは安全ですか？ -はい。 OpenCode はコードやコンテキスト データを保存しません。すべての処理はローカルで、または AI プロバイダーへの直接 API 呼び出しを通じて行われます。一元的な構成と SSO の統合により、データは組織のインフラストラクチャ内で安全に保たれます。 +はい。 OpenCode はコードやコンテキストデータを保存しません。すべての処理はローカルで、または AI プロバイダーへの直接 API 呼び出しを通じて行われます。一元的な設定と SSO の統合により、データは組織のインフラストラクチャ内で安全に保たれます。
-Can we use our own private npm registry? +独自のプライベート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/ @@ -154,7 +152,7 @@ npm login --registry=https://your-company.jfrog.io/api/npm/npm-virtual/ これを拾ってください。 :::caution -OpenCode を実行する前に、プライベート レジストリにログインする必要があります。 +OpenCode を実行する前に、プライベートレジストリにログインする必要があります。 ::: あるいは、.npmrc ファイルを手動で構成することもできます。 @@ -163,6 +161,6 @@ registry=https://your-company.jfrog.io/api/npm/npm-virtual/ //your-company.jfrog.io/api/npm/npm-virtual/:_authToken=${NPM_AUTH_TOKEN} ``` -開発者は、エンタープライズ レジストリからパッケージを確実にインストールできるように、OpenCode を実行する前にプライベート レジストリにログインする必要があります。 +開発者は、エンタープライズレジストリからパッケージを確実にインストールできるように、OpenCode を実行する前にプライベートレジストリにログインする必要があります。
diff --git a/packages/web/src/content/docs/ja/formatters.mdx b/packages/web/src/content/docs/ja/formatters.mdx index bbbe01c83..04f5227e0 100644 --- a/packages/web/src/content/docs/ja/formatters.mdx +++ b/packages/web/src/content/docs/ja/formatters.mdx @@ -3,11 +3,11 @@ title: フォーマッタ description: OpenCode は言語固有のフォーマッタを使用します。 --- -OpenCode は、言語固有のフォーマッタを使用してファイルを作成または編集した後、ファイルを自動的にフォーマットします。これにより、生成されるコードがプロジェクトのコード スタイルに従っていることが保証されます。 +OpenCode は、言語固有のフォーマッタを使用してファイルを作成または編集した後、ファイルを自動的にフォーマットします。これにより、生成されるコードがプロジェクトのコードスタイルに従っていることが保証されます。 --- -## 内蔵 +## 組み込み OpenCode には、一般的な言語およびフレームワーク用のいくつかの組み込みフォーマッタが付属しています。以下は、フォーマッタ、サポートされているファイル拡張子、および必要なコマンドまたは構成オプションのリストです。 @@ -47,16 +47,16 @@ OpenCode には、一般的な言語およびフレームワーク用のいく OpenCode がファイルを書き込んだり編集したりすると、次のことが行われます。 1. 有効なすべてのフォーマッタに対してファイル拡張子をチェックします。 -2. ファイルに対して適切なフォーマッタ コマンドを実行します。 +2. ファイルに対して適切なフォーマッタコマンドを実行します。 3. 書式の変更を自動的に適用します。 -このプロセスはバックグラウンドで実行されるため、手動の手順を行わなくてもコード スタイルが維持されます。 +このプロセスはバックグラウンドで実行されるため、手動の手順を行わなくてもコードスタイルが維持されます。 --- -## 設定する +## 設定 -OpenCode 構成の `formatter` セクションを通じてフォーマッタをカスタマイズできます。 +OpenCode 設定の `formatter` セクションを通じてフォーマッタをカスタマイズできます。 ```json title="opencode.json" { diff --git a/packages/web/src/content/docs/ja/github.mdx b/packages/web/src/content/docs/ja/github.mdx index b879e08dc..d587094dc 100644 --- a/packages/web/src/content/docs/ja/github.mdx +++ b/packages/web/src/content/docs/ja/github.mdx @@ -7,7 +7,7 @@ OpenCode は GitHub ワークフローと統合します。コメントで `/ope --- -## 特徴 +## 機能 - **問題のトリアージ**: OpenCode に問題を調べて説明してもらいます。 - **修正と実装**: OpenCode に問題の修正または機能の実装を依頼します。そして、新しいブランチで動作し、すべての変更を含む PR を送信します。 @@ -33,11 +33,11 @@ opencode github install 1. **GitHub アプリをインストールします** -[**github.com/apps/opencode-agent**](https://github.com/apps/opencode-agent) にアクセスしてください。ターゲット リポジトリにインストールされていることを確認してください。 +[**github.com/apps/opencode-agent**](https://github.com/apps/opencode-agent) にアクセスしてください。ターゲットリポジトリにインストールされていることを確認してください。 2. **ワークフローを追加** -次のワークフロー ファイルをリポジトリの `.github/workflows/opencode.yml` に追加します。適切な `model` と必要な API キーを `env` に設定してください。 +次のワークフローファイルをリポジトリの `.github/workflows/opencode.yml` に追加します。適切な `model` と必要な API キーを `env` に設定してください。 ```yml title=".github/workflows/opencode.yml" {24,26} name: opencode @@ -73,19 +73,19 @@ opencode github install # github_token: xxxx ``` -3. **API キーをシークレットに保存します** +3. **API キーをシークレットに保存する** 組織またはプロジェクトの**設定**で、左側の**シークレットと変数**を展開し、**アクション**を選択します。そして、必要な API キーを追加します。 --- -## 構成 +## 設定 - `model`: OpenCode で使用するモデル。 `provider/model` の形式をとります。これは**必須**です。 -- `agent`: 使用するエージェント。プライマリ エージェントである必要があります。見つからない場合は、設定から `default_agent` にフォールバックするか、`"build"` にフォールバックします。 -- `share`: OpenCode セッションを共有するかどうか。パブリック リポジトリのデフォルトは **true** です。 -- `prompt`: デフォルトの動作をオーバーライドするためのオプションのカスタム プロンプト。これを使用して、OpenCode がリクエストを処理する方法をカスタマイズします。 -- `token`: コメントの作成、変更のコミット、プル リクエストのオープンなどの操作を実行するためのオプションの GitHub アクセス トークン。デフォルトでは、OpenCode は OpenCode GitHub アプリからのインストール アクセス トークンを使用するため、コミット、コメント、プル リクエストはアプリからのものとして表示されます。 +- `agent`: 使用するエージェント。プライマリエージェントである必要があります。見つからない場合は、設定から `default_agent` にフォールバックするか、`"build"` にフォールバックします。 +- `share`: OpenCode セッションを共有するかどうか。パブリックリポジトリのデフォルトは **true** です。 +- `prompt`: デフォルトの動作をオーバーライドするためのオプションのカスタムプロンプト。これを使用して、OpenCode がリクエストを処理する方法をカスタマイズします。 +- `token`: コメントの作成、変更のコミット、プルリクエストのオープンなどの操作を実行するためのオプションの GitHub アクセストークン。デフォルトでは、OpenCode は OpenCode GitHub アプリからのインストールアクセストークンを使用するため、コミット、コメント、プルリクエストはアプリからのものとして表示されます。 あるいは、OpenCode GitHub アプリをインストールせずに、GitHub Action ランナーの [組み込み `GITHUB_TOKEN`](https://docs.github.com/en/actions/tutorials/authenticate-with-github_token) を使用することもできます。ワークフローで必要な権限を必ず付与してください。 @@ -97,7 +97,7 @@ permissions: issues: write ``` -必要に応じて、[パーソナル アクセス トークン](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)(PAT) を使用することもできます。 +必要に応じて、[パーソナルアクセストークン](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)(PAT) を使用することもできます。 --- @@ -105,16 +105,16 @@ permissions: OpenCode は、次の GitHub イベントによってトリガーできます。 -| イベントの種類 | きっかけ | 詳細 | +| イベントの種類 | トリガー | 詳細 | | ----------------------------- | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | `issue_comment` | 問題または PR についてコメントする | コメントで `/opencode` または `/oc` について言及してください。 OpenCode はコンテキストを読み取り、ブランチを作成したり、PR を開いたり、返信したりできます。 | -| `pull_request_review_comment` | PR 内の特定のコード行にコメントする | コードをレビューするときに、`/opencode` または `/oc` について言及します。 OpenCode は、ファイル パス、行番号、および diff コンテキストを受け取ります。 | +| `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 に送られます。 | -### スケジュール例 +### スケジュールの例 スケジュールに従って OpenCode を実行し、自動化されたタスクを実行します。 @@ -150,7 +150,7 @@ 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` を付与する必要があります。 --- @@ -191,11 +191,11 @@ jobs: - Suggest improvements ``` -`pull_request` イベントの場合、`prompt` が指定されていない場合、OpenCode はデフォルトでプル リクエストをレビューします。 +`pull_request` イベントの場合、`prompt` が指定されていない場合、OpenCode はデフォルトでプルリクエストをレビューします。 --- -### 問題のトリアージの例 +### Issueのトリアージの例 新しい問題を自動的に優先順位付けします。この例では、スパムを減らすために 30 日より古いアカウントにフィルターを適用します。 @@ -273,7 +273,7 @@ jobs: GitHub で OpenCode を使用する方法の例をいくつか示します。 -- **問題の説明** +- **Issueの説明** このコメントを GitHub の問題に追加します。 @@ -283,7 +283,7 @@ GitHub で OpenCode を使用する方法の例をいくつか示します。 OpenCode は、すべてのコメントを含むスレッド全体を読み取り、明確な説明を返信します。 -- **問題を修正** +- **Issueの修正** GitHub の問題で次のように言います。 @@ -293,7 +293,7 @@ GitHub の問題で次のように言います。 そして、OpenCode は新しいブランチを作成し、変更を実装し、変更を含む PR を開きます。 -- **PR を確認して変更を加える** +- **PR をレビューして変更を加える** GitHub PR に次のコメントを残してください。 @@ -303,7 +303,7 @@ GitHub PR に次のコメントを残してください。 OpenCode は要求された変更を実装し、同じ PR にコミットします。 -- **特定のコード行を確認してください** +- **特定のコード行のレビュー** PR の「ファイル」タブのコード行に直接コメントを残します。 OpenCode は、ファイル、行番号、および diff コンテキストを自動的に検出して、正確な応答を提供します。 @@ -319,4 +319,4 @@ PR の「ファイル」タブのコード行に直接コメントを残しま - 周囲の差分コンテキスト - 行番号情報 -これにより、ファイル パスや行番号を手動で指定する必要がなく、よりターゲットを絞ったリクエストが可能になります。 +これにより、ファイルパスや行番号を手動で指定する必要がなく、よりターゲットを絞ったリクエストが可能になります。 diff --git a/packages/web/src/content/docs/ja/gitlab.mdx b/packages/web/src/content/docs/ja/gitlab.mdx index 7f20ed571..8560c9503 100644 --- a/packages/web/src/content/docs/ja/gitlab.mdx +++ b/packages/web/src/content/docs/ja/gitlab.mdx @@ -17,17 +17,17 @@ OpenCode は通常の GitLab パイプラインで動作します。 [CI コン --- -### 特徴 +### 機能 -- **ジョブごとにカスタム構成を使用する**: カスタム構成ディレクトリ (`./config/#custom-directory` など) を使用して OpenCode を構成し、OpenCode の呼び出しごとに機能を有効または無効にします。 -- **最小限のセットアップ**: CI コンポーネントはバックグラウンドで OpenCode をセットアップします。必要なのは、OpenCode 構成と初期プロンプトを作成することだけです。 +- **ジョブごとにカスタム設定を使用する**: カスタム設定ディレクトリ (`./config/#custom-directory` など) を使用して OpenCode を構成し、OpenCode の呼び出しごとに機能を有効または無効にします。 +- **最小限のセットアップ**: CI コンポーネントはバックグラウンドで OpenCode をセットアップします。必要なのは、OpenCode 設定と初期プロンプトを作成することだけです。 - **柔軟性**: CI コンポーネントは、動作をカスタマイズするための複数の入力をサポートしています。 --- ### 設定 -1. OpenCode 認証 JSON をファイル タイプ CI 環境変数として [**設定**] > [**CI/CD**] > [**変数**] に保存します。必ず「マスクして非表示」としてマークしてください。 +1. OpenCode 認証 JSON をファイルタイプ CI 環境変数として [**設定**] > [**CI/CD**] > [**変数**] に保存します。必ず「マスクして非表示」としてマークしてください。 2. 以下を `.gitlab-ci.yml` ファイルに追加します。 ```yaml title=".gitlab-ci.yml" @@ -40,7 +40,7 @@ OpenCode は通常の GitLab パイプラインで動作します。 [CI コン message: "Your prompt here" ``` -さらに多くの入力と使用例については、このコンポーネントの docs](https://gitlab.com/explore/catalog/nagyv/gitlab-opencode) をチェックしてください。 +さらに多くの入力と使用例については、このコンポーネントの [ドキュメント](https://gitlab.com/explore/catalog/nagyv/gitlab-opencode) をチェックしてください。 --- @@ -51,7 +51,7 @@ OpenCode は GitLab ワークフローと統合します。 --- -### 特徴 +### 機能 - **問題のトリアージ**: OpenCode に問題を調べて説明してもらいます。 - **修正と実装**: OpenCode に問題の修正または機能の実装を依頼します。 @@ -70,14 +70,14 @@ OpenCode は GitLab CI/CD パイプラインで実行されます。セットア 1. GitLab 環境を構成する 2. CI/CD のセットアップ -3. AI モデル プロバイダー API キーを取得する +3. AI モデルプロバイダー API キーを取得する 4. サービスアカウントを作成する 5. CI/CD変数を構成する -6. フロー構成ファイルを作成します。例を次に示します。 +6. フロー設定ファイルを作成します。例を次に示します。
- Flow configuration + フロー設定 ```yaml image: node:22-slim @@ -161,7 +161,7 @@ OpenCode は GitLab CI/CD パイプラインで実行されます。セットア GitLab で OpenCode を使用する方法の例をいくつか示します。 :::tip -`@opencode` とは異なるトリガー フレーズを使用するように設定できます。 +`@opencode` とは異なるトリガーフレーズを使用するように設定できます。 ::: - **問題の説明** @@ -182,14 +182,14 @@ GitLab の問題では、次のように言います。 @opencode fix this ``` -OpenCode は新しいブランチを作成し、変更を実装し、変更を含むマージ リクエストを開きます。 +OpenCode は新しいブランチを作成し、変更を実装し、変更を含むマージリクエストを開きます。 - **マージリクエストを確認する** -GitLab マージ リクエストに次のコメントを残してください。 +GitLab マージリクエストに次のコメントを残してください。 ``` @opencode review this merge request ``` -OpenCode はマージ リクエストをレビューし、フィードバックを提供します。 +OpenCode はマージリクエストをレビューし、フィードバックを提供します。 diff --git a/packages/web/src/content/docs/ja/ide.mdx b/packages/web/src/content/docs/ja/ide.mdx index dcced1c89..6003f6412 100644 --- a/packages/web/src/content/docs/ja/ide.mdx +++ b/packages/web/src/content/docs/ja/ide.mdx @@ -3,14 +3,14 @@ title: IDE description: VS Code、Cursor、およびその他の IDE 用の OpenCode 拡張機能 --- -OpenCode は、VS Code、Cursor、またはterminal をサポートする任意の IDE と統合します。開始するには、terminal で `opencode` を実行するだけです。 +OpenCode は、VS Code、Cursor、またはターミナルをサポートする任意の IDE と統合します。開始するには、ターミナルで `opencode` を実行するだけです。 --- ## 使用法 -- **クイック起動**: `Cmd+Esc` (Mac) または `Ctrl+Esc` (Windows/Linux) を使用して、分割terminal ビューで OpenCode を開くか、既存のterminal セッションが既に実行されている場合はそれにフォーカスします。 -- **新しいセッション**: すでに開いている場合でも、`Cmd+Shift+Esc` (Mac) または `Ctrl+Shift+Esc` (Windows/Linux) を使用して、新しい OpenCode terminal セッションを開始します。 UI の [OpenCode] ボタンをクリックすることもできます。 +- **クイック起動**: `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`。 @@ -20,8 +20,8 @@ OpenCode は、VS Code、Cursor、またはterminal をサポートする任意 OpenCode を VS Code および Cursor、Windsurf、VSCodium などの一般的なフォークにインストールするには: -1. VS Codeを開く -2. 統合terminal を開きます +1. VS Code を開く +2. 統合ターミナルを開きます 3. `opencode` を実行します - 拡張機能は自動的にインストールされます 一方、TUI から `/editor` または `/export` を実行するときに独自の IDE を使用したい場合は、`export EDITOR="code --wait"` を設定する必要があります。 [詳細はこちら](/docs/tui/#editor-setup)。 @@ -38,11 +38,11 @@ Extension Marketplace で **OpenCode** を検索し、**インストール** を 拡張機能が自動的にインストールされない場合: -- 統合terminal で `opencode` を実行していることを確認してください。 +- 統合ターミナルで `opencode` を実行していることを確認してください。 - IDE の CLI がインストールされていることを確認します。 - - VS コードの場合: `code` コマンド - - Cursorの場合: `cursor` コマンド - - Windsurfの場合: `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/ja/index.mdx b/packages/web/src/content/docs/ja/index.mdx index 87b0e9e74..6a6612715 100644 --- a/packages/web/src/content/docs/ja/index.mdx +++ b/packages/web/src/content/docs/ja/index.mdx @@ -1,5 +1,5 @@ --- -title: イントロ +title: はじめに description: OpenCode を始めましょう。 --- @@ -7,7 +7,7 @@ import { Tabs, TabItem } from "@astrojs/starlight/components" import config from "../../../../config.mjs" export const console = config.console -[**OpenCode**](/) は、オープンソースの AI コーディング エージェントです。これは、terminal ベースのインターフェイス、デスクトップ アプリ、または IDE 拡張機能として利用できます。 +[**OpenCode**](/) は、オープンソースの AI コーディングエージェントです。これは、ターミナルベースのインターフェイス、デスクトップアプリ、または IDE 拡張機能として利用できます。 ![opencodeテーマ](../../../assets/lander/screenshot.png)を使用したOpenCode TUI @@ -17,9 +17,9 @@ export const console = config.console #### 前提条件 -terminal で OpenCode を使用するには、次のものが必要です。 +ターミナルで OpenCode を使用するには、次のものが必要です。 -1. 次のような最新のterminal エミュレータ: +1. 次のような最新のターミナルエミュレータ: - [WezTerm](https://wezterm.org)、クロスプラットフォーム - [Alacritty](https://alacritty.org)、クロスプラットフォーム - [Ghostty](https://ghostty.org)、Linux および macOS @@ -31,7 +31,7 @@ terminal で OpenCode を使用するには、次のものが必要です。 ## インストール -OpenCode をインストールする最も簡単な方法は、インストール スクリプトを使用することです。 +OpenCode をインストールする最も簡単な方法は、インストールスクリプトを使用することです。 ```bash curl -fsSL https://opencode.ai/install | bash @@ -99,19 +99,19 @@ Windows で最高のエクスペリエンスを得るには、[Windows Subsystem choco install opencode ``` -- **Using Scoop** +- **Scoop の使用** ```bash scoop install opencode ``` -- **NPM の使用** +- **npm の使用** ```bash npm install -g opencode-ai ``` -- **Using Mise** +- **Mise の使用** ```bash mise use -g github:anomalyco/opencode @@ -129,15 +129,14 @@ Bun を使用して Windows に OpenCode をインストールするためのサ --- -## 設定する +## 設定 OpenCode を使用すると、API キーを構成することで任意の LLM プロバイダーを使用できます。 -LLM プロバイダーを初めて使用する場合は、[OpenCode Zen](/docs/zen). -これは、OpenCode によってテストおよび検証されたモデルの厳選されたリストです。 -team. +LLM プロバイダーを初めて使用する場合は、[OpenCode Zen](/docs/zen) をお勧めします。 +これは、OpenCode チームによってテストおよび検証されたモデルの厳選されたリストです。 -1. TUI で `/connect` コマンドを実行し、opencode を選択して、[opencode.ai/auth](https://opencode.ai/auth). +1. TUI で `/connect` コマンドを実行し、opencode を選択して、[opencode.ai/auth](https://opencode.ai/auth) で認証します。 ```txt /connect @@ -158,10 +157,9 @@ team. --- -## 初期化する +## 初期化 -プロバイダーを構成したので、次のプロジェクトに移動できます。 -取り組みたいと考えています。 +プロバイダーを構成したので、取り組みたいプロジェクトに移動できます。 ```bash cd /path/to/project @@ -179,25 +177,21 @@ opencode /init ``` -これにより、OpenCode がプロジェクトを分析し、`AGENTS.md` ファイルを作成します。 -プロジェクトのルート。 +これにより、OpenCode がプロジェクトを分析し、プロジェクトのルートに `AGENTS.md` ファイルを作成します。 :::tip プロジェクトの `AGENTS.md` ファイルを Git にコミットする必要があります。 ::: -これは、OpenCode がプロジェクトの構造とコーディング パターンを理解するのに役立ちます。 -used. +これは、OpenCode がプロジェクトの構造と使用されているコーディングパターンを理解するのに役立ちます。 --- ## 使用法 -これで、OpenCode を使用してプロジェクトに取り組む準備が整いました。お気軽にお尋ねください -何でも！ +これで、OpenCode を使用してプロジェクトに取り組む準備が整いました。何でもお気軽にお尋ねください！ -AI コーディング エージェントを初めて使用する場合は、次の例を参考にしてください。 -help. +AI コーディングエージェントを初めて使用する場合は、次の例を参考にしてください。 --- @@ -224,7 +218,7 @@ OpenCode に新しい機能をプロジェクトに追加するよう依頼で 1. **計画を作成する** OpenCode には、変更を加える機能を無効にする _Plan mode_ があり、 -代わりに、その機能を*どのように*実装するかを提案してください。 +代わりに、その機能を*どのように*実装するかを提案します。 **Tab** キーを使用してそれに切り替えます。右下隅にこれを示すインジケーターが表示されます。 @@ -240,12 +234,11 @@ OpenCode には、変更を加える機能を無効にする _Plan mode_ があ From this screen, the user can undelete a note or permanently delete it. ``` -自分が何を望んでいるのかを理解するために、OpenCode に十分な詳細を提供したいと考えています。役に立ちます -チームの若手開発者と話しているように話すことができます。 +自分が何を望んでいるのかを理解するために、OpenCode に十分な詳細を提供したいと考えています。 +チームの若手開発者と話しているように話すと良いでしょう。 :::tip OpenCode に多くのコンテキストと例を提供して、意図する内容を理解できるようにします。 -want. ::: 2. **計画を反復する** @@ -258,11 +251,11 @@ want. ``` :::tip -画像をterminal にドラッグ アンド ドロップして、プロンプトに追加します。 +画像をターミナルにドラッグアンドドロップして、プロンプトに追加します。 ::: -OpenCode は、指定された画像をスキャンしてプロンプトに追加できます。あなたはできる -これを行うには、画像をterminal にドラッグ アンド ドロップします。 +OpenCode は、指定された画像をスキャンしてプロンプトに追加できます。 +画像をターミナルにドラッグアンドドロップしてこれを行うことができます。 3. **機能を構築する** @@ -292,8 +285,7 @@ handled in the /notes route in @packages/functions/src/notes.ts and implement the same logic in @packages/functions/src/settings.ts ``` -OpenCode が適切な情報を提供できるように、十分な量の詳細を確実に提供する必要があります。 -changes. +OpenCode が適切な変更を行えるように、十分な量の詳細を確実に提供する必要があります。 --- @@ -312,8 +304,7 @@ Can you refactor the function in @packages/functions/src/api/index.ts? /undo ``` -OpenCode は加えた変更を元に戻し、元のメッセージを表示します。 -again. +OpenCode は加えた変更を元に戻し、元のメッセージを再度表示します。 ```txt frame="none" "@packages/functions/src/api/index.ts" Can you refactor the function in @packages/functions/src/api/index.ts? @@ -335,8 +326,7 @@ Can you refactor the function in @packages/functions/src/api/index.ts? ## 共有 -OpenCode との会話は [他のユーザーと共有できます] -チーム](/docs/share)。 +OpenCode との会話は [他のチームメンバーと共有できます](/docs/share)。 ```bash frame="none" /share @@ -356,4 +346,4 @@ OpenCode との会話は [他のユーザーと共有できます] それで終わりです！これであなたは OpenCode の使い方のプロになりました。 -独自のものにするには、[テーマ](/docs/themes) を選択する、[キーバインドをカスタマイズする ](/docs/keybinds)、[コード フォーマッタ ](/docs/formatters) を設定する、[カスタム コマンド ](/docs/commands) を作成する]、または [OpenCode config](/docs/config) を試してみる] ことをお勧めします。 +独自のものにするには、[テーマ](/docs/themes) を選択する、[キーバインドをカスタマイズする](/docs/keybinds)、[コードフォーマッタ](/docs/formatters) を設定する、[カスタムコマンド](/docs/commands) を作成する、または [OpenCode設定](/docs/config) を試してみることをお勧めします。 diff --git a/packages/web/src/content/docs/ja/keybinds.mdx b/packages/web/src/content/docs/ja/keybinds.mdx index 30a36054e..66466a7f7 100644 --- a/packages/web/src/content/docs/ja/keybinds.mdx +++ b/packages/web/src/content/docs/ja/keybinds.mdx @@ -107,11 +107,11 @@ OpenCode には、OpenCode 設定を通じてカスタマイズできるキー ## リーダーキー -OpenCode は、ほとんどのキーバインドに `leader` キーを使用します。これにより、terminal での競合が回避されます。 +OpenCode は、ほとんどのキーバインドに `leader` キーを使用します。これにより、ターミナルでの競合が回避されます。 -デフォルトでは、`ctrl+x` がリーダー キーであり、ほとんどの操作では、最初にリーダー キーを押してからショートカットを押す必要があります。たとえば、新しいセッションを開始するには、まず `ctrl+x` を押してから、`n` を押します。 +デフォルトでは、`ctrl+x` がリーダーキーであり、ほとんどの操作では、最初にリーダーキーを押してからショートカットを押す必要があります。たとえば、新しいセッションを開始するには、まず `ctrl+x` を押してから、`n` を押します。 -キーバインドにリーダー キーを使用する必要はありませんが、そうすることをお勧めします。 +キーバインドにリーダーキーを使用する必要はありませんが、そうすることをお勧めします。 --- @@ -132,7 +132,7 @@ OpenCode は、ほとんどのキーバインドに `leader` キーを使用し ## デスクトッププロンプトのショートカット -OpenCode デスクトップ アプリのプロンプト入力は、テキストを編集するための一般的な Readline/Emacs スタイルのショートカットをサポートしています。これらは組み込みであり、現在 `opencode.json` を介して構成することはできません。 +OpenCode デスクトップアプリのプロンプト入力は、テキストを編集するための一般的な Readline/Emacs スタイルのショートカットをサポートしています。これらは組み込みであり、現在 `opencode.json` を介して構成することはできません。 | ショートカット | アクション | | -------------- | ------------------------------------------------- | @@ -154,7 +154,7 @@ OpenCode デスクトップ アプリのプロンプト入力は、テキスト ## Shift+Enter -一部のterminal では、デフォルトでは Enter キーを使用して修飾キーを送信しません。エスケープ シーケンスとして `Shift+Enter` を送信するようにterminal を設定する必要がある場合があります。 +一部のターミナルでは、デフォルトでは Enter キーを使用して修飾キーを送信しません。エスケープシーケンスとして `Shift+Enter` を送信するようにターミナルを設定する必要がある場合があります。 ### Windows Terminal diff --git a/packages/web/src/content/docs/ja/lsp.mdx b/packages/web/src/content/docs/ja/lsp.mdx index 43af52de7..7b42c3733 100644 --- a/packages/web/src/content/docs/ja/lsp.mdx +++ b/packages/web/src/content/docs/ja/lsp.mdx @@ -3,11 +3,11 @@ title: LSPサーバー description: OpenCode は LSP サーバーと統合します。 --- -OpenCode は言語サーバー プロトコル (LSP) と統合して、LLM がコードベースと対話できるようにします。診断を使用して LLM にフィードバックを提供します。 +OpenCode は言語サーバープロトコル (LSP) と統合して、LLM がコードベースと対話できるようにします。診断を使用して LLM にフィードバックを提供します。 --- -## 内蔵 +## 組み込み OpenCode には、一般的な言語用のいくつかの組み込み LSP サーバーが付属しています。 @@ -56,16 +56,16 @@ OpenCode には、一般的な言語用のいくつかの組み込み LSP サー ## 仕組み -opencode がファイルを開くと、次のようになります。 +OpenCode がファイルを開くと、次のようになります。 1. 有効なすべての LSP サーバーに対してファイル拡張子をチェックします。 2. 適切な LSP サーバーがまだ実行されていない場合は開始します。 --- -## 設定する +## 設定 -Opencode 構成の `lsp` セクションを通じて LSP サーバーをカスタマイズできます。 +OpenCode 設定の `lsp` セクションを通じて LSP サーバーをカスタマイズできます。 ```json title="opencode.json" { @@ -158,7 +158,7 @@ LSP サーバーの起動時に `env` プロパティを使用して環境変数 --- -### カスタムLSPサーバー +### カスタム LSP サーバー コマンドとファイル拡張子を指定して、カスタム LSP サーバーを追加できます。 @@ -180,9 +180,9 @@ LSP サーバーの起動時に `env` プロパティを使用して環境変数 ### PHP Intelephense -PHP Intelephense は、ライセンス キーを通じてプレミアム機能を提供します。ライセンス キーを指定するには、次の場所にあるテキスト ファイルにキー (のみ) を配置します。 +PHP Intelephense は、ライセンスキーを通じてプレミアム機能を提供します。ライセンスキーを指定するには、次の場所にあるテキストファイルにキー (のみ) を配置します。 - macOS/Linux の場合: `$HOME/intelephense/license.txt` - Windows の場合: `%USERPROFILE%/intelephense/license.txt` -ファイルにはライセンス キーのみが含まれており、追加のコンテンツは含まれていません。 +ファイルにはライセンスキーのみが含まれており、追加のコンテンツは含まれていません。 diff --git a/packages/web/src/content/docs/ja/mcp-servers.mdx b/packages/web/src/content/docs/ja/mcp-servers.mdx index 7282f5af9..a4b248533 100644 --- a/packages/web/src/content/docs/ja/mcp-servers.mdx +++ b/packages/web/src/content/docs/ja/mcp-servers.mdx @@ -3,7 +3,7 @@ title: MCPサーバー description: ローカルおよびリモートの MCP ツールを追加します。 --- -_Model Context Protocol_ (MCP) を使用して、OpenCode に外部ツールを追加できます。 OpenCode は、ローカル サーバーとリモート サーバーの両方をサポートします。 +_Model Context Protocol_ (MCP) を使用して、OpenCode に外部ツールを追加できます。 OpenCode は、ローカルサーバーとリモートサーバーの両方をサポートします。 MCP ツールを追加すると、組み込みツールとともに LLM で自動的に使用できるようになります。 @@ -16,13 +16,13 @@ MCP サーバーを使用すると、コンテキストが追加されます。 :::tip MCP サーバーはコンテキストに追加されるため、どのサーバーを有効にするかには注意してください。 ::: -Certain MCP サーバーなどの特定の MCP サーバーは、大量のトークンを追加する傾向があり、コンテキスト制限を簡単に超える可能性があります。 +特定の MCP サーバーは、大量のトークンを追加する傾向があり、コンテキスト制限を簡単に超える可能性があります。 --- -## 有効にする +## 有効化 -MCP サーバーは、`mcp` の下の [OpenCode Config](https://opencode.ai/docs/config/) で定義できます。各 MCP を一意の名前で追加します。 LLM にプロンプ​​トを表示するときに、その MCP を名前で参照できます。 +MCP サーバーは、`mcp` の下の [OpenCode 設定](https://opencode.ai/docs/config/) で定義できます。各 MCP を一意の名前で追加します。 LLM にプロンプ​​トを表示するときに、その MCP を名前で参照できます。 ```jsonc title="opencode.jsonc" {6} { @@ -39,6 +39,474 @@ MCP サーバーは、`mcp` の下の [OpenCode Config](https://opencode.ai/docs } ``` +`enabled` を `false` に設定してサーバーを無効にすることもできます。これは、サーバーを設定から削除せずに一時的に無効にする場合に便利です。 + +--- + +### リモートのデフォルトを上書きする + +組織は、`.well-known/opencode` エンドポイント経由でデフォルトの MCP サーバーを提供できます。これらのサーバーはデフォルトで無効になっている場合があり、ユーザーは必要なサーバーにオプトインできます。 + +組織のリモート設定から特定のサーバーを有効にするには、`enabled: true` を使用してローカル設定に追加します。 + +```json title="opencode.json" +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "jira": { + "type": "remote", + "url": "https://jira.example.com/mcp", + "enabled": true + } + } +} +``` + +ローカルの設定値はリモートのデフォルト値をオーバーライドします。詳細については、「[設定の優先順位](/docs/config#precedence-order)」を参照してください。 + +--- + +## ローカル + +MCP オブジェクト内の `type` から `"local"` を使用してローカル MCP サーバーを追加します。 + +```jsonc title="opencode.jsonc" {15} +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "my-local-mcp-server": { + "type": "local", + // Or ["bun", "x", "my-mcp-command"] + "command": ["npx", "-y", "my-mcp-command"], + "enabled": true, + "environment": { + "MY_ENV_VAR": "my_env_var_value", + }, + }, + }, +} +``` + +このコマンドは、ローカル MCP サーバーの起動方法を示します。環境変数のリストを渡すこともできます。 + +たとえば、テスト [`@modelcontextprotocol/server-everything`](https://www.npmjs.com/package/@modelcontextprotocol/server-everything) MCP サーバーを追加する方法は次のとおりです。 + +```jsonc title="opencode.jsonc" +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "mcp_everything": { + "type": "local", + "command": ["npx", "-y", "@modelcontextprotocol/server-everything"], + }, + }, +} +``` + +これを使用するには、プロンプトに `use the mcp_everything tool` を追加します。 + +```txt "mcp_everything" +use the mcp_everything tool to add the number 3 and 4 +``` + +--- + +#### オプション + +ここでは、ローカル MCP サーバーを構成するためのすべてのオプションを示します。 + +| オプション | タイプ | 必須 | 説明 | +| ------------- | ------------ | ---- | ------------------------------------------------------------------------------------------ | +| `type` | 文字列 | Y | MCP サーバー接続のタイプは、`"local"` である必要があります。 | +| `command` | 配列 | Y | MCP サーバーを実行するためのコマンドと引数。 | +| `environment` | オブジェクト | | サーバーの実行時に設定する環境変数。 | +| `enabled` | ブール値 | | 起動時に MCP サーバーを有効または無効にします。 | +| `timeout` | 数値 | | MCP サーバーからツールを取得する際のタイムアウト (ミリ秒)。デフォルトは 5000 (5 秒) です。 | + +--- + +## リモート + +`type` を `"remote"` に設定して、リモート MCP サーバーを追加します。 + +```json title="opencode.json" +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "my-remote-mcp": { + "type": "remote", + "url": "https://my-mcp-server.com", + "enabled": true, + "headers": { + "Authorization": "Bearer MY_API_KEY" + } + } + } +} +``` + +`url` はリモート MCP サーバーの URL で、`headers` オプションを使用するとヘッダーのリストを渡すことができます。 + +--- + +#### オプション + +| オプション | タイプ | 必須 | 説明 | +| ---------- | ------------ | ---- | ------------------------------------------------------------------------------------------ | +| `type` | 文字列 | Y | MCP サーバー接続のタイプは、`"remote"` である必要があります。 | +| `url` | 文字列 | Y | リモート MCP サーバーの URL。 | +| `enabled` | ブール値 | | 起動時に MCP サーバーを有効または無効にします。 | +| `headers` | オブジェクト | | リクエストとともに送信するヘッダー。 | +| `oauth` | オブジェクト | | OAuth 認証設定。以下の「OAuth](#oauth)」セクションを参照してください。 | +| `timeout` | 数値 | | MCP サーバーからツールを取得する際のタイムアウト (ミリ秒)。デフォルトは 5000 (5 秒) です。 | + +--- + +## OAuth + +OpenCode は、リモート MCP サーバーの OAuth 認証を自動的に処理します。サーバーが認証を必要とする場合、OpenCode は次のことを行います。 + +1. 401 応答を検出し、OAuth フローを開始します。 +2. サーバーでサポートされている場合は **動的クライアント登録 (RFC 7591)** を使用します +3. 今後のリクエストに備えてトークンを安全に保管する + +--- + +### 自動 + +ほとんどの OAuth 対応 MCP サーバーでは、特別な構成は必要ありません。リモートサーバーを設定するだけです。 + +```json title="opencode.json" +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "my-oauth-server": { + "type": "remote", + "url": "https://mcp.example.com/mcp" + } + } +} +``` + +サーバーが認証を必要とする場合、OpenCode を初めて使用しようとすると、認証を求めるプロンプトが表示されます。そうでない場合は、`opencode mcp auth ` を使用して [flow](#authenticating) を手動でトリガーできます。 + +--- + +### 事前登録済み + +MCP サーバープロバイダーからクライアント認証情報を取得している場合は、それらを構成できます。 + +```json title="opencode.json" {7-11} +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "my-oauth-server": { + "type": "remote", + "url": "https://mcp.example.com/mcp", + "oauth": { + "clientId": "{env:MY_MCP_CLIENT_ID}", + "clientSecret": "{env:MY_MCP_CLIENT_SECRET}", + "scope": "tools:read tools:execute" + } + } + } +} +``` + +--- + +### 認証中 + +手動で認証をトリガーしたり、資格情報を管理したりできます。 + +特定の MCP サーバーで認証します。 + +```bash +opencode mcp auth my-oauth-server +``` + +すべての MCP サーバーとその認証ステータスをリストします。 + +```bash +opencode mcp list +``` + +保存されている認証情報を削除します。 + +```bash +opencode mcp logout my-oauth-server +``` + +`mcp auth` コマンドは、認証のためにブラウザを開きます。承認後、OpenCode はトークンを `~/.local/share/opencode/mcp-auth.json` に安全に保存します。 + +--- + +#### OAuthの無効化 + +サーバー (代わりに API キーを使用するサーバーなど) の自動 OAuth を無効にする場合は、`oauth` を `false` に設定します。 + +```json title="opencode.json" {7} +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "my-api-key-server": { + "type": "remote", + "url": "https://mcp.example.com/mcp", + "oauth": false, + "headers": { + "Authorization": "Bearer {env:MY_API_KEY}" + } + } + } +} +``` + +--- + +#### OAuth オプション + +| オプション | タイプ | 説明 | +| -------------- | --------------- | -------------------------------------------------------------------------------- | +| `oauth` | Object \| false | OAuth config object, or `false` to disable OAuth auto-detection. | +| `clientId` | String | OAuth client ID. If not provided, dynamic client registration will be attempted. | +| `clientSecret` | String | OAuth client secret, if required by the authorization server. | +| `scope` | String | OAuth scopes to request during authorization. | + +#### デバッグ + +リモート MCP サーバーが認証に失敗した場合は、次の方法で問題を診断できます。 + +```bash +# View auth status for all OAuth-capable servers +opencode mcp auth list + +# Debug connection and OAuth flow for a specific server +opencode mcp debug my-oauth-server +``` + +`mcp debug` コマンドは、現在の認証ステータスを表示し、HTTP 接続をテストし、OAuth 検出フローを試行します。 + +--- + +## 管理 + +MCP は、組み込みツールと並んで、OpenCode のツールとして利用できます。したがって、他のツールと同様に、OpenCode 設定を通じてそれらを管理できます。 + +--- + +### グローバル + +これは、それらをグローバルに有効または無効にできることを意味します。 + +```json title="opencode.json" {14} +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "my-mcp-foo": { + "type": "local", + "command": ["bun", "x", "my-mcp-command-foo"] + }, + "my-mcp-bar": { + "type": "local", + "command": ["bun", "x", "my-mcp-command-bar"] + } + }, + "tools": { + "my-mcp-foo": false + } +} +``` + +グロブパターンを使用して、一致するすべての MCP を無効にすることもできます。 + +```json title="opencode.json" {14} +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "my-mcp-foo": { + "type": "local", + "command": ["bun", "x", "my-mcp-command-foo"] + }, + "my-mcp-bar": { + "type": "local", + "command": ["bun", "x", "my-mcp-command-bar"] + } + }, + "tools": { + "my-mcp*": false + } +} +``` + +ここでは、グロブパターン `my-mcp*` を使用して、すべての MCP を無効にしています。 + +--- + +### エージェントごと + +多数の MCP サーバーがある場合は、エージェントごとにのみ有効にし、グローバルに無効にすることができます。これを行うには: + +1. ツールとしてグローバルに無効にします。 +2. [エージェント設定](/docs/agents#tools) で、MCP サーバーをツールとして有効にします。 + +```json title="opencode.json" {11, 14-18} +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "my-mcp": { + "type": "local", + "command": ["bun", "x", "my-mcp-command"], + "enabled": true + } + }, + "tools": { + "my-mcp*": false + }, + "agent": { + "my-agent": { + "tools": { + "my-mcp*": true + } + } + } +} +``` + +--- + +#### グロブパターン + +グロブパターンでは、単純な正規表現のグロブパターンを使用します。 + +- `*` は 0 個以上の任意の文字に一致します (例: `"my-mcp*"` は `my-mcp_search`、`my-mcp_list` などに一致します)。 +- `?` は 1 つの文字に正確に一致します +- 他のすべての文字は文字通り一致します + +:::note +MCP サーバーツールはサーバー名をプレフィックスとして登録されているため、サーバーのすべてのツールを無効にするには、次のコマンドを使用するだけです。 + +``` +"mymcpservername_*": false +``` + +::: + +## 例 + +以下に、一般的な MCP サーバーの例をいくつか示します。他のサーバーを文書化したい場合は、PR を送信できます。 + +--- + +### Sentry + +[Sentry MCP サーバー](https://mcp.sentry.dev) を追加して、Sentry プロジェクトや問題と対話します。 + +```json title="opencode.json" {4-8} +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "sentry": { + "type": "remote", + "url": "https://mcp.sentry.dev/mcp", + "oauth": {} + } + } +} +``` + +設定を追加した後、Sentry で認証します。 + +```bash +opencode mcp auth sentry +``` + +これにより、ブラウザウィンドウが開き、OAuth フローが完了し、OpenCode が Sentry アカウントに接続されます。 + +認証が完了すると、プロンプトで Sentry ツールを使用して、問題、プロジェクト、エラーデータをクエリできるようになります。 + +```txt "use sentry" +Show me the latest unresolved issues in my project. use sentry +``` + +--- + +### Context7 + +ドキュメントを検索するために [Context7 MCP server](https://github.com/upstash/context7) を追加します。 + +```json title="opencode.json" {4-7} +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "context7": { + "type": "remote", + "url": "https://mcp.context7.com/mcp" + } + } +} +``` + +無料アカウントにサインアップしている場合は、API キーを使用して、より高いレート制限を取得できます。 + +```json title="opencode.json" {7-9} +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "context7": { + "type": "remote", + "url": "https://mcp.context7.com/mcp", + "headers": { + "CONTEXT7_API_KEY": "{env:CONTEXT7_API_KEY}" + } + } + } +} +``` + +ここでは、`CONTEXT7_API_KEY` 環境変数が設定されていることを前提としています。 + +Context7 MCP サーバーを使用するには、プロンプトに `use context7` を追加します。 + +```txt "use context7" +Configure a Cloudflare Worker script to cache JSON API responses for five minutes. use context7 +``` + +あるいは、次のようなものを [AGENTS.md](/docs/rules/) に追加します。 + +```md title="AGENTS.md" +When you need to search docs, use `context7` tools. +``` + +--- + +### Grep by Vercel + +GitHub 上のコードスニペットを検索するには、[Grep by Vercel](https://grep.app) MCP サーバーを追加します。 + +```json title="opencode.json" {4-7} +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "gh_grep": { + "type": "remote", + "url": "https://mcp.grep.app" + } + } +} +``` + +MCP サーバーに `gh_grep` という名前を付けたので、プロンプトに `use the gh_grep tool` を追加して、エージェントにそれを使用させることができます。 + +```txt "use the gh_grep tool" +What's the right way to set a custom domain in an SST Astro component? use the gh_grep tool +``` + +あるいは、次のようなものを [AGENTS.md](/docs/rules/) に追加します。 + +```md title="AGENTS.md" +If you are unsure how to do something, use `gh_grep` to search code examples from GitHub. +``` + `enabled` を `false` に設定してサーバーを無効にすることもできます。これは、サーバーを構成から削除せずに一時的に無効にする場合に便利です。 --- @@ -66,7 +534,7 @@ MCP サーバーは、`mcp` の下の [OpenCode Config](https://opencode.ai/docs --- -## Local +## ローカル MCP オブジェクト内の `type` から `"local"` を使用してローカル MCP サーバーを追加します。 @@ -265,7 +733,7 @@ opencode mcp logout my-oauth-server #### OAuth オプション -| Option | Type | Description | +| オプション | タイプ | 説明 | | -------------- | --------------- | -------------------------------------------------------------------------------- | | `oauth` | Object \| false | OAuth config object, or `false` to disable OAuth auto-detection. | | `clientId` | String | OAuth client ID. If not provided, dynamic client registration will be attempted. | diff --git a/packages/web/src/content/docs/ja/models.mdx b/packages/web/src/content/docs/ja/models.mdx index d2617a7f8..caa7b8179 100644 --- a/packages/web/src/content/docs/ja/models.mdx +++ b/packages/web/src/content/docs/ja/models.mdx @@ -3,7 +3,7 @@ title: モデル description: LLM プロバイダーとモデルを構成します。 --- -OpenCode は [AI SDK](https://ai-sdk.dev/) および [Models.dev](https://models.dev) を使用して **75 以上の LLM プロバイダー** をサポートし、ローカル モデルの実行をサポートします。 +OpenCode は [AI SDK](https://ai-sdk.dev/) および [Models.dev](https://models.dev) を使用して **75 以上の LLM プロバイダー** をサポートし、ローカルモデルの実行をサポートします。 --- @@ -15,7 +15,7 @@ OpenCode は [AI SDK](https://ai-sdk.dev/) および [Models.dev](https://models --- -## モデルを選択してください +## モデルの選択 プロバイダーを構成したら、次のように入力して必要なモデルを選択できます。 @@ -25,7 +25,7 @@ OpenCode は [AI SDK](https://ai-sdk.dev/) および [Models.dev](https://models --- -## 推奨機種 +## 推奨モデル たくさんのモデルがあり、毎週のように新しいモデルが登場します。 @@ -45,10 +45,9 @@ OpenCode は [AI SDK](https://ai-sdk.dev/) および [Models.dev](https://models --- -## デフォルトを設定する +## デフォルトの設定 -これらのいずれかをデフォルトのモデルとして設定するには、`model` キーを -OpenCodeの設定。 +これらのいずれかをデフォルトのモデルとして設定するには、`model` キーを OpenCode の設定に追加します。 ```json title="opencode.json" {3} { @@ -63,7 +62,7 @@ OpenCodeの設定。 --- -## モデルの構成 +## モデルの設定 config を通じてモデルのオプションをグローバルに設定できます。 @@ -100,11 +99,11 @@ config を通じてモデルのオプションをグローバルに設定でき ``` ここでは、2 つの組み込みモデル (`gpt-5` プロバイダー経由でアクセスする場合は `openai`、`claude-sonnet-4-20250514` プロバイダー経由でアクセスする場合は `anthropic`) のグローバル設定を構成しています。 -組み込みプロバイダーとモデル名は、[Models.dev](https://models.dev). +組み込みプロバイダーとモデル名は、[Models.dev](https://models.dev) で確認できます。 -使用しているエージェントに対してこれらのオプションを構成することもできます。ここでエージェント設定はグローバル オプションをオーバーライドします。 [詳細はこちら](/docs/agents/#additional)。 +使用しているエージェントに対してこれらのオプションを構成することもできます。ここでエージェント設定はグローバルオプションをオーバーライドします。 [詳細はこちら](/docs/agents/#additional)。 -組み込みバリアントを拡張するカスタム バリアントを定義することもできます。バリアントを使用すると、重複したエントリを作成せずに、同じモデルに対して異なる設定を構成できます。 +組み込みバリアントを拡張するカスタムバリアントを定義することもできます。バリアントを使用すると、重複したエントリを作成せずに、同じモデルに対して異なる設定を構成できます。 ```jsonc title="opencode.jsonc" {6-21} { @@ -134,7 +133,7 @@ config を通じてモデルのオプションをグローバルに設定でき --- -## バリエーション +## バリアント 多くのモデルは、異なる構成の複数のバリアントをサポートしています。 OpenCode には、一般的なプロバイダーのデフォルトのバリアントが組み込まれています。 @@ -194,7 +193,7 @@ OpenCode には、多くのプロバイダーのデフォルトのバリアン } ``` -### サイクルのバリエーション +### バリアントの切り替え キーバインド `variant_cycle` を使用すると、バリアントをすばやく切り替えることができます。 [詳細はこちら](/docs/keybinds)。 @@ -204,7 +203,7 @@ OpenCode には、多くのプロバイダーのデフォルトのバリアン OpenCode が起動すると、次の優先順位でモデルがチェックされます。 -1. `--model` または `-m` コマンド ライン フラグ。形式は構成ファイルと同じです: `provider_id/model_id`。 +1. `--model` または `-m` コマンドラインフラグ。形式は構成ファイルと同じです: `provider_id/model_id`。 2. OpenCode 構成内のモデルのリスト。 @@ -219,4 +218,4 @@ OpenCode が起動すると、次の優先順位でモデルがチェックさ 3. 最後に使用されたモデル。 -4. 内部優先を使用した最初のモデル。 +4. 内部優先順位に基づく最初のモデル。 diff --git a/packages/web/src/content/docs/ja/modes.mdx b/packages/web/src/content/docs/ja/modes.mdx index 5c7f9958d..6e7bc121b 100644 --- a/packages/web/src/content/docs/ja/modes.mdx +++ b/packages/web/src/content/docs/ja/modes.mdx @@ -4,58 +4,58 @@ description: さまざまなユースケースに応じたさまざまなモー --- :::caution -モードは、opencode config の `agent` オプションを通じて設定されるようになりました。の +モードは、OpenCode 設定の `agent` オプションを通じて設定されるようになりました。 `mode` オプションは非推奨になりました。 [詳細はこちら](/docs/agents)。 ::: -Modes のモードを使用すると、さまざまなユースケースに合わせて動作、ツール、プロンプトをカスタマイズできます。 +モードを使用すると、さまざまなユースケースに合わせて動作、ツール、プロンプトをカスタマイズできます。 -**ビルド** と **プラン** という 2 つの組み込みモードが付属しています。カスタマイズできます -これらを使用するか、opencode config を通じて独自の設定を行います。 +**Build** と **Plan** という 2 つの組み込みモードが付属しています。カスタマイズできます +これらを使用するか、OpenCode 設定を通じて独自の設定を行います。 -セッション中にモードを切り替えることも、構成ファイルでモードを構成することもできます。 +セッション中にモードを切り替えることも、設定ファイルでモードを構成することもできます。 --- -## 内蔵 +## 組み込み -opencode には 2 つの組み込みモードが付属しています。 +OpenCode には 2 つの組み込みモードが付属しています。 --- ### Build -ビルドは、すべてのツールが有効になっている **デフォルト** モードです。これは、ファイル操作やシステム コマンドへのフル アクセスが必要な開発作業の標準モードです。 +Build は、すべてのツールが有効になっている **デフォルト** モードです。これは、ファイル操作やシステムコマンドへのフルアクセスが必要な開発作業の標準モードです。 --- ### Plan -計画と分析のために設計された制限付きモード。プラン モードでは、次のツールはデフォルトで無効になっています。 +計画と分析のために設計された制限付きモード。Plan モードでは、次のツールはデフォルトで無効になっています。 - `write` - 新しいファイルを作成できません - `edit` - 計画自体の詳細を示す `.opencode/plans/*.md` にあるファイルを除き、既存のファイルを変更できません - `patch` - パッチを適用できません -- `bash` - shell コマンドを実行できません +- `bash` - シェルコマンドを実行できません このモードは、コードベースに実際の変更を加えずに、AI にコードを分析させたり、変更を提案したり、計画を作成させたい場合に便利です。 --- -## スイッチング +## 切り替え セッション中に _Tab_ キーを使用してモードを切り替えることができます。または、設定された `switch_mode` キーバインド。 -参照: [コードのフォーマット構成については、Formatters](/docs/formatters)。 +参照: [コードのフォーマット設定については、Formatters](/docs/formatters)。 --- -## 設定する +## 設定 組み込みモードをカスタマイズしたり、構成を通じて独自のモードを作成したりできます。モードは次の 2 つの方法で設定できます。 -### JSON構成 +### JSON 設定 -`opencode.json` 構成ファイルでモードを構成します。 +`opencode.json` 設定ファイルでモードを構成します。 ```json title="opencode.json" { @@ -82,7 +82,7 @@ opencode には 2 つの組み込みモードが付属しています。 } ``` -### Markdown構成 +### Markdown 設定 Markdown ファイルを使用してモードを定義することもできます。それらを次の場所に置きます。 @@ -111,13 +111,13 @@ Provide constructive feedback without making direct changes. Markdown ファイル名はモード名になります (例: `review.md` は `review` モードを作成します)。 -これらの構成オプションを詳しく見てみましょう。 +これらの設定オプションを詳しく見てみましょう。 --- ### モデル -`model` 設定を使用して、このモードのデフォルト モデルをオーバーライドします。さまざまなタスクに最適化されたさまざまなモデルを使用する場合に役立ちます。たとえば、計画にはより高速なモデルを、実装にはより有能なモデルを使用します。 +`model` 設定を使用して、このモードのデフォルトモデルをオーバーライドします。さまざまなタスクに最適化されたさまざまなモデルを使用する場合に役立ちます。たとえば、計画にはより高速なモデルを、実装にはより有能なモデルを使用します。 ```json title="opencode.json" { @@ -133,7 +133,7 @@ Markdown ファイル名はモード名になります (例: `review.md` は `re ### 温度 -`temperature` 構成を使用して、AI の応答のランダム性と創造性を制御します。値が低いほど、応答はより集中的かつ決定的になりますが、値が高いほど、創造性と変動性が高まります。 +`temperature` 設定を使用して、AI の応答のランダム性と創造性を制御します。値が低いほど、応答はより集中的かつ決定的になりますが、値が高いほど、創造性と変動性が高まります。 ```json title="opencode.json" { @@ -172,13 +172,13 @@ Markdown ファイル名はモード名になります (例: `review.md` は `re } ``` -温度が指定されていない場合、opencode はモデル固有のデフォルトを使用します (通常、ほとんどのモデルでは 0、Qwen モデルでは 0.55)。 +温度が指定されていない場合、OpenCode はモデル固有のデフォルトを使用します (通常、ほとんどのモデルでは 0、Qwen モデルでは 0.55)。 --- ### プロンプト -`prompt` 構成を使用して、このモードのカスタム システム プロンプト ファイルを指定します。プロンプト ファイルには、モードの目的に固有の指示が含まれている必要があります。 +`prompt` 設定を使用して、このモードのカスタムシステムプロンプトファイルを指定します。プロンプトファイルには、モードの目的に固有の指示が含まれている必要があります。 ```json title="opencode.json" { @@ -190,8 +190,7 @@ Markdown ファイル名はモード名になります (例: `review.md` は `re } ``` -このパスは、構成ファイルが配置されている場所に対する相対パスです。したがって、これは次の場合に機能します -グローバルなopencode構成とプロジェクト固有の構成の両方。 +このパスは、設定ファイルが配置されている場所に対する相対パスです。したがって、これはグローバルな OpenCode 設定とプロジェクト固有の設定の両方で機能します。 --- @@ -226,7 +225,7 @@ Markdown ファイル名はモード名になります (例: `review.md` は `re | ツール | 説明 | | ----------- | ------------------------------ | -| `bash` | shell コマンドを実行する | +| `bash` | シェルコマンドを実行する | | `edit` | 既存のファイルを変更する | | `write` | 新しいファイルを作成する | | `read` | ファイルの内容を読み取る | @@ -242,9 +241,9 @@ Markdown ファイル名はモード名になります (例: `review.md` は `re ## カスタムモード -構成に追加することで、独自のカスタム モードを作成できます。両方のアプローチを使用した例を次に示します。 +構成に追加することで、独自のカスタムモードを作成できます。両方のアプローチを使用した例を次に示します。 -### JSON設定の使用 +### JSON 設定の使用 ```json title="opencode.json" {4-14} { @@ -267,7 +266,7 @@ Markdown ファイル名はモード名になります (例: `review.md` は `re ### Markdown ファイルの使用 -モード ファイルをプロジェクト固有モードの場合は `.opencode/modes/` に、グローバル モードの場合は `~/.config/opencode/modes/` に作成します。 +モードファイルをプロジェクト固有モードの場合は `.opencode/modes/` に、グローバルモードの場合は `~/.config/opencode/modes/` に作成します。 ```markdown title=".opencode/modes/debug.md" --- @@ -321,10 +320,10 @@ Priorities: さまざまなモードの一般的な使用例をいくつか示します。 -- **ビルド モード**: すべてのツールを有効にした完全な開発作業 +- **ビルドモード**: すべてのツールを有効にした完全な開発作業 - **計画モード**: 変更を加えずに分析および計画を立てる -- **レビュー モード**: 読み取り専用アクセスとドキュメント ツールによるコード レビュー -- **デバッグ モード**: bash および読み取りツールを有効にして調査に重点を置きます -- **ドキュメント モード**: ファイル操作を使用してドキュメントを作成しますが、システム コマンドは使用しません +- **レビューモード**: 読み取り専用アクセスとドキュメントツールによるコードレビュー +- **デバッグモード**: bash および読み取りツールを有効にして調査に重点を置きます +- **ドキュメントモード**: ファイル操作を使用してドキュメントを作成しますが、システムコマンドは使用しません また、さまざまなユースケースにさまざまなモデルが適していることがわかるかもしれません。 diff --git a/packages/web/src/content/docs/ja/network.mdx b/packages/web/src/content/docs/ja/network.mdx index 4dd2cfb86..fc9eb3ff0 100644 --- a/packages/web/src/content/docs/ja/network.mdx +++ b/packages/web/src/content/docs/ja/network.mdx @@ -3,7 +3,7 @@ title: ネットワーク description: プロキシとカスタム証明書を構成します。 --- -OpenCode は、エンタープライズ ネットワーク環境の標準プロキシ環境変数とカスタム証明書をサポートしています。 +OpenCode は、エンタープライズネットワーク環境の標準プロキシ環境変数とカスタム証明書をサポートしています。 --- @@ -23,15 +23,15 @@ export NO_PROXY=localhost,127.0.0.1 ``` :::caution -TUI はローカル HTTP サーバーと通信します。ルーティング ループを防ぐには、この接続のプロキシをバイパスする必要があります。 +TUI はローカル HTTP サーバーと通信します。ルーティングループを防ぐには、この接続のプロキシをバイパスする必要があります。 ::: -[CLI flags](/docs/cli#run) を使用して、サーバーのポートとホスト名を構成できます。 +[CLI フラグ](/docs/cli#run) を使用して、サーバーのポートとホスト名を構成できます。 --- -### 認証する +### 認証 -プロキシで基本認証が必要な場合は、URL に資格情報を含めます。 +プロキシで基本認証が必要な場合は、URL に認証情報を含めます。 ```bash export HTTPS_PROXY=http://username:password@proxy.example.com:8080 diff --git a/packages/web/src/content/docs/ja/permissions.mdx b/packages/web/src/content/docs/ja/permissions.mdx index 253093d51..93143f9ca 100644 --- a/packages/web/src/content/docs/ja/permissions.mdx +++ b/packages/web/src/content/docs/ja/permissions.mdx @@ -3,9 +3,9 @@ title: 権限 description: どのアクションの実行に承認が必要かを制御します。 --- -OpenCode は `permission` 構成を使用して、特定のアクションを自動的に実行するか、プロンプトを表示するか、ブロックするかを決定します。 +OpenCode は `permission` 設定を使用して、特定のアクションを自動的に実行するか、プロンプトを表示するか、ブロックするかを決定します。 -`v1.1.1` の時点で、従来の `tools` ブール値設定は非推奨となり、`permission` にマージされました。古い `tools` 構成は、下位互換性のために引き続きサポートされています。 +`v1.1.1` 現在、従来の `tools` ブール値設定は非推奨となり、`permission` にマージされました。古い `tools` 設定は、下位互換性のために引き続きサポートされています。 --- @@ -19,7 +19,7 @@ OpenCode は `permission` 構成を使用して、特定のアクションを自 --- -## 構成 +## 設定 権限をグローバルに (`*` を使用して) 設定し、特定のツールをオーバーライドできます。 @@ -68,19 +68,19 @@ OpenCode は `permission` 構成を使用して、特定のアクションを自 } ``` -ルールはパターン マッチによって評価され、**最後に一致したルールが優先されます**。一般的なパターンは、キャッチオール `"*"` ルールを最初に置き、その後により具体的なルールを置くことです。 +ルールはパターンマッチによって評価され、**最後に一致したルールが優先されます**。一般的なパターンは、キャッチオール `"*"` ルールを最初に置き、その後により具体的なルールを置くことです。 ### ワイルドカード -許可パターンでは、単純なワイルドカード マッチングを使用します。 +許可パターンでは、単純なワイルドカードマッチングを使用します。 - `*` は 0 個以上の任意の文字と一致します - `?` は 1 つの文字に正確に一致します - 他のすべての文字は文字通り一致します -### ホームディレクトリの拡張 +### ホームディレクトリの展開 -パターンの先頭で `~` または `$HOME` を使用して、ホーム ディレクトリを参照できます。これは、[`external_directory`](#external-directories) ルールに特に役立ちます。 +パターンの先頭で `~` または `$HOME` を使用して、ホームディレクトリを参照できます。これは、[`external_directory`](#external-directories) ルールに特に役立ちます。 - `~/projects/*` -> `/Users/username/projects/*` - `$HOME/projects/*` -> `/Users/username/projects/*` @@ -90,7 +90,7 @@ OpenCode は `permission` 構成を使用して、特定のアクションを自 `external_directory` を使用して、OpenCode が開始された作業ディレクトリの外部のパスに触れるツール呼び出しを許可します。これは、パスを入力として受け取るすべてのツール (`read`、`edit`、`list`、`glob`、`grep`、および多くの `bash` コマンドなど) に適用されます。 -ホーム拡張 (`~/...` など) は、パターンの記述方法にのみ影響します。外部パスは現在のワークスペースの一部にはならないため、作業ディレクトリの外部のパスも `external_directory` 経由で許可する必要があります。 +ホーム展開 (`~/...` など) は、パターンの記述方法にのみ影響します。外部パスは現在のワークスペースの一部にはならないため、作業ディレクトリの外部のパスも `external_directory` 経由で許可する必要があります。 たとえば、これにより、`~/projects/personal/` の下にあるすべてのものへのアクセスが許可されます。 @@ -127,14 +127,14 @@ OpenCode は `permission` 構成を使用して、特定のアクションを自 ## 利用可能な権限 -OpenCode のアクセス許可は、ツール名に加えて、いくつかの安全対策によってキー化されます。 +OpenCode の権限は、ツール名に加えて、いくつかの安全対策によってキー化されます。 - `read` — ファイルの読み取り (ファイルパスと一致) - `edit` — すべてのファイル変更 (`edit`、`write`、`patch`、`multiedit` をカバー) - `glob` — ファイルのグロビング (グロブパターンと一致) - `grep` — コンテンツ検索 (正規表現パターンと一致) -- `list` — ディレクトリ内のファイルのリスト (ディレクトリ パスと一致) -- `bash` — shell コマンドの実行 (`git status --porcelain` などの解析されたコマンドと一致します) +- `list` — ディレクトリ内のファイルのリスト (ディレクトリパスと一致) +- `bash` — シェルコマンドの実行 (`git status --porcelain` などの解析されたコマンドと一致します) - `task` — サブエージェントの起動 (サブエージェントのタイプと一致) - `skill` — スキルをロードしています（スキル名と一致します） - `lsp` — LSP クエリの実行 (現在は非細分性) @@ -169,7 +169,7 @@ OpenCode のアクセス許可は、ツール名に加えて、いくつかの --- -## 「尋ねる」ということ +## 承認の要求 OpenCode が承認を求めるプロンプトを表示すると、UI は 3 つの結果を提供します。 @@ -177,16 +177,63 @@ OpenCode が承認を求めるプロンプトを表示すると、UI は 3 つ - `always` — 提案されたパターンに一致する今後のリクエストを承認します（現在の OpenCode セッションの残りの部分） - `reject` — リクエストを拒否します -`always` が承認するパターンのセットは、ツールによって提供されます (たとえば、bash の承認では通常、`git status*` のような安全なコマンド プレフィックスがホワイトリストに登録されます)。 +`always` が承認するパターンのセットは、ツールによって提供されます (たとえば、bash の承認では通常、`git status*` のような安全なコマンドプレフィックスがホワイトリストに登録されます)。 --- ## エージェント -エージェントごとに権限をオーバーライドできます。エージェントの権限はグローバル設定とマージされ、エージェント ルールが優先されます。 [エージェントの権限について詳しくは、](/docs/agents#permissions) をご覧ください。 +エージェントごとに権限をオーバーライドできます。エージェントの権限はグローバル設定とマージされ、エージェントルールが優先されます。 [エージェントの権限について詳しくは、](/docs/agents#permissions) をご覧ください。 :::note -パターン マッチングの詳細な例については、上記の[粒度ルール (オブジェクト構文)](#granular-rules-object-syntax)セクションを参照してください。 +パターンマッチングの詳細な例については、上記の[詳細なルール (オブジェクト構文)](#detailed-rules-object-syntax)セクションを参照してください。 +::: + +```json title="opencode.json" +{ + "$schema": "https://opencode.ai/config.json", + "permission": { + "bash": { + "*": "ask", + "git *": "allow", + "git commit *": "deny", + "git push *": "deny", + "grep *": "allow" + } + }, + "agent": { + "build": { + "permission": { + "bash": { + "*": "ask", + "git *": "allow", + "git commit *": "ask", + "git push *": "deny", + "grep *": "allow" + } + } + } + } +} +``` + +Markdown でエージェントの権限を構成することもできます。 + +```markdown title="~/.config/opencode/agents/review.md" +--- +description: Code review without edits +mode: subagent +permission: + edit: deny + bash: ask + webfetch: deny +--- + +Only analyze code and suggest changes. +``` + +:::tip +引数のあるコマンドにはパターンマッチングを使用します。 `"grep *"` は `grep pattern file.txt` を許可しますが、`"grep"` だけではブロックされます。 `git status` のようなコマンドはデフォルトの動作で機能しますが、引数を渡すときに明示的な許可 (`"git status *"` など) が必要です。 ::: ```json title="opencode.json" diff --git a/packages/web/src/content/docs/ja/plugins.mdx b/packages/web/src/content/docs/ja/plugins.mdx index f718992e5..39fc1dda2 100644 --- a/packages/web/src/content/docs/ja/plugins.mdx +++ b/packages/web/src/content/docs/ja/plugins.mdx @@ -9,7 +9,7 @@ description: OpenCode を拡張する独自のプラグインを作成します --- -## プラグインを使用する +## プラグインの使用 プラグインをロードするには 2 つの方法があります。 @@ -17,7 +17,7 @@ description: OpenCode を拡張する独自のプラグインを作成します ### ローカルファイルから -JavaScript または TypeScript ファイルをプラグイン ディレクトリに配置します。 +JavaScript または TypeScript ファイルをプラグインディレクトリに配置します。 - `.opencode/plugins/` - プロジェクトレベルのプラグイン - `~/.config/opencode/plugins/` - グローバルプラグイン @@ -26,9 +26,9 @@ JavaScript または TypeScript ファイルをプラグイン ディレクト --- -### npmから +### npm から -構成ファイルで npm パッケージを指定します。 +設定ファイルで npm パッケージを指定します。 ```json title="opencode.json" { @@ -43,11 +43,11 @@ JavaScript または TypeScript ファイルをプラグイン ディレクト --- -### プラグインのインストール方法 +### プラグインのインストール **npm プラグイン** は、起動時に Bun を使用して自動的にインストールされます。パッケージとその依存関係は `~/.cache/opencode/node_modules/` にキャッシュされます。 -**ローカル プラグイン**は、プラグイン ディレクトリから直接ロードされます。外部パッケージを使用するには、config ディレクトリ内に `package.json` を作成するか ([Dependency](#dependencies) を参照)、プラグインを npm に公開して [config](/docs/config#plugins) に追加する] 必要があります。 +**ローカルプラグイン**は、プラグインディレクトリから直接ロードされます。外部パッケージを使用するには、config ディレクトリ内に `package.json` を作成するか ([Dependency](#dependencies) を参照)、プラグインを npm に公開して [config](/docs/config#plugins) に追加する必要があります。 --- @@ -55,25 +55,25 @@ JavaScript または TypeScript ファイルをプラグイン ディレクト プラグインはすべてのソースからロードされ、すべてのフックが順番に実行されます。ロード順序は次のとおりです。 -1. グローバル構成 (`~/.config/opencode/opencode.json`) -2. プロジェクト構成 (`opencode.json`) +1. グローバル設定 (`~/.config/opencode/opencode.json`) +2. プロジェクト設定 (`opencode.json`) 3. グローバルプラグインディレクトリ (`~/.config/opencode/plugins/`) 4. プロジェクトプラグインディレクトリ (`.opencode/plugins/`) -同じ名前とバージョンを持つ重複した npm パッケージは 1 回ロードされます。ただし、似た名前のローカル プラグインと npm プラグインは両方とも別々にロードされます。 +同じ名前とバージョンを持つ重複した npm パッケージは 1 回ロードされます。ただし、似た名前のローカルプラグインと npm プラグインは両方とも別々にロードされます。 --- ## プラグインを作成する -プラグインは、1 つ以上のプラグインをエクスポートする **JavaScript/TypeScript モジュール**です -機能。各関数はコンテキスト オブジェクトを受け取り、フック オブジェクトを返します。 +プラグインは、1 つ以上のプラグインをエクスポートする **JavaScript/TypeScript モジュール**です。 +各関数はコンテキストオブジェクトを受け取り、フックオブジェクトを返します。 --- ### 依存関係 -ローカル プラグインとカスタム ツールは外部の npm パッケージを使用できます。必要な依存関係を含む `package.json` を config ディレクトリに追加します。 +ローカルプラグインとカスタムツールは外部の npm パッケージを使用できます。必要な依存関係を含む `package.json` を config ディレクトリに追加します。 ```json title=".opencode/package.json" { @@ -118,14 +118,14 @@ export const MyPlugin = async ({ project, client, $, directory, worktree }) => { - `project`: 現在のプロジェクト情報。 - `directory`: 現在の作業ディレクトリ。 - `worktree`: git ワークツリーのパス。 -- `client`: AI と対話するためのopencode SDK クライアント。 -- `$`: Bun の [コマンドを実行するためのshell API](https://bun.com/docs/runtime/shell)。 +- `client`: AI と対話するための OpenCode SDK クライアント。 +- `$`: Bun の [コマンドを実行するためのシェル API](https://bun.com/docs/runtime/shell)。 --- ### TypeScript のサポート -TypeScript プラグインの場合、プラグイン パッケージから型をインポートできます。 +TypeScript プラグインの場合、プラグインパッケージから型をインポートできます。 ```ts title="my-plugin.ts" {1} import type { Plugin } from "@opencode-ai/plugin" @@ -188,11 +188,11 @@ export const MyPlugin: Plugin = async ({ project, client, $, directory, worktree - `session.status` - `session.updated` -#### Todoイベント +#### ToDo イベント - `todo.updated` -#### shellイベント +#### シェルイベント - `shell.env` @@ -211,7 +211,7 @@ export const MyPlugin: Plugin = async ({ project, client, $, directory, worktree ## 例 -ここでは、opencodeを拡張するために使用できるプラグインの例をいくつか示します。 +ここでは、OpenCode を拡張するために使用できるプラグインの例をいくつか示します。 --- @@ -235,14 +235,14 @@ export const NotificationPlugin = async ({ project, client, $, directory, worktr macOS 上で AppleScript を実行するために `osascript` を使用しています。ここでは通知を送信するために使用しています。 :::note -OpenCode デスクトップ アプリを使用している場合は、応答の準備ができたとき、またはセッション エラーが発生したときにシステム通知を自動的に送信できます。 +OpenCode デスクトップアプリを使用している場合は、応答の準備ができたとき、またはセッションエラーが発生したときにシステム通知を自動的に送信できます。 ::: --- -### .env 保護 +### .env の保護 -opencode が `.env` ファイルを読み取らないようにします。 +OpenCode が `.env` ファイルを読み取らないようにします。 ```javascript title=".opencode/plugins/env-protection.js" export const EnvProtection = async ({ project, client, $, directory, worktree }) => { @@ -260,7 +260,7 @@ export const EnvProtection = async ({ project, client, $, directory, worktree }) ### 環境変数を挿入する -すべてのshell 実行 (AI ツールとユーザーterminal) に環境変数を挿入します。 +すべてのシェル実行 (AI ツールとユーザーターミナル) に環境変数を挿入します。 ```javascript title=".opencode/plugins/inject-env.js" export const InjectEnvPlugin = async () => { @@ -277,7 +277,7 @@ export const InjectEnvPlugin = async () => { ### カスタムツール -プラグインはopencodeにカスタム ツールを追加することもできます。 +プラグインは OpenCode にカスタムツールを追加することもできます。 ```ts title=".opencode/plugins/custom-tools.ts" import { type Plugin, tool } from "@opencode-ai/plugin" @@ -300,13 +300,13 @@ export const CustomToolsPlugin: Plugin = async (ctx) => { } ``` -`tool` ヘルパーは、opencode が呼び出すことができるカスタム ツールを作成します。 Zod スキーマ関数を受け取り、次のようなツール定義を返します。 +`tool` ヘルパーは、OpenCode が呼び出すことができるカスタムツールを作成します。 Zod スキーマ関数を受け取り、次のようなツール定義を返します。 - `description`: ツールの機能 - `args`: ツールの引数の Zod スキーマ - `execute`: ツールが呼び出されたときに実行される関数 -カスタム ツールは、組み込みツールと並行してopencodeに使用できます。 +カスタムツールは、組み込みツールと並行して OpenCode で使用できます。 --- diff --git a/packages/web/src/content/docs/ja/providers.mdx b/packages/web/src/content/docs/ja/providers.mdx index b54a8bf6d..2602f8ef2 100644 --- a/packages/web/src/content/docs/ja/providers.mdx +++ b/packages/web/src/content/docs/ja/providers.mdx @@ -6,23 +6,23 @@ description: OpenCode で 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 プロバイダー** をサポートし、ローカル モデルの実行をサポートします。 +OpenCode は [AI SDK](https://ai-sdk.dev/) および [Models.dev](https://models.dev) を使用して **75 以上の LLM プロバイダー** をサポートし、ローカルモデルの実行をサポートします。 プロバイダーを追加するには、次のことを行う必要があります。 1. `/connect` コマンドを使用して、プロバイダーの API キーを追加します。 -2. OpenCode 構成でプロバイダーを構成します。 +2. OpenCode 設定でプロバイダーを構成します。 --- -### 資格 +### 認証情報 `/connect` コマンドを使用してプロバイダーの API キーを追加すると、それらは保存されます `~/.local/share/opencode/auth.json`で。 --- -### 構成 +### 設定 OpenCode の `provider` セクションを通じてプロバイダーをカスタマイズできます。 config. @@ -31,7 +31,7 @@ config. #### Base URL -`baseURL` オプションを設定することで、任意のプロバイダーのベース URL をカスタマイズできます。これは、プロキシ サービスまたはカスタム エンドポイントを使用する場合に便利です。 +`baseURL` オプションを設定することで、任意のプロバイダーのベース URL をカスタマイズできます。これは、プロキシサービスまたはカスタムエンドポイントを使用する場合に便利です。 ```json title="opencode.json" {6} { @@ -57,7 +57,7 @@ OpenCode で適切に動作することがテストおよび検証されてい 初めての方は、OpenCode Zen から始めることをお勧めします。 ::: -1. TUI で `/connect` コマンドを実行し、opencode を選択して、[opencode.ai/auth](https://opencode.ai/auth). +1. TUI で `/connect` コマンドを実行し、opencode を選択して、[opencode.ai/auth](https://opencode.ai/auth) で認証します。 ```txt /connect @@ -126,7 +126,7 @@ OpenCode で適切に動作することがテストおよび検証されてい OpenCode で Amazon Bedrock を使用するには: -1. Amazon Bedrock コンソールの **モデル カタログ** に移動してリクエストします。 +1. Amazon Bedrock コンソールの **モデルカタログ** に移動してリクエストします。 必要なモデルにアクセスします。 :::tip @@ -135,7 +135,7 @@ Amazon Bedrock で必要なモデルにアクセスできる必要がありま 2. **次のいずれかの方法を使用して認証を構成します**。 - #### 環境変数 (クイック スタート) + #### 環境変数 (クイックスタート) opencode の実行中に次の環境変数のいずれかを設定します。 @@ -159,7 +159,7 @@ opencode の実行中に次の環境変数のいずれかを設定します。 #### 設定ファイル (推奨) -プロジェクト固有の構成または永続的な構成の場合は、`opencode.json` を使用します。 +プロジェクト固有の設定または永続的な設定の場合は、`opencode.json` を使用します。 ```json title="opencode.json" { @@ -179,10 +179,10 @@ opencode の実行中に次の環境変数のいずれかを設定します。 - `region` - AWS リージョン (例: `us-east-1`、`eu-west-1`) - `profile` - `~/.aws/credentials` からの AWS 名前付きプロファイル -- `endpoint` - VPC エンドポイントのカスタム エンドポイント URL (汎用 `baseURL` オプションのエイリアス) +- `endpoint` - VPC エンドポイントのカスタムエンドポイント URL (汎用 `baseURL` オプションのエイリアス) :::tip -構成ファイルのオプションは環境変数より優先されます。 +設定ファイルのオプションは環境変数より優先されます。 ::: #### 上級: VPC エンドポイント @@ -210,17 +210,17 @@ Bedrock の VPC エンドポイントを使用している場合: #### 認証方法 -- **`AWS_ACCESS_KEY_ID` / `AWS_SECRET_ACCESS_KEY`**: IAM ユーザーを作成し、AWS コンソールでアクセス キーを生成します。 +- **`AWS_ACCESS_KEY_ID` / `AWS_SECRET_ACCESS_KEY`**: IAM ユーザーを作成し、AWS コンソールでアクセスキーを生成します。 - **`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 ID トークン (EKS IRSA)、インスタンス メタデータ +2. **AWS 認証情報チェーン** - プロファイル、アクセスキー、共有認証情報、IAM ロール、Web ID トークン (EKS IRSA)、インスタンスメタデータ :::note ベアラー トークンが (`/connect` または `AWS_BEARER_TOKEN_BEDROCK` 経由で) 設定されると、設定されたプロファイルを含むすべての AWS 認証情報方法よりも優先されます。 @@ -275,28 +275,28 @@ Amazon Bedrock は次の認証優先度を使用します。 └ ``` -3. これで、`/models` コマンドを使用すると、すべての人智モデルが利用できるようになります。 +3. これで、`/models` コマンドを使用すると、すべての Anthropic モデルが利用できるようになります。 ```txt /models ``` :::info -OpenCode での Claude Pro/Max サブスクリプションの使用は、[Anthropic](https://anthropic.com). +OpenCode での Claude Pro/Max サブスクリプションの使用は、[Anthropic](https://anthropic.com) によって正式に許可されていませんが、一般的に機能します。 ::: ##### APIキーの使用 -Pro/Max サブスクリプションをお持ちでない場合は、[**API キーの作成**] を選択することもできます。また、ブラウザが開き、Anthropic にログインするよう求められ、terminal に貼り付けるコードが表示されます。 +Pro/Max サブスクリプションをお持ちでない場合は、[**API キーの作成**] を選択することもできます。また、ブラウザが開き、Anthropic にログインするよう求められ、ターミナルに貼り付けるコードが表示されます。 -または、すでに API キーをお持ちの場合は、[**API キーを手動で入力**] を選択してterminal に貼り付けることができます。 +または、すでに API キーをお持ちの場合は、[**API キーを手動で入力**] を選択してターミナルに貼り付けることができます。 --- ### Azure OpenAI :::note -「申し訳ありませんが、そのリクエストには対応できません」エラーが発生した場合は、Azure リソースのコンテンツ フィルターを **DefaultV2** から **Default** に変更してみてください。 +「申し訳ありませんが、そのリクエストには対応できません」エラーが発生した場合は、Azure リソースのコンテンツフィルターを **DefaultV2** から **Default** に変更してみてください。 ::: 1. [Azure portal](https://portal.azure.com/) に移動し、**Azure OpenAI** リソースを作成します。必要なものは次のとおりです。 @@ -306,7 +306,7 @@ Pro/Max サブスクリプションをお持ちでない場合は、[**API キ 2. [Azure AI Foundry](https://ai.azure.com/) に移動し、モデルをデプロイします。 :::note -opencodeが正しく動作するには、デプロイメント名がモデル名と一致する必要があります。 +OpenCode が正しく動作するには、デプロイメント名がモデル名と一致する必要があります。 ::: 3. `/connect` コマンドを実行し、**Azure** を検索します。 @@ -353,7 +353,7 @@ opencodeが正しく動作するには、デプロイメント名がモデル名 2. [Azure AI Foundry](https://ai.azure.com/) に移動し、モデルをデプロイします。 :::note -opencodeが正しく動作するには、デプロイメント名がモデル名と一致する必要があります。 +OpenCode が正しく動作するには、デプロイメント名がモデル名と一致する必要があります。 ::: 3. `/connect` コマンドを実行し、**Azure Cognitive Services** を検索します。 @@ -485,7 +485,7 @@ Cloudflare AI Gatewayを使用すると、統合エンドポイントを通じ /models ``` -opencode構成を通じてモデルを追加することもできます。 +OpenCode 設定を通じてモデルを追加することもできます。 ```json title="opencode.json" { @@ -586,7 +586,7 @@ opencode構成を通じてモデルを追加することもできます。 ### Firmware -1. [ファームウェア ダッシュボード](https://app.firmware.ai/signup) に移動し、アカウントを作成し、API キーを生成します。 +1. [ファームウェアダッシュボード](https://app.firmware.ai/signup) に移動し、アカウントを作成し、API キーを生成します。 2. `/connect` コマンドを実行し、**ファームウェア**を検索します。 @@ -640,7 +640,7 @@ opencode構成を通じてモデルを追加することもできます。 ### GitLab Duo -GitLab Duo は、GitLab の Anthropic プロキシを介したネイティブ ツール呼び出し機能を備えた AI を活用したエージェント チャットを提供します。 +GitLab Duo は、GitLab の Anthropic プロキシを介したネイティブツール呼び出し機能を備えた AI を活用したエージェントチャットを提供します。 1. `/connect` コマンドを実行し、GitLab を選択します。 @@ -668,7 +668,7 @@ GitLab Duo は、GitLab の Anthropic プロキシを介したネイティブ 2. **新しいトークンを追加** をクリックします 3. 名前: `OpenCode`、スコープ: `api` 4. トークンをコピーします（`glpat-`で始まる） -5. terminal に入力してください +5. ターミナルに入力してください 6. `/models` コマンドを実行して、利用可能なモデルを確認します。 @@ -676,9 +676,7 @@ GitLab Duo は、GitLab の Anthropic プロキシを介したネイティブ /models ``` -```` - -3 つのクロードベースのモデルが利用可能です。 +3 つの Claude ベースのモデルが利用可能です。 - **duo-chat-haiku-4-5** (デフォルト) - 素早いタスクに対する素早い応答 - **duo-chat-sonnet-4-5** - ほとんどのワークフローでバランスの取れたパフォーマンス @@ -686,24 +684,23 @@ GitLab Duo は、GitLab の Anthropic プロキシを介したネイティブ :::note 必要がない場合は、「GITLAB_TOKEN」環境変数を指定することもできます。 -トークンをopencode認証ストレージに保存します。 +トークンを OpenCode 認証ストレージに保存します。 ::: ##### 自己ホスト型 GitLab :::note[コンプライアンスメモ] -OpenCode は、セッション タイトルの生成などの一部の AI タスクに小規模なモデルを使用します。 -デフォルトでは、Zen によってホストされる gpt-5-nano を使用するように構成されています。 OpenCodeをロックするには +OpenCode は、セッションタイトルの生成などの一部の AI タスクに小規模なモデルを使用します。 +デフォルトでは、Zen によってホストされる gpt-5-nano を使用するように構成されています。 OpenCode をロックするには 自分の GitLab でホストされているインスタンスのみを使用するには、次の行を `opencode.json` ファイル。セッション共有を無効にすることもお勧めします。 ```json { -"$schema": "https://opencode.ai/config.json", -"small_model": "gitlab/duo-chat-haiku-4-5", -"share": "disabled" + "small_model": "gitlab/duo-chat-haiku-4-5", + "share": "disabled" } -```` +``` ::: @@ -755,7 +752,7 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here 詳細については、[opencode-gitlab-auth](https://www.npmjs.com/package/@gitlab/opencode-gitlab-auth) ホームページ。 -##### 構成 +##### 設定 `opencode.json` を通じてカスタマイズします。 @@ -778,7 +775,7 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here ##### GitLab API ツール (オプションですが強く推奨) -GitLab ツール (マージ リクエスト、問題、パイプライン、CI/CD など) にアクセスするには: +GitLab ツール (マージリクエスト、問題、パイプライン、CI/CD など) にアクセスするには: ```json title="opencode.json" { @@ -793,13 +790,13 @@ GitLab ツール (マージ リクエスト、問題、パイプライン、CI/C ### GitHub Copilot -GitHub Copilot サブスクリプションをopencodeで使用するには: +GitHub Copilot サブスクリプションを OpenCode で使用するには: :::note 一部のモデルでは [Pro+] が必要になる場合があります。 subscription](https://github.com/features/copilot/plans) を使用します。 -一部のモデルは、[GitHub Copilot settings](https://docs.github.com/en/copilot/how-tos/use-ai-models/configure-access-to-ai-models#setup-for-individual-use). +一部のモデルは、[GitHub Copilot settings](https://docs.github.com/en/copilot/how-tos/use-ai-models/configure-access-to-ai-models#setup-for-individual-use) で構成する必要があります。 ::: 1. `/connect` コマンドを実行し、GitHub Copilot を検索します。 @@ -817,6 +814,7 @@ subscription](https://github.com/features/copilot/plans) を使用します。 │ │ Enter code: 8F43-6FCF │ + │ └ Waiting for authorization... ``` @@ -843,7 +841,7 @@ Vertex AI API が有効になっている Google Cloud プロジェクトが必 - `GOOGLE_CLOUD_PROJECT`: Google Cloud プロジェクト ID - `VERTEX_LOCATION` (オプション): Vertex AI の領域 (デフォルトは `global`) - 認証 (1 つ選択): - - `GOOGLE_APPLICATION_CREDENTIALS`: サービス アカウントの JSON キー ファイルへのパス + - `GOOGLE_APPLICATION_CREDENTIALS`: サービスアカウントの JSON キーファイルへのパス - gcloud CLI を使用して認証する: `gcloud auth application-default login` opencode の実行中に設定します。 @@ -861,7 +859,7 @@ opencode の実行中に設定します。 ``` :::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` コマンドを実行して、必要なモデルを選択します。 @@ -901,7 +899,7 @@ opencode の実行中に設定します。 ### Hugging Face -[ハグ顔推論プロバイダー ](https://huggingface.co/docs/inference-providers) は、17 を超えるプロバイダーがサポートするオープン モデルへのアクセスを提供します。 +[Hugging Face Inference Provider](https://huggingface.co/docs/inference-providers) は、17 を超えるプロバイダーがサポートするオープンモデルへのアクセスを提供します。 1. [Hugging Face settings](https://huggingface.co/settings/tokens/new?ownUserPermissions=inference.serverless.write&tokenType=fineGrained) に移動して、推論プロバイダーを呼び出す権限を持つトークンを作成します。 @@ -911,7 +909,7 @@ opencode の実行中に設定します。 /connect ``` -3. ハグフェイストークンを入力してください。 +3. Hugging Face トークンを入力してください。 ```txt ┌ API key @@ -955,13 +953,13 @@ opencode の実行中に設定します。 /models ``` -その他のプロバイダーや、キャッシュやレート制限などの高度な機能については、[Helicone ドキュメント ](https://docs.helicone.ai). +その他のプロバイダーや、キャッシュやレート制限などの高度な機能については、[Helicone ドキュメント](https://docs.helicone.ai). -#### オプションの構成 +#### オプションの設定 -opencodeを通じて自動的に構成されていない Helicone の機能またはモデルを見つけた場合は、いつでも自分で構成できます。 +OpenCode を通じて自動的に構成されていない Helicone の機能またはモデルを見つけた場合は、いつでも自分で構成できます。 -これは [Helicone のモデル ディレクトリ ](https://helicone.ai/models) です。追加するモデルの ID を取得するためにこれが必要になります。 +これは [Helicone のモデルディレクトリ](https://helicone.ai/models) です。追加するモデルの ID を取得するためにこれが必要になります。 ```jsonc title="~/.config/opencode/opencode.jsonc" { @@ -978,7 +976,7 @@ opencodeを通じて自動的に構成されていない Helicone の機能ま // Model ID (from Helicone's model directory page) "name": "GPT-4o", // Your own custom name for the model }, - "claude-sonnet-4-20250514": { + "claude-sonnet-4-20250929": { "name": "Claude Sonnet 4", }, }, @@ -989,7 +987,7 @@ opencodeを通じて自動的に構成されていない Helicone の機能ま #### カスタムヘッダー -Helicone は、キャッシュ、ユーザー追跡、セッション管理などの機能のカスタム ヘッダーをサポートしています。 `options.headers` を使用してプロバイダー構成に追加します。 +Helicone は、キャッシュ、ユーザー追跡、セッション管理などの機能のカスタムヘッダーをサポートしています。 `options.headers` を使用してプロバイダー設定に追加します。 ```jsonc title="~/.config/opencode/opencode.jsonc" { @@ -1018,7 +1016,7 @@ Helicone の [Sessions](https://docs.helicone.ai/features/sessions) 機能を使 npm install -g opencode-helicone-session ``` -それを構成に追加します。 +それを設定に追加します。 ```json title="opencode.json" { @@ -1026,16 +1024,16 @@ npm install -g opencode-helicone-session } ``` -プラグインは、リクエストに `Helicone-Session-Id` ヘッダーと `Helicone-Session-Name` ヘッダーを挿入します。 Helicone のセッション ページでは、OpenCode の各会話が個別のセッションとしてリストされています。 +プラグインは、リクエストに `Helicone-Session-Id` ヘッダーと `Helicone-Session-Name` ヘッダーを挿入します。 Helicone のセッションページでは、OpenCode の各会話が個別のセッションとしてリストされています。 ##### 一般的なヘリコーンヘッダー -| ヘッダー | 説明 | -| -------------------------- | ----------------------------------------------------------------------- | -| `Helicone-Cache-Enabled` | 応答キャッシュを有効にする (`true`/`false`) | -| `Helicone-User-Id` | ユーザーごとにメトリクスを追跡する | -| `Helicone-Property-[Name]` | カスタム プロパティを追加します (例: `Helicone-Property-Environment`)。 | -| `Helicone-Prompt-Id` | リクエストをプロンプト バージョンに関連付ける | +| ヘッダー | 説明 | +| -------------------------- | ---------------------------------------------------------------------- | +| `Helicone-Cache-Enabled` | 応答キャッシュを有効にする (`true`/`false`) | +| `Helicone-User-Id` | ユーザーごとにメトリクスを追跡する | +| `Helicone-Property-[Name]` | カスタムプロパティを追加します (例: `Helicone-Property-Environment`)。 | +| `Helicone-Prompt-Id` | リクエストをプロンプトバージョンに関連付ける | 利用可能なすべてのヘッダーについては、[Helicone Header Directory](https://docs.helicone.ai/helicone-headers/header-directory) を参照してください。 @@ -1043,7 +1041,7 @@ npm install -g opencode-helicone-session ### llama.cpp -[llama.cpp の s](https://github.com/ggml-org/llama.cpp) llama-server ユーティリティ] を通じて、ローカル モデルを使用するようにopencodeを構成できます。 +[llama.cpp の s](https://github.com/ggml-org/llama.cpp) llama-server ユーティリティ] を通じて、ローカルモデルを使用するように opencode を構成できます。 ```json title="opencode.json" "llama.cpp" {5, 6, 8, 10-15} { @@ -1074,8 +1072,8 @@ npm install -g opencode-helicone-session - `llama.cpp` はカスタムプロバイダー ID です。これには任意の文字列を指定できます。 - `npm` は、このプロバイダーに使用するパッケージを指定します。ここで、`@ai-sdk/openai-compatible` は OpenAI 互換 API に使用されます。 - `name` は、UI でのプロバイダーの表示名です。 -- `options.baseURL` はローカル サーバーのエンドポイントです。 -- `models` は、モデル ID とその構成のマップです。機種選択リストに機種名が表示されます。 +- `options.baseURL` はローカルサーバーのエンドポイントです。 +- `models` は、モデル ID とその設定のマップです。機種選択リストに機種名が表示されます。 --- @@ -1110,7 +1108,7 @@ IO.NET は、さまざまなユースケースに最適化された 17 のモデ ### LM Studio -LM Studio を通じてローカル モデルを使用するようにopencodeを構成できます。 +LM Studio を通じてローカルモデルを使用するように opencode を構成できます。 ```json title="opencode.json" "lmstudio" {5, 6, 8, 10-14} { @@ -1137,8 +1135,8 @@ LM Studio を通じてローカル モデルを使用するようにopencodeを - `lmstudio` はカスタムプロバイダー ID です。これには任意の文字列を指定できます。 - `npm` は、このプロバイダーに使用するパッケージを指定します。ここで、`@ai-sdk/openai-compatible` は OpenAI 互換 API に使用されます。 - `name` は、UI でのプロバイダーの表示名です。 -- `options.baseURL` はローカル サーバーのエンドポイントです。 -- `models` は、モデル ID とその構成のマップです。機種選択リストに機種名が表示されます。 +- `options.baseURL` はローカルサーバーのエンドポイントです。 +- `models` は、モデル ID とその設定のマップです。機種選択リストに機種名が表示されます。 --- @@ -1225,9 +1223,9 @@ Moonshot AI の Kim K2 を使用するには: --- -### オラマ +### Ollama -Ollama を通じてローカル モデルを使用するようにopencodeを構成できます。 +Ollama を通じてローカルモデルを使用するように opencode を構成できます。 :::tip Ollama は OpenCode 用に自動的に構成できます。詳細については、[Ollama 統合 docs](https://docs.ollama.com/integrations/opencode)」を参照してください。 @@ -1258,8 +1256,8 @@ Ollama は OpenCode 用に自動的に構成できます。詳細については - `ollama` はカスタムプロバイダー ID です。これには任意の文字列を指定できます。 - `npm` は、このプロバイダーに使用するパッケージを指定します。ここで、`@ai-sdk/openai-compatible` は OpenAI 互換 API に使用されます。 - `name` は、UI でのプロバイダーの表示名です。 -- `options.baseURL` はローカル サーバーのエンドポイントです。 -- `models` は、モデル ID とその構成のマップです。機種選択リストに機種名が表示されます。 +- `options.baseURL` はローカルサーバーのエンドポイントです。 +- `models` は、モデル ID とその設定のマップです。機種選択リストに機種名が表示されます。 :::tip ツール呼び出しが機能しない場合は、Ollama の `num_ctx` を増やしてみてください。 16k〜32kあたりから始めてください。 @@ -1292,7 +1290,7 @@ OpenCode で Ollama Cloud を使用するには: └ enter ``` -6. **重要**: OpenCode でクラウド モデルを使用する前に、モデル情報をローカルに取得する必要があります。 +6. **重要**: OpenCode でクラウドモデルを使用する前に、モデル情報をローカルに取得する必要があります。 ```bash ollama pull gpt-oss:20b-cloud @@ -1335,7 +1333,7 @@ OpenCode で Ollama Cloud を使用するには: ##### APIキーの使用 -すでに API キーをお持ちの場合は、**API キーを手動で入力** を選択し、terminal に貼り付けることができます。 +すでに API キーをお持ちの場合は、**API キーを手動で入力** を選択し、ターミナルに貼り付けることができます。 --- @@ -1393,7 +1391,7 @@ OpenCode Zen は、OpenCode チームによって提供される、テストお /models ``` -opencode構成を通じて追加のモデルを追加することもできます。 +OpenCode 設定を通じて追加のモデルを追加することもできます。 ```json title="opencode.json" {6} { @@ -1408,7 +1406,7 @@ opencode構成を通じて追加のモデルを追加することもできます } ``` -5. opencode設定を通じてカスタマイズすることもできます。プロバイダーを指定する例を次に示します。 +5. OpenCode 設定を通じてカスタマイズすることもできます。プロバイダーを指定する例を次に示します。 ```json title="opencode.json" { @@ -1436,10 +1434,10 @@ opencode構成を通じて追加のモデルを追加することもできます SAP AI コアは、統合プラットフォームを通じて、OpenAI、Anthropic、Google、Amazon、Meta、Mistral、AI21 の 40 以上のモデルへのアクセスを提供します。 -1. [SAP BTP Cockpit](https://account.hana.ondemand.com/) に移動し、SAP AI コア サービス インスタンスに移動して、サービス キーを作成します。 +1. [SAP BTP Cockpit](https://account.hana.ondemand.com/) に移動し、SAP AI コアサービスインスタンスに移動して、サービスキーを作成します。 :::tip -サービス キーは、`clientid`、`clientsecret`、`url`、および `serviceurls.AI_API_URL` を含む JSON オブジェクトです。 AI コア インスタンスは、BTP コックピットの **サービス** > **インスタンスとサブスクリプション** で見つかります。 +サービスキーは、`clientid`、`clientsecret`、`url`、および `serviceurls.AI_API_URL` を含む JSON オブジェクトです。 AI コアインスタンスは、BTP コックピットの **サービス** > **インスタンスとサブスクリプション** で見つかります。 ::: 2. `/connect` コマンドを実行し、**SAP AI Core** を検索します。 @@ -1448,7 +1446,7 @@ SAP AI コアは、統合プラットフォームを通じて、OpenAI、Anthrop /connect ``` -3. サービス キーの JSON を入力します。 +3. サービスキーの JSON を入力します。 ```txt ┌ Service key @@ -1469,7 +1467,7 @@ SAP AI コアは、統合プラットフォームを通じて、OpenAI、Anthrop export AICORE_SERVICE_KEY='{"clientid":"...","clientsecret":"...","url":"...","serviceurls":{"AI_API_URL":"..."}}' ``` -4. 必要に応じて、デプロイメント ID とリソース グループを設定します。 +4. 必要に応じて、デプロイメント ID とリソースグループを設定します。 ```bash AICORE_DEPLOYMENT_ID=your-deployment-id AICORE_RESOURCE_GROUP=your-resource-group opencode @@ -1624,7 +1622,7 @@ Vercel AI Gateway を使用すると、統合エンドポイントを通じて O /models ``` -opencode構成を通じてモデルをカスタマイズすることもできます。プロバイダーのルーティング順序を指定する例を次に示します。 +OpenCode 設定を通じてモデルをカスタマイズすることもできます。プロバイダーのルーティング順序を指定する例を次に示します。 ```json title="opencode.json" { @@ -1643,11 +1641,11 @@ opencode構成を通じてモデルをカスタマイズすることもできま } ``` -いくつかの便利なルーティング オプション: +いくつかの便利なルーティングオプション: | オプション | 説明 | | ------------------- | ---------------------------------------------------- | -| `order` | 試行するプロバイダー シーケンス | +| `order` | 試行するプロバイダーシーケンス | | `only` | 特定のプロバイダーに制限する | | `zeroDataRetention` | データ保持ポリシーがゼロのプロバイダーのみを使用する | @@ -1690,7 +1688,7 @@ opencode構成を通じてモデルをカスタマイズすることもできま /connect ``` -**GLM コーディング プラン**に加入している場合は、**Z.AI コーディング プラン**を選択します。 +**GLM コーディングプラン**に加入している場合は、**Z.AI コーディングプラン**を選択します。 3. Z.AI API キーを入力します。 @@ -1734,7 +1732,7 @@ opencode構成を通じてモデルをカスタマイズすることもできま /models ``` -opencode構成を通じて追加のモデルを追加することもできます。 +OpenCode 設定を通じて追加のモデルを追加することもできます。 ```json title="opencode.json" {6} { @@ -1756,7 +1754,7 @@ opencode構成を通じて追加のモデルを追加することもできます `/connect` コマンドにリストされていない **OpenAI 互換**プロバイダーを追加するには: :::tip -OpenAI と互換性のある任意のプロバイダーをopencodeで使用できます。最新の AI プロバイダーのほとんどは、OpenAI 互換の API を提供しています。 +OpenAI と互換性のある任意のプロバイダーを OpenCode で使用できます。最新の AI プロバイダーのほとんどは、OpenAI 互換の API を提供しています。 ::: 1. `/connect` コマンドを実行し、**その他**まで下にスクロールします。 @@ -1785,7 +1783,7 @@ OpenAI と互換性のある任意のプロバイダーをopencodeで使用で ``` :::note -覚えやすい ID を選択してください。これを構成ファイルで使用します。 +覚えやすい ID を選択してください。これを設定ファイルで使用します。 ::: 3. プロバイダーの API キーを入力します。 @@ -1802,7 +1800,7 @@ OpenAI と互換性のある任意のプロバイダーをopencodeで使用で └ ``` -4. プロジェクト ディレクトリで `opencode.json` ファイルを作成または更新します。 +4. プロジェクトディレクトリで `opencode.json` ファイルを作成または更新します。 ```json title="opencode.json" ""myprovider"" {5-15} { @@ -1828,14 +1826,14 @@ OpenAI と互換性のある任意のプロバイダーをopencodeで使用で - **npm**: 使用する AI SDK パッケージ、OpenAI 互換プロバイダーの場合は `@ai-sdk/openai-compatible` - **name**: UI での表示名。 -- **モデル**: 利用可能なモデル。 +- **models**: 利用可能なモデル。 - **options.baseURL**: API エンドポイント URL。 - **options.apiKey**: 認証を使用しない場合は、オプションで API キーを設定します。 -- **options.headers**: 必要に応じてカスタム ヘッダーを設定します。 +- **options.headers**: 必要に応じてカスタムヘッダーを設定します。 詳細オプションの詳細については、以下の例を参照してください。 -5. `/models` コマンドを実行すると、カスタム プロバイダーとモデルが選択リストに表示されます。 +5. `/models` コマンドを実行すると、カスタムプロバイダーとモデルが選択リストに表示されます。 --- @@ -1871,12 +1869,12 @@ OpenAI と互換性のある任意のプロバイダーをopencodeで使用で } ``` -構成の詳細: +設定の詳細: - **apiKey**: `env` 変数構文を使用して設定します。[詳細については ](/docs/config#env-vars). -- **headers**: 各リクエストとともに送信されるカスタム ヘッダー。 -- **limit.context**: モデルが受け入れる最大Input Tokens。 -- **limit.output**: モデルが生成できる最大トークン。 +- **headers**: 各リクエストとともに送信されるカスタムヘッダー。 +- **limit.context**: モデルが受け入れる最大入力トークン。 +- **limit.output**: モデルが生成できる最大出力トークン。 `limit` フィールドを使用すると、OpenCode はコンテキストがどのくらい残っているかを理解できます。標準プロバイダーは、これらを models.dev から自動的に取得します。 @@ -1884,14 +1882,14 @@ OpenAI と互換性のある任意のプロバイダーをopencodeで使用で ## トラブルシューティング -プロバイダーの構成で問題が発生した場合は、次の点を確認してください。 +プロバイダーの設定で問題が発生した場合は、次の点を確認してください。 1. **認証設定を確認します**: `opencode auth list` を実行して、資格情報が正しいかどうかを確認します。 - プロバイダー用のものが構成に追加されます。 + プロバイダー用のものが設定に追加されます。 これは、認証に環境変数に依存する Amazon Bedrock のようなプロバイダーには当てはまりません。 -2. カスタム プロバイダーの場合は、opencode 構成を確認し、次のことを行います。 - - `/connect` コマンドで使用されるプロバイダー ID が、opencode 構成内の ID と一致することを確認してください。 +2. カスタムプロバイダーの場合は、OpenCode 設定を確認し、次のことを行います。 + - `/connect` コマンドで使用されるプロバイダー ID が、OpenCode 設定内の ID と一致することを確認してください。 - プロバイダーには適切な npm パッケージが使用されます。たとえば、Cerebras には `@ai-sdk/cerebras` を使用します。他のすべての OpenAI 互換プロバイダーの場合は、`@ai-sdk/openai-compatible` を使用します。 - `options.baseURL` フィールドで正しい API エンドポイントが使用されていることを確認してください。 diff --git a/packages/web/src/content/docs/ja/rules.mdx b/packages/web/src/content/docs/ja/rules.mdx index b188f92a1..0333850c0 100644 --- a/packages/web/src/content/docs/ja/rules.mdx +++ b/packages/web/src/content/docs/ja/rules.mdx @@ -1,20 +1,20 @@ --- title: ルール -description: opencodeのカスタム命令を設定します。 +description: OpenCode のカスタム命令を設定します。 --- -`AGENTS.md` ファイルを作成することで、opencode にカスタム命令を提供できます。これは Cursor のルールと似ています。これには、特定のプロジェクトに合わせて LLM の動作をカスタマイズするために LLM のコンテキストに含まれる命令が含まれています。 +`AGENTS.md` ファイルを作成することで、OpenCode にカスタム命令を提供できます。これは Cursor のルールと似ています。これには、特定のプロジェクトに合わせて LLM の動作をカスタマイズするために LLM のコンテキストに含まれる命令が含まれています。 --- -## 初期化する +## 初期化 -新しい `AGENTS.md` ファイルを作成するには、opencode で `/init` コマンドを実行します。 +新しい `AGENTS.md` ファイルを作成するには、OpenCode で `/init` コマンドを実行します。 :::tip プロジェクトの `AGENTS.md` ファイルを Git にコミットする必要があります。 ::: -This `AGENTS.md` ファイルが生成されます。これは、opencode がプロジェクトをより適切にナビゲートするのに役立ちます。 +`AGENTS.md` ファイルが生成されます。これは、OpenCode がプロジェクトをより適切にナビゲートするのに役立ちます。 既存の `AGENTS.md` ファイルがある場合、これはそれに追加しようとします。 @@ -53,27 +53,27 @@ This is an SST v3 monorepo with TypeScript. The project uses bun workspaces for ## 種類 -opencode は、複数の場所からの `AGENTS.md` ファイルの読み取りもサポートしています。そして、これはさまざまな目的に役立ちます。 +OpenCode は、複数の場所からの `AGENTS.md` ファイルの読み取りもサポートしています。そして、これはさまざまな目的に役立ちます。 ### プロジェクト -プロジェクト固有のルールのために、プロジェクト ルートに `AGENTS.md` を配置します。これらは、このディレクトリまたはそのサブディレクトリで作業している場合にのみ適用されます。 +プロジェクト固有のルールのために、プロジェクトルートに `AGENTS.md` を配置します。これらは、このディレクトリまたはそのサブディレクトリで作業している場合にのみ適用されます。 ### グローバル -`~/.config/opencode/AGENTS.md` ファイルにグローバル ルールを含めることもできます。これは、すべてのopencode セッションに適用されます。 +`~/.config/opencode/AGENTS.md` ファイルにグローバルルールを含めることもできます。これは、すべての OpenCode セッションに適用されます。 これは Git にコミットされておらず、チームと共有されていないため、LLM が従うべき個人ルールを指定するためにこれを使用することをお勧めします。 -### Claude Code Compatibility +### Claude Code 互換性 Claude Code から移行するユーザーのために、OpenCode はフォールバックとして Claude Code のファイル規則をサポートしています。 -- **プロジェクト ルール**: プロジェクト ディレクトリ内の `CLAUDE.md` (`AGENTS.md` が存在しない場合に使用されます) -- **グローバル ルール**: `~/.claude/CLAUDE.md` (`~/.config/opencode/AGENTS.md` が存在しない場合に使用) -- **スキル**: `~/.claude/skills/` — 詳細については、[エージェント スキル ](/docs/skills/) を参照してください。 +- **プロジェクトルール**: プロジェクトディレクトリ内の `CLAUDE.md` (`AGENTS.md` が存在しない場合に使用されます) +- **グローバルルール**: `~/.claude/CLAUDE.md` (`~/.config/opencode/AGENTS.md` が存在しない場合に使用) +- **スキル**: `~/.claude/skills/` — 詳細については、[エージェントスキル](/docs/skills/) を参照してください。 -クロード コードの互換性を無効にするには、次の環境変数のいずれかを設定します。 +Claude Code の互換性を無効にするには、次の環境変数のいずれかを設定します。 ```bash export OPENCODE_DISABLE_CLAUDE_CODE=1 # Disable all .claude support @@ -85,13 +85,13 @@ export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills ## 優先順位 -opencode が開始されると、次の順序でルール ファイルが検索されます。 +OpenCode が開始されると、次の順序でルールファイルが検索されます。 -1. **ローカル ファイル** (現在のディレクトリから上に移動) (`AGENTS.md`、`CLAUDE.md`) -2. **グローバル ファイル** (`~/.config/opencode/AGENTS.md`) -3. **クロード コード ファイル** (`~/.claude/CLAUDE.md` にあります) (無効になっていない限り) +1. **ローカルファイル** (現在のディレクトリから上に移動) (`AGENTS.md`、`CLAUDE.md`) +2. **グローバルファイル** (`~/.config/opencode/AGENTS.md`) +3. **Claude Code ファイル** (`~/.claude/CLAUDE.md` にあります) (無効になっていない限り) -最初に一致したファイルが各カテゴリで優勝します。たとえば、`AGENTS.md` と `CLAUDE.md` の両方がある場合、`AGENTS.md` のみが使用されます。同様に、`~/.config/opencode/AGENTS.md` は `~/.claude/CLAUDE.md` よりも優先されます。 +最初に一致したファイルが各カテゴリで優先されます。たとえば、`AGENTS.md` と `CLAUDE.md` の両方がある場合、`AGENTS.md` のみが使用されます。同様に、`~/.config/opencode/AGENTS.md` は `~/.claude/CLAUDE.md` よりも優先されます。 --- @@ -123,11 +123,11 @@ opencode が開始されると、次の順序でルール ファイルが検索 --- -## 外部ファイルの参照 +## 外部ファイル参照 -opencode は `AGENTS.md` のファイル参照を自動的に解析しませんが、次の 2 つの方法で同様の機能を実現できます。 +OpenCode は `AGENTS.md` のファイル参照を自動的に解析しませんが、次の 2 つの方法で同様の機能を実現できます。 -### opencode.json の使用 +### `opencode.json` の使用 推奨されるアプローチは、`instructions` の `opencode.json` フィールドを使用することです。 @@ -138,9 +138,9 @@ opencode は `AGENTS.md` のファイル参照を自動的に解析しません } ``` -### AGENTS.md のマニュアル手順 +### AGENTS.md の手動指示 -`AGENTS.md` で明示的な命令を指定することで、opencodeに外部ファイルを読み取るように教えることができます。実際の例を次に示します。 +`AGENTS.md` で明示的な命令を指定することで、OpenCode に外部ファイルを読み取るように教えることができます。実際の例を次に示します。 ```markdown title="AGENTS.md" # TypeScript Project Rules @@ -169,11 +169,11 @@ Read the following file immediately as it's relevant to all workflows: @rules/ge このアプローチにより、次のことが可能になります。 -- モジュール式の再利用可能なルール ファイルを作成する +- モジュール式の再利用可能なルールファイルを作成する - シンボリックリンクまたは git サブモジュールを介してプロジェクト間でルールを共有する - 詳細なガイドラインを参照しながら、AGENTS.md を簡潔に保ちます -- opencode が特定のタスクに必要な場合にのみファイルをロードするようにする +- OpenCode が特定のタスクに必要な場合にのみファイルをロードするようにする :::tip -モノリポジトリまたは共有標準を使用するプロジェクトの場合、グロブ パターン (`opencode.json` など) で `packages/*/AGENTS.md` を使用する方が、手動で指示するよりも保守しやすくなります。 +モノリポジトリまたは共有標準を使用するプロジェクトの場合、グロブパターン (`opencode.json` など) で `packages/*/AGENTS.md` を使用する方が、手動で指示するよりも保守しやすくなります。 ::: diff --git a/packages/web/src/content/docs/ja/sdk.mdx b/packages/web/src/content/docs/ja/sdk.mdx index 6ea735586..ee5fd3645 100644 --- a/packages/web/src/content/docs/ja/sdk.mdx +++ b/packages/web/src/content/docs/ja/sdk.mdx @@ -1,15 +1,15 @@ --- title: SDK -description: opencodeサーバー用のタイプセーフな JS クライアント。 +description: OpenCode サーバー用の型安全な JS クライアント。 --- import config from "../../../../config.mjs" export const typesUrl = `${config.github}/blob/dev/packages/sdk/js/src/gen/types.gen.ts` -opencode JS/TS SDK は、サーバーと対話するためのタイプセーフなクライアントを提供します。 -これを使用して、統合を構築し、opencodeをプログラムで制御します。 +OpenCode JS/TS SDK は、サーバーと対話するための型安全なクライアントを提供します。 +これを使用して、統合を構築し、OpenCode をプログラムで制御します。 -[サーバーの仕組みについて詳しくは、](/docs/server) をご覧ください。たとえば、コミュニティによって構築された [projects](/docs/ecosystem#projects) をチェックしてください。 +[サーバーの仕組みについての詳細](/docs/server) をご覧ください。たとえば、コミュニティによって構築された [projects](/docs/ecosystem#projects) をチェックしてください。 --- @@ -25,7 +25,7 @@ npm install @opencode-ai/sdk ## クライアントの作成 -opencodeのインスタンスを作成します。 +OpenCode のインスタンスを作成します。 ```javascript import { createOpencode } from "@opencode-ai/sdk" @@ -43,13 +43,13 @@ const { client } = await createOpencode() | `port` | `number` | サーバーポート | `4096` | | `signal` | `AbortSignal` | キャンセルのためのアボート信号 | `undefined` | | `timeout` | `number` | サーバー起動のタイムアウト (ミリ秒) | `5000` | -| `config` | `Config` | 構成オブジェクト | `{}` | +| `config` | `Config` | 設定オブジェクト | `{}` | --- -## 構成 +## 設定 -構成オブジェクトを渡して動作をカスタマイズできます。インスタンスは引き続き `opencode.json` を取得しますが、設定をインラインでオーバーライドまたは追加することができます。 +設定オブジェクトを渡して動作をカスタマイズできます。インスタンスは引き続き `opencode.json` を取得しますが、設定をインラインでオーバーライドまたは追加することができます。 ```javascript import { createOpencode } from "@opencode-ai/sdk" @@ -69,7 +69,7 @@ opencode.server.close() ## クライアントのみ -すでに実行中のopencodeのインスタンスがある場合は、それに接続するためのクライアント インスタンスを作成できます。 +すでに実行中の OpenCode のインスタンスがある場合は、それに接続するためのクライアントインスタンスを作成できます。 ```javascript import { createOpencodeClient } from "@opencode-ai/sdk" @@ -91,7 +91,7 @@ const client = createOpencodeClient({ --- -## 種類 +## 型定義 SDK には、すべての API タイプの TypeScript 定義が含まれています。それらを直接インポートします。 @@ -99,7 +99,7 @@ SDK には、すべての API タイプの TypeScript 定義が含まれてい import type { Session, Message, Part } from "@opencode-ai/sdk" ``` -すべてのタイプはサーバーの OpenAPI 仕様から生成され、タイプ ファイル で使用できます。 +すべてのタイプはサーバーの OpenAPI 仕様から生成され、タイプファイル で使用できます。 --- @@ -119,13 +119,13 @@ try { ## API -SDK は、タイプセーフなクライアントを通じてすべてのサーバー API を公開します。 +SDK は、型安全なクライアントを通じてすべてのサーバー API を公開します。 --- ### Global -| 方法 | 説明 | 応答 | +| メソッド | 説明 | 戻り値 | | ----------------- | -------------------------------------- | ------------------------------------ | | `global.health()` | サーバーの健全性とバージョンを確認する | `{ healthy: true, version: string }` | @@ -142,7 +142,7 @@ console.log(health.data.version) ### App -| 方法 | 説明 | 応答 | +| メソッド | 説明 | 戻り値 | | -------------- | ------------------------------------------ | ------------------------------------------- | | `app.log()` | ログエントリを書き込む | `boolean` | | `app.agents()` | 利用可能なすべてのエージェントをリストする | Agent[] | @@ -169,7 +169,7 @@ const agents = await client.app.agents() ### Project -| 方法 | 説明 | 応答 | +| メソッド | 説明 | 戻り値 | | ------------------- | -------------------------------- | --------------------------------------------- | | `project.list()` | すべてのプロジェクトをリストする | Project[] | | `project.current()` | 現在のプロジェクトを取得 | Project | @@ -190,7 +190,7 @@ const currentProject = await client.project.current() ### Path -| 方法 | 説明 | 応答 | +| メソッド | 説明 | 戻り値 | | ------------ | ---------------- | ---------------------------------------- | | `path.get()` | 現在のパスを取得 | Path | @@ -207,9 +207,9 @@ const pathInfo = await client.path.get() ### Config -| 方法 | 説明 | 応答 | +| メソッド | 説明 | 戻り値 | | -------------------- | -------------------------------------------- | ----------------------------------------------------------------------------------------------------- | -| `config.get()` | 構成情報を取得する | Config | +| `config.get()` | 設定情報を取得する | Config | | `config.providers()` | プロバイダーとデフォルトのモデルをリストする | `{ providers: `Provider[]`, default: { [key: string]: string } }` | --- @@ -226,7 +226,7 @@ const { providers, default: defaults } = await client.config.providers() ### Sessions -| 方法 | 説明 | メモ | +| メソッド | 説明 | 詳細 | | ---------------------------------------------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `session.list()` | セッションをリストする | 戻り値 Session[] | | `session.get({ path })` | セッションを取得 | 戻り値 Session | @@ -243,7 +243,7 @@ const { providers, default: defaults } = await client.config.providers() | `session.message({ path })` | メッセージの詳細を取得する | 戻り値 `{ info: `Message`, parts: `Part[]`}` | | `session.prompt({ path, body })` | プロンプトメッセージを送信する | `body.noReply: true` は UserMessage (コンテキストのみ) を返します。デフォルトでは、AI 応答を含む AssistantMessage を返します。 | | `session.command({ path, body })` | コマンドをセッションに送信 | 戻り値 `{ info: `AssistantMessage`, parts: `Part[]`}` | -| `session.shell({ path, body })` | shell コマンドを実行する | 戻り値 AssistantMessage | +| `session.shell({ path, body })` | シェルコマンドを実行する | 戻り値 AssistantMessage | | `session.revert({ path, body })` | メッセージを元に戻す | 戻り値 Session | | `session.unrevert({ path })` | 元に戻したメッセージを復元する | 戻り値 Session | | `postSessionByIdPermissionsByPermissionId({ path, body })` | 許可リクエストに応答する | 戻り値 `boolean` | @@ -283,7 +283,7 @@ await client.session.prompt({ ### Files -| Method | Description | Response | +| メソッド | 説明 | 戻り値 | | ------------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------- | | `find.text({ query })` | Search for text in files | Array of match objects with `path`, `lines`, `line_number`, `absolute_offset`, `submatches` | | `find.files({ query })` | Find files and directories by name | `string[]` (paths) | @@ -291,10 +291,10 @@ await client.session.prompt({ | `file.read({ query })` | Read a file | `{ type: "raw" \| "patch", content: string }` | | `file.status({ query? })` | Get status for tracked files | File[] | -`find.files` は、いくつかのオプションのクエリ フィールドをサポートしています。 +`find.files` は、いくつかのオプションのクエリフィールドをサポートしています。 - `type`: `"file"` または `"directory"` -- `directory`: 検索用のプロジェクト ルートをオーバーライドします。 +- `directory`: 検索用のプロジェクトルートをオーバーライドします。 - `limit`: 最大結果 (1 ～ 200) --- @@ -324,7 +324,7 @@ const content = await client.file.read({ ### TUI -| 方法 | 説明 | 応答 | +| メソッド | 説明 | 戻り値 | | ------------------------------ | -------------------------------- | --------- | | `tui.appendPrompt({ body })` | プロンプトにテキストを追加します | `boolean` | | `tui.openHelp()` | ヘルプダイアログを開く | `boolean` | @@ -355,7 +355,7 @@ await client.tui.showToast({ ### Auth -| 方法 | 説明 | 応答 | +| メソッド | 説明 | 戻り値 | | ------------------- | ---------------------- | --------- | | `auth.set({ ... })` | 認証資格情報を設定する | `boolean` | @@ -374,9 +374,9 @@ await client.auth.set({ ### Events -| 方法 | 説明 | 応答 | -| ------------------- | ------------------------------- | ------------------------------- | -| `event.subscribe()` | サーバー送信イベント ストリーム | サーバー送信イベント ストリーム | +| メソッド | 説明 | 戻り値 | +| ------------------- | ------------------------------ | ------------------------------ | +| `event.subscribe()` | サーバー送信イベントストリーム | サーバー送信イベントストリーム | --- diff --git a/packages/web/src/content/docs/ja/server.mdx b/packages/web/src/content/docs/ja/server.mdx index e86e81197..cbea87083 100644 --- a/packages/web/src/content/docs/ja/server.mdx +++ b/packages/web/src/content/docs/ja/server.mdx @@ -1,12 +1,12 @@ --- -title: サーバ -description: HTTP 経由でopencode サーバーと通信します。 +title: サーバー +description: HTTP 経由で OpenCode サーバーと通信します。 --- import config from "../../../../config.mjs" export const typesUrl = `${config.github}/blob/dev/packages/sdk/js/src/gen/types.gen.ts` -`opencode serve` コマンドは、opencode クライアントが使用できる OpenAPI エンドポイントを公開するヘッドレス HTTP サーバーを実行します。 +`opencode serve` コマンドは、OpenCode クライアントが使用できる OpenAPI エンドポイントを公開するヘッドレス HTTP サーバーを実行します。 --- @@ -18,13 +18,13 @@ opencode serve [--port ] [--hostname ] [--cors ] #### オプション -| 旗 | 説明 | デフォルト | -| --------------- | ---------------------------------- | ---------------- | -| `--port` | リッスンするポート | `4096` | -| `--hostname` | リッスンするホスト名 | `127.0.0.1` | -| `--mdns` | mDNS 検出を有効にする | `false` | -| `--mdns-domain` | mDNS サービスのカスタム ドメイン名 | `opencode.local` | -| `--cors` | 許可する追加のブラウザーオリジン | `[]` | +| フラグ | 説明 | デフォルト | +| --------------- | --------------------------------- | ---------------- | +| `--port` | リッスンするポート | `4096` | +| `--hostname` | リッスンするホスト名 | `127.0.0.1` | +| `--mdns` | mDNS 検出を有効にする | `false` | +| `--mdns-domain` | mDNS サービスのカスタムドメイン名 | `opencode.local` | +| `--cors` | 許可する追加のブラウザーオリジン | `[]` | `--cors` は複数回渡すことができます。 @@ -46,29 +46,25 @@ OPENCODE_SERVER_PASSWORD=your-password opencode serve ### 仕組み -`opencode` を実行すると、TUI とサーバーが起動します。 TUI の場所 -サーバーと通信するクライアント。サーバーは OpenAPI 3.1 仕様を公開します -終点。このエンドポイントは、[SDK](/docs/sdk). +`opencode` を実行すると、TUI とサーバーが起動します。 TUI はサーバーと通信するクライアントです。サーバーは OpenAPI 3.1 仕様のエンドポイントを公開します。このエンドポイントは、[SDK](/docs/sdk) を使用してアクセスできます。 :::tip -opencode サーバーを使用して、プログラムで opencode と対話します。 +OpenCode サーバーを使用して、プログラムで OpenCode と対話します。 ::: -This -`opencode serve` を実行してスタンドアロン サーバーを起動できます。持っている場合は、 -opencode TUI を実行すると、`opencode serve` が新しいサーバーを起動します。 +`opencode serve` を実行してスタンドアロンサーバーを起動できます。すでに OpenCode TUI を実行している場合でも、`opencode serve` は新しいサーバーを起動します。 --- #### 既存のサーバーに接続する -TUI を起動すると、ポートとホスト名がランダムに割り当てられます。代わりに、`--hostname` と `--port` [flags](/docs/cli).次に、これを使用してサーバーに接続します。 +TUI を起動すると、ポートとホスト名がランダムに割り当てられます。代わりに、`--hostname` と `--port` [フラグ](/docs/cli) を使用して固定できます。次に、これを使用してサーバーに接続します。 -[`/tui`](#tui) エンドポイントは、サーバー経由で TUI を駆動するために使用できます。たとえば、プロンプトを事前入力したり、実行したりできます。この設定は、OpenCode [IDE](/docs/ide) プラグイン] によって使用されます。 +[`/tui`](#tui) エンドポイントは、サーバー経由で TUI を駆動するために使用できます。たとえば、プロンプトを事前入力したり、実行したりできます。この設定は、OpenCode [IDE](/docs/ide) プラグインによって使用されます。 --- -## スペック +## 仕様 サーバーは、次の場所で閲覧できる OpenAPI 3.1 仕様を公開しています。 @@ -82,205 +78,205 @@ http://:/doc ## API -opencode サーバーは次の API を公開します。 +OpenCode サーバーは次の API を公開します。 --- -### グローバル +### Global -| 方法 | パス | 説明 | 応答 | -| ----- | ---------------- | ------------------------------------------ | ------------------------------------ | -| `GET` | `/global/health` | サーバーの健全性とバージョンを取得する | `{ healthy: true, version: string }` | -| `GET` | `/global/event` | グローバル イベントの取得 (SSE ストリーム) | イベントストリーム | +| メソッド | パス | 説明 | レスポンス | +| -------- | ---------------- | ----------------------------------------- | ------------------------------------ | +| `GET` | `/global/health` | サーバーの健全性とバージョンを取得する | `{ healthy: true, version: string }` | +| `GET` | `/global/event` | グローバルイベントの取得 (SSE ストリーム) | イベントストリーム | --- -### プロジェクト +### Project -| 方法 | パス | 説明 | 応答 | -| ----- | ------------------ | -------------------------------- | -------------------------------------------------- | -| `GET` | `/project` | すべてのプロジェクトをリストする | プロジェクト[] | -| `GET` | `/project/current` | 現在のプロジェクトを取得 | プロジェクト | +| メソッド | パス | 説明 | レスポンス | +| -------- | ------------------ | -------------------------------- | --------------------------------------------- | +| `GET` | `/project` | すべてのプロジェクトをリストする | Project[] | +| `GET` | `/project/current` | 現在のプロジェクトを取得 | Project | --- -### パスと VCS +### Path and VCS -| 方法 | パス | 説明 | 応答 | -| ----- | ------- | --------------------------------------- | ------------------------------------------- | -| `GET` | `/path` | 現在のパスを取得する | パス | -| `GET` | `/vcs` | 現在のプロジェクトの VCS 情報を取得する | VcsInfo | +| メソッド | パス | 説明 | レスポンス | +| -------- | ------- | --------------------------------------- | ------------------------------------------- | +| `GET` | `/path` | 現在のパスを取得する | Path | +| `GET` | `/vcs` | 現在のプロジェクトの VCS 情報を取得する | VcsInfo | --- -### 実例 +### Instance -| 方法 | パス | 説明 | 応答 | -| ------ | ------------------- | ---------------------------- | ------ | -| `POST` | `/instance/dispose` | 現在のインスタンスを破棄する | うーん | +| メソッド | パス | 説明 | レスポンス | +| -------- | ------------------- | ---------------------------- | ---------- | +| `POST` | `/instance/dispose` | 現在のインスタンスを破棄する | void | --- -### 構成 +### Config -| 方法 | パス | 説明 | 応答 | -| ------- | ------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------ | -| `GET` | `/config` | 構成情報を取得する | 構成 | -| `PATCH` | `/config` | 構成を更新する | 構成 | -| `GET` | `/config/providers` | プロバイダーとデフォルトのモデルをリストする | `{ providers: `プロバイダ[]`, default: { [key: string]: string } }` | +| メソッド | パス | 説明 | レスポンス | +| -------- | ------------------- | -------------------------------------------- | ----------------------------------------------------------------------------------------------------- | +| `GET` | `/config` | 設定情報を取得する | Config | +| `PATCH` | `/config` | 設定を更新する | Config | +| `GET` | `/config/providers` | プロバイダーとデフォルトのモデルをリストする | `{ providers: `Provider[]`, default: { [key: string]: string } }` | --- ### プロバイダー -| 方法 | パス | 説明 | 応答 | -| ------ | -------------------------------- | ------------------------------------------- | ------------------------------------------------------------------------------------- | -| `GET` | `/provider` | すべてのプロバイダーをリストする | `{ all: `プロバイダ[]`, default: {...}, connected: string[] }` | -| `GET` | `/provider/auth` | プロバイダーの認証方法を取得する | `{ [providerID: string]: `ProviderAuthMethod[]` }` | -| `POST` | `/provider/{id}/oauth/authorize` | OAuth を使用してプロバイダーを認証する | ProviderAuthAuthorization | -| `POST` | `/provider/{id}/oauth/callback` | プロバイダーの OAuth コールバックを処理する | うーん | +| メソッド | パス | 説明 | レスポンス | +| -------- | -------------------------------- | ------------------------------------------- | ------------------------------------------------------------------------------------------------ | +| `GET` | `/provider` | すべてのプロバイダーをリストする | `{ all: `Provider[]`, default: {...}, connected: string[] }` | +| `GET` | `/provider/auth` | プロバイダーの認証方法を取得する | `{ [providerID: string]: `ProviderAuthMethod[]` }` | +| `POST` | `/provider/{id}/oauth/authorize` | OAuth を使用してプロバイダーを認証する | ProviderAuthAuthorization | +| `POST` | `/provider/{id}/oauth/callback` | プロバイダーの OAuth コールバックを処理する | void | --- -### セッション +### Session -| 方法 | パス | 説明 | メモ | -| -------- | ---------------------------------------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------ | -| `GET` | `/session` | すべてのセッションをリストする | 戻り値 セッション[] | -| `POST` | `/session` | 新しいセッションを作成する | 本文: `{ parentID?, title? }`、セッション を返します。 | -| `GET` | `/session/status` | すべてのセッションのセッション ステータスを取得する | 戻り値 `{ [sessionID: string]: `SessionStatus` }` | -| `GET` | `/session/:id` | セッションの詳細を取得する | 戻り値 セッション | -| `DELETE` | `/session/:id` | セッションとそのすべてのデータを削除する | 戻り値 `boolean` | -| `PATCH` | `/session/:id` | セッションのプロパティを更新する | 本文: `{ title? }`、セッション を返します。 | -| `GET` | `/session/:id/children` | セッションの子セッションを取得する | 戻り値 セッション[] | -| `GET` | `/session/:id/todo` | セッションの ToDo リストを取得する | 戻り値 Todo[] | -| `POST` | `/session/:id/init` | アプリを分析して `AGENTS.md` を作成する | 本文: `{ messageID, providerID, modelID }`、`boolean` を返します。 | -| `POST` | `/session/:id/fork` | メッセージで既存のセッションをフォークする | 本文: `{ messageID? }`、セッション を返します。 | -| `POST` | `/session/:id/abort` | 実行中のセッションを中止する | 戻り値 `boolean` | -| `POST` | `/session/:id/share` | セッションを共有する | 戻り値 セッション | -| `DELETE` | `/session/:id/share` | セッションの共有を解除する | 戻り値 セッション | -| `GET` | `/session/:id/diff` | このセッションの差分を取得する | クエリ: `messageID?`、FileDiff[] を返します。 | -| `POST` | `/session/:id/summarize` | セッションを要約する | 本文: `{ providerID, modelID }`、`boolean` を返します。 | -| `POST` | `/session/:id/revert` | メッセージを元に戻す | 本文: `{ messageID, partID? }`、`boolean` を返します。 | -| `POST` | `/session/:id/unrevert` | 元に戻したすべてのメッセージを復元する | 戻り値 `boolean` | -| `POST` | `/session/:id/permissions/:permissionID` | 許可リクエストに応答する | 本文: `{ response, remember? }`、`boolean` を返します。 | +| メソッド | パス | 説明 | 詳細 | +| -------- | ---------------------------------------- | -------------------------------------------------- | --------------------------------------------------------------------------------------- | +| `GET` | `/session` | すべてのセッションをリストする | 戻り値 Session[] | +| `POST` | `/session` | 新しいセッションを作成する | 本文: `{ parentID?, title? }`、Session を返します。 | +| `GET` | `/session/status` | すべてのセッションのセッションステータスを取得する | 戻り値 `{ [sessionID: string]: `SessionStatus` }` | +| `GET` | `/session/:id` | セッションの詳細を取得する | 戻り値 Session | +| `DELETE` | `/session/:id` | セッションとそのすべてのデータを削除する | 戻り値 `boolean` | +| `PATCH` | `/session/:id` | セッションのプロパティを更新する | 本文: `{ title? }`、Session を返します。 | +| `GET` | `/session/:id/children` | セッションの子セッションを取得する | 戻り値 Session[] | +| `GET` | `/session/:id/todo` | セッションの ToDo リストを取得する | 戻り値 Todo[] | +| `POST` | `/session/:id/init` | アプリを分析して `AGENTS.md` を作成する | 本文: `{ messageID, providerID, modelID }`、`boolean` を返します。 | +| `POST` | `/session/:id/fork` | メッセージで既存のセッションをフォークする | 本文: `{ messageID? }`、Session を返します。 | +| `POST` | `/session/:id/abort` | 実行中のセッションを中止する | 戻り値 `boolean` | +| `POST` | `/session/:id/share` | セッションを共有する | 戻り値 Session | +| `DELETE` | `/session/:id/share` | セッションの共有を解除する | 戻り値 Session | +| `GET` | `/session/:id/diff` | このセッションの差分を取得する | クエリ: `messageID?`、FileDiff[] を返します。 | +| `POST` | `/session/:id/summarize` | セッションを要約する | 本文: `{ providerID, modelID }`、`boolean` を返します。 | +| `POST` | `/session/:id/revert` | メッセージを元に戻す | 本文: `{ messageID, partID? }`、`boolean` を返します。 | +| `POST` | `/session/:id/unrevert` | 元に戻したすべてのメッセージを復元する | 戻り値 `boolean` | +| `POST` | `/session/:id/permissions/:permissionID` | 許可リクエストに応答する | 本文: `{ response, remember? }`、`boolean` を返します。 | --- -### メッセージ +### Message -| 方法 | パス | 説明 | メモ | -| ------ | --------------------------------- | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `GET` | `/session/:id/message` | セッション内のメッセージをリストする | クエリ: `limit?`、`{ info: `メッセージを返します。`, parts: `Part[]`}[]` | -| `POST` | `/session/:id/message` | メッセージを送信して応答を待ちます | 本文: `{ messageID?, model?, agent?, noReply?, system?, tools?, parts }`、`{ info: `メッセージを返します`, parts: `Part[]`}` | -| `GET` | `/session/:id/message/:messageID` | メッセージの詳細を取得する | 戻り値 `{ info: `メッセージ`, parts: `Part[]`}` | -| `POST` | `/session/:id/prompt_async` | メッセージを非同期に送信する (待機なし) | body: `/session/:id/message` と同じ、`204 No Content` を返します。 | -| `POST` | `/session/:id/command` | スラッシュコマンドを実行します | 本文: `{ messageID?, agent?, model?, command, arguments }`、`{ info: `メッセージを返します`, parts: `Part[]`}` | -| `POST` | `/session/:id/shell` | shell コマンドを実行する | 本文: `{ agent, model?, command }`、`{ info: `メッセージを返します`, parts: `Part[]`}` | +| メソッド | パス | 説明 | 詳細 | +| -------- | --------------------------------- | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `GET` | `/session/:id/message` | セッション内のメッセージをリストする | クエリ: `limit?`、`{ info: `Message`, parts: `Part[]`}[]` を返します。 | +| `POST` | `/session/:id/message` | メッセージを送信して応答を待ちます | 本文: `{ messageID?, model?, agent?, noReply?, system?, tools?, parts }`、`{ info: `Message`, parts: `Part[]`}` を返します | +| `GET` | `/session/:id/message/:messageID` | メッセージの詳細を取得する | 戻り値 `{ info: `Message`, parts: `Part[]`}` | +| `POST` | `/session/:id/prompt_async` | メッセージを非同期に送信する (待機なし) | body: `/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[]`}` を返します | --- -### コマンド +### Command -| 方法 | パス | 説明 | 応答 | -| ----- | ---------- | ---------------------------- | ---------------------------------------------- | -| `GET` | `/command` | すべてのコマンドをリストする | コマンド[] | +| メソッド | パス | 説明 | レスポンス | +| -------- | ---------- | ---------------------------- | --------------------------------------------- | +| `GET` | `/command` | すべてのコマンドをリストする | Command[] | --- -### ファイル +### File -| 方法 | パス | 説明 | 応答 | -| ----- | ------------------------ | ---------------------------------------- | -------------------------------------------------------------------------------------------- | -| `GET` | `/find?pattern=` | ファイル内のテキストを検索 | `path`、`lines`、`line_number`、`absolute_offset`、`submatches` と一致するオブジェクトの配列 | -| `GET` | `/find/file?query=` | ファイルとディレクトリを名前で検索する | `string[]` (パス) | -| `GET` | `/find/symbol?query=` | ワークスペースのシンボルを検索する | シンボル[] | -| `GET` | `/file?path=` | ファイルとディレクトリをリストする | FileNode[] | -| `GET` | `/file/content?path=

` | ファイルを読む | ファイルコンテンツ | -| `GET` | `/file/status` | 追跡されたファイルのステータスを取得する | ファイル[] | +| メソッド | パス | 説明 | レスポンス | +| -------- | ------------------------ | ---------------------------------------- | -------------------------------------------------------------------------------------------- | +| `GET` | `/find?pattern=` | ファイル内のテキストを検索 | `path`、`lines`、`line_number`、`absolute_offset`、`submatches` と一致するオブジェクトの配列 | +| `GET` | `/find/file?query=` | ファイルとディレクトリを名前で検索する | `string[]` (パス) | +| `GET` | `/find/symbol?query=` | ワークスペースのシンボルを検索する | Symbol[] | +| `GET` | `/file?path=` | ファイルとディレクトリをリストする | FileNode[] | +| `GET` | `/file/content?path=

` | ファイルを読む | FileContent | +| `GET` | `/file/status` | 追跡されたファイルのステータスを取得する | File[] | #### `/find/file` クエリパラメータ - `query` (必須) — 検索文字列 (あいまい一致) - `type` (オプション) — 結果を `"file"` または `"directory"` に制限します -- `directory` (オプション) — 検索用のプロジェクト ルートをオーバーライドします。 +- `directory` (オプション) — 検索用のプロジェクトルートをオーバーライドします。 - `limit` (オプション) — 最大結果 (1 ～ 200) - `dirs` (オプション) — 従来のフラグ (`"false"` はファイルのみを返します) --- -### ツール (実験的) +### Tool (Experimental) -| 方法 | パス | 説明 | 応答 | -| ----- | ------------------------------------------- | ---------------------------------------------- | ------------------------------------------------ | -| `GET` | `/experimental/tool/ids` | すべてのツール ID をリストする | ツール ID | -| `GET` | `/experimental/tool?provider=

&model=` | モデルの JSON スキーマを含むツールをリストする | ツールリスト | +| メソッド | パス | 説明 | レスポンス | +| -------- | ------------------------------------------- | ---------------------------------------------- | -------------------------------------------- | +| `GET` | `/experimental/tool/ids` | すべてのツール ID をリストする | ToolIDs | +| `GET` | `/experimental/tool?provider=

&model=` | モデルの JSON スキーマを含むツールをリストする | ToolList | --- -### LSP、フォーマッタ、MCP +### LSP, Formatter, MCP -| 方法 | パス | 説明 | 応答 | -| ------ | ------------ | ---------------------------------- | ----------------------------------------------------------------- | -| `GET` | `/lsp` | LSP サーバーのステータスを取得 | LSPStatus[] | -| `GET` | `/formatter` | フォーマッタのステータスを取得する | FormatterStatus[] | -| `GET` | `/mcp` | MCP サーバーのステータスを取得する | `{ [name: string]: `MCPStatus` }` | -| `POST` | `/mcp` | MCP サーバーを動的に追加する | 本文: `{ name, config }`、MCP ステータス オブジェクトを返します。 | +| メソッド | パス | 説明 | レスポンス | +| -------- | ------------ | ---------------------------------- | --------------------------------------------------------------------- | +| `GET` | `/lsp` | LSP サーバーのステータスを取得 | LSPStatus[] | +| `GET` | `/formatter` | フォーマッタのステータスを取得する | FormatterStatus[] | +| `GET` | `/mcp` | MCP サーバーのステータスを取得する | `{ [name: string]: `MCPStatus` }` | +| `POST` | `/mcp` | MCP サーバーを動的に追加する | 本文: `{ name, config }`、MCP ステータスオブジェクトを返します。 | --- -### エージェント +### Agent -| 方法 | パス | 説明 | 応答 | -| ----- | -------- | ------------------------------------------ | -------------------------------------------------- | -| `GET` | `/agent` | 利用可能なすべてのエージェントをリストする | エージェント[] | +| メソッド | パス | 説明 | レスポンス | +| -------- | -------- | ------------------------------------------ | ------------------------------------------- | +| `GET` | `/agent` | 利用可能なすべてのエージェントをリストする | Agent[] | --- -### ロギング +### Logging -| 方法 | パス | 説明 | 応答 | -| ------ | ------ | ---------------------------------------------------------------------- | ------ | -| `POST` | `/log` | ログエントリを書き込みます。本体:`{ service, level, message, extra? }` | うーん | +| メソッド | パス | 説明 | レスポンス | +| -------- | ------ | ---------------------------------------------------------------------- | ---------- | +| `POST` | `/log` | ログエントリを書き込みます。本体:`{ service, level, message, extra? }` | void | --- -### トゥイ +### TUI -| 方法 | パス | 説明 | 応答 | -| ------ | ----------------------- | ----------------------------------------------- | ---------------------------------- | -| `POST` | `/tui/append-prompt` | プロンプトにテキストを追加します | うーん | -| `POST` | `/tui/open-help` | ヘルプダイアログを開く | うーん | -| `POST` | `/tui/open-sessions` | セッションセレクターを開く | うーん | -| `POST` | `/tui/open-themes` | テーマセレクターを開く | うーん | -| `POST` | `/tui/open-models` | モデルセレクターを開く | うーん | -| `POST` | `/tui/submit-prompt` | 現在のプロンプトを送信します | うーん | -| `POST` | `/tui/clear-prompt` | プロンプトをクリア | うーん | -| `POST` | `/tui/execute-command` | コマンドを実行する (`{ command }`) | うーん | -| `POST` | `/tui/show-toast` | トーストを表示 (`{ title?, message, variant }`) | うーん | -| `GET` | `/tui/control/next` | 次の制御リクエストを待ちます | コントロールリクエストオブジェクト | -| `POST` | `/tui/control/response` | 制御リクエストに応答する (`{ body }`) | うーん | +| メソッド | パス | 説明 | レスポンス | +| -------- | ----------------------- | ----------------------------------------------- | -------------------------- | +| `POST` | `/tui/append-prompt` | プロンプトにテキストを追加します | void | +| `POST` | `/tui/open-help` | ヘルプダイアログを開く | void | +| `POST` | `/tui/open-sessions` | セッションセレクターを開く | void | +| `POST` | `/tui/open-themes` | テーマセレクターを開く | void | +| `POST` | `/tui/open-models` | モデルセレクターを開く | void | +| `POST` | `/tui/submit-prompt` | 現在のプロンプトを送信します | void | +| `POST` | `/tui/clear-prompt` | プロンプトをクリア | void | +| `POST` | `/tui/execute-command` | コマンドを実行する (`{ command }`) | void | +| `POST` | `/tui/show-toast` | トーストを表示 (`{ title?, message, variant }`) | void | +| `GET` | `/tui/control/next` | 次の制御リクエストを待ちます | 制御リクエストオブジェクト | +| `POST` | `/tui/control/response` | 制御リクエストに応答する (`{ body }`) | void | --- -### 認証 +### Auth -| 方法 | パス | 説明 | 応答 | -| ----- | ----------- | ------------------------------------------------------------------------------ | ------ | -| `PUT` | `/auth/:id` | 認証資格情報を設定します。本文はプロバイダーのスキーマと一致する必要があります | うーん | +| メソッド | パス | 説明 | レスポンス | +| -------- | ----------- | ------------------------------------------------------------------------------ | ---------- | +| `PUT` | `/auth/:id` | 認証資格情報を設定します。本文はプロバイダーのスキーマと一致する必要があります | void | --- -### イベント +### Event -| Method | Path | Description | Response | -| ------ | -------- | ----------------------------------------------------------------------------- | ------------------------- | -| `GET` | `/event` | Server-sent events stream. First event is `server.connected`, then bus events | Server-sent events stream | +| メソッド | パス | 説明 | レスポンス | +| -------- | -------- | ------------------------------------------------------------------------------------- | ------------------------------ | +| `GET` | `/event` | サーバー送信イベントストリーム。最初のイベントは `server.connected`、次にバスイベント | サーバー送信イベントストリーム | --- -### ドキュメント +### Documentation -| 方法 | パス | 説明 | 応答 | -| ----- | ------ | ---------------- | -------------------------------- | -| `GET` | `/doc` | OpenAPI 3.1 仕様 | OpenAPI 仕様を備えた HTML ページ | +| メソッド | パス | 説明 | レスポンス | +| -------- | ------ | ---------------- | -------------------------------- | +| `GET` | `/doc` | OpenAPI 3.1 仕様 | OpenAPI 仕様を備えた HTML ページ | diff --git a/packages/web/src/content/docs/ja/share.mdx b/packages/web/src/content/docs/ja/share.mdx index f8d26d7df..7995ba9a0 100644 --- a/packages/web/src/content/docs/ja/share.mdx +++ b/packages/web/src/content/docs/ja/share.mdx @@ -37,7 +37,7 @@ OpenCode は、会話の共有方法を制御する 3 つの共有モードを これにより、クリップボードにコピーされる一意の URL が生成されます。 -[config file](/docs/config):] で手動モードを明示的に設定するには: +[設定ファイル](/docs/config): で手動モードを明示的に設定するには: ```json title="opencode.json" { @@ -50,7 +50,7 @@ OpenCode は、会話の共有方法を制御する 3 つの共有モードを ### 自動共有 -[config file](/docs/config):] で `share` オプションを `"auto"` に設定することで、すべての新しい会話の自動共有を有効にできます。 +[設定ファイル](/docs/config): で `share` オプションを `"auto"` に設定することで、すべての新しい会話の自動共有を有効にできます。 ```json title="opencode.json" { @@ -65,7 +65,7 @@ OpenCode は、会話の共有方法を制御する 3 つの共有モードを ### 無効 -[config file](/docs/config):] で `share` オプションを `"disabled"` に設定することで、共有を完全に無効にすることができます。 +[設定ファイル](/docs/config): で `share` オプションを `"disabled"` に設定することで、共有を完全に無効にすることができます。 ```json title="opencode.json" { @@ -78,9 +78,9 @@ OpenCode は、会話の共有方法を制御する 3 つの共有モードを --- -## 共有を解除する +## 共有の解除 -会話の共有を停止し、パブリック アクセスから削除するには: +会話の共有を停止し、パブリックアクセスから削除するには: ``` /unshare @@ -125,4 +125,4 @@ OpenCode は、会話の共有方法を制御する 3 つの共有モードを - **SSO を通じて認証されたユーザーのみに制限** - 独自のインフラストラクチャで **セルフホスト** -[組織内でのopencodeの使用について詳しくは、](/docs/enterprise) をご覧ください。 +[組織内での OpenCode の使用について詳しくは、](/docs/enterprise) をご覧ください。 diff --git a/packages/web/src/content/docs/ja/skills.mdx b/packages/web/src/content/docs/ja/skills.mdx index becc1bd6f..6e5bae6c7 100644 --- a/packages/web/src/content/docs/ja/skills.mdx +++ b/packages/web/src/content/docs/ja/skills.mdx @@ -1,37 +1,37 @@ --- -title: 「エージェントスキル」 -description: 「SKILL.md定義による再利用可能な動作の定義」 +title: エージェントスキル +description: SKILL.md 定義による再利用可能な動作の定義 --- -エージェント スキルにより、OpenCode はリポジトリまたはホーム ディレクトリから再利用可能な命令を検出できます。 +エージェントスキルにより、OpenCode はリポジトリまたはホームディレクトリから再利用可能な命令を検出できます。 スキルはネイティブの `skill` ツールを介してオンデマンドでロードされます。エージェントは利用可能なスキルを確認し、必要に応じて完全なコンテンツをロードできます。 --- -## ファイルを配置する +## ファイルの配置 スキル名ごとにフォルダーを 1 つ作成し、その中に `SKILL.md` を置きます。 OpenCode は次の場所を検索します。 -- プロジェクト構成: `.opencode/skills//SKILL.md` -- グローバル構成: `~/.config/opencode/skills//SKILL.md` -- Project Claude互換: `.claude/skills//SKILL.md` -- グローバルクロード互換: `~/.claude/skills//SKILL.md` +- プロジェクト設定: `.opencode/skills//SKILL.md` +- グローバル設定: `~/.config/opencode/skills//SKILL.md` +- プロジェクト Claude 互換: `.claude/skills//SKILL.md` +- グローバル Claude 互換: `~/.claude/skills//SKILL.md` - プロジェクトエージェント互換: `.agents/skills//SKILL.md` - グローバルエージェント互換: `~/.agents/skills//SKILL.md` --- -## 発見を理解する +## 検出の仕組み -プロジェクトのローカル パスの場合、OpenCode は現在の作業ディレクトリから git ワークツリーに到達するまで進みます。 +プロジェクトのローカルパスの場合、OpenCode は現在の作業ディレクトリから git ワークツリーに到達するまで進みます。 途中で、一致する `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` からもロードされます。 --- -## 前付を書く +## フロントマターの記述 各 `SKILL.md` は YAML フロントマターで始まる必要があります。 次のフィールドのみが認識されます。 @@ -46,7 +46,7 @@ OpenCode は次の場所を検索します。 --- -## 名前を検証する +## 名前の検証 `name` は次のことを行う必要があります。 @@ -64,14 +64,14 @@ OpenCode は次の場所を検索します。 --- -## 長さのルールに従ってください +## 長さのルール `description` は 1 ～ 1024 文字である必要があります。 エージェントが正しく選択できるように、十分具体的な内容にしてください。 --- -## 例を使用する +## 使用例 次のように `.opencode/skills/git-release/SKILL.md` を作成します。 @@ -100,7 +100,7 @@ Ask clarifying questions if the target versioning scheme is unclear. --- -## ツールの説明を認識する +## ツールの説明認識 OpenCode では、`skill` ツールの説明に利用可能なスキルがリストされています。 各エントリにはスキル名と説明が含まれます。 @@ -122,7 +122,7 @@ skill({ name: "git-release" }) --- -## 権限の構成 +## 権限の設定 `opencode.json` のパターンベースの権限を使用して、エージェントがアクセスできるスキルを制御します。 @@ -139,7 +139,7 @@ skill({ name: "git-release" }) } ``` -| 許可 | 行動 | +| 許可 | アクション | | ------- | ---------------------------------------------------------- | | `allow` | スキルはすぐにロードされます | | `deny` | スキルはエージェントから隠蔽され、アクセスは拒否されました | @@ -149,11 +149,11 @@ skill({ name: "git-release" }) --- -## エージェントごとに上書きする +## エージェントごとの上書き 特定のエージェントにグローバルのデフォルトとは異なる権限を与えます。 -**カスタム エージェントの場合** (エージェント フロントマター内): +**カスタムエージェントの場合** (エージェントフロントマター内): ```yaml --- @@ -181,11 +181,11 @@ permission: --- -## スキルツールを無効にする +## スキルツールの無効化 スキルを使用すべきではないエージェントのスキルを完全に無効にします。 -**カスタム エージェントの場合**: +**カスタムエージェントの場合**: ```yaml --- diff --git a/packages/web/src/content/docs/ja/themes.mdx b/packages/web/src/content/docs/ja/themes.mdx index 5bb353488..dd76651d6 100644 --- a/packages/web/src/content/docs/ja/themes.mdx +++ b/packages/web/src/content/docs/ja/themes.mdx @@ -3,21 +3,21 @@ title: テーマ description: 組み込みのテーマを選択するか、独自のテーマを定義します。 --- -OpenCode を使用すると、いくつかの組み込みテーマから 1 つを選択したり、terminal のテーマに適合するテーマを使用したり、独自のカスタム テーマを定義したりできます。 +OpenCode を使用すると、いくつかの組み込みテーマから 1 つを選択したり、ターミナルのテーマに適合するテーマを使用したり、独自のカスタムテーマを定義したりできます。 デフォルトでは、OpenCode は独自の `opencode` テーマを使用します。 --- -## terminal要件 +## ターミナル要件 -テーマをフルカラー パレットで正しく表示するには、terminal が **truecolor** (24 ビット カラー) をサポートしている必要があります。最新のterminal のほとんどはデフォルトでこれをサポートしていますが、有効にする必要がある場合があります。 +テーマをフルカラーパレットで正しく表示するには、ターミナルが **Truecolor** (24 ビットカラー) をサポートしている必要があります。最新のターミナルのほとんどはデフォルトでこれをサポートしていますが、有効にする必要がある場合があります。 - **サポートを確認してください**: `echo $COLORTERM` を実行します - `truecolor` または `24bit` が出力されるはずです -- **トゥルーカラーを有効にする**: shell プロファイルで環境変数 `COLORTERM=truecolor` を設定します。 -- **terminal の互換性**: terminal エミュレータが 24 ビット カラーをサポートしていることを確認してください (iTerm2、Alacritty、Kitty、Windows terminal、および GNOME terminal の最新バージョンなどのほとんどの最新のterminalはサポートしています)。 +- **Truecolor を有効にする**: シェルプロファイルで環境変数 `COLORTERM=truecolor` を設定します。 +- **ターミナルの互換性**: ターミナルエミュレータが 24 ビットカラーをサポートしていることを確認してください (iTerm2、Alacritty、Kitty、Windows Terminal、および GNOME Terminal の最新バージョンなどのほとんどの最新のターミナルはサポートしています)。 -トゥルーカラーのサポートがないと、テーマの色の精度が低下したり、最も近い 256 色の近似値に戻ったりする可能性があります。 +Truecolor のサポートがないと、テーマの色の精度が低下したり、最も近い 256 色の近似値に戻ったりする可能性があります。 --- @@ -45,23 +45,23 @@ OpenCode にはいくつかの組み込みテーマが付属しています。 ## システムテーマ -`system` テーマは、terminal のカラースキームに自動的に適応するように設計されています。固定色を使用する従来のテーマとは異なり、_system_ テーマは次のようになります。 +`system` テーマは、ターミナルのカラースキームに自動的に適応するように設計されています。固定色を使用する従来のテーマとは異なり、_system_ テーマは次のようになります。 -- **グレー スケールを生成**: terminal の背景色に基づいてカスタム グレー スケールを作成し、最適なコントラストを確保します。 -- **ANSI カラーを使用**: 構文の強調表示と UI 要素に標準の ANSI カラー (0 ～ 15) を利用し、terminal のカラー パレットを尊重します。 -- **terminal のデフォルトを維持**: テキストと背景の色に `none` を使用して、terminal のネイティブの外観を維持します。 +- **グレースケールを生成**: ターミナルの背景色に基づいてカスタムグレースケールを作成し、最適なコントラストを確保します。 +- **ANSI カラーを使用**: 構文の強調表示と UI 要素に標準の ANSI カラー (0 ～ 15) を利用し、ターミナルのカラーパレットを尊重します。 +- **ターミナルのデフォルトを維持**: テキストと背景の色に `none` を使用して、ターミナルのネイティブの外観を維持します。 -システム テーマは、次のようなユーザーを対象としています。 +システムテーマは、次のようなユーザーを対象としています。 -- OpenCode をterminal の外観と一致させたい -- カスタムterminal のカラースキームを使用する -- すべてのterminalアプリケーションにわたって一貫した外観を好む +- OpenCode をターミナルの外観と一致させたい +- カスタムターミナルのカラースキームを使用する +- すべてのターミナルアプリケーションにわたって一貫した外観を好む --- ## テーマの使用 -テーマを選択するには、`/theme` コマンドでテーマ選択を表示します。または、[config](/docs/config). +テーマを選択するには、`/theme` コマンドでテーマ選択を表示します。または、[config](/docs/config) で設定します。 ```json title="opencode.json" {3} { @@ -74,6 +74,304 @@ OpenCode にはいくつかの組み込みテーマが付属しています。 ## カスタムテーマ +OpenCode は、ユーザーがテーマを簡単に作成およびカスタマイズできる柔軟な JSON ベースのテーマシステムをサポートしています。 + +--- + +### 優先順位 + +テーマは複数のディレクトリから次の順序でロードされ、後のディレクトリが前のディレクトリをオーバーライドします。 + +1. **組み込みテーマ** - これらはバイナリに埋め込まれています +2. **ユーザー設定ディレクトリ** - `~/.config/opencode/themes/*.json` または `$XDG_CONFIG_HOME/opencode/themes/*.json` で定義されます +3. **プロジェクトのルートディレクトリ** - `/.opencode/themes/*.json` で定義されます。 +4. **現在の作業ディレクトリ** - `./.opencode/themes/*.json` で定義 + +複数のディレクトリに同じ名前のテーマが含まれている場合は、優先度の高いディレクトリのテーマが使用されます。 + +--- + +### テーマの作成 + +カスタムテーマを作成するには、テーマディレクトリの 1 つに JSON ファイルを作成します。 + +ユーザー全体のテーマの場合: + +```bash no-frame +mkdir -p ~/.config/opencode/themes +vim ~/.config/opencode/themes/my-theme.json +``` + +そしてプロジェクト固有のテーマについても。 + +```bash no-frame +mkdir -p .opencode/themes +vim .opencode/themes/my-theme.json +``` + +--- + +### JSON 形式 + +テーマは、以下をサポートする柔軟な JSON 形式を使用します。 + +- **16 進数の色**: `"#ffffff"` +- **ANSI カラー**: `3` (0-255) +- **色の参照**: `"primary"` またはカスタム定義 +- **ダーク/ライトのバリエーション**: `{"dark": "#000", "light": "#fff"}` +- **色なし**: `"none"` - ターミナルのデフォルトの色または透明を使用します。 + +--- + +### 色の定義 + +`defs` セクションはオプションであり、テーマ内で参照できる再利用可能な色を定義できます。 + +--- + +### ターミナルのデフォルト + +特別な値 `"none"` を任意の色に使用して、ターミナルのデフォルトの色を継承できます。これは、ターミナルの配色とシームレスに融合するテーマを作成する場合に特に便利です。 + +- `"text": "none"` - ターミナルのデフォルトの前景色を使用します +- `"background": "none"` - ターミナルのデフォルトの背景色を使用します + +--- + +### 例 + +カスタムテーマの例を次に示します。 + +```json title="my-theme.json" +{ + "$schema": "https://opencode.ai/theme.json", + "defs": { + "nord0": "#2E3440", + "nord1": "#3B4252", + "nord2": "#434C5E", + "nord3": "#4C566A", + "nord4": "#D8DEE9", + "nord5": "#E5E9F0", + "nord6": "#ECEFF4", + "nord7": "#8FBCBB", + "nord8": "#88C0D0", + "nord9": "#81A1C1", + "nord10": "#5E81AC", + "nord11": "#BF616A", + "nord12": "#D08770", + "nord13": "#EBCB8B", + "nord14": "#A3BE8C", + "nord15": "#B48EAD" + }, + "theme": { + "primary": { + "dark": "nord8", + "light": "nord10" + }, + "secondary": { + "dark": "nord9", + "light": "nord9" + }, + "accent": { + "dark": "nord7", + "light": "nord7" + }, + "error": { + "dark": "nord11", + "light": "nord11" + }, + "warning": { + "dark": "nord12", + "light": "nord12" + }, + "success": { + "dark": "nord14", + "light": "nord14" + }, + "info": { + "dark": "nord8", + "light": "nord10" + }, + "text": { + "dark": "nord4", + "light": "nord0" + }, + "textMuted": { + "dark": "nord3", + "light": "nord1" + }, + "background": { + "dark": "nord0", + "light": "nord6" + }, + "backgroundPanel": { + "dark": "nord1", + "light": "nord5" + }, + "backgroundElement": { + "dark": "nord1", + "light": "nord4" + }, + "border": { + "dark": "nord2", + "light": "nord3" + }, + "borderActive": { + "dark": "nord3", + "light": "nord2" + }, + "borderSubtle": { + "dark": "nord2", + "light": "nord3" + }, + "diffAdded": { + "dark": "nord14", + "light": "nord14" + }, + "diffRemoved": { + "dark": "nord11", + "light": "nord11" + }, + "diffContext": { + "dark": "nord3", + "light": "nord3" + }, + "diffHunkHeader": { + "dark": "nord3", + "light": "nord3" + }, + "diffHighlightAdded": { + "dark": "nord14", + "light": "nord14" + }, + "diffHighlightRemoved": { + "dark": "nord11", + "light": "nord11" + }, + "diffAddedBg": { + "dark": "#3B4252", + "light": "#E5E9F0" + }, + "diffRemovedBg": { + "dark": "#3B4252", + "light": "#E5E9F0" + }, + "diffContextBg": { + "dark": "nord1", + "light": "nord5" + }, + "diffLineNumber": { + "dark": "nord2", + "light": "nord4" + }, + "diffAddedLineNumberBg": { + "dark": "#3B4252", + "light": "#E5E9F0" + }, + "diffRemovedLineNumberBg": { + "dark": "#3B4252", + "light": "#E5E9F0" + }, + "markdownText": { + "dark": "nord4", + "light": "nord0" + }, + "markdownHeading": { + "dark": "nord8", + "light": "nord10" + }, + "markdownLink": { + "dark": "nord9", + "light": "nord9" + }, + "markdownLinkText": { + "dark": "nord7", + "light": "nord7" + }, + "markdownCode": { + "dark": "nord14", + "light": "nord14" + }, + "markdownBlockQuote": { + "dark": "nord3", + "light": "nord3" + }, + "markdownEmph": { + "dark": "nord12", + "light": "nord12" + }, + "markdownStrong": { + "dark": "nord13", + "light": "nord13" + }, + "markdownHorizontalRule": { + "dark": "nord3", + "light": "nord3" + }, + "markdownListItem": { + "dark": "nord8", + "light": "nord10" + }, + "markdownListEnumeration": { + "dark": "nord7", + "light": "nord7" + }, + "markdownImage": { + "dark": "nord9", + "light": "nord9" + }, + "markdownImageText": { + "dark": "nord7", + "light": "nord7" + }, + "markdownCodeBlock": { + "dark": "nord4", + "light": "nord0" + }, + "syntaxComment": { + "dark": "nord3", + "light": "nord3" + }, + "syntaxKeyword": { + "dark": "nord9", + "light": "nord9" + }, + "syntaxFunction": { + "dark": "nord8", + "light": "nord8" + }, + "syntaxVariable": { + "dark": "nord7", + "light": "nord7" + }, + "syntaxString": { + "dark": "nord14", + "light": "nord14" + }, + "syntaxNumber": { + "dark": "nord15", + "light": "nord15" + }, + "syntaxType": { + "dark": "nord7", + "light": "nord7" + }, + "syntaxOperator": { + "dark": "nord9", + "light": "nord9" + }, + "syntaxPunctuation": { + "dark": "nord4", + "light": "nord0" + } + } +} +``` + +--- + +## カスタムテーマ + OpenCode は、ユーザーがテーマを簡単に作成およびカスタマイズできる柔軟な JSON ベースのテーマ システムをサポートしています。 --- @@ -129,7 +427,7 @@ vim .opencode/themes/my-theme.json --- -### terminal のデフォルト +### ターミナルのデフォルト 特別な値 `"none"` を任意の色に使用して、terminal のデフォルトの色を継承できます。これは、terminal の配色とシームレスに融合するテーマを作成する場合に特に便利です。 diff --git a/packages/web/src/content/docs/ja/tools.mdx b/packages/web/src/content/docs/ja/tools.mdx index 50bc8620b..6aa7e956f 100644 --- a/packages/web/src/content/docs/ja/tools.mdx +++ b/packages/web/src/content/docs/ja/tools.mdx @@ -3,13 +3,13 @@ title: ツール description: LLM が使用できるツールを管理します。 --- -ツールを使用すると、LLM がコードベースでアクションを実行できるようになります。 OpenCode には一連の組み込みツールが付属していますが、[カスタム ツール](/docs/custom-tools) または [MCP サーバー](/docs/mcp-servers). +ツールを使用すると、LLM がコードベースでアクションを実行できるようになります。 OpenCode には一連の組み込みツールが付属していますが、[カスタムツール](/docs/custom-tools) または [MCP サーバー](/docs/mcp-servers) を使用して拡張できます。 -デフォルトでは、すべてのツールは**有効**になっており、実行するための権限は必要ありません。 [permissions](/docs/permissions). +デフォルトでは、すべてのツールは**有効**になっており、実行するための権限は必要ありません。 [権限](/docs/permissions). --- -## 設定する +## 設定 `permission` フィールドを使用してツールの動作を制御します。各ツールを許可、拒否、または承認を要求することができます。 @@ -39,15 +39,15 @@ description: LLM が使用できるツールを管理します。 --- -## 内蔵 +## 組み込み OpenCode で利用可能なすべての組み込みツールを次に示します。 --- -### Bash +### bash -プロジェクト環境でshell コマンドを実行します。 +プロジェクト環境でシェルコマンドを実行します。 ```json title="opencode.json" {4} { @@ -58,11 +58,11 @@ OpenCode で利用可能なすべての組み込みツールを次に示しま } ``` -このツールを使用すると、LLM は `npm install`、`git status`、またはその他のshell コマンドなどのterminalコマンドを実行できます。 +このツールを使用すると、LLM は `npm install`、`git status`、またはその他のシェルコマンドなどのターミナルコマンドを実行できます。 --- -### 編集 +### edit 正確な文字列置換を使用して既存のファイルを変更します。 @@ -79,7 +79,7 @@ OpenCode で利用可能なすべての組み込みツールを次に示しま --- -### 書く +### write 新しいファイルを作成するか、既存のファイルを上書きします。 @@ -100,7 +100,7 @@ OpenCode で利用可能なすべての組み込みツールを次に示しま --- -### 読む +### read コードベースからファイルの内容を読み取ります。 @@ -130,11 +130,11 @@ OpenCode で利用可能なすべての組み込みツールを次に示しま } ``` -コードベース全体での高速コンテンツ検索。完全な正規表現構文とファイル パターン フィルタリングをサポートします。 +コードベース全体での高速コンテンツ検索。完全な正規表現構文とファイルパターンフィルタリングをサポートします。 --- -### グロブ +### glob パターンマッチングによりファイルを検索します。 @@ -147,11 +147,11 @@ OpenCode で利用可能なすべての組み込みツールを次に示しま } ``` -`**/*.js` や `src/**/*.ts` などの glob パターンを使用してファイルを検索します。一致するファイル パスを変更時間順に並べて返します。 +`**/*.js` や `src/**/*.ts` などの glob パターンを使用してファイルを検索します。一致するファイルパスを変更時間順に並べて返します。 --- -### リスト +### list 指定されたパス内のファイルとディレクトリを一覧表示します。 @@ -170,7 +170,7 @@ OpenCode で利用可能なすべての組み込みツールを次に示しま ### lsp (実験的) -構成された LSP サーバーと対話して、定義、参照、ホバー情報、呼び出し階層などのコード インテリジェンス機能を取得します。 +構成された LSP サーバーと対話して、定義、参照、ホバー情報、呼び出し階層などのコードインテリジェンス機能を取得します。 :::note このツールは、`OPENCODE_EXPERIMENTAL_LSP_TOOL=true` (または `OPENCODE_EXPERIMENTAL=true`) の場合にのみ使用できます。 @@ -191,7 +191,7 @@ OpenCode で利用可能なすべての組み込みツールを次に示しま --- -### パッチ +### patch ファイルにパッチを適用します。 @@ -204,7 +204,7 @@ OpenCode で利用可能なすべての組み込みツールを次に示しま } ``` -このツールは、コードベースにパッチ ファイルを適用します。さまざまなソースからの差分やパッチを適用するのに役立ちます。 +このツールは、コードベースにパッチファイルを適用します。さまざまなソースからの差分やパッチを適用するのに役立ちます。 :::note `patch` ツールは、すべてのファイル変更 (`edit`、`edit`、`write`、`patch`) をカバーする `multiedit` 権限によって制御されます。 @@ -212,7 +212,7 @@ OpenCode で利用可能なすべての組み込みツールを次に示しま --- -### スキル +### skill [skill](/docs/skills) (`SKILL.md` ファイル) をロードし、会話でその内容を返します。 @@ -229,7 +229,7 @@ OpenCode で利用可能なすべての組み込みツールを次に示しま ### todowrite -コーディング セッション中に ToDo リストを管理します。 +コーディングセッション中に ToDo リストを管理します。 ```json title="opencode.json" {4} { @@ -240,7 +240,7 @@ OpenCode で利用可能なすべての組み込みツールを次に示しま } ``` -タスク リストを作成および更新して、複雑な操作中の進行状況を追跡します。 LLM はこれを使用して、複数ステップのタスクを整理します。 +タスクリストを作成および更新して、複雑な操作中の進行状況を追跡します。 LLM はこれを使用して、複数ステップのタスクを整理します。 :::note このツールはデフォルトではサブエージェントに対して無効になっていますが、手動で有効にすることができます。 [詳細はこちら](/docs/agents/#permissions) @@ -248,7 +248,7 @@ OpenCode で利用可能なすべての組み込みツールを次に示しま --- -### トドリード +### todoread 既存の ToDo リストを読み取ります。 @@ -269,7 +269,7 @@ OpenCode で利用可能なすべての組み込みツールを次に示しま --- -### ウェブフェッチ +### webfetch Web コンテンツを取得します。 @@ -282,11 +282,11 @@ Web コンテンツを取得します。 } ``` -LLM が Web ページをフェッチして読み取ることを許可します。ドキュメントの検索やオンライン リソースの調査に役立ちます。 +LLM が Web ページをフェッチして読み取ることを許可します。ドキュメントの検索やオンラインリソースの調査に役立ちます。 --- -### ウェブ検索 +### websearch ウェブで情報を検索してください。 @@ -310,7 +310,7 @@ OPENCODE_ENABLE_EXA=1 opencode } ``` -Exa AI を使用して Web 検索を実行し、オンラインで関連情報を見つけます。トピックの調査、最新のイベントの検索、またはトレーニング データのカットオフを超えた情報の収集に役立ちます。 +Exa AI を使用して Web 検索を実行し、オンラインで関連情報を見つけます。トピックの調査、最新のイベントの検索、またはトレーニングデータのカットオフを超えた情報の収集に役立ちます。 API キーは必要ありません。ツールは認証なしで Exa AI のホストされた MCP サービスに直接接続します。 @@ -320,7 +320,7 @@ API キーは必要ありません。ツールは認証なしで Exa AI のホ --- -### 質問 +### question 実行中にユーザーに質問します。 @@ -346,21 +346,21 @@ API キーは必要ありません。ツールは認証なしで Exa AI のホ ## カスタムツール -カスタム ツールを使用すると、LLM が呼び出すことができる独自の関数を定義できます。これらは構成ファイルで定義されており、任意のコードを実行できます。 +カスタムツールを使用すると、LLM が呼び出すことができる独自の関数を定義できます。これらは設定ファイルで定義されており、任意のコードを実行できます。 -[カスタム ツールの作成について詳しくは、](/docs/custom-tools) をご覧ください。 +[カスタムツールの作成について詳しくは、](/docs/custom-tools) をご覧ください。 --- ## MCPサーバー -MCP (Model Context Protocol) サーバーを使用すると、外部ツールとサービスを統合できます。これには、データベース アクセス、API 統合、サードパーティ サービスが含まれます。 +MCP (Model Context Protocol) サーバーを使用すると、外部ツールとサービスを統合できます。これには、データベースアクセス、API 統合、サードパーティサービスが含まれます。 -[MCP サーバーの構成について詳しくは、](/docs/mcp-servers) をご覧ください。 +[MCP サーバーの設定について詳しくは、](/docs/mcp-servers) をご覧ください。 --- -## 内部構造 +## 内部動作 内部的には、`grep`、`glob`、`list` などのツールは内部で [ripgrep](https://github.com/BurntSushi/ripgrep) を使用します。デフォルトでは、ripgrep は `.gitignore` パターンを尊重します。つまり、`.gitignore` にリストされているファイルとディレクトリは検索とリストから除外されます。 diff --git a/packages/web/src/content/docs/ja/troubleshooting.mdx b/packages/web/src/content/docs/ja/troubleshooting.mdx index 132f7d08b..e58818da6 100644 --- a/packages/web/src/content/docs/ja/troubleshooting.mdx +++ b/packages/web/src/content/docs/ja/troubleshooting.mdx @@ -3,26 +3,26 @@ title: トラブルシューティング description: よくある問題とその解決方法。 --- -OpenCode の問題をデバッグするには、まず、ディスク上に保存されているログとローカル データを確認します。 +OpenCode の問題をデバッグするには、まず、ディスク上に保存されているログとローカルデータを確認します。 --- ## ログ -ログ ファイルは次の場所に書き込まれます。 +ログファイルは次の場所に書き込まれます。 - **macOS/Linux**: `~/.local/share/opencode/log/` - **Windows**: `WIN+R` を押して `%USERPROFILE%\.local\share\opencode\log` を貼り付けます -ログ ファイルにはタイムスタンプ付きの名前が付けられ (例: `2025-01-09T123456.log`)、最新の 10 個のログ ファイルが保存されます。 +ログファイルにはタイムスタンプ付きの名前が付けられ (例: `2025-01-09T123456.log`)、最新の 10 個のログファイルが保存されます。 -`--log-level` コマンドライン オプションを使用してログ レベルを設定すると、より詳細なデバッグ情報を取得できます。たとえば、`opencode --log-level DEBUG`。 +`--log-level` コマンドラインオプションを使用してログレベルを設定すると、より詳細なデバッグ情報を取得できます。たとえば、`opencode --log-level DEBUG`。 --- ## ストレージ -opencode は、セッション データとその他のアプリケーション データをディスク上の次の場所に保存します。 +OpenCode は、セッションデータとその他のアプリケーションデータをディスク上の次の場所に保存します。 - **macOS/Linux**: `~/.local/share/opencode/` - **Windows**: `WIN+R` を押して `%USERPROFILE%\.local\share\opencode` を貼り付けます @@ -31,7 +31,7 @@ opencode は、セッション データとその他のアプリケーション - `auth.json` - API キー、OAuth トークンなどの認証データ - `log/` - アプリケーションログ -- `project/` - セッション データやメッセージ データなどのプロジェクト固有のデータ +- `project/` - セッションデータやメッセージデータなどのプロジェクト固有のデータ - プロジェクトが Git リポジトリ内にある場合は、`.//storage/` に保存されます - Git リポジトリではない場合は、`./global/storage/` に保存されます @@ -39,21 +39,21 @@ opencode は、セッション データとその他のアプリケーション ## デスクトップアプリ -OpenCode Desktop は、ローカル OpenCode サーバー (`opencode-cli` サイドカー) をバックグラウンドで実行します。ほとんどの問題は、誤動作するプラグイン、破損したキャッシュ、または不正なサーバー設定によって発生します。 +OpenCode Desktop は、ローカル OpenCode サーバー (`opencode-cli` サイドカー) をバックグラウンドで実行します。ほとんどの問題は、誤動作しているプラグイン、破損したキャッシュ、または不正なサーバー設定によって発生します。 ### クイックチェック - アプリを完全に終了して再起動します。 - アプリにエラー画面が表示された場合は、**再起動** をクリックしてエラーの詳細をコピーします。 -- macOS のみ: `OpenCode` メニュー -> **Webview を再ロード** (UI が空白またはフリーズしている場合に役立ちます)。 +- macOS のみ: `OpenCode` メニュー -> **Webview をリロード** (UI が空白またはフリーズしている場合に役立ちます)。 --- ### プラグインを無効にする -デスクトップ アプリが起動時にクラッシュしたり、ハングしたり、異常な動作をしたりする場合は、まずプラグインを無効にしてください。 +デスクトップアプリが起動時にクラッシュしたり、ハングしたり、異常な動作をしたりする場合は、まずプラグインを無効にしてください。 -#### グローバル設定を確認してください +#### グローバル設定の確認 グローバル設定ファイルを開き、`plugin` キーを探します。 @@ -70,14 +70,14 @@ OpenCode Desktop は、ローカル OpenCode サーバー (`opencode-cli` サイ } ``` -#### プラグインのディレクトリを確認する +#### プラグインディレクトリの確認 -OpenCode はディスクからローカル プラグインをロードすることもできます。これらを一時的に邪魔にならない場所に移動し (またはフォルダーの名前を変更し)、デスクトップ アプリを再起動します。 +OpenCode はディスクからローカルプラグインをロードすることもできます。これらを一時的に邪魔にならない場所に移動し (またはフォルダーの名前を変更し)、デスクトップアプリを再起動します。 -- **グローバル プラグイン** +- **グローバルプラグイン** - **macOS/Linux**: `~/.config/opencode/plugins/` - **Windows**: `WIN+R` を押して `%USERPROFILE%\.config\opencode\plugins` を貼り付けます -- **プロジェクト プラグイン** (プロジェクトごとの構成を使用する場合のみ) +- **プロジェクトプラグイン** (プロジェクトごとの構成を使用する場合のみ) - `/.opencode/plugins/` アプリが再び動作し始めた場合は、プラグインを 1 つずつ再度有効にして、問題の原因となっているプラ​​グインを特定します。 @@ -89,7 +89,7 @@ OpenCode はディスクからローカル プラグインをロードするこ プラグインを無効にしても解決しない場合 (またはプラグインのインストールが停止した場合)、OpenCode がキャッシュを再構築できるようにキャッシュをクリアします。 1. OpenCode Desktop を完全に終了します。 -2. キャッシュ ディレクトリを削除します。 +2. キャッシュディレクトリを削除します。 - **macOS**: Finder -> `Cmd+Shift+G` -> `~/.cache/opencode` を貼り付け - **Linux**: `~/.cache/opencode` を削除します (または `rm -rf ~/.cache/opencode` を実行します)。 @@ -99,23 +99,23 @@ OpenCode はディスクからローカル プラグインをロードするこ --- -### サーバー接続の問題を修正する +### サーバー接続の問題の修正 -OpenCode Desktop は、独自のローカル サーバー (デフォルト) を起動することも、構成したサーバー URL に接続することもできます。 +OpenCode Desktop は、独自のローカルサーバー (デフォルト) を起動することも、構成したサーバー URL に接続することもできます。 -**「接続に失敗しました」** ダイアログが表示された場合 (またはアプリがスプラッシュ画面を通過できない場合)、カスタム サーバー URL を確認してください。 +**「接続に失敗しました」** ダイアログが表示された場合 (またはアプリがスプラッシュ画面を通過できない場合)、カスタムサーバー URL を確認してください。 #### デスクトップのデフォルトのサーバー URL をクリアします -ホーム画面でサーバー名 (ステータス ドット付き) をクリックしてサーバー ピッカーを開きます。 [**デフォルト サーバー**] セクションで、[**クリア**] をクリックします。 +ホーム画面でサーバー名 (ステータスドット付き) をクリックしてサーバーピッカーを開きます。 [**デフォルトサーバー**] セクションで、[**クリア**] をクリックします。 #### 設定から `server.port` / `server.hostname` を削除します -`opencode.json(c)` に `server` セクションが含まれている場合は、それを一時的に削除し、デスクトップ アプリを再起動します。 +`opencode.json(c)` に `server` セクションが含まれている場合は、それを一時的に削除し、デスクトップアプリを再起動します。 #### 環境変数を確認する -環境に `OPENCODE_PORT` が設定されている場合、デスクトップ アプリはローカル サーバーにそのポートを使用しようとします。 +環境に `OPENCODE_PORT` が設定されている場合、デスクトップアプリはローカルサーバーにそのポートを使用しようとします。 - `OPENCODE_PORT` の設定を解除して (または空きポートを選択して)、再起動します。 @@ -123,7 +123,7 @@ OpenCode Desktop は、独自のローカル サーバー (デフォルト) を ### Linux: Wayland / X11 の問題 -Linux では、一部の Wayland セットアップにより、空白のウィンドウやコンポジター エラーが発生する可能性があります。 +Linux では、一部の Wayland セットアップにより、空白のウィンドウやコンポジターエラーが発生する可能性があります。 - Wayland を使用していて、アプリが空白またはクラッシュしている場合は、`OC_ALLOW_WAYLAND=1` で起動してみてください。 - これにより状況が悪化する場合は、それを削除し、代わりに X11 セッションで起動してみてください。 @@ -138,7 +138,7 @@ Windows では、OpenCode Desktop には Microsoft Edge **WebView2 ランタイ ### Windows: 一般的なパフォーマンスの問題 -Windows でパフォーマンスの低下、ファイル アクセスの問題、またはterminal の問題が発生している場合は、[WSL (Windows Subsystem for Linux)](/docs/windows-wsl) を使用してみてください。 WSL は、OpenCode の機能とよりシームレスに連携する Linux 環境を提供します。 +Windows でパフォーマンスの低下、ファイルアクセスの問題、またはターミナルの問題が発生している場合は、[WSL (Windows Subsystem for Linux)](/docs/windows-wsl) を使用してみてください。 WSL は、OpenCode の機能とよりシームレスに連携する Linux 環境を提供します。 --- @@ -151,12 +151,12 @@ OpenCode Desktop では、次の場合にのみシステム通知が表示され --- -### デスクトップ アプリのストレージをリセットする (最後の手段) +### デスクトップアプリのストレージのリセット (最後の手段) -アプリが起動せず、UI 内から設定をクリアできない場合は、デスクトップ アプリの保存された状態をリセットします。 +アプリが起動せず、UI 内から設定をクリアできない場合は、デスクトップアプリの保存された状態をリセットします。 1. OpenCode デスクトップを終了します。 -2. これらのファイルを見つけて削除します (これらのファイルは OpenCode デスクトップ アプリのデータ ディレクトリにあります)。 +2. これらのファイルを見つけて削除します (これらのファイルは OpenCode デスクトップアプリのデータディレクトリにあります)。 - `opencode.settings.dat` (デスクトップのデフォルトサーバー URL) - `opencode.global.dat` および `opencode.workspace.*.dat` (最近のサーバー/プロジェクトなどの UI 状態) @@ -169,7 +169,7 @@ OpenCode Desktop では、次の場合にのみシステム通知が表示され --- -## 助けを求める +## ヘルプを求める OpenCode で問題が発生している場合: @@ -181,7 +181,7 @@ OpenCode で問題が発生している場合: 新しい問題を作成する前に、既存の問題を検索して、問題がすでに報告されているかどうかを確認してください。 -2. **Discord に参加してください** +2. **Discord への参加** リアルタイムのヘルプやコミュニティのディスカッションについては、Discord サーバーに参加してください。 @@ -195,10 +195,10 @@ OpenCode で問題が発生している場合: --- -### OpenCodeが起動しない +### OpenCode が起動しない -1. ログでエラー メッセージを確認する -2. `--print-logs` で実行して、terminal に出力を確認してください。 +1. ログでエラーメッセージを確認する +2. `--print-logs` で実行して、ターミナルに出力を確認してください。 3. `opencode upgrade` を含む最新バージョンを使用していることを確認してください --- @@ -211,7 +211,7 @@ OpenCode で問題が発生している場合: --- -### モデルがありません +### モデルが見つからない 1. プロバイダーで認証されていることを確認してください 2. 構成内のモデル名が正しいことを確認してください @@ -237,42 +237,42 @@ ProviderInitError が発生した場合は、構成が無効または破損し これを解決するには: -1. まず、[プロバイダー ガイド](/docs/providers) に従って、プロバイダーが正しく設定されていることを確認します。 +1. まず、[プロバイダーガイド](/docs/providers) に従って、プロバイダーが正しく設定されていることを確認します。 2. 問題が解決しない場合は、保存されている構成をクリアしてみてください。 ```bash rm -rf ~/.local/share/opencode ``` -Windows では、`WIN+R` を押して、`%USERPROFILE%\.local\share\opencode` を削除します。 + Windows では、`WIN+R` を押して、`%USERPROFILE%\.local\share\opencode` を削除します。 3. TUI の `/connect` コマンドを使用して、プロバイダーで再認証します。 --- -### AI_APICallError とプロバイダー パッケージの問題 +### AI_APICallError とプロバイダーパッケージの問題 -API 呼び出しエラーが発生した場合は、プロバイダー パッケージが古いことが原因である可能性があります。 opencode は、必要に応じてプロバイダー パッケージ (OpenAI、Anthropic、Google など) を動的にインストールし、ローカルにキャッシュします。 +API 呼び出しエラーが発生した場合は、プロバイダーパッケージが古いことが原因である可能性があります。 OpenCode は、必要に応じてプロバイダーパッケージ (OpenAI、Anthropic、Google など) を動的にインストールし、ローカルにキャッシュします。 -プロバイダー パッケージの問題を解決するには: +プロバイダーパッケージの問題を解決するには: -1. プロバイダー パッケージのキャッシュをクリアします。 +1. プロバイダーパッケージのキャッシュをクリアします。 ```bash rm -rf ~/.cache/opencode ``` -Windows では、`WIN+R` を押して、`%USERPROFILE%\.cache\opencode` を削除します。 + Windows では、`WIN+R` を押して、`%USERPROFILE%\.cache\opencode` を削除します。 -2. opencodeを再起動して最新のプロバイダー パッケージを再インストールします +2. OpenCode を再起動して最新のプロバイダーパッケージを再インストールします -これにより、opencodeはプロバイダー パッケージの最新バージョンを強制的にダウンロードすることになり、多くの場合、モデル パラメーターや API の変更に関する互換性の問題が解決されます。 +これにより、OpenCode はプロバイダーパッケージの最新バージョンを強制的にダウンロードすることになり、多くの場合、モデルパラメーターや API の変更に関する互換性の問題が解決されます。 --- ### Linux ではコピー/ペーストが機能しない -Linux ユーザーがコピー/ペースト機能を動作させるには、次のクリップボード ユーティリティのいずれかがインストールされている必要があります。 +Linux ユーザーがコピー/ペースト機能を動作させるには、次のクリップボードユーティリティのいずれかがインストールされている必要があります。 **X11 システムの場合:** @@ -297,4 +297,4 @@ Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 & export DISPLAY=:99.0 ``` -opencode は、Wayland を使用していて `wl-clipboard` を優先しているかどうかを検出します。そうでない場合は、`xclip` および `xsel` の順序でクリップボード ツールを検索しようとします。 +OpenCode は、Wayland を使用していて `wl-clipboard` を優先しているかどうかを検出します。そうでない場合は、`xclip` および `xsel` の順序でクリップボードツールを検索しようとします。 diff --git a/packages/web/src/content/docs/ja/tui.mdx b/packages/web/src/content/docs/ja/tui.mdx index b7ec3a482..36c94fffc 100644 --- a/packages/web/src/content/docs/ja/tui.mdx +++ b/packages/web/src/content/docs/ja/tui.mdx @@ -1,11 +1,11 @@ --- -title: トゥイ -description: OpenCode terminal ユーザー インターフェイスの使用。 +title: TUI +description: OpenCode ターミナルユーザーインターフェイスの使用。 --- import { Tabs, TabItem } from "@astrojs/starlight/components" -OpenCode は、LLM を使用してプロジェクトを作業するための対話型terminal インターフェイスまたは TUI を提供します。 +OpenCode は、LLM を使用してプロジェクトを作業するための対話型ターミナルインターフェイスまたは TUI を提供します。 OpenCode を実行すると、現在のディレクトリの TUI が開始されます。 @@ -45,7 +45,7 @@ How is auth handled in @packages/functions/src/api/index.ts? ## Bash コマンド -メッセージを `!` で開始して、shell コマンドを実行します。 +メッセージを `!` で開始して、シェルコマンドを実行します。 ```bash frame="none" !ls -la @@ -63,13 +63,13 @@ OpenCode TUI を使用する場合、「`/`」に続いてコマンド名を入 /help ``` -ほとんどのコマンドには、`ctrl+x` をリーダー キーとして使用するキーバインドもあります。`ctrl+x` がデフォルトのリーダー キーです。 [詳細はこちら](/docs/keybinds)。 +ほとんどのコマンドには、`ctrl+x` をリーダーキーとして使用するキーバインドもあります。`ctrl+x` がデフォルトのリーダーキーです。 [詳細はこちら](/docs/keybinds)。 -利用可能なすべてのスラッシュ コマンドは次のとおりです。 +利用可能なすべてのスラッシュコマンドは次のとおりです。 --- -### 接続する +### 接続 OpenCode にプロバイダーを追加します。利用可能なプロバイダーから選択し、その API キーを追加できます。 @@ -115,9 +115,9 @@ OpenCode にプロバイダーを追加します。利用可能なプロバイ --- -### 出口 +### 終了 -OpenCodeを終了します。 _エイリアス_: `/quit`、`/q` +OpenCode を終了します。 _エイリアス_: `/quit`、`/q` ```bash frame="none" /exit @@ -127,7 +127,7 @@ OpenCodeを終了します。 _エイリアス_: `/quit`、`/q` --- -### 輸出 +### エクスポート 現在の会話を Markdown にエクスポートし、デフォルトのエディターで開きます。 `EDITOR` 環境変数に設定されたエディタを使用します。 [詳細はこちら](#editor-setup)。 @@ -175,7 +175,7 @@ OpenCodeを終了します。 _エイリアス_: `/quit`、`/q` --- -### 新しい +### 新規セッション 新しいセッションを開始します。 _別名_: `/clear` @@ -194,8 +194,7 @@ OpenCodeを終了します。 _エイリアス_: `/quit`、`/q` :::tip ファイルの変更も復元されます。 ::: -Internally, を使用してファイルの変更を管理します。したがって、あなたのプロジェクトは ** する必要があります -Git リポジトリ** であること。 +内部的には、`undo` を使用してファイルの変更を管理します。したがって、あなたのプロジェクトは **Git リポジトリ** である必要があります。 ```bash frame="none" /redo @@ -241,12 +240,12 @@ Git リポジトリ** であること。 --- -### 考え +### 思考 会話内の思考/推論ブロックの表示を切り替えます。有効にすると、拡張思考をサポートするモデルの推論プロセスを確認できます。 :::note -このコマンドは、思考ブロックを**表示**するかどうかのみを制御します。モデルの推論機能を有効または無効にすることはありません。実際の推論機能を切り替えるには、`ctrl+t` を使用してモデル バリアントを循環させます。 +このコマンドは、思考ブロックを**表示**するかどうかのみを制御します。モデルの推論機能を有効または無効にすることはありません。実際の推論機能を切り替えるには、`ctrl+t` を使用してモデルバリアントを循環させます。 ::: ```bash frame="none" @@ -257,13 +256,12 @@ Git リポジトリ** であること。 ### 元に戻す -会話の最後のメッセージを元に戻します。最新のユーザー メッセージ、その後のすべての応答、およびファイルの変更を削除します。 +会話の最後のメッセージを元に戻します。最新のユーザーメッセージ、その後のすべての応答、およびファイルの変更を削除します。 :::tip 加えられたファイルの変更も元に戻されます。 ::: -Internally, を使用してファイルの変更を管理します。したがって、あなたのプロジェクトは ** する必要があります -Git リポジトリ** であること。 +内部的には、`undo` を使用してファイルの変更を管理します。したがって、あなたのプロジェクトは **Git リポジトリ** である必要があります。 ```bash frame="none" /undo @@ -273,7 +271,7 @@ Git リポジトリ** であること。 --- -### 共有を解除する +### 共有の解除 現在のセッションの共有を解除します。 [詳細はこちら](/docs/share#un-sharing)。 @@ -283,7 +281,7 @@ Git リポジトリ** であること。 --- -## エディターのセットアップ +## エディタのセットアップ `/editor` および `/export` コマンドはどちらも、`EDITOR` 環境変数で指定されたエディターを使用します。 @@ -299,7 +297,7 @@ Git リポジトリ** であること。 export EDITOR="code --wait" ``` -これを永続的にするには、これをshell プロファイルに追加します。 +これを永続的にするには、これをシェルプロファイルに追加します。 `~/.bashrc`、`~/.zshrc`など @@ -313,8 +311,7 @@ Git リポジトリ** であること。 set EDITOR=code --wait ``` -これを永続的にするには、**システム プロパティ** > **環境を使用します。 -変数**。 +これを永続的にするには、**システムプロパティ** > **環境変数**を使用します。 @@ -332,7 +329,7 @@ Git リポジトリ** であること。 -一般的なエディター オプションには次のものがあります。 +一般的なエディターオプションには次のものがあります。 - `code` - VS Code - `cursor` - Cursor @@ -350,9 +347,9 @@ VS Code などの一部のエディターは、`--wait` フラグを使用して --- -## 設定する +## 設定 -OpenCode 構成ファイルを通じて TUI の動作をカスタマイズできます。 +OpenCode 設定ファイルを通じて TUI の動作をカスタマイズできます。 ```json title="opencode.json" { @@ -368,20 +365,20 @@ OpenCode 構成ファイルを通じて TUI の動作をカスタマイズでき ### オプション -- `scroll_acceleration` - macOS スタイルのスクロール アクセラレーションを有効にして、スムーズで自然なスクロールを実現します。有効にすると、高速スクロール ジェスチャではスクロール速度が向上し、ゆっくりとした動きでは正確なままになります。 **この設定は `scroll_speed` よりも優先され、有効になっている場合は上書きされます。** -- `scroll_speed` - スクロール コマンドを使用するときに TUI がスクロールする速度を制御します (最小: `1`)。デフォルトは `3` です。 **注: `scroll_acceleration.enabled` が `true` に設定されている場合、これは無視されます。** +- `scroll_acceleration` - macOS スタイルのスクロールアクセラレーションを有効にして、スムーズで自然なスクロールを実現します。有効にすると、高速スクロールジェスチャではスクロール速度が向上し、ゆっくりとした動きでは正確なままになります。 **この設定は `scroll_speed` よりも優先され、有効になっている場合は上書きされます。** +- `scroll_speed` - スクロールコマンドを使用するときに TUI がスクロールする速度を制御します (最小: `1`)。デフォルトは `3` です。 **注: `scroll_acceleration.enabled` が `true` に設定されている場合、これは無視されます。** --- ## カスタマイズ -コマンド パレット (`ctrl+x h` または `/help`) を使用して、TUI ビューのさまざまな側面をカスタマイズできます。これらの設定は再起動後も維持されます。 +コマンドパレット (`ctrl+x h` または `/help`) を使用して、TUI ビューのさまざまな側面をカスタマイズできます。これらの設定は再起動後も維持されます。 --- #### ユーザー名の表示 -チャット メッセージにユーザー名を表示するかどうかを切り替えます。これには次の方法でアクセスします。 +チャットメッセージにユーザー名を表示するかどうかを切り替えます。これには次の方法でアクセスします。 - コマンドパレット:「ユーザー名」または「ユーザー名を隠す」を検索します。 - 設定は自動的に保持され、TUI セッション全体で記憶されます。 diff --git a/packages/web/src/content/docs/ja/web.mdx b/packages/web/src/content/docs/ja/web.mdx index 030186d07..77095dac7 100644 --- a/packages/web/src/content/docs/ja/web.mdx +++ b/packages/web/src/content/docs/ja/web.mdx @@ -3,10 +3,12 @@ title: ウェブ description: ブラウザで OpenCode を使用する。 --- -OpenCode はブラウザーで Web アプリケーションとして実行でき、terminal を必要とせずに同じ強力な AI コーディング エクスペリエンスを提供します。 +OpenCode はブラウザで Web アプリケーションとして実行でき、ターミナルを必要とせずに同じ強力な AI コーディングエクスペリエンスを提供します。 ![OpenCode Web - 新しいセッション](../../../assets/web/web-homepage-new-session.png) +--- + ## はじめる 以下を実行して Web インターフェースを開始します。 @@ -15,19 +17,20 @@ OpenCode はブラウザーで Web アプリケーションとして実行でき opencode web ``` -これにより、利用可能なランダムなポートを使用して `127.0.0.1` でローカル サーバーが起動され、デフォルトのブラウザで OpenCode が自動的に開きます。 +これにより、利用可能なランダムなポートを使用して `127.0.0.1` でローカルサーバーが起動され、デフォルトのブラウザで OpenCode が自動的に開きます。 :::caution -`OPENCODE_SERVER_PASSWORD` が設定されていない場合、サーバーは保護されません。これはローカルで使用する場合には問題ありませんが、ネットワーク アクセス用に設定する必要があります。 +`OPENCODE_SERVER_PASSWORD` が設定されていない場合、サーバーは保護されません。これはローカルで使用する場合には問題ありませんが、ネットワークアクセス用に設定する必要があります。 +::: :::tip[Windows ユーザー] -最高のエクスペリエンスを得るには、PowerShell ではなく [WSL](/docs/windows-wsl) から `opencode web` を実行します。これにより、ファイル システムへの適切なアクセスとterminal の統合が保証されます。 +最高のエクスペリエンスを得るには、PowerShell ではなく [WSL](/docs/windows-wsl) から `opencode web` を実行します。これにより、ファイルシステムへの適切なアクセスとターミナルの統合が保証されます。 ::: --- -## 構成 +## 設定 -コマンド ライン フラグを使用するか、[config file](/docs/config).config ファイル] で Web サーバーを設定できます。 +コマンドラインフラグを使用するか、[設定ファイル](/docs/config)で Web サーバーを設定できます。 ### ポート @@ -45,16 +48,16 @@ opencode web --port 4096 opencode web --hostname 0.0.0.0 ``` -`0.0.0.0` を使用すると、OpenCode はローカル アドレスとネットワーク アドレスの両方を表示します。 +`0.0.0.0` を使用すると、OpenCode はローカルアドレスとネットワークアドレスの両方を表示します。 ``` Local access: http://localhost:4096 Network access: http://192.168.1.100:4096 ``` -### mDNS ディスカバリー +### mDNS 検出 -mDNS を有効にして、ローカル ネットワーク上でサーバーを検出できるようにします。 +mDNS を有効にして、ローカルネットワーク上でサーバーを検出できるようにします。 ```bash opencode web --mdns @@ -68,9 +71,9 @@ mDNS ドメイン名をカスタマイズして、同じネットワーク上で opencode web --mdns --mdns-domain myproject.local ``` -### コルス +### CORS -CORS の追加ドメインを許可するには (カスタム フロントエンドに便利): +CORS の追加ドメインを許可するには (カスタムフロントエンドに便利): ```bash opencode web --cors https://example.com @@ -102,13 +105,13 @@ OPENCODE_SERVER_PASSWORD=secret opencode web 「サーバーを表示」をクリックすると、接続されているサーバーとそのステータスが表示されます。 -![OpenCode Web - Servers](../../../assets/web/web-homepage-see-servers.png) を参照 +![OpenCode Web - サーバー](../../../assets/web/web-homepage-see-servers.png) --- -## terminal の接続 +## ターミナルの接続 -実行中の Web サーバーにterminal TUI を接続できます。 +実行中の Web サーバーにターミナル TUI を接続できます。 ```bash # Start the web server @@ -118,13 +121,13 @@ opencode web --port 4096 opencode attach http://localhost:4096 ``` -これにより、Web インターフェイスとterminal の両方を同時に使用し、同じセッションと状態を共有できるようになります。 +これにより、Web インターフェイスとターミナルの両方を同時に使用し、同じセッションと状態を共有できるようになります。 --- ## 設定ファイル -`opencode.json` 構成ファイルでサーバー設定を構成することもできます。 +`opencode.json` 設定ファイルでサーバー設定を構成することもできます。 ```json { @@ -137,4 +140,4 @@ opencode attach http://localhost:4096 } ``` -コマンド ライン フラグは、構成ファイルの設定よりも優先されます。 +コマンドラインフラグは、設定ファイルの設定よりも優先されます。 diff --git a/packages/web/src/content/docs/ja/windows-wsl.mdx b/packages/web/src/content/docs/ja/windows-wsl.mdx index 190d80641..f5a09f270 100644 --- a/packages/web/src/content/docs/ja/windows-wsl.mdx +++ b/packages/web/src/content/docs/ja/windows-wsl.mdx @@ -8,7 +8,7 @@ import { Steps } from "@astrojs/starlight/components" OpenCode は Windows で直接実行できますが、より快適に使うには [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) の利用をおすすめします。WSL は OpenCode の機能とスムーズに連携する Linux 環境を提供します。 :::tip[WSL を使う理由] -WSL を使うと、ファイルシステム性能、terminalサポート、OpenCode が依存する開発ツールとの互換性が向上します。 +WSL を使うと、ファイルシステム性能、ターミナルサポート、OpenCode が依存する開発ツールとの互換性が向上します。 ::: --- @@ -23,7 +23,7 @@ WSL を使うと、ファイルシステム性能、terminalサポート、OpenC 2. **WSL で OpenCode をインストールする** - WSL の準備ができたら WSL のterminal を開き、[インストール方法](/docs/) のいずれかで OpenCode をインストールします。 + WSL の準備ができたら WSL のターミナルを開き、[インストール方法](/docs/) のいずれかで OpenCode をインストールします。 ```bash curl -fsSL https://opencode.ai/install | bash @@ -44,7 +44,7 @@ WSL を使うと、ファイルシステム性能、terminalサポート、OpenC ## デスクトップアプリ + WSL サーバー -OpenCode Desktop アプリを使いつつ、サーバーは WSL で動かしたい場合は次の手順です。 +OpenCode デスクトップアプリを使いつつ、サーバーは WSL で動かしたい場合は次の手順です。 1. **WSL でサーバーを起動する** @@ -54,12 +54,13 @@ OpenCode Desktop アプリを使いつつ、サーバーは WSL で動かした opencode serve --hostname 0.0.0.0 --port 4096 ``` -2. **Desktop アプリを接続する** +2. **デスクトップアプリを接続する** `http://localhost:4096` に接続します。 :::note 環境によって `localhost` が使えない場合は、WSL 側で `hostname -I` を実行して IP アドレスを確認し、`http://:4096` に接続してください。 +::: :::caution `--hostname 0.0.0.0` を使う場合は、`OPENCODE_SERVER_PASSWORD` を設定してサーバーを保護してください。 @@ -73,17 +74,17 @@ OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0 Windows で Web 利用を快適にするには: -1. **PowerShell ではなく WSL terminal で `opencode web` を実行する** +1. **PowerShell ではなく WSL ターミナルで `opencode web` を実行する** ```bash opencode web --hostname 0.0.0.0 ``` -2. **Windows のブラウザーからアクセスする** +2. **Windows のブラウザからアクセスする** `http://localhost:` にアクセスします（URL は OpenCode が表示します）。 -WSL から `opencode web` を実行すると、適切なファイルシステムアクセスとterminal 統合を維持したまま、Windows ブラウザーから利用できます。 +WSL から `opencode web` を実行すると、適切なファイルシステムアクセスとターミナル統合を維持したまま、Windows ブラウザから利用できます。 --- @@ -111,5 +112,5 @@ opencode ## ヒント - Windows ドライブ上のプロジェクトでも、OpenCode は WSL で実行するとファイルアクセスがスムーズです -- OpenCode と一緒に VS Code の [WSL 拡張](https://code.visualstudio.com/docs/remote/wsl) を使うと統合的な開発フローを構築できます +- OpenCode と一緒に VS Code の [WSL 拡張機能](https://code.visualstudio.com/docs/remote/wsl) を使うと統合的な開発フローを構築できます - OpenCode の設定とセッションは WSL 環境内の `~/.local/share/opencode/` に保存されます diff --git a/packages/web/src/content/docs/ja/zen.mdx b/packages/web/src/content/docs/ja/zen.mdx index 0f5df718e..751ca45e4 100644 --- a/packages/web/src/content/docs/ja/zen.mdx +++ b/packages/web/src/content/docs/ja/zen.mdx @@ -1,5 +1,5 @@ --- -title: 禅 +title: OpenCode Zen description: OpenCode によって提供されるモデルの厳選されたリスト。 --- @@ -12,22 +12,20 @@ OpenCode Zen は、OpenCode チームによって提供される、テストお :::note OpenCode Zen は現在ベータ版です。 ::: -Zen は OpenCode の他のプロバイダーと同様に機能します。 OpenCode Zen にログインすると、 -API キー。これは **完全にオプション** であり、使用するために使用する必要はありません。 -OpenCode. +Zen は OpenCode の他のプロバイダーと同様に機能します。 OpenCode Zen にログインすると、API キーを取得できます。これは **完全にオプション** であり、OpenCode を使用するために使用する必要はありません。 --- ## 背景 モデルはたくさんありますが、そのうちのほんの一部です -これらのモデルはコーディング エージェントとしてうまく機能します。さらに、ほとんどのプロバイダーは、 +これらのモデルはコーディングエージェントとしてうまく機能します。さらに、ほとんどのプロバイダーは、 構成が大きく異なります。したがって、まったく異なるパフォーマンスと品質が得られます。 :::tip 私たちは、OpenCode で適切に動作するモデルとプロバイダーの選択されたグループをテストしました。 ::: -So などを通じてモデルを使用している場合は、決してそうすることはできません。 +OpenRouter などを通じてモデルを使用している場合は、決してそうすることはできません。 必要なモデルの最高のバージョンを入手しているかどうかを確認してください。 これを修正するために、いくつかのことを行いました。 @@ -35,7 +33,6 @@ So などを通じてモデルを使用している場合は、決してそう 1. 私たちは選択したモデルのグループをテストし、その方法についてチームと話し合いました。 それらを実行するのが最善です。 2. その後、いくつかのプロバイダーと協力して、これらが確実に提供されるようにしました。 - correctly. 3. 最後に、モデルとプロバイダーの組み合わせをベンチマークし、次の結果を導き出しました。 私たちが自信を持ってお勧めするリストをご紹介します。 @@ -93,7 +90,7 @@ OpenCode Zen は、OpenCode の他のプロバイダーと同様に機能しま | Big Pickle | big-pickle | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | OpenCode 設定の [model id](/docs/config/#models) -`opencode/` 形式を使用します。たとえば、GPT 5.2 Codex の場合は、次のようになります。 +`opencode/` 形式を使用します。たとえば、GPT 5.2 Codex の場合は、 設定で `opencode/gpt-5.2-codex` を使用してください。 --- @@ -108,7 +105,7 @@ https://opencode.ai/zen/v1/models --- -## 価格設定 +## 価格 当社は従量課金制モデルをサポートしています。以下は **100 万トークンあたりの価格**です。 @@ -148,17 +145,16 @@ https://opencode.ai/zen/v1/models | GPT 5 Codex | $1.07 | $8.50 | $0.107 | - | | GPT 5 Nano | Free | Free | Free | - | -使用履歴に _Claude Haiku 3.5_ が表示されるかもしれません。これは [セッションのタイトルを生成するために使用される低コスト モデル ](/docs/config/#models) です。 +使用履歴に _Claude Haiku 3.5_ が表示されるかもしれません。これは [セッションのタイトルを生成するために使用される低コストモデル](/docs/config/#models) です。 :::note -クレジット カード手数料は実費で引き継がれます (4.4% + 取引ごとに 0.30 ドル)。それ以上の料金はかかりません。 +クレジットカード手数料は実費で引き継がれます (4.4% + 取引ごとに 0.30 ドル)。それ以上の料金はかかりません。 ::: -The - GLM 4.7 Free は期間限定で OpenCode で入手できます。チームはこの時間を利用してフィードバックを収集し、モデルを改善します。 - Kim K2.5 Free は OpenCode で期間限定で利用可能です。チームはこの時間を利用してフィードバックを収集し、モデルを改善します。 - MiniMax M2.1 Free は期間限定で OpenCode で入手できます。チームはこの時間を利用してフィードバックを収集し、モデルを改善します。 -- Big Pickle は、期間限定で OpenCode で無料で利用できるステルス モデルです。チームはこの時間を利用してフィードバックを収集し、モデルを改善します。 +- Big Pickle は、期間限定で OpenCode で無料で利用できるステルスモデルです。チームはこの時間を利用してフィードバックを収集し、モデルを改善します。 ご質問がございましたら、お問い合わせください。 @@ -191,8 +187,8 @@ The - GLM 4.7 無料: 無料期間中、収集されたデータはモデルを改善するために使用される場合があります。 - Kimi K2.5 Free: 無料期間中、収集されたデータはモデルの改善に使用される場合があります。 - MiniMax M2.1 無料: 無料期間中、収集されたデータはモデルを改善するために使用される場合があります。 -- OpenAI API: リクエストは [OpenAI のデータ ポリシー ](https://platform.openai.com/docs/guides/your-data). -- Anthropic API: リクエストは、[Anthropic のデータ ポリシー ](https://docs.anthropic.com/en/docs/claude-code/data-usage). +- OpenAI API: リクエストは [OpenAI のデータポリシー](https://platform.openai.com/docs/guides/your-data)に従います。 +- Anthropic API: リクエストは、[Anthropic のデータポリシー](https://docs.anthropic.com/en/docs/claude-code/data-usage)に従います。 --- @@ -204,12 +200,11 @@ Zen はチームにも効果的です。チームメイトを招待し、役割 :::note ワークスペースは現在、ベータ版の一部としてチームに無料で提供されています。 ::: -Managing 価格の詳細については近日中にお知らせします。 --- -### 役割 +### ロール チームメイトをワークスペースに招待し、役割を割り当てることができます。 @@ -229,7 +224,7 @@ Managing --- -### 自分の鍵を持参してください +### 自分のキーを持ち込む Zen の他のモデルにアクセスしながら、独自の OpenAI または Anthropic API キーを使用できます。 @@ -244,7 +239,7 @@ Zen が提供するものの代わりにそれを使用したいとします。 私たちは次の目的で OpenCode Zen を作成しました。 -1. **ベンチマーク** コーディング エージェントに最適なモデル/プロバイダー。 +1. **ベンチマーク** コーディングエージェントに最適なモデル/プロバイダー。 2. **最高品質**のオプションにアクセスでき、パフォーマンスをダウングレードしたり、より安価なプロバイダーにルートしたりする必要はありません。 3. 原価で販売することで**価格下落**を転嫁します。したがって、唯一のマークアップは処理手数料をカバーすることです。 -4. 他のコーディング エージェントとの併用を許可することで、**ロックイン**がなくなります。また、常に OpenCode で他のプロバイダーも使用できるようにします。 +4. 他のコーディングエージェントとの併用を許可することで、**ロックイン**がなくなります。また、常に OpenCode で他のプロバイダーも使用できるようにします。 diff --git a/packages/web/src/content/docs/ko/acp.mdx b/packages/web/src/content/docs/ko/acp.mdx index 76134ed05..2fbd58013 100644 --- a/packages/web/src/content/docs/ko/acp.mdx +++ b/packages/web/src/content/docs/ko/acp.mdx @@ -1,6 +1,6 @@ --- -title: ACP Support -description: Use opencode in any ACP-compatible editor. +title: ACP 지원 +description: ACP 호환 편집기에서 opencode를 사용하세요. --- opencode는 [Agent Client Protocol](https://agentclientprotocol.com) 또는 (ACP)을 지원하며, 호환 편집기 및 IDE에서 직접 사용할 수 있습니다. @@ -23,7 +23,7 @@ ACP를 통해 opencode를 사용하려면 `opencode acp` 명령을 실행하려 --- -##### Zed를 +##### Zed [Zed](https://zed.dev) 구성 (`~/.config/zed/settings.json`)에 추가 : @@ -67,7 +67,7 @@ ACP를 통해 opencode를 사용하려면 `opencode acp` 명령을 실행하려 --- -#### JetBrains IDEs의 특징 +#### JetBrains IDEs [JetBrains IDE]에 추가하십시오 (https://www.jetbrains.com/) [documentation]에 따라 acp.json (https://www.jetbrains.com/help/ai-assistant/acp.html): @@ -86,7 +86,7 @@ ACP를 통해 opencode를 사용하려면 `opencode acp` 명령을 실행하려 --- -#### Avante.nvim의 +#### Avante.nvim [Avante.nvim](https://github.com/yetone/avante.nvim) 구성에 추가하십시오: @@ -140,9 +140,9 @@ require("codecompanion").setup({ 환경 변수 (`OPENCODE_API_KEY`와 같은)를 전달해야하는 경우, CodeCompanion.nvim 문서에서 [Configuring Adapters: Environment variables](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key)를 참조하십시오. -## 지원 +## 지원 기능 -opencode는 terminal에서 같은 ACP를 통해 작동합니다. 모든 기능은 지원됩니다: +opencode는 터미널과 동일하게 ACP를 통해 작동합니다. 모든 기능은 지원됩니다: :::note `/undo` 및 `/redo`와 같은 일부 내장 슬래시 명령은 현재 지원되지 않습니다. diff --git a/packages/web/src/content/docs/ko/agents.mdx b/packages/web/src/content/docs/ko/agents.mdx index 56c7ec27c..5b3712243 100644 --- a/packages/web/src/content/docs/ko/agents.mdx +++ b/packages/web/src/content/docs/ko/agents.mdx @@ -1,136 +1,135 @@ --- -title: Agents -description: Configure and use specialized agents. +title: 에이전트 +description: 전문 에이전트를 구성하고 사용하세요. --- -에이전트는 특정 작업과 워크플로우를 구성할 수 있는 AI 보조를 전문으로 합니다. 사용자 정의 프롬프트, 모델 및 도구 액세스와 초점을 맞춘 도구를 만들 수 있습니다. +에이전트는 특정 작업과 워크플로우를 전문으로 하는 구성 가능한 AI 보조자입니다. 사용자 정의 프롬프트, 모델, 도구 액세스로 집중된 도구를 만들 수 있습니다. :::tip -코드를 분석하고 코드 변경없이 제안을 검토 할 계획 에이전트를 사용합니다. +코드 변경 없이 제안을 검토할 때는 Plan 에이전트를 사용하세요. ::: -세션 중에 에이전트를 전환하거나 `@` 언급으로 호출 할 수 있습니다. +세션 중에 에이전트를 전환하거나 `@` 멘션으로 호출할 수 있습니다. --- ## 유형 -OpenCode의 두 가지 유형이 있습니다; 기본 에이전트와 subagents. +OpenCode에는 두 가지 유형의 에이전트가 있습니다: 기본 에이전트(Primary Agent)와 서브 에이전트(Subagent). --- -### 주요 에이전트 +### 기본 에이전트 -주요 에이전트은 당신이 직접 상호 작용하는 주요 조수입니다. **Tab** 키 또는 설정된 `switch_agent` keybind를 사용하여 주기 할 수 있습니다. 이 에이전트은 당신의 주요 대화를 취급합니다. 도구 액세스는 권한을 통해 구성된다 — 예를 들어, Build는 Plan이 제한되는 동안 모든 도구를 사용할 수 있습니다. +기본 에이전트는 사용자가 직접 상호 작용하는 주요 보조자입니다. **Tab** 키 또는 설정된 `switch_agent` 키바인드를 사용하여 순환할 수 있습니다. 이 에이전트는 주요 대화를 처리합니다. 도구 액세스는 권한을 통해 구성됩니다 — 예를 들어, Build는 모든 도구를 사용할 수 있지만 Plan은 제한됩니다. :::tip -세션 중에 기본 에이전트를 전환하는 **Tab** 키를 사용할 수 있습니다. +세션 중에 **Tab** 키를 사용하여 기본 에이전트를 전환할 수 있습니다. ::: -OpenCode는 두 개의 내장 기본 에이전트, **Build** 및 **Plan**와 함께 제공됩니다. 우리는 -아래에서 보기. +OpenCode는 두 가지 내장 기본 에이전트, **Build** 및 **Plan**을 제공합니다. 아래에서 자세히 살펴봅니다. --- -### Subagents +### 서브 에이전트 -Subagents는 기본 에이전트가 특정 작업을 위해 호출 할 수있는 전문 보조입니다. 또한 수동으로 그들을 호출 할 수 있습니다 ** @ 언급 ** 메시지에서 그들. +서브 에이전트는 기본 에이전트가 특정 작업을 위해 호출할 수 있는 전문 보조자입니다. 또한 메시지에서 **@멘션**을 통해 수동으로 호출할 수도 있습니다. -OpenCode는 두 개의 내장 subagents, **General** 및 **Explore**. 아래에서 볼 수 있습니다. +OpenCode는 두 가지 내장 서브 에이전트, **General** 및 **Explore**를 제공합니다. 아래에서 자세히 살펴봅니다. --- -## 내장 +## 기본 제공 -OpenCode는 기본 에이전트와 두 개의 내장 subagents로 제공됩니다. +OpenCode는 기본 에이전트와 두 개의 내장 서브 에이전트를 제공합니다. --- -### 사용 Build +### Build _모드_: `primary` -Build는 **default** 모든 도구가 활성화된 기본 에이전트입니다. 이것은 당신이 파일 가동 및 체계 명령에 가득 차있는 접근을 필요로 하는 발달 일을 위한 표준 에이전트입니다. +Build는 모든 도구가 활성화된 **기본** 에이전트입니다. 파일 조작 및 시스템 명령에 대한 전체 액세스가 필요한 개발 작업을 위한 표준 에이전트입니다. --- -### 사용 Plan +### Plan _모드_: `primary` -계획 및 분석을 위해 설계된 제한된 에이전트. 우리는 더 많은 통제를 주고 무인화한 변화를 방지하기 위하여 허가 체계를 이용합니다. -기본적으로, 뒤에 오는 전부는 `ask`로 놓입니다: +계획 및 분석을 위해 설계된 제한된 에이전트입니다. 더 많은 제어권을 부여하고 의도하지 않은 변경을 방지하기 위해 권한 시스템을 사용합니다. +기본적으로 다음은 모두 `ask`로 설정됩니다: - `file edits`: 모든 쓰기, 패치 및 편집 - `bash`: 모든 bash 명령 -이 에이전트는 코드를 분석 할 LLM을 원할 때 유용합니다, 변경을 제안하거나 코드베이스에 실제 수정없이 계획을 만들 수 있습니다. +이 에이전트는 코드를 분석하거나 변경을 제안받고 싶지만, 코드베이스에 실제 수정 없이 계획만 만들고 싶을 때 유용합니다. --- -### 사용 General +### General _모드_: `subagent` -복잡한 질문을 연구하고 다중 단계 작업을 실행하기위한 범용 에이전트. 전체 도구 액세스 (todo 제외), 그래서 필요할 때 파일 변경을 만들 수 있습니다. 평행한에 있는 일의 다수 단위를 달리기 위하여 이것을 사용하십시오. +복잡한 질문을 연구하고 다단계 작업을 실행하기 위한 범용 에이전트입니다. 전체 도구 액세스(todo 제외)를 가지므로 필요할 때 파일 변경을 수행할 수 있습니다. 여러 단위의 작업을 병렬로 실행할 때 사용하세요. --- -### 사용 Explore +### Explore _모드_: `subagent` -Codebases를 탐구하는 빠르고, 읽기 전용 에이전트. 파일을 수정할 수 없습니다. 이 작업을 사용하면 패턴, 키워드 검색 코드, 또는 codebase에 대한 질문에 신속하게 파일을 찾을 수 있습니다. +코드베이스를 탐색하는 빠르고 읽기 전용인 에이전트입니다. 파일을 수정할 수 없습니다. 패턴, 키워드로 코드를 검색하거나 코드베이스에 대한 질문에 답하기 위해 파일을 빠르게 찾아야 할 때 사용하세요. --- -### 사용 Compaction +### Compaction _모드_: `primary` -더 작은 요약으로 긴 맥락을 압축하는 숨겨진 시스템 에이전트. 필요한 경우 자동으로 실행되며 UI에서 선택할 수 없습니다. +긴 컨텍스트를 작은 요약으로 압축하는 숨겨진 시스템 에이전트입니다. 필요한 경우 자동으로 실행되며 UI에서 선택할 수 없습니다. --- -### 사용 Title +### Title _모드_: `primary` -짧은 세션 타이틀을 생성하는 숨겨진 시스템 에이전트. 그것은 자동으로 실행하고 UI에서 선택할 수 없습니다. +짧은 세션 제목을 생성하는 숨겨진 시스템 에이전트입니다. 자동으로 실행되며 UI에서 선택할 수 없습니다. --- -### 사용 Summary +### Summary _모드_: `primary` -세션 summaries를 만드는 숨겨진 시스템 에이전트. 그것은 자동으로 실행하고 UI에서 선택할 수 없습니다. +세션 요약을 만드는 숨겨진 시스템 에이전트입니다. 자동으로 실행되며 UI에서 선택할 수 없습니다. --- ## 사용법 -1. 주요 에이전트을 위해, **Tab ** 열쇠를 사용하여 세션 도중 주기. 구성 된 `switch_agent` keybind도 사용할 수 있습니다. +1. 기본 에이전트의 경우, 세션 중에 **Tab** 키를 사용하여 순환합니다. 구성된 `switch_agent` 키바인드도 사용할 수 있습니다. -2. Subagents은 invoked 일 수 있습니다: - - **Automatically** 그들의 설명에 근거를 둔 특화된 업무를 위한 주요 에이전트에 의하여. - - 메시지에 대한 subagents\*\*. 예를 들어. +2. 서브 에이전트는 다음과 같이 호출할 수 있습니다: + - 설명에 근거하여 전문적인 작업을 위해 기본 에이전트에 의해 **자동으로** 호출됨. + - 메시지에서 서브 에이전트를 **@멘션**. 예를 들어: ```txt frame="none" @general help me search for this function ``` -3. ** 세션 간의 편차 **: subagents는 자신의 자녀 세션을 만들 때, 부모 세션과 모든 어린이 세션을 사용하여 탐색 할 수 있습니다. - - **\+Right** (또는 부모 → Child1 → Child2 →를 통해 전달하기 위해 설정된 `session_child_cycle` keybind) - - **\+Left** (또는 `session_child_cycle_reverse` keybind) 부모를 통해 돌아 가기 위해 ← child1 ← child2 ← ... ← 부모 +3. **세션 간 이동**: 서브 에이전트가 자체 자식 세션을 만들 때, 부모 세션과 자식 세션 간을 탐색할 수 있습니다. + - **\+Right** (또는 부모 → 자식1 → 자식2 순으로 이동하기 위해 설정된 `session_child_cycle` 키바인드) + - **\+Left** (또는 `session_child_cycle_reverse` 키바인드) 부모 방향으로 되돌아가기: 자식2 → 자식1 → 부모 - 이로 인해 주요 대화와 특이한 subagent 작업을 원활하게 전환할 수 있습니다. + 이를 통해 주요 대화와 전문적인 서브 에이전트 작업 간을 원활하게 전환할 수 있습니다. --- ## 구성 -내장 에이전트를 사용자 정의하거나 구성을 통해 자신의 만들 수 있습니다. 에이전트는 두 가지 방법으로 구성 될 수 있습니다: +내장 에이전트를 사용자 정의하거나 구성을 통해 자신만의 에이전트를 만들 수 있습니다. 에이전트는 두 가지 방법으로 구성될 수 있습니다: --- @@ -212,13 +211,13 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m ## 옵션 -이 구성 옵션을 자세히 살펴봅시다. +이 구성 옵션들을 자세히 살펴봅시다. --- -### 묘사 +### 설명 -`description` 옵션을 사용하여 에이전트가 작동하고 사용할 때의 간단한 설명을 제공합니다. +`description` 옵션을 사용하여 에이전트가 무엇을 하고 언제 사용해야 하는지에 대한 간단한 설명을 제공합니다. ```json title="opencode.json" { @@ -230,15 +229,15 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m } ``` -\*\* config 옵션이 필요합니다. +\*\* 필수 구성 옵션입니다. --- ### 온도 -`temperature` config와 LLM의 응답의 임의성과 창의성을 제어합니다. +`temperature` 구성으로 LLM 응답의 무작위성과 창의성을 제어합니다. -더 낮은 값은 더 집중하고 세심한 응답을 만듭니다. 더 높은 값은 창의력과 가변성을 증가하면서. +값이 낮을수록 더 집중되고 결정적인 응답을 생성하며, 값이 높을수록 창의성과 가변성이 증가합니다. ```json title="opencode.json" { @@ -253,10 +252,11 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m } ``` -온도 값은 일반적으로 0.0에서 1.0에 배열합니다: +온도 값은 일반적으로 0.0에서 1.0 사이입니다: -- **0.0-0.2**: 매우 집중하고 신중한 응답, 코드 분석 및 계획에 이상 -**0.3-0.5**: 일부 창의력과 균형 잡힌 응답, 일반 개발 작업에 좋은 -- **0.6-1.0**: 더 창조적이고 다양한 응답, 뇌하수 및 탐험에 유용한 +- **0.0-0.2**: 매우 집중되고 신중한 응답, 코드 분석 및 계획에 이상적 +- **0.3-0.5**: 창의성과 정확성의 균형, 일반 개발 작업에 좋음 +- **0.6-1.0**: 더 창의적이고 다양한 응답, 브레인스토밍 및 탐색에 유용함 ```json title="opencode.json" { @@ -276,15 +276,15 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m } ``` -온도가 지정되지 않은 경우, opencode는 모델 별 기본을 사용합니다. 일반적으로 대부분의 모델의 경우 0, Qwen 모델의 경우 0.55. +온도가 지정되지 않은 경우, OpenCode는 모델별 기본값을 사용합니다. 일반적으로 대부분의 모델은 0, Qwen 모델의 경우 0.55입니다. --- ## 최대 단계 -에이전트의 최대 수를 통제하는 에이전트은 원본과 반응하기 전에 실행할 수 있습니다. 이 사용자는 에이전트 행동에 제한을 설정하는 비용을 제어 할 수 있습니다. +에이전트가 중지하고 사용자와 다시 상호 작용하기 전에 실행할 수 있는 최대 단계 수를 제어합니다. 이를 통해 에이전트의 행동과 비용을 제어할 수 있습니다. -이 설정되지 않은 경우, 에이전트는 모델이 중지하거나 사용자가 세션을 중단하도록 선택할 때까지 계속됩니다. +설정되지 않은 경우, 에이전트는 모델이 중지하거나 사용자가 세션을 중단할 때까지 계속됩니다. ```json title="opencode.json" { @@ -298,17 +298,17 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m } ``` -제한이 도달되면, 에이전트는 특별한 시스템을 신속하게 작업의 요약과 권장되는 나머지 작업에 응답하도록 지시합니다. +제한에 도달하면, 에이전트는 작업 요약과 권장되는 남은 작업을 신속하게 응답하도록 지시받습니다. :::caution -레거시 `maxSteps` 필드는 deprecated. 대신 `steps`를 사용하십시오. +레거시 `maxSteps` 필드는 더 이상 사용되지 않습니다. 대신 `steps`를 사용하십시오. ::: --- #### 비활성화 -`true`로 에이전트를 비활성화합니다. +`true`로 설정하여 에이전트를 비활성화합니다. ```json title="opencode.json" { @@ -324,7 +324,7 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m #### 프롬프트 -`prompt` config를 가진 이 에이전트을 위한 주문 체계 prompt 파일을 지정하십시오. prompt 파일은 에이전트의 목적에 따라 지시를 포함해야합니다. +`prompt` 구성으로 이 에이전트를 위한 사용자 정의 시스템 프롬프트 파일을 지정하십시오. 프롬프트 파일은 에이전트의 목적에 따른 지시를 포함해야 합니다. ```json title="opencode.json" { @@ -336,16 +336,16 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m } ``` -이 경로는 config 파일이 있는 곳에 관계됩니다. 그래서 이것은 글로벌 opencode 구성과 프로젝트 특정 구성 모두를 위해 작동합니다. +이 경로는 구성 파일이 있는 위치를 기준으로 합니다. 따라서 글로벌 OpenCode 구성과 프로젝트별 구성 모두에서 작동합니다. --- -### 모형 +### 모델 -`model` config를 사용하여이 에이전트에 대한 모델을 삭제합니다. 다른 작업에 최적화 된 다른 모델을 사용하는 데 유용합니다. 예를 들어, 계획을위한 빠른 모델, 구현을위한 더 많은 모델. +`model` 구성을 사용하여 이 에이전트에 대한 모델을 재정의합니다. 다른 작업에 최적화된 다른 모델을 사용하는 데 유용합니다. 예를 들어, 계획을 위한 빠른 모델, 구현을 위한 더 강력한 모델 등입니다. :::tip -모델을 지정하지 않는 경우, 기본 에이전트는 [model globallyconfig](/docs/config#models)를 사용하며, subagents는 subagent를 호출하는 1차 에이전트의 모델을 사용합니다. +모델을 지정하지 않는 경우, 기본 에이전트는 [전역 구성 모델](/docs/config#models)을 사용하며, 서브 에이전트는 자신을 호출한 기본 에이전트의 모델을 사용합니다. ::: ```json title="opencode.json" @@ -358,13 +358,13 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m } ``` -opencode config의 모델 ID는 `provider/model-id` 형식을 사용합니다. 예를 들어, [OpenCode Zen](/docs/zen)을 사용한다면, GPT 5.1 Codex에 `opencode/gpt-5.1-codex`를 사용할 수 있습니다. +OpenCode 구성의 모델 ID는 `provider/model-id` 형식을 사용합니다. 예를 들어, [OpenCode Zen](/docs/zen)을 사용한다면, GPT 5.1 Codex에 `opencode/gpt-5.1-codex`를 사용할 수 있습니다. --- ## 도구 -`tools` config로 이 에이전트에서 사용할 수있는 제어. `true` 또는 `false`로 설정하여 특정 도구를 활성화하거나 비활성화 할 수 있습니다. +`tools` 구성으로 이 에이전트가 사용할 수 있는 도구를 제어합니다. `true` 또는 `false`로 설정하여 특정 도구를 활성화하거나 비활성화할 수 있습니다. ```json title="opencode.json" {3-6,9-12} { @@ -385,10 +385,10 @@ opencode config의 모델 ID는 `provider/model-id` 형식을 사용합니다. ``` :::note -에이전트 별 구성 overrides 글로벌 구성. +에이전트별 구성은 글로벌 구성을 덮어씁니다. ::: -한 번에 여러 도구를 제어 할 와일드 카드를 사용할 수 있습니다. 예를 들어, MCP 서버에서 모든 도구를 비활성화하려면: +한 번에 여러 도구를 제어하기 위해 와일드카드를 사용할 수 있습니다. 예를 들어, MCP 서버에서 모든 도구를 비활성화하려면: ```json title="opencode.json" { @@ -405,16 +405,16 @@ opencode config의 모델 ID는 `provider/model-id` 형식을 사용합니다. } ``` -[공구에 대해 더 알아보기](/docs/tools). +[도구에 대해 더 알아보기](/docs/tools). --- -## # 권한 +## 권한 -에이전트가 수행 할 수있는 작업을 관리 할 수있는 권한을 구성 할 수 있습니다. 현재 `edit`, `bash` 및 `webfetch` 도구에 대한 권한은 다음과 같습니다. +에이전트가 수행할 수 있는 작업을 관리할 수 있는 권한을 구성할 수 있습니다. 현재 `edit`, `bash` 및 `webfetch` 도구에 대한 권한은 다음과 같습니다. -- `"ask"` - 도구 실행하기 전에 승인을위한 Prompt -- `"allow"` - 승인없이 모든 작업을 허용 +- `"ask"` - 도구를 실행하기 전에 승인 요청 +- `"allow"` - 승인 없이 모든 작업 허용 - `"deny"` - 도구 비활성화 ```json title="opencode.json" @@ -426,7 +426,7 @@ opencode config의 모델 ID는 `provider/model-id` 형식을 사용합니다. } ``` -당신은 에이전트 당이 허가를 override 할 수 있습니다. +에이전트별로 이 권한을 재정의(override)할 수 있습니다. ```json title="opencode.json" {3-5,8-10} { @@ -444,7 +444,7 @@ opencode config의 모델 ID는 `provider/model-id` 형식을 사용합니다. } ``` -Markdown 에이전트에서 권한을 설정할 수 있습니다. +Markdown 에이전트에서도 권한을 설정할 수 있습니다. ```markdown title="~/.config/opencode/agents/review.md" --- @@ -481,7 +481,7 @@ Only analyze code and suggest changes. } ``` -이것은 glob 본을 가지고 갈 수 있습니다. +이것은 glob 패턴을 사용할 수 있습니다. ```json title="opencode.json" {7} { @@ -498,8 +498,8 @@ Only analyze code and suggest changes. } ``` -또한 `*` 와일드 카드를 사용하여 모든 명령에 대한 권한을 관리 할 수 있습니다. -마지막 일치 규칙이 우선적으로 걸리기 때문에, `*` 와일드카드를 첫번째로 두고 특정 규칙을 후에 두십시오. +또한 `*` 와일드카드를 사용하여 모든 명령에 대한 권한을 관리할 수 있습니다. +마지막 일치 규칙이 우선하므로, `*` 와일드카드를 먼저 두고 특정 규칙을 나중에 두십시오. ```json title="opencode.json" {8} { @@ -517,13 +517,13 @@ Only analyze code and suggest changes. } ``` -[허가에 대해 더 알아보기](/docs/permissions). +[권한에 대해 더 알아보기](/docs/permissions). --- -### 형태 +### 모드 -`mode` config로 에이전트 모드를 제어합니다. `mode` 선택권은 에이전트이 사용될 수 있는 방법을 결정하기 위하여 이용됩니다. +`mode` 구성으로 에이전트 모드를 제어합니다. `mode` 옵션은 에이전트가 어떻게 사용될 수 있는지 결정하는 데 사용됩니다. ```json title="opencode.json" { @@ -535,13 +535,13 @@ Only analyze code and suggest changes. } ``` -`mode` 선택권은 `primary`, `subagent`, 또는 `all`에 놓일 수 있습니다. `mode`가 지정되지 않은 경우 `all`로 기본값입니다. +`mode` 옵션은 `primary`, `subagent`, 또는 `all`로 설정할 수 있습니다. `mode`가 지정되지 않은 경우 `all`이 기본값입니다. --- -## #숨겨진 +## 숨김 -`@`를 사용해 `hidden: true` 자동 완성 메뉴에서 시약을 숨깁니다. 작업 도구를 통해 다른 에이전트에 의해 invoked programmatically 있어야하는 내부 시약에 유용합니다. +`hidden: true`를 사용하여 `@` 자동 완성 메뉴에서 에이전트를 숨깁니다. 작업 도구를 통해 다른 에이전트에 의해 프로그래밍 방식으로 호출되어야 하는 내부 에이전트에 유용합니다. ```json title="opencode.json" { @@ -554,17 +554,17 @@ Only analyze code and suggest changes. } ``` -자동 완성 메뉴의 사용자 가시에만 영향을 미칩니다. 숨겨진 에이전트는 여전히 작업 도구를 통해 모델에 의해 호출 될 수 있습니다 권한 허용. +자동 완성 메뉴의 사용자 가시성에만 영향을 미칩니다. 숨겨진 에이전트는 권한이 허용된다면 여전히 작업 도구를 통해 모델에 의해 호출될 수 있습니다. :::note -`mode: subagent` 에이전트에서만 적용합니다. +`mode: subagent` 에이전트에만 적용됩니다. ::: --- ## 작업 권한 -에이전트가 `permission.task`와 작업 도구를 통해 호출 할 수있는 제어. 유연한 일치를 위한 glob 본을 사용합니다. +`permission.task`와 작업 도구를 통해 에이전트가 호출할 수 있는 서브 에이전트를 제어합니다. 유연한 일치를 위한 glob 패턴을 사용합니다. ```json title="opencode.json" { @@ -583,23 +583,23 @@ Only analyze code and suggest changes. } ``` -`deny`로 설정할 때, Subagent는 작업 도구 설명에서 완전히 제거됩니다. 그래서 모델은 그것을 호출하려고하지 않습니다. +`deny`로 설정할 때, 서브 에이전트는 작업 도구 설명에서 완전히 제거됩니다. 따라서 모델은 그것을 호출하려고 시도하지 않습니다. :::tip -규칙은 순서로 평가되고, **마지막 일치 규칙은**를 이깁니다. 위의 예에서 `orchestrator-planner`는 `*` (deny)와 `orchestrator-*` (allow) 모두 일치하지만 `orchestrator-*`가 `*` 후 제공되므로 결과는 `allow`입니다. +규칙은 순서대로 평가되며, **마지막 일치 규칙**이 우선합니다. 위의 예에서 `orchestrator-planner`는 `*` (deny)와 `orchestrator-*` (allow) 모두 일치하지만 `orchestrator-*`가 `*` 뒤에 오므로 결과는 `allow`입니다. ::: :::tip -사용자는 `@` 자동 완성 메뉴를 통해 직접 어떤 subagent를 호출 할 수 있습니다. 에이전트의 작업 허가가 거부 할 경우에도. +사용자는 에이전트의 작업 권한이 거부되더라도 `@` 자동 완성 메뉴를 통해 직접 어떤 서브 에이전트든 호출할 수 있습니다. ::: --- -### 색깔 +### 색상 -`color` 옵션과 UI에서 에이전트의 시각적 외관을 사용자 정의합니다. 이것은 어떻게 에이전트가 인터페이스에 나타납니다. +`color` 옵션으로 UI에서 에이전트의 시각적 모양을 사용자 정의합니다. -유효한 hex 색깔을 사용하십시오 (예를들면, `#FF5733`) 또는 주제 색깔: `primary`, `secondary`, `accent`, `success`, `warning`, `error`, `info`. +유효한 hex 색상(예: `#FF5733`) 또는 테마 색상을 사용하십시오: `primary`, `secondary`, `accent`, `success`, `warning`, `error`, `info`. ```json title="opencode.json" { @@ -616,9 +616,9 @@ Only analyze code and suggest changes. --- -### 정상 P +### Top P -`top_p` 선택권을 가진 응답 다양성을 통제하십시오. 무작위 통제를 위한 온도에 대안. +`top_p` 옵션으로 응답의 다양성을 제어합니다. 무작위성 제어를 위한 온도의 대안입니다. ```json title="opencode.json" { @@ -630,15 +630,15 @@ Only analyze code and suggest changes. } ``` -가치는 0.0에서 1.0에 배열합니다. 더 낮은 가치는 더 집중되고, 더 높은 가치는 더 다양합니다. +값은 0.0에서 1.0 사이입니다. 낮은 값은 더 집중되고, 높은 값은 더 다양합니다. --- -### 추가 +### 추가 옵션 -에이전트 구성에 지정하는 다른 옵션은 ** 직접 통과 ** 모델 옵션으로 공급자. 이 공급자 별 기능 및 매개 변수를 사용할 수 있습니다. +에이전트 구성에 지정하는 다른 옵션은 모델 옵션으로 공급자에게 **직접 전달**됩니다. 이를 통해 공급자별 기능 및 매개변수를 사용할 수 있습니다. -예를 들어, OpenAI의 이유 모델과 함께, 당신은 이유를 제어 할 수 있습니다 노력: +예를 들어, OpenAI의 추론 모델과 함께, 추론 노력을 제어할 수 있습니다: ```json title="opencode.json" {6,7} { @@ -653,7 +653,7 @@ Only analyze code and suggest changes. } ``` -이 추가 옵션은 모델과 공급자 별입니다. 공급자의 문서 확인 가능 매개 변수. +이 추가 옵션은 모델과 공급자별로 다릅니다. 사용 가능한 매개변수는 공급자의 문서를 확인하십시오. :::tip `opencode models`를 실행하여 사용 가능한 모델 목록을 볼 수 있습니다. @@ -669,25 +669,25 @@ Only analyze code and suggest changes. opencode agent create ``` -이 대화 형 명령은: +이 대화형 명령은: -1. 에이전트을 저장하는 곳에게; 세계적인 프로젝트 별. -2. 에이전트이 해야 하는 무슨의 묘사. -3. 적절한 시스템 프롬프트 및 식별자를 생성한다. -4. 당신은 에이전트이 접근할 수 있는 어떤 공구를 선정하자. -5. 마지막으로, 에이전트 구성을 가진 markdown 파일을 창조하십시오. +1. 에이전트를 저장할 위치를 묻습니다 (전역 또는 프로젝트별). +2. 에이전트가 해야 할 일에 대한 설명을 묻습니다. +3. 적절한 시스템 프롬프트 및 식별자를 생성합니다. +4. 에이전트가 접근할 수 있는 도구를 선택하게 합니다. +5. 마지막으로, 에이전트 구성을 가진 markdown 파일을 생성합니다. --- ## 사용 사례 -다른 에이전트을 위한 몇몇 일반적인 사용 사례는 여기 있습니다. +다른 에이전트를 위한 몇 가지 일반적인 사용 사례는 다음과 같습니다. -- **빌딩 에이전트**: 모든 도구와 함께 전체 개발 작업 -- ** 플랜 에이전트**: 변화없이 분석 및 계획 -- **리뷰 에이전트**: Code review with read-only access plus 문서 도구 -- ** 디버그 에이전트**: bash 및 읽기 도구와 함께 조사에 집중 -- **Docs 에이전트 **: 파일 작업과 문서 작성하지만 시스템 명령 없음 +- **Build Agent**: 모든 도구와 함께 전체 개발 작업 +- **Plan Agent**: 변경 없이 분석 및 계획 +- **Review Agent**: 읽기 전용 액세스 및 문서 도구와 함께 코드 리뷰 +- **Debug Agent**: bash 및 읽기 도구와 함께 조사에 집중 +- **Docs Agent**: 파일 작업과 문서 작성을 하지만 시스템 명령 없음 --- @@ -696,7 +696,7 @@ opencode agent create 여기에 유용 할 수있는 몇 가지 예 에이전트가 있습니다. :::tip -당신은 공유하고 싶은 에이전트이 있습니까? [PR](https://github.com/anomalyco/opencode). +공유하고 싶은 에이전트가 있습니까? [PR](https://github.com/anomalyco/opencode). ::: --- diff --git a/packages/web/src/content/docs/ko/cli.mdx b/packages/web/src/content/docs/ko/cli.mdx index 007569366..a78ac96f3 100644 --- a/packages/web/src/content/docs/ko/cli.mdx +++ b/packages/web/src/content/docs/ko/cli.mdx @@ -27,7 +27,7 @@ OpenCode 터미널 사용자 인터페이스를 시작합니다. opencode [project] ``` -#### Flags +#### 플래그 | 플래그 | 축약 | 설명 | | ------------ | ---- | ---------------------------------------------------------------------- | @@ -42,7 +42,7 @@ opencode [project] --- -## Commands +## 명령어 opencode CLI는 아래 명령들도 제공합니다. @@ -76,7 +76,7 @@ opencode web --port 4096 --hostname 0.0.0.0 opencode attach http://10.20.30.40:4096 ``` -#### Flags +#### 플래그 | 플래그 | 축약 | 설명 | | ----------- | ---- | -------------------------- | @@ -185,7 +185,7 @@ GitHub 에이전트를 실행합니다. 보통 GitHub Actions에서 사용합니 opencode github run ``` -##### Flags +##### 플래그 | 플래그 | 설명 | | --------- | ------------------------- | @@ -294,7 +294,7 @@ opencode models [provider] opencode models anthropic ``` -#### Flags +#### 플래그 | 플래그 | 설명 | | ----------- | ------------------------------------------------- | @@ -333,7 +333,7 @@ opencode serve opencode run --attach http://localhost:4096 "Explain async/await in JavaScript" ``` -#### Flags +#### 플래그 | 플래그 | 축약 | 설명 | | ------------ | ---- | ---------------------------------------------------------------------- | @@ -362,7 +362,7 @@ opencode serve 이 명령은 TUI 없이 opencode 기능에 접근할 수 있는 HTTP 서버를 시작합니다. `OPENCODE_SERVER_PASSWORD`를 설정하면 HTTP basic auth가 활성화됩니다(기본 사용자명: `opencode`). -#### Flags +#### 플래그 | 플래그 | 설명 | | ------------ | --------------------------------- | @@ -391,7 +391,7 @@ OpenCode 세션 목록을 표시합니다. opencode session list ``` -##### Flags +##### 플래그 | 플래그 | 축약 | 설명 | | ------------- | ---- | -------------------------------------- | @@ -408,7 +408,7 @@ OpenCode 세션의 토큰 사용량과 비용 통계를 표시합니다. opencode stats ``` -#### Flags +#### 플래그 | 플래그 | 설명 | | ----------- | ------------------------------------------------------------ | @@ -458,7 +458,7 @@ opencode web 이 명령은 HTTP 서버를 시작하고 웹 브라우저를 열어 웹 인터페이스로 OpenCode에 접속합니다. `OPENCODE_SERVER_PASSWORD`를 설정하면 HTTP basic auth가 활성화됩니다(기본 사용자명: `opencode`). -#### Flags +#### 플래그 | 플래그 | 설명 | | ------------ | --------------------------------- | @@ -479,7 +479,7 @@ opencode acp 이 명령은 nd-JSON 형식으로 stdin/stdout을 통해 통신하는 ACP 서버를 시작합니다. -#### Flags +#### 플래그 | 플래그 | 설명 | | ------------ | ------------- | @@ -497,7 +497,7 @@ OpenCode를 제거하고 관련 파일을 삭제합니다. opencode uninstall ``` -#### Flags +#### 플래그 | 플래그 | 축약 | 설명 | | --------------- | ---- | ------------------------------- | @@ -528,7 +528,7 @@ opencode upgrade opencode upgrade v0.1.48 ``` -#### Flags +#### 플래그 | 플래그 | 축약 | 설명 | | ---------- | ---- | ------------------------------------------ | @@ -536,7 +536,7 @@ opencode upgrade v0.1.48 --- -## Global Flags +## 전역 플래그 opencode CLI는 아래 전역 플래그를 지원합니다. @@ -549,7 +549,7 @@ opencode CLI는 아래 전역 플래그를 지원합니다. --- -## Environment variables +## 환경 변수 OpenCode는 환경 변수로도 구성할 수 있습니다. @@ -582,7 +582,7 @@ OpenCode는 환경 변수로도 구성할 수 있습니다. --- -### Experimental +### 실험적 기능 아래 환경 변수는 변경되거나 제거될 수 있는 실험 기능을 활성화합니다. diff --git a/packages/web/src/content/docs/ko/commands.mdx b/packages/web/src/content/docs/ko/commands.mdx index 38ff73896..c477cb12f 100644 --- a/packages/web/src/content/docs/ko/commands.mdx +++ b/packages/web/src/content/docs/ko/commands.mdx @@ -1,6 +1,6 @@ --- -title: Commands -description: Create custom commands for repetitive tasks. +title: 명령어 +description: 반복적인 작업을 위한 커스텀 명령을 만드세요. --- 커스텀 명령을 사용하면 TUI에서 해당 명령이 실행될 때 사용할 프롬프트를 미리 정의할 수 있습니다. @@ -109,7 +109,7 @@ Markdown 파일명이 명령 이름이 됩니다. 예를 들어 `test.md`라면 --- -### 인수(Arguments) +### 인수 `$ARGUMENTS` 플레이스홀더로 명령 인수를 전달할 수 있습니다. @@ -219,7 +219,7 @@ Check for performance issues and suggest improvements. --- -### Template +### 템플릿 `template` 옵션은 명령 실행 시 LLM에 전달할 프롬프트를 정의합니다. @@ -237,7 +237,7 @@ Check for performance issues and suggest improvements. --- -### Description +### 설명 `description` 옵션으로 명령의 짧은 설명을 추가할 수 있습니다. @@ -255,7 +255,7 @@ Check for performance issues and suggest improvements. --- -### Agent +### 에이전트 `agent` 설정으로 이 명령을 실행할 [agent](/docs/agents)를 지정할 수 있습니다. 지정한 값이 [subagent](/docs/agents/#subagents)면 기본적으로 subagent 호출이 실행됩니다. @@ -275,7 +275,7 @@ Check for performance issues and suggest improvements. --- -### Subtask +### 서브태스크 `subtask` 불리언(boolean)을 사용하면 명령이 [subagent](/docs/agents/#subagents) 호출을 강제로 트리거합니다. 주 컨텍스트를 오염시키고 싶지 않을 때 유용하며, [agent](/docs/agents) 설정의 `mode`가 `primary`여도 subagent로 실행합니다. @@ -294,7 +294,7 @@ Check for performance issues and suggest improvements. --- -### Model +### 모델 `model` 설정으로 이 명령의 기본 모델을 오버라이드할 수 있습니다. @@ -312,7 +312,7 @@ Check for performance issues and suggest improvements. --- -## Built-in +## 내장 명령 OpenCode는 `/init`, `/undo`, `/redo`, `/share`, `/help` 등 여러 내장 명령을 제공합니다. [더 알아보기](/docs/tui#commands). diff --git a/packages/web/src/content/docs/ko/config.mdx b/packages/web/src/content/docs/ko/config.mdx index f8ae05ba1..0357ded78 100644 --- a/packages/web/src/content/docs/ko/config.mdx +++ b/packages/web/src/content/docs/ko/config.mdx @@ -1,15 +1,15 @@ --- -title: Config -description: Using the opencode JSON config. +title: 구성 +description: OpenCode JSON 구성을 사용합니다. --- -JSON config 파일을 사용하여 opencode를 구성할 수 있습니다. +JSON 구성 파일을 사용하여 OpenCode를 구성할 수 있습니다. --- ## 형식 -opencode는 **JSON** 및 **JSONC** (JSON with Comments) 형식을 지원합니다. +OpenCode는 **JSON** 및 **JSONC** (주석이 있는 JSON) 형식을 지원합니다. ```jsonc title="opencode.jsonc" { @@ -25,44 +25,44 @@ opencode는 **JSON** 및 **JSONC** (JSON with Comments) 형식을 지원합니 ## 위치 -다른 위치의 몇 개에 구성을 배치 할 수 있으며 그들은 -precedence의 다른 순서. +구성을 여러 위치에 배치할 수 있으며, 이들은 서로 다른 우선 순위(precedence)를 가집니다. :::note -구성 파일은 \*\* 함께, 대체되지 않습니다. +구성 파일은 **병합**되며, 대체되지 않습니다. ::: -구성 파일은 함께 결합되어 대체되지 않습니다. 다음 구성 위치에서 설정이 결합됩니다. 나중에 configs override 이전 하나만 충돌 키. 모든 구성에서 설정이 보존됩니다. +구성 파일은 함께 병합되며 대체되지 않습니다. 다음 구성 위치의 설정이 결합됩니다. 나중의 구성은 충돌하는 키에 대해 이전 구성을 덮어씁니다. 모든 구성의 설정이 보존됩니다. -예를 들어, 글로벌 구성 세트 `theme: "opencode"` 및 `autoupdate: true` 및 프로젝트 구성 세트 `model: "anthropic/claude-sonnet-4-5"`를 설정하면 최종 구성은 모든 세 가지 설정을 포함합니다. +예를 들어, 전역 구성이 `theme: "opencode"` 및 `autoupdate: true`를 설정하고 프로젝트 구성이 `model: "anthropic/claude-sonnet-4-5"`를 설정하면 최종 구성에는 세 가지 설정이 모두 포함됩니다. --- -### 임신 순서 +### 우선 순위 -Config 소스는 이 순서에서 적재됩니다 (더 많은 소스는 더 이른 것 삭제합니다): +구성 소스는 다음 순서로 로드됩니다 (나중 소스가 이전 소스를 덮어씀): -1. ** 원격 설정** (`.well-known/opencode`에서) - 조직 기본 2.**Global config** (`~/.config/opencode/opencode.json`) - 사용자 선호도 -2. ** 사용자 정의 설정** (`OPENCODE_CONFIG` env var) - 사용자 정의 overrides -3. ** 프로젝트 별 설정** (`opencode.json`) - 프로젝트 별 설정 -4. **`.opencode` 디렉토리 ** - 에이전트, 명령, 플러그인 -5. ** 인라인 설정** (`OPENCODE_CONFIG_CONTENT` env var) - 런타임 오버라이드 +1. **원격 구성** (`.well-known/opencode`에서) - 조직 기본값 +2. **전역 구성** (`~/.config/opencode/opencode.json`) - 사용자 환경설정 +3. **사용자 정의 구성** (`OPENCODE_CONFIG` 환경 변수) - 사용자 정의 재정의 +4. **프로젝트별 구성** (`opencode.json`) - 프로젝트별 설정 +5. **`.opencode` 디렉토리** - 에이전트, 명령, 플러그인 +6. **인라인 구성** (`OPENCODE_CONFIG_CONTENT` 환경 변수) - 런타임 재정의 -이것은 프로젝트 구성은 글로벌 디폴트를 override 할 수 있으며, 글로벌 구성은 원격 조직 디폴트를 override 할 수 있습니다. +이것은 프로젝트 구성이 전역 기본값을 덮어쓸 수 있고, 전역 구성이 원격 조직 기본값을 덮어쓸 수 있음을 의미합니다. :::note -`.opencode`와 `~/.config/opencode` 감독 사용 **plural 이름** 하위 디렉토리에 대 한: `agents/`, `commands/`, `modes/`, `plugins/`, `skills/`, `tools/`, 그리고 `themes/`. Singular 이름 (예를들면, `agent/`)는 또한 뒤쪽 겸용성을 위해 지원됩니다. +`.opencode`와 `~/.config/opencode` 디렉토리는 하위 디렉토리에 대해 **복수형 이름**을 사용합니다: `agents/`, `commands/`, `modes/`, `plugins/`, `skills/`, `tools/`, 그리고 `themes/`. 단수형 이름(예: `agent/`)도 하위 호환성을 위해 지원됩니다. ::: --- -### 리모트 +### 원격 -조직은 `.well-known/opencode` 엔드포인트를 통해 기본 구성을 제공 할 수 있습니다. 이것은 당신이 그것을 지원하는 공급자로 정통할 때 자동적으로 fetched. +조직은 `.well-known/opencode` 엔드포인트를 통해 기본 구성을 제공할 수 있습니다. 이를 지원하는 공급자로 인증할 때 자동으로 가져옵니다. -원격 설정은 기본 레이어로 제공된 첫 번째입니다. 다른 구성 소스 (글로벌, 프로젝트)는 이러한 기본값을 무시할 수 있습니다. +원격 구성은 기본 레이어로 가장 먼저 로드됩니다. 다른 구성 소스(전역, 프로젝트)는 이러한 기본값을 무시(override)할 수 있습니다. -예를 들어, 조직이 기본으로 비활성화 된 MCP 서버를 제공한다면: +예를 들어, 조직이 기본적으로 비활성화된 MCP 서버를 제공하는 경우: ```json title="Remote config from .well-known/opencode" { @@ -76,7 +76,7 @@ Config 소스는 이 순서에서 적재됩니다 (더 많은 소스는 더 이 } ``` -로컬 설정에서 특정 서버를 사용할 수 있습니다: +로컬 설정에서 특정 서버를 활성화할 수 있습니다: ```json title="opencode.json" { @@ -92,68 +92,65 @@ Config 소스는 이 순서에서 적재됩니다 (더 많은 소스는 더 이 --- -## 글로벌 +## 전역 -`~/.config/opencode/opencode.json`에서 글로벌 opencode 구성을 배치합니다. 테마, 공급자, keybinds와 같은 사용자 전체 선호도에 대한 글로벌 구성을 사용합니다. +`~/.config/opencode/opencode.json`에 전역 OpenCode 구성을 배치합니다. 테마, 공급자, 키바인드와 같은 사용자 전체 기본 설정에 전역 구성을 사용하십시오. -글로벌 구성 overrides 원격 조직 기본. +전역 구성은 원격 조직 기본값을 덮어씁니다. --- -## 프로젝트 당 +## 프로젝트별 -프로젝트 루트에 `opencode.json`를 추가합니다. Project config는 표준 구성 파일 중 가장 높은 우선순위가 있습니다. 이는 글로벌 및 원격 구성 모두 overrides합니다. +프로젝트 루트에 `opencode.json`을 추가합니다. 프로젝트 구성은 표준 구성 파일 중 가장 높은 우선순위를 가집니다. 이는 전역 및 원격 구성을 모두 덮어씁니다. :::tip -프로젝트의 루트에 특정 설정. +프로젝트의 루트에 특정 설정을 둡니다. ::: -opencode가 시작될 때, 현재 디렉토리의 설정 파일이나 가장 가까운 Git 디렉토리로 이동합니다. +OpenCode가 시작될 때, 현재 디렉토리의 설정 파일이나 가장 가까운 Git 디렉토리를 찾습니다. -이것은 Git로 검사되고 글로벌 하나로 동일한 schema를 사용합니다. +이것은 Git으로 관리되며 전역 구성과 동일한 스키마를 사용합니다. --- ### 사용자 정의 경로 -`OPENCODE_CONFIG` 환경 변수를 사용하여 사용자 정의 구성 파일 경로 지정. +`OPENCODE_CONFIG` 환경 변수를 사용하여 사용자 정의 구성 파일 경로를 지정합니다. ```bash export OPENCODE_CONFIG=/path/to/my/custom-config.json opencode run "Hello world" ``` -Custom config는 precedence 순서에 있는 세계적인 프로젝트 구성 사이에서 적재됩니다. +사용자 정의 구성은 우선 순위에서 전역 구성과 프로젝트 구성 사이에 로드됩니다. --- ## 사용자 정의 디렉토리 -`OPENCODE_CONFIG_DIR`를 사용하여 사용자 정의 구성 디렉토리 지정 -환경 변수. 이 디렉토리는 에이전트, 명령을 검색합니다, -모드 및 플러그인은 표준 `.opencode` 디렉토리와 같은, 그리고 해야 -동일한 구조를 따르십시오. +`OPENCODE_CONFIG_DIR` 환경 변수를 사용하여 사용자 정의 구성 디렉토리를 지정할 수 있습니다. 이 디렉토리는 표준 `.opencode` 디렉토리와 마찬가지로 에이전트, 명령, 모드 및 플러그인을 검색하며 동일한 구조를 따라야 합니다. ```bash export OPENCODE_CONFIG_DIR=/path/to/my/config-directory opencode run "Hello world" ``` -사용자 정의 디렉토리는 글로벌 구성 및 `.opencode` 디렉토리 후로드됩니다. \*\* 설정할 수 있습니다. +사용자 정의 디렉토리는 전역 구성 이후 및 `.opencode` 디렉토리 이전에 로드됩니다. --- -## 여성 +## 스키마 -구성 파일에는 [**`opencode.ai/config.json`**](https://opencode.ai/config.json)에서 정의된 스키마가 있습니다. +구성 파일에는 [**`opencode.ai/config.json`**](https://opencode.ai/config.json)에 정의된 스키마가 있습니다. -당신의 편집자는 schema에 근거를 둔 검증하고 자동 완성될 수 있어야 합니다. +편집기는 스키마에 따라 유효성 검사 및 자동 완성을 제공해야 합니다. --- #### TUI -`tui` 옵션을 통해 TUI-specific 설정을 구성할 수 있습니다. +`tui` 옵션을 통해 TUI 관련 설정을 구성할 수 있습니다. ```json title="opencode.json" { @@ -168,13 +165,13 @@ opencode run "Hello world" } ``` -유효한 선택권: +유효한 옵션: -- `scroll_acceleration.enabled` - macOS 스타일 스크롤 가속을 가능하게합니다. ** `scroll_speed`에 대한 준비. ** -- `scroll_speed` - 사용자 정의 스크롤 속도 승수 (기본: `3`, 최소: `1`). `scroll_acceleration.enabled`가 `true`인 경우에 Ignored. -- `diff_style` - 제어 디프 렌더링. `"auto"`는 terminal 폭에, `"stacked"` 항상 단 하나 란을 보여줍니다 적응시킵니다. +- `scroll_acceleration.enabled` - macOS 스타일 스크롤 가속을 활성화합니다. **`scroll_speed`보다 우선합니다.** +- `scroll_speed` - 사용자 정의 스크롤 속도 배수 (기본값: `3`, 최소값: `1`). `scroll_acceleration.enabled`가 `true`이면 무시됩니다. +- `diff_style` - diff 렌더링을 제어합니다. `"auto"`는 터미널 너비에 맞추고, `"stacked"`는 항상 단일 열을 보여줍니다. -[TUI를 사용하여 더 자세히 알아보기](/docs/tui). +[TUI 사용법에 대해 더 알아보기](/docs/tui). --- @@ -195,21 +192,21 @@ opencode run "Hello world" } ``` -유효한 선택권: +유효한 옵션: -- `port` - 듣는 항구. -- `hostname` - 듣는 호스트 이름. `mdns`가 활성화되고 hostname이 설정되지 않으면 `0.0.0.0`로 기본값이 됩니다. -- `mdns` - 사용 가능한 mDNS 서비스 발견. 이 네트워크에서 다른 장치가 opencode 서버를 발견 할 수 있습니다. -- `mdnsDomain` - mDNS 서비스에 대한 사용자 정의 도메인 이름. 기본 `opencode.local`. 동일한 네트워크에서 여러 인스턴스를 실행하는 데 유용합니다. -- `cors` - 브라우저 기반 클라이언트에서 HTTP 서버를 사용할 때 CORS를 허용하는 추가 기원. 가치는 가득 차있는 근원이어야 합니다 (scheme + 주인 + 선택적인 항구), 예를들면 `https://app.example.com`. +- `port` - 리스닝 포트. +- `hostname` - 리스닝 호스트 이름. `mdns`가 활성화되고 hostname이 설정되지 않으면 `0.0.0.0`이 기본값이 됩니다. +- `mdns` - mDNS 서비스 발견 활성화. 로컬 네트워크의 다른 장치가 OpenCode 서버를 찾을 수 있습니다. +- `mdnsDomain` - mDNS 서비스를 위한 사용자 정의 도메인 이름. 기본값은 `opencode.local`입니다. 동일한 네트워크에서 여러 인스턴스를 실행할 때 유용합니다. +- `cors` - 브라우저 기반 클라이언트에서 HTTP 서버를 사용할 때 CORS를 허용할 추가 출처(Origin). 값은 전체 출처(스킴 + 호스트 + 선택적 포트)여야 합니다. 예: `https://app.example.com`. -[서버에 대해 자세히 알아보기](/docs/server). +[서버에 대해 더 알아보기](/docs/server). --- ## 도구 -LLM은 `tools` 옵션을 통해 사용할 수 있습니다. +`tools` 옵션을 통해 LLM이 사용할 수 있는 도구를 구성할 수 있습니다. ```json title="opencode.json" { @@ -221,13 +218,13 @@ LLM은 `tools` 옵션을 통해 사용할 수 있습니다. } ``` -[이 도구에 대해 자세히 알아보기](/docs/tools). +[도구에 대해 더 알아보기](/docs/tools). --- ## 모델 -`provider`, `model` 및 `small_model` 옵션을 통해 opencode config에서 사용하려는 공급자와 모델을 구성할 수 있습니다. +`provider`, `model`, `small_model` 옵션을 통해 OpenCode 구성에서 사용할 공급자와 모델을 구성할 수 있습니다. ```json title="opencode.json" { @@ -238,9 +235,9 @@ LLM은 `tools` 옵션을 통해 사용할 수 있습니다. } ``` -`small_model` 옵션은 제목 생성과 같은 경량 작업을 위한 별도의 모델을 구성합니다. 기본적으로, opencode는 당신의 공급자에게서 1개가 유효하다면 더 싼 모형을 이용하는 것을 시도합니다, 그렇지 않으면 당신의 주요 모형에 돌려보냅니다. +`small_model` 옵션은 제목 생성과 같은 가벼운 작업을 위한 별도의 모델을 구성합니다. 기본적으로, OpenCode는 공급자에게서 사용 가능한 더 저렴한 모델이 있다면 그것을 사용하고, 그렇지 않으면 주 모델로 돌아갑니다. -공급자 선택권은 `timeout`와 `setCacheKey`를 포함할 수 있습니다: +공급자 옵션은 `timeout`과 `setCacheKey`를 포함할 수 있습니다: ```json title="opencode.json" { @@ -256,20 +253,20 @@ LLM은 `tools` 옵션을 통해 사용할 수 있습니다. } ``` -- `timeout` - 밀리 초 (기본: 300000)에서 타임 아웃 요청. `false`로 분리할 수 있습니다. -- `setCacheKey` - 캐시 키가 항상 지정된 공급자를 위해 설정됩니다. +- `timeout` - 요청 타임아웃(밀리초) (기본값: 300000). `false`로 설정하여 비활성화할 수 있습니다. +- `setCacheKey` - 지정된 공급자에 대해 캐시 키가 항상 설정되도록 강제합니다. -[local model](/docs/models#local)을 구성할 수 있습니다. [더 알아보기](/docs/models). +[로컬 모델](/docs/models#local)을 구성할 수도 있습니다. [더 알아보기](/docs/models). --- -### 공급자 특정 선택권 +### 공급자별 옵션 -몇몇 공급자는 일반적인 `timeout` 및 `apiKey` 조정을 넘어서 추가 구성 선택권을 지원합니다. +일반적인 `timeout` 및 `apiKey` 외에도 일부 공급자는 추가 구성 옵션을 지원합니다. -##### 아마존 베드록 +##### Amazon Bedrock -Amazon Bedrock는 AWS 별 구성을 지원합니다: +Amazon Bedrock는 AWS 관련 구성을 지원합니다: ```json title="opencode.json" { @@ -286,21 +283,21 @@ Amazon Bedrock는 AWS 별 구성을 지원합니다: } ``` -- `region` - Bedrock를 위한 AWS 지역 (`AWS_REGION` env var 또는 `us-east-1`에 기본) -- `profile` - AWS는 `~/.aws/credentials` (`AWS_PROFILE` env var에 기본)에서 단면도 지명했습니다 -- `endpoint` - VPC 엔드 포인트에 대한 사용자 정의 엔드 포인트 URL. 이것은 AWS 별 용어를 사용하여 일반적인 `baseURL` 옵션에 대한 별명입니다. 둘 다 지정되는 경우에, `endpoint`는 전진합니다. +- `region` - Bedrock를 위한 AWS 리전 (`AWS_REGION` 환경 변수 또는 `us-east-1`이 기본값) +- `profile` - `~/.aws/credentials`의 AWS 프로필 이름 (`AWS_PROFILE` 환경 변수가 기본값) +- `endpoint` - VPC 엔드포인트 등을 위한 사용자 정의 엔드포인트 URL. 이는 AWS 관련 용어를 사용한 일반적인 `baseURL` 옵션의 별칭입니다. 둘 다 지정된 경우 `endpoint`가 우선합니다. :::note -Bearer 토큰 (`AWS_BEARER_TOKEN_BEDROCK` 또는 `/connect`)은 프로파일 기반 인증을 통해 우선 순위를 부여합니다. 자세한 내용은 [authentication precedence](/docs/providers#authentication-precedence)를 참조하십시오. +Bearer 토큰(`AWS_BEARER_TOKEN_BEDROCK` 또는 `/connect`)은 프로필 기반 인증보다 우선합니다. 자세한 내용은 [인증 우선 순위](/docs/providers#authentication-precedence)를 참조하십시오. ::: -[Amazon-bedrock에 대해 자세히 알아보기](/docs/providers#amazon-bedrock). +[Amazon Bedrock에 대해 더 알아보기](/docs/providers#amazon-bedrock). --- ## 테마 -`theme` 옵션을 통해 opencode config에서 사용하려는 테마를 구성할 수 있습니다. +`theme` 옵션을 통해 OpenCode 구성에서 사용할 테마를 설정할 수 있습니다. ```json title="opencode.json" { @@ -315,7 +312,7 @@ Bearer 토큰 (`AWS_BEARER_TOKEN_BEDROCK` 또는 `/connect`)은 프로파일 기 ## 에이전트 -`agent` 옵션을 통해 특정 작업을 전문 에이전트를 구성할 수 있습니다. +`agent` 옵션을 통해 특정 작업을 전문으로 하는 에이전트를 구성할 수 있습니다. ```jsonc title="opencode.jsonc" { @@ -335,13 +332,13 @@ Bearer 토큰 (`AWS_BEARER_TOKEN_BEDROCK` 또는 `/connect`)은 프로파일 기 } ``` -`~/.config/opencode/agents/` 또는 `.opencode/agents/`에서 Markdown 파일을 사용하여 에이전트를 정의 할 수 있습니다. [더 알아보기](/docs/시약). +`~/.config/opencode/agents/` 또는 `.opencode/agents/`에서 Markdown 파일을 사용하여 에이전트를 정의할 수도 있습니다. [더 알아보기](/docs/agents). --- ### 기본 에이전트 -`default_agent` 옵션을 사용하여 기본 에이전트를 설정할 수 있습니다. 아무도 명시적으로 지정되지 않을 때 에이전트가 사용되는 결정. +`default_agent` 옵션을 사용하여 기본 에이전트를 설정할 수 있습니다. 명시적으로 지정되지 않았을 때 어떤 에이전트가 사용될지 결정합니다. ```json title="opencode.json" { @@ -350,15 +347,15 @@ Bearer 토큰 (`AWS_BEARER_TOKEN_BEDROCK` 또는 `/connect`)은 프로파일 기 } ``` -기본 에이전트은 주요 에이전트이어야 합니다 (미약 아닙니다). 이것은 `"build"` 또는 `"plan"`, 또는 정의된 [custom 에이전트](./agents) 같이 붙박이 에이전트일 수 있습니다. 지정된 에이전트가 존재하지 않는 경우, opencode는 경고로 `"build"`로 돌아갑니다. +기본 에이전트는 기본(primary) 에이전트여야 합니다(서브 에이전트 불가). `"build"` 또는 `"plan"`과 같은 내장 에이전트이거나 정의된 [사용자 정의 에이전트](./agents)일 수 있습니다. 지정된 에이전트가 존재하지 않는 경우, OpenCode는 경고와 함께 `"build"`로 돌아갑니다. -이 설정은 모든 인터페이스에서 적용됩니다: TUI, CLI (`opencode run`), 데스크탑 앱 및 GitHub Action. +이 설정은 모든 인터페이스에 적용됩니다: TUI, CLI (`opencode run`), 데스크톱 앱 및 GitHub Action. --- ## 공유 -`share` 옵션을 통해 [share](/docs/share) 기능을 구성할 수 있습니다. +`share` 옵션을 통해 [공유](/docs/share) 기능을 구성할 수 있습니다. ```json title="opencode.json" { @@ -367,19 +364,19 @@ Bearer 토큰 (`AWS_BEARER_TOKEN_BEDROCK` 또는 `/connect`)은 프로파일 기 } ``` -이 소요: +값은 다음과 같습니다: -- `"manual"` - 명령을 통해 수동 공유 허용 (기본값) -- `"auto"` - 자동 공유 새로운 대화 -- `"disabled"` - 완전하게 공유할 수 있는 +- `"manual"` - 명령을 통한 수동 공유 허용 (기본값) +- `"auto"` - 새로운 대화를 자동으로 공유 +- `"disabled"` - 공유 기능 완전히 비활성화 -기본적으로 `/share` 명령을 사용하여 대화를 명시적으로 공유해야 할 수동 모드로 설정됩니다. +기본적으로 `/share` 명령을 사용하여 대화를 명시적으로 공유해야 하는 수동 모드로 설정됩니다. --- ## 명령 -`command` 옵션을 통해 반복 작업을 위한 사용자 지정 명령을 구성할 수 있습니다. +`command` 옵션을 통해 반복 작업을 위한 사용자 정의 명령을 구성할 수 있습니다. ```jsonc title="opencode.jsonc" { @@ -390,6 +387,8 @@ Bearer 토큰 (`AWS_BEARER_TOKEN_BEDROCK` 또는 `/connect`)은 프로파일 기 "description": "Run tests with coverage", "agent": "build", "model": "anthropic/claude-haiku-4-5", + "agent": "build", + "model": "anthropic/claude-haiku-4-5", }, "component": { "template": "Create a new React component named $ARGUMENTS with TypeScript support.\nInclude proper typing and basic structure.", @@ -399,13 +398,13 @@ Bearer 토큰 (`AWS_BEARER_TOKEN_BEDROCK` 또는 `/connect`)은 프로파일 기 } ``` -`~/.config/opencode/commands/` 또는 `.opencode/commands/`에서 Markdown 파일을 사용하여 명령을 정의 할 수 있습니다. [더 이상](/docs/commands). +`~/.config/opencode/commands/` 또는 `.opencode/commands/`에서 Markdown 파일을 사용하여 명령을 정의할 수도 있습니다. [더 알아보기](/docs/commands). --- -## 키빈드 +## 키바인드 -`keybinds` 옵션을 통해 keybinds를 사용자 정의 할 수 있습니다. +`keybinds` 옵션을 통해 키바인드를 사용자 정의할 수 있습니다. ```json title="opencode.json" { @@ -420,7 +419,7 @@ Bearer 토큰 (`AWS_BEARER_TOKEN_BEDROCK` 또는 `/connect`)은 프로파일 기 ## 자동 업데이트 -opencode는 자동으로 시작될 때 새로운 업데이트를 다운로드합니다. `autoupdate` 옵션으로 이것을 비활성화 할 수 있습니다. +OpenCode는 시작될 때 자동으로 새로운 업데이트를 다운로드합니다. `autoupdate` 옵션으로 이를 비활성화할 수 있습니다. ```json title="opencode.json" { @@ -429,14 +428,14 @@ opencode는 자동으로 시작될 때 새로운 업데이트를 다운로드합 } ``` -업데이트를 원하지 않으면 새로운 버전이 사용할 수있을 때 알림을하고 `autoupdate`를 `"notify"`로 설정하십시오. +업데이트를 원하지 않지만 새 버전을 알림받고 싶다면 `autoupdate`를 `"notify"`로 설정하십시오. Homebrew와 같은 패키지 관리자를 사용하여 설치되지 않은 경우에만 작동합니다. --- -## 형식 +## 포매터 -`formatter` 옵션을 통해 코드 형식기를 구성할 수 있습니다. +`formatter` 옵션을 통해 코드 포매터를 구성할 수 있습니다. ```json title="opencode.json" { @@ -456,15 +455,15 @@ Homebrew와 같은 패키지 관리자를 사용하여 설치되지 않은 경 } ``` -[출판자에 대해 자세히 알아보기](/docs/formatters). +[포매터에 대해 더 알아보기](/docs/formatters). --- -## # 권한 +## 권한 -기본적으로, opencode ** 명시된 승인 없이 모든 작업**을 허용한다. `permission` 옵션을 사용하여 이것을 변경할 수 있습니다. +기본적으로, OpenCode는 **명시적 승인 없이 모든 작업을 허용**합니다. `permission` 옵션을 사용하여 이를 변경할 수 있습니다. -예를 들어, `edit` 및 `bash` 도구가 사용자 승인을 요구합니다. +예를 들어, `edit` 및 `bash` 도구가 사용자 승인을 요구하도록 설정하려면: ```json title="opencode.json" { @@ -476,7 +475,7 @@ Homebrew와 같은 패키지 관리자를 사용하여 설치되지 않은 경 } ``` -[이 권한에 대해 더 알아보기](/docs/permissions). +[권한에 대해 더 알아보기](/docs/permissions). --- @@ -494,14 +493,14 @@ Homebrew와 같은 패키지 관리자를 사용하여 설치되지 않은 경 } ``` -- `auto` - 컨텍스트가 풀 때 자동으로 세션을 압축합니다 (기본: `true`). -- `prune` - 토큰을 저장하기 위해 오래된 도구 출력을 제거 (기본: `true`). +- `auto` - 컨텍스트가 꽉 차면 자동으로 세션을 압축합니다 (기본값: `true`). +- `prune` - 토큰을 절약하기 위해 오래된 도구 출력을 제거합니다 (기본값: `true`). --- -### 시계 +### 파일 감시자 -`watcher` 옵션을 통해 파일워커가 패턴을 무시할 수 있습니다. +`watcher` 옵션을 통해 파일 감시자가 무시할 패턴을 설정할 수 있습니다. ```json title="opencode.json" { @@ -512,7 +511,7 @@ Homebrew와 같은 패키지 관리자를 사용하여 설치되지 않은 경 } ``` -패턴은 glob 구문을 따릅니다. 이 파일을 보시려면 noisy 디렉토리를 제외하십시오. +패턴은 glob 구문을 따릅니다. 잡음이 많은 디렉토리를 제외하는 데 사용하십시오. --- @@ -527,15 +526,15 @@ Homebrew와 같은 패키지 관리자를 사용하여 설치되지 않은 경 } ``` -[더 이상](/docs/mcp-servers). +[더 알아보기](/docs/mcp-servers). --- ### 플러그인 -[Plugins](/docs/plugins)는 사용자 정의 도구, 후크 및 통합으로 opencode를 확장합니다. +[플러그인](/docs/plugins)은 사용자 정의 도구, 훅(hook), 통합으로 OpenCode를 확장합니다. -`.opencode/plugins/` 또는 `~/.config/opencode/plugins/`에서 플러그인 파일을 배치하십시오. `plugin` 옵션을 통해 npm에서 플러그인을로드 할 수 있습니다. +`.opencode/plugins/` 또는 `~/.config/opencode/plugins/`에 플러그인 파일을 배치하십시오. `plugin` 옵션을 통해 npm에서 플러그인을 로드할 수 있습니다. ```json title="opencode.json" { @@ -544,13 +543,13 @@ Homebrew와 같은 패키지 관리자를 사용하여 설치되지 않은 경 } ``` -[더 이상](/docs/plugins). +[더 알아보기](/docs/plugins). --- -### 지시 +### 지침 -`instructions` 옵션을 통해 사용할 모델에 대한 지침을 구성할 수 있습니다. +`instructions` 옵션을 통해 모델에 대한 지침(Rules)을 구성할 수 있습니다. ```json title="opencode.json" { @@ -559,14 +558,13 @@ Homebrew와 같은 패키지 관리자를 사용하여 설치되지 않은 경 } ``` -이 경로와 glob 패턴의 배열을 사용하여 명령 파일. [더 알아보기 -여기 규칙에 관하여](./rules). +지침 파일에 대한 경로와 glob 패턴의 배열을 사용합니다. [규칙에 대해 더 알아보기](/docs/rules). --- -## Disabled 공급자 +## 비활성화된 공급자 -`disabled_providers` 옵션을 통해 자동으로 로드된 공급자를 비활성화할 수 있습니다. 이것은 당신이 그들의 credentials가 유효하다하더라도 적재되는에서 특정 공급자를 방지할 때 유용합니다. +`disabled_providers` 옵션을 통해 자동으로 로드되는 공급자를 비활성화할 수 있습니다. 자격 증명이 유효하더라도 특정 공급자가 로드되는 것을 방지할 때 유용합니다. ```json title="opencode.json" { @@ -576,20 +574,20 @@ Homebrew와 같은 패키지 관리자를 사용하여 설치되지 않은 경 ``` :::note -`disabled_providers`는 `enabled_providers`에 우선권을 가지고 있습니다. +`disabled_providers`는 `enabled_providers`보다 우선합니다. ::: `disabled_providers` 옵션은 공급자 ID의 배열을 허용합니다. 공급자가 비활성화되면: - 환경 변수가 설정된 경우에도 로드되지 않습니다. -- API 키가 `/connect` 명령을 통해 구성되는 경우에도로드되지 않습니다. +- API 키가 `/connect` 명령을 통해 구성되는 경우에도 로드되지 않습니다. - 공급자의 모델은 모델 선택 목록에 표시되지 않습니다. --- -### Enabled 공급자 +### 활성화된 공급자 -`enabled_providers` 옵션을 통해 공급자의 수당을 지정할 수 있습니다. 설정할 때 지정된 공급자만이 활성화되고 다른 모든 사람들이 무시됩니다. +`enabled_providers` 옵션을 통해 허용할 공급자를 지정할 수 있습니다. 설정하면 지정된 공급자만 활성화되고 다른 모든 공급자는 무시됩니다. ```json title="opencode.json" { @@ -598,19 +596,19 @@ Homebrew와 같은 패키지 관리자를 사용하여 설치되지 않은 경 } ``` -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` 키는 활발히 개발 중인 옵션을 포함합니다. ```json title="opencode.json" { @@ -620,20 +618,20 @@ opencode를 제한 할 때 유용합니다. 특정 공급자를 사용하지 않 ``` :::caution -실험 옵션은 안정되지 않습니다. 그들은 예고없이 변경하거나 제거 할 수 있습니다. +실험적 옵션은 안정적이지 않습니다. 예고 없이 변경되거나 제거될 수 있습니다. ::: --- ## 변수 -config 파일에서 참조 환경 변수 및 파일 내용에 대한 변수 대변을 사용할 수 있습니다. +구성 파일에서 환경 변수를 참조하고 파일 내용에 대한 변수 대체를 사용할 수 있습니다. --- -##### Env 바 +##### 환경 변수 -`{env:VARIABLE_NAME}`를 사용하여 환경 변수를 대체합니다. +`{env:VARIABLE_NAME}`을 사용하여 환경 변수를 대체합니다. ```json title="opencode.json" { @@ -674,11 +672,11 @@ config 파일에서 참조 환경 변수 및 파일 내용에 대한 변수 대 파일 경로는: -- config 파일 디렉토리에 관계 -- 또는 `/` 또는 `~`로 시작하는 절대 경로 +- 구성 파일 디렉토리에 상대적이거나 +- `/` 또는 `~`로 시작하는 절대 경로여야 합니다. -이것들은 유용하다: +이것은 다음에 유용합니다: -- 별도의 파일에서 API 키와 같은 민감한 데이터를 유지. -- config를 cluttering하지 않고 큰 명령어 파일을 포함합니다. -- 여러 구성 파일에서 공통 구성 스니펫 공유. +- API 키와 같은 민감한 데이터를 별도의 파일에 유지할 때. +- 구성을 어지럽히지 않고 큰 지침 파일을 포함할 때. +- 여러 구성 파일에서 공통 구성 스니펫을 공유할 때. diff --git a/packages/web/src/content/docs/ko/custom-tools.mdx b/packages/web/src/content/docs/ko/custom-tools.mdx index 8eff26669..5da050f49 100644 --- a/packages/web/src/content/docs/ko/custom-tools.mdx +++ b/packages/web/src/content/docs/ko/custom-tools.mdx @@ -1,6 +1,6 @@ --- -title: Custom Tools -description: Create tools the LLM can call in opencode. +title: 사용자 정의 도구 +description: OpenCode에서 LLM이 호출할 수 있는 도구를 만듭니다. --- 사용자 정의 도구는 LLM이 대화 중에 호출 할 수있는 기능을 만듭니다. 그들은 `read`, `write` 및 `bash`와 같은 opencode의 [붙박이 도구](./tools)와 함께 작동합니다. @@ -45,7 +45,7 @@ export default tool({ --- -### 파일 당 다수 공구 +### 파일당 여러 도구 단일 파일에서 여러 도구를 수출할 수 있습니다. 각 수출은 ** 별도의 도구 ** 이름 ** `_`**: @@ -79,7 +79,7 @@ export const multiply = tool({ --- -#### 가격 +#### 스키마 `tool.schema`를 사용할 수 있습니다, 그냥 [Zod](https://zod.dev), 인수 유형을 정의합니다. @@ -108,7 +108,7 @@ export default { --- -### 텍스트 +### 컨텍스트 도구는 현재 세션에 대한 컨텍스트를받습니다. diff --git a/packages/web/src/content/docs/ko/ecosystem.mdx b/packages/web/src/content/docs/ko/ecosystem.mdx index 21bce0db5..afb741c3d 100644 --- a/packages/web/src/content/docs/ko/ecosystem.mdx +++ b/packages/web/src/content/docs/ko/ecosystem.mdx @@ -1,6 +1,6 @@ --- -title: Ecosystem -description: Projects and integrations built with opencode. +title: 생태계 +description: OpenCode로 구축된 프로젝트 및 통합. --- opencode에 내장 된 커뮤니티 프로젝트의 컬렉션. diff --git a/packages/web/src/content/docs/ko/enterprise.mdx b/packages/web/src/content/docs/ko/enterprise.mdx index 806da8eb1..9055b592b 100644 --- a/packages/web/src/content/docs/ko/enterprise.mdx +++ b/packages/web/src/content/docs/ko/enterprise.mdx @@ -1,6 +1,6 @@ --- -title: Enterprise -description: Using opencode securely in your organization. +title: 엔터프라이즈 +description: 조직에서 OpenCode를 안전하게 사용하세요. --- import config from "../../../../config.mjs" @@ -75,7 +75,7 @@ opencode Enterprise의 per-seat 모델을 사용합니다. LLM 게이트웨이 --- -### 중앙 Config +### 중앙 구성 opencode를 설정하여 전체 조직의 단일 중앙 구성을 사용할 수 있습니다. @@ -111,14 +111,14 @@ opencode는 기존 ID 관리 시스템을 통해 내부 AI 게이트웨이에 ## 자주 묻는 질문

-What is opencode Enterprise? +opencode Enterprise란 무엇입니까? opencode Enterprise는 코드와 데이터가 인프라를 결코 나타낸다는 것을 보증하는 단체입니다. SSO 및 내부 AI 게이트웨이와 통합하는 중앙화 된 구성을 사용하여 이것을 할 수 있습니다.
-How do I get started with opencode Enterprise? +opencode Enterprise를 어떻게 시작하나요? 단순히 팀과 내부 평가판을 시작합니다. 기본값으로 opencode는 코드를 저장하지 않거나 context data, 시작하기 쉬운 만들기. @@ -127,21 +127,21 @@ opencode Enterprise는 코드와 데이터가 인프라를 결코 나타낸다
-How does enterprise pricing work? +엔터프라이즈 가격 정책은 어떻게 되나요? 우리는 per-seat 기업 가격을 제안합니다. LLM 게이트웨이를 가지고 있다면 토큰을 사용할 수 없습니다. 더 자세한 내용은 **contact us** 를 통해 조직의 요구에 따라 맞춤형 견적을 제공합니다.
-Is my data secure with opencode Enterprise? +opencode Enterprise에서 내 데이터는 안전한가요? 예. opencode는 코드 또는 컨텍스트 데이터를 저장하지 않습니다. 모든 처리는 로컬 또는 직접 API 호출을 통해 AI 공급자. 중앙 설정 및 SSO 통합으로 데이터는 조직의 인프라 내에서 안전하게 유지됩니다.
-Can we use our own private npm registry? +자체 비공개 npm 레지스트리를 사용할 수 있나요? opencode는 Bun's native `.npmrc` 파일 지원을 통해 개인 npm 등록을 지원합니다. 조직이 JFrog Artifactory, Nexus 또는 이와 같은 개인 레지스트리를 사용한다면, 개발자가 opencode를 실행하기 전에 인증됩니다. diff --git a/packages/web/src/content/docs/ko/formatters.mdx b/packages/web/src/content/docs/ko/formatters.mdx index 9617a368a..c2e539be6 100644 --- a/packages/web/src/content/docs/ko/formatters.mdx +++ b/packages/web/src/content/docs/ko/formatters.mdx @@ -1,6 +1,6 @@ --- -title: Formatters -description: opencode uses language specific formatters. +title: 포매터 +description: opencode는 언어별 포매터를 사용합니다. --- opencode는 언어 별 형식을 사용하여 작성 또는 편집 한 후 자동으로 파일을 포맷합니다. 이 생성 된 코드는 프로젝트의 코드 스타일을 따릅니다. @@ -11,39 +11,37 @@ opencode는 언어 별 형식을 사용하여 작성 또는 편집 한 후 자 opencode는 인기있는 언어 및 프레임 워크에 대한 몇 가지 내장 형식자와 함께 제공됩니다. 아래는 formatters, 지원된 파일 확장 및 명령 또는 구성 옵션의 목록입니다. -| 형식 | 연장 | 요구 사항 | -| ----- | ------------------------------------------- | ----------------- | -| gofmt | .go | `gofmt` 명령 가능 | -| 믹스 | .ex, .ex, .eex, .heex, .leex, .neex, .sface | `mix` 명령 가능 | - -인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 -| 바이오메 | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml, [기타](https://biomejs.dev/) | `biome.json(c)` 구성 파일 | -| 지그 | .zig, .zon | `zig` 명령 가능 | -| clang-format | .c, .cpp, .h, .hpp, .ino, [기타](https://clang.llvm.org/docs/ClangFormat.html) | `.clang-format` 구성 파일 | -| ktlint | .kt, .kts | `ktlint` 명령 가능 | -| ruff | .py, .pyi | 구성 가능한 `ruff` 명령 | -| rustfmt | .rs | `rustfmt` 명령 가능 | -| 화물fmt | .rs | `cargo fmt` 명령 가능 | -| uv | .py, .pyi | `uv` 명령 가능 | -| rubocop | .rb, .rake, .gemspec, .ru | `rubocop` 명령 사용 가능 | -| 표준 | .rb, .rake, .gemspec, .ru | `standardrb` 명령 사용 가능 | -| htmlbeautifier | .erb, .html.erb | `htmlbeautifier` 명령 가능 | -| 공기 | .R | `air` 명령 가능 | -| 다트 | 다트 | `dart` 명령 | -| ocamlformat | .ml, .mli | `ocamlformat` 명령 가능·`.ocamlformat` 설정 파일 | -| 지형 | .tf, .tfvars | `terraform` 명령 가능 | -| gleam | .gleam | `gleam` 명령 가능 | -| nixfmt | .nix | `nixfmt` 명령 가능 | -| shfmt | .sh, .bash | `shfmt` 명령 가능 | -| 핀 | .php | `laravel/pint` 의존도 `composer.json` | -| oxfmt (Experimental) | .js, .jsx, .ts, .tsx | `oxfmt` Dependency in `package.json`, [experimental env 변수 플래그](/docs/cli/#experimental) | -| ormolu | .hs | `ormolu` 명령 가능 | +| 포매터 | 확장자 | 요구 사항 | +| -------------------- | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | +| gofmt | .go | `gofmt` 명령 사용 가능 | +| Mix | .ex, .ex, .eex, .heex, .leex, .neex, .sface | `mix` 명령 사용 가능 | +| 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` 구성 파일 | +| ktlint | .kt, .kts | `ktlint` 명령 사용 가능 | +| ruff | .py, .pyi | 구성 가능한 `ruff` 명령 | +| rustfmt | .rs | `rustfmt` 명령 사용 가능 | +| cargo fmt | .rs | `cargo fmt` 명령 사용 가능 | +| uv | .py, .pyi | `uv` 명령 사용 가능 | +| rubocop | .rb, .rake, .gemspec, .ru | `rubocop` 명령 사용 가능 | +| StandardRB | .rb, .rake, .gemspec, .ru | `standardrb` 명령 사용 가능 | +| htmlbeautifier | .erb, .html.erb | `htmlbeautifier` 명령 사용 가능 | +| Air | .R | `air` 명령 사용 가능 | +| Dart | 다트 | `dart` 명령 | +| ocamlformat | .ml, .mli | `ocamlformat` 명령 사용 가능·`.ocamlformat` 설정 파일 | +| Terraform | .tf, .tfvars | `terraform` 명령 사용 가능 | +| gleam | .gleam | `gleam` 명령 사용 가능 | +| nixfmt | .nix | `nixfmt` 명령 사용 가능 | +| shfmt | .sh, .bash | `shfmt` 명령 사용 가능 | +| Pint | .php | `laravel/pint` 의존도 `composer.json` | +| oxfmt (Experimental) | .js, .jsx, .ts, .tsx | `oxfmt` Dependency in `package.json`, [experimental env 변수 플래그](/docs/cli/#experimental) | +| ormolu | .hs | `ormolu` 명령 사용 가능 | 그래서 프로젝트가 `prettier`를 `package.json`에 가지고 있다면, opencode는 자동으로 그것을 사용합니다. --- -## 어떻게 작동합니까? +## 작동 방식 opencode가 파일을 작성하거나 편집할 때: @@ -68,20 +66,20 @@ opencode config의 `formatter` 섹션을 통해 형식기를 사용자 정의 각 formatter 구성은 다음을 지원합니다: -| 재산 | 유형 | 묘사 | -| ------------- | -------- | ---------------------------------- | -| `disabled` | 불린 | 이 세트를 `true`로 포맷터 비활성화 | -| `command` | 문자열[] | 형식을 실행하는 명령 | -| `environment` | 객체 | 형식의 실행시 설정하는 환경 변수 | -| `extensions` | string[] | 이 형식의 파일 확장자 취급 | +| 속성 | 타입 | 설명 | +| ------------- | -------- | --------------------------------- | +| `disabled` | boolean | `true`로 설정하여 포매터 비활성화 | +| `command` | 문자열[] | 형식을 실행하는 명령 | +| `environment` | 객체 | 형식의 실행시 설정하는 환경 변수 | +| `extensions` | string[] | 이 형식의 파일 확장자 취급 | 몇 가지 예제를 살펴 보자. --- -## Disabling 형식자 +## 포매터 비활성화 -`false`에 `formatter`를 세계로 바꾸기 위하여 **all** formatters: +모든 포매터를 비활성화하려면 `formatter`를 `false`로 설정하십시오: ```json title="opencode.json" {3} { @@ -90,7 +88,7 @@ opencode config의 `formatter` 섹션을 통해 형식기를 사용자 정의 } ``` -** 특정** 형식, `disabled`를 `true`로 설정: +**특정** 포매터의 경우, `disabled`를 `true`로 설정하십시오: ```json title="opencode.json" {5} { @@ -105,7 +103,7 @@ opencode config의 `formatter` 섹션을 통해 형식기를 사용자 정의 --- -### 사용자 정의 형식 +### 사용자 정의 포매터 내장 형식자를 무시하거나 명령, 환경 변수 및 파일 확장을 지정하여 새로운 것을 추가 할 수 있습니다. diff --git a/packages/web/src/content/docs/ko/github.mdx b/packages/web/src/content/docs/ko/github.mdx index 2395ee667..777b8cb6d 100644 --- a/packages/web/src/content/docs/ko/github.mdx +++ b/packages/web/src/content/docs/ko/github.mdx @@ -1,16 +1,17 @@ --- title: GitHub -description: Use opencode in GitHub issues and pull-requests. +description: GitHub 이슈 및 풀 리퀘스트에서 opencode를 사용하세요. --- opencode는 GitHub 워크플로우와 통합됩니다. Mention `/opencode` 또는 `/oc` 당신의 의견에, 그리고 opencode는 당신의 GitHub 활동 주자 안에 작업을 실행할 것입니다. --- -## 특징 +## 기능 -- **문제**: opencode가 문제점을 보고 당신을 설명합니다. -- **Fix 및 구현 **: 이슈를 수정하거나 기능을 구현하려면 opencode에 문의하십시오. 그리고 새로운 지점에서 일하고 모든 변경으로 PR을 제출합니다. -**Secure**: opencode는 GitHub의 런너 내부에서 실행됩니다. +- **이슈**: opencode가 이슈를 보고 설명해 줍니다. +- **수정 및 구현**: 이슈를 수정하거나 기능을 구현하도록 opencode에 요청하세요. 새로운 브랜치에서 작업하고 변경 사항으로 PR을 제출합니다. +- **보안**: opencode는 GitHub 러너 내부에서 실행됩니다. --- @@ -30,11 +31,11 @@ GitHub 앱을 설치하고 워크플로를 만들고 비밀을 설정할 수 있 또는 수동으로 설정할 수 있습니다. -1. ** GitHub 앱 설치 ** +1. **GitHub 앱 설치** -[**github.com/apps/opencode-agent**](https://github.com/apps/opencode-agent)에 머리가 붙습니다. 대상 저장소에 설치되어 있는지 확인하십시오. +[**github.com/apps/opencode-agent**](https://github.com/apps/opencode-agent)로 이동합니다. 대상 저장소에 설치되어 있는지 확인하십시오. -2. ** 워크플로우 추가 ** +2. **워크플로우 추가** 저장소에 `.github/workflows/opencode.yml`에 다음 작업 흐름 파일을 추가합니다. 적절한 `model`를 설정하고 `env`의 API 키가 필요합니다. @@ -72,9 +73,9 @@ GitHub 앱을 설치하고 워크플로를 만들고 비밀을 설정할 수 있 # github_token: xxxx ``` -3. ** 비밀의 API 키 저장 ** +3. **API 키를 Secret으로 저장** -조직 또는 프로젝트 ** 설정**, 확장 ** 축소 및 변수 ** 왼쪽 및 선택 **Actions**. 그리고 필요한 API 키를 추가합니다. +조직 또는 프로젝트 **Settings**에서, 왼쪽의 **Secrets and variables**를 확장하고 **Actions**를 선택합니다. 그리고 필요한 API 키를 추가합니다. --- @@ -100,20 +101,20 @@ permissions: --- -## 지원된 사건 +## 지원되는 이벤트 opencode는 다음 GitHub 이벤트에 의해 트리거 될 수 있습니다: -| 이벤트 타입 | Triggered by | 상세 | -| ----------------------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------- | -| `issue_comment` | 발행 또는 PR에 대한 의견 | 멘션 `/opencode` 또는 `/oc` 당신의 의견. opencode는 컨텍스트를 읽고, 지점을 만들 수 있습니다, 열린 PR, 또는 대답. · | -| `pull_request_review_comment` | PR의 특정 코드 라인에 대한 의견 | Mention `/opencode` 또는 `/oc` 코드 검토 중. opencode는 파일 경로, 줄 번호 및 diff 컨텍스트를 수신합니다. · | -| `issues` | 이슈가 열리고 편집되었습니다 | 이슈가 생성되거나 수정될 때 자동으로 opencode를 트리거합니다. `prompt` 입력이 필요합니다. | -| `pull_request` | PR 오픈 또는 업데이트 | PR이 열릴 때 자동 트리거 opencode 자동 리뷰에 대한 유용한 정보 | -| `schedule` | 크론 기반 일정 | 일정에 opencode를 실행합니다. `prompt` 입력을 요구합니다. 출력 로그 및 PR에 간다 (댓글이 없습니다). | -| `workflow_dispatch` | GitHub UI에서 수동 트리거 | 액션 탭을 통해 까다로운 Trigger opencode. `prompt` 입력을 요구합니다. 출력 로그 및 PR에 간다. | +| 이벤트 타입 | Triggered by | 상세 | +| ----------------------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------- | +| `issue_comment` | 이슈 또는 PR 댓글 | 멘션 `/opencode` 또는 `/oc` 당신의 의견. opencode는 컨텍스트를 읽고, 지점을 만들 수 있습니다, 열린 PR, 또는 대답. · | +| `pull_request_review_comment` | PR의 특정 코드 라인 댓글 | Mention `/opencode` 또는 `/oc` 코드 검토 중. opencode는 파일 경로, 줄 번호 및 diff 컨텍스트를 수신합니다. · | +| `issues` | 이슈가 열리거나 편집됨 | 이슈가 생성되거나 수정될 때 자동으로 opencode를 트리거합니다. `prompt` 입력이 필요합니다. | +| `pull_request` | PR 오픈 또는 업데이트 | PR이 열릴 때 자동 트리거 opencode 자동 리뷰에 대한 유용한 정보 | +| `schedule` | 크론 기반 일정 | 일정에 opencode를 실행합니다. `prompt` 입력을 요구합니다. 출력 로그 및 PR에 간다 (댓글이 없습니다). | +| `workflow_dispatch` | GitHub UI에서 수동 트리거 | 액션 탭을 통해 까다로운 Trigger opencode. `prompt` 입력을 요구합니다. 출력 로그 및 PR에 간다. | -### 일정 예 +### 일정 예제 자동화된 작업을 수행하는 일정에 opencode를 실행: @@ -149,11 +150,11 @@ jobs: If you find issues worth addressing, open an issue to track them. ``` -예정된 이벤트의 경우, `prompt` 입력은 **필요 ** 이후의 지시를 추출할 수 없습니다. 사용자 컨텍스트 없이 실행되는 워크플로우는 권한 확인을 위해, 워크플로우는 `contents: write`와 `pull-requests: write`를 부여해야 하며, opencode가 지점이나 PR을 만들게 됩니다. +스케줄된 이벤트의 경우, `prompt` 입력은 **필요 ** 이후의 지시를 추출할 수 없습니다. 사용자 컨텍스트 없이 실행되는 워크플로우는 권한 확인을 위해, 워크플로우는 `contents: write`와 `pull-requests: write`를 부여해야 하며, opencode가 지점이나 PR을 만들게 됩니다. --- -## Pull 요청 예제 +## Pull Request 예제 자동 검토 PR 때 그들은 열려있거나 업데이트 : @@ -194,7 +195,7 @@ jobs: --- -### 문제 부족 예제 +### 이슈 분류 예제 자동으로 새로운 문제를 삼는다. 이 예제는 스팸을 줄이기 위해 30 일 이상 계정 필터 : @@ -272,7 +273,7 @@ opencode의 작업 흐름을 사용자 정의하는 기본 프롬프트를 부 GitHub에서 opencode를 사용할 수있는 몇 가지 예입니다. -- **문제 설명** +- **이슈 설명** GitHub 문제에서 이 의견 추가. @@ -282,7 +283,7 @@ GitHub 문제에서 이 의견 추가. opencode는 모든 코멘트를 포함하여 전체 스레드를 읽고, 명확한 설명과 대답. -- **문제** +- **이슈 해결** GitHub 문제에서: @@ -292,7 +293,7 @@ GitHub 문제에서: opencode는 새로운 지점을 만들 것이며 변경 사항을 실행하고 PR을 변경합니다. --**Review PR 및 변경 사항** +- **PR 및 변경 사항 검토** GitHub PR에 다음 댓글을 남겨주세요. @@ -302,7 +303,7 @@ GitHub PR에 다음 댓글을 남겨주세요. opencode는 요청한 변경을 구현하고 동일한 PR에 커밋합니다. -- ** 특정 코드 라인** +- **특정 코드 라인** PR의 "Files" 탭의 코드 라인에 직접 댓글을 남겨주세요. opencode는 파일, 줄 번호 및 diff 컨텍스트를 자동으로 감지하여 정확한 응답을 제공합니다. diff --git a/packages/web/src/content/docs/ko/gitlab.mdx b/packages/web/src/content/docs/ko/gitlab.mdx index 758ab0491..7b6468c74 100644 --- a/packages/web/src/content/docs/ko/gitlab.mdx +++ b/packages/web/src/content/docs/ko/gitlab.mdx @@ -1,6 +1,6 @@ --- title: GitLab -description: Use opencode in GitLab issues and merge requests. +description: GitLab 이슈 및 머지 리퀘스트에서 opencode를 사용하세요. --- opencode는 GitLab CI/CD 파이프라인 또는 GitLab Duo를 통해 GitLab 워크플로우와 통합됩니다. @@ -9,17 +9,17 @@ opencode는 GitLab CI/CD 파이프라인 또는 GitLab Duo를 통해 GitLab 워 --- -#GitLab CI 소개 +# 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). --- -### 특징 +### 기능 -- **일당 사용자 지정 구성 사용**: 사용자 정의 구성 디렉토리와 opencode 구성, 예를 들어 `./config/#custom-directory`는 opencode invocation 당 활성화하거나 비활성화 할 수 있습니다. +- **실행별 사용자 지정 구성 사용**: 사용자 정의 구성 디렉토리와 opencode 구성, 예를 들어 `./config/#custom-directory`는 opencode 실행마다 활성화하거나 비활성화 할 수 있습니다. - ** 최소 설정**: CI 구성 요소는 opencode를 배경으로 설정하면 opencode 구성과 초기 프롬프트를 만들 필요가 있습니다. - **Flexible**: CI 구성 요소는 여러 입력을 지원합니다. @@ -44,19 +44,19 @@ opencode는 일반 GitLab 파이프라인에서 작동합니다. [CI 구성품]( --- -## GitLab 듀오 +## GitLab Duo opencode는 GitLab 워크플로우와 통합됩니다. 코멘트에 Mention `@opencode`, opencode는 GitLab CI 파이프라인 내에서 작업을 실행합니다. --- -### 특징 +### 기능 -- **문제**: opencode가 문제점을 보고 당신을 설명합니다. -- **Fix 및 구현 **: 이슈를 수정하거나 기능을 구현하려면 opencode에 문의하십시오. +- **이슈**: opencode가 문제점을 보고 당신을 설명합니다. +- **수정 및 구현**: 이슈를 수정하거나 기능을 구현하려면 opencode에 문의하십시오. 새로운 지점을 만들고 변화를 병합 요청을 제기합니다. -- **Secure**: opencode는 GitLab runners에서 실행됩니다. +- **보안**: opencode는 GitLab runners에서 실행됩니다. --- @@ -164,7 +164,7 @@ opencode는 GitLab CI/CD 파이프라인에서 실행되며, 여기서 설정해 `@opencode`보다 다른 트리거 구문을 사용할 수 있습니다. ::: -- **문제 설명** +- **이슈 설명** GitLab 문제에서이 코멘트를 추가하십시오. @@ -174,7 +174,7 @@ GitLab 문제에서이 코멘트를 추가하십시오. opencode는 문제와 대답을 명확하게 설명합니다. -- **문제** +- **이슈 해결** GitLab 문제에서, 말한다: @@ -184,7 +184,7 @@ GitLab 문제에서, 말한다: opencode는 새로운 지점을 만들 것이며 변경 사항을 구현하고 변경 사항을 병합 요청을 엽니다. -- **Review 병합 요청** +- **머지 리퀘스트 검토** GitLab 병합 요청에 대한 다음 의견을 남겨주세요. diff --git a/packages/web/src/content/docs/ko/ide.mdx b/packages/web/src/content/docs/ko/ide.mdx index 2e5c2f55a..2df782a9e 100644 --- a/packages/web/src/content/docs/ko/ide.mdx +++ b/packages/web/src/content/docs/ko/ide.mdx @@ -1,17 +1,17 @@ --- title: IDE -description: The opencode extension for VS Code, Cursor, and other IDEs +description: VS Code, Cursor 및 기타 IDE용 opencode 확장 프로그램. --- -opencode는 VS Code, Cursor, 또는 terminal을 지원하는 IDE와 통합합니다. 시작하려면 terminal에서 `opencode`를 실행하십시오. +opencode는 VS Code, Cursor, 또는 터미널을 지원하는 IDE와 통합됩니다. 시작하려면 terminal에서 `opencode`를 실행하십시오. --- ## 사용법 --**Quick Launch**: `Cmd+Esc` (Mac) 또는 `Ctrl+Esc` (Windows/Linux)를 사용하여 균열 단자 전망에 opencode를 열거나 기존 terminal 세션을 이미 실행하면 됩니다. -**New Session**: `Cmd+Shift+Esc` (Mac) 또는 `Ctrl+Shift+Esc` (Windows/Linux)를 사용하여 새로운 opencode terminal 세션을 시작하려면 이미 열리면 됩니다. UI에서 opencode 버튼을 클릭합니다. -**Context Awareness**: opencode로 현재 선택 또는 탭을 자동으로 공유합니다. +-**Quick Launch**: `Cmd+Esc` (Mac) 또는 `Ctrl+Esc` (Windows/Linux)를 사용하여 통합 터미널 뷰에 opencode를 열거나 기존 terminal 세션을 이미 실행하면 됩니다. -**New Session**: `Cmd+Shift+Esc` (Mac) 또는 `Ctrl+Shift+Esc` (Windows/Linux)를 사용하여 새로운 opencode terminal 세션을 시작하려면 이미 열리면 됩니다. UI에서 opencode 버튼을 클릭합니다. -**Context Awareness**: opencode로 현재 선택 또는 탭을 자동으로 공유합니다. -- ** 파일 참조 단축키 ** : 파일 참조를 삽입하려면 `Cmd+Option+K` (Mac) 또는 `Alt+Ctrl+K` (Linux / Windows)를 사용하십시오. 예를 들어, `@File#L37-42`. +- **파일 참조 단축키** : 파일 참조를 삽입하려면 `Cmd+Option+K` (Mac) 또는 `Alt+Ctrl+K` (Linux / Windows)를 사용하십시오. 예를 들어, `@File#L37-42`. --- @@ -23,7 +23,7 @@ VS Code에 opencode를 설치하고 Cursor, Windsurf, VSCodium과 같은 인기 2. 통합 terminal을 여십시오 3. 실행 `opencode` - 확장 자동으로 설치 -당신이 TUI에서 `/editor` 또는 `/export`를 실행할 때 다른 한편에, 당신은 `export EDITOR="code --wait"`를 설정할 필요가 있을 것입니다. [Learn more](/docs/tui/#editor-setup). +반면에 TUI에서 `/editor` 또는 `/export`를 실행할 때, 당신은 `export EDITOR="code --wait"`를 설정할 필요가 있을 것입니다. [Learn more](/docs/tui/#editor-setup). --- diff --git a/packages/web/src/content/docs/ko/index.mdx b/packages/web/src/content/docs/ko/index.mdx index fd55c15ac..d5bd6a979 100644 --- a/packages/web/src/content/docs/ko/index.mdx +++ b/packages/web/src/content/docs/ko/index.mdx @@ -1,6 +1,6 @@ --- -title: Intro -description: Get started with opencode. +title: 소개 +description: OpenCode를 시작해 보세요. --- import { Tabs, TabItem } from "@astrojs/starlight/components" @@ -15,11 +15,11 @@ export const console = config.console --- -#### 사전 준비 +## 사전 준비 터미널에서 OpenCode를 사용하려면 다음이 필요합니다. -1. 최신 터미널 에뮬레이터(예:) +1. 최신 터미널 에뮬레이터 (예:) - [WezTerm](https://wezterm.org), 크로스 플랫폼 - [Alacritty](https://alacritty.org), 크로스 플랫폼 - [Ghostty](https://ghostty.org), Linux 및 macOS @@ -336,8 +336,8 @@ OpenCode와의 대화는 [팀과 공유](/docs/share)할 수 있습니다. --- -## 커스터마이즈 +## 사용자 지정 이제 OpenCode 사용의 기본은 끝났습니다. -자신의 워크플로우에 맞추려면 [테마 선택](/docs/themes), [키바인드 커스터마이즈](/docs/keybinds), [코드 포매터 설정](/docs/formatters), [커스텀 명령 작성](/docs/commands), [OpenCode config 조정](/docs/config)을 추천합니다. +자신의 워크플로우에 맞추려면 [테마 선택](/docs/themes), [키바인드 사용자 지정](/docs/keybinds), [코드 포매터 설정](/docs/formatters), [커스텀 명령 작성](/docs/commands), [OpenCode 구성 조정](/docs/config)을 추천합니다. diff --git a/packages/web/src/content/docs/ko/keybinds.mdx b/packages/web/src/content/docs/ko/keybinds.mdx index 487797fb1..d41fb8cef 100644 --- a/packages/web/src/content/docs/ko/keybinds.mdx +++ b/packages/web/src/content/docs/ko/keybinds.mdx @@ -1,6 +1,6 @@ --- -title: Keybinds -description: Customize your keybinds. +title: 키바인드 +description: 키바인드를 사용자 지정하세요. --- opencode는 opencode config를 통해 사용자 정의 할 수있는 keybinds 목록을 가지고 있습니다. @@ -111,11 +111,11 @@ opencode는 대부분의 keybinds에 대한 `leader` 키를 사용합니다. 이 기본적으로 `ctrl+x`는 리더 키이며 대부분의 작업은 리더 키를 먼저 누르고 단축키를 누릅니다. 예를 들어, 새 세션을 시작하려면 먼저 `ctrl+x`를 누르고 `n`를 누릅니다. -당신은 당신의 keybinds를 위한 지도자 열쇠를 사용할 필요가 없습니다 그러나 우리는 이렇게 추천합니다. +키바인드에 리더 키를 사용할 필요는 없지만, 사용하는 것을 권장합니다. --- -## 비활성화 keybind +## 키바인드 비활성화 "none"의 값으로 구성에 키를 추가하여 keybind를 비활성화 할 수 있습니다. @@ -134,7 +134,7 @@ opencode는 대부분의 keybinds에 대한 `leader` 키를 사용합니다. 이 opencode 데스크톱 앱 프롬프트 입력은 텍스트 편집을 위한 일반적인 Readline/Emacs-style 단축키를 지원합니다. 이들은 내장되어 있으며 현재 `opencode.json`를 통해 구성할 수 없습니다. -| 단축 | 액션 | +| 단축키 | 동작 | | -------- | -------------------------- | | `ctrl+a` | 현재 행 시작으로 이동 | | `ctrl+e` | 현재선 끝으로 이동 | @@ -152,11 +152,11 @@ opencode 데스크톱 앱 프롬프트 입력은 텍스트 편집을 위한 일 --- -## 시프트+ 이름 \* +## Shift+Enter -몇몇 terminal은 기본적으로 입력한 modifier 열쇠를 보내지 않습니다. `Shift+Enter`를 탈출 순서로 보낼 terminal을 구성해야 할 수 있습니다. +몇몇 terminal은 기본적으로 입력한 보조 키를 보내지 않습니다. `Shift+Enter`를 이스케이프 시퀀스로 보낼 terminal을 구성해야 할 수 있습니다. -### 윈도우 terminal +### Windows Terminal `settings.json`를 엽니다: @@ -189,4 +189,4 @@ opencode 데스크톱 앱 프롬프트 입력은 텍스트 편집을 위한 일 ] ``` -파일을 저장하고 Windows terminal을 다시 시작하거나 새 탭을 엽니 다. +파일을 저장하고 Windows Terminal을 다시 시작하거나 새 탭을 엽니 다. diff --git a/packages/web/src/content/docs/ko/lsp.mdx b/packages/web/src/content/docs/ko/lsp.mdx index 0bb5e8357..31d3dda26 100644 --- a/packages/web/src/content/docs/ko/lsp.mdx +++ b/packages/web/src/content/docs/ko/lsp.mdx @@ -1,52 +1,52 @@ --- -title: LSP Servers -description: opencode integrates with your LSP servers. +title: LSP 서버 +description: OpenCode는 LSP 서버와 통합되어 작동합니다. --- -opencode는 언어 서버 프로토콜 (LSP)과 통합하여 LLM은 코드베이스와 상호 작용합니다. 그것은 LLM에 피드백을 제공하기 위해 진단을 사용합니다. +OpenCode는 언어 서버 프로토콜(LSP)과 통합되어 LLM이 코드베이스와 상호 작용할 수 있게 돕습니다. 이를 통해 진단 정보를 사용하여 LLM에 피드백을 제공합니다. --- -## 내장 +## 기본 제공 (Built-in) -opencode는 인기있는 언어로 여러 내장 LSP 서버와 함께 제공됩니다. +OpenCode는 인기 있는 언어들에 대해 여러 내장 LSP 서버를 제공합니다. -| LSP 서버 | 연장 | 요구사항 | -| ----------------- | ------------------------------------------------------------------ | ----------------------------------------------- | -| 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` 명령 | -| 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 | 루아 사업용 자동설치 | -| nixd | .nix | `nixd` 명령 가능 | -| ocaml-lsp | .ml, .mli | `ocamllsp` 명령 가능 | -| oxlint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .ct, .vue, .astro, .svelte | 프로젝트의 `oxlint` 신뢰성 | -| PHP intelephense | .php | PHP 프로젝트 자동 설치 | -| 프리즘 | .prisma | `prisma` 명령 가능 | -| pyright | .py, .pyi | `pyright` 의존성 설치 | -| 루비-lsp(rubocop) | .rb, .rake, .gemspec, .ru | `ruby` 및 `gem` 명령 사용 가능 | -| 녹 | .rs | `rust-analyzer` 명령 가능 | -| sourcekit-lsp | .swift, .objc, .objcpp | `swift` 설치 (MacOS의 `xcode`) | -| svelte | .svelte | Svelte 프로젝트 자동 설치 | -| 지형 | .tf, .tfvars | GitHub 릴리스의 자동 설치 | -| 작문 | .typ, .typc | GitHub 릴리스의 자동 설치 | -| 인가정보 | .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 서버 | 확장자 | 요구사항 | +| ------------------ | ------------------------------------------------------------------ | ----------------------------------------------------- | +| 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, .ct, .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` 설치 (macOS의 `xcode`) | +| svelte | .svelte | Svelte 프로젝트 자동 설치 | +| terraform | .tf, .tfvars | GitHub 릴리스에서 자동 설치 | +| typst | .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 서버 다운로드를 비활성화 할 수 있습니다. @@ -54,18 +54,18 @@ LSP 서버는 위의 파일 확장자 중 하나가 감지되고 요구 사항 --- -## 그것이 작동하는 방법 +## 작동 방식 -opencode가 파일을 열 때, 그것은: +OpenCode가 파일을 열 때, 다음과 같이 작동합니다: -1. 모든 활성화된 LSP 서버에 대한 파일 확장을 확인합니다. -2. 이미 실행되지 않은 경우 적절한 LSP 서버를 시작합니다. +1. 활성화된 모든 LSP 서버에 대해 파일 확장자를 확인합니다. +2. 적절한 LSP 서버가 아직 실행 중이지 않다면 시작합니다. --- ## 구성 -opencode 설정에서 `lsp` 섹션을 통해 LSP 서버를 사용자 정의할 수 있습니다. +OpenCode 설정의 `lsp` 섹션을 통해 LSP 서버를 사용자 정의할 수 있습니다. ```json title="opencode.json" { @@ -76,21 +76,21 @@ opencode 설정에서 `lsp` 섹션을 통해 LSP 서버를 사용자 정의할 각 LSP 서버는 다음을 지원합니다: -| 재산 | 유형 | 묘사 | +| 속성 | 유형 | 설명 | | ---------------- | -------- | --------------------------------------- | -| `disabled` | 불린 | LSP 서버를 비활성화하려면 `true`로 설정 | -| `command` | 문자열[] | LSP 서버를 시작하는 명령 | -| `extensions` | string[] | 이 LSP 서버 확장 | -| `env` | 객체 | 서버 시작시 설정할 환경 변수 | -| `initialization` | 객체 | LSP 서버에 보내는 초기화 옵션 | +| `disabled` | boolean | LSP 서버를 비활성화하려면 `true`로 설정 | +| `command` | string[] | LSP 서버를 시작하는 명령 | +| `extensions` | string[] | 이 LSP 서버의 확장자 | +| `env` | object | 서버 시작 시 설정할 환경 변수 | +| `initialization` | object | LSP 서버에 보내는 초기화 옵션 | -몇 가지 예제를 살펴 보자. +몇 가지 예제를 살펴봅시다. --- ## 환경 변수 -`env` 속성을 사용하여 LSP 서버를 시작할 때 환경 변수를 설정하십시오. +`env` 속성을 사용하여 LSP 서버를 시작할 때 환경 변수를 설정합니다. ```json title="opencode.json" {5-7} { @@ -132,9 +132,9 @@ opencode 설정에서 `lsp` 섹션을 통해 LSP 서버를 사용자 정의할 --- -### LSP 서버를 해제 +### LSP 서버 비활성화 -전 세계적으로 ** 모든** LSP 서버를 비활성화하려면 `lsp`를 `false`로 설정하십시오. +전역적으로 **모든** LSP 서버를 비활성화하려면 `lsp`를 `false`로 설정하십시오. ```json title="opencode.json" {3} { @@ -143,7 +143,7 @@ opencode 설정에서 `lsp` 섹션을 통해 LSP 서버를 사용자 정의할 } ``` -** 특정** LSP 서버를 비활성화하려면 `disabled`를 `true`로 설정하십시오. +**특정** LSP 서버를 비활성화하려면 `disabled`를 `true`로 설정하십시오. ```json title="opencode.json" {5} { @@ -160,7 +160,7 @@ opencode 설정에서 `lsp` 섹션을 통해 LSP 서버를 사용자 정의할 ## 사용자 정의 LSP 서버 -명령 및 파일 확장명을 지정하여 사용자 정의 LSP 서버를 추가할 수 있습니다. +명령어와 파일 확장자를 지정하여 사용자 정의 LSP 서버를 추가할 수 있습니다. ```json title="opencode.json" {4-7} { @@ -178,11 +178,11 @@ opencode 설정에서 `lsp` 섹션을 통해 LSP 서버를 사용자 정의할 ## 추가 정보 -### PHP 인텔 +### PHP Intelephense -PHP를 Intelephense는 라이센스 키를 통해 프리미엄 기능을 제공합니다. 텍스트 파일에서 키 (만)를 배치하여 라이센스 키를 제공 할 수 있습니다. +PHP Intelephense는 라이선스 키를 통해 프리미엄 기능을 제공합니다. 텍스트 파일에 키(만)를 저장하여 라이선스 키를 제공할 수 있습니다. -- macOS/리눅스에서: `$HOME/intelephense/license.txt` -- Windows에서: `%USERPROFILE%/intelephense/license.txt` +- macOS/Linux: `$HOME/intelephense/license.txt` +- Windows: `%USERPROFILE%/intelephense/license.txt` -파일에는 추가 내용이 없습니다. +파일에는 다른 내용이 없어야 합니다. diff --git a/packages/web/src/content/docs/ko/mcp-servers.mdx b/packages/web/src/content/docs/ko/mcp-servers.mdx index d36cd4d22..2d5a8e025 100644 --- a/packages/web/src/content/docs/ko/mcp-servers.mdx +++ b/packages/web/src/content/docs/ko/mcp-servers.mdx @@ -1,6 +1,6 @@ --- -title: MCP servers -description: Add local and remote MCP tools. +title: MCP 서버 +description: 로컬 및 원격 MCP 도구를 추가하세요. --- Model Context Protocol , 또는 MCP를 사용하여 opencode에 외부 도구를 추가할 수 있습니다. opencode는 로컬 및 원격 서버를 모두 지원합니다. @@ -11,7 +11,7 @@ Model Context Protocol , 또는 MCP를 사용하여 opencode에 외부 도구를 #### 주의사항 -MCP 서버를 사용할 때 상황에 추가합니다. 도구가 많이 있으면 신속하게 추가 할 수 있습니다. 그래서 우리는 당신이 사용하는 MCP 서버와 주의를 기울여야 합니다. +MCP 서버를 사용할 때 컨텍스트에 추가됩니다. 도구가 많으면 컨텍스트가 빠르게 채워질 수 있습니다. 그래서 우리는 당신이 사용하는 MCP 서버와 주의를 기울여야 합니다. :::tip MCP 서버는 귀하의 컨텍스트에 추가하므로, 활성화할 수 있는 것을 주의해야 합니다. @@ -21,7 +21,7 @@ GitHub MCP 서버와 같은 특정 MCP 서버는 많은 토큰을 추가하고 --- -## 사용 가능 +## 구성 `mcp`에서 MCP 서버를 정의할 수 있습니다. 각 MCP를 고유 이름으로 추가합니다. LLM을 프롬프트할 때 MCP를 참조할 수 있습니다. @@ -44,7 +44,7 @@ GitHub MCP 서버와 같은 특정 MCP 서버는 많은 토큰을 추가하고 --- -### 원격 디폴트 overriding +### 원격 기본값 재정의 조직은 `.well-known/opencode` 엔드포인트를 통해 기본 MCP 서버를 제공 할 수 있습니다. 이 서버는 기본적으로 비활성화 될 수 있으며 사용자가 필요한 것들에 대해 선택 할 수 있습니다. @@ -67,7 +67,7 @@ GitHub MCP 서버와 같은 특정 MCP 서버는 많은 토큰을 추가하고 --- -## 지역 +## 로컬 MCP 객체 내에서 `type`를 `"local"`로 사용하는 로컬 MCP 서버를 추가하십시오. @@ -116,17 +116,17 @@ use the mcp_everything tool to add the number 3 and 4 로컬 MCP 서버를 구성하는 모든 옵션이 있습니다. -| 옵션 | 유형 | 필수 | 설명 | +| 옵션 | 타입 | 필수 | 설명 | | ------------- | ------- | ---- | ----------------------------------------------------- | | `type` | 문자열 | Y | MCP 서버 연결 유형은 `"local"`. | | `command` | Array | Y | MCP 서버를 실행하는 명령과 인수. | | `environment` | 개체 | | 서버 실행시 설정하는 환경 변수 | -| `enabled` | Boolean | | 시동에서 MCP 서버 사용 가능 | -| `timeout` | Number | | MCP 서버에서 태핑툴을 위한 타임아웃 기본 5000 (5 초). | +| `enabled` | boolean | | 시동에서 MCP 서버 사용 가능 | +| `timeout` | number | | MCP 서버에서 태핑툴을 위한 타임아웃 기본 5000 (5 초). | --- -## 리모트 +## 원격 `type`를 `"remote"`로 설정하여 원격 MCP 서버를 추가하십시오. @@ -152,14 +152,14 @@ use the mcp_everything tool to add the number 3 and 4 #### 옵션 -| 옵션 | 유형 | 필수 | 설명 | +| 옵션 | 타입 | 필수 | 설명 | | --------- | ------- | ---- | ----------------------------------------------------------- | | `type` | 문자열 | Y | MCP 서버 연결 유형은 `"remote"`. | | `url` | 문자열 | Y | 원격 MCP 서버의 URL. | -| `enabled` | Boolean | | 시동에서 MCP 서버 사용 가능 | +| `enabled` | boolean | | 시동에서 MCP 서버 사용 가능 | | `headers` | 개체 | | 헤드러는 요청으로 보내드립니다. | | `oauth` | 개체 | | OAuth 인증 구성 [OAuth](#oauth) 아래의 섹션을 참조하십시오. | -| `timeout` | Number | | MCP 서버에서 태핑툴을 위한 타임아웃 기본 5000 (5 초). | +| `timeout` | number | | MCP 서버에서 태핑툴을 위한 타임아웃 기본 5000 (5 초). | --- @@ -173,7 +173,7 @@ opencode는 원격 MCP 서버에 대한 OAuth 인증을 자동으로 처리합 --- -## 자동 +## 자동 설정 대부분의 OAuth-enabled MCP 서버를 위해, 특별한 구성은 필요하지 않습니다. 원격 서버를 구성: @@ -189,7 +189,7 @@ opencode는 원격 MCP 서버에 대한 OAuth 인증을 자동으로 처리합 } ``` -서버가 인증이 필요한 경우, opencode는 먼저 사용하려고 할 때 인증됩니다. 그렇지 않다면, `opencode mcp auth `를 사용하여 [manually 방아쇠](#authenticating)을 유발할 수 있습니다. +서버가 인증이 필요한 경우, opencode는 먼저 사용하려고 할 때 인증됩니다. 그렇지 않다면, `opencode mcp auth `를 사용하여 [수동으로 트리거](#authenticating)할 수 있습니다. --- @@ -295,9 +295,9 @@ MCP는 opencode의 도구로 사용할 수 있으며 내장 도구와 함께 사 --- -## 글로벌 +## 전역 -이것은 당신이 활성화하거나 전 세계적으로 비활성화 할 수 있다는 것을 의미합니다. +이는 전역적으로 활성화하거나 비활성화할 수 있음을 의미합니다. ```json title="opencode.json" {14} { @@ -318,7 +318,7 @@ MCP는 opencode의 도구로 사용할 수 있으며 내장 도구와 함께 사 } ``` -우리는 또한 모든 일치 MCPs를 비활성화하는 glob 패턴을 사용할 수 있습니다. +또한 glob 패턴을 사용하여 일치하는 모든 MCP를 비활성화할 수 있습니다. ```json title="opencode.json" {14} { @@ -343,9 +343,9 @@ MCP는 opencode의 도구로 사용할 수 있으며 내장 도구와 함께 사 --- -## 에이전트 당 +## 에이전트별 -MCP 서버의 많은 수를 가지고 있다면 에이전트 당만 활성화하고 전 세계적으로 비활성화 할 수 있습니다. 이 작업을 수행: +많은 MCP 서버가 있다면 전역적으로는 비활성화하고 에이전트별로만 활성화할 수 있습니다. 이 작업을 수행: 1. 글로벌 도구로 사용 가능. 2. [agent config](/docs/agents#tools)에서 MCP 서버를 도구로 사용할 수 있습니다. @@ -375,7 +375,7 @@ MCP 서버의 많은 수를 가지고 있다면 에이전트 당만 활성화하 --- -### 글로브 패턴 +### Glob 패턴 glob 패턴은 간단한 regex globbing 패턴을 사용합니다 : diff --git a/packages/web/src/content/docs/ko/models.mdx b/packages/web/src/content/docs/ko/models.mdx index 7395421a6..2eeaa1ef5 100644 --- a/packages/web/src/content/docs/ko/models.mdx +++ b/packages/web/src/content/docs/ko/models.mdx @@ -1,6 +1,6 @@ --- -title: Models -description: Configuring an LLM provider and model. +title: 모델 +description: LLM 공급자 및 모델 구성. --- opencode는 [AI SDK](https://ai-sdk.dev/) 및 [Models.dev](https://models.dev)를 사용하여 **75+ LLM 제공 업체**를 지원하며 로컬 모델을 실행합니다. @@ -9,7 +9,7 @@ opencode는 [AI SDK](https://ai-sdk.dev/) 및 [Models.dev](https://models.dev) ## 공급자 -가장 인기 있는 공급자는 기본적으로 preloaded. `/connect` 명령을 통해 공급자를위한 자격 증명을 추가하면 opencode를 시작할 때 사용할 수 있습니다. +가장 인기 있는 공급자는 기본적으로 미리 로드되어 있습니다. `/connect` 명령을 통해 공급자를위한 자격 증명을 추가하면 opencode를 시작할 때 사용할 수 있습니다. 자세히 알아보기 [providers](/docs/providers). @@ -27,22 +27,22 @@ opencode는 [AI SDK](https://ai-sdk.dev/) 및 [Models.dev](https://models.dev) ## 추천 모델 -거기에 많은 모델이 있습니다, 새로운 모델이 매주 온다. +수많은 모델이 있으며, 매주 새로운 모델이 출시됩니다. :::tip 우리가 추천하는 모델 중 하나를 사용하여 고려하십시오. ::: -그러나 코드와 도구 호출 모두에서 좋은 그들 중 몇 가지가있다. +하지만 코드 작성과 도구 호출 모두에서 뛰어난 성능을 보이는 모델들이 있습니다. -다음은 opencode와 잘 작동하는 몇 가지 모델입니다. 특히 주문이 없습니다. (이것은 철저한 목록이 아니며 반드시 날짜까지입니다) : +특별한 순서는 없습니다. (이 목록은 전체 목록이 아니며 최신 상태가 아닐 수 있습니다): -- GPT의 5.2 -- GPT 5.1 코덱 -- 클로드 오푸스 4.5 -- 클로드 Sonnet 4.5 -- 소형 M2.1 -- Gemini 3 프로 +- GPT 5.2 +- GPT 5.1 Codex +- Claude Opus 4.5 +- Claude Sonnet 4.5 +- M2.1 +- Gemini 3 Pro --- @@ -100,7 +100,7 @@ config를 통해 모델의 옵션을 구성할 수 있습니다. } ``` -여기에 우리는 두 개의 내장 모델에 대한 글로벌 설정을 구성 : `gpt-5`를 통해 액세스 할 때 `openai` 공급자 및 `claude-sonnet-4-20250514`는 `anthropic` 공급자를 통해 액세스 할 때. +여기서는 두 개의 내장 모델에 대한 전역 설정을 구성합니다: `gpt-5`를 통해 액세스 할 때 `openai` 공급자 및 `claude-sonnet-4-20250514`는 `anthropic` 공급자를 통해 액세스 할 때. 내장 공급자 및 모델 이름은 [Models.dev](https://models.dev)에서 찾을 수 있습니다. 사용중인 에이전트에 이러한 옵션을 구성할 수 있습니다. 에이전트 구성은 여기에 모든 글로벌 옵션을 overrides. [더 알아보기](/docs/agents/#additional). @@ -135,9 +135,9 @@ config를 통해 모델의 옵션을 구성할 수 있습니다. --- -## 참배 +## 변형 -다른 구성을 가진 많은 모형 지원 다수 변종. opencode는 인기있는 공급자를위한 기본 변형으로 배송됩니다. +많은 모델이 다양한 구성의 변형(variant)을 지원합니다. opencode는 인기있는 공급자를위한 기본 변형으로 배송됩니다. ## 내장 변형 @@ -145,15 +145,15 @@ opencode는 많은 공급자를 위한 기본 변종으로 발송합니다: **Anthropic**: -- `high` - 높은 생각 예산 (기본) +- `high` - 높은 생각(Thinking) 예산 (기본) - `max` - 최대 생각 예산 ** OpenAI **: 모델에 따라 다릅니다. -- `none` - 이유 없음 -- `minimal` - 미니멀 이유 노력 +- `none` - 추론(Reasoning) 없음 +- `minimal` - 최소 추론 노력 - `low` - 낮은 이유 노력 - `medium` - 중간 이유 노력 - `high` - 높은 이유 노력 @@ -195,13 +195,13 @@ opencode는 많은 공급자를 위한 기본 변종으로 발송합니다: } ``` -## 사이클 변형 +## 변형 순환 keybind `variant_cycle`를 사용하여 변형 사이 신속하게 전환합니다. [더 알아보기](/docs/keybinds). --- -## 로딩 모델 +## 모델 로딩 순서 opencode가 시작될 때, 다음의 우선순위 순서에 있는 모형을 검사합니다: diff --git a/packages/web/src/content/docs/ko/modes.mdx b/packages/web/src/content/docs/ko/modes.mdx index fd36fcf0b..4daa41000 100644 --- a/packages/web/src/content/docs/ko/modes.mdx +++ b/packages/web/src/content/docs/ko/modes.mdx @@ -1,11 +1,11 @@ --- -title: Modes -description: Different modes for different use cases. +title: 모드 +description: 다양한 사용 사례를 위한 다양한 모드. --- :::caution 모드는 opencode 설정에서 `agent` 옵션을 통해 구성되어 있습니다. 더 보기 -`mode` 옵션이 이제 비활성화되었습니다. [더 알아보기](/docs/시약). +`mode` 옵션이 이제 비활성화되었습니다. [더 알아보기](/docs/agents). ::: opencode의 모드는 다른 사용 사례에 대한 행동, 도구 및 프롬프트를 사용자 정의 할 수 있습니다. @@ -116,7 +116,7 @@ Markdown 파일 이름은 모드 이름 (예 : `review.md`는 `review` 모드를 --- -### 모형 +### 모델 `model` config를 사용하여 이 모드의 기본 모델을 무시합니다. 다른 작업에 최적화 된 다른 모델을 사용하는 데 유용합니다. 예를 들어, 계획을위한 빠른 모델, 구현을위한 더 많은 모델. @@ -152,7 +152,7 @@ Markdown 파일 이름은 모드 이름 (예 : `review.md`는 `review` 모드를 온도 값은 일반적으로 0.0에서 1.0에 배열합니다: - **0.0-0.2**: 매우 집중하고 신중한 응답, 코드 분석 및 계획에 이상 -**0.3-0.5**: 일부 창의력과 균형 잡힌 응답, 일반 개발 작업에 좋은 -- **0.6-1.0**: 더 창조적이고 다양한 응답, 뇌하수 및 탐험에 유용한 +- **0.6-1.0**: 더 창조적이고 다양한 응답, 브레인스토밍 및 탐험에 유용한 ```json title="opencode.json" { @@ -220,23 +220,23 @@ Markdown 파일 이름은 모드 이름 (예 : `review.md`는 `review` 모드를 --- -### 유효한 공구 +### 유효한 도구 여기에 모든 도구는 모드 구성을 통해 제어 할 수 있습니다. -| 도구 | 설명 | -| ----------- | ------------------ | -| `bash` | shell 명령 실행 | -| `edit` | 기존 파일 수정 | -| `write` | 새 파일 만들기 | -| `read` | 읽는 파일 내용 | -| `grep` | 파일 검색 | -| `glob` | 패턴으로 찾기 | -| `list` | 디렉토리 내용 보기 | -| `patch` | 파일에 패치 적용 | -| `todowrite` | 도도 목록 관리 | -| `todoread` | 읽는 도 목록 | -| `webfetch` | 사이트 맵 | +| 도구 | 설명 | +| ----------- | --------------------- | +| `bash` | shell 명령 실행 | +| `edit` | 기존 파일 수정 | +| `write` | 새 파일 만들기 | +| `read` | 읽는 파일 내용 | +| `grep` | 파일 검색 | +| `glob` | 패턴으로 찾기 | +| `list` | 디렉토리 내용 보기 | +| `patch` | 파일에 패치 적용 | +| `todowrite` | 할 일(Todo) 목록 관리 | +| `todoread` | 할 일(Todo) 목록 읽기 | +| `webfetch` | 웹사이트 가져오기 | --- @@ -321,9 +321,9 @@ Priorities: 다음은 다른 모드에 대한 일반적인 사용 사례입니다. -- **빌딩 모드**: 모든 도구와 함께 전체 개발 작업 -- **플랜 모드**: 변화없이 분석 및 계획 -**Review 모드**: Code review with read-only access plus 문서 도구 -- ** 디버그 모드**: bash 및 읽기 도구와 함께 조사에 집중 +- **Build 모드**: 모든 도구와 함께 전체 개발 작업 +- **Plan 모드**: 변화없이 분석 및 계획 -**Review 모드**: Code review with read-only access plus 문서 도구 +- **Debug 모드**: bash 및 읽기 도구와 함께 조사에 집중 - **Docs 모드**: 파일 작업과 문서 작성하지만 시스템 명령 없음 다른 모델을 찾을 수 있습니다 다른 사용 케이스에 대 한 좋은. diff --git a/packages/web/src/content/docs/ko/network.mdx b/packages/web/src/content/docs/ko/network.mdx index b2a0f8236..ee3cbfa25 100644 --- a/packages/web/src/content/docs/ko/network.mdx +++ b/packages/web/src/content/docs/ko/network.mdx @@ -1,6 +1,6 @@ --- -title: Network -description: Configure proxies and custom certificates. +title: 네트워크 +description: 프록시 및 사용자 정의 인증서 구성. --- opencode는 엔터프라이즈 네트워크 환경을 위한 표준 프록시 환경 변수 및 사용자 지정 인증서를 지원합니다. diff --git a/packages/web/src/content/docs/ko/permissions.mdx b/packages/web/src/content/docs/ko/permissions.mdx index 4dad997ab..ac698b7cf 100644 --- a/packages/web/src/content/docs/ko/permissions.mdx +++ b/packages/web/src/content/docs/ko/permissions.mdx @@ -1,6 +1,6 @@ --- -title: Permissions -description: Control which actions require approval to run. +title: 권한 +description: 실행 승인이 필요한 작업을 제어합니다. --- opencode는 주어진 동작이 자동으로 실행되는지 결정하기 위해 `permission` config를 사용하거나 차단합니다. @@ -9,7 +9,7 @@ opencode는 주어진 동작이 자동으로 실행되는지 결정하기 위해 --- -## 활동 +## 동작 각 권한 규칙은 다음과 같습니다: @@ -45,7 +45,7 @@ opencode는 주어진 동작이 자동으로 실행되는지 결정하기 위해 --- -## 과립 규칙 (Object Syntax) +## 세부 규칙 (객체 구문) 대부분의 권한을 위해 도구 입력을 기반으로 다른 작업을 적용 할 수 있습니다. @@ -86,7 +86,7 @@ Permission 본 사용 간단한 wildcard 일치: - `$HOME/projects/*` -> `/Users/username/projects/*` - `~` -> `/Users/username` -## 외부 감독 +## 외부 디렉터리 `external_directory`를 사용하여 도구가 opencode가 시작된 작업 디렉토리 밖에 터치 경로가 호출되도록합니다. 이것은 입력 (예 : `read`, `edit`, `list`, `glob`, `glob`, `grep` 및 많은 `bash` 명령)로 경로를 수행하는 모든 도구에 적용됩니다. @@ -135,7 +135,7 @@ opencode 권한은 도구 이름에 의해 키 입력되며, 두 개의 안전 - `grep` - 콘텐츠 검색 ( regex 패턴 매칭) - `list` - 디렉토리의 목록 파일 (폴더 경로 매칭) - `bash` - shell 명령 실행 (`git status --porcelain`와 같은 팟 명령) -- `task` - 시약 출시 (미시 시약 유형) +- `task` - 에이전트 실행 (작업 에이전트 유형) - `skill` - 기술을 로딩 (기술 이름을 매칭) - `lsp` - LSP 쿼리 실행 (현재 비 과립) - `todoread`, `todowrite` - 토도 목록의 읽기 / 업데이트 @@ -146,7 +146,7 @@ opencode 권한은 도구 이름에 의해 키 입력되며, 두 개의 안전 --- -## 기본 +## 기본값 아무것도 지정하지 않는 경우, opencode는 permissive 기본값에서 시작합니다. @@ -169,7 +169,7 @@ opencode 권한은 도구 이름에 의해 키 입력되며, 두 개의 안전 --- -## "Ask"는 무엇입니까? +## "Ask"란 무엇입니까? opencode가 승인되면 UI는 세 가지 결과를 제공합니다. diff --git a/packages/web/src/content/docs/ko/plugins.mdx b/packages/web/src/content/docs/ko/plugins.mdx index 6a90c5504..9a2995df8 100644 --- a/packages/web/src/content/docs/ko/plugins.mdx +++ b/packages/web/src/content/docs/ko/plugins.mdx @@ -1,6 +1,6 @@ --- -title: Plugins -description: Write your own plugins to extend opencode. +title: 플러그인 +description: OpenCode를 확장하기 위해 자신만의 플러그인을 작성하세요. --- 플러그인은 다양한 이벤트와 사용자 정의 행동으로 후킹하여 opencode를 확장 할 수 있습니다. 플러그인을 만들 수 있습니다 새로운 기능을 추가, 외부 서비스와 통합, 또는 opencode의 기본 동작을 수정. @@ -15,7 +15,7 @@ description: Write your own plugins to extend opencode. --- -## 현지 파일에서 +## 로컬 파일에서 플러그인 디렉토리에 JavaScript 또는 TypeScript 파일을 배치합니다. @@ -26,7 +26,7 @@ description: Write your own plugins to extend opencode. --- -### 부터 npm +### npm에서 config 파일에 npm 패키지를 지정합니다. @@ -45,22 +45,22 @@ config 파일에 npm 패키지를 지정합니다. ## 플러그인이 설치되는 방법 -**npm 플러그인**는 시작시 Bun을 사용하여 자동으로 설치됩니다. 패키지와 그들의 의존성은 `~/.cache/opencode/node_modules/`에서 캐시됩니다. +**npm 플러그인**은 시작시 Bun을 사용하여 자동으로 설치됩니다. 패키지와 그들의 의존성은 `~/.cache/opencode/node_modules/`에서 캐시됩니다. -**Local 플러그인 ** 플러그인 디렉토리에서 직접로드됩니다. 외부 패키지를 사용하려면 구성 디렉토리 내 `package.json`를 작성해야 합니다 ([Dependencies](#dependencies)), 또는 플러그인을 npm에 게시하고 [config에 추가](/docs/config#plugins). +**로컬 플러그인**은 플러그인 디렉토리에서 직접로드됩니다. 외부 패키지를 사용하려면 구성 디렉토리 내 `package.json`를 작성해야 합니다 ([Dependencies](#dependencies)), 또는 플러그인을 npm에 게시하고 [config에 추가](/docs/config#plugins). --- -## 짐 순서 +## 로드 순서 -플러그인은 모든 소스에서로드되며 모든 후크는 순서대로 실행됩니다. 짐 순서는: +플러그인은 모든 소스에서로드되며 모든 후크는 순서대로 실행됩니다. 로드 순서는 다음과 같습니다: 1. 글로벌 구성 (`~/.config/opencode/opencode.json`) 2. 프로젝트 구성 (`opencode.json`) 3. 글로벌 플러그인 디렉토리 (`~/.config/opencode/plugins/`) 4. 프로젝트 플러그인 디렉토리 (`.opencode/plugins/`) -동일한 이름과 버전을 가진 중복 npm 포장은 한 번 적재됩니다. 하지만, 로컬 플러그인과 같은 이름과 npm 플러그인은 모두 별도로로드됩니다. +중복 npm 패키지는 한 번만 로드됩니다. 하지만, 로컬 플러그인과 같은 이름과 npm 플러그인은 모두 별도로로드됩니다. --- @@ -71,7 +71,7 @@ config 파일에 npm 패키지를 지정합니다. --- -### 종점 +### 의존성 로컬 플러그인 및 사용자 정의 도구는 외부 npm 패키지를 사용할 수 있습니다. `package.json`를 config 디렉토리에 추가하면 필요한 의존도가 있습니다. @@ -192,7 +192,7 @@ export const MyPlugin: Plugin = async ({ project, client, $, directory, worktree - `todo.updated` -#### Shell 이벤트 +#### 셸 이벤트 - `shell.env` @@ -331,7 +331,7 @@ export const MyPlugin = async ({ client }) => { --- -## Compaction 걸이 +## Compaction 훅 세션이 압축 될 때 포함 된 컨텍스트를 사용자 지정: @@ -355,7 +355,7 @@ Include any state that should persist across compaction: } ``` -LLM의 앞에 `experimental.session.compacting` 걸이 불은 오염 요약을 생성합니다. 기본 압축 프롬프트가 놓을 수 있도록 도메인 별 컨텍스트를 주입합니다. +LLM이 압축 요약을 생성하기 전에 `experimental.session.compacting` 훅이 실행됩니다. 기본 압축 프롬프트를 대체할 수 있도록 도메인 별 컨텍스트를 주입합니다. 당신은 또한 `output.prompt`를 조정해서 조밀함을 전적으로 대체할 수 있습니다: diff --git a/packages/web/src/content/docs/ko/providers.mdx b/packages/web/src/content/docs/ko/providers.mdx index e02928fdd..488c02537 100644 --- a/packages/web/src/content/docs/ko/providers.mdx +++ b/packages/web/src/content/docs/ko/providers.mdx @@ -1,37 +1,36 @@ --- -title: Providers -description: Using any LLM provider in opencode. +title: 공급자 +description: OpenCode에서 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 제공 업체**를 지원하며 로컬 모델을 실행합니다. +OpenCode는 [AI SDK](https://ai-sdk.dev/) 및 [Models.dev](https://models.dev)를 사용하여 **75개 이상의 LLM 공급자**를 지원하며 로컬 모델도 실행할 수 있습니다. 필요한 공급자를 추가하려면: -1. `/connect` 명령을 사용하여 공급자를 위한 API 열쇠를 추가하십시오. -2. opencode config에 있는 공급자를 구성하십시오. +1. `/connect` 명령을 사용하여 공급자의 API 키를 추가하십시오. +2. OpenCode 구성에서 공급자를 구성하십시오. --- -### 등급 +### 자격 증명 -공급자의 API 키를 `/connect` 명령으로 추가하면 저장됩니다. -`~/.local/share/opencode/auth.json`에서. +`/connect` 명령으로 공급자의 API 키를 추가하면 다음 위치에 저장됩니다: +`~/.local/share/opencode/auth.json` --- -#### 콘피그 +#### 구성 -opencode의 `provider` 섹션을 통해 공급자를 사용자 정의 할 수 있습니다. -설정. +OpenCode 설정의 `provider` 섹션을 통해 공급자를 사용자 정의할 수 있습니다. --- ### 기본 URL -`baseURL` 옵션을 설정하여 모든 공급자를위한 기본 URL을 사용자 정의 할 수 있습니다. 프록시 서비스 또는 사용자 정의 엔드포인트를 사용할 때 유용합니다. +`baseURL` 옵션을 설정하여 모든 공급자를 위한 기본 URL을 사용자 정의할 수 있습니다. 프록시 서비스 또는 사용자 정의 엔드포인트를 사용할 때 유용합니다. ```json title="opencode.json" {6} { @@ -48,24 +47,23 @@ opencode의 `provider` 섹션을 통해 공급자를 사용자 정의 할 수 --- -## opencode 젠 +## OpenCode Zen -OpenCode Zen은 opencode 팀이 제공하는 모델 목록입니다. -opencode와 잘 작동하도록 테스트 및 검증. [더 알아보기](/docs/zen). +OpenCode Zen은 OpenCode 팀이 OpenCode와 잘 작동하도록 테스트하고 검증한 모델 목록입니다. [더 알아보기](/docs/zen). :::tip -새로운 경우, OpenCode Zen로 시작하는 것이 좋습니다. +처음이라면 OpenCode Zen으로 시작하는 것이 좋습니다. ::: -1. TUI에서 `/connect` 명령을 실행하고, opencode를 선택하고, [opencode.ai/auth](https://opencode.ai/auth)에 머리를 선택합니다. +1. TUI에서 `/connect` 명령을 실행하고 `opencode`를 선택한 뒤, [opencode.ai/auth](https://opencode.ai/auth)로 이동합니다. ```txt /connect ``` -2. 로그인, 청구 세부 정보를 추가하고 API 키를 복사하십시오. +2. 로그인하고 결제 정보를 입력한 후 API 키를 복사하십시오. -3. API 키를 붙여. +3. API 키를 붙여넣습니다. ```txt ┌ API key @@ -74,30 +72,29 @@ opencode와 잘 작동하도록 테스트 및 검증. [더 알아보기](/docs/z └ enter ``` -4. TUI의 `/models`를 실행하여 우리가 추천하는 모델 목록을 볼 수 있습니다. +4. TUI에서 `/models`를 실행하여 추천 모델 목록을 볼 수 있습니다. ```txt /models ``` -opencode의 다른 공급자와 같이 작동하고 사용하기에 완전히 선택적입니다. +OpenCode의 다른 공급자처럼 작동하며 사용은 완전히 선택 사항입니다. --- ## 디렉토리 -세부사항에 있는 공급자의 몇몇을 보십시오. 공급자를 추가하려는 경우 -목록, PR을 무료로 엽니 다. +공급자 세부 정보를 확인하세요. 목록에 공급자를 추가하려면 PR을 열어주세요. :::note -여기에서 공급자를 볼 수 없습니다? PR 제출 +원하는 공급자가 없나요? PR을 제출해 주세요. ::: --- ### 302.AI -1. [302.AI 콘솔](https://302.ai/)에 머리, 계정을 만들고 API 키를 생성합니다. +1. [302.AI 콘솔](https://302.ai/)로 이동하여 계정을 만들고 API 키를 생성합니다. 2. `/connect` 명령을 실행하고 **302.AI**를 검색하십시오. @@ -122,22 +119,21 @@ opencode의 다른 공급자와 같이 작동하고 사용하기에 완전히 --- -### 아마존 베드록 +### Amazon Bedrock -opencode로 Amazon Bedrock을 사용하려면: +OpenCode로 Amazon Bedrock을 사용하려면: -1. Amazon Bedrock 콘솔 및 요청에서 ** 모델 카탈로그**에 머리 - 원하는 모델에 액세스. +1. Amazon Bedrock 콘솔의 **Model catalog**로 이동하여 원하는 모델에 대한 액세스를 요청합니다. :::tip - Amazon Bedrock에서 원하는 모델에 액세스해야합니다. + Amazon Bedrock에서 원하는 모델에 대한 액세스 권한이 있어야 합니다. ::: -2. ** 설정** 다음 방법 중 하나를 사용하여: +2. 다음 방법 중 하나를 사용하여 **설정**합니다: ### 환경 변수 (빠른 시작) -opencode를 실행하는 동안 이러한 환경 변수 중 하나를 설정: +OpenCode를 실행하는 동안 다음 환경 변수 중 하나를 설정합니다: ```bash # Option 1: Using AWS access keys @@ -150,16 +146,16 @@ opencode를 실행하는 동안 이러한 환경 변수 중 하나를 설정: AWS_BEARER_TOKEN_BEDROCK=XXX opencode ``` -또는 bash 프로필에 추가: +또는 bash 프로필에 추가합니다: ```bash title="~/.bash_profile" export AWS_PROFILE=my-dev-profile export AWS_REGION=us-east-1 ``` -#### 설정 파일 (추천) +#### 설정 파일 (권장) -프로젝트 별 또는 지속적 구성의 경우 `opencode.json`를 사용하십시오. +프로젝트별 또는 영구 구성을 위해 `opencode.json`을 사용하십시오. ```json title="opencode.json" { @@ -175,14 +171,14 @@ opencode를 실행하는 동안 이러한 환경 변수 중 하나를 설정: } ``` -** 유효한 옵션:** +**유효한 옵션:** -- `region` - AWS 지역 (예: `us-east-1`, `eu-west-1`) -- `profile` - AWS는 `~/.aws/credentials`에서 단면도를 지명했습니다 -- `endpoint` - VPC 엔드 포인트에 대한 사용자 정의 엔드 포인트 URL (일반 `baseURL` 옵션 별) +- `region` - AWS 리전 (예: `us-east-1`, `eu-west-1`) +- `profile` - `~/.aws/credentials`의 AWS 프로필 이름 +- `endpoint` - VPC 엔드포인트 등을 위한 사용자 정의 엔드포인트 URL (일반 `baseURL` 옵션의 별칭) :::tip - 구성 파일 옵션은 환경 변수에 대한 precedence를 가져옵니다. + 구성 파일 옵션은 환경 변수보다 우선 순위가 높습니다. ::: #### 고급: VPC 엔드포인트 @@ -205,36 +201,35 @@ Bedrock의 VPC 엔드포인트를 사용하는 경우: ``` :::note -`endpoint` 옵션은 일반적인 `baseURL` 옵션의 별칭입니다. `endpoint`와 `baseURL` 둘 다 지정되는 경우에, `endpoint`는 전진합니다. +`endpoint` 옵션은 일반적인 `baseURL` 옵션의 별칭입니다. `endpoint`와 `baseURL` 둘 다 지정된 경우 `endpoint`가 우선합니다. ::: #### 인증 방법 --**`AWS_ACCESS_KEY_ID`/`AWS_SECRET_ACCESS_KEY`**: IAM 사용자 생성 및 AWS 콘솔에서 액세스 키를 생성 +- **`AWS_ACCESS_KEY_ID`/`AWS_SECRET_ACCESS_KEY`**: IAM 사용자 및 AWS 콘솔에서 액세스 키 생성 +- **`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 역할) 또는 다른 Kubernetes 환경의 OIDC 연동. 이 환경 변수는 서비스 계정을 사용할 때 Kubernetes에 의해 자동으로 주입됩니다. -- **`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 federation과 다른 쿠버네티스 환경. 이 환경 변수는 서비스 계정 할당을 사용할 때 쿠버네티스에 의해 자동으로 주사됩니다. - -#### 인증 +#### 인증 우선 순위 Amazon Bedrock은 다음과 같은 인증 우선 순위를 사용합니다. -1. ** 브라우저 토큰 ** - `AWS_BEARER_TOKEN_BEDROCK` 환경 변수 또는 `/connect` 명령에서 토큰 -2. **AWS Credential Chain ** - 프로필, 액세스 키, 공유 자격 증명, IAM 역할, 웹 ID 토큰 (EKS IRSA), 인스턴스 메타 데이터 +1. **Bearer Token** - `AWS_BEARER_TOKEN_BEDROCK` 환경 변수 또는 `/connect` 명령의 토큰 +2. **AWS Credential Chain** - 프로필, 액세스 키, 공유 자격 증명, IAM 역할, 웹 ID 토큰 (EKS IRSA), 인스턴스 메타데이터 :::note - Bearer 토큰을 설정할 때 (`/connect` 또는 `AWS_BEARER_TOKEN_BEDROCK`를 통해), 구성 된 프로파일을 포함한 모든 AWS 자격 방법을 통해 우선 순위가됩니다. + Bearer 토큰을 설정할 때 (`/connect` 또는 `AWS_BEARER_TOKEN_BEDROCK`를 통해), 구성된 프로필을 포함한 모든 AWS 자격 증명 방법보다 우선 순위가 높습니다. ::: -3. 당신이 원하는 모형을 선정하기 위하여 `/models` 명령을 실행하십시오. +3. `/models` 명령을 실행하여 원하는 모델을 선택하십시오. ```txt /models ``` :::note -custom inference profiles를 위해, 열쇠에 있는 모형 그리고 공급자 이름을 사용하고 arn에 `id` 재산을 놓습니다. 이것은 정확한 캐싱을 지킵니다: +사용자 정의 추론 프로필(custom inference profiles)의 경우, 키에 모델과 공급자 이름을 사용하고 `id` 속성에 ARN을 설정하십시오. 이렇게 하면 올바른 캐싱이 보장됩니다: ```json title="opencode.json" { @@ -256,16 +251,15 @@ custom inference profiles를 위해, 열쇠에 있는 모형 그리고 공급자 --- -#### 안토픽 +#### Anthropic -1. 가입하면 `/connect` 명령을 실행하고 Anthropic을 선택합니다. +1. 가입 후 `/connect` 명령을 실행하고 **Anthropic**을 선택합니다. ```txt /connect ``` -2. **Claude Pro/Max** 옵션을 선택하고 브라우저를 열 수 있습니다. - 자주 묻는 질문 +2. **Claude Pro/Max** 옵션을 선택하면 브라우저가 열립니다. ```txt ┌ Select auth method @@ -276,39 +270,38 @@ custom inference profiles를 위해, 열쇠에 있는 모형 그리고 공급자 └ ``` -3. 이제 모든 Anthropic 모델은 `/models` 명령을 사용할 때 사용할 수 있어야합니다. +3. 이제 `/models` 명령을 사용할 때 모든 Anthropic 모델을 사용할 수 있습니다. ```txt /models ``` :::info -opencode의 Claude Pro/Max 구독을 사용하여 [Anthropic](https://anthropic.com)에서 공식적으로 지원되지 않습니다. +OpenCode에서 Claude Pro/Max 구독을 사용하는 것은 [Anthropic](https://anthropic.com)에서 공식적으로 지원하지 않습니다. ::: ##### API 키 사용 -Pro/Max 구독이 없는 경우 **Create an API Key**를 선택할 수 있습니다. 브라우저를 열고 Anthropic에 로그인하고 terminal에서 붙여넣을 수있는 코드를 제공합니다. +Pro/Max 구독이 없는 경우 **Create an API Key**를 선택할 수 있습니다. 브라우저가 열리고 Anthropic에 로그인한 후 터미널에 붙여넣을 수 있는 코드를 제공합니다. -또는 이미 API 키가 있다면, ** 수동으로 API Key**를 입력하고 terminal에서 붙여넣을 수 있습니다. +또는 이미 API 키가 있다면, **Manually enter API Key**를 선택하고 터미널에 붙여넣을 수 있습니다. --- ### Azure OpenAI :::note -"나는 미안 해요, 하지만 나는 그 요청을 지원할 수 없습니다" 오류, 에서 콘텐츠 필터를 변경 시도 **DefaultV2**에서 **Default**로 당신의 Azure 자원에. +"I'm sorry, but I can't support 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 포털](https://portal.azure.com/)로 이동하여 **Azure OpenAI** 리소스를 만듭니다. 다음이 필요합니다: + - **리소스 이름**: API 엔드포인트의 일부가 됩니다 (`https://RESOURCE_NAME.openai.azure.com/`) + - **API 키**: 리소스의 `KEY 1` 또는 `KEY 2` 2. [Azure AI Foundry](https://ai.azure.com/)로 이동하여 모델을 배포합니다. :::note - 배포 이름은 제대로 작동하려면 opencode의 모델 이름을 일치해야합니다. + 배포 이름은 제대로 작동하려면 OpenCode의 모델 이름과 일치해야 합니다. ::: 3. `/connect` 명령을 실행하고 **Azure**를 검색하십시오. @@ -326,19 +319,19 @@ Pro/Max 구독이 없는 경우 **Create an API Key**를 선택할 수 있습니 └ enter ``` -5. 환경 변수로 리소스 이름을 설정: +5. 리소스 이름을 환경 변수로 설정: ```bash AZURE_RESOURCE_NAME=XXX opencode ``` -또는 bash 프로파일에 추가: + 또는 bash 프로필에 추가: -```bash title="~/.bash_profile" + ```bash title="~/.bash_profile" export AZURE_RESOURCE_NAME=XXX -``` + ``` -6. `/models` 명령을 실행하여 배포 된 모델을 선택하십시오. +6. `/models` 명령을 실행하여 배포된 모델을 선택하십시오. ```txt /models @@ -346,17 +339,16 @@ Pro/Max 구독이 없는 경우 **Create an API Key**를 선택할 수 있습니 --- -### Azure Cognitive 서비스 +### 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 포털](https://portal.azure.com/)로 이동하여 **Azure OpenAI** 리소스를 만듭니다. 다음이 필요합니다: + - **리소스 이름**: API 엔드포인트의 일부가 됩니다 (`https://AZURE_COGNITIVE_SERVICES_RESOURCE_NAME.cognitiveservices.azure.com/`) + - **API 키**: 리소스의 `KEY 1` 또는 `KEY 2` 2. [Azure AI Foundry](https://ai.azure.com/)로 이동하여 모델을 배포합니다. :::note - 배포 이름은 제대로 작동하려면 opencode의 모델 이름을 일치해야합니다. + 배포 이름은 제대로 작동하려면 OpenCode의 모델 이름과 일치해야 합니다. ::: 3. `/connect` 명령을 실행하고 **Azure Cognitive Services**를 검색하십시오. @@ -374,19 +366,19 @@ Pro/Max 구독이 없는 경우 **Create an API Key**를 선택할 수 있습니 └ enter ``` -5. 환경 변수로 리소스 이름을 설정: +5. 리소스 이름을 환경 변수로 설정: ```bash AZURE_COGNITIVE_SERVICES_RESOURCE_NAME=XXX opencode ``` -또는 bash 프로파일에 추가: + 또는 bash 프로필에 추가: -```bash title="~/.bash_profile" + ```bash title="~/.bash_profile" export AZURE_COGNITIVE_SERVICES_RESOURCE_NAME=XXX -``` + ``` -6. `/models` 명령을 실행하여 배포 된 모델을 선택하십시오. +6. `/models` 명령을 실행하여 배포된 모델을 선택하십시오. ```txt /models @@ -394,11 +386,11 @@ Pro/Max 구독이 없는 경우 **Create an API Key**를 선택할 수 있습니 --- -#### 기본 +#### Baseten -1. [Baseten](https://app.baseten.co/)에 머리는, 계정을 만들고, API 열쇠를 생성합니다. +1. [Baseten](https://app.baseten.co/)으로 이동하여 계정을 만들고 API 키를 생성합니다. -2. `/connect` 명령을 실행하고 **Baseten**를 검색하십시오. +2. `/connect` 명령을 실행하고 **Baseten**을 검색하십시오. ```txt /connect @@ -421,9 +413,9 @@ Pro/Max 구독이 없는 경우 **Create an API Key**를 선택할 수 있습니 --- -#### Cerebras의 +#### Cerebras -1. [Cerebras 콘솔](https://inference.cerebras.ai/)에 머리, 계정을 만들고 API 키를 생성합니다. +1. [Cerebras 콘솔](https://inference.cerebras.ai/)로 이동하여 계정을 만들고 API 키를 생성합니다. 2. `/connect` 명령을 실행하고 **Cerebras**를 검색하십시오. @@ -440,7 +432,7 @@ Pro/Max 구독이 없는 경우 **Create an API Key**를 선택할 수 있습니 └ enter ``` -4. `/models` 명령을 실행하여 같은 모델을 선택하십시오 Qwen 3 Coder 480B . +4. `/models` 명령을 실행하여 모델(예: Qwen 3 Coder 480B)을 선택하십시오. ```txt /models @@ -448,11 +440,11 @@ Pro/Max 구독이 없는 경우 **Create an API Key**를 선택할 수 있습니 --- -## Cloudflare AI 게이트웨이 +## Cloudflare AI Gateway -Cloudflare AI 게이트웨이는 OpenAI, Anthropic, Workers AI 등의 모델에 액세스할 수 있으며, 통합된 엔드포인트를 통해 더 많은 기능을 제공합니다. [Unified Billing](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 대시보드](https://dash.cloudflare.com/)로 이동하여, **AI** > **AI Gateway**로 가서 새로운 게이트웨이를 만듭니다. 2. 계정 ID 및 Gateway ID를 환경 변수로 설정하십시오. @@ -461,7 +453,7 @@ Cloudflare AI 게이트웨이는 OpenAI, Anthropic, Workers AI 등의 모델에 export CLOUDFLARE_GATEWAY_ID=your-gateway-id ``` -3. `/connect` 명령을 실행하고 ** Cloudflare AI Gateway**를 검색하십시오. +3. `/connect` 명령을 실행하고 **Cloudflare AI Gateway**를 검색하십시오. ```txt /connect @@ -476,11 +468,11 @@ Cloudflare AI 게이트웨이는 OpenAI, Anthropic, Workers AI 등의 모델에 └ enter ``` -또는 환경 변수로 설정한다. + 또는 환경 변수로 설정합니다. -```bash title="~/.bash_profile" + ```bash title="~/.bash_profile" export CLOUDFLARE_API_TOKEN=your-api-token -``` + ``` 5. 모델을 선택하려면 `/models` 명령을 실행하십시오. @@ -488,27 +480,27 @@ Cloudflare AI 게이트웨이는 OpenAI, Anthropic, Workers AI 등의 모델에 /models ``` -opencode config를 통해 모델을 추가할 수 있습니다. + OpenCode 구성을 통해 모델을 추가할 수 있습니다. -```json title="opencode.json" -{ - "$schema": "https://opencode.ai/config.json", - "provider": { - "cloudflare-ai-gateway": { - "models": { - "openai/gpt-4o": {}, - "anthropic/claude-sonnet-4": {} - } - } - } -} -``` + ```json title="opencode.json" + { + "$schema": "https://opencode.ai/config.json", + "provider": { + "cloudflare-ai-gateway": { + "models": { + "openai/gpt-4o": {}, + "anthropic/claude-sonnet-4": {} + } + } + } + } + ``` --- -#### 코텍 +#### Cortecs -1. [Cortecs 콘솔](https://cortecs.ai/)에 머리, 계정을 만들고 API 키를 생성합니다. +1. [Cortecs 콘솔](https://cortecs.ai/)로 이동하여 계정을 만들고 API 키를 생성합니다. 2. `/connect` 명령을 실행하고 **Cortecs**를 검색하십시오. @@ -525,7 +517,7 @@ opencode config를 통해 모델을 추가할 수 있습니다. └ enter ``` -4. `/models` 명령을 실행하여 같은 모델을 선택하십시오 Kimi K2 Instruct . +4. `/models` 명령을 실행하여 모델(예: Kimi K2 Instruct)을 선택하십시오. ```txt /models @@ -533,9 +525,9 @@ opencode config를 통해 모델을 추가할 수 있습니다. --- -## 딥스카이 +## DeepSeek -1. [DeepSeek 콘솔](https://platform.deepseek.com/)에 머리, 계정을 만들고, ** 새로운 API 키**를 클릭합니다. +1. [DeepSeek 콘솔](https://platform.deepseek.com/)로 이동하여 계정을 만들고 **API Keys**를 클릭하여 키를 생성합니다. 2. `/connect` 명령을 실행하고 **DeepSeek**를 검색하십시오. @@ -552,7 +544,7 @@ opencode config를 통해 모델을 추가할 수 있습니다. └ enter ``` -4. `/models` 명령을 실행하여 DeepSeek 모델을 선택하십시오. DeepSeek Reasoner . +4. `/models` 명령을 실행하여 DeepSeek 모델(예: DeepSeek Reasoner)을 선택하십시오. ```txt /models @@ -560,9 +552,9 @@ opencode config를 통해 모델을 추가할 수 있습니다. --- -## 딥 인프라 +## Deep Infra -1. [Deep Infra 대시보드](https://deepinfra.com/dash)에 머리로, 계정을 만들고 API 키를 생성합니다. +1. [Deep Infra 대시보드](https://deepinfra.com/dash)로 이동하여 계정을 만들고 API 키를 생성합니다. 2. `/connect` 명령을 실행하고 **Deep Infra**를 검색하십시오. @@ -570,7 +562,7 @@ opencode config를 통해 모델을 추가할 수 있습니다. /connect ``` -3. 딥 인프라 API 키 입력. +3. Deep Infra API 키를 입력하십시오. ```txt ┌ API key @@ -587,9 +579,9 @@ opencode config를 통해 모델을 추가할 수 있습니다. --- -## 펌웨어 +## Firmware -1. [Firmware 대시보드](https://app.firmware.ai/signup)에 머리, 계정을 만들고 API 키를 생성합니다. +1. [Firmware 대시보드](https://app.firmware.ai/signup)로 이동하여 계정을 만들고 API 키를 생성합니다. 2. `/connect` 명령을 실행하고 **Firmware**를 검색하십시오. @@ -597,7 +589,7 @@ opencode config를 통해 모델을 추가할 수 있습니다. /connect ``` -3. Firmware API 키 입력. +3. Firmware API 키를 입력하십시오. ```txt ┌ API key @@ -614,17 +606,17 @@ opencode config를 통해 모델을 추가할 수 있습니다. --- -## 불꽃 놀이 AI +## Fireworks AI -1. [Fireworks AI 콘솔](https://app.fireworks.ai/)에 머리, 계정을 만들고 ** API 키**를 클릭합니다. +1. [Fireworks AI 콘솔](https://app.fireworks.ai/)로 이동하여 계정을 만들고 **API Keys**를 클릭합니다. -2. `/connect` 명령을 실행하고 ** 불꽃 놀이 AI **를 검색하십시오. +2. `/connect` 명령을 실행하고 **Fireworks AI**를 검색하십시오. ```txt /connect ``` -3. 불꽃 놀이 AI API 열쇠를 입력하십시오. +3. Fireworks AI API 키를 입력하십시오. ```txt ┌ API key @@ -633,7 +625,7 @@ opencode config를 통해 모델을 추가할 수 있습니다. └ enter ``` -4. `/models` 명령을 실행하여 같은 모델을 선택하십시오 Kimi K2 Instruct . +4. `/models` 명령을 실행하여 모델(예: Kimi K2 Instruct)을 선택하십시오. ```txt /models @@ -641,9 +633,9 @@ opencode config를 통해 모델을 추가할 수 있습니다. --- -### GitLab 듀오 +### GitLab Duo -프로젝트 Duo는 GitLab의 Anthropic 프록시를 통해 기본 툴 호출 기능을 갖춘 AI-powered Agentic 채팅을 제공합니다. +GitLab Duo는 GitLab의 Anthropic 프록시를 통해 기본 도구 호출 기능을 갖춘 AI 기반 에이전트 채팅을 제공합니다. 1. `/connect` 명령을 실행하고 GitLab을 선택합니다. @@ -661,38 +653,42 @@ opencode config를 통해 모델을 추가할 수 있습니다. └ ``` -#### OAuth 사용 (추천) +#### OAuth 사용 (권장) -Select**OAuth**와 브라우저는 권한이 없습니다. +**OAuth**를 선택하면 브라우저에서 권한 부여를 요청합니다. ### 개인 액세스 토큰 사용 -1. [GitLab User Settings > Access Tokens](https://gitlab.com/-/user settings/personal access tokens)로 이동 -2. 새 토큰 추가 \*\* -3. 이름: `OpenCode`의 범위: `api` -4. 토큰 복사 (`glpat-`와 함께 시작) -5. terminal에서 그것을 입력하십시오 +1. [GitLab User Settings > Access Tokens](https://gitlab.com/-/user_settings/personal_access_tokens)로 이동 +2. 새 토큰 추가 +3. 이름: `OpenCode`, 범위: `api` +4. 토큰 복사 (`glpat-`로 시작) +5. 터미널에 입력하십시오. -6. 유효한 모형을 보기 위하여 `/models` 명령을 실행하십시오. +6. 사용 가능한 모델을 보려면 `/models` 명령을 실행하십시오. ```txt /models ``` -세 개의 클로드 기반 모델은 다음과 같습니다. -**duo-chat-haiku-4-5** (기본값) - 빠른 작업에 대한 빠른 응답 -**duo-chat-sonnet-4-5** - 대부분의 워크플로우의 밸런스 성능 -**duo-chat-opus-4-5** - 복잡한 분석 가능 +세 가지 Claude 기반 모델을 사용할 수 있습니다: + +- **duo-chat-haiku-4-5** (기본값) - 빠른 작업을 위한 빠른 응답 +- **duo-chat-sonnet-4-5** - 대부분의 워크플로우에 균형 잡힌 성능 +- **duo-chat-opus-4-5** - 복잡한 분석 가능 :::note -'GITLAB TOKEN' 환경 변수를 지정할 수도 있습니다. -opencode auth 저장소에 토큰을 저장합니다. +`GITLAB_TOKEN` 환경 변수를 지정할 수도 있습니다. +OpenCode는 인증 저장소에 토큰을 저장합니다. ::: -#### 셀프 호스팅 GitLab +#### 셀프 호스팅 GitLab (Self-Hosted) -:::note[compliance note] -opencode는 세션 제목을 생성하고 같은 일부 AI 작업을 위해 작은 모델을 사용합니다. -기본적으로 gpt-5-nano를 사용하도록 구성되며 Zen에서 호스팅됩니다. opencode를 잠금 -자신의 GitLab-hosted 인스턴스를 사용하여 다음을 추가하십시오. -`opencode.json` 파일. 세션 공유를 비활성화하는 것이 좋습니다. +:::note[규정 준수 참고 사항] +OpenCode는 세션 제목 생성과 같은 일부 AI 작업을 위해 작은 모델을 사용합니다. +기본적으로 Zen에서 호스팅되는 gpt-5-nano를 사용하도록 구성됩니다. +OpenCode를 자체 호스팅 GitLab 인스턴스만 사용하도록 제한하려면 `opencode.json` 파일에 다음을 추가하십시오. +세션 공유를 비활성화하는 것도 권장합니다. ```json { @@ -711,13 +707,13 @@ export GITLAB_INSTANCE_URL=https://gitlab.company.com export GITLAB_TOKEN=glpat-... ``` -인스턴스가 사용자 정의 AI Gateway를 실행하면: +인스턴스가 사용자 정의 AI Gateway를 실행하는 경우: ```bash -GITLAB_AI_GATEWAY_URL=https://ai-gateway.company.com +export GITLAB_AI_GATEWAY_URL=https://ai-gateway.company.com ``` -또는 bash 프로파일에 추가: +또는 bash 프로필에 추가: ```bash title="~/.bash_profile" export GITLAB_INSTANCE_URL=https://gitlab.company.com @@ -726,36 +722,35 @@ export GITLAB_TOKEN=glpat-... ``` :::note -GitLab 관리자는 다음을 활성화해야합니다. +GitLab 관리자는 다음을 활성화해야 합니다: -1. [Duo Agent Platform](https://docs.gitlab.com/user/gitlab duo/turn on off/) 사용자, 그룹 또는 인스턴스 -2. 특징 깃발 (철도 콘솔을 통해): +1. [Duo Agent Platform](https://docs.gitlab.com/user/gitlab_duo/turn_on_off/) (사용자, 그룹 또는 인스턴스) +2. 기능 플래그 (Rails 콘솔을 통해): - `agent_platform_claude_code` - `third_party_agents_enabled` ::: -####OAuth for Self-Hosted 인스턴스 +#### 셀프 호스팅 인스턴스용 OAuth -자체 호스팅 된 인스턴스를 위해 Oauth 작업을 만들기 위해, 당신은 만들 필요가 -새로운 응용 프로그램 (설정 → 응용 프로그램) -콜백 URL `http://127.0.0.1:8080/callback` 및 다음 범위: +자체 호스팅 인스턴스에 대해 OAuth를 작동시키려면 새로운 애플리케이션(Settings → Applications)을 만들어야 합니다. +콜백 URL `http://127.0.0.1:8080/callback` 및 다음 범위가 필요합니다: -- api (당신의 대신에 API에 액세스) -- read user (개인 정보 읽기) -- read repository (Repository에 읽은 전용 접근) +- `api` (사용자 대신 API 액세스) +- `read_user` (개인 정보 읽기) +- `read_repository` (리포지토리 읽기 전용 액세스) -그런 다음 환경 변수로 애플리케이션 ID를 노출: +그런 다음 애플리케이션 ID를 환경 변수로 노출하십시오: ```bash export GITLAB_OAUTH_CLIENT_ID=your_application_id_here ``` -[opencode-gitlab-auth](https://www.npmjs.com/package/@gitlab/opencode-gitlab-auth) 홈페이지에 대한 추가 문서. +[opencode-gitlab-auth](https://www.npmjs.com/package/@gitlab/opencode-gitlab-auth) 홈페이지에 추가 문서가 있습니다. ##### 구성 -`opencode.json`를 통해 주문을 받아서 만드십시오: +`opencode.json`을 통해 사용자 정의: ```json title="opencode.json" { @@ -774,9 +769,9 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here } ``` -##### GitLab API 도구 (선택, 그러나 높게 추천되는) +##### GitLab API 도구 (선택 사항이지만 강력 권장) -GitLab 도구에 액세스하려면 (merge 요청, 문제, 파이프라인, CI/CD 등): +GitLab 도구(병합 요청, 이슈, 파이프라인, CI/CD 등)에 액세스하려면: ```json title="opencode.json" { @@ -785,11 +780,11 @@ GitLab 도구에 액세스하려면 (merge 요청, 문제, 파이프라인, CI/C } ``` -이 플러그인은 MR 리뷰, 문제 추적, 파이프라인 모니터링 등을 포함한 종합 GitLab 저장소 관리 기능을 제공합니다. +이 플러그인은 MR 리뷰, 이슈 추적, 파이프라인 모니터링 등을 포함한 포괄적인 GitLab 리포지토리 관리 기능을 제공합니다. --- -프로젝트 +### GitHub Copilot GitHub Copilot 구독을 사용하여 opencode: @@ -898,7 +893,7 @@ opencode를 실행하면서 설정한다. --- -###Hugging 얼굴 +### Hugging Face [Hugging Face Inference Provider](https://huggingface.co/docs/inference-providers)는 17+ 공급자가 지원하는 오픈 모델에 대한 액세스를 제공합니다. @@ -927,7 +922,7 @@ opencode를 실행하면서 설정한다. --- -### 헬리콘 +### Helicone [Helicone](https://helicone.ai)는 AI 애플리케이션에 대한 로깅, 모니터링 및 분석 기능을 제공하는 LLM Observability 플랫폼입니다. Helicone AI Gateway는 모델을 기반으로 적절한 공급자에게 요청을 자동으로 전달합니다. @@ -1027,7 +1022,7 @@ npm install -g opencode-helicone-session 플러그인은 `Helicone-Session-Id` 및 `Helicone-Session-Name` 헤더를 귀하의 요청에 주사합니다. Helicone의 세션 페이지에서는 별도의 세션으로 나열된 각 opencode 대화를 볼 수 있습니다. -###### 공통 헬리콥터 +###### 공통 Helicone 헤더 | 헤드러 | Description | | -------------------------- | ---------------------------------------------------------- | @@ -1040,7 +1035,7 @@ npm install -g opencode-helicone-session --- -#### llama.cpp를 +#### llama.cpp [llama.cpp's](https://github.com/ggml-org/llama.cpp) llama-server 유틸리티를 통해 로컬 모델을 사용할 수 있습니다. @@ -1107,7 +1102,7 @@ IO.NET은 다양한 사용 사례에 최적화된 17개의 모델을 제공합 --- -### LM 스튜디오 +### LM Studio LM Studio를 통해 로컬 모델을 사용할 수 있습니다. @@ -1141,7 +1136,7 @@ LM Studio를 통해 로컬 모델을 사용할 수 있습니다. --- -## 문샷 AI +## Moonshot AI Moonshot AI에서 Kimi K2 사용 : @@ -1170,7 +1165,7 @@ Moonshot AI에서 Kimi K2 사용 : --- -## 미니 맥스 +## MiniMax 1. [MiniMax API 콘솔](https://platform.minimax.io/login)에 머리, 계정을 만들고 API 키를 생성합니다. @@ -1197,7 +1192,7 @@ Moonshot AI에서 Kimi K2 사용 : --- -## Nebius 토큰 공장 +## Nebius Token Factory 1. [Nebius Token Factory 콘솔](https://tokenfactory.nebius.com/)에 머리, 계정을 만들고, ** 키 추가 **. @@ -1224,7 +1219,7 @@ Moonshot AI에서 Kimi K2 사용 : --- -#### 오라마 +#### Ollama Ollama를 통해 로컬 모델을 사용할 수 있습니다. @@ -1266,7 +1261,7 @@ Ollama는 opencode를 자동으로 구성할 수 있습니다. 자세한 내용 --- -##Ollama 클라우드 +## Ollama Cloud opencode로 Ollama Cloud를 사용하려면: @@ -1305,7 +1300,7 @@ opencode로 Ollama Cloud를 사용하려면: --- -### 오픈아이 +### OpenAI [ChatGPT Plus 또는 Pro](https://chatgpt.com/pricing)에 가입하는 것이 좋습니다. @@ -1338,7 +1333,7 @@ API 키가 이미 있다면 ** 수동으로 API 키**를 입력하고 terminal --- -## opencode 젠 +## OpenCode Zen OpenCode Zen은 opencode 팀에서 제공하는 테스트 및 검증된 모델 목록입니다. [더 알아보기](/docs/zen). @@ -1367,7 +1362,7 @@ OpenCode Zen은 opencode 팀에서 제공하는 테스트 및 검증된 모델 --- -## 오픈로자 +## OpenRouter 1. [OpenRouter 대시보드](https://openrouter.ai/settings/keys)에 머리, click ** API Key**를 클릭하고 키를 복사합니다. @@ -1431,7 +1426,7 @@ opencode config를 통해 추가 모델을 추가할 수 있습니다. --- -### SAP AI 핵심 +### SAP AI Core SAP AI Core는 OpenAI, Anthropic, Google, Amazon, Meta, Mistral 및 AI21의 40+ 모델에 대한 액세스를 제공합니다. @@ -1513,7 +1508,7 @@ SAP AI Core는 OpenAI, Anthropic, Google, Amazon, Meta, Mistral 및 AI21의 40+ --- -### 스케일웨이 +### Scaleway opencode를 사용하여 [Scaleway Generative APIs](https://www.scaleway.com/en/docs/generative-apis/)를 사용하려면: @@ -1542,7 +1537,7 @@ opencode를 사용하여 [Scaleway Generative APIs](https://www.scaleway.com/en/ --- -## 함께 AI +## Together AI 1. [Together AI 콘솔](https://api.together.ai)에 머리, 계정을 만들고 ** 키 추가 **를 클릭합니다. @@ -1569,7 +1564,7 @@ opencode를 사용하여 [Scaleway Generative APIs](https://www.scaleway.com/en/ --- -## 베니스 AI +## Venice AI 1. [Venice AI 콘솔](https://venice.ai)에 머리, 계정을 만들고 API 키를 생성합니다. @@ -1652,7 +1647,7 @@ opencode config를 통해 모델을 사용자 정의 할 수 있습니다. 공 --- -# +### xAI 1. [xAI 콘솔](https://console.x.ai/)에 머리, 계정을 만들고 API 키를 생성합니다. @@ -1679,7 +1674,7 @@ opencode config를 통해 모델을 사용자 정의 할 수 있습니다. 공 --- -#### Z.AI +### Z.AI 1. [Z.AI API 콘솔](https://z.ai/manage-apikey/apikey-list)에 머리, 계정을 만들고, **새로운 API 키**를 클릭합니다. @@ -1708,7 +1703,7 @@ opencode config를 통해 모델을 사용자 정의 할 수 있습니다. 공 --- -## ZenMux를 +## ZenMux 1. [ZenMux 대쉬보드](https://zenmux.ai/settings/keys)에 머리, click **Create API Key**, 키 복사. diff --git a/packages/web/src/content/docs/ko/rules.mdx b/packages/web/src/content/docs/ko/rules.mdx index 5c0a4707b..940ad6237 100644 --- a/packages/web/src/content/docs/ko/rules.mdx +++ b/packages/web/src/content/docs/ko/rules.mdx @@ -1,6 +1,6 @@ --- -title: Rules -description: Set custom instructions for opencode. +title: 규칙 +description: OpenCode에 대한 사용자 정의 지침 설정. --- `AGENTS.md` 파일을 만들 수 있도록 opencode에 사용자 정의 지침을 제공 할 수 있습니다. Cursor의 규칙과 유사합니다. LLM의 컨텍스트에 포함된 지침을 통해 특정 프로젝트에 대한 행동을 사용자 정의합니다. @@ -60,7 +60,7 @@ opencode는 또한 다수 위치에서 `AGENTS.md` 파일을 읽습니다. 그 프로젝트 별 규칙에 대한 프로젝트 루트에 `AGENTS.md`를 배치합니다. 이 디렉토리 또는 하위 디렉토리에서 작업 할 때만 적용됩니다. -## 글로벌 +## 전역 또한 `~/.config/opencode/AGENTS.md` 파일에서 글로벌 규칙을 가질 수 있습니다. 이 모든 opencode 세션에서 적용됩니다. @@ -83,7 +83,7 @@ export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills --- -## 전신 +## 우선순위 opencode가 시작될 때, 이 순서에 있는 규칙 파일을 찾습니다: @@ -123,7 +123,7 @@ opencode가 시작될 때, 이 순서에 있는 규칙 파일을 찾습니다: --- -## 외부 파일을 Referencing +## 외부 파일 참조 opencode가 `AGENTS.md`에 있는 자동적으로 파스 파일 참조를 하지 않는 동안, 당신은 두 가지 방법으로 유사한 기능을 달성할 수 있습니다: @@ -138,7 +138,7 @@ opencode가 `AGENTS.md`에 있는 자동적으로 파스 파일 참조를 하지 } ``` -## # AGENTS.md의 수동 지침 +### AGENTS.md의 수동 지침 `AGENTS.md`에 명시된 지침을 제공함으로써 외부 파일을 읽을 수 있습니다. 여기에 실용적인 예: diff --git a/packages/web/src/content/docs/ko/sdk.mdx b/packages/web/src/content/docs/ko/sdk.mdx index d181a6f10..f6d43c136 100644 --- a/packages/web/src/content/docs/ko/sdk.mdx +++ b/packages/web/src/content/docs/ko/sdk.mdx @@ -1,6 +1,6 @@ --- title: SDK -description: Type-safe JS client for opencode server. +description: opencode 서버를 위한 타입 안전한 JS 클라이언트. --- import config from "../../../../config.mjs" @@ -47,7 +47,7 @@ const { client } = await createOpencode() --- -## 콘피그 +## 구성 구성 객체를 전달할 수 있습니다. 인스턴스는 여전히 `opencode.json`를 선택하지만 구성 인라인을 추가 할 수 있습니다. @@ -91,7 +91,7 @@ const client = createOpencodeClient({ --- -## 유형 +## 타입 SDK에는 모든 API 유형의 TypeScript 정의가 포함되어 있습니다. 직접 가져 오기 : @@ -125,7 +125,7 @@ SDK는 type-safe 클라이언트를 통해 모든 서버 API를 노출합니다. ## 글로벌 -| 방법 | 설명 | 응답 | +| 메서드 | 설명 | 응답 | | ----------------- | ---------------------- | ------------------------------------ | | `global.health()` | 서버 건강 및 버전 확인 | `{ healthy: true, version: string }` | @@ -205,7 +205,7 @@ const pathInfo = await client.path.get() --- -#### 콘피그 +#### 구성 | 방법 | 설명 | 응답 | | -------------------- | -------------------------- | ----------------------------------------------------------------------------------------------------- | @@ -226,27 +226,27 @@ const { providers, default: defaults } = await client.config.providers() ## 세션 -| 방법 | 묘사 | 주 | -| ---------------------------------------------------------- | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | -| `session.list()` | 세션 일람 | Session[] | -| `session.get({ path })` | 세션 가져 오기 | Session | -| `session.children({ path })` | 목록 어린이 세션 | 반품 Session | -| `session.create({ body })` | 세션 만들기 | 리턴 Session | -| `session.delete({ path })` | 세션 삭제 | `boolean` 반품 | -| `session.update({ path, body })` | 업데이트 세션 속성 | 반품 Session | -| `session.init({ path, body })` | Analyze 앱을 만들고 `AGENTS.md` | `boolean`를 반환 | -| `session.abort({ path })` | 운영 중인 세션 | 반품 `boolean` | -| `session.share({ path })` | 공유 세션 | 반품 Session | -| `session.unshare({ path })` | 공유 세션 | 반품 Session | -| `session.summarize({ path, body })` | 세션 요약 | 반품 `boolean` | -| `session.messages({ path })` | 세션의 메시지 목록 | `{ info: `Message`, parts: `Part`}[]` | -| `session.message({ path })` | 메시지 상세정보 | 반품 `{ info: `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 })` | shell 명령을 실행 | AssistantMessage | -| `session.revert({ path, body })` | 메시지 다시 변환 | Session | -| `session.unrevert({ path })` | 통일된 메시지 | 반품 Session | -| `postSessionByIdPermissionsByPermissionId({ path, body })` | 허가 요청 대응 | 반품 `boolean` | +| 메서드 | 설명 | 비고 | +| ---------------------------------------------------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | +| `session.list()` | 세션 일람 | Session[] | +| `session.get({ path })` | 세션 가져 오기 | Session | +| `session.children({ path })` | 하위 세션 목록 | 반품 Session | +| `session.create({ body })` | 세션 만들기 | 리턴 Session | +| `session.delete({ path })` | 세션 삭제 | `boolean` 반품 | +| `session.update({ path, body })` | 업데이트 세션 속성 | 반품 Session | +| `session.init({ path, body })` | 앱 초기화 및 `AGENTS.md` 분석 | `boolean`를 반환 | +| `session.abort({ path })` | 운영 중인 세션 | 반품 `boolean` | +| `session.share({ path })` | 공유 세션 | 반품 Session | +| `session.unshare({ path })` | 공유 세션 | 반품 Session | +| `session.summarize({ path, body })` | 세션 요약 | 반품 `boolean` | +| `session.messages({ path })` | 세션의 메시지 목록 | `{ info: `Message`, parts: `Part`}[]` | +| `session.message({ path })` | 메시지 상세정보 | 반품 `{ info: `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 })` | shell 명령을 실행 | AssistantMessage | +| `session.revert({ path, body })` | 메시지 다시 변환 | Session | +| `session.unrevert({ path })` | 메시지 되돌리기 취소 | 반품 Session | +| `postSessionByIdPermissionsByPermissionId({ path, body })` | 허가 요청 대응 | 반품 `boolean` | --- @@ -287,7 +287,7 @@ await client.session.prompt({ | ------------------------- | ---------------------------- | -------------------------------------------------------------------------------------- | | `find.text({ query })` | 파일에서 텍스트 검색 | `path`, `lines`, `line_number`, `absolute_offset`, `submatches`와 일치하는 개체의 배열 | | `find.files({ query })` | 이름의 파일 및 디렉토리 찾기 | `string[]` (경로) | -| `find.symbols({ query })` | 업무 공간 기호 찾기 | Symbol[] | +| `find.symbols({ query })` | 작업 공간 심볼 찾기 | Symbol[] | | `file.read({ query })` | 파일 보기 | `{ type: "raw" \| "patch", content: string }` | | `file.status({ query? })` | 트랙 된 파일 상태를 확인 | File[] | @@ -329,12 +329,12 @@ const content = await client.file.read({ | `tui.appendPrompt({ body })` | 프롬프트에 텍스트를 부여 | `boolean` | | `tui.openHelp()` | 도움말 열기 | `boolean` | | `tui.openSessions()` | 세션 선택 안내 | `boolean` | -| `tui.openThemes()` | 테마 선택 해제 | `boolean` | +| `tui.openThemes()` | 테마 선택 열기 | `boolean` | | `tui.openModels()` | 모델 선택 안내 | `boolean` | | `tui.submitPrompt()` | 현재 프롬프트 제출 | `boolean` | | `tui.clearPrompt()` | 프롬프트 클리어 | `boolean` | | `tui.executeCommand({ body })` | 명령어 실행 | `boolean` | -| `tui.showToast({ body })` | 쇼 토스트 알림 | `boolean` | +| `tui.showToast({ body })` | 토스트 알림 표시 | `boolean` | --- @@ -353,7 +353,7 @@ await client.tui.showToast({ --- -##### 가을 +##### 인증 | 방법 | 설명 | 응답 | | ------------------- | -------------- | --------- | diff --git a/packages/web/src/content/docs/ko/server.mdx b/packages/web/src/content/docs/ko/server.mdx index f76583902..a6914605a 100644 --- a/packages/web/src/content/docs/ko/server.mdx +++ b/packages/web/src/content/docs/ko/server.mdx @@ -1,6 +1,6 @@ --- -title: Server -description: Interact with opencode server over HTTP. +title: 서버 +description: HTTP를 통해 OpenCode 서버와 상호 작용합니다. --- import config from "../../../../config.mjs" @@ -44,7 +44,7 @@ OPENCODE_SERVER_PASSWORD=your-password opencode serve --- -### 어떻게 작동합니까? +### 작동 방식 `opencode`를 실행하면 TUI와 서버를 시작합니다. TUI는 어디에 있습니까? 서버와 대화하는 클라이언트. 서버는 OpenAPI 3.1 spec을 노출 @@ -122,7 +122,7 @@ opencode 서버는 다음과 같은 API를 노출합니다. --- -### 콘피그 +### 구성 | 방법 | 경로 | 설명 | 응답 | | ------- | ------------------- | -------------------------- | ---------------------------------------------------------------------------------------- | @@ -145,7 +145,7 @@ opencode 서버는 다음과 같은 API를 노출합니다. ## 세션 -| 방법 | 경로 | 설명 | 주 | +| 메서드 | 경로 | 설명 | 비고 | | -------- | ---------------------------------------- | ---------------------------------- | ----------------------------------------------------------------------------- | | `GET` | `/session` | 모든 세션 일람표 | 반환 Session[] | | `POST` | `/session` | 새 세션 만들기 | 몸: `{ parentID?, title? }`, 반환 Session | @@ -153,9 +153,9 @@ opencode 서버는 다음과 같은 API를 노출합니다. | `GET` | `/session/:id` | 세션 상세보기 | 반품 Session | | `DELETE` | `/session/:id` | 세션 삭제 및 모든 데이터 | `boolean` | | `PATCH` | `/session/:id` | 업데이트 세션 속성 | 본체: `{ title? }`, 반환 Session | -| `GET` | `/session/:id/children` | 세션의 어린이 세션 | 리턴 Session[] | -| `GET` | `/session/:id/todo` | 세션별 도우미 목록 받기 | Todo[] | -| `POST` | `/session/:id/init` | 분석 응용 프로그램 및 `AGENTS.md` | 몸: `{ messageID, providerID, modelID }`, 반환 `boolean` | +| `GET` | `/session/:id/children` | 세션의 하위 세션 | 리턴 Session[] | +| `GET` | `/session/:id/todo` | 세션의 할 일(Todo) 목록 받기 | Todo[] | +| `POST` | `/session/:id/init` | 앱 초기화 및 `AGENTS.md` 분석 | 몸: `{ messageID, providerID, modelID }`, 반환 `boolean` | | `POST` | `/session/:id/fork` | 메시지의 기존 세션 | 몸: `{ messageID? }`, 반환 Session | | `POST` | `/session/:id/abort` | 운영 중인 세션 | 반품 `boolean` | | `POST` | `/session/:id/share` | 세션 공유 | Session | @@ -163,7 +163,7 @@ opencode 서버는 다음과 같은 API를 노출합니다. | `GET` | `/session/:id/diff` | `/session/:id/diff` | `messageID?`, 반환 FileDiff[] | | `POST` | `/session/:id/summarize` | 세션을 요약 | 본체: `{ providerID, modelID }`, `boolean` 반환 | | `POST` | `/session/:id/revert` | 메시지 재생 | 몸: `{ messageID, partID? }`, 반환 `boolean` | -| `POST` | `/session/:id/unrevert` | 통일된 모든 메시지 | 반품 `boolean` | +| `POST` | `/session/:id/unrevert` | 메시지 되돌리기 취소 | 반품 `boolean` | | `POST` | `/session/:id/permissions/:permissionID` | 허가 요청 대응 | 본체: `{ response, remember? }`, `boolean` | --- @@ -210,7 +210,7 @@ opencode 서버는 다음과 같은 API를 노출합니다. --- -## 도구 (실험) +## 도구 (실험적) | 방법 | 경로 | 설명 | 응답 | | ----- | ------------------------------------------- | ----------------------- | --------------------------------------------- | @@ -219,7 +219,7 @@ opencode 서버는 다음과 같은 API를 노출합니다. --- -### LSP의 체재자 & MCP +### LSP, 포매터 & MCP | 방법 | 경로 | 설명 | 응답 | | ------ | ------------ | ---------------------- | -------------------------------------------------------- | @@ -276,7 +276,7 @@ opencode 서버는 다음과 같은 API를 노출합니다. | 방법 | 경로 | 설명 | 응답 | | ----- | -------- | ------------------------------------------------------------------------------- | ------------------------ | -| `GET` | `/event` | 서버 침묵 이벤트 스트림. 첫 번째 이벤트는 `server.connected`, 그 후 버스 이벤트 | Server-sent event stream | +| `GET` | `/event` | 서버 전송 이벤트 스트림. 첫 번째 이벤트는 `server.connected`, 그 후 버스 이벤트 | Server-sent event stream | --- diff --git a/packages/web/src/content/docs/ko/share.mdx b/packages/web/src/content/docs/ko/share.mdx index 816a501dc..55cf6a2c3 100644 --- a/packages/web/src/content/docs/ko/share.mdx +++ b/packages/web/src/content/docs/ko/share.mdx @@ -1,6 +1,6 @@ --- -title: Share -description: Share your opencode conversations. +title: 공유 +description: OpenCode 대화를 공유하세요. --- opencode의 공유 기능은 opencode 대화에 대한 공개 링크를 만들 수 있으므로 Teammates와 협업하거나 다른 곳에서 도움을받을 수 있습니다. @@ -11,7 +11,7 @@ opencode의 공유 기능은 opencode 대화에 대한 공개 링크를 만들 --- -## 어떻게 작동합니까? +## 작동 방식 대화를 공유할 때, opencode: @@ -48,7 +48,7 @@ opencode는 대화가 공유되는 방법을 제어하는 세 가지 공유 모 --- -## 자동차 공유 +## 자동 공유 `share` 옵션을 설정하여 모든 새로운 대화에 대한 자동 공유를 활성화 할 수 있습니다 `"auto"` 당신의 [config 파일](/docs/config): @@ -78,7 +78,7 @@ opencode는 대화가 공유되는 방법을 제어하는 세 가지 공유 모 --- -## 비 쉐링 +## 공유 취소 대화를 중지하고 공공 액세스에서 제거 : diff --git a/packages/web/src/content/docs/ko/skills.mdx b/packages/web/src/content/docs/ko/skills.mdx index 36cab78c2..03ec9c75a 100644 --- a/packages/web/src/content/docs/ko/skills.mdx +++ b/packages/web/src/content/docs/ko/skills.mdx @@ -1,6 +1,6 @@ --- -title: "Agent Skills" -description: "Define reusable behavior via SKILL.md definitions" +title: "에이전트 스킬" +description: "SKILL.md 정의를 통해 재사용 가능한 동작을 정의합니다." --- Agent Skill let opencode discover reusable instruction from your repo 또는 홈 디렉토리. @@ -8,7 +8,7 @@ Skills are loaded on-demand via native `skill` tool-agents see available skills --- -## 파일 장소 +## 파일 위치 기술 이름 당 하나의 폴더를 만들고 내부 `SKILL.md`를 넣어. opencode 이 위치를 검색: @@ -22,7 +22,7 @@ opencode 이 위치를 검색: --- -## 발견의 이해 +## 검색 이해 Project-local paths의 경우, opencode는 git worktree에 도달 할 때까지 현재 작업 디렉토리에서 걷습니다. 그것은 `skills/*/SKILL.md`에 있는 어떤 어울리는 `.opencode/` 및 어떤 어울리는 `.claude/skills/*/SKILL.md` 또는 `.agents/skills/*/SKILL.md`를 방법 적재합니다. @@ -31,7 +31,7 @@ Project-local paths의 경우, opencode는 git worktree에 도달 할 때까지 --- -## 쓰기 frontmatter +## Frontmatter 작성 각 `SKILL.md`는 YAML frontmatter로 시작해야 합니다. 이 필드는 인식됩니다: @@ -46,7 +46,7 @@ Project-local paths의 경우, opencode는 git worktree에 도달 할 때까지 --- -## 유효 이름 +## 유효한 이름 `name`는 해야 합니다: @@ -64,14 +64,14 @@ Project-local paths의 경우, opencode는 git worktree에 도달 할 때까지 --- -## 길이 규칙을 따르십시오 +## 길이 규칙 준수 `description`는 1-1024 특성이어야 합니다. 제대로 선택하기 위해 에이전트에 대해 충분히 유지하십시오. --- -## 예제 사용 +## 사용 예제 이처럼 `.opencode/skills/git-release/SKILL.md` 만들기: @@ -100,7 +100,7 @@ Ask clarifying questions if the target versioning scheme is unclear. --- -## 인식 도구 설명 +## 도구 설명 인식 opencode는 `skill` 도구 설명에서 사용할 수있는 기술을 나열합니다. 각 항목에는 기술 이름 및 설명이 포함됩니다. @@ -149,7 +149,7 @@ skill({ name: "git-release" }) --- -## 에이전트 당 override +## 에이전트별 재정의 글로벌 디폴트보다 특정 에이전트 다른 권한을 부여합니다. @@ -181,7 +181,7 @@ permission: --- -## 기술 도구 비활성화 +## 스킬 도구 비활성화 그들을 사용하지 않는 에이전트을위한 완전히 비활성화 된 기술 : @@ -212,7 +212,7 @@ tools: --- -## 문제 해결 선적 +## 로딩 문제 해결 기술이 나타나지 않는 경우: diff --git a/packages/web/src/content/docs/ko/themes.mdx b/packages/web/src/content/docs/ko/themes.mdx index e396d7907..b83b62017 100644 --- a/packages/web/src/content/docs/ko/themes.mdx +++ b/packages/web/src/content/docs/ko/themes.mdx @@ -1,6 +1,6 @@ --- -title: Themes -description: Select a built-in theme or define your own. +title: 테마 +description: 내장 테마를 선택하거나 자신만의 테마를 정의하세요. --- opencode를 사용하면 여러 내장 테마 중 하나에서 선택할 수 있으며 terminal 테마에 적응하는 테마를 사용하거나 사용자 정의 테마를 정의 할 수 있습니다. @@ -9,7 +9,7 @@ opencode를 사용하면 여러 내장 테마 중 하나에서 선택할 수 있 --- -## 끝 필요조건 +## 터미널 요구 사항 자신의 풀 컬러 팔레트로 올바르게 표시하려면 terminal을 지원해야합니다 ** truecolor** (24 비트 색상). 대부분의 현대 terminal은 기본적으로 이것을 지원합니다, 그러나 당신은 그것을 가능하게 할 필요가 있을지도 모릅니다: @@ -48,7 +48,7 @@ opencode는 여러 내장 테마와 함께 제공됩니다. `system` 테마는 terminal의 색깔 계획에 자동적으로 적응시키기 위하여 디자인됩니다. 고정 색상을 사용하는 전통적인 테마와 달리, system 테마: -- ** 회색 가늠자 **: terminal의 배경 색상을 기반으로 사용자 정의 회색 가늠자를 만들고 최적의 대조를 보장합니다. +- **그레이스케일**: terminal의 배경 색상을 기반으로 사용자 정의 회색 가늠자를 만들고 최적의 대조를 보장합니다. - ** ANSI 색상 사용 ** : terminal의 색상 팔레트를 존중하는 구문 강조 및 UI 요소에 대한 표준 ANSI 색상 (0-15). - ** terminal 기본 사항**: `none` 텍스트 및 배경 색상을 사용하여 terminal의 네이티브 외관을 유지합니다. @@ -79,7 +79,7 @@ opencode는 사용자가 쉽게 테마를 만들 수 있도록 유연한 JSON --- -##### Hierarchy의 +##### 계층 구조 테마는 다음과 같은 순서에서 여러 디렉토리에서로드됩니다. 나중에 감독은 이전 것을 무시합니다. @@ -128,7 +128,7 @@ vim .opencode/themes/my-theme.json --- -## terminal 기본값 +## 터미널 기본값 특별한 가치 `"none"`는 terminal의 기본 색깔을 상속하기 위하여 어떤 색깔든지를 위해 사용될 수 있습니다. 이것은 특히 당신의 terminal의 색깔 계획과 이음새가 없는 혼합 테마 창조를 위해 유용합니다: diff --git a/packages/web/src/content/docs/ko/tools.mdx b/packages/web/src/content/docs/ko/tools.mdx index 44f507077..c9f4fdaf6 100644 --- a/packages/web/src/content/docs/ko/tools.mdx +++ b/packages/web/src/content/docs/ko/tools.mdx @@ -1,6 +1,6 @@ --- -title: Tools -description: Manage the tools an LLM can use. +title: 도구 +description: LLM이 사용할 수 있는 도구를 관리합니다. --- 도구는 LLM을 사용하여 코드베이스에서 작업을 수행 할 수 있습니다. opencode는 내장 도구 세트로 제공되지만, [custom tools](/docs/custom-tools) 또는 [MCP 서버](/docs/mcp-servers)로 확장할 수 있습니다. @@ -62,7 +62,7 @@ description: Manage the tools an LLM can use. --- -### 편집 +### edit 정확한 문자열 교체를 사용하여 기존 파일을 수정합니다. @@ -79,7 +79,7 @@ description: Manage the tools an LLM can use. --- -### 쓰기 +### write 새로운 파일을 만들거나 기존의 것을 덮어쓰기. @@ -100,7 +100,7 @@ LLM을 사용하여 새 파일을 만듭니다. 이미 존재하는 경우 기 --- -### 읽기 +### read codebase에서 파일 내용을 읽으십시오. @@ -117,7 +117,7 @@ codebase에서 파일 내용을 읽으십시오. --- -#### 그라프 +#### grep 정규 표현식을 사용하여 파일 내용을 검색합니다. @@ -151,7 +151,7 @@ Codebase에서 빠른 콘텐츠 검색. 전체 regex 문법 및 파일 패턴 --- -### 리스트 +### list 주어진 경로의 파일 및 디렉토리 목록. @@ -168,7 +168,7 @@ Codebase에서 빠른 콘텐츠 검색. 전체 regex 문법 및 파일 패턴 --- -### lsp (실험) +### lsp (실험적) 정의, 참고, hover info 및 호출 hierarchy와 같은 코드 인텔리전스 기능을 얻기 위해 구성 된 LSP 서버와 인터랙트. @@ -191,7 +191,7 @@ LSP 서버가 프로젝트에 사용할 수 있는 구성하려면 [LSP Servers] --- -## 패치 +## patch 파일에 패치를 적용합니다. @@ -212,7 +212,7 @@ LSP 서버가 프로젝트에 사용할 수 있는 구성하려면 [LSP Servers] --- -### 기술 +### skill [skill](/docs/skills) (`SKILL.md` 파일)을로드하고 대화의 내용을 반환합니다. @@ -227,7 +227,7 @@ LSP 서버가 프로젝트에 사용할 수 있는 구성하려면 [LSP Servers] --- -## todowrite에 +## todowrite 코딩 세션 중에 todo 목록을 관리합니다. @@ -269,7 +269,7 @@ LSP 서버가 프로젝트에 사용할 수 있는 구성하려면 [LSP Servers] --- -#### 웹 사이트 +#### webfetch Fetch 웹 콘텐츠. @@ -286,7 +286,7 @@ LLM을 fetch 및 웹 페이지를 읽을 수 있습니다. 온라인 리소스 --- -#### 웹 검색 +#### websearch 웹 검색 @@ -320,7 +320,7 @@ API 키가 필요하지 않습니다 - 도구는 인증없이 Exa AI의 호스 --- -### 질문 +### question 실행 중에 사용자의 질문 요청. diff --git a/packages/web/src/content/docs/ko/troubleshooting.mdx b/packages/web/src/content/docs/ko/troubleshooting.mdx index dd8d17b11..a7a7ae5e4 100644 --- a/packages/web/src/content/docs/ko/troubleshooting.mdx +++ b/packages/web/src/content/docs/ko/troubleshooting.mdx @@ -1,13 +1,13 @@ --- -title: Troubleshooting -description: Common issues and how to resolve them. +title: 문제 해결 +description: 일반적인 문제와 해결 방법. --- opencode와 문제를 디버그하려면 로그와 로컬 데이터를 확인하여 디스크에 저장합니다. --- -## 로그인 +## 로깅 로그 파일은 다음과 같습니다: @@ -21,7 +21,7 @@ opencode와 문제를 디버그하려면 로그와 로컬 데이터를 확인하 --- -## 저장 +## 저장소 opencode 저장 세션 데이터 및 디스크에 다른 응용 데이터: @@ -39,11 +39,11 @@ opencode 저장 세션 데이터 및 디스크에 다른 응용 데이터: --- -## 데스크탑 앱 +## 데스크톱 앱 opencode 데스크톱은 배경에서 로컬 opencode 서버 (`opencode-cli` sidecar)를 실행합니다. 대부분의 문제는 misbehaving 플러그인, 손상된 캐시, 또는 나쁜 서버 설정에 의해 발생합니다. -## 빠른 체크 +## 빠른 확인 - 완전히 종료하고 앱을 다시 시작. - 앱이 오류 화면을 보여 주면 ** Restart**를 클릭하고 오류 세부 정보를 복사합니다. @@ -51,11 +51,11 @@ opencode 데스크톱은 배경에서 로컬 opencode 서버 (`opencode-cli` sid --- -## Disable 플러그인 +## 플러그인 비활성화 데스크톱 앱이 출시, 거는, 또는 이상한 것에서 충돌하면 플러그인을 비활성화하여 시작합니다. -### 글로벌 설정 확인 +### 전역 설정 확인 글로벌 설정 파일을 열고 `plugin` 키를 찾습니다. @@ -101,17 +101,17 @@ opencode는 디스크에서 로컬 플러그인을로드 할 수 있습니다. T --- -## 수정 서버 연결 문제 +## 서버 연결 문제 수정 opencode 데스크톱은 자체 로컬 서버(기본)를 시작하거나 구성된 서버 URL에 연결할 수 있습니다. **"Connection Failed"** 대화 상자 (또는 앱이 스패시 화면을 지나지 않습니다), 사용자 정의 서버 URL을 확인합니다. -### 바탕 화면 기본 서버 URL 삭제 +### 데스크톱 기본 서버 URL 삭제 Home 화면에서 Server Picker를 열려면 서버 이름(상태 점)을 클릭하십시오. **기본 서버** 섹션에서 **Clear**를 클릭합니다. -####는 `server.port`/`server.hostname`를 당신의 설정에서 제거합니다 +#### 설정에서 server.port/server.hostname 제거 `opencode.json(c)`가 `server` 섹션을 포함하면 일시적으로 제거하고 데스크톱 앱을 다시 시작합니다. @@ -123,7 +123,7 @@ Home 화면에서 Server Picker를 열려면 서버 이름(상태 점)을 클릭 --- -## Linux: 웨이랜드 / X11 문제 +## Linux: Wayland / X11 문제 Linux에서 일부 Wayland 설정은 공백 창이나 compositor 오류를 일으킬 수 있습니다. @@ -132,7 +132,7 @@ Linux에서 일부 Wayland 설정은 공백 창이나 compositor 오류를 일 --- -## Windows: WebView2 실행 시간 +## Windows: WebView2 런타임 Windows에서 opencode 데스크톱은 Microsoft Edge ** WebView2 실행 시간 **를 요구합니다. 앱이 공백 창에 열거나 시작하지 않을 경우, install/update WebView2를 설치하고 다시 시도하십시오. @@ -144,7 +144,7 @@ Windows에서 opencode 데스크톱은 Microsoft Edge ** WebView2 실행 시간 --- -## 알림 표시되지 않음 +## 알림이 표시되지 않음 opencode 데스크톱은 시스템 알림을 보여줍니다 : @@ -153,7 +153,7 @@ opencode 데스크톱은 시스템 알림을 보여줍니다 : --- -## 재설정 데스크톱 앱 스토리지 (마지막 리조트) +## 데스크톱 앱 저장소 재설정 (최후의 수단) 앱이 시작되지 않은 경우 UI 내부에서 설정을 취소할 수 없습니다. 데스크탑 앱의 저장된 상태를 재설정하십시오. @@ -214,7 +214,7 @@ opencode와 문제가 발생하면: --- -#### 모델 사용할 수 없습니다 +#### 모델을 사용할 수 없음 1. 공급자와 정통한 확인 2. config의 모델명을 수정한다. @@ -234,7 +234,7 @@ opencode와 문제가 발생하면: --- -## 공급자InitError +## ProviderInitError ProviderInitError가 발생하면 잘못된 구성이나 손상된 구성이 있습니다. @@ -253,7 +253,7 @@ Windows에서, `WIN+R`를 누르고 삭제하십시오: `%USERPROFILE%\.local\sh --- -### AI APICallError와 공급자 포장 문제점 +### AI_APICallError 및 공급자 패키지 문제 API 호출 오류가 발생하면, 이 공급 업체 패키지로 인해 발생할 수 있습니다. opencode 동적 설치 공급자 패키지 (OpenAI, Anthropic, Google 등) 필요 하 고 로컬로 캐시. @@ -273,7 +273,7 @@ Windows에서, `WIN+R`를 누르고 삭제하십시오: `%USERPROFILE%\.cache\op --- -#### 복사 / Linux에서 작동하지 않음 +#### Linux에서 복사/붙여넣기 작동 안 함 Linux 사용자는 다음과 같은 클립 보드 유틸리티 중 하나가 복사 / 붙여 넣기 기능에 설치해야합니다. diff --git a/packages/web/src/content/docs/ko/tui.mdx b/packages/web/src/content/docs/ko/tui.mdx index 7e16f3151..8717cc785 100644 --- a/packages/web/src/content/docs/ko/tui.mdx +++ b/packages/web/src/content/docs/ko/tui.mdx @@ -1,6 +1,6 @@ --- title: TUI -description: Using the opencode terminal user interface. +description: OpenCode 터미널 사용자 인터페이스 사용. --- import { Tabs, TabItem } from "@astrojs/starlight/components" @@ -69,7 +69,7 @@ opencode TUI를 사용할 때, `/`를 입력하여 명령 이름을 따라 작 --- -### 연결 +### /connect opencode에 대한 공급자를 추가합니다. 사용 가능한 공급자에서 선택하고 API 키를 추가 할 수 있습니다. @@ -79,7 +79,7 @@ opencode에 대한 공급자를 추가합니다. 사용 가능한 공급자에 --- -### 콤팩트 +### /compact 현재 세션을 압축합니다. 앨리스 : `/summarize` @@ -91,7 +91,7 @@ opencode에 대한 공급자를 추가합니다. 사용 가능한 공급자에 --- -### 세부사항 +### /details 토글 툴 실행 세부 사항. @@ -103,7 +103,7 @@ opencode에 대한 공급자를 추가합니다. 사용 가능한 공급자에 --- -### 편집기 +### /editor 메시지를 작성하기 위한 외부 편집기를 엽니다. `EDITOR` 환경에서 설정된 편집기를 사용합니다. [더 알아보기](#editor-setup). @@ -115,7 +115,7 @@ opencode에 대한 공급자를 추가합니다. 사용 가능한 공급자에 --- -### 출구 +### /exit opencode를 종료합니다. Aliases : `/quit`, `/q` @@ -127,7 +127,7 @@ opencode를 종료합니다. Aliases : `/quit`, `/q` --- -### 수출 +### /export Markdown에 대한 현재 대화를 내보내고 기본 편집기에서 열립니다. `EDITOR` 환경에서 설정된 편집기를 사용합니다. [더 알아보기](#editor-setup). @@ -139,7 +139,7 @@ Markdown에 대한 현재 대화를 내보내고 기본 편집기에서 열립 --- -### 도움 +### /help 도움말 대화 상자를 표시합니다. @@ -151,7 +151,7 @@ Markdown에 대한 현재 대화를 내보내고 기본 편집기에서 열립 --- -###### 인 +###### /init `AGENTS.md` 파일을 만들거나 업데이트하십시오. [더 알아보기](/docs/rules). @@ -163,7 +163,7 @@ Markdown에 대한 현재 대화를 내보내고 기본 편집기에서 열립 --- -## 모델 +## /models 사용 가능한 모델 목록. @@ -175,7 +175,7 @@ Markdown에 대한 현재 대화를 내보내고 기본 편집기에서 열립 --- -## 새로운 +## /new 새로운 세션을 시작합니다. 앨리스 : `/clear` @@ -187,7 +187,7 @@ Markdown에 대한 현재 대화를 내보내고 기본 편집기에서 열립 --- -##### 재도 +##### /redo 이전 undone 메시지 Redo. `/undo`를 사용하는 후에만 유효한. @@ -206,7 +206,7 @@ Git 저장소**입니다. --- -## 세션 +## /sessions 세션 간 목록 및 전환. Aliases : `/resume`, `/continue` @@ -230,7 +230,7 @@ Git 저장소**입니다. --- -## 테마 +## /theme 사용할 수 있는 테마 목록. @@ -242,7 +242,7 @@ Git 저장소**입니다. --- -### 생각 +### /thinking 대화의 사고/거주 블록의 가시성을 토합니다. 사용할 때, 확장 된 생각을 지원하는 모델의 이유 프로세스를 볼 수 있습니다. @@ -256,7 +256,7 @@ Git 저장소**입니다. --- -##### 취소 +##### /undo 대화에서 마지막 메시지. 가장 최근의 사용자 메시지, 모든 후속 응답 및 모든 파일 변경 제거. @@ -275,7 +275,7 @@ Git 저장소**입니다. --- -#### 공유 +#### /unshare Unshare 현재 세션. [더 알아보기](/docs/share#un-sharing). @@ -285,7 +285,7 @@ Unshare 현재 세션. [더 알아보기](/docs/share#un-sharing). --- -## 에디터 설정 +## 편집기 설정 `/editor`와 `/export` 명령 모두는 `EDITOR` 환경변수에서 지정된 편집기를 사용합니다. @@ -382,7 +382,7 @@ opencode config 파일을 통해 TUI 동작을 사용자 정의할 수 있습니 --- -#### 사용자 이름 전시 +#### 사용자 이름 표시 사용자 이름이 채팅 메시지에 나타나는지 여부를 수정합니다. 이것을 통해 접근: diff --git a/packages/web/src/content/docs/ko/web.mdx b/packages/web/src/content/docs/ko/web.mdx index d5fb556d5..349ee4d08 100644 --- a/packages/web/src/content/docs/ko/web.mdx +++ b/packages/web/src/content/docs/ko/web.mdx @@ -1,6 +1,6 @@ --- title: Web -description: Using opencode in your browser. +description: 브라우저에서 OpenCode 사용하기. --- opencode는 브라우저에서 웹 응용 프로그램을 실행할 수 있으며 terminal을 필요로하지 않고 동일한 강력한 AI 코딩 경험을 제공합니다. @@ -108,7 +108,7 @@ OPENCODE_SERVER_PASSWORD=secret opencode web --- -## terminal 부착 +## 터미널 연결 실행 웹 서버에 terminal TUI를 연결할 수 있습니다. @@ -124,7 +124,7 @@ opencode attach http://localhost:4096 --- -## Config 파일 +## 구성 파일 `opencode.json` config 파일에서 서버 설정을 구성할 수 있습니다: diff --git a/packages/web/src/content/docs/ko/zen.mdx b/packages/web/src/content/docs/ko/zen.mdx index 3981e1dc5..bf30ccc65 100644 --- a/packages/web/src/content/docs/ko/zen.mdx +++ b/packages/web/src/content/docs/ko/zen.mdx @@ -1,6 +1,6 @@ --- title: Zen -description: Curated list of models provided by opencode. +description: OpenCode가 제공하는 엄선된 모델 목록. --- import config from "../../../../config.mjs" @@ -233,7 +233,7 @@ Admins는 또한 통제의 밑에 비용을 지키는 각 일원을 위한 매 --- -## 자신의 열쇠를 가져옵니다 +## BYOK (Bring Your Own Key) OpenAI 또는 Anthropic API 키를 사용하여 Zen에서 다른 모델에 액세스 할 수 있습니다. diff --git a/packages/web/src/content/docs/nb/acp.mdx b/packages/web/src/content/docs/nb/acp.mdx index 3a217d0fe..23fbd06d2 100644 --- a/packages/web/src/content/docs/nb/acp.mdx +++ b/packages/web/src/content/docs/nb/acp.mdx @@ -1,25 +1,25 @@ --- -title: ACP Støtte +title: ACP-støtte description: Bruk opencode i en hvilken som helst ACP-kompatibel editor. --- -OpenCode støtter [Agent Client Protocol](https://agentclientprotocol.com) eller (ACP), slik at du kan bruke den direkte i kompatible redaktører og IDE-er. +OpenCode støtter [Agent Client Protocol](https://agentclientprotocol.com) eller (ACP), slik at du kan bruke den direkte i kompatible editorer og IDE-er. :::tip -For en liste over redaktører og verktøy som støtter ACP, sjekk ut [ACP fremdriftsrapport](https://zed.dev/blog/acp-progress-report#available-now). +For en liste over editorer og verktøy som støtter ACP, sjekk ut [ACP fremdriftsrapport](https://zed.dev/blog/acp-progress-report#available-now). ::: -ACP er en åpen protokoll som standardiserer kommunikasjon mellom koderedigerere og AI kodeagenter. +ACP er en åpen protokoll som standardiserer kommunikasjon mellom kodeditorer og AI-kodeagenter. --- -## Konfigurer +## Konfigurasjon For å bruke OpenCode via ACP, konfigurer redigeringsprogrammet til å kjøre kommandoen `opencode acp`. -Kommandoen starter OpenCode som en ACP-kompatibel underprosess som kommuniserer med redaktøren din over JSON-RPC via stdio. +Kommandoen starter OpenCode som en ACP-kompatibel underprosess som kommuniserer med editoren din over JSON-RPC via stdio. -Nedenfor er eksempler på populære redaktører som støtter ACP. +Nedenfor er eksempler på populære editorer som støtter ACP. --- diff --git a/packages/web/src/content/docs/nb/agents.mdx b/packages/web/src/content/docs/nb/agents.mdx index eb6d61d8c..d7831e338 100644 --- a/packages/web/src/content/docs/nb/agents.mdx +++ b/packages/web/src/content/docs/nb/agents.mdx @@ -15,7 +15,7 @@ Du kan bytte mellom agenter under en økt eller påkalle dem med `@`-omtalen. ## Typer -Det er to typer agenter i OpenCode; primære agenter og subagenter. +Det er to typer agenter i OpenCode; primære agenter og underagenter. --- @@ -31,21 +31,21 @@ OpenCode kommer med to innebygde primære agenter, **Build** og **Plan**. Vi ser --- -### Subagenter +### Underagenter -Subagenter er spesialiserte assistenter som primære agenter kan påkalle for spesifikke oppgaver. Du kan også starte dem manuelt ved å **@ nevne** dem i meldingene dine. +Underagenter er spesialiserte assistenter som primære agenter kan påkalle for spesifikke oppgaver. Du kan også starte dem manuelt ved å **@ nevne** dem i meldingene dine. -OpenCode kommer med to innebygde subagenter, **General** og **Explore**. Vi skal se på dette nedenfor. +OpenCode kommer med to innebygde underagenter, **General** og **Explore**. Vi skal se på dette nedenfor. --- ## Innebygd -OpenCode kommer med to innebygde primære agenter og to innebygde subagenter. +OpenCode kommer med to innebygde primære agenter og to innebygde underagenter. --- -### Bruk Build +### Bruk av Build _Modus_: `primary` @@ -53,7 +53,7 @@ Build er **standard** primæragent med alle verktøy aktivert. Dette er standard --- -### Bruk Plan +### Bruk av Plan _Modus_: `primary` @@ -67,7 +67,7 @@ Denne agenten er nyttig når du vil at LLM skal analysere kode, foreslå endring --- -### Bruk General +### Bruk av General _Modus_: `subagent` @@ -75,7 +75,7 @@ En generell agent for å undersøke komplekse spørsmål og utføre flertrinnsop --- -### Bruk Explore +### Bruk av Explore _Modus_: `subagent` @@ -83,7 +83,7 @@ En rask, skrivebeskyttet agent for å utforske kodebaser. Kan ikke endre filer. --- -### Bruk Compaction +### Bruk av Compaction _Modus_: `primary` @@ -91,7 +91,7 @@ Skjult systemagent som komprimerer lang kontekst til et mindre sammendrag. Den k --- -### Bruk Title +### Bruk av Title _Modus_: `primary` @@ -99,7 +99,7 @@ Skjult systemagent som genererer korte økttitler. Den kjører automatisk og kan --- -### Bruk Summary +### Bruk av Summary _Modus_: `primary` @@ -111,7 +111,7 @@ Skjult systemagent som lager øktsammendrag. Den kjører automatisk og kan ikke 1. For primære agenter, bruk **Tab**-tasten for å bla gjennom dem under en økt. Du kan også bruke din konfigurerte `switch_agent` nøkkelbinding. -2. Subagenter kan påkalles: +2. Underagenter kan påkalles: - **Automatisk** av primære agenter for spesialiserte oppgaver basert på deres beskrivelser. - Manuelt ved å **@ nevne** en underagent i meldingen. For eksempel. @@ -127,7 +127,7 @@ Skjult systemagent som lager øktsammendrag. Den kjører automatisk og kan ikke --- -## Konfigurer +## Konfigurasjon Du kan tilpasse de innebygde agentene eller lage dine egne gjennom konfigurasjon. Agenter kan konfigureres på to måter: @@ -322,9 +322,9 @@ Sett til `true` for å deaktivere agenten. --- -### Spør +### Ledetekst -Spesifiser en tilpasset systemmeldingsfil for denne agenten med `prompt`-konfigurasjonen. Spørrefilen skal inneholde instruksjoner som er spesifikke for agentens formål. +Spesifiser en tilpasset systemmeldingsfil for denne agenten med `prompt`-konfigurasjonen. Ledetekstfilen skal inneholde instruksjoner som er spesifikke for agentens formål. ```json title="opencode.json" { @@ -616,7 +616,7 @@ Bruk en gyldig sekskantfarge (f.eks. `#FF5733`) eller temafarge: `primary`, `sec --- -### Topp P +### Top P Kontroller responsmangfoldet med alternativet `top_p`. Alternativ til temperatur for å kontrollere tilfeldighet. @@ -634,7 +634,7 @@ Verdiene varierer fra 0,0 til 1,0. Lavere verdier er mer fokuserte, høyere verd --- -### Tillegg +### Ekstra Eventuelle andre alternativer du spesifiserer i agentkonfigurasjonen vil bli **overført direkte** til leverandøren som modellalternativer. Dette lar deg bruke leverandørspesifikke funksjoner og parametere. @@ -661,7 +661,7 @@ Kjør `opencode models` for å se en liste over tilgjengelige modeller. --- -## Opprett agenter +## Opprette agenter Du kan opprette nye agenter ved å bruke følgende kommando: @@ -679,15 +679,15 @@ Denne interaktive kommandoen vil: --- -## Brukstilfeller +## Bruksområder -Her er noen vanlige brukstilfeller for forskjellige agenter. +Her er noen vanlige bruksområder for forskjellige agenter. - **Byggagent**: Fullstendig utviklingsarbeid med alle verktøy aktivert - **Planagent**: Analyse og planlegging uten å gjøre endringer -- **Anmeldelsesagent**: Kodegjennomgang med skrivebeskyttet tilgang pluss dokumentasjonsverktøy +- **Kodevurderingsagent**: Kodegjennomgang med skrivebeskyttet tilgang pluss dokumentasjonsverktøy - **Feilsøkingsagent**: Fokusert på etterforskning med bash og leseverktøy aktivert -- **Docs-agent**: Dokumentasjonsskriving med filoperasjoner, men ingen systemkommandoer +- **Dokumentasjonsagent**: Dokumentasjonsskriving med filoperasjoner, men ingen systemkommandoer --- diff --git a/packages/web/src/content/docs/nb/cli.mdx b/packages/web/src/content/docs/nb/cli.mdx index f86dd0392..2f1b3884e 100644 --- a/packages/web/src/content/docs/nb/cli.mdx +++ b/packages/web/src/content/docs/nb/cli.mdx @@ -1,6 +1,6 @@ --- title: CLI -description: opencode CLI alternativer og kommandoer. +description: OpenCode CLI-alternativer og kommandoer. --- import { Tabs, TabItem } from "@astrojs/starlight/components" @@ -36,7 +36,7 @@ opencode [project] | `--fork` | | Forgren økten ved fortsettelse (bruk med `--continue` eller `--session`) | | `--prompt` | | Ledetekst som skal brukes | | `--model` | `-m` | Modell å bruke i form av leverandør/modell | -| `--agent` | | Agent å bruke | +| `--agent` | | Agent som skal brukes | | `--port` | | Port å lytte på | | `--hostname` | | Vertsnavn å lytte på | @@ -109,7 +109,7 @@ opencode agent list ### auth -Kommando for å administrere legitimasjon og pålogging for leverandører. +Kommando for administrasjon av påloggingsinformasjon og innlogging for leverandører. ```bash opencode auth [command] @@ -125,19 +125,19 @@ OpenCode drives av leverandørlisten på [Models.dev](https://models.dev), så d opencode auth login ``` -Når OpenCode starter opp, laster den leverandørene fra legitimasjonsfilen. Og hvis det er noen nøkler definert i miljøene dine eller en `.env`-fil i prosjektet ditt. +Når OpenCode starter opp, laster den leverandørene fra filen med påloggingsinformasjon. Og hvis det er noen nøkler definert i miljøene dine eller en `.env`-fil i prosjektet ditt. --- #### list -Viser alle de autentiserte leverandørene som er lagret i legitimasjonsfilen. +Viser alle de autentiserte leverandørene som er lagret i filen med påloggingsinformasjon. ```bash opencode auth list ``` -Eller kortversjonen. +Eller bruk kortversjonen. ```bash opencode auth ls @@ -147,7 +147,7 @@ opencode auth ls #### logout -Logger deg ut av en leverandør ved å fjerne den fra legitimasjonsfilen. +Logger deg ut av en leverandør ved å fjerne den fra filen med påloggingsinformasjon. ```bash opencode auth logout @@ -187,10 +187,10 @@ opencode github run ##### Flagg -| Flagg | Beskrivelse | -| --------- | ---------------------------------------- | -| `--event` | GitHub mock-hendelse å kjøre agenten for | -| `--token` | GitHub personlig tilgangstoken | +| Flagg | Beskrivelse | +| --------- | -------------------------------------------- | +| `--event` | GitHub mock-hendelse agenten skal kjøres for | +| `--token` | GitHub personlig tilgangsnøkkel | --- @@ -258,7 +258,7 @@ opencode mcp auth ls #### logout -Fjern OAuth-legitimasjon for en MCP-server. +Fjern OAuth-påloggingsinformasjon for en MCP-server. ```bash opencode mcp logout [name] @@ -323,7 +323,7 @@ Dette er nyttig for skripting, automatisering eller når du vil ha et raskt svar opencode run Explain the use of context in Go ``` -Du kan også koble til en kjørende `opencode serve`-forekomst for å unngå MCP-tjenerkaldoppstartstider ved hver kjøring: +Du kan også koble til en kjørende `opencode serve`-forekomst for å unngå MCP-serveres kaldstarttid ved hver kjøring: ```bash # Start a headless server in one terminal @@ -344,7 +344,7 @@ opencode run --attach http://localhost:4096 "Explain async/await in JavaScript" | `--share` | | Del økten | | `--model` | `-m` | Modell å bruke i form av leverandør/modell | | `--agent` | | Agent å bruke | -| `--file` | `-f` | Fil(er) som skal legges ved melding | +| `--file` | `-f` | Fil(er) som skal legges ved meldingen | | `--format` | | Format: standard (formatert) eller json (rå JSON hendelser) | | `--title` | | Tittel for økten (bruker avkortet ledetekst hvis ingen verdi er oppgitt) | | `--attach` | | Koble til en kjørende OpenCode-server (f.eks. http://localhost:4096) | @@ -354,7 +354,7 @@ opencode run --attach http://localhost:4096 "Explain async/await in JavaScript" ### serve -Start en hodeløs OpenCode-server for API-tilgang. Sjekk ut [server-dokumentene](/docs/server) for hele HTTP-grensesnittet. +Start en headless OpenCode-server for API-tilgang. Sjekk ut [server-dokumentene](/docs/server) for hele HTTP-grensesnittet. ```bash opencode serve @@ -364,12 +364,12 @@ Dette starter en HTTP-server som gir API tilgang til OpenCode-funksjonalitet ute #### Flagg -| Flagg | Beskrivelse | -| ------------ | --------------------------------------------------- | -| `--port` | Port å lytte på | -| `--hostname` | Vertsnavn å lytte på | -| `--mdns` | Aktiver mDNS-oppdagelse | -| `--cors` | Ytterligere nettleseropprinnelse for å tillate CORS | +| Flagg | Beskrivelse | +| ------------ | -------------------------------------------------- | +| `--port` | Port å lytte på | +| `--hostname` | Vertsnavn å lytte på | +| `--mdns` | Aktiver mDNS-oppdagelse | +| `--cors` | Ytterligere nettleseropprinnelse som tillater CORS | --- @@ -450,7 +450,7 @@ opencode import https://opncd.ai/s/abc123 ### web -Start en hodeløs OpenCode-server med et webgrensesnitt. +Start en headless OpenCode-server med et webgrensesnitt. ```bash opencode web @@ -460,12 +460,12 @@ Dette starter en HTTP-server og åpner en nettleser for å få tilgang til OpenC #### Flagg -| Flagg | Beskrivelse | -| ------------ | --------------------------------------------------- | -| `--port` | Port å lytte på | -| `--hostname` | Vertsnavn å lytte på | -| `--mdns` | Aktiver mDNS-oppdagelse | -| `--cors` | Ytterligere nettleseropprinnelse for å tillate CORS | +| Flagg | Beskrivelse | +| ------------ | -------------------------------------------------- | +| `--port` | Port å lytte på | +| `--hostname` | Vertsnavn å lytte på | +| `--mdns` | Aktiver mDNS-oppdagelse | +| `--cors` | Ytterligere nettleseropprinnelse som tillater CORS | --- @@ -582,7 +582,7 @@ OpenCode kan konfigureres ved hjelp av miljøvariabler. --- -### Eksperimentell +### Eksperimentelt Disse miljøvariablene muliggjør eksperimentelle funksjoner som kan endres eller fjernes. @@ -591,8 +591,8 @@ Disse miljøvariablene muliggjør eksperimentelle funksjoner som kan endres elle | `OPENCODE_EXPERIMENTAL` | boolsk | Aktiver alle eksperimentelle funksjoner | | `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | boolsk | Aktiver ikonoppdagelse | | `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | boolsk | Deaktiver kopi ved valg i TUI | -| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | nummer | Standard tidsavbrudd for bash-kommandoer i ms | -| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | nummer | Maks Output Tokens for LLM-svar | +| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | tall | Standard tidsavbrudd for bash-kommandoer i ms | +| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | tall | Maks Output Tokens for LLM-svar | | `OPENCODE_EXPERIMENTAL_FILEWATCHER` | boolsk | Aktiver filovervåker for hele dir | | `OPENCODE_EXPERIMENTAL_OXFMT` | boolsk | Aktiver oxfmt formatter | | `OPENCODE_EXPERIMENTAL_LSP_TOOL` | boolsk | Aktiver eksperimentelt LSP-verktøy | diff --git a/packages/web/src/content/docs/nb/commands.mdx b/packages/web/src/content/docs/nb/commands.mdx index e77cb7763..b4bf8f09f 100644 --- a/packages/web/src/content/docs/nb/commands.mdx +++ b/packages/web/src/content/docs/nb/commands.mdx @@ -40,7 +40,7 @@ Bruk kommandoen ved å skrive `/` etterfulgt av kommandonavnet. --- -## Konfigurer +## Konfigurasjon Du kan legge til egendefinerte kommandoer gjennom OpenCode-konfigurasjonen eller ved å lage markdown-filer i katalogen `commands/`. @@ -102,7 +102,7 @@ deg kjøre: --- -## Ledetekst-konfigurasjon +## Ledetekstkonfigurasjon Ledetekstene for de egendefinerte kommandoene støtter flere spesielle plassholdere og syntaks. @@ -161,7 +161,7 @@ Dette erstatter: --- -### Shell-utgang +### Shell-utdata Bruk _!`command`_ for å injisere [bash-kommando](/docs/tui#bash-commands)-utdata i ledeteksten. @@ -274,9 +274,9 @@ Denne kommandoen vil veilede deg gjennom å lage en ny agent med en tilpasset sy --- -### Subtask +### Underoppgave -Bruk `subtask` boolean for å tvinge kommandoen til å utløse en [subagent](/docs/agents/#subagents) påkalling. +Bruk `subtask` for å tvinge kommandoen til å utløse en [subagent](/docs/agents/#subagents) påkalling. Dette er nyttig hvis du vil at kommandoen ikke skal forurense din primære kontekst og vil **tvinge** agenten til å fungere som en underagent, selv om `mode` er satt til `primary` på [agent](/docs/agents) konfigurasjonen. diff --git a/packages/web/src/content/docs/nb/config.mdx b/packages/web/src/content/docs/nb/config.mdx index 0d90baebd..8f5433579 100644 --- a/packages/web/src/content/docs/nb/config.mdx +++ b/packages/web/src/content/docs/nb/config.mdx @@ -1,5 +1,5 @@ --- -title: Konfig +title: Konfigurasjon description: Ved å bruke opencode JSON-konfigurasjonen. --- @@ -23,7 +23,7 @@ OpenCode støtter både **JSON** og **JSONC** (JSON med kommentarer) formater. --- -## Steder +## Plasseringer Du kan plassere konfigurasjonen på et par forskjellige steder, og de har en annen rekkefølge. @@ -34,16 +34,16 @@ Konfigurasjonsfiler er **slått sammen**, ikke erstattet. Konfigurasjonsfiler slås sammen, ikke erstattes. Innstillinger fra følgende konfigurasjonsplasseringer kombineres. Senere konfigurasjoner overstyrer tidligere kun for motstridende nøkler. Ikke-motstridende innstillinger fra alle konfigurasjoner er bevart. -For eksempel, hvis dine globale konfigurasjonssett `theme: "opencode"` og `autoupdate: true`, og prosjektkonfigurasjonen setter `model: "anthropic/claude-sonnet-4-5"`, vil den endelige konfigurasjonen inkludere alle tre innstillingene. +For eksempel, hvis din globale konfigurasjon setter `theme: "opencode"` og `autoupdate: true`, og prosjektkonfigurasjonen setter `model: "anthropic/claude-sonnet-4-5"`, vil den endelige konfigurasjonen inkludere alle tre innstillingene. --- -### Forrangsrekkefølge +### Prioritetsrekkefølge Konfigurasjonskilder lastes inn i denne rekkefølgen (senere kilder overstyrer tidligere): -1. **Ekstern konfig** (fra `.well-known/opencode`) - organisasjonsstandarder -2. **Global konfig** (`~/.config/opencode/opencode.json`) - brukerinnstillinger +1. **Ekstern konfigurasjon** (fra `.well-known/opencode`) - organisasjonsstandarder +2. **Global konfigurasjon** (`~/.config/opencode/opencode.json`) - brukerinnstillinger 3. **Egendefinert konfigurasjon** (`OPENCODE_CONFIG` env var) - egendefinerte overstyringer 4. **Prosjektkonfigurasjon** (`opencode.json` i prosjekt) - prosjektspesifikke innstillinger 5. **`.opencode` kataloger** - agenter, kommandoer, plugins @@ -52,16 +52,16 @@ Konfigurasjonskilder lastes inn i denne rekkefølgen (senere kilder overstyrer t Dette betyr at prosjektkonfigurasjoner kan overstyre globale standardinnstillinger, og globale konfigurasjoner kan overstyre eksterne organisasjonsstandarder. :::note -`.opencode` og `~/.config/opencode` katalogene bruker **flertallsnavn** for underkataloger: `agents/`, `commands/`, `modes/`, `plugins/`, `skills/`, `tools/` og `themes/`. Enkeltnavn (f.eks. `agent/`) støttes også for bakoverkompatibilitet. +`.opencode` og `~/.config/opencode` katalogene bruker **flertallsnavn** på underkataloger: `agents/`, `commands/`, `modes/`, `plugins/`, `skills/`, `tools/` og `themes/`. Enkeltnavn (f.eks. `agent/`) støttes også for bakoverkompatibilitet. ::: --- -### Ekstern +### Ekstern konfigurasjon -Organisasjoner kan gi standardkonfigurasjon via `.well-known/opencode`-endepunktet. Dette hentes automatisk når du autentiserer med en leverandør som støtter det. +Organisasjoner kan tilby standardkonfigurasjon via `.well-known/opencode`-endepunktet. Dette hentes automatisk når du autentiserer med en leverandør som støtter det. -Ekstern konfigurasjon lastes først, og fungerer som basislaget. Alle andre konfigurasjonskilder (global, prosjekt) kan overstyre disse standardinnstillingene. +Ekstern konfigurasjon lastes først, og fungerer som grunnlaget. Alle andre konfigurasjonskilder (global, prosjekt) kan overstyre disse standardinnstillingene. For eksempel, hvis organisasjonen din tilbyr MCP servere som er deaktivert som standard: @@ -93,9 +93,9 @@ Du kan aktivere spesifikke servere i din lokale konfigurasjon: --- -### Globalt +### Global konfigurasjon -Plasser din globale OpenCode-konfigurasjon i `~/.config/opencode/opencode.json`. Bruk global konfigurasjon for brukeromfattende preferanser som temaer, leverandører eller nøkkelbindinger. +Plasser din globale OpenCode-konfigurasjon i `~/.config/opencode/opencode.json`. Bruk global konfigurasjon for brukerspesifikke preferanser som temaer, leverandører eller nøkkelbindinger. Global konfigurasjon overstyrer eksterne organisasjonsstandarder. @@ -103,7 +103,7 @@ Global konfigurasjon overstyrer eksterne organisasjonsstandarder. ### Per prosjekt -Legg til `opencode.json` i prosjektroten din. Project config har den høyeste prioritet blant standard config-filer - den overstyrer både globale og eksterne konfigurasjoner. +Legg til `opencode.json` i prosjektroten din. Prosjektkonfigurasjon har den høyeste prioritet blant standard config-filer - den overstyrer både globale og eksterne konfigurasjoner. :::tip Plasser prosjektspesifikk konfigurasjon i roten til prosjektet ditt. @@ -111,7 +111,7 @@ Plasser prosjektspesifikk konfigurasjon i roten til prosjektet ditt. Når OpenCode starter opp, ser den etter en konfigurasjonsfil i gjeldende katalog eller går opp til nærmeste Git-katalog. -Dette er også trygt å bli sjekket inn i Git og bruker samme skjema som det globale. +Det er også trygt å sjekke inn dette i Git og bruker samme skjema som det globale. --- @@ -179,7 +179,7 @@ Tilgjengelige alternativer: --- -### Server +### Tjener Du kan konfigurere serverinnstillinger for kommandoene `opencode serve` og `opencode web` gjennom alternativet `server`. @@ -198,7 +198,7 @@ Du kan konfigurere serverinnstillinger for kommandoene `opencode serve` og `open Tilgjengelige alternativer: -- `port` - Port for å lytte på. +- `port` - Port å lytte på. - `hostname` - Vertsnavn å lytte på. Når `mdns` er aktivert og ingen vertsnavn er angitt, er standard `0.0.0.0`. - `mdns` - Aktiver mDNS-tjenesteoppdagelse. Dette lar andre enheter på nettverket oppdage OpenCode-serveren din. - `mdnsDomain` - Egendefinert domenenavn for mDNS-tjeneste. Standard er `opencode.local`. Nyttig for å kjøre flere forekomster på samme nettverk. @@ -239,7 +239,7 @@ Du kan konfigurere leverandørene og modellene du vil bruke i OpenCode-konfigura } ``` -Alternativet `small_model` konfigurerer en egen modell for lette oppgaver som tittelgenerering. Som standard prøver OpenCode å bruke en billigere modell hvis en er tilgjengelig fra leverandøren din, ellers faller den tilbake til hovedmodellen din. +Alternativet `small_model` konfigurerer en egen modell for lette oppgaver som tittelgenerering. Som standard prøver OpenCode å bruke en rimeligere modell hvis en er tilgjengelig fra leverandøren din, ellers faller den tilbake til hovedmodellen din. Leverandøralternativer kan inkludere `timeout` og `setCacheKey`: @@ -257,8 +257,8 @@ Leverandøralternativer kan inkludere `timeout` og `setCacheKey`: } ``` -- `timeout` - Be om tidsavbrudd i millisekunder (standard: 300 000). Sett til `false` for å deaktivere. -- `setCacheKey` - Sørg for at en hurtigbuffernøkkel alltid er angitt for utpekt leverandør. +- `timeout` - Tidsavbrudd for forespørsler i millisekunder (standard: 300 000). Sett til `false` for å deaktivere. +- `setCacheKey` - Sørg for at en hurtigbuffernøkkel alltid settes for valgt leverandør. Du kan også konfigurere [lokale modeller](/docs/models#local). [Finn ut mer](/docs/models). @@ -292,7 +292,7 @@ Amazon Bedrock støtter AWS-spesifikk konfigurasjon: - `endpoint` - Egendefinert endepunkt URL for VPC endepunkter. Dette er et alias for det generiske `baseURL`-alternativet som bruker AWS-spesifikk terminologi. Hvis begge er spesifisert, har `endpoint` forrang. :::note -Bærer-tokens (`AWS_BEARER_TOKEN_BEDROCK` eller `/connect`) har forrang over profilbasert autentisering. Se [godkjenningsprioritet](/docs/providers#authentication-precedence) for detaljer. +Bærer-tokens (`AWS_BEARER_TOKEN_BEDROCK` eller `/connect`) har forrang over profilbasert autentisering. Se [autentiseringsprioritet](/docs/providers#authentication-precedence) for detaljer. ::: [Les mer om konfigurasjon av Amazon Bedrock](/docs/providers#amazon-bedrock). @@ -340,7 +340,7 @@ Du kan også definere agenter ved å bruke markdown-filer i `~/.config/opencode/ --- -### Standard agent +### Standardagent Du kan angi standard agent ved å bruke alternativet `default_agent`. Dette bestemmer hvilken agent som brukes når ingen er eksplisitt spesifisert. @@ -404,9 +404,9 @@ Du kan også definere kommandoer ved å bruke markdown-filer i `~/.config/openco --- -### Nøkkelbindinger +### Tastebindinger -Du kan tilpasse nøkkelbindingene dine gjennom alternativet `keybinds`. +Du kan tilpasse tastebindingene dine gjennom alternativet `keybinds`. ```json title="opencode.json" { @@ -465,7 +465,7 @@ Du kan konfigurere kodeformatere gjennom alternativet `formatter`. Som standard **tillater OpenCode alle operasjoner** uten å kreve eksplisitt godkjenning. Du kan endre dette ved å bruke alternativet `permission`. -For å sikre at verktøyene `edit` og `bash` krever brukergodkjenning: +Slik sikrer du at verktøyene `edit` og `bash` krever brukergodkjenning: ```json title="opencode.json" { @@ -483,7 +483,7 @@ For å sikre at verktøyene `edit` og `bash` krever brukergodkjenning: ### Komprimering -Du kan kontrollere atferden for kontekstkomprimering gjennom alternativet `compaction`. +Du kan styre kontekstkomprimering gjennom alternativet `compaction`. ```json title="opencode.json" { @@ -496,11 +496,11 @@ Du kan kontrollere atferden for kontekstkomprimering gjennom alternativet `compa ``` - `auto` - Komprimer økten automatisk når konteksten er full (standard: `true`). -- `prune` - Fjern gamle verktøyutganger for å lagre tokens (standard: `true`). +- `prune` - Fjern gamle verktøyutdata for å spare tokens (standard: `true`). --- -### Overvåker +### Filovervåker Du kan konfigurere ignoreringsmønstre for filovervåking gjennom alternativet `watcher`. @@ -513,7 +513,7 @@ Du kan konfigurere ignoreringsmønstre for filovervåking gjennom alternativet ` } ``` -Mønstre følger glob-syntaks. Bruk dette for å ekskludere støyende kataloger fra filvisning. +Mønstre følger glob-syntaks. Bruk dette for å ekskludere støyende kataloger fra filovervåking. --- @@ -532,7 +532,7 @@ Du kan konfigurere MCP-servere du vil bruke gjennom alternativet `mcp`. --- -### Plugins +### Utvidelser [Plugins](/docs/plugins) utvider OpenCode med tilpassede verktøy, kroker og integrasjoner. @@ -551,7 +551,7 @@ Plasser plugin-filer i `.opencode/plugins/` eller `~/.config/opencode/plugins/`. ### Instruksjoner -Du kan konfigurere instruksjonene for modellen du bruker gjennom alternativet `instructions`. +Du kan konfigurere instruksjoner for modellen du bruker gjennom alternativet `instructions`. ```json title="opencode.json" { @@ -560,7 +560,7 @@ Du kan konfigurere instruksjonene for modellen du bruker gjennom alternativet `i } ``` -Dette krever en rekke baner og globmønstre til instruksjonsfiler. [Les mer +Dette krever en liste med baner og globmønstre til instruksjonsfiler. [Les mer om regler her](/docs/rules). --- @@ -609,7 +609,7 @@ Hvis en leverandør vises i både `enabled_providers` og `disabled_providers`, h --- -### Eksperimentell +### Eksperimentelt `experimental`-nøkkelen inneholder alternativer som er under aktiv utvikling. @@ -632,7 +632,7 @@ Du kan bruke variabelerstatning i konfigurasjonsfilene dine for å referere til --- -### Env vars +### Miljøvariabler Bruk `{env:VARIABLE_NAME}` for å erstatte miljøvariabler: diff --git a/packages/web/src/content/docs/nb/custom-tools.mdx b/packages/web/src/content/docs/nb/custom-tools.mdx index a3dfa9f8b..0b88f7507 100644 --- a/packages/web/src/content/docs/nb/custom-tools.mdx +++ b/packages/web/src/content/docs/nb/custom-tools.mdx @@ -3,7 +3,7 @@ title: Egendefinerte verktøy description: Lag verktøy som LLM kan kalle inn OpenCode. --- -Egendefinerte verktøy er funksjoner du oppretter som LLM kan ringe under samtaler. De fungerer sammen med OpenCode sine [innebygde verktøy](/docs/tools) som `read`, `write` og `bash`. +Egendefinerte verktøy er funksjoner du oppretter som LLM kan kalle under samtaler. De fungerer sammen med OpenCode sine [innebygde verktøy](/docs/tools) som `read`, `write` og `bash`. --- @@ -47,7 +47,7 @@ export default tool({ #### Flere verktøy per fil -Du kan også eksportere flere verktøy fra en enkelt fil. Hver eksport blir **et eget verktøy** med navnet **`_`**: +Du kan også eksportere flere verktøy fra en enkelt fil. Hver eksport blir **et separat verktøy** med navnet **`_`**: ```ts title=".opencode/tools/math.ts" import { tool } from "@opencode-ai/plugin" @@ -127,13 +127,13 @@ export default tool({ ``` Bruk `context.directory` for øktens arbeidskatalog. -Bruk `context.worktree` for git-arbeidstreroten. +Bruk `context.worktree` for git-arbeidstreet. --- ## Eksempler -### Skriv et verktøy i Python +### Skrive et verktøy i Python Du kan skrive verktøyene dine på hvilket som helst språk du vil. Her er et eksempel som legger til to tall ved hjelp av Python. diff --git a/packages/web/src/content/docs/nb/ecosystem.mdx b/packages/web/src/content/docs/nb/ecosystem.mdx index 0890fbc08..714a9ee95 100644 --- a/packages/web/src/content/docs/nb/ecosystem.mdx +++ b/packages/web/src/content/docs/nb/ecosystem.mdx @@ -13,25 +13,25 @@ Du kan også sjekke ut [awesome-opencode](https://github.com/awesome-opencode/aw --- -## Plugins +## Utvidelser | Navn | Beskrivelse | | --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | -| [opencode-daytona](https://github.com/jamesmurdza/daytona/blob/main/guides/typescript/opencode/README.md) | Kjør OpenCode-økter automatisk i isolerte Daytona-sandkasser med git-synkronisering og live forhåndsvisninger | -| [opencode-helicone-session](https://github.com/H2Shami/opencode-helicone-session) | Injiser automatisk Helicone-økthoder for forespørselsgruppering | +| [opencode-daytona](https://github.com/jamesmurdza/daytona/blob/main/guides/typescript/opencode/README.md) | Kjør OpenCode-økter automatisk i isolerte Daytona-sandkasser med git-synkronisering og live-forhåndsvisninger | +| [opencode-helicone-session](https://github.com/H2Shami/opencode-helicone-session) | Injiser automatisk Helicone-headers for forespørselsgruppering | | [opencode-type-inject](https://github.com/nick-vi/opencode-type-inject) | Auto-injiser TypeScript/Svelte-typer i fillesninger med oppslagsverktøy | | [opencode-openai-codex-auth](https://github.com/numman-ali/opencode-openai-codex-auth) | Bruk ChatGPT Plus/Pro-abonnementet ditt i stedet for API kreditter | | [opencode-gemini-auth](https://github.com/jenslys/opencode-gemini-auth) | Bruk din eksisterende Gemini-plan i stedet for API-fakturering | -| [opencode-antigravity-auth](https://github.com/NoeFabris/opencode-antigravity-auth) | Bruk Antigravitys gratis modeller i stedet for API fakturering | +| [opencode-antigravity-auth](https://github.com/NoeFabris/opencode-antigravity-auth) | Bruk Antigravitys gratis modeller i stedet for API-fakturering | | [opencode-devcontainers](https://github.com/athal7/opencode-devcontainers) | Multi-branch devcontainer-isolasjon med grunne kloner og automatisk tildelte porter | | [opencode-google-antigravity-auth](https://github.com/shekohex/opencode-google-antigravity-auth) | Google Antigravity OAuth-plugin, med støtte for Google Søk og mer robust API-håndtering | | [opencode-dynamic-context-pruning](https://github.com/Tarquinen/opencode-dynamic-context-pruning) | Optimaliser bruken av token ved å beskjære utdaterte verktøy | -| [opencode-websearch-cited](https://github.com/ghoulr/opencode-websearch-cited.git) | Legg til innebygd nettsøk-støtte for støttede leverandører med Googles jordet stil | -| [opencode-pty](https://github.com/shekohex/opencode-pty.git) | Gjør det mulig for AI-agenter å kjøre bakgrunnsprosesser i en PTY, sende interaktive input til dem. | -| [opencode-shell-strategy](https://github.com/JRedeker/opencode-shell-strategy) | Instruksjoner for ikke-interaktive shell-kommandoer - forhindrer heng fra TTY-avhengige operasjoner | +| [opencode-websearch-cited](https://github.com/ghoulr/opencode-websearch-cited.git) | Legg til innebygd støtte for nettsøk for støttede leverandører med Googles kildebaserte stil | +| [opencode-pty](https://github.com/shekohex/opencode-pty.git) | Gjør det mulig for AI-agenter å kjøre bakgrunnsprosesser i en PTY, sende interaktiv inndata til dem. | +| [opencode-shell-strategy](https://github.com/JRedeker/opencode-shell-strategy) | Instruksjoner for ikke-interaktive skallkommandoer - forhindrer heng ved TTY-avhengige operasjoner | | [opencode-wakatime](https://github.com/angristan/opencode-wakatime) | Spor OpenCode-bruk med Wakatime | -| [opencode-md-table-formatter](https://github.com/franlol/opencode-md-table-formatter/tree/main) | Rydd opp avslagstabeller produsert av LLMs | -| [opencode-morph-fast-apply](https://github.com/JRedeker/opencode-morph-fast-apply) | 10 ganger raskere koderedigering med Morph Fast Apply API og lazy redigeringsmarkører | +| [opencode-md-table-formatter](https://github.com/franlol/opencode-md-table-formatter/tree/main) | Rydd opp i markdown-tabeller produsert av LLMs | +| [opencode-morph-fast-apply](https://github.com/JRedeker/opencode-morph-fast-apply) | 10 ganger raskere koderedigering med Morph Fast Apply API og lazy-redigeringsmarkører | | [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) | Bakgrunnsagenter, forhåndsbygde LSP/AST/MCP verktøy, kurerte agenter, Claude Code-kompatibel | | [opencode-notificator](https://github.com/panta82/opencode-notificator) | Skrivebordsvarsler og lydvarsler for OpenCode-økter | | [opencode-notifier](https://github.com/mohak34/opencode-notifier) | Skrivebordsvarsler og lydvarsler for tillatelse, fullføring og feilhendelser | @@ -45,7 +45,7 @@ Du kan også sjekke ut [awesome-opencode](https://github.com/awesome-opencode/aw | [octto](https://github.com/vtemian/octto) | Interaktiv nettleser UI for AI idédugnad med flerspørsmålsskjemaer | | [opencode-background-agents](https://github.com/kdcokenny/opencode-background-agents) | Claude Bakgrunnsagenter i kodestil med asynkrondelegering og kontekstutholdenhet | | [opencode-notify](https://github.com/kdcokenny/opencode-notify) | Innfødte OS-varsler for OpenCode – vet når oppgaver fullføres | -| [opencode-workspace](https://github.com/kdcokenny/opencode-workspace) | Medfølgende multi-agent orkestreringssele – 16 komponenter, én installasjon | +| [opencode-workspace](https://github.com/kdcokenny/opencode-workspace) | Medfølgende multi-agent orkestreringsrammeverk – 16 komponenter, én installasjon | | [opencode-worktree](https://github.com/kdcokenny/opencode-worktree) | Nullfriksjon git-arbeidstre for OpenCode | --- @@ -55,7 +55,7 @@ Du kan også sjekke ut [awesome-opencode](https://github.com/awesome-opencode/aw | Navn | Beskrivelse | | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------- | | [kimaki](https://github.com/remorses/kimaki) | Discord-bot for å kontrollere OpenCode-økter, bygget på SDK | -| [opencode.nvim](https://github.com/NickvanDyke/opencode.nvim) | Neovim-plugin for redaktørbevisste meldinger, bygget på API | +| [opencode.nvim](https://github.com/NickvanDyke/opencode.nvim) | Neovim-plugin for editor-tilpassede meldinger, bygget på API | | [portal](https://github.com/hosenur/portal) | Mobile-first web UI for OpenCode over Tailscale/VPN | | [opencode plugin template](https://github.com/zenobi-us/opencode-plugin-template/) | Mal for å bygge OpenCode-plugins | | [opencode.nvim](https://github.com/sudo-tee/opencode.nvim) | Neovim-grensesnitt for OpenCode - en terminalbasert AI-kodingsagent | diff --git a/packages/web/src/content/docs/nb/enterprise.mdx b/packages/web/src/content/docs/nb/enterprise.mdx index 09f253b0c..eef0d7e98 100644 --- a/packages/web/src/content/docs/nb/enterprise.mdx +++ b/packages/web/src/content/docs/nb/enterprise.mdx @@ -1,5 +1,5 @@ --- -title: Enterprise +title: Bedrift description: Sikker bruk av opencode i din organisasjon. --- @@ -19,7 +19,7 @@ For å komme i gang med OpenCode Enterprise: --- -## Prøve +## Prøveversjon OpenCode er åpen kildekode og lagrer ingen av koden eller kontekstdataene dine, så utviklerne dine kan ganske enkelt [komme i gang](/docs/) og utføre en prøveversjon. @@ -36,7 +36,7 @@ Det eneste forbeholdet her er den valgfrie `/share`-funksjonen. --- -#### Deler samtaler +#### Deling av samtaler Hvis en bruker aktiverer funksjonen `/share`, sendes samtalen og dataene knyttet til den til tjenesten vi bruker til å være vert for disse delesidene på opencode.ai. @@ -75,7 +75,7 @@ prissetting og implementeringsalternativer. --- -### Sentral konfig +### Sentral konfigurasjon Vi kan sette opp OpenCode for å bruke en enkelt sentral konfigurasjon for hele organisasjonen din. @@ -83,7 +83,7 @@ Denne sentraliserte konfigurasjonen kan integreres med SSO-leverandøren din og --- -### SSO integrasjon +### SSO-integrasjon Gjennom den sentrale konfigurasjonen kan OpenCode integreres med organisasjonens SSO-leverandør for autentisering. @@ -91,7 +91,7 @@ Dette lar OpenCode få legitimasjon for din interne AI-gateway gjennom ditt eksi --- -### Intern AI gateway +### Intern AI-gateway Med den sentrale konfigurasjonen kan OpenCode også konfigureres til kun å bruke din interne AI-gateway. @@ -99,7 +99,7 @@ Du kan også deaktivere alle andre AI-leverandører, og sikre at alle forespørs --- -### Selvhosting +### Egen hosting Selv om vi anbefaler å deaktivere delingssidene for å sikre at dataene dine aldri forsvinner organisasjonen din, kan vi også hjelpe deg med å være vert for dem på din infrastruktur. @@ -108,7 +108,7 @@ Dette er nå på veikartet vårt. Hvis du er interessert, **gi o --- -## FAQ +## Ofte stilte spørsmål (FAQ)
Hva er OpenCode Enterprise? @@ -120,7 +120,7 @@ OpenCode Enterprise er for organisasjoner som ønsker å sikre at deres kode og
Hvordan kommer jeg i gang med OpenCode Enterprise? -Bare start med en intern prøveversjon med teamet ditt. OpenCode lagrer som standard ikke koden eller kontekstdataene dine, noe som gjør det enkelt å komme i gang. +Bare sett i gang en intern prøveversjon med teamet ditt. OpenCode lagrer som standard ikke koden eller kontekstdataene dine, noe som gjør det enkelt å komme i gang. Så **kontakt oss** for å diskutere priser og implementeringsalternativer. @@ -129,7 +129,7 @@ Så **kontakt oss** for å diskutere priser og implementerin
Hvordan fungerer bedriftsprising? -Vi tilbyr bedriftspriser per sete. Hvis du har din egen LLM-gateway, tar vi ikke betalt for tokens som brukes. For ytterligere detaljer, **kontakt oss** for et tilpasset tilbud basert på organisasjonens behov. +Vi tilbyr bedriftspriser per bruker. Hvis du har din egen LLM-gateway, tar vi ikke betalt for tokens som brukes. For ytterligere detaljer, **kontakt oss** for et tilpasset tilbud basert på organisasjonens behov.
@@ -143,7 +143,7 @@ Ja. OpenCode lagrer ikke koden eller kontekstdataene dine. All behandling skjer
Kan vi bruke vårt eget private NPM-register? -OpenCode støtter private npm-registre gjennom Buns innebygde `.npmrc`-filstøtte. Hvis organisasjonen din bruker et privat register, som JFrog Artifactory, Nexus eller lignende, sørg for at utviklerne er autentisert før du kjører OpenCode. +OpenCode støtter private npm-registre gjennom Bun sin innebygde støtte for .npmrc-filer. Hvis organisasjonen din bruker et privat register, som JFrog Artifactory, Nexus eller lignende, sørg for at utviklerne er autentisert før du kjører OpenCode. Slik setter du opp autentisering med ditt private register: diff --git a/packages/web/src/content/docs/nb/formatters.mdx b/packages/web/src/content/docs/nb/formatters.mdx index d26cc1971..b9fe99a44 100644 --- a/packages/web/src/content/docs/nb/formatters.mdx +++ b/packages/web/src/content/docs/nb/formatters.mdx @@ -1,42 +1,42 @@ --- -title: Formatere -description: opencode bruker språkspesifikke formatere. +title: Formattere +description: OpenCode bruker språkspesifikke formattere. --- -OpenCode formaterer automatisk filer etter at de er skrevet eller redigert ved hjelp av språkspesifikke formatere. Dette sikrer at koden som genereres følger kodestilene til prosjektet ditt. +OpenCode formaterer automatisk filer etter at de er skrevet eller redigert ved hjelp av språkspesifikke formattere. Dette sikrer at koden som genereres følger kodestilene til prosjektet ditt. --- -## Innebygd +## Innebygde formattere -OpenCode kommer med flere innebygde formatere for populære språk og rammeverk. Nedenfor er en liste over formatere, støttede filutvidelser og kommandoer eller konfigurasjonsalternativer den trenger. +OpenCode kommer med flere innebygde formattere for populære språk og rammeverk. Nedenfor er en liste over formattere, støttede filendelser og kommandoer eller konfigurasjonsalternativer den krever. -| Formater | Utvidelser | Krav | -| ---------------------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | -| gofmt | .go | `gofmt` kommando tilgjengelig | -| mix | .ex, .exs, .eex, .heex, .leex, .neex, .sface | `mix` kommando tilgjengelig | -| prettier | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml og [mer](https://prettier.io/docs/en/index.html) | `prettier` avhengighet i `package.json` | -| biome | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml og [mer](https://biomejs.dev/) | `biome.json(c)` konfigurasjonsfil | -| zig | .zig, .zon | `zig` kommando tilgjengelig | -| clang-format | .c, .cpp, .h, .hpp, .ino og [mer](https://clang.llvm.org/docs/ClangFormat.html) | `.clang-format` konfigurasjonsfil | -| ktlint | .kt, .kts | `ktlint` kommando tilgjengelig | -| ruff | .py, .pyi | `ruff` kommando tilgjengelig med config | -| rustfmt | .rs | `rustfmt` kommando tilgjengelig | -| cargofmt | .rs | `cargo fmt` kommando tilgjengelig | -| uv | .py, .pyi | `uv` kommando tilgjengelig | -| rubocop | .rb, .rake, .gemspec, .ru | `rubocop` kommando tilgjengelig | -| standardrb | .rb, .rake, .gemspec, .ru | `standardrb` kommando tilgjengelig | -| htmlbeautifier | .erb, .html.erb | `htmlbeautifier` kommando tilgjengelig | -| air | .R | `air` kommando tilgjengelig | -| dart | .dart | `dart` kommando tilgjengelig | -| ocamlformat | .ml, .mli | `ocamlformat` kommando tilgjengelig og `.ocamlformat` konfigurasjonsfil | -| terraform | .tf, .tfvars | `terraform` kommando tilgjengelig | -| gleam | .gleam | `gleam` kommando tilgjengelig | -| nixfmt | .nix | `nixfmt` kommando tilgjengelig | -| shfmt | .sh, .bash | `shfmt` kommando tilgjengelig | -| pint | .php | `laravel/pint` avhengighet i `composer.json` | -| oxfmt (Eksperimentell) | .js, .jsx, .ts, .tsx | `oxfmt` avhengighet i `package.json` og et [eksperimentelt env variabel flagg](/docs/cli/#experimental) | -| ormolu | .hs | `ormolu` kommando tilgjengelig | +| Formatter | Filendelser | Krav | +| ---------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | +| gofmt | .go | `gofmt` kommando tilgjengelig | +| mix | .ex, .exs, .eex, .heex, .leex, .neex, .sface | `mix` kommando tilgjengelig | +| prettier | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml og [flere](https://prettier.io/docs/en/index.html) | `prettier` avhengighet i `package.json` | +| biome | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml og [flere](https://biomejs.dev/) | `biome.json(c)` konfigurasjonsfil | +| zig | .zig, .zon | `zig` kommando tilgjengelig | +| clang-format | .c, .cpp, .h, .hpp, .ino og [flere](https://clang.llvm.org/docs/ClangFormat.html) | `.clang-format` konfigurasjonsfil | +| ktlint | .kt, .kts | `ktlint` kommando tilgjengelig | +| ruff | .py, .pyi | `ruff` kommando tilgjengelig med config | +| rustfmt | .rs | `rustfmt` kommando tilgjengelig | +| cargofmt | .rs | `cargo fmt` kommando tilgjengelig | +| uv | .py, .pyi | `uv` kommando tilgjengelig | +| rubocop | .rb, .rake, .gemspec, .ru | `rubocop` kommando tilgjengelig | +| standardrb | .rb, .rake, .gemspec, .ru | `standardrb` kommando tilgjengelig | +| htmlbeautifier | .erb, .html.erb | `htmlbeautifier` kommando tilgjengelig | +| air | .R | `air` kommando tilgjengelig | +| dart | .dart | `dart` kommando tilgjengelig | +| ocamlformat | .ml, .mli | `ocamlformat` kommando tilgjengelig og `.ocamlformat` konfigurasjonsfil | +| terraform | .tf, .tfvars | `terraform` kommando tilgjengelig | +| gleam | .gleam | `gleam` kommando tilgjengelig | +| nixfmt | .nix | `nixfmt` kommando tilgjengelig | +| shfmt | .sh, .bash | `shfmt` kommando tilgjengelig | +| pint | .php | `laravel/pint` avhengighet i `composer.json` | +| oxfmt (Eksperimentell) | .js, .jsx, .ts, .tsx | `oxfmt` avhengighet i `package.json` og et [eksperimentelt env variabel flagg](/docs/cli/#experimental) | +| ormolu | .hs | `ormolu` kommando tilgjengelig | Så hvis prosjektet ditt har `prettier` i `package.json`, vil OpenCode automatisk bruke det. @@ -46,7 +46,7 @@ Så hvis prosjektet ditt har `prettier` i `package.json`, vil OpenCode automatis Når OpenCode skriver eller redigerer en fil, gjør den: -1. Kontrollerer filtypen mot alle aktiverte formatere. +1. Kontrollerer filtypen mot alle aktiverte formattere. 2. Kjører riktig formateringskommando på filen. 3. Bruker formateringsendringene automatisk. @@ -54,9 +54,9 @@ Denne prosessen skjer i bakgrunnen, og sikrer at kodestilene dine opprettholdes --- -## Konfigurer +## Konfigurasjon -Du kan tilpasse formatere gjennom `formatter`-delen i OpenCode-konfigurasjonen. +Du kan tilpasse formattere gjennom `formatter`-delen i OpenCode-konfigurasjonen. ```json title="opencode.json" { @@ -67,20 +67,20 @@ Du kan tilpasse formatere gjennom `formatter`-delen i OpenCode-konfigurasjonen. Hver formateringskonfigurasjon støtter følgende: -| Property | Type | Beskrivelse | -| ------------- | -------- | ----------------------------------------------------------------- | -| `disabled` | boolean | Sett dette til `true` for å deaktivere formatereren | -| `command` | string[] | Kommandoen som skal kjøres for formatering | -| `environment` | object | Miljøvariabler som skal angis når du kjører formateringsverktøyet | -| `extensions` | string[] | Filutvidelser denne formatereren skal håndtere | +| Egenskap | Type | Beskrivelse | +| ------------- | -------- | --------------------------------------------------------------- | +| `disabled` | boolean | Sett dette til `true` for å deaktivere formatteren | +| `command` | string[] | Kommandoen som skal kjøres for formatering | +| `environment` | object | Miljøvariabler som skal settes når formateringsverktøyet kjøres | +| `extensions` | string[] | Filendelser denne formatteren skal håndtere | La oss se på noen eksempler. --- -### Deaktivering av formatere +### Deaktivering av formattere -For å deaktivere **alle** formatere globalt, sett `formatter` til `false`: +For å deaktivere **alle** formattere globalt, sett `formatter` til `false`: ```json title="opencode.json" {3} { @@ -89,7 +89,7 @@ For å deaktivere **alle** formatere globalt, sett `formatter` til `false`: } ``` -For å deaktivere en **spesifikk** formatering, sett `disabled` til `true`: +For å deaktivere en **spesifikk** formatter, sett `disabled` til `true`: ```json title="opencode.json" {5} { @@ -104,9 +104,9 @@ For å deaktivere en **spesifikk** formatering, sett `disabled` til `true`: --- -### Egendefinerte formatere +### Egendefinerte formattere -Du kan overstyre de innebygde formaterne eller legge til nye ved å spesifisere kommandoen, miljøvariablene og filtypene: +Du kan overstyre de innebygde formatterne eller legge til nye ved å spesifisere kommandoen, miljøvariablene og filtypene: ```json title="opencode.json" {4-14} { @@ -127,4 +127,4 @@ Du kan overstyre de innebygde formaterne eller legge til nye ved å spesifisere } ``` -**`$FILE` plassholderen** i kommandoen vil bli erstattet med banen til filen som formateres. +**Plassholderen $FILE** i kommandoen vil bli erstattet med banen til filen som formateres. diff --git a/packages/web/src/content/docs/nb/github.mdx b/packages/web/src/content/docs/nb/github.mdx index 8c3a8c9be..4a39c8830 100644 --- a/packages/web/src/content/docs/nb/github.mdx +++ b/packages/web/src/content/docs/nb/github.mdx @@ -9,25 +9,25 @@ OpenCode integreres med GitHub-arbeidsflyten din. Nevn `/opencode` eller `/oc` i ## Funksjoner -- **Triage-problemer**: Be OpenCode se på et problem og forklare det for deg. -- **Fiks og implementer**: Be OpenCode om å fikse et problem eller implementere en funksjon. Og den vil fungere i en ny gren og sender inn en PR med alle endringene. -- **Sikkert**: OpenCode kjører inne i GitHubs løpere. +- **Triage saker**: Be OpenCode se på en sak og forklare den for deg. +- **Fiks og implementer**: Be OpenCode om å fikse en sak eller implementere en funksjon. Den vil jobbe i en ny gren og sende inn en PR med alle endringene. +- **Sikkert**: OpenCode kjører i GitHub-runners. --- ## Installasjon -Kjør følgende kommando i et prosjekt som er i en GitHub-repo: +Kjør følgende kommando i et prosjekt som er et GitHub-repo: ```bash opencode github install ``` -Dette vil lede deg gjennom å installere GitHub-appen, lage arbeidsflyten og sette opp hemmeligheter. +Dette vil lede deg gjennom å installere GitHub-appen, lage arbeidsflyten og sette opp secrets (hemmeligheter). --- -### Manuell oppsett +### Manuelt oppsett Eller du kan sette den opp manuelt. @@ -37,7 +37,7 @@ Eller du kan sette den opp manuelt. 2. **Legg til arbeidsflyten** - Legg til følgende arbeidsflytfil til `.github/workflows/opencode.yml` i repoen. Sørg for å sette riktige `model` og nødvendige API nøkler i `env`. + Legg til følgende arbeidsflytfil til `.github/workflows/opencode.yml` i repoen. Sørg for å sette riktig `model` og nødvendige API-nøkler i `env`. ```yml title=".github/workflows/opencode.yml" {24,26} name: opencode @@ -75,7 +75,7 @@ Eller du kan sette den opp manuelt. 3. **Lagre API-nøklene i hemmeligheter** - Utvid **Hemmeligheter og variabler** til venstre i **innstillingene** for organisasjonen eller prosjektet og velg **Handlinger**. Og legg til de nødvendige API-nøklene. + Utvid **Hemmeligheter og variabler** til venstre i **innstillingene** for organisasjonen eller prosjektet og velg **Actions**. Og legg til de nødvendige API-nøklene. --- @@ -85,7 +85,7 @@ Eller du kan sette den opp manuelt. - `agent`: Agenten som skal brukes. Må være en primær agent. Faller tilbake til `default_agent` fra config eller `"build"` hvis ikke funnet. - `share`: Om OpenCode-økten skal deles. Standard er **true** for offentlige depoter. - `prompt`: Valgfri egendefinert melding for å overstyre standard oppførsel. Bruk dette til å tilpasse hvordan OpenCode behandler forespørsler. -- `token`: Valgfritt GitHub-tilgangstoken for å utføre operasjoner som å lage kommentarer, foreta endringer og åpne pull-forespørsler. Som standard bruker OpenCode installasjonstilgangstokenet fra OpenCode GitHub-appen, så forpliktelser, kommentarer og pull-forespørsler ser ut til å komme fra appen. +- `token`: Valgfritt GitHub-tilgangstoken for å utføre operasjoner som å lage kommentarer, foreta endringer og åpne pull-forespørsler. Som standard bruker OpenCode installasjonstilgangstokenet fra OpenCode GitHub-appen, så commits, kommentarer og pull-forespørsler ser ut til å komme fra appen. Alternativt kan du bruke GitHub Action-løperens [innebygde `GITHUB_TOKEN`](https://docs.github.com/en/actions/tutorials/authenticate-with-github_token) uten å installere OpenCode GitHub-appen. Bare sørg for å gi de nødvendige tillatelsene i arbeidsflyten din: @@ -107,14 +107,14 @@ OpenCode kan utløses av følgende GitHub-hendelser: | Hendelsestype | Utløst av | Detaljer | | ----------------------------- | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | -| `issue_comment` | Kommenter et problem eller PR | Nevn `/opencode` eller `/oc` i kommentaren din. OpenCode leser kontekst og kan opprette grener, åpne PR-er eller svare. | +| `issue_comment` | Kommentar på sak eller PR | Nevn `/opencode` eller `/oc` i kommentaren din. OpenCode leser kontekst og kan opprette grener, åpne PR-er eller svare. | | `pull_request_review_comment` | Kommenter spesifikke kodelinjer i en PR | Nevn `/opencode` eller `/oc` mens du ser gjennom koden. OpenCode mottar filbane, linjenummer og diff-kontekst. | -| `issues` | Utgave åpnet eller redigert | Utløs OpenCode automatisk når problemer opprettes eller endres. Krever `prompt` inngang. | +| `issues` | Sak åpnet eller redigert | Utløs OpenCode automatisk når saker opprettes eller endres. Krever `prompt` inngang. | | `pull_request` | PR åpnet eller oppdatert | Utløs OpenCode automatisk når PR-er åpnes, synkroniseres eller gjenåpnes. Nyttig for automatiserte anmeldelser. | -| `schedule` | Cron-basert tidsplan | Kjør OpenCode etter en tidsplan. Krever `prompt` inngang. Utdata går til logger og PR (ingen problem å kommentere). | +| `schedule` | Cron-basert tidsplan | Kjør OpenCode etter en tidsplan. Krever `prompt` inngang. Utdata går til logger og PR (ingen sak å kommentere). | | `workflow_dispatch` | Manuell utløser fra GitHub UI | Utløs OpenCode på forespørsel via fanen Handlinger. Krever `prompt` inngang. Utdata går til logger og PR-er. | -### Tidsplan Eksempel +### Eksempel på tidsplan Kjør OpenCode på en tidsplan for å utføre automatiserte oppgaver: @@ -150,11 +150,11 @@ jobs: If you find issues worth addressing, open an issue to track them. ``` -For planlagte arrangementer er `prompt`-inngangen **påkrevd** siden det ikke er noen kommentarer å trekke ut instruksjoner fra. Planlagte arbeidsflyter kjører uten brukerkontekst for tillatelsessjekking, så arbeidsflyten må gi `contents: write` og `pull-requests: write` hvis du forventer at OpenCode oppretter grener eller PR-er. +For planlagte arrangementer er `prompt`-inngangen **påkrevd** siden det ikke er noen kommentarer å trekke ut instruksjoner fra. Planlagte workflows kjører uten brukerkontekst for tillatelsessjekking, så arbeidsflyten må gi `contents: write` og `pull-requests: write` hvis du forventer at OpenCode oppretter grener eller PR-er. --- -### Pull Request Eksempel +### Eksempel på Pull Request Gjennomgå PR-er automatisk når de åpnes eller oppdateres: @@ -191,13 +191,13 @@ jobs: - Suggest improvements ``` -For `pull_request`-hendelser, hvis ingen `prompt` er oppgitt, går OpenCode som standard gjennom pull-forespørselen. +For `pull_request`-hendelser, hvis ingen `prompt` er oppgitt, går OpenCode som standard gjennom PR-en. --- -### Issues Triage Eksempel +### Eksempel på triage av saker -Triage automatisk nye problemer. Dette eksemplet filtrerer til kontoer eldre enn 30 dager for å redusere spam: +Automatisk triage av nye saker. Dette eksemplet filtrerer til kontoer eldre enn 30 dager for å redusere spam: ```yaml title=".github/workflows/opencode-triage.yml" name: Issue Triage @@ -250,9 +250,9 @@ For `issues`-hendelser er `prompt`-inngangen **påkrevd** siden det ikke er noen --- -## Egendefinerte ledetekster +## Egendefinerte prompter -Overstyr standardledeteksten for å tilpasse oppførselen til OpenCode for arbeidsflyten din. +Overstyr standardprompten for å tilpasse oppførselen til OpenCode for arbeidsflyten din. ```yaml title=".github/workflows/opencode.yml" - uses: anomalyco/opencode/github@latest @@ -277,9 +277,9 @@ Her er noen eksempler på hvordan du kan bruke OpenCode i GitHub. Du kan konfigurere til å bruke en annen triggerfrase enn `@opencode`. ::: -- **Forklar et problem** +- **Forklar en sak (issue)** - Legg til denne kommentaren i en GitHub-utgave. + Legg til denne kommentaren i en GitHub-sak. ``` /opencode explain this issue @@ -287,9 +287,9 @@ Du kan konfigurere til å bruke en annen triggerfrase enn `@opencode`. OpenCode vil lese hele tråden, inkludert alle kommentarer, og svare med en tydelig forklaring. -- **Fiks et problem** +- **Fiks en sak** - I en GitHub-utgave, si: + I en GitHub-sak, si: ``` /opencode fix this @@ -297,7 +297,7 @@ Du kan konfigurere til å bruke en annen triggerfrase enn `@opencode`. Og OpenCode vil opprette en ny gren, implementere endringene og åpne en PR med endringene. -- **Gjennomgå PR-er og gjør endringer** +- **Se gjennom PR-er og gjør endringer** Legg igjen følgende kommentar på en GitHub PR. @@ -305,9 +305,9 @@ Du kan konfigurere til å bruke en annen triggerfrase enn `@opencode`. Delete the attachment from S3 when the note is removed /oc ``` - OpenCode vil implementere den forespurte endringen og forplikte den til samme PR. + OpenCode vil implementere den forespurte endringen og committe den til samme PR. -- **Se gjennom spesifikke kodelinjer** +- **Review av spesifikke kodelinjer** Legg igjen en kommentar direkte på kodelinjer i PRs "Filer"-fane. OpenCode oppdager automatisk filen, linjenumrene og diff-konteksten for å gi presise svar. diff --git a/packages/web/src/content/docs/nb/gitlab.mdx b/packages/web/src/content/docs/nb/gitlab.mdx index dd0077c81..2fc34a3e8 100644 --- a/packages/web/src/content/docs/nb/gitlab.mdx +++ b/packages/web/src/content/docs/nb/gitlab.mdx @@ -1,17 +1,17 @@ --- title: GitLab -description: Bruk opencode i GitLab-problemer og sammenslåingsforespørsler. +description: Bruk opencode i GitLab-problemer og Merge Requests. --- OpenCode integreres med GitLab arbeidsflyten gjennom GitLab CI/CD pipeline eller med GitLab Duo. -I begge tilfeller vil OpenCode kjøre på GitLab-løperne dine. +I begge tilfeller vil OpenCode kjøre på GitLab Runners. --- ## GitLab CI -OpenCode fungerer i en vanlig GitLab-pipeline. Du kan bygge den inn i en pipeline som en [CI komponent](https://docs.gitlab.com/ee/ci/components/) +OpenCode fungerer i en vanlig GitLab-pipeline. Du kan bygge den inn i en pipeline som en [CI-komponent](https://docs.gitlab.com/ee/ci/components/) Her bruker vi en fellesskapsskapt CI/CD-komponent for OpenCode — [nagyv/gitlab-opencode](https://gitlab.com/nagyv/gitlab-opencode). @@ -27,7 +27,7 @@ Her bruker vi en fellesskapsskapt CI/CD-komponent for OpenCode — [nagyv/gitlab ### Oppsett -1. Lagre OpenCode-autentiseringen JSON som en filtype CI miljøvariabler under **Innstillinger** > **CI/CD** > **Variabler**. Sørg for å merke dem som "Masket og skjult". +1. Lagre OpenCode sin autentiserings-JSON som en CI-miljøvariabel av typen Fil under **Innstillinger** > **CI/CD** > **Variabler**. Sørg for å merke dem som "Masked and hidden". 2. Legg til følgende i `.gitlab-ci.yml`-filen. ```yaml title=".gitlab-ci.yml" @@ -47,16 +47,16 @@ For flere inndata og brukstilfeller [sjekk ut dokumentene](https://gitlab.com/ex ## GitLab Duo OpenCode integreres med din GitLab arbeidsflyt. -Nevn `@opencode` i en kommentar, og OpenCode vil utføre oppgaver innenfor din GitLab CI pipeline. +Nevn `@opencode` i en kommentar, og OpenCode vil utføre oppgaver innenfor din GitLab CI-pipeline. --- ### Funksjoner -- **Triage-problemer**: Be OpenCode se på et problem og forklare det for deg. -- **Fiks og implementer**: Be OpenCode om å fikse et problem eller implementere en funksjon. - Det vil opprette en ny gren og sende en sammenslåingsforespørsel med endringene. -- **Sikkert**: OpenCode kjører på GitLab-løperne dine. +- **Triage av saker**: Be OpenCode se på en sak og forklare den for deg. +- **Fiks og implementer**: Be OpenCode om å fikse en sak eller implementere en funksjon. + Det vil opprette en ny gren og sende en Merge Request med endringene. +- **Sikkert**: OpenCode kjører på GitLab Runners. --- @@ -164,7 +164,7 @@ Her er noen eksempler på hvordan du kan bruke OpenCode i GitLab. Du kan konfigurere til å bruke en annen triggerfrase enn `@opencode`. ::: -- **Forklar et problem** +- **Forklar en sak** Legg til denne kommentaren i en GitLab-sak. @@ -172,9 +172,9 @@ Du kan konfigurere til å bruke en annen triggerfrase enn `@opencode`. @opencode explain this issue ``` - OpenCode vil lese problemet og svare med en klar forklaring. + OpenCode vil lese saken og svare med en klar forklaring. -- **Fiks et problem** +- **Fiks en sak** I en GitLab-sak, si: @@ -182,14 +182,14 @@ Du kan konfigurere til å bruke en annen triggerfrase enn `@opencode`. @opencode fix this ``` - OpenCode vil opprette en ny gren, implementere endringene og åpne en sammenslåingsforespørsel med endringene. + OpenCode vil opprette en ny gren, implementere endringene og åpne en Merge Request med endringene. -- **Gjennomgå sammenslåingsforespørsler** +- **Review av Merge Requests** - Legg igjen følgende kommentar på en GitLab-sammenslåingsforespørsel. + Legg igjen følgende kommentar på en GitLab Merge Request. ``` @opencode review this merge request ``` - OpenCode vil gjennomgå sammenslåingsforespørselen og gi tilbakemelding. + OpenCode vil gjennomgå Merge Request-en og gi tilbakemelding. diff --git a/packages/web/src/content/docs/nb/ide.mdx b/packages/web/src/content/docs/nb/ide.mdx index 002bf7ee6..76b1ce166 100644 --- a/packages/web/src/content/docs/nb/ide.mdx +++ b/packages/web/src/content/docs/nb/ide.mdx @@ -12,13 +12,13 @@ OpenCode integreres med VS Code, Cursor eller en hvilken som helst IDE som støt - **Hurtigstart**: Bruk `Cmd+Esc` (Mac) eller `Ctrl+Esc` (Windows/Linux) for å åpne OpenCode i en delt terminalvisning, eller fokuser en eksisterende terminaløkt hvis en allerede kjører. - **Ny økt**: Bruk `Cmd+Shift+Esc` (Mac) eller `Ctrl+Shift+Esc` (Windows/Linux) for å starte en ny OpenCode-terminaløkt, selv om en allerede er åpen. Du kan også klikke på OpenCode-knappen i UI. - **Kontekstbevissthet**: Del automatisk ditt nåværende valg eller fane med OpenCode. -- **Snarveier for filreferanse**: Bruk `Cmd+Option+K` (Mac) eller `Alt+Ctrl+K` (Linux/Windows) for å sette inn filreferanser. For eksempel `@File#L37-42`. +- **Snarveier for filreferanser**: Bruk `Cmd+Option+K` (Mac) eller `Alt+Ctrl+K` (Linux/Windows) for å sette inn filreferanser. For eksempel `@File#L37-42`. --- ## Installasjon -For å installere OpenCode på VS Code og populære forgreninger som Cursor, Windsurf, VSCodium: +For å installere OpenCode på VS Code og populære varianter som Cursor, Windsurf, VSCodium: 1. Åpne VS Code 2. Åpne den integrerte terminalen diff --git a/packages/web/src/content/docs/nb/index.mdx b/packages/web/src/content/docs/nb/index.mdx index 85b4a4e6e..b10662537 100644 --- a/packages/web/src/content/docs/nb/index.mdx +++ b/packages/web/src/content/docs/nb/index.mdx @@ -1,5 +1,5 @@ --- -title: Intro +title: Introduksjon description: Kom i gang med OpenCode. --- @@ -29,7 +29,7 @@ For å bruke OpenCode i terminalen din trenger du: --- -## Installer +## Installasjon Den enkleste måten å installere OpenCode på er gjennom installasjonsskriptet. @@ -123,21 +123,20 @@ For den beste opplevelsen på Windows anbefaler vi å bruke [Windows Subsystem f docker run -it --rm ghcr.io/anomalyco/opencode ``` -Støtte for å installere OpenCode på Windows med Bun pågår for øyeblikket. +Støtte for installasjon av OpenCode på Windows med Bun er under arbeid. Du kan også hente binæren fra [Releases](https://github.com/anomalyco/opencode/releases). --- -## Konfigurer +## Konfigurasjon Med OpenCode kan du bruke hvilken som helst LLM-leverandør ved å konfigurere deres API-nøkler. -Hvis du er ny til å bruke LLM-leverandører, anbefaler vi å bruke [OpenCode Zen](/docs/zen). -Det er en kuratert liste over modeller som har blitt testet og verifisert av OpenCode -team. +Hvis du er ukjent med LLM-leverandører, anbefaler vi å bruke [OpenCode Zen](/docs/zen). +Det er en kuratert liste over modeller som har blitt testet og verifisert av OpenCode-teamet. -1. Kjør kommandoen `/connect` i TUI, velg opencode og gå til [opencode.ai/auth](https://opencode.ai/auth). +1. Kjør kommandoen `/connect` i TUI, velg OpenCode og gå til [opencode.ai/auth](https://opencode.ai/auth). ```txt /connect @@ -158,7 +157,7 @@ Alternativt kan du velge en av de andre leverandørene. [Finn ut mer](/docs/prov --- -## Initialiser +## Initialisering Nå som du har konfigurert en leverandør, kan du navigere til et prosjekt som du vil jobbe med. @@ -196,8 +195,8 @@ brukt. Du er nå klar til å bruke OpenCode for å jobbe med prosjektet ditt. Spør det gjerne noe! -Hvis du er ny til å bruke en AI kodeagent, her er noen eksempler som kan -hjelp. +Hvis du er ukjent med AI-kodeagenter, her er noen eksempler som kan +hjelpe. --- @@ -217,14 +216,14 @@ Dette er nyttig hvis det er en del av kodebasen du ikke har jobbet med. --- -### Legg til funksjoner +### Legg til funksjonalitet Du kan be OpenCode legge til nye funksjoner i prosjektet ditt. Selv om vi først anbefaler å be den om å lage en plan. 1. **Lag en plan** - OpenCode har en _Plan-modus_ som deaktiverer evnen til å gjøre endringer og - foreslå i stedet _hvordan_ det vil implementere funksjonen. + OpenCode har en _Plan-modus_ som deaktiverer muligheten til å gjøre endringer og + foreslår i stedet _hvordan_ den vil implementere funksjonen. Bytt til den ved å bruke **Tab**-tasten. Du vil se en indikator for dette i nedre høyre hjørne. @@ -240,17 +239,17 @@ Du kan be OpenCode legge til nye funksjoner i prosjektet ditt. Selv om vi først From this screen, the user can undelete a note or permanently delete it. ``` - Du vil gi OpenCode nok detaljer til å forstå hva du ønsker. Det hjelper + Du bør gi OpenCode nok detaljer til å forstå hva du ønsker. Det hjelper å snakke med det som om du snakker med en juniorutvikler på laget ditt. :::tip - Gi OpenCode mye kontekst og eksempler for å hjelpe den å forstå hva du gjør + Gi OpenCode mye kontekst og eksempler for å hjelpe den å forstå hva du ønsker. ::: -2. **Gjenta på planen** +2. **Iterer på planen** - Når den gir deg en plan, kan du gi den tilbakemelding eller legge til flere detaljer. + Når du får en plan, kan du gi den tilbakemelding eller legge til flere detaljer. ```txt frame="none" We'd like to design this new screen using a design I've used before. @@ -266,14 +265,14 @@ Du kan be OpenCode legge til nye funksjoner i prosjektet ditt. Selv om vi først 3. **Bygg funksjonen** - Når du føler deg komfortabel med planen, bytt tilbake til _Byggemodus_ av + Når du føler deg komfortabel med planen, bytt tilbake til _Byggemodus_ ved å trykke på **Tab**-tasten igjen. ```bash frame="none" ``` - Og ber den om å gjøre endringene. + Og be den om å gjøre endringene. ```bash frame="none" Sounds good! Go ahead and make the changes. @@ -283,7 +282,7 @@ Du kan be OpenCode legge til nye funksjoner i prosjektet ditt. Selv om vi først ### Gjør endringer -For mer enkle endringer kan du be OpenCode om å bygge den direkte +For mer enkle endringer kan du be OpenCode om å bygge det direkte uten å måtte gjennomgå planen først. ```txt frame="none" "@packages/functions/src/settings.ts" "@packages/functions/src/notes.ts" @@ -292,8 +291,8 @@ handled in the /notes route in @packages/functions/src/notes.ts and implement the same logic in @packages/functions/src/settings.ts ``` -Du vil sørge for at du gir en god mengde detaljer, slik at OpenCode gjør det rette -endringer. +Sørg for å gi nok detaljer, slik at OpenCode gjør de rette +endringene. --- @@ -333,7 +332,7 @@ Eller du **kan gjøre om** endringene ved å bruke `/redo`-kommandoen. --- -## Del +## Deling Samtalene du har med OpenCode kan [deles med din team](/docs/share). @@ -352,8 +351,8 @@ Her er en [eksempelsamtale](https://opencode.ai/s/4XP1fce5) med OpenCode. --- -## Tilpass +## Tilpasning Og det er det! Du er nå en proff på å bruke OpenCode. -For å gjøre det til ditt eget anbefaler vi å [velge et tema](/docs/themes), [tilpasse nøkkelbindingene](/docs/keybinds), [konfigurere kodeformatere](/docs/formatters), [opprette egendefinerte kommandoer](/docs/commands) eller leke med [OpenCode-konfigurasjonen](/docs/config). +For å tilpasse det anbefaler vi å [velge et tema](/docs/themes), [tilpasse tastebindingene](/docs/keybinds), [konfigurere kodeformattere](/docs/formatters), [opprette egendefinerte kommandoer](/docs/commands) eller leke med [OpenCode-konfigurasjonen](/docs/config). diff --git a/packages/web/src/content/docs/nb/keybinds.mdx b/packages/web/src/content/docs/nb/keybinds.mdx index 25d15de55..d762a647f 100644 --- a/packages/web/src/content/docs/nb/keybinds.mdx +++ b/packages/web/src/content/docs/nb/keybinds.mdx @@ -1,9 +1,9 @@ --- -title: Keybinds +title: Tastebindinger description: Tilpass tastebindingene dine. --- -OpenCode har en liste over nøkkelbindinger som du kan tilpasse gjennom OpenCode-konfigurasjonen. +OpenCode har en liste over tastebindinger som du kan tilpasse gjennom OpenCode-konfigurasjonen. ```json title="opencode.json" { @@ -105,19 +105,19 @@ OpenCode har en liste over nøkkelbindinger som du kan tilpasse gjennom OpenCode --- -## Ledertast +## Leader-tast -OpenCode bruker en `leader`-nøkkel for de fleste nøkkelbindinger. Dette unngår konflikter i terminalen din. +OpenCode bruker en `leader`-tast for de fleste tastebindinger. Dette unngår konflikter i terminalen din. Som standard er `ctrl+x` ledertasten, og de fleste handlinger krever at du først trykker på ledertasten og deretter snarveien. For å starte en ny økt, trykker du for eksempel først `ctrl+x` og deretter `n`. -Du trenger ikke å bruke en ledernøkkel for tastebindingene dine, men vi anbefaler at du gjør det. +Du trenger ikke å bruke en ledertast for tastebindingene dine, men vi anbefaler at du gjør det. --- -## Deaktiver tastebinding +## Deaktivering av tastebindinger -Du kan deaktivere en nøkkelbinding ved å legge til nøkkelen til konfigurasjonen med verdien "ingen". +Du kan deaktivere en tastebinding ved å legge til tasten til konfigurasjonen med verdien "none". ```json title="opencode.json" { @@ -130,9 +130,9 @@ Du kan deaktivere en nøkkelbinding ved å legge til nøkkelen til konfigurasjon --- -## Snarveier på skrivebordet +## Snarveier i skrivebordsappen -Ledetekstinngangen for OpenCode-skrivebordsappen støtter vanlige snarveier i Readline/Emacs-stil for redigering av tekst. Disse er innebygd og foreløpig ikke konfigurerbare via `opencode.json`. +Prompt-feltet for OpenCode-skrivebordsappen støtter vanlige snarveier i Readline/Emacs-stil for redigering av tekst. Disse er innebygd og foreløpig ikke konfigurerbare via `opencode.json`. | Snarvei | Handling | | -------- | ---------------------------------------- | @@ -147,14 +147,14 @@ Ledetekstinngangen for OpenCode-skrivebordsappen støtter vanlige snarveier i Re | `ctrl+u` | Slett til starten av linjen | | `ctrl+w` | Slett forrige ord | | `alt+d` | Slett neste ord | -| `ctrl+t` | Transponere tegn | +| `ctrl+t` | Bytt om tegn | | `ctrl+g` | Avbryt popovers / avbryt kjøring av svar | --- ## Shift+Enter -Noen terminaler sender ikke modifikasjonsnøkler med Enter som standard. Du må kanskje konfigurere terminalen til å sende `Shift+Enter` som en escape-sekvens. +Noen terminaler sender ikke modifikasjonstaster med Enter som standard. Du må kanskje konfigurere terminalen til å sende `Shift+Enter` som en escape-sekvens. ### Windows Terminal diff --git a/packages/web/src/content/docs/nb/lsp.mdx b/packages/web/src/content/docs/nb/lsp.mdx index 384710652..c52b79a32 100644 --- a/packages/web/src/content/docs/nb/lsp.mdx +++ b/packages/web/src/content/docs/nb/lsp.mdx @@ -1,5 +1,5 @@ --- -title: LSP Servere +title: LSP-servere description: opencode integreres med LSP-serverne dine. --- @@ -7,15 +7,15 @@ OpenCode integreres med din Language Server Protocol (LSP) for å hjelpe LLM med --- -## Innebygd +## Innebygde servere OpenCode kommer med flere innebygde LSP-servere for populære språk: -| LSP Server | Utvidelser | Krav | +| LSP Server | Filendelser | Krav | | ------------------ | ------------------------------------------------------------------- | ----------------------------------------------------------------------- | -| astro | .astro | Autoinstallasjoner for Astro-prosjekter | -| bash | .sh, .bash, .zsh, .ksh | Autoinstallerer bash-language-server | -| clangd | .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++ | Autoinstallasjoner for C/C++-prosjekter | +| astro | .astro | Installeres automatisk for Astro-prosjekter | +| bash | .sh, .bash, .zsh, .ksh | Installerer bash-language-server automatisk | +| clangd | .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++ | Installeres automatisk for C/C++-prosjekter | | csharp | .cs | `.NET SDK` installert | | clojure-lsp | .clj, .cljs, .cljc, .edn | `clojure-lsp` kommando tilgjengelig | | dart | .dart | `dart` kommando tilgjengelig | @@ -27,23 +27,23 @@ OpenCode kommer med flere innebygde LSP-servere for populære språk: | gopls | .go | `go` kommando tilgjengelig | | hls | .hs, .lhs | `haskell-language-server-wrapper` kommando tilgjengelig | | jdtls | .java | `Java SDK (version 21+)` installert | -| kotlin-ls | .kt, .kts | Autoinstallasjoner for Kotlin-prosjekter | -| lua-ls | .lua | Autoinstallasjoner for Lua-prosjekter | +| kotlin-ls | .kt, .kts | Installeres automatisk for Kotlin-prosjekter | +| lua-ls | .lua | Installeres automatisk for Lua-prosjekter | | nixd | .nix | `nixd` kommando tilgjengelig | | ocaml-lsp | .ml, .mli | `ocamllsp` kommando tilgjengelig | | oxlint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte | `oxlint` avhengighet i prosjekt | -| php intelephense | .php | Autoinstallasjoner for PHP-prosjekter | +| php intelephense | .php | Installeres automatisk for PHP-prosjekter | | prisma | .prisma | `prisma` kommando tilgjengelig | | pyright | .py, .pyi | `pyright` avhengighet installert | | ruby-lsp (rubocop) | .rb, .rake, .gemspec, .ru | `ruby` og `gem` kommandoer tilgjengelig | | rust | .rs | `rust-analyzer` kommando tilgjengelig | | sourcekit-lsp | .swift, .objc, .objcpp | `swift` installert (`xcode` på macOS) | -| svelte | .svelte | Autoinstallasjoner for Svelte-prosjekter | -| terraform | .tf, .tfvars | Automatiske installasjoner fra GitHub-utgivelser | -| tinymist | .typ, .typc | Automatiske installasjoner fra GitHub-utgivelser | +| svelte | .svelte | Installeres automatisk for Svelte-prosjekter | +| terraform | .tf, .tfvars | Installeres automatisk fra GitHub-utgivelser | +| tinymist | .typ, .typc | Installeres automatisk fra GitHub-utgivelser | | typescript | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts | `typescript` avhengighet i prosjekt | -| vue | .vue | Autoinstallasjoner for Vue-prosjekter | -| yaml-ls | .yaml, .yml | Autoinstallerer Red Hat yaml-language-server | +| vue | .vue | Installeres automatisk for Vue-prosjekter | +| yaml-ls | .yaml, .yml | Installerer Red Hat yaml-language-server automatisk | | zls | .zig, .zon | `zig` kommando tilgjengelig | LSP-servere aktiveres automatisk når en av filtypene ovenfor oppdages og kravene oppfylles. @@ -54,7 +54,7 @@ Du kan deaktivere automatiske LSP-servernedlastinger ved å sette miljøvariabel --- -## Hvordan det fungerer +## Slik fungerer det Når opencode åpner en fil, gjør den: @@ -63,7 +63,7 @@ Når opencode åpner en fil, gjør den: --- -## Konfigurer +## Konfigurasjon Du kan tilpasse LSP-servere gjennom `lsp`-delen i OpenCode-konfigurasjonen. @@ -76,11 +76,11 @@ Du kan tilpasse LSP-servere gjennom `lsp`-delen i OpenCode-konfigurasjonen. Hver LSP-server støtter følgende: -| Property | Type | Beskrivelse | +| Egenskap | Type | Beskrivelse | | ---------------- | -------- | -------------------------------------------------------- | | `disabled` | boolean | Sett dette til `true` for å deaktivere LSP-serveren | | `command` | string[] | Kommandoen for å starte LSP-serveren | -| `extensions` | string[] | Filutvidelser denne LSP-serveren skal håndtere | +| `extensions` | string[] | Filendelser denne LSP-serveren skal håndtere | | `env` | object | Miljøvariabler som skal angis når serveren startes | | `initialization` | object | Initialiseringsalternativer for å sende til LSP-serveren | @@ -132,9 +132,9 @@ Initialiseringsalternativer varierer etter LSP-server. Sjekk dokumentasjonen til --- -### Deaktiverer LSP-servere +### Deaktivering av LSP-servere -For å deaktivere **alle** LSP servere globalt, sett `lsp` til `false`: +For å deaktivere **alle** LSP-servere globalt, sett `lsp` til `false`: ```json title="opencode.json" {3} { diff --git a/packages/web/src/content/docs/nb/mcp-servers.mdx b/packages/web/src/content/docs/nb/mcp-servers.mdx index dfb3e1ad5..c7908eb98 100644 --- a/packages/web/src/content/docs/nb/mcp-servers.mdx +++ b/packages/web/src/content/docs/nb/mcp-servers.mdx @@ -1,5 +1,5 @@ --- -title: MCP servere +title: MCP-servere description: Legg til lokale og eksterne MCP-verktøy. --- @@ -14,16 +14,16 @@ Når de er lagt til, er MCP-verktøy automatisk tilgjengelige for LLM sammen med Når du bruker en MCP-server, legger den til konteksten. Dette kan fort gå opp hvis du har mange verktøy. Så vi anbefaler å være forsiktig med hvilke MCP-servere du bruker. :::tip -MCP servere legger til konteksten din, så du vil være forsiktig med hvilke du aktiverer. +MCP-servere legger til konteksten din, så du vil være forsiktig med hvilke du aktiverer. ::: Enkelte MCP-servere, som GitHub MCP-serveren, har en tendens til å legge til mange tokens og kan lett overskride kontekstgrensen. --- -## Aktiver +## Aktivering -Du kan definere MCP-servere i [OpenCode Config](https://opencode.ai/docs/config/) under `mcp`. Legg til hver MCP med et unikt navn. Du kan referere til den MCP ved navn når du ber om LLM. +Du kan definere MCP-servere i [OpenCode Config](https://opencode.ai/docs/config/) under `mcp`. Legg til hver MCP med et unikt navn. Du kan referere til den MCP ved navn når du spør LLM-en. ```jsonc title="opencode.jsonc" {6} { @@ -44,7 +44,7 @@ Du kan også deaktivere en server ved å sette `enabled` til `false`. Dette er n --- -### Overstyrer fjernstandarder +### Overstyring av fjernstandarder Organisasjoner kan tilby standard MCP-servere via deres `.well-known/opencode`-endepunkt. Disse serverne kan være deaktivert som standard, slik at brukere kan melde seg på de de trenger. @@ -104,7 +104,7 @@ For eksempel, her er hvordan du kan legge til test [`@modelcontextprotocol/serve } ``` -Og for å bruke den kan jeg legge til `use the mcp_everything tool` i ledetekstene mine. +Og for å bruke den kan du legge til `use the mcp_everything tool` i ledetekstene mine. ```txt "mcp_everything" use the mcp_everything tool to add the number 3 and 4 @@ -146,7 +146,7 @@ Legg til eksterne MCP-servere ved å sette `type` til `"remote"`. } ``` -`url` er URL til den eksterne MCP serveren og med alternativet `headers` kan du sende inn en liste over overskrifter. +`url` er URL til den eksterne MCP serveren og med alternativet `headers` kan du sende inn en liste over headere. --- @@ -157,7 +157,7 @@ Legg til eksterne MCP-servere ved å sette `type` til `"remote"`. | `type` | String | Y | Type MCP servertilkobling, må være `"remote"`. | | `url` | String | Y | URL av den eksterne MCP-serveren. | | `enabled` | Boolean | | Aktiver eller deaktiver MCP-serveren ved oppstart. | -| `headers` | Object | | Overskrifter å sende med forespørselen. | +| `headers` | Object | | Headere å sende med forespørselen. | | `oauth` | Object | | OAuth-autentiseringskonfigurasjon. Se delen [OAuth](#oauth) nedenfor. | | `timeout` | Number | | Tidsavbrudd i ms for henting av verktøy fra MCP-serveren. Standard er 5000 (5 sekunder). | @@ -216,7 +216,7 @@ Hvis du har klientlegitimasjon fra MCP-serverleverandøren, kan du konfigurere d --- -### Autentiserer +### Autentisering Du kan utløse autentisering manuelt eller administrere legitimasjon. @@ -242,7 +242,7 @@ Kommandoen `mcp auth` åpner nettleseren din for autorisasjon. Etter at du har g --- -#### Deaktiverer OAuth +#### Deaktivering av OAuth Hvis du vil deaktivere automatisk OAuth for en server (f.eks. for servere som bruker API-nøkler i stedet), setter du `oauth` til `false`: @@ -289,7 +289,7 @@ Kommandoen `mcp debug` viser gjeldende autentiseringsstatus, tester HTTP-tilkobl --- -## Administrer +## Administrering MCP-ene dine er tilgjengelige som verktøy i OpenCode, sammen med innebygde verktøy. Så du kan administrere dem gjennom OpenCode-konfigurasjonen som alle andre verktøy. @@ -433,7 +433,7 @@ Show me the latest unresolved issues in my project. use sentry --- -### Kontekst7 +### Context7 Legg til [Context7 MCP-serveren](https://github.com/upstash/context7) for å søke gjennom dokumenter. @@ -509,3 +509,116 @@ Alternativt kan du legge til noe slikt til din [AGENTS.md](/docs/rules/). ```md title="AGENTS.md" If you are unsure how to do something, use `gh_grep` to search code examples from GitHub. ``` + +--- + +### Helicone + +[Helicone](https://helicone.ai) er en LLM observerbarhetsplattform som gir logging, overvåking og analyser for AI-applikasjonene dine. Helicone AI Gateway ruter forespørslene dine til riktig leverandør automatisk basert på modellen. + +1. Gå over til [Helicone](https://helicone.ai), opprett en konto og generer en API nøkkel fra dashbordet. + +2. Kjør kommandoen `/connect` og søk etter **Helicone**. + + ```txt + /connect + ``` + +3. Skriv inn Helicone API-nøkkelen. + + ```txt + ┌ API key + │ + │ + └ enter + ``` + +4. Kjør kommandoen `/models` for å velge en modell. + + ```txt + /models + ``` + +For flere leverandører og avanserte funksjoner som bufring og hastighetsbegrensning, sjekk [Helicone-dokumentasjonen](https://docs.helicone.ai). + +#### Valgfrie konfigurasjoner + +I tilfelle du ser en funksjon eller modell fra Helicone som ikke konfigureres automatisk gjennom OpenCode, kan du alltid konfigurere den selv. + +Her er [Helicone's Model Directory](https://helicone.ai/models), du trenger denne for å hente ID-ene til modellene du vil legge til. + +```jsonc title="~/.config/opencode/opencode.jsonc" +{ + "$schema": "https://opencode.ai/config.json", + "provider": { + "helicone": { + "npm": "@ai-sdk/openai-compatible", + "name": "Helicone", + "options": { + "baseURL": "https://ai-gateway.helicone.ai", + }, + "models": { + "gpt-4o": { + // Model ID (from Helicone's model directory page) + "name": "GPT-4o", // Your own custom name for the model + }, + "claude-sonnet-4-20250514": { + "name": "Claude Sonnet 4", + }, + }, + }, + }, +} +``` + +#### Egendefinerte headere + +Helicone støtter tilpassede headere for funksjoner som bufring, brukersporing og øktadministrasjon. Legg dem til leverandørkonfigurasjonen din ved å bruke `options.headers`: + +```jsonc title="~/.config/opencode/opencode.jsonc" +{ + "$schema": "https://opencode.ai/config.json", + "provider": { + "helicone": { + "npm": "@ai-sdk/openai-compatible", + "name": "Helicone", + "options": { + "baseURL": "https://ai-gateway.helicone.ai", + "headers": { + "Helicone-Cache-Enabled": "true", + "Helicone-User-Id": "opencode", + }, + }, + }, + }, +} +``` + +##### Sesjonssporing + +Helicones [Sessions](https://docs.helicone.ai/features/sessions) funksjon lar deg gruppere relaterte LLM forespørsler sammen. Bruk [opencode-helicone-session](https://github.com/H2Shami/opencode-helicone-session) plugin for automatisk å logge hver OpenCode-samtale som en økt i Helicone. + +```bash +npm install -g opencode-helicone-session +``` + +Legg den til i konfigurasjonen din. + +```json title="opencode.json" +{ + "plugin": ["opencode-helicone-session"] +} +``` + +Programtillegget injiserer `Helicone-Session-Id` og `Helicone-Session-Name` overskrifter i forespørslene dine. På Helicones Sessions-side vil du se hver OpenCode-samtale oppført som en separat økt. + +##### Vanlige Helicone-headere + +| Overskrift | Beskrivelse | +| -------------------------- | -------------------------------------------------------------------------- | +| `Helicone-Cache-Enabled` | Aktiver responsbufring (`true`/`false`) | +| `Helicone-User-Id` | Spor beregninger etter bruker | +| `Helicone-Property-[Name]` | Legg til egendefinerte egenskaper (f.eks. `Helicone-Property-Environment`) | +| `Helicone-Prompt-Id` | Knytt forespørsler til spørsmålsversjoner | + +Se [Helicone Header Directory](https://docs.helicone.ai/helicone-headers/header-directory) for alle tilgjengelige overskrifter. diff --git a/packages/web/src/content/docs/nb/models.mdx b/packages/web/src/content/docs/nb/models.mdx index fe48ce370..fe53d9661 100644 --- a/packages/web/src/content/docs/nb/models.mdx +++ b/packages/web/src/content/docs/nb/models.mdx @@ -15,7 +15,7 @@ Finn ut mer om [leverandører](/docs/providers). --- -## Velg en modell +## Velge en modell Når du har konfigurert leverandøren din, kan du velge modellen du ønsker ved å skrive inn: @@ -195,13 +195,13 @@ Du kan overstyre eksisterende varianter eller legge til dine egne: } ``` -### Syklusvarianter +### Bytt varianter Bruk tastebindingen `variant_cycle` for raskt å bytte mellom varianter. [Finn ut mer](/docs/keybinds). --- -## Laster modeller +## Lasting av modeller Når OpenCode starter opp, ser den etter modeller i følgende prioriterte rekkefølge: diff --git a/packages/web/src/content/docs/nb/modes.mdx b/packages/web/src/content/docs/nb/modes.mdx index b3c159bb9..0322f0693 100644 --- a/packages/web/src/content/docs/nb/modes.mdx +++ b/packages/web/src/content/docs/nb/modes.mdx @@ -1,31 +1,23 @@ --- -title: Modi +title: Moduser description: Ulike moduser for forskjellige brukstilfeller. --- :::caution -Modi er nå konfigurert gjennom alternativet `agent` i OpenCode-konfigurasjonen. De +Moduser er nå konfigurert gjennom alternativet `agent` i OpenCode-konfigurasjonen. De Alternativet `mode` er nå utdatert. [Finn ut mer](/docs/agents). ::: -Moduser i OpenCode lar deg tilpasse oppførselen, verktøyene og ledetekstene for ulike brukstilfeller. +Moduser i OpenCode lar deg tilpasse oppførselen, verktøyene og prompter for ulike brukstilfeller. Den kommer med to innebygde moduser: **bygg** og **plan**. Du kan tilpasse disse eller konfigurer din egen gjennom OpenCode-konfigurasjonen. -Du kan bytte mellom moduser under en økt eller konfigurere dem i konfigurasjonsfilen. - ---- - -## Innebygd - -OpenCode kommer med to innebygde moduser. - --- ### Bygg -Bygg er **standard**-modus med alle verktøy aktivert. Dette er standardmodusen for utviklingsarbeid der du trenger full tilgang til filoperasjoner og systemkommandoer. +Bygg er **standard**-modusen med alle verktøy aktivert. Dette er standardmodusen for utviklingsarbeid der du trenger full tilgang til filoperasjoner og systemkommandoer. --- @@ -42,99 +34,9 @@ Denne modusen er nyttig når du vil at AI skal analysere kode, foreslå endringe --- -## Bytte - -Du kan bytte mellom moduser under en økt ved å bruke _Tab_-tasten. Eller din konfigurerte `switch_mode` nøkkelbinding. - -Se også: [Formatters](/docs/formatters) for informasjon om konfigurasjon av kodeformatering. - ---- - -## Konfigurer - -Du kan tilpasse de innebygde modusene eller lage dine egne gjennom konfigurasjon. Modi kan konfigureres på to måter: - -### JSON Konfigurasjon - -Konfigurer moduser i konfigurasjonsfilen `opencode.json`: - -```json title="opencode.json" -{ - "$schema": "https://opencode.ai/config.json", - "mode": { - "build": { - "model": "anthropic/claude-sonnet-4-20250514", - "prompt": "{file:./prompts/build.txt}", - "tools": { - "write": true, - "edit": true, - "bash": true - } - }, - "plan": { - "model": "anthropic/claude-haiku-4-20250514", - "tools": { - "write": false, - "edit": false, - "bash": false - } - } - } -} -``` - -### Markdown-konfigurasjon - -Du kan også definere moduser ved å bruke markdown-filer. Plasser dem i: - -- Globalt: `~/.config/opencode/modes/` -- Prosjekt: `.opencode/modes/` - -```markdown title="~/.config/opencode/modes/review.md" ---- -model: anthropic/claude-sonnet-4-20250514 -temperature: 0.1 -tools: - write: false - edit: false - bash: false ---- - -You are in code review mode. Focus on: - -- Code quality and best practices -- Potential bugs and edge cases -- Performance implications -- Security considerations - -Provide constructive feedback without making direct changes. -``` - -Markdown-filnavnet blir modusnavnet (f.eks. `review.md` oppretter en `review`-modus). - -La oss se på disse konfigurasjonsalternativene i detalj. - ---- - -### Modell - -Bruk `model`-konfigurasjonen for å overstyre standardmodellen for denne modusen. Nyttig for bruk av ulike modeller optimalisert for ulike oppgaver. For eksempel en raskere modell for planlegging, en mer kapabel modell for implementering. - -```json title="opencode.json" -{ - "mode": { - "plan": { - "model": "anthropic/claude-haiku-4-20250514" - } - } -} -``` - ---- - ### Temperatur -Kontroller tilfeldigheten og kreativiteten til AIs svar med `temperature`-konfigurasjonen. Lavere verdier gjør svarene mer fokuserte og deterministiske, mens høyere verdier øker kreativiteten og variasjonen. +Kontroller tilfeldigheten og kreativiteten til AI-ens svar med `temperature`-konfigurasjonen. Lavere verdier gjør svarene mer fokuserte og deterministiske, mens høyere verdier øker kreativiteten og variasjonen. ```json title="opencode.json" { @@ -151,181 +53,22 @@ Kontroller tilfeldigheten og kreativiteten til AIs svar med `temperature`-konfig Temperaturverdier varierer vanligvis fra 0,0 til 1,0: -- **0.0-0.2**: Veldig fokuserte og deterministiske svar, ideell for kodeanalyse og planlegging +- **0.0-0.2**: Veldig fokuserte og deterministiske svar, ideelt for kodeanalyse og planlegging - **0,3-0,5**: Balanserte svar med litt kreativitet, bra for generelle utviklingsoppgaver - **0.6-1.0**: Mer kreative og varierte svar, nyttig for idédugnad og utforskning -```json title="opencode.json" -{ - "mode": { - "analyze": { - "temperature": 0.1, - "prompt": "{file:./prompts/analysis.txt}" - }, - "build": { - "temperature": 0.3 - }, - "brainstorm": { - "temperature": 0.7, - "prompt": "{file:./prompts/creative.txt}" - } - } -} -``` - -Hvis ingen temperatur er spesifisert, bruker OpenCode modellspesifikke standarder (vanligvis 0 for de fleste modeller, 0,55 for Qwen-modeller). +Hvis ingen temperatur er spesifisert, bruker OpenCode modellspesifikke standardinnstillinger (vanligvis 0 for de fleste modeller, 0,55 for Qwen-modeller). --- -### Ledetekst +### Bruksområder -Spesifiser en tilpasset systemmeldingsfil for denne modusen med `prompt`-konfigurasjonen. Ledetekstfilen skal inneholde instruksjoner som er spesifikke for modusens formål. +Her er noen vanlige bruksområder for forskjellige moduser. -```json title="opencode.json" -{ - "mode": { - "review": { - "prompt": "{file:./prompts/code-review.txt}" - } - } -} -``` - -Denne banen er i forhold til hvor konfigurasjonsfilen er plassert. Så dette fungerer for -både den globale OpenCode-konfigurasjonen og den prosjektspesifikke konfigurasjonen. - ---- - -### Verktøy - -Kontroller hvilke verktøy som er tilgjengelige i denne modusen med `tools`-konfigurasjonen. Du kan aktivere eller deaktivere spesifikke verktøy ved å sette dem til `true` eller `false`. - -```json -{ - "mode": { - "readonly": { - "tools": { - "write": false, - "edit": false, - "bash": false, - "read": true, - "grep": true, - "glob": true - } - } - } -} -``` - -Hvis ingen verktøy er spesifisert, er alle verktøy aktivert som standard. - ---- - -#### Tilgjengelige verktøy - -Her er alle verktøyene som kan kontrolleres gjennom moduskonfigurasjonen. - -| Verktøy | Beskrivelse | -| ----------- | --------------------------- | -| `bash` | Utfør shell-kommandoer | -| `edit` | Endre eksisterende filer | -| `write` | Opprett nye filer | -| `read` | Les filinnhold | -| `grep` | Søk filinnhold | -| `glob` | Finn filer etter mønster | -| `list` | Liste kataloginnhold | -| `patch` | Bruk patcher på filer | -| `todowrite` | Administrer gjøremålslister | -| `todoread` | Les gjøremålslister | -| `webfetch` | Hent nettinnhold | - ---- - -## Egendefinerte moduser - -Du kan lage dine egne tilpassede moduser ved å legge dem til konfigurasjonen. Her er eksempler som bruker begge tilnærmingene: - -### Bruker JSON konfigurasjon - -```json title="opencode.json" {4-14} -{ - "$schema": "https://opencode.ai/config.json", - "mode": { - "docs": { - "prompt": "{file:./prompts/documentation.txt}", - "tools": { - "write": true, - "edit": true, - "bash": false, - "read": true, - "grep": true, - "glob": true - } - } - } -} -``` - -### Bruker markdown-filer - -Lag modusfiler i `.opencode/modes/` for prosjektspesifikke moduser eller `~/.config/opencode/modes/` for globale moduser: - -```markdown title=".opencode/modes/debug.md" ---- -temperature: 0.1 -tools: - bash: true - read: true - grep: true - write: false - edit: false ---- - -You are in debug mode. Your primary goal is to help investigate and diagnose issues. - -Focus on: - -- Understanding the problem through careful analysis -- Using bash commands to inspect system state -- Reading relevant files and logs -- Searching for patterns and anomalies -- Providing clear explanations of findings - -Do not make any changes to files. Only investigate and report. -``` - -```markdown title="~/.config/opencode/modes/refactor.md" ---- -model: anthropic/claude-sonnet-4-20250514 -temperature: 0.2 -tools: - edit: true - read: true - grep: true - glob: true ---- - -You are in refactoring mode. Focus on improving code quality without changing functionality. - -Priorities: - -- Improve code readability and maintainability -- Apply consistent naming conventions -- Reduce code duplication -- Optimize performance where appropriate -- Ensure all tests continue to pass -``` - ---- - -### Brukstilfeller - -Her er noen vanlige brukstilfeller for forskjellige moduser. - -- **Build-modus**: Fullt utviklingsarbeid med alle verktøy aktivert +- **Bygg-modus**: Fullt utviklingsarbeid med alle verktøy aktivert - **Plan-modus**: Analyse og planlegging uten å gjøre endringer - **Review-modus**: Kodegjennomgang med skrivebeskyttet tilgang pluss dokumentasjonsverktøy - **Debug-modus**: Fokusert på etterforskning med bash- og leseverktøy aktivert - **Docs-modus**: Dokumentasjonsskriving med filoperasjoner, men ingen systemkommandoer -Du kan også finne at forskjellige modeller er gode for forskjellige brukstilfeller. +Du kan også finne at forskjellige modeller er gode for forskjellige bruksområder. diff --git a/packages/web/src/content/docs/nb/network.mdx b/packages/web/src/content/docs/nb/network.mdx index 1d075524a..418cc6d27 100644 --- a/packages/web/src/content/docs/nb/network.mdx +++ b/packages/web/src/content/docs/nb/network.mdx @@ -7,7 +7,7 @@ OpenCode støtter standard proxy-miljøvariabler og tilpassede sertifikater for --- -## Proxy +## Mellomtjener OpenCode respekterer standard proxy-miljøvariabler. @@ -23,26 +23,26 @@ export NO_PROXY=localhost,127.0.0.1 ``` :::caution -TUI kommuniserer med en lokal HTTP server. Du må omgå proxyen for denne tilkoblingen for å forhindre rutingsløyfer. +TUI-en kommuniserer med en lokal HTTP-server. Du må unngå proxy for denne tilkoblingen for å unngå rutingsløyfer. ::: -Du kan konfigurere serverens port og vertsnavn ved å bruke [CLI flagg](/docs/cli#run). +Du kan konfigurere serverens port og vertsnavn ved å bruke [CLI-flagg](/docs/cli#run). --- -### Autentiser +### Autentisering -Hvis proxyen din krever grunnleggende autentisering, inkluder legitimasjon i URL. +Hvis proxyen din krever grunnleggende autentisering, inkluder påloggingsinformasjon i URL-en. ```bash export HTTPS_PROXY=http://username:password@proxy.example.com:8080 ``` :::caution -Unngå hardkoding av passord. Bruk miljøvariabler eller sikker lagring av legitimasjon. +Unngå hardkoding av passord. Bruk miljøvariabler eller sikker lagring av påloggingsinformasjon. ::: -For proxyer som krever avansert autentisering som NTLM eller Kerberos, bør du vurdere å bruke en LLM Gateway som støtter autentiseringsmetoden din. +For proxyer som krever avansert autentisering som NTLM eller Kerberos, bør du vurdere en LLM Gateway som støtter din autentiseringsmetode. --- diff --git a/packages/web/src/content/docs/nb/permissions.mdx b/packages/web/src/content/docs/nb/permissions.mdx index 47c7cf296..e551a7fee 100644 --- a/packages/web/src/content/docs/nb/permissions.mdx +++ b/packages/web/src/content/docs/nb/permissions.mdx @@ -134,23 +134,23 @@ OpenCode-tillatelser tastes inn etter verktøynavn, pluss et par sikkerhetsvakte - `glob` — fil-globing (tilsvarer glob-mønsteret) - `grep` — innholdssøk (samsvarer med regex-mønsteret) - `list` — viser filer i en katalog (tilsvarer katalogbanen) -- `bash` — kjører shell-kommandoer (matcher analyserte kommandoer som `git status --porcelain`) -- `task` — lansering av subagenter (tilsvarer subagenttypen) -- `skill` — laster en ferdighet (tilsvarer ferdighetsnavnet) +- `bash` — kjører skallkommandoer (matcher analyserte kommandoer som `git status --porcelain`) +- `task` — start av subagenter (tilsvarer subagenttypen) +- `skill` — laster en ferdighet (tilsvarer navnet på ferdigheten) - `lsp` — kjører LSP-spørringer (for øyeblikket ikke-granulære) - `todoread`, `todowrite` — lesing/oppdatering av gjøremålslisten - `webfetch` — henter en URL (tilsvarer URL) - `websearch`, `codesearch` - nett-/kodesøk (samsvarer med søket) - `external_directory` - utløses når et verktøy berører stier utenfor prosjektets arbeidskatalog -- `doom_loop` — utløses når det samme verktøykallet gjentas 3 ganger med identisk inngang +- `doom_loop` — utløses når det samme verktøykallet gjentas 3 ganger med identisk inndata --- -## Standard +## Standarder Hvis du ikke spesifiserer noe, starter OpenCode fra tillatte standardinnstillinger: -- De fleste tillatelser er `"allow"` som standard. +- De fleste tillatelser er satt til `"allow"` som standard. - `doom_loop` og `external_directory` er standard til `"ask"`. - `read` er `"allow"`, men `.env` filer nektes som standard: @@ -171,7 +171,7 @@ Hvis du ikke spesifiserer noe, starter OpenCode fra tillatte standardinnstilling ## Hva "ask" gjør -Når OpenCode ber om godkjenning, gir UI tre utfall: +Når OpenCode ber om godkjenning, gir brukergrensesnittet tre alternativer: - `once` — godkjenne nettopp denne forespørselen - `always` — godkjenn fremtidige forespørsler som samsvarer med de foreslåtte mønstrene (for resten av den nåværende OpenCode-økten) diff --git a/packages/web/src/content/docs/nb/plugins.mdx b/packages/web/src/content/docs/nb/plugins.mdx index 811141b7f..6b6e1edf3 100644 --- a/packages/web/src/content/docs/nb/plugins.mdx +++ b/packages/web/src/content/docs/nb/plugins.mdx @@ -1,15 +1,15 @@ --- -title: Plugins -description: Skriv dine egne plugins for å utvide opencode. +title: Programtillegg +description: Skriv dine egne programtillegg for å utvide opencode. --- -Plugins lar deg utvide OpenCode ved å koble til ulike arrangementer og tilpasse atferd. Du kan lage plugins for å legge til nye funksjoner, integrere med eksterne tjenester eller endre standardoppførselen til OpenCode. +Plugins lar deg utvide OpenCode ved å koble til ulike hendelser og tilpasse atferd. Du kan lage plugins for å legge til nye funksjoner, integrere med eksterne tjenester eller endre standardoppførselen til OpenCode. For eksempler, sjekk ut [plugins](/docs/ecosystem#plugins) opprettet av fellesskapet. --- -## Bruk en plugin +## Bruk av en plugin Det er to måter å laste inn plugins. @@ -64,7 +64,7 @@ Dupliserte npm-pakker med samme navn og versjon lastes inn én gang. Imidlertid --- -## Opprett en plugin +## Opprette en plugin En plugin er en **JavaScript/TypeScript-modul** som eksporterer en eller flere plugin-moduler funksjoner. Hver funksjon mottar et kontekstobjekt og returnerer et krokobjekt. @@ -141,7 +141,7 @@ export const MyPlugin: Plugin = async ({ project, client, $, directory, worktree ### Hendelser -Plugins kan abonnere på arrangementer som vist nedenfor i Eksempler-delen. Her er en liste over de forskjellige arrangementene som er tilgjengelige. +Plugins kan abonnere på hendelser som vist nedenfor i Eksempler-delen. Her er en liste over de forskjellige hendelsene som er tilgjengelige. #### Kommandohendelser @@ -304,9 +304,9 @@ export const CustomToolsPlugin: Plugin = async (ctx) => { - `description`: Hva verktøyet gjør - `args`: Zod-skjema for verktøyets argumenter -- `execute`: Funksjon som kjører når verktøyet kalles + - `execute`: Funksjon som kjører når verktøyet kalles -Dine egendefinerte verktøy vil være tilgjengelige for å OpenCode sammen med innebygde verktøy. +Dine egendefinerte verktøy vil være tilgjengelige for OpenCode sammen med innebygde verktøy. --- @@ -331,7 +331,7 @@ Nivåer: `debug`, `info`, `warn`, `error`. Se [SDK dokumentasjon](https://openco --- -### Komprimeringskroker +### Komprimerings-hooks Tilpass konteksten inkludert når en økt komprimeres: @@ -355,9 +355,9 @@ Include any state that should persist across compaction: } ``` -`experimental.session.compacting`-kroken avfyres før LLM genererer et fortsettelsessammendrag. Bruk den til å injisere domenespesifikk kontekst som standard komprimeringsforespørsel ville gå glipp av. +`experimental.session.compacting`-kroken trigges før LLM genererer et fortsettelsessammendrag. Bruk den til å injisere domenespesifikk kontekst som standard komprimeringsprompt ville gå glipp av. -Du kan også erstatte komprimeringsmeldingen helt ved å stille inn `output.prompt`: +Du kan også erstatte komprimeringsprompten helt ved å stille inn `output.prompt`: ```ts title=".opencode/plugins/custom-compaction.ts" import type { Plugin } from "@opencode-ai/plugin" diff --git a/packages/web/src/content/docs/nb/providers.mdx b/packages/web/src/content/docs/nb/providers.mdx index dc010fe42..58d325cab 100644 --- a/packages/web/src/content/docs/nb/providers.mdx +++ b/packages/web/src/content/docs/nb/providers.mdx @@ -10,7 +10,7 @@ OpenCode bruker [AI SDK](https://ai-sdk.dev/) og [Models.dev](https://models.dev For å legge til en leverandør må du: -1. Legg til API-nøklene for leverandøren ved å bruke kommandoen `/connect`. +1. Legg til API-nøkkelen for leverandøren ved å bruke kommandoen `/connect`. 2. Konfigurer leverandøren i OpenCode-konfigurasjonen. --- @@ -22,16 +22,16 @@ i `~/.local/share/opencode/auth.json`. --- -### Konfig +### Konfigurasjon Du kan tilpasse leverandørene gjennom `provider`-delen i OpenCode konfig. --- -#### Base URL +#### Base-URL -Du kan tilpasse basen URL for enhver leverandør ved å angi alternativet `baseURL`. Dette er nyttig når du bruker proxy-tjenester eller tilpassede endepunkter. +Du kan tilpasse base-URL-en for enhver leverandør ved å angi alternativet `baseURL`. Dette er nyttig når du bruker proxy-tjenester eller tilpassede endepunkter. ```json title="opencode.json" {6} { @@ -178,13 +178,13 @@ Slik bruker du Amazon Bedrock med OpenCode: **Tilgjengelige alternativer:** - `region` - AWS region (f.eks. `us-east-1`, `eu-west-1`) - `profile` - AWS navngitt profil fra `~/.aws/credentials` - - `endpoint` - Egendefinert endepunkt URL for VPC endepunkter (alias for generisk `baseURL`-alternativ) + - `endpoint` - Egendefinert endepunkt URL for VPC-endepunkter (alias for generisk `baseURL`-alternativ) :::tip Alternativer for konfigurasjonsfil har forrang over miljøvariabler. ::: - #### Avansert: VPC Sluttpunkter + #### Avansert: VPC-endepunkter Hvis du bruker VPC-endepunkter for Bedrock: @@ -282,7 +282,7 @@ For egendefinerte slutningsprofiler, bruk modellen og leverandørnavnet i nøkke Å bruke Claude Pro/Max-abonnementet ditt i opencode støttes ikke offisielt av [Anthropic](https://anthropic.com). ::: -##### Bruke API-tastene +##### Bruke API-nøkler Du kan også velge **Opprett en API nøkkel** hvis du ikke har et Pro/Max-abonnement. Den åpner også nettleseren din og ber deg logge på Anthropic og gi deg en kode du kan lime inn i terminalen din. @@ -684,7 +684,7 @@ for å lagre token i OpenCode auth-lagring. ##### Selvhostet GitLab -:::note[compliance note] +:::note[Merknad om samsvar] OpenCode bruker en liten modell for noen AI oppgaver som å generere økttittelen. Den er konfigurert til å bruke gpt-5-nano som standard, hostet av Zen. For å låse OpenCode for kun å bruke din egen GitLab-hostede forekomst, legg til følgende i din @@ -980,9 +980,9 @@ Her er [Helicone's Model Directory](https://helicone.ai/models), du trenger denn } ``` -#### Egendefinerte topptekster +#### Egendefinerte headere -Helicone støtter tilpassede overskrifter for funksjoner som bufring, brukersporing og øktadministrasjon. Legg dem til leverandørkonfigurasjonen din ved å bruke `options.headers`: +Helicone støtter tilpassede headere for funksjoner som bufring, brukersporing og øktadministrasjon. Legg dem til leverandørkonfigurasjonen din ved å bruke `options.headers`: ```jsonc title="~/.config/opencode/opencode.jsonc" { @@ -1019,9 +1019,9 @@ Legg den til i konfigurasjonen din. } ``` -Programtillegget injiserer `Helicone-Session-Id` og `Helicone-Session-Name` overskrifter i forespørslene dine. På Helicones Sessions-side vil du se hver OpenCode-samtale oppført som en separat økt. +Programtillegget injiserer `Helicone-Session-Id` og `Helicone-Session-Name` headere i forespørslene dine. På Helicones Sessions-side vil du se hver OpenCode-samtale oppført som en separat økt. -##### Vanlige helikonhoder +##### Vanlige Helicone-headere | Overskrift | Beskrivelse | | -------------------------- | -------------------------------------------------------------------------- | @@ -1326,7 +1326,7 @@ Vi anbefaler at du registrerer deg for [ChatGPT Plus eller Pro](https://chatgpt. /models ``` -##### Bruke API-tastene +##### Bruke API-nøkler Hvis du allerede har en API-nøkkel, kan du velge **Angi API-nøkkel manuelt** og lime den inn i terminalen. @@ -1866,7 +1866,7 @@ Her er et eksempel på innstilling av alternativene `apiKey`, `headers` og model Konfigurasjonsdetaljer: - **apiKey**: Angi med `env` variabel syntaks, [finn ut mer](/docs/config#env-vars). -- **overskrifter**: Egendefinerte overskrifter sendt med hver forespørsel. +- **headere**: Egendefinerte headere sendt med hver forespørsel. - **limit.context**: Maksimalt Input Tokens som modellen godtar. - **limit.output**: Maksimalt antall tokens modellen kan generere. diff --git a/packages/web/src/content/docs/nb/rules.mdx b/packages/web/src/content/docs/nb/rules.mdx index 4eb16c378..38d5b7711 100644 --- a/packages/web/src/content/docs/nb/rules.mdx +++ b/packages/web/src/content/docs/nb/rules.mdx @@ -7,12 +7,12 @@ Du kan gi tilpassede instruksjoner for å OpenCode ved å opprette en `AGENTS.md --- -## Initialiser +## Initialisering For å lage en ny `AGENTS.md` fil, kan du kjøre kommandoen `/init` i OpenCode. :::tip -Du bør overgi prosjektets `AGENTS.md`-fil til Git. +Du bør sjekke inn prosjektets `AGENTS.md`-fil i Git. ::: Dette vil skanne prosjektet og alt dets innhold for å forstå hva prosjektet handler om og generere en `AGENTS.md`-fil med det. Dette hjelper OpenCode å navigere i prosjektet bedre. @@ -118,13 +118,13 @@ Du kan også bruke eksterne URL-er for å laste instruksjoner fra nettet. } ``` -Fjerninstruksjoner hentes med 5 sekunders tidsavbrudd. +Eksterne instruksjoner hentes med 5 sekunders tidsavbrudd. Alle instruksjonsfilene er kombinert med `AGENTS.md`-filene dine. --- -## Refererer til eksterne filer +## Referere til eksterne filer Selv om OpenCode ikke automatisk analyserer filreferanser i `AGENTS.md`, kan du oppnå lignende funksjonalitet på to måter: @@ -170,10 +170,10 @@ Read the following file immediately as it's relevant to all workflows: @rules/ge Denne tilnærmingen lar deg: -- Lag modulære, gjenbrukbare regelfiler -- Del regler på tvers av prosjekter via symbolkoblinger eller git-undermoduler -- Hold AGENTS.md kortfattet mens du refererer til detaljerte retningslinjer -- Sørg for at OpenCode laster filer kun når det er nødvendig for den spesifikke oppgaven +- Lage modulære, gjenbrukbare regelfiler +- Dele regler på tvers av prosjekter via symbolkoblinger eller git-undermoduler +- Holde AGENTS.md kortfattet mens du refererer til detaljerte retningslinjer +- Sørge for at OpenCode laster filer kun når det er nødvendig for den spesifikke oppgaven :::tip For monorepos eller prosjekter med delte standarder er bruk av `opencode.json` med glob-mønstre (som `packages/*/AGENTS.md`) mer vedlikeholdbart enn manuelle instruksjoner. diff --git a/packages/web/src/content/docs/nb/sdk.mdx b/packages/web/src/content/docs/nb/sdk.mdx index b128f5b4f..bbff8ebec 100644 --- a/packages/web/src/content/docs/nb/sdk.mdx +++ b/packages/web/src/content/docs/nb/sdk.mdx @@ -13,7 +13,7 @@ Bruk den til å bygge integrasjoner og kontrollere OpenCode programmatisk. --- -## Installer +## Installasjon Installer SDK fra npm: @@ -23,7 +23,7 @@ npm install @opencode-ai/sdk --- -## Opprett klient +## Opprette klient Opprett en forekomst av OpenCode: @@ -41,13 +41,13 @@ Dette starter både en server og en klient | ---------- | ------------- | -------------------------------- | ----------- | | `hostname` | `string` | Server vertsnavn | `127.0.0.1` | | `port` | `number` | Serverport | `4096` | -| `signal` | `AbortSignal` | Avbryt signal for kansellering | `undefined` | +| `signal` | `AbortSignal` | AbortSignal for avbrudd | `undefined` | | `timeout` | `number` | Tidsavbrudd i ms for serverstart | `5000` | | `config` | `Config` | Konfigurasjonsobjekt | `{}` | --- -## Konfig +## Konfigurasjon Du kan sende et konfigurasjonsobjekt for å tilpasse virkemåten. Forekomsten henter fortsatt din `opencode.json`, men du kan overstyre eller legge til konfigurasjon inline: @@ -81,13 +81,13 @@ const client = createOpencodeClient({ #### Alternativer -| Alternativ | Type | Beskrivelse | Standard | -| --------------- | ---------- | ---------------------------------- | ----------------------- | -| `baseUrl` | `string` | URL av serveren | `http://localhost:4096` | -| `fetch` | `function` | Egendefinert hentingimplementering | `globalThis.fetch` | -| `parseAs` | `string` | Svarparsingmetode | `auto` | -| `responseStyle` | `string` | Returstil: `data` eller `fields` | `fields` | -| `throwOnError` | `boolean` | Kast feil i stedet for retur | `false` | +| Alternativ | Type | Beskrivelse | Standard | +| --------------- | ---------- | --------------------------------- | ----------------------- | +| `baseUrl` | `string` | URL av serveren | `http://localhost:4096` | +| `fetch` | `function` | Egendefinert fetch-implementasjon | `globalThis.fetch` | +| `parseAs` | `string` | Metode for responsparsing | `auto` | +| `responseStyle` | `string` | Returstil: `data` eller `fields` | `fields` | +| `throwOnError` | `boolean` | Kast feil i stedet for retur | `false` | --- @@ -99,7 +99,7 @@ SDK inkluderer TypeScript-definisjoner for alle API-typer. Importer dem direkte: import type { Session, Message, Part } from "@opencode-ai/sdk" ``` -Alle typer er generert fra serverens OpenAPI-spesifikasjon og tilgjengelig i types-filen. +Alle typer er generert fra serverens OpenAPI-spesifikasjon og tilgjengelig i type-filen. --- @@ -117,17 +117,17 @@ try { --- -## APIer +## API-er -SDK avslører alle server-APIer gjennom en typesikker klient. +SDK-en eksponerer alle server-API-er gjennom en typesikker klient. --- ### Globalt -| Metode | Beskrivelse | Svar | -| ----------------- | ---------------------------- | ------------------------------------ | -| `global.health()` | Sjekk serverhelse og versjon | `{ healthy: true, version: string }` | +| Metode | Beskrivelse | Svar | +| ----------------- | ----------------------------- | ------------------------------------ | +| `global.health()` | Sjekk serverstatus og versjon | `{ healthy: true, version: string }` | --- @@ -142,10 +142,10 @@ console.log(health.data.version) ### App -| Metode | Beskrivelse | Svar | -| -------------- | -------------------------------- | ------------------------------------------- | -| `app.log()` | Skriv en loggoppføring | `boolean` | -| `app.agents()` | Liste alle tilgjengelige agenter | Agent[] | +| Metode | Beskrivelse | Svar | +| -------------- | ------------------------------- | ------------------------------------------- | +| `app.log()` | Skriv en loggoppføring | `boolean` | +| `app.agents()` | List alle tilgjengelige agenter | Agent[] | --- @@ -169,10 +169,10 @@ const agents = await client.app.agents() ### Prosjekt -| Metode | Beskrivelse | Svar | -| ------------------- | -------------------------- | --------------------------------------------- | -| `project.list()` | Liste over alle prosjekter | Project[] | -| `project.current()` | Få nåværende prosjekt | Project | +| Metode | Beskrivelse | Svar | +| ------------------- | ----------------------- | --------------------------------------------- | +| `project.list()` | List alle prosjekter | Project[] | +| `project.current()` | Hent gjeldende prosjekt | Project | --- @@ -190,9 +190,9 @@ const currentProject = await client.project.current() ### Sti -| Metode | Beskrivelse | Svar | -| ------------ | ----------------- | ---------------------------------------- | -| `path.get()` | Få gjeldende bane | Path | +| Metode | Beskrivelse | Svar | +| ------------ | ------------------- | ---------------------------------------- | +| `path.get()` | Hent gjeldende bane | Path | --- @@ -205,12 +205,12 @@ const pathInfo = await client.path.get() --- -### Konfig +### Konfigurasjon -| Metode | Beskrivelse | Svar | -| -------------------- | -------------------------------------- | ----------------------------------------------------------------------------------------------------- | -| `config.get()` | Få konfigurasjonsinformasjon | Config | -| `config.providers()` | Liste leverandører og standardmodeller | `{ providers: `Provider[]`, default: { [key: string]: string } }` | +| Metode | Beskrivelse | Svar | +| -------------------- | ------------------------------------- | ----------------------------------------------------------------------------------------------------- | +| `config.get()` | Hent konfigurasjonsinformasjon | Config | +| `config.providers()` | List leverandører og standardmodeller | `{ providers: `Provider[]`, default: { [key: string]: string } }` | --- @@ -226,27 +226,27 @@ const { providers, default: defaults } = await client.config.providers() ### Sesjoner -| Metode | Beskrivelse | Merknader | -| ---------------------------------------------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | -| `session.list()` | Liste økter | Returnerer Session[] | -| `session.get({ path })` | Få økt | Returnerer Session | -| `session.children({ path })` | Liste over barneøkter | Returnerer Session[] | -| `session.create({ body })` | Opprett økt | Returnerer Session | -| `session.delete({ path })` | Slett økt | Returnerer `boolean` | -| `session.update({ path, body })` | Oppdater øktegenskaper | Returnerer Session | -| `session.init({ path, body })` | Analyser appen og lag `AGENTS.md` | Returnerer `boolean` | -| `session.abort({ path })` | Avbryt en løpeøkt | Returnerer `boolean` | -| `session.share({ path })` | Del økten | Returnerer Session | -| `session.unshare({ path })` | Slutt å dele økten | Returnerer Session | -| `session.summarize({ path, body })` | Oppsummer økten | Returnerer `boolean` | -| `session.messages({ path })` | Liste meldinger i en økt | Returnerer `{ info: `Message`, parts: `Part[]`}[]` | -| `session.message({ path })` | Få meldingsdetaljer | Returnerer `{ info: `Message`, parts: `Part[]`}` | -| `session.prompt({ path, body })` | Send melding | `body.noReply: true` returnerer UserMessage (kun kontekst). Standard returnerer AssistantMessage med AI svar | -| `session.command({ path, body })` | Send kommando til økt | Returnerer `{ info: `AssistantMessage`, parts: `Part[]`}` | -| `session.shell({ path, body })` | Kjør en shell-kommando | Returnerer AssistantMessage | -| `session.revert({ path, body })` | Tilbakestill en melding | Returnerer Session | -| `session.unrevert({ path })` | Gjenopprett tilbakestilte meldinger | Returnerer Session | -| `postSessionByIdPermissionsByPermissionId({ path, body })` | Svar på en tillatelsesforespørsel | Returnerer `boolean` | +| Metode | Beskrivelse | Merknader | +| ---------------------------------------------------------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | +| `session.list()` | List økter | Returnerer Session[] | +| `session.get({ path })` | Hent økt | Returnerer Session | +| `session.children({ path })` | List barneøkter | Returnerer Session[] | +| `session.create({ body })` | Opprett økt | Returnerer Session | +| `session.delete({ path })` | Slett økt | Returnerer `boolean` | +| `session.update({ path, body })` | Oppdater øktegenskaper | Returnerer Session | +| `session.init({ path, body })` | Analyser appen og lag `AGENTS.md` | Returnerer `boolean` | +| `session.abort({ path })` | Avbryt en kjørende økt | Returnerer `boolean` | +| `session.share({ path })` | Del økten | Returnerer Session | +| `session.unshare({ path })` | Slutt å dele økten | Returnerer Session | +| `session.summarize({ path, body })` | Oppsummer økten | Returnerer `boolean` | +| `session.messages({ path })` | List meldinger i en økt | Returnerer `{ info: `Message`, parts: `Part[]`}[]` | +| `session.message({ path })` | Hent meldingsdetaljer | Returnerer `{ info: `Message`, parts: `Part[]`}` | +| `session.prompt({ path, body })` | Send melding | `body.noReply: true` returnerer UserMessage (kun kontekst). Standard returnerer AssistantMessage med AI svar | +| `session.command({ path, body })` | Send kommando til økt | Returnerer `{ info: `AssistantMessage`, parts: `Part[]`}` | +| `session.shell({ path, body })` | Kjør en shell-kommando | Returnerer AssistantMessage | +| `session.revert({ path, body })` | Tilbakestill en melding | Returnerer Session | +| `session.unrevert({ path })` | Gjenopprett reverserte meldinger | Returnerer Session | +| `postSessionByIdPermissionsByPermissionId({ path, body })` | Svar på en tillatelsesforespørsel | Returnerer `boolean` | --- @@ -287,9 +287,9 @@ await client.session.prompt({ | ------------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------ | | `find.text({ query })` | Søk etter tekst i filer | En rekke matchobjekter med `path`, `lines`, `line_number`, `absolute_offset`, `submatches` | | `find.files({ query })` | Finn filer og kataloger etter navn | `string[]` (baner) | -| `find.symbols({ query })` | Finn arbeidsområdesymboler | Symbol[] | +| `find.symbols({ query })` | Finn symboler i arbeidsområdet | Symbol[] | | `file.read({ query })` | Les en fil | `{ type: "raw" \| "patch", content: string }` | -| `file.status({ query? })` | Få status for sporede filer | File[] | +| `file.status({ query? })` | Hent status for sporede filer | File[] | `find.files` støtter noen få valgfrie søkefelt: @@ -324,17 +324,17 @@ const content = await client.file.read({ ### TUI -| Metode | Beskrivelse | Svar | -| ------------------------------ | ---------------------------- | --------- | -| `tui.appendPrompt({ body })` | Legg til tekst i ledeteksten | `boolean` | -| `tui.openHelp()` | Åpne hjelpedialogen | `boolean` | -| `tui.openSessions()` | Åpne øktvelgeren | `boolean` | -| `tui.openThemes()` | Åpne temavelgeren | `boolean` | -| `tui.openModels()` | Åpne modellvelgeren | `boolean` | -| `tui.submitPrompt()` | Send inn gjeldende ledetekst | `boolean` | -| `tui.clearPrompt()` | Fjern ledeteksten | `boolean` | -| `tui.executeCommand({ body })` | Utfør en kommando | `boolean` | -| `tui.showToast({ body })` | Vis toastvarsel | `boolean` | +| Metode | Beskrivelse | Svar | +| ------------------------------ | ------------------------- | --------- | +| `tui.appendPrompt({ body })` | Legg til tekst i prompten | `boolean` | +| `tui.openHelp()` | Åpne hjelpedialogen | `boolean` | +| `tui.openSessions()` | Åpne øktvelgeren | `boolean` | +| `tui.openThemes()` | Åpne temavelgeren | `boolean` | +| `tui.openModels()` | Åpne modellvelgeren | `boolean` | +| `tui.submitPrompt()` | Send inn gjeldende prompt | `boolean` | +| `tui.clearPrompt()` | Tøm prompten | `boolean` | +| `tui.executeCommand({ body })` | Utfør en kommando | `boolean` | +| `tui.showToast({ body })` | Vis toast-varsel | `boolean` | --- @@ -355,9 +355,9 @@ await client.tui.showToast({ ### Auth -| Metode | Beskrivelse | Svar | -| ------------------- | ------------------------------- | --------- | -| `auth.set({ ... })` | Angi autentiseringslegitimasjon | `boolean` | +| Metode | Beskrivelse | Svar | +| ------------------- | ------------------------------ | --------- | +| `auth.set({ ... })` | Angi autentiseringsinformasjon | `boolean` | --- @@ -374,9 +374,9 @@ await client.auth.set({ ### Hendelser -| Metode | Beskrivelse | Svar | -| ------------------- | ------------------------------ | ------------------------------ | -| `event.subscribe()` | Server-sendte hendelser stream | Server-sendte hendelser stream | +| Metode | Beskrivelse | Svar | +| ------------------- | -------------------------------- | -------------------------------- | +| `event.subscribe()` | Strøm av server-sendte hendelser | Strøm av server-sendte hendelser | --- diff --git a/packages/web/src/content/docs/nb/server.mdx b/packages/web/src/content/docs/nb/server.mdx index 16c88e60d..a6ad8c6df 100644 --- a/packages/web/src/content/docs/nb/server.mdx +++ b/packages/web/src/content/docs/nb/server.mdx @@ -1,12 +1,12 @@ --- -title: Server -description: Samhandle med OpenCode-server over HTTP. +title: Tjener +description: Samhandle med OpenCode-tjener over HTTP. --- import config from "../../../../config.mjs" export const typesUrl = `${config.github}/blob/dev/packages/sdk/js/src/gen/types.gen.ts` -Kommandoen `opencode serve` kjører en hodeløs HTTP-server som avslører et OpenAPI-endepunkt som en OpenCode-klient kan bruke. +Kommandoen `opencode serve` kjører en hodeløs HTTP-server som eksponerer et OpenAPI-endepunkt som en OpenCode-klient kan bruke. --- @@ -18,15 +18,15 @@ opencode serve [--port ] [--hostname ] [--cors ] #### Alternativer -| Flagg | Beskrivelse | Standard | -| --------------- | ---------------------------------------------- | ---------------- | -| `--port` | Port å lytte på | `4096` | -| `--hostname` | Vertsnavn å lytte på | `127.0.0.1` | -| `--mdns` | Aktiver mDNS-oppdagelse | `false` | -| `--mdns-domain` | Egendefinert domenenavn for mDNS-tjeneste | `opencode.local` | -| `--cors` | Ytterligere nettleseropprinnelse for å tillate | `[]` | +| Flagg | Beskrivelse | Standard | +| --------------- | --------------------------------------------- | ---------------- | +| `--port` | Port å lytte på | `4096` | +| `--hostname` | Vertsnavn å lytte på | `127.0.0.1` | +| `--mdns` | Aktiver mDNS-oppdagelse | `false` | +| `--mdns-domain` | Egendefinert domenenavn for mDNS-tjeneste | `opencode.local` | +| `--cors` | Ytterligere nettleseropprinnelse som tillates | `[]` | -`--cors` kan passeres flere ganger: +`--cors` kan angis flere ganger: ```bash opencode serve --cors http://localhost:5173 --cors https://app.example.com @@ -36,7 +36,7 @@ opencode serve --cors http://localhost:5173 --cors https://app.example.com ### Autentisering -Sett `OPENCODE_SERVER_PASSWORD` for å beskytte serveren med HTTP grunnleggende autentisering. Brukernavnet er standard til `opencode`, eller sett `OPENCODE_SERVER_USERNAME` for å overstyre det. Dette gjelder både `opencode serve` og `opencode web`. +Sett `OPENCODE_SERVER_PASSWORD` for å beskytte serveren med HTTP grunnleggende autentisering. Brukernavnet er satt til `opencode` som standard, eller sett `OPENCODE_SERVER_USERNAME` for å overstyre det. Dette gjelder både `opencode serve` og `opencode web`. ```bash OPENCODE_SERVER_PASSWORD=your-password opencode serve @@ -98,48 +98,48 @@ opencode-serveren viser følgende APIer. ### Prosjekt -| Metode | Sti | Beskrivelse | Svar | -| ------ | ------------------ | --------------------------- | --------------------------------------------- | -| `GET` | `/project` | Liste over alle prosjekter | Project[] | -| `GET` | `/project/current` | Få det nåværende prosjektet | Project | +| Metode | Sti | Beskrivelse | Svar | +| ------ | ------------------ | ----------------------- | --------------------------------------------- | +| `GET` | `/project` | List alle prosjekter | Project[] | +| `GET` | `/project/current` | Hent gjeldende prosjekt | Project | --- ### Bane og VCS -| Metode | Sti | Beskrivelse | Svar | -| ------ | ------- | ---------------------------------- | ------------------------------------------- | -| `GET` | `/path` | Få gjeldende bane | Path | -| `GET` | `/vcs` | Få VCS info for gjeldende prosjekt | VcsInfo | +| Metode | Sti | Beskrivelse | Svar | +| ------ | ------- | ------------------------------------ | ------------------------------------------- | +| `GET` | `/path` | Hent gjeldende bane | Path | +| `GET` | `/vcs` | Hent VCS-info for gjeldende prosjekt | VcsInfo | --- ### Forekomst -| Metode | Sti | Beskrivelse | Svar | -| ------ | ------------------- | ------------------------ | --------- | -| `POST` | `/instance/dispose` | Kast gjeldende forekomst | `boolean` | +| Metode | Sti | Beskrivelse | Svar | +| ------ | ------------------- | --------------------------- | --------- | +| `POST` | `/instance/dispose` | Avslutt gjeldende forekomst | `boolean` | --- -### Konfig +### Konfigurasjon -| Metode | Sti | Beskrivelse | Svar | -| ------- | ------------------- | -------------------------------------- | ---------------------------------------------------------------------------------------- | -| `GET` | `/config` | Få konfigurasjonsinformasjon | Config | -| `PATCH` | `/config` | Oppdater konfigurasjon | Config | -| `GET` | `/config/providers` | Liste leverandører og standardmodeller | `{ providers: `Provider[]`, default: { [key: string]: string } }` | +| Metode | Sti | Beskrivelse | Svar | +| ------- | ------------------- | ------------------------------------- | ---------------------------------------------------------------------------------------- | +| `GET` | `/config` | Hent konfigurasjonsinformasjon | Config | +| `PATCH` | `/config` | Oppdater konfigurasjon | Config | +| `GET` | `/config/providers` | List leverandører og standardmodeller | `{ providers: `Provider[]`, default: { [key: string]: string } }` | --- ### Leverandør -| Metode | Sti | Beskrivelse | Svar | -| ------ | -------------------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------- | -| `GET` | `/provider` | Liste alle leverandører | `{ all: `Provider[]`, default: {...}, connected: string[] }` | -| `GET` | `/provider/auth` | Få leverandørautentiseringsmetoder | `{ [providerID: string]: `ProviderAuthMethod[]` }` | -| `POST` | `/provider/{id}/oauth/authorize` | Autoriser en leverandør ved å bruke OAuth | ProviderAuthAuthorization | -| `POST` | `/provider/{id}/oauth/callback` | Håndtere OAuth-tilbakeringing for en leverandør | `boolean` | +| Metode | Sti | Beskrivelse | Svar | +| ------ | -------------------------------- | ---------------------------------------------- | ----------------------------------------------------------------------------------- | +| `GET` | `/provider` | List alle leverandører | `{ all: `Provider[]`, default: {...}, connected: string[] }` | +| `GET` | `/provider/auth` | Hent autentiseringsmetoder for leverandør | `{ [providerID: string]: `ProviderAuthMethod[]` }` | +| `POST` | `/provider/{id}/oauth/authorize` | Autoriser en leverandør ved å bruke OAuth | ProviderAuthAuthorization | +| `POST` | `/provider/{id}/oauth/callback` | Håndter OAuth-tilbakeringing for en leverandør | `boolean` | --- @@ -147,20 +147,20 @@ opencode-serveren viser følgende APIer. | Metode | Sti | Beskrivelse | Merknader | | -------- | ---------------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------- | -| `GET` | `/session` | Liste alle økter | Returnerer Session[] | +| `GET` | `/session` | List alle økter | Returnerer Session[] | | `POST` | `/session` | Opprett en ny økt | body: `{ parentID?, title? }`, returnerer Session | -| `GET` | `/session/status` | Få øktstatus for alle økter | Returnerer `{ [sessionID: string]: `SessionStatus` }` | -| `GET` | `/session/:id` | Få øktdetaljer | Returnerer Session | +| `GET` | `/session/status` | Hent øktstatus for alle økter | Returnerer `{ [sessionID: string]: `SessionStatus` }` | +| `GET` | `/session/:id` | Hent øktdetaljer | Returnerer Session | | `DELETE` | `/session/:id` | Slett en økt og alle dens data | Returnerer `boolean` | | `PATCH` | `/session/:id` | Oppdater øktegenskaper | body: `{ title? }`, returnerer Session | -| `GET` | `/session/:id/children` | Få en økts barneøkter | Returnerer Session[] | -| `GET` | `/session/:id/todo` | Få gjøremålslisten for en økt | Returnerer Todo[] | +| `GET` | `/session/:id/children` | Hent en økts barneøkter | Returnerer Session[] | +| `GET` | `/session/:id/todo` | Hent gjøremålslisten for en økt | Returnerer Todo[] | | `POST` | `/session/:id/init` | Analyser appen og lag `AGENTS.md` | body: `{ messageID, providerID, modelID }`, returnerer `boolean` | | `POST` | `/session/:id/fork` | Fork en eksisterende økt ved en melding | body: `{ messageID? }`, returnerer Session | -| `POST` | `/session/:id/abort` | Avbryt en løpeøkt | Returnerer `boolean` | +| `POST` | `/session/:id/abort` | Avbryt en kjørende økt | Returnerer `boolean` | | `POST` | `/session/:id/share` | Del en økt | Returnerer Session | | `DELETE` | `/session/:id/share` | Slutt å dele en økt | Returnerer Session | -| `GET` | `/session/:id/diff` | Få diff for denne økten | spørring: `messageID?`, returnerer FileDiff[] | +| `GET` | `/session/:id/diff` | Hent diff for denne økten | spørring: `messageID?`, returnerer FileDiff[] | | `POST` | `/session/:id/summarize` | Oppsummer økten | body: `{ providerID, modelID }`, returnerer `boolean` | | `POST` | `/session/:id/revert` | Tilbakestill en melding | body: `{ messageID, partID? }`, returnerer `boolean` | | `POST` | `/session/:id/unrevert` | Gjenopprett alle tilbakestilte meldinger | Returnerer `boolean` | @@ -172,20 +172,20 @@ opencode-serveren viser følgende APIer. | Metode | Sti | Beskrivelse | Merknader | | ------ | --------------------------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `GET` | `/session/:id/message` | Liste meldinger i en økt | spørring: `limit?`, returnerer `{ info: `Message`, parts: `Part[]`}[]` | +| `GET` | `/session/:id/message` | List meldinger i en økt | spørring: `limit?`, returnerer `{ info: `Message`, parts: `Part[]`}[]` | | `POST` | `/session/:id/message` | Send en melding og vent på svar | body: `{ messageID?, model?, agent?, noReply?, system?, tools?, parts }`, returnerer `{ info: `Message`, parts: `Part[]`}` | -| `GET` | `/session/:id/message/:messageID` | Få meldingsdetaljer | Returnerer `{ info: `Message`, parts: `Part[]`}` | +| `GET` | `/session/:id/message/:messageID` | Hent meldingsdetaljer | Returnerer `{ info: `Message`, parts: `Part[]`}` | | `POST` | `/session/:id/prompt_async` | Send en melding asynkront (ingen vent) | body: samme som `/session/:id/message`, returnerer `204 No Content` | -| `POST` | `/session/:id/command` | Utfør en skråstrek-kommando | body: `{ messageID?, agent?, model?, command, arguments }`, returnerer `{ info: `Message`, parts: `Part[]`}` | +| `POST` | `/session/:id/command` | Utfør en slash-kommando | body: `{ messageID?, agent?, model?, command, arguments }`, returnerer `{ info: `Message`, parts: `Part[]`}` | | `POST` | `/session/:id/shell` | Kjør en shell-kommando | body: `{ agent, model?, command }`, returnerer `{ info: `Message`, parts: `Part[]`}` | --- ### Kommandoer -| Metode | Sti | Beskrivelse | Svar | -| ------ | ---------- | --------------------- | --------------------------------------------- | -| `GET` | `/command` | Liste alle kommandoer | Command[] | +| Metode | Sti | Beskrivelse | Svar | +| ------ | ---------- | -------------------- | --------------------------------------------- | +| `GET` | `/command` | List alle kommandoer | Command[] | --- @@ -195,10 +195,10 @@ opencode-serveren viser følgende APIer. | ------ | ------------------------ | ---------------------------------- | ------------------------------------------------------------------------------------------ | | `GET` | `/find?pattern=` | Søk etter tekst i filer | En rekke matchobjekter med `path`, `lines`, `line_number`, `absolute_offset`, `submatches` | | `GET` | `/find/file?query=` | Finn filer og kataloger etter navn | `string[]` (baner) | -| `GET` | `/find/symbol?query=` | Finn arbeidsområdesymboler | Symbol[] | -| `GET` | `/file?path=` | Liste filer og kataloger | FileNode[] | +| `GET` | `/find/symbol?query=` | Finn symboler i arbeidsområdet | Symbol[] | +| `GET` | `/file?path=` | List filer og kataloger | FileNode[] | | `GET` | `/file/content?path=

` | Les en fil | FileContent | -| `GET` | `/file/status` | Få status for sporede filer | File[] | +| `GET` | `/file/status` | Hent status for sporede filer | File[] | #### `/find/file` spørringsparametere @@ -223,26 +223,26 @@ opencode-serveren viser følgende APIer. | Metode | Sti | Beskrivelse | Svar | | ------ | ------------ | ---------------------------- | -------------------------------------------------------- | -| `GET` | `/lsp` | Få LSP serverstatus | LSPStatus[] | -| `GET` | `/formatter` | Få formateringsstatus | FormatterStatus[] | -| `GET` | `/mcp` | Få MCP serverstatus | `{ [name: string]: `MCPStatus` }` | -| `POST` | `/mcp` | Legg til MCP server dynamisk | body: `{ name, config }`, returnerer MCP statusobjekt | +| `GET` | `/lsp` | Hent LSP-serverstatus | LSPStatus[] | +| `GET` | `/formatter` | Hent formateringsstatus | FormatterStatus[] | +| `GET` | `/mcp` | Hent MCP-serverstatus | `{ [name: string]: `MCPStatus` }` | +| `POST` | `/mcp` | Legg til MCP-server dynamisk | body: `{ name, config }`, returnerer MCP statusobjekt | --- ### Agenter -| Metode | Sti | Beskrivelse | Svar | -| ------ | -------- | -------------------------------- | ------------------------------------------- | -| `GET` | `/agent` | Liste alle tilgjengelige agenter | Agent[] | +| Metode | Sti | Beskrivelse | Svar | +| ------ | -------- | ------------------------------- | ------------------------------------------- | +| `GET` | `/agent` | List alle tilgjengelige agenter | Agent[] | --- ### Logging -| Metode | Sti | Beskrivelse | Svar | -| ------ | ------ | --------------------------------------------------------------------- | --------- | -| `POST` | `/log` | Skriv loggoppføring. Brødtekst: `{ service, level, message, extra? }` | `boolean` | +| Metode | Sti | Beskrivelse | Svar | +| ------ | ------ | ---------------------------------------------------------------- | --------- | +| `POST` | `/log` | Skriv loggoppføring. Body: `{ service, level, message, extra? }` | `boolean` | --- @@ -250,13 +250,13 @@ opencode-serveren viser følgende APIer. | Metode | Sti | Beskrivelse | Svar | | ------ | ----------------------- | ------------------------------------------- | -------------------------- | -| `POST` | `/tui/append-prompt` | Legg til tekst i ledeteksten | `boolean` | +| `POST` | `/tui/append-prompt` | Legg til tekst i prompten | `boolean` | | `POST` | `/tui/open-help` | Åpne hjelpedialogen | `boolean` | | `POST` | `/tui/open-sessions` | Åpne øktvelgeren | `boolean` | | `POST` | `/tui/open-themes` | Åpne temavelgeren | `boolean` | | `POST` | `/tui/open-models` | Åpne modellvelgeren | `boolean` | -| `POST` | `/tui/submit-prompt` | Send inn gjeldende ledetekst | `boolean` | -| `POST` | `/tui/clear-prompt` | Fjern ledeteksten | `boolean` | +| `POST` | `/tui/submit-prompt` | Send inn gjeldende prompt | `boolean` | +| `POST` | `/tui/clear-prompt` | Tøm prompten | `boolean` | | `POST` | `/tui/execute-command` | Utfør en kommando (`{ command }`) | `boolean` | | `POST` | `/tui/show-toast` | Vis toast (`{ title?, message, variant }`) | `boolean` | | `GET` | `/tui/control/next` | Vent på neste kontrollforespørsel | Kontrollforespørselsobjekt | @@ -266,17 +266,17 @@ opencode-serveren viser følgende APIer. ### Auth -| Metode | Sti | Beskrivelse | Svar | -| ------ | ----------- | --------------------------------------------------------------------------- | --------- | -| `PUT` | `/auth/:id` | Angi autentiseringslegitimasjon. Brødtekst må samsvare med leverandørskjema | `boolean` | +| Metode | Sti | Beskrivelse | Svar | +| ------ | ----------- | --------------------------------------------------------------------- | --------- | +| `PUT` | `/auth/:id` | Angi autentiseringsinformasjon. Body må samsvare med leverandørskjema | `boolean` | --- ### Hendelser -| Metode | Sti | Beskrivelse | Svar | -| ------ | -------- | -------------------------------------------------------------------------------------------------- | ------------------------------ | -| `GET` | `/event` | Server-sendte hendelsesstrøm. Første arrangement er `server.connected`, deretter bussarrangementer | Server-sendte hendelser stream | +| Metode | Sti | Beskrivelse | Svar | +| ------ | -------- | ----------------------------------------------------------------------------------------------- | -------------------------------- | +| `GET` | `/event` | Strøm av server-sendte hendelser. Første hendelse er `server.connected`, deretter busshendelser | Strøm av server-sendte hendelser | --- diff --git a/packages/web/src/content/docs/nb/share.mdx b/packages/web/src/content/docs/nb/share.mdx index a6d6a67a0..370477d1c 100644 --- a/packages/web/src/content/docs/nb/share.mdx +++ b/packages/web/src/content/docs/nb/share.mdx @@ -1,5 +1,5 @@ --- -title: Dele +title: Deling description: Del dine OpenCode-samtaler. --- @@ -123,6 +123,6 @@ For bedriftsimplementeringer kan delingsfunksjonen være: - **Deaktivert** helt for overholdelse av sikkerhet - **Begrenset** til brukere som kun er autentisert gjennom SSO -- **Selvvert** på din egen infrastruktur +- **Selv-hostet** på din egen infrastruktur [Finn ut mer](/docs/enterprise) om bruk av opencode i organisasjonen din. diff --git a/packages/web/src/content/docs/nb/skills.mdx b/packages/web/src/content/docs/nb/skills.mdx index 9c4151535..717ad87df 100644 --- a/packages/web/src/content/docs/nb/skills.mdx +++ b/packages/web/src/content/docs/nb/skills.mdx @@ -1,10 +1,10 @@ --- title: "Agentferdigheter" -description: "Definer gjenbrukbar atferd via SKILL.md-definisjoner" +description: "Definer gjenbrukbar oppførsel via SKILL.md-definisjoner" --- -Agentferdigheter lar opencode oppdage gjenbrukbare instruksjoner fra repo- eller hjemmekatalogen din. -Ferdigheter lastes inn på forespørsel via det opprinnelige `skill`-verktøyet – agenter ser tilgjengelige ferdigheter og kan laste inn hele innholdet når det er nødvendig. +Agentferdigheter lar OpenCode oppdage gjenbrukbare instruksjoner fra repo- eller hjemmekatalogen din. +Ferdigheter lastes inn på forespørsel via det innebygde `skill`-verktøyet – agenter ser tilgjengelige ferdigheter og kan laste inn hele innholdet når det er nødvendig. --- @@ -31,7 +31,7 @@ Globale definisjoner lastes også inn fra `~/.config/opencode/skills/*/SKILL.md` --- -## Skriv frontmaterie +## Skriv frontmatter Hver `SKILL.md` må starte med YAML frontmatter. Bare disse feltene gjenkjennes: @@ -42,7 +42,7 @@ Bare disse feltene gjenkjennes: - `compatibility` (valgfritt) - `metadata` (valgfritt, streng-til-streng kart) -Ukjente frontmatter-felter ignoreres. +Ukjente frontmatter-felt ignoreres. --- @@ -51,10 +51,10 @@ Ukjente frontmatter-felter ignoreres. `name` må: - Bestå av 1–64 tegn -- Vær alfanumerisk med små bokstaver med skilletegn med enkelt bindestrek +- Vær alfanumerisk med små bokstaver, adskilt med enkel bindestrek - Ikke begynne eller slutte med `-` - Ikke inneholde påfølgende `--` -- Match katalognavnet som inneholder `SKILL.md` +- Samsvare med katalognavnet som inneholder `SKILL.md` Ekvivalent regulært uttrykk: @@ -100,9 +100,9 @@ Ask clarifying questions if the target versioning scheme is unclear. --- -## Gjenkjenne verktøybeskrivelsen +## Forstå verktøybeskrivelsen -opencode viser tilgjengelige ferdigheter i `skill` verktøybeskrivelsen. +opencode viser tilgjengelige ferdigheter i `skill`-verktøybeskrivelsen. Hver oppføring inneholder ferdighetsnavnet og beskrivelsen: ```xml @@ -139,11 +139,11 @@ Kontroller hvilke ferdigheter agenter har tilgang til ved å bruke mønsterbaser } ``` -| Tillatelse | Atferd | -| ---------- | ------------------------------------------ | -| `allow` | Ferdigheter lastes umiddelbart | -| `deny` | Ferdighet skjult for agent, tilgang avvist | -| `ask` | Bruker bedt om godkjenning før lasting | +| Tillatelse | Atferd | +| ---------- | ------------------------------------------- | +| `allow` | Ferdigheter lastes umiddelbart | +| `deny` | Ferdighet skjult for agent, tilgang avvist | +| `ask` | Bruker blir bedt om godkjenning før lasting | Mønstre støtter jokertegn: `internal-*` samsvarer med `internal-docs`, `internal-tools` osv. diff --git a/packages/web/src/content/docs/nb/themes.mdx b/packages/web/src/content/docs/nb/themes.mdx index c62adef3d..a294a6a0f 100644 --- a/packages/web/src/content/docs/nb/themes.mdx +++ b/packages/web/src/content/docs/nb/themes.mdx @@ -45,23 +45,23 @@ Og mer, vi legger stadig til nye temaer. ## Systemtema -`system`-temaet er designet for å automatisk tilpasse seg terminalens fargevalg. I motsetning til tradisjonelle temaer som bruker faste farger, er _system_-temaet: +`system`-temaet er designet for å automatisk tilpasse seg terminalens fargeskjema. I motsetning til tradisjonelle temaer som bruker faste farger, er _system_-temaet: -- **Genererer gråskala**: Oppretter en tilpasset gråskala basert på terminalens bakgrunnsfarge, og sikrer optimal kontrast. -- **Bruker ANSI farger**: Bruker standard ANSI farger (0-15) for syntaksutheving og UI elementer, som respekterer terminalens fargepalett. +- **Genererer gråtone**: Oppretter en tilpasset gråskala basert på terminalens bakgrunnsfarge, og sikrer optimal kontrast. +- **Bruker ANSI-farger**: Bruker standard ANSI farger (0-15) for syntaksutheving og UI elementer, som respekterer terminalens fargepalett. - **Bevarer terminalens standardinnstillinger**: Bruker `none` for tekst- og bakgrunnsfarger for å opprettholde terminalens opprinnelige utseende. Systemtemaet er for brukere som: - Vil at opencode skal matche terminalens utseende -- Bruk tilpassede terminalfargeskjemaer +- Bruker tilpassede terminalfargeskjemaer - Foretrekker et konsistent utseende på tvers av alle terminalapplikasjoner --- ## Bruke et tema -Du kan velge et tema ved å hente frem temavalg med kommandoen `/theme`. Eller du kan spesifisere det i [config](/docs/config). +Du kan velge et tema ved å åpne temavelgeren med kommandoen `/theme`. Eller du kan spesifisere det i [config](/docs/config). ```json title="opencode.json" {3} { @@ -95,7 +95,7 @@ Hvis flere kataloger inneholder et tema med samme navn, vil temaet fra katalogen For å lage et tilpasset tema, lag en JSON-fil i en av temakatalogene. -For brukeromfattende temaer: +For brukerspesifikke temaer: ```bash no-frame mkdir -p ~/.config/opencode/themes @@ -111,12 +111,12 @@ vim .opencode/themes/my-theme.json --- -### JSON format +### JSON-format Temaer bruker et fleksibelt JSON-format med støtte for: -- **Sekskantfarger**: `"#ffffff"` -- **ANSI farger**: `3` (0-255) +- **Hex-farger**: `"#ffffff"` +- **ANSI-farger**: `3` (0-255) - **Fargereferanser**: `"primary"` eller egendefinerte definisjoner - **Mørke/lyse varianter**: `{"dark": "#000", "light": "#fff"}` - **Ingen farge**: `"none"` - Bruker terminalens standardfarge eller transparent diff --git a/packages/web/src/content/docs/nb/tools.mdx b/packages/web/src/content/docs/nb/tools.mdx index 841d44c8e..089a0cbb5 100644 --- a/packages/web/src/content/docs/nb/tools.mdx +++ b/packages/web/src/content/docs/nb/tools.mdx @@ -9,7 +9,7 @@ Som standard er alle verktøy **aktivert** og trenger ikke tillatelse for å kj --- -## Konfigurer +## Konfigurasjon Bruk feltet `permission` for å kontrollere verktøyets oppførsel. Du kan tillate, avslå eller kreve godkjenning for hvert verktøy. @@ -47,7 +47,7 @@ Her er alle de innebygde verktøyene som er tilgjengelige i OpenCode. ### bash -Utfør shell-kommandoer i prosjektmiljøet ditt. +Utfør skallkommandoer i prosjektmiljøet ditt. ```json title="opencode.json" {4} { @@ -58,7 +58,7 @@ Utfør shell-kommandoer i prosjektmiljøet ditt. } ``` -Dette verktøyet lar LLM kjøre terminalkommandoer som `npm install`, `git status` eller en hvilken som helst annen shell-kommando. +Dette verktøyet lar LLM kjøre terminalkommandoer som `npm install`, `git status` eller en hvilken som helst annen skallkommando. --- @@ -168,9 +168,9 @@ Dette verktøyet viser kataloginnhold. Den aksepterer glob-mønstre for å filtr --- -### lsp (experimental) +### lsp (eksperimentell) -Samhandle med dine konfigurerte LSP-servere for å få kodeintelligensfunksjoner som definisjoner, referanser, sveveinformasjon og anropshierarki. +Samhandle med dine konfigurerte LSP-servere for å få kodeintelligens-funksjoner som definisjoner, referanser, hover-informasjon og kallhierarki. :::note Dette verktøyet er bare tilgjengelig når `OPENCODE_EXPERIMENTAL_LSP_TOOL=true` (eller `OPENCODE_EXPERIMENTAL=true`). @@ -204,7 +204,7 @@ Bruk patcher på filer. } ``` -Dette verktøyet bruker oppdateringsfiler til kodebasen din. Nyttig for å påføre diff og lapper fra forskjellige kilder. +Dette verktøyet bruker oppdateringsfiler til kodebasen din. Nyttig for å påføre diffs og patcher fra forskjellige kilder. :::note `patch`-verktøyet kontrolleres av tillatelsen `edit`, som dekker alle filendringer (`edit`, `write`, `patch`, `multiedit`). @@ -291,7 +291,7 @@ Lar LLM hente og lese nettsider. Nyttig for å slå opp dokumentasjon eller fors Søk på nettet for informasjon. :::note -Dette verktøyet er bare tilgjengelig når du bruker OpenCode-leverandøren eller når miljøvariabelen `OPENCODE_ENABLE_EXA` er satt til en sannverdi (f.eks. `true` eller `1`). +Dette verktøyet er bare tilgjengelig når du bruker OpenCode-leverandøren eller når miljøvariabelen `OPENCODE_ENABLE_EXA` er satt til en sann verdi (f.eks. `true` eller `1`). Slik aktiverer du når du starter OpenCode: @@ -362,7 +362,7 @@ MCP (Model Context Protocol) servere lar deg integrere eksterne verktøy og tjen ## Internaler -Internt bruker verktøy som `grep`, `glob` og `list` [ripgrep](https://github.com/BurntSushi/ripgrep) under panseret. Som standard respekterer ripgrep `.gitignore`-mønstre, noe som betyr at filer og kataloger som er oppført i `.gitignore` vil bli ekskludert fra søk og oppføringer. +Internt bruker verktøy som `grep`, `glob` og `list` [ripgrep](https://github.com/BurntSushi/ripgrep) i bakgrunnen. Som standard respekterer ripgrep `.gitignore`-mønstre, noe som betyr at filer og kataloger som er oppført i `.gitignore` vil bli ekskludert fra søk og oppføringer. --- diff --git a/packages/web/src/content/docs/nb/troubleshooting.mdx b/packages/web/src/content/docs/nb/troubleshooting.mdx index 057f0db27..006008415 100644 --- a/packages/web/src/content/docs/nb/troubleshooting.mdx +++ b/packages/web/src/content/docs/nb/troubleshooting.mdx @@ -37,7 +37,7 @@ Denne katalogen inneholder: --- -## Desktop-app +## Skrivebordsapp OpenCode Desktop kjører en lokal OpenCode-server (`opencode-cli` sidevognen) i bakgrunnen. De fleste problemene er forårsaket av en plugin som fungerer dårlig, en ødelagt cache eller en dårlig serverinnstilling. @@ -105,7 +105,7 @@ OpenCode Desktop kan enten starte sin egen lokale server (standard) eller koble Hvis du ser en **"Tilkobling mislyktes"**-dialogboks (eller appen kommer aldri forbi splash-skjermen), se etter en tilpasset server URL. -#### Slett standardserveren for skrivebordet URL +#### Slett skrivebordsappens standardserver-URL Fra startskjermen klikker du på servernavnet (med statusprikken) for å åpne servervelgeren. I delen **Standardserver** klikker du på **Slett**. @@ -153,7 +153,7 @@ OpenCode Desktop viser bare systemvarsler når: ### Tilbakestill skrivebordsapplagring (siste utvei) -Hvis appen ikke starter og du ikke kan slette innstillingene fra UI, tilbakestill skrivebordsappens lagrede tilstand. +Hvis appen ikke starter og du ikke kan slette innstillingene fra UI-et, tilbakestill skrivebordsappens lagrede tilstand. 1. Avslutt OpenCode Desktop. 2. Finn og slett disse filene (de finnes i OpenCode Desktop-appens datakatalog): @@ -161,54 +161,6 @@ Hvis appen ikke starter og du ikke kan slette innstillingene fra UI, tilbakestil - `opencode.settings.dat` (stasjonær standardserver URL) - `opencode.global.dat` og `opencode.workspace.*.dat` (UI tilstand som nylige servere/prosjekter) -Slik finner du katalogen raskt: - -- **macOS**: Finder -> `Cmd+Shift+G` -> `~/Library/Application Support` (søk deretter etter filnavnene ovenfor) -- **Linux**: søk under `~/.local/share` etter filnavnene ovenfor -- **Windows**: Trykk `WIN+R` -> `%APPDATA%` (søk deretter etter filnavnene ovenfor) - ---- - -## Får hjelp - -Hvis du opplever problemer med OpenCode: - -1. **Rapporter problemer på GitHub** - - Den beste måten å rapportere feil eller be om funksjoner på er gjennom vårt GitHub-lager: - - [**github.com/anomalyco/opencode/issues**](https://github.com/anomalyco/opencode/issues) - - Før du oppretter et nytt problem, søk i eksisterende problemer for å se om problemet ditt allerede er rapportert. - -2. **Bli med i vår Discord** - - For sanntidshjelp og fellesskapsdiskusjon, bli med i vår Discord-server: - - [**opencode.ai/discord**](https://opencode.ai/discord) - ---- - -## Vanlige problemer - -Her er noen vanlige problemer og hvordan du kan løse dem. - ---- - -### OpenCode vil ikke starte - -1. Sjekk loggene for feilmeldinger -2. Prøv å kjøre med `--print-logs` for å se utdata i terminalen -3. Sørg for at du har den nyeste versjonen med `opencode upgrade` - ---- - -### Autentiseringsproblemer - -1. Prøv å autentisere på nytt med kommandoen `/connect` i TUI -2. Sjekk at API-nøklene dine er gyldige -3. Sørg for at nettverket ditt tillater tilkoblinger til leverandørens API - --- ### Modellen er ikke tilgjengelig @@ -217,42 +169,15 @@ Her er noen vanlige problemer og hvordan du kan løse dem. 2. Kontroller at modellnavnet i konfigurasjonen er riktig 3. Noen modeller kan kreve spesifikk tilgang eller abonnement -Hvis du støter på `ProviderModelNotFoundError` er du mest sannsynlig feil -refererer til en modell et sted. +Hvis du støter på `ProviderModelNotFoundError` refererer du mest sannsynlig feil +til en modell et sted. Modeller skal refereres slik: `/` -Eksempler: - -- `openai/gpt-4.1` -- `openrouter/google/gemini-2.5-flash` -- `opencode/kimi-k2` - -For å finne ut hvilke modeller du har tilgang til, kjør `opencode models` - ---- - -### ProviderInitError - -Hvis du støter på en ProviderInitError, har du sannsynligvis en ugyldig eller ødelagt konfigurasjon. - -For å løse dette: - -1. Kontroller først at leverandøren din er riktig konfigurert ved å følge [leverandørveiledningen](/docs/providers) -2. Hvis problemet vedvarer, prøv å tømme den lagrede konfigurasjonen: - - ```bash - rm -rf ~/.local/share/opencode - ``` - - På Windows, trykk `WIN+R` og slett: `%USERPROFILE%\.local\share\opencode` - -3. Autentiser på nytt med leverandøren din ved å bruke kommandoen `/connect` i TUI. - --- ### AI_APICallError og leverandørpakkeproblemer -Hvis du støter på API-anropsfeil, kan dette skyldes utdaterte leverandørpakker. OpenCode installerer dynamisk leverandørpakker (OpenAI, Anthropic, Google, etc.) etter behov og cacher dem lokalt. +Hvis du støter på API-anropsfeil, kan dette skyldes utdaterte provider-pakker. OpenCode installerer dynamisk provider-pakker (OpenAI, Anthropic, Google, etc.) etter behov og cacher dem lokalt. For å løse problemer med leverandørpakke: @@ -264,15 +189,15 @@ For å løse problemer med leverandørpakke: På Windows, trykk `WIN+R` og slett: `%USERPROFILE%\.cache\opencode` -2. Start OpenCode på nytt for å installere de nyeste leverandørpakkene på nytt +2. Start OpenCode på nytt for å installere de nyeste provider-pakkene på nytt -Dette vil tvinge OpenCode til å laste ned de nyeste versjonene av leverandørpakkene, som ofte løser kompatibilitetsproblemer med modellparametere og API-endringer. +Dette vil tvinge OpenCode til å laste ned de nyeste versjonene av provider-pakkene, som ofte løser kompatibilitetsproblemer med modellparametere og API-endringer. --- ### Kopier/lim inn fungerer ikke på Linux -Linux-brukere må ha ett av følgende utklippstavleverktøy installert for at kopier/lim inn-funksjonalitet skal fungere: +Linux-brukere må ha ett av følgende utklippstavle-verktøy installert for at kopier/lim inn-funksjonalitet skal fungere: **For X11-systemer:** @@ -288,7 +213,7 @@ apt install -y xsel apt install -y wl-clipboard ``` -**For hodeløse miljøer:** +**For headless-miljøer:** ```bash apt install -y xvfb @@ -297,4 +222,4 @@ Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 & export DISPLAY=:99.0 ``` -OpenCode vil oppdage om du bruker Wayland og foretrekker `wl-clipboard`, ellers vil den prøve å finne utklippstavleverktøy i rekkefølgen: `xclip` og `xsel`. +OpenCode vil oppdage om du bruker Wayland og foretrekker `wl-clipboard`, ellers vil den prøve å finne utklippstavle-verktøy i rekkefølgen: `xclip` og `xsel`. diff --git a/packages/web/src/content/docs/nb/tui.mdx b/packages/web/src/content/docs/nb/tui.mdx index 76134b4e8..fae2a2364 100644 --- a/packages/web/src/content/docs/nb/tui.mdx +++ b/packages/web/src/content/docs/nb/tui.mdx @@ -5,7 +5,7 @@ description: Bruke opencode-terminalbrukergrensesnittet. import { Tabs, TabItem } from "@astrojs/starlight/components" -opencode gir et interaktivt terminalgrensesnitt eller TUI for å jobbe med prosjektene dine med en LLM. +opencode gir et interaktivt terminalgrensesnitt (TUI) for å jobbe med prosjektene dine med en LLM. Å kjøre opencode starter TUI for gjeldende katalog. @@ -13,13 +13,13 @@ opencode gir et interaktivt terminalgrensesnitt eller TUI for å jobbe med prosj opencode ``` -Eller du kan starte den for en bestemt arbeidskatalog. +Eller du kan starte den for en spesifikk arbeidskatalog. ```bash opencode /path/to/project ``` -Når du er i TUI, kan du spørre den med en melding. +Når du er i TUI, kan du stille den spørsmål med en prompt. ```text Give me a quick summary of the codebase. @@ -29,7 +29,7 @@ Give me a quick summary of the codebase. ## Filreferanser -Du kan referere til filer i meldingene dine ved å bruke `@`. Dette gjør et uklar filsøk i gjeldende arbeidskatalog. +Du kan referere til filer i meldingene dine ved å bruke `@`. Dette gjør et fuzzy-filsøk i gjeldende arbeidskatalog. :::tip Du kan også bruke `@` til å referere til filer i meldingene dine. @@ -45,7 +45,7 @@ Innholdet i filen legges automatisk til samtalen. ## Bash-kommandoer -Start en melding med `!` for å kjøre en shell-kommando. +Start en melding med `!` for å kjøre en skallkommando. ```bash frame="none" !ls -la @@ -63,13 +63,13 @@ Når du bruker opencode TUI, kan du skrive `/` etterfulgt av et kommandonavn for /help ``` -De fleste kommandoer har også tastebinding som bruker `ctrl+x` som ledernøkkel, der `ctrl+x` er standard ledernøkkel. [Finn ut mer](/docs/keybinds). +De fleste kommandoer har også tastebinding som bruker `ctrl+x` som leader-tast, der `ctrl+x` er standard leader-tast. [Finn ut mer](/docs/keybinds). -Her er alle tilgjengelige skråstrekkommandoer: +Her er alle tilgjengelige slash-kommandoer: --- -### koble til +### connect Legg til en leverandør til opencode. Lar deg velge fra tilgjengelige leverandører og legge til deres API-nøkler. @@ -79,7 +79,7 @@ Legg til en leverandør til opencode. Lar deg velge fra tilgjengelige leverandø --- -### kompakt +### compact Komprimer gjeldende økt. _Alias_: `/summarize` @@ -91,9 +91,9 @@ Komprimer gjeldende økt. _Alias_: `/summarize` --- -### detaljer +### details -Veksle verktøyutførelsesdetaljer. +Veksle visning av verktøydetaljer. ```bash frame="none" /details @@ -103,9 +103,9 @@ Veksle verktøyutførelsesdetaljer. --- -### redaktør +### editor -Åpne eksternt redigeringsprogram for å skrive meldinger. Bruker redigeringssettet i miljøvariabelen `EDITOR`. [Finn ut mer](#editor-setup). +Åpne eksternt tekstredigeringsprogram for å skrive meldinger. Bruker redigeringssettet i miljøvariabelen `EDITOR`. [Finn ut mer](#editor-setup). ```bash frame="none" /editor @@ -115,7 +115,7 @@ Veksle verktøyutførelsesdetaljer. --- -### avslutt +### exit Avslutt opencode. _Aliaser_: `/quit`, `/q` @@ -127,7 +127,7 @@ Avslutt opencode. _Aliaser_: `/quit`, `/q` --- -### eksport +### export Eksporter gjeldende samtale til Markdown og åpne i standardredigeringsprogrammet. Bruker redigeringssettet i miljøvariabelen `EDITOR`. [Finn ut mer](#editor-setup). @@ -139,7 +139,7 @@ Eksporter gjeldende samtale til Markdown og åpne i standardredigeringsprogramme --- -### hjelp +### help Vis hjelpedialogen. @@ -163,7 +163,7 @@ Opprett eller oppdater `AGENTS.md`-fil. [Finn ut mer](/docs/rules). --- -### modeller +### models Liste over tilgjengelige modeller. @@ -175,7 +175,7 @@ Liste over tilgjengelige modeller. --- -### ny +### new Start en ny økt. _Alias_: `/clear` @@ -187,7 +187,7 @@ Start en ny økt. _Alias_: `/clear` --- -### gjør om +### redo Gjenta en tidligere angret melding. Kun tilgjengelig etter bruk av `/undo`. @@ -196,7 +196,7 @@ Eventuelle filendringer vil også bli gjenopprettet. ::: Internt bruker dette Git til å administrere filendringene. Så ditt prosjekt **må -være et Git-depot**. +være et Git-repo**. ```bash frame="none" /redo @@ -206,7 +206,7 @@ være et Git-depot**. --- -### økter +### sessions List opp og bytt mellom økter. _Aliaser_: `/resume`, `/continue` @@ -218,7 +218,7 @@ List opp og bytt mellom økter. _Aliaser_: `/resume`, `/continue` --- -### del +### share Del gjeldende økt. [Finn ut mer](/docs/share). @@ -230,7 +230,7 @@ Del gjeldende økt. [Finn ut mer](/docs/share). --- -### temaer +### theme Liste over tilgjengelige temaer. @@ -242,7 +242,7 @@ Liste over tilgjengelige temaer. --- -### tenker +### thinking Veksle mellom synligheten av tenke-/resonneringsblokker i samtalen. Når den er aktivert, kan du se modellens resonneringsprosess for modeller som støtter utvidet tenkning. @@ -256,7 +256,7 @@ Denne kommandoen kontrollerer bare om tenkeblokker **vises** - den aktiverer ell --- -### angre +### undo Angre siste melding i samtalen. Fjerner den siste brukermeldingen, alle påfølgende svar og eventuelle filendringer. @@ -265,7 +265,7 @@ Eventuelle filendringer vil også bli tilbakestilt. ::: Internt bruker dette Git til å administrere filendringene. Så ditt prosjekt **må -være et Git-depot**. +være et Git-repo**. ```bash frame="none" /undo @@ -275,7 +275,7 @@ være et Git-depot**. --- -### avbryt deling +### unshare Opphev deling av gjeldende økt. [Finn ut mer](/docs/share#un-sharing). @@ -285,9 +285,9 @@ Opphev deling av gjeldende økt. [Finn ut mer](/docs/share#un-sharing). --- -## Redaktøroppsett +## Oppsett av editor -Både kommandoene `/editor` og `/export` bruker redigeringsprogrammet som er spesifisert i miljøvariabelen `EDITOR`. +Både kommandoene `/editor` og `/export` bruker editoren som er spesifisert i miljøvariabelen `EDITOR`. @@ -334,26 +334,26 @@ Både kommandoene `/editor` og `/export` bruker redigeringsprogrammet som er spe -Populære redigeringsalternativer inkluderer: +Populære editor-alternativer inkluderer: - `code` - Visual Studio Code - `cursor` - Cursor - `windsurf` - Windsurf -- `nvim` - Neovim-redaktør +- `nvim` - Neovim-editor - `vim` - Vim editor - `nano` - Nano-editor - `notepad` - Windows Notisblokk - `subl` - Sublime Text :::note -Noen redaktører som VS Code må startes med flagget `--wait`. +Noen editorer som VS Code må startes med flagget `--wait`. ::: -Noen redaktører trenger kommandolinjeargumenter for å kjøre i blokkeringsmodus. `--wait`-flagget gjør at redigeringsprosessen blokkeres til den lukkes. +Noen editorer trenger kommandolinjeargumenter for å kjøre i blokkeringsmodus. `--wait`-flagget gjør at editor-prosessen blokkeres til den lukkes. --- -## Konfigurer +## Konfigurasjon Du kan tilpasse TUI-oppførselen gjennom opencode-konfigurasjonsfilen. diff --git a/packages/web/src/content/docs/nb/web.mdx b/packages/web/src/content/docs/nb/web.mdx index 2619e385b..c8cc9d413 100644 --- a/packages/web/src/content/docs/nb/web.mdx +++ b/packages/web/src/content/docs/nb/web.mdx @@ -9,7 +9,7 @@ OpenCode kan kjøres som en nettapplikasjon i nettleseren din, og gir den samme ## Komme i gang -Start nettgrensesnittet ved å kjøre: +Start web-grensesnittet ved å kjøre: ```bash opencode web @@ -17,19 +17,11 @@ opencode web Dette starter en lokal server på `127.0.0.1` med en tilfeldig tilgjengelig port og åpner automatisk OpenCode i standard nettleser. -:::caution -Hvis `OPENCODE_SERVER_PASSWORD` ikke er satt, vil serveren være usikret. Dette er greit for lokal bruk, men bør settes for nettverkstilgang. -::: - -:::tip[Windows-brukere] -For den beste opplevelsen, kjør `opencode web` fra [WSL](/docs/windows-wsl) i stedet for PowerShell. Dette sikrer riktig filsystemtilgang og terminalintegrasjon. -::: - --- ## Konfigurasjon -Du kan konfigurere webserveren ved å bruke kommandolinjeflagg eller i [konfigurasjonsfil](/docs/config). +Du kan konfigurere webserveren ved å bruke kommandolinjeflagg eller i [konfigurasjonsfilen](/docs/config). ### Port @@ -41,42 +33,13 @@ opencode web --port 4096 ### Vertsnavn -Som standard binder serveren seg til `127.0.0.1` (kun lokal vert). Slik gjør du OpenCode tilgjengelig på nettverket ditt: +Som standard binder serveren seg til `127.0.0.1` (kun localhost). Slik gjør du OpenCode tilgjengelig på nettverket ditt: ```bash opencode web --hostname 0.0.0.0 ``` -Når du bruker `0.0.0.0`, vil OpenCode vise både lokale adresser og nettverksadresser: - -``` - Local access: http://localhost:4096 - Network access: http://192.168.1.100:4096 -``` - -### mDNS-oppdagelse - -Aktiver mDNS for å gjøre serveren din synlig på det lokale nettverket: - -```bash -opencode web --mdns -``` - -Dette setter automatisk vertsnavnet til `0.0.0.0` og annonserer serveren som `opencode.local`. - -Du kan tilpasse mDNS-domenenavnet til å kjøre flere forekomster på samme nettverk: - -```bash -opencode web --mdns --mdns-domain myproject.local -``` - -### CORS - -For å tillate flere domener for CORS (nyttig for egendefinerte grensesnitt): - -```bash -opencode web --cors https://example.com -``` +--- ### Autentisering @@ -86,13 +49,13 @@ For å beskytte tilgang, angi et passord ved hjelp av miljøvariabelen `OPENCODE OPENCODE_SERVER_PASSWORD=secret opencode web ``` -Brukernavnet er standard til `opencode`, men kan endres med `OPENCODE_SERVER_USERNAME`. +Brukernavnet er satt til `opencode` som standard, men kan endres med `OPENCODE_SERVER_USERNAME`. --- ## Bruke webgrensesnittet -Når det er startet, gir nettgrensesnittet tilgang til dine OpenCode-økter. +Når den er startet, gir nettgrensesnittet tilgang til dine OpenCode-økter. ### Sesjoner @@ -102,7 +65,7 @@ Se og administrer øktene dine fra hjemmesiden. Du kan se aktive økter og start ### Serverstatus -Klikk "Se servere" for å se tilkoblede servere og deres status. +Klikk på "Se servere" for å se tilkoblede servere og deres status. ![OpenCode Web - Se servere](../../../assets/web/web-homepage-see-servers.png) diff --git a/packages/web/src/content/docs/nb/windows-wsl.mdx b/packages/web/src/content/docs/nb/windows-wsl.mdx index d6f9388c5..7ffc141cd 100644 --- a/packages/web/src/content/docs/nb/windows-wsl.mdx +++ b/packages/web/src/content/docs/nb/windows-wsl.mdx @@ -31,7 +31,7 @@ WSL gir bedre filsystemytelse, full terminalstøtte og kompatibilitet med utvikl 3. **Bruk OpenCode fra WSL** - Gå til prosjektmappen din (Windows-filer finnes via `/mnt/c/`, `/mnt/d/` osv.) og kjør OpenCode. + Gå til prosjektmappen din (Windows-filer er tilgjengelige via `/mnt/c/`, `/mnt/d/` osv.) og kjør OpenCode. ```bash cd /mnt/c/Users/YourName/project @@ -69,9 +69,9 @@ OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0 --- -## Nettklient + WSL +## Web-klient + WSL -For best nettopplevelse på Windows: +For best web-opplevelse på Windows: 1. **Kjør `opencode web` i WSL-terminalen** i stedet for PowerShell: diff --git a/packages/web/src/content/docs/nb/zen.mdx b/packages/web/src/content/docs/nb/zen.mdx index 974769435..f8dac0f39 100644 --- a/packages/web/src/content/docs/nb/zen.mdx +++ b/packages/web/src/content/docs/nb/zen.mdx @@ -114,7 +114,7 @@ https://opencode.ai/zen/v1/models Vi støtter en pay-as-you-go-modell. Nedenfor er prisene **per 1 million tokens**. -| Modell | Inngang | Utgang | Bufret lesing | Bufret skriving | +| Modell | Inndata | Utdata | Bufret lesing | Bufret skriving | | --------------------------------- | ------- | ------ | ------------- | --------------- | | Big Pickle | Gratis | Gratis | Gratis | - | | MiniMax M2.1 Free | Gratis | Gratis | Gratis | - | @@ -167,11 +167,11 @@ De gratis modellene: --- -### Last inn automatisk +### Automatisk påfylling -Hvis saldoen din går under $5, vil Zen automatisk laste inn $20 på nytt. +Hvis saldoen din går under $5, vil Zen automatisk fylle på med $20. -Du kan endre beløpet for automatisk påfylling. Du kan også deaktivere automatisk reload helt. +Du kan endre beløpet for automatisk påfylling. Du kan også deaktivere automatisk påfylling helt. --- @@ -181,14 +181,14 @@ Du kan også angi en månedlig bruksgrense for hele arbeidsområdet og for hver medlem av teamet ditt. La oss for eksempel si at du setter en månedlig bruksgrense til $20, Zen vil ikke bruke -mer enn $20 på en måned. Men hvis du har automatisk reload aktivert, kan Zen ende opp +mer enn $20 på en måned. Men hvis du har automatisk påfylling aktivert, kan Zen ende opp belaster deg mer enn $20 hvis saldoen din går under $5. --- ## Personvern -Alle våre modeller er vert i US. Leverandørene våre følger en nulloppbevaringspolicy og bruker ikke dataene dine til modellopplæring, med følgende unntak: +Alle våre modeller er hostet i USA. Leverandørene våre følger retningslinjer om ingen datalagring og bruker ikke dataene dine til modellopplæring, med følgende unntak: - Big Pickle: I løpet av gratisperioden kan innsamlede data brukes til å forbedre modellen. - GLM 4.7 Free: I løpet av gratisperioden kan innsamlede data brukes til å forbedre modellen. @@ -249,6 +249,6 @@ og du vil bruke det i stedet for det Zen gir. Vi opprettet OpenCode Zen for å: 1. **Benchmark** de beste modellene/leverandørene for kodingsagenter. -2. Ha tilgang til alternativene for **høyeste kvalitet** og ikke nedgrader ytelsen eller rute til billigere leverandører. -3. Gi videre eventuelle **prisfall** ved å selge til kostpris; så den eneste markeringen er å dekke behandlingsgebyrene våre. +2. Ha tilgang til alternativene for **høyeste kvalitet** og ikke nedgrader ytelsen eller rute trafikk til billigere leverandører. +3. Gi videre eventuelle **prisfall** ved å selge til kostpris; så det eneste påslaget er å dekke behandlingsgebyrene våre. 4. Ha **ingen låsing** ved å la deg bruke den med en hvilken som helst annen kodeagent. Og la deg alltid bruke en hvilken som helst annen leverandør med opencode også. diff --git a/packages/web/src/content/docs/pl/acp.mdx b/packages/web/src/content/docs/pl/acp.mdx index 1dd4181f3..3b3c4720e 100644 --- a/packages/web/src/content/docs/pl/acp.mdx +++ b/packages/web/src/content/docs/pl/acp.mdx @@ -1,31 +1,33 @@ --- -title: Wsparcie AKP -description: przetwarzanie opencode w procesorze komunikatu z ACP. +title: ACP +description: Używanie OpenCode z protokołem Agent Client Protocol (ACP). --- -opencode obsługi [Protokół klienta agenta](https://agentclientprotocol.com) lub (ACP), dzięki któremu można przejść do oprogramowania bezpośrednio w zainstalowanych edytorach i środowisku IDE. +import { Tabs, TabItem } from "@astrojs/starlight/components" + +OpenCode obsługuje [Agent Client Protocol](https://agentclientprotocol.com) (ACP), który umożliwia korzystanie z OpenCode bezpośrednio w edytorach i środowiskach IDE. :::tip -Lista edytorów i narzędzi obsługujących ACP w [raportu sprzętu ACP](https://zed.dev/blog/acp-progress-report#available-now). +Listę edytorów i narzędzi obsługujących ACP znajdziesz w [raporcie postępu ACP](https://zed.dev/blog/acp-progress-report#available-now). ::: -ACP do otwierania dokumentów, które standaryzują treść między edytorami kodu a agentem kodującym AI. +ACP to otwarty standard, który ujednolica komunikację między edytorami kodu a agentami kodującymi AI. --- -## Skonfiguruj +## Konfiguracja -Aby wybrać opencode przez ACP, skonfiguruj edytor tak, aby wybrać opcję `opencode acp`. +Aby używać OpenCode przez ACP, skonfiguruj swój edytor tak, aby uruchamiał polecenie `opencode acp`. -Uruchomienie opencode jako podproces oprogramowania z ACP, który komunikuje się z edytorem poprzez JSON-RPC poprzez stdio. +Uruchamia to OpenCode jako podproces zgodny z ACP, który komunikuje się z edytorem za pomocą JSON-RPC przez stdio. -Poniżej znajdują się przykłady procesorów obsługujących ACP. +Poniżej znajdują się przykłady dla edytorów obsługujących ACP. --- -### Zeda +### Zed -Dodaj do konstrukcji [Zed](https://zed.dev) (`~/.config/zed/settings.json`): +Dodaj do konfiguracji [Zed](https://zed.dev) (`~/.config/zed/settings.json`): ```json title="~/.config/zed/settings.json" { @@ -38,9 +40,9 @@ Dodaj do konstrukcji [Zed](https://zed.dev) (`~/.config/zed/settings.json`): } ``` -Aby przejść do akcji, `agent: new thread` w **Palecie redakcji**. +Aby użyć, wybierz `agent: new thread` w **Palecie poleceń** (Command Palette). -Można także po skrócie skrótowym, edytując `keymap.json`: +Możesz także przypisać skrót klawiszowy, edytując `keymap.json`: ```json title="keymap.json" [ @@ -67,9 +69,9 @@ Można także po skrócie skrótowym, edytując `keymap.json`: --- -### IDE JetBrains +### JetBrains IDE -Dodaj do swojego [JetBrains IDE](https://www.jetbrains.com/) acp.json zgodnie z [dokumentacją](https://www.jetbrains.com/help/ai-assistant/acp.html): +Dodaj do swojego [JetBrains IDE](https://www.jetbrains.com/) plik `acp.json` zgodnie z [dokumentacją](https://www.jetbrains.com/help/ai-assistant/acp.html): ```json title="acp.json" { @@ -82,13 +84,13 @@ Dodaj do swojego [JetBrains IDE](https://www.jetbrains.com/) acp.json zgodnie z } ``` -Aby przejść do nowego agenta „opencode” w selektorze agenta AI Chat. +Następnie wybierz „OpenCode” w selektorze agentów AI Chat. --- ### Avante.nvim -Dodaj do konstrukcji [Avante.nvim](https://github.com/yetone/avante.nvim): +Dodaj do konfiguracji [Avante.nvim](https://github.com/yetone/avante.nvim): ```lua { @@ -101,7 +103,7 @@ Dodaj do konstrukcji [Avante.nvim](https://github.com/yetone/avante.nvim): } ``` -Jeśli chcesz zachować bezpieczeństwo: +Jeśli potrzebujesz przekazać klucz API: ```lua {6-8} { @@ -121,7 +123,7 @@ Jeśli chcesz zachować bezpieczeństwo: ### CodeCompanion.nvim -Aby opencode jako agenta ACP w [CodeCompanion.nvim](https://github.com/olimorris/codecompanion.nvim), dodaj dodatkowe elementy, aby otrzymać konstrukcje Neovim: +Aby używać OpenCode jako agenta ACP w [CodeCompanion.nvim](https://github.com/olimorris/codecompanion.nvim), dodaj następującą konfigurację do Neovim: ```lua require("codecompanion").setup({ @@ -136,21 +138,21 @@ require("codecompanion").setup({ }) ``` -Ta konfiguracja CodeCompanion wymaga opencode jako agenta ACP dla czatu. +Ta konfiguracja sprawia, że CodeCompanion używa OpenCode jako agenta ACP do czatu. -Jeśli jesteś zarejestrowany jako `OPENCODE_API_KEY`, zapoznaj się z sekcją [Konfigurowanie adapterów: Zmienne przebieg](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) w dokumentacji CodeCompanion.nvim, aby uzyskać szczegółowe informacje. +Jeśli wymagany jest `OPENCODE_API_KEY`, zapoznaj się z sekcją [Konfigurowanie adapterów: Zmienne środowiskowe](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) w dokumentacji CodeCompanion.nvim, aby uzyskać szczegółowe informacje. ## Wsparcie -opencode działa tak samo przez ACP, jak w terminalu. Obsługiwane są wszystkie funkcje: +OpenCode działa przez ACP tak samo, jak w terminalu. Obsługiwane są wszystkie główne funkcje: :::note -początek źródła ukośnikowego, takie jak `/undo` i `/redo`, nie są aktualne pobierane. +Niektóre polecenia z ukośnikiem, takie jak `/undo` i `/redo`, nie są obecnie obsługiwane przez ACP. ::: -- Wbudowane narzędzie (operacje na plikach, rozwiązanie terminala itp.) -- Niestandardowe narzędzie i polecenie ukośnikowe -- Serwery MCP skonfigurowane w konfiguracji opencode -- Zasady dotyczące projektu od `AGENTS.md` -- Niestandardowe formatory i lintery -- Agentów systemowych i uprawnień +- Narzędzia wbudowane (operacje na plikach, terminal itp.) +- Niestandardowe narzędzia i polecenia z ukośnikiem +- Serwery MCP zdefiniowane w konfiguracji OpenCode +- Zasady projektu z `AGENTS.md` +- Niestandardowe formatery i lintery +- Agenci systemowi i uprawnienia diff --git a/packages/web/src/content/docs/pl/agents.mdx b/packages/web/src/content/docs/pl/agents.mdx index 4d04da7b3..7a4d7a996 100644 --- a/packages/web/src/content/docs/pl/agents.mdx +++ b/packages/web/src/content/docs/pl/agents.mdx @@ -1,142 +1,141 @@ --- title: Agenci -description: Konfiguruj i używaj funkcjonalnych agentów. +description: Konfiguruj i używaj potężnych agentów. --- -Agenci to asystenci AI, które można podłączyć do gniazd zasilania i przepływów pracy. Umożliwiają tworzenie ukierunkowanych narzędzi z niestandardowymi monitami, modelami i udostępnianiem narzędzi. +Agenci to asystenci AI, których można przypisać do ról i workflow. Umożliwiają tworzenie ukierunkowanych narzędzi z niestandardowymi promptami, modelami i dostępem do narzędzi. :::tip -Skorzystaj z agenta Plan, aby uzyskać dostęp do kodu i przeglądać informacje bez dodatkowych zmian w kodzie. +Użyj agenta Plan, aby uzyskać dostęp do kodu i przeglądać informacje bez wprowadzania zmian w kodzie. ::: Możesz przełączać się między agentami podczas sesji lub wywoływać ich za pomocą wzmianki `@`. --- -## Typowe +## Typy -W opencode zasada dwóch charakterystycznych agentów; Najpierw Primary i Subagents. +W OpenCode obowiązuje zasada dwóch typów agentów: Primary (Główni) i Subagents (Subagenci). --- -### Primary Agents +### Primary Agents (Agenci główni) -Główne zasady asystenci, z podstawowym kontaktem. Możesz je mieć za pomocą klawisza **Tab** lub podwójnego skrótu klawiszowego `switch_agent`. Ci agenci obsługujący urządzenie główne. Dostęp do narzędzia jest konfigurowany za pomocą uprawnień — na przykład w programie Build wszystkie narzędzia są dostępne, a Plan jest ograniczony. +Główni asystenci, z którymi prowadzisz interakcję. Możesz przełączać się między nimi za pomocą klawisza **Tab** lub skrótu klawiszowego `switch_agent`. Ci agenci obsługują główną pętlę. Dostęp do narzędzi jest konfigurowany za pomocą uprawnień — na przykład w agencie Build wszystkie narzędzia są dostępne, a w agencie Plan są ograniczone. :::tip -Twój klawisz klawisza **Tab**, aby wyłączyć się między agentami podczas sesji. +Użyj klawisza **Tab**, aby przełączać się między agentami podczas sesji. ::: -opencode zawiera dwa puste agenty główne: **Build** i **Plan**. Dobrze -spójrz na te poniżej. +OpenCode zawiera dwa wbudowane agenty główne: **Build** i **Plan**. Przyjrzymy się im poniżej. --- -### Subagents +### Subagents (Subagenci) -Subagenci to pomocniczy asystenci, których można przywoływać agenci główni w celu wykonania podstawowych zadań. Możesz także wytwarzać je, **@ wspominając** o nich w swoich wiadomościach. +Subagenci to asystenci pomocniczy, których mogą przywoływać agenci główni w celu wykonania konkretnych zadań. Możesz także wywoływać ich ręcznie, **wzmiankując ich (@)** w swoich wiadomościach. -opencode ma dwóch subagentów: **General** i **Explore**. Przyjrzymy się temu poniżej. +OpenCode ma dwóch wbudowanych subagentów: **General** i **Explore**. Przyjrzymy się im poniżej. --- -## Wbudowany +## Wbudowane -opencode ma dwa główne agenty i dwa główne agenty podrzędne. +OpenCode ma dwa wbudowane agenty główne i dwa wbudowane subagenty. --- ### Build -_Tryb_: `primary` +_Mode_: `primary` -Kompilacja jest **domyślnym** agentem zastosowania z ukrytymi narzędziami. Jest to standardowy agent do prac programistycznych, którego dostęp jest udostępniony do operacji na plikach i podstawowych systemowych. +Build to **domyślny** agent ogólnego przeznaczenia z pełnym zestawem narzędzi. Jest to standardowy agent do prac programistycznych, który ma dostęp do operacji na plikach i poleceń systemowych. --- ### Plan -_Tryb_: `primary` +_Mode_: `primary` -Zastrzeżony agent do analizy. Używamy systemu, aby włączyć Ci większe ryzyko i zapobiec niezamierzonym zmianom. -Domyślnie są wybrane na `ask`: +Dedykowany agent do analizy. Używa zestawu narzędzi tylko do odczytu, aby zmniejszyć ryzyko i zapobiec niezamierzonym zmianom. +Domyślnie uprawnienia są ustawione na `ask` dla: -- `file edits`: Wszystkie zapisy, transkrypcja i edycje -- `bash`: Wszystkie polecam bash +- `file edits`: Wszystkie zapisy, patche i edycje +- `bash`: Wszystkie polecenia bash -Ten agent jest podłączony, gdy chcesz, aby LLM był kompatybilny z kodem, który wymaga zastosowania lub wersji plastikowej bez konieczności stosowania innej wersji bazy kodu. +Ten agent jest zalecany, gdy chcesz, aby LLM zapoznał się z kodem, stworzył plan lub odpowiedział na pytania bez ryzyka modyfikacji bazy kodu. --- ### General -_Tryb_: `subagent` +_Mode_: `subagent` -Rozwiązanie rozwiązania złożone z zadań wieloetapowych. Pełny dostęp do narzędzia (z funkcjonalnymi funkcjami do wykonania), dzięki czemu może w razie potrzeby zostać dostarczone w plikach. Przewoźnik dziesięć, aby określić wiele jednostek roboczych. +Rozwiązuje złożone zadania wieloetapowe. Pełny dostęp do narzędzi (z możliwością modyfikacji plików), dzięki czemu może w razie potrzeby wprowadzać zmiany w plikach. Używany przez agenta nadrzędnego do delegowania jednostek pracy. --- ### Explore -_Tryb_: `subagent` +_Mode_: `subagent` -Szybki agent tylko do odczytu do eksploracji baz kodu. Nie można modyfikować plików. Użycie tej opcji, jeśli chcesz szybko uzyskać dostęp do plików według wzorców, wyszukać w kodzie słowa kluczowe lub rozwiązania dotyczące zapytań dotyczących bazy kodu. +Szybki agent tylko do odczytu do eksploracji baz kodu. Nie może modyfikować plików. Używany, gdy chcesz szybko znaleźć pliki według wzorców, wyszukać w kodzie słowa kluczowe lub uzyskać odpowiedzi na pytania dotyczące bazy kodu. --- ### Compaction -_Tryb_: `primary` +_Mode_: `primary` -Ukryty agent systemowy, który jest kontekstem kontekstowym w dużym podsumowaniu. W razie działania nie można przejść do interfejsu użytkownika. +Ukryty agent systemowy, który kompresuje kontekst w zwięzłe podsumowanie. Działa automatycznie i nie jest widoczny w interfejsie użytkownika. --- ### Title -_Tryb_: `primary` +_Mode_: `primary` -Ukryty agent systemowy, krótki tytuł sesji. Działa automatycznie i nie można przejść do interfejsu użytkownika. +Ukryty agent systemowy, który generuje krótki tytuł sesji. Działa automatycznie i nie jest widoczny w interfejsie użytkownika. --- ### Summary -_Tryb_: `primary` +_Mode_: `primary` -Ukryty agent systemowy, który stanowi podsumowanie podsumowania sesji. Działa automatycznie i nie można przejść do interfejsu użytkownika. +Ukryty agent systemowy, który generuje podsumowanie sesji. Działa automatycznie i nie jest widoczny w interfejsie użytkownika. --- -## Stosowanie +## Użycie -1. W przypadku agentów głównych klawisza **Tab**, aby przełączać się między nimi podczas sesji. Można również podać z skrótu klawiszowego `switch_agent`. +1. W przypadku agentów głównych użyj klawisza **Tab**, aby przełączać się między nimi podczas sesji. Można to również zrobić za pomocą skrótu klawiszowego `switch_agent`. -2. Subagent można wytwarzać: +2. Subagentów można wywoływać: - **Automatycznie** przez głównych agentów do specjalistycznych zadań na podstawie ich opisów. - - Ręcznie, **@ wspomnienie** o subagencji w Twoich wiadomościach. Na przykład. + - Ręcznie, **wzmiankując (@)** subagenta w swoich wiadomościach. Na przykład: ```txt frame="none" - @general help me search for this function + @explore help me search for this function ``` -3. **Nawigacja pomiędzy sesjami**: Kiedy można mieć własne sesje podrzędne, można nawigować pomiędzy sesjami nadrzędnymi a określonymi podrzędnymi, dostępnymi z: - - **\+Prawo** (lub skonfigurowane przez Ciebie klawisze `session_child_cycle`), aby przełączać się między jednostkami nadrzędnymi → podrzędnymi 1 → podrzędnymi 2 → ... → nadrzędnymi - - **\+Left** (lub skrót klawiszowy `session_child_cycle_reverse`), aby przejść dalej między macierzym ← podnośnik1 ← podnośnik2 ← ... ← prowadzącym +3. **Nawigacja pomiędzy sesjami**: Kiedy sesja ma sesje podrzędne, możesz nawigować pomiędzy sesją nadrzędną a sesjami podrzędnymi za pomocą: + - **\+Prawo** (lub skonfigurowanego klawisza `session_child_cycle`), aby przełączać się w dół: rodzic → dziecko 1 → dziecko 2 → ... → rodzic + - **\+Lewo** (lub skonfigurowanego klawisza `session_child_cycle_reverse`), aby przełączać się w górę: rodzic ← dziecko 1 ← dziecko 2 ← ... ← rodzic - Dostępna możliwość płynnego przełączania pomiędzy rozmową główną a pracą specjalistyczną subagentę. + Umożliwia to płynne przełączanie się między główną rozmową a pracą specjalistyczną wykonywaną przez subagentów. --- -## Skonfiguruj +## Konfiguracja -Możliwość zastosowania agentów lub urządzeń poprzez zastosowanie. Agentów można zidentyfikować na dwóch systemach: +Możesz tworzyć własnych agentów lub dostosowywać istniejących. Agentów można definiować na dwa sposoby: --- ### JSON -Skonfiguruj agenta w pliku konfiguracyjnym `opencode.json`: +Skonfiguruj agenta w pliku `opencode.json`: ```json title="opencode.json" { @@ -177,12 +176,12 @@ Skonfiguruj agenta w pliku konfiguracyjnym `opencode.json`: --- -### Obniżka cen +### Markdown -Można także definiować agentów za pomocą plików przecen. Trzymaj je w: +Możesz także definiować agentów za pomocą plików markdown. Przechowuj je w: - Globalnie: `~/.config/opencode/agents/` -- Na projekt: `.opencode/agents/` +- W projekcie: `.opencode/agents/` ```markdown title="~/.config/opencode/agents/review.md" --- @@ -206,19 +205,19 @@ You are in code review mode. Focus on: Provide constructive feedback without making direct changes. ``` -Nazwa pliku przecen staje się nazwą agenta. Na przykład `review.md` tworzy agenta `review`. +Nazwa pliku markdown staje się nazwą agenta. Na przykład `review.md` tworzy agenta `review`. --- ## Opcje -Przyjrzyjmy się szczegółowo tym opcjom konfiguracji. +Przyjrzyjmy się szczegółowo opcjom konfiguracji. --- -### Opis +### Description (Opis) -miejsce `description`, aby krótko tego, co robi agent i kiedy go stosować. +Użyj `description`, aby krótko opisać, co robi agent i kiedy go używać. ```json title="opencode.json" { @@ -234,11 +233,11 @@ Jest to **wymagana** opcja konfiguracji. --- -### Temperatura +### Temperature (Temperatura) Kontroluj losowość i kreatywność odpowiedzi LLM za pomocą konfiguracji `temperature`. -Niższe wartości, że odpowiedzi są bardziej skupione i deterministyczne, gdy wartość jest innowacyjna i złożona. +Niższe wartości sprawiają, że odpowiedzi są bardziej skupione i deterministyczne, podczas gdy wyższe wartości wprowadzają więcej różnorodności i kreatywności. ```json title="opencode.json" { @@ -253,11 +252,11 @@ Niższe wartości, że odpowiedzi są bardziej skupione i deterministyczne, gdy } ``` -Wartość temperatury zwykle waha się od 0,0 do 1,0: +Wartość temperatury zwykle waha się od 0.0 do 1.0: -- **0,0-0,2**: Bardzo skoncentrowane i deterministyczne odpowiedzi, idealne do analizy i kodu źródłowego -- **0,3-0,5**: Zrównoważona odpowiedź z chwilą powstania, dobre do ogólnych zadań rozwojowych -- **0,6–1,0**: Bardziej kreatywne i odpowiedzi, rozstrzygnięte podczas burzy mózgów i eksploracji +- **0.0-0.2**: Bardzo skoncentrowane i deterministyczne odpowiedzi, idealne do analizy kodu i debugowania +- **0.3-0.5**: Zrównoważone odpowiedzi, dobre do ogólnych zadań programistycznych +- **0.6-1.0**: Bardziej kreatywne i zróżnicowane odpowiedzi, przydatne podczas burzy mózgów i eksploracji ```json title="opencode.json" { @@ -277,15 +276,15 @@ Wartość temperatury zwykle waha się od 0,0 do 1,0: } ``` -Jeśli nie ma wpływu na kontrolę, opencode używa narzędzia do analizy danych dla modelu; 0 dla określonych modeli, 0,55 dla modeli Qwen. +Jeśli nie zostanie skonfigurowana, OpenCode używa wartości domyślnej dla danego modelu; 0 dla modeli rozumowania (reasoning models), 0.55 dla modeli Qwen. --- -### Maksymalna liczba kroków +### Steps (Kroki) -Kontroluj funkcjonowanie iteracji agenta, jaki agent może być, zanim będzie dostępny wyłącznie z tekstem. Dzięki temu użytkownicy kontrolujący koszty mogą mieć wpływ na działanie agentów. +Kontroluj maksymalną liczbę iteracji, jaką agent może wykonać, zanim poprosi o interwencję użytkownika. Pomaga to kontrolować koszty i zapobiegać pętlom. -Jeśli ta opcja nie zostanie skonfigurowana, agent będzie obowiązywał iterację, jeśli model nie zostanie wydany lub użytkownik nie będzie regularnie używany. +Jeśli ta opcja nie zostanie skonfigurowana, agent będzie kontynuował iterację, dopóki model nie zakończy zadania lub użytkownik nie przerwie działania. ```json title="opencode.json" { @@ -299,7 +298,7 @@ Jeśli ta opcja nie zostanie skonfigurowana, agent będzie obowiązywał iteracj } ``` -Po tym, jak agent limitu otrzymuje specjalny monit systemowy nakazujący podsumowanie swojej pracy i rekomendowanych do wykonywania zadań. +Po osiągnięciu limitu agent otrzymuje specjalny monit systemowy nakazujący podsumowanie swojej pracy i zarekomendowanie kolejnych kroków. :::caution Starsze pole `maxSteps` jest przestarzałe. Zamiast tego użyj `steps`. @@ -307,7 +306,7 @@ Starsze pole `maxSteps` jest przestarzałe. Zamiast tego użyj `steps`. --- -### Wymienne +### Disabled (Wyłączony) Ustaw na `true`, aby wyłączyć agenta. @@ -323,9 +322,9 @@ Ustaw na `true`, aby wyłączyć agenta. --- -### Podpowiedź +### Prompt (Monit) -niestandardowy plik podpowiedzi systemowych dla tego agenta z konfiguracją `prompt`. Plik informacyjny powinien zawierać dla celu agenta. +Podaj niestandardowy prompt systemowy dla tego agenta za pomocą konfiguracji `prompt`. Prompt powinien zawierać instrukcje dotyczące celu i zachowania agenta. ```json title="opencode.json" { @@ -337,16 +336,16 @@ niestandardowy plik podpowiedzi systemowych dla tego agenta z konfiguracją `pro } ``` -Ścieżka ta zależy od miejsca, w którym znajduje się plik konfiguracyjny. Działa również w przypadku globalnej konstrukcji opencode, jak i funkcjonalnej dla projektu. +Ścieżka jest względna do miejsca, w którym znajduje się plik konfiguracyjny. Działa to zarówno w przypadku globalnej konfiguracji OpenCode, jak i konfiguracji specyficznej dla projektu. --- ### Model -konstrukcja nośna `model`, aby mieć model dla tego agenta. Przydatne przy różnych modelach konfiguracji w różnych zadaniach. Na przykład zastosowania modelu, skuteczne wykonanie modelu. +Użyj `model`, aby określić model dla tego agenta. Przydatne do używania różnych modeli do różnych zadań. Na przykład użycie modelu rozumowania do planowania, ale szybszego modelu do edycji. :::tip -Jeśli nie ma wpływu na model, główne są [modelu skonfigurowanego globalnie](/docs/config#models), agenci podrzędni podmiotem modelu agenta, który wywołał subagentę. +Jeśli model nie zostanie określony, agenci główni używają [modelu skonfigurowanego globalnie](/docs/config#models), a agenci podrzędni używają modelu agenta, który ich wywołał. ::: ```json title="opencode.json" @@ -359,13 +358,13 @@ Jeśli nie ma wpływu na model, główne są [modelu skonfigurowanego globalnie] } ``` -Identyfikator modelu w konfiguracji opencode w `provider/model-id`. Na koniec, [OpenCode Zen](/docs/zen), przestrzeganie `opencode/gpt-5.1-codex` dla kodeksu GPT 5.1. +Identyfikator modelu jest taki sam, jak w konfiguracji OpenCode w `provider/model-id`. Na przykład, [OpenCode Zen](/docs/zen), użyj `opencode/gpt-5.1-codex` dla GPT 5.1 Codex. --- -### Narzędzia +### Tools (Narzędzia) -Kontroluj, które narzędzia są dostępne w tej agencji, za pomocą konfiguracji `tools`. Można włączyć lub dostępne narzędzie, ustawiając je na `true` lub `false`. +Kontroluj, które narzędzia są dostępne dla tego agenta, za pomocą konfiguracji `tools`. Możesz włączyć lub wyłączyć określone narzędzia, ustawiając je na `true` lub `false`. ```json title="opencode.json" {3-6,9-12} { @@ -386,10 +385,10 @@ Kontroluj, które narzędzia są dostępne w tej agencji, za pomocą konfiguracj ``` :::note -Konfiguracja specjalna dla agenta globalnego. +Konfiguracja specyficzna dla agenta nadpisuje konfigurację globalną. ::: -Można także zastosować symboli wieloznacznych do kontrolowanych wielu narzędzi jednocześnie. Na przykład, aby wyłączyć wszystkie narzędzia z serwera MCP: +Możesz także używać symboli wieloznacznych (wildcards), aby kontrolować wiele narzędzi jednocześnie. Na przykład, aby wyłączyć wszystkie narzędzia z serwera MCP: ```json title="opencode.json" { @@ -410,13 +409,13 @@ Można także zastosować symboli wieloznacznych do kontrolowanych wielu narzęd --- -### Uprawnienia +### Permissions (Uprawnienia) -Może wystąpić możliwość działania, które może pozostać ostateczne przez agenta. Obecnie proste dla narzędzia `edit`, `bash` i `webfetch` można znaleźć w drodze: +Możesz skonfigurować uprawnienia dla potencjalnie wrażliwych działań wykonywanych przez agenta. Obecnie obsługiwane dla narzędzi `edit`, `bash` i `webfetch`: -- `"ask"` — Monituj o zatwierdzenie przed użyciem narzędzia -- `"allow"` — Zezwalaj na wszystkie operacje bez zatwierdzenia -- `"deny"` — Wyłączenie narzędzia +- `"ask"` — Pytaj o zatwierdzenie przed użyciem narzędzia +- `"allow"` — Zezwalaj na użycie bez zatwierdzenia +- `"deny"` — Zabroń użycia narzędzia ```json title="opencode.json" { @@ -427,7 +426,7 @@ Może wystąpić możliwość działania, które może pozostać ostateczne prze } ``` -Można mieć odpowiedni dla każdego agenta. +Możesz nadpisać to dla każdego agenta. ```json title="opencode.json" {3-5,8-10} { @@ -445,7 +444,7 @@ Można mieć odpowiedni dla każdego agenta. } ``` -Można także istnieć w agentach Markdown. +Można to również ustawić w agentach Markdown. ```markdown title="~/.config/opencode/agents/review.md" --- @@ -464,7 +463,7 @@ permission: Only analyze code and suggest changes. ``` -Można podłączyć do gniazda bash. +Możesz to skonfigurować szczegółowo dla poleceń bash. ```json title="opencode.json" {7} { @@ -482,7 +481,7 @@ Można podłączyć do gniazda bash. } ``` -Może być przestrzegany globalnym. +Można to połączyć z globalnym symbolem wieloznacznym. ```json title="opencode.json" {7} { @@ -499,8 +498,8 @@ Może być przestrzegany globalnym. } ``` -Możesz także uzyskać symbolu wieloznacznego `*` do zarządzania uprawnieniami dla wszystkich użytkowników. -Ostatnie dostępne źródło pierwszeństwo, symbol wieloznaczny `*` na pierwszym miejscu, wyodrębnione na końcu. +Możesz także użyć symbolu wieloznacznego `*`, aby zarządzać wszystkimi innymi poleceniami. +Najbardziej szczegółowa reguła ma pierwszeństwo, symbol wieloznaczny `*` jest sprawdzany na końcu. ```json title="opencode.json" {8} { @@ -518,13 +517,13 @@ Ostatnie dostępne źródło pierwszeństwo, symbol wieloznaczny `*` na pierwszy } ``` -[Dowiedz się więcej o prawach](/docs/permissions). +[Dowiedz się więcej o uprawnieniach](/docs/permissions). --- -### Tryb +### Mode (Tryb) -Kontroluj tryb agenta za pomocą konfiguracji `mode`. Opcja `mode` umożliwiająca użycie środka. +Kontroluj tryb agenta za pomocą konfiguracji `mode`. Opcja `mode` określa, w jaki sposób agent może być używany. ```json title="opencode.json" { @@ -536,13 +535,13 @@ Kontroluj tryb agenta za pomocą konfiguracji `mode`. Opcja `mode` umożliwiają } ``` -Opcję `mode` można ustawić na `primary`, `subagent` lub `all`. Jeśli nie dotyczy `mode`, jest to `all`. +Opcję `mode` można ustawić na `primary`, `subagent` lub `all`. Jeśli nie podano `mode`, domyślnie jest to `all`. --- -### Ukryty +### Hidden (Ukryty) -Ukryj subagenta w menu autouzupełniania `@` za pomocą `hidden: true`. Przydatne w postępowaniu sądowym podagenci, potencjalnie być wywoływani programowo przez innych agentów, którzy korzystają z pomocy jako narzędzia. +Ukryj subagenta w menu autouzupełniania `@` za pomocą `hidden: true`. Przydatne w przypadku subagentów narzędziowych, którzy powinni być wywoływani tylko programowo przez innych agentów, a nie bezpośrednio przez użytkownika. ```json title="opencode.json" { @@ -555,17 +554,17 @@ Ukryj subagenta w menu autouzupełniania `@` za pomocą `hidden: true`. Przydatn } ``` -Wpływ tylko na użytkownika w menu autouzupełniania. Model może nadal wywoływać ukrytych agentów za pomocą narzędzi do zadań, funkcji użytkowych. +Wpływa to tylko na widoczność w menu autouzupełniania. Model nadal może wywoływać ukrytych agentów za pomocą narzędzia zadania, jeśli ma do nich dostęp. :::note -Dotyczy tylko agentów `mode: subagent`. +Dotyczy tylko agentów z `mode: subagent`. ::: --- -### Uprawnienia do zadań +### Task Permissions (Uprawnienia zadań) -Kontroluj, których agenci podawców mogą wywołać za pomocą narzędzia zadanie za pomocą `permission.task`. Używa wzorców globalnych do elastycznego dopasowywania. +Kontroluj, których subagentów może wywołać ten agent za pomocą narzędzia zadania, używając `permission.task`. Używa wzorców glob do elastycznego dopasowywania. ```json title="opencode.json" { @@ -584,23 +583,23 @@ Kontroluj, których agenci podawców mogą wywołać za pomocą narzędzia zadan } ``` -Po ustawieniu wartości `deny` podagent zostanie usunięty z opisu narzędzia Zadania, więc model nie będzie gotowy do uruchomienia. +Po ustawieniu wartości `deny` subagent zostanie usunięty z definicji narzędzia Zadania, więc model nie będzie nawet wiedział o jego istnieniu. :::tip -Reguły są następujące w kolejności i **ostatnia reguła wygrywająca**. W zasadzie `orchestrator-planner` jest konfiguracją `*` (odmową), jak i `orchestrator-*` (zezwolenie), ale ponieważ `orchestrator-*` użytkownika po `*`, postać jest `allow`. +Reguły są oceniane w kolejności i **wygrywa ostatnia pasująca reguła**. W powyższym przykładzie `orchestrator-planner` pasuje zarówno do `*` (odmowa), jak i `orchestrator-*` (zezwolenie), ale ponieważ `orchestrator-*` występuje po `*`, wynikiem jest `allow`. ::: :::tip -Zawsze można rozwiązać rozwiązanie, bezpośrednio poprzez menu autouzupełnieniania `@`, nawet jeśli wystąpią zadania agenta temu naprawiające. +Zawsze możesz wywołać subagenta ręcznie, wspominając go bezpośrednio (`@`), nawet jeśli obecny agent ma uprawnienia ustawione na `deny`. ::: --- -### Kolor +### Color (Kolor) -Dostosuj wygląd agenta w interfejsie użytkownika za pomocą opcji `color`. Wpływ na wygląd agenta w interfejsie. +Dostosuj wygląd agenta w interfejsie użytkownika za pomocą opcji `color`. Wpływa to na ikonę i obramowanie agenta w interfejsie. -Użyj koloru hex (np. `#FF5733`) lub koloru motywu: `primary`, `secondary`, `accent`, `success`, `warning`, `error`, `info`. +Użyj kodu hex (np. `#FF5733`) lub nazwy koloru motywu: `primary`, `secondary`, `accent`, `success`, `warning`, `error`, `info`. ```json title="opencode.json" { @@ -619,7 +618,7 @@ Użyj koloru hex (np. `#FF5733`) lub koloru motywu: `primary`, `secondary`, `acc ### Top P -Kontroluj różnorodność odpowiedzi za pomocą opcji `top_p`. Alternatywa dla temperatury w celu kontrolowanej braku wartości. +Kontroluj różnorodność odpowiedzi za pomocą opcji `top_p`. Alternatywa dla temperatury w celu kontrolowania losowości. ```json title="opencode.json" { @@ -631,15 +630,15 @@ Kontroluj różnorodność odpowiedzi za pomocą opcji `top_p`. Alternatywa dla } ``` -Wartość mieszkalna obejmuje zakres od 0,0 do 1,0. Niższe wartości są bardziej skoncentrowane, wyższe wartości są bardziej zaawansowane. +Wartość waha się od 0.0 do 1.0. Niższe wartości są bardziej skoncentrowane, wyższe wartości są bardziej zróżnicowane. --- -### nadal +### Passthrough (Przekazywanie) -Wszelkie inne konfiguracje w agentach **przekazane bezpośrednio** jako model sprzedawcy. Dostęp do funkcji i parametrów dostarczanych dla dostawcy. +Wszelkie inne konfiguracje w agentach są **przekazywane bezpośrednio** do dostawcy modelu. Pozwala to na korzystanie z funkcji i parametrów specyficznych dla dostawcy. -Na przykład dzięki modelowi rozumowania OpenAI może kontrolować rozumowanie: +Na przykład, używając modelu rozumowania OpenAI, możesz kontrolować wysiłek rozumowania: ```json title="opencode.json" {6,7} { @@ -654,55 +653,55 @@ Na przykład dzięki modelowi rozumowania OpenAI może kontrolować rozumowanie: } ``` -Te dodatkowe cechy można zidentyfikować od modelu i dostawcy. Sprawdź swoje dostawcę pod kątem parametrów. +Te dodatkowe właściwości zależą od modelu i dostawcy. Sprawdź dokumentację swojego dostawcy pod kątem dostępnych parametrów. :::tip -Uruchomione `opencode models`, aby wyłączyć modele. +Uruchom `opencode models`, aby zobaczyć dostępne modele. ::: --- -## Utwórz agentów +## Tworzenie agentów -Możesz stworzyć nowych agentów za pomocą innego polecenia: +Możesz stworzyć nowych agentów interaktywnie za pomocą polecenia: ```bash opencode agent create ``` -Wykonaj decyzję: +Poprowadzi Cię to przez proces: -1. Zapytaj, gdzie zapisać agenta; globalne lub szczegółowe dla projektu. -2. Opisz tego, co agent powinien. -3. Wygeneruj właściwy monit systemowy i identyfikator. -4. Wejście do wybrania narzędzia, do którego agenta może być dostęp. -5. Na koniec pliku pliku przecen z konfiguracją agenta. +1. Pytanie o miejsce zapisu agenta (globalnie lub dla projektu). +2. Opis tego, co agent powinien robić. +3. Wygenerowanie odpowiedniego promptu systemowego i identyfikatora. +4. Wybór narzędzi, do których agent powinien mieć dostęp. +5. Zapisanie pliku markdown z konfiguracją agenta. --- ## Przypadki użycia -Oto kilka typowych zastosowań różnych agentów. +Oto kilka typowych zastosowań różnych agentów: -- **Agent użyciai**: Pełne prace programistyczne z dostępnymi narzędziami -- **Plan agenta**: Analiza i planowanie bez zmian -- **Agent recenzujący**: Przegląd kodu z odczytu i narzędzia do dokumentacji -- **Agent debugujący**: Koncentruje się na urządzeniu z dostępnymi narzędziami bash i odczytu -- **Agent Dokumentów**: Zapisywanie dokumentacji za pomocą operacji na plikach, ale bez konieczności posiadania kopii systemowych +- **Agent programista**: Pełne prace programistyczne z dostępem do wszystkich narzędzi. +- **Agent Plan**: Analiza i planowanie bez ryzyka modyfikacji kodu. +- **Agent recenzujący**: Przegląd kodu z dostępem do odczytu plików i narzędzi dokumentacyjnych. +- **Agent debugujący**: Koncentruje się na rozwiązywaniu problemów z dostępem do narzędzi bash i odczytu plików. +- **Agent Documentation**: Tworzenie i utrzymywanie dokumentacji z dostępem do operacji na plikach, ale bez poleceń systemowych. --- -## Przykład +## Przykłady -Oto kilka przykładowych agentów, którzy mogą się przydatni. +Oto kilka przykładowych agentów, którzy mogą być przydatni. :::tip -Czy masz agenta, który jest osobą towarzyszącą? [Prześlij PR](https://github.com/anomalyco/opencode). +Masz agenta, którym warto się podzielić? [Prześlij PR](https://github.com/anomalyco/opencode). ::: --- -### Dokumentacja agenta +### Agent Documentation ```markdown title="~/.config/opencode/agents/docs-writer.md" --- @@ -724,7 +723,7 @@ Focus on: --- -### Audytor bezpieczeństwa +### Security Auditor ```markdown title="~/.config/opencode/agents/security-auditor.md" --- diff --git a/packages/web/src/content/docs/pl/cli.mdx b/packages/web/src/content/docs/pl/cli.mdx index cb5e3b3fd..352185901 100644 --- a/packages/web/src/content/docs/pl/cli.mdx +++ b/packages/web/src/content/docs/pl/cli.mdx @@ -1,17 +1,17 @@ --- title: CLI -description: Opcje i polecenia CLI opencode. +description: Opcje i polecenia wiersza poleceń OpenCode. --- import { Tabs, TabItem } from "@astrojs/starlight/components" -CLI opencode domyślnie uruchamia [TUI](/docs/tui), gdy wywołasz je bez argumentów. +CLI OpenCode domyślnie uruchamia [TUI](/docs/tui), gdy wywołasz je bez argumentów. ```bash opencode ``` -CLI obsługuje też polecenia opisane na tej stronie, więc możesz używać opencode programowo. +CLI obsługuje też polecenia opisane na tej stronie, więc możesz używać OpenCode programowo. ```bash opencode run "Explain how closures work in JavaScript" @@ -21,7 +21,7 @@ opencode run "Explain how closures work in JavaScript" ### tui -Uruchomienie interfejsu użytkownika terminala opencode. +Uruchamia interfejs terminalowy (TUI) OpenCode. ```bash opencode [project] @@ -29,28 +29,28 @@ opencode [project] #### Flagi -| Flaga | Krótkie | Opis | -| ------------ | ------- | ------------------------------------------------------------------------ | -| `--continue` | `-c` | Kontynuuj ostatnią datę | -| `--session` | `-s` | Identyfikator sesji, aby kontynuować | -| `--fork` | | Rozgałęź sesję podczas kontynuacji (użyj z `--continue` lub `--session`) | -| `--prompt` | | Monituj o zastosowanie | -| `--model` | `-m` | Model wykorzystania w postaci dostawcy/modelu | -| `--agent` | | Agent do użycia | -| `--port` | | Port do słuchania | -| `--hostname` | | Nazwa hosta, która jest częścią składową | +| Flaga | Skrót | Opis | +| ------------ | ----- | ----------------------------------------------------------------------- | +| `--continue` | `-c` | Kontynuuj ostatnią sesję | +| `--session` | `-s` | Identyfikator sesji do kontynuowania | +| `--fork` | | Sklonuj sesję podczas kontynuacji (użyj z `--continue` lub `--session`) | +| `--prompt` | | Monit do użycia | +| `--model` | `-m` | Model do użycia w formacie dostawca/model | +| `--agent` | | Agent do użycia | +| `--port` | | Port do nasłuchiwania | +| `--hostname` | | Nazwa hosta, do której należy się powiązać | --- ## Polecenia -Interfejs CLI opencode zawiera także szczegółowe polecenie. +Interfejs CLI OpenCode zawiera także dodatkowe polecenia. --- ### agent -Zarządzaj agentami opencode. +Zarządzaj agentami OpenCode. ```bash opencode agent [command] @@ -60,13 +60,13 @@ opencode agent [command] ### attach -Dołącz terminal do już działającego serwera zaplecza opencode uruchomionego za pomocą oprogramowania `serve` lub `web`. +Dołącz terminal do już działającego serwera backendu OpenCode uruchomionego za pomocą `serve` lub `web`. ```bash opencode attach [url] ``` -Możliwość zabezpieczenia z TUI ze zdalnym backendem opencode. Na przykład: +Pozwala to połączyć TUI ze zdalnym backendem OpenCode. Na przykład: ```bash # Start the backend server for web/mobile access @@ -78,10 +78,10 @@ opencode attach http://10.20.30.40:4096 #### Flagi -| Flaga | Krótkie | Opis | -| ----------- | ------- | ------------------------------------- | -| `--dir` | | Katalog roboczy do uruchomienia TUI w | -| `--session` | `-s` | Identyfikator sesji, aby kontynuować | +| Flaga | Skrót | Opis | +| ----------- | ----- | --------------------------------------- | +| `--dir` | | Katalog roboczy, w którym uruchomić TUI | +| `--session` | `-s` | Identyfikator sesji do kontynuowania | --- @@ -93,13 +93,13 @@ Utwórz nowego agenta z niestandardową konfiguracją. opencode agent create ``` -To działanie poprowadził Cię przez proces tworzenia nowego agenta z niestandardowym monitem systemowym i konfiguracją narzędzia. +To polecenie poprowadzi Cię przez proces tworzenia nowego agenta z niestandardowym promptem systemowym i konfiguracją narzędzi. --- #### list -Lista wszystkich agentów. +Wyświetl listę wszystkich agentów. ```bash opencode agent list @@ -109,7 +109,7 @@ opencode agent list ### auth -Polecenie do zarządzania danymi uwierzytelniającymi i logowaniem dla dostawców. +Zarządzaj danymi uwierzytelniającymi i logowaniem dla dostawców. ```bash opencode auth [command] @@ -119,25 +119,25 @@ opencode auth [command] #### login -opencode jest dostępny przez listę dostawców w [Models.dev](https://models.dev), więc można użyć `opencode auth login` do skonfigurowania klucza API dla dowolnego dostawcy, który może być kontrolowany. Jest to możliwe w `~/.local/share/opencode/auth.json`. +OpenCode integruje się z wieloma dostawcami. Możesz użyć `opencode auth login`, aby skonfigurować klucz API dla dowolnego obsługiwanego dostawcy. Klucze są bezpiecznie przechowywane w `~/.local/share/opencode/auth.json`. ```bash opencode auth login ``` -Po uruchomieniu opencode ładuje dostawców z pliku poświadczeń. A jeśli twoje siedliskiem są jakieś klucze lub plik `.env` w twoim projekcie. +Podczas uruchamiania OpenCode ładuje dostawców z pliku poświadczeń, a także ze zmiennych środowiskowych lub pliku `.env` w Twoim projekcie. --- #### list -Wyświetlanie list wszystkich uwierzytelnionych dostawców przechowywanych w pliku poświadczeń. +Wyświetl listę wszystkich uwierzytelnionych dostawców przechowywanych w pliku poświadczeń. ```bash opencode auth list ``` -Lub krótka wersja. +Lub skrócona wersja: ```bash opencode auth ls @@ -147,7 +147,7 @@ opencode auth ls #### logout -Wylogowuje Cię z dostawcy poprzez usunięcie go z pliku poświadczeń. +Wyloguj się z dostawcy, usuwając go z pliku poświadczeń. ```bash opencode auth logout @@ -173,13 +173,13 @@ Zainstaluj agenta GitHub w swoim repozytorium. opencode github install ``` -Spowoduje to konieczność uruchomienia akcji GitHub i przeprowadzi cię przez proces tworzenia. [Dowiedz się więcej](/docs/github). +Spowoduje to utworzenie pliku workflow GitHub Actions i poprowadzi Cię przez proces konfiguracji. [Dowiedz się więcej](/docs/github). --- #### run -Uruchom agenta na GitHubie. Jest to zwykły użytkownik w akcjach GitHub. +Uruchom agenta na GitHubie. Zwykle używane w GitHub Actions. ```bash opencode github run @@ -187,16 +187,16 @@ opencode github run ##### Flagi -| Flaga | Opis | -| --------- | ------------------------------------------------- | -| `--event` | Zdarzenie próbne GitHub, aby sprawdzić agenta dla | -| `--token` | Osobisty token dostępu GitHub | +| Flaga | Opis | +| --------- | ---------------------------------------- | +| `--event` | Zdarzenie GitHub, które wyzwoliło agenta | +| `--token` | Osobisty token dostępu GitHub | --- -### MCP +### mcp -Zarządzaj serwerem kluczowego modelu kontekstowego. +Zarządzaj serwerami Model Context Protocol (MCP). ```bash opencode mcp [command] @@ -212,19 +212,19 @@ Dodaj serwer MCP do swojej konfiguracji. opencode mcp add ``` -To polecenie poprowadzić Cię przez proces dodawania lokalnego lub zdalnego serwera MCP. +To polecenie poprowadzi Cię przez proces dodawania lokalnego lub zdalnego serwera MCP. --- #### list -Wyświetlanie list wszystkich skonfigurowanych serwerów MCP i ich awarii. +Wyświetl listę wszystkich skonfigurowanych serwerów MCP i ich status. ```bash opencode mcp list ``` -Lub skrót krótkiej wersji. +Lub skrócona wersja: ```bash opencode mcp ls @@ -234,21 +234,21 @@ opencode mcp ls #### auth -Uwierzytelnij się za pomocą serwera MCP z włączoną funkcją OAuth. +Uwierzytelnij się w serwerze MCP z włączoną funkcją OAuth. ```bash opencode mcp auth [name] ``` -Jeśli nie poddasz nazwy serwera, zostaniesz poproszony o wybranie jednego z serwerów obsługujących OAuth. +Jeśli nie podasz nazwy serwera, zostaniesz poproszony o wybranie jednego z serwerów wymagających uwierzytelnienia. -Możesz także uruchomić serwery obsługujące OAuth i ich status uwierzytelnienia. +Możesz także wyświetlić listę serwerów obsługujących OAuth i ich status uwierzytelnienia. ```bash opencode mcp auth list ``` -Lub skrót krótkiej wersji. +Lub skrócona wersja: ```bash opencode mcp auth ls @@ -258,7 +258,7 @@ opencode mcp auth ls #### logout -Usuń doświadczenie OAuth dla serwera MCP. +Usuń tokeny OAuth dla serwera MCP. ```bash opencode mcp logout [name] @@ -278,17 +278,17 @@ opencode mcp debug ### models -Wyświetlanie list modeli wszystkich skonfigurowanych dostawców. +Wyświetl listę modeli ze wszystkich skonfigurowanych dostawców. ```bash opencode models [provider] ``` -Do sterowania dostępnymi modelami u dostawców w `provider/model`. +Pokazuje modele dostępne do użycia w `provider/model`. -Jest to wydanie do nazwy modelu, który jest używany w [twoja] (./config/). +Jest to identyfikator modelu, którego używasz w [konfiguracji](/docs/config). -Opcjonalnie możesz udostępnić identyfikator dostawcy, aby filtrować modele według tego dostawcy. +Opcjonalnie możesz podać identyfikator dostawcy, aby filtrować modele według tego dostawcy. ```bash opencode models anthropic @@ -298,10 +298,10 @@ opencode models anthropic | Flaga | Opis | | ----------- | ------------------------------------------------------------------------------- | -| `--refresh` | Odśwież pamięć podręczną modele z models.dev | +| `--refresh` | Odśwież pamięć podręczną modeli | | `--verbose` | Bardziej szczegółowe dane wyjściowe modelu (zawiera metadane, takie jak koszty) | -flagi `--refresh`, aby znaleźć listę modeli w pamięci podręcznej. Jest to wymagane, gdy dostawca dodano nowe modele, które chcesz zobaczyć w opencode. +Użyj flagi `--refresh`, aby zaktualizować listę modeli w pamięci podręcznej. Jest to przydatne, gdy dostawca dodał nowe modele, które chcesz zobaczyć w OpenCode. ```bash opencode models --refresh @@ -309,21 +309,21 @@ opencode models --refresh --- -### chcesz +### run -Uruchomiony opencode w trybie nieinteraktywnym, przekazując bezpośrednio monit. +Uruchom OpenCode w trybie nieinteraktywnym, przekazując bezpośrednio prompt. ```bash opencode run [message..] ``` -Jest to wymagane w przypadku tworzenia skryptów, automatyzacji lub gdy zostanie wysłane natychmiastowe przesłanie bez uruchomienia TUI. Na przykład. +Jest to przydatne do tworzenia skryptów, automatyzacji lub gdy chcesz wysłać szybkie zapytanie bez uruchamiania TUI. Na przykład: ```bash "opencode run" opencode run Explain the use of context in Go ``` -Można również zastosować, uruchamiając `opencode serve`, aby wyłączyć zimne uruchamianie serwera MCP przy każdym uruchomieniu: +Można również użyć tego z działającym `opencode serve`, aby uniknąć zimnego startu serwera MCP przy każdym uruchomieniu: ```bash # Start a headless server in one terminal @@ -335,47 +335,47 @@ opencode run --attach http://localhost:4096 "Explain async/await in JavaScript" #### Flagi -| Flaga | Krótkie | Opis | -| ------------ | ------- | ------------------------------------------------------------------------ | -| `--command` | | Polecenie do uruchomienia, komunikatu dla argumentów | -| `--continue` | `-c` | Kontynuuj ostatnią datę | -| `--session` | `-s` | Identyfikator sesji, aby kontynuować | -| `--fork` | | Rozgałęź sesję podczas kontynuacji (użyj z `--continue` lub `--session`) | -| `--share` | | Udostępnij sesję | -| `--model` | `-m` | Model wykorzystania w postaci dostawcy/modelu | -| `--agent` | | Agent do użycia | -| `--file` | `-f` | Pliki do załączenia do wiadomości | -| `--format` | | Format: domyślny (sformatowany) lub json (surowe rozwiązanie JSON) | -| `--title` | | Tytuł sesji (używany skróconego monitu, jeśli nie podano wartości) | -| `--attach` | | Dołącz do skutecznego serwera opencode (np. http://localhost:4096) | -| `--port` | | Port dla serwera lokalnego (domyślnie jest do portu losowego) | +| Flaga | Skrót | Opis | +| ------------ | ----- | ----------------------------------------------------------------------- | +| `--command` | | Polecenie do uruchomienia, reszta to argumenty | +| `--continue` | `-c` | Kontynuuj ostatnią sesję | +| `--session` | `-s` | Identyfikator sesji do kontynuowania | +| `--fork` | | Sklonuj sesję podczas kontynuacji (użyj z `--continue` lub `--session`) | +| `--share` | | Udostępnij sesję po zakończeniu | +| `--model` | `-m` | Model do użycia w formacie dostawca/model | +| `--agent` | | Agent do użycia | +| `--file` | `-f` | Pliki do załączenia do wiadomości | +| `--format` | | Format wyjściowy: `default` (sformatowany) lub `json` (surowy JSON) | +| `--title` | | Tytuł sesji (jeśli nie podano, zostanie wygenerowany z promptu) | +| `--attach` | | Dołącz do działającego serwera OpenCode (np. http://localhost:4096) | +| `--port` | | Port dla serwera lokalnego (domyślnie losowy) | --- ### serve -Uruchom bezgłowy serwer opencode w celu uzyskania dostępu do API. Pełny interfejs HTTP w [dokumentacji serwera](/docs/server). +Uruchom serwer OpenCode (bez interfejsu) w celu uzyskania dostępu do API. Pełny opis API HTTP znajduje się w [dokumentacji serwera](/docs/server). ```bash opencode serve ``` -Spowoduje dostęp do serwera HTTP, który zapewnia dostęp do API opencode bez interfejsu TUI. Ustaw `OPENCODE_SERVER_PASSWORD`, aby włączyć podstawowe uwierzytelnianie HTTP (domyślna nazwa użytkownika do `opencode`). +Uruchamia to serwer HTTP, który zapewnia dostęp do API OpenCode bez interfejsu TUI. Ustaw `OPENCODE_SERVER_PASSWORD`, aby włączyć podstawowe uwierzytelnianie HTTP (domyślna nazwa użytkownika to `opencode`). #### Flagi -| Flaga | Opis | -| ------------ | ---------------------------------------- | -| `--port` | Port do słuchania | -| `--hostname` | Nazwa hosta, która jest częścią składową | -| `--mdns` | Włącz wykrywanie mDNS | -| `--cors` | Dodatkowe źródło użytkownika CORS | +| Flaga | Opis | +| ------------ | ------------------------------------------ | +| `--port` | Port do nasłuchiwania | +| `--hostname` | Nazwa hosta, do której należy się powiązać | +| `--mdns` | Włącz wykrywanie mDNS | +| `--cors` | Dodatkowe dozwolone źródła CORS | --- ### session -Zarządzaj sesją opencode. +Zarządzaj sesjami OpenCode. ```bash opencode session [command] @@ -385,7 +385,7 @@ opencode session [command] #### list -Lista wszystkich sesji opencode. +Lista wszystkich sesji OpenCode. ```bash opencode session list @@ -393,16 +393,16 @@ opencode session list ##### Flagi -| Flaga | Krótkie | Opis | -| ------------- | ------- | ------------------------------------------ | -| `--max-count` | `-n` | Ograniczony do ostatniego sesji | -| `--format` | | Format wyjściowy: tabela lub json (tabela) | +| Flaga | Skrót | Opis | +| ------------- | ----- | ------------------------------------------ | +| `--max-count` | `-n` | Ogranicz do ostatnich N sesji | +| `--format` | | Format wyjściowy: tabela lub json (tabela) | --- ### stats -Pokaż statystyki wykorzystania tokenów i sesji szkoleniowych opencode. +Pokaż statystyki wykorzystania tokenów i sesji OpenCode. ```bash opencode stats @@ -412,10 +412,10 @@ opencode stats | Flaga | Opis | | ----------- | ------------------------------------------------------------------------------------- | -| `--days` | Pokaż statystyki z ostatnich N dni (cały czas) | -| `--tools` | Liczba narzędzi do po specyfikacji (wszystkie) | -| `--models` | Pokaż podział modelu wykorzystania (domyślnie ukryty). Podajnik usługowy, aby górne N | -| `--project` | Filtruj według projektu (wszystkie projekty, pusty ciąg: dostęp projekt) | +| `--days` | Pokaż statystyki z ostatnich N dni (domyślnie: cały czas) | +| `--tools` | Pokaż użycie poszczególnych narzędzi (domyślnie: wszystkie) | +| `--models` | Pokaż podział na modele (domyślnie ukryty). Podaj liczbę, aby pokazać N najczęstszych | +| `--project` | Filtruj według projektu (domyślnie: wszystkie projekty, pusty ciąg: bieżący projekt) | --- @@ -427,19 +427,19 @@ Eksportuj dane sesji jako JSON. opencode export [sessionID] ``` -Jeśli nie poddasz identyfikatora sesji, zostaniesz poproszony o wybranie jednego z sesji. +Jeśli nie podasz identyfikatora sesji, zostaniesz poproszony o wybranie jednej z ostatnich sesji. --- ### import -Importuj dane sesji z pliku JSON lub adresu URL udostępniania opencode. +Importuj dane sesji z pliku JSON lub adresu URL udostępniania OpenCode. ```bash opencode import ``` -Możesz importować z lokalnego lub adresu URL opencode. +Możesz importować z pliku lokalnego lub adresu URL. ```bash opencode import session.json @@ -450,48 +450,48 @@ opencode import https://opncd.ai/s/abc123 ### web -Uruchomiony bezgłowy serwer opencode z interfejsem internetowym. +Uruchom serwer OpenCode z interfejsem internetowym. ```bash opencode web ``` -Spowoduje dostęp do serwera HTTP i otwarcie dostępu do opencode przez interfejs sieciowy. Ustaw `OPENCODE_SERVER_PASSWORD`, aby włączyć podstawowe uwierzytelnianie HTTP (domyślna nazwa użytkownika do `opencode`). +Uruchamia to serwer HTTP i udostępnia OpenCode przez interfejs przeglądarkowy. Ustaw `OPENCODE_SERVER_PASSWORD`, aby włączyć podstawowe uwierzytelnianie HTTP (domyślna nazwa użytkownika to `opencode`). #### Flagi -| Flaga | Opis | -| ------------ | ---------------------------------------- | -| `--port` | Port do słuchania | -| `--hostname` | Nazwa hosta, która jest częścią składową | -| `--mdns` | Włącz wykrywanie mDNS | -| `--cors` | Dodatkowe źródło użytkownika CORS | +| Flaga | Opis | +| ------------ | ------------------------------------------ | +| `--port` | Port do nasłuchiwania | +| `--hostname` | Nazwa hosta, do której należy się powiązać | +| `--mdns` | Włącz wykrywanie mDNS | +| `--cors` | Dodatkowe dozwolone źródła CORS | --- ### acp -Uruchomiony serwer ACP (Agent Client Protocol). +Uruchom serwer ACP (Agent Client Protocol). ```bash opencode acp ``` -Aby udostępnić serwer ACP, który komunikuje się poprzez stdin/stdout przy użyciu nd-JSON. +Uruchamia serwer ACP, który komunikuje się przez stdin/stdout przy użyciu JSON-RPC. #### Flagi -| Flaga | Opis | -| ------------ | ---------------------------------------- | -| `--cwd` | Katalog roboczy | -| `--port` | Port do słuchania | -| `--hostname` | Nazwa hosta, która jest częścią składową | +| Flaga | Opis | +| ------------ | ------------------------------------------ | +| `--cwd` | Katalog roboczy | +| `--port` | Port do nasłuchiwania | +| `--hostname` | Nazwa hosta, do której należy się powiązać | --- ### uninstall -Odinstaluj opencode i usuń wszystkie pliki powiązane. +Odinstaluj OpenCode i usuń wszystkie powiązane pliki. ```bash opencode uninstall @@ -499,30 +499,30 @@ opencode uninstall #### Flagi -| Flaga | Krótkie | Opis | -| --------------- | ------- | --------------------------------- | -| `--keep-config` | `-c` | Zachowaj pliki konfiguracyjne | -| `--keep-data` | `-d` | Przechowuj dane sesji i snapshots | -| `--dry-run` | | Pokaż, wykluczy bez usuwania | -| `--force` | `-f` | Pomiń monity o potwierdzenie | +| Flaga | Skrót | Opis | +| --------------- | ----- | ----------------------------- | +| `--keep-config` | `-c` | Zachowaj pliki konfiguracyjne | +| `--keep-data` | `-d` | Zachowaj dane sesji i migawki | +| `--dry-run` | | Pokaż co zostanie usunięte | +| `--force` | `-f` | Pomiń monity o potwierdzenie | --- ### upgrade -Aktualizuje opencode do oryginalnej wersji lub oryginalnej wersji. +Aktualizuj OpenCode do najnowszej lub określonej wersji. ```bash opencode upgrade [target] ``` -Aby zachować ostatnią wersję. +Aby zaktualizować do najnowszej wersji: ```bash opencode upgrade ``` -Aby zobaczyć wersję pierwotną. +Aby zaktualizować do konkretnej wersji: ```bash opencode upgrade v0.1.48 @@ -530,74 +530,74 @@ opencode upgrade v0.1.48 #### Flagi -| Flaga | Krótkie | Opis | -| ---------- | ------- | --------------------------------------------------------- | -| `--method` | `-m` | Zastosowana metoda instalacji; curl, npm, pnpm, bun, brew | +| Flaga | Skrót | Opis | +| ---------- | ----- | --------------------------------------------------- | +| `--method` | `-m` | Wymuś metodę instalacji: curl, npm, pnpm, bun, brew | --- ## Flagi globalne -Interfejs CLI kod opencode przyjmuje flagi globalne. +Interfejs CLI OpenCode przyjmuje następujące flagi globalne dla każdego polecenia. -| Flaga | Krótkie | Opis | -| -------------- | ------- | ------------------------------------------- | -| `--help` | `-h` | Wyświetl pomoc | -| `--version` | `-v` | Drukuj numer wersji | -| `--print-logs` | | Wydrukuj logi na stderr | -| `--log-level` | | Poziom dziennika (DEBUG, INFO, WARN, ERROR) | +| Flaga | Skrót | Opis | +| -------------- | ----- | ------------------------------------------- | +| `--help` | `-h` | Wyświetl pomoc | +| `--version` | `-v` | Wydrukuj numer wersji | +| `--print-logs` | | Drukuj logi na stderr | +| `--log-level` | | Poziom logowania (DEBUG, INFO, WARN, ERROR) | --- ## Zmienne środowiskowe -opencode można skonfigurować za pomocą zmiennych środowiskowych. +OpenCode można skonfigurować za pomocą zmiennych środowiskowych. -| Zmienna | Wpisz | Opis | -| ------------------------------------- | ------- | ----------------------------------------------------------------------- | -| `OPENCODE_AUTO_SHARE` | boolean | Automatycznie udostępniaj sesje | -| `OPENCODE_GIT_BASH_PATH` | string | Ścieżka do pliku wykonywalnego Git Bash w systemie Windows | -| `OPENCODE_CONFIG` | string | Ścieżka do pliku konfiguracyjnego | -| `OPENCODE_CONFIG_DIR` | string | Ścieżka do katalogu konfiguracyjnego | -| `OPENCODE_CONFIG_CONTENT` | string | Wbudowana treść konstrukcji JSON | -| `OPENCODE_DISABLE_AUTOUPDATE` | boolean | Wyłącz automatyczne sprawdzanie aktualizacji | -| `OPENCODE_DISABLE_PRUNE` | boolean | Wyłączenie regulowane | -| `OPENCODE_DISABLE_TERMINAL_TITLE` | boolean | Wyłącz automatycznie tytuł terminala | -| `OPENCODE_PERMISSION` | string | Wbudowane prawo JSON | -| `OPENCODE_DISABLE_DEFAULT_PLUGINS` | boolean | Wyłączenie wtyczki | -| `OPENCODE_DISABLE_LSP_DOWNLOAD` | boolean | Wyłącz automatyczne pobieranie z serwera LSP | -| `OPENCODE_ENABLE_EXPERIMENTAL_MODELS` | boolean | Włącz modele eksperymentalne | -| `OPENCODE_DISABLE_AUTOCOMPACT` | boolean | Wyłącz automatyczne zagęszczanie kontekstu | -| `OPENCODE_DISABLE_CLAUDE_CODE` | boolean | Wyłączenie gry z `.claude` (podpowiedź + podłączenie) | -| `OPENCODE_DISABLE_CLAUDE_CODE_PROMPT` | boolean | Wyłącz czytanie `~/.claude/CLAUDE.md` | -| `OPENCODE_DISABLE_CLAUDE_CODE_SKILLS` | boolean | Wyłącz ładowanie `.claude/skills` | -| `OPENCODE_DISABLE_MODELS_FETCH` | boolean | Wyłączenie modeli pobierania ze źródeł niedostępnych | -| `OPENCODE_FAKE_VCS` | string | Fałszywy sprzedawca VCS do celów testowych | -| `OPENCODE_DISABLE_FILETIME_CHECK` | boolean | Wyłączone sprawdzanie pliku w celu optymalizacji | -| `OPENCODE_CLIENT` | string | Identyfikator klienta (domyślnie `cli`) | -| `OPENCODE_ENABLE_EXA` | boolean | Włącz narzędzie wyszukiwania internetowego Exa | -| `OPENCODE_SERVER_PASSWORD` | string | Włącz uwierzytelnianie podstawowe dla `serve`/`web` | -| `OPENCODE_SERVER_USERNAME` | string | Zakończenie stosowania użytkownika z autoryzacją (domyślnie `opencode`) | -| `OPENCODE_MODELS_URL` | string | Niestandardowy adres URL do pobrania konfiguracji modeli | +| Zmienna | Typ | Opis | +| ------------------------------------- | ------- | ----------------------------------------------------------- | +| `OPENCODE_AUTO_SHARE` | boolean | Automatycznie udostępniaj sesje | +| `OPENCODE_GIT_BASH_PATH` | string | Ścieżka do pliku wykonywalnego Git Bash w systemie Windows | +| `OPENCODE_CONFIG` | string | Ścieżka do pliku konfiguracyjnego | +| `OPENCODE_CONFIG_DIR` | string | Ścieżka do katalogu konfiguracyjnego | +| `OPENCODE_CONFIG_CONTENT` | string | Treść konfiguracji JSON (inline) | +| `OPENCODE_DISABLE_AUTOUPDATE` | boolean | Wyłącz automatyczne sprawdzanie aktualizacji | +| `OPENCODE_DISABLE_PRUNE` | boolean | Wyłącz czyszczenie starych wyników (pruning) | +| `OPENCODE_DISABLE_TERMINAL_TITLE` | boolean | Wyłącz automatyczne ustawianie tytułu terminala | +| `OPENCODE_PERMISSION` | string | Konfiguracja uprawnień w JSON (inline) | +| `OPENCODE_DISABLE_DEFAULT_PLUGINS` | boolean | Wyłącz domyślne wtyczki | +| `OPENCODE_DISABLE_LSP_DOWNLOAD` | boolean | Wyłącz automatyczne pobieranie serwerów LSP | +| `OPENCODE_ENABLE_EXPERIMENTAL_MODELS` | boolean | Włącz modele eksperymentalne | +| `OPENCODE_DISABLE_AUTOCOMPACT` | boolean | Wyłącz automatyczne kompaktowanie kontekstu | +| `OPENCODE_DISABLE_CLAUDE_CODE` | boolean | Wyłącz integrację z `.claude` (prompt + skills) | +| `OPENCODE_DISABLE_CLAUDE_CODE_PROMPT` | boolean | Wyłącz czytanie `~/.claude/CLAUDE.md` | +| `OPENCODE_DISABLE_CLAUDE_CODE_SKILLS` | boolean | Wyłącz ładowanie `.claude/skills` | +| `OPENCODE_DISABLE_MODELS_FETCH` | boolean | Wyłącz pobieranie modeli ze źródeł zewnętrznych | +| `OPENCODE_FAKE_VCS` | string | Fałszywy dostawca VCS do celów testowych | +| `OPENCODE_DISABLE_FILETIME_CHECK` | boolean | Wyłącz sprawdzanie czasu modyfikacji plików (optymalizacja) | +| `OPENCODE_CLIENT` | string | Identyfikator klienta (domyślnie `cli`) | +| `OPENCODE_ENABLE_EXA` | boolean | Włącz narzędzie wyszukiwania internetowego Exa | +| `OPENCODE_SERVER_PASSWORD` | string | Włącz uwierzytelnianie podstawowe dla `serve`/`web` | +| `OPENCODE_SERVER_USERNAME` | string | Nazwa użytkownika do autoryzacji (domyślnie `opencode`) | +| `OPENCODE_MODELS_URL` | string | Niestandardowy adres URL do pobierania konfiguracji modeli | --- ### Eksperymentalne -Te zmienne możliwości użycia funkcji eksperymentalnych, które mogą zostać lub usunięte. +Te zmienne włączają funkcje eksperymentalne, które mogą ulec zmianie lub zostać usunięte. -| Zmienna | Wpisz | Opis | -| ----------------------------------------------- | ------- | ---------------------------------------------- | -| `OPENCODE_EXPERIMENTAL` | boolean | Włącz wszystkie funkcje eksperymentalne | -| `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | boolean | Włącz wykrywanie ikon | -| `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | boolean | Wyłączenie kopiowania przy wyborze w TUI | -| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | numer | Domyślny limit czasu dla ukrytego bash w ms | -| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | numer | Maksymalne tokeny wyjściowe dla odpowiedzi LLM | -| `OPENCODE_EXPERIMENTAL_FILEWATCHER` | boolean | Włącz obserwatora plików dla całego katalogu | -| `OPENCODE_EXPERIMENTAL_OXFMT` | boolean | Włącz formater oxfmt | -| `OPENCODE_EXPERIMENTAL_LSP_TOOL` | boolean | Włącz eksperymentalne narzędzie LSP | -| `OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER` | boolean | Wyłącz obserwatora plików | -| `OPENCODE_EXPERIMENTAL_EXA` | boolean | Włącz funkcje eksperymentalne Exa | -| `OPENCODE_EXPERIMENTAL_LSP_TY` | boolean | Włącz eksperymentalne sprawdzanie typu LSP | -| `OPENCODE_EXPERIMENTAL_MARKDOWN` | boolean | Włącz funkcje eksperymentalne Markdown | -| `OPENCODE_EXPERIMENTAL_PLAN_MODE` | boolean | Włącz tryb planu | +| Zmienna | Typ | Opis | +| ----------------------------------------------- | ------- | -------------------------------------------- | +| `OPENCODE_EXPERIMENTAL` | boolean | Włącz wszystkie funkcje eksperymentalne | +| `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | boolean | Włącz wykrywanie ikon | +| `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | boolean | Wyłącz kopiowanie przy zaznaczaniu w TUI | +| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | number | Domyślny limit czasu dla narzędzia bash w ms | +| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | number | Maksymalne tokeny wyjściowe dla LLM | +| `OPENCODE_EXPERIMENTAL_FILEWATCHER` | boolean | Włącz obserwatora plików dla całego katalogu | +| `OPENCODE_EXPERIMENTAL_OXFMT` | boolean | Włącz formater oxfmt | +| `OPENCODE_EXPERIMENTAL_LSP_TOOL` | boolean | Włącz eksperymentalne narzędzie LSP | +| `OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER` | boolean | Wyłącz obserwatora plików | +| `OPENCODE_EXPERIMENTAL_EXA` | boolean | Włącz funkcje eksperymentalne Exa | +| `OPENCODE_EXPERIMENTAL_LSP_TY` | boolean | Włącz eksperymentalne sprawdzanie typów LSP | +| `OPENCODE_EXPERIMENTAL_MARKDOWN` | boolean | Włącz funkcje eksperymentalne Markdown | +| `OPENCODE_EXPERIMENTAL_PLAN_MODE` | boolean | Włącz tryb planowania | diff --git a/packages/web/src/content/docs/pl/commands.mdx b/packages/web/src/content/docs/pl/commands.mdx index 757959098..4c5dad7d6 100644 --- a/packages/web/src/content/docs/pl/commands.mdx +++ b/packages/web/src/content/docs/pl/commands.mdx @@ -1,21 +1,21 @@ --- title: Polecenia -description: Tworz polecany dla powtarzalnych zadań. +description: Twórz polecenia dla powtarzalnych zadań. --- -Polecenia ustawienia monitu, które może zostać uruchomione po uruchomieniu tego polecenia w TUI. +Polecenia to zdefiniowane prompty, które można uruchomić w TUI. ```bash frame="none" /my-command ``` -Polecenia stanowią dodatek do dostarczonych, takich jak `/init`, `/undo`, `/redo`, `/share`, `/help`. [Dowiedz się więcej](/docs/tui#commands). +Polecenia są dodatkiem do wbudowanych, takich jak `/init`, `/undo`, `/redo`, `/share`, `/help`. [Dowiedz się więcej](/docs/tui#commands). --- -## Utwórz źródło plikówwe +## Utwórz pliki źródłowe -Utwórz pliki Markdown w katalogu `commands/`, aby móc korzystać z usług polecanych. +Utwórz pliki Markdown w katalogu `commands/`, aby zdefiniować polecenia. Utwórz `.opencode/commands/test.md`: @@ -30,9 +30,9 @@ Run the full test suite with coverage report and show any failures. Focus on the failing tests and suggest fixes. ``` -Frontmatter posiada właściwości. Treść staje się szablonem. +Frontmatter definiuje właściwości. Treść staje się szablonem. -polecany, w rejestrze `/`, a następnie polecany. +Uruchom polecenie, wpisując `/`, a następnie nazwę polecenia. ```bash frame="none" "/test" @@ -40,15 +40,15 @@ polecany, w rejestrze `/`, a następnie polecany. --- -## Skonfiguruj +## Konfiguracja -Dostęp do sieci przez połączenie opencode lub udostępnia pliki w katalogu `commands/`. +Możesz zdefiniować polecenia w `opencode.json` lub w plikach w katalogu `commands/`. --- ### JSON -opcja opcja `command` w swoim opencode [config](/docs/config): +Użyj opcji `command` w swojej konfiguracji opencode: ```json title="opencode.jsonc" {4-12} { @@ -93,8 +93,8 @@ Run the full test suite with coverage report and show any failures. Focus on the failing tests and suggest fixes. ``` -Nazwa pliku Markdown staje się nazwą referencyjną. Na przykład `test.md` pozwala -biegniesz: +Nazwa pliku Markdown staje się nazwą polecenia. Na przykład `test.md` pozwala +uruchomić: ```bash frame="none" /test @@ -102,15 +102,15 @@ biegniesz: --- -## Szybko kliknij +## Składnia promptu -Monity dotyczące niestandardowych urządzeń obsługujących kilka specjalnych symboli zastępczych i składni. +Prompty niestandardowych poleceń obsługują kilka specjalnych symboli zastępczych. --- -### Argumentacja +### Argumenty -Przekazuj argumentację do ręki, używając symbolu zastępczego `$ARGUMENTS`. +Przekazuj argumenty do promptu, używając symbolu zastępczego `$ARGUMENTS`. ```md title=".opencode/commands/component.md" --- @@ -121,20 +121,20 @@ Create a new React component named $ARGUMENTS with TypeScript support. Include proper typing and basic structure. ``` -Uruchomienie reakcji z argumentami: +Uruchomienie polecenia z argumentami: ```bash frame="none" /component Button ``` -A `$ARGUMENTS` pozostanie pozostawione przez `Button`. +`$ARGUMENTS` zostanie zastąpione przez `Button`. -Dostępność do poszczególnych argumentów można również uzyskać za pomocą parametrów funkcjonalnych: +Dostęp do poszczególnych argumentów można uzyskać za pomocą parametrów pozycyjnych: - `$1` - Pierwszy argument - `$2` - Drugi argument - `$3` - Trzeci argument -- Biorę dalej... +- I tak dalej... Na przykład: @@ -147,25 +147,25 @@ Create a file named $1 in the directory $2 with the following content: $3 ``` -Uruchomienie decyzji: +Uruchomienie polecenia: ```bash frame="none" /create-file config.json src "{ \"key\": \"value\" }" ``` -Aby przechowywać: +Wartości: -- `$1` z `config.json` -- `$2` z `src` -- `$3` z `{ "key": "value" }` +- `$1` to `config.json` +- `$2` to `src` +- `$3` to `{ "key": "value" }` --- -### Wyjście z pamięci +### Dane wyjściowe poleceń -urządzenie \__!`command`_, aby wstawić dane wyjściowe [polecenie bash](/docs/tui#bash-commands) wykonaj obciążenie. +Użyj `!command`, aby wstawić dane wyjściowe [polecenia bash](/docs/tui#bash-commands) do promptu. -Na przykład, aby sprawdzić narzędzie analityczne: +Na przykład, aby przeanalizować pokrycie testami: ```md title=".opencode/commands/analyze-coverage.md" --- @@ -178,7 +178,7 @@ Here are the current test results: Based on these results, suggest improvements to increase coverage. ``` -Lub aby ostatnia zmiana: +Lub aby przejrzeć ostatnie zmiany: ```md title=".opencode/commands/review-changes.md" --- @@ -191,13 +191,13 @@ Recent git commits: Review these changes and suggest any improvements. ``` -Polecenia są uruchamiane w systemie wyjściowym, a ich dane wyjściowe są uruchamiane. +Polecenia są uruchamiane w powłoce, a ich dane wyjściowe są wstawiane do promptu. --- -### Referencje plików +### Odwołania do plików -Dołącz pliki do swojego polecenia, używając `@`, zawierającego plik. +Dołącz pliki do swojego polecenia, używając `@` i ścieżki do pliku. ```md title=".opencode/commands/review-component.md" --- @@ -208,7 +208,7 @@ Review the component in @src/components/Button.tsx. Check for performance issues and suggest improvements. ``` -Zawartość pliku jest automatycznie umieszczana w pliku. +Zawartość pliku jest automatycznie wstawiana do promptu. --- @@ -218,9 +218,9 @@ Przyjrzyjmy się szczegółowo opcjom konfiguracji. --- -### Szablon +### Template -Opcja `template` została rozstrzygnięta, która została wysłana do LLM po wykonaniu polecenia. +Opcja `template` to prompt wysyłany do LLM po wykonaniu polecenia. ```json title="opencode.json" { @@ -236,9 +236,9 @@ Jest to **wymagana** opcja konfiguracji. --- -### Opis +### Description -Możliwość użycia `description`, aby skrócony opis działania polecenia. +Użyj `description`, aby dodać krótki opis działania polecenia. ```json title="opencode.json" { @@ -250,15 +250,15 @@ Możliwość użycia `description`, aby skrócony opis działania polecenia. } ``` -Jest podany jako opis w TUI po wpisaniu polecenia. +Jest wyświetlany jako opis w TUI po wpisaniu polecenia. --- ### Agent -Zastosowanie zastosowania `agent`, aby określić, który [agent] (./agents) powinien zostać naprawiony do wyboru. -Jeśli jest to [podagent](/docs/agents/#subagents), rozwiązanie to ujawnione, podagenta. -Aby móc, ustawa `subtask` na `false`. +Użyj opcji `agent`, aby określić, który [agent](/docs/agents) powinien wykonać to polecenie. +Jeśli jest to [subagent](/docs/agents/#subagents), zostanie on użyty. +Aby to zmienić, ustaw `subtask` na `false`. ```json title="opencode.json" { @@ -270,15 +270,15 @@ Aby móc, ustawa `subtask` na `false`. } ``` -Jest to **opcjonalna** opcja konfiguracji. Jeśli nie jest dostępny, dostępny jest agentem. +Jest to **opcjonalna** opcja konfiguracji. Jeśli nie podano, użyty zostanie domyślny agent. --- -### Podzadanie +### Subtask -Użyj wartości logicznej `subtask`, aby wymusić wywołanie [podagenta](/docs/agents/#subagents) polecenia. -Jest to narzędzie, jeśli chcesz, aby decyzja nie zanieczyszczała kontekstu i **zmusiło** agenta do działania jako subagent, -nawet jeśli `mode` jest podłączony na `primary` w konfiguracji [agent](/docs/agents). +Użyj `subtask`, aby wymusić wywołanie polecenia jako subzadania. +Jest to przydatne, jeśli chcesz, aby polecenie nie zanieczyszczało kontekstu i **zmusiło** agenta do działania jako subagent, +nawet jeśli `mode` jest ustawiony na `primary` w konfiguracji [agent](/docs/agents). ```json title="opencode.json" { @@ -296,7 +296,7 @@ Jest to **opcjonalna** opcja konfiguracji. ### Model -Używając konstrukcji `model`, aby znaleźć ukryty model dla tego polecenia. +Użyj `model`, aby określić model dla tego polecenia. ```json title="opencode.json" { @@ -312,12 +312,12 @@ Jest to **opcjonalna** opcja konfiguracji. --- -## Wbudowany +## Wbudowane -opencode zawiera kilka istniejących urządzeń, takich jak `/init`, `/undo`, `/redo`, `/share`, `/help`; [dowiedz się więcej](/docs/tui#commands). +opencode zawiera kilka wbudowanych poleceń, takich jak `/init`, `/undo`, `/redo`, `/share`, `/help`; [dowiedz się więcej](/docs/tui#commands). :::note -Polecenia mogą zostać usunięte. +Polecenia wbudowane mogą zostać nadpisane. ::: -Jeśli zdefiniujesz tę samą nazwę, nastąpi decyzja. +Jeśli zdefiniujesz tę samą nazwę, twoje polecenie będzie miało pierwszeństwo. diff --git a/packages/web/src/content/docs/pl/config.mdx b/packages/web/src/content/docs/pl/config.mdx index 327afe368..cde2e312e 100644 --- a/packages/web/src/content/docs/pl/config.mdx +++ b/packages/web/src/content/docs/pl/config.mdx @@ -1,15 +1,15 @@ --- title: Konfiguracja -description: Ustawienia opencode w pliku JSON. +description: Ustawienia OpenCode w pliku JSON. --- -Możesz zagrać z opencode za pomocą pliku konfiguracyjnego JSON. +Możesz dostosować OpenCode za pomocą pliku konfiguracyjnego JSON. --- ## Format -opencode obsługa formaty **JSON** i **JSONC** (JSON z komentarzami). +OpenCode obsługuje formaty **JSON** i **JSONC** (JSON z komentarzami). ```jsonc title="opencode.jsonc" { @@ -25,45 +25,44 @@ opencode obsługa formaty **JSON** i **JSONC** (JSON z komentarzami). ## Lokalizacje -Możesz umieścić swoją instalację w kilku różnych lokalizacjach i jednym pliku -inne porządki pierwszeństwa. +Możesz umieścić swoją konfigurację w kilku różnych lokalizacjach, które mają ustaloną kolejność pierwszeństwa. :::note -Pliki konfiguracyjne są **łączone**, a nie zastępowane. +Pliki konfiguracyjne są **łączone**, a nie nadpisywane. ::: -Pliki konfiguracyjne są łączone ze sobą, a nie zastępowane. Ustawienia z lokalizacji konfiguracyjnych są konfigurowalne. Ewentualne konfiguracje zaistnieją tylko w przypadku sprzecznych kluczy. Niekonfliktowe ustawienia ze wszystkich zasobów zachowanych. +Pliki konfiguracyjne są łączone ze sobą. Ustawienia z lokalizacji o wyższym priorytecie nadpisują ustawienia z lokalizacji o niższym priorytecie tylko w przypadku konfliktów kluczy. Ustawienia niekolidujące ze wszystkich źródeł są zachowywane. -Na zestawie, przygotowana globalna ustawi `theme: "opencode"` i `autoupdate: true`, zestaw zestawu `model: "anthropic/claude-sonnet-4-5"`, ostateczna zestaw będzie zawierał wszystkie trzy ustawienia. +Na przykład, jeśli konfiguracja globalna ustawi `theme: "opencode"` i `autoupdate: true`, a konfiguracja projektu ustawi `model: "anthropic/claude-sonnet-4-5"`, ostateczna konfiguracja będzie zawierać wszystkie trzy ustawienia. --- ### Kolejność pierwszeństwa -Źródła konfiguracji są ładowane w kolejności (później źródła występują wcześniej): +Źródła konfiguracji są ładowane w następującej kolejności (źródła występujące później mają pierwszeństwo): -1. **Zdalna konfiguracja** (od `.well-known/opencode`) – ustawienia stosowane w organizacji -2. **Konfiguracja globalna** (`~/.config/opencode/opencode.json`) – przestrzeganie użytkownika -3. **Konfiguracja niestandardowa** (`OPENCODE_CONFIG` env var) — zastosowanie zastąpienie -4. **Konfiguracja projektu** (`opencode.json` w projekcie) - ustawienia dla projektu specjalnego -5. **`.opencode` katalogi** - agent, poleca, półki -6. **Konfiguracja wbudowana** (`OPENCODE_CONFIG_CONTENT` env var) — zastąpienie środowiska wykonawczego +1. **Konfiguracja zdalna** (z `.well-known/opencode`) – ustawienia wymuszane przez organizację +2. **Konfiguracja globalna** (`~/.config/opencode/opencode.json`) – preferencje użytkownika +3. **Konfiguracja niestandardowa** (zmienna `OPENCODE_CONFIG`) — jawne nadpisanie +4. **Konfiguracja projektu** (`opencode.json` w projekcie) - ustawienia specyficzne dla projektu +5. **Katalogi `.opencode`** - agenci, polecenia, umiejętności +6. **Konfiguracja wbudowana** (zmienna `OPENCODE_CONFIG_CONTENT`) — nadpisanie środowiska uruchomieniowego -to, że konfiguracje projektu mogą być dostępne na poziomie globalnym konfiguracji, a konfiguracje globalne mogą być zdalne, zdalne konfiguracja organizacji. +Oznacza to, że konfiguracje projektu mogą nadpisywać konfiguracje globalne, a konfiguracje globalne mogą nadpisywać konfiguracje zdalne. :::note -W katalogach `.opencode` i `~/.config/opencode` użytkownicy są **nazwy w zwykłej mnogiej** dla podkatalogów: `agents/`, `commands/`, `modes/`, `plugins/`, `skills/`, `tools/` i `themes/`. Nazwy wydane (np. `agent/`) są również objęte gwarancją kompatybilności wstecznej. +W katalogach `.opencode` i `~/.config/opencode` używane są **nazwy w liczbie mnogiej** dla podkatalogów: `agents/`, `commands/`, `modes/`, `plugins/`, `skills/`, `tools/` i `themes/`. Nazwy w liczbie pojedynczej (np. `agent/`) są również obsługiwane dla kompatybilności wstecznej. ::: --- -### Zdalny +### Zdalna -Organizacje mogą być podłączone do łączy końcowych `.well-known/opencode`. Jest pobierane automatycznie po uwierzytelnieniu u dostawcy, który obsługuje. +Organizacje mogą publikować konfigurację pod adresem `.well-known/opencode`. Jest ona pobierana automatycznie po uwierzytelnieniu u dostawcy, który ją obsługuje. -Zdalna jest ładowana jako pierwsza i podstawowa. Wszystkie inne źródła konfiguracji (globalne, projektowe) mogą zostać udostępnione menu. +Konfiguracja zdalna jest ładowana jako pierwsza i stanowi bazę. Wszystkie inne źródła konfiguracji (globalne, projektowe) mogą ją nadpisywać. -Na przykład, jeśli Twoja organizacja udostępnia serwery MCP, które są siecią internetową: +Na przykład, jeśli Twoja organizacja udostępnia serwery MCP, które są domyślnie wyłączone: ```json title="Remote config from .well-known/opencode" { @@ -77,7 +76,7 @@ Na przykład, jeśli Twoja organizacja udostępnia serwery MCP, które są sieci } ``` -Możesz udostępnić serwery w szczegółach: +Możesz włączyć serwer w konfiguracji projektu: ```json title="opencode.json" { @@ -93,68 +92,65 @@ Możesz udostępnić serwery w szczegółach: --- -### Światowy +### Globalna -Umieść swoją globalną konfigurację opencode w `~/.config/opencode/opencode.json`. przestrzeganie funkcji globalnej, aby uzyskać dostęp do całego użytkownika, takie jak motywy, dostawca lub skróty klawiszowe. +Umieść swoją globalną konfigurację OpenCode w `~/.config/opencode/opencode.json`. Użyj jej do ustawień ogólnych dla użytkownika, takich jak motywy, domyślny dostawca lub skróty klawiszowe. -Konfiguracja globalna zaawansowana, zdalne ustawienie konfiguracji. +Konfiguracja globalna ma pierwszeństwo przed konfiguracją zdalną. --- ### Projekt -Dodaj `opencode.json` w katalogu głównym projektu. Konfiguracja projektu ma priorytet wśród plików konfiguracyjnych — zaawansowane konfiguracje globalne i zdalne. +Dodaj `opencode.json` w katalogu głównym projektu. Konfiguracja projektu ma najwyższy priorytet wśród plików konfiguracyjnych — nadpisuje konfiguracje globalne i zdalne. :::tip -Instalacja wstępna dla katalogu w katalogu. +Dodaj ten plik do kontroli wersji, aby udostępniać konfigurację zespołowi. ::: -Kiedy opencode się uruchomi, szuka pliku konfiguracyjnego w katalogu Git. +Kiedy OpenCode się uruchamia, szuka pliku konfiguracyjnego w katalogu głównym repozytorium Git. -Można również sprawdzić w Git i tego samego schematu, co globalny. +Może on być przechowywany w Git i mieć ten sam schemat, co konfiguracja globalna. --- ### Niestandardowa ścieżka -Niestandardowe rozwiązanie konfiguracyjne, różne opcje `OPENCODE_CONFIG`. +Możesz załadować niestandardowy plik konfiguracyjny, ustawiając zmienną środowiskową `OPENCODE_CONFIG`. ```bash export OPENCODE_CONFIG=/path/to/my/custom-config.json opencode run "Hello world" ``` -Konfiguracja niestandardowa jest ładowana z konfiguracją globalną i konfiguracją projektu w kolejności pierwszych. +Konfiguracja niestandardowa jest ładowana po konfiguracji globalnej i przed konfiguracją projektu w kolejności priorytetów. --- -### Katalog niestandardowy +### Niestandardowy katalog -niestandardowy katalog konfiguracyjny za pomocą `OPENCODE_CONFIG_DIR` -zmienna środowiskowa. Katalog ten będzie przeszukiwany pod kątem agentów, ukryty, -tryby i wtyczki, tak jak standardowy katalog `.opencode` i powinienem -podążaj tą samą strukturą. +Możesz ustawić niestandardowy katalog konfiguracyjny za pomocą zmiennej środowiskowej `OPENCODE_CONFIG_DIR`. Katalog ten będzie przeszukiwany pod kątem agentów, poleceń, trybów i wtyczek, tak jak standardowy katalog `.opencode` i powinien zachować tę samą strukturę. ```bash export OPENCODE_CONFIG_DIR=/path/to/my/config-directory opencode run "Hello world" ``` -Katalog niestandardowy jest ładowany po katalogach global config i `.opencode`, więc **może być połączony** z ich urządzeniami. +Katalog niestandardowy jest ładowany po globalnej konfiguracji i katalogach `.opencode`, więc **może być łączony** z ich zawartością. --- ## Schemat -Plik konfiguracyjny ma schemat końcowy w [**`opencode.ai/config.json`**](https://opencode.ai/config.json). +Plik konfiguracyjny ma schemat JSON dostępny pod adresem [**`opencode.ai/config.json`**](https://opencode.ai/config.json). -Twój edytor powinien mieć możliwość sprawdzania poprawności i autouzupełniania na podstawie schematu. +Twój edytor powinien zapewniać walidację i autouzupełnianie na podstawie tego schematu. --- ### TUI -Możliwość podłączenia urządzenia dla TUI za pomocą opcji `tui`. +Możesz skonfigurować zachowanie TUI za pomocą opcji `tui`. ```json title="opencode.json" { @@ -169,19 +165,19 @@ Możliwość podłączenia urządzenia dla TUI za pomocą opcji `tui`. } ``` -Dostępna opcja: +Dostępne opcje: -- `scroll_acceleration.enabled` - Włącz przyspieszenie przewijania w rysiku macOS. **Ma pierwszeństwo przed `scroll_speed`.** -- `scroll_speed` - Niestandardowy mnożnik szybkości przewijania (domyślnie: `3`, minimalnie: `1`). Ignorowane, jeśli `scroll_acceleration.enabled` do `true`. -- `diff_style` – Sterowanie renderowaniem różnicowym. `"auto"` dostępny jest do szerokości terminala, `"stacked"` zawsze pojawia się pojedyncza kolumna. +- `scroll_acceleration.enabled` - Włącz przyspieszenie przewijania na gładzikach macOS. **Ma pierwszeństwo przed `scroll_speed`.** +- `scroll_speed` - Niestandardowy mnożnik szybkości przewijania (domyślnie: `3`, minimalnie: `1`). Ignorowane, jeśli `scroll_acceleration.enabled` ustawiono na `true`. +- `diff_style` – Sterowanie renderowaniem różnic. `"auto"` przełącza się w zależności od szerokości terminala, `"stacked"` zawsze wymusza pojedynczą kolumnę. -[Dowiedz się więcej o korzystaniu z TUI tutaj](/docs/tui). +[Dowiedz się więcej o korzystaniu z TUI](/docs/tui). --- -### Serwer +### Server (Serwer) -Możliwość ustawienia serwera dla źródeł `opencode serve` i `opencode web` za pomocą opcji `server`. +Możesz skonfigurować serwer dla `opencode serve` i `opencode web` za pomocą opcji `server`. ```json title="opencode.json" { @@ -196,21 +192,21 @@ Możliwość ustawienia serwera dla źródeł `opencode serve` i `opencode web` } ``` -Dostępna opcja: +Dostępne opcje: - `port` - Port do nasłuchiwania. -- `hostname` — nazwa hosta, która jest przeznaczona dla Ciebie. Gdy `mdns` jest połączony i nie jest ułożony inną nazwą hosta, jest połączony z `0.0.0.0`. -- `mdns` - Włącz wykrywanie usług mDNS. Dzięki temu zewnętrznemu urządzeniu w sieci może być przesyłany Twój serwer opencode. -- `mdnsDomain` - Niestandardowa nazwa domeny dla usług mDNS. Wartość domyślna do `opencode.local`. Przydatne do uruchomienia wielu zastosowań w tej samej sieci. -- `cors` - Dodatkowe źródło CORS podczas korzystania z serwera HTTP z punktu końcowego. Wartość musi być dostępna dla źródeł (schemat + host + port opcjonalny), np. `https://app.example.com`. +- `hostname` — Nazwa hosta, z którą należy się powiązać. Gdy `mdns` jest włączone i nie ustawiono innej nazwy hosta, domyślnie jest to `0.0.0.0`. +- `mdns` - Włącz wykrywanie usług mDNS. Dzięki temu inne urządzenia w sieci mogą łatwo znaleźć Twój serwer OpenCode. +- `mdnsDomain` - Niestandardowa nazwa domeny dla usług mDNS. Domyślnie `opencode.local`. Przydatne do uruchamiania wielu instancji w tej samej sieci. +- `cors` - Dozwolone źródła CORS podczas korzystania z serwera HTTP z przeglądarki. Wartość musi być listą źródeł (schemat + host + opcjonalny port), np. `https://app.example.com`. -[Dowiedz się więcej o tutaj](/docs/server). +[Dowiedz się więcej o serwerze](/docs/server). --- -### Narzędzia +### Tools (Narzędzia) -Dostępne narzędzia, z których można korzystać LLM, dostęp do opcji `tools`. +Kontroluj, które narzędzia są dostępne dla LLM, za pomocą opcji `tools`. ```json title="opencode.json" { @@ -222,13 +218,13 @@ Dostępne narzędzia, z których można korzystać LLM, dostęp do opcji `tools` } ``` -[Dowiedz się więcej o narzędziach tutaj](/docs/tools). +[Dowiedz się więcej o narzędziach](/docs/tools). --- -### Modele +### Models (Modele) -Możesz mieć dostawców i modele, które chcesz mieć w konfiguracji opencode, za pomocą opcji `provider`, `model` i `small_model`. +Możesz skonfigurować dostawców i modele, których chcesz używać, za pomocą opcji `provider`, `model` i `small_model`. ```json title="opencode.json" { @@ -239,9 +235,9 @@ Możesz mieć dostawców i modele, które chcesz mieć w konfiguracji opencode, } ``` -Opcja `small_model` konfiguruje oddzielny model do lekkich zadań, takich jak generowanie tytułów. Domyślnie opencode wyparte przez dostępny model, jeśli jest dostępny u dostawcy, w razie potrzeby powróć do innego modelu. +Opcja `small_model` konfiguruje oddzielny model do lżejszych zadań, takich jak generowanie tytułów. Domyślnie OpenCode wybiera tańszy model od tego samego dostawcy, jeśli jest dostępny, w przeciwnym razie powraca do modelu głównego. -Opcje dostawcy mogą być zainstalowane `timeout` i `setCacheKey`: +Opcje dostawcy mogą zawierać `timeout` i `setCacheKey`: ```json title="opencode.json" { @@ -257,20 +253,20 @@ Opcje dostawcy mogą być zainstalowane `timeout` i `setCacheKey`: } ``` -- `timeout` - Limit czasu trwania w milisekundach (domyślnie: 300000). Ustaw na `false`, aby wyłączyć. -- `setCacheKey` — wkrótce, że klucz pamięci podręcznej jest zawsze gotowy dla dostawcy. +- `timeout` - Limit czasu żądania w milisekundach (domyślnie: 300000). Ustaw na `false`, aby wyłączyć. +- `setCacheKey` — Wymuś ustawienie klucza pamięci podręcznej dla dostawcy. -Możesz także mieć [model lokalny](/docs/models#local). [Dowiedz się więcej](/docs/models). +Możesz także skonfigurować [modele lokalne](/docs/models#local). [Dowiedz się więcej o modelach](/docs/models). --- #### Opcje specyficzne dla dostawców -inne udostępnienie dodatkowych możliwości wyposażenia poza urządzeniami `timeout` i `apiKey`. +Niektórzy dostawcy obsługują dodatkowe opcje konfiguracji poza `timeout` i `apiKey`. ##### Amazon Bedrock -Amazon Bedrock umożliwia podłączenie wyłącznika dla AWS: +Amazon Bedrock umożliwia konfigurację połączenia z AWS: ```json title="opencode.json" { @@ -287,21 +283,21 @@ Amazon Bedrock umożliwia podłączenie wyłącznika dla AWS: } ``` -- `region` — region AWS dla Bedrock (domyślnie jest do `AWS_REGION` env var lub `us-east-1`) -- `profile` - profil nazwany AWS z `~/.aws/credentials` (domyślnie `AWS_PROFILE` env var) -- `endpoint` — niestandardowy adres URL punktu końcowego dla punktów końcowych VPC. Jest to alias dla opcji ogólnej `baseURL` przy użyciu terminologii specjalnej dla AWS. Jeśli oba, pierwszeństwo ma `endpoint`. +- `region` — Region AWS dla Bedrock (domyślnie `AWS_REGION` env var lub `us-east-1`) +- `profile` - Nazwa profilu AWS z `~/.aws/credentials` (domyślnie `AWS_PROFILE` env var) +- `endpoint` — Niestandardowy adres URL punktu końcowego (np. dla punktów końcowych VPC). Jest to alias dla opcji ogólnej `baseURL` przy użyciu terminologii AWS. Jeśli podano oba, pierwszeństwo ma `endpoint`. :::note Token okaziciela (`AWS_BEARER_TOKEN_BEDROCK` lub `/connect`) ma pierwszeństwo przed uwierzytelnianiem opartym na profilu. Aby uzyskać szczegółowe informacje, zobacz [pierwszeństwo uwierzytelniania](/docs/providers#authentication-precedence). ::: -[Dowiedz się więcej o budowie Amazon Bedrock](/docs/providers#amazon-bedrock). +[Dowiedz się więcej o Amazon Bedrock](/docs/providers#amazon-bedrock). --- -### Motywy +### Theme (Motyw) -Urządzenie zachęcające do korzystania z urządzeń opencode, za pomocą sieci `theme`. +Skonfiguruj motyw interfejsu OpenCode za pomocą opcji `theme`. ```json title="opencode.json" { @@ -310,13 +306,13 @@ Urządzenie zachęcające do korzystania z urządzeń opencode, za pomocą sieci } ``` -[Dowiedz się więcej tutaj](/docs/themes). +[Dowiedz się więcej o motywach](/docs/themes). --- -### Agenci +### Agents (Agenci) -Możliwość dostępności agentów do gniazd za pomocą opcji `agent`. +Możesz zdefiniować i skonfigurować agentów za pomocą opcji `agent`. ```jsonc title="opencode.jsonc" { @@ -336,13 +332,13 @@ Możliwość dostępności agentów do gniazd za pomocą opcji `agent`. } ``` -Możesz także uniknąć agentów przy użyciu plików przecen w `~/.config/opencode/agents/` lub `.opencode/agents/`. [Dowiedz się więcej tutaj](/docs/agents). +Możesz także definiować agentów przy użyciu plików markdown w `~/.config/opencode/agents/` lub `.opencode/agents/`. [Dowiedz się więcej o agentach](/docs/agents). --- -### Domyślny agent +### Default Agent (Domyślny agent) -Domyślnego agenta można ustawić za pomocą opcji `default_agent`. Wykrywacz, który jest używany, jeśli nie został ujawniony. +Domyślnego agenta można ustawić za pomocą opcji `default_agent`. Określa to agenta, który jest używany, jeśli nie wybrano żadnego innego. ```json title="opencode.json" { @@ -351,15 +347,15 @@ Domyślnego agenta można ustawić za pomocą opcji `default_agent`. Wykrywacz, } ``` -Agent domyślny musi być agentem (nie subagentem). Może być agentem aplikacji, taki jak `"build"` lub `"plan"`, albo ukryty przez Ciebie [agent niestandardowy](/docs/agents). Jeśli agent nie istnieje lub jest podagentem, opencode powróć do `"build"` z ostrzeżeniem. +Agent domyślny musi być agentem typu `primary` (nie `subagent`). Może to być agent wbudowany, taki jak `"build"` lub `"plan"`, albo zdefiniowany przez Ciebie [agent niestandardowy](/docs/agents). Jeśli agent nie istnieje lub jest subagentem, OpenCode powróci do `"build"` z ostrzeżeniem. -Dotyczy urządzeń wszystkich interfejsów: TUI, CLI (`opencode run`), aplikacji komputerowej i akcji GitHub. +Dotyczy to wszystkich interfejsów: TUI, CLI (`opencode run`), aplikacji desktopowej i GitHub Actions. --- -### Udostępnianie +### Share (Udostępnianie) -Możesz udostępnić [udostępnij](/docs/share) za pomocą opcji `share`. +Możesz skonfigurować [udostępnianie](/docs/share) za pomocą opcji `share`. ```json title="opencode.json" { @@ -368,19 +364,19 @@ Możesz udostępnić [udostępnij](/docs/share) za pomocą opcji `share`. } ``` -Działaj: +Opcje: -- `"manual"` – Zezwalaj na ręczne korzystanie z pomocy narzędzi (domyślnie) +- `"manual"` – Zezwalaj na ręczne udostępnianie (domyślnie) - `"auto"` - Automatycznie udostępniaj nowe rozmowy -- `"disabled"` - Całkowicie udostępnienie +- `"disabled"` - Całkowicie wyłącz udostępnianie -Domyślnie jest rozwiązaniem na tryb manualny, w którym należy jawnie udostępniać rozmowy za pomocą polecenia `/share`. +Domyślnie ustawiony jest tryb ręczny, w którym należy jawnie udostępniać rozmowy za pomocą polecenia `/share`. --- -### Polecenia +### Commands (Polecenia) -Możesz korzystać z usług polecanych dla powtarzalnych zadań za pomocą opcji `command`. +Możesz zdefiniować niestandardowe polecenia dla powtarzalnych zadań za pomocą opcji `command`. ```jsonc title="opencode.jsonc" { @@ -400,13 +396,13 @@ Możesz korzystać z usług polecanych dla powtarzalnych zadań za pomocą opcji } ``` -Można także definiować polecenia przy użyciu plików Markdown w `~/.config/opencode/commands/` lub `.opencode/commands/`. [Dowiedz się więcej tutaj](/docs/commands). +Możesz także definiować polecenia przy użyciu plików Markdown w `~/.config/opencode/commands/` lub `.opencode/commands/`. [Dowiedz się więcej o poleceniach](/docs/commands). --- -### Keybinds +### Keybinds (Skróty klawiszowe) -Możliwość zmiany skrótu klawiszowego za pomocą opcji `keybinds`. +Możesz dostosować skróty klawiszowe za pomocą opcji `keybinds`. ```json title="opencode.json" { @@ -415,13 +411,13 @@ Możliwość zmiany skrótu klawiszowego za pomocą opcji `keybinds`. } ``` -[Dowiedz się więcej tutaj](/docs/keybinds). +[Dowiedz się więcej o skrótach klawiszowych](/docs/keybinds). --- -### Automatyczna aktualizacja +### Autoupdate (Automatyczna aktualizacja) -opencode automatycznie pobierze każde nowe uruchomienie. Można skorzystać z opcji `autoupdate`. +OpenCode może automatycznie pobierać nowe wersje. Możesz to kontrolować za pomocą opcji `autoupdate`. ```json title="opencode.json" { @@ -430,14 +426,14 @@ opencode automatycznie pobierze każde nowe uruchomienie. Można skorzystać z o } ``` -Jeśli nie chcesz aktualizacji, ale chcesz podłączyć nową wersję, ustaw `autoupdate` na `"notify"`. -Działa tylko wtedy, gdy nie jest uruchamiana przy użyciu menedżera pakietów, jak Homebrew. +Jeśli nie chcesz automatycznych aktualizacji, ale chcesz być powiadamiany o nowych wersjach, ustaw `autoupdate` na `"notify"`. +Działa to tylko wtedy, gdy OpenCode nie został zainstalowany przez menedżera pakietów, takiego jak Homebrew. --- -### Formattery +### Formatters (Formatery) -Można podać kod formacyjny za pomocą opcji `formatter`. +Możesz skonfigurować formatery kodu za pomocą opcji `formatter`. ```json title="opencode.json" { @@ -457,15 +453,15 @@ Można podać kod formacyjny za pomocą opcji `formatter`. } ``` -[Dowiedz się więcej o formaterach tutaj](/docs/formatters). +[Dowiedz się więcej o formaterach](/docs/formatters). --- -### Uprawnienia +### Permissions (Uprawnienia) -Domyślnie opencode **zezwala na wszystkie działania** bez konieczności posiadania zgody. Można zmienić opcję `permission`. +Domyślnie OpenCode **zezwala na wszystkie działania** bez konieczności zatwierdzania. Możesz to zmienić za pomocą opcji `permission`. -Na przykład, aby można było wykryć, że narzędzie `edit` i `bash` wymaga zgody użytkownika: +Na przykład, aby wymagać zatwierdzenia dla narzędzi `edit` i `bash`: ```json title="opencode.json" { @@ -477,13 +473,13 @@ Na przykład, aby można było wykryć, że narzędzie `edit` i `bash` wymaga zg } ``` -[Dowiedz się więcej o prawach tutaj](/docs/permissions). +[Dowiedz się więcej o uprawnieniach](/docs/permissions). --- -### Zagęszczanie +### Compaction (Kompaktowanie) -Możesz kontrolować zachowanie zagęszczania kontekstu za pomocą opcji `compaction`. +Możesz kontrolować zachowanie kompaktowania kontekstu za pomocą opcji `compaction`. ```json title="opencode.json" { @@ -496,13 +492,13 @@ Możesz kontrolować zachowanie zagęszczania kontekstu za pomocą opcji `compac ``` - `auto` - Automatycznie kompaktuj, gdy kontekst jest pełny (domyślnie: `true`). -- `prune` - Usuń stare dane narzędzia, aby zapisać tokeny (domyślnie: `true`). +- `prune` - Usuń stare wyniki narzędzi, aby zaoszczędzić tokeny (domyślnie: `true`). --- -### Obserwator +### Watcher (Obserwator) -Rejestracja wzorca plików za pomocą `watcher`. +Skonfiguruj ignorowane wzorce plików dla obserwatora plików za pomocą `watcher`. ```json title="opencode.json" { @@ -513,13 +509,13 @@ Rejestracja wzorca plików za pomocą `watcher`. } ``` -Wzorce są zgodne ze składnią glob. Dostęp tej opcji, aby móc zaszumione katalogi z plikami do przeglądania. +Wzorce są zgodne ze składnią glob. Użyj tej opcji, aby wykluczyć często zmieniające się lub duże katalogi z monitorowania. --- -### Serwery MCP +### MCP Servers (Serwery MCP) -Dostęp do serwerów MCP, których chcesz używać, za pośrednictwem sieci `mcp`. +Skonfiguruj serwery MCP, których chcesz używać, za pomocą opcji `mcp`. ```json title="opencode.json" { @@ -528,15 +524,15 @@ Dostęp do serwerów MCP, których chcesz używać, za pośrednictwem sieci `mcp } ``` -[Dowiedz się więcej tutaj](/docs/mcp-servers). +[Dowiedz się więcej o serwerach MCP](/docs/mcp-servers). --- -### Wtyczki +### Plugins (Wtyczki) -[Wtyczki](/docs/plugins) rozszerzają opencode o podstawowe narzędzia, hooki i integracje. +[Wtyczki](/docs/plugins) rozszerzają OpenCode o niestandardowe narzędzia, hooki i integracje. -Pliki plików wtyczek w `.opencode/plugins/` lub `~/.config/opencode/plugins/`. Można także włączyć wtyczkę z npm poprzez opcję `plugin`. +Umieść pliki wtyczek w `.opencode/plugins/` lub `~/.config/opencode/plugins/`. Możesz także załadować wtyczkę z npm za pomocą opcji `plugin`. ```json title="opencode.json" { @@ -545,13 +541,13 @@ Pliki plików wtyczek w `.opencode/plugins/` lub `~/.config/opencode/plugins/`. } ``` -[Dowiedz się więcej tutaj](/docs/plugins). +[Dowiedz się więcej o wtyczkach](/docs/plugins). --- -### Instructions +### Instructions (Instrukcje) -Instrukcja dla modelu, w której można zastosować opcję `instructions`. +Określ pliki instrukcji dla modelu, używając opcji `instructions`. ```json title="opencode.json" { @@ -560,14 +556,13 @@ Instrukcja dla modelu, w której można zastosować opcję `instructions`. } ``` -Pobierana do schematów i wzorców globalnych do plików graficznych. [Dowiedz się więcej -o zasadach tutaj](/docs/rules). +Załadowane pliki są dołączane do promptu systemowego. Obsługuje wzorce glob. [Dowiedz się więcej o zasadach](/docs/rules). --- -### Wyłączeni dostawcy +### Disabled Providers (Wyłączeni dostawcy) -Zasilacz ładowany automatycznie za pomocą zasilacza `disabled_providers`. Jest to możliwe, gdy istnieje możliwość podłączenia ładowania niektórych dostawców, nawet jeśli dane uwierzytelniające są dostępne. +Zapobiegaj automatycznemu ładowaniu dostawców za pomocą opcji `disabled_providers`. Jest to przydatne, gdy chcesz wyłączyć niektórych dostawców, nawet jeśli masz dla nich dane uwierzytelniające. ```json title="opencode.json" { @@ -577,20 +572,20 @@ Zasilacz ładowany automatycznie za pomocą zasilacza `disabled_providers`. Jest ``` :::note -`disabled_providers` pierwszeństwo przed `enabled_providers`. +`disabled_providers` ma pierwszeństwo przed `enabled_providers`. ::: -Opcja `disabled_providers` analiza tablica identyfikatorów dostawców. Gdy dostawca jest wyłączony: +Opcja `disabled_providers` przyjmuje tablicę identyfikatorów dostawców. Gdy dostawca jest wyłączony: -- Nie istnieje możliwość wystąpienia zagrożenia, które jest możliwe do zastosowania. -- Nie nastąpi uruchomienie, nawet jeśli klucz API zostanie uruchomiony za pomocą polecenia `/connect`. -- Model dostawcy nie pojawia się na liście wyboru modeli. +- Nie zostanie załadowany podczas startu. +- Nie zostanie załadowany, nawet jeśli podasz klucz API za pomocą `/connect`. +- Modele tego dostawcy nie pojawią się na liście wyboru modeli. --- -### Włączeni dostawcy +### Enabled Providers (Włączeni dostawcy) -Można znaleźć dostawców za pomoc `enabled_providers`. Po ustawieniu włączeni tylko dostawcy, a wszyscy będą obecni. +Możesz określić listę dozwolonych dostawców za pomocą `enabled_providers`. Po ustawieniu, tylko wymienieni dostawcy będą ładowani. ```json title="opencode.json" { @@ -599,19 +594,19 @@ Można znaleźć dostawców za pomoc `enabled_providers`. Po ustawieniu włącze } ``` -Jest to urządzenie, gdy urządzenie opencode jest używane tylko z urządzeniami, zamiast odłączać ich jedno po drugim. +Jest to przydatne, gdy chcesz ograniczyć użycie OpenCode tylko do określonych dostawców. :::note -`disabled_providers` pierwszeństwo przed `enabled_providers`. +`disabled_providers` ma pierwszeństwo przed `enabled_providers`. ::: -Jeśli obowiązująsz w `enabled_providers`, jak i `disabled_providers`, `disabled_providers` pierwszeństwo ze względu na kompatybilność wsteczną. +Jeśli dostawca jest wymieniony zarówno w `enabled_providers`, jak i `disabled_providers`, `disabled_providers` wygrywa. --- -### Eksperymentalny +### Experimental (Eksperymentalne) -Klucz `experimental` zawiera opcje, które są początkiem rozwoju. +Klucz `experimental` zawiera opcje, które są we wczesnej fazie rozwoju. ```json title="opencode.json" { @@ -621,20 +616,20 @@ Klucz `experimental` zawiera opcje, które są początkiem rozwoju. ``` :::caution -Opcje eksperymentalne nie są awaryjne. Jedna zmiana lub zmiana bez zniszczenia. +Opcje eksperymentalne nie są stabilne. Mogą ulec zmianie lub zostać usunięte bez ostrzeżenia. ::: --- ## Zmienne -Możliwość wykorzystania danych zmiennych w plikach konfiguracyjnych, aby odwoływać się do zmiennych zewnętrznych i zawartości plików. +Możesz używać specjalnej składni w plikach konfiguracyjnych, aby odwoływać się do zmiennych środowiskowych i zawartości plików. --- -### Env vars +### Env vars (Zmienne środowiskowe) -zastosowanie `{env:VARIABLE_NAME}`, aby zakończyć zmiennego przebiegu: +Użyj `{env:VARIABLE_NAME}`, aby wstawić wartość zmiennej środowiskowej: ```json title="opencode.json" { @@ -651,13 +646,13 @@ zastosowanie `{env:VARIABLE_NAME}`, aby zakończyć zmiennego przebiegu: } ``` -Jeżeli zmienna kontrolna nie jest skonfigurowana, należy zastosować do niej pusty ciąg znaków. +Jeśli zmienna środowiskowa nie jest ustawiona, zostanie zastąpiona pustym ciągiem. --- -### Pliki +### Files (Pliki) -źródło `{file:path/to/file}`, aby znaleźć zawartość pliku: +Użyj `{file:path/to/file}`, aby wstawić zawartość pliku: ```json title="opencode.json" { @@ -675,11 +670,11 @@ Jeżeli zmienna kontrolna nie jest skonfigurowana, należy zastosować do niej p Ścieżki plików mogą być: -- Względem katalogu konfiguracyjnego -- Lub nadrzędne kierowane się od `/` lub `~` +- Względne do pliku konfiguracyjnego +- Lub absolutne, zaczynające się od `/` lub `~` -Sądzimy, że: +Zalecamy używanie tego do: -- Przechowywanie wrażliwych danych, takich jak klucze API, w oddzielnych plikach. -- Do udostępnienia dużych plików bez zaśmiecania konstrukcji. -- Udostępnianie fragmentów konfiguracji w wielu plikach konfiguracyjnych. +- Przechowywania wrażliwych danych, takich jak klucze API, w oddzielnych plikach. +- Ładowania dużych promptów bez zaśmiecania konfiguracji. +- Dzielenia fragmentów konfiguracji między wieloma plikami. diff --git a/packages/web/src/content/docs/pl/custom-tools.mdx b/packages/web/src/content/docs/pl/custom-tools.mdx index 3a49c341d..eaf403d2d 100644 --- a/packages/web/src/content/docs/pl/custom-tools.mdx +++ b/packages/web/src/content/docs/pl/custom-tools.mdx @@ -7,7 +7,7 @@ Narzędzia stosowane do funkcji, z których LLM może korzystać podczas rozmów --- -## Narzędzie do tworzenia +## Tworzenie narzędzia Narzędzia tworzą pliki **TypeScript** lub **JavaScript**. Definicja narzędzia może być odwoływana do skryptów napisanych w **dowolnym języku** — TypeScript lub JavaScript są używane tylko w tym samym narzędziu. @@ -79,7 +79,7 @@ Tworzy do dwóch narzędzi: `math_add` i `math_multiply`. --- -### Argumentacja +### Argumenty Do zdefiniowania argumentów można zastosować `tool.schema`, czyli po prostu [Zod](https://zod.dev). diff --git a/packages/web/src/content/docs/pl/formatters.mdx b/packages/web/src/content/docs/pl/formatters.mdx index 358a024cf..154c55ef8 100644 --- a/packages/web/src/content/docs/pl/formatters.mdx +++ b/packages/web/src/content/docs/pl/formatters.mdx @@ -1,62 +1,62 @@ --- title: Formatery -description: opencode używa formaterów specyficznych dla języka. +description: OpenCode używa formaterów specyficznych dla języka. --- -opencode automatycznie formatuje pliki po ich zapisaniu lub edycję przy użyciu formaterów przesyłanych dla języka. Dzięki temu wygenerowany kod będzie używany ze stylami kodu Twojego projektu. +OpenCode automatycznie formatuje pliki po ich zapisaniu lub edycji przy użyciu formaterów specyficznych dla języka. Zapewnia to, że wygenerowany kod jest zgodny ze stylem kodu Twojego projektu. --- -## Wbudowany +## Wbudowane -opencode zawiera kilka wbudowanych formaterów dla nauki języków i frameworków. Zawiera listę formaterów, rozszerzonych plików oraz rozszerzenia i konfiguratory, których potrzebujesz. +OpenCode zawiera kilka wbudowanych formaterów dla popularnych języków i frameworków. Poniższa tabela zawiera listę formaterów, obsługiwanych plików oraz wymagań konfiguracyjnych. -| Formater | Rozszerzenia | Wymagania | -| ----------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | -| gofmt | .idź | Komenda `gofmt` dostępna | -| ryzyko | .ex, .exs, .eex, .heex, .leex, .neex, .sface | Komenda `mix` dostępna | -| ładniejsza | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml i [więcej](https://prettier.io/docs/en/index.html) | Zależność `prettier` w `package.json` | -| biom | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml i [więcej](https://biomejs.dev/) | `biome.json(c)` plik konfiguracyjny | -| zyg | .zig, .zon | Komenda `zig` dostępna | -| formatuj brzęk | .c, .cpp, .h, .hpp, .ino i [więcej](https://clang.llvm.org/docs/ClangFormat.html) | `.clang-format` plik konfiguracyjny | -| ktlint | .kt, .kts | Komenda `ktlint` dostępna | -| kryza | .py, .pyi | Komenda `ruff` dostępna w konstrukcji | -| rustfmt | .rs | Komenda `rustfmt` dostępna | -| załadunek | .rs | Komenda `cargo fmt` dostępna | -| UV | .py, .pyi | Komenda `uv` dostępna | -| rubocop | .rb, .rake, .gemspec, .ru | Komenda `rubocop` dostępna | -| standardowe | .rb, .rake, .gemspec, .ru | Komenda `standardrb` dostępna | -| htmlupiększacz | .erb, .html.erb | Komenda `htmlbeautifier` dostępna | -| powietrze | .R | Komenda `air` dostępna | -| strzałka | .dart | Komenda `dart` dostępna | -| formatuj ocaml | .ml, .mli | Dostępna opcja `ocamlformat` i plik konfiguracyjny `.ocamlformat` | -| terraforma | .tf, .tfvars | Komenda `terraform` dostępna | -| blask | .blask | Komenda `gleam` dostępna | -| nixfmt | .nix | Komenda `nixfmt` dostępna | -| shfmt | .sh, .bash | Komenda `shfmt` dostępna | -| kufel | .php | Zależność `laravel/pint` w `composer.json` | -| oxfmt (eksperymentalny) | .js, .jsx, .ts, .tsx | wykonanie `oxfmt` w `package.json` i [flaga eksperymentalna zmienna env](/docs/cli/#experimental) | -| ormolu | .hs | Komenda `ormolu` dostępna | +| Formater | Rozszerzenia | Wymagania | +| -------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | +| gofmt | .go | Dostępne polecenie `gofmt` | +| mix | .ex, .exs, .eex, .heex, .leex, .neex, .sface | Dostępne polecenie `mix` | +| prettier | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml i [więcej](https://prettier.io/docs/en/index.html) | Zależność `prettier` w `package.json` | +| biome | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml i [więcej](https://biomejs.dev/) | Plik konfiguracyjny `biome.json(c)` | +| zig | .zig, .zon | Dostępne polecenie `zig` | +| clang-format | .c, .cpp, .h, .hpp, .ino i [więcej](https://clang.llvm.org/docs/ClangFormat.html) | Plik konfiguracyjny `.clang-format` | +| ktlint | .kt, .kts | Dostępne polecenie `ktlint` | +| ruff | .py, .pyi | Dostępne polecenie `ruff` | +| rustfmt | .rs | Dostępne polecenie `rustfmt` | +| cargo | .rs | Dostępne polecenie `cargo fmt` | +| uv | .py, .pyi | Dostępne polecenie `uv` | +| rubocop | .rb, .rake, .gemspec, .ru | Dostępne polecenie `rubocop` | +| standardrb | .rb, .rake, .gemspec, .ru | Dostępne polecenie `standardrb` | +| htmlbeautifier | .erb, .html.erb | Dostępne polecenie `htmlbeautifier` | +| air | .R | Dostępne polecenie `air` | +| dart | .dart | Dostępne polecenie `dart` | +| ocamlformat | .ml, .mli | Dostępne polecenie `ocamlformat` i plik konfiguracyjny `.ocamlformat` | +| terraform | .tf, .tfvars | Dostępne polecenie `terraform` | +| gleam | .gleam | Dostępne polecenie `gleam` | +| nixfmt | .nix | Dostępne polecenie `nixfmt` | +| shfmt | .sh, .bash | Dostępne polecenie `shfmt` | +| pint | .php | Zależność `laravel/pint` w `composer.json` | +| oxfmt (experimental) | .js, .jsx, .ts, .tsx | Zależność `oxfmt` w `package.json` i [eksperymentalna flaga](/docs/cli/#experimental) | +| ormolu | .hs | Dostępne polecenie `ormolu` | -Jeśli więc Twój projekt zawiera `prettier` w `package.json`, opencode automatycznie przejdź do podmiote. +Jeśli więc Twój projekt zawiera `prettier` w `package.json`, OpenCode automatycznie go użyje. --- ## Jak to działa -Kiedy opencode zapisuje lub edytuje plik: +Kiedy OpenCode zapisuje lub edytuje plik: -1. Badanie pliku dotyczącego wszystkich danych formaterów. -2. Uruchamia decyzje wykonawcze formatujące na plik. +1. Sprawdza plik pod kątem wszystkich dostępnych formaterów. +2. Uruchamia odpowiedni formater na pliku. 3. Automatycznie stosuje zmiany formatowania. -Dziesięć procesów zachodzi w tle, konieczne jest zachowanie stylów kodu bez konieczności wykonania czynności czynnościowych. +Ten proces odbywa się w tle, zapewniając spójność stylu kodu bez konieczności ręcznej interwencji. --- -## Skonfiguruj +## Konfiguracja -Można dostosować formatery za pomocą sekcji `formatter` w konstrukcji opencode. +Możesz dostosować formatery za pomocą sekcji `formatter` w konfiguracji OpenCode. ```json title="opencode.json" { @@ -65,14 +65,14 @@ Można dostosować formatery za pomocą sekcji `formatter` w konstrukcji opencod } ``` -obsługiwane formatyzator Zobacz elementy: +Każdy formater obsługuje następujące właściwości: -| Nieruchomość | Wpisz | Opis | -| ------------- | -------- | -------------------------------------------------------------------------- | -| `disabled` | boolean | Ustaw tę opcję na `true`, aby wyłączyć formater | -| `command` | string[] | Polecenie uruchomienia formatowania | -| `environment` | object | Zmienne ustawienia do ustawień podczas uruchamiania programu formatującego | -| `extensions` | string[] | Rozszerzenia plików, które powinny opuścić ten formater | +| Właściwość | Typ | Opis | +| ------------- | -------- | -------------------------------------------------------- | +| `disabled` | boolean | Ustaw na `true`, aby wyłączyć ten formater | +| `command` | string[] | Polecenie uruchomienia formatera | +| `environment` | object | Zmienne środowiskowe ustawiane podczas uruchamiania | +| `extensions` | string[] | Rozszerzenia plików, które powinny używać tego formatera | Spójrzmy na kilka przykładów. @@ -106,7 +106,7 @@ Aby wyłączyć **określony** formater, ustaw `disabled` na `true`: ### Niestandardowe formatery -Może wystąpić, gdyby nastąpiło nowe, uruchomienie, zmienne udostępnienie i udostępnienie plików: +Możesz dodać niestandardowe formatery, podając polecenie, zmienne środowiskowe i rozszerzenia plików: ```json title="opencode.json" {4-14} { @@ -127,4 +127,4 @@ Może wystąpić, gdyby nastąpiło nowe, uruchomienie, zmienne udostępnienie i } ``` -Symbol zastępczy **`$FILE`** w poleceniu pochodziony z formatowanego pliku. +Symbol zastępczy **`$FILE`** w poleceniu jest zastępowany ścieżką do formatowanego pliku. diff --git a/packages/web/src/content/docs/pl/index.mdx b/packages/web/src/content/docs/pl/index.mdx index c89ce24ad..1c4ea7ea2 100644 --- a/packages/web/src/content/docs/pl/index.mdx +++ b/packages/web/src/content/docs/pl/index.mdx @@ -1,5 +1,5 @@ --- -title: Intro +title: Wstęp description: Zacznij pracę z opencode. --- @@ -7,7 +7,7 @@ import { Tabs, TabItem } from "@astrojs/starlight/components" import config from "../../../../config.mjs" export const console = config.console -[**opencode**](/) to open source AI coding agent. Jest dostępny jako interfejs terminalowy, aplikacja desktopowa i rozszerzenie IDE. +[**opencode**](/) to agent kodujący AI typu open source. Jest dostępny jako interfejs terminalowy, aplikacja desktopowa i rozszerzenie IDE. ![opencode TUI z motywem opencode](../../../assets/lander/screenshot.png) @@ -89,8 +89,8 @@ Możesz też użyć poniższych metod instalacji: #### Windows -:::tip[Zalecane: prowadzenie WSL] -Aby najlepiej wykorzystać działanie w systemie Windows, zalecamy udostępnienie [Podsystemu Windows dla systemu Linux (WSL)](/docs/windows-wsl). pozwolenie na użytkowanie i pełna kompatybilność z funkcjami opencode. +:::tip[Zalecane: Uruchamianie w WSL] +Aby najlepiej wykorzystać działanie w systemie Windows, zalecamy włączenie [Podsystemu Windows dla systemu Linux (WSL)](/docs/windows-wsl). Zapewnia to pełną kompatybilność z funkcjami opencode. ::: - **Używając Chocolatey** @@ -123,21 +123,20 @@ Aby najlepiej wykorzystać działanie w systemie Windows, zalecamy udostępnieni docker run -it --rm ghcr.io/anomalyco/opencode ``` -Obecnie trwają prace nad instalacją opencode w systemie Windows za pomocą Bun. +Obecnie pracujemy nad instalacją opencode w systemie Windows za pomocą Bun. -Możesz także otrzymać plik binarny z [Releases](https://github.com/anomalyco/opencode/releases). +Możesz także pobrać plik binarny z [Releases](https://github.com/anomalyco/opencode/releases). --- -## Skonfiguruj +## Konfiguracja Dzięki opencode możesz korzystać z dowolnego dostawcy LLM, konfigurując jego klucze API. -Jeśli nadal będziesz korzystać z dostawców LLM, zalecamy skorzystanie z [OpenCode Zen](/docs/zen). -Do wyselekcjonowanej listy modeli, które zostały zatwierdzone i zweryfikowane przez opencode -zespół. +Jeśli będziesz korzystać z wielu dostawców LLM, zalecamy skorzystanie z [OpenCode Zen](/docs/zen). +Aby uzyskać dostęp do wyselekcjonowanej listy modeli, które zostały zatwierdzone i zweryfikowane przez zespół opencode. -1. Uruchom opcję `/connect` w TUI, wybierz opencode i przejdź do [opencode.ai/auth](https://opencode.ai/auth). +1. Uruchom polecenie `/connect` w TUI, wybierz opencode i przejdź do [opencode.ai/auth](https://opencode.ai/auth). ```txt /connect @@ -158,55 +157,50 @@ Alternatywnie możesz wybrać jednego z dodatkowych dostawców. [Dowiedz się wi --- -## Zainicjuj +## Inicjalizacja -Po skonfigurowaniu dostawcy, który może przejść do projektu, który -chcesz pracować. +Po skonfigurowaniu dostawcy możesz przejść do projektu, nad którym chcesz pracować. ```bash cd /path/to/project ``` -Uruchamiam opencode. +Uruchom opencode. ```bash opencode ``` -Następnie zainicjuj opencode dla projektu, uruchamiając odpowiednią instrukcję. +Następnie zainicjuj opencode dla projektu, uruchamiając odpowiednie polecenie. ```bash frame="none" /init ``` -Spowoduje to, że opencode przeanalizuje Twój projekt i utworzy plik `AGENTS.md` -katalog główny projektu. +Spowoduje to, że opencode przeanalizuje Twój projekt i utworzy plik `AGENTS.md` w katalogu głównym projektu. :::tip -Powinieneś zatwierdzić plik `AGENTS.md` swojego projektu w Git. +Powinieneś zacommitować plik `AGENTS.md` swojego projektu w Git. ::: -Pomaga w opencode zrozumieniu struktury projektu i wzorce kodowania -używany. +Pomaga to opencode zrozumieć strukturę projektu i stosowane wzorce kodowania. --- ## Użycie -Teraz możesz pracować nad swoim projektem. Możesz o to zapytać -wszystko! +Teraz możesz pracować nad swoim projektem. Możesz zapytać o wszystko! -Jeśli tylko zaczniesz korzystać z agenta kodującego AI, oto kilka, które mogą być używane -pomoc. +Jeśli dopiero zaczynasz korzystać z agenta kodującego AI, oto kilka wskazówek, które mogą być pomocne. --- ### Zadawaj pytania -Możesz uruchomić opencode o wyjaśnienie bazy kodu. +Możesz poprosić opencode o wyjaśnienie bazy kodu. :::tip -klawisza klawisza `@` do wyszukiwania rozmytego plików w projekcie. +Użyj `@` do wyszukiwania rozmytego plików w projekcie. ::: ```txt frame="none" "@packages/functions/src/api/index.ts" @@ -219,20 +213,20 @@ Jest to pomocne, jeśli istnieje część bazy kodu, nad którą nie pracowałe ### Dodaj funkcje -Możesz zastosować opencode o nowej funkcji do Twojego projektu. Najpierw zalecamy poproszenie o wypłacenie planu. +Możesz poprosić opencode o dodanie nowej funkcji do Twojego projektu. Najpierw zalecamy poproszenie o przygotowanie planu. -1. **Plan Stworza** +1. **Stwórz Plan** opencode ma _Plan Mode_, który umożliwia wyłączenie zmian i - zamiast tego zasugeruj, jak\_ zaimplementuje tę funkcję. + zamiast tego zasugeruje, jak zaimplementować tę funkcję. - Przejdź do niego za pomocą klawisza **Tab**. W osobnym dolnym rogu zobacz właściwy wskaźnik. + Przejdź do niego za pomocą klawisza **Tab**. Zobaczysz odpowiedni wskaźnik w prawym dolnym rogu. ```bash frame="none" title="Switch to Plan mode" ``` - Opiszmy teraz, co chcemy, żeby robił. + Opiszmy teraz, co chcemy, żeby zrobił. ```txt frame="none" When a user deletes a note, we'd like to flag it as deleted in the database. @@ -240,17 +234,16 @@ Możesz zastosować opencode o nowej funkcji do Twojego projektu. Najpierw zalec From this screen, the user can undelete a note or permanently delete it. ``` - Wersja opencode zawiera dużo oprogramowania, aby zrozumieć, czego chcesz. To pomaga + Wersja opencode jest bardzo inteligentna, aby zrozumieć, czego chcesz. To pomaga rozmawiaj z nim tak, jakbyś rozmawiał z młodszym programistą w swoim zespole. :::tip - Podaj opencode kontekstu i kontekstu, które można zrozumieć, co Ty - chcieć. + Podaj opencode kontekst, aby zrozumiał, czego chcesz. ::: -2. **Postęp zgodnie z planem** +2. **Udoskonalanie planu** - Gdy będziesz mieć plan, możesz pozostawić go lub podłączyć więcej. + Gdy będziesz mieć plan, możesz zostawić go lub dodać więcej. ```txt frame="none" We'd like to design this new screen using a design I've used before. @@ -261,18 +254,17 @@ Możesz zastosować opencode o nowej funkcji do Twojego projektu. Najpierw zalec Przeciągnij i upuść obrazy do terminala, aby dodać je do monitu. ::: - opencode może zeskanować obrazy, które mu przekażesz i poprosisz o potwierdzenie. Możesz - należy to, przeciągając i upuszczając obraz do terminala. + opencode może zeskanować obrazy, które mu przekażesz i zrozumieć je. Możesz to zrobić, przeciągając i upuszczając obraz do terminala. -3. **Stwórz przełącza** +3. **Wprowadź zmiany** - Kiedy już jest komfortowo z planem, przełącz się z powrotem do _Act Mode_ na klawisza **Tab**. + Kiedy już będziesz zadowolony z planu, przełącz się z powrotem do _Act Mode_ naciskając klawisz **Tab**. ```bash frame="none" ``` - Poproszę o wprowadzenie zmian. + Poproś o wprowadzenie zmian. ```bash frame="none" Sounds good! Go ahead and make the changes. @@ -282,8 +274,7 @@ Możesz zastosować opencode o nowej funkcji do Twojego projektu. Najpierw zalec ### Wprowadź zmiany -Aby zastosować następczą zmianę, można zastosować opencode lub bezpośrednio zbudowanie go -bez konieczności wcześniejszego przeglądania planu. +Aby wprowadzić kolejną zmianę, możesz poprosić opencode lub zrobić to bezpośrednio bez konieczności wcześniejszego przeglądania planu. ```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 @@ -291,8 +282,7 @@ handled in the /notes route in @packages/functions/src/notes.ts and implement the same logic in @packages/functions/src/settings.ts ``` -Musisz mieć dostęp, że pod warunkiem dostępności narzędzia, więc opencode ma właściwie -zmiany. +Musisz upewnić się, że dostarczyłeś odpowiednie pliki, aby opencode mógł wprowadzić zmiany. --- @@ -304,27 +294,26 @@ Załóżmy, że prosisz opencode o wprowadzenie zmian. Can you refactor the function in @packages/functions/src/api/index.ts? ``` -Ale z sobie sobie sprawę, że to nie jest to, czego chciałeś. **Możesz być** zmiany -za pomoc polecenia `/undo`. +Ale zdajesz sobie sprawę, że to nie jest to, czego chciałeś. **Możesz cofnąć** zmiany +za pomocą polecenia `/undo`. ```bash frame="none" /undo ``` -opencode cofnie teraz zmiany i wyświetli wiadomość -Ponownie. +opencode cofnie teraz zmiany i wyświetli wiadomość ponownie. ```txt frame="none" "@packages/functions/src/api/index.ts" Can you refactor the function in @packages/functions/src/api/index.ts? ``` -Można zastosować monit i zastosować opencode o próbę próby. +Możesz edytować monit i poprosić opencode o ponowną próbę. :::tip -Można `/undo` wiele razy, aby uniknąć wielu zmian. +Możesz użyć `/undo` wiele razy, aby cofnąć wiele zmian. ::: -Możesz też **możesz powtórzyć** zmianę za pomocą polecenia `/redo`. +Możesz też **przywrócić** zmianę za pomocą polecenia `/redo`. ```bash frame="none" /redo @@ -334,14 +323,13 @@ Możesz też **możesz powtórzyć** zmianę za pomocą polecenia `/redo`. ## Udostępnianie -Rozmowy z opencode można [udostępniać swoim -zespół](/docs/share). +Rozmowy z opencode można [udostępniać swojemu zespołowi](/docs/share). ```bash frame="none" /share ``` -Spowoduje to, że łącza do bieżących połączeń idą do schowki. +Spowoduje to, że link do bieżącej rozmowy zostanie skopiowany do schowka. :::note Rozmowy nie są ogólnodostępne. @@ -353,6 +341,6 @@ Oto [przykładowa rozmowa](https://opencode.ai/s/4XP1fce5) z opencode. ## Dostosuj -tyle! Jesteś teraz profesjonalistą w korzystaniu z opencode. +To tyle! Jesteś teraz profesjonalistą w korzystaniu z opencode. -Aby dostosować go do potrzeb, zalecamy [wybranie motywu](/docs/themes), [dostosowanie skrótów klawiaturowych](/docs/keybinds), [konfigurowanie programów formatujących kod](/docs/formatters), [tworzenie niestandardowych kodów](/docs/commands) lub grę z [konfiguracją opencode](/docs/config). +Aby dostosować go do potrzeb, zalecamy [wybranie motywu](/docs/themes), [dostosowanie skrótów klawiaturowych](/docs/keybinds), [konfigurowanie programów formatujących kod](/docs/formatters), [tworzenie niestandardowych poleceń](/docs/commands) lub zabawę z [konfiguracją opencode](/docs/config). diff --git a/packages/web/src/content/docs/pl/lsp.mdx b/packages/web/src/content/docs/pl/lsp.mdx index b1fffc90b..8430bd9ca 100644 --- a/packages/web/src/content/docs/pl/lsp.mdx +++ b/packages/web/src/content/docs/pl/lsp.mdx @@ -1,71 +1,71 @@ --- title: Serwery LSP -description: opencode integruje się z serwerem LSP. +description: OpenCode integruje się z serwerami LSP. --- -opencode integruje się z protokołem serwera językowego (LSP), aby pomóc LLM w korzystaniu z bazowego kodu. Wykorzystuje diagnostykę, aby otrzymać odpowiedź zwrotną do LLM. +OpenCode integruje się z protokołem Language Server Protocol (LSP), aby zapewnić modelom LLM kontekst bazy kodu. Wykorzystuje diagnostykę, aby przekazywać informacje zwrotne do LLM. --- -## Wbudowany +## Wbudowane -opencode posiada kilka wbudowanych serwerów LSP dla języków: +OpenCode posiada kilka wbudowanych serwerów LSP dla następujących języków: -| Serwer LSP | Rozszerzenie | Wymagania | -| ------------------ | ------------------------------------------------------------------- | -------------------------------------------------------------------------- | -| astro | .astro | Automatyczne instalacje dla Astro | -| bash | .sh, .bash, .zsh, .ksh | Automatycznie instaluje serwer języka bash | -| clangd | .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++ | Automatyczne instalacje dla C/C++ | -| csharp | .cs | `.NET SDK` zainstalowany | -| clojure-lsp | .clj, .cljs, .cljc, .edn | Komenda `clojure-lsp` dostępna | -| dart | .dart | Komenda `dart` dostępna | -| deno | .ts, .tsx, .js, .jsx, .mjs | Dostępne rozwiązanie `deno` (automatyczne wykrywanie deno.json/deno.jsonc) | -| elixir-ls | .ex, .exs | Komenda `elixir` dostępna | -| eslint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue | `eslint` zależność w projekcie | -| fsharp | .fs, .fsi, .fsx, .fsscript | `.NET SDK` zainstalowany | -| gleam | .gleam | Komenda `gleam` dostępna | -| gopls | .go | Komenda `go` dostępna | -| hls | .hs, .lhs | Komenda `haskell-language-server-wrapper` dostępna | -| jdtls | .java | `Java SDK (version 21+)` zainstalowany | -| kotlin-ls | .kt, .kts | Automatyczne instalacje dla Kotlin | -| lua-ls | .lua | Automatyczne instalacje dla Lua | -| nixd | .nix | Komenda `nixd` dostępna | -| ocaml-lsp | .ml, .mli | Komenda `ocamllsp` dostępna | -| oxlint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte | `oxlint` zależność w projekcie | -| php intelephense | .php | Automatyczne instalacje dla PHP | -| prisma | .prisma | Komenda `prisma` dostępna | -| pyright | .py, .pyi | Zainstalowana zależność `pyright` | -| ruby-lsp (rubocop) | .rb, .rake, .gemspec, .ru | Dostępne polecenie `ruby` i `gem` | -| rust | .rs | Komenda `rust-analyzer` dostępna | -| sourcekit-lsp | .swift, .objc, .objcpp | `swift` zainstalowany (`xcode` na macOS) | -| svelte | .svelte | Automatyczne instalacje dla aplikacji Svelte | -| terraform | .tf, .tfvars | Automatyczne instalacje z wydań GitHub | -| tinymist | .typ, .typc | Automatyczne instalacje z wydań GitHub | -| typescript | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts | `typescript` zależność w projekcie | -| vue | .vue | Automatyczne instalacje dla Vue | -| yaml-ls | .yaml, .yml | Automatycznie instaluje serwer języka yaml Red Hat | -| zls | .zig, .zon | Komenda `zig` dostępna | +| Serwer LSP | Rozszerzenia | Wymagania | +| ------------------ | ------------------------------------------------------------------- | ------------------------------------------------------------------------ | +| astro | .astro | Automatyczna instalacja dla Astro | +| bash | .sh, .bash, .zsh, .ksh | Automatycznie instaluje serwer języka bash | +| clangd | .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++ | Automatyczna instalacja dla C/C++ | +| csharp | .cs | Zainstalowany `.NET SDK` | +| clojure-lsp | .clj, .cljs, .cljc, .edn | Dostępne polecenie `clojure-lsp` | +| dart | .dart | Dostępne polecenie `dart` | +| deno | .ts, .tsx, .js, .jsx, .mjs | Dostępne polecenie `deno` (automatyczne wykrywanie deno.json/deno.jsonc) | +| elixir-ls | .ex, .exs | Dostępne polecenie `elixir` | +| eslint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue | Zależność `eslint` w projekcie | +| fsharp | .fs, .fsi, .fsx, .fsscript | Zainstalowany `.NET SDK` | +| gleam | .gleam | Dostępne polecenie `gleam` | +| gopls | .go | Dostępne polecenie `go` | +| hls | .hs, .lhs | Dostępne polecenie `haskell-language-server-wrapper` | +| jdtls | .java | Zainstalowany `Java SDK (version 21+)` | +| kotlin-ls | .kt, .kts | Automatyczna instalacja dla Kotlin | +| lua-ls | .lua | Automatyczna instalacja dla Lua | +| nixd | .nix | Dostępne polecenie `nixd` | +| ocaml-lsp | .ml, .mli | Dostępne polecenie `ocamllsp` | +| oxlint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte | Zależność `oxlint` w projekcie | +| php intelephense | .php | Automatyczna instalacja dla PHP | +| prisma | .prisma | Dostępne polecenie `prisma` | +| pyright | .py, .pyi | Zainstalowana zależność `pyright` | +| ruby-lsp (rubocop) | .rb, .rake, .gemspec, .ru | Dostępne polecenie `ruby` i `gem` | +| rust | .rs | Dostępne polecenie `rust-analyzer` | +| sourcekit-lsp | .swift, .objc, .objcpp | Zainstalowany `swift` (`xcode` na macOS) | +| svelte | .svelte | Automatyczna instalacja dla aplikacji Svelte | +| terraform | .tf, .tfvars | Automatyczna instalacja z wydań GitHub | +| tinymist | .typ, .typc | Automatyczna instalacja z wydań GitHub | +| typescript | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts | Zależność `typescript` w projekcie | +| vue | .vue | Automatyczna instalacja dla Vue | +| yaml-ls | .yaml, .yml | Automatycznie instaluje serwer języka yaml Red Hat | +| zls | .zig, .zon | Dostępne polecenie `zig` | -Serwery LSP są automatycznie włączane po wykryciu jednego z rozszerzonych plików i wymagań. +Serwery LSP są automatycznie włączane po wykryciu jednego z obsługiwanych plików i spełnieniu wymagań. :::note -Możliwość automatycznego pobierania z serwera LSP, ustawianie zmiennej środowiska `OPENCODE_DISABLE_LSP_DOWNLOAD` na `true`. +Możesz wyłączyć automatyczne pobieranie serwerów LSP, ustawiając zmienną środowiskową `OPENCODE_DISABLE_LSP_DOWNLOAD` na `true`. ::: --- ## Jak to działa -Gdy opencode otwiera plik, to: +Gdy OpenCode otwiera plik: -1. Sprawdzanie pliku na wszystkich dostępnych serwerach LSP. -2. Uruchamia właściwy serwer LSP, jeśli jeszcze nie działa. +1. Sprawdza plik pod kątem wszystkich dostępnych serwerów LSP. +2. Uruchamia odpowiedni serwer LSP, jeśli jeszcze nie działa. --- -## Skonfiguruj +## Konfiguracja -Możesz dostosować serwery LSP poprzez sekcję `lsp` w konfiguracji opencode. +Możesz dostosować serwery LSP poprzez sekcję `lsp` w konfiguracji OpenCode. ```json title="opencode.json" { @@ -74,15 +74,15 @@ Możesz dostosować serwery LSP poprzez sekcję `lsp` w konfiguracji opencode. } ``` -Każdy serwer LSP obsługuje szczegółowe elementy: +Każdy serwer LSP obsługuje następujące właściwości: -| Nieruchomość | Wpisz | Opis | +| Właściwość | Typ | Opis | | ---------------- | -------- | ------------------------------------------------------ | -| `disabled` | boolean | Ustaw tę opcję na `true`, aby wyłączyć serwer LSP | +| `disabled` | boolean | Ustaw na `true`, aby wyłączyć ten serwer LSP | | `command` | string[] | Polecenie uruchomienia serwera LSP | -| `extensions` | string[] | Rozszerzenia plików, które powinny mieć ten serwer LSP | -| `env` | object | Zmienne ustawienia podczas uruchamiania serwera | -| `initialization` | object | Opcje inicjalizacji do wysłania na serwer LSP | +| `extensions` | string[] | Rozszerzenia plików, które powinny używać tego serwera | +| `env` | object | Zmienne środowiskowe ustawiane podczas uruchamiania | +| `initialization` | object | Opcje inicjalizacji do wysłania do serwera LSP | Spójrzmy na kilka przykładów. @@ -90,7 +90,7 @@ Spójrzmy na kilka przykładów. ### Zmienne środowiskowe -Zastosowanie `env`, aby ustawić zmienne parametry transmisji podczas uruchamiania serwera LSP: +Użyj `env`, aby ustawić zmienne środowiskowe podczas uruchamiania serwera LSP: ```json title="opencode.json" {5-7} { @@ -109,7 +109,7 @@ Zastosowanie `env`, aby ustawić zmienne parametry transmisji podczas uruchamian ### Opcje inicjalizacji -właściwości `initialization`, aby mieć możliwość inicjalizacji na serwerze LSP. Są to ustawienia dla serwera wysyłającego podczas przełączania LSP `initialize`: +Użyj właściwości `initialization`, aby przekazać niestandardowe opcje inicjalizacji do serwera LSP. Są one wysyłane w żądaniu `initialize` protokołu LSP: ```json title="opencode.json" {5-9} { @@ -127,7 +127,7 @@ właściwości `initialization`, aby mieć możliwość inicjalizacji na serwerz ``` :::note -Opcje inicjalizacji różnią się w zależności od serwera LSP. Sprawdź swój serwer LSP pod gniazdem. +Opcje inicjalizacji różnią się w zależności od serwera LSP. Sprawdź dokumentację swojego serwera LSP. ::: --- @@ -143,7 +143,7 @@ Aby wyłączyć **wszystkie** serwery LSP globalnie, ustaw `lsp` na `false`: } ``` -Aby wyłączyć **określony** serwer LSP, ustawa `disabled` na `true`: +Aby wyłączyć **określony** serwer LSP, ustaw `disabled` na `true`: ```json title="opencode.json" {5} { @@ -160,7 +160,7 @@ Aby wyłączyć **określony** serwer LSP, ustawa `disabled` na `true`: ### Niestandardowe serwery LSP -Serwer udostępniający serwery LSP, mechanizmy sterujące i udostępniane pliki: +Możesz dodać niestandardowe serwery LSP, podając polecenie i rozszerzenia plików: ```json title="opencode.json" {4-7} { @@ -178,11 +178,11 @@ Serwer udostępniający serwery LSP, mechanizmy sterujące i udostępniane pliki ## Dodatkowe informacje -### PHP Intelefense +### PHP Intelephense -PHP Intelephense oferuje funkcje premium poprzez klucz licencyjny. Możesz przechowywać klucz licencyjny umieszczając (tylko) klucz w pliku tekstowym pod adresem: +PHP Intelephense oferuje funkcje premium poprzez klucz licencyjny. Możesz użyć klucza licencyjnego, umieszczając go (sam klucz) w pliku tekstowym pod adresem: -- W systemie macOS/Linux: `$HOME/intelephense/license.txt` -- W systemie Windows: `%USERPROFILE%/intelephense/license.txt` +- macOS/Linux: `$HOME/intelephense/license.txt` +- Windows: `%USERPROFILE%/intelephense/license.txt` -Plik powinien zawierać wyłącznie klucz licencyjny, bez udostępniania treści. +Plik powinien zawierać wyłącznie klucz licencyjny, bez białych znaków. diff --git a/packages/web/src/content/docs/pl/models.mdx b/packages/web/src/content/docs/pl/models.mdx index 8c6fcf51d..e1c792290 100644 --- a/packages/web/src/content/docs/pl/models.mdx +++ b/packages/web/src/content/docs/pl/models.mdx @@ -195,7 +195,7 @@ Można uwzględnić warianty lub dodać własne: } ``` -### Warianty cyklu +### Przełączanie wariantów Naciśnij klawisza `variant_cycle`, aby szybko przełączać się między wariantami. [Dowiedz się więcej](/docs/keybinds). diff --git a/packages/web/src/content/docs/pl/modes.mdx b/packages/web/src/content/docs/pl/modes.mdx index 6cec27515..52ab16334 100644 --- a/packages/web/src/content/docs/pl/modes.mdx +++ b/packages/web/src/content/docs/pl/modes.mdx @@ -17,7 +17,7 @@ Można przełączać się między trybami podczas sesji lub konfigurować je w p --- -## Wbudowany +## Wbudowane opencode ma dwa puste tryby. @@ -54,7 +54,7 @@ Zobacz także: [Formaterzy](/docs/formatters), aby uzyskać informacje na temat Możliwość dostosowania alternatywnego trybu lub konfiguracji poprzez własną konfigurację. Tryb można skonfigurować na dwa systemy: -### Konfiguracja JSON-a +### Konfiguracja JSON Skonfiguruj tryb w pliku konfiguracyjnym `opencode.json`: @@ -83,7 +83,7 @@ Skonfiguruj tryb w pliku konfiguracyjnym `opencode.json`: } ``` -### Konfiguracja przecen +### Konfiguracja Markdown Można także definiować tryby za pomocą plików przecen. Trzymaj je w: @@ -177,7 +177,7 @@ Jeśli nie ma wpływu na temperaturę, opencode stosuje się narzędzia badawcze --- -### Podpowiedź +### Prompt (Monit) niestandardowy plik podpowiedzi systemowych dla tej procedury za pomocą konfiguracji `prompt`. Plik informacyjny powinien zawierać instrukcje dotyczące przeznaczenia trybu. @@ -221,7 +221,7 @@ Jeśli nie ma żadnych narzędzi, wszystkie narzędzia są wyłączone. --- -#### Dostępne narzędzie +#### Dostępne narzędzia Oto wszystkie narzędzia, które można sterować za pomocą konfiguracji trybów. diff --git a/packages/web/src/content/docs/pl/providers.mdx b/packages/web/src/content/docs/pl/providers.mdx index 4ed34411d..58f824764 100644 --- a/packages/web/src/content/docs/pl/providers.mdx +++ b/packages/web/src/content/docs/pl/providers.mdx @@ -1,5 +1,5 @@ --- -title: Providers +title: Dostawcy description: Korzystanie z dowolnego dostawcy LLM w opencode. --- @@ -22,7 +22,7 @@ w `~/.local/share/opencode/auth.json`. --- -### Config +### Konfiguracja Możesz dostosować dostawców za pomocą sekcji `provider` w swoim opencode config. @@ -84,7 +84,7 @@ Działa jak każdy inny dostawca w opencode i jest całkowicie opcjonalny w uży --- -## Directory +## Katalog Przyjrzyjmy się szczegółowo niektórym dostawcom. Jeśli chcesz dodać dostawcę do listę, możesz otworzyć PR. @@ -184,7 +184,7 @@ Aby używać Amazon Bedrock z opencode: Opcje z pliku konfiguracyjnego mają pierwszeństwo przed zmiennymi środowiskowymi. ::: - #### Zaawansowane: endpointy VPC + #### Zaawansowane: Punkty końcowe VPC Jeśli używasz punktów końcowych VPC dla Bedrock: @@ -659,7 +659,7 @@ GitLab Duo zapewnia czat agentowy oparty na sztucznej inteligencji z natywnymi m Wybierz **OAuth**, a Twoja przeglądarka otworzy się w celu autoryzacji. - #### Using Personal Access Token + #### Użycie osobistego tokenu dostępu 1. Przejdź do [Ustawienia użytkownika GitLab > Tokeny dostępu](https://gitlab.com/-/user_settings/personal_access_tokens) 2. Click **Add new token** 3. Name: `OpenCode`, Scopes: `api` @@ -748,7 +748,7 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here Więcej informacji znajdziesz na stronie [opencode-gitlab-auth](https://www.npmjs.com/package/@gitlab/opencode-gitlab-auth). -##### Configuration +##### Konfiguracja Customize through `opencode.json`: @@ -769,7 +769,7 @@ Customize through `opencode.json`: } ``` -##### GitLab API Tools (Optional, but highly recommended) +##### Narzędzia GitLab API (opcjonalne, ale wysoce zalecane) To access GitLab tools (merge requests, issues, pipelines, CI/CD, etc.): @@ -1873,7 +1873,7 @@ Pola `limit` pozwalają opencode zrozumieć, ile kontekstu pozostało. Standardo --- -## Troubleshooting +## Rozwiązywanie problemów Jeśli masz problemy z konfiguracją dostawcy, sprawdź następujące elementy: diff --git a/packages/web/src/content/docs/pl/rules.mdx b/packages/web/src/content/docs/pl/rules.mdx index a2496e19c..1b5876f22 100644 --- a/packages/web/src/content/docs/pl/rules.mdx +++ b/packages/web/src/content/docs/pl/rules.mdx @@ -1,5 +1,5 @@ --- -title: Rules +title: Zasady description: Ustaw niestandardowe instrukcje dla opencode. --- @@ -52,21 +52,21 @@ Dodajemy tutaj instrukcje dotyczące konkretnego projektu, które zostaną udost --- -## Types +## Typy opencode obsługuje także odczytywanie pliku `AGENTS.md` z wielu lokalizacji. A to służy różnym celom. -### Project +### Projekt Umieść `AGENTS.md` w katalogu głównym projektu, aby uzyskać reguły specyficzne dla projektu. Mają one zastosowanie tylko wtedy, gdy pracujesz w tym katalogu lub jego podkatalogach. -### Global +### Globalne Możesz także mieć reguły globalne w pliku `~/.config/opencode/AGENTS.md`. Jest to stosowane we wszystkich sesjach opencode. Ponieważ nie jest to wymagane dla Git ani udostępniane Twojemu zespołowi, zalecamy użycie tego do określenia wszelkich osobistych zasad, których powinien przestrzegać LLM. -### Claude Code Compatibility +### Kompatybilność z Claude Code W przypadku użytkowników migrujących z Claude Code opencode obsługuje konwencje plików Claude Code jako rozwiązania awaryjne: @@ -84,7 +84,7 @@ export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills --- -## Precedence +## Priorytet Po uruchomieniu opencode szuka plików reguł w następującej kolejności: @@ -139,7 +139,7 @@ Zalecanym podejściem jest użycie pola `instructions` w `opencode.json`: } ``` -### Manual Instructions in AGENTS.md +### Ręczne instrukcje w AGENTS.md Możesz nauczyć opencode czytać pliki zewnętrzne, podając wyraźne instrukcje w swoim `AGENTS.md`. Oto praktyczny przykład: diff --git a/packages/web/src/content/docs/pl/sdk.mdx b/packages/web/src/content/docs/pl/sdk.mdx index 2a0640ab3..3236e38c2 100644 --- a/packages/web/src/content/docs/pl/sdk.mdx +++ b/packages/web/src/content/docs/pl/sdk.mdx @@ -1,19 +1,19 @@ --- title: SDK -description: Klient JS bezpieczny dla typu dla serwera opencode. +description: Typowany klient JS dla serwera OpenCode. --- import config from "../../../../config.mjs" export const typesUrl = `${config.github}/blob/dev/packages/sdk/js/src/gen/types.gen.ts` -Pakiet SDK JS/TS z opencode zapewnia klienta bezpiecznego typu do interakcji z serwerem. -Użyj go do budowania integracji i programowej kontroli otwartego kodu. +Pakiet SDK JS/TS OpenCode zapewnia klienta z bezpiecznym typowaniem (type-safe) do interakcji z serwerem. +Użyj go do budowania integracji i programowej kontroli OpenCode. [Dowiedz się więcej](/docs/server) o działaniu serwera. Przykłady znajdziesz w [projektach](/docs/ecosystem#projects) stworzonych przez społeczność. --- -## Zainstalować +## Instalacja Zainstaluj pakiet SDK z npm: @@ -23,9 +23,9 @@ npm install @opencode-ai/sdk --- -## Utwórz klienta +## Tworzenie klienta -Utwórz instancję otwartego kodu: +Utwórz instancję OpenCode: ```javascript import { createOpencode } from "@opencode-ai/sdk" @@ -33,21 +33,21 @@ import { createOpencode } from "@opencode-ai/sdk" const { client } = await createOpencode() ``` -Spowoduje to uruchomienie zarówno serwera, jak i klienta +Spowoduje to uruchomienie zarówno serwera, jak i klienta. -#### Options +#### Opcje -| Opcja | Wpisz | Opis | Domyślne | +| Opcja | Typ | Opis | Domyślne | | ---------- | ------------- | ----------------------------------------- | ----------- | | `hostname` | `string` | Nazwa hosta serwera | `127.0.0.1` | | `port` | `number` | Port serwera | `4096` | | `signal` | `AbortSignal` | Sygnał przerwania w celu anulowania | `undefined` | | `timeout` | `number` | Limit czasu w ms dla uruchomienia serwera | `5000` | -| `config` | `Config` | Configuration object | `{}` | +| `config` | `Config` | Obiekt konfiguracji | `{}` | --- -## Config +## Konfiguracja Można przekazać obiekt konfiguracyjny, aby dostosować zachowanie. Instancja nadal pobiera `opencode.json`, ale możesz zastąpić lub dodać konfigurację bezpośrednio: @@ -67,9 +67,9 @@ console.log(`Server running at ${opencode.server.url}`) opencode.server.close() ``` -## Client only +## Tylko klient -Jeśli masz już działającą instancję opencode, możesz utworzyć instancję klienta, aby się z nią połączyć: +Jeśli masz już działającą instancję OpenCode, możesz utworzyć instancję klienta, aby się z nią połączyć: ```javascript import { createOpencodeClient } from "@opencode-ai/sdk" @@ -79,19 +79,19 @@ const client = createOpencodeClient({ }) ``` -#### Options +#### Opcje -| Opcja | Wpisz | Opis | Domyślne | -| --------------- | ---------- | -------------------------------- | ----------------------- | -| `baseUrl` | `string` | Adres URL serwera | `http://localhost:4096` | -| `fetch` | `function` | Custom fetch implementation | `globalThis.fetch` | -| `parseAs` | `string` | Response parsing method | `auto` | -| `responseStyle` | `string` | Return style: `data` or `fields` | `fields` | -| `throwOnError` | `boolean` | Throw errors instead of return | `false` | +| Opcja | Typ | Opis | Domyślne | +| --------------- | ---------- | ----------------------------------- | ----------------------- | +| `baseUrl` | `string` | Adres URL serwera | `http://localhost:4096` | +| `fetch` | `function` | Niestandardowa implementacja fetch | `globalThis.fetch` | +| `parseAs` | `string` | Metoda parsowania odpowiedzi | `auto` | +| `responseStyle` | `string` | Styl zwracania: `data` lub `fields` | `fields` | +| `throwOnError` | `boolean` | Rzucaj błędy zamiast zwracać je | `false` | --- -## Types +## Typy Zestaw SDK zawiera definicje TypeScript dla wszystkich typów API. Zaimportuj je bezpośrednio: @@ -103,7 +103,7 @@ Wszystkie typy są generowane na podstawie specyfikacji OpenAPI serwera i dostę --- -## Errors +## Błędy SDK może generować błędy, które można przechwycić i obsłużyć: @@ -117,21 +117,21 @@ try { --- -## APIs +## API Zestaw SDK udostępnia wszystkie interfejsy API serwera za pośrednictwem klienta bezpiecznego typu. --- -### Global +### Globalne -| Method | Description | Response | +| Metoda | Opis | Odpowiedź | | ----------------- | ----------------------------- | ------------------------------------ | | `global.health()` | Sprawdź stan i wersję serwera | `{ healthy: true, version: string }` | --- -#### Examples +#### Przykłady ```javascript const health = await client.global.health() @@ -140,16 +140,16 @@ console.log(health.data.version) --- -### App +### Aplikacja -| Method | Description | Response | +| Metoda | Opis | Odpowiedź | | -------------- | ----------------------------------- | ------------------------------------------- | -| `app.log()` | Write a log entry | `boolean` | +| `app.log()` | Zapisz wpis logu | `boolean` | | `app.agents()` | Lista wszystkich dostępnych agentów | Agent[] | --- -#### Examples +#### Przykłady ```javascript // Write a log entry @@ -167,16 +167,16 @@ const agents = await client.app.agents() --- -### Project +### Projekt -| Method | Description | Response | +| Metoda | Opis | Odpowiedź | | ------------------- | -------------------------- | --------------------------------------------- | | `project.list()` | Lista wszystkich projektów | Project[] | -| `project.current()` | Get current project | Project | +| `project.current()` | Pobierz bieżący projekt | Project | --- -#### Examples +#### Przykłady ```javascript // List all projects @@ -188,15 +188,15 @@ const currentProject = await client.project.current() --- -### Path +### Ścieżka -| Method | Description | Response | -| ------------ | ---------------- | ---------------------------------------- | -| `path.get()` | Get current path | Path | +| Metoda | Opis | Odpowiedź | +| ------------ | ----------------------- | ---------------------------------------- | +| `path.get()` | Pobierz bieżącą ścieżkę | Path | --- -#### Examples +#### Przykłady ```javascript // Get current path information @@ -205,16 +205,16 @@ const pathInfo = await client.path.get() --- -### Config +### Konfiguracja -| Method | Description | Response | +| Metoda | Opis | Odpowiedź | | -------------------- | ----------------------------------- | ----------------------------------------------------------------------------------------------------- | -| `config.get()` | Get config info | Config | +| `config.get()` | Pobierz informacje o konfiguracji | Config | | `config.providers()` | Lista dostawców i modeli domyślnych | `{ providers: `Provider[]`, default: { [key: string]: string } }` | --- -#### Examples +#### Przykłady ```javascript const config = await client.config.get() @@ -224,12 +224,12 @@ const { providers, default: defaults } = await client.config.providers() --- -### Sessions +### Sesje -| Method | Description | Notes | +| Metoda | Opis | Uwagi | | ---------------------------------------------------------- | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | `session.list()` | Lista sesji | Zwraca Session[] | -| `session.get({ path })` | Uzyskaj sesję | Zwraca Session | +| `session.get({ path })` | Pobierz sesję | Zwraca Session | | `session.children({ path })` | Lista sesji podrzędnych | Zwraca Session[] | | `session.create({ body })` | Utwórz sesję | Zwraca Session | | `session.delete({ path })` | Usuń sesję | Zwraca `boolean` | @@ -238,19 +238,19 @@ const { providers, default: defaults } = await client.config.providers() | `session.abort({ path })` | Przerwij trwającą sesję | Zwraca `boolean` | | `session.share({ path })` | Udostępnij sesję | Zwraca Session | | `session.unshare({ path })` | Cofnij udostępnianie sesji | Zwraca Session | -| `session.summarize({ path, body })` | Podsumowanie sesji | Zwraca `boolean` | +| `session.summarize({ path, body })` | Podsumuj sesję | Zwraca `boolean` | | `session.messages({ path })` | Lista wiadomości w sesji | Zwraca `{ info: `Message`, parts: `Part[]`}[]` | -| `session.message({ path })` | Uzyskaj szczegóły wiadomości | Zwraca `{ info: `Message`, parts: `Part[]`}` | +| `session.message({ path })` | Pobierz szczegóły wiadomości | Zwraca `{ info: `Message`, parts: `Part[]`}` | | `session.prompt({ path, body })` | Wyślij wiadomość | `body.noReply: true` zwraca UserMessage (tylko kontekst). Domyślnie zwraca AssistantMessage z odpowiedzią AI | | `session.command({ path, body })` | Wyślij polecenie do sesji | Zwraca `{ info: `AssistantMessage`, parts: `Part[]`}` | | `session.shell({ path, body })` | Uruchom polecenie shell | Zwraca AssistantMessage | -| `session.revert({ path, body })` | Przywróć wiadomość | Zwraca Session | -| `session.unrevert({ path })` | Przywróć przywrócone wiadomości | Zwraca Session | -| `postSessionByIdPermissionsByPermissionId({ path, body })` | Respond to a permission request | Returns `boolean` | +| `session.revert({ path, body })` | Cofnij wiadomość (revert) | Zwraca Session | +| `session.unrevert({ path })` | Przywróć cofnięte wiadomości | Zwraca Session | +| `postSessionByIdPermissionsByPermissionId({ path, body })` | Odpowiedz na żądanie uprawnienia | Zwraca `boolean` | --- -#### Examples +#### Przykłady ```javascript // Create and manage sessions @@ -281,25 +281,25 @@ await client.session.prompt({ --- -### Files +### Pliki -| Method | Description | Response | +| Metoda | Opis | Odpowiedź | | ------------------------- | ------------------------------------ | ---------------------------------------------------------------------------------------------- | | `find.text({ query })` | Szukaj tekstu w plikach | Tablica obiektów dopasowania z `path`, `lines`, `line_number`, `absolute_offset`, `submatches` | | `find.files({ query })` | Znajdź pliki i katalogi według nazwy | `string[]` (ścieżki) | -| `find.symbols({ query })` | Find workspace symbols | Symbol[] | -| `file.read({ query })` | Read a file | `{ type: "raw" \| "patch", content: string }` | -| `file.status({ query? })` | Uzyskaj status śledzonych plików | File[] | +| `find.symbols({ query })` | Znajdź symbole w obszarze roboczym | Symbol[] | +| `file.read({ query })` | Odczytaj plik | `{ type: "raw" \| "patch", content: string }` | +| `file.status({ query? })` | Pobierz status śledzonych plików | File[] | -`find.files` supports a few optional query fields: +`find.files` obsługuje kilka opcjonalnych pól zapytania: -- `type`: `"file"` or `"directory"` +- `type`: `"file"` lub `"directory"` - `directory`: zastąp katalog główny projektu dla wyszukiwania -- `limit`: max results (1–200) +- `limit`: maks. wyników (1–200) --- -#### Examples +#### Przykłady ```javascript // Search and read files @@ -324,21 +324,21 @@ const content = await client.file.read({ ### TUI -| Method | Description | Response | +| Metoda | Opis | Odpowiedź | | ------------------------------ | --------------------------- | --------- | -| `tui.appendPrompt({ body })` | Dołącz tekst do zachęty | `boolean` | +| `tui.appendPrompt({ body })` | Dołącz tekst do promptu | `boolean` | | `tui.openHelp()` | Otwórz okno pomocy | `boolean` | | `tui.openSessions()` | Otwórz selektor sesji | `boolean` | | `tui.openThemes()` | Otwórz selektor motywów | `boolean` | | `tui.openModels()` | Otwórz selektor modelu | `boolean` | -| `tui.submitPrompt()` | Prześlij bieżący monit | `boolean` | -| `tui.clearPrompt()` | Wyczyść monit | `boolean` | +| `tui.submitPrompt()` | Prześlij bieżący prompt | `boolean` | +| `tui.clearPrompt()` | Wyczyść prompt | `boolean` | | `tui.executeCommand({ body })` | Wykonaj polecenie | `boolean` | -| `tui.showToast({ body })` | Pokaż powiadomienie tostowe | `boolean` | +| `tui.showToast({ body })` | Pokaż powiadomienie (toast) | `boolean` | --- -#### Examples +#### Przykłady ```javascript // Control TUI interface @@ -353,15 +353,15 @@ await client.tui.showToast({ --- -### Auth +### Uwierzytelnianie -| Method | Description | Response | -| ------------------- | ------------------------------ | --------- | -| `auth.set({ ... })` | Set authentication credentials | `boolean` | +| Metoda | Opis | Odpowiedź | +| ------------------- | ------------------------------------ | --------- | +| `auth.set({ ... })` | Ustaw poświadczenia uwierzytelniania | `boolean` | --- -#### Examples +#### Przykłady ```javascript await client.auth.set({ @@ -372,15 +372,15 @@ await client.auth.set({ --- -### Events +### Zdarzenia -| Method | Description | Response | -| ------------------- | --------------------------------------- | --------------------------------------- | -| `event.subscribe()` | Strumień zdarzeń wysłanych przez serwer | Strumień zdarzeń wysłanych przez serwer | +| Metoda | Opis | Odpowiedź | +| ------------------- | ---------------------------------------- | ---------------------------------------- | +| `event.subscribe()` | Strumień zdarzeń wysyłanych przez serwer | Strumień zdarzeń wysyłanych przez serwer | --- -#### Examples +#### Przykłady ```javascript // Listen to real-time events diff --git a/packages/web/src/content/docs/pl/server.mdx b/packages/web/src/content/docs/pl/server.mdx index 7c862bc0f..0efcf486f 100644 --- a/packages/web/src/content/docs/pl/server.mdx +++ b/packages/web/src/content/docs/pl/server.mdx @@ -44,7 +44,7 @@ OPENCODE_SERVER_PASSWORD=your-password opencode serve --- -### How it works +### Jak to działa Kiedy uruchomisz `opencode`, uruchomi się TUI i serwer. Gdzie jest TUI klient komunikujący się z serwerem. Serwer udostępnia specyfikację OpenAPI 3.1 @@ -61,7 +61,7 @@ opencode TUI działa, `opencode serve` uruchomi nowy serwer. --- -#### Połącz się z istniejącym serwerem +#### Połączenie z istniejącym serwerem Po uruchomieniu TUI losowo przypisuje port i nazwę hosta. Zamiast tego możesz przekazać `--hostname` i `--port` [flagi](/docs/cli). Następnie użyj tego, aby połączyć się z serwerem. @@ -69,7 +69,7 @@ Punktu końcowego [`/tui`](#TUI) można użyć do sterowania TUI przez serwer. M --- -## Spec +## Specyfikacja Serwer publikuje specyfikację OpenAPI 3.1, którą można obejrzeć pod adresem: @@ -81,13 +81,13 @@ Na przykład `http://localhost:4096/doc`. Użyj specyfikacji, aby wygenerować k --- -## APIs +## API Serwer opencode udostępnia następujące interfejsy API. --- -### Global +### Globalne | Method | Path | Description | Response | | ------ | ---------------- | ------------------------------ | ------------------------------------ | @@ -96,7 +96,7 @@ Serwer opencode udostępnia następujące interfejsy API. --- -### Project +### Projekt | Method | Path | Description | Response | | ------ | ------------------ | -------------------------- | --------------------------------------------- | @@ -105,7 +105,7 @@ Serwer opencode udostępnia następujące interfejsy API. --- -### Path & VCS +### Ścieżka i VCS | Method | Path | Description | Response | | ------ | ------- | --------------------------------------------- | ------------------------------------------- | @@ -114,7 +114,7 @@ Serwer opencode udostępnia następujące interfejsy API. --- -### Instance +### Instancja | Method | Path | Description | Response | | ------ | ------------------- | ---------------------- | --------- | @@ -122,7 +122,7 @@ Serwer opencode udostępnia następujące interfejsy API. --- -### Config +### Konfiguracja | Method | Path | Description | Response | | ------- | ------------------- | ----------------------------------- | ---------------------------------------------------------------------------------------- | @@ -143,7 +143,7 @@ Serwer opencode udostępnia następujące interfejsy API. --- -### Sessions +### Sesje | Method | Path | Description | Notes | | -------- | ---------------------------------------- | ------------------------------------------- | ---------------------------------------------------------------------------------- | @@ -168,7 +168,7 @@ Serwer opencode udostępnia następujące interfejsy API. --- -### Messages +### Wiadomości | Method | Path | Description | Notes | | ------ | --------------------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | @@ -181,7 +181,7 @@ Serwer opencode udostępnia następujące interfejsy API. --- -### Komendy +### Polecenia | Metoda | Ścieżka | Opis | Odpowiedź | | ------ | ---------- | ------------------------ | --------------------------------------------- | @@ -210,7 +210,7 @@ Serwer opencode udostępnia następujące interfejsy API. --- -### Tools (Experimental) +### Narzędzia (Eksperymentalne) | Method | Path | Description | Response | | ------ | ------------------------------------------- | -------------------------------------------- | -------------------------------------------- | @@ -219,7 +219,7 @@ Serwer opencode udostępnia następujące interfejsy API. --- -### LSP, Formatters & MCP +### LSP, Formatery i MCP | Method | Path | Description | Response | | ------ | ------------ | ---------------------------- | -------------------------------------------------------- | @@ -230,7 +230,7 @@ Serwer opencode udostępnia następujące interfejsy API. --- -### Agents +### Agenci | Method | Path | Description | Response | | ------ | -------- | ----------------------------------- | ------------------------------------------- | @@ -238,7 +238,7 @@ Serwer opencode udostępnia następujące interfejsy API. --- -### Logging +### Logowanie | Method | Path | Description | Response | | ------ | ------ | ------------------------------------------------------------ | --------- | @@ -264,7 +264,7 @@ Serwer opencode udostępnia następujące interfejsy API. --- -### Auth +### Uwierzytelnianie | Method | Path | Description | Response | | ------ | ----------- | --------------------------------------------------------------------- | --------- | @@ -272,7 +272,7 @@ Serwer opencode udostępnia następujące interfejsy API. --- -### Events +### Zdarzenia | Method | Path | Description | Response | | ------ | -------- | -------------------------------------------------------------------------------------------------------------------- | --------------------------------------- | @@ -280,7 +280,7 @@ Serwer opencode udostępnia następujące interfejsy API. --- -### Docs +### Dokumentacja | Method | Path | Description | Response | | ------ | ------ | ------------------------ | ----------------------------------- | diff --git a/packages/web/src/content/docs/pl/share.mdx b/packages/web/src/content/docs/pl/share.mdx index d3165c6d2..463019295 100644 --- a/packages/web/src/content/docs/pl/share.mdx +++ b/packages/web/src/content/docs/pl/share.mdx @@ -1,5 +1,5 @@ --- -title: Share +title: Udostępnianie description: Udostępnij swoje rozmowy dotyczące opencode. --- @@ -11,7 +11,7 @@ Udostępnione konwersacje są publicznie dostępne dla każdej osoby mającej li --- -## How it works +## Jak to działa Kiedy udostępniasz rozmowę, opencode: @@ -21,13 +21,13 @@ Kiedy udostępniasz rozmowę, opencode: --- -## Sharing +## Udostępnianie opencode obsługuje trzy tryby udostępniania, które kontrolują sposób udostępniania rozmów: --- -### Ręczny (domyślny) +### Ręczne (domyślne) Domyślnie opencode korzysta z ręcznego trybu udostępniania. Sesje nie są udostępniane automatycznie, ale możesz je udostępnić ręcznie za pomocą polecenia `/share`: @@ -48,7 +48,7 @@ Aby jawnie ustawić tryb ręczny w [pliku konfiguracyjnym] (./config): --- -### Auto-share +### Automatyczne udostępnianie Możesz włączyć automatyczne udostępnianie dla wszystkich nowych rozmów, ustawiając opcję `share` na `"auto"` w [pliku konfiguracyjnym] (./config): @@ -63,7 +63,7 @@ Po włączeniu automatycznego udostępniania każda nowa rozmowa będzie automat --- -### Disabled +### Wyłączone Możesz całkowicie wyłączyć udostępnianie, ustawiając opcję `share` na `"disabled"` w [pliku konfiguracyjnym] (./config): @@ -78,7 +78,7 @@ Aby wymusić to w całym zespole dla danego projektu, dodaj go do `opencode.json --- -## Un-sharing +## Cofnięcie udostępnienia Aby zatrzymać udostępnianie rozmowy i usunąć ją z dostępu publicznego: @@ -90,28 +90,28 @@ Spowoduje to usunięcie łącza udostępniania i danych związanych z rozmową. --- -## Privacy +## Prywatność -There are a few things to keep in mind when sharing a conversation. +Podczas udostępniania rozmowy należy pamiętać o kilku rzeczach. --- -### Data retention +### Przechowywanie danych Udostępnione rozmowy pozostają dostępne, dopóki wyraźnie ich nie udostępnisz. Ten includes: -- Full conversation history +- Pełna historia rozmów - Wszystkie wiadomości i odpowiedzi - Metadane sesji --- -### Recommendations +### Zalecenia - Udostępniaj tylko rozmowy, które nie zawierają poufnych informacji. -- Review conversation content before sharing. -- Unshare conversations when collaboration is complete. +- Przejrzyj treść rozmowy przed udostępnieniem. +- Cofnij udostępnianie rozmów po zakończeniu współpracy. - Unikaj udostępniania rozmów zawierających zastrzeżony kod lub poufne dane. - W przypadku wrażliwych projektów całkowicie wyłącz udostępnianie. diff --git a/packages/web/src/content/docs/pl/skills.mdx b/packages/web/src/content/docs/pl/skills.mdx index 30d1541cb..9262d87e6 100644 --- a/packages/web/src/content/docs/pl/skills.mdx +++ b/packages/web/src/content/docs/pl/skills.mdx @@ -1,6 +1,6 @@ --- -title: "Agent Skills" -description: "Define reusable behavior via SKILL.md definitions" +title: "Umiejętności Agenta" +description: "Definiuj powtarzalne zachowania za pomocą definicji SKILL.md" --- Umiejętności agenta pozwalają opencode odkryć instrukcje wielokrotnego użytku z repozytorium lub katalogu domowego. @@ -8,10 +8,10 @@ Umiejętności są ładowane na żądanie za pośrednictwem natywnego narzędzia --- -## Place files +## Lokalizacja plików Utwórz jeden folder na nazwę umiejętności i umieść w nim `SKILL.md`. -opencode searches these locations: +opencode przeszukuje te lokalizacje: - Project config: `.opencode/skills//SKILL.md` - Global config: `~/.config/opencode/skills//SKILL.md` @@ -22,7 +22,7 @@ opencode searches these locations: --- -## Understand discovery +## Zrozumienie wykrywania W przypadku ścieżek lokalnych projektu opencode przechodzi od bieżącego katalogu roboczego, aż dotrze do drzewa roboczego git. Ładuje po drodze dowolne pasujące `skills/*/SKILL.md` w `.opencode/` i dowolne pasujące `.claude/skills/*/SKILL.md` lub `.agents/skills/*/SKILL.md`. @@ -31,32 +31,32 @@ W przypadku ścieżek lokalnych projektu opencode przechodzi od bieżącego kata --- -## Write frontmatter +## Tworzenie frontmatter Każdy `SKILL.md` musi zaczynać się od treści YAML. -Only these fields are recognized: +Rozpoznawane są tylko te pola: -- `name` (required) -- `description` (required) -- `license` (optional) -- `compatibility` (optional) -- `metadata` (optional, string-to-string map) +- `name` (wymagane) +- `description` (wymagane) +- `license` (opcjonalnie) +- `compatibility` (opcjonalnie) +- `metadata` (opcjonalnie, mapa string-to-string) -Unknown frontmatter fields are ignored. +Nieznane pola frontmatter są ignorowane. --- -## Validate names +## Walidacja nazw -`name` must: +`name` musi: -- Be 1–64 characters +- Mieć od 1 do 64 znaków - Należy używać małych liter alfanumerycznych i oddzielać je pojedynczym łącznikiem - Nie zaczyna się ani nie kończy na `-` -- Not contain consecutive `--` +- Nie może zawierać następujących po sobie `--` - Dopasuj nazwę katalogu zawierającą `SKILL.md` -Equivalent regex: +Odpowiednik wyrażenia regularnego: ```text ^[a-z0-9]+(-[a-z0-9]+)*$ @@ -64,14 +64,14 @@ Equivalent regex: --- -## Follow length rules +## Zasady dotyczące długości -`description` must be 1-1024 characters. +`description` musi mieć od 1 do 1024 znaków. Zadbaj o to, aby agent mógł dokonać prawidłowego wyboru. --- -## Skorzystaj z przykładu +## Przykład użycia Utwórz `.opencode/skills/git-release/SKILL.md` w ten sposób: @@ -100,7 +100,7 @@ Ask clarifying questions if the target versioning scheme is unclear. --- -## Recognize tool description +## Opis narzędzia opencode wymienia dostępne umiejętności w opisie narzędzia `skill`. Każdy wpis zawiera nazwę i opis umiejętności: @@ -122,9 +122,9 @@ skill({ name: "git-release" }) --- -## Skonfiguruj uprawnienia +## Konfiguracja uprawnień -Control which skills agents can access using pattern-based permissions in `opencode.json`: +Kontroluj, do których umiejętności agenci mogą uzyskać dostęp, używając uprawnień opartych na wzorcach w `opencode.json`: ```json { @@ -149,7 +149,7 @@ Wzorce obsługują symbole wieloznaczne: `internal-*` odpowiada `internal-docs`, --- -## Override per agent +## Nadpisywanie dla agenta Nadaj konkretnym agentom inne uprawnienia niż globalne ustawienia domyślne. @@ -181,11 +181,11 @@ permission: --- -## Wyłącz narzędzie umiejętności +## Wyłączanie narzędzia umiejętności Całkowicie wyłącz umiejętności agentów, którzy nie powinni ich używać: -**Dla agentów celnych**: +**Dla agentów niestandardowych** (w temacie agentów): ```yaml --- @@ -212,11 +212,11 @@ Jeśli opcja jest wyłączona, sekcja `` jest całkowicie pomi --- -## Troubleshoot loading +## Rozwiązywanie problemów z ładowaniem Jeśli umiejętność nie pojawi się: -1. Verify `SKILL.md` is spelled in all caps +1. Sprawdź, czy `SKILL.md` jest napisane wielkimi literami 2. Sprawdź, czy frontmatter zawiera `name` i `description` -3. Ensure skill names are unique across all locations +3. Upewnij się, że nazwy umiejętności są unikalne we wszystkich lokalizacjach 4. Sprawdź uprawnienia — umiejętności z `deny` są ukryte przed agentami diff --git a/packages/web/src/content/docs/pl/themes.mdx b/packages/web/src/content/docs/pl/themes.mdx index 46e1620c7..d4272e2c9 100644 --- a/packages/web/src/content/docs/pl/themes.mdx +++ b/packages/web/src/content/docs/pl/themes.mdx @@ -9,7 +9,7 @@ Domyślnie opencode używa naszego własnego motywu `opencode`. --- -## Terminal requirements +## Wymagania terminala Aby motywy wyświetlały się poprawnie z pełną paletą kolorów, Twój terminal musi obsługiwać **truecolor** (kolor 24-bitowy). Większość nowoczesnych terminali domyślnie obsługuje tę opcję, ale może być konieczne jej włączenie: @@ -43,7 +43,7 @@ Co więcej, stale dodajemy nowe motywy. --- -## System theme +## Motyw systemowy Motyw `system` został zaprojektowany tak, aby automatycznie dostosowywał się do schematu kolorów terminala. W przeciwieństwie do tradycyjnych motywów, które używają stałych kolorów, motyw _system_: @@ -59,7 +59,7 @@ Motyw systemu przeznaczony jest dla użytkowników, którzy: --- -## Using a theme +## Używanie motywu Możesz wybrać motyw, wywołując opcję wyboru motywu za pomocą polecenia `/theme`. Możesz też określić to w [config](/docs/config). @@ -72,26 +72,26 @@ Możesz wybrać motyw, wywołując opcję wyboru motywu za pomocą polecenia `/t --- -## Custom themes +## Motywy niestandardowe opencode obsługuje elastyczny system motywów oparty na JSON, który pozwala użytkownikom łatwo tworzyć i dostosowywać motywy. --- -### Hierarchy +### Hierarchia Motywy są ładowane z wielu katalogów w następującej kolejności, przy czym późniejsze katalogi zastępują wcześniejsze: 1. **Wbudowane motywy** – są osadzone w formacie binarnym -2. **User config directory** - Defined in `~/.config/opencode/themes/*.json` or `$XDG_CONFIG_HOME/opencode/themes/*.json` +2. **Katalog konfiguracji użytkownika** - Zdefiniowany w `~/.config/opencode/themes/*.json` lub `$XDG_CONFIG_HOME/opencode/themes/*.json` 3. **Katalog główny projektu** - Zdefiniowany w `/.opencode/themes/*.json` -4. **Current working directory** - Defined in `./.opencode/themes/*.json` +4. **Bieżący katalog roboczy** - Zdefiniowany w `./.opencode/themes/*.json` Jeśli wiele katalogów zawiera motyw o tej samej nazwie, zostanie użyty motyw z katalogu o wyższym priorytecie. --- -### Creating a theme +### Tworzenie motywu Aby utworzyć niestandardowy motyw, utwórz plik JSON w jednym z katalogów motywów. @@ -111,25 +111,25 @@ vim .opencode/themes/my-theme.json --- -### JSON format +### Format JSON Motywy korzystają z elastycznego formatu JSON z obsługą: -- **Hex colors**: `"#ffffff"` -- **ANSI colors**: `3` (0-255) -- **Color references**: `"primary"` or custom definitions -- **Dark/light variants**: `{"dark": "#000", "light": "#fff"}` -- **Brak koloru**: `"none"` - Używa domyślnego koloru terminala lub przezroczystości +- **Kolorów Hex**: `"#ffffff"` +- **Kolorów ANSI**: `3` (0-255) +- **Referencji kolorów**: `"primary"` lub definicje niestandardowe +- **Wariantów Ciemny/Jasny**: `{"dark": "#000", "light": "#fff"}` +- **Braku koloru**: `"none"` - Używa domyślnego koloru terminala lub przezroczystości --- -### Color definitions +### Definicje kolorów Sekcja `defs` jest opcjonalna i pozwala zdefiniować kolory wielokrotnego użytku, do których można się odwoływać w motywie. --- -### Terminal defaults +### Domyślne ustawienia terminala Wartość specjalna `"none"` może zostać użyta dla dowolnego koloru, aby przejąć domyślny kolor terminala. Jest to szczególnie przydatne do tworzenia motywów, które płynnie komponują się ze schematem kolorów terminala: @@ -140,7 +140,7 @@ Wartość specjalna `"none"` może zostać użyta dla dowolnego koloru, aby prze ### Przykład -Here's an example of a custom theme: +Oto przykład niestandardowego motywu: ```json title="my-theme.json" { diff --git a/packages/web/src/content/docs/pl/tools.mdx b/packages/web/src/content/docs/pl/tools.mdx index 501c3ae64..3e5fd1540 100644 --- a/packages/web/src/content/docs/pl/tools.mdx +++ b/packages/web/src/content/docs/pl/tools.mdx @@ -1,17 +1,17 @@ --- -title: Tools +title: Narzędzia description: Zarządzaj narzędziami, z których może korzystać LLM. --- -Narzędzia umożliwiają LLM wykonywanie działań w bazie kodu. opencode ma zestaw wbudowanych narzędzi, ale możesz go rozszerzyć o [narzędzia niestandardowe](/docs/custom-tools) lub [serwery MCP](/docs/mcp-servers). +Narzędzia umożliwiają LLM wykonywanie działań w bazie kodu. OpenCode posiada zestaw wbudowanych narzędzi, ale możesz go rozszerzyć o [narzędzia niestandardowe](/docs/custom-tools) lub [serwery MCP](/docs/mcp-servers). -Domyślnie wszystkie narzędzia są **włączone** i nie wymagają pozwolenia na uruchomienie. Możesz kontrolować zachowanie narzędzia poprzez [uprawnienia](/docs/permissions). +Domyślnie wszystkie narzędzia są **włączone** i nie wymagają zatwierdzenia przed uruchomieniem. Możesz kontrolować zachowanie narzędzi poprzez [uprawnienia](/docs/permissions). --- -## Skonfiguruj +## Konfiguracja -Użyj pola `permission` do kontrolowania zachowania narzędzia. Dla każdego narzędzia możesz zezwolić, odmówić lub wymagać zatwierdzenia. +Użyj pola `permission` do kontrolowania zachowania narzędzia. Dla każdego narzędzia możesz zezwolić (`allow`), odmówić (`deny`) lub wymagać zatwierdzenia (`ask`). ```json title="opencode.json" { @@ -24,7 +24,7 @@ Użyj pola `permission` do kontrolowania zachowania narzędzia. Dla każdego nar } ``` -Możesz także używać symboli wieloznacznych do kontrolowania wielu narzędzi jednocześnie. Na przykład, aby wymagać zatwierdzenia wszystkich narzędzi z serwera MCP: +Możesz także używać symboli wieloznacznych do kontrolowania wielu narzędzi jednocześnie. Na przykład, aby wymagać zatwierdzenia dla wszystkich narzędzi z serwera MCP: ```json title="opencode.json" { @@ -39,15 +39,15 @@ Możesz także używać symboli wieloznacznych do kontrolowania wielu narzędzi --- -## Wbudowane +## Wbudowane narzędzia -Oto wszystkie wbudowane narzędzia dostępne w opencode. +Oto wszystkie wbudowane narzędzia dostępne w OpenCode. --- ### bash -Wykonuj polecenia shell w środowisku projektu. +Wykonuj polecenia powłoki (shell) w środowisku projektu. ```json title="opencode.json" {4} { @@ -58,13 +58,13 @@ Wykonuj polecenia shell w środowisku projektu. } ``` -To narzędzie umożliwia LLM uruchamianie poleceń terminalowych, takich jak `npm install`, `git status` lub dowolne inne polecenie shell. +To narzędzie umożliwia LLM uruchamianie poleceń terminalowych, takich jak `npm install`, `git status` lub dowolne inne polecenie powłoki. --- ### edit -Modyfikuj istniejące pliki przez dokładne podmiany tekstu. +Modyfikuj istniejące pliki poprzez precyzyjne zastępowanie tekstu. ```json title="opencode.json" {4} { @@ -81,7 +81,7 @@ To narzędzie umożliwia precyzyjną edycję plików poprzez zastąpienie dokła ### write -Utwórz nowe pliki lub nadpisz istniejące. +Twórz nowe pliki lub nadpisuj istniejące. ```json title="opencode.json" {4} { @@ -102,7 +102,7 @@ Narzędzie `write` jest kontrolowane przez uprawnienie `edit`, które obejmuje w ### read -Przeczytaj zawartość pliku z bazy kodu. +Odczytaj zawartość pliku z bazy kodu. ```json title="opencode.json" {4} { @@ -147,11 +147,11 @@ Znajduj pliki na podstawie wzorców. } ``` -Szukaj plików przy użyciu wzorców globalnych, takich jak `**/*.js` lub `src/**/*.ts`. Zwraca pasujące ścieżki plików posortowane według czasu modyfikacji. +Szukaj plików przy użyciu wzorców glob, takich jak `**/*.js` lub `src/**/*.ts`. Zwraca pasujące ścieżki plików posortowane według czasu modyfikacji. --- -### lista +### list Wyświetla listę plików i katalogów w podanej ścieżce. @@ -164,13 +164,13 @@ Wyświetla listę plików i katalogów w podanej ścieżce. } ``` -To narzędzie wyświetla zawartość katalogu. Akceptuje wzorce globalne do filtrowania wyników. +To narzędzie wyświetla zawartość katalogu. Akceptuje wzorce glob do filtrowania wyników. --- -### LSP (experimental) +### LSP (eksperymentalne) -Wejdź w interakcję ze skonfigurowanymi serwerami LSP, aby uzyskać funkcje analizy kodu, takie jak definicje, odniesienia, informacje o najechaniu myszką i hierarchia połączeń. +Interakcja ze skonfigurowanymi serwerami LSP w celu uzyskania funkcji analizy kodu, takich jak definicje, referencje, podpowiedzi (hover) i hierarchia wywołań. :::note To narzędzie jest dostępne tylko wtedy, gdy `OPENCODE_EXPERIMENTAL_LSP_TOOL=true` (lub `OPENCODE_EXPERIMENTAL=true`). @@ -193,7 +193,7 @@ Aby skonfigurować, które serwery LSP są dostępne dla Twojego projektu, zobac ### patch -Stosuj patche do plików. +Stosuj łatki (patches) do plików. ```json title="opencode.json" {4} { @@ -204,7 +204,7 @@ Stosuj patche do plików. } ``` -To narzędzie stosuje pliki poprawek do bazy kodu. Przydatne do stosowania różnic i poprawek z różnych źródeł. +To narzędzie stosuje pliki różnicowe (diffs) do bazy kodu. Przydatne do stosowania zmian z różnych źródeł. :::note Narzędzie `patch` jest kontrolowane przez uprawnienie `edit`, które obejmuje wszystkie modyfikacje plików (`edit`, `write`, `patch`, `multiedit`). @@ -229,7 +229,7 @@ Załaduj [umiejętność](/docs/skills) (plik `SKILL.md`) i zwróć jej treść ### todowrite -Zarządzaj listami rzeczy do zrobienia podczas sesji kodowania. +Zarządzaj listami zadań (todo) podczas sesji kodowania. ```json title="opencode.json" {4} { @@ -243,14 +243,14 @@ Zarządzaj listami rzeczy do zrobienia podczas sesji kodowania. Tworzy i aktualizuje listy zadań w celu śledzenia postępu podczas złożonych operacji. LLM wykorzystuje to do organizowania zadań wieloetapowych. :::note -To narzędzie jest domyślnie wyłączone dla podagentów, ale można je włączyć ręcznie. [Dowiedz się więcej](/docs/agents/#permissions) +To narzędzie jest domyślnie wyłączone dla subagentów, ale można je włączyć ręcznie. [Dowiedz się więcej](/docs/agents/#permissions) ::: --- ### todoread -Odczytuj istniejące listy todo. +Odczytuj istniejące listy zadań (todo). ```json title="opencode.json" {4} { @@ -264,14 +264,14 @@ Odczytuj istniejące listy todo. Odczytuje bieżący stan listy rzeczy do zrobienia. Używany przez LLM do śledzenia zadań oczekujących lub ukończonych. :::note -To narzędzie jest domyślnie wyłączone dla podagentów, ale można je włączyć ręcznie. [Dowiedz się więcej](/docs/agents/#permissions) +To narzędzie jest domyślnie wyłączone dla subagentów, ale można je włączyć ręcznie. [Dowiedz się więcej](/docs/agents/#permissions) ::: --- ### webfetch -Pobieraj treści z web. +Pobieraj treści z sieci. ```json title="opencode.json" {4} { @@ -282,7 +282,7 @@ Pobieraj treści z web. } ``` -Umożliwia LLM pobieranie i odczytywanie stron internetowych. Przydatne do wyszukiwania dokumentacji lub wyszukiwania zasobów online. +Umożliwia LLM pobieranie i odczytywanie stron internetowych. Przydatne do wyszukiwania dokumentacji lub zasobów online. --- @@ -291,9 +291,9 @@ Umożliwia LLM pobieranie i odczytywanie stron internetowych. Przydatne do wyszu Wyszukaj informacje w Internecie. :::note -To narzędzie jest dostępne tylko w przypadku korzystania z dostawcy opencode lub gdy zmienna środowiskowa `OPENCODE_ENABLE_EXA` jest ustawiona na dowolną wartość prawdziwą (np. `true` lub `1`). +To narzędzie jest dostępne tylko w przypadku korzystania z dostawcy OpenCode lub gdy zmienna środowiskowa `OPENCODE_ENABLE_EXA` jest ustawiona na dowolną wartość prawdziwą (np. `true` lub `1`). -Aby włączyć przy uruchamianiu opencode: +Aby włączyć przy uruchamianiu OpenCode: ```bash OPENCODE_ENABLE_EXA=1 opencode @@ -310,12 +310,12 @@ OPENCODE_ENABLE_EXA=1 opencode } ``` -Przeszukuje Internet za pomocą Exa AI, aby znaleźć odpowiednie informacje w Internecie. Przydatne do badania tematów, znajdowania bieżących wydarzeń lub zbierania informacji wykraczających poza limit danych szkoleniowych. +Przeszukuje Internet za pomocą Exa AI, aby znaleźć odpowiednie informacje. Przydatne do badania tematów, znajdowania bieżących wydarzeń lub zbierania informacji wykraczających poza zbiór danych treningowych. Nie jest wymagany żaden klucz API — narzędzie łączy się bezpośrednio z usługą MCP hostowaną przez Exa AI bez uwierzytelniania. :::tip -Użyj `websearch`, gdy chcesz znaleźć informacje (odkrycie), i `webfetch`, gdy musisz pobrać treść z określonego adresu URL (pobieranie). +Użyj `websearch`, gdy chcesz znaleźć informacje (odkrywanie), i `webfetch`, gdy musisz pobrać treść z określonego adresu URL (pobieranie). ::: --- @@ -333,12 +333,12 @@ Zadawaj pytania użytkownikowi podczas wykonywania. } ``` -To narzędzie umożliwia LLM zadawanie pytań użytkownikowi podczas wykonywania zadania. Jest to przydatne dla: +To narzędzie umożliwia LLM zadawanie pytań użytkownikowi podczas wykonywania zadania. Jest to przydatne do: -- Zbieranie preferencji i wymagań użytkownika -- Doprecyzowanie niejednoznacznych instrukcji -- Uzyskiwanie decyzji dotyczących implementacji -- Proponowanie możliwych kierunków działania +- Zbierania preferencji i wymagań użytkownika +- Doprecyzowania niejednoznacznych instrukcji +- Podejmowania decyzji dotyczących implementacji +- Proponowania możliwych kierunków działania Każde pytanie zawiera nagłówek, tekst pytania i listę opcji. Użytkownicy mogą wybierać spośród dostępnych opcji lub wpisać niestandardową odpowiedź. Jeśli pytań jest wiele, użytkownicy mogą nawigować między nimi przed przesłaniem wszystkich odpowiedzi. @@ -360,13 +360,13 @@ Serwery MCP (Model Context Protocol) umożliwiają integrację zewnętrznych nar --- -## Wnętrze działania +## Szczegóły techniczne -Wewnętrznie narzędzia takie jak `grep`, `glob` i `list` używają pod maską [ripgrep](https://github.com/BurntSushi/ripgrep). Domyślnie ripgrep respektuje wzorce `.gitignore`, co oznacza, że ​​pliki i katalogi wymienione w Twoim `.gitignore` zostaną wykluczone z wyszukiwań i list. +Wewnętrznie narzędzia takie jak `grep`, `glob` i `list` używają [ripgrep](https://github.com/BurntSushi/ripgrep). Domyślnie ripgrep respektuje wzorce `.gitignore`, co oznacza, że pliki i katalogi wymienione w Twoim `.gitignore` zostaną wykluczone z wyszukiwań i list. --- -### Wzorce ignorowania +### Ignorowanie plików Aby uwzględnić pliki, które normalnie byłyby ignorowane, utwórz plik `.ignore` w katalogu głównym projektu. Ten plik może jawnie zezwalać na określone ścieżki. diff --git a/packages/web/src/content/docs/pl/troubleshooting.mdx b/packages/web/src/content/docs/pl/troubleshooting.mdx index 3cded1325..2230cea35 100644 --- a/packages/web/src/content/docs/pl/troubleshooting.mdx +++ b/packages/web/src/content/docs/pl/troubleshooting.mdx @@ -1,5 +1,5 @@ --- -title: Troubleshooting +title: Rozwiązywanie problemów description: Typowe problemy i sposoby ich rozwiązywania. --- @@ -7,9 +7,9 @@ Aby debugować problemy z opencode, zacznij od sprawdzenia dzienników i danych --- -## Logs +## Dzienniki -Log files are written to: +Pliki logów są zapisywane w: - **macOS/Linux**: `~/.local/share/opencode/log/` - **Windows**: Naciśnij `WIN+R` i wklej `%USERPROFILE%\.local\share\opencode\log` @@ -20,7 +20,7 @@ Możesz ustawić poziom dziennika za pomocą opcji wiersza poleceń `--log-level --- -## Storage +## Przechowywanie danych opencode przechowuje dane sesji i inne dane aplikacji na dysku pod adresem: @@ -37,11 +37,11 @@ Ten katalog zawiera: --- -## Desktop app +## Aplikacja desktopowa opencode Desktop uruchamia w tle lokalny serwer opencode (sidecar `opencode-cli`). Większość problemów jest spowodowana nieprawidłowo działającą wtyczką, uszkodzoną pamięcią podręczną lub złymi ustawieniami serwera. -### Quick checks +### Szybkie sprawdzenie - Całkowicie zakończ i uruchom ponownie aplikację. - Jeśli aplikacja wyświetli ekran błędu, kliknij **Uruchom ponownie** i skopiuj szczegóły błędu. @@ -49,7 +49,7 @@ opencode Desktop uruchamia w tle lokalny serwer opencode (sidecar `opencode-cli` --- -### Disable plugins +### Wyłączanie wtyczek Jeśli aplikacja komputerowa ulega awarii podczas uruchamiania, zawiesza się lub zachowuje się dziwnie, zacznij od wyłączenia wtyczek. @@ -57,8 +57,8 @@ Jeśli aplikacja komputerowa ulega awarii podczas uruchamiania, zawiesza się lu Otwórz globalny plik konfiguracyjny i poszukaj klucza `plugin`. -- **macOS/Linux**: `~/.config/opencode/opencode.jsonc` (or `~/.config/opencode/opencode.json`) -- **macOS/Linux** (older installs): `~/.local/share/opencode/opencode.jsonc` +- **macOS/Linux**: `~/.config/opencode/opencode.jsonc` (lub `~/.config/opencode/opencode.json`) +- **macOS/Linux** (starsze instalacje): `~/.local/share/opencode/opencode.jsonc` - **Windows**: Naciśnij `WIN+R` i wklej `%USERPROFILE%\.config\opencode\opencode.jsonc` Jeśli masz skonfigurowane wtyczki, tymczasowo je wyłącz, usuwając klucz lub ustawiając go na pustą tablicę: @@ -70,11 +70,11 @@ Jeśli masz skonfigurowane wtyczki, tymczasowo je wyłącz, usuwając klucz lub } ``` -#### Check plugin directories +#### Sprawdź katalogi wtyczek opencode może także ładować lokalne wtyczki z dysku. Tymczasowo usuń je (lub zmień nazwę folderu) i uruchom ponownie aplikację komputerową: -- **Global plugins** +- **Wtyczki globalne** - **macOS/Linux**: `~/.config/opencode/plugins/` - **Windows**: Naciśnij `WIN+R` i wklej `%USERPROFILE%\.config\opencode\plugins` - **Wtyczki projektowe** (tylko jeśli używasz konfiguracji dla poszczególnych projektów) @@ -88,14 +88,14 @@ Jeśli aplikacja ponownie zacznie działać, włączaj ponownie wtyczki pojedync Jeśli wyłączenie wtyczek nie pomoże (lub instalacja wtyczki utknęła), wyczyść pamięć podręczną, aby opencode mógł ją odbudować. -1. Quit opencode Desktop completely. +1. Całkowicie zamknij opencode Desktop. 2. Usuń katalog pamięci podręcznej: - **macOS**: Finder -> `Cmd+Shift+G` -> paste `~/.cache/opencode` - **Linux**: usuń `~/.cache/opencode` (lub uruchom `rm -rf ~/.cache/opencode`) - **Windows**: Naciśnij `WIN+R` i wklej `%USERPROFILE%\.cache\opencode` -3. Restart opencode Desktop. +3. Uruchom ponownie opencode Desktop. --- @@ -113,49 +113,49 @@ Na ekranie głównym kliknij nazwę serwera (z kropką stanu), aby otworzyć sel Jeśli Twój `opencode.json(c)` zawiera sekcję `server`, tymczasowo usuń ją i uruchom ponownie aplikację komputerową. -#### Check environment variables +#### Sprawdź zmienne środowiskowe Jeśli w swoim środowisku masz ustawiony `OPENCODE_PORT`, aplikacja komputerowa spróbuje użyć tego portu dla serwera lokalnego. -- Rozbierz `OPENCODE_PORT` (lub wybierz wolny port) i uruchom ponownie. +- usuń `OPENCODE_PORT` (lub wybierz wolny port) i uruchom ponownie. --- -### Linux: Wayland / X11 issues +### Linux: Problemy z Wayland / X11 -On Linux, some Wayland setups can cause blank windows or compositor errors. +W systemie Linux, niektóre konfiguracje Wayland mogą powodować puste okna lub błędy kompozytora. - Jeśli korzystasz z Wayland, a aplikacja jest pusta/ ulega awarii, spróbuj uruchomić ją za pomocą `OC_ALLOW_WAYLAND=1`. - Jeśli to pogorszy sprawę, usuń go i zamiast tego spróbuj uruchomić w sesji X11. --- -### Windows: WebView2 runtime +### Windows: Środowisko uruchomieniowe WebView2 W systemie Windows opencode Desktop wymaga Microsoft Edge **WebView2 Runtime**. Jeśli aplikacja otwiera się w pustym oknie lub nie uruchamia się, zainstaluj/zaktualizuj WebView2 i spróbuj ponownie. --- -### Windows: General performance issues +### Windows: Ogólne problemy z wydajnością Jeśli doświadczasz niskiej wydajności, problemów z dostępem do plików lub problemów z terminalem w systemie Windows, spróbuj użyć [WSL (podsystem Windows dla systemu Linux) (./windows-wsl). WSL zapewnia środowisko Linux, które płynniej współpracuje z funkcjami opencode. --- -### Notifications not showing +### Brak powiadomień -opencode Desktop only shows system notifications when: +opencode Desktop pokazuje powiadomienia systemowe tylko wtedy, gdy: - powiadomienia są włączone dla opencode w ustawieniach systemu operacyjnego, oraz - okno aplikacji nie jest aktywne. --- -### Reset desktop app storage (last resort) +### Resetowanie pamięci aplikacji Jeśli aplikacja nie uruchamia się i nie możesz wyczyścić ustawień w interfejsie użytkownika, zresetuj zapisany stan aplikacji komputerowej. -1. Quit opencode Desktop. +1. Zamknij całkowicie opencode Desktop. 2. Znajdź i usuń te pliki (znajdują się w katalogu danych aplikacji opencode Desktop): - `opencode.settings.dat` (domyślny adres URL serwera na komputerze stacjonarnym) @@ -169,11 +169,11 @@ Aby szybko znaleźć katalog: --- -## Getting help +## Uzyskiwanie pomocy Jeśli masz problemy z opencode: -1. **Report issues on GitHub** +1. **Zgłoś problem na GitHub** Najlepszym sposobem zgłaszania błędów lub zgłaszania żądań funkcji jest skorzystanie z naszego repozytorium GitHub: @@ -181,7 +181,7 @@ Jeśli masz problemy z opencode: Przed utworzeniem nowego problemu przeszukaj istniejące i sprawdź, czy Twój problem nie został już zgłoszony. -2. **Join our Discord** +2. **Dołącz do naszego Discorda** Aby uzyskać pomoc w czasie rzeczywistym i dyskusję społeczności, dołącz do naszego serwera Discord: @@ -189,7 +189,7 @@ Jeśli masz problemy z opencode: --- -## Common issues +## Typowe problemy Oto kilka typowych problemów i sposobów ich rozwiązania. @@ -203,7 +203,7 @@ Oto kilka typowych problemów i sposobów ich rozwiązania. --- -### Authentication issues +### Problemy z uwierzytelnianiem 1. Spróbuj ponownie uwierzytelnić się za pomocą polecenia `/connect` w TUI 2. Sprawdź, czy klucze API są ważne @@ -215,13 +215,13 @@ Oto kilka typowych problemów i sposobów ich rozwiązania. 1. Sprawdź, czy dokonałeś uwierzytelnienia u dostawcy 2. Sprawdź, czy nazwa modelu w konfiguracji jest poprawna -3. Some models may require specific access or subscriptions +3. Niektóre modele mogą wymagać określonego dostępu lub subskrypcji -Jeśli napotkasz `ProviderModelNotFoundError`, najprawdopodobniej się mylisz -odwołując się gdzieś do modelu. -Models should be referenced like so: `/` +Jeśli napotkasz `ProviderModelNotFoundError`, najprawdopodobniej +błędnie odwołujesz się gdzieś do modelu. +Modele powinny być wskazywane w ten sposób: `/` -Examples: +Przykłady: - `openai/gpt-4.1` - `openrouter/google/gemini-2.5-flash` @@ -250,7 +250,7 @@ Aby rozwiązać ten problem: --- -### Problemy z AI_APICallError i pakietem dostawcy +### Błędy AI_APICallError i problemy z pakietami dostawców Jeśli napotkasz błędy wywołań API, może to wynikać z nieaktualnych pakietów dostawców. opencode dynamicznie instaluje pakiety dostawców (OpenAI, Anthropic, Google itp.) w razie potrzeby i przechowuje je lokalnie w pamięci podręcznej. @@ -270,7 +270,7 @@ Zmusi to opencode do pobrania najnowszych wersji pakietów dostawców, co częst --- -### Copy/paste not working on Linux +### Kopiowanie/wklejanie nie działa na Linuxie Aby funkcja kopiowania/wklejania działała, użytkownicy systemu Linux muszą mieć zainstalowane jedno z następujących narzędzi schowka: diff --git a/packages/web/src/content/docs/pl/tui.mdx b/packages/web/src/content/docs/pl/tui.mdx index 620865835..6d693eb9e 100644 --- a/packages/web/src/content/docs/pl/tui.mdx +++ b/packages/web/src/content/docs/pl/tui.mdx @@ -369,7 +369,7 @@ Możesz dostosować zachowanie TUI za pomocą pliku konfiguracyjnego opencode. } ``` -### Options +### Opcje - `scroll_acceleration` — Włącz przyspieszenie przewijania w stylu macOS, aby zapewnić płynne, naturalne przewijanie. Po włączeniu prędkość przewijania wzrasta wraz z szybkimi gestami przewijania i pozostaje precyzyjna w przypadku wolniejszych ruchów. **To ustawienie ma pierwszeństwo przed `scroll_speed` i zastępuje je, gdy jest włączone.** - `scroll_speed` - Kontroluje szybkość przewijania TUI podczas korzystania z poleceń przewijania (minimum: `1`). Wartość domyślna to `3`. **Uwaga: jest to ignorowane, jeśli `scroll_acceleration.enabled` jest ustawione na `true`.** diff --git a/packages/web/src/content/docs/pl/web.mdx b/packages/web/src/content/docs/pl/web.mdx index ddd345f3d..2a2ada1cf 100644 --- a/packages/web/src/content/docs/pl/web.mdx +++ b/packages/web/src/content/docs/pl/web.mdx @@ -7,7 +7,7 @@ opencode może działać jako aplikacja internetowa w przeglądarce, zapewniają ![Sieć opencode - Nowa sesja](../../../assets/web/web-homepage-new-session.png) -## Getting Started +## Pierwsze kroki Uruchom interfejs sieciowy, uruchamiając: @@ -27,7 +27,7 @@ Aby uzyskać najlepsze wyniki, uruchom `opencode web` z [WSL](/docs/windows-wsl) --- -## Configuration +## Konfiguracja Możesz skonfigurować serwer WWW za pomocą flag wiersza poleceń lub w [pliku konfiguracyjnym] (./config). @@ -39,7 +39,7 @@ Domyślnie opencode wybiera dostępny port. Możesz określić port: opencode web --port 4096 ``` -### Hostname +### Nazwa hosta Domyślnie serwer łączy się z `127.0.0.1` (tylko localhost). Aby udostępnić opencode w swojej sieci: @@ -54,7 +54,7 @@ Podczas korzystania z `0.0.0.0` opencode wyświetli zarówno adresy lokalne, jak Network access: http://192.168.1.100:4096 ``` -### mDNS Discovery +### Wykrywanie mDNS Włącz mDNS, aby Twój serwer był wykrywalny w sieci lokalnej: @@ -78,7 +78,7 @@ Aby zezwolić na dodatkowe domeny dla CORS (przydatne w przypadku niestandardowy opencode web --cors https://example.com ``` -### Authentication +### Uwierzytelnianie Aby chronić dostęp, ustaw hasło za pomocą zmiennej środowiskowej `OPENCODE_SERVER_PASSWORD`: @@ -94,7 +94,7 @@ Domyślna nazwa użytkownika to `opencode`, ale można ją zmienić za pomocą ` Po uruchomieniu interfejs sieciowy zapewnia dostęp do sesji opencode. -### Sessions +### Sesje Przeglądaj sesje i zarządzaj nimi ze strony głównej. Możesz zobaczyć aktywne sesje i rozpocząć nowe. @@ -108,7 +108,7 @@ Kliknij „Zobacz serwery”, aby wyświetlić podłączone serwery i ich status --- -## Attaching a Terminal +## Podłączanie terminala Możesz podłączyć terminal TUI do działającego serwera WWW: @@ -124,7 +124,7 @@ Umożliwia to jednoczesne korzystanie z interfejsu sieciowego i terminala, wspó --- -## Config File +## Plik konfiguracyjny Możesz także skonfigurować ustawienia serwera w pliku konfiguracyjnym `opencode.json`: diff --git a/packages/web/src/content/docs/pl/zen.mdx b/packages/web/src/content/docs/pl/zen.mdx index 1d86db663..6d5d8c0bd 100644 --- a/packages/web/src/content/docs/pl/zen.mdx +++ b/packages/web/src/content/docs/pl/zen.mdx @@ -19,11 +19,11 @@ opencode. --- -## Background +## Tło -There are a large number of models out there but only a few of -these models work well as coding agents. Additionally, most providers are -skonfigurowany bardzo różnie; więc otrzymujesz zupełnie inną wydajność i jakość. +Istnieje ogromna liczba modeli, ale tylko kilka z nich +działa dobrze jako agenci kodujący. Dodatkowo większość dostawców jest +skonfigurowana bardzo różnie; więc otrzymujesz zupełnie inną wydajność i jakość. :::tip Przetestowaliśmy wybraną grupę modeli i dostawców, którzy dobrze współpracują z opencode. @@ -45,7 +45,7 @@ OpenCode Zen to brama AI, która zapewnia dostęp do tych modeli. --- -## How it works +## Jak to działa OpenCode Zen działa jak każdy inny dostawca opencode. @@ -58,7 +58,7 @@ Opłata jest pobierana za każde żądanie i możesz dodać kredyty do swojego k --- -## Endpoints +## Punkty końcowe Dostęp do naszych modeli można również uzyskać za pośrednictwem następujących punktów końcowych API. @@ -100,7 +100,7 @@ użyj `opencode/gpt-5.2-codex` w swojej konfiguracji. --- -### Models +### Modele Pełną listę dostępnych modeli i ich metadane możesz pobrać z: @@ -110,7 +110,7 @@ https://opencode.ai/zen/v1/models --- -## Pricing +## Cennik Wspieramy model pay-as-you-go. Poniżej znajdują się ceny **za 1M tokenów**. @@ -167,7 +167,7 @@ Darmowe modele: --- -### Auto-reload +### Automatyczne doładowanie Jeśli Twoje saldo spadnie poniżej 5 USD, Zen automatycznie doładuje 20 USD. @@ -175,7 +175,7 @@ Możesz zmienić kwotę automatycznego doładowania. Możesz także całkowicie --- -### Monthly limits +### Limity miesięczne Możesz także ustawić miesięczny limit wykorzystania dla całego obszaru roboczego i dla każdego z nich członek Twojego zespołu. @@ -186,7 +186,7 @@ obciąży Cię kwotą wyższą niż 20 USD, jeśli saldo spadnie poniżej 5 USD. --- -## Privacy +## Prywatność Wszystkie nasze modele są hostowane w USA. Nasi dostawcy przestrzegają polityki zerowego przechowywania i nie wykorzystują Twoich danych do szkolenia modeli, z następującymi wyjątkami: @@ -213,7 +213,7 @@ wkrótce udostępnimy więcej szczegółów na temat cen. --- -### Roles +### Role Możesz zapraszać członków zespołu do swojego obszaru roboczego i przypisywać role: @@ -244,11 +244,11 @@ i chcesz go używać zamiast tego, który zapewnia Zen. --- -## Goals +## Cele -We created OpenCode Zen to: +Stworzyliśmy OpenCode Zen, aby: -1. **Benchmark** najlepsze modele/dostawcy dla agentów kodujących. +1. **Testować** (Benchmark) najlepsze modele/dostawców dla agentów kodujących. 2. Miej dostęp do opcji **najwyższej jakości**, a nie obniżaj wydajności ani nie kieruj się do tańszych dostawców. 3. Przekaż wszelkie **obniżki cen**, sprzedając po kosztach; więc jedyną marżą jest pokrycie naszych opłat manipulacyjnych. 4. Nie **nie blokuj**, umożliwiając używanie go z dowolnym innym agentem kodującym. I zawsze pozwalaj na korzystanie z opencode dowolnego innego dostawcy. diff --git a/packages/web/src/content/docs/pt-br/acp.mdx b/packages/web/src/content/docs/pt-br/acp.mdx index 9968a52a1..549f6cead 100644 --- a/packages/web/src/content/docs/pt-br/acp.mdx +++ b/packages/web/src/content/docs/pt-br/acp.mdx @@ -1,23 +1,23 @@ --- title: Suporte ACP -description: Use opencode em qualquer editor compatível com ACP. +description: Use o opencode em qualquer editor compatível com ACP. --- -opencode suporta o [Agent Client Protocol](https://agentclientprotocol.com) ou (ACP), permitindo que você o utilize diretamente em editores e IDEs compatíveis. +O opencode suporta o [Agent Client Protocol](https://agentclientprotocol.com) ou (ACP), permitindo que você o utilize diretamente em editores e IDEs compatíveis. :::tip Para uma lista de editores e ferramentas que suportam ACP, confira o [relatório de progresso do ACP](https://zed.dev/blog/acp-progress-report#available-now). ::: -ACP é um protocolo aberto que padroniza a comunicação entre editores de código e agentes de codificação de AI. +O ACP é um protocolo aberto que padroniza a comunicação entre editores de código e agentes de codificação de IA. --- -## Configurar +## Configuração Para usar opencode via ACP, configure seu editor para executar o comando `opencode acp`. -O comando inicia o opencode como um subprocesso compatível com ACP que se comunica com seu editor via JSON-RPC através do stdio. +Este comando inicia o opencode como um subprocesso compatível com ACP que se comunica com seu editor via JSON-RPC através do stdio. Abaixo estão exemplos para editores populares que suportam ACP. @@ -138,11 +138,11 @@ require("codecompanion").setup({ Esta configuração configura o CodeCompanion para usar opencode como o agente ACP para chat. -Se você precisar passar variáveis de ambiente (como `OPENCODE_API_KEY`), consulte [Configuring Adapters: Environment Variables](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) na documentação do CodeCompanion.nvim para detalhes completos. +Se você precisar passar variáveis de ambiente (como `OPENCODE_API_KEY`), consulte [Configurando Adaptadores: Variáveis de Ambiente](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) na documentação do CodeCompanion.nvim para detalhes completos. ## Suporte -opencode funciona da mesma forma via ACP como funciona no terminal. Todos os recursos são suportados: +O opencode funciona da mesma forma via ACP como funciona no terminal. Todos os recursos são suportados: :::note Alguns comandos de barra integrados, como `/undo` e `/redo`, atualmente não são suportados. diff --git a/packages/web/src/content/docs/pt-br/agents.mdx b/packages/web/src/content/docs/pt-br/agents.mdx index ddc034fad..9a831e804 100644 --- a/packages/web/src/content/docs/pt-br/agents.mdx +++ b/packages/web/src/content/docs/pt-br/agents.mdx @@ -3,10 +3,10 @@ title: Agentes description: Configure e use agentes especializados. --- -Agentes são assistentes de AI especializados que podem ser configurados para tarefas e fluxos de trabalho específicos. Eles permitem que você crie ferramentas focadas com prompts, modelos e acesso a ferramentas personalizados. +Agentes são assistentes de IA especializados que podem ser configurados para tarefas e fluxos de trabalho específicos. Eles permitem que você crie ferramentas focadas com prompts, modelos e acesso a ferramentas personalizados. :::tip -Use o agente de planejamento para analisar código e revisar sugestões sem fazer alterações no código. +Use o agente de planejamento (plan) para analisar código e revisar sugestões sem fazer alterações no código. ::: Você pode alternar entre agentes durante uma sessão ou invocá-los com a menção `@`. @@ -40,13 +40,13 @@ opencode vem com dois subagentes integrados, **General** e **Explore**. Vamos ve --- -## Integrado +## Integrados opencode vem com dois agentes primários integrados e dois subagentes integrados. --- -### Usar build +### build _Modo_: `primary` @@ -54,7 +54,7 @@ Build é o agente primário **padrão** com todas as ferramentas habilitadas. Es --- -### Usar plan +### plan _Modo_: `primary` @@ -68,7 +68,7 @@ Este agente é útil quando você deseja que o LLM analise código, sugira alter --- -### Usar general +### general _Modo_: `subagent` @@ -76,7 +76,7 @@ Um agente de propósito geral para pesquisar questões complexas e executar tare --- -### Usar explore +### explore _Modo_: `subagent` @@ -84,7 +84,7 @@ Um agente rápido e somente leitura para explorar bases de código. Não pode mo --- -### Usar compaction +### compaction _Modo_: `primary` @@ -92,7 +92,7 @@ Agente de sistema oculto que compacta longos contextos em um resumo menor. Ele --- -### Usar title +### title _Modo_: `primary` @@ -100,7 +100,7 @@ Agente de sistema oculto que gera títulos curtos para sessões. Ele é executad --- -### Usar summary +### summary _Modo_: `primary` @@ -128,7 +128,7 @@ Agente de sistema oculto que cria resumos de sessões. Ele é executado automati --- -## Configurar +## Configuração Você pode personalizar os agentes integrados ou criar os seus próprios através da configuração. Os agentes podem ser configurados de duas maneiras: @@ -162,10 +162,10 @@ Configure os agentes em seu arquivo de configuração `opencode.json`: } }, "code-reviewer": { - "description": "Reviews code for best practices and potential issues", + "description": "Revisa código para melhores práticas e potenciais problemas", "mode": "subagent", "model": "anthropic/claude-sonnet-4-20250514", - "prompt": "You are a code reviewer. Focus on security, performance, and maintainability.", + "prompt": "Você é um revisor de código. Foque em segurança, performance e manutenibilidade.", "tools": { "write": false, "edit": false @@ -186,7 +186,7 @@ Você também pode definir agentes usando arquivos markdown. Coloque-os em: ```markdown title="~/.config/opencode/agents/review.md" --- -description: Reviews code for quality and best practices +description: Revisa código para qualidade e melhores práticas mode: subagent model: anthropic/claude-sonnet-4-20250514 temperature: 0.1 @@ -196,14 +196,14 @@ tools: bash: false --- -You are in code review mode. Focus on: +Você está no modo de revisão de código. Foque em: -- Code quality and best practices -- Potential bugs and edge cases -- Performance implications -- Security considerations +- Qualidade do código e melhores práticas +- Bugs potenciais e casos de borda +- Implicações de desempenho +- Considerações de segurança -Provide constructive feedback without making direct changes. +Forneça feedback construtivo sem fazer alterações diretas. ``` O nome do arquivo markdown se torna o nome do agente. Por exemplo, `review.md` cria um agente `review`. @@ -224,7 +224,7 @@ Use a opção `description` para fornecer uma breve descrição do que o agente { "agent": { "review": { - "description": "Reviews code for best practices and potential issues" + "description": "Revisa código para melhores práticas e potenciais problemas" } } } @@ -291,8 +291,8 @@ Se isso não for definido, o agente continuará a iterar até que o modelo decid { "agent": { "quick-thinker": { - "description": "Fast reasoning with limited iterations", - "prompt": "You are a quick thinker. Solve problems with minimal steps.", + "description": "Raciocínio rápido com iterações limitadas", + "prompt": "Você é um pensador rápido. Resolva problemas com etapas mínimas.", "steps": 5 } } @@ -449,7 +449,7 @@ Você também pode definir permissões em agentes Markdown. ```markdown title="~/.config/opencode/agents/review.md" --- -description: Code review without edits +description: Revisão de código sem edições mode: subagent permission: edit: deny @@ -461,7 +461,7 @@ permission: webfetch: deny --- -Only analyze code and suggest changes. +Apenas analise o código e sugira alterações. ``` Você pode definir permissões para comandos bash específicos. @@ -645,7 +645,7 @@ Por exemplo, com os modelos de raciocínio da OpenAI, você pode controlar o esf { "agent": { "deep-thinker": { - "description": "Agent that uses high reasoning effort for complex problems", + "description": "Agente que usa alto esforço de raciocínio para problemas complexos", "model": "openai/gpt-5", "reasoningEffort": "high", "textVerbosity": "low" @@ -662,7 +662,7 @@ Execute `opencode models` para ver uma lista dos modelos disponíveis. --- -## Criar agentes +## Criando agentes Você pode criar novos agentes usando o seguinte comando: @@ -706,20 +706,20 @@ Você tem um agente que gostaria de compartilhar? [Envie um PR](https://github.c ```markdown title="~/.config/opencode/agents/docs-writer.md" --- -description: Writes and maintains project documentation +description: Escreve e mantém a documentação do projeto mode: subagent tools: bash: false --- -You are a technical writer. Create clear, comprehensive documentation. +Você é um escritor técnico. Crie documentação clara e abrangente. -Focus on: +Foque em: -- Clear explanations -- Proper structure -- Code examples -- User-friendly language +- Explicações claras +- Estrutura adequada +- Exemplos de código +- Linguagem amigável ao usuário ``` --- @@ -728,20 +728,20 @@ Focus on: ```markdown title="~/.config/opencode/agents/security-auditor.md" --- -description: Performs security audits and identifies vulnerabilities +description: Realiza auditorias de segurança e identifica vulnerabilidades mode: subagent tools: write: false edit: false --- -You are a security expert. Focus on identifying potential security issues. +Você é um especialista em segurança. Foque em identificar potenciais problemas de segurança. -Look for: +Procure por: -- Input validation vulnerabilities -- Authentication and authorization flaws -- Data exposure risks -- Dependency vulnerabilities -- Configuration security issues +- Vulnerabilidades de validação de entrada +- Falhas de autenticação e autorização +- Riscos de exposição de dados +- Vulnerabilidades de dependência +- Problemas de segurança de configuração ``` diff --git a/packages/web/src/content/docs/pt-br/cli.mdx b/packages/web/src/content/docs/pt-br/cli.mdx index 36557ef45..0edaaadea 100644 --- a/packages/web/src/content/docs/pt-br/cli.mdx +++ b/packages/web/src/content/docs/pt-br/cli.mdx @@ -27,7 +27,7 @@ Inicie a interface de usuário do terminal do opencode. opencode [project] ``` -#### Flags +#### Opções | Flag | Curto | Descrição | | ------------ | ----- | -------------------------------------------------------------------------- | @@ -69,14 +69,14 @@ opencode attach [url] Isso permite usar o TUI com um backend opencode remoto. Por exemplo: ```bash -# Start the backend server for web/mobile access +# Inicie o servidor backend para acesso web/mobile opencode web --port 4096 --hostname 0.0.0.0 -# In another terminal, attach the TUI to the running backend +# Em outro terminal, anexe o TUI ao backend em execução opencode attach http://10.20.30.40:4096 ``` -#### Flags +#### Opções | Flag | Curto | Descrição | | ----------- | ----- | ---------------------------------------- | @@ -185,7 +185,7 @@ Execute o agente do GitHub. Isso é tipicamente usado em GitHub Actions. opencode github run ``` -##### Flags +##### Opções | Flag | Descrição | | --------- | ------------------------------------------------ | @@ -294,7 +294,7 @@ Você pode opcionalmente passar um ID de provedor para filtrar modelos por esse opencode models anthropic ``` -#### Flags +#### Opções | Flag | Descrição | | ----------- | --------------------------------------------------------------------- | @@ -320,20 +320,20 @@ opencode run [message..] Isso é útil para scripts, automação ou quando você deseja uma resposta rápida sem iniciar o TUI completo. Por exemplo. ```bash "opencode run" -opencode run Explain the use of context in Go +opencode run Explique o uso de context em Go ``` Você também pode se anexar a uma instância em execução do `opencode serve` para evitar tempos de inicialização a frio do servidor MCP em cada execução: ```bash -# Start a headless server in one terminal +# Inicie um servidor sem cabeça em um terminal opencode serve -# In another terminal, run commands that attach to it -opencode run --attach http://localhost:4096 "Explain async/await in JavaScript" +# Em outro terminal, execute comandos que se anexam a ele +opencode run --attach http://localhost:4096 "Explique async/await em JavaScript" ``` -#### Flags +#### Opções | Flag | Curto | Descrição | | ------------ | ----- | ----------------------------------------------------------------------------- | @@ -362,7 +362,7 @@ opencode serve Isso inicia um servidor HTTP que fornece acesso à funcionalidade do opencode sem a interface TUI. Defina `OPENCODE_SERVER_PASSWORD` para habilitar a autenticação básica HTTP (o nome de usuário padrão é `opencode`). -#### Flags +#### Opções | Flag | Descrição | | ------------ | ----------------------------------------------------- | @@ -391,7 +391,7 @@ Liste todas as sessões do opencode. opencode session list ``` -##### Flags +##### Opções | Flag | Curto | Descrição | | ------------- | ----- | ----------------------------------------- | @@ -408,7 +408,7 @@ Mostre o uso de tokens e estatísticas de custo para suas sessões do opencode. opencode stats ``` -#### Flags +#### Opções | Flag | Descrição | | ----------- | ---------------------------------------------------------------------------------------------------- | @@ -458,7 +458,7 @@ opencode web Isso inicia um servidor HTTP e abre um navegador para acessar o opencode através de uma interface web. Defina `OPENCODE_SERVER_PASSWORD` para habilitar a autenticação básica HTTP (o nome de usuário padrão é `opencode`). -#### Flags +#### Opções | Flag | Descrição | | ------------ | ----------------------------------------------------- | @@ -479,7 +479,7 @@ opencode acp Este comando inicia um servidor ACP que se comunica via stdin/stdout usando nd-JSON. -#### Flags +#### Opções | Flag | Descrição | | ------------ | ------------------------- | @@ -497,7 +497,7 @@ Desinstale o opencode e remova todos os arquivos relacionados. opencode uninstall ``` -#### Flags +#### Opções | Flag | Curto | Descrição | | --------------- | ----- | ---------------------------------------- | @@ -528,7 +528,7 @@ Para atualizar para uma versão específica. opencode upgrade v0.1.48 ``` -#### Flags +#### Opções | Flag | Curto | Descrição | | ---------- | ----- | ---------------------------------------------------------------- | @@ -536,7 +536,7 @@ opencode upgrade v0.1.48 --- -## Flags Globais +## Opções Globais A CLI do opencode aceita as seguintes flags globais. diff --git a/packages/web/src/content/docs/pt-br/commands.mdx b/packages/web/src/content/docs/pt-br/commands.mdx index 89d9655cf..b4a8a306d 100644 --- a/packages/web/src/content/docs/pt-br/commands.mdx +++ b/packages/web/src/content/docs/pt-br/commands.mdx @@ -13,7 +13,7 @@ Comandos personalizados são adicionais aos comandos integrados como `/init`, `/ --- -## Criar arquivos de comando +## Criando arquivos de comando Crie arquivos markdown no diretório `commands/` para definir comandos personalizados. @@ -21,13 +21,13 @@ Crie `.opencode/commands/test.md`: ```md title=".opencode/commands/test.md" --- -description: Run tests with coverage +description: Execute testes com cobertura agent: build model: anthropic/claude-3-5-sonnet-20241022 --- -Run the full test suite with coverage report and show any failures. -Focus on the failing tests and suggest fixes. +Execute a suíte de testes completa com relatório de cobertura e mostre quaisquer falhas. +Concentre-se nos testes com falha e sugira correções. ``` O frontmatter define as propriedades do comando. O conteúdo se torna o template. @@ -40,7 +40,7 @@ Use o comando digitando `/` seguido pelo nome do comando. --- -## Configurar +## Configuração Você pode adicionar comandos personalizados através da configuração do opencode ou criando arquivos markdown no diretório `commands/`. @@ -54,12 +54,12 @@ Use a opção `command` na sua [configuração](/docs/config) do opencode: { "$schema": "https://opencode.ai/config.json", "command": { - // This becomes the name of the command + // Isso se torna o nome do comando "test": { - // This is the prompt that will be sent to the LLM - "template": "Run the full test suite with coverage report and show any failures.\nFocus on the failing tests and suggest fixes.", - // This is shown as the description in the TUI - "description": "Run tests with coverage", + // Este é o prompt que será enviado ao LLM + "template": "Execute a suíte de testes completa com relatório de cobertura e mostre quaisquer falhas.\nConcentre-se nos testes com falha e sugira correções.", + // Isso é exibido como a descrição no TUI + "description": "Execute testes com cobertura", "agent": "build", "model": "anthropic/claude-3-5-sonnet-20241022" } @@ -84,13 +84,13 @@ Você também pode definir comandos usando arquivos markdown. Coloque-os em: ```markdown title="~/.config/opencode/commands/test.md" --- -description: Run tests with coverage +description: Execute testes com cobertura agent: build model: anthropic/claude-3-5-sonnet-20241022 --- -Run the full test suite with coverage report and show any failures. -Focus on the failing tests and suggest fixes. +Execute a suíte de testes completa com relatório de cobertura e mostre quaisquer falhas. +Concentre-se nos testes com falha e sugira correções. ``` O nome do arquivo markdown se torna o nome do comando. Por exemplo, `test.md` permite que você execute: @@ -113,11 +113,11 @@ Passe argumentos para os comandos usando o espaço reservado `$ARGUMENTS`. ```md title=".opencode/commands/component.md" --- -description: Create a new component +description: Crie um novo componente --- -Create a new React component named $ARGUMENTS with TypeScript support. -Include proper typing and basic structure. +Crie um novo componente React chamado $ARGUMENTS com suporte a TypeScript. +Inclua tipagem adequada e estrutura básica. ``` Execute o comando com argumentos: @@ -139,11 +139,11 @@ Por exemplo: ```md title=".opencode/commands/create-file.md" --- -description: Create a new file with content +description: Crie um novo arquivo com conteúdo --- -Create a file named $1 in the directory $2 -with the following content: $3 +Crie um arquivo chamado $1 no diretório $2 +com o seguinte conteúdo: $3 ``` Execute o comando: @@ -168,26 +168,26 @@ Por exemplo, para criar um comando personalizado que analisa a cobertura de test ```md title=".opencode/commands/analyze-coverage.md" --- -description: Analyze test coverage +description: Analise cobertura de testes --- -Here are the current test results: +Aqui estão os resultados atuais dos testes: !`npm test` -Based on these results, suggest improvements to increase coverage. +Com base nesses resultados, sugira melhorias para aumentar a cobertura. ``` Ou para revisar alterações recentes: ```md title=".opencode/commands/review-changes.md" --- -description: Review recent changes +description: Revise alterações recentes --- -Recent git commits: +Commits recentes do git: !`git log --oneline -10` -Review these changes and suggest any improvements. +Revise essas alterações e sugira quaisquer melhorias. ``` Os comandos são executados no diretório raiz do seu projeto e sua saída se torna parte do prompt. @@ -200,11 +200,11 @@ Inclua arquivos no seu comando usando `@` seguido pelo nome do arquivo. ```md title=".opencode/commands/review-component.md" --- -description: Review component +description: Revise componente --- -Review the component in @src/components/Button.tsx. -Check for performance issues and suggest improvements. +Revise o componente em @src/components/Button.tsx. +Verifique problemas de desempenho e sugira melhorias. ``` O conteúdo do arquivo é incluído automaticamente no prompt. @@ -225,7 +225,7 @@ A opção `template` define o prompt que será enviado ao LLM quando o comando f { "command": { "test": { - "template": "Run the full test suite with coverage report and show any failures.\nFocus on the failing tests and suggest fixes." + "template": "Execute a suíte de testes completa com relatório de cobertura e mostre quaisquer falhas.\nConcentre-se nos testes com falha e sugira correções." } } } @@ -243,7 +243,7 @@ Use a opção `description` para fornecer uma breve descrição do que o comando { "command": { "test": { - "description": "Run tests with coverage" + "description": "Execute testes com cobertura" } } } @@ -311,7 +311,7 @@ Esta é uma opção de configuração **opcional**. --- -## Integrado +## Integrados opencode inclui vários comandos integrados como `/init`, `/undo`, `/redo`, `/share`, `/help`; [saiba mais](/docs/tui#commands). diff --git a/packages/web/src/content/docs/pt-br/config.mdx b/packages/web/src/content/docs/pt-br/config.mdx index aa500a156..405c53794 100644 --- a/packages/web/src/content/docs/pt-br/config.mdx +++ b/packages/web/src/content/docs/pt-br/config.mdx @@ -1,5 +1,5 @@ --- -title: Config +title: Configuração description: Usando a configuração JSON do opencode. --- @@ -23,9 +23,9 @@ O opencode suporta os formatos **JSON** e **JSONC** (JSON com Comentários). --- -## Localizações +## Locais -Você pode colocar sua configuração em algumas localizações diferentes e elas têm uma +Você pode colocar sua configuração em alguns locais diferentes e eles têm uma ordem de precedência diferente. :::note @@ -320,11 +320,11 @@ Você pode configurar agentes especializados para tarefas específicas através "$schema": "https://opencode.ai/config.json", "agent": { "code-reviewer": { - "description": "Reviews code for best practices and potential issues", + "description": "Revisa código para melhores práticas e potenciais problemas", "model": "anthropic/claude-sonnet-4-5", - "prompt": "You are a code reviewer. Focus on security, performance, and maintainability.", + "prompt": "Você é um revisor de código. Foque em segurança, performance e manutenibilidade.", "tools": { - // Disable file modification tools for review-only agent + // Desabilitar ferramentas de modificação de arquivo para agente de apenas revisão "write": false, "edit": false, }, @@ -384,14 +384,14 @@ Você pode configurar comandos personalizados para tarefas repetitivas através "$schema": "https://opencode.ai/config.json", "command": { "test": { - "template": "Run the full test suite with coverage report and show any failures.\nFocus on the failing tests and suggest fixes.", - "description": "Run tests with coverage", + "template": "Execute a suíte de testes completa com relatório de cobertura e mostre quaisquer falhas.\nConcentre-se nos testes com falha e sugira correções.", + "description": "Execute testes com cobertura", "agent": "build", "model": "anthropic/claude-haiku-4-5", }, "component": { - "template": "Create a new React component named $ARGUMENTS with TypeScript support.\nInclude proper typing and basic structure.", - "description": "Create a new component", + "template": "Crie um novo componente React chamado $ARGUMENTS com suporte a TypeScript.\nInclua tipagem adequada e estrutura básica.", + "description": "Crie um novo componente", }, }, } diff --git a/packages/web/src/content/docs/pt-br/custom-tools.mdx b/packages/web/src/content/docs/pt-br/custom-tools.mdx index 63a43df76..43749200f 100644 --- a/packages/web/src/content/docs/pt-br/custom-tools.mdx +++ b/packages/web/src/content/docs/pt-br/custom-tools.mdx @@ -1,6 +1,6 @@ --- title: Ferramentas Personalizadas -description: Crie ferramentas que o LLM pode chamar em opencode. +description: Crie ferramentas que o LLM pode chamar no opencode. --- Ferramentas personalizadas são funções que você cria e que o LLM pode chamar durante as conversas. Elas funcionam junto com as [ferramentas integradas](/docs/tools) do opencode, como `read`, `write` e `bash`. @@ -30,13 +30,13 @@ A maneira mais fácil de criar ferramentas é usando o helper `tool()`, que forn import { tool } from "@opencode-ai/plugin" export default tool({ - description: "Query the project database", + description: "Consultar o banco de dados do projeto", args: { - query: tool.schema.string().describe("SQL query to execute"), + query: tool.schema.string().describe("Consulta SQL para executar"), }, async execute(args) { - // Your database logic here - return `Executed query: ${args.query}` + // Sua lógica de banco de dados aqui + return `Consulta executada: ${args.query}` }, }) ``` @@ -53,10 +53,10 @@ Você também pode exportar várias ferramentas de um único arquivo. Cada expor import { tool } from "@opencode-ai/plugin" export const add = tool({ - description: "Add two numbers", + description: "Adicionar dois números", args: { - a: tool.schema.number().describe("First number"), - b: tool.schema.number().describe("Second number"), + a: tool.schema.number().describe("Primeiro número"), + b: tool.schema.number().describe("Segundo número"), }, async execute(args) { return args.a + args.b @@ -64,10 +64,10 @@ export const add = tool({ }) export const multiply = tool({ - description: "Multiply two numbers", + description: "Multiplicar dois números", args: { - a: tool.schema.number().describe("First number"), - b: tool.schema.number().describe("Second number"), + a: tool.schema.number().describe("Primeiro número"), + b: tool.schema.number().describe("Segundo número"), }, async execute(args) { return args.a * args.b @@ -85,7 +85,7 @@ Você pode usar `tool.schema`, que é apenas [Zod](https://zod.dev), para defini ```ts "tool.schema" args: { - query: tool.schema.string().describe("SQL query to execute") + query: tool.schema.string().describe("Consulta SQL para executar") } ``` @@ -95,12 +95,12 @@ Você também pode importar [Zod](https://zod.dev) diretamente e retornar um obj import { z } from "zod" export default { - description: "Tool description", + description: "Descrição da ferramenta", args: { - param: z.string().describe("Parameter description"), + param: z.string().describe("Descrição do parâmetro"), }, async execute(args, context) { - // Tool implementation + // Implementação da ferramenta return "result" }, } @@ -116,10 +116,10 @@ As ferramentas recebem contexto sobre a sessão atual: import { tool } from "@opencode-ai/plugin" export default tool({ - description: "Get project information", + description: "Obter informações do projeto", args: {}, async execute(args, context) { - // Access context information + // Acessar informações de contexto const { agent, sessionID, messageID, directory, worktree } = context return `Agent: ${agent}, Session: ${sessionID}, Message: ${messageID}, Directory: ${directory}, Worktree: ${worktree}` }, @@ -133,7 +133,7 @@ Use `context.worktree` para a raiz do worktree do git. ## Exemplos -### Escreva uma ferramenta em Python +### Escrevendo uma ferramenta em Python Você pode escrever suas ferramentas em qualquer linguagem que desejar. Aqui está um exemplo que adiciona dois números usando Python. @@ -154,10 +154,10 @@ import { tool } from "@opencode-ai/plugin" import path from "path" export default tool({ - description: "Add two numbers using Python", + description: "Adicionar dois números usando Python", args: { - a: tool.schema.number().describe("First number"), - b: tool.schema.number().describe("Second number"), + a: tool.schema.number().describe("Primeiro número"), + b: tool.schema.number().describe("Segundo número"), }, async execute(args, context) { const script = path.join(context.worktree, ".opencode/tools/add.py") diff --git a/packages/web/src/content/docs/pt-br/ecosystem.mdx b/packages/web/src/content/docs/pt-br/ecosystem.mdx index a405cdf62..ac5d35444 100644 --- a/packages/web/src/content/docs/pt-br/ecosystem.mdx +++ b/packages/web/src/content/docs/pt-br/ecosystem.mdx @@ -1,6 +1,6 @@ --- title: Ecossistema -description: Projetos e integrações construídos com opencode. +description: Projetos e integrações construídos com o opencode. --- Uma coleção de projetos da comunidade construídos sobre o opencode. @@ -27,7 +27,7 @@ Você também pode conferir [awesome-opencode](https://github.com/awesome-openco | [opencode-google-antigravity-auth](https://github.com/shekohex/opencode-google-antigravity-auth) | Plugin Google Antigravity OAuth, com suporte para Google Search e manuseio de API mais robusto | | [opencode-dynamic-context-pruning](https://github.com/Tarquinen/opencode-dynamic-context-pruning) | Otimize o uso de tokens podando saídas de ferramentas obsoletas | | [opencode-websearch-cited](https://github.com/ghoulr/opencode-websearch-cited.git) | Adicione suporte nativo de pesquisa na web para provedores suportados com estilo fundamentado no Google | -| [opencode-pty](https://github.com/shekohex/opencode-pty.git) | Permite que agentes de AI executem processos em segundo plano em um PTY, enviando entrada interativa para eles. | +| [opencode-pty](https://github.com/shekohex/opencode-pty.git) | Permite que agentes de IA executem processos em segundo plano em um PTY, enviando entrada interativa para eles. | | [opencode-shell-strategy](https://github.com/JRedeker/opencode-shell-strategy) | Instruções para comandos de shell não interativos - evita travamentos de operações dependentes de TTY | | [opencode-wakatime](https://github.com/angristan/opencode-wakatime) | Acompanhe o uso do opencode com Wakatime | | [opencode-md-table-formatter](https://github.com/franlol/opencode-md-table-formatter/tree/main) | Limpe tabelas markdown produzidas por LLMs | @@ -35,14 +35,14 @@ Você também pode conferir [awesome-opencode](https://github.com/awesome-openco | [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) | Agentes em segundo plano, ferramentas LSP/AST/MCP pré-construídas, agentes curados, compatível com Claude Code | | [opencode-notificator](https://github.com/panta82/opencode-notificator) | Notificações de desktop e alertas sonoros para sessões do opencode | | [opencode-notifier](https://github.com/mohak34/opencode-notifier) | Notificações de desktop e alertas sonoros para eventos de permissão, conclusão e erro | -| [opencode-zellij-namer](https://github.com/24601/opencode-zellij-namer) | Nomeação automática de sessões Zellij com suporte de AI com base no contexto do opencode | +| [opencode-zellij-namer](https://github.com/24601/opencode-zellij-namer) | Nomeação automática de sessões Zellij com suporte de IA com base no contexto do opencode | | [opencode-skillful](https://github.com/zenobi-us/opencode-skillful) | Permite que agentes do opencode carreguem prompts sob demanda com descoberta e injeção de habilidades | | [opencode-supermemory](https://github.com/supermemoryai/opencode-supermemory) | Memória persistente entre sessões usando Supermemory | | [@plannotator/opencode](https://github.com/backnotprop/plannotator/tree/main/apps/opencode-plugin) | Revisão de plano interativa com anotação visual e compartilhamento privado/offline | | [@openspoon/subtask2](https://github.com/spoons-and-mirrors/subtask2) | Estenda opencode /commands em um poderoso sistema de orquestração com controle de fluxo granular | | [opencode-scheduler](https://github.com/different-ai/opencode-scheduler) | Agende trabalhos recorrentes usando launchd (Mac) ou systemd (Linux) com sintaxe cron | | [micode](https://github.com/vtemian/micode) | Fluxo de trabalho Estruturado Brainstorm → Planejar → Implementar com continuidade de sessão | -| [octto](https://github.com/vtemian/octto) | UI interativa do navegador para brainstorming de AI com formulários de múltiplas perguntas | +| [octto](https://github.com/vtemian/octto) | UI interativa do navegador para brainstorming de IA com formulários de múltiplas perguntas | | [opencode-background-agents](https://github.com/kdcokenny/opencode-background-agents) | Agentes em segundo plano estilo Claude Code com delegação assíncrona e persistência de contexto | | [opencode-notify](https://github.com/kdcokenny/opencode-notify) | Notificações nativas do OS para opencode – saiba quando as tarefas são concluídas | | [opencode-workspace](https://github.com/kdcokenny/opencode-workspace) | Conjunto de orquestração multi-agente – 16 componentes, uma instalação | @@ -58,7 +58,7 @@ Você também pode conferir [awesome-opencode](https://github.com/awesome-openco | [opencode.nvim](https://github.com/NickvanDyke/opencode.nvim) | Plugin Neovim para prompts cientes do editor, construído sobre a API | | [portal](https://github.com/hosenur/portal) | UI web mobile-first para opencode sobre Tailscale/VPN | | [opencode plugin template](https://github.com/zenobi-us/opencode-plugin-template/) | Template para construir plugins do opencode | -| [opencode.nvim](https://github.com/sudo-tee/opencode.nvim) | Frontend Neovim para opencode - um agente de codificação AI baseado em terminal | +| [opencode.nvim](https://github.com/sudo-tee/opencode.nvim) | Frontend Neovim para opencode - um agente de codificação IA baseado em terminal | | [ai-sdk-provider-opencode-sdk](https://github.com/ben-vargas/ai-sdk-provider-opencode-sdk) | Provedor Vercel AI SDK para usar opencode via @opencode-ai/sdk | | [OpenChamber](https://github.com/btriapitsyn/openchamber) | Aplicativo Web / Desktop e Extensão do VS Code para opencode | | [OpenCode-Obsidian](https://github.com/mtymek/opencode-obsidian) | Plugin Obsidian que incorpora opencode na UI do Obsidian | @@ -72,5 +72,5 @@ Você também pode conferir [awesome-opencode](https://github.com/awesome-openco | Nome | Descrição | | ----------------------------------------------------------------- | ----------------------------------------------------------------------------- | -| [Agentic](https://github.com/Cluster444/agentic) | Agentes e comandos de AI modulares para desenvolvimento estruturado | +| [Agentic](https://github.com/Cluster444/agentic) | Agentes e comandos de IA modulares para desenvolvimento estruturado | | [opencode-agents](https://github.com/darrenhinde/opencode-agents) | Configurações, prompts, agentes e plugins para fluxos de trabalho aprimorados | diff --git a/packages/web/src/content/docs/pt-br/enterprise.mdx b/packages/web/src/content/docs/pt-br/enterprise.mdx index 6ea6e5dc3..3a649dc07 100644 --- a/packages/web/src/content/docs/pt-br/enterprise.mdx +++ b/packages/web/src/content/docs/pt-br/enterprise.mdx @@ -1,18 +1,18 @@ --- title: Empresa -description: Usando opencode com segurança em sua organização. +description: Usando o opencode com segurança em sua organização. --- import config from "../../../../config.mjs" export const email = `mailto:${config.email}` -opencode Enterprise é para organizações que desejam garantir que seu código e dados nunca deixem sua infraestrutura. Isso pode ser feito usando uma configuração centralizada que se integra ao seu SSO e gateway de AI interno. +O opencode Enterprise é para organizações que desejam garantir que seu código e dados nunca deixem sua infraestrutura. Isso pode ser feito usando uma configuração centralizada que se integra ao seu SSO e gateway de IA interno. :::note -opencode não armazena nenhum de seus códigos ou dados de contexto. +O opencode não armazena nenhum de seus códigos ou dados de contexto. ::: -Para começar com opencode Enterprise: +Para começar com o opencode Enterprise: 1. Faça um teste internamente com sua equipe. 2. **Entre em contato conosco** para discutir opções de preços e implementação. @@ -21,15 +21,15 @@ Para começar com opencode Enterprise: ## Teste -opencode é de código aberto e não armazena nenhum de seus códigos ou dados de contexto, então seus desenvolvedores podem simplesmente [começar](/docs/) e realizar um teste. +O opencode é de código aberto e não armazena nenhum de seus códigos ou dados de contexto, então seus desenvolvedores podem simplesmente [começar](/docs/) e realizar um teste. --- ### Manipulação de dados -**opencode não armazena seu código ou dados de contexto.** Todo o processamento acontece localmente ou através de chamadas diretas de API para seu provedor de AI. +**O opencode não armazena seu código ou dados de contexto.** Todo o processamento acontece localmente ou através de chamadas diretas de API para seu provedor de IA. -Isso significa que, enquanto você estiver usando um provedor em quem confia, ou um gateway de AI interno, você pode usar o opencode com segurança. +Isso significa que, enquanto você estiver usando um provedor em quem confia, ou um gateway de IA interno, você pode usar o opencode com segurança. A única ressalva aqui é o recurso opcional `/share`. @@ -76,7 +76,7 @@ Uma vez que você tenha concluído seu teste e esteja pronto para usar o opencod Podemos configurar o opencode para usar uma única configuração central para toda a sua organização. -Essa configuração centralizada pode se integrar ao seu provedor de SSO e garante que todos os usuários acessem apenas seu gateway de AI interno. +Essa configuração centralizada pode se integrar ao seu provedor de SSO e garante que todos os usuários acessem apenas seu gateway de IA interno. --- @@ -84,15 +84,15 @@ Essa configuração centralizada pode se integrar ao seu provedor de SSO e garan Através da configuração central, o opencode pode se integrar ao provedor de SSO de sua organização para autenticação. -Isso permite que o opencode obtenha credenciais para seu gateway de AI interno através do seu sistema de gerenciamento de identidade existente. +Isso permite que o opencode obtenha credenciais para seu gateway de IA interno através do seu sistema de gerenciamento de identidade existente. --- -### Gateway de AI Interno +### Gateway de IA Interno -Com a configuração central, o opencode também pode ser configurado para usar apenas seu gateway de AI interno. +Com a configuração central, o opencode também pode ser configurado para usar apenas seu gateway de IA interno. -Você também pode desativar todos os outros provedores de AI, garantindo que todas as solicitações passem pela infraestrutura aprovada de sua organização. +Você também pode desativar todos os outros provedores de IA, garantindo que todas as solicitações passem pela infraestrutura aprovada de sua organização. --- @@ -107,14 +107,14 @@ Isso está atualmente em nosso roadmap. Se você estiver interessado, ** -

O que é opencode Enterprise? +O que é o opencode Enterprise? -opencode Enterprise é para organizações que desejam garantir que seu código e dados nunca deixem sua infraestrutura. Isso pode ser feito usando uma configuração centralizada que se integra ao seu SSO e gateway de AI interno. +O opencode Enterprise é para organizações que desejam garantir que seu código e dados nunca deixem sua infraestrutura. Isso pode ser feito usando uma configuração centralizada que se integra ao seu SSO e gateway de IA interno.
-Como posso começar com opencode Enterprise? +Como posso começar com o opencode Enterprise? Basta começar com um teste interno com sua equipe. O opencode, por padrão, não armazena seu código ou dados de contexto, facilitando o início. @@ -130,9 +130,9 @@ Oferecemos preços empresariais por assento. Se você tiver seu próprio gateway
-Meus dados estão seguros com opencode Enterprise? +Meus dados estão seguros com o opencode Enterprise? -Sim. O opencode não armazena seu código ou dados de contexto. Todo o processamento acontece localmente ou através de chamadas diretas de API para seu provedor de AI. Com a configuração central e a integração SSO, seus dados permanecem seguros dentro da infraestrutura de sua organização. +Sim. O opencode não armazena seu código ou dados de contexto. Todo o processamento acontece localmente ou através de chamadas diretas de API para seu provedor de IA. Com a configuração central e a integração SSO, seus dados permanecem seguros dentro da infraestrutura de sua organização.
diff --git a/packages/web/src/content/docs/pt-br/formatters.mdx b/packages/web/src/content/docs/pt-br/formatters.mdx index 3d25ca1ee..3037e7b65 100644 --- a/packages/web/src/content/docs/pt-br/formatters.mdx +++ b/packages/web/src/content/docs/pt-br/formatters.mdx @@ -1,15 +1,15 @@ --- title: Formatadores -description: opencode usa formatadores específicos de linguagem. +description: O opencode usa formatadores específicos de linguagem. --- -opencode formata automaticamente arquivos após serem escritos ou editados usando formatadores específicos de linguagem. Isso garante que o código gerado siga os estilos de código do seu projeto. +O opencode formata automaticamente arquivos após serem escritos ou editados usando formatadores específicos de linguagem. Isso garante que o código gerado siga os estilos de código do seu projeto. --- -## Integrado +## Integrados -opencode vem com vários formatadores integrados para linguagens e frameworks populares. Abaixo está uma lista dos formatadores, extensões de arquivo suportadas e comandos ou opções de configuração necessárias. +O opencode vem com vários formatadores integrados para linguagens e frameworks populares. Abaixo está uma lista dos formatadores, extensões de arquivo suportadas e comandos ou opções de configuração necessárias. | Formatador | Extensões | Requisitos | | -------------------- | ------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------- | @@ -54,7 +54,7 @@ Esse processo acontece em segundo plano, garantindo que seus estilos de código --- -## Configurar +## Configuração Você pode personalizar os formatadores através da seção `formatter` em sua configuração do opencode. diff --git a/packages/web/src/content/docs/pt-br/github.mdx b/packages/web/src/content/docs/pt-br/github.mdx index 98ab1cec1..c2e53ca77 100644 --- a/packages/web/src/content/docs/pt-br/github.mdx +++ b/packages/web/src/content/docs/pt-br/github.mdx @@ -1,9 +1,9 @@ --- title: GitHub -description: Use opencode em problemas e pull-requests do GitHub. +description: Use o opencode em problemas e pull-requests do GitHub. --- -opencode integra-se ao seu fluxo de trabalho do GitHub. Mencione `/opencode` ou `/oc` em seu comentário, e o opencode executará tarefas dentro do seu runner do GitHub Actions. +O opencode integra-se ao seu fluxo de trabalho do GitHub. Mencione `/opencode` ou `/oc` em seu comentário, e o opencode executará tarefas dentro do seu runner do GitHub Actions. --- @@ -139,15 +139,15 @@ jobs: with: persist-credentials: false - - name: Run OpenCode - uses: anomalyco/opencode/github@latest - env: - ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }} - with: - model: anthropic/claude-sonnet-4-20250514 - prompt: | - Review the codebase for any TODO comments and create a summary. - If you find issues worth addressing, open an issue to track them. + - name: Run OpenCode + uses: anomalyco/opencode/github@latest + env: + ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }} + with: + model: anthropic/claude-sonnet-4-20250514 + prompt: | + Revise a base de código para quaisquer comentários TODO e crie um resumo. + Se encontrar problemas que valham a pena resolver, abra um issue para rastreá-los. ``` Para eventos agendados, a entrada `prompt` é **obrigatória** uma vez que não há comentário para extrair instruções. Fluxos de trabalho agendados são executados sem um contexto de usuário para verificação de permissões, então o fluxo de trabalho deve conceder `contents: write` e `pull-requests: write` se você espera que o opencode crie branches ou PRs. @@ -177,18 +177,18 @@ jobs: - uses: actions/checkout@v6 with: persist-credentials: false - - uses: anomalyco/opencode/github@latest - env: - ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }} - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} - with: - model: anthropic/claude-sonnet-4-20250514 - use_github_token: true - prompt: | - Review this pull request: - - Check for code quality issues - - Look for potential bugs - - Suggest improvements + - uses: anomalyco/opencode/github@latest + env: + ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }} + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + with: + model: anthropic/claude-sonnet-4-20250514 + use_github_token: true + prompt: | + Revise este pull request: + - Verifique problemas de qualidade de código + - Procure por potenciais bugs + - Sugira melhorias ``` Para eventos de `pull_request`, se nenhum `prompt` for fornecido, o opencode padrão será revisar o pull request. @@ -233,17 +233,17 @@ jobs: with: persist-credentials: false - - uses: anomalyco/opencode/github@latest - if: steps.check.outputs.result == 'true' - env: - ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }} - with: - model: anthropic/claude-sonnet-4-20250514 - prompt: | - Review this issue. If there's a clear fix or relevant docs: - - Provide documentation links - - Add error handling guidance for code examples - Otherwise, do not comment. + - uses: anomalyco/opencode/github@latest + if: steps.check.outputs.result == 'true' + env: + ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }} + with: + model: anthropic/claude-sonnet-4-20250514 + prompt: | + Revise este issue. Se houver uma correção clara ou docs relevantes: + - Forneça links de documentação + - Adicione orientação sobre tratamento de erros para exemplos de código + Caso contrário, não comente. ``` Para eventos de `issues`, a entrada `prompt` é **obrigatória** uma vez que não há comentário para extrair instruções. @@ -259,10 +259,10 @@ Substitua o prompt padrão para personalizar o comportamento do opencode para se with: model: anthropic/claude-sonnet-4-5 prompt: | - Review this pull request: - - Check for code quality issues - - Look for potential bugs - - Suggest improvements + Revise este pull request: + - Verifique problemas de qualidade de código + - Procure por potenciais bugs + - Sugira melhorias ``` Isso é útil para impor critérios de revisão específicos, padrões de codificação ou áreas de foco relevantes para seu projeto. @@ -308,7 +308,7 @@ Aqui estão alguns exemplos de como você pode usar o opencode no GitHub. Deixe um comentário diretamente nas linhas de código na aba "Files" do PR. O opencode detecta automaticamente o arquivo, os números das linhas e o contexto do diff para fornecer respostas precisas. ``` - [Comment on specific lines in Files tab] + [Comentário em linhas específicas na aba Files] /oc add error handling here ``` diff --git a/packages/web/src/content/docs/pt-br/gitlab.mdx b/packages/web/src/content/docs/pt-br/gitlab.mdx index 7a2ce36ea..dc48aa57c 100644 --- a/packages/web/src/content/docs/pt-br/gitlab.mdx +++ b/packages/web/src/content/docs/pt-br/gitlab.mdx @@ -1,9 +1,9 @@ --- title: GitLab -description: Use opencode em problemas e solicitações de mesclagem do GitLab. +description: Use o opencode em problemas e solicitações de mesclagem do GitLab. --- -opencode se integra ao seu fluxo de trabalho do GitLab através do seu pipeline CI/CD do GitLab ou com o GitLab Duo. +O opencode se integra ao seu fluxo de trabalho do GitLab através do seu pipeline CI/CD do GitLab ou com o GitLab Duo. Em ambos os casos, o opencode será executado em seus runners do GitLab. @@ -11,7 +11,7 @@ Em ambos os casos, o opencode será executado em seus runners do GitLab. ## GitLab CI -opencode funciona em um pipeline regular do GitLab. Você pode integrá-lo a um pipeline como um [componente CI](https://docs.gitlab.com/ee/ci/components/) +O opencode funciona em um pipeline regular do GitLab. Você pode integrá-lo a um pipeline como um [componente CI](https://docs.gitlab.com/ee/ci/components/) Aqui estamos usando um componente CI/CD criado pela comunidade para opencode — [nagyv/gitlab-opencode](https://gitlab.com/nagyv/gitlab-opencode). @@ -35,9 +35,9 @@ Aqui estamos usando um componente CI/CD criado pela comunidade para opencode — - component: $CI_SERVER_FQDN/nagyv/gitlab-opencode/opencode@2 inputs: config_dir: ${CI_PROJECT_DIR}/opencode-config - auth_json: $OPENCODE_AUTH_JSON # The variable name for your OpenCode authentication JSON + auth_json: $OPENCODE_AUTH_JSON # O nome da variável para seu JSON de autenticação do OpenCode command: optional-custom-command - message: "Your prompt here" + message: "Seu prompt aqui" ``` Para mais entradas e casos de uso [consulte a documentação](https://gitlab.com/explore/catalog/nagyv/gitlab-opencode) deste componente. @@ -46,7 +46,7 @@ Para mais entradas e casos de uso [consulte a documentação](https://gitlab.com ## GitLab Duo -opencode se integra ao seu fluxo de trabalho do GitLab. +O opencode se integra ao seu fluxo de trabalho do GitLab. Mencione `@opencode` em um comentário, e o opencode executará tarefas dentro do seu pipeline CI do GitLab. --- @@ -70,7 +70,7 @@ Consulte a [**documentação do GitLab**](https://docs.gitlab.com/user/duo_agent 1. Configure seu ambiente GitLab 2. Configure CI/CD -3. Obtenha uma chave de API do provedor de modelo de AI +3. Obtenha uma chave de API do provedor de modelo de IA 4. Crie uma conta de serviço 5. Configure variáveis de CI/CD 6. Crie um arquivo de configuração de fluxo, aqui está um exemplo: @@ -82,16 +82,16 @@ Consulte a [**documentação do GitLab**](https://docs.gitlab.com/user/duo_agent ```yaml image: node:22-slim commands: - - echo "Installing opencode" + - echo "Instalando opencode" - npm install --global opencode-ai - - echo "Installing glab" + - echo "Instalando glab" - export GITLAB_TOKEN=$GITLAB_TOKEN_OPENCODE - apt-get update --quiet && apt-get install --yes curl wget gpg git && rm --recursive --force /var/lib/apt/lists/* - curl --silent --show-error --location "https://raw.githubusercontent.com/upciti/wakemeops/main/assets/install_repository" | bash - apt-get install --yes glab - - echo "Configuring glab" + - echo "Configurando glab" - echo $GITLAB_HOST - - echo "Creating OpenCode auth configuration" + - echo "Criando configuração de auth do OpenCode" - mkdir --parents ~/.local/share/opencode - | cat > ~/.local/share/opencode/auth.json << EOF @@ -102,47 +102,47 @@ Consulte a [**documentação do GitLab**](https://docs.gitlab.com/user/duo_agent } } EOF - - echo "Configuring git" + - echo "Configurando git" - git config --global user.email "opencode@gitlab.com" - git config --global user.name "OpenCode" - - echo "Testing glab" + - echo "Testando glab" - glab issue list - - echo "Running OpenCode" + - echo "Executando OpenCode" - | opencode run " - You are an AI assistant helping with GitLab operations. + Você é um assistente de IA ajudando com operações do GitLab. - Context: $AI_FLOW_CONTEXT - Task: $AI_FLOW_INPUT - Event: $AI_FLOW_EVENT + Contexto: $AI_FLOW_CONTEXT + Tarefa: $AI_FLOW_INPUT + Evento: $AI_FLOW_EVENT - Please execute the requested task using the available GitLab tools. - Be thorough in your analysis and provide clear explanations. + Por favor, execute a tarefa solicitada usando as ferramentas disponíveis do GitLab. + Seja minucioso em sua análise e forneça explicações claras. - Please use the glab CLI to access data from GitLab. The glab CLI has already been authenticated. You can run the corresponding commands. + Por favor, use a CLI glab para acessar dados do GitLab. A CLI glab já foi autenticada. Você pode executar os comandos correspondentes. - If you are asked to summarize an MR or issue or asked to provide more information then please post back a note to the MR/Issue so that the user can see it. - You don't need to commit or push up changes, those will be done automatically based on the file changes you make. + Se for solicitado a resumir um MR ou problema ou solicitado a fornecer mais informações, poste uma nota de volta no MR/Problema para que o usuário possa ver. + Você não precisa commitar ou enviar alterações, isso será feito automaticamente com base nas alterações de arquivo que você fizer. " - git checkout --branch $CI_WORKLOAD_REF origin/$CI_WORKLOAD_REF - - echo "Checking for git changes and pushing if any exist" + - echo "Verificando alterações no git e enviando se existirem" - | if ! git diff --quiet || ! git diff --cached --quiet || [ --not --zero "$(git ls-files --others --exclude-standard)" ]; then - echo "Git changes detected, adding and pushing..." + echo "Alterações git detectadas, adicionando e enviando..." git add . if git diff --cached --quiet; then - echo "No staged changes to commit" + echo "Nenhuma alteração preparada para commit" else - echo "Committing changes to branch: $CI_WORKLOAD_REF" + echo "Commitando alterações para o branch: $CI_WORKLOAD_REF" git commit --message "Codex changes" - echo "Pushing changes up to $CI_WORKLOAD_REF" + echo "Enviando alterações para $CI_WORKLOAD_REF" git push https://gitlab-ci-token:$GITLAB_TOKEN@$GITLAB_HOST/gl-demo-ultimate-dev-ai-epic-17570/test-java-project.git $CI_WORKLOAD_REF - echo "Changes successfully pushed" + echo "Alterações enviadas com sucesso" fi else - echo "No git changes detected, skipping push" + echo "Nenhuma alteração git detectada, pulando envio" fi variables: - ANTHROPIC_API_KEY diff --git a/packages/web/src/content/docs/pt-br/ide.mdx b/packages/web/src/content/docs/pt-br/ide.mdx index c7dd5ecc2..cb773c991 100644 --- a/packages/web/src/content/docs/pt-br/ide.mdx +++ b/packages/web/src/content/docs/pt-br/ide.mdx @@ -1,9 +1,9 @@ --- title: IDE -description: A extensão opencode para VS Code, Cursor e outras IDEs +description: A extensão opencode para VS Code, Cursor e outros IDEs --- -opencode integra-se com VS Code, Cursor ou qualquer IDE que suporte um terminal. Basta executar `opencode` no terminal para começar. +O opencode integra-se com VS Code, Cursor ou qualquer IDE que suporte um terminal. Basta executar `opencode` no terminal para começar. --- @@ -24,7 +24,7 @@ Para instalar o opencode no VS Code e forks populares como Cursor, Windsurf, VSC 2. Abra o terminal integrado 3. Execute `opencode` - a extensão será instalada automaticamente -Se, por outro lado, você quiser usar sua própria IDE ao executar `/editor` ou `/export` a partir do TUI, você precisará definir `export EDITOR="code --wait"`. [Saiba mais](/docs/tui/#editor-setup). +Se, por outro lado, você quiser usar seu próprio IDE ao executar `/editor` ou `/export` a partir do TUI, você precisará definir `export EDITOR="code --wait"`. [Saiba mais](/docs/tui/#editor-setup). --- @@ -39,10 +39,10 @@ Procure por **opencode** no Marketplace de Extensões e clique em **Instalar**. Se a extensão falhar ao instalar automaticamente: - Certifique-se de que você está executando `opencode` no terminal integrado. -- Confirme se o CLI para sua IDE está instalado: +- Confirme se a CLI para seu IDE está instalado: - Para VS Code: comando `code` - Para Cursor: comando `cursor` - Para Windsurf: comando `windsurf` - Para VSCodium: comando `codium` - - Se não, execute `Cmd+Shift+P` (Mac) ou `Ctrl+Shift+P` (Windows/Linux) e procure por "Shell Command: Install 'code' command in PATH" (ou o equivalente para sua IDE) + - Se não, execute `Cmd+Shift+P` (Mac) ou `Ctrl+Shift+P` (Windows/Linux) e procure por "Shell Command: Install 'code' command in PATH" (ou o equivalente para seu IDE) - Certifique-se de que o VS Code tem permissão para instalar extensões diff --git a/packages/web/src/content/docs/pt-br/index.mdx b/packages/web/src/content/docs/pt-br/index.mdx index bbb951d23..acbf12f2a 100644 --- a/packages/web/src/content/docs/pt-br/index.mdx +++ b/packages/web/src/content/docs/pt-br/index.mdx @@ -1,13 +1,13 @@ --- title: Introdução -description: Comece com o opencode. +description: Comece a usar o opencode. --- import { Tabs, TabItem } from "@astrojs/starlight/components" import config from "../../../../config.mjs" export const console = config.console -[**opencode**](/) é um agente de codificação AI de código aberto. Está disponível como uma interface baseada em terminal, aplicativo desktop ou extensão de IDE. +[**opencode**](/) é um agente de codificação de IA de código aberto. Está disponível como uma interface baseada em terminal, aplicativo desktop ou extensão de IDE. ![opencode TUI com o tema opencode](../../../assets/lander/screenshot.png) @@ -29,7 +29,7 @@ Para usar o opencode no seu terminal, você precisará de: --- -## Instalar +## Instalação A maneira mais fácil de instalar o opencode é através do script de instalação. @@ -129,7 +129,7 @@ Você também pode baixar o binário na seção [Releases](https://github.com/an --- -## Configurar +## Configuração Com o opencode, você pode usar qualquer provedor de LLM configurando suas chaves de API. @@ -157,7 +157,7 @@ Alternativamente, você pode selecionar um dos outros provedores. [Saiba mais](/ --- -## Inicializar +## Inicialização Agora que você configurou um provedor, pode navegar até um projeto no qual deseja trabalhar. @@ -191,11 +191,11 @@ Isso ajuda o opencode a entender a estrutura do projeto e os padrões de codific Agora você está pronto para usar o opencode para trabalhar em seu projeto. Sinta-se à vontade para perguntar qualquer coisa! -Se você é novo no uso de um agente de codificação AI, aqui estão alguns exemplos que podem ajudar. +Se você é novo no uso de um agente de codificação de IA, aqui estão alguns exemplos que podem ajudar. --- -### Fazer perguntas +### Fazendo perguntas Você pode pedir ao opencode para explicar a base de código para você. @@ -211,7 +211,7 @@ Isso é útil se houver uma parte da base de código na qual você não trabalho --- -### Adicionar recursos +### Adicionando recursos Você pode pedir ao opencode para adicionar novos recursos ao seu projeto. Embora primeiro recomendemos pedir para ele criar um plano. @@ -270,7 +270,7 @@ Você pode pedir ao opencode para adicionar novos recursos ao seu projeto. Embor --- -### Fazer alterações +### Fazendo alterações Para alterações mais simples, você pode pedir ao opencode para construí-las diretamente sem precisar revisar o plano primeiro. @@ -284,7 +284,7 @@ Você quer ter certeza de fornecer uma boa quantidade de detalhes para que o ope --- -### Desfazer alterações +### Desfazendo alterações Vamos supor que você peça ao opencode para fazer algumas alterações. @@ -318,7 +318,7 @@ Ou você **pode refazer** as alterações usando o comando `/redo`. --- -## Compartilhar +## Compartilhamento As conversas que você tem com o opencode podem ser [compartilhadas com sua equipe](/docs/share). @@ -336,7 +336,7 @@ Aqui está uma [conversa de exemplo](https://opencode.ai/s/4XP1fce5) com o openc --- -## Personalizar +## Personalização E é isso! Agora você é um profissional em usar o opencode. diff --git a/packages/web/src/content/docs/pt-br/keybinds.mdx b/packages/web/src/content/docs/pt-br/keybinds.mdx index 1df58fa84..b4da4471a 100644 --- a/packages/web/src/content/docs/pt-br/keybinds.mdx +++ b/packages/web/src/content/docs/pt-br/keybinds.mdx @@ -3,7 +3,7 @@ title: Atalhos de Teclado description: Personalize seus atalhos de teclado. --- -opencode tem uma lista de atalhos de teclado que você pode personalizar através da configuração do opencode. +O opencode tem uma lista de atalhos de teclado que você pode personalizar através da configuração do opencode. ```json title="opencode.json" { @@ -107,7 +107,7 @@ opencode tem uma lista de atalhos de teclado que você pode personalizar atravé ## Tecla líder -opencode usa uma tecla `leader` para a maioria dos atalhos de teclado. Isso evita conflitos no seu terminal. +O opencode usa uma tecla `leader` para a maioria dos atalhos de teclado. Isso evita conflitos no seu terminal. Por padrão, `ctrl+x` é a tecla líder e a maioria das ações requer que você primeiro pressione a tecla líder e depois o atalho. Por exemplo, para iniciar uma nova sessão, você primeiro pressiona `ctrl+x` e depois pressiona `n`. diff --git a/packages/web/src/content/docs/pt-br/lsp.mdx b/packages/web/src/content/docs/pt-br/lsp.mdx index 9dab7555f..6baf1813b 100644 --- a/packages/web/src/content/docs/pt-br/lsp.mdx +++ b/packages/web/src/content/docs/pt-br/lsp.mdx @@ -1,15 +1,15 @@ --- title: Servidores LSP -description: opencode integra-se aos seus servidores LSP. +description: O opencode integra-se aos seus servidores LSP. --- -opencode integra-se ao seu Protocolo de Servidor de Linguagem (LSP) para ajudar o LLM a interagir com sua base de código. Ele usa diagnósticos para fornecer feedback ao LLM. +O opencode integra-se ao seu Protocolo de Servidor de Linguagem (LSP) para ajudar o LLM a interagir com sua base de código. Ele usa diagnósticos para fornecer feedback ao LLM. --- -## Integrado +## Integrados -opencode vem com vários servidores LSP integrados para linguagens populares: +O opencode vem com vários servidores LSP integrados para linguagens populares: | Servidor LSP | Extensões | Requisitos | | ------------------ | ------------------------------------------------------------------- | ------------------------------------------------------------------------ | @@ -63,7 +63,7 @@ Quando o opencode abre um arquivo, ele: --- -## Configurar +## Configuração Você pode personalizar os servidores LSP através da seção `lsp` na sua configuração do opencode. diff --git a/packages/web/src/content/docs/pt-br/mcp-servers.mdx b/packages/web/src/content/docs/pt-br/mcp-servers.mdx index 597869035..a4d6c1bfb 100644 --- a/packages/web/src/content/docs/pt-br/mcp-servers.mdx +++ b/packages/web/src/content/docs/pt-br/mcp-servers.mdx @@ -21,7 +21,7 @@ Certos servidores MCP, como o servidor MCP do GitHub, tendem a adicionar muitos --- -## Habilitar +## Habilitando Você pode definir servidores MCP em sua [Configuração do opencode](https://opencode.ai/docs/config/) sob `mcp`. Adicione cada MCP com um nome único. Você pode se referir a esse MCP pelo nome ao solicitar ao LLM. @@ -216,7 +216,7 @@ Se você tiver credenciais de cliente do provedor do servidor MCP, pode configur --- -### Autenticando +### Autenticação Você pode iniciar manualmente a autenticação ou gerenciar credenciais. @@ -289,7 +289,7 @@ O comando `mcp debug` mostra o status de autenticação atual, testa a conectivi --- -## Gerenciar +## Gerenciamento Seus MCPs estão disponíveis como ferramentas no opencode, juntamente com ferramentas integradas. Portanto, você pode gerenciá-los através da configuração do opencode como qualquer outra ferramenta. diff --git a/packages/web/src/content/docs/pt-br/models.mdx b/packages/web/src/content/docs/pt-br/models.mdx index 078387783..3711bf110 100644 --- a/packages/web/src/content/docs/pt-br/models.mdx +++ b/packages/web/src/content/docs/pt-br/models.mdx @@ -3,7 +3,7 @@ title: Modelos description: Configurando um provedor e modelo LLM. --- -opencode usa o [AI SDK](https://ai-sdk.dev/) e [Models.dev](https://models.dev) para suportar **75+ provedores LLM** e suporta a execução de modelos locais. +O opencode usa o [AI SDK](https://ai-sdk.dev/) e [Models.dev](https://models.dev) para suportar **75+ provedores LLM** e suporta a execução de modelos locais. --- @@ -15,7 +15,7 @@ Saiba mais sobre [provedores](/docs/providers). --- -## Selecione um modelo +## Selecionando um modelo Depois de configurar seu provedor, você pode selecionar o modelo que deseja digitando: @@ -46,7 +46,7 @@ Aqui estão vários modelos que funcionam bem com o opencode, em nenhuma ordem e --- -## Defina um padrão +## Definindo um padrão Para definir um desses como o modelo padrão, você pode definir a chave `model` na sua configuração do opencode. @@ -63,7 +63,7 @@ Se você configurou um [provedor personalizado](/docs/providers#custom), o `prov --- -## Configurar modelos +## Configurando modelos Você pode configurar globalmente as opções de um modelo através da configuração. diff --git a/packages/web/src/content/docs/pt-br/modes.mdx b/packages/web/src/content/docs/pt-br/modes.mdx index 0eea196d8..62a7f947a 100644 --- a/packages/web/src/content/docs/pt-br/modes.mdx +++ b/packages/web/src/content/docs/pt-br/modes.mdx @@ -15,19 +15,19 @@ Você pode alternar entre os modos durante uma sessão ou configurá-los no seu --- -## Integrado +## Integrados O opencode vem com dois modos integrados. --- -### Build +### build Build é o modo **padrão** com todas as ferramentas habilitadas. Este é o modo padrão para trabalho de desenvolvimento onde você precisa de acesso total a operações de arquivos e comandos do sistema. --- -### Plan +### plan Um modo restrito projetado para planejamento e análise. No modo plan, as seguintes ferramentas estão desativadas por padrão: @@ -36,7 +36,7 @@ Um modo restrito projetado para planejamento e análise. No modo plan, as seguin - `patch` - Não pode aplicar patches - `bash` - Não pode executar comandos de shell -Este modo é útil quando você deseja que a AI analise o código, sugira alterações ou crie planos sem fazer modificações reais em sua base de código. +Este modo é útil quando você deseja que a IA analise o código, sugira alterações ou crie planos sem fazer modificações reais em sua base de código. --- @@ -48,7 +48,7 @@ Veja também: [Formatadores](/docs/formatters) para informações sobre configur --- -## Configurar +## Configuração Você pode personalizar os modos integrados ou criar os seus próprios através da configuração. Os modos podem ser configurados de duas maneiras: @@ -132,7 +132,7 @@ Use a configuração `model` para substituir o modelo padrão para este modo. Ú ### Temperatura -Controle a aleatoriedade e a criatividade das respostas da AI com a configuração `temperature`. Valores mais baixos tornam as respostas mais focadas e determinísticas, enquanto valores mais altos aumentam a criatividade e a variabilidade. +Controle a aleatoriedade e a criatividade das respostas da IA com a configuração `temperature`. Valores mais baixos tornam as respostas mais focadas e determinísticas, enquanto valores mais altos aumentam a criatividade e a variabilidade. ```json title="opencode.json" { diff --git a/packages/web/src/content/docs/pt-br/network.mdx b/packages/web/src/content/docs/pt-br/network.mdx index 25052ae12..1e13f258c 100644 --- a/packages/web/src/content/docs/pt-br/network.mdx +++ b/packages/web/src/content/docs/pt-br/network.mdx @@ -3,13 +3,13 @@ title: Rede description: Configure proxies e certificados personalizados. --- -opencode suporta variáveis de ambiente de proxy padrão e certificados personalizados para ambientes de rede corporativa. +O opencode suporta variáveis de ambiente de proxy padrão e certificados personalizados para ambientes de rede corporativa. --- ## Proxy -opencode respeita variáveis de ambiente de proxy padrão. +O opencode respeita variáveis de ambiente de proxy padrão. ```bash # HTTPS proxy (recommended) @@ -30,7 +30,7 @@ Você pode configurar a porta e o nome do host do servidor usando [flags da CLI] --- -### Autenticar +### Autenticação Se o seu proxy requer autenticação básica, inclua as credenciais na URL. diff --git a/packages/web/src/content/docs/pt-br/permissions.mdx b/packages/web/src/content/docs/pt-br/permissions.mdx index 13299e576..a815e7313 100644 --- a/packages/web/src/content/docs/pt-br/permissions.mdx +++ b/packages/web/src/content/docs/pt-br/permissions.mdx @@ -3,7 +3,7 @@ title: Permissões description: Controle quais ações requerem aprovação para serem executadas. --- -opencode usa a configuração `permission` para decidir se uma determinada ação deve ser executada automaticamente, solicitar sua aprovação ou ser bloqueada. +O opencode usa a configuração `permission` para decidir se uma determinada ação deve ser executada automaticamente, solicitar sua aprovação ou ser bloqueada. A partir da versão `v1.1.1`, a configuração booleana legada `tools` foi descontinuada e mesclada na `permission`. A antiga configuração `tools` ainda é suportada para compatibilidade retroativa. diff --git a/packages/web/src/content/docs/pt-br/plugins.mdx b/packages/web/src/content/docs/pt-br/plugins.mdx index eed62df67..bcf8f379b 100644 --- a/packages/web/src/content/docs/pt-br/plugins.mdx +++ b/packages/web/src/content/docs/pt-br/plugins.mdx @@ -9,7 +9,7 @@ Para exemplos, confira os [plugins](/docs/ecosystem#plugins) criados pela comuni --- -## Usar um plugin +## Usando um plugin Existem duas maneiras de carregar plugins. @@ -64,7 +64,7 @@ Pacotes npm duplicados com o mesmo nome e versão são carregados uma vez. No en --- -## Criar um plugin +## Criando um plugin Um plugin é um **módulo JavaScript/TypeScript** que exporta uma ou mais funções de plugin. Cada função recebe um objeto de contexto e retorna um objeto de hooks. @@ -214,7 +214,7 @@ Aqui estão alguns exemplos de plugins que você pode usar para estender o openc --- -### Enviar notificações +### Enviando notificações Envie notificações quando certos eventos ocorrerem: @@ -257,7 +257,7 @@ export const EnvProtection = async ({ project, client, $, directory, worktree }) --- -### Injetar variáveis de ambiente +### Injetando variáveis de ambiente Injete variáveis de ambiente em todas as execuções de shell (ferramentas de AI e terminais de usuário): diff --git a/packages/web/src/content/docs/pt-br/providers.mdx b/packages/web/src/content/docs/pt-br/providers.mdx index c07844de8..43f2e385f 100644 --- a/packages/web/src/content/docs/pt-br/providers.mdx +++ b/packages/web/src/content/docs/pt-br/providers.mdx @@ -258,11 +258,11 @@ Para perfis de inferência personalizados, use o nome do modelo e do provedor na 2. Aqui você pode selecionar a opção **Claude Pro/Max** e isso abrirá seu navegador e pedirá para você se autenticar. ```txt - ┌ Select auth method + ┌ Selecione o método de autenticação │ │ Claude Pro/Max - │ Create an API Key - │ Manually enter API Key + │ Criar uma chave de API + │ Inserir manualmente a chave de API └ ``` @@ -278,9 +278,9 @@ Usar sua assinatura Claude Pro/Max no opencode não é oficialmente suportado pe ##### Usando chaves da API -Você também pode selecionar **Criar uma chave da API** se não tiver uma assinatura Pro/Max. Isso também abrirá seu navegador e pedirá que você faça login na Anthropic e lhe dará um código que você pode colar no seu terminal. +Você também pode selecionar **Criar uma chave de API** se não tiver uma assinatura Pro/Max. Isso também abrirá seu navegador e pedirá que você faça login na Anthropic e lhe dará um código que você pode colar no seu terminal. -Ou, se você já tiver uma chave da API, pode selecionar **Inserir chave da API manualmente** e colá-la no seu terminal. +Ou, se você já tiver uma chave da API, pode selecionar **Inserir manualmente a chave de API** e colá-la no seu terminal. --- @@ -642,10 +642,10 @@ GitLab Duo fornece um chat agente com suporte a ferramentas nativas através do 2. Escolha seu método de autenticação: ```txt - ┌ Select auth method + ┌ Selecione o método de autenticação │ - │ OAuth (Recommended) - │ Personal Access Token + │ OAuth (Recomendado) + │ Token de Acesso Pessoal └ ``` @@ -797,13 +797,13 @@ Alguns modelos precisam ser habilitados manualmente nas suas [configurações do 2. Navegue até [github.com/login/device](https://github.com/login/device) e insira o código. ```txt - ┌ Login with GitHub Copilot + ┌ Login com GitHub Copilot │ │ https://github.com/login/device │ - │ Enter code: 8F43-6FCF + │ Digite o código: 8F43-6FCF │ - └ Waiting for authorization... + └ Aguardando autorização... ``` 3. Agora execute o comando `/models` para selecionar o modelo que você deseja. @@ -1305,10 +1305,10 @@ Recomendamos se inscrever para [ChatGPT Plus ou Pro](https://chatgpt.com/pricing 2. Aqui você pode selecionar a opção **ChatGPT Plus/Pro** e isso abrirá seu navegador e pedirá para você se autenticar. ```txt - ┌ Select auth method + ┌ Selecione o método de autenticação │ │ ChatGPT Plus/Pro - │ Manually enter API Key + │ Inserir manualmente a chave de API └ ``` @@ -1749,11 +1749,12 @@ Você pode usar qualquer provedor compatível com OpenAI com o opencode. A maior ```bash $ /connect - ┌ Add credential + ┌ Adicionar credencial │ - ◆ Select provider - │ ... - │ ● Other + ▲ Isso armazena apenas uma credencial para myprovider - você precisará configurá-lo no opencode.json, verifique a documentação para exemplos. + │ + ◇ Digite sua chave de API + │ sk-... └ ``` @@ -1762,10 +1763,12 @@ Você pode usar qualquer provedor compatível com OpenAI com o opencode. A maior ```bash $ /connect - ┌ Add credential + ┌ Adicionar credencial │ - ◇ Enter provider id - │ myprovider + ▲ Isso armazena apenas uma credencial para myprovider - você precisará configurá-lo no opencode.json, verifique a documentação para exemplos. + │ + ◇ Digite sua chave de API + │ sk-... └ ``` @@ -1778,11 +1781,11 @@ Você pode usar qualquer provedor compatível com OpenAI com o opencode. A maior ```bash $ /connect - ┌ Add credential + ┌ Adicionar credencial │ - ▲ This only stores a credential for myprovider - you will need to configure it in opencode.json, check the docs for examples. + ▲ Isso armazena apenas uma credencial para myprovider - você precisará configurá-lo no opencode.json, verifique a documentação para exemplos. │ - ◇ Enter your API key + ◇ Digite sua chave de API │ sk-... └ ``` @@ -1795,16 +1798,18 @@ Você pode usar qualquer provedor compatível com OpenAI com o opencode. A maior "provider": { "myprovider": { "npm": "@ai-sdk/openai-compatible", - "name": "My AI ProviderDisplay Name", + "name": "Nome de Exibição do Meu Provedor de IA", "options": { "baseURL": "https://api.myprovider.com/v1" }, "models": { "my-model-name": { - "name": "My Model Display Name" + "name": "Nome de Exibição do Meu Modelo" } } } + } + } } } ``` @@ -1833,7 +1838,7 @@ Aqui está um exemplo definindo as opções `apiKey`, `headers` e `limit` do mod "provider": { "myprovider": { "npm": "@ai-sdk/openai-compatible", - "name": "My AI ProviderDisplay Name", + "name": "Nome de Exibição do Meu Provedor de IA", "options": { "baseURL": "https://api.myprovider.com/v1", "apiKey": "{env:ANTHROPIC_API_KEY}", @@ -1843,7 +1848,19 @@ Aqui está um exemplo definindo as opções `apiKey`, `headers` e `limit` do mod }, "models": { "my-model-name": { - "name": "My Model Display Name", + "name": "Nome de Exibição do Meu Modelo", + "limit": { + "context": 200000, + "output": 65536 + } + } + } + } + } + }, + "models": { + "my-model-name": { + "name": "Nome de Exibição do Meu Modelo", "limit": { "context": 200000, "output": 65536 diff --git a/packages/web/src/content/docs/pt-br/tools.mdx b/packages/web/src/content/docs/pt-br/tools.mdx index 74b4757a0..53f962485 100644 --- a/packages/web/src/content/docs/pt-br/tools.mdx +++ b/packages/web/src/content/docs/pt-br/tools.mdx @@ -9,7 +9,7 @@ Por padrão, todas as ferramentas estão **ativadas** e não precisam de permiss --- -## Configurar +## Configuração Use o campo `permission` para controlar o comportamento das ferramentas. Você pode permitir, negar ou exigir aprovação para cada ferramenta. diff --git a/packages/web/src/content/docs/pt-br/troubleshooting.mdx b/packages/web/src/content/docs/pt-br/troubleshooting.mdx index 2d0009243..aa70e80fe 100644 --- a/packages/web/src/content/docs/pt-br/troubleshooting.mdx +++ b/packages/web/src/content/docs/pt-br/troubleshooting.mdx @@ -22,7 +22,7 @@ Você pode definir o nível de log com a opção de linha de comando `--log-leve ## Armazenamento -opencode armazena dados de sessão e outros dados do aplicativo no disco em: +O opencode armazena dados de sessão e outros dados do aplicativo no disco em: - **macOS/Linux**: `~/.local/share/opencode/` - **Windows**: Pressione `WIN+R` e cole `%USERPROFILE%\.local\share\opencode` @@ -39,7 +39,7 @@ Este diretório contém: ## Aplicativo de Desktop -opencode Desktop executa um servidor opencode local (o sidecar `opencode-cli`) em segundo plano. A maioria dos problemas é causada por um plugin com mau funcionamento, um cache corrompido ou uma configuração de servidor incorreta. +O opencode Desktop executa um servidor opencode local (o sidecar `opencode-cli`) em segundo plano. A maioria dos problemas é causada por um plugin com mau funcionamento, um cache corrompido ou uma configuração de servidor incorreta. ### Verificações rápidas @@ -49,11 +49,11 @@ opencode Desktop executa um servidor opencode local (o sidecar `opencode-cli`) e --- -### Desativar plugins +### Desativando plugins Se o aplicativo de desktop estiver travando ao iniciar, pendurado ou se comportando de maneira estranha, comece desativando os plugins. -#### Verifique a configuração global +#### Verificando a configuração global Abra seu arquivo de configuração global e procure uma chave `plugin`. @@ -70,9 +70,9 @@ Se você tiver plugins configurados, desative-os temporariamente removendo a cha } ``` -#### Verifique os diretórios de plugins +#### Verificando os diretórios de plugins -opencode também pode carregar plugins locais do disco. Mova-os temporariamente para fora do caminho (ou renomeie a pasta) e reinicie o aplicativo de desktop: +O opencode também pode carregar plugins locais do disco. Mova-os temporariamente para fora do caminho (ou renomeie a pasta) e reinicie o aplicativo de desktop: - **Plugins globais** - **macOS/Linux**: `~/.config/opencode/plugins/` @@ -84,7 +84,7 @@ Se o aplicativo voltar a funcionar, reative os plugins um por um para descobrir --- -### Limpar o cache +### Limpando o cache Se desativar plugins não ajudar (ou se a instalação de um plugin estiver travada), limpe o cache para que o opencode possa reconstruí-lo. @@ -99,21 +99,21 @@ Se desativar plugins não ajudar (ou se a instalação de um plugin estiver trav --- -### Corrigir problemas de conexão com o servidor +### Corrigindo problemas de conexão com o servidor -opencode Desktop pode iniciar seu próprio servidor local (padrão) ou conectar-se a uma URL de servidor que você configurou. +O opencode Desktop pode iniciar seu próprio servidor local (padrão) ou conectar-se a uma URL de servidor que você configurou. Se você ver um diálogo **"Conexão Falhou"** (ou o aplicativo nunca passa da tela de inicialização), verifique se há uma URL de servidor personalizada. -#### Limpar a URL do servidor padrão do desktop +#### Limpando a URL do servidor padrão do desktop Na tela inicial, clique no nome do servidor (com o ponto de status) para abrir o seletor de Servidor. Na seção **Servidor padrão**, clique em **Limpar**. -#### Remover `server.port` / `server.hostname` da sua configuração +#### Removendo `server.port` / `server.hostname` da sua configuração Se seu `opencode.json(c)` contiver uma seção `server`, remova-a temporariamente e reinicie o aplicativo de desktop. -#### Verifique as variáveis de ambiente +#### Verificando as variáveis de ambiente Se você tiver `OPENCODE_PORT` definido em seu ambiente, o aplicativo de desktop tentará usar essa porta para o servidor local. @@ -130,7 +130,7 @@ No Linux, algumas configurações do Wayland podem causar janelas em branco ou e --- -### Windows: WebView2 runtime +### Windows: Runtime do WebView2 No Windows, o opencode Desktop requer o **WebView2 Runtime** do Microsoft Edge. Se o aplicativo abrir em uma janela em branco ou não iniciar, instale/atualize o WebView2 e tente novamente. @@ -151,7 +151,7 @@ O opencode Desktop só mostra notificações do sistema quando: --- -### Redefinir o armazenamento do aplicativo de desktop (último recurso) +### Redefinindo o armazenamento do aplicativo de desktop (último recurso) Se o aplicativo não iniciar e você não conseguir limpar as configurações pela interface, redefina o estado salvo do aplicativo de desktop. @@ -195,7 +195,7 @@ Aqui estão alguns problemas comuns e como resolvê-los. --- -### opencode não inicia +### O opencode não inicia 1. Verifique os logs em busca de mensagens de erro 2. Tente executar com `--print-logs` para ver a saída no terminal @@ -251,7 +251,7 @@ Para resolver isso: ### AI_APICallError e problemas com pacotes de provedores -Se você encontrar erros de chamada de API, isso pode ser devido a pacotes de provedores desatualizados. opencode instala dinamicamente pacotes de provedores (OpenAI, Anthropic, Google, etc.) conforme necessário e os armazena em cache localmente. +Se você encontrar erros de chamada de API, isso pode ser devido a pacotes de provedores desatualizados. O opencode instala dinamicamente pacotes de provedores (OpenAI, Anthropic, Google, etc.) conforme necessário e os armazena em cache localmente. Para resolver problemas com pacotes de provedores: @@ -296,4 +296,4 @@ Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 & export DISPLAY=:99.0 ``` -opencode detectará se você está usando Wayland e preferirá `wl-clipboard`, caso contrário, tentará encontrar ferramentas de área de transferência na ordem: `xclip` e `xsel`. +O opencode detectará se você está usando Wayland e preferirá `wl-clipboard`, caso contrário, tentará encontrar ferramentas de área de transferência na ordem: `xclip` e `xsel`. diff --git a/packages/web/src/content/docs/pt-br/tui.mdx b/packages/web/src/content/docs/pt-br/tui.mdx index 3199c842c..17b9c7de0 100644 --- a/packages/web/src/content/docs/pt-br/tui.mdx +++ b/packages/web/src/content/docs/pt-br/tui.mdx @@ -5,7 +5,7 @@ description: Usando a interface de usuário de terminal opencode. import { Tabs, TabItem } from "@astrojs/starlight/components" -opencode fornece uma interface de terminal interativa ou TUI para trabalhar em seus projetos com um LLM. +O opencode fornece uma interface de terminal interativa ou TUI para trabalhar em seus projetos com um LLM. Executar opencode inicia o TUI para o diretório atual. @@ -22,7 +22,7 @@ opencode /path/to/project Uma vez que você esteja no TUI, você pode solicitar com uma mensagem. ```text -Give me a quick summary of the codebase. +Faça um resumo rápido da base de código. ``` --- @@ -36,7 +36,7 @@ Você também pode usar `@` para referenciar arquivos em suas mensagens. ::: ```text "@packages/functions/src/api/index.ts" -How is auth handled in @packages/functions/src/api/index.ts? +Como a autenticação é tratada em @packages/functions/src/api/index.ts? ``` O conteúdo do arquivo é adicionado à conversa automaticamente. @@ -290,12 +290,12 @@ Tanto os comandos `/editor` quanto `/export` usam o editor especificado na sua v ```bash - # Example for nano or vim + # Exemplo para nano ou vim export EDITOR=nano export EDITOR=vim - # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc. - # include --wait + # Para editores GUI, VS Code, Cursor, VSCodium, Windsurf, Zed, etc. + # inclua --wait export EDITOR="code --wait" ``` @@ -308,8 +308,8 @@ Tanto os comandos `/editor` quanto `/export` usam o editor especificado na sua v ```bash set EDITOR=notepad - # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc. - # include --wait + # Para editores GUI, VS Code, Cursor, VSCodium, Windsurf, Zed, etc. + # inclua --wait set EDITOR=code --wait ``` @@ -321,8 +321,8 @@ Tanto os comandos `/editor` quanto `/export` usam o editor especificado na sua v ```powershell $env:EDITOR = "notepad" - # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc. - # include --wait + # Para editores GUI, VS Code, Cursor, VSCodium, Windsurf, Zed, etc. + # inclua --wait $env:EDITOR = "code --wait" ``` @@ -350,7 +350,7 @@ Alguns editores precisam de argumentos de linha de comando para rodar em modo bl --- -## Configurar +## Configuração Você pode personalizar o comportamento do TUI através do seu arquivo de configuração do opencode. diff --git a/packages/web/src/content/docs/pt-br/web.mdx b/packages/web/src/content/docs/pt-br/web.mdx index 3382c700a..5338a4ce4 100644 --- a/packages/web/src/content/docs/pt-br/web.mdx +++ b/packages/web/src/content/docs/pt-br/web.mdx @@ -1,13 +1,13 @@ --- title: Web -description: Usando opencode no seu navegador. +description: Usando o opencode no seu navegador. --- -opencode pode ser executado como uma aplicação web no seu navegador, proporcionando a mesma poderosa experiência de codificação com AI sem precisar de um terminal. +O opencode pode ser executado como uma aplicação web no seu navegador, proporcionando a mesma poderosa experiência de codificação com IA sem precisar de um terminal. ![opencode Web - Nova Sessão](../../../assets/web/web-homepage-new-session.png) -## Começando +## Primeiros passos Inicie a interface web executando: diff --git a/packages/web/src/content/docs/pt-br/windows-wsl.mdx b/packages/web/src/content/docs/pt-br/windows-wsl.mdx index 67fdc65f5..a4b9ac11a 100644 --- a/packages/web/src/content/docs/pt-br/windows-wsl.mdx +++ b/packages/web/src/content/docs/pt-br/windows-wsl.mdx @@ -1,11 +1,11 @@ --- title: Windows (WSL) -description: Execute o opencode no Windows com WSL para melhor experiencia. +description: Execute o opencode no Windows com WSL para melhor experiência. --- import { Steps } from "@astrojs/starlight/components" -Embora o opencode possa rodar direto no Windows, recomendamos usar [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) para a melhor experiencia. O WSL oferece um ambiente Linux que funciona de forma integrada com os recursos do opencode. +Embora o opencode possa rodar direto no Windows, recomendamos usar [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) para a melhor experiência. O WSL oferece um ambiente Linux que funciona de forma integrada com os recursos do opencode. :::tip[Por que WSL?] O WSL oferece melhor desempenho de sistema de arquivos, suporte completo a terminal e compatibilidade com as ferramentas de desenvolvimento das quais o opencode depende. @@ -13,17 +13,17 @@ O WSL oferece melhor desempenho de sistema de arquivos, suporte completo a termi --- -## Configuracao +## Configuração 1. **Instale o WSL** - Se ainda nao instalou, [instale o WSL](https://learn.microsoft.com/en-us/windows/wsl/install) usando o guia oficial da Microsoft. + Se ainda não instalou, [instale o WSL](https://learn.microsoft.com/en-us/windows/wsl/install) usando o guia oficial da Microsoft. 2. **Instale o opencode no WSL** - Depois de configurar o WSL, abra o terminal do WSL e instale o opencode usando um dos [metodos de instalacao](/docs/). + Depois de configurar o WSL, abra o terminal do WSL e instale o opencode usando um dos [métodos de instalação](/docs/). ```bash curl -fsSL https://opencode.ai/install | bash @@ -31,7 +31,7 @@ O WSL oferece melhor desempenho de sistema de arquivos, suporte completo a termi 3. **Use o opencode pelo WSL** - Va para o diretorio do seu projeto (acesse arquivos do Windows via `/mnt/c/`, `/mnt/d/` etc.) e execute o opencode. + Vá para o diretório do seu projeto (acesse arquivos do Windows via `/mnt/c/`, `/mnt/d/` etc.) e execute o opencode. ```bash cd /mnt/c/Users/YourName/project @@ -44,9 +44,9 @@ O WSL oferece melhor desempenho de sistema de arquivos, suporte completo a termi ## App desktop + servidor WSL -Se voce prefere usar o app desktop do opencode, mas quer rodar o servidor no WSL: +Se você prefere usar o app desktop do opencode, mas quer rodar o servidor no WSL: -1. **Inicie o servidor no WSL** com `--hostname 0.0.0.0` para permitir conexoes externas: +1. **Inicie o servidor no WSL** com `--hostname 0.0.0.0` para permitir conexões externas: ```bash opencode serve --hostname 0.0.0.0 --port 4096 @@ -55,7 +55,7 @@ Se voce prefere usar o app desktop do opencode, mas quer rodar o servidor no WSL 2. **Conecte o app desktop** em `http://localhost:4096` :::note -Se `localhost` nao funcionar no seu ambiente, conecte usando o IP do WSL (no WSL: `hostname -I`) e use `http://:4096`. +Se `localhost` não funcionar no seu ambiente, conecte usando o IP do WSL (no WSL: `hostname -I`) e use `http://:4096`. ::: :::caution @@ -71,7 +71,7 @@ OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0 ## Cliente web + WSL -Para a melhor experiencia web no Windows: +Para a melhor experiência web no Windows: 1. **Execute `opencode web` no terminal WSL** em vez do PowerShell: @@ -81,13 +81,13 @@ Para a melhor experiencia web no Windows: 2. **Acesse pelo navegador do Windows** em `http://localhost:` (o opencode mostra a URL) -Executar `opencode web` a partir do WSL garante acesso correto ao sistema de arquivos e integracao com o terminal, continuando acessivel no navegador do Windows. +Executar `opencode web` a partir do WSL garante acesso correto ao sistema de arquivos e integração com o terminal, continuando acessível no navegador do Windows. --- ## Acessar arquivos do Windows -O WSL pode acessar todos os arquivos do Windows pelo diretorio `/mnt/`: +O WSL pode acessar todos os arquivos do Windows pelo diretório `/mnt/`: - Unidade `C:` → `/mnt/c/` - Unidade `D:` → `/mnt/d/` @@ -101,7 +101,7 @@ opencode ``` :::tip -Para uma experiencia mais fluida, considere clonar/copiar seu repositorio para o sistema de arquivos do WSL (por exemplo em `~/code/`) e executar o opencode por la. +Para uma experiência mais fluida, considere clonar/copiar seu repositório para o sistema de arquivos do WSL (por exemplo em `~/code/`) e executar o opencode por lá. ::: --- @@ -109,5 +109,5 @@ Para uma experiencia mais fluida, considere clonar/copiar seu repositorio para o ## Dicas - Mantenha o opencode rodando no WSL para projetos armazenados em unidades do Windows - o acesso aos arquivos fica fluido -- Use a [extensao WSL do VS Code](https://code.visualstudio.com/docs/remote/wsl) junto com o opencode para um fluxo de desenvolvimento integrado -- Sua configuracao e suas sessoes do opencode ficam armazenadas no ambiente WSL em `~/.local/share/opencode/` +- Use a [extensão WSL do VS Code](https://code.visualstudio.com/docs/remote/wsl) junto com o opencode para um fluxo de desenvolvimento integrado +- Sua configuração e suas sessões do opencode ficam armazenadas no ambiente WSL em `~/.local/share/opencode/` diff --git a/packages/web/src/content/docs/pt-br/zen.mdx b/packages/web/src/content/docs/pt-br/zen.mdx index c472cf60f..203f0b3f9 100644 --- a/packages/web/src/content/docs/pt-br/zen.mdx +++ b/packages/web/src/content/docs/pt-br/zen.mdx @@ -1,28 +1,28 @@ --- title: Zen -description: Lista selecionada de modelos fornecidos pela opencode. +description: Lista selecionada de modelos fornecidos pelo opencode. --- import config from "../../../../config.mjs" export const console = config.console export const email = `mailto:${config.email}` -OpenCode Zen é uma lista de modelos testados e verificados fornecidos pela equipe da opencode. +O OpenCode Zen é uma lista de modelos testados e verificados fornecidos pela equipe do opencode. :::note -OpenCode Zen está atualmente em beta. +O OpenCode Zen está atualmente em beta. ::: -Zen funciona como qualquer outro provedor na opencode. Você faz login no OpenCode Zen e obtém sua chave de API. É **completamente opcional** e você não precisa usá-la para utilizar a opencode. +O Zen funciona como qualquer outro provedor no opencode. Você faz login no OpenCode Zen e obtém sua chave de API. É **completamente opcional** e você não precisa usá-lo para utilizar o opencode. --- ## Contexto -Existem um grande número de modelos disponíveis, mas apenas alguns desses modelos funcionam bem como agentes de codificação. Além disso, a maioria dos provedores é configurada de maneira muito diferente; portanto, você obtém desempenhos e qualidades muito diferentes. +Existe um grande número de modelos disponíveis, mas apenas alguns desses modelos funcionam bem como agentes de codificação. Além disso, a maioria dos provedores é configurada de maneira muito diferente; portanto, você obtém desempenhos e qualidades muito diferentes. :::tip -Testamos um grupo selecionado de modelos e provedores que funcionam bem com a opencode. +Testamos um grupo selecionado de modelos e provedores que funcionam bem com o opencode. ::: Portanto, se você estiver usando um modelo através de algo como OpenRouter, você nunca pode ter certeza se está obtendo a melhor versão do modelo que deseja. @@ -33,17 +33,17 @@ Para resolver isso, fizemos algumas coisas: 2. Trabalhamos com alguns provedores para garantir que esses modelos estivessem sendo servidos corretamente. 3. Finalmente, realizamos benchmarks da combinação modelo/provedor e elaboramos uma lista que nos sentimos bem em recomendar. -OpenCode Zen é um gateway de AI que lhe dá acesso a esses modelos. +O OpenCode Zen é um gateway de IA que lhe dá acesso a esses modelos. --- ## Como funciona -OpenCode Zen funciona como qualquer outro provedor na opencode. +O OpenCode Zen funciona como qualquer outro provedor no opencode. 1. Você faz login no **OpenCode Zen**, adiciona seus dados de cobrança e copia sua chave de API. -2. Você executa o comando `/connect` na TUI, seleciona OpenCode Zen e cola sua chave de API. -3. Execute `/models` na TUI para ver a lista de modelos que recomendamos. +2. Você executa o comando `/connect` no TUI, seleciona OpenCode Zen e cola sua chave de API. +3. Execute `/models` no TUI para ver a lista de modelos que recomendamos. Você é cobrado por solicitação e pode adicionar créditos à sua conta. @@ -85,7 +85,7 @@ Você também pode acessar nossos modelos através dos seguintes endpoints da AP | 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` | -O [id do modelo](/docs/config/#models) na sua configuração da opencode usa o formato `opencode/`. Por exemplo, para GPT 5.2 Codex, você usaria `opencode/gpt-5.2-codex` na sua configuração. +O [id do modelo](/docs/config/#models) na sua configuração do opencode usa o formato `opencode/`. Por exemplo, para GPT 5.2 Codex, você usaria `opencode/gpt-5.2-codex` na sua configuração. --- @@ -147,10 +147,10 @@ As taxas de cartão de crédito são repassadas ao custo (4,4% + $0,30 por trans Os modelos gratuitos: -- GLM 4.7 Free está disponível na opencode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo. -- Kimi K2.5 Free está disponível na opencode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo. -- MiniMax M2.1 Free está disponível na opencode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo. -- Big Pickle é um modelo oculto que está gratuito na opencode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo. +- GLM 4.7 Free está disponível no opencode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo. +- Kimi K2.5 Free está disponível no opencode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo. +- MiniMax M2.1 Free está disponível no opencode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo. +- Big Pickle é um modelo oculto que está gratuito no opencode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo. Entre em contato conosco se você tiver alguma dúvida. @@ -158,7 +158,7 @@ Os modelos gratuitos: ### Recarga automática -Se seu saldo cair abaixo de $5, Zen recarregará automaticamente $20. +Se seu saldo cair abaixo de $5, o Zen recarregará automaticamente $20. Você pode alterar o valor da recarga automática. Você também pode desativar a recarga automática completamente. @@ -168,7 +168,7 @@ Você pode alterar o valor da recarga automática. Você também pode desativar Você também pode definir um limite de uso mensal para todo o espaço de trabalho e para cada membro de sua equipe. -Por exemplo, digamos que você defina um limite de uso mensal de $20, Zen não usará mais de $20 em um mês. Mas se você tiver a recarga automática ativada, Zen pode acabar cobrando mais de $20 se seu saldo cair abaixo de $5. +Por exemplo, digamos que você defina um limite de uso mensal de $20, o Zen não usará mais de $20 em um mês. Mas se você tiver a recarga automática ativada, o Zen pode acabar cobrando mais de $20 se seu saldo cair abaixo de $5. --- @@ -187,7 +187,7 @@ Todos os nossos modelos estão hospedados nos EUA. Nossos provedores seguem uma ## Para Equipes -Zen também funciona muito bem para equipes. Você pode convidar colegas de equipe, atribuir funções, selecionar os modelos que sua equipe usa e muito mais. +O Zen também funciona muito bem para equipes. Você pode convidar colegas de equipe, atribuir funções, selecionar os modelos que sua equipe usa e muito mais. :::note Os espaços de trabalho estão atualmente gratuitos para equipes como parte do beta. @@ -233,4 +233,4 @@ Criamos o OpenCode Zen para: 1. **Benchmark** os melhores modelos/provedores para agentes de codificação. 2. Ter acesso às opções de **mais alta qualidade** e não degradar o desempenho ou redirecionar para provedores mais baratos. 3. Repassar quaisquer **reduções de preço** vendendo ao custo; assim, a única margem é para cobrir nossas taxas de processamento. -4. Não ter **vinculação** permitindo que você o use com qualquer outro agente de codificação. E sempre permitir que você use qualquer outro provedor com a opencode também. +4. Não ter **vinculação** permitindo que você o use com qualquer outro agente de codificação. E sempre permitir que você use qualquer outro provedor com o opencode também. diff --git a/packages/web/src/content/docs/ru/acp.mdx b/packages/web/src/content/docs/ru/acp.mdx index 92cb8d7a2..c4a6132fe 100644 --- a/packages/web/src/content/docs/ru/acp.mdx +++ b/packages/web/src/content/docs/ru/acp.mdx @@ -3,17 +3,17 @@ title: Поддержка ACP description: Используйте opencode в любом ACP-совместимом редакторе. --- -opencode поддерживает [Agent Client Protocol](https://agentclientprotocol.com) или (ACP), что позволяет использовать его непосредственно в совместимых редакторах и IDE. +opencode поддерживает [Agent Client Protocol](https://agentclientprotocol.com) (ACP), что позволяет использовать его непосредственно в совместимых редакторах и IDE. :::tip Список редакторов и инструментов, поддерживающих ACP, можно найти в [отчете о ходе работы ACP](https://zed.dev/blog/acp-progress-report#available-now). ::: -ACP — это открытый протокол, который стандартизирует связь между редакторами кода и агентами кодирования ИИ. +ACP — это открытый протокол, который стандартизирует взаимодействие между редакторами кода и ИИ-агентами. --- -## Настроить +## Настройка Чтобы использовать opencode через ACP, настройте свой редактор для запуска команды `opencode acp`. diff --git a/packages/web/src/content/docs/ru/agents.mdx b/packages/web/src/content/docs/ru/agents.mdx index 5d4d9b03f..f515c15d7 100644 --- a/packages/web/src/content/docs/ru/agents.mdx +++ b/packages/web/src/content/docs/ru/agents.mdx @@ -27,8 +27,7 @@ description: Настройте и используйте специализир Вы можете использовать клавишу **Tab** для переключения между основными агентами во время сеанса. ::: -opencode поставляется с двумя встроенными основными агентами: **Build** и **Plan**. Хорошо -посмотрите на это ниже. +opencode поставляется с двумя встроенными основными агентами: **Build** и **Plan**. Мы рассмотрим их ниже. --- @@ -40,13 +39,13 @@ opencode поставляется с двумя встроенными суба --- -## Встроенный +## Встроенные агенты opencode поставляется с двумя встроенными основными агентами и двумя встроенными субагентами. --- -### Use Build +### Использование Build _Режим_: `primary` @@ -54,7 +53,7 @@ Build — основной агент **по умолчанию** со всем --- -### Use Plan +### Использование Plan _Режим_: `primary` @@ -68,7 +67,7 @@ _Режим_: `primary` --- -### Use General +### Использование General _Режим_: `subagent` @@ -76,7 +75,7 @@ _Режим_: `subagent` --- -### Use Explore +### Использование Explore _Режим_: `subagent` @@ -84,7 +83,7 @@ _Режим_: `subagent` --- -### Use Compact +### Использование Compact _Режим_: `primary` @@ -92,7 +91,7 @@ _Режим_: `primary` --- -### Use Title +### Использование Title _Режим_: `primary` @@ -100,7 +99,7 @@ _Режим_: `primary` --- -### Use Summary +### Использование Summary _Режим_: `primary` @@ -128,7 +127,7 @@ _Режим_: `primary` --- -## Настроить +## Настройка Вы можете настроить встроенные агенты или создать свои собственные посредством настройки. Агенты можно настроить двумя способами: @@ -256,7 +255,7 @@ Provide constructive feedback without making direct changes. Значения температуры обычно находятся в диапазоне от 0,0 до 1,0: - **0,0–0,2**: очень целенаправленные и детерминированные ответы, идеальные для анализа кода и планирования. -- **0,3–0,5**: сбалансированные ответы с некоторой креативностью, подходят для общих задач развития. +- **0,3–0,5**: сбалансированные ответы с некоторой креативностью, подходят для общих задач разработки. - **0,6–1,0**: более творческие и разнообразные ответы, полезные для мозгового штурма и исследования. ```json title="opencode.json" @@ -307,7 +306,7 @@ Provide constructive feedback without making direct changes. --- -### Запрещать +### Отключение Установите `true`, чтобы отключить агент. @@ -323,7 +322,7 @@ Provide constructive feedback without making direct changes. --- -### Prompt +### Промпт Укажите собственный файл системных приглашений для этого агента с помощью конфигурации `prompt`. Файл подсказки должен содержать инструкции, специфичные для целей агента. @@ -631,11 +630,11 @@ Only analyze code and suggest changes. } ``` -Значения варьируются от 0,0 до 1,0. Низкие ценности более целенаправленны, высшие ценности более разнообразны. +Значения варьируются от 0,0 до 1,0. Низкие значения делают ответы более целенаправленными, высокие — более разнообразными. --- -### Extra +### Дополнительно Любые другие параметры, указанные вами в конфигурации вашего агента, будут **передаваться напрямую** поставщику в качестве параметров модели. Это позволяет использовать функции и параметры, специфичные для поставщика. @@ -672,11 +671,11 @@ opencode agent create Эта интерактивная команда: -1. Спросить, где сохранить агента; глобальный или специфичный для проекта. -2. Описание того, что должен делать агент. -3. Создайте соответствующее системное приглашение и идентификатор. -4. Позволяет вам выбрать, к каким инструментам может получить доступ агент. -5. Наконец, создайте файл Markdown с конфигурацией агента. +1. Спрашивает, где сохранить агента: глобально или в проекте. +2. Запрашивает описание того, что должен делать агент. +3. Создает соответствующий системный промпт и идентификатор. +4. Позволяет выбрать, к каким инструментам агент будет иметь доступ. +5. Наконец, создает файл Markdown с конфигурацией агента. --- diff --git a/packages/web/src/content/docs/ru/cli.mdx b/packages/web/src/content/docs/ru/cli.mdx index ebe988d2c..1a1003a63 100644 --- a/packages/web/src/content/docs/ru/cli.mdx +++ b/packages/web/src/content/docs/ru/cli.mdx @@ -34,7 +34,7 @@ opencode [project] | `--continue` | `-c` | Продолжить последний сеанс | | `--session` | `-s` | Идентификатор сеанса для продолжения | | `--fork` | | Разветвить сеанс при продолжении (используйте с `--continue` или `--session`) | -| `--prompt` | | Подскажите использовать | +| `--prompt` | | Промпт для использования | | `--model` | `-m` | Модель для использования в виде поставщика/модели. | | `--agent` | | Агент для использования | | `--port` | | Порт для прослушивания | @@ -119,7 +119,7 @@ opencode auth [command] #### login -opencode основан на списке поставщиков по адресу [Models.dev](https://models.dev)), поэтому вы можете использовать `opencode auth login` для настройки ключей API для любого поставщика, которого вы хотите использовать. Это хранится в `~/.local/share/opencode/auth.json`. +opencode использует список провайдеров с [Models.dev](https://models.dev), поэтому вы можете использовать `opencode auth login` для настройки ключей API для любого поставщика, которого вы хотите использовать. Это хранится в `~/.local/share/opencode/auth.json`. ```bash opencode auth login @@ -582,7 +582,7 @@ opencode можно настроить с помощью переменных с --- -### Экспериментальный +### Экспериментальные функции Эти переменные среды позволяют использовать экспериментальные функции, которые могут быть изменены или удалены. diff --git a/packages/web/src/content/docs/ru/commands.mdx b/packages/web/src/content/docs/ru/commands.mdx index f122ecf9f..447ef0f0d 100644 --- a/packages/web/src/content/docs/ru/commands.mdx +++ b/packages/web/src/content/docs/ru/commands.mdx @@ -13,7 +13,7 @@ description: Создавайте собственные команды для --- -## Создание командных файлов +## Создание файлов команд Создайте Markdown файлы в каталоге `commands/` для определения пользовательских команд. @@ -40,7 +40,7 @@ Focus on the failing tests and suggest fixes. --- -## Настроить +## Настройка Вы можете добавлять собственные команды через конфигурацию opencode или создав файлы Markdown в каталоге `commands/`. @@ -102,7 +102,7 @@ Focus on the failing tests and suggest fixes. --- -## Prompt Configuration +## Настройка промпта Подсказки для пользовательских команд поддерживают несколько специальных заполнителей и синтаксиса. @@ -161,7 +161,7 @@ with the following content: $3 --- -### Shell output +### Вывод shell Используйте _!`command`_, чтобы ввести вывод команды bash](/docs/tui#bash-commands) в приглашение. @@ -312,7 +312,7 @@ Check for performance issues and suggest improvements. --- -## Встроенный +## Встроенные команды opencode включает несколько встроенных команд, таких как `/init`, `/undo`, `/redo`, `/share`, `/help`; [подробнее](/docs/tui#commands). diff --git a/packages/web/src/content/docs/ru/config.mdx b/packages/web/src/content/docs/ru/config.mdx index 2a088bc81..14af31cfd 100644 --- a/packages/web/src/content/docs/ru/config.mdx +++ b/packages/web/src/content/docs/ru/config.mdx @@ -23,7 +23,7 @@ opencode поддерживает форматы **JSON** и **JSONC** (JSON с --- -## Локации +## Расположение Вы можете разместить свою конфигурацию в нескольких разных местах, и у них есть разный порядок старшинства. @@ -57,7 +57,7 @@ opencode поддерживает форматы **JSON** и **JSONC** (JSON с --- -### Удаленный +### Удаленная Организации могут предоставить конфигурацию по умолчанию через конечную точку `.well-known/opencode`. Он извлекается автоматически при аутентификации у провайдера, который его поддерживает. @@ -93,7 +93,7 @@ opencode поддерживает форматы **JSON** и **JSONC** (JSON с --- -### Глобальный +### Глобальная Поместите глобальную конфигурацию opencode в `~/.config/opencode/opencode.json`. Используйте глобальную конфигурацию для общепользовательских настроек, таких как темы, поставщики или привязки клавиш. @@ -101,7 +101,7 @@ opencode поддерживает форматы **JSON** и **JSONC** (JSON с --- -### За проект +### Проектная Добавьте `opencode.json` в корень вашего проекта. Конфигурация проекта имеет наивысший приоритет среди стандартных файлов конфигурации — она переопределяет как глобальные, так и удаленные конфигурации. @@ -130,10 +130,7 @@ opencode run "Hello world" ### Пользовательский каталог -Укажите пользовательский каталог конфигурации, используя `OPENCODE_CONFIG_DIR`. -переменная среды. В этом каталоге будет осуществляться поиск агентов, команд, -режимы и плагины, такие как стандартный каталог `.opencode`, и должны -следовать той же структуре. +Укажите пользовательский каталог конфигурации, используя переменную среды `OPENCODE_CONFIG_DIR`. В этом каталоге будет выполняться поиск агентов, команд, режимов и плагинов (аналогично стандартному каталогу `.opencode`), и он должен иметь ту же структуру. ```bash export OPENCODE_CONFIG_DIR=/path/to/my/config-directory @@ -179,7 +176,7 @@ opencode run "Hello world" --- -### server +### Сервер Вы можете настроить параметры сервера для команд `opencode serve` и `opencode web` с помощью опции `server`. @@ -208,7 +205,7 @@ opencode run "Hello world" --- -### tools +### Инструменты Вы можете управлять инструментами, которые LLM может использовать, с помощью опции `tools`. @@ -226,7 +223,7 @@ opencode run "Hello world" --- -### Models +### models Вы можете настроить поставщиков и модели, которые хотите использовать в своей конфигурации opencode, с помощью параметров `provider`, `model` и `small_model`. @@ -368,7 +365,7 @@ Amazon Bedrock поддерживает конфигурацию, специфи } ``` -Это занимает: +Принимает значения: - `"manual"` — разрешить общий доступ вручную с помощью команд (по умолчанию). - `"auto"` — автоматически делиться новыми беседами. @@ -378,7 +375,7 @@ Amazon Bedrock поддерживает конфигурацию, специфи --- -### command +### Команды Вы можете настроить собственные команды для повторяющихся задач с помощью опции `command`. @@ -404,7 +401,7 @@ Amazon Bedrock поддерживает конфигурацию, специфи --- -### keybinds +### Сочетания клавиш Вы можете настроить привязки клавиш с помощью опции `keybinds`. @@ -419,7 +416,7 @@ Amazon Bedrock поддерживает конфигурацию, специфи --- -### autoupdate +### Автообновление opencode автоматически загрузит все новые обновления при запуске. Вы можете отключить это с помощью опции `autoupdate`. @@ -435,7 +432,7 @@ opencode автоматически загрузит все новые обно --- -### formatter +### Форматтеры Вы можете настроить форматировщики кода с помощью опции `formatter`. @@ -532,7 +529,7 @@ opencode автоматически загрузит все новые обно --- -### plugin +### Плагины [Плагины](/docs/plugins) расширяют opencode с помощью пользовательских инструментов, перехватчиков и интеграций. @@ -560,8 +557,7 @@ opencode автоматически загрузит все новые обно } ``` -Для этого требуется массив путей и шаблонов glob для файлов инструкций. [Узнать больше -о правилах здесь ](/docs/rules). +Для этого требуется массив путей и шаблонов glob для файлов инструкций. [Подробнее о правилах читайте здесь](/docs/rules). --- @@ -609,7 +605,7 @@ opencode автоматически загрузит все новые обно --- -### experimental +### Экспериментальные возможности Ключ `experimental` содержит параметры, находящиеся в активной разработке. @@ -632,7 +628,7 @@ opencode автоматически загрузит все новые обно --- -### переменные окружения +### Переменные окружения Используйте `{env:VARIABLE_NAME}` для замены переменных среды: diff --git a/packages/web/src/content/docs/ru/custom-tools.mdx b/packages/web/src/content/docs/ru/custom-tools.mdx index 25626b79c..c487ee995 100644 --- a/packages/web/src/content/docs/ru/custom-tools.mdx +++ b/packages/web/src/content/docs/ru/custom-tools.mdx @@ -133,7 +133,7 @@ export default tool({ ## Примеры -### Напишите инструмент на Python +### Инструмент на Python Вы можете писать свои инструменты на любом языке, который захотите. Вот пример сложения двух чисел с использованием Python. diff --git a/packages/web/src/content/docs/ru/ecosystem.mdx b/packages/web/src/content/docs/ru/ecosystem.mdx index 7b8af3dcc..a27804361 100644 --- a/packages/web/src/content/docs/ru/ecosystem.mdx +++ b/packages/web/src/content/docs/ru/ecosystem.mdx @@ -9,7 +9,7 @@ description: Проекты и интеграции, созданные с по Хотите добавить свой проект, связанный с 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) — хаб, объединяющий экосистему и сообщество. --- diff --git a/packages/web/src/content/docs/ru/enterprise.mdx b/packages/web/src/content/docs/ru/enterprise.mdx index 20dd3d6a0..d5932e0e0 100644 --- a/packages/web/src/content/docs/ru/enterprise.mdx +++ b/packages/web/src/content/docs/ru/enterprise.mdx @@ -1,5 +1,5 @@ --- -title: Предприятие +title: Корпоративное использование description: Безопасное использование opencode в вашей организации. --- @@ -19,7 +19,7 @@ opencode не хранит ваш код или контекстные данн --- -## Пробный +## Пробная версия opencode имеет открытый исходный код и не хранит ваш код или контекстные данные, поэтому ваши разработчики могут просто [приступить к работе](/docs/) и провести пробную версию. @@ -83,7 +83,7 @@ opencode имеет открытый исходный код и не храни --- -### Интеграция единого входа +### Интеграция SSO Через центральную конфигурацию opencode может интегрироваться с провайдером единого входа вашей организации для аутентификации. @@ -101,10 +101,9 @@ opencode имеет открытый исходный код и не храни ### Самостоятельный хостинг -Хотя мы рекомендуем отключить страницы общего доступа, чтобы гарантировать, что ваши данные никогда не исчезнут. -вашей организации, мы также можем помочь вам самостоятельно разместить их в вашей инфраструктуре. +Хотя мы рекомендуем отключить страницы общего доступа, чтобы гарантировать, что ваши данные никогда не покинут вашу организацию, мы также можем помочь вам самостоятельно разместить их в вашей инфраструктуре. -В настоящее время это находится в нашей дорожной карте. Если вам интересно, **дайте нам знать**. +В настоящее время это находится в нашей дорожной карте. Если вы заинтересованы, **дайте нам знать**. --- @@ -151,8 +150,7 @@ opencode поддерживает частные реестры npm посред npm login --registry=https://your-company.jfrog.io/api/npm/npm-virtual/ ``` -При этом создается `~/.npmrc` с данными аутентификации. opencode автоматически -возьми это. +При этом создается `~/.npmrc` с данными аутентификации. opencode автоматически подхватит его. :::caution Перед запуском opencode вы должны войти в частный реестр. diff --git a/packages/web/src/content/docs/ru/formatters.mdx b/packages/web/src/content/docs/ru/formatters.mdx index 771327aac..8712e39c6 100644 --- a/packages/web/src/content/docs/ru/formatters.mdx +++ b/packages/web/src/content/docs/ru/formatters.mdx @@ -1,5 +1,5 @@ --- -title: Форматеры +title: Форматтеры description: opencode использует средства форматирования, специфичные для языка. --- @@ -7,7 +7,7 @@ opencode автоматически форматирует файлы после --- -## Built-in +## Встроенные opencode поставляется с несколькими встроенными форматировщиками для популярных языков и платформ. Ниже приведен список форматтеров, поддерживаемых расширений файлов, а также необходимых команд или параметров конфигурации. @@ -35,14 +35,14 @@ opencode поставляется с несколькими встроенным | nixfmt | .nix | Доступна команда `nixfmt` | | shfmt | .sh, .bash | Доступна команда `shfmt` | | pint | .php | Зависимость `laravel/pint` в `composer.json` | -| oxfmt (Experimental) | .js, .jsx, .ts, .tsx | Зависимость `oxfmt` в `package.json` и [экспериментальная переменная окружения flag](/docs/cli/#experimental) | +| oxfmt (Experimental) | .js, .jsx, .ts, .tsx | Зависимость `oxfmt` в `package.json` и [экспериментальный флаг переменной окружения](/docs/cli/#experimental) | | ormolu | .hs | Доступна команда `ormolu` | -Поэтому, если ваш проект имеет `prettier` в вашем `package.json`, opencode автоматически его использует. +Поэтому, если ваш проект имеет `prettier` в вашем `package.json`, opencode автоматически будет использовать его. --- -## Configure +## Настройка Вы можете настроить форматтеры через раздел `formatter` в конфигурации opencode. @@ -66,7 +66,7 @@ opencode поставляется с несколькими встроенным --- -### Disabling Formatters +### Отключение форматтеров Чтобы глобально отключить **все** средства форматирования, установите для `formatter` значение `false`: @@ -92,7 +92,7 @@ opencode поставляется с несколькими встроенным --- -### Custom Formatters +### Пользовательские форматтеры Вы можете переопределить встроенные средства форматирования или добавить новые, указав команду, переменные среды и расширения файлов: diff --git a/packages/web/src/content/docs/ru/github.mdx b/packages/web/src/content/docs/ru/github.mdx index a61a9679b..131d4f66d 100644 --- a/packages/web/src/content/docs/ru/github.mdx +++ b/packages/web/src/content/docs/ru/github.mdx @@ -7,11 +7,11 @@ opencode интегрируется с вашим рабочим процесс --- -## Функции +## Возможности -- **Сортировка проблем**. Попросите opencode разобраться в проблеме и объяснить ее вам. -- **Исправить и внедрить**. Попросите opencode исправить проблему или реализовать функцию. И будет работать в новой ветке и подавать PR со всеми изменениями. -- **Безопасность**: opencode запускается внутри бегунов вашего GitHub. +- **Триаж задач (Issue Triage)**. Попросите opencode разобраться в проблеме и объяснить ее вам. +- **Исправление и реализация**. Попросите opencode исправить проблему или реализовать функцию. Он будет работать в новой ветке и создаст PR со всеми изменениями. +- **Безопасность**: opencode запускается внутри ваших GitHub Runners. --- @@ -23,11 +23,11 @@ opencode интегрируется с вашим рабочим процесс opencode github install ``` -Это поможет вам установить приложение GitHub, создать рабочий процесс и настроить секреты. +Это поможет вам установить приложение GitHub, создать рабочий процесс и настроить secrets (секреты). --- -### Manual Setup +### Ручная настройка Или вы можете настроить его вручную. @@ -79,7 +79,7 @@ opencode github install --- -## Configuration +## Настройка - `model`: модель для использования с opencode. Принимает формат `provider/model`. Это **обязательно**. - `agent`: используемый агент. Должен быть основным агентом. Возвращается к `default_agent` из конфигурации или к `"build"`, если не найден. @@ -101,7 +101,7 @@ opencode github install --- -## Supported Events +## Поддерживаемые события opencode может быть запущен следующими событиями GitHub: @@ -109,12 +109,12 @@ opencode может быть запущен следующими события | ----------------------------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | | `issue_comment` | Комментарий к проблеме или PR | Упомяните `/opencode` или `/oc` в своем комментарии. opencode считывает контекст и может создавать ветки, открывать PR или отвечать. | | `pull_request_review_comment` | Комментируйте конкретные строки кода в PR. | Упоминайте `/opencode` или `/oc` при просмотре кода. opencode получает путь к файлу, номера строк и контекст сравнения. | -| `issues` | Проблема открыта или отредактирована | Автоматически запускать opencode при создании или изменении проблем. Требуется ввод `prompt`. | +| `issues` | Issue открыт или изменен | Автоматически запускать opencode при создании или изменении проблем. Требуется ввод `prompt`. | | `pull_request` | PR открыт или обновлен | Автоматически запускать opencode при открытии, синхронизации или повторном открытии PR. Полезно для автоматических обзоров. | | `schedule` | Расписание на основе Cron | Запускайте opencode по расписанию. Требуется ввод `prompt`. Вывод поступает в журналы и PR (комментариев нет). | | `workflow_dispatch` | Ручной триггер из пользовательского интерфейса GitHub | Запускайте opencode по требованию на вкладке «Действия». Требуется ввод `prompt`. Вывод идет в логи и PR. | -### Пример расписания +### Пример: Расписание Запускайте opencode по расписанию для выполнения автоматизированных задач: @@ -154,7 +154,7 @@ jobs: --- -### Пример запроса на включение +### Пример: Pull Request Автоматически просматривать PR при их открытии или обновлении: @@ -195,9 +195,9 @@ jobs: --- -### Пример сортировки проблем +### Пример: Сортировка Issue -Автоматически сортируйте новые проблемы. В этом примере фильтруется учетные записи старше 30 дней, чтобы уменьшить количество спама: +Автоматически сортируйте новые проблемы. В этом примере фильтруется аккаунты, созданные более 30 дней назад, чтобы уменьшить количество спама: ```yaml title=".github/workflows/opencode-triage.yml" name: Issue Triage @@ -250,7 +250,7 @@ jobs: --- -## Custom Prompts +## Пользовательские промпты Переопределите приглашение по умолчанию, чтобы настроить поведение opencode для вашего рабочего процесса. @@ -273,7 +273,7 @@ jobs: Вот несколько примеров того, как вы можете использовать opencode в GitHub. -- **Объясните проблему** +- **Объяснение проблемы** Добавьте этот комментарий в выпуск GitHub. @@ -283,7 +283,7 @@ jobs: opencode прочитает всю ветку, включая все комментарии, и ответит с четким объяснением. -- **Исправить проблему** +- **Исправление проблемы** В выпуске GitHub скажите: @@ -293,7 +293,7 @@ jobs: А opencode создаст новую ветку, внедрит изменения и откроет PR с изменениями. -- **Проверьте Pull Requests и внесите изменения** +- **Проверка Pull Request и внесение изменений** Оставьте следующий комментарий к PR на GitHub. @@ -303,7 +303,7 @@ jobs: opencode внедрит запрошенное изменение и зафиксирует его в том же PR. -- **Просмотрите отдельные строки кода** +- **Проверка отдельных строк кода** Оставляйте комментарии непосредственно к строкам кода на вкладке «Файлы» PR. opencode автоматически определяет файл, номера строк и контекст различий, чтобы предоставить точные ответы. diff --git a/packages/web/src/content/docs/ru/gitlab.mdx b/packages/web/src/content/docs/ru/gitlab.mdx index 7f85f27e9..ad56e998b 100644 --- a/packages/web/src/content/docs/ru/gitlab.mdx +++ b/packages/web/src/content/docs/ru/gitlab.mdx @@ -25,7 +25,7 @@ opencode работает в обычном конвейере GitLab. Вы мо --- -### Setup +### Настройка 1. Сохраните JSON аутентификации opencode как переменные среды CI типа файла в разделе **Настройки** > **CI/CD** > **Переменные**. Обязательно пометьте их как «Замаскированные и скрытые». 2. Добавьте следующее в файл `.gitlab-ci.yml`. @@ -53,14 +53,14 @@ opencode интегрируется с вашим рабочим процесс ### Функции -- **Сортировка проблем**. Попросите opencode разобраться в проблеме и объяснить ее вам. -- **Исправить и внедрить**. Попросите opencode исправить проблему или реализовать функцию. +- **Триаж задач (Issue Triage)**. Попросите opencode разобраться в проблеме и объяснить ее вам. +- **Исправление и реализация**. Попросите opencode исправить проблему или реализовать функцию. Он создаст новую ветку и создаст мерж-реквест с изменениями. - **Безопасность**: opencode работает на ваших программах GitLab. --- -### Setup +### Настройка opencode работает в вашем конвейере GitLab CI/CD. Вот что вам понадобится для его настройки: @@ -164,9 +164,9 @@ opencode работает в вашем конвейере GitLab CI/CD. Вот Вы можете настроить использование триггерной фразы, отличной от `@opencode`. ::: -- **Объясните проблему** +- **Объяснение проблемы** - Добавьте этот комментарий в выпуск GitLab. + Добавьте этот комментарий в issue GitLab. ``` @opencode explain this issue @@ -174,9 +174,9 @@ opencode работает в вашем конвейере GitLab CI/CD. Вот opencode прочитает проблему и ответит с четким объяснением. -- **Исправить проблему** +- **Исправление проблемы** - В выпуске GitLab скажите: + В issue GitLab напишите: ``` @opencode fix this @@ -184,7 +184,7 @@ opencode работает в вашем конвейере GitLab CI/CD. Вот opencode создаст новую ветку, внедрит изменения и откроет мерж-реквест с изменениями. -- **Просмотр мерж-реквестов** +- **Проверка Merge Request** Оставьте следующий комментарий к мерж-реквесту GitLab. diff --git a/packages/web/src/content/docs/ru/ide.mdx b/packages/web/src/content/docs/ru/ide.mdx index e66bde632..8691767e3 100644 --- a/packages/web/src/content/docs/ru/ide.mdx +++ b/packages/web/src/content/docs/ru/ide.mdx @@ -9,10 +9,10 @@ opencode интегрируется с VS Code, Cursor или любой IDE, п ## Использование -- **Быстрый запуск**: используйте `Cmd+Esc` (Mac) или `Ctrl+Esc` (Windows/Linux), чтобы открыть opencode в разделенном представлении терминала, или сосредоточьте внимание на существующем сеансе терминала, если он уже запущен. +- **Быстрый запуск**: используйте `Cmd+Esc` (Mac) или `Ctrl+Esc` (Windows/Linux), чтобы открыть opencode в разделенном представлении терминала, или сфокусируйтесь на существующем сеансе терминала, если он уже запущен. - **Новый сеанс**: используйте `Cmd+Shift+Esc` (Mac) или `Ctrl+Shift+Esc` (Windows/Linux), чтобы начать новый сеанс терминала opencode, даже если он уже открыт. Вы также можете нажать кнопку opencode в пользовательском интерфейсе. -- **Узнавание контекста**: автоматически делитесь своим текущим выбором или вкладкой с помощью opencode. -- **File Reference Shortcuts**: Use `Cmd+Option+K` (Mac) or `Alt+Ctrl+K` (Linux/Windows) to insert file references. Например, `@File#L37-42`. +- **Осведомленность о контексте**: автоматически делитесь своим текущим выбором или вкладкой с помощью opencode. +- **Шорткаты ссылок на файлы**: Используйте `Cmd+Option+K` (Mac) или `Alt+Ctrl+K` (Linux/Windows) для вставки ссылок на файлы. Например, `@File#L37-42`. --- @@ -34,7 +34,7 @@ opencode интегрируется с VS Code, Cursor или любой IDE, п --- -### Поиск неисправностей +### Устранение неполадок Если расширение не устанавливается автоматически: diff --git a/packages/web/src/content/docs/ru/index.mdx b/packages/web/src/content/docs/ru/index.mdx index 3edebca94..b4a115250 100644 --- a/packages/web/src/content/docs/ru/index.mdx +++ b/packages/web/src/content/docs/ru/index.mdx @@ -15,7 +15,7 @@ export const console = config.console --- -#### Предварительные условия +#### Системные требования Чтобы использовать opencode в вашем терминале, вам понадобится: @@ -29,7 +29,7 @@ export const console = config.console --- -## Установить +## Установка Самый простой способ установить opencode — через сценарий установки. @@ -79,7 +79,7 @@ curl -fsSL https://opencode.ai/install | bash brew install anomalyco/tap/opencode ``` - > Мы рекомендуем использовать кран opencode для получения самых последних версий. Официальная формула `brew install opencode` поддерживается командой Homebrew и обновляется реже. + > Мы рекомендуем использовать tap opencode для получения самых последних версий. Официальная формула `brew install opencode` поддерживается командой Homebrew и обновляется реже. - **Использование Paru в Arch Linux** @@ -87,7 +87,7 @@ curl -fsSL https://opencode.ai/install | bash paru -S opencode-bin ``` -#### Окна +#### Windows :::tip[Рекомендуется: используйте WSL] Для наилучшей работы в Windows мы рекомендуем использовать [Подсистема Windows для Linux (WSL)](/docs/windows-wsl). Он обеспечивает лучшую производительность и полную совместимость с функциями opencode. @@ -123,7 +123,7 @@ curl -fsSL https://opencode.ai/install | bash docker run -it --rm ghcr.io/anomalyco/opencode ``` -В настоящее время находится поддержка установки opencode в Windows с помощью Bun. +В настоящее время добавляется поддержка установки opencode в Windows с помощью Bun. Вы также можете получить двоичный файл из файла [Releases](https://github.com/anomalyco/opencode/releases). @@ -158,7 +158,7 @@ curl -fsSL https://opencode.ai/install | bash --- -## Инициализировать +## Инициализация Теперь, когда вы настроили поставщика, вы можете перейти к проекту, который над которым вы хотите работать. @@ -193,8 +193,7 @@ opencode ## Использование -Теперь вы готовы использовать opencode для работы над своим проектом. Не стесняйтесь спрашивать это -что-либо! +Теперь вы готовы использовать opencode для работы над своим проектом. Не стесняйтесь спрашивать о чем угодно! Если вы новичок в использовании агента кодирования ИИ, вот несколько примеров, которые могут вам помочь. помощь. @@ -217,7 +216,7 @@ How is authentication handled in @packages/functions/src/api/index.ts --- -### Добавить функции +### Добавление функций Вы можете попросить opencode добавить новые функции в ваш проект. Хотя мы сначала рекомендуем попросить его создать план. @@ -281,7 +280,7 @@ How is authentication handled in @packages/functions/src/api/index.ts --- -### Внести изменения +### Внесение изменений Для более простых изменений вы можете попросить opencode создать его напрямую. без необходимости предварительного рассмотрения плана. @@ -297,7 +296,7 @@ the same logic in @packages/functions/src/settings.ts --- -### Отменить изменения +### Отмена изменений Допустим, вы просите opencode внести некоторые изменения. @@ -333,7 +332,7 @@ Can you refactor the function in @packages/functions/src/api/index.ts? --- -## Делиться +## Общий доступ Разговоры, которые вы ведете с opencode, можно [поделиться с вашим команда](/docs/share). diff --git a/packages/web/src/content/docs/ru/keybinds.mdx b/packages/web/src/content/docs/ru/keybinds.mdx index e812670f6..67d191ea2 100644 --- a/packages/web/src/content/docs/ru/keybinds.mdx +++ b/packages/web/src/content/docs/ru/keybinds.mdx @@ -109,13 +109,13 @@ opencode имеет список сочетаний клавиш, которые opencode использует клавишу `leader` для большинства сочетаний клавиш. Это позволяет избежать конфликтов в вашем терминале. -По умолчанию `ctrl+x` является ведущей клавишей, и для большинства действий требуется сначала нажать ведущую клавишу, а затем сочетание клавиш. Например, чтобы начать новый сеанс, сначала нажмите `ctrl+x`, а затем нажмите `n`. +По умолчанию `ctrl+x` является клавишей leader, и для большинства действий требуется сначала нажать клавишу leader, а затем сочетание клавиш. Например, чтобы начать новый сеанс, сначала нажмите `ctrl+x`, а затем нажмите `n`. -Вам не обязательно использовать выносную клавишу для привязок клавиш, но мы рекомендуем это сделать. +Вам не обязательно использовать клавишу leader для привязок клавиш, но мы рекомендуем это сделать. --- -## Отключить привязку клавиш +## Отключение привязки клавиш Вы можете отключить привязку клавиш, добавив ключ в свою конфигурацию со значением «none». @@ -130,7 +130,7 @@ opencode использует клавишу `leader` для большинст --- -## Ярлыки команд на рабочем столе +## Шорткаты в Desktop-приложении Ввод приглашения настольного приложения opencode поддерживает распространенные сочетания клавиш в стиле Readline/Emacs для редактирования текста. Они встроены и в настоящее время не настраиваются через `opencode.json`. @@ -143,20 +143,20 @@ opencode использует клавишу `leader` для большинст | `alt+b` | Переместить курсор на одно слово назад | | `alt+f` | Переместить курсор вперед на одно слово | | `ctrl+d` | Удалить символ под курсором | -| `ctrl+k` | Убить до конца строки | -| `ctrl+u` | Убить до начала строки | -| `ctrl+w` | Убить предыдущее слово | -| `alt+d` | Убить следующее слово | -| `ctrl+t` | Транспонировать символы | +| `ctrl+k` | Удалить до конца строки | +| `ctrl+u` | Удалить до начала строки | +| `ctrl+w` | Удалить предыдущее слово | +| `alt+d` | Удалить следующее слово | +| `ctrl+t` | Поменять местами символы | | `ctrl+g` | Отменить всплывающие окна/прервать выполнение ответа | --- -## Shift+Ввод +## Shift+Enter Некоторые терминалы по умолчанию не отправляют клавиши-модификаторы с Enter. Возможно, вам придется настроить терминал на отправку `Shift+Enter` в качестве escape-последовательности. -### Терминал Windows +### Windows Terminal Откройте свой `settings.json` по адресу: diff --git a/packages/web/src/content/docs/ru/lsp.mdx b/packages/web/src/content/docs/ru/lsp.mdx index 751adbdec..0b63c9ea3 100644 --- a/packages/web/src/content/docs/ru/lsp.mdx +++ b/packages/web/src/content/docs/ru/lsp.mdx @@ -1,5 +1,5 @@ --- -title: ЛСП Серверы +title: LSP-серверы description: opencode интегрируется с вашими серверами LSP. --- @@ -7,44 +7,44 @@ opencode интегрируется с вашим протоколом язык --- -## Встроенный +## Встроенные opencode поставляется с несколькими встроенными LSP-серверами для популярных языков: -| LSP Server | Extensions | Requirements | -| ------------------ | ------------------------------------------------------------------- | ------------------------------------------------------------ | -| astro | .astro | Auto-installs for Astro projects | -| bash | .sh, .bash, .zsh, .ksh | Auto-installs bash-language-server | -| clangd | .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++ | Auto-installs for C/C++ projects | -| csharp | .cs | `.NET SDK` installed | -| clojure-lsp | .clj, .cljs, .cljc, .edn | `clojure-lsp` command available | -| dart | .dart | `dart` command available | -| deno | .ts, .tsx, .js, .jsx, .mjs | `deno` command available (auto-detects deno.json/deno.jsonc) | -| elixir-ls | .ex, .exs | `elixir` command available | -| eslint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue | `eslint` dependency in project | -| fsharp | .fs, .fsi, .fsx, .fsscript | `.NET SDK` installed | -| gleam | .gleam | `gleam` command available | -| gopls | .go | `go` command available | -| hls | .hs, .lhs | `haskell-language-server-wrapper` command available | -| jdtls | .java | `Java SDK (version 21+)` installed | -| kotlin-ls | .kt, .kts | Auto-installs for Kotlin projects | -| lua-ls | .lua | Auto-installs for Lua projects | -| nixd | .nix | `nixd` command available | -| ocaml-lsp | .ml, .mli | `ocamllsp` command available | -| oxlint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte | `oxlint` dependency in project | -| php intelephense | .php | Auto-installs for PHP projects | -| prisma | .prisma | `prisma` command available | -| pyright | .py, .pyi | `pyright` dependency installed | -| ruby-lsp (rubocop) | .rb, .rake, .gemspec, .ru | `ruby` and `gem` commands available | -| rust | .rs | `rust-analyzer` command available | -| sourcekit-lsp | .swift, .objc, .objcpp | `swift` installed (`xcode` on macOS) | -| svelte | .svelte | Auto-installs for Svelte projects | -| terraform | .tf, .tfvars | Auto-installs from GitHub releases | -| tinymist | .typ, .typc | Auto-installs from GitHub releases | -| typescript | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts | `typescript` dependency in project | -| vue | .vue | Auto-installs for Vue projects | -| yaml-ls | .yaml, .yml | Auto-installs Red Hat yaml-language-server | -| zls | .zig, .zon | `zig` command available | +| 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 автоматически включаются при обнаружении одного из указанных выше расширений файлов и выполнении требований. @@ -63,7 +63,7 @@ opencode поставляется с несколькими встроенным --- -## Настроить +## Настройка Вы можете настроить серверы LSP через раздел `lsp` в конфигурации opencode. diff --git a/packages/web/src/content/docs/ru/mcp-servers.mdx b/packages/web/src/content/docs/ru/mcp-servers.mdx index 03771eeb7..da88f413f 100644 --- a/packages/web/src/content/docs/ru/mcp-servers.mdx +++ b/packages/web/src/content/docs/ru/mcp-servers.mdx @@ -21,7 +21,7 @@ description: Добавьте локальные и удаленные инст --- -## Давать возможность +## Включение Вы можете определить серверы MCP в своем [opencode Config](https://opencode.ai/docs/config/) в разделе `mcp`. Добавьте каждому MCP уникальное имя. Вы можете обратиться к этому MCP по имени при запросе LLM. @@ -63,11 +63,11 @@ description: Добавьте локальные и удаленные инст } ``` -Значения вашей локальной конфигурации переопределяют удаленные значения по умолчанию. Дополнительную информацию см. в [config Priorce](/docs/config#precedence-order). +Значения вашей локальной конфигурации переопределяют удаленные значения по умолчанию. Дополнительную информацию см. в [приоритете конфигурации](/docs/config#precedence-order). --- -## Местный +## Локальные Добавьте локальные серверы MCP с помощью `type` в `"local"` внутри объекта MCP. @@ -104,7 +104,7 @@ description: Добавьте локальные и удаленные инст } ``` -И чтобы использовать его, я могу добавить `use the mcp_everything tool` в свои подсказки. +И чтобы использовать его, добавьте `use the mcp_everything tool` в свои подсказки. ```txt "mcp_everything" use the mcp_everything tool to add the number 3 and 4 @@ -116,17 +116,17 @@ use the mcp_everything tool to add the number 3 and 4 Вот все варианты настройки локального сервера MCP. -| Вариант | Тип | Необходимый | Описание | -| ------------- | ------------------- | ----------- | ------------------------------------------------------------------------------------- | -| `type` | Нить | Да | Тип подключения к серверу MCP должен быть `"local"`. | -| `command` | Множество | Да | Команда и аргументы для запуска сервера MCP. | -| `environment` | Объект | | Переменные среды, которые необходимо установить при запуске сервера. | -| `enabled` | логическое значение | | Включите или отключите сервер MCP при запуске. | -| `timeout` | Число | | Тайм-аут в мс для получения инструментов с сервера MCP. По умолчанию 5000 (5 секунд). | +| Вариант | Тип | Обязательный | Описание | +| ------------- | ------------------- | ------------ | ------------------------------------------------------------------------------------- | +| `type` | Строка | Да | Тип подключения к серверу MCP должен быть `"local"`. | +| `command` | Массив | Да | Команда и аргументы для запуска сервера MCP. | +| `environment` | Объект | | Переменные среды, которые необходимо установить при запуске сервера. | +| `enabled` | логическое значение | | Включите или отключите сервер MCP при запуске. | +| `timeout` | Число | | Тайм-аут в мс для получения инструментов с сервера MCP. По умолчанию 5000 (5 секунд). | --- -## Удаленный +## Удаленные Добавьте удаленные серверы MCP, установив для `type` значение `"remote"`. @@ -152,14 +152,14 @@ use the mcp_everything tool to add the number 3 and 4 #### Параметры -| Вариант | Тип | Необходимый | Описание | -| --------- | ------------------- | ----------- | ------------------------------------------------------------------------------------- | -| `type` | Нить | Да | Тип подключения к серверу MCP должен быть `"remote"`. | -| `url` | Нить | Да | URL-адрес удаленного сервера MCP. | -| `enabled` | логическое значение | | Включите или отключите сервер MCP при запуске. | -| `headers` | Объект | | Заголовки для отправки с запросом. | -| `oauth` | Объект | | Конфигурация аутентификации OAuth. См. раздел [OAuth](#oauth) ниже. | -| `timeout` | Число | | Тайм-аут в мс для получения инструментов с сервера MCP. По умолчанию 5000 (5 секунд). | +| Вариант | Тип | Обязательный | Описание | +| --------- | ------------------- | ------------ | ------------------------------------------------------------------------------------- | +| `type` | Строка | Да | Тип подключения к серверу MCP должен быть `"remote"`. | +| `url` | Строка | Да | URL-адрес удаленного сервера MCP. | +| `enabled` | логическое значение | | Включите или отключите сервер MCP при запуске. | +| `headers` | Объект | | Заголовки для отправки с запросом. | +| `oauth` | Объект | | Конфигурация аутентификации OAuth. См. раздел [OAuth](#oauth) ниже. | +| `timeout` | Число | | Тайм-аут в мс для получения инструментов с сервера MCP. По умолчанию 5000 (5 секунд). | --- @@ -173,7 +173,7 @@ opencode автоматически обрабатывает аутентифи --- -### Автоматический +### Автоматически Для большинства серверов MCP с поддержкой OAuth не требуется никакой специальной настройки. Просто настройте удаленный сервер: @@ -289,13 +289,13 @@ opencode mcp debug my-oauth-server --- -## Управлять +## Управление Ваши MCP доступны в виде инструментов opencode наряду со встроенными инструментами. Таким образом, вы можете управлять ими через конфигурацию opencode, как и любым другим инструментом. --- -### Глобальный +### Глобально Это означает, что вы можете включать или отключать их глобально. @@ -343,7 +343,7 @@ opencode mcp debug my-oauth-server --- -### За агента +### Для каждого агента Если у вас большое количество серверов MCP, вы можете включить их только для каждого агента и отключить глобально. Для этого: @@ -375,7 +375,7 @@ opencode mcp debug my-oauth-server --- -#### Шаблоны глобусов +#### Glob-шаблоны Шаблон glob использует простые шаблоны подстановки регулярных выражений: @@ -400,7 +400,7 @@ opencode mcp debug my-oauth-server --- -### Часовой +### Sentry Добавьте [сервер Sentry MCP](https://mcp.sentry.dev) для взаимодействия с вашими проектами и проблемами Sentry. @@ -433,7 +433,7 @@ Show me the latest unresolved issues in my project. use sentry --- -### Контекст7 +### Context7 Добавьте [сервер Context7 MCP](https://github.com/upstash/context7) для поиска в документах. @@ -482,7 +482,7 @@ When you need to search docs, use `context7` tools. --- -### Греп от Верселя +### Grep by Vercel Добавьте сервер MCP [Grep от Vercel](https://grep.app) для поиска по фрагментам кода на GitHub. diff --git a/packages/web/src/content/docs/ru/models.mdx b/packages/web/src/content/docs/ru/models.mdx index 280dc916e..a23a02f6a 100644 --- a/packages/web/src/content/docs/ru/models.mdx +++ b/packages/web/src/content/docs/ru/models.mdx @@ -39,10 +39,10 @@ opencode использует [AI SDK](https://ai-sdk.dev/) и [Models.dev](http - GPT 5.2 - Кодекс GPT 5.1 -- Закрыть работу 4.5 -- Клод Сонет 4.5 -- Минимакс М2.1 -- Близнецы 3 Про +- Claude Opus 4.5 +- Claude Sonnet 4.5 +- MiniMax M2.1 +- Gemini 3 Pro --- @@ -143,21 +143,21 @@ opencode использует [AI SDK](https://ai-sdk.dev/) и [Models.dev](http opencode поставляется с вариантами по умолчанию для многих провайдеров: -**Антропный**: +**Anthropic**: -- `high` — Бюджет с высоким мышлением (по умолчанию) -- `max` — Максимальный бюджет мышления +- `high` — Бюджет рассуждений: высокий (по умолчанию) +- `max` — Максимальный бюджет рассуждений **OpenAI**: Зависит от модели, но примерно: -- `none` — Никаких рассуждений. -- `minimal` — Минимальные усилия рассуждения -- `low` — Низкие усилия по рассуждению. -- `medium` – средние усилия рассуждения. -- `high` — Большие усилия по рассуждению. -- `xhigh` — сверхвысокие мыслительные усилия. +- `none` — Без рассуждений. +- `minimal` — Минимальные усилия для рассуждений +- `low` — Низкие усилия для рассуждений. +- `medium` — Средние усилия для рассуждений. +- `high` — Высокие усилия для рассуждений. +- `xhigh` — Сверхвысокие усилия для рассуждений. **Google**: @@ -195,7 +195,7 @@ opencode поставляется с вариантами по умолчани } ``` -### Варианты цикла +### Переключение вариантов Используйте сочетание клавиш `variant_cycle` для быстрого переключения между вариантами. [Подробнее ](/docs/keybinds). diff --git a/packages/web/src/content/docs/ru/modes.mdx b/packages/web/src/content/docs/ru/modes.mdx index 65b4efba2..c412d7842 100644 --- a/packages/web/src/content/docs/ru/modes.mdx +++ b/packages/web/src/content/docs/ru/modes.mdx @@ -23,15 +23,15 @@ opencode имеет два встроенных режима. --- -### Строить +### Build -Сборка — это режим **по умолчанию** со всеми включенными инструментами. Это стандартный режим разработки, в котором вам необходим полный доступ к файловым операциям и системным командам. +Build — это режим **по умолчанию** со всеми включенными инструментами. Это стандартный режим разработки, в котором вам необходим полный доступ к файловым операциям и системным командам. --- -### План +### Plan -Ограниченный режим, предназначенный для планирования и анализа. В режиме плана по умолчанию отключены следующие инструменты: +Ограниченный режим, предназначенный для планирования и анализа. В режиме Plan по умолчанию отключены следующие инструменты: - `write` – невозможно создавать новые файлы. - `edit` – невозможно изменить существующие файлы, за исключением файлов, расположенных по адресу `.opencode/plans/*.md`, для детализации самого плана. @@ -177,7 +177,7 @@ Provide constructive feedback without making direct changes. --- -### Быстрый +### Промпт Укажите собственный файл системных подсказок для этого режима с помощью конфигурации `prompt`. Файл подсказки должен содержать инструкции, специфичные для целей режима. @@ -326,6 +326,6 @@ Priorities: - **Режим планирования**: анализ и планирование без внесения изменений. - **Режим проверки**: проверка кода с доступом только для чтения и инструментами документирования. - **Режим отладки**: сосредоточен на исследовании с включенными инструментами bash и чтения. -- **Режим «Документы»**: запись документации с использованием файловых операций, но без системных команд. +- **Режим документации**: запись документации с использованием файловых операций, но без системных команд. Вы также можете обнаружить, что разные модели подходят для разных случаев использования. diff --git a/packages/web/src/content/docs/ru/network.mdx b/packages/web/src/content/docs/ru/network.mdx index 1d2562750..b80c84789 100644 --- a/packages/web/src/content/docs/ru/network.mdx +++ b/packages/web/src/content/docs/ru/network.mdx @@ -46,7 +46,7 @@ export HTTPS_PROXY=http://username:password@proxy.example.com:8080 --- -## Таможенные сертификаты +## Пользовательские сертификаты Если ваше предприятие использует собственные центры сертификации для HTTPS-соединений, настройте opencode, чтобы доверять им. diff --git a/packages/web/src/content/docs/ru/permissions.mdx b/packages/web/src/content/docs/ru/permissions.mdx index 471180832..efbacc8b5 100644 --- a/packages/web/src/content/docs/ru/permissions.mdx +++ b/packages/web/src/content/docs/ru/permissions.mdx @@ -169,7 +169,7 @@ opencode использует конфигурацию `permission`, чтобы --- -## Что означает «Спросить» +## Что означает «ask» Когда opencode запрашивает одобрение, пользовательский интерфейс предлагает три результата: @@ -177,7 +177,7 @@ opencode использует конфигурацию `permission`, чтобы - `always` — одобрять будущие запросы, соответствующие предложенным шаблонам (до конца текущего сеанса opencode). - `reject` — отклонить запрос -Набор шаблонов, которые одобрит `always`, предоставляется инструментом (например, утверждения bash обычно включают в белый список безопасный префикс команды, такой как `git status*`). +Набор шаблонов, которые одобрит `always`, предоставляется инструментом (например, разрешения bash обычно включают в белый список безопасный префикс команды, такой как `git status*`). --- diff --git a/packages/web/src/content/docs/ru/plugins.mdx b/packages/web/src/content/docs/ru/plugins.mdx index d0b313e80..1d7ffb339 100644 --- a/packages/web/src/content/docs/ru/plugins.mdx +++ b/packages/web/src/content/docs/ru/plugins.mdx @@ -240,7 +240,7 @@ export const NotificationPlugin = async ({ project, client, $, directory, worktr --- -### защита .env +### Защита .env Запретите открытому коду читать файлы `.env`: @@ -331,7 +331,7 @@ export const MyPlugin = async ({ client }) => { --- -### Уплотняющие крюки +### Хуки сжатия Настройте контекст, включаемый при сжатии сеанса: @@ -355,7 +355,7 @@ Include any state that should persist across compaction: } ``` -Хук `experimental.session.compacting` срабатывает до того, как LLM сгенерирует сводку продолжения. Используйте его для внедрения контекста, специфичного для домена, который будет пропущен при запросе на сжатие по умолчанию. +Хук `experimental.session.compacting` срабатывает до того, как LLM сгенерирует сводку для продолжения. Используйте его для внедрения контекста, специфичного для домена, который будет пропущен при запросе на сжатие по умолчанию. Вы также можете полностью заменить запрос на уплотнение, установив `output.prompt`: diff --git a/packages/web/src/content/docs/ru/providers.mdx b/packages/web/src/content/docs/ru/providers.mdx index fdad4a202..5984c89f4 100644 --- a/packages/web/src/content/docs/ru/providers.mdx +++ b/packages/web/src/content/docs/ru/providers.mdx @@ -15,14 +15,14 @@ opencode использует [AI SDK](https://ai-sdk.dev/) и [Models.dev](http --- -### Credentials +### Учетные данные Когда вы добавляете ключи API провайдера с помощью команды `/connect`, они сохраняются в `~/.local/share/opencode/auth.json`. --- -### Config +### Настройка Вы можете настроить поставщиков через раздел `provider` в вашем opencode. конфиг. @@ -48,7 +48,7 @@ opencode использует [AI SDK](https://ai-sdk.dev/) и [Models.dev](http --- -## Открытый код Нет +## OpenCode Zen OpenCode Zen — это список моделей, предоставленный командой opencode, которые были протестировано и проверено на хорошую работу с opencode. [Подробнее](/docs/zen). @@ -86,11 +86,10 @@ OpenCode Zen — это список моделей, предоставленн ## Каталог -Рассмотрим некоторых провайдеров подробнее. Если вы хотите добавить провайдера в -список, смело открывайте пиар. +Рассмотрим некоторых провайдеров подробнее. Если вы хотите добавить провайдера в список, смело открывайте PR. :::note -Не видите здесь провайдера? Разместите пиар. +Не видите здесь провайдера? Откройте PR. ::: --- diff --git a/packages/web/src/content/docs/ru/rules.mdx b/packages/web/src/content/docs/ru/rules.mdx index f35dde5fd..d553bd0ce 100644 --- a/packages/web/src/content/docs/ru/rules.mdx +++ b/packages/web/src/content/docs/ru/rules.mdx @@ -12,7 +12,7 @@ description: Установите пользовательские инстру Чтобы создать новый файл `AGENTS.md`, вы можете запустить команду `/init` в opencode. :::tip -Вам следует зафиксировать файл `AGENTS.md` вашего проекта в Git. +Вам следует закоммитить файл `AGENTS.md` вашего проекта в Git. ::: Это позволит отсканировать ваш проект и все его содержимое, чтобы понять, о чем этот проект, и сгенерировать с его помощью файл `AGENTS.md`. Это помогает opencode лучше ориентироваться в проекте. @@ -64,7 +64,7 @@ opencode также поддерживает чтение файла `AGENTS.md` Вы также можете иметь глобальные правила в файле `~/.config/opencode/AGENTS.md`. Это применяется ко всем сеансам opencode. -Поскольку это не передается в Git и не передается вашей команде, мы рекомендуем использовать его для указания любых личных правил, которым должен следовать LLM. +Поскольку это не коммитится в Git и не передается вашей команде, мы рекомендуем использовать его для указания любых личных правил, которым должен следовать LLM. ### Совместимость кода Клода diff --git a/packages/web/src/content/docs/ru/sdk.mdx b/packages/web/src/content/docs/ru/sdk.mdx index 6e6e1b6f7..1269d9fc0 100644 --- a/packages/web/src/content/docs/ru/sdk.mdx +++ b/packages/web/src/content/docs/ru/sdk.mdx @@ -353,7 +353,7 @@ await client.tui.showToast({ --- -### Авторизация +### Аутентификация | Метод | Описание | Ответ | | ------------------- | ------------------------------ | --------- | diff --git a/packages/web/src/content/docs/ru/server.mdx b/packages/web/src/content/docs/ru/server.mdx index 48efe4430..898789c29 100644 --- a/packages/web/src/content/docs/ru/server.mdx +++ b/packages/web/src/content/docs/ru/server.mdx @@ -114,7 +114,7 @@ For example, `http://localhost:4096/doc`. Use the spec to generate clients or in --- -### Пример +### Экземпляр | Метод | Путь | Описание | Ответ | | ------ | ------------------- | ---------------------------- | --------- | diff --git a/packages/web/src/content/docs/ru/share.mdx b/packages/web/src/content/docs/ru/share.mdx index 392985a9c..c4df3b6a7 100644 --- a/packages/web/src/content/docs/ru/share.mdx +++ b/packages/web/src/content/docs/ru/share.mdx @@ -63,7 +63,7 @@ opencode поддерживает три режима общего доступ --- -### Неполноценный +### Отключено Вы можете полностью отключить общий доступ, установив для параметра `share` значение `"disabled"` в вашем [файле конфигурации](/docs/config): @@ -122,7 +122,7 @@ opencode поддерживает три режима общего доступ Для корпоративных развертываний функция общего доступа может быть: - **Отключено** полностью из соображений безопасности. -- **Только** только для пользователей, прошедших аутентификацию посредством единого входа. +- **Доступно только** для пользователей, прошедших аутентификацию посредством единого входа. - **Автономное размещение** в вашей собственной инфраструктуре [Узнайте больше](/docs/enterprise) об использовании opencode в вашей организации. diff --git a/packages/web/src/content/docs/ru/skills.mdx b/packages/web/src/content/docs/ru/skills.mdx index 00a2de11e..152e48782 100644 --- a/packages/web/src/content/docs/ru/skills.mdx +++ b/packages/web/src/content/docs/ru/skills.mdx @@ -1,6 +1,6 @@ --- -title: «Навыки агента» -description: «Определите повторно используемое поведение с помощью определений SKILL.md» +title: Навыки агента +description: Определите повторно используемое поведение с помощью определений SKILL.md --- Навыки агента позволяют opencode обнаруживать многократно используемые инструкции из вашего репозитория или домашнего каталога. @@ -22,7 +22,7 @@ opencode выполняет поиск в следующих местах: --- -## Понять открытие +## Понимание обнаружения Для локальных путей проекта opencode переходит из вашего текущего рабочего каталога, пока не достигнет рабочего дерева git. Он загружает все соответствующие `skills/*/SKILL.md` в `.opencode/` и все соответствующие `.claude/skills/*/SKILL.md` или `.agents/skills/*/SKILL.md` по пути. @@ -100,7 +100,7 @@ Ask clarifying questions if the target versioning scheme is unclear. --- -## Распознать описание инструмента +## Распознавание описания инструмента opencode перечисляет доступные навыки в описании инструмента `skill`. Каждая запись включает название и описание навыка: diff --git a/packages/web/src/content/docs/ru/themes.mdx b/packages/web/src/content/docs/ru/themes.mdx index 89859d743..2e5219e4c 100644 --- a/packages/web/src/content/docs/ru/themes.mdx +++ b/packages/web/src/content/docs/ru/themes.mdx @@ -27,7 +27,7 @@ opencode поставляется с несколькими встроенным | Имя | Описание | | ---------------------- | ---------------------------------------------------------------------------- | -| `system` | Adapts to your terminal’s background color | +| `system` | Адаптируется к фоновому цвету терминала | | `tokyonight` | Based on the [tokyonight](https://github.com/folke/tokyonight.nvim) theme | | `everforest` | Based on the [Everforest](https://github.com/sainnhe/everforest) theme | | `ayu` | Based on the [Ayu](https://github.com/ayu-theme) dark theme | @@ -36,7 +36,7 @@ opencode поставляется с несколькими встроенным | `gruvbox` | Based on the [Gruvbox](https://github.com/morhetz/gruvbox) theme | | `kanagawa` | Based on the [Kanagawa](https://github.com/rebelot/kanagawa.nvim) theme | | `nord` | Based on the [Nord](https://github.com/nordtheme/nord) theme | -| `matrix` | Hacker-style green on black theme | +| `matrix` | Хакерская тема: зеленый на черном | | `one-dark` | Based on the [Atom One](https://github.com/Th3Whit3Wolf/one-nvim) Dark theme | И более того, мы постоянно добавляем новые темы. @@ -95,14 +95,14 @@ opencode поддерживает гибкую систему тем на осн Чтобы создать собственную тему, создайте файл JSON в одном из каталогов темы. -Для общепользовательских тем: +Для глобальных тем: ```bash no-frame mkdir -p ~/.config/opencode/themes vim ~/.config/opencode/themes/my-theme.json ``` -И для тем, специфичных для проекта. +Для тем проекта: ```bash no-frame mkdir -p .opencode/themes diff --git a/packages/web/src/content/docs/ru/tools.mdx b/packages/web/src/content/docs/ru/tools.mdx index b0757867b..333216b37 100644 --- a/packages/web/src/content/docs/ru/tools.mdx +++ b/packages/web/src/content/docs/ru/tools.mdx @@ -9,7 +9,7 @@ description: Управляйте инструментами, которые м --- -## Настроить +## Настройка Используйте поле `permission` для управления поведением инструмента. Вы можете разрешить, запретить или потребовать одобрения для каждого инструмента. @@ -360,7 +360,7 @@ OPENCODE_ENABLE_EXA=1 opencode --- -## Внутренности +## Внутреннее устройство Внутренне такие инструменты, как `grep`, `glob` и `list`, используют [ripgrep](https://github.com/BurntSushi/ripgrep). По умолчанию ripgrep учитывает шаблоны `.gitignore`, что означает, что файлы и каталоги, перечисленные в вашем `.gitignore`, будут исключены из поиска и списков. diff --git a/packages/web/src/content/docs/ru/troubleshooting.mdx b/packages/web/src/content/docs/ru/troubleshooting.mdx index ac2120a21..d1d240cb7 100644 --- a/packages/web/src/content/docs/ru/troubleshooting.mdx +++ b/packages/web/src/content/docs/ru/troubleshooting.mdx @@ -39,7 +39,7 @@ opencode хранит данные сеанса и другие данные п ## Настольное приложение -opencode Desktop запускает локальный сервер opencode (сопутствующий модуль `opencode-cli`) в фоновом режиме. Большинство проблем вызвано неправильно работающим плагином, поврежденным кешем или неверными настройками сервера. +opencode Desktop запускает локальный сервер opencode (спутник `opencode-cli`) в фоновом режиме. Большинство проблем вызвано неправильно работающим плагином, поврежденным кешем или неверными настройками сервера. ### Быстрые проверки @@ -231,7 +231,7 @@ opencode Desktop отображает системные уведомления --- -### Провидеринитеррор +### ProviderInitError Если вы столкнулись с ошибкой ProviderInitError, скорее всего, у вас неверная или поврежденная конфигурация. @@ -288,7 +288,7 @@ apt install -y xsel apt install -y wl-clipboard ``` -**Для безголовых сред:** +**Для headless-сред:** ```bash apt install -y xvfb diff --git a/packages/web/src/content/docs/ru/tui.mdx b/packages/web/src/content/docs/ru/tui.mdx index dcb07fb0e..0134e29c4 100644 --- a/packages/web/src/content/docs/ru/tui.mdx +++ b/packages/web/src/content/docs/ru/tui.mdx @@ -69,7 +69,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -### соединять +### connect Добавьте провайдера в opencode. Позволяет выбирать из доступных поставщиков и добавлять их ключи API. @@ -79,7 +79,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -### компактный +### compact Сжать текущий сеанс. _Псевдоним_: `/summarize` @@ -91,7 +91,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -### подробности +### details Переключить детали выполнения инструмента. @@ -103,7 +103,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -### редактор +### editor Открыть внешний редактор для составления сообщений. Использует редактор, установленный в переменной среды `EDITOR`. [Подробнее ](#editor-setup). @@ -115,7 +115,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -### Выход +### exit Выйдите из opencode. _Псевдонимы_: `/quit`, `/q` @@ -127,7 +127,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -### экспорт +### export Экспортируйте текущий разговор в Markdown и откройте его в редакторе по умолчанию. Использует редактор, установленный в переменной среды `EDITOR`. [Подробнее ](#editor-setup). @@ -139,7 +139,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -### помощь +### help Показать диалоговое окно помощи. @@ -151,7 +151,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -### инициализация +### init Создайте или обновите файл `AGENTS.md`. [Подробнее ](/docs/rules). @@ -163,7 +163,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -### модели +### models Перечислите доступные модели. @@ -175,7 +175,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -### новый +### new Начать новый сеанс. _Псевдоним_: `/clear` @@ -187,7 +187,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -### переделывать +### redo Повторить ранее отмененное сообщение. Доступно только после использования `/undo`. @@ -206,7 +206,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -### сессии +### sessions Составляйте список и переключайтесь между сеансами. _Псевдонимы_: `/resume`, `/continue` @@ -218,7 +218,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -### делиться +### share Поделиться текущим сеансом. [Подробнее](/docs/share). @@ -230,7 +230,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -### темы +### theme Список доступных тем. @@ -242,7 +242,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -### мышление +### thinking Переключить видимость блоков мышления/рассуждения в разговоре. Если этот параметр включен, вы можете увидеть процесс рассуждения модели для моделей, поддерживающих расширенное мышление. @@ -256,7 +256,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -### отменить +### undo Отменить последнее сообщение в разговоре. Удаляет самое последнее сообщение пользователя, все последующие ответы и любые изменения файлов. @@ -275,7 +275,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -### отменить совместное использование +### unshare Отменить общий доступ к текущему сеансу. [Подробнее](/docs/share#un-sharing). @@ -343,7 +343,7 @@ How is auth handled in @packages/functions/src/api/index.ts? - `vim` — редактор Vim - `nano` — Нано-редактор - `notepad` — Блокнот Windows -- `subl` – возвышенный текст +- `subl` — Sublime Text :::note Некоторые редакторы, такие как VS Code, необходимо запускать с флагом `--wait`. @@ -353,7 +353,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -## Настроить +## Настройка Вы можете настроить поведение TUI через файл конфигурации opencode. diff --git a/packages/web/src/content/docs/ru/web.mdx b/packages/web/src/content/docs/ru/web.mdx index 13a543cb3..53122749f 100644 --- a/packages/web/src/content/docs/ru/web.mdx +++ b/packages/web/src/content/docs/ru/web.mdx @@ -7,7 +7,7 @@ opencode может работать как веб-приложение в ва ![opencode Web — новый сеанс](../../../assets/web/web-homepage-new-session.png) -## Начиная +## Начало работы Запустите веб-интерфейс, выполнив: @@ -54,7 +54,7 @@ opencode web --hostname 0.0.0.0 Network access: http://192.168.1.100:4096 ``` -### обнаружение mDNS +### Обнаружение mDNS Включите mDNS, чтобы ваш сервер был доступен для обнаружения в локальной сети: diff --git a/packages/web/src/content/docs/ru/zen.mdx b/packages/web/src/content/docs/ru/zen.mdx index b5925c5d4..d0563bdcd 100644 --- a/packages/web/src/content/docs/ru/zen.mdx +++ b/packages/web/src/content/docs/ru/zen.mdx @@ -1,5 +1,5 @@ --- -title: Дзен +title: Zen description: Кураторский список моделей, предоставленный opencode. --- @@ -19,7 +19,7 @@ Zen работает как любой другой провайдер в openco --- -## Фон +## Предыстория Существует большое количество моделей, но лишь некоторые из них. эти модели хорошо работают в качестве агентов кодирования. Кроме того, большинство провайдеров @@ -114,41 +114,41 @@ https://opencode.ai/zen/v1/models Мы поддерживаем модель оплаты по мере использования. Ниже приведены цены **за 1 миллион токенов**. -| Модель | Вход | Выход | Кэшированное чтение | Кэшированная запись | -| ----------------------------------- | --------- | --------- | ------------------- | ------------------- | -| Большой рассол | Бесплатно | Бесплатно | Бесплатно | - | -| MiniMax M2.1 Free | Бесплатно | Бесплатно | Бесплатно | - | -| MiniMax M2.1 | $0.30 | $1.20 | $0.10 | - | -| ГЛМ 4.7 Бесплатно | Бесплатно | Бесплатно | Бесплатно | - | -| ГЛМ 4.7 | $0.60 | $2.20 | $0.10 | - | -| ГЛМ 4.6 | $0.60 | $2.20 | $0.10 | - | -| Кими K2.5 Бесплатно | Бесплатно | Бесплатно | Бесплатно | - | -| Как К2.5 | $0.60 | $3.00 | $0.08 | - | -| Кими К2 думает | $0.40 | $2.50 | - | - | -| Как К2 | $0.40 | $2.50 | - | - | -| Qwen3 Кодер 480B | $0.45 | $1.50 | - | - | -| Клод Сонет 4.5 (≤ 200 тыс. токенов) | $3.00 | $15.00 | $0.30 | $3.75 | -| Клод Сонет 4.5 (> 200 тыс. токенов) | $6.00 | $22.50 | $0.60 | $7.50 | -| Клод Сонет 4 (≤ 200 тыс. токенов) | $3.00 | $15.00 | $0.30 | $3.75 | -| Клод Сонет 4 (> 200 тыс. токенов) | $6.00 | $22.50 | $0.60 | $7.50 | -| Клод Хайку 4.5 | $1.00 | $5.00 | $0.10 | $1.25 | -| Клод Хайку 3.5 | $0.80 | $4.00 | $0.08 | $1.00 | -| Клод Опус 4.6 (≤ 200 тыс. токенов) | $5.00 | $25.00 | $0.50 | $6.25 | -| Клод Опус 4.6 (> 200 тыс. токенов) | $10.00 | $37.50 | $1.00 | $12.50 | -| Закрыть работу 4.5 | $5.00 | $25.00 | $0.50 | $6.25 | -| Закрыть работу 4.1 | $15.00 | $75.00 | $1.50 | $18.75 | -| Gemini 3 Pro (≤ 200 тыс. токенов) | $2.00 | $12.00 | $0.20 | - | -| Gemini 3 Pro (> 200 тыс. токенов) | $4.00 | $18.00 | $0.40 | - | -| Близнецы 3 Флэш | $0.50 | $3.00 | $0.05 | - | -| GPT 5.2 | $1.75 | $14.00 | $0.175 | - | -| Кодекс GPT 5.2 | $1.75 | $14.00 | $0.175 | - | -| GPT 5.1 | $1.07 | $8.50 | $0.107 | - | -| Кодекс GPT 5.1 | $1.07 | $8.50 | $0.107 | - | -| Кодекс GPT 5.1 Макс. | $1.25 | $10.00 | $0.125 | - | -| Кодекс GPT 5.1 Мини | $0.25 | $2.00 | $0.025 | - | -| GPT 5 | $1.07 | $8.50 | $0.107 | - | -| Кодекс GPT 5 | $1.07 | $8.50 | $0.107 | - | -| ГПТ 5 Нано | Бесплатно | Бесплатно | Бесплатно | - | +| Модель | Вход | Выход | Кэшированное чтение | Кэшированная запись | +| -------------------------------------- | --------- | --------- | ------------------- | ------------------- | +| Big Pickle | Бесплатно | Бесплатно | Бесплатно | - | +| MiniMax M2.1 Free | Бесплатно | Бесплатно | Бесплатно | - | +| MiniMax M2.1 | $0.30 | $1.20 | $0.10 | - | +| GLM 4.7 Free | Бесплатно | Бесплатно | Бесплатно | - | +| GLM 4.7 | $0.60 | $2.20 | $0.10 | - | +| GLM 4.6 | $0.60 | $2.20 | $0.10 | - | +| Kimi K2.5 Free | Бесплатно | Бесплатно | Бесплатно | - | +| Kimi K2.5 | $0.60 | $3.00 | $0.08 | - | +| Kimi K2 Thinking | $0.40 | $2.50 | - | - | +| Kimi K2 | $0.40 | $2.50 | - | - | +| Qwen3 Coder 480B | $0.45 | $1.50 | - | - | +| Claude Sonnet 4.5 (≤ 200 тыс. токенов) | $3.00 | $15.00 | $0.30 | $3.75 | +| Claude Sonnet 4.5 (> 200 тыс. токенов) | $6.00 | $22.50 | $0.60 | $7.50 | +| Claude Sonnet 4 (≤ 200 тыс. токенов) | $3.00 | $15.00 | $0.30 | $3.75 | +| Claude Sonnet 4 (> 200 тыс. токенов) | $6.00 | $22.50 | $0.60 | $7.50 | +| Claude Haiku 4.5 | $1.00 | $5.00 | $0.10 | $1.25 | +| Claude Haiku 3.5 | $0.80 | $4.00 | $0.08 | $1.00 | +| Claude Opus 4.6 (≤ 200 тыс. токенов) | $5.00 | $25.00 | $0.50 | $6.25 | +| Claude Opus 4.6 (> 200 тыс. токенов) | $10.00 | $37.50 | $1.00 | $12.50 | +| Claude Opus 4.5 | $5.00 | $25.00 | $0.50 | $6.25 | +| Claude Opus 4.1 | $15.00 | $75.00 | $1.50 | $18.75 | +| Gemini 3 Pro (≤ 200 тыс. токенов) | $2.00 | $12.00 | $0.20 | - | +| Gemini 3 Pro (> 200 тыс. токенов) | $4.00 | $18.00 | $0.40 | - | +| Gemini 3 Flash | $0.50 | $3.00 | $0.05 | - | +| GPT 5.2 | $1.75 | $14.00 | $0.175 | - | +| GPT 5.2 Codex | $1.75 | $14.00 | $0.175 | - | +| GPT 5.1 | $1.07 | $8.50 | $0.107 | - | +| GPT 5.1 Codex | $1.07 | $8.50 | $0.107 | - | +| GPT 5.1 Codex Max | $1.25 | $10.00 | $0.125 | - | +| GPT 5.1 Codex Mini | $0.25 | $2.00 | $0.025 | - | +| GPT 5 | $1.07 | $8.50 | $0.107 | - | +| GPT 5 Codex | $1.07 | $8.50 | $0.107 | - | +| GPT 5 Nano | Бесплатно | Бесплатно | Бесплатно | - | Вы можете заметить _Claude Haiku 3.5_ в своей истории использования. Это [недорогая модель](/docs/config/#models), которая используется для создания заголовков ваших сеансов. @@ -167,7 +167,7 @@ https://opencode.ai/zen/v1/models --- -### Автоматическая перезагрузка +### Автопополнение Если ваш баланс упадет ниже 5 долларов, Zen автоматически пополнит 20 долларов. @@ -191,9 +191,9 @@ https://opencode.ai/zen/v1/models Все наши модели размещены в США. Наши поставщики придерживаются политики нулевого хранения и не используют ваши данные для обучения моделей, за следующими исключениями: - Big Pickle: во время бесплатного периода собранные данные могут быть использованы для улучшения модели. -- GLM 4.7 Бесплатная: в течение бесплатного периода собранные данные могут использоваться для улучшения модели. +- GLM 4.7 Free: в течение бесплатного периода собранные данные могут использоваться для улучшения модели. - Kimi K2.5 Free: в течение бесплатного периода собранные данные могут использоваться для улучшения модели. -- MiniMax M2.1 Бесплатно: в течение бесплатного периода собранные данные могут использоваться для улучшения модели. +- MiniMax M2.1 Free: в течение бесплатного периода собранные данные могут использоваться для улучшения модели. - API OpenAI: запросы хранятся в течение 30 дней в соответствии с [Политикой данных OpenAI](https://platform.openai.com/docs/guides/your-data). - API-интерфейсы Anthropic: запросы хранятся в течение 30 дней в соответствии с [Политикой данных Anthropic](https://docs.anthropic.com/en/docs/claude-code/data-usage). diff --git a/packages/web/src/content/docs/th/acp.mdx b/packages/web/src/content/docs/th/acp.mdx index b5897a480..f7850ed40 100644 --- a/packages/web/src/content/docs/th/acp.mdx +++ b/packages/web/src/content/docs/th/acp.mdx @@ -3,13 +3,13 @@ title: การรองรับ ACP description: ใช้ OpenCode ในโปรแกรมแก้ไขที่รองรับ ACP --- -OpenCode ที่แสดง [Agent Client Protocol](https://agentclientprotocol.com) หรือ (ACP) ซึ่งสามารถช่วยได้โดยตรงในการแก้ไขและ IDE ที่หน่วยความจำ +OpenCode รองรับ [Agent Client Protocol](https://agentclientprotocol.com) (ACP) ซึ่งช่วยให้สามารถทำงานร่วมกับ editor และ IDE ต่างๆ ได้โดยตรง :::tip -สำหรับรายชื่อและเครื่องมือที่รองรับ ACPรายงานที่[ACP รายงาน](https://zed.dev/blog/acp-progress-report#available-now) +สำหรับรายชื่อเครื่องมือที่รองรับ ACP สามารถดูได้ที่ [ACP progress report](https://zed.dev/blog/acp-progress-report#available-now) ::: -ACP เป็นแบบเปิดมาตรฐานการสื่อสารระหว่างโปรแกรมแก้ไขโค้ดและตัวแทน AI +ACP เป็นมาตรฐานเปิดสำหรับการสื่อสารระหว่างโปรแกรมแก้ไขโค้ดและ AI agent --- @@ -17,7 +17,7 @@ ACP เป็นแบบเปิดมาตรฐานการสื่อ ในการใช้ OpenCode ผ่าน ACP ให้กำหนดค่าโปรแกรมแก้ไขของคุณให้รันคำสั่ง `opencode acp` -คำสั่งนี้จะเริ่ม OpenCode เป็นกระบวนการย่อยที่เข้ากันได้กับ ACP ซึ่งสื่อสารกับโปรแกรมแก้ไขของคุณผ่าน JSON-RPC ผ่าน stdio +คำสั่งนี้จะเริ่ม OpenCode เป็น process ย่อยที่รองรับ ACP ซึ่งสื่อสารกับโปรแกรมแก้ไขของคุณผ่าน JSON-RPC ทาง stdio นี่คือตัวอย่างสำหรับโปรแกรมแก้ไขยอดนิยมที่รองรับ ACP @@ -25,7 +25,7 @@ ACP เป็นแบบเปิดมาตรฐานการสื่อ ### Zed -อดทนต่อไป [Zed](https://zed.dev) (`~/.config/zed/settings.json`): +สำหรับ [Zed](https://zed.dev) (`~/.config/zed/settings.json`): ```json title="~/.config/zed/settings.json" { @@ -38,9 +38,9 @@ ACP เป็นแบบเปิดมาตรฐานการสื่อ } ``` -สิ่งนั้นเปิดใช้สำหรับ `agent: new thread` ใน **Command Palette** +สิ่งนี้จะเปิดใช้ `agent: new thread` ใน **Command Palette** -คุณต้องผูกมัดอย่างหนักเพื่อแก้ไข `keymap.json` ของคุณ: +คุณต้องตั้งค่า keybinding ใน `keymap.json` ของคุณ: ```json title="keymap.json" [ @@ -101,7 +101,7 @@ ACP เป็นแบบเปิดมาตรฐานการสื่อ } ``` -จะต้องส่งผ่านวันพรุ่งนี้: +หากคุณต้องการส่งผ่าน environment variables (เช่น `OPENCODE_API_KEY`) คุณต้องระบุใน `env`: ```lua {6-8} { diff --git a/packages/web/src/content/docs/th/agents.mdx b/packages/web/src/content/docs/th/agents.mdx index 83b9bb942..567125ace 100644 --- a/packages/web/src/content/docs/th/agents.mdx +++ b/packages/web/src/content/docs/th/agents.mdx @@ -1,142 +1,140 @@ --- -title: ตัวแทน -description: และตัวแทนพิเศษ +title: เอเจนต์ +description: เอเจนต์พิเศษและปรับแต่งได้ --- -เจ้าหน้าที่คือผู้ช่วย AI ในช่องทางต่างๆ ของอินเทอร์เฟซและอินเทอร์เฟซของโฟลว์เฉพาะได้สามารถสร้างเครื่องมือที่รวบรวมข้อมูลด้วยโมดูลและอินเทอร์เฟซของอินเทอร์เฟซ... +เอเจนต์ (Agent) คือผู้ช่วย AI ที่เชี่ยวชาญในงานเฉพาะด้าน คุณสามารถสร้างเอเจนต์ที่มีเครื่องมือ (tools) ที่เหมาะสมกับงานและคำสั่งระบบ (system prompt) ที่ต้องการได้ :::tip -ใช้แผนของตัวแทนเพื่อวิเคราะห์โค้ดและทบทวนเหตุผลในการทำการเปลี่ยนแปลงโค้ดใดๆ +ใช้เอเจนต์ **Plan** เพื่อวิเคราะห์โค้ดและตรวจสอบเหตุผลก่อนทำการเปลี่ยนแปลงโค้ดใดๆ ::: -การผสมผสานระหว่างตัวแทนระหว่างการประชุมหรือต้องการโดยระบุ `@` +คุณสามารถสลับเอเจนต์ได้ระหว่างการสนทนาโดยใช้ปุ่ม **Tab** หรือเรียกใช้โดยระบุ `@` --- ## ประเภท -OpenCode มีเอเจนต์สองประเภทตัวแทนหลักและตัวแทนย่อย +OpenCode มีเอเจนต์สองประเภท: **Primary Agent** (เอเจนต์หลัก) และ **Subagent** (เอเจนต์ย่อย) --- -### ตัวแทนหลัก +### Primary Agent (เอเจนต์หลัก) -ตัวแทนหลักคือผู้ช่วยหลักที่คุณมักจะเกิดขึ้นด้วยโดยตรงในวนดูได้เฉพาะปุ่ม **Tab** หรือปุ่ม `switch_agent` ที่โน่ไว้เจ้าหน้าที่สามารถจัดการระบบของคุณได้โดยได้รับเครื่องมือที่มีคุณลักษณะหลักเช่น Build มีเครื่องมือทั้งหมดในส่วนของแผนถูกจำกัด +Primary Agent คือผู้ช่วยหลักที่คุณคุยด้วยโดยตรง คุณสามารถวนดูเอเจนต์หลักที่มีอยู่ได้โดยกดปุ่ม **Tab** หรือปุ่ม `switch_agent` ที่ตั้งค่าไว้ เอเจนต์เหล่านี้สามารถจัดการงานที่ซับซ้อนและเข้าถึงเครื่องมือที่มีความเสี่ยงสูงได้ เช่น **Build** ที่มีเครื่องมือทั้งหมด หรือ **Plan** ที่ถูกจำกัดสิทธิ์ :::tip -**Tab** บันทึกเรื่องราวระหว่างตัวแทนหลักดื่มด่ำได้ +**Tab** จะเก็บประวัติการสนทนาไว้เมื่อสลับระหว่างเอเจนต์ ::: -OpenCode ของเอเจนต์หลักในตัวได้แก่ **Build** และ **Plan** ดี -ดูด้านล่าง +OpenCode มีเอเจนต์หลักในตัวได้แก่ **Build** และ **Plan** +ดูรายละเอียดด้านล่าง --- -### ตัวแทนย่อย +### Subagent (เอเจนต์ย่อย) -ตัวแทนย่อยคือผู้ช่วยเฉพาะทางที่ตัวแทนหลักสามารถเรียกงานเฉพาะได้เฉพาะเรียกได้โดยตรงโดย **@ หมายถึง**ความหมายในข้อความของคุณ +Subagent คือผู้ช่วยเฉพาะทางที่ Primary Agent สามารถเรียกใช้งานได้ หรือคุณสามารถเรียกใช้โดยตรงโดยพิมพ์ **@** ตามด้วยชื่อเอเจนต์ในข้อความของคุณ -OpenCode ในการควบคุมเอเจนต์ย่อยในส่วนนี้ได้แก่ **ทั่วไป** และ **สำรวจ** ส่วนดูพื้นที่ +OpenCode มี subagent ในตัวได้แก่ **General** และ **Explore** --- ## บิวท์อิน -OpenCode สืบสวนเอเจนต์หลักในตัวและเอเจนต์ย่อยในอีกหนึ่ง +OpenCode มาพร้อมกับเอเจนต์หลักและ subagent ในตัวดังนี้ --- -### ใช้บิลด์ +### Build _Mode_: `primary` -สร้างเว็บหลัก **รองรับ** พร้อมด้วยเครื่องมือทั้งหมดที่มีเอเจนต์มาตรฐานเพื่อให้มีสิทธิ์การเข้าถึงไฟล์และคำสั่งระบบโดยสมบูรณ์ +เอเจนต์หลักสำหรับ **การพัฒนา** มาพร้อมกับเครื่องมือทั้งหมดเพื่อให้มีสิทธิ์การเข้าถึงไฟล์และคำสั่งระบบโดยสมบูรณ์ --- -### ใช้แผน +### Plan _Mode_: `primary` -ตัวแทนแบบจำกัดที่ความเชื่อถือและการควบคุมระบบของการที่แจ้งให้ทราบอย่างเป็นทางการและป้องกันการเปลี่ยนแปลงโดยเฉพาะอย่างยิ่ง -ตามคำอธิบายตามลำดับทั้งหมดของระบบเป็น `ask`: +เอเจนต์ที่ถูกจำกัดสิทธิ์ เน้นการคิดวิเคราะห์และวางแผน โดยป้องกันการเปลี่ยนแปลงไฟล์โดยไม่ได้ตั้งใจ +เครื่องมือต่อไปนี้จะถูกตั้งค่าเป็น `ask` (ต้องขออนุญาต): -- `file edits`: เนื้อหา แพตช์ และเป็นที่ทั้งหมด +- `file edits`: การแก้ไขไฟล์, patch, และการเขียนไฟล์ - `bash`: คำสั่ง bash ทั้งหมด -เอเจนต์นี้มีประโยชน์ต้องการให้ LLM ตรวจสอบโค้ดตรวจสอบการเปลี่ยนแปลงหรือสร้างแผนว่าจะทำดีเบสของคุณจริง +เอเจนต์นี้มีประโยชน์เมื่อต้องการให้ LLM ตรวจสอบโค้ด หรือสร้างแผนงานก่อนที่จะลงมือทำจริง --- -### ใช้ทั่วไป +### General _Mode_: `subagent` -ตัวแทนเพื่อค้นหาคำถามที่จำเป็นและต่อเนื่องหลายขั้นตอน อนุญาตให้เข้าถึงเครื่องมือต่างๆ (ยกเว้นการตรวจสอบ) และการปรับปรุงไฟล์ได้เมื่อจำเป็นต้องใช้สิ่งนี้เพื่อรันงานหลายหน่วยพร้อมกัน +เอเจนต์สำหรับตอบคำถามทั่วไปและการคิดวิเคราะห์หลายขั้นตอน อนุญาตให้เข้าถึงเครื่องมือต่างๆ (ยกเว้นการแก้ไขไฟล์) ใช้สิ่งนี้เมื่อต้องการรันงานที่ไม่ต้องแก้ไขโค้ด --- -### ใช้สำรวจ +### Explore _Mode_: `subagent` -เอเจนต์ความเร็วสูงและอ่านอย่างเดียวสำหรับฐานพื้นฐานโค้ดและตรวจดูไฟล์ได้ใช้สิ่งนี้เมื่อคุณต้องการค้นหาไฟล์อย่างรวดเร็วรูปแบบตามค้นหาโค้ดด้วยคำสำคัญหรือแบบสอบถามเกี่ยวกับโค้ดเบส +เอเจนต์ความเร็วสูงสำหรับอ่านและสำรวจ codebase ใช้สิ่งนี้เมื่อคุณต้องการค้นหาไฟล์อย่างรวดเร็ว, ค้นหาโค้ดด้วยคำสำคัญ, หรือสอบถามเกี่ยวกับโครงสร้าง codebase --- -### ใช้การบดอัด +### Compact _Mode_: `primary` -เอเจนต์ระบบนั้นมีส่วนช่วยในการสรุปที่ยาวไปสู่บทสรุปที่เล็กลงโดยเฉพาะอย่างยิ่งเมื่อจำเป็นต้องมีและใน UI +เอเจนต์ระบบที่มีหน้าที่สรุปประวัติการสนทนาที่ยาวให้สั้นลง โดยยังคงใจความสำคัญไว้ --- -### ใช้ชื่อ +### Name _Mode_: `primary` -ตัวแทนของระบบซึ่งสร้างชื่อที่ออกแบบสั้น ๆ มันทำงานได้โดยไม่ต้องใช้ UI +เอเจนต์ระบบที่มีหน้าที่สร้างชื่อ session ให้สั้นและได้ใจความ ทำงานอัตโนมัติโดยไม่ต้องมี UI --- -### ใช้สรุป +### Summarize _Mode_: `primary` -ตัวแทนระบบนั้นซึ่งสร้างสรุปการตรวจสอบและทำงานโดยไม่ต้องมี UI +เอเจนต์ระบบที่มีหน้าที่สร้างสรุปการเปลี่ยนแปลงและงานที่ทำไป ทำงานอัตโนมัติโดยไม่ต้องมี UI --- -## เรื่องนั้น +## การใช้งาน -1. สำหรับตัวแทนหลักให้ใช้ปุ่ม **Tab** เพื่อวนดูตัวแทนที่มีความสำคัญ โปรดใช้การผูกปุ่ม `switch_agent` ที่โรงยิมไว้ได้ +1. สำหรับ Primary Agent ให้ใช้ปุ่ม **Tab** เพื่อวนดูเอเจนต์ที่มีอยู่ หรือใช้ keybind `switch_agent` ที่คุณตั้งค่าไว้ -2. สามารถตัวแทนย่อยได้: - - \*\*\*\*โดยตัวแทนหลักโดยเฉพาะพิเศษตามคำอธิบาย - - เพิ่มเติมโดย **@ ต้องการ** ตัวแทนย่อยในข้อความของคุณเช่น +2. สำหรับ Subagent: + - เรียกใช้โดย Primary Agent โดยอัตโนมัติตามความเหมาะสม + - เรียกใช้ด้วยตนเองโดยพิมพ์ **@** ตามด้วยชื่อ subagent ในข้อความของคุณ เช่น ```txt frame="none" @general help me search for this function ``` -3. **ปรับปรุงระหว่างการปรับปรุง**: เมื่อตัวแทนย่อยสร้างหลังคาและเรียนรู้ร่วมกันระหว่างการปรับปรุงหลักและหลังคาทั้งหมดได้ทั้งหมด: - - **\+Right** (หรือ `session_child_cycle` keybind ที่คุณรู้ไว้) ในวนผ่าน parent → child1 → child2 → ... → parent - - **\+Left** (หรือฟัง `session_child_cycle_reverse` keybind) เพื่อวนย้อนกลับผ่าน parent ← child1 ← child2 ← ... ← parent - - เรียนรู้การดำเนินการระหว่างการดำเนินการหลักและงานตัวแทนย่อยเฉพาะเจาะจง +3. **การนำทางระหว่าง Agent**: เมื่อ Subagent ทำงานเสร็จและส่งผลลัพธ์กลับมายัง Primary Agent คุณสามารถดูประวัติการทำงานได้: + - **\+Right** (หรือ `session_child_cycle` keybind) เพื่อวนผ่าน parent → child1 → child2 → ... → parent + - **\+Left** (หรือ `session_child_cycle_reverse` keybind) เพื่อวนย้อนกลับผ่าน parent ← child1 ← child2 ← ... ← parent --- ## การกำหนดค่า -ปรับแต่งเอเจนต์ในหรือสร้างเอเจนต์ได้ผ่านมาได้อย่างไม่น่าเชื่อตัวแทนได้สองวิธี: +คุณสามารถปรับแต่งเอเจนต์ที่มีอยู่หรือสร้างเอเจนต์ใหม่ได้สองวิธี: --- ### JSON -ไม่เชื่อตัวแทนในไฟล์ในกรุง `opencode.json` ของคุณ: +กำหนดค่าเอเจนต์ในไฟล์ `opencode.json` ของคุณ: ```json title="opencode.json" { @@ -179,10 +177,10 @@ _Mode_: `primary` ### Markdown -คุณอาจกำหนดเอเจนต์สำหรับไฟล์ Markdown ได้หลายสีใน: +คุณสามารถกำหนดเอเจนต์ด้วยไฟล์ Markdown ได้ใน: -- ทั่วโลก: `~/.config/opencode/agents/` -- ต่อโครงการ: `.opencode/agents/` +- ระดับผู้ใช้ (Global): `~/.config/opencode/agents/` +- ระดับโปรเจ็กต์: `.opencode/agents/` ```markdown title="~/.config/opencode/agents/review.md" --- @@ -206,19 +204,19 @@ You are in code review mode. Focus on: Provide constructive feedback without making direct changes. ``` -ชื่อไฟล์ Markdown พร้อมกับชื่อเอเจนต์เช่น `review.md` สร้างตัวแทน `review` +ชื่อไฟล์ Markdown จะกลายเป็นชื่อเอเจนต์ เช่น `review.md` สร้างเอเจนต์ `review` --- ## ตัวเลือก -มาดูรายละเอียดเพิ่มเติมที่จุดนั้นกัน +มาดูรายละเอียดของตัวเลือกต่างๆ --- -### Description +### Description (คำอธิบาย) -ใช้ฟีเจอร์ `description` เพื่อให้คำอธิบายสีนี้ทำอะไรและแนะนำเมื่อใด +ใช้ฟิลด์ `description` เพื่ออธิบายว่าเอเจนต์นี้ทำอะไร ```json title="opencode.json" { @@ -230,15 +228,15 @@ Provide constructive feedback without making direct changes. } ``` -รายการไม่จำเป็น **จำเป็น** +ฟิลด์นี้ **จำเป็น** สำหรับ JSON --- -### Temperature +### Temperature (อุณหภูมิ) -เหตุผลของการสุ่มและการตอบกลับของ LLM ด้วย `temperature` +ควบคุมความสุ่มและความคิดสร้างสรรค์ของการตอบกลับของ LLM ด้วย `temperature` -ค่าที่ต่ำกว่านี้จะตอบสนองมีจุดมุ่งหมายและทราบถึงค่าที่จะช่วยลดการส่งผลและส่งผลถึง +ค่าที่ต่ำกว่าจะให้ผลลัพธ์ที่แน่นอนและแม่นยำกว่า ส่วนค่าที่สูงกว่าจะให้ความหลากหลายและความคิดสร้างสรรค์มากกว่า ```json title="opencode.json" { @@ -253,11 +251,11 @@ Provide constructive feedback without making direct changes. } ``` -อุณหภูมิจะเท่ากัน 0.0 ถึง 1.0: +ช่วงอุณหภูมิอยู่ระหว่าง 0.0 ถึง 1.0: -- **0.0-0.2**: สิ่งที่เราคาดการณ์และกำหนดไว้เป็นไปได้และวางแผนโค้ด -- **0.3-0.5**: ปฏิกิริยาที่สมดุลและเป็นผลให้เกิดงานพัฒนาทั่วไป -- **0.6-1.0**: คำตอบที่สร้างสรรค์และหลากหลายมากขึ้นซึ่งมีประโยชน์สำหรับการศึกษาและต่อไป +- **0.0-0.2**: แน่นอนและแม่นยำ เหมาะสำหรับการเขียนโค้ดและการวางแผน +- **0.3-0.5**: สมดุล เหมาะสำหรับการพัฒนาทั่วไป +- **0.6-1.0**: สร้างสรรค์ เหมาะสำหรับการระดมสมอง ```json title="opencode.json" { @@ -277,15 +275,15 @@ Provide constructive feedback without making direct changes. } ``` -ข้อสังเกตอุณหภูมิ OpenCode โดยทั่วไปจะมีเฉพาะรุ่นเท่านั้นแล้ว 0 สำหรับรุ่นส่วนใหญ่ 0.55 สำหรับรุ่น Qwen +หมายเหตุ: OpenCode ค่าเริ่มต้นคือ 0 สำหรับโมเดลส่วนใหญ่ และ 0.55 สำหรับโมเดล Qwen --- -### Max steps +### Steps (ขั้นตอน) -จำนวนส่วนประกอบของการวนซ้ำของเอเจนต์ที่เอเจนต์เป็นผลสืบเนื่องด้วยข้อความเท่านั้นวิธีการที่ต้องการควบคุมต้นทุนสามารถกำหนดได้ในแนวทางที่ตัวแทนได้ +จำกัดจำนวนการวนซ้ำ (iterations) สูงสุดที่เอเจนต์สามารถทำได้ เพื่อควบคุมค่าใช้จ่ายและป้องกันการทำงานไม่รู้จบ -หากไม่ได้ตั้งค่านี้ เอเจนต์จะดำเนินต่อไปจนกว่าโมเดลจะจะหยุดหรือผู้ใช้ขัดจังหวะ +หากไม่ได้ตั้งค่านี้ เอเจนต์จะทำงานต่อไปจนกว่างานจะเสร็จหรือผู้ใช้ขัดจังหวะ ```json title="opencode.json" { @@ -299,17 +297,17 @@ Provide constructive feedback without making direct changes. } ``` -ไปถึงความโดดเด่นจะได้รับพร้อมท์พิเศษที่แนะนำให้เรียนรู้ด้วยการสรุปงานและงานที่เหลืออีกครั้ง +เมื่อถึงขีดจำกัด เอเจนต์จะได้รับพรอมต์พิเศษเพื่อสรุปงานและสิ่งที่เหลืออยู่ :::caution -ช่อง `maxSteps` แบบเดิมเลิกใช้แล้วใช้ `steps` แทน +ฟิลด์ `maxSteps` แบบเดิมเลิกใช้แล้ว โปรดใช้ `steps` แทน ::: --- -### Disable +### Disable (ปิดใช้งาน) -ตั้งค่าเป็น `true` ไปถึงสมาชิก +ตั้งค่าเป็น `true` เพื่อปิดการใช้งานเอเจนต์ ```json title="opencode.json" { @@ -323,9 +321,9 @@ Provide constructive feedback without making direct changes. --- -### Prompt +### พรอมต์ -ระบุไฟล์พร้อมท์ระบบสำหรับเอเจนต์นี้ด้วย `prompt`ความละเอียดสูงพร้อมคำแนะนำเฉพาะสำหรับกรณีของตัวแทน +ระบุ System Prompt สำหรับเอเจนต์นี้ด้วย `prompt` ```json title="opencode.json" { @@ -337,16 +335,16 @@ Provide constructive feedback without making direct changes. } ``` -เกี่ยวเนื่องกับสิ่งนี้กับระบบไฟล์ที่อาจเป็นสาเหตุว่าทำไมจึงสามารถใช้ได้กับทั้ง OpenCode ส่วนกลางและเฉพาะโครงการ +รองรับเส้นทางสัมพัทธ์ (Relative paths) ซึ่งทำให้ใช้งานได้สะดวกทั้งในระดับ Global และ Project --- -### Model +### Model (โมเดล) -ใช้ฟังก์ชัน `model` ในส่วนของโมเดลโมเดลสำหรับเอเจนต์นี้มีประโยชน์สำหรับการใช้โมเดลโมเลกุลซึ่งปรับให้เหมาะกับงานโครงสร้างเช่นโมดูลสำหรับโมดูลที่ตรวจสอบที่เก็บข้อมูลจำนวนมากสำหรับการดำเนินการ +ใช้ตัวเลือก `model` เพื่อกำหนดโมเดลเฉพาะสำหรับเอเจนต์นี้ มีประโยชน์เมื่อต้องการใช้โมเดลที่เชี่ยวชาญเฉพาะด้าน หรือโมเดลที่มี Context window ขนาดใหญ่สำหรับการตรวจสอบ codebase :::tip -ไม่ได้ระบุโมเดลตัวแทนหลักๆ [ โมเดลที่ build ทั่วโลก](/docs/config#models) ทำให้ตัวแทนย่อยในเมนูของตัวแทนหลักที่ทอดตัวแทนย่อยทั่วโลก +หากไม่ได้ระบุโมเดล เอเจนต์จะใช้ [โมเดลเริ่มต้น](/docs/config#models) ของ OpenCode ::: ```json title="opencode.json" @@ -359,13 +357,13 @@ Provide constructive feedback without making direct changes. } ``` -รหัสโมเดลในบางครั้ง OpenCode ของคุณใช้รูปแบบ `provider/model-id` เช่นต้องใช้ [OpenCode Zen](/docs/zen) แล้วก็ใช้ `opencode/gpt-5.1-codex` สำหรับ GPT 5.1 Codex +ID ของโมเดลใช้รูปแบบ `provider/model-id` --- ### เครื่องมือ -พื้นฐานว่าเครื่องมือนี้สามารถตรวจสอบประสิทธิภาพของเอเจนต์ด้วย `tools` วิจัยเปิดหรือตรวจสอบเครื่องมือเฉพาะเจาะจงเป็น `true` หรือ `false` +กำหนดเครื่องมือที่เอเจนต์สามารถใช้งานได้ด้วย `tools` คุณสามารถระบุชื่อเครื่องมือ หรือใช้ wildcard ```json title="opencode.json" {3-6,9-12} { @@ -386,10 +384,10 @@ Provide constructive feedback without making direct changes. ``` :::note -ความพยายามเฉพาะเอเจนต์จะเน้นไปที่ส่วนกลาง +การกำหนดค่าเครื่องมือในระดับเอเจนต์จะมีความสำคัญเหนือกว่าระดับ Global ::: -จำเป็นต้องใช้ไวด์การ์ดเพื่อควบคุมเครื่องมือหลายรายการพร้อมกันได้ยืนยันว่าเครื่องมือทั้งหมดจากเซิร์ฟเวอร์ MCP: +คุณสามารถใช้ wildcard `*` เพื่อควบคุมเครื่องมือหลายรายการพร้อมกัน เช่น เครื่องมือจากเซิร์ฟเวอร์ MCP: ```json title="opencode.json" { @@ -410,13 +408,13 @@ Provide constructive feedback without making direct changes. --- -### สิทธิ์ +### Permissions (สิทธิ์) -หลักการที่ถูกต้องเพื่อประสิทธิภาพในการดำเนินการที่ตัวแทนหลายแห่งในปัจจุบันความสามารถในการสำหรับเครื่องมือ `edit`, `bash` และ `webfetch` ได้อย่างมีประสิทธิภาพเป็น: +กำหนดสิทธิ์สำหรับเครื่องมือที่มีความละเอียดอ่อน เช่น `edit`, `bash` และ `webfetch`: -- `"ask"` — อนุมัติก่อนการเข้าถึงเครื่องมือ -- `"allow"` — ประสิทธิภาพการทำงานทั้งหมดเป็นเพียง... -- `"deny"` — มันเป็นเครื่องมือ +- `"ask"` — ต้องขออนุมัติจากผู้ใช้ก่อน +- `"allow"` — อนุญาตให้ทำงานได้โดยไม่ต้องถาม +- `"deny"` — ไม่อนุญาตให้ใช้ ```json title="opencode.json" { @@ -427,7 +425,7 @@ Provide constructive feedback without making direct changes. } ``` -ทำให้คุณมีสิทธิ์ที่จะต่อตัวแทนได้ +คุณสามารถกำหนดสิทธิ์ในระดับเอเจนต์ได้: ```json title="opencode.json" {3-5,8-10} { @@ -445,7 +443,7 @@ Provide constructive feedback without making direct changes. } ``` -คุณไม่จำเป็นต้องมีสิทธิ์ในตัวแทน Markdown +ใน Markdown agent: ```markdown title="~/.config/opencode/agents/review.md" --- @@ -464,7 +462,7 @@ permission: Only analyze code and suggest changes. ``` -การตั้งค่าเริ่มต้นสำหรับคำสั่งทุบตีเฉพาะได้ +คุณสามารถกำหนดสิทธิ์สำหรับคำสั่ง bash เฉพาะได้: ```json title="opencode.json" {7} { @@ -482,7 +480,7 @@ Only analyze code and suggest changes. } ``` -นี่อาจใช้รูปแบบ glob +รองรับ glob patterns: ```json title="opencode.json" {7} { @@ -499,8 +497,7 @@ Only analyze code and suggest changes. } ``` -และอีกครั้งใช้ `*` wildcard เพื่อให้สิทธิ์สำหรับคำสั่งทั้งหมดได้ -เมื่อกฎเริ่มขึ้นล่าสุดมีความสำคัญมากกว่าที่จะใส่ `*` ไวด์การ์ดขึ้นนำและกฎเฉพาะตามหลัง +ใช้ `*` wildcard เพื่อตั้งค่าเริ่มต้นสำหรับคำสั่งอื่นๆ ทั้งหมด กฎที่ตรงกันล่าสุดจะมีผลบังคับใช้ (Last match wins): ```json title="opencode.json" {8} { @@ -518,13 +515,13 @@ Only analyze code and suggest changes. } ``` -[เรียนรู้เพิ่มเติมเกี่ยวกับเรื่องนี้](/docs/permissions) +[เรียนรู้เพิ่มเติมเกี่ยวกับสิทธิ์](/docs/permissions) --- -### Mode +### Mode (โหมด) -ต้นแบบโหมดของตัวแทนด้วย `mode` บันทึก `mode` บันทึกวิธีการกำหนดวิธีการใช้ตัวแทน +กำหนดโหมดของเอเจนต์ด้วย `mode` ```json title="opencode.json" { @@ -536,13 +533,13 @@ Only analyze code and suggest changes. } ``` -สวัสดี `mode` สามารถตั้งค่าเป็น `primary`, `subagent` หรือ `all` หากไม่ได้ระบุ `mode` ระบบระบบควบคุมเป็น `all` +`mode` สามารถเป็น `primary`, `subagent` หรือ `all` หากไม่ระบุ ค่าเริ่มต้นจะเป็น `all` --- -### Hidden +### Hidden (ซ่อน) -ซ่อนตัวแทนย่อยจากเมนูเติมข้อความอัตโนมัติ `@` ด้วย `hidden: true` มีประโยชน์สำหรับตัวแทนย่อยภายในจำเป็นต้องมีโปรแกรมโดยทางอื่นตัวแทนผ่านเครื่องมืองานเท่านั้น +ซ่อน subagent จากเมนู autocomplete `@` ด้วย `hidden: true` มีประโยชน์สำหรับ subagent ภายในที่ถูกเรียกใช้โดยเอเจนต์อื่นผ่านเครื่องมือ task เท่านั้น ```json title="opencode.json" { @@ -555,17 +552,15 @@ Only analyze code and suggest changes. } ``` -ในที่สุดคุณจะพบในเมนูเติมข้อความอัตโนมัติเท่านั้นที่จำเป็นต้องมีเอเจนต์ที่เป็นได้ผ่านเครื่องมืองานหากต้องการ - :::note -สามารถตัวแทน `mode: subagent` ได้ +ใช้ได้กับเอเจนต์ที่มี `mode: subagent` เท่านั้น ::: --- -### Task permissions +### Task Permissions (สิทธิ์งาน) -ต้นแบบตัวแทนย่อยที่ตัวแทนสามารถต้องใช้เครื่องมือผ่านงานด้วย `permission.task` ใช้รูปแบบ glob ส่วนใหญ่ที่ใหญ่ขึ้น +กำหนดว่า subagent ใดที่เอเจนต์นี้สามารถเรียกใช้ได้ผ่านเครื่องมือ task ด้วย `permission.task` ```json title="opencode.json" { @@ -584,23 +579,19 @@ Only analyze code and suggest changes. } ``` -ตั้งเป็น `deny` แอดเจนต์ย่อยจะลบคำอธิบายเครื่องมืองานทั้งหมดนั่นคือโมเดลจะไม่พยายามทำอะไร +หากตั้งเป็น `deny` เอเจนต์จะมองไม่เห็นเครื่องมือ task สำหรับ subagent นั้นๆ :::tip -กฎเพื่อให้ชนะตามลำดับและ **กฎส่วนใหญ่ส่วนใหญ่จะสุดท้ายจะ** ในตัวอย่าง `orchestrator-planner` ตรงกับทั้ง `*` (ปฏิเสธ) และ `orchestrator-*` (อาจจะ) แต่เนื่องจาก `orchestrator-*` มาหลัง `*` ผลลัพธ์ที่เป็น `allow` -::: - -:::tip -ไม่จำเป็นต้องให้ตัวแทนย่อยใดๆก็ได้โดยตรงผ่านเมนูเติมข้อความอัตโนมัติ `@` สำหรับความต้องการของงานของตัวแทนจะเพิกเฉย +กฎทำงานตามลำดับ และ **กฎที่ตรงกันล่าสุดจะมีผล** ในตัวอย่างข้างต้น `orchestrator-planner` ตรงกับทั้ง `*` (deny) และ `orchestrator-*` (allow) แต่เนื่องจาก `orchestrator-*` มาทีหลัง ผลลัพธ์จึงเป็น `allow` ::: --- -### Color +### สี -ปรับแต่งความต้องการของตัวแทนใน UI ด้วยตัวเลือก `color` เพื่อดูลักษณะเฉพาะของตัวแทนในการปฏิบัติตาม +ปรับแต่งสีของเอเจนต์ใน UI ด้วยตัวเลือก `color` -ใช้สีฐานสิบหกที่ถูกต้อง (เช่น `#FF5733`) หรือระบบควบคุม: `primary`, `secondary`, `accent`, `success`, `warning`, `error`, `info` +ใช้รหัสสี hex (เช่น `#FF5733`) หรือชื่อสีมาตรฐาน: `primary`, `secondary`, `accent`, `success`, `warning`, `error`, `info` ```json title="opencode.json" { @@ -619,7 +610,7 @@ Only analyze code and suggest changes. ### Top P -หลักการของปฏิกิริยาด้วยตัวเลือก `top_p` ทางเลือกแทนการควบคุมการสุ่ม +ควบคุมความหลากหลายของการตอบกลับด้วยตัวเลือก `top_p` ```json title="opencode.json" { @@ -631,15 +622,15 @@ Only analyze code and suggest changes. } ``` -ค่าครองชีพ 0.0 ถึง 1.0 ค่าที่ต่ำกว่าจะเน้นไปที่ค่าที่มักจะเป็นเวลานาน +ช่วงค่า 0.0 ถึง 1.0 ค่าที่ต่ำกว่าจะเน้นไปที่โทเค็นที่มีความน่าจะเป็นสูง --- -### Additional +### Additional (เพิ่มเติม) -ข้อมูลอื่นๆ ที่คุณระบุในบางครั้งตัวแทนของคุณไปที่ **ส่งผ่านโดยตรง** ในส่วนของโครงสร้างข้อมูล คุณจะต้องดำเนินการและตรวจสอบเฉพาะของข้อมูลเท่านั้นได้ +คุณสมบัติอื่นๆ ที่คุณระบุใน object ของเอเจนต์จะถูก **ส่งผ่านโดยตรง** ไปยัง LLM config -เช่น ด้วยรูปแบบการใช้เหตุผลของ OpenAI อ่านการควบคุมเพื่อให้เหตุผล: +เช่น สำหรับโมเดลที่มีการให้เหตุผลของ OpenAI: ```json title="opencode.json" {6,7} { @@ -654,55 +645,53 @@ Only analyze code and suggest changes. } ``` -ตรวจสอบเพิ่มเติมในรุ่นและเฉพาะเจาะจงการสแกนเอกสารของคุณเพื่อดูภาพรวม +ตรวจสอบเอกสารของแต่ละโมเดลสำหรับตัวเลือกที่รองรับ :::tip -ต้องการ `opencode models` เพื่อดูรายการที่สมบูรณ์ +ใช้ `opencode models` เพื่อดูรายการตัวเลือกทั้งหมด ::: --- -## สร้างตัวแทน +## การสร้างเอเจนต์ -การสร้างตัวแทนใหม่ได้อีกครั้งตามลำดับ: +สร้างเอเจนต์ใหม่ด้วยคำสั่ง: ```bash opencode agent create ``` -คำสั่งแบบในเวลานี้: +คำสั่งแบบโต้ตอบจะถาม: -1. ถามว่าจะบันทึกตัวแทนได้ที่ไหนระดับโลกหรือเฉพาะโครงการ -2. คำอธิบายสิ่งที่ตัวแทนควรทำ -3. สร้างพรอมต์และตัวระบุชนิดของที่เหมาะสม -4. ให้คุณเลือกเครื่องมือที่ตัวแทนอย่างเป็นทางการ -5. ในที่สุดสร้างไฟล์ Markdown ด้วยเอเจนต์ +1. สถานที่บันทึก (Global หรือ Project) +2. คำอธิบายหน้าที่ของเอเจนต์ +3. สร้างพรอมต์และเลือกไอคอนที่เหมาะสม +4. เลือกเครื่องมือที่เอเจนต์สามารถใช้ได้ +5. สร้างไฟล์ Markdown ของเอเจนต์ --- -## กรณีการใช้งาน +## ตัวอย่างการใช้งาน -ต่อไปเป็นกรณีการใช้งานทั่วไปสำหรับตัวแทนต่างๆ +ต่อไปนี้เป็นกรณีการใช้งานทั่วไปสำหรับเอเจนต์ต่างๆ -- **ตัวแทนที่กำลังพัฒนา**: งานพัฒนาใหม่ล่าสุดโดยอาศัยเครื่องมือทั้งหมด -- **ตัวแทนแผน**: ผู้วิเคราะห์และวางแผนโดยไม่ทำการเปลี่ยนแปลง -- **ตัวแทนตรวจสอบ**: ตรวจสอบโค้ดพร้อมแบบอ่านเพียงอย่างเดียวพร้อมเครื่องมือเอกสารประกอบ -- **ตัวแทนแก้ไขข้อบกพร่อง**: ตรวจสอบโดยการตรวจสอบโดยการควบคุมตีและผู้อ่าน -- **ตัวแทนเอกสาร**: เนื้อหาเอกสารด้วยไฟล์จัดเก็บข้อมูลที่ระบบปฏิบัติตาม +- **Developer**: งานพัฒนาทั่วไป ใช้เครื่องมือทั้งหมด +- **Planner**: วิเคราะห์และวางแผนโดยไม่ทำการเปลี่ยนแปลง +- **Reviewer**: ตรวจสอบโค้ดแบบอ่านอย่างเดียว (Read-only) +- **Debugger**: แก้ไขข้อผิดพลาดโดยเน้นการอ่าน log และทดสอบ +- **Docs Writer**: เขียนและปรับปรุงเอกสาร --- -## แปลความหมายได้ +## ตัวอย่างเอเจนต์ -ตัวแทนอธิบายว่าคุณอาจจะพบว่ามีประโยชน์ +นี่คือตัวอย่างเอเจนต์ที่คุณอาจพบว่ามีประโยชน์ :::tip -คุณเป็นตัวแทนคุณต้องการแบ่งปันหรือไม่? [ส่งประชาสัมพันธ์](https://github.com/anomalyco/opencode) +คุณมีเอเจนต์เจ๋งๆ ที่ต้องการแบ่งปันหรือไม่? [ส่ง PR มาที่นี่](https://github.com/anomalyco/opencode) ::: ---- - -### ตัวแทนเอกสาร +### Docs Writer ```markdown title="~/.config/opencode/agents/docs-writer.md" --- @@ -724,7 +713,7 @@ Focus on: --- -### ผู้ตรวจสอบความปลอดภัย +### Security Auditor ```markdown title="~/.config/opencode/agents/security-auditor.md" --- diff --git a/packages/web/src/content/docs/th/cli.mdx b/packages/web/src/content/docs/th/cli.mdx index a89143c71..60e3fac76 100644 --- a/packages/web/src/content/docs/th/cli.mdx +++ b/packages/web/src/content/docs/th/cli.mdx @@ -1,17 +1,17 @@ --- title: CLI -description: OpenCode CLI รับสัญญาณและคำสั่ง +description: สัญญาณและคำสั่งของ OpenCode CLI --- import { Tabs, TabItem } from "@astrojs/starlight/components" -OpenCode CLI โดยเฉพาะอย่างยิ่งจะเริ่มต้น [TUI](/docs/tui) ไม่ต้องทำงานโดยไม่มีข้อใดใดๆ +OpenCode CLI จะเริ่มต้น [TUI](/docs/tui) เป็นค่าเริ่มต้นเมื่อเรียกใช้โดยไม่มีอาร์กิวเมนต์ ```bash opencode ``` -การยอมรับคำสั่งตามเอกสารในนั้นด้วยเหตุนี้ทำให้คุณสามารถพบกับ OpenCode โดยทางโปรแกรมได้ +นอกจากนี้ยังรับคำสั่งและแฟล็ก ซึ่งช่วยให้คุณใช้ OpenCode ผ่านโปรแกรมได้ ```bash opencode run "Explain how closures work in JavaScript" @@ -21,7 +21,7 @@ opencode run "Explain how closures work in JavaScript" ### tui -เริ่มเปิดให้ผู้ใช้เริ่มใช้ OpenCode +เริ่ม TUI เพื่อใช้ OpenCode แบบโต้ตอบ ```bash opencode [project] @@ -31,26 +31,26 @@ opencode [project] | แฟล็ก | สั้น | คำอธิบาย | | ------------ | ---- | ---------------------------------------------------------- | -| `--continue` | `-c` | มาดูกันเป็นครั้งสุดท้าย | -| `--session` | `-s` | รหัสให้ดีเพื่อเหตุการณ์ | +| `--continue` | `-c` | ดำเนินการต่อจากเซสชันล่าสุด | +| `--session` | `-s` | ID เซสชันเพื่อดำเนินการต่อ | | `--fork` | | แยกเซสชันเมื่อทำต่อ (ใช้กับ `--continue` หรือ `--session`) | -| `--prompt` | | แจ้งการใช้งาน | -| `--model` | `-m` | รูปแบบการใช้งานรูปแบบ provider/model | -| `--agent` | | ตัวแทนการรับ | -| `--port` | | ท่าเรือที่จะฟัง | -| `--hostname` | | ชื่อที่จะฟัง | +| `--prompt` | | พรอมต์เริ่มต้นที่จะใช้ | +| `--model` | `-m` | โมเดลที่จะใช้ในรูปแบบ provider/model | +| `--agent` | | เอเจนต์ที่จะใช้ | +| `--port` | | พอร์ตที่จะฟัง | +| `--hostname` | | ชื่อโฮสต์ที่จะฟัง | --- ## คำสั่ง -OpenCode CLI ยังมีคำสั่งอีกมากมาย +OpenCode CLI ยังมีคำสั่งย่อยอีกมากมาย --- ### agent -จัดการตัวแทนสำหรับ OpenCode +จัดการเอเจนต์สำหรับ OpenCode ```bash opencode agent [command] @@ -60,13 +60,13 @@ opencode agent [command] ### attach -สาเหตุว่าทำไมเซิร์ฟเวอร์แบ็กเอนด์ OpenCode ที่รันจริงๆ ซึ่งเริ่มต้นผ่านคำสั่ง `serve` หรือ `web` +เชื่อมต่อกับเซิร์ฟเวอร์แบ็กเอนด์ OpenCode ที่กำลังทำงานอยู่ ซึ่งเริ่มต้นผ่านคำสั่ง `serve` หรือ `web` ```bash opencode attach [url] ``` -วิธีการใช้ TUI กับแบ็กเอนด์ OpenCode ตัวอย่าง: +วิธีนี้ช่วยให้คุณใช้ TUI กับแบ็กเอนด์ OpenCode ระยะไกลได้ ตัวอย่าง: ```bash # Start the backend server for web/mobile access @@ -81,25 +81,25 @@ opencode attach http://10.20.30.40:4096 | แฟล็ก | สั้น | คำอธิบาย | | ----------- | ---- | -------------------------------------- | | `--dir` | | ไดเร็กทอรีการทำงานเพื่อเริ่มต้น TUI ใน | -| `--session` | `-s` | รหัสให้ดีเพื่อเหตุการณ์ | +| `--session` | `-s` | ID เซสชันเพื่อดำเนินการต่อ | --- #### create -สร้างตัวแทนใหม่ด้วยคืนนี้ +สร้างเอเจนต์ใหม่ ```bash opencode agent create ``` -คำสั่งนี้จะแนะนำคุณตลอดไปจนถึงเอเจนต์ใหม่พร้อมพร้อมท์ระบบและประสิทธิภาพของเครื่องมือ +คำสั่งนี้จะแนะนำคุณตลอดกระบวนการสร้างเอเจนต์ใหม่ พร้อมพรอมต์ระบบและความสามารถของเครื่องมือ --- #### list -รายชื่อตัวแทนทั้งหมดทั้งหมด +แสดงรายชื่อเอเจนต์ที่พร้อมใช้งานทั้งหมด ```bash opencode agent list @@ -109,7 +109,7 @@ opencode agent list ### auth -ขอแจ้งให้ทราบข้อมูลและข้อมูลเข้าสู่ระบบสำหรับ... +จัดการการตรวจสอบสิทธิ์และข้อมูลรับรอง ```bash opencode auth [command] @@ -119,25 +119,25 @@ opencode auth [command] #### login -OpenCode มีประสิทธิภาพสูงโดยรายชื่อทั่วไปที่ [Models.dev](https://models.dev) ดังนั้นเหตุผลที่เป็นไปได้ API สำหรับความต้องการใดๆ จำเป็นต้องใช้ข้อมูลนี้ถูกที่ `~/.local/share/opencode/auth.json` +OpenCode ได้รับการกำหนดค่าไว้ล่วงหน้าด้วยรายชื่อผู้ให้บริการทั่วไปที่ [Models.dev](https://models.dev) ดังนั้นคุณเพียงแค่ต้องใส่คีย์ API สำหรับผู้ให้บริการที่คุณต้องการใช้ ข้อมูลนี้จะถูกเก็บไว้ที่ `~/.local/share/opencode/auth.json` ```bash opencode auth login ``` -เมื่อ OpenCode เริ่มต้นระบบจะโหลดจากไฟล์ข้อมูลรับรองและไม่จำเป็นต้องคำนึงถึงสิ่งใด ๆ ที่จะพบไฟล์ของคุณหรือ `.env` ในโปรเจ็กต์ของคุณ +เมื่อ OpenCode เริ่มต้น ระบบจะโหลดข้อมูลรับรองจากไฟล์นี้ ดังนั้นคุณจึงไม่ต้องกังวลกับการตั้งค่าตัวแปรสภาพแวดล้อมหรือไฟล์ `.env` ในโปรเจ็กต์ของคุณ --- #### list -การแจ้งเตือนที่พิสูจน์ความถูกต้องทั้งหมดซึ่งจัดเป็นไฟล์ข้อมูลสามารถตรวจสอบได้ +แสดงรายการข้อมูลรับรองการตรวจสอบสิทธิ์ทั้งหมดที่กำหนดค่าไว้ ```bash opencode auth list ``` -หรือฮิลตันสั้น +หรือใช้นามแฝงสั้น ```bash opencode auth ls @@ -147,7 +147,7 @@ opencode auth ls #### logout -นำคุณออกจากระบบของมักจะพบข้อมูลจากไฟล์รับรองข้อมูล +ออกจากระบบของผู้ให้บริการและลบข้อมูลรับรองออกจากไฟล์ auth ```bash opencode auth logout @@ -157,7 +157,7 @@ opencode auth logout ### github -การจัดการเอเจนต์ GitHub สำหรับพื้นที่อัตโนมัติ +จัดการเอเจนต์ GitHub สำหรับเวิร์กโฟลว์อัตโนมัติ ```bash opencode github [command] @@ -167,19 +167,19 @@ opencode github [command] #### install -ตู้เสื้อผ้าเอเจนต์ GitHub ในที่เก็บของคุณ +ติดตั้งเอเจนต์ GitHub ใน repository ของคุณ ```bash opencode github install ``` -ไม่ว่าคุณจะเริ่มต้นโฟลว์ GitHub Actions และแนะนำคุณตลอดประวัติศาสตร์ [เรียนรู้เพิ่มเติม](/docs/github) +คำสั่งนี้จะสร้างเวิร์กโฟลว์ GitHub Actions และแนะนำคุณตลอดกระบวนการตั้งค่า [เรียนรู้เพิ่มเติม](/docs/github) --- #### run -ต้องการตัวแทน GitHub อีกครั้งใน GitHub Actions +รันเอเจนต์ GitHub ด้วยตนเองหรือใน GitHub Actions ```bash opencode github run @@ -187,16 +187,16 @@ opencode github run ##### แฟล็ก -| แฟล็ก | คำอธิบาย | -| --------- | -------------------------------- | -| `--event` | การจำลอง GitHub เพื่อขอรับตัวแทน | -| `--token` | ความเป็นส่วนตัวของ GitHub | +| แฟล็ก | คำอธิบาย | +| --------- | -------------------------------------- | +| `--event` | เหตุการณ์ GitHub เพื่อทริกเกอร์เอเจนต์ | +| `--token` | GitHub token | --- ### mcp -เซิร์ฟเวอร์เซิร์ฟเวอร์ Model Context Protocol +จัดการเซิร์ฟเวอร์ Model Context Protocol (MCP) ```bash opencode mcp [command] @@ -206,25 +206,25 @@ opencode mcp [command] #### add -เพลิดเพลินไปกับแขก MCP ในคืนนี้ของคุณ +เพิ่มเซิร์ฟเวอร์ MCP ลงในการกำหนดค่าของคุณ ```bash opencode mcp add ``` -คำสั่งนี้จะแนะนำคุณในคืนนี้ MCP ความเชื่อหรือในตำนาน +คำสั่งนี้จะแนะนำคุณผ่านวิซาร์ดเพื่อกำหนดค่าเซิร์ฟเวอร์ MCP ใหม่ --- #### list -เชิญแขก MCP ที่ RAM ทั้งหมดและดำรงอยู่ +แสดงรายชื่อเซิร์ฟเวอร์ MCP ทั้งหมดที่กำหนดค่าไว้และสถานะ ```bash opencode mcp list ``` -ต้องใช้หอพักระยะสั้น +หรือใช้นามแฝงสั้น ```bash opencode mcp ls @@ -234,21 +234,21 @@ opencode mcp ls #### auth -ตัดสิทธิ์กับแขก MCP ที่ OAuth +ยืนยันตัวตนกับเซิร์ฟเวอร์ MCP ที่ต้องการ OAuth ```bash opencode mcp auth [name] ``` -ไม่ต้องระบุชื่อเซิร์ฟเวอร์ คุณจะได้รับแจ้งจากเซิร์ฟเวอร์ที่รองรับ OAuth ที่พร้อมให้บริการ +หากไม่ระบุชื่อเซิร์ฟเวอร์ คุณจะได้รับแจ้งให้เลือกจากเซิร์ฟเวอร์ที่รองรับ OAuth ที่พร้อมใช้งาน -รับรองว่ารองรับ OAuth และสถานะยืนยันสิทธิ์ได้ +คุณยังสามารถแสดงรายการสถานะการตรวจสอบสิทธิ์ OAuth ได้: ```bash opencode mcp auth list ``` -ต้องใช้หอพักระยะสั้น +หรือใช้นามแฝงสั้น ```bash opencode mcp auth ls @@ -258,7 +258,7 @@ opencode mcp auth ls #### logout -ข้อมูลรับรอง OAuth สำหรับผู้เข้าชม MCP +ลบข้อมูลรับรอง OAuth สำหรับเซิร์ฟเวอร์ MCP ```bash opencode mcp logout [name] @@ -268,7 +268,7 @@ opencode mcp logout [name] #### debug -โปรดตรวจสอบ OAuth สำหรับเซิร์ฟเวอร์ MCP +ดีบักการเชื่อมต่อเซิร์ฟเวอร์ MCP ```bash opencode mcp debug @@ -278,17 +278,17 @@ opencode mcp debug ### models -การทดลองแบบจำลองทั้งหมดทั้งหมดจากที่เก็บข้อมูลนี้ +แสดงรายการโมเดลที่พร้อมใช้งานทั้งหมดจากผู้ให้บริการที่กำหนดค่าไว้ ```bash opencode models [provider] ``` -คำสั่งนี้แสดงให้เห็นโมเดลทั้งหมดและเป็นที่เก็บข้อมูลของคุณ `provider/model` +คำสั่งนี้จะแสดง ID โมเดลทั้งหมดในรูปแบบ `provider/model` -คุณสามารถใช้ชื่อรุ่นได้อย่างแม่นยำใน [ ฟังก์ชั่นของคุณ](/docs/config/) +คุณสามารถใช้ชื่อโมเดลเหล่านี้ในการกำหนดค่า [config](/docs/config/) ของคุณ -สามารถส่งรหัสมีหน้าที่เพื่อกรองโมเดลตามส่วนรายนั้นได้ +คุณยังสามารถส่งผ่านรหัสผู้ให้บริการเพื่อกรองโมเดลตามผู้ให้บริการรายนั้นได้ ```bash opencode models anthropic @@ -296,12 +296,13 @@ opencode models anthropic #### แฟล็ก -| แฟล็ก | คำอธิบาย | -| ----------- | ------------------------------------------------- | -| `--refresh` | โครงสร้างแคชโมเดลจาก models.dev | -| `--verbose` | ใช้โมเดลนี้เพื่อตรวจสอบ (รวมข้อมูลเมตาเช่นต้นทุน) | +| แฟล็ก | คำอธิบาย | +| ----------- | ------------------------------------------------------ | +| `--refresh` | รีเฟรชแคชโมเดลจาก models.dev | +| `--verbose` | แสดงรายละเอียดโมเดลเพิ่มเติม (รวมข้อมูลเมตาเช่นต้นทุน) | +| `--json` | แสดงผลลัพธ์เป็น JSON | -ใช้แฟล็ก `--refresh` ในที่นี้รายการโมเดลที่แคชไว้ตรงนั้นมีประโยชน์เพิ่มโมเดลใหม่ให้กับระบบและขอดูโมเดลของข้อมูลใน OpenCode +ใช้แฟล็ก `--refresh` เพื่ออัปเดตรายการโมเดลที่แคชไว้ มีประโยชน์เมื่อมีการเพิ่มโมเดลใหม่ให้กับผู้ให้บริการและคุณต้องการเห็นใน OpenCode ```bash opencode models --refresh @@ -311,19 +312,19 @@ opencode models --refresh ### run -ต้องการ opencode ภายนอกไม่มีการแจ้งโดยแจ้งแจ้งโดยตรง +รัน OpenCode โดยไม่ต้องใช้ TUI โดยส่งพรอมต์โดยตรง ```bash opencode run [message..] ``` -มีประโยชน์สำหรับการทำงานร่วมกันของการทำงานอัตโนมัติหรือเมื่อต้องการให้ตอบสนองอย่างรวดเร็วเปิด TUI เป็นตัวอย่าง +มีประโยชน์สำหรับการทำงานอัตโนมัติหรือเมื่อต้องการคำตอบอย่างรวดเร็วโดยไม่ต้องเปิด TUI ตัวอย่าง: ```bash "opencode run" opencode run Explain the use of context in Go ``` -ขอแนบไปกับฟีเจอร์นี้ `opencode serve` ทำงานอยู่อีกครั้งเวลาของแขก MCP การทำงานหลายอย่าง: +คุณยังสามารถแนบไปกับเซิร์ฟเวอร์ `opencode serve` ที่ทำงานอยู่ หรือใช้เซิร์ฟเวอร์ MCP แบบ headless: ```bash # Start a headless server in one terminal @@ -335,47 +336,47 @@ opencode run --attach http://localhost:4096 "Explain async/await in JavaScript" #### แฟล็ก -| แฟล็ก | สั้น | คำอธิบาย | -| ------------ | ---- | --------------------------------------------------------------------- | -| `--command` | | คำสั่งให้รันใช้ข้อความสำหรับ args | -| `--continue` | `-c` | มาดูกันเป็นครั้งสุดท้าย | -| `--session` | `-s` | รหัสให้ดีเพื่อเหตุการณ์ | -| `--fork` | | แยกเซสชันเมื่อทำต่อ (ใช้กับ `--continue` หรือ `--session`) | -| `--share` | | เซสชั่น | -| `--model` | `-m` | รูปแบบการใช้งานรูปแบบ provider/model | -| `--agent` | | ตัวแทนการรับ | -| `--file` | `-f` | แนบไปกับข้อความได้เลย | -| `--format` | | การรักษา: (จัดรูปแบบ) หรือ json ( อดทนดิบ JSON) | -| `--title` | | ชื่อเรื่องสำหรับการเฉลิมฉลอง (ใช้พร้อมท์ที่สามารถนำมาใช้กับค่าตัวยึด) | -| `--attach` | | แนบไปกับผู้โดยสาร opencode สำนักงานอยู่ (เช่น http://localhost:4096) | -| `--port` | | ท่าเรือสำหรับผู้โดยสารภายในเครื่อง (ตรวจสอบเป็นพอร์ตสุ่ม) | +| แฟล็ก | สั้น | คำอธิบาย | +| ------------ | ---- | ---------------------------------------------------------------------- | +| `--command` | | คำสั่งที่จะรัน (ใช้ส่วนที่เหลือของ args เป็นอาร์กิวเมนต์) | +| `--continue` | `-c` | ดำเนินการต่อจากเซสชันล่าสุด | +| `--session` | `-s` | ID เซสชันเพื่อดำเนินการต่อ | +| `--fork` | | แยกเซสชันเมื่อทำต่อ (ใช้กับ `--continue` หรือ `--session`) | +| `--share` | | สร้างลิงก์แชร์สำหรับเซสชัน | +| `--model` | `-m` | โมเดลที่จะใช้ในรูปแบบ provider/model | +| `--agent` | | เอเจนต์ที่จะใช้ | +| `--file` | `-f` | แนบไฟล์ไปกับข้อความ | +| `--format` | | รูปแบบเอาต์พุต: text (จัดรูปแบบ) หรือ json (JSON ดิบ) | +| `--title` | | ชื่อสำหรับเซสชัน (หากไม่ได้ระบุ จะสร้างจากพรอมต์) | +| `--attach` | | แนบไปกับเซิร์ฟเวอร์ opencode ที่ทำงานอยู่ (เช่น http://localhost:4096) | +| `--port` | | พอร์ตสำหรับเซิร์ฟเวอร์ภายในเครื่อง (หากไม่ได้ระบุ จะใช้พอร์ตสุ่ม) | --- ### serve -เริ่มต้นเลานจ์ OpenCode ไม่เพียงแต่สำหรับนักท่องเที่ยวเท่านั้น API ภาพถ่าย [เอกสารรับรอง](/docs/server) เพื่อดู HTTP เต็มรูปแบบ +เริ่มต้นเซิร์ฟเวอร์ OpenCode headless ที่ให้บริการ API HTTP ดู [เอกสารเซิร์ฟเวอร์](/docs/server) สำหรับรายละเอียด API เต็มรูปแบบ ```bash opencode serve ``` -ตัวควบคุมจะเริ่มต้นเซิร์ฟเวอร์ HTTP ให้ API เข้าถึงฟังก์ชันการทำงานของ opencode ได้อย่างมีประสิทธิภาพ TUI จัดเตรียม `OPENCODE_SERVER_PASSWORD` ประสิทธิภาพของฮาร์ดแวร์ฮาร์ดแวร์ความถูกต้องพื้นฐาน HTTP (ตัวควบคุมของฮาร์ดแวร์คือ `opencode`) +คำสั่งนี้จะเริ่มต้นเซิร์ฟเวอร์ HTTP ให้ API เข้าถึงฟังก์ชันการทำงานของ OpenCode ได้โดยไม่ต้องมี TUI นอกจากนี้ยังรองรับการตรวจสอบสิทธิ์พื้นฐาน HTTP (ชื่อผู้ใช้เริ่มต้นคือ `opencode` และรหัสผ่านระบุโดย `OPENCODE_SERVER_PASSWORD`) #### แฟล็ก -| แฟล็ก | คำอธิบาย | -| ------------ | --------------------------------------- | -| `--port` | ท่าเรือที่จะฟัง | -| `--hostname` | ชื่อที่จะฟัง | -| `--mdns` | โปรดตรวจสอบ mDNS | -| `--cors` | จำเป็นต้องมีเพิ่มเติมเพื่อการทำงาน CORS | +| แฟล็ก | คำอธิบาย | +| ------------ | -------------------------------------- | +| `--port` | พอร์ตที่จะฟัง | +| `--hostname` | ชื่อโฮสต์ที่จะฟัง | +| `--mdns` | เปิดใช้งานการค้นหา mDNS | +| `--cors` | ต้นกำเนิดเพิ่มเติมที่อนุญาตสำหรับ CORS | --- ### session -การจัดการ OpenCode +จัดการเซสชัน OpenCode ```bash opencode session [command] @@ -385,7 +386,7 @@ opencode session [command] #### list -การแจ้งเตือน OpenCode ทั้งหมด +แสดงรายการเซสชัน OpenCode ทั้งหมด ```bash opencode session list @@ -393,16 +394,16 @@ opencode session list ##### แฟล็ก -| แฟล็ก | สั้น | คำอธิบาย | -| ------------- | ---- | --------------------------- | -| `--max-count` | `-n` | จำกัดการควบคุม N ใหม่ล่าสุด | -| `--format` | | ตารางตารางหรือ json (ตาราง) | +| แฟล็ก | สั้น | คำอธิบาย | +| ------------- | ---- | ----------------------------- | +| `--max-count` | `-n` | จำกัดการแสดงผล N รายการล่าสุด | +| `--format` | | รูปแบบ table หรือ json | --- ### stats -แสดงสถิติการเริ่มต้นและค่าใช้จ่ายสำหรับ OpenCode ของคุณ +แสดงสถิติการใช้งานและค่าใช้จ่ายสำหรับ OpenCode ของคุณ ```bash opencode stats @@ -410,36 +411,36 @@ opencode stats #### แฟล็ก -| แฟล็ก | คำอธิบาย | -| ----------- | ------------------------------------------------------------------------------- | -| `--days` | แสดงสถิติของ N วันในอดีต (ตลอดเวลา) | -| `--tools` | เครื่องมือที่มองเห็น (ทั้งหมด) | -| `--models` | แสดงรายละเอียดการใช้งานโมเดล (ซ่อนไว้ตามตัวอย่าง) เอกสารหมายเลขนั้น N หมายเลขบน | -| `--project` | กรองตามโครงการ (โครงการทั้งหมดที่มีอยู่: โครงการปัจจุบัน) | +| แฟล็ก | คำอธิบาย | +| ----------- | ---------------------------------------------------- | +| `--days` | แสดงสถิติของ N วันที่ผ่านมา (ค่าเริ่มต้น: ตลอดเวลา) | +| `--tools` | แสดงสถิติการใช้เครื่องมือ | +| `--models` | แสดงรายละเอียดการใช้งานโมเดล (ซ่อนไว้ตามค่าเริ่มต้น) | +| `--project` | กรองตามโครงการ (ค่าเริ่มต้น: โครงการปัจจุบัน) | --- ### export -ส่งออกข้อมูลข่าวสารเป็น JSON +ส่งออกประวัติเซสชันเป็น JSON ```bash opencode export [sessionID] ``` -ไม่ระบุรหัสผู้ดูแลระบบ คุณจะได้รับแจ้งจากการปรับปรุงดังกล่าว +หากไม่ระบุรหัสเซสชัน คุณจะได้รับแจ้งให้เลือกจากรายการล่าสุด --- ### import -นำเข้าข้อมูลที่ดีจากไฟล์ JSON หรือแชร์ OpenCode URL +นำเข้าเซสชันจากไฟล์ JSON หรือ URL ที่แชร์ของ OpenCode ```bash opencode import ``` -ไม่เคยนำเข้าไฟล์ในเครื่องหรือแชร์ OpenCode URL +คุณสามารถนำเข้าไฟล์ในเครื่องหรือ URL ที่แชร์ ```bash opencode import session.json @@ -450,22 +451,22 @@ opencode import https://opncd.ai/s/abc123 ### web -เชิญแขก OpenCode อย่างเป็นทางการด้วยเว็บอินเตอร์เฟส +เริ่ม OpenCode ในโหมดเซิร์ฟเวอร์พร้อมเว็บอินเตอร์เฟส ```bash opencode web ``` -ตัวควบคุมจะเริ่มต้นเซิร์ฟเวอร์ HTTP และเปิดเว็บเองเพื่อเข้าถึง OpenCode ผ่านทางเว็บอินเตอร์เฟส จัดเตรียม `OPENCODE_SERVER_PASSWORD` สำหรับคำอธิบายคุณสมบัติความถูกต้องพื้นฐาน HTTP (ตัวยึดของฮาร์ดแวร์คือ `opencode`) +คำสั่งนี้จะเริ่มต้นเซิร์ฟเวอร์ HTTP และเปิดเว็บเบราว์เซอร์เพื่อเข้าถึง OpenCode ผ่านทางเว็บอินเตอร์เฟส รองรับการตรวจสอบสิทธิ์พื้นฐาน HTTP (ชื่อผู้ใช้เริ่มต้นคือ `opencode` และรหัสผ่านระบุโดย `OPENCODE_SERVER_PASSWORD`) #### แฟล็ก -| แฟล็ก | คำอธิบาย | -| ------------ | --------------------------------------- | -| `--port` | ท่าเรือที่จะฟัง | -| `--hostname` | ชื่อที่จะฟัง | -| `--mdns` | โปรดตรวจสอบ mDNS | -| `--cors` | จำเป็นต้องมีเพิ่มเติมเพื่อการทำงาน CORS | +| แฟล็ก | คำอธิบาย | +| ------------ | -------------------------------------- | +| `--port` | พอร์ตที่จะฟัง | +| `--hostname` | ชื่อโฮสต์ที่จะฟัง | +| `--mdns` | เปิดใช้งานการค้นหา mDNS | +| `--cors` | ต้นกำเนิดเพิ่มเติมที่อนุญาตสำหรับ CORS | --- @@ -477,21 +478,21 @@ opencode web opencode acp ``` -สั่งนี้เริ่มต้นผู้โดยสาร ACP ที่สื่อสารผ่าน stdin/stdout nd-JSON +คำสั่งนี้เริ่มต้นเซิร์ฟเวอร์ ACP ที่สื่อสารผ่าน stdin/stdout ด้วย nd-JSON #### แฟล็ก | แฟล็ก | คำอธิบาย | | ------------ | ------------------ | | `--cwd` | ไดเร็กทอรีการทำงาน | -| `--port` | ท่าเรือที่จะฟัง | -| `--hostname` | ชื่อที่จะฟัง | +| `--port` | พอร์ตที่จะฟัง | +| `--hostname` | ชื่อโฮสต์ที่จะฟัง | --- ### uninstall -ไม่ว่า OpenCode และลบไฟล์ทั้งหมดทั้งหมด +ถอนการติดตั้ง OpenCode และลบข้อมูลการกำหนดค่าทั้งหมด ```bash opencode uninstall @@ -499,30 +500,30 @@ opencode uninstall #### แฟล็ก -| แฟล็ก | สั้น | คำอธิบาย | -| --------------- | ---- | ---------------------------------- | -| `--keep-config` | `-c` | เก็บไฟล์ไว้ที่นี่ | -| `--keep-data` | `-d` | บางครั้งเซสชั่นและสแน็ปช็อต | -| `--dry-run` | | แสดงสิ่งที่จะลบออกโดยไม่ต้องใช้ออก | -| `--force` | `-f` | ข้อความแจ้งข้อความ | +| แฟล็ก | สั้น | คำอธิบาย | +| --------------- | ---- | ----------------------------------- | +| `--keep-config` | `-c` | เก็บไฟล์การกำหนดค่าไว้ | +| `--keep-data` | `-d` | เก็บไฟล์ข้อมูล (เซสชันและสแน็ปช็อต) | +| `--dry-run` | | แสดงสิ่งที่จะลบออกโดยไม่ต้องทำจริง | +| `--force` | `-f` | บังคับลบโดยไม่มีการแจ้งเตือน | --- ### upgrade -อัปเดต opencode เป็นครั้งสุดท้ายหรือเฉพาะเจาะจง +อัปเกรด OpenCode เป็นเวอร์ชันล่าสุดหรือเวอร์ชันที่ระบุ ```bash opencode upgrade [target] ``` -เราปรับปรุงเป็นระดับล่าสุด +อัปเกรดเป็นเวอร์ชันล่าสุด ```bash opencode upgrade ``` -เพื่อพัฒนาเป็นฮอนด้าโดยเฉพาะ +อัปเกรดเป็นเวอร์ชันที่ระบุ ```bash opencode upgrade v0.1.48 @@ -536,16 +537,16 @@ opencode upgrade v0.1.48 --- -## ระดับโลก +## แฟล็กระดับโลก -opencode CLI รับค่าสถานะสากลต่อไป +OpenCode CLI ยอมรับแฟล็กสากลต่อไปนี้สำหรับทุกคำสั่ง -| แฟล็ก | สั้น | คำอธิบาย | -| -------------- | ---- | ------------------------------------------- | -| `--help` | `-h` | แสดงความช่วยเหลือ | -| `--version` | `-v` | หมายเลขการพิมพ์ | -| `--print-logs` | | พิมพ์บันทึกไปยัง stderr | -| `--log-level` | | ระดับการเรียนรู้ (DEBUG, INFO, WARN, ERROR) | +| แฟล็ก | สั้น | คำอธิบาย | +| -------------- | ---- | ----------------------------------------- | +| `--help` | `-h` | แสดงความช่วยเหลือ | +| `--version` | `-v` | พิมพ์เวอร์ชัน | +| `--print-logs` | | พิมพ์บันทึกไปยัง stderr | +| `--log-level` | | ระดับการบันทึก (DEBUG, INFO, WARN, ERROR) | --- @@ -553,51 +554,51 @@ opencode CLI รับค่าสถานะสากลต่อไป OpenCode สามารถกำหนดค่าโดยใช้ตัวแปรสภาพแวดล้อม -| ตัวแปร | ชนิด | คำอธิบาย | -| ------------------------------------- | ------- | ----------------------------------------------------------- | -| `OPENCODE_AUTO_SHARE` | Boolean | แชร์การแจ้งเตือน | -| `OPENCODE_GIT_BASH_PATH` | String | เข้าสู่ Git Bash ได้บน Windows | -| `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 สำหรับข้อมูลดึงข้อมูลโมเดล | +| ตัวแปร | ชนิด | คำอธิบาย | +| ------------------------------------- | ------- | ---------------------------------------------------------------- | +| `OPENCODE_AUTO_SHARE` | Boolean | แชร์เซสชันอัตโนมัติเมื่อสร้าง | +| `OPENCODE_GIT_BASH_PATH` | String | เส้นทางไปยัง Git Bash บน Windows | +| `OPENCODE_CONFIG` | String | เส้นทางไปยังไฟล์การกำหนดค่า | +| `OPENCODE_CONFIG_DIR` | String | เส้นทางไปยังไดเร็กทอรีการกำหนดค่า | +| `OPENCODE_CONFIG_CONTENT` | String | เนื้อหาการกำหนดค่าแบบ inline JSON | +| `OPENCODE_DISABLE_AUTOUPDATE` | Boolean | ปิดใช้งานการอัปเดตอัตโนมัติ | +| `OPENCODE_DISABLE_PRUNE` | Boolean | ปิดใช้งานการลบข้อมูลเซสชันเก่า | +| `OPENCODE_DISABLE_TERMINAL_TITLE` | Boolean | ปิดใช้งานการตั้งชื่อหน้าต่าง terminal | +| `OPENCODE_PERMISSION` | String | การกำหนดค่าสิทธิ์แบบ inline 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` (prompt + skills) | +| `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 แทน ls หากมี | +| `OPENCODE_SERVER_PASSWORD` | String | รหัสผ่านสำหรับการตรวจสอบสิทธิ์พื้นฐาน `serve`/`web` | +| `OPENCODE_SERVER_USERNAME` | String | ชื่อผู้ใช้สำหรับการตรวจสอบสิทธิ์พื้นฐาน (ค่าเริ่มต้น `opencode`) | +| `OPENCODE_MODELS_URL` | String | URL ที่กำหนดเองสำหรับการดึงรายการโมเดล | --- -### Experimental +### ขั้นทดลอง ตัวแปรสภาพแวดล้อมเหล่านี้เปิดใช้งานฟีเจอร์ทดลองที่อาจมีการเปลี่ยนแปลงหรือถูกลบออก | ตัวแปร | ชนิด | คำอธิบาย | | ----------------------------------------------- | ------- | ---------------------------------------------- | -| `OPENCODE_EXPERIMENTAL` | Boolean | ในที่สุดเราก็ทดลองทั้งหมด | -| `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | Boolean | การแจ้งเตือนการแจ้งเตือน | -| `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | Boolean | ยังไงก็ตามการเลือกที่จะเลือกใน TUI | -| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | ตัวเลข | การหมดเวลาเริ่มต้นสำหรับคำสั่ง bash ในหน่วย ms | -| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | ตัวเลข | เหตุผลที่สูงสุดสำหรับตอบกลับ LLM | -| `OPENCODE_EXPERIMENTAL_FILEWATCHER` | Boolean | เพื่อให้ตัวดูไฟล์สำหรับ dir ทั้งหมด | -| `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 | เพื่อเป็นโหมด | +| `OPENCODE_EXPERIMENTAL` | Boolean | เปิดใช้งานฟีเจอร์ทดลองทั้งหมด | +| `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | Boolean | การค้นหาไอคอนทดลอง | +| `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | Boolean | ปิดใช้งานการคัดลอกเมื่อเลือกใน TUI | +| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | Number | การหมดเวลาเริ่มต้นสำหรับคำสั่ง bash ในหน่วย ms | +| `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 renderer แบบทดลอง | +| `OPENCODE_EXPERIMENTAL_PLAN_MODE` | Boolean | เปิดใช้งาน Plan mode | diff --git a/packages/web/src/content/docs/th/commands.mdx b/packages/web/src/content/docs/th/commands.mdx index 86bf4c67a..0ef947e05 100644 --- a/packages/web/src/content/docs/th/commands.mdx +++ b/packages/web/src/content/docs/th/commands.mdx @@ -1,9 +1,9 @@ --- title: คำสั่ง -description: คำสั่งสร้างคำสั่งอีกครั้งที่ซ้ำกัน +description: คำสั่งที่กำหนดเองสำหรับงานที่ทำซ้ำๆ --- -คำสั่งดังกล่าวระบุพรอมต์จำเป็นต้องร้องขอเมื่อคำสั่งนั้นถูกดำเนินการใน TUI +คำสั่งช่วยให้คุณกำหนดชุดของพรอมต์ที่ใช้บ่อย เพื่อให้สามารถเรียกใช้งานได้อย่างรวดเร็วใน TUI ```bash frame="none" /my-command @@ -13,9 +13,9 @@ description: คำสั่งสร้างคำสั่งอีกคร --- -## สร้างไฟล์คำสั่ง +## การสร้างคำสั่ง -สร้างไฟล์ Markdown ในไดเร็กทอรี `commands/` เพื่อกำหนดคำสั่งทำตาม +สร้างไฟล์ Markdown ในไดเร็กทอรี `commands/` เพื่อกำหนดคำสั่งของคุณ สร้าง `.opencode/commands/test.md`: @@ -30,9 +30,9 @@ Run the full test suite with coverage report and show any failures. Focus on the failing tests and suggest fixes. ``` -frontmatter กำหนดคุณสมบัติคำสั่งเนื้อหาโดยละเอียด +Frontmatter กำหนดคุณสมบัติของคำสั่ง และเนื้อหาคือพรอมต์ที่จะส่งไปยัง LLM -ใช้คำสั่งโดยพิมพ์ `/` คำสั่งคำสั่ง +ใช้คำสั่งโดยพิมพ์ `/` ตามด้วยชื่อไฟล์ (ไม่รวมนามสกุล) ใน TUI: ```bash frame="none" "/test" @@ -40,15 +40,15 @@ frontmatter กำหนดคุณสมบัติคำสั่งเน --- -## เม็กซิโก +## วิธีการกำหนด -คำสั่งนี้จะผ่าน OpenCode หรือโดยการดำเนินการไฟล์ Markdown ในไดเร็กทอรี `commands/` +คุณสามารถกำหนดคำสั่งได้สองวิธี: ผ่านการกำหนดค่า JSON หรือโดยการสร้างไฟล์ Markdown --- ### JSON -ใช้ส่วน `command` ใน OpenCode ของคุณ [config](/docs/config): +ใช้ส่วน `command` ในไฟล์ [config](/docs/config) ของ OpenCode: ```json title="opencode.jsonc" {4-12} { @@ -77,10 +77,10 @@ frontmatter กำหนดคุณสมบัติคำสั่งเน ### Markdown -หากต้องการกำหนดคำสั่งของไฟล์ Markdown ได้คุณจะต้องดำเนินการใน: +หากต้องการกำหนดคำสั่งด้วยไฟล์ Markdown ให้วางไฟล์ไว้ใน: -- ทั่วโลก: `~/.config/opencode/commands/` -- ต่อโครงการ: `.opencode/commands/` +- ระดับผู้ใช้ (Global): `~/.config/opencode/commands/` +- ระดับโปรเจ็กต์: `.opencode/commands/` ```markdown title="~/.config/opencode/commands/test.md" --- @@ -93,8 +93,7 @@ Run the full test suite with coverage report and show any failures. Focus on the failing tests and suggest fixes. ``` -ชื่อไฟล์ Markdown ในชื่อคำสั่งเช่น `test.md` ให้ -คุณวิ่ง: +ชื่อไฟล์ Markdown จะกลายเป็นชื่อคำสั่ง เช่น `test.md` ให้คุณเรียกใช้: ```bash frame="none" /test @@ -102,15 +101,15 @@ Focus on the failing tests and suggest fixes. --- -## เรามีพร้อมท์ +## อาร์กิวเมนต์และการแทนที่ -พร้อมรองรับคำสั่งรองรับตามตำแหน่งและพิเศษหลายรายการ +คำสั่งรองรับอาร์กิวเมนต์ตามตำแหน่งและการแทนที่ค่าพิเศษหลายรายการ --- -### บทความโทรทัศน์ +### อาร์กิวเมนต์ -ส่งผ่านข้อเขียนไปยังคำสั่งของวงดนตรี `$ARGUMENTS` +คุณสามารถส่งผ่านอาร์กิวเมนต์ไปยังคำสั่งของคุณได้โดยใช้ `$ARGUMENTS` ```md title=".opencode/commands/component.md" --- @@ -127,16 +126,16 @@ Include proper typing and basic structure. /component Button ``` -และ `$ARGUMENTS` จะเป็นอย่างไร `Button` +และ `$ARGUMENTS` จะถูกแทนที่ด้วย `Button` -เราสามารถเข้าถึงแต่ละจุดได้ตามความต้องการตามหลัก: +คุณยังสามารถเข้าถึงแต่ละอาร์กิวเมนต์แยกกันได้: -- `$1` - ​​​​อาร์กิวเมนต์แรก -- `$2` - ​​​​อาร์กิวเมนต์ที่สอง -- `$3` - ​​​​อาร์กิวเมนต์ที่สาม -- นั่น... +- `$1` - อาร์กิวเมนต์แรก +- `$2` - อาร์กิวเมนต์ที่สอง +- `$3` - อาร์กิวเมนต์ที่สาม +- และอื่นๆ... -เช่น: +ตัวอย่าง: ```md title=".opencode/commands/create-file.md" --- @@ -153,19 +152,19 @@ with the following content: $3 /create-file config.json src "{ \"key\": \"value\" }" ``` -คุณจะรู้สึกได้ถึงความสูง: +ผลลัพธ์ที่ได้: -- `$1` กับ `config.json` -- `$2` กับ `src` -- `$3` กับ `{ "key": "value" }` +- `$1` แทนด้วย `config.json` +- `$2` แทนด้วย `src` +- `$3` แทนด้วย `{ "key": "value" }` --- -### ส่วนเชล +### คำสั่ง Shell ใช้ _!`command`_ เพื่อแทรกเอาต์พุตของ [คำสั่ง bash](/docs/tui#bash-commands) ใดๆ ลงในพรอมต์ของคุณ -เพื่อเป็นคำสั่งสร้างความพยายามเพื่อวิเคราะห์การทดสอบของการทดสอบ: +ตัวอย่างเช่น การรันชุดทดสอบและรวมผลลัพธ์: ```md title=".opencode/commands/analyze-coverage.md" --- @@ -178,7 +177,7 @@ Here are the current test results: Based on these results, suggest improvements to increase coverage. ``` -หรือตรวจสอบการเปลี่ยนแปลงล่าสุด: +หรือตรวจสอบการเปลี่ยนแปลงล่าสุดใน git: ```md title=".opencode/commands/review-changes.md" --- @@ -191,13 +190,13 @@ Recent git commits: Review these changes and suggest any improvements. ``` -คำสั่งไดเร็กทอรีรากของโปรเจ็กต์การปฏิบัติตามคำสั่งพร้อมท์ +คำสั่งจะถูกดำเนินการในไดเร็กทอรีรากของโปรเจ็กต์ --- -### อ้างถึงไฟล์ +### การอ้างอิงไฟล์ -รวมไฟล์ในคำสั่งของคุณ `@` ในชื่อไฟล์ +คุณสามารถรวมเนื้อหาไฟล์ในคำสั่งของคุณโดยใช้ `@` นำหน้าชื่อไฟล์ ```md title=".opencode/commands/review-component.md" --- @@ -208,19 +207,19 @@ Review the component in @src/components/Button.tsx. Check for performance issues and suggest improvements. ``` -เนื้อหาไฟล์จะถูกรวมไว้ด้วยการประกาศอย่างเป็นทางการ +เนื้อหาของไฟล์จะถูกอ่านและรวมเข้าไปในพรอมต์ที่ส่งไปยัง LLM --- ## ตัวเลือก -มาดูรายละเอียดเพิ่มเติมกัน +มาดูรายละเอียดของตัวเลือกการกำหนดค่าต่างๆ --- -### Template +### Template (เทมเพลต) -`template` กำหนดพรอมต์ที่จะเป็นไปได้ LLM จะดำเนินการคำสั่ง +`template` กำหนดพรอมต์ที่จะถูกส่งไปยัง LLM เมื่อเรียกใช้คำสั่ง ```json title="opencode.json" { @@ -232,11 +231,11 @@ Check for performance issues and suggest improvements. } ``` -รายการไม่จำเป็น **จำเป็น** +ฟิลด์นี้ **จำเป็น** สำหรับการกำหนดค่าแบบ JSON (ใน Markdown คือส่วนเนื้อหา) --- -### คำอธิบาย +### Description (คำอธิบาย) ใช้ตัวเลือก `description` เพื่อให้คำอธิบายโดยย่อเกี่ยวกับสิ่งที่คำสั่งทำ @@ -250,15 +249,13 @@ Check for performance issues and suggest improvements. } ``` -คำอธิบายที่เป็นคำอธิบายใน TUI คุณต้องการเขียนคำสั่ง +คำอธิบายนี้จะแสดงในรายการเติมคำอัตโนมัติของ TUI เมื่อคุณพิมพ์คำสั่ง --- -### ตัวแทน +### Agent (เอเจนต์) -ใช้ `agent` เพื่อระบุทางเลือกว่า [ตัวแทน](/docs/agents) ใดควรดำเนินการคำสั่งนี้ -นี่คือ [ตัวแทนย่อย](/docs/agents/#subagents) คำสั่งจะไม่จำเป็นต้องทำการย่อยตัวแทนย่อยตาม... -เหตุผลที่ทำให้สิ่งนี้เป็นไปได้ `subtask` เป็น `false` +ใช้ `agent` เพื่อระบุว่า [เอเจนต์](/docs/agents) ใดควรดำเนินการคำสั่งนี้ ```json title="opencode.json" { @@ -270,15 +267,15 @@ Check for performance issues and suggest improvements. } ``` -ขึ้นอยู่กับ ** ตัวเลือก** หากไม่ได้ระบุเหตุผลว่าเป็นเอเจนต์ปัจจุบันของคุณ +นี่คือ **ทางเลือก** หากไม่ได้ระบุ จะใช้เอเจนต์ปัจจุบันของคุณ --- -### งานย่อย +### Subtask (งานย่อย) -ใช้ `subtask` บูลีนเพื่อไม่จำเป็นต้องทำอะไรเลย [subagent](/docs/agents/#subagents) -เพราะเหตุใดจะช่วยให้คำสั่งไม่ทำให้ระบบหลักของคุณเสียหาย และจะ **บังคับ** เอเจนต์ให้ความเห็นตัวแทนย่อย -โปรดดู `mode` เพื่อดูการตั้งค่าเป็น `primary` ในคืนนี้ [agent](/docs/agents) แขก +ใช้ `subtask` (บูลีน) เพื่อระบุว่าคำสั่งควรทำงานเป็น [subagent](/docs/agents/#subagents) หรือไม่ + +การตั้งค่านี้จะป้องกันไม่ให้คำสั่งรบกวนบริบทหลักของเซสชัน และจะ **บังคับ** ให้เอเจนต์ใช้โหมดที่เหมาะสม ```json title="opencode.json" { @@ -294,9 +291,9 @@ Check for performance issues and suggest improvements. --- -### Model +### Model (โมเดล) -ใช้ `model` ไปจนถึงโมเดลเริ่มต้นสำหรับคำสั่งนี้ +ใช้ `model` เพื่อกำหนดโมเดลเฉพาะสำหรับคำสั่งนี้ ```json title="opencode.json" { @@ -312,12 +309,12 @@ Check for performance issues and suggest improvements. --- -## บิวท์อิน +### Built-ins (ในตัว) -opencode มีคำสั่งในคำสั่งหลายเช่น `/init`, `/undo`, `/redo`, `/share`, `/help`; [เรียนรู้เพิ่มเติม](/docs/tui#คำสั่ง) +OpenCode มีคำสั่งในตัวหลายคำสั่ง เช่น `/init`, `/undo`, `/redo`, `/share`, `/help` [เรียนรู้เพิ่มเติม](/docs/tui#คำสั่ง) :::note -คำสั่งนี้สามารถดำเนินการได้ในขั้นตอนนี้ +คุณสามารถเขียนทับคำสั่งในตัวได้โดยกำหนดคำสั่งที่กำหนดเองด้วยชื่อเดียวกัน ::: -บันทึกคำสั่งด้วยชื่อเดียวกันคำสั่งย้ำคำสั่งใน +อย่างไรก็ตาม เราไม่แนะนำให้ทำเช่นนั้น เว้นแต่คุณจะมีเหตุผลที่เฉพาะเจาะจง diff --git a/packages/web/src/content/docs/th/config.mdx b/packages/web/src/content/docs/th/config.mdx index c87b007f8..06836aca3 100644 --- a/packages/web/src/content/docs/th/config.mdx +++ b/packages/web/src/content/docs/th/config.mdx @@ -179,7 +179,7 @@ opencode run "Hello world" --- -### Server +### เซิร์ฟเวอร์ คุณสามารถกำหนดการตั้งค่าเซิร์ฟเวอร์สำหรับคำสั่ง `opencode serve` และ `opencode web` ผ่านตัวเลือก `server` @@ -208,7 +208,7 @@ opencode run "Hello world" --- -### Tools +### เครื่องมือ คุณสามารถจัดการเครื่องมือที่ LLM สามารถใช้ได้ผ่านตัวเลือก `tools` @@ -378,7 +378,7 @@ Bearer Token (`AWS_BEARER_TOKEN_BEDROCK` หรือ `/connect`) มีคว --- -### Commands +### คำสั่ง คุณสามารถกำหนดค่าคำสั่งที่กำหนดเองสำหรับงานซ้ำๆ ได้ผ่านตัวเลือก `command` @@ -404,7 +404,7 @@ Bearer Token (`AWS_BEARER_TOKEN_BEDROCK` หรือ `/connect`) มีคว --- -### Keybinds +### คีย์ลัด คุณสามารถปรับแต่งปุ่มลัดของคุณได้ผ่านตัวเลือก `keybinds` @@ -419,7 +419,7 @@ Bearer Token (`AWS_BEARER_TOKEN_BEDROCK` หรือ `/connect`) มีคว --- -### Autoupdate +### อัปเดตอัตโนมัติ OpenCode จะดาวน์โหลดการอัปเดตใหม่โดยอัตโนมัติเมื่อเริ่มต้นระบบ คุณสามารถปิดการใช้งานนี้ได้โดยใช้ตัวเลือก `autoupdate` @@ -435,7 +435,7 @@ OpenCode จะดาวน์โหลดการอัปเดตใหม --- -### Formatters +### ตัวจัดรูปแบบ คุณสามารถกำหนดค่าตัวจัดรูปแบบโค้ดผ่านตัวเลือก `formatter` @@ -461,7 +461,7 @@ OpenCode จะดาวน์โหลดการอัปเดตใหม --- -### Permissions +### การอนุญาต ตามค่าเริ่มต้น opencode **อนุญาตการดำเนินการทั้งหมด** โดยไม่ต้องมีการอนุมัติอย่างชัดเจน คุณสามารถเปลี่ยนสิ่งนี้ได้โดยใช้ตัวเลือก `permission` @@ -481,7 +481,7 @@ OpenCode จะดาวน์โหลดการอัปเดตใหม --- -### Compaction +### การบีบอัด คุณสามารถควบคุมลักษณะการทำงานของการบีบอัดบริบทได้โดยใช้ตัวเลือก `compaction` @@ -500,7 +500,7 @@ OpenCode จะดาวน์โหลดการอัปเดตใหม --- -### Watcher +### ตัวเฝ้าดู คุณสามารถกำหนดค่ารูปแบบการละเว้นตัวเฝ้าดูไฟล์ได้ผ่านตัวเลือก `watcher` @@ -532,7 +532,7 @@ OpenCode จะดาวน์โหลดการอัปเดตใหม --- -### Plugins +### ปลั๊กอิน [ปลั๊กอิน](/docs/plugins) ขยาย OpenCode ด้วยเครื่องมือที่กำหนดเอง hooks และการผสานรวม @@ -549,7 +549,7 @@ OpenCode จะดาวน์โหลดการอัปเดตใหม --- -### Instructions +### คำแนะนำ คุณสามารถกำหนดค่าคำแนะนำสำหรับรุ่นที่คุณใช้ผ่านตัวเลือก `instructions` @@ -609,7 +609,7 @@ OpenCode จะดาวน์โหลดการอัปเดตใหม --- -### Experimental +### ขั้นทดลอง ปุ่ม `experimental` มีตัวเลือกที่อยู่ระหว่างการพัฒนา diff --git a/packages/web/src/content/docs/th/enterprise.mdx b/packages/web/src/content/docs/th/enterprise.mdx index 629646597..9bc041fa7 100644 --- a/packages/web/src/content/docs/th/enterprise.mdx +++ b/packages/web/src/content/docs/th/enterprise.mdx @@ -111,14 +111,14 @@ OpenCode เป็นโอเพ่นซอร์สและไม่ได ## FAQ
-What is OpenCode Enterprise? +OpenCode Enterprise คืออะไร? OpenCode Enterprise เหมาะสำหรับองค์กรที่ต้องการให้แน่ใจว่าโค้ดและข้อมูลของตนไม่หลุดออกจากโครงสร้างพื้นฐาน ซึ่งสามารถทำได้โดยใช้การกำหนดค่าแบบรวมศูนย์ที่ทำงานร่วมกับ SSO และเกตเวย์ AI ภายในของคุณ
-How do I get started with OpenCode Enterprise? +ฉันจะเริ่มต้นใช้งาน OpenCode Enterprise ได้อย่างไร? เพียงเริ่มต้นด้วยการทดลองใช้ภายในกับทีมของคุณ ตามค่าเริ่มต้น OpenCode จะไม่จัดเก็บโค้ดหรือข้อมูลบริบทของคุณ ทำให้ง่ายต่อการเริ่มต้น @@ -127,21 +127,21 @@ OpenCode Enterprise เหมาะสำหรับองค์กรที่
-How does enterprise pricing work? +ราคาสำหรับองค์กรทำงานอย่างไร? เราเสนอราคาสำหรับองค์กรต่อที่นั่ง หากคุณมีเกตเวย์ LLM ของคุณเอง เราจะไม่เรียกเก็บเงินสำหรับtokensที่ใช้ สำหรับรายละเอียดเพิ่มเติม **ติดต่อเรา** เพื่อขอใบเสนอราคาที่กำหนดเองตามความต้องการขององค์กรของคุณ
-Is my data secure with OpenCode Enterprise? +ข้อมูลของฉันปลอดภัยกับ OpenCode Enterprise หรือไม่? ใช่. OpenCode จะไม่เก็บโค้ดหรือข้อมูลบริบทของคุณ การประมวลผลทั้งหมดเกิดขึ้นภายในเครื่องหรือผ่านการโทรศัพท์ API โดยตรงไปยังผู้ให้บริการ AI ของคุณ ด้วยการกำหนดค่าส่วนกลางและการบูรณาการ SSO ข้อมูลของคุณยังคงปลอดภัยภายในโครงสร้างพื้นฐานขององค์กรของคุณ
-Can we use our own private NPM registry? +เราสามารถใช้ private NPM registry ของเราเองได้หรือไม่? OpenCode รองรับการลงทะเบียน npm ส่วนตัวผ่านการรองรับไฟล์ `.npmrc` ดั้งเดิมของ Bun หากองค์กรของคุณใช้รีจิสทรีส่วนตัว เช่น JFrog Artifactory, Nexus หรือที่คล้ายกัน โปรดตรวจสอบให้แน่ใจว่านักพัฒนาได้รับการตรวจสอบสิทธิ์ก่อนเรียกใช้ OpenCode diff --git a/packages/web/src/content/docs/th/keybinds.mdx b/packages/web/src/content/docs/th/keybinds.mdx index e9973e334..2fbcd02a6 100644 --- a/packages/web/src/content/docs/th/keybinds.mdx +++ b/packages/web/src/content/docs/th/keybinds.mdx @@ -105,7 +105,7 @@ OpenCode มีรายการปุ่มลัดที่คุณปร --- -## Leader key +## ปุ่ม Leader OpenCode ใช้ปุ่ม `leader` สำหรับการเชื่อมโยงคีย์ส่วนใหญ่ วิธีนี้จะหลีกเลี่ยงความขัดแย้งใน terminal ของคุณ @@ -156,7 +156,7 @@ OpenCode ใช้ปุ่ม `leader` สำหรับการเชื่ terminal บางตัวไม่ส่งคีย์ตัวปรับแต่งพร้อม Enter เป็นค่าเริ่มต้น คุณอาจต้องกำหนดค่า terminal ของคุณให้ส่ง `Shift+Enter` เป็นลำดับหลีก -### terminal Windows +### Windows Terminal เปิด `settings.json` ของคุณที่: diff --git a/packages/web/src/content/docs/th/mcp-servers.mdx b/packages/web/src/content/docs/th/mcp-servers.mdx index 4fb641a87..bd5a4365c 100644 --- a/packages/web/src/content/docs/th/mcp-servers.mdx +++ b/packages/web/src/content/docs/th/mcp-servers.mdx @@ -9,7 +9,7 @@ description: เพิ่มเครื่องมือ MCP ในพื้ --- -#### Warning +#### คำเตือน เมื่อคุณใช้เซิร์ฟเวอร์ MCP เซิร์ฟเวอร์ดังกล่าวจะเพิ่มบริบท สิ่งนี้สามารถเพิ่มขึ้นได้อย่างรวดเร็วหากคุณมีเครื่องมือมากมาย ดังนั้นเราขอแนะนำให้ระมัดระวังเซิร์ฟเวอร์ MCP ที่คุณใช้ @@ -375,7 +375,7 @@ MCP ของคุณพร้อมใช้งานในฐานะเค --- -#### รูปแบบลูกโลก +#### รูปแบบ Glob รูปแบบ glob ใช้รูปแบบ globbing regex แบบง่าย: diff --git a/packages/web/src/content/docs/th/models.mdx b/packages/web/src/content/docs/th/models.mdx index d5789b024..859aff480 100644 --- a/packages/web/src/content/docs/th/models.mdx +++ b/packages/web/src/content/docs/th/models.mdx @@ -135,42 +135,42 @@ ID แบบเต็มคือ `provider_id/model_id` ตัวอย่า --- -## หลากหลาย +## Variants (แบบ) -หลายรุ่นรองรับหลายรุ่นด้วยการกำหนดค่าที่แตกต่างกัน OpenCode มาพร้อมกับตัวแปรเริ่มต้นในตัวสำหรับผู้ให้บริการยอดนิยม +โมเดลหลายตัวรองรับหลาย variants (รูปแบบย่อย) ที่มีการกำหนดค่าต่างกัน OpenCode มาพร้อมกับ variants เริ่มต้นในตัวสำหรับผู้ให้บริการยอดนิยม -### ตัวแปรในตัว +### Variants ในตัว (Built-in Variants) -OpenCode มาพร้อมกับตัวแปรเริ่มต้นสำหรับผู้ให้บริการหลายราย: +OpenCode มาพร้อมกับ variants เริ่มต้นสำหรับผู้ให้บริการหลายราย: **Anthropic**: -- `high` - ​​งบประมาณการคิดสูง (ค่าเริ่มต้น) -- `max` - ​​งบประมาณการคิดสูงสุด +- `high` - งบประมาณการคิดสูง (ค่าเริ่มต้น) +- `max` - งบประมาณการคิดสูงสุด **OpenAI**: แตกต่างกันไปตามรุ่น แต่โดยประมาณ: -- `none` - ​​ไม่มีเหตุผล -- `minimal` - ​​ความพยายามในการให้เหตุผลน้อยที่สุด -- `low` - ​​ความพยายามในการให้เหตุผลต่ำ -- `medium` - ​​ความพยายามในการให้เหตุผลปานกลาง -- `high` - ​​ความพยายามในการให้เหตุผลสูง -- `xhigh` - ​​ความพยายามในการให้เหตุผลสูงเป็นพิเศษ +- `none` - ไม่ใช้การให้เหตุผล +- `minimal` - ความพยายามในการให้เหตุผลน้อยที่สุด +- `low` - ความพยายามในการให้เหตุผลต่ำ +- `medium` - ความพยายามในการให้เหตุผลปานกลาง +- `high` - ความพยายามในการให้เหตุผลสูง +- `xhigh` - ความพยายามในการให้เหตุผลสูงเป็นพิเศษ **Google**: -- `low` - ​​ลดความพยายาม/token งบประมาณ -- `high` - ​​ความพยายามที่สูงขึ้น/token งบประมาณ +- `low` - งบประมาณการคิดต่ำ/token ต่ำ +- `high` - งบประมาณการคิดสูง/token สูง :::tip -รายการนี้ไม่ครอบคลุม ผู้ให้บริการรายอื่นหลายรายก็มีค่าเริ่มต้นในตัวเช่นกัน +รายการนี้ไม่ครอบคลุมทั้งหมด ผู้ให้บริการรายอื่นหลายรายก็มีค่าเริ่มต้นในตัวเช่นกัน ::: -### ตัวแปรที่กำหนดเอง +### Variants แบบกำหนดเอง -คุณสามารถแทนที่ตัวแปรที่มีอยู่หรือเพิ่มตัวแปรของคุณเองได้: +คุณสามารถแทนที่ variants ที่มีอยู่หรือเพิ่มของคุณเองได้: ```jsonc title="opencode.jsonc" {7-18} { @@ -195,9 +195,9 @@ OpenCode มาพร้อมกับตัวแปรเริ่มต้ } ``` -### ตัวแปรของวงจร +### การหมุนเวียน Variants -ใช้ปุ่มลัด `variant_cycle` เพื่อสลับระหว่างตัวแปรต่างๆ อย่างรวดเร็ว [เรียนรู้เพิ่มเติม](/docs/keybinds) +ใช้ปุ่มลัด `variant_cycle` เพื่อสลับระหว่าง variants ต่างๆ อย่างรวดเร็ว [เรียนรู้เพิ่มเติม](/docs/keybinds) --- diff --git a/packages/web/src/content/docs/th/modes.mdx b/packages/web/src/content/docs/th/modes.mdx index c9f9fe28f..0ed3d4da5 100644 --- a/packages/web/src/content/docs/th/modes.mdx +++ b/packages/web/src/content/docs/th/modes.mdx @@ -54,7 +54,7 @@ Build เป็นโหมด **ค่าเริ่มต้น** โดย คุณสามารถปรับแต่งโหมดในตัวหรือสร้างโหมดของคุณเองผ่านการกำหนดค่าได้ โหมดสามารถกำหนดค่าได้สองวิธี: -### JSON การกำหนดค่า +### การกำหนดค่าด้วย JSON กำหนดค่าโหมดในไฟล์กำหนดค่า `opencode.json` ของคุณ: @@ -116,7 +116,7 @@ Provide constructive feedback without making direct changes. --- -### Model +### Model (โมเดล) ใช้การกำหนดค่า `model` เพื่อแทนที่โมเดลเริ่มต้นสำหรับโหมดนี้ มีประโยชน์สำหรับการใช้โมเดลที่แตกต่างกันซึ่งปรับให้เหมาะกับงานที่แตกต่างกัน ตัวอย่างเช่น โมเดลสำหรับการวางแผนที่เร็วขึ้น โมเดลที่มีความสามารถมากขึ้นสำหรับการนำไปปฏิบัติ @@ -132,7 +132,7 @@ Provide constructive feedback without making direct changes. --- -### อุณหภูมิ +### Temperature (อุณหภูมิ) ควบคุมการสุ่มและความคิดสร้างสรรค์ของการตอบสนองของ AI ด้วยการกำหนดค่า `temperature` ค่าที่ต่ำกว่าจะทำให้คำตอบมีจุดมุ่งหมายและกำหนดได้มากขึ้น ในขณะที่ค่าที่สูงกว่าจะเพิ่มความคิดสร้างสรรค์และความแปรปรวน diff --git a/packages/web/src/content/docs/th/network.mdx b/packages/web/src/content/docs/th/network.mdx index 78bcbea72..86e7f8613 100644 --- a/packages/web/src/content/docs/th/network.mdx +++ b/packages/web/src/content/docs/th/network.mdx @@ -7,7 +7,7 @@ OpenCode รองรับตัวแปรสภาพแวดล้อม --- -## Proxy +## พร็อกซี OpenCode เคารพตัวแปรสภาพแวดล้อมพร็อกซีมาตรฐาน @@ -30,7 +30,7 @@ TUI สื่อสารกับเซิร์ฟเวอร์ HTTP ใน --- -### Authentication +### การยืนยันตัวตน หากพร็อกซีของคุณต้องการการรับรองความถูกต้องขั้นพื้นฐาน ให้ใส่ข้อมูลรับรองใน URL diff --git a/packages/web/src/content/docs/th/plugins.mdx b/packages/web/src/content/docs/th/plugins.mdx index 1e52f01e0..a2d74ceb9 100644 --- a/packages/web/src/content/docs/th/plugins.mdx +++ b/packages/web/src/content/docs/th/plugins.mdx @@ -26,7 +26,7 @@ description: เขียนปลั๊กอินของคุณเอง --- -### From npm +### จาก npm ระบุแพ็คเกจ npm ในไฟล์ปรับแต่งของคุณ @@ -331,7 +331,7 @@ export const MyPlugin = async ({ client }) => { --- -### Compaction hooks +### Hooks สำหรับการกระชับข้อมูล ปรับแต่งบริบทที่รวมไว้เมื่อมีการกระชับเซสชัน: diff --git a/packages/web/src/content/docs/th/providers.mdx b/packages/web/src/content/docs/th/providers.mdx index f8fc77c12..e9fbb351d 100644 --- a/packages/web/src/content/docs/th/providers.mdx +++ b/packages/web/src/content/docs/th/providers.mdx @@ -29,7 +29,7 @@ OpenCode ใช้ [AI SDK](https://ai-sdk.dev/) และ [Models.dev](https:// --- -#### Base URL +#### Base URL (URL พื้นฐาน) คุณสามารถปรับแต่งฐาน URL สำหรับผู้ให้บริการรายใดก็ได้โดยตั้งค่าตัวเลือก `baseURL` สิ่งนี้มีประโยชน์เมื่อใช้บริการพร็อกซีหรือจุดสิ้นสุดแบบกำหนดเอง @@ -282,7 +282,7 @@ OpenCode Zen คือรายชื่อโมเดลที่จัดท การใช้การสมัครสมาชิก Claude Pro/Max ใน OpenCode ไม่ได้รับการสนับสนุนอย่างเป็นทางการจาก [Anthropic](https://anthropic.com) ::: -##### ใช้API Key +##### การใช้ API Key คุณยังสามารถเลือก **สร้าง API คีย์** หากคุณไม่มีการสมัครสมาชิก Pro/Max นอกจากนี้ยังจะเปิดเบราว์เซอร์ของคุณและขอให้คุณเข้าสู่ระบบ Anthropic และให้รหัสที่คุณสามารถวางใน terminal ของคุณ @@ -341,7 +341,7 @@ OpenCode Zen คือรายชื่อโมเดลที่จัดท --- -### บริการความรู้ความเข้าใจ Azure +### Azure Cognitive Services 1. ไปที่ [พอร์ทัล Azure](https://portal.azure.com/) และสร้างทรัพยากร **Azure OpenAI** คุณจะต้องการ: - **ชื่อทรัพยากร**: นี่จะกลายเป็นส่วนหนึ่งของจุดสิ้นสุด API ของคุณ (`https://AZURE_COGNITIVE_SERVICES_RESOURCE_NAME.cognitiveservices.azure.com/`) @@ -388,7 +388,7 @@ OpenCode Zen คือรายชื่อโมเดลที่จัดท --- -### บาสเตน +### Baseten 1. ไปที่ [Baseten](https://app.baseten.co/) สร้างบัญชี และสร้างคีย์ API @@ -442,11 +442,11 @@ OpenCode Zen คือรายชื่อโมเดลที่จัดท --- -### เกตเวย์ AI ของ Cloudflare +### Cloudflare AI Gateway Cloudflare AI Gateway ช่วยให้คุณเข้าถึงโมเดลจาก OpenAI, Anthropic, Workers AI และอื่นๆ อีกมากมายผ่านตำแหน่งข้อมูลแบบรวม ด้วย [การเรียกเก็บเงินแบบรวม](https://developers.cloudflare.com/ai-gateway/features/unified-billing/) คุณไม่จำเป็นต้องใช้คีย์ API แยกต่างหากสำหรับผู้ให้บริการแต่ละราย -1. ไปที่ [แดชบอร์ด Cloudflare](https://dash.cloudflare.com/) ไปที่ **AI** > **เกตเวย์ AI** และสร้างเกตเวย์ใหม่ +1. ไปที่ [แดชบอร์ด Cloudflare](https://dash.cloudflare.com/) ไปที่ **AI** > **AI Gateway** และสร้างเกตเวย์ใหม่ 2. ตั้งค่ารหัสบัญชีและรหัสเกตเวย์ของคุณเป็นตัวแปรสภาพแวดล้อม @@ -500,7 +500,7 @@ Cloudflare AI Gateway ช่วยให้คุณเข้าถึงโม --- -### คอร์เทคส์ +### Cortecs 1. ไปที่ [คอนโซล Cortecs](https://cortecs.ai/) สร้างบัญชี และสร้างคีย์ API @@ -527,7 +527,7 @@ Cloudflare AI Gateway ช่วยให้คุณเข้าถึงโม --- -### ดีปซีค +### DeepSeek 1. ไปที่ [คอนโซล DeepSeek](https://platform.deepseek.com/) สร้างบัญชี แล้วคลิก **สร้างคีย์ API ใหม่** @@ -583,15 +583,15 @@ Cloudflare AI Gateway ช่วยให้คุณเข้าถึงโม ### Firmware -1. ไปที่ [แดชบอร์ดเฟิร์มแวร์](https://app.firmware.ai/signup) สร้างบัญชี และสร้างคีย์ API +1. ไปที่ [แดชบอร์ด Firmware](https://app.firmware.ai/signup) สร้างบัญชี และสร้างคีย์ API -2. เรียกใช้คำสั่ง `/connect` และค้นหา **เฟิร์มแวร์** +2. เรียกใช้คำสั่ง `/connect` และค้นหา **Firmware** ```txt /connect ``` -3. ป้อนคีย์เฟิร์มแวร์ API ของคุณ +3. ป้อนคีย์ Firmware API ของคุณ ```txt ┌ API key @@ -610,7 +610,7 @@ Cloudflare AI Gateway ช่วยให้คุณเข้าถึงโม ### Fireworks AI -1. ไปที่ [คอนโซล AI ดอกไม้ไฟ](https://app.fireworks.ai/) สร้างบัญชี แล้วคลิก **สร้าง API คีย์** +1. ไปที่ [คอนโซล Fireworks AI](https://app.fireworks.ai/) สร้างบัญชี แล้วคลิก **Create API Key** 2. รันคำสั่ง `/connect` และค้นหา **Fireworks AI** @@ -618,7 +618,7 @@ Cloudflare AI Gateway ช่วยให้คุณเข้าถึงโม /connect ``` -3. ป้อนคีย์ดอกไม้ไฟ AI API ของคุณ +3. ป้อนคีย์ Fireworks AI API ของคุณ ```txt ┌ API key @@ -659,7 +659,7 @@ GitLab Duo ให้การแชทแบบเอเจนต์ที่ข เลือก **OAuth** และเบราว์เซอร์ของคุณจะเปิดขึ้นเพื่อรับสิทธิ์ -#### Using Personal Access Token +#### การใช้ Personal Access Token 1. ไปที่ [GitLab User Settings > Access Tokens](https://gitlab.com/-/user_settings/personal_access_tokens) 2. คลิก **เพิ่มโทเค็นใหม่** @@ -791,7 +791,7 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here :::note บางรุ่นอาจต้องมี [Pro+ -สมัครสมาชิก](https://github.com/features/copilot/plans) เพื่อใช้งาน +subscription](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) ::: @@ -811,7 +811,7 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here │ │ Enter code: 8F43-6FCF │ - └ Waiting for authorization... + │ Waiting for authorization... ``` 3. ตอนนี้รันคำสั่ง `/models` เพื่อเลือกรุ่นที่คุณต้องการ @@ -822,7 +822,7 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here --- -### กูเกิล เวอร์เท็กซ์ เอไอ +### Google Vertex AI วิธีใช้ Google Vertex AI กับ OpenCode: @@ -895,9 +895,9 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here ### Hugging Face -[ผู้ให้บริการการอนุมานHugging Face](https://huggingface.co/docs/inference-providers) ช่วยให้สามารถเข้าถึงโมเดลแบบเปิดที่รองรับโดยผู้ให้บริการมากกว่า 17 ราย +[ผู้ให้บริการการอนุมาน Hugging Face](https://huggingface.co/docs/inference-providers) ช่วยให้สามารถเข้าถึงโมเดลแบบเปิดที่รองรับโดยผู้ให้บริการมากกว่า 17 ราย -1. ไปที่ [การตั้งค่าHugging Face](https://huggingface.co/settings/tokens/new?ownUserPermissions=inference.serverless.write&tokenType=fineGrained) เพื่อสร้างโทเค็นที่มีสิทธิ์ในการโทรไปยังผู้ให้บริการการอนุมาน +1. ไปที่ [การตั้งค่า Hugging Face](https://huggingface.co/settings/tokens/new?ownUserPermissions=inference.serverless.write&tokenType=fineGrained) เพื่อสร้างโทเค็นที่มีสิทธิ์ในการโทรไปยังผู้ให้บริการการอนุมาน 2. เรียกใช้คำสั่ง `/connect` และค้นหา **Hugging Face** @@ -922,7 +922,7 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here --- -### เฮลิโคน +### Helicone [Helicone](https://helicone.ai) เป็นแพลตฟอร์มการติดตาม LLM ที่ให้การบันทึก การตรวจสอบ และการวิเคราะห์สำหรับแอปพลิเคชัน AI ของคุณ Helicone AI Gateway กำหนดเส้นทางคำขอของคุณไปยังผู้ให้บริการที่เหมาะสมโดยอัตโนมัติตามรุ่น @@ -1073,7 +1073,7 @@ npm install -g opencode-helicone-session --- -### ไอโอ.NET +### IO.NET IO.NET มี 17 โมเดลที่ได้รับการปรับให้เหมาะกับการใช้งานที่หลากหลาย: @@ -1140,7 +1140,7 @@ IO.NET มี 17 โมเดลที่ได้รับการปรับ วิธีใช้ Kimi K2 จาก Moonshot AI: -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** @@ -1194,7 +1194,7 @@ IO.NET มี 17 โมเดลที่ได้รับการปรับ ### Nebius Token Factory -1. ไปที่ [คอนโซล Nebius Token Factory](https://tokenfactory.nebius.com/) สร้างบัญชี แล้วคลิก **เพิ่มรหัส** +1. ไปที่ [คอนโซล Nebius Token Factory](https://tokenfactory.nebius.com/) สร้างบัญชี แล้วคลิก **Add key** 2. รันคำสั่ง `/connect` และค้นหา **Nebius Token Factory** @@ -1267,7 +1267,7 @@ Ollama สามารถกำหนดค่าตัวเองสำหร 1. ไปที่ [https://ollama.com/](https://ollama.com/) แล้วลงชื่อเข้าใช้หรือสร้างบัญชี -2. ไปที่ **การตั้งค่า** > **คีย์** แล้วคลิก **เพิ่ม API คีย์** เพื่อสร้างคีย์ API ใหม่ +2. ไปที่ **Settings** > **Keys** แล้วคลิก **Add API Key** เพื่อสร้างคีย์ API ใหม่ 3. คัดลอกคีย์ API เพื่อใช้ใน OpenCode @@ -1327,13 +1327,13 @@ Ollama สามารถกำหนดค่าตัวเองสำหร /models ``` -##### ใช้API Key +##### การใช้ API Key -หากคุณมีคีย์ API อยู่แล้ว คุณสามารถเลือก **ป้อนคีย์ API ด้วยตนเอง** และวางลงใน terminal ของคุณ +หากคุณมีคีย์ API อยู่แล้ว คุณสามารถเลือก **Manually enter API Key** และวางลงใน terminal ของคุณ --- -### โอเพ่นโค้ดเซน +### OpenCode Zen OpenCode Zen คือรายการโมเดลที่ได้รับการทดสอบและตรวจสอบแล้วโดยทีมงาน OpenCode [เรียนรู้เพิ่มเติม](/docs/zen) diff --git a/packages/web/src/content/docs/th/rules.mdx b/packages/web/src/content/docs/th/rules.mdx index aef600f4b..c8deed792 100644 --- a/packages/web/src/content/docs/th/rules.mdx +++ b/packages/web/src/content/docs/th/rules.mdx @@ -66,7 +66,7 @@ opencode ยังรองรับการอ่านไฟล์ `AGENTS.md เนื่องจากสิ่งนี้ไม่ได้ผูกมัดกับ Git หรือแชร์กับทีมของคุณ เราขอแนะนำให้ใช้สิ่งนี้เพื่อระบุกฎส่วนบุคคลที่ LLM ควรปฏิบัติตาม -### Claude Code Compatibility +### ความเข้ากันได้กับ Claude Code สำหรับผู้ใช้ที่ย้ายจาก Claude Code นั้น OpenCode รองรับรูปแบบไฟล์ของ Claude Code เป็นทางเลือก: diff --git a/packages/web/src/content/docs/th/server.mdx b/packages/web/src/content/docs/th/server.mdx index 610f9f228..13302cf57 100644 --- a/packages/web/src/content/docs/th/server.mdx +++ b/packages/web/src/content/docs/th/server.mdx @@ -210,7 +210,7 @@ http://:/doc --- -### เครื่องมือ (ทดลอง) +### เครื่องมือ (ขั้นทดลอง) | Method | เส้นทาง | คำอธิบาย | การตอบสนอง | | ------ | ------------------------------------------- | ----------------------------------------------- | ---------------------------------------------------- | diff --git a/packages/web/src/content/docs/th/share.mdx b/packages/web/src/content/docs/th/share.mdx index 72e15912c..195d7696f 100644 --- a/packages/web/src/content/docs/th/share.mdx +++ b/packages/web/src/content/docs/th/share.mdx @@ -63,7 +63,7 @@ OpenCode รองรับโหมดการแชร์สามโหม --- -### 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 29ed9f6f4..d3658e66c 100644 --- a/packages/web/src/content/docs/th/skills.mdx +++ b/packages/web/src/content/docs/th/skills.mdx @@ -1,5 +1,5 @@ --- -title: Agent Skills +title: ทักษะของเอเจนต์ description: "กำหนดพฤติกรรมที่นำมาใช้ซ้ำได้ผ่านคำจำกัดความ SKILL.md" --- @@ -100,7 +100,7 @@ Ask clarifying questions if the target versioning scheme is unclear. --- -## Tool Description Discovery +## การค้นพบคำอธิบายเครื่องมือ OpenCode แสดงรายการทักษะที่มีอยู่ในคำอธิบายเครื่องมือ `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/tools.mdx b/packages/web/src/content/docs/th/tools.mdx index 780aaf7d7..6db4cfc2a 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 (Experimental) +### lsp (ขั้นทดลอง) โต้ตอบกับเซิร์ฟเวอร์ LSP ที่กำหนดค่าของคุณเพื่อรับฟีเจอร์อัจฉริยะด้านโค้ด เช่น คำจำกัดความ การอ้างอิง ข้อมูลโฮเวอร์ และลำดับชั้นการโทร diff --git a/packages/web/src/content/docs/th/troubleshooting.mdx b/packages/web/src/content/docs/th/troubleshooting.mdx index 13a84aea2..cd50c1379 100644 --- a/packages/web/src/content/docs/th/troubleshooting.mdx +++ b/packages/web/src/content/docs/th/troubleshooting.mdx @@ -121,7 +121,7 @@ OpenCode Desktop สามารถเริ่มต้นเซิร์ฟเ --- -### Linux: Wayland / X11 issues +### Linux: ปัญหา Wayland / X11 บน Linux การตั้งค่า Wayland บางอย่างอาจทำให้เกิดหน้าต่างว่างหรือข้อผิดพลาดของตัวประกอบ @@ -130,7 +130,7 @@ OpenCode Desktop สามารถเริ่มต้นเซิร์ฟเ --- -### Windows: WebView2 Runtime +### Windows: รันไทม์ WebView2 บน Windows OpenCode Desktop ต้องใช้ Microsoft Edge **WebView2 Runtime** หากแอปเปิดเป็นหน้าต่างว่างหรือไม่เริ่มทำงาน ให้ติดตั้ง/update WebView2 แล้วลองอีกครั้ง @@ -250,7 +250,7 @@ OpenCode Desktop จะแสดงการแจ้งเตือนของ --- -### AI_APICallError and provider package issues +### AI_APICallError และปัญหาแพ็คเกจผู้ให้บริการ หากคุณพบข้อผิดพลาดในการโทร 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 d8d6c46c2..9151462d7 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 +## คำสั่ง Bash เริ่มข้อความด้วย `!` เพื่อรันคำสั่ง shell diff --git a/packages/web/src/content/docs/th/web.mdx b/packages/web/src/content/docs/th/web.mdx index b1b3786d7..33bd3020c 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 +### พอร์ต ตามค่าเริ่มต้น OpenCode จะเลือกพอร์ตที่พร้อมใช้งาน คุณสามารถระบุพอร์ต: diff --git a/packages/web/src/content/docs/th/zen.mdx b/packages/web/src/content/docs/th/zen.mdx index 35534bb17..f0b39ceaa 100644 --- a/packages/web/src/content/docs/th/zen.mdx +++ b/packages/web/src/content/docs/th/zen.mdx @@ -233,7 +233,7 @@ Zen ยังใช้งานได้ดีกับทีมอีกด้ --- -### Bring Your Own Key +### นำคีย์ของคุณมาเอง คุณสามารถใช้คีย์ OpenAI หรือ Anthropic API ของคุณเองในขณะที่ยังเข้าถึงรุ่นอื่นๆ ใน Zen ได้ diff --git a/packages/web/src/content/docs/tr/acp.mdx b/packages/web/src/content/docs/tr/acp.mdx index 899d9429f..abdfda091 100644 --- a/packages/web/src/content/docs/tr/acp.mdx +++ b/packages/web/src/content/docs/tr/acp.mdx @@ -1,19 +1,19 @@ --- -title: ACP Destek -description: opencode'u ACP uyumlu herhangi bir sürdürülebilirde kullanın. +title: ACP Desteği +description: opencode'u ACP uyumlu herhangi bir editörde kullanın. --- -opencode, [Agent Client Protocol](https://agentclientprotocol.com) veya (ACP) dosyalarını destekleyerek onu doğrudan uyumlu tamamlayıcılarda ve IDE'lerde kullanmanızı sağlar. +opencode, [Agent Client Protocol](https://agentclientprotocol.com) veya (ACP) dosyalarını destekleyerek onu doğrudan uyumlu editörlerde ve IDE'lerde kullanmanızı sağlar. :::tip -ACP'yi destekleyenlerin ve araçların listesi için [ACP progress report](https://zed.dev/blog/acp-progress-report#available-now)'e bakın. +ACP'yi destekleyen editörlerin ve araçların listesi için [ACP progress report](https://zed.dev/blog/acp-progress-report#available-now)'e bakın. ::: -ACP, kod editörleri ile AI kullanma araçları arasındaki iletişimi standartlaştıran açık bir protokoldür. +ACP, kod editörleri ile AI kodlama ajanları arasındaki iletişimi standartlaştıran açık bir protokoldür. --- -## Yapılandır +## Yapılandırma opencode'u ACP aracılığıyla kullanmak için düzenleyicinizi `opencode acp` komutunu çalıştıracak şekilde yapılandırın. @@ -25,7 +25,7 @@ Aşağıda ACP'yi destekleyen popüler düzenleyicilere ilişkin örnekler veril ### Zed -[Zed](https://zed.dev) bakımınıza (`~/.config/zed/settings.json`) ekleyin: +[Zed](https://zed.dev) yapılandırmanıza (`~/.config/zed/settings.json`) ekleyin: ```json title="~/.config/zed/settings.json" { @@ -82,13 +82,13 @@ Açmak için **Komut Paleti**'ndeki `agent: new thread` eylemini kullanın. } ``` -Açmak için AI Sohbet temsilcisi seçicisindeki yeni 'opencode' aracısını kullanın. +Açmak için AI Chat agent seçicisindeki yeni 'OpenCode' ajanını kullanın. --- ### Avante.nvim -[Avante.nvim](https://github.com/yetone/avante.nvim) miktarınıza ekleyin: +[Avante.nvim](https://github.com/yetone/avante.nvim) yapılandırmanıza ekleyin: ```lua { @@ -121,7 +121,7 @@ Ortam değişkenlerini iletmeniz gerekiyor: ### CodeCompanion.nvim -opencode'u [CodeCompanion.nvim](https://github.com/olimorris/codecompanion.nvim)'de ACP aracısı olarak kullanmak için Neovim yapılandırmanıza aşağıdakileri ekleyin: +opencode'u [CodeCompanion.nvim](https://github.com/olimorris/codecompanion.nvim)'de ACP ajanı olarak kullanmak için Neovim yapılandırmanıza aşağıdakileri ekleyin: ```lua require("codecompanion").setup({ @@ -136,7 +136,7 @@ require("codecompanion").setup({ }) ``` -Bu yapılandırma, CodeCompanion'ı opencode'u sohbet için ACP aracısı olarak kullanacak şekilde ayarlar. +Bu yapılandırma, CodeCompanion'ı opencode'u sohbet için ACP ajanı olarak kullanacak şekilde ayarlar. Ortam değişkenlerini (`OPENCODE_API_KEY` gibi) iletmeniz gerekiyorsa, tüm ayrıntılar için CodeCompanion.nvim belgelerindeki [Configuring Adapters: Environment Variables](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key)'ye bakın. @@ -145,12 +145,12 @@ Ortam değişkenlerini (`OPENCODE_API_KEY` gibi) iletmeniz gerekiyorsa, tüm ayr opencode, terminalde olduğu gibi ACP aracılığıyla aynı şekilde çalışır. Tüm özellikler desteklenir: :::note -`/undo` ve `/redo` gibi bazı yerleşik eğik çizgi komutları şu anda desteklenmemektedir. +`/undo` ve `/redo` gibi bazı yerleşik slash komutları şu anda desteklenmemektedir. ::: - Yerleşik araçlar (dosya işlemleri, terminal komutları vb.) -- Özel araçlar ve eğik çizgi komutları +- Özel araçlar ve slash komutları - opencode yapılandırmanızda yapılandırılmış MCP sunucuları - `AGENTS.md`'dan projeye özel kurallar -- Özel formatlayıcılar ve linterler +- Özel biçimlendiriciler ve linter'lar - Aracılar ve izin sistemi diff --git a/packages/web/src/content/docs/tr/agents.mdx b/packages/web/src/content/docs/tr/agents.mdx index c9036810a..47c16abf1 100644 --- a/packages/web/src/content/docs/tr/agents.mdx +++ b/packages/web/src/content/docs/tr/agents.mdx @@ -1,9 +1,9 @@ --- -title: Agents +title: Agent'lar description: Özel agent'ları yapılandırın ve kullanın. --- -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. +Agent'lar, belirli görevler ve iş akışları için yapılandırılabilen uzmanlaşmış AI asistanlarıdır. Özel istemler, 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 agent'ını kullanın. @@ -15,48 +15,47 @@ Bir oturum sırasında agent'lar arasında geçiş yapabilir veya onları `@` if ## Türler -opencode'da iki tür aracı vardır; birincil ajanlar ve alt ajanlar. +opencode'da iki tür agent vardır; birincil agent'lar ve alt agent'lar. --- -### Primary agent'lar +### Birincil agent'lar -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. +Birincil 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 primary agent'lar arasında geçiş yapmak için **Sekme** tuşunu kullanabilirsiniz. +Bir oturum sırasında birincil agent'lar arasında geçiş yapmak için **Sekme** tuşunu kullanabilirsiniz. ::: -opencode, **Build** ve **Plan** olmak üzere iki yerleşik primary agent ile birlikte gelir. Kuyu -aşağıdakilere bakın. +opencode, **Build** ve **Plan** olmak üzere iki yerleşik birincil agent ile birlikte gelir. Bunlara aşağıda bakacağız. --- -### Subagent'lar +### Alt agent'lar -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. +Alt agent'lar, birincil 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, **General** ve **Explore** olmak üzere iki yerleşik subagent ile birlikte gelir. Buna aşağıda bakacağız. +opencode, **General** ve **Explore** olmak üzere iki yerleşik alt agent ile birlikte gelir. Buna aşağıda bakacağız. --- -## Dahili +## Yerleşik -opencode iki yerleşik primary agent ve iki yerleşik subagent ile birlikte gelir. +opencode iki yerleşik birincil agent ve iki yerleşik alt agent ile birlikte gelir. --- -### Build'i kullan +### Build Kullanımı -_Mode_: `primary` +_Mod_: `primary` -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. +Build, tüm araçların etkin olduğu **varsayılan** birincil 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ımı -_Mode_: `primary` +_Mod_: `primary` 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: @@ -64,45 +63,45 @@ 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 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. +Bu agent, LLM'in 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. --- -### General'ı kullan +### General Kullanımı -_Mode_: `subagent` +_Mod_: `subagent` 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. --- -### Explore'u kullan +### Explore Kullanımı -_Mode_: `subagent` +_Mod_: `subagent` 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. --- -### Compact'i kullan +### Compact Kullanımı -_Mode_: `primary` +_Mod_: `primary` 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. --- -### Title'ı kullan +### Title Kullanımı -_Mode_: `primary` +_Mod_: `primary` 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 +### Summary Kullanımı -_Mode_: `primary` +_Mod_: `primary` Oturum özetleri oluşturan gizli sistem agent'ı. Otomatik olarak çalışır ve kullanıcı arayüzünde seçilemez. @@ -110,25 +109,25 @@ Oturum özetleri oluşturan gizli sistem agent'ı. Otomatik olarak çalışır v ## Kullanım -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. +1. Birincil 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. 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. +2. Alt agent'lar çağrılabilir: + - Açıklamalarına göre özel görevler için birincil agent'lar tarafından **otomatik olarak**. + - Mesajınızda bir alt agent'tan **@ bahsederek** manuel olarak. Örneğin. ```txt frame="none" @general help me search for this function ``` -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: +3. **Oturumlar arasında gezinme**: Alt agent'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 subagent çalışması arasında sorunsuz bir şekilde geçiş yapmanıza olanak tanır. + Bu, ana görüşme ile özel alt agent çalışması arasında sorunsuz bir şekilde geçiş yapmanıza olanak tanır. --- -## Yapılandır +## Yapılandırma Yerleşik agent'ları özelleştirebilir veya yapılandırma yoluyla kendinizinkini oluşturabilirsiniz. Agent'lar iki şekilde yapılandırılabilir: @@ -216,7 +215,7 @@ Bu yapılandırma seçeneklerine ayrıntılı olarak bakalım. --- -### Description +### Açıklama 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. @@ -234,9 +233,9 @@ Bu **gerekli** bir yapılandırma seçeneğidir. --- -### Temperature +### Sıcaklık -LLM'nin yanıtlarının rastgeleliğini ve yaratıcılığını `temperature` yapılandırmasıyla kontrol edin. +LLM'in yanıtlarının rastgeleliğini ve yaratıcılığını `temperature` yapılandırmasıyla kontrol edin. Düşük değerler yanıtları daha odaklı ve belirleyici hale getirirken, yüksek değerler yaratıcılığı ve değişkenliği artırır. @@ -281,7 +280,7 @@ Sıcaklık belirtilmezse opencode modeline özgü varsayılanları kullanır; ç --- -### Max steps +### Maksimum adım 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. @@ -307,7 +306,7 @@ Eski `maxSteps` alanı kullanımdan kaldırıldı. Bunun yerine `steps` kullanı --- -### Disable +### Devre dışı bırakma Agent'ı devre dışı bırakmak için `true` olarak ayarlayın. @@ -323,7 +322,7 @@ Agent'ı devre dışı bırakmak için `true` olarak ayarlayın. --- -### Prompt +### İstem 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. @@ -346,7 +345,7 @@ Bu yol, yapılandırma dosyasının bulunduğu yere göredir. Yani bu hem global 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, 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. +Bir model belirtmezseniz, birincil agent'lar [model globally configured](/docs/config#models)'yi kullanırken alt agent'lar, alt agent'ı çağıran birincil agent'ın modelini kullanır. ::: ```json title="opencode.json" @@ -363,7 +362,7 @@ opencode hesabınızdaki model kimliğini `provider/model-id` biçimini kullanı --- -### Tools +### Araçlar `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. @@ -410,7 +409,7 @@ Aynı anda birden fazla aracı kontrol etmek için joker karakterleri de kullana --- -### Permissions +### İzinler 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: @@ -522,7 +521,7 @@ Son eşleşen kural öncelikli olduğundan, `*` joker karakterini ilk sıraya ve --- -### Mode +### Mod 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. @@ -540,9 +539,9 @@ Agent'ın modunu `mode` yapılandırmasıyla kontrol edin. `mode` seçeneği age --- -### Hidden +### Gizli -`@` 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. +`@` otomatik tamamlama menüsünden bir alt agent'ı `hidden: true` ile gizleyin. Yalnızca diğer agent'lar tarafından Task aracı aracılığıyla programlı olarak çağrılması gereken dahili alt agent'lar için kullanışlıdır. ```json title="opencode.json" { @@ -555,7 +554,7 @@ Agent'ın modunu `mode` yapılandırmasıyla kontrol edin. `mode` seçeneği age } ``` -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. +Bu yalnızca otomatik menüdeki görünürlüğü etkiler. İzinler izin verirse, gizli agent'lar model tarafından Task aracı aracılığıyla çağrılmaya devam edilebilir. :::note Yalnızca `mode: subagent` agent'ları için geçerlidir. @@ -563,9 +562,9 @@ Yalnızca `mode: subagent` agent'ları için geçerlidir. --- -### Task permissions +### Görev izinleri -`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. +`permission.task` ile bir agent'ın Task aracı aracılığıyla hangi alt agent'ları çağırabileceğini kontrol edin. Esnek eşleştirme için küresel desenleri kullanır. ```json title="opencode.json" { @@ -584,19 +583,19 @@ Yalnızca `mode: subagent` agent'ları için geçerlidir. } ``` -`deny` olarak ayarlandığında, subagent Task aracı açıklamasından tamamen kaldırılır, böylece model onu çağırmaya çalışmaz. +`deny` olarak ayarlandığında, alt agent 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, agent'ın görev izinleri bunu reddetse bile, her zaman herhangi bir subagent'ı `@` 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 alt agent'ı `@` otomatik tamamlama menüsü aracılığıyla doğrudan çağırabilir. ::: --- -### Color +### Renk 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. @@ -635,9 +634,9 @@ Değerler 0,0 ile 1,0 arasında değişir. Düşük değerler daha odaklıdır, --- -### Additional +### Ek -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. +Agent yapılandırmanızdaki diğer seçenekler, model seçenekleri olarak **doğrudan sağlayıcıya** iletilecektir. Bu, sağlayıcıya özgü özelliklerin ve parametrelerin kullanılmasını sağlar. Örneğin OpenAI'nin akıl yürütme modelleriyle akıl yürütme çabasını kontrol edebilirsiniz: @@ -662,7 +661,7 @@ Mevcut modellerin listesini görmek için `opencode models` komutunu çalıştı --- -## Agent oluşturma +## Agent Oluşturma Aşağıdaki komutu kullanarak yeni agent'lar oluşturabilirsiniz: @@ -672,17 +671,17 @@ opencode agent create Bu etkileşimli komut şunları sağlayacaktır: -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. +1. Agent'ı nereye kaydedeceğinizi sorar; küresel veya projeye özel. +2. Agent'ın ne yapması gerektiğinin açıklamasını ister. +3. Uygun bir sistem prompt'u ve tanımlayıcı oluşturur. +4. Agent'ın hangi araçlara erişebileceğini seçmenize izin verir. +5. Son olarak agent yapılandırmasıyla bir Markdown dosyası oluşturur. --- -## Kullanım durumları +## Kullanım Senaryoları -Farklı agent'lara yönelik bazı yaygın kullanım durumları aşağıda verilmiştir. +Farklı agent'lara yönelik bazı yaygın kullanım senaryoları aşağıda verilmiştir. - **Build agent**: Tüm araçların etkinleştirildiği tam geliştirme çalışması - **Plan agent**: Değişiklik yapmadan analiz ve planlama @@ -702,7 +701,7 @@ Paylaşmak istediğiniz bir agent'ınız var mı? [Submit a PR](https://github.c --- -### Documentation agent +### Dokümantasyon agent'ı ```markdown title="~/.config/opencode/agents/docs-writer.md" --- @@ -724,7 +723,631 @@ Focus on: --- -### Security auditor +### Güvenlik denetçisi + +```markdown title="~/.config/opencode/agents/security-auditor.md" +--- +description: Performs security audits and identifies vulnerabilities +mode: subagent +tools: + write: false + edit: false +--- + +You are a security expert. Focus on identifying potential security issues. + +Look for: + +- Input validation vulnerabilities +- Authentication and authorization flaws +- Data exposure risks +- Dependency vulnerabilities +- Configuration security issues +``` + +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 subagent çalışması arasında sorunsuz bir şekilde geçiş yapmanıza olanak tanır. + +--- + +## Yapılandırma veya yapılandırma yoluyla kendinizinkini oluşturabilirsiniz. Agent'lar iki şekilde yapılandırılabilir: + +--- + +### JSON + +Agent'ları `opencode.json` yapılandırma dosyanızda yapılandırın: + +```json title="opencode.json" +{ + "$schema": "https://opencode.ai/config.json", + "agent": { + "build": { + "mode": "primary", + "model": "anthropic/claude-sonnet-4-20250514", + "prompt": "{file:./prompts/build.txt}", + "tools": { + "write": true, + "edit": true, + "bash": true + } + }, + "plan": { + "mode": "primary", + "model": "anthropic/claude-haiku-4-20250514", + "tools": { + "write": false, + "edit": false, + "bash": false + } + }, + "code-reviewer": { + "description": "Reviews code for best practices and potential issues", + "mode": "subagent", + "model": "anthropic/claude-sonnet-4-20250514", + "prompt": "You are a code reviewer. Focus on security, performance, and maintainability.", + "tools": { + "write": false, + "edit": false + } + } + } +} +``` + +--- + +### Markdown + +Ayrıca agent'ları Markdown dosyalarını kullanarak da tanımlayabilirsiniz. Bunları şuraya yerleştirin: + +- Global: `~/.config/opencode/agents/` +- Per-project: `.opencode/agents/` + +```markdown title="~/.config/opencode/agents/review.md" +--- +description: Reviews code for quality and best practices +mode: subagent +model: anthropic/claude-sonnet-4-20250514 +temperature: 0.1 +tools: + write: false + edit: false + bash: false +--- + +You are in code review mode. Focus on: + +- Code quality and best practices +- Potential bugs and edge cases +- Performance implications +- Security considerations + +Provide constructive feedback without making direct changes. +``` + +Markdown dosyasının adı agent'ın adı olur. Örneğin, `review.md` bir `review` agent'ı oluşturur. + +--- + +## Seçenekler + +Bu yapılandırma seçeneklerine ayrıntılı olarak bakalım. + +--- + +### Açıklama + +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" +{ + "agent": { + "review": { + "description": "Reviews code for best practices and potential issues" + } + } +} +``` + +Bu **gerekli** bir yapılandırma seçeneğidir. + +--- + +### Sıcaklık + +LLM'nin yanıtlarının rastgeleliğini ve yaratıcılığını `temperature` yapılandırmasıyla kontrol edin. + +Düşük değerler yanıtları daha odaklı ve belirleyici hale getirirken, yüksek değerler yaratıcılığı ve değişkenliği artırır. + +```json title="opencode.json" +{ + "agent": { + "plan": { + "temperature": 0.1 + }, + "creative": { + "temperature": 0.8 + } + } +} +``` + +Sıcaklık değerleri tipik olarak 0,0 ila 1,0 arasındadır: + +- **0,0-0,2**: Çok odaklı ve belirleyici yanıtlar, kod analizi ve planlama için idealdir +- **0,3-0,5**: Biraz yaratıcılık içeren dengeli yanıtlar, genel gelişim görevleri için iyi +- **0,6-1,0**: Daha yaratıcı ve çeşitli yanıtlar, beyin fırtınası ve keşif için yararlı + +```json title="opencode.json" +{ + "agent": { + "analyze": { + "temperature": 0.1, + "prompt": "{file:./prompts/analysis.txt}" + }, + "build": { + "temperature": 0.3 + }, + "brainstorm": { + "temperature": 0.7, + "prompt": "{file:./prompts/creative.txt}" + } + } +} +``` + +Sıcaklık belirtilmezse opencode modeline özgü varsayılanları kullanır; çoğu model için genellikle 0, Qwen modelleri için 0,55. + +--- + +### Maksimum adım + +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 agent yinelemeye devam edecektir. + +```json title="opencode.json" +{ + "agent": { + "quick-thinker": { + "description": "Fast reasoning with limited iterations", + "prompt": "You are a quick thinker. Solve problems with minimal steps.", + "steps": 5 + } + } +} +``` + +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. +::: + +--- + +### Devre dışı bırakma + +Agent'ı devre dışı bırakmak için `true` olarak ayarlayın. + +```json title="opencode.json" +{ + "agent": { + "review": { + "disable": true + } + } +} +``` + +--- + +### İstem + +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" +{ + "agent": { + "review": { + "prompt": "{file:./prompts/code-review.txt}" + } + } +} +``` + +Bu yol, yapılandırma dosyasının bulunduğu yere göredir. Yani bu hem global opencode yapılandırması hem de projeye özel yapılandırma için işe yarar. + +--- + +### Model + +Bu agent'ın varsayılan modelini geçersiz kılmak 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, primary agent'lar [model globally configured](/docs/config#models)'yi kullanırken subagent'lar, subagent'ı çağıran primary agent'ın modelini kullanır. +::: + +```json title="opencode.json" +{ + "agent": { + "plan": { + "model": "anthropic/claude-haiku-4-20250514" + } + } +} +``` + +opencode hesabınızdaki model kimliğini `provider/model-id` biçimini kullanır. Örneğin, [OpenCode Zen](/docs/zen) kullanıyorsanız, GPT 5.1 Codex için `opencode/gpt-5.1-codex` kullanırsınız. + +--- + +### Araçlar + +`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} +{ + "$schema": "https://opencode.ai/config.json", + "tools": { + "write": true, + "bash": true + }, + "agent": { + "plan": { + "tools": { + "write": false, + "bash": false + } + } + } +} +``` + +:::note +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: + +```json title="opencode.json" +{ + "$schema": "https://opencode.ai/config.json", + "agent": { + "readonly": { + "tools": { + "mymcp_*": false, + "write": false, + "edit": false + } + } + } +} +``` + +[Araçlar hakkında daha fazla bilgi](/docs/tools). + +--- + +### İzinler + +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"` — Agent çalıştırmadan önce onay iste +- `"allow"` — Onay olmadan tüm işlemlere izin ver +- `"deny"` — Agent'ı devre dışı bırakır + +```json title="opencode.json" +{ + "$schema": "https://opencode.ai/config.json", + "permission": { + "edit": "deny" + } +} +``` + +Bu izinleri agent başına geçersiz kılabilirsiniz. + +```json title="opencode.json" {3-5,8-10} +{ + "$schema": "https://opencode.ai/config.json", + "permission": { + "edit": "deny" + }, + "agent": { + "build": { + "permission": { + "edit": "ask" + } + } + } +} +``` + +İzinleri Markdown agent'larında da ayarlayabilirsiniz. + +```markdown title="~/.config/opencode/agents/review.md" +--- +description: Code review without edits +mode: subagent +permission: + edit: deny + bash: + "*": ask + "git diff": allow + "git log*": allow + "grep *": allow + webfetch: deny +--- + +Only analyze code and suggest changes. +``` + +Belirli bash komutları için izinleri ayarlayabilirsiniz. + +```json title="opencode.json" {7} +{ + "$schema": "https://opencode.ai/config.json", + "agent": { + "build": { + "permission": { + "bash": { + "git push": "ask", + "grep *": "allow" + } + } + } + } +} +``` + +Bu küresel bir desen alabilir. + +```json title="opencode.json" {7} +{ + "$schema": "https://opencode.ai/config.json", + "agent": { + "build": { + "permission": { + "bash": { + "git *": "ask" + } + } + } + } +} +``` + +Ayrıca tüm komutların izinlerini yönetmek için `*` joker karakterini de kullanabilirsiniz. +Son eşleşen kural öncelikli olduğundan, `*` joker karakterini ilk sıraya ve belirli kuralları sonraya koyun. + +```json title="opencode.json" {8} +{ + "$schema": "https://opencode.ai/config.json", + "agent": { + "build": { + "permission": { + "bash": { + "*": "ask", + "git status *": "allow" + } + } + } + } +} +``` + +[İzinler hakkında daha fazla bilgi](/docs/permissions). + +--- + +### Mod + +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" +{ + "agent": { + "review": { + "mode": "subagent" + } + } +} +``` + +`mode` seçeneği `primary`, `subagent` veya `all` olarak ayarlanabilir. `mode` belirtilmezse varsayılan olarak `all` olur. + +--- + +### Gizli + +`@` 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" +{ + "agent": { + "internal-helper": { + "mode": "subagent", + "hidden": true + } + } +} +``` + +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` agent'ları için geçerlidir. +::: + +--- + +### Görev izinleri + +`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" +{ + "agent": { + "orchestrator": { + "mode": "primary", + "permission": { + "task": { + "*": "deny", + "orchestrator-*": "allow", + "code-reviewer": "ask" + } + } + } + } +} +``` + +`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, 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 + +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. + +geçerli bir onaltılık renk (ör. `#FF5733`) veya tema rengini kullanın: `primary`, `secondary`, `accent`, `success`, `warning`, `error`, `info`. + +```json title="opencode.json" +{ + "agent": { + "creative": { + "color": "#ff6b6b" + }, + "code-reviewer": { + "color": "accent" + } + } +} +``` + +--- + +### Top P + +`top_p` seçeneğiyle yanıt çeşitliliğini kontrol edin. Rastgeleliği kontrol etmek için sıcaklığa alternatif. + +```json title="opencode.json" +{ + "agent": { + "brainstorm": { + "top_p": 0.9 + } + } +} +``` + +Değerler 0,0 ile 1,0 arasında değişir. Düşük değerler daha odaklıdır, yüksek değerler ise daha çeşitlidir. + +--- + +### Ek + +Agent yapılandırmanızdaki diğer seçenekler, model seçenekleri olarak **doğrudan sağlayıcıya** iletilecektir. Bu, sağlayıcıya özgü özelliklerin kullanılmasını sağlar. + +Örneğin OpenAI'nin akıl yürütme modelleriyle akıl yürütme çabasını kontrol edebilirsiniz: + +```json title="opencode.json" {6,7} +{ + "agent": { + "deep-thinker": { + "description": "Agent that uses high reasoning effort for complex problems", + "model": "openai/gpt-5", + "reasoningEffort": "high", + "textVerbosity": "low" + } + } +} +``` + +Bu ek seçenekler modele ve sağlayıcıya özeldir. Kullanılabilir parametreler için sağlayıcınızın belgelerine bakın. + +:::tip +Mevcut modellerin listesini görmek için `opencode models` komutunu çalıştırın. +::: + +--- + +## Agent Oluşturma + +Aşağıdaki komutu kullanarak yeni agent'lar oluşturabilirsiniz: + +```bash +opencode agent create +``` + +Bu etkileşimli komut şunları sağlayacaktır: + +1. Agent'ı nereye kaydedeceğinizi sorun; küresel veya projeye özel. +2. Agent'ın ne yapması gerektiğinin açıklaması. +3. Uygun bir sistem istemi 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 Senaryoları + +Farklı agent'lara yönelik bazı yaygın kullanım senaryoları aşağıda verilmiştir. + +- **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 + +--- + +## Örnekler + +Yararlı bulabileceğiniz bazı örnek agent'ları burada bulabilirsiniz. + +:::tip +Paylaşmak istediğiniz bir agent'ınız var mı? [Submit a PR](https://github.com/anomalyco/opencode). +::: + +--- + +### Dokümantasyon agent'ı + +```markdown title="~/.config/opencode/agents/docs-writer.md" +--- +description: Writes and maintains project documentation +mode: subagent +tools: + bash: false +--- + +You are a technical writer. Create clear, comprehensive documentation. + +Focus on: + +- Clear explanations +- Proper structure +- Code examples +- User-friendly language +``` + +--- + +### Güvenlik denetçisi ```markdown title="~/.config/opencode/agents/security-auditor.md" --- diff --git a/packages/web/src/content/docs/tr/cli.mdx b/packages/web/src/content/docs/tr/cli.mdx index fc8f1a431..ae151bd5c 100644 --- a/packages/web/src/content/docs/tr/cli.mdx +++ b/packages/web/src/content/docs/tr/cli.mdx @@ -36,7 +36,7 @@ opencode [project] | `--fork` | | Devam ederken oturumu fork'lar (`--continue` veya `--session` ile kullanın) | | `--prompt` | | Kullanılacak prompt | | `--model` | `-m` | provider/model biçiminde kullanılacak model | -| `--agent` | | Kullanılacak temsilci | +| `--agent` | | Kullanılacak agent | | `--port` | | Dinlenecek port | | `--hostname` | | Dinlenecek host adı | @@ -50,7 +50,7 @@ opencode CLI ayrıca aşağıdaki komutlara da sahiptir. ### agent -opencode için aracıları yönetin. +opencode için agent'ları yönetin. ```bash opencode agent [command] @@ -87,13 +87,13 @@ opencode attach http://10.20.30.40:4096 #### create -Özel yapılandırmaya sahip yeni bir aracı oluşturun. +Özel yapılandırmaya sahip yeni bir agent oluşturun. ```bash opencode agent create ``` -Bu komut, özel sistem istemi ve araç yapılandırmasıyla yeni bir aracı oluşturma konusunda size yol gösterecektir. +Bu komut, özel sistem istemi ve araç yapılandırmasıyla yeni bir agent oluşturma konusunda size yol gösterecektir. --- @@ -553,32 +553,32 @@ opencode CLI aşağıdaki global bayrakları destekler. opencode ortam değişkenleri kullanılarak yapılandırılabilir. -| Değişken | Tür | Açıklama | +| Değişken | Tip | Açıklama | | ------------------------------------- | ------- | --------------------------------------------------------------------------- | -| `OPENCODE_AUTO_SHARE` | boole | Oturumları otomatik olarak paylaş | -| `OPENCODE_GIT_BASH_PATH` | dize | Windows'ta yürütülebilir Git Bash'in Yolu | -| `OPENCODE_CONFIG` | dize | Yapılandırma dosyasının yolu | -| `OPENCODE_CONFIG_DIR` | dize | Yapılandırma dizinine giden yol | +| `OPENCODE_AUTO_SHARE` | boolean | Oturumları otomatik olarak paylaş | +| `OPENCODE_GIT_BASH_PATH` | string | Windows'ta yürütülebilir Git Bash'in Yolu | +| `OPENCODE_CONFIG` | string | Yapılandırma dosyasının yolu | +| `OPENCODE_CONFIG_DIR` | string | Yapılandırma dizinine giden yol | | `OPENCODE_CONFIG_CONTENT` | string | Satır içi JSON config içeriği | | `OPENCODE_DISABLE_AUTOUPDATE` | boolean | Otomatik güncelleme kontrollerini devre dışı bırak | | `OPENCODE_DISABLE_PRUNE` | boolean | Eski verilerin temizlenmesini devre dışı bırak | -| `OPENCODE_DISABLE_TERMINAL_TITLE` | boole | Otomatik terminal başlığı güncellemelerini devre dışı bırakın | +| `OPENCODE_DISABLE_TERMINAL_TITLE` | boolean | Otomatik terminal başlığı güncellemelerini devre dışı bırakın | | `OPENCODE_PERMISSION` | string | Satır içi JSON izin config'i | -| `OPENCODE_DISABLE_DEFAULT_PLUGINS` | boole | Varsayılan eklentileri devre dışı bırakın | -| `OPENCODE_DISABLE_LSP_DOWNLOAD` | boole | Otomatik LSP sunucu indirmelerini devre dışı bırakın | +| `OPENCODE_DISABLE_DEFAULT_PLUGINS` | boolean | Varsayılan eklentileri devre dışı bırakın | +| `OPENCODE_DISABLE_LSP_DOWNLOAD` | boolean | Otomatik LSP sunucu indirmelerini devre dışı bırakın | | `OPENCODE_ENABLE_EXPERIMENTAL_MODELS` | boolean | Deneysel modelleri etkinleştir | | `OPENCODE_DISABLE_AUTOCOMPACT` | boolean | Otomatik context sıkıştırmayı devre dışı bırak | -| `OPENCODE_DISABLE_CLAUDE_CODE` | boole | `.claude`'den okumayı devre dışı bırak (istem + beceriler) | +| `OPENCODE_DISABLE_CLAUDE_CODE` | boolean | `.claude`'den okumayı devre dışı bırak (istem + beceriler) | | `OPENCODE_DISABLE_CLAUDE_CODE_PROMPT` | boolean | `~/.claude/CLAUDE.md` dosyasını okumayı devre dışı bırak | | `OPENCODE_DISABLE_CLAUDE_CODE_SKILLS` | boolean | `.claude/skills` yüklemesini devre dışı bırak | -| `OPENCODE_DISABLE_MODELS_FETCH` | boole | Uzak kaynaklardan model getirmeyi devre dışı bırakın | -| `OPENCODE_FAKE_VCS` | dize | Test amaçlı sahte VCS sağlayıcısı | -| `OPENCODE_DISABLE_FILETIME_CHECK` | boole | Optimizasyon için dosya süresi kontrolünü devre dışı bırakın | +| `OPENCODE_DISABLE_MODELS_FETCH` | boolean | Uzak kaynaklardan model getirmeyi devre dışı bırakın | +| `OPENCODE_FAKE_VCS` | string | Test amaçlı sahte VCS sağlayıcısı | +| `OPENCODE_DISABLE_FILETIME_CHECK` | boolean | Optimizasyon için dosya süresi kontrolünü devre dışı bırakın | | `OPENCODE_CLIENT` | string | Client kimliği (varsayılan: `cli`) | | `OPENCODE_ENABLE_EXA` | boolean | Exa web arama araçlarını etkinleştir | -| `OPENCODE_SERVER_PASSWORD` | dize | `serve`/`web` için temel kimlik doğrulamayı etkinleştirin | -| `OPENCODE_SERVER_USERNAME` | dize | Temel kimlik doğrulama kullanıcı adını geçersiz kıl (varsayılan `opencode`) | -| `OPENCODE_MODELS_URL` | dize | Model yapılandırmasını almak için özel URL | +| `OPENCODE_SERVER_PASSWORD` | string | `serve`/`web` için temel kimlik doğrulamayı etkinleştirin | +| `OPENCODE_SERVER_USERNAME` | string | Temel kimlik doğrulama kullanıcı adını geçersiz kıl (varsayılan `opencode`) | +| `OPENCODE_MODELS_URL` | string | Model yapılandırmasını almak için özel URL | --- @@ -591,8 +591,8 @@ Bu ortam değişkenleri değişebilecek veya kaldırılabilecek deneysel özelli | `OPENCODE_EXPERIMENTAL` | boolean | Tüm deneysel özellikleri etkinleştir | | `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | boolean | Simge bulmayı etkinleştir | | `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | boolean | TUI'da seçim yapıldığında kopyalamayı devre dışı bırak | -| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | sayı | MS cinsinden bash komutları için varsayılan zaman aşımı | -| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | sayı | LLM yanıtları için maksimum çıktı belirteçleri | +| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | number | MS cinsinden bash komutları için varsayılan zaman aşımı | +| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | number | LLM yanıtları için maksimum çıktı belirteçleri | | `OPENCODE_EXPERIMENTAL_FILEWATCHER` | boolean | Tüm dizin için dosya izleyiciyi etkinleştir | | `OPENCODE_EXPERIMENTAL_OXFMT` | boolean | Oxfmt biçimlendiriciyi etkinleştir | | `OPENCODE_EXPERIMENTAL_LSP_TOOL` | boolean | Deneysel LSP aracını etkinleştir | diff --git a/packages/web/src/content/docs/tr/commands.mdx b/packages/web/src/content/docs/tr/commands.mdx index 38822174d..a37e98f4e 100644 --- a/packages/web/src/content/docs/tr/commands.mdx +++ b/packages/web/src/content/docs/tr/commands.mdx @@ -13,7 +13,7 @@ description: Tekrarlanan görevler için özel komutlar oluşturulur. --- -## Komut dosyaları oluşturun +## Komut dosyaları oluşturma Özel komutları tanımlamak için `commands/` dizininde işaretleme dosyaları oluşturun. @@ -40,7 +40,7 @@ Focus on the failing tests and suggest fixes. --- -## Yapılandır +## Yapılandırma opencode işlemleri aracılığıyla veya `commands/` dizininde işaretleme dosyalarının oluşturulması özel komutlar ile yapılabilir. @@ -75,7 +75,7 @@ Artık bu komutu TUI'da çalıştırabilirsiniz: --- -### İndirim +### Markdown Markdown dosyalarını kullanarak komutları da tanımlayabilirsiniz. Bunları şuraya yerleştirin: @@ -212,7 +212,7 @@ Dosya içeriği otomatik olarak istemde yer alır. --- -## Options +## Seçenekler Yapılandırma seçeneklerine ayrıntılı olarak bakalım. @@ -236,7 +236,7 @@ Bu **gerekli** bir yapılandırma seçeneğidir. --- -### Tanım +### Açıklama Komutun ne yaptığına ilişkin kısa bir açıklama sağlamak için `description` seçeneğini kullanın. @@ -312,7 +312,7 @@ Bu **isteğe bağlı** bir yapılandırma seçeneğidir. --- -## Built-in +## Yerleşik opencode, `/init`, `/undo`, `/redo`, `/share`, `/help` gibi çeşitli yerleşik komutlar içerir; [learn more](/docs/tui#commands). diff --git a/packages/web/src/content/docs/tr/config.mdx b/packages/web/src/content/docs/tr/config.mdx index a2f4ff7c4..fe60991c6 100644 --- a/packages/web/src/content/docs/tr/config.mdx +++ b/packages/web/src/content/docs/tr/config.mdx @@ -26,7 +26,7 @@ opencode hem **JSON** hem de **JSONC** (JSON Yorumlarla birlikte) formatlarını ## Konumlar Yapılandırmanızı birkaç farklı konuma yerleştirebilirsiniz ve bunların -farklı öncelik sırası. +farklı öncelik sırası vardır. :::note Yapılandırma dosyaları **birleştirilir**, değiştirilmez. @@ -34,20 +34,20 @@ Yapılandırma dosyaları **birleştirilir**, değiştirilmez. Yapılandırma dosyaları değiştirilmez, birleştirilir. Aşağıdaki yapılandırma konumlarındaki ayarlar birleştirilir. Daha sonraki yapılandırmalar, yalnızca çakışan anahtarlar için önceki yapılandırmaları geçersiz kılar. Tüm yapılandırmalardaki çakışmayan ayarlar korunur. -Örneğin, genel ayarınız `theme: "opencode"` ve `autoupdate: true`'yi ayarlıyorsa ve proje ayarlarınız `model: "anthropic/claude-sonnet-4-5"`'yi ayarlıyorsa, son tork ayarının tümünü dikkate alır. +Örneğin, genel ayarınız `theme: "opencode"` ve `autoupdate: true`'yi ayarlıyorsa ve proje ayarlarınız `model: "anthropic/claude-sonnet-4-5"`'yi ayarlıyorsa, nihai yapılandırma üç ayarı da içerecektir. --- -### Precedence order +### Öncelik sırası Yapılandırma kaynakları bu sırayla yüklenir (sonraki kaynaklar öncekileri geçersiz kılar): -1. **Uzaktan yapılandırma** (`.well-known/opencode`'dan) - kurumsal varsayılanlar -2. **Global config** (`~/.config/opencode/opencode.json`) - user preferences -3. **Custom config** (`OPENCODE_CONFIG` env var) - custom overrides -4. **Project config** (`opencode.json` in project) - project-specific settings -5. **`.opencode` dizinleri** - aracılar, komutlar, eklentiler -6. **Inline config** (`OPENCODE_CONFIG_CONTENT` env var) - runtime overrides +1. **Uzak yapılandırma** (`.well-known/opencode`'dan) - kurumsal varsayılanlar +2. **Genel yapılandırma** (`~/.config/opencode/opencode.json`) - kullanıcı tercihleri +3. **Özel yapılandırma** (`OPENCODE_CONFIG` env var) - özel geçersiz kılmalar +4. **Proje yapılandırması** (projedeki `opencode.json`) - projeye özgü ayarlar +5. **`.opencode` dizinleri** - agent'lar, komutlar, eklentiler +6. **Satır içi yapılandırma** (`OPENCODE_CONFIG_CONTENT` env var) - çalışma zamanı geçersiz kılmaları Bu, proje yapılandırmalarının genel varsayılanları geçersiz kılabileceği ve genel yapılandırmaların uzak organizasyonel varsayılanları geçersiz kılabileceği anlamına gelir. @@ -61,7 +61,7 @@ Bu, proje yapılandırmalarının genel varsayılanları geçersiz kılabileceğ Kuruluşlar, `.well-known/opencode` uç noktası aracılığıyla varsayılan yapılandırmayı sağlayabilir. Bu, onu destekleyen bir sağlayıcıyla kimlik doğrulaması yaptığınızda otomatik olarak alınır. -Remote config ilk olarak yüklenir ve temel katman görevi görür. Diğer tüm yapılandırma kaynakları (genel, proje) bu varsayılanları geçersiz kılabilir. +Uzak yapılandırma ilk olarak yüklenir ve temel katman görevi görür. Diğer tüm yapılandırma kaynakları (genel, proje) bu varsayılanları geçersiz kılabilir. Örneğin, kuruluşunuz varsayılan olarak devre dışı bırakılan MCP sunucuları sağlıyorsa: @@ -97,7 +97,7 @@ Yerel yapılandırmanızda belirli sunucuları etkinleştirebilirsiniz: Global opencode yapılandırmanızı `~/.config/opencode/opencode.json` içine yerleştirin. Temalar, sağlayıcılar veya tuş atamaları gibi kullanıcı çapındaki tercihler için genel yapılandırmayı kullanın. -Global config overrides remote organizational defaults. +Genel yapılandırma, uzak kurumsal varsayılanları geçersiz kılar. --- @@ -131,7 +131,7 @@ opencode run "Hello world" ### Özel dizin `OPENCODE_CONFIG_DIR` kullanarak özel bir yapılandırma dizini belirtin -ortam değişkeni. Bu dizin aracılar, komutlar için aranacaktır. +ortam değişkeni. Bu dizin agent'lar, komutlar için aranacaktır. modlar ve eklentiler tıpkı standart `.opencode` dizini gibi olmalıdır ve aynı yapıyı takip edin. @@ -144,7 +144,7 @@ opencode run "Hello world" --- -## Schema +## Şema Yapılandırma dosyası [**`opencode.ai/config.json`**](https://opencode.ai/config.json)'da tanımlanan bir şemaya sahiptir. @@ -268,7 +268,7 @@ Ayrıca [local models](/docs/models#local) ayarlayabilirsiniz. [Daha fazla bilgi Bazı sağlayıcılar genel `timeout` ve `apiKey` ayarlarının ötesinde ek yapılandırma seçeneklerini destekler. -##### Amazon Ana Kayası +##### Amazon Bedrock Amazon Bedrock, AWS'a özgü yapılandırmayı destekler: @@ -314,9 +314,9 @@ opencode yapılandırmanızda kullanmak istediğiniz temayı `theme` seçeneği --- -### Temsilciler +### Agent'lar -`agent` seçeneği aracılığıyla özel görevlere yönelik özel aracıları yapılandırabilirsiniz. +`agent` seçeneği aracılığıyla özel görevlere yönelik özel agent'ları yapılandırabilirsiniz. ```jsonc title="opencode.jsonc" { @@ -330,6 +330,7 @@ opencode yapılandırmanızda kullanmak istediğiniz temayı `theme` seçeneği // Disable file modification tools for review-only agent "write": false, "edit": false, + "bash": true, }, }, }, @@ -340,9 +341,9 @@ Agent'ları `~/.config/opencode/agents/` veya `.opencode/agents/` içindeki Mark --- -### Varsayılan temsilci +### Varsayılan agent -`default_agent` seçeneğini kullanarak varsayılan aracıyı ayarlayabilirsiniz. Bu, hiçbiri açıkça belirtilmediğinde hangi aracının kullanılacağını belirler. +`default_agent` seçeneğini kullanarak varsayılan agent'ı ayarlayabilirsiniz. Bu, hiçbiri açıkça belirtilmediğinde hangi agent'ın kullanılacağını belirler. ```json title="opencode.json" { @@ -351,7 +352,7 @@ Agent'ları `~/.config/opencode/agents/` veya `.opencode/agents/` içindeki Mark } ``` -Varsayılan aracı, birincil aracı olmalıdır (alt aracı değil). Bu, `"build"` veya `"plan"` gibi yerleşik bir aracı ya da tanımladığınız bir [custom agent](/docs/agents) olabilir. Belirtilen aracı mevcut değilse veya bir alt aracı ise, opencode bir uyarıyla birlikte `"build"`'ye geri döner. +Varsayılan agent, birincil agent olmalıdır (alt agent değil). Bu, `"build"` veya `"plan"` gibi yerleşik bir agent ya da tanımladığınız bir [özel agent](/docs/agents) olabilir. Belirtilen agent mevcut değilse veya bir alt agent ise, opencode bir uyarıyla birlikte `"build"`'ye geri döner. Bu ayar tüm arayüzler için geçerlidir: TUI, CLI (`opencode run`), masaüstü uygulaması ve GitHub Action. @@ -359,7 +360,7 @@ Bu ayar tüm arayüzler için geçerlidir: TUI, CLI (`opencode run`), masaüstü ### Paylaşma -[share](/docs/share) özelliği `share` seçeneğini aracılığıyla yapılandırabilirsiniz. +[share](/docs/share) özelliğini `share` seçeneği aracılığıyla yapılandırabilirsiniz. ```json title="opencode.json" { @@ -374,7 +375,7 @@ Bu şunları gerektirir: - `"auto"` - Yeni konuşmaları otomatik olarak paylaş - `"disabled"` - Paylaşımı tamamen devre dışı bırak -Varsayılan olarak paylaşım, `/share` yoğunluğu kullanılarak konuşmaları açıkça paylaşmanız gereken manuel moda ayarlanmıştır. +Varsayılan olarak paylaşım, `/share` komutunu kullanarak konuşmaları açıkça paylaşmanız gereken manuel moda ayarlanmıştır. --- @@ -404,7 +405,7 @@ Komutları `~/.config/opencode/commands/` veya `.opencode/commands/` içindeki M --- -### Tuş bağlantıları +### Tuş atamaları Tuş atamalarınızı `keybinds` seçeneği aracılığıyla özelleştirebilirsiniz. @@ -419,7 +420,7 @@ Tuş atamalarınızı `keybinds` seçeneği aracılığıyla özelleştirebilirs --- -### Autoupdate +### Otomatik Güncelleme opencode başlatıldığında yeni güncellemeleri otomatik olarak indirecektir. Bunu `autoupdate` seçeneğiyle devre dışı bırakabilirsiniz. @@ -461,7 +462,7 @@ Kod formatlayıcılarını `formatter` seçeneği aracılığıyla yapılandıra --- -### Permissions +### İzinler Varsayılan olarak, opencode açık bir onay gerektirmeden **tüm işlemlere izin verir**. `permission` seçeneğini kullanarak bunu değiştirebilirsiniz. @@ -500,7 +501,7 @@ Bağlam sıkıştırma davranışını `compaction` seçeneği aracılığıyla --- -### Watcher +### İzleyici Dosya izleyicinin yok sayma kalıplarını `watcher` seçeneği aracılığıyla yapılandırabilirsiniz. @@ -532,9 +533,9 @@ Kullanmak istediğiniz MCP sunucularını `mcp` seçeneği aracılığıyla yap --- -### Plugins +### Eklentiler -[Plugins](/docs/plugins) opencode'u özel araçlar, kancalar ve entegrasyonlarla genişletin. +[Eklentiler](/docs/plugins) opencode'u özel araçlar, kancalar ve entegrasyonlarla genişletin. Eklenti dosyalarını `.opencode/plugins/` veya `~/.config/opencode/plugins/` içine yerleştirin. Ayrıca eklentileri `plugin` seçeneği aracılığıyla npm'den de yükleyebilirsiniz. @@ -560,12 +561,11 @@ Kullandığınız modele ilişkin talimatları `instructions` seçeneği aracıl } ``` -Bu, talimat dosyalarına giden bir dizi yolu ve glob desenini alır. [Daha fazla bilgi edin -kurallar hakkında burada](/docs/rules). +Bu, talimat dosyalarına giden bir dizi yolu ve glob desenini alır. [Kurallar hakkında daha fazla bilgiyi buradan edinin](/docs/rules). --- -### Disabled providers +### Devre dışı bırakılan sağlayıcılar `disabled_providers` seçeneği aracılığıyla otomatik olarak yüklenen sağlayıcıları devre dışı bırakabilirsiniz. Bu, belirli sağlayıcıların kimlik bilgileri mevcut olsa bile yüklenmesini engellemek istediğinizde kullanışlıdır. @@ -582,7 +582,7 @@ kurallar hakkında burada](/docs/rules). `disabled_providers` seçeneği bir dizi sağlayıcı kimliğini kabul eder. Bir sağlayıcı devre dışı bırakıldığında: -- It won't be loaded even if environment variables are set. +- Ortam değişkenleri ayarlanmış olsa bile yüklenmez. - API anahtarları `/connect` komutu aracılığıyla yapılandırılsa bile yüklenmeyecektir. - Sağlayıcının modelleri, model seçim listesinde görünmez. @@ -609,7 +609,7 @@ Bir sağlayıcı hem `enabled_providers` hem de `disabled_providers`'de görün --- -### Experimental +### Deneysel `experimental` anahtarı aktif olarak geliştirilmekte olan seçenekleri içerir. @@ -621,7 +621,7 @@ Bir sağlayıcı hem `enabled_providers` hem de `disabled_providers`'de görün ``` :::caution -Experimental options are not stable. They may change or be removed without notice. +Deneysel seçenekler kararlı değildir. Bildirim yapılmaksızın değişebilir veya kaldırılabilirler. ::: --- @@ -632,7 +632,7 @@ Ortam değişkenlerine ve dosya içeriklerine referans vermek için yapılandır --- -### Env vars +### Ortam değişkenleri Ortam değişkenlerini değiştirmek için `{env:VARIABLE_NAME}` kullanın: diff --git a/packages/web/src/content/docs/tr/custom-tools.mdx b/packages/web/src/content/docs/tr/custom-tools.mdx index 6f8e987fd..cb6a12deb 100644 --- a/packages/web/src/content/docs/tr/custom-tools.mdx +++ b/packages/web/src/content/docs/tr/custom-tools.mdx @@ -7,7 +7,7 @@ description: LLM'un opencode'da çağırabileceği araçları birleştirebilir. --- -## Creating a tool +## Araç oluşturma Araçlar **TypeScript** veya **JavaScript** dosyaları olarak tanımlanır. Ancak araç tanımı **herhangi bir dilde** yazılmış komut dosyalarını çağırabilir; TypeScript veya JavaScript yalnızca araç tanımının kendisi için kullanılır. @@ -22,7 +22,7 @@ Bunlar tanımlanabilir: --- -### Structure +### Yapı Araç oluşturmanın en kolay yolu, tür güvenliği ve doğrulama sağlayan `tool()` yardımcısını kullanmaktır. @@ -79,7 +79,7 @@ Bu iki araç oluşturur: `math_add` ve `math_multiply`. --- -### Arguments +### Argümanlar Bağımsız değişken türlerini tanımlamak için yalnızca [Zod](https://zod.dev) olan `tool.schema` öğesini kullanabilirsiniz. @@ -131,9 +131,9 @@ Git çalışma ağacı kökü için `context.worktree` kullanın. --- -## Examples +## Örnekler -### Write a tool in Python +### Python ile araç yazma Araçlarınızı dilediğiniz dilde yazabilirsiniz. İşte Python kullanarak iki sayıyı toplayan bir örnek. diff --git a/packages/web/src/content/docs/tr/ecosystem.mdx b/packages/web/src/content/docs/tr/ecosystem.mdx index 5c9624a0e..835d9ba89 100644 --- a/packages/web/src/content/docs/tr/ecosystem.mdx +++ b/packages/web/src/content/docs/tr/ecosystem.mdx @@ -13,7 +13,7 @@ Ayrıca ekosistemi ve topluluğu bir araya getiren bir topluluk olan [awesome-op --- -## Plugins +## Eklentiler | İsim | Açıklama | | --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | @@ -68,7 +68,7 @@ Ayrıca ekosistemi ve topluluğu bir araya getiren bir topluluk olan [awesome-op --- -## Agents +## Agent'lar | İsim | Açıklama | | ----------------------------------------------------------------- | --------------------------------------------------------------------------- | diff --git a/packages/web/src/content/docs/tr/enterprise.mdx b/packages/web/src/content/docs/tr/enterprise.mdx index e8f6ea766..af2a0360b 100644 --- a/packages/web/src/content/docs/tr/enterprise.mdx +++ b/packages/web/src/content/docs/tr/enterprise.mdx @@ -1,6 +1,6 @@ --- -title: Girişim -description: opencode'u kısıtlamanızda güvenli bir şekilde kullanma. +title: Kurumsal +description: opencode'u kuruluşunuzda güvenli bir şekilde kullanma. --- import config from "../../../../config.mjs" @@ -19,9 +19,9 @@ opencode Enterprise'ı kullanmaya başlamak için: --- -## Trial +## Deneme -opencode açık kaynaktır ve herhangi bir kodunuzu veya içerik verilerinizi saklamaz; böylece geliştiricileriniz [get started](/docs/) yapıp bir deneme gerçekleştirebilir. +opencode açık kaynaktır ve herhangi bir kodunuzu veya içerik verilerinizi saklamaz; böylece geliştiricileriniz [hemen başlayıp](/docs/) bir deneme gerçekleştirebilir. --- @@ -36,7 +36,7 @@ saklama alanının tek izolasyonuna bağlı `/share` özelliğidir. --- -#### Sharing conversations +#### Konuşmaları paylaşma Bir kullanıcı `/share` özelliğini etkinleştirirse, görüşme ve onunla ilişkili veriler, bu paylaşım sayfalarını opencode.ai'de barındırmak için kullandığımız hizmete gönderilir. @@ -61,9 +61,9 @@ Deneme süreniz için bunu devre dışı bırakmanızı öneririz. --- -## Pricing +## Fiyatlandırma -opencode Enterprise için bilgisayar başına model kullanıyoruz. Kendi LLM ağ geçidiniz varsa, kullanılan jetonlar için ücret talep etmiyoruz. Fiyatlandırma ve uygulama seçenekleri hakkında daha fazla ayrıntı için **bize ulaşın**. +opencode Enterprise için koltuk başına model kullanıyoruz. Kendi LLM ağ geçidiniz varsa, kullanılan token'lar için ücret talep etmiyoruz. Fiyatlandırma ve uygulama seçenekleri hakkında daha fazla ayrıntı için **bize ulaşın**. --- @@ -75,7 +75,7 @@ fiyatlandırma ve uygulama seçenekleri. --- -### Central Config +### Merkezi Yapılandırma opencode'u tüm organizasyonunuz için tek bir merkezi yapılandırma kullanacak şekilde ayarlayabiliriz. @@ -91,7 +91,7 @@ Bu, opencode'un mevcut kimlik yönetimi sisteminiz aracılığıyla dahili AI a --- -### Internal AI gateway +### Dahili AI ağ geçidi Merkezi yapılandırmayla opencode yalnızca dahili AI ağ geçidinizi kullanacak şekilde de yapılandırılabilir. @@ -108,17 +108,17 @@ Bu şu anda yol haritamızda yer alıyor. İlgileniyorsanız **b --- -## FAQ +## SSS
-What is opencode Enterprise? +opencode Enterprise nedir? opencode Enterprise, kodlarının ve verilerinin altyapılarından asla ayrılmamasını sağlamak isteyen kuruluşlar içindir. Bunu, SSO ve dahili AI ağ geçidinizle entegre olan merkezi bir yapılandırma kullanarak yapabilir.
-How do I get started with opencode Enterprise? +opencode Enterprise'a nasıl başlarım? Ekibinizle dahili bir denemeyle başlayın. opencode varsayılan olarak kodunuzu veya içerik verilerinizi saklamaz, bu da başlamayı kolaylaştırır. @@ -127,21 +127,21 @@ Daha sonra fiyatlandırma ve uygulama seçeneklerini görüşmek için **
-How does enterprise pricing work? +Kurumsal fiyatlandırma nasıl çalışır? -Koltuk başına kurumsal fiyatlandırma sunuyoruz. Kendi LLM ağ geçidiniz varsa, kullanılan jetonlar için ücret talep etmiyoruz. Daha fazla ayrıntı için kuruluşunuzun ihtiyaçlarına göre özel bir fiyat teklifi almak üzere **bize ulaşın**. +Koltuk başına kurumsal fiyatlandırma sunuyoruz. Kendi LLM ağ geçidiniz varsa, kullanılan token'lar için ücret talep etmiyoruz. Daha fazla ayrıntı için kuruluşunuzun ihtiyaçlarına göre özel bir fiyat teklifi almak üzere **bize ulaşın**.
-Is my data secure with opencode Enterprise? +Verilerim opencode Enterprise ile güvende mi? Evet. opencode kodunuzu veya içerik verilerinizi saklamaz. Tüm işlemler yerel olarak veya AI sağlayıcınıza doğrudan API çağrıları yoluyla gerçekleşir. Merkezi yapılandırma ve SSO entegrasyonuyla verileriniz kuruluşunuzun altyapısında güvende kalır.
-Can we use our own private NPM registry? +Kendi özel NPM kayıt defterimizi kullanabilir miyiz? opencode, Bun'un yerel `.npmrc` dosya desteği aracılığıyla özel npm kayıtlarını destekler. Kuruluşunuz JFrog Artifactory, Nexus veya benzeri gibi özel bir kayıt defteri kullanıyorsa, opencode'u çalıştırmadan önce geliştiricilerin kimlik doğrulamasının yapıldığından emin olun. @@ -152,7 +152,7 @@ npm login --registry=https://your-company.jfrog.io/api/npm/npm-virtual/ ``` Bu, kimlik doğrulama ayrıntılarını içeren `~/.npmrc` öğesini oluşturur. opencode otomatik olarak -şunu al. +bunu alır. :::caution opencode'u çalıştırmadan önce özel kayıt defterinde oturum açmalısınız. diff --git a/packages/web/src/content/docs/tr/formatters.mdx b/packages/web/src/content/docs/tr/formatters.mdx index 34dc3b46d..b6db406e1 100644 --- a/packages/web/src/content/docs/tr/formatters.mdx +++ b/packages/web/src/content/docs/tr/formatters.mdx @@ -7,38 +7,38 @@ opencode, dosyaları dile özgü formatlayıcılar kullanılarak yazıldıktan v --- -## Built-in +## Yerleşik opencode, popüler diller ve çerçeveler için çeşitli yerleşik biçimlendiricilerle birlikte gelir. Aşağıda ihtiyaç duyduğu biçimlendiricilerin, desteklenen dosya uzantılarının ve komutların veya yapılandırma seçeneklerinin bir listesi bulunmaktadır. -| Formatter | Extensions | Requirements | -| -------------------- | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | -| gofmt | .go | `gofmt` komutu mevcut | -| mix | .ex, .exs, .eex, .heex, .leex, .neex, .sface | `mix` komutu mevcut | -| prettier | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml ve [more](https://prettier.io/docs/en/index.html) | `package.json` içinde `prettier` bağımlılığı | -| biome | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml ve [more](https://biomejs.dev/) | `biome.json(c)` yapılandırma dosyası | -| zig | .zig, .zon | `zig` komutu mevcut | -| clang-format | .c, .cpp, .h, .hpp, .ino ve [more](https://clang.llvm.org/docs/ClangFormat.html) | `.clang-format` yapılandırma dosyası | -| ktlint | .kt, .kts | `ktlint` komutu mevcut | -| ruff | .py, .pyi | `ruff` komutu yapılandırmayla kullanılabilir | -| rustfmt | .rs | `rustfmt` komutu mevcut | -| cargofmt | .rs | `cargo fmt` komutu mevcut | -| uv | .py, .pyi | `uv` komutu mevcut | -| rubocop | .rb, .rake, .gemspec, .ru | `rubocop` komutu mevcut | -| standardrb | .rb, .rake, .gemspec, .ru | `standardrb` komutu mevcut | -| htmlbeautifier | .erb, .html.erb | `htmlbeautifier` komutu mevcut | -| air | .R | `air` komutu mevcut | -| dart | .dart | `dart` komutu mevcut | -| ocamlformat | .ml, .mli | `ocamlformat` komutu mevcut ve `.ocamlformat` yapılandırma dosyası | -| terraform | .tf, .tfvars | `terraform` komutu mevcut | -| gleam | .gleam | `gleam` komutu mevcut | -| nixfmt | .nix | `nixfmt` komutu mevcut | -| shfmt | .sh, .bash | `shfmt` komutu mevcut | -| pint | .php | `composer.json` içinde `laravel/pint` bağımlılığı | -| oxfmt (Experimental) | .js, .jsx, .ts, .tsx | `package.json` içinde `oxfmt` bağımlılığı ve [experimental env variable flag](/docs/cli/#experimental) | -| ormolu | .hs | `ormolu` komutu mevcut | +| Biçimlendirici | Uzantılar | Gereksinimler | +| ---------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | +| gofmt | .go | `gofmt` komutu mevcut | +| mix | .ex, .exs, .eex, .heex, .leex, .neex, .sface | `mix` komutu mevcut | +| prettier | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml ve [daha fazla](https://prettier.io/docs/en/index.html) | `package.json` içinde `prettier` bağımlılığı | +| biome | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml ve [daha fazla](https://biomejs.dev/) | `biome.json(c)` yapılandırma dosyası | +| zig | .zig, .zon | `zig` komutu mevcut | +| clang-format | .c, .cpp, .h, .hpp, .ino ve [daha fazla](https://clang.llvm.org/docs/ClangFormat.html) | `.clang-format` yapılandırma dosyası | +| ktlint | .kt, .kts | `ktlint` komutu mevcut | +| ruff | .py, .pyi | `ruff` komutu yapılandırmayla kullanılabilir | +| rustfmt | .rs | `rustfmt` komutu mevcut | +| cargofmt | .rs | `cargo fmt` komutu mevcut | +| uv | .py, .pyi | `uv` komutu mevcut | +| rubocop | .rb, .rake, .gemspec, .ru | `rubocop` komutu mevcut | +| standardrb | .rb, .rake, .gemspec, .ru | `standardrb` komutu mevcut | +| htmlbeautifier | .erb, .html.erb | `htmlbeautifier` komutu mevcut | +| air | .R | `air` komutu mevcut | +| dart | .dart | `dart` komutu mevcut | +| ocamlformat | .ml, .mli | `ocamlformat` komutu mevcut ve `.ocamlformat` yapılandırma dosyası | +| terraform | .tf, .tfvars | `terraform` komutu mevcut | +| gleam | .gleam | `gleam` komutu mevcut | +| nixfmt | .nix | `nixfmt` komutu mevcut | +| shfmt | .sh, .bash | `shfmt` komutu mevcut | +| pint | .php | `composer.json` içinde `laravel/pint` bağımlılığı | +| oxfmt (Deneysel) | .js, .jsx, .ts, .tsx | `package.json` içinde `oxfmt` bağımlılığı ve [experimental env variable flag](/docs/cli/#experimental) | +| ormolu | .hs | `ormolu` komutu mevcut | -Yani eğer projenizin `prettier` dosyasında `package.json` varsa, opencode bunu otomatik olarak kullanacaktır. +Yani eğer projenizin `package.json` dosyasında `prettier` varsa, opencode bunu otomatik olarak kullanacaktır. --- @@ -54,7 +54,7 @@ Bu işlem arka planda gerçekleşir ve kod stillerinizin herhangi bir manuel ad --- -## Yapılandır +## Yapılandırma Biçimlendiricileri opencode yapılandırmanızdaki `formatter` bölümü aracılığıyla özelleştirebilirsiniz. @@ -67,7 +67,7 @@ Biçimlendiricileri opencode yapılandırmanızdaki `formatter` bölümü aracı Her formatlayıcı yapılandırması aşağıdakileri destekler: -| Property | Type | Açıklama | +| Özellik | Tip | Açıklama | | ------------- | -------- | ---------------------------------------------------------------------- | | `disabled` | boolean | Biçimlendiriciyi devre dışı bırakmak için bunu `true` olarak ayarlayın | | `command` | string[] | Biçimlendirme için çalıştırılacak komut | diff --git a/packages/web/src/content/docs/tr/github.mdx b/packages/web/src/content/docs/tr/github.mdx index e9db5f15d..8a5ea203f 100644 --- a/packages/web/src/content/docs/tr/github.mdx +++ b/packages/web/src/content/docs/tr/github.mdx @@ -7,7 +7,7 @@ opencode, GitHub iş akışınızla bütünleşir. Yorumunuzda `/opencode` veya --- -## Features +## Özellikler - **Sorunları önceliklendirin**: opencode'dan bir sorunu araştırıp size açıklamasını isteyin. - **Düzelt ve uygula**: opencode'dan bir sorunu düzeltmesini veya bir özelliği uygulamasını isteyin. Ve yeni bir şubede çalışacak ve tüm değişiklikleri içeren bir PR gönderecek. @@ -27,7 +27,7 @@ Bu size GitHub uygulamasını yükleme, iş akışını oluşturma ve gizli dizi --- -### Manual Setup +### Manuel Kurulum Veya manuel olarak ayarlayabilirsiniz. @@ -101,11 +101,11 @@ Veya manuel olarak ayarlayabilirsiniz. --- -## Supported Events +## Desteklenen Olaylar opencode aşağıdaki GitHub olayları tarafından tetiklenebilir: -| Event Type | Triggered By | Details | +| Olay Tipi | Tetikleyen | Detaylar | | ----------------------------- | --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | `issue_comment` | Bir soruna veya halkla ilişkilere yorum yapın | Yorumunuzda `/opencode` veya `/oc`'den bahsedin. opencode bağlamı okur ve şubeler oluşturabilir, PR'leri açabilir veya yanıt verebilir. | | `pull_request_review_comment` | PR'deki belirli kod satırlarına yorum yapın | Kodu incelerken `/opencode` veya `/oc`'den bahsedin. opencode dosya yolunu, satır numaralarını ve fark içeriğini alır. | @@ -114,7 +114,7 @@ opencode aşağıdaki GitHub olayları tarafından tetiklenebilir: | `schedule` | Cron tabanlı program | opencode'u bir programa göre çalıştırın. `prompt` girişi gerektirir. Çıktı, günlüklere ve PR'lere gider (yorum yapılacak bir sorun yoktur). | | `workflow_dispatch` | GitHub kullanıcı arayüzünden manuel tetikleme | Eylemler sekmesi aracılığıyla opencode'u isteğe bağlı olarak tetikleyin. `prompt` girişi gerektirir. Çıktı günlüklere ve PR'lere gider. | -### Schedule Example +### Zamanlama Örneği Otomatik görevleri gerçekleştirmek için opencode'u bir zamanlamaya göre çalıştırın: @@ -195,7 +195,7 @@ jobs: --- -### Issues Triage Example +### Sorun Önceliklendirme Örneği Yeni sorunları otomatik olarak önceliklendirin. Bu örnek, spam'i azaltmak için 30 günden eski hesapları filtreler: @@ -269,11 +269,11 @@ Bu, projenizle ilgili spesifik inceleme kriterlerini, kodlama standartlarını v --- -## Examples +## Örnekler GitHub'da opencode'u nasıl kullanabileceğinize dair bazı örnekleri burada bulabilirsiniz. -- **Explain an issue** +- **Bir sorunu açıklama** Bu yorumu GitHub sayısına ekleyin. @@ -283,7 +283,7 @@ GitHub'da opencode'u nasıl kullanabileceğinize dair bazı örnekleri burada bu opencode, tüm yorumlar da dahil olmak üzere ileti dizisinin tamamını okuyacak ve net bir açıklama ile yanıt verecektir. -- **Fix an issue** +- **Bir sorunu düzeltme** In a GitHub issue, say: @@ -303,7 +303,7 @@ GitHub'da opencode'u nasıl kullanabileceğinize dair bazı örnekleri burada bu opencode istenen değişikliği uygulayacak ve aynı PR'ye uygulayacaktır. -- **Review specific code lines** +- **Belirli kod satırlarını inceleme** PR'nin "Dosyalar" sekmesindeki kod satırlarına doğrudan yorum bırakın. opencode, kesin yanıtlar sağlamak için dosyayı, satır numaralarını ve fark içeriğini otomatik olarak algılar. @@ -312,10 +312,10 @@ GitHub'da opencode'u nasıl kullanabileceğinize dair bazı örnekleri burada bu /oc add error handling here ``` - When commenting on specific lines, opencode receives: + Belirli satırlara yorum yaparken opencode şunları alır: - İncelenmekte olan dosyanın tamamı - Belirli kod satırları - Çevreleyen fark bağlamı - - Line number information + - Satır numarası bilgisi Bu, dosya yollarını veya satır numaralarını manuel olarak belirtmeye gerek kalmadan daha hedefli isteklere olanak tanır. diff --git a/packages/web/src/content/docs/tr/gitlab.mdx b/packages/web/src/content/docs/tr/gitlab.mdx index 5d1d859af..23f15c682 100644 --- a/packages/web/src/content/docs/tr/gitlab.mdx +++ b/packages/web/src/content/docs/tr/gitlab.mdx @@ -1,9 +1,9 @@ --- title: GitLab -description: GitLab sorunlarında ve parçalanma isteğinde opencode'u kullanın. +description: GitLab sorunlarında ve birleştirme isteklerinde opencode'u kullanın. --- -opencode, GitLab CI/CD ardışık düzeniniz veya GitLab Duo aracılığıyla GitLab iş akışınızla bütünleşir. +opencode, GitLab CI/CD işlem hattınız veya GitLab Duo aracılığıyla GitLab iş akışınızla bütünleşir. Her iki durumda da opencode, GitLab çalıştırıcılarınızda çalışacaktır. @@ -11,7 +11,7 @@ Her iki durumda da opencode, GitLab çalıştırıcılarınızda çalışacaktı ## GitLab CI -opencode normal bir GitLab hattında çalışır. Bunu bir [CI component](https://docs.gitlab.com/ee/ci/components/) olarak bir boru hattına oluşturabilirsiniz. +opencode normal bir GitLab işlem hattında çalışır. Bunu bir [CI component](https://docs.gitlab.com/ee/ci/components/) olarak bir işlem hattına oluşturabilirsiniz. Burada opencode için topluluk tarafından oluşturulan bir CI/CD bileşeni kullanıyoruz — [nagyv/gitlab-opencode](https://gitlab.com/nagyv/gitlab-opencode). @@ -25,7 +25,7 @@ Burada opencode için topluluk tarafından oluşturulan bir CI/CD bileşeni kull --- -### Setup +### Kurulum 1. opencode kimlik doğrulamanızı JSON **Ayarlar** > **CI/CD** > **Değişkenler** altında Dosya türü CI ortam değişkenleri olarak saklayın. Bunları "Maskeli ve gizli" olarak işaretlediğinizden emin olun. 2. Aşağıdakileri `.gitlab-ci.yml` dosyanıza ekleyin. @@ -51,16 +51,16 @@ Bir yorumda `@opencode`'dan bahsedin; opencode, GitLab CI işlem hattınızdaki --- -### Features +### Özellikler - **Sorunları önceliklendirin**: opencode'dan bir sorunu araştırıp size açıklamasını isteyin. - **Düzelt ve uygula**: opencode'dan bir sorunu düzeltmesini veya bir özelliği uygulamasını isteyin. - Yeni bir şube oluşturacak ve değişikliklerle birlikte bir birleştirme isteği oluşturacaktır. + Yeni bir dal oluşturacak ve değişikliklerle birlikte bir birleştirme isteği oluşturacaktır. - **Güvenli**: opencode, GitLab çalıştırıcılarınızda çalışır. --- -### Kurmak +### Yapılandırma opencode, GitLab CI/CD işlem hattınızda çalışır; bunu ayarlamak için ihtiyacınız olacaklar: @@ -75,7 +75,7 @@ Güncel talimatlar için [**GitLab docs**](https://docs.gitlab.com/user/duo_agen 5. CI/CD değişkenlerini yapılandırma 6. Bir akış yapılandırma dosyası oluşturun; işte bir örnek: - +
Akış yapılandırması @@ -150,13 +150,13 @@ Güncel talimatlar için [**GitLab docs**](https://docs.gitlab.com/user/duo_agen - GITLAB_HOST ``` - +
Ayrıntılı talimatlar için [GitLab CLI agents docs](https://docs.gitlab.com/user/duo_agent_platform/agent_assistant/)'a başvurabilirsiniz. --- -### Examples +### Örnekler GitLab'da opencode'u nasıl kullanabileceğinize dair bazı örnekleri burada bulabilirsiniz. @@ -164,7 +164,7 @@ GitLab'da opencode'u nasıl kullanabileceğinize dair bazı örnekleri burada bu `@opencode`'dan farklı bir tetikleyici ifade kullanacak şekilde yapılandırabilirsiniz. ::: -- **Explain an issue** +- **Bir sorunu açıklama** Bu yorumu bir GitLab sayısına ekleyin. @@ -174,7 +174,7 @@ GitLab'da opencode'u nasıl kullanabileceğinize dair bazı örnekleri burada bu opencode konuyu okuyacak ve net bir açıklama ile yanıt verecektir. -- **Fix an issue** +- **Bir sorunu düzeltme** In a GitLab issue, say: @@ -182,9 +182,9 @@ GitLab'da opencode'u nasıl kullanabileceğinize dair bazı örnekleri burada bu @opencode fix this ``` - opencode yeni bir şube oluşturacak, değişiklikleri uygulayacak ve değişiklikleri içeren bir birleştirme isteği açacaktır. + opencode yeni bir dal oluşturacak, değişiklikleri uygulayacak ve değişiklikleri içeren bir birleştirme isteği açacaktır. -- **Review merge requests** +- **Birleştirme isteklerini inceleme** GitLab birleştirme isteğine aşağıdaki yorumu bırakın. diff --git a/packages/web/src/content/docs/tr/index.mdx b/packages/web/src/content/docs/tr/index.mdx index 525471995..7c31f5bd3 100644 --- a/packages/web/src/content/docs/tr/index.mdx +++ b/packages/web/src/content/docs/tr/index.mdx @@ -1,17 +1,17 @@ --- title: Giriş -description: opencode'u kullanmaya başlayın. +description: opencode kullanmaya başlayın. --- import { Tabs, TabItem } from "@astrojs/starlight/components" import config from "../../../../config.mjs" export const console = config.console -[**opencode**](/) açık kaynaklı bir AI coding agent'ıdır. Terminal tabanlı bir arayüz, masaüstü uygulaması veya IDE uzantısı olarak mevcuttur. +[**opencode**](/) açık kaynaklı bir AI kodlama ajanıdır. Terminal tabanlı bir arayüz, masaüstü uygulaması veya IDE uzantısı olarak mevcuttur. ![opencode TUI with the opencode theme](../../../assets/lander/screenshot.png) -Hadi başlayalım. +Başlayalım. --- @@ -129,12 +129,12 @@ opencode'un Bun kullanılarak Windows'a yüklenmesine yönelik destek şu anda d --- -## Yapılandır +## Yapılandırma 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 team tarafından test edilmiş ve doğrulanmış modellerin seçilmiş bir listesidir. +opencode ekibi 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 [opencode.ai/auth](https://opencode.ai/auth)'ye gidin. @@ -157,7 +157,7 @@ Alternatif olarak diğer sağlayıcılardan birini seçebilirsiniz. [Daha fazla --- -## Başlat +## Başlatma Artık bir sağlayıcı yapılandırdığınıza göre, bir projeye gidebilirsiniz. üzerinde çalışmak istiyorsun. @@ -193,11 +193,11 @@ Bu, opencode'un proje yapısını ve kullanılan kodlama kalıplarını anlamas Artık projeniz üzerinde çalışmak için opencode'u kullanmaya hazırsınız. Dilediğiniz soruyu sorabilirsiniz. -AI kodlama agent'ı kullanmaya yeniyseniz aşağıdaki örnekler yardımcı olabilir. +AI kodlama ajanını kullanmaya yeniyseniz aşağıdaki örnekler yardımcı olabilir. --- -### Soru sor +### Soru Sorma opencode'dan kod tabanını size açıklamasını isteyebilirsiniz. @@ -213,18 +213,18 @@ Kod tabanının üzerinde çalışmadığınız bir kısmı varsa bu yararlı ol --- -### Özellik ekle +### Özellik Ekleme opencode'dan projenize yeni özellikler eklemesini isteyebilirsiniz. Yine de öncelikle ondan bir plan oluşturmasını istemenizi öneririz. 1. **Bir plan oluşturun** - opencode, değişiklik yapma özelliğini kapatan bir _Plan mode_'a sahiptir. + opencode, değişiklik yapma özelliğini kapatan bir \_Plan modu_na sahiptir. Bu modda, özelliğin nasıl uygulanacağını önerir. **Sekme** tuşunu kullanarak buna geçin. Bunun için sağ alt köşede bir gösterge göreceksiniz. - ```bash frame="none" title="Switch to Plan mode" + ```bash frame="none" title="Plan moduna geç" ``` @@ -243,6 +243,9 @@ opencode'dan projenize yeni özellikler eklemesini isteyebilirsiniz. Yine de ön opencode'a bol bağlam ve örnek verin. ::: + opencode verdiğiniz görselleri tarayıp prompt'a ekleyebilir. + Bunu bir görseli terminale sürükleyip bırakarak yapabilirsiniz. + 2. **Planı yineleyin** Size bir plan sunduğunda ona geri bildirimde bulunabilir veya daha fazla ayrıntı ekleyebilirsiniz. @@ -261,7 +264,7 @@ opencode'dan projenize yeni özellikler eklemesini isteyebilirsiniz. Yine de ön 3. **Özelliği oluşturun** - Planı yeterli bulduğunuzda **Sekme** tuşuna tekrar basarak _Build mode_'a dönün. + Planı yeterli bulduğunuzda **Sekme** tuşuna tekrar basarak \_Build modu_na dönün. ```bash frame="none" @@ -275,7 +278,7 @@ opencode'dan projenize yeni özellikler eklemesini isteyebilirsiniz. Yine de ön --- -### Değişiklik yap +### Değişiklik Yapma Daha basit değişikliklerde, önce planı incelemeden opencode'dan doğrudan değişiklik yapmasını isteyebilirsiniz. @@ -289,7 +292,7 @@ opencode'un doğru değişiklikleri yapması için yeterli ayrıntı verdiğiniz --- -### Değişiklikleri geri al +### Değişiklikleri Geri Alma Diyelim ki opencode'dan bazı değişiklikler yapmasını istediniz. @@ -324,7 +327,7 @@ Veya `/redo` komutunu kullanarak değişiklikleri **yeniden yapabilirsiniz**. --- -## Paylaş +## Paylaşma opencode ile yaptığınız görüşmeleri [ekibinizle paylaşabilirsiniz](/docs/share). @@ -342,8 +345,8 @@ Konuşmalar varsayılan olarak paylaşılmaz. --- -## Özelleştir +## Özelleştirme İşte bu kadar! Artık opencode'u kullanma konusunda profesyonelsiniz. -Kendinize göre uyarlamak için [tema seçebilir](/docs/themes), [keybind'leri özelleştirebilir](/docs/keybinds), [code formatter ayarlayabilir](/docs/formatters), [özel komutlar oluşturabilir](/docs/commands) veya [opencode config](/docs/config) ile oynayabilirsiniz. +Kendinize göre uyarlamak için [tema seçebilir](/docs/themes), [tuş atamalarını özelleştirebilir](/docs/keybinds), [kod biçimlendirici ayarlayabilir](/docs/formatters), [özel komutlar oluşturabilir](/docs/commands) veya [opencode config](/docs/config) ile oynayabilirsiniz. diff --git a/packages/web/src/content/docs/tr/keybinds.mdx b/packages/web/src/content/docs/tr/keybinds.mdx index b5033a584..9a22c329c 100644 --- a/packages/web/src/content/docs/tr/keybinds.mdx +++ b/packages/web/src/content/docs/tr/keybinds.mdx @@ -1,5 +1,5 @@ --- -title: Tuş bağlantıları +title: Tuş atamaları description: Tuş bağlantılarınızı özelleştirin. --- @@ -105,7 +105,7 @@ opencode, opencode yapılandırması aracılığıyla özelleştirebileceğiniz --- -## Leader key +## Leader tuşu opencode çoğu tuş ataması için `leader` anahtarını kullanır. Bu, terminalinizdeki çakışmaları önler. diff --git a/packages/web/src/content/docs/tr/lsp.mdx b/packages/web/src/content/docs/tr/lsp.mdx index 77b586c6d..db7421138 100644 --- a/packages/web/src/content/docs/tr/lsp.mdx +++ b/packages/web/src/content/docs/tr/lsp.mdx @@ -1,13 +1,13 @@ --- -title: LSP Sunucular +title: LSP Sunucuları description: opencode, LSP sunucularınızla bütünleşir. --- -opencode, LLM'nin kod tabanınızla etkileşime girmesine yardımcı olmak için Dil Sunucusu Protokolünüzle (LSP) bütünleşir. LLM'ye geri bildirim sağlamak için tanılamayı kullanır. +opencode, LLM'in kod tabanınızla etkileşime girmesine yardımcı olmak için Dil Sunucusu Protokolünüzle (LSP) bütünleşir. LLM'ye geri bildirim sağlamak için tanılamayı kullanır. --- -## Built-in +## Yerleşik opencode, popüler diller için çeşitli yerleşik LSP sunucularıyla birlikte gelir: @@ -63,7 +63,7 @@ Opencode bir dosyayı açtığında: --- -## Yapılandır +## Yapılandırma LSP sunucularını, opencode yapılandırmanızdaki `lsp` bölümü aracılığıyla özelleştirebilirsiniz. @@ -76,7 +76,7 @@ LSP sunucularını, opencode yapılandırmanızdaki `lsp` bölümü aracılığ Her LSP sunucusu aşağıdakileri destekler: -| Property | Type | Açıklama | +| Özellik | Tip | Açıklama | | ---------------- | -------- | -------------------------------------------------------------------- | | `disabled` | boolean | LSP sunucusunu devre dışı bırakmak için bunu `true` olarak ayarlayın | | `command` | string[] | LSP sunucusunu başlatma komutu | @@ -107,7 +107,7 @@ LSP sunucusunu başlatırken ortam değişkenlerini ayarlamak için `env` özell --- -### Initialization options +### Başlatma seçenekleri Başlatma seçeneklerini LSP sunucusuna iletmek için `initialization` özelliğini kullanın. Bunlar LSP `initialize` isteği sırasında gönderilen sunucuya özel ayarlardır: diff --git a/packages/web/src/content/docs/tr/mcp-servers.mdx b/packages/web/src/content/docs/tr/mcp-servers.mdx index f485a9868..0f60c5633 100644 --- a/packages/web/src/content/docs/tr/mcp-servers.mdx +++ b/packages/web/src/content/docs/tr/mcp-servers.mdx @@ -9,7 +9,7 @@ MCP araçları eklendikten sonra yerleşik araçların yanı sıra LLM tarafınd --- -#### Caveats +#### Uyarılar Bir MCP sunucusu kullandığınızda bağlama eklenir. Çok fazla aletiniz varsa, bu hızla artabilir. Bu nedenle hangi MCP sunucularını kullandığınıza dikkat etmenizi öneririz. @@ -21,7 +21,7 @@ GitHub MCP sunucusu gibi belirli MCP sunucuları çok sayıda belirteç ekleme e --- -## Olanak vermek +## Etkinleştirme MCP sunucularını [opencode Config](https://opencode.ai/docs/config/)'nizde `mcp` altında tanımlayabilirsiniz. Her MCP'ü benzersiz bir adla ekleyin. LLM isteminde bulunurken bu MCP adına başvurabilirsiniz. @@ -44,7 +44,7 @@ Ayrıca `enabled` öğesini `false` olarak ayarlayarak bir sunucuyu devre dış --- -### Overriding remote defaults +### Uzak varsayılanları geçersiz kılma Kuruluşlar, `.well-known/opencode` uç noktaları aracılığıyla varsayılan MCP sunucularını sağlayabilir. Bu sunucular varsayılan olarak devre dışı bırakılarak kullanıcıların ihtiyaç duydukları sunucuları seçmelerine olanak tanınabilir. @@ -112,7 +112,7 @@ use the mcp_everything tool to add the number 3 and 4 --- -#### Options +#### Seçenekler Yerel bir MCP sunucusunu yapılandırmak için tüm seçenekler burada verilmiştir. @@ -150,7 +150,7 @@ Yerel bir MCP sunucusunu yapılandırmak için tüm seçenekler burada verilmiş --- -#### Options +#### Seçenekler | Seçenek | Tür | Gerekli | Açıklama | | --------- | ------- | ------- | ---------------------------------------------------------------------------------------------- | @@ -173,7 +173,7 @@ opencode, uzak MCP sunucuları için OAuth kimlik doğrulamasını otomatik olar --- -### Automatic +### Otomatik OAuth'un etkin olduğu çoğu MCP sunucusu için özel bir yapılandırmaya gerek yoktur. Uzak sunucuyu yapılandırmanız yeterli: @@ -216,7 +216,7 @@ MCP sunucu sağlayıcısından istemci kimlik bilgileriniz varsa, bunları yapı --- -### Authenticating +### Kimlik doğrulama Kimlik doğrulamayı manuel olarak tetikleyebilir veya kimlik bilgilerini yönetebilirsiniz. @@ -264,7 +264,7 @@ Bir sunucu için otomatik OAuth'u devre dışı bırakmak istiyorsanız (örneğ --- -#### OAuth Options +#### OAuth Seçenekleri | Seçenek | Tür | Açıklama | | -------------- | --------------- | -------------------------------------------------------------------------------- | @@ -273,7 +273,7 @@ Bir sunucu için otomatik OAuth'u devre dışı bırakmak istiyorsanız (örneğ | `clientSecret` | Dize | Yetkilendirme sunucusu gerektiriyorsa OAuth istemci sırrı. | | `scope` | String | OAuth scopes to request during authorization. | -#### Debugging +#### Hata Ayıklama Uzak bir MCP sunucusunun kimlik doğrulaması başarısız olursa aşağıdakileri kullanarak sorunları teşhis edebilirsiniz: @@ -289,7 +289,7 @@ opencode mcp debug my-oauth-server --- -## Üstesinden gelmek +## Yönetim MCP'leriniz yerleşik araçların yanı sıra opencode'da araç olarak mevcuttur. Böylece bunları diğer araçlar gibi opencode yapılandırması aracılığıyla yönetebilirsiniz. @@ -343,7 +343,7 @@ Burada tüm MCP'leri devre dışı bırakmak için `my-mcp*` glob modelini kulla --- -### Temsilci başına +### Agent başına Çok sayıda MCP sunucunuz varsa, bunları yalnızca aracı başına etkinleştirmek ve genel olarak devre dışı bırakmak isteyebilirsiniz. Bunu yapmak için: @@ -375,7 +375,7 @@ Burada tüm MCP'leri devre dışı bırakmak için `my-mcp*` glob modelini kulla --- -#### Glob patterns +#### Glob desenleri Glob modeli, basit normal ifade globbing modellerini kullanır: @@ -433,7 +433,7 @@ Show me the latest unresolved issues in my project. use sentry --- -### Bağlam7 +### Context7 Dokumanlar arasında arama yapmak için [Context7 MCP server](https://github.com/upstash/context7) ekleyin. diff --git a/packages/web/src/content/docs/tr/models.mdx b/packages/web/src/content/docs/tr/models.mdx index 2f25bcceb..45df6e3ff 100644 --- a/packages/web/src/content/docs/tr/models.mdx +++ b/packages/web/src/content/docs/tr/models.mdx @@ -15,7 +15,7 @@ opencode, **75+ LLM sağlayıcısını** desteklemek için [AI SDK](https://ai-s --- -## Bir model seçin +## Model seçimi Sağlayıcınızı yapılandırdıktan sonra aşağıdaki komutu yazarak istediğiniz modeli seçebilirsiniz: @@ -46,7 +46,7 @@ Burada, opencode ile belirli bir sıraya göre iyi çalışan birkaç model yer --- -## Varsayılanı ayarla +## Varsayılan ayarlama Bunlardan birini varsayılan model olarak ayarlamak için `model` anahtarınızı telefonunuzudan ayarlayabilirsiniz. opencode yapılandırması @@ -64,7 +64,7 @@ Bir [custom provider](/docs/providers#custom) yapılandırılmışsa, `provider_ --- -## Modelleri yapılandırın +## Model yapılandırma Bir modelin seçeneklerini genel olarak yapılandırma aracılığıyla yapılandırabilirsiniz. @@ -201,7 +201,7 @@ Mevcut varyantları geçersiz kılabilir veya kendinizinkini ekleyebilirsiniz: --- -## Loading models +## Modelleri yükleme opencode başlatıldığında modelleri aşağıdaki öncelik sırasına göre kontrol eder: diff --git a/packages/web/src/content/docs/tr/modes.mdx b/packages/web/src/content/docs/tr/modes.mdx index fb16c35fb..b8dfc838e 100644 --- a/packages/web/src/content/docs/tr/modes.mdx +++ b/packages/web/src/content/docs/tr/modes.mdx @@ -17,13 +17,13 @@ Bir oturum sırasında modlar arasında geçiş yapabilir veya bunları yapılan --- -## Built-in +## Yerleşik opencode iki yerleşik modla birlikte gelir. --- -### İnşa etmek +### Build Derleme, tüm araçların etkin olduğu **varsayılan** moddur. Bu, dosya işlemlerine ve sistem komutlarına tam erişime ihtiyaç duyduğunuz geliştirme çalışmaları için standart moddur. @@ -35,14 +35,14 @@ Planlama ve analiz için tasarlanmış sınırlı bir mod. Plan modunda aşağı - `write` - Yeni dosyalar oluşturulamıyor - `edit` - Planın kendisini detaylandırmak için `.opencode/plans/*.md` adresinde bulunan dosyalar dışında mevcut dosyalar değiştirilemez -- `patch` - Cannot apply patches +- `patch` - Yamalar uygulanamaz - `bash` - Kabuk komutları yürütülemiyor Bu mod, yapay zekanın kod tabanınızda herhangi bir gerçek değişiklik yapmadan kodu analiz etmesini, değişiklik önermesini veya plan oluşturmasını istediğinizde kullanışlıdır. --- -## Anahtarlama +## Geçiş Bir oturum sırasında _Tab_ tuşunu kullanarak modlar arasında geçiş yapabilirsiniz. Veya yapılandırılmış `switch_mode` tuş bağlantınız. @@ -50,11 +50,11 @@ Ayrıca bkz.: Kod biçimlendirme yapılandırması hakkında bilgi için [Format --- -## Yapılandır +## Yapılandırma Yerleşik modları özelleştirebilir veya yapılandırma aracılığıyla kendinizinkini oluşturabilirsiniz. Modlar iki şekilde yapılandırılabilir: -### JSON Configuration +### JSON Yapılandırması `opencode.json` yapılandırma dosyanızdaki modları yapılandırın: @@ -83,7 +83,7 @@ Yerleşik modları özelleştirebilir veya yapılandırma aracılığıyla kendi } ``` -### Markdown Configuration +### Markdown Yapılandırması Markdown dosyalarını kullanarak modları da tanımlayabilirsiniz. Bunları şuraya yerleştirin: @@ -112,13 +112,13 @@ Provide constructive feedback without making direct changes. Markdown dosyası adı mod adı olur (örneğin, `review.md` bir `review` modu oluşturur). -Let's look at these configuration options in detail. +Bu yapılandırma seçeneklerine ayrıntılı olarak bakalım. --- -### Modeli +### Model -Bu modun varsayılan standardı geçersiz için `model` kontrolü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 modun varsayılan modelini geçersiz kılmak 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. ```json title="opencode.json" { @@ -132,7 +132,7 @@ Bu modun varsayılan standardı geçersiz için `model` kontrolünü kullanın. --- -### Temperature +### Sıcaklık `temperature` yapılandırmasıyla yapay zekanın yanıtlarının rastgeleliğini ve yaratıcılığını kontrol edin. Düşük değerler yanıtları daha odaklı ve belirleyici hale getirirken, yüksek değerler yaratıcılığı ve değişkenliği artırır. @@ -177,9 +177,9 @@ Sıcaklık belirtilmezse, opencode modele özgü varsayılanları kullanır (ço --- -### Çabuk +### İstem -`prompt` analiziyle bu mod için özel bir sistem bilgi istemi dosyası destekleniyor. Bilgi istemi şeması, modun amacına özel talimatlar içermelidir. +`prompt` yapılandırmasıyla bu mod için özel bir sistem bilgi istemi dosyası belirtin. Bilgi istemi dosyası, modun amacına özel talimatlar içermelidir. ```json title="opencode.json" { @@ -196,7 +196,7 @@ hem global opencode yapılandırması hem de projeye özel yapılandırma. --- -### Tools +### Araçlar `tools` yapılandırmasıyla bu modda hangi araçların kullanılabileceğini kontrol edin. Belirli araçları `true` veya `false` olarak ayarlayarak etkinleştirebilir veya devre dışı bırakabilirsiniz. @@ -225,27 +225,27 @@ Hiçbir araç belirtilmezse tüm araçlar varsayılan olarak etkindir. İşte mod yapılandırması aracılığıyla kontrol edilebilecek tüm araçlar. -| Alet | Tanım | -| ----------- | ------------------------------- | -| `bash` | Kabuk komutlarını yürütün | -| `edit` | Mevcut dosyaları değiştirin | -| `write` | Yeni dosyalar oluştur | -| `read` | Dosya içeriğini oku | -| `grep` | Dosya içeriğini arayın | -| `glob` | Dosyaları desene göre bulun | -| `list` | Dizinin içeriği listele | -| `patch` | Dosyalara yama uygulama | -| `todowrite` | Yapılacaklar listelerini yönet | -| `todoread` | Yapılacaklar listelerini okuyun | -| `webfetch` | Web içeriğini getir | +| Araç | Açıklama | +| ----------- | ------------------------------ | +| `bash` | Kabuk komutlarını yürütün | +| `edit` | Mevcut dosyaları değiştirin | +| `write` | Yeni dosyalar oluştur | +| `read` | Dosya içeriğini oku | +| `grep` | Dosya içeriğini ara | +| `glob` | Dosyaları desene göre bul | +| `list` | Dizinin içeriğini listele | +| `patch` | Dosyalara yama uygula | +| `todowrite` | Yapılacaklar listelerini yönet | +| `todoread` | Yapılacaklar listelerini oku | +| `webfetch` | Web içeriğini getir | --- -## Custom modes +## Özel modlar Yapılandırmaya ekleyerek kendi özel modlarınızı oluşturabilirsiniz. Her iki yaklaşımın kullanıldığı örnekler aşağıda verilmiştir: -### JSON yapılandırmasını kullanma +### JSON yapılandırması kullanma ```json title="opencode.json" {4-14} { @@ -266,7 +266,7 @@ Yapılandırmaya ekleyerek kendi özel modlarınızı oluşturabilirsiniz. Her i } ``` -### Markdown dosyalarını kullanma +### Markdown dosyaları kullanma Projeye özel modlar için `.opencode/modes/` veya genel modlar için `~/.config/opencode/modes/`'de mod dosyaları oluşturun: @@ -318,9 +318,9 @@ Priorities: --- -### Kullanım durumları +### Kullanım Senaryoları -Farklı modlar için bazı yaygın kullanım durumları aşağıda verilmiştir. +Farklı modlar için bazı yaygın kullanım senaryoları aşağıda verilmiştir. - **Derleme modu**: Tüm araçların etkinleştirildiği tam geliştirme çalışması - **Plan modu**: Değişiklik yapmadan analiz ve planlama diff --git a/packages/web/src/content/docs/tr/network.mdx b/packages/web/src/content/docs/tr/network.mdx index 1e7a4f83e..b1ea7bc79 100644 --- a/packages/web/src/content/docs/tr/network.mdx +++ b/packages/web/src/content/docs/tr/network.mdx @@ -7,7 +7,7 @@ opencode, kurumsal ağ ortamları için standart proxy ortam değişkenlerini ve --- -## Proxy +## Vekil Sunucu opencode respects standard proxy environment variables. @@ -46,7 +46,7 @@ NTLM veya Kerberos gibi gelişmiş kimlik doğrulaması gerektiren proxy'ler iç --- -## Custom certificates +## Özel sertifikalar Kuruluşunuz HTTPS bağlantıları için özel CA'lar kullanıyorsa, opencode'u bunlara güvenecek şekilde yapılandırın. diff --git a/packages/web/src/content/docs/tr/permissions.mdx b/packages/web/src/content/docs/tr/permissions.mdx index 57f3ed33e..1194be9a4 100644 --- a/packages/web/src/content/docs/tr/permissions.mdx +++ b/packages/web/src/content/docs/tr/permissions.mdx @@ -1,6 +1,6 @@ --- title: İzinler -description: Hangi işlemlerin çalıştırılması için onay işlemini kontrol edin. +description: Hangi işlemlerin çalıştırılması için onay sürecini kontrol edin. --- opencode, belirli bir eylemin otomatik olarak mı çalıştırılacağına, size sorulacağına veya engelleneceğine karar vermek için `permission` yapılandırmasını kullanır. @@ -9,9 +9,9 @@ opencode, belirli bir eylemin otomatik olarak mı çalıştırılacağına, size --- -## Actions +## Eylemler -Each permission rule resolves to one of: +Her izin kuralı şunlardan birine çözümlenir: - `"allow"` — onay olmadan çalıştır - `"ask"` — onay istemi @@ -45,7 +45,7 @@ Ayrıca tüm izinleri aynı anda ayarlayabilirsiniz: --- -## Granular Rules (Object Syntax) +## Ayrıntılı Kurallar (Nesne Sözdizimi) Çoğu izin için, araç girişine bağlı olarak farklı eylemleri uygulamak için bir nesneyi kullanabilirsiniz. @@ -70,13 +70,13 @@ Ayrıca tüm izinleri aynı anda ayarlayabilirsiniz: Kurallar, **son eşleşen kuralın kazanması** ile kalıp eşleşmesine göre değerlendirilir. Yaygın bir model, tümünü yakala `"*"` kuralını ilk sıraya koymak ve daha spesifik kuralları ondan sonra koymaktır. -### Wildcards +### Joker Karakterler İzin kalıpları basit joker karakter eşleştirmesini kullanır: - `*` herhangi bir karakterin sıfır veya daha fazlasıyla eşleşir -- `?` matches exactly one character -- All other characters match literally +- `?` tam olarak bir karakterle eşleşir +- Diğer tüm karakterler birebir eşleşir ### Ana Dizin Genişletme @@ -86,7 +86,7 @@ Ana dizininize referans vermek için bir modelin başlangıcında `~` veya `$HOM - `$HOME/projects/*` -> `/Users/username/projects/*` - `~` -> `/Users/username` -### Dış Dizinler +### Harici Dizinler opencode'un başlatıldığı çalışma dizini dışındaki yollara dokunan araç çağrılarına izin vermek için `external_directory` kullanın. Bu, girdi olarak bir yolu alan tüm araçlar için geçerlidir (örneğin `read`, `edit`, `list`, `glob`, `grep` ve birçok `bash` komutu). @@ -127,7 +127,7 @@ Listeyi güvenilir yollara odaklı tutun ve diğer araçlar için gereken ekstra ## Mevcut İzinler -opencode izinleri araç adına ve birkaç güvenlik görevlisine göre anahtarlanır: +opencode izinleri araç adına ve birkaç güvenlik önlemine göre anahtarlanır: - `read` — bir dosyayı okumak (dosya yoluyla eşleşir) - `edit` — tüm dosya değişiklikleri (`edit`, `write`, `patch`, `multiedit`'yi kapsar) @@ -135,12 +135,12 @@ opencode izinleri araç adına ve birkaç güvenlik görevlisine göre anahtarla - `grep` — içerik arama (regex modeliyle eşleşir) - `list` — bir dizideki dosyaları listeleme (dizin yoluyla eşleşir) - `bash` — kabuk komutlarını çalıştırma (`git status --porcelain` gibi ayrıştırılmış komutlarla eşleşir) -- `task` — alt aracıların başlatılması (alt aracı türüyle eşleşir) -- `skill` — bir beceri yükleniyor (beceri adıyla eşleşir) +- `task` — alt agent'ların başlatılması (alt agent türüyle eşleşir) +- `skill` — bir skill yükleniyor (skill adıyla eşleşir) - `lsp` — LSP sorgularını çalıştırıyor (şu anda ayrıntılı değil) -- `todoread`, `todowrite` — reading/updating yapılacaklar listesi +- `todoread`, `todowrite` — yapılacaklar listesini okuma/güncelleme - `webfetch` — URL getiriliyor (URL ile eşleşiyor) -- `websearch`, `codesearch` — web/code arama (sorguyla eşleşir) +- `websearch`, `codesearch` — web/kod arama (sorguyla eşleşir) - `external_directory` — bir araç proje çalışma dizini dışındaki yollara dokunduğunda tetiklenir - `doom_loop` — aynı araç çağrısı aynı girdiyle 3 kez tekrarlandığında tetiklenir @@ -152,7 +152,7 @@ Hiçbir şey belirtmezseniz opencode izin verilen varsayılanlardan başlar: - Çoğu izin varsayılan olarak `"allow"` şeklindedir. - `doom_loop` ve `external_directory` varsayılan olarak `"ask"`'dir. -- `read`, `"allow"`'dir, ancak `.env` dosyaları varsayılan olarak reddedilir: +- `read`, `"allow"`'dır, ancak `.env` dosyaları varsayılan olarak reddedilir: ```json title="opencode.json" { @@ -181,12 +181,12 @@ opencode onay istediğinde kullanıcı arayüzü üç sonuç sunar: --- -## Agents +## Agent'lar Agent bazında izinleri geçersiz kılabilirsiniz. Agent izinleri global yapılandırmayla birleştirilir ve agent kuralları önceliklidir. [Daha fazla bilgi](/docs/agents#permissions). :::note -Daha ayrıntılı desen eşleştirme örnekleri için yukarıdaki [Ayrıntılı kurallar (obje söz dizimi)](#granular-rules-object-syntax) bölümüne bakın. +Daha ayrıntılı desen eşleştirme örnekleri için yukarıdaki [Ayrıntılı kurallar (nesne söz dizimi)](#granular-rules-object-syntax) bölümüne bakın. ::: ```json title="opencode.json" @@ -217,7 +217,7 @@ Daha ayrıntılı desen eşleştirme örnekleri için yukarıdaki [Ayrıntılı } ``` -Aracı izinlerini Markdown'da da yapılandırabilirsiniz: +Agent izinlerini Markdown'da da yapılandırabilirsiniz: ```markdown title="~/.config/opencode/agents/review.md" --- diff --git a/packages/web/src/content/docs/tr/plugins.mdx b/packages/web/src/content/docs/tr/plugins.mdx index dd04544ac..0b24e48c3 100644 --- a/packages/web/src/content/docs/tr/plugins.mdx +++ b/packages/web/src/content/docs/tr/plugins.mdx @@ -5,13 +5,13 @@ description: opencode'u genişletmek için kendi eklentilerinizi yazın. Eklentiler, çeşitli olaylara bağlanarak ve davranışı özelleştirerek opencode'u genişletmenize olanak tanır. Yeni özellikler eklemek, harici hizmetlerle entegrasyon sağlamak veya opencode'un varsayılan davranışını değiştirmek için eklentiler oluşturabilirsiniz. -Örnekler için topluluk tarafından oluşturulan [plugins](/docs/ecosystem#plugins)'a göz atın. +Örnekler için topluluk tarafından oluşturulan [eklentilere](/docs/ecosystem#plugins) göz atın. --- -## Bir eklenti kullanın +## Eklenti kullanımı -There are two ways to load plugins. +Eklentileri yüklemenin iki yolu vardır. --- @@ -39,7 +39,7 @@ Yapılandırma dosyanızda npm paketlerini belirtin. Hem normal hem de kapsamlı npm paketleri desteklenir. -[ecosystem](/docs/ecosystem#plugins)'daki mevcut eklentilere göz atın. +[Ekosistem](/docs/ecosystem#plugins)'deki mevcut eklentilere göz atın. --- @@ -47,11 +47,11 @@ Hem normal hem de kapsamlı npm paketleri desteklenir. **npm eklentileri** başlangıçta Bun kullanılarak otomatik olarak yüklenir. Paketler ve bağımlılıkları `~/.cache/opencode/node_modules/`'da önbelleğe alınır. -**Yerel eklentiler** doğrudan eklenti dizininden yüklenir. Harici paketleri kullanmak için, sisteminizin dizininde bir `package.json` oluşturmanız (bkz. [Dependencies](#dependencies)) veya eklentiyi npm ve [add it to your config](/docs/config#plugins)'de yayınlamanız gerekir. +**Yerel eklentiler** doğrudan eklenti dizininden yüklenir. Harici paketleri kullanmak için, sisteminizin dizininde bir `package.json` oluşturmanız (bkz. [Bağımlılıklar](#dependencies)) veya eklentiyi npm ve [add it to your config](/docs/config#plugins)'de yayınlamanız gerekir. --- -### Load order +### Yükleme sırası Eklentiler tüm kaynaklardan yüklenir ve tüm kancalar sırayla çalışır. Yükleme sırası şöyledir: @@ -64,14 +64,14 @@ Aynı ad ve sürüme sahip yinelenen npm paketleri bir kez yüklenir. Ancak benz --- -## Eklenti oluştur +## Eklenti oluşturma Eklenti, bir veya daha fazla eklentiyi dışa aktaran bir **JavaScript/TypeScript modülüdür** işlevler. Her işlev bir bağlam nesnesi alır ve bir kanca nesnesi döndürür. --- -### Dependencies +### Bağımlılıklar Yerel eklentiler ve özel araçlar harici npm paketlerini kullanabilir. İhtiyacınız olan bağımlılıkları içeren config dizininize bir `package.json` ekleyin. @@ -152,32 +152,32 @@ Eklentiler aşağıdaki Örnekler bölümünde görüldüğü gibi etkinliklere - `file.edited` - `file.watcher.updated` -#### Kurulum Etkinlikleri +#### Kurulum Olayları - `installation.updated` -#### LSP Etkinlikler +#### LSP Olayları - `lsp.client.diagnostics` - `lsp.updated` -#### Mesaj Etkinlikleri +#### Mesaj Olayları - `message.part.removed` - `message.part.updated` - `message.removed` - `message.updated` -#### İzin Etkinlikleri +#### İzin Olayları - `permission.asked` - `permission.replied` -#### Sunucu Etkinlikleri +#### Sunucu Olayları - `server.connected` -#### Oturum Etkinlikleri +#### Oturum Olayları - `session.created` - `session.compacted` @@ -188,11 +188,11 @@ Eklentiler aşağıdaki Örnekler bölümünde görüldüğü gibi etkinliklere - `session.status` - `session.updated` -#### Yapılacak Etkinlikler +#### Yapılacaklar Olayları - `todo.updated` -#### Kabuk Etkinlikleri +#### Kabuk Olayları - `shell.env` @@ -201,7 +201,7 @@ Eklentiler aşağıdaki Örnekler bölümünde görüldüğü gibi etkinliklere - `tool.execute.after` - `tool.execute.before` -#### TUI Etkinlikler +#### TUI Olayları - `tui.prompt.append` - `tui.command.execute` @@ -209,13 +209,13 @@ Eklentiler aşağıdaki Örnekler bölümünde görüldüğü gibi etkinliklere --- -## Examples +## Örnekler opencode'u genişletmek için kullanabileceğiniz bazı eklenti örneklerini burada bulabilirsiniz. --- -### Bildirim gönder +### Bildirim Gönderme Belirli olaylar meydana geldiğinde bildirim gönderin: @@ -240,7 +240,7 @@ opencode masaüstü uygulamasını kullanıyorsanız yanıt hazır olduğunda ve --- -### .env protection +### .env Koruması opencode'un `.env` dosyalarını okumasını önleyin: @@ -275,7 +275,7 @@ export const InjectEnvPlugin = async () => { --- -### Custom tools +### Özel araçlar Eklentiler ayrıca opencode'a özel araçlar da ekleyebilir: @@ -331,7 +331,7 @@ Seviyeler: `debug`, `info`, `warn`, `error`. Ayrıntılar için [SDK documentati --- -### Compaction hooks +### Sıkıştırma kancaları Bir oturum sıkıştırıldığında içerilen bağlamı özelleştirin: diff --git a/packages/web/src/content/docs/tr/providers.mdx b/packages/web/src/content/docs/tr/providers.mdx index 0f57b5ec2..efe5ff9af 100644 --- a/packages/web/src/content/docs/tr/providers.mdx +++ b/packages/web/src/content/docs/tr/providers.mdx @@ -15,21 +15,21 @@ Bir sağlayıcı eklemek için şunları yapmanız gerekir: --- -### Credentials +### Kimlik Bilgileri Bir sağlayıcının API anahtarlarını `/connect` komutuyla eklediğinizde, bunlar saklanır `~/.local/share/opencode/auth.json` içinde. --- -### Config +### Yapılandırma Sağlayıcıları opencode'unuzdaki `provider` bölümü aracılığıyla özelleştirebilirsiniz. config. --- -#### Base URL +#### Temel URL `baseURL` seçeneğini ayarlayarak URL tabanını herhangi bir sağlayıcı için özelleştirebilirsiniz. Bu, proxy hizmetlerini veya özel uç noktaları kullanırken kullanışlıdır. @@ -137,7 +137,7 @@ Amazon Bedrock'u opencode ile kullanmak için: #### Ortam Değişkenleri (Hızlı Başlangıç) - Set one of these environment variables while running opencode: + opencode'u çalıştırırken bu ortam değişkenlerinden birini ayarlayın: ```bash # Option 1: Using AWS access keys @@ -184,44 +184,46 @@ Amazon Bedrock'u opencode ile kullanmak için: Yapılandırma dosyası seçenekleri ortam değişkenlerine göre önceliklidir. ::: - #### Advanced: VPC Endpoints +#### Gelişmiş: VPC Uç Noktaları - Bedrock için VPC uç noktaları kullanıyorsanız: +Bedrock için VPC uç noktaları kullanıyorsanız: - ```json title="opencode.json" - { - "$schema": "https://opencode.ai/config.json", - "provider": { - "amazon-bedrock": { - "options": { - "region": "us-east-1", - "profile": "production", - "endpoint": "https://bedrock-runtime.us-east-1.vpce-xxxxx.amazonaws.com" - } - } - } - } - ``` +```json title="opencode.json" +{ + "$schema": "https://opencode.ai/config.json", + "provider": { + "amazon-bedrock": { + "options": { + "region": "us-east-1", + "profile": "production", + "endpoint": "https://bedrock-runtime.us-east-1.vpce-xxxxx.amazonaws.com" + } + } + } +} +``` - :::note - `endpoint` seçeneği, AWS'ye özgü terminolojiyi kullanan genel `baseURL` seçeneğinin takma adıdır. Hem `endpoint` hem de `baseURL` belirtilirse, `endpoint` öncelikli olur. - ::: +:::note +`endpoint` seçeneği, AWS'ye özgü terminolojiyi kullanan genel `baseURL` seçeneğinin takma adıdır. Hem `endpoint` hem de `baseURL` belirtilirse, `endpoint` öncelikli olur. +::: - #### Authentication Methods - - **`AWS_ACCESS_KEY_ID` / `AWS_SECRET_ACCESS_KEY`**: Bir IAM kullanıcısı oluşturun ve AWS Konsolunda erişim anahtarları oluşturun - - **`AWS_PROFILE`**: `~/.aws/credentials`'den adlandırılmış profilleri kullanın. İlk önce `aws configure --profile my-profile` veya `aws sso login` ile yapılandırın - - **`AWS_BEARER_TOKEN_BEDROCK`**: Amazon Bedrock konsolundan uzun vadeli API anahtarları oluşturun - - **`AWS_WEB_IDENTITY_TOKEN_FILE` / `AWS_ROLE_ARN`**: EKS IRSA (IAM Hizmet Hesapları için Roller) veya OIDC federasyonuna sahip diğer Kubernetes ortamları için. Bu ortam değişkenleri, hizmet hesabı ek açıklamaları kullanılırken Kubernetes tarafından otomatik olarak eklenir. +#### Kimlik Doğrulama Yöntemleri - #### Authentication Precedence +- **`AWS_ACCESS_KEY_ID` / `AWS_SECRET_ACCESS_KEY`**: Bir IAM kullanıcısı oluşturun ve AWS Konsolunda erişim anahtarları oluşturun +- **`AWS_PROFILE`**: `~/.aws/credentials`'den adlandırılmış profilleri kullanın. İlk önce `aws configure --profile my-profile` veya `aws sso login` ile yapılandırın +- **`AWS_BEARER_TOKEN_BEDROCK`**: Amazon Bedrock konsolundan uzun vadeli API anahtarları oluşturun +- **`AWS_WEB_IDENTITY_TOKEN_FILE` / `AWS_ROLE_ARN`**: EKS IRSA (IAM Hizmet Hesapları için Roller) veya OIDC federasyonuna sahip diğer Kubernetes ortamları için. Bu ortam değişkenleri, hizmet hesabı ek açıklamaları kullanılırken Kubernetes tarafından otomatik olarak eklenir. - Amazon Bedrock aşağıdaki kimlik doğrulama önceliğini kullanır: - 1. **Taşıyıcı Belirteç** - `AWS_BEARER_TOKEN_BEDROCK` ortam değişkeni veya `/connect` komutundan belirteç - 2. **AWS Credential Chain** - Profile, access keys, shared credentials, IAM roles, Web Identity Tokens (EKS IRSA), instance metadata +#### Kimlik Doğrulama Önceliği - :::note - When a bearer token is set (via `/connect` or `AWS_BEARER_TOKEN_BEDROCK`), it takes precedence over all AWS credential methods including configured profiles. - ::: +Amazon Bedrock aşağıdaki kimlik doğrulama önceliğini kullanır: + +1. **Taşıyıcı Belirteç** - `AWS_BEARER_TOKEN_BEDROCK` ortam değişkeni veya `/connect` komutundan belirteç +2. **AWS Credential Chain** - Profil, erişim anahtarları, paylaşılan kimlik bilgileri, IAM rolleri, Web Identity Tokens (EKS IRSA), örnek meta verileri + +:::note +Bir taşıyıcı belirteç ayarlandığında (`/connect` veya `AWS_BEARER_TOKEN_BEDROCK` yoluyla), yapılandırılmış profiller dahil olmak üzere tüm AWS kimlik bilgisi yöntemlerine göre öncelik kazanır. +::: 3. İstediğiniz modeli seçmek için `/models` komutunu çalıştırın. @@ -282,7 +284,7 @@ Amazon Bedrock'u opencode ile kullanmak için: Claude Pro/Max aboneliğinizi opencode'da kullanmak [Anthropic](https://anthropic.com) tarafından resmi olarak desteklenmemektedir. ::: -##### API tuşlarını kullanma +##### API anahtarlarını kullanma Pro/Max aboneliğiniz yoksa **API Anahtarı Oluştur** seçeneğini de seçebilirsiniz. Ayrıca tarayıcınızı açacak ve Anthropic'te oturum açmanızı isteyecek ve terminalinize yapıştırabileceğiniz bir kod verecektir. @@ -353,7 +355,7 @@ Veya zaten bir API anahtarınız varsa **API Anahtarını Manuel Olarak Girin** opencode'un düzgün çalışması için dağıtım adının model adıyla eşleşmesi gerekir. ::: -3. `/connect` komutunu çalıştırın ve **Azure Bilişsel Hizmetler**'i arayın. +3. `/connect` komutunu çalıştırın ve **Azure Cognitive Services**'i arayın. ```txt /connect @@ -461,7 +463,7 @@ Cloudflare AI Gateway, OpenAI, Anthropic, Workers AI ve daha fazlasındaki model /connect ``` -4. Cloudflare API jetonunuzu girin. +4. Cloudflare API tokenınızı girin. ```txt ┌ API key @@ -470,7 +472,7 @@ Cloudflare AI Gateway, OpenAI, Anthropic, Workers AI ve daha fazlasındaki model └ enter ``` - Or set it as an environment variable. + Veya bunu bir ortam değişkeni olarak ayarlayın. ```bash title="~/.bash_profile" export CLOUDFLARE_API_TOKEN=your-api-token @@ -682,9 +684,9 @@ GitLab Duo, GitLab'ın Anthropic proxy'si aracılığıyla yerel araç çağırm to store token in opencode auth storage. ::: -##### Self-Hosted GitLab +##### Kendi Kendine Barındırılan GitLab -:::note[compliance note] +:::note[uyumluluk notu] opencode, oturum başlığını oluşturmak gibi bazı AI görevleri için küçük bir model kullanır. Varsayılan olarak Zen tarafından barındırılan gpt-5-nano'yu kullanacak şekilde yapılandırılmıştır. opencode'u kilitlemek için yalnızca kendi GitLab tarafından barındırılan örneğinizi kullanmak için aşağıdakileri ekleyin: @@ -748,9 +750,9 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here Daha fazla belge [opencode-gitlab-auth](https://www.npmjs.com/package/@gitlab/opencode-gitlab-auth) ana sayfasında. -##### Configuration +##### Yapılandırma -Customize through `opencode.json`: +`opencode.json` üzerinden özelleştirin: ```json title="opencode.json" { @@ -769,9 +771,9 @@ Customize through `opencode.json`: } ``` -##### GitLab API Tools (Optional, but highly recommended) +##### GitLab API Araçları (İsteğe bağlı, ancak şiddetle önerilir) -To access GitLab tools (merge requests, issues, pipelines, CI/CD, etc.): +GitLab araçlarına (birleştirme istekleri, sorunlar, işlem hatları, CI/CD vb.) erişmek için: ```json title="opencode.json" { @@ -834,11 +836,11 @@ Google Vertex AI'yi opencode ile kullanmak için: 2. Gerekli ortam değişkenlerini ayarlayın: - `GOOGLE_CLOUD_PROJECT`: Google Cloud proje kimliğiniz - `VERTEX_LOCATION` (isteğe bağlı): Vertex AI bölgesi (varsayılanı `global`'dir) - - Authentication (choose one): + - Kimlik Doğrulama (birini seçin): - `GOOGLE_APPLICATION_CREDENTIALS`: Hizmet hesabınızın yolu JSON anahtar dosyası - gcloud kullanarak kimlik doğrulaması yapın CLI: `gcloud auth application-default login` - Set them while running opencode. + Bunları opencode çalıştırılırken ayarlayın. ```bash GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json GOOGLE_CLOUD_PROJECT=your-project-id opencode @@ -897,13 +899,13 @@ Google Vertex AI'yi opencode ile kullanmak için: 1. Çıkarım Sağlayıcılara çağrı yapma iznine sahip bir belirteç oluşturmak için [Hugging Face settings](https://huggingface.co/settings/tokens/new?ownUserPermissions=inference.serverless.write&tokenType=fineGrained) adresine gidin. -2. `/connect` komutunu çalıştırın ve **Sarılma Yüzünü** arayın. +2. `/connect` komutunu çalıştırın ve **Hugging Face**'i arayın. ```txt /connect ``` -3. Hugging Face jetonunuzu girin. +3. Hugging Face tokenınızı girin. ```txt ┌ API key @@ -949,7 +951,7 @@ Google Vertex AI'yi opencode ile kullanmak için: Daha fazla sağlayıcı ve önbelleğe alma ve hız sınırlama gibi gelişmiş özellikler için [Helicone documentation](https://docs.helicone.ai)'yi kontrol edin. -#### Optional Configs +#### İsteğe Bağlı Yapılandırmalar Helicone'un opencode aracılığıyla otomatik olarak yapılandırılmayan bir özelliği veya modelini görmeniz durumunda bunu her zaman kendiniz yapılandırabilirsiniz. @@ -979,7 +981,7 @@ Helicone'un opencode aracılığıyla otomatik olarak yapılandırılmayan bir } ``` -#### Custom Headers +#### Özel Başlıklar Helicone, önbelleğe alma, kullanıcı izleme ve oturum yönetimi gibi özellikler için özel başlıkları destekler. `options.headers` kullanarak bunları sağlayıcınızın yapılandırmasına ekleyin: @@ -1020,7 +1022,7 @@ Yapılandırmanıza ekleyin. Eklenti isteklerinize `Helicone-Session-Id` ve `Helicone-Session-Name` başlıklarını enjekte eder. Helicone'un Oturumlar sayfasında her opencode görüşmesinin ayrı bir oturum olarak listelendiğini göreceksiniz. -##### Common Helicone headers +##### Yaygın Helicone başlıkları | Başlık | Açıklama | | -------------------------- | ------------------------------------------------------------- | @@ -1325,7 +1327,7 @@ Ollama Cloud'u opencode ile kullanmak için: /models ``` -##### API tuşlarını kullanma +##### API anahtarlarını kullanma Zaten bir API anahtarınız varsa, **API Anahtarını Manuel Olarak Girin** seçeneğini seçip terminalinize yapıştırabilirsiniz. @@ -1635,12 +1637,12 @@ Modelleri opencode yapılandırmanız aracılığıyla da özelleştirebilirsini } ``` -Some useful routing options: +Bazı yararlı yönlendirme seçenekleri: | Seçenek | Açıklama | | ------------------- | --------------------------------------------------------------------- | | `order` | Denenecek sağlayıcı sırası | -| `only` | Restrict to specific providers | +| `only` | Belirli sağlayıcılarla sınırla | | `zeroDataRetention` | Yalnızca sıfır veri saklama politikasına sahip sağlayıcıları kullanın | --- @@ -1818,11 +1820,11 @@ OpenAI uyumlu herhangi bir sağlayıcıyı opencode ile kullanabilirsiniz. Çoğ Yapılandırma seçenekleri şunlardır: - **npm**: Kullanılacak AI SDK paketi, OpenAI uyumlu sağlayıcılar için `@ai-sdk/openai-compatible` - - **name**: Display name in UI. + - **name**: UI'daki görünen ad. - **modeller**: Mevcut modeller. - **options.baseURL**: API endpoint URL. - **options.apiKey**: Kimlik doğrulama kullanılmıyorsa isteğe bağlı olarak API anahtarını ayarlayın. - - **options.headers**: Optionally set custom headers. + - **options.headers**: İsteğe bağlı olarak özel başlıklar ayarlayın. Aşağıdaki örnekte gelişmiş seçenekler hakkında daha fazla bilgi bulabilirsiniz. @@ -1830,7 +1832,7 @@ OpenAI uyumlu herhangi bir sağlayıcıyı opencode ile kullanabilirsiniz. Çoğ --- -##### Example +##### Örnek Burada `apiKey`, `headers` ve model `limit` seçeneklerini ayarlayan bir örnek verilmiştir. @@ -1862,18 +1864,18 @@ Burada `apiKey`, `headers` ve model `limit` seçeneklerini ayarlayan bir örnek } ``` -Configuration details: +Yapılandırma ayrıntıları: -- **apiKey**: `env` değişken söz dizimini kullanarak ayarlayın, [learn more](/docs/config#env-vars). -- **başlıklar**: Her istekle birlikte gönderilen özel başlıklar. -- **limit.context**: Modelin kabul ettiği maksimum giriş jetonları. -- **limit.output**: Modelin üretebileceği maksimum jeton sayısı. +- **apiKey**: `env` değişken söz dizimini kullanarak ayarlayın, [daha fazla bilgi](/docs/config#env-vars). +- **headers**: Her istekle birlikte gönderilen özel başlıklar. +- **limit.context**: Modelin kabul ettiği maksimum giriş tokenları. +- **limit.output**: Modelin üretebileceği maksimum token sayısı. `limit` alanları opencode'un ne kadar bağlamınız kaldığını anlamasını sağlar. Standart sağlayıcılar bunları models.dev'den otomatik olarak alır. --- -## Troubleshooting +## Sorun Giderme Sağlayıcıyı yapılandırma konusunda sorun yaşıyorsanız aşağıdakileri kontrol edin: diff --git a/packages/web/src/content/docs/tr/sdk.mdx b/packages/web/src/content/docs/tr/sdk.mdx index 4a66932a2..b5ba99f43 100644 --- a/packages/web/src/content/docs/tr/sdk.mdx +++ b/packages/web/src/content/docs/tr/sdk.mdx @@ -1,21 +1,21 @@ --- title: SDK -description: opencode serveri icin type-safe JS istemcisi. +description: opencode sunucusu için type-safe JS istemcisi. --- import config from "../../../../config.mjs" export const typesUrl = `${config.github}/blob/dev/packages/sdk/js/src/gen/types.gen.ts` -opencode JS/TS SDK, sunucu ile etkilesmek icin type-safe bir istemci saglar. -opencode'u programatik olarak kontrol etmek ve entegrasyonlar olusturmak icin kullanabilirsiniz. +opencode JS/TS SDK, sunucu ile etkileşmek için type-safe bir istemci sağlar. +opencode'u programatik olarak kontrol etmek ve entegrasyonlar oluşturmak için kullanabilirsiniz. -[Sunucu](/docs/server) sayfasinda nasil calistigini gorebilir, ornekler icin toplulugun olusturdugu [projects](/docs/ecosystem#projects) bolumune bakabilirsiniz. +[Sunucu](/docs/server) sayfasında nasıl çalıştığını görebilir, örnekler için topluluğun oluşturduğu [projeler](/docs/ecosystem#projects) bölümüne bakabilirsiniz. --- -## Install +## Kurulum -Install the SDK from npm: +SDK'yı npm'den yükleyin: ```bash npm install @opencode-ai/sdk @@ -23,9 +23,9 @@ npm install @opencode-ai/sdk --- -## Create client +## İstemci Oluşturma -Create an instance of opencode: +Bir opencode örneği oluşturun: ```javascript import { createOpencode } from "@opencode-ai/sdk" @@ -33,23 +33,23 @@ import { createOpencode } from "@opencode-ai/sdk" const { client } = await createOpencode() ``` -This starts both a server and a client +Bu, hem bir sunucu hem de bir istemci başlatır -#### Options +#### Seçenekler -| Option | Type | Description | Default | -| ---------- | ------------- | ------------------------------ | ----------- | -| `hostname` | `string` | Server hostname | `127.0.0.1` | -| `port` | `number` | Server port | `4096` | -| `signal` | `AbortSignal` | Abort signal for cancellation | `undefined` | -| `timeout` | `number` | Timeout in ms for server start | `5000` | -| `config` | `Config` | Configuration object | `{}` | +| Seçenek | Tip | Açıklama | Varsayılan | +| ---------- | ------------- | --------------------------------------------- | ----------- | +| `hostname` | `string` | Sunucu ana bilgisayar adı | `127.0.0.1` | +| `port` | `number` | Sunucu bağlantı noktası | `4096` | +| `signal` | `AbortSignal` | İptal için durdurma sinyali | `undefined` | +| `timeout` | `number` | Sunucu başlatma için ms cinsinden zaman aşımı | `5000` | +| `config` | `Config` | Yapılandırma nesnesi | `{}` | --- -## Config +## Yapılandırma -You can pass a configuration object to customize behavior. The instance still picks up your `opencode.json`, but you can override or add configuration inline: +Davranışı özelleştirmek için bir yapılandırma nesnesi iletebilirsiniz. Örnek yine de `opencode.json` dosyanızı alır, ancak yapılandırmayı satır içi olarak geçersiz kılabilir veya ekleyebilirsiniz: ```javascript import { createOpencode } from "@opencode-ai/sdk" @@ -67,9 +67,9 @@ console.log(`Server running at ${opencode.server.url}`) opencode.server.close() ``` -## Client only +## Yalnızca istemci -If you already have a running instance of opencode, you can create a client instance to connect to it: +Halihazırda çalışan bir opencode örneğiniz varsa, ona bağlanmak için bir istemci örneği oluşturabilirsiniz: ```javascript import { createOpencodeClient } from "@opencode-ai/sdk" @@ -79,33 +79,33 @@ const client = createOpencodeClient({ }) ``` -#### Options +#### Seçenekler -| Option | Type | Description | Default | -| --------------- | ---------- | -------------------------------- | ----------------------- | -| `baseUrl` | `string` | URL of the server | `http://localhost:4096` | -| `fetch` | `function` | Custom fetch implementation | `globalThis.fetch` | -| `parseAs` | `string` | Response parsing method | `auto` | -| `responseStyle` | `string` | Return style: `data` or `fields` | `fields` | -| `throwOnError` | `boolean` | Throw errors instead of return | `false` | +| Seçenek | Tip | Açıklama | Varsayılan | +| --------------- | ---------- | --------------------------------- | ----------------------- | +| `baseUrl` | `string` | Sunucunun URL'si | `http://localhost:4096` | +| `fetch` | `function` | Özel fetch uygulaması | `globalThis.fetch` | +| `parseAs` | `string` | Yanıt ayrıştırma yöntemi | `auto` | +| `responseStyle` | `string` | Dönüş stili: `data` veya `fields` | `fields` | +| `throwOnError` | `boolean` | Dönüş yerine hata fırlat | `false` | --- -## Types +## Türler -The SDK includes TypeScript definitions for all API types. Import them directly: +SDK, tüm API türleri için TypeScript tanımlarını içerir. Bunları doğrudan içe aktarın: ```typescript import type { Session, Message, Part } from "@opencode-ai/sdk" ``` -All types are generated from the server's OpenAPI specification and available in the types file. +Tüm tipler, sunucunun OpenAPI spesifikasyonundan oluşturulur ve tipler dosyasında mevcuttur. --- -## Errors +## Hatalar -The SDK can throw errors that you can catch and handle: +SDK, yakalayabileceğiniz ve işleyebileceğiniz hatalar fırlatabilir: ```typescript try { @@ -117,21 +117,21 @@ try { --- -## APIs +## API'ler -The SDK exposes all server APIs through a type-safe client. +SDK, tüm sunucu API'lerini type-safe bir istemci aracılığıyla sunar. --- ### Global -| Method | Description | Response | -| ----------------- | ------------------------------- | ------------------------------------ | -| `global.health()` | Check server health and version | `{ healthy: true, version: string }` | +| Yöntem | Açıklama | Yanıt | +| ----------------- | --------------------------------------- | ------------------------------------ | +| `global.health()` | Sunucu sağlığını ve sürümünü kontrol et | `{ healthy: true, version: string }` | --- -#### Examples +#### Örnekler ```javascript const health = await client.global.health() @@ -142,14 +142,14 @@ console.log(health.data.version) ### App -| Method | Description | Response | -| -------------- | ------------------------- | ------------------------------------------- | -| `app.log()` | Write a log entry | `boolean` | -| `app.agents()` | List all available agents | Agent[] | +| Yöntem | Açıklama | Yanıt | +| -------------- | ----------------------------- | ------------------------------------------- | +| `app.log()` | Bir günlük girdisi yaz | `boolean` | +| `app.agents()` | Tüm mevcut agent'ları listele | Agent[] | --- -#### Examples +#### Örnekler ```javascript // Write a log entry @@ -169,14 +169,14 @@ const agents = await client.app.agents() ### Project -| Method | Description | Response | -| ------------------- | ------------------- | --------------------------------------------- | -| `project.list()` | List all projects | Project[] | -| `project.current()` | Get current project | Project | +| Yöntem | Açıklama | Yanıt | +| ------------------- | --------------------- | --------------------------------------------- | +| `project.list()` | Tüm projeleri listele | Project[] | +| `project.current()` | Mevcut projeyi al | Project | --- -#### Examples +#### Örnekler ```javascript // List all projects @@ -190,13 +190,13 @@ const currentProject = await client.project.current() ### Path -| Method | Description | Response | -| ------------ | ---------------- | ---------------------------------------- | -| `path.get()` | Get current path | Path | +| Yöntem | Açıklama | Yanıt | +| ------------ | -------------- | ---------------------------------------- | +| `path.get()` | Mevcut yolu al | Path | --- -#### Examples +#### Örnekler ```javascript // Get current path information @@ -207,14 +207,14 @@ const pathInfo = await client.path.get() ### Config -| Method | Description | Response | -| -------------------- | --------------------------------- | ----------------------------------------------------------------------------------------------------- | -| `config.get()` | Get config info | Config | -| `config.providers()` | List providers and default models | `{ providers: `Provider[]`, default: { [key: string]: string } }` | +| Yöntem | Açıklama | Yanıt | +| -------------------- | --------------------------------------------- | ----------------------------------------------------------------------------------------------------- | +| `config.get()` | Yapılandırma bilgisini al | Config | +| `config.providers()` | Sağlayıcıları ve varsayılan modelleri listele | `{ providers: `Provider[]`, default: { [key: string]: string } }` | --- -#### Examples +#### Örnekler ```javascript const config = await client.config.get() @@ -224,33 +224,33 @@ const { providers, default: defaults } = await client.config.providers() --- -### Sessions +### Oturumlar -| Method | Description | Notes | -| ---------------------------------------------------------- | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | -| `session.list()` | List sessions | Returns Session[] | -| `session.get({ path })` | Get session | Returns Session | -| `session.children({ path })` | List child sessions | Returns Session[] | -| `session.create({ body })` | Create session | Returns Session | -| `session.delete({ path })` | Delete session | Returns `boolean` | -| `session.update({ path, body })` | Update session properties | Returns Session | -| `session.init({ path, body })` | Analyze app and create `AGENTS.md` | Returns `boolean` | -| `session.abort({ path })` | Abort a running session | Returns `boolean` | -| `session.share({ path })` | Share session | Returns Session | -| `session.unshare({ path })` | Unshare session | Returns Session | -| `session.summarize({ path, body })` | Summarize session | Returns `boolean` | -| `session.messages({ path })` | List messages in a session | Returns `{ info: `Message`, parts: `Part[]`}[]` | -| `session.message({ path })` | Get message details | Returns `{ info: `Message`, parts: `Part[]`}` | -| `session.prompt({ path, body })` | Send prompt message | `body.noReply: true` returns UserMessage (context only). Default returns AssistantMessage with AI response | -| `session.command({ path, body })` | Send command to session | Returns `{ info: `AssistantMessage`, parts: `Part[]`}` | -| `session.shell({ path, body })` | Run a shell command | Returns AssistantMessage | -| `session.revert({ path, body })` | Revert a message | Returns Session | -| `session.unrevert({ path })` | Restore reverted messages | Returns Session | -| `postSessionByIdPermissionsByPermissionId({ path, body })` | Respond to a permission request | Returns `boolean` | +| Yöntem | Açıklama | Notlar | +| ---------------------------------------------------------- | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `session.list()` | Oturumları listele | Session[] döndürür | +| `session.get({ path })` | Oturum al | Session döndürür | +| `session.children({ path })` | Alt oturumları listele | Session[] döndürür | +| `session.create({ body })` | Oturum oluştur | Session döndürür | +| `session.delete({ path })` | Oturum sil | `boolean` döndürür | +| `session.update({ path, body })` | Oturum özelliklerini güncelle | Session döndürür | +| `session.init({ path, body })` | Uygulamayı analiz et ve `AGENTS.md` oluştur | `boolean` döndürür | +| `session.abort({ path })` | Çalışan bir oturumu iptal et | `boolean` döndürür | +| `session.share({ path })` | Oturum paylaş | Session döndürür | +| `session.unshare({ path })` | Oturum paylaşımını kaldır | Session döndürür | +| `session.summarize({ path, body })` | Oturumu özetle | `boolean` döndürür | +| `session.messages({ path })` | Oturumdaki mesajları listele | `{ info: `Message`, parts: `Part[]`}[]` döndürür | +| `session.message({ path })` | Mesaj ayrıntılarını al | `{ info: `Message`, parts: `Part[]`}` döndürür | +| `session.prompt({ path, body })` | İstem mesajı gönder | `body.noReply: true` UserMessage (yalnızca bağlam) döndürür. Varsayılan olarak AI yanıtıyla AssistantMessage döndürür | +| `session.command({ path, body })` | Oturuma komut gönder | `{ info: `AssistantMessage`, parts: `Part[]`}` döndürür | +| `session.shell({ path, body })` | Bir kabuk komutu çalıştır | AssistantMessage döndürür | +| `session.revert({ path, body })` | Bir mesajı geri al | Session döndürür | +| `session.unrevert({ path })` | Geri alınan mesajları geri yükle | Session döndürür | +| `postSessionByIdPermissionsByPermissionId({ path, body })` | Bir izin isteğine yanıt ver | `boolean` döndürür | --- -#### Examples +#### Örnekler ```javascript // Create and manage sessions @@ -281,25 +281,25 @@ await client.session.prompt({ --- -### Files +### Dosyalar -| Method | Description | Response | -| ------------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------- | -| `find.text({ query })` | Search for text in files | Array of match objects with `path`, `lines`, `line_number`, `absolute_offset`, `submatches` | -| `find.files({ query })` | Find files and directories by name | `string[]` (paths) | -| `find.symbols({ query })` | Find workspace symbols | Symbol[] | -| `file.read({ query })` | Read a file | `{ type: "raw" \| "patch", content: string }` | -| `file.status({ query? })` | Get status for tracked files | File[] | +| Yöntem | Açıklama | Yanıt | +| ------------------------- | -------------------------------- | ----------------------------------------------------------------------------------------------- | +| `find.text({ query })` | Dosyalarda metin ara | `path`, `lines`, `line_number`, `absolute_offset`, `submatches` içeren eşleşme nesneleri dizisi | +| `find.files({ query })` | Dosya ve dizinleri isme göre bul | `string[]` (yollar) | +| `find.symbols({ query })` | Çalışma alanı sembollerini bul | Symbol[] | +| `file.read({ query })` | Bir dosyayı oku | `{ type: "raw" \| "patch", content: string }` | +| `file.status({ query? })` | İzlenen dosyalar için durumu al | File[] | -`find.files` supports a few optional query fields: +`find.files` birkaç isteğe bağlı sorgu alanını destekler: -- `type`: `"file"` or `"directory"` -- `directory`: override the project root for the search -- `limit`: max results (1-200) +- `type`: `"file"` veya `"directory"` +- `directory`: arama için proje kökünü geçersiz kılma +- `limit`: maksimum sonuç (1-200) --- -#### Examples +#### Örnekler ```javascript // Search and read files @@ -324,21 +324,21 @@ const content = await client.file.read({ ### TUI -| Method | Description | Response | -| ------------------------------ | ------------------------- | --------- | -| `tui.appendPrompt({ body })` | Append text to the prompt | `boolean` | -| `tui.openHelp()` | Open the help dialog | `boolean` | -| `tui.openSessions()` | Open the session selector | `boolean` | -| `tui.openThemes()` | Open the theme selector | `boolean` | -| `tui.openModels()` | Open the model selector | `boolean` | -| `tui.submitPrompt()` | Submit the current prompt | `boolean` | -| `tui.clearPrompt()` | Clear the prompt | `boolean` | -| `tui.executeCommand({ body })` | Execute a command | `boolean` | -| `tui.showToast({ body })` | Show toast notification | `boolean` | +| Yöntem | Açıklama | Yanıt | +| ------------------------------ | --------------------------- | --------- | +| `tui.appendPrompt({ body })` | İsteme metin ekle | `boolean` | +| `tui.openHelp()` | Yardım iletişim kutusunu aç | `boolean` | +| `tui.openSessions()` | Oturum seçiciyi aç | `boolean` | +| `tui.openThemes()` | Tema seçiciyi aç | `boolean` | +| `tui.openModels()` | Model seçiciyi aç | `boolean` | +| `tui.submitPrompt()` | Mevcut istemi gönder | `boolean` | +| `tui.clearPrompt()` | İstemi temizle | `boolean` | +| `tui.executeCommand({ body })` | Bir komut çalıştır | `boolean` | +| `tui.showToast({ body })` | Toast bildirimi göster | `boolean` | --- -#### Examples +#### Örnekler ```javascript // Control TUI interface @@ -355,13 +355,13 @@ await client.tui.showToast({ ### Auth -| Method | Description | Response | -| ------------------- | ------------------------------ | --------- | -| `auth.set({ ... })` | Set authentication credentials | `boolean` | +| Yöntem | Açıklama | Yanıt | +| ------------------- | ------------------------- | --------- | +| `auth.set({ ... })` | Kimlik bilgilerini ayarla | `boolean` | --- -#### Examples +#### Örnekler ```javascript await client.auth.set({ @@ -372,15 +372,15 @@ await client.auth.set({ --- -### Events +### Olaylar -| Method | Description | Response | -| ------------------- | ------------------------- | ------------------------- | -| `event.subscribe()` | Server-sent events stream | Server-sent events stream | +| Yöntem | Açıklama | Yanıt | +| ------------------- | --------------------------------------- | --------------------------------------- | +| `event.subscribe()` | Sunucu tarafından gönderilen olay akışı | Sunucu tarafından gönderilen olay akışı | --- -#### Examples +#### Örnekler ```javascript // Listen to real-time events diff --git a/packages/web/src/content/docs/tr/server.mdx b/packages/web/src/content/docs/tr/server.mdx index c3f7402f0..e9af6afd0 100644 --- a/packages/web/src/content/docs/tr/server.mdx +++ b/packages/web/src/content/docs/tr/server.mdx @@ -6,27 +6,27 @@ description: opencode sunucusuyla HTTP uzerinden etkilesin. import config from "../../../../config.mjs" export const typesUrl = `${config.github}/blob/dev/packages/sdk/js/src/gen/types.gen.ts` -`opencode serve` komutu, opencode istemcisinin kullanabilecegi bir OpenAPI endpoint'i acan headless bir HTTP sunucusu calistirir. +`opencode serve` komutu, opencode istemcisinin kullanabileceği bir OpenAPI endpoint'i açan headless bir HTTP sunucusu çalıştırır. --- -### Kullanim +### Kullanım ```bash opencode serve [--port ] [--hostname ] [--cors ] ``` -#### Secenekler +#### Seçenekler -| Flag | Description | Default | -| --------------- | ----------------------------------- | ---------------- | -| `--port` | Dinlenecek port | `4096` | -| `--hostname` | Dinlenecek host adı | `127.0.0.1` | -| `--mdns` | Enable mDNS discovery | `false` | -| `--mdns-domain` | Custom domain name for mDNS service | `opencode.local` | -| `--cors` | Additional browser origins to allow | `[]` | +| Bayrak | Açıklama | Varsayılan | +| --------------- | ---------------------------------------------- | ---------------- | +| `--port` | Dinlenecek bağlantı noktası | `4096` | +| `--hostname` | Dinlenecek ana bilgisayar adı | `127.0.0.1` | +| `--mdns` | mDNS keşfini etkinleştir | `false` | +| `--mdns-domain` | mDNS hizmeti için özel alan adı | `opencode.local` | +| `--cors` | İzin verilecek ek tarayıcı kaynakları (origin) | `[]` | -`--cors` birden fazla kez gecilebilir: +`--cors` birden fazla kez geçilebilir: ```bash opencode serve --cors http://localhost:5173 --cors https://app.example.com @@ -34,9 +34,9 @@ opencode serve --cors http://localhost:5173 --cors https://app.example.com --- -### Kimlik dogrulama +### Kimlik Doğrulama -Sunucuyu HTTP basic auth ile korumak icin `OPENCODE_SERVER_PASSWORD` ayarlayin. Kullanici adi varsayilan olarak `opencode` degeridir; degistirmek isterseniz `OPENCODE_SERVER_USERNAME` ayarlayabilirsiniz. Bu ayar hem `opencode serve` hem de `opencode web` icin gecerlidir. +Sunucuyu HTTP temel kimlik doğrulama (basic auth) ile korumak için `OPENCODE_SERVER_PASSWORD` ayarlayın. Kullanıcı adı varsayılan olarak `opencode` değeridir; değiştirmek isterseniz `OPENCODE_SERVER_USERNAME` ayarlayabilirsiniz. Bu ayar hem `opencode serve` hem de `opencode web` için geçerlidir. ```bash OPENCODE_SERVER_PASSWORD=your-password opencode serve @@ -44,242 +44,242 @@ OPENCODE_SERVER_PASSWORD=your-password opencode serve --- -### Nasil calisir +### Nasıl çalışır -`opencode` calistirdiginizda hem TUI hem de sunucu baslar. TUI, sunucuyla konusan istemci tarafidir. -Sunucu bir OpenAPI 3.1 spec endpoint'i acar. Bu endpoint [SDK](/docs/sdk) uretiminde de kullanilir. +`opencode` çalıştırdığınızda hem TUI hem de sunucu başlar. TUI, sunucuyla konuşan istemci tarafıdır. +Sunucu bir OpenAPI 3.1 spesifikasyon uç noktası açar. Bu uç nokta [SDK](/docs/sdk) üretiminde de kullanılır. :::tip -opencode ile programatik etkilesim icin opencode sunucusunu kullanin. +opencode ile programatik etkileşim için opencode sunucusunu kullanın. ::: -Bu mimari, opencode'un birden fazla istemciyi desteklemesini ve programatik kullanimlari mumkun kilmasini saglar. +Bu mimari, opencode'un birden fazla istemciyi desteklemesini ve programatik kullanımları mümkün kılmasını sağlar. -`opencode serve` ile bagimsiz bir sunucu baslatabilirsiniz. opencode TUI aciksa, `opencode serve` yeni bir sunucu baslatir. +`opencode serve` ile bağımsız bir sunucu başlatabilirsiniz. opencode TUI açıksa, `opencode serve` yeni bir sunucu başlatır. --- -#### Mevcut sunucuya baglanin +#### Mevcut sunucuya bağlanın -TUI baslarken rastgele bir port ve hostname atanir. Bunun yerine `--hostname` ve `--port` [bayraklarini](/docs/cli) verebilirsiniz. +TUI başlarken rastgele bir port ve hostname atanır. Bunun yerine `--hostname` ve `--port` [bayraklarını](/docs/cli) verebilirsiniz. -[`/tui`](#tui) endpoint'i sunucu uzerinden TUI'yi surmek icin kullanilabilir. Ornegin bir istemi onceden doldurabilir veya calistirabilirsiniz. Bu kurulum opencode [IDE](/docs/ide) eklentileri tarafindan kullanilir. +[`/tui`](#tui) uç noktası sunucu üzerinden TUI'yi sürmek için kullanılabilir. Örneğin bir istemi önceden doldurabilir veya çalıştırabilirsiniz. Bu kurulum opencode [IDE](/docs/ide) eklentileri tarafından kullanılır. --- ## Spesifikasyon -Sunucu, su adreste gorulebilen bir OpenAPI 3.1 spec yayinlar: +Sunucu, şu adreste görülebilen bir OpenAPI 3.1 spesifikasyonu yayınlar: ``` http://:/doc ``` -Ornegin `http://localhost:4096/doc`. Istemci olusturmak, istek/yanit tiplerini incelemek veya Swagger gezgininde acmak icin bu spec'i kullanin. +Örneğin `http://localhost:4096/doc`. İstemci oluşturmak, istek/yanit tiplerini incelemek veya Swagger gezgininde açmak için bu spec'i kullanın. --- ## API'ler -opencode sunucusu asagidaki API'leri sunar. +opencode sunucusu aşağıdaki API'leri sunar. --- ### Global -| Method | Path | Description | Response | -| ------ | ---------------- | ------------------------------ | ------------------------------------ | -| `GET` | `/global/health` | Get server health and version | `{ healthy: true, version: string }` | -| `GET` | `/global/event` | Get global events (SSE stream) | Event stream | +| Yöntem | Yol | Açıklama | Yanıt | +| ------ | ---------------- | ------------------------------- | ------------------------------------ | +| `GET` | `/global/health` | Sunucu sağlığını ve sürümünü al | `{ healthy: true, version: string }` | +| `GET` | `/global/event` | Küresel olayları al (SSE akışı) | Olay akışı | --- -### Project +### Proje -| Method | Path | Description | Response | -| ------ | ------------------ | ----------------------- | --------------------------------------------- | -| `GET` | `/project` | List all projects | Project[] | -| `GET` | `/project/current` | Get the current project | Project | +| Yöntem | Yol | Açıklama | Yanıt | +| ------ | ------------------ | --------------------- | --------------------------------------------- | +| `GET` | `/project` | Tüm projeleri listele | Project[] | +| `GET` | `/project/current` | Mevcut projeyi al | Project | --- -### Path & VCS +### Yol & VCS -| Method | Path | Description | Response | -| ------ | ------- | ------------------------------------ | ------------------------------------------- | -| `GET` | `/path` | Get the current path | Path | -| `GET` | `/vcs` | Get VCS info for the current project | VcsInfo | +| Yöntem | Yol | Açıklama | Yanıt | +| ------ | ------- | ---------------------------------- | ------------------------------------------- | +| `GET` | `/path` | Mevcut yolu al | Path | +| `GET` | `/vcs` | Mevcut proje için VCS bilgisini al | VcsInfo | --- -### Instance +### Örnek (Instance) -| Method | Path | Description | Response | -| ------ | ------------------- | ---------------------------- | --------- | -| `POST` | `/instance/dispose` | Dispose the current instance | `boolean` | +| Yöntem | Yol | Açıklama | Yanıt | +| ------ | ------------------- | ------------------------------ | --------- | +| `POST` | `/instance/dispose` | Mevcut örneği (instance) kapat | `boolean` | --- ### Config -| Method | Path | Description | Response | -| ------- | ------------------- | --------------------------------- | ---------------------------------------------------------------------------------------- | -| `GET` | `/config` | Get config info | Config | -| `PATCH` | `/config` | Update config | Config | -| `GET` | `/config/providers` | List providers and default models | `{ providers: `Provider[]`, default: { [key: string]: string } }` | +| Yöntem | Yol | Açıklama | Yanıt | +| ------- | ------------------- | --------------------------------------------- | ---------------------------------------------------------------------------------------- | +| `GET` | `/config` | Yapılandırma bilgisini al | Config | +| `PATCH` | `/config` | Yapılandırmayı güncelle | Config | +| `GET` | `/config/providers` | Sağlayıcıları ve varsayılan modelleri listele | `{ providers: `Provider[]`, default: { [key: string]: string } }` | --- -### Provider +### Sağlayıcı (Provider) -| Method | Path | Description | Response | -| ------ | -------------------------------- | ------------------------------------ | ----------------------------------------------------------------------------------- | -| `GET` | `/provider` | List all providers | `{ all: `Provider[]`, default: {...}, connected: string[] }` | -| `GET` | `/provider/auth` | Get provider authentication methods | `{ [providerID: string]: `ProviderAuthMethod[]` }` | -| `POST` | `/provider/{id}/oauth/authorize` | Authorize a provider using OAuth | ProviderAuthAuthorization | -| `POST` | `/provider/{id}/oauth/callback` | Handle OAuth callback for a provider | `boolean` | +| Yöntem | Yol | Açıklama | Yanıt | +| ------ | -------------------------------- | -------------------------------------------- | ----------------------------------------------------------------------------------- | +| `GET` | `/provider` | Tüm sağlayıcıları listele | `{ all: `Provider[]`, default: {...}, connected: string[] }` | +| `GET` | `/provider/auth` | Sağlayıcı kimlik doğrulama yöntemlerini al | `{ [providerID: string]: `ProviderAuthMethod[]` }` | +| `POST` | `/provider/{id}/oauth/authorize` | OAuth kullanarak bir sağlayıcıyı yetkilendir | ProviderAuthAuthorization | +| `POST` | `/provider/{id}/oauth/callback` | Bir sağlayıcı için OAuth geri çağrısını işle | `boolean` | --- -### Sessions +### Oturumlar (Sessions) -| Method | Path | Description | Notes | -| -------- | ---------------------------------------- | ------------------------------------- | ---------------------------------------------------------------------------------- | -| `GET` | `/session` | List all sessions | Returns Session[] | -| `POST` | `/session` | Create a new session | body: `{ parentID?, title? }`, returns Session | -| `GET` | `/session/status` | Get session status for all sessions | Returns `{ [sessionID: string]: `SessionStatus` }` | -| `GET` | `/session/:id` | Get session details | Returns Session | -| `DELETE` | `/session/:id` | Delete a session and all its data | Returns `boolean` | -| `PATCH` | `/session/:id` | Update session properties | body: `{ title? }`, returns Session | -| `GET` | `/session/:id/children` | Get a session's child sessions | Returns Session[] | -| `GET` | `/session/:id/todo` | Get the todo list for a session | Returns Todo[] | -| `POST` | `/session/:id/init` | Analyze app and create `AGENTS.md` | body: `{ messageID, providerID, modelID }`, returns `boolean` | -| `POST` | `/session/:id/fork` | Fork an existing session at a message | body: `{ messageID? }`, returns Session | -| `POST` | `/session/:id/abort` | Abort a running session | Returns `boolean` | -| `POST` | `/session/:id/share` | Share a session | Returns Session | -| `DELETE` | `/session/:id/share` | Unshare a session | Returns Session | -| `GET` | `/session/:id/diff` | Get the diff for this session | query: `messageID?`, returns FileDiff[] | -| `POST` | `/session/:id/summarize` | Summarize the session | body: `{ providerID, modelID }`, returns `boolean` | -| `POST` | `/session/:id/revert` | Revert a message | body: `{ messageID, partID? }`, returns `boolean` | -| `POST` | `/session/:id/unrevert` | Restore all reverted messages | Returns `boolean` | -| `POST` | `/session/:id/permissions/:permissionID` | Respond to a permission request | body: `{ response, remember? }`, returns `boolean` | +| Yöntem | Yol | Açıklama | Notlar | +| -------- | ---------------------------------------- | ------------------------------------------- | ------------------------------------------------------------------------------------ | +| `GET` | `/session` | Tüm oturumları listele | Session[] döndürür | +| `POST` | `/session` | Yeni bir oturum oluştur | gövde: `{ parentID?, title? }`, Session döndürür | +| `GET` | `/session/status` | Tüm oturumlar için durumu al | `{ [sessionID: string]: `SessionStatus` }` döndürür | +| `GET` | `/session/:id` | Oturum ayrıntılarını al | Session döndürür | +| `DELETE` | `/session/:id` | Bir oturumu ve tüm verilerini sil | `boolean` döndürür | +| `PATCH` | `/session/:id` | Oturum özelliklerini güncelle | gövde: `{ title? }`, Session döndürür | +| `GET` | `/session/:id/children` | Bir oturumun alt oturumlarını al | Session[] döndürür | +| `GET` | `/session/:id/todo` | Bir oturum için yapılacaklar listesini al | Todo[] döndürür | +| `POST` | `/session/:id/init` | Uygulamayı analiz et ve `AGENTS.md` oluştur | gövde: `{ messageID, providerID, modelID }`, `boolean` döndürür | +| `POST` | `/session/:id/fork` | Mevcut bir oturumu bir mesajda çatalla | gövde: `{ messageID? }`, Session döndürür | +| `POST` | `/session/:id/abort` | Çalışan bir oturumu iptal et | `boolean` döndürür | +| `POST` | `/session/:id/share` | Bir oturumu paylaş | Session döndürür | +| `DELETE` | `/session/:id/share` | Bir oturumun paylaşımını kaldır | Session döndürür | +| `GET` | `/session/:id/diff` | Bu oturum için farkı (diff) al | sorgu: `messageID?`, FileDiff[] döndürür | +| `POST` | `/session/:id/summarize` | Oturumu özetle | gövde: `{ providerID, modelID }`, `boolean` döndürür | +| `POST` | `/session/:id/revert` | Bir mesajı geri al | gövde: `{ messageID, partID? }`, `boolean` döndürür | +| `POST` | `/session/:id/unrevert` | Geri alınan tüm mesajları geri yükle | `boolean` döndürür | +| `POST` | `/session/:id/permissions/:permissionID` | Bir izin isteğine yanıt ver | gövde: `{ response, remember? }`, `boolean` döndürür | --- -### Messages +### Mesajlar -| Method | Path | Description | Notes | -| ------ | --------------------------------- | --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `GET` | `/session/:id/message` | List messages in a session | query: `limit?`, returns `{ info: `Message`, parts: `Part[]`}[]` | -| `POST` | `/session/:id/message` | Send a message and wait for response | body: `{ messageID?, model?, agent?, noReply?, system?, tools?, parts }`, returns `{ info: `Message`, parts: `Part[]`}` | -| `GET` | `/session/:id/message/:messageID` | Get message details | Returns `{ info: `Message`, parts: `Part[]`}` | -| `POST` | `/session/:id/prompt_async` | Send a message asynchronously (no wait) | body: same as `/session/:id/message`, returns `204 No Content` | -| `POST` | `/session/:id/command` | Execute a slash command | body: `{ messageID?, agent?, model?, command, arguments }`, returns `{ info: `Message`, parts: `Part[]`}` | -| `POST` | `/session/:id/shell` | Run a shell command | body: `{ agent, model?, command }`, returns `{ info: `Message`, parts: `Part[]`}` | +| Yöntem | Yol | Açıklama | Notlar | +| ------ | --------------------------------- | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `GET` | `/session/:id/message` | Bir oturumdaki mesajları listele | sorgu: `limit?`, `{ info: `Message`, parts: `Part[]`}[]` döndürür | +| `POST` | `/session/:id/message` | Bir mesaj gönder ve yanıt bekle | gövde: `{ messageID?, model?, agent?, noReply?, system?, tools?, parts }`, `{ info: `Message`, parts: `Part[]`}` döndürür | +| `GET` | `/session/:id/message/:messageID` | Mesaj ayrıntılarını al | `{ info: `Message`, parts: `Part[]`}` döndürür | +| `POST` | `/session/:id/prompt_async` | Eşzamansız bir mesaj gönder (bekleme yok) | gövde: `/session/:id/message` ile aynı, `204 No Content` döndürür | +| `POST` | `/session/:id/command` | Bir eğik çizgi (slash) komutu çalıştır | gövde: `{ messageID?, agent?, model?, command, arguments }`, `{ info: `Message`, parts: `Part[]`}` döndürür | +| `POST` | `/session/:id/shell` | Bir kabuk komutu çalıştır | gövde: `{ agent, model?, command }`, `{ info: `Message`, parts: `Part[]`}` döndürür | --- -### Commands +### Komutlar -| Method | Path | Description | Response | -| ------ | ---------- | ----------------- | --------------------------------------------- | -| `GET` | `/command` | List all commands | Command[] | +| Yöntem | Yol | Açıklama | Yanıt | +| ------ | ---------- | --------------------- | --------------------------------------------- | +| `GET` | `/command` | Tüm komutları listele | Command[] | --- -### Files +### Dosyalar -| Method | Path | Description | Response | -| ------ | ------------------------ | ---------------------------------- | ------------------------------------------------------------------------------------------- | -| `GET` | `/find?pattern=` | Search for text in files | Array of match objects with `path`, `lines`, `line_number`, `absolute_offset`, `submatches` | -| `GET` | `/find/file?query=` | Find files and directories by name | `string[]` (paths) | -| `GET` | `/find/symbol?query=` | Find workspace symbols | Symbol[] | -| `GET` | `/file?path=` | List files and directories | FileNode[] | -| `GET` | `/file/content?path=

` | Read a file | FileContent | -| `GET` | `/file/status` | Get status for tracked files | File[] | +| Yöntem | Yol | Açıklama | Yanıt | +| ------ | ------------------------ | -------------------------------- | ----------------------------------------------------------------------------------------------- | +| `GET` | `/find?pattern=` | Dosyalarda metin ara | `path`, `lines`, `line_number`, `absolute_offset`, `submatches` içeren eşleşme nesneleri dizisi | +| `GET` | `/find/file?query=` | Dosya ve dizinleri isme göre bul | `string[]` (yollar) | +| `GET` | `/find/symbol?query=` | Çalışma alanı sembollerini bul | Symbol[] | +| `GET` | `/file?path=` | Dosya ve dizinleri listele | FileNode[] | +| `GET` | `/file/content?path=

` | Bir dosyayı oku | FileContent | +| `GET` | `/file/status` | İzlenen dosyalar için durumu al | File[] | -#### `/find/file` query parametreleri +#### `/find/file` sorgu parametreleri -- `query` (required) - arama metni (fuzzy match) -- `type` (optional) - sonuclari `"file"` veya `"directory"` ile sinirlama -- `directory` (optional) - arama icin proje kokunu gecersiz kilma -- `limit` (optional) - en fazla sonuc (1-200) -- `dirs` (optional) - eski bayrak (`"false"` sadece dosyalari dondurur) +- `query` (gerekli) - arama metni (bulanık eşleşme) +- `type` (isteğe bağlı) - sonuçları `"file"` veya `"directory"` ile sınırlama +- `directory` (isteğe bağlı) - arama için proje kökünü geçersiz kılma +- `limit` (isteğe bağlı) - en fazla sonuç (1-200) +- `dirs` (isteğe bağlı) - eski bayrak (`"false"` sadece dosyaları döndürür) --- -### Tools (Deneysel) +### Araçlar (Deneysel) -| Method | Path | Description | Response | -| ------ | ------------------------------------------- | ---------------------------------------- | -------------------------------------------- | -| `GET` | `/experimental/tool/ids` | List all tool IDs | ToolIDs | -| `GET` | `/experimental/tool?provider=

&model=` | List tools with JSON schemas for a model | ToolList | +| Yöntem | Yol | Açıklama | Yanıt | +| ------ | ------------------------------------------- | ------------------------------------------------ | -------------------------------------------- | +| `GET` | `/experimental/tool/ids` | Tüm araç kimliklerini listele | ToolIDs | +| `GET` | `/experimental/tool?provider=

&model=` | Bir model için araçları JSON şemalarıyla listele | ToolList | --- -### LSP, Formatters & MCP +### LSP, Biçimlendiriciler & MCP -| Method | Path | Description | Response | -| ------ | ------------ | -------------------------- | -------------------------------------------------------- | -| `GET` | `/lsp` | Get LSP server status | LSPStatus[] | -| `GET` | `/formatter` | Get formatter status | FormatterStatus[] | -| `GET` | `/mcp` | Get MCP server status | `{ [name: string]: `MCPStatus` }` | -| `POST` | `/mcp` | Add MCP server dynamically | body: `{ name, config }`, returns MCP status object | +| Yöntem | Yol | Açıklama | Yanıt | +| ------ | ------------ | -------------------------------- | -------------------------------------------------------- | +| `GET` | `/lsp` | LSP sunucu durumunu al | LSPStatus[] | +| `GET` | `/formatter` | Biçimlendirici durumunu al | FormatterStatus[] | +| `GET` | `/mcp` | MCP sunucu durumunu al | `{ [name: string]: `MCPStatus` }` | +| `POST` | `/mcp` | Dinamik olarak MCP sunucusu ekle | gövde: `{ name, config }`, MCP durum nesnesi döndürür | --- -### Agents +### Agent'lar -| Method | Path | Description | Response | -| ------ | -------- | ------------------------- | ------------------------------------------- | -| `GET` | `/agent` | List all available agents | Agent[] | +| Yöntem | Yol | Açıklama | Yanıt | +| ------ | -------- | ----------------------------- | ------------------------------------------- | +| `GET` | `/agent` | Tüm mevcut agent'ları listele | Agent[] | --- -### Logging +### Günlük (Logging) -| Method | Path | Description | Response | -| ------ | ------ | ------------------------------------------------------------ | --------- | -| `POST` | `/log` | Write log entry. Body: `{ service, level, message, extra? }` | `boolean` | +| Yöntem | Yol | Açıklama | Yanıt | +| ------ | ------ | ---------------------------------------------------------------- | --------- | +| `POST` | `/log` | Günlük girdisi yaz. Gövde: `{ service, level, message, extra? }` | `boolean` | --- ### TUI -| Method | Path | Description | Response | -| ------ | ----------------------- | ------------------------------------------- | ---------------------- | -| `POST` | `/tui/append-prompt` | Append text to the prompt | `boolean` | -| `POST` | `/tui/open-help` | Open the help dialog | `boolean` | -| `POST` | `/tui/open-sessions` | Open the session selector | `boolean` | -| `POST` | `/tui/open-themes` | Open the theme selector | `boolean` | -| `POST` | `/tui/open-models` | Open the model selector | `boolean` | -| `POST` | `/tui/submit-prompt` | Submit the current prompt | `boolean` | -| `POST` | `/tui/clear-prompt` | Clear the prompt | `boolean` | -| `POST` | `/tui/execute-command` | Execute a command (`{ command }`) | `boolean` | -| `POST` | `/tui/show-toast` | Show toast (`{ title?, message, variant }`) | `boolean` | -| `GET` | `/tui/control/next` | Wait for the next control request | Control request object | -| `POST` | `/tui/control/response` | Respond to a control request (`{ body }`) | `boolean` | +| Yöntem | Yol | Açıklama | Yanıt | +| ------ | ----------------------- | ------------------------------------------------------- | ---------------------- | +| `POST` | `/tui/append-prompt` | İsteme metin ekle | `boolean` | +| `POST` | `/tui/open-help` | Yardım iletişim kutusunu aç | `boolean` | +| `POST` | `/tui/open-sessions` | Oturum seçiciyi aç | `boolean` | +| `POST` | `/tui/open-themes` | Tema seçiciyi aç | `boolean` | +| `POST` | `/tui/open-models` | Model seçiciyi aç | `boolean` | +| `POST` | `/tui/submit-prompt` | Mevcut istemi gönder | `boolean` | +| `POST` | `/tui/clear-prompt` | İstemi temizle | `boolean` | +| `POST` | `/tui/execute-command` | Bir komut çalıştır (`{ command }`) | `boolean` | +| `POST` | `/tui/show-toast` | Toast bildirimi göster (`{ title?, message, variant }`) | `boolean` | +| `GET` | `/tui/control/next` | Bir sonraki kontrol isteğini bekle | Kontrol isteği nesnesi | +| `POST` | `/tui/control/response` | Bir kontrol isteğine yanıt ver (`{ body }`) | `boolean` | --- -### Auth +### Kimlik Doğrulama (Auth) -| Method | Path | Description | Response | -| ------ | ----------- | --------------------------------------------------------------- | --------- | -| `PUT` | `/auth/:id` | Set authentication credentials. Body must match provider schema | `boolean` | +| Yöntem | Yol | Açıklama | Yanıt | +| ------ | ----------- | ----------------------------------------------------------------- | --------- | +| `PUT` | `/auth/:id` | Kimlik bilgilerini ayarla. Gövde sağlayıcı şemasıyla eşleşmelidir | `boolean` | --- -### Events +### Olaylar (Events) -| Method | Path | Description | Response | -| ------ | -------- | ----------------------------------------------------------------------------- | ------------------------- | -| `GET` | `/event` | Server-sent events stream. First event is `server.connected`, then bus events | Server-sent events stream | +| Yöntem | Yol | Açıklama | Yanıt | +| ------ | -------- | ------------------------------------------------------------------------------------------------------ | --------------------------------------- | +| `GET` | `/event` | Sunucu tarafından gönderilen olay akışı (SSE). İlk olay `server.connected`, ardından veriyolu olayları | Sunucu tarafından gönderilen olay akışı | --- -### Docs +### Dokümanlar (Docs) -| Method | Path | Description | Response | -| ------ | ------ | ------------------------- | --------------------------- | -| `GET` | `/doc` | OpenAPI 3.1 specification | HTML page with OpenAPI spec | +| Yöntem | Yol | Açıklama | Yanıt | +| ------ | ------ | -------------------------- | -------------------------------- | +| `GET` | `/doc` | OpenAPI 3.1 spesifikasyonu | OpenAPI spec içeren HTML sayfası | diff --git a/packages/web/src/content/docs/tr/themes.mdx b/packages/web/src/content/docs/tr/themes.mdx index 68809957c..93911315f 100644 --- a/packages/web/src/content/docs/tr/themes.mdx +++ b/packages/web/src/content/docs/tr/themes.mdx @@ -1,67 +1,67 @@ --- title: Temalar -description: Yerlesik bir tema secin veya kendiniz olusturun. +description: Yerleşik bir tema seçin veya kendiniz oluşturun. --- -opencode ile birden fazla yerlesik tema arasindan secim yapabilir, terminal temaniza uyum saglayan bir tema kullanabilir veya kendi ozel temanizi tanimlayabilirsiniz. +opencode ile birden fazla yerleşik tema arasından seçim yapabilir, terminal temanıza uyum sağlayan bir tema kullanabilir veya kendi özel temanızı tanımlayabilirsiniz. -Varsayilan olarak opencode kendi `opencode` temasini kullanir. +Varsayılan olarak opencode kendi `opencode` temasını kullanır. --- ## Terminal gereksinimleri -Temalarin tum renk paletiyle dogru gorunmesi icin terminalinizin **truecolor** (24-bit renk) desteklemesi gerekir. Cogu modern terminal bunu varsayilan olarak destekler, ancak gerekirse etkinlestirmeniz gerekebilir: +Temaların tüm renk paletiyle doğru görünmesi için terminalinizin **truecolor** (24-bit renk) desteklemesi gerekir. Çoğu modern terminal bunu varsayılan olarak destekler, ancak gerekirse etkinleştirmeniz gerekebilir: -- **Destegi kontrol edin**: `echo $COLORTERM` calistirin - cikti `truecolor` veya `24bit` olmalidir -- **Truecolor etkinlestirin**: kabuk profilinizde `COLORTERM=truecolor` ortam degiskenini ayarlayin -- **Terminal uyumlulugu**: terminal emulatorunuzun 24-bit rengi desteklediginden emin olun (iTerm2, Alacritty, Kitty, Windows Terminal ve GNOME Terminal'in yeni surumleri gibi modern terminaller genelde destekler) +- **Desteği kontrol edin**: `echo $COLORTERM` çalıştırın - çıktı `truecolor` veya `24bit` olmalıdır +- **Truecolor etkinleştirin**: kabuk profilinizde `COLORTERM=truecolor` ortam değişkenini ayarlayın +- **Terminal uyumluluğu**: terminal emülatörünüzün 24-bit rengi desteklediğinden emin olun (iTerm2, Alacritty, Kitty, Windows Terminal ve GNOME Terminal'in yeni sürümleri gibi modern terminaller genelde destekler) -Truecolor destegi yoksa temalar daha dusuk renk dogrulugu ile gorunebilir veya en yakin 256 renk yaklasimina dusebilir. +Truecolor desteği yoksa temalar daha düşük renk doğruluğu ile görünebilir veya en yakın 256 renk yaklaşımına düşebilir. --- -## Yerlesik temalar +## Yerleşik temalar -opencode birden fazla yerlesik temayla gelir. +opencode birden fazla yerleşik temayla gelir. -| Ad | Aciklama | +| Ad | Açıklama | | ---------------------- | ----------------------------------------------------------------------------- | -| `system` | Terminalinizin arka plan rengine uyum saglar | -| `tokyonight` | [tokyonight](https://github.com/folke/tokyonight.nvim) temasini temel alir | -| `everforest` | [Everforest](https://github.com/sainnhe/everforest) temasini temel alir | -| `ayu` | [Ayu](https://github.com/ayu-theme) koyu temasini temel alir | -| `catppuccin` | [Catppuccin](https://github.com/catppuccin) temasini temel alir | -| `catppuccin-macchiato` | [Catppuccin](https://github.com/catppuccin) temasini temel alir | -| `gruvbox` | [Gruvbox](https://github.com/morhetz/gruvbox) temasini temel alir | -| `kanagawa` | [Kanagawa](https://github.com/rebelot/kanagawa.nvim) temasini temel alir | -| `nord` | [Nord](https://github.com/nordtheme/nord) temasini temel alir | -| `matrix` | Hacker tarzi yesil uzerine siyah tema | -| `one-dark` | [Atom One](https://github.com/Th3Whit3Wolf/one-nvim) Dark temasini temel alir | +| `system` | Terminalinizin arka plan rengine uyum sağlar | +| `tokyonight` | [tokyonight](https://github.com/folke/tokyonight.nvim) temasını temel alır | +| `everforest` | [Everforest](https://github.com/sainnhe/everforest) temasını temel alır | +| `ayu` | [Ayu](https://github.com/ayu-theme) koyu temasını temel alır | +| `catppuccin` | [Catppuccin](https://github.com/catppuccin) temasını temel alır | +| `catppuccin-macchiato` | [Catppuccin](https://github.com/catppuccin) temasını temel alır | +| `gruvbox` | [Gruvbox](https://github.com/morhetz/gruvbox) temasını temel alır | +| `kanagawa` | [Kanagawa](https://github.com/rebelot/kanagawa.nvim) temasını temel alır | +| `nord` | [Nord](https://github.com/nordtheme/nord) temasını temel alır | +| `matrix` | Hacker tarzı yeşil üzerine siyah tema | +| `one-dark` | [Atom One](https://github.com/Th3Whit3Wolf/one-nvim) Dark temasını temel alır | -Ve daha fazlasi; surekli yeni temalar ekliyoruz. +Ve daha fazlası; sürekli yeni temalar ekliyoruz. --- -## Sistem temasi +## Sistem teması -`system` temasi, terminalinizin renk duzenine otomatik uyum saglamak icin tasarlanmistir. Sabit renk kullanan klasik temalardan farkli olarak _system_ temasi: +`system` teması, terminalinizin renk düzenine otomatik uyum sağlamak için tasarlanmıştır. Sabit renk kullanan klasik temalardan farklı olarak _system_ teması: -- **Gri olcegi uretir**: En iyi kontrast icin terminal arka planina gore ozel gri tonlari olusturur -- **ANSI renkleri kullanir**: 0-15 arasi standart ANSI renklerini syntax highlighting ve UI ogelerinde kullanir, boylece terminal paletinize uyar -- **Terminal varsayilanlarini korur**: Metin ve arka plan renklerinde `none` kullanarak terminalin yerel gorunumunu korur +- **Gri ölçeği üretir**: En iyi kontrast için terminal arka planına göre özel gri tonları oluşturur +- **ANSI renkleri kullanır**: 0-15 arası standart ANSI renklerini syntax highlighting ve UI öğelerinde kullanır, böylece terminal paletinize uyar +- **Terminal varsayılanlarını korur**: Metin ve arka plan renklerinde `none` kullanarak terminalin yerel görünümünü korur -Sistem temasi su kullanicilar icin idealdir: +Sistem teması şu kullanıcılar için idealdir: -- opencode'un terminal gorunumuyle birebir uyumlu olmasini isteyenler -- Ozel terminal renk semalari kullananlar -- Tum terminal uygulamalarinda tutarli bir gorunum tercih edenler +- opencode'un terminal görünümüyle birebir uyumlu olmasını isteyenler +- Özel terminal renk şemaları kullananlar +- Tüm terminal uygulamalarında tutarlı bir görünüm tercih edenler --- -## Tema kullanin +## Tema kullanımı -`/theme` komutuyla tema secicisini acip tema secebilirsiniz. Isterseniz [config](/docs/config) dosyanizda da belirtebilirsiniz. +`/theme` komutuyla tema seçicisini açıp tema seçebilirsiniz. İsterseniz [config](/docs/config) dosyanızda da belirtebilirsiniz. ```json title="opencode.json" {3} { @@ -72,37 +72,37 @@ Sistem temasi su kullanicilar icin idealdir: --- -## Ozel temalar +## Özel temalar -opencode, kullanicilarin kolayca tema olusturup ozellestirebilmesi icin esnek bir JSON tabanli tema sistemi sunar. +opencode, kullanıcıların kolayca tema oluşturup özelleştirebilmesi için esnek bir JSON tabanlı tema sistemi sunar. --- -### Hiyerarsi +### Hiyerarşi -Temalar birden fazla dizinden su sirayla yuklenir; daha sonra gelen dizin oncekini ezer: +Temalar birden fazla dizinden şu sırayla yüklenir; daha sonra gelen dizin öncekini ezer: -1. **Yerlesik temalar** - Binary icine gomuludur -2. **Kullanici config dizini** - `~/.config/opencode/themes/*.json` veya `$XDG_CONFIG_HOME/opencode/themes/*.json` -3. **Proje kok dizini** - `/.opencode/themes/*.json` -4. **Gecerli calisma dizini** - `./.opencode/themes/*.json` +1. **Yerleşik temalar** - Binary içine gömülüdür +2. **Kullanıcı yapılandırma dizini** - `~/.config/opencode/themes/*.json` veya `$XDG_CONFIG_HOME/opencode/themes/*.json` +3. **Proje kök dizini** - `/.opencode/themes/*.json` +4. **Geçerli çalışma dizini** - `./.opencode/themes/*.json` -Birden fazla dizinde ayni adli tema varsa, onceligi daha yuksek dizindeki tema kullanilir. +Birden fazla dizinde aynı adlı tema varsa, önceliği daha yüksek dizindeki tema kullanılır. --- -### Tema olusturun +### Tema oluşturma -Ozel tema olusturmak icin tema dizinlerinden birinde bir JSON dosyasi olusturun. +Özel tema oluşturmak için tema dizinlerinden birinde bir JSON dosyası oluşturun. -Kullanici geneli temalar icin: +Kullanıcı geneli temalar için: ```bash no-frame mkdir -p ~/.config/opencode/themes vim ~/.config/opencode/themes/my-theme.json ``` -Proje ozel temalar icin: +Proje özel temalar için: ```bash no-frame mkdir -p .opencode/themes @@ -111,36 +111,36 @@ vim .opencode/themes/my-theme.json --- -### JSON formati +### JSON formatı -Temalar asagidaki ozellikleri destekleyen esnek bir JSON formati kullanir: +Temalar aşağıdaki özellikleri destekleyen esnek bir JSON formatı kullanır: - **Hex renkler**: `"#ffffff"` - **ANSI renkler**: `3` (0-255) -- **Renk referanslari**: `"primary"` veya ozel tanimlar -- **Koyu/acik varyantlar**: `{"dark": "#000", "light": "#fff"}` -- **Renk yok**: `"none"` - Terminal varsayilan rengi veya seffaflik kullanilir +- **Renk referansları**: `"primary"` veya özel tanımlar +- **Koyu/açık varyantlar**: `{"dark": "#000", "light": "#fff"}` +- **Renk yok**: `"none"` - Terminal varsayılan rengi veya şeffaflık kullanılır --- -### Renk tanimlari +### Renk tanımları -`defs` bolumu istege baglidir ve tema icinde tekrar kullanilabilir renkler tanimlamanizi saglar. +`defs` bölümü isteğe bağlıdır ve tema içinde tekrar kullanılabilir renkler tanımlamanızı sağlar. --- -### Terminal varsayilanlari +### Terminal varsayılanları -Ozel `"none"` degeri, terminalin varsayilan rengini miras almak icin herhangi bir renkte kullanilabilir. Bu, terminalinizin renk semasiyla dogal sekilde butunlesen temalar olustururken ozellikle faydalidir: +Özel `"none"` değeri, terminalin varsayılan rengini miras almak için herhangi bir renkte kullanılabilir. Bu, terminalinizin renk şemasıyla doğal şekilde bütünleşen temalar oluştururken özellikle faydalıdır: -- `"text": "none"` - Terminalin varsayilan on plan rengini kullanir -- `"background": "none"` - Terminalin varsayilan arka plan rengini kullanir +- `"text": "none"` - Terminalin varsayılan ön plan rengini kullanır +- `"background": "none"` - Terminalin varsayılan arka plan rengini kullanır --- -### Ornek +### Örnek -Asagida ozel bir tema ornegi var: +Aşağıda özel bir tema örneği var: ```json title="my-theme.json" { diff --git a/packages/web/src/content/docs/tr/tools.mdx b/packages/web/src/content/docs/tr/tools.mdx index 04a4b9f93..2eded12d3 100644 --- a/packages/web/src/content/docs/tr/tools.mdx +++ b/packages/web/src/content/docs/tr/tools.mdx @@ -1,17 +1,17 @@ --- -title: Araclar -description: LLM'in kullanabilecegi araclari yonetin. +title: Araçlar +description: LLM'in kullanabileceği araçları yönetin. --- -Araclar, LLM'in kod tabaninizda eylem gerceklestirmesini saglar. opencode yerlesik bir arac setiyle gelir, ancak bunu [ozel araclarla](/docs/custom-tools) veya [MCP sunuculariyla](/docs/mcp-servers) genisletebilirsiniz. +Araçlar, LLM'in kod tabanınızda eylem gerçekleştirmesini sağlar. opencode yerleşik bir araç setiyle gelir, ancak bunu [özel araçlarla](/docs/custom-tools) veya [MCP sunucularıyla](/docs/mcp-servers) genişletebilirsiniz. -Varsayilan olarak tum araclar **etkindir** ve calismak icin izin istemez. Arac davranisini [izinler](/docs/permissions) uzerinden kontrol edebilirsiniz. +Varsayılan olarak tüm araçlar **etkindir** ve çalışmak için izin istemez. Araç davranışını [izinler](/docs/permissions) üzerinden kontrol edebilirsiniz. --- -## Yapilandirin +## Yapılandırma -Arac davranisini kontrol etmek icin `permission` alanini kullanin. Her arac icin izin verebilir, reddedebilir veya onay isteyebilirsiniz. +Araç davranışını kontrol etmek için `permission` alanını kullanın. Her araç için izin verebilir, reddedebilir veya onay isteyebilirsiniz. ```json title="opencode.json" { @@ -24,7 +24,7 @@ Arac davranisini kontrol etmek icin `permission` alanini kullanin. Her arac icin } ``` -Birden fazla araci ayni anda kontrol etmek icin wildcard da kullanabilirsiniz. Ornegin, bir MCP sunucusundan gelen tum araclar icin onay istemek: +Birden fazla aracı aynı anda kontrol etmek için joker karakterler de kullanabilirsiniz. Örneğin, bir MCP sunucusundan gelen tüm araçlar için onay istemek: ```json title="opencode.json" { @@ -35,19 +35,19 @@ Birden fazla araci ayni anda kontrol etmek icin wildcard da kullanabilirsiniz. O } ``` -Izin yapilandirmasi icin [daha fazla bilgi alin](/docs/permissions). +İzin yapılandırması için [daha fazla bilgi alın](/docs/permissions). --- -## Yerlesik +## Yerleşik -opencode icinde bulunan tum yerlesik araclar asagidadir. +opencode içinde bulunan tüm yerleşik araçlar aşağıdadır. --- ### bash -Proje ortaminizda kabuk komutlari calistirir. +Proje ortamınızda kabuk komutları çalıştırır. ```json title="opencode.json" {4} { @@ -58,13 +58,13 @@ Proje ortaminizda kabuk komutlari calistirir. } ``` -Bu arac LLM'in `npm install`, `git status` gibi terminal komutlarini veya diger kabuk komutlarini calistirmasini saglar. +Bu araç LLM'in `npm install`, `git status` gibi terminal komutlarını veya diğer kabuk komutlarını çalıştırmasını sağlar. --- ### edit -Birebir metin degistirme ile mevcut dosyalari duzenler. +Birebir metin değiştirme ile mevcut dosyaları düzenler. ```json title="opencode.json" {4} { @@ -75,13 +75,13 @@ Birebir metin degistirme ile mevcut dosyalari duzenler. } ``` -Bu arac dosyalarda kesin metin eslesmelerini degistirerek hassas duzenleme yapar. LLM'in kodu degistirmek icin kullandigi temel yontemdir. +Bu araç dosyalarda kesin metin eşleşmelerini değiştirerek hassas düzenleme yapar. LLM'in kodu değiştirmek için kullandığı temel yöntemdir. --- ### write -Yeni dosyalar olusturur veya mevcut dosyalari uzerine yazar. +Yeni dosyalar oluşturur veya mevcut dosyaları üzerine yazar. ```json title="opencode.json" {4} { @@ -92,17 +92,17 @@ Yeni dosyalar olusturur veya mevcut dosyalari uzerine yazar. } ``` -LLM'in yeni dosya olusturmasina izin vermek icin bunu kullanin. Dosya zaten varsa uzerine yazar. +LLM'in yeni dosya oluşturmasına izin vermek için bunu kullanın. Dosya zaten varsa üzerine yazar. :::note -`write` araci `edit` izniyle kontrol edilir; bu izin tum dosya degisikliklerini kapsar (`edit`, `write`, `patch`, `multiedit`). +`write` aracı `edit` izniyle kontrol edilir; bu izin tüm dosya değişikliklerini kapsar (`edit`, `write`, `patch`, `multiedit`). ::: --- ### read -Kod tabaninizdan dosya icerigi okur. +Kod tabanınızdan dosya içeriği okur. ```json title="opencode.json" {4} { @@ -113,13 +113,13 @@ Kod tabaninizdan dosya icerigi okur. } ``` -Bu arac dosyalari okur ve iceriklerini dondurur. Buyuk dosyalar icin belirli satir araliklarini okuma destegi vardir. +Bu araç dosyaları okur ve içeriklerini döndürür. Büyük dosyalar için belirli satır aralıklarını okuma desteği vardır. --- ### grep -Duzensiz ifadelerle dosya iceriginde arama yapar. +Düzenli ifadelerle dosya içeriğinde arama yapar. ```json title="opencode.json" {4} { @@ -130,13 +130,13 @@ Duzensiz ifadelerle dosya iceriginde arama yapar. } ``` -Kod tabaninda hizli icerik aramasi sunar. Tam regex sozdizimini ve dosya desen filtrelerini destekler. +Kod tabanında hızlı içerik araması sunar. Tam regex sözdizimini ve dosya desen filtrelerini destekler. --- ### glob -Desen eslestirme ile dosya bulur. +Desen eşleştirme ile dosya bulur. ```json title="opencode.json" {4} { @@ -147,7 +147,7 @@ Desen eslestirme ile dosya bulur. } ``` -`**/*.js` veya `src/**/*.ts` gibi glob desenleriyle dosya arar. Eslesen dosya yollarini degisim zamanina gore siralar. +`**/*.js` veya `src/**/*.ts` gibi glob desenleriyle dosya arar. Eşleşen dosya yollarını değişim zamanına göre sıralar. --- @@ -164,16 +164,16 @@ Verilen yoldaki dosya ve dizinleri listeler. } ``` -Bu arac dizin icerigini listeler. Sonuclari filtrelemek icin glob desenlerini kabul eder. +Bu araç dizin içeriğini listeler. Sonuçları filtrelemek için glob desenlerini kabul eder. --- ### lsp (deneysel) -Tanim, referans, hover bilgisi ve cagrilar hiyerarsisi gibi kod zekasi ozellikleri icin yapilandirdiginiz LSP sunuculariyla etkilesir. +Tanım, referans, hover bilgisi ve çağrılar hiyerarşisi gibi kod zekası özellikleri için yapılandırdığınız LSP sunucularıyla etkileşir. :::note -Bu arac yalnizca `OPENCODE_EXPERIMENTAL_LSP_TOOL=true` (veya `OPENCODE_EXPERIMENTAL=true`) oldugunda kullanilabilir. +Bu araç yalnızca `OPENCODE_EXPERIMENTAL_LSP_TOOL=true` (veya `OPENCODE_EXPERIMENTAL=true`) olduğunda kullanılabilir. ::: ```json title="opencode.json" {4} @@ -185,9 +185,9 @@ Bu arac yalnizca `OPENCODE_EXPERIMENTAL_LSP_TOOL=true` (veya `OPENCODE_EXPERIMEN } ``` -Desteklenen islemler: `goToDefinition`, `findReferences`, `hover`, `documentSymbol`, `workspaceSymbol`, `goToImplementation`, `prepareCallHierarchy`, `incomingCalls`, `outgoingCalls`. +Desteklenen işlemler: `goToDefinition`, `findReferences`, `hover`, `documentSymbol`, `workspaceSymbol`, `goToImplementation`, `prepareCallHierarchy`, `incomingCalls`, `outgoingCalls`. -Projeniz icin kullanilabilir LSP sunucularini ayarlamak icin [LSP Servers](/docs/lsp) sayfasina bakin. +Projeniz için kullanılabilir LSP sunucularını ayarlamak için [LSP Sunucuları](/docs/lsp) sayfasına bakın. --- @@ -204,17 +204,17 @@ Dosyalara patch uygular. } ``` -Bu arac patch dosyalarini kod tabaniniza uygular. Farkli kaynaklardan gelen diff ve patch'leri uygulamak icin kullanislidir. +Bu araç patch dosyalarını kod tabanınıza uygular. Farklı kaynaklardan gelen diff ve patch'leri uygulamak için kullanışlıdır. :::note -`patch` araci `edit` izniyle kontrol edilir; bu izin tum dosya degisikliklerini kapsar (`edit`, `write`, `patch`, `multiedit`). +`patch` aracı `edit` izniyle kontrol edilir; bu izin tüm dosya değişikliklerini kapsar (`edit`, `write`, `patch`, `multiedit`). ::: --- ### skill -Bir [skill](/docs/skills) (`SKILL.md` dosyasi) yukler ve icerigini konusmaya dondurur. +Bir [skill](/docs/skills) (`SKILL.md` dosyası) yükler ve içeriğini konuşmaya döndürür. ```json title="opencode.json" {4} { @@ -229,7 +229,7 @@ Bir [skill](/docs/skills) (`SKILL.md` dosyasi) yukler ve icerigini konusmaya don ### todowrite -Kodlama oturumlarinda yapilacaklar listesini yonetir. +Kodlama oturumlarında yapılacaklar listesini yönetir. ```json title="opencode.json" {4} { @@ -240,17 +240,17 @@ Kodlama oturumlarinda yapilacaklar listesini yonetir. } ``` -Karmasik islemlerde ilerlemeyi takip etmek icin gorev listeleri olusturur ve gunceller. LLM bunu cok adimli gorevleri duzenlemek icin kullanir. +Karmaşık işlemlerde ilerlemeyi takip etmek için görev listeleri oluşturur ve günceller. LLM bunu çok adımlı görevleri düzenlemek için kullanır. :::note -Bu arac alt ajanlar icin varsayilan olarak devre disidir, ama manuel etkinlestirebilirsiniz. [Daha fazla bilgi](/docs/agents/#permissions) +Bu araç alt agent'lar için varsayılan olarak devre dışıdır, ama manuel etkinleştirebilirsiniz. [Daha fazla bilgi](/docs/agents/#permissions) ::: --- ### todoread -Mevcut yapilacaklar listesini okur. +Mevcut yapılacaklar listesini okur. ```json title="opencode.json" {4} { @@ -261,17 +261,17 @@ Mevcut yapilacaklar listesini okur. } ``` -Guncel todo listesi durumunu okur. LLM bunu hangi gorevlerin bekledigini veya tamamlandigini takip etmek icin kullanir. +Güncel todo listesi durumunu okur. LLM bunu hangi görevlerin beklediğini veya tamamlandığını takip etmek için kullanır. :::note -Bu arac alt ajanlar icin varsayilan olarak devre disidir, ama manuel etkinlestirebilirsiniz. [Daha fazla bilgi](/docs/agents/#permissions) +Bu araç alt agent'lar için varsayılan olarak devre dışıdır, ama manuel etkinleştirebilirsiniz. [Daha fazla bilgi](/docs/agents/#permissions) ::: --- ### webfetch -Web icerigi getirir. +Web içeriği getirir. ```json title="opencode.json" {4} { @@ -282,7 +282,7 @@ Web icerigi getirir. } ``` -LLM'in web sayfalarini getirip okumasini saglar. Dokumantasyon aramak veya cevrimici kaynaklari incelemek icin kullanislidir. +LLM'in web sayfalarını getirip okumasını sağlar. Dokümantasyon aramak veya çevrimiçi kaynakları incelemek için kullanışlıdır. --- @@ -291,9 +291,9 @@ LLM'in web sayfalarini getirip okumasini saglar. Dokumantasyon aramak veya cevri Web'de bilgi arar. :::note -Bu arac yalnizca opencode provider kullanilirken veya `OPENCODE_ENABLE_EXA` ortam degiskeni dogru degerlerden birine ayarlandiginda (ornegin `true` ya da `1`) kullanilabilir. +Bu araç yalnızca opencode provider kullanılırken veya `OPENCODE_ENABLE_EXA` ortam değişkeni doğru değerlerden birine ayarlandığında (örneğin `true` ya da `1`) kullanılabilir. -opencode baslatirken etkinlestirmek icin: +opencode başlatırken etkinleştirmek için: ```bash OPENCODE_ENABLE_EXA=1 opencode @@ -310,19 +310,19 @@ OPENCODE_ENABLE_EXA=1 opencode } ``` -Exa AI ile web aramasi yaparak ilgili bilgileri bulur. Egitim verisi kesim tarihinin otesindeki konulari arastirmak, guncel olaylari bulmak veya genel arastirma yapmak icin kullanislidir. +Exa AI ile web araması yaparak ilgili bilgileri bulur. Eğitim verisi kesim tarihinin ötesindeki konuları araştırmak, güncel olayları bulmak veya genel araştırma yapmak için kullanışlıdır. -API anahtari gerekmez - arac Exa AI'nin barindirilan MCP hizmetine dogrudan kimlik dogrulamasi olmadan baglanir. +API anahtarı gerekmez - araç Exa AI'nin barındırılan MCP hizmetine doğrudan kimlik doğrulaması olmadan bağlanır. :::tip -Bilgi kesfetmeniz gerekiyorsa `websearch`, belirli bir URL'den icerik cekmeniz gerekiyorsa `webfetch` kullanin. +Bilgi keşfetmeniz gerekiyorsa `websearch`, belirli bir URL'den içerik çekmeniz gerekiyorsa `webfetch` kullanın. ::: --- ### question -Calisma sirasinda kullaniciya soru sorar. +Çalışma sırasında kullanıcıya soru sorar. ```json title="opencode.json" {4} { @@ -333,42 +333,42 @@ Calisma sirasinda kullaniciya soru sorar. } ``` -Bu arac LLM'in gorev sirasinda kullaniciya soru sormasini saglar. Sunlar icin kullanislidir: +Bu araç LLM'in görev sırasında kullanıcıya soru sormasını sağlar. Şunlar için kullanışlıdır: -- Kullanici tercihleri veya gereksinimleri toplamak -- Belirsiz talimatlari netlestirmek -- Uygulama seceneklerinde karar almak -- Hangi yone gidilecegine dair secenek sunmak +- Kullanıcı tercihleri veya gereksinimleri toplamak +- Belirsiz talimatları netleştirmek +- Uygulama seçeneklerinde karar almak +- Hangi yöne gidileceğine dair seçenek sunmak -Her soru bir baslik, soru metni ve secenek listesi icerir. Kullanicilar seceneklerden birini secebilir veya ozel yanit yazabilir. Birden fazla soru varsa tum yanitlari gondermeden once sorular arasinda gezebilirler. +Her soru bir başlık, soru metni ve seçenek listesi içerir. Kullanıcılar seçeneklerden birini seçebilir veya özel yanıt yazabilir. Birden fazla soru varsa tüm yanıtları göndermeden önce sorular arasında gezebilirler. --- -## Ozel araclar +## Özel araçlar -Ozel araclar, LLM'in cagirabilecegi kendi fonksiyonlarinizi tanimlamanizi saglar. Bunlar config dosyanizda tanimlanir ve keyfi kod calistirabilir. +Özel araçlar, LLM'in çağırabileceği kendi fonksiyonlarınızı tanımlamanızı sağlar. Bunlar config dosyanızda tanımlanır ve keyfi kod çalıştırabilir. -Ozel arac olusturma icin [daha fazla bilgi alin](/docs/custom-tools). +Özel araç oluşturma için [daha fazla bilgi alın](/docs/custom-tools). --- -## MCP sunuculari +## MCP sunucuları -MCP (Model Context Protocol) sunuculari, harici araclari ve servisleri entegre etmenizi saglar. Buna veritabani erisimi, API entegrasyonlari ve ucuncu taraf servisler dahildir. +MCP (Model Context Protocol) sunucuları, harici araçları ve servisleri entegre etmenizi sağlar. Buna veritabanı erişimi, API entegrasyonları ve üçüncü taraf servisler dahildir. -MCP sunucularini yapilandirma icin [daha fazla bilgi alin](/docs/mcp-servers). +MCP sunucularını yapılandırma için [daha fazla bilgi alın](/docs/mcp-servers). --- ## Dahili detaylar -Dahilde `grep`, `glob` ve `list` gibi araclar [ripgrep](https://github.com/BurntSushi/ripgrep) kullanir. Varsayilan olarak ripgrep `.gitignore` desenlerine uyar; yani `.gitignore` icindeki dosya ve dizinler arama ve listeleme sonucuna dahil edilmez. +Dahilde `grep`, `glob` ve `list` gibi araçlar [ripgrep](https://github.com/BurntSushi/ripgrep) kullanır. Varsayılan olarak ripgrep `.gitignore` desenlerine uyar; yani `.gitignore` içindeki dosya ve dizinler arama ve listeleme sonucuna dahil edilmez. --- -### Ignore desenleri +### Yoksayma desenleri -Normalde yok sayilan dosyalari dahil etmek icin proje kokunde bir `.ignore` dosyasi olusturun. Bu dosya belirli yollari acikca izinli yapabilir. +Normalde yok sayılan dosyaları dahil etmek için proje kökünde bir `.ignore` dosyası oluşturun. Bu dosya belirli yolları açıkça izinli yapabilir. ```text title=".ignore" !node_modules/ @@ -376,4 +376,4 @@ Normalde yok sayilan dosyalari dahil etmek icin proje kokunde bir `.ignore` dosy !build/ ``` -Ornegin bu `.ignore` dosyasi, `node_modules/` icinde olsalar bile ripgrep'in `dist/`, `build/` ve `.gitignore` dizinlerinde arama yapmasina izin verir. +Örneğin bu `.ignore` dosyası, `node_modules/` içinde olsalar bile ripgrep'in `dist/`, `build/` ve `.gitignore` dizinlerinde arama yapmasına izin verir. diff --git a/packages/web/src/content/docs/tr/troubleshooting.mdx b/packages/web/src/content/docs/tr/troubleshooting.mdx index dbf7289a9..24ef067ff 100644 --- a/packages/web/src/content/docs/tr/troubleshooting.mdx +++ b/packages/web/src/content/docs/tr/troubleshooting.mdx @@ -37,11 +37,11 @@ Bu dizin sunlari icerir: --- -## Masaustu uygulamasi +## Masaüstü uygulaması opencode Desktop arka planda yerel bir opencode sunucusu (`opencode-cli` sidecar) calistirir. Sorunlarin cogu bozuk bir plugin, hasarli cache veya hatali sunucu ayarindan kaynaklanir. -### Hizli kontroller +### Hızlı kontroller - Uygulamayi tamamen kapatip yeniden acin - Uygulama hata ekrani gosteriyorsa **Restart**'a tiklayip hata detaylarini kopyalayin @@ -49,7 +49,7 @@ opencode Desktop arka planda yerel bir opencode sunucusu (`opencode-cli` sidecar --- -### Pluginleri devre disi birakin +### Eklentileri devre dışı bırakın Desktop uygulamasi acilista cokuyorsa, takiliyorsa veya garip davranislar gosteriyorsa once pluginleri devre disi birakin. @@ -70,7 +70,7 @@ Plugin tanimliysa anahtari kaldirarak veya bos bir diziye cekerek gecici olarak } ``` -#### Plugin dizinlerini kontrol edin +#### Eklenti dizinlerini kontrol edin opencode diskten yerel plugin de yukleyebilir. Bu dizinleri gecici olarak tasiyin (veya klasoru yeniden adlandirin) ve uygulamayi yeniden baslatin: @@ -99,7 +99,7 @@ Pluginleri kapatmak ise yaramazsa (veya plugin kurulumu takili kaldiysa), openco --- -### Sunucu baglanti sorunlarini duzeltin +### Sunucu bağlantı sorunlarını düzeltin opencode Desktop ya kendi yerel sunucusunu baslatir (varsayilan) ya da sizin tanimladiginiz bir sunucu URL'sine baglanir. @@ -121,7 +121,7 @@ Ortamda `OPENCODE_PORT` ayarliysa desktop uygulamasi yerel sunucu icin o portu k --- -### Linux: Wayland / X11 sorunlari +### Linux: Wayland / X11 sorunları Linux'ta bazi Wayland kurulumlari bos pencere veya compositor hatalarina yol acabilir. @@ -130,19 +130,19 @@ Linux'ta bazi Wayland kurulumlari bos pencere veya compositor hatalarina yol aca --- -### Windows: WebView2 runtime +### Windows: WebView2 Çalışma Zamanı Windows'ta opencode Desktop, Microsoft Edge **WebView2 Runtime** gerektirir. Uygulama bos pencereyle aciliyorsa veya hic baslamiyorsa WebView2'yi kurup/guncelleyip tekrar deneyin. --- -### Windows: Genel performans sorunlari +### Windows: Genel performans sorunları Windows'ta yavaslik, dosya erisim sorunlari veya terminal problemleri yasiyorsaniz [WSL (Windows Subsystem for Linux)](/docs/windows-wsl) kullanmayi deneyin. WSL, opencode ozellikleriyle daha sorunsuz calisan bir Linux ortami saglar. --- -### Bildirimler gorunmuyor +### Bildirimler görünmüyor opencode Desktop sistem bildirimlerini yalnizca su durumlarda gosterir: @@ -151,7 +151,7 @@ opencode Desktop sistem bildirimlerini yalnizca su durumlarda gosterir: --- -### Desktop depolamasini sifirlayin (son care) +### Desktop depolamasını sıfırlayın (son çare) Uygulama acilmiyorsa ve ayarlari arayuz icinden temizleyemiyorsaniz, desktop uygulamasinin kayitli durumunu sifirlayin. @@ -169,7 +169,7 @@ Dizini hizlica bulmak icin: --- -## Yardim alin +## Yardım alın opencode ile ilgili bir sorun yasiyorsaniz: @@ -189,13 +189,13 @@ opencode ile ilgili bir sorun yasiyorsaniz: --- -## Yaygin sorunlar +## Yaygın sorunlar Asagida yaygin sorunlar ve cozumleri yer aliyor. --- -### opencode baslamiyor +### opencode başlamıyor 1. Hata mesaji icin loglari kontrol edin 2. Terminalde cikti gormek icin `--print-logs` ile calistirin @@ -203,7 +203,7 @@ Asagida yaygin sorunlar ve cozumleri yer aliyor. --- -### Kimlik dogrulama sorunlari +### Kimlik doğrulama sorunları 1. TUI'da `/connect` komutuyla yeniden kimlik dogrulamasi yapin 2. API anahtarlarinizin gecerli oldugunu kontrol edin @@ -211,7 +211,7 @@ Asagida yaygin sorunlar ve cozumleri yer aliyor. --- -### Model kullanilamiyor +### Model kullanılamıyor 1. Provider ile kimlik dogrulamasi yaptiginizi kontrol edin 2. Config'teki model adinin dogru oldugunu dogrulayin @@ -269,7 +269,7 @@ Bu, opencode'un en yeni provider paket surumlerini indirmesini zorlar ve model p --- -### Linux'ta kopyala/yapistir calismiyor +### Linux'ta kopyala/yapıştır çalışmıyor Linux kullanicilarinin kopyala/yapistir ozelliginin calismasi icin asagidaki pano araclarindan en az birini kurmasi gerekir: diff --git a/packages/web/src/content/docs/tr/web.mdx b/packages/web/src/content/docs/tr/web.mdx index ea36c9d80..4b9ae78ea 100644 --- a/packages/web/src/content/docs/tr/web.mdx +++ b/packages/web/src/content/docs/tr/web.mdx @@ -21,7 +21,7 @@ Bu, `127.0.0.1` üzerinde rastgele kullanılabilir bir bağlantı noktasına sah `OPENCODE_SERVER_PASSWORD` ayarlanmadıysa sunucunun güvenliği kaldırılacaktır. Bu, yerel kullanım için iyidir ancak ağ erişimi için ayarlanmalıdır. ::: -:::tip[Windows Users] +:::tip[Windows Kullanıcıları] En iyi deneyim için PowerShell yerine `opencode web`'yi [WSL](/docs/windows-wsl)'den çalıştırın. Bu, uygun dosya sistemi erişimini ve terminal entegrasyonunu sağlar. ::: diff --git a/packages/web/src/content/docs/tr/windows-wsl.mdx b/packages/web/src/content/docs/tr/windows-wsl.mdx index c7dd84111..7d0471682 100644 --- a/packages/web/src/content/docs/tr/windows-wsl.mdx +++ b/packages/web/src/content/docs/tr/windows-wsl.mdx @@ -7,7 +7,7 @@ import { Steps } from "@astrojs/starlight/components" opencode Windows'ta dogrudan calisabilir, ancak en iyi deneyim icin [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) kullanmanizi oneriyoruz. WSL, opencode ozellikleriyle sorunsuz calisan bir Linux ortami saglar. -:::tip[Why WSL?] +:::tip[Neden WSL?] WSL, daha iyi dosya sistemi performansi, tam terminal destegi ve opencode'un dayandigi gelistirme araclariyla uyumluluk sunar. ::: @@ -42,7 +42,7 @@ WSL, daha iyi dosya sistemi performansi, tam terminal destegi ve opencode'un day --- -## Desktop uygulamasi + WSL sunucusu +## Masaüstü uygulaması + WSL sunucusu opencode Desktop kullanmak isteyip sunucuyu WSL'de calistirmak istiyorsaniz: @@ -85,7 +85,7 @@ Windows'ta en iyi web deneyimi icin: --- -## Windows dosyalarina erisin +## Windows dosyalarına erişin WSL, tum Windows dosyalariniza `/mnt/` dizini uzerinden erisebilir: @@ -106,7 +106,7 @@ En sorunsuz deneyim icin deponuzu WSL dosya sistemine (ornegin `~/code/` altina) --- -## Ipuclari +## İpuçları - Windows suruculerinde duran projelerde opencode'u WSL icinde calistirin - dosya erisimi daha sorunsuz olur - Butunlesik bir gelistirme akisi icin opencode ile birlikte VS Code [WSL eklentisini](https://code.visualstudio.com/docs/remote/wsl) kullanin diff --git a/packages/web/src/content/docs/zh-cn/acp.mdx b/packages/web/src/content/docs/zh-cn/acp.mdx index 14f898148..47e0f3e05 100644 --- a/packages/web/src/content/docs/zh-cn/acp.mdx +++ b/packages/web/src/content/docs/zh-cn/acp.mdx @@ -69,7 +69,7 @@ ACP 是一种开放协议，用于标准化代码编辑器和 AI 编码代理之 ### JetBrains IDE -根据 [docs](https://www.jetbrains.com/help/ai-assistant/acp.html) 添加到你的 [JetBrains IDE](https://www.jetbrains.com/) `acp.json`： +根据 [文档](https://www.jetbrains.com/help/ai-assistant/acp.html) 添加到你的 [JetBrains IDE](https://www.jetbrains.com/) `acp.json`： ```json title="acp.json" { diff --git a/packages/web/src/content/docs/zh-cn/agents.mdx b/packages/web/src/content/docs/zh-cn/agents.mdx index c22ccb934..a94296f45 100644 --- a/packages/web/src/content/docs/zh-cn/agents.mdx +++ b/packages/web/src/content/docs/zh-cn/agents.mdx @@ -1,5 +1,5 @@ --- -title: Agents +title: 代理 description: 配置和使用专门的代理。 --- @@ -19,22 +19,22 @@ OpenCode 有两种类型的代理；主代理和子代理。 --- -### Primary 代理 +### 主代理 -Primary 代理是与您直接交互的主要助手。您可以使用 **Tab** 键或您配置的 `switch_agent` 键绑定循环浏览它们。这些代理处理您的主要对话。工具访问是通过权限配置的 - 例如，“Build”启用了所有工具，而“Plan”则受到限制。 +主代理 (Primary) 是与您直接交互的主要助手。您可以使用 **Tab** 键或您配置的 `switch_agent` 键绑定循环浏览它们。这些代理处理您的主要对话。工具访问是通过权限配置的 - 例如，“Build”启用了所有工具，而“Plan”则受到限制。 :::tip -您可以在会话期间使用 **Tab** 键在 Primary 代理之间进行切换。 +您可以在会话期间使用 **Tab** 键在主代理之间进行切换。 ::: -OpenCode 附带两个内置的 Primary 代理：**Build** 和 **Plan**。 +OpenCode 附带两个内置的主代理：**Build** 和 **Plan**。 看看下面这些。 --- -### Subagents (子代理) +### 子代理 -Subagents (子代理) 是 Primary 代理可以调用​​来执行特定任务的专业助手。您还可以通过在消息中 **@提及** 它们来手动调用它们。 +子代理 (Subagents) 是主代理可以调用​​来执行特定任务的专业助手。您还可以通过在消息中 **@提及** 它们来手动调用它们。 OpenCode 附带两个内置子代理：**General** 和 **Explore**。我们将在下面看看这个。 @@ -110,10 +110,10 @@ _模式_：`primary` ## 用法 -1. 对于 Primary 代理，请在会话期间使用 **Tab** 键循环浏览它们。您还可以使用配置的 `switch_agent` 键绑定。 +1. 对于主代理，请在会话期间使用 **Tab** 键循环浏览它们。您还可以使用配置的 `switch_agent` 键绑定。 2. 可以调用子代理： - - **自动**由 Primary 代理根据其描述执行专门任务。 + - **自动**由主代理根据其描述执行专门任务。 - 通过在消息中 **@提及** 子代理手动进行。例如。 ```txt frame="none" @@ -346,7 +346,7 @@ Markdown 文件名成为代理名称。例如，`review.md` 创建 `review` 代 使用 `model` 配置此代理的模型。对于使用针对不同任务优化的不同模型很有帮助。例如，更快的规划模型、更强大的实施模型。 :::tip -如果您不指定模型，Primary 代理将使用 [全局配置的模型](/docs/config#models)，而子代理将使用调用子代理的 Primary 代理的模型。 +如果您不指定模型，主代理将使用 [全局配置的模型](/docs/config#models)，而子代理将使用调用子代理的主代理的模型。 ::: ```json title="opencode.json" diff --git a/packages/web/src/content/docs/zh-cn/cli.mdx b/packages/web/src/content/docs/zh-cn/cli.mdx index 532285dde..6d2ea032d 100644 --- a/packages/web/src/content/docs/zh-cn/cli.mdx +++ b/packages/web/src/content/docs/zh-cn/cli.mdx @@ -27,22 +27,22 @@ opencode run "Explain how closures work in JavaScript" opencode [project] ``` -#### Flags +#### 标志 -| Flag | Short | Description | -| ------------ | ----- | --------------------------------------------------------- | -| `--continue` | `-c` | 继续上一个会话 | -| `--session` | `-s` | 继续的会话 ID | -| `--fork` | | 继续时分叉会话（与 `--continue` 或 `--session` 一起使用） | -| `--prompt` | | 使用的提示 | -| `--model` | `-m` | 使用的模型 (provider/model) | -| `--agent` | | 使用的代理 | -| `--port` | | 监听端口 | -| `--hostname` | | 监听的主机名 | +| 标志 | 简写 | 描述 | +| ------------ | ---- | --------------------------------------------------------- | +| `--continue` | `-c` | 继续上一个会话 | +| `--session` | `-s` | 继续的会话 ID | +| `--fork` | | 继续时分叉会话（与 `--continue` 或 `--session` 一起使用） | +| `--prompt` | | 使用的提示 | +| `--model` | `-m` | 使用的模型 (provider/model) | +| `--agent` | | 使用的代理 | +| `--port` | | 监听端口 | +| `--hostname` | | 监听的主机名 | --- -## Commands +## 命令 opencode CLI 还具有以下命令。 @@ -76,12 +76,12 @@ opencode web --port 4096 --hostname 0.0.0.0 opencode attach http://10.20.30.40:4096 ``` -#### Flags +#### 标志 -| Flag | Short | Description | -| ----------- | ----- | ------------------- | -| `--dir` | | 启动 TUI 的工作目录 | -| `--session` | `-s` | 继续的会话 ID | +| 标志 | 简写 | 描述 | +| ----------- | ---- | ------------------- | +| `--dir` | | 启动 TUI 的工作目录 | +| `--session` | `-s` | 继续的会话 ID | --- @@ -185,9 +185,9 @@ opencode github install opencode github run ``` -##### Flags +#### 标志 -| Flag | Description | +| 标志 | 描述 | | --------- | ------------------------------ | | `--event` | 用于运行代理的 GitHub 模拟事件 | | `--token` | GitHub 个人访问 Token | @@ -294,9 +294,9 @@ opencode models [provider] opencode models anthropic ``` -#### Flags +#### 标志 -| Flag | Description | +| 标志 | 描述 | | ----------- | ---------------------------------------- | | `--refresh` | 从 models.dev 刷新模型缓存 | | `--verbose` | 使用更详细的模型输出（包括成本等元数据） | @@ -333,22 +333,22 @@ opencode serve opencode run --attach http://localhost:4096 "Explain async/await in JavaScript" ``` -#### Flags +#### 标志 -| 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` | | 本地服务器的端口（默认为随机端口） | +| 标志 | 简写 | 描述 | +| ------------ | ---- | --------------------------------------------------------------- | +| `--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` | | 本地服务器的端口（默认为随机端口） | --- @@ -362,9 +362,9 @@ opencode serve 这将启动一个 HTTP 服务器，该服务器提供对 opencode 功能的 API 访问，无需 TUI 界面。设置 `OPENCODE_SERVER_PASSWORD` 以启用 HTTP 基本身份验证（用户名默认为 `opencode`）。 -#### Flags +#### 标志 -| Flag | Description | +| 标志 | 描述 | | ------------ | ------------------------ | | `--port` | 监听端口 | | `--hostname` | 监听的主机名 | @@ -391,12 +391,12 @@ opencode session [command] opencode session list ``` -##### Flags +##### 标志 -| Flag | Short | Description | -| ------------- | ----- | ------------------------------ | -| `--max-count` | `-n` | 限制为最近的 N 个会话 | -| `--format` | | 输出格式：table 或 json(table) | +| 标志 | 简写 | 描述 | +| ------------- | ---- | ------------------------------ | +| `--max-count` | `-n` | 限制为最近的 N 个会话 | +| `--format` | | 输出格式：table 或 json(table) | --- @@ -408,9 +408,9 @@ opencode session list opencode stats ``` -#### Flags +#### 标志 -| Flag | Description | +| 标志 | 描述 | | ----------- | -------------------------------------------------------- | | `--days` | 显示过去 N 天（所有时间）的统计数据 | | `--tools` | 显示工具数量（全部） | @@ -458,9 +458,9 @@ opencode web 这将启动 HTTP 服务器并打开 Web 浏览器以通过 Web 界面访问 opencode。设置 `OPENCODE_SERVER_PASSWORD` 以启用 HTTP 基本身份验证（用户名默认为 `opencode`）。 -#### Flags +#### 标志 -| Flag | Description | +| 标志 | 描述 | | ------------ | ------------------------ | | `--port` | 监听端口 | | `--hostname` | 监听的主机名 | @@ -479,9 +479,9 @@ opencode acp 此命令启动一个 ACP 服务器，该服务器使用 nd-JSON 通过 stdin/stdout 进行通信。 -#### Flags +#### 标志 -| Flag | Description | +| 标志 | 描述 | | ------------ | ------------ | | `--cwd` | 工作目录 | | `--port` | 监听端口 | @@ -497,14 +497,14 @@ opencode acp opencode uninstall ``` -#### Flags +#### 标志 -| Flag | Short | Description | -| --------------- | ----- | ---------------------------- | -| `--keep-config` | `-c` | 保留配置文件 | -| `--keep-data` | `-d` | 保留会话数据和快照 | -| `--dry-run` | | 显示将删除的内容但不实际删除 | -| `--force` | `-f` | 跳过确认提示 | +| 标志 | 简写 | 描述 | +| --------------- | ---- | ---------------------------- | +| `--keep-config` | `-c` | 保留配置文件 | +| `--keep-data` | `-d` | 保留会话数据和快照 | +| `--dry-run` | | 显示将删除的内容但不实际删除 | +| `--force` | `-f` | 跳过确认提示 | --- @@ -528,32 +528,32 @@ opencode upgrade opencode upgrade v0.1.48 ``` -#### Flags +#### 标志 -| Flag | Short | Description | -| ---------- | ----- | ------------------------------------------ | -| `--method` | `-m` | 使用的安装方法；curl, npm, pnpm, bun, brew | +| 标志 | 简写 | 描述 | +| ---------- | ---- | ------------------------------------------ | +| `--method` | `-m` | 使用的安装方法；curl, npm, pnpm, bun, brew | --- -## Global Flags +## 全局标志 opencode CLI 接受以下全局标志。 -| Flag | Short | Description | -| -------------- | ----- | ----------------------------------- | -| `--help` | `-h` | 显示帮助 | -| `--version` | `-v` | 打印版本号 | -| `--print-logs` | | 将日志打印到 stderr | -| `--log-level` | | 日志级别 (DEBUG, INFO, WARN, ERROR) | +| 标志 | 简写 | 描述 | +| -------------- | ---- | ----------------------------------- | +| `--help` | `-h` | 显示帮助 | +| `--version` | `-v` | 打印版本号 | +| `--print-logs` | | 将日志打印到 stderr | +| `--log-level` | | 日志级别 (DEBUG, INFO, WARN, ERROR) | --- -## Environment variables +## 环境变量 可以使用环境变量配置 opencode。 -| Variable | Type | Description | +| 变量 | 类型 | 描述 | | ------------------------------------- | ------- | ----------------------------------------- | | `OPENCODE_AUTO_SHARE` | boolean | 自动共享会话 | | `OPENCODE_GIT_BASH_PATH` | string | Windows 上 Git Bash 可执行文件的路径 | @@ -582,11 +582,11 @@ opencode CLI 接受以下全局标志。 --- -### Experimental +### 实验性功能 这些环境变量启用可能会更改或删除的实验性功能。 -| Variable | Type | Description | +| 变量 | 类型 | 描述 | | ----------------------------------------------- | ------- | ----------------------------------- | | `OPENCODE_EXPERIMENTAL` | boolean | 启用所有实验性功能 | | `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | boolean | 启用图标发现 | diff --git a/packages/web/src/content/docs/zh-cn/commands.mdx b/packages/web/src/content/docs/zh-cn/commands.mdx index 5c04f638f..548b681b0 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: Commands +title: 命令 description: 为重复任务创建自定义命令。 --- @@ -108,7 +108,7 @@ Markdown 文件名成为命令名。例如，`test.md` 让 --- -### Arguments +### 参数 使用 `$ARGUMENTS` 占位符将参数提交给命令。 @@ -161,7 +161,7 @@ with the following content: $3 --- -### Shell Output +### Shell 输出 使用 _!`command`_ 将 [bash 命令](/docs/tui#bash-commands) 输出注入到提示符中。 @@ -195,7 +195,7 @@ Review these changes and suggest any improvements. --- -### File Reference +### 文件引用 使用 `@` 后跟文件名将文件包含在命令中。 diff --git a/packages/web/src/content/docs/zh-cn/config.mdx b/packages/web/src/content/docs/zh-cn/config.mdx index 93b6c0366..e07e4601f 100644 --- a/packages/web/src/content/docs/zh-cn/config.mdx +++ b/packages/web/src/content/docs/zh-cn/config.mdx @@ -56,7 +56,7 @@ opencode 支持 **JSON** 和 **JSONC**（带注释的 JSON）格式。 --- -### Remote +### 远程 组织可以通过 `.well-known/opencode` 端点提供默认配置。当您向支持的提供商进行身份验证时，会自动获取该信息。 @@ -92,7 +92,7 @@ opencode 支持 **JSON** 和 **JSONC**（带注释的 JSON）格式。 --- -### Global +### 全局 将全局 opencode 配置放在 `~/.config/opencode/opencode.json` 中。使用全局配置来实现用户范围的首选项，例如主题、提供商或按键绑定。 @@ -100,7 +100,7 @@ opencode 支持 **JSON** 和 **JSONC**（带注释的 JSON）格式。 --- -### Per Project +### 项目级 在项目根目录中添加 `opencode.json`。项目配置在标准配置文件中具有最高优先级 - 它覆盖全局配置和远程配置。 @@ -114,7 +114,7 @@ opencode 支持 **JSON** 和 **JSONC**（带注释的 JSON）格式。 --- -### Custom Path +### 自定义路径 使用 `OPENCODE_CONFIG` 环境变量指定自定义配置文件路径。 @@ -127,7 +127,7 @@ opencode run "Hello world" --- -### Custom Directory +### 自定义目录 使用 `OPENCODE_CONFIG_DIR` 环境变量指定自定义配置目录。将在该目录中搜索代理、命令、模式和插件，就像标准 `.opencode` 目录一样，并且应该遵循相同的结构。 @@ -175,7 +175,7 @@ opencode run "Hello world" --- -### Server +### 服务器 您可以通过 `opencode serve` 选项为 `opencode web` 和 `server` 命令配置服务器设置。 @@ -204,7 +204,7 @@ opencode run "Hello world" --- -### Tools +### 工具 您可以通过 `tools` 选项管理 LLM 可以使用的工具。 @@ -222,7 +222,7 @@ opencode run "Hello world" --- -### Models +### 模型 您可以通过 `provider`、`model` 和 `small_model` 选项来配置要在 opencode 配置中使用的提供商和模型。 @@ -295,7 +295,7 @@ Bearer Tokens (`AWS_BEARER_TOKEN_BEDROCK` 或 `/connect`) 优先于基于配置 --- -### Theme +### 主题 您可以通过 opencode 配置中的 `theme` 选项配置要使用的主题。 @@ -310,7 +310,7 @@ Bearer Tokens (`AWS_BEARER_TOKEN_BEDROCK` 或 `/connect`) 优先于基于配置 --- -### Agents +### 代理 您可以通过 `agent` 选项为特定任务配置专用代理。 @@ -336,7 +336,7 @@ Bearer Tokens (`AWS_BEARER_TOKEN_BEDROCK` 或 `/connect`) 优先于基于配置 --- -### Default Agent +### 默认代理 您可以使用 `default_agent` 选项设置默认代理。当没有明确指定时，这将确定使用哪个代理。 @@ -353,7 +353,7 @@ Bearer Tokens (`AWS_BEARER_TOKEN_BEDROCK` 或 `/connect`) 优先于基于配置 --- -### Share +### 分享 您可以通过 `share` 选项配置 [分享](/docs/share) 功能。 @@ -374,7 +374,7 @@ Bearer Tokens (`AWS_BEARER_TOKEN_BEDROCK` 或 `/connect`) 优先于基于配置 --- -### Command +### 命令 您可以通过 `command` 选项为重复任务配置自定义命令。 @@ -400,7 +400,7 @@ Bearer Tokens (`AWS_BEARER_TOKEN_BEDROCK` 或 `/connect`) 优先于基于配置 --- -### Keybinds +### 快捷键 您可以通过 `keybinds` 选项自定义您的按键绑定。 @@ -415,7 +415,7 @@ Bearer Tokens (`AWS_BEARER_TOKEN_BEDROCK` 或 `/connect`) 优先于基于配置 --- -### Autoupdate +### 自动更新 opencode 将在启动时自动下载任何新的更新。您可以使用 `autoupdate` 选项禁用此功能。 @@ -431,7 +431,7 @@ opencode 将在启动时自动下载任何新的更新。您可以使用 `autoup --- -### Formatters +### 格式化程序 您可以通过 `formatter` 选项配置代码格式化程序。 @@ -457,7 +457,7 @@ opencode 将在启动时自动下载任何新的更新。您可以使用 `autoup --- -### Permissions +### 权限 默认情况下，opencode **允许所有操作**，无需明确批准。您可以使用 `permission` 选项更改此设置。 @@ -477,7 +477,7 @@ opencode 将在启动时自动下载任何新的更新。您可以使用 `autoup --- -### Compaction +### 压缩 您可以通过 `compaction` 选项控制上下文压缩行为。 @@ -496,7 +496,7 @@ opencode 将在启动时自动下载任何新的更新。您可以使用 `autoup --- -### Watcher +### 观察器 您可以通过 `watcher` 选项配置文件观察器忽略模式。 @@ -513,7 +513,7 @@ opencode 将在启动时自动下载任何新的更新。您可以使用 `autoup --- -### MCP Servers +### MCP 服务器 您可以通过 `mcp` 选项配置要使用的 MCP 服务器。 @@ -528,7 +528,7 @@ opencode 将在启动时自动下载任何新的更新。您可以使用 `autoup --- -### Plugins +### 插件 [Plugins](/docs/plugins) 使用自定义工具、挂钩和集成扩展 opencode。 @@ -545,7 +545,7 @@ opencode 将在启动时自动下载任何新的更新。您可以使用 `autoup --- -### Instructions +### 指令 您可以通过 `instructions` 选项配置您正在使用的模型的说明。 @@ -560,7 +560,7 @@ opencode 将在启动时自动下载任何新的更新。您可以使用 `autoup --- -### Disabled Providers +### 禁用提供商 您可以通过 `disabled_providers` 选项禁用自动加载的提供商。当您想要阻止加载某些提供商（即使其凭据可用）时，这非常有用。 @@ -583,7 +583,7 @@ opencode 将在启动时自动下载任何新的更新。您可以使用 `autoup --- -### Enabled Providers +### 启用提供商 您可以通过 `enabled_providers` 选项指定允许的提供商列表。设置后，仅启用指定的提供商，所有其他提供商将被忽略。 @@ -604,7 +604,7 @@ opencode 将在启动时自动下载任何新的更新。您可以使用 `autoup --- -### Experimental +### 实验性功能 `experimental` 键包含正在积极开发的选项。 @@ -621,13 +621,13 @@ opencode 将在启动时自动下载任何新的更新。您可以使用 `autoup --- -## Variables +## 变量 您可以在配置文件中使用变量替换来引用环境变量和文件内容。 --- -### Env Vars +### 环境变量 使用 `{env:VARIABLE_NAME}` 替换环境变量： @@ -650,7 +650,7 @@ opencode 将在启动时自动下载任何新的更新。您可以使用 `autoup --- -### Files +### 文件 使用 `{file:path/to/file}` 替换文件的内容： 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 503b1e1df..211df7c01 100644 --- a/packages/web/src/content/docs/zh-cn/custom-tools.mdx +++ b/packages/web/src/content/docs/zh-cn/custom-tools.mdx @@ -13,7 +13,7 @@ description: 创建 LLM 可以在 opencode 中调用的工具。 --- -### Location +### 位置 它们可以定义为： @@ -22,7 +22,7 @@ description: 创建 LLM 可以在 opencode 中调用的工具。 --- -### Structure +### 结构 创建工具最简单的方法是使用 `tool()` 帮助程序，它提供类型安全和验证。 @@ -79,7 +79,7 @@ export const multiply = tool({ --- -### Arguments +### 参数 您可以使用 `tool.schema`（即 [Zod](https://zod.dev)）来定义参数类型。 @@ -108,7 +108,7 @@ export default { --- -### Context +### 上下文 工具接收有关当前会话的上下文： diff --git a/packages/web/src/content/docs/zh-cn/ecosystem.mdx b/packages/web/src/content/docs/zh-cn/ecosystem.mdx index 92639f08d..25689beb1 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: Ecosystem +title: 生态系统 description: 使用 opencode 构建的项目和集成。 --- @@ -13,44 +13,44 @@ description: 使用 opencode 构建的项目和集成。 --- -## 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) | 使用 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 工作树 | +| 名称 | 描述 | +| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | +| [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) | 非交互式 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 生成的 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 +## 项目 | 名称 | 描述 | | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------- | @@ -68,7 +68,7 @@ description: 使用 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 9970dd4f1..d4ababa2d 100644 --- a/packages/web/src/content/docs/zh-cn/enterprise.mdx +++ b/packages/web/src/content/docs/zh-cn/enterprise.mdx @@ -1,18 +1,18 @@ --- -title: Enterprise +title: 企业版 description: 在您的组织中安全地使用 opencode。 --- import config from "../../../../config.mjs" export const email = `mailto:${config.email}` -opencode Enterprise 适用于希望确保其代码和数据永远不会离开其基础设施的组织。它可以通过使用与 SSO 和内部 AI 网关集成的集中方式配置来实现此目的。 +opencode 企业版适用于希望确保其代码和数据永远不会离开其基础设施的组织。它可以通过使用与 SSO 和内部 AI 网关集成的集中方式配置来实现此目的。 :::note opencode 不存储您的任何代码或上下文数据。 ::: -要开始使用 opencode Enterprise： +要开始使用 opencode 企业版： 1. 与您的团队进行内部试用。 2. **联系我们** 讨论定价和实施选项。 @@ -72,7 +72,7 @@ opencode 是开源的，不存储您的任何代码或上下文数据，因此 --- -### Central Config +### 中央配置 我们可以将 opencode 设置为您的整个组织使用单一的中央配置。 @@ -80,7 +80,7 @@ opencode 是开源的，不存储您的任何代码或上下文数据，因此 --- -### SSO Integration +### SSO 集成 通过中央配置，opencode 可以与您组织的 SSO 提供商集成以进行身份验证。 @@ -88,7 +88,7 @@ opencode 是开源的，不存储您的任何代码或上下文数据，因此 --- -### Internal AI Gateway +### 内部 AI 网关 通过中央配置，opencode 还可以配置为仅使用您的内部 AI 网关。 @@ -96,7 +96,7 @@ opencode 是开源的，不存储您的任何代码或上下文数据，因此 --- -### Self-hosting +### 自托管 虽然我们建议禁用共享页面以确保您的数据永远不会离开您的组织，我们还可以帮助您在您的基础设施上自行托管它们。 @@ -104,17 +104,17 @@ opencode 是开源的，不存储您的任何代码或上下文数据，因此 --- -## FAQ +## 常见问题

-什么是 opencode Enterprise？ +什么是 opencode 企业版？ -opencode Enterprise 适用于希望确保其代码和数据永远不会离开其基础设施的组织。它可以通过使用与 SSO 和内部 AI 网关集成的集中方式配置来实现此目的。 +opencode 企业版适用于希望确保其代码和数据永远不会离开其基础设施的组织。它可以通过使用与 SSO 和内部 AI 网关集成的集中方式配置来实现此目的。
-如何开始使用 opencode Enterprise？ +如何开始使用 opencode 企业版？ 与您的团队进行内部实验即可。opencode 默认情况下不存储您的代码或上下文数据，可以轻松上手。 @@ -130,7 +130,7 @@ opencode Enterprise 适用于希望确保其代码和数据永远不会离开其
-opencode Enterprise 保证我的数据安全吗？ +opencode 企业版保证我的数据安全吗？ 是的。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 25d5e2777..8e080d85f 100644 --- a/packages/web/src/content/docs/zh-cn/formatters.mdx +++ b/packages/web/src/content/docs/zh-cn/formatters.mdx @@ -7,11 +7,11 @@ description: opencode 使用特定于语言的格式化程序。 --- -## Built-in +## 内置 opencode 附带了多个适用于流行语言和框架的内置格式化程序。下面是格式化程序、支持的文件扩展名以及所需的命令或配置选项的列表。 -| Formatter | Extensions | Requirements | +| 格式化程序 | 扩展名 | 要求 | | -------------------- | -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | | gofmt | .go | `gofmt` command available | | mix | .ex, .exs, .eex, .heex, .leex, .neex, .sface | `mix` command available | @@ -67,7 +67,7 @@ opencode 附带了多个适用于流行语言和框架的内置格式化程序 每个格式化程序配置支持以下内容： -| Property | Type | Description | +| 属性 | 类型 | 描述 | | ------------- | -------- | ---------------------------------- | | `disabled` | boolean | 将其设置为 `true` 以禁用格式化程序 | | `command` | string[] | 格式化运行的命令 | diff --git a/packages/web/src/content/docs/zh-cn/github.mdx b/packages/web/src/content/docs/zh-cn/github.mdx index 4e63ace80..b9b80d0dd 100644 --- a/packages/web/src/content/docs/zh-cn/github.mdx +++ b/packages/web/src/content/docs/zh-cn/github.mdx @@ -7,7 +7,7 @@ opencode 与您的 GitHub 工作流程集成。在评论中提及 `/opencode` --- -## Features +## 功能 - **Triage issues**: 要求 opencode 调查问题并向您解释。 - **Fix and implement**: 要求 opencode 修复问题或实施功能。将在一个新的分支中工作并提交包含所有更改的 PR。 @@ -27,7 +27,7 @@ opencode github install --- -### Manual Setup +### 手动设置 或者您可以手动设置。 @@ -79,7 +79,7 @@ opencode github install --- -## Configuration +## 配置 - `model`：与 opencode 一起使用的模型。采用 `provider/model` 格式。这是 **必需的**。 - `agent`：要使用的代理。必须是一级代理。如果未找到，则从配置回退到 `default_agent` 或 `"build"`。 @@ -101,11 +101,11 @@ opencode github install --- -## 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 上下文。 | @@ -114,7 +114,7 @@ opencode 可以由以下 GitHub 事件触发： | `schedule` | 基于 Cron 的计划 | 按计划运行 opencode。需要 `prompt` 输入。输出进入日志和 PR（没有可评论的问题）。 | | `workflow_dispatch` | 从 GitHub UI 手动触发 | 通过“操作”选项卡触发 opencode。需要 `prompt` 输入。输出进入日志和 PR。 | -### Schedule Example +### 计划示例 按计划运行 opencode 以执行自动化任务： @@ -154,7 +154,7 @@ jobs: --- -### Pull Request Example +### Pull Request 示例 或更新 PR 时自动审核： @@ -195,7 +195,7 @@ jobs: --- -### Issue Triage Example +### Issue 分类示例 自动分类新问题。此示例过滤超过 30 天的账户以减少垃圾邮件： @@ -250,7 +250,7 @@ jobs: --- -## Custom Prompt +## 自定义提示 覆盖默认提示，为您的工作流程自定义 opencode 的行为。 diff --git a/packages/web/src/content/docs/zh-cn/gitlab.mdx b/packages/web/src/content/docs/zh-cn/gitlab.mdx index c63369f8d..e9c474e62 100644 --- a/packages/web/src/content/docs/zh-cn/gitlab.mdx +++ b/packages/web/src/content/docs/zh-cn/gitlab.mdx @@ -17,7 +17,7 @@ opencode 在常规 GitLab 管道中工作。您可以将其构建为管道 [CI --- -### Features +### 功能 - **Use custom configuration per job**: 使用自定义配置目录配置 opencode，例如 `./config/#custom-directory` 以启用或禁用 opencode 调用的功能。 - **Authentication**: Uses OIDC for secure authentication @@ -25,7 +25,7 @@ opencode 在常规 GitLab 管道中工作。您可以将其构建为管道 [CI --- -### Setup +### 设置 1. 将 opencode 身份验证 JSON 作为文件类型 CI 环境变量存储在 **Settings** > **CI/CD** > **Variables** 下。确保将它们标记为“隐藏和隐藏”。 2. 将以下内容添加到您的 `.gitlab-ci.yml` 文件中。 @@ -51,7 +51,7 @@ opencode 与您的 GitLab 工作流程集成。 --- -### Features +### 功能 - **Triage issues**: 要求 opencode 调查问题并向您解释。 - **Fix and implement**: 要求 opencode 修复问题或实施功能。 @@ -60,7 +60,7 @@ opencode 与您的 GitLab 工作流程集成。 --- -### Setup +### 设置 opencode 在您的 GitLab CI/CD 管道中运行，您需要进行以下设置： @@ -156,7 +156,7 @@ opencode 在您的 GitLab CI/CD 管道中运行，您需要进行以下设置： --- -### Examples +### 示例 以下是如何在 GitLab 中使用 opencode 的一些示例。 diff --git a/packages/web/src/content/docs/zh-cn/ide.mdx b/packages/web/src/content/docs/zh-cn/ide.mdx index 64999cc23..fb3a92bec 100644 --- a/packages/web/src/content/docs/zh-cn/ide.mdx +++ b/packages/web/src/content/docs/zh-cn/ide.mdx @@ -28,7 +28,7 @@ opencode 与 VS Code、Cursor 或任何支持终端的 IDE 集成。只需在终 --- -### Manual Installation +### 手动安装 在扩展市场中搜索 **opencode**，然后单击 **Install**。 diff --git a/packages/web/src/content/docs/zh-cn/index.mdx b/packages/web/src/content/docs/zh-cn/index.mdx index ad1389bc2..bc7122137 100644 --- a/packages/web/src/content/docs/zh-cn/index.mdx +++ b/packages/web/src/content/docs/zh-cn/index.mdx @@ -1,5 +1,5 @@ --- -title: Introduction +title: 介绍 description: 开始使用 opencode。 --- @@ -15,7 +15,7 @@ export const console = config.console --- -#### Prerequisites +#### 先决条件 要在终端中使用 opencode，您需要： @@ -89,17 +89,17 @@ curl -fsSL https://opencode.ai/install | bash #### Windows -:::tip[Recommended: 使用 WSL] +:::tip[推荐：使用 WSL] 为了在 Windows 上获得最佳体验，我们建议使用 [Windows Subsystem for Linux (WSL)](/docs/windows-wsl)。它提供了更好的性能并与 opencode 的功能完全兼容。 ::: -- **Using Chocolatey** +- **使用 Chocolatey** ```bash choco install opencode ``` -- **Using Scoop** +- **使用 Scoop** ```bash scoop install opencode @@ -111,7 +111,7 @@ curl -fsSL https://opencode.ai/install | bash npm install -g opencode-ai ``` -- **Using Mise** +- **使用 Mise** ```bash mise use -g github:anomalyco/opencode @@ -157,7 +157,7 @@ curl -fsSL https://opencode.ai/install | bash --- -## Initialization +## 初始化 现在您已经配置了提供商，您可以导航到一个项目 你想继续工作。 @@ -197,7 +197,7 @@ opencode --- -### Asking Questions +### 提问 您可以要求 opencode 向您解释代码库。 @@ -213,13 +213,13 @@ How is authentication handled in @packages/functions/src/api/index.ts --- -### Adding Features +### 添加功能 您可以要求 opencode 向您的项目添加新功能。但是我们首先建议要求它制定一个计划。 -1. **Create a plan** +1. **创建计划** - opencode 有一个 _Plan Mode_，该模式禁止其进行更改和 + opencode 有一个 _计划模式_，该模式禁止其进行更改和 相反，建议 _如何_ 实现该功能。 使用 **Tab** 键切换到它。您会在右下角有一个指示符。 @@ -244,7 +244,7 @@ How is authentication handled in @packages/functions/src/api/index.ts 想。 ::: -2. **Iterate on the plan** +2. **迭代计划** 一旦它为您提供了计划，您就可以提供反馈或添加更多详细信息。 @@ -260,9 +260,9 @@ How is authentication handled in @packages/functions/src/api/index.ts opencode 可以扫描您提供的任何图像并将其添加到提示中。您可以 通过将图像拖放到终端中来完成此操作。 -3. **Build the feature** +3. **构建功能** - 一旦您对计划感到满意，请切换回 _Build Mode_ + 一旦您对计划感到满意，请切换回 _构建模式_ 再次按 **Tab** 键。 ```bash frame="none" @@ -277,7 +277,7 @@ How is authentication handled in @packages/functions/src/api/index.ts --- -### Making Changes +### 进行更改 对于更直接的更改，您可以要求 opencode 直接构建它 无需先审查计划。 diff --git a/packages/web/src/content/docs/zh-cn/keybinds.mdx b/packages/web/src/content/docs/zh-cn/keybinds.mdx index fb1188676..0ecd7c9bf 100644 --- a/packages/web/src/content/docs/zh-cn/keybinds.mdx +++ b/packages/web/src/content/docs/zh-cn/keybinds.mdx @@ -1,5 +1,5 @@ --- -title: Keybinds +title: 快捷键 description: 自定义您的按键绑定。 --- @@ -105,7 +105,7 @@ opencode 有一个按键绑定列表，您可以通过 opencode 配置进行自 --- -## Leader key +## Leader 键 opencode 对大多数按键绑定使用 `leader` 键。这可以避免终端中的冲突。 @@ -115,7 +115,7 @@ opencode 对大多数按键绑定使用 `leader` 键。这可以避免终端中 --- -## Disable keybind +## 禁用按键绑定 您可以通过将按键添加到您的配置中并使用值“none”来禁用按键绑定。 @@ -130,11 +130,11 @@ opencode 对大多数按键绑定使用 `leader` 键。这可以避免终端中 --- -## Desktop prompt shortcuts +## 桌面提示快捷键 opencode 桌面应用程序提示输入支持常见的 Readline/Emacs 风格的文本编辑快捷方式。这些是内置的，目前无法通过 `opencode.json` 进行配置。 -| Shortcut | Action | +| 快捷键 | 动作 | | -------- | ------------------------- | | `ctrl+a` | 移至当前行起点 | | `ctrl+e` | 移至当前行尾 | diff --git a/packages/web/src/content/docs/zh-cn/lsp.mdx b/packages/web/src/content/docs/zh-cn/lsp.mdx index 184c8be98..cc81810cc 100644 --- a/packages/web/src/content/docs/zh-cn/lsp.mdx +++ b/packages/web/src/content/docs/zh-cn/lsp.mdx @@ -1,5 +1,5 @@ --- -title: LSP Servers +title: LSP 服务器 description: opencode 与您的 LSP 服务器集成。 --- @@ -7,11 +7,11 @@ opencode 与您的语言服务器协议 (LSP) 集成，以帮助 LLM 与您的 --- -## Built-in +## 内置 opencode 附带了多种适用于流行语言的内置 LSP 服务器： -| LSP Server | Extensions | Requirements | +| LSP 服务器 | 扩展名 | 要求 | | ------------------ | ------------------------------------------------------------------- | ------------------------------------------------ | | astro | .astro | Astro 项目自动安装 | | bash | .sh, .bash, .zsh, .ksh | 自动安装 bash-language-server | @@ -63,7 +63,7 @@ opencode 附带了多种适用于流行语言的内置 LSP 服务器： --- -## Configure +## 配置 您可以通过 opencode 配置中的 `lsp` 部分自定义 LSP 服务器。 @@ -76,7 +76,7 @@ opencode 附带了多种适用于流行语言的内置 LSP 服务器： 每个 LSP 服务器支持以下功能： -| Property | Type | Description | +| 属性 | 类型 | 描述 | | ---------------- | -------- | ----------------------------------- | | `disabled` | boolean | 将其设置为 `true` 以禁用 LSP 服务器 | | `command` | string[] | 启动 LSP 服务器的命令 | @@ -88,7 +88,7 @@ opencode 附带了多种适用于流行语言的内置 LSP 服务器： --- -### Environment Variables +### 环境变量 启动 LSP 服务器时使用 `env` 参数设置环境变量： @@ -107,7 +107,7 @@ opencode 附带了多种适用于流行语言的内置 LSP 服务器： --- -### Initialization Options +### 初始化选项 使用 `initialization` 属性将初始化选项传递给 LSP 服务器。这些是在 LSP `initialize` 请求发送期间的服务器特定设置： @@ -132,7 +132,7 @@ opencode 附带了多种适用于流行语言的内置 LSP 服务器： --- -### Disabling LSP servers +### 禁用 LSP 服务器 要全局禁用 **所有** LSP 服务，将 `lsp` 设置为 `false`： @@ -158,7 +158,7 @@ opencode 附带了多种适用于流行语言的内置 LSP 服务器： --- -### Custom LSP servers +### 自定义 LSP 服务器 您可以通过指定命令和文件扩展名来添加自定义 LSP 服务器： @@ -176,7 +176,7 @@ opencode 附带了多种适用于流行语言的内置 LSP 服务器： --- -## Additional Information +## 其他信息 ### PHP Intelephense 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 e884a76d8..eb0015638 100644 --- a/packages/web/src/content/docs/zh-cn/mcp-servers.mdx +++ b/packages/web/src/content/docs/zh-cn/mcp-servers.mdx @@ -1,5 +1,5 @@ --- -title: MCP服务器 +title: MCP 服务器 description: 添加本地和远程MCP工具。 --- @@ -9,7 +9,7 @@ description: 添加本地和远程MCP工具。 --- -#### 注意事項 +#### 注意事项 当您使用 MCP 服务器时，它会添加到上下文中。如果您有很多工具，这会很快增加。因此，我们建议您选择使用哪些 MCP 服务器。 @@ -21,7 +21,7 @@ MCP服务器会添加到您的上下文中，因此您需要小心启用哪些 --- -## 使能夠 +## 启用 您可以在`mcp`下的[opencode配置](https://opencode.ai/docs/config/)中定义MCP服务器。为每个MCP添加唯一的名称。当提示LLM时，您可以通过名称引用该MCP。 @@ -44,7 +44,7 @@ MCP服务器会添加到您的上下文中，因此您需要小心启用哪些 --- -### 覆盖遠程默認值 +### 覆盖远程默认值 组织可以通过其 `.well-known/opencode` 端点提供默认的 MCP 服务器。这些服务器可能默认被禁用，允许用户选择他们需要的服务器。 @@ -67,7 +67,7 @@ MCP服务器会添加到您的上下文中，因此您需要小心启用哪些 --- -## 当地的 +## 本地 使用`type`将本地MCP服务器添加到MCP对像中的`"local"`。 @@ -112,11 +112,11 @@ use the mcp_everything tool to add the number 3 and 4 --- -#### 選項 +#### 选项 以下是配置本地 MCP 服务器的所有选项。 -| 選項 | 類型 | 必填 | 描述 | +| 选项 | 类型 | 必填 | 描述 | | ------------- | ------ | ---- | -------------------------------------------------------------- | | `type` | 字符串 | 是 | MCP 服务器连接类型，必须是`"local"`。 | | `command` | 数据库 | 是 | 运行 MCP 服务器的命令和参数。 | @@ -126,7 +126,7 @@ use the mcp_everything tool to add the number 3 and 4 --- -## 偏僻的 +## 远程 通过将`type`设置为ZZPH1Z添加远程MCP服务器。 @@ -150,9 +150,9 @@ use the mcp_everything tool to add the number 3 and 4 --- -#### 選項 +#### 选项 -| 選項 | 類型 | 必填 | 描述 | +| 选项 | 类型 | 必填 | 描述 | | ---------- | ------ | ---- | -------------------------------------------------------------- | | `headers` | 字符串 | 是 | MCP 服务器连接类型，必须是`type`。 | | `"remote"` | 字符串 | 是 | 远程 MCP 服务器的 URL。 | @@ -163,7 +163,7 @@ use the mcp_everything tool to add the number 3 and 4 --- -## 開放認證 +## OAuth opencode自动处理远程MCP服务器的OAuth身份验证。当服务器需要身份验证时，opencode将： @@ -173,7 +173,7 @@ opencode自动处理远程MCP服务器的OAuth身份验证。当服务器需要 --- -### 自动的 +### 自动 对于大多数支持 OAuth 的 MCP 配置服务器，不需要特殊配置。只需远程服务器： @@ -193,7 +193,7 @@ opencode自动处理远程MCP服务器的OAuth身份验证。当服务器需要 --- -### 預登記 +### 预注册 如果您有来自MCP服务器强大的客户端，则可以配置它们： @@ -216,7 +216,7 @@ opencode自动处理远程MCP服务器的OAuth身份验证。当服务器需要 --- -### 正在驗證 +### 身份验证 您可以手动觸發身份验证或管理憑據。 @@ -266,14 +266,14 @@ opencode mcp logout my-oauth-server #### OAuth 选项 -| 選項 | 類型 | 描述 | +| 选项 | 类型 | 描述 | | -------------- | --------------- | --------------------------------------------------- | | `false` | 对象 \| `oauth` | OAuth 配置对象，或 `false` 以取消 OAuth 自动检测。 | | `clientId` | 字符串 | OAuth 客户端 ID。如果未提供，将尝试动态客户端注册。 | | `clientSecret` | 字符串 | OAuth客户端密钥（如果需要授权服务器）。 | | `scope` | 字符串 | 授权期间请求的 OAuth 范围。 | -#### 偵錯 +#### 调试 如果远程MCP服务器无法进行身份验证，您可以通过以下方式诊断问题： @@ -295,7 +295,7 @@ opencode mcp debug my-oauth-server --- -### 全球的 +### 全局 这意味著您可以全局启用或禁用它們。 diff --git a/packages/web/src/content/docs/zh-cn/models.mdx b/packages/web/src/content/docs/zh-cn/models.mdx index d9376a431..1a9b5b4c0 100644 --- a/packages/web/src/content/docs/zh-cn/models.mdx +++ b/packages/web/src/content/docs/zh-cn/models.mdx @@ -25,7 +25,7 @@ opencode 使用 [AI SDK](https://ai-sdk.dev/) 和 [Models.dev](https://models.de --- -## 推薦模型 +## 推荐模型 那裡有很多模型，每週都会有新模型問世。 @@ -46,7 +46,7 @@ opencode 使用 [AI SDK](https://ai-sdk.dev/) 和 [Models.dev](https://models.de --- -## 设置默認值 +## 设置默认值 要将其中之一设置为默認模型，您可以在您的 打開代碼配置。 @@ -135,11 +135,11 @@ opencode 使用 [AI SDK](https://ai-sdk.dev/) 和 [Models.dev](https://models.de --- -## 變體 +## 变体 许多模型支持具有不同配置的多种变体。opencode附带了流行建设的内置默认变体。 -### 内置變體 +### 内置变体 opencode 附带了许多重大的默认变体： @@ -168,7 +168,7 @@ opencode 附带了许多重大的默认变体： 该列表并不全面。許多其他提供商也有内置的默認值。 ::: -### 定制變體 +### 自定义变体 您可以覆盖現有變體或添加您自己的變體： @@ -195,13 +195,13 @@ opencode 附带了许多重大的默认变体： } ``` -### 循環變體 +### 循环变体 使用按键绑定`variant_cycle`在变体之间快速切换。 [了解更多](/docs/keybinds)。 --- -## 加載模型 +## 加载模型 当opencode启动时，它会按以下优先顺序检查模型： diff --git a/packages/web/src/content/docs/zh-cn/modes.mdx b/packages/web/src/content/docs/zh-cn/modes.mdx index 1c9091d63..f4c2c78fd 100644 --- a/packages/web/src/content/docs/zh-cn/modes.mdx +++ b/packages/web/src/content/docs/zh-cn/modes.mdx @@ -10,26 +10,26 @@ description: 不同的模式適用于不同的用例。 opencode 中的模式允许自定义不同的示例行为、工具和提示。 -它具有两种内置模式：**構建**和**計劃**。您可以定制 +它具有两种内置模式：**构建**和**计划**。您可以定制 这些或通过 opencode 配置配置您自己的。 您可以在会话期間在模式之間切換或在配置文件中配置它們。 --- -## 內建 +## 内置 opencode 有两种内置模式。 --- -### 建造 +### 构建 構建是启用所有工具的**默認**模式。这是開發工作的標準模式，您需要完全访问文件操作和系統命令。 --- -### 計劃 +### 计划 专为規劃和分析而設計的受限模式。在計劃模式下，默認情况下禁用以下工具： @@ -42,7 +42,7 @@ opencode 有两种内置模式。 --- -## 交換 +## 切换 您可以在会话期间使用 _Tab_ 键在模式之间切换。或者您配置的 `switch_mode` 键绑定。 @@ -132,7 +132,7 @@ Markdown 文件名成为模式名称（例如，`review.md` 创建`review` 模 --- -### 溫度 +### 温度 使用`temperature`配置控制AI响应的随机性和创造。较低的值使响应更加集中和确定，而较高的值则增加创造力和可变性。 @@ -177,7 +177,7 @@ Markdown 文件名成为模式名称（例如，`review.md` 创建`review` 模 --- -### 迅速的 +### 提示词 使用 `prompt` 配置为模式指定自定义系统提示文件。提示文件应包含特定于该模式用途的指令。 @@ -241,7 +241,7 @@ Markdown 文件名成为模式名称（例如，`review.md` 创建`review` 模 --- -## 自定義模式 +## 自定义模式 您可以通过将自定義模式添加到配置來创建自己的自定義模式。以下是使用这两种方法的示例： @@ -322,8 +322,8 @@ Priorities: 以下是不同模式的一些常見用例。 -- **構建模式**：启用所有工具的完整開發工作 -- **計劃模式**：分析和計劃，無需更改 +- **构建模式**：启用所有工具的完整開發工作 +- **计划模式**：分析和計劃，無需更改 - **审阅模式**：使用只讀访问权限和文档工具進行代碼审阅 - **调试模式**：专注于启用bash和读取工具的调查 - **文档模式**：使用文件操作但不使用系統命令的文档編寫 diff --git a/packages/web/src/content/docs/zh-cn/network.mdx b/packages/web/src/content/docs/zh-cn/network.mdx index 3cb6f4810..f64d099c6 100644 --- a/packages/web/src/content/docs/zh-cn/network.mdx +++ b/packages/web/src/content/docs/zh-cn/network.mdx @@ -1,5 +1,5 @@ --- -title: 網絡 +title: 网络 description: 配置代理和自定義證書。 --- @@ -7,7 +7,7 @@ opencode支持企业网络环境的标准代理环境变量和自定义证书。 --- -## 代理人 +## 代理 opencode 尊重标准代理环境变量。 @@ -30,7 +30,7 @@ TUI 与本地 HTTP 服务器通信。您必须绕过此连接的代理以防止 --- -### 認證 +### 认证 如果您的代理需要基本身份验证，请在 URL 中包含凭据。 @@ -46,7 +46,7 @@ export HTTPS_PROXY=http://username:password@proxy.example.com:8080 --- -## 定制證書 +## 自定义证书 如果您的企业使用自定义 CA 进行 HTTPS 连接，请配置 opencode 以信任它们。 diff --git a/packages/web/src/content/docs/zh-cn/permissions.mdx b/packages/web/src/content/docs/zh-cn/permissions.mdx index 65f7d4dee..47f7ef95d 100644 --- a/packages/web/src/content/docs/zh-cn/permissions.mdx +++ b/packages/web/src/content/docs/zh-cn/permissions.mdx @@ -9,7 +9,7 @@ opencode 使用`permission` 配置来决定给定的操作是否应自动运行 --- -## 行動 +## 动作 每个权限规则解析为以下之一： @@ -45,7 +45,7 @@ opencode 使用`permission` 配置来决定给定的操作是否应自动运行 --- -## 粒度规则（对象語法） +## 粒度规则（对象语法） 对于大多數权限，您可以使用对像根據工具輸入应用不同的操作。 @@ -169,7 +169,7 @@ opencode权限由工具名称和一些安全防护措施决定： --- -## “問”的作用是什麼 +## “询问”的作用是什么 当 opencode 提示批准时，UI 会提供清晰的结果： @@ -181,7 +181,7 @@ opencode权限由工具名称和一些安全防护措施决定： --- -## 代理商 +## 代理 您可以覆盖每个代理的权限。代理权限与全局​​配置合并，代理规则优先。 [了解更多](/docs/agents#permissions)关于代理权限。 diff --git a/packages/web/src/content/docs/zh-cn/plugins.mdx b/packages/web/src/content/docs/zh-cn/plugins.mdx index c45d86f55..3a4a80753 100644 --- a/packages/web/src/content/docs/zh-cn/plugins.mdx +++ b/packages/web/src/content/docs/zh-cn/plugins.mdx @@ -15,7 +15,7 @@ description: 编写您自己的插件来扩展 opencode。 --- -### 從本地文件 +### 从本地文件 将 JavaScript 或 TypeScript 文件放置在插件目录中。 @@ -51,7 +51,7 @@ description: 编写您自己的插件来扩展 opencode。 --- -### 加載顺序 +### 加载顺序 插件從所有源加載，所有掛鉤按顺序運行。加載顺序为： @@ -71,7 +71,7 @@ description: 编写您自己的插件来扩展 opencode。 --- -### 依賴關係 +### 依赖关系 本地插件和自定义工具可以使用外部 npm 包。将 `package.json` 添加到您的配置目录，其中包含您需要的依赖项。 @@ -101,7 +101,7 @@ export const MyPlugin = async (ctx) => { --- -### 基本結構 +### 基本结构 ```js title=".opencode/plugins/example.js" export const MyPlugin = async ({ project, client, $, directory, worktree }) => { @@ -139,7 +139,7 @@ export const MyPlugin: Plugin = async ({ project, client, $, directory, worktree --- -### 活动 +### 事件 插件可以訂閱事件，如下面的示例部分所示。以下是可用的不同事件的列表。 @@ -152,11 +152,11 @@ export const MyPlugin: Plugin = async ({ project, client, $, directory, worktree - `file.edited` - `file.watcher.updated` -#### 安装活动 +#### 安装事件 - `installation.updated` -#### LSP活动 +#### LSP 事件 - `lsp.client.diagnostics` - `lsp.updated` @@ -173,11 +173,11 @@ export const MyPlugin: Plugin = async ({ project, client, $, directory, worktree - `permission.asked` - `permission.replied` -#### 服務器事件 +#### 服务器事件 - `server.connected` -#### 会话活动 +#### 会话事件 - `session.created` - `session.compacted` @@ -188,11 +188,11 @@ export const MyPlugin: Plugin = async ({ project, client, $, directory, worktree - `session.status` - `session.updated` -#### 都都活动 +#### 待办事项事件 - `todo.updated` -#### 殼牌活动 +#### Shell 事件 - `shell.env` @@ -201,7 +201,7 @@ export const MyPlugin: Plugin = async ({ project, client, $, directory, worktree - `tool.execute.after` - `tool.execute.before` -#### TUI 活动 +#### TUI 事件 - `tui.prompt.append` - `tui.command.execute` @@ -215,7 +215,7 @@ export const MyPlugin: Plugin = async ({ project, client, $, directory, worktree --- -### 發送通知 +### 发送通知 当某些事件發生時發送通知： @@ -258,7 +258,7 @@ export const EnvProtection = async ({ project, client, $, directory, worktree }) --- -### 注入環境變量 +### 注入环境变量 将环境变量注入所有shell执行（AI工具和用户终端）： @@ -275,7 +275,7 @@ export const InjectEnvPlugin = async () => { --- -### 定制工具 +### 自定义工具 插件还可以向 opencode 添加自定义工具： @@ -310,7 +310,7 @@ export const CustomToolsPlugin: Plugin = async (ctx) => { --- -### 記錄 +### 日志 使用 `client.app.log()` 而不是 `console.log` 进行成型日志记录： @@ -331,7 +331,7 @@ export const MyPlugin = async ({ client }) => { --- -### 壓實鉤 +### 压缩钩子 自定義壓縮会话時包含的上下文： diff --git a/packages/web/src/content/docs/zh-cn/providers.mdx b/packages/web/src/content/docs/zh-cn/providers.mdx index 64d7438e6..b9b35d619 100644 --- a/packages/web/src/content/docs/zh-cn/providers.mdx +++ b/packages/web/src/content/docs/zh-cn/providers.mdx @@ -28,7 +28,7 @@ opencode 使用 [AI SDK](https://ai-sdk.dev/) 和 [Models.dev](https://models.de --- -#### 基本網址 +#### 基本网址 您可以通过设置 `baseURL` 选项来自定义任何提供商的基本 URL。这在使用代理服务或自定义端点时非常有用。 @@ -47,7 +47,7 @@ opencode 使用 [AI SDK](https://ai-sdk.dev/) 和 [Models.dev](https://models.de --- -## opencode 一代 +## OpenCode Zen OpenCode Zen 是opencode团队提供的模型列表，这些模型已被 经测试和验证可与opencode良好配合。 [了解更多](/docs/zen)。 @@ -94,7 +94,7 @@ OpenCode Zen 是opencode团队提供的模型列表，这些模型已被 --- -### 302.艾伊 +### 302.AI 1. Head over to the [302.AI console](https://302.ai/), create an account, and generate an API key. @@ -121,7 +121,7 @@ OpenCode Zen 是opencode团队提供的模型列表，这些模型已被 --- -### 亞馬遜基岩 +### Amazon Bedrock 相当于 Amazon Bedrock 与 opencode 结合使用： @@ -251,7 +251,7 @@ OpenCode Zen 是opencode团队提供的模型列表，这些模型已被 --- -### 人择 +### Anthropic 1. 注册后，执行`/connect`命令并选择Anthropic。 @@ -289,7 +289,7 @@ Using your Claude Pro/Max subscription in opencode is not officially supported b --- -### 天蓝色 OpenAI +### Azure OpenAI :::note 如果遇到“抱歉，但我无法协助该请求”错误，请尝试将 Azure 资源中的内容筛选器从 **DefaultV2** 更改为 **Default**。 @@ -387,7 +387,7 @@ Using your Claude Pro/Max subscription in opencode is not officially supported b --- -### 巴吉度獵犬 +### Baseten 1. Head over to the [Baseten](https://app.baseten.co/), create an account, and generate an API key. @@ -414,7 +414,7 @@ Using your Claude Pro/Max subscription in opencode is not officially supported b --- -### 大腦 +### Cerebras 1. Head over to the [Cerebras console](https://inference.cerebras.ai/), create an account, and generate an API key. @@ -441,7 +441,7 @@ Using your Claude Pro/Max subscription in opencode is not officially supported b --- -### Cloudflare AI闸道器 +### Cloudflare AI Gateway Cloudflare AI Gateway lets you access models from OpenAI, Anthropic, Workers AI, and more through a unified endpoint. With [Unified Billing](https://developers.cloudflare.com/ai-gateway/features/unified-billing/) you don't need separate API keys for each provider. @@ -499,7 +499,7 @@ Cloudflare AI Gateway lets you access models from OpenAI, Anthropic, Workers AI, --- -### 皮質 +### Cortecs 1. Head over to the [Cortecs console](https://cortecs.ai/), create an account, and generate an API key. @@ -526,7 +526,7 @@ Cloudflare AI Gateway lets you access models from OpenAI, Anthropic, Workers AI, --- -### 深度搜索 +### DeepSeek 1. Head over to the [DeepSeek console](https://platform.deepseek.com/), create an account, and click **Create new API key**. @@ -553,7 +553,7 @@ Cloudflare AI Gateway lets you access models from OpenAI, Anthropic, Workers AI, --- -### 深層基礎設施 +### Deep Infra 1. Head over to the [Deep Infra dashboard](https://deepinfra.com/dash), create an account, and generate an API key. @@ -580,7 +580,7 @@ Cloudflare AI Gateway lets you access models from OpenAI, Anthropic, Workers AI, --- -### 韌體 +### Firmware 1. Head over to the [Firmware dashboard](https://app.firmware.ai/signup), create an account, and generate an API key. @@ -607,7 +607,7 @@ Cloudflare AI Gateway lets you access models from OpenAI, Anthropic, Workers AI, --- -### 煙花人工智慧 +### Fireworks AI 1. Head over to the [Fireworks AI console](https://app.fireworks.ai/), create an account, and click **Create API Key**. @@ -634,7 +634,7 @@ Cloudflare AI Gateway lets you access models from OpenAI, Anthropic, Workers AI, --- -### GitLab 二人组 +### GitLab Duo GitLab Duo 通过 GitLab 的人工代理提供具有本机工具呼叫功能的人工智慧代理聊天。 @@ -820,7 +820,7 @@ Some models need to be manually enabled in your [GitHub Copilot settings](https: --- -### 谷歌顶点人工智能 +### Google Vertex AI Google Vertex AI 与 opencode 结合使用： @@ -864,7 +864,7 @@ The `global` region improves availability and reduces errors at no extra cost. U --- -### 格羅克 +### Groq 1. Head over to the [Groq console](https://console.groq.com/), click **Create API Key**, and copy the key. @@ -891,7 +891,7 @@ The `global` region improves availability and reduces errors at no extra cost. U --- -### 抱臉 +### Hugging Face [Hugging Face Inference Providers](https://huggingface.co/docs/inference-providers) provides access to open models supported by 17+ providers. @@ -920,7 +920,7 @@ The `global` region improves availability and reduces errors at no extra cost. U --- -### 螺旋錐 +### Helicone [Helicone](https://helicone.ai) is an LLM observability platform that provides logging, monitoring, and analytics for your AI applications. The Helicone AI Gateway routes your requests to the appropriate provider automatically based on the model. @@ -1033,7 +1033,7 @@ See the [Helicone Header Directory](https://docs.helicone.ai/helicone-headers/he --- -### 呼叫.cpp +### llama.cpp You can configure opencode to use local models through [llama.cpp's](https://github.com/ggml-org/llama.cpp) llama-server utility @@ -1071,7 +1071,7 @@ You can configure opencode to use local models through [llama.cpp's](https://git --- -### IO网路 +### IO.NET IO.NET提供了17种针对各种例子进行优化的模型： @@ -1100,7 +1100,7 @@ IO.NET提供了17种针对各种例子进行优化的模型： --- -### LM工作室 +### LM Studio 您可以通过使用本地模型来使用 LM Studio 配置opencode。 @@ -1134,7 +1134,7 @@ IO.NET提供了17种针对各种例子进行优化的模型： --- -### 登月人工智慧 +### Moonshot AI 要使用 Moonshot AI 中的 Kimi K2： @@ -1163,7 +1163,7 @@ IO.NET提供了17种针对各种例子进行优化的模型： --- -### 最小最大 +### MiniMax 1. Head over to the [MiniMax API Console](https://platform.minimax.io/login), create an account, and generate an API key. @@ -1190,7 +1190,7 @@ IO.NET提供了17种针对各种例子进行优化的模型： --- -### Nebius 代币工厂 +### Nebius Token Factory 1. Head over to the [Nebius Token Factory console](https://tokenfactory.nebius.com/), create an account, and click **Add Key**. @@ -1217,7 +1217,7 @@ IO.NET提供了17种针对各种例子进行优化的模型： --- -### 成为 +### Ollama 您可以使用 Ollama 配置 opencode 本地模型。 @@ -1259,7 +1259,7 @@ Ollama can automatically configure itself for opencode. See the [Ollama integrat --- -### 奧拉馬雲 +### Ollama Cloud 相当于 Ollama Cloud 与 opencode 一起使用： @@ -1298,7 +1298,7 @@ Ollama can automatically configure itself for opencode. See the [Ollama integrat --- -### 开放人工智能 +### OpenAI We recommend signing up for [ChatGPT Plus or Pro](https://chatgpt.com/pricing). @@ -1331,7 +1331,7 @@ We recommend signing up for [ChatGPT Plus or Pro](https://chatgpt.com/pricing). --- -### opencode 一代 +### OpenCode Zen OpenCode Zen 是 opencode 团队提供的经过测试和验证的模型列表。 [了解更多](/docs/zen)。 @@ -1360,7 +1360,7 @@ OpenCode Zen 是 opencode 团队提供的经过测试和验证的模型列表。 --- -### 開放路由器 +### OpenRouter 1. Head over to the [OpenRouter dashboard](https://openrouter.ai/settings/keys), click **Create API Key**, and copy the key. @@ -1424,7 +1424,7 @@ OpenCode Zen 是 opencode 团队提供的经过测试和验证的模型列表。 --- -### SAP人工智慧核心 +### SAP AI Core SAP AI Core跨统一平台提供对OpenAI、Anthropic、Google、Amazon、Meta、Mistral和AI21的40多个模型的访问。 @@ -1479,7 +1479,7 @@ SAP AI Core跨统一平台提供对OpenAI、Anthropic、Google、Amazon、Meta --- -### OVHcloud AI 端点 +### OVHcloud AI Endpoints 1. Head over to the [OVHcloud panel](https://ovh.com/manager). Navigate to the `Public Cloud` section, `AI & Machine Learning` > `AI Endpoints` and in `API Keys` tab, click **Create a new API key**. @@ -1506,7 +1506,7 @@ SAP AI Core跨统一平台提供对OpenAI、Anthropic、Google、Amazon、Meta --- -### 斯卡威 +### Scaleway To use [Scaleway Generative APIs](https://www.scaleway.com/en/docs/generative-apis/) with Opencode: @@ -1535,7 +1535,7 @@ To use [Scaleway Generative APIs](https://www.scaleway.com/en/docs/generative-ap --- -### 一起人工智慧 +### Together AI 1. Head over to the [Together AI console](https://api.together.ai), create an account, and click **Add Key**. @@ -1562,7 +1562,7 @@ To use [Scaleway Generative APIs](https://www.scaleway.com/en/docs/generative-ap --- -### 威尼斯人工智慧 +### Venice AI 1. Head over to the [Venice AI console](https://venice.ai), create an account, and generate an API key. @@ -1589,7 +1589,7 @@ To use [Scaleway Generative APIs](https://www.scaleway.com/en/docs/generative-ap --- -### Vercel人工智慧闸道器 +### Vercel AI Gateway Vercel AI Gateway 可以让您跨统一端点访问来自 OpenAI、Anthropic、Google、xAI 等的模型。模型按标价提供，不加价。 @@ -1645,7 +1645,7 @@ Vercel AI Gateway 可以让您跨统一端点访问来自 OpenAI、Anthropic、G --- -### 人工智慧 +### xAI 1. Head over to the [xAI console](https://console.x.ai/), create an account, and generate an API key. @@ -1672,7 +1672,7 @@ Vercel AI Gateway 可以让您跨统一端点访问来自 OpenAI、Anthropic、G --- -### 扎艾 +### Z.AI 1. Head over to the [Z.AI API console](https://z.ai/manage-apikey/apikey-list), create an account, and click **Create a new API key**. @@ -1701,7 +1701,7 @@ Vercel AI Gateway 可以让您跨统一端点访问来自 OpenAI、Anthropic、G --- -### 多路復用器 +### ZenMux 1. Head over to the [ZenMux dashboard](https://zenmux.ai/settings/keys), click **Create API Key**, and copy the key. @@ -1743,7 +1743,7 @@ Vercel AI Gateway 可以让您跨统一端点访问来自 OpenAI、Anthropic、G --- -## 定製提供商 +## 自定义提供商 要添加 `/connect` 命令中未列出的任何 **OpenAI 兼容**提供商： diff --git a/packages/web/src/content/docs/zh-cn/rules.mdx b/packages/web/src/content/docs/zh-cn/rules.mdx index 5331e7fae..c9135c299 100644 --- a/packages/web/src/content/docs/zh-cn/rules.mdx +++ b/packages/web/src/content/docs/zh-cn/rules.mdx @@ -52,15 +52,15 @@ This is an SST v3 monorepo with TypeScript. The project uses bun workspaces for --- -## 類型 +## 类型 opencode 还支持从多个位置读取 `AGENTS.md` 文件。这有不同的目的。 -### 专案 +### 项目 将 `AGENTS.md` 放置在项目根目录中以获取特定于项目的规则。这些仅适用于您在此目录或子目录中工作时。 -### 全球的 +### 全局 您还可以在 `~/.config/opencode/AGENTS.md` 文件中包含全局规则。这适用于所有opencode会话。 @@ -84,7 +84,7 @@ export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills --- -## 优先級 +## 优先级 当opencode启动时，它会按以下顺序查找规则文件： @@ -96,7 +96,7 @@ export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills --- -## 定制說明 +## 自定义指令 您可以在 `opencode.json` 或全局 `~/.config/opencode/opencode.json` 中指定自定义指令文件。这允许您和您的团队重用现有规则，而不必将它们复制到 AGENTS.md。 diff --git a/packages/web/src/content/docs/zh-cn/sdk.mdx b/packages/web/src/content/docs/zh-cn/sdk.mdx index 515fec988..0a8f63fa1 100644 --- a/packages/web/src/content/docs/zh-cn/sdk.mdx +++ b/packages/web/src/content/docs/zh-cn/sdk.mdx @@ -1,5 +1,5 @@ --- -title: 軟體開發工具包 +title: SDK description: opencode 服务器的类型不同于安全 JS 客户端。 --- @@ -23,7 +23,7 @@ npm install @opencode-ai/sdk --- -## 建立客戶端 +## 创建客户端 创建opencode的示例项： @@ -35,9 +35,9 @@ const { client } = await createOpencode() 这会同時启动服务器和客戶端 -#### 選項 +#### 选项 -| 選項 | 型別 | 描述 | 默认 | +| 选项 | 型别 | 描述 | 默认 | | ---------- | ------------- | ------------------------------ | ----------- | | `hostname` | `string` | 服务器主机名 | `127.0.0.1` | | `port` | `number` | 服务器埠 | `4096` | @@ -67,7 +67,7 @@ console.log(`Server running at ${opencode.server.url}`) opencode.server.close() ``` -## 仅限客戶 +## 仅限客户端 如果您已经有 opencode 的正在执行示例项，则可以创建一个客户端示例项来连线到它： @@ -79,9 +79,9 @@ const client = createOpencodeClient({ }) ``` -#### 選項 +#### 选项 -| 選項 | 型別 | 描述 | 默认 | +| 选项 | 型别 | 描述 | 默认 | | --------------- | ---------- | ---------------------------- | ----------------------- | | `baseUrl` | `string` | 服务器的 URL | `http://localhost:4096` | | `fetch` | `function` | 习俗获取实现 | `globalThis.fetch` | @@ -91,7 +91,7 @@ const client = createOpencodeClient({ --- -## 型別 +## 类型 SDK 包括所有 API 型以外的 TypeScript 定义。直接汇入其中： @@ -117,13 +117,13 @@ try { --- -## 蜜蜂 +## API SDK跨越型别安全客户端公开所有服务器API。 --- -### 全球的 +### 全局 | 方法 | 描述 | 回应 | | ----------------- | ------------------------ | ------------------------------------ | @@ -167,7 +167,7 @@ const agents = await client.app.agents() --- -### 专案 +### 项目 | 方法 | 描述 | 回应 | | ------------------- | ------------ | ------------------------------------------ | @@ -188,7 +188,7 @@ const currentProject = await client.project.current() --- -### 小路 +### 路径 | 方法 | 描述 | 回应 | | ------------ | ------------ | ---------------------------------------- | @@ -353,7 +353,7 @@ await client.tui.showToast({ --- -### 授權 +### 授权 | 方法 | 描述 | 回应 | | ------------------- | ---------------- | --------- | @@ -372,7 +372,7 @@ await client.auth.set({ --- -### 活动 +### 事件 | 方法 | 描述 | 回应 | | ------------------- | ------------------ | ------------------ | diff --git a/packages/web/src/content/docs/zh-cn/server.mdx b/packages/web/src/content/docs/zh-cn/server.mdx index c687b4b77..27604021a 100644 --- a/packages/web/src/content/docs/zh-cn/server.mdx +++ b/packages/web/src/content/docs/zh-cn/server.mdx @@ -16,9 +16,9 @@ The `opencode serve` command runs a headless HTTP server that exposes an OpenAPI opencode serve [--port ] [--hostname ] [--cors ] ``` -#### 選項 +#### 选项 -| 旗幟 | 描述 | 默认 | +| 标志 | 描述 | 默认 | | --------------- | ----------------------------------- | ---------------- | | `--port` | 监听音频 | `4096` | | `--hostname` | 监听的主机名 | `127.0.0.1` | @@ -34,7 +34,7 @@ opencode serve --cors http://localhost:5173 --cors https://app.example.com --- -### 驗證 +### 验证 Set `OPENCODE_SERVER_PASSWORD` to protect the server with HTTP basic auth. The username defaults to `opencode`, or set `OPENCODE_SERVER_USERNAME` to override it. This applies to both `opencode serve` and `opencode web`. @@ -81,13 +81,13 @@ http://:/doc --- -## 蜜蜂 +## API opencode服务器公开以下API。 --- -### 全球的 +### 全局 | 方法 | 路徑 | 描述 | 回应 | | ----- | ---------------- | ------------------------ | ------------------------------------ | @@ -96,7 +96,7 @@ opencode服务器公开以下API。 --- -### 专案 +### 项目 | 方法 | 路徑 | 描述 | 回应 | | ----- | ------------------ | ------------ | ------------------------------------------ | @@ -238,7 +238,7 @@ opencode服务器公开以下API。 --- -### 記錄 +### 日志 | 方法 | 路徑 | 描述 | 回应 | | ------ | ------------------------------------------- | ------ | -------------------- | @@ -264,7 +264,7 @@ opencode服务器公开以下API。 --- -### 授權 +### 授权 | 方法 | 路徑 | 描述 | 回应 | | ----- | ----------- | ------------------------------------------ | --------- | @@ -280,7 +280,7 @@ opencode服务器公开以下API。 --- -### 文件 +### 文档 | 方法 | 路徑 | 描述 | 回应 | | ----- | ------ | --------------- | ------------------------- | diff --git a/packages/web/src/content/docs/zh-cn/share.mdx b/packages/web/src/content/docs/zh-cn/share.mdx index 5559de913..e73eac373 100644 --- a/packages/web/src/content/docs/zh-cn/share.mdx +++ b/packages/web/src/content/docs/zh-cn/share.mdx @@ -63,7 +63,7 @@ opencode 支持清晰控制对话共享方式的共享模式： --- -### 殘疾人 +### 已禁用 您可以通过将 [config file](/docs/config) 中的 `share` 选项设置为 `"disabled"` 来完全禁用共享： diff --git a/packages/web/src/content/docs/zh-cn/skills.mdx b/packages/web/src/content/docs/zh-cn/skills.mdx index b5bd59c26..f5c588d1e 100644 --- a/packages/web/src/content/docs/zh-cn/skills.mdx +++ b/packages/web/src/content/docs/zh-cn/skills.mdx @@ -22,7 +22,7 @@ opencode 搜索这些位置： --- -## 瞭解發現 +## 了解发现 对于专案本地路径， opencode 从当前工作目录向上走，直到到达 git 工作树。 It loads any matching `skills/*/SKILL.md` in `.opencode/` and any matching `.claude/skills/*/SKILL.md` or `.agents/skills/*/SKILL.md` along the way. @@ -31,7 +31,7 @@ Global definitions are also loaded from `~/.config/opencode/skills/*/SKILL.md`, --- -## 寫前言 +## 编写 Frontmatter 每个 `SKILL.md` 必须以 YAML frontmatter 。 仅識別这些欄位： @@ -46,7 +46,7 @@ Global definitions are also loaded from `~/.config/opencode/skills/*/SKILL.md`, --- -## 驗證姓名 +## 验证名称 `name` 必须： @@ -64,7 +64,7 @@ Global definitions are also loaded from `~/.config/opencode/skills/*/SKILL.md`, --- -## 遵循長度规则 +## 遵循长度规则 `description` 必须是 1-1024 个字元。 保持足夠具體，以便代理能夠正确选择。 @@ -100,7 +100,7 @@ Ask clarifying questions if the target versioning scheme is unclear. --- -## 識別工具說明 +## 识别工具说明 opencode 列出了 `skill` 工具描述中的可用技能。 每个条目都包含技能名称和描述： @@ -212,7 +212,7 @@ tools: --- -## 解決載入問題 +## 解决加载问题 如果某項技能沒有显示： diff --git a/packages/web/src/content/docs/zh-cn/themes.mdx b/packages/web/src/content/docs/zh-cn/themes.mdx index 41c17729b..2f28f15d5 100644 --- a/packages/web/src/content/docs/zh-cn/themes.mdx +++ b/packages/web/src/content/docs/zh-cn/themes.mdx @@ -21,7 +21,7 @@ By default, opencode uses our own `opencode` theme. --- -## 內建主题 +## 内置主题 opencode 带有几个内建主题。 @@ -43,7 +43,7 @@ opencode 带有几个内建主题。 --- -## 系統主题 +## 系统主题 `system` 主题旨在自动适应您的最终方案。与使用固定颜色的传统主题不同，_system_ 主题： @@ -72,13 +72,13 @@ opencode 带有几个内建主题。 --- -## 自定義主题 +## 自定义主题 opencode 支持灵活的基于 JSON 的主题系统，允许用户轻松创建和自定义主题。 --- -### 等級制度 +### 优先级 主题按以下顺序從多个目录載入，其中后面的目录覆盖前面的目录： @@ -91,7 +91,7 @@ opencode 支持灵活的基于 JSON 的主题系统，允许用户轻松创建 --- -### 建立主题 +### 创建主题 要创建自定义主题，请在主题目录中创建 JSON 档案。 @@ -123,7 +123,7 @@ vim .opencode/themes/my-theme.json --- -### 顏色定義 +### 颜色定义 `defs` 部分是可选的，它允许您定义可在主题中引用的可重用颜色。 diff --git a/packages/web/src/content/docs/zh-cn/troubleshooting.mdx b/packages/web/src/content/docs/zh-cn/troubleshooting.mdx index a46a263dd..b658f6938 100644 --- a/packages/web/src/content/docs/zh-cn/troubleshooting.mdx +++ b/packages/web/src/content/docs/zh-cn/troubleshooting.mdx @@ -7,7 +7,7 @@ description: 常見問題以及如何解決它們。 --- -## 紀錄 +## 日志 日誌文件寫入： @@ -20,7 +20,7 @@ You can set the log level with the `--log-level` command-line option to get more --- -## 貯存 +## 存储 opencode程序将会话数据和其他应用程序数据存储在磁碟上： @@ -169,7 +169,7 @@ opencode 桌面仅在以下情况下显示系统通知： --- -## 尋求幫助 +## 寻求帮助 如果您遇到 opencode 问题： @@ -189,7 +189,7 @@ opencode 桌面仅在以下情况下显示系统通知： --- -## 常見問題 +## 常见问题 以下是一些常見問題以及解決方法。 diff --git a/packages/web/src/content/docs/zh-cn/tui.mdx b/packages/web/src/content/docs/zh-cn/tui.mdx index 05203c464..e1beb9abf 100644 --- a/packages/web/src/content/docs/zh-cn/tui.mdx +++ b/packages/web/src/content/docs/zh-cn/tui.mdx @@ -27,7 +27,7 @@ Give me a quick summary of the codebase. --- -## 文件參考 +## 文件引用 您可以使用 `@` 在消息中引用文件。这会在当前工作目录中進行模糊文件搜索。 @@ -43,7 +43,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -## bash 命令 +## Bash 命令 以`!`开始一条消息以执行shell命令。 @@ -115,7 +115,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -### 出口 +### 退出 退出opencode。 _别名_：`/quit`、`/q` @@ -127,7 +127,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -### 出口 +### 导出 将当前对话汇出到 Markdown 并在默认编辑器中开启。使用 `EDITOR` 环境变数中设定的编辑器。 [了解更多](#editor-setup)。 @@ -376,7 +376,7 @@ Create or update `AGENTS.md` file. [Learn more](/docs/rules). --- -## 定製化 +## 自定义 您可以使用命令选项板（`ctrl+x h` 或 `/help`）自定义 TUI 查看的各个方面。这些设置在重新启动后仍然存在。 diff --git a/packages/web/src/content/docs/zh-cn/web.mdx b/packages/web/src/content/docs/zh-cn/web.mdx index 6daac5122..efb55aaab 100644 --- a/packages/web/src/content/docs/zh-cn/web.mdx +++ b/packages/web/src/content/docs/zh-cn/web.mdx @@ -31,7 +31,7 @@ For the best experience, run `opencode web` from [WSL](/docs/windows-wsl) rather 您可以使用命令列标志或在[config file](/docs/config).conf 中配置Web服务器。 -### 港口 +### 端口 默认情况下，opencode 选择一个可用的端口。您可以指定一个端口： @@ -90,7 +90,7 @@ The username defaults to `opencode` but can be changed with `OPENCODE_SERVER_USE --- -## 使用網路介面 +## 使用网络界面 启动后，网路界面将提供对您的 opencode 会话的访问。 diff --git a/packages/web/src/content/docs/zh-cn/zen.mdx b/packages/web/src/content/docs/zh-cn/zen.mdx index 63874410f..1a2e77aab 100644 --- a/packages/web/src/content/docs/zh-cn/zen.mdx +++ b/packages/web/src/content/docs/zh-cn/zen.mdx @@ -58,7 +58,7 @@ OpenCode Zen 的工作方式与 opencode 中的任何其他功能相同。 --- -## 端點 +## 端点 您还可以通过以下 API 端点访问我们的模型。 @@ -110,7 +110,7 @@ https://opencode.ai/zen/v1/models --- -## 定價 +## 定价 我们支持即用即付模式。以下是**每 100 万Tokens的价格**。 @@ -186,7 +186,7 @@ https://opencode.ai/zen/v1/models --- -## 隱私 +## 隐私 我们所有的模型都在美国託管。我们的提供商遵循零保留政策，不会将您的数据用于模型训练，但以下情况除外： @@ -199,7 +199,7 @@ https://opencode.ai/zen/v1/models --- -## 对于團隊 +## 对于团队 Zen 对团队也很有效。您可以参与第三方、角色、策划 您的團隊使用的模型等等。 diff --git a/packages/web/src/content/docs/zh-tw/acp.mdx b/packages/web/src/content/docs/zh-tw/acp.mdx index 2bd3d3948..26ddcff90 100644 --- a/packages/web/src/content/docs/zh-tw/acp.mdx +++ b/packages/web/src/content/docs/zh-tw/acp.mdx @@ -1,31 +1,31 @@ --- -title: ACP 支持 -description: 在任何 ACP 兼容編輯器中使用 OpenCode。 +title: ACP 支援 +description: 在任何 ACP 相容編輯器中使用 OpenCode。 --- -OpenCode 支持 [Agent Client Protocol](https://agentclientprotocol.com) 或 (ACP)，允許您直接在兼容的編輯器和 IDE 中使用它。 +OpenCode 支援 [Agent Client Protocol](https://agentclientprotocol.com) 或 (ACP)，允許您直接在相容的編輯器和 IDE 中使用它。 :::tip -有關支持 ACP 的編輯器和工具的列表，請查看[ACP progress report](https://zed.dev/blog/acp-progress-report#available-now)。 +有關支援 ACP 的編輯器和工具的列表，請查看 [ACP progress report](https://zed.dev/blog/acp-progress-report#available-now)。 ::: -ACP 是一種開放協議，用於標準化程式碼編輯器和 AI 編碼代理之間的通信。 +ACP 是一種開放協議，用於標準化程式碼編輯器和 AI 程式碼代理之間的通訊。 --- -## 配置 +## 設定 -要通過 ACP 使用 OpenCode，請將編輯器配置為運行 `opencode acp` 命令。 +要透過 ACP 使用 OpenCode，請將編輯器設定為執行 `opencode acp` 指令。 -該命令將 OpenCode 作為 ACP 兼容的子進程啟動，通過 stdio 通過 JSON-RPC 與您的編輯器進行通信。 +該指令將 OpenCode 作為 ACP 相容的子程序啟動，透過 stdio 透過 JSON-RPC 與您的編輯器進行通訊。 -以下是支持 ACP 的流行編輯器的示例。 +以下是支援 ACP 的流行編輯器的範例。 --- ### Zed -添加到您的[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： +根據 [文件](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 -添加到您的[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} { @@ -121,7 +121,7 @@ ACP 是一種開放協議，用於標準化程式碼編輯器和 AI 編碼代理 ### CodeCompanion.nvim -要將 OpenCode 用作 [CodeCompanion.nvim](https://github.com/olimorris/codecompanion.nvim) 中的 ACP 代理，請將以下內容添加到 Neovim 配置中： +要將 OpenCode 用作 [CodeCompanion.nvim](https://github.com/olimorris/codecompanion.nvim) 中的 ACP 代理，請將以下內容新增到 Neovim 設定中： ```lua require("codecompanion").setup({ @@ -136,21 +136,21 @@ require("codecompanion").setup({ }) ``` -此配置將 CodeCompanion 設置為使用 OpenCode 作為聊天的 ACP 代理。 +此設定將 CodeCompanion 設定為使用 OpenCode 作為聊天的 ACP 代理。 -如果您需要傳遞環境變量（如 `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) 了解完整詳細資訊。 -## 支持 +## 支援 -OpenCode 通過 ACP 的工作方式與在 terminal 中的工作方式相同。支持所有功能： +OpenCode 透過 ACP 的工作方式與在終端機中的工作方式相同。支援所有功能： :::note -目前不支持某些內置斜杠命令，例如 `/undo` 和 `/redo`。 +目前不支援某些內建斜線指令，例如 `/undo` 和 `/redo`。 ::: -- 內置工具（文件操作、terminal 命令等） -- 自定義工具和斜杠命令 -- 在 OpenCode 配置中配置的 MCP 服務器 -- `AGENTS.md` 的項目特定規則 -- 自定義格式化程序和 linter +- 內建工具（檔案操作、終端機指令等） +- 自定義工具和斜線指令 +- 在 OpenCode 設定中設定的 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 fe8b4496e..c4d3d656b 100644 --- a/packages/web/src/content/docs/zh-tw/agents.mdx +++ b/packages/web/src/content/docs/zh-tw/agents.mdx @@ -1,15 +1,15 @@ --- -title: Agents -description: 配置和使用專門的代理。 +title: 代理 +description: 設定和使用專門的代理。 --- -代理是專門的AI助手，可以針對特定任務和工作流程進行配置。它們允許您創建具有自定義提示、模型和工具訪問權限的專用工具。 +代理是專門的 AI 助理，可以針對特定任務和工作流程進行設定。它們允許您建立具有自定義提示、模型和工具存取權限的專用工具。 :::tip -使用計劃代理來分析程式碼並審查建議，而無需進行任何程式碼更改。 +使用計畫代理來分析程式碼並審閱建議，而無需進行任何程式碼變更。 ::: -您可以在會話期間在代理之間切換，或使用 `@` 提及來調用它們。 +您可以在工作階段期間在代理之間切換，或使用 `@` 提及來呼叫它們。 --- @@ -21,122 +21,121 @@ opencode 中有兩種類型的代理；主要代理和子代理。 ### 主要代理 -主要代理是與您直接互動的主要助手。您可以使用 **Tab** 鍵或您配置的 `switch_agent` 鍵綁定循環瀏覽它們。這些代理處理您的主要對話。工具訪問是通過權限配置的 - 例如，“構建”啟用了所有工具，而“計劃”則受到限制。 +主要代理是與您直接互動的主要助理。您可以使用 **Tab** 鍵或您設定的 `switch_agent` 鍵綁定循環切換它們。這些代理處理您的主要對話。工具存取是透過權限設定的 - 例如，「Build」啟用了所有工具，而「Plan」則受到限制。 :::tip -您可以在會話期間使用 **Tab** 鍵在主要代理之間切換。 +您可以在工作階段期間使用 **Tab** 鍵在主要代理之間切換。 ::: -opencode 附帶兩個內置的主要代理：**Build** 和 **Plan**。出色地 -看看下面這些。 +opencode 附帶兩個內建的主要代理：**Build** 和 **Plan**。我們將在下面看看這些。 --- ### 子代理 -子代理是主要代理可以調用​​來執行特定任務的專業助手。您還可以通過在消息中**@提及**它們來手動調用它們。 +子代理是主要代理可以呼叫來執行特定任務的專業助理。您也可以透過在訊息中 **@提及** 它們來手動呼叫它們。 -opencode 附帶兩個內置子代理：**General** 和 **Explore**。我們將在下面看看這個。 +opencode 附帶兩個內建子代理：**General** 和 **Explore**。我們將在下面看看這個。 --- ## 內建 -opencode 附帶兩個內置主代理和兩個內置子代理。 +opencode 附帶兩個內建主代理和兩個內建子代理。 --- -### 使用構建 +### 使用 Build (構建) _模式_：`primary` -構建是啟用所有工具的**默認**主要代理。這是用於需要完全訪問文件操作和系統命令的開發工作的標準代理。 +Build 是啟用所有工具的**預設**主要代理。這是用於需要完全存取檔案操作和系統指令的開發工作的標準代理。 --- -### 使用計劃 +### 使用 Plan (計畫) _模式_：`primary` -專為規劃和分析而設計的受限代理。我們使用權限系統為您提供更多控制並防止意外更改。 -默認情況下，以下所有項均設置為`ask`： +專為規劃和分析而設計的受限代理。我們使用權限系統為您提供更多控制並防止意外變更。 +預設情況下，以下所有項均設定為 `ask`： - `file edits`：所有寫入、修補和編輯 -- `bash`：所有 bash 命令 +- `bash`：所有 bash 指令 -當您希望 LLM 分析程式碼、建議更改或創建計劃而不對程式碼庫進行任何實際修改時，此代理非常有用。 +當您希望 LLM 分析程式碼、建議變更或建立計畫而不對程式碼庫進行任何實際修改時，此代理非常有用。 --- -### 使用一般 +### 使用 General (一般) _模式_：`subagent` -用於研究複雜問題和執行多步驟任務的通用代理。具有完整的工具訪問權限（待辦事項除外），因此可以在需要時更改文件。使用它可以並行運行多個工作單元。 +用於研究複雜問題和執行多步驟任務的通用代理。具有完整的工具存取權限（待辦事項除外），因此可以在需要時變更檔案。使用它可以並行執行多個工作單元。 --- -### 使用探索 +### 使用 Explore (探索) _模式_：`subagent` -用於探索程式碼庫的快速只讀代理。無法修改文件。當您需要按模式快速查找文件、搜索程式碼中的關鍵字或回答有關程式碼庫的問題時，請使用此功能。 +用於探索程式碼庫的快速唯讀代理。無法修改檔案。當您需要按模式快速尋找檔案、搜尋程式碼中的關鍵字或回答有關程式碼庫的問題時，請使用此功能。 --- -### 使用壓實 +### 使用 Compact (壓縮) _模式_：`primary` -隱藏的系統代理，將長上下文壓縮為較小的摘要。它會在需要時自動運行，並且無法在 UI 中選擇。 +隱藏的系統代理，將長上下文壓縮為較小的摘要。它會在需要時自動執行，並且無法在 UI 中選擇。 --- -### 使用標題 +### 使用 Title (標題) _模式_：`primary` -生成短會話標題的隱藏系統代理。它會自動運行，並且無法在 UI 中選擇。 +生成短工作階段標題的隱藏系統代理。它會自動執行，並且無法在 UI 中選擇。 --- -### 使用總結 +### 使用 Summarize (摘要) _模式_：`primary` -創建會話摘要的隱藏系統代理。它會自動運行，並且無法在 UI 中選擇。 +建立工作階段摘要的隱藏系統代理。它會自動執行，並且無法在 UI 中選擇。 --- ## 用法 -1. 對於主要代理，請在會話期間使用 **Tab** 鍵循環瀏覽它們。您還可以使用配置的 `switch_agent` 鍵綁定。 +1. 對於主要代理，請在工作階段期間使用 **Tab** 鍵循環切換它們。您也可以使用設定的 `switch_agent` 鍵綁定。 -2. 可以調用子代理： +2. 可以呼叫子代理： - **自動**由主要代理根據其描述執行專門任務。 - - 通過在消息中**@提及**子代理手動進行。例如。 + - 透過在訊息中 **@提及** 子代理手動進行。例如： ```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 ← ... ← 父級 這使您可以在主要對話和專門的子代理工作之間無縫切換。 --- -## 配置 +## 設定 -您可以自定義內置代理或通過配置創建您自己的代理。可以通過兩種方式配置代理： +您可以自定義內建代理或透過設定建立您自己的代理。可以透過兩種方式設定代理： --- ### JSON -在 `opencode.json` 配置文件中配置代理： +在 `opencode.json` 設定檔中設定代理： ```json title="opencode.json" { @@ -179,10 +178,10 @@ _模式_：`primary` ### Markdown -您還可以使用 Markdown 文件定義代理。將它們放入： +您也可以使用 Markdown 檔案定義代理。將它們放入： -- 全球：`~/.config/opencode/agents/` -- 每個項目：`.opencode/agents/` +- 全域：`~/.config/opencode/agents/` +- 每個專案：`.opencode/agents/` ```markdown title="~/.config/opencode/agents/review.md" --- @@ -206,17 +205,17 @@ You are in code review mode. Focus on: Provide constructive feedback without making direct changes. ``` -Markdown 文件名成為代理名稱。例如，`review.md` 創建`review` 代理。 +Markdown 檔名成為代理名稱。例如，`review.md` 建立 `review` 代理。 --- ## 選項 -讓我們詳細看看這些配置選項。 +讓我們詳細看看這些設定選項。 --- -### 描述 +### 描述 (Description) 使用 `description` 選項提供代理的作用以及何時使用它的簡要描述。 @@ -230,15 +229,15 @@ Markdown 文件名成為代理名稱。例如，`review.md` 創建`review` 代 } ``` -這是一個**必需的**配置選項。 +這是一個**必需的**設定選項。 --- -### 溫度 +### 溫度 (Temperature) -使用 `temperature` 配置控制 LLM 響應的隨機性和創造性。 +使用 `temperature` 設定控制 LLM 回應的隨機性和創造性。 -較低的值使響應更加集中和確定，而較高的值則增加創造力和可變性。 +較低的值使回應更加集中和確定，而較高的值則增加創造力和可變性。 ```json title="opencode.json" { @@ -255,9 +254,9 @@ Markdown 文件名成為代理名稱。例如，`review.md` 創建`review` 代 溫度值的範圍通常為 0.0 到 1.0： -- **0.0-0.2**：非常集中且確定的響應，非常適合程式碼分析和規劃 -- **0.3-0.5**：具有一定創造力的平衡響應，適合一般開發任務 -- **0.6-1.0**：更有創意和多樣化的反應，有助於頭腦風暴和探索 +- **0.0-0.2**：非常集中且確定的回應，非常適合程式碼分析和規劃 +- **0.3-0.5**：具有一定創造力的平衡回應，適合一般開發任務 +- **0.6-1.0**：更有創意和多樣化的反應，有助於腦力激盪和探索 ```json title="opencode.json" { @@ -277,15 +276,15 @@ Markdown 文件名成為代理名稱。例如，`review.md` 創建`review` 代 } ``` -如果未指定溫度，opencode 將使用特定於型號的默認值；大多數型號通常為 0，Qwen 型號為 0.55。 +如果未指定溫度，opencode 將使用特定於模型的預設值；大多數模型通常為 0，Qwen 模型為 0.55。 --- -### 最大步數 +### 最大步數 (Steps) -控制代理在被迫僅使用文本響應之前可以執行的最大代理迭代次數。這允許希望控製成本的用戶對代理操作設置限制。 +控制代理在被迫僅使用文字回應之前可以執行的最大代理迭代次數。這允許希望控制成本的使用者對代理操作設定限制。 -如果未設置，代理將繼續迭代，直到模型選擇停止或用戶中斷會話。 +如果未設定，代理將繼續迭代，直到模型選擇停止或使用者中斷工作階段。 ```json title="opencode.json" { @@ -299,17 +298,17 @@ Markdown 文件名成為代理名稱。例如，`review.md` 創建`review` 代 } ``` -當達到限制時，代理會收到特殊的系統提示，指示其響應其工作摘要和建議的剩餘任務。 +當達到限制時，代理會收到特殊的系統提示，指示其回應其工作摘要和建議的剩餘任務。 :::caution -舊版 `maxSteps` 字段已棄用。請改用`steps`。 +舊版 `maxSteps` 欄位已棄用。請改用 `steps`。 ::: --- -### 禁用 +### 禁用 (Disable) -設置為 `true` 以禁用代理。 +設定為 `true` 以禁用代理。 ```json title="opencode.json" { @@ -323,9 +322,9 @@ Markdown 文件名成為代理名稱。例如，`review.md` 創建`review` 代 --- -### 迅速的 +### 提示 (Prompt) -使用 `prompt` 配置為此代理指定自定義系統提示文件。提示文件應包含特定於代理目的的說明。 +使用 `prompt` 設定為此代理指定自定義系統提示檔案。提示檔案應包含特定於代理目的的說明。 ```json title="opencode.json" { @@ -337,16 +336,16 @@ Markdown 文件名成為代理名稱。例如，`review.md` 創建`review` 代 } ``` -該路徑是相對於配置文件所在位置的。因此，這適用於全局 opencode 配置和項目特定配置。 +該路徑是相對於設定檔所在位置的。因此，這適用於全域 opencode 設定和專案特定設定。 --- -### 模型 +### 模型 (Model) -使用 `model` 配置覆蓋此代理的模型。對於使用針對不同任務優化的不同模型很有用。例如，更快的規劃模型、更強大的實施模型。 +使用 `model` 設定覆蓋此代理的模型。對於使用針對不同任務最佳化的不同模型很有用。例如，更快的規劃模型、更強大的實作模型。 :::tip -如果您不指定模型，主代理將使用[全局配置的模型](/docs/config#models)，而子代理將使用調用子代理的主代理的模型。 +如果您不指定模型，主代理將使用 [全域設定的模型](/docs/config#models)，而子代理將使用呼叫子代理的主代理的模型。 ::: ```json title="opencode.json" @@ -359,13 +358,13 @@ Markdown 文件名成為代理名稱。例如，`review.md` 創建`review` 代 } ``` -opencode 配置中的模型 ID 使用格式`provider/model-id`。例如，如果您使用 [OpenCode Zen](/docs/zen)，則您將使用 `opencode/gpt-5.1-codex` 來表示 GPT 5.1 Codex。 +opencode 設定中的模型 ID 使用格式 `provider/model-id`。例如，如果您使用 [OpenCode Zen](/docs/zen)，則您將使用 `opencode/gpt-5.1-codex` 來表示 GPT 5.1 Codex。 --- -### 工具 +### 工具 (Tools) -使用 `tools` 配置控制此代理中可用的工具。您可以通過將特定工具設置為`true` 或`false` 來啟用或禁用特定工具。 +使用 `tools` 設定控制此代理中可用的工具。您可以透過將特定工具設定為 `true` 或 `false` 來啟用或禁用特定工具。 ```json title="opencode.json" {3-6,9-12} { @@ -386,10 +385,10 @@ opencode 配置中的模型 ID 使用格式`provider/model-id`。例如，如果 ``` :::note -特定於代理的配置會覆蓋全局配置。 +特定於代理的設定會覆蓋全域設定。 ::: -您還可以使用通配符同時控制多個工具。例如，要禁用 MCP 服務器中的所有工具： +您也可以使用萬用字元同時控制多個工具。例如，要禁用 MCP 伺服器中的所有工具： ```json title="opencode.json" { @@ -406,15 +405,15 @@ opencode 配置中的模型 ID 使用格式`provider/model-id`。例如，如果 } ``` -[了解有關工具的更多信息](/docs/tools)。 +[了解有關工具的更多資訊](/docs/tools)。 --- -### 權限 +### 權限 (Permissions) -您可以配置權限來管理代理可以執行的操作。目前，`edit`、`bash` 和`webfetch` 工具的權限可以配置為： +您可以設定權限來管理代理可以執行的操作。目前，`edit`、`bash` 和 `webfetch` 工具的權限可以設定為： -- `"ask"` — 運行工具之前提示批准 +- `"ask"` — 執行工具之前提示批准 - `"allow"` — 未經批准允許所有操作 - `"deny"` — 禁用該工具 @@ -445,7 +444,7 @@ opencode 配置中的模型 ID 使用格式`provider/model-id`。例如，如果 } ``` -您還可以在 Markdown 代理中設置權限。 +您還可以在 Markdown 代理中設定權限。 ```markdown title="~/.config/opencode/agents/review.md" --- @@ -464,7 +463,7 @@ permission: Only analyze code and suggest changes. ``` -您可以設置特定 bash 命令的權限。 +您可以設定特定 bash 指令的權限。 ```json title="opencode.json" {7} { @@ -482,7 +481,7 @@ Only analyze code and suggest changes. } ``` -這可以採用全局模式。 +這可以採用全域模式。 ```json title="opencode.json" {7} { @@ -499,8 +498,8 @@ Only analyze code and suggest changes. } ``` -您還可以使用`*`通配符來管理所有命令的權限。 -由於最後一個匹配規則優先，因此將 `*` 通配符放在前面，將特定規則放在後面。 +您也可以使用 `*` 萬用字元來管理所有指令的權限。 +由於最後一個匹配規則優先，因此將 `*` 萬用字元放在前面，將特定規則放在後面。 ```json title="opencode.json" {8} { @@ -518,13 +517,13 @@ Only analyze code and suggest changes. } ``` -[了解有關權限的更多信息](/docs/permissions)。 +[了解有關權限的更多資訊](/docs/permissions)。 --- -### 模式 +### 模式 (Mode) -使用`mode` 配置控制代理的模式。 `mode` 選項用於確定如何使用代理。 +使用 `mode` 設定控制代理的模式。 `mode` 選項用於確定如何使用代理。 ```json title="opencode.json" { @@ -536,13 +535,13 @@ Only analyze code and suggest changes. } ``` -`mode` 選項可設置為`primary`、`subagent` 或`all`。如果未指定`mode`，則默認為`all`。 +`mode` 選項可設定為 `primary`、`subagent` 或 `all`。如果未指定 `mode`，則預設為 `all`。 --- -### 隱 +### 隱藏 (Hidden) -使用 `@` 從 `hidden: true` 自動完成菜單隱藏子代理。對於只能由其他代理通過任務工具以編程方式調用的內部子代理很有用。 +使用 `@` 從 `hidden: true` 自動完成選單隱藏子代理。對於只能由其他代理透過任務工具以程式化方式呼叫的內部子代理很有用。 ```json title="opencode.json" { @@ -555,17 +554,17 @@ Only analyze code and suggest changes. } ``` -這僅影響自動完成菜單中的用戶可見性。如果權限允許，模型仍然可以通過任務工具調用隱藏代理。 +這僅影響自動完成選單中的使用者可見性。如果權限允許，模型仍然可以透過任務工具呼叫隱藏代理。 :::note -僅適用於`mode: subagent` 代理。 +僅適用於 `mode: subagent` 代理。 ::: --- -### 任務權限 +### 任務權限 (Task Permissions) -使用 `permission.task` 控制代理可以通過任務工具調用哪些子代理。使用 glob 模式進行靈活匹配。 +使用 `permission.task` 控制代理可以透過任務工具呼叫哪些子代理。使用 glob 模式進行靈活匹配。 ```json title="opencode.json" { @@ -584,23 +583,23 @@ Only analyze code and suggest changes. } ``` -當設置為 `deny` 時，子代理將從任務工具描述中完全刪除，因此模型不會嘗試調用它。 +當設定為 `deny` 時，子代理將從任務工具描述中完全刪除，因此模型不會嘗試呼叫它。 :::tip -規則按順序評估，**最後匹配的規則獲勝**。在上面的示例中，`orchestrator-planner` 匹配`*`（拒絕）和`orchestrator-*`（允許），但由於`orchestrator-*` 位於`*` 之後，因此結果為`allow`。 +規則按順序評估，**最後匹配的規則獲勝**。在上面的範例中，`orchestrator-planner` 匹配 `*`（拒絕）和 `orchestrator-*`（允許），但由於 `orchestrator-*` 位於 `*` 之後，因此結果為 `allow`。 ::: :::tip -用戶始終可以通過 `@` 自動完成菜單直接調用任何子代理，即使代理的任務權限會拒絕它。 +使用者始終可以透過 `@` 自動完成選單直接呼叫任何子代理，即使代理的任務權限會拒絕它。 ::: --- -### 顏色 +### 顏色 (Color) 使用 `color` 選項自定義代理在 UI 中的視覺外觀。這會影響代理在介面中的顯示方式。 -使用有效的十六進制顏色（例如`#FF5733`）或主題顏色：`primary`、`secondary`、`accent`、`success`、`warning`、`error`、`info`。 +使用有效的十六進位顏色（例如 `#FF5733`）或主題顏色：`primary`、`secondary`、`accent`、`success`、`warning`、`error`、`info`。 ```json title="opencode.json" { @@ -617,9 +616,9 @@ Only analyze code and suggest changes. --- -### 頂P +### Top P -使用 `top_p` 選項控制響應多樣性。控制隨機性的溫度替代方案。 +使用 `top_p` 選項控制回應多樣性。控制隨機性的溫度替代方案。 ```json title="opencode.json" { @@ -635,9 +634,9 @@ Only analyze code and suggest changes. --- -### 額外的 +### 額外選項 (Extra) -您在代理配置中指定的任何其他選項都將作為模型選項**直接**傳遞給提供商。這允許您使用特定於提供商的功能和參數。 +您在代理設定中指定的任何其他選項都將作為模型選項**直接**傳遞給供應商。這允許您使用特定於供應商的功能和參數。 例如，使用 OpenAI 的推理模型，您可以控制推理工作： @@ -654,47 +653,47 @@ Only analyze code and suggest changes. } ``` -這些附加選項是特定於型號和提供商的。檢查提供商的文檔以獲取可用參數。 +這些附加選項是特定於模型和供應商的。檢查供應商的文件以獲取可用參數。 :::tip -運行 `opencode models` 查看可用模型的列表。 +執行 `opencode models` 查看可用模型的列表。 ::: --- -## 創建代理 +## 建立代理 -您可以使用以下命令創建新代理： +您可以使用以下指令建立新代理： ```bash opencode agent create ``` -此交互式命令將： +此互動式指令將： -1. 詢問代理保存在哪裡；全局或特定項目。 +1. 詢問代理保存在哪裡；全域或特定專案。 2. 描述代理應該做什麼。 3. 生成適當的系統提示和標識符。 -4. 讓您選擇代理可以訪問哪些工具。 -5. 最後，使用代理配置創建一個 markdown 文件。 +4. 讓您選擇代理可以存取哪些工具。 +5. 最後，使用代理設定建立一個 markdown 檔案。 --- ## 使用案例 -以下是不同代理的一些常見用例。 +以下是不同代理的一些常見使用案例。 -- **構建代理**：啟用所有工具的完整開發工作 -- **規劃代理**：分析規劃，不做改動 -- **審查代理**：具有隻讀訪問權限和文檔工具的程式碼審查 -- **調試代理**：專注於啟用 bash 和讀取工具的調查 -- **文檔代理**：使用文件操作但不使用系統命令的文檔編寫 +- **Build 代理**：啟用所有工具的完整開發工作 +- **Plan 代理**：分析規劃，不做改動 +- **Review 代理**：具有唯讀存取權限和文件工具的程式碼審查 +- **Debug 代理**：專注於啟用 bash 和讀取工具的調查 +- **Docs 代理**：使用檔案操作但不使用系統指令的文件編寫 --- -## 示例 +## 範例 -以下是一些您可能會覺得有用的示例代理。 +以下是一些您可能會覺得有用的範例代理。 :::tip 您有想要分享的代理嗎？ [提交 PR](https://github.com/anomalyco/opencode)。 @@ -724,7 +723,7 @@ Focus on: --- -### 安全審核員 +### 安全稽核員 ```markdown title="~/.config/opencode/agents/security-auditor.md" --- diff --git a/packages/web/src/content/docs/zh-tw/cli.mdx b/packages/web/src/content/docs/zh-tw/cli.mdx index 2827be9dc..580526524 100644 --- a/packages/web/src/content/docs/zh-tw/cli.mdx +++ b/packages/web/src/content/docs/zh-tw/cli.mdx @@ -1,17 +1,17 @@ --- -title: 命令行介面 -description: opencode CLI 選項和命令。 +title: 命令列介面 +description: opencode CLI 選項和指令。 --- import { Tabs, TabItem } from "@astrojs/starlight/components" -默認情況下，OpenCode CLI 在不帶任何參數運行時啟動[TUI](/docs/tui)。 +預設情況下，OpenCode CLI 在不帶任何參數執行時啟動 [TUI](/docs/tui)。 ```bash opencode ``` -但它也接受本頁記錄的命令。這允許您以編程方式與 OpenCode 交互。 +但它也接受本頁記錄的指令。這允許您以程式化方式與 OpenCode 互動。 ```bash opencode run "Explain how closures work in JavaScript" @@ -27,24 +27,24 @@ opencode run "Explain how closures work in JavaScript" opencode [project] ``` -#### 旗標 +#### 旗標 (Flags) -| 旗標 | 簡寫 | 描述 | -| ------------ | ---- | --------------------------------------------------------- | -| `--continue` | `-c` | 繼續上一期 | -| `--session` | `-s` | 會話 ID 繼續 | -| `--fork` | | 繼續時分叉會話（與 `--continue` 或 `--session` 一起使用） | -| `--prompt` | | 提示使用 | -| `--model` | `-m` | 以提供者/模型形式使用的模型 | -| `--agent` | | 代理使用 | -| `--port` | | 監聽端口 | -| `--hostname` | | 監聽的主機名 | +| 旗標 | 簡寫 | 說明 | +| ------------ | ---- | ------------------------------------------------------------- | +| `--continue` | `-c` | 繼續上一個工作階段 | +| `--session` | `-s` | 繼續指定的工作階段 ID | +| `--fork` | | 繼續時分岔工作階段（與 `--continue` 或 `--session` 一起使用） | +| `--prompt` | | 使用的提示 | +| `--model` | `-m` | 使用的模型 (provider/model) | +| `--agent` | | 使用的代理 | +| `--port` | | 監聽連接埠 | +| `--hostname` | | 監聽的主機名稱 | --- -## 命令 +## 指令 -OpenCode CLI 還具有以下命令。 +OpenCode CLI 還具有以下指令。 --- @@ -60,13 +60,13 @@ opencode agent [command] ### attach -將 terminal 連接到通過 `serve` 或 `web` 命令啟動的已運行的 OpenCode 後端服務器。 +將終端機連接到透過 `serve` 或 `web` 指令啟動的已執行的 OpenCode 後端伺服器。 ```bash opencode attach [url] ``` -這允許將 TUI 與遠程 OpenCode 後端一起使用。例如： +這允許將 TUI 與遠端 OpenCode 後端一起使用。例如： ```bash # Start the backend server for web/mobile access @@ -78,22 +78,22 @@ opencode attach http://10.20.30.40:4096 #### 旗標 -| 旗標 | 簡寫 | 描述 | -| ----------- | ---- | ------------------- | -| `--dir` | | 啟動 TUI 的工作目錄 | -| `--session` | `-s` | 會話 ID 繼續 | +| 旗標 | 簡寫 | 說明 | +| ----------- | ---- | --------------------- | +| `--dir` | | 啟動 TUI 的工作目錄 | +| `--session` | `-s` | 繼續指定的工作階段 ID | --- #### create -使用自定義配置創建新代理。 +使用自定義設定建立新代理。 ```bash opencode agent create ``` -此命令將指導您使用自定義系統提示和工具配置創建新代理。 +此指令將指導您使用自定義系統提示和工具設定建立新代理。 --- @@ -109,7 +109,7 @@ opencode agent list ### auth -用於管理提供商的憑據和登錄的命令。 +用於管理供應商的憑證和登入的指令。 ```bash opencode auth [command] @@ -119,19 +119,19 @@ opencode auth [command] #### login -OpenCode 由 [Models.dev](https://models.dev) 上的提供商列表提供支持，因此您可以使用 `opencode auth login` 為您想要使用的任何提供商配置 API 密鑰。它存儲在`~/.local/share/opencode/auth.json` 中。 +OpenCode 由 [Models.dev](https://models.dev) 上的供應商列表提供支援，因此您可以使用 `opencode auth login` 為您想要使用的任何供應商設定 API 金鑰。它儲存在 `~/.local/share/opencode/auth.json` 中。 ```bash opencode auth login ``` -當 OpenCode 啟動時，它會從憑據文件加載提供商。如果您的環境中定義了任何鍵或項目中的 `.env` 文件。 +當 OpenCode 啟動時，它會從憑證檔案載入供應商。如果您的環境中定義了任何金鑰或專案中的 `.env` 檔案。 --- #### list -列出憑證文件中存儲的所有經過身份驗證的提供商。 +列出憑證檔案中儲存的所有經過身分驗證的供應商。 ```bash opencode auth list @@ -147,7 +147,7 @@ opencode auth ls #### logout -通過從憑據文件中清除提供商，將您從提供商中註銷。 +透過從憑證檔案中清除供應商，將您從供應商中登出。 ```bash opencode auth logout @@ -157,7 +157,7 @@ opencode auth logout ### github -管理 GitHub 代理以實現存儲庫自動化。 +管理 GitHub 代理以實現儲存庫自動化。 ```bash opencode github [command] @@ -167,36 +167,36 @@ opencode github [command] #### install -在您的存儲庫中安裝 GitHub 代理。 +在您的儲存庫中安裝 GitHub 代理。 ```bash opencode github install ``` -這將設置必要的 GitHub Actions 工作流程並指導您完成配置過程。 [了解更多](/docs/github)。 +這將設定必要的 GitHub Actions 工作流程並指導您完成設定過程。 [了解更多](/docs/github)。 --- #### run -運行 GitHub 代理。這通常用在 GitHub Actions 中。 +執行 GitHub 代理。這通常用在 GitHub Actions 中。 ```bash opencode github run ``` -##### 旗幟 +##### 旗標 -| 旗幟 | 描述 | +| 旗標 | 說明 | | --------- | ------------------------------ | -| `--event` | 用於運行代理的 GitHub 模擬事件 | -| `--token` | GitHub 個人訪問令牌 | +| `--event` | 用於執行代理的 GitHub 模擬事件 | +| `--token` | GitHub 個人存取權杖 | --- ### mcp -管理模型上下文協議服務器。 +管理模型上下文協議 (MCP) 伺服器。 ```bash opencode mcp [command] @@ -206,19 +206,19 @@ opencode mcp [command] #### add -將 MCP 服務器添加到您的配置中。 +將 MCP 伺服器新增到您的設定中。 ```bash opencode mcp add ``` -此命令將指導您添加本地或遠程 MCP 服務器。 +此指令將指導您新增本地或遠端 MCP 伺服器。 --- #### list -列出所有已配置的 MCP 服務器及其連接狀態。 +列出所有已設定的 MCP 伺服器及其連線狀態。 ```bash opencode mcp list @@ -234,15 +234,15 @@ opencode mcp ls #### auth -使用啟用 OAuth 的 MCP 服務器進行身份驗證。 +使用啟用 OAuth 的 MCP 伺服器進行身分驗證。 ```bash opencode mcp auth [name] ``` -如果您不提供服務器名稱，系統將提示您從可用的支持 OAuth 的服務器中進行選擇。 +如果您不提供伺服器名稱，系統將提示您從可用的支援 OAuth 的伺服器中進行選擇。 -您還可以列出支持 OAuth 的服務器及其身份驗證狀態。 +您還可以列出支援 OAuth 的伺服器及其身分驗證狀態。 ```bash opencode mcp auth list @@ -258,7 +258,7 @@ opencode mcp auth ls #### logout -刪除 MCP 服務器的 OAuth 憑據。 +刪除 MCP 伺服器的 OAuth 憑證。 ```bash opencode mcp logout [name] @@ -268,7 +268,7 @@ opencode mcp logout [name] #### debug -調試 MCP 服務器的 OAuth 連接問題。 +除錯 MCP 伺服器的 OAuth 連線問題。 ```bash opencode mcp debug @@ -278,30 +278,30 @@ opencode mcp debug ### models -列出已配置提供商的所有可用模型。 +列出已設定供應商的所有可用模型。 ```bash opencode models [provider] ``` -此命令以 `provider/model` 格式顯示您配置的提供商中可用的所有模型。 +此指令以 `provider/model` 格式顯示您設定的供應商中可用的所有模型。 -這對於確定[你的配置](/docs/config/) 中使用的確切模型名稱很有用。 +這對於確定 [你的設定](/docs/config/) 中使用的確切模型名稱很有用。 -您可以選擇傳遞提供商 ID 以按該提供商篩選模型。 +您可以選擇傳遞供應商 ID 以按該供應商篩選模型。 ```bash opencode models anthropic ``` -#### 旗幟 +#### 旗標 -| 旗幟 | 描述 | +| 旗標 | 說明 | | ----------- | ---------------------------------------- | -| `--refresh` | 從 models.dev 刷新模型緩存 | -| `--verbose` | 使用更詳細的模型輸出（包括成本等元數據） | +| `--refresh` | 從 models.dev 刷新模型快取 | +| `--verbose` | 使用更詳細的模型輸出（包括成本等元資料） | -使用`--refresh`標誌來更新緩存的模型列表。當新模型已添加到提供商並且您希望在 OpenCode 中查看它們時，這非常有用。 +使用 `--refresh` 旗標來更新快取的模型列表。當新模型已新增到供應商並且您希望在 OpenCode 中查看它們時，這非常有用。 ```bash opencode models --refresh @@ -311,19 +311,19 @@ opencode models --refresh ### run -通過直接傳遞提示以非交互模式運行 opencode。 +透過直接傳遞提示以非互動模式執行 opencode。 ```bash opencode run [message..] ``` -這對於腳本編寫、自動化，或者當您想要快速得到答案而不啟動完整的 TUI 時非常有用。例如。 +這對於撰寫指令碼、自動化，或者當您想要快速得到答案而不啟動完整的 TUI 時非常有用。例如： ```bash "opencode run" opencode run Explain the use of context in Go ``` -您還可以附加到正在運行的 `opencode serve` 實例，以避免每次運行時 MCP 服務器冷啟動時間： +您還可以附加到正在執行的 `opencode serve` 實例，以避免每次執行時 MCP 伺服器冷啟動時間： ```bash # Start a headless server in one terminal @@ -333,49 +333,49 @@ opencode serve opencode run --attach http://localhost:4096 "Explain async/await in JavaScript" ``` -#### 旗幟 +#### 旗標 -| 旗幟 | 短 | 描述 | +| 旗標 | 短 | 說明 | | ------------ | ---- | --------------------------------------------------------------- | -| `--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` | | 本地服務器的端口（默認為隨機端口） | +| `--command` | | 要執行的指令，使用訊息作為參數 | +| `--continue` | `-c` | 繼續上一個工作階段 | +| `--session` | `-s` | 繼續指定的工作階段 ID | +| `--fork` | | 繼續時分岔工作階段（與 `--continue` 或 `--session` 一起使用） | +| `--share` | | 分享工作階段 | +| `--model` | `-m` | 使用的模型 (provider/model) | +| `--agent` | | 使用的代理 | +| `--file` | `-f` | 要附加到訊息的檔案 | +| `--format` | | 格式：預設 (formatted) 或 json (原始 JSON 事件) | +| `--title` | | 工作階段標題（如果未提供值，則使用截斷的提示） | +| `--attach` | | 連接到正在執行的 opencode 伺服器（例如，http://localhost:4096） | +| `--port` | | 本地伺服器的連接埠（預設為隨機連接埠） | --- ### serve -啟動無頭 opencode 服務器以進行 API 訪問。查看[服務器文檔](/docs/server) 以獲取完整的 HTTP 接口。 +啟動無介面 opencode 伺服器以進行 API 存取。查看 [伺服器文件](/docs/server) 以獲取完整的 HTTP 介面。 ```bash opencode serve ``` -這將啟動一個 HTTP 服務器，該服務器提供對 opencode 功能的 API 訪問，而無需 TUI 接口。設置`OPENCODE_SERVER_PASSWORD`以啟用HTTP基本身份驗證（用戶名默認為`opencode`）。 +這將啟動一個 HTTP 伺服器，該伺服器提供對 opencode 功能的 API 存取，而無需 TUI 介面。設定 `OPENCODE_SERVER_PASSWORD` 以啟用 HTTP 基本身分驗證（使用者名稱預設為 `opencode`）。 -#### 旗幟 +#### 旗標 -| 旗幟 | 描述 | -| ------------ | ------------------------ | -| `--port` | 監聽端口 | -| `--hostname` | 監聽的主機名 | -| `--mdns` | 啟用 mDNS 發現 | -| `--cors` | 允許 CORS 的其他瀏覽器源 | +| 旗標 | 說明 | +| ------------ | -------------------------- | +| `--port` | 監聽連接埠 | +| `--hostname` | 監聽的主機名稱 | +| `--mdns` | 啟用 mDNS 探索 | +| `--cors` | 允許 CORS 的其他瀏覽器來源 | --- ### session -管理 opencode 會話。 +管理 opencode 工作階段。 ```bash opencode session [command] @@ -385,61 +385,61 @@ opencode session [command] #### list -列出所有 opencode 會話。 +列出所有 opencode 工作階段。 ```bash opencode session list ``` -##### 旗幟 +##### 旗標 -| 旗幟 | 短 | 描述 | +| 旗標 | 短 | 說明 | | ------------- | ---- | ------------------------------ | -| `--max-count` | `-n` | 限制為最近 N 個會話 | +| `--max-count` | `-n` | 限制為最近 N 個工作階段 | | `--format` | | 輸出格式：table 或 json(table) | --- ### stats -顯示 opencode 會話的令牌使用情況和成本統計信息。 +顯示 opencode 工作階段的 Tokens 使用情況和成本統計資訊。 ```bash opencode stats ``` -#### 旗幟 +#### 旗標 -| 旗幟 | 描述 | +| 旗標 | 說明 | | ----------- | -------------------------------------------------------- | | `--days` | 顯示過去 N 天（所有時間）的統計數據 | | `--tools` | 顯示的工具數量（全部） | -| `--models` | 顯示模型使用情況細分（默認隱藏）。傳遞一個數字來顯示前 N | -| `--project` | 按項目過濾（所有項目，空字符串：當前項目） | +| `--models` | 顯示模型使用情況細分（預設隱藏）。傳遞一個數字來顯示前 N | +| `--project` | 按專案過濾（所有專案，空字串：當前專案） | --- ### export -將會話數據導出為 JSON。 +將工作階段數據導出為 JSON。 ```bash opencode export [sessionID] ``` -如果您不提供會話 ID，系統將提示您從可用會話中進行選擇。 +如果您不提供工作階段 ID，系統將提示您從可用工作階段中進行選擇。 --- ### import -從 JSON 文件或 opencode 共享 URL 導入會話數據。 +從 JSON 檔案或 opencode 分享 URL 匯入工作階段數據。 ```bash opencode import ``` -您可以從本地文件或 opencode 共享 URL 導入。 +您以從本地檔案或 opencode 分享 URL 匯入。 ```bash opencode import session.json @@ -450,59 +450,59 @@ 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 介面存取 opencode。設定 `OPENCODE_SERVER_PASSWORD` 以啟用 HTTP 基本身分驗證（使用者名稱預設為 `opencode`）。 -#### 旗幟 +#### 旗標 -| 旗幟 | 描述 | -| ------------ | ------------------------ | -| `--port` | 監聽端口 | -| `--hostname` | 監聽的主機名 | -| `--mdns` | 啟用 mDNS 發現 | -| `--cors` | 允許 CORS 的其他瀏覽器源 | +| 旗標 | 說明 | +| ------------ | -------------------------- | +| `--port` | 監聽連接埠 | +| `--hostname` | 監聽的主機名稱 | +| `--mdns` | 啟用 mDNS 探索 | +| `--cors` | 允許 CORS 的其他瀏覽器來源 | --- ### acp -啟動 ACP（Agent Client Protocol）服務器。 +啟動 ACP (Agent Client Protocol) 伺服器。 ```bash opencode acp ``` -此命令啟動一個 ACP 服務器，該服務器使用 nd-JSON 通過 stdin/stdout 進行通信。 +此指令啟動一個 ACP 伺服器，該伺服器使用 nd-JSON 透過 stdin/stdout 進行通訊。 -#### 旗幟 +#### 旗標 -| 旗幟 | 描述 | -| ------------ | ------------ | -| `--cwd` | 工作目錄 | -| `--port` | 監聽端口 | -| `--hostname` | 監聽的主機名 | +| 旗標 | 說明 | +| ------------ | -------------- | +| `--cwd` | 工作目錄 | +| `--port` | 監聽連接埠 | +| `--hostname` | 監聽的主機名稱 | --- ### uninstall -卸載 opencode 並刪除所有相關文件。 +解除安裝 opencode 並刪除所有相關檔案。 ```bash opencode uninstall ``` -#### 旗幟 +#### 旗標 -| 旗幟 | 短 | 描述 | +| 旗標 | 短 | 說明 | | --------------- | ---- | -------------------------------- | -| `--keep-config` | `-c` | 保留配置文件 | -| `--keep-data` | `-d` | 保留會話數據和快照 | +| `--keep-config` | `-c` | 保留設定檔 | +| `--keep-data` | `-d` | 保留工作階段數據和快照 | | `--dry-run` | | 顯示在不刪除的情況下將刪除的內容 | | `--force` | `-f` | 跳過確認提示 | @@ -528,76 +528,76 @@ opencode upgrade opencode upgrade v0.1.48 ``` -#### 旗幟 +#### 旗標 -| 旗標 | 簡寫 | 描述 | +| 旗標 | 簡寫 | 說明 | | ---------- | ---- | ------------------------------------------ | | `--method` | `-m` | 使用的安裝方法；curl、npm、pnpm、bun、brew | --- -## 全球旗幟 +## 全域旗標 -opencode CLI 採用以下全局標誌。 +opencode CLI 採用以下全域旗標。 -| 旗幟 | 短 | 描述 | -| -------------- | ---- | ---------------------------------- | -| `--help` | `-h` | 顯示幫助 | -| `--version` | `-v` | 打印版本號 | -| `--print-logs` | | 將日誌打印到 stderr | -| `--log-level` | | 日誌級別（調試、信息、警告、錯誤） | +| 旗標 | 短 | 說明 | +| -------------- | ---- | ------------------------------------ | +| `--help` | `-h` | 顯示說明 | +| `--version` | `-v` | 列印版本號 | +| `--print-logs` | | 將記錄列印到 stderr | +| `--log-level` | | 記錄等級（debug, info, warn, error） | --- -## 環境變量 +## 環境變數 -可以使用環境變量配置 opencode。 +可以使用環境變數設定 opencode。 -| 變量 | 類型 | 描述 | -| ------------------------------------- | ------- | ---------------------------------------- | -| `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 | +| 變數 | 類型 | 說明 | +| ------------------------------------- | ------- | --------------------------------------------- | +| `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 | --- ### 實驗性的 -這些環境變量啟用可能會更改或刪除的實驗性功能。 +這些環境變數啟用可能會更改或刪除的實驗性功能。 -| 變量 | 類型 | 描述 | +| 變數 | 類型 | 說明 | | ----------------------------------------------- | ------- | ----------------------------------- | | `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_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 回應的最大輸出 tokens | +| `OPENCODE_EXPERIMENTAL_FILEWATCHER` | boolean | 為整個目錄啟用檔案觀察器 | +| `OPENCODE_EXPERIMENTAL_OXFMT` | boolean | 啟用 oxfmt 格式化程式 | | `OPENCODE_EXPERIMENTAL_LSP_TOOL` | boolean | 啟用實驗性 LSP 工具 | -| `OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER` | boolean | 禁用文件觀察器 | +| `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 | 啟用計劃模式 | +| `OPENCODE_EXPERIMENTAL_PLAN_MODE` | boolean | 啟用計畫模式 | diff --git a/packages/web/src/content/docs/zh-tw/commands.mdx b/packages/web/src/content/docs/zh-tw/commands.mdx index 82f9db68e..88069e271 100644 --- a/packages/web/src/content/docs/zh-tw/commands.mdx +++ b/packages/web/src/content/docs/zh-tw/commands.mdx @@ -1,23 +1,23 @@ --- -title: 命令 -description: 為重複任務創建自定義命令。 +title: 指令 +description: 為重複任務建立自定義指令。 --- -自定義命令允許您指定在 TUI 中執行該命令時要運行的提示。 +自定義指令允許您指定在 TUI 中執行該指令時要執行的提示。 ```bash frame="none" /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" --- @@ -30,9 +30,9 @@ Run the full test suite with coverage report and show any failures. Focus on the failing tests and suggest fixes. ``` -frontmatter 定義命令屬性。內容成為模板。 +frontmatter 定義指令屬性。內容成為範本。 -通過鍵入 `/` 後跟命令名稱來使用該命令。 +透過輸入 `/` 後跟指令名稱來使用該指令。 ```bash frame="none" "/test" @@ -40,15 +40,15 @@ frontmatter 定義命令屬性。內容成為模板。 --- -## 配置 +## 設定 -您可以通過 opencode 配置或通過在 `commands/` 目錄中創建 markdown 文件來添加自定義命令。 +您 可以透過 opencode 設定或透過在 `commands/` 目錄中建立 markdown 檔案來新增自定義指令。 --- ### JSON -在 opencode [配置](/docs/config) 中使用 `command` 選項： +在 opencode [設定](/docs/config) 中使用 `command` 選項： ```json title="opencode.jsonc" {4-12} { @@ -67,7 +67,7 @@ frontmatter 定義命令屬性。內容成為模板。 } ``` -現在您可以在 TUI 中運行此命令： +現在您可以在 TUI 中執行此指令： ```bash frame="none" /test @@ -77,10 +77,10 @@ frontmatter 定義命令屬性。內容成為模板。 ### Markdown -您還可以使用 Markdown 文件定義命令。將它們放入： +您也可以使用 Markdown 檔案定義指令。將它們放入： -- 全球：`~/.config/opencode/commands/` -- 每個項目：`.opencode/commands/` +- 全域：`~/.config/opencode/commands/` +- 每個專案：`.opencode/commands/` ```markdown title="~/.config/opencode/commands/test.md" --- @@ -93,8 +93,7 @@ Run the full test suite with coverage report and show any failures. Focus on the failing tests and suggest fixes. ``` -Markdown 文件名成為命令名。例如，`test.md` 讓 -你運行： +Markdown 檔名成為指令名。例如，`test.md` 讓您執行： ```bash frame="none" /test @@ -102,15 +101,15 @@ Markdown 文件名成為命令名。例如，`test.md` 讓 --- -## 提示配置 +## 提示設定 -自定義命令的提示支持幾個特殊的佔位符和語法。 +自定義指令的提示支援幾個特殊的預留位置和語法。 --- -### 參數 +### 參數 (Arguments) -使用 `$ARGUMENTS` 佔位符將參數傳遞給命令。 +使用 `$ARGUMENTS` 預留位置將參數傳遞給指令。 ```md title=".opencode/commands/component.md" --- @@ -121,7 +120,7 @@ Create a new React component named $ARGUMENTS with TypeScript support. Include proper typing and basic structure. ``` -使用參數運行命令： +使用參數執行指令： ```bash frame="none" /component Button @@ -129,7 +128,7 @@ Include proper typing and basic structure. `$ARGUMENTS` 將替換為 `Button`。 -您還可以使用位置參數訪問各個參數： +您也可以使用位置參數存取各個參數： - `$1` - 第一個參數 - `$2` - 第二個參數 @@ -147,7 +146,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\" }" @@ -155,17 +154,17 @@ with the following content: $3 這取代了： -- `$1` 與`config.json` -- `$2` 與`src` -- `$3` 與`{ "key": "value" }` +- `$1` 與 `config.json` +- `$2` 與 `src` +- `$3` 與 `{ "key": "value" }` --- ### Shell 輸出 -使用 _!`command`_ 將 [bash命令](/docs/tui#bash-commands) 輸出注入到提示符中。 +使用 _!`command`_ 將 [bash 指令](/docs/tui#bash-commands) 輸出注入到提示中。 -例如，要創建分析測試覆蓋率的自定義命令： +例如，要建立分析測試覆蓋率的自定義指令： ```md title=".opencode/commands/analyze-coverage.md" --- @@ -178,7 +177,7 @@ Here are the current test results: Based on these results, suggest improvements to increase coverage. ``` -或者查看最近的更改： +或者查看最近的變更： ```md title=".opencode/commands/review-changes.md" --- @@ -191,13 +190,13 @@ Recent git commits: Review these changes and suggest any improvements. ``` -命令在項目的根目錄中運行，其輸出成為提示的一部分。 +指令在專案的根目錄中執行，其輸出成為提示的一部分。 --- -### 文件參考 +### 檔案參考 -使用 `@` 後跟文件名將文件包含在命令中。 +使用 `@` 後跟檔名將檔案包含在指令中。 ```md title=".opencode/commands/review-component.md" --- @@ -208,19 +207,19 @@ Review the component in @src/components/Button.tsx. Check for performance issues and suggest improvements. ``` -文件內容會自動包含在提示中。 +檔案內容會自動包含在提示中。 --- ## 選項 -讓我們詳細看看配置選項。 +讓我們詳細看看設定選項。 --- -### 模板 +### 範本 (Template) -`template` 選項定義執行命令時將發送到 LLM 的提示。 +`template` 選項定義執行指令時將發送到 LLM 的提示。 ```json title="opencode.json" { @@ -232,13 +231,13 @@ Check for performance issues and suggest improvements. } ``` -這是一個**必需的**配置選項。 +這是一個**必需的**設定選項。 --- -### 描述 +### 描述 (Description) -使用 `description` 選項提供命令功能的簡要描述。 +使用 `description` 選項提供指令功能的簡要描述。 ```json title="opencode.json" { @@ -250,15 +249,15 @@ Check for performance issues and suggest improvements. } ``` -當您鍵入命令時，這將在 TUI 中顯示為描述。 +當您輸入指令時，這將在 TUI 中顯示為描述。 --- -### 代理 +### 代理 (Agent) -使用`agent` 配置可選擇指定哪個[代理](/docs/agents) 應執行此命令。 -如果這是 [子代理](/docs/agents/#subagents) 該命令將默認觸發子代理調用。 -要禁用此行為，請將`subtask` 設置為`false`。 +使用 `agent` 設定可選擇指定哪個 [代理](/docs/agents) 應執行此指令。 +如果這是 [子代理](/docs/agents/#subagents)，該指令將預設觸發子代理呼叫。 +要禁用此行為，請將 `subtask` 設定為 `false`。 ```json title="opencode.json" { @@ -270,15 +269,15 @@ Check for performance issues and suggest improvements. } ``` -這是一個**可選**配置選項。如果未指定，則默認為您當前的代理。 +這是一個**可選**設定選項。如果未指定，則預設為您當前的代理。 --- -### 子任務 +### 子任務 (Subtask) -使用`subtask` 布爾值強制命令觸發[子代理](/docs/agents/#subagents) 調用。 -如果您希望命令不污染您的主要上下文並且將**強制**代理充當子代理，那麼這非常有用， -即使`mode` 在[代理](/docs/agents) 配置上設置為`primary`。 +使用 `subtask` 布林值強制指令觸發 [子代理](/docs/agents/#subagents) 呼叫。 +如果您希望指令不污染您的主要上下文並且將**強制**代理充當子代理，那麼這非常有用， +即使 `mode` 在 [代理](/docs/agents) 設定上設定為 `primary`。 ```json title="opencode.json" { @@ -290,13 +289,13 @@ Check for performance issues and suggest improvements. } ``` -這是一個**可選**配置選項。 +這是一個**可選**設定選項。 --- -### 模型 +### 模型 (Model) -使用 `model` 配置覆蓋此命令的默認模型。 +使用 `model` 設定覆寫此指令的預設模型。 ```json title="opencode.json" { @@ -308,16 +307,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-tw/config.mdx b/packages/web/src/content/docs/zh-tw/config.mdx index d623f0b79..817b08673 100644 --- a/packages/web/src/content/docs/zh-tw/config.mdx +++ b/packages/web/src/content/docs/zh-tw/config.mdx @@ -1,15 +1,15 @@ --- -title: 配置 -description: 使用 opencode JSON 配置。 +title: 設定 +description: 使用 opencode JSON 設定。 --- -您可以使用 JSON 配置文件配置 opencode。 +您可以使用 JSON 設定檔設定 opencode。 --- ## 格式 -opencode 支持 **JSON** 和 **JSONC**（帶註釋的 JSON）格式。 +opencode 支援 **JSON** 和 **JSONC**（帶註解的 JSON）格式。 ```jsonc title="opencode.jsonc" { @@ -23,47 +23,46 @@ opencode 支持 **JSON** 和 **JSONC**（帶註釋的 JSON）格式。 --- -## 地點 +## 位置 -您可以將配置放置在幾個不同的位置，它們有一個 -不同的優先順序。 +您可以將設定放置在幾個不同的位置，它們有一個不同的優先順序。 :::note -配置文件**合併在一起**，而不是替換。 +設定檔**合併在一起**，而不是取代。 ::: -配置文件被合併在一起，而不是被替換。以下配置位置的設置被合併。僅當密鑰衝突時，後面的配置才會覆蓋前面的配置。保留所有配置中的非衝突設置。 +設定檔被合併在一起，而不是被取代。以下設定位置的設定被合併。僅當鍵值衝突時，後面的設定才會覆寫前面的設定。保留所有設定中的非衝突設定。 -例如，如果您的全局配置設置`theme: "opencode"`和`autoupdate: true`，並且您的項目配置設置`model: "anthropic/claude-sonnet-4-5"`，則最終配置將包括所有三個設置。 +例如，如果您的全域設定設定 `theme: "opencode"` 和 `autoupdate: true`，並且您的專案設定設定 `model: "anthropic/claude-sonnet-4-5"`，則最終設定將包括所有三個設定。 --- ### 優先順序 -配置源按以下順序加載（後面的源覆蓋前面的源）： +設定來源按以下順序載入（後面的來源覆寫前面的來源）： -1. **遠程配置**（來自`.well-known/opencode`）-組織默認值 -2. **全局配置** (`~/.config/opencode/opencode.json`) - 用戶首選項 -3. **自定義配置** (`OPENCODE_CONFIG` env var) - 自定義覆蓋 -4. **項目配置**（項目中的`opencode.json`）- 項目特定的設置 -5. **`.opencode` 目錄** - 代理、命令、插件 -6. **內聯配置** (`OPENCODE_CONFIG_CONTENT` env var) - 運行時覆蓋 +1. **遠端設定**（來自 `.well-known/opencode`）- 組織預設值 +2. **全域設定** (`~/.config/opencode/opencode.json`) - 使用者偏好設定 +3. **自定義設定** (`OPENCODE_CONFIG` env var) - 自定義覆寫 +4. **專案設定**（專案中的 `opencode.json`）- 專案特定的設定 +5. **`.opencode` 目錄** - 代理、指令、外掛 +6. **內聯設定** (`OPENCODE_CONFIG_CONTENT` env var) - 執行時覆寫 -這意味著項目配置可以覆蓋全局默認值，全局配置可以覆蓋遠程組織默認值。 +這意味著專案設定可以覆寫全域預設值，全域設定可以覆寫遠端組織預設值。 :::note -`.opencode` 和`~/.config/opencode` 目錄對子目錄使用**複數名稱**：`agents/`、`commands/`、`modes/`、`plugins/`、`skills/`、`tools/` 和`themes/`。為了向後兼容，還支持單數名稱（例如`agent/`）。 +`.opencode` 和 `~/.config/opencode` 目錄對子目錄使用**複數名稱**：`agents/`、`commands/`、`modes/`、`plugins/`、`skills/`、`tools/` 和 `themes/`。為了向後相容，也支援單數名稱（例如 `agent/`）。 ::: --- -### 遠程 +### 遠端 -組織可以通過 `.well-known/opencode` 端點提供默認配置。當您向支持它的提供商進行身份驗證時，會自動獲取該信息。 +組織可以透過 `.well-known/opencode` 端點提供預設設定。當您向支援它的供應商進行身分驗證時，會自動取得該資訊。 -首先加載遠程配置，作為基礎層。所有其他配置源（全局、項目）都可以覆蓋這些默認值。 +首先載入遠端設定，作為基礎層。所有其他設定來源（全域、專案）都可以覆寫這些預設值。 -例如，如果您的組織提供默認禁用的 MCP 服務器： +例如，如果您的組織提供預設禁用的 MCP 伺服器： ```json title="Remote config from .well-known/opencode" { @@ -77,7 +76,7 @@ opencode 支持 **JSON** 和 **JSONC**（帶註釋的 JSON）格式。 } ``` -您可以在本地配置中啟用特定服務器： +您可以在本地設定中啟用特定伺服器： ```json title="opencode.json" { @@ -93,60 +92,57 @@ opencode 支持 **JSON** 和 **JSONC**（帶註釋的 JSON）格式。 --- -### 全球的 +### 全域 -將全局 opencode 配置放在 `~/.config/opencode/opencode.json` 中。使用全局配置來實現用戶範圍的首選項，例如主題、提供商或按鍵綁定。 +將全域 opencode 設定放在 `~/.config/opencode/opencode.json` 中。使用全域設定來實現使用者範圍的偏好設定，例如主題、供應商或按鍵綁定。 -全局配置覆蓋遠程組織默認值。 +全域設定覆寫遠端組織預設值。 --- -### 每個項目 +### 每個專案 -在項目根目錄中添加`opencode.json`。項目配置在標準配置文件中具有最高優先級 - 它覆蓋全局配置和遠程配置。 +在專案根目錄中新增 `opencode.json`。專案設定在標準設定檔中具有最高優先級 - 它覆寫全域設定和遠端設定。 :::tip -將項目特定配置放在項目的根目錄中。 +將專案特定設定放在專案的根目錄中。 ::: -當 opencode 啟動時，它會在當前目錄中查找配置文件或遍歷到最近的 Git 目錄。 +當 opencode 啟動時，它會在當前目錄中尋找設定檔或遍歷到最近的 Git 目錄。 -這也可以安全地簽入 Git 並使用與全局模式相同的模式。 +這也可以安全地簽入 Git 並使用與全域模式相同的模式。 --- ### 自定義路徑 -使用 `OPENCODE_CONFIG` 環境變量指定自定義配置文件路徑。 +使用 `OPENCODE_CONFIG` 環境變數指定自定義設定檔路徑。 ```bash export OPENCODE_CONFIG=/path/to/my/custom-config.json opencode run "Hello world" ``` -自定義配置按優先順序在全局配置和項目配置之間加載。 +自定義設定按優先順序在全域設定和專案設定之間載入。 --- ### 自定義目錄 -使用`OPENCODE_CONFIG_DIR`指定自定義配置目錄 -環境變量。將在該目錄中搜索代理、命令、 -模式和插件就像標準`.opencode`目錄一樣，並且應該 -遵循相同的結構。 +使用 `OPENCODE_CONFIG_DIR` 環境變數指定自定義設定目錄。將在該目錄中搜尋代理、指令、模式和外掛，就像標準 `.opencode` 目錄一樣，並且應該遵循相同的結構。 ```bash export OPENCODE_CONFIG_DIR=/path/to/my/config-directory opencode run "Hello world" ``` -自定義目錄在全局配置和`.opencode`目錄之後加載，因此它**可以覆蓋**它們的設置。 +自定義目錄在全域設定和 `.opencode` 目錄之後載入，因此它**可以覆寫**它們的設定。 --- -## 模式 +## 架構 -配置文件具有在 [**`opencode.ai/config.json`**](https://opencode.ai/config.json) 中定義的架構。 +設定檔具有在 [**`opencode.ai/config.json`**](https://opencode.ai/config.json) 中定義的架構。 您的編輯器應該能夠根據架構進行驗證和自動完成。 @@ -154,7 +150,7 @@ opencode run "Hello world" ### TUI -您可以通過 `tui` 選項配置特定於 TUI 的設置。 +您可以透過 `tui` 選項設定特定於 TUI 的設定。 ```json title="opencode.json" { @@ -171,17 +167,17 @@ opencode run "Hello world" 可用選項： -- `scroll_acceleration.enabled` - 啟用 macOS 風格的滾動加速。 **優先於`scroll_speed`。 ** -- `scroll_speed` - 自定義滾動速度倍增（默認值：`3`，最小值：`1`）。如果`scroll_acceleration.enabled` 是`true`，則忽略。 -- `diff_style` - 控制差異渲染。 `"auto"` 適應terminal寬度，`"stacked"` 始終顯示單列。 +- `scroll_acceleration.enabled` - 啟用 macOS 風格的捲動加速。 **優先於 `scroll_speed`。** +- `scroll_speed` - 自定義捲動速度倍數（預設值：`3`，最小值：`1`）。如果 `scroll_acceleration.enabled` 是 `true`，則忽略。 +- `diff_style` - 控制差異顯示。 `"auto"` 適應終端機寬度，`"stacked"` 始終顯示單列。 -[在此處了解有關使用 TUI 的更多信息](/docs/tui)。 +[在此處了解有關使用 TUI 的更多資訊](/docs/tui)。 --- ### 伺服器 -您可以通過`opencode serve` 選項為`opencode web` 和`server` 命令配置服務器設置。 +您可以透過 `opencode serve` 選項為 `opencode web` 和 `server` 指令設定伺服器設定。 ```json title="opencode.json" { @@ -198,19 +194,19 @@ opencode run "Hello world" 可用選項： -- `port` - 監聽的端口。 -- `hostname` - 要監聽的主機名。當`mdns`啟用且未設置主機名時，默認為`0.0.0.0`。 -- `mdns` - 啟用 mDNS 服務發現。這允許網絡上的其他設備發現您的 opencode 服務器。 -- `mdnsDomain` - mDNS 服務的自定義域名。默認為`opencode.local`。對於在同一網絡上運行多個實例很有用。 -- `cors` - 從基於瀏覽器的客戶端使用 HTTP 服務器時允許 CORS 的其他來源。值必須是完整來源（方案+主機+可選端口），例如`https://app.example.com`。 +- `port` - 監聽的連接埠。 +- `hostname` - 要監聽的主機名稱。當 `mdns` 啟用且未設定主機名稱時，預設為 `0.0.0.0`。 +- `mdns` - 啟用 mDNS 服務探索。這允許網路上的其他設備發現您的 opencode 伺服器。 +- `mdnsDomain` - mDNS 服務的自定義網域名稱。預設為 `opencode.local`。對於在同一網路上執行多個實例很有用。 +- `cors` - 從基於瀏覽器的客戶端使用 HTTP 伺服器時允許 CORS 的其他來源。值必須是完整來源（通訊協定+主機+可選連接埠），例如 `https://app.example.com`。 -[在此處了解有關服務器的更多信息](/docs/server)。 +[在此處了解有關伺服器的更多資訊](/docs/server)。 --- ### 工具 -您可以通過 `tools` 選項管理LLM可以使用的工具。 +您可以透過 `tools` 選項管理 LLM 可以使用的工具。 ```json title="opencode.json" { @@ -222,13 +218,13 @@ opencode run "Hello world" } ``` -[在此處了解有關工具的更多信息](/docs/tools)。 +[在此處了解有關工具的更多資訊](/docs/tools)。 --- -### 型號 +### 模型 -您可以通過 `provider`、`model` 和 `small_model` 選項來配置要在 opencode 配置中使用的提供商和模型。 +您可以透過 `provider`、`model` 和 `small_model` 選項來設定要在 opencode 設定中使用的供應商和模型。 ```json title="opencode.json" { @@ -239,9 +235,9 @@ opencode run "Hello world" } ``` -`small_model` 選項為標題生成等輕量級任務配置單獨的模型。默認情況下，如果您的提供商可以提供更便宜的模型，opencode 會嘗試使用更便宜的模型，否則它會回退到您的主模型。 +`small_model` 選項為標題生成等輕量級任務設定單獨的模型。預設情況下，如果您的供應商可以提供更便宜的模型，opencode 會嘗試使用更便宜的模型，否則它會退回到您的主模型。 -提供者選項可以包括`timeout`和`setCacheKey`： +供應商選項可以包括 `timeout` 和 `setCacheKey`： ```json title="opencode.json" { @@ -257,20 +253,20 @@ opencode run "Hello world" } ``` -- `timeout` - 請求超時以毫秒為單位（默認值：300000）。設置為 `false` 以禁用。 -- `setCacheKey` - 確保始終為指定的提供者設置緩存密鑰。 +- `timeout` - 請求超時以毫秒為單位（預設值：300000）。設定為 `false` 以禁用。 +- `setCacheKey` - 確保始終為指定的供應商設定快取金鑰。 -您還可以配置[本地模型](/docs/models#local)。 [了解更多](/docs/models)。 +您也可以設定 [本地模型](/docs/models#local)。 [了解更多](/docs/models)。 --- -#### 特定於提供商的選項 +#### 特定於供應商的選項 -某些提供商支持除通用`timeout` 和`apiKey` 設置之外的其他配置選項。 +某些供應商支援除通用 `timeout` 和 `apiKey` 設定之外的其他設定選項。 -##### 亞馬遜基岩 +##### Amazon Bedrock -Amazon Bedrock 支持 AWS 特定配置： +Amazon Bedrock 支援 AWS 特定設定： ```json title="opencode.json" { @@ -287,21 +283,21 @@ Amazon Bedrock 支持 AWS 特定配置： } ``` -- `region` - Bedrock 的 AWS 區域（默認為 `AWS_REGION` env var 或 `us-east-1`） -- `profile` - 來自 `~/.aws/credentials` 的 AWS 命名配置文件（默認為 `AWS_PROFILE` env var） -- `endpoint` - VPC terminal節點的自定義terminal節點 URL。這是使用 AWS 特定術語的通用 `baseURL` 選項的別名。如果兩者都指定，`endpoint` 優先。 +- `region` - Bedrock 的 AWS 區域（預設為 `AWS_REGION` env var 或 `us-east-1`） +- `profile` - 來自 `~/.aws/credentials` 的 AWS 命名設定檔（預設為 `AWS_PROFILE` env var） +- `endpoint` - VPC 終端節點的自定義終端節點 URL。這是使用 AWS 特定術語的通用 `baseURL` 選項的別名。如果兩者都指定，`endpoint` 優先。 :::note -承載令牌（`AWS_BEARER_TOKEN_BEDROCK` 或`/connect`）優先於基於配置文件的身份驗證。詳情請參閱[認證優先級](/docs/providers#authentication-precedence)。 +Bearer Token (`AWS_BEARER_TOKEN_BEDROCK` 或 `/connect`) 優先於基於設定檔的身分驗證。詳情請參閱 [認證優先級](/docs/providers#authentication-precedence)。 ::: -[了解有關 Amazon Bedrock 配置的更多信息](/docs/providers#amazon-bedrock)。 +[了解有關 Amazon Bedrock 設定的更多資訊](/docs/providers#amazon-bedrock)。 --- ### 主題 -您可以通過 `theme` 選項在 opencode 配置中配置要使用的主題。 +您可以透過 `theme` 選項在 opencode 設定中設定要使用的主題。 ```json title="opencode.json" { @@ -314,9 +310,9 @@ Amazon Bedrock 支持 AWS 特定配置： --- -### Agents +### 代理 -您可以通過 `agent` 選項為特定任務配置專用代理。 +您可以透過 `agent` 選項為特定任務設定專用代理。 ```jsonc title="opencode.jsonc" { @@ -336,13 +332,13 @@ Amazon Bedrock 支持 AWS 特定配置： } ``` -您還可以使用 `~/.config/opencode/agents/` 或 `.opencode/agents/` 中的 markdown 文件定義代理。 [在這裡了解更多](/docs/agents)。 +您也可以使用 `~/.config/opencode/agents/` 或 `.opencode/agents/` 中的 markdown 檔案定義代理。 [在這裡了解更多](/docs/agents)。 --- -### 默認代理 +### 預設代理 -您可以使用 `default_agent` 選項設置默認代理。當沒有明確指定時，這將確定使用哪個代理。 +您可以使用 `default_agent` 選項設定預設代理。當沒有明確指定時，這將決定使用哪個代理。 ```json title="opencode.json" { @@ -351,15 +347,15 @@ Amazon Bedrock 支持 AWS 特定配置： } ``` -默認代理必須是主代理（而不是子代理）。這可以是內置代理，例如`"build"`或`"plan"`，或者您定義的[定制代理](/docs/agents)。如果指定的代理不存在或者是子代理，opencode 將回退到 `"build"` 並發出警告。 +預設代理必須是主代理（而不是子代理）。這可以是內建代理，例如 `"build"` 或 `"plan"`，或者您定義的 [自定義代理](/docs/agents)。如果指定的代理不存在或者是子代理，opencode 將退回到 `"build"` 並發出警告。 -此設置適用於所有介面：TUI、CLI (`opencode run`)、桌面應用程式和 GitHub Action。 +此設定適用於所有介面：TUI、CLI (`opencode run`)、桌面應用程式和 GitHub Action。 --- ### 分享 -您可以通過`share`選項配置[分享](/docs/share)功能。 +您可以透過 `share` 選項設定 [分享](/docs/share) 功能。 ```json title="opencode.json" { @@ -370,17 +366,17 @@ Amazon Bedrock 支持 AWS 特定配置： 這需要： -- `"manual"` - 允許通過命令手動共享（默認） +- `"manual"` - 允許透過指令手動分享（預設） - `"auto"` - 自動分享新對話 -- `"disabled"` - 完全禁用共享 +- `"disabled"` - 完全禁用分享 -默認情況下，共享設置為手動模式，您需要使用 `/share` 命令顯式共享對話。 +預設情況下，分享設定為手動模式，您需要使用 `/share` 指令明確分享對話。 --- -### 命令 +### 指令 -您可以通過`command`選項為重複任務配置自定義命令。 +您可以透過 `command` 選項為重複任務設定自定義指令。 ```jsonc title="opencode.jsonc" { @@ -400,13 +396,13 @@ Amazon Bedrock 支持 AWS 特定配置： } ``` -您還可以使用 `~/.config/opencode/commands/` 或 `.opencode/commands/` 中的 Markdown 文件定義命令。 [在這裡了解更多](/docs/commands)。 +您也可以使用 `~/.config/opencode/commands/` 或 `.opencode/commands/` 中的 Markdown 檔案定義指令。 [在這裡了解更多](/docs/commands)。 --- ### 按鍵綁定 -您可以通過 `keybinds` 選項自定義您的按鍵綁定。 +您可以透過 `keybinds` 選項自定義您的按鍵綁定。 ```json title="opencode.json" { @@ -430,14 +426,14 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup } ``` -如果您不想更新但希望在新版本可用時收到通知，請將`autoupdate` 設置為`"notify"`。 -請注意，這僅在未使用 Homebrew 等包管理器安裝時才有效。 +如果您不想更新但希望在新版本可用時收到通知，請將 `autoupdate` 設定為 `"notify"`。 +請注意，這僅在未使用 Homebrew 等套件管理器安裝時才有效。 --- -### 格式化程序 +### 格式化程式 -您可以通過`formatter`選項配置程式碼格式化程序。 +您可以透過 `formatter` 選項設定程式碼格式化程式。 ```json title="opencode.json" { @@ -457,15 +453,15 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup } ``` -[在此處了解有關格式化程序的更多信息](/docs/formatters)。 +[在此處了解有關格式化程式的更多資訊](/docs/formatters)。 --- ### 權限 -默認情況下，opencode **允許所有操作**，無需明確批准。您可以使用`permission` 選項更改此設置。 +預設情況下，opencode **允許所有操作**，無需明確批准。您可以使用 `permission` 選項更改此設定。 -例如，要確保 `edit` 和 `bash` 工具需要用戶批准： +例如，要確保 `edit` 和 `bash` 工具需要使用者批准： ```json title="opencode.json" { @@ -477,13 +473,13 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup } ``` -[在此處了解有關權限的更多信息](/docs/permissions)。 +[在此處了解有關權限的更多資訊](/docs/permissions)。 --- -### 壓實 +### 壓縮 -您可以通過 `compaction` 選項控制上下文壓縮行為。 +您可以透過 `compaction` 選項控制上下文壓縮行為。 ```json title="opencode.json" { @@ -495,14 +491,14 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup } ``` -- `auto` - 當上下文已滿時自動壓縮會話（默認值：`true`）。 -- `prune` - 刪除舊工具輸出以保存令牌（默認值：`true`）。 +- `auto` - 當上下文已滿時自動壓縮工作階段（預設值：`true`）。 +- `prune` - 刪除舊工具輸出以節省 tokens（預設值：`true`）。 --- -### 守望者 +### 觀察者 (Watcher) -您可以通過`watcher`選項配置文件觀察器忽略模式。 +您可以透過 `watcher` 選項設定檔案觀察器忽略模式。 ```json title="opencode.json" { @@ -513,13 +509,13 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup } ``` -模式遵循 glob 語法。使用它可以從文件監視中排除嘈雜的目錄。 +模式遵循 glob 語法。使用它可以從檔案監視中排除嘈雜的目錄。 --- -### MCP服務器 +### MCP 伺服器 -您可以通過 `mcp` 選項配置要使用的 MCP 服務器。 +您可以透過 `mcp` 選項設定要使用的 MCP 伺服器。 ```json title="opencode.json" { @@ -532,11 +528,11 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup --- -### 插件 +### 外掛 -[插件](/docs/plugins) 使用自定義工具、掛鉤和集成擴展 opencode。 +[外掛](/docs/plugins) 使用自定義工具、掛鉤和整合擴展 opencode。 -將插件文件放置在`.opencode/plugins/` 或`~/.config/opencode/plugins/` 中。您還可以通過 `plugin` 選項從 npm 加載插件。 +將外掛檔案放置在 `.opencode/plugins/` 或 `~/.config/opencode/plugins/` 中。您也可以透過 `plugin` 選項從 npm 載入外掛。 ```json title="opencode.json" { @@ -549,9 +545,9 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup --- -### 指示 +### 指示 (Instructions) -您可以通過 `instructions` 選項配置您正在使用的型號的說明。 +您可以透過 `instructions` 選項設定您正在使用的模型的指示。 ```json title="opencode.json" { @@ -560,14 +556,13 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup } ``` -這需要指令文件的路徑和全局模式數組。 [了解更多 -關於規則在這裡](/docs/rules)。 +這需要指示檔案的路徑和全域模式陣列。 [了解更多關於規則在這裡](/docs/rules)。 --- -### 殘疾服務提供者 +### 禁用供應商 -您可以通過 `disabled_providers` 選項禁用自動加載的提供商。當您想要阻止加載某些提供商（即使其憑據可用）時，這非常有用。 +您可以透過 `disabled_providers` 選項禁用自動載入的供應商。當您想要阻止載入某些供應商（即使其憑證可用）時，這非常有用。 ```json title="opencode.json" { @@ -577,20 +572,20 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup ``` :::note -`disabled_providers` 優先於`enabled_providers`。 +`disabled_providers` 優先於 `enabled_providers`。 ::: -`disabled_providers` 選項接受提供者 ID 數組。當提供者被禁用時： +`disabled_providers` 選項接受供應商 ID 陣列。當供應商被禁用時： -- 即使設置了環境變量也不會加載。 -- 即使通過 `/connect` 命令配置 API 密鑰，也不會加載它。 -- 提供商的型號不會出現在型號選擇列表中。 +- 即使設定了環境變數也不會載入。 +- 即使透過 `/connect` 指令設定 API 金鑰，也不會載入它。 +- 供應商的模型不會出現在模型選擇列表中。 --- -### 啟用的提供商 +### 啟用的供應商 -您可以通過 `enabled_providers` 選項指定提供商的允許列表。設置後，僅啟用指定的提供商，所有其他提供商將被忽略。 +您可以透過 `enabled_providers` 選項指定供應商的允許清單。設定後，僅啟用指定的供應商，所有其他供應商將被忽略。 ```json title="opencode.json" { @@ -599,13 +594,13 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup } ``` -當您想要限制 opencode 僅使用特定的提供商而不是一一禁用它們時，這非常有用。 +當您想要限制 opencode 僅使用特定的供應商而不是一一禁用它們時，這非常有用。 :::note -`disabled_providers` 優先於`enabled_providers`。 +`disabled_providers` 優先於 `enabled_providers`。 ::: -如果某個提供商同時出現在`enabled_providers` 和`disabled_providers` 中，則`disabled_providers` 優先考慮向後兼容性。 +如果某個供應商同時出現在 `enabled_providers` 和 `disabled_providers` 中，則 `disabled_providers` 優先考慮向後相容性。 --- @@ -626,15 +621,15 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup --- -## 變量 +## 變數 -您可以在配置文件中使用變量替換來引用環境變量和文件內容。 +您可以在設定檔中使用變數替換來引用環境變數和檔案內容。 --- -### 環境變量 +### 環境變數 -使用`{env:VARIABLE_NAME}`替換環境變量： +使用 `{env:VARIABLE_NAME}` 替換環境變數： ```json title="opencode.json" { @@ -651,13 +646,13 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup } ``` -如果未設置環境變量，它將被替換為空字符串。 +如果未設定環境變數，它將被替換為空字串。 --- -### 文件 +### 檔案 -使用 `{file:path/to/file}` 替換文件的內容： +使用 `{file:path/to/file}` 替換檔案的內容： ```json title="opencode.json" { @@ -673,13 +668,13 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup } ``` -文件路徑可以是： +檔案路徑可以是： -- 相對於配置文件目錄 +- 相對於設定檔目錄 - 或者以 `/` 或 `~` 開頭的絕對路徑 這些對於： -- 將 API 密鑰等敏感數據保存在單獨的文件中。 -- 包含大型指令文件，而不會弄亂您的配置。 -- 跨多個配置文件共享通用配置片段。 +- 將 API 金鑰等敏感數據保存在單獨的檔案中。 +- 包含大型指示檔案，而不會弄亂您的設定。 +- 跨多個設定檔共享通用設定片段。 diff --git a/packages/web/src/content/docs/zh-tw/custom-tools.mdx b/packages/web/src/content/docs/zh-tw/custom-tools.mdx index e55e01da2..29db4675e 100644 --- a/packages/web/src/content/docs/zh-tw/custom-tools.mdx +++ b/packages/web/src/content/docs/zh-tw/custom-tools.mdx @@ -1,30 +1,30 @@ --- -title: 定制工具 -description: 創建LLM可以在opencode中調用的工具。 +title: 自定義工具 +description: 建立 LLM 可以在 opencode 中呼叫的工具。 --- -自定義工具是您創建的函數，LLM 可以在對話期間調用。它們與 opencode 的 [內置工具](/docs/tools) 一起工作，例如 `read`、`write` 和 `bash`。 +自定義工具是您建立的函式，LLM 可以在對話期間呼叫。它們與 opencode 的 [內建工具](/docs/tools) 一起工作，例如 `read`、`write` 和 `bash`。 --- -## 創建工具 +## 建立工具 -工具定義為 **TypeScript** 或 **JavaScript** 文件。但是，工具定義可以調用用 **任何語言** 編寫的腳本 - TypeScript 或 JavaScript 僅用於工具定義本身。 +工具定義為 **TypeScript** 或 **JavaScript** 檔案。但是，工具定義可以呼叫用 **任何語言** 編寫的指令碼 - TypeScript 或 JavaScript 僅用於工具定義本身。 --- -### 地點 +### 位置 它們可以定義為： -- 通過將它們放在項目的 `.opencode/tools/` 目錄中來本地進行。 -- 或者在全局範圍內，將它們放置在 `~/.config/opencode/tools/` 中。 +- 透過將它們放在專案的 `.opencode/tools/` 目錄中來本地進行。 +- 或者在全域範圍內，將它們放置在 `~/.config/opencode/tools/` 中。 --- ### 結構 -創建工具的最簡單方法是使用 `tool()` 幫助程序，它提供類型安全和驗證。 +建立工具的最簡單方法是使用 `tool()` 輔助程式，它提供類型安全和驗證。 ```ts title=".opencode/tools/database.ts" {1} import { tool } from "@opencode-ai/plugin" @@ -41,13 +41,13 @@ export default tool({ }) ``` -**文件名**成為**工具名稱**。以上創建了一個 `database` 工具。 +**檔名**成為**工具名稱**。以上建立了一個 `database` 工具。 --- -#### 每個文件多個工具 +#### 每個檔案多個工具 -您還可以從單個文件導出多個工具。每個導出都會成為**一個單獨的工具**，名稱為**`_`**： +您也可以從單個檔案匯出多個工具。每個匯出都會成為**一個單獨的工具**，名稱為 **`_`**： ```ts title=".opencode/tools/math.ts" import { tool } from "@opencode-ai/plugin" @@ -75,13 +75,13 @@ export const multiply = tool({ }) ``` -這將創建兩個工具：`math_add` 和`math_multiply`。 +這將建立兩個工具：`math_add` 和 `math_multiply`。 --- -### 論據 +### 參數 (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" @@ -126,18 +126,18 @@ export default tool({ }) ``` -使用 `context.directory` 作為會話工作目錄。 +使用 `context.directory` 作為工作階段工作目錄。 使用 `context.worktree` 作為 git 工作樹根。 --- -## 示例 +## 範例 -### 用Python編寫一個工具 +### 用 Python 編寫一個工具 -您可以用任何您想要的語言編寫工具。下面是一個使用 Python 將兩個數字相加的示例。 +您可以用任何您想要的語言編寫工具。下面是一個使用 Python 將兩個數字相加的範例。 -首先，將該工具創建為 Python 腳本： +首先，將該工具建立為 Python 指令碼： ```python title=".opencode/tools/add.py" import sys @@ -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" @@ -167,4 +167,4 @@ export default tool({ }) ``` -這裡我們使用 [`Bun.$`](https://bun.com/docs/runtime/shell) 實用程序來運行 Python 腳本。 +這裡我們使用 [`Bun.$`](https://bun.com/docs/runtime/shell) 公用程式來執行 Python 指令碼。 diff --git a/packages/web/src/content/docs/zh-tw/ecosystem.mdx b/packages/web/src/content/docs/zh-tw/ecosystem.mdx index e3dfac52b..ca0d8bf15 100644 --- a/packages/web/src/content/docs/zh-tw/ecosystem.mdx +++ b/packages/web/src/content/docs/zh-tw/ecosystem.mdx @@ -1,52 +1,52 @@ --- title: 生態系統 -description: 使用 opencode 構建的項目和集成。 +description: 使用 opencode 構建的專案和整合。 --- -基於 opencode 的社區項目集合。 +基於 opencode 的社群專案集合。 :::note -想要將您的 opencode 相關項目添加到此列表中嗎？提交 PR。 +想要將您的 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)，這是一個聚合生態系統和社群的社群。 --- -## 插件 +## 外掛 -| 名稱 | 描述 | -| --------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | -| [opencode-daytona](https://github.com/jamesmurdza/daytona/blob/main/guides/typescript/opencode/README.md) | 使用 git 同步和實時預覽在隔離的 Daytona 沙箱中自動運行 opencode 會話 | -| [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) | 通過修剪過時的工具輸出來優化代幣使用 | -| [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 生成的 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) | 使用超級內存跨會話持久內存 | -| [@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) | 使用 git 同步和即時預覽在隔離的 Daytona 沙箱中自動執行 opencode 工作階段 | +| [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) | 透過修剪過時的工具輸出來最佳化代幣使用 | +| [opencode-websearch-cited](https://github.com/ghoulr/opencode-websearch-cited.git) | 為具有 Google Grounding 風格的受支援供應商添加原生網路搜尋支援 | +| [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 生成的 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) | 使用超級記憶體跨工作階段持久記憶體 | +| [@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 工作樹 | --- @@ -54,23 +54,23 @@ description: 使用 opencode 構建的項目和集成。 | 名稱 | 描述 | | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------- | -| [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 | -| [opencode plugin template](https://github.com/zenobi-us/opencode-plugin-template/) | 用於構建 opencode 插件的模板 | -| [opencode.nvim](https://github.com/sudo-tee/opencode.nvim) | Neovim opencode 前端 - 基於 terminal 的 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 擴展 | -| [OpenCode-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 擴展管理器具有可移植、隔離的配置文件。 | -| [CodeNomad](https://github.com/NeuralNomadsAI/CodeNomad) | opencode 的桌面、Web、移動和遠程客戶端應用程式 | +| [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 | +| [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 擴充功能 | +| [OpenCode-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 擴充功能管理器具有可攜式、隔離的設定檔。 | +| [CodeNomad](https://github.com/NeuralNomadsAI/CodeNomad) | opencode 的桌面、Web、行動和遠端客戶端應用程式 | --- -## Agents +## 代理 | 名稱 | 描述 | | ----------------------------------------------------------------- | ---------------------------------------- | -| [Agentic](https://github.com/Cluster444/agentic) | 用於結構化開發的模塊化AI代理和命令 | -| [opencode-agents](https://github.com/darrenhinde/opencode-agents) | 用於增強工作流程的配置、提示、代理和插件 | +| [Agentic](https://github.com/Cluster444/agentic) | 用於結構化開發的模組化 AI 代理和指令 | +| [opencode-agents](https://github.com/darrenhinde/opencode-agents) | 用於增強工作流程的設定、提示、代理和外掛 | diff --git a/packages/web/src/content/docs/zh-tw/enterprise.mdx b/packages/web/src/content/docs/zh-tw/enterprise.mdx index 0df88ae07..c4e5451b5 100644 --- a/packages/web/src/content/docs/zh-tw/enterprise.mdx +++ b/packages/web/src/content/docs/zh-tw/enterprise.mdx @@ -1,36 +1,35 @@ --- -title: 企業 +title: 企業版 description: 在您的組織中安全地使用 opencode。 --- import config from "../../../../config.mjs" export const email = `mailto:${config.email}` -opencode Enterprise 適用於希望確保其程式碼和數據永遠不會離開其基礎設施的組織。它可以通過使用與 SSO 和內部 AI 網關集成的集中式配置來實現此目的。 +opencode Enterprise 適用於希望確保其程式碼和資料永遠不會離開其基礎架構的組織。它可以透過使用與 SSO 和內部 AI 閘道整合的集中式設定來實現此目的。 :::note -opencode 不存儲您的任何程式碼或上下文數據。 +opencode 不儲存您的任何程式碼或上下文資料。 ::: 要開始使用 opencode Enterprise： -1. 與您的團隊進行內部試驗。 -2. **聯繫我們**討論定價和實施選項。 +1. 與您的團隊進行內部試用。 +2. **聯絡我們**討論定價和實作選項。 --- -## 審判 +## 試用 -opencode 是開源的，不存儲您的任何程式碼或上下文數據，因此您的開發人員只需 [開始吧](/docs/) 並進行試用。 +opencode 是開源的，不儲存您的任何程式碼或上下文資料，因此您的開發人員只需 [開始使用](/docs/) 並進行試用。 --- -### 數據處理 +### 資料處理 -**opencode 不會存儲您的程式碼或上下文數據。 ** 所有處理都在本地進行或通過直接 API 調用您的 AI 提供商。 +**opencode 不會儲存您的程式碼或上下文資料。** 所有處理都在本地進行或透過直接 API 呼叫您的 AI 供應商。 -這意味著只要您使用您信任的提供商或內部提供商 -AI網關，您可以安全使用opencode。 +這意味著只要您使用您信任的供應商或內部 AI 閘道，您就可以安全使用 opencode。 這裡唯一需要注意的是可選的 `/share` 功能。 @@ -38,9 +37,9 @@ AI網關，您可以安全使用opencode。 #### 分享對話 -如果用戶啟用 `/share` 功能，對話和與之關聯的數據將被發送到我們用於在 opencode.ai 上託管這些共享頁面的服務。 +如果使用者啟用 `/share` 功能，對話和與之關聯的資料將被發送到我們用於在 opencode.ai 上託管這些分享頁面的服務。 -數據當前通過我們的 CDN 邊緣網絡提供服務，並緩存在用戶附近的邊緣。 +資料當前透過我們的 CDN 邊緣網路提供服務，並快取在使用者附近的邊緣。 我們建議您在試用時禁用此功能。 @@ -51,120 +50,118 @@ AI網關，您可以安全使用opencode。 } ``` -[了解更多關於分享的信息](/docs/share)。 +[了解更多關於分享的資訊](/docs/share)。 --- ### 程式碼所有權 -**您擁有 opencode 生成的所有程式碼。 ** 沒有許可限製或所有權聲明。 +**您擁有 opencode 生成的所有程式碼。** 沒有授權限制或所有權聲明。 --- ## 定價 -我們對 opencode Enterprise 使用單機模型。如果您有自己的 LLM 網關，我們不會對使用的令牌收取費用。有關定價和實施選項的更多詳細信息，請**聯繫我們**。 +我們對 opencode Enterprise 使用按席位計費模式。如果您有自己的 LLM 閘道，我們不會對使用的 Tokens 收取費用。有關定價和實作選項的更多詳細資訊，請**聯絡我們**。 --- ## 部署 完成試用並準備好使用 opencode 後，請訪問： -您的組織，您可以**聯繫我們**進行討論 -定價和實施選項。 +您的組織，您可以**聯絡我們**進行討論 +定價和實作選項。 --- -### 中央配置 +### 中央設定 -我們可以將 opencode 設置為為您的整個組織使用單一的中央配置。 +我們可以將 opencode 設定為為您的整個組織使用單一的中央設定。 -這種集中式配置可以與您的 SSO 提供商集成，並確保所有用戶僅訪問您的內部 AI 網關。 +這種集中式設定可以與您的 SSO 供應商整合，並確保所有使用者僅存取您的內部 AI 閘道。 --- -### 單點登錄集成 +### 單一登入整合 -通過中央配置，opencode 可以與您組織的 SSO 提供商集成以進行身份​​驗證。 +透過中央設定，opencode 可以與您組織的 SSO 供應商整合以進行身分驗證。 -這使得 opencode 能夠通過現有的身份管理系統獲取內部 AI 網關的憑據。 +這使得 opencode 能夠透過現有的身分管理系統取得內部 AI 閘道的憑證。 --- -### 內部AI網關 +### 內部 AI 閘道 -通過中央配置，opencode 還可以配置為僅使用您的內部 AI 網關。 +透過中央設定，opencode 還可以設定為僅使用您的內部 AI 閘道。 -您還可以禁用所有其他 AI 提供商，確保所有請求都通過組織批准的基礎設施。 +您還可以禁用所有其他 AI 供應商，確保所有請求都通過組織核准的基礎架構。 --- -### 自託管 +### 自行託管 -雖然我們建議禁用共享頁面以確保您的數據永遠不會離開 -您的組織，我們還可以幫助您在您的基礎設施上自行託管它們。 +雖然我們建議禁用分享頁面以確保您的資料永遠不會離開您的組織，我們還可以幫助您在您的基礎架構上自行託管它們。 目前這已在我們的路線圖上。如果您有興趣，**讓我們知道**。 --- -## 常問問題 +## 常見問題
什麼是 opencode Enterprise？ -opencode Enterprise 適用於希望確保其程式碼和數據永遠不會離開其基礎設施的組織。它可以通過使用與 SSO 和內部 AI 網關集成的集中式配置來實現此目的。 +opencode Enterprise 適用於希望確保其程式碼和資料永遠不會離開其基礎架構的組織。它可以透過使用與 SSO 和內部 AI 閘道整合的集中式設定來實現此目的。
如何開始使用 opencode Enterprise？ -只需與您的團隊進行內部試用即可。 opencode 默認情況下不存儲您的程式碼或上下文數據，因此可以輕鬆上手。 +只需與您的團隊進行內部試用即可。 opencode 預設情況下不儲存您的程式碼或上下文資料，因此可以輕鬆上手。 -然後**聯繫我們**討論定價和實施選項。 +然後**聯絡我們**討論定價和實作選項。
企業定價如何運作？ -我們提供按席位企業定價。如果您有自己的 LLM 網關，我們不會對使用的令牌收取費用。如需了解更多詳情，請**聯繫我們**，獲取根據您組織的需求定制的報價。 +我們提供按席位企業定價。如果您有自己的 LLM 閘道，我們不會對使用的 Tokens 收取費用。如需了解更多詳情，請**聯絡我們**，獲取根據您組織的需求客製化的報價。
-opencode Enterprise 保證我的數據安全嗎？ +opencode Enterprise 保證我的資料安全嗎？ -是的。 opencode 不存儲您的程式碼或上下文數據。所有處理都在本地進行或通過直接 API 調用您的 AI 提供商。通過中央配置和 SSO 集成，您的數據在組織的基礎架構中保持安全。 +是的。 opencode 不儲存您的程式碼或上下文資料。所有處理都在本地進行或透過直接 API 呼叫您的 AI 供應商。透過中央設定和 SSO 整合，您的資料在組織的基礎架構中保持安全。
-我們可以使用自己的私有 NPM 註冊表嗎？ +我們可以使用自己的私有 NPM Registry 嗎？ -opencode 通過 Bun 的本機 `.npmrc` 文件支持來支持私有 npm 註冊表。如果您的組織使用私有註冊表，例如 JFrog Artifactory、Nexus 或類似的註冊表，請確保開發人員在運行 opencode 之前經過身份驗證。 +opencode 透過 Bun 的原生 `.npmrc` 檔案支援來支援私有 npm Registry。如果您的組織使用私有 Registry，例如 JFrog Artifactory、Nexus 或類似的 Registry，請確保開發人員在執行 opencode 之前經過身分驗證。 -要使用您的私有註冊表設置身份驗證： +要使用您的私有 Registry 設定身分驗證： ```bash npm login --registry=https://your-company.jfrog.io/api/npm/npm-virtual/ ``` -這將創建帶有身份驗證詳細信息的`~/.npmrc`。 opencode 會自動 -拿起這個。 +這將建立帶有身分驗證詳細資訊的 `~/.npmrc`。 opencode 會自動讀取這個。 :::caution -在運行 opencode 之前，您必須登錄私有註冊表。 +在執行 opencode 之前，您必須登入私有 Registry。 ::: -或者，您可以手動配置 `.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 之前登入私有 Registry，以確保可以從企業 Registry 安裝套件。
diff --git a/packages/web/src/content/docs/zh-tw/formatters.mdx b/packages/web/src/content/docs/zh-tw/formatters.mdx index b47fb3470..2ded1419d 100644 --- a/packages/web/src/content/docs/zh-tw/formatters.mdx +++ b/packages/web/src/content/docs/zh-tw/formatters.mdx @@ -1,62 +1,62 @@ --- -title: 格式化程序 -description: opencode 使用特定於語言的格式化程序。 +title: 格式化程式 +description: opencode 使用特定於語言的格式化程式。 --- -使用特定於語言的格式化程序編寫或編輯文件後，opencode 會自動格式化文件。這可確保生成的程式碼遵循項目的程式碼風格。 +使用特定於語言的格式化程式編寫或編輯檔案後，opencode 會自動格式化檔案。這可確保生成的程式碼遵循專案的程式碼風格。 --- ## 內建 -opencode 附帶了多個適用於流行語言和框架的內置格式化程序。下面是格式化程序、支持的文件擴展名以及所需的命令或配置選項的列表。 +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) | `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` 配置文件 | -| ktlint | .kt, .kts | `ktlint` 命令可用 | -| ruff | .py, .pyi | `ruff` 命令可用并配置完成 | -| rustfmt | .rs | `rustfmt` 命令可用 | -| cargofmt | .rs | `cargo fmt` 命令可用 | -| uv | .py, .pyi | `uv` 命令可用 | -| rubocop | .rb, .rake, .gemspec, .ru | `rubocop` 命令可用 | -| standardrb | .rb, .rake, .gemspec, .ru | `standardrb` 命令可用 | -| htmlbeautifier | .erb, .html.erb | `htmlbeautifier` 命令可用 | -| air | .R | `air` 命令可用 | -| dart | .dart | `dart` 命令可用 | -| ocamlformat | .ml, .mli | `ocamlformat` 命令可用，且存在 `.ocamlformat` 配置文件 | -| terraform | .tf, .tfvars | `terraform` 命令可用 | -| gleam | .gleam | `gleam` 命令可用 | -| nixfmt | .nix | `nixfmt` 命令可用 | -| shfmt | .sh, .bash | `shfmt` 命令可用 | -| pint | .php | `laravel/pint` 中有 `composer.json` 依賴 | -| oxfmt (Experimental) | .js, .jsx, .ts, .tsx | `oxfmt` 中有 `package.json` 依賴且啟用[實驗環境變量旗標](/docs/cli/#experimental) | -| ormolu | .hs | `ormolu` 命令可用 | +| 格式化程式 | 副檔名 | 要求 | +| -------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | +| 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) | `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` 設定檔 | +| ktlint | .kt, .kts | `ktlint` 指令可用 | +| ruff | .py, .pyi | `ruff` 指令可用並設定完成 | +| rustfmt | .rs | `rustfmt` 指令可用 | +| cargofmt | .rs | `cargo fmt` 指令可用 | +| uv | .py, .pyi | `uv` 指令可用 | +| rubocop | .rb, .rake, .gemspec, .ru | `rubocop` 指令可用 | +| standardrb | .rb, .rake, .gemspec, .ru | `standardrb` 指令可用 | +| htmlbeautifier | .erb, .html.erb | `htmlbeautifier` 指令可用 | +| air | .R | `air` 指令可用 | +| dart | .dart | `dart` 指令可用 | +| ocamlformat | .ml, .mli | `ocamlformat` 指令可用，且存在 `.ocamlformat` 設定檔 | +| terraform | .tf, .tfvars | `terraform` 指令可用 | +| gleam | .gleam | `gleam` 指令可用 | +| nixfmt | .nix | `nixfmt` 指令可用 | +| shfmt | .sh, .bash | `shfmt` 指令可用 | +| pint | .php | `laravel/pint` 中有 `composer.json` 相依套件 | +| oxfmt (Experimental) | .js, .jsx, .ts, .tsx | `oxfmt` 中有 `package.json` 相依套件且啟用[實驗環境變數旗標](/docs/cli/#experimental) | +| ormolu | .hs | `ormolu` 指令可用 | -因此，如果您的項目的`prettier`中有`package.json`，opencode將自動使用它。 +因此，如果您的專案的 `package.json` 中有 `prettier`，opencode 將自動使用它。 --- ## 它是如何運作的 -當 opencode 寫入或編輯文件時，它： +當 opencode 寫入或編輯檔案時，它： -1. 根據所有啟用的格式化程序檢查文件擴展名。 -2. 對文件運行適當的格式化程序命令。 -3. 自動應用格式更改。 +1. 根據所有啟用的格式化程式檢查檔案副檔名。 +2. 對檔案執行適當的格式化程式指令。 +3. 自動套用格式變更。 -此過程在後台進行，確保無需任何手動步驟即可維護您的程式碼樣式。 +此過程在背景進行，確保無需任何手動步驟即可維護您的程式碼樣式。 --- -## 配置 +## 設定 -您可以通過 opencode 配置中的 `formatter` 部分自定義格式化程序。 +您可以透過 opencode 設定中的 `formatter` 部分自定義格式化程式。 ```json title="opencode.json" { @@ -65,22 +65,22 @@ opencode 附帶了多個適用於流行語言和框架的內置格式化程序 } ``` -每個格式化程序配置支持以下內容： +每個格式化程式設定支援以下內容： -| 物業 | 類型 | 描述 | -| ------------- | -------- | ---------------------------------- | -| `disabled` | 布爾 | 將其設置為 `true` 以禁用格式化程序 | -| `command` | 字符串[] | 格式化運行的命令 | -| `environment` | 對象 | 運行格式化程序時要設置的環境變量 | -| `extensions` | 字符串[] | 此格式化程序應處理的文件擴展名 | +| 屬性 | 類型 | 描述 | +| ------------- | ------ | ---------------------------------- | +| `disabled` | 布林值 | 將其設定為 `true` 以禁用格式化程式 | +| `command` | 字串[] | 格式化執行的指令 | +| `environment` | 物件 | 執行格式化程式時要設定的環境變數 | +| `extensions` | 字串[] | 此格式化程式應處理的檔案副檔名 | 讓我們看一些例子。 --- -### 禁用格式化程序 +### 禁用格式化程式 -要全局禁用**所有**格式化程序，請將`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} { @@ -127,4 +127,4 @@ opencode 附帶了多個適用於流行語言和框架的內置格式化程序 } ``` -命令中的 **`$FILE` 佔位符** 將替換為正在格式化的文件的路徑。 +指令中的 **`$FILE` 預留位置** 將替換為正在格式化的檔案的路徑。 diff --git a/packages/web/src/content/docs/zh-tw/github.mdx b/packages/web/src/content/docs/zh-tw/github.mdx index ccee14109..32d3f005e 100644 --- a/packages/web/src/content/docs/zh-tw/github.mdx +++ b/packages/web/src/content/docs/zh-tw/github.mdx @@ -1,43 +1,43 @@ --- title: GitHub -description: 在 GitHub 問題和拉取請求中使用 opencode。 +description: 在 GitHub Issues 和拉取請求中使用 opencode。 --- -opencode 與您的 GitHub 工作流程集成。在評論中提及`/opencode` 或`/oc`，opencode 將在您的 GitHub Actions 運行器中執行任務。 +opencode 與您的 GitHub 工作流程整合。在評論中提及 `/opencode` 或 `/oc`，opencode 將在您的 GitHub Actions Runner 中執行任務。 --- -## 特徵 +## 功能 - **分類問題**：要求 opencode 調查問題並向您解釋。 -- **修復和實施**：要求 opencode 修復問題或實施功能。它將在一個新分支中工作並提交包含所有更改的 PR。 -- **安全**：opencode 在 GitHub 的運行器中運行。 +- **修復和實作**：要求 opencode 修復問題或實作功能。它將在一個新分支中工作並提交包含所有變更的 PR。 +- **安全**：opencode 在 GitHub 的 Runner 中執行。 --- ## 安裝 -在 GitHub 存儲庫中的項目中運行以下命令： +在 GitHub 儲存庫中的專案中執行以下指令： ```bash opencode github install ``` -這將引導您完成安裝 GitHub 應用程式、創建工作流程和設置機密。 +這將引導您完成安裝 GitHub 應用程式、建立工作流程和設定 Secrets。 --- -### 手動設置 +### 手動設定 -或者您可以手動設置。 +或者您可以手動設定。 -1. Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try again later.That’s all we know. +1. **安裝 GitHub 應用程式** - 前往[**github.com/apps/opencode-agent**](https://github.com/apps/opencode-agent)。確保它已安裝在目標存儲庫上。 + 前往 [**github.com/apps/opencode-agent**](https://github.com/apps/opencode-agent)。確保它已安裝在目標儲存庫上。 -2. **添加工作流程** +2. **新增工作流程** - 將以下工作流程文件添加到存儲庫中的 `.github/workflows/opencode.yml` 中。確保在`model`中設置適當的`env`和所需的API密鑰。 + 將以下工作流程檔案新增到儲存庫中的 `.github/workflows/opencode.yml` 中。確保在 `env` 中設定適當的 `model` 和所需的 API 金鑰。 ```yml title=".github/workflows/opencode.yml" {24,26} name: opencode @@ -73,21 +73,21 @@ opencode github install # github_token: xxxx ``` -3. Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try again later.That’s all we know. +3. **設定 Secrets** - 在您的組織或項目的**設置**中，展開左側的**秘密和變量**，然後選擇**操作**。並添加所需的 API 密鑰。 + 在您的組織或專案的 **Settings** 中，展開左側的 **Secrets and variables**，然後選擇 **Actions**。並新增所需的 API 金鑰。 --- -## 配置 +## 設定 -- `model`：與 opencode 一起使用的模型。採用`provider/model` 格式。這是**必需的**。 -- `agent`: The agent to use.必須是一級代理。如果未找到，則從配置回退到 `default_agent` 或 `"build"`。 -- `share`：是否共享opencode會話。對於公共存儲庫，默認為 **true**。 -- `prompt`：可選的自定義提示以覆蓋默認行為。使用它來自定義 opencode 處理請求的方式。 -- `token`：可選的 GitHub 訪問令牌，用於執行創建評論、提交更改和打開拉取請求等操作。默認情況下，opencode 使用來自 opencode GitHub 應用程式的安裝訪問令牌，因此提交、評論和拉取請求顯示為來自應用程式。 +- `model`：與 opencode 一起使用的模型。採用 `provider/model` 格式。這是**必需的**。 +- `agent`: 使用的代理。必須是主要代理。如果未找到，則從設定退回到 `default_agent` 或 `"build"`。 +- `share`：是否分享 opencode 工作階段。對於公共儲存庫，預設為 **true**。 +- `prompt`：可選的自定義提示以覆寫預設行為。使用它來自定義 opencode 處理請求的方式。 +- `token`：可選的 GitHub 存取權杖，用於執行建立評論、提交變更和打開拉取請求等操作。預設情況下，opencode 使用來自 opencode GitHub 應用程式的安裝存取權杖，因此提交、評論和拉取請求顯示為來自應用程式。 - 或者，您可以使用 GitHub Action 運行程序的[內置`GITHUB_TOKEN`](https://docs.github.com/en/actions/tutorials/authenticate-with-github_token)，而無需安裝 opencode GitHub 應用程式。只需確保在您的工作流程中授予所需的權限： + 或者，您可以使用 GitHub Action Runner 的 [內建 `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 ``` - Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try again later.That’s all we know. + **注意**：使用 `GITHUB_TOKEN` 時，opencode 執行的操作（如提交和評論）將不會觸發其他工作流程。 --- -## 支持的活動 +## 支援的事件 opencode 可以由以下 GitHub 事件觸發： -| 事件類型 | 觸發者 | 詳情 | -| ----------------------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------- | -| `issue_comment` | 對問題或 PR 發表評論 | Mention `/opencode` or `/oc` in your comment. opencode 讀取上下文並可以創建分支、打開 PR 或回复。 | -| `pull_request_review_comment` | 對 PR 中的特定程式碼行進行評論 | 在檢查程式碼時提及`/opencode` 或`/oc`。 opencode receives file path, line numbers, and diff context. | -| `issues` | 問題已打開或已編輯 | 創建或修改問題時自動觸發 opencode。需要 `prompt` 輸入。 | -| `pull_request` | PR 已開啟或已更新 | Automatically trigger opencode when PRs are opened, synchronized, or reopened.對於自動評論很有用。 | -| `schedule` | 基於 Cron 的計劃 | 按計劃運行 opencode。需要 `prompt` 輸入。輸出進入日誌和 PR（沒有可評論的問題）。 | -| `workflow_dispatch` | 從 GitHub UI 手動觸發 | 通過“操作”選項卡按需觸發 opencode。需要 `prompt` 輸入。輸出進入日誌和 PR。 | +| 事件類型 | 觸發條件 | 詳情 | +| ----------------------------- | ------------------------------ | --------------------------------------------------------------------------------------- | +| `issue_comment` | 對問題或 PR 發表評論 | 在評論中提及 `/opencode` 或 `/oc`。 opencode 讀取上下文並可以建立分支、打開 PR 或回覆。 | +| `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 手動觸發 | 透過「Actions」標籤按需觸發 opencode。需要 `prompt` 輸入。輸出進入日誌和 PR。 | -### 時間表示例 +### 排程範例 -按計劃運行 opencode 以執行自動化任務： +按排程執行 opencode 以執行自動化任務： ```yaml title=".github/workflows/opencode-scheduled.yml" name: Scheduled OpenCode Task @@ -150,13 +150,13 @@ jobs: If you find issues worth addressing, open an issue to track them. ``` -For scheduled events, the `prompt` input is **required** since there's no comment to extract instructions from.計劃工作流在沒有用戶上下文的情況下運行以進行權限檢查，因此如果您希望 opencode 創建分支或 PR，工作流必須授予 `contents: write` 和 `pull-requests: write`。 +對於排程事件，`prompt` 輸入是**必需的**，因為沒有註釋可從中提取指令。排程工作流程在沒有使用者上下文的情況下執行以進行權限檢查，因此如果您希望 opencode 建立分支或 PR，工作流程必須授予 `contents: write` 和 `pull-requests: write`。 --- -### 拉取請求示例 +### 拉取請求範例 -打開或更新 PR 時自動審核： +打開或更新 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 將預設審閱拉取請求。 --- -### 問題分類示例 +### 問題分類範例 -自動分類新問題。此示例過濾超過 30 天的帳戶以減少垃圾郵件： +自動分類新問題。此範例過濾超過 30 天的帳號以減少垃圾訊息： ```yaml title=".github/workflows/opencode-triage.yml" name: Issue Triage @@ -246,13 +246,13 @@ jobs: Otherwise, do not comment. ``` -對於 `issues` 事件，`prompt` 輸入是**必需的**，因為沒有註釋可從中提取指令。 +對於 `issues` 事件，`prompt` 輸入是**必需的**，因為沒有評論可從中提取指令。 --- ## 自定義提示 -覆蓋默認提示，為您的工作流程自定義 opencode 的行為。 +覆寫預設提示，為您的工作流程自定義 opencode 的行為。 ```yaml title=".github/workflows/opencode.yml" - uses: anomalyco/opencode/github@latest @@ -265,35 +265,35 @@ jobs: - Suggest improvements ``` -這對於執行與您的項目相關的特定審查標準、編碼標准或重點領域非常有用。 +這對於執行與您的專案相關的特定審閱標準、編碼標準或重點領域非常有用。 --- -## 示例 +## 範例 -以下是如何在 GitHub 中使用 opencode 的一些示例。 +以下是如何在 GitHub 中使用 opencode 的一些範例。 - **解釋一個問題** - 在 GitHub 問題中添加此評論。 + 在 GitHub Issue 中添加此評論。 ``` /opencode explain this issue ``` - opencode 將閱讀整個線程，包括所有評論，並回复並提供清晰的解釋。 + opencode 將閱讀整個討論串，包括所有評論，並回覆並提供清晰的解釋。 - **解決問題** - 在 GitHub 問題中，說： + 在 GitHub Issue 中，說： ``` /opencode fix this ``` - opencode 將創建一個新分支，實施更改，並使用更改打開 PR。 + opencode 將建立一個新分支，實作變更，並使用變更打開 PR。 -- **審查 PR 並進行更改** +- **審閱 PR 並進行變更** 在 GitHub PR 上留下以下評論。 @@ -301,21 +301,21 @@ jobs: Delete the attachment from S3 when the note is removed /oc ``` - Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try again later.That’s all we know. + opencode 將實作請求的變更並將其推送到分支。 - **查看特定程式碼行** - 直接在 PR 的“文件”選項卡中的程式碼行上留下評論。 opencode 自動檢測文件、行號和差異上下文以提供精確的響應。 + 直接在 PR 的「Files」標籤中的程式碼行上留下評論。 opencode 自動檢測檔案、行號和 diff 上下文以提供精確的回應。 ``` [Comment on specific lines in Files tab] /oc add error handling here ``` - Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try again later.That’s all we know. - - 正在審查的確切文件 + opencode 將查看： + - 正在審閱的確切檔案 - 具體程式碼行 - 周圍的 diff 上下文 - - 行號信息 + - 行號資訊 - 這允許更有針對性的請求，而無需手動指定文件路徑或行號。 + 這允許更有針對性的請求，而無需手動指定檔案路徑或行號。 diff --git a/packages/web/src/content/docs/zh-tw/gitlab.mdx b/packages/web/src/content/docs/zh-tw/gitlab.mdx index 3d9c5dace..a96618fd1 100644 --- a/packages/web/src/content/docs/zh-tw/gitlab.mdx +++ b/packages/web/src/content/docs/zh-tw/gitlab.mdx @@ -3,32 +3,32 @@ title: GitLab description: 在 GitLab 問題和合併請求中使用 opencode。 --- -opencode 通過 GitLab CI/CD 管道或與 GitLab Duo 與您的 GitLab 工作流程集成。 +opencode 透過 GitLab CI/CD 管線或與 GitLab Duo 與您的 GitLab 工作流程整合。 -在這兩種情況下，opencode 都將在您的 GitLab 運行器上運行。 +在這兩種情況下，opencode 都將在您的 GitLab Runner 上執行。 --- -## GitLab。 +## GitLab -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)。 +在這裡，我們使用社群建立的 opencode CI/CD 組件 — [nagyv/gitlab-opencode](https://gitlab.com/nagyv/gitlab-opencode)。 --- -### 特徵 +### 功能 -- **每個作業使用自定義配置**：使用自定義配置目錄配置 opencode，例如 `./config/#custom-directory` 以啟用或禁用每個 opencode 調用的功能。 -- Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try again later.That’s all we know. -- **靈活**：CI 組件支持多種輸入來自定義其行為 +- **每個作業使用自定義設定**：使用自定義設定目錄設定 opencode，例如 `./config/#custom-directory` 以啟用或禁用每個 opencode 呼叫的功能。 +- **無狀態**：opencode 的狀態（訊息歷史記錄等）儲存在合併請求評論線程中，使其完全無狀態。 +- **靈活**：CI 組件支援多種輸入來自定義其行為 --- ### 設定 -1. 將 opencode 身份驗證 JSON 作為文件類型 CI 環境變量存儲在 **設置** > **CI/CD** > **變量** 下。確保將它們標記為“屏蔽和隱藏”。 -2. 將以下內容添加到您的 `.gitlab-ci.yml` 文件中。 +1. 將 opencode 身分驗證 JSON 作為檔案類型 CI 環境變數儲存在 **Settings** > **CI/CD** > **Variables** 下。確保將它們標記為「Masked and hidden」。 +2. 將以下內容新增到您的 `.gitlab-ci.yml` 檔案中。 ```yaml title=".gitlab-ci.yml" include: @@ -40,40 +40,40 @@ opencode 在常規 GitLab 管道中工作。您可以將其構建為管道作為 message: "Your prompt here" ``` -有關此組件的更多輸入和用例[查看文檔](https://gitlab.com/explore/catalog/nagyv/gitlab-opencode)。 +有關此組件的更多輸入和使用案例[查看文件](https://gitlab.com/explore/catalog/nagyv/gitlab-opencode)。 --- -## 亞搏體育app二人組 +## GitLab Duo -opencode 與您的 GitLab 工作流程集成。 -在評論中提及`@opencode`，opencode 將在您的 GitLab CI 管道中執行任務。 +opencode 與您的 GitLab 工作流程整合。 +在評論中提及 `@opencode`，opencode 將在您的 GitLab CI 管線中執行任務。 --- -### 特徵 +### 功能 - **分類問題**：要求 opencode 調查問題並向您解釋。 -- **修復和實施**：要求 opencode 修復問題或實施功能。 - 它將創建一個新分支並提出包含更改的合併請求。 -- **安全**：opencode 在您的 GitLab 運行器上運行。 +- **修復和實作**：要求 opencode 修復問題或實作功能。 + 它將建立一個新分支並提出包含變更的合併請求。 +- **安全**：opencode 在您的 GitLab Runner 上執行。 --- ### 設定 -opencode 在您的 GitLab CI/CD 管道中運行，您需要進行以下設置： +opencode 在您的 GitLab CI/CD 管線中執行，您需要進行以下設定： :::tip -查看[**GitLab 文檔**](https://docs.gitlab.com/user/duo_agent_platform/agent_assistant/) 以獲取最新說明。 +查看 [**GitLab 文件**](https://docs.gitlab.com/user/duo_agent_platform/agent_assistant/) 以獲取最新說明。 ::: -1. 配置您的 GitLab 環境 -2. 設置 CI/CD -3. 獲取 AI 模型提供商 API 密鑰 -4. 創建服務帳戶 -5. 配置 CI/CD 變量 -6. 創建一個流配置文件，這是一個示例： +1. 設定您的 GitLab 環境 +2. 設定 CI/CD +3. 取得 AI 模型供應商 API 金鑰 +4. 建立服務帳號 +5. 設定 CI/CD 變數 +6. 建立一個流程設定檔，這是一個範例：
@@ -152,16 +152,16 @@ opencode 在您的 GitLab CI/CD 管道中運行，您需要進行以下設置：
-詳細說明可以參考[GitLab CLI 代理文檔](https://docs.gitlab.com/user/duo_agent_platform/agent_assistant/)。 +詳細說明可以參考 [GitLab CLI 代理文件](https://docs.gitlab.com/user/duo_agent_platform/agent_assistant/)。 --- -### 示例 +### 範例 -以下是如何在 GitLab 中使用 opencode 的一些示例。 +以下是如何在 GitLab 中使用 opencode 的一些範例。 :::tip -您可以配置使用與 `@opencode` 不同的觸發短語。 +您可以設定使用與 `@opencode` 不同的觸發短語。 ::: - **解釋一個問題** @@ -172,7 +172,7 @@ opencode 在您的 GitLab CI/CD 管道中運行，您需要進行以下設置： @opencode explain this issue ``` - opencode 將閱讀該問題並回复並提供清晰的解釋。 + opencode 將閱讀該問題並回覆並提供清晰的解釋。 - **解決問題** @@ -182,9 +182,9 @@ opencode 在您的 GitLab CI/CD 管道中運行，您需要進行以下設置： @opencode fix this ``` - opencode 將創建一個新分支，實施更改，並打開包含更改的合併請求。 + opencode 將建立一個新分支，實作變更，並打開包含變更的合併請求。 -- **審查合併請求** +- **審閱合併請求** 對 GitLab 合併請求留下以下評論。 @@ -192,4 +192,4 @@ opencode 在您的 GitLab CI/CD 管道中運行，您需要進行以下設置： @opencode review this merge request ``` - opencode 將審核合併請求並提供反饋。 + opencode 將審閱合併請求並提供回饋。 diff --git a/packages/web/src/content/docs/zh-tw/ide.mdx b/packages/web/src/content/docs/zh-tw/ide.mdx index d40c71a97..11275318f 100644 --- a/packages/web/src/content/docs/zh-tw/ide.mdx +++ b/packages/web/src/content/docs/zh-tw/ide.mdx @@ -1,48 +1,48 @@ --- title: IDE -description: VS Code、Cursor 和其他 IDE 的 OpenCode 擴展 +description: VS Code、Cursor 和其他 IDE 的 OpenCode 擴充功能 --- -OpenCode 與 VS Code、Cursor 或任何支持 terminal 的 IDE 集成。只需在 terminal 中運行 `opencode` 即可開始。 +OpenCode 與 VS Code、Cursor 或任何支援終端機的 IDE 整合。只需在終端機中執行 `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+Option+K` (Mac) 或`Alt+Ctrl+K` (Linux/Windows) 插入文件引用。例如，`@File#L37-42`。 +- **快速啟動**：使用 `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`。 --- ## 安裝 -要在 VS Code 和 Cursor、Windsurf、VSCodium 等流行分支上安裝 OpenCode： +要在 VS Code 和 Cursor、Windsurf、VSCodium 等流行 Fork 上安裝 OpenCode： 1. 打開 VS Code -2. 打開集成 terminal -3. 運行 `opencode` - 擴展會自動安裝 +2. 打開整合終端機 +3. 執行 `opencode` - 擴充功能會自動安裝 -另一方面，如果您想在從 TUI 運行 `/editor` 或 `/export` 時使用自己的 IDE，則需要設置 `export EDITOR="code --wait"`。 [了解更多](/docs/tui/#editor-setup)。 +另一方面，如果您想在從 TUI 執行 `/editor` 或 `/export` 時使用自己的 IDE，則需要設定 `export EDITOR="code --wait"`。 [了解更多](/docs/tui/#editor-setup)。 --- ### 手動安裝 -在擴展市場中搜索 **OpenCode**，然後單擊 **安裝**。 +在擴充功能市集中搜尋 **OpenCode**，然後單擊 **安裝**。 --- -### 故障排除 +### 疑難排解 -如果擴展無法自動安裝： +如果擴充功能無法自動安裝： -- 確保您在集成 terminal 中運行`opencode`。 +- 確保您在整合終端機中執行 `opencode`。 - 確認您的 IDE 的 CLI 已安裝： - - 對於 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 有權安裝擴展 + - 對於 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 1b5eb76c6..ab22bfb5c 100644 --- a/packages/web/src/content/docs/zh-tw/index.mdx +++ b/packages/web/src/content/docs/zh-tw/index.mdx @@ -1,15 +1,15 @@ --- title: 簡介 -description: 開始使用 opencode。 +description: 開始使用 OpenCode。 --- import { Tabs, TabItem } from "@astrojs/starlight/components" import config from "../../../../config.mjs" export const console = config.console -[**OpenCode**](/) 是一個開源 AI 編碼代理。它可用作基於 terminal 的介面、桌面應用程式或 IDE 擴展。 +[**OpenCode**](/) 是一個開源 AI 程式碼代理。它可用作基於終端機的介面、桌面應用程式或 IDE 擴充功能。 -![具有 opencode 主題的 OpenCode TUI](../../../assets/lander/screenshot.png) +![具有 OpenCode 主題的 OpenCode TUI](../../../assets/lander/screenshot.png) 讓我們開始吧。 @@ -17,27 +17,27 @@ export const console = config.console #### 先決條件 -要在 terminal 中使用 OpenCode，您需要： +要在終端機中使用 OpenCode，您需要： -1. 現代 terminal 模擬器，例如： +1. 現代終端機模擬器，例如： - [WezTerm](https://wezterm.org)，跨平台 - [Alacritty](https://alacritty.org)，跨平台 - [Ghostty](https://ghostty.org)，Linux 和 macOS - [Kitty](https://sw.kovidgoyal.net/kitty/)，Linux 和 macOS -2. 您想要使用的 LLM 提供商的 API 密鑰。 +2. 您想要使用的 LLM 供應商的 API 金鑰。 --- ## 安裝 -安裝 OpenCode 最簡單的方法是通過安裝腳本。 +安裝 OpenCode 最簡單的方法是透過安裝指令碼。 ```bash curl -fsSL https://opencode.ai/install | bash ``` -您還可以使用以下命令安裝它： +您也可以使用以下指令安裝： - **使用 Node.js** @@ -89,17 +89,17 @@ curl -fsSL https://opencode.ai/install | bash #### Windows -:::tip[Recommended: Use WSL] -為了在 Windows 上獲得最佳體驗，我們建議使用[適用於 Linux 的 Windows 子系統 (WSL)](/docs/windows-wsl)。它提供了更好的性能並與 OpenCode 的功能完全兼容。 +:::tip[建議：使用 WSL] +為了在 Windows 上獲得最佳體驗，我們建議使用[適用於 Linux 的 Windows 子系統 (WSL)](/docs/windows-wsl)。它提供了更好的效能並與 OpenCode 的功能完全相容。 ::: -- **使用Chocolatey** +- **使用 Chocolatey** ```bash choco install opencode ``` -- **使用Scoop** +- **使用 Scoop** ```bash scoop install opencode @@ -111,7 +111,7 @@ curl -fsSL https://opencode.ai/install | bash npm install -g opencode-ai ``` -- **使用Mise** +- **使用 Mise** ```bash mise use -g github:anomalyco/opencode @@ -123,29 +123,28 @@ curl -fsSL https://opencode.ai/install | bash docker run -it --rm ghcr.io/anomalyco/opencode ``` -目前正在支持使用 Bun 在 Windows 上安裝 OpenCode。 +目前正在支援使用 Bun 在 Windows 上安裝 OpenCode。 -您還可以從[Releases](https://github.com/anomalyco/opencode/releases) 獲取二進製文件。 +您還可以從 [Releases](https://github.com/anomalyco/opencode/releases) 獲取二進位檔案。 --- -## 配置 +## 設定 -借助 OpenCode，您可以通過配置 API 密鑰來使用任何 LLM 提供商。 +借助 OpenCode，您可以透過設定 API 金鑰來使用任何 LLM 供應商。 -如果您不熟悉使用 LLM 提供商，我們建議使用[OpenCode Zen](/docs/zen)。 -這是經過 OpenCode 測試和驗證的精選模型列表 -團隊。 +如果您不熟悉使用 LLM 供應商，我們建議使用 [OpenCode Zen](/docs/zen)。 +這是經過 OpenCode 團隊測試和驗證的精選模型列表。 -1. 在 TUI 中運行 `/connect` 命令，選擇 opencode，然後前往 [opencode.ai/auth](https://opencode.ai/auth)。 +1. 在 TUI 中執行 `/connect` 指令，選擇 opencode，然後前往 [opencode.ai/auth](https://opencode.ai/auth)。 ```txt /connect ``` -2. 登錄，添加您的帳單詳細信息，然後復制您的 API 密鑰。 +2. 登入，新增您的帳單詳細資訊，然後複製您的 API 金鑰。 -3. 粘貼您的 API 密鑰。 +3. 貼上您的 API 金鑰。 ```txt ┌ API key @@ -154,50 +153,45 @@ curl -fsSL https://opencode.ai/install | bash └ enter ``` -或者，您可以選擇其他提供商之一。 [了解更多](/docs/providers#directory)。 +或者，您可以選擇其他供應商之一。[了解更多](/docs/providers#directory)。 --- ## 初始化 -現在您已經配置了提供商，您可以導航到一個項目 -你想繼續工作。 +現在您已經設定了供應商，您可以導航到一個您想繼續工作的專案。 ```bash cd /path/to/project ``` -並運行 OpenCode。 +並執行 OpenCode。 ```bash opencode ``` -接下來，通過運行以下命令來初始化項目的 OpenCode。 +接下來，透過執行以下指令來初始化專案的 OpenCode。 ```bash frame="none" /init ``` -這將使 OpenCode 分析您的項目並在以下位置創建 `AGENTS.md` 文件 -項目根。 +這將使 OpenCode 分析您的專案並在專案根目錄下建立 `AGENTS.md` 檔案。 :::tip -您應該將項目的 `AGENTS.md` 文件提交到 Git。 +您應該將專案的 `AGENTS.md` 檔案提交到 Git。 ::: -這有助於 OpenCode 理解項目結構和編碼模式 -用過的。 +這有助於 OpenCode 理解專案結構和使用的編碼模式。 --- ## 用法 -您現在已準備好使用 OpenCode 來處理您的項目。請隨意詢問 -任何事物！ +您現在已準備好使用 OpenCode 來處理您的專案。請隨意詢問任何事物！ -如果您不熟悉使用 AI 編碼代理，以下是一些可能會有所幫助的示例 -幫助。 +如果您不熟悉使用 AI 程式碼代理，以下是一些可能會有所幫助的範例。 --- @@ -206,7 +200,7 @@ opencode 您可以用 OpenCode 向您解釋程式碼庫。 :::tip -使用`@`鍵模糊搜索工程中的文件。 +使用`@`鍵模糊搜尋專案中的檔案。 ::: ```txt frame="none" "@packages/functions/src/api/index.ts" @@ -217,14 +211,13 @@ How is authentication handled in @packages/functions/src/api/index.ts --- -### 添加功能 +### 新增功能 -您可以用 OpenCode 向您的項目添加新功能。不過我們首先建議要求它制定一個計劃。 +您可以用 OpenCode 向您的專案新增新功能。不過我們首先建議要求它制定一個計畫。 -1. **制定計劃** +1. **制定計畫** - OpenCode 有一個*計劃模式*，該模式禁用其進行更改和 - 相反，建議*如何*實現該功能。 + OpenCode 有一個*計畫模式*，該模式禁用其進行變更，而是建議*如何*實作該功能。 使用 **Tab** 鍵切換到它。您會在右下角看到一個指示符。 @@ -240,17 +233,15 @@ 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 提供足夠的詳細信息以了解您想要的內容。它有幫助 - 就像與團隊中的初級開發人員交談一樣與它交談。 + 您需要為 OpenCode 提供足夠的詳細資訊以了解您想要的內容。這有幫助，就像與團隊中的初級開發人員交談一樣與它交談。 :::tip - 為 OpenCode 提供大量上下文和示例，以幫助其理解您的內容 - 想。 + 為 OpenCode 提供大量上下文和範例，以幫助其理解您的想法。 ::: -2. **迭代計劃** +2. **迭代計畫** - 一旦它為您提供了計劃，您就可以提供反饋或添加更多詳細信息。 + 一旦它為您提供了計畫，您可以提供回饋或新增更多詳細資訊。 ```txt frame="none" We'd like to design this new screen using a design I've used before. @@ -258,16 +249,14 @@ How is authentication handled in @packages/functions/src/api/index.ts ``` :::tip - 將圖像拖放到 terminal 中以將其添加到提示中。 + 將影像拖放到終端機中以將其新增到提示中。 ::: - OpenCode 可以掃描您提供的任何圖像並將其添加到提示中。你可以 - 通過將圖像拖放到 terminal 中來完成此操作。 + OpenCode 可以掃描您提供的任何影像並將其新增到提示中。您可以透過將影像拖放到終端機中來完成此操作。 -3. **構建功能** +3. **建置功能** - 一旦您對計劃感到滿意，請切換回*構建模式* - 再次按 **Tab** 鍵。 + 一旦您對計畫感到滿意，請切換回*建置模式*，再次按 **Tab** 鍵。 ```bash frame="none" @@ -283,8 +272,7 @@ How is authentication handled in @packages/functions/src/api/index.ts ### 做出改變 -對於更直接的更改，您可以要求 OpenCode 直接構建它 -無需先審查計劃。 +對於更直接的變更，您可以要求 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,28 +280,25 @@ handled in the /notes route in @packages/functions/src/notes.ts and implement the same logic in @packages/functions/src/settings.ts ``` -您需要確保提供大量詳細信息，以便 OpenCode 做出正確的決定 -變化。 +您需要確保提供大量詳細資訊，以便 OpenCode 做出正確的變更。 --- -### 撤消更改 +### 撤銷變更 -假設您要求 OpenCode 進行一些更改。 +假設您要求 OpenCode 進行一些變更。 ```txt frame="none" "@packages/functions/src/api/index.ts" Can you refactor the function in @packages/functions/src/api/index.ts? ``` -但你意識到這不是你想要的。您**可以撤消**更改 -使用 `/undo` 命令。 +但你意識到這不是你想要的。您**可以撤銷**變更，使用 `/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? @@ -322,10 +307,10 @@ Can you refactor the function in @packages/functions/src/api/index.ts? 從這裡您可以調整提示並要求 OpenCode 重試。 :::tip -您可以多次運行 `/undo` 以撤消多項更改。 +您可以多次執行 `/undo` 以撤銷多項變更。 ::: -或者您**可以使用 `/redo` 命令重做**更改。 +或者您**可以使用 `/redo` 指令重做**變更。 ```bash frame="none" /redo @@ -335,25 +320,24 @@ Can you refactor the function in @packages/functions/src/api/index.ts? ## 分享 -您與 OpenCode 的對話可以[與您的 -團隊](/docs/share)。 +您與 OpenCode 的對話可以[與您的團隊分享](/docs/share)。 ```bash frame="none" /share ``` -這將創建當前對話的連結並將其複製到剪貼板。 +這將建立目前對話的連結並將其複製到剪貼簿。 :::note -默認情況下不共享對話。 +預設情況下不分享對話。 ::: -這是帶有 OpenCode 的[示例對話](https://opencode.ai/s/4XP1fce5)。 +這是帶有 OpenCode 的[範例對話](https://opencode.ai/s/4XP1fce5)。 --- -## 定制 +## 自訂 就是這樣！您現在已經是使用 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-tw/keybinds.mdx b/packages/web/src/content/docs/zh-tw/keybinds.mdx index 00dcc42a0..de3d6882f 100644 --- a/packages/web/src/content/docs/zh-tw/keybinds.mdx +++ b/packages/web/src/content/docs/zh-tw/keybinds.mdx @@ -3,7 +3,7 @@ title: 按鍵綁定 description: 自定義您的按鍵綁定。 --- -opencode 有一個按鍵綁定列表，您可以通過 opencode 配置進行自定義。 +opencode 有一個按鍵綁定列表，您可以透過 opencode 設定進行自定義。 ```json title="opencode.json" { @@ -105,19 +105,19 @@ opencode 有一個按鍵綁定列表，您可以通過 opencode 配置進行自 --- -## 領袖鑰匙 +## Leader 鍵 -opencode 對大多數按鍵綁定使用 `leader` 鍵。這可以避免terminal 中的衝突。 +opencode 對大多數按鍵綁定使用 `leader` 鍵。這可以避免終端機中的衝突。 -默認情況下，`ctrl+x` 是主鍵，大多數操作要求您先按主鍵，然後再按快捷鍵。例如，要開始新會話，請先按`ctrl+x`，然後按`n`。 +預設情況下，`ctrl+x` 是 Leader 鍵，大多數操作要求您先按 Leader 鍵，然後再按快速鍵。例如，要開始新工作階段，請先按 `ctrl+x`，然後按 `n`。 -您不需要為鍵綁定使用主鍵，但我們建議您這樣做。 +您不需要為鍵綁定使用 Leader 鍵，但我們建議您這樣做。 --- ## 禁用按鍵綁定 -您可以通過將鍵添加到您的配置中並使用值“none”來禁用鍵綁定。 +您可以透過將鍵添加到您的設定中並使用值「none」來禁用鍵綁定。 ```json title="opencode.json" { @@ -130,41 +130,41 @@ opencode 對大多數按鍵綁定使用 `leader` 鍵。這可以避免terminal --- -## 桌面提示快捷方式 +## 桌面提示快速鍵 -opencode 桌面應用程式提示輸入支持常見的 Readline/Emacs 風格的文本編輯快捷方式。這些是內置的，目前無法通過`opencode.json`進行配置。 +opencode 桌面應用程式提示輸入支援常見的 Readline/Emacs 風格的文字編輯快速鍵。這些是內建的，目前無法透過 `opencode.json` 進行設定。 -| 快捷方式 | 行動 | +| 快速鍵 | 動作 | | -------- | ------------------------- | | `ctrl+a` | 移至當前行開頭 | | `ctrl+e` | 移至當前行尾 | -| `ctrl+b` | 將光標向後移動一個字符 | -| `ctrl+f` | 將光標向前移動一個字符 | -| `alt+b` | 將光標向後移動一個字 | -| `alt+f` | 將光標向前移動一個字 | -| `ctrl+d` | 刪除光標下的字符 | -| `ctrl+k` | 殺到行尾 | -| `ctrl+u` | 殺至行首 | -| `ctrl+w` | 刪除前一個單詞 | -| `alt+d` | 殺死下一個詞 | -| `ctrl+t` | 轉置字符 | -| `ctrl+g` | 取消彈出窗口/中止運行響應 | +| `ctrl+b` | 將游標向後移動一個字元 | +| `ctrl+f` | 將游標向前移動一個字元 | +| `alt+b` | 將游標向後移動一個字 | +| `alt+f` | 將游標向前移動一個字 | +| `ctrl+d` | 刪除游標下的字元 | +| `ctrl+k` | 刪除至行尾 | +| `ctrl+u` | 刪除至行首 | +| `ctrl+w` | 刪除前一個單字 | +| `alt+d` | 刪除下一個單字 | +| `ctrl+t` | 調換字元 | +| `ctrl+g` | 取消彈出視窗/中止執行回應 | --- ## Shift+Enter -默認情況下，某些terminal不發送帶有 Enter 的修飾鍵。您可能需要將terminal配置為發送 `Shift+Enter` 作為轉義序列。 +預設情況下，某些終端機不發送帶有 Enter 的輔助鍵。您可能需要將終端機設定為發送 `Shift+Enter` 作為跳脫序列。 -### Windows terminal +### 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 terminal或打開新選項卡。 +儲存檔案並重新啟動 Windows Terminal 或打開新分頁。 diff --git a/packages/web/src/content/docs/zh-tw/lsp.mdx b/packages/web/src/content/docs/zh-tw/lsp.mdx index 5feea4db0..54bc37c26 100644 --- a/packages/web/src/content/docs/zh-tw/lsp.mdx +++ b/packages/web/src/content/docs/zh-tw/lsp.mdx @@ -1,71 +1,71 @@ --- -title: LSP服務器 -description: opencode 與您的 LSP 服務器集成。 +title: LSP 伺服器 +description: opencode 與您的 LSP 伺服器整合。 --- -opencode 與您的語言服務器協議 (LSP) 集成，以幫助 LLM 與您的程式碼庫交互。它使用診斷向LLM提供反饋。 +opencode 與您的語言伺服器協定 (LSP) 整合，以幫助 LLM 與您的程式碼庫互動。它使用診斷向 LLM 提供回饋。 --- ## 內建 -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` 命令可用 | -| ocx林特 | .ts、.tsx、.js、.jsx、.mjs、.cjs、.mts、.cts、.vue、.astro、.svelte | `oxlint` 項目中的依賴項 | -| php intelephense | 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 伺服器 | 副檔名 | 要求 | +| ------------------ | ------------------------------------------------------------------- | ------------------------------------------------ | +| 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 專案 | +| nil | .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-analyzer | .rs | `rust-analyzer` 指令可用 | +| sourcekit-lsp | .swift、.objc、.objcpp | `swift` 已安裝（`xcode` 在 macOS 上） | +| svelte | .svelte | Svelte 專案的自動安裝 | +| terraform-ls | .tf、.tfvars | 從 GitHub Releases 自動安裝 | +| tinymist | .typ、.typc | 從 GitHub Releases 自動安裝 | +| 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 服務器。 +1. 根據所有啟用的 LSP 伺服器檢查檔案副檔名。 +2. 如果尚未執行，則啟動相應的 LSP 伺服器。 --- -## 配置 +## 設定 -您可以通過 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服務器的初始化選項 | +| 屬性 | 類型 | 描述 | +| ---------------- | ------ | ----------------------------------- | +| `disabled` | 布林值 | 將其設定為 `true` 以禁用 LSP 伺服器 | +| `command` | 字串[] | 啟動 LSP 伺服器的指令 | +| `extensions` | 字串[] | 此 LSP 伺服器應處理的檔案副檔名 | +| `env` | 物件 | 啟動伺服器時設定的環境變數 | +| `initialization` | 物件 | 發送到 LSP 伺服器的初始化選項 | 讓我們看一些例子。 --- -### 環境變量 +### 環境變數 -啟動LSP服務器時使用`env`屬性設置環境變量： +啟動 LSP 伺服器時使用 `env` 屬性設定環境變數： ```json title="opencode.json" {5-7} { @@ -109,7 +109,7 @@ opencode 附帶了多種適用於流行語言的內置 LSP 服務器： ### 初始化選項 -使用`initialization` 屬性將初始化選項傳遞給LSP 服務器。這些是在 LSP `initialize` 請求期間發送的服務器特定設置： +使用 `initialization` 屬性將初始化選項傳遞給 LSP 伺服器。這些是在 LSP `initialize` 請求期間發送的伺服器特定設定： ```json title="opencode.json" {5-9} { @@ -127,14 +127,14 @@ opencode 附帶了多種適用於流行語言的內置 LSP 服務器： ``` :::note -初始化選項因 LSP 服務器而異。檢查 LSP 服務器的文檔以獲取可用選項。 +初始化選項因 LSP 伺服器而異。檢查 LSP 伺服器的文件以獲取可用選項。 ::: --- -### 禁用LSP服務器 +### 禁用 LSP 伺服器 -要全局禁用**所有** 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 服務器 +### 自定義 LSP 伺服器 -您可以通過指定命令和文件擴展名來添加自定義 LSP 服務器： +您可以透過指定指令和檔案副檔名來添加自定義 LSP 伺服器： ```json title="opencode.json" {4-7} { @@ -176,13 +176,13 @@ opencode 附帶了多種適用於流行語言的內置 LSP 服務器： --- -## 附加信息 +## 附加資訊 -### PHP 英特爾芬斯 +### PHP Intelephense -PHP Intelephense 通過許可證密鑰提供高級功能。您可以通過將（僅）密鑰放入位於以下位置的文本文件中來提供許可證密鑰： +PHP Intelephense 透過授權金鑰提供高級功能。您可以透過將（僅）金鑰放入位於以下位置的文字檔案中來提供授權金鑰： - 在 macOS/Linux 上：`$HOME/intelephense/license.txt` - 在 Windows 上：`%USERPROFILE%/intelephense/license.txt` -該文件應僅包含許可證密鑰，不包含其他內容。 +該檔案應僅包含授權金鑰，不包含其他內容。 diff --git a/packages/web/src/content/docs/zh-tw/mcp-servers.mdx b/packages/web/src/content/docs/zh-tw/mcp-servers.mdx index cad4ff031..829e696e9 100644 --- a/packages/web/src/content/docs/zh-tw/mcp-servers.mdx +++ b/packages/web/src/content/docs/zh-tw/mcp-servers.mdx @@ -1,29 +1,29 @@ --- -title: MCP服務器 -description: 添加本地和遠程 MCP 工具。 +title: MCP 伺服器 +description: 添加本地和遠端 MCP 工具。 --- -您可以使用“模型上下文協議”或 MCP 將外部工具添加到 opencode。 opencode 支持本地和遠程服務器。 +您可以使用「模型上下文協定」或 MCP 將外部工具添加到 opencode。 opencode 支援本地和遠端伺服器。 -添加後，MCP 工具將自動與內置工具一起供LLM使用。 +添加後，MCP 工具將自動與內建工具一起供 LLM 使用。 --- #### 注意事項 -當您使用 MCP 服務器時，它會添加到上下文中。如果您有很多工具，這會很快增加。因此，我們建議您謹慎選擇使用哪些 MCP 服務器。 +當您使用 MCP 伺服器時，它會添加到上下文中。如果您有很多工具，這會很快增加。因此，我們建議您謹慎選擇使用哪些 MCP 伺服器。 :::tip -MCP 服務器會添加到您的上下文中，因此您需要小心啟用哪些服務器。 +MCP 伺服器會添加到您的上下文中，因此您需要小心啟用哪些伺服器。 ::: -某些 MCP 服務器（例如 GitHub MCP 服務器）往往會添加大量令牌，並且很容易超出上下文限制。 +某些 MCP 伺服器（例如 GitHub MCP 伺服器）往往會添加大量 tokens，並且很容易超出上下文限制。 --- -## 使能夠 +## 啟用 -您可以在`mcp` 下的[opencode配置](https://opencode.ai/docs/config/) 中定義MCP 服務器。為每個 MCP 添加唯一的名稱。當提示 LLM 時，您可以通過名稱引用該 MCP。 +您可以在 `mcp` 下的 [opencode 設定](https://opencode.ai/docs/config/) 中定義 MCP 伺服器。為每個 MCP 添加唯一的名稱。當提示 LLM 時，您可以透過名稱引用該 MCP。 ```jsonc title="opencode.jsonc" {6} { @@ -40,15 +40,15 @@ MCP 服務器會添加到您的上下文中，因此您需要小心啟用哪些 } ``` -您還可以通過將`enabled` 設置為`false` 來禁用服務器。如果您想暫時禁用服務器而不將其從配置中刪除，這非常有用。 +您還可以透過將 `enabled` 設定為 `false` 來禁用伺服器。如果您想暫時禁用伺服器而不將其從設定中刪除，這非常有用。 --- -### 覆蓋遠程默認值 +### 覆寫遠端預設值 -組織可以通過其 `.well-known/opencode` 端點提供默認 MCP 服務器。這些服務器可能默認被禁用，允許用戶選擇他們需要的服務器。 +組織可以透過其 `.well-known/opencode` 端點提供預設 MCP 伺服器。這些伺服器可能預設被禁用，允許使用者選擇他們需要的伺服器。 -要從組織的遠程配置啟用特定服務器，請使用 `enabled: true` 將其添加到本地配置： +要從組織的遠端設定啟用特定伺服器，請使用 `enabled: true` 將其添加到本地設定： ```json title="opencode.json" { @@ -63,13 +63,13 @@ MCP 服務器會添加到您的上下文中，因此您需要小心啟用哪些 } ``` -您的本地配置值會覆蓋遠程默認值。有關更多詳細信息，請參閱[配置優先級](/docs/config#precedence-order)。 +您的本地設定值會覆寫遠端預設值。有關更多詳細資訊，請參閱 [設定優先級](/docs/config#precedence-order)。 --- -## 當地的 +## 本地 -使用`type` 將本地MCP 服務器添加到MCP 對像中的`"local"`。 +使用 `type` 將本地 MCP 伺服器添加到 MCP 物件中的 `"local"`。 ```jsonc title="opencode.jsonc" {15} { @@ -88,9 +88,9 @@ MCP 服務器會添加到您的上下文中，因此您需要小心啟用哪些 } ``` -該命令是本地 MCP 服務器的啟動方式。您還可以傳入環境變量列表。 +該指令是本地 MCP 伺服器的啟動方式。您還可以傳入環境變數列表。 -例如，以下是添加測試 [`@modelcontextprotocol/server-everything`](https://www.npmjs.com/package/@modelcontextprotocol/server-everything) MCP 服務器的方法。 +例如，以下是添加測試 [`@modelcontextprotocol/server-everything`](https://www.npmjs.com/package/@modelcontextprotocol/server-everything) MCP 伺服器的方法。 ```jsonc title="opencode.jsonc" { @@ -114,21 +114,21 @@ use the mcp_everything tool to add the number 3 and 4 #### 選項 -以下是配置本地 MCP 服務器的所有選項。 +以下是設定本地 MCP 伺服器的所有選項。 | 選項 | 類型 | 必填 | 描述 | | ------------- | ------ | ---- | ------------------------------------------------------------------ | -| `type` | 字符串 | 是 | MCP 服務器連接類型，必須是`"local"`。 | -| `command` | 數組 | 是 | 運行 MCP 服務器的命令和參數。 | -| `environment` | 對象 | | 運行服務器時設置的環境變量。 | -| `enabled` | 布爾 | | 在啟動時啟用或禁用 MCP 服務器。 | -| `timeout` | 數量 | | 從 MCP 服務器獲取工具的超時（以毫秒為單位）。默認為 5000（5 秒）。 | +| `type` | 字串 | 是 | MCP 伺服器連接類型，必須是 `"local"`。 | +| `command` | 陣列 | 是 | 執行 MCP 伺服器的指令和參數。 | +| `environment` | 物件 | | 執行伺服器時設定的環境變數。 | +| `enabled` | 布林值 | | 在啟動時啟用或禁用 MCP 伺服器。 | +| `timeout` | 數量 | | 從 MCP 伺服器獲取工具的超時（以毫秒為單位）。預設為 5000（5 秒）。 | --- -## 偏僻的 +## 遠端 -通過將`type` 設置為`"remote"` 添加遠程MCP 服務器。 +透過將 `type` 設定為 `"remote"` 添加遠端 MCP 伺服器。 ```json title="opencode.json" { @@ -146,7 +146,7 @@ use the mcp_everything tool to add the number 3 and 4 } ``` -`url` 是遠程 MCP 服務器的 URL，使用 `headers` 選項您可以傳入標頭列表。 +`url` 是遠端 MCP 伺服器的 URL，使用 `headers` 選項您可以傳入標頭列表。 --- @@ -154,28 +154,28 @@ use the mcp_everything tool to add the number 3 and 4 | 選項 | 類型 | 必填 | 描述 | | --------- | ------ | ---- | ------------------------------------------------------------------ | -| `type` | 字符串 | 是 | MCP 服務器連接類型，必須是`"remote"`。 | -| `url` | 字符串 | 是 | 遠程 MCP 服務器的 URL。 | -| `enabled` | 布爾 | | 在啟動時啟用或禁用 MCP 服務器。 | -| `headers` | 對象 | | 隨請求一起發送的標頭。 | -| `oauth` | 對象 | | OAuth 身份驗證配置。請參閱下面的[開放認證](#oauth) 部分。 | -| `timeout` | 數量 | | 從 MCP 服務器獲取工具的超時（以毫秒為單位）。默認為 5000（5 秒）。 | +| `type` | 字串 | 是 | MCP 伺服器連接類型，必須是 `"remote"`。 | +| `url` | 字串 | 是 | 遠端 MCP 伺服器的 URL。 | +| `enabled` | 布林值 | | 在啟動時啟用或禁用 MCP 伺服器。 | +| `headers` | 物件 | | 隨請求一起發送的標頭。 | +| `oauth` | 物件 | | OAuth 身分驗證設定。請參閱下面的 [OAuth](#oauth) 部分。 | +| `timeout` | 數量 | | 從 MCP 伺服器獲取工具的超時（以毫秒為單位）。預設為 5000（5 秒）。 | --- -## 開放認證 +## OAuth -opencode 自動處理遠程 MCP 服務器的 OAuth 身份驗證。當服務器需要身份驗證時，opencode 將： +opencode 自動處理遠端 MCP 伺服器的 OAuth 身分驗證。當伺服器需要身分驗證時，opencode 將： -1. 檢測 401 響應並啟動 OAuth 流程 -2. 如果服務器支持，請使用**動態客戶端註冊 (RFC 7591)** -3. 安全地存儲令牌以供將來的請求 +1. 檢測 401 回應並啟動 OAuth 流程 +2. 如果伺服器支援，請使用**動態客戶端註冊 (RFC 7591)** +3. 安全地儲存權杖以供將來的請求 --- -### 自動的 +### 自動 -對於大多數支持 OAuth 的 MCP 服務器，不需要特殊配置。只需配置遠程服務器： +對於大多數支援 OAuth 的 MCP 伺服器，不需要特殊設定。只需設定遠端伺服器： ```json title="opencode.json" { @@ -189,13 +189,13 @@ opencode 自動處理遠程 MCP 服務器的 OAuth 身份驗證。當服務器 } ``` -如果服務器需要身份驗證，opencode 將在您第一次嘗試使用它時提示您進行身份驗證。如果沒有，您可以使用 `opencode mcp auth `[手動觸發流量](#authenticating)。 +如果伺服器需要身分驗證，opencode 將在您第一次嘗試使用它時提示您進行身分驗證。如果沒有，您可以使用 `opencode mcp auth ` [手動觸發流程](#authenticating)。 --- -### 預登記 +### 預先註冊 -如果您有來自 MCP 服務器提供商的客戶端憑據，則可以配置它們： +如果您有來自 MCP 伺服器供應商的客戶端憑證，則可以設定它們： ```json title="opencode.json" {7-11} { @@ -216,35 +216,35 @@ opencode 自動處理遠程 MCP 服務器的 OAuth 身份驗證。當服務器 --- -### 正在驗證 +### 進行身分驗證 -您可以手動觸發身份驗證或管理憑據。 +您可以手動觸發身分驗證或管理憑證。 -使用特定 MCP 服務器進行身份驗證： +使用特定 MCP 伺服器進行身分驗證： ```bash opencode mcp auth my-oauth-server ``` -列出所有 MCP 服務器及其身份驗證狀態： +列出所有 MCP 伺服器及其身分驗證狀態： ```bash opencode mcp list ``` -刪除存儲的憑據： +刪除儲存的憑證： ```bash opencode mcp logout my-oauth-server ``` -`mcp auth` 命令將打開您的瀏覽器進行授權。授權後，opencode 會將令牌安全地存儲在`~/.local/share/opencode/mcp-auth.json` 中。 +`mcp auth` 指令將打開您的瀏覽器進行授權。授權後，opencode 會將權杖安全地儲存在 `~/.local/share/opencode/mcp-auth.json` 中。 --- #### 禁用 OAuth -如果要禁用服務器的自動 OAuth（例如，對於使用 API 密鑰的服務器），請將 `oauth` 設置為 `false`： +如果要禁用伺服器的自動 OAuth（例如，對於使用 API 金鑰的伺服器），請將 `oauth` 設定為 `false`： ```json title="opencode.json" {7} { @@ -268,14 +268,14 @@ opencode mcp logout my-oauth-server | 選項 | 類型 | 描述 | | -------------- | --------------- | --------------------------------------------------- | -| `oauth` | Object \| false | OAuth 配置對象，或 `false` 以禁用 OAuth 自動檢測。 | +| `oauth` | Object \| false | OAuth 設定物件，或 `false` 以禁用 OAuth 自動檢測。 | | `clientId` | String | OAuth 客戶端 ID。如果未提供，將嘗試動態客戶端註冊。 | -| `clientSecret` | String | OAuth 客戶端密鑰（如果授權服務器需要）。 | +| `clientSecret` | String | OAuth 客戶端密鑰（如果授權伺服器需要）。 | | `scope` | String | 授權期間請求的 OAuth 範圍。 | #### 偵錯 -如果遠程 MCP 服務器無法進行身份驗證，您可以通過以下方式診斷問題： +如果遠端 MCP 伺服器無法進行身分驗證，您可以透過以下方式診斷問題： ```bash # View auth status for all OAuth-capable servers @@ -285,19 +285,19 @@ opencode mcp auth list opencode mcp debug my-oauth-server ``` -`mcp debug` 命令顯示當前身份驗證狀態、測試 HTTP 連接並嘗試 OAuth 發現流程。 +`mcp debug` 指令顯示當前身分驗證狀態、測試 HTTP 連接並嘗試 OAuth 發現流程。 --- ## 管理 -您的 MCP 可作為 opencode 中的工具以及內置工具使用。因此，您可以像任何其他工具一樣通過 opencode 配置來管理它們。 +您的 MCP 可作為 opencode 中的工具以及內建工具使用。因此，您可以像任何其他工具一樣透過 opencode 設定來管理它們。 --- -### 全球的 +### 全域 -這意味著您可以全局啟用或禁用它們。 +這意味著您可以全域啟用或禁用它們。 ```json title="opencode.json" {14} { @@ -318,7 +318,7 @@ opencode mcp debug my-oauth-server } ``` -我們還可以使用 glob 模式來禁用所有匹配的 MCP。 +我們也可以使用 glob 模式來禁用所有匹配的 MCP。 ```json title="opencode.json" {14} { @@ -343,12 +343,12 @@ opencode mcp debug my-oauth-server --- -### 每個代理人 +### 每個代理 -如果您有大量 MCP 服務器，您可能只想為每個代理啟用它們並全局禁用它們。為此： +如果您有大量 MCP 伺服器，您可能只想為每個代理啟用它們並全域禁用它們。為此： 1. 全局禁用它作為工具。 -2. 在您的[代理配置](/docs/agents#tools) 中，啟用MCP 服務器作為工具。 +2. 在您的 [代理設定](/docs/agents#tools) 中，啟用 MCP 伺服器作為工具。 ```json title="opencode.json" {11, 14-18} { @@ -375,16 +375,16 @@ opencode mcp debug my-oauth-server --- -#### 全局模式 +#### Glob 模式 -glob 模式使用簡單的正則表達式 globbing 模式： +glob 模式使用簡單的正規表示式 globbing 模式： -- `*` 匹配零個或多個任意字符（例如，`"my-mcp*"` 匹配 `my-mcp_search`、`my-mcp_list` 等） -- `?` 恰好匹配一個字符 -- 所有其他字符均按字面意思匹配 +- `*` 匹配零個或多個任意字元（例如，`"my-mcp*"` 匹配 `my-mcp_search`、`my-mcp_list` 等） +- `?` 恰好匹配一個字元 +- 所有其他字元均按字面意思匹配 :::note -MCP 服務器工具以服務器名稱作為前綴進行註冊，因此要禁用服務器的所有工具，只需使用： +MCP 伺服器工具以伺服器名稱作為前綴進行註冊，因此要禁用伺服器的所有工具，只需使用： ``` "mymcpservername_*": false @@ -394,15 +394,15 @@ MCP 服務器工具以服務器名稱作為前綴進行註冊，因此要禁用 --- -## 示例 +## 範例 -以下是一些常見 MCP 服務器的示例。如果您想記錄其他服務器，您可以提交 PR。 +以下是一些常見 MCP 伺服器的範例。如果您想記錄其他伺服器，您可以提交 PR。 --- -### 哨兵 +### Sentry -添加 [哨兵 MCP 服務器](https://mcp.sentry.dev) 以與您的 Sentry 項目和問題進行交互。 +添加 [Sentry MCP 伺服器](https://mcp.sentry.dev) 以與您的 Sentry 專案和問題進行互動。 ```json title="opencode.json" {4-8} { @@ -417,15 +417,15 @@ MCP 服務器工具以服務器名稱作為前綴進行註冊，因此要禁用 } ``` -添加配置後，使用Sentry進行身份驗證： +添加設定後，使用 Sentry 進行身分驗證： ```bash opencode mcp auth sentry ``` -這將打開一個瀏覽器窗口以完成 OAuth 流程並將 opencode 連接到您的 Sentry 帳戶。 +這將打開一個瀏覽器視窗以完成 OAuth 流程並將 opencode 連接到您的 Sentry 帳號。 -通過身份驗證後，您可以在提示中使用 Sentry 工具來查詢問題、項目和錯誤數據。 +通過身分驗證後，您可以在提示中使用 Sentry 工具來查詢問題、專案和錯誤資料。 ```txt "use sentry" Show me the latest unresolved issues in my project. use sentry @@ -433,9 +433,9 @@ Show me the latest unresolved issues in my project. use sentry --- -### 背景7 +### Context7 -添加[Context7 MCP 服務器](https://github.com/upstash/context7) 以搜索文檔。 +添加 [Context7 MCP 伺服器](https://github.com/upstash/context7) 以搜尋文件。 ```json title="opencode.json" {4-7} { @@ -449,7 +449,7 @@ Show me the latest unresolved issues in my project. use sentry } ``` -如果您註冊了免費帳戶，則可以使用 API 密鑰並獲得更高的速率限制。 +如果您註冊了免費帳號，則可以使用 API 金鑰並獲得更高的速率限制。 ```json title="opencode.json" {7-9} { @@ -466,15 +466,15 @@ Show me the latest unresolved issues in my project. use sentry } ``` -這裡我們假設您設置了 `CONTEXT7_API_KEY` 環境變量。 +這裡我們假設您設定了 `CONTEXT7_API_KEY` 環境變數。 -將 `use context7` 添加到提示中以使用 Context7 MCP 服務器。 +將 `use context7` 添加到提示中以使用 Context7 MCP 伺服器。 ```txt "use context7" Configure a Cloudflare Worker script to cache JSON API responses for five minutes. use context7 ``` -或者，您可以將類似的內容添加到您的[代理.md](/docs/rules/)。 +或者，您可以將類似的內容添加到您的 [AGENTS.md](/docs/rules/)。 ```md title="AGENTS.md" When you need to search docs, use `context7` tools. @@ -484,7 +484,7 @@ When you need to search docs, use `context7` tools. ### Vercel 的 Grep -添加 [Vercel 的 Grep](https://grep.app) MCP 服務器以搜索 GitHub 上的程式碼片段。 +添加 [Vercel 的 Grep](https://grep.app) MCP 伺服器以搜尋 GitHub 上的程式碼片段。 ```json title="opencode.json" {4-7} { @@ -498,13 +498,13 @@ When you need to search docs, use `context7` tools. } ``` -由於我們將 MCP 服務器命名為 `gh_grep`，因此您可以將 `use the gh_grep tool` 添加到提示中以使代理使用它。 +由於我們將 MCP 伺服器命名為 `gh_grep`，因此您可以將 `use the gh_grep tool` 添加到提示中以使代理使用它。 ```txt "use the gh_grep tool" What's the right way to set a custom domain in an SST Astro component? use the gh_grep tool ``` -或者，您可以將類似的內容添加到您的[代理.md](/docs/rules/)。 +或者，您可以將類似的內容添加到您的 [AGENTS.md](/docs/rules/)。 ```md title="AGENTS.md" If you are unsure how to do something, use `gh_grep` to search code examples from GitHub. diff --git a/packages/web/src/content/docs/zh-tw/models.mdx b/packages/web/src/content/docs/zh-tw/models.mdx index 09fdb7c72..082f8ba4d 100644 --- a/packages/web/src/content/docs/zh-tw/models.mdx +++ b/packages/web/src/content/docs/zh-tw/models.mdx @@ -1,23 +1,23 @@ --- -title: 型號 -description: 配置LLM提供者和模型。 +title: 模型 +description: 配置 LLM 供應商和模型。 --- -OpenCode 使用[AI SDK](https://ai-sdk.dev/) 和[Models.dev](https://models.dev) 來支持**75+ LLM 提供商**，並且它支持運行本地模型。 +OpenCode 使用 [AI SDK](https://ai-sdk.dev/) 和 [Models.dev](https://models.dev) 來支援 **75+ LLM 供應商**，並且它支援執行本地模型。 --- ## 供應商 -默認情況下會預加載大多數流行的提供商。如果您已通過 `/connect` 命令添加了提供商的憑據，那麼它們將在您啟動 OpenCode 時可用。 +預設情況下會預先載入大多數流行的供應商。如果您已透過 `/connect` 指令添加了供應商的憑證，那麼它們將在您啟動 OpenCode 時可用。 -了解有關[提供者](/docs/providers) 的更多信息。 +了解有關 [供應商](/docs/providers) 的更多資訊。 --- -## 選擇型號 +## 選擇模型 -配置完提供商後，您可以通過輸入以下內容來選擇您想要的型號： +配置完供應商後，您可以透過輸入以下內容來選擇您想要的模型： ```bash frame="none" /models @@ -25,15 +25,15 @@ OpenCode 使用[AI SDK](https://ai-sdk.dev/) 和[Models.dev](https://models.dev) --- -## 推薦型號 +## 推薦模型 -那裡有很多型號，每週都會有新型號問世。 +那裡有很多模型，每週都會有新模型問世。 :::tip 考慮使用我們推薦的模型之一。 ::: -然而，既擅長生成程式碼又擅長工具調用的只有少數。 +然而，既擅長生成程式碼又擅長工具呼叫的只有少數。 以下是與 OpenCode 配合良好的幾個模型，排名不分先後。 （這不是詳盡的列表，也不一定是最新的）： @@ -46,9 +46,9 @@ OpenCode 使用[AI SDK](https://ai-sdk.dev/) 和[Models.dev](https://models.dev) --- -## 設置默認值 +## 設定預設值 -要將其中之一設置為默認模型，您可以在您的 +要將其中之一設定為預設模型，您可以在您的 OpenCode 配置。 ```json title="opencode.json" {3} @@ -58,15 +58,15 @@ OpenCode 配置。 } ``` -這裡完整的 ID 是`provider_id/model_id`。例如，如果您使用 [OpenCode Zen](/docs/zen)，則您將使用 `opencode/gpt-5.1-codex` 來表示 GPT 5.1 Codex。 +這裡完整的 ID 是 `provider_id/model_id`。例如，如果您使用 [OpenCode Zen](/docs/zen)，則您將使用 `opencode/gpt-5.1-codex` 來表示 GPT 5.1 Codex。 -如果您配置了[定制提供商](/docs/providers#custom)，則`provider_id` 是配置中`provider` 部分的密鑰，`model_id` 是`provider.models` 中的密鑰。 +如果您配置了 [自定義供應商](/docs/providers#custom)，則 `provider_id` 是配置中 `provider` 部分的鍵，`model_id` 是 `provider.models` 中的鍵。 --- ## 配置模型 -您可以通過 config.json 全局配置模型的選項。 +您可以透過 config.json 全局配置模型的選項。 ```jsonc title="opencode.jsonc" {7-12,19-24} { @@ -100,12 +100,12 @@ OpenCode 配置。 } ``` -在這裡，我們為兩個內置模型配置全局設置：`gpt-5`（通過 `openai` 提供商訪問時）和 `claude-sonnet-4-20250514`（通過 `anthropic` 提供商訪問時）。 -內置提供商和型號名稱可以在[Models.dev](https://models.dev) 上找到。 +在這裡，我們為兩個內建模型配置全局設定：`gpt-5`（透過 `openai` 供應商存取時）和 `claude-sonnet-4-20250514`（透過 `anthropic` 供應商存取時）。 +內建供應商和模型名稱可以在 [Models.dev](https://models.dev) 上找到。 -您還可以為您正在使用的任何代理配置這些選項。代理配置會覆蓋此處的所有全局選項。 [了解更多](/docs/agents/#additional)。 +您還可以為您正在使用的任何代理配置這些選項。代理配置會覆寫此處的所有全局選項。 [了解更多](/docs/agents/#additional)。 -您還可以定義擴展內置變體的自定義變體。變體允許您為同一模型配置不同的設置，而無需創建重複的條目： +您還可以定義擴展內建變體的自定義變體。變體允許您為同一模型配置不同的設定，而無需建立重複的項目： ```jsonc title="opencode.jsonc" {6-21} { @@ -137,40 +137,40 @@ OpenCode 配置。 ## 變體 -許多型號支持具有不同配置的多種變體。OpenCode 附帶了流行提供商的內置默認變體。 +許多模型支援具有不同配置的多種變體。OpenCode 附帶了流行供應商的內建預設變體。 -### 內置變體 +### 內建變體 -OpenCode 附帶了許多提供商的默認變體： +OpenCode 附帶了許多供應商的預設變體： **Anthropic**： -- `high` - 高思維預算（默認） -- `max` - 最大思維預算 +- `high` - 高思考預算（預設） +- `max` - 最大思考預算 **OpenAI**： -因型號而異，但大致如下： +因模型而異，但大致如下： - `none` - 沒有推理 - `minimal` - 最少的推理工作 - `low` - 推理工作量低 -- `medium` - 中等推理努力 +- `medium` - 中等推理工作量 - `high` - 高推理能力 - `xhigh` - 極高的推理能力 **Google**: -- `low` - 降低工作量/代幣預算 -- `high` - 更高的努力/代幣預算 +- `low` - 降低工作量/Tokens 預算 +- `high` - 更高的工作量/Tokens 預算 :::tip -該列表並不全面。許多其他提供商也有內置的默認值。 +該列表並不全面。許多其他供應商也有內建的預設值。 ::: -### 定制變體 +### 自定義變體 -您可以覆蓋現有變體或添加您自己的變體： +您可以覆寫現有變體或添加您自己的變體： ```jsonc title="opencode.jsonc" {7-18} { @@ -201,11 +201,11 @@ OpenCode 附帶了許多提供商的默認變體： --- -## 加載模型 +## 載入模型 當 OpenCode 啟動時，它會按以下優先順序檢查模型： -1. `--model` 或 `-m` 命令行標誌。格式與配置文件中的相同：`provider_id/model_id`。 +1. `--model` 或 `-m` 命令列旗標。格式與設定檔中的相同：`provider_id/model_id`。 2. OpenCode 配置中的模型列表。 @@ -216,8 +216,8 @@ OpenCode 附帶了許多提供商的默認變體： } ``` - 這裡的格式是`provider/model`。 + 這裡的格式是 `provider/model`。 -3. 最後使用的型號。 +3. 最後使用的模型。 -4. 第一個模型使用內部優先級。 +4. 第一個模型使用內部優先順序。 diff --git a/packages/web/src/content/docs/zh-tw/modes.mdx b/packages/web/src/content/docs/zh-tw/modes.mdx index 1b4e75fd6..0d44dc2dd 100644 --- a/packages/web/src/content/docs/zh-tw/modes.mdx +++ b/packages/web/src/content/docs/zh-tw/modes.mdx @@ -1,62 +1,62 @@ --- title: 模式 -description: 不同的模式適用於不同的用例。 +description: 不同的模式適用於不同的使用案例。 --- :::caution -現在通過 opencode 配置中的 `agent` 選項配置模式。這 +現在透過 opencode 設定中的 `agent` 選項配置模式。這 `mode` 選項現已棄用。 [了解更多](/docs/agents)。 ::: -opencode 中的模式允許您自定義不同用例的行為、工具和提示。 +opencode 中的模式允許您自定義不同使用案例的行為、工具和提示。 -它具有兩種內置模式：**構建**和**計劃**。您可以定制 -這些或通過 opencode 配置配置您自己的。 +它具有兩種內建模式：**建置 (Build)**和**計畫 (Plan)**。您可以自定義 +這些或透過 opencode 設定配置您自己的。 -您可以在會話期間在模式之間切換或在配置文件中配置它們。 +您可以在工作階段期間在模式之間切換或在設定檔中配置它們。 --- ## 內建 -opencode 有兩種內置模式。 +opencode 有兩種內建模式。 --- -### 建造 +### 建置 (Build) -構建是啟用所有工具的**默認**模式。這是開發工作的標準模式，您需要完全訪問文件操作和系統命令。 +建置是啟用所有工具的**預設**模式。這是開發工作的標準模式，您需要完全存取檔案操作和系統指令。 --- -### 計劃 +### 計畫 (Plan) -專為規劃和分析而設計的受限模式。在計劃模式下，默認情況下禁用以下工具： +專為規劃和分析而設計的受限模式。在計畫模式下，預設情況下禁用以下工具： -- `write` - 無法創建新文件 -- `edit` - 無法修改現有文件，位於 `.opencode/plans/*.md` 的用於詳細說明計劃本身的文件除外 -- `patch` - 無法應用補丁 -- `bash` - 無法執行 shell 命令 +- `write` - 無法建立新檔案 +- `edit` - 無法修改現有檔案，位於 `.opencode/plans/*.md` 的用於詳細說明計畫本身的檔案除外 +- `patch` - 無法套用 Patch +- `bash` - 無法執行 shell 指令 -當您希望 AI 分析程式碼、建議更改或創建計劃而不對程式碼庫進行任何實際修改時，此模式非常有用。 +當您希望 AI 分析程式碼、建議變更或建立計畫而不對程式碼庫進行任何實際修改時，此模式非常有用。 --- -## 交換 +## 切換 -您可以在會話期間使用 _Tab_ 鍵在模式之間切換。或者您配置的 `switch_mode` 鍵綁定。 +您可以在工作階段期間使用 _Tab_ 鍵在模式之間切換。或者您配置的 `switch_mode` 鍵綁定。 -另請參閱：[格式化程序](/docs/formatters) 有關程式碼格式配置的信息。 +另請參閱：[格式化程式](/docs/formatters) 有關程式碼格式配置的資訊。 --- -## 配置 +## 設定 -您可以自定義內置模式或通過配置創建自己的模式。可以通過兩種方式配置模式： +您可以自定義內建模式或透過配置建立自己的模式。可以透過兩種方式配置模式： ### JSON 配置 -在 `opencode.json` 配置文件中配置模式： +在 `opencode.json` 設定檔中配置模式： ```json title="opencode.json" { @@ -85,10 +85,10 @@ opencode 有兩種內置模式。 ### Markdown 配置 -您還可以使用 Markdown 文件定義模式。將它們放入： +您還可以使用 Markdown 檔案定義模式。將它們放入： -- 全球：`~/.config/opencode/modes/` -- 項目：`.opencode/modes/` +- 全域：`~/.config/opencode/modes/` +- 專案：`.opencode/modes/` ```markdown title="~/.config/opencode/modes/review.md" --- @@ -110,15 +110,15 @@ You are in code review mode. Focus on: Provide constructive feedback without making direct changes. ``` -Markdown 文件名成為模式名稱（例如，`review.md` 創建`review` 模式）。 +Markdown 檔名成為模式名稱（例如，`review.md` 建立 `review` 模式）。 讓我們詳細看看這些配置選項。 --- -### 模型 +### 模型 (Model) -使用`model` 配置覆蓋此模式的默認模型。對於使用針對不同任務優化的不同模型很有用。例如，更快的規劃模型、更強大的實施模型。 +使用 `model` 配置覆寫此模式的預設模型。對於使用針對不同任務最佳化的不同模型很有用。例如，更快的規劃模型、更強大的實作模型。 ```json title="opencode.json" { @@ -132,9 +132,9 @@ Markdown 文件名成為模式名稱（例如，`review.md` 創建`review` 模 --- -### 溫度 +### 溫度 (Temperature) -使用 `temperature` 配置控制 AI 響應的隨機性和創造性。較低的值使響應更加集中和確定，而較高的值則增加創造力和可變性。 +使用 `temperature` 配置控制 AI 回應的隨機性和創造性。較低的值使回應更加集中和確定，而較高的值則增加創造力和可變性。 ```json title="opencode.json" { @@ -151,9 +151,9 @@ Markdown 文件名成為模式名稱（例如，`review.md` 創建`review` 模 溫度值的範圍通常為 0.0 到 1.0： -- **0.0-0.2**：非常集中且確定的響應，非常適合程式碼分析和規劃 -- **0.3-0.5**：具有一定創造力的平衡響應，適合一般開發任務 -- **0.6-1.0**：更有創意和多樣化的反應，有助於頭腦風暴和探索 +- **0.0-0.2**：非常集中且確定的回應，非常適合程式碼分析和規劃 +- **0.3-0.5**：具有一定創造力的平衡回應，適合一般開發任務 +- **0.6-1.0**：更有創意和多樣化的反應，有助於腦力激盪和探索 ```json title="opencode.json" { @@ -173,13 +173,13 @@ Markdown 文件名成為模式名稱（例如，`review.md` 創建`review` 模 } ``` -如果未指定溫度，opencode 將使用特定於模型的默認值（大多數模型通常為 0，Qwen 模型為 0.55）。 +如果未指定溫度，opencode 將使用特定於模型的預設值（大多數模型通常為 0，Qwen 模型為 0.55）。 --- -### 迅速的 +### 提示 (Prompt) -使用 `prompt` 配置為此模式指定自定義系統提示文件。提示文件應包含特定於該模式用途的指令。 +使用 `prompt` 配置為此模式指定自定義系統提示檔案。提示檔案應包含特定於該模式用途的指令。 ```json title="opencode.json" { @@ -191,14 +191,14 @@ Markdown 文件名成為模式名稱（例如，`review.md` 創建`review` 模 } ``` -該路徑是相對於配置文件所在位置的。所以這適用於 -全局 opencode 配置和項目特定配置。 +該路徑是相對於設定檔所在位置的。所以這適用於 +全域 opencode 配置和專案特定配置。 --- -### 工具 +### 工具 (Tools) -使用 `tools` 配置控制在此模式下可用的工具。您可以通過將特定工具設置為`true` 或`false` 來啟用或禁用特定工具。 +使用 `tools` 配置控制在此模式下可用的工具。您可以透過將特定工具設定為 `true` 或 `false` 來啟用或禁用特定工具。 ```json { @@ -217,33 +217,33 @@ Markdown 文件名成為模式名稱（例如，`review.md` 創建`review` 模 } ``` -如果未指定任何工具，則默認啟用所有工具。 +如果未指定任何工具，則預設啟用所有工具。 --- #### 可用工具 -這裡是所有可以通過模式配置控制的工具。 +這裡是所有可以透過模式配置控制的工具。 | 工具 | 描述 | | ----------- | ---------------- | -| `bash` | 執行 shell 命令 | -| `edit` | 修改現有文件 | -| `write` | 創建新文件 | -| `read` | 讀取文件內容 | -| `grep` | 搜索文件內容 | -| `glob` | 按模式查找文件 | +| `bash` | 執行 shell 指令 | +| `edit` | 修改現有檔案 | +| `write` | 建立新檔案 | +| `read` | 讀取檔案內容 | +| `grep` | 搜尋檔案內容 | +| `glob` | 按模式尋找檔案 | | `list` | 列出目錄內容 | -| `patch` | 對文件應用補丁 | -| `todowrite` | 管理待辦事項列表 | -| `todoread` | 閱讀待辦事項列表 | -| `webfetch` | 獲取網頁內容 | +| `patch` | 對檔案套用 Patch | +| `todowrite` | 管理待辦事項清單 | +| `todoread` | 閱讀待辦事項清單 | +| `webfetch` | 取得網頁內容 | --- ## 自定義模式 -您可以通過將自定義模式添加到配置來創建自己的自定義模式。以下是使用這兩種方法的示例： +您可以透過將自定義模式添加到配置來建立自己的自定義模式。以下是使用這兩種方法的範例： ### 使用 JSON 配置 @@ -266,9 +266,9 @@ Markdown 文件名成為模式名稱（例如，`review.md` 創建`review` 模 } ``` -### 使用 Markdown 文件 +### 使用 Markdown 檔案 -在`.opencode/modes/`中為項目特定模式創建模式文件，在`~/.config/opencode/modes/`中為全局模式創建模式文件： +在 `.opencode/modes/` 中為專案特定模式建立模式檔案，在 `~/.config/opencode/modes/` 中為全域模式建立模式檔案： ```markdown title=".opencode/modes/debug.md" --- @@ -320,12 +320,12 @@ Priorities: ### 使用案例 -以下是不同模式的一些常見用例。 +以下是不同模式的一些常見使用案例。 -- **構建模式**：啟用所有工具的完整開發工作 -- **計劃模式**：分析和計劃，無需更改 -- **審閱模式**：使用只讀訪問權限和文檔工具進行程式碼審閱 -- **調試模式**：專注於啟用 bash 和讀取工具的調查 -- **文檔模式**：使用文件操作但不使用系統命令的文檔編寫 +- **建置模式**：啟用所有工具的完整開發工作 +- **計畫模式**：分析和計畫，無需變更 +- **審閱模式**：使用唯讀存取權限和文件工具進行程式碼審閱 +- **除錯模式**：專注於啟用 bash 和讀取工具的調查 +- **文件模式**：使用檔案操作但不使用系統指令的文件編寫 -您可能還會發現不同的模型適用於不同的用例。 +您可能還會發現不同的模型適用於不同的使用案例。 diff --git a/packages/web/src/content/docs/zh-tw/network.mdx b/packages/web/src/content/docs/zh-tw/network.mdx index d67497b29..1bd900dbb 100644 --- a/packages/web/src/content/docs/zh-tw/network.mdx +++ b/packages/web/src/content/docs/zh-tw/network.mdx @@ -1,15 +1,15 @@ --- -title: 網絡 -description: 配置代理和自定義證書。 +title: 網路 +description: 配置代理伺服器和自定義憑證。 --- -opencode 支持企業網絡環境的標準代理環境變量和自定義證書。 +opencode 支援企業網路環境的標準代理環境變數和自定義憑證。 --- -## 代理人 +## 代理伺服器 -opencode 尊重標準代理環境變量。 +opencode 遵循標準代理環境變數。 ```bash # HTTPS proxy (recommended) @@ -23,30 +23,30 @@ export NO_PROXY=localhost,127.0.0.1 ``` :::caution -TUI 與本地 HTTP 服務器通信。您必須繞過此連接的代理以防止路由循環。 +TUI 與本地 HTTP 伺服器通訊。您必須繞過此連接的代理以防止路由迴圈。 ::: -您可以使用[CLI 標誌](/docs/cli#run)配置服務器的端口和主機名。 +您可以使用 [CLI 旗標](/docs/cli#run) 配置伺服器的連接埠和主機名稱。 --- -### 認證 +### 身分驗證 -如果您的代理需要基本身份驗證，請在 URL 中包含憑據。 +如果您的代理需要基本身分驗證，請在 URL 中包含憑證。 ```bash export HTTPS_PROXY=http://username:password@proxy.example.com:8080 ``` :::caution -避免對密碼進行硬編碼。使用環境變量或安全憑證存儲。 +避免對密碼進行寫死。使用環境變數或安全憑證儲存區。 ::: -對於需要高級身份驗證（例如 NTLM 或 Kerberos）的代理，請考慮使用支持您的身份驗證方法的 LLM 網關。 +對於需要高級身分驗證（例如 NTLM 或 Kerberos）的代理，請考慮使用支援您的身分驗證方法的 LLM 閘道。 --- -## 定制證書 +## 自定義憑證 如果您的企業使用自定義 CA 進行 HTTPS 連接，請配置 opencode 以信任它們。 @@ -54,4 +54,4 @@ export HTTPS_PROXY=http://username:password@proxy.example.com:8080 export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem ``` -這適用於代理連接和直接 API 訪問。 +這適用於代理連接和直接 API 存取。 diff --git a/packages/web/src/content/docs/zh-tw/permissions.mdx b/packages/web/src/content/docs/zh-tw/permissions.mdx index ee15881f7..7f14b9ebc 100644 --- a/packages/web/src/content/docs/zh-tw/permissions.mdx +++ b/packages/web/src/content/docs/zh-tw/permissions.mdx @@ -1,19 +1,19 @@ --- title: 權限 -description: 控制哪些操作需要批准才能運行。 +description: 控制哪些操作需要批准才能執行。 --- -opencode 使用`permission` 配置來決定給定的操作是否應自動運行、提示您或被阻止。 +opencode 使用 `permission` 配置來決定給定的操作是否應自動執行、提示您或被阻止。 -從 `v1.1.1` 開始，舊版 `tools` 布爾配置已被棄用，並已合併到 `permission` 中。仍支持舊的 `tools` 配置以實現向後兼容性。 +從 `v1.1.1` 開始，舊版 `tools` 布林配置已被棄用，並已合併到 `permission` 中。仍支援舊的 `tools` 配置以實現向後相容性。 --- -## 行動 +## 操作 每個權限規則解析為以下之一： -- `"allow"` — 未經批准運行 +- `"allow"` — 未經批准執行 - `"ask"` — 提示批准 - `"deny"` — 阻止該操作 @@ -21,7 +21,7 @@ opencode 使用`permission` 配置來決定給定的操作是否應自動運行 ## 配置 -您可以全局設置權限（使用`*`），並覆蓋特定工具。 +您可以全局設定權限（使用 `*`），並覆寫特定工具。 ```json title="opencode.json" { @@ -34,7 +34,7 @@ opencode 使用`permission` 配置來決定給定的操作是否應自動運行 } ``` -您還可以一次設置所有權限： +您還可以一次設定所有權限： ```json title="opencode.json" { @@ -45,9 +45,9 @@ opencode 使用`permission` 配置來決定給定的操作是否應自動運行 --- -## 粒度規則（對象語法） +## 精細規則（物件語法） -對於大多數權限，您可以使用對像根據工具輸入應用不同的操作。 +對於大多數權限，您可以使用物件根據工具輸入應用不同的操作。 ```json title="opencode.json" { @@ -68,17 +68,17 @@ opencode 使用`permission` 配置來決定給定的操作是否應自動運行 } ``` -規則通過模式匹配進行評估，**最後匹配的規則獲勝**。常見的模式是將包羅萬象的 `"*"` 規則放在前面，然後再放置更具體的規則。 +規則透過模式匹配進行評估，**最後匹配的規則獲勝**。常見的模式是將通用的 `"*"` 規則放在前面，然後再放置更具體的規則。 ### 通配符 權限模式使用簡單的通配符匹配： -- `*` 匹配零個或多個任意字符 -- `?` 恰好匹配一個字符 -- 所有其他字符均按字面意思匹配 +- `*` 匹配零個或多個任意字元 +- `?` 恰好匹配一個字元 +- 所有其他字元均按字面意思匹配 -### 主目錄擴展 +### 主目錄展開 您可以在模式開頭使用 `~` 或 `$HOME` 來引用您的主目錄。這對於 [`external_directory`](#external-directories) 規則特別有用。 @@ -88,11 +88,11 @@ opencode 使用`permission` 配置來決定給定的操作是否應自動運行 ### 外部目錄 -使用 `external_directory` 允許工具調用觸及啟動 opencode 的工作目錄之外的路徑。這適用於任何採用路徑作為輸入的工具（例如`read`、`edit`、`list`、`glob`、`grep` 和許多`bash` 命令）。 +使用 `external_directory` 允許工具呼叫存取啟動 opencode 的工作目錄之外的路徑。這適用於任何採用路徑作為輸入的工具（例如 `read`、`edit`、`list`、`glob`、`grep` 和許多 `bash` 指令）。 -主擴展（如`~/...`）僅影響模式的編寫方式。它不會使外部路徑成為當前工作空間的一部分，因此仍必須通過 `external_directory` 允許工作目錄之外的路徑。 +主目錄展開（如 `~/...`）僅影響模式的編寫方式。它不會使外部路徑成為當前工作空間的一部分，因此仍必須透過 `external_directory` 允許工作目錄之外的路徑。 -例如，這允許訪問 `~/projects/personal/` 下的所有內容： +例如，這允許存取 `~/projects/personal/` 下的所有內容： ```json title="opencode.json" { @@ -105,7 +105,7 @@ opencode 使用`permission` 配置來決定給定的操作是否應自動運行 } ``` -此處允許的任何目錄都會繼承與當前工作空間相同的默認值。自[`read` 默認為 `allow`](#defaults) 起，也允許讀取`external_directory` 下的條目，除非被覆蓋。當工具應限制在這些路徑中時添加顯式規則，例如在保留讀取的同時阻止編輯： +此處允許的任何目錄都會繼承與當前工作空間相同的預設值。自 [`read` 預設為 `allow`](#defaults) 起，也允許讀取 `external_directory` 下的項目，除非被覆寫。當工具應限制在這些路徑中時添加顯式規則，例如在保留讀取的同時阻止編輯： ```json title="opencode.json" { @@ -121,7 +121,7 @@ opencode 使用`permission` 配置來決定給定的操作是否應自動運行 } ``` -將列表重點放在受信任的路徑上，並根據其他工具的需要分層額外的允許或拒絕規則（例如 `bash`）。 +將列表重點放在受信任的路徑上，並根據其他工具的需要疊加額外的允許或拒絕規則（例如 `bash`）。 --- @@ -129,30 +129,30 @@ opencode 使用`permission` 配置來決定給定的操作是否應自動運行 opencode 權限由工具名稱和一些安全防護措施決定： -- `read` — 讀取文件（與文件路徑匹配） -- `edit` — 所有文件修改（涵蓋`edit`、`write`、`patch`、`multiedit`） -- `glob` — 文件通配符（匹配通配符模式） -- `grep` — 內容搜索（匹配正則表達式模式） -- `list` — 列出目錄中的文件（與目錄路徑匹配） -- `bash` — 運行 shell 命令（匹配 `git status --porcelain` 等解析命令） +- `read` — 讀取檔案（與檔案路徑匹配） +- `edit` — 所有檔案修改（涵蓋 `edit`、`write`、`patch`、`multiedit`） +- `glob` — 檔案通配符（匹配通配符模式） +- `grep` — 內容搜尋（匹配正規表示式模式） +- `list` — 列出目錄中的檔案（與目錄路徑匹配） +- `bash` — 執行 shell 指令（匹配 `git status --porcelain` 等解析指令） - `task` — 啟動子代理（與子代理類型匹配） -- `skill` — 加載技能（與技能名稱匹配） -- `lsp` — 運行 LSP 查詢（當前非粒度） -- `todoread`、`todowrite` — 讀取/更新待辦事項列表 +- `skill` — 載入技能（與技能名稱匹配） +- `lsp` — 執行 LSP 查詢（當前非精細） +- `todoread`、`todowrite` — 讀取/更新待辦事項清單 - `webfetch` — 獲取 URL（與 URL 匹配） -- `websearch`、`codesearch` — 網頁/程式碼搜索（與查詢匹配） -- `external_directory` — 當工具觸及項目工作目錄之外的路徑時觸發 -- `doom_loop` — 當相同的工具調用使用相同的輸入重複 3 次時觸發 +- `websearch`、`codesearch` — 網頁/程式碼搜尋（與查詢匹配） +- `external_directory` — 當工具存取專案工作目錄之外的路徑時觸發 +- `doom_loop` — 當相同的工具呼叫使用相同的輸入重複 3 次時觸發 --- ## 預設值 -如果您不指定任何內容，opencode 將從許可的默認值開始： +如果您不指定任何內容，opencode 將從許可的預設值開始： -- 大多數權限默認為`"allow"`。 -- `doom_loop` 和`external_directory` 默認為`"ask"`。 -- `read` 是 `"allow"`，但 `.env` 文件默認被拒絕： +- 大多數權限預設為 `"allow"`。 +- `doom_loop` 和 `external_directory` 預設為 `"ask"`。 +- `read` 是 `"allow"`，但 `.env` 檔案預設被拒絕： ```json title="opencode.json" { @@ -169,24 +169,24 @@ opencode 權限由工具名稱和一些安全防護措施決定： --- -## “問”的作用是什麼 +## 「問」(Ask) 的作用是什麼 當 opencode 提示批准時，UI 會提供三種結果： - `once` — 僅批准此請求 -- `always` — 批准與建議模式匹配的未來請求（對於當前 opencode 會話的其餘部分） +- `always` — 批准與建議模式匹配的未來請求（對於當前 opencode 工作階段的其餘部分） - `reject` — 拒絕請求 -`always` 將批准的模式集由該工具提供（例如，bash 批准通常將安全命令前綴（如 `git status*`）列入白名單）。 +`always` 將批准的模式集由該工具提供（例如，bash 批准通常將安全指令前綴（如 `git status*`）列入白名單）。 --- -## Agents +## 代理 -您可以覆蓋每個代理的權限。代理權限與全局​​配置合併，代理規則優先。 [了解更多](/docs/agents#permissions) 關於代理權限。 +您可以覆寫每個代理的權限。代理權限與全局配置合併，代理規則優先。 [了解更多](/docs/agents#permissions) 關於代理權限。 :::note -有關更詳細的模式匹配示例，請參閱上面的 [粒度規則（對象語法）](#granular-rules-object-syntax) 部分。 +有關更詳細的模式匹配範例，請參閱上面的 [精細規則（物件語法）](#granular-rules-object-syntax) 部分。 ::: ```json title="opencode.json" @@ -233,5 +233,5 @@ Only analyze code and suggest changes. ``` :::tip -對帶有參數的命令使用模式匹配。 `"grep *"` 允許`grep pattern file.txt`，而`"grep"` 單獨會阻止它。像 `git status` 這樣的命令適用於默認行為，但在傳遞參數時需要顯式許可（如 `"git status *"`）。 +對帶有參數的指令使用模式匹配。 `"grep *"` 允許 `grep pattern file.txt`，而 `"grep"` 單獨會阻止它。像 `git status` 這樣的指令適用於預設行為，但在傳遞參數時需要顯式許可（如 `"git status *"`）。 ::: diff --git a/packages/web/src/content/docs/zh-tw/plugins.mdx b/packages/web/src/content/docs/zh-tw/plugins.mdx index be6230bf2..1b586c3df 100644 --- a/packages/web/src/content/docs/zh-tw/plugins.mdx +++ b/packages/web/src/content/docs/zh-tw/plugins.mdx @@ -1,34 +1,34 @@ --- -title: 插件 -description: 編寫您自己的插件來擴展 opencode。 +title: 外掛 +description: 編寫您自己的外掛來擴展 opencode。 --- -插件允許您通過掛鉤各種事件和自定義行為來擴展 opencode。您可以創建插件來添加新功能、與外部服務集成或修改 opencode 的默認行為。 +外掛允許您透過掛鉤各種事件和自定義行為來擴展 opencode。您可以建立外掛來新增新功能、與外部服務整合或修改 opencode 的預設行為。 -例如，查看社區創建的[插件](/docs/ecosystem#plugins)。 +例如，查看社群建立的[外掛](/docs/ecosystem#plugins)。 --- -## 使用插件 +## 使用外掛 -有兩種加載插件的方法。 +有兩種載入外掛的方法。 --- -### 從本地文件 +### 從本地檔案 -將 JavaScript 或 TypeScript 文件放置在插件目錄中。 +將 JavaScript 或 TypeScript 檔案放置在外掛目錄中。 -- `.opencode/plugins/` - 項目級插件 -- `~/.config/opencode/plugins/` - 全局插件 +- `.opencode/plugins/` - 專案級外掛 +- `~/.config/opencode/plugins/` - 全域外掛 -這些目錄中的文件會在啟動時自動加載。 +這些目錄中的檔案會在啟動時自動載入。 --- ### 來自 npm -在配置文件中指定 npm 包。 +在設定檔中指定 npm 套件。 ```json title="opencode.json" { @@ -37,43 +37,43 @@ description: 編寫您自己的插件來擴展 opencode。 } ``` -支持常規和範圍 npm 包。 +支援常規和範圍 npm 套件。 -瀏覽[生態系統](/docs/ecosystem#plugins)中的可用插件。 +瀏覽[生態系統](/docs/ecosystem#plugins)中的可用外掛。 --- -### 插件是如何安裝的 +### 外掛是如何安裝的 -**npm 插件** 在啟動時使用 Bun 自動安裝。包及其依賴項緩存在`~/.cache/opencode/node_modules/`中。 +**npm 外掛** 在啟動時使用 Bun 自動安裝。套件及其相依套件快取在 `~/.cache/opencode/node_modules/` 中。 -**本地插件**直接從插件目錄加載。要使用外部包，您必須在配置目錄中創建`package.json`（請參閱[依賴關係](#dependencies)），或將插件發佈到npm和[將其添加到您的配置中](/docs/config#plugins)。 +**本地外掛**直接從外掛目錄載入。要使用外部套件，您必須在設定目錄中建立 `package.json`（請參閱[相依性](#dependencies)），或將外掛發佈到 npm 和[將其添加到您的設定中](/docs/config#plugins)。 --- -### 加載順序 +### 載入順序 -插件從所有源加載，所有掛鉤按順序運行。加載順序為： +外掛從所有來源載入，所有掛鉤按順序執行。載入順序為： -1. 全局配置 (`~/.config/opencode/opencode.json`) -2. 項目配置（`opencode.json`） -3. 全局插件目錄 (`~/.config/opencode/plugins/`) -4. 項目插件目錄(`.opencode/plugins/`) +1. 全域設定 (`~/.config/opencode/opencode.json`) +2. 專案設定（`opencode.json`） +3. 全域外掛目錄 (`~/.config/opencode/plugins/`) +4. 專案外掛目錄(`.opencode/plugins/`) -具有相同名稱和版本的重複 npm 包將被加載一次。但是，本地插件和名稱相似的 npm 插件都是分開加載的。 +具有相同名稱和版本的重複 npm 套件將被載入一次。但是，本地外掛和名稱相似的 npm 外掛都是分開載入的。 --- -## 創建一個插件 +## 建立一個外掛 -插件是一個 **JavaScript/TypeScript 模塊**，它導出一個或多個插件 -功能。每個函數接收一個上下文對象並返回一個鉤子對象。 +外掛是一個 **JavaScript/TypeScript 模組**，它匯出一個或多個外掛 +函式。每個函式接收一個上下文物件並返回一個掛鉤物件。 --- -### 依賴關係 +### 相依性 -本地插件和自定義工具可以使用外部 npm 包。將 `package.json` 添加到您的配置目錄，其中包含您需要的依賴項。 +本地外掛和自定義工具可以使用外部 npm 套件。將 `package.json` 添加到您的設定目錄，其中包含您需要的相依套件。 ```json title=".opencode/package.json" { @@ -83,7 +83,7 @@ description: 編寫您自己的插件來擴展 opencode。 } ``` -opencode 在啟動時運行 `bun install` 來安裝這些。然後您的插件和工具就可以導入它們。 +opencode 在啟動時執行 `bun install` 來安裝這些。然後您的外掛和工具就可以匯入它們。 ```ts title=".opencode/plugins/my-plugin.ts" import { escape } from "shescape" @@ -113,19 +113,19 @@ export const MyPlugin = async ({ project, client, $, directory, worktree }) => { } ``` -插件函數接收： +外掛函式接收： -- `project`：當前項目信息。 +- `project`：當前專案資訊。 - `directory`：當前工作目錄。 - `worktree`：git 工作樹路徑。 -- `client`：用於與 AI 交互的opencode SDK 客戶端。 -- `$`：Bun的[shell API](https://bun.com/docs/runtime/shell)用於執行命令。 +- `client`：用於與 AI 互動的 opencode SDK 客戶端。 +- `$`：Bun 的 [shell API](https://bun.com/docs/runtime/shell) 用於執行指令。 --- -### TypeScript 支持 +### TypeScript 支援 -對於 TypeScript 插件，您可以從插件包中導入類型： +對於 TypeScript 外掛，您可以從外掛套件中匯入類型： ```ts title="my-plugin.ts" {1} import type { Plugin } from "@opencode-ai/plugin" @@ -139,29 +139,29 @@ export const MyPlugin: Plugin = async ({ project, client, $, directory, worktree --- -### 活動 +### 事件 -插件可以訂閱事件，如下面的示例部分所示。以下是可用的不同事件的列表。 +外掛可以訂閱事件，如下面的範例部分所示。以下是可用的不同事件的列表。 -#### 命令事件 +#### 指令事件 - `command.executed` -#### 文件事件 +#### 檔案事件 - `file.edited` - `file.watcher.updated` -#### 安裝活動 +#### 安裝事件 - `installation.updated` -#### LSP活動 +#### LSP 事件 - `lsp.client.diagnostics` - `lsp.updated` -#### 消息事件 +#### 訊息事件 - `message.part.removed` - `message.part.updated` @@ -173,11 +173,11 @@ export const MyPlugin: Plugin = async ({ project, client, $, directory, worktree - `permission.asked` - `permission.replied` -#### 服務器事件 +#### 伺服器事件 - `server.connected` -#### 會議活動 +#### 工作階段事件 - `session.created` - `session.compacted` @@ -188,11 +188,11 @@ export const MyPlugin: Plugin = async ({ project, client, $, directory, worktree - `session.status` - `session.updated` -#### 都都活動 +#### Todo 事件 - `todo.updated` -#### 殼牌活動 +#### Shell 事件 - `shell.env` @@ -201,7 +201,7 @@ export const MyPlugin: Plugin = async ({ project, client, $, directory, worktree - `tool.execute.after` - `tool.execute.before` -#### TUI 活動 +#### TUI 事件 - `tui.prompt.append` - `tui.command.execute` @@ -209,9 +209,9 @@ export const MyPlugin: Plugin = async ({ project, client, $, directory, worktree --- -## 示例 +## 範例 -以下是一些可用於擴展 opencode 的插件示例。 +以下是一些可用於擴展 opencode 的外掛範例。 --- @@ -232,17 +232,17 @@ export const NotificationPlugin = async ({ project, client, $, directory, worktr } ``` -我們使用 `osascript` 在 macOS 上運行 AppleScript。這裡我們用它來發送通知。 +我們使用 `osascript` 在 macOS 上執行 AppleScript。這裡我們用它來發送通知。 :::note -如果您使用 opencode 桌面應用程式，它可以在響應準備就緒或會話出錯時自動發送系統通知。 +如果您使用 opencode 桌面應用程式，它可以在回應準備就緒或工作階段出錯時自動發送系統通知。 ::: --- ### .env 保護 -阻止 opencode 讀取 `.env` 文件： +阻止 opencode 讀取 `.env` 檔案： ```javascript title=".opencode/plugins/env-protection.js" export const EnvProtection = async ({ project, client, $, directory, worktree }) => { @@ -258,9 +258,9 @@ export const EnvProtection = async ({ project, client, $, directory, worktree }) --- -### 注入環境變量 +### 注入環境變數 -將環境變量注入所有 shell 執行（AI 工具和用戶 terminal）： +將環境變數注入所有 shell 執行（AI 工具和使用者終端機）： ```javascript title=".opencode/plugins/inject-env.js" export const InjectEnvPlugin = async () => { @@ -275,9 +275,9 @@ export const InjectEnvPlugin = async () => { --- -### 定制工具 +### 自定義工具 -插件還可以向 opencode 添加自定義工具： +外掛還可以向 opencode 添加自定義工具： ```ts title=".opencode/plugins/custom-tools.ts" import { type Plugin, tool } from "@opencode-ai/plugin" @@ -300,19 +300,19 @@ export const CustomToolsPlugin: Plugin = async (ctx) => { } ``` -`tool` 幫助器創建一個 opencode 可以調用的自定義工具。它採用 Zod 模式函數並返回一個工具定義： +`tool` 輔助程式建立一個 opencode 可以呼叫的自定義工具。它採用 Zod 模式函式並返回一個工具定義： - `description`：該工具的作用 - `args`：工具參數的 Zod 模式 -- `execute`：調用工具時運行的函數 +- `execute`：呼叫工具時執行的函式 -您的自定義工具將可與內置工具一起用於opencode。 +您的自定義工具將可與內建工具一起用於 opencode。 --- ### 記錄 -使用 `client.app.log()` 而不是 `console.log` 進行結構化日誌記錄： +使用 `client.app.log()` 而不是 `console.log` 進行結構化記錄： ```ts title=".opencode/plugins/my-plugin.ts" export const MyPlugin = async ({ client }) => { @@ -327,13 +327,13 @@ export const MyPlugin = async ({ client }) => { } ``` -級別：`debug`、`info`、`warn`、`error`。詳情請參閱[SDK 文件](https://opencode.ai/docs/sdk)。 +等級：`debug`、`info`、`warn`、`error`。詳情請參閱 [SDK 文件](https://opencode.ai/docs/sdk)。 --- -### 壓實鉤 +### 壓縮掛鉤 -自定義壓縮會話時包含的上下文： +自定義壓縮工作階段時包含的上下文： ```ts title=".opencode/plugins/compaction.ts" import type { Plugin } from "@opencode-ai/plugin" @@ -343,7 +343,7 @@ export const CompactionPlugin: Plugin = async (ctx) => { "experimental.session.compacting": async (input, output) => { // Inject additional context into the compaction prompt output.context.push(` -## Custom Context +## 自定義上下文 Include any state that should persist across compaction: - Current task status @@ -355,9 +355,9 @@ Include any state that should persist across compaction: } ``` -`experimental.session.compacting` 鉤子在 LLM 生成延續摘要之前觸發。使用它來注入默認壓縮提示會錯過的特定於域的上下文。 +`experimental.session.compacting` 掛鉤在 LLM 生成延續摘要之前觸發。使用它來注入預設壓縮提示會錯過的特定於域的上下文。 -您還可以通過設置`output.prompt`來完全替換壓縮提示： +您還可以透過設定 `output.prompt` 來完全替換壓縮提示： ```ts title=".opencode/plugins/custom-compaction.ts" import type { Plugin } from "@opencode-ai/plugin" @@ -382,4 +382,4 @@ Format as a structured prompt that a new agent can use to resume work. } ``` -當設置`output.prompt`時，它完全取代默認的壓縮提示。在這種情況下，`output.context` 數組將被忽略。 +當設定 `output.prompt` 時，它完全取代預設的壓縮提示。在這種情況下，`output.context` 陣列將被忽略。 diff --git a/packages/web/src/content/docs/zh-tw/providers.mdx b/packages/web/src/content/docs/zh-tw/providers.mdx index 8c21f5cf1..44bf90d99 100644 --- a/packages/web/src/content/docs/zh-tw/providers.mdx +++ b/packages/web/src/content/docs/zh-tw/providers.mdx @@ -1,36 +1,36 @@ --- -title: 提供商 -description: 使用 OpenCode 中的任何 LLM 提供商。 +title: 供應商 +description: 使用 OpenCode 中的任何 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 提供商**，並且它支持運行本地模型。 +OpenCode 使用 [AI SDK](https://ai-sdk.dev/) 和 [Models.dev](https://models.dev) 來支援 **75+ LLM 供應商**，並且它支援執行本地模型。 -要添加提供商，您需要： +要添加供應商，您需要： -1. 使用 `/connect` 命令添加提供商的 API 密鑰。 -2. 在 OpenCode 配置中配置提供商。 +1. 使用 `/connect` 指令添加供應商的 API 金鑰。 +2. 在 OpenCode 配置中配置供應商。 --- ### 憑證 -當您使用 `/connect` 命令添加提供商的 API 密鑰時，它們會被存儲 +當您使用 `/connect` 指令添加供應商的 API 金鑰時，它們會被儲存 在 `~/.local/share/opencode/auth.json`。 --- ### 配置 -您可以在 OpenCode 配置的 `provider` 部分自定義提供商。 +您可以在 OpenCode 配置的 `provider` 部分自定義供應商。 --- -#### 基本網址 +#### 基本網址 (Base URL) -您可以通過設置 `baseURL` 選項來自定義任何提供商的基本 URL。這在使用代理服務或自定義端點時非常有用。 +您可以透過設定 `baseURL` 選項來自定義任何供應商的基本 URL。這在使用代理服務或自定義端點時非常有用。 ```json title="opencode.json" {6} { @@ -56,15 +56,15 @@ OpenCode Zen 是 OpenCode 團隊提供的模型列表，這些模型已被 如果您是新手，我們建議您從 OpenCode Zen 開始。 ::: -1. 在 TUI 中運行 `/connect` 命令，選擇 opencode，然後前往 [opencode.ai/auth](https://opencode.ai/auth)。 +1. 在 TUI 中執行 `/connect` 指令，選擇 opencode，然後前往 [opencode.ai/auth](https://opencode.ai/auth)。 ```txt /connect ``` -2. 登錄，添加您的帳單詳細信息，然後複製您的 API 密鑰。 +2. 登入，添加您的帳單詳細資訊，然後複製您的 API 金鑰。 -3. 粘貼您的 API 密鑰。 +3. 貼上您的 API 金鑰。 ```txt ┌ API key @@ -73,38 +73,38 @@ OpenCode Zen 是 OpenCode 團隊提供的模型列表，這些模型已被 └ enter ``` -4. 在 TUI 中運行 `/models` 以查看我們推薦的模型列表。 +4. 在 TUI 中執行 `/models` 以查看我們推薦的模型列表。 ```txt /models ``` -它的工作方式與 OpenCode 中的任何其他提供商一樣，並且完全可以選擇使用。 +它的工作方式與 OpenCode 中的任何其他供應商一樣，並且完全可以選擇使用。 --- ## 目錄 -讓我們詳細了解一些提供商。如果您想將提供商添加到 +讓我們詳細了解一些供應商。如果您想將供應商添加到 列表，請隨時打開 PR。 :::note -在這裡沒有看到提供商？提交 PR。 +在這裡沒有看到供應商？提交 PR。 ::: --- ### 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 ``` -3. 輸入您的 302.AI API 密鑰。 +3. 輸入您的 302.AI API 金鑰。 ```txt ┌ API key @@ -113,7 +113,7 @@ OpenCode Zen 是 OpenCode 團隊提供的模型列表，這些模型已被 └ enter ``` -4. 執行 `/models` 命令選擇模型。 +4. 執行 `/models` 指令選擇模型。 ```txt /models @@ -125,18 +125,18 @@ OpenCode Zen 是 OpenCode 團隊提供的模型列表，這些模型已被 要將 Amazon Bedrock 與 OpenCode 結合使用： -1. 前往 Amazon Bedrock 控制台中的 **Model catalog** 並請求 - 訪問您想要的模型。 +1. 前往 Amazon Bedrock 主控台中的 **Model catalog** 並請求 + 存取您想要的模型。 :::tip - 您需要能夠在 Amazon Bedrock 中訪問所需的模型。 + 您需要能夠在 Amazon Bedrock 中存取所需的模型。 ::: -2. **使用以下方法之一配置身份驗證**： +2. **使用以下方法之一配置身分驗證**： - #### 環境變量（快速啟動） + #### 環境變數（快速啟動） - 運行 opencode 時設置以下環境變量之一： + 執行 opencode 時設定以下環境變數之一： ```bash # Option 1: Using AWS access keys @@ -149,16 +149,16 @@ OpenCode Zen 是 OpenCode 團隊提供的模型列表，這些模型已被 AWS_BEARER_TOKEN_BEDROCK=XXX opencode ``` - 或者將它們添加到您的 bash 配置文件中： + 或者將它們添加到您的 bash 設定檔中： ```bash title="~/.bash_profile" export AWS_PROFILE=my-dev-profile export AWS_REGION=us-east-1 ``` - #### 配置文件（推薦） + #### 設定檔（推薦） - 對於特定於項目或持久的配置，請使用 `opencode.json`： + 對於特定於專案或持久的配置，請使用 `opencode.json`： ```json title="opencode.json" { @@ -176,11 +176,11 @@ OpenCode Zen 是 OpenCode 團隊提供的模型列表，這些模型已被 **可用選項：** - `region` - AWS 區域（例如 `us-east-1`、`eu-west-1`） - - `profile` - 來自 `~/.aws/credentials` 的 AWS 命名配置文件 + - `profile` - 來自 `~/.aws/credentials` 的 AWS 命名設定檔 - `endpoint` - 用於 VPC 端點的自定義端點 URL（通用 `baseURL` 選項的別名） :::tip - 配置文件選項優先於環境變量。 + 設定檔選項優先於環境變數。 ::: #### 高級：VPC 端點 @@ -207,29 +207,29 @@ OpenCode Zen 是 OpenCode 團隊提供的模型列表，這些模型已被 ::: #### 認證方式 - - **`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_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 自動注入。 #### 認證優先級 - Amazon Bedrock 使用以下身份驗證優先級： - 1. **Bearer Token** - `AWS_BEARER_TOKEN_BEDROCK` 環境變量或來自 `/connect` 命令的令牌 - 2. **AWS Credential Chain** - 配置文件、訪問密鑰、共享憑證、IAM 角色、Web 身份令牌 (EKS IRSA)、實例元數據 + Amazon Bedrock 使用以下身分驗證優先級： + 1. **Bearer Token** - `AWS_BEARER_TOKEN_BEDROCK` 環境變數或來自 `/connect` 指令的令牌 + 2. **AWS Credential Chain** - 設定檔、存取金鑰、共享憑證、IAM 角色、Web 身分令牌 (EKS IRSA)、實例元數據 :::note - 當設置 Bearer Token 時（通過 `/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" { @@ -253,14 +253,14 @@ OpenCode Zen 是 OpenCode 團隊提供的模型列表，這些模型已被 ### Anthropic -1. 註冊後，運行 `/connect` 命令並選擇 Anthropic。 +1. 註冊後，執行 `/connect` 指令並選擇 Anthropic。 ```txt /connect ``` 2. 在這裡您可以選擇 **Claude Pro/Max** 選項，它將打開您的瀏覽器 - 並要求您進行身份驗證。 + 並要求您進行身分驗證。 ```txt ┌ Select auth method @@ -271,21 +271,21 @@ OpenCode Zen 是 OpenCode 團隊提供的模型列表，這些模型已被 └ ``` -3. 現在，當您使用 `/models` 命令時，所有 Anthropic 模型都應該可用。 +3. 現在，當您使用 `/models` 指令時，所有 Anthropic 模型都應該可用。 ```txt /models ``` :::info -[Anthropic](https://anthropic.com) 不正式支持在 OpenCode 中使用您的 Claude Pro/Max 訂閱。 +[Anthropic](https://anthropic.com) 不正式支援在 OpenCode 中使用您的 Claude Pro/Max 訂閱。 ::: -##### 使用 API 密鑰 +##### 使用 API 金鑰 -如果您沒有 Pro/Max 訂閱，您還可以選擇 **Create an API Key**。它還會打開您的瀏覽器並要求您登錄 Anthropic 並為您提供一個可以粘貼到終端機中的代碼。 +如果您沒有 Pro/Max 訂閱，您還可以選擇 **Create an API Key**。它還會打開您的瀏覽器並要求您登入 Anthropic 並為您提供一個可以貼上到終端機中的代碼。 -或者，如果您已有 API 密鑰，則可以選擇 **Manually enter API Key** 並將其粘貼到您的終端機中。 +或者，如果您已有 API 金鑰，則可以選擇 **Manually enter API Key** 並將其貼上到您的終端機中。 --- @@ -295,7 +295,7 @@ OpenCode Zen 是 OpenCode 團隊提供的模型列表，這些模型已被 如果遇到 "I'm sorry, but I cannot assist with that request" 錯誤，請嘗試將 Azure 資源中的內容篩選器從 **DefaultV2** 更改為 **Default**。 ::: -1. 轉到 [Azure portal](https://portal.azure.com/) 並創建 **Azure OpenAI** 資源。您需要： +1. 轉到 [Azure portal](https://portal.azure.com/) 並建立 **Azure OpenAI** 資源。您需要： - **Resource name**：這將成為您的 API 端點 (`https://RESOURCE_NAME.openai.azure.com/`) 的一部分 - **API key**：來自您的資源的 `KEY 1` 或 `KEY 2` @@ -305,13 +305,13 @@ OpenCode Zen 是 OpenCode 團隊提供的模型列表，這些模型已被 部署名稱必須與模型名稱匹配，OpenCode 才能正常工作。 ::: -3. 運行 `/connect` 命令並搜尋 **Azure**。 +3. 執行 `/connect` 指令並搜尋 **Azure**。 ```txt /connect ``` -4. 輸入您的 API 密鑰。 +4. 輸入您的 API 金鑰。 ```txt ┌ API key @@ -320,19 +320,19 @@ OpenCode Zen 是 OpenCode 團隊提供的模型列表，這些模型已被 └ enter ``` -5. 將您的資源名稱設置為環境變量： +5. 將您的資源名稱設定為環境變數： ```bash AZURE_RESOURCE_NAME=XXX opencode ``` - 或者將其添加到您的 bash 配置文件中： + 或者將其添加到您的 bash 設定檔中： ```bash title="~/.bash_profile" export AZURE_RESOURCE_NAME=XXX ``` -6. 運行 `/models` 命令以選擇您部署的模型。 +6. 執行 `/models` 指令以選擇您部署的模型。 ```txt /models @@ -342,7 +342,7 @@ OpenCode Zen 是 OpenCode 團隊提供的模型列表，這些模型已被 ### Azure Cognitive Services -1. 轉到 [Azure portal](https://portal.azure.com/) 並創建 **Azure OpenAI** 資源。您需要： +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` @@ -352,13 +352,13 @@ OpenCode Zen 是 OpenCode 團隊提供的模型列表，這些模型已被 部署名稱必須與模型名稱匹配，OpenCode 才能正常工作。 ::: -3. 運行 `/connect` 命令並搜尋 **Azure Cognitive Services**。 +3. 執行 `/connect` 指令並搜尋 **Azure Cognitive Services**。 ```txt /connect ``` -4. 輸入您的 API 密鑰。 +4. 輸入您的 API 金鑰。 ```txt ┌ API key @@ -367,19 +367,19 @@ OpenCode Zen 是 OpenCode 團隊提供的模型列表，這些模型已被 └ enter ``` -5. 將您的資源名稱設置為環境變量： +5. 將您的資源名稱設定為環境變數： ```bash AZURE_COGNITIVE_SERVICES_RESOURCE_NAME=XXX opencode ``` - 或者將其添加到您的 bash 配置文件中： + 或者將其添加到您的 bash 設定檔中： ```bash title="~/.bash_profile" export AZURE_COGNITIVE_SERVICES_RESOURCE_NAME=XXX ``` -6. 運行 `/models` 命令以選擇您部署的模型。 +6. 執行 `/models` 指令以選擇您部署的模型。 ```txt /models @@ -389,15 +389,15 @@ 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 ``` -3. 輸入您的 Baseten API 密鑰。 +3. 輸入您的 Baseten API 金鑰。 ```txt ┌ API key @@ -406,7 +406,7 @@ OpenCode Zen 是 OpenCode 團隊提供的模型列表，這些模型已被 └ enter ``` -4. 執行 `/models` 命令選擇模型。 +4. 執行 `/models` 指令選擇模型。 ```txt /models @@ -416,15 +416,15 @@ 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 ``` -3. 輸入您的 Cerebras API 密鑰。 +3. 輸入您的 Cerebras API 金鑰。 ```txt ┌ API key @@ -433,7 +433,7 @@ OpenCode Zen 是 OpenCode 團隊提供的模型列表，這些模型已被 └ enter ``` -4. 運行 `/models` 命令選擇模型，如 _Qwen 3 Coder 480B_。 +4. 執行 `/models` 指令選擇模型，如 _Qwen 3 Coder 480B_。 ```txt /models @@ -443,18 +443,18 @@ OpenCode Zen 是 OpenCode 團隊提供的模型列表，這些模型已被 ### Cloudflare AI Gateway -Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthropic、Workers AI 等的模型。使用 [Unified Billing](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 dashboard](https://dash.cloudflare.com/)，導航至 **AI** > **AI Gateway**，然後創建一個新網關。 +1. 前往 [Cloudflare dashboard](https://dash.cloudflare.com/)，導覽至 **AI** > **AI Gateway**，然後建立一個新閘道。 -2. 將您的 Account ID 和 Gateway 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 @@ -469,19 +469,19 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro └ enter ``` - 或者將其設置為環境變量。 + 或者將其設定為環境變數。 ```bash title="~/.bash_profile" export CLOUDFLARE_API_TOKEN=your-api-token ``` -5. 執行 `/models` 命令選擇模型。 +5. 執行 `/models` 指令選擇模型。 ```txt /models ``` - 您還可以通過 OpenCode 配置添加模型。 + 您還可以透過 OpenCode 配置添加模型。 ```json title="opencode.json" { @@ -501,15 +501,15 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro ### Cortecs -1. 前往 [Cortecs console](https://cortecs.ai/)，創建一個帳戶並生成一個 API 密鑰。 +1. 前往 [Cortecs console](https://cortecs.ai/)，建立一個帳戶並生成一個 API 金鑰。 -2. 運行 `/connect` 命令並搜尋 **Cortecs**。 +2. 執行 `/connect` 指令並搜尋 **Cortecs**。 ```txt /connect ``` -3. 輸入您的 Cortecs API 密鑰。 +3. 輸入您的 Cortecs API 金鑰。 ```txt ┌ API key @@ -518,7 +518,7 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro └ enter ``` -4. 運行 `/models` 命令選擇一個模型，如 _Kimi K2 Instruct_。 +4. 執行 `/models` 指令選擇一個模型，如 _Kimi K2 Instruct_。 ```txt /models @@ -528,15 +528,15 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro ### DeepSeek -1. 前往 [DeepSeek console](https://platform.deepseek.com/)，創建一個帳戶，然後單擊 **Create new API key**。 +1. 前往 [DeepSeek console](https://platform.deepseek.com/)，建立一個帳戶，然後單擊 **Create new API key**。 -2. 運行 `/connect` 命令並搜尋 **DeepSeek**。 +2. 執行 `/connect` 指令並搜尋 **DeepSeek**。 ```txt /connect ``` -3. 輸入您的 DeepSeek API 密鑰。 +3. 輸入您的 DeepSeek API 金鑰。 ```txt ┌ API key @@ -545,7 +545,7 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro └ enter ``` -4. 運行 `/models` 命令以選擇 DeepSeek 模型，例如 _DeepSeek Reasoner_。 +4. 執行 `/models` 指令以選擇 DeepSeek 模型，例如 _DeepSeek Reasoner_。 ```txt /models @@ -555,15 +555,15 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro ### Deep Infra -1. 前往 [Deep Infra 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 ``` -3. 輸入您的 Deep Infra API 密鑰。 +3. 輸入您的 Deep Infra API 金鑰。 ```txt ┌ API key @@ -572,7 +572,7 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro └ enter ``` -4. 執行 `/models` 命令選擇模型。 +4. 執行 `/models` 指令選擇模型。 ```txt /models @@ -582,15 +582,15 @@ 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` 命令並搜尋 **Firmware**。 +2. 執行 `/connect` 指令並搜尋 **Firmware**。 ```txt /connect ``` -3. 輸入您的 Firmware API 密鑰。 +3. 輸入您的 Firmware API 金鑰。 ```txt ┌ API key @@ -599,7 +599,7 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro └ enter ``` -4. 執行 `/models` 命令選擇模型。 +4. 執行 `/models` 指令選擇模型。 ```txt /models @@ -609,15 +609,15 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro ### Fireworks AI -1. 前往 [Fireworks AI console](https://app.fireworks.ai/)，創建一個帳戶，然後單擊 **Create API Key**。 +1. 前往 [Fireworks AI console](https://app.fireworks.ai/)，建立一個帳戶，然後單擊 **Create API Key**。 -2. 運行 `/connect` 命令並搜尋 **Fireworks AI**。 +2. 執行 `/connect` 指令並搜尋 **Fireworks AI**。 ```txt /connect ``` -3. 輸入您的 Fireworks AI API 密鑰。 +3. 輸入您的 Fireworks AI API 金鑰。 ```txt ┌ API key @@ -626,7 +626,7 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro └ enter ``` -4. 運行 `/models` 命令選擇一個模型，如 _Kimi K2 Instruct_。 +4. 執行 `/models` 指令選擇一個模型，如 _Kimi K2 Instruct_。 ```txt /models @@ -636,21 +636,22 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro ### GitLab Duo -GitLab Duo 通過 GitLab 的 Anthropic 代理提供具有本機工具調用功能的 AI 驅動的代理聊天。 +GitLab Duo 透過 GitLab 的 Anthropic 代理提供具有本機工具呼叫功能的 AI 驅動的代理聊天。 -1. 運行 `/connect` 命令並選擇 GitLab。 +1. 執行 `/connect` 指令並選擇 GitLab。 ```txt /connect ``` -2. 選擇您的身份驗證方法： +2. 選擇您的身分驗證方法： ```txt ┌ Select auth method │ │ OAuth (Recommended) │ Personal Access Token + │ └ ``` @@ -665,28 +666,28 @@ GitLab Duo 通過 GitLab 的 Anthropic 代理提供具有本機工具調用功 4. 複製令牌（以 `glpat-` 開頭） 5. 在終端機中輸入它 -3. 運行 `/models` 命令以查看可用模型。 +3. 執行 `/models` 指令以查看可用模型。 ```txt /models ``` 提供三種基於 Claude 的模型： - - **duo-chat-haiku-4-5**（Default）- 快速任務的快速響應 + - **duo-chat-haiku-4-5**（Default）- 快速任務的快速回應 - **duo-chat-sonnet-4-5** - 大多數工作流程的平衡性能 - **duo-chat-opus-4-5** - 最有能力進行複雜分析 :::note -如果您不想將令牌存儲在 OpenCode auth 存儲中，也可以指定 `GITLAB_TOKEN` 環境變量。 +如果您不想將令牌儲存在 OpenCode auth 儲存中，也可以指定 `GITLAB_TOKEN` 環境變數。 ::: -##### Self-Hosted GitLab +##### 自託管 GitLab -:::note[compliance note] -OpenCode 使用小型模型來執行某些 AI 任務，例如生成會話標題。 -默認情況下，它配置為使用 gpt-5-nano，由 Zen 託管。若要鎖定 OpenCode +:::note[合規性注意事項] +OpenCode 使用小型模型來執行某些 AI 任務，例如生成工作階段標題。 +預設情況下，它配置為使用 gpt-5-nano，由 Zen 託管。若要鎖定 OpenCode 僅使用您自己的 GitLab 託管實例，請將以下內容添加到您的 -`opencode.json` 文件。還建議禁用會話共享。 +`opencode.json` 檔案。還建議禁用工作階段分享。 ```json { @@ -705,13 +706,13 @@ export GITLAB_INSTANCE_URL=https://gitlab.company.com export GITLAB_TOKEN=glpat-... ``` -如果您的實例運行自定義 AI 網關： +如果您的實例執行自定義 AI 閘道： ```bash GITLAB_AI_GATEWAY_URL=https://ai-gateway.company.com ``` -或者添加到您的 bash 配置文件中： +或者添加到您的 bash 設定檔中： ```bash title="~/.bash_profile" export GITLAB_INSTANCE_URL=https://gitlab.company.com @@ -722,33 +723,33 @@ export GITLAB_TOKEN=glpat-... :::note 您的 GitLab 管理員必須啟用以下功能： -1. [Duo Agent Platform](https://docs.gitlab.com/user/gitlab_duo/turn_on_off/) 用於用戶、組或實例 -2. Feature flags（通過 Rails console）： +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 for Self-Hosted instances +##### 自託管實例的 OAuth -為了使 OAuth 適用於您的自託管實例，您需要創建 +為了使 OAuth 適用於您的自託管實例，您需要建立 一個新的應用程式（Settings → Applications），使用 回調 URL `http://127.0.0.1:8080/callback` 和以下範圍： -- api（代表您訪問 API） -- read_user（讀取您的個人信息） -- read_repository（允許對存儲庫進行只讀訪問） +- api（代表您存取 API） +- read_user（讀取您的個人資訊） +- read_repository（允許對儲存庫進行唯讀存取） -然後將應用程式 ID 公開為環境變量： +然後將應用程式 ID 公開為環境變數： ```bash export GITLAB_OAUTH_CLIENT_ID=your_application_id_here ``` -更多文檔請參見 [opencode-gitlab-auth](https://www.npmjs.com/package/@gitlab/opencode-gitlab-auth) 主頁。 +更多文件請參見 [opencode-gitlab-auth](https://www.npmjs.com/package/@gitlab/opencode-gitlab-auth) 主頁。 -##### Configuration +##### 配置 -通過 `opencode.json` 定制： +透過 `opencode.json` 定制： ```json title="opencode.json" { @@ -769,7 +770,7 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here ##### GitLab API Tools（可選，但強烈推薦） -要訪問 GitLab 工具（merge requests、issues、pipelines、CI/CD 等）： +要存取 GitLab 工具（merge requests、issues、pipelines、CI/CD 等）： ```json title="opencode.json" { @@ -778,7 +779,7 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here } ``` -該插件提供全面的 GitLab 存儲庫管理功能，包括 MR 審查、問題跟踪、管道監控等。 +該外掛提供全面的 GitLab 儲存庫管理功能，包括 MR 審閱、問題追蹤、管線監控等。 --- @@ -791,13 +792,13 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here 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 @@ -809,7 +810,7 @@ subscription](https://github.com/features/copilot/plans) 來使用。 └ Waiting for authorization... ``` -3. 現在運行 `/models` 命令來選擇您想要的模型。 +3. 現在執行 `/models` 指令來選擇您想要的模型。 ```txt /models @@ -825,23 +826,23 @@ subscription](https://github.com/features/copilot/plans) 來使用。 您所在地區提供的模型。 :::note - 您需要有一個啟用了 Vertex AI API 的 Google Cloud 項目。 + 您需要有一個啟用了 Vertex AI API 的 Google Cloud 專案。 ::: -2. 設置所需的環境變量： - - `GOOGLE_CLOUD_PROJECT`：您的 Google Cloud 項目 ID - - `VERTEX_LOCATION`（可選）：Vertex AI 的區域（默認為 `global`） - - 身份驗證（選擇一項）： +2. 設定所需的環境變數： + - `GOOGLE_CLOUD_PROJECT`：您的 Google Cloud 專案 ID + - `VERTEX_LOCATION`（可選）：Vertex AI 的區域（預設為 `global`） + - 身分驗證（選擇一項）： - `GOOGLE_APPLICATION_CREDENTIALS`：Path to your service account JSON key file - Authenticate using gcloud CLI: `gcloud auth application-default login` - 在運行 opencode 時設置它們。 + 在執行 opencode 時設定它們。 ```bash GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json GOOGLE_CLOUD_PROJECT=your-project-id opencode ``` - 或者將它們添加到您的 bash 配置文件中。 + 或者將它們添加到您的 bash 設定檔中。 ```bash title="~/.bash_profile" export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json @@ -850,10 +851,10 @@ subscription](https://github.com/features/copilot/plans) 來使用。 ``` :::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 @@ -863,15 +864,15 @@ subscription](https://github.com/features/copilot/plans) 來使用。 ### Groq -1. 前往 [Groq console](https://console.groq.com/)，單擊 **Create API Key**，然後複製密鑰。 +1. 前往 [Groq console](https://console.groq.com/)，單擊 **Create API Key**，然後複製金鑰。 -2. 運行 `/connect` 命令並搜尋 Groq。 +2. 執行 `/connect` 指令並搜尋 Groq。 ```txt /connect ``` -3. 輸入提供商的 API 密鑰。 +3. 輸入供應商的 API 金鑰。 ```txt ┌ API key @@ -880,7 +881,7 @@ subscription](https://github.com/features/copilot/plans) 來使用。 └ enter ``` -4. 運行 `/models` 命令選擇您想要的。 +4. 執行 `/models` 指令選擇您想要的。 ```txt /models @@ -890,11 +891,11 @@ subscription](https://github.com/features/copilot/plans) 來使用。 ### Hugging Face -[Hugging Face Inference Providers](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) 創建一個具有調用 Inference Providers 權限的令牌。 +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 @@ -909,7 +910,7 @@ subscription](https://github.com/features/copilot/plans) 來使用。 └ enter ``` -4. 運行 `/models` 命令來選擇模型，如 _Kimi-K2-Instruct_ 或 _GLM-4.6_。 +4. 執行 `/models` 指令來選擇模型，如 _Kimi-K2-Instruct_ 或 _GLM-4.6_。 ```txt /models @@ -919,17 +920,17 @@ subscription](https://github.com/features/copilot/plans) 來使用。 ### Helicone -[Helicone](https://helicone.ai) 是一個 LLM 可觀察性平台，可為您的 AI 應用程式提供日誌記錄、監控和分析。 The 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 ``` -3. 輸入您的 Helicone API 密鑰。 +3. 輸入您的 Helicone API 金鑰。 ```txt ┌ API key @@ -938,17 +939,17 @@ subscription](https://github.com/features/copilot/plans) 來使用。 └ enter ``` -4. 執行 `/models` 命令選擇模型。 +4. 執行 `/models` 指令選擇模型。 ```txt /models ``` -有關更多提供商和高級功能（例如緩存和速率限制），請查看 [Helicone documentation](https://docs.helicone.ai)。 +有關更多供應商和高級功能（例如快取和速率限制），請查看 [Helicone documentation](https://docs.helicone.ai)。 -#### Optional Configs +#### 可選配置 -如果您發現 Helicone 的功能或模型未通過 OpenCode 自動配置，您始終可以自行配置。 +如果您發現 Helicone 的功能或模型未透過 OpenCode 自動配置，您始終可以自行配置。 這是 [Helicone's Model Directory](https://helicone.ai/models)，您將需要它來獲取要添加的模型的 ID。 @@ -976,9 +977,9 @@ subscription](https://github.com/features/copilot/plans) 來使用。 } ``` -#### Custom Headers +#### 自定義標頭 -Helicone 支持緩存、用戶跟踪和會話管理等功能的自定義標頭。使用 `options.headers` 將它們添加到您的提供商配置中： +Helicone 支援快取、使用者追蹤和工作階段管理等功能的自定義標頭。使用 `options.headers` 將它們添加到您的供應商配置中： ```jsonc title="~/.config/opencode/opencode.jsonc" { @@ -999,9 +1000,9 @@ Helicone 支持緩存、用戶跟踪和會話管理等功能的自定義標頭 } ``` -##### Session tracking +##### 工作階段追蹤 -Helicone 的 [Sessions](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) 外掛自動將每個 OpenCode 對話記錄為 Helicone 中的工作階段。 ```bash npm install -g opencode-helicone-session @@ -1015,14 +1016,14 @@ npm install -g opencode-helicone-session } ``` -該插件將 `Helicone-Session-Id` 和 `Helicone-Session-Name` 標頭注入您的請求中。在 Helicone 的 Sessions 頁面中，您將看到每個 OpenCode 對話都列為單獨的會話。 +該外掛將 `Helicone-Session-Id` 和 `Helicone-Session-Name` 標頭注入您的請求中。在 Helicone 的 Sessions 頁面中，您將看到每個 OpenCode 對話都列為單獨的工作階段。 -##### Common Helicone headers +##### 常見 Helicone 標頭 | Header | Description | | -------------------------- | ------------------------------------------------------ | -| `Helicone-Cache-Enabled` | 啟用響應緩存 (`true`/`false`) | -| `Helicone-User-Id` | 按用戶跟踪指標 | +| `Helicone-Cache-Enabled` | 啟用回應快取 (`true`/`false`) | +| `Helicone-User-Id` | 按使用者追蹤指標 | | `Helicone-Property-[Name]` | 添加自定義屬性（例如 `Helicone-Property-Environment`） | | `Helicone-Prompt-Id` | 將請求與提示版本相關聯 | @@ -1032,7 +1033,7 @@ npm install -g opencode-helicone-session ### llama.cpp -您可以通過 [llama.cpp's](https://github.com/ggml-org/llama.cpp) llama-server 實用程序配置 OpenCode 以使用本地模型 +您可以透過 [llama.cpp's](https://github.com/ggml-org/llama.cpp) llama-server 公用程式配置 OpenCode 以使用本地模型 ```json title="opencode.json" "llama.cpp" {5, 6, 8, 10-15} { @@ -1060,27 +1061,27 @@ npm install -g opencode-helicone-session 在這個例子中： -- `llama.cpp` 是自定義提供商 ID。這可以是您想要的任何字符串。 -- `npm` 指定用於此提供商的包。這裡，`@ai-sdk/openai-compatible` 用於任何 OpenAI 兼容的 API。 -- `name` 是 UI 中提供商的顯示名稱。 -- `options.baseURL` 是本地服務器的端點。 -- `models` 是模型 ID 與其配置的映射。模型名稱將顯示在模型選擇列表中。 +- `llama.cpp` 是自定義供應商 ID。這可以是您想要的任何字串。 +- `npm` 指定用於此供應商的套件。這裡，`@ai-sdk/openai-compatible` 用於任何 OpenAI 相容的 API。 +- `name` 是 UI 中供應商的顯示名稱。 +- `options.baseURL` 是本地伺服器的端點。 +- `models` 是模型 ID 與其配置的對應。模型名稱將顯示在模型選擇列表中。 --- ### IO.NET -IO.NET 提供了 17 種針對各種用例進行優化的模型： +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 ``` -3. 輸入您的 IO.NET API 密鑰。 +3. 輸入您的 IO.NET API 金鑰。 ```txt ┌ API key @@ -1089,7 +1090,7 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型： └ enter ``` -4. 執行 `/models` 命令選擇模型。 +4. 執行 `/models` 指令選擇模型。 ```txt /models @@ -1099,7 +1100,7 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型： ### LM Studio -您可以通過 LM Studio 配置 OpenCode 以使用本地模型。 +您可以透過 LM Studio 配置 OpenCode 以使用本地模型。 ```json title="opencode.json" "lmstudio" {5, 6, 8, 10-14} { @@ -1123,11 +1124,11 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型： 在這個例子中： -- `lmstudio` 是自定義提供商 ID。這可以是您想要的任何字符串。 -- `npm` 指定用於此提供商的包。這裡，`@ai-sdk/openai-compatible` 用於任何 OpenAI 兼容的 API。 -- `name` 是 UI 中提供商的顯示名稱。 -- `options.baseURL` 是本地服務器的端點。 -- `models` 是模型 ID 與其配置的映射。模型名稱將顯示在模型選擇列表中。 +- `lmstudio` 是自定義供應商 ID。這可以是您想要的任何字串。 +- `npm` 指定用於此供應商的套件。這裡，`@ai-sdk/openai-compatible` 用於任何 OpenAI 相容的 API。 +- `name` 是 UI 中供應商的顯示名稱。 +- `options.baseURL` 是本地伺服器的端點。 +- `models` 是模型 ID 與其配置的對應。模型名稱將顯示在模型選擇列表中。 --- @@ -1135,15 +1136,15 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型： 要使用 Moonshot AI 中的 Kimi K2： -1. 前往 [Moonshot AI console](https://platform.moonshot.ai/console)，創建一個帳戶，然後單擊 **Create API key**。 +1. 前往 [Moonshot AI console](https://platform.moonshot.ai/console)，建立一個帳戶，然後單擊 **Create API key**。 -2. 運行 `/connect` 命令並搜尋 **Moonshot AI**。 +2. 執行 `/connect` 指令並搜尋 **Moonshot AI**。 ```txt /connect ``` -3. 輸入您的 Moonshot API 密鑰。 +3. 輸入您的 Moonshot API 金鑰。 ```txt ┌ API key @@ -1152,7 +1153,7 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型： └ enter ``` -4. 運行 `/models` 命令選擇 _Kimi K2_。 +4. 執行 `/models` 指令選擇 _Kimi K2_。 ```txt /models @@ -1162,15 +1163,15 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型： ### MiniMax -1. 前往 [MiniMax API Console](https://platform.minimax.io/login)，創建一個帳戶並生成一個 API 密鑰。 +1. 前往 [MiniMax API Console](https://platform.minimax.io/login)，建立一個帳戶並生成一個 API 金鑰。 -2. 運行 `/connect` 命令並搜尋 **MiniMax**。 +2. 執行 `/connect` 指令並搜尋 **MiniMax**。 ```txt /connect ``` -3. 輸入您的 MiniMax API 密鑰。 +3. 輸入您的 MiniMax API 金鑰。 ```txt ┌ API key @@ -1179,7 +1180,7 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型： └ enter ``` -4. 運行 `/models` 命令選擇模型，如 _M2.1_。 +4. 執行 `/models` 指令選擇模型，如 _M2.1_。 ```txt /models @@ -1189,15 +1190,15 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型： ### Nebius Token Factory -1. 前往 [Nebius Token Factory console](https://tokenfactory.nebius.com/)，創建一個帳戶，然後單擊 **Add Key**。 +1. 前往 [Nebius Token Factory console](https://tokenfactory.nebius.com/)，建立一個帳戶，然後單擊 **Add Key**。 -2. 運行 `/connect` 命令並搜尋 **Nebius Token Factory**。 +2. 執行 `/connect` 指令並搜尋 **Nebius Token Factory**。 ```txt /connect ``` -3. 輸入您的 Nebius Token Factory API 密鑰。 +3. 輸入您的 Nebius Token Factory API 金鑰。 ```txt ┌ API key @@ -1206,7 +1207,7 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型： └ enter ``` -4. 運行 `/models` 命令選擇一個模型，如 _Kimi K2 Instruct_。 +4. 執行 `/models` 指令選擇一個模型，如 _Kimi K2 Instruct_。 ```txt /models @@ -1216,7 +1217,7 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型： ### Ollama -您可以通過 Ollama 配置 OpenCode 以使用本地模型。 +您可以透過 Ollama 配置 OpenCode 以使用本地模型。 :::tip Ollama 可以自動為 OpenCode 配置自身。詳情請參閱 [Ollama integration docs](https://docs.ollama.com/integrations/opencode)。 @@ -1244,14 +1245,14 @@ Ollama 可以自動為 OpenCode 配置自身。詳情請參閱 [Ollama integrati 在這個例子中： -- `ollama` 是自定義提供商 ID。這可以是您想要的任何字符串。 -- `npm` 指定用於此提供商的包。這裡，`@ai-sdk/openai-compatible` 用於任何 OpenAI 兼容的 API。 -- `name` 是 UI 中提供商的顯示名稱。 -- `options.baseURL` 是本地服務器的端點。 -- `models` 是模型 ID 與其配置的映射。模型名稱將顯示在模型選擇列表中。 +- `ollama` 是自定義供應商 ID。這可以是您想要的任何字串。 +- `npm` 指定用於此供應商的套件。這裡，`@ai-sdk/openai-compatible` 用於任何 OpenAI 相容的 API。 +- `name` 是 UI 中供應商的顯示名稱。 +- `options.baseURL` 是本地伺服器的端點。 +- `models` 是模型 ID 與其配置的對應。模型名稱將顯示在模型選擇列表中。 :::tip -如果工具調用不起作用，請嘗試增加 Ollama 中的 `num_ctx`。從 16k - 32k 左右開始。 +如果工具呼叫不起作用，請嘗試增加 Ollama 中的 `num_ctx`。從 16k - 32k 左右開始。 ::: --- @@ -1260,19 +1261,19 @@ Ollama 可以自動為 OpenCode 配置自身。詳情請參閱 [Ollama integrati 要將 Ollama Cloud 與 OpenCode 結合使用： -1. 前往 [https://ollama.com/](https://ollama.com/) 並登錄或創建帳戶。 +1. 前往 [https://ollama.com/](https://ollama.com/) 並登入或建立帳戶。 -2. 導航到 **Settings** > **Keys**，然後單擊 **Add API Key** 以生成新的 API 密鑰。 +2. 導覽到 **Settings** > **Keys**，然後單擊 **Add API Key** 以生成新的 API 金鑰。 -3. 複製 API 密鑰以在 OpenCode 中使用。 +3. 複製 API 金鑰以在 OpenCode 中使用。 -4. 運行 `/connect` 命令並搜尋 **Ollama Cloud**。 +4. 執行 `/connect` 指令並搜尋 **Ollama Cloud**。 ```txt /connect ``` -5. 輸入您的 Ollama Cloud API 密鑰。 +5. 輸入您的 Ollama Cloud API 金鑰。 ```txt ┌ API key @@ -1281,13 +1282,13 @@ Ollama 可以自動為 OpenCode 配置自身。詳情請參閱 [Ollama integrati └ enter ``` -6. **Important**：在 OpenCode 中使用雲模型之前，您必須將模型信息拉取到本地： +6. **Important**：在 OpenCode 中使用雲端模型之前，您必須將模型資訊拉取到本地： ```bash ollama pull gpt-oss:20b-cloud ``` -7. 運行 `/models` 命令以選擇您的 Ollama Cloud 模型。 +7. 執行 `/models` 指令以選擇您的 Ollama Cloud 模型。 ```txt /models @@ -1299,14 +1300,14 @@ Ollama 可以自動為 OpenCode 配置自身。詳情請參閱 [Ollama integrati 我們建議註冊 [ChatGPT Plus or Pro](https://chatgpt.com/pricing)。 -1. 註冊後，運行 `/connect` 命令並選擇 OpenAI。 +1. 註冊後，執行 `/connect` 指令並選擇 OpenAI。 ```txt /connect ``` 2. 在這裡您可以選擇 **ChatGPT Plus/Pro** 選項，它將打開您的瀏覽器 - 並要求您進行身份驗證。 + 並要求您進行身分驗證。 ```txt ┌ Select auth method @@ -1316,15 +1317,15 @@ Ollama 可以自動為 OpenCode 配置自身。詳情請參閱 [Ollama integrati └ ``` -3. 現在，當您使用 `/models` 命令時，所有 OpenAI 模型都應該可用。 +3. 現在，當您使用 `/models` 指令時，所有 OpenAI 模型都應該可用。 ```txt /models ``` -##### 使用 API 密鑰 +##### 使用 API 金鑰 -如果您已有 API 密鑰，可以選擇 **Manually enter API Key** 並將其粘貼到您的終端機中。 +如果您已有 API 金鑰，可以選擇 **Manually enter API Key** 並將其貼上到您的終端機中。 --- @@ -1332,15 +1333,15 @@ Ollama 可以自動為 OpenCode 配置自身。詳情請參閱 [Ollama integrati OpenCode Zen 是 OpenCode 團隊提供的經過測試和驗證的模型列表。 [了解更多](/docs/zen)。 -1. 登錄 **OpenCode Zen** 並單擊 **Create API Key**。 +1. 登入 **OpenCode Zen** 並單擊 **Create API Key**。 -2. 運行 `/connect` 命令並搜尋 **OpenCode Zen**。 +2. 執行 `/connect` 指令並搜尋 **OpenCode Zen**。 ```txt /connect ``` -3. 輸入您的 OpenCode API 密鑰。 +3. 輸入您的 OpenCode API 金鑰。 ```txt ┌ API key @@ -1349,7 +1350,7 @@ OpenCode Zen 是 OpenCode 團隊提供的經過測試和驗證的模型列表。 └ enter ``` -4. 運行 `/models` 命令選擇模型，如 _Qwen 3 Coder 480B_。 +4. 執行 `/models` 指令選擇模型，如 _Qwen 3 Coder 480B_。 ```txt /models @@ -1359,15 +1360,15 @@ OpenCode Zen 是 OpenCode 團隊提供的經過測試和驗證的模型列表。 ### OpenRouter -1. 前往 [OpenRouter dashboard](https://openrouter.ai/settings/keys)，單擊 **Create API Key**，然後複製密鑰。 +1. 前往 [OpenRouter dashboard](https://openrouter.ai/settings/keys)，單擊 **Create API Key**，然後複製金鑰。 -2. 運行 `/connect` 命令並搜尋 OpenRouter。 +2. 執行 `/connect` 指令並搜尋 OpenRouter。 ```txt /connect ``` -3. 輸入提供商的 API 密鑰。 +3. 輸入供應商的 API 金鑰。 ```txt ┌ API key @@ -1376,13 +1377,13 @@ OpenCode Zen 是 OpenCode 團隊提供的經過測試和驗證的模型列表。 └ enter ``` -4. 許多 OpenRouter 模型是默認預加載的，運行 `/models` 命令選擇您想要的模型。 +4. 許多 OpenRouter 模型是預設預先載入的，執行 `/models` 指令選擇您想要的模型。 ```txt /models ``` - 您還可以通過 OpenCode 配置添加其他模型。 + 您還可以透過 OpenCode 配置添加其他模型。 ```json title="opencode.json" {6} { @@ -1397,7 +1398,7 @@ OpenCode Zen 是 OpenCode 團隊提供的經過測試和驗證的模型列表。 } ``` -5. 您還可以通過 OpenCode 配置自定義它們。這是指定提供商的示例 +5. 您還可以透過 OpenCode 配置自定義它們。這是指定供應商的範例 ```json title="opencode.json" { @@ -1423,21 +1424,21 @@ OpenCode Zen 是 OpenCode 團隊提供的經過測試和驗證的模型列表。 ### SAP AI Core -SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、Meta、Mistral 和 AI21 的 40 多個模型的訪問。 +SAP AI Core 透過統一平台提供對 OpenAI、Anthropic、Google、Amazon、Meta、Mistral 和 AI21 的 40 多個模型的存取。 -1. 轉到您的 [SAP BTP Cockpit](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 的 **Services** > **Instances and Subscriptions** 下找到您的 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 ``` -3. 輸入您的服務密鑰 JSON。 +3. 輸入您的服務金鑰 JSON。 ```txt ┌ Service key @@ -1446,29 +1447,29 @@ 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 ``` - 或者將其添加到您的 bash 配置文件中： + 或者將其添加到您的 bash 設定檔中： ```bash title="~/.bash_profile" export AICORE_SERVICE_KEY='{"clientid":"...","clientsecret":"...","url":"...","serviceurls":{"AI_API_URL":"..."}}' ``` -4. （可選）設置部署 ID 和資源組： +4. （可選）設定部署 ID 和資源組： ```bash AICORE_DEPLOYMENT_ID=your-deployment-id AICORE_RESOURCE_GROUP=your-resource-group opencode ``` :::note - 這些設置是可選的，應根據您的 SAP AI Core 設置進行配置。 + 這些設定是可選的，應根據您的 SAP AI Core 設定進行配置。 ::: -5. 運行 `/models` 命令從 40 多個可用模型中進行選擇。 +5. 執行 `/models` 指令從 40 多個可用模型中進行選擇。 ```txt /models @@ -1478,15 +1479,15 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M ### OVHcloud AI Endpoints -1. 前往 [OVHcloud panel](https://ovh.com/manager)。導航到 `Public Cloud` 部分，`AI & Machine Learning` > `AI Endpoints`，然後在 `API Keys` 選項卡中單擊 **Create a new API key**。 +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 ``` -3. 輸入您的 OVHcloud AI Endpoints API 密鑰。 +3. 輸入您的 OVHcloud AI Endpoints API 金鑰。 ```txt ┌ API key @@ -1495,7 +1496,7 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M └ enter ``` -4. 運行 `/models` 命令選擇模型，如 _gpt-oss-120b_。 +4. 執行 `/models` 指令選擇模型，如 _gpt-oss-120b_。 ```txt /models @@ -1507,15 +1508,15 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M 要將 [Scaleway Generative APIs](https://www.scaleway.com/en/docs/generative-apis/) 與 OpenCode 一起使用： -1. 前往 [Scaleway Console IAM settings](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 ``` -3. 輸入您的 Scaleway API 密鑰。 +3. 輸入您的 Scaleway API 金鑰。 ```txt ┌ API key @@ -1524,7 +1525,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 @@ -1534,15 +1535,15 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M ### Together AI -1. 前往 [Together AI console](https://api.together.ai)，創建一個帳戶，然後單擊 **Add Key**。 +1. 前往 [Together AI console](https://api.together.ai)，建立一個帳戶，然後單擊 **Add Key**。 -2. 運行 `/connect` 命令並搜尋 **Together AI**。 +2. 執行 `/connect` 指令並搜尋 **Together AI**。 ```txt /connect ``` -3. 輸入您的 Together AI API 密鑰。 +3. 輸入您的 Together AI API 金鑰。 ```txt ┌ API key @@ -1551,7 +1552,7 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M └ enter ``` -4. 運行 `/models` 命令選擇一個模型，如 _Kimi K2 Instruct_。 +4. 執行 `/models` 指令選擇一個模型，如 _Kimi K2 Instruct_。 ```txt /models @@ -1561,15 +1562,15 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M ### 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 ``` -3. 輸入您的 Venice AI API 密鑰。 +3. 輸入您的 Venice AI API 金鑰。 ```txt ┌ API key @@ -1578,7 +1579,7 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M └ enter ``` -4. 運行 `/models` 命令選擇模型，如 _Llama 3.3 70B_。 +4. 執行 `/models` 指令選擇模型，如 _Llama 3.3 70B_。 ```txt /models @@ -1588,17 +1589,17 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M ### 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 keys** 以創建新的 API 密鑰。 +1. 前往 [Vercel dashboard](https://vercel.com/)，導覽至 **AI Gateway** 選項卡，然後單擊 **API keys** 以建立新的 API 金鑰。 -2. 運行 `/connect` 命令並搜尋 **Vercel AI Gateway**。 +2. 執行 `/connect` 指令並搜尋 **Vercel AI Gateway**。 ```txt /connect ``` -3. 輸入您的 Vercel AI Gateway API 密鑰。 +3. 輸入您的 Vercel AI Gateway API 金鑰。 ```txt ┌ API key @@ -1607,13 +1608,13 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G └ enter ``` -4. 執行 `/models` 命令選擇模型。 +4. 執行 `/models` 指令選擇模型。 ```txt /models ``` -您還可以通過 OpenCode 配置自定義模型。以下是指定提供者路由順序的示例。 +您還可以透過 OpenCode 配置自定義模型。以下是指定供應商路由順序的範例。 ```json title="opencode.json" { @@ -1644,15 +1645,15 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G ### xAI -1. 前往 [xAI console](https://console.x.ai/)，創建一個帳戶並生成一個 API 密鑰。 +1. 前往 [xAI console](https://console.x.ai/)，建立一個帳戶並生成一個 API 金鑰。 -2. 運行 `/connect` 命令並搜尋 **xAI**。 +2. 執行 `/connect` 指令並搜尋 **xAI**。 ```txt /connect ``` -3. 輸入您的 xAI API 密鑰。 +3. 輸入您的 xAI API 金鑰。 ```txt ┌ API key @@ -1661,7 +1662,7 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G └ enter ``` -4. 運行 `/models` 命令選擇一個模型，如 _Grok Beta_。 +4. 執行 `/models` 指令選擇一個模型，如 _Grok Beta_。 ```txt /models @@ -1671,9 +1672,9 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G ### Z.AI -1. 前往 [Z.AI API console](https://z.ai/manage-apikey/apikey-list)，創建一個帳戶，然後單擊 **Create a new API key**。 +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 @@ -1681,7 +1682,7 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G 如果您訂閱了 **GLM Coding Plan**，請選擇 **Z.AI Coding Plan**。 -3. 輸入您的 Z.AI API 密鑰。 +3. 輸入您的 Z.AI API 金鑰。 ```txt ┌ API key @@ -1690,7 +1691,7 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G └ enter ``` -4. 運行 `/models` 命令選擇 _GLM-4.7_ 等模型。 +4. 執行 `/models` 指令選擇 _GLM-4.7_ 等模型。 ```txt /models @@ -1700,15 +1701,15 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G ### ZenMux -1. 前往 [ZenMux dashboard](https://zenmux.ai/settings/keys)，單擊 **Create API Key**，然後複製密鑰。 +1. 前往 [ZenMux dashboard](https://zenmux.ai/settings/keys)，單擊 **Create API Key**，然後複製金鑰。 -2. 運行 `/connect` 命令並搜尋 ZenMux。 +2. 執行 `/connect` 指令並搜尋 ZenMux。 ```txt /connect ``` -3. 輸入提供商的 API 密鑰。 +3. 輸入供應商的 API 金鑰。 ```txt ┌ API key @@ -1717,13 +1718,13 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G └ enter ``` -4. 默認情況下預加載了許多 ZenMux 模型，運行 `/models` 命令選擇您想要的模型。 +4. 預設情況下預先載入了許多 ZenMux 模型，執行 `/models` 指令選擇您想要的模型。 ```txt /models ``` - 您還可以通過 OpenCode 配置添加其他模型。 + 您還可以透過 OpenCode 配置添加其他模型。 ```json title="opencode.json" {6} { @@ -1740,15 +1741,15 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G --- -## Custom provider +## 自定義供應商 -要添加 `/connect` 命令中未列出的任何 **OpenAI-compatible** 提供商： +要添加 `/connect` 指令中未列出的任何 **OpenAI-compatible** 供應商： :::tip -您可以將任何與 OpenAI 兼容的提供商與 OpenCode 結合使用。大多數現代 AI 提供商都提供與 OpenAI 兼容的 API。 +您可以將任何與 OpenAI 相容的供應商與 OpenCode 結合使用。大多數現代 AI 供應商都提供與 OpenAI 相容的 API。 ::: -1. 運行 `/connect` 命令並向下滾動到 **Other**。 +1. 執行 `/connect` 指令並向下捲動到 **Other**。 ```bash $ /connect @@ -1761,7 +1762,7 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G └ ``` -2. 輸入提供商的唯一 ID。 +2. 輸入供應商的唯一 ID。 ```bash $ /connect @@ -1774,10 +1775,10 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G ``` :::note - 選擇一個容易記住的 ID，您將在配置文件中使用它。 + 選擇一個容易記住的 ID，您將在設定檔中使用它。 ::: -3. 輸入提供商的 API 密鑰。 +3. 輸入供應商的 API 金鑰。 ```bash $ /connect @@ -1791,7 +1792,7 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G └ ``` -4. 在項目目錄中創建或更新 `opencode.json` 文件： +4. 在專案目錄中建立或更新 `opencode.json` 檔案： ```json title="opencode.json" ""myprovider"" {5-15} { @@ -1814,22 +1815,22 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G ``` 以下是配置選項： - - **npm**：要使用的 AI SDK 包，`@ai-sdk/openai-compatible` 用於 OpenAI 兼容提供商 + - **npm**：要使用的 AI SDK 套件，`@ai-sdk/openai-compatible` 用於 OpenAI 相容供應商 - **name**：UI 中的顯示名稱。 - **models**：可用模型。 - **options.baseURL**：API 端點 URL。 - - **options.apiKey**：如果不使用身份驗證，可以選擇設置 API 密鑰。 - - **options.headers**：可選擇設置自定義標頭。 + - **options.apiKey**：如果不使用身分驗證，可以選擇設定 API 金鑰。 + - **options.headers**：可選擇設定自定義標頭。 - 有關高級選項的更多信息，請參見下面的示例。 + 有關高級選項的更多資訊，請參見下面的範例。 -5. 運行 `/models` 命令，您的自定義提供商和模型將出現在選擇列表中。 +5. 執行 `/models` 指令，您的自定義供應商和模型將出現在選擇列表中。 --- -##### Example +##### 範例 -以下是設置 `apiKey`、`headers` 和模型 `limit` 選項的示例。 +以下是設定 `apiKey`、`headers` 和模型 `limit` 選項的範例。 ```json title="opencode.json" {9,11,17-20} { @@ -1861,25 +1862,25 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G 配置詳情： -- **apiKey**：使用 `env` 變量語法 [了解更多](/docs/config#env-vars) 設置。 +- **apiKey**：使用 `env` 變數語法 [了解更多](/docs/config#env-vars) 設定。 - **headers**：隨每個請求發送的自定義標頭。 -- **limit.context**：模型接受的最大輸入標記。 -- **limit.output**：模型可以生成的最大令牌。 +- **limit.context**：模型接受的最大輸入 tokens。 +- **limit.output**：模型可以生成的最大 tokens。 -`limit` 字段允許 OpenCode 了解您還剩下多少上下文。標準提供商會自動從 models.dev 中提取這些內容。 +`limit` 欄位允許 OpenCode 了解您還剩下多少上下文。標準供應商會自動從 models.dev 中提取這些內容。 --- -## Troubleshooting +## 疑難排解 -如果您在配置提供商時遇到問題，請檢查以下內容： +如果您在配置供應商時遇到問題，請檢查以下內容： -1. **Check the auth setup**：運行 `opencode auth list` 以查看憑據是否 - 提供商的配置已添加到您的配置中。 +1. **檢查 auth 設定**：執行 `opencode auth list` 以查看憑證是否 + 供應商的配置已添加到您的配置中。 - 這不適用於 Amazon Bedrock 等依賴環境變量進行身份驗證的提供商。 + 這不適用於 Amazon Bedrock 等依賴環境變數進行身分驗證的供應商。 -2. 對於自定義提供商，請檢查 OpenCode 配置並： - - 確保 `/connect` 命令中使用的提供商 ID 與 OpenCode 配置中的 ID 匹配。 - - 正確的 npm 包用於提供商。例如，對 Cerebras 使用 `@ai-sdk/cerebras`。對於所有其他 OpenAI 兼容提供商，請使用 `@ai-sdk/openai-compatible`。 - - 檢查 `options.baseURL` 字段中使用了正確的 API 端點。 +2. 對於自定義供應商，請檢查 OpenCode 配置並： + - 確保 `/connect` 指令中使用的供應商 ID 與 OpenCode 配置中的 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 218fd3c78..2ce0c327b 100644 --- a/packages/web/src/content/docs/zh-tw/rules.mdx +++ b/packages/web/src/content/docs/zh-tw/rules.mdx @@ -1,29 +1,29 @@ --- title: 規則 -description: 設置opencode的自定義指令。 +description: 設定 opencode 的自定義指令。 --- -您可以通過創建 `AGENTS.md` 文件來提供 opencode 的自定義指令。這和Cursor的規則類似。它包含將包含在 LLM 上下文中的說明，以便為您的特定項目自定義其行為。 +您可以透過建立 `AGENTS.md` 檔案來提供 opencode 的自定義指令。這和 Cursor 的規則類似。它包含將包含在 LLM 上下文中的說明，以便為您的特定專案自定義其行為。 --- ## 初始化 -要創建新的`AGENTS.md`文件，您可以在opencode中運行`/init`命令。 +要建立新的 `AGENTS.md` 檔案，您可以在 opencode 中執行 `/init` 指令。 :::tip -您應該將項目的 `AGENTS.md` 文件提交到 Git。 +您應該將專案的 `AGENTS.md` 檔案提交到 Git。 ::: -這將掃描您的項目及其所有內容，以了解該項目的內容並生成一個 `AGENTS.md` 文件。這有助於 opencode 更好地導航項目。 +這將掃描您的專案及其所有內容，以了解該專案的內容並生成一個 `AGENTS.md` 檔案。這有助於 opencode 更好地導覽專案。 -如果您有現有的 `AGENTS.md` 文件，這將嘗試添加到其中。 +如果您有現有的 `AGENTS.md` 檔案，這將嘗試添加到其中。 --- -## 例子 +## 範例 -您也可以手動創建此文件。以下是您可以放入 `AGENTS.md` 文件中的一些內容的示例。 +您也可以手動建立此檔案。以下是您可以放入 `AGENTS.md` 檔案中的一些內容的範例。 ```markdown title="AGENTS.md" # SST v3 Monorepo Project @@ -48,33 +48,33 @@ This is an SST v3 monorepo with TypeScript. The project uses bun workspaces for - Import shared modules using workspace names: `@my-app/core/example` ``` -我們在此處添加特定於項目的說明，這將在您的團隊中共享。 +我們在此處添加特定於專案的說明，這將在您的團隊中共享。 --- ## 類型 -opencode 還支持從多個位置讀取 `AGENTS.md` 文件。這有不同的目的。 +opencode 還支援從多個位置讀取 `AGENTS.md` 檔案。這有不同的目的。 ### 專案 -將 `AGENTS.md` 放置在項目根目錄中以獲取特定於項目的規則。這些僅適用於您在此目錄或其子目錄中工作時。 +將 `AGENTS.md` 放置在專案根目錄中以獲取特定於專案的規則。這些僅適用於您在此目錄或其子目錄中工作時。 -### 全球的 +### 全域 -您還可以在 `~/.config/opencode/AGENTS.md` 文件中包含全局規則。這適用於所有opencode會話。 +您還可以在 `~/.config/opencode/AGENTS.md` 檔案中包含全域規則。這適用於所有 opencode 工作階段。 由於這未提交給 Git 或與您的團隊共享，因此我們建議使用它來指定 LLM 應遵循的任何個人規則。 -### 克勞德程式碼兼容性 +### Claude Code 相容性 -對於從 Claude Code 遷移的用戶，opencode 支持 Claude Code 的文件約定作為後備： +對於從 Claude Code 遷移的使用者，opencode 支援 Claude Code 的檔案慣例作為備援： -- **項目規則**：項目目錄中的`CLAUDE.md`（如果`AGENTS.md`不存在則使用） -- **全局規則**：`~/.claude/CLAUDE.md`（如果不存在`~/.config/opencode/AGENTS.md`則使用） -- **技能**：`~/.claude/skills/` — 詳情請參閱[代理技巧](/docs/skills/) +- **專案規則**：專案目錄中的 `CLAUDE.md`（如果 `AGENTS.md` 不存在則使用） +- **全域規則**：`~/.claude/CLAUDE.md`（如果不存在 `~/.config/opencode/AGENTS.md` 則使用） +- **技能**：`~/.claude/skills/` — 詳情請參閱 [代理技能](/docs/skills/) -要禁用 Claude Code 兼容性，請設置以下環境變量之一： +要禁用 Claude Code 相容性，請設定以下環境變數之一： ```bash export OPENCODE_DISABLE_CLAUDE_CODE=1 # Disable all .claude support @@ -84,23 +84,23 @@ export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills --- -## 優先級 +## 優先順序 -當 opencode 啟動時，它會按以下順序查找規則文件： +當 opencode 啟動時，它會按以下順序尋找規則檔案： -1. **本地文件**，從當前目錄向上遍歷(`AGENTS.md`,`CLAUDE.md`) -2. **全局文件** `~/.config/opencode/AGENTS.md` -3. **克勞德程式碼文件**位於`~/.claude/CLAUDE.md`（除非禁用） +1. **本地檔案**，從當前目錄向上遍歷 (`AGENTS.md`,`CLAUDE.md`) +2. **全域檔案** `~/.config/opencode/AGENTS.md` +3. **Claude Code 檔案** 位於 `~/.claude/CLAUDE.md`（除非禁用） -第一個匹配的文件在每個類別中獲勝。例如，如果您同時擁有`AGENTS.md` 和`CLAUDE.md`，則僅使用`AGENTS.md`。同樣，`~/.config/opencode/AGENTS.md` 優先於`~/.claude/CLAUDE.md`。 +第一個匹配的檔案在每個類別中獲勝。例如，如果您同時擁有 `AGENTS.md` 和 `CLAUDE.md`，則僅使用 `AGENTS.md`。同樣，`~/.config/opencode/AGENTS.md` 優先於 `~/.claude/CLAUDE.md`。 --- -## 定制說明 +## 自定義指令 -您可以在 `opencode.json` 或全局 `~/.config/opencode/opencode.json` 中指定自定義指令文件。這允許您和您的團隊重用現有規則，而不必將它們複製到 AGENTS.md。 +您可以在 `opencode.json` 或全域 `~/.config/opencode/opencode.json` 中指定自定義指令檔案。這允許您和您的團隊重複使用現有規則，而不必將它們複製到 AGENTS.md。 -例子： +範例： ```json title="opencode.json" { @@ -109,7 +109,7 @@ export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills } ``` -您還可以使用遠程 URL 從 Web 加載說明。 +您還可以使用遠端 URL 從 Web 載入指令。 ```json title="opencode.json" { @@ -118,19 +118,19 @@ export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills } ``` -遠程指令的獲取有 5 秒的超時時間。 +遠端指令的獲取有 5 秒的超時時間。 -所有說明文件均與您的`AGENTS.md` 文件合併。 +所有指令檔案均與您的 `AGENTS.md` 檔案合併。 --- -## 引用外部文件 +## 引用外部檔案 -雖然 opencode 不會自動解析 `AGENTS.md` 中的文件引用，但您可以通過兩種方式實現類似的功能： +雖然 opencode 不會自動解析 `AGENTS.md` 中的檔案引用，但您可以透過兩種方式實現類似的功能： ### 使用 opencode.json -推薦的方法是在`instructions`中使用`opencode.json`字段： +推薦的方法是在 `instructions` 中使用 `opencode.json` 欄位： ```json title="opencode.json" { @@ -141,7 +141,7 @@ export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills ### AGENTS.md 中的手動說明 -您可以通過在 `AGENTS.md` 中提供明確的指令來教 opencode 讀取外部文件。這是一個實際的例子： +您可以透過在 `AGENTS.md` 中提供明確的指令來教 opencode 讀取外部檔案。這是一個實際的範例： ```markdown title="AGENTS.md" # TypeScript Project Rules @@ -170,11 +170,11 @@ Read the following file immediately as it's relevant to all workflows: @rules/ge 這種方法允許您： -- 創建模塊化、可重用的規則文件 -- 通過符號連結或 git 子模塊在項目之間共享規則 +- 建立模組化、可重複使用的規則檔案 +- 透過符號連結或 git 子模組在專案之間共享規則 - 保持 AGENTS.md 簡潔，同時參考詳細指南 -- 確保 opencode 僅在特定任務需要時加載文件 +- 確保 opencode 僅在特定任務需要時載入檔案 :::tip -對於 monorepos 或具有共享標準的項目，使用 `opencode.json` 和 glob 模式（如 `packages/*/AGENTS.md`）比手動指令更易於維護。 +對於 Monorepos 或具有共享標準的專案，使用 `opencode.json` 和 glob 模式（如 `packages/*/AGENTS.md`）比手動指令更易於維護。 ::: diff --git a/packages/web/src/content/docs/zh-tw/sdk.mdx b/packages/web/src/content/docs/zh-tw/sdk.mdx index e9877fb59..713718c9b 100644 --- a/packages/web/src/content/docs/zh-tw/sdk.mdx +++ b/packages/web/src/content/docs/zh-tw/sdk.mdx @@ -1,15 +1,15 @@ --- -title: 軟件開發工具包 -description: opencode 服務器的類型安全 JS 客戶端。 +title: SDK +description: opencode 伺服器的類型安全 JS 客戶端。 --- import config from "../../../../config.mjs" export const typesUrl = `${config.github}/blob/dev/packages/sdk/js/src/gen/types.gen.ts` -opencode JS/TS SDK 提供類型安全的客戶端用於與服務器交互。 -使用它以編程方式構建集成和控制opencode。 +opencode JS/TS SDK 提供類型安全的客戶端用於與伺服器互動。 +使用它以程式化方式構建整合和控制 opencode。 -[了解更多](/docs/server) 關於服務器如何工作。例如，查看社區構建的[專案](/docs/ecosystem#projects)。 +[了解更多](/docs/server) 關於伺服器如何工作。例如，查看社群構建的[專案](/docs/ecosystem#projects)。 --- @@ -23,9 +23,9 @@ npm install @opencode-ai/sdk --- -## 創建客戶端 +## 建立客戶端 -創建 opencode 的實例： +建立 opencode 的實例： ```javascript import { createOpencode } from "@opencode-ai/sdk" @@ -33,23 +33,23 @@ import { createOpencode } from "@opencode-ai/sdk" const { client } = await createOpencode() ``` -這會同時啟動服務器和客戶端 +這會同時啟動伺服器和客戶端 #### 選項 -| 選項 | 類型 | 描述 | 默認 | +| 選項 | 類型 | 描述 | 預設 | | ---------- | ------------- | ------------------------------ | ----------- | -| `hostname` | `string` | 服務器主機名 | `127.0.0.1` | -| `port` | `number` | 服務器端口 | `4096` | -| `signal` | `AbortSignal` | 取消的中止信號 | `undefined` | -| `timeout` | `number` | 服務器啟動超時（以毫秒為單位） | `5000` | -| `config` | `Config` | 配置對象 | `{}` | +| `hostname` | `string` | 伺服器主機名稱 | `127.0.0.1` | +| `port` | `number` | 伺服器連接埠 | `4096` | +| `signal` | `AbortSignal` | 取消的中止訊號 | `undefined` | +| `timeout` | `number` | 伺服器啟動超時（以毫秒為單位） | `5000` | +| `config` | `Config` | 設定物件 | `{}` | --- ## 配置 -您可以傳遞配置對象來自定義行為。該實例仍然會選擇您的`opencode.json`，但您可以覆蓋或添加內聯配置： +您可以傳遞設定物件來自定義行為。該實例仍然會選擇您的 `opencode.json`，但您可以覆寫或添加內聯設定： ```javascript import { createOpencode } from "@opencode-ai/sdk" @@ -67,9 +67,9 @@ console.log(`Server running at ${opencode.server.url}`) opencode.server.close() ``` -## 僅限客戶 +## 僅限客戶端 -如果您已經有一個正在運行的 opencode 實例，您可以創建一個客戶端實例來連接到它： +如果您已經有一個正在執行的 opencode 實例，您可以建立一個客戶端實例來連接到它： ```javascript import { createOpencodeClient } from "@opencode-ai/sdk" @@ -81,11 +81,11 @@ const client = createOpencodeClient({ #### 選項 -| 選項 | 類型 | 描述 | 默認 | +| 選項 | 類型 | 描述 | 預設 | | --------------- | ---------- | ---------------------------- | ----------------------- | -| `baseUrl` | `string` | 服務器的 URL | `http://localhost:4096` | -| `fetch` | `function` | 自定義獲取實現 | `globalThis.fetch` | -| `parseAs` | `string` | 響應解析方法 | `auto` | +| `baseUrl` | `string` | 伺服器的 URL | `http://localhost:4096` | +| `fetch` | `function` | 自定義 fetch 實作 | `globalThis.fetch` | +| `parseAs` | `string` | 回應解析方法 | `auto` | | `responseStyle` | `string` | 返回樣式：`data` 或 `fields` | `fields` | | `throwOnError` | `boolean` | 拋出錯誤而不是返回 | `false` | @@ -93,19 +93,19 @@ const client = createOpencodeClient({ ## 類型 -SDK 包含所有 API 類型的 TypeScript 定義。直接導入它們： +SDK 包含所有 API 類型的 TypeScript 定義。直接匯入它們： ```typescript import type { Session, Message, Part } from "@opencode-ai/sdk" ``` -所有類型均根據服務器的 OpenAPI 規範生成，並可在 types 文件中找到。 +所有類型均根據伺服器的 OpenAPI 規範生成，並可在 types 檔案中找到。 --- ## 錯誤 -SDK 可能會拋出錯誤，您可以捕獲並處理這些錯誤： +SDK 可能會拋出錯誤，您可以捕捉並處理這些錯誤： ```typescript try { @@ -117,21 +117,21 @@ try { --- -## 蜜蜂 +## API -SDK 通過類型安全的客戶端公開所有服務器 API。 +SDK 透過類型安全的客戶端公開所有伺服器 API。 --- -### 全球的 +### 全域 | 方法 | 描述 | 回應 | | ----------------- | ------------------------ | ------------------------------------ | -| `global.health()` | 檢查服務器健康狀況和版本 | `{ healthy: true, version: string }` | +| `global.health()` | 檢查伺服器健康狀態和版本 | `{ healthy: true, version: string }` | --- -#### 示例 +#### 範例 ```javascript const health = await client.global.health() @@ -142,14 +142,14 @@ console.log(health.data.version) ### 應用程式 -| 方法 | 描述 | 回應 | -| -------------- | ------------------ | ------------------------------------------ | -| `app.log()` | 寫入日誌條目 | `boolean` | -| `app.agents()` | 列出所有可用的代理 | 代理[] | +| 方法 | 描述 | 回應 | +| -------------- | ------------------ | ------------------------------------------- | +| `app.log()` | 寫入日誌項目 | `boolean` | +| `app.agents()` | 列出所有可用的代理 | Agent[] | --- -#### 示例 +#### 範例 ```javascript // Write a log entry @@ -169,14 +169,14 @@ const agents = await client.app.agents() ### 專案 -| 方法 | 描述 | 回應 | -| ------------------- | ------------ | ------------------------------------------ | -| `project.list()` | 列出所有項目 | 項目[] | -| `project.current()` | 獲取當前項目 | 項目 | +| 方法 | 描述 | 回應 | +| ------------------- | ------------ | --------------------------------------------- | +| `project.list()` | 列出所有專案 | Project[] | +| `project.current()` | 獲取當前專案 | Project | --- -#### 示例 +#### 範例 ```javascript // List all projects @@ -188,15 +188,15 @@ const currentProject = await client.project.current() --- -### 小路 +### 路徑 | 方法 | 描述 | 回應 | | ------------ | ------------ | ---------------------------------------- | -| `path.get()` | 獲取當前路徑 | 路徑 | +| `path.get()` | 獲取當前路徑 | Path | --- -#### 示例 +#### 範例 ```javascript // Get current path information @@ -209,12 +209,12 @@ const pathInfo = await client.path.get() | 方法 | 描述 | 回應 | | -------------------- | -------------------- | ----------------------------------------------------------------------------------------------------- | -| `config.get()` | 獲取配置信息 | 配置 | -| `config.providers()` | 列出提供商和默認模型 | `{ providers: `Provider[]`, default: { [key: string]: string } }` | +| `config.get()` | 獲取設定資訊 | Config | +| `config.providers()` | 列出供應商和預設模型 | `{ providers: `Provider[]`, default: { [key: string]: string } }` | --- -#### 示例 +#### 範例 ```javascript const config = await client.config.get() @@ -224,33 +224,33 @@ const { providers, default: defaults } = await client.config.providers() --- -### 會議 +### 工作階段 -| 方法 | 描述 | 筆記 | -| ---------------------------------------------------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | -| `session.list()` | 列出會話 | 返回 Session[] | -| `session.get({ path })` | 獲取會話 | 返回 Session | -| `session.children({ path })` | 列出子會話 | 返回 Session[] | -| `session.create({ body })` | 創建會話 | 返回 Session | -| `session.delete({ path })` | 刪除會話 | 返回 `boolean` | -| `session.update({ path, body })` | 更新會話屬性 | 返回 Session | -| `session.init({ path, body })` | 分析應用程式並創建`AGENTS.md` | 返回 `boolean` | -| `session.abort({ path })` | 中止正在運行的會話 | 返回 `boolean` | -| `session.share({ path })` | 分享會 | 返回 Session | -| `session.unshare({ path })` | 取消共享會話 | 返回 Session | -| `session.summarize({ path, body })` | 會議總結 | 返回 `boolean` | -| `session.messages({ path })` | 列出會話中的消息 | 返回 `{ info: `消息`, parts: `Part[]`}[]` | -| `session.message({ path })` | 獲取消息詳情 | 返回 `{ info: `消息`, parts: `Part[]`}` | -| `session.prompt({ path, body })` | 發送提示信息 | `body.noReply: true` 返回 UserMessage（僅上下文）。默認返回帶有 AI 響應的 AssistantMessage | -| `session.command({ path, body })` | 向會話發送命令 | 返回 `{ info: `AssistantMessage`, parts: `Part[]`}` | -| `session.shell({ path, body })` | 運行 shell 命令 | 返回 AssistantMessage | -| `session.revert({ path, body })` | 回复消息 | 返回 Session | -| `session.unrevert({ path })` | 恢復已恢復的消息 | 返回 Session | -| `postSessionByIdPermissionsByPermissionId({ path, body })` | 回復權限請求 | 返回 `boolean` | +| 方法 | 描述 | 備註 | +| ---------------------------------------------------------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ | +| `session.list()` | 列出工作階段 | 返回 Session[] | +| `session.get({ path })` | 獲取工作階段 | 返回 Session | +| `session.children({ path })` | 列出子工作階段 | 返回 Session[] | +| `session.create({ body })` | 建立工作階段 | 返回 Session | +| `session.delete({ path })` | 刪除工作階段 | 返回 `boolean` | +| `session.update({ path, body })` | 更新工作階段屬性 | 返回 Session | +| `session.init({ path, body })` | 分析應用程式並建立 `AGENTS.md` | 返回 `boolean` | +| `session.abort({ path })` | 中止正在執行的工作階段 | 返回 `boolean` | +| `session.share({ path })` | 分享工作階段 | 返回 Session | +| `session.unshare({ path })` | 取消分享工作階段 | 返回 Session | +| `session.summarize({ path, body })` | 工作階段摘要 | 返回 `boolean` | +| `session.messages({ path })` | 列出工作階段中的訊息 | 返回 `{ info: `Message`, parts: `Part[]`}[]` | +| `session.message({ path })` | 獲取訊息詳情 | 返回 `{ info: `Message`, parts: `Part[]`}` | +| `session.prompt({ path, body })` | 發送提示訊息 | `body.noReply: true` 返回 UserMessage（僅上下文）。預設返回帶有 AI 回應的 AssistantMessage | +| `session.command({ path, body })` | 向工作階段發送指令 | 返回 `{ info: `AssistantMessage`, parts: `Part[]`}` | +| `session.shell({ path, body })` | 執行 shell 指令 | 返回 AssistantMessage | +| `session.revert({ path, body })` | 還原訊息 | 返回 Session | +| `session.unrevert({ path })` | 恢復已還原的訊息 | 返回 Session | +| `postSessionByIdPermissionsByPermissionId({ path, body })` | 回覆權限請求 | 返回 `boolean` | --- -#### 示例 +#### 範例 ```javascript // Create and manage sessions @@ -281,25 +281,25 @@ await client.session.prompt({ --- -### 文件 +### 檔案 | 方法 | 描述 | 回應 | | ------------------------- | -------------------- | ----------------------------------------------------------------------------------- | -| `find.text({ query })` | 搜索文件中的文本 | 具有 `path`, `lines`, `line_number`, `absolute_offset`, `submatches` 的匹配對象陣列 | -| `find.files({ query })` | 按名稱查找文件和目錄 | `string[]`（路徑） | -| `find.symbols({ query })` | 查找工作區符號 | Symbol[] | -| `file.read({ query })` | 讀取文件 | `{ type: "raw" \| "patch", content: string }` | -| `file.status({ query? })` | 獲取跟蹤文件的狀態 | File[] | +| `find.text({ query })` | 搜尋檔案中的文字 | 具有 `path`, `lines`, `line_number`, `absolute_offset`, `submatches` 的匹配物件陣列 | +| `find.files({ query })` | 按名稱尋找檔案和目錄 | `string[]`（路徑） | +| `find.symbols({ query })` | 尋找工作區符號 | Symbol[] | +| `file.read({ query })` | 讀取檔案 | `{ type: "raw" \| "patch", content: string }` | +| `file.status({ query? })` | 獲取追蹤檔案的狀態 | File[] | -`find.files` 支持一些可選的查詢字段： +`find.files` 支援一些可選的查詢欄位： -- `type`：`"file"`或`"directory"` -- `directory`：覆蓋搜索的項目根目錄 +- `type`：`"file"` 或 `"directory"` +- `directory`：覆寫搜尋的專案根目錄 - `limit`：最大結果 (1–200) --- -#### 示例 +#### 範例 ```javascript // Search and read files @@ -324,21 +324,21 @@ const content = await client.file.read({ ### TUI -| 方法 | 描述 | 回應 | -| ------------------------------ | ---------------- | --------- | -| `tui.appendPrompt({ body })` | 將文本附加到提示 | `boolean` | -| `tui.openHelp()` | 打開幫助對話框 | `boolean` | -| `tui.openSessions()` | 打開會話選擇器 | `boolean` | -| `tui.openThemes()` | 打開主題選擇器 | `boolean` | -| `tui.openModels()` | 打開模型選擇器 | `boolean` | -| `tui.submitPrompt()` | 提交當前提示 | `boolean` | -| `tui.clearPrompt()` | 清除提示 | `boolean` | -| `tui.executeCommand({ body })` | 執行命令 | `boolean` | -| `tui.showToast({ body })` | 顯示 toast 通知 | `boolean` | +| 方法 | 描述 | 回應 | +| ------------------------------ | ------------------ | --------- | +| `tui.appendPrompt({ body })` | 將文字附加到提示 | `boolean` | +| `tui.openHelp()` | 打開說明對話方塊 | `boolean` | +| `tui.openSessions()` | 打開工作階段選擇器 | `boolean` | +| `tui.openThemes()` | 打開主題選擇器 | `boolean` | +| `tui.openModels()` | 打開模型選擇器 | `boolean` | +| `tui.submitPrompt()` | 提交當前提示 | `boolean` | +| `tui.clearPrompt()` | 清除提示 | `boolean` | +| `tui.executeCommand({ body })` | 執行指令 | `boolean` | +| `tui.showToast({ body })` | 顯示 Toast 通知 | `boolean` | --- -#### 示例 +#### 範例 ```javascript // Control TUI interface @@ -357,11 +357,11 @@ await client.tui.showToast({ | 方法 | 描述 | 回應 | | ------------------- | ---------------- | --------- | -| `auth.set({ ... })` | 設置身份驗證憑據 | `boolean` | +| `auth.set({ ... })` | 設定身分驗證憑證 | `boolean` | --- -#### 示例 +#### 範例 ```javascript await client.auth.set({ @@ -372,15 +372,15 @@ await client.auth.set({ --- -### 活動 +### 事件 -| 方法 | 描述 | 回應 | -| ------------------- | ------------------ | ------------------ | -| `event.subscribe()` | 服務器發送的事件流 | 服務器發送的事件流 | +| 方法 | 描述 | 回應 | +| ------------------- | -------------------- | -------------------- | +| `event.subscribe()` | 伺服器發送的事件串流 | 伺服器發送的事件串流 | --- -#### 示例 +#### 範例 ```javascript // Listen to real-time events diff --git a/packages/web/src/content/docs/zh-tw/server.mdx b/packages/web/src/content/docs/zh-tw/server.mdx index aac6fc02b..1c038a59d 100644 --- a/packages/web/src/content/docs/zh-tw/server.mdx +++ b/packages/web/src/content/docs/zh-tw/server.mdx @@ -1,12 +1,12 @@ --- title: 伺服器 -description: 通過 HTTP 與 opencode 服務器交互。 +description: 透過 HTTP 與 opencode 伺服器互動。 --- import config from "../../../../config.mjs" export const typesUrl = `${config.github}/blob/dev/packages/sdk/js/src/gen/types.gen.ts` -`opencode serve` 命令運行一個無頭 HTTP 服務器，該服務器公開opencode客戶端可以使用的 OpenAPI 端點。 +`opencode serve` 指令執行一個無介面 HTTP 伺服器，該伺服器公開 opencode 客戶端可以使用的 OpenAPI 端點。 --- @@ -18,13 +18,13 @@ opencode serve [--port ] [--hostname ] [--cors ] #### 選項 -| 旗幟 | 描述 | 默認 | -| --------------- | --------------------- | ---------------- | -| `--port` | 監聽端口 | `4096` | -| `--hostname` | 監聽的主機名 | `127.0.0.1` | -| `--mdns` | 啟用 mDNS 發現 | `false` | -| `--mdns-domain` | mDNS 服務的自定義域名 | `opencode.local` | -| `--cors` | 允許的其他瀏覽器來源 | `[]` | +| 旗標 | 描述 | 預設 | +| --------------- | ------------------------- | ---------------- | +| `--port` | 監聽連接埠 | `4096` | +| `--hostname` | 監聽的主機名稱 | `127.0.0.1` | +| `--mdns` | 啟用 mDNS 探索 | `false` | +| `--mdns-domain` | mDNS 服務的自定義網域名稱 | `opencode.local` | +| `--cors` | 允許的其他瀏覽器來源 | `[]` | `--cors` 可以多次傳遞： @@ -34,9 +34,9 @@ opencode serve --cors http://localhost:5173 --cors https://app.example.com --- -### 驗證 +### 身分驗證 -設置`OPENCODE_SERVER_PASSWORD`以使用HTTP基本身份驗證保護服務器。用戶名默認為`opencode`，或設置`OPENCODE_SERVER_USERNAME`來覆蓋它。這適用於`opencode serve` 和`opencode web`。 +設定 `OPENCODE_SERVER_PASSWORD` 以使用 HTTP 基本身分驗證保護伺服器。使用者名稱預設為 `opencode`，或設定 `OPENCODE_SERVER_USERNAME` 來覆蓋它。這適用於 `opencode serve` 和 `opencode web`。 ```bash OPENCODE_SERVER_PASSWORD=your-password opencode serve @@ -46,71 +46,71 @@ OPENCODE_SERVER_PASSWORD=your-password opencode serve ### 它是如何運作的 -當您運行 `opencode` 時，它會啟動 TUI 和服務器。 TUI 是哪裡 -與服務器對話的客戶端。服務器公開 OpenAPI 3.1 規範 -端點。該端點還用於生成[軟件開發工具包](/docs/sdk)。 +當您執行 `opencode` 時，它會啟動 TUI 和伺服器。 TUI 是 +與伺服器對話的客戶端。伺服器公開 OpenAPI 3.1 規範 +端點。該端點還用於生成 [軟體開發套件](/docs/sdk)。 :::tip -使用 opencode 服務器以編程方式與 opencode 進行交互。 +使用 opencode 伺服器以程式化方式與 opencode 進行互動。 ::: -此架構讓 opencode 支持多個客戶端，並允許您以編程方式與 opencode 進行交互。 +此架構讓 opencode 支援多個客戶端，並允許您以程式化方式與 opencode 進行互動。 -您可以運行 `opencode serve` 來啟動獨立服務器。如果您有 -opencode TUI 運行，`opencode serve` 將啟動一個新服務器。 +您可以執行 `opencode serve` 來啟動獨立伺服器。如果您有 +opencode TUI 執行，`opencode serve` 將啟動一個新伺服器。 --- -#### 連接到現有服務器 +#### 連接到現有伺服器 -當您啟動 TUI 時，它會隨機分配端口和主機名。您可以改為傳入`--hostname` 和`--port` [旗幟](/docs/cli)。然後使用它連接到其服務器。 +當您啟動 TUI 時，它會隨機分配連接埠和主機名稱。您可以改為傳入 `--hostname` 和 `--port` [旗標](/docs/cli)。然後使用它連接到其伺服器。 -[`/tui`](#tui) 端點可用於通過服務器驅動 TUI。例如，您可以預填充或運行提示。此設置由 opencode [集成開發環境](/docs/ide) 插件使用。 +[`/tui`](#tui) 端點可用於透過伺服器驅動 TUI。例如，您可以預填充或執行提示。此設定由 opencode [IDE](/docs/ide) 外掛使用。 --- ## 規格 -服務器發布了 OpenAPI 3.1 規範，可以在以下位置查看： +伺服器發布了 OpenAPI 3.1 規範，可以在以下位置查看： ``` http://:/doc ``` -例如，`http://localhost:4096/doc`。使用規範生成客戶端或檢查請求和響應類型。或者在 Swagger 瀏覽器中查看它。 +例如，`http://localhost:4096/doc`。使用規範生成客戶端或檢查請求和回應類型。或者在 Swagger 瀏覽器中查看它。 --- -## 蜜蜂 +## API -opencode 服務器公開以下 API。 +opencode 伺服器公開以下 API。 --- -### 全球的 +### 全域 | 方法 | 路徑 | 描述 | 回應 | | ----- | ---------------- | ------------------------ | ------------------------------------ | -| `GET` | `/global/health` | 獲取服務器運行狀況和版本 | `{ healthy: true, version: string }` | -| `GET` | `/global/event` | 獲取全局事件（SSE 流） | 事件流 | +| `GET` | `/global/health` | 獲取伺服器健康狀態和版本 | `{ healthy: true, version: string }` | +| `GET` | `/global/event` | 獲取全域事件（SSE 串流） | 事件串流 | --- ### 專案 -| 方法 | 路徑 | 描述 | 回應 | -| ----- | ------------------ | ------------ | ------------------------------------------ | -| `GET` | `/project` | 列出所有項目 | 項目[] | -| `GET` | `/project/current` | 獲取當前項目 | 項目 | +| 方法 | 路徑 | 描述 | 回應 | +| ----- | ------------------ | ------------ | --------------------------------------------- | +| `GET` | `/project` | 列出所有專案 | Project[] | +| `GET` | `/project/current` | 獲取當前專案 | Project | --- -### 路徑和VCS +### 路徑和 VCS | 方法 | 路徑 | 描述 | 回應 | | ----- | ------- | ----------------------- | ------------------------------------------- | -| `GET` | `/path` | 獲取當前路徑 | 路徑 | -| `GET` | `/vcs` | 獲取當前項目的 VCS 信息 | VcsInfo | +| `GET` | `/path` | 獲取當前路徑 | Path | +| `GET` | `/vcs` | 獲取當前專案的 VCS 資訊 | VcsInfo | --- @@ -124,89 +124,89 @@ opencode 服務器公開以下 API。 ### 配置 -| 方法 | 路徑 | 描述 | 回應 | -| ------- | ------------------- | -------------------- | -------------------------------------------------------------------------------------- | -| `GET` | `/config` | 獲取配置信息 | 配置 | -| `PATCH` | `/config` | 更新配置 | 配置 | -| `GET` | `/config/providers` | 列出提供商和默認模型 | `{ providers: `提供商[]`, default: { [key: string]: string } }` | +| 方法 | 路徑 | 描述 | 回應 | +| ------- | ------------------- | -------------------- | ---------------------------------------------------------------------------------------- | +| `GET` | `/config` | 獲取設定資訊 | Config | +| `PATCH` | `/config` | 更新設定 | Config | +| `GET` | `/config/providers` | 列出供應商和預設模型 | `{ providers: `Provider[]`, default: { [key: string]: string } }` | --- -### 提供者 +### 供應商 -| 方法 | 路徑 | 描述 | 回應 | -| ------ | -------------------------------- | ----------------------- | --------------------------------------------------------------------------------- | -| `GET` | `/provider` | 列出所有提供商 | `{ all: `提供商[]`, default: {...}, connected: string[] }` | -| `GET` | `/provider/auth` | 獲取提供商身份驗證方法 | `{ [providerID: string]: `ProviderAuthMethod[]` }` | -| `POST` | `/provider/{id}/oauth/authorize` | 使用 OAuth 授權提供商 | ProviderAuthAuthorization | -| `POST` | `/provider/{id}/oauth/callback` | 處理提供商的 OAuth 回調 | `boolean` | +| 方法 | 路徑 | 描述 | 回應 | +| ------ | -------------------------------- | ----------------------- | ----------------------------------------------------------------------------------- | +| `GET` | `/provider` | 列出所有供應商 | `{ all: `Provider[]`, default: {...}, connected: string[] }` | +| `GET` | `/provider/auth` | 獲取供應商身分驗證方法 | `{ [providerID: string]: `ProviderAuthMethod[]` }` | +| `POST` | `/provider/{id}/oauth/authorize` | 使用 OAuth 授權供應商 | ProviderAuthAuthorization | +| `POST` | `/provider/{id}/oauth/callback` | 處理供應商的 OAuth 回調 | `boolean` | --- -### 會議 +### 工作階段 -| 方法 | 路徑 | 描述 | 筆記 | -| -------- | ---------------------------------------- | ----------------------------- | ------------------------------------------------------------------------------- | -| `GET` | `/session` | 列出所有會話 | 返回 Session[] | -| `POST` | `/session` | 創建新會話 | 正文：`{ parentID?, title? }`，返回 Session | -| `GET` | `/session/status` | 獲取所有會話的會話狀態 | 返回 `{ [sessionID: string]: `SessionStatus` }` | -| `GET` | `/session/:id` | 獲取會話詳細信息 | 返回 Session | -| `DELETE` | `/session/:id` | 刪除會話及其所有數據 | 返回 `boolean` | -| `PATCH` | `/session/:id` | 更新會話屬性 | 正文：`{ title? }`，返回 Session | -| `GET` | `/session/:id/children` | 獲取會話的子會話 | 返回 Session[] | -| `GET` | `/session/:id/todo` | 獲取會話的待辦事項列表 | 返回 Todo[] | -| `POST` | `/session/:id/init` | 分析應用程式並創建`AGENTS.md` | 主體：`{ messageID, providerID, modelID }`，返回`boolean` | -| `POST` | `/session/:id/fork` | 在消息中分叉現有會話 | 正文：`{ messageID? }`，返回 Session | -| `POST` | `/session/:id/abort` | 中止正在運行的會話 | 返回 `boolean` | -| `POST` | `/session/:id/share` | 分享會議 | 返回 Session | -| `DELETE` | `/session/:id/share` | 取消共享會話 | 返回 Session | -| `GET` | `/session/:id/diff` | 獲取本次會話的差異 | 查詢：`messageID?`，返回 FileDiff[] | -| `POST` | `/session/:id/summarize` | 會議總結 | 主體：`{ providerID, modelID }`，返回`boolean` | -| `POST` | `/session/:id/revert` | 回复消息 | 主體：`{ messageID, partID? }`，返回`boolean` | -| `POST` | `/session/:id/unrevert` | 恢復所有已恢復的消息 | 返回 `boolean` | -| `POST` | `/session/:id/permissions/:permissionID` | 回復權限請求 | 主體：`{ response, remember? }`，返回`boolean` | +| 方法 | 路徑 | 描述 | 備註 | +| -------- | ---------------------------------------- | ------------------------------ | ------------------------------------------------------------------------------- | +| `GET` | `/session` | 列出所有工作階段 | 返回 Session[] | +| `POST` | `/session` | 建立新工作階段 | 正文：`{ parentID?, title? }`，返回 Session | +| `GET` | `/session/status` | 獲取所有工作階段的狀態 | 返回 `{ [sessionID: string]: `SessionStatus` }` | +| `GET` | `/session/:id` | 獲取工作階段詳細資訊 | 返回 Session | +| `DELETE` | `/session/:id` | 刪除工作階段及其所有數據 | 返回 `boolean` | +| `PATCH` | `/session/:id` | 更新工作階段屬性 | 正文：`{ title? }`，返回 Session | +| `GET` | `/session/:id/children` | 獲取工作階段的子工作階段 | 返回 Session[] | +| `GET` | `/session/:id/todo` | 獲取工作階段的待辦事項清單 | 返回 Todo[] | +| `POST` | `/session/:id/init` | 分析應用程式並建立 `AGENTS.md` | 主體：`{ messageID, providerID, modelID }`，返回`boolean` | +| `POST` | `/session/:id/fork` | 在訊息中分岔現有工作階段 | 正文：`{ messageID? }`，返回 Session | +| `POST` | `/session/:id/abort` | 中止正在執行的工作階段 | 返回 `boolean` | +| `POST` | `/session/:id/share` | 分享工作階段 | 返回 Session | +| `DELETE` | `/session/:id/share` | 取消分享工作階段 | 返回 Session | +| `GET` | `/session/:id/diff` | 獲取本次工作階段的差異 | 查詢：`messageID?`，返回 FileDiff[] | +| `POST` | `/session/:id/summarize` | 工作階段摘要 | 主體：`{ providerID, modelID }`，返回`boolean` | +| `POST` | `/session/:id/revert` | 還原訊息 | 主體：`{ messageID, partID? }`，返回`boolean` | +| `POST` | `/session/:id/unrevert` | 恢復所有已還原的訊息 | 返回 `boolean` | +| `POST` | `/session/:id/permissions/:permissionID` | 回覆權限請求 | 主體：`{ response, remember? }`，返回`boolean` | --- -### 留言 +### 訊息 -| 方法 | 路徑 | 描述 | 筆記 | -| ------ | --------------------------------- | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `GET` | `/session/:id/message` | 列出會話中的消息 | 查詢：`limit?`，返回`{ info: `消息`, parts: `Part[]`}[]` | -| `POST` | `/session/:id/message` | 發送消息並等待回复 | 主體：`{ messageID?, model?, agent?, noReply?, system?, tools?, parts }`，返回`{ info: `消息`, parts: `部分[]`}` | -| `GET` | `/session/:id/message/:messageID` | 獲取消息詳情 | 返回`{ info: `消息`, parts: `部分[]`}` | -| `POST` | `/session/:id/prompt_async` | 異步發送消息（無需等待） | body：與`/session/:id/message`相同，返回`204 No Content` | -| `POST` | `/session/:id/command` | 執行斜杠命令 | 主體：`{ messageID?, agent?, model?, command, arguments }`，返回`{ info: `消息`, parts: `部分[]`}` | -| `POST` | `/session/:id/shell` | 運行 shell 命令 | 主體：`{ agent, model?, command }`，返回`{ info: `消息`, parts: `部分[]`}` | +| 方法 | 路徑 | 描述 | 備註 | +| ------ | --------------------------------- | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `GET` | `/session/:id/message` | 列出工作階段中的訊息 | 查詢：`limit?`，返回`{ info: `Message`, parts: `Part[]`}[]` | +| `POST` | `/session/:id/message` | 發送訊息並等待回覆 | 主體：`{ messageID?, model?, agent?, noReply?, system?, tools?, parts }`，返回`{ info: `Message`, parts: `Part[]`}` | +| `GET` | `/session/:id/message/:messageID` | 獲取訊息詳情 | 返回`{ info: `Message`, parts: `Part[]`}` | +| `POST` | `/session/:id/prompt_async` | 非同步發送訊息（無需等待） | body：與`/session/:id/message`相同，返回`204 No Content` | +| `POST` | `/session/:id/command` | 執行斜線指令 | 主體：`{ messageID?, agent?, model?, command, arguments }`，返回`{ info: `Message`, parts: `Part[]`}` | +| `POST` | `/session/:id/shell` | 執行 shell 指令 | 主體：`{ agent, model?, command }`，返回`{ info: `Message`, parts: `Part[]`}` | --- -### 命令 +### 指令 | 方法 | 路徑 | 描述 | 回應 | | ----- | ---------- | ------------ | --------------------------------------------- | -| `GET` | `/command` | 列出所有命令 | Command[] | +| `GET` | `/command` | 列出所有指令 | Command[] | --- -### 文件 +### 檔案 | 方法 | 路徑 | 描述 | 回應 | | ----- | ------------------------ | -------------------- | ----------------------------------------------------------------------------------- | -| `GET` | `/find?pattern=` | 搜索文件中的文本 | 具有 `path`, `lines`, `line_number`, `absolute_offset`, `submatches` 的匹配對象陣列 | -| `GET` | `/find/file?query=` | 按名稱查找文件和目錄 | `string[]`（路徑） | -| `GET` | `/find/symbol?query=` | 查找工作區符號 | Symbol[] | -| `GET` | `/file?path=` | 列出文件和目錄 | FileNode[] | -| `GET` | `/file/content?path=

` | 讀取文件 | FileContent | -| `GET` | `/file/status` | 獲取跟蹤文件的狀態 | File[] | +| `GET` | `/find?pattern=` | 搜尋檔案中的文字 | 具有 `path`, `lines`, `line_number`, `absolute_offset`, `submatches` 的匹配物件陣列 | +| `GET` | `/find/file?query=` | 按名稱尋找檔案和目錄 | `string[]`（路徑） | +| `GET` | `/find/symbol?query=` | 尋找工作區符號 | Symbol[] | +| `GET` | `/file?path=` | 列出檔案和目錄 | FileNode[] | +| `GET` | `/file/content?path=

` | 讀取檔案 | FileContent | +| `GET` | `/file/status` | 獲取追蹤檔案的狀態 | File[] | -#### `/find/file`查詢參數 +#### `/find/file` 查詢參數 -- `query`（必需）- 搜索字符串（模糊匹配） -- `type`（可選）- 將結果限制為`"file"` 或`"directory"` -- `directory` (可選) — 覆蓋搜索的項目根目錄 +- `query`（必需）- 搜尋字串（模糊匹配） +- `type`（可選）- 將結果限制為 `"file"` 或 `"directory"` +- `directory` (可選) — 覆寫搜尋的專案根目錄 - `limit`（可選）— 最大結果 (1–200) -- `dirs`（可選）- 舊標誌（`"false"` 僅返回文件） +- `dirs`（可選）- 舊旗標（`"false"` 僅返回檔案） --- @@ -215,26 +215,26 @@ opencode 服務器公開以下 API。 | 方法 | 路徑 | 描述 | 回應 | | ----- | ------------------------------------------- | ---------------------------- | -------------------------------------------- | | `GET` | `/experimental/tool/ids` | 列出所有工具 ID | ToolID | -| `GET` | `/experimental/tool?provider=

&model=` | 列出具有模型 JSON 架構的工具 | 工具列表 | +| `GET` | `/experimental/tool?provider=

&model=` | 列出具有模型 JSON 架構的工具 | ToolList | --- -### LSP、格式化程序和 MCP +### LSP、格式化程式和 MCP | 方法 | 路徑 | 描述 | 回應 | | ------ | ------------ | ------------------- | -------------------------------------------------------- | -| `GET` | `/lsp` | 獲取LSP服務器狀態 | LSPStatus[] | -| `GET` | `/formatter` | 獲取格式化程序狀態 | FormatterStatus[] | -| `GET` | `/mcp` | 獲取 MCP 服務器狀態 | `{ [name: string]: `MCPStatus` }` | -| `POST` | `/mcp` | 動態添加MCP服務器 | body: `{ name, config }`, 返回 MCP 狀態對象 | +| `GET` | `/lsp` | 獲取 LSP 伺服器狀態 | LSPStatus[] | +| `GET` | `/formatter` | 獲取格式化程式狀態 | FormatterStatus[] | +| `GET` | `/mcp` | 獲取 MCP 伺服器狀態 | `{ [name: string]: `MCPStatus` }` | +| `POST` | `/mcp` | 動態添加 MCP 伺服器 | body: `{ name, config }`, 返回 MCP 狀態物件 | --- -### Agents +### 代理 -| 方法 | 路徑 | 描述 | 回應 | -| ----- | -------- | ------------------ | ------------------------------------------ | -| `GET` | `/agent` | 列出所有可用的代理 | 代理[] | +| 方法 | 路徑 | 描述 | 回應 | +| ----- | -------- | ------------------ | ------------------------------------------- | +| `GET` | `/agent` | 列出所有可用的代理 | Agent[] | --- @@ -242,25 +242,25 @@ opencode 服務器公開以下 API。 | 方法 | 路徑 | 描述 | 回應 | | ------ | ------ | --------------------------------------------------------- | --------- | -| `POST` | `/log` | 寫入日誌條目。正文：`{ service, level, message, extra? }` | `boolean` | +| `POST` | `/log` | 寫入日誌項目。正文：`{ service, level, message, extra? }` | `boolean` | --- ### TUI -| 方法 | 路徑 | 描述 | 回應 | -| ------ | ----------------------- | ----------------------------------------- | ------------ | -| `POST` | `/tui/append-prompt` | 將文本附加到提示 | `boolean` | -| `POST` | `/tui/open-help` | 打開幫助對話框 | `boolean` | -| `POST` | `/tui/open-sessions` | 打開會話選擇器 | `boolean` | -| `POST` | `/tui/open-themes` | 打開主題選擇器 | `boolean` | -| `POST` | `/tui/open-models` | 打開模型選擇器 | `boolean` | -| `POST` | `/tui/submit-prompt` | 提交當前提示 | `boolean` | -| `POST` | `/tui/clear-prompt` | 清除提示 | `boolean` | -| `POST` | `/tui/execute-command` | 執行命令(`{ command }`) | `boolean` | -| `POST` | `/tui/show-toast` | 顯示祝酒 (`{ title?, message, variant }`) | `boolean` | -| `GET` | `/tui/control/next` | 等待下一個控制請求 | 控制請求對象 | -| `POST` | `/tui/control/response` | 響應控制請求 (`{ body }`) | `boolean` | +| 方法 | 路徑 | 描述 | 回應 | +| ------ | ----------------------- | ------------------------------------------- | ------------ | +| `POST` | `/tui/append-prompt` | 將文字附加到提示 | `boolean` | +| `POST` | `/tui/open-help` | 打開說明對話方塊 | `boolean` | +| `POST` | `/tui/open-sessions` | 打開工作階段選擇器 | `boolean` | +| `POST` | `/tui/open-themes` | 打開主題選擇器 | `boolean` | +| `POST` | `/tui/open-models` | 打開模型選擇器 | `boolean` | +| `POST` | `/tui/submit-prompt` | 提交當前提示 | `boolean` | +| `POST` | `/tui/clear-prompt` | 清除提示 | `boolean` | +| `POST` | `/tui/execute-command` | 執行指令 (`{ command }`) | `boolean` | +| `POST` | `/tui/show-toast` | 顯示 Toast (`{ title?, message, variant }`) | `boolean` | +| `GET` | `/tui/control/next` | 等待下一個控制請求 | 控制請求物件 | +| `POST` | `/tui/control/response` | 回應控制請求 (`{ body }`) | `boolean` | --- @@ -268,15 +268,15 @@ opencode 服務器公開以下 API。 | 方法 | 路徑 | 描述 | 回應 | | ----- | ----------- | ------------------------------------------ | --------- | -| `PUT` | `/auth/:id` | 設置身份驗證憑據。正文必須與提供者架構匹配 | `boolean` | +| `PUT` | `/auth/:id` | 設定身分驗證憑證。正文必須與供應商架構匹配 | `boolean` | --- -### 活動 +### 事件 -| 方法 | 路徑 | 描述 | 回應 | -| ----- | -------- | ------------------------------------------------------------------ | ------------------ | -| `GET` | `/event` | 服務器發送的事件流。第一個活動是`server.connected`，然後是巴士活動 | 服務器發送的事件流 | +| 方法 | 路徑 | 描述 | 回應 | +| ----- | -------- | --------------------------------------------------------------------------- | -------------------- | +| `GET` | `/event` | 伺服器發送的事件串流。第一個活動是 `server.connected`，然後是事件匯流排事件 | 伺服器發送的事件串流 | --- diff --git a/packages/web/src/content/docs/zh-tw/share.mdx b/packages/web/src/content/docs/zh-tw/share.mdx index 30375552d..a7733e346 100644 --- a/packages/web/src/content/docs/zh-tw/share.mdx +++ b/packages/web/src/content/docs/zh-tw/share.mdx @@ -3,10 +3,10 @@ title: 分享 description: 分享您的 opencode 對話。 --- -opencode 的共享功能允許您創建 opencode 對話的公共連結，以便您可以與團隊成員協作或從其他人那裡獲得幫助。 +opencode 的共享功能允許您建立 opencode 對話的公共連結，以便您可以與團隊成員協作或從其他人那裡獲得幫助。 :::note -任何知道連結的人都可以公開訪問共享對話。 +任何知道連結的人都可以公開存取共享對話。 ::: --- @@ -15,29 +15,29 @@ opencode 的共享功能允許您創建 opencode 對話的公共連結，以便 當您共享對話時，opencode： -1. 為您的會話創建唯一的公共 URL -2. 將您的對話歷史記錄同步到我們的服務器 -3. 通過可共享連結進行對話 — `opncd.ai/s/` +1. 為您的工作階段建立唯一的公共 URL +2. 將您的對話歷史記錄同步到我們的伺服器 +3. 透過可共享連結進行對話 — `opncd.ai/s/` --- -## 分享 +## 模式 -opencode 支持三種控制對話共享方式的共享模式： +opencode 支援三種控制對話共享方式的共享模式： --- -### 手動（默認） +### 手動（預設） -opencode默認使用手動共享模式。會話不會自動共享，但您可以使用 `/share` 命令手動共享它們： +opencode 預設使用手動共享模式。工作階段不會自動共享，但您可以使用 `/share` 指令手動共享它們： ``` /share ``` -這將生成一個唯一的 URL，並將其複製到您的剪貼板。 +這將生成一個唯一的 URL，並將其複製到您的剪貼簿。 -要在 [配置文件](/docs/config) 中顯式設置手動模式： +要在 [設定檔](/docs/config) 中明確設定手動模式： ```json title="opencode.json" { @@ -50,7 +50,7 @@ opencode默認使用手動共享模式。會話不會自動共享，但您可以 ### 自動分享 -您可以通過將[配置文件](/docs/config)中的`share`選項設置為`"auto"`來為所有新對話啟用自動共享： +您可以在 [設定檔](/docs/config) 中將 `share` 選項設定為 `"auto"` 來為所有新對話啟用自動共享： ```json title="opencode.json" { @@ -63,9 +63,9 @@ opencode默認使用手動共享模式。會話不會自動共享，但您可以 --- -### 殘疾人 +### 已禁用 -您可以通過將[配置文件](/docs/config)中的`share`選項設置為`"disabled"`來完全禁用共享： +您可以在 [設定檔](/docs/config) 中將 `share` 選項設定為 `"disabled"` 來完全禁用共享： ```json title="opencode.json" { @@ -74,13 +74,13 @@ opencode默認使用手動共享模式。會話不會自動共享，但您可以 } ``` -要在整個團隊中針對給定項目強制執行此操作，請將其添加到項目中的 `opencode.json` 並簽入 Git。 +要在整個團隊中針對給定專案強制執行此操作，請將其添加到專案中的 `opencode.json` 並簽入 Git。 --- ## 取消共享 -要停止共享對話並將其從公共訪問中刪除： +要停止共享對話並將其從公共存取中刪除： ``` /unshare @@ -96,24 +96,24 @@ opencode默認使用手動共享模式。會話不會自動共享，但您可以 --- -### 數據保留 +### 資料保留 -共享對話仍然可以訪問，直到您明確取消共享。這 +共享對話仍然可以存取，直到您明確取消共享。這 包括： - 完整的對話歷史記錄 -- 所有消息和回复 -- 會話元數據 +- 所有訊息和回覆 +- 工作階段元數據 --- ### 建議 -- 僅共享不包含敏感信息的對話。 +- 僅共享不包含敏感資訊的對話。 - 分享之前查看對話內容。 - 協作完成後取消共享對話。 - 避免與專有程式碼或機密數據共享對話。 -- 對於敏感項目，完全禁用共享。 +- 對於敏感專案，完全禁用共享。 --- @@ -122,7 +122,7 @@ opencode默認使用手動共享模式。會話不會自動共享，但您可以 對於企業部署，共享功能可以是： - **出於安全合規性完全禁用** -- **僅限**僅通過 SSO 進行身份驗證的用戶 -- **在您自己的基礎設施上自行託管** +- **僅限**僅透過 SSO 進行身分驗證的使用者 +- **在您自己的基礎架構上自行託管** -[了解更多](/docs/enterprise) 關於在您的組織中使用opencode。 +[了解更多](/docs/enterprise) 關於在您的組織中使用 opencode。 diff --git a/packages/web/src/content/docs/zh-tw/skills.mdx b/packages/web/src/content/docs/zh-tw/skills.mdx index eb608fb0b..f9bd62263 100644 --- a/packages/web/src/content/docs/zh-tw/skills.mdx +++ b/packages/web/src/content/docs/zh-tw/skills.mdx @@ -1,62 +1,62 @@ --- -title: 《代理技巧》 -description: “通過 SKILL.md 定義定義可重用行為” +title: 代理技能 +description: 透過 SKILL.md 定義定義可重複使用行為 --- -代理技能讓 opencode 從您的存儲庫或主目錄中發現可重用的指令。 -技能通過本機 `skill` 工具按需加載 - 代理可以查看可用技能並可以在需要時加載完整內容。 +代理技能讓 opencode 從您的儲存庫或主目錄中發現可重複使用的指令。 +技能透過原生 `skill` 工具按需載入 - 代理可以查看可用技能並可以在需要時載入完整內容。 --- -## 放置文件 +## 放置檔案 -每個技能名稱創建一個文件夾，並在其中放入`SKILL.md`。 -opencode 搜索這些位置： +每個技能名稱建立一個資料夾，並在其中放入 `SKILL.md`。 +opencode 搜尋這些位置： -- 項目配置：`.opencode/skills//SKILL.md` -- 全局配置：`~/.config/opencode/skills//SKILL.md` -- 克勞德項目兼容：`.claude/skills//SKILL.md` -- 全球克勞德兼容：`~/.claude/skills//SKILL.md` -- 項目代理兼容：`.agents/skills//SKILL.md` -- 全球代理兼容：`~/.agents/skills//SKILL.md` +- 專案設定：`.opencode/skills//SKILL.md` +- 全域設定：`~/.config/opencode/skills//SKILL.md` +- Claude 專案相容：`.claude/skills//SKILL.md` +- 全域 Claude 相容：`~/.claude/skills//SKILL.md` +- 專案代理相容：`.agents/skills//SKILL.md` +- 全域代理相容：`~/.agents/skills//SKILL.md` --- ## 了解發現 -對於項目本地路徑，opencode 將從當前工作目錄開始，直到到達 git 工作樹。 -它加載 `skills/*/SKILL.md` 中任何匹配的 `.opencode/` 以及一路上任何匹配的 `.claude/skills/*/SKILL.md` 或 `.agents/skills/*/SKILL.md`。 +對於專案本地路徑，opencode 將從當前工作目錄開始，直到到達 git 工作樹。 +它載入 `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` 加載。 +全域定義也從 `~/.config/opencode/skills/*/SKILL.md`、`~/.claude/skills/*/SKILL.md` 和 `~/.agents/skills/*/SKILL.md` 載入。 --- -## 寫前言 +## 撰寫 Frontmatter -每個`SKILL.md` 必須以 YAML frontmatter 開頭。 -僅識別這些字段： +每個 `SKILL.md` 必須以 YAML frontmatter 開頭。 +僅識別這些欄位： - `name`（必填） - `description`（必填） - `license`（可選） - `compatibility`（可選） -- `metadata`（可選，字符串到字符串映射） +- `metadata`（可選，字串到字串對應） -未知的 frontmatter 字段將被忽略。 +未知的 frontmatter 欄位將被忽略。 --- -## 驗證姓名 +## 驗證名稱 `name` 必須： -- 長度為 1–64 個字符 -- 為小寫字母數字並帶有單個連字符分隔符 +- 長度為 1–64 個字元 +- 為小寫字母數字並帶有單個連字號分隔符 - 不以 `-` 開頭或結尾 -- 不包含連續`--` -- 匹配包含`SKILL.md`的目錄名 +- 不包含連續 `--` +- 匹配包含 `SKILL.md` 的目錄名 -等效的正則表達式： +等效的正規表示式： ```text ^[a-z0-9]+(-[a-z0-9]+)*$ @@ -66,14 +66,14 @@ opencode 搜索這些位置： ## 遵循長度規則 -`description` 必須是 1-1024 個字符。 +`description` 必須是 1-1024 個字元。 保持足夠具體，以便代理能夠正確選擇。 --- -## 使用一個例子 +## 使用一個範例 -像這樣創建`.opencode/skills/git-release/SKILL.md`： +像這樣建立 `.opencode/skills/git-release/SKILL.md`： ```markdown --- @@ -102,8 +102,8 @@ Ask clarifying questions if the target versioning scheme is unclear. ## 識別工具說明 -opencode 在`skill` 工具描述中列出了可用的技能。 -每個條目都包含技能名稱和描述： +opencode 在 `skill` 工具描述中列出了可用的技能。 +每個項目都包含技能名稱和描述： ```xml @@ -114,7 +114,7 @@ opencode 在`skill` 工具描述中列出了可用的技能。 ``` -代理通過調用工具來加載技能： +代理透過呼叫工具來載入技能： ``` skill({ name: "git-release" }) @@ -124,7 +124,7 @@ skill({ name: "git-release" }) ## 配置權限 -使用 `opencode.json` 中基於模式的權限控制客服人員可以訪問哪些技能： +使用 `opencode.json` 中基於模式的權限控制代理可以存取哪些技能： ```json { @@ -141,17 +141,17 @@ skill({ name: "git-release" }) | 許可 | 行為 | | ------- | -------------------------- | -| `allow` | 技能立即加載 | -| `deny` | 技能對特工隱藏，訪問被拒絕 | -| `ask` | 加載前提示用戶批准 | +| `allow` | 技能立即載入 | +| `deny` | 技能對代理隱藏，存取被拒絕 | +| `ask` | 載入前提示使用者批准 | -模式支持通配符：`internal-*` 匹配`internal-docs`、`internal-tools` 等。 +模式支援通配符：`internal-*` 匹配 `internal-docs`、`internal-tools` 等。 --- -## 覆蓋每個代理 +## 覆寫每個代理 -為特定代理授予與全局默認權限不同的權限。 +為特定代理授予與全域預設權限不同的權限。 **對於自定義代理**（在代理前言中）： @@ -163,7 +163,7 @@ permission: --- ``` -**對於內置代理**（在 `opencode.json` 中）： +**對於內建代理**（在 `opencode.json` 中）： ```json { @@ -183,9 +183,9 @@ permission: ## 禁用技能工具 -完全禁用不應該使用技能的特工： +完全禁用不應該使用技能的代理： -**對於定制代理**： +**對於自定義代理**： ```yaml --- @@ -194,7 +194,7 @@ tools: --- ``` -**對於內置代理**： +**對於內建代理**： ```json { @@ -212,7 +212,7 @@ tools: --- -## 解決加載問題 +## 解決載入問題 如果某項技能沒有顯示： diff --git a/packages/web/src/content/docs/zh-tw/themes.mdx b/packages/web/src/content/docs/zh-tw/themes.mdx index 437cdfa57..d47e1afe5 100644 --- a/packages/web/src/content/docs/zh-tw/themes.mdx +++ b/packages/web/src/content/docs/zh-tw/themes.mdx @@ -1,43 +1,43 @@ --- title: 主題 -description: 選擇內置主題或定義您自己的主題。 +description: 選擇內建主題或定義您自己的主題。 --- -使用 opencode，您可以從多個內置主題之一中進行選擇，使用適合您的terminal主題的主題，或者定義您自己的自定義主題。 +使用 opencode，您可以從多個內建主題之一中進行選擇，使用適合您的終端機主題的主題，或者定義您自己的自定義主題。 -默認情況下，opencode 使用我們自己的 `opencode` 主題。 +預設情況下，opencode 使用我們自己的 `opencode` 主題。 --- -## terminal要求 +## 終端機要求 -為了使主題能夠正確顯示完整的調色板，您的terminal必須支持**真彩色**（24 位顏色）。大多數現代terminal默認支持此功能，但您可能需要啟用它： +為了使主題能夠正確顯示完整的調色盤，您的終端機必須支援**真彩色**（24 位元顏色）。大多數現代終端機預設支援此功能，但您可能需要啟用它： -- **檢查支持**：運行`echo $COLORTERM` - 它應該輸出`truecolor`或`24bit` -- **啟用真彩色**：在 shell 配置文件中設置環境變量 `COLORTERM=truecolor` -- **terminal兼容性**：確保您的terminal模擬器支持 24 位顏色（大多數現代terminal，​​如 iTerm2、Alacritty、Kitty、Windows terminal和最新版本的 GNOME terminal都支持） +- **檢查支援**：執行 `echo $COLORTERM` - 它應該輸出 `truecolor` 或 `24bit` +- **啟用真彩色**：在 shell 設定檔中設定環境變數 `COLORTERM=truecolor` +- **終端機相容性**：確保您的終端機模擬器支援 24 位元顏色（大多數現代終端機，​​如 iTerm2、Alacritty、Kitty、Windows Terminal 和最新版本的 GNOME Terminal 都支援） -如果沒有真彩色支持，主題的顏色精度可能會降低或回落到最接近的 256 色近似值。 +如果沒有真彩色支援，主題的顏色精度可能會降低或回退到最接近的 256 色近似值。 --- -## 內置主題 +## 內建主題 -opencode 附帶了幾個內置主題。 +opencode 附帶了幾個內建主題。 -| 名稱 | 描述 | -| ---------------------- | ----------------------------------------------------------------- | -| `system` | 適應您terminal的背景顏色 | -| `tokyonight` | 基於[tokyonight](https://github.com/folke/tokyonight.nvim)主題 | -| `everforest` | 基於[everforest](https://github.com/sainnhe/everforest)主題 | -| `ayu` | 基於[ayu](https://github.com/ayu-theme)深色主題 | -| `catppuccin` | 基於[catppuccin](https://github.com/catppuccin)主題 | -| `catppuccin-macchiato` | 基於[catppuccin](https://github.com/catppuccin)主題 | -| `gruvbox` | 基於[gruvbox](https://github.com/morhetz/gruvbox)主題 | -| `kanagawa` | 基於[kanagawa](https://github.com/rebelot/kanagawa.nvim)主題 | -| `nord` | 基於[Nord](https://github.com/nordtheme/nord)主題 | -| `matrix` | 黑客風格黑底綠主題 | -| `one-dark` | 基於[One Dark](https://github.com/Th3Whit3Wolf/one-nvim) 深色主題 | +| 名稱 | 描述 | +| ---------------------- | ------------------------------------------------------------------ | +| `system` | 適應您終端機的背景顏色 | +| `tokyonight` | 基於 [Tokyo Night](https://github.com/folke/tokyonight.nvim) 主題 | +| `everforest` | 基於 [Everforest](https://github.com/sainnhe/everforest) 主題 | +| `ayu` | 基於 [Ayu](https://github.com/ayu-theme) 深色主題 | +| `catppuccin` | 基於 [Catppuccin](https://github.com/catppuccin) 主題 | +| `catppuccin-macchiato` | 基於 [Catppuccin](https://github.com/catppuccin) 主題 | +| `gruvbox` | 基於 [Gruvbox](https://github.com/morhetz/gruvbox) 主題 | +| `kanagawa` | 基於 [Kanagawa](https://github.com/rebelot/kanagawa.nvim) 主題 | +| `nord` | 基於 [Nord](https://github.com/nordtheme/nord) 主題 | +| `matrix` | 駭客風格黑底綠主題 | +| `one-dark` | 基於 [One Dark](https://github.com/Th3Whit3Wolf/one-nvim) 深色主題 | 此外，我們還在不斷添加新主題。 @@ -45,23 +45,23 @@ opencode 附帶了幾個內置主題。 ## 系統主題 -`system` 主題旨在自動適應您terminal的配色方案。與使用固定顏色的傳統主題不同，_system_ 主題： +`system` 主題旨在自動適應您終端機的配色方案。與使用固定顏色的傳統主題不同，_system_ 主題： -- **生成灰度**：根據terminal的背景顏色創建自定義灰度，確保最佳對比度。 -- **使用 ANSI 顏色**：利用標準 ANSI 顏色 (0-15) 進行語法突出顯示和 UI 元素，尊重terminal的調色板。 -- **保留terminal默認設置**：使用 `none` 作為文本和背景顏色，以保持terminal的本機外觀。 +- **生成灰階**：根據終端機的背景顏色建立自定義灰階，確保最佳對比度。 +- **使用 ANSI 顏色**：利用標準 ANSI 顏色 (0-15) 進行語法高亮顯示和 UI 元素，尊重終端機的調色盤。 +- **保留終端機預設設定**：使用 `none` 作為文字和背景顏色，以保持終端機的原生外觀。 -系統主題適合以下用戶： +系統主題適合以下使用者： -- 希望 opencode 與其terminal的外觀相匹配 -- 使用自定義terminal配色方案 -- 希望所有terminal應用程式具有一致的外觀 +- 希望 opencode 與其終端機的外觀相匹配 +- 使用自定義終端機配色方案 +- 希望所有終端機應用程式具有一致的外觀 --- ## 使用主題 -您可以通過使用 `/theme` 命令調出主題選擇來選擇主題。或者您可以在[配置](/docs/config) 中指定它。 +您可以透過使用 `/theme` 指令調出主題選擇來選擇主題。或者您可以在 [設定](/docs/config) 中指定它。 ```json title="opencode.json" {3} { @@ -74,35 +74,35 @@ opencode 附帶了幾個內置主題。 ## 自定義主題 -opencode 支持靈活的基於 JSON 的主題系統，允許用戶輕鬆創建和自定義主題。 +opencode 支援靈活的基於 JSON 的主題系統，允許使用者輕鬆建立和自定義主題。 --- -### 等級制度 +### 階層 -主題按以下順序從多個目錄加載，其中後面的目錄覆蓋前面的目錄： +主題按以下順序從多個目錄載入，其中後面的目錄覆寫前面的目錄： -1. **內置主題** - 這些主題嵌入在二進製文件中 -2. **用戶配置目錄** - 在`~/.config/opencode/themes/*.json` 或`$XDG_CONFIG_HOME/opencode/themes/*.json` 中定義 -3. **項目根目錄** - 定義在`/.opencode/themes/*.json` -4. **當前工作目錄** - 在`./.opencode/themes/*.json`中定義 +1. **內建主題** - 這些主題嵌入在二進位檔案中 +2. **使用者設定目錄** - 在 `~/.config/opencode/themes/*.json` 或 `$XDG_CONFIG_HOME/opencode/themes/*.json` 中定義 +3. **專案根目錄** - 定義在 `/.opencode/themes/*.json` +4. **當前工作目錄** - 在 `./.opencode/themes/*.json` 中定義 -如果多個目錄包含同名主題，則將使用優先級較高的目錄中的主題。 +如果多個目錄包含同名主題，則將使用優先順序較高的目錄中的主題。 --- -### 創建主題 +### 建立主題 -要創建自定義主題，請在主題目錄之一中創建一個 JSON 文件。 +要建立自定義主題，請在主題目錄之一中建立一個 JSON 檔案。 -對於用戶範圍的主題： +對於使用者範圍的主題： ```bash no-frame mkdir -p ~/.config/opencode/themes vim ~/.config/opencode/themes/my-theme.json ``` -以及針對特定項目的主題。 +以及針對特定專案的主題。 ```bash no-frame mkdir -p .opencode/themes @@ -111,36 +111,36 @@ vim .opencode/themes/my-theme.json --- -### JSON格式 +### JSON 格式 -主題使用靈活的 JSON 格式，支持： +主題使用靈活的 JSON 格式，支援： -- **十六進制顏色**：`"#ffffff"` +- **十六進位顏色**：`"#ffffff"` - **ANSI 顏色**：`3` (0-255) - **顏色參考**：`"primary"` 或自定義定義 - **深色/淺色版本**：`{"dark": "#000", "light": "#fff"}` -- **無顏色**：`"none"` - 使用terminal的默認顏色或透明 +- **無顏色**：`"none"` - 使用終端機的預設顏色或透明 --- ### 顏色定義 -`defs` 部分是可選的，它允許您定義可在主題中引用的可重用顏色。 +`defs` 部分是可選的，它允許您定義可在主題中引用的可重複使用顏色。 --- -### terminal默認值 +### 終端機預設值 -特殊值`"none"`可用於任何顏色以繼承terminal的默認顏色。這對於創建與terminal配色方案無縫融合的主題特別有用： +特殊值 `"none"` 可用於任何顏色以繼承終端機的預設顏色。這對於建立與終端機配色方案無縫融合的主題特別有用： -- `"text": "none"` - 使用terminal的默認前景色 -- `"background": "none"` - 使用terminal的默認背景顏色 +- `"text": "none"` - 使用終端機的預設前景色 +- `"background": "none"` - 使用終端機的預設背景顏色 --- -### 例子 +### 範例 -以下是自定義主題的示例： +以下是自定義主題的範例： ```json title="my-theme.json" { diff --git a/packages/web/src/content/docs/zh-tw/tools.mdx b/packages/web/src/content/docs/zh-tw/tools.mdx index 380b74c95..a030a5e84 100644 --- a/packages/web/src/content/docs/zh-tw/tools.mdx +++ b/packages/web/src/content/docs/zh-tw/tools.mdx @@ -1,17 +1,17 @@ --- title: 工具 -description: 管理LLM可以使用的工具。 +description: 管理 LLM 可以使用的工具。 --- -工具允許 LLM 在您的程式碼庫中執行操作。 opencode 附帶了一組內置工具，但您可以使用[定制工具](/docs/custom-tools) 或[MCP服務器](/docs/mcp-servers) 對其進行擴展。 +工具允許 LLM 在您的程式碼庫中執行操作。 opencode 附帶了一組內建工具，但您可以使用 [自定義工具](/docs/custom-tools) 或 [MCP 伺服器](/docs/mcp-servers) 對其進行擴展。 -默認情況下，所有工具都是**啟用**並且不需要運行權限。您可以通過[權限](/docs/permissions)控制工具行為。 +預設情況下，所有工具都是**啟用**並且不需要執行權限。您可以透過 [權限](/docs/permissions) 控制工具行為。 --- ## 配置 -使用 `permission` 字段控制工具行為。您可以允許、拒絕或要求批准每個工具。 +使用 `permission` 欄位控制工具行為。您可以允許、拒絕或要求批准每個工具。 ```json title="opencode.json" { @@ -24,7 +24,7 @@ description: 管理LLM可以使用的工具。 } ``` -您還可以使用通配符同時控制多個工具。例如，要求 MCP 服務器批准所有工具： +您還可以使用通配符同時控制多個工具。例如，要求 MCP 伺服器批准所有工具： ```json title="opencode.json" { @@ -41,13 +41,13 @@ description: 管理LLM可以使用的工具。 ## 內建 -以下是 opencode 中可用的所有內置工具。 +以下是 opencode 中可用的所有內建工具。 --- ### bash -在項目環境中執行 shell 命令。 +在專案環境中執行 shell 指令。 ```json title="opencode.json" {4} { @@ -58,13 +58,13 @@ description: 管理LLM可以使用的工具。 } ``` -該工具允許LLM運行 `npm install`、`git status` 等terminal 命令或任何其他 shell 命令。 +該工具允許 LLM 執行 `npm install`、`git status` 等終端機指令或任何其他 shell 指令。 --- ### edit -使用精確的字符串替換修改現有文件。 +使用精確的字串替換修改現有檔案。 ```json title="opencode.json" {4} { @@ -75,13 +75,13 @@ description: 管理LLM可以使用的工具。 } ``` -該工具通過替換精確的文本匹配來對文件執行精確編輯。這是LLM修改程式碼的主要方式。 +該工具透過替換精確的文字匹配來對檔案執行精確編輯。這是 LLM 修改程式碼的主要方式。 --- ### write -創建新文件或覆蓋現有文件。 +建立新檔案或覆蓋現有檔案。 ```json title="opencode.json" {4} { @@ -92,17 +92,17 @@ description: 管理LLM可以使用的工具。 } ``` -使用它允許LLM創建新文件。如果現有文件已經存在，它將覆蓋它們。 +使用它允許 LLM 建立新檔案。如果現有檔案已經存在，它將覆蓋它們。 :::note -`write`工具由`edit`權限控制，該權限涵蓋所有文件修改（`edit`、`write`、`patch`、`multiedit`）。 +`write` 工具由 `edit` 權限控制，該權限涵蓋所有檔案修改（`edit`、`write`、`patch`、`multiedit`）。 ::: --- ### read -從程式碼庫中讀取文件內容。 +從程式碼庫中讀取檔案內容。 ```json title="opencode.json" {4} { @@ -113,13 +113,13 @@ description: 管理LLM可以使用的工具。 } ``` -該工具讀取文件並返回其內容。它支持讀取大文件的特定行範圍。 +該工具讀取檔案並返回其內容。它支援讀取大檔案的特定行範圍。 --- ### grep -使用正則表達式搜索文件內容。 +使用正規表示式搜尋檔案內容。 ```json title="opencode.json" {4} { @@ -130,13 +130,13 @@ description: 管理LLM可以使用的工具。 } ``` -在您的程式碼庫中快速進行內容搜索。支持完整的正則表達式語法和文件模式過濾。 +在您的程式碼庫中快速進行內容搜尋。支援完整的正規表示式語法和檔案模式過濾。 --- ### glob -通過模式匹配查找文件。 +透過模式匹配尋找檔案。 ```json title="opencode.json" {4} { @@ -147,13 +147,13 @@ description: 管理LLM可以使用的工具。 } ``` -使用`**/*.js` 或`src/**/*.ts` 等全局模式搜索文件。返回按修改時間排序的匹配文件路徑。 +使用 `**/*.js` 或 `src/**/*.ts` 等全域模式搜尋檔案。返回按修改時間排序的匹配檔案路徑。 --- ### list -列出給定路徑中的文件和目錄。 +列出給定路徑中的檔案和目錄。 ```json title="opencode.json" {4} { @@ -164,16 +164,16 @@ description: 管理LLM可以使用的工具。 } ``` -該工具列出目錄內容。它接受全局模式來過濾結果。 +該工具列出目錄內容。它接受全域模式來過濾結果。 --- ### lsp（實驗性） -與您配置的 LSP 服務器交互，以獲得程式碼智能功能，例如定義、引用、懸停信息和調用層次結構。 +與您配置的 LSP 伺服器互動，以獲得程式碼智慧功能，例如定義、引用、游標懸停資訊和呼叫階層。 :::note -該工具僅在`OPENCODE_EXPERIMENTAL_LSP_TOOL=true`（或`OPENCODE_EXPERIMENTAL=true`）時可用。 +該工具僅在 `OPENCODE_EXPERIMENTAL_LSP_TOOL=true`（或 `OPENCODE_EXPERIMENTAL=true`）時可用。 ::: ```json title="opencode.json" {4} @@ -185,15 +185,15 @@ description: 管理LLM可以使用的工具。 } ``` -支持的操作包括`goToDefinition`、`findReferences`、`hover`、`documentSymbol`、`workspaceSymbol`、`goToImplementation`、`prepareCallHierarchy`、`incomingCalls` 和`outgoingCalls`。 +支援的操作包括 `goToDefinition`、`findReferences`、`hover`、`documentSymbol`、`workspaceSymbol`、`goToImplementation`、`prepareCallHierarchy`、`incomingCalls` 和 `outgoingCalls`。 -要配置哪些 LSP 服務器可用於您的項目，請參閱[LSP服務器](/docs/lsp)。 +要配置哪些 LSP 伺服器可用於您的專案，請參閱 [LSP 伺服器](/docs/lsp)。 --- ### patch -對文件應用補丁。 +對檔案套用 Patch。 ```json title="opencode.json" {4} { @@ -204,17 +204,17 @@ description: 管理LLM可以使用的工具。 } ``` -該工具將補丁文件應用到您的程式碼庫。對於應用來自各種來源的差異和補丁很有用。 +該工具將 Patch 檔案套用到您的程式碼庫。對於套用來自各種來源的差異和 Patch 很有用。 :::note -`patch`工具由`edit`權限控制，該權限涵蓋所有文件修改（`edit`、`write`、`patch`、`multiedit`）。 +`patch` 工具由 `edit` 權限控制，該權限涵蓋所有檔案修改（`edit`、`write`、`patch`、`multiedit`）。 ::: --- ### skill -加載[技能](/docs/skills)（`SKILL.md` 文件）並在對話中返回其內容。 +載入 [技能](/docs/skills)（`SKILL.md` 檔案）並在對話中返回其內容。 ```json title="opencode.json" {4} { @@ -229,7 +229,7 @@ description: 管理LLM可以使用的工具。 ### todowrite -在編碼會話期間管理待辦事項列表。 +在編碼工作階段期間管理待辦事項清單。 ```json title="opencode.json" {4} { @@ -240,17 +240,17 @@ description: 管理LLM可以使用的工具。 } ``` -創建和更新任務列表以跟踪複雜操作期間的進度。LLM使用它來組織多步驟任務。 +建立和更新任務列表以追蹤複雜操作期間的進度。LLM 使用它來組織多步驟任務。 :::note -默認情況下，子代理禁用此工具，但您可以手動啟用它。 [了解更多](/docs/agents/#permissions) +預設情況下，子代理禁用此工具，但您可以手動啟用它。 [了解更多](/docs/agents/#permissions) ::: --- ### todoread -閱讀現有的待辦事項列表。 +閱讀現有的待辦事項清單。 ```json title="opencode.json" {4} { @@ -261,10 +261,10 @@ description: 管理LLM可以使用的工具。 } ``` -讀取當前待辦事項列表狀態。LLM用來跟踪哪些任務待處理或已完成。 +讀取當前待辦事項清單狀態。LLM 用來追蹤哪些任務待處理或已完成。 :::note -默認情況下，子代理禁用此工具，但您可以手動啟用它。 [了解更多](/docs/agents/#permissions) +預設情況下，子代理禁用此工具，但您可以手動啟用它。 [了解更多](/docs/agents/#permissions) ::: --- @@ -282,16 +282,16 @@ description: 管理LLM可以使用的工具。 } ``` -允許LLM獲取和閱讀網頁。對於查找文檔或研究在線資源很有用。 +允許 LLM 獲取和閱讀網頁。對於尋找文件或研究線上資源很有用。 --- ### websearch -在網絡上搜索信息。 +在網路上搜尋資訊。 :::note -僅當使用 opencode 提供商或 `OPENCODE_ENABLE_EXA` 環境變量設置為任何真值（例如 `true` 或 `1`）時，此工具才可用。 +僅當使用 opencode 供應商或 `OPENCODE_ENABLE_EXA` 環境變數設定為任何真值（例如 `true` 或 `1`）時，此工具才可用。 要在啟動 opencode 時啟用： @@ -310,19 +310,19 @@ OPENCODE_ENABLE_EXA=1 opencode } ``` -使用 Exa AI 執行網絡搜索以在線查找相關信息。對於研究主題、查找時事或收集超出訓練數據截止範圍的信息很有用。 +使用 Exa AI 執行網路搜尋以線上尋找相關資訊。對於研究主題、尋找時事或收集超出訓練數據截止範圍的資訊很有用。 -不需要 API 密鑰 - 該工具無需身份驗證即可直接連接到 Exa AI 的託管 MCP 服務。 +不需要 API 金鑰 - 該工具無需身分驗證即可直接連接到 Exa AI 的託管 MCP 服務。 :::tip -當您需要查找信息（發現）時，請使用 `websearch`；當您需要從特定 URL 檢索內容（檢索）時，請使用 `webfetch`。 +當您需要尋找資訊（發現）時，請使用 `websearch`；當您需要從特定 URL 檢索內容（檢索）時，請使用 `webfetch`。 ::: --- ### question -在執行過程中詢問用戶問題。 +在執行過程中詢問使用者問題。 ```json title="opencode.json" {4} { @@ -333,42 +333,42 @@ OPENCODE_ENABLE_EXA=1 opencode } ``` -該工具允許LLM在任務期間詢問用戶問題。它適用於： +該工具允許 LLM 在任務期間詢問使用者問題。它適用於： -- 收集用戶偏好或要求 +- 收集使用者偏好或要求 - 澄清不明確的指令 -- 就實施選擇做出決策 +- 就實作選擇做出決策 - 提供選擇方向 -每個問題都包含標題、問題文本和選項列表。用戶可以從提供的選項中進行選擇或輸入自定義答案。當存在多個問題時，用戶可以在提交所有答案之前在這些問題之間導航。 +每個問題都包含標題、問題文字和選項列表。使用者可以從提供的選項中進行選擇或輸入自定義答案。當存在多個問題時，使用者可以在提交所有答案之前在這些問題之間導航。 --- -## 定制工具 +## 自定義工具 -自定義工具可讓您定義LLM可以調用的自己的函數。這些是在您的配置文件中定義的並且可以執行任意程式碼。 +自定義工具可讓您定義 LLM 可以呼叫的自己的函式。這些是在您的設定檔中定義的並且可以執行任意程式碼。 -[了解更多](/docs/custom-tools) 關於創建自定義工具。 +[了解更多](/docs/custom-tools) 關於建立自定義工具。 --- -## MCP服務器 +## MCP 伺服器 -MCP（模型上下文協議）服務器允許您集成外部工具和服務。這包括數據庫訪問、API 集成和第三方服務。 +MCP（模型上下文協定）伺服器允許您整合外部工具和服務。這包括資料庫存取、API 整合和第三方服務。 -[了解更多](/docs/mcp-servers) 關於配置 MCP 服務器。 +[了解更多](/docs/mcp-servers) 關於配置 MCP 伺服器。 --- ## 內部結構 -在內部，`grep`、`glob` 和`list` 等工具在底層使用[ripgrep](https://github.com/BurntSushi/ripgrep)。默認情況下，ripgrep 遵循 `.gitignore` 模式，這意味著 `.gitignore` 中列出的文件和目錄將從搜索和列表中排除。 +在內部，`grep`、`glob` 和 `list` 等工具在底層使用 [ripgrep](https://github.com/BurntSushi/ripgrep)。預設情況下，ripgrep 遵循 `.gitignore` 模式，這意味著 `.gitignore` 中列出的檔案和目錄將從搜尋和列表中排除。 --- ### 忽略模式 -要包含通常會被忽略的文件，請在項目根目錄中創建一個 `.ignore` 文件。該文件可以明確允許某些路徑。 +要包含通常會被忽略的檔案，請在專案根目錄中建立一個 `.ignore` 檔案。該檔案可以明確允許某些路徑。 ```text title=".ignore" !node_modules/ @@ -376,4 +376,4 @@ MCP（模型上下文協議）服務器允許您集成外部工具和服務。 !build/ ``` -例如，此 `.ignore` 文件允許 ripgrep 在 `node_modules/`、`dist/` 和 `build/` 目錄中搜索，即使它們列在 `.gitignore` 中。 +例如，此 `.ignore` 檔案允許 ripgrep 在 `node_modules/`、`dist/` 和 `build/` 目錄中搜尋，即使它們列在 `.gitignore` 中。 diff --git a/packages/web/src/content/docs/zh-tw/troubleshooting.mdx b/packages/web/src/content/docs/zh-tw/troubleshooting.mdx index cd9ed3012..17c5aa3a6 100644 --- a/packages/web/src/content/docs/zh-tw/troubleshooting.mdx +++ b/packages/web/src/content/docs/zh-tw/troubleshooting.mdx @@ -1,67 +1,67 @@ --- -title: 故障排除 +title: 疑難排解 description: 常見問題以及如何解決它們。 --- -要調試 opencode 問題，請首先檢查其存儲在磁盤上的日誌和本地數據。 +要除錯 opencode 問題，請首先檢查其儲存在磁碟上的日誌和本地數據。 --- -## 紀錄 +## 日誌 -日誌文件寫入： +日誌檔案寫入： - **macOS/Linux**：`~/.local/share/opencode/log/` -- **Windows**：按`WIN+R`並粘貼`%USERPROFILE%\.local\share\opencode\log` +- **Windows**：按 `WIN+R` 並貼上 `%USERPROFILE%\.local\share\opencode\log` -日誌文件以時間戳命名（例如`2025-01-09T123456.log`），並保留最近的 10 個日誌文件。 +日誌檔案以時間戳命名（例如 `2025-01-09T123456.log`），並保留最近的 10 個日誌檔案。 -您可以使用 `--log-level` 命令行選項設置日誌級別以獲取更詳細的調試信息。例如，`opencode --log-level DEBUG`。 +您可以使用 `--log-level` 命令列選項設定日誌等級以獲取更詳細的除錯資訊。例如，`opencode --log-level DEBUG`。 --- -## 存儲 +## 儲存 -opencode 將會話數據和其他應用程式數據存儲在磁盤上： +opencode 將工作階段數據和其他應用程式數據儲存在磁碟上： - **macOS/Linux**：`~/.local/share/opencode/` -- **Windows**：按`WIN+R`並粘貼`%USERPROFILE%\.local\share\opencode` +- **Windows**：按 `WIN+R` 並貼上 `%USERPROFILE%\.local\share\opencode` 該目錄包含： -- `auth.json` - 身份驗證數據，例如 API 密鑰、OAuth 令牌 +- `auth.json` - 身分驗證數據，例如 API 金鑰、OAuth 令牌 - `log/` - 應用程式日誌 -- `project/` - 項目特定數據，例如會話和消息數據 - - 如果項目位於 Git 存儲庫中，則它存儲在 `.//storage/` 中 - - 如果不是 Git 存儲庫，則存儲在 `./global/storage/` 中 +- `project/` - 專案特定數據，例如工作階段和訊息數據 + - 如果專案位於 Git 儲存庫中，則它儲存在 `.//storage/` 中 + - 如果不是 Git 儲存庫，則儲存在 `./global/storage/` 中 --- ## 桌面應用程式 -opencode Desktop 在後台運行本地 opencode 服務器（`opencode-cli` sidecar）。大多數問題是由行為不當的插件、損壞的緩存或錯誤的服務器設置引起的。 +opencode Desktop 在背景執行本地 opencode 伺服器（`opencode-cli` sidecar）。大多數問題是由行為不當的外掛、損壞的快取或錯誤的伺服器設定引起的。 ### 快速檢查 - 完全退出並重新啟動應用程式。 -- 如果應用程式顯示錯誤屏幕，請單擊“**重新啟動**”並複制錯誤詳細信息。 -- 僅限 macOS：`OpenCode` 菜單 -> **重新加載 Webview**（如果 UI 為空白/凍結，則有幫助）。 +- 如果應用程式顯示錯誤螢幕，請單擊「**重新啟動**」並複製錯誤詳細資訊。 +- 僅限 macOS：`OpenCode` 選單 -> **重新載入 Webview**（如果 UI 為空白/凍結，則有幫助）。 --- -### 禁用插件 +### 禁用外掛 -如果桌面應用程式在啟動時崩潰、掛起或行為異常，請首先禁用插件。 +如果桌面應用程式在啟動時崩潰、卡住或行為異常，請首先禁用外掛。 -#### 檢查全局配置 +#### 檢查全域配置 -打開全局配置文件並查找 `plugin` 密鑰。 +打開全域設定檔並查找 `plugin` 鍵。 -- **macOS/Linux**：`~/.config/opencode/opencode.jsonc`（或`~/.config/opencode/opencode.json`） +- **macOS/Linux**：`~/.config/opencode/opencode.jsonc`（或 `~/.config/opencode/opencode.json`） - **macOS/Linux**（較舊的安裝）：`~/.local/share/opencode/opencode.jsonc` -- **Windows**：按`WIN+R`並粘貼`%USERPROFILE%\.config\opencode\opencode.jsonc` +- **Windows**：按 `WIN+R` 並貼上 `%USERPROFILE%\.config\opencode\opencode.jsonc` -如果您配置了插件，請通過刪除密鑰或將其設置為空數組來暫時禁用它們： +如果您配置了外掛，請透過刪除鍵或將其設定為空陣列來暫時禁用它們： ```jsonc { @@ -70,75 +70,75 @@ opencode Desktop 在後台運行本地 opencode 服務器（`opencode-cli` sidec } ``` -#### 檢查插件目錄 +#### 檢查外掛目錄 -opencode 還可以從磁盤加載本地插件。暫時將它們移開（或重命名文件夾）並重新啟動桌面應用程式： +opencode 還可以從磁碟載入本地外掛。暫時將它們移開（或重命名資料夾）並重新啟動桌面應用程式： -- **全局插件** +- **全域外掛** - **macOS/Linux**：`~/.config/opencode/plugins/` - - **Windows**：按`WIN+R`並粘貼`%USERPROFILE%\.config\opencode\plugins` -- **項目插件**（僅當您使用每個項目配置時） + - **Windows**：按 `WIN+R` 並貼上 `%USERPROFILE%\.config\opencode\plugins` +- **專案外掛**（僅當您使用每個專案配置時） - `/.opencode/plugins/` -如果應用程式再次開始工作，請一次重新啟用一個插件，以找出導致問題的插件。 +如果應用程式再次開始工作，請一次重新啟用一個外掛，以找出導致問題的外掛。 --- -### 清除緩存 +### 清除快取 -如果禁用插件沒有幫助（或者插件安裝被卡住），請清除緩存，以便 opencode 可以重建它。 +如果禁用外掛沒有幫助（或者外掛安裝被卡住），請清除快取，以便 opencode 可以重建它。 1. 完全退出 opencode Desktop。 -2. 刪除緩存目錄： +2. 刪除快取目錄： -- **macOS**：Finder -> `Cmd+Shift+G` -> 粘貼`~/.cache/opencode` -- **Linux**：刪除`~/.cache/opencode`（或運行`rm -rf ~/.cache/opencode`） -- **Windows**：按`WIN+R`並粘貼`%USERPROFILE%\.cache\opencode` +- **macOS**：Finder -> `Cmd+Shift+G` -> 貼上 `~/.cache/opencode` +- **Linux**：刪除 `~/.cache/opencode`（或執行 `rm -rf ~/.cache/opencode`） +- **Windows**：按 `WIN+R` 並貼上 `%USERPROFILE%\.cache\opencode` 3. 重新啟動 opencode 桌面。 --- -### 修復服務器連接問題 +### 修復伺服器連接問題 -opencode Desktop 可以啟動自己的本地服務器（默認）或連接到您配置的服務器 URL。 +opencode Desktop 可以啟動自己的本地伺服器（預設）或連接到您配置的伺服器 URL。 -如果您看到 **“連接失敗”** 對話框（或者應用程式永遠無法通過啟動屏幕），請檢查自定義服務器 URL。 +如果您看到 **「連接失敗」** 對話方塊（或者應用程式永遠無法通過啟動螢幕），請檢查自定義伺服器 URL。 -#### 清除桌面默認服務器 URL +#### 清除桌面預設伺服器 URL -在主屏幕中，單擊服務器名稱（帶有狀態點）以打開服務器選取器。在“**默認服務器**”部分中，單擊“**清除**”。 +在主螢幕中，單擊伺服器名稱（帶有狀態點）以打開伺服器選取器。在「**預設伺服器**」部分中，單擊「**清除**」。 -#### 從您的配置中刪除`server.port` / `server.hostname` +#### 從您的配置中刪除 `server.port` / `server.hostname` 如果您的 `opencode.json(c)` 包含 `server` 部分，請將其暫時刪除並重新啟動桌面應用程式。 -#### 檢查環境變量 +#### 檢查環境變數 -如果您在環境中設置了 `OPENCODE_PORT`，桌面應用程式將嘗試將該端口用於本地服務器。 +如果您在環境中設定了 `OPENCODE_PORT`，桌面應用程式將嘗試將該連接埠用於本地伺服器。 -- 取消設置`OPENCODE_PORT`（或選擇一個空閒端口）並重新啟動。 +- 取消設定 `OPENCODE_PORT`（或選擇一個空閒連接埠）並重新啟動。 --- ### Linux：Wayland / X11 問題 -在 Linux 上，某些 Wayland 設置可能會導致空白窗口或合成器錯誤。 +在 Linux 上，某些 Wayland 設定可能會導致空白視窗或合成器錯誤。 - 如果您在 Wayland 上且應用程式空白/崩潰，請嘗試使用 `OC_ALLOW_WAYLAND=1` 啟動。 -- 如果這讓事情變得更糟，請將其刪除並嘗試在 X11 會話下啟動。 +- 如果這讓事情變得更糟，請將其刪除並嘗試在 X11 工作階段下啟動。 --- -### Windows：WebView2 運行時 +### Windows：WebView2 執行時 -在 Windows 上，opencode Desktop 需要 Microsoft Edge **WebView2 運行時**。如果應用程式打開為空白窗口或無法啟動，請安裝/更新 WebView2，然後重試。 +在 Windows 上，opencode Desktop 需要 Microsoft Edge **WebView2 執行時**。如果應用程式打開為空白視窗或無法啟動，請安裝/更新 WebView2，然後重試。 --- ### Windows：一般性能問題 -如果您在 Windows 上遇到性能緩慢、文件訪問問題或terminal問題，請嘗試使用[WSL（適用於 Linux 的 Windows 子系統）](/docs/windows-wsl)。 WSL 提供了一個可以與 opencode 功能更加無縫協作的 Linux 環境。 +如果您在 Windows 上遇到性能緩慢、檔案存取問題或終端機問題，請嘗試使用 [WSL（適用於 Linux 的 Windows 子系統）](/docs/windows-wsl)。 WSL 提供了一個可以與 opencode 功能更加無縫協作的 Linux 環境。 --- @@ -146,26 +146,26 @@ opencode Desktop 可以啟動自己的本地服務器（默認）或連接到您 opencode Desktop 僅在以下情況下顯示系統通知： -- 在您的操作系統設置中啟用 opencode 通知，並且 -- 應用程式窗口未聚焦。 +- 在您的作業系統設定中啟用 opencode 通知，並且 +- 應用程式視窗未聚焦。 --- -### 重置桌面應用程式存儲（最後的手段） +### 重置桌面應用程式儲存（最後手段） -如果應用程式無法啟動並且您無法從 UI 內部清除設置，請重置桌面應用程式的保存狀態。 +如果應用程式無法啟動並且您無法從 UI 內部清除設定，請重置桌面應用程式的保存狀態。 1. 退出 opencode Desktop。 -2. 查找並刪除這些文件（它們位於 opencode Desktop 應用程式數據目錄中）： +2. 查找並刪除這些檔案（它們位於 opencode Desktop 應用程式資料目錄中）： -- `opencode.settings.dat`（桌面默認服務器 URL） -- `opencode.global.dat` 和 `opencode.workspace.*.dat`（UI 狀態，如最近的服務器/項目） +- `opencode.settings.dat`（桌面預設伺服器 URL） +- `opencode.global.dat` 和 `opencode.workspace.*.dat`（UI 狀態，如最近的伺服器/專案） 快速找到目錄： -- **macOS**：Finder -> `Cmd+Shift+G` -> `~/Library/Application Support`（然後搜索上面的文件名） -- **Linux**：在 `~/.local/share` 下搜索上述文件名 -- **Windows**：按`WIN+R` -> `%APPDATA%`（然後搜索上面的文件名） +- **macOS**：Finder -> `Cmd+Shift+G` -> `~/Library/Application Support`（然後搜尋上面的檔名） +- **Linux**：在 `~/.local/share` 下搜尋上述檔名 +- **Windows**：按 `WIN+R` -> `%APPDATA%`（然後搜尋上面的檔名） --- @@ -175,15 +175,15 @@ opencode Desktop 僅在以下情況下顯示系統通知： 1. **在 GitHub 上報告問題** - 報告錯誤或請求功能的最佳方式是通過我們的 GitHub 存儲庫： + 報告錯誤或請求功能的最佳方式是透過我們的 GitHub 儲存庫： [**github.com/anomalyco/opencode/issues**](https://github.com/anomalyco/opencode/issues) - 在創建新問題之前，請搜索現有問題以查看您的問題是否已被報告。 + 在建立新問題之前，請搜尋現有問題以查看您的問題是否已被報告。 -2. **加入我們的不和諧** +2. **加入我們的 Discord** - 如需實時幫助和社區討論，請加入我們的 Discord 服務器： + 如需即時幫助和社群討論，請加入我們的 Discord 伺服器： [**opencode.ai/discord**](https://opencode.ai/discord) @@ -197,48 +197,48 @@ opencode Desktop 僅在以下情況下顯示系統通知： ### opencode 無法啟動 -1. 檢查日誌中是否有錯誤消息 -2. 嘗試使用 `--print-logs` 運行以查看terminal 中的輸出 -3. 確保您擁有最新版本`opencode upgrade` +1. 檢查日誌中是否有錯誤訊息 +2. 嘗試使用 `--print-logs` 執行以查看終端機中的輸出 +3. 確保您擁有最新版本 `opencode upgrade` --- -### 身份驗證問題 +### 身分驗證問題 -1. 嘗試使用 TUI 中的 `/connect` 命令重新進行身份驗證 -2. 檢查您的 API 密鑰是否有效 -3. 確保您的網絡允許連接到提供商的 API +1. 嘗試使用 TUI 中的 `/connect` 指令重新進行身分驗證 +2. 檢查您的 API 金鑰是否有效 +3. 確保您的網路允許連接到供應商的 API --- -### 型號不可用 +### 模型不可用 -1. 檢查您是否已通過提供商的身份驗證 -2. 驗證配置中的型號名稱是否正確 -3. 某些型號可能需要特定的訪問權限或訂閱 +1. 檢查您是否已通過供應商的身分驗證 +2. 驗證配置中的模型名稱是否正確 +3. 某些模型可能需要特定的存取權限或訂閱 -如果您遇到`ProviderModelNotFoundError`，您很可能是錯誤的 +如果您遇到 `ProviderModelNotFoundError`，您很可能是錯誤的 在某處引用模型。 模型應該像這樣引用：`/` -示例： +範例： - `openai/gpt-4.1` - `openrouter/google/gemini-2.5-flash` - `opencode/kimi-k2` -要了解您可以訪問哪些模型，請運行`opencode models` +要了解您可以存取哪些模型，請執行 `opencode models` --- -### 提供者初始化錯誤 +### 供應商初始化錯誤 如果遇到 ProviderInitError，您的配置可能無效或損壞。 要解決這個問題： -1. 首先，按照 [供應商指南](/docs/providers) 驗證您的提供商是否已正確設置 -2. 如果問題仍然存在，請嘗試清除存儲的配置： +1. 首先，按照 [供應商指南](/docs/providers) 驗證您的供應商是否已正確設定 +2. 如果問題仍然存在，請嘗試清除儲存的配置： ```bash rm -rf ~/.local/share/opencode @@ -246,17 +246,17 @@ opencode Desktop 僅在以下情況下顯示系統通知： 在 Windows 上，按 `WIN+R` 並刪除：`%USERPROFILE%\.local\share\opencode` -3. 使用 TUI 中的 `/connect` 命令向您的提供商重新進行身份驗證。 +3. 使用 TUI 中的 `/connect` 指令向您的供應商重新進行身分驗證。 --- -### AI_APICallError 和提供商套件問題 +### AI_APICallError 和供應商套件問題 -如果您遇到 API 調用錯誤，這可能是由於過時的提供商套件造成的。 opencode 根據需要動態安裝提供商套件（OpenAI、Anthropic、Google 等）並將其緩存在本地。 +如果您遇到 API 呼叫錯誤，這可能是由於過時的供應商套件造成的。 opencode 根據需要動態安裝供應商套件（OpenAI、Anthropic、Google 等）並將其快取在本地。 -要解決提供商套件問題： +要解決供應商套件問題： -1. 清除提供商套件緩存： +1. 清除供應商套件快取： ```bash rm -rf ~/.cache/opencode @@ -264,15 +264,15 @@ opencode Desktop 僅在以下情況下顯示系統通知： 在 Windows 上，按 `WIN+R` 並刪除：`%USERPROFILE%\.cache\opencode` -2. 重新啟動 opencode 以重新安裝最新的提供商套件 +2. 重新啟動 opencode 以重新安裝最新的供應商套件 -這將強制 opencode 下載最新版本的提供商套件，這通常可以解決模型參數和 API 更改的兼容性問題。 +這將強制 opencode 下載最新版本的供應商套件，這通常可以解決模型參數和 API 更改的相容性問題。 --- -### 複製/粘貼在 Linux 上不起作用 +### 複製/貼上在 Linux 上不起作用 -Linux 用戶需要安裝以下剪貼板實用程序之一才能使用複制/粘貼功能： +Linux 使用者需要安裝以下剪貼簿公用程式之一才能使用複製/貼上功能： **對於 X11 系統：** @@ -288,7 +288,7 @@ apt install -y xsel apt install -y wl-clipboard ``` -**對於無頭環境：** +**對於無介面環境：** ```bash apt install -y xvfb @@ -297,4 +297,4 @@ Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 & export DISPLAY=:99.0 ``` -opencode 將檢測您是否使用 Wayland 並更喜歡 `wl-clipboard`，否則它將嘗試按 `xclip` 和 `xsel` 的順序查找剪貼板工具。 +opencode 將檢測您是否使用 Wayland 並更喜歡 `wl-clipboard`，否則它將嘗試按 `xclip` 和 `xsel` 的順序尋找剪貼簿工具。 diff --git a/packages/web/src/content/docs/zh-tw/tui.mdx b/packages/web/src/content/docs/zh-tw/tui.mdx index b64ada84c..f234bad8c 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: TUI -description: 使用 OpenCode terminal 用戶介面。 +description: 使用 OpenCode 終端機使用者介面。 --- import { Tabs, TabItem } from "@astrojs/starlight/components" -OpenCode 提供了一個交互式 terminal 介面或 TUI，供您與 LLM 一起處理項目。 +OpenCode 提供了一個互動式終端機介面或 TUI，供您與 LLM 一起處理專案。 -運行 OpenCode 會啟動當前目錄的 TUI。 +執行 OpenCode 會啟動當前目錄的 TUI。 ```bash opencode @@ -19,7 +19,7 @@ opencode opencode /path/to/project ``` -進入 TUI 後，您可以通過消息進行提示。 +進入 TUI 後，您可以透過訊息進行提示。 ```text Give me a quick summary of the codebase. @@ -27,51 +27,51 @@ Give me a quick summary of the codebase. --- -## 文件參考 +## 檔案參考 -您可以使用 `@` 在消息中引用文件。這會在當前工作目錄中進行模糊文件搜索。 +您可以使用 `@` 在訊息中引用檔案。這會在當前工作目錄中進行模糊檔案搜尋。 :::tip -您還可以使用 `@` 來引用消息中的文件。 +您還可以使用 `@` 來引用訊息中的檔案。 ::: ```text "@packages/functions/src/api/index.ts" How is auth handled in @packages/functions/src/api/index.ts? ``` -文件的內容會自動添加到對話中。 +檔案的內容會自動添加到對話中。 --- -## Bash 命令 +## Bash 指令 -以 `!` 開始一條消息以運行 shell 命令。 +以 `!` 開始一條訊息以執行 shell 指令。 ```bash frame="none" !ls -la ``` -命令的輸出將作為工具結果添加到對話中。 +指令的輸出將作為工具結果添加到對話中。 --- -## 命令 +## 指令 -使用 OpenCode TUI 時，您可以鍵入 `/` 後跟命令名稱來快速執行操作。例如： +使用 OpenCode TUI 時，您可以輸入 `/` 後跟指令名稱來快速執行操作。例如： ```bash frame="none" /help ``` -Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` is the default leader key. [了解更多](/docs/keybinds)。 +大多數指令也有使用 `ctrl+x` 作為 Leader 鍵的按鍵綁定，其中 `ctrl+x` 是預設的 Leader 鍵。 [了解更多](/docs/keybinds)。 -以下是所有可用的斜杠命令： +以下是所有可用的斜線指令： --- ### connect -將提供商添加到 OpenCode。允許您從可用的提供商中進行選擇並添加其 API 密鑰。 +將供應商添加到 OpenCode。允許您從可用的供應商中進行選擇並添加其 API 金鑰。 ```bash frame="none" /connect @@ -81,7 +81,7 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` ### compact -壓縮當前會話。 _別名_：`/summarize` +壓縮當前工作階段。 _別名_：`/summarize` ```bash frame="none" /compact @@ -93,7 +93,7 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` ### details -切換工具執行詳細信息。 +切換工具執行詳細資訊。 ```bash frame="none" /details @@ -105,7 +105,7 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` ### editor -打開外部編輯器來撰寫消息。使用 `EDITOR` 環境變量中設置的編輯器。 [了解更多](#editor-setup)。 +打開外部編輯器來撰寫訊息。使用 `EDITOR` 環境變數中設定的編輯器。 [了解更多](#editor-setup)。 ```bash frame="none" /editor @@ -129,7 +129,7 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` ### export -將當前對話導出到 Markdown 並在默認編輯器中打開。使用 `EDITOR` 環境變量中設置的編輯器。 [了解更多](#editor-setup)。 +將當前對話導出到 Markdown 並在預設編輯器中打開。使用 `EDITOR` 環境變數中設定的編輯器。 [了解更多](#editor-setup)。 ```bash frame="none" /export @@ -141,7 +141,7 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` ### help -顯示幫助對話框。 +顯示說明對話方塊。 ```bash frame="none" /help @@ -153,7 +153,7 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` ### init -創建或更新`AGENTS.md` 文件。 [了解更多](/docs/rules)。 +建立或更新 `AGENTS.md` 檔案。 [了解更多](/docs/rules)。 ```bash frame="none" /init @@ -165,7 +165,7 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` ### models -列出可用型號。 +列出可用模型。 ```bash frame="none" /models @@ -177,7 +177,7 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` ### new -開始新的會話。 _別名_：`/clear` +開始新的工作階段。 _別名_：`/clear` ```bash frame="none" /new @@ -189,14 +189,14 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` ### redo -重做之前撤消的消息。僅在使用`/undo`後可用。 +重做之前撤銷的訊息。僅在使用 `/undo` 後可用。 :::tip -任何文件更改也將被恢復。 +任何檔案變更也將被恢復。 ::: -在內部，這使用 Git 來管理文件更改。所以你的項目**需要 -是一個 Git 存儲庫**。 +在內部，這使用 Git 來管理檔案變更。所以你的專案**需要 +是一個 Git 儲存庫**。 ```bash frame="none" /redo @@ -208,7 +208,7 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` ### sessions -列出會話並在會話之間切換。 _別名_：`/resume`、`/continue` +列出工作階段並在工作階段之間切換。 _別名_：`/resume`、`/continue` ```bash frame="none" /sessions @@ -220,7 +220,7 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` ### share -共享當前會話。 [了解更多](/docs/share)。 +分享當前工作階段。 [了解更多](/docs/share)。 ```bash frame="none" /share @@ -244,10 +244,10 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` ### thinking -切換對話中思維/推理塊的可見性。啟用後，您可以看到支持擴展思維的模型的推理過程。 +切換對話中思考/推理區塊的可見性。啟用後，您可以看到支援擴展思考的模型的推理過程。 :::note -該命令僅控制是否**顯示** - 它不啟用或禁用模型的推理功能。要切換實際推理功能，請使用 `ctrl+t` 循環切換模型變體。 +該指令僅控制是否**顯示** - 它不啟用或禁用模型的推理功能。要切換實際推理功能，請使用 `ctrl+t` 循環切換模型變體。 ::: ```bash frame="none" @@ -258,14 +258,14 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` ### undo -撤消對話中的最後一條消息。刪除最近的用戶消息、所有後續響應以及任何文件更改。 +撤銷對話中的最後一條訊息。刪除最近的使用者訊息、所有後續回應以及任何檔案變更。 :::tip -所做的任何文件更改也將被恢復。 +所做的任何檔案變更也將被恢復。 ::: -在內部，這使用 Git 來管理文件更改。所以你的項目**需要 -是一個 Git 存儲庫**。 +在內部，這使用 Git 來管理檔案變更。所以你的專案**需要 +是一個 Git 儲存庫**。 ```bash frame="none" /undo @@ -277,7 +277,7 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` ### unshare -取消共享當前會話。 [了解更多](/docs/share#un-sharing)。 +取消分享當前工作階段。 [了解更多](/docs/share#un-sharing)。 ```bash frame="none" /unshare @@ -285,9 +285,9 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` --- -## 編輯器設置 +## 編輯器設定 -`/editor` 和`/export` 命令都使用`EDITOR` 環境變量中指定的編輯器。 +`/editor` 和 `/export` 指令都使用 `EDITOR` 環境變數中指定的編輯器。 @@ -346,16 +346,16 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` - `subl` - Sublime Text :::note -某些編輯器（例如 VS Code）需要以 `--wait` 標誌啟動。 +某些編輯器（例如 VS Code）需要以 `--wait` 旗標啟動。 ::: -某些編輯器需要命令行參數才能在阻止模式下運行。 `--wait` 標誌使編輯器進程阻塞直到關閉。 +某些編輯器需要命令列參數才能在阻止模式下執行。 `--wait` 旗標使編輯器處理程序阻塞直到關閉。 --- ## 配置 -您可以通過 OpenCode 配置文件自定義 TUI 行為。 +您可以透過 OpenCode 設定檔自定義 TUI 行為。 ```json title="opencode.json" { @@ -371,20 +371,20 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` ### 選項 -- `scroll_acceleration` - 啟用 macOS 風格的滾動加速，實現平滑、自然的滾動。啟用後，滾動速度會隨著快速滾動手勢而增加，並在較慢的移動時保持精確。 **此設置優先於`scroll_speed`，並在啟用時覆蓋它。 ** -- `scroll_speed` - 控制使用滾動命令時 TUI 滾動的速度（最小值：`1`）。默認為`3`。 **注意：如果`scroll_acceleration.enabled` 設置為`true`，則忽略此設置。 ** +- `scroll_acceleration` - 啟用 macOS 風格的捲動加速，實現平滑、自然的捲動。啟用後，捲動速度會隨著快速捲動手勢而增加，並在較慢的移動時保持精確。 **此設定優先於 `scroll_speed`，並在啟用時覆寫它。** +- `scroll_speed` - 控制使用捲動指令時 TUI 捲動的速度（最小值：`1`）。預設為 `3`。 **注意：如果 `scroll_acceleration.enabled` 設定為 `true`，則忽略此設定。** --- -## 定制化 +## 自定義 -您可以使用命令選項板（`ctrl+x h` 或`/help`）自定義 TUI 視圖的各個方面。這些設置在重新啟動後仍然存在。 +您可以使用指令面板（`ctrl+x h` 或 `/help`）自定義 TUI 視圖的各個方面。這些設定在重新啟動後仍然存在。 --- -#### 用戶名顯示 +#### 使用者名稱顯示 -切換您的用戶名是否出現在聊天消息中。通過以下方式訪問： +切換您的使用者名稱是否出現在聊天訊息中。透過以下方式存取： -- 命令面板：搜索“用戶名”或“隱藏用戶名” -- 該設置會自動保留並在 TUI 會話中被記住 +- 指令面板：搜尋「使用者名稱」或「隱藏使用者名稱」 +- 該設定會自動保留並在 TUI 工作階段中被記住 diff --git a/packages/web/src/content/docs/zh-tw/web.mdx b/packages/web/src/content/docs/zh-tw/web.mdx index ef2391a6a..548307ffb 100644 --- a/packages/web/src/content/docs/zh-tw/web.mdx +++ b/packages/web/src/content/docs/zh-tw/web.mdx @@ -1,70 +1,70 @@ --- -title: 網絡 +title: Web description: 在瀏覽器中使用 opencode。 --- -opencode 可以在瀏覽器中作為 Web 應用程式運行，無需terminal即可提供同樣強大的 AI 編碼體驗。 +opencode 可以在瀏覽器中作為 Web 應用程式執行，無需終端機即可提供同樣強大的 AI 程式碼體驗。 -![opencode Web - 新會話](../../../assets/web/web-homepage-new-session.png) +![opencode Web - 新工作階段](../../../assets/web/web-homepage-new-session.png) ## 入門 -通過運行以下命令啟動 Web 介面： +透過執行以下指令啟動 Web 介面： ```bash opencode web ``` -這將在 `127.0.0.1` 上啟動一個具有隨機可用端口的本地服務器，並自動在默認瀏覽器中打開 opencode。 +這將在 `127.0.0.1` 上啟動一個具有隨機可用連接埠的本地伺服器，並自動在預設瀏覽器中打開 opencode。 :::caution -如果未設置`OPENCODE_SERVER_PASSWORD`，服務器將不安全。這對於本地使用來說很好，但應該針對網絡訪問進行設置。 +如果未設定 `OPENCODE_SERVER_PASSWORD`，伺服器將不安全。這對於本地使用來說很好，但應該針對網路存取進行設定。 ::: -:::tip[Windows 用戶] -為了獲得最佳體驗，請從 [WSL](/docs/windows-wsl) 而不是 PowerShell 運行 `opencode web`。這確保了正確的檔案系統訪問和terminal集成。 +:::tip[Windows 使用者] +為了獲得最佳體驗，請從 [WSL](/docs/windows-wsl) 而不是 PowerShell 執行 `opencode web`。這確保了正確的檔案系統存取和終端機整合。 ::: --- ## 配置 -您可以使用命令行標誌或在 [配置文件](/docs/config) 中配置 Web 服務器。 +您可以使用命令列旗標或在 [設定檔](/docs/config) 中配置 Web 伺服器。 -### 港口 +### 連接埠 -默認情況下，opencode 選擇一個可用端口。您可以指定一個端口： +預設情況下，opencode 選擇一個可用連接埠。您可以指定一個連接埠： ```bash opencode web --port 4096 ``` -### 主機名 +### 主機名稱 -默認情況下，服務器綁定到`127.0.0.1`（僅限本地主機）。要使 opencode 在您的網絡上可訪問： +預設情況下，伺服器綁定到 `127.0.0.1`（僅限 localhost）。要使 opencode 在您的網路上可存取： ```bash opencode web --hostname 0.0.0.0 ``` -當使用`0.0.0.0`時，opencode將顯示本地地址和網絡地址： +當使用 `0.0.0.0` 時，opencode 將顯示本地位址和網路位址： ``` Local access: http://localhost:4096 Network access: http://192.168.1.100:4096 ``` -### mDNS 發現 +### mDNS 探索 -啟用 mDNS 以使您的服務器在本地網絡上可發現： +啟用 mDNS 以使您的伺服器在本地網路上可探索： ```bash opencode web --mdns ``` -這會自動將主機名設置為 `0.0.0.0` 並將服務器通告為 `opencode.local`。 +這會自動將主機名稱設定為 `0.0.0.0` 並將伺服器廣播為 `opencode.local`。 -您可以自定義 mDNS 域名以在同一網絡上運行多個實例： +您可以自定義 mDNS 網域名稱以在同一網路上執行多個實例： ```bash opencode web --mdns --mdns-domain myproject.local @@ -78,39 +78,39 @@ opencode web --mdns --mdns-domain myproject.local opencode web --cors https://example.com ``` -### 驗證 +### 身分驗證 -要保護訪問，請使用 `OPENCODE_SERVER_PASSWORD` 環境變量設置密碼： +要保護存取，請使用 `OPENCODE_SERVER_PASSWORD` 環境變數設定密碼： ```bash OPENCODE_SERVER_PASSWORD=secret opencode web ``` -用戶名默認為`opencode`，但可以使用`OPENCODE_SERVER_USERNAME` 進行更改。 +使用者名稱預設為 `opencode`，但可以使用 `OPENCODE_SERVER_USERNAME` 進行更改。 --- -## 使用網絡介面 +## 使用 Web 介面 -啟動後，Web 介面將提供對 opencode 會話的訪問。 +啟動後，Web 介面將提供對 opencode 工作階段的存取。 -### 會議 +### 工作階段 -從主頁查看和管理您的會話。您可以查看活動會話並開始新會話。 +從主頁查看和管理您的工作階段。您可以查看活動工作階段並開始新工作階段。 -![opencode Web - 活動會話](../../../assets/web/web-homepage-active-session.png) +![opencode Web - 活動工作階段](../../../assets/web/web-homepage-active-session.png) -### 服務器狀態 +### 伺服器狀態 -單擊“查看服務器”可查看連接的服務器及其狀態。 +單擊「查看伺服器」可查看連接的伺服器及其狀態。 -![opencode Web - 查看服務器](../../../assets/web/web-homepage-see-servers.png) +![opencode Web - 查看伺服器](../../../assets/web/web-homepage-see-servers.png) --- -## 連接terminal +## 連接終端機 -您可以將terminal TUI 連接到正在運行的 Web 服務器： +您可以將終端機 TUI 連接到正在執行的 Web 伺服器： ```bash # Start the web server @@ -120,13 +120,13 @@ opencode web --port 4096 opencode attach http://localhost:4096 ``` -這允許您同時使用 Web 介面和terminal，共享相同的會話和狀態。 +這允許您同時使用 Web 介面和終端機，共享相同的工作階段和狀態。 --- -## 配置文件 +## 設定檔 -您還可以在 `opencode.json` 配置文件中配置服務器設置： +您還可以在 `opencode.json` 設定檔中配置伺服器設定： ```json { @@ -139,4 +139,4 @@ opencode attach http://localhost:4096 } ``` -命令行標誌優先於配置文件設置。 +命令列旗標優先於設定檔設定。 diff --git a/packages/web/src/content/docs/zh-tw/zen.mdx b/packages/web/src/content/docs/zh-tw/zen.mdx index c163febe0..142597fad 100644 --- a/packages/web/src/content/docs/zh-tw/zen.mdx +++ b/packages/web/src/content/docs/zh-tw/zen.mdx @@ -1,5 +1,5 @@ --- -title: 禪 +title: Zen description: opencode 提供的精選模型列表。 --- @@ -13,56 +13,56 @@ OpenCode Zen 是 opencode 團隊提供的經過測試和驗證的模型列表。 OpenCode Zen 目前處於測試階段。 ::: -Zen 的工作方式與 opencode 中的任何其他提供商一樣。您登錄 OpenCode Zen 並獲取 -您的 API 密鑰。它是**完全可選的**，您不需要使用它即可使用 +Zen 的工作方式與 opencode 中的任何其他供應商一樣。您登入 OpenCode Zen 並獲取 +您的 API 金鑰。它是**完全可選的**，您不需要使用它即可使用 opencode。 --- ## 背景 -市面上有很多型號，但其中只有少數幾個 -這些模型可以很好地用作編碼代理。此外，大多數提供商都 +市面上有很多模型，但其中只有少數幾個 +這些模型可以很好地用作程式碼代理。此外，大多數供應商都 配置非常不同；所以你會得到截然不同的性能和質量。 :::tip -我們測試了一組精選的與 opencode 配合良好的模型和提供商。 +我們測試了一組精選的與 opencode 配合良好的模型和供應商。 ::: -因此，如果您通過 OpenRouter 之類的東西使用模型，那麼您永遠無法 +因此，如果您透過 OpenRouter 之類的東西使用模型，那麼您永遠無法 確定您是否獲得了您想要的模型的最佳版本。 為了解決這個問題，我們做了幾件事： 1. 我們測試了一組選定的模型，並與他們的團隊討論瞭如何 - 最好運行它們。 -2. 然後我們與一些提供商合作以確保這些服務得到服務 + 最好執行它們。 +2. 然後我們與一些供應商合作以確保這些服務得到服務 正確。 -3. 最後，我們對模型/提供商的組合進行了基準測試並提出了 +3. 最後，我們對模型/供應商的組合進行了基準測試並提出了 並附上一份我們覺得不錯的推薦清單。 -OpenCode Zen 是一個 AI 網關，可讓您訪問這些模型。 +OpenCode Zen 是一個 AI 閘道，可讓您存取這些模型。 --- ## 它是如何運作的 -OpenCode Zen 的工作方式與 opencode 中的任何其他提供商一樣。 +OpenCode Zen 的工作方式與 opencode 中的任何其他供應商一樣。 -1. 您登錄 **OpenCode Zen**，添加您的帳單 - 詳細信息，然後復制您的 API 密鑰。 -2. 您在 TUI 中運行 `/connect` 命令，選擇 OpenCode Zen，然後粘貼您的 API 密鑰。 -3. 在 TUI 中運行 `/models` 以查看我們推薦的型號列表。 +1. 您登入 **OpenCode Zen**，添加您的帳單 + 詳細資訊，然後複製您的 API 金鑰。 +2. 您在 TUI 中執行 `/connect` 指令，選擇 OpenCode Zen，然後貼上您的 API 金鑰。 +3. 在 TUI 中執行 `/models` 以查看我們推薦的模型列表。 -您需要按請求付費，並且可以將積分添加到您的帳戶中。 +您需要按請求付費，並且可以將點數添加到您的帳戶中。 --- ## 端點 -您還可以通過以下 API 端點訪問我們的模型。 +您還可以透過以下 API 端點存取我們的模型。 -| 型號 | 型號 ID | 端點 | AI SDK 套件 | +| 模型 | 模型 ID | 端點 | 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` | @@ -94,13 +94,13 @@ OpenCode Zen 的工作方式與 opencode 中的任何其他提供商一樣。 | 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` | -opencode 配置中的 [型號編號](/docs/config/#models) -使用格式`opencode/`。例如，對於 GPT 5.2 Codex，您將 -在您的配置中使用`opencode/gpt-5.2-codex`。 +opencode 配置中的 [模型編號](/docs/config/#models) +使用格式 `opencode/`。例如，對於 GPT 5.2 Codex，您將 +在您的配置中使用 `opencode/gpt-5.2-codex`。 --- -### 型號 +### 模型 您可以從以下位置獲取可用模型及其元數據的完整列表： @@ -112,9 +112,9 @@ https://opencode.ai/zen/v1/models ## 定價 -我們支持即用即付模式。以下是**每 100 萬代幣的價格**。 +我們支援按用量付費模式。以下是**每 100 萬 Tokens 的價格**。 -| 型號 | 輸入 | 輸出 | 緩存讀取 | 緩存寫入 | +| 模型 | 輸入 | 輸出 | 快取讀取 | 快取寫入 | | --------------------------------- | ------ | ------ | -------- | -------- | | Big Pickle | Free | Free | Free | - | | MiniMax M2.1 Free | Free | Free | Free | - | @@ -150,7 +150,7 @@ https://opencode.ai/zen/v1/models | GPT 5 Codex | $1.07 | $8.50 | $0.107 | - | | GPT 5 Nano | Free | Free | Free | - | -您可能會在使用歷史記錄中註意到*Claude Haiku 3.5*。這是一個[低成本模式](/docs/config/#models)，用於生成會話標題。 +您可能會在使用歷史記錄中注意到 _Claude Haiku 3.5_。這是一個 [低成本模型](/docs/config/#models)，用於生成工作階段標題。 :::note 信用卡費用按成本轉嫁（4.4% + 每筆交易 0.30 美元）；除此之外我們不收取任何費用。 @@ -158,57 +158,57 @@ https://opencode.ai/zen/v1/models 免費模型： -- GLM 4.7 免費版在 opencode 上限時提供。團隊正在利用這段時間收集反饋並改進模型。 -- Kimi K2.5 Free 在 opencode 上限時提供。團隊正在利用這段時間收集反饋並改進模型。 -- MiniMax M2.1 免費版在 opencode 上限時提供。團隊正在利用這段時間收集反饋並改進模型。 -- Big Pickle 是一個秘密模型，在 opencode 上限時免費。團隊正在利用這段時間收集反饋並改進模型。 +- GLM 4.7 免費版在 opencode 上限時提供。團隊正在利用這段時間收集回饋並改進模型。 +- Kimi K2.5 Free 在 opencode 上限時提供。團隊正在利用這段時間收集回饋並改進模型。 +- MiniMax M2.1 免費版在 opencode 上限時提供。團隊正在利用這段時間收集回饋並改進模型。 +- Big Pickle 是一個秘密模型，在 opencode 上限時免費。團隊正在利用這段時間收集回饋並改進模型。 -如果您有任何疑問，請聯繫我們。 +如果您有任何疑問，請聯絡我們。 --- -### 自動重新加載 +### 自動重新載入 -如果您的餘額低於 5 美元，Zen 將自動充值 20 美元。 +如果您的餘額低於 5 美元，Zen 將自動加值 20 美元。 -您可以更改自動充值金額。您還可以完全禁用自動重新加載。 +您可以更改自動加值金額。您還可以完全禁用自動重新載入。 --- ### 每月限額 -您還可以為整個工作區和每個工作區設置每月使用限制 +您還可以為整個工作區和每個工作區設定每月使用限制 你的團隊的成員。 -例如，假設您將每月使用限額設置為 20 美元，Zen 將不會使用 -一個月超過20美元。但如果你啟用了自動重新加載，Zen 可能會結束 +例如，假設您將每月使用限額設定為 20 美元，Zen 將不會使用 +一個月超過 20 美元。但如果你啟用了自動重新載入，Zen 可能會結束 如果您的餘額低於 5 美元，則向您收取超過 20 美元的費用。 --- ## 隱私 -我們所有的模型都在美國託管。我們的提供商遵循零保留政策，不會將您的數據用於模型訓練，但以下情況除外： +我們所有的模型都在美國託管。我們的供應商遵循零保留政策，不會將您的數據用於模型訓練，但以下情況除外： - Big Pickle：在免費期間，收集的數據可用於改進模型。 - GLM 4.7 免費：在免費期間，收集的數據可用於改進模型。 - Kimi K2.5 免費：在免費期間，收集的數據可用於改進模型。 - MiniMax M2.1 免費：在免費期間，收集的數據可用於改進模型。 -- OpenAI API：根據[OpenAI 的數據政策](https://platform.openai.com/docs/guides/your-data)，請求將保留 30 天。 -- Anthropic API：根據[Anthropic 的數據政策](https://docs.anthropic.com/en/docs/claude-code/data-usage)，請求將保留 30 天。 +- OpenAI API：根據 [OpenAI 的數據政策](https://platform.openai.com/docs/guides/your-data)，請求將保留 30 天。 +- Anthropic API：根據 [Anthropic 的數據政策](https://docs.anthropic.com/en/docs/claude-code/data-usage)，請求將保留 30 天。 --- ## 對於團隊 -Zen 對團隊也很有效。您可以邀請隊友、分配角色、策劃 +Zen 對團隊也很有效。您可以邀請隊友、分配角色、精選 您的團隊使用的模型等等。 :::note -作為測試版的一部分，工作空間目前對團隊免費。 +作為測試版的一部分，工作區目前對團隊免費。 ::: -作為測試版的一部分，管理工作空間目前對團隊免費。我們將會 +作為測試版的一部分，管理工作區目前對團隊免費。我們將會 很快就會分享更多有關定價的細節。 --- @@ -217,14 +217,14 @@ Zen 對團隊也很有效。您可以邀請隊友、分配角色、策劃 您可以邀請團隊成員到您的工作區並分配角色： -- **管理員**：管理模型、成員、API 密鑰和計費 -- **成員**：僅管理自己的 API 密鑰 +- **管理員**：管理模型、成員、API 金鑰和計費 +- **成員**：僅管理自己的 API 金鑰 -管理員還可以為每個成員設置每月支出限額，以控製成本。 +管理員還可以為每個成員設定每月支出限額，以控制成本。 --- -### 模型訪問 +### 模型存取 管理員可以啟用或禁用工作區的特定模型。對禁用模型發出的請求將返回錯誤。 @@ -233,22 +233,22 @@ Zen 對團隊也很有效。您可以邀請隊友、分配角色、策劃 --- -### 帶上你自己的鑰匙 +### 帶上你自己的金鑰 -您可以使用自己的 OpenAI 或 Anthropic API 密鑰，同時仍然訪問 Zen 中的其他模型。 +您可以使用自己的 OpenAI 或 Anthropic API 金鑰，同時仍然存取 Zen 中的其他模型。 -當您使用自己的密鑰時，令牌將由提供商直接計費，而不是由 Zen。 +當您使用自己的金鑰時，Tokens 將由供應商直接計費，而不是由 Zen。 -例如，您的組織可能已經擁有 OpenAI 或 Anthropic 的密鑰 +例如，您的組織可能已經擁有 OpenAI 或 Anthropic 的金鑰 你想使用它而不是 Zen 提供的。 --- ## 目標 -我們創建 OpenCode Zen 的目的是： +我們建立 OpenCode Zen 的目的是： -1. **對標**編碼代理的最佳模型/提供商。 -2. 可以使用**最高質量**選項，而不是降低性能或轉向更便宜的提供商。 -3. 通過按成本價銷售來傳遞任何**價格下跌**；所以唯一的加價就是支付我們的加工費。 -4. 通過允許您將其與任何其他編碼代理一起使用，**無鎖定**。並且始終允許您將任何其他提供商與 opencode 一起使用。 +1. **設定基準**編碼代理的最佳模型/供應商。 +2. 可以使用**最高品質**選項，而不是降低性能或轉向更便宜的供應商。 +3. 透過按成本價銷售來傳遞任何**價格下跌**；所以唯一的加價就是支付我們的處理費。 +4. 透過允許您將其與任何其他編碼代理一起使用，**無鎖定**。並且始終允許您將任何其他供應商與 opencode 一起使用。 diff --git a/packages/web/src/content/i18n/bs.json b/packages/web/src/content/i18n/bs.json index 8cc47d72d..6dc96ce7f 100644 --- a/packages/web/src/content/i18n/bs.json +++ b/packages/web/src/content/i18n/bs.json @@ -1,36 +1,36 @@ { - "app.head.titleSuffix": "Agent za AI kodiranje napravljen za terminal", - "app.header.home": "Dom", - "app.header.docs": "Docs", - "app.footer.issueLink": "Pronašli ste grešku? Otvorite issue", + "app.head.titleSuffix": "AI agent za kodiranje, napravljen za terminal", + "app.header.home": "Početna", + "app.header.docs": "Dokumentacija", + "app.footer.issueLink": "Pronašli ste grešku? Prijavite problem", "app.footer.discordLink": "Pridružite se našoj Discord zajednici", - "app.lander.hero.title": "Agent za AI kodiranje napravljen za terminal.", + "app.lander.hero.title": "AI agent za kodiranje, napravljen za terminal.", "app.lander.cta.getStarted": "Započnite", - "app.lander.features.native_tui.title": "Native TUI", - "app.lander.features.native_tui.description": "Prilagodljivo, izvorno, tematsko korisničko sučelje terminala.", + "app.lander.features.native_tui.title": "Izvorni TUI", + "app.lander.features.native_tui.description": "Prilagodljiv, izvorni, tematski interfejs terminala.", "app.lander.features.lsp_enabled.title": "LSP omogućen", "app.lander.features.lsp_enabled.description": "Automatski učitava ispravne LSP-ove za LLM.", "app.lander.features.multi_session.title": "Više sesija", "app.lander.features.multi_session.description": "Pokrenite više agenata paralelno na istom projektu.", "app.lander.features.shareable_links.title": "Linkovi za dijeljenje", - "app.lander.features.shareable_links.description": "Podijelite vezu do bilo koje sesije za referencu ili za otklanjanje grešaka.", + "app.lander.features.shareable_links.description": "Podijelite link do bilo koje sesije za referencu ili otklanjanje grešaka.", "app.lander.features.github_copilot.description": "Prijavite se na GitHub da koristite svoj Copilot nalog.", - "app.lander.features.chatgpt_plus_pro.description": "Prijavite se na OpenAI da biste koristili svoj ChatGPT Plus ili Pro nalog.", + "app.lander.features.chatgpt_plus_pro.description": "Prijavite se na OpenAI da koristite svoj ChatGPT Plus ili Pro nalog.", "app.lander.features.use_any_model.title": "Koristite bilo koji model", - "app.lander.features.use_any_model.prefix": "Podržava 75+ LLM providera kroz", + "app.lander.features.use_any_model.prefix": "Podržava 75+ LLM provajdera kroz", "app.lander.features.use_any_model.suffix": "uključujući lokalne modele.", - "app.lander.images.tui.caption": "opencode TUI u tokyonight temi", - "app.lander.images.tui.alt": "opencode TUI u tokyonight temi", - "app.lander.images.vscode.caption": "opencode u VS Code", - "app.lander.images.vscode.alt": "opencode u VS Code", - "app.lander.images.github.caption": "opencode u GitHub", - "app.lander.images.github.alt": "opencode u GitHub", - "share.meta_description": "opencode - AI agent za kodiranje napravljen za terminal.", + "app.lander.images.tui.caption": "OpenCode TUI u tokyonight temi", + "app.lander.images.tui.alt": "OpenCode TUI u tokyonight temi", + "app.lander.images.vscode.caption": "OpenCode u VS Code", + "app.lander.images.vscode.alt": "OpenCode u VS Code", + "app.lander.images.github.caption": "OpenCode u GitHub", + "app.lander.images.github.alt": "OpenCode u GitHub", + "share.meta_description": "OpenCode - AI agent za kodiranje napravljen za terminal.", "share.not_found": "Nije pronađeno", "share.link_to_message": "Link do ove poruke", "share.copied": "Kopirano!", "share.copy": "Kopiraj", - "share.show_more": "Pokaži više", + "share.show_more": "Prikaži više", "share.show_less": "Prikaži manje", "share.show_results": "Prikaži rezultate", "share.hide_results": "Sakrij rezultate", @@ -43,31 +43,31 @@ "share.show_output": "Prikaži izlaz", "share.hide_output": "Sakrij izlaz", "share.error": "Greška", - "share.waiting_for_messages": "Čekaju se poruke...", - "share.status_connected_waiting": "Povezano, čekam poruke...", + "share.waiting_for_messages": "Čekanje poruka...", + "share.status_connected_waiting": "Povezano, čekanje poruka...", "share.status_connecting": "Povezivanje...", - "share.status_disconnected": "Isključeno", + "share.status_disconnected": "Prekinuto", "share.status_reconnecting": "Ponovno povezivanje...", "share.status_error": "Greška", "share.status_unknown": "Nepoznato", - "share.error_id_not_found": "id nije pronađen", + "share.error_id_not_found": "ID nije pronađen", "share.error_api_url_not_found": "API URL nije pronađen", "share.error_connection_failed": "Povezivanje nije uspjelo", - "share.opencode_version": "opencode verzija", - "share.opencode_name": "opencode", + "share.opencode_version": "OpenCode verzija", + "share.opencode_name": "OpenCode", "share.models": "Modeli", "share.cost": "Cijena", - "share.input_tokens": "Input Tokens", - "share.output_tokens": "Output Tokens", - "share.reasoning_tokens": "Reasoning Tokens", - "share.scroll_to_bottom": "Pomaknite se na dno", + "share.input_tokens": "Ulazni tokeni", + "share.output_tokens": "Izlazni tokeni", + "share.reasoning_tokens": "Tokeni rezonovanja", + "share.scroll_to_bottom": "Pomjerite na dno", "share.attachment": "Prilog", - "share.thinking": "Thinking", - "share.thinking_pending": "mislim...", + "share.thinking": "Razmišljanje", + "share.thinking_pending": "razmišlja...", "share.creating_plan": "Kreiranje plana", "share.completing_plan": "Završavanje plana", "share.updating_plan": "Ažuriranje plana", - "share.match_one": "match", + "share.match_one": "podudaranje", "share.match_other": "podudaranja", "share.result_one": "rezultat", "share.result_other": "rezultati", diff --git a/packages/web/src/content/i18n/da.json b/packages/web/src/content/i18n/da.json index 3a00d54a6..a375c6713 100644 --- a/packages/web/src/content/i18n/da.json +++ b/packages/web/src/content/i18n/da.json @@ -6,11 +6,11 @@ "app.footer.discordLink": "Bliv en del af vores Discord-fællesskab", "app.lander.hero.title": "AI-kodningsagenten bygget til terminalen.", "app.lander.cta.getStarted": "Kom i gang", - "app.lander.features.native_tui.title": "Native TUI", + "app.lander.features.native_tui.title": "Indbygget TUI", "app.lander.features.native_tui.description": "En responsiv, indbygget, temavenlig terminal-brugergrænseflade.", "app.lander.features.lsp_enabled.title": "LSP aktiveret", "app.lander.features.lsp_enabled.description": "Indlæser automatisk de rigtige LSPs for LLM.", - "app.lander.features.multi_session.title": "Multi-session", + "app.lander.features.multi_session.title": "Flere sessioner", "app.lander.features.multi_session.description": "Start flere agenter parallelt på det samme projekt.", "app.lander.features.shareable_links.title": "Delbare links", "app.lander.features.shareable_links.description": "Del et link til enhver session til reference eller til fejlretning.", @@ -53,13 +53,13 @@ "share.error_id_not_found": "id ikke fundet", "share.error_api_url_not_found": "API URL ikke fundet", "share.error_connection_failed": "Forbindelsen mislykkedes", - "share.opencode_version": "opencode version", + "share.opencode_version": "opencode-version", "share.opencode_name": "opencode", "share.models": "Modeller", "share.cost": "Omkostning", - "share.input_tokens": "Input Tokens", - "share.output_tokens": "Output Tokens", - "share.reasoning_tokens": "Reasoning Tokens", + "share.input_tokens": "Input-tokens", + "share.output_tokens": "Output-tokens", + "share.reasoning_tokens": "Ræsonneringstokens", "share.scroll_to_bottom": "Rul til bunden", "share.attachment": "Vedhæftet fil", "share.thinking": "Tænker", @@ -67,8 +67,8 @@ "share.creating_plan": "Oprettelse af plan", "share.completing_plan": "Færdiggør plan", "share.updating_plan": "Opdatering af plan", - "share.match_one": "match", - "share.match_other": "matches", + "share.match_one": "træf", + "share.match_other": "træf", "share.result_one": "resultat", "share.result_other": "resultater", "share.debug_key": "Nøgle" diff --git a/packages/web/src/content/i18n/de.json b/packages/web/src/content/i18n/de.json index 636ba9f8e..9d6314368 100644 --- a/packages/web/src/content/i18n/de.json +++ b/packages/web/src/content/i18n/de.json @@ -6,7 +6,7 @@ "app.footer.discordLink": "Tritt unserer Discord-Community bei", "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.title": "Natives TUI", "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.", @@ -21,10 +21,10 @@ "app.lander.features.use_any_model.suffix": "einschließlich lokaler Modelle.", "app.lander.images.tui.caption": "opencode TUI mit dem tokyonight Theme", "app.lander.images.tui.alt": "opencode TUI mit dem tokyonight Theme", - "app.lander.images.vscode.caption": "opencode in VS Code", - "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", + "app.lander.images.vscode.caption": "opencode im VS-Code-Editor", + "app.lander.images.vscode.alt": "opencode im VS-Code-Editor", + "app.lander.images.github.caption": "opencode auf GitHub", + "app.lander.images.github.alt": "opencode auf GitHub", "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", @@ -57,9 +57,9 @@ "share.opencode_name": "opencode", "share.models": "Modelle", "share.cost": "Kosten", - "share.input_tokens": "Input Tokens", - "share.output_tokens": "Output Tokens", - "share.reasoning_tokens": "Reasoning Tokens", + "share.input_tokens": "Eingabe-Token", + "share.output_tokens": "Ausgabe-Token", + "share.reasoning_tokens": "Reasoning-Token", "share.scroll_to_bottom": "Nach unten scrollen", "share.attachment": "Anhang", "share.thinking": "Denken", diff --git a/packages/web/src/content/i18n/es.json b/packages/web/src/content/i18n/es.json index c98215fde..a30a7f064 100644 --- a/packages/web/src/content/i18n/es.json +++ b/packages/web/src/content/i18n/es.json @@ -1,10 +1,10 @@ { - "app.head.titleSuffix": "Agente de codificacion con IA para terminal", + "app.head.titleSuffix": "Agente de codificación con IA para terminal", "app.header.home": "Inicio", - "app.header.docs": "Docs", + "app.header.docs": "Documentación", "app.footer.issueLink": "¿Encontraste un error? Abre una incidencia", "app.footer.discordLink": "Únete a nuestra comunidad de Discord", - "app.lander.hero.title": "El agente de codificacion con IA hecho para terminal.", + "app.lander.hero.title": "El agente de codificación con IA hecho para terminal.", "app.lander.cta.getStarted": "Comenzar", "app.lander.features.native_tui.title": "Nativo TUI", "app.lander.features.native_tui.description": "Una UI de terminal responsiva, nativa y personalizable.", @@ -51,22 +51,22 @@ "share.status_error": "Error", "share.status_unknown": "Desconocido", "share.error_id_not_found": "no encontrado", - "share.error_api_url_not_found": "API URL no encontrada", - "share.error_connection_failed": "La conexión falló", + "share.error_api_url_not_found": "URL de la API no encontrada", + "share.error_connection_failed": "Error de conexión", "share.opencode_version": "Versión opencode", "share.opencode_name": "opencode", "share.models": "Modelos", "share.cost": "Costo", - "share.input_tokens": "Input Tokens", - "share.output_tokens": "Output Tokens", - "share.reasoning_tokens": "Reasoning Tokens", + "share.input_tokens": "Tokens de entrada", + "share.output_tokens": "Tokens de salida", + "share.reasoning_tokens": "Tokens de razonamiento", "share.scroll_to_bottom": "Desplazarse hacia abajo", "share.attachment": "Adjunto", "share.thinking": "Pensamiento", - "share.thinking_pending": "Pensamiento...", + "share.thinking_pending": "Pensando...", "share.creating_plan": "Creando plan", "share.completing_plan": "Completando el plan", - "share.updating_plan": "Plan de actualización", + "share.updating_plan": "Actualizando el plan", "share.match_one": "coincidencia", "share.match_other": "coincidencias", "share.result_one": "resultado", diff --git a/packages/web/src/content/i18n/fr.json b/packages/web/src/content/i18n/fr.json index ef1760aa7..294badf49 100644 --- a/packages/web/src/content/i18n/fr.json +++ b/packages/web/src/content/i18n/fr.json @@ -1,7 +1,7 @@ { - "app.head.titleSuffix": "Agent AI de code conçu pour le terminal", + "app.head.titleSuffix": "Agent IA de code conçu pour le terminal", "app.header.home": "Accueil", - "app.header.docs": "Docs", + "app.header.docs": "Documentation", "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 AI conçu pour le terminal.", @@ -10,7 +10,7 @@ "app.lander.features.native_tui.description": "Une interface terminal native, réactive et personnalisable.", "app.lander.features.lsp_enabled.title": "LSP activé", "app.lander.features.lsp_enabled.description": "Charge automatiquement les bons LSP pour le LLM.", - "app.lander.features.multi_session.title": "Multi-session", + "app.lander.features.multi_session.title": "Sessions multiples", "app.lander.features.multi_session.description": "Démarrez plusieurs agents en parallèle sur le même projet.", "app.lander.features.shareable_links.title": "Liens partageables", "app.lander.features.shareable_links.description": "Partagez un lien vers n’importe quelle session pour référence ou pour déboguer.", @@ -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 AI de code conçu pour le terminal.", + "share.meta_description": "opencode - Agent IA de code conçu pour le terminal.", "share.not_found": "Pas trouvé", "share.link_to_message": "Lien vers ce message", "share.copied": "Copié!", @@ -57,9 +57,9 @@ "share.opencode_name": "opencode", "share.models": "Modèles", "share.cost": "Coût", - "share.input_tokens": "Input Tokens", - "share.output_tokens": "Output Tokens", - "share.reasoning_tokens": "Reasoning Tokens", + "share.input_tokens": "Tokens d'entrée", + "share.output_tokens": "Tokens de sortie", + "share.reasoning_tokens": "Tokens de raisonnement", "share.scroll_to_bottom": "Faire défiler vers le bas", "share.attachment": "Pièce jointe", "share.thinking": "Réflexion", diff --git a/packages/web/src/content/i18n/it.json b/packages/web/src/content/i18n/it.json index a1ad90e54..a9ed2b1f8 100644 --- a/packages/web/src/content/i18n/it.json +++ b/packages/web/src/content/i18n/it.json @@ -1,6 +1,6 @@ { "app.head.titleSuffix": "Agente AI di coding creato per il terminale", - "app.header.home": "Home", + "app.header.home": "Inizio", "app.header.docs": "Documentazione", "app.footer.issueLink": "Hai trovato un bug? Apri una issue", "app.footer.discordLink": "Unisciti alla nostra community Discord", @@ -21,10 +21,10 @@ "app.lander.features.use_any_model.suffix": "inclusi i modelli locali.", "app.lander.images.tui.caption": "TUI di opencode con il tema tokyonight", "app.lander.images.tui.alt": "TUI di opencode con il tema tokyonight", - "app.lander.images.vscode.caption": "opencode in VS Code", - "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", + "app.lander.images.vscode.caption": "opencode su VS Code", + "app.lander.images.vscode.alt": "opencode su VS Code", + "app.lander.images.github.caption": "opencode su GitHub", + "app.lander.images.github.alt": "opencode su GitHub", "share.meta_description": "opencode - L'agente AI di coding creato per il terminale.", "share.not_found": "Non trovato", "share.link_to_message": "Link a questo messaggio", @@ -50,16 +50,16 @@ "share.status_reconnecting": "Riconnessione in corso...", "share.status_error": "Errore", "share.status_unknown": "Sconosciuto", - "share.error_id_not_found": "id non trovato", - "share.error_api_url_not_found": "API URL non trovato", + "share.error_id_not_found": "ID non trovato", + "share.error_api_url_not_found": "URL API non trovato", "share.error_connection_failed": "Connessione non riuscita", - "share.opencode_version": "opencode version", + "share.opencode_version": "Versione OpenCode", "share.opencode_name": "opencode", "share.models": "Modelli", "share.cost": "Costo", - "share.input_tokens": "Input Tokens", - "share.output_tokens": "Output Tokens", - "share.reasoning_tokens": "Reasoning Tokens", + "share.input_tokens": "Token di input", + "share.output_tokens": "Token di output", + "share.reasoning_tokens": "Token di ragionamento", "share.scroll_to_bottom": "Scorri in basso", "share.attachment": "Allegato", "share.thinking": "Elaborazione", diff --git a/packages/web/src/content/i18n/ja.json b/packages/web/src/content/i18n/ja.json index b3f579aae..9ef6851e5 100644 --- a/packages/web/src/content/i18n/ja.json +++ b/packages/web/src/content/i18n/ja.json @@ -1,13 +1,13 @@ { - "app.head.titleSuffix": "terminal向けのAIコーディングエージェント", + "app.head.titleSuffix": "ターミナル向けのAIコーディングエージェント", "app.header.home": "ホーム", "app.header.docs": "ドキュメント", "app.footer.issueLink": "バグを見つけたらIssueを作成", "app.footer.discordLink": "Discordコミュニティに参加", - "app.lander.hero.title": "terminal向けのAIコーディングエージェント。", + "app.lander.hero.title": "ターミナル向けのAIコーディングエージェント", "app.lander.cta.getStarted": "始める", "app.lander.features.native_tui.title": "ネイティブ TUI", - "app.lander.features.native_tui.description": "レスポンシブでネイティブ、テーマ対応のterminal UI。", + "app.lander.features.native_tui.description": "レスポンシブでネイティブ、テーマ対応のターミナル UI。", "app.lander.features.lsp_enabled.title": "LSP対応", "app.lander.features.lsp_enabled.description": "LLMに最適なLSPを自動で読み込みます。", "app.lander.features.multi_session.title": "マルチセッション", @@ -25,7 +25,7 @@ "app.lander.images.vscode.alt": "VS Codeでのopencode", "app.lander.images.github.caption": "GitHubでのopencode", "app.lander.images.github.alt": "GitHubでのopencode", - "share.meta_description": "opencode - terminal向けのAIコーディングエージェント。", + "share.meta_description": "opencode - ターミナル向けのAIコーディングエージェント。", "share.not_found": "見つかりません", "share.link_to_message": "このメッセージへのリンク", "share.copied": "コピーしました!", @@ -53,13 +53,13 @@ "share.error_id_not_found": "idが見つかりません", "share.error_api_url_not_found": "API URLが見つかりません", "share.error_connection_failed": "接続に失敗しました", - "share.opencode_version": "opencode version", + "share.opencode_version": "opencode バージョン", "share.opencode_name": "opencode", "share.models": "モデル", "share.cost": "コスト", - "share.input_tokens": "Input Tokens", - "share.output_tokens": "Output Tokens", - "share.reasoning_tokens": "Reasoning Tokens", + "share.input_tokens": "入力トークン", + "share.output_tokens": "出力トークン", + "share.reasoning_tokens": "推論トークン", "share.scroll_to_bottom": "一番下までスクロール", "share.attachment": "添付ファイル", "share.thinking": "思考", diff --git a/packages/web/src/content/i18n/ko.json b/packages/web/src/content/i18n/ko.json index c34bd8db1..633665517 100644 --- a/packages/web/src/content/i18n/ko.json +++ b/packages/web/src/content/i18n/ko.json @@ -1,13 +1,13 @@ { - "app.head.titleSuffix": "terminal에 최적화된 AI coding agent", + "app.head.titleSuffix": "터미널에 최적화된 AI coding agent", "app.header.home": "홈", "app.header.docs": "문서", "app.footer.issueLink": "버그를 찾으셨나요? 이슈를 열어 주세요", "app.footer.discordLink": "Discord 커뮤니티에 참여하세요", - "app.lander.hero.title": "terminal을 위해 만든 AI coding agent.", + "app.lander.hero.title": "터미널을 위해 만든 AI coding agent.", "app.lander.cta.getStarted": "시작하기", - "app.lander.features.native_tui.title": "Native TUI", - "app.lander.features.native_tui.description": "반응형의 네이티브 테마형 terminal UI입니다.", + "app.lander.features.native_tui.title": "네이티브 TUI", + "app.lander.features.native_tui.description": "반응형의 네이티브 테마형 터미널 UI입니다.", "app.lander.features.lsp_enabled.title": "LSP 지원", "app.lander.features.lsp_enabled.description": "LLM에 맞는 LSP를 자동으로 불러옵니다.", "app.lander.features.multi_session.title": "멀티 세션", @@ -57,9 +57,9 @@ "share.opencode_name": "opencode", "share.models": "모델", "share.cost": "비용", - "share.input_tokens": "Input Tokens", - "share.output_tokens": "Output Tokens", - "share.reasoning_tokens": "Reasoning Tokens", + "share.input_tokens": "입력 토큰", + "share.output_tokens": "출력 토큰", + "share.reasoning_tokens": "추론 토큰", "share.scroll_to_bottom": "맨 아래로 이동", "share.attachment": "첨부 파일", "share.thinking": "생각 중", diff --git a/packages/web/src/content/i18n/nb.json b/packages/web/src/content/i18n/nb.json index a67ffd8e9..c91ba2e22 100644 --- a/packages/web/src/content/i18n/nb.json +++ b/packages/web/src/content/i18n/nb.json @@ -57,9 +57,9 @@ "share.opencode_name": "opencode", "share.models": "Modeller", "share.cost": "Kostnad", - "share.input_tokens": "Input Tokens", - "share.output_tokens": "Output Tokens", - "share.reasoning_tokens": "Reasoning Tokens", + "share.input_tokens": "Inndata-tokens", + "share.output_tokens": "Utdata-tokens", + "share.reasoning_tokens": "Resonneringstokens", "share.scroll_to_bottom": "Rull til bunnen", "share.attachment": "Vedlegg", "share.thinking": "Tenker", diff --git a/packages/web/src/content/i18n/pl.json b/packages/web/src/content/i18n/pl.json index c42fe1892..8cc874f82 100644 --- a/packages/web/src/content/i18n/pl.json +++ b/packages/web/src/content/i18n/pl.json @@ -50,16 +50,16 @@ "share.status_reconnecting": "Ponowne łączenie...", "share.status_error": "Błąd", "share.status_unknown": "Nieznany", - "share.error_id_not_found": "nie znaleziono identyfikatora", + "share.error_id_not_found": "Nie znaleziono identyfikatora", "share.error_api_url_not_found": "Nie znaleziono API URL", "share.error_connection_failed": "Połączenie nie powiodło się", - "share.opencode_version": "wersja opencode", + "share.opencode_version": "Wersja opencode", "share.opencode_name": "opencode", "share.models": "Modele", "share.cost": "Koszt", - "share.input_tokens": "Input Tokens", - "share.output_tokens": "Output Tokens", - "share.reasoning_tokens": "Reasoning Tokens", + "share.input_tokens": "Tokeny wejściowe", + "share.output_tokens": "Tokeny wyjściowe", + "share.reasoning_tokens": "Tokeny wnioskowania", "share.scroll_to_bottom": "Przewiń w dół", "share.attachment": "Załącznik", "share.thinking": "Myślenie", diff --git a/packages/web/src/content/i18n/pt-BR.json b/packages/web/src/content/i18n/pt-BR.json index dca9e841a..c7a378131 100644 --- a/packages/web/src/content/i18n/pt-BR.json +++ b/packages/web/src/content/i18n/pt-BR.json @@ -1,10 +1,10 @@ { - "app.head.titleSuffix": "Agente de codificação AI construído para o terminal", + "app.head.titleSuffix": "Agente de codificação de IA construído para o terminal", "app.header.home": "Início", - "app.header.docs": "Docs", + "app.header.docs": "Documentação", "app.footer.issueLink": "Encontrou um bug? Abra uma issue", "app.footer.discordLink": "Participe da nossa comunidade no Discord", - "app.lander.hero.title": "O agente de codificação AI construído para o terminal.", + "app.lander.hero.title": "O agente de codificação de IA construído para o terminal.", "app.lander.cta.getStarted": "Começar", "app.lander.features.native_tui.title": "TUI nativo", "app.lander.features.native_tui.description": "Uma interface de terminal nativa, responsiva e com tema personalizável.", @@ -25,7 +25,7 @@ "app.lander.images.vscode.alt": "opencode no VS Code", "app.lander.images.github.caption": "opencode no GitHub", "app.lander.images.github.alt": "opencode no GitHub", - "share.meta_description": "opencode - O agente de codificação AI construído para o terminal.", + "share.meta_description": "opencode - O agente de codificação de IA construído para o terminal.", "share.not_found": "Não encontrado", "share.link_to_message": "Link para esta mensagem", "share.copied": "Copiado!", @@ -57,9 +57,9 @@ "share.opencode_name": "opencode", "share.models": "Modelos", "share.cost": "Custo", - "share.input_tokens": "Input Tokens", - "share.output_tokens": "Output Tokens", - "share.reasoning_tokens": "Reasoning Tokens", + "share.input_tokens": "Tokens de Entrada", + "share.output_tokens": "Tokens de Saída", + "share.reasoning_tokens": "Tokens de Raciocínio", "share.scroll_to_bottom": "Rolar para baixo", "share.attachment": "Anexo", "share.thinking": "Pensando", diff --git a/packages/web/src/content/i18n/ru.json b/packages/web/src/content/i18n/ru.json index 6771bd1be..945bc7b0b 100644 --- a/packages/web/src/content/i18n/ru.json +++ b/packages/web/src/content/i18n/ru.json @@ -1,13 +1,13 @@ { - "app.head.titleSuffix": "AI-агент для программирования, созданный для terminal", + "app.head.titleSuffix": "AI-агент для программирования, созданный для терминала", "app.header.home": "Главная", "app.header.docs": "Документация", "app.footer.issueLink": "Нашли ошибку? Откройте issue", "app.footer.discordLink": "Присоединяйтесь к нашему сообществу в Discord", - "app.lander.hero.title": "AI-агент для программирования, созданный для terminal.", + "app.lander.hero.title": "AI-агент для программирования, созданный для терминала.", "app.lander.cta.getStarted": "Начать", "app.lander.features.native_tui.title": "Нативный TUI", - "app.lander.features.native_tui.description": "Отзывчивый нативный интерфейс terminal с поддержкой тем.", + "app.lander.features.native_tui.description": "Отзывчивый нативный интерфейс терминала с поддержкой тем.", "app.lander.features.lsp_enabled.title": "Поддержка LSP", "app.lander.features.lsp_enabled.description": "Автоматически загружает подходящие LSP для LLM.", "app.lander.features.multi_session.title": "Несколько сессий", @@ -25,7 +25,7 @@ "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 - AI-агент для программирования, созданный для terminal.", + "share.meta_description": "opencode - AI-агент для программирования, созданный для терминала.", "share.not_found": "Не найдено", "share.link_to_message": "Ссылка на это сообщение", "share.copied": "Скопировано!", @@ -57,9 +57,9 @@ "share.opencode_name": "opencode", "share.models": "Модели", "share.cost": "Стоимость", - "share.input_tokens": "Input Tokens", - "share.output_tokens": "Output Tokens", - "share.reasoning_tokens": "Reasoning Tokens", + "share.input_tokens": "Входные токены", + "share.output_tokens": "Выходные токены", + "share.reasoning_tokens": "Токены рассуждения", "share.scroll_to_bottom": "Прокрутить вниз", "share.attachment": "Вложение", "share.thinking": "Размышление", diff --git a/packages/web/src/content/i18n/th.json b/packages/web/src/content/i18n/th.json index 7c4606604..11eb7145c 100644 --- a/packages/web/src/content/i18n/th.json +++ b/packages/web/src/content/i18n/th.json @@ -57,9 +57,9 @@ "share.opencode_name": "opencode", "share.models": "โมเดล", "share.cost": "ค่าใช้จ่าย", - "share.input_tokens": "Input Tokens", - "share.output_tokens": "Output Tokens", - "share.reasoning_tokens": "Reasoning Tokens", + "share.input_tokens": "โทเค็นอินพุต", + "share.output_tokens": "โทเค็นเอาต์พุต", + "share.reasoning_tokens": "โทเค็นการให้เหตุผล", "share.scroll_to_bottom": "เลื่อนไปด้านล่าง", "share.attachment": "ไฟล์แนบ", "share.thinking": "กำลังคิด", diff --git a/packages/web/src/content/i18n/tr.json b/packages/web/src/content/i18n/tr.json index c63907988..9f3e95aa7 100644 --- a/packages/web/src/content/i18n/tr.json +++ b/packages/web/src/content/i18n/tr.json @@ -1,13 +1,13 @@ { - "app.head.titleSuffix": "Terminal için üretilmiş AI coding agent", + "app.head.titleSuffix": "Terminal için AI kodlama asistanı", "app.header.home": "Ana sayfa", "app.header.docs": "Dokümanlar", "app.footer.issueLink": "Bir hata mı buldunuz? Issue açın", "app.footer.discordLink": "Discord topluluğumuza katılın", - "app.lander.hero.title": "Terminal için üretilmiş AI kodlama aracı.", + "app.lander.hero.title": "Terminal için üretilmiş AI kodlama ajanı.", "app.lander.cta.getStarted": "Başlayın", - "app.lander.features.native_tui.title": "Native TUI", - "app.lander.features.native_tui.description": "Hızlı, native ve tema uyumlu terminal arayüzü.", + "app.lander.features.native_tui.title": "Yerel TUI", + "app.lander.features.native_tui.description": "Hızlı, yerel ve tema uyumlu terminal arayüzü.", "app.lander.features.lsp_enabled.title": "LSP etkin", "app.lander.features.lsp_enabled.description": "LLM için doğru LSP'leri otomatik yükler.", "app.lander.features.multi_session.title": "Çoklu oturum", @@ -57,9 +57,9 @@ "share.opencode_name": "opencode", "share.models": "Modeller", "share.cost": "Maliyet", - "share.input_tokens": "Input Tokens", - "share.output_tokens": "Output Tokens", - "share.reasoning_tokens": "Reasoning Tokens", + "share.input_tokens": "Girdi Token'ları", + "share.output_tokens": "Çıktı Token'ları", + "share.reasoning_tokens": "Akıl Yürütme Token'ları", "share.scroll_to_bottom": "En alta kaydır", "share.attachment": "Ek", "share.thinking": "Düşünüyor", diff --git a/packages/web/src/content/i18n/zh-CN.json b/packages/web/src/content/i18n/zh-CN.json index 0b731442c..e1c9f0c9e 100644 --- a/packages/web/src/content/i18n/zh-CN.json +++ b/packages/web/src/content/i18n/zh-CN.json @@ -57,9 +57,9 @@ "share.opencode_name": "opencode", "share.models": "模型", "share.cost": "成本", - "share.input_tokens": "Input Tokens", - "share.output_tokens": "Output Tokens", - "share.reasoning_tokens": "Reasoning Tokens", + "share.input_tokens": "输入 Tokens", + "share.output_tokens": "输出 Tokens", + "share.reasoning_tokens": "推理 Tokens", "share.scroll_to_bottom": "滚动到底部", "share.attachment": "附件", "share.thinking": "思考", diff --git a/packages/web/src/content/i18n/zh-TW.json b/packages/web/src/content/i18n/zh-TW.json index 8e40125fb..82cc25771 100644 --- a/packages/web/src/content/i18n/zh-TW.json +++ b/packages/web/src/content/i18n/zh-TW.json @@ -1,34 +1,34 @@ { - "app.head.titleSuffix": "為 terminal 打造的 AI 編碼代理", + "app.head.titleSuffix": "為終端機打造的 AI 程式碼代理", "app.header.home": "首頁", "app.header.docs": "文件", - "app.footer.issueLink": "發現問題？提交 issue", + "app.footer.issueLink": "發現問題？提交 Issue", "app.footer.discordLink": "加入我們的 Discord 社群", - "app.lander.hero.title": "為 terminal 打造的 AI 編碼代理。", + "app.lander.hero.title": "為終端機打造的 AI 程式碼代理。", "app.lander.cta.getStarted": "開始使用", - "app.lander.features.native_tui.title": "本機 TUI", - "app.lander.features.native_tui.description": "響應式、原生、可主題化的 terminal UI。", + "app.lander.features.native_tui.title": "原生 TUI", + "app.lander.features.native_tui.description": "反應靈敏、原生、可自訂主題的終端機 UI。", "app.lander.features.lsp_enabled.title": "LSP 已啟用", "app.lander.features.lsp_enabled.description": "自動為 LLM 載入正確的 LSP。", - "app.lander.features.multi_session.title": "多會話", + "app.lander.features.multi_session.title": "多重工作階段", "app.lander.features.multi_session.description": "在同一專案上並行啟動多個代理。", "app.lander.features.shareable_links.title": "可分享的連結", - "app.lander.features.shareable_links.description": "共享任何會話的連結以供參考或除錯。", + "app.lander.features.shareable_links.description": "分享任何工作階段的連結以供參考或除錯。", "app.lander.features.github_copilot.description": "使用 GitHub 登入以使用您的 Copilot 帳戶。", "app.lander.features.chatgpt_plus_pro.description": "使用 OpenAI 登入以使用您的 ChatGPT Plus 或 Pro 帳戶。", "app.lander.features.use_any_model.title": "使用任何模型", - "app.lander.features.use_any_model.prefix": "透過以下方式支援 75+ LLM 提供商", + "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.tui.caption": "OpenCode TUI (Tokyo Night 主題)", + "app.lander.images.tui.alt": "OpenCode TUI (Tokyo Night 主題)", "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.meta_description": "OpenCode - 為終端機打造的 AI 程式碼代理。", + "share.not_found": "找不到", "share.link_to_message": "連結到此訊息", - "share.copied": "複製了！", + "share.copied": "已複製！", "share.copy": "複製", "share.show_more": "顯示更多", "share.show_less": "顯示較少", @@ -50,17 +50,17 @@ "share.status_reconnecting": "正在重新連線...", "share.status_error": "錯誤", "share.status_unknown": "未知", - "share.error_id_not_found": "未找到 ID", - "share.error_api_url_not_found": "API URL 未找到", + "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.models": "模型", "share.cost": "成本", - "share.input_tokens": "Input Tokens", - "share.output_tokens": "Output Tokens", - "share.reasoning_tokens": "Reasoning Tokens", - "share.scroll_to_bottom": "滾動到底部", + "share.input_tokens": "輸入 Tokens", + "share.output_tokens": "輸出 Tokens", + "share.reasoning_tokens": "推理 Tokens", + "share.scroll_to_bottom": "捲動到底部", "share.attachment": "附件", "share.thinking": "思考中", "share.thinking_pending": "思考中...",