WeChat Personnel via Wisdom
Utilisez le service Wisdom auto-hébergé de l'utilisateur pour opérer son compte WeChat personnel. Wisdom s'exécute sur un hôte Windows avec WeChat Desktop connecté et expose une API HTTP.
Les identifiants sont injectés par le connecteur BYOC personalwechat :
PERSONALWECHAT_BASE_URL— URL de base du serveur Wisdom, ex.http://82.156.126.14:8000.PERSONALWECHAT_API_TOKEN— Jeton API (API_TOKEN) de Wisdom. Secret — ne jamais afficher, imprimer ou journaliser.
L'assistant envoie le jeton sous forme Authorization: Bearer ... ; il ne place jamais le jeton dans l'URL. Pour les opérations UI en file d'attente comme la recherche et l'envoi, l'assistant soumet la tâche et attend /api/tasks/{id} avant d'afficher le résultat final.
Il s'agit du véritable compte WeChat personnel de l'utilisateur. Les opérations de lecture peuvent être exécutées directement. L'envoi de messages ou de fichiers doit d'abord faire l'objet d'un test à sec, puis être effectué uniquement après que l'utilisateur a explicitement approuvé la cible et le contenu exacts.
CLI
La compétence inclut un assistant ne dépendant que de la bibliothèque standard :
WX=$SKILL_DIR/scripts/personal_wechat.py
Vérifier la connexion en premier
Commencez toujours par le statut lorsque l'utilisateur demande à utiliser WeChat :
python3 $WX status
Réponse attendue en état sain :
{"auth":{"logged_in":true,"wechat_running":true,"page":"logged_in"}}
Si logged_in=false, dites à l'utilisateur d'ouvrir l'interface web Wisdom / RDP et de scanner le code QR WeChat. Si l'API renvoie 401, demandez à l'utilisateur de reconnecter le connecteur WeChat Personnel avec le jeton API Wisdom actuel.
Workflows de lecture
Compte actuel
python3 $WX account
Contacts
python3 $WX contacts --limit 50
Conversations récentes
Utilisez d'abord le endpoint normal des conversations ; il privilégie la base de données WeChat lorsqu'elle est prête et se rabat sur la base de données de l'application Wisdom.
python3 $WX conversations --limit 20
Pour les sessions d'historique WeChat local déchiffré :
python3 $WX conversations --history --limit 20
Messages dans une conversation
Listez d'abord les conversations, puis utilisez l'id comme conversation_id :
python3 $WX messages "34642176898@chatroom" --limit 50 --order asc
Messages historiques
Lisez à partir des bases de données locales WeChat déchiffrées de Wisdom :
python3 $WX history --limit 50
python3 $WX history --talker "34642176898@chatroom" --limit 50
python3 $WX history --limit 20 --offset 20
SQL brut, lecture seule uniquement
Wisdom n'autorise que SELECT et PRAGMA :
python3 $WX sql MicroMsg.db 'SELECT count(*) AS cnt FROM Session'
Utilisez le SQL brut uniquement pour des diagnostics ou des requêtes de métadonnées ciblées. Ne videz pas les grandes tables de messages sauf si l'utilisateur le demande explicitement.
Rafraîchir la base de données d'historique
Si l'historique semble obsolète, rafraîchissez l'instantané de la base de données déchiffrée :
python3 $WX refresh-history
Recherche
python3 $WX search "Alice"
La recherche pilote l'interface utilisateur WeChat, elle peut donc être plus lente que les lectures de la base de données locale.
Envoi de messages — GATED
send exécute un test à sec par défaut. Il n'envoie jamais sans --confirm, ou à moins qu'une tâche planifiée AceDataCloud n'ait pré-autorisé cette compétence et que vous utilisiez --unattended-confirm.
python3 $WX send "Alice" "Est-ce qu'on se réunit à 20h ce soir ?"
# -> {"dry_run": true, ...}
Affichez le résultat du test à sec à l'utilisateur et demandez une approbation explicite pour le destinataire et le texte exacts. Ensuite seulement, exécutez :
python3 $WX send "Alice" "Est-ce qu'on se réunit à 20h ce soir ?" --confirm
N'ajoutez jamais --confirm lors de la première tentative. N'inférez jamais un consentement à partir d'un texte vague. L'utilisateur doit clairement approuver l'envoi de ce message exact.
Confirmation sans surveillance pour les tâches planifiées
Lors de l'exécution dans une tâche planifiée AceDataCloud, la plateforme peut pré-autoriser certaines compétences pour une exécution sans surveillance. Si toutes ces conditions sont vraies :
AICHAT_UNATTENDED_MODE=trueAICHAT_ACTIVE_SKILLestpersonal-wechatouacedatacloud/personal-wechatAICHAT_ACTIVE_SKILLapparaît dansAICHAT_UNATTENDED_ALLOWED_SKILLS
alors l'utilisateur a pré-autorisé cette compétence pour cette tâche planifiée. Dans ce cas, utilisez :
python3 $WX send "Alice" "Est-ce qu'on se réunit à 20h ce soir ?" --unattended-confirm
Si l'assistant renvoie unattended_confirmation_denied, ne réessayez pas avec --confirm ; signalez le test à sec et expliquez que la tâche doit sélectionner cette compétence dans ses paramètres d'autorisation sans surveillance.
Règles de sécurité
- N'imprimez jamais
PERSONALWECHAT_API_TOKEN. - Considérez
PERSONALWECHAT_BASE_URL + API_TOKENcomme un contrôle à distance complet du WeChat de l'utilisateur. - Pour les opérations normales d'écriture/envoi dans le chat : faites un test à sec d'abord, demandez une approbation explicite, puis réexécutez avec
--confirm. - Pour les écritures sans surveillance dans les tâches planifiées : utilisez
--unattended-confirmuniquement lorsque l'environnement de la plateforme indique que cette compétence est pré-autorisée. - N'appelez pas les endpoints de déconnexion/redémarrage depuis la compétence sauf si l'utilisateur demande explicitement de réparer le service Wisdom.
- Si Wisdom renvoie 503 pour l'historique, exécutez
python3 $WX refresh-historyune fois, puis réessayez la lecture. - Si le serveur est inaccessible, demandez à l'utilisateur de vérifier l'hôte Windows / le groupe de sécurité / le port 8000.
Correspondance des endpoints
L'assistant encapsule ces endpoints 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(uniquement après--confirmou--unattended-confirmvérifié)