• 骰主手册

For Ver 2.5.XCHAOS4.Oliva.1.2.X

世界是属于每一个人的。要创造一个充满逻辑并尊重每一个人的世界。 ——《Новый Элемент Расселения》A.D.1960 Москва

DIXE(OLIVADICE)

注:本文只针对基本使用功能,更多优化细节与复杂进阶功能请参考青果扩充手册(进阶)

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 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(带减号为收回信任)

信任级别
权限

1(原用户白名单)

为群分发使用许可,允许使用某些指令

2

黑名单豁免

3

响应退群指令,接受不良记录共享(warning)

4(原管理)

查看、分发和收回低于4的用户权限,原管理权限

5及以上

查看、分发和收回低于自身的用户权限,系统操作指令

监听好友申请(.admin ListenFriendRequest=1)

默认开启,仅好友验证方式为【需要验证信息】或【需要回答问题并由我确认】时有效,拦截消息并决定通过或拒绝。黑名单用户必定拒绝。同意好友邀请时将发送strAddFriend,特别地,通过受信任用户的好友时会发送strAddFriendWhiteQQ。当好友验证方式为【允许任何人】或【需要正确回答问题】时,通过开启ListenFriendAdd,也会向通过的好友发送strAddFriend,注意这种方式通过的好友可能仅为单向好友。

允许陌生好友邀请(.admin AllowStranger=1/2)

默认为1。决定是否接受陌生人的好友邀请:2-无条件接受;1-无用户记录不接受;0-无信任不接受。该项设定建议配合QQ自带的【允许陌生人邀请我加入群聊】选项。

单群设置(.group)

.group ([群号])+/-[词条] //修改单群设置,群内原地使用可省略群号

词条
作用
修改要求

许可使用

私用模式/审核模式可正常邀请入群/群内使用

信任1

未审核

审核模式下标记新加入无【许可使用】的群,拒绝指令

信任1

免清

清群时和搜查黑名单时略过该群

信任2

免黑

发生在该群的不良记录无效;不搜查黑名单

信任4

忽略

不接受任何该群的事件

信任4

停用指令

停止响应指令和'.'开头的回复(即.bot off)

信任或群管

禁用回复

停止响应自定义回复

信任或群管

拦截消息

拦截消息,阻止低优先级插件响应

信任或群管

禁用jrrp/禁用me/禁用ob

禁用对应指令

信任或群管

/禁用draw/禁用help

  • 原群白名单自动初始化为【许可使用】+【免清】

  • 重要的大群(跑团交流群、骰娘群)请加【免清】+【免黑】或【忽略】,以免意料之外的自动退群

  • .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是不可用的意思!

关键词
默认状态
说明

DisabledListenWarning

0

屏蔽Warning响应流程

BelieveOlivaDicelist

0

控制是否拉取OlivaDicelist

BelieveThirdDicelist

0

控制是否拉取第三方Dicelist

HelpMode

1

Help指令模式控制项

LocalJrrp

1

本地Jrrp控制项

LocalJrrpMin

1

本地Jrrp最小值控制项

LocalJrrpRange

100

本地Jrrp范围宽度控制项

JrrpDashesRange

25

本地Jrrp{dashes}关键词长度控制项

CnLocalMode

1

控制部分输入的简繁转换

CnOutputMode

0

控制所有输出的简繁转换

CnmodsMode

1

魔都模组功能控制项

ReplyMode

3

Reply模式控制项

PulseMode

0

心跳上报控制项

DisabledGlobal

0

全局静默,只响应dismiss和bot,私聊会说明

DisabledBlock

0

bot off时拦截消息,阻止低优先级插件响应

DisabledListenAt

1

停用指令时可以通过at指名响应指令

DisabledMe

0

拒绝响应.me

DisabledJrrp

0

拒绝响应.jrrp

DisabledDeck

1

拒绝响应.deck

DisabledDraw

0

拒绝响应.draw

DisabledSend

0

拒绝响应.send

Private

0

私用模式开启(私骰作成=1)

LeaveDiscuss

0

检测到讨论组发言时自动退出

ListenGroupRequest

1

响应群添加请求

ListenGroupAdd

1

响应入群反馈

ListenFriendRequest

1

响应好友添加请求

ListenFriendAdd

1

响应好友添加反馈(由插件通过则不重复)

0

配置为0时,仅允许白名单好友申请(私骰作成=0)

AllowStranger

0

配置为1时,允许非白名单好友申请(公骰作成=1)

0

配置为2时,允许同意没有使用记录的好友的申请

ListenGroupKick

1

响应群移出事件

ListenGroupBan

1

响应群禁言事件

ListenSpam

1

响应刷屏监测

LeaveBlackQQ

0

检测群权限相同的黑名单用户时自动退出(公骰作成=1)

BannedLeave

0

被禁言后自动退群(公骰作成=1)

BannedBanInviter

0

被禁言后拉黑邀请者(公骰作成=1)

KickedBanInviter

0

被踢后拉黑邀请者(公骰作成=1)

BelieveDiceList

0

信任来自骰娘列表成员的warning(公骰作成=1)

CloudVisible

1

允许通过骰娘网络公开骰娘的QQ和其他信息

CloudBlackShare

1

调节是否与云端互通不良记录

SystemAlarmCPU

90

系统CPU占用触发报警的百分比阈值(0则不检测)

SystemAlarmRAM

90

系统内存占用触发报警的百分比阈值(0则不检测)

SendIntervalIdle

500

闲时消息队列处理一条消息发送的间隔(ms)

SendIntervalBusy

100

忙时消息队列处理一条消息发送的间隔(ms)

指令禁用对信任4以上用户无效 如果使用了容易刷屏又没有独立开关的回复插件,建议开启DisabledBlock并令Dice拥有更高优先级 对.me特别处理的理由是其在跑团中几乎零作用,却可以制造骰娘自己说话的假象,引发风险。

通知类型表

事件
554输出
通知类型

启动初始化

发送recorder

0

自定义回执文本

发送recorder

0

接收响应的warning

发送recorder

0

非黑受邀入群

发送recorder

0

非黑好友申请

发送recorder

0

刷屏初次提醒

发送recorder

0

解除禁言提醒

发送admin

1

增减黑名单

发送recorder

1

接收warning处理反馈

发送admin

1

申请/入群检测到黑名单

发送admin

1

黑名单触发退群

发送admin

1

接收陌生warning

发送admin

1

自定义全局设置

发送recorder

1

信任等级变动

发送admin

1

遥控单群退群/群设置

1

撤销管理员

发送admin

2

批量修改群设置

2

接收send信息

发送admin

2

群聊清查

发送recorder

2

刷屏二次提醒

发送admin

3

原生不良记录

发送monitor

3

系统负载报警

3

切换公用/私用(only)

发送admin

4

定时开关

发送monitor

4

生成warning

发送monitor

5

文件位置表

文件路径
说明
读写时机

DiceData/conf/Console.xml

Master模式配置

修改时写入

DiceData/conf/NoticeList.txt

通知窗口列表

修改时写入

DiceData/conf/CustomMsg.json

自定义回执文本

修改时写入

DiceData/conf/CustomHelp.json

自定义帮助文本

修改时写入

DiceData/conf/CustomReply.json

自定义回复文本

修改时写入

DiceData/conf/BlackList.json

黑名单记录

修改时写入

DiceData/conf/CustomCensor.json

自定义敏感词库

更新时写入

DiceData/conf/censor/

外置敏感词库

load时读取,不写入

DiceData/user/UserList.txt

用户信任、时间记录

退出或save时写入

DiceData/user/UserConf.RDconf

用户配置

退出或save时写入

DiceData/user/ChatList.txt

群聊时间记录、邀请人

退出或save时写入

DiceData/user/ChatConf.RDconf

群聊配置

退出或save时写入

DiceData/user/PlayerCards.RDconf

角色卡记录

退出或save时写入

DiceData/user/session/

团内记录(先攻、ob)

修改时写入

DiceData/audit/

消息通知日志

更新时写入

DiceData/mod/

模块文件(目前限定帮助文档)

load时读取,不写入

DiceData/PublicDeck/

外置牌堆

load时读取,不写入

DiceData/CardTemp/

角色卡模板

load时读取,不写入

DiceData/update/

更新缓存

修改时写入

DiceData/cnmods/

魔都模组缓存

修改时写入

DiceData/plugin/

扩展指令脚本

load时读取,不写入

DiceData/plugin/lib/

扩展指令脚本依赖库

load时读取,不写入

Mod文件示例

Last updated

Was this helpful?