Graphify - AI 编程助手知识图谱技能¶

一句话定位：把任意文件夹变成可查询的知识图谱，让 AI 编程助手理解代码库的结构和设计决策，查询 token 消耗降低 71.5x。

核心解决的问题¶

• AI 编程助手面对大型代码库时，每次都要重新读取全部文件，token 消耗巨大
• 代码、文档、论文、截图、视频等异构素材之间缺乏关联
• 无法追溯"为什么这样设计"，只知道"代码做了什么"

Graphify 解决这三个问题：提取结构 → 建立关联 → 持久化图谱，后续查询只读压缩后的图谱而非原始文件。

主要功能与特性¶

工作原理（三遍扫描）¶

Pass 1: AST 扫描（本地，无 LLM）
  tree-sitter 解析代码文件 → 类/函数/import/调用图/docstring/设计注释

Pass 2: 视频/音频转录（本地，无 LLM）
  faster-whisper 转录 → 领域感知 prompt（从语料 god nodes 生成）

Pass 3: 语义提取（LLM 子代理并行）
  Claude/GPT 子代理处理文档、论文、图片、转录文本
  → 提取概念、关系、设计决策
  → 合并到 NetworkX 图
  → Leiden 社区发现
  → 输出 HTML + JSON + 报告

技术栈¶

仓库结构¶

graphify/
├── detect.py      # 文件发现与过滤
├── extract.py     # AST + LLM 提取（核心）
├── build.py       # 构建 NetworkX 图
├── cluster.py     # Leiden 社区发现
├── analyze.py     # God nodes、惊奇连接、建议问题
├── report.py      # 生成 GRAPH_REPORT.md
├── export.py      # HTML/JSON/Obsidian/SVG/GraphML/Neo4j 导出
├── ingest.py      # URL 拉取（论文、推文、视频）
├── cache.py       # SHA256 增量缓存
├── security.py    # 输入验证（URL/路径/标签）
├── validate.py    # 提取结果 schema 校验
├── serve.py       # MCP stdio server
├── watch.py       # 文件监听自动重建
├── wiki.py        # Wikipedia 风格 markdown 输出
├── benchmark.py   # Token 压缩基准测试
└── skill*.md      # 各平台 skill 定义文件

支持平台¶

安装与使用¶

# 安装（PyPI 包名是 graphifyy，双 y）
pip install graphifyy && graphify install

# Hermes 平台
graphify install --platform hermes
graphify hermes install    # always-on

# 基本使用
/graphify .                              # 当前目录
/graphify ./raw --mode deep              # 深度推断
/graphify ./raw --update                 # 增量更新
/graphify ./raw --obsidian               # 输出到 Obsidian vault
/graphify ./raw --watch                  # 文件变更自动重建

# 查询
/graphify query "show the auth flow"
graphify query "what is CfgNode?" --budget 500
graphify path "DigestAuth" "Response"
graphify explain "SwinTransformer"

# 添加内容
/graphify add https://arxiv.org/abs/1706.03762
/graphify add <video-url> --author "Name"

# MCP Server
python -m graphify.serve graphify-out/graph.json

# Git Hooks
graphify hook install     # post-commit + post-checkout 自动重建

性能数据¶

安全与隐私¶

输出文件¶

graphify-out/
├── graph.html       # 交互式图谱（浏览器打开，点击节点、搜索、按社区过滤）
├── GRAPH_REPORT.md  # God nodes、惊奇连接、建议问题
├── graph.json       # 持久化图谱（JSON，可 MCP server 查询）
└── cache/           # SHA256 缓存（增量更新用）

Roadmap¶

• Penpax — 企业层，持续后台运行，连接浏览器历史/会议/邮件/文件/代码，全本地，无云。面向律师、顾问、高管、医生、研究员。Free trial 即将上线。

参考资料¶

• GitHub 仓库
• PyPI 包 (注意双 y)
• Penpax 等待列表

相关笔记¶

• [[LLM Wiki]] - 知识管理相关
• [[Hermes Agent]] - 同类 AI 编程助手平台