Разработка на 1С с AI‑агентом

Установка

1. Что понадобится

   • Агент. Codex или Claude Code с действующей подпиской. Unica подключается к нему как плагин.
   • Git. Через него ставится плагин. На Windows подойдёт Git for Windows.
   • Выгрузка конфигурации в файлы. Unica работает с каталогом, в который конфигуратор 8.3.27 выгрузил конфигурацию или расширение, а не с базой напрямую. Если выгрузки ещё нет, Unica сделает её сама из вашей базы: для этого нужна установленная платформа.
   • Платформа 1С только для запуска. Читать, проверять и править выгрузку можно без установленной платформы. Она нужна операциям, которые собирают базу или запускают конфигуратор.

   Работает на Windows, macOS и Linux. Ядро и движки докачиваются при первом запуске; что именно и откуда, описано в разделе «Сеть и данные».

2. Поставить плагин

   Codex и Claude Code ставятся из одного маркетплейса. Нативная поддержка ZCode готовится; её статус — на вкладке ZCode.

   Codex Claude Code ZCode

   codex plugin marketplace add IngvarConsulting/unica-marketplace --ref main
   codex plugin add unica@unica

   claude plugin marketplace add IngvarConsulting/unica-marketplace
   claude plugin install unica@unica

   Нативная поддержка готовится в PR #1097. Выпуски 0.12.3 и 0.13.0-rc.3 её ещё не содержат. Перед установкой дождитесь выпуска, в примечаниях к которому указана поддержка ZCode.

   Для ZCode будет использоваться тот же каталог Unica. Отдельный маркетплейс добавлять не понадобится.

   После выхода такого выпуска откройте Plugin Marketplace → Add → Add Plugin Marketplace и добавьте https://github.com/IngvarConsulting/unica-marketplace.git. В разделе Personal найдите Unica и установите плагин. Оставьте включённой одну установку Unica и начните новую задачу.

   Кандидаты выходят в канале next. Его версия может отличаться от стабильной.

   После установки в Codex откройте новую задачу. В Claude Code начните новую сессию или выполните /reload-plugins.

   Следующую версию можно поставить до выхода: кандидатов раздаёт отдельный канал next.

   Команды выше добавляют ветку main: обновление каталога приносит следующий стабильный выпуск. Чтобы закрепить конкретную версию, добавьте маркетплейс по её тегу: --ref vX.Y.Z у Codex, #vX.Y.Z у Claude Code. Теги с v0.9.1 по v0.13.0-rc.5 указывают на каталог предыдущей версии и ставят её, поэтому эти версии ставьте по ветке; начиная с v0.13.0-rc.6 тег ставит свою версию. Если маркетплейс unica уже добавлен по ветке, сначала удалите его командой marketplace remove unica.

3. Первый запрос

   Откройте агента в каталоге проекта и попросите подключить его. Дальше разговор идёт словами разработчика, а Unica отвечает планом до каждой записи.

   Подключи проект и покажи, что в нём есть

   Агент с Unica

   Нашёл выгрузку конфигуратора в каталоге src. Файла проекта ещё нет, план такой:

   • создать v8project.yaml с набором main, тип CONFIGURATION, путь src

   Создать?

   Да

   Агент с Unica

   Готово. Конфигурация прочитана: справочники, документы, регистры, общие модули, роли. Готовность проверена, можно работать.

   Добавь справочнику Контрагенты реквизит ИНН, строка 12

   Агент с Unica

   План правки main:Catalog.Контрагенты:

   • реквизит ИНН, Строка (12), переменная длина
   • остальные реквизиты, формы и модули без изменений

   Записать в файлы?

   Записывай

   Агент с Unica

   Записано в src/Catalogs/Контрагенты.xml. Проверка справочника прошла без ошибок.

Поддерживаемые версии платформы

Версия платформы задаёт формат выгрузки, а Unica читает и пишет ровно один формат. Каждая лишняя ветка это ещё один формат, который нужно держать в тестах, поэтому старые версии не поддерживаем намеренно: актуальные типовые конфигурации уже вышли на 8.3.27 и выше.

С чего начать

Порядок для того, кто хочет вносить вклад: сначала что Unica делает, потом как она устроена, потом по каким правилам её меняют.

1. Что умеет

   Каталог задач разработчика, которые Unica проходит цепочкой вызовов. Тот же список гоняет приёмочный тест, поэтому в нём нет ничего, что не работает.

2. Архитектура

   Кто приходит по MCP, две поверхности инструментов, тонкий процесс и демон, движки под ними.

3. github.com/IngvarConsulting/unica/CONTRIBUTING.md

   Окружение: Python 3.12, Rust, rust-analyzer для кодового агента и навыки для Codex и Claude Code.

4. github.com/IngvarConsulting/unica/AGENTS.md

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

5. github.com/IngvarConsulting/unica/arch/

   Нормативный слой: решения, инварианты и контракты, одна запись — один файл. На них ссылаются тесты, поэтому спор о правиле решается здесь.