# Сообщить о проблеме

Что-то сломалось, работало медленнее, чем должно, удивило или отсутствует? Ошибки и пожелания отслеживаются публично на
[elide-dev/elide](https://github.com/elide-dev/elide/issues). Выберите подходящий путь.

| Путь | Когда использовать | Начало |
| --- | --- | --- |
| Ваш ИИ-агент | Вы работаете в Claude Code, Codex, Cursor или другом MCP-клиенте. | [Сообщить через агента](#report-from-your-agent) |
| Issue на GitHub | Вы хотите сами создать issue и следить за ним. | [Создать issue на GitHub](#file-a-github-issue) |
| Discord | Нужна помощь прямо сейчас или вы не уверены, что это ошибка. | [elide.dev/discord](https://elide.dev/discord) |
| Уведомление о безопасности | Проблема — уязвимость. | [Сообщить в частном порядке](#security-vulnerabilities) |

## Сообщить через агента

Один раз подключите публичный [MCP-сервер документации](/docs/mcp-docs):

```bash
claude mcp add --transport http elide-docs https://elide.help/mcp
codex mcp add elide-docs --url https://elide.help/mcp
```

Затем расскажите агенту, что пошло не так:

```text
elide test hangs after the last test passes. Report it to Elide.
```

Агент ищет существующий issue, собирает данные командой `elide agent` и показывает предпросмотр, из которого удалены
секреты, домашние пути и адреса электронной почты. Ничего не отправляется, пока вы не подтвердите. Принятые сообщения
становятся публичными issue, обычно в течение часа.

Пока вы работаете, сервер также просит агента замечать сбои, медленные запуски и неожиданное поведение и предлагать вам
сообщить о них.

- [Сообщить через агента](/docs/agentic-reporting): виды сообщений, шаг подтверждения, данные и что сохраняется.
- [От сообщения до исправления](/docs/agentic-triage): что происходит дальше и как следить за сообщением.

## Создать issue на GitHub

`elide agent bug` выводит текст issue с уже подставленными версией Elide и платформой. Он ничего не отправляет.

```bash
elide agent bug
```

```text
File this report at https://github.com/elide-dev/elide/issues
Or send it through the docs MCP server at https://elide.help/mcp

---

### What happened

<!-- the command you ran, what you expected, what occurred -->

### Environment

| key | value |
| --- | --- |
| version | 1.6.3 |
| platform | linux-amd64 |
…
```

Откройте [новый issue](https://github.com/elide-dev/elide/issues/new), вставьте текст и опишите, что произошло.

Приложите то, что подходит к проблеме:

| Проблема | Что приложить |
| --- | --- |
| Ошибка или сбой | Команду, её полный вывод и самый новый файл в `crash_root`, если он был записан. |
| Неверный результат | Что вы ожидали, что получили и почему: страницу документации или вывод другой среды выполнения. |
| Медленный запуск | Замеры `elide agent perf` в сравнении со средой выполнения или версией Elide, с которой вы сравнивали. |
| Недостающая возможность | Что вы построили бы с её помощью. |

`elide agent diagnostics` выводит вашу версию, платформу и каталог отчётов о сбоях (`crash_root`). Чем меньше проект
или файл, воспроизводящий проблему, тем быстрее её исправят.

```bash
elide agent diagnostics
elide agent perf --baseline "node app.ts" -- elide run app.ts
elide agent perf --against 1.6.2 -- elide run app.ts
```

`--against` запускает уже установленную версию Elide; он никогда её не загружает.

## Уязвимости безопасности

Сообщайте об уязвимости в частном порядке через
[рекомендации по безопасности GitHub](https://github.com/elide-dev/elide/security/advisories/new). Не создавайте
публичный issue, не пишите в Discord и не отправляйте её через MCP-сервер документации, который создаёт публичные issue.

## Перед отправкой

- [Устранение неполадок](/docs/troubleshooting) описывает частые ошибки и их исправление.
- [Совместимость](/docs/compatibility) и [обзор API](/docs/api-overview) перечисляют то, что Elide пока не поддерживает.
- `elide --version` должен совпадать с последним выпуском; см. [Обновление](/docs/upgrading).
- О неверной или отсутствующей странице документации тоже стоит сообщить: используйте **Была ли эта страница
  полезна?** в конце страницы или отправьте `expectation` со ссылкой на страницу.