2.13.0-beta.20). Tính năng có thể thay đổi trước bản stable tiếp theo.Chuyển sang stable →Tham chiếu CLI
ak update
Xem trước hoặc áp dụng cập nhật dự án và kit toàn cục với backup nhận biết drift.
ak update làm mới tệp dự án thuộc quyền sở hữu của AgentKit hoặc bản cài kit toàn cục, đồng thời giữ nguyên nội dung do người dùng sở hữu.
Cú pháp
ak update [project-dir] [options]
ak update --global [options]Trước khi chạy
- Lần xem trước ngầm định không tương tác thoát với mã
3. Thêm--dry-runđể xem trước tường minh và thoát0, hoặc--yesđể áp dụng. - Lệnh trần trong TTY mở trình hướng dẫn hợp nhất. Mỗi cập nhật CLI, kit toàn cục và kit dự án mặc định là không;
--yeschấp nhận các bước phù hợp. - Lần xem trước từ xa vẫn có thể xác thực, kiểm tra quyền sử dụng, tải nội dung kit và cập nhật cache trước khi tính kế hoạch.
--forcechỉ cho phép thay thế sau snapshot. Tùy chọn này không biến cài đặt toàn cục thành ghi đè vô điều kiện.--json,--quiet,--no-interactivehoặc môi trường không phải TTY chọn hành vi cho script. Trong lần chạy dự án hoặc toàn cục có tương tác, từ chối mọi lời nhắc sẽ thoát0.
Đối số
[project-dir] chọn một dự án. Nếu bỏ qua, chế độ dự án tìm dự án hiện tại trừ khi đặt --global. Lệnh không có alias.
Tùy chọn
| Tùy chọn | Mặc định | Mục đích |
|---|---|---|
--beta | false | Bao gồm hành vi tự cập nhật CLI beta. |
--channel <channel> | stable | Chọn kênh kit. |
--dry-run | false | Xem trước mà không ghi bản cài dự án hoặc toàn cục. |
--force | false | Cho phép thay thế drift sau backup. |
-g, --global | false | Cập nhật bản cài kit toàn cục. |
--kits <names> | Trống | Giới hạn danh sách kit phân tách bằng dấu phẩy. |
--kits-dir <path> | Trống | Đọc kit từ thư mục cục bộ. |
--local | false | Dùng nguồn kit cục bộ. |
--registry-url <url> | Trống | Ghi đè URL registry. |
--remote | true | Dùng registry từ xa. |
--runtime <runtime> | claude-code | Alias của --target; chọn runtime toàn cục, phân tách bằng dấu phẩy, như claude-code, codex, cursor hoặc grok. |
--show-diff | false | Bao gồm diff tệp trong kế hoạch. |
--target <target> | Trống | Chọn runtime cần cập nhật, phân tách bằng dấu phẩy, như claude-code, codex, cursor hoặc grok; chỉ truyền một trong hai cờ --target hoặc --runtime. |
--version <version> | Trống | Ghim phiên bản kit. |
Ví dụ
Xem trước cập nhật dự án với trạng thái xem trước thành công:
ak update . --dry-run --show-diffÁp dụng cập nhật dự án mà không hỏi:
ak update . --yesXem trước cập nhật toàn cục:
ak update --global --dry-run --kits core --runtime claude-code
ak update --global --dry-run --kits core --local --kits-dir ./kits --target grokĐầu ra và luồng
Với --json, stdout dùng envelope chung có "kind": "update". data của dự án gồm project_dir, files_updated, files_skipped, files_new và dry_run; nó cũng có thể gồm các trường snapshot, skipped, diffs, project_config, project_config_created và scope.
Đầu ra toàn cục còn có locations, kits và skipped_targets. Mỗi kết quả kit có thể báo cáo kit, runtime, status, channel, reason, error, why, next, các trường snapshot, locations và warnings. Runtime đã chọn nhưng chưa cài global được báo là bỏ qua thay vì được tạo mới. Lần xem trước JSON ngầm định in envelope thành công ra stdout rồi thoát 3. Lỗi lệnh có cấu trúc đi tới stderr; lỗi phân tích vẫn là văn bản thuần.
Trạng thái thoát
| Mã | Ý nghĩa |
|---|---|
0 | Đã áp dụng cập nhật, hoàn tất dry-run tường minh hoặc từ chối lời nhắc tương tác. |
1 | Runtime, vòng đời, nguồn, snapshot, ghi hoặc cập nhật toàn cục một phần thất bại. |
2 | Cờ, phạm vi, mục tiêu hoặc lựa chọn bản cài toàn cục đủ điều kiện không hợp lệ. |
3 | Lần xem trước ngầm định không tương tác cần --yes để áp dụng. |
Tác động, an toàn và khôi phục
Cập nhật dự án phân loại tệp thuộc quyền sở hữu. Tệp sạch có thể được thay thế; tệp đã sửa hoặc vị trí mới bị chiếm được bỏ qua trừ khi dùng --force. Chế độ áp dụng tạo snapshot dự án bắt buộc trước khi ghi cập nhật. Một số tệp ngoài phạm vi khôi phục cần được phục hồi thủ công; làm theo snapshot_data_dir khi được báo cáo. Cấu hình dự án còn thiếu có thể được tạo trước bước phân loại và snapshot, ngay cả khi bước sau thất bại.
Các tệp được ghi tuần tự nên lỗi có thể để lại cập nhật một phần. Cập nhật toàn cục tiếp tục qua các kit, báo cáo lỗi theo kit và có thể tạo gói hỗ trợ trong ~/.agentkit/support. Chế độ force toàn cục có thể lưu trữ kỹ năng Codex cũ được cho phép, nhưng vẫn giữ nguyên sửa đổi của người dùng.
Lệnh liên quan và giới hạn
Dùng ak new cho dự án mới, ak uninstall để xóa tệp thuộc quyền sở hữu và ak doctor sau lỗi một phần. Xem quy ước CLI về cờ dùng chung.