Перейти к содержимому

Ревью и коммит изменений

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

  • Фильтруйте по поиску, статусу (added, modified, deleted, renamed, untracked, conflicted), изображениям и All / Unstaged / Staged; счётчики учитывают остальные фильтры.
  • Stage, Unstage и Discard появляются на строке файла, папки или группы при наведении или фокусе с клавиатуры и действуют на показанные файлы.
  • Контекстное меню неотслеживаемого файла или папки добавляет его в корневой .gitignore — одной строкой в рабочем файле, чтобы вы её проверили.
  • .ffignore в корне worktree, в синтаксисе .gitignore, перечисляет отслеживаемые файлы, изменения в которых ожидаемы, — например, те, что переписывает white-label-сборка. Их непроиндексированные изменения не попадают в список, пока не включить Show .ffignore files в меню фильтра статусов.

Если выбрать файл, откроется его diff с правильными версиями «до» и «после» для индекса, рабочей копии и коммитов, включая переименования.

  • Подсветка синтаксиса для 35 языков — язык определяется по имени файла, расширению или строке #!. Каждая сторона раскрашивается по всему своему файлу, если Git может его прочитать, поэтому фрагмент внутри комментария или строкового литерала читается правильно.
  • Изменённые слова: удалённые строки сопоставляются со следующими за ними добавленными, а слова, изменившиеся в каждой паре, выделяются более насыщенным цветом.
  • Side by side в заголовке diff ставит удалённые и добавленные строки друг напротив друга. Пока панель diff уже 800 px, diff остаётся единым (unified).
  • Пробелы: кнопка пробелов скрывает изменения, состоящие только из пробельных символов (git diff -w). Пробелы в конце добавленной строки отмечаются красным, а табуляция выравнивается по ширине, которую файлу задаёт .editorconfig worktree.
  • Заголовки фрагментов называют метод, функцию, тип, заголовок Markdown или ключ YAML, внутри которого находится фрагмент. Их кнопка показывает ещё по 20 строк вокруг каждого фрагмента, а Whole file — весь файл.
  • Свёртывание: lock-файлы, сгенерированные файлы и diff длиннее 3 000 строк ждут за кнопкой Load diff. Wrap lines переносит длинные строки вместо горизонтальной прокрутки.
  • Навигация: F7 и Shift+F7 (⌥↓ и ⌥↑ в diff) переходят к следующему или предыдущему фрагменту, а после последнего — к следующему файлу. Отметки у правого края показывают, где находятся изменения.

Правый щелчок по номерам строки предлагает Line history…: поверх diff — кто менял строку последним и каждый коммит, который менял её до этого, с учётом переименований, по 20 за раз.

  • Индексируйте целый файл из списка или убирайте его из индекса.
  • В diff изменённого файла Stage hunk (или Unstage hunk) в заголовке фрагмента индексирует этот фрагмент. Щелчок по номерам изменённой строки выбирает её для Stage lines на панели над diff.
  • В непроиндексированном diff Discard hunk и Discard lines возвращают эти строки к проиндексированной версии — после подтверждения и с предварительной резервной копией.
  • Каждое из этих действий сначала заново проверяет diff и ничего не меняет, если файл успел измениться.
  • Когда вы индексируете, убираете из индекса или отменяете изменения (discard) в просматриваемом файле, ffgit переходит к следующему файлу.

Индексация и её отмена проходят через очередь изменений (change queue): файлы перемещаются сразу и остаются полупрозрачными, пока Git их не обработает, так что можно индексировать файл за файлом без ожидания. Записи выполняются по одной, по порядку. Если index.lock занят, ffgit несколько секунд повторяет попытку — и никогда не удаляет этот файл, — а при ошибке файлы возвращаются на место. Меню Change queue на панели инструментов списка файлов показывает каждую запись с действиями Cancel, Retry и Dismiss.

В форме коммита есть заголовок (summary), необязательное описание и число проиндексированных файлов. Amend нужно выбрать явно. Если коммит не удался, черновик сохраняется — как и всё, что вы наберёте после. Хуки и подпись выполняются ровно так, как настроено в Git. Панель коммита сворачивается в одну строку под списком файлов кнопкой на панели вкладок; эта кнопка, щелчок по строке или ⌘Enter снова её показывают.

Кнопка рядом с заголовком просит вашего агента написать всё сообщение, заголовок и описание, по проиндексированным изменениям. Claude Code или Codex выбирается в меню рядом с кнопкой или в настройках Coding agents. Агент запускается один раз и только на чтение (режим Plan, песочница только для чтения, сессия не сохраняется) с промптом ffgit, который этот диалог настроек показывает и позволяет изменить. Ответ лишь заполняет поля; повторное нажатие останавливает агента, а при первом использовании в проекте ffgit спрашивает разрешение. В написанном агентом сообщении нет строк Claude Code Co-Authored-By и Generated with Claude Code, если не включена настройка Agent’s co-author line in commits.

Перед коммитом ffgit помечает проиндексированные файлы, на которые стоит взглянуть:

  • файл больше лимита размера (по умолчанию 50 МиБ, задаётся в Cleanup › Suggestions);
  • результаты сборки — по правилам Build output in Git;
  • вероятный секрет, найденный по имени (.env, *.pem, *.p8, *.p12, id_ed25519, *private-key*…), — содержимое ffgit не читает;
  • файл, указанный в .ffignore.

Commit и Amend один раз перечисляют такие файлы с причиной и предлагают Commit anyway (всё равно закоммитить) или Unstage them (убрать их из индекса). Только это нажатие убирает файлы из индекса — и только эти файлы.

В diff на вкладке Changes кнопка + на строке оставляет заметку; в просмотре изображений заметку можно оставить к области изменённого изображения в его собственных пикселях (см. ревью изображений). Заметка следует за своей строкой, когда файл меняется (Moved from line N), или помечается Anchor needs review либо Outdated. В Review notes (N) их можно закрыть, изменить или удалить, а щелчок по заметке открывает её файл на нужной строке.

  • Send to chat отправляет открытые заметки worktree в работающий чат одним сообщением — по файлам и строкам, с вырезками областей изображений. Панель следит за пакетом, пока агент его не примет.
  • Copy package… копирует открытые заметки в Markdown, а Export… записывает их в папку вместе с JSON-манифестом.
  • Каждое из этих действий сначала показывает пакет в том виде, в каком он уйдёт; с любой заметки можно снять отметку, чтобы оставить её на потом.

Заметки сохраняются после выхода из приложения — в зашифрованном виде рядом с настройками, вместе с их изображениями.

История, ветки, конфликты и worktree описаны на странице История и ветки.