SuperAPI AI 工具集

graphify

通用与其它

查看项目

更新于 10-16 09:28

技能介绍

用途:graphify 用于在关系查询有帮助时,查询 src 符号关系或跨项目依赖路径,例如回答架构类“X 如何连接到 Y”的问题、查找调用方、依赖方或跨项目路径,以及在陌生的 src/ 区域中定位。

主要能力:提供 query、path、explain、affected 等命令,分别用于提问、查找两节点路径、解释概念和查看受影响符号。规范图位于 docs/architecture/graphify-out/。

使用方式:优先使用仓库内二进制:G=.tools/graphify-venv/bin/graphify,GRAPH=docs/architecture/graphify-out/graph.json。若 venv 缺失,可执行 python3 -m venv .tools/graphify-venv 与 .tools/graphify-venv/bin/pip install -U pip graphifyy。命令示例:$G query "<question>" --graph "$GRAPH"、$G path "<A>" "<B>" --graph "$GRAPH"、$G explain "<concept>" --graph "$GRAPH"、$G affected "<symbol>" --graph "$GRAPH"。根目录可能存在 graphify-out → docs/architecture/graphify-out 的符号链接,使默认 CLI 路径可用。

人类可读入口:GRAPH_REPORT.md(枢纽/关键节点/建议问题)、GRAPH_TREE.html(轻量浏览器视图)、graph.html(完整力导向图,较大)。

重建:完整重建优先使用 scripts/update-graphify.sh,会限定到 src/ 并刷新图、树和符号链接。增量更新使用 $G update src,不要传 --graph,也不要传 .(整仓库根)。大型重构后优先完整重建。

限制:图或工具不可用或过期时,应改用源码检查;图查询是可选的,重要发现需对照当前源码核实。graphify <subcommand> --help 不可靠,仅使用顶层 graphify --help。其他细节暂未提供。