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