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

57 lines
4.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Быстрый поиск по исходникам
Graphify строит локальный AST-граф поддерживаемых языков проекта, включая Rust. Индекс
помогает Luna находить файлы, символы и связи перед точным чтением исходников. Markdown,
изображения и другие смысловые документы в этот индекс не входят. Для них нужен `rg`.
Связи AST — подсказка для навигации, поведение подтверждается исходником и проверками.
При актуальном индексе сразу выполняй запрос. Обновление нужно после изменений кода
или при отсутствии индекса.
## Установка и обновление
```powershell
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, глобальные настройки и фоновые процессы не устанавливаются. Обновляй индекс перед
поиском после изменений кода. Автоматического наблюдения за файлами нет.
## Запросы
```powershell
./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` содержит список покрытых файлов и счётчики узлов/связей.
Граф не содержит кластеров, визуализации или семантической интерпретации документации.