Skills

Vérifier l’autorisation WeCom dans le terminal avec wecom-cli avant de commencer le travail de bureau

Pour qui veut opérer documents, todos ou calendrier WeCom depuis le terminal — Node.js >= 18 et un compte WeCom, installer d’abord le CLI puis le Skill obligatoire.

Official source · wecom-cli

Install

npx skills add WeComTeam/wecom-cli -y -g

À qui ça s’adresse

Utilisez cette skill quand vous voulez opérer WeCom depuis le terminal — messages, mail, documents, todos, calendrier, réunions, WeDrive ou contacts — et que humains et AI Agent partagent la même ligne de commande. Ce n’est pas une autre console web ; elle branche la capacité open platform sur le terminal pour lever l’efficacité de bureau. Dépôt officiel :

https://github.com/wecomteam/wecom-cli

Les prérequis sont explicites : cette machine a besoin de Node.js >= 18 et d’un compte WeCom ; plateformes limitées à macOS (x64/arm64), Linux (x64/arm64) et Windows (x64). Sans compte, version trop basse, ou hors de ces plateformes, ne pas installer encore. Qui veut seulement cliquer WeCom dans un navigateur et ne pas laisser de commande globale ici ne doit pas commencer par là.

La source sépare installation CLI et installation CLI Skill en deux étapes et écrit que le Skill est obligatoire. Avoir la ligne de commande d’abord, puis apprendre à l’Agent à l’appeler. N’inventez pas un installeur jamais apparu, ni un répertoire de skill non nommé. La source n’écrit pas « humains et AI Agent » comme exclusivité de quelques produits ; ne rétrécissez pas vous-même les clients nommés.

Premier essai en 3 minutes

Confirmer d’abord trois choses : Node.js est 18 ou plus ; vous avez un compte WeCom ; le système actuel est parmi les plateformes ci-dessus. Ouvrir la page officielle et vérifier :

https://github.com/wecomteam/wecom-cli

Le chemin principal : installer d’abord le CLI, puis le CLI Skill obligatoire. Installer le paquet change les commandes globales de cette machine ; avant d’exécuter, confirmer que vous voulez laisser @wecom/cli ici :

npm install -g @wecom/cli

Ensuite exécuter l’installation Skill que donne la source (marquée obligatoire) :

npx skills add WeComTeam/wecom-cli -y -g

Ne pas séparer ces deux étapes en deux chemins principaux parallèles, ni changer les paramètres. La source n’écrit pas le répertoire d’atterrissage du skill ; n’inventez pas un chemin.

La première fois dans un Agent, seulement contrôler ; ne pas créer de documents, envoyer de mail ni changer le calendrier. Si les identifiants ne sont pas encore configurés, la configuration est un effet de bord : scan QR par défaut, ou --manual pour taper. Avant d’exécuter, confirmer que c’est votre propre compte WeCom et que vous êtes prêt à finir cette interaction :

wecom-cli auth init

Après configuration, inspecter l’autorisation avec une commande en lecture seule :

wecom-cli auth show

Signal de succès : la commande se termine normalement et vous voyez l’état d’autorisation actuel. La source ne donne pas les noms de champs de show ; n’inventez pas un format de sortie. La première fois, pas de notifications bot, d’écriture de documents, de réservation de réunion ni d’upload WeDrive. Si l’Agent ne fait que réciter « d’abord init, puis show » sans avoir vraiment passé show, ne pas traiter l’autorisation comme déjà réussie.

Cas d’usage

Cas 1 : Seulement contrôler l’autorisation. Après CLI et Skill obligatoire, exécuter wecom-cli auth show dans le terminal ou dans un Agent qui peut appeler les mêmes commandes. Cela inspecte l’état d’autorisation, pour confirmer que les identifiants sont encore là. Avant d’exécuter, confirmer que vous ne changerez pas la configuration au passage ; le signal de succès est de voir l’état d’autorisation. La source n’écrit pas de code de sortie pour non autorisé ; en échec, s’arrêter, n’inventez pas de commande de réparation. Ne pas étendre ce contrôle à l’envoi de mail ou à la lecture des contacts ; ces actions n’ont pas de formulation de commande correspondante.

Cas 2 : Configurer les identifiants la première fois. La source écrit que la configuration est interactive et n’est nécessaire qu’une fois, scan QR par défaut, --manual pour taper. La commande est wecom-cli auth init. Avant d’exécuter, confirmer que vous voulez laisser des identifiants WeCom sur cette machine et que vous êtes prêt à scanner ou taper. Après configuration, lancer wecom-cli auth show pour vérifier. La source n’écrit ni révocation ni déconnexion ; n’inventez pas une étape de désinstallation des identifiants. Les capacités métier — messages, documents, todos, calendrier, réunions, WeDrive, mail, contacts — ne sont écrites que comme noms de capacité, par exemple créer et lire des documents, recherche de documents, créer et gérer le calendrier, réserver et récupérer des infos de réunion, créer et suivre des todos, téléverser et récupérer des fichiers WeDrive, envoyer et récupérer du mail, récupérer des membres du carnet, et notifications initiées par bot ; quand vous avez besoin de ces opérations, d’abord revenir au dépôt officiel, n’inventez pas de commandes.

Limites d’usage

Plateforme, runtime et exigence de compte suivent la source : macOS (x64/arm64), Linux (x64/arm64) et Windows (x64), Node.js >= 18, et un compte WeCom. Humains et AI Agent peuvent tous deux opérer dans le terminal, mais la source ne nomme aucun produit Agent précis ; n’écrivez pas quelques clients comme exclusifs.

L’ordre d’installation est npm install -g @wecom/cli, puis le npx skills add WeComTeam/wecom-cli -y -g obligatoire. N’inventez pas un second marketplace ni une variante skills add non écrite. Ne lisez pas « Skill obligatoire » comme une permission de sauter le CLI ; les deux étapes doivent finir dans l’ordre de la source.

La configuration d’identifiants écrit sur cette machine, scan QR par défaut, --manual disponible. La source n’écrit ni chemin de fichier, ni politique d’expiration, ni révocation. La couverture métier inclut messages, mail, documents, todos, calendrier, réunions, WeDrive, contacts, y compris notifications bot, recherche de documents, réservation de réunions, upload WeDrive, mais les preuves s’arrêtent à la description de capacité et ne donnent pas la formulation de ces sous-commandes ; ne complétez pas paramètres, portées de droits ou facturation non écrits. La première fois, seulement vérifier l’autorisation ; ne traitez pas les actions de bureau sans commande comme des étapes déjà copiables. N’inventez pas de chemins de désinstallation ou de mise à jour que les preuves n’ont jamais écrits.