Карта исследования Faset Engine

Локальное React-приложение с интерактивной картой, просмотром Markdown и переходами к строкам исходников. research.tsx хранится здесь же; сборка не зависит от Codex, абсолютного пути к рабочему столу или файлов в домашнем каталоге. Карта показывает принятые решения и критерии этапов. Текущее состояние C++-реализации и проверок записано в журнале реализации.

Главные документы: о проекте, план до/после MVP, архитектура, исследования. Актуальный охват: собственный Vulkan 1.3/Render Graph, Slang, SDL3, C++/EnTT, retained editor UI; две демки в MVP, продвинутая графика и Lua после него. MCP работает строго в Editor, без доступа к runtime worlds/сессиям и без MCP в Player.

В этой папке, с установленными Node.js 20+ и npm:

npm ci
npm run build
npm start

Открыть http://localhost:4178. Сервер слушает только 127.0.0.1; PORT позволяет выбрать другой порт. После правки исходников повторить сборку; после правки сервера перезапустить его.

Отчёты читаются из docs/, также доступны корневые README.md и PLAN.md. Карта запускается после обычного clone Faset без чужих исходников. Для опционального локального просмотра source-ссылок можно разместить checkout рядом с проектом:

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; иной локальный commit может иметь другие строки. Исходники движков не копируются в сборку карты.

API принимает пути относительно корня проекта, проверяет реальные пути и разрешает только текстовые файлы из перечисленных областей размером до 8 MiB. Скрытые каталоги и node_modules исключены. Сервер предназначен для локального чтения исследования, без изменения файлов. Его следует запускать локально; это не публичный file server и не MCP редактора.

Проверка разрешения ссылок и границ файлового API: npm test.

3.5 KiB Raw Permalink Blame History Unescape Escape

Карта исследования Faset Engine

3.5 KiB

Raw Permalink Blame History