Graphify:用Claude Code一键生成代码库知识图谱,支持交互式HTML和Obsidian输出

Graphify 是一个 Claude Code 专用的 skill,能让你的 AI 助手具备生成代码库知识图谱的能力。它支持多模态分析,可以生成交互式 HTML 知识图谱和 Obsidian 知识库,帮助开发者从宏观角度理解复杂的代码库。

项目是什么

在大型代码库中,理解模块之间的关系、依赖结构和架构设计是一个巨大的挑战。传统的代码阅读方式是逐文件浏览,效率低下且容易迷失在细节中。

Graphify 的思路完全不同:它让 Claude Code 自动扫描整个代码库,识别关键模块、类、函数和它们之间的关系,然后生成一个可视化的知识图谱。你可以在浏览器中交互式地浏览这个图谱,点击节点查看详情,拖拽探索依赖关系。

核心功能

1. 自动代码分析

Graphify 会自动分析代码库的结构,识别:

  • 模块和包的层次结构
  • 类和接口的继承关系
  • 函数调用关系
  • 依赖导入关系
  • 配置文件和数据流

2. 多模态输出

Graphify 支持两种输出格式:

交互式 HTML 知识图谱:在浏览器中打开,支持缩放、拖拽、搜索和点击查看详情。节点大小反映重要性,连线粗细反映依赖强度。

Obsidian 知识库:生成 Markdown 格式的知识库文件,可以在 Obsidian 中打开,利用 Obsidian 的双向链接和图谱视图来浏览代码关系。

3. 多语言支持

Graphify 支持分析多种编程语言的代码库,包括 Python、JavaScript/TypeScript、Java、Go、Rust 等主流语言。

4. 智能摘要

除了结构化的知识图谱,Graphify 还会生成代码库的智能摘要,包括:

  • 项目整体架构概述
  • 核心模块的功能说明
  • 关键设计模式的识别
  • 潜在的架构问题提示

如何使用

Graphify 作为 Claude Code 的 skill 使用,安装和配置非常简单:

# 在 Claude Code 中安装 skill
/install-skill safishamsi/graphify

# 使用 skill 分析当前项目
/graphify

# 指定输出格式
/graphify --format html
/graphify --format obsidian

分析完成后,Graphify 会在当前目录生成知识图谱文件。HTML 文件可以直接在浏览器中打开,Obsidian 文件可以用 Obsidian 打开。

适合场景

  • 项目接手:接手新项目时,用 Graphify 快速了解代码库的整体架构
  • 代码审查:在审查大型 PR 时,用知识图谱理解变更的影响范围
  • 架构文档:自动生成代码库的架构文档,省去手动绘制的麻烦
  • 技术债分析:通过知识图谱识别复杂的依赖关系和潜在的技术债
  • 团队协作:新成员入职时,用知识图谱快速熟悉项目结构
  • 重构规划:在重构前用 Graphify 分析依赖关系,规划重构路径

与其他工具的对比

特性 Graphify Sourcegraph CodeSee
AI 驱动 部分 部分
本地运行
知识图谱
Obsidian 输出
免费使用 部分 部分

注意事项

  • Graphify 需要 Claude Code 环境,使用前请确保已安装 Claude Code
  • 分析大型代码库可能需要较长时间,建议先从小项目开始体验
  • 生成的知识图谱质量取决于代码库的结构清晰度
  • 对于超大型项目(百万行以上),可能需要分模块分析

简评

Graphify 是一个非常有创意的工具。它把 AI 的代码理解能力和知识图谱的可视化能力结合在一起,为开发者提供了一种全新的代码库理解方式。

对于经常需要接手新项目或审查大型代码库的开发者来说,Graphify 能显著提升效率。特别是 Obsidian 输出功能,让代码知识可以和个人笔记系统无缝集成。

项目地址:https://github.com/safishamsi/graphify

© 版权声明
THE END
喜欢就支持一下吧
点赞6 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容