К основному содержанию
правило CX Codex

perf-r3f-perf — правило для Claude Code: мониторинг React Three Fiber

Правило perf-r3f-perf добавляет в Claude Code знания о r3f-perf — библиотеке для отслеживания производительности Three.js сцен в реальном времени. Помогает находить узкие места: низкий FPS, утечки памяти, лишние пересчёты матриц.

MIT ★ 4 719 обновлён 2026-10-24

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/perf-r3f-perf.md
Открыть на GitHub

Что делает perf-r3f-perf

r3f-perf показывает FPS, время кадра (MS), нагрузку на CPU и GPU, потребление памяти и количество draw calls прямо на экране. Можно включить глубокий анализ для перечисления времени рендера каждого объекта отдельно, но это добавляет нагрузку. Компонент поддерживает позиционирование в четырёх углах, минимальный режим (только FPS) и график производительности.

Правило учит Claude Code добавлять <Perf /> в Canvas, настраивать его пропсы и скрывать в production через process.env.NODE_ENV === 'development'. Сам инструмент имеет оверхед — его стоит отключать или переводить в минимальный режим на финальных сборках.

Какие задачи решает

  • отследить падение FPS в Three.js сцене
  • найти утечки геометрий и текстур в памяти
  • подсчитать draw calls и оптимизировать количество
  • проанализировать время рендера отдельных объектов

Примеры запросов агенту

  • Добавь r3f-perf в Canvas, чтобы видеть FPS и время кадра
  • Настрой позицию монитора и включи граф производительности
  • Используй deepAnalyze, чтобы узнать, какой объект жрёт больше всего времени

Как установить perf-r3f-perf

Вручную: положить файлы

.claude/rules/perf-r3f-perf.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о perf-r3f-perf

Как установить perf-r3f-perf в Claude Code?

Создай файл .claude/rules/perf-r3f-perf.md с содержимым правила. Claude Code автоматически загрузит его при следующем запуске проекта.

Что мониторит r3f-perf?

FPS, миллисекунды на кадр, время выполнения JavaScript, время рисования WebGL, объём памяти под геометрии и текстуры, количество пересчётов матриц. Всё выводится на экран во время разработки.

Нужно ли включать deepAnalyze?

Только если ищешь конкретный объект, который замораживает сцену. Режим добавляет CPU нагрузку, поэтому используй его кратко — глубокий анализ сам по себе может исказить результаты.

Исходный текст

perf-r3f-perf.md · MIT
# r3f-perf for Performance Monitoring

> Source: [100 Three.js Tips - Utsubo](https://www.utsubo.com/blog/threejs-best-practices-100-tips)

Use r3f-perf for comprehensive React Three Fiber performance monitoring.

## Installation

```bash
npm install r3f-perf
```

## Basic Usage

```jsx
import { Perf } from 'r3f-perf';

function App() {
  return (
    <Canvas>
      <Perf position="top-left" />
      <Scene />
    </Canvas>
  );
}
```

## Available Props

```jsx
<Perf
  position="top-left"     // Position: top-left, top-right, bottom-left, bottom-right
  minimal={false}         // Minimal mode (just FPS)
  showGraph={true}        // Show performance graph
  matrixUpdate={true}     // Show matrix updates
  deepAnalyze={false}     // Deep analysis (more CPU intensive)
  overClock={false}       // Over-clock mode for high refresh rate monitors
  logsPerSecond={10}      // Logs per second
/>
```

## What It Monitors

- **FPS** - Frames per second
- **MS** - Milliseconds per frame
- **CPU** - JavaScript execution time
- **GPU** - WebGL draw time (estimated)
- **Memory** - Geometries, textures, draw calls
- **Matrix Updates** - Number of matrix recalculations

## Conditional Rendering for Production

```jsx
import { Perf } from 'r3f-perf';

function App() {
  const isDev = process.env.NODE_ENV === 'development';

  return (
    <Canvas>
      {isDev && <Perf position="top-left" />}
      <Scene />
    </Canvas>
  );
}
```

## Deep Analyze Mode

For detailed per-object analysis:

```jsx
<Perf
  deepAnalyze={true}
  className="custom-perf"
/>
```

Shows render times for individual objects but has higher CPU overhead.

## Best Practices

1. **Remove in production** - Always hide in production builds
2. **Use sparingly** - Performance monitor itself has overhead
3. **Check draw calls** - Target under 100 draw calls
4. **Monitor memory** - Watch for leaking geometries/textures
5. **Use alongside renderer.info** - For detailed WebGL stats

© zebbern · MIT · zebbern/claude-code-guide

Похожие правила IDE

Все правила IDE по теме «Фронтенд и UI» →
r3f-fundamentals EnzeD Скилл r3f-fundamentals учит агента строить сцены React Three Fiber: Canvas, типизированный JSX, хуки рендер-цикла и владение ресурсами. Для базовой архитектуры сцены, не для детальных материалов. CX Codex +1 2 400установок r3f-animation EnzeD Скилл r3f-animation для плавной анимации 3D-объектов в React Three Fiber через useFrame, damping и GLTF-клипы. Подходит для процедурного движения, переходов между состояниями и управления анимацией по запросу. CX Codex +1 2 300установок r3f-best-practices three-agent-skills Скилл r3f-best-practices для Claude Code содержит 70+ правил для написания, ревью и ускорения кода на React Three Fiber. Помогает избегать частых перерисовок и работать со стеком Poimandres. CX Codex +1 1 700установок threejs-r3f AThevon Скилл threejs-r3f для Claude Code помогает создавать 3D-сцены на Three.js и React Three Fiber. Даёт рекомендации по шейдерам, постобработке и производительности. CX Codex +1 1 000установок react-native-r3f Mindrally Скилл react-native-r3f задаёт правила разработки 3D-сцен на React Three Fiber и three.js. Помогает генерировать чистые компоненты с TypeScript без точек с запятой. CX Codex +1 699установок 3d-web-experience sickn33 Скилл 3d-web-experience помогает создавать и отлаживать 3D-сцены, конфигураторы товаров и портфолио для веба. Разбирает выбор стека, загрузку моделей и производительность. CX Codex +1 5 400установок

Из того же набора86

Весь набор →
memory-dispose-geometry Правило memory-dispose-geometry для Claude Code напоминает освобождать геометрию при удалении объектов из сцены. Оно срабатывает при работе с ресурсами Three.js. CX Codex +1 ★ 4 719звёзд репо root-cause-debugger Субагент root-cause-debugger воспроизводит сбои и находит первопричину багов без правок в коде. Помогает локализовать поломку до начала написания фикса. CX Codex ★ 4 719звёзд репо code-reviewer Субагент code-reviewer для Claude Code проверяет готовые изменения на ошибки и регрессии. Запускается после реализации или при проверке существующего diff. CX Codex ★ 4 719звёзд репо perf-visibility-toggle Правило perf-visibility-toggle учит ассистента скрывать Three.js-компоненты через свойство visible, а не удалять их из дерева React, чтобы видеокарта не пересобирала шейдеры. CX Codex +1 ★ 4 719звёзд репо codebase-mapper Субагент codebase-mapper исследует структуру репозитория, потоки данных и точки входа перед внесением правок, не меняя рабочий код. CX Codex ★ 4 719звёзд репо solution-architect Субагент solution-architect для Claude Code, Codex и Cursor сравнивает архитектурные варианты и рекомендует один с учётом ограничений. Включается, когда требования понятны, но решений несколько. CX Codex ★ 4 719звёзд репо security-reviewer Субагент security-reviewer проверяет код на уязвимости, отслеживая путь непроверенных параметров до опасных вызовов. Не вносит правок в проект. CX Codex ★ 4 719звёзд репо runtime-verifier Субагент runtime-verifier проверяет готовые изменения через интерфейсы CLI, сервисов или файловой системы, фиксируя побочные эффекты без правок кода. CX Codex ★ 4 719звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой