1C Enterprise Agent Toolkit

Универсальный инструментарий для AI-агентов, которые работают с любыми прикладными конфигурациями 1С:Предприятие, BSL и расширениями. Он не содержит привязки к УНФ или другой типовой конфигурации: выгружает только указанные пользователем метаданные, изолирует работу над расширениями от основной базы, проверяет результат пакетного Конфигуратора и удаляет созданные им временные данные.

Установка за 60 секунд

git clone https://github.com/Muredsa/1C-Enterprise-Agent-Toolkit.git
cd 1C-Enterprise-Agent-Toolkit
py install.py --agent codex

Перезапустите Codex и вызовите $onec-dev. Для Claude Code используйте python3 install.py --agent claude, а для другого агента — python3 install.py --target /path/to/agent/skills.

[!IMPORTANT] Платформа 1С и информационная база не входят в проект. Перед первым использованием проверьте работу на одноразовой копии базы.

Что умеет

Общий CLI scripts/onec.py использует только стандартную библиотеку Python. Структура skills/<name>/SKILL.md переносима между агентами.

Как устроен безопасный цикл

flowchart LR
    A["Исходная файловая база"] -->|"копирование"| B["Изолированная сессия onec-dev-*"]
    B --> C["Выборочная выгрузка объектов"]
    C --> D["Создание или изменение расширения"]
    D --> E["Проверка и контрольная выгрузка"]
    E --> F["Удаление только данных сессии"]
    A -. "не изменяется" .-> F

Основные гарантии:

• файловая база по умолчанию копируется в отдельную маркированную сессию;
• все логи, /DumpResult, выгрузки и резервные копии остаются внутри неё;
• очистка отклоняет корень диска, домашнюю и текущую папку, неверный маркер и ссылки;
• пароль передаётся только через имя переменной окружения;
• существующее расширение резервируется в редактируемом и рабочем формате;
• успешным считается только нулевой код процесса, нулевой /DumpResult и чистый лог.

Полные ограничения описаны в контракте безопасности.

Первый безопасный запуск

Найдите установленную платформу:

py scripts/onec.py discover

Создайте изолированную сессию:

py scripts/onec.py session-create `
  --base-file "C:\путь\к\базе" `
  --user "Администратор"

Используйте путь session из полученного JSON:

py scripts/onec.py selective-export `
  --session "C:\путь\к\onec-dev-...\manifest.json" `
  --object "Catalog.Номенклатура"

После работы удалите сессию:

py scripts/onec.py session-cleanup `
  --session "C:\путь\к\onec-dev-...\manifest.json"

Готовый универсальный сценарий находится в examples/safe-object-inspection. Все параметры доступны через py scripts/onec.py <команда> --help.

Живая файловая база требует одновременно --no-sandbox --allow-live-base; серверная или заданная строкой подключения — --allow-live-base. Эти режимы применяются только после явного решения пользователя.

Совместимость

Выборочная выгрузка требует платформу с поддержкой -listFile. Имена объектов всегда передаются явно, поэтому CLI одинаково работает с типовыми, отраслевыми и самописными конфигурациями. При создании расширения он сам определяет основной язык конфигурации и не предполагает, что это русский. УНФ используется только как документированная среда интеграционного теста, а не как ограничение инструментария.

Проверка проекта

python3 -m unittest discover -s tests -v

CI проверяет Python-код, манифесты, frontmatter скиллов и ограничения очистки. Интеграционный сценарий описан в tests/INTEGRATION.md, а подтверждённый прогон на УНФ — в tests/INTEGRATION-2026-08-11.md.

План развития

• больше проверенных примеров для типовых конфигураций;
• публикация стабильных версий и заметок о совместимости;
• расширение автоматизированных проверок без ослабления контракта безопасности;
• подготовка пакетов для каталогов агентов после стабилизации форматов.

Участие в проекте

Сообщения об ошибках и идеи принимаются через Issues. Перед Pull Request прочитайте CONTRIBUTING.md и SECURITY.md.

Поддержать проект

Если инструментарий оказался полезен и сэкономил вам время, вы можете поддержать его развитие через CloudTips. Поддержка помогает проверять новые версии платформы и развивать безопасные сценарии работы с конфигурациями и расширениями 1С.

Проект распространяется по лицензии MIT. 1С и 1С:Предприятие являются товарными знаками соответствующего правообладателя. Это независимый общественный проект, не связанный с фирмой «1С» и не одобренный ею.