Graphify: превращаем кодовую базу в запросный граф знаний

Пошаговая инструкция по установке и запуску Graphify-Labs/graphify для локального построения графа знаний из кода, документации, SQL-схем и PDF без векторной базы.

Средний

Алексей Кузнецов

Системный администратор4 ноября 2026 г.2 мин чтения

node -v
npm install -g graphify

cd ./my-project
graphify init

{
  "sources": [
    {"path": "./src", "type": "code"},
    {"path": "./docs", "type": "markdown"},
    {"path": "./schema.sql", "type": "sql"},
    {"path": "./pdfs", "type": "pdf"}
  ]
}

graphify build

graphify query "найти все импорты функции processOrder"
graphify query "показать связи таблицы users"

# Пример для Claude Code (CLAUDE.md)
# /graphify — построить и запросить граф знаний текущего репозитория

graphify status
graphify clean

Graphify: превращаем кодовую базу в запросный граф знаний

Пошаговая инструкция по установке и запуску Graphify-Labs/graphify для локального построения графа знаний из кода, документации, SQL-схем и PDF без векторной базы.

Предварительные требования

• Node.js 18+ и npm
• Доступ к терминалу
• Кодовая база для анализа

Шаг 1: Проверка окружения и установка Graphify

Убедитесь, что установлен Node.js версии 18 или выше. Graphify распространяется как CLI-утилита, поэтому достаточно установить её глобально через npm.

node -v
npm install -g graphify

Шаг 2: Инициализация проекта

Перейдите в корень кодовой базы и создайте конфигурацию Graphify. Это позволит указать, какие директории и типы файлов нужно индексировать.

cd ./my-project
graphify init

Шаг 3: Настройка источников данных

Отредактируйте сгенерированный файл graphify.config.json. Укажите пути к исходному коду, SQL-схемам, конфигам и PDF-документам, которые должны попасть в граф.

{
  "sources": [
    {"path": "./src", "type": "code"},
    {"path": "./docs", "type": "markdown"},
    {"path": "./schema.sql", "type": "sql"},
    {"path": "./pdfs", "type": "pdf"}
  ]
}

Шаг 4: Построение графа знаний

Запустите детерминированный обход через AST-парсер. Graphify проанализирует зависимости, импорты, связи между таблицами и ссылки в документах без использования векторного хранилища.

graphify build

Шаг 5: Запрос к графу знаний

Используйте встроенный язык запросов, чтобы найти связи между сущностями. Например, узнать, какие файлы зависят от конкретной функции или таблицы.

graphify query "найти все импорты функции processOrder"
graphify query "показать связи таблицы users"

Шаг 6: Интеграция с Claude Code, Cursor, Codex и Gemini CLI

Добавьте навык /graphify в ваш AI-ассистент. После этого модель сможет запрашивать граф напрямую, получая точные объяснения каждой связи вместо семантического поиска по векторам.

# Пример для Claude Code (CLAUDE.md)
# /graphify — построить и запросить граф знаний текущего репозитория

Шаг 7: Проверка результатов и очистка

Убедитесь, что граф собран без ошибок. При необходимости пересоберите его после изменений в коде. Для удаления индекса используйте команду очистки.

graphify status
graphify clean