Files
sindoring d229117a23 Add NPC authoring, custom appearances and bilingual quests
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>
2026-11-14 18:43:02 +04:00

4.4 KiB
Raw Permalink Blame History

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

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 содержит список покрытых файлов и счётчики узлов/связей. Граф не содержит кластеров, визуализации или семантической интерпретации документации.