Przejdź do treści
Biblioteka skilli
Programowanie · Testowanie

glb-diff

/glb-diff

Porównuje strukturalnie dwa modele glTF lub GLB i blokuje CI przy poważnych zmianach w szkieletach, animacjach lub materiałach.

Repozytorium
three.ws ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Porównuje strukturalnie dwa modele glTF lub GLB i blokuje CI przy poważnych zmianach w szkieletach, animacjach lub materiałach.

Oryginalny opis (EN)

Compare two glTF or GLB models structurally with the glb-diff CLI or @three-ws/glb-diff and gate CI on severity. Use when reviewing a 3D asset change, checking that an optimization or re-export did not break joints, clips or materials, or writing a model regression check.

Jak działa

  1. CLI
  2. Library
  3. Worked example
  4. Guidance
Sekcje z nagłówków SKILL.md, w oryginale · 49 linii, 264 słów
Podgląd SKILL.md
---
name: glb-diff
description: Compare two glTF or GLB models structurally with the glb-diff CLI or @three-ws/glb-diff and gate CI on severity. Use when reviewing a 3D asset change, checking that an optimization or re-export did not break joints, clips or materials, or writing a model regression check.
---

# GLB diff

`@three-ws/glb-diff` (Node 18+, ESM) reports what actually changed between two models: geometry, materials, textures, skeletons and animations, with git-style rename and move detection.

Run without installing: `npx -y @three-ws/glb-diff before.glb after.glb`

## CLI

```
glb-diff <before> <after> [options]
  <before>, <after>   .glb/.gltf path or http(s) URL
  --json              full change set as JSON
  --markdown | --md   Markdown report for a pull-request comment
  --fail-on <level>   exit 1 when severity reaches: cosmetic | minor | major | breaking
  --verbose           include unchanged totals
  --no-color
```

Exit codes: `0` ran and stayed below `--fail-on` (default never fails on changes), `1` severity reached `--fail-on`, `2` the tool could not run (bad args, unreadable or unparseable input).

Severity ladder: `none`, `cosmetic` (metadata only), `minor` (appearance changed, still loads and animates), `major` (geometry or hierarchy changed), `breaking` (something referenced by name is gone, such as a joint, so clips stop moving).

## Library

```js
import { readFile } from 'node:fs/promises';
import { diffModels, formatText, formatMarkdown } from '@three-ws/glb-diff';

const changes = await diffModels(await readFile('v1.glb'), await readFile('v2.glb'), { nameA: 'v1', nameB: 'v2' });
console.log(formatText(changes));
if (changes.severity === 'breaking') process.exit(1);
```

Also exported: `describeModel`, `diffDescriptions`, `readDocument`, `isGLB`, `SEVERITIES`, `atLeast`, `maxSeverity`, `matchEntries`.

## Worked example

```bash
npx -y @three-ws/glb-diff avatar.v1.glb avatar.v2.glb --fail-on breaking
npx -y @three-ws/glb-diff base.glb https://cdn.example.com/live.glb --markdown > diff.md
```

## Guidance

- Use `--fail-on breaking` in CI to catch removed joints after an optimization pass, and `--markdown` to post the report on a pull request.
- Treat exit code 2 as a tooling failure, not a regression.
- The diff runs locally. A URL input is fetched with plain `fetch`.

Wersje

W bazie nie ma innych skilli o nazwie glb-diff.

Migawka bazy z 13.11.2026 · wersja paczki 2d3c7b0797c6 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100gltf-asset-pipeline-qa
    Sprawdza, waliduje i optymalizuje pliki glTF i GLB, kompresję oraz eksport, bez animacji w czasie działania.
  • 90three-d-gltf-export
    Eksportuje GLB lub glTF z kontrolą materiałów, transformacji i tekstur.
  • 95melonjs-3d-assets
    Wczytuje modele 3D w formatach glTF, GLB i OBJ do silnika gier melonJS, z materiałami i animacją.
  • 100game-3d-assets
    Znajduje, pobiera i wdraża modele GLB oraz GLTF do gier w Three.js zamiast prostych brył z prymitywów geometrycznych.
  • 100gltf-asset-pipeline
    Prowadzi przez przygotowanie zasobów glTF i GLB: eksport z Blendera, optymalizację gltfpack i gltf-transform, kompresję Draco, tekstury KTX2, generowanie gltfjsx i nagłówki cache.
  • 100three-dart-loaders
    Ładuje modele GLTF/GLB, tekstury i zasoby asynchronicznie do sceny three_dart we Flutterze.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.