Ревью и коммит изменений
Changes
Section titled “Changes”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). Пробелы в конце добавленной строки отмечаются красным, а табуляция выравнивается по ширине, которую файлу задаёт.editorconfigworktree. - Заголовки фрагментов называют метод, функцию, тип, заголовок Markdown или ключ YAML, внутри которого находится фрагмент. Их кнопка показывает ещё по 20 строк вокруг каждого фрагмента, а Whole file — весь файл.
- Свёртывание: lock-файлы, сгенерированные файлы и diff длиннее 3 000 строк ждут за кнопкой Load diff. Wrap lines переносит длинные строки вместо горизонтальной прокрутки.
- Навигация: F7 и Shift+F7 (⌥↓ и ⌥↑ в diff) переходят к следующему или предыдущему фрагменту, а после последнего — к следующему файлу. Отметки у правого края показывают, где находятся изменения.
Правый щелчок по номерам строки предлагает Line history…: поверх diff — кто менял строку последним и каждый коммит, который менял её до этого, с учётом переименований, по 20 за раз.
Индексация
Section titled “Индексация”- Индексируйте целый файл из списка или убирайте его из индекса.
- В 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.
Коммит
Section titled “Коммит”В форме коммита есть заголовок (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 (убрать их из индекса). Только это нажатие убирает файлы из индекса — и только эти файлы.
Заметки к ревью
Section titled “Заметки к ревью”В diff на вкладке Changes кнопка + на строке оставляет заметку; в просмотре изображений заметку можно оставить к области изменённого изображения в его собственных пикселях (см. ревью изображений). Заметка следует за своей строкой, когда файл меняется (Moved from line N), или помечается Anchor needs review либо Outdated. В Review notes (N) их можно закрыть, изменить или удалить, а щелчок по заметке открывает её файл на нужной строке.
- Send to chat отправляет открытые заметки worktree в работающий чат одним сообщением — по файлам и строкам, с вырезками областей изображений. Панель следит за пакетом, пока агент его не примет.
- Copy package… копирует открытые заметки в Markdown, а Export… записывает их в папку вместе с JSON-манифестом.
- Каждое из этих действий сначала показывает пакет в том виде, в каком он уйдёт; с любой заметки можно снять отметку, чтобы оставить её на потом.
Заметки сохраняются после выхода из приложения — в зашифрованном виде рядом с настройками, вместе с их изображениями.
История, ветки, конфликты и worktree описаны на странице История и ветки.