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

memory-dispose-geometry — правило для Claude Code

Правило memory-dispose-geometry для Claude Code напоминает освобождать геометрию при удалении объектов из сцены. Оно срабатывает при работе с ресурсами Three.js.

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

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

Что делает memory-dispose-geometry

Правило требует вызывать geometry.dispose() перед тем, как забыть удалённый объект сцены. В Three.js сборщик мусора JavaScript не освобождает память GPU, поэтому буферы геометрии могут остаться занятыми.

Для сложных моделей описана рекурсивная очистка геометрии, материалов и текстур. Пример для React удаляет объект из сцены и освобождает его геометрию и материал при очистке эффекта.

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

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

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

  • Переделай удаление mesh, чтобы геометрия освобождалась из памяти GPU.
  • Добавь очистку геометрии, материалов и текстур для complexModel.
  • Проверь очистку ресурсов Three.js в этом эффекте React.

Как установить memory-dispose-geometry

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

.claude/rules/memory-dispose-geometry.md

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

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

Вопросы о memory-dispose-geometry

Как установить memory-dispose-geometry в Claude Code?

Добавь файл правила по пути .claude/rules/memory-dispose-geometry.md в проект Claude Code.

Что делает memory-dispose-geometry?

Напоминает освобождать геометрию при удалении объектов сцены и описывает очистку материалов и текстур.

Что нужно очищать у сложной модели?

Геометрию, материалы и текстуры; для вложенных объектов правило описывает рекурсивную очистку.

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

memory-dispose-geometry.md · MIT
# memory-dispose-geometry

**Always dispose geometries when removing objects from scene.**

## Why It Matters

Three.js does NOT automatically garbage collect GPU resources. Geometries allocate GPU buffer memory that persists until explicitly freed. Failing to dispose causes memory leaks that eventually crash the browser.

## Bad Example

```javascript
// BAD - Memory leak
scene.remove(mesh);
mesh = null; // GPU buffers still allocated!
```

The JavaScript object is garbage collected, but the GPU memory remains allocated.

## Good Example

```javascript
// GOOD - Proper cleanup
scene.remove(mesh);
mesh.geometry.dispose();
mesh = null;
```

## Recursive Disposal

For complex hierarchies, use recursive disposal:

```javascript
function disposeObject(obj) {
  if (obj.geometry) {
    obj.geometry.dispose();
  }

  if (obj.material) {
    if (Array.isArray(obj.material)) {
      obj.material.forEach(disposeMaterial);
    } else {
      disposeMaterial(obj.material);
    }
  }

  if (obj.children) {
    obj.children.forEach(disposeObject);
  }
}

function disposeMaterial(material) {
  const textureKeys = [
    'map', 'lightMap', 'bumpMap', 'normalMap', 'specularMap',
    'envMap', 'alphaMap', 'aoMap', 'displacementMap',
    'emissiveMap', 'gradientMap', 'metalnessMap', 'roughnessMap'
  ];

  textureKeys.forEach(key => {
    if (material[key]) {
      material[key].dispose();
    }
  });

  material.dispose();
}

// Usage
disposeObject(complexModel);
scene.remove(complexModel);
```

## React Example

```jsx
useEffect(() => {
  const geometry = new THREE.BoxGeometry();
  const material = new THREE.MeshBasicMaterial();
  const mesh = new THREE.Mesh(geometry, material);
  scene.add(mesh);

  return () => {
    scene.remove(mesh);
    geometry.dispose();
    material.dispose();
  };
}, []);
```

## References

- [Three.js Manual: Dispose](https://threejs.org/manual/#en/dispose)

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

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

Все правила IDE по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
threejs-geometry CloudAI-X Скилл threejs-geometry учит ИИ-агента создавать стандартные и процедурные геометрии three.js, настраивать буферные атрибуты и генерировать 3D-текст. CX Codex +1 20 600установок threejs-fundamentals CloudAI-X Скилл threejs-fundamentals помогает настроить базовую сцену Three.js r186: рендерер, камеры, цикл анимации с THREE.Timer и import map для WebGL или WebGPU с TSL. CX Codex +1 24 100установок webgl-3d-object MengTo Скилл webgl-3d-object добавляет в агент правила генерации трёхмерных объектов на Three.js с честным PBR-освещением, тенями и анимацией вместо псевдо-3D на CSS. CX Codex +1 2 000установок add-mouse-driven-orbit MengTo Скилл add-mouse-driven-orbit для Claude Code добавляет плавный параллакс и кинематографичное вращение сцены Three.js вслед за курсором, без OrbitControls. Анимация используется в интерактивных hero-секциях. CX Codex +1 1 500установок threejs-interaction calesthio Скилл threejs-interaction для Claude Code помогает добавить в Three.js выбор объектов, обработку ввода и управление камерой. Подключается к задачам с raycasting и интерактивными 3D-сценами. CX Codex +1 1 200установок threejs-game OpusGameLabs Скилл threejs-game для Claude Code: задаёт структуру проекта и обязательные модули для 3D-игры в браузере на Three.js. Разворачивает сцену и игровой цикл с нуля. CX Codex +1 1 200установок

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

Весь набор →
server-auth-actions Правило server-auth-actions требует проверять аутентификацию и права внутри каждой Server Action. Оно защищает серверные мутации, которые можно вызвать напрямую. CX Codex +1 ★ 4 719звёзд репо setup-use-import-maps Правило setup-use-import-maps требует подключать Three.js через import map с модулями и точной версией, а не старым тегом <script src> с CDN. CX Codex +1 ★ 4 719звёзд репо render-delta-time Правило render-delta-time предписывает использовать delta time в циклах анимации, чтобы скорость движения не зависела от частоты кадров. 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звёзд репо 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звёзд репо

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

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