章节未完成，需要完善图片链接及超链接跳转，请维护人员注意完善。
善用 Ctrl+F 进行页面搜索关键词以快速定位到相关问题！
¶ 如何绑定Master
¶ 通过认主指令设置
当不存在Master时，框架登录完毕并成功对接Dice驱动器之后，Dice驱动器的终端会显示这样的一段内容：
Dice! by 溯洄 & Shiki Ver xxx
Dice！驱动器 OneBot by 安研色Shiki & 溯洄w4123
欢迎使用Dice！掷骰机器人！
请发送.master 69424997 //公骰作成 或
.master 72674221 //私骰作成 即可成为我的主人～
可发送.help查看帮助
此时，你可以选择对骰娘发送 .master 69424997 来使其认主，并初始化为公骰。
关于公骰和私骰的区别请参考官方文档，大部分场景下我们推荐你使用公骰模式，以免遇到不会处理的问题。
¶ 通过WebUI设置
框架登录完毕并成功对接Dice驱动器之后，Dice驱动器的终端会显示这样的一段内容：
Dice!WebUI 正于端口5731运行，本地可通过浏览器访问 http://localhost:5731
默认用户名为admin密码为password，详细教程请查看 https://forum.kokona.tech/d/721-dice-webui-shi-yong-shuo-ming
其中，http://localhost:5731 就是你骰子的 WebUI 端口。5731是骰子随机的一个未被占用的端口号，它可能是其他的数字。
用浏览器打开 http://localhost:(登录端口)
例： http://localhost:5731 或者：http://127.0.0.1:5731
请注意，必须是本地浏览器才可以访问localhost或127.0.0.1，即必须是你用来搭建骰子的计算机内部的浏览器。
在弹出的网页对话框中，输入用户名 admin，密码 password，点击登录，进入 WebUI 界面。
在 Master设置 选项卡中，找到 Master 输入框，填写自己的QQ号，点击 认主 按钮即可完成绑定。
但请注意，如果没有 固定端口? 的话，每次重启Dice，端口号(登录网址)都会改变。
测试跳转?
¶ 网络连接类问题
心跳报告失败：心跳只是向后台发送骰娘当前状态，完全不影响骰娘运行，但无法获取骰娘列表
jrrp 获取失败：访问境外 jrrp 服务器失败会向后台报错，但用户会正常收到回执
log 上传失败：访问境外 log 服务器失败，需要手动从\user\log\文件夹提取log的txt
不良记录上传失败：无法生成云黑 wid，可以在官方群内发 warning 申请重新审核
刷新软件包缓存失败：Mirai 访问服务器失败，不影响工作
¶ 文件操作类问题
¶ 想升级骰娘怎么办
骰子只要可以稳定运行，就不要为了追求更新而更换登录方式
通常情况下，只需要更换 DiceCore（核心文件）即可完成。
如文档时间当前最新版本的核心文件为 w4123.Dice-2.7.0beta9(664).dll ，将其放置在 Diceki 文件夹中，重新启动Dice驱动器即可生效。
但是有时Dice驱动器也要同时更换，不然无法正常驱动新版本的核心文件。
如果和目标版本相差过大，请使用 .bot 查询骰娘当前的版本，并在官方群中尝试取得更新建议。
¶ 想迁移计算机或服务器
迁移计算机/服务器时，你可以将所有文件及文件夹压缩成一个压缩包，并复制到另一个计算机/服务器上解压缩使用。
或者你也可以只保留 Dice骰娘QQ号 ，骰娘本体的数据都在里面。
保留这个文件夹，在目标计算机/服务器上重新启用一份骰娘包，把骰娘数据文件夹放置在相应位置，重新搭建骰娘。
¶ 换骰系数据还在吗
换骰系时，骰娘数据无法保留，这是因为各骰系的数据存储结构不同。
Shiki&溯洄系骰娘除黑名单和骰娘信息之外的数据没有发送至云端共享。
¶ 黑名单会同步吗
云黑名单是自动下发至骰娘中的，本地的黑名单需要云同步，请移步官群找Shiki核验。
¶ 骰娘报警CPU\内存\硬盘占用怎么办
这是在提醒您，骰娘所在的计算机/服务器资源不足，若计算机/服务器并没有高负载程序，但出现了上述提示，请及时检查计算机/服务器健康状况，并立即做出行动。
大部分情况下，这并不会影响骰娘的运行，但有可能会导致骰娘回复延迟变高。
若CPU占用过高，请检查是否有高占用的程序运行，并酌情结束该进程。
若内存占用过高，可以使用 Memreduct 应用程序来定时释放内存。
若磁盘空间占用过高，请检查骰娘所在硬盘分区是否即将被占满，酌情清理一些无用文件。
如果不想检视上述提示，您也可以通过设定关闭这些功能。
使用具有Master权限的账号，对骰娘发送指令 .admin SystemAlarmCPU 0 以关闭CPU告警；
发送指令.admin SystemAlarmRAM 0 关闭内存告警；
发送指令.admin SystemAlarmDisk 0 关闭存储空间告警。
或者，您也可以在WebUI网址中，点击 Master设置 选项卡，找到 SystemAlarmCPU SystemAlarmRAM SystemAlarmDisk 选项，在需要关闭的告警项目右侧的 值 的输入栏中，输入0。
¶ 骰娘提示更新外源不良记录
有新的不良用户被登记至云黑名单时，会同步至已开启云黑名单功能的骰娘的数据中，当触发此功能时，会出现该提示。
如您不想骰娘同步云黑名单，可以使用具有Master权限的账号，对骰娘发送指令 .admin CloudBlackShare 0 以关闭云黑名单同步功能，
或者，您也可以在WebUI网址中，点击 Master设置 选项卡，找到 CloudBlackShare 选项，在右侧的 值 的输入栏中，输入0。
¶ 出现数据文件损坏应该怎么办
如果 Dice骰娘QQ号/user 文件夹里面有文件损坏，尝试将 .RDCONF 和 .dat 为后缀的文件删除，只保留 .bak 后缀的文件再次启动。
.bak 是数据备份文件，通常不会损坏。
¶ 报错显示删除旧dll失败
可能是你进行了手动版本退回，但Dice低版本不支持高版本的数据，出现了兼容故障。
请参考想升级骰娘怎么办
同样你也可以尝试手动删除 Dice骰娘QQ号/dll 文件夹。
¶ 更新到639以上版本时无法正常开启Dice驱动器
出现如下提示：
无法启动此程序，因为计算机丢失api-ms-win-core-path-l1-1+1-0.dll。
尝试重新安装该程序以解决此问题。
这是因为部分旧系统对升级后的Dice不支持，请更换版本为 Windows 10 / Windows2016 及以上版本/
如果无法更换更高版本的操作系统，尝试切换Windows的64位版本，然后下载下面的文件
api-ms-win-core-path-l1-1-0.dll.zip（高级版启动驱动补丁）
api-ms-win-core-path-l1-1-0.dll.zip
打开 C:\\Windoes\\SysWOW64 文件夹，将压缩包内 SysWOW64 文件夹的 api-ms-win-core-path-l1-1-0.dll 放入该文件夹。
重启计算机/服务器之后就可以正常使用了。
¶ WebUI相关问题
¶ 如何固定WebUI端口号
通常情况下，新建的骰娘的WebUI的网址端口号是不固定的，每一次重启都会使其发生改变。
这是为了防止预设的端口号被占用，导致无法启动骰娘。
此时我们可以自行固定一个端口号来方便访问。
使用具有Master权限的账号，对骰娘发送 .admin WebUIPort 12345，即可完成端口号固定。
其中 12345 可以替换成任意 1-65535 之间的你心仪的数值。
通常情况下，我们建议您选择一个大于 10000 的数值。
或者，您也可以在WebUI网址中，点击 Master设置 选项卡，找到 WebUIPort 选项，在右侧的 值 的输入栏中，输入您想设定的端口号。
设定完成后，关闭并重新运行DiceDriver程序以生效设定。
¶ 部署在云服务器上时，如何通过外网直接访问WebUI？
当部署在云服务器上时，通常情况下，云服务器拥有自己的 全世界唯一的、静态的IP地址。
我们可以通过一些简单的设定，允许外部访问我们的WebUI网址。
例如家里的电脑、手机等任意可以访问互联网的设备，而不必须使用服务器内部浏览器访问WebUI。
首先，使用具有Master权限的账号，对骰娘发送 .admin WebUIAllowInternetAccess 1 。
或者，您也可以在WebUI网址中，点击 Master设置 选项卡，找到 WebUIAllowInternetAccess 选项，在右侧的 值 的输入栏中，输入1。
设定完成后，关闭并重新运行DiceDriver程序以生效设定。
然后你就可以使用 云服务器IP:你固定的端口号 ，来访问WebUI了。
例如：http://114.51.4.191:10086
¶ 设定了WebUI到固定端口后就无法使用了
固定端口推荐设置10000-65000之间的数字，不推荐设置四位数及更少位的端口，计算机本身很可能有服务正在使用这些端口。
例如：端口1，端口0，端口8080，端口80这些系统常用端口号。
设置五位数端口可以最大程度的避开已使用端口。
如果已经设置了冲突端口，请打开 Dice骰娘QQ号 文件夹里的 conf 文件夹，然后打开 console 文件，找到 WebUIPort，直接修改文件后重新运行DiceDriver程序。
或者在骰娘启动后，使用具有Master权限的账号，对骰娘发送 .admin WebUIPort 其他端口号 ，关闭并重新运行DiceDriver程序以生效设定。
¶ 忘记WebUI管理密码
删除 Dice骰娘QQ号/conf/WebUIPassword.digest 这个文件，密码将自动重置为password。
¶ WebUI无法正常显示
此问题在最新核心已修复
这是由于WebUI页面中所需调用的 unpkg.com 网址被屏蔽无法访问，导致页面无法正确加载样式及脚本。
方法一：下载webui.zip并解压到 Dice骰娘QQ号/webui（不要重载Dice，否则需要重新覆盖）
WebUI本地版（需启动后再替换）
webui.zip
方法二：一劳永逸的解决方案是打开你的 Webui.html 然后把网址的cdn域名改成下面任何一个的：
fastly.jsdelivr.net
testingcf.jsdelivr.net
gcore.jsdelivr.net
quantil.jsdelivr.net
originfastly.jsdelivr.net
例如：
https://gcore.jsdelivr.net/npm/layui@2.6.8/dist/css/layui.css
https://gcore.jsdelivr.net/npm/layui-soul-table@1.5.13/soulTable.css
¶ 扩展文件及牌堆相关
¶ 下载到的扩展文件应该放在哪里？
首先确认你所有的扩展文件都应该放在Dice的数据文件夹中。
也就是这些文件夹之中。
会需要放扩展文件的文件夹如下：
CardTemp - 文件格式是Dxml的文件放在这里。（已弃用）
mod - 分有两种，一种是只有json格式的文件，文件内容开头格式如下：
{
"mod":"mod名",
"author":"作者",
"dice_build":564, --版本号
"brief":"外置模块样例文档。未来版本指令时可见",
"comment":"模块信息,该内容只在源文件可见。",
"helpdoc":{}
}
有这样开头的文件，放在mod文件夹里。
如果附赠有和json同一名称的文件夹，同样也放在mod文件夹里。
例子如图所示：
plugin - 存放脚本文件，文件格式为.lua，.js，.py（或其他Python格式）
一般情况下不推荐使用Python，因为需要配置环境变量。js格式也需要更新到版本640以上才可使用。
PublicDeck - 牌堆文件，json格式的文件，不属于以上类型的，基本上都属于牌堆文件。
在下载文件时，如果是在论坛下载的文件，通常会有使用说明，根据使用说明进行放置即可。
放置文件成功后，骰主对骰子发送：.system load 指令即可读取文件。
如果有读取失败的文件，骰子会交予回执。
¶ Dice文件夹里面没有PublicDeck怎么办，牌堆放哪里？为什么抽牌没反应？
自己建一个 PublicDeck 文件夹。牌堆放自己建的 PublicDeck 文件夹里。
如果依旧没有反应，在启动时注意检查骰子提示，文件是否加载成功。
如果加载成功但依旧提示没有这个牌堆，确定一下你.draw 的牌堆名对不对。文件名≠牌堆名。你可以.help 全牌堆列表 获取自动生成的牌堆名单。
¶ 牌堆和扩展的功能去哪获取？
论坛和官群都有，也有一些私人的开发群会有人上传。扩展功能出问题找写扩展的作者，跟开发者没关系，跟作者也没关系。
或者你可以自己学，自己写。本教程不教如何写牌堆。
¶ Dice驱动器（DiceDriver）相关
¶ Dic驱动器打开之后闪退或者没有反应
常见于新买的家用电脑，大概率是太新了没有配置一些环境的问题，但具体是什么环境目前还不确定，推荐换个电脑或者搞个服务器。
通常DD（也就是Dice驱动器Gocq.Lite.exe）会显示got bad HTTP response '400'
如果成功启动，Dice驱动器Gocq.Lite窗口显示了配置加载完毕但是没有反应，可以尝试敲一下回车，看看是不是开启了快速编辑模式。如果是，那么关闭快速编辑模式。
如果显示了:No connection could be made because the target machine actively refused it和get Bad HTTP response '404' 可以尝试以下解决方案：
系统防火墙阻止了本地到本地端口的访问，需要修改防火墙设置
¶ Dice驱动器启动失败
报错：[Fatal]: listen tcp 127.0.0.1:15800: bind: Only one usage of each socket address
常见于一台电脑或服务器同时开启两个以上骰子的情况。ws连接的端口被占用（极大可能是多个go-cqhttp程序使用相同默认的初始端口），需要修改config.yml使每个go-cqhttp配置的端口各不相同。
修改位置：打开config.yml文件
找到这里，将红圈中的数字改成别的，不要和WebUI端口冲突，也不要和其他端口冲突，尽量选择10000-65000之间的数字，这样不重复的概率较大。
¶ 指令响应相关问题
¶ 添加骰子好友时显示无用户记录拒绝添加好友，如何关闭审核？
指令：.admin AllowStranger 2
对应的选择分别是：2-允许任何人;1-需要有使用记录;0-仅允许信任用户
¶ 拉骰子进群时无响应，显示需要审核，如何关闭加群审核模式？
指令：.admin CheckGroupLicense 0
对应的选择分别是：2-任何群必须许可使用;1-新加群须许可使用;0-关闭
¶ 骰子只有在特定群内不响应，其他群正常使用是什么情况？
可能有以下几种情况。前提是你先艾特骰娘发送了.r。且确定其他群内可以响应。本群内所有人都无法使用骰子。
例：@骰子 .r
第一种：不响应的群是大群，人数很多。骰子有一个设置叫做停用指令，会默认在500人以上的群内开启。如果需要改人数的话，选择是GroupInvalidSize。
或者在小窗手动给群聊删除停用指令选择。
指令：.group [群号] -停用指令。【发送指令时不要加括号】
第二种：刚加的新群。很可能是骰子没有读取到已经加入群聊，所以不响应。可以考虑重启骰子解决问题。通常这种情况控制台也收不到群内消息。
第三种：你全员禁言了但忘了给骰子管理。
第四种：骰子开启了审核模式，而没有通过审核。尝试发送.help确认是否为该状态，如果确定为审核问题则发送指令：!authorize
¶ 新加好友之后不响应指令
因为Dice的缓存问题，新加好友时不会被判定为好友，如果你打开了默认的禁止非好友使用DisableStrangerChat，就会出现不响应的情况。
如果框架本身不支持非好友消息，请将DisableStrangerChat设置为0
或使用指令:.admin DisableStrangerChat 0
¶ 加骰娘好友没被同意也没被拒绝？
可能原因是骰娘关闭了ListenFriendRequest，不由 Dice!监听好友申请；申请人账号因【加好友过于频繁】等理由被屏蔽好友申请，可以尝试通知骰主手动处理请求，被屏蔽的申请需要点开【过滤通知】查看
¶ 加回复词reply之后，使用sample无法正常回复内容
请注意你写回复的选择，有文本（text），牌堆（deck）和其他代码（lua，JavaScript，Python）三类，使用sample时必须使用文本模式才能触发，牌堆模式与sample不兼容。牌堆模式下可以直接使用：回复内容1|回复内容2
这样的回复作为随机回复词
¶ 忘了原来的自定义语句怎么办？
有关于str自定义相关的内容，想要重置回最开始的内容，可以使用指令.strxxxxx reset，让str自定义语句回到默认回复。
¶ 添加好友之后在私聊窗口骰子无反应怎么办？
首先确认骰子是否是你的单向好友，部分骰主设置了错误的好友申请方式，加好友之后会出现单向好友。确认方法为打开骰子空间查看是否有亲密度的提示，如果有就是双向好友，没有就是单向好友。如果是单向好友请联系骰主反应问题。
如果是双向好友但依旧私聊无反应，可能是因为刚刚才加好友，骰子还没缓存下来，等一段时间就可以用了。
¶ 如何启动DiceDriver.OneBot
这是以OneBot协议为基础构造的DiceDriver，可以适配全部支持OneBot协议的框架。
确认/Diceki/driver.toml中的onebot.ws端口未被占用（默认15800）。双击启动DiceDriver.OneBot.exe（请确认端口的数字与链接方式与框架中填入的一致）
driver.toml内容：
[onebot]
platform='QQ'
impl='NapCat'
ws='127.0.0.1:15800'
[onebot]
platform='QQ'
impl='LLOneBot'
ws_reverse='127.0.0.1:15800'
impl：使用框架，例如此处可以填写'LLOneBot'或'NapCat'（但使用LLOneBot时推荐使用反向链接地址，使用NapCat时推荐使用正向链接地址，两个部署方法无法兼容）
ws：正向链接地址
ws_reverse：反向链接地址
不同骰子需要使用不同端口。但同一个骰子的端口号与链接方式必须一致
注意：Diceki文件夹以及DiceDriver.OneBot.exe可以单独设置文件夹，作为单个骰子的数据文件夹。*只要保证Diceki文件夹、DiceDriver.OneBot.exe和Dice+QQ号文件夹（如有）在同一个目录内，放在其他路径是没问题的。
多账号部署
启动框架后登录不同账户，设置不同的端口号，单独开启对应文件夹里的DiceDriver.OneBot.exe即可完成多账号部署。
¶ 出现读取数据错误type must be array，but is string/type must be string，but is array怎么办？
检查你的Mod和PublicDeck 文件夹。
type must be array，but is string说明你的PublicDeck文件夹有不是牌堆的东西，比如Mod文件。
type must be string，but is array说明你的Mod文件夹有不是属于Mod的文件，比如牌堆。
如何鉴别扩展文件往上看。
¶ 相对路径无法使用时，如何设置绝对路径
绝对路径的示例：[CQ:image,file=file:///C:/xx/xx.jpg] 在file:///后面填入图片的准确路径
¶ 过时问题
本段收纳已经不再存在或已经过时的问题，用于归档。
¶ 跑团log不记录机器人昵称，只显示机器人QQ号，着色器渲染出来的内容少了命令结果可能是什么导致的？
可能是由于 Mirai 框架下开启了 ListenGroupEcho，导致无法记录自己发送的消息。尝试将 ListenGroupEcho 设置为 0，已经出现问题的 log 请尝试手动在 log 里添加机器人名字。
改用NapCat框架之后可以正常使用