39 lines
3.5 KiB
Markdown
39 lines
3.5 KiB
Markdown
# Карта исследования Faset Engine
|
||
|
||
Локальное React-приложение с интерактивной картой, просмотром Markdown и переходами к строкам исходников. `research.tsx` хранится здесь же; сборка не зависит от Codex, абсолютного пути к рабочему столу или файлов в домашнем каталоге. Карта показывает принятые решения и критерии этапов. Текущее состояние C++-реализации и проверок записано в [журнале реализации](../../IMPLEMENTATION.md).
|
||
|
||
Главные документы: [о проекте](../../../README.md), [план до/после MVP](../../../PLAN.md), [архитектура](../../ARCHITECTURE.md), [исследования](../README.md). Актуальный охват: собственный Vulkan 1.3/Render Graph, Slang, SDL3, C++/EnTT, retained editor UI; две демки в MVP, продвинутая графика и Lua после него. MCP работает строго в Editor, без доступа к runtime worlds/сессиям и без MCP в Player.
|
||
|
||
В этой папке, с установленными Node.js 20+ и npm:
|
||
|
||
```sh
|
||
npm ci
|
||
npm run build
|
||
npm start
|
||
```
|
||
|
||
Открыть <http://localhost:4178>. Сервер слушает только `127.0.0.1`; `PORT` позволяет выбрать другой порт. После правки исходников повторить сборку; после правки сервера перезапустить его.
|
||
|
||
Отчёты читаются из `docs/`, также доступны корневые `README.md` и `PLAN.md`. Карта запускается после обычного clone Faset без чужих исходников. Для опционального локального просмотра source-ссылок можно разместить checkout рядом с проектом:
|
||
|
||
```text
|
||
workspace/
|
||
Faset_Engine/
|
||
README.md
|
||
PLAN.md
|
||
docs/
|
||
ARCHITECTURE.md
|
||
studies/
|
||
map/
|
||
UnrealEngine/
|
||
godot/
|
||
UnityCsReference/
|
||
blender-source/
|
||
```
|
||
|
||
Без внешнего checkout локальная source-ссылка показывает пояснение. Карточки UE также ведут на upstream конкретного research commit; доступ к Unreal Engine регулируется Epic. Номера строк проверялись на snapshots из [source-manifest.json](../source-manifest.json); иной локальный commit может иметь другие строки. Исходники движков не копируются в сборку карты.
|
||
|
||
API принимает пути относительно корня проекта, проверяет реальные пути и разрешает только текстовые файлы из перечисленных областей размером до 8 MiB. Скрытые каталоги и `node_modules` исключены. Сервер предназначен для локального чтения исследования, без изменения файлов. Его следует запускать локально; это не публичный file server и не MCP редактора.
|
||
|
||
Проверка разрешения ссылок и границ файлового API: `npm test`.
|