# asset-compression

Правило asset-compression с инструкциями по сжатию 3D-ассетов для Three.js. Помогает настроить Draco, Meshopt, KTX2-текстуры и LOD для ускорения 3D-сцен в вебе.

- правило · `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/asset-compression.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/asset-compression

## Что делает

Файл задаёт стандарты сжатия геометрии и текстур в Three.js проектах. Внутри собраны готовые параметры вызова `gltf-transform`, снижающие вес геометрии на 90–95%, а также правила выбора между алгоритмами Draco и Meshopt в зависимости от критичности скорости распаковки.

Отдельный блок посвящён текстурам в формате KTX2: обычный PNG весом 200 КБ занимает свыше 20 МБ в видеопамяти (VRAM), поэтому правило предписывает переводить материалы в UASTC или ETC1S. Также описана настройка путей к декодерам через `setDecoderPath` и `setTranscoderPath`, объединение текстур в атласы и создание уровней детализации `THREE.LOD`, дающих прирост кадровой частоты до 30–40%.

Для работы алгоритмов на клиенте понадобятся внешние декодеры Draco и Basis по путям `/draco/` и `/basis/`, а на этапе сборки — установленный CLI-пакет `gltf-transform`.

## Установка

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

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

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Windsurf (Devin Desktop)

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

### Cline

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

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

## Когда брать
- сжать геометрию GLB-моделей через Draco или Meshopt
- сократить потребление видеопамяти переходом на текстуры KTX2
- настроить пути к декодерам DRACOLoader и KTX2Loader
- внедрить уровни детализации THREE.LOD для разгрузки рендера

## Примеры запросов агенту
- Оптимизируй модель `scene.glb` с помощью gltf-transform, используя сжатие Draco и текстуры KTX2
- Покажи, как настроить DRACOLoader и KTX2Loader в коде загрузки модели
- Добавь уровни детализации THREE.LOD для высокополигональной сетки

## Похожие
- [threejs-asset-pipeline](https://affpapa.org/nevibecode/skills/threejs-asset-pipeline.md) — скилл · 6500 установок
- [threejs-gltf-loading](https://affpapa.org/nevibecode/skills/threejs-gltf-loading.md) — скилл · 11200 установок
- [blender-web-pipeline](https://affpapa.org/nevibecode/skills/blender-web-pipeline.md) — скилл · 4100 установок
- [threejs-loaders](https://affpapa.org/nevibecode/skills/threejs-loaders.md) — скилл · 18400 установок
- [threejs-webgl](https://affpapa.org/nevibecode/skills/threejs-webgl.md) — скилл · 5300 установок
- [threejs](https://affpapa.org/nevibecode/skills/mengto-threejs.md) — скилл · 2500 установок

Из того же набора: [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
