开始搭建

解压

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

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)，你通常需要在进行问题求助和漏洞反馈时提供这些信息。

      登录

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

      Image description

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

        方法一：基于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
        • 账号一栏填入你的QQ号

        Image description

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

        Image description

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

        Image description

        完成后请移步 仑质 运行

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

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

        详细操作实例可参考社区案例【教程】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

                  Image description

                  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

                        18 天 后

                        运行

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

                        Image description

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

                          登录的后续操作

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

                          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/appOlivOS插件需要放在这里

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

                              OlivaDice

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

                                说点什么吧...