1C AI Core

Плагин для AI-разработки и сопровождения проектов 1С в Codex. Объединяет поиск и анализ кода, изменение объектов конфигурации через EDT, проверку стандартов, ревью изменений и автоматизированное тестирование с YaXUnit и Vanessa Automation.

Реализует подход к разработке на основе контекста проекта, проверенных знаний и контролируемых действий AI-агента. Перед выполнением изменений учитываются существующие механизмы, применимость решений, стандарты разработки и ограничения безопасности.

Поддерживает интеграцию с EDT-MCP, Code Index, BSL Language Server, v8std и базой знаний OpenViking. Позволяет работать с разными проектами через индивидуальные профили .ai/project.yaml.

flowchart TD
    A["Codex + 1C AI Core"] --> K["Контекст, знания и контроль действий"]
    K --> B["EDT-MCP / Изменение конфигурации"]
    K --> C["Code Index + BSL LS / Анализ кода"]
    K --> D["v8std / Стандарты"]
    K --> E["YaXUnit + Vanessa / Тестирование"]
    K --> F["OpenViking / База знаний"]

Установка из GitHub-магазина

Нужны настольный Codex с локальным выполнением и Node.js 22+ в PATH. EDT-MCP и v8std запускаются отдельно. Плагин подготавливает индекс кода и, по желанию, BSL Language Server; для последнего нужна совместимая Java.

Добавьте магазин ShadobaAI/codex-plugins в Codex. Через CLI это можно сделать командой:
```
codex plugin marketplace add https://github.com/ShadobaAI/codex-plugins.git
```
Откройте каталог плагинов, выберите источник ShadobaAI (shadobaai) и установите 1C AI Core (Stable) или 1C AI Core Preview для предварительных сборок из develop.
Откройте папку своего проекта 1С и начните чат с установленным плагином.
Напишите: «Помоги настроить 1C AI Core для этого проекта». Агент поможет создать профиль, сопоставить репозитории с проектами EDT и указать адреса EDT-MCP и v8std.
Разрешите подготовку нужных компонентов и запустите проверку готовности. Сохранённый адрес подключения ещё не означает готовность проекта EDT.

JS-зависимости включены в пакет: пользователю не нужен npm install. Порядок регистрации магазинов описан в официальной документации Codex. Исходники плагина находятся в edt-ai-core, установочный магазин — в отдельном репозитории codex-plugins.

v8std

v8std предоставляет нормативные материалы и базу знаний для разработки 1С:

zeegin/v8std — исходный проект, основа.
ShadobaAI/v8std — форк автора 1C AI Core с базой знаний по Vanessa и YaXUnit. Рекомендуется использовать этот форк.
aleksp99/v8std-mcp — готовый Docker-образ автора 1C AI Core, собранный из ShadobaAI/v8std, с базой знаний по Vanessa и YaXUnit.

Сервер v8std запускается отдельно; его MCP URL указывается в настройках плагина. Подключая публичный или локальный v8std, пользователь разрешает его операции, включая передачу кода и контекста задачи; дополнительных согласий на работу с этим сервером плагин не запрашивает. Решения среды об одобрении и разрешения на самостоятельные действия с проектом действуют отдельно.

Настройка и работа

Попросите «Открой настройки проекта 1C AI Core» в чате или откройте «Настройки» через карточку плагина. Из чата форма привязана к его проекту; общая форма показывает список известных профилей.

Профиль — .ai/project.yaml в вашем проекте: какие репозитории использовать, где исходники и какой EDT-проект ими управляет. Личные адреса подключений сохраняйте в локальных настройках. Поставляется универсальный шаблон generic-1c; профиль конкретной конфигурации создаётся в её репозитории.

После настройки можно попросить: «Найди реализацию…», «Внеси изменение…», «Проведи ревью ветки…», «Добавь тест YaXUnit…». Запуск тестов требует соответствующего окружения и настройки профиля.

База знаний OpenViking помогает находить готовые механизмы и проверенный опыт. Плагин поддерживает режимы знаний, workflow gates и клиентский MCP-адаптер; публикация, права сервера и live-приёмка проверяются отдельно. Отдельный MCP информационной базы в плагин не входит. Подробности — в документации по интеграциям. Локальные регрессии и поведенческие сценарии описаны в локальных проверках; они не подтверждают полную KORA-готовность.

Разработчику

Корень репозитория совпадает с корнем Node.js-плагина. Для изменения самого плагина EDT не требуется. Нужны Node.js 22+, npm и Git.

git clone https://github.com/ShadobaAI/edt-ai-core.git
cd edt-ai-core
npm ci --ignore-scripts
node tools/vendor.mjs
node tools/test.mjs

Локальная сборка через build-plugin.sh (на Windows — в Git Bash):

bash tools/build-plugin.sh

Без Bash выполните те же действия напрямую:

node tools/vendor.mjs
node tools/package-plugin.mjs

Результат — .build/marketplace/ и два ZIP в .build/: плагин и магазин. Для локальной установки зарегистрируйте готовый магазин:

codex plugin marketplace add ./.build/marketplace

Установите 1C AI Core из этого источника в каталоге плагинов. Сборка заменяет предыдущую .build/ и ничего не публикует. Проверка пакета и выпуск описаны в руководстве разработчика.

Лицензия

Код, навыки и документация 1C AI Core распространяются под Mozilla Public License 2.0. Авторство и сведения о сторонних компонентах — в NOTICE.md; сторонние компоненты сохраняют собственные лицензии. Лицензия Unicode-данных включена в UNICODE-LICENSE.txt, лицензии встроенных Node-зависимостей собираются в vendor/NOTICE.txt.