Иконки

AIKraft Agents поддерживает иконки для источников, навыков и статусов. Иконками могут быть эмодзи, SVG-файлы или растровые изображения (PNG, JPG).

Лейблы не используют иконки — они отображаются как цветные круги. См. настройку цветов лейблов.

Поддерживаемые форматы

Настройка иконок

Эмодзи

Установите поле icon в config.json вашей сущности на любой эмодзи Unicode:

{
  "icon": "🔧"
}

Поддерживаются многокодовые эмодзи и последовательности ZWJ (например, 👨‍💻, 🇭🇺).

Файлы иконок

Поместите файл иконки в директорию вашей сущности. AIKraft Agents автоматически обнаруживает файлы с именем icon.{svg,png,jpg,jpeg}:

sources/
  linear/
    config.json
    icon.svg        ← авто-обнаруживается

Порядок приоритета при наличии нескольких форматов: SVG > PNG > JPG > JPEG.

Явный путь

Укажите конкретный файл с помощью относительного пути в config.json:

{
  "icon": "./my-custom-icon.svg"
}

URL (только для источников)

Для источников с полем icon, основанным на URL, AIKraft Agents загружает изображение в локальный файл icon.{ext} (максимум 50 КБ). После загрузки локальный файл используется для отображения.

Порядок разрешения

При отображении иконки сущности AIKraft Agents разрешает её в следующем порядке:

1. Эмодзи — если поле icon является строкой эмодзи, отображается как текст
2. Явный путь — если icon является относительным путём (например, ./icon.svg), загружается указанный файл
3. Авто-обнаружение — поиск icon.svg, icon.png, icon.jpg в директории сущности
4. Резервная иконка Favicon (только для источников) — разрешается из URL сервиса (MCP url или API baseUrl)
5. Резервная иконка — отображается универсальная заглушка

Темизация SVG

SVG-файлы, использующие currentColor, автоматически адаптируются к текущей теме:

<svg viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
  <path d="M12 2L2 7l10 5 10-5-10-5z" fill="currentColor"/>
</svg>

Как это работает:

• SVG с currentColor определяются как цветные — они наследуют цвет из родительского контекста (например, иконка статуса принимает цвет статуса)
• SVG без currentColor отображаются с жёстко заданными цветами
• SVG без атрибута fill на корневом элементе <svg> автоматически получают цвет переднего плана темы

Используйте currentColor в своих SVG для иконок, которые должны соответствовать цвету сущности (например, статусы) или адаптироваться к светлой/тёмной теме.

Детали по типам сущностей

Источники

~/.craft-agent/workspaces/{id}/sources/{slug}/
  config.json     ← "icon": "🔧" или "./icon.svg"
  icon.svg        ← авто-обнаруживается

Источники имеют резервную иконку Favicon: если локальная иконка отсутствует, AIKraft Agents разрешает одну из MCP URL или API базового URL.

Навыки

~/.craft-agent/workspaces/{id}/skills/{slug}/
  SKILL.md
  icon.svg        ← авто-обнаруживается

Навыки используют тот же шаблон авто-обнаружения. Разрешённый путь к иконке сохраняется в метаданных навыка как iconPath.

Статусы

~/.craft-agent/workspaces/{id}/statuses/
  config.json     ← определения статусов с необязательным полем "icon"
  {status-id}.svg ← файл иконки с именем статуса

Иконки статусов используют ID статуса в качестве имени файла вместо icon:

statuses/
  config.json
  in-progress.svg   ← обнаруживается для статуса с id "in-progress"
  done.svg          ← обнаруживается для статуса с id "done"

Размеры иконок

Иконки отображаются в стандартных размерах по всему интерфейсу:

Советы

Используйте SVG для лучших результатов

SVG масштабируются идеально при всех размерах и могут адаптироваться к цветам темы через currentColor. Это рекомендуемый формат для пользовательских иконок.

Держите SVG простыми

Удаляйте ненужные метаданные, артефакты редактора и встроенные стили. Чистый viewBox, пути с fill="currentColor" и отсутствие атрибутов width/height работают лучше всего.

Эмодзи для быстрой настройки

Эмодзи не требуют файлов и отображаются нативно. Они идеальны для быстрого старта или когда файловая иконка не нужна.

Иконка не отображается?

• Проверьте, что файл находится в правильной директории для вашего типа сущности
• Убедитесь, что имя файла совпадает (icon.svg для источников/навыков, {id}.svg для статусов)
• Убедитесь, что содержимое SVG является допустимым XML
• Для иконок по URL проверьте, что файл был загружен (ищите icon.{ext} в директории сущности)