OlivaDiceDocs
  • OlivaDice(DIXE)官方文档
  • OlivaDice 3 新版手册
  • • 骰主手册
  • • 用户手册
  • • 启程手册
  • • 前进手册
  • OlivaDice 2 旧版手册
  • • 骰主手册
  • • 进阶手册
  • • 食用手册
  • • 用户手册
  • • 喧闹手册
  • 其他工具
  • • Json2Yaml牌堆转换器
Powered by GitBook
On this page
  • 前置基础知识
  • 关于框架和插件的部分
  • 关于骰娘核心的部分
  • 如何搭建OvO框架下的骰娘
  • 1.选择你的系统和运行方式
  • 2.部署OvO框架
  • Windows下的基础文件部署
  • Linux下的基础环境部署
  • 3.运行
  • Windows下运行
  • 4.Win环境的登录
  • 4.1设置登录账号
  • 4.2登录
  • 5.客制化
  • 插件的安装
  • Win下取消登录时候的commit框
  • 怎么设置master
  • 如何确认你已经是master了
  • 6.关于手动配置go-cqhttp的那些事
  • 写在前面的:
  • 基本原理速览
  • 需要配置的文件所在位置
  • 配置之前需要做的
  • 详细配置环节

Was this helpful?

• 前进手册

前置基础知识

关于框架和插件的部分

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

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

插件

OlivOS 简写:OvO 直接运行

Mirai 学名:未来 需要native

XQ 学名:先驱 需要额外插件转接

OlivaDiceCore

√

×

×

溯系核心

×

√

√

铃心

×

√

√

关于骰娘核心的部分

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

如何搭建OvO框架下的骰娘

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

  1. 选择系统和运行方式

  2. 部署文件

  3. 运行

  4. 登录

    1. 调整登录配置

    2. 登录

  5. 客制化

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

系统
运行方式
配置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. 解压到你喜欢的文件夹/路径下面 这里假设你放在了D:\OlivOS路径下 在此路径下能直接看见main.py

    3. 安装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来安装依赖 如果安装缓慢可以尝试第一步的第二种方法

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

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

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

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

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

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

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

    4. 观看后面的运行章节

Linux下的基础环境部署

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

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环境的登录

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.客制化

插件的安装

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鉴权用的)

Previous• 启程手册NextOlivaDice 2 旧版手册

Last updated 3 years ago

Was this helpful?

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

从Github下载(OlivOS框架)源码

从Github下载(OlivaDiceCore)源码

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

从Github的go-cqhttp/releases下载

这里有一份来自狐狐的

这里仅说QQ端的, 其他端请参考进行类比

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

OlivaDice For OlivOS 搭建教程
OlivOS-Team/OlivOS
OlivOS-Team/OlivaDiceCore
releases
go-cqhttp_windows_amd64.exe
Linux手动安装OlivOS&Dice
Oliva|3启程手册
OlivOS-Team/OlivaDiceJoy
releases