memory-dispose-geometry — правило для Claude Code
Правило memory-dispose-geometry для Claude Code напоминает освобождать геометрию при удалении объектов из сцены. Оно срабатывает при работе с ресурсами Three.js.
MIT ★ 4 719 обновлён 2026-10-24
.claude/rules/memory-dispose-geometry.mdЧто делает 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
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/memory-dispose-geometry.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/memory-dispose-geometry.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/memory-dispose-geometry.mdВручную: положить файлы
.clinerules/memory-dispose-geometry.mdПо шагам, с командами для каждой платформы: 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