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/rules/perf-r3f-perf.mdЧто делает 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
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/perf-r3f-perf.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/perf-r3f-perf.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/perf-r3f-perf.mdВручную: положить файлы
.clinerules/perf-r3f-perf.mdПо шагам, с командами для каждой платформы: 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