Référence CLI

Le CLI comp-hub fournit un ensemble de commandes pour gérer votre serveur de développement local. Plusieurs projets peuvent s'exécuter simultanément, chacun avec son propre port.

Le CLI est publié avec trois noms binaires — comphub, ch et comp-hub — qui pointent tous vers le même programme. Toutes les commandes ci-dessous fonctionnent avec n'importe lequel, par exemple ch status, comp-hub -p 8080.

Aperçu des commandes

Commande	Description
comphub	Démarrer le serveur de développement pour le projet actuel
comphub status	Afficher l'état du maître et tous les projets en cours d'exécution
comphub stop <hash>	Arrêter un projet spécifique
comphub stop --all	Arrêter tous les projets
comphub kill	Arrêter le processus maître
comphub fix	Corriger les problèmes courants (fichier d'exécution obsolète, etc.)

---

comphub — Démarrer le serveur

Exécutez dans le répertoire du projet pour démarrer le serveur de développement et prévisualiser les composants dans le navigateur.

comphub

Options :

Option	Court	Type	Défaut	Description
--port	-p	number	5478	Port du service
--dir	-d	path	"./"	Chemin relatif du répertoire des ressources
--log-level	-l	string	"error"	Niveau de journal : debug, info, warn, error

| --version | -v | - | - | Afficher la version | | --help | -h | - | - | Afficher l'aide |

--port ne s'applique que si aucun processus maître n'est encore en cours. Si un maître est déjà actif, le CLI le réutilise et affiche un avertissement indiquant que -p est ignoré ; exécutez d'abord comphub kill si vous avez vraiment besoin d'un autre port.

Exemples :

# Démarrer avec le port par défaut
comphub

# Utiliser un port personnalisé
comphub -p 8080

# Spécifier le répertoire
comphub -d ./src

Après un démarrage réussi, vous verrez les informations du projet et l'URL d'accès :

✓ comp-hub v0.44.11

   ██████╗  ██████╗  ███╗   ███╗ ██████╗       ██╗  ██╗ ██╗   ██╗ ██████╗
  ██╔════╝ ██╔═══██╗ ████╗ ████║ ██╔══██╗      ██║  ██║ ██║   ██║ ██╔══██╗
  ██║      ██║   ██║ ██╔████╔██║ ██████╔╝      ███████║ ██║   ██║ ██████╔╝
  ██║      ██║   ██║ ██║╚██╔╝██║ ██╔═══╝       ██╔══██║ ██║   ██║ ██╔══██╗
  ╚██████╗ ╚██████╔╝ ██║ ╚═╝ ██║ ██║           ██║  ██║ ╚██████╔╝ ██████╔╝
   ╚═════╝  ╚═════╝  ╚═╝     ╚═╝ ╚═╝           ╚═╝  ╚═╝  ╚═════╝  ╚═════╝


  Version  0.44.11
  Project  D:\project\housing\vue2
  Hash     94525912
  Port     5478

  URL      http://localhost:5478/94525912/main/

  ─────────────────────────────────────────────

  comphub status                View all projects
  comphub stop    94525912      Stop current project
  comphub stop    --all         Stop all projects
  comphub kill                  Shutdown master

Ouvrez l'URL dans votre navigateur pour entrer sur la plateforme.

Comportement au démarrage

• Vérification de version : avant de démarrer, le CLI interroge le service distant pour savoir si la version installée est encore autorisée. Si la version actuelle est bloquée, le démarrage s'arrête avec comp-hub must be upgraded before it can start ; exécutez npm install comp-hub@latest -g puis relancez. Si une version plus récente est seulement disponible, un simple avis est affiché et le démarrage continue.
• Flux de journaux : après la bannière, le CLI diffuse en continu les journaux MidwayJS de ce projet (SSE). Appuyez sur Ctrl+C pour arrêter : le projet est alors automatiquement désenregistré du maître.

---

comphub status — Afficher l'état

Voir quels projets sont actuellement en cours d'exécution.

comphub status

Exemple de sortie :

● Master Status

  Status      ● running
  Version     0.44.11
  Uptime      2m
  Projects    2

  ▸ Registered Projects (2):
  ────────────────────────────────────────────────────────
    hash     94525912
    path     D:\project\housing\vue2
    url      http://localhost:5478/94525912/main/
  ────────────────────────────────────────────────────────
    hash     a3f82109
    path     D:\project\housing\vue3
    url      http://localhost:5478/a3f82109/main/
  ────────────────────────────────────────────────────────

Si aucun service n'est en cours d'exécution :

✗ Master service is not running

---

comphub stop — Arrêter les projets

Arrêter un ou tous les projets en cours d'exécution sans affecter les autres.

# Arrêter un projet spécifique (utilisez status pour trouver le hash)
comphub stop <hash>

# Arrêter tous les projets
comphub stop --all

Exemples :

# Arrêter le projet avec le hash 94525912
comphub stop 94525912

# Arrêter tous les projets en une fois
comphub stop --all

---

comphub kill — Arrêter tous les services

Arrêtez tous les projets et services.

comphub kill

Cela termine le processus maître et tous les projets enregistrés. Exécutez comphub à nouveau pour redémarrer.

---

comphub fix — Corriger les problèmes courants

Nettoyez les fichiers d'exécution obsolètes et corrigez d'autres problèmes courants :

comphub fix

Ceci est utile lorsque :

• Un arrêt précédent a laissé un fichier de processus obsolète qui empêche un nouveau démarrage
• Vous devez réinitialiser l'état d'exécution local

---

Exécution de plusieurs projets

Vous pouvez exécuter différents projets en même temps :

# Terminal 1 : Démarrer le projet A
cd /path/to/project-a
comphub

# Terminal 2 : Démarrer le projet B
cd /path/to/project-b
comphub

# Vérifier tous les projets en cours d'exécution
comphub status

Chaque projet obtient son propre port et est accessible via une URL différente.