Collection Blueprint

KURV działa dziś na Base Sepolia i Solana Devnet. Ta strona to przewodnik terenowy z kompletnej budowy (HANI the Dog, 1000 NFT, 20 unikatów), napisany dla twórcy, który pracuje z agentem AI przez konektor KURV pod adresem https://mcp.kurv.fun/mcp. Konektor udostępnia agentom ten sam przewodnik jako zasób kurv://blueprint, a źródłem prawdy jest narzędzie kurv_builder_spec: gdy ta strona i narzędzie się różnią, zaufaj narzędziu.

Podłącz agenta

1. Dodaj https://mcp.kurv.fun/mcp jako zdalny serwer MCP w kliencie, który obsługuje zdalne MCP z OAuth. Klienty i ich kroki wymienia strona Podłącz agenta przez MCP.
2. Zaloguj się na KURV w przeglądarce i zatwierdź połączenie. Wybierasz, co może robić (tylko odczyt, odczyt i szkice albo odczyt, szkice i przygotowanie wypuszczenia) i jak długo trwa.
3. Poproś agenta, aby przeczytał kurv://blueprint, a potem wywołał kurv_account i kurv_builder_spec dla Twojej sieci. Konektor oferuje też prompt build-kurv-collection, który prowadzi agenta przez tę stronę z każdym punktem zatwierdzenia na swoim miejscu.

Kto co robi

Agent planuje, weryfikuje, tworzy szkic, przesyła grafiki, robi podgląd i przygotowuje wypuszczenie. Ty zatwierdzasz grafiki, próbki i każde ostrzeżenie, a potem otwierasz link do przeglądu i podpisujesz wypuszczenie własnym portfelem. Agent nigdy niczego nie wdraża, nigdy nie podpisuje i nigdy nie prosi o klucz prywatny ani frazę seed. Gdy grafiki są gotowe i zatwierdzone, część po stronie KURV (weryfikacja, utworzenie, przesłanie, podgląd, przygotowanie) zajmuje około 20 minut. Stworzenie dobrych grafik trwa dłużej i tak powinno być.

Limity

Element	Limit
Rozmiar kolekcji	Od 1 do 1000 NFT łącznie z unikatami: 980 losowych NFT i 20 unikatów to rozmiar 1000.
Warstwy	Do 12.
Obrazy cech	Łącznie do 240 we wszystkich warstwach, wliczając grafiki używane tylko przez unikaty. Pusta warstwa nic nie kosztuje.
Unikaty	Do 32.
Reguły	Do 48, tyle samo w każdej sieci.
Rozmiar pliku obrazu	Do 2 MiB na obraz wysyłany pojedynczo; do 20 MiB na jeden obraz w pliku zip.
Płótno	Kwadratowe, do 2048 na 2048 pikseli. Każdy plik ma dokładnie rozmiar płótna.
Formaty	Tło: PNG, JPEG albo WebP. Każda inna warstwa: PNG z prawdziwą przezroczystością.
Nazwa None	Zarezerwowana niezależnie od wielkości liter. Nigdy cecha o nazwie None, nigdy pusty obraz: warstwa staje się opcjonalna przez noneWeight.
Opis	Traktuj jako wymagany: od 1 do 2000 znaków. Trafia do metadanych każdego NFT.
Szkice	20 aktywnych na konto. kurv_archive_draft od razu zwalnia miejsce; grafiki zarchiwizowanego szkicu są przechowywane 30 dni, a potem usuwane.
Podglądy	Do 9 losowych próbek na wywołanie albo do 9 wybranych numerów NFT, w rozmiarze od 64 do 512 pikseli.

Po każdej weryfikacji agent odczytuje validCombinations: ile różnych NFT pozwalają uzyskać warstwy i reguły. Wartość jest liczona dokładnie dla przestrzeni do około 50 milionów kombinacji, a powyżej jest oznaczana jako szacunek. Utrzymuj ją wyraźnie powyżej rozmiaru kolekcji.

Ścieżka krok po kroku

Kroki oznaczone jako Zatwierdzenie oznaczają, że agent zatrzymuje się i czeka na Twoje wyraźne „tak”.

1. Zdjęcia. Zbierz od 3 do 10 ostrych zdjęć prawdziwego zwierzaka albo postaci: pyszczek, oczy, zęby i pysk, znaczenia, uszy. Wybierz jedno główne zdjęcie z twarzą w ujęciu trzy czwarte.
2. Kierunek graficzny. Jeden styl, jedna poza (najlepiej sprawdza się trzy czwarte), jedno kwadratowe płótno (zalecane 2048 na 2048), krótki arkusz stylu: kreska, cieniowanie, paleta, nastrój. Zatwierdzenie: główna postać, zanim powstanie jakakolwiek cecha.
3. Główna baza. Postać w ostatecznej pozie na płaskim jednokolorowym tle, na środku, w pełnym rozmiarze płótna, od razu rozpoznawalna jako prawdziwy zwierzak. Każda cecha to edycja tej bazy, z tą samą pozą, skalą i kadrem.
4. Warstwy. Warstwy nakładają się od dołu do góry: Background, Skin (warstwa bazowa), Collar, Teeth, Eyes, Headwear (opcjonalna). Około sześciu warstw; kolekcję niesie postać, a nie rekwizyty. Agent podaje warstwę bazową w base_layer i każdej warstwie nadaje ramkę kotwiczenia, w której muszą znaleźć się jej cechy.
5. Cechy. Każda cecha to edycja kopii bazy, wycięta tak, aby widoczne były tylko piksele samej cechy, a wszystko inne było przezroczyste. Generowanie cech na płasko pokolorowanej kopii ciała chroni je przed sierścią. Cecha, która przesuwa się w położeniu lub skali, zostaje odrzucona.
6. Unikaty. W pełni przemienione ciała (diament, chrom, lawa, brąz), każde z pasującym tłem i bez obroży. Ich grafiki trafiają do swojej warstwy jako cecha z wagą 0, więc nigdy nie pojawiają się w losowych NFT; wliczają się do 240 obrazów.
7. Reguły. Arkusze zestawień każdej skóry z każdą obrożą, zębami, oczami i nakryciem głowy. Każda zła para (nachodzenie, niewidoczność, brzydota) staje się grupową regułą wykluczenia z notatką, która wyjaśnia dlaczego.
8. Zatwierdzenie: arkusze warstw, co najmniej 9 złożonych próbek, arkusz unikatów, konfiguracja i warunki sprzedaży, zanim powstanie szkic.
9. Konfiguracja i weryfikacja. kurv_builder_spec z siecią, a potem kurv_validate_collection z konfiguracją, dopóki jej lista issues nie będzie bez błędów. Ostrzeżenia wskazują to, o czym warto wiedzieć. Odpowiedź zawiera required_assets, czyli dokładne klucze do przesłania, oraz validCombinations.
10. Szkic. kurv_create_collection z version: 3, siecią, konfiguracją, warunkami sprzedaży i kluczem idempotencji, najpierw z check_only ustawionym na true, potem naprawdę. Nieudane wywołanie ponawia się z tym samym kluczem. Warunki sprzedaży mają ten sam kształt w każdej sieci: zobacz Warunki sprzedaży.
11. Grafiki. Pojedynczo przez kurv_upload_trait (najpierw tło, baza i po jednej cesze na warstwę, potem podgląd, potem reszta) albo wszystkie naraz w formacie folderu ze strony przez kurv_upload_collection_zip. Pusta warstwa to noneWeight, nigdy przezroczysty PNG.
12. Kontrola i podgląd. kurv_validate_collection ze szkicem uruchamia kontrolę grafik. kurv_preview_collection z 9 próbkami po ostatnim przesłaniu oraz z numerami NFT każdego unikatu i najbardziej ryzykownych kombinacji. Agent ogląda każdy obraz. Długi pierwszy podgląd odpowiada retry_after i oczekującymi próbkami; agent wywołuje go ponownie.
13. Poprawki bez nowego szkicu. kurv_update_collection zmienia na miejscu reguły, unikaty, wagi, wskazówki albo opis; płótna nie można zmienić. kurv_replace_trait_image wymienia jeden obraz, kurv_rename_trait zmienia nazwę cechy i aktualizuje jej reguły i unikaty, kurv_delete_trait usuwa cechę, do której nic się nie odwołuje. Potem nowy podgląd.
14. Zatwierdzenie: ostateczne próbki i każde ostrzeżenie, odczytane Ci na głos.
15. Przygotowanie. kurv_prepare_launch ze szkicem. Przy warnings_need_review agent wyjaśnia każde ostrzeżenie; dopiero gdy je zaakceptujesz, wywołuje narzędzie ponownie z acknowledge_warnings ustawionym na true. Dostajesz link do przeglądarki.
16. Podpisujesz ty. Otwórz jeden link, sprawdź, co jest wypełnione, wybierz Opublikuj i uruchom i podpisz własnym portfelem na ostatnim kroku. Każda odpowiedź jest jedno Wstecz dalej. Żadne narzędzie nie podpisuje za ciebie.

Reguły

Reguła rozdziela albo łączy cechy dwóch warstw: {"type", "when", "target", "note"}, gdzie type to exclude albo require, a when i target wskazują każdy warstwę i opcjonalnie cechę: jedną nazwę albo listę nazw. Brak cechy oznacza całą warstwę, a when i target muszą być różnymi warstwami. Klucz to trait: reguła zapisana z traits zostaje odrzucona ze wskazaniem właściwego klucza, zamiast po cichu dotyczyć całej warstwy. None może oznaczać pustą warstwę tylko tam, gdzie ta warstwa ma noneWeight powyżej 0. Grupuj pary w listy, aby zmieścić się w 48: jedna reguła na grupę skór, z listą wszystkich obroży, których nigdy nie mogą nosić.

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

Reguły docierają do NFT: ten sam silnik generuje podgląd i opublikowane pliki, a mint wydaje właśnie te pliki. Unikat może pominąć reguły dzięki ignoreRules ustawionemu na true; unikalność nadal obowiązuje.

Unikaty

Unikaty to specials: nazwa, każda warstwa ze swoją cechą albo None, opcjonalny przypięty numer NFT i opcjonalny opis. Unikat, który pomija warstwę, dostaje ją losowo, a weryfikacja ostrzega, które to warstwy. null zostaje odrzucone, podobnie jak nazwa cechy, która nie istnieje.

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

Grafiki, których ludzie chcą

• Dopracowane grafiki, w które włożono dużo pracy. Bez płaskiego, mętnego, wyraźnie wygenerowanego wyglądu.
• Mocne tła: śmiałe kolory albo bogate sceny. Unikaj motywów miejsc (miasta, plaże), chyba że są zamierzone.
• Poza trzy czwarte i rozpoznawalne podobieństwo do prawdziwego zwierzaka: znaczenia, kolor oczu, kształt uszu.
• Wyraziste cechy dopasowane do ciała postaci, rysowane na kształcie bazy. Zęby dokładnie pasują do pyska.
• Bez unoszących się nakryć głowy. Kapelusze siedzą na głowie z cieniem kontaktowym; duże uszy wychodzą na rondo.
• Ubrania zwykle źle leżą na zwierzętach. Wybieraj obroże, łańcuchy i ozdoby na szyję i sprawdź je na każdej skórze.
• Wyjątkowe unikaty są w pełni przemienione, z pasującymi tłami i bez obroży.

Konektor sprawdza grafiki w chwili ich przesłania. Błędy odrzucają przesłanie: inny rozmiar płótna, warstwa nad tłem, która nie jest PNG z przezroczystością, obraz bez widocznych pikseli. Ostrzeżenia wracają do Twojej oceny: cecha poza swoją ramką kotwiczenia, cecha w innej skali niż jej warstwa, cecha poza siatką pikseli bazy, cecha, która wciąż zawiera obraz bazy w całości lub w części, cecha pokrywająca całe płótno. Jedno ostrzeżenie może być fałszywe: naturalne oczy w tej samej warstwie co okulary przeciwsłoneczne celowo mają inny rozmiar. Agent ustawia mixedScales na tej warstwie albo acknowledge na cesze, gdy się zgodzisz, a grafiki zostają takie, jakie powinny być.

Co agent odczytuje

Każde narzędzie weryfikujące zgłasza wszystkie problemy naraz na jednej liście issues, każdy ze ścieżką, kodem, wagą, komunikatem i sposobem naprawy. Nieznany klucz zostaje odrzucony z nazwy, wraz z najbliższym poprawnym. Sieć jest nazwana (base-sepolia, solana-devnet, solana-localnet), a szkic bez niej korzysta z Base Sepolia i o tym informuje. Metody sprzedaży mają nazwy ze strony (fixed, mystery, rising, falling, auction): przez konektor Base oferuje fixed, mystery i rising, Solana oferuje fixed i rising, a sprzedaże falling i auction konfiguruje się na stronie. Pole sprzedaży, którego sieć nie ma, na przykład symbol w Solana, zostaje odrzucone z nazwy. Metadane są sprawdzane automatycznie: każde NFT przestrzega reguł, unikat trafia na NFT, do którego jest przypięty, a pusta warstwa jest zapisywana jako {"trait_type": "<layer>", "value": "None"}.

Gotowe NFT

NFT, które już istnieją jako gotowe obrazy, pomijają warstwy: kurv_finished_art_limits, potem kurv_upload_finished_file_part dla każdego obrazu i pliku metadata.json, potem kurv_import_finished_collection. Bajty są zachowywane w przesłanej postaci, łącznie z animacją, a limity warstw nie obowiązują; obowiązują aktualne limity publikacji na stronie. Pliki opisuje strona Dodaj gotowe grafiki.

Znane ograniczenia tej wersji

• Wartości sprzedaży Solana w wersji 2 są sprawdzane przez własny parser aplikacji po kluczach, pojedynczo; sprzedaż w wersji 3 zgłasza wszystkie problemy naraz.
• Szkicu z gotowymi grafikami nie można edytować na miejscu; poprawka to nowe przesłanie i nowy klucz.
• Zarchiwizowanego szkicu nie można przywrócić przez konektor; jego grafiki są przechowywane 30 dni.
• Robinhood Chain nie jest dostępny przez konektor: brak konfiguracji sieci i schematu sprzedaży. Pojawi się po wypuszczeniach na Base i Solana.

Wartości kolekcji to migawki, a wypuszczenie przenosi prawdziwą wartość w swojej sieci; zanim komukolwiek doradzisz w sprawie pieniędzy, przeczytaj Ryzyka i zastrzeżenia.