• 骰主手册
For Ver 2.5.XCHAOS4.Oliva.1.2.X
世界是属于每一个人的。要创造一个充满逻辑并尊重每一个人的世界。 ——《Новый Элемент Расселения》A.D.1960 Москва
注:本文只针对基本使用功能,更多优化细节与复杂进阶功能请参考青果扩充手册(进阶)
Master模式
Master是骰娘的控制者,每个骰娘同时至多只能有一个Master。Master可以控制骰娘的发言和行为,并个性化大量配置。受信任用户也可以获得对骰娘的部分权限,但只有Master拥有发放和回收高级权限的权限。
Master功能初始默认关闭,需要在应用菜单中切换。
Master绑定/解绑
Master模式初次开启后为无主状态,此时对骰娘.master (private/public)
将绑定身份。
.master (private)
默认私骰作成,将自动开启私用模式
.master public
公骰作成,将骰娘初始化为公骰,自动调整相应的配置
.master delete
解除绑定,骰娘此时会重回无主状态,清空通知窗口,但先前设定的配置不会初始化。
.master reset [新masterQQ]
解除绑定,骰娘此时会认主[新masterQQ](原Master保留信任级别)
.master admin
添加管理时自动将私聊添加为监视窗口,管理可以用.admin delete
放弃权限,清除窗口可以私聊.admin notice - me
控制台指令
状态查看
.admin state
可以查看当前的全局设置和黑白名单情况
遥控开关
.admin boton/botoff [群号]
//等效于所在群群管使用.bot on/off.dismiss [群号]
//可以遥控骰娘退出所在的群,即使骰娘不在,也能将该群移出白名单
消息发送(.send)
send用于用户与管理员间的远程交流
.send 待发送消息
(任何人可用)向Master发送消息
.send [窗口] [待发送消息]
//向指定窗口发送消息(权限4限定; 权限5用户发送的消息不会标明转发来源,等效于骰娘亲自说话 )
窗口是指QQ收发消息的聊天窗口。窗口参数识别一下5种格式:
qq [QQ号]
group [群号]
discuss [讨论组号]
this(发送指令的窗口)
me(发送者的私聊窗口)
消息转发(.link)
link用于管理员与特定窗口保持交流(尤其是新加入、待审核的群),或者操纵骰娘跑团
.link to/from/with [窗口]
当前窗口向目标窗口单向转发/单向接收/双向转发消息
.link close
关闭从当前聊天窗口发起的消息转发
转发自Master的消息不会标明转发来源,等效于骰娘亲自说话
无法确认目标聊天窗口是否存在,可能会导致没有反应
转发状态没有被写入文件,因此重载应用后会清空
系统指令(.system)
.system save
//立即存储所有数据(相当于执行所有停用应用时的操作)
.system load
//立即读取外置文件(模块、牌堆和角色卡模板)。便于不重载应用的反复调试。save/load涉及的文件见附录。
.system state
//显示插件运行时间及内存占用等硬件信息
.system clrimg
//(不递归地)删除data_static\文件夹下所有(文件名长度达32的)图片,但保留被Dice!引用的图片(如welcome);有其他插件调用缓存图片且不另存于文件夹,不要使用此命令以免影响其他插件正常运作;每清除一万张图片大约需要半分钟至一分钟,避免在业务繁忙时使用此命令。权限5可用。
.system reload
//立即保存数据后令酷Q进程自杀并快速重启。第一次使用请保持远程连接监控,如重启后出现黄色提示框提醒上次未正常退出,请勾选【不再提醒】并确认,以免耽误重启。Linux容器内的酷Q存在无法勾选的情况,请慎用。权限5可用。
.system rexplorer
//杀死资源管理器后重启。当 Windows 服务器内存占用逐渐随时间而升高时,考虑由资源管理器逐渐占用内存导致,可能适用该指令。权限5可用。
查看更新(.cloud update)
远程获取Dice!正式版及开发版信息
.cloud update
//刷新更新源(在更新前这是必要的)
.cloud update [对应指令]
//更新对应版本(在上一条指令中将会列出)
一键清群(.master groupclr)
遍历群列表并退出符合条件的群,也可以在应用菜单中【一键清退】。群列表上限500,请避免群数超过500
.master groupclr
可以实现一键退群,无参数时默认参数为unpower
.master groupclr [天数]
将退出当前所有骰娘在指定天数内未发言的群
.master groupclr unpower
将退出当前所有骰娘不是群管/群主的群
.master groupclr preserve
将退出当前所有无许可使用的群
.master groupclr black
将退出当前所有黑名单群和有危险的黑名单用户的群
全局配置
配置项目表见附录
.admin [关键词]
//查看配置项状态,如.admin Private
.admin [关键词]=[数值]
//修改配置项。一般1表示开启,0表示关闭
通知窗口
运行过程中产生的提醒、警告等通知消息会分类型发送给设置的通知窗口。所有通知被分为0-5六种类型(具体通知类型见附录)。当产生通知时,会向通知窗口中所有接收该类型通知的窗口发送消息。如果没有窗口能发送消息,骰娘会将通知发送给自己;无论如何所有通知会自动保存在"DiceData\audit"中,请定期整理该文件夹。
.admin notice [窗口] +/-[通知类型](...+/-[通知类型])
//增减通知窗口类型
.admin notice - [窗口]
//直接移除指定窗口。
例:
.admin notice group 754494359 -0-1-2-3-4+5
变更通知类型的接收情况.admin notice - this
直接移除当前通知窗口
全局开关(.admin DisabledGlobal=0/1)
DisabledGlobal=1等价于.admin off(全局关闭)。开启时一切如常,关闭则进入静默状态,所有群聊/讨论组会相当于.bot off状态而无视群内设置,私聊会回复关闭中的信息。也可以用.admin on/off 操作全局开启/关闭,也可以在应用菜单中点击"全局开关"自动切换。
定时事件(.admin clock)
.admin clock +/- on/off/save/clear [时]:[分]
添加/移除 定时 全局开启/全局关闭/保存/清群
每日执行,如果当日错过不会补回。
定时开启和定时关闭时会向窗口4发送通知文本
清群为基于黑名单清群(=.master groupclr black)
用户策略
用户记录(.user)
用户在使用指令或被授予信任后会生成用户记录
.user state
//查看自己用户记录
.user trust [用户qq]
//查看用户信任级别(4以上限定,上级对下级屏蔽)
.user trust [用户qq] [信任级别]
//调整用户信任级别(4以上限定,只能调整下级用户)
用户授信(.user trust)
每名登记用户会标记信任级别,初始为0。级别越高享受的权限越多,上级包含下级的所有权限。
.admin whiteqq (-) [白名单QQ]
可以为用户授予信任1(带减号为收回信任)
监听好友申请(.admin ListenFriendRequest=1)
默认开启,仅好友验证方式为【需要验证信息】或【需要回答问题并由我确认】时有效,拦截消息并决定通过或拒绝。黑名单用户必定拒绝。同意好友邀请时将发送strAddFriend,特别地,通过受信任用户的好友时会发送strAddFriendWhiteQQ。当好友验证方式为【允许任何人】或【需要正确回答问题】时,通过开启ListenFriendAdd,也会向通过的好友发送strAddFriend,注意这种方式通过的好友可能仅为单向好友。
允许陌生好友邀请(.admin AllowStranger=1/2)
默认为1。决定是否接受陌生人的好友邀请:2-无条件接受;1-无用户记录不接受;0-无信任不接受。该项设定建议配合QQ自带的【允许陌生人邀请我加入群聊】选项。
单群设置(.group)
.group ([群号])+/-[词条]
//修改单群设置,群内原地使用可省略群号
原群白名单自动初始化为【许可使用】+【免清】
重要的大群(跑团交流群、骰娘群)请加【免清】+【免黑】或【忽略】,以免意料之外的自动退群
.admin whitegroup
查看当前【许可使用】或【免清】或【免黑】的群列表
授权许可(!authorize)
受信任用户可通过在群内发送!authorize或在任意窗口发送!authorize +[群号]来为目标群添加【许可使用】。非信任用户也可在群内使用!authorize [理由]向窗口2发送许可申请。
!authorize (+[群号])
//受信任用户为本群+许可使用
!authorize (+[群号]) [理由]
//非信任用户申请本群许可
监听群邀请(.admin ListenGroupRequest=1)
默认开启。接收用户的群邀请(小群邀请将由QQ系统自动通过,因此骰娘无法处理或知晓邀请人),拒绝来自黑名单的邀请,邀请来自受信任用户时通过且自动为群添加【许可使用】,非信任用户时私用模式而定。通过邀请的同时标记邀请人。
入群检测(.admin ListenGroupAdd=1)
默认开启。遍历群员,获取群主信息(临时创建的群可能无法获取群管理信息)、检索黑名单,为私用模式二次确认【许可使用】,为审核模式检查【许可使用】。发送strAddGroup。
私用模式(.admin Private=1)
认主时私骰作成进入私用模式,仅在受信任用户或【许可使用】群邀请时接受邀请,在新加入管理员无信任用户(否则为群自动添加【许可使用】)且无【许可使用】的群时自动退出,退出时自动留言。也可以用.admin only/public
切换私用/公用状态。
审核模式(.admin CheckGroupLicense=1/2)
入群后,对于无【许可使用】的群,将自动标记【未审核】并发送strAddGroupNoLicense。该项生效时将拒绝提供除help之外的其他服务,其余指令仅authorize/dismiss/bot有效。该项为1时拒绝所有【未审核】的群(不溯及审核模式开启前已加入的群),该项为1时拒绝所有无【许可使用】的群(含开启前已加入的群)。
审核模式与私用模式的差别:
审核模式会在未许可群停留,增加潜在风险
留在群内有更高向用户群引流的概率
由于自动入群的小群无法正常给群加【许可使用】,骰娘在无法识别群管理的情况下会自动退群,需要受信任用户额外使用一次!authorize [群号],重复邀请
入群检测(.admin ListenGroupAdd=1)
默认开启。入群时反馈群信息(群名、群号、群人数、邀请人);群内发现黑名单时会通知,有管理员是黑名单时会触发退群(群未设置【免清】或【免黑】时)。
自动退出讨论组(.admin LeaveDiscuss=1)
开启LeaveDiscuss后,只要讨论组有人发言,就会自动退出讨论组。但开启后始终无人发言的讨论组无法处理,只能手动处理。讨论组具有许多不适应酷Q的机制,如无法获取讨论组列表,无法获取邀请信息,无法获取成员列表,无法自动检测被踢。
黑名单(.admin blackqq/blackgroup)
任何情况下,来自黑名单的邀请不会被通过,指令除了dismiss都不会被响应
.admin blackgroup (-) ([黑名单理由]) [黑名单群号]
可以添加群黑名单(带减号是删除)
.admin blackqq (-) ([黑名单理由]) [黑名单QQ]
可以添加用户黑名单(带减号是删除),带理由时危险等级为2且通知对方,否则危险等级为1。
.admin blackfriend
//查看好友列表内的黑名单用户
危险的黑名单用户包括群内权限更高的用户或非免清群内相同权限用户(可选),同时危险等级需要达到2。危险等级只有1的黑名单用户不通知、不会触发退群。
现在自己、Master、信任2以上用户都不会新加入黑名单。
不良行为检测(.admin ListenGroupKick/ListenGroupBan/ListenGroupSpam=1)
默认开启。分别开启后,移出、禁言、刷屏会被加入黑名单。生成危险等级2的不良记录后,会自动向通知5窗口广播生成的!warning指令。warning指令:接收到信任3或记录可识别的骰娘warning时,骰娘将自动录入黑名单。骰娘通过这一机制实现不良记录的传递共享。 拉黑群时会自动移除【许可使用】。 刷屏在程序内定义为发送指令超过20/30s,实际解释权归Master所有
邀请人连带(.admin KickedBanInviter/BannedBanInviter=1)
默认开启。被移出、禁言时将入群邀请者同时加入黑名单。 邀请者责任源于协议中不得擅自拉群的规定,这里的擅自是双向的:一边无视骰娘协议,一边无视群内意愿 协议需骰主自行定制确认
个性化
自定义帮助词条(.helpdoc)
.helpdoc [词条名] [词条内容]
—— 自定义帮助词条
词条内容以&开头表示重定向,如.helpdoc 追仙子 &追仙后,.help追仙子 将重定向到追仙的词条
词条名不需要是源代码中已有的,请随意添加
外置帮助文档可放入DiceData/mod/读取。文件样例见附录。
自定义回复(.reply)
当存在触发词与收到的消息完全一致时,将随机选择一项回复发送。当群内开启【禁用回复】时,不会响应回复。触发回复也会算入刷屏计数!
.reply [触发词] [回复文本1](...[回复文本N])
//收到触发词后,从N项回复中随机取一项
.reply [触发词]
//清除触发词
自定义回执文本(.str)
将系统处理事件的回执替换为自定义文本
.[键值] [文本]
——自定义骰娘的某类回执
.[键值] NULL
——自定义文本为空白
.[键值] show
——查看自定义文本
双斜杠后为注释,请不要直接连带复制
强烈建议自定义strHlpMsg和strAddFriend、strAddGroup,向不熟悉的用户介绍私骰的特别之处(申请、使用须知)
例:
如果没有设置,strSelfName和strSelfCall将预设为QQ昵称,并且{self}会自动替换为strSelfCall
自定义敏感词库(.admin censor)
.admin censor
敏感词设置
.admin censor +([触发等级])=[敏感词0](|[敏感词1]...)
添加敏感词
.admin censor -[敏感词0](|[敏感词1]...)
移除敏感词
例:.admin censor +=nmsl
将“nmsl”设置为Warning级
.admin censor +Danger=nn老公|nn主人
将“nn老公”、“nn主人”设置为Danger级
.admin censor -手枪
移除敏感词“手枪”
匹配机制
骰娘会模糊匹配指令标识符(.)开头的消息,并返回所含敏感词的最高触发等级
匹配过程自动跳过文本中的特殊符号和空格,且大小写不敏感
受信任用户会相应降低触发等级,信任4以上用户将不触发检测
触发等级
使用指令设置Ignore等级可以临时屏蔽词库中不该生效的词,对外置词库这一等级是无意义的
*请避免为纯字母/数字的敏感词设置较高触发等级,这些字符存在误匹配图 片码的可能性 词库批量加载 load会读取存档目录中/conf/censor下所有文本文件 字符编码默认按GBK读取,若字符为UTF8,可在开头先起一行"#UTF8"一词一行 触发等级默认为Warning,读取到"#[触发等级]"时,后续录入的词调整为响 应等级,如"#Danger" 词库文件示例: 以下内容表示以utf-8编码,读取4个敏感词 "nmsl":Warning,"nn老 公":Danger,"nn主人":Danger,"sb":Notice
外置牌堆
将牌堆文件放入DiceData/PublicDeck内并重启或load,即可使用牌堆内的条目。牌堆名以'_'开头时,无法直接使用draw命令抽取。
附录
默认回执文本
可用的键值如下表
配置项目表
注:Disabled是不可用的意思!
指令禁用对信任4以上用户无效 如果使用了容易刷屏又没有独立开关的回复插件,建议开启DisabledBlock并令Dice拥有更高优先级 对.me特别处理的理由是其在跑团中几乎零作用,却可以制造骰娘自己说话的假象,引发风险。
通知类型表
文件位置表
Mod文件示例
Last updated