Unica

Unica - это плагин для Codex, который помогает работать с проектами 1С:Предприятие.

Обычным языком: репозиторий содержит набор инструкций, сценариев и подключаемых инструментов, чтобы Codex мог выполнять типовые задачи 1С-разработчика: создавать объекты конфигурации, собирать внешние обработки и отчеты, обновлять базы, запускать проверки и искать код в больших 1С-проектах.

Что в этой репе

• plugins/unica/skills/ - прикладные навыки Codex: формы, метаданные, EPF/ERF, базы, роли, СКД, веб-публикация и другие задачи 1С.
• plugins/unica/.mcp.json - MCP-подключения для поиска кода, работы с инструментами 1С и справочными материалами.
• plugins/unica/scripts/ - безопасные запускатели bundled-инструментов.
• plugins/unica/third-party/tools.lock.json - единый список версий внешних инструментов.
• .github/workflows/unica-plugin-release.yml - сборка готового пакета плагина для установки.

Исходники в репозитории не хранят готовые бинарные утилиты. Они собираются в GitHub Actions и попадают в готовый marketplace-пакет.

Для кого

• Для 1С-разработчиков, которые хотят использовать Codex как помощника по реальным задачам разработки.
• Для тех, кто поддерживает или расширяет сам плагин Unica.
• Для команд, которым нужен воспроизводимый набор 1С-инструментов внутри Codex.

Установка

Одна команда скачивает installer из последнего GitHub Release, определяет платформу, скачивает нужный пакет Unica и устанавливает его в Codex:

curl -fsSL https://github.com/IngvarConsulting/unica/releases/latest/download/install-unica.sh | sh

Для установки конкретного релиза:

curl -fsSL https://github.com/IngvarConsulting/unica/releases/latest/download/install-unica.sh | sh -s -- --version v0.3.11

Release assets собираются отдельно под платформы:

• unica-codex-marketplace-darwin-arm64.tar.gz
• unica-codex-marketplace-linux-x64.tar.gz
• unica-codex-marketplace-win-x64.zip

Installer выбирает нужный архив, регистрирует marketplace unica-local, обновляет cache Codex и включает unica@unica-local.

Проверка:

codex debug prompt-input 'test'

В выводе должны быть видны plugin Unica и навыки вида unica:meta-compile, unica:epf-build, unica:db-update.

Установка из исходников для разработки

Этот режим нужен, если вы меняете сам плагин:

git clone https://github.com/IngvarConsulting/unica.git
cd unica
scripts/dev/install-local-unica.sh

Скрипт соберет пакет под текущую машину из локальных исходников, установит его в Codex как unica-local и проверит свежую сессию через codex debug prompt-input.

Что нужно для работы

• Установленный Codex CLI.
• Для реальных операций с базами и конфигурациями - установленная платформа 1С.
• Для Windows-сценариев - PowerShell.
• Для macOS/Linux MCP-сценариев - shell-окружение.

Где смотреть детали

• Техническое описание плагина: plugins/unica/README.md.
• Внутренняя схема инструментов и сборки: plugins/unica/references/tooling.md.
• Список pinned-инструментов: plugins/unica/third-party/tools.lock.json.

Официальная публикация в публичный каталог Codex будет отдельным шагом, когда OpenAI откроет self-serve публикацию плагинов. Сейчас репозиторий готовит воспроизводимый marketplace-пакет, который можно устанавливать как локальный или Git-backed marketplace.