ak uninstall

Xem trước hoặc xóa tệp dự án thuộc quyền sở hữu của AgentKit và giữ nguyên orphan.

ak uninstall xóa các tệp được manifest dự án AgentKit theo dõi. Lệnh không xóa nội dung dự án không thuộc quyền sở hữu.

Cú pháp

ak uninstall [path] [options]

Trước khi chạy

--dry-run luôn xem trước và thoát 3, ngay cả khi có --yes.
Trong TTY, chế độ áp dụng yêu cầu xác nhận trừ khi đặt --yes. Từ chối hoặc hết đầu vào sẽ thoát 3.
Chế độ JSON, quiet và không tương tác không hiển thị lời nhắc. Nếu thiếu --yes, lệnh từ chối thay đổi và thoát 3.
--force cho phép xóa tệp thuộc quyền sở hữu đã sửa nhưng vẫn cần xác nhận. Tùy chọn này không bao giờ xóa tệp orphan.
Dự án có gốc là thư mục home của bạn chứa cấu hình cấp người dùng, chẳng hạn ~/.claude/skills do ak init ở cấp home tiếp nhận. Nếu thiếu --force, lệnh liệt kê các tệp sẽ xóa rồi thoát 6, kể cả khi có --dry-run. Hãy xem lại danh sách đó trước khi chạy lại với --force, hoặc dùng ak kit uninstall <kit> --global để gỡ một Kit cấp người dùng.

Đối số

[path] chọn thư mục dự án và được ưu tiên hơn --project-dir. Nếu không có cả hai, lệnh tìm từ thư mục hiện tại lên các thư mục cha. Lệnh không có alias.

Tùy chọn

Tùy chọn	Mặc định	Mục đích
`--dry-run`	`false`	Xem trước các thao tác tệp đã phân loại.
`--force`	`false`	Cho phép xóa tệp thuộc quyền sở hữu đã sửa và gỡ dự án có gốc là thư mục home.
`--keep-registry`	`false`	Giữ mục dự án trong registry toàn cục.
`--project-dir <path>`	Trống	Chọn thư mục dự án.

Ví dụ

Xem trước việc xóa:

ak uninstall . --dry-run

Xóa tệp sạch thuộc quyền sở hữu mà không hỏi:

ak uninstall . --yes

Xóa tệp thuộc quyền sở hữu đã sửa sau snapshot:

ak uninstall . --force --yes

Đầu ra dễ đọc liệt kê tệp sạch, đã sửa, orphan và bị thiếu. Với --json, stdout dùng envelope chung có "kind": "uninstall". Đối tượng data chứa project_dir, dry_run, files, deleted, skipped và orphans, cùng snapshot_id khi được tạo. Lần xóa đã áp dụng còn báo files_snapshot_id và files_restore_command cho snapshot các tệp dự án đã xóa.

Các phần tử trong files hiện dùng chính xác các khóa RelPath, Class, WillDelete, Deleted và Skipped. Class là số: 0 sạch, 1 đã sửa, 2 orphan và 3 bị thiếu. Lỗi đi tới stderr. Khi từ chối vì tệp đã sửa hoặc vì dự án nằm ở thư mục home, stderr có thể chứa bản tóm tắt dễ đọc trước lỗi JSON có cấu trúc, trừ khi dùng chế độ quiet.

Trạng thái thoát

Mã	Ý nghĩa
`0`	Xóa đã xác nhận hoàn tất.
`1`	Tìm dự án, snapshot, hệ thống tệp hoặc xóa một phần thất bại.
`2`	Cờ hoặc đối số đường dẫn không hợp lệ.
`3`	Dry-run hoàn tất, xác nhận bị từ chối hoặc lần áp dụng không tương tác thiếu `--yes`.
`6`	Tệp thuộc quyền sở hữu đã sửa, hoặc dự án có gốc là thư mục home của bạn, cần `--force`.

Tác động, an toàn và khôi phục

Lệnh phân loại tệp hai lần trước khi xóa. Tệp sạch thuộc quyền sở hữu được xóa; tệp đã sửa cần --force; tệp bị thiếu được bỏ qua; tệp orphan được giữ nguyên. Với dự án có gốc là thư mục home, lệnh bỏ qua bước quét orphan thay vì duyệt cả cây home, nên không báo orphan nào. Lệnh xóa manifest quyền sở hữu và lock, sau đó chỉ xóa .agentkit khi thư mục rỗng. Các tệp khác trong thư mục đó vẫn còn.

Chế độ áp dụng tạo snapshot AgentKit giới hạn trước khi gỡ, rồi tạo snapshot thứ hai cho đúng các tệp dự án sẽ xóa cùng manifest quyền sở hữu, sau đó mới xóa tuần tự. Nếu snapshot thứ hai thất bại, không tệp nào bị xóa. Đầu ra dễ đọc in ID snapshot đó cùng lệnh khôi phục ak backups restore <id> --allow-root <project>. Lỗi trong lúc xóa có thể để lại trạng thái xóa một phần; khi đó thông báo lỗi kèm cùng lệnh khôi phục. Kiểm tra hệ thống tệp trước khi thử lại. Việc xóa registry dự án là best effort và có thể tắt bằng --keep-registry. Lệnh không dùng mạng, xác thực, quyền sử dụng, cache hoặc tiến trình con.

Lệnh liên quan và giới hạn

Dùng ak init để tạo lại metadata dự án và ak doctor để kiểm tra trạng thái khôi phục. Các snapshot chỉ bao gồm trạng thái AgentKit và các tệp đã xóa; chúng không phải backup toàn bộ dự án.