ChatLearning————学群友说话使用手册

开始使用

mirai-api-http 配置 http adapter ， singleMode 为 false 为了保证稳定性，请尽量使用mirai-api-http v2.3.3版本
配置 data.json

{
 "Key": "xxxxx", // 在mirai-api-http中设置的密钥,若使用singleMode也不需要校验,设置为""即可
 "host": "127.0.0.1", // mirai-api-http中设置的地址（若设置成0.0.0.0，请填写127.0.0.1）
 "port": "8080", // mirai-api-http中设置的端口
 "qq": "xxx",  // 在mirai登陆的QQ号
 "session": "xxx" // 无需修改
}

Windows双击 ChatLearning.exe 直接运行
Linux在cd到目录后使用./ChatLearning运行
Win7或以下的32位系统(包括32位的Linux)则需下载Source包并确保Python版本≥3.6使用 pip install -r requirements.txt 安装依赖后运行 Chatmain.py

首次使用在控制台使用 setadmin <QQ号,多个请用空格隔开> 设置管理员； blackfreq <次数> 设置黑名单容错次数

指令

控制台下可执行指令，发送 help 获取指令表；管理员在聊天环境下私聊bot执行指令时，加上指令前缀 ！ 或 !

基本	描述
`help`	指令表
`check`	查看词库的问答个数和属性设置
`admin`	进入管理模式
`learning`	开启/关闭记录
`reply`	开启/关闭回复
`voicereply`	开启/关闭文字转语音回复
`setadmin <QQ>`	设置管理员QQ号，有多个用空格隔开

属性	描述
`globe`	开启/关闭总词库
`cosmatch`	开启/关闭问题余弦相似度计算
`cosmatch <匹配率>`	设定问题余弦相似度计算匹配率阈值
`blackfreq <次数>`	设置黑名单容错次数
`merge <单位/秒>`	间隔多长时间合成一次总词库
`learning <单位/秒>`	词库链间隔时间
`typefreq <消息类型> <次数>`	为消息类型设置回复阈值
`voicereply`	开启/关闭文字转语音回复
`reply <百分比>`	回复概率，若没有触发也不会触发文字转语音
`replywait <基准时间> <浮动时间>`	设置回复时的等待时间（基准时间±浮动时间）
`replycd <秒>`	设置回复的冷却时间
`voicereply <百分比>`	文字转语音概率，若没有触发将会继续发送文字

回复阈值：Bot获取到答案时，需要这个答案在词库中重复出现的次数大于或者等于这个阈值时，才会回复
黑名单容错次数：根据你设置的敏感词，达到次数自动将对象拉入黑名单后，不记录此人所有的发言。
全局模式：未启用全局模式时，每个群的词库独立且实时生效（分群词库），上一秒从群中收集到一个词，下一秒就可以在本群中回复这个词。开启全局模式后，bot将采用由所有分群词库定时合成的总词库回复
词库链间隔时间：发消息后多长时间会进入空窗期，比如设置10s，一个人发完一条消息10s内没人继续说话，就会将10s后的第一条消息作为问，再下一条就是答，可能没什么卵用，毕竟群里经常上话不接下话，不在一个频道。
问题余弦相似度计算：当词库中无该问题时，会启用相似度计算引擎，会将问题与词库中所有的问题进行相似度计算，选取匹配率最高的进行回答（该阈值可设定），较消耗计算机资源，斟酌开启

群部分	描述
`grouplist`	查看开启记录/回复的群列表
`add/remove learning <群号>`	添加/移除开启记录的群，有多个用空格隔开
`add/remove learnings <群号>`	同时添加/移除开启记录和回复的群，有多个用空格隔开
`add/remove reply <群号>`	添加/移除开启回复的群，有多个用空格隔开
`add/remove tag <标签> <群号>`	添加/移除群标签(移除时不需要带上标签参数)
`add/remove subadmin <群号>`	添加/移除可自行管理本群词库的群，有多个用空格隔开
`add/remove unmerge <群号>`	添加/移除不录入总词库的群，有多个用空格隔开

群标签：群往往带有一些属性，例如xxx游戏群，xxx交流群，这时候可以为群添加相应的标签，在记录词库时，会记录在相应标签的词库内，这样在回复时，只会在相应标签词库内寻找答案，一个群可以拥有多个标签，支持中文

文字转语音	描述
`setvoicept <训练集>`	选择音源合成时的训练模型
`uploadwav`	上传音源文件

快速删除	描述
`fastdelete`	更改快速删除功能的使用权限
`settemp` <条数>	设置单个群中消息缓存最大数目

`快速删除：在开启回复的群中，向Bot所发送的消息回复!d 、!delete 、！d 、！delete 即可在词库中删除该回复

定时任务	描述
`add/remove autotask <任务名称>`	添加/移除定时任务
`autotaskinfo`	查看定时任务详情
`autotaskcommand`	查看定时任务中的特殊指令

定时任务

ChatLearning在2.9.5版本中加入了定时任务功能，可以自定义地定时执行ChatLearning中的指令

注：若发现输入正确却无法解析内容，请检查txt文件编码是否为UTF-8

'''这是一个定时任务的模板，程序会自动解析带标记的行'''
'''请创建一个新的txt文件放置AutoTask文件夹下来自定义你的任务，文件名即是任务名'''

''开头使用"#"来标记任务的执行日期''
如"每日"：
#everyday
或是"周一 周日"：
#w1 w7
还可以是"每2天":
#x2
亦或是"具体日期"(不足十位请补0，如5→05)：
#2022-08-30

''开头使用"@"来标记执行结果发送的QQ号''
如：
@123456

''开头使用"*"来标记任务的执行时间''
如(请使用英文冒号哦，不足十位请补0，如5→05)：
*05:05

''开头使用"/"来标记任务所需执行的指令''
如(一个指令对应一行)：
/check
/autodelete

以下是示例（每天的12点和23点59分，按顺序执行check，grouplist指令，并将结果发送给123456）：
#everyday
@123456
*12:00 23:59
/check
/grouplist

-------------------
在自动任务中有一些特殊指令：
自动清理词库"autodelete"
发送群消息"sendgroupmessage <群号> <消息>"
发送群图片"sendgroupmessageimage <群号> <图片文件的绝对路径>"
发送好友消息"sendfriendmessage <好友QQ> <消息>"
发送好友图片"sendfriendmessageimage <好友QQ> <图片文件的绝对路径>"
在<消息>这个参数中，可以附带一些指定的标记，程序会将这些标记替换成相应的结果：
当前年：{year}
当前月：{month}
当前日：{day}
换行：{n}
如：
/sendgroupmessage 123456 今天是{year}年{month}月{day}日！{n}大家好啊！
-------------------

管理模式

词库管理：模糊 搜索/查看/删除 所有群/指定群 的词库
过滤：自定义无用关键词，也可以通过在删除答案时前加add来直接添加进过滤列表
黑名单：自定义敏感关键词，不记录且将对象拉入黑名单，用 blackfreq <次数> 自定义容错次数。
自动清理词库：删除词库中仅出现过单次的条目和被过滤的条目
添加定时任务：使用定时任务定义的语法添加定时任务
添加自定义回复：为词库添加回复，问答皆可除视频、文件任意形式的消息(只要QQ能发出来)，同时为答案定义权重(词库中每个答案都有一个权重，意为答案出现过的次数)