Graphify: построение графа знаний из кодовой базы

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

Средний

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

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

node --version && npm --version

git clone https://github.com/Graphify-Labs/graphify.git && cd graphify

npm install

cat > graphify.config.json << 'EOF'
{
  "sourcePaths": ["./src", "./docs"],
  "outputPath": "./graph",
  "include": ["*.ts", "*.sql", "*.md", "*.pdf"],
  "exclude": ["node_modules", ".git"]
}
EOF

npx graphify parse --config graphify.config.json

npx graphify view --graph ./graph/graph.json

cat >> ~/.claude/commands.json << 'EOF'
{
  "commands": [
    {
      "name": "graphify",
      "description": "Build knowledge graph from codebase",
      "command": "npx graphify parse --config graphify.config.json"
    }
  ]
}
EOF

npx graphify query --graph ./graph/graph.json --query "MATCH (f:Function)-[:CALLS]->(other:Function) RETURN f.name, other.name LIMIT 10"

npx graphify export --graph ./graph/graph.json --format svg --output ./graph/export.svg

Graphify: построение графа знаний из кодовой базы

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

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

• Установленный Node.js (версия 18 и выше)
• Доступ к терминалу (Linux, macOS или WSL на Windows)
• Базовые навыки работы с командной строкой
• Аккаунт в Claude Code (для интеграции навыка /graphify)

Шаг 1: Установка Node.js и npm

Graphify работает на платформе Node.js. Убедитесь, что у вас установлена версия 18 или новее. Проверьте текущую версию и при необходимости обновите.

node --version && npm --version

Шаг 2: Клонирование репозитория Graphify

Склонируйте официальный репозиторий Graphify с GitHub на локальную машину.

git clone https://github.com/Graphify-Labs/graphify.git && cd graphify

Шаг 3: Установка зависимостей

Установите все необходимые зависимости проекта с помощью npm.

npm install

Шаг 4: Создание конфигурационного файла

Создайте конфигурационный файл graphify.config.json в корне проекта для настройки путей к исходным файлам и параметров парсинга.

cat > graphify.config.json << 'EOF'
{
  "sourcePaths": ["./src", "./docs"],
  "outputPath": "./graph",
  "include": ["*.ts", "*.sql", "*.md", "*.pdf"],
  "exclude": ["node_modules", ".git"]
}
EOF

Шаг 5: Запуск парсинга кодовой базы

Выполните команду для запуска локального детерминированного AST-парсинга. Graphify проанализирует указанные файлы и построит граф знаний с объяснением каждой связи.

npx graphify parse --config graphify.config.json

Шаг 6: Просмотр сгенерированного графа знаний

После завершения парсинга в указанной директории (./graph) появятся файлы графа. Используйте встроенный просмотрщик для визуализации и запросов к графу.

npx graphify view --graph ./graph/graph.json

Шаг 7: Интеграция с Claude Code через /graphify

Для использования Graphify как навыка в Claude Code зарегистрируйте команду /graphify в конфигурации Claude. Это позволит запускать парсинг прямо из интерфейса Claude Code.

cat >> ~/.claude/commands.json << 'EOF'
{
  "commands": [
    {
      "name": "graphify",
      "description": "Build knowledge graph from codebase",
      "command": "npx graphify parse --config graphify.config.json"
    }
  ]
}
EOF

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

Используйте встроенный язык запросов Graphify (GQL) для поиска связей между сущностями, функциями, таблицами и документацией. Пример простого запроса:

npx graphify query --graph ./graph/graph.json --query "MATCH (f:Function)-[:CALLS]->(other:Function) RETURN f.name, other.name LIMIT 10"

Шаг 9: Экспорт результатов

Экспортируйте граф знаний в форматы JSON, CSV или визуальные модели (SVG, PNG) для дальнейшего анализа или документирования.

npx graphify export --graph ./graph/graph.json --format svg --output ./graph/export.svg