用途 SpriteCook Upload Assets 用于将本地图片文件上传到 SpriteCook，并得到一个可复用的 asset_id。当用户给出一个本地文件路径、且该图片需要成为 SpriteCook 资产时，使用此技能。它通过 MCP 完成上传，不需要 API 密钥，也不会产生 base64 日志。建议与 spritecook-workflow-essentials 搭配使用，以处理凭据安全、清单（manifests）和下游资产复用。
主要能力
- 将本地图片文件上传为 SpriteCook 资产，返回 asset_id。
- 支持指定 file_name、MIME content_type、可选的 size_bytes，以及 pixel 是否为 true。
- 提供 create_asset_upload、finalize_asset_upload 等 MCP 工具调用流程。
- 支持在图片已是小型 data URL 或 base64 值时使用 import_asset(image=...) 进行内联导入。
- 支持上传后的资产在后续 SpriteCook 工具中复用。
使用方式（首选流程）
- 检查本地文件路径，但不打印文件字节。
- 确定 file_name、MIME content_type、可选的 size_bytes，以及 pixel 是否应为 true。
- 调用 create_asset_upload(file_name=..., content_type=..., pixel=..., size_bytes=...)。
- 使用返回的 upload_url 和返回的 headers，通过 HTTP PUT 上传文件字节。
- 调用 finalize_asset_upload(upload_token=...)。
- 在下一个 SpriteCook 工具中使用返回的 asset_id。
上传 URL 和 token 是短时效密钥。不要在面向用户的文字中打印它们，不要保存到项目文件，也不要写入清单。
Windows PowerShell 模式 在 Windows 上，可不上传打印字节： Invoke-WebRequest -Method Put -Uri $uploadUrl -InFile $path -ContentType $contentType | Out-Null 对 $uploadUrl、$path 和 $contentType 使用变量；如果它们包含上传 token，不要回显。
何时使用内联导入 仅当图片已经是小型 data URL 或 base64 值、且可以直接传递而不记录日志时，才使用 import_asset(image=...)。不要使用会把 base64 打印到终端的 shell 命令。如果必须编码，请将值保存在内存或私有变量中，并直接传给 MCP 工具。
复用已上传资产
- 当上传的资产是一个特定来源或上下文图片时，使用 reference_asset_id。
- 仅当上传的资产是正在被直接修改的那张图片时，使用 edit_asset_id。
- 当上传的资产是环境风格指南时，在 generate_game_art 上使用 style_asset_ids；最多传 10 个 ID。
- 在 generate_tileset 上使用 style_asset_id，用于一张 tileset 风格指南图片。
- 当上传的资产是要动画化的源图时，在 animate_game_art 上使用 asset_id。
- 当工作区可写时，将返回的 asset_id 和本地文件哈希保存到项目清单中。
适用场景
- 用户提供本地图片路径，希望将其转为 SpriteCook 资产。
- 需要在不暴露 API 密钥、不产生 base64 日志的情况下上传图片。
- 上传后的资产需要作为参考图、编辑对象、风格指南或动画源图，在后续 SpriteCook 工具中复用。
限制
- 上传 URL 和 token 为短时效密钥，不应打印、保存到项目文件或写入清单。
- 内联导入仅适用于小型 data URL 或 base64 值，且不得记录日志。
- 不要使用会向终端打印 base64 的 shell 命令。
- 关于收费、价格、平台支持范围等具体信息，资料中暂未提供。