Skip to content
Back to search

unica

Unica (Ю́ника) — публичный плагин Codex и Claude Code для разработки на 1С:Предприятии.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/IngvarConsulting/unica with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/IngvarConsulting/unica'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ingvarconsulting--unica/badge.svg)](/listings/ingvarconsulting--unica)

HTML

<a href="/listings/ingvarconsulting--unica"><img src="/api/listings/ingvarconsulting--unica/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Codex

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

После установки откройте new Codex task: список навыков и MCP-конфигурация фиксируются на границе новой задачи, а не подменяются в уже работающей сессии.

Claude Code

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

Затем выполните `/reload-plugins` либо начните новую сессию. Навыки становятся доступны с префиксом плагина, например `/unica:meta-info`.

ZCode

Пакет содержит нативный `.zcode-plugin/plugin.json`, общий `.mcp.json` и те же навыки и runtime, что для Codex и Claude Code. Отдельный MCP-сервер, launcher или преобразователь аргументов для ZCode не требуется.

В ZCode откройте **Plugin Marketplace → Add → Add Plugin Marketplace** и добавьте каталог выпуска, содержащего ZCode-манифест. Для локальной проверки используйте корень собранного marketplace, а не исходный `plugins/unica`: его `.mcp.json` предназначен для разработки через Cargo. В **Personal** найдите плагин и установите его; установленными плагинами управляет **Settings → Plugins**. Оставьте включённой только одну установку Юники, чтобы не запускать две версии.

После установки начните **новую задачу** и попросите вызвать `unica.run` с `{}` без запуска 1С. Ожидается словарь операций текущей версии, а не требование заполнить все аргументы. Уже открытая сессия может хранить старую схему `runtime.execute`; она не проверяет новый пакет. Успешная упаковка или прямой `tools/list` не заменяет этот тест через выбранную модель и провайдера. Подробности локальной проверки — в [CONTRIBUTING.md](CONTRIBUTING.md#проверка-локального-плагина-в-zcode).

Доставка ядра и движков

При старте MCP bootstrap скачивает только ядро `unica` из релиза `IngvarConsulting/unica` для текущей ОС и архитектуры. После запуска ядро доставляет нужный движок из закреплённого релиза `unica-toolchain` перед первым вызовом, которому этот движок действительно нужен. Архив, ассет и каждый файл проверяются по SHA-256; неполная или повреждённая загрузка не получает маркер готовности.

Если доставка движка не завершилась внутри ограниченного окна, вызов возвращает `work.status=working` и не запускает обработчик. Повторите тот же предметный вызов: отдельного публичного инструмента установки нет. Параллельные вызовы делят одну загрузку.

Корень кэша зависит от хоста:

| Хост | Каталог кэша | | --- | --- | | Codex | `$CODEX_HOME/unica/runtimes`, при стандартном `CODEX_HOME` — `~/.codex/unica/runtimes` | | Claude Code | `${CLAUDE_PLUGIN_DATA}/runtimes`, по умолчанию — `~/.claude/plugins/data/unica-unica/...`; этот каталог переживает обновление плагина | | ZCode | `${ZCODE_PLUGIN_DATA}/runtimes`; хост также передаёт совместимый `CLAUDE_PLUGIN_DATA` с тем же значением |

Явные `UNICA_RUNTIME_CACHE_DIR` и `UNICA_PROVIDER_STATE_DIR` сохраняют приоритет над настройками хостов. При запуске через bootstrap состояние провайдеров без переопределения размещается в `<каталог данных плагина>/unica/provider-state`. Локальный debug-пакет запускает ядро напрямую: без `UNICA_PROVIDER_STATE_DIR` оно использует `~/.unica/provider-state`, а не каталог данных плагина. Оба пути — корни хранилища, не идентичность рабочего проекта. Рабочую папку ZCode передаёт через `ZCODE_PROJECT_DIR` и совместимый `CLAUDE_PROJECT_DIR`; конфликт значений даёт отказ, а не выбор чужого проекта.

Внутри корня каждая неизменяемая поставка лежит по адресу `<artifact>/<version>--<asset-sha256>/<target>`. Поэтому пересобранные байты с той же версией не перезаписывают прежний движок. Для образа, который после сборки работает без сети, заранее доставьте ядро и все движки:

<plugin-root>/bootstrap/bin/<target>/unica-bootstrap prefetch --plugin-root <plugin-root>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 103 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <a href="https://ingvar.pro/products/unica">
  3. <img src="docs/visual-kit/logos/unica-logo-letter-transparent-blue.svg" alt="Unica" width="420">
  4. </a>
  5. </p>
  6. # Unica
  7. Unica (Ю&#x301;ника) — плагин для [Codex](https://openai.com/codex/),
  8. [Claude Code](https://code.claude.com/docs/en/overview) и ZCode для разработки на
  9. 1С:Предприятии. Он добавляет навыки и один MCP-сервер `unica`, через который
  10. агент создаёт и проверяет метаданные, формы, роли, СКД, внешние обработки и
  11. отчёты, запускает 1С и ищет BSL-код.
  12. ## Требования
  13. - один из агентов:
  14. - [Codex CLI](https://learn.chatgpt.com/docs/codex/cli);
  15. - [Claude Code](https://code.claude.com/docs/en/overview);
  16. - ZCode Desktop;
  17. - стандартный Git, включая Git for Windows на Windows;
  18. - платформа 1С только для операций, которым нужен запуск 1С.
  19. ### Поддерживаемые версии платформы 1С
  20. | Версия платформы | Статус | Что это означает |
  21. | --- | --- | --- |
  22. | `8.5.4.x` | Поддерживается | Исходники в формате выгрузки 2.22 читаются и правятся в своём формате. Эталоны выгрузки сняты на 8.5.4.2028. |
  23. | `8.5.1.x` | Поддерживается | Исходники в формате выгрузки 2.21 читаются и правятся в своём формате. Эталоны выгрузки сняты на 8.5.1.1529. |
  24. | `8.3.27.x` | Поддерживается | Unica поддерживает все актуальные релизы ветки 8.3.27. |
  25. | `8.3.26.x` и ниже | Не планируется | Помогаем мигрировать на 8.3.27. Если вам действительно нужна более старая версия, [создайте issue](https://github.com/IngvarConsulting/unica/issues/new) и опишите причину — нам важно понимать такой сценарий. |
  26. Каждый набор исходников правится в своём формате выгрузки: Unica не переводит набор в другой формат без вашего выбора. Основа и расширение могут быть выгружены разными версиями одной линии — платформа загружает их вместе.
  27. ## Установка, обновление и удаление
  28. После каждого из этих действий начните новую сессию агента: уже открытая
  29. сессия не видит изменённые навыки и MCP-сервер. В Claude Code вместо этого
  30. можно выполнить `/reload-plugins`.
  31. ### Codex
  32. ```sh
  33. codex plugin marketplace add IngvarConsulting/unica-marketplace --ref main
  34. codex plugin add unica@unica
  35. ```
  36. Обновление: каталог обновляется, плагин переустанавливается.
  37. ```sh
  38. codex plugin marketplace upgrade unica
  39. codex plugin remove unica@unica
  40. codex plugin add unica@unica
  41. ```
  42. Удаление: `codex plugin remove unica@unica`, затем
  43. `codex plugin marketplace remove unica`.
  44. ### Claude Code
  45. ```sh
  46. claude plugin marketplace add IngvarConsulting/unica-marketplace
  47. claude plugin install unica@unica
  48. ```
  49. Обновление:
  50. ```sh
  51. claude plugin marketplace update unica
  52. claude plugin update unica@unica
  53. ```
  54. Удаление: `claude plugin uninstall unica@unica`, затем
  55. `claude plugin marketplace remove unica`. Навыки доступны с префиксом
  56. плагина, например `/unica:meta-info`.
  57. Скачанные ядро и движки можно оставить в кэше для повторной установки:
  58. при обычном удалении плагина удалять их вручную не нужно.
  59. ### ZCode
  60. 1. В **Plugin Marketplace → Add → Add Plugin Marketplace** добавьте каталог
  61. выпуска с манифестом ZCode.
  62. 2. В **Personal** установите `unica`.
  63. Чтобы обновить плагин, обновите каталог в источниках marketplace и нажмите **Update**
  64. у плагина в **Personal**. Установленными плагинами управляет
  65. **Settings → Plugins**. Оставьте включённой одну установку Unica.
  66. Канал кандидатов `next`, установка конкретной версии по тегу, доставка ядра
  67. и движков, каталоги кэша, офлайн-образ, сертификаты и прокси описаны в
  68. [README плагина](plugins/unica/README.md).
  69. ## Ссылки
  70. - [Справочник инструментов](docs/tool-surface.md) — инструменты `unica.*`
  71. и их аргументы.
  72. - [Сайт проекта](https://ingvarconsulting.github.io/unica/) и
  73. [канал кандидатов `next`](https://ingvarconsulting.github.io/unica/next.html).
  74. - [Разработка Unica](CONTRIBUTING.md) — локальная сборка, окружение
  75. и проверки.
  76. - [Авторы, источники и лицензии](plugins/unica/ATTRIBUTIONS.md).
  77. Лицензия Unica: LGPL-3.0-or-later.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.