SuperAPI AI 工具集

unity-csharp-navigate

通用与其它

查看项目

更新于 10-15 16:46

技能介绍

用途:在不修改文件的前提下浏览与搜索 Unity 项目中的 C# 源码,帮助理解和定位现有代码行为。它是 unity-csharp-edit 的只读配套工具,一旦请求涉及写入或新建文件,应转交编辑类工具;若任务依赖 Unity 场景状态而非源码,应改用 unity-scene-inspect。

适用时机:用户想查看脚本或理解现有 C# 行为;想知道某个符号在哪里定义或被引用;在改动前先搜索包或源码树。

推荐流程:先构建或刷新索引,再进行符号较多的查询;用 read 或 search 定位到正确文件;在目标标识符明确后使用 get_symbols、find_symbol、find_refs;结果集过大时收窄搜索路径或分页大小;问题可能涉及包而非项目源码时使用 list_packages。

常用命令示例: unity-cli raw read --json '{"path":"Assets/Scripts/Player.cs"}' unity-cli raw search --json '{"pattern":"OnCollisionEnter","path":"Assets/Scripts"}' unity-cli raw find_symbol --json '{"name":"PlayerController","kind":"class","scope":"assets"}' unity-cli raw find_refs --json '{"name":"Health","scope":"assets","pageSize":20}'

典型示例:读取 PlayerController.cs 并解释跳跃逻辑;查找项目脚本中 Health 的全部引用;列出已安装包并检查是否存在 Input System。

限制:仅为只读导航,不用于修改代码或创建新 C# 文件,也不用于依赖场景状态的任务。运行前需满足连接与实例等前置条件,相关说明见 runtime-checklist.md;索引策略、路径收窄与引用追踪指南见 code-search-playbook.md。具体平台与收费信息暂未提供。