十年匠心定制 · 商业建站与技术教学双线并行 咨询热线:400-886-1026 service@lmnt.cn
ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

graphify --cluster-only实战:不重新提取也能调整社区划分粒度

graphify --cluster-only实战:不重新提取也能调整社区划分粒度 graphify --cluster-only实战不重新提取也能调整社区划分粒度【免费下载链接】graphifyTurn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.项目地址: https://gitcode.com/GitHub_Trending/graph/graphifygraphify可以把代码库连同文档、SQL、配置一起变成可查询的知识图谱而它的cluster-only子命令能让你跳过耗时的重新提取只对已有的graph.json重跑社区划分Leiden/Louvain 聚类快速调整社区粒度并同步刷新 graphify/report.py 生成的 GRAPH_REPORT.md。这篇文章用最短路径带你跑通这个命令。为什么需要 cluster-only一次完整的graphify extract .要解析代码、调用 LLM 标注语义边对大型仓库可能耗时很久。但很多时候你只是想换一种社区粒度来看架构比如报告里的社区太碎几十个社区难以通读或者相反某个上帝社区把不相关的子系统搅在一起想验证不同--resolution值对社区数量的影响又不想反复消耗 token。这些场景都不需要重新提取。cluster-only直接加载现成的图重跑聚类、重算凝聚度、重新生成报告和graph.html全程本地确定性执行不调用 LLM除非你显式要求重新命名社区。一键执行基本命令前提是项目里已经有一次graphify extract .的产物graphify-out/graph.jsongraphify cluster-only .输出会告诉你加载了多少节点和边例如Graph: 1284 nodes, 3902 edges然后依次完成重聚类 → 复用上轮社区标签 → 生成 GRAPH_REPORT.md → 更新 graph.json 和 graph.html。常用组合示例# 大图跳过 HTML 可视化适合 CI 或节点数 5000 的项目 graphify cluster-only . --no-viz # 图不默认位置时用 --graph 指定 graph.json graphify cluster-only . --graph backup/graph.json --no-viz # 只看耗时分布 graphify cluster-only . --timing调整粒度的核心开关--resolution--resolution是控制社区划分粒度最直接的参数对应 graphify/cluster.py 中_partition函数的 resolution 参数参数值效果--resolution 0.5社区更少、更大适合快速通读全局架构--resolution 1.0默认值均衡粒度--resolution 2.0社区更多、更细适合深挖某个模块的边界# 合并成更大的社区 graphify cluster-only . --resolution0.5 --no-viz # 拆得更细 graphify cluster-only . --resolution2.0 --no-viz经验做法先跑0.5看全局再逐步升到1.5、2.0观察哪些子系统被拆出来。由于不重新提取一轮试错通常只要几秒到几分钟。另外两个辅助开关值得知道--exclude-hubs百分位在聚类前排除最高连接的 hub 节点避免万能节点比如全局配置文件把不相干的模块焊死在一个社区里--min-community-sizeN控制社区命名的最小规模默认 3。社区标签会保留吗会而且比想象中更聪明。cluster-only会通过节点重合度把新社区 ID 映射回旧 IDremap_communities_to_previous让已保存的 LLM 社区名尽量粘在同一个概念社区上用成员指纹每个社区成员 ID 的哈希存于.graphify_labels.json.sig校验社区成员没变的直接复用旧标签成员变了或社区数量变了自动用该社区度最高的枢纽节点名字临时顶替并提示你运行graphify label用 LLM 重新命名如果你显式传了--backend/--model但实际复用了旧标签终端会给出明确 warning而不是假装重命名过。只想改名字而不重聚类时用专门的label命令即可# 只补命名缺失/占位的社区 graphify label . --missing-only --backendopenai常见问题速查症状原因与解法error: no graph found该路径下没有graphify-out/graph.json先跑一次graphify extract .传了--backend却提示被忽略存在旧标签文件本次是复用而非重新标注用graphify label强制重命名报告/标签正常但 graph.json 没变触发了节点数缩水保护shrink guard属预期行为确认后用--force语义的update流程处理HTML 太大打不开加--no-viz节点数超过上限时也会自动回退到社区聚合视图小结graphify cluster-only是架构探索的轻量档不重新提取——直接复用 graph.json省时间省 token--resolution调粒度——大于 1 拆细、小于 1 合并标签自动续接——成员指纹保证改名不串位需要时再graphify label刷新。配合 GRAPH_REPORT.md 里的社区列表和凝聚度分数你可以快速在全局概览和模块深挖之间切换视角而不必为一次视角调整付出重新构建的代价。【免费下载链接】graphifyTurn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.项目地址: https://gitcode.com/GitHub_Trending/graph/graphify创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表