Эта страница переведена с английской документации. Команды, идентификаторы и примеры не изменены. Среда выполнения 7.24.4 · SDK 2.6.7. Английский оригинал

Руководство по откату выпуска

Статус: действует Область: публичная, текущее состояние Последняя проверка: 2026-09-03 Владелец: инженерия выпусков AX Code

Это руководство описывает, как отозвать опубликованный стабильный (канал latest) выпуск CLI AX Code и вернуть предыдущий. Предварительные выпуски (канал beta) не трогают tap Homebrew и winget, поэтому их откат требует только шага выпуска GitHub ниже.

Для функциональных ошибок предпочитайте движение вперёд хотфиксом (выпустить vX.Y.Z+1). Откатывайте только при сбоях целостности выпуска: сломанные или неправильно подписанные артефакты, повреждённый установщик, ошибка канала или метки (например метка предварительного выпуска, опубликованная в latest) или тяжёлая регрессия без быстрого исправления.

1. Заморозить канал

Приостановите дальнейшие выпуски и возобновления postpublish_only, пока откат не завершится. Рабочий процесс выпуска отказывается заменять ресурсы уже опубликованного выпуска, поэтому параллельный повтор не может перезаписать откатываемое состояние.

2. Перенаправить выпуск GitHub

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

gh release edit "vX.Y.Z" --repo defai-digital/ax-code --prerelease
gh release edit "vX.Y.(Z-1)" --repo defai-digital/ax-code --latest

Если ресурсы плохого выпуска повреждены или подписаны неверно, также удалите их, чтобы ни один установщик не мог их получить:

gh release delete-asset "vX.Y.Z" "<asset-name>" --repo defai-digital/ax-code

Не удаляйте сам объект выпуска, пока его артефакты не расследованы. Подписанные ресурсы и журналы рабочего процесса — свидетельства для разбора.

3. Откатить tap Homebrew

bash .github/scripts/update-homebrew.sh отправил коммит формулы в общий репозиторий defai-digital/homebrew-tap. Откатите этот коммит, чтобы brew upgrade ax-code снова отдавал предыдущую версию. Прежний репозиторий defai-digital/homebrew-ax-code содержит только метаданные миграции. Его формулу не восстанавливайте:

git -C homebrew-tap revert --no-edit <formula-commit>

Затем проверьте схождение дымовым заданием Homebrew (.github/workflows/install-matrix-smoke.yml) против восстановленной версии.

4. Откатить манифесты winget

Манифесты winget сопровождающие отправляют в microsoft/winget-pkgs из ZIP манифестов, приложенного к выпуску GitHub. Если плохую версию уже приняли, откройте запрос на изменение, откатывающий эти файлы манифеста. Если он ещё на рецензии, закройте запрос. Загрузка --clobber в выпуске заменяет только приложенный ZIP, а не опубликованный пакет.

5. Сообщить

Опубликуйте короткое замечание в обсуждении выпуска и в любом канале поддержки: затронутые версии, восстановленная версия и инструкции переустановки:

Homebrew: brew update && brew upgrade ax-code (или brew uninstall ax-code && brew install ax-code).
Windows и прочее: снова запустите закреплённый установщик со страницы предыдущего выпуска. Установщик закрывается при сбое при несовпадении подписи и поднимает закреплённый, проверенный по SHA-256 minisign.

6. Проверить восстановленное состояние

Подтвердите, что выпуск GitHub latest указывает на предыдущую метку и каждый ресурс проверяется:

gh release download "vX.Y.(Z-1)" --repo defai-digital/ax-code -p '*.zip' -p '*.minisig'
minisign -V -p docs/release/ax-minisign.pub -m ax-code-darwin-arm64.zip -x ax-code-darwin-arm64.zip.minisig

Подтвердите, что формула Homebrew отдаёт восстановленную версию и чисто устанавливается на чистом исполнителе (это делает дымовой рабочий процесс матрицы установки).
Подтвердите, что ax-code --version на свежей установке сообщает восстановленную версию и проходит ax-code doctor.

7. Разбор

Запишите, что прошло шлюзы выпуска и всё же ушло сломанным, и заведите исправления против .github/workflows/release.yml (валидация, покрытие дымовых проверок) до следующего выпуска. Обновите это руководство, если какой-то шаг сработал не так, как написано.