CommunityRédaction et éditiongithub.com

jlc-cli

CLI non officiel pour le site chinois de JLC (嘉立创, jlc.com) : téléversement de PCB/Gerber, prévisualisation, paramètres de fabrication, devis, commandes, connexion et connexion par QR code.

Qu'est-ce que jlc-cli ?

Ce skill fournit une interface en ligne de commande (CLI) pour interagir avec le site chinois de JLC (嘉立创, jlc.com), permettant aux agents IA de gérer les flux métiers : téléversement de fichiers PCB/Gerber, prévisualisation, configuration des paramètres de fabrication, obtention de devis, création de commandes, connexion par mot de passe ou QR code, et consultation du solde pour paiement. Il ne remplace pas l'outillage de conception (EDA) ni la conversion locale de Gerber, et ne cible pas la version internationale JLCPCB. Le skill s'appuie sur le CLI communautaire `jlc-cli` (non officiel) et nécessite Node.js 22+, npm, Git et Google Chrome. Il offre une séparation claire des responsabilités : les commandes automatisées gèrent la majorité des opérations, tandis que les décisions humaines (validation de paiement, confirmation de commande) sont signalées via un mécanisme de « reprise CDP ». Le skill respecte des limites strictes pour éviter toute action non autorisée (pas de soumission de commande sans accord explicite, pas de faux témoignages de confirmation humaine). Il est compatible avec les plateformes d'agents IA comme Claude Code, Cursor ou Codex, et propose des références détaillées pour l'installation, le diagnostic de navigateur, la gestion des sessions et le traitement des résultats inconnus.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TXyy2023/jlc-cli/tree/main/skills/jlc-cli

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait jlc-cli ?

CLI métier pour interagir avec le site chinois de JLC (嘉立创). Projet communautaire non officiel, sans approbation de JLC. Utilisez les commandes pour les flux standards ; n'intervenez dans la page CDP conservée que lorsque la commande demande une prise en charge.

Vérification d'installation

Avant toute commande métier, exécutez jlc-cli --version puis jlc-cli --help. L'installation de ce skill n'installe pas automatiquement le CLI.

Si la commande est introuvable (command not found / non reconnue), expliquez que le CLI n'est pas installé ou absent du PATH, et fournissez le dépôt du projet et les instructions d'installation. Il n'est actuellement pas publié sur npm ; n'installez pas de paquet tiers du même nom. Préparez Node.js 22.12 ou supérieur, npm, Git et Google Chrome, puis installez depuis les sources :

git clone https://github.com/TXyy2023/jlc-cli.git
cd jlc-cli
npm ci
npm run build
npm pack
npm install -g ./jlc-com-cli-1.0.0-dev.1.tgz
jlc-cli --version
jlc-cli --help

Le nom du paquet correspond à la version de développement actuelle ; utilisez le nom de fichier réel généré par npm pack en cas de changement de version. Si le répertoire source existe déjà, vérifiez le chemin sans écraser le répertoire utilisateur. Après installation, revérifiez la version et l'aide, puis reprenez la tâche. Si la commande existe mais échoue au démarrage, rapportez l'erreur réelle et vérifiez la version de Node.js et le PATH ; ne traitez pas un échec de démarrage comme une absence d'installation pour réinstaller aveuglément.

Démarrage

Après vérification d'installation, exécutez jlc-cli browser doctor --json pour vérifier la disponibilité du navigateur. jlc-cli skill path renvoie le skill livré avec le CLI ; utilisez de préférence la documentation fournie avec la même version.

Pour la première utilisation, présentez d'abord la portée de l'initialisation via jlc-cli init --json à l'humain, obtenez son consentement explicite, puis exécutez jlc-cli init --accept --confirmed-by human. L'humain peut aussi exécuter init de manière interactive. Ensuite, configurez le navigateur, lancez la connexion et vérifiez auth status ; lors de la connexion par QR code, affichez le QR code actuel renvoyé par la commande. La finalisation de la connexion est déterminée par l'état du compte, pas seulement par la redirection de page ou l'action de scan. Une fois connecté, utilisez jlc-cli account show --json pour une vérification.

Le flux actuel utilise explicitement jlc-cli browser configure --clear-endpoint --engine chrome. Le runtime Obscura par défaut a été vérifié, mais des problèmes de compatibilité persistent avec le SPA du centre client réel et l'iframe de connexion ; ne considérez pas la connectivité du runtime comme disponible pour le métier, et ne prétendez pas avoir basculé automatiquement de navigateur. Si le CLI dispose de son propre mécanisme de changement de session, arrêtez d'abord cette session, consultez Commandes de navigateur et de connexion.

Index métier

BesoinGroupe de commandes et référence
Découverte d'installation, initialisation, navigateur, configuration du compte, connexion multiple, QR code, callback de succèsCommandes et connexion
Téléversement/analyse/prévisualisation, paramètres, devis, vérification et création de commandeFlux PCB
Commandes PCB/FPC, paiement par solde, Jia XiaozhiCommandes et paiement
État JSON, code de sortie, observation de tâche, reprise CDP, résultat inconnuRésultats et reprise

Limites décisionnelles impératives

  • default : les paramètres de production non décidés par l'utilisateur doivent être demandés. La présélection du site, la configuration précédente et les faits d'analyse ne deviennent pas automatiquement un choix utilisateur. auto : nécessite d'abord l'intention de l'utilisateur de confier le remplissage à l'Agent, puis suggestion et remplissage dans ses contraintes ; indiquez les justifications, demandez en cas de conflit. Le drapeau de mode n'est pas une autorisation.
  • Après configuration des paramètres, lisez les valeurs effectives. Si le site modifie ou réinitialise le choix utilisateur, rapportez la différence ; n'acceptez pas la valeur de remplacement au motif que le flux peut continuer.
  • Le téléversement, la prévisualisation et le devis n'autorisent pas automatiquement la création de commande. Lorsque l'utilisateur a autorisé la création de commande, vérifiez d'abord le résumé, puis soumettez clairement ; ne considérez pas un devis comme une commande ou un paiement.
  • Chaque paiement par solde nécessite une confirmation humaine du compte courant, de la commande, du montant et du mode de paiement. Ne transmettez --human-confirmed que si le résumé actuel a bien obtenu l'accord explicite de l'humain ; ne falsifiez pas la confirmation et ne modifiez pas les enregistrements locaux. Le CLI vérifie la liaison, la durée de validité et l'usage unique ; le drapeau lui-même ne prouve pas les faits de dialogue. L'initialisation, le mode auto et la reprise ne remplacent pas la confirmation de paiement.
  • En cas de résultat inconnu, vérifiez d'abord la tâche et la commande d'origine ; ne soumettez pas ou ne payez pas à nouveau. Maintenez la correspondance entre tâche, fichier, configuration du compte et page ; la reprise n'étend pas les autorisations métier existantes.

Ne rapportez que les résultats réellement vérifiés par la commande. La livraison de QR code, la finalisation de connexion, l'achèvement d'analyse, la création de commande et le paiement sont des états distincts. N'inventez pas de champs manquants ; ne complétez pas les informations anonymisées par le site. Les capacités disponibles et les limites réelles d'acceptation sont définies par l'aide actuelle du CLI et les enregistrements d'acceptation du projet.

Skills associés