用途:MSW Search 面向 MSW 开发,解决两类检索需求。一是 API 文档与实现指南的向量搜索,用于补充 .d.mlua 中缺失的详细描述、代码示例、相关 API 与实现模式;二是资源检索 REST API,用于查找精灵、动画、音效、资源包与角色外观资源,也是获取 RUID 的唯一途径,禁止猜测或编造 RUID。
主要能力:文档侧提供 mlua_api_retriever(按 API/类/函数/组件名查签名、参数、示例)与 mlua_document_retriever(按自然语言描述查手册、指南、最佳实践)。资源侧提供 searchResources、searchAvatarItems、findSimilarResources、getResource、getResourcesBatch、getResourceTags、listResources、randomResources、findPacksContaining、listAvatars、getAvatarDefaults 等函数,对应 /v3 系列端点。
使用方式:文档检索优先读 .d.mlua 确认签名与类型,不足时再调用 MCP 工具,默认请求 3 条结果。资源检索统一通过 Node.js 包装脚本 scripts/msw_resource_api.cjs 调用,避免手工拼 curl;支持 CLI 与 require 两种用法,例如 node scripts/msw_resource_api.cjs search "orange mushroom" --resource-type resource_pack --category npc --topK 3。默认资源类型为 resource_pack,先选包再下钻 payload.elements 分配单个 RUID。
适用场景:确认方法签名、属性类型、事件参数、枚举值;查找代码示例、参数细节、相关 API;按语义查找未知 API 名;查找精灵、动画、音效、资源包、角色外观;查询 RUID 详情与相似资源;上传、列出、更新、删除自有资源;设置精灵轴心、九宫格边界等资源属性。
限制:.d.mlua 仅含签名,详细描述与示例需向量搜索。搜索结果中的 Maker Editor 语法需转换为 .mlua(override→method、花括号→end、int→integer 等)。覆写方法的 @ExecSpace 必须与父类完全一致,否则触发 LEA-3014 SignatureMismatch。SpriteRendererComponent.SpriteRUID 接受 sprite 与 animationclip 但渲染不同,赋值前需检查 payload.type。skeleton 与 avataritem 的 RUID 赋给 SpriteRUID/ImageRUID 时需 thumbnail:// 前缀,而 CostumeManagerComponent 等字段不接受该前缀。offset 为不透明字符串游标,首页不可传整数 0。MCP 调用失败应向用户说明并回退到 .d.mlua,不得猜测。