stkoecn/im-mcp

Guide de gestion opérationnelle du service MCP pour les historiques de chat, contacts, groupes et fichiers de WeChat et DingTalk sous Windows et macOS.

Qu'est-ce que im-mcp ?

Ce skill guide l'agent IA dans la gestion du cycle de vie des données et des opérations de la suite d'outils `im-mcp`, qui comprend les connecteurs MCP pour WeChat et DingTalk. Il couvre la vérification préalable de l'environnement, l'initialisation et le déchiffrement hors ligne des bases de données, la recherche de messages, et le nettoyage sécurisé des données après la tâche. Il est essentiel pour les développeurs et utilisateurs d'agents IA qui ont besoin d'analyser des communications professionnelles, de générer des rapports hebdomadaires, de retrouver des fichiers partagés ou de nettoyer des données sensibles. Le skill impose des règles strictes à l'agent, comme ne pas analyser le code en cas d'erreur, ne pas écrire de scripts de test de protocole, et toujours demander à l'utilisateur de confirmer l'état de connexion des applications avant d'initialiser. Il supporte les plateformes comme Claude Desktop, Cursor, Pi, et fournit des workflows opérationnels précis, de l'installation (via `uv tool install` ou `uvx`) jusqu'à la désinstallation complète, en passant par la génération d'un rapport de déploiement structuré.

Compatible avec✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/stkoecn/im-mcp/tree/HEAD/skills/im-mcp

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

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

Documentation

Guide de l'Agent IA pour l'Exploitation et la Gestion du Cycle de Vie des Données de IM-MCP

Cette compétence guide l'agent IA dans la gestion de la suite d'outils im-mcp (incluant WeChat MCP et DingTalk MCP) sous Windows et macOS, couvrant la vérification préalable de l'environnement, l'initialisation et le déchiffrement hors ligne des bases de données, la recherche de données de chat et le nettoyage sécurisé après la tâche.


1. Positionnement central et stratégie d'exécution (Core Principles & Execution Strategy)

1.1 Principe de priorité du mode d'exécution et stratégie

Lorsqu'il guide ou assiste l'utilisateur dans le déploiement, l'agent IA doit suivre la stratégie d'exécution suivante :

  1. Privilégier l'installation persistante : Dans des environnements de bureau comme Claude Desktop, Cursor ou d'autres clients prenant en charge la persistance des outils, il est recommandé d'utiliser uv tool install "git+https://github.com/stkoecn/im-mcp.git" --with "im-mcp[all]" ;
  2. Dégradation en environnement restreint/sandbox : Si l'environnement du client IA actuel (comme l'environnement sandbox Pi) bloque l'installation globale d'outils (avec un message du type Blocked ... use uvx), il faut suivre la politique de sécurité de cet environnement et utiliser la méthode d'exécution ad-hoc uvx --from "git+https://github.com/stkoecn/im-mcp.git[all]" pour exécuter les commandes concernées ;
  3. Alternative avec miroir réseau national (source Gitee) : Si l'utilisateur se trouve sur un réseau national chinois ou a un accès limité/lent à GitHub, l'URL Git ci-dessus peut être remplacée par le miroir Gitee :
    • Installation persistante : uv tool install "git+https://gitee.com/ws4m/im-mcp.git" --with "im-mcp[all]"
    • Exécution ad-hoc : uvx --from "git+https://gitee.com/ws4m/im-mcp.git[all]" <commande>
  4. Interdiction d'écrire du code de test de protocole sans autorisation : Après l'installation et l'exécution de l'initialisation (wechat-init et dingtalk-init), il est strictement interdit d'écrire des scripts ou du code pour simuler des tests de protocole JSON-RPC/stdio sous-jacents. Il faut livrer directement à l'utilisateur et fournir un guide d'activation du client ;
  5. Détection de l'environnement hôte et guidage de livraison : L'agent IA doit, en fonction de l'environnement client actuel (Pi, Claude Code/Desktop, Cursor, Cline, etc.), déterminer de manière autonome et indiquer à l'utilisateur les étapes spécifiques pour activer la compétence et le MCP (par exemple, saisir /reload, redémarrer le client ou activer la confiance dans le panneau latéral), et fournir directement 1 à 2 exemples d'utilisation en conversation quotidienne.

1.2 Matrice des commandes et aperçu des permissions

# Méthode A : Installation isolée de la chaîne d'outils CLI en persistance globale (recommandé en priorité)
uv tool install "git+https://github.com/stkoecn/im-mcp.git" --with "im-mcp[all]"

Matrice des commandes :

CommandeAppel après installation globaleMode d'exécution ad-hoc uvx en environnement restreint/sandboxCas d'usageExigences de permissionProduit clé / Chemin
wechat-initwechat-inituvx --from "git+https://github.com/stkoecn/im-mcp.git[all]" wechat-initExtraire la DBKey de WeChat et déchiffrer hors ligne en base de données SQLiteWindows nécessite les droits administrateur (lecture mémoire) ; macOS prend en charge --passphrase ou configuration persistante~/.wechat_mcp/decrypted/, ~/.wechat_mcp/app.db
dingtalk-initdingtalk-inituvx --from "git+https://github.com/stkoecn/im-mcp.git[all]" dingtalk-initExtraire hors ligne la clé DingTalk, déchiffrer la DB et fusionner les transactions WALPermissions utilisateur standard~/.dingtalk_mcp/decrypted/dingtalk.db
im-cleanim-cleanuvx --from "git+https://github.com/stkoecn/im-mcp.git[all]" im-cleanNettoyer en un clic et en toute sécurité toutes les données en clair exportées, clés et cachesPermissions utilisateur standard/administrateurNettoie les bases de données déchiffrées et les répertoires de données globales des deux ci-dessus
wechat-mcpwechat-mcpuvx --from "git+https://github.com/stkoecn/im-mcp.git[all]" wechat-mcpPoint d'entrée standard du serveur FastMCP WeChatPermissions utilisateur standardInterface stdio
dingtalk-mcpdingtalk-mcpuvx --from "git+https://github.com/stkoecn/im-mcp.git[all]" dingtalk-mcpPoint d'entrée standard du serveur FastMCP DingTalkPermissions utilisateur standardInterface stdio

2. Workflows opérationnels de l'agent IA (Lifecycle Workflows)

2.1 Avant le début de la tâche : Initialisation automatique de la base de données (Pre-flight Initialization)

Lorsque l'utilisateur demande "analyser les communications récentes WeChat/DingTalk", "générer un rapport hebdomadaire", "trouver tel fichier dans un groupe", si le MCP signale une erreur "base de données introuvable" ou retourne des résultats vides, l'agent IA doit exécuter l'initialisation de manière autonome :

Initialisation de la base de données DingTalk

DingTalk est un déchiffrement local hors ligne en Python pur, automatisé à presque 100%, sans besoin de droits administrateur :

# Exécution de l'initialisation par l'agent
 dingtalk-init
  • Sortie attendue : Détection d'un UID actif, affichage de 🎉 Synchronisation des données DingTalk réussie !.
  • Vérification préalable de l'environnement (interdiction de numérisation aveugle) : Si le message indique qu'aucun répertoire de données ou UID n'a été trouvé, l'agent IA a l'interdiction de lancer une recherche récursive profonde et aveugle de processus ou de disques sur la machine hôte. Il doit s'arrêter immédiatement, expliquer la situation à l'utilisateur et lui demander de confirmer que le client DingTalk est bien connecté sur la machine actuelle.

Initialisation de la base de données WeChat

WeChat nécessite une clé et doit déchiffrer et vérifier la base de données WCDB :

  • Windows :
    # Windows : Exécuter en tant qu'administrateur
    wechat-init
    
    WeChat doit extraire la clé de la mémoire du processus client en cours d'exécution et effectuer la vérification. Le client WeChat doit être démarré et connecté. Si WeChat n'est pas démarré, wechat-init signalera une erreur.
  • macOS :
    # macOS : Prend en charge la transmission directe d'une passphrase 64 bits
    wechat-init --passphrase <passphrase hexadécimale 64 bits>
    
    L'outil localise automatiquement le répertoire de données WeChat sur macOS (~/Library/Containers/com.tencent.xinWeChat/Data/Documents/xwechat_files/*/db_storage), appelle le CommonCrypto natif du système (CCCrypt) pour dériver la clé et effectuer le déchiffrement.
  • Vérification préalable de l'exécution de WeChat (interdiction de numérisation aveugle) :
    • Contrainte importante : Si le processus WeChat est introuvable ou si les éléments nécessaires à la clé manquent, l'agent IA ne doit en aucun cas essayer de deviner, de scanner des processus système non pertinents ou de parcourir les répertoires système globaux !
    • Procédure correcte : Il doit expliquer activement l'état actuel de l'environnement à l'utilisateur, le guider pour préparer l'environnement ou saisir la passphrase.
  • Détermination des permissions : Si Windows signale une erreur Access Denied, expliquer la raison à l'utilisateur et suggérer d'exécuter en tant qu'administrateur.
  • Indicateur de succès : Génération de la base de données déchiffrée dans le répertoire utilisateur ~/.wechat_mcp/decrypted/ et achèvement du nettoyage de l'index FTS5 dans ~/.wechat_mcp/app.db. Si seule une réexécution du nettoyage des données et de l'index est nécessaire, exécuter wechat-init --etl-only.

2.2 Pendant l'exécution de la tâche : Règles d'appel des outils MCP

Après une initialisation réussie, l'agent IA doit donner la priorité à la recherche via les outils MCP, en évitant les requêtes SQL brutes :

Ordre d'appel recommandé pour WeChat :

  1. list_wechat_sessions(limit=20) : Lister d'abord les sessions/groupes récents, obtenir le session_id clé (par exemple xxx@chatroom ou ID WeChat).
  2. search_wechat_messages(query="mot-clé", limit=50) : Recherche en texte intégral globale du contenu des chats (prend en charge le pagination avec offset).
  3. get_session_history(session_id="...", limit=100) : Obtenir le flux de messages contextuel de la session cible.
  4. get_message_image(message_id=...) : Déchiffrement à la demande des images de chat. Lorsque les messages de recherche ou d'historique contiennent [image], utiliser l'id du message correspondant pour appeler cet outil.
    • Mode par défaut : Retourne le chemin physique absolu local de l'image déchiffrée (mise en cache dans ~/.wechat_mcp/images/), évitant que les grandes images en Base64 ne saturent directement le contexte de l'Agent ;
    • Mode vision multimodal : Si l'Agent actuel a besoin d'une analyse visuelle de l'image, définir include_base64=True pour extraire la chaîne Base64 et permettre au modèle de l'interpréter.
  5. search_shared_files(keyword="...", limit=20) : Localiser les chemins de fichiers transférés dans un groupe ou une conversation privée.

WeChat propose également : get_messages_by_date / get_messages_by_range (extraction par date ou plage horaire), search_contacts (recherche inverse de contacts), list_chatroom_members (liste des membres du groupe), search_media_files (chemins disque des images/vidéos), list_favorites (favoris), list_emoticons (emojis), get_chat_activity_stats (statistiques d'activité), get_persona_style (distillation du style de communication), get_sync_status (fraîcheur de l'index). get_messages_by_date / get_messages_by_range prennent en charge la pagination avec offset, tout comme search_wechat_messages.

Ordre d'appel recommandé pour DingTalk :

  1. list_dingtalk_conversations(limit=20) : Obtenir la liste des groupes et des conversations privées récents (les vrais noms et noms de groupe sont déjà mappés automatiquement).
  2. search_dingtalk_messages(keyword="mot-clé", limit=50) : Recherche agrégée de texte sur 128 sous-tables.
  3. get_dingtalk_messages(cid="...", limit=100) : Voir les détails de la conversation dans un groupe DingTalk spécifique ou une conversation privée.
  4. list_dingtalk_contacts(keyword="Nom/Pinyin") : Recherche inverse rapide de l'UID du contact et de son vrai nom.

2.3 Mise à jour de version et maintenance (Project Upgrade & Version Maintenance)

Lorsque l'utilisateur demande "mettre à jour im-mcp", "mettre à niveau les MCP WeChat/DingTalk", "récupérer les derniers correctifs" ou qu'une nouvelle fonctionnalité/correction de bug est publiée, l'agent IA doit effectuer une mise à niveau en douceur en fonction de la méthode d'installation actuelle :

1. Mise à niveau en mode d'installation persistante globale (recommandé) :

Si l'utilisateur a auparavant installé avec uv tool install, utiliser uv tool update ou réinstaller en spécifiant le dépôt Git :

# Mise à jour globale standard en une commande
uv tool upgrade im-mcp

# Ou réinstaller en forçant la dernière version du dépôt distant (prend en charge le dernier HEAD Git)
uv tool install --force "git+https://github.com/stkoecn/im-mcp.git" --with "im-mcp[all]"

# Environnement réseau national (source Gitee)
uv tool install --force "git+https://gitee.com/ws4m/im-mcp.git" --with "im-mcp[all]"

2. Mode d'exécution ad-hoc (uvx) :

Si l'exécution se fait via uvx dans un sandbox, uvx peut mettre en cache une ancienne version de la Wheel. Pour effectuer la mise à niveau ou forcer le rafraîchissement du cache de version :

# Nettoyer le cache temporaire de l'outil uvx pour garantir la récupération du dernier code Git
uv cache clean im-mcp

# Ou ajouter le paramètre --refresh lors du prochain appel à uvx pour forcer la récupération de la dernière version
uvx --refresh --from "git+https://github.com/stkoecn/im-mcp.git[all]" <commande>

3. Rechargement en douceur après la mise à niveau :

Une fois la mise à niveau terminée, l'agent IA doit rappeler activement à l'utilisateur de rafraîchir ou de recharger le client pour charger la dernière version de la définition du service MCP et de la suite d'outils :

  • Pi / Pebrel : Inviter à saisir /reload ;
  • Claude Desktop / Cursor / WorkBuddy : Inviter à redémarrer le client ou à reconnecter le serveur MCP ;
  • Si cette mise à niveau implique des modifications de la logique de nettoyage de la base de données sous-jacente, exécuter wechat-init --etl-only en 2 secondes pour reconstruire sans perte le dernier index FTS, sans avoir à réextraire ou déchiffrer laborieusement.

2.4 Après la fin de la tâche : Nettoyage de la confidentialité des données et du stockage (Post-flight Cleanup)

Après avoir terminé le rapport hebdomadaire, le résumé des heures de travail, ou lorsque l'utilisateur demande explicitement "nettoyer l'environnement", "supprimer les historiques de chat exportés", l'agent IA doit appeler activement im-clean :

Prévisualisation des fichiers à nettoyer (vérification de sécurité en lecture seule) :

im-clean --dry-run

Exécution complète du nettoyage :

# Utiliser le paramètre -y pour un nettoyage silencieux de tous les fichiers SQLite, clés et caches intermédiaires exportés en clair (prend en charge la détection et le traitement automatiques des verrous de processus résidents)
im-clean -y

# En cas de verrouillage persistant par des handlers, ajouter --force pour forcer l'arrêt du service MCP et effectuer la suppression complète
im-clean -y --force

Nettoyage uniquement des données d'une plateforme spécifique :

# Nettoyer uniquement les données WeChat, conserver DingTalk
im-clean --scope wechat -y

# Nettoyer uniquement les données DingTalk, conserver WeChat
im-clean --scope dingtalk -y

2.5 Désinstallation complète et coordination du nettoyage client (Full Uninstallation Guidance)

Lorsque l'utilisateur demande explicitement "désinstaller complètement ce MCP", "supprimer définitivement l'outil de chat et sa configuration", l'agent IA doit aider l'utilisateur à effectuer le nettoyage standard dans l'ordre suivant, et indiquer activement à l'utilisateur les étapes qu'il doit effectuer manuellement dans l'interface du client :

  1. Quitter le client ou arrêter le service : Rappeler à l'utilisateur de quitter d'abord le client IA actuel, ou laisser im-clean -y --force gérer automatiquement les processus MCP résiduels ;
  2. Nettoyage automatique des données : L'agent IA exécute im-clean -y --force pour supprimer complètement ~/.wechat_mcp et ~/.dingtalk_mcp (s'assurer que le code de retour est 0, ne jamais signaler un succès si ce n'est pas le cas) ;
  3. Désinstallation automatique des dépendances : L'agent IA exécute uv tool uninstall im-mcp ou uv cache clean pour nettoyer l'environnement et le cache ;
  4. Rappel actif à l'utilisateur du nettoyage manuel du client :
    • En fonction du client hôte actuel, l'agent IA doit indiquer à l'utilisateur comment nettoyer manuellement les fichiers de configuration (les chemins courants pour chaque environnement peuvent être consultés à la fin de cette compétence dans [Annexe : Répertoires de référence des environnements hôtes d'agents courants]).

3. Gestion des pannes courantes et règles de conduite de l'agent (Troubleshooting & Agent Rules)

  1. Règle fondamentale : S'arrêter immédiatement en cas d'erreur, il est strictement interdit d'analyser le code ou de bricoler aveuglément :

    • Si, lors de l'installation, de l'initialisation ou de l'appel de test, une erreur inconnue, un conflit d'environnement ou une anomalie d'exécution se produit :
    • Interdiction absolue : L'agent IA a l'interdiction formelle de fouiller le code source, d'écrire des correctifs, de deviner et de réessayer à plusieurs reprises, ou de dépister aveuglément l'environnement système ;
    • Doit exécuter : S'arrêter immédiatement à l'étape de l'erreur, afficher le résumé de l'erreur principale tel quel, et demander clairement à l'utilisateur :

      "Une erreur s'est produite à l'étape actuelle : [bref résumé de l'erreur]. Souhaitez-vous que j'essaie de résoudre le problème, ou préférez-vous arrêter l'opération et ne pas utiliser l'outil ?"

    • Rendre le contrôle à l'utilisateur, et n'agir qu'après sa confirmation de continuer ou de quitter.
  2. Livrer immédiatement à l'utilisateur après l'installation et l'initialisation, il est strictement interdit d'écrire du code pour simuler des protocoles et effectuer des tests répétés :

    • Une fois que l'agent IA a terminé l'installation de l'outil (par exemple uv tool install), l'écriture des fichiers de configuration et l'initialisation (init), tout le processus de déploiement est terminé.
    • Interdiction absolue : L'agent IA ne doit en aucun cas écrire des scripts de test Python/Node pour simuler une poignée de main JSON-RPC 2.0, une communication par tube ou sonder les détails internes du protocole. Cela ne ferait qu'augmenter la consommation de tokens et le risque d'erreurs imprévues et incontrôlables, tout en privant l'utilisateur d'une perception et d'un contrôle en temps réel.
    • Doit exécuter : Après l'installation et l'initialisation, livrer directement et fournir les conseils d'utilisation les plus simples et les plus conviviaux :
      1. Indiquer clairement à l'utilisateur d'activer/faire confiance au MCP dans le client actuel (par exemple, demander à l'utilisateur de Pi d'exécuter /reload, aux utilisateurs de Claude Desktop / Cursor de redémarrer le client pour appliquer les modifications) ;
      2. Donner 1 à 2 exemples de langage naturel simples et intuitifs pour guider l'utilisateur, par exemple :

        "L'installation et l'initialisation sont prêtes ! Veuillez confirmer la confiance/l'activation de ce MCP dans votre client (par exemple, exécutez /reload). Ensuite, dites-moi simplement des phrases comme celles-ci pour commencer à utiliser : 👉 'Aide-moi à voir ce qui s'est dit dans le groupe de projet récemment' 👉 'Trouve les résultats de rapport que Cheng Peng a envoyés sur DingTalk' *👉 'Résume les communications de la semaine dernière sur tel besoin pour en faire un rapport hebdomadaire'"

  3. Confiance et autorisation de l'application client (identification autonome de l'environnement hôte et guide d'activation) :

    • L'Agent doit identifier de manière autonome le client hôte utilisé par l'utilisateur actuel en fonction des caractéristiques de la session en cours ;
    • Il est strictement interdit de sortir une réponse vague comme "activez-le dans votre client", mais doit donner le mode d'activation spécifique correspondant au client hôte actuel (par exemple, demander à l'utilisateur de Pi de saisir /reload, ou demander à l'utilisateur d'une application de bureau de redémarrer pour appliquer les modifications, les caractéristiques spécifiques peuvent être consultées dans l'annexe à la fin de ce document).
  4. Comportement à proscrire lorsque le processus WeChat/DingTalk est introuvable :

    • Il est strictement interdit d'effectuer un scan intensif et intrusif du disque dur ou de deviner d'autres processus système sur la machine hôte ;
    • Doit s'arrêter immédiatement et confirmer poliment avec l'utilisateur l'état de connexion du client.
  5. Problème de synchronisation des nouveaux messages WeChat : Lorsque le client WeChat est en ligne, les nouveaux messages sont écrits dans la base de données cryptée d'origine. Pour obtenir les nouveaux messages qui viennent d'être générés, l'agent IA peut suggérer à l'utilisateur de "réexécuter wechat-init" pour mettre à jour la base de données locale déchiffrée.

  6. Problème de verrou WAL de DingTalk : dingtalk-init intègre un mécanisme de copie automatique, de sorte que même si DingTalk est en cours d'exécution et en transaction WAL, aucun conflit de verrouillage SQLite ne se produit.

  7. Principe de confidentialité et de sécurité : Les bases de données SQLite déchiffrées sont des données locales sensibles. Dans un environnement de machine publique ou multi-locataire, il est impératif de guider ou d'exécuter automatiquement im-clean -y après la fin du travail.

  8. Rapport de retour de déploiement et mécanisme de développement automatique de la communauté (Deployment Feedback & Auto-Development) :

    • Que le déploiement et l'initialisation soient réussis ou aient rencontré un échec, à la fin du processus, l'agent IA doit prendre l'initiative de compiler et de générer pour l'utilisateur un « Rapport de retour de déploiement et d'exploitation » structuré et concis, et suggérer à l'utilisateur de le copier en un clic pour soumettre un Issue sur GitHub.
    • ⚠️ Principe fondamental de mise en évidence (doit être clairement marqué, en évitant toute ambiguïté) :
      • Dans le titre du rapport et la première ligne de la barre d'état, utiliser un indicateur visuel extrêmement visible (par exemple 【Statut:🟢 Déploiement réussi / SUCCESS】 ou 【Statut:🔴 Déploiement bloqué / FAILED】) ;
      • Éviter catégoriquement les formulations ambiguës ou neutres, afin que le demandeur ou l'agent de diagnostic puisse voir en un coup d'œil s'il s'agit d'un succès ou d'un échec.
    • Engagement d'exploitation automatisée de l'agent : Indiquer à l'utilisateur : "Ce projet est intégré à un pipeline de collaboration automatisée GitHub Agent. Les Issues que vous soumettez seront automatiquement reproduites, analysées, corrigées et fusionnées par un agent dédié !"
    • Modèle standard de génération du rapport :
      • En cas de succès (SUCCESS) :
        ### 📋 Rapport de retour de déploiement im-mcp 【Statut:🟢 Déploiement réussi / SUCCESS】
        > **Conclusion finale** : ✅ Toutes les dépendances installées avec succès, extraction des données et synchronisation des index terminées, le service est prêt à être utilisé immédiatement !
        
        - **Statut principal** : 🟢 SUCCESS
        - **Informations sur l'environnement** : Version de l'OS (ex: Win11 23H2), client hôte (ex: WorkBuddy / Pi / Claude Desktop), versions de Python et uv
        - **Mode d'installation** : `uv tool install` / `uvx` / code source local
        - **Indicateurs d'initialisation** : Temps passé (ex: WeChat 12s / DingTalk 3s), nombre de contacts/sessions/messages synchronisés
        - **Conseils d'utilisation** : Expérience de démarrage à froid, guide de synchronisation incrémentale ou attentes de fonctionnalités futures
        - **Point d'entrée pour les retours** : Rendez-vous sur [GitHub Issues](https://github.com/stkoecn/im-mcp/issues) pour soumettre votre expérience. L'Agent de la communauté suivra et optimisera automatiquement !
        
      • En cas d'échec ou de blocage (FAILED) :
        ### ⚠️ Rapport de retour de déploiement im-mcp 【Statut:🔴 Déploiement bloqué / FAILED】
        > **Conclusion finale** : ❌ Le processus a été interrompu en cours de route. Le service principal ne peut pas démarrer correctement. Veuillez vous référer au diagnostic de panne ci-dessous.
        
        - **Statut principal** : 🔴 FAILED
        - **Étape bloquée** : Installation des dépendances / Extraction de la clé WeChat / Déchiffrement DingTalk / Construction de l'index de la base de données / Montage du client
        - **Caractéristiques de l'environnement** : Version de l'OS, client hôte, version de WeChat (ex: 4.x / 3.x), version de DingTalk (ex: 7.x V3)
        - **Résumé de l'erreur clé** : Extraire la stack d'erreur principale ou les messages système (ex: Access Denied / Processus non démarré / Refus de verrouillage de fichier)
        - **Mesures déjà tentées** : Élévation de privilèges tentée ? Tentative de `--force` ou `--etl-only` ?
        - **Suggestions d'amélioration** : Indiquer les aspects du processus actuel qui ne sont pas fluides ou qui nécessitent une tolérance automatique de l'outil
        - **Retour en un clic** : Veuillez copier ce rapport et le soumettre sur [GitHub Issues](https://github.com/stkoecn/im-mcp/issues). L'agent dédié du dépôt analysera automatiquement les journaux et effectuera les réparations !
        

4. Annexe : Répertoires de référence des environnements hôtes d'agents courants (à titre indicatif uniquement)

💡 Déclaration : Ce répertoire recueille le comportement par défaut et les caractéristiques de configuration des environnements d'agents IA/de clients courants actuels, à titre indicatif uniquement. Les différentes plateformes peuvent être ajustées lors de mises à jour de version, veuillez vous référer à la documentation officielle la plus récente de la plateforme correspondante.

Environnement clientCaractéristiques d'identification typiquesRéférence de configuration/activationRéférence de désinstallation/nettoyage
Pi / PebrelPrésence de variables d'environnement PI_* ou du répertoire ~/.pi/Éditer ~/.pi/agent/mcp.json, saisir /reload dans la session pour rechargerSupprimer l'entrée de mcp.json, supprimer ~/.agents/skills/im-mcp, saisir /reload
Claude DesktopConfiguration Claude dans AppData localÉditer %APPDATA%\Claude\claude_desktop_config.json, redémarrer complètement l'application clientSupprimer l'entrée de mcpServers dans le fichier de configuration et redémarrer le logiciel, nettoyer le répertoire de la compétence
CursorDérivé de VS Code, présence de configuration CursorAjouter dans Settings ➔ Features ➔ MCP Servers, montage instantané dans l'interfaceCliquer sur Delete / Remove pour l'entrée correspondante dans la liste des serveurs MCP
Cline / Roo CodePanneau d'extension VS CodeAjouter la configuration dans l'onglet MCP du panneau latéral des extensions, passer à "Enabled" pour activer et autoriserDésactiver l'interrupteur ou cliquer sur l'icône de la corbeille pour supprimer dans la liste MCP du panneau latéral
Cherry StudioOutil de gestion multi-modèles de bureauAjouter la commande stdio dans Paramètres ➔ Serveurs MCP, sauvegarder pour appliquerSélectionner et cliquer sur "Supprimer" dans la liste des serveurs MCP, sauvegarder les paramètres
WorkBuddyPrésence du répertoire ~/.workbuddy/ ou de configuration associéeÉditer ~/.workbuddy/mcp.json, cliquer manuellement sur "Approuver/Activer" dans l'interface de gestion des connecteursSupprimer le bloc de configuration de mcp.json et supprimer le connecteur dans l'interface

Skills associés