根本原因:cocos_component.set_property(spriteFrame, 'atlas-common/00010.png') 写入了 ImageAsset 路径形式,导致 importer 报 'Cannot read _name'。 正确做法:用 SpriteFrame 的真实 UUID (含 @f9941 sub-asset 后缀)。 修复前: __uuid__ = 'atlas-common/00010.png@f9941' (路径,importer 拒绝) 修复后: __uuid__ = 'dcc4530b-344b-40b6-8fbb-9fa35db6a289@f9941' (真UUID) 教训:cocos-mcp-server 的 spriteFrame value 参数期望 SpriteFrame UUID, 不是 ImageAsset 路径。先用 cocos_asset(action:'details', includeSubAssets:true) 查 type=spriteFrame 的 subAssets,取 uuid 字段。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
framework — 框架真源(唯一权威副本)
各子游戏工程的 assets/framework 是指向本目录的 junction(见 scripts/setup-links.mjs)。
六层结构(依赖严格单向,详见 spec §3):core / net / protocol / platform / ui / sdk。
协议相关实现一律以 docs/protocol/ 为唯一信息源(spec §0.1),不在代码或注释中内联复制协议字段。