12. Словарь
Эти термины имеют одинаковый смысл в архитектурных представлениях и принятых решениях. Словарь объясняет предметные различия; обязанности компонентов остаются в создаваемом из модели справочнике раздела 5, а точные поля и пределы — в ADR.
12.1 Участники и полномочия
Заголовок раздела «12.1 Участники и полномочия»Контракты ролей и личности определяют ADR-0005, ADR-0009, ADR-0010, ADR-0011 и ADR-0014.
| Термин | Значение |
|---|---|
| Владелец CLI | Сторона, собирающая приложение с собственным именем и устанавливающая доверенный код и полномочия настройки |
| Издатель расширения | Сторона, распространяющая объявления и точные файлы расширения; личность издателя и доверие к коду требуют одобренных владельцем оснований |
| Оператор CLI | Человек, использующий или обслуживающий установку в рамках переданных прав; не становится автоматически владельцем или подтверждённым субъектом организации |
| Субъект | Сторона, чьи права применяются, с указанием подтверждающей её системы; явный локальный контекст не создаёт подтверждённого субъекта |
| Вызывающая сторона | Отдельно установленный человек или приложение, обращающееся от имени субъекта; заявленное имя клиента не является такой привязкой |
| Учётные данные службы | Данные, с которыми доверенный адаптер выполняет связанную операцию службы; не становятся автоматически личностью или правом вызывающего |
| Область доступа | Пространство полномочий и правил, закреплённое владельцем; не адрес службы, выбранный расширением |
| Сеанс аутентификации | Подтверждённый контекст личности под управлением ядра; его срок отделён от обновления токенов и пригодности прав |
| Security Broker | Граница интеграции личности, прав и допустимого поиска; не требует удалённого сервера |
12.2 Пакеты, команды и настройки
Заголовок раздела «12.2 Пакеты, команды и настройки»Контракты публикации, путей команд и настройки определяют ADR-0006, ADR-0007, ADR-0009 и ADR-0013.
| Термин | Значение |
|---|---|
| Расширение | Независимо публикуемый пакет с объявленными командами и требованиями исполнения |
| Описание расширения | Статические проверенные данные издателя об расширении; экспортируются из KCL без исполняемой настройки |
| Выпуск | Точный состав оболочки выпуска, описания и файлов, связанный идентичностью пакета, версией и проверенными хешами; изменяемая метка не является точной привязкой выпуска |
| Каталог | Допущенные владельцем идентичности кандидатов, ссылки на выпуски и источники; не хранилище файлов и не право на любой ресурс |
| Доверие к файлам | Одобрение связи издателя, пакета и содержимого; одной целостности по контрольной сумме недостаточно |
| Каноническая идентичность команды | Издатель, пакет и устойчивый ID команды, общие для путей, альтернативных имён и интерфейсов |
| Путь / размещение команды | Видимая последовательность имён и её место в дереве собственного CLI; написание отделено от канонической идентичности |
| Группа / подкоманда | Группа упорядочивает пути без обработчика; исполняемая подкоманда объявляется отдельно и имеет собственный ID |
| Альтернативное имя | Другой прямой путь к той же команде с теми же входными данными, требованиями и правами |
| Установка / активация | Установка фиксирует полные проверенные файлы; активация публикует проверенную конфигурацию и набор команд |
| Поколение команд | Неизменяемый полный набор привязок встроенных команд и расширений, целевых платформ и путей |
| Активный профиль | Опубликованная связь одной ревизии настроек владельца и одного поколения команд; не постоянное разрешение |
| Настройки как код | Проверяемые версионируемые данные; их полномочия определяет одобренный издатель, а не сам репозиторий или язык записи |
| Представление команд | CLI или MCP на основе одной активной модели команд, а не другая реализация |
| Пригодность для MCP / предоставление | Пригодность объявляет совместимость с программным вызовом; предоставление — отдельный выбор владельца открыть команду через MCP |
| Привязка инструмента | Точная связь имени программного инструмента с командой и ревизией профиля; старое имя не перенаправляется на новый выпуск |
12.3 Исполнение и окружение
Заголовок раздела «12.3 Исполнение и окружение»Эти значения следуют из ADR-0001, ADR-0002, ADR-0004, ADR-0008 и ADR-0015.
| Термин | Значение |
|---|---|
| Вызов | Один неизменяемый запрос команды или контекстной справки с закреплённой идентичностью, вводом и контекстом; попытка исполнения имеет один окончательный исход |
| Исполнитель | Механизм запуска и контроля экземпляра исполнения; отличается от окружения, необходимого его коду |
| Среда языка / окружение | Точный выбранный интерпретатор или движок и проверенные зависимости; не жизненный цикл и не представление поведения arc42 |
| Поставщик среды | Доверенная интеграция, подбирающая и подготавливающая окружение в рамках собственных полномочий |
| Синхронное исполнение | Работа, жизненным циклом которой до завершения владеет запросившая область; долго работающее приложение MCP не превращает её в отдельное фоновое задание |
| Профиль исполнения | Явное доверенное исполнение либо проверенный набор ограничений ресурсов и процессов; отличается от активного профиля настроек |
Доверенное исполнение (host-trusted) | Допущенный код работает с полномочиями своей учётной записи ОС; проверки ядра не изолируют прямые системные вызовы |
| Окончательный исход / результат команды | Зафиксированный ядром исход исполнения и необязательные или обязательные типизированные данные команды — разные записи; правильные данные ещё не означают окончательного успеха |
12.4 Защищаемые операции и внешние действия
Заголовок раздела «12.4 Защищаемые операции и внешние действия»Эти термины следуют из ADR-0005, ADR-0012, ADR-0014 и ADR-0016.
| Термин | Значение |
|---|---|
| Операция ядра / действие доступа | Операция предоставляет зарегистрированное средство; действие выражает требуемые полномочия над действительным ресурсом |
| Допуск | Окончательная проверка ядра перед защищаемой работой; прежний поиск или предварительный запрос прав её не заменяет |
| Полномочия задачи | Доверенные ограниченные права задачи; не область процесса, запрос к модели, описание цели или произвольный аргумент инструмента |
| Делегирование | Разрешённое сужение области для установленной дочерней стороны с сохранением корневых ограничений и ограничений предков |
| Резерв | Атомарное удержание конечного допустимого расхода до работы; неопределённые действия сохраняют неучтённый остаток |
| Управляемое внешнее действие | Конкретное действие по контракту привязки и фиксации допущенной операции; не любое прямое побочное действие обычного процесса |
| Идентификатор действия | Выданная ядром идентичность одного намеченного действия, отдельная от ID транспортного запроса и вызова |
| Неопределённость действия | Нет достоверных сведений о том, произошло ли допущенное действие и сколько ресурсов потратило; нельзя предполагать ни отказ, ни откат |
| Сверка результата | Разрешённое определение состояния записанного действия по поддерживаемым сведениям; не повторяет и не открывает заново исходный вызов |