Descripción
JianShanAgent (见山) es un marco de bot QQ de código abierto desarrollado específicamente para sitios de MediaWiki. Aborda el desafío común en grupos comunitarios, como comunidades de jugadores de juegos o wikis de fans, donde los usuarios frecuentemente hacen preguntas sobre estadísticas de personajes, mecánicas de habilidades, recompensas de eventos o buscan información de capturas de pantalla. Los bots tradicionales basados en palabras clave están limitados a comandos fijos, mientras que los modelos de lenguaje grande genéricos a menudo alucinan o proporcionan datos incorrectos específicos de versiones.
Leer más
JianShanAgent supera estas limitaciones integrando consultas precisas con verificación robusta de modelos de lenguaje grande. Ofrece búsquedas estructuradas directas utilizando comandos como `/查` (consulta) y `/筛选` (filtrar), que acceden directamente a las API de MediaWiki o a datos estructurados del sitio. Estos comandos devuelven tarjetas formateadas en 1-2 segundos, evitando el modelo de lenguaje grande para garantizar la precisión de los datos y prevenir la fabricación.
Para preguntas en lenguaje natural, el bot emplea un proceso de verificación de múltiples pasos, combinando Generación Aumentada por Recuperación (RAG) con revisión independiente. Primero descompone la pregunta e identifica alias, luego busca en bases de conocimiento vectoriales locales y contenido wiki en tiempo real en busca de evidencia. Después de generar una respuesta, un paso de revisión independiente filtra información especulativa o enlaces no verificados, proporcionando solo hechos fundamentados con citas de fuentes.
Las características clave también incluyen búsqueda de imágenes inversa, que utiliza un modelo vectorial para indexar ilustraciones, skins e íconos del sitio, permitiendo a los usuarios identificar fuentes al subir imágenes. Un proceso `kbsync` automático realiza actualizaciones incrementales a la base de conocimiento cada hora al verificar los cambios recientes de MediaWiki. El marco viene con un backend de administración web precompilado, eliminando la necesidad de instalación de Node.js. Esta consola permite a los usuarios ver la cadena completa de recuperación y verificación para cada pregunta y respuesta, depurar conversaciones directamente y actualizar configuraciones y cambios de plugins al instante.
Actualmente, JianShanAgent está desplegado en instancias de producción para Huiji Onmyoji Wiki y BWiki Onmyoji Story Encyclopedia, habiendo indexado aproximadamente 9,000 documentos, 19,000 fragmentos de conocimiento y 3,000 imágenes. El proyecto es completamente de código abierto bajo la Licencia MIT, con su marco central, plugins del sitio y plantillas de despliegue disponibles en GitHub.
- CategoríaCreadores de chatbots de IA
- Modelo de preciosCódigo abierto
- ImplementaciónPython Native, Docker Compose
- PlataformasMediaWiki
Características principales de JianShanAgent
Marco de bot QQ de código abierto para sitios de MediaWiki
Búsquedas de datos estructurados precisas basadas en comandos
RAG de múltiples pasos con verificación independiente de respuestas
Búsqueda de imágenes inversa para ilustraciones y activos del sitio
Sincronización incremental de la base de conocimiento cada hora
Consola de administración web integrada para depuración y configuración
Soporte para plugins y extensiones personalizadas del sitio
Integración directa con la API de MediaWiki para recuperación de datos
Base de conocimiento vectorial local para búsquedas eficientes
Reconocimiento automático de alias para consultas en lenguaje natural
Opciones de despliegue: nativo de Python o Docker Compose
Instancias de plantilla para configuración rápida del bot
Licencia MIT para todo el código del repositorio
Soporta múltiples plataformas de MediaWiki (por ejemplo, Huiji, BWiki)
¿Cómo usar JianShanAgent?
Crear Instancia: Usa el `template-instance` para crear un nuevo repositorio para tu bot.
Configurar Ajustes: Completa tu dirección de API de MediaWiki en `config/core.wiki.yaml` y las claves de modelo de lenguaje grande/bot QQ en `config/secrets.yaml`.
Elegir Método de Lanzamiento: Ejecuta de forma nativa con Python (`uv sync && uv run jianshanagent`) o usa Docker Compose (`docker compose up -d --build`).
Acceder a la Administración Web: Abre `http://127.0.0.1:8080` en tu navegador, recupera el token de inicio de sesión y prueba preguntas y respuestas en la sección 'Diálogo Web'.
Construir Base de Conocimiento: Ejecuta los comandos `knowledge run / embed / load` en la consola de administración para recuperación completa de vectores.
Casos de uso de JianShanAgent
- Automatización de Preguntas y Respuestas Comunitarias
- Recuperación de Datos de MediaWiki
- Verificación de Base de Conocimiento
- Identificación de Fuentes de Imágenes
- Sincronización de Contenido de Wiki
- Gestión y Depuración del Bot
- Integración de Wiki Personalizada






