stkoecn/im-mcp

IM-MCP – Leitfaden zur KI-Agenten-Operation und Datenlebenszyklusverwaltung

Dieser Skill leitet den KI-Agenten bei der Verwaltung des im-mcp-Werkzeugsatzes (einschließlich WeChat MCP und DingTalk MCP) unter Windows und macOS an. Er umfasst Umgebungsprüfung, Offline-Datenbankinitialisierung und -entschlüsselung, Suche in Chatdaten sowie die sichere Bereinigung nach Abschluss der Aufgaben.

---

1. Kernpositionierung und Ausführungsstrategie (Core Principles & Execution Strategy)

1.1 Priorität der Ausführungsmethode und Ausführungsstrategie

Der KI-Agent sollte bei der Führung oder Unterstützung des Benutzers bei der Bereitstellung die folgende Ausführungsstrategie befolgen:

1. Bevorzugte persistente Installation: In Umgebungen wie Claude Desktop, Cursor oder anderen Desktop-Clients, die persistente Werkzeuge unterstützen, wird uv tool install "git+https://github.com/stkoecn/im-mcp.git" --with "im-mcp[all]" empfohlen.
2. Downgrade in Sandbox-/eingeschränkten Umgebungen: Wenn die aktuelle KI-Client-Umgebung (z. B. Pi-Sandbox) die globale Tool-Installation blockiert (Hinweis Blocked ... use uvx), sollte direkt der Sicherheitsstrategie dieser Umgebung gefolgt und die relevanten Befehle ad-hoc mit uvx --from "git+https://github.com/stkoecn/im-mcp.git[all]" ausgeführt werden.
3. Netzwerk-Spiegel-Alternative für Inland (Gitee-Quelle): Wenn der Benutzer sich in einer inländischen Netzwerkumgebung befindet oder der Zugriff auf GitHub eingeschränkt/langsam ist, kann die Git-Adresse oben direkt durch das Gitee-Spiegel-Repository ersetzt werden:
   • Persistent: uv tool install "git+https://gitee.com/ws4m/im-mcp.git" --with "im-mcp[all]"
   • Ad-hoc: uvx --from "git+https://gitee.com/ws4m/im-mcp.git[all]" <command>
4. Keine eigenmächtigen Protokolltest-Codes erstellen: Nach der Installation und Initialisierung (wechat-init und dingtalk-init) ist es strengstens untersagt, eigene Skripte oder Codes zur Simulation von JSON-RPC/stdio-Protokolltests zu schreiben. Der Vorgang muss direkt abgeschlossen und dem Benutzer mit einer Anleitung zur Client-Aktivierung übergeben werden.
5. Host-Umgebungserkennung und Übergabeanleitung: Der KI-Agent sollte basierend auf der aktuellen Client-Umgebung (z. B. Pi, Claude Code/Desktop, Cursor, Cline) eigenständig die spezifischen Schritte zur Aktivierung des Skills und MCP erkennen und dem Benutzer mitteilen (z. B. Eingabe von /reload, Neustart des Clients oder Aktivierung von Vertrauen in der Seitenleiste). Direkt 1-2 Beispiele für die tägliche Nutzung im Gespräch angeben.

1.2 Befehlsmatrix und Berechtigungsübersicht

# Methode A: Globale persistente isolierte Installation der CLI-Toolchain (bevorzugt)
uv tool install "git+https://github.com/stkoecn/im-mcp.git" --with "im-mcp[all]"

Befehlsmatrix:

Befehl	Aufruf nach globaler Installation	Ad-hoc-Ausführung in Sandbox/eingeschränkter Umgebung uvx	Anwendungsfall	Berechtigungsanforderung	Wichtige Ergebnisse / Pfade
wechat-init	wechat-init	uvx --from "git+https://github.com/stkoecn/im-mcp.git[all]" wechat-init	WeChat-DBKey extrahieren und offline in SQLite-Datenbank entschlüsseln	Windows: Administratorrechte (Speicher auslesen); macOS: --passphrase oder persistente Konfiguration	~/.wechat_mcp/decrypted/, ~/.wechat_mcp/app.db
dingtalk-init	dingtalk-init	uvx --from "git+https://github.com/stkoecn/im-mcp.git[all]" dingtalk-init	DingTalk-Schlüssel offline extrahieren, DB entschlüsseln und WAL-Transaktionen zusammenführen	Normale Benutzerrechte	~/.dingtalk_mcp/decrypted/dingtalk.db
im-clean	im-clean	uvx --from "git+https://github.com/stkoecn/im-mcp.git[all]" im-clean	Alle exportierten Klartextdaten, Schlüssel und Caches sicher mit einem Befehl löschen	Normale/Administratorrechte	Löscht die entschlüsselten Bibliotheken und globalen Datenverzeichnisse beider obigen
wechat-mcp	wechat-mcp	uvx --from "git+https://github.com/stkoecn/im-mcp.git[all]" wechat-mcp	WeChat FastMCP Standard-Server-Einstiegspunkt	Normale Benutzerrechte	stdio-Schnittstelle
dingtalk-mcp	dingtalk-mcp	uvx --from "git+https://github.com/stkoecn/im-mcp.git[all]" dingtalk-mcp	DingTalk FastMCP Standard-Server-Einstiegspunkt	Normale Benutzerrechte	stdio-Schnittstelle

---

2. KI-Agenten-Arbeitsabläufe (Lifecycle Workflows)

2.1 Vor Aufgabenbeginn: Automatische Datenbankinitialisierung (Pre-flight Initialization)

Wenn der Benutzer bittet, "die letzten WeChat/DingTalk-Kommunikationen zu analysieren", "einen Wochenbericht zu erstellen" oder "nach Dateien in einer bestimmten Gruppe zu suchen", und der MCP meldet, dass die Datenbank nicht gefunden wurde oder leere Ergebnisse zurückgegeben werden, sollte der KI-Agent die Initialisierung eigenständig durchführen:

DingTalk-Datenbankinitialisierung (DingTalk)

DingTalk ist eine reine Python-lokale Offline-Entschlüsselung, die fast 100% automatisch abläuft und keine Administratorrechte erfordert:

# KI-Agent führt Initialisierung durch
dingtalk-init

• Erwartete Ausgabe: Erkennt aktive UID, gibt 🎉 DingTalk-Dateninitialisierung erfolgreich synchronisiert! aus.
• Umgebungsvorprüfung (Kein blindes Scannen): Wenn gemeldet wird, dass das Datenverzeichnis oder die UID nicht gefunden wurde, ist es dem KI-Agenten untersagt, eigenmächtig auf dem Hostsystem ziellos rekursiv zu suchen, Prozesse oder Festplatten zu durchsuchen. Bitte pausieren Sie direkt und erläutern Sie die Situation dem Benutzer. Fragen und erinnern Sie den Benutzer, zu bestätigen, ob der DingTalk-Client auf diesem Rechner angemeldet ist.

WeChat-Datenbankinitialisierung (WeChat)

WeChat benötigt einen Schlüssel und führt die Entschlüsselung und Überprüfung der WCDB-Datenbank durch:

• Windows:

  # Windows: Als Administrator ausführen
  wechat-init
  

  WeChat extrahiert den Schlüssel aus dem Prozessspeicher des laufenden Clients und führt die Überprüfung durch. Der WeChat-Client muss gestartet und angemeldet sein. Wenn WeChat nicht gestartet ist, gibt wechat-init einen Fehler aus.
• macOS:

  # macOS: Unterstützt die direkte Übergabe einer 64-Bit-Passphrase
  wechat-init --passphrase <64-Bit-Hex-Passphrase>
  

  Das Tool lokalisiert automatisch das macOS-WeChat-Datenverzeichnis (~/Library/Containers/com.tencent.xinWeChat/Data/Documents/xwechat_files/*/db_storage), ruft das systemeigene CommonCrypto (CCCrypt) auf, leitet den Schlüssel ab und führt die Entschlüsselung durch.
• Vorprüfung auf laufendes WeChat (Kein blindes Scannen):
  • Wichtige Einschränkung: Wenn der WeChat-Prozess nicht gefunden wird oder Schlüsselmaterial fehlt, darf der KI-Agent nicht eigenständig versuchen, systemfremde Prozesse zu erraten oder systemweite Verzeichnisse zu durchsuchen!
  • Korrektes Vorgehen: Sollte aktiv dem Benutzer den aktuellen Umgebungszustand erläutern, den Benutzer zur Vorbereitung der Umgebung oder zur Eingabe der Passphrase führen.
• Berechtigungsfeststellung: Wenn Windows Access Denied meldet, dem Benutzer den Grund erläutern und vorschlagen, den Befehl als Administrator auszuführen.
• Erfolgsindikator: Erzeugt die entschlüsselte Datenbank im Benutzerdatenverzeichnis ~/.wechat_mcp/decrypted/ und führt die FTS5-Indexbereinigung in ~/.wechat_mcp/app.db durch. Wenn nur die Datenbereinigung und Indizierung wiederholt werden müssen, kann wechat-init --etl-only ausgeführt werden.

---

2.2 Während der Aufgabenausführung: MCP-Tool-Aufrufkonventionen

Nach erfolgreicher Initialisierung sollte der KI-Agent bevorzugt MCP-Tools zur Suche verwenden und direkte SQL-Abfragen vermeiden:

Empfohlene Aufrufreihenfolge für WeChat (wechat):

1. list_wechat_sessions(limit=20): Listet zuerst die letzten aktiven Sitzungen/Gruppen auf, um die wichtige session_id (wie xxx@chatroom oder WeChat-ID) zu erhalten.
2. search_wechat_messages(query="Schlüsselwort", limit=50): Globale Volltextsuche im Chatverlauf (unterstützt offset-Paginierung).
3. get_session_history(session_id="...", limit=100): Holt den Nachrichtenkontext der Ziel-Sitzung.
4. get_message_image(message_id=...): Entschlüsselung von Chatbildern bei Bedarf. Wenn in Suchergebnissen oder Nachrichtenverläufen [Bild] enthalten ist, mit der entsprechenden Nachrichten-ID dieses Tool aufrufen.
   • Standardmodus: Gibt den lokalen physischen absoluten Pfad des entschlüsselten Bildes zurück (zwischengespeichert in ~/.wechat_mcp/images/), vermeidet das Aufblähen des Agenten-Kontexts durch große Base64-Bilder;
   • Multimodaler Bildanzeigemodus: Wenn der aktuelle Agent eine visuelle Bildanalyse benötigt, kann include_base64=True gesetzt werden, um den Base64-String zur Verarbeitung durch das Modell zu extrahieren.
5. search_shared_files(keyword="...", limit=20): Lokalisiert Dateipfade, die in Gruppen oder privaten Chats geteilt wurden.

Auf der WeChat-Seite werden außerdem bereitgestellt: get_messages_by_date / get_messages_by_range (nach Datum oder Zeitbereich abrufen), search_contacts (Kontaktrückwärtssuche), list_chatroom_members (Gruppenmitgliederliste), search_media_files (Bild-/Videopfade auf der Festplatte), list_favorites (Favoriten), list_emoticons (Emoticons), get_chat_activity_stats (Aktivitätsstatistiken), get_persona_style (Kommunikationsstil-Destillation), get_sync_status (Indexaktualität). get_messages_by_date / get_messages_by_range unterstützen wie search_wechat_messages die offset-Paginierung.

Empfohlene Aufrufreihenfolge für DingTalk (dingtalk):

1. list_dingtalk_conversations(limit=20): Ruft die Liste der letzten Gruppen- und Privatchats ab (wurde automatisch mit den aktuellsten echten Namen und Gruppennamen aktualisiert).
2. search_dingtalk_messages(keyword="Schlüsselwort", limit=50): Aggregierte Suche über 128 Tabellen nach Text.
3. get_dingtalk_messages(cid="...", limit=100): Zeigt Details zu einem bestimmten DingTalk-Gruppen- oder Privatchat an.
4. list_dingtalk_contacts(keyword="Name/Pinyin"): Schnelle Rückwärtssuche nach Kontakt-UID und echtem Namen.

---

2.3 Versionsupgrade und Wartung (Project Upgrade & Version Maintenance)

Wenn der Benutzer ein Update von im-mcp, ein Upgrade von WeChat/DingTalk MCP, das Ziehen der neuesten Fehlerbehebungen oder neue Funktionen anfordert, sollte der KI-Agent basierend auf der aktuellen Installationsmethode ein reibungsloses Upgrade durchführen:

1. Upgrade bei globaler persistenter Installation (empfohlen):

Wenn der Benutzer zuvor mit uv tool install installiert hat, mit uv tool update oder Neuspezifikation des Git-Repositorys upgraden:

# Standard globales Update mit einem Befehl
uv tool upgrade im-mcp

# Oder Zwangsweise Neuinstallation mit der neuesten Version des Remote-Repositorys (unterstützt neuesten Git HEAD)
uv tool install --force "git+https://github.com/stkoecn/im-mcp.git" --with "im-mcp[all]"

# Inländische Netzwerkumgebung (Gitee-Quelle)
uv tool install --force "git+https://gitee.com/ws4m/im-mcp.git" --with "im-mcp[all]"

2. Ad-hoc-Ausführungsmodus (uvx):

Wenn im Sandkasten mit uvx ausgeführt wird, kann uvx standardmäßig die alte Version des Wheels zwischenspeichern. Führen Sie zum Upgrade oder zum erzwungenen Leeren des Versionscaches durch:

# Löschen des temporären uvx-Tool-Caches, um sicherzustellen, dass der neueste Git-Code gezogen wird
uv cache clean im-mcp

# Oder beim nächsten Aufruf von uvx den Parameter --refresh anhängen, um die neueste Version zu erzwingen
uvx --refresh --from "git+https://github.com/stkoecn/im-mcp.git[all]" <command>

3. Neuladen nach dem Upgrade:

Nach Abschluss des Upgrades sollte der KI-Agent den Benutzer aktiv daran erinnern, den Client zu aktualisieren oder neu zu laden, um die neueste Version der MCP-Servicedefinitionen und Tool-Sets zu laden:

• Pi / Pebrel: Aufforderung zur Eingabe von /reload;
• Claude Desktop / Cursor / WorkBuddy: Aufforderung zum Neustart des Clients oder zur erneuten Verbindung mit dem MCP-Server;
• Wenn dieses Upgrade Änderungen an der zugrunde liegenden Datenbankbereinigungslogik beinhaltet, kann wechat-init --etl-only ausgeführt werden, um innerhalb von 2 Sekunden ohne zeitaufwändige Neu-Extraktion oder -Entschlüsselung den neuesten FTS-Index zu erstellen.

---

2.4 Nach Aufgabenende: Datenprivatsphäre und Speicherbereinigung (Post-flight Cleanup)

Nach Abschluss des Wochenberichts, der Zusammenfassung der Arbeitszeiten oder wenn der Benutzer explizit "Umgebung bereinigen" oder "exportierte Chatverläufe löschen" anfordert, sollte der KI-Agent aktiv im-clean aufrufen:

Vorschau der zu löschenden Dateien (schreibgeschützte Sicherheitsprüfung):

im-clean --dry-run

Vollständige Bereinigung durchführen:

# Verwendung des Parameters -y zur stillen Bereinigung aller exportierten Klartext-SQLite-Datenbanken, Schlüssel und Zwischen-Caches (unterstützt automatische Erkennung und Behandlung von laufenden Prozesssperren)
im-clean -y

# Bei verbleibenden Handle-Sperren kann --force hinzugefügt werden, um die MCP-Dienste zwangsweise zu beenden und eine vollständige Löschung durchzuführen
im-clean -y --force

Nur Daten einer bestimmten Plattform bereinigen:

# Nur WeChat-Daten bereinigen, DingTalk-Daten behalten
im-clean --scope wechat -y

# Nur DingTalk-Daten bereinigen, WeChat-Daten behalten
im-clean --scope dingtalk -y

2.5 Vollständige Deinstallation und koordinierte Client-Bereinigung (Full Uninstallation Guidance)

Wenn der Benutzer explizit "dieses MCP vollständig deinstallieren" oder "Chat-Tool und Konfiguration vollständig löschen" anfordert, sollte der KI-Agent dem Benutzer helfen, die folgende standardmäßige Löschreihenfolge durchzuführen, und den Benutzer aktiv darüber informieren, welche Schritte er manuell in der Client-Oberfläche durchführen muss:

1. Client beenden oder Dienst stoppen: Den Benutzer daran erinnern, zuerst den aktuellen AI-Client zu beenden, oder im-clean -y --force die verbleibenden MCP-Prozesse automatisch behandeln lassen;
2. Automatische Datenbereinigung: Der KI-Agent führt im-clean -y --force aus, um ~/.wechat_mcp und ~/.dingtalk_mcp vollständig zu löschen (sicherstellen, dass der Rückgabecode 0 ist; bei Nicht-0 ist es strengstens untersagt, fälschlicherweise Erfolg zu melden);
3. Automatische Deinstallation der Abhängigkeiten: Der KI-Agent führt uv tool uninstall im-mcp oder uv cache clean aus, um die Umgebung und den Cache zu bereinigen;
4. Aktive Ausgabe einer Erinnerung zur manuellen Client-Bereinigung an den Benutzer:
   • Der KI-Agent sollte basierend auf dem aktuellen Host-Client den Benutzer auffordern, die Konfigurationsdateien manuell zu bereinigen (spezifische Pfade für jede Umgebung finden Sie im [Anhang: Referenzverzeichnisse für gängige Agent-Host-Umgebungen] am Ende dieses Skills).

---

3. Häufige Fehlerbehebung und Verhaltensregeln für KI-Agenten (Troubleshooting & Agent Rules)

1. Kernverbot: Sofort anhalten bei Fehlern, kein eigenmächtiges Analysieren von Code oder sinnloses Herumprobieren:

   • Wenn während der Installation, Initialisierung oder Testaufrufen unbekannte Fehler, Umgebungskonflikte oder Ausführungsanomalien auftreten:
   • Absolut verboten: Der KI-Agent darf nicht eigenmächtig in den Quellcode eindringen, Patches schreiben, Code reparieren, wiederholt raten oder blind die Systemumgebung durchsuchen;
   • Muss ausgeführt werden: Sofort am Schritt des Fehlers anhalten, die Kernfehlerzusammenfassung originalgetreu anzeigen und den Benutzer klar fragen:

     "Beim aktuellen Schritt ist ein Fehler aufgetreten: [Kurzbeschreibung des Fehlers]. Möchten Sie das Problem selbst beheben oder die Operation abbrechen und nicht mehr verwenden?"

   • Die Kontrolle an den Benutzer übergeben; erst nach Bestätigung durch den Benutzer fortfahren oder abbrechen.

2. Nach Abschluss der Installation und Initialisierung sofort an den Benutzer übergeben; kein eigenmächtiges Schreiben von Code zum Testen des Protokolls:

   • Nach Abschluss der Tool-Installation (z. B. uv tool install), dem Schreiben der Konfigurationsdatei und der init-Initialisierung ist der gesamte Bereitstellungsprozess vollständig abgeschlossen.
   • Absolut verboten: Der KI-Agent darf keine Python/Node-Testskripte schreiben, um den JSON-RPC 2.0-Handshake, die Pipe-Kommunikation oder Details des Protokolls zu simulieren. Dies erhöht nicht nur den Token-Verbrauch und das Risiko unkontrollierbarer Fehler, sondern entzieht dem Benutzer auch die Echtzeitwahrnehmung und Kontrolle.
   • Muss ausgeführt werden: Nach Abschluss der Installation und Initialisierung direkt übergeben und eine prägnante, benutzerfreundliche Nutzungsanleitung geben:
     1. Den Benutzer klar darauf hinweisen, dieses MCP im aktuellen Client zu aktivieren/zu vertrauen (z. B. Pi-Benutzer auffordern, /reload auszuführen; Claude Desktop / Cursor-Benutzer auffordern, den Client neu zu starten, um die Änderungen zu übernehmen);
     2. 1-2 einfache, intuitive Beispiele in natürlicher Sprache geben, um den Benutzer zur Nutzung zu führen, z. B.:

        *"Installation und Initialisierung sind abgeschlossen! Bitte bestätigen Sie die Vertrauenswürdigkeit dieses MCP im Client (z. B. durch Ausführen von /reload). Danach können Sie direkt mit mir sprechen, zum Beispiel: 👉 'Hilf mir, die letzten Gespräche in der Projektgruppe zu finden.' 👉 'Suche die von Cheng Peng gesendeten Berichtsstatistiken in DingTalk.' 👉 'Fasse die Kommunikationsaufzeichnungen der letzten Woche zu Anforderung XYZ für den Wochenbericht zusammen.'"

3. Client- und Anwendungsautorisierung und -vertrauen (Host-Umgebungserkennung und Aktivierungsanleitung)::

   • Der Agent muss anhand der Merkmale der aktuellen Sitzung eigenständig erkennen, welchen Client-Host der Benutzer verwendet;
   • Es ist strengstens untersagt, vage auszugeben "Aktivieren Sie es in Ihrem Client". Stattdessen muss basierend auf dem aktuellen Host die spezifische Methode für den entsprechenden Client angegeben werden (z. B. Aufforderung zur Eingabe von /reload bei Pi, oder Aufforderung zum Neustart der Desktop-Anwendung bei Desktop-Apps; Einzelheiten finden Sie im Anhang am Ende).

4. Verhaltensverbote, wenn der WeChat-/DingTalk-Prozess nicht gefunden wird:

   • Strengstens untersagt ist das eigenmächtige, zeitaufwändige und invasive Durchsuchen der gesamten Festplatte oder das Erraten anderer Systemprozesse auf dem Host;
   • Muss unterbrochen und der Benutzer höflich um Bestätigung des Client-Anmeldestatus gebeten werden.

5. Problem der inkrementellen Nachrichtensynchronisation bei WeChat: Wenn der WeChat-Client online ist, werden neue Nachrichten in die ursprüngliche verschlüsselte Bibliothek geschrieben. Um die gerade erstellten neuen Nachrichten zu erhalten, kann der KI-Agent den Benutzer auffordern, "wechat-init erneut auszuführen", um die lokale entschlüsselte Bibliothek zu aktualisieren.

6. DingTalk WAL-Sperrproblem: dingtalk-init verfügt über einen eingebauten automatischen Kopiermechanismus. Selbst wenn DingTalk läuft und sich in einer WAL-Transaktion befindet, kommt es nicht zu SQLite-Sperrkonflikten.

7. Datenschutzsicherheitsprinzip: Die entschlüsselte SQLite-Datenbank ist sensible lokale Privatsphäre. In öffentlichen Umgebungen oder Multi-Tenant-Umgebungen muss nach Abschluss der Arbeiten im-clean -y angewiesen oder automatisch ausgeführt werden.

8. Bereitstellungs-Feedback-Bericht und Community-Autoentwicklungsmechanismus (Deployment Feedback & Auto-Development):

   • Unabhängig davon, ob die Bereitstellung und Initialisierung erfolgreich oder fehlgeschlagen ist, sollte der KI-Agent am Ende des Prozesses aktiv einen strukturierten, prägnanten "Bereitstellungs- und Betriebs-Feedback-Bericht" für den Benutzer erstellen und den Benutzer auffordern, diesen mit einem Klick zu kopieren und ein Issue auf GitHub zu erstellen.
   • ⚠️ Kern-Highlight-Prinzip (muss deutlich markiert werden, vage Formulierungen sind strengstens untersagt):
     • Im Berichtstitel und in der ersten Statuszeile müssen extrem auffällige visuelle Kennzeichnungen verwendet werden (z. B. 【Status: 🟢 Bereitstellung erfolgreich / SUCCESS】 oder 【Status: 🔴 Bereitstellung blockiert / FAILED】);
     • Vage, neutrale Formulierungen sind strikt zu vermeiden, damit der Fragesteller und der prüfende KI-Agent sofort erkennen, ob es ein Erfolg oder ein Fehler ist.
   • Versprechen der automatisierten KI-Agenten-Operation: Den Benutzer daran erinnern: "Dieses Projekt ist an die GitHub-Agent-Automatisierungskollaborationspipeline angeschlossen. Die von Ihnen eingereichten Issues werden von einem speziellen Agenten automatisch reproduziert, behoben und als Merge-Request eingereicht!"
   • Standardvorlage für die Berichterstellung:
     • Bei Erfolg (SUCCESS):

       ### 📋 im-mcp Bereitstellungs-Feedback-Bericht 【Status: 🟢 Bereitstellung erfolgreich / SUCCESS】
       > **Endgültiges Fazit**: ✅ Alle Abhängigkeiten erfolgreich installiert, Datenextraktion und Indexsynchronisation abgeschlossen, Dienst ist sofort einsatzbereit!
       
       - **Kernstatus**: 🟢 SUCCESS
       - **Umgebungsinformationen**: OS-Version (z. B. Win11 23H2), Client-Host (z. B. WorkBuddy / Pi / Claude Desktop), Python- und uv-Version
       - **Installationsmethode**: `uv tool install` / `uvx` / Lokaler Quellcode
       - **Initialisierungsmetriken**: Dauer (z. B. WeChat 12s / DingTalk 3s), Anzahl synchronisierter Kontakte/Sitzungen/Nachrichten
       - **Nutzungsvorschläge**: Kaltstart-Erfahrung, inkrementelle Synchronisationsanleitung oder nächste Funktionswünsche
       - **Feedback-Eingang**: Besuchen Sie [GitHub Issues](https://github.com/stkoecn/im-mcp/issues) und teilen Sie Ihre Erfahrungen. Der Community-Agent wird diese automatisch verfolgen und optimieren!
       

     • Bei Fehler oder Blockade (FAILED):

       ### ⚠️ im-mcp Bereitstellungs-Feedback-Bericht 【Status: 🔴 Bereitstellung blockiert / FAILED】
       > **Endgültiges Fazit**: ❌ Der Prozess wurde unterbrochen und blockiert, der Kerndienst kann nicht normal gestartet werden. Bitte lesen Sie die folgende Fehlerlokalisierung.
       
       - **Kernstatus**: 🔴 FAILED
       - **Blockierte Phase**: Abhängigkeitsinstallation / WeChat-Schlüsselextraktion / DingTalk-Entschlüsselung / Datenbankindexerstellung / Client-Mounting
       - **Umgebungsmerkmale**: OS-Version, Client-Host, WeChat-Version (z. B. 4.x/3.x), DingTalk-Version (z. B. 7.x V3)
       - **Wichtige Fehlerzusammenfassung**: Kopieren Sie den Kern-Fehler-Stack oder die Systemmeldung (z. B. Access Denied / Prozess läuft nicht / Dateisperre verweigert)
       - **Bereits ergriffene Maßnahmen**: Wurden Rechte erhöht? Wurde `--force` oder `--etl-only` versucht?
       - **Verbesserungsvorschläge**: Zeigen Sie auf, welche Schritte im aktuellen Prozess nicht reibungslos sind oder eine automatische Fehlertoleranz des Tools erfordern.
       - **Ein-Klick-Feedback**: Bitte kopieren Sie diesen Bericht und reichen Sie ihn unter [GitHub Issues](https://github.com/stkoecn/im-mcp/issues) ein. Der spezielle Agent des Repositorys analysiert automatisch die Logs und beginnt mit der Reparatur!
       

---

4. Anhang: Referenzverzeichnisse für gängige Agent-Host-Umgebungen (nur als Referenz)

💡 Hinweis: Dieses Verzeichnis enthält die Standardverhaltensweisen und Konfigurationsmerkmale der derzeit gängigen AI-Client-/Agent-Umgebungen. Nur als Referenz. Nach Versionsupdates und Iterationen der Plattformen können Änderungen auftreten. Bitte beachten Sie die neueste offizielle Dokumentation der jeweiligen Plattform.

Client-Umgebung	Typische Erkennungsmerkmale	Referenz für Konfiguration/Aktivierung	Referenz für Deinstallation/Bereinigung
Pi / Pebrel	Existenz von PI_*-Umgebungsvariablen oder ~/.pi/-Verzeichnis	Bearbeiten Sie ~/.pi/agent/mcp.json, geben Sie in der Sitzung /reload ein, um die Änderungen zu laden	Eintrag aus mcp.json entfernen, ~/.agents/skills/im-mcp löschen, /reload eingeben
Claude Desktop	Lokales AppData enthält Claude-Konfiguration	Bearbeiten Sie %APPDATA%\Claude\claude_desktop_config.json, Client-Anwendung vollständig neu starten	Eintrag aus mcpServers in der Konfigurationsdatei entfernen und Software neu starten, Skill-Verzeichnis bereinigen
Cursor	VS-Code-Abkömmling, Cursor-Konfiguration vorhanden	In Settings ➔ Features ➔ MCP Servers hinzufügen, wird sofort in der Oberfläche eingehängt	In der MCP-Server-Liste auf Delete / Remove des entsprechenden Eintrags klicken
Cline / Roo Code	VS-Code-Erweiterungsleiste	In der MCP-Registerkarte der Erweiterungs-Seitenleiste Konfiguration hinzufügen, auf "Enabled" umschalten, um zu aktivieren und zu autorisieren	In der MCP-Liste der Seitenleiste den Schalter ausschalten oder auf das Papierkorb-Symbol klicken, um zu entfernen
Cherry Studio	Desktop-Multi-Modell-Verwaltungstool	In Einstellungen ➔ MCP-Server den stdio-Befehl hinzufügen, speichern und sofort wirksam	In der MCP-Server-Liste auswählen und auf "Löschen" klicken, Einstellungen speichern
WorkBuddy	Existenz von ~/.workbuddy/-Verzeichnis oder verwandter Konfiguration	Bearbeiten Sie ~/.workbuddy/mcp.json, klicken Sie im Connectormanagement auf "Vertrauen/Aktivieren"	Konfigurationsblock aus mcp.json entfernen und Connector in der Oberfläche entfernen