用途:graphify-dotnet 用于对代码仓库做结构化发现、架构评审、新人上手和依赖发现,生成知识图谱与架构快照。触发场景包括 graphify run、watch、benchmark、config,以及生成 graph.json、graph.html、graph.svg、graph.cypher、GRAPH_REPORT.md、obsidian/、wiki/ 等产物。
主要能力:支持仅 AST 提取与 AI 增强语义提取两种模式;生成知识图谱与 Louvain 社区划分;可导出为人类审阅(graph.html、GRAPH_REPORT.md)、自动化(graph.json)、静态文档(graph.svg)、知识库(obsidian/、wiki/)和 Neo4j 查询(graph.cypher)。
使用方式:先安装并验证:dotnet --version、dotnet tool install -g graphify-dotnet、graphify --version。建议先做有界的 AST-only 运行:graphify run ./src --format json,html,report --provider none --verbose。按 GRAPH_REPORT.md、graph.html、graph.json 顺序查看。需要推断关系时再启用 AI 增强。导出示例:graphify run ./src --format json,neo4j,svg,obsidian,wiki --output ./graphify-out。已有 graph.json 后可运行 graphify benchmark ./graphify-out/graph.json。配置优先级为 CLI 参数、用户机密、环境变量、appsettings.local.json、appsettings.json;可用 graphify config 向导和 graphify config show 查看。Provider 可选 none、ollama、azureopenai、copilotsdk。
适用场景:架构快照、依赖发现、新人上手地图、CI 产物、Neo4j 图查询、Obsidian/wiki 知识库。
限制:AST-only 无法推断语法中不存在的概念链接;AI 增强增加延迟、Provider 配置、配额与隐私审查;watch 模式删除文件需干净重建,重命名可能临时重复节点;大图 graph.html 渲染慢,file:// 可能被浏览器阻止;graphify 遵循 .gitignore,空图可能是路径选择问题;benchmark 为启发式估算,非精确计费。验证需 .NET 10 SDK,graphify --version 可解析,运行无 Provider 或路径错误,输出目录含预期产物。