ChatLearning：基于Mirai Console的词库插件最佳实践

1、项目介绍

ChatLearning 是一个基于 Mirai Console 的词库插件，能够自动从群组交流中收集对话内容，并将这些记录整理成一个问答词库。当有人发送的消息与词库中的"问"匹配时，会从"答"中随机抽取一个回复在群组中。此外，ChatLearning 还支持文字转语音回复、限制名单、定时任务等功能，使机器人更加智能和灵活。

2、项目快速启动

2.1 环境配置

1. 确保你的电脑上已经安装了 Python 3.6 或更高版本。
2. 克隆 ChatLearning 项目到本地：

   git clone https://github.com/JHue58/ChatLearning.git
   

3. 进入项目目录并安装依赖：

   cd ChatLearning
   pip install -r requirements.txt
   

2.2 启动配置

1. 编辑 config.clc 文件，填写以下信息：

   • Key：在 mirai-api-http 中设置的密钥（如果使用 singleMode，则无需校验，设置为 "" 即可）。
   • host：mirai-api-http 中设置的地址（如果设置成 0.0.0.0，请填写 127.0.0.1）。
   • port：mirai-api-http 中设置的端口。
   • qq：在 mirai 登陆的 QQ 号。
   • session：无需修改。

2. 运行 ChatLearning：

   • Windows：双击 ChatLearning.exe。
   • Linux：在终端中运行 ./ChatLearning。

3. 在控制台使用指令设置管理员和限制名单容错次数：

   setadmin <QQ号,多个请用空格隔开>
   blackfreq <次数>
   

4. 使用 help 指令查看更多指令和功能。

3、应用案例和最佳实践

3.1 基本设置

1. 添加需要机器人记录的群号。
2. 使用 add 指令添加群号，例如 add learning <群号>。
3. 使用 add 指令添加需要机器人回复的群号，例如 add reply <群号>。
4. 使用 setadmin 指令设置管理员权限。
5. 使用 learning 指令开启记录功能。
6. 使用 reply 指令开启回复功能。

3.2 高级功能

1. 使用 merge 指令设置合并词库的间隔时间。
2. 使用 cosmatch 指令开启/关闭问题余弦相似度计算，并设置匹配率阈值。
3. 使用 typefreq 指令为消息类型设置回复阈值。
4. 使用 voicereply 指令开启/关闭文字转语音回复。
5. 使用 replywait 指令设置回复等待时间。
6. 使用 replycd 指令设置回复冷却时间。

3.3 文字转语音

1. 使用 setvoicept 指令选择音源合成时的训练模型。
2. 使用 uploadwav 指令上传音源文件。

3.4 定时任务

1. 使用 add 指令添加定时任务，例如 add autotask <任务名称>。
2. 使用 autotaskinfo 指令查看定时任务详情。
3. 使用 autotaskcommand 指令查看定时任务中的特殊指令。

4、典型生态项目

ChatLearning 可以与其他开源项目进行集成，例如：

1. Mirai Console：作为 ChatLearning 的基础框架，提供 QQ 机器人操作接口。
2. ToVoice：ChatLearning 的文字转语音模块，可以将文字回复转换为语音。

通过以上步骤，你可以快速搭建并使用 ChatLearning 机器人，实现自动问答、文字转语音等功能。希望这份最佳实践能帮助你更好地了解和使用 ChatLearning。