Первые шаги¶

Эта страница помогает пройти первый рабочий сценарий в Koda Desktop: выбрать проект, отправить запрос и понять, что происходит во время ответа.

Перед началом¶

Для начала требуется учётная запись.

Привязка устройства происходит так же, как в других продуктах Koda: открывается страница авторизации, если вы ещё не вошли в свой аккаунт, и после входа устройство будет привязано автоматически. Тогда станет доступен основной интерфейс программы.

Для первого знакомства лучше включить Только чтение. Так можно попросить объяснить проект, найти риски или предложить план без изменений файлов.

Откройте проект¶

Есть три быстрых варианта:

• нажмите Открыть проект в боковой панели и выберите папку;
• выберите ранее выбранный проект под основным полем ввода для нового чата, либо одну из существующих сессий в боковой панели (при наличии);
• выберите Временная папка в меню проекта под полем ввода, чтобы создать временное рабочее пространство без привязки к папке на диске.

Отправьте первое сообщение¶

1. Если задаче нужен файл, нажмите или перетащите файл в поле запроса.
2. Введите задачу в поле запроса.
3. Нажмите Enter, чтобы отправить сообщение.
4. Нажмите Shift + Enter, если нужно добавить новую строку.
5. Во время выполнения используйте Стоп, чтобы остановить текущий ответ.

На пустом экране также есть готовые карточки-примеры:

• Объясни проект — попросит описать структуру и точки входа.
• Найди проблемы — запустит read-only анализ без правок.
• Напиши тесты — попросит найти непокрытые модули и добавить тесты.

Хороший первый запрос:

Объясни, как устроен этот проект: где точки входа, какие основные модули и с чего лучше начать изучение. Файлы пока не меняй.

Если вы приложили скриншот или документ:

Посмотри приложенные материалы и сначала составь список вопросов и рисков. Код пока не меняй.

Что видно во время ответа¶

Koda Desktop показывает не только финальный текст:

• сообщения пользователя и агента;
• ленту действий агента — вызовы инструментов и размышления;
• diff для предлагаемых изменений;
• приложенные файлы рядом с вашим сообщением;
• источники, если агент вернул ссылки на материалы;
• состояние текущего ответа и причину остановки, если она произошла.

Длинное сообщение пользователя показывается свёрнутым: видны первые строки, остальное раскрывается кнопкой Показать ещё и снова сворачивается кнопкой Свернуть. Изображения в отправленном сообщении видны целиком, без открытия файла.

Лента действий¶

v1.2.6

Вызовы инструментов и размышления агент показывает не по одному: подряд идущие шаги он собирает в одну строку.

Пока ход идёт, строка говорит, что агент делает прямо сейчас, — «Читаю», «Выполняю команду», «Ищу в интернете»; рядом крутится индикатор, а справа видно время хода и число действий. Когда ход завершён, строка превращается в сводку: «Создал 1 файл, изменил 2 файла, выполнил 2 команды». Созданные файлы сводка считает отдельно от изменённых.

Клик по строке раскрывает список шагов, а клик по шагу — его содержимое: вывод команды, diff правки, источники или текст размышления. У правки файла в списке видно число добавленных и удалённых строк — например, +12 −3. У чтения видно диапазон строк, а если файл прочитан целиком — пометка весь файл.

Пока модель формирует содержимое файла или параметры другого инструмента, карточка показывает подготовку: «Готовлю изменения файла» или «Готовлю вызов инструмента». Как только получен путь, в заголовке появляется имя файла, а полный путь виден при наведении. Раскройте шаг, чтобы увидеть поступающий текст; у длинного содержимого показывается его конец. Подготовленная карточка ещё не значит, что файл изменён: после подготовки она показывает подтверждение, выполнение и результат. Если параметры готовы, а вызов ждёт предыдущих, карточка говорит «В очереди».

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

В ленте встречаются два разных ожидания:

• Размышляю — модель обдумывает запрос, и рядом видно живое превью: последние строки потока размышлений;
• Думаю — агент отправил запрос модели и ждёт первого ответа.

Короткое размышление остаётся на виду и после ответа, длинное сворачивается и разворачивается по клику. Если команда выполняется долго, в её строке видно, сколько времени ей отведено, а после остановки — что она прервана вами, а не упала.

Если агент запросит разрешение на действие, над полем ввода появится панель подтверждения или отклонения запроса.

После первого ответа¶

Обычно следующий шаг зависит от результата:

• если это анализ, попросите короткий план действий;
• если это правка, попросите показать итог и риски;
• если менялись файлы, попросите запустить или подсказать проверку;
• если всё готово, попросите подготовить сообщение коммита.

Контекст новой задачи настраивается рядом с композером: проект, ветка, режим подтверждений, модель, режим агента и Только чтение.