Support project-local editing of existing NPC services and quest links, with guarded migrations and preserved server data. Add custom appearance artifacts, Russian-first quests with independent English text, and the local D0 launcher and content catalog. Validation: cargo fmt --all; cargo clippy --workspace --all-targets -- -D warnings; cargo test --workspace (106 passed, 0 failed, 32 ignored). Co-Authored-By: Codex <noreply@openai.com>
4.4 KiB
Быстрый поиск по исходникам
Graphify строит локальный AST-граф поддерживаемых языков проекта, включая Rust. Индекс
помогает Luna находить файлы, символы и связи перед точным чтением исходников. 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 содержит список покрытых файлов и счётчики узлов/связей.
Граф не содержит кластеров, визуализации или семантической интерпретации документации.