Use o wecom-cli no terminal para verificar a autorização WeCom antes de começar o trabalho de escritório

Para quem

Use esta skill quando quiser operar o WeCom a partir do terminal — mensagens, correio, documentos, todos, calendário, reuniões, WeDrive ou contactos — e quiser que humanos e um AI Agent partilhem a mesma linha de comandos. Não é outra consola web; liga a capacidade da plataforma aberta ao terminal para subir a eficiência de escritório. Repositório oficial:

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

Os pré-requisitos são explícitos: esta máquina precisa de Node.js >= 18 e de uma conta WeCom; plataformas limitadas a macOS (x64/arm64), Linux (x64/arm64) e Windows (x64). Sem conta, versão baixa ou fora dessas plataformas, não instale ainda. Quem só quer clicar no WeCom no browser e não quer deixar um comando global aqui não deve começar por aqui.

A fonte divide a instalação do CLI e a da CLI Skill em dois passos e escreve que a Skill é obrigatória. Primeiro a linha de comandos, depois o Agent aprender a chamá-la. Não invente um instalador que nunca apareceu nem acrescente um diretório de skill não nomeado. A fonte não escreve «humanos e AI Agent» como exclusividade de uns produtos; não estreite você os clientes nomeados.

Conclua a primeira tentativa em 3 minutos

Confirme primeiro três coisas: o Node.js é 18 ou mais; tem conta WeCom; o sistema atual está entre as plataformas acima. Abra a página oficial e verifique:

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

O caminho principal: instale primeiro o CLI, depois a CLI Skill obrigatória. Instalar o pacote muda os comandos globais desta máquina; antes de executar, confirme que quer deixar @wecom/cli aqui:

npm install -g @wecom/cli

Depois execute a instalação de Skill que a fonte dá (marcada como obrigatória):

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

Não divida estes dois passos em dois caminhos principais paralelos nem mude os parâmetros. A fonte não escreve o diretório de aterragem da skill; não invente um caminho.

Na primeira vez num Agent, só verifique; não crie documentos, não envie correio nem altere o calendário. Se as credenciais ainda não estiverem configuradas, a configuração é um efeito secundário: leitura QR por omissão, ou --manual para escrever. Antes de executar, confirme que é a sua própria conta WeCom e que vai terminar esta interação:

wecom-cli auth init

Depois de configurar, inspecione a autorização com um comando só de leitura:

wecom-cli auth show

Sinal de sucesso: o comando termina normalmente e vê o estado de autorização atual. A fonte não dá nomes de campo do show; não invente um formato de saída. Na primeira vez, não faça notificações de bot, escrita de documentos, reserva de reuniões nem carregamentos WeDrive. Se o Agent só recitar «primeiro init, depois show» e não tiver corrido o show de verdade, não trate a autorização como já bem-sucedida.

Casos de uso

Caso 1: Só verificar autorização. Depois do CLI e da Skill obrigatória, execute wecom-cli auth show no terminal ou num Agent que possa chamar os mesmos comandos. Isto inspeciona o estado de autorização, para confirmar que as credenciais ainda estão. Antes de executar, confirme que não vai alterar a configuração de passagem; o sinal de sucesso é ver o estado de autorização. A fonte não escreve um código de saída para não autorizado; se falhar, pare, não invente um comando de reparação. Não alargue esta verificação a enviar correio ou ler contactos; essas ações não têm redação de comando correspondente.

Caso 2: Configurar credenciais na primeira vez. A fonte escreve que configurar credenciais é interativo e só é preciso uma vez, leitura QR por omissão, --manual para escrever. O comando é wecom-cli auth init. Antes de executar, confirme que quer deixar credenciais WeCom nesta máquina e que está pronto a ler o código ou escrever. Depois de configurar, corra wecom-cli auth show para verificar. A fonte não escreve revogação nem terminar sessão; não invente um passo para desinstalar credenciais. As capacidades de negócio — mensagens, documentos, todos, calendário, reuniões, WeDrive, correio, contactos — só estão escritas como nomes de capacidade, por exemplo criar e ler documentos, pesquisa de documentos, criar e gerir calendário, reservar e obter info de reuniões, criar e acompanhar todos, carregar e obter ficheiros WeDrive, enviar e obter correio, obter membros de contactos, e notificações iniciadas por bot; quando precisar dessas operações, volte primeiro ao repositório oficial, não invente comandos.

Limites de uso

Plataforma, runtime e exigência de conta seguem a fonte: macOS (x64/arm64), Linux (x64/arm64) e Windows (x64), Node.js >= 18, e uma conta WeCom. Humanos e um AI Agent podem ambos operar no terminal, mas a fonte não nomeia um produto Agent concreto; não escreva uns clientes como exclusivos.

A ordem de instalação é npm install -g @wecom/cli, depois o npx skills add WeComTeam/wecom-cli -y -g obrigatório. Não invente um segundo marketplace nem uma variante skills add não escrita. Não leia «Skill obrigatória» como permissão para saltar o CLI; ambos os passos têm de terminar na ordem da fonte.

A configuração de credenciais escreve nesta máquina, leitura QR por omissão, --manual disponível. A fonte não escreve o caminho do ficheiro, a política de caducidade nem como revogar. A cobertura de negócio inclui mensagens, correio, documentos, todos, calendário, reuniões, WeDrive, contactos, incluindo notificações de bot, pesquisa de documentos, reserva de reuniões, carregamento WeDrive, mas a evidência pára na descrição de capacidade e não dá a redação desses subcomandos; não complete parâmetros, âmbitos de permissão nem faturação não escritos. Na primeira vez, só verifique a autorização; não trate ações de escritório sem comando como passos já copiáveis. Não invente caminhos de desinstalação ou atualização que a evidência nunca escreveu.