À propos du projet
OpenCode SubAgent Magazine est un plugin destiné au TUI d'OpenCode, visant à fournir une surveillance en temps réel des sous-agents et une visualisation dans une barre latérale. Il charge et affiche les informations des sous-agents comme un chargeur, aidant l'utilisateur à suivre visuellement l'état d'exécution, la consommation de tokens, le coût, la durée, le modèle et la progression de chaque sous-agent.
Les principales fonctionnalités du plugin incluent :
- **Affichage d'état en temps réel** : via des points colorés (vert terminé, jaune en cours avec animation de respiration, rouge erreur), l'état de chaque sous-agent est visible d'un coup d'œil.
- **Suivi des tokens et des coûts** : agrège la consommation de tokens et le coût de chaque sous-agent, avec un affichage global dans la barre de titre.
- **Détails dépliables** : un clic sur une entrée déploie le type d'agent, l'état, la durée, les tokens, le coût, le modèle, la progression et d'autres informations détaillées, avec les valeurs alignées à droite pour faciliter la lecture.
- **Accès à la session en un clic** : après dépliage, un clic sur « → 进入会话 » permet d'accéder directement à la conversation complète de ce sous-agent.
- **Affichage de l'ID de session** : les détails dépliés montrent le Session ID du sous-agent ; un clic ouvre une fenêtre pour voir l'ID complet et le copier.
- **Marquage manuel comme terminé** : pour les entrées zombies bloquées, le bouton « - 标记完成 » à droite de la zone dépliée permet de les terminer manuellement, ou d'utiliser `/subagent-clear-running` pour un nettoyage groupé.
- **Panneau repliable** : un clic sur la barre de titre replie/déplie le panneau, l'état est persistant et conservé après redémarrage.
- **Défilement vers le haut/bas** : des boutons « ↑ 回顶 » et « ↓ 回底 » sont disponibles en bas de liste, avec une direction adaptée au tri.
- **Tri configurable** : via `/subagent-order`, prise en charge d'un ordre décroissant (plus récent en premier) ou croissant (plus ancien en premier).
- **Changement de mode de pagination** : `/subagent-scroll` permet de choisir entre « pagination à la molette » ou « pagination par clic sur more », résolvant les conflits entre la barre latérale et le défilement global.
- **Nettoyage automatique TTL** : durée de conservation des données configurable (3/7/14/30 jours ou illimitée), renouvelée automatiquement à chaque accès, suppression automatique à expiration.
- **Suppression manuelle des entrées** : `/subagent-clear-entries` efface tous les enregistrements de la session en cours, empêchant la reconstruction par analyse des entrées historiques.
- **Adaptation linguistique** : prise en charge de `/subagent-lang` pour basculer à l'exécution entre chinois et anglais, avec persistance de la préférence.
- **Bordure commutable** : `/subagent-border` contrôle l'affichage de la bordure extérieure du panneau (masquée par défaut) ; une fois activée, le style s'harmonise avec le panneau de statistiques du cache.
- **Commandes slash** : fournit des commandes de configuration dynamique telles que `/subagent-lang`, `/subagent-max`, `/subagent-order`, `/subagent-scroll`, `/subagent-ttl`, `/subagent-clear-entries`, `/subagent-session`, `/subagent-version`, `/subagent-clear-running`, `/subagent-border`.
Concernant l'installation, le plugin prend en charge à la fois opencode 1.x et 2.x. Pour 2.x, il faut ajouter une entrée dans le tableau `plugins` de `~/.config/opencode/cli.json` ; pour 1.x, l'installation peut se faire via la palette de commandes ou par configuration manuelle de `tui.jsonc`. Attention à ne pas utiliser `opencode plugin add` pour l'installation, car cette commande écrit dans la configuration du plugin serveur et provoque des erreurs.
Le guide d'utilisation détaille l'usage des commandes slash, les opérations clavier et souris (comme le clic sur la barre de titre pour replier, le clic sur une entrée pour déplier, la molette pour paginer, etc.), ainsi que la signification des couleurs d'état. Lors des mises à jour, il faut vider le cache du plugin et réinstaller, car OpenCode présente un problème connu qui verrouille la version du plugin.
Le plugin est totalement indépendant du modèle et prend en charge tous les modèles IA compatibles avec OpenCode (comme DeepSeek, Claude, GPT, etc.) ; les données sont obtenues via les interfaces standard du SDK OpenCode. Licence MIT.
Comments
0 people shared their preference · Deer Point appears after 10 participants
Sign in to join the discussion.