Перейти к основному содержимому

Быстрый путь: от установки до первого результата

Что это​

Кратчайший путь от чистого репозитория до первого полезного результата: установка, запуск локального интерфейса, построение графа кода, первый graph-запрос и создание задачи. Каждый шаг сопровождается командой или действием и тем, что вы должны увидеть.

Предварительные условия​

Нужны Python 3.12+ и uv. Node.js 22+ требуется только при пересборке фронтенда — для этого пути он не нужен. Подробнее — в требованиях.

Пошагово​

1. Установить зависимости​

uv sync --dev

Ожидаемо: окружение собрано, команда uv run raytsystem ... доступна. При желании проверьте установку:

uv run raytsystem doctor

2. Открыть интерфейс​

uv run raytsystem ui

Ожидаемо: интерфейс открывается на http://127.0.0.1:8765. raytsystem связывается только с loopback-адресом; API-ключ, облачный аккаунт или расширение браузера не требуются.

3. Открыть «Вселенную»​

В левой панели, в группе Оркестрация, откройте раздел Вселенная. Это граф знаний, работы и доказательств. Переключитесь на линзу Код, чтобы видеть структуру кодовой базы. Если граф ещё не построен, линза будет пустой — перейдём к сборке.

4. Построить граф кода​

Сначала посмотрите свежесть графа (только чтение):

uv run raytsystem graph status --json

Затем постройте или обновите его:

uv run raytsystem graph update --json

Ожидаемо: инкрементальный снимок графа создан. Для полной пересборки используйте uv run raytsystem graph rebuild --json. Обе команды пишут только в служебный, пересобираемый план .raytsystem/graph/ и не изменяют канонические знания. Подробнее — в обзоре графа кода.

5. Задать первый graph-запрос​

uv run raytsystem graph query "How does task checkout work?" --depth 2 --json

Ожидаемо: ограниченный по глубине ответ с узлами и связями графа. Те же результаты доступны в интерфейсе через линзу «Код». См. query / explain / neighbors.

6. Создать задачу​

Перейдите в раздел Задачи и создайте задачу через форму создания. Эквивалент в CLI — команда uv run raytsystem task create (точные аргументы и статусы см. в «Задачи: интерфейс и CLI»). Убедиться, что задача записана:

uv run raytsystem task list --json

Ожидаемо: новая задача появляется в операционном журнале. История задач неизменяема — статусы меняются переходами, а не перезаписью.

Ожидаемый результат​

Интерфейс запущен локально, граф кода построен, первый graph-запрос вернул результат, а в журнале задач есть ваша первая задача.

Ограничения и безопасность​

Выполнение моделей по умолчанию отключено (runtime_execution_enabled выключен): интерфейс не запускает модель и не обращается к провайдеру. Реальная публикация знаний работает по принципу default-deny. Не редактируйте вручную _raw/, ledger/ и сгенерированные страницы knowledge/.

Связанные страницы​

Источники истины​

  • README.md
  • web/src/app/App.tsx
  • web/src/presentation.ts