Trang này được dịch từ tài liệu tiếng Anh. Lệnh, định danh và ví dụ giữ nguyên. Runtime 7.24.4 · SDK 2.6.7. Bản tiếng Anh

Sổ tay quay lui bản phát hành

Trạng thái: Đang hoạt động Phạm vi: công khai, trạng thái hiện tại Xem xét lần cuối: 2026-09-03 Chủ sở hữu: kỹ thuật phát hành AX Code

Sổ tay này mô tả cách rút một bản phát hành CLI AX Code ổn định (kênh latest) đã công bố và khôi phục bản trước. Các bản phát hành tiền phát hành (kênh beta) không đụng tap Homebrew hay winget, nên quay lui chúng chỉ cần bước bản phát hành GitHub bên dưới.

Hãy ưu tiên vá nóng tiến lên (phát hành vX.Y.Z+1) cho lỗi chức năng. Chỉ quay lui khi thất bại tính toàn vẹn bản phát hành: tạo tác hỏng hoặc ký sai, trình cài bị hỏng, nhầm kênh/thẻ (ví dụ một thẻ tiền phát hành được công bố lên latest), hoặc một hồi quy nặng không có bản sửa nhanh.

1. Đóng băng kênh

Tạm dừng các bản phát hành tiếp và các lần tiếp tục postpublish_only cho đến khi quay lui xong. Quy trình phát hành từ chối thay tài sản trên một bản phát hành đã công bố, nên không lần chạy lại đồng thời nào có thể ghi đè trạng thái đang được quay lui.

2. Trỏ lại bản phát hành GitHub

Đánh dấu bản phát hành xấu là tiền phát hành để latest phân giải về thẻ trước, và khôi phục ghi chú bản phát hành trước nếu chúng bị ghi đè:

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

Nếu tài sản của bản phát hành xấu bị hỏng hoặc ký sai, hãy xóa chúng để không trình cài nào có thể lấy chúng:

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

Đừng xóa chính đối tượng bản phát hành cho đến khi các tạo tác của nó đã được điều tra; tài sản đã ký và nhật ký quy trình là bằng chứng cho buổi rút kinh nghiệm.

3. Hoàn nguyên tap Homebrew

bash .github/scripts/update-homebrew.sh đã đẩy một commit formula tới kho dùng chung defai-digital/homebrew-tap. Hãy hoàn nguyên commit đó để brew upgrade ax-code phục vụ lại phiên bản trước. Kho defai-digital/homebrew-ax-code trước đây chỉ chứa siêu dữ liệu di chuyển; đừng khôi phục formula của nó:

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

Sau đó xác minh hội tụ bằng việc thử Homebrew (.github/workflows/install-matrix-smoke.yml) đối với phiên bản đã khôi phục.

4. Hoàn nguyên bản kê winget

Bản kê winget do người bảo trì gửi tới microsoft/winget-pkgs từ ZIP bản kê đính kèm bản phát hành GitHub. Nếu phiên bản xấu đã được chấp nhận, hãy mở một PR hoàn nguyên các tệp bản kê đó. Nếu nó vẫn đang được xem, hãy đóng PR. Lần tải --clobber trên bản phát hành chỉ thay ZIP đính kèm, không bao giờ thay gói đã công bố.

5. Thông báo

Đăng một ghi chú ngắn trong thảo luận bản phát hành và mọi kênh hỗ trợ: các phiên bản bị ảnh hưởng, phiên bản đã khôi phục, và chỉ dẫn cài lại:

Homebrew: brew update && brew upgrade ax-code (hoặc brew uninstall ax-code && brew install ax-code).
Windows/khác: chạy lại trình cài đã ghim từ trang bản phát hành trước; trình cài đóng khi lỗi nếu chữ ký không khớp và tự khởi tạo một minisign đã ghim, đã kiểm SHA-256.

6. Xác minh trạng thái đã khôi phục

Xác nhận bản phát hành GitHub latest trỏ tới thẻ trước và mọi tài sản xác minh được:

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

Xác nhận formula Homebrew phục vụ phiên bản đã khôi phục và cài sạch trên một runner sạch (quy trình thử ma trận cài làm việc này).
Xác nhận ax-code --version trên một bản cài mới báo phiên bản đã khôi phục và vượt ax-code doctor.

7. Rút kinh nghiệm

Ghi lại cái gì đã qua các cổng phát hành nhưng vẫn được phát hành trong trạng thái hỏng, và nộp các bản sửa đối với .github/workflows/release.yml (xác thực, độ phủ thử) trước bản phát hành kế tiếp. Hãy cập nhật sổ tay này nếu một bước không hoạt động như đã viết.