【教程】手把手教你搭建青果骰

仑质

OlivaDice For OlivOS 搭建教程

Image description

前言

本帖将尽量详细介绍如何基于发布版本以二进制形式搭建青果骰，面向对编程没有什么基础的普通骰主。
更详细的搭建后骰主使用指南，请移步骰主手册
使用中遇到问题请前往问题求助提出疑问，或者前往漏洞反馈上报漏洞

请同时善用Ctrl+F(即浏览器的搜索功能)搜索

仑质前言

仑质目录

仑质获取软件

仑质开始搭建
仑质解压

仑质启动

仑质登录

仑质登录QQ和QQ频道

仑质登录Telegram

仑质登录Dodo

仑质登录Fanbook

仑质登录开黑啦

仑质登录Discord

仑质运行

仑质登录的后续操作

仑质你需要注意的几点

仑质搭建后续

更详细的骰主使用指南，请移步骰主手册

NULL

框架相关:
仑质 OlivaDice For OlivOS 搭建教程
骰主相关：
NULL 牌堆，Mod
NULL 系统指令
SnowLier 远程更新
SnowLier 管理指令
NULL 框架插件的安装
用户相关：
SnowLier Bot相关指令
NULL 人物卡

SnowLier 人物卡扩充指令

SnowLier 通用掷骰指令
SnowLier 成长检定
NULL 理智鉴定
SnowLier 检定指令

仑质

获取软件

本论坛推荐的软件获取途径是版本发布/OlivaDice 板块，最新版本软件请前往获取

本教程内容大部分所基于的版本为3.2.16，最新版本为【3.2.16】OlivaDice - 已发布

你也可以浏览本项目的Github项目仓库 OlivOS-Team/OlivaDiceCore 以及 OlivOS-Team/OlivOS

仑质

开始搭建

解压

在开始使用时，你所需要做的第一件事情就是将获取到的软件包解压。

Image description

不要自作聪明的在压缩包中直接双击运行OlivOS.exe文件，这将导致诸多问题。
完成解压后，你将得到如下文件夹

Image description

仑质

启动

打开得到的文件夹，你将看到本软件包的文件结构，可以看到本程序包初始内容非常简洁

Image description

双击OlivOS.exe启动本程序即可，启动并稍加等待后将会弹出一个登陆管理器(OlivOS Login Manager)

Image description

完成登录流程后会弹出OlivOS 终端

Image description

在此你需要关注形同
[20XX-XX-XX XX:XX:XX] - [INFO] - Welcome to OlivOS 0.10.6(106)
的字样，这表明了当前所使用的OlivOS版本，例如此时的版本为0.10.6(106)，你通常需要在进行问题求助和漏洞反馈时提供这些信息。

仑质

方法一：基于go-cqhttp登录QQ

go-cqhttp是使用mirai以及MiraiGo开发的cqhttp golang原生实现，兼容onebot v11绝大多数内容，并在其基础上做了一些扩展。OlivOS基于onebot v11实现对其的接入，你可以在lib/go-cqhttp.exe找到所依赖的对应二进制发布版本。

如果你只是简单使用，你不需要深究上述斜体内容，你只需要按照本教程所述进行操作即可。
你需要准备好一个用于搭建的QQ账号，QQ账号的注册方法请自行百度。我认为这是一定不会存在问题的部分，否则你也不会来到这里。
注册好后，你将得到一个QQ账号，你需要关注的是它的QQ号。
单击左下角的新建按钮

Image description

将会弹出一个用于输入账号信息的窗口

Image description

账号类型一栏选择QQ/GoCq/安卓平板或者QQ/GoCq/安卓手机

账号一栏填入你的QQ号

Image description

单击保存按钮，即可将你的账号添加至登陆管理器

Image description

你可以重复这个过程，直到你将所有账号添加完成。
单击编辑按钮可以修改已添加的账号登录信息，单击删除可以删除已添加的账号信息。
完成所有添加后，你可以单击右下角的启动OlivOS按钮开始正式的登录。

完成后请移步仑质运行

方法二：基于QQ机器人平台（官方）登录QQ频道

账号类型一栏，公域机器人选择QQ频道/公域/V2，私域机器人选择QQ频道/私域/V2

根据你的机器人能力情况选择是否纯频道

AppID一栏填入你的BotAppID

AppSecret一栏填入AppSecret（请特别注意不是Token）

详细操作实例可参考社区案例【教程】OlivOS接入QQ官方频道教程

Image description

完成后请移步仑质运行

仑质

登录Telegram

你需要通过Telegram官方的文档指引向Bot Father申请一个Bot

Image description

根据操作提示你将能够顺利申请一个机器人

Image description

你将会得到一个形如
ID:TOKEN
的Token

账号类型一栏选择Telegram

TOKEN一栏填入你的ID:TOKEN

Image description

仑质

登录Dodo

以Dodo开放平台登录

账号类型一栏选择渡渡语音 - Dodo

BotID一栏填入你的BotID（clientId）

Bot私钥一栏填入你的Bot私钥（clientSecret）
然后单击保存进行保存

Image description

以Dodo先锋接口登录（已弃用）

此方法不再提供

仑质

登录Fanbook

你可以通过Fanbook官方的机器人管家或者Fanbook开发者平台申请机器人账号，你将获得一个Token

Image description

账号类型一栏选择Fanbook

Token一栏填入你的Token

然后单击保存进行保存

Image description

仑质

登录开黑啦

基于KOOK（原开黑啦）开放平台登录

开黑啦开放平台仍在内测中，所以你需要首先获得开发者资格，你可以在开发者平台获取机器人，此处不详细描述获取途径。

Image description

你需要将当前应用->机器人->机器人连接模式选择为websocket
设置妥当后，你将在当前应用->机器人->Token获得Token
你需要按照以下清单进行设置

账号类型一栏选择开黑啦 - KOOK

Token一栏填入你的Token

Image description

仑质

登录Discord

你需要通过Discord官方的开发者平台申请一个应用

Image description

根据操作提示你将能够顺利申请一个机器人

Image description

点击侧边导航栏「Bot」，使用Reset Token你将可以获取重新生成的Token

点击侧边导航栏「Bot」，打开Privileged Gateway Intents目录下全部三个开关：Presence Intent，Server Members Intent，Message Content Intent（如果你知道这一步是在做什么，你可以自己选择）。完成后点击Save Changes

OlivOS中，账号类型一栏选择Discord

TOKEN一栏填入你的Token

Image description

仑质

运行

如果你是首次运行本软件，你将有可能见到形如如下的提示

Image description

通常情况下，你当然应当选择允许访问，如果你确实要使用本软件却又不愿意如此选择，我们将不对你使用过程中产生的任何问题负责。

仑质

登录的后续操作

如果你采用基于go-cqhttp登录QQ的方式使用，你的每个账号都将会额外弹出一个如下窗口

Image description

这是该方法所依赖的go-cqhttp软件本体，请按照其提示进行后续登录操作，例如此处的扫码登录。
值得注意的是，如果扫码登录方法下，如果不小心关闭了二维码，需要重新扫描，你可以前往文件目录中直接找到当前二维码的本体文件，通常为如下路径：
conf\gocqhttp\{Hash}\qrcode.png
其中{Hash}为一段与账号相关的“乱码”，经由MD5算法完成计算，固定为32位16进制数
例如：

Image description

如果你采用其它方式登录，则这一步没有需要注意的事情。

仑质

你需要注意的几点

更详细的骰主使用指南，请移步骰主手册

完成上述操作后，你将会在右下角的任务栏托盘中看到蓝色的OlivOS图标

Image description

右键打开菜单，插件菜单 -> OlivaDice设置面板 -> 打开设置

Image description

如果没有出现意料之外的事情，此时你将可以开始在聊天窗口中进行使用

Master认证

你将会在OlivOS 终端看到形如如下内容
[20XX-XX-XX XX:XX:XX] - [INFO] - [OlivaDice] - [Init] - 请使用[.master d9c07c94-ef20-4553-87fc-9658656d1c24]指令以获取Master权限
或者在首页上看到显而易见的指示
这意味着你可以在聊天中使用其所述指令获得Master权限

私骰设置

基于我们根据过去4年骰子圈内现状的观察，我们认为黑名单机制的泛滥将是一种助长网络暴力的行为，响应清朗行动的号召，我们没有将黑名单这一陋习作为默认配置，故而实际上不存在所谓公骰与私骰之间明确的界限。
但你仍可以通过以下指令对自动同意好友请求与自动同意群邀请进行关闭。

.master autoAcceptGroupAdd 0
关闭自动同意群邀请

.master autoAcceptFriendAdd 0
关闭自动同意好友邀请

安全性规避

2022-01-19开始出现大面积连续封禁现象，疑似tx暗改临时会话协议，暗骰需要加好友。
如果依旧对私聊安全性存疑，请使用.master disableReplyPrivate 1将由群聊发起的私聊禁用。
同理使用.master disableReplyPrivate 0可恢复原状。

仑质

搭建后续

如果你只是简单使用，以下内容你并不一定需要知道

目录结构

OlivOS

通常而言，OlivOS的目录结构如下

conf
 \_ account.json
 \_ basic.json
lib
logfile
plugin
 \_ app
 \_ conf
 \_ data
 \_ tmp
resource
OlivOS.exe

路径	说明
`conf/account.json`	用于储存账号相关信息
`conf/basic.json`	用于储存OlivOS启动相关配置，`0.9.1`后通常不需要
`plugin/app`	OlivOS插件需要放在这里

如果你看不到这些后缀名，这只与你的资源管理器的相关设置有关，不影响使用

OlivaDice

更详细的骰主使用指南，请移步骰主手册