/
Master_Manual.md
1057 lines (731 loc) · 66.1 KB
/
Master_Manual.md
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
# Dice! Master手册
手册更新时间：20220607
*这是Dice!于2022.12.15更新2.6.6rc(638)后对应的[Master手册](https://v2docs.kokona.tech/zh/latest/Master_Manual.html)*。<br>
用户指令请参考[用户手册](https://v2docs.kokona.tech/zh/latest/User_Manual.html)。<br>
更多内容可参看[Dice!论坛](https://forum.kokona.tech/)。<br>
**本手册中[DiceData]一律指代Dice!存档目录，当前版本格式为[框架根目录]/Dice[DiceQQ]**
### 前言
**感谢您选择Dice!**<br>
此手册将帮助您了解Dice!的基本使用和配置<br>
如果在使用中遇到任何问题或者有任何建议，请在阅读文档后访问[Dice!论坛](https://forum.kokona.tech/)提出你的想法<br>
如果你认为此文档中有任何错误或值得改进的地方，欢迎点击右上方 Edit on GitHub 按钮修改文档。或者你也可以在论坛提出你的想法<br>
祝跑团顺利！
### 目录
- [更新说明](#更新说明2.6.4)
- [从2.5.0+版本升级](#从2.5.0+版本升级)
- [从低版本升级到2.5.0+](#从低版本升级到2.5.0+)
- [框架说明](#QQ框架Dice!2.5.0+)
- [管理面板](#WebUI配置面板（推荐）)
- [控制台指令](#控制台指令)
- [全局配置](#全局配置)
- [用户策略](#用户策略)
- [云操作](#云操作)
- [不良记录](#不良记录)
- [个性化](#个性化)
- [扩展指令](#扩展指令)
- [自定义回复](#自定义回复(.reply))
- [自定义回执文本](#自定义回执文本(.str))
- [支持作者](#支持作者)
- [常见问题](#常见问题)
- [登录失败](#登录失败)
- [账号屏蔽](#账号屏蔽)
- [网络连接失败](#网络连接失败)
- [附录](#附录)
- [更新历史](#更新历史)
- [后记](#后记)
### 更新说明(2.6.6)
- 新增: [变量赋值转义标识var](#文本转义标识)
- 新增: 转义[send定向发送](#消息发送(.send))的消息
- 新增: toml读写
- 新增: webui[远程获取模块资源](#远程模块资源)
- 新增: webui可进行mod调序
- 优化: [webui可定制化](#个性化WebUI)
- 修复: rc附带奖惩骰时无法调取属性
#### 2.6.5
- 重写认主机制
- 恢复cloud update远程更新
- reply与msg_order合并，新增限制项lock
- 优化[消息转义](#文本转义标识)，支持case、grade条件输出等，支持welcome有限转义
- 留档每日数据至/user/daily/
- 优化`mod on/off`热插拔，支持`mod get安装/info信息/detail详细信息/delete卸载/reload重载/update更新/reinstall重装`
- WebUI新增模块管理页
- mod新增image与audio子目录
- 支持TimeZoneLag项手动调整时差
- 新增各项lua交互特性，新增函数getSelfData,msg:format等
- json等数据结构采用fifo特性
#### 2.6.4
- WebUI优化回执跨行编辑，同步reply的触发词多对一
- 新增`.mod on/off/list`指令
- mod新增event子目录，支持循环`cycle`/定时`clock`/代理`hook`类型事件
- 更新log指令，允许自定义log名
- 更新ob指令
- 新增`.link state/list`
#### 2.6.3
- 新增DisableStrangerChat禁用非好友私聊
- lua允许向msg读写成员，支持`msg:echo`方法
- 扩展[mod](#扩展模块mod)目录结构，支持reply/script/speech子文件夹
- 优化[文本转义]()，支持花括号多层嵌套，支持{vary:uid?}对用户差分
- 优化[关键词回复](#自定义回复(.reply))的解析，支持一个回复对应多个关键词，指令设置时以 **|** 为分隔符
- http.post支持定义contentType
- 修复.sc使用给定理智值时，剩余理智存入角色卡的bug
- 修复[敏感词检测](#自定义敏感词库(.admin censor))时点（点号开头、指令、回复、被at时）
#### 2.6.2
- 可使用[.str reset](#自定义回执文本(.str))指令重置过时的文本而无需重启了
- reply新增[触发限制条件](#触发条件)，`reply set`时可加入Limit字段
- 优化.setcoc指令，可使用.setcoc show查看
- getUserConf支持获取用户名称
- getGroupConf支持获取群名片/群权限/最后发言
- WebUI页面为Master配置项添加说明
- 角色卡、用户配置、群配置支持读写table
- lua新增函数log，用于向框架或通知窗口输出日志
- 允许设置全局默认rc房规
- 允许lua修改5级以下信任
#### 2.6.1
- lua新增http.get/http.post等函数
- 对lua优化require路径，现在require可以读取Diceki/lua/文件夹下的lua或dll了
- [CustomMsg](#自定义回执文本(.str))不再兼容远古版本的序号转义（形如{0}{1}），请手动调整
- 新增.bot信息抬头strBotHeader，请自定义（默认发布版写作"标准型"，测试版写作"试作型"）
- [自定义回复](#)新增前缀匹配模式
- 新增.ak指令
- WebUI提供reply跨行编辑按钮
#### 2.6.0
- ww指令机制优化
- 支持[reply](#自定义回复(.reply))使用多种触发模式与回复模式
- 可使用[WebUI](#WebUI配置面板)进行远程图形化配置，原设置插件/综合管理重定向至WebUI
- .pc stat角色卡掷骰统计
### QQ框架(Dice!2.5.0+)
2.5.0版本，Dice!本体由酷Q插件改为了独立于框架的dll，由作为框架插件的DiceDriver加载，具体能实现的接口视框架条件而不同。先驱跑路后，Dice!驱动器目前支持Mirai、MyQQ、MyQQA、OnoQQAir、go-cqhttp框架，也在跟进OvQQ等更新。由于不同版本适配进度不同，你可能无法找到以下所有版本。*Miria加载DiceDriver须使用MiraiNative插件。*
#### QQ登录协议
同一QQ在同一类型设备（手Q/电脑/平板）登录时会将原先设备挤占下线，因此骰娘在框架登录所用设备应与人工登录所用设备错开。
#### 选择一个框架
MiraiAndroid是当前不使用模拟器在**手机挂载Dice**的唯一选择，MiraiDice也支持在Linux、MacOS等系统挂载Dice，详见[Dice! 论坛 Mirai版教程](https://forum.kokona.tech/d/448-mirai-dice-20210324)。
##### 框架接口差异
- Mirai2.*（MiraiNative转接）：
1. 支持手Q/平板登录
2. 不能多开QQ，启动即登录
3. 无法处理登录设备异常（但支持设备锁验证）
5. 不能响应来自自己的消息
6. 无法获取未加入群的群信息
7. **支持Windows, Linux, MacOS, Android**, iOS(停更中)
- [HiMyQQ](https://forum.kokona.tech/d/1820-himyqq)：
1. 由于程序不支持附加调试，存在未排除的异常风险
2. 固定PC设备登录，协议可以选PC版QQ或者PC版TIM等
3. 允许多开QQ，支持扫码登录
4. 无法私聊发送语音文件
- MyQQA（MQ安卓版）：
1. 由于程序不支持附加调试，存在未排除的异常风险
2. 支持手Q/平板登录
3. 允许多开QQ，但不支持启动自动登录
4. 选择手表协议登录时支持扫码登录
5. 接收好友申请时无法获取验证信息
6. 因为程序缺陷，会出现连接服务器失败、“与服务器北京时间相差超过1秒”等问题
7. 能接收频道消息，但发送频道消息疑似需要申请官方接口
- go-cqhttp：
2. 支持手Q/平板/手表登录
3. 不能多开QQ，但DiceDriver支持一键启动多个go-cqhttp.exe
4. 支持扫码登录
#### 框架目录结构
##### Mirai目录
非Windows系统可能目录稍微不一致，但文档中提到的应该适用于任何操作系统。Android版目录位置为内部存储空间/Android/data/io.github.mzdluo123.mirai.android/files/
#### 2.5.0+版本升级
- Mirai版本：执行Update.sh/更新.cmd
- MiraiAndroid: 安装新版APK
- 其他版本: 需要将更新版的w4123.Dice.dll放入Diceki文件夹替换旧文件，并重载DiceDriver插件；如果DiceDriver同时有新版则必须同步更新
- 请关注论坛以获得具体版本的更新方法
#### 从低版本升级到2.5.0+
##### 迁移骰娘存档到整合包
将对应版本的存档目录[DiceData]复制到新框架根目录下。
- 原Dice2.4.0及以上版本：根目录下的Dice[DiceQQ]文件夹
- 原Dice2.3.8exp9及以上版本酷Q骰娘：根目录下的DiceData文件夹
如为原Dice2.3.8exp10(555)及以下版本：将data/app/com.w4123.dice复制到新目录[DiceData]/com.w4123.dice的位置。
##### Mirai框架升级
1. 按照论坛中教程，使用新安装方法安装新版本Mirai
2. 迁移Dice[DiceQQ]目录
3. 将根目录下device.json复制到根目录下（让Mirai继续使用先前的登录信息）
### WebUI配置面板（推荐）
WebUI是**全平台**可用的图形化配置页面，通过Dice!初始化时运行的监听端口访问。
#### WebUI 基础使用
在登录成功以后，Dice!会向Master(没有Master的情况下，自己) 发送WebUI运行的端口。如图中运行在8080端口。默认情况下，WebUI运行在一个随机的未使用的端口，但你可以通过WebUIPort属性更改。
在本地(运行Dice的同一个设备)浏览器中输入`http://127.0.0.1:端口`进入WebUI **请一定要输入http://否则某些浏览器会卡死** <br>`.system gui`指令也会**引导打开WebUI**<br>如果你在远程访问WebUI，请确定已配置好防火墙等，并使用对应的IP地址或域名访问（而不是127.0.0.1）
提示登录时，默认用户名为admin，密码为password，进入WebUI后可在WebUI配置栏更改密码。WebUI默认只允许本地访问，所以如果设备只有你一个人能访问（不是共享的云服务器等）不更改密码也无所谓。
可以在上面执行管理操作，应该都符合直觉。需要注意的是你可以直接点击表格修改其中内容，表格中的修改无需点击保存等，会在编辑完成后自动生效。
#### WebUI 配置
WebUI有三个配置项，更改配置后重启才会生效<br>
`EnableWebUI` - 启用WebUI, 0为禁用, 1为启用, 默认为1<br>
`WebUIPort` - WebUI端口, 0为随机, 其他为固定端口<br>
`WebUIAllowInternetAccess` - 允许从非本地地址访问WebUI, 0为不允许, 1为允许, 默认为0, 也就是WebUI默认只能从本地访问。如果你使用Docker网络等，你可能需要将此项设置为1才能在Docker宿主机上访问WebUI。
#### WebUI 环境变量
可以通过环境变量设置WebUI配置。环境变量具有较高优先级。<br>
`DICE_WEBUI_PORT` 设置端口，0为随机端口<br>
`DICE_WEBUI_PORT_USE_VARIABLE` 使用另一个环境变量的值作为端口，比DICE_WEBUI_PORT有更高优先级，可用于PaaS等平台<br>
`DICE_WEBUI_ALLOW_INTERNET_ACCESS` 0为不允许, 1为允许
#### 配置远程访问
WebUI 使用 HTTP Digest验证，密码保存为Digest，理论上比较安全。然而，如果需要暴露到公网，我们仍然推荐使用nginx或apache等配置好TLS然后反向代理到Dice WebUI以确保安全。<br>
**当然，允许远程访问前请务必更改密码，不然再安全也没用。**
### GUI管理面板（已停更）
**任意Windows框架**可对骰娘发送`.system gui`打开图形界面（确认进入GUI，取消进入WebUI）。请注意此页面**仍可使用**，但将不会继续更新并有可能在未来版本移除，推荐使用上方提到的WebUI进行设置修改。
(MiraiNative)右键**托盘图标（流泪猫猫头）->（插件菜单）Dice!->综合管理**
(OQ等)**切换至插件列表页->Dice.Driver(右键)->设置插件。单框架多开时请使用指令，避免错乱**
可在界面内设置Master、调整用户信任、修改CustomMsg文本、修改全局配置
### 骰主(Master)
Master是骰娘的控制者，每个骰娘同时至多只能有一个Master。Master可以控制骰娘的发言和行为，并进行大量**个性化配置**，也**对骰娘行为负责**。受信任用户也可以获得对骰娘的部分权限，但只有Master拥有发放和回收高级权限的权限。
新生骰娘默认为无主状态，你可以在WebUI/GUI管理面板完成认主（推荐，WebUI支持全平台）或在聊天栏输入口令认主。无主骰娘在启动时将**向自身账号及框架日志窗口输出认主口令**，在聊天栏中对骰娘发送对应口令将绑定发送者账号为Master。也可直接在管理面板设置Master。认主时将自动开启全类型通知窗口，**建议将部分通知特别是通知窗口0转移到专门的小群**。<br>
`.master delete` 解除绑定，骰娘此时会重回无主状态，清空通知窗口，但先前设定的配置不会初始化。<br>
`.master reset [新masterQQ]` 解除绑定，骰娘此时会认主[新masterQQ]（原Master保留信任级别）<br>
`.master admin`添加管理时自动将私聊添加为监视窗口，管理可以用`.admin delete`放弃权限，清除窗口可以私聊`.admin notice - me`
### 控制台指令
#### 状态查看
`.admin state` 可以查看当前的全局设置和黑白名单情况
#### 遥控开关
- `.admin boton/botoff [群号]` //等效于所在群群管使用.bot on/off <br>
- `.dismiss [群号]` //可以遥控骰娘退出所在的群，即使骰娘不在，也能将该群移出白名单
#### 消息发送(.send)
send用于用户与管理员间的远程交流<br>
`.send 待发送消息` （任何人可用）向Master发送消息<br>
`.send [窗口] [待发送消息]` //向指定窗口发送消息（权限4限定；**权限5用户发送的消息不会标明转发来源，等效于骰娘亲自说话**)
**窗口**是指QQ收发消息的聊天窗口。窗口参数识别一下6种格式:
- qq [QQ号]
- group [群号]
- discuss [讨论组号]
- notice [通知类型]（仅send可用）
- this（发送指令的窗口）
- me（发送者的私聊窗口）
#### 消息转发(.link)
link用于管理员与特定窗口保持交流（尤其是新加入、待审核的群），或者操纵骰娘跑团 <br>
`.link to/from/with [窗口]` 当前窗口向目标窗口单向转发/单向接收/双向转发消息 <br>
`.link close` 关闭从当前聊天窗口发起的消息转发 <br>
`.link start` 开启上次建立的链接 <br>
**对象窗口为群/讨论组时，可省略group/discuss，直接输入群号；对象为私聊时，qq可简写为q** <br>
**转发自Master的消息不会标明转发来源，等效于骰娘亲自说话** <br>
**无法确认目标聊天窗口是否存在，可能会导致没有反应**
#### 系统指令(.system)
`.system save` //立即存储所有数据（相当于执行所有停用应用时的操作） <br>
`.system load` //立即读取外置文件（模块、牌堆和角色卡模板）。便于不重载应用的反复调试。save/load涉及的文件见附录。 <br>
`.system state` //显示插件运行时间及内存占用等硬件信息<br>
`.system rexplorer` //杀死资源管理器后重启。当 Windows 服务器内存占用逐渐随时间而升高时，考虑由资源管理器逐渐占用内存导致，可能适用该指令。**权限5可用**。
#### 一键清群(.master groupclr)
遍历群列表并退出符合条件的群，**也可以在应用菜单中【一键清退】**。部分框架群列表上限500，**请避免群数超过500**。单次清群上限受`GroupClearLimit`调节（默认一次至多退20个群）。 <br>
`.master groupclr` 可以实现一键退群，无参数时默认参数为unpower <br>
`.master groupclr [天数]` 将退出当前所有**骰娘在指定天数内未发言**的群 <br>
`.master groupclr unpower` 将退出当前所有**骰娘不是群管/群主**的群 <br>
`.master groupclr preserve` 将退出当前所有**无`许可使用`**的群 <br>
`.master groupclr black` 将退出当前所有**黑名单群**和**有危险的黑名单用户**的群
### 全局配置
配置项目表见[附录](#配置项目表) <br>
`.admin [关键词]` //查看配置项状态，如.admin Private <br>
`.admin [关键词]=[数值]` //修改配置项。一般的开关项1表示开启，0表示关闭
#### 通知窗口
运行过程中产生的提醒、警告等通知消息会分类型发送给设置的通知窗口。所有通知被分为0-9共十个等级，其中0-5会被骰娘用于内置广播，6-9用于自定义（具体通知类型见[附录](#通知类型表)）。当产生通知时，会向通知窗口中所有接收该类型通知的窗口发送消息。如果没有窗口能发送消息，骰娘会将通知发送给自己；无论如何所有通知会自动保存在"[DiceData]\audit"中，请定期整理该文件夹。 由于通知窗口0会产生较多日志型消息，**建议将通知窗口0转移到专门的小群**。 <br>
`.admin notice [窗口] +/-[通知类型](...+/-[通知类型])` //增减通知窗口类型 <br>
`.admin notice - [窗口]` //直接移除指定窗口。 <br>
`.send notice [通知类型] [通知文本]` //向指定类型窗口广播通知
例: <br>
`.admin notice group 928626681 -0-1-2-3-4+5` 变更通知类型的接收情况 <br>
`.admin notice - this` 直接移除当前通知窗口
#### 全局开关(.admin DisabledGlobal=0/1)
DisabledGlobal=1等价于.admin off（全局关闭）。开启时一切如常，关闭则进入静默状态，所有群聊/讨论组会相当于.bot off状态而无视群内设置，私聊会回复关闭中的信息。也可以用.admin on/off 操作全局开启/关闭，也可以在应用菜单中点击"全局开关"自动切换。
#### 定时点事件(.admin clock)
`.admin clock +/- [任务名] [时]:[分]` 添加/移除 定时任务 <br>
内置定时任务:on-全局开启;off-全局关闭;clear-黑名单清群 <br>
允许调用自定义任务，参考plugin手册 <br>
每日执行，如果当日错过不会补回。 <br>
定时开启和定时关闭时会向窗口4发送通知文本 <br>
清群为基于黑名单清群(=.master groupclr black)
#### 定时长事件
以下事件会在Dice!每运行固定时间后执行一次 <br>
`.admin AutoSaveInterval=5` //定时保存用户数据(min)，默认每5分钟保存一次 <br>
`.admin AutoRemake=0` //定时重启(h)，默认关闭。 <br>
**定时系统监测报警**(.admin SystemAlarmRAM/SystemAlarmCPU/SystemAlarmDisk=90) ：每半小时监测一次系统内存、CPU、硬盘占用(%)，超过阈值即报警。报警状态下每5分钟监测一次，如果数值升高超过1个百分点则继续报警，低于阈值则会提醒解除报警。设置在1-99时生效。
### 用户策略
#### 用户记录(.user)
用户在使用指令或被授予信任后会生成用户记录 <br>
`.user state` //查看自己用户记录 <br>
`.user trust [用户qq]` //查看用户信任级别（4以上限定，上级对下级屏蔽） <br>
`.user trust [用户qq] [信任级别]` //调整用户信任级别（4以上限定，只能调整下级用户，最高为255） <br>
`.user diss [用户qq]` //最轻的拉黑用户(type=local,danger=1)
##### 用户授信(.user trust)
每名登记用户会标记信任级别，初始为0。级别越高享受的权限越多，上级包含下级的所有权限。
`.admin whiteqq (-) [白名单QQ]` 可以为用户授予信任1(带减号为收回信任)
<table><thead><tr><th>信任级别</th><th>权限</th></tr></thead><tbody>
<tr><td>1</td><td>（白名单）为群分发使用许可，允许使用某些指令</td></tr>
<tr><td>2</td><td>黑名单豁免</td></tr>
<tr><td>3</td><td>响应退群指令，接受不良记录共享(warning)</td></tr>
<tr><td>4</td><td>（后台管理）查看、分发和收回低于4的用户权限，原管理权限</td></tr>
<tr><td>5</td><td>（骰主级）查看、分发和收回低于自身的用户权限，系统操作指令</td></tr>
</tbody></table>
#### 过期数据自动清理(.admin InactiveUserLine/InactiveGroupLine=360)
最后活跃天数超过InactiveUserLine的用户，其记录及角色卡会在清理用户时被清除；最后活跃天数超过InactiveGroupLine的群，其记录及开团信息会在清群时被清除。（配置项为0时不生效）
清理过期数据会在定时任务`clear`中自动执行，在执行清群时也会在退群的同时检测目标群是否会被清理。
#### 监听好友申请(.admin ListenFriendRequest=1)
默认开启，仅好友验证方式为【需要验证信息】或【需要回答问题并由我确认】时有效，拦截消息并决定通过或拒绝。黑名单用户必定拒绝。同意好友邀请时将发送strAddFriend，特别地，通过受信任用户的好友时会发送strAddFriendWhiteQQ。当好友验证方式为【允许任何人】或【需要正确回答问题】时，通过开启**ListenFriendAdd**，也会向通过的好友发送strAddFriend，注意这种方式通过的好友可能仅为单向好友。
#### 允许陌生好友邀请(.admin AllowStranger=0/1/2)
默认为1。决定是否接受陌生人的好友邀请：2-无条件接受;1-无用户记录不接受;0-无信任不接受。该项设定建议配合QQ自带的【允许陌生人邀请我加入群聊】选项。
#### 单群设置(.group)
`.group ([群号])+/-[词条]` //修改单群设置，群内原地使用可省略群号
<table><thead><tr><th>词条</th><th>效果</th><th>修改条件</th></tr></thead><tbody>
<tr><td>许可使用</td><td>私用模式/审核模式可正常邀请入群/群内使用</td><td>信任1</td></tr>
<tr><td>未审核</td><td>审核模式下标记新加入无【许可使用】的群，拒绝指令</td><td>信任1</td></tr>
<tr><td>免清</td><td>清群时和搜查黑名单时略过该群</td><td>信任2</td></tr>
<tr><td>免黑</td><td>发生在该群的不良记录无效；不搜查黑名单</td><td>信任4</td></tr>
<tr><td>忽略</td><td>不接受任何该群的事件</td><td>信任4</td></tr>
<tr><td>协议无效</td><td>不接受除云黑外的事件</td><td>信任4</td></tr>
<tr><td>停用指令</td><td>停止响应指令（.bot off）</td><td>信任或群管</td></tr>
<tr><td>禁用回复</td><td>停止响应回复（.reply off）</td><td>信任或群管</td></tr>
<tr><td>拦截消息</td><td>拦截消息，阻止低优先级插件响应</td><td>信任或群管</td></tr>
<tr><td>禁用jrrp/禁用me/禁用ob/禁用draw/禁用help</td><td>禁用对应指令</td><td>信任或群管 |
</tbody></table>
- *原群白名单自动初始化为【许可使用】+【免清】*
- *重要的大群（跑团交流群、骰娘群）请加【免清】+【免黑】或【忽略】，以免意料之外的自动退群*
- `.admin whitegroup` 查看当前【许可使用】或【免清】或【免黑】的群列表
##### 授权许可(!authorize)
受信任用户可通过在群内发送!authorize或在任意窗口发送!authorize +[群号]来为目标群添加【许可使用】。非信任用户也可在群内使用!authorize [理由]向窗口2发送许可申请。<br>
`!authorize (+[群号])` //受信任用户为本群+许可使用 <br>
`!authorize (+[群号]) [理由]` //非信任用户申请本群许可 <br>
撤销许可使用需要使用`.group [群号] -许可使用`
#### 批量群处理(.groups)
取群列表.groups list(管理限定)<br>
.groups list idle //按闲置天数降序列出群<br>
.groups list size //按群规模降序列出群<br>
.groups list [群管词条] //列出带有词条的群
#### 监听群邀请(.admin ListenGroupRequest=1)
默认开启。接收用户的群邀请（**小群邀请**将由QQ系统自动通过，因此骰娘无法处理或知晓邀请人），拒绝来自黑名单的邀请，邀请来自受信任用户时通过且自动为群添加【许可使用】，非信任用户时视私用模式开关状态处理。通过邀请的同时标记邀请人。**如果回执为【已同意】却实际并未入群，考虑接口出错或腾讯屏蔽。**
#### 入群检测(.admin ListenGroupAdd=1)
默认开启。入群时反馈群信息（群名、群号、群人数、邀请人），遍历群员，获取群主信息（临时创建的群可能无法获取群管理信息）、检索黑名单，为私用模式二次确认【许可使用】，为审核模式检查【许可使用】；群内发现黑名单时会通知，有管理员是黑名单时会触发退群（群未设置【免清】或【免黑】时）。发送strAddGroup。
#### 私用模式(.admin Private=1)
认主时私骰作成进入私用模式，仅在**受信任**用户或【许可使用】群邀请时接受邀请，在**新加入管理员无信任用户**（否则为群自动添加【许可使用】）且**无【许可使用】的群**时自动退出，退出时自动留言。也可以用`.admin only/public` 切换私用/公用状态。
#### 审核模式(.admin CheckGroupLicense=0/1/2)
入群后，对于无【许可使用】的群，将自动标记【未审核】并发送strAddGroupNoLicense。该项生效时将拒绝提供除help之外的其他服务，其余指令仅authorize/dismiss/bot有效。该项为1时拒绝所有【未审核】的群（不溯及审核模式开启前已加入的群），该项为2时拒绝所有无【许可使用】的群（含开启前已加入的群）。
**审核模式与私用模式的差别**：
- 审核模式会在未许可群停留，增加潜在风险；
- 留在群内有更高向用户群引流的概率；
- 由于自动入群的小群无法正常给群加【许可使用】，骰娘在无法识别群管理的情况下会自动退群，需要受信任用户额外使用一次!authorize [群号]，重复邀请；
#### 黑名单(.admin blackqq/blackgroup)
任何情况下，来自黑名单的邀请不会被通过，指令除了dismiss都不会被响应<br>
`.admin blackgroup (-) ([黑名单理由]) [黑名单群号]` 可以添加群黑名单(带减号是删除)<br>
`.admin blackqq (-) ([黑名单理由]) [黑名单QQ]` 可以添加用户黑名单(带减号是删除)，带理由时危险等级为2且通知对方，否则危险等级为1。<br>
`.admin blackfriend` //查看好友列表内的黑名单用户<br>
**危险**的黑名单用户包括**群内权限更高**的用户或**非免清群内相同权限用户（可选）**，同时危险等级需要达到2。危险等级只有1的黑名单用户不通知、不会触发退群。<br>
*现在自己、Master、信任2以上用户都不会新加入黑名单。*
#### 不良行为检测(.admin ListenGroupKick/ListenGroupBan/ListenSpam=1)
默认开启。分别开启后，移出、禁言、刷屏会被加入黑名单。生成危险等级2的不良记录后，会自动向通知5窗口广播生成的!warning指令。**warning指令**：接收到信任3或记录可识别的骰娘warning时，骰娘将自动录入黑名单。骰娘通过这一机制实现不良记录的传递共享。<br>
拉黑群时会自动移除【许可使用】。<br>
*刷屏在程序内定义为发送指令超过20/30s，实际解释权归Master所有*
#### 邀请人连带(.admin KickedBanInviter/BannedBanInviter=1)
默认开启。被移出/禁言时将入群邀请者同时加入黑名单。<br>
*邀请者责任源于协议中不得擅自拉群的规定，这里的擅自是双向的：一边无视骰娘协议，一边无视群内意愿*
### 云操作(.cloud)
#### 查看更新(.cloud update)
注意：此功能可能暂时不可用。对于Mirai请执行更新.cmd或Update.sh以进行更新。<br>
远程获取Dice!正式版及开发版信息<br>
`.cloud update` //检查版本更新<br>
`.cloud update release` //下载最新发布版<br>
`.cloud update dev` //下载最新开发版（使用测试版/开发版请保持与开发者的交流）
#### 同步不良记录(.cloud black)
该指令会从后台获取经核验的不良记录，并更新本地黑名单库。骰娘不会自动同步云端记录。
### 不良记录
#### 不良记录上传(.admin CloudBlackShare=1)
**该选项默认开启** <br>
开启时，当骰娘原生生成Kick/Ban/Spam记录时，会同时向后台发送该记录。记录在后台收录后处于待核验状态，需要后台管理二次核验才会对其他骰娘生效。<br>
所有云记录有唯一的wid。*上传可能因连接后台失败而失败* 对于生成记录过于频繁，或不良记录源于非Dice!原因与用户产生不良互动的，后台会拒绝收录该骰娘的记录。
“**同步云不良记录同步失败**”的处理方式：手动访问url指向的网页，本地另存为后，参考下文【读取外源记录文件】的方式手动读取。
**该选项开启时，其他QQ发送云端已核验的记录也会对该骰娘生效。**
#### 读取外源记录文件
将其他来源的不良记录BlackList.json重命名为BlackListEx.json，放置于\[DiceData]/conf目录下。Dice!加载时会自动读取并更新记录，之后该文件会被销毁。两种情况下已有记录不会在读取时更新：DiceMaid就是自己；危险等级与本地记录不同。
#### 云记录注销
当前记录核销在群(928626681)内完成，入群后可使用以下指令：<br>
- isbanqq=[qq] 查询目标QQ的云记录
- 查询wid=[wid] 获取wid对应的记录
- erase=[wid] 注销wid对应的记录，仅记录中的当事骰娘(DiceMaid)和骰主(masterQQ)可用
可私聊司令塔Bot`Shiki(Pope)(530136753)`（具体角色可能会有变动）进行上述操作。也可请求管理来完成注销，最通用证明材料为：当事人对当事骰娘发送.admin isban [本人QQ]，连同骰娘回复将聊天记录转发给管理。
#### 用户自行解黑
云记录核销之后，所有骰娘并不会自动同步。遇到尚未注销黑名单的骰娘，请用户自行解黑。方法为**对已注销的骰娘发送.admin isban [QQ]**，将得到的warning指令保存，用于私聊未注销的骰娘。由于骰娘存在连接后台失败的可能，导致无法获取记录更新的信息，因此无法保证指令有效。这时请联系相应骰主。
### 其他机制
#### 框架消息富文本转义（CQ码）
DiceDriver会将不同框架下接收的QQ富文本消息（图片、语音等）转换为统一的CQ码，发送时则会转义回框架格式
`[CQ:image,file=xxx.abc]` 将本地`[框架根目录]/data/image/xxx.abc`位置的图片上传并在消息中发送
`[CQ:image,id=xxx]`接收消息中的图片，id与服务器缓存图片对应，但区分群聊图片与私聊图片。群聊调用私聊消息的图片id将无法正常发送图片，反之同理。
`[CQ:record,file=xxx.silk]`将本地`[框架根目录]/data/record/xxx.silk`位置的语音上传并覆盖整条消息内容发送（Mirai不限制文件后缀）
`[CQ:face,id=xxx]` 发送对应id的QQ黄豆表情
`[CQ:emoji,id=xxx]` 发送对应十进制编码的Unicode字符
`[CQ:reply,id=xxx]`（群聊且限定在开头适用）回复引用指定id的消息
#### 消息送间隔(.admin SendIntervalIdle=500)
一般地，Dice!的待发送QQ消息不会立即发送，而是进入发送队列排队发送，并在每次发送后等待固定时间，即发送间隔(ms)。`SendIntervalIdle`控制闲时发送间隔，`SendIntervalBusy`控制忙时发送间隔。
特别地，Dice!识别一条待发送消息中的分页符(`'\f'`)，并沿分页符将消息拆成多条，依序送入消息发送队列。分页符无法在指令输入时直接录入，可以输入{FormFeed}作为消息分段，调用时会自动转义。
#### 回复引用原消息(.admin ReferMsgReply=1)
(**仅gocq及MQ系列可用**)开启后所有公屏消息回复将引用原消息。
#### 本系骰识别
Dice2.5.0+可以通过调用后台接口以识别目标QQ是否在Dice!云端有登记信息。新入群遍历群成员时将统计可识别本系骰数量。由于禁言反制和踢出反制是Dice!的默认协议，让Dice!骰去禁言/踢出另一只Dice!骰无疑是愚蠢的，因此在执行group ban/kick前会先查询目标是否为Dice!骰，是则不会进行实际操作。基于骰主所拥有的隐私权，云端不可见(CloudVisible=0)的Dice!骰不会被识别。
## 个性化
### 文本转义标识
回复文本中可以通过特定的{}标记转义文本，当前花括号支持嵌套。
指令回复中对用户（消息来源）的通用转义如下：
- `{nick}`-取用户昵称，优先级为群内nn>全局nn>群名片>QQ昵称。
- `{pc}`-取用户角色名，未录入角色卡则同{nick}。
部分转义方法：
- `{at:目标用户}`-at用户，省略参数则at消息对象；
- `{help:条目名}`-获取帮助文档指定条目；
- `{ran:最小值~最大值}`-从范围中随机取值；
- `{sample:分项1|分项2(...|分项n)}`-从所有分项中随机均匀抽取一项插入文本。例：` {sample:效果拔群|干得漂亮}`；
- `{case:uid?账号1=1号专属文本&账号2=2号专属文本&else=通用文本}`-根据消息语境中的变量分条件回复；
- `{grade:user.favor?0=用户&100=亲爱的&else=讨厌鬼}`-根据消息语境中的变量分档位回复；
- `{wait:5000}`-处理时延迟指定的毫秒数
- `{var:变量名?值}`-赋值变量并打印
`{var:变量1=值1&变量2=值2}`-多变量赋值，不打印
其他转义标识：
- `{br}`换行
- `{FormFeed}`分条发送
### 扩展模块mod
扩展模块放入[DiceData]/mod/读取，可加载自定义回执、自定义回复与帮助词条，详见[开发手册](https://v2docs.kokona.tech/zh/latest/Develop_Manual.html)。mod按序读取，且从后向前覆盖。
`.mod list` 查看已加载mod列表
`.mod on 模块名` 启用指定模块
`.mod off 模块名` 停用指定模块
`.mod info 模块名` 指定模块简介信息
`.mod detail 模块名` 指定模块详细信息
`.mod delete 模块名` 卸载指定模块
#### 远程模块资源
可以在`WebUI->模块管理->远程资源`中查看远程mod库列表并远程安装。
### 个性化WebUI
Dice!2.6.6更新后将WebUI主页面写出到`[DiceData]/webui/index.html`，同时webui目录可通过WebUI端口访问。
### 自定义
#### 扩展指令
扩展脚本可放入`[DiceData]/plugin/`读取。文件样例见附录，更多内容请参阅[脚本手册]()。默认可使用`.help扩展指令` 查询载入的指令。
#### 自定义帮助词条(.helpdoc)
`.helpdoc [词条名] [词条内容]` —— 自定义帮助词条<br>
词条内容以&开头表示重定向，如`.helpdoc 追仙子 &追仙`后，.help追仙子 将重定向到追仙的词条<br>
词条名**不需要是源代码中已有的**，请随意添加
特别地，部分词条会存在引用的情况，自定义时可以只自定义被引用的词条。
```json
{
"设定":"Master：{master_ID}\n好友申请：需要使用记录\n入群邀请：黑名单制，非黑即入\n讨论组使用：允许\n移出反制：拉黑群和操作者\n禁言反制：默认拉黑群和群主\n刷屏反制：警告\n邀请人责任：有限连带\n窥屏可能：{窥屏可能}\n其他插件：{其他插件}{姐妹骰}\n骰娘用户群:{骰娘用户群}\n私骰分享群：192499947\n开发交流群：1029435374",
"骰娘用户群":"【未设置】",
"窥屏可能":"有",
"其他插件":"【未设置】"
}
```
#### 自定义回复(.reply)
消息检测触发的顺序为**特殊指令->自定义指令(`Type=Order`)>内建指令->自定义回复(`Type=Reply`)**，检测触发词的顺序为**完全匹配->前缀匹配->模糊匹配->正则匹配**。**触发回复也会算入刷屏计数！**(脚本中可通过写入`msg.ignored = true`无视计数)
```
.reply set (Type=[回复性质](Reply/Order))
[匹配模式](Match/Search/Prefix/Regex)=[触发词1|触发词2]
(Limit=[触发限制])
[回复模式](Deck/Text/Lua)=[回复词]
```
- 回复性质：决定该回复由`停用指令`(bot off)还是`禁用回复`(reply off)控制开关。该项可省略，默认由reply控制。
- 匹配模式：Match-完全匹配；Prefix-前缀匹配；Search-模糊匹配；Regex-正则匹配。
- 触发限制：可填入零至多项触发条件，多项条件以`;`分隔，在触发词匹配后检查是否会被触发（**一项不满足就不触发**）。不触发的消息**不计入刷屏、不进入当日计数、不进入冷却计时**。
- 回复模式：Deck-牌堆（回复词以分隔符'|'切割为牌堆）Text-直接返回回复词；Lua-将回复词作为Lua语句执行，将返回值回复。
`.reply show [触发词]` 查看回复注释<br>
`.reply get [触发词]` 查看回复本文<br>
`.reply del [触发词]` 清除触发词<br>
`.reply list` 列出全部触发词<br>
默认可使用`.help回复列表` 查询触发词，帮助文档对所有人可见，建议手动修饰。
##### 触发条件
- 用户名单user_id：
- 正向名单`user_id:`：只有所列ID中的用户才触发，ID以|分隔
`user_id:触发用户1|触发用户2|...`
- 反向名单`user_id:!`：只有所列ID中的用户不触发，ID以|分隔
`user_id:!触发用户1|触发用户2|...`
- 群聊名单grp_id：
**所有私聊的id视为0**，写入正向名单表示不限制私聊，写入反向名单表示私聊不触发
- 正向名单`grp_id:`：只有所列ID中的群聊才触发，ID以|分隔，
`grp_id:触发群号1|触发群号2|...`
- 反向名单`grp_id:!`：只有所列ID中的群聊不触发，ID以|分隔
`grp_id:!触发群号1|触发群号2|...`
- 触发概率prob：百分比概率触发
`prob:概率`
- 冷却计时cd：计时器中有一个正在冷却状态则不触发，若触发则为每个计时器增加冷却时间。每个计时器以`&`分隔，计时器名称为空时默认取回复关键词。
计量单位：`chat`-以聊天窗口为单位；`user`-以用户为单位；`global`-全局共享
`cd:[计时器名称]@[计量单位]=[冷却秒数]&...`
`[计时器名称]`可省略，视为取本回复的关键词；`@[计量单位]`可省略，视为`@chat`。特别地，当两者均省略时，`cd:秒数`表示以聊天窗口为单位，为本回复独立计算特定秒数的冷却。
- 今日计数today：计数器中有一个达到上限则不触发，若触发则为每个计数器+1。每个计数器以`&`分隔，计时器名称为空时默认取回复关键词。
`today:[计数器名称]@[计量单位]=[计数上限]&...`
省略机制同cd。
- 用户阈值user_var：UserConf中变量为特定值或以上或以下触发，每项以&分隔，`字段=值`表示等于时触发，`字段=值+`表示大于等于时触发，`字段=值-`表示小于等于时触发。特别地，`trust`表示信任等级
`user_var:[变量1]=[阈值1]&[变量2]=[阈值2]+&[变量3]=[阈值3]-`
- 群聊阈值grp_var：群聊时取GroupConf，格式同user_var，使用时推荐搭配`grp_id:!0`排除私聊
- 自身阈值self_var：取DiceMaid自身UserConf，格式同user_var
- 骰娘识别dicemaid：根据对方是否识别为Dice!骰娘判别是否触发，消息来源为自己时不作判别
- 仅骰娘触发`dicemaid:only`
- 骰娘不触发`dicemaid:off`
#### 自定义回执文本(.str)
将系统处理事件的回执替换为自定义文本<br>
`.[键值] [文本]` ——自定义骰娘的某项回执<br>`.[键值] reset` ——重置为原生文本<br>
`.[键值] NULL` ——自定义文本为空白<br>
`.[键值] show` ——查看自定义文本<br>
**如果没有设置，strSelfName和strSelfCall将预设为QQ昵称，并且{self}会自动替换为strSelfCall，前者用于自我展示，后者用于自称。强烈建议自定义strHlpMsg和strAddFriend、strAddGroup，向不熟悉的用户介绍私骰的特别之处（申请、使用须知）。**
例:
```
.strSelfName 测试姬 //入群等自我介绍场合使用
.strSelfCall 本骰娘 //回执中用作自称，{self}的重定向
.strBotOn {self}开始工作了
.strAddGroup Shiki(Judgement), Servant Ruler, 四季映姫·ヤマザナドゥ。来，细数你的罪孽吧
.strRollFumble 大失败 就像是见了阎王一样
.strNameSet 以后就称呼{old_nick}的名称为{new_nick}了
```
#### 自定义敏感词库(.admin censor)
敏感词设置.admin censor <br>`.admin censor +([触发等级])=\[敏感词0](|[敏感词1]...)` //添加敏感词 <br>`
.admin censor -\[敏感词0](|[敏感词1]...)` //移除敏感词 <br>
例:`.admin censor +=nmsl` //将“nmsl”设置为Warning级 <br>`.admin censor +Danger=nn老公|nn主人` //将“nn老公”、“nn主人”设置为Danger级 <br>`
.admin censor -手枪` //移除敏感词“手枪”
##### 匹配机制
骰娘会模糊匹配指令标识符(.)开头的消息，并返回所含敏感词的最高触发等级 <br>
匹配过程自动跳过文本中的特殊符号和空格，且大小写不敏感 <br>
受信任用户会相应降低触发等级，信任4以上用户将不触发检测
##### 触发等级
*使用指令设置Ignore等级可以临时屏蔽词库中不该生效的词，对外置词库这一等级是无意义的* <br>
Ignore //无视 <br>
Notice //仅在0级窗口通知 <br>
Caution //提醒用户，并在1级窗口提醒 <br>
Warning //【默认等级】警告用户，并在1级窗口提醒 <br>
Danger //警告用户且拒绝指令，并在3级窗口警告 <br>
*请避免为纯字母/数字的敏感词设置较高触发等级，这些字符存在误匹配图片码的可能性
##### 词库批量加载
load会读取存档目录中/conf/censor下所有文本文件 <br>
字符编码默认按GBK读取，若字符为UTF8，可在开头先起一行"#UTF8" <br>
一词一行 <br>
触发等级默认为Warning，读取到"#[触发等级]"时，后续录入的词调整为响应等级，如"#Danger" <br>
**词库文件示例**：
以下内容表示以utf-8编码，读取4个敏感词 "nmsl":Warning,"nn老公":Danger,"nn主人":Danger,"sb":Notice
```txt
#UTF8
nmsl
#Danger
nn老公
nn主人
#Notice
sb
```
#### 外置牌堆
将牌堆文件放入[DiceData]/PublicDeck内并重启或load，即可使用牌堆内的条目。牌堆名以'_'开头时，无法直接使用draw命令抽取。
## 支持作者
溯洄正在为后续的开发计划众筹:[https://afdian.net/@suhuiw4123](https://afdian.net/@suhuiw4123)
[欢迎在爱发电支持Shiki](https://afdian.net/@dice_shiki):https://afdian.net/@dice_shiki
也可以微信赞赏Shiki:
## 常见问题
### 登录失败
- **当前版本过低**[00020]：所有非本地原因的登录失败都会返回错误码00020，该错误码的官方说明即为“当前版本过低”，实际原因可能是账号登录被tx判定有风险等，可以选择更换登录协议等方法尝试。 
- 登录环境被判定风险：Mirai或gocq的登录设备信息在`device.json`中，设备信息可能被标记风险，可通过删除账号的原`device.json`重新尝试（Mirai删除bots文件夹下账号信息）。
- 骰娘账号手机登录时，在同一wifi下登录框架有更高成功率。若如此且框架为mirai或gocq，可在登录成功后将设备信息文件`device.json`迁移至用于稳定运行的网络环境(gocq可额外迁移登录会话文件`session.token`)。
- gocq显示*密码错误或账号被冻结*但实际并没有：原理不明，常见于刚解除冻结后，可尝试删除config.yml中的密码改为扫码登录。
框架登录通过的成功率：**同wifi下扫码登录>异地扫码登录>短信验证登录>无验证登录**
### 账号风控（消息屏蔽）
账号被QQ屏蔽最常见的特征有：群聊消息无法成功发送，但私聊消息可以；长文本消息无法成功发送，但短文本可以。
验证是否被屏蔽最直接的方式为查看框架日志，如有发送消息的记录但实际并没有，则可以断定被屏蔽。除此之外的快捷检测方式为在群内发送暗骰指令`.rh`，如果私聊能正常收到结果但群聊无回执，则高概率为被屏蔽。
当账号被屏蔽时，建议暂停工作，避免带病上班，同时将账号作为正常QQ使用（养号）。
### 网络连接失败
- 心跳报告失败：心跳只是向后台发送骰娘当前状态，不影响骰娘运行
- jrrp获取失败：访问境外jrrp服务器失败会向后台报错，但用户会正常收到回执，不影响使用
- log上传失败：访问境外log服务器失败，需要手动从\user\log\文件夹提取txt
- 不良记录上传失败：无法生成云黑wid，可以在官群内发warning申请补录
### 命令行窗口无动静，按回车有
在窗口标题栏右键`属性->选项->编辑选项`页下，关闭`快速编辑模式`，确定。
### Dice驱动器启动失败
#### \[Fatal\]: listen tcp 127.0.0.1:15800: bind: Only one usage of each socket address \<protocol/network address/port\> is normally permitted.
ws连接的端口被占用（极大可能是多个go-cqhttp程序使用相同默认的初始端口），需要修改`config.yaml`使每个go-cqhttp配置的端口各不相同:
```yaml
# config.yml 底端部分
# 连接服务列表
servers:
# 正向WS设置
- ws:
# 正向WS服务器监听地址，修改此处以避免冲突
address: 127.0.0.1:15801
middlewares:
<<: *default # 引用默认中间件
```
### 磁盘空间占用增多
- Mirai一键脚本使用.git更新文件，会造成.git文件夹堆积，如无回退需要可以直接删除；
- Dice目录下`user/log/`所存储的.log记录文件不会在log结束后销毁，部分log可能存在长期记录而不被关闭的情况，需要手动清理；
### 忘记WebUI管理密码
删除`conf/WebUIPassword.digest`，密码将自动重置。
### Mirai红字报错
#### W/MiraiNative: 当前运行环境 64 可能不与 Mirai Native 兼容，推荐使用 32位 JRE 运行 Mirai Native
Mirai启动时检测64位jre启动，而官方版本的MiraiNative只支持32位。请使用[MiraiDiceWindows一键脚本](https://drive.kokona.tech/s/y8WPcEpfMNRyCTa)部署后的`更新.cmd`，并确保根目录没有64位jre后以`启动Mirai.cmd`启动（该启动方式将强制使用根目录下的32位jre而非环境变量中的）。
#### W/MCL Addon: iTXTech Soyuz 未安装，Soyuz MCL Handler 特性已禁用
无影响。
## 附录
#### 配置项目表
详见WebUI`Master设置`页
*注：Disabled是不可用的意思！*
**指令禁用对信任4以上用户无效**
*DisabledBlock仅在区分插件优先级的框架生效，高优先级插件将拦截事件而非传递给低优先级插件处理*
*对.me特别处理的理由是其在跑团中几乎零作用，却可以制造骰娘自己说话的假象，引发风险。*
#### 通知类型表
- 通知级别：事件
- 0（调试）：启动初始化、自定义回执文本、接收响应的warning、非黑受邀入群、非黑好友申请、刷屏初次提醒
- 1（提醒）：解除禁言提醒、增减黑名单、接收warning处理反馈、申请/入群检测到黑名单、黑名单触发退群、接收陌生warning、自定义全局设置、信任等级变动、遥控单群退群/群设置
- 2（敏感）：撤销管理员、批量修改群设置、接收send信息、群聊清查
- 3（警告）：刷屏二次提醒、原生不良记录、系统负载报警
- 4（用户通知）：切换公用/私用、定时开关
- 5（骰娘广播）：生成warning
#### 文件位置表
<table><thead><tr><th>文件路径 </th><th>说明</th><th>读写时机</th></tr></thead><tbody>
<tr><td>[DiceData]/conf/BlackList.json</td><td>黑名单记录</td><td>修改时写入</td></tr>
<tr><td>[DiceData]/conf/Console.xml</td><td>Master配置</td><td>修改时写入</td></tr>
<tr><td>[DiceData]/conf/CustomCensor.json</td><td>自定义敏感词库</td><td>修改时写入</td></tr>
<tr><td>[DiceData]/conf/censor/</td><td>敏感词库</td><td>load时只读</td></tr>
<tr><td>[DiceData]/conf/CustomHelp.json</td><td>自定义帮助文本</td><td>修改时写入</td></tr>
<tr><td>[DiceData]/conf/CustomMsg.json</td><td>自定义回执文本</td><td>修改时写入</td></tr>
<tr><td>[DiceData]/conf/CustomMsgReply.json</td><td>关键词回复文本</td><td>修改时写入</td></tr>
<tr><td>[DiceData]/conf/LinkList.json</td><td>链接索引</td><td>修改时写入</td></tr>
<tr><td>[DiceData]/conf/ModList.json</td><td>模块索引</td><td>修改时写入</td></tr>
<tr><td>[DiceData]/conf/NoticeList.json</td><td>通知窗口列表</td><td>修改时写入</td></tr>
<tr><td>[DiceData]/conf/WebUIPassword.digest</td><td>WebUI密码</td><td>修改时写入</td></tr>
<tr><td>[DiceData]/user/ChatConf.dat</td><td>群聊配置</td><td>退出或save时写入</td></tr>
<tr><td>[DiceData]/user/DiceToday.json</td><td>今日统计</td><td>修改时写入</td></tr>
<tr><td>[DiceData]/user/HelpStatic.json</td><td>帮助统计</td><td>修改时写入</td></tr>
<tr><td>[DiceData]/user/PlayerCards.RDconf</td><td>角色卡记录</td><td>退出或save时写入</td></tr>
<tr><td>[DiceData]/user/UserConf.dat</td><td>用户配置</td><td>退出或save时写入</td></tr>
<tr><td>[DiceData]/user/session/</td><td>团内记录（先攻、ob）</td><td>修改时写入</td></tr>
<tr><td>[DiceData]/audit/</td><td>消息通知日志</td><td>更新时写入</td></tr>
<tr><td>[DiceData]/mod/</td><td>模块文件</td><td>load时只读</td></tr>
<tr><td>[DiceData]/plugin/</td><td>脚本文件</td><td>load及调用时只读</td></tr>
<tr><td>[DiceData]/PublicDeck/</td><td>外置牌堆</td><td>load时只读</td></tr>
<tr><td>[DiceData]/CardTemp/</td><td>角色卡模板</td><td>load时只读</td></tr>
#### Mod文件示例
```json
{
"mod":"塔罗",
"author":"Shiki",
"dice_build":564,
"brief":"外置模块样例文档。未来版本指令时可见",
"comment":"模块信息,该内容只在源文件可见。未来版本dice_build会作为当前版本是否可用的参照",
"helpdoc":{
"塔罗":"塔罗牌，由“TAROT”一词音译而来，被称为“大自然的奥秘库”。它是西方古老的占卜工具，中世纪起流行于欧洲，地位相当于中国的《周易》",
"愚者正位":"憧憬自然的地方、毫无目的地前行、喜欢尝试挑战新鲜事物、四处流浪。美好的梦想。",
"愚者逆位":"冒险的行动，追求可能性，重视梦想，无视物质的损失，离开家园，过于信赖别人，为出外旅行而烦恼。心情空虚、轻率的恋情、无法长久持续的融洽感、不安的爱情的旅程、对婚姻感到束缚、彼此忽冷忽热、不顾众人反对坠入爱河、为恋人的负心所伤、感情不专一。",
"魔术师正位":"事情的开始，行动的改变，熟练的技术及技巧，贯彻我的意志，运用自然的力量来达到野心。",
"魔术师逆位":"意志力薄弱，起头难，走入错误的方向，知识不足，被骗和失败。",
"女祭司正位":"开发出内在的神秘潜力，前途将有所变化的预言，深刻地思考，敏锐的洞察力，准确的直觉。",
"女祭司逆位":"过于洁癖，无知，贪心，目光短浅，自尊心过高，偏差的判断，有勇无谋，自命不凡。",
"女皇正位":"幸福，成功，收获，无忧无虑，圆满的家庭生活，良好的环境，美貌，艺术，与大自然接触，愉快的旅行，休闲。",
"女皇逆位":"不活泼，缺乏上进心，散漫的生活习惯，无法解决的事情，不能看到成果，担于享乐，环境险恶，与家人发生纠纷。",
"皇帝正位":"光荣，权力，胜利，握有领导权，坚强的意志，达成目标，父亲的责任，精神上的孤单。",
"皇帝逆位":"幼稚，无力，独裁，撒娇任性，平凡，没有自信，行动力不足，意志薄弱，被支配。",
"教皇正位":"援助，同情，宽宏大量，可信任的人给予的劝告，良好的商量对象，得到精神上的满足，遵守规则，志愿者。",
"教皇逆位":"错误的讯息，恶意的规劝，上当，援助被中断，愿望无法达成，被人利用，被放弃。",
"恋人正位":"撮合，爱情，流行，兴趣，充满希望的未来，魅力，增加朋友。",
"恋人逆位":"禁不起诱惑，纵欲过度，反覆无常，友情变淡，厌倦，争吵，华丽的打扮，优柔寡断。",
"战车正位":"努力而获得成功，胜利，克服障碍，行动力，自立，尝试，自我主张，年轻男子，交通工具，旅行运大吉。",
"战车逆位":"争论失败，发生纠纷，阻滞，违返规则，诉诸暴力，顽固的男子，突然的失败，不良少年，挫折和自私自利。",
"力量正位":"大胆的行动，有勇气的决断，新发展，大转机，异动，以意志力战胜困难，健壮的女人。",
"力量逆位":"胆小，输给强者，经不起诱惑，屈服在权威与常识之下，没有实践便告放弃，虚荣，懦弱，没有耐性。",
"隐者正位":"隐藏的事实，个别的行动，倾听他人的意见，享受孤独，有益的警戒，年长者，避开危险，祖父，乡间生活。",
"隐者逆位":"憎恨孤独，自卑，担心，幼稚思想，过于慎重导致失败，偏差，不宜旅行。",
"命运之轮正位":"关键性的事件，有新的机会，因的潮流，环境的变化，幸运的开端，状况好转，问题解决，幸运之神降临。",
"命运之轮逆位":"挫折，计划泡汤，障碍，无法修正方向，往坏处发展，恶性循环，中断。",
"正义正位":"公正、中立、诚实、心胸坦荡、表里如一、身兼二职、追求合理化、协调者、与法律有关、光明正大的交往、感情和睦。",
"正义逆位":"失衡、偏见、纷扰、诉讼、独断专行、问心有愧、无法两全、表里不一、男女性格不合、情感波折、无视社会道德的恋情。",
"倒吊人正位":"接受考验、行动受限、牺牲、不畏艰辛、不受利诱、有失必有得、吸取经验教训、浴火重生、广泛学习、奉献的爱。",
"倒吊人逆位":"无谓的牺牲、骨折、厄运、不够努力、处于劣势、任性、利己主义者、缺乏耐心、受惩罚、逃避爱情、没有结果的恋情。",
"死神正位":"失败、接近毁灭、生病、失业、维持停滞状态、持续的损害、交易停止、枯燥的生活、别离、重新开始、双方有很深的鸿沟、恋情终止。",
"死神逆位":"抱有一线希望、起死回生、回心转意、摆脱低迷状态、挽回名誉、身体康复、突然改变计划、逃避现实、斩断情丝、与旧情人相逢。",
"节制正位":"单纯、调整、平顺、互惠互利、好感转为爱意、纯爱、深爱。",
"节制逆位":"消耗、下降、疲劳、损失、不安、不融洽、爱情的配合度不佳。",
"恶魔正位":"被束缚、堕落、生病、恶意、屈服、欲望的俘虏、不可抗拒的诱惑、颓废的生活、举债度日、不可告人的秘密、私密恋情。",
"恶魔逆位":"逃离拘束、解除困扰、治愈病痛、告别过去、暂停、别离、拒绝诱惑、舍弃私欲、别离时刻、爱恨交加的恋情。",
"塔正位":"破产、逆境、被开除、急病、致命的打击、巨大的变动、受牵连、信念崩溃、玩火自焚、纷扰不断、突然分离，破灭的爱。",
"塔逆位":"困境、内讧、紧迫的状态、状况不佳、趋于稳定、骄傲自大将付出代价、背水一战、分离的预感、爱情危机。",
"星星正位":"前途光明、充满希望、想象力、创造力、幻想、满足愿望、水准提高、理想的对象、美好的恋情。",
"星星逆位":"挫折、失望、好高骛远、异想天开、仓皇失措、事与愿违、工作不顺心、情况悲观、秘密恋情、缺少爱的生活。",
"月亮正位":"不安、迷惑、动摇、谎言、欺骗、鬼迷心窍、动荡的爱、三角关系。",
"月亮逆位":"逃脱骗局、解除误会、状况好转、预知危险、等待、正视爱情的裂缝。",
"太阳正位":"活跃、丰富的生命力、充满生机、精力充沛、工作顺利、贵人相助、幸福的婚姻、健康的交际。",
"太阳逆位":"消沉、体力不佳、缺乏连续性、意气消沉、生活不安、人际关系不好、感情波动、离婚。",
"审判正位":"复活的喜悦、康复、坦白、好消息、好运气、初露锋芒、复苏的爱、重逢、爱的奇迹。",
"审判逆位":"一蹶不振、幻灭、隐瞒、坏消息、无法决定、缺少目标、没有进展、消除、恋恋不舍。",
"世界正位":"完成、成功、完美无缺、连续不断、精神亢奋、拥有毕生奋斗的目标、完成使命、幸运降临、快乐的结束、模范情侣。",
"世界逆位":"未完成、失败、准备不足、盲目接受、一时不顺利、半途而废、精神颓废、饱和状态、合谋、态度不够融洽、感情受挫。"
}
}
```
## 更新历史
#### 更新说明(2.5.2)
- 支持[自定义文本](#文本转义标识)使用sample转义多选一
- [自动清理过期用户数据](#过期数据自动清理(.admin InactiveUserLine/InactiveGroupLine=360))（默认360天）
- 高频指令通知将显示最后一次指令的内容
- 增加入群后对[同系Dice!的识别](#本系骰识别)
- 降低jrrp失败向后台报错的频率
- 修复单次清群上限无作用的bug
- 修复st格式错误导致CPU100%的恶性bug
- 修复了一些其他bug
#### 更新说明(2.5.1)
- 优化{pc}丢失、群昵称获取失败等问题
- 扩展通知窗口级别，允许.send notice
- 允许自定义定时任务
- 优化lua跨平台编码问题
- lua预设函数新增到18个
#### 更新说明(2.5.0)
- 允许安装lua脚本指令
- 本体独立于框架，必须由Dice驱动器装载
- 使用`.admin ListenSelfEcho/ListenGroupEcho`自定义是否接收自己的私聊/群聊消息
- 补充了对自身的指令频度监控，避免自我响应
- 使用`.admin GroupInvalidSize`自定义协议无效的群规模
- 开启对同系Dice的识别
- 缓存今日人品，允许lua调用
- 默认自动保存间隔调整为5分钟
### 更新说明(2.4.1)
- 更新适配先驱框架的更新和重载功能，及其他接口适配
- 新增.log日志记录功能
- 新增.help模糊查询建议
- 新增敏感词检测机制
- 新增.groups查群功能
- 优化.link功能
- 视入群邀请者拥有群权限
### 更新说明(2.4.0)
- 新增GUI，入口为酷Q【菜单】->【应用】->【Dice!】->【综合管理】
- Dice!对Mirai适配
- 新增统计信息
系统新增硬盘占用检测。入群新增用户比例检测。新增每日用户、指令量统计。
- 新增定时任务
取消默认的每日保存，默认每十分钟保存一次。允许定时清理image/，默认关闭。
- 优化空参数指令的响应
当新人只知道指令不知道参数，在裸发".pc"时将难以得到有效反馈。为了提高交互效率，对于空参数无意义的指令，回执将重定向为对应的help文档。现在发送".pc"将收到与".help pc"相同的应答。与此同时一些原本用于空参数的回执条目被弃用，如：strStErr。
- 新增牌堆格式
在牌堆内可使用"::牌数::内容"的格式替换重复的项目。
- 优化不良记录同步系统
通过将其他来源的不良记录BlackList.json重命名为BlackListEx.json，放置于[DiceData]/conf目录下。Dice!加载时会自动读取并更新记录，之后该文件会被销毁。
通过指令.cloud black可以读取云端经二次确认的记录
新增.user diss 私黑指令
- 新增group 协议无效词条
类似于忽略，但允许!authorize和!warning以及来自admin的!dismiss。进入500人以上群时自动添加该词条，该规模的群聊不该认为自动建立用户协议。
- 新增分页发送机制