feat: externe 3D-Assets, AutoRigPro-Rig und Asset-Sync

- Asset-Manifest mit Hash, Platzierung und Rig-Metadaten
- tools/sync_assets.sh prueft Quelle und Ziel und kopiert aus dem
  Workbench-Archiv nach assets/external (gitignored)
- Skater mit AutoRigPro geriggt: 226 Control-, 30 Deform-Bones
- glTF-Export inkl. gebackenem Testclip, Godot-Import verifiziert
- Manifest-Test mit 48 Assertions (1123 gesamt)
- Phase-1-Exporte schliessen assets/external aus
- Doku, Roadmap und Findings aktualisiert
This commit is contained in:
torsten 2026-10-31 12:30:49 +01:00
parent 05dee8da2b
commit 8861cbae92
16 changed files with 949 additions and 8 deletions

View file

@ -3,8 +3,8 @@
Stand: 2026-10-31
Grundlage: `rinkplanner/rinkplanner_definition_agent_guidelines.md`
Übergeordnete Reihenfolge: `docs/roadmap.md`
Letzte Session: `docs/findings-2026-10-31-sprungkombinationen.md`
(Session davor: `docs/findings-2026-10-31-adult-2026-27.md`)
Letzte Session: `docs/findings-2026-10-31-arp-rig.md`
(Session davor: `docs/findings-2026-10-31-sprungkombinationen.md`)
## 1. Leitentscheidung
@ -30,6 +30,8 @@ wird nicht weiterentwickelt. Phase 2 konsumiert später dasselbe Datenmodell
│ └── whiteboard/ # Phase 1: view / ctrl / io
├── scenes/ # dünne Szenen, die Views zusammensetzen
├── assets/
│ ├── asset_manifest.json # externe 3D-Assets (Metadaten)
│ └── external/ # synchronisiert, gitignored
├── tests/ # headless GDScript-Tests
└── prototype/3d_test/ # alter 3D-Test, eingefroren
```
@ -170,6 +172,17 @@ Text erhalten. Sprungfolgen verlangen einen Axel als zweiten oder dritten
Sprung. Der Export verwendet die zusammengesetzte Caption (`3Lz+2T`,
`3Lz+2A+SEQ`).
**D13 – 3D-Assets liegen extern, das Repo hält nur das Manifest.**
Die Binärdateien (GLB, `.blend`, Texturen) liegen im Workbench-Archiv unter
`~/Documents/workbench_rinkplanner`, nicht im Git-Repo. Das Repo enthält
`assets/asset_manifest.json` mit ID, Quell-/Zielpfad, SHA-256, Größe,
Platzierungsdaten und Rig-Metadaten. `tools/sync_assets.sh` prüft beide
Seiten gegen den Hash, kopiert nach `assets/external/` (gitignored) und stößt
den Godot-Import an. Damit bleiben Checkout und Build klein, während die
Arbeitsdateien versioniert und reproduzierbar bleiben. Phase 1 lädt keine
3D-Ressourcen; die Pipeline ist Vorbereitung für Phase 2. Details:
`docs/assets.md`.
## 4. View- und Controller-Grenzen
- **View** (`Node2D`/`Control`) liest das Modell und zeichnet. Sie verändert
@ -439,6 +452,9 @@ Aktueller Stand:
PASV/EPSV/MDTM-Parsing, Sync-Stand und die Einstellungs-Verdrahtung.
Der FTP-Client wurde zusätzlich gegen den echten Zielserver geprüft
(Upload, Download, Übernahme, Konflikt, Aufräumen).
- **3D-Assets:** 48 Assertions für Manifest-Schema, Pfade, Platzierung,
Rig-Metadaten, Hashes und – falls synchronisiert – Größe und SHA-256 der
GLB-Datei.
Autosave/Restore wird zusätzlich in einem isolierten `XDG_DATA_HOME`
end-to-end geprüft.

160
docs/assets.md Normal file
View file

@ -0,0 +1,160 @@
# 3D-Assets (extern)
Stand: 2026-10-31
Die 3D-Assets liegen bewusst außerhalb des Git-Repos. Das Repo enthält nur
ein Manifest, ein Sync-Werkzeug und die Dokumentation. Die Binärdateien
bleiben im Workbench-Archiv.
## Verzeichnisse
```
/home/torsten/Documents/workbench_rinkplanner/
├── inbox/ # Eingang, unverändert lassen
├── library/ # kuratiert, vom Manifest referenziert
│ └── characters/
├── source/ # .blend, Rig, Rohdaten
│ └── characters/skater/
└── archive/ # alte Stände, Videos, Bilder
```
```
rinkplanner/
├── assets/
│ ├── asset_manifest.json # versioniert
│ └── external/ # gitignored, per Sync befüllt
└── tests/run_asset_manifest_tests.gd
tools/sync_assets.sh
```
`assets/external/` wird nie committet. Ein frischer Checkout braucht einmal
`./tools/sync_assets.sh --sync`, sonst fehlen die 3D-Dateien.
## Workflow
1. Neue Datei in `inbox/` ablegen.
2. Prüfen, bei Bedarf konvertieren und als versionierte Datei nach
`library/` legen (`..._v001.glb`, `..._v002.glb`).
3. Die bearbeitbare Quelle (`.blend`, Rig, Referenzvideo) nach `source/`.
4. Eintrag in `rinkplanner/assets/asset_manifest.json` ergänzen:
ID, Quelle, Ziel, SHA-256, Größe, Platzierung, Rig, Animationen.
5. `./tools/sync_assets.sh --sync` kopiert und importiert.
6. Vor dem Commit `./tools/sync_assets.sh --check` laufen lassen.
### Befehle
```bash
./tools/sync_assets.sh --check # Standard: nur prüfen
./tools/sync_assets.sh --sync # fehlende Dateien kopieren + Godot-Import
./tools/sync_assets.sh --sync --force # abweichendes Ziel überschreiben
```
Umgebungsvariablen:
| Variable | Standard | Zweck |
| :--- | :--- | :--- |
| `RINKPLANNER_WORKBENCH` | `~/Documents/workbench_rinkplanner` | Archivpfad |
| `GODOT` | `/opt/godot/Godot_v4.7.2-stable_linux.x86_64` | Import-Binary |
Das Skript prüft **Quelle und Ziel** gegen den Hash aus dem Manifest. Eine
still veränderte Workbench-Datei wird nicht kopiert, sondern gemeldet.
## Manifest
```json
{
"id": "character.skater.figure",
"version": 2,
"kind": "character",
"format": "glb",
"source": "library/characters/skater_figure_rigged_deform_v002.glb",
"target": "assets/external/characters/skater_figure_rigged_deform_v002.glb",
"sha256": "1c1f0646…",
"bytes": 8345424,
"source_scene": "source/characters/skater/skater_rig_v002.blend",
"placement": {
"up_axis": "Y",
"facing": "+Z",
"pivot": "feet",
"height_m": 1.898,
"ground_offset_m": 0.0
},
"rig": {
"type": "humanoid",
"control_bones": 226,
"deform_bones": 30,
"bind": "PSEUDO_VOXELS"
},
"animations": []
}
```
| Feld | Bedeutung |
| :--- | :--- |
| `id` | stabile Kennung; Code und Szenen referenzieren die ID, nicht den Dateinamen |
| `version` | Zähler der kuratierten Fassung |
| `source` | Pfad relativ zum Workbench-Archiv |
| `target` | Pfad relativ zum Godot-Projekt, immer unter `assets/external/` |
| `sha256` / `bytes` | Integritätsprüfung |
| `source_scene` | bearbeitbare Quelle (`.blend`) für Rig/Animation |
| `placement` | Up-Achse, Blickrichtung, Pivot und Höhe für die 3D-Szene |
| `rig` | Control-/Deform-Bones und Bind-Verfahren |
| `animations` | Liste der exportierten Clipnamen |
## Versionierung
- Dateinamen tragen `_vNNN`; vorhandene Versionen werden nicht überschrieben.
- Eine neue Fassung ist eine neue Datei plus neuer Manifest-Eintrag bzw.
aktualisierte `version` und `sha256`.
- Alte Versionen bleiben in `library/` und im Archiv nachvollziehbar.
- Nicht parsebare oder verworfene Experimente gehören nicht ins Manifest.
## Godot und Export
- `assets/external/` ist gitignored und wird nach dem Sync importiert.
- `asset_manifest.json` wird über `include_filter="*.json"` mit exportiert.
- Die aktuellen Phase-1-Export-Presets schließen `assets/external/*` aus.
Für einen 3D-Build muss bewusst ein eigenes Preset die Dateien einschließen.
Desktop kann die GLB einbetten; für Android sind 1K-Texturen oder ein
separater Asset-Pack vorgesehen.
- Phase 1 bleibt unberührt: Der 2D-Code lädt keine 3D-Ressourcen.
## Aktueller Bestand
| ID | Datei | Größe | Rig | Clips |
| :--- | :--- | ---: | :--- | :--- |
| `character.skater.figure` | `skater_figure_rigged_deform_v002.glb` | 8,35 MB | 226 Control / 30 Deform | keine (Produktion) |
Testdateien (nicht im Manifest): `skater_figure_anim_test_v001.glb` mit dem
2-Sekunden-Clip `TestWave`.
## Rig-Pipeline (AutoRigPro)
1. GLB in Blender importieren, Füße auf Z=0, Transform anwenden.
2. ARP Smart Rig: Marker für Neck, Chin, Shoulder, Hand, Root, Foot setzen.
3. `PSEUDO_VOXELS` als Bind-Engine; das Mesh hat 37 Inseln und offene Kanten,
Heat-Map-Weighting ist dafür ungeeignet.
4. **`Match to Rig` ist Pflicht:** Erst danach sitzen Knie, Füße und Arme
exakt auf dem Mesh. Der erste Auto-Rig-Lauf hatte die Füße bei x = 0,24
statt 0,10.
5. Animationen auf dem Control-Rig erstellen (IK/FK, Fußrollen, Root Motion).
6. Export mit `export_def_bones=True`; der Exporter backt Constraints
automatisch. Im GLB landen nur die 30 Deform-Bones.
7. Ergebnis in Godot prüfen (`tests/manual/inspect_rig.gd`,
`tests/manual/capture_rig.gd`).
Details und Messwerte: `docs/findings-2026-10-31-arp-rig.md`.
## Backup und Lizenz
- Das Workbench-Archiv liegt außerhalb des Repos und wird **nicht** vom
Git-Remote gesichert. `library/` und `source/` separat sichern
(restic/rsync).
- Die Skaterin ist ein eigenes GenAI-Asset; das Rig wurde mit AutoRigPro
erstellt. Vor einer Veröffentlichung die Lizenz der Basistexturen prüfen.
## Tests
`tests/run_asset_manifest_tests.gd` prüft Schema, Pfade, Hashes und – falls
synchronisiert – Größe und SHA-256 der Zieldatei. Fehlt das Asset (z. B. in
CI), wird der Dateicheck übersprungen, der Schema-Test bleibt aktiv.

View file

@ -0,0 +1,120 @@
# Findings 2026-10-31 – AutoRigPro, Skater-Rig und Asset-Pipeline
## Ziel
Prüfen, ob sich die GenAI-Skaterin mit AutoRigPro in Blender 5.2 riggen
lässt, ob der Export nach Godot trägt und wie die externen Assets
reproduzierbar ins Projekt kommen.
## Ausgangsdatei
`workbench_rinkplanner/inbox/figure_skater_blades_aligned.glb`
| Eigenschaft | Wert |
| :--- | :--- |
| Mesh | 8.188 Vertices, 13.956 Dreiecke, 1 Objekt |
| Topologie | 37 zusammenhängende Inseln, 2.346 offene/Non-Manifold-Kanten |
| Texturen | 3 × 2048² PNG (BaseColor, Normal, MetallicRoughness) |
| Maße | 1,66 × 0,35 × 1,90 m, Füße bei Z = 0 |
| Ausrichtung | T-Pose, Blick +Z, Pivot Körpermitte |
| Animation | keine, kein Skelett |
## AutoRigPro
- ARP liegt als Blender-5.2-Extension unter
`~/.config/blender/5.2/extensions/superhivemarket_com/`.
- Die AI-Marker-Dateien fehlen (`~/Documents/AutoRigPro/AI` existiert nicht).
Die Marker wurden deshalb skriptbasiert gesetzt:
Neck, Chin, Head Tip, Root, Thigh, Knee, Foot, Shoulder, Elbow, Hand,
Hand Tip.
- Smart Rig mit `arp_smart_sym = True`, Finger aus, Bind-Engine
`PSEUDO_VOXELS`.
- Ergebnis: 226-Bone-Control-Rig, 33 Deform-Bones, Bindung in 1,3 s.
### Befund: erste Platzierung war falsch
Der erste Lauf setzte die Beinkette zu weit außen:
| Knochen | erster Lauf | korrekt |
| :--- | ---: | ---: |
| Fuß x | 0,24 | 0,10 |
| Knie x | 0,17 | 0,095 |
| Hand z | 1,17 | 1,50 |
Die Reference-Bones waren bereits korrekt; nur die Deform-/IK-Kette wich ab.
**`arp.match_to_rig` („Match to Rig")** baut die Deform-Kette aus den
Reference-Bones neu, aktualisiert die Gewichte und setzt die Armature-Scale
auf 1,0. Danach sitzen Fuß, Knie, Hand und Schulter exakt auf dem Mesh.
Dieser Schritt ist bei diesem Mesh-Typ Pflicht.
### Testpose
Arm hoch/tief, Bein gehoben, Kopf gedreht, Oberkörper geneigt. Rock, Haare
und Schlittschuhe folgen ohne sichtbare Artefakte. Die Bindung wurde nicht
manuell nachgearbeitet.
## Export
| Variante | Bones | Größe |
| :--- | ---: | ---: |
| vollständiger Control-Rig | 226 | 8,41 MB |
| nur Deform-Bones (`export_def_bones`) | 30 | 8,35 MB |
Der Exporter meldet:
- mehr als 4 Joint-Einflüsse → auf die 4 stärksten gekürzt und normalisiert
- mehrere Shader-Tex-Image-Knoten → Sampler-Warnung, visuell unauffällig
- Constraints nicht glTF-fähig → Animationen werden gebacken
## Godot
- Import über `res://assets/external/characters/`.
- `Skeleton3D` mit 30 Bones, eine skinnende `MeshInstance3D`, AABB
1,659 × 1,898 × 0,352 m, Material `model`.
- Testclip `TestWave`: 2,0 s, 90 Kanäle (3 pro Joint), als
`AnimationPlayer` mit Länge 2,0 s importiert und bei t = 1,0 gerendert.
- Prüfwerkzeuge: `tests/manual/inspect_rig.gd`, `tests/manual/capture_rig.gd`.
## Asset-Pipeline
- `assets/asset_manifest.json` beschreibt ID, Quelle, Ziel, SHA-256, Größe,
Platzierung und Rig-Metadaten.
- `tools/sync_assets.sh --check|--sync [--force]` prüft Quelle und Ziel gegen
den Hash, kopiert nach `assets/external/` und importiert in Godot.
- `assets/external/` ist gitignored.
- Die Phase-1-Export-Presets schließen `assets/external/*` aus; 3D-Builds
brauchen ein eigenes Preset.
- Neuer Test `tests/run_asset_manifest_tests.gd`: 48 Assertions für Schema,
Pfade, Platzierung, Rig-Daten und optional die synchronisierte Datei.
- Gesamtsuite: **1123 Assertions** grün.
## Dateien
```
workbench/source/characters/skater/
├── skater_rig_v002.blend # Produktions-Rig, ohne Testaktion
├── skater_anim_test.blend # Rig + TestWave
├── skater_rig_v001.blend # erster Lauf (vergleichen)
└── skater_rig_test_01.blend # vor dem Rig
workbench/library/characters/
├── skater_figure_rigged_deform_v002.glb # 30 Bones, 8,35 MB
├── skater_figure_anim_test_v001.glb # + TestWave
└── ... (Vergleichsversionen)
```
## Entscheidungen
- **D13:** 3D-Assets bleiben extern; das Repo hält Manifest und Sync-Werkzeug.
- Der Produktions-Rig bleibt im `.blend`; exportiert werden nur Deform-Bones.
- Animationen werden beim glTF-Export gebacken, nicht als Constraints
mitgeschleppt.
- Der Testclip bleibt aus dem Produktions-Rig und aus dem Manifest.
## Offen
- 3D-Rink und Skater im Godot-Prototyp bewegen (Kurven-Sampling aus Phase 1).
- Rotoscoping-Workflow: Referenzvideo, Kamera, Action-/NLA-Konventionen.
- Erste echte Clips (Vorwärtsgleiten, Rückwärts, Pirouette).
- Android: Texturen auf 1K reduzieren oder separater Asset-Pack.
- Workbench-Backup außerhalb des Repos sicherstellen.

View file

@ -182,10 +182,14 @@ UI-Feedback der Tester ohnehin noch ausstehen.
## Phase 2 – 3D-Präsentation
- [ ] 3D-Rink und Skater auf Basis desselben Datenmodells
- [x] Externe Asset-Pipeline (Manifest, Hash-Prüfung, Sync nach `assets/external/`)
- [x] Geriggter Skater (AutoRigPro, 226 Control-/30 Deform-Bones, glTF-Export)
- [x] Animations-Bake und Godot-Import eines Testclips (`TestWave`)
- [ ] 3D-Rink und Skater auf Basis desselben Datenmodells im Godot-Prototyp
- [ ] Rotoscoping-Workflow und erste echte Animationsclips
- [ ] NLA-/Animations-Tracks aus Blender
- [ ] Blender-MCP und Godot-Editor-MCP für den Asset-Workflow
- [ ] Klare Trennung: Phase 1 bleibt ohne 3D-Abhängigkeiten lauffähig
- [x] Klare Trennung: Phase 1 bleibt ohne 3D-Abhängigkeiten lauffähig
## Bewusst nicht jetzt