feat: added French support

This commit is contained in:
Xiaohan-Tian
2026-05-30 23:37:51 -07:00
parent 4c82f514d7
commit e263b1cc41
25 changed files with 862 additions and 29 deletions
+107
View File
@@ -0,0 +1,107 @@
## Aide
Bienvenue dans **lassistant musical K.G.Studio**, votre agent IA dédié à la composition, à larrangement et au travail de production directement dans le navigateur.
Pour commencer, vous pouvez soit utiliser le **LLM local intégré au navigateur** sans clé API, soit configurer un fournisseur LLM externe.
---
### Utiliser le LLM local (navigateur) sans clé API
K.G.Studio peut exécuter **Gemma 4 E4B** entièrement dans votre navigateur avec accélération WebGPU. Aucune requête API externe nest envoyée, aucun coût supplémentaire nest engagé, et vos données restent sur votre machine.
1. Dans **Réglages ⚙️ → Général → Fournisseur LLM**, sélectionnez **LLM local (navigateur)**.
2. Le modèle (~2,8 Go) se télécharge automatiquement lors de la première ouverture du chat, puis reste en cache local pour les lancements suivants.
3. Vous pouvez régler la **Longueur de contexte** (32k / 64k / 128k tokens) selon votre matériel.
4. Commencez à dialoguer.
**Configuration recommandée :** Chrome 113+ ou Edge 113+, contexte sécurisé (HTTPS ou localhost), et GPU avec au moins 8 Go de VRAM ou machine avec au moins 16 Go de mémoire unifiée.
> Remarque : la qualité du modèle local reste inférieure à celle des grands modèles commerciaux. Pour les tâches complexes, un fournisseur externe donnera généralement de meilleurs résultats.
---
### Configurer un fournisseur LLM externe
Allez dans **Réglages ⚙️ → Général → Fournisseur LLM**. Selon le fournisseur choisi, vous devrez renseigner la clé API appropriée et, si besoin, une URL de base personnalisée.
---
### Utiliser OpenAI
1. Récupérez une clé API OpenAI depuis [**OpenAI**](https://platform.openai.com/account/api-keys).
2. Dans **Réglages ⚙️ → Général → Fournisseur LLM**, choisissez **OpenAI**.
3. Saisissez votre clé dans **OpenAI → Clé**.
4. Sélectionnez le modèle voulu dans **OpenAI → Modèle**. Pour un bon compromis coût / performances, `gpt-5.4-mini` est recommandé.
5. Vous pouvez activer **Mode Flex** si vous acceptez une latence plus variable en échange dun coût potentiellement réduit.
---
### Utiliser OpenRouter
OpenRouter donne accès à de nombreux modèles via une API unique, y compris certaines options gratuites.
1. Créez une clé API sur [**OpenRouter**](https://openrouter.ai/keys).
2. Dans **Réglages ⚙️ → Général → Fournisseur LLM**, choisissez **Serveur compatible OpenAI**.
3. Saisissez votre clé dans **Serveur compatible OpenAI → Clé**.
4. Consultez les modèles disponibles sur la [**page des modèles OpenRouter**](https://openrouter.ai/models).
5. Saisissez le nom du modèle dans **Serveur compatible OpenAI → Modèle**.
6. Saisissez `https://openrouter.ai/api/v1` dans **Serveur compatible OpenAI → URL de base**.
### Opérations DAW de base
Commandes du chat : `/clear`, `/welcome`, `/help`, `/hotkeys`
- Pistes
- Ajouter, renommer et réordonner les pistes depuis le panneau dinfos de piste.
- Changer dinstrument via le bouton instrument ; régler Solo, Mute et Volume.
- Supprimer une piste depuis son menu de réglages.
- **Enregistrement audio** : cliquez sur `Rec` dans la barre doutils pour enregistrer directement dans une piste audio.
- Régions
- Créer une région : avec loutil pointeur, double-cliquez ; ou maintenez `Ctrl/Cmd` et cliquez. Avec loutil crayon, un simple clic suffit.
- Déplacer / redimensionner : faites glisser le corps de région pour déplacer, ou les bords pour redimensionner.
- Ouvrir le Piano Roll via le petit crayon en haut à gauche de la région.
- Piano Roll
- Outils : Sélection ou Crayon.
- Créer des notes : double-clic ou `Ctrl/Cmd+clic` en mode sélection ; clic simple en mode crayon.
- Sélectionner : clic, `Maj+clic` pour la multisélection, ou glisser pour un lasso.
- Déplacer / redimensionner : faites glisser le corps ou les bords des notes.
- **Vue partition** : bascule entre Piano Roll et notation sur portée depuis la barre doutils.
- **Voies dautomation** : éditez le pitch bend et les courbes MIDI CC sous la grille piano.
- **Mode spectrogramme** : affichez le spectrogramme dune région audio comme référence d’édition.
- **Liste des événements** : inspectez et modifiez les notes, pitch bends et contrôleurs de la région MIDI active.
- Système de pistes globales
- Quatre pistes permanentes en haut de la timeline : **Repère**, **Tempo**, **Armure** et **Accord**.
- Elles pilotent le timing, les suggestions daccords, laffichage de la partition et certains résultats danalyse.
- Analyse audio
- **Détecter les accords** : ouvre lanalyse harmonique dune région audio et alimente la piste globale des accords.
- **Détecter le tempo** : analyse une région audio pour en extraire le BPM et peut réaligner le tempo du projet.
- Générateur musical K.G.One
- Cliquez sur le bouton **✦** dans la barre doutils.
- **Morceau complet** : génération dun titre complet à partir dune description et, si besoin, de paroles.
- **Clip** : génération de clips instrumentaux courts et de boucles MIDI.
- **Séparation de stems (navigateur)** : séparation locale dune région audio en stems, sans serveur.
- Snap et quantification
- Réglez le snap depuis le menu `NO SNAP`.
- Quantifiez avec `Qua. Pos.` et `Qua. Len.`.
- Lecture
- Retour au début ; Lecture / Pause depuis la barre doutils.
- Placez la tête de lecture en cliquant sur les numéros de mesure.
- Changez BPM, chiffrage de mesure et armure depuis la barre doutils.
---
### Remarque
Par sécurité, lorsque K.G.Studio tourne hors dun hôte local, les clés API ne sont pas conservées dans IndexedDB par défaut. Vous pouvez activer leur persistance dans les réglages, mais ce nest pas recommandé sur un environnement partagé.
### Avertissement
K.G.Studio nhéberge aucun des modèles mentionnés et nest affilié à aucun fournisseur de modèles. Toutes les données restent sur votre appareil ; vous êtes responsable des informations envoyées à des services tiers.
+59
View File
@@ -0,0 +1,59 @@
## Raccourcis
Ce guide récapitule les raccourcis clavier et les actions avec modificateurs actuellement disponibles dans K.G.Studio.
### Création selon la plateforme
- Sur **macOS**, utilisez `Cmd+clic` pour créer une région, une note ou un point dautomation avec loutil pointeur.
- Sur **Windows/Linux**, utilisez `Ctrl+clic` pour créer une région, une note ou un point dautomation avec loutil pointeur.
- Dans la timeline principale, un double-clic dans une zone vide crée une région lorsque loutil pointeur est actif.
- Dans le Piano Roll et les voies dautomation, loutil crayon permet aussi de créer avec un simple clic.
### Raccourcis principaux
- `Espace` — Lecture / Arrêt
- `C` — Activer / désactiver la boucle
- `R` — Démarrer / arrêter lenregistrement
- `Cmd/Ctrl+Z` — Annuler
- `Cmd/Ctrl+Shift+Z` — Rétablir
- `Cmd/Ctrl+C` — Copier les éléments sélectionnés
- `Cmd/Ctrl+V` — Coller
- `Cmd/Ctrl+S` — Enregistrer le projet
- `Cmd/Ctrl+A` — Sélectionner toutes les notes de la région MIDI active
- `Cmd/Ctrl+T` — Couper la région sélectionnée à la tête de lecture
- `Cmd/Ctrl+J` — Fusionner les régions MIDI sélectionnées
### Fenêtre de région / Piano Roll
- `E` — Ouvrir le Piano Roll pour une région MIDI sélectionnée, ou l’éditeur de forme donde pour une région audio sélectionnée. Si l’éditeur est déjà ouvert, `E` le ferme.
- `N` — Ouvrir le Piano Roll en vue partition pour une région MIDI sélectionnée.
- `Suppr` / `Retour arrière` — Supprimer les régions, notes ou points dautomation sélectionnés.
- `Esc` — Fermer la fenêtre du Piano Roll.
### Sélection
- `Maj+clic` — Ajouter à la sélection.
- Lasso dans une zone vide — Sélection rectangulaire de régions ou de points dautomation.
- `Maj+lasso` dans la fenêtre Piano Roll — Basculer la sélection des éléments contenus dans la zone.
### Raccourcis du Piano Roll
- `G` — Faire défiler les modes du guide daccords
- `Tab` — Aller à la suggestion daccord suivante
- `Maj+Tab` — Revenir à la suggestion daccord ou au renversement précédent
### Raccourcis de snap
- `1` — Aucun snap
- `2` — Snap sur `1/4`
- `3` — Snap sur `1/8`
- `4` — Snap sur `1/16`
### Raccourcis de quantification
- `5` — Quantification de position sur `1/4`
- `6` — Quantification de position sur `1/8`
- `7` — Quantification de position sur `1/16`
- `8` — Quantification de durée sur `1/4`
- `9` — Quantification de durée sur `1/8`
- `0` — Quantification de durée sur `1/16`
+11
View File
@@ -0,0 +1,11 @@
## Bon retour
Ravi de vous revoir. Votre fournisseur LLM semble déjà configuré, vous pouvez commencer à dialoguer immédiatement.
Conseils :
- Utilisez `/clear` à tout moment pour réinitialiser le chat.
- Tapez `/welcome` pour réafficher ce message.
- Tapez `/help` pour ouvrir laide.
- Tapez `/hotkeys` pour afficher le guide des raccourcis.
Bonne composition avec lassistant musical K.G.Studio.
+29
View File
@@ -0,0 +1,29 @@
## Mode LLM local
Bienvenue dans **lassistant musical K.G.Studio** en mode LLM local.
- Aucune API externe nest nécessaire. Tout sexécute directement dans votre navigateur, sans coût API supplémentaire.
- Ce mode utilise **Gemma 4 E4B** via **LiteRT-LM** avec accélération **WebGPU**.
- Configuration matérielle recommandée : GPU avec au moins **8 Go de VRAM** ou système avec au moins **16 Go de mémoire unifiée**.
- Les performances restent plus limitées que celles des grands modèles hébergés dans le cloud, surtout pour les tâches longues, complexes ou très itératives.
### Flux de travail recommandé
- Gardez des demandes courtes et ciblées.
- Faites progresser le modèle étape par étape vers le résultat final.
- Travaillez sur de petites régions musicales plutôt que sur des arrangements de morceau complet.
- Préférez des consignes darrangement simples lorsque cest possible.
- Ouvrez une nouvelle conversation pour chaque tâche autonome.
Exemple :
- Pour de meilleurs résultats, découpez les demandes complexes en plusieurs étapes.
- Si vous voulez que le modèle écrive une progression daccords à partir de la musique actuelle, commencez par : `Please read the current music.`
- Une fois cette étape terminée, poursuivez avec : `Please write a chord progression based on it.`
- Ce flux incrémental est généralement plus fiable en mode LLM local.
- Gardez la région MIDI que vous souhaitez modifier sélectionnée pendant tout le flux de travail.
- Il nest pas nécessaire de changer de sélection vers une autre région uniquement pour `read_music`, car `read_music` peut lire la musique sur lensemble des pistes.
### Utiliser plutôt un LLM externe
- Si vous souhaitez utiliser un modèle plus grand dans le cloud ou auto-hébergé, ouvrez **Réglages -> Général -> Fournisseur LLM** et quittez **LLM local (navigateur)**.
- Pour un modèle cloud, vous pouvez utiliser **OpenAI**, ou **Serveur compatible OpenAI** avec un fournisseur comme OpenRouter.
- Pour un modèle auto-hébergé, choisissez **Serveur compatible OpenAI** puis renseignez l**URL de base** et le **Modèle** de votre serveur.
- Après changement de fournisseur, démarrez une nouvelle conversation pour repartir proprement avec le nouveau modèle.
+25
View File
@@ -0,0 +1,25 @@
## Bienvenue
Bienvenue dans **lassistant musical K.G.Studio**, votre partenaire IA dans le navigateur pour la composition et larrangement.
### Démarrage rapide
**Configurer lassistant musical K.G.Studio**
- [Cliquez ici pour obtenir une clé API OpenRouter gratuite](https://openrouter.ai/keys) ; un compte OpenRouter peut être nécessaire.
- Dans **Réglages ⚙️ → Général → Fournisseur LLM**, sélectionnez **Serveur compatible OpenAI**.
- Dans **Serveur compatible OpenAI → Clé**, collez votre clé. Remarque : hors localhost, la clé nest pas conservée après rechargement.
- Dans **Serveur compatible OpenAI → Modèle**, saisissez `qwen/qwen3-30b-a3b:free`.
- Dans **Serveur compatible OpenAI → URL de base**, saisissez `https://openrouter.ai/api/v1`.
*(Vous pouvez aussi utiliser lAPI officielle OpenAI ou tout autre service compatible OpenAI.)*
**Opérations DAW de base**
- Double-cliquez sur une piste, ou faites `Ctrl/Cmd+clic`, pour créer une région.
- Faites glisser les bords dune région pour la redimensionner ; faites glisser son corps pour la déplacer.
- Cliquez sur le petit crayon en haut à gauche dune région pour ouvrir le Piano Roll.
- Dans le Piano Roll, double-cliquez ou faites `Ctrl/Cmd+clic` pour créer une note.
- Cliquez pour sélectionner ; `Maj+clic` pour la multisélection ; glissez pour une sélection rectangulaire.
- Faites glisser les bords dune note pour modifier sa durée, ou son corps pour la déplacer.
- Utilisez le snap dans la barre doutils du Piano Roll pour quantifier sur la grille.
### Avertissement
K.G.Studio nest affilié à aucun fournisseur LLM. Toutes les données sont stockées localement sur votre appareil ; vous restez responsable des données envoyées à des services tiers.