From 88cb62158e4575c155ac0451879df51e771416b1 Mon Sep 17 00:00:00 2001 From: WavyCat Date: Thu, 28 May 2026 00:38:23 +0500 Subject: [PATCH 1/2] i18n(ru): update `guides/build-with-ai.mdx` --- src/content/docs/ru/guides/build-with-ai.mdx | 103 ++++++++++++++++--- 1 file changed, 88 insertions(+), 15 deletions(-) diff --git a/src/content/docs/ru/guides/build-with-ai.mdx b/src/content/docs/ru/guides/build-with-ai.mdx index 4542e4547bb2a..3a140944733c8 100644 --- a/src/content/docs/ru/guides/build-with-ai.mdx +++ b/src/content/docs/ru/guides/build-with-ai.mdx @@ -11,7 +11,7 @@ description: Ресурсы и советы по созданию сайтов import { Steps, LinkButton, Card, Tabs, TabItem } from '@astrojs/starlight/components'; -Редакторы с поддержкой ИИ и инструменты агентного программирования обычно хорошо знакомы с основными API и концепциями Astro. Однако некоторые из них могут использовать устаревшие API и не знать о новых функциях или последних изменениях в фреймворке. +Редакторы с поддержкой ИИ и инструменты агентного программирования обычно хорошо знакомы с основными API и концепциями Astro. Однако некоторые из них могут использовать устаревшие API и не знать о новых функциях или последних изменениях во фреймворке. Это руководство описывает, как улучшить инструменты ИИ с помощью актуальных знаний об Astro и предоставляет лучшие практики для создания сайтов на Astro с использованием ИИ. @@ -43,7 +43,7 @@ MCP-сервер Astro Docs использует API [kapa.ai](https://www.kapa. - ```json title="mcp.json" {3-6} + ```json title="Конфигурация MCP" {3-6} { "mcpServers": { "Astro docs": { @@ -55,7 +55,7 @@ MCP-сервер Astro Docs использует API [kapa.ai](https://www.kapa. ``` - ```json title="mcp.json" {3-7} + ```json title="Конфигурация MCP" {3-7} { "mcpServers": { "Astro docs": { @@ -105,6 +105,20 @@ Claude Code также предоставляет GitHub Action, который [Подробнее об использовании MCP-серверов с Claude Code GitHub Action](https://github.com/anthropics/claude-code-action?tab=readme-ov-file#using-custom-mcp-configuration) +#### Codex CLI + +Codex CLI — это инструмент для программирования с ИИ, работающий в командной строке, который может использовать MCP сервер Astro Docs для доступа к документации при генерации кода Astro. + +Вы можете настроить MCP-сервера глобально в файле `~/.codex/config.toml` или в файле `.codex/config.toml` в корне проекта. + +```toml title="~/.codex/config.toml" +[mcp_servers.astro-docs] +command = "npx" +args = ["-y", "mcp-remote", "https://mcp.docs.astro.build/mcp"] +``` + +[Подробнее об использовании MCP-серверов с Codex CLI](https://developers.openai.com/codex/mcp) + #### Cursor [Cursor](https://cursor.com/) — это редактор кода с ИИ. Добавление MCP-сервера Astro Docs позволяет Cursor использовать последнюю документацию Astro при выполнении задач разработки. @@ -205,7 +219,7 @@ Gemini CLI — это инструмент командной строки дл { "mcpServers": { "Astro docs": { - "httpUrl": "https://mcp.docs.astro.build/mcp", + "serverUrl": "https://mcp.docs.astro.build/mcp", } } } @@ -213,23 +227,43 @@ Gemini CLI — это инструмент командной строки дл [Подробнее об использовании MCP-серверов с Gemini CLI](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md) +#### Google Antigravity + +[Google Antigravity](https://antigravity.google/) — это агентная платформа для разработки. + + + +1. Откройте `~/.gemini/antigravity/mcp_config.json` следуя инструкциям [руководства по подключению пользовательских MCP-серверов](https://antigravity.google/docs/mcp#connecting-custom-mcp-servers). +2. Добавьте следующую конфигурацию в `mcp_config.json`: + ```json title="mcp_config.json" {3-5} + { + "mcpServers": { + "astro-docs": { + "serverUrl": "https://mcp.docs.astro.build/mcp" + } + } + } + ``` +3. Сохраните файл и нажмите "Refresh" во вкладке "Manage MCPs". + + + #### Zed [Zed](https://zed.dev/) поддерживает MCP-серверы при использовании его ИИ-возможностей. Он может использовать MCP-сервер Astro Docs для доступа к документации при выполнении задач программирования. -Zed не поддерживает потоковый HTTP, поэтому требуется конфигурация локального прокси: - 1. Откройте файл `~/.config/zed/settings.json` в вашем редакторе. 2. Добавьте следующую конфигурацию в настройки MCP Zed: - ```json title="Конфигурация MCP" {3-6} + ```json title="Конфигурация MCP" {3-7} { "context_servers": { "Astro docs": { - "command": "npx", - "args": ["-y", "mcp-remote", "https://mcp.docs.astro.build/mcp"] + "settings": {}, + "enabled": true, + "url": "https://mcp.docs.astro.build/mcp" } } } @@ -242,15 +276,11 @@ Zed не поддерживает потоковый HTTP, поэтому тре #### ChatGPT -:::caution[Ограниченная доступность] -Интеграция с MCP-сервером доступна только для пользователей ChatGPT Pro, Team и Enterprise. Процесс настройки сложнее, чем для других инструментов. -::: - Обратитесь к [документации OpenAI по MCP](https://platform.openai.com/docs/mcp#test-and-connect-your-mcp-server) для получения конкретных инструкций по настройке. #### Raycast -[Raycast](https://www.raycast.com/) может подключаться к MCP-серверам для улучшения своих ИИ-возможностей. Для использования ИИ-функций, таких как MCP, требуется аккаунт [Raycast Pro](https://www.raycast.com/pro), поэтому убедитесь, что вы обновили аккаунт перед установкой. Добавление MCP-сервера Astro Docs позволяет Raycast использовать последнюю документацию Astro при ответах на вопросы. +[Raycast](https://www.raycast.com/) может подключаться к MCP-серверам для улучшения своих ИИ-возможностей. Для использования ИИ-функций, таких, как MCP, требуется аккаунт [Raycast Pro](https://www.raycast.com/pro), поэтому убедитесь, что вы обновили аккаунт перед установкой. Добавление MCP-сервера Astro Docs позволяет Raycast использовать последнюю документацию Astro при ответах на вопросы. Установка по кнопке ниже: @@ -258,6 +288,49 @@ Zed не поддерживает потоковый HTTP, поэтому тре [Подробнее об использовании MCP-серверов с Raycast](https://manual.raycast.com/model-context-protocol) +#### Opencode AI + +[Opencode AI](https://opencode.ai/) — это консольный инструмент программирования с ИИ с открытым исходным кодом, который может использовать MCP сервер Astro Docs для доступа к документации при генерации кода Astro. + +Вы можете настроить MCP-сервера в своём конфигурационном файле Opencode, обычно с названием `opencode.json`, расположенном в корне вашего проекта или вашем каталоге глобальной конфигурации (например, `~/.config/opencode/opencode.json`). + +```json title="MCP Configuration" +{ + "$schema": "https://opencode.ai/config.json", + "mcp": { + "Astro docs": { + "type": "remote", + "url": "https://mcp.docs.astro.build/mcp", + "enabled": true + } + } +} + +``` + +[Подробнее об использовании Opencode AI](https://opencode.ai/) + +#### GitHub Copilot Coding Agent + +[GitHub Copilot](https://docs.github.com/en/copilot/concepts/agents/coding-agent/about-coding-agent) можно использовать как coding agent на базе GitHub Actions. Включение MCP-сервера Astro Docs позволяет ему получать доступ к актуальной документации Astro при ответах на вопросы или выполнении задач по программированию. + +Вы можете настроить его на использование MCP-сервера Astro Docs для доступа к документации, добавив следующее в настройки Copilot coding agent вашего репозитория, доступные по адресу `https://github.com///settings/copilot/coding_agent`: + +```json title="MCP Configuration" +{ + "mcpServers": { + "astro-docs": { + "type": "http", + "url": "https://mcp.docs.astro.build/mcp", + "tools": ["mcp__astro-docs__search_astro_docs"] + } + } +} +``` + +Подробнее о [расширении GitHub Copilot coding agent с помощью MCP-серверов](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp). + + ### Использование После настройки вы можете задавать своему инструменту ИИ вопросы об Astro, и он будет получать информацию непосредственно из последней документации. Агенты программирования смогут обращаться к актуальной документации при выполнении задач, а чат-боты смогут точно отвечать на вопросы о функциях, API и лучших практиках Astro. @@ -288,5 +361,5 @@ MCP-сервер Astro Docs предоставляет доступ к теку - **Начинайте с шаблонов**: Вместо создания с нуля просите инструменты ИИ использовать существующий [шаблон Astro](https://astro.build/themes/) или команду `npm create astro@latest` с опцией `template`. - **Используйте `astro add` для интеграций**: Просите инструменты ИИ использовать `astro add` для официальных интеграций (например, `astro add tailwind`, `astro add react`). Для других пакетов используйте команду вашего менеджера пакетов вместо прямого редактирования `package.json`. -- **Проверяйте актуальные API**: Инструменты ИИ могут использовать устаревшие шаблоны. Просите их проверять последнюю документацию, особенно для новых функций, таких как сессии и действия. Это также важно для функций, которые значительно изменились с момента их выпуска, например, коллекции контента, или ранее экспериментальных функций, которые больше не являются экспериментальными. +- **Проверяйте актуальные API**: Инструменты ИИ могут использовать устаревшие шаблоны. Просите их проверять последнюю документацию, особенно для новых функций, таких как сессии и действия. Это также важно для функций, которые значительно изменились с момента их выпуска. Например, коллекции контента, или ранее экспериментальных функций, которые больше не являются экспериментальными. - **Используйте правила проекта**: Если ваш инструмент ИИ поддерживает это, настройте правила проекта для соблюдения лучших практик и стандартов кодирования, таких как указанные выше. From c37c43f40a60bd24ce04781af940a3624a56b842 Mon Sep 17 00:00:00 2001 From: WavyCat Date: Tue, 23 Jun 2026 20:55:18 +0500 Subject: [PATCH 2/2] i18n(ru): update `build-with-ai.mdx` --- src/content/docs/ru/guides/build-with-ai.mdx | 24 ++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/src/content/docs/ru/guides/build-with-ai.mdx b/src/content/docs/ru/guides/build-with-ai.mdx index 3a140944733c8..b0fe05ebc3ca4 100644 --- a/src/content/docs/ru/guides/build-with-ai.mdx +++ b/src/content/docs/ru/guides/build-with-ai.mdx @@ -9,6 +9,8 @@ i18nReady: true description: Ресурсы и советы по созданию сайтов на Astro с помощью ИИ --- +import Since from '~/components/Since.astro'; +import ReadMore from '~/components/ReadMore.astro'; import { Steps, LinkButton, Card, Tabs, TabItem } from '@astrojs/starlight/components'; Редакторы с поддержкой ИИ и инструменты агентного программирования обычно хорошо знакомы с основными API и концепциями Astro. Однако некоторые из них могут использовать устаревшие API и не знать о новых функциях или последних изменениях во фреймворке. @@ -357,6 +359,28 @@ MCP-сервер Astro Docs предоставляет доступ к теку **Беседы с чат-ботом публичны и подчиняются тем же правилам сервера относительно языка и поведения, что и другие каналы**, но волонтёры поддержки не посещают их активно. Для помощи от сообщества создайте тред в обычном канале `#support`. +## Фоновый режим + +

+ +При обнаружении ИИ-агента для программирования, `astro dev` автоматически запускает dev-сервер как отдельный фоновый процесс. Это предотвращает блокировку dev-сервером терминала агента и позволяет ему продолжать работу во время работы сервера. + +При запуске dev-сервера создаётся lock-файл (`.astro/dev.json`), в который записываются URL-адрес сервера, порт и PID. Это предотвращает запуск нескольких серверов для одного и того же проекта. + +Если вы не используете ИИ-агента для программирования, то `astro dev` запускается как приоритетный процесс и выводится в терминале. + +Для того, чтобы отключить фоновый режим, установите переменную окружения `ASTRO_DEV_BACKGROUND` перед запуском `astro dev`: + +```shell +ASTRO_DEV_BACKGROUND=0 astro dev +``` + +См. [справочник по CLI](/ru/reference/cli-reference/#astro-dev) с полным списком флагов и подкомманд для `astro dev`. + +### Health эндпойнт + +Dev-сервер добавляет эндпойнт `/_astro/status`, который возвращает JSON-ответ `{"ok": true}`. Он позволяет агентам и другим инструментам проверять готов ли dev-сервер принимать запросы. Этот эндпойнт доступен только в dev-сервере и не присутствует в продакшен-сборках. + ## Советы по разработке на Astro с использованием ИИ - **Начинайте с шаблонов**: Вместо создания с нуля просите инструменты ИИ использовать существующий [шаблон Astro](https://astro.build/themes/) или команду `npm create astro@latest` с опцией `template`.