合集蓝图

KURV 目前运行在 Base Sepolia 和 Solana Devnet 上。这一页是一次完整真实构建（HANI the Dog，1,000 件，20 件独特作品）留下的现场指南，写给通过 https://mcp.kurv.fun/mcp 的 KURV 连接器与 AI 智能体一起工作的创作者。连接器把同一份指南作为资源 kurv://blueprint 提供给智能体，工具 kurv_builder_spec 是依据：这一页与工具不一致时，以工具为准。

连接一个智能体

1. 在支持远程 MCP 和 OAuth 的客户端里，把 https://mcp.kurv.fun/mcp 添加为远程 MCP 服务器。用 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. 草稿。 带 version: 3、网络、配置、销售条款和幂等键调用 kurv_create_collection，先把 check_only 设为 true，再正式调用。失败的调用用同一个键重试。销售条款在每个网络上都是同一种形式：参见销售条款。
11. 素材。 用 kurv_upload_trait 逐张上传（先背景、基础和每个图层各一个特征，然后预览，再上传其余），或用 kurv_upload_collection_zip 以网页文件夹格式一次上传。空图层是 noneWeight，而不是透明 PNG。
12. 检查与预览。 带草稿调用 kurv_validate_collection 会运行素材检查。最后一次上传后，用 9 张样图调用 kurv_preview_collection，再加上每件独特作品和最冒险组合的作品编号。智能体查看每一张图。耗时较长的首次预览会回答 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 的规则会被拒绝并指出正确的键，而不是悄悄作用于整个图层。只有当某图层的 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、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，再对每张图片和 metadata.json 调用 kurv_upload_finished_file_part，然后 kurv_import_finished_collection。字节原样保留，包括动画，图层限制不适用；网站当前的发布限制适用。成品作品说明了这些文件。

这个版本的已知限制

• 版本 2 的 Solana 销售，其数值在键之后由应用自身的解析器逐项检查；版本 3 的销售会一次回答所有问题。
• 成品作品的草稿不能就地编辑；修正意味着新的上传和新的键。
• 归档的草稿不能通过连接器恢复；其素材保留 30 天。
• Robinhood Chain 无法通过连接器使用：没有网络配置，也没有销售 schema。它在 Base 和 Solana 发行之后到来。

合集数据是快照，一次发行会在其网络上转移真实价值；在就金钱给任何人建议之前，请先读风险与免责声明。