OlivaDice For OlivOS 搭建教程

前言

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

目录

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

1. 仑质 前言
2. 仑质 目录
3. 仑质 获取软件
4. 仑质 开始搭建
   • 仑质 解压
   • 仑质 启动
   • 仑质 登录
   • 仑质 登录QQ和QQ频道
   • 仑质 登录Telegram
   • 仑质 登录Dodo
   • 仑质 登录Fanbook
   • 仑质 登录开黑啦
   • 仑质 登录Discord
   • 仑质 运行
   • 仑质 登录的后续操作
   • 仑质 你需要注意的几点
5. 仑质 搭建后续

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

获取软件

• 本论坛推荐的软件获取途径是 版本发布/OlivaDice 板块，最新版本软件请前往获取
• 本教程内容大部分所基于的版本为3.2.16，最新版本为【3.2.16】OlivaDice - 已发布
• 你也可以浏览本项目的Github项目仓库 OlivOS-Team/OlivaDiceCore 以及 OlivOS-Team/OlivOS

开始搭建

解压

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

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

启动

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

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

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

在此你需要关注形同

[20XX-XX-XX XX:XX:XX] - [INFO] - Welcome to OlivOS 0.10.6(106)

的字样，这表明了当前所使用的OlivOS版本，例如此时的版本为0.10.6(106)，你通常需要在进行问题求助和漏洞反馈时提供这些信息。

登录

现在让我们将注意力放在登陆管理器(OlivOS Login Manager)上
理论上，当前版本的登录管理器已经被充分设计，只需要将提供的栏目都进行填写即可完成登录

你将可以采用多种方式进行登录，值得注意的是，先进的OlivOS支持所有这些账号同时运行，无论它们是否分布在多种平台上，都会基于一致的插件得到一致的使用体验。

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

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

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

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

• 账号类型一栏选择传统QQ
• 账号一栏填入你的QQ号

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

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

完成后请移步 仑质 运行

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

• 账号类型一栏，公域机器人选择QQ频道 - 公域，私域机器人选择QQ频道 - 私域
• BotAppID一栏填入你的BotAppID
• 机器人令牌一栏填入机器人令牌

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

完成后请移步 仑质 运行

登录Telegram

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

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

你将会得到一个形如

ID:TOKEN

的Token

• 账号类型一栏选择Telegram
• TOKEN一栏填入你的ID:TOKEN

登录Dodo

以Dodo开放平台登录

• 账号类型一栏选择渡渡语音 - Dodo
• BotID一栏填入你的BotID（clientId）
• Bot私钥一栏填入你的Bot私钥（clientSecret）
  然后单击保存进行保存

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

此方法不再提供

登录Fanbook

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

• 账号类型一栏选择Fanbook
• Token一栏填入你的Token

然后单击保存进行保存

登录开黑啦

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

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

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

• 账号类型一栏选择开黑啦 - KOOK
• Token一栏填入你的Token

登录的后续操作

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

这是该方法所依赖的go-cqhttp软件本体，请按照其提示进行后续登录操作，例如此处的扫码登录。
值得注意的是，如果扫码登录方法下，如果不小心关闭了二维码，需要重新扫描，你可以前往文件目录中直接找到当前二维码的本体文件，通常为如下路径：

conf\gocqhttp\{Hash}\qrcode.png

其中{Hash}为一段与账号相关的“乱码”，经由MD5算法完成计算，固定为32位16进制数
例如：

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

你需要注意的几点

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

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

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

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

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

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

OlivaDice

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