Bản thiết kế bộ sưu tập

KURV hiện chạy trên Base Sepolia và Solana Devnet. Trang này là cuốn cẩm nang từ một lần xây dựng thật đã hoàn tất (HANI the Dog, 1,000 tác phẩm, 20 tác phẩm độc nhất), viết cho nhà sáng tạo làm việc cùng một tác nhân AI qua đầu nối KURV tại https://mcp.kurv.fun/mcp. Đầu nối cung cấp cùng cẩm nang này cho tác nhân dưới dạng tài nguyên kurv://blueprint, và công cụ kurv_builder_spec là nguồn sự thật: khi trang này và công cụ khác nhau, hãy tin công cụ.

Kết nối một tác nhân

1. Thêm https://mcp.kurv.fun/mcp làm máy chủ MCP từ xa trong một ứng dụng hỗ trợ MCP từ xa với OAuth. Kết nối tác nhân bằng MCP liệt kê các ứng dụng và các bước của chúng.
2. Đăng nhập KURV trong trình duyệt và chấp thuận kết nối. Bạn chọn nó được làm gì (chỉ đọc; đọc và bản nháp; hoặc đọc, bản nháp và chuẩn bị ra mắt) và kéo dài bao lâu.
3. Yêu cầu tác nhân đọc kurv://blueprint, rồi gọi kurv_account và kurv_builder_spec cho mạng của bạn. Đầu nối cũng cung cấp prompt build-kurv-collection, dẫn tác nhân đi theo trang này với mọi điểm dừng phê duyệt được giữ nguyên.

Ai làm gì

Tác nhân lập kế hoạch, kiểm tra, tạo bản nháp, tải tác phẩm lên, xem trước và chuẩn bị ra mắt. Bạn phê duyệt tác phẩm, các mẫu và mọi cảnh báo, rồi mở liên kết xem xét và ký lần ra mắt bằng ví của chính mình. Tác nhân không bao giờ triển khai, không bao giờ ký và không bao giờ hỏi khóa riêng hay cụm từ khôi phục. Khi tác phẩm đã xong và được phê duyệt, phần việc phía KURV (kiểm tra, tạo, tải lên, xem trước, chuẩn bị) mất khoảng 20 phút. Làm ra tác phẩm tốt mất lâu hơn, và nên như vậy.

Các giới hạn

Mục	Giới hạn
Kích cỡ bộ sưu tập	1 đến 1,000 tác phẩm, tính cả tác phẩm độc nhất: 980 tác phẩm ngẫu nhiên và 20 tác phẩm độc nhất là kích cỡ 1,000.
Lớp	Tối đa 12.
Ảnh thuộc tính	Tối đa 240 ảnh trên tất cả các lớp, tính cả ảnh chỉ dùng cho tác phẩm độc nhất. Một lớp trống không tốn gì.
Tác phẩm độc nhất	Tối đa 32.
Quy tắc	Tối đa 48, giống nhau trên mọi mạng.
Kích cỡ tệp ảnh	Tối đa 2 MiB cho mỗi ảnh gửi từng tấm; tối đa 20 MiB cho một ảnh bên trong zip.
Khung vẽ	Hình vuông, tối đa 2,048 nhân 2,048 điểm ảnh. Mỗi tệp đúng bằng kích cỡ khung vẽ.
Định dạng	Nền: PNG, JPEG hoặc WebP. Mọi lớp khác: PNG có độ trong suốt thật.
Cái tên None	Được dành riêng ở mọi cách viết hoa. Không bao giờ tạo thuộc tính tên None, không bao giờ dùng ảnh trống: một lớp trở thành tùy chọn qua noneWeight.
Mô tả	Coi như bắt buộc: 1 đến 2,000 ký tự. Nó đi vào siêu dữ liệu của mọi tác phẩm.
Bản nháp	20 bản đang hoạt động mỗi tài khoản. kurv_archive_draft giải phóng một chỗ ngay lập tức; tác phẩm của bản nháp đã lưu trữ được giữ 30 ngày rồi xóa.
Xem trước	Tối đa 9 mẫu ngẫu nhiên mỗi lần gọi, hoặc tối đa 9 số tác phẩm được chọn, ở 64 đến 512 điểm ảnh.

Tác nhân đọc validCombinations sau mỗi lần kiểm tra: các lớp và quy tắc cho phép bao nhiêu tác phẩm khác nhau. Con số được đếm chính xác cho không gian tới khoảng 50 triệu tổ hợp và được ghi là ước tính nếu lớn hơn. Hãy giữ nó cao hơn hẳn kích cỡ bộ sưu tập.

Con đường, từng bước

Các bước ghi Phê duyệt nghĩa là: tác nhân dừng lại và chờ lời “đồng ý” rõ ràng của bạn.

1. Ảnh. Thu thập 3 đến 10 bức ảnh sắc nét của thú cưng hoặc nhân vật thật: mặt, mắt, răng và miệng, hoa văn, tai. Chọn một bức ảnh chính với khuôn mặt ở góc ba phần tư.
2. Hướng nghệ thuật. Một phong cách, một dáng (ba phần tư hợp nhất), một khung vẽ vuông (khuyến nghị 2,048 nhân 2,048), một bảng phong cách ngắn: nét, bóng, bảng màu, không khí. Phê duyệt: nhân vật gốc, trước khi làm bất kỳ thuộc tính nào.
3. Bản gốc. Nhân vật ở dáng cuối cùng trên nền phẳng một màu, ở giữa, kích cỡ trọn khung vẽ, nhận ra ngay là thú cưng thật. Mọi thuộc tính là một bản chỉnh sửa của bản gốc này, cùng dáng, tỷ lệ và khung hình.
4. Lớp. Các lớp vẽ từ dưới lên trên: Background, Skin (lớp nền), Collar, Teeth, Eyes, Headwear (tùy chọn). Khoảng sáu lớp; nhân vật gánh bộ sưu tập, không phải đạo cụ. Tác nhân đặt tên lớp nền trong base_layer và cho mỗi lớp một hộp neo nơi các thuộc tính của nó phải nằm.
5. Thuộc tính. Mỗi thuộc tính là bản chỉnh sửa của một bản sao bản gốc, cắt sao cho chỉ điểm ảnh của riêng thuộc tính hiện ra và mọi thứ khác trong suốt. Tạo thuộc tính trên một bản sao thân màu phẳng giữ lông không lẫn vào. Thuộc tính lệch vị trí hay tỷ lệ bị từ chối.
6. Tác phẩm độc nhất. Thân biến đổi hoàn toàn (kim cương, crôm, dung nham, đồng), mỗi cái có nền tương xứng và không vòng cổ. Ảnh của chúng đi vào lớp của nó như một thuộc tính có trọng số 0, nên không bao giờ xuất hiện trong tác phẩm ngẫu nhiên; nó được tính vào 240 ảnh.
7. Quy tắc. Bảng đối chiếu mọi da với mọi thuộc tính vòng cổ, răng, mắt và đồ đội đầu. Mỗi cặp xấu (cắt xén, không thấy, khó coi) trở thành một quy tắc loại trừ theo nhóm với ghi chú nói lý do.
8. Phê duyệt: các bảng lớp, ít nhất 9 mẫu ghép, bảng tác phẩm độc nhất, cấu hình và điều khoản bán, trước khi tạo bản nháp.
9. Cấu hình và kiểm tra. kurv_builder_spec với mạng, rồi kurv_validate_collection với cấu hình cho đến khi danh sách issues không còn lỗi. Cảnh báo nêu điều bạn nên nghe. Câu trả lời mang required_assets, các khóa chính xác cần tải lên, và validCombinations.
10. Bản nháp. kurv_create_collection với version: 3, mạng, cấu hình, điều khoản bán và một khóa idempotency, trước hết với check_only đặt true, rồi gọi thật. Lần gọi thất bại được thử lại với cùng khóa. Điều khoản bán có một dạng duy nhất trên mọi mạng: xem Điều khoản bán.
11. Tác phẩm. Từng tấm với kurv_upload_trait (nền, bản gốc và một thuộc tính mỗi lớp trước, rồi xem trước, rồi phần còn lại), hoặc tất cả một lần theo định dạng thư mục web qua kurv_upload_collection_zip. Một lớp trống là noneWeight, không bao giờ là PNG trong suốt.
12. Kiểm tra và xem trước. kurv_validate_collection với bản nháp chạy các kiểm tra tác phẩm. kurv_preview_collection với 9 mẫu sau lần tải lên cuối, cộng số tác phẩm của mọi tác phẩm độc nhất và các tổ hợp rủi ro nhất. Tác nhân xem từng ảnh. Lần xem trước đầu kéo dài trả về retry_after và các mẫu còn chờ; tác nhân gọi lại.
13. Sửa mà không cần bản nháp mới. kurv_update_collection đổi quy tắc, tác phẩm độc nhất, trọng số, gợi ý hay mô tả ngay tại chỗ; khung vẽ không thể đổi. kurv_replace_trait_image thay một ảnh, kurv_rename_trait đổi tên một thuộc tính và cập nhật quy tắc cùng tác phẩm độc nhất của nó, kurv_delete_trait xóa một thuộc tính không gì tham chiếu. Rồi xem trước lại.
14. Phê duyệt: các mẫu cuối và mọi cảnh báo, được đọc cho bạn.
15. Chuẩn bị. kurv_prepare_launch với bản nháp. Khi gặp warnings_need_review, tác nhân giải thích từng cảnh báo; chỉ sau khi bạn chấp nhận, nó mới gọi lại với acknowledge_warnings đặt true. Bạn nhận một liên kết trình duyệt.
16. Bạn ký. Mở liên kết duy nhất, kiểm tra những gì đã điền, chọn Xuất bản và ra mắt và ký bằng ví của chính bạn ở bước cuối. Mỗi câu trả lời chỉ cách một lần Quay lại. Không công cụ nào ký thay bạn.

Quy tắc

Một quy tắc giữ thuộc tính của hai lớp tách rời hay đi cùng: {"type", "when", "target", "note"}, trong đó type là exclude hoặc require, còn when và target mỗi cái nêu một lớp và, tùy chọn, một thuộc tính: một tên hoặc một danh sách tên. Không có thuộc tính nghĩa là cả lớp, và when với target phải là hai lớp khác nhau. Khóa là trait: quy tắc viết bằng traits bị từ chối kèm khóa đúng được nêu tên, thay vì âm thầm áp lên cả lớp. None chỉ có thể đại diện cho lớp trống khi lớp đó có noneWeight lớn hơn 0. Gom các cặp vào danh sách để giữ dưới 48: một quy tắc cho mỗi nhóm da, liệt kê mọi vòng cổ chúng không bao giờ được đeo.

{"type": "exclude", "note": "Thick fur hides these collars", "when": {"layer": "Skin", "trait": ["Lion Mane", "Fire Fur"]}, "target": {"layer": "Collar", "trait": ["Bow Tie", "Name Tag"]}}

Quy tắc đi tới tận tác phẩm: cùng một bộ máy sinh ra bản xem trước và các tệp xuất bản, và việc đúc trao ra chính các tệp đó. Một tác phẩm độc nhất có thể bỏ qua quy tắc bằng ignoreRules đặt true; tính độc nhất vẫn giữ.

Tác phẩm độc nhất

Tác phẩm độc nhất là specials: một tên, mọi lớp với thuộc tính của nó hoặc None, một số tác phẩm ghim tùy chọn và một mô tả tùy chọn. Tác phẩm độc nhất bỏ sót một lớp sẽ nhận lớp đó ngẫu nhiên, và việc kiểm tra cảnh báo đó là những lớp nào. null bị từ chối, và tên thuộc tính không tồn tại cũng vậy.

{"name": "Diamond Grail", "tokenId": 1, "traits": {"Background": "Diamond Vault", "Skin": "Pave Diamond", "Collar": "None", "Teeth": "Diamond Grill", "Eyes": "None"}}

Tác phẩm mà người ta muốn

• Tác phẩm công phu, trau chuốt. Không có vẻ phẳng, đục, lộ rõ là máy tạo.
• Nền mạnh: màu táo bạo hoặc cảnh giàu chi tiết. Tránh chủ đề địa điểm (thành phố, bãi biển) trừ khi có chủ ý.
• Dáng ba phần tư và nét giống nhận ra được của thú cưng thật: hoa văn, màu mắt, dáng tai.
• Thuộc tính táo bạo khớp với thân nhân vật, vẽ trên hình dáng bản gốc. Răng khớp miệng chính xác.
• Không đồ đội đầu lơ lửng. Mũ nằm trên đầu với bóng tiếp xúc; tai lớn vượt lên trên vành.
• Quần áo thường không vừa với động vật. Ưu tiên vòng cổ, dây chuyền và đồ trang trí cổ, và thử trên mọi da.
• Tác phẩm độc nhất cao cấp biến đổi hoàn toàn, với nền tương xứng và không vòng cổ.

Đầu nối kiểm tra tác phẩm khi nó đến. Lỗi từ chối một lần tải lên: kích cỡ khung vẽ khác, một lớp trên nền không phải PNG có độ trong suốt, một ảnh không có điểm ảnh nhìn thấy. Cảnh báo quay về cho bạn xem lại: thuộc tính ngoài neo của nó, thuộc tính ở tỷ lệ khác với lớp của nó, thuộc tính lệch khỏi lưới điểm ảnh của bản gốc, thuộc tính vẫn mang toàn bộ hay một phần hình bản gốc, thuộc tính phủ cả khung vẽ. Một cảnh báo có thể sai: đôi mắt tự nhiên ở cùng lớp với kính râm cố ý có kích cỡ khác. Tác nhân đặt mixedScales trên lớp đó, hoặc acknowledge trên thuộc tính khi bạn đã đồng ý, và tác phẩm giữ đúng như nó nên có.

Những gì tác nhân đọc lại

Mọi công cụ kiểm tra đều trả lời mọi vấn đề cùng lúc trong một danh sách issues, mỗi mục có đường dẫn, mã, mức độ, thông điệp và cách khắc phục. Một khóa lạ bị từ chối kèm tên và khóa hợp lệ gần nhất. Mạng được nêu tên (base-sepolia, solana-devnet, solana-localnet), và bản nháp không có mạng sẽ dùng Base Sepolia và nói rõ điều đó. Các cách bán dùng tên của trang web (fixed, mystery, rising, falling, auction): qua đầu nối Base cung cấp fixed, mystery và rising, Solana cung cấp fixed và rising, còn bán kiểu falling và auction được thiết lập trên trang web. Một trường bán mà mạng không có, chẳng hạn ký hiệu trên Solana, bị từ chối kèm tên. Siêu dữ liệu được chứng minh bằng một bài kiểm chứng: mọi tác phẩm tuân thủ quy tắc, tác phẩm độc nhất nằm đúng tác phẩm nó được ghim, và một lớp trống được ghi là {"trait_type": "<layer>", "value": "None"}.

Tác phẩm hoàn thiện

Những tác phẩm đã có sẵn dưới dạng ảnh hoàn thiện bỏ qua các lớp: kurv_finished_art_limits, rồi kurv_upload_finished_file_part cho mỗi ảnh và metadata.json, rồi kurv_import_finished_collection. Các byte được giữ nguyên như đã gửi, kể cả hoạt ảnh, và các giới hạn theo lớp không áp dụng; giới hạn xuất bản hiện tại của trang web mới áp dụng. Tác phẩm hoàn thiện giải thích các tệp.

Giới hạn đã biết của bản này

• Giá trị của một đợt bán Solana phiên bản 2 được bộ phân tích của chính ứng dụng kiểm tra sau các khóa, từng cái một; đợt bán phiên bản 3 trả lời mọi vấn đề cùng lúc.
• Bản nháp tác phẩm hoàn thiện không thể sửa tại chỗ; sửa nghĩa là một lần tải lên mới và một khóa mới.
• Bản nháp đã lưu trữ không thể khôi phục qua đầu nối; tác phẩm của nó được giữ 30 ngày.
• Robinhood Chain không dùng được qua đầu nối: không có cấu hình mạng và không có lược đồ bán. Nó đến sau các lần ra mắt trên Base và Solana.

Số liệu bộ sưu tập là ảnh chụp tức thời và một lần ra mắt chuyển giá trị thật trên mạng của nó; hãy đọc Rủi ro và miễn trừ trách nhiệm trước khi khuyên ai về tiền.