مخطط المجموعة

يعمل KURV اليوم على Base Sepolia و Solana Devnet. هذه الصفحة دليل ميداني مأخوذ من بناء كامل (HANI the Dog، بـ 1,000 قطعة، منها 20 قطعة فريدة)، كُتب للمبدع الذي يعمل مع وكيل ذكاء اصطناعي عبر أداة ربط 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 لكل صورة تُرسل منفردة؛ وحتى 20 MiB لصورة واحدة داخل ملف zip.
مساحة الرسم	مربعة، حتى 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.

أرقام المجموعات لقطات، والإطلاق ينقل قيمة حقيقية على شبكته؛ لذا يُستحسن قراءة المخاطر وإخلاء المسؤولية قبل تقديم أي نصيحة لأحد بشأن المال.