用途:当本地图片文件需要变成可复用的 SpriteCook asset_id 时使用本技能。建议与 spritecook-workflow-essentials 配合,以处理凭据安全、清单和下游素材复用。
主要流程:先检查本地文件路径,但不打印文件字节;确定 file_name、MIME content_type、可选 size_bytes,以及 pixel 是否为 true;调用 create_asset_upload(file_name=..., content_type=..., pixel=..., size_bytes=...);用 HTTP PUT 将文件字节上传到返回的 upload_url,并带上返回的 headers;调用 finalize_asset_upload(upload_token=...);在下一个 SpriteCook 工具中使用返回的 asset_id。
安全限制:upload URL 和 token 是短期有效的机密,不要打印在面向用户的文字中,不要保存到项目文件,也不要写入清单。
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 传一张图块集风格参考图;在 animate_game_art 上,当上传素材是待动画源图时用 asset_id。工作区可写时,将返回的 asset_id 和本地文件哈希保存到项目清单。