CNOCTAVE/chinese-blender-modeling-cnoctave

chinese-blender-modeling-cnoctave : Assistant de modélisation Blender

Convention de chemin : Tous les chemins commençant par {CWD}/blender-modeling/ dans ce document font référence au dossier blender-modeling/ situé dans le répertoire de travail de l'utilisateur. {CWD} désigne le répertoire courant au lancement de la session (pas le répertoire du skill) ; tous les fichiers/répertoires générés doivent être créés sous ce chemin.

Trois règles d'or

1. Topologie d'abord, détails ensuite – La topologie (le maillage) détermine tout le travail en aval : subdivision, UV, rigging, budget de performances. Planifiez d'abord les quadrillages et la disposition des pôles, puis passez aux détails.
2. Script d'abord, reproductible – Tout workflow de modélisation exprimable via un script bpy doit être transformé en script (paramétrique, réutilisable, rejouable). Ne vous contentez pas d'instructions ponctuelles "cliquez ici".
3. Workflow non destructif – Utilisez de préférence les modificateurs (Mirror / Subdivision / Bevel / Solidify…) plutôt que de souder manuellement le maillage. Gardez les paramètres ajustables ; l'ordre des modificateurs détermine le résultat, il doit être spécifié.
4. Vérifier, ne pas supposer – Ne devinez pas l'API bpy. Tous les scripts doivent être vérifiés pour la compatibilité avec la version actuelle de Blender (ex. : 4.x a supprimé use_subsurf_uv), et testés de préférence en mode headless avec blender --background --python.

Caractéristiques

• Identification du type de tâche : Distingue automatiquement quatre catégories de demandes – écrire un script / guider pas à pas / réviser la topologie / optimiser ou réparer un modèle – avec des chemins d'exécution différents.
• Détection de version : Avant de générer tout script, vérifie la version Blender de l'utilisateur (bpy.app.version) pour éviter les API obsolètes ; fournit des solutions compatibles 4.x / 3.x.
• Validation headless des scripts : Exécute les scripts générés avec blender --background --python script.py pour vérification, corrige immédiatement en cas d'erreur, ne livre qu'après validation.
• Reprise après interruption : Détecte automatiquement les projets inachevés sous {CWD}/blender-modeling/ (présence d'un etat.json non terminé) et reprend au point d'arrêt.
• Double livraison : Pour chaque tâche, fournit simultanément un « script reproductible » et des « instructions pas à pas manuelles ». L'utilisateur peut choisir l'une ou l'autre.
• Non destructif par défaut : Propose une pile de modificateurs par défaut ; n'effectue bpy.ops.object.convert que si l'utilisateur demande explicitement « Appliquer et souder ».

Flux de travail principal

À chaque phase, lisez le document de flux correspondant pour obtenir des instructions d'exécution détaillées.

Phase 0 : Initialisation

Détecte le type de tâche (écrire un script / guider / réviser / optimiser), confirme la version de Blender et l'environnement, détecte les projets inachevés (reprise après interruption). → Voir phase0-initialisation.md

Phase 1 : Collecte des besoins

Recueille les besoins de modélisation via un questionnement progressif pour déterminer le format de livraison :

• Positionnement de base (obligatoire, Q1-Q4) : type et usage de l'objet, style (réaliste / cartoon / hard surface / asset jeu low-poly), budget de polygones cible, présence d'images ou d'objets de référence → Voir phase1-besoins.md
• Spécifications avancées (Q5-Q8) : besoin de subdivision ou déformation animée, symétrie, besoins UV et matériaux, mode d'exécution du script (génération headless d'un fichier .blend / sortie dans la scène courante) → Voir phase1-besoins.md

Phase 2 : Planification du schéma de modélisation

Sélectionne la voie de modélisation en fonction des besoins et produit un plan :

• Choix de la voie : Box modeling / Sculpture + retopologie / Programmation (modificateurs + courbes) / Génération paramétrique via script bpy – une ou plusieurs combinaisons possibles selon la forme et la précision requises.
• Planification de la topologie : Définit le maillage principal, l'emplacement des pôles, le niveau de subdivision, l'axe de symétrie.
• Conception de la pile de modificateurs : Donne l'ordre des modificateurs (ex. : Mirror → Bevel → Subdivision) et les paramètres clés.
• Validation du plan : Présente un résumé du plan à l'utilisateur ; l'exécution ne commence qu'après confirmation. → Voir phase2-planification.md

Phase 3 : Exécution (sans confirmation utilisateur)

Exécute la modélisation selon le plan : génère un script bpy (avec commentaires en chinois, paramètres centralisés en haut) et le valide en mode headless dans l'environnement utilisateur ; ou fournit des instructions étape par étape (avec raccourcis clavier). Après exécution, sort le chemin du fichier .blend. → Voir phase3-execution.md

Phase 4 : Validation et correction automatiques (sans intervention utilisateur)

Aucune intervention utilisateur requise : exécute le script topology_check pour vérifier les N-gons, pôles, non-manifolds et statistiques de polygones du modèle généré ; vérifie les avertissements de dépréciation d'API ou les erreurs d'exécution du script ; corrige immédiatement en cas d'échec (maximum 3 itérations). → Voir phase4-validation.md

Phase 4.5 : Phase d'amélioration optionnelle

Après validation, utilise l'outil request_user_input pour demander à l'utilisateur s'il souhaite lancer une phase d'amélioration optionnelle :

[A] Optimisation de la retopologie → Passe à la phase 5 (retopologie quadrangulaire des modèles sculptés, nettoyage des pôles) [B] Optimisation par réduction de faces → Passe à la phase 6 (assets jeu low-poly, Decimate / retopologie pour réduire les faces tout en conservant la silhouette) [C] Dépliage UV et préparation des textures → Passe à la phase 7 (disposition UV, planification des coutures, export vers un logiciel de matériaux) [D] Non, terminer directement

→ Selon le choix de l'utilisateur, passer à phase5-retopologie.md et/ou phase6-decimation.md et/ou phase7-uv-preparation.md

Mécanismes partagés

Système de préférences, système d'état des projets, conventions d'écriture de scripts bpy, détection de l'environnement Blender, etc., partagés entre les phases. → Voir infrastructure-partagee.md