wip(docs): i18n (#12681)

2026-02-09 11:34:35 -06:00
parent f74c0339cc
commit dc53086c1e
642 changed files with 192745 additions and 509 deletions
@@ -0,0 +1,156 @@
+---
+title: Поддержка АСР
+description: Используйте OpenCode в любом ACP-совместимом редакторе.
+---
+
+OpenCode поддерживает [Протокол агента-клиента](https://agentclientprotocol.com) или (ACP), что позволяет использовать его непосредственно в совместимых редакторах и IDE.
+
+:::кончик
+Список редакторов и инструментов, поддерживающих ACP, можно найти в [отчете о ходе работы ACP](https://zed.dev/blog/acp-progress-report#available-now).
+:::
+
+ACP — это открытый протокол, который стандартизирует связь между редакторами кода и агентами кодирования ИИ.
+
+---
+
+## Настроить
+
+Чтобы использовать OpenCode через ACP, настройте свой редактор для запуска команды `opencode acp`.
+
+Команда запускает OpenCode как ACP-совместимый подпроцесс, который взаимодействует с вашим редактором через JSON-RPC через stdio.
+
+Ниже приведены примеры популярных редакторов, поддерживающих ACP.
+
+---
+
+### Зед
+
+Добавьте в конфигурацию [Zed](https://zed.dev) (`~/.config/zed/settings.json`):
+
+```json title="~/.config/zed/settings.json"
+{
+  "agent_servers": {
+    "OpenCode": {
+      "command": "opencode",
+      "args": ["acp"]
+    }
+  }
+}
+```
+
+Чтобы открыть его, используйте действие `agent: new thread` в **Палитре команд**.
+
+Вы также можете привязать сочетание клавиш, отредактировав свой `keymap.json`:
+
+```json title="keymap.json"
+[
+  {
+    "bindings": {
+      "cmd-alt-o": [
+        "agent::NewExternalAgentThread",
+        {
+          "agent": {
+            "custom": {
+              "name": "OpenCode",
+              "command": {
+                "command": "opencode",
+                "args": ["acp"]
+              }
+            }
+          }
+        }
+      ]
+    }
+  }
+]
+```
+
+---
+
+### IDE JetBrains
+
+Добавьте в свою [JetBrains IDE](https://www.jetbrains.com/) acp.json в соответствии с [документацией](https://www.jetbrains.com/help/ai-assistant/acp.html):
+
+```json title="acp.json"
+{
+  "agent_servers": {
+    "OpenCode": {
+      "command": "/absolute/path/bin/opencode",
+      "args": ["acp"]
+    }
+  }
+}
+```
+
+Чтобы открыть его, используйте новый агент OpenCode в селекторе агентов AI Chat.
+
+---
+
+### Аванте.nvim
+
+Добавьте в свою конфигурацию [Avante.nvim](https://github.com/yetone/avante.nvim):
+
+```lua
+{
+  acp_providers = {
+    ["opencode"] = {
+      command = "opencode",
+      args = { "acp" }
+    }
+  }
+}
+```
+
+Если вам нужно передать переменные среды:
+
+```lua {6-8}
+{
+  acp_providers = {
+    ["opencode"] = {
+      command = "opencode",
+      args = { "acp" },
+      env = {
+        OPENCODE_API_KEY = os.getenv("OPENCODE_API_KEY")
+      }
+    }
+  }
+}
+```
+
+---
+
+### КодКомпаньон.nvim
+
+Чтобы использовать OpenCode в качестве агента ACP в [CodeCompanion.nvim](https://github.com/olimorris/codecompanion.nvim), добавьте в конфигурацию Neovim следующее:
+
+```lua
+require("codecompanion").setup({
+  interactions = {
+    chat = {
+      adapter = {
+        name = "opencode",
+        model = "claude-sonnet-4",
+      },
+    },
+  },
+})
+```
+
+Эта конфигурация настраивает CodeCompanion для использования OpenCode в качестве агента ACP для чата.
+
+Если вам нужно передать переменные среды (например, `OPENCODE_API_KEY`), обратитесь к разделу [Настройка адаптеров: переменные среды](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) в документации CodeCompanion.nvim для получения полной информации.
+
+## Поддерживать
+
+OpenCode через ACP работает так же, как и в терминале. Поддерживаются все функции:
+
+:::примечание
+Некоторые встроенные команды слэша, такие как `/undo` и `/redo`, в настоящее время не поддерживаются.
+:::
+
+- Встроенные инструменты (файловые операции, команды терминала и т. д.)
+- Пользовательские инструменты и команды слэша
+- Серверы MCP, настроенные в вашей конфигурации OpenCode
+- Правила для конкретного проекта из `AGENTS.md`
+- Пользовательские форматтеры и линтеры
+- Агенты и система разрешений