用途:当需要深入理解代码库中某个具体文件、函数或模块时使用,提供详尽解释。
主要能力:基于知识图谱(knowledge-graph.json)定位目标节点,梳理其类型、摘要、标签与复杂度;通过边(edges)找出该节点的出向与入向连接,构建组件邻域;识别其所属架构层;再读取实际源码做深入分析。最终解释组件在架构中的角色、内部结构(包含的函数与类)、外部连接(导入、被调用、依赖关系)以及数据流(输入→处理→输出),并尽量用不依赖特定编程语言的方式说明,突出值得理解的模式与惯用法。
使用方式:先确认 .understand-anything/knowledge-graph.json 存在,若不存在需提示用户先运行 /understand。随后用 Grep 在知识图谱中搜索目标组件:文件路径按 filePath 匹配,函数写法如 src/auth/login.ts:verifyToken 则按 name 加文件路径过滤。记录节点 id、类型、摘要、标签、复杂度;再在 edges 中搜索该 id 的 source 与 target 匹配,得到连接节点与边类型;接着读取这些连接节点信息,并在 layers 中查找所属层;最后读取节点 filePath 对应的源码文件。
适用场景:代码库阅读、架构梳理、依赖分析、新人上手、代码评审前的背景理解。
限制:依赖已生成的知识图谱文件,缺失时无法工作;需按需读取图谱片段而非整体载入上下文;具体支持的语言、框架与图谱生成细节暂未提供。