Workspace — рабочие области — документация AIKraft Agents

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

Понимание рабочих пространств

Рабочее пространство — это автономная конфигурационная единица, хранящаяся по пути:

terminalbash

~/.craft-agent/workspaces/{workspace-id}/

Каждое рабочее пространство содержит:

Компонент	Описание
Источники	MCP-серверы, API и локальные файловые системы, подключённые к этому рабочему пространству
Скиллы	Многократно используемые инструкции, вызываемые с помощью `@mention`
Статусы	Состояния рабочего процесса для организации сессий
Сессии	История чатов, специфичная для этого рабочего пространства

Добавление рабочего пространства

Во время начальной настройки вы автоматически создаёте своё первое рабочее пространство. Чтобы добавить ещё:

Нажмите на выпадающий список рабочих пространств в боковой панели (отображает имя вашего текущего рабочего пространства)
Выберите Добавить рабочее пространство...
Введите имя для нового рабочего пространства
Рабочее пространство создаётся с настройками по умолчанию

Переключение между рабочими пространствами

Чтобы переключаться между рабочими пространствами:

Нажмите на выпадающий список рабочих пространств в боковой панели
Выберите рабочее пространство, на которое хотите переключиться

Боковая панель отображает имя вашего текущего рабочего пространства. Переключение рабочих пространств загружает источники, скиллы, статусы и сессии этого рабочего пространства.

Конфигурация, специфичная для рабочего пространства

Каждое рабочее пространство поддерживает собственные:

Данные	Описание
Источники	MCP-серверы, API и локальные файловые системы
Скиллы	Многократно используемые инструкции, определённые в `skills/`
Статусы	Состояния рабочего процесса, определённые в `statuses/config.json`
Сессии	История чатов, хранящаяся в `sessions/`
Разрешения	Необязательные правила режима Изучения в `permissions.json`
Тема	Необязательный переопределение цветовой темы (настраивается в Настройки → Внешний вид)
LLM-подключение по умолчанию	Необязательное LLM-подключение по умолчанию для новых сессий

Структура каталогов

terminalbash

~/.craft-agent/
  workspaces/
    {workspace-id}/
      config.json           # Конфигурация рабочего пространства
      .claude-plugin/       # Манифест плагина (совместимость с Claude Code SDK)
        plugin.json         # Манифест плагина со скиллами и агентами
      sources/
        {source-slug}/
          config.json       # Конфигурация источника
          guide.md          # Документация по использованию
      skills/
        {skill-slug}/
          SKILL.md          # Определение скилла
      statuses/
        config.json         # Определения статусов
        icons/              # Пользовательские иконки статусов
          todo.svg
          done.svg
      sessions/
        {session-id}/
          session.jsonl     # Диалог в формате JSONL
          attachments/      # Загруженные файлы
          plans/            # Планы реализации
      projects/
        {project-slug}/     # Необязательные проекты, ограниченные рабочим пространством
          config.json       # Конфигурация проекта
          MEMORY.md         # Долгоживущая память проекта
          assets/           # Файлы, отображаемые через манифест ресурсов
      permissions.json      # Необязательные правила режима Изучения
      icon.png              # Необязательная иконка рабочего пространства (png/jpg/svg)

Настройки по умолчанию для рабочих пространств

Рабочие пространства могут переопределять настройки приложения по умолчанию для LLM-подключения и темы:

terminaljson

{
  "defaults": {
    "defaultLlmConnection": "claude-max",
    "colorTheme": "nord"
  }
}

Порядок разрешения для подключений:

Подключение сессии
Рабочее пространство по умолчанию (defaults.defaultLlmConnection)
Глобальное по умолчанию (defaultLlmConnection в config.json)
Первое подключение в списке

Несколько окон

Вы можете открыть несколько окон одновременно — обычно по одному на каждое рабочее пространство — чтобы держать разные контексты рядом без постоянного переключения.

Заголовки окон

Строка заголовка адаптируется к количеству открытых окон:

Открытые окна	Заголовок, отображаемый на каждом окне
1	`AIKraft Agents` (название приложения)
2 и более	Имя рабочего пространства, которое просматривает это окно

Это упрощает выбор нужного окна из Cmd-Tab, Mission Control или панели задач Windows при нескольких открытых окнах. Заголовки обновляются автоматически при открытии или закрытии окна или переключении окна на другое рабочее пространство.

Если окно ещё не связано с рабочим пространством (например, окно онбординга), оно сохраняет заголовок AIKraft Agents.

Автообновления сохраняют макет окон

При принятии автообновления AIKraft Agents теперь сохраняет макет открытых окон перед тем, как установщик закрывает приложение. При перезапуске каждое окно — и рабочее пространство, которое оно просматривало — восстанавливается точно так же, как было. Больше вы не теряете многократную настройку окон после обновления.

Удалённые рабочие пространства

Вы можете подключиться к рабочим пространствам, запущенным на удалённом сервере. Удалённые рабочие пространства отображаются в переключателе рабочих пространств наряду с локальными.

Подключение к удалённому серверу

Нажмите на выпадающий список рабочих пространств в боковой панели
Выберите Добавить рабочее пространство... → Подключиться к удалённому серверу
Введите URL сервера (например, wss://192.168.1.100:9100) и токен сервера
Нажмите Проверить подключение — зелёная галочка подтверждает подключение
Выберите существующее рабочее пространство из выпадающего списка или создайте новое

Несколько удалённых рабочих пространств

Один удалённый сервер может размещать несколько рабочих пространств. При подключении вы можете выбрать, какое рабочее пространство добавить в переключатель. Вы также можете подключиться к нескольким серверам — каждое удалённое рабочее пространство независимо.

Состояние подключения

Удалённые рабочие пространства отображают статус подключения в переключателе:

Индикатор	Значение
Обычная иконка	Подключено и работает нормально
Иконка CloudOff	Недоступно — сервер отключён или проблема с сетью

Приложение проверяет состояние удалённых рабочих пространств при открытии переключателя рабочих пространств.

Управление удалёнными рабочими пространствами

Удалить: Щёлкните правой кнопкой мыши по рабочему пространству в переключателе и выберите Удалить, или наведите курсор и нажмите иконку корзины. Это отключает локальную ссылку — оно не удаляет рабочее пространство на сервере.
Переключить: Нажмите на любое рабочее пространство (локальное или удалённое), чтобы переключиться на него. Список сессий, источники и скиллы загружаются из этого рабочего пространства.

Перенос сессий

Вы можете перенести сессию из одного рабочего пространства в другое с помощью Отправить в рабочее пространство:

Откройте меню сессии (щёлкните правой кнопкой мыши или меню заголовка)
Выберите Отправить в рабочее пространство
Выберите удалённое рабочее пространство из списка
Сессия копируется в целевое рабочее пространство вместе с кратким описанием диалога для контекста

Это создаёт независимую копию — изменения в одном рабочем пространстве не синхронизируются с другим.

Перенос сессий в настоящее время доступен только из локальных удалённым рабочим пространствам. Целевое рабочее пространство должно быть доступно в момент переноса.

Примеры использования

Личное и рабочее разделение

Держите личные проекты отделёнными от работы. Каждое рабочее пространство имеет собственные источники, скиллы и историю сессий — без смешения контекстов.

Проекты клиентов

Консультанты и фрилансеры могут настроить отдельные рабочие пространства для каждого клиента с выделенными источниками и специальными скиллами для каждого проекта.

Окружения разработки

Поддерживайте отдельные рабочие пространства для разработки, тестирования и производства — каждое с соответствующими конечными точками API и разрешениями.

Сотрудничество в команде

Поделитесь конфигурациями рабочих пространств с членами команды, скопировав структуру каталогов рабочего пространства.

Советы

Называйте рабочие пространства понятно

Используйте описательные имена, которые позволяют легко идентифицировать контекст на первый взгляд.

Начните с одного рабочего пространства

Освойте основы, прежде чем добавлять несколько рабочих пространств. Вы всегда можете добавить больше позже.

Настройте режим Изучения

Добавьте файл permissions.json, чтобы разрешить дополнительные операции в режиме Изучения. Подробности см. в разделе Разрешения.