Graphify 技术深度指引
Graphify 是什么
Graphify 是一个将代码、文档、PDF、图片和视频转化为 AI 编码助手可查询知识图谱的工具/skill。根据 guide，它在 FDE 知识库 v2 中承担知识图谱驱动能力。
为什么适合 FDE
| FDE 痛点 | Graphify 对应能力 |
|---|
| 团队使用不同 AI 编码助手 | 一次构图，多平台查询 |
| 新人不熟悉代码和文档结构 | 用图谱追踪模块、概念和路径 |
| Code Review 缺少上下文 | PR 影响分析 |
| Token 消耗高 | 用结构化图谱减少重复读取 |
| 知识分散 | 将多模态资料转成统一关系图 |
三流水线架构
输入：code / docs / pdf / images / mp4
Pass 1: Code Structure
Tree-sitter AST，本地离线解析代码结构
Pass 2: Video/Audio
本地转写音视频
Pass 3: Docs/Images
语义提取文档与图片
汇总：
NetworkX 图谱 + Leiden 社区检测
输出：
graph.html
GRAPH_REPORT.md
graph.json
快速命令卡
brew install python@3.12 uv
uv tool install graphifyy && graphify install
# before first run, add .graphifyignore to the project root
/graphify .
graphify query "what connects auth to DB?"
graphify path LoginForm users_table
graphify explain AuthService
graphify prs --triage
graphify hook install
graphify export callflow-html
输出三件套
| 文件 | 用途 |
|---|
graph.html | 浏览器打开的交互式图谱 |
GRAPH_REPORT.md | 节点发现和结构报告 |
graph.json | 持久化可查询图数据 |
置信度标签
| 标签 | 含义 |
|---|
EXTRACTED | 从代码或文件中直接提取 |
INFERRED | 由模型推理得出 |
AMBIGUOUS | 不确定，需要人工复核 |
在 FDE 交付中的使用方式
- 作为企业知识库项目的首构图工具。
- 作为代码库 onboarding 的交付物。
- 作为 PR triage 和影响分析工具。
- 作为 GraphRAG 或知识问答系统的数据准备层。
- 作为 FDE 自身知识库的结构化索引能力。
运维要点
.graphifyignore 建议
每个客户项目都应在运行 /graphify . 前建立 .graphifyignore，避免扫描 node_modules、build outputs、缓存、密钥和大型媒体文件，降低索引时间和泄露风险。
模板见 graphifyignore-template。