Skip to content

Commit

Permalink
交错战线 全自动小助手1.0
Browse files Browse the repository at this point in the history
  • Loading branch information
Tohkahb committed Jun 24, 2024
1 parent 5331bf8 commit 1238d87
Show file tree
Hide file tree
Showing 30 changed files with 3,046 additions and 378 deletions.
108 changes: 51 additions & 57 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,96 +1,90 @@
<!-- markdownlint-disable MD033 MD041 -->
<p align="center">
<img alt="LOGO" src="https://cdn.jsdelivr.net/gh/MaaAssistantArknights/design@main/logo/maa-logo_512x512.png" width="256" height="256" />
</p>
# MCCA

<div align="center">
基于全新架构的 交错战线 小助手。图像技术 + 模拟控制,解放双手!
[MaaFramework](https://github.com/MaaXYZ/MaaFramework) 强力驱动!

# MaaPracticeBoilerplate
## 功能介绍

</div>
目前已有的功能:

本仓库为 [MaaFramework](https://github.com/MaaXYZ/MaaFramework) 所提供的项目模板,开发者可基于此模板直接创建自己的 MaaXXX 项目。
1. 启动游戏
2. 每日免费礼包
3. 每日探索(只使用自然回复的燃料)
4. 模拟军演(只打第一个,次数耗尽为止)
5. 基建(换班+好友换抽)
6. 周本(只刷第一关,需提前配好至少一队,二队可刷好感)
7. 领取奖励(邮箱+每日+通行证)
8. 关闭游戏

> **MaaFramework** 是基于图像识别技术、运用 [MAA](https://github.com/MaaAssistantArknights/MaaAssistantArknights) 开发经验去芜存菁、完全重写的新一代自动化黑盒测试框架。
> 低代码的同时仍拥有高扩展性,旨在打造一款丰富、领先、且实用的开源库,助力开发者轻松编写出更好的黑盒测试程序,并推广普及。
## 使用说明

下载地址:<https://github.com/MaaXYZ/MCCA/releases>

## 即刻开始
### Windows

- [📄入门文档](https://github.com/MaaXYZ/MaaFramework/blob/main/docs/zh_cn/1.1-%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B.md)
- [🎞️视频教程](https://www.bilibili.com/video/BV1yr421E7MW)
- 对于绝大部分用户,请下载 `MCCA-win-x86_64-vXXX.zip`
- 若确定自己的电脑是 arm 架构,请下载 `MCCA-win-aarch64-vXXX.zip`
- 解压后运行 `MaaPiCli.exe` 即可

## 如何开发
### macOS

0. 使用右上角 `Use this template` - `Create a new repository` 来基于本模板创建您自己的项目。
- 若使用 Intel 处理器,请下载 `MCCA-macos-x86_64-vXXX.zip`
- 若使用 M1, M2 等 arm 处理器,请下载 `MCCA-macos-aarch64-vXXX.zip`
- 使用方式:

1. 完整克隆本项目及子项目(地址请修改为您基于本模板创建的新项目地址)。
```bash
chmod a+x MaaPiCli
./MaaPiCli
```

```bash
git clone --recursive https://github.com/MaaXYZ/MaaPracticeBoilerplate.git
```

**请注意,一定要完整克隆子项目,不要漏了 `--recursive`,也不要下载 zip 包!**
### Linux

2. 下载 MaaFramework 的 [Release 包](https://github.com/MaaXYZ/MaaFramework/releases),解压到 `deps` 文件夹中。
~~用 Linux 的大佬应该不需要我教~~

3. 配置资源文件。
## 其他说明

```bash
python ./configure.py
```
- 添加 `-d` 参数可跳过交互直接运行任务,如 `./MaaPiCli.exe -d`
- 反馈问题请附上日志文件 `debug/maa.log`,谢谢!

4. 按需求修改 `assets` 中的资源文件,请参考 MaaFramework 相关文档。
## 图形化界面

- 可使用 [MaaDebugger](https://github.com/MaaXYZ/MaaDebugger) 进行调试;
- 也可以在本地安装后测试:
先凑活用吧(

1. 执行安装脚本
## How to build

```bash
python ./install.py
```
**如果你要编译源码才看这节,否则直接 [下载](https://github.com/MaaXYZ/MCCA/releases) 即可**

2. 运行 `install/MaaPiCli.exe`

5. 完成开发工作后,上传您的代码并发布版本。
0. 完整克隆本项目及子项目

```bash
# 配置 git 信息(仅第一次需要,后续不用再配置)
git config user.name "您的 GitHub 昵称"
git config user.email "您的 GitHub 邮箱"
# 提交修改
git add .
git commit -m "XX 新功能"
git push origin HEAD -u
git clone --recursive https://github.com/MaaXYZ/MCCA.git
```

6. 发布您的版本

需要先修改仓库设置 `Settings` - `Actions` - `General` - `Read and write permissions` - `Save`
1. 下载 MaaFramework 的 [Release 包](https://github.com/MaaXYZ/MaaFramework/releases),解压到 `deps` 文件夹中
2. 安装

```bash
# CI 检测到 tag 会自动进行发版
git tag v1.0.0
git push origin v1.0.0
```python
python ./install.py
```

## 生态共建
生成的二进制及相关资源文件在 `install` 目录下

## 开发相关

MAA 正计划建设为一类项目,而非舟的单一软件。
- [MaaFramework 快速开始](https://github.com/MaaXYZ/MaaFramework/blob/main/docs/zh_cn/1.1-%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B.md)

若您的项目依赖于 MaaFramework,我们欢迎您将它命名为 MaaXXX, MXA, MAX 等等。当然,这是许可而不是限制,您也可以自由选择其他与 MAA 无关的名字,完全取决于您自己的想法!
## Join us

同时,我们也非常欢迎在 [最佳实践列表](https://github.com/MaaXYZ/MaaFramework#%E6%9C%80%E4%BD%B3%E5%AE%9E%E8%B7%B5) 中添加上您的项目!
- MCCA 开发交流 QQ 群:513065464
- MaaFramework 开发交流 QQ 群: 595990173

## 鸣谢

本项目由 **[MaaFramework](https://github.com/MaaXYZ/MaaFramework)** 强力驱动!

感谢以下开发者对本项目作出的贡献(下面链接改成你自己的项目地址):

<a href="https://github.com/MaaXYZ/MaaFramework/graphs/contributors">
<img src="https://contrib.rocks/image?repo=MaaXYZ/MaaFramework&max=1000" />
<a href="https://github.com/MaaXYZ/MCCA/graphs/contributors">
<img src="https://contrib.rocks/image?repo=MaaXYZ/MCCA&max=1000" />
</a>

Loading

0 comments on commit 1238d87

Please sign in to comment.