Descrição
JianShanAgent (见山) é um framework de bot QQ de código aberto especificamente desenvolvido para sites MediaWiki. Ele aborda o desafio comum em grupos comunitários, como comunidades de jogadores de jogos ou wikis de fãs, onde os usuários frequentemente fazem perguntas sobre estatísticas de personagens, mecânicas de habilidades, recompensas de eventos ou buscam informações a partir de capturas de tela. Bots tradicionais baseados em palavras-chave são limitados a comandos fixos, enquanto modelos de linguagem grandes genéricos frequentemente alucinam ou fornecem dados específicos de versão incorretos.
Ler mais
JianShanAgent supera essas limitações integrando consultas precisas com verificação robusta de modelos de linguagem grandes. Ele oferece buscas estruturadas diretas usando comandos como `/查` (consulta) e `/筛选` (filtrar), que acessam diretamente as APIs do MediaWiki ou dados estruturados do site. Esses comandos retornam cartões formatados em 1-2 segundos, contornando o modelo de linguagem grande para garantir a precisão dos dados e evitar fabrications.
Para perguntas em linguagem natural, o bot emprega um processo de verificação em múltiplas etapas, combinando Geração Aumentada por Recuperação (RAG) com revisão independente. Ele primeiro decompõe a pergunta e identifica aliases, depois busca em bases de conhecimento vetoriais locais e conteúdo wiki em tempo real por evidências. Após gerar uma resposta, uma etapa de revisão independente filtra informações especulativas ou links não verificados, fornecendo apenas fatos fundamentados com citações de fontes.
Os recursos principais também incluem busca reversa de imagens, que utiliza um modelo vetorial para indexar ilustrações, skins e ícones do site, permitindo que os usuários identifiquem fontes ao enviar imagens. Um processo `kbsync` automático realiza atualizações incrementais na base de conhecimento a cada hora, verificando as mudanças recentes do MediaWiki. O framework vem com um backend de administração web pré-compilado, eliminando a necessidade de instalação do Node.js. Este console permite que os usuários visualizem toda a cadeia de recuperação e verificação para cada pergunta e resposta, depurem conversas diretamente e atualizem configurações e alternâncias de plugins em tempo real.
Atualmente, o JianShanAgent está implantado em instâncias de produção para o Huiji Onmyoji Wiki e a Enciclopédia da História Onmyoji BWiki, tendo indexado aproximadamente 9.000 documentos, 19.000 trechos de conhecimento e 3.000 imagens. O projeto é totalmente de código aberto sob a Licença MIT, com seu framework central, plugins do site e templates de implantação disponíveis no GitHub.
- CategoriaCriadores de chatbots de IA
- Modelo de preçosCódigo Aberto
- ImplantaçãoPython Native, Docker Compose
- PlataformasMediaWiki
Recursos principais de JianShanAgent
Framework de bot QQ de código aberto para sites MediaWiki
Buscas de dados estruturados baseadas em comandos precisos
RAG em múltiplas etapas com verificação independente de respostas
Busca reversa de imagens para ilustrações e ativos do site
Sincronização incremental da base de conhecimento a cada hora
Console de administração web embutido para depuração e configuração
Suporte para plugins e extensões personalizadas do site
Integração direta com a API do MediaWiki para recuperação de dados
Base de conhecimento vetorial local para busca eficiente
Reconhecimento automático de aliases para consultas em linguagem natural
Opções de implantação: nativo em Python ou Docker Compose
Instâncias de template para configuração rápida do bot
Licença MIT para todo o código do repositório
Suporta múltiplas plataformas MediaWiki (por exemplo, Huiji, BWiki)
Como usar JianShanAgent?
Criar Instância: Use o `template-instance` para criar um novo repositório para seu bot.
Configurar Configurações: Preencha seu endereço da API do MediaWiki em `config/core.wiki.yaml` e as chaves do modelo de linguagem grande/bot QQ em `config/secrets.yaml`.
Escolher Método de Lançamento: Execute nativamente com Python (`uv sync && uv run jianshanagent`) ou use Docker Compose (`docker compose up -d --build`).
Acessar Admin Web: Abra `http://127.0.0.1:8080` em seu navegador, recupere o token de login e teste perguntas e respostas na seção 'Diálogo Web'.
Construir Base de Conhecimento: Execute os comandos `knowledge run / embed / load` no console de administração para recuperação completa de vetores.
Casos de uso de JianShanAgent
- Automação de Perguntas e Respostas Comunitárias
- Recuperação de Dados do MediaWiki
- Verificação da Base de Conhecimento
- Identificação de Fontes de Imagens
- Sincronização de Conteúdo da Wiki
- Gerenciamento e Depuração do Bot
- Integração Personalizada com a Wiki






