Настройка значков инструментов

Обзор

Когда агент выполняет команду CLI (например, git status, npm install), приложение сопоставляет имя команды со значком. Соответствие задано в файле:

~/.craft-agent/tool-icons/tool-icons.json

Файлы значков (.png, .ico, .svg, .jpg) хранятся в том же каталоге рядом с JSON-конфигурацией.

Схема

{
  "version": 1,
  "tools": [
    {
      "id": "git",
      "displayName": "Git",
      "icon": "git.ico",
      "commands": ["git"]
    }
  ]
}

Поля

Добавление пользовательского инструмента

1. Поместите файл значка в ~/.craft-agent/tool-icons/ (любой из форматов: .png, .ico, .svg, .jpg)
2. Добавьте запись в tool-icons.json:

{
  "id": "my-tool",
  "displayName": "My Tool",
  "icon": "my-tool.png",
  "commands": ["my-tool", "mt"]
}

3. Перезапустите приложение или начните новый чат, чтобы изменения вступили в силу.

Сопоставление команд

Парсер команд обрабатывает сложные bash-строки:

• Простые команды: git status сопоставляется с git
• Сцепленные команды: git add . && npm publish сопоставляется с первым распознанным инструментом
• Префиксы переменных окружения: NODE_ENV=prod npm test сопоставляется с npm
• Префиксы sudo и time: sudo docker ps сопоставляется с docker
• Префиксы путей: /usr/local/bin/node сопоставляется с node
• Конвейеры: git log | head -10 сопоставляется с git

Первая распознанная команда в строке определяет значок.

Несколько команд для одного инструмента

Инструмент может сопоставляться с несколькими именами команд:

{
  "id": "npm",
  "displayName": "npm",
  "icon": "npm.png",
  "commands": ["npm", "npx"]
}

Встроенные значения по умолчанию

Приложение поставляется примерно с 57 встроенными значками инструментов, покрывающими распространённые CLI-инструменты (git, npm, docker, python, rust, aws и т. д.). Они добавляются при первом запуске и никогда не перезаписываются, поэтому ваши настройки сохраняются при обновлениях.

Рекомендации по файлам значков

• Рекомендуемый размер: 64x64 или 128x128 пикселей
• Форматы: PNG (предпочтительно), ICO, SVG, JPG
• Фон: прозрачный PNG работает лучше всего
• Значки отображаются в интерфейсе размером 20x20px, поэтому делайте их простыми и узнаваемыми