SuperAPI AI 工具集

generate-editor-search-query

编程与开发

查看项目

更新于 10-16 02:33

技能介绍

用途:把“帮我找/筛选/列出某类资源或场景对象”等自然语言请求翻译成简洁的 Unity Search(Quick Search)查询,向用户展示该查询,并在合适时打开 Unity Search 窗口。若提示明确提到 Unity Search、Quick Search、Search 窗口或要求某个查询,即使目标属于光照、UI、物理、音频、动画等领域,也由本技能处理。

主要能力:判断请求针对项目资源、场景对象还是两者;生成单一简洁查询;优先使用类型过滤器(如 t:material、t:texture、t:prefab、t:scene、t:script、t:shader、t:Light、t:Rigidbody);用户给出的名称与关键词按普通词保留;使用 dir:、l:、ref= 等限定;必要时使用 Search 表达式(如 t:prefab ref={t:texture});通过 Editor 端代码片段打开 Search 窗口。范围仅限只读查询,覆盖材质、纹理、预制体、场景、脚本、着色器等资源,以及相机、灯光、Rigidbody、Canvas、UI、ParticleSystem、AudioSource、Animator、Terrain 等场景对象与组件。

使用方式:生成非平凡查询前阅读 references/query-patterns.md,打开窗口前阅读 references/open-search-window.md。打开时对查询做 UTF-8 Base64 编码,在 C# 片段内解码;注意 eval 编译的是语句块而非文件,不能写 using 指令(会报 CS0210),类型需完全限定(如裸 SearchService 报 CS0246,裸 Object 与 object 歧义报 CS0104)。打开 Search 依赖 unity-cli 技能提供的环境与 eval 命令;若不可用,则只给出查询文本并说明无法打开窗口。

适用场景:查找、定位、列出、筛选具名资源或场景对象,按路径、标签、类型、文件名、关键词或引用关系搜索,处理对话中已有的已选资源名称或路径。

限制:不安装包、不执行菜单命令、不编辑资源或场景、不搜索外部文档或仓库文本、不检查构建日志、不删除或修复结果、不做依赖图分析;对结果的操作须先确认。用户说“不要打开”“只要查询”等时不打开窗口并仅提供查询。属于项目概览、架构讲解或“怎么做”类编程问题时不使用本技能。指代“这个/当前/所选”但无明确名称或路径时,先询问而不臆造;遇到无法可靠表达的请求,使用最接近的安全查询并说明限制。不得在命令失败时声称窗口已打开。官方参考包括 Unity Search、Search expressions、SearchService.ShowWindow、Passing C# to eval。