系列藍圖
KURV 目前在 Base Sepolia 和 Solana Devnet 上運作。這一頁是一次完整打造(HANI the Dog,1,000 件藏品,20 件獨特作品)留下的實戰指南,寫給透過 https://mcp.kurv.fun/mcp 上的 KURV 連接器和 AI 代理一起工作的創作者。連接器把同一份指南以資源 kurv://blueprint 提供給代理,而工具 kurv_builder_spec 是最終依據:這一頁和工具說法不一致時,以工具為準。
連接代理
「連接代理」段落- 在支援遠端 MCP 和 OAuth 的用戶端中,把
https://mcp.kurv.fun/mcp加為遠端 MCP 伺服器。用 MCP 連接代理列出了各個用戶端和它們的步驟。 - 在瀏覽器中登入 KURV 並核准連線。由你決定它能做什麼(唯讀;讀取和草稿;或讀取、草稿和發行準備),以及權限持續多久。
- 請代理讀取
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 百萬種以內時會精確計算,超過時則標示為估計值。讓它保持在系列規模之上,留有充裕的餘地。
路徑,一步一步來
「路徑,一步一步來」段落標示核准的步驟表示:代理會停下來,等你明確說好。
- 照片。 收集 3 到 10 張真實寵物或角色的清晰照片:臉、眼睛、牙齒和嘴巴、斑紋、耳朵。挑一張臉部呈四分之三側面的主照片。
- 美術方向。 一種風格、一個姿勢(四分之三側面效果最好)、一個正方形畫布(建議 2,048 × 2,048),以及一份簡短的風格表:線條、陰影、配色、氛圍。**核准:**在製作任何特徵之前,先確定主角色。
- 主底稿。 角色以最終姿勢畫在平整的單色背景上,置中、填滿整個畫布,一眼就能認出是那隻真實的寵物。每個特徵都是對這份主底稿的修改,姿勢、比例和構圖都相同。
- 圖層。 圖層由下往上繪製:Background、Skin(基礎圖層)、Collar、Teeth、Eyes、Headwear(可選)。大約六個圖層;撐起系列的是角色,不是道具。代理會在
base_layer中寫明基礎圖層,並為每個圖層指定一個錨點框,它的特徵必須落在框內。 - 特徵。 每個特徵都是對主底稿副本的修改,裁切到只剩特徵本身的像素可見,其他部分全部透明。在身體的單色副本上生成特徵,毛髮就不會混進去。位置或比例跑掉的特徵會被拒絕。
- 獨特作品。 整個身體徹底變身(鑽石、鍍鉻、熔岩、青銅),各自搭配相稱的背景,而且不戴項圈。它們的圖以權重為 0 的特徵放進對應的圖層,所以永遠不會出現在隨機藏品中;但會計入那 240 張圖片。
- 規則。 把每種皮膚和每個項圈、牙齒、眼睛和頭飾特徵組合成對照表。每個不好的組合(穿模、看不見、難看)都變成一條分組的排除規則,並附上說明原因的備註。
- **核准:**建立草稿之前,先審過圖層表、至少 9 張合成樣本、獨特作品表、設定和銷售條款。
- 設定與驗證。 帶著網路呼叫
kurv_builder_spec,接著帶著設定呼叫kurv_validate_collection,直到它的issues清單中沒有任何錯誤。警告會點出你應該知道的事。回應中會有required_assets(要上傳的確切鍵)和validCombinations。 - 草稿。 帶著
version: 3、網路、設定、銷售條款和冪等鍵呼叫kurv_create_collection,先把check_only設為 true,再正式呼叫。失敗的呼叫用同一個鍵重試。銷售條款在每個網路上都是同一種格式:請參閱銷售條款。 - 作品。 用
kurv_upload_trait一次上傳一張(先上傳背景、基礎圖層,以及每個圖層各一個特徵,然後預覽,再上傳其餘的),或用kurv_upload_collection_zip以網站的資料夾格式一次全部上傳。空的圖層是noneWeight,絕不是透明的 PNG。 - 檢查與預覽。 帶著草稿呼叫
kurv_validate_collection會執行作品檢查。最後一次上傳後,用 9 張樣本呼叫kurv_preview_collection,再加上每件獨特作品和最可能出問題的組合的藏品編號。代理會看過每一張圖。如果第一次預覽耗時較長,會回應retry_after和還在處理的樣本;代理會再呼叫一次。 - 不用新草稿的修正。
kurv_update_collection可以直接修改規則、獨特作品、權重、提示或描述;畫布不能改。kurv_replace_trait_image替換一張圖片,kurv_rename_trait重新命名特徵並更新它的規則和獨特作品,kurv_delete_trait刪除沒有被任何地方引用的特徵。然後再預覽一次。 - **核准:**最終樣本和每一則警告,逐一念給你聽。
- 準備。 帶著草稿呼叫
kurv_prepare_launch。收到warnings_need_review時,代理會解釋每一則警告;只有在你接受之後,它才會把acknowledge_warnings設為 true 再呼叫一次。你會拿到一個瀏覽器連結。 - 由你簽署。 開啟那一個連結,檢查填好的內容,選擇 發布並發行,然後在最後一步用你自己的錢包簽署。每一個答案都只差一次「返回」就能修改。沒有任何工具會替你簽署。
規則
「規則」段落規則讓兩個圖層的特徵分開或一起出現:{"type", "when", "target", "note"},其中 type 是 exclude 或 require,when 和 target 各指定一個圖層,也可以再指定特徵:一個名稱或一組名稱。沒有指定特徵就代表整個圖層,而 when 和 target 必須是不同的圖層。鍵是 trait:寫成 traits 的規則會被拒絕,並指出正確的鍵,而不是默默套用到整個圖層。只有在某個圖層的 noneWeight 大於 0 時,None 才能代表該圖層為空。把成對的組合歸成清單,才能維持在 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),沒有指定網路的草稿會使用 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,再為每張圖片和 metadata.json 呼叫 kurv_upload_finished_file_part,然後呼叫 kurv_import_finished_collection。檔案的位元組會原封不動保留,包括動畫,分層的限制不適用;網站目前的發布限制則適用。成品作品說明了這些檔案。
這個版本的已知限制
「這個版本的已知限制」段落- 版本 2 的 Solana 銷售,數值是在檢查完鍵之後,由應用程式自己的解析器逐一檢查;版本 3 的銷售會一次回應所有問題。
- 成品作品的草稿無法直接修改;要修正就得重新上傳,並使用新的鍵。
- 封存的草稿無法透過連接器還原;它的作品會保留 30 天。
- 應用程式提供的每個網路,都透過連接器開放,步驟相同,並由
kurv_networks列出。應用程式沒有提供的網路會被點名拒絕。
系列數據都是快照,而一次發行會在它的網路上移動真實的價值;在就金錢向任何人提供建議之前,請先閱讀風險與免責聲明。
此處內容均不構成財務建議。在鑄造、購買或賣回之前,請先閱讀風險與免責聲明。返回 kurv.fun。隱私權政策。使用條款。 。