无界 | Bncr | Boundless Nodejs Chat Robot 机器人框架安装使用教程

背景：Bncr 是一个开箱即用的Nodejs Chat RoBot（会话式机器人）框架。它基于OOP函数响应式编程，具有占用小、响应快、开发易等特点，允许开发者创建高度可测试、可扩展、松散耦合且易于维护的应用程序。本项目架构深受Koishi与sillyGirl的启发；

项目地址：https://github.com/Anmours/Bncr
开发文档：https://anmours.github.io/Bncr
项目介绍：Nodejs环境的插件式机器人框架，它可以diy Adapter来对接任何平台来实现交互。

比较常用的插件/功能：

奶酪棒插件–对接青龙：获取|删除配置文件，环境变量删除|禁用|启用|查找|移动，任务运行|停止|启用|禁用|状态|置顶|取消置顶|添加|修改|删除|日志。
登录插件–对接ark，rabbit扫码，pro扫码、短信登录。
店铺抽豆监控。
店铺签到监控。
可迁移傻妞到Bncr。
Bncr SPY 监控变量。

安装无界

目前仅支持 docker安装

在你要存放数据的目录下手动新建BncrData文件夹(以root目录为例)

警告！群晖用户请勿在root下存放任何文件！修改成你的硬盘目录！

在root目录新建BncrData文件夹

mkdir /root/BncrData

拉取并运行容器并进入交互控制台

docker run -dit \

 -v /root/BncrData:/bncr/BncrData \

 -p 9090:9090 \

 --name bncr \

 --hostname bncr \

 --restart on-failure:5 \

 --log-opt max-size=5m \

 --log-opt max-file=3 \

anmour/bncr && docker attach bncr

更新命令

docker run --rm \

 -v /var/run/docker.sock:/var/run/docker.sock \

 containrrr/watchtower \

 -c --run-once \

bncr

查看日志

docker logs bncr

进入容器控制台

进入

docker attach bncr

退出attach

Ctrl+p Ctrl+q

进入容器命令行

docker exec -it bncr /bin/sh

初次启动会在你映射的宿主机路径下创建5个文件夹，分别为 Adapter config public db plugins
config 下会自动生成一些启动所需的配置文件，已进行详细注释，根据自己情况来填写；

Adapter下会自带 tgbot、HumanTG 、qqbot、wxKeAImao、wxQianxun以及系统适配器；

public 为静态资源目录，你可以在里边放一些文件，通过 http://ip:9090/public/文件名来访问这些资源

db 为系统数据库存放目录

plugins 插件目录，自带一些官方插件

基础命令

//设置qq管理员其他平台类似

set qq admin 12345698

//获取数据库

get 表 key

//例如获取管理员

get qq admin

// 设置数据库

set 表 key value

// 重启机器

重启

//获取时间

time

//启动时间

启动时间

//获取机器码

机器码

//获取版本

bncr版本

// 获取群id

群id

//获取个人id

我的id

//监听群消息（默认屏蔽所有群）

监听该群

//屏蔽群消息

屏蔽该群

//不回复该群

不回复该群

//回复

回复该群

配置Bncr

基本配置

Token获取
1.先私聊 https://t.me/red_Lights_Districts_Bot ,否者收不到消息，然后BncrJS里发 /get_token
复制token填入config
2.把要对接的平台开关enable改为true
3.重启

常见问题

为什么不回复消息，发消息没反应

当发送管理员命令没有反应时，请检查管理员是否正确
步骤:
对着机器人发 ‘我的id’ 机器人会回复你的id然后设置一下管理员(见下文)
注意! 管理员命令需要在有管理员权限的平台操作，不然无效
不知道哪个平台有管理员权限的，docker attach bncr 后在控制台发

//设置qq管理员 其他平台类似=

set qq admin 12345698

set wxKeAImao admin 12345698

set wxQianxun admin 12345698

set wxXyo admin 12345698

set tgBot admin 12345698

set HumanTG admin 12345698

当群友在群里发消息机器人没有任何回应时，说明你没对群监听

快捷操作
管理员在群聊中发送 ‘监听该群’ 即可响应群友消息
发送 ‘屏蔽该群’ 取消监听
发送 ‘不回复该群’ 监听消息但是不会回复任何消息
‘回复该群’ 恢复默认
手动设置上诉效果

// 监听tg频道，或者手动设置监听群

set groupWhitelist 平台名:id true

// 栗子，监听一个频道

set groupWhitelist HumanTG:-1001744932665 true

// 删除监听(屏蔽该频道)

del groupWhitelist HumanTG:-1001744932665

// 不回复手动

set noReplylist HumanTG:-1001744932665 true

// 回复手动

set noReplylist HumanTG:-1001744932665 false

或

del noReplylist HumanTG:-1001744932665

显示未设置@name丨@rule丨@admin 插件加载异常"

检查插件文件夹是否放入正确：
插件保存至bncr 的 BncrData/plugins/红灯区/下

Error: Cannot find module ‘./xxxxx’"

插件文件夹下没有mod文件，或缺少自定义模块，谁写的插件找谁要这些模块,一般对应的插件仓库都有的,是你没装好!
下载 https://github.com/RedLightsDistrict/Bncr_plugins 链接中的mod放入到红灯区下

Error: Cannot find module ‘xxxxx’"

统一为缺少npm模块,通过管理员对机器人发送 npm i xxxx 命令安装模块后重启即可解决

查询没有反应

安装依赖

docker exec -it bncr /bin/sh

    cd BncrData

    npm i got@11.8.5 crypto-js