O que WeChat Pessoal via Wisdom faz?
Use o serviço Wisdom auto-hospedado do usuário para operar sua conta pessoal do WeChat. O Wisdom é executado em um host Windows com o WeChat Desktop logado e expõe uma API HTTP.
As credenciais são injetadas pelo conector BYOC personalwechat:
PERSONALWECHAT_BASE_URL— URL base do servidor Wisdom, ex.:http://82.156.126.14:8000.PERSONALWECHAT_API_TOKEN—API_TOKENdo Wisdom. Segredo — nunca ecoe, imprima ou registre em log.
O helper envia o token como Authorization: Bearer ...; ele nunca coloca o
token na URL. Para operações de UI em fila, como pesquisa e envio, o helper
submete a tarefa e aguarda /api/tasks/{id} antes de imprimir o resultado final.
Esta é a conta pessoal real do WeChat do usuário. Operações de leitura podem ser executadas diretamente. O envio de mensagens ou arquivos deve primeiro ser simulado (dry-run) e só realizado após o usuário aprovar explicitamente o destinatário e o conteúdo exatos.
CLI
A skill inclui um helper que depende apenas da stdlib:
WX=$SKILL_DIR/scripts/personal_wechat.py
Verifique a Conexão Primeiro
Sempre comece com o status quando o usuário pedir para usar o WeChat:
python3 $WX status
Forma esperada de resposta saudável:
{"auth":{"logged_in":true,"wechat_running":true,"page":"logged_in"}}
Se logged_in=false, informe ao usuário para abrir a UI web/RDP do Wisdom e escanear o
código QR do WeChat. Se a API retornar 401, peça ao usuário para reconectar o conector
Personal WeChat com o token atual da API Wisdom.
Fluxos de Leitura
Conta Atual
python3 $WX account
Contatos
python3 $WX contacts --limit 50
Conversas Recentes
Use o endpoint normal de conversas primeiro; ele prefere o banco de dados do WeChat quando disponível e, caso contrário, usa o banco de dados do Wisdom.
python3 $WX conversations --limit 20
Para sessões de histórico do WeChat local descriptografado:
python3 $WX conversations --history --limit 20
Mensagens em uma Conversa
Primeiro liste as conversas, depois use o id como conversation_id:
python3 $WX messages "34642176898@chatroom" --limit 50 --order asc
Mensagens Históricas
Leia dos bancos de dados locais do WeChat descriptografados pelo Wisdom:
python3 $WX history --limit 50
python3 $WX history --talker "34642176898@chatroom" --limit 50
python3 $WX history --limit 20 --offset 20
SQL Bruto, Somente Leitura
O Wisdom permite apenas SELECT e PRAGMA:
python3 $WX sql MicroMsg.db 'SELECT count(*) AS cnt FROM Session'
Use SQL bruto apenas para diagnósticos ou consultas de metadados direcionadas. Não despeje tabelas grandes de mensagens a menos que o usuário peça explicitamente.
Atualizar Banco de Dados do Histórico
Se o histórico parecer desatualizado, atualize o snapshot do banco de dados descriptografado:
python3 $WX refresh-history
Pesquisa
python3 $WX search "Alice"
A pesquisa dirige a UI do WeChat, portanto pode ser mais lenta que as leituras do banco de dados local.
Envio de Mensagens — BLOQUEADO
send executa um dry-run por padrão. Ele nunca envia a menos que --confirm
esteja presente, ou a menos que uma tarefa agendada do AceDataCloud tenha
pré-autorizado esta Skill e você use --unattended-confirm.
python3 $WX send "Alice" "Vamos nos encontrar às 20h?"
# -> {"dry_run": true, ...}
Mostre a saída do dry-run ao usuário e peça aprovação explícita do destinatário e do texto exatos. Só então execute:
python3 $WX send "Alice" "Vamos nos encontrar às 20h?" --confirm
Nunca adicione --confirm na primeira tentativa. Nunca deduza consentimento de
texto vago. O usuário deve aprovar claramente o envio desta mensagem exata.
Confirmação não assistida em tarefa agendada
Ao executar dentro de uma tarefa agendada do AceDataCloud, a plataforma pode pré-autorizar Skills específicas para execução não assistida. Se todas as condições abaixo forem verdadeiras:
AICHAT_UNATTENDED_MODE=trueAICHAT_ACTIVE_SKILLépersonal-wechatouacedatacloud/personal-wechatAICHAT_ACTIVE_SKILLaparece emAICHAT_UNATTENDED_ALLOWED_SKILLS
então o usuário pré-autorizou esta Skill para aquela tarefa agendada. Nesse caso, use:
python3 $WX send "Alice" "Vamos nos encontrar às 20h?" --unattended-confirm
Se o helper retornar unattended_confirmation_denied, não tente novamente com
--confirm; reporte o dry-run e explique que a tarefa precisa que esta Skill
seja selecionada em suas configurações de autorização não assistida.
Regras de Segurança
- Nunca imprima
PERSONALWECHAT_API_TOKEN. - Trate
PERSONALWECHAT_BASE_URL + API_TOKENcomo controle remoto total do WeChat do usuário. - Para operações normais de escrita/envio de chat: dry-run primeiro, peça aprovação explícita, depois execute novamente com
--confirm. - Para escritas não assistidas em tarefas agendadas: use
--unattended-confirmapenas quando as variáveis de ambiente da plataforma indicarem que esta Skill está pré-autorizada. - Não chame endpoints de logout/reinicialização da skill a menos que o usuário peça explicitamente para reparar o serviço Wisdom.
- Se o Wisdom retornar 503 para histórico, execute
python3 $WX refresh-historyuma vez e repita a leitura. - Se o servidor estiver inacessível, peça ao usuário para verificar o host Windows / grupo de segurança / porta 8000.
Mapeamento de Endpoints
O helper encapsula estes endpoints do Wisdom:
GET /api/statusGET /api/auth/statusGET /api/accountGET /api/contacts?version=2.0GET /api/conversationsGET /api/conversations/historyGET /api/messagesGET /api/messages/historyPOST /api/messages/history/queryPOST /api/messages/history/refreshPOST /api/searchPOST /api/messages/send(apenas com--confirmou--unattended-confirmverificado)