Communitygithub.com

wecom-agent — Agent de WeCom tout-en-un

Kit d'agent pour exploiter l'API WeCom (messages, contacts, calendrier, docs) et décrypter localement les chats sur macOS/Windows.

Qu'est-ce que wecom-agent — Agent de WeCom tout-en-un ?

Cet agent est conçu pour interagir avec la plateforme WeCom (WeChat Work) à travers trois voies principales : l'API officielle pour les actions actives (envoi de messages, gestion des contacts, documents, calendrier et réunions), la lecture locale des logs de chat décryptés sur macOS et Windows, et un serveur en temps réel pour recevoir et répondre automatiquement aux messages via un LLM. Il supporte Claude Code, Cursor et d'autres IDE via une interface en ligne de commande ou MCP. La partie décryptage repose sur l'extraction de clés depuis la mémoire vive des processus WeCom, sans nécessiter de jailbreak ni de root. L'agent peut également transcrire les messages vocaux avec Whisper et analyser les pièces jointes (textes, PDF, images). Il est utile pour automatiser les workflows d'entreprise, la recherche locale dans les conversations, ou la création de bots de réponse automatique.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add tzwkb/wecom-agent

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

wecom-agent — Agent WeCom tout-en-un

LigneCapacitéPoint d'entréeDépendances
A Actions activesEnvoyer des messages / Gérer les contacts / Lire-écrire des documents / Calendrier / Réunionswecom.pyCorpID+Secret+AgentId + IP de confiance
B Lecture localeDéchiffrer et exporter les logs de chat (conversation, expéditeur, horodatage, contenu)decrypt/WeCom connecté + resignature adhoc (désactiver hardened runtime)
C Réception temps réel + traitement autonomeRecevoir un message → analyser → répondre automatiquement / écrire un documentrecv_server.py + agent_worker.pyIdentifiants de A + Token de réception / AESKey + URL publique

Configuration dans README.md et docs/自建应用配置教程.md. Les identifiants sont dans config.json (gitignoré).

A Actions actives (API officielle)

python3 wecom.py <catégorie> <méthode> '<paramètres_json>'   # Sortie JSON, errcode:0 = succès
catégorieméthodeparamètresFonction
contactdepartmentsaucunListe des services (nom + ID)
contactusers{"department_id":1}Membres du service (userid + nom)
contactget/search/list_id{"userid"/"keyword":..}Détails membre / rechercher par nom / liste des ID
messagetext/markdown/news{"touser":"x","content":".."}Envoyer un message (touser par défaut @all, plusieurs séparés par |)
doccreate/get/edit/del/rename/sheet_get/sheet_editcorps transmisLecture/écriture et édition de documents (edit = batch_update)
schedule/meetingadd/create/list..corps transmisCalendrier / Réunions
callÉchappatoire{"path":"/cgi-bin/..","body":{}}N'importe quelle API officielle

Les opérations en écriture (envoyer message / supprimer réunion / modifier document) demandent une confirmation utilisateur avant exécution.

B Lecture locale des logs de chat

Routage par OS : macOS → decrypt/macos/, Windows → decrypt/windows/ ; le noyau de déchiffrement wxwork_crypto.py + analyse export_wxwork.py est partagé (même AES wxSQLite3, validé sur les deux plateformes).

macOS (validé)

Prérequis : WeCom ouvert et connecté + resignature adhoc (voir docs/解密思路.md, wechat_codesign_pitfall).

python3 decrypt/macos/read_wecom.py        # ★ Tout-en-un : vérifie la clé → déchiffre → exporte
python3 decrypt/macos/find_key_fast.py     # Capture la clé séparément (lecture mémoire du processus, lecture seule, pas d'injection) ; stocke dans wxwork_keys.json
python3 decrypt/macos/decrypt_wxwork.py    # Déchiffrement complet → decrypt/macos/decrypted/
python3 decrypt/macos/monitor.py --once    # Incrémental (--poll N pour surveillance continue)

Analyse couverte : nom réel de l'expéditeur (Session.db USER), nom de la conversation, types de messages — texte / image / [Voix] / [Fichier] nom / [Document] titre + lien / [Carte] titre + lien / système / réunion.

Transcription vocale optionnelle : voice_transcribe.py (cache local SILK→whisper, nécessite pilk+mlx-whisper, ne couvre que les voix déjà lues).

Une fois la clé sauvegardée, les étapes ②③ et monitor n'ont plus besoin de scanner la mémoire. Solution de secours hors ligne find_key_offline.py. Voir docs/解密思路.md. Les fichiers produits sont privés et gitignorés.

Recherche / analyse des données locales (après déchiffrement, entièrement local, sans réseau) : python3 decrypt/macos/wecom_local.py <sous-commande>

Sous-commandeFonction
contacts [mot]Carnet d'adresses (138 personnes : nom / service / poste / téléphone / email), filtrable par mot
conversationsListe des conversations (nom / nombre de messages / dernière date)
membres <conversation>Membres du groupe (classés par nombre de messages)
search <mot>Recherche plein texte dans les messages
statsStatistiques / profil (classement expéditeurs / conversations / type / par heure / par jour)
todo / calendarTâches / calendrier locaux
media [--out]Exporter les images et fichiers en cache (161 images + 119 fichiers)
openfile <nom/mot>Trouver un document dans les chats → localiser le fichier local → analyser le contenu textuel (txt/csv/md/xlsx/docx/PDF texte, nécessite openpyxl/pdfplumber/python-docx) ; images / PDF scannés → sortie 🖼️VISUAL <chemin> → vous utilisez ensuite Read multimodal directement. Les images inline (type29) ne peuvent pas être localisées par message ; utilisez media puis navigation multimodale

Transcription vocale : python3 decrypt/macos/voice_transcribe.py (cache SILK→whisper large-v3, validé sur 6 messages).

MCP (façade optionnelle, alignée avec wechat)

Le cœur logique est la CLI wecom_local.py (--json pour données structurées) ; les outils MCP de server.py ne font que rediriger vers celui-ci, sans logique propre. Pas besoin de MCP — utilisez directement wecom_local.py <sous-commande>.

Enregistrement : bash setup.sh (installe mcp + claude mcp add wecom) → redémarrez Claude Code. Outils : wecom_contacts/conversations/members/search/stats/todo/calendar/media/openfile (paramètres identiques aux sous-commandes). Prérequis : exécuter read_wecom.py pour déchiffrer, s'assurer que decrypt/macos/decrypted/ est présent.

Windows (validé · UTM Win11 ARM · bout en bout 12/12)

Prérequis : WeCom (WXWork) ouvert et connecté + Python installé + pip install pycryptodome (backend de déchiffrement ; cryptography n'a pas de wheel win-arm64). Pour la lecture de documents openfile, installez aussi pip install openpyxl xlrd pypdf python-docx. Pas besoin de resignature.

# ★ Tout-en-un : scanne la clé → déchiffre → exécute la sous-commande
powershell -ExecutionPolicy Bypass -File decrypt/windows/run.ps1 <sous-commande>
#   Sous-commandes (alignées sur macOS wecom_local) :
#   read | contacts [mot] | conversations | members <conversation> | search <mot> | stats
#   todo | calendar | media [--out] | openfile <nom> | voice | monitor
powershell -ExecutionPolicy Bypass -File decrypt/windows/run_test.ps1   # Test bout en bout 12 items → rapport
# Étapes séparées :
powershell -ExecutionPolicy Bypass -File decrypt/windows/find_key.ps1   # PowerShell + C# embarqué scanne la mémoire de WXWork.exe (ReadProcessMemory) → KEY=<hex>
python decrypt/windows/wecom_win.py <key> <sous-commande>               # Réutilise wxwork_crypto/export_wxwork/read_doc commun

Résolution des noms : user.db (uid→nom/téléphone/email) + session.db (conversation→nom), correspondance 1:1. Base de données dans Documents\WXWork\<id>\Data\, cache clair dans …\Cache\{File,Image,Voice}. Les balises content_type sont mappées selon les codes Windows (couvrant la table de rendu d'export_wxwork). Transcription voice : sur x64 Windows, installez faster-whisper+pilk (fonctionne) ; ARM n'a pas de wheel win_arm64 / pas de chaîne d'outils C++ → indisponible (localisation et export fonctionnent quand même).

C Réception temps réel + traitement autonome

# 1. Configurez « Recevoir des messages » selon docs/自建应用配置教程.md (URL/Token/EncodingAESKey)
# 2. Exposition Internet : cloudflared tunnel --url http://localhost:8000
python3 recv_server.py               # Vérification de signature + déchiffrement AES + acquittement rapide + mise en file d'attente jobs/inbox.jsonl
python3 agent_worker.py              # Lecture de la file → décision → réponse via wecom.py / écriture de document

Configurez config.json avec llm_base_url/llm_key/llm_model (compatible OpenAI) → le LLM décide de manière autonome ; "auto_reply":false enregistre seulement sans envoyer (validation humaine requise).

Règles de déclenchement de l'agent

L'utilisateur ditAppel
"Exporte/lis mes chats WeCom"Ligne B en trois étapes
"Envoie un message WeCom à X" "Notifie X"message text
"Cherche dans le carnet d'adresses" "Trouve la personne X"contact users/search
"Crée/lis un document WeCom"doc create/get
"Planifie une réunion" "Crée un événement"meeting create/schedule add
"Fais répondre automatiquement l'agent WeCom"Ligne C (recv_server + agent_worker)
Interface non encapsuléecall

Statut

  • B Lecture locale : ✅ Validé en pratique (5458 messages structurés).
  • A Actions actives : Code prêt, endpoints vérifiés selon la doc officielle ; en attente de test en conditions réelles avec des identifiants réels (gettoken déjà testé avec succès).
  • C Réception temps réel + traitement autonome : Chiffrement/déchiffrement des callbacks, boucle de décision testés ; en attente des identifiants + URL publique pour test final.
  • La lecture du carnet d'adresses peut être restreinte par la politique de confidentialité WeCom (nécessite portée visible + permissions, sinon 60011/60020).

Skills associés