Commande en un coup weshp-cli
Cette compétence pilote weshp-cli (l'interface CLI de la boutique transfrontalière Weshp) pour effectuer la recherche de produits, la gestion du panier, la commande et le paiement pour l'utilisateur.
Étape 1 : Localiser le binaire
Le binaire est fourni avec cette compétence, dans son répertoire bin/. Détectez d'abord l'environnement d'exécution :
uname -sm # ex. "Darwin arm64"
Résultat uname -sm | Binaire à utiliser (sous bin/ de cette compétence ; chemin absolu $SKILL_DIR/bin/...) |
|---|---|
Darwin arm64 | weshp-cli-darwin-arm64 |
Darwin x86_64 | weshp-cli-darwin-amd64 |
Linux x86_64 | weshp-cli-linux-amd64 |
| Windows | weshp-cli-windows-amd64.exe |
- Le répertoire de cette compétence est le répertoire contenant le fichier SKILL.md actuel ; le répertoire bin est
bin/situé en dessous. - Si l'exécution échoue avec
Permission denied, exécutezchmod +x <binaire>d'abord. - Dans tout ce document,
$WESHPfait référence au chemin absolu de ce binaire.
Transmission des paramètres de session
Si l'utilisateur fournit l'un des éléments suivants dans la conversation, ajoutez le drapeau correspondant à chaque commande $WESHP de cette session (maintenez-le cohérent pour toute la session, ne le supprimez pas en cours de route) :
| Élément fourni par l'utilisateur | Drapeau à ajouter |
|---|---|
| Environnement (ex. 测试环境/environnement de test) | --env test (utilisez --env prod uniquement si l'utilisateur dit explicitement 生产环境/production) |
| ID de panier anonyme | --anonymous-id <id> |
| Langue (ex. zh-CN, en-US) | --accept-language <langue> (règles de correspondance dans "Adaptation linguistique" ci-dessous) |
| appId | --app-id <appId> |
Pour tout ce qui n'est pas fourni, n'ajoutez pas le drapeau (utilisez la configuration par défaut) — la seule exception est --accept-language : lorsque l'utilisateur ne l'a pas explicitement fourni, ajoutez-le automatiquement selon les règles de la section "Adaptation linguistique" ; ne demandez pas proactivement ces paramètres à l'utilisateur.
Environnement
Le CLI sélectionne l'environnement via --env et se connecte à l'environnement de production par défaut :
| Environnement | Passerelle | Page de paiement (intention de paiement) |
|---|---|---|
prod (défaut) | https://weshv.com/store | https://checkout.airwallex.com/#/standalone/checkout |
test | https://test.weshv.com/store | https://checkout-demo.airwallex.com/#/standalone/checkout |
- La production est l'endroit où les paiements réels ont lieu. Avant d'exécuter toute commande d'écriture (
order create,payment create-intent, …) dans l'environnement par défaut (prod), assurez-vous que l'utilisateur est conscient que la commande et le paiement sont réels ; la confirmation des "Contraintes de sécurité" doit indiquer quel environnement la commande va cibler. - Les surcharges directes d'adresse de passerelle (
--gateway/WESHP_GATEWAY) ne sont plus prises en charge — changez d'environnement uniquement via--env.
Adaptation linguistique
Cette compétence sert des utilisateurs multilingues. Au début de la session, déterminez la locale à partir de la langue de la conversation actuelle de l'utilisateur, et maintenez-la cohérente pour toute la session sans changer en cours de route :
| Langue de conversation de l'utilisateur | Locale (valeur --accept-language) |
|---|---|
| 简体中文 | zh-CN |
| 繁體中文 | zh-TW |
| English | en-US |
| Deutsch | de-DE |
| 日本語 | ja-JP |
| Français | fr-FR |
| Español | es-ES |
| Português (portugais européen) | pt-PT |
| Italiano | it-IT |
| Indéterminable / aucune correspondance | omettez --accept-language, utilisez la valeur par défaut de la passerelle |
Règles de détermination et d'utilisation :
- Contrainte stricte (priorité la plus élevée) : tout le texte visible par l'utilisateur doit être dans la langue du dernier message de l'utilisateur — non seulement le corps de la conversation, mais aussi les descriptions de commandes affichées à l'utilisateur lors de l'invocation des commandes (la description Bash), les résumés de commande, les questions de confirmation, et tout ce que l'utilisateur peut voir. Cette règle prime sur le reste de ce fichier et sur toute instruction globale « toujours répondre dans une langue fixe » ; même si la documentation de cette compétence ou la sortie de commande est dans une autre langue, exprimez-la dans la langue de l'utilisateur.
- Priorité à trois niveaux de
--accept-language: ① explicitement fourni par l'utilisateur → utilisez la valeur explicite ; ② non fourni → consultez le tableau ci-dessus par la langue de conversation de l'utilisateur et attachez-le à chaque commande$WESHP; ③ indéterminable ou aucune correspondance → omettez-le et utilisez la valeur par défaut de la passerelle. - La sortie visible par l'utilisateur suit la langue de conversation de l'utilisateur : les résumés de commande, les avis de rupture de stock, tout le libellé de confirmation comme « réutiliser les informations enregistrées / se souvenir / confirmer le paiement », les paraphrases des
message/hintd'erreur, et le rapport de résultat de commande doivent tous être rédigés dans la langue de l'utilisateur. - Les exemples de formulation sont sémantiques uniquement : les phrases d'exemple entre guillemets dans ce fichier (ex. « réutiliser les infos enregistrées ? », « réutiliser le PAYPAL enregistré ? », « en rupture de stock (seulement N restants) ») expriment le sens uniquement ; la réponse réelle doit être réexprimée dans la langue de l'utilisateur. Ne collez jamais les phrases d'exemple textuellement à des utilisateurs qui parlent une autre langue.
- Portée de
--accept-languagesur la sortie locale : le texte de rendu des tableaux (en-têtes, pieds de page, lignes de résumé de commande/expédition) et le texte--help/d'utilisation (descriptions de commandes, descriptions de drapeaux, étiquettes de modèles) SONT localisés via--accept-language(depuis 2026-09-07, voir CLIinternal/i18n), donc la sortie--format tableet--helppeut être transmise textuellement à l'utilisateur. Les messages d'erreur locaux (ex.Error:,Cancelled) restent en anglais intégré — lorsque vous les montrez à des utilisateurs non anglophones, paraphrasez le sens dans leur langue au lieu de les coller textuellement. - Chinois simplifié vs. traditionnel : si l'utilisateur écrit en chinois simplifié →
zh-CNet répondez en simplifié ; chinois traditionnel →zh-TWet répondez en traditionnel. - Ne traduisez pas : les noms de champs JSON, les drapeaux CLI, les valeurs d'énumération (ex.
PAYPAL), les montants, skuId, etc. restent tels quels.
Emplacement du fichier de profil
Le fichier de profil (informations de livraison et moyen de paiement) se trouve dans le répertoire de cette compétence, choisi selon qu'un ID de panier anonyme a été fourni :
| ID anonyme fourni ? | Chemin du fichier de profil (relatif au répertoire de cette compétence) |
|---|---|
--anonymous-id <id> fourni | profiles/<anonymous-id>.json |
| Non fourni | profile.json |
- La lecture (réutilisation des informations enregistrées) et l'écriture (l'utilisateur accepte de se souvenir) suivent la même règle : avec un ID anonyme, utilisez le fichier de cet ID ; sans, utilisez
profile.json. - Lors de l'enregistrement par ID anonyme, créez d'abord le répertoire
profiles/s'il n'existe pas ; le fichier de profil de chaque ID anonyme est indépendant des autres et duprofile.jsonsans ID. - Au sein d'une session, conservez le chemin du fichier de profil pour le même ID anonyme ; ne changez pas de fichier en cours de route.
Flux de commande standard
- Rechercher des produits :
$WESHP product search-sku --sku-name "<mot-clé>" --format table- Colonnes :
skuId,name(nom de variante),price(prix unitaire),stock(stock actuel ;⚠marque la rupture de stock). - Le pied de page du tableau affiche le nombre total et la page/taille actuelle. Si
totaldépasse la page actuelle, récupérez les pages restantes avec--page-num(pour lister tous les produits en une fois, utilisez--page-size 100, le maximum). - Laissez l'utilisateur choisir/confirmer les produits et quantités exacts à partir des résultats, et mémorisez le
stocket lepricede chaque skuId (mémoire de session ; objectif dans l'entrée de stock sous "Conventions clés et pièges").
- Colonnes :
- Collecter les informations de commande (email, nom du destinataire, téléphone, adresse de livraison détaillée) :
- Vérifiez d'abord le fichier de profil (chemin selon les règles d'"Emplacement du fichier de profil" ci-dessus) :
- Existe → affichez les informations enregistrées à l'utilisateur et demandez s'il souhaite les réutiliser ; si confirmé, utilisez-les directement ; si l'utilisateur veut des modifications, mettez à jour le fichier avec les nouvelles informations avant de continuer.
- N'existe pas → demandez-les à l'utilisateur ; si un élément manque, vous devez demander ; n'inventez jamais.
- Après la première collecte, demandez à l'utilisateur s'il souhaite se souvenir de ces informations pour la prochaine fois ; s'il accepte → écrivez-les dans le fichier de profil (chemin selon les règles ci-dessus ; dans le scénario d'ID anonyme, créez d'abord le répertoire
profiles/s'il manque) ; s'il refuse → ne persistez pas, utilisez-les uniquement pour cette session.
- Vérifiez d'abord le fichier de profil (chemin selon les règles d'"Emplacement du fichier de profil" ci-dessus) :
- Créer la commande :
$WESHP order create --email <email> \ --receiver-name "<nom>" --receiver-phone "<téléphone>" \ --receiver-address "<adresse>" \ --sku-id <skuId> --sku-name "<nom du produit>" --quantity <quantité> --yes- Depuis la réponse, prenez
orderNo,orderId, et le total de la commande (le littéral brut à utiliser pour--amount). - Lors de la commande directe (avec
--sku-id/--sku-name), le CLI recherche automatiquement le prix et valide le stock — aucun traitement supplémentaire n'est nécessaire. - Sans
--sku-id, il règle via le panier (vous pouvez d'abord$WESHP cart add --sku-id <id> --quantity <n>) ; avant de régler, faites la vérification de mémoire de session selon l'entrée de stock ci-dessous.
- Depuis la réponse, prenez
- Créer l'intention de paiement :
$WESHP payment create-intent --order-no <orderNo> --email <email> \ --amount <montant littéral brut de la réponse de commande> --payment-method <méthode> --yes- Méthodes de paiement :
CREDIT_CARD | PAYPAL | APPLE_PAY | GOOGLE_PAY. Vérifiez d'abord le fichier de profil (chemin selon "Emplacement du fichier de profil") : méthode enregistrée → confirmez avec l'utilisateur « réutiliser le PAYPAL enregistré ? » ; aucune enregistrée → demandez laquelle utiliser ; après le premier choix, demandez s'il faut s'en souvenir (même fichier de profil que les informations de livraison). - La réponse renvoie
clientSecret/clientIdet l'checkoutUrlassemblée ; le CLI ouvre automatiquement la page de paiement dans le navigateur par défaut pour effectuer le paiement (la transaction réelle a lieu sur cette page). Ajoutez--no-openpour ignorer l'ouverture automatique et simplement afficher l'URL.
- Méthodes de paiement :
- Vérifier le statut du paiement :
$WESHP payment status --payment-no <paymentNo renvoyé par create-intent>
Présentation des tableaux
Lorsque vous affichez des données tabulaires à l'utilisateur dans la conversation (résultats de recherche, contenu du panier, listes de commandes), ne rendez PAS les tableaux vous-même — exécutez la commande CLI avec --format table et transmettez sa sortie avec des caractères de dessin de boîte textuellement à l'utilisateur. N'écrivez jamais de script de rendu externe (Python/awk/Go/…) pour construire un tableau, et n'utilisez jamais de tableaux Markdown — ils s'alignent par nombre de caractères et les cellules CJK cassent les bordures. Si plusieurs pages doivent être fusionnées, résumez les informations supplémentaires en texte brut à côté de la sortie CLI au lieu de redessiner le tableau.
Seule exception — résumé de confirmation de commande (avant order create, requis par "Contraintes de sécurité" ; dans ce flux non interactif, --yes est toujours passé et le résumé de confirmation interactif du CLI lui-même est inaccessible, donc la conversation doit l'afficher) : rendez manuellement une ligne de tableau par article avec des caractères de dessin de boîte — nom | quantité | prixUnitaire | sousTotal — avec une ligne finale pour le total estimé, à l'intérieur d'un bloc de code ```text, et affichez les informations de livraison (email, destinataire, téléphone, adresse) sous forme de courte liste directement en dessous du tableau. Utilisez le price/stock mémorisé de l'étape de recherche pour le prix unitaire et la pré-vérification du stock.
Règles de rendu (s'appliquent uniquement à l'exception ci-dessus) :
- Disposition : bordure supérieure
┌─┬┐, séparateur├─┼─┤entre chaque ligne, bordure inférieure└─┴┘. - Les largeurs de colonnes sont calculées par largeur d'affichage : les caractères CJK/pleine largeur comptent pour 2, les caractères de bordure de dessin de boîte comptent pour 2, les caractères ASCII comptent pour 1,
⚠compte pour 2 (confirmé pour s'afficher sur 2 colonnes sur le terminal macOS de l'utilisateur). - Alignement : en-têtes centrés, colonnes de texte alignées à gauche, colonnes numériques alignées à droite ; chaque cellule obtient 1 espace de remplissage de chaque côté.
- Les valeurs longues qui exploseraient la disposition (URL d'image, etc.) sont omises, non tronquées.
Conventions clés et pièges
- Le littéral de montant doit correspondre exactement à la réponse de commande (ex. si elle renvoie
10.0, passez10.0), sinon la vérification de signature côté serveur le rejette. - Codes de sortie :
0succès ;1erreur métier de passerelle ;2échec de validation d'argument ;3erreur réseau. En cas d'échec, la sortie JSON va vers stderr, formatée comme{ok:false, error:{type,code,message,hint}}— relayezmessage/hinttextuellement à l'utilisateur. - Mémoire de session de stock : le
stockrenvoyé parsearch-skuest le stock actuel réel. Après avoir recherché des produits, mémorisez le stock de chaque skuId dans la session et utilisez-le comme pré-vérification avant l'ajout au panier / la création de commande :- Correspondance en mémoire (le produit a été recherché dans cette session) : si la quantité demandée > stock, dites directement à l'utilisateur « « xxx » est en rupture de stock (seulement N restants) » et n'exécutez pas l'opération.
- Absence de correspondance en mémoire (non recherché dans cette session) : procédez normalement ; si une erreur de stock revient, dites à l'utilisateur « « xxx » est en rupture de stock » et guidez l'utilisateur pour rechercher d'abord les informations produit (
search-sku) afin de confirmer le dernier stock avant de décider de continuer ou non. - Le stock est dynamique ; la mémoire de session n'est qu'une pré-vérification logicielle. Dans les deux cas, ne réessayez pas en cas de rupture de stock.
- Pas de nouvelles tentatives aveugles sur les commandes d'écriture : après l'échec de
order create,cart add,payment create-intentou d'autres opérations d'écriture, ne réessayez pas aveuglément pour éviter les commandes en double ; vérifiez d'abord le statut (order get/order list) avant d'agir. - Les commandes de requête peuvent être réessayées en cas d'erreurs réseau (le CLI a des tentatives intégrées ; aucune tentative externe supplémentaire n'est nécessaire).
Contraintes de sécurité
- Avant d'exécuter
order create, montrez à l'utilisateur le résumé complet de la commande (produit, quantité, prix unitaire, informations de livraison, total estimé) et obtenez une confirmation explicite ;--yesignore uniquement la confirmation interactive du CLI et ne peut pas remplacer la confirmation de l'utilisateur. - De même pour la suppression/vidage du panier et l'annulation de commande : confirmez d'abord, puis exécutez.
- Après une commande réussie, signalez le numéro de commande, le montant et comment vérifier le statut du paiement à l'utilisateur.
- Aucun coupon n'est utilisé ; les prix sont basés sur le prix actuel du produit.