yakui-studio

Yakui Studio

Connecte l'analyse audio réelle, la transcription candidate, la retouche manuelle et l'édition de projets. Suivez les références spécifiées par l'utilisateur et la musique approuvée ; la création musicale elle-même n'autorise pas la modification de jeux ou de packages de distribution.

Démarrage et ressources

Le package npm fournit l'atelier local yakui-studio ; yakui-studio --no-open démarre uniquement le service. yakui-studio setup --agent codex|claude|opencode|all installe cette extension et procedural-chiptune au même niveau ; par défaut codex. Les destinations sont respectivement $CODEX_HOME/skills (par défaut ~/.codex/skills), ~/.claude/skills, ~/.config/opencode/skills (respecte XDG_CONFIG_HOME). --skills-dir PATH spécifie un seul répertoire, --replace sauvegarde la version existante avant l'installation. Lorsque les extensions sont copiées vers une autre destination, les deux doivent rester des dossiers adjacents.

• yakui-studio music setup --profile basic : Configure l'environnement Python nécessaire à l'analyse / la synthèse procédurale.
• yakui-studio music setup --profile transcribe : Installe les dépendances pour pistes réelles et transcription selon les besoins ; la première séparation de pistes peut nécessiter un téléchargement de modèle.
• music analyze/separate/transcribe/review/init/render appelle les outils Python fournis avec le package ; music import convertit les candidats en projet d'atelier. Exécutez la sous-commande correspondante avec --help pour vérifier les paramètres actuels, en particulier le mode de transcription, les chemins d'entrée/sortie et le BPM.

Si seule l'extension est installée, vous pouvez toujours exécuter directement les outils dans procedural-chiptune/scripts ; les chemins des scripts et modèles sont résolus par rapport au répertoire de cette extension. Python 3.10+ et NumPy sont nécessaires pour la synthèse de base ; le décodage audio et le MP3 nécessitent FFmpeg. Voir Pistes réelles et transcription pour les dépendances des modèles.

Si le shell ne trouve pas yakui-studio, utilisez npx --yes --package [email protected] yakui-studio --help ; les commandes suivantes ajoutent également leurs arguments après ce préfixe. L'installation de l'extension n'installe pas le CLI de l'agent, ne connecte pas de compte et ne télécharge pas de modèle musical. Codex et OpenCode utilisent leurs propres configurations de connexion et de modèle ; l'interface candidate intégrée de Claude Code est réservée pour une fonctionnalité future. Dans l'atelier, le mode candidat désactive les outils ; les agents externes manipulent le projet via le CLI décrit ci-dessous.

Opérations de l'agent externe sur l'atelier courant

Exécutez d'abord yakui-studio project --help et yakui-studio project read pour lire le projet courant, la révision, les segments de piste et la sélection dans le navigateur. Le service écoute par défaut sur http://127.0.0.1:5240 ; utilisez YAKUI_STUDIO_URL pour pointer vers l'instance réellement ouverte par l'utilisateur, sans en créer une nouvelle instance vide à la place.

• yakui-studio project selection lit la sélection, project selection --file selection.json met à jour la sélection.
• yakui-studio project apply --file operations.json applique une édition. Le fichier doit utiliser le projectId, baseRevision lus précédemment, un nouveau operationId et operations ; voir Protocole CLI du projet pour les types d'opérations, champs et exemples complets. En cas de conflit de version, relisez et réévaluez l'édition ; ne remplacez pas brutalement la révision pour écraser les modifications de l'utilisateur.
• yakui-studio project import input.json ou input.mid importe ; project export output.json ou output.mid exporte. Avant d'importer, exportez le projet courant pour conserver le matériel approuvé par l'utilisateur et pouvoir le restaurer.
• yakui-studio project undo --revision N --project ID et redo --revision N --project ID manipulent l'historique d'annulation du même service.

Après une édition, relisez avec project read pour vérifier la révision et les notes réelles, et informez l'utilisateur des pistes/segments modifiés. L'atelier voit immédiatement les modifications du même projet. Écrire uniquement un JSON sur le disque ne modifie pas automatiquement le projet ouvert.

Du référent au projet

1. Une fois obtenu un fichier audio réellement décodable, suivez Analyse de référence pour vérifier le tempo, le demi-tempo/double tempo et les pulsations de plusieurs phrases musicales. Avec seulement un titre ou un lien, ne prétendez pas avoir écouté ou transcrit.
2. Lorsque des pistes réelles sont nécessaires, utilisez Demucs et conservez les sources réelles du modèle ; drums/bass/other/vocals ne garantissent pas la mélodie principale / la réponse. Utilisez Basic Pitch ONNX pour les instruments polyphoniques séparés, et pYIN par comparaison sur les segments clairement monophoniques. Validez d'abord sur de courts extraits avant d'étendre à l'ensemble du morceau.
3. Conservez les candidats originaux, la source, le temps en secondes, les valeurs de confiance/activation, le pitch bend et la justification humaine. Utilisez music review ou review_notes.py pour appliquer des fenêtres de rôle et des éditions explicites, en conservant l'état "avant". Les rôles en conflit restent "non assignés", les champs de quantification sont traités comme des données dérivées.
4. Convertissez en projet d'atelier avec music import, puis ouvrez le JSON dans l'interface. Conservez les fichiers candidats originaux ; l'import mappe les notes sur des unités de temps éditables (pulsations). Si le format de destination ne peut pas contenir les informations de pitch bend, expliquez la limitation ; ne considérez pas l'export du projet comme l'intégralité des preuves originales.
5. Dans l'éditeur de piste, sélectionnez un segment, ouvrez le rouleau de piano, vérifiez l'octave, le temps de début, la durée, les notes répétées, les ornements et les parties simultanées. Utilisez le solo, la boucle de segment et les propriétés numériques pour peaufiner segment par segment. Sauvegardez le JSON du projet comme livrable éditable.

Collaboration manuelle et IA

Le point de départ d'un segment est le nombre de pulsations depuis le début du morceau ; le début des notes est relatif au segment. L'unité de temps est la noire. Faites attention aux limites des segments et aux notes prolongées entre segments. Les éditions du projet, l'annulation et le rétablissement modifient la révision.

L'IA utilise des sélections de notes/temps explicites pour générer des candidats, les compare par écoute, puis les applique ou les rejette ; les candidats obsolètes sont régénérés après un changement de projet. Les propositions d'arrangement de l'IA ne constituent pas une preuve de transcription précise de l'audio de référence. Même sans agent configuré, l'utilisateur peut éditer, écouter et exporter manuellement ; si l'agent n'est pas disponible ou que l'authentification échoue, signalez-le honnêtement.

La musique procédurale originale suit la voie init/render de procedural-chiptune ; modifiez le motif du template, ne changez pas seulement le BPM. Voir score-format pour le format de la partition d'événements. La synthèse dans le navigateur et le rendu Python ne sont pas identiques échantillon par échantillon.

Critères de livraison

"Candidat extrait", "partiellement révisé manuellement", "validé par rapport à la référence sur toute la plage" doivent être exprimés distinctement. La sortie du modèle, la réussite de l'importation ou celle de la modification IA ne constituent pas à elles seules une transcription précise. Mentionnez la plage vérifiée, les parties non assignées et les notes incertaines ; marquez clairement les réponses originales.

Livrez un projet éditable, les candidats originaux nécessaires et l'historique des révisions, ainsi qu'une écoute jouable. Le JSON du projet conserve les pistes et les segments, la partition d'événements sert au rendu procédural, le MIDI à l'édition externe, le WAV à l'écoute. L'enregistrement de référence n'est pas automatiquement mixé dans la piste synthétisée ni dans le package npm. Si l'écoute réelle n'est pas disponible, indiquez-le clairement et fournissez l'audio pour que l'utilisateur puisse l'écouter.