描述
JianShanAgent (见山) 是一个专为 MediaWiki 网站开发的开源 QQ 机器人框架。它解决了社区群体中常见的挑战,例如游戏玩家社区或粉丝维基,用户经常询问角色属性、技能机制、事件奖励或从截图中获取信息。传统的基于关键字的机器人仅限于固定命令,而通用的大型语言模型往往会产生幻觉或提供不正确的版本特定数据。
阅读更多
JianShanAgent 通过将精确查询与强大的大型语言模型验证相结合,克服了这些限制。它提供了直接的结构化查询,使用诸如 `/查`(查询)和 `/筛选`(过滤)等命令,直接访问 MediaWiki API 或结构化网站数据。这些命令在 1-2 秒内返回格式化的卡片,绕过大型语言模型以确保数据准确性并防止虚构。
对于自然语言问题,机器人采用多步骤验证过程,将检索增强生成(RAG)与独立审查相结合。它首先分解问题并识别别名,然后在本地向量知识库和实时维基内容中搜索证据。在生成答案后,独立审查步骤过滤掉推测性信息或未经验证的链接,仅提供有根据的事实及其来源引用。
主要功能还包括反向图像搜索,使用向量模型对站内插图、皮肤和图标进行索引,允许用户通过上传图像来识别来源。每小时的 `kbsync` 过程自动通过检查最近的 MediaWiki 更改来执行知识库的增量更新。该框架配备了预编译的网络管理后端,消除了对 Node.js 安装的需求。此控制台允许用户查看每个问答的完整检索和验证链,直接调试对话,并热更新配置和插件开关。
目前,JianShanAgent 已在 Huiji Onmyoji Wiki 和 BWiki Onmyoji Story Encyclopedia 的生产实例中部署,已索引约 9,000 个文档、19,000 个知识片段和 3,000 张图像。该项目完全开源,遵循 MIT 许可证,其核心框架、网站插件和部署模板可在 GitHub 上获取。
- 类别AI聊天机器人搭建平台
- 定价模式开源
- 部署Python Native, Docker Compose
- 平台MediaWiki
JianShanAgent的核心功能
开源的 QQ 机器人框架,适用于 MediaWiki 网站
基于命令的精确结构化数据查询
多步骤 RAG 及独立答案验证
用于站内插图和资产的反向图像搜索
每小时增量知识库同步
内置的网络管理控制台,用于调试和配置
支持自定义网站插件和扩展
与 MediaWiki API 的直接集成,用于数据检索
本地向量知识库,实现高效搜索
自然语言查询的自动别名识别
部署选项:Python 原生或 Docker Compose
模板实例,快速设置机器人
所有代码遵循 MIT 许可证
支持多个 MediaWiki 平台(例如,Huiji、BWiki)
如何使用 JianShanAgent?
创建实例:使用 `template-instance` 为您的机器人创建一个新的代码库。
配置设置:在 `config/core.wiki.yaml` 中填写您的 MediaWiki API 地址,在 `config/secrets.yaml` 中填写大型语言模型/QQ 机器人密钥。
选择启动方法:使用 Python 原生运行(`uv sync && uv run jianshanagent`)或使用 Docker Compose(`docker compose up -d --build`)。
访问网络管理:在浏览器中打开 `http://127.0.0.1:8080`,获取登录令牌,并在“网络对话”部分测试问答。
构建知识库:在管理控制台中执行 `knowledge run / embed / load` 命令以进行完整的向量检索。
JianShanAgent的使用案例
- 社区问答自动化
- MediaWiki 数据检索
- 知识库验证
- 图像来源识别
- 维基内容同步
- 机器人管理与调试
- 自定义维基集成






