用途:Graphify Query 面向已经启用 Graphify 的项目,用于查询项目内的知识图谱(位于 graphify-out/)。这些图谱包含 god 节点、社区结构和跨文件关系,可帮助回答代码库相关问题以及进行架构导航。
主要能力:
- 查询知识图谱中的架构信息、god 节点、社区结构与跨文件关系。
- 提供范围受限的子图结果,通常比 GRAPH_REPORT.md 或直接使用 grep 的输出更小、更聚焦。
- 支持路径查询(graphify path "<A>" "<B>")与概念解释(graphify explain "<concept>")。
- 当存在 graphify-out/wiki/index.md 时,可用于大范围导航,替代直接浏览源码。
使用方式:
- 如果当前会话已提供 Graphify MCP 工具(例如 graphify_query、similar),优先直接调用,而不是通过 shell 调用;这样结果相同,并且不会额外启动进程。
- 如果当前会话没有 MCP 工具,并且 graphify-out/graph.json 存在,可以先运行 graphify query "<question>" 来回答代码库问题;可以用 graphify path "<A>" "<B>" 查询关系,用 graphify explain "<concept>" 查看聚焦概念。
- 只有在进行大范围架构审查,或 query、path、explain 返回的上下文不足时,才读取 graphify-out/GRAPH_REPORT.md。
- 修改代码后,运行 graphify update . 更新图谱;该过程仅使用 AST,不产生 API 成本。
适用场景:在 Alethe 编排的 Claude Code、Codex、OpenCode 三类代理环境中,如果项目启用了 Graphify,每个会话都会自动接入 Graphify MCP 服务器:Claude 通过 --mcp-config 接入,Codex/OpenCode 通过项目根目录下的 .codex/config.toml 或 opencode.json 接入。此时该技能适用于代码库问答、架构导航和跨文件关系查询。
限制:资料未提供收费、价格、平台要求或效果方面的信息;其能力依赖项目已启用 Graphify,并且存在 graphify-out/ 知识图谱及相应文件。