# raycasting-optimization

Правило raycasting-optimization для Claude Code описывает, как ускорить поиск пересечений и выбор объектов в Three.js. Сокращает проверки Raycaster в интерактивных сценах и на сложных мешах.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 4719 у репозитория
- Автор: zebbern
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/zebbern/claude-code-guide/tree/HEAD/skills/three-best-practices/rules/raycasting-optimization.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/raycasting-optimization

## Что делает

Правило описывает способы отфильтровать объекты для Raycaster и сократить число проверок. Можно использовать слои для исключения декора, ограничить дальность через `near` и `far`, проверять только первое пересечение и не запускать Raycasting на каждом событии мыши.

Для сложных мешей правило предлагает `three-mesh-bvh`: установка выполняется через `npm install three-mesh-bvh`, затем для геометрии строится BVH. Для запросов по сцене описан Octree, а для скиннинговых мешей — подбор объекта по цвету через GPU. У этих вариантов разные задачи: Octree также рассматривает столкновения капсулы, а BVH ускоряет пересечения с мешем.

Без установленного `three-mesh-bvh` пример с BVH не заработает; для сцены с 80k+ полигонов правило предлагает рассмотреть этот вариант.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/rules/raycasting-optimization.md` — Поле paths во frontmatter ограничивает файлы

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/raycasting-optimization.mdc` — Во frontmatter: description, globs, alwaysApply

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/raycasting-optimization.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/raycasting-optimization.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/raycasting-optimization.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/zebbern/claude-code-guide/tree/HEAD/skills/three-best-practices/rules/raycasting-optimization.md

## Когда брать
- отфильтровать декорации при поиске пересечений
- сократить проверки сложного меша с помощью BVH
- ограничить частоту Raycasting при движении указателя
- находить объекты по пикселю через GPU
- проверять столкновение капсулы с Octree

## Примеры запросов агенту
- Примени правило raycasting-optimization и настрой слои, чтобы Raycaster проверял только интерактивные объекты.
- Подскажи, как ускорить пересечения с этим сложным мешем с помощью `three-mesh-bvh`.
- Используй рекомендации raycasting-optimization, чтобы ограничить проверки при движении указателя.

## Похожие
- [threejs-interaction](https://affpapa.org/nevibecode/skills/threejs-interaction.md) — скилл · 20100 установок
- [godot-raycasting-queries](https://affpapa.org/nevibecode/skills/godot-raycasting-queries.md) — скилл · 328 установок
- [deepmotion-animate-3d](https://affpapa.org/nevibecode/skills/deepmotion-animate-3d.md) — скилл · 143 установки
- [RTK Motion Intelligence](https://affpapa.org/nevibecode/mcp/rtk-motion-intelligence.md) — MCP-сервер · 2335 установок
- [threejs-fundamentals](https://affpapa.org/nevibecode/skills/threejs-fundamentals.md) — скилл · 24100 установок
- [orbit-card](https://affpapa.org/nevibecode/skills/orbit-card.md) — скилл · 13200 установок

Из того же набора: [zebbern/claude-code-guide](https://affpapa.org/nevibecode/by/zebbern/claude-code-guide.md) — 86 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
