Beschreibung
JianShanAgent (见山) ist ein Open-Source QQ-Bot-Framework, das speziell für MediaWiki-Seiten entwickelt wurde. Es adressiert die häufige Herausforderung in Gemeinschaftsgruppen, wie z.B. in Spielercommunities oder Fan-Wikis, wo Benutzer häufig Fragen zu Charakterstatistiken, Fertigkeitsmechaniken, Belohnungen von Veranstaltungen oder Informationen aus Screenshots stellen. Traditionelle, auf Schlüsselwörtern basierende Bots sind auf feste Befehle beschränkt, während generische große Sprachmodelle oft Halluzinationen erzeugen oder falsche versionsspezifische Daten bereitstellen.
Weiterlesen
JianShanAgent überwindet diese Einschränkungen, indem es präzise Abfragen mit robuster Verifizierung durch große Sprachmodelle integriert. Es bietet direkte strukturierte Abfragen mit Befehlen wie `/查` (Abfrage) und `/筛选` (Filtern), die direkt auf MediaWiki-APIs oder strukturierte Site-Daten zugreifen. Diese Befehle geben formatierte Karten innerhalb von 1-2 Sekunden zurück und umgehen das große Sprachmodell, um die Datenintegrität zu gewährleisten und Fälschungen zu verhindern.
Für Fragen in natürlicher Sprache verwendet der Bot einen mehrstufigen Verifizierungsprozess, der Retrieval-Augmented Generation (RAG) mit unabhängiger Überprüfung kombiniert. Zuerst zerlegt er die Frage und identifiziert Aliase, dann durchsucht er lokale Vektor-Wissensdatenbanken und Echtzeit-Wiki-Inhalte nach Beweisen. Nach der Generierung einer Antwort filtert ein unabhängiger Überprüfungsschritt spekulative Informationen oder unbestätigte Links heraus und liefert nur fundierte Fakten mit Quellenangaben.
Zu den wichtigsten Funktionen gehört auch die Rückwärtssuche von Bildern, die ein Vektormodell verwendet, um Illustrationen, Skins und Icons auf der Seite zu indizieren, sodass Benutzer Quellen identifizieren können, indem sie Bilder hochladen. Ein stündlicher `kbsync`-Prozess führt automatisch inkrementelle Updates der Wissensdatenbank durch, indem er die aktuellen Änderungen in MediaWiki überprüft. Das Framework wird mit einem vorcompilierten Web-Administrations-Backend geliefert, das die Notwendigkeit einer Node.js-Installation beseitigt. Diese Konsole ermöglicht es Benutzern, die vollständige Abruf- und Verifizierungskette für jede Q&A zu sehen, Gespräche direkt zu debuggen und Konfigurationen sowie Plugin-Umschaltungen im laufenden Betrieb zu aktualisieren.
Derzeit ist JianShanAgent in Produktionsinstanzen für Huiji Onmyoji Wiki und BWiki Onmyoji Story Encyclopedia im Einsatz und hat etwa 9.000 Dokumente, 19.000 Wissensschnipsel und 3.000 Bilder indiziert. Das Projekt ist vollständig Open-Source unter der MIT-Lizenz, wobei das Kernframework, die Site-Plugins und die Bereitstellungsvorlagen auf GitHub verfügbar sind.
- KategorieKI-Chatbot-Baukästen
- PreismodellOpen Source
- BereitstellungPython Native, Docker Compose
- PlattformenMediaWiki
JianShanAgent's Kernfunktionen
Open-Source QQ-Bot-Framework für MediaWiki-Seiten
Präzise befehlsbasierte strukturierte Datenabfragen
Mehrstufiges RAG mit unabhängiger Antwortverifizierung
Rückwärtssuche von Bildern für Illustrationen und Assets auf der Seite
Stündliche inkrementelle Synchronisation der Wissensdatenbank
Integrierte Web-Administrationskonsole für Debugging und Konfiguration
Unterstützung für benutzerdefinierte Site-Plugins und Erweiterungen
Direkte Integration mit der MediaWiki-API für Datenabruf
Lokale Vektor-Wissensdatenbank für effizientes Suchen
Automatische Alias-Erkennung für Abfragen in natürlicher Sprache
Bereitstellungsoptionen: Python-nativ oder Docker Compose
Vorlageninstanzen für eine schnelle Bot-Einrichtung
MIT-Lizenz für gesamten Repository-Code
Unterstützt mehrere MediaWiki-Plattformen (z.B. Huiji, BWiki)
Wie verwendet man JianShanAgent?
Instanz erstellen: Verwenden Sie die `template-instance`, um ein neues Repository für Ihren Bot zu erstellen.
Einstellungen konfigurieren: Geben Sie Ihre MediaWiki-API-Adresse in `config/core.wiki.yaml` und die Schlüssel für das große Sprachmodell/QQ-Bot in `config/secrets.yaml` ein.
Startmethode wählen: Führen Sie nativ mit Python (`uv sync && uv run jianshanagent`) oder mit Docker Compose (`docker compose up -d --build`) aus.
Web-Admin aufrufen: Öffnen Sie `http://127.0.0.1:8080` in Ihrem Browser, holen Sie sich das Login-Token und testen Sie Q&A im Abschnitt 'Web-Dialog'.
Wissensdatenbank aufbauen: Führen Sie die Befehle `knowledge run / embed / load` in der Administrationskonsole für den vollständigen Vektorrückruf aus.
JianShanAgent's Anwendungsfälle
- Automatisierung von Community-Q&A
- Datenabruf von MediaWiki
- Verifizierung der Wissensdatenbank
- Identifizierung von Bildquellen
- Synchronisation von Wiki-Inhalten
- Bot-Management & Debugging
- Benutzerdefinierte Wiki-Integration






