Content
<div align="center">
[Русский](README.md) · [English](README.en.md)
<img src="docs/assets/readme/ai-edt-hero-agentic.svg" alt="AI-EDT - агентная разработка для 1C:EDT: AI-агент получает доступ к проекту и конфигурации через MCP-сервер" width="100%">
[](https://github.com/Desko77/ai-edt/actions/workflows/build.yml)
[](https://github.com/Desko77/ai-edt/releases/latest)
[](https://desko77.github.io/ai-edt/)
[](#-1-требования)
[](#-1-требования)
[](#-как-это-работает)
[](LICENSE)
**Дайте AI-ассистенту структурированный доступ к проекту 1С через службы запущенного экземпляра EDT.**
[Быстрый старт](#-быстрый-старт) · [Возможности](#-что-можно-делать) · [Архитектура](#-как-это-работает) · [Участие в разработке](#-участие-в-разработке)
</div>
---
AI-EDT - MCP-сервер в виде плагина, работающего **внутри запущенного экземпляра 1C:EDT**. Он позволяет Claude, Cursor, GitHub Copilot и другим MCP-клиентам исследовать и изменять метаданные и BSL, переходить по семантическим ссылкам, управлять отладчиком, проверять проекты и работать с подключенной информационной базой.
Вместо того чтобы воспринимать рабочее пространство EDT как каталог XML- и BSL-файлов, ассистент использует семантическую модель, индексы, валидаторы и службы отладки самой EDT.
> [!IMPORTANT]
> Текущая версия работает на **1C:EDT 2026.2** и **2026.1**. Сборка идет против 2026.1, поэтому один артефакт ставится на обе. Плагин работает везде, где работает EDT; на Windows рассчитаны только описанные ниже скрипты сборки и установки.
## 🎯 Зачем нужен AI-EDT
Ассистент с доступом только к тексту может искать по файлам, но не способен надежно отвечать на вопросы, зависящие от модели IDE:
- На какой объект метаданных указывает эта ссылка?
- Какие формы, роли и подсистемы зависят от справочника?
- Какой тип EDT вывела в этой позиции BSL?
- Почему валидатор проекта отклоняет объект?
- Что происходит в приостановленной отладочной сессии 1С?
- Можно ли применить изменение метаданных без ручного редактирования XML EDT?
- Соберется ли этот запрос именно на этой конфигурации - есть ли в ней такие таблицы и поля?
- Что скажет о новом коде валидатор EDT, а не текстовый линтер со стороны?
- Откроется ли эта форма у пользователя или развалится при загрузке конфигурации в базу?
- Соберется ли схема компоновки так, чтобы отчет заработал, а не просто существовал в файле?
AI-EDT дает для этого специализированные MCP-инструменты - те же службы, которыми пользуется сама среда. Ассистент не просто пишет BSL, запрос, форму, схему компоновки или объект метаданных: он тут же проверяет результат валидаторами EDT, поэтому ошибка всплывает на месте, а не в тот момент, когда конфигурацию впервые загружают в информационную базу. Меньше гадания, меньше хрупких текстовых правок, и вся работа идет в той же модели, которую видит разработчик в IDE.
## ⚡ Что можно делать
| Сценарий | Что может сделать ассистент |
|---|---|
| 🔍 **Исследовать код и метаданные** | Искать по BSL, разрешать символы, находить семантические ссылки, строить иерархии вызовов, получать список модулей и структуру объектов. |
| 🏗️ **Создавать и изменять метаданные** | Создавать справочники, документы, регистры, формы, роли, команды, сервисы и другие объекты через `edit_metadata`, включая предпросмотр и пакетные операции. |
| 🐞 **Отлаживать BSL** | Запускать или подключать отладочную сессию, ставить обычные и exception breakpoints, смотреть переменные, вычислять выражения, выполнять шаги и собирать профилирование. |
| 🩺 **Диагностировать конфигурацию** | Получать проблемы EDT, перевалидировать объекты, исследовать граф зависимостей, находить антипаттерны запросов и оценивать влияние изменений. |
| 🧱 **Собирать сложные артефакты** | Работать со СКД, MXL, XDTO, расширениями, внешними объектами и внешними источниками данных через специализированные мастерские. |
| 🧪 **Тестировать и исследовать данные** | Запускать и отлаживать тесты YAxUnit, выполнять сценарии Vanessa Automation и исследовать состояние исполнения в приостановленной сессии отладки. |
| 🛡️ **Проверять границы доступа** | Аудировать роли и RLS, искать потенциально чувствительные данные в коде и метаданных, отключать записывающие инструменты пресетами. |
| 📦 **Забирать поставку одним файлом** | Импортировать конфигурацию или расширение из `.cf` и `.cfe` прямо в проект - последний сценарий, ради которого приходилось открывать Конфигуратор. |
| 👀 **Видеть, что делал агент** | Открыть историю вызовов из строки состояния: что вызывалось, с какими аргументами и что ответило. |
Сервер предоставляет более ста операций. Родственные действия объединены фасадами `code_search`, `edit_metadata`, `launch_debugger`, `diagnostics`, `insights` и `security_audit`, поэтому MCP-клиент видит компактный набор инструментов вместо длинного списка почти одинаковых команд.
### 🧮 Метаданные, запросы и формы - там, где текстовый ассистент ломается чаще всего
**Метаданные создаются по описанию, а не правкой XML.** Разработчику достаточно сказать, что нужно: справочник с такими-то реквизитами, документ с движениями, форма списка к нему. Ассистент раскладывает это в план операций `edit_metadata` и выполняет его одним пакетом, а не десятком разрозненных вызовов. Любой шаг заранее прогоняется с `dryRun=true` и показывает, что именно будет затронуто; удаление и прочие деструктивные операции требуют отдельного подтверждения. Изменения идут через модель EDT, а не текстом по `.mdo`, и сразу после применения объекты перевалидируются, так что ошибка видна на месте, а не при первой загрузке в информационную базу.
**Запрос проверяется до того, как его кто-то запустит.** `validate_query` разбирает текст в контексте проекта и возвращает синтаксические и семантические ошибки с номерами строк, отдельно для обычных запросов и для запросов СКД. Вместе с ними приходит список подсказок на типовые промахи: слова SQL вместо языка запросов 1С, `УБЫВАНИЕ` вместо `УБЫВ`. Ассистенту не нужно запускать конфигурацию, чтобы выяснить, что запрос не соберется.
**И что этот запрос вернет - тоже.** С `describeResult=true` тот же инструмент сообщает колонки каждого результата и их типы, взятые из модели конструктора запросов EDT, а не вычитанные из текста. Пакет разбирается целиком: временные таблицы не выдаются за результат, но занимают свою позицию в `ВыполнитьПакет()`, поэтому индексы совпадают с реальными. Тип, который определить нельзя, не указывается вовсе - уверенная неправда обошлась бы дороже честного пробела. Ассистент перестает угадывать имена колонок, а с ними уходит целый класс ошибок, которые иначе доживают до рантайма.
**Форму собирает генератор EDT, а не ассистент.** Достаточно описать, какая форма нужна: `create_form` принимает назначение - форма объекта, форма списка, форма выбора, русские синонимы тоже принимаются, - и форму строит тот же генератор, которым пользуется мастер IDE, с основным реквизитом и рабочей раскладкой. Дальше она правится по частям: реквизиты и колонки, поля, таблицы динамических списков, команды, обработчики событий, параметры, командный интерфейс, функциональные опции. Результат читается через `get_form_structure` и просматривается глазами через `get_form_screenshot`, а `validate_for_export` ловит дефекты формы, которые проходят валидацию EDT и проявляются только при загрузке в информационную базу.
## 🔄 Типичный цикл работы агента
```mermaid
flowchart TD
Q["Разработчик описывает задачу"] --> S["AI исследует модель EDT:<br/>код, метаданные, зависимости"]
S --> P["Показывает предлагаемые изменения"]
P --> E["Изменяет BSL или метаданные"]
E --> V["Запускает валидацию EDT и тесты"]
V --> D{"Найдена проблема?"}
D -- Да --> B["Отлаживает сессию 1С"]
B --> E
D -- Нет --> R["Возвращает проверенный результат"]
```
## 🧩 Как это работает
```mermaid
flowchart TD
subgraph Client["MCP-клиент"]
AI["Claude · Cursor · Copilot · Cline"]
end
subgraph Plugin["Плагин AI-EDT · внутри процесса EDT"]
direction LR
HTTP["MCP endpoint<br/>Streamable HTTP + SSE"] --> GATE["Политика доступа<br/>пресеты и разрешения"] --> TOOLS["Фасады<br/>и мастерские"]
end
subgraph EDT["Службы 1C:EDT"]
direction LR
BM["Семантическая<br/>модель"]
AST["Парсер BSL"]
CHECKS["Валидация"]
DEBUG["Отладчик"]
end
subgraph Runtime["1С:Предприятие"]
APP["Клиент · сервер · задания · тесты"]
end
AI <-->|"JSON-RPC · localhost:12250"| HTTP
TOOLS --> BM
TOOLS --> AST
TOOLS --> CHECKS
TOOLS --> DEBUG
DEBUG <--> APP
```
По умолчанию сервер доступен по адресу `http://localhost:12250/mcp`. Плагин не является отдельным headless-сервером: EDT должна быть запущена, а целевой проект - загружен. Благодаря этому инструментам доступны разрешенные ссылки, выведенные типы, текущие маркеры валидации и состояние живой отладки.
## 🚀 Быстрый старт
### 📋 1. Требования
- 1C:EDT
- **2026.2**
- **2026.1**
- Java / JDK
- **25** - для 1C:EDT 2026.2
- **17** - для 1C:EDT 2026.1
- Maven **3.9+** для сборки из исходников
- MCP-совместимый клиент
- ОС - любая, где работает 1C:EDT. Плагин собирается и полностью прогоняет тесты на Linux в CI. Windows нужна только вспомогательным скриптам `build.cmd` и `scripts/edt-selfupdate.ps1`, а команды установки ниже записаны для PowerShell; сама установка через p2 director от ОС не зависит
Для дополнительных возможностей потребуются YAxUnit, Vanessa Automation или конфигурация Attach. Подробнее - в разделе [Дополнительные интеграции](#-дополнительные-интеграции).
### 🔨 2. Сборка
В корне репозитория выполните:
```cmd
build.cmd [EDT_INSTALL_DIR]
```
Альтернативный вариант - собрать Maven-реактор напрямую:
```cmd
cd mcp
mvn clean verify
```
Сгенерированный P2-репозиторий:
```text
mcp/repositories/ru.aiedt.mcp.server.repository/target/repository
```
### 📦 3. Установка в EDT
#### 🤖 Просто попросите агента установить плагин
**Установка сводится к одному сообщению агенту: он поставит плагин сам, без единого щелчка мышью.** Нужен AI-агент с доступом к оболочке на той машине, где стоит EDT.
Скопируйте ему этот промпт:
```text
Установи мне плагин AI-EDT в 1C:EDT.
Рецепт: https://github.com/Desko77/ai-edt/blob/main/docs/agent-install.md
Прочитай его целиком и следуй ему.
Ставь с update site https://desko77.github.io/ai-edt/ через Equinox p2 director
(1cedtc.exe из каталога установки EDT). Мастер "Установить новое ПО" не используй.
Это первая установка, поэтому -uninstallIU не передавай.
Перед установкой закрой запущенный сеанс EDT, запомнив его командную строку;
после установки запусти его теми же аргументами и дождись ответа status: ok
от health endpoint.
После этого поставь себе скил из каталога skills/ai-edt репозитория - без него
ты будешь пользоваться сервером вслепую. Порядок в skills/README.md.
Ничего не завершай принудительно. Если EDT не закрывается сам - остановись и скажи мне.
```
Если плагин уже установлен и вы его обновляете, замените предложение про первую установку на: `Плагин уже установлен, обновляй его одним запросом director с -uninstallIU и -installIU.`
Полный рецепт вместе с правилами обращения с запущенной средой - в [docs/agent-install.md](docs/agent-install.md).
#### 🖱️ Через интерфейс EDT
Оба ручных пути - мастер EDT и командная строка - ставят ту же фичу с того же update site, поэтому собирать плагин самостоятельно не обязательно:
```text
https://desko77.github.io/ai-edt/
```
Этот адрес указывается в EDT так же, как локальный архив.
**Шаг 1.** Запустите EDT и откройте **Справка → Установить новое ПО**.
**Шаг 2.** Нажмите **Добавить** рядом с полем **Работать с**.
**Шаг 3.** В диалоге **Добавить репозиторий** укажите, откуда ставить. Подходит любой из вариантов:
- поле **Расположение** и адрес update site `https://desko77.github.io/ai-edt/`;
- то же поле и адрес прямо на архив последнего релиза - p2 умеет читать репозиторий внутри zip по HTTP:
```text
jar:https://github.com/Desko77/ai-edt/releases/latest/download/AI-EDT-update-site.zip!/
```
Этот вариант всегда указывает на свежий выпуск и не зависит от публикации страницы, поэтому отстать от релиза не может. Обратите внимание на префикс `jar:` и завершающие символы `!/` - без них адрес не работает.
- **Архив...** и файл `mcp/repositories/ru.aiedt.mcp.server.repository/target/AI-EDT-<версия>.zip` из локальной сборки;
- **Расположение...** и каталог `mcp/repositories/ru.aiedt.mcp.server.repository/target/repository`.
Имя репозитория произвольное, например `AI-EDT`.
**Шаг 4.** Отметьте категорию **AI-EDT** или фичу **AI-EDT (1C AI tools for EDT)** внутри нее и нажмите **Далее**. Если список выглядит пустым, снимите флажок **Группировать элементы по категории**.
**Шаг 5.** Проверьте состав установки, примите лицензионное соглашение и нажмите **Готово**.
**Шаг 6.** Сборка не подписана, поэтому при первой установке EDT просит подтвердить установку неподписанного содержимого. Согласитесь, чтобы продолжить.
**Шаг 7.** Когда установщик предложит перезапустить EDT, нажмите **Перезапустить**.
После перезапуска переходите к разделу **4. Запуск и проверка**.
#### ⌨️ Из командной строки
Equinox P2 director ставит ту же фичу без интерфейса. Сначала закройте обновляемый сеанс EDT: запущенный экземпляр держит старый плагин в памяти до перезапуска, то есть перезапуск все равно понадобится, а сеанс, который сам выполняет операцию установки, удерживает блокировку профиля.
```powershell
& "<EDT>\1cedtc.exe" -nosplash `
-application org.eclipse.equinox.p2.director `
-repository "file:///C:/path/to/AI-EDT/mcp/repositories/ru.aiedt.mcp.server.repository/target/repository" `
-uninstallIU ru.aiedt.mcp.server.feature.feature.group `
-installIU ru.aiedt.mcp.server.feature.feature.group `
-profileProperties org.eclipse.update.reconcile=true
```
Фича - это p2-синглтон, поэтому установка новой версии поверх существующей не пройдет, если в том же запросе не удалить старую. При самой первой установке строку `-uninstallIU` нужно убрать: удалять еще нечего.
Для рабочей среды разработки скрипт `scripts/edt-selfupdate.ps1` выполняет весь цикл: аккуратное закрытие, установку, перезапуск и проверку состояния.
#### 🎓 И сразу поставьте скил агенту
Каким бы путем вы ни поставили плагин, установка на этом не заканчивается. Плагин дает агенту инструменты, но не объясняет, как ими пользоваться: какой фасад брать под задачу, какие проверки обязательны после правки, что означает ответ с ключом возврата. Это знание лежит в скиле `skills/ai-edt` и ставится копированием каталога:
```powershell
Copy-Item -Recurse skills\ai-edt "$env:USERPROFILE\.claude\skills\ai-edt"
```
```bash
cp -r skills/ai-edt ~/.claude/skills/ai-edt
```
Это расположение для Claude Code на уровне пользователя; каталог `.claude/skills/ai-edt` внутри проекта ограничит скил одним проектом. Если вы ставили плагин с update site и чекаута рядом нет, заберите каталог поверхностным клоном:
```powershell
git clone --depth 1 https://github.com/Desko77/ai-edt.git "$env:TEMP\ai-edt-skill"
Copy-Item -Recurse "$env:TEMP\ai-edt-skill\skills\ai-edt" "$env:USERPROFILE\.claude\skills\ai-edt"
Remove-Item -Recurse -Force "$env:TEMP\ai-edt-skill"
```
Для другого агента действует его собственное соглашение: `SKILL.md` - обычный Markdown с именем и описанием во front matter, файлы `references/` подгружаются по мере надобности. Подробности - [skills/README.md](skills/README.md).
Скил необязателен: без него агент тоже работает, просто дороже - читает модули целиком, правит руками файлы, которыми владеет EDT, и повторяет вызов, который уже вернул ключ возврата.
### ▶️ 4. Запуск и проверка
Откройте **Window → Preferences → AI-EDT** и проверьте:
1. порт сервера, обычно `12250`;
2. нажмите **Start**, чтобы запустить сервер сейчас, либо включите **Auto-start** и перезапустите EDT;
3. **Plain text mode** для клиентов без поддержки MCP resources;
4. активный пресет инструментов.
После этого проверьте health endpoint:
```powershell
curl.exe http://localhost:12250/health
```
Готовый экземпляр возвращает ответ со значениями `status: ok` и `phase: ready`. Если указано `phase: indexing`, дождитесь завершения загрузки проекта в EDT.
### 🔗 5. Подключение AI-клиента
#### Claude Code
Добавьте сервер в `%USERPROFILE%\.claude.json`:
```json
{
"mcpServers": {
"AI-EDT": {
"type": "http",
"url": "http://localhost:12250/mcp"
}
}
}
```
#### Cursor
Создайте `.cursor/mcp.json` в корне проекта и включите **Plain text mode** в настройках AI-EDT:
```json
{
"mcpServers": {
"AI-EDT": {
"url": "http://localhost:12250/mcp"
}
}
}
```
#### VS Code / GitHub Copilot
Создайте `.vscode/mcp.json`:
```json
{
"servers": {
"AI-EDT": {
"type": "http",
"url": "http://localhost:12250/mcp"
}
}
}
```
Конфигурации для Claude Desktop, Cline и Antigravity находятся в [docs/clients.md](docs/clients.md).
### 🎓 5a. Проверьте, что скил на месте
Скил **[skills/ai-edt](skills/ai-edt)** ставится на шаге установки - [И сразу поставьте скил
агенту](#-и-сразу-поставьте-скил-агенту). Если вы его пропустили, сейчас самый момент: клиент уже
подключен, и разница видна с первого задания. Проверить просто - в Claude Code скил появляется в
списке доступных под именем `ai-edt`.
### 💬 6. Первый вызов
Попросите клиента вывести список проектов EDT или версию EDT. Успешный ответ должен содержать структурированную информацию о проекте, а не сообщение "инструмент недоступен".
Примеры запросов:
```text
Покажи проекты EDT в текущем рабочем пространстве и кратко опиши состояние их валидации.
```
```text
Найди все семантические ссылки на Справочник.Номенклатура и сгруппируй их по метаданным, формам и модулям BSL.
```
## 🧰 Набор инструментов
В основе API AI-EDT лежат фасады. Фасад принимает дискриминатор операции и направляет родственные действия через единую стабильную точку входа.
> [!TIP]
> **[Открыть полный каталог инструментов →](docs/tools/README.ru.md)**
> Все группы инструментов, режимы доступа и раскрываемые описания ключевых фасадов.
| Фасад | Область применения |
|---|---|
| `code_search` | Текстовый поиск, ссылки, разрешение символов, иерархия вызовов, информация о символах и content assist. |
| `edit_metadata` | Изменение метаданных, форм, команд, ролей, сервисов, макетов и других элементов модели. |
| `launch_debugger` | Запуск/подключение, точки останова, шаги, переменные, вычисление выражений и профилирование. |
| `diagnostics` | Проблемы проекта, документация проверок, очистка и точечная перевалидация. |
| `insights` | Зависимости, метрики, антипаттерны, сравнение и анализ влияния. |
| `security_audit` | Права ролей, нарушения RLS и поиск чувствительных данных. |
| `project_admin` / `infobase_admin` | Проекты рабочего пространства, конфигурации запуска, обновление ИБ и синхронизация. |
| `dcs_workshop` / `mxl_workshop` / `xdto_workshop` | Программные конструкторы сложных артефактов 1С. |
| `extension_workshop` / `external_object_workshop` | Жизненный цикл расширений, внешних отчетов и обработок. |
| `yaxunit_tests` | Запуск или отладка выбранных тестов YAxUnit и чтение отчетов. |
Прежние отдельные имена инструментов сохранены как алиасы для обратной совместимости. Пресет **Canonical** скрывает их из `tools/list`, уменьшая расход контекста без потери возможностей.
## 🔐 Пресеты инструментов и безопасность
На странице настроек **Tools** инструменты сгруппированы по назначению и доступны следующие пресеты:
| Пресет | Назначение |
|---|---|
| **Canonical** | Рекомендуемый вариант. В списке видны фасады, а алиасы совместимости остаются вызываемыми, но скрытыми. |
| **All Tools** | Показывает каждый зарегистрированный инструмент и алиас. Полезно для исследования API. |
| **Read-only** | Поиск, навигация и валидация без правок, отладки и обновления ИБ. |
| **Editing** | Чтение и запись без отладки. |
| **Debug & Test** | Чтение, отладка и тесты без изменения исходников и метаданных. |
| **Code Review** | Анализ кода и метаданных без записи. |
У каждого инструмента может быть состояние **listed**, **callable-hidden** или **disabled**. Скрытые инструменты продолжают принимать вызовы, отключенные - отклоняются. Благодаря этому Canonical уменьшает шум в каталоге, а ограничивающие пресеты действительно устанавливают границы доступа.
> [!CAUTION]
> Плагин работает с правами процесса EDT. Он может изменять исходники, метаданные и информационные базы. Храните проект в системе контроля версий, проверяйте предпросмотр перед подтверждением разрушающих операций и не публикуйте локальный порт без аутентификации за пределами loopback-интерфейса.
### Токен доступа и привязка к интерфейсу
По умолчанию сервер слушает только `127.0.0.1` и не требует аутентификации: за пределы машины он не выходит. Если endpoint нужно открыть наружу, на странице **Preferences → AI-EDT** есть две настройки, и включать их следует вместе:
- **Bearer-токен.** Кнопка генерации создает случайный токен; клиент передает его заголовком `Authorization: Bearer <токен>`. Сравнение идет за константное время, чтобы токен нельзя было подобрать по времени ответа. Запрос без верного токена отклоняется до того, как дойдет до инструмента.
- **Привязка ко всем интерфейсам.** Снимает ограничение loopback. Если ее включить без токена, плагин пишет предупреждение в лог: любой хост, который дотянется до машины, получит право читать и менять исходники и информационную базу.
### Маскирование персональных данных
Отдельная настройка включает маскирование данных, попадающих в ответ инструмента, - по категориям 152-ФЗ: ИНН, СНИЛС, номер карты, паспорт, телефон, email. По умолчанию выключена.
Что важно понимать про нее честно:
- Маскирование сделано с приоритетом точности над полнотой. ИНН, СНИЛС и карта проверяются по контрольной сумме, у паспорта и телефона обязателен разделитель - поэтому произвольный числовой идентификатор не будет испорчен. Обратная сторона: это не ловит ФИО, адреса и прочие персональные данные в свободном тексте.
- Маскируется собственный вывод инструмента и текст ошибок, но не конверт JSON-RPC и не бинарные изображения: структура ответа не меняется, только содержимое строк.
- Это снижает риск утечки в облачную модель, но не заменяет решение о том, какие данные вообще показывать ассистенту.
### История вызовов
Каждый вызов инструмента записывается: что вызвали, с какими аргументами, что ответили, сколько заняло. Открыть - из индикатора AI-EDT в строке состояния, пункт **Call history**. Окно немодальное: агент продолжает работать, пока вы читаете.
Заголовок окна показывает, сколько вызовов хранится и по скольку символов запроса и ответа, а над панелью ответа видно, какая часть сохранена: `Response (303 of 1957 characters)`. Так урезанную запись нельзя принять за короткий ответ.
Настройки в **Window -> Preferences -> AI-EDT**, раздел **Call history**: вести ли запись вообще, сколько вызовов хранить, сколько символов запроса и ответа сохранять. Умолчания рассчитаны на вопрос "какие инструменты отработали", а не "что именно они ответили" - если нужен полный ответ, увеличьте число символов, оно и решает, что вы увидите.
Глубина и объем ограничены совместно: буфер целиком не превышает заданного предела памяти, и если запрошенные значения в него не помещаются, число символов уменьшается пропорционально. Фактические значения показаны в заголовке окна истории, так что урезание видно. Умолчания до этого предела не достают.
Отдельная настройка дописывает каждый вызов в файл в служебном каталоге плагина, чтобы запись пережила перезапуск EDT. По умолчанию выключена. Файл ограничен по размеру и ротируется. Пароли информационных баз в него не попадают: значения аргументов с ключом вида `password`, `token`, `secret` заменяются на `***` до записи. Персональные данные в файле маскируются - это можно отключить, но по умолчанию включено, потому что файл живет дольше сессии и уезжает вместе с приложением к отчету об ошибке.
### Прочие меры
- Инструменты рефакторинга метаданных используют сценарий preview/confirm.
- Для незнакомых проектов рекомендуется пресет Read-only.
- `evaluate_expression` выполняет код в живой сессии 1С.
- Удаление ИБ, импорт конфигурации и синхронизацию можно отключить отдельно.
- Перед структурными обновлениями, которые нельзя отменить через Git, сделайте резервную копию ИБ.
## 🐞 Отладка клиентского и серверного кода
Фасад отладки поддерживает обычные клиентские запуски и конфигурации **Attach to 1C:Enterprise Debug Server**. Attach необходим для HTTP-сервисов, серверных вызовов, фоновых и регламентных заданий, а также кода, выполняемого в `rphost`.
Агент получает список конфигураций запуска EDT, подключается к серверу отладки 1С, устанавливает точку останова и ждет приостановки. После этого AI-EDT возвращает стабильные ссылки на поток, стек и кадр, чтобы агент мог исследовать переменные, вычислять выражения, выполнять код по шагам и продолжать выполнение.
## 🔌 Дополнительные интеграции
| Интеграция | Что становится доступно | Что нужно настроить |
|---|---|---|
| **YAxUnit** | Запуск и отладка unit-тестов, фильтрация наборов и разбор JUnit-отчетов. | Установить расширение YAxUnit в целевую информационную базу. |
| **Vanessa Automation** | Выполнение сценарных UI-тестов. | Отдельно настроить Vanessa и требуемую конфигурацию запуска. |
| **Сервер отладки 1С** | Отладка серверного BSL через Attach. | Запустить `ragent` с `-debug -http` и создать конфигурацию Attach в EDT. |
| **BSL Language Server** | Дополнительный анализ исходников через `code_review`. | Указать внешний JAR в настройках AI-EDT. |
## ⚠️ Ограничения
- AI-EDT зависит от внутренних и публичных служб EDT; после крупного обновления EDT может потребоваться новая версия плагина.
- Сервер доступен только при запущенной EDT.
- Для части семантических инструментов необходимо дождаться завершения индексации проекта.
- По умолчанию endpoint слушает loopback и не требует аутентификации. Bearer-токен и привязка ко всем интерфейсам есть в настройках, но включать их нужно осознанно - см. раздел про безопасность.
- Update site публикуется автоматически при выпуске релиза. Промежуточные сборки между релизами ставятся из исходников или из локального P2-репозитория.
## 🤝 Участие в разработке
Проект принимает воспроизводимые сообщения об ошибках, сфокусированные предложения возможностей, улучшения документации и pull request.
Начните с документов:
- [CHANGELOG.md](CHANGELOG.md) - что изменилось в каждом выпуске, одной строкой со ссылкой на подробности;
- [CONTRIBUTING.md](CONTRIBUTING.md) - сборка, стиль кода и правила участия;
- [SECURITY.md](SECURITY.md) - закрытая передача уязвимостей и модель угроз;
- [docs/PROVENANCE.md](docs/PROVENANCE.md) - происхождение исходников и история переимплементации.
Структура репозитория:
```text
mcp/
├── bundles/ # реализация OSGi-плагина
├── features/ # устанавливаемая Eclipse feature
├── repositories/ # генерируемый P2-репозиторий
├── targets/ # target platform EDT
└── tests/ # тесты плагина и контрактов
docs/ # руководства, аудиты и release notes
scripts/ # автоматизация разработки и обновления
```
Перед созданием pull request соберите Maven-реактор и опишите, как изменение было проверено на запущенном экземпляре EDT.
## 📜 Происхождение проекта
AI-EDT - самостоятельный продукт, созданный на основе [EDT-MCP](https://github.com/DitriXNew/EDT-MCP) автора DitriX. Проект распространяется под лицензией AGPL-3.0-or-later; сохраненные уведомления и подробная история исходников описаны в [LICENSE](LICENSE) и [docs/PROVENANCE.md](docs/PROVENANCE.md).
## ⚖️ Лицензия
GNU Affero General Public License версии 3.0 или новее. Полный текст - в [LICENSE](LICENSE).
Connection Info
You Might Also Like
No recommendations available