AgentKit
Tài liệuBộ kitTham chiếu CLIỨng dụng Desktop
BetaBạn đang đọc tài liệu kênh beta (3.2.0-beta.10). Tính năng có thể thay đổi trước bản stable tiếp theo.Chuyển sang stable →

ak skills kit

ak skills kit unpublish

Unpublish (xoá mềm) Kit SkillX của một Kit cá nhân, khôi phục được trong 30 ngày, mà không chạm vào Kit cá nhân cục bộ.

Dùng ak skills kit unpublish để gỡ khỏi SkillX Kit mà một Kit cá nhân đang liên kết, hoặc Kit mà --kit chỉ định. SkillX xoá mềm Kit đó, nên không ai đọc hay sync được, và giữ nó khôi phục được trong 30 ngày bằng ak skills kit restore. Tên vẫn được giữ chỗ.

Cách dùng

ak skills kit unpublish <name> [--kit @<handle>/<name>] [--yes] [flags]
ak skills kit unpublish mine
ak skills kit unpublish mine --yes --json
ak skills kit unpublish mine --kit @alice/mine --dry-run

Tuỳ chọn

CờMặc địnhMô tả
--kit @<handle>/<name>Kit đã liên kếtKit cá nhân trên SkillX cần unpublish. Bắt buộc khi Kit cá nhân chưa có liên kết SkillX.
--dry-runfalseHiển thị Kit sẽ bị unpublish; không gửi gì.
--yesfalseXác nhận mà không hỏi. Bắt buộc khi dùng --json, --no-interactive hoặc không có terminal.

Các cờ dùng chung nằm trong quy ước CLI.

Điều kiện

SkillX phải bật, sau ak update --ssot hoặc với AGENTKIT_SKILLX=1, và các lệnh Kit cá nhân không bị AGENTKIT_SKILL_OVERLAYS ẩn đi.

SkillX chỉ nhận lệnh này từ chủ sở hữu Kit với một SkillX API key không giới hạn scope trong ak secrets (SKILLX_TOKEN). Lệnh dùng key đó kể cả khi ak skills link đang liên kết SkillX. Chỉ có liên kết agentkit.best thì bị từ chối kèm gợi ý: lưu một key bằng ak secrets set SKILLX_TOKEN, hoặc dùng creator dashboard của SkillX.

Lệnh chỉ chạm vào AGENTKIT_HOME và theo scope global của nó từ bất kỳ thư mục nào.

Lệnh làm gì

Lệnh đọc link record AGENTKIT_HOME/state/personal-kits/<name>/skillx.json để tìm Kit trên SkillX, trừ khi --kit chỉ định một Kit. Không có liên kết và không có --kit thì lệnh thoát 2.

Sau đó lệnh gửi một request xoá. SkillX ẩn Kit và các revision của nó ngay lập tức và giữ Kit khôi phục được trong 30 ngày. Kit đã bị unpublish trước đó báo already_unpublished và thoát 0.

Không có gì cục bộ thay đổi: Kit cá nhân, các projection và link record vẫn còn, nên ak skills kit restore có thể đưa Kit trở lại. Để gỡ các projection, dùng ak skills kit remove.

Trên terminal, lệnh hỏi Unpublish <kit> from SkillX? It stays restorable for 30 days with ak skills kit restore. [y/N]. Từ chối sẽ thoát 3 và không gửi gì. Với --json, --no-interactive hoặc không có terminal, lệnh cần --yes; thiếu nó, lệnh thoát 2 với thông báo rằng cần xác nhận và chưa gửi gì.

Đầu ra

Đầu ra text hiển thị Kit cá nhân và Kit SkillX của nó cùng kết quả. Sau khi unpublish, lệnh còn in hạn khôi phục và dòng ak skills kit restore <name> --kit <kit> để đưa Kit trở lại. Dry run được đánh dấu [dry run, nothing sent].

JSON dùng kind=skills.kit.unpublish với các trường sau dưới data:

personalKit, kit, host, status, dryRun, deletedAt, restoreDeadline

status là planned cho dry run, unpublished, hoặc already_unpublished. deletedAt và restoreDeadline có khi SkillX đã trả lời lệnh xoá.

Kết quả và mã thoát

MãÝ nghĩa
0Đã unpublish, đã unpublish từ trước, hoặc dry run.
1Lệnh thất bại: SkillX offline, hoặc không có SkillX API key không giới hạn scope (chỉ có liên kết agentkit.best thì bị từ chối).
2SkillX hoặc cờ overlay bị tắt, cờ không hợp lệ, không có Kit đã liên kết và không có --kit, hoặc thiếu --yes khi không có terminal.
3Bạn đã từ chối xác nhận; không gửi gì.
5Không tìm thấy Kit SkillX với credential này, hoặc đã quá khung khôi phục 30 ngày.
7SkillX từ chối: không sở hữu publisher, hoặc quản trị viên đã xoá Kit.
10Kit cá nhân chưa được bật cho tài khoản của bạn (SkillX trả về kit.api_disabled). Kit cá nhân cục bộ vẫn hoạt động.

Lệnh liên quan