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 restore

Khôi phục Kit SkillX của một Kit cá nhân đã unpublish trong 30 ngày qua và chuyển link record sang generation đã khôi phục.

Dùng ak skills kit restore để đưa trở lại Kit SkillX mà một Kit cá nhân đang liên kết, hoặc Kit mà --kit chỉ định, sau khi unpublish, tại đây hoặc trên dashboard SkillX, trong vòng 30 ngày. Lệnh không bao giờ hỏi.

Cách dùng

ak skills kit restore <name> [--kit @<handle>/<name>] [flags]
ak skills kit restore mine
ak skills kit restore mine --kit @alice/mine --json

Tuỳ chọn

CờMặc địnhMô tả
--kit @<handle>/<name>Kit đã liên kếtKit cá nhân trên SkillX cần khôi phục. Bắt buộc khi Kit cá nhân chưa có liên kết SkillX.

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 khôi phục. Kit đang hoạt động được báo là already_live và thoát 0. Kit do quản trị viên xoá chỉ quản trị viên mới khôi phục được (thoát 7), và Kit đã quá khung 30 ngày vẫn bị xoá (thoát 5).

Mỗi lần unpublish và khôi phục đều tăng generation của Kit thêm một. Khi link record chỉ đúng Kit vừa khôi phục trên cùng host, không có upload đang dở, và đã thấy generation ngay trước lần unpublish, lệnh chuyển record sang generation đã khôi phục qua journal của skill store, nên lần ak skills kit publish kế tiếp không cần --expect-generation. Nếu ghi thất bại, một cảnh báo nêu --expect-generation <n> cần truyền ở lần publish kế tiếp. Khi record không khớp, đầu ra text yêu cầu bạn kiểm tra Kit bằng ak skills kit revisions trước lần publish kế tiếp.

Đầu ra

Đầu ra text hiển thị Kit cá nhân, Kit SkillX của nó, host, thời điểm khôi phục và generation, hoặc cho biết Kit đang hoạt động và không có gì để khôi phục.

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

personalKit, kit, host, status, restoredAt, generation, linkUpdated

status là restored hoặc already_live. linkUpdated là true khi link record đã được chuyển sang generation đã khôi phục.

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

MãÝ nghĩa
0Đã khôi phục, hoặc Kit đang hoạt động.
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ệ, hoặc không có Kit đã liên kết và không có --kit.
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