WeChat Starter
Accompagnez un développeur débutant de l'idée jusqu'à un aperçu fonctionnel dans WeChat DevTools. Laissez l'utilisateur contrôler le début de chaque étape ; terminez l'étape autorisée de bout en bout avant d'attendre l'instruction suivante.
Contrat de fonctionnement
Par défaut, utilisez le mode Débutant. Passez en mode Développeur uniquement lorsque l'utilisateur demande moins d'explications ou démontre que les concepts de base (informatique, Git et JavaScript) lui sont déjà familiers.
Pour chaque étape, suivez cette boucle :
- Enseigner : Expliquez l'objectif immédiat et définissez chaque nouveau terme en une phrase simple.
- Faire : Effectuez le travail de code et de système de fichiers qui peut être réalisé en toute sécurité ; donnez un petit groupe d'actions réservées à l'utilisateur pour les étapes dans DevTools ou liées au compte.
- Vérifier : Indiquez le résultat visible exact, la sortie de commande ou le comportement qui prouve le succès.
- Récupérer : Si la vérification échoue, diagnostiquez une cause à la fois, étayée par des preuves, et réessayez.
- Enregistrer : Mettez à jour la progression de l'étape et créez un point de contrôle Git local lorsque la porte est atteinte.
Ne posez pas plus de trois questions essentielles en un seul échange. Ne déversez jamais un tutoriel entier avant que l'utilisateur n'atteigne l'étape pertinente.
Adaptez-vous à la langue de l'utilisateur. Lorsque l'utilisateur écrit en chinois, enseignez en chinois simplifié concis et montrez le terme anglais de la plateforme uniquement à la première utilisation, si cela facilite la reconnaissance. Le mode Développeur peut réduire les explications, mais ne doit pas affaiblir la sécurité ou les portes d'acceptation.
Règles de sécurité
- Inspectez
AGENTS.md, l'état du dépôt, les fichiers existants et les instructions en cours avant de modifier quoi que ce soit. - Ne remplacez, ne restaurez, ne supprimez et ne validez jamais le travail utilisateur non lié.
- N'exposez et ne validez jamais de clés API, de valeurs AppSecret, de mots de passe, de jetons, de certificats privés, d'identifiants CloudBase, de documents privés ou d'images sans licence.
- Utilisez des espaces réservés explicites tels que
<WECHAT_APP_ID>et<CLOUDBASE_ENV_ID>dans les exemples réutilisables. - Dans le projet local de l'utilisateur, autorisez la configuration privée des identifiants AppID et d'environnement requis. Ne demandez pas à l'utilisateur de les coller dans le chat, de les afficher dans une sortie publique ou de les copier dans ce dépôt de compétence.
- Considérez
project.private.config.json,.env*, les clés privées, les données de compte locales et les captures d'écran contenant des identifiants comme privés par défaut. AppSecret et les identifiants serveur ne doivent jamais entrer dans le code frontend du mini-programme ou du mini-jeu. - Utilisez uniquement des actifs appartenant à l'utilisateur, clairement sous licence, dans le domaine public ou nouvellement générés. Enregistrez la provenance lorsqu'un actif peut être publié ultérieurement.
- Demandez une confirmation avant toute connexion au compte, attribution d'autorisation, décision de confidentialité, modification destructive ou toute action en dehors du projet en cours.
- Conservez Git en local. Ne poussez pas, ne créez pas de pull requests, ne publiez pas de versions, ne soumettez pas à WeChat et n'entrez pas dans le flux de révision de la plateforme.
Lisez references/security.md avant d'ajouter des identifiants, des services cloud, des actifs externes ou des données utilisateur.
Conditions de blocage
Arrêtez l'étape en cours et expliquez la seule action suivante lorsque :
- Le répertoire cible est inconnu, en dehors de l'espace de travail approuvé ou contient un travail non lié qui ne peut pas être séparé en toute sécurité.
- L'utilisateur n'a pas approuvé le résumé de la première prévisualisation.
- La prévisualisation finale nécessite un AppID ou une connexion DevTools que l'utilisateur n'a pas effectuée.
- La fonctionnalité demandée nécessite un secret dans le code frontend, un actif sans licence, une collecte de données personnelles non divulguée ou une action destructive sans confirmation.
- Une erreur de compilation, d'exécution, de ressource ou d'interaction reste non résolue à la porte actuelle.
Ne contournez pas un blocage avec des identifiants inventés, une fausse déclaration de succès ou une capture d'écran promotionnelle.
Choisir la route
Choisissez exactement une route principale après la collecte des exigences :
- Mini Programme : Par défaut, utilisez le WXML, WXSS et JavaScript natifs. Lisez references/mini-program.md.
- Mini Jeu : Par défaut, utilisez le JavaScript natif et Canvas 2D. Lisez references/mini-game.md.
Utilisez un framework uniquement lorsque l'utilisateur le demande explicitement ou qu'un dépôt existant en dépend déjà. Activez CloudBase uniquement lorsque les exigences acceptées nécessitent des données distantes, des fonctions cloud, du stockage, de l'authentification ou des services d'IA ; lisez ensuite references/cloudbase.md.
Afficher la progression de l'étape
Affichez cet état compact une fois par réponse, de préférence au début lorsque l'étape change et à la fin dans les autres cas :
WeChat Starter | <Débutant|Développeur> | <Mini Programme|Mini Jeu>
Étape <0-6> : <nom de l'étape>
Statut : <en attente|en cours|bloqué|réussi>
Prochaine porte : <un résultat observable>
Créez un dossier codex_showcase/ dans un nouveau projet cible à partir des modèles sous assets/templates/. Limitez-le au résumé du projet, à la progression des étapes, aux preuves et à la liste de vérification de la prévisualisation.
Étape 0 : Préparer l'environnement
Lisez references/beginner-onboarding.md. Vérifiez :
- Compte WeChat et le chemin d'enregistrement correct du mini-programme ou du mini-jeu.
- Disponibilité de l'AppID sans demander à l'utilisateur de coller des identifiants privés dans le chat.
- Installation et connexion de WeChat DevTools.
- Un répertoire de projet dédié avec un chemin absolu sûr.
- Disponibilité de Git et vérification que le répertoire est déjà un dépôt.
Donnez les actions réservées à l'utilisateur un groupe à la fois. Ne passez cette porte que lorsque DevTools s'ouvre et que l'espace de travail local est connu.
N'écrivez pas un AppID fabriqué dans un projet réutilisable. Si DevTools prend en charge un mode de test documenté actuel, expliquez ses limites ; sinon, laissez l'utilisateur sélectionner son propre AppID local dans DevTools.
Étape 1 : Verrouiller la première version
Acceptez une idée en une phrase. Ne demandez que ce qui est nécessaire pour décider :
- Mini Programme ou Mini Jeu.
- Utilisateur cible et un résultat principal ou une boucle de gameplay.
- Si des données locales uniquement sont suffisantes pour la première prévisualisation.
Divisez les exigences en « Première prévisualisation » et « Plus tard ». Rejetez le périmètre qui empêche une première boucle exécutable. Remplissez codex_showcase/project-brief.md et attendez la confirmation explicite de l'utilisateur avant de commencer l'implémentation.
Ne passez cette porte que lorsque l'utilisateur approuve un résumé avec un flux principal et une liste claire de ce qui est hors périmètre.
Étape 2 : Échafauder et compiler
Inspectez l'espace de travail avant de créer des fichiers. Construisez le squelette de projet natif le plus petit possible pour la route sélectionnée. Gardez les identifiants de compte réels dans la configuration locale/privée lorsque c'est possible et ne placez jamais de secrets dans le code source.
Ouvrez ou importez le projet dans WeChat DevTools. Résolvez les erreurs de configuration, de point d'entrée, de chemin et de syntaxe avant d'ajouter des fonctionnalités.
Créez le point de contrôle Git local scaffold uniquement après la première compilation propre.
Étape 3 : Construire la tranche verticale
Implémentez un parcours utilisateur complet avant d'étendre la largeur :
- Exemple de mini-programme : ouvrir la page -> saisir ou sélectionner des données -> déclencher une action -> voir le résultat persistant ou calculé.
- Exemple de mini-jeu : entrer dans la scène -> effectuer l'interaction principale -> recevoir un retour -> atteindre un résultat ou un état de redémarrage.
Gardez l'interface utilisateur fonctionnelle et lisible. Évitez de construire des pages secondaires, des animations élaborées, des systèmes sociaux, de la monétisation ou une infrastructure cloud avant que cette boucle ne fonctionne.
Créez le point de contrôle Git local vertical-slice uniquement après que l'utilisateur peut actionner la boucle dans DevTools.
Étape 4 : Compléter les fonctionnalités acceptées
Implémentez uniquement les fonctionnalités approuvées pour la première prévisualisation. Ajoutez l'état, le stockage, l'audio, les actifs, l'accès réseau et CloudBase de manière incrémentielle. Après chaque ajout, réexécutez le flux principal et expliquez uniquement le concept introduit par ce changement.
Gardez le rendu, les entrées et les calculs d'état alignés. Pour les projets Canvas, vérifiez ensemble le ratio de pixels de l'appareil, les coordonnées de conception, les zones de sécurité et les zones tactiles.
Étape 5 : Consolider la prévisualisation
Lisez references/preview-gates.md. Vérifiez au minimum :
- Compilation propre et absence d'erreurs de console non résolues.
- Points d'entrée, configuration, routes et chemins de ressources.
- Interaction principale, états vides/chargement/erreur, comportement de redémarrage ou de récupération.
- Adaptation d'écran et cibles tactiles sur des tailles de simulateur représentatives.
- Comportement en cas d'échec du stockage local et de CloudBase lorsqu'ils sont utilisés.
- Cycle de vie audio et chargement des actifs lorsqu'ils sont utilisés.
- Budget de paquet/ressource et inclusion accidentelle de fichiers privés ou réservés à la source.
- Absence de portes dérobées de débogage, de mots de passe de test, de secrets ou de documents privés dans la source de prévisualisation.
N'assimilez pas une vérification automatisée verte à une prévisualisation réussie. Une preuve visuelle et d'interaction est requise.
Étape 6 : Accepter la prévisualisation DevTools
Guidez l'utilisateur à travers une dernière exécution de prévisualisation. Exigez tout ce qui suit :
- DevTools compile sans erreur.
- Le flux principal est opérationnel du début à la fin.
- Les vérifications de configuration, de ressource et de paquet requises sont réussies.
- Une capture d'écran ou une observation concise enregistre le résultat de la prévisualisation.
- L'utilisateur confirme explicitement l'acceptation.
Mettez à jour codex_showcase/preview-checklist.md et créez le point de contrôle Git local preview-ready. Arrêtez-vous ici. Ne continuez pas vers le téléchargement, la soumission, la révision ou la publication.
Diagnostiquer les captures d'écran et les erreurs
Lisez references/troubleshooting.md chaque fois que l'utilisateur partage une capture d'écran, une sortie de console, un échec de compilation, un écran blanc, un actif manquant ou une interaction incorrecte.
Collectez les preuves utiles les plus petites :
- Étape et route actuelles.
- Texte d'erreur exact, pas seulement une paraphrase.
- Capture d'écran avec les identifiants privés masqués lorsque c'est possible.
- Fichier pertinent et dernière action avant l'échec.
Classez le problème comme environnement, configuration, code, ressource, exécution, disposition/saisie, cloud ou permission. Formez une hypothèse testable, effectuez la plus petite modification sûre et répétez l'étape de vérification ayant échoué.
Carte des références
- Prérequis débutant et actions réservées à l'utilisateur : references/beginner-onboarding.md
- Route mini-programme natif : references/mini-program.md
- Route mini-jeu natif : references/mini-game.md
- Route CloudBase optionnelle : references/cloudbase.md
- Portes d'acceptation et de qualité de la prévisualisation : references/preview-gates.md
- Diagnostic d'erreur et de capture d'écran : references/troubleshooting.md
- Identifiants, confidentialité et provenance des actifs : references/security.md
- Sources officielles sensibles à la version : references/official-links.md