mooxbot_instruction
@mooxbot魔核机器人使用说明
自动聊天操作步骤：
一、基础配置
1、上传协议号包
进入“基础配置”面板，上传包含.session .json文件的协议号包
2、执行“验证协议号”操作
机器人将验证协议号的可用性(被冻结、会话失效的协议号都会被排除)，并记录下可用的协议号信息。（执行完成后，点击“协议号信息”可查看验证的统计结果。（注：已经在活动中的协议号不会重新检测，如果需要检测这些已经在活动中的协议号，前行“执行面板”执行“下线协议号”后再检测！）
注：如遇执行任务过程中，帐号操作失败，可先 停止所有协议号 ，然后再次运行 验证协议号 操作。这将排除掉 失效/被冻结 的协议号。
协议号验证完成后，点击“协议号信息”即可查看当前可用的协议号概况。信息里出现的协议号“帐号名”是后续操作中需要用到的帐号唯一标识。（比如：填入一个监控帐号，就需要这里列出的“帐号名”）
3、执行“上传剧本”操作
将符合格式的剧本文件上传给机器人，机器人会解析生成可用的剧本。（点击“剧本信息”可看到当前已有的剧本文件信息。）如果只需要“克隆他群聊天”，此步骤可跳过）
说明：剧本对话中支持发送贴纸自定义表情，自定义表情使用“源码”方式发送。通过使用机器人的/echo 命令取得。如：/echo [贴纸表情] 机器人会返回相应代码给你。如下图所示：
二、任务配置
“任务配置”是用来指引机器人如何执行任务的配置信息，在创建配置后，可多次快速启动相同内容的任务
写在前面：在正式启动相关任务前，请一定检查目标 频道/群组 的相关权限设置，如：是否允许发送图片，是否允许发送消息，是否需要加入。如果权限设置不正确，协议号在不停尝试发送消息或者加入 频道/群组 的话，可能会导致帐号被标记为异常！
1、“创建 对话任务配置”
创建用于群内根据剧本自动聊天的配置信息。
1.1 根据机器人提示，填入任务名字，选择剧本，填写群邀请链接，选择好运行方式“定时循环”，“日常任务”等。
1.2 配置完成后，在“执行面板”内选择“启动剧本聊天，即可选择你创建好的配置按设定执行。
2、“创建 克隆任务配置”
创建克隆他群聊天的配置信息
2.1 根据提示完成配置，会需要你填入一个协议号（输入协议号session文件的名即可）作为“监听者”。剩余步骤请按照提示进行。对于替换规则，支持正则表达式:
举例:
a 一个规则 可以同时检测多个关键字:
(关键字1|关键字2...)
b.规则可以模糊匹配,比如匹配“关键字”开头的任何内容
关键字.*
2.2 然后在“执行面板”选择“启动克隆聊天”。
(克隆支持语音、贴纸、视频、图片消息的克隆，并且会自动突破被监听的群组设置的“禁止转发/复制”限制）
3、“创建 评论任务配置”
创建在“批量评论”操作时的一些配置信息。
按提示输入对应的信息即可，不再赘述。
（注：不同VIP等级可用的频道链接数限制不同，你可以输入多个链接，但在实际执行时会根据VIP等级限制，只执行对应等级的频道链接数量）
完成上述步骤，你已经可以基本使用本机器人完成你想要的功能。其他未提及的功能，自行探索。或待我日后补充进本文档。
3、执行面板
1、批量点赞：用于给指定帖子范围执行 “点赞” 操作
2、批量读帖：用于给指定帖子范围增加 “阅读” 计数
3、批量评论：用于在指定帖子配置中，在带有评论区的帖子内，发布评论。
4、批量改名：用于对帐号批量修改帐号昵称
5、批量换头像：用于批量更换帐号的头像
6、批量进群：用于批量加群（在某些需要入群的任务执行前，可以先执行此操作）
注：此功能可以用来增加群内的 在线人数！！！
7、启动 剧本聊天：启动 配置好的 剧本聊天任务
8、启动克隆聊天：启动配置好的克隆聊天 任务
9、重启协议号：该操作会启动协议号，此操作后，协议号将会处于持续在线状态，如果协议号空闲（无任务）时间太长（8小时）机器人会将协议号下线，因此如果需要头号，则需要定期重启。
10、下线协议号：用于将所有活动中的协议号下线，此操作后协议号不在处于连线状态。
其他：
“批量改名”
需要先在“基础配置”中上传名字文件(TXT文件，一行一个名字)
“批量换头像”
同样，需要先在“基础配置”中上传头像文件。
如果剧本中发言需要特殊格式，比如粗体，比如剧透等，请使用机器人的/echo命令解码出格式后填入剧本对话中。
清除协议号数据：
发送/clrsess指令，会清除协议号数据，执行完成后，在执行面板 重启协议号
常见问题：
1、在克隆聊天过程中，如果协议号所在的发言频道执行过 移除 协议帐号 的操作，协议号再次进入该群时会有阻碍，原因是：群管理默认的 移除用户 操作，会将帐号拉黑，需将帐号 从 群组的“权限管理”菜单 “移除的用户” 列表中拉出来
2、如需批量更换协议号，请注意先停止所有任务。不然会有残留帐号登录中。同时更新后，执行：验证协议号>重启协议号操作，以保证新的协议号可用。
VIP等级限制：
VIP 1:
最大活动帐号数量:10
最大同时运行任务数:3
最大剧本数量:3
最大配置文件数量:3
批量评论最大频道链接数量:10
VIP 2:
最大活动帐号数量:30
最大同时运行任务数:8
最大剧本数量:10
最大配置文件数量:10
批量评论最大频道链接数量:30
VIP 3:
最大活动帐号数量:100
最大同时运行任务数:15
最大剧本数量:20
最大配置文件数量:20
批量评论最大频道链接数量:100
关于克隆他群聊天
1他群内“机器人”发言会过滤不转发
2他群内出现有按钮的消息会过滤不转发。
3他群内贴纸如果是会员贴纸正常只会转发成普通 emoji，也可能会转发失败跳过。
4他群内如果出现“回复”，回复消息在最近200条发言内，会正常以“回复”的方式被克隆。
5他群内出现@xxx这样的内容会被去掉。
另：机器人会自动分配角色，如果协议号少于源群聊天人数，则会一个协议号分配多个角色。所以如果源群组活跃聊天人数较多，建议增加协议号以达到最佳模拟效果。
文档的最后是剧本文件格式的说明，请仔细阅读。有任何疑问请私信
注：下面剧本示例中#号开头的行，不是剧本必须的内容，#号开头的行表示这一行不被解析为剧本内容，在你编辑剧本时，并不需要必须有#号开头的行存在
剧本语法讲解:
1.设定某个角色发言，以"-"符号跟上空格开头 A,B,C等，是代称，机器人会自动会各代称分配帐号扮演，如下
- (A):这是A角色的一句发言内容
- (B):这是B角色说的话
2.回复某人发言，以"--"符号跟上空格作为开头 后面跟上要回复的角色“代称” 然后跟上发言角色的的代称。比如:角色A回复角色B最近的发言：
-- (B) (A):这是A回复B的发言内容
如果是回复当前剧本最近的一次发言,可以不指定角色，比如：
- (A):第一句
- (C):第二句
-- (H):这里表示 回复 C的这句发言
#*********************************************
# 示例剧本
# 剧本语法格式 (注意下面的冒号必须为英文冒号)：
# - <发言角色>:<发言内容..可以多行..> 支持发送贴纸,贴纸不能以回复方式发送。格式请使用机器人/echo命令解码，下文也有示例。
# -- {回复某人} <发言角色>:<发言内容..可以多行..> 不指定回复对象则回复上一个发言的人
#
# 举例如下：
# -861232:xxxxxx 指定协议号 861232 发言，这里的角色名是完全匹配
# -(A):xxxxxx 这里括号括起来的表示“助记名” 不强制指定发言人，由系统自动分配角色
# -- (B):ddddddddd 这里表示B回复上一个发言人
# -- (B) (C):eeeeeeee 这里表示 C 回复 B 的最近一次发言
# -- 86111:xxxxx (回复上一个发言者)
# -- 86112 86333:abcsfas (指定回复86112的发言)
#
#**********************************************
# 注：
# 1. “-”，“--” 后面可以有多个空格，但是":"必须紧跟发言角色
# 2.正文开始前，以 “#” 开头的行 或者空行，被视为注释
# 3.助记名不区分大小定，即：(A) 与 (a) 为同一个发言角色
#
# 正文第一行可以设置脚本类型，目前支持：
# comment：表示专门用于批量回复评论的话术脚本，注意批量评论脚本中：发言人，回复人无实际意义。
# random:表示每一句的“发言人” 随机分配
#
- (A):大家今天过得怎么样啊？
#下面是一个发送贴纸的示例
- (a):(❤️|CAACAgIAAxkBAAIFNGii5OU_JZVbep1CviZnQpJtm628AAJgBQACP5XMCkbIdgRkzFEVHgQ)
- (B):也就那样吧
-- (A):展开讲讲
-- (A) (C):
今天一单都没有做啊。
什么时候才可以开单啊。
-(A):行情不是很好啊。
-(D):你们都收工了吗？
-- (B):你现在才来啊。