Persönliches WeChat via Wisdom
Nutzen Sie den selbst gehosteten Wisdom-Dienst des Benutzers, um dessen persönliches WeChat-Konto zu bedienen. Wisdom läuft auf einem Windows-Host mit angemeldetem WeChat Desktop und stellt eine HTTP-API bereit.
Anmeldeinformationen werden vom personalwechat-BYOC-Connector injiziert:
PERSONALWECHAT_BASE_URL— Wisdom-Server-Basis-URL, z. B.http://82.156.126.14:8000.PERSONALWECHAT_API_TOKEN— WisdomAPI_TOKEN. Geheimnis – niemals ausgeben, drucken oder protokollieren.
Der Helfer sendet den Token als Authorization: Bearer ...; er setzt den Token niemals in die URL. Für in die Warteschlange gestellte UI-Operationen wie Suchen und Senden reicht der Helfer die Aufgabe ein und wartet auf /api/tasks/{id}, bevor er das endgültige Ergebnis ausgibt.
Dies ist das echte persönliche WeChat-Konto des Benutzers. Lesevorgänge können direkt ausgeführt werden. Das Senden von Nachrichten oder Dateien muss zuerst im Trockenlauf (Dry-Run) erfolgen und dann nur ausgeführt werden, nachdem der Benutzer das exakte Ziel und den Inhalt explizit genehmigt hat.
CLI
Der Skill enthält einen rein auf der Standardbibliothek basierenden Helfer:
WX=$SKILL_DIR/scripts/personal_wechat.py
Verbindung zuerst überprüfen
Beginnen Sie immer mit dem Status, wenn der Benutzer bittet, WeChat zu nutzen:
python3 $WX status
Erwartetes gesundes Format:
{"auth":{"logged_in":true,"wechat_running":true,"page":"logged_in"}}
Wenn logged_in=false, sagen Sie dem Benutzer, er solle die Wisdom-Web-UI / RDP öffnen und den WeChat-QR-Code scannen. Wenn die API 401 zurückgibt, bitten Sie den Benutzer, den Personal WeChat-Connector mit dem aktuellen Wisdom-API-Token neu zu verbinden.
Lese-Workflows
Aktuelles Konto
python3 $WX account
Kontakte
python3 $WX contacts --limit 50
Aktuelle Unterhaltungen
Verwenden Sie zuerst den normalen Unterhaltungs-Endpunkt; er bevorzugt die WeChat-Datenbank, wenn sie bereit ist, und fällt auf die Wisdom-App-Datenbank zurück.
python3 $WX conversations --limit 20
Für entschlüsselte lokale WeChat-Verlaufssitzungen:
python3 $WX conversations --history --limit 20
Nachrichten in einer Unterhaltung
Listen Sie zuerst die Unterhaltungen auf und verwenden Sie dann die id als conversation_id:
python3 $WX messages "34642176898@chatroom" --limit 50 --order asc
Historische Nachrichten
Lesen Sie aus den entschlüsselten lokalen WeChat-Datenbanken von Wisdom:
python3 $WX history --limit 50
python3 $WX history --talker "34642176898@chatroom" --limit 50
python3 $WX history --limit 20 --offset 20
Rohes SQL, nur lesend
Wisdom erlaubt nur SELECT und PRAGMA:
python3 $WX sql MicroMsg.db 'SELECT count(*) AS cnt FROM Session'
Verwenden Sie rohes SQL nur für Diagnosezwecke oder gezielte Metadatenabfragen. Geben Sie keine großen Nachrichtentabellen aus, es sei denn, der Benutzer fordert dies ausdrücklich an.
Verlaufsdatenbank aktualisieren
Wenn der Verlauf veraltet erscheint, aktualisieren Sie die entschlüsselte DB-Momentaufnahme:
python3 $WX refresh-history
Suche
python3 $WX search "Alice"
Die Suche steuert die WeChat-UI, daher kann sie langsamer sein als lokale DB-Verlaufslesevorgänge.
Nachrichten senden – GESPERRT
send führt standardmäßig einen Trockenlauf durch. Es sendet niemals, es sei denn, --confirm ist vorhanden, oder ein geplanter AceDataCloud-Auftrag hat diesen Skill vorab autorisiert und Sie verwenden --unattended-confirm.
python3 $WX send "Alice" "Heute Abend um 8 Uhr Besprechung?"
# -> {"dry_run": true, ...}
Zeigen Sie dem Benutzer die Trockenlauf-Ausgabe und bitten Sie um explizite Genehmigung des genauen Empfängers und Textes. Führen Sie erst dann aus:
python3 $WX send "Alice" "Heute Abend um 8 Uhr Besprechung?" --confirm
Fügen Sie niemals --confirm im ersten Versuch hinzu. Leiten Sie niemals Zustimmung aus vagen Texten ab. Der Benutzer muss das Senden dieser genauen Nachricht klar genehmigen.
Unbeaufsichtigte Bestätigung bei geplanten Aufgaben
Wenn der Skill innerhalb einer geplanten AceDataCloud-Aufgabe ausgeführt wird, kann die Plattform bestimmte Skills für die unbeaufsichtigte Ausführung vorab autorisieren. Wenn alle folgenden Bedingungen zutreffen:
AICHAT_UNATTENDED_MODE=trueAICHAT_ACTIVE_SKILListpersonal-wechatoderacedatacloud/personal-wechatAICHAT_ACTIVE_SKILLerscheint inAICHAT_UNATTENDED_ALLOWED_SKILLS
dann hat der Benutzer diesen Skill für diese geplante Aufgabe vorab autorisiert. Verwenden Sie in diesem Fall:
python3 $WX send "Alice" "Heute Abend um 8 Uhr Besprechung?" --unattended-confirm
Wenn der Helfer unattended_confirmation_denied zurückgibt, wiederholen Sie den Vorgang nicht mit --confirm; melden Sie den Trockenlauf und erklären Sie, dass die Aufgabe diesen Skill in den Einstellungen für unbeaufsichtigte Autorisierung auswählen muss.
Sicherheitsregeln
- Geben Sie
PERSONALWECHAT_API_TOKENniemals aus. - Behandeln Sie
PERSONALWECHAT_BASE_URL + API_TOKENals vollständige Fernsteuerung des WeChat-Kontos des Benutzers. - Für normale Chat-Schreib-/Sendeoperationen: Führen Sie zuerst einen Trockenlauf durch, bitten Sie um explizite Genehmigung und führen Sie ihn dann mit
--confirmerneut aus. - Für unbeaufsichtigte Schreibvorgänge bei geplanten Aufgaben: Verwenden Sie
--unattended-confirmnur, wenn die Plattform-Umgebung anzeigt, dass dieser Skill vorab autorisiert ist. - Rufen Sie keine Logout-/Neustart-Endpunkte aus dem Skill auf, es sei denn, der Benutzer bittet explizit um die Reparatur des Wisdom-Dienstes.
- Wenn Wisdom 503 für den Verlauf zurückgibt, führen Sie einmal
python3 $WX refresh-historyaus und wiederholen Sie dann den Lesevorgang. - Wenn der Server nicht erreichbar ist, bitten Sie den Benutzer, den Windows-Host / die Sicherheitsgruppe / den Port 8000 zu überprüfen.
Endpunkt-Zuordnung
Der Helfer kapselt diese Wisdom-Endpunkte:
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(nur nach--confirmoder bestätigtem--unattended-confirm)