内容
<p align="center">
<a href="docs/visual-kit/index.html">
<img src="docs/visual-kit/logos/unica-logo-letter-transparent-blue.svg" alt="Unica" width="420">
</a>
</p>
# Unica
Unica (Ю́ника) — публичный плагин [Codex](https://openai.com/codex/) и
[Claude Code](https://code.claude.com/docs/en/overview) для разработки на
1С:Предприятии. Он добавляет навыки и один MCP-сервер `unica`, через который
агент создаёт и проверяет метаданные, формы, роли, СКД, внешние обработки и
отчёты, запускает 1С и ищет BSL-код.
Оба хоста получают один и тот же каталог плагина: манифесты лежат рядом, а
`.mcp.json` определяет корень плагина по той переменной, которую подставляет
конкретный хост.
## Требования
- один из агентов:
- [Codex CLI](https://learn.chatgpt.com/docs/codex/cli);
- [Claude Code](https://code.claude.com/docs/en/overview);
- стандартный Git, включая Git for Windows на Windows;
- платформа 1С только для операций, которым реально требуется запуск 1С.
### Поддерживаемые версии платформы 1С
| Версия платформы | Статус | Что это означает |
| --- | --- | --- |
| `8.5.1.x`, `8.5.4.x` | Планируется | Хотим добавить в ближайшее время. |
| `8.3.27.x` | Поддерживается | Unica поддерживает все актуальные релизы ветки 8.3.27. |
| `8.3.26.x` и ниже | Не планируется | Помогаем мигрировать на 8.3.27. Если вам действительно нужна более старая версия, [создайте issue](https://github.com/IngvarConsulting/unica/issues/new) и опишите причину — нам важно понимать такой сценарий. |
## Установка
### Codex
```sh
codex plugin marketplace add IngvarConsulting/unica-marketplace --ref main
codex plugin add unica@unica
```
После установки откройте new Codex task: список навыков и MCP-конфигурация
фиксируются на границе новой задачи, а не подменяются в уже работающей сессии.
### Claude Code
```sh
claude plugin marketplace add IngvarConsulting/unica-marketplace
claude plugin install unica@unica
```
Затем выполните `/reload-plugins` либо начните новую сессию. Навыки становятся
доступны с префиксом плагина, например `/unica:meta-validate`.
### Загрузка runtime
При первом MCP-вызове `unica` скачивает из релиза `IngvarConsulting/unica`
исполнительные файлы для текущей ОС и архитектуры. Архив и каждый файл
проверяются по SHA-256. Неполная или повреждённая загрузка не получает маркер
готовности.
Готовый runtime атомарно публикуется в кэше хоста:
| Хост | Каталог кэша |
| --- | --- |
| Codex | `$CODEX_HOME/unica/runtimes/<version>/<target>`, при стандартном `CODEX_HOME` — `~/.codex/unica/runtimes/...` |
| Claude Code | `${CLAUDE_PLUGIN_DATA}/runtimes/<version>/<target>`, по умолчанию — `~/.claude/plugins/data/unica-unica/...`; этот каталог переживает обновление плагина |
## Обновление
### Codex
```sh
codex plugin marketplace upgrade unica
codex plugin remove unica@unica
codex plugin add unica@unica
```
Затем откройте new Codex task: уже работающая сессия не загрузит обновлённые
навыки и MCP-конфигурацию.
Отдельной команды `codex plugin upgrade` в поддерживаемом CLI нет, поэтому
переустановка плагина после обновления каталога является намеренным шагом.
### Claude Code
```sh
claude plugin marketplace update unica
claude plugin update unica@unica
```
Затем выполните `/reload-plugins`.
## Переход со старых версий
Узнайте свою версию:
```sh
codex plugin list
```
В строке `unica@...` смотрите столбец `VERSION`.
| Ваша версия | Что делать |
| --- | --- |
| `0.3.0`–`0.7.4` | Запустите скрипт миграции |
| `0.7.5` и новее | Выполните обычное обновление |
Для версий `0.3.0`–`0.7.4` на macOS и Linux:
```sh
curl -fLO https://github.com/IngvarConsulting/unica/releases/download/v0.7.8/install-unica.sh
sh install-unica.sh --ref v0.7.8
```
Для версий `0.3.0`–`0.7.4` в Windows PowerShell:
```powershell
Invoke-WebRequest https://github.com/IngvarConsulting/unica/releases/download/v0.7.8/install-unica.ps1 -OutFile install-unica.ps1
.\install-unica.ps1 -Ref v0.7.8
```
Для версий `0.7.5` и новее:
```sh
codex plugin marketplace upgrade unica
codex plugin remove unica@unica
codex plugin add unica@unica
```
Если скрипт завершился ошибкой, предыдущая установка уже будет восстановлена.
Начиная с `v0.8.0`, текущий пакет не содержит исполняемого кода старых-миграций:
для старых версий поддерживается только переход через замороженную версию `v0.7.8`.
## Удаление
Codex:
```sh
codex plugin remove unica@unica
codex plugin marketplace remove unica
```
Claude Code:
```sh
claude plugin uninstall unica@unica
claude plugin marketplace remove unica
```
Проверенные исполняемые-кэши можно оставить для повторной установки. Их ручное
удаление не является частью обычного процесса удаления.
## Разработка
Для разработки под Codex используется отдельный marketplace `unica-dev`:
```sh
git clone https://github.com/IngvarConsulting/unica.git
cd unica
scripts/dev/install-local-unica.sh
```
Под Claude Code каталог плагина подключается напрямую, без маркетплейса:
```sh
claude --plugin-dir ./plugins/unica
```
На Windows x64 запускайте этот скрипт из **Git Bash**, входящего в 64-битный
Git for Windows. Для локальной сборки нужны Python 3.10 или новее, стабильный
Rust с нативным toolchain MSVC, а также Microsoft C++ Build Tools и Windows SDK.
WSL сохраняет Linux-семантику и собирает `linux-x64`. MSYS2 и Cygwin не входят
в поддерживаемые shell для этого installer; используйте Git Bash.
Исходный `.mcp.json` запускает `cargo run`; локальный скрипт собирает инструменты
только для текущей машины. Официальный пакет остаётся тонким: skills, assets,
три bootstrap-бинарника и `runtime-manifest.json`, без полного runtime.
## Репозиторий
- `plugins/unica/skills/` — прикладные навыки 1С;
- `crates/unica-coder/` — единый MCP runtime `unica`;
- `crates/unica-bootstrap/` — загрузка, проверка и запуск runtime;
- `plugins/unica/third-party/tools.lock.json` — версии внутренних инструментов.
[Авторы, источники и лицензии](plugins/unica/ATTRIBUTIONS.md).
Лицензия Unica: LGPL-3.0-or-later.
MCP 市场