Files
moonwell-editor/docs/graphify.md
T

4.4 KiB
Raw Blame History

Быстрый поиск по исходникам

Graphify строит локальный AST-граф поддерживаемых языков проекта, включая Rust. Индекс помогает Terra находить файлы, символы и связи перед точным чтением исходников. Markdown, изображения и другие смысловые документы в этот индекс не входят. Для них нужен rg. Связи AST — подсказка для навигации, поведение подтверждается исходником и проверками. При актуальном индексе сразу выполняй запрос. Обновление нужно после изменений кода или при отсутствии индекса.

Установка и обновление

uv tool install graphifyy==0.9.93
./scripts/graphify.ps1 build
./scripts/graphify.ps1 update
./scripts/graphify.ps1 status

Скрипт находит Python через uv tool dir, затем рядом с graphify в PATH. При другом способе установки передай -Python <полный путь к python.exe окружения graphifyy>. Путь текущего окружения — C:/Users/sindo/AppData/Roaming/uv/tools/graphifyy/Scripts/python.exe.

build и update выполняют одну полную локальную экстракцию --code-only --no-cluster в свежий временный каталог. Это учитывает удалённые файлы и не сохраняет старые смысловые слои Graphify. Старый graph.json заменяется атомарно только после успешной экстракции и проверок непустого графа, наличия Rust и исключённых путей. При ошибке старый граф остаётся. Временный каталог находится внутри graphify-out/ и автоматически убирается.

Индекс и index-report.json игнорируются Git. Сборки, .git, локальные настройки и секреты исключены через .gitignore и .graphifyignore. API-ключи не нужны, LLM-токены — 0. Hooks, глобальные настройки и фоновые процессы не устанавливаются. Обновляй индекс перед поиском после изменений кода. Автоматического наблюдения за файлами нет.

Запросы

./scripts/graphify.ps1 vocab
./scripts/graphify.ps1 query "quest" --seed crates/editor-app/src/quest_ui.rs --budget 1200
./scripts/graphify.ps1 query "quest migration" --budget 3000
./scripts/graphify.ps1 explain "crates/editor-app/src/quest_ui.rs"
./scripts/graphify.ps1 path "crates/editor-project/src/quest.rs" "crates/editor-vmangos/src/quest.rs" --undirected

Перед запросом выбери до 12 терминов из vocab и явно сообщи выбор. Graphify сопоставляет имена без перевода и синонимов. Русский вопрос о квестах нужно сопоставить с существующим quest. Если подходящих терминов нет, переходи к rg.

У каждого результата проверяй source_file и source_location. Одинаковые имена могут принадлежать editor-project/src/quest.rs, editor-vmangos/src/quest.rs и UI-модулю editor-app/src/quest_ui.rs. Проверяй их отдельно. query показывает ограниченную выборку. Отсутствие узла в ней не доказывает отсутствие файла. Для точного текста дополняй поиск rg -n <термин> crates. Источник истины — исходники.

graphify-out/index-report.json содержит список покрытых файлов и счётчики узлов/связей. Граф не содержит кластеров, визуализации или семантической интерпретации документации.