api-design
Проектирование и ревью API 1С: публичный программный интерфейс, служебный интерфейс, переопределяемые модули, совместимость,…
Локализация конфигурации 1С: НСтр/NStr, языки, переводы интерфейса и форматирование. Используй для подготовки к другому языку или проверки многоязычного кода и метаданных.
Claude Code
$ npx -y skills add IngvarConsulting/unica --skill localization --agent claude-code
Codex
$ npx skills add IngvarConsulting/unica --skill localization -a codex -y
Cursor
$ npx skills add IngvarConsulting/unica --skill localization -a cursor -y
Gemini CLI
$ npx skills add IngvarConsulting/unica --skill localization -a gemini-cli -y
GitHub Copilot
$ npx skills add IngvarConsulting/unica --skill localization -a github-copilot -y
OpenCode
$ npx skills add IngvarConsulting/unica --skill localization -a opencode -y
Windsurf
$ npx skills add IngvarConsulting/unica --skill localization -a windsurf -y
name: localization description: "Локализация конфигурации 1С: НСтр/NStr, языки, переводы интерфейса и форматирование. Используй для подготовки к другому языку или проверки многоязычного кода и метаданных."
Определи целевые языки, проверь пользовательские тексты и сохрани существующие переводы. Отделяй выполненные изменения от аудита и шагов, для которых публичная поверхность ещё не предоставляет операции.
`Language.Name` — имя объекта, `LanguageCode` — код вроде `ru` или `en`. `Configuration.DefaultLanguage` ссылается на объект языка; например, `Language.Русский` само по себе не сообщает его код. `ScriptVariant` выбирает язык BSL, а не язык интерфейса. `LocaleCode` региональных настроек управляет форматами чисел, дат и Булево отдельно от выбора текста через НСтр.
Начни с `unica.view {}` и выданного корня конфигурации. В его свойствах `properties.defaultLanguage` и ветви `Language` проверь основной язык и состав. Если деталь языка показывает только `kind`, а `LanguageCode` не выдаётся, проверь другие доступные исходные данные задачи, затем уточни недостающие коды у пользователя. Не выводи код из имени объекта или языка переписки. Расширение имеет собственный языковой профиль; внешние обработки и отчёты при выполнении используют языки открывшей их конфигурации. Для скалярных многоязычных значений внешнего артефакта writer Unica выбирает явный `ru` по умолчанию: собственного `DefaultLanguage` у такого набора нет. Это не выбирает язык выполняющей базы.
Для подготовки к английскому составь перечень существующих и целевых кодов, основного языка, доступных переводов и пробелов. Добавление языка предполагает уникальный код, регистрацию в конфигурации и заполнение интерфейсных текстов. Выполняй его только при наличии соответствующей операции в текущем `Can`. Отсутствующая операция остаётся незавершённым шагом подготовки.
Полнота переводов по выбранным языкам — проверка качества проекта. Для НСтр и интерфейсных строк нет общего требования равенства всех наборов кодов: в интерфейсных текстах могут остаться переводы удалённых языков. Не удаляй их без поручения. Объявленные языковые страницы макетов проверяй по отдельным правилам ресурса.
`НСтр(ИсходнаяСтрока, КодЯзыка)` / `NStr` возвращает строку. Второй аргумент — необязательная строка с кодом языка, не числовой индекс; массива переводов функция не возвращает. Без второго аргумента выбирается язык пользователя; справка описывает результат на языке пользователя либо основном языке конфигурации. Не используй непроверенный fallback вместо проверки полноты.
Текст = НСтр("ru = 'Документ %1 не найден';
|en = 'Document %1 was not found'");
Сообщить(СтрШаблон(Текст, ПредставлениеДокумента));
Ответ = НСтр("ru = 'Да'; en = 'Yes'", "en");Записи разделяются `;`, код и текст — `=`. В примере текст каждой записи заключён в одинарные кавычки внутри строкового литерала BSL. `|` продолжает многострочный литерал: физический перенос попадает в строку. Здесь перенос разделяет записи языков; перенос внутри кавычек перевода станет частью пользовательского текста. Не разрывай подпись ради ширины исходника.
Локализуй подписи, подсказки, команды, сообщения и показываемые пользователю исключения. Для составного сообщения переводи целую фразу и подставляй значения через `%1`, `%2` и `СтрШаблон`; склейка переведённых слов ломает порядок слов. Именованные `%Параметр%` не являются синтаксисом СтрШаблон. Используй подходящие представления метаданных, когда они уже решают задачу.
Внутренние имена, ключи, коды протоколов и идентификаторы не переводятся; локализованное представление не служит ключом алгоритма. Журнал регистрации не исключается целиком: его тип события и комментарий локализуемы. Для типа события стандарт фиксирует основной язык, чтобы категория не зависела от языка сеанса; комментарий может использовать язык пользователя.
Многоязычные `Synonym`, `ToolTip` и заголовки хранят пары код → текст. Семантический пример `Synonym`, сверенный с Designer XML 2.20 УТ:
<Synonym xmlns="http://v8.1c.ru/8.3/MDClasses"
xmlns:v8="http://v8.1c.ru/8.1/data/core">
<v8:item>
<v8:lang>ru</v8:lang>
<v8:content>Валюты</v8:content>
</v8:item>
</Synonym>В контексте этого фрагмента `v8` связан с `http://v8.1c.ru/8.1/data/core`. Другой перевод — отдельный `v8:item`. `Comment` — обычная строка, а не такой набор. `Name` также остаётся идентификатором. НСтр применяется в BSL; её вызов, записанный текстом в `Synonym`, не создаёт переводы. XML здесь иллюстрирует формат; изменяет его публичный `unica.apply`.
Читай цель и её `Can.<операция>` по адресам из `view`/`search`. Формы аргументов различаются:
использует свой `attribute.set` и опубликованное поле `synonym`. Скаляр относится к основному языку набора, не к языку текущего пользователя. Английская строка при основном `ru` не добавляет перевод `en`.
с сохранением других переводов или полной картой переводов. Пустая строка удаляет весь заголовок со всеми переводами. Для удаления только одного перевода передай полную непустую карту с остальными языками и непустыми текстами. Последний перевод удаляется пустой строкой `Title`. Поддержку карты проверяй в `Can` этой формы.
языков. Это отдельный контракт создания: поддержку карты для изменения существующего элемента, других видов элементов или команд проверяй в соответствующем `Can`, не переноси её с корня формы или нового `Label`.
переводов. Если полный набор не наблюдается, получи его из разрешённых исходных данных задачи до замены карты. Не собирай её из единственной подписи.
Например, когда полный набор загол
Unica (Ю́ника) — плагин для Codex, Claude Code и ZCode для разработки на 1С:Предприятии.
Проектирование и ревью API 1С: публичный программный интерфейс, служебный интерфейс, переопределяемые модули, совместимость,…
Автономный сервер отладки 1С. Используй когда нужно развернуть или проанализировать локальный автономный контур для отладки…
Фоновые и регламентные задания 1С. Используй когда нужно спроектировать, проверить или диагностировать background jobs,…
Поиск и применение паттернов БСП. Используй когда задача про длительные операции, профили групп доступа, безопасное хранение,…
Точечное редактирование конфигурации 1С. Используй когда нужно изменить свойства конфигурации, добавить или удалить объект из…
Создать пустую конфигурацию 1С (scaffold XML-исходников). Используй когда нужно начать новую конфигурацию с нуля
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…
Ask which skill or flow fits your situation. A router over the skills in this repo.