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

perf-visibility-toggle — правило для Claude Code: что делает

Правило perf-visibility-toggle учит ассистента скрывать Three.js-компоненты через свойство visible, а не удалять их из дерева React, чтобы видеокарта не пересобирала шейдеры.

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

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

Что делает perf-visibility-toggle

Правило предписывает переключать свойство visible у Three.js-объектов вместо условного рендеринга вида {show && <Model />}. При повторном монтировании React уничтожает объект Three.js, заново создаёт геометрию с материалами, отправляет данные в видеопамять и заставляет GPU компилировать шейдеры с нуля.

Свойство visible={false} оставляет меш в оперативной памяти, но пропускает его при отрисовке кадра. В тексте правила также описана прямая мутация свойства visible через ссылки в хуке useFrame и использование слоёв Three.js (layers), если нужно выборочно скрывать объекты от конкретной камеры без изменения общего флага видимости.

Полное удаление компонента из дерева остаётся оправданным только при жёстких ограничениях по памяти или когда объект появляется редко.

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

  • избежать повторной компиляции шейдеров при скрытии Three.js-моделей
  • предотвратить лишнюю выгрузку геометрии и материалов в GPU
  • настроить прямое управление видимостью меша внутри useFrame
  • разделить отрисовку объектов по камерам через слои Three.js

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

  • Проверь сцену с 3D-моделью и замени условный рендеринг на свойство visible
  • Оптимизируй переключение видимости меша в цикле useFrame через ref
  • Покажи, как скрыть объект от основной камеры с помощью layers

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

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

.claude/rules/perf-visibility-toggle.md

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

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

Вопросы о perf-visibility-toggle

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

Сохраните файл правила по пути .claude/rules/perf-visibility-toggle.md в корне вашего проекта.

Что делает правило perf-visibility-toggle?

Оно объясняет ассистенту, что часто скрываемые 3D-компоненты нужно выключать через проп visible, чтобы не тратить ресурсы на пересоздание геометрии и шейдеров.

В каких случаях всё же нужно монтировать компонент заново?

Условный рендеринг нужен, если сцена ограничена по доступной памяти, объектов слишком много либо конкретный меш появляется крайне редко.

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

perf-visibility-toggle.md · MIT
# Toggle Visibility Instead of Remounting

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

Toggle the `visible` prop instead of conditionally mounting/unmounting components.

## Why It Matters

Remounting a component:
1. Destroys the Three.js object
2. Triggers disposal (if configured)
3. Creates new geometry/material
4. Uploads new data to GPU
5. Recompiles shaders

Toggling visibility:
1. Sets `object.visible = false`
2. That's it - object stays in memory

## BAD: Conditional Mounting

```jsx
function Scene({ showModel }) {
  return (
    <>
      {showModel && <ExpensiveModel />}
    </>
  );
}
```

Every toggle destroys and recreates the entire model.

## GOOD: Visibility Toggle

```jsx
function Scene({ showModel }) {
  return (
    <ExpensiveModel visible={showModel} />
  );
}
```

Model stays in memory, just skipped during render.

## When to Use Each

### Use Visibility Toggle When:
- Frequent show/hide (e.g., UI state)
- Object is expensive to create
- Object is needed again soon
- Object count is manageable

### Use Conditional Mounting When:
- Object is rarely shown
- Memory is constrained
- Object is cheap to create
- Large number of potential objects

## With Refs

```jsx
function ToggleableModel() {
  const meshRef = useRef();
  const [visible, setVisible] = useState(true);

  // Direct mutation for animations
  useFrame(() => {
    if (meshRef.current) {
      meshRef.current.visible = shouldBeVisible;
    }
  });

  return <mesh ref={meshRef} visible={visible} />;
}
```

## Visibility vs Layers

For complex visibility logic, consider using Three.js layers:

```jsx
function SelectiveRendering() {
  const meshRef = useRef();

  useEffect(() => {
    // Set to layer 1 (not rendered by default camera)
    meshRef.current.layers.set(1);
  }, []);

  return <mesh ref={meshRef} />;
}
```

Layers allow camera-selective rendering without changing visibility.

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

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

Все правила IDE по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
r3f-materials EnzeD Скилл r3f-materials для Claude Code и ещё пяти агентных сред, который подбирает материалы React Three Fiber. Помогает выбрать самый дешёвый вариант для PBR-поверхностей, стекла и прозрачности. CX Codex +1 2 200установок cloudai-threejs podo Скилл cloudai-threejs для Claude Code объединяет инструкции по Three.js, WebGL, WebGPU и React Three Fiber для создания 3D-сцен, шейдеров и анимаций без устаревших паттернов. CX Codex +1 207установок particles-gpu Bbeierle12 Скилл particles-gpu генерирует системы частиц на GPU через Three.js и React Three Fiber. Помогает рендерить эффекты от 10 тысяч до миллионов точек без просадки кадров. CX Codex +1 173установок postfx-effects Bbeierle12 Скилл postfx-effects для Claude Code собирает рецепты пост-эффектов для сцен на React Three Fiber: глубину резкости, виньетирование и ретро-стили. CX Codex +1 106установок improve-threejs millionco Скилл improve-threejs для Claude Code находит утечки памяти GPU и просадки FPS в Three.js и React Three Fiber. Включается по запросу аудита или команде /improve-threejs. CX Codex +1 451установок threejs-perf OpusGameLabs Скилл threejs-perf переводит отрисовку повторяющихся объектов Three.js на InstancedMesh и пакетное обновление матриц. Снижает число draw calls в сценах с сотнями одинаковых мешей. CX Codex +1 753установок

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

Весь набор →
render-delta-time Правило render-delta-time предписывает использовать delta time в циклах анимации, чтобы скорость движения не зависела от частоты кадров. CX Codex +1 ★ 4 719звёзд репо 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-r3f-perf Правило perf-r3f-perf добавляет в Claude Code знания о r3f-perf — библиотеке для отслеживания производительности Three.js сцен в реальном времени. Помогает находить узкие места: низкий FPS, утечки памяти, лишние пересчёты матриц. 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звёзд репо

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

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