wecom-agent — Agent WeCom tout-en-un
| Ligne | Capacité | Point d'entrée | Dépendances |
|---|---|---|---|
| A Actions actives | Envoyer des messages / Gérer les contacts / Lire-écrire des documents / Calendrier / Réunions | wecom.py | CorpID+Secret+AgentId + IP de confiance |
| B Lecture locale | Dé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 autonome | Recevoir un message → analyser → répondre automatiquement / écrire un document | recv_server.py + agent_worker.py | Identifiants 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égorie | méthode | paramètres | Fonction |
|---|---|---|---|
contact | departments | aucun | Liste des services (nom + ID) |
contact | users | {"department_id":1} | Membres du service (userid + nom) |
contact | get/search/list_id | {"userid"/"keyword":..} | Détails membre / rechercher par nom / liste des ID |
message | text/markdown/news | {"touser":"x","content":".."} | Envoyer un message (touser par défaut @all, plusieurs séparés par |) |
doc | create/get/edit/del/rename/sheet_get/sheet_edit | corps transmis | Lecture/écriture et édition de documents (edit = batch_update) |
schedule/meeting | add/create/list.. | corps transmis | Calendrier / 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échiffrementwxwork_crypto.py+ analyseexport_wxwork.pyest 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-commande | Fonction |
|---|---|
contacts [mot] | Carnet d'adresses (138 personnes : nom / service / poste / téléphone / email), filtrable par mot |
conversations | Liste 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 |
stats | Statistiques / profil (classement expéditeurs / conversations / type / par heure / par jour) |
todo / calendar | Tâ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 dit | Appel |
|---|---|
| "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ée | call |
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 (
gettokendé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).