Управление задачами

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

Структуру задач см. в разделе Обзор Агента.

Доступ к истории задач

Нажмите кнопку «История» на боковой панели Kodik, чтобы открыть панель истории задач. По умолчанию задачи отсортированы от новых к старым.

Перетаскивайте внутреннюю границу панели истории, чтобы уменьшить её ширину вплоть до компактных 144 пикселей. По мере сужения области чата Kodik автоматически уменьшает панель истории до этого предела, сохраняя удобную ширину разговора. История скрывается только тогда, когда обе минимальные ширины уже не помещаются. Нажмите ту же кнопку боковой панели, чтобы снова показать её; когда места станет больше, панель вернётся к предпочитаемой ширине.

Просмотр и фильтрация

Поиск

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

Порядок сортировки

Переключайтесь между Новые сначала (по умолчанию) и Старые сначала. Результаты разбиты на страницы; при прокрутке следующая страница загружается автоматически (100 задач на страницу).

В строках задач также отображается последний статус: выполняется, требуется действие, непрочитано, завершено, ошибка или остановлено. Задача, завершившаяся, пока вы смотрели другой чат, показывает синюю точку непрочитано, пока вы её не откроете (или не отправите ей новое сообщение) — после этого она отображается как обычная завершённая. Восстановленные и импортированные задачи сохраняют завершённый статус в истории ещё до открытия.

Фильтр по рабочему пространству

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

Архивированные сессии

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

Закреплённые сессии

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

Действия с задачами

Для каждой задачи в списке истории доступны следующие действия:

• Открыть — возобновить задачу в чате Kodik. История разговора агента, состояние файлов и модель восстанавливаются с того места, где задача была прервана. В длинных разговорах Kodik также догружает ранние сообщения, если сначала показан только ограниченный хвост истории.
• Закрепить / открепить — оставить задачу в отдельном разделе закреплённых сессий вверху боковой панели или вернуть её в обычную группу по рабочему пространству, времени или статусу.
• Переименовать — изменить название, которое отображается в истории и списках недавних сессий.
• Экспорт — сохранить полный транскрипт API-разговора в виде Markdown-файла. Экспорт включает все сообщения, вызовы инструментов и их результаты из истории задачи.
• Архивировать / разархивировать — скрыть задачу из обычного списка истории или вернуть её из архивного вида. Архивирование сохраняет данные сессии на диске и не планирует их удаление.
• Удалить — удалить задачу и все её данные, включая отметку избранного и сохранённый снимок контрольных точек/проверки изменений. Это действие применяется только к выбранной задаче. Если задача открыта, её вкладка чата удаляется; новый пустой черновик появляется только когда это была последняя открытая вкладка.

Выполняющиеся задачи и окна

Активные задачи продолжают выполняться в agent host, даже если вы отключились от чата, перезагрузили окно или открыли другое окно. При повторном открытии задачи Kodik сначала загружает сохранённый снимок, а затем подключается к новым событиям host, поэтому поток текста, ожидание инструментов, подтверждения и вопросы догоняют текущее состояние.

У каждой задачи своя очередь и статус, а несколько задач могут выполняться одновременно. Если инструменту нужен интерфейс workbench, Kodik направляет такой запрос в подключённое окно; файловые операции, поиск и shell могут продолжаться на стороне host без подключённого окна с учётом обычных настроек подтверждения.

Создание новой задачи

Нажмите Новая задача (или используйте сочетание клавиш), чтобы начать новый разговор. Можно выбрать режим рабочего пространства:

Локальный режим

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

Режим рабочего дерева

Kodik создаёт отдельное рабочее дерево Git для задачи в директории .worktrees/ в корне репозитория. Агент работает в этой изолированной ветке, поэтому его изменения полностью отделены от основного рабочего дерева до тех пор, пока вы не решите их применить.

• Требуется хотя бы один коммит в репозитории (рабочее дерево ответвляется от HEAD).
• Имя ветки генерируется из заголовка задачи с префиксом kodik/ по умолчанию (можно изменить через kodik.git.branchPrefix).
• Продолжить существующий worktree: меню worktree в нижней панели показывает существующие worktree репозитория под пунктом Новый worktree — выберите один, чтобы продолжить работу в нём. Новый чат запускается внутри этого worktree, сохраняя его ветку и незакоммиченные изменения, вместо создания нового. (Очистка по лимиту хранения ниже всё ещё может удалить устаревший worktree, поэтому продолжайте его до того, как он будет удалён.)
• Пока задача активна, в composer отображается бейдж Worktree. Откройте его, чтобы увидеть имя worktree и показать папку в Explorer.
• Действия просмотра изменений, такие как Оставить и Сохранить всё, принимают состояние проверки только внутри worktree задачи; они не применяют патч к основной рабочей копии.
• Чтобы перенести работу в основную ветку, используйте папку или ветку worktree через обычные Git-процессы.
• Worktree сохраняются после завершения задачи, после отмены её изменений и после удаления чата — созданный вами worktree по этим причинам никогда не удаляется автоматически.
• Когда включено Автоудаление worktree (по умолчанию), лимит хранения (по умолчанию: 15) работает как жёсткий предел: создание нового worktree принудительно удаляет наименее недавно активные зарегистрированные worktree сверх лимита, включая любые незакоммиченные или неслитые изменения в них. Активность считается по файлам внутри worktree, а не только по времени создания папки. Worktree, которые использует запущенная или доступная для восстановления задача, не удаляются, в том числе если задача активна в другом окне Kodik; та же очистка выполняется при запуске. Отключите настройку, чтобы управлять worktree вручную.

Управление версиями

До запуска локальной задачи меню управления версиями в нижней панели чата позволяет переключать ветки и обновлять состояние репозитория через рабочую среду. После запуска задачи оно превращается в доступный только для чтения индикатор ветки, привязанный к выбранной папке этой сессии. Индикатор остаётся видимым и обновляется при переключении ветки вне Kodik, даже если чат всё время остаётся открытым. Если рабочей среде не удаётся выполнить действие с репозиторием, Kodik сообщает об ошибке и сохраняет текущее состояние вместо того, чтобы считать неизменившуюся ветку успешным переключением.

Рабочая папка

Селектор рабочей папки в нижней панели чата (слева от меню локально/worktree) задаёт папку, в которой будет работать новая сессия. По умолчанию используется открытая папка рабочей области.

• На кнопке отображается имя рабочей папки. В меню перечислены открытые папки рабочей области, недавно открытые папки (тот же список, что и на экране приветствия) и пункт Выбрать папку…, который открывает системный диалог выбора папки — можно указать любую папку на компьютере, в том числе вне рабочей области.
• Выбранная папка становится рабочей директорией сессии: все инструменты агента (чтение/запись файлов, команды терминала, glob, поиск) работают относительно неё.
• В окне Remote SSH удалённые папки сохраняют свою удалённую идентичность. Файловые операции, команды терминала, процессы проекта и поиск по кодовой базе выполняются на SSH-хосте, а не ищут такой же путь на локальном компьютере.
• Выбор сохраняется вместе с сессией (при возобновлении папка восстанавливается) и сбрасывается к папке по умолчанию после отправки, поэтому разовый выбор не переносится на следующую сессию.
• Вместе с режимом worktree рабочее дерево создаётся из git-репозитория выбранной папки.
• Режим git worktree пока доступен только для локальных рабочих областей. В Remote SSH используйте обычный режим: если запрошен worktree, Kodik оставит чат в выбранной удалённой папке и не перенаправит его в одноимённый локальный путь.
• Если выбранная папка недоступна на момент запуска чата, сессия запускается в папке рабочей области, и об этом выводится уведомление.