|
|
@@ -1,5 +1,3 @@
|
|
|
-欢迎大家捧场
|
|
|
-
|
|
|

|
|
|
|
|
|
## 设计思路(其实大部分就是alas的设计)
|
|
|
@@ -7,40 +5,109 @@
|
|
|
<details>
|
|
|
<summary></summary>
|
|
|
|
|
|
-- 核心
|
|
|
+### 核心
|
|
|
|
|
|
- - 看上图左侧的+号,每一个被称为script实例,可以简单的理解为不同的模拟器配置或者是不同的任务配置,每个实例由一个config.json文件来驱动。config来管理任务的调度,配置任务的不同的参数。
|
|
|
- - 这个脚本的目的是实现全程的7x24的接管游戏,去享受生活而不是在阴阳师这里上班,所以我也是有空更新。
|
|
|
- - 对于每个任务的执行过程就是比较常规的截图(识别)+控制(点击啥的),在这里会选择和我[早期的设计](https://github.com/runhey/Uowl)一致,设计一个原子化的模块化的配置信息。比如说要识别某个图片会添加一份json数据来设置识图的范围、方式、识别的图片。点击的话也会有一份json数据配置点击的随机概率、范围等等。每一个操作都一份可格式化的配置信息,而不是同alas一样将识别图片和点击一起抽象成一个button。
|
|
|
- - 噢对了我在写代码的时候命名上并没有针对oas,因此说你可以fork该项目使用到你的游戏脚本上
|
|
|
+- 多实例化:简单理解为不同的模拟器配置或者是不同的任务配置,每个实例由一个config.json文件来驱动。Config来管理任务的调度,配置任务的不同的参数。
|
|
|
+- 全程接管:阴阳师已经走过了颠覆时期,三次元痒痒鼠玩家本应游戏中畅行无阻,而游戏世界7x24永续航。
|
|
|
+- 游戏通用:我们在参考Alas时发现其同碧蓝航线有很强的耦合性,于此设计该项目将减少同阴阳师的耦合,因此你可以fork该项目使用到你的游戏脚本上
|
|
|
+- 操作格式化:对于每个任务的执行过程就是比较常规的截图+控制,我们选择同[早期的设计](https://github.com/runhey/Uowl)一致,设计一个原子化的模块化的配置信息。比如说要识别某个图片会添加一份json数据来设置识图的范围、方式、识别的图片。点击的话也会有一份json数据配置点击的随机概率、范围等等。每一个操作都一份可格式化的配置信息,而不是同alas一样将识别图片和点击一起抽象成一个button。
|
|
|
|
|
|
-- 部署方式:用的是batchfile + python(env+pip) + git
|
|
|
|
|
|
- - 具体的说就是,需要先下载一个安装包里面包含一个最小python和git环境,运行后下拉仓库,完事后安装依赖,再完事后启动gui。
|
|
|
|
|
|
+### 设计架构
|
|
|
|
|
|
-#### 设计架构
|
|
|
+- 部署方式:batchfile + python(env+pip) + git 。具体的说就是,需要先下载一个安装包里面包含一个最小python和git环境,运行后下拉仓库,完事后安装依赖,再完事后启动gui。
|
|
|
|
|
|
+- GUI实现: 用的是这个库[FluentUI for QML ](https://github.com/zhuzichu520/FluentUI).是用的qml来写,我想懂这个语言的人不多吧,跟python通信一个是靠注入上下文,另一个是靠zerorpc。
|
|
|
|
|
|
-- gui部分
|
|
|
+- 程序入口: 有两个根目录下的gui.py和script.py。而gui.py会根据配置文件config.json来实例化不同的script,script就是某个具体的脚本过程。
|
|
|
|
|
|
- - 用的是这个库[FluentUI for QML ](https://github.com/zhuzichu520/FluentUI).是用的qml来写,我想懂这个语言的人不多吧,跟python通信一个是靠注入上下文,另一个是靠zerorpc。
|
|
|
+- 脚本进程: gui启动自带一个进程,每有一个script就会继续多一个进程,单独建一个进程来提供ocr服务。一般用zerorpc来进程通信。
|
|
|
|
|
|
-- 程序入口
|
|
|
+- 运行过程: gui 按钮点击后就会开始从script上启动服务。script持有一个设备device,一个配置config,一个任务task。这个时候调度器(其实就是config)会更新出running、pending and waiting tasks。选择runing的去执行,任务的执行过程就是一个大的状态机。
|
|
|
|
|
|
- - 有两个根目录下的gui.py和script.py。而gui.py会根据配置文件config.json来实例化不同的script,script就是某个具体的脚本过程。
|
|
|
|
|
|
-- 进程
|
|
|
+### 模块设计
|
|
|
|
|
|
- - gui启动自带一个进程,每有一个script就会继续多一个进程,单独建一个进程来提供ocr服务。一般用zerorpc来进程通信。
|
|
|
|
|
|
-- 运行过程
|
|
|
+</details>
|
|
|
|
|
|
- - gui 按钮点击后就会开始从script上启动服务。script持有一个设备device,一个配置config,一个任务task。这个时候调度器(其实就是config)会更新出running、pending and waiting tasks。选择runing的去执行,任务的执行过程就是一个大的状态机。
|
|
|
|
|
|
-#### 模块设计
|
|
|
|
|
|
-- config模块,主要是有一个类Config,主要是对配置的文件的接口,以及一些代码中手工配置的参数。(我还没写好从yaml到template.json和从template更新配置)
|
|
|
-- device模块,四个方向的功能管理模拟器,管理游戏,截图和控制
|
|
|
+## SETUP
|
|
|
+
|
|
|
+oas目前还在开发中,我们期待你的加入,Q群: 465946275
|
|
|
+
|
|
|
+### 浅尝即可
|
|
|
+
|
|
|
+如果单纯了解本项目,你可以下载[最新发布](https://github.com/runhey/OnmyojiAutoScript/releases),会自动安装环境。
|
|
|
+
|
|
|
+具体是:下载->解压->打开'oas.exe', 稍等一两分钟待环境安装好后即可启动
|
|
|
+
|
|
|
+### 参与开发
|
|
|
+
|
|
|
+1. 打开本项目[主仓库](https://github.com/runhey/OnmyojiAutoScript/tree/master), 点击右上角的 `Fork`,然后点击下面绿色的 `Create fork`
|
|
|
+
|
|
|
+2. 进入自己账号下的 Alas 仓库,并 `clone` 其中的 `dev` 分支到本地
|
|
|
+ ```
|
|
|
+ git clone url -b dev
|
|
|
+ ```
|
|
|
+
|
|
|
+3. 下载[最新环境包](https://github.com/runhey/OnmyojiAutoScript/releases), 解压复制`toolkit`,`deploy`两个文件夹和`consloe.bat`到本地的仓库根目录,`toolkit`里面包含python最小环境、git环境和GUI启动环境。
|
|
|
+
|
|
|
+3. 安装pip库, 安装后你可以执行`gui.py`启动进行测试
|
|
|
+
|
|
|
+ ```
|
|
|
+ ./toolkit/python.exe -m pip install -r requirements.txt
|
|
|
+ ```
|
|
|
+
|
|
|
+5. 此时你可以进行开发了,建议完成所有功能/任务后,再提交 `commit`, 别忘了按照下面的 `统一格式` 写上 `message`
|
|
|
+
|
|
|
+ ```
|
|
|
+ git commit -m 'message'
|
|
|
+ ```
|
|
|
+ >`message`的统一格式
|
|
|
+ >```
|
|
|
+ >doc(your part): your changes
|
|
|
+ >feat(module name): your add
|
|
|
+ >fix(module name): your fix
|
|
|
+ >```
|
|
|
+
|
|
|
+6. 完成开发后,推送本地分支到自己的仓库
|
|
|
+
|
|
|
+ ```
|
|
|
+ git push -u origin
|
|
|
+ ```
|
|
|
+
|
|
|
+ > 第一次 `push` 代码需要按照提示设置上传流(`--set-upstream`)
|
|
|
+
|
|
|
+5. 打开 [主仓库](https://github.com/runhey/OnmyojiAutoScript/tree/master)。提交一个 `pull request` (会自动携带你 `commit` 的信息),等待管理员通过。注意:要提交到 `dev` 分支上,别提交到 `master` 分支去了
|
|
|
+
|
|
|
+### 开发IDE
|
|
|
+
|
|
|
+- Pycharm
|
|
|
+- QtCreator: 用于qml开发
|
|
|
+- Linguist: Qt家的翻译器
|
|
|
+
|
|
|
+## NEXT
|
|
|
+
|
|
|
+| 进度表 |
|
|
|
+| :----------------------------------------------------------- |
|
|
|
+| ✔自动化部署 |
|
|
|
+| ✔GUI引入工程 |
|
|
|
+| ✔config读写参数字段 |
|
|
|
+| 🔨优化window截图+控制 |
|
|
|
+| 🔨投屏到OAS |
|
|
|
+| 🔨操作格式化json生成工具:可以从用户界面简单操作生成维护数据(包括图片匹配,点击操作,滑动操作,ocr识别等等) |
|
|
|
+| 📆Atom: 对于上一条数据的接口 |
|
|
|
+| 📆实现ocr单独进程 |
|
|
|
+| 📆到此我们可以(读参数)、(对游戏截屏控制)、(操控数据)。实现第一个脚本任务如挖土 |
|
|
|
+| 📆重写device(从alas复制过来需要解耦) |
|
|
|
+| |
|
|
|
+
|
|
|
+| **更多** | 难题 |
|
|
|
+| --------------- | ---------------- |
|
|
|
+| 📆实现更多的任务 | 如何输出Log到GUI |
|
|
|
+| 📆建立任务调度 | 优化速度 |
|
|
|
+| | |
|
|
|
|
|
|
-</details>
|