Extensions

Une extension peut proposer une page plein écran, par exemple un tableau de tâches. Ouvre-la depuis Pages des extensions au-dessus des sessions. Le menu apparaît uniquement pour les pages activées et approuvées. Choisir un chat, recharger, mettre en pause, supprimer ou changer de serveur ferme la page. L’extension ne peut pas l’ouvrir elle-même.

Ses propres données restent sur le serveur connecté et sont supprimées au retrait de l’extension. Un tableau peut suivre les sessions de plusieurs projets et worktrees sans créer de fichiers dans ton projet.

Utilise Paramètres → Extensions pour ajouter à OpenChamber des panneaux créés par d’autres personnes. Une extension est une petite page placée dans la barre de droite, à côté des panneaux intégrés. Elle peut t’afficher des données d’un autre service, attacher une tâche au chat et, si tu l’autorises, démarrer des sessions, envoyer des prompts ou lire des fichiers.

Les extensions fonctionnent dans OpenChamber web et desktop. VS Code et l’app mobile ne les chargent pas encore. Ce n’est pas la même chose que les plugins OpenCode.

En installer une

Les extensions marquées Intégrée sont fournies avec l’instance OpenChamber sélectionnée. Elles démarrent activées et reçoivent leurs autorisations déclarées sans dialogue supplémentaire. Utilisez Désactiver ou Activer sur leur carte. Elles ne se suppriment ni ne se mettent à jour séparément de l’application. La désactivation conserve les données et comptes connectés, et reste en vigueur après les mises à jour.

Leurs comptes figurent dans Paramètres → Intégrations → Intégrations natives. Un service peut encore demander un jeton API ou une connexion pour accéder à votre compte.

Ouvre Paramètres → Extensions.
Colle l’un de ces éléments dans le champ Dossier, ZIP ou URL et choisis Ajouter :
- le chemin absolu d’un dossier sur cet ordinateur
- le chemin d’un fichier .zip
- un lien https vers un dépôt git ou un fichier zip
- une adresse Git SSH comme [email protected]:owner/extension.git
Si l’extension demande des autorisations, une boîte de dialogue les liste. Choisis Autoriser et activer, ou Supprimer pour la retirer.

Tu peux aussi déposer un .zip sur le champ ou le choisir avec le bouton archive à côté ; l’archive est envoyée au serveur OpenChamber, donc cela fonctionne aussi avec une instance distante. Sur desktop, le bouton dossier ouvre un sélecteur natif, et un dossier déposé s’installe depuis son chemin.

L’icône de l’extension apparaît dans la barre. Si ce n’est pas le cas, consulte Dépannage.

Une installation depuis un dossier s’exécute directement depuis ce dossier, donc quelqu’un qui développe une extension peut modifier et recharger. Un zip ou une URL est d’abord copié dans le dossier de données d’OpenChamber ; le fichier d’origine n’est pas touché.

Dépôts privés et identités Git

Les installations SSH acceptent [email protected]:owner/extension.git et ssh://[email protected]/owner/extension.git, avec un suffixe #branch-or-tag facultatif. Choisissez l’identité globale ou une identité Git enregistrée dans le menu empreinte à côté du champ. Ce choix est conservé pour vérifier et installer les mises à jour. Un changement de clé s’applique à l’opération suivante.

L’identité globale utilise la configuration Git/SSH et l’agent SSH de l’utilisateur qui exécute le serveur OpenChamber sélectionné. Sur une instance distante, la clé doit être disponible sur ce serveur. Déverrouillez d’abord les clés protégées dans l’agent SSH de ce processus. HTTPS utilise les identifiants HTTPS de Git sans basculer automatiquement vers SSH. Les hôtes Git doivent résoudre vers des adresses publiques ; les alias SSH locaux et les destinations de réseaux privés ne sont pas pris en charge.

Ce qu’une extension peut faire

Afficher un panneau et lire quel projet et quelle session sont ouverts ne demande aucune autorisation. Tout ce qui agit en ton nom en demande une, et tu vois toute la liste une seule fois, à l’installation :

Envoyer des messages dans tes sessions : écrit et envoie des prompts au modèle, ce qui coûte des jetons et peut lancer des outils.
Accéder aux projets et sessions : lister les projets, worktrees et états des sessions, puis créer et ouvrir des sessions dans les projets enregistrés. Le contenu des conversations reste privé.
Lire et écrire les fichiers du projet : n’importe quel fichier du projet ouvert.
Lire et écrire des fichiers hors du projet : seulement les emplacements listés dans la boîte de dialogue.
Utiliser ton Small Model : génération de texte ponctuelle en dehors de tes sessions, avec le modèle défini dans Paramètres → Sessions → Small Model. Coûte des tokens.
Se connecter à un service externe : avec le compte que tu connectes dans Paramètres → Intégrations.
Lire la conversation d’une session : seulement quand tu lances l’action de l’extension sur cette session.
Exécuter un service local : un programme séparé avec tous les accès de ton compte utilisateur. N’autorise cela que si tu fais confiance à l’auteur.

Quand une version plus récente demande plus que ce que tu as autorisé, la carte affiche Approbation requise et un bouton Vérifier les autorisations. Tant que tu n’as pas autorisé la nouvelle liste, cette extension reste désactivée.

Où elle apparaît

En plus de son panneau dans la barre latérale, une extension peut ajouter des entrées à des menus que tu utilises déjà : les actions d’un message du chat, le menu d’une session, le menu + à côté de la zone de chat et des commandes slash comme /task ABC-12 qui attachent quelque chose sans rien ouvrir. Elle peut aussi donner à ses propres outils une vraie icône, un titre et une mise en page de sortie dans le chat, comme en ont les outils intégrés d’OpenChamber. L’extension décide lesquels elle propose ; tous restent désactivés tant que tu n’as pas autorisé l’extension.

Certaines extensions affichent une image en direct au lieu d’un panneau à elles : ce dans quoi un agent travaille sur le serveur, par exemple un navigateur ou un simulateur. Cliquez dans l’image ou tapez pour prendre le contrôle ; la ligne d’état indique Vous avez le contrôle et les actions de navigateur de l’agent sont refusées jusqu’à ce que vous appuyiez sur Rendre à l’agent. Copier et coller fonctionnent normalement. Un autre appareil connecté en même temps voit qui a le contrôle et ne peut pas le prendre. Une telle extension peut ajouter ses propres commandes à côté de l’image, par exemple une barre d’adresse au-dessus ou une colonne d’outils sur le côté.

Connecter son compte

Une extension qui parle à un service reçoit une carte dans Paramètres → Intégrations sous Comptes d’extensions. Selon le service, la carte demande un jeton d’API, un nom d’utilisateur et un jeton, ou un client id pour une connexion. Choisis Connecter ; Déconnecter oublie le jeton enregistré. Les champs supplémentaires que l’extension déclare s’enregistrent tout seuls quand tu les quittes.

Le jeton reste sur le serveur OpenChamber. La page de l’extension ne le voit jamais.

Mettre à jour

Les extensions installées depuis une URL git peuvent se mettre à jour toutes seules. Ouvrir Paramètres → Extensions vérifie chacune d’elles au plus une fois par heure ; Rechercher des mises à jour vérifie tout de suite. Une carte avec une version plus récente affiche Mise à jour disponible et un bouton Mettre à jour. La mise à jour garde tes autorisations, tes comptes et tes réglages ; si la nouvelle version en demande plus, la boîte de dialogue d’approbation réapparaît. Les installations depuis un dossier ou un zip ne se mettent pas à jour : remplace-les à la main.

Ajoute #v1.2.0 ou #stable à l’URL git à l’installation pour suivre un tag ou une branche plutôt que la branche par défaut.

Mettre en pause ou retirer

Chaque carte a un interrupteur Activé. Désactivé garde l’extension installée mais cache son panneau et bloque ses appels. Retirer supprime une installation par zip ou URL du dossier de données d’OpenChamber ; pour une installation depuis un dossier, il oublie seulement le chemin, ton dossier reste.

Créer la tienne

Tout ce qu’une extension peut faire, et comment en créer une, est dans Créer une extension.