พิมพ์เขียวคอลเลกชัน

วันนี้ KURV ทำงานบน Base Sepolia และ Solana Devnet หน้านี้คือคู่มือภาคสนามจากการสร้างจริงที่เสร็จสมบูรณ์ (HANI the Dog, 1,000 ชิ้น, ชิ้นพิเศษ 20 ชิ้น) เขียนให้ครีเอเตอร์ที่ทำงานกับเอเจนต์ AI ผ่านคอนเน็กเตอร์ KURV ที่ https://mcp.kurv.fun/mcp คอนเน็กเตอร์ให้คู่มือเดียวกันนี้แก่เอเจนต์ในรูปรีซอร์ส kurv://blueprint และเครื่องมือ kurv_builder_spec คือแหล่งความจริง เมื่อหน้านี้กับเครื่องมือขัดกัน ให้เชื่อเครื่องมือ

เชื่อมต่อเอเจนต์

1. เพิ่ม https://mcp.kurv.fun/mcp เป็นเซิร์ฟเวอร์ MCP ระยะไกลในไคลเอนต์ที่รองรับ MCP ระยะไกลพร้อม OAuth เชื่อมต่อเอเจนต์ด้วย MCP แสดงรายชื่อไคลเอนต์และขั้นตอนของแต่ละตัว
2. เข้าสู่ระบบ KURV ในเบราว์เซอร์แล้วอนุมัติการเชื่อมต่อ คุณเลือกว่าให้ทำอะไรได้ (อ่านอย่างเดียว อ่านและฉบับร่าง หรืออ่าน ฉบับร่าง และเตรียมเปิดตัว) และนานเท่าใด
3. ขอให้เอเจนต์อ่าน kurv://blueprint แล้วเรียก kurv_account และ kurv_builder_spec สำหรับเครือข่ายของคุณ คอนเน็กเตอร์ยังมีพรอมต์ build-kurv-collection ซึ่งพาเอเจนต์เดินตามหน้านี้โดยคงจุดหยุดอนุมัติทุกจุดไว้

ใครทำอะไร

เอเจนต์วางแผน ตรวจสอบ สร้างฉบับร่าง อัปโหลดภาพ ดูตัวอย่าง และเตรียมเปิดตัว คุณอนุมัติภาพ ตัวอย่าง และคำเตือนทุกข้อ แล้วเปิดลิงก์ตรวจทานและเซ็นการเปิดตัวด้วยกระเป๋าของคุณเอง เอเจนต์ไม่เคยดีพลอย ไม่เคยเซ็น และไม่เคยขอกุญแจส่วนตัวหรือวลีกู้คืน เมื่อภาพเสร็จและได้รับอนุมัติแล้ว งานฝั่ง KURV (ตรวจสอบ สร้าง อัปโหลด ดูตัวอย่าง เตรียม) ใช้เวลาราว 20 นาที การทำภาพดีๆ ใช้เวลานานกว่านั้น และก็ควรเป็นเช่นนั้น

ขีดจำกัด

รายการ	ขีดจำกัด
ขนาดคอลเลกชัน	1 ถึง 1,000 ชิ้น รวมชิ้นพิเศษ: ชิ้นสุ่ม 980 ชิ้นกับชิ้นพิเศษ 20 ชิ้นคือขนาด 1,000
เลเยอร์	สูงสุด 12
ภาพลักษณะ	รวมทุกเลเยอร์สูงสุด 240 ภาพ รวมภาพที่ใช้เฉพาะชิ้นพิเศษ เลเยอร์ว่างไม่กินโควตา
ชิ้นพิเศษ	สูงสุด 32
กฎ	สูงสุด 48 เท่ากันทุกเครือข่าย
ขนาดไฟล์ภาพ	ภาพที่ส่งทีละภาพสูงสุด 2 MiB ภาพหนึ่งภาพใน zip สูงสุด 20 MiB
ผืนภาพ	สี่เหลี่ยมจัตุรัส สูงสุด 2,048 คูณ 2,048 พิกเซล ทุกไฟล์มีขนาดเท่าผืนภาพพอดี
รูปแบบ	พื้นหลัง: PNG, JPEG หรือ WebP เลเยอร์อื่นทั้งหมด: PNG ที่โปร่งใสจริง
ชื่อ None	ถูกสงวนไว้ไม่ว่าจะเขียนตัวพิมพ์ใดก็ตาม อย่าสร้างลักษณะชื่อ None และอย่าใช้ภาพว่าง เลเยอร์กลายเป็นตัวเลือกได้ด้วย noneWeight
คำอธิบาย	ถือว่าจำเป็น: 1 ถึง 2,000 ตัวอักษร มันเข้าไปอยู่ในเมตาดาตาของทุกชิ้น
ฉบับร่าง	ใช้งานอยู่ได้ 20 ฉบับต่อบัญชี kurv_archive_draft คืนช่องให้ทันที ภาพของฉบับร่างที่เก็บเข้าคลังจะถูกเก็บไว้ 30 วันแล้วลบ
ตัวอย่าง	ตัวอย่างสุ่มสูงสุด 9 ชิ้นต่อการเรียกหนึ่งครั้ง หรือเลขชิ้นที่เลือกสูงสุด 9 เลข ที่ 64 ถึง 512 พิกเซล

เอเจนต์อ่าน validCombinations หลังการตรวจสอบทุกครั้ง: เลเยอร์และกฎอนุญาตให้มีชิ้นที่ต่างกันกี่ชิ้น ตัวเลขนับได้แม่นยำสำหรับพื้นที่ถึงราว 50 ล้านชุดผสม และจะติดป้ายว่าเป็นค่าประมาณเมื่อมากกว่านั้น รักษาให้สูงกว่าขนาดคอลเลกชันอย่างสบายๆ

เส้นทาง ทีละก้าว

ขั้นที่ทำเครื่องหมาย อนุมัติ หมายถึง: เอเจนต์หยุดและรอคำว่า “ใช่” ที่ชัดเจนจากคุณ

1. ภาพถ่าย รวบรวมภาพถ่ายคมชัดของสัตว์เลี้ยงหรือตัวละครจริง 3 ถึง 10 ภาพ: หน้า ตา ฟันและปาก ลวดลาย หู เลือกภาพหลักหนึ่งภาพที่เห็นหน้าในมุมสามส่วนสี่
2. ทิศทางศิลปะ หนึ่งสไตล์ หนึ่งท่า (สามส่วนสี่ได้ผลดีที่สุด) หนึ่งผืนภาพสี่เหลี่ยมจัตุรัส (แนะนำ 2,048 คูณ 2,048) และสไตล์ชีตสั้นๆ: ลายเส้น แสงเงา ชุดสี อารมณ์ อนุมัติ: ตัวละครต้นแบบ ก่อนทำลักษณะใดๆ
3. ภาพฐานต้นแบบ ตัวละครในท่าสุดท้ายบนพื้นหลังสีเดียวเรียบ อยู่กลาง ขนาดเต็มผืนภาพ จำได้ทันทีว่าเป็นสัตว์เลี้ยงตัวจริง ทุกลักษณะคือการแก้ไขจากต้นแบบนี้ ด้วยท่า สัดส่วน และการจัดภาพเดียวกัน
4. เลเยอร์ เลเยอร์วาดจากล่างขึ้นบน: Background, Skin (เลเยอร์ฐาน), Collar, Teeth, Eyes, Headwear (ตัวเลือก) ราวหกเลเยอร์ ตัวละครคือสิ่งที่พาคอลเลกชันไป ไม่ใช่ของประกอบ เอเจนต์ระบุเลเยอร์ฐานใน base_layer และให้แต่ละเลเยอร์มีกรอบยึดที่ลักษณะของมันต้องอยู่
5. ลักษณะ แต่ละลักษณะคือการแก้ไขสำเนาของต้นแบบ ตัดให้เห็นเฉพาะพิกเซลของลักษณะนั้นเองและส่วนอื่นโปร่งใสทั้งหมด การสร้างลักษณะบนสำเนาลำตัวสีเรียบช่วยไม่ให้ขนปนเข้าไป ลักษณะที่เคลื่อนตำแหน่งหรือสัดส่วนจะถูกปฏิเสธ
6. ชิ้นพิเศษ ลำตัวที่แปลงร่างทั้งตัว (เพชร โครเมียม ลาวา ทองสัมฤทธิ์) แต่ละชิ้นมีพื้นหลังที่เข้ากันและไม่มีปลอกคอ ภาพของมันเข้าไปอยู่ในเลเยอร์เป็นลักษณะที่มีน้ำหนัก 0 จึงไม่เคยปรากฏในชิ้นสุ่ม แต่นับรวมใน 240 ภาพ
7. กฎ แผ่นตารางเทียบทุกผิวกับทุกลักษณะปลอกคอ ฟัน ตา และของสวมหัว คู่ที่แย่ทุกคู่ (ทับซ้อน มองไม่เห็น ไม่สวย) กลายเป็นกฎกันออกแบบกลุ่มพร้อมโน้ตบอกเหตุผล
8. อนุมัติ: แผ่นเลเยอร์ ตัวอย่างประกอบอย่างน้อย 9 ชิ้น แผ่นชิ้นพิเศษ คอนฟิก และเงื่อนไขการขาย ก่อนสร้างฉบับร่าง
9. คอนฟิกและการตรวจสอบ kurv_builder_spec พร้อมเครือข่าย แล้ว kurv_validate_collection พร้อมคอนฟิกจนรายการ issues ไม่มีข้อผิดพลาด คำเตือนบอกสิ่งที่คุณควรรับฟัง คำตอบมี required_assets คือคีย์ที่ต้องอัปโหลดอย่างแม่นยำ และ validCombinations
10. ฉบับร่าง kurv_create_collection พร้อม version: 3 เครือข่าย คอนฟิก เงื่อนไขการขาย และคีย์ไอเดมโพเทนซี ครั้งแรกตั้ง check_only เป็น true แล้วค่อยเรียกจริง การเรียกที่ล้มเหลวให้ลองใหม่ด้วยคีย์เดิม เงื่อนไขการขายมีรูปแบบเดียวในทุกเครือข่าย ดูเงื่อนไขการขาย
11. ภาพ ทีละภาพด้วย kurv_upload_trait (พื้นหลัง ฐาน และหนึ่งลักษณะต่อเลเยอร์ก่อน แล้วดูตัวอย่าง แล้วส่วนที่เหลือ) หรือทั้งหมดในครั้งเดียวในรูปแบบโฟลเดอร์เว็บผ่าน kurv_upload_collection_zip เลเยอร์ว่างคือ noneWeight ไม่ใช่ PNG โปร่งใส
12. ตรวจและดูตัวอย่าง kurv_validate_collection พร้อมฉบับร่างจะรันการตรวจภาพ kurv_preview_collection พร้อมตัวอย่าง 9 ชิ้นหลังการอัปโหลดครั้งสุดท้าย บวกเลขชิ้นของชิ้นพิเศษทุกชิ้นและชุดผสมที่เสี่ยงที่สุด เอเจนต์ดูทุกภาพ การดูตัวอย่างครั้งแรกที่นานจะตอบ retry_after และตัวอย่างที่ค้างอยู่ เอเจนต์เรียกอีกครั้ง
13. แก้โดยไม่ต้องสร้างฉบับร่างใหม่ kurv_update_collection แก้กฎ ชิ้นพิเศษ น้ำหนัก คำใบ้ หรือคำอธิบายในที่เดิม ผืนภาพเปลี่ยนไม่ได้ kurv_replace_trait_image สลับภาพหนึ่งภาพ kurv_rename_trait เปลี่ยนชื่อลักษณะและอัปเดตกฎกับชิ้นพิเศษของมัน kurv_delete_trait ลบลักษณะที่ไม่มีอะไรอ้างถึง จากนั้นดูตัวอย่างใหม่
14. อนุมัติ: ตัวอย่างสุดท้ายและคำเตือนทุกข้อ อ่านให้คุณฟัง
15. เตรียม kurv_prepare_launch พร้อมฉบับร่าง เมื่อได้ warnings_need_review เอเจนต์อธิบายคำเตือนแต่ละข้อ และหลังจากคุณยอมรับแล้วเท่านั้นจึงเรียกอีกครั้งโดยตั้ง acknowledge_warnings เป็น true คุณจะได้ลิงก์เบราว์เซอร์
16. คุณเป็นผู้ลงนาม เปิดลิงก์เดียว ตรวจสิ่งที่กรอกไว้ เลือก เผยแพร่และเปิดตัว แล้วลงนามด้วยกระเป๋าเงินของคุณเองในขั้นตอนสุดท้าย ทุกคำตอบอยู่ห่างแค่กดย้อนกลับครั้งเดียว ไม่มีเครื่องมือใดลงนามแทนคุณ

กฎ

กฎทำให้ลักษณะของสองเลเยอร์แยกกันหรืออยู่ด้วยกัน: {"type", "when", "target", "note"} โดย type เป็น exclude หรือ require และ when กับ target แต่ละอันระบุเลเยอร์หนึ่ง และจะระบุลักษณะด้วยก็ได้: หนึ่งชื่อหรือรายการชื่อ ไม่ระบุลักษณะหมายถึงทั้งเลเยอร์ และ when กับ target ต้องเป็นเลเยอร์ที่ต่างกัน คีย์คือ trait กฎที่เขียนด้วย traits จะถูกปฏิเสธพร้อมบอกคีย์ที่ถูก แทนที่จะใช้กับทั้งเลเยอร์อย่างเงียบๆ None แทนเลเยอร์ว่างได้ก็ต่อเมื่อเลเยอร์นั้นมี noneWeight มากกว่า 0 จัดกลุ่มคู่เป็นรายการเพื่อให้อยู่ใต้ 48: หนึ่งกฎต่อกลุ่มผิว ระบุปลอกคอทุกอันที่ห้ามใส่

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

กฎไปถึงตัวชิ้นงาน: เอนจินเดียวกันสร้างตัวอย่างและไฟล์ที่เผยแพร่ และการมินต์แจกไฟล์เหล่านั้น ชิ้นพิเศษข้ามกฎได้โดยตั้ง ignoreRules เป็น true ความไม่ซ้ำกันยังคงอยู่

ชิ้นพิเศษ

ชิ้นพิเศษคือ specials: ชื่อ ทุกเลเยอร์พร้อมลักษณะของมันหรือ None เลขชิ้นที่ปักหมุดไว้ (ไม่บังคับ) และคำอธิบาย (ไม่บังคับ) ชิ้นพิเศษที่ละเลเยอร์ไว้จะได้เลเยอร์นั้นแบบสุ่ม และการตรวจสอบจะเตือนว่าเลเยอร์ใด null ถูกปฏิเสธ และชื่อลักษณะที่ไม่มีอยู่ก็เช่นกัน

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

ภาพที่คนอยากได้

• ภาพที่ทุ่มเทและขัดเกลา ไม่แบน ไม่ขุ่น ไม่ดูเป็นของสร้างจากเครื่องอย่างโจ่งแจ้ง
• พื้นหลังที่แข็งแรง: สีจัดจ้านหรือฉากที่สมบูรณ์ หลีกเลี่ยงธีมสถานที่ (เมือง ชายหาด) เว้นแต่ตั้งใจ
• ท่าสามส่วนสี่และความเหมือนที่จำได้ว่าเป็นสัตว์เลี้ยงตัวจริง: ลวดลาย สีตา รูปหู
• ลักษณะที่โดดเด่นเข้ารูปกับลำตัวตัวละคร วาดบนรูปร่างของต้นแบบ ฟันเข้ากับปากพอดี
• ไม่มีของสวมหัวที่ลอย หมวกวางบนหัวพร้อมเงาสัมผัส หูใหญ่โผล่เหนือปีกหมวก
• เสื้อผ้ามักไม่เข้ากับสัตว์ เลือกปลอกคอ สร้อย และเครื่องประดับคอ แล้วลองกับทุกผิว
• ชิ้นพิเศษระดับพรีเมียมแปลงร่างทั้งตัว มีพื้นหลังที่เข้ากัน และไม่มีปลอกคอ

คอนเน็กเตอร์ตรวจภาพทันทีที่มาถึง ข้อผิดพลาดปฏิเสธการอัปโหลด: ขนาดผืนภาพที่ต่าง เลเยอร์เหนือพื้นหลังที่ไม่ใช่ PNG โปร่งใส ภาพที่ไม่มีพิกเซลมองเห็น คำเตือนกลับมาให้คุณทบทวน: ลักษณะที่อยู่นอกกรอบยึด ลักษณะที่สัดส่วนต่างจากเลเยอร์ของมัน ลักษณะที่หลุดจากกริดพิกเซลของฐาน ลักษณะที่ยังมีภาพฐานทั้งหมดหรือบางส่วน ลักษณะที่คลุมทั้งผืนภาพ คำเตือนหนึ่งอาจผิดได้: ตาธรรมชาติในเลเยอร์เดียวกับแว่นกันแดดมีขนาดต่างกันโดยตั้งใจ เอเจนต์ตั้ง mixedScales บนเลเยอร์นั้น หรือ acknowledge บนลักษณะเมื่อคุณเห็นด้วย และภาพคงอยู่อย่างที่ควรเป็น

สิ่งที่เอเจนต์อ่านกลับ

เครื่องมือตรวจสอบทุกตัวตอบปัญหาทั้งหมดในครั้งเดียวในรายการ issues รายการเดียว แต่ละข้อมีพาธ โค้ด ระดับความรุนแรง ข้อความ และวิธีแก้ คีย์ที่ไม่รู้จักถูกปฏิเสธโดยระบุชื่อพร้อมคีย์ที่ถูกต้องที่ใกล้ที่สุด เครือข่ายระบุด้วยชื่อ (base-sepolia, solana-devnet, solana-localnet) และฉบับร่างที่ไม่ระบุใช้ Base Sepolia พร้อมบอกไว้ วิธีขายใช้ชื่อตามเว็บไซต์ (fixed, mystery, rising, falling, auction): ผ่านคอนเน็กเตอร์ Base ให้ fixed, mystery และ rising Solana ให้ fixed และ rising ส่วนการขายแบบ falling และ auction ตั้งค่าบนเว็บไซต์ ฟิลด์การขายที่เครือข่ายไม่มี เช่น สัญลักษณ์บน Solana จะถูกปฏิเสธโดยระบุชื่อ เมตาดาตาได้รับการพิสูจน์ด้วยการตรวจพิสูจน์: ทุกชิ้นเคารพกฎ ชิ้นพิเศษลงตรงชิ้นที่ปักหมุด และเลเยอร์ว่างเขียนเป็น {"trait_type": "<layer>", "value": "None"}

ชิ้นงานสำเร็จ

ชิ้นงานที่มีอยู่แล้วเป็นภาพสำเร็จข้ามเลเยอร์ไป: kurv_finished_art_limits แล้ว kurv_upload_finished_file_part สำหรับทุกภาพและ metadata.json แล้ว kurv_import_finished_collection ไบต์ถูกเก็บตามที่ให้มา รวมแอนิเมชัน และขีดจำกัดแบบเลเยอร์ไม่ใช้ แต่ขีดจำกัดการเผยแพร่ปัจจุบันของเว็บไซต์ใช้ งานสำเร็จ อธิบายไฟล์ต่างๆ

ขีดจำกัดที่รู้แล้วของบิลด์นี้

• ค่าของการขายบน Solana เวอร์ชัน 2 ถูกตรวจโดยตัวแยกวิเคราะห์ของแอปเองหลังจากคีย์ ทีละค่า ส่วนการขายเวอร์ชัน 3 ตอบปัญหาทั้งหมดในครั้งเดียว
• ฉบับร่างงานสำเร็จแก้ในที่เดิมไม่ได้ การแก้คือการอัปโหลดใหม่และคีย์ใหม่
• ฉบับร่างที่เก็บเข้าคลังกู้คืนผ่านคอนเน็กเตอร์ไม่ได้ ภาพของมันถูกเก็บไว้ 30 วัน
• Robinhood Chain ใช้ผ่านคอนเน็กเตอร์ไม่ได้: ไม่มีคอนฟิกเครือข่ายและไม่มีสคีมาการขาย มันจะมาหลังการเปิดตัวบน Base และ Solana

ตัวเลขของคอลเลกชันคือภาพ ณ ขณะหนึ่ง และการเปิดตัวเคลื่อนย้ายมูลค่าจริงบนเครือข่ายของมัน อ่านความเสี่ยงและข้อปฏิเสธความรับผิดก่อนแนะนำใครเรื่องเงิน