Перейти к основному содержимому
Открыть Markdown

Карта продукта и основные понятия

Центральная сущность Just Run — песочница. Остальные сущности задают, как она создается, предоставляют данные и учетные данные, запускают работу внутри нее либо публикуют долговременный сервис на ее основе.

Основная модель​

СущностьЗа что отвечаетСвязь с песочницей
ПесочницаЗапущенное или приостановленное вычислительное окружение, его файловая система, процессы, настройки и опубликованные портыМесто выполнения команд и сервисов
ШаблонВерсионируемая начальная файловая система и значения ресурсов по умолчаниюПесочница создается из одной версии шаблона
ПресетРесурсы запуска и необязательные настройки подготовки для одного шаблонаЗаполняет форму создания. В запросе создания через REST API пресет можно указать в preset_id: он дополнит запрос недостающими настройками подготовки и ресурсами. Без preset_id, как и при создании через MCP управления платформой, пресет шаблона по умолчанию дополняет запрос только настройками подготовки
АвтоматизацияCron- или вебхук-триггер и вызываемое действиеЗапускает команду или HTTP-действие в существующей песочнице
MCP-хостингУправляемое определение MCP-сервера и постоянный эндпоинт для клиентаРаботает в отдельной песочнице mcp-<имя>, которую Just Run создает сам; эта песочница видна в списке песочниц тем, кому виден Hosted MCP
ХранилищеОбъектное хранилище уровня аккаунтаОтделено от файловой системы песочницы; доступ выдается явно
СекретПереиспользуемые учетные данные или конфигурацияУказывается по имени; сервер расшифровывает секрет и подставляет значения при создании песочницы или развертывании Hosted MCP
НавыкИнструкции для ассистента или файлы, устанавливаемые в песочницуНавыки плагина Just Run расширяют Claude Code или Codex на вашем компьютере; навыки песочницы входят в ее состав

Файловая система песочницы и хранилище​

Файлы внутри песочницы принадлежат ей. Остановка и последующий запуск сохраняют файловую систему, а удаление песочницы безвозвратно удаляет и ее файлы.

Хранилище аккаунта — отдельное объектное хранилище. В файловую систему песочницы оно не монтируется. Доступ на чтение или на чтение и запись песочница получает, только если его выбрали при создании песочницы или позже в ее настройках.

Шаблон и пресет​

Шаблон — переиспользуемая стартовая точка машины. Пресет — сохраненный набор значений для создания песочницы. После выбора пресета в блоке Дополнительные настройки формы создания можно изменить:

  • шаблон и его версию, если у шаблона есть версии;
  • ресурсы;
  • все, что входит в блок Интеграции: секреты, переменные окружения, MCP-серверы, навыки и внешний доступ.

Контекст аккаунта​

Ресурсы относятся к активному личному аккаунту или организации. Пользователь может переключать контекст, а API-операции используют контекст из токена или сессии. Список песочниц показывает только песочницы активного аккаунта — даже администратору платформы; песочницы всех аккаунтов он видит в Админке.

В организации личными и общими бывают:

  • песочницы
  • секреты
  • автоматизации
  • Hosted MCP

Новые ресурсы по умолчанию личные: их видят автор и пользователи с ролью Владелец или Администратор. Общие ресурсы видят все участники организации. Список песочниц в организации открывается с фильтром Только мои: чтобы увидеть общие песочницы коллег, выключите его.

Выбор сущности​

  • Используйте песочницу для интерактивной работы, изолированного выполнения команд и сервисов с управляемым жизненным циклом.
  • Используйте автоматизацию, когда в существующей песочнице нужно запускать команду или HTTP-запрос по расписанию или по входящему вебхуку.
  • Используйте MCP-хостинг, когда результатом должен быть постоянный MCP-эндпоинт, а не универсальная песочница.
  • Используйте хранилище для объектов, которые должны переживать жизненный цикл одной песочницы или быть общими для нескольких песочниц.