• 前进手册

前置基础知识

关于框架和插件的部分

首先知悉一点 框架和插件不是平级关系 而是上下级关系 先有框架,再有插件在框架上运行

至于扩展那是插件的事情,和框架无关 以下是常见的 OlivaDiceCore,溯洄核心,铃心等插件 OlivOS,Mirai,XQ等框架的支持图表

插件	OlivOS 简写:OvO 直接运行	Mirai 学名:未来 需要native	XQ 学名:先驱 需要额外插件转接
OlivaDiceCore	√	×	×
溯系核心	×	√	√
铃心	×	√	√

关于骰娘核心的部分

这一段在其他地方 已经有详细的叙述了 本篇不多赘述

如何搭建OvO框架下的骰娘

虽然没有把大象装进冰箱那么简单 不过步骤也差不了多少

1. 选择系统和运行方式

2. 部署文件

3. 运行

4. 登录

   1. 调整登录配置

   2. 登录

5. 客制化

如果要选择Windows系统下的整合包形式进行搭建 推荐阅读OlivaDice For OlivOS 搭建教程 这个有图更容易理解

先导表格，下面有具体说明

系统	运行方式	配置gcq	手动装依赖
Windows	exe	×	×
Windows	源码	×	√
linux	源码	√	√

1.选择你的系统和运行方式

• windows(不一一列举)

  1. 以源码形式运行

     • 需要手动安装依赖 是源码运行 适合进阶玩家 支持更多依赖（毕竟自己手动配置）

  2. 以整合包方式运行

     • 一键安装 是exe运行 适合新手玩家 对于更多依赖暂时还不支持

• linux(不一一列举)

  1. 以源码形式运行

     • linux目前没有一键包 需要手动安装依赖 需要手动配置 是源码运行 适合进阶玩家 支持更多依赖（毕竟自己手动配置）

2.部署OvO框架

Windows下的基础文件部署

以整合包进行基础文件部署

1. 将整个整合包解压到你想要的文件夹里去 建议路径全英文，中文也行

2. 观察是否满足整合包要求

   1. 在整合包的根目录下有一个OlivOS.exe

   2. 在整合包的lib目录下有一个go-cqhttp.exe

   3. 在整合包的plugin\app目录下有一个OlivaDiceCore的文件夹或者.opk文件

   4. 如果以上条件满足,请开始下一步 否则请换一个整合包 或者参考Win的以源码模式运行章节 进行资源文件补齐

3. 在满足上述要求后,观看后面的运行章节

以源码模式进行基础文件部署

1. 基础条件

   1. 能直接访问Github 或者会使用各种镜像站下载

   2. 有Chrome,FireFox,Edge等 任意一种常见的Chrome内核浏览器 这个不作强制要求,但是推荐使用 防止因为浏览器原因导致的无法打开Github

2. 开始安装

   1. 你需要安装python3.7.5以上版本 Python官网下载地址:https://www.python.org/downloads/ 安装过程请记得将添加环境变量(Add Python 3.xx to PATH)的√勾上

   2. 从Github下载OlivOS-Team/OlivOS（OlivOS框架）源码

   3. 解压到你喜欢的文件夹/路径下面 这里假设你放在了D:\OlivOS路径下 在此路径下能直接看见main.py

   4. 安装requirements依赖

      1. 打开cmd输入以下指令然后执行 cd D:\OlivOS && pip install -r requirements.txt

      2. 如果下载速度缓慢请自行切换镜像站下载，例： cd D:\OlivOS && pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/

         • 想要通过不同的镜像站进行下载 请自行通过搜索引擎寻找更多镜像站（如Baidu,Google）

      3. 或者在scrpits\目录下找到install.bat来安装依赖 如果安装缓慢可以尝试第一步的第二种方法

   5. 从Github下载OlivOS-Team/OlivaDiceCore（OlivaDiceCore）源码

      • 下载完成后解压压缩包里的OlivaDiceCore到 D:\OlivOS\plugin\app\路径下

      • 完整路径应该是D:\OlivOS\plugin\app\OlivaDiceCore\ 而且打开后能直接看见main.py

      • 如果不是,可能是你的文件夹套娃了 请剪切出来 或者从releases直接下载以.opk结尾的插件

      • 下载完成后直接放在D:\OlivOS\plugin\app\路径下

   6. 从Github的go-cqhttp/releases下载go-cqhttp_windows_amd64.exe

      • 如果有qq平台账号登录需求

      • 或者通过整合包复制一个过来

      • 下载完成后放在lib目录下

      • 重命名go-cqhttp_windows_amd64.exe为go-cqhttp.exe

   7. 观看后面的运行章节

Linux下的基础环境部署

以源码模式进行基础文件部署

这里有一份来自狐狐的Linux手动安装OlivOS&Dice

3.运行

Windows下运行

前置要求 看到这里 那么就已经按照上面的手册操作过了 环境,依赖,gcq,插件什么的都装完放对位置了 那么开始下一步,启动 这里有两种运行方式 自己寻找对应的运行方式即可 这里假设你主路径是D:\OlivOS

通过整合包的exe运行

直接双击OlivOS.exe 然后观看登录环节

通过源码运行

1. 第一种方式： 直接使用自带启动脚本 进入D:\OlivOS\scripts\文件夹 直接运行start.bat即可

2. 第二种方式：手打指令 Win+R 在弹出的窗口输入cmd 点击确定 输入python D:\OlivOS\main.py

然后观看登录环节

4.Win环境的登录

这里仅说QQ端的， 其他端请参考Oliva|3启程手册进行类比

4.1设置登录账号

1. 点击开启OlivOS后出现的窗口内的NEW按钮

2. 账号密码应该是常识

3. PLATFORM：选择平台，应该是常识

4. SDK：选你顺眼的

5. MODEL：gocqhttp-show

6. Auto：True 到这就好了

7. 点击Save

8. 如果需要go-cqhttp与OlivOS分离运行的可以看第六段 关于手动配置go-cqhttp的那些事 这里建议登录成功后再去看 还没学会走路就想着跑步只会摔个大跟头

9. 可以重复此操作直到所有账号全录入完毕

   1. 如果有多个qq的需求 建议在成功登录一个以后 学习使用分离运行的方法

4.2登录

1. 点击Commit

2. 在go-cqhttp的窗口内扫描二维码（一般是这样） 如果二维码显示不全可以去这个路径 conf\gocqhttp\{Hash}\qrcode.png 打开这个二维码使用qq扫描登录 或者直接拉一下（不要左右拉，二维码会消失）

5.客制化

插件的安装

（如果需要jrrp，draw，helpdoc等非OlivaDiceCore本身有的功能请看此条） 从Github下载OlivOS-Team/OlivaDiceJoy源码， 或者从releases 直接下载opk结尾的插件 放置在D:\OlivOS\plugin\app\路径下

Win下取消登录时候的commit框

1. 删除conf\basic.json里第七行的 "OlivOS_multiLoginUI", 所在的一整行

2. 如果想要继续添加这个框就把这一行加回去

怎么设置master

1. 在OlivOS控制台可以看见如.master xxxxxxxx-xxxx-xxxxx-xxxxxx-xxxxxxxx类似的语句。

2. 在私聊窗口向骰娘发送这一句

如何确认你已经是master了

1. 输入.help master

6.关于手动配置go-cqhttp的那些事

写在前面的：

目前qq平台的发消息机制如下： 由go-cqhttp获取来自腾讯服务器的消息转发给OlivOS OlivOS上加载的插件处理完毕以后 由OlivOS发送给go-cqhttp 和go-cqhttp通讯需要token 再由go-cqhttp发送给腾讯服务器

所以需要同时调整OlivOS和go-cqhttp的设置

基本原理速览

1. 这里本质上是网络通讯 所以你甚至可以把OlivOS和go-cqhttp放在两个不同的电脑上 只要能互相ping通就行 或者就直接本机运行 因此引出下面的两个路径

2. 如果你需要OlivOS和go-cqhttp分离运行 把想要设置的相关账号里的MODEL改为Default 并把Auto改为False

3. 全自动配置的go-cqhttp相关文件会在conf/gocqhttp/{Hash}/路径下生成， 所以你可以把lib里的go-cqhttp.exe复制进去 或者搞懂原理以后随便你在哪里运行 甚至是另一个电脑 另一个服务器，包括手机上之类的

需要配置的文件所在位置

此处约定~1为OlivOS框架所在路径 ~2为go-cqhttp所在路径

·	文件名	所在文件夹位置
OlivOS	account.json	~1\conf\account.json
OlivOS	basic.json	~1\conf\basic.json
go-cqhttp	config.yml	~2\config.yml

假设你是win系统 ~1为D:\OlivOS\ ~2为D:\OlivOS\conf\gocqhttp\{Hash}\ 那么对应的文件路径分别为 D:\OlivOS\conf\account.json D:\OlivOS\conf\basic.json D:\OlivOS\conf\gocqhttp\{Hash}\config.yml

配置之前需要做的

1. OlivOS

   1. 运行OlivOS

      (linux用户可以考虑先windows上生成一个以后复制过去,或者熟记结构以后手搓)

   2. 按照正常流程设置一遍虚拟账号密码 比如账号为1,密码为1 设置auto,设置qq,onebot 点击save,此时应当看见一个已经保存成功的账号为1的条目 点击commit

   3. 关闭OlivOS,此时已经生成填写模板了

2. go-cqhttp

   1. 运行go-cqhttp.exe

      1. 选择确定*3

      2. 这是为了释放go-cqhttp启动脚本 如果已经有了请跳过这两步

   2. 运行go-cqhttp.bat

      1. 输入0选择HTTP通讯

      2. 关闭cmd窗口

      3. 这是为了生成config.yml 如果已经有了请跳过这一步

详细配置环节

所需要配置的文件有三个 需要的变量和对应的文件如下

变量	作用	涉及文件
id	账号	~1\conf\account.json ~2\config.yml
password	密码	~1\conf\account.json ~2\config.yml
host：OlivOS	OlivOS服务所在ip	~1\conf\basic.json ~2\config.yml 注意这里是basic.json
port：OlivOS	OlivOS服务所在端口	~1\conf\basic.json ~2\config.yml 注意这里是basic.json
host：go-cqhttp	go-cqhttp服务所在ip	~1\conf\account.json ~2\config.yml
port：go-cqhttp	go-cqhttp服务所在端口	~1\conf\account.json ~2\config.yml
access_token	go-cqhttp服务通信鉴权码 这个随你心意设置 可当成与go-cqhttp服务通信的密码看待	~1\conf\account.json ~2\config.yml

1. OlivOS(框架)

   1. account.json（文件）

      1. id：输入你的骰娘qq

      2. password：随便填，或者不填也行 账号密码核心设置在go-cqhttp那

      3. server

         1. host:你的go-cqhttp服务所在ip 如果是本机可填http://127.0.0.1 你接收完消息,处理完毕以后 需要发到go-cqhttp上去 然后交由go-cqhttp发送到腾讯聊天服务器上去 所以这里是你的go-cqhttpip地址

         2. port:端口号，与go-cqhttp上设置的一致

         3. access_token:随意编造一个 建议设置的复杂一点 这个可以类比成和go-cqhttp通讯时的密码

   2. basic.json（文件）

      1. models

         1. OlivOS_flash_post_rx

            1. server

               1. port 设置端口号 推荐自动以后改手动

               2. host就默认0.0.0.0好了 当然如果不涉及多机通讯可以127.0.0.1

2. go-cqhttp(运行文件)

   1. config.yml（文件）

      1. account

         1. uin: 输入你的骰娘qq,和上面的一致

         2. password就留空,扫码登录就好

      2. default -middlewares

         1. access-token：这个的填写和access_token一致 在OlivOS发送给gcq的时候gcq会根据这个来鉴权 所以请务必保证这个密钥的强度够高

      3. servers

         1. http

            1. host：填写你go-cqhttp运行服务器所在ip 如果就是本机的话可以直接输入localhost 如果是远程请务必不要使用localhost或者127.0.0.1 请填写你自己的服务器ip地址 否则回复消息无法送达

               举例一： A服务器ip为192.168.1.10，运行OlivOS B服务器ip为192.168.1.11，运行go-cqhttp B服务器此处应当填写的是192.168.1.11 或者0.0.0.0 ……………分割线………………… 举例二： A服务器ip为192.168.1.3 同时运行OlivOS和go-cqhttp 那么只要填127.0.0.1就好了 ……………分割线………………… 简单来说就是 如果你的OlivOS和go-cqhttp不在同一个ip上 请参照举例一 如果在同一个电脑上 请参照举例二

            2. port：

               1. 这个port和上面account.json里的port保持一致 否则无法通信

            3. secret目前似乎不需要填写 等待纠正中 (疑似是发给OlivOS的时候让OlivOS鉴权用的)