Dùng router ak:ckm-storage

Export ak-ckm-storage route các thao tác list, sync, upload và url tới client storage tương thích S3. Frontmatter hiện khai báo định danh runtime riêng ak:ckm-storage, khác với export ak-storage riêng biệt.

Dùng trang này để hiểu ranh giới thao tác

Scope

• Liệt kê object từ xa, có thể lọc theo prefix.
• Preview hoặc thực hiện sync đệ quy một folder local.
• Upload một tệp local tới object key đã chọn.
• Tạo public URL cho một object key.

Không dùng export này khi

• Bạn cần download, delete, access policy, tạo bucket, lifecycle hoặc migration. Đây không phải subcommand của router.
• Bạn cần bảo đảm URL được tạo là public hoặc object tồn tại. Quyền public vẫn là quyết định của provider và bucket policy.

Chuẩn bị mà không làm lộ credential

Client kiểm tra các environment variable sau:

Client phía sau cũng cần @aws-sdk/client-s3 trong environment thực thi. Giữ credential trong tệp environment local đã ignore, dùng credential giới hạn ở bucket với least privilege và không dán secret vào prompt hay output của Skill.

Trạng thái định danh theo runtime

Xem Runtime adapter để hiểu khác biệt về capability và delivery. Dùng cách gọi theo runtime ở trên.

Review contract thao tác

Truyền các argument này sau cách gọi canonical theo runtime.

Hiểu các giai đoạn

1. Router parse argument đầu tiên thành thao tác.
2. Router tải reference tương ứng với thao tác.
3. Thao tác tải backing client từ export ak-storage riêng và xác minh cấu hình.
4. Thao tác read-only liệt kê metadata hoặc tạo URL. Thao tác ghi kiểm tra input local trước request từ xa.
5. Dry-run sync báo các object key đề xuất mà không upload. Live sync upload tuần tự và báo thành công hay thất bại theo từng tệp.

Dependency xuyên export này có nghĩa ak-ckm-storage là router thay vì một implementation storage độc lập.

Giữ approval và tác động bên ngoài rõ ràng

• list và bước kiểm tra tồn tại tùy chọn gửi request đọc có xác thực tới provider đã cấu hình.
• upload và live sync đọc tệp local rồi gửi nội dung tới bucket đã cấu hình. Hãy duyệt chính xác tệp, object key, provider và phân loại dữ liệu trước.
• --dry-run ngăn upload trong routine sync phía sau, nhưng vẫn scan folder local.
• Việc tạo URL không đổi bucket policy và không biến object private thành public.
• Router không cấp quyền delete, publication, đổi CDN, phát sinh billing provider hay tạo credential.

Bằng chứng dự kiến

Với mỗi thao tác, hãy yêu cầu:

• Thao tác đã chọn cùng local path và remote path đã resolve.
• Trạng thái có cấu hình nhưng không hiển thị giá trị secret.
• Mapping tệp sang object từ dry run trước multi-file upload.
• Kết quả upload theo từng tệp, số lỗi và URL trả về cho live sync.
• Lỗi provider được giữ đủ để chẩn đoán nhưng không làm lộ credential.

Xử lý sự cố hoặc tiếp tục

Tiếp tục với Tổng quan Marketing Kit, Cài đặt Kit hoặc Tham chiếu CLI cho lệnh lifecycle AgentKit.

Biết các giới hạn hiện tại

• Chọn router này qua tên canonical đã khai báo ak:ckm-storage; ak-storage giữ định danh ak:storage riêng.
• Router tham chiếu backing client ở export còn lại, vì vậy cả hai export vẫn thuộc operation path đã được tài liệu hóa.
• Tương thích provider là intent được ship, không phải bảo đảm live. Endpoint, authentication, public URL và billing phải được xác minh với provider đã chọn.