Cloudflare-WX-API ist ein Open-Source-Projekt, das auf GitHub gehostet wird und Entwicklern helfen soll, WeChat Service Number mit der Cloudflare-Plattform zu kombinieren, um CAPTCHA-Login, Code-Scanning-Login und intelligente Auto-Reply-Funktionen auf der Grundlage von Large Language Modelling (LLM) zu erreichen. Das von Tinger-X entwickelte Projekt ist für einzelne Entwickler oder kleine Teams geeignet, um schnell Automatisierungsfunktionen für WeChat Service Number zu erstellen. Das Projekt nutzt Cloudflare Workers, um eine effiziente serverseitige Unterstützung zu bieten, kombiniert mit der WeChat-API, um Benutzerauthentifizierung und Nachrichtenverarbeitung zu erreichen. Durch die Integration von LLM können Entwickler intelligente Nachrichtenantworten erstellen und die Benutzerinteraktion verbessern. Das gesamte Projekt zielt darauf ab, einfach und leicht zu bedienen zu sein, mit offenem Code und klarer Dokumentation, geeignet für Benutzer mit einer gewissen Programmiergrundlage.
Funktionsliste
- Zugang zur WeChat-Servicenummer: Unterstützung der schnellen Konfiguration der WeChat-Servicenummer, vollständiges Andocken der API.
- CAPTCHA-Anmeldung: Bieten Sie eine WeChat-basierte CAPTCHA-Anmeldefunktion an, um den Benutzerauthentifizierungsprozess zu vereinfachen.
- Scan-Code-Anmeldung: Unterstützung der Anmeldung von Benutzern über den WeChat-Scan-Code, geeignet für die schnelle Identitätsüberprüfung in einer Vielzahl von Szenarien.
- Intelligente Auto-Responder: Integration von Large Language Modelling (LLM) für kontextabhängige intelligente Nachrichtenantworten.
- Cloudflare Workers Support: Nutzt die serverlose Architektur von Cloudflare für eine effiziente und kostengünstige Bereitstellung.
- Offener Quellcode: Der vollständige Code und die Dokumentation werden Entwicklern zur Verfügung gestellt, damit sie die Funktionen anpassen können.
- Leichte Konfiguration: Die Ersteinrichtung kann mit einer einfachen Konfigurationsdatei erfolgen.
Hilfe verwenden
Installation und Konfiguration
Um Cloudflare-WX-API zu verwenden, müssen Sie zunächst die folgende Umgebung vorbereiten:
- GitHub-Konto: Zugang
https://github.com/Tinger-X/cloudflare-wx-api
Klicken Sie auf "Fork" oder "Clone", um das Projekt lokal herunterzuladen. - Cloudflare-KontoRegistrieren Sie sich für ein Cloudflare-Konto und aktivieren Sie die Funktion "Workers". Melden Sie sich in Ihrem Cloudflare-Dashboard an und gehen Sie auf die Seite "Workers", um ein neues Projekt zu erstellen.
- WeChat Entwickler-PlattformRegistrieren Sie sich für ein Konto auf der öffentlichen WeChat-Plattform, erstellen Sie eine Servicenummer und erhalten Sie eine AppID und ein AppSecret.
- Node.js-UmgebungNode.js: Stellen Sie sicher, dass Node.js (empfohlene Version 16 oder höher) zum Ausführen und Testen des Projekts lokal installiert ist.
Installationsschritte::
- Klonen von Projekten auf lokaler Ebene:
git clone https://github.com/Tinger-X/cloudflare-wx-api.git cd cloudflare-wx-api
- Installieren Sie die Abhängigkeit:
npm install
- Konfigurieren Sie die Umgebungsvariablen:
- Erstellen Sie im Stammverzeichnis des Projekts die Datei
.env
fügen Sie Folgendes hinzu:WECHAT_APP_ID=你的微信AppID WECHAT_APP_SECRET=你的微信AppSecret CLOUDFLARE_API_TOKEN=你的Cloudflare API令牌 LLM_API_KEY=你的LLM服务API密钥
- Erstellen Sie im Stammverzeichnis des Projekts die Datei
- Bereitstellen auf Cloudflare Workers:
- Melden Sie sich mit dem Wrangler CLI-Tool (Cloudflare's Kommandozeilen-Tool) an:
npx wrangler login
- Einführungsprojekte:
npx wrangler deploy
- Wenn die Bereitstellung abgeschlossen ist, gibt der Wrangler eine URL zurück (z. B.
https://your-project.workers.dev
) für die Konfiguration der Microsoft-Dienstnummer.
- Melden Sie sich mit dem Wrangler CLI-Tool (Cloudflare's Kommandozeilen-Tool) an:
Konfiguration der WeChat-Dienstnummer::
- Melden Sie sich bei WeChat Public Platform an und gehen Sie zu "Entwicklung - Grundkonfiguration".
- Füllen Sie unter "Serverkonfiguration" die folgenden Felder aus:
- Server-Adresse (URL)Füllen Sie die von Cloudflare Workers bereitgestellte URL aus.
- Token: Passen Sie die Einstellungen in der Projektkonfigurationsdatei an.
- Schlüssel zur Verschlüsselung und Entschlüsselung von NachrichtenGenerieren Sie einen Zufallsschlüssel und speichern Sie ihn.
- Übermitteln Sie die Konfiguration und überprüfen Sie, ob der Server erfolgreich mit der WeChat-Dienstnummer verbunden ist.
Funktion Betriebsablauf
CAPTCHA Anmeldung
- Der Nutzer löst eine Anmeldeanfrage auf dem Frontend aus, und das System sendet einen Verifizierungscode an das WeChat des Nutzers.
- Der Benutzer gibt einen Verifizierungscode ein und das Projekt wird genehmigt
/verify
Endpunkt-Prüfsummen-Verifizierungscode. - Nach erfolgreicher Authentifizierung werden die Benutzerauthentifizierungsinformationen (z. B. OpenID) für nachfolgende Vorgänge zurückgegeben.
- Funktionsbeispiel: Benutzer besuchen Ihre Webseite, klicken auf "WeChat Login", geben den erhaltenen Verifizierungscode ein und das System schließt die Identitätsprüfung automatisch ab.
Zum Einloggen wischen
- Das Projekt generiert einen dynamischen QR-Code, den die Nutzer mit WeChat scannen.
- Nach dem Scannen ruft der WeChat-Server die vom Projekt konfigurierte URL zurück, um die Benutzeridentitätsinformationen zu übermitteln.
- Das System verarbeitet die Rückrufe und schließt die Benutzeranmeldung ab.
- Beispiel: Der Nutzer scannt den QR-Code auf der Webseite, WeChat springt auf die Autorisierungsseite und meldet sich nach Bestätigung automatisch an.
Intelligenter Auto-Responder
- Der Nutzer sendet eine Nachricht an die WeChat-Servicenummer und löst damit die Verarbeitung durch Cloudflare Workers aus.
- Das Projekt ruft die LLM-API (z. B. OpenAI oder andere Modelle) auf, um kontextabhängige Antworten zu erzeugen.
- Die Antwort wird über die WeChat-API an den Nutzer zurückgesendet.
- Funktionsbeispiel: Der Benutzer sendet "Wie ist das Wetter morgen?" Die Servicenummer antwortet: "Bitte geben Sie den Namen der Stadt ein, ich werde das Wetter für Sie prüfen" oder gibt die Wetterinformationen direkt zurück.
Personalisierung
Entwickler kann ändern index.js
Datei, um benutzerdefinierte Logik hinzuzufügen. Fügen Sie zum Beispiel Nachrichtenfilterung, Schlüsselwortauslösung oder Mehrsprachenunterstützung hinzu. Das Projekt unterstützt modulare Erweiterungen, Entwickler können je nach Bedarf auf andere APIs zugreifen.
caveat
- SicherheitUm sicherzustellen, dass
.env
Der Schlüssel in der Datei wird nicht offengelegt und das Hochladen in öffentliche Repositories wird vermieden. - Komponenten während der Prüfung anpassen: Verwendung
npx wrangler dev
Testen Sie die Funktionalität von Workers lokal. - Hinweis auf die DokumentationAusführliche Dokumentation ist auf der GitHub-Seite des Projekts verfügbar unter
README.md
im Gesang antwortenDOCS
Mappe. - Update WartungRegelmäßige Überprüfung der Versionskompatibilität zwischen Cloudflare Workers und der WeChat-API.
Anwendungsszenario
- Einzelne Entwickler schnell bauen WeChat Service-Nummer
Einzelne Entwickler können Cloudflare-WX-API verwenden, um schnell zu implementieren WeChat Service-Nummer Login und Nachricht Antwort Funktionen, ohne komplexe Server-Konfiguration, geeignet für Rapid Prototyping. - Authentifizierung von Nutzern einer E-Commerce-Plattform
E-Commerce-Websites können den Prozess der Benutzerauthentifizierung vereinfachen, die Benutzerfreundlichkeit verbessern und die Registrierungsschwelle durch Scannen des Anmeldecodes oder des Verifizierungscodes senken. - Intelligentes Kundenservicesystem
Unternehmen können mit intelligenten Autorespondern ein 24/7-Kundenservice-System aufbauen, um häufig gestellte Fragen zu beantworten und den Aufwand für den manuellen Kundendienst zu verringern. - Plattformen für Bildung oder Interaktion mit der Gemeinschaft
Online-Bildungs- oder Community-Plattformen können über WeChat-Servicenummern mit den Nutzern interagieren, Kurserinnerungen oder Veranstaltungsbenachrichtigungen pushen und über LLM personalisierte Antworten geben.
QA
- Sie brauchen einen Server?
Nicht erforderlich. Das Projekt basiert auf Cloudflare Workers, was den Bedarf an herkömmlichen Servern eliminiert und die Bereitstellung einfach und kostengünstig macht. - Welche großen Sprachmodelle werden unterstützt?
Das Projekt unterstützt jeden LLM, der eine API zur Verfügung stellt, wie z.B. OpenAI, Anthropic, usw., die in der.env
Konfigurieren Sie den API-Schlüssel in der - Wie debuggt man Microsoft Callbacks?
ausnutzennpx wrangler dev
Starten Sie den lokalen Server und überprüfen Sie die Callback-Funktion in Verbindung mit der Testnummer der öffentlichen WeChat-Plattform. - Unterstützt es mehrsprachige Antworten?
Standardunterstützung für chinesische Antworten, Entwickler können den Code ändern, um auf die mehrsprachige LLM- oder Übersetzungs-API zuzugreifen.