feat: publish sanitized Linux cloud-game MAA adapter

2026-09-16 11:11:35 +08:00
commit de064272ec
23 changed files with 2741 additions and 0 deletions
@@ -0,0 +1,180 @@
+# maa-online
+
+在 Linux 无图形服务器上，通过网易云游戏运行《明日方舟》，并让官方 MAA/maa-cli 执行日常任务的实验性适配层。
+
+> 本项目调用网易云游戏未公开的 HTTP、WebSocket 与 WebRTC 协议，可能随平台更新失效，也可能不符合平台服务条款。请仅用于个人研究，自行承担账号及服务风险；禁止多账号、商业代练或规避平台限制。
+
+## 上游项目
+
+本仓库是在以下开源项目及实验原型基础上整理的适配代码，不包含完整第三方源码、官方 MAA 二进制或任何用户凭据：
+
+- **MAA 官方仓库（AGPL-3.0）**  
+  https://github.com/MaaAssistantArknights/MaaAssistantArknights
+- **maa-cli 官方仓库**  
+  https://github.com/MaaAssistantArknights/maa-cli
+- **网易云游戏后端原型（Apache-2.0）**  
+  https://github.com/Tokisaki-Galaxy/netease_cloud_game_server
+- **后端使用的网易云游戏 SDK fork（Apache-2.0）**  
+  https://github.com/Tokisaki-Galaxy/netease_cloud_game_sdk
+- **MAA 云游戏实验分支**  
+  https://github.com/Tokisaki-Galaxy/MaaAssistantArknights/tree/support-cloudgame
+- **最初的网易云游戏 SDK 原型（Apache-2.0）**  
+  https://github.com/wupco/netease_cloud_game_sdk
+- **MAA 社区实验讨论**  
+  https://github.com/orgs/MaaAssistantArknights/discussions/14404
+
+`backend/` 与 `backend/sdk/` 分别保留了相应上游的 Apache-2.0 LICENSE。MAA 和 maa-cli 由安装脚本从官方渠道下载，其许可证仍以各自上游为准。
+
+## 工作原理
+
+```text
+官方 maa-cli / MaaCore
+        │ 标准 ADB 命令
+        ▼
+  bin/adb-cloud
+        │ loopback HTTP
+        ▼
+backend/server.py
+        │ 网易 HTTP + WebSocket + WebRTC
+        ▼
+  网易云游戏中的明日方舟
+```
+
+没有修改官方 MaaCore。`adb-cloud` 将 MaaCore 的截图、点击、滑动、文字输入和启动/停止命令转换成本地 HTTP 请求，因此官方 `maa self update`、`maa update` 与 `maa hot-update` 仍可使用。
+
+## 环境要求
+
+- Linux x86_64（其他架构需自行验证）
+- Python 3.10+
+- `python3-venv`、Git、curl
+- 可访问网易云游戏和 GitHub
+- 已完成实名认证的网易云游戏账号
+- 已有或可登录的《明日方舟》官服账号
+
+## 安装
+
+```bash
+git clone https://git.rrrosmontis.icu/RoyirinRosmontis/maa-online.git
+cd maa-online
+./install.sh
+```
+
+安装脚本会在仓库内部创建被 Git 忽略的 `runtime/`，安装 Python 依赖、官方 maa-cli、官方 MaaCore 和资源；不会下载或保存本仓库维护者的账号数据。
+
+## 登录网易云游戏
+
+```bash
+runtime/venv/bin/python backend/login.py request <手机号>
+runtime/venv/bin/python backend/login.py verify <短信验证码>
+```
+
+生成的 token 位于 `backend/token`，权限为 `0600`，且已被 `.gitignore` 排除。不要将 token、手机号、验证码、身份证信息、游戏截图或日志提交到 Git。
+
+实名认证请在网易云游戏网页或 App 中自行完成，不要通过 Issue、聊天或配置文件提供身份证信息。
+
+## 启动与运行
+
+终端一：
+
+```bash
+bin/maa-online-server
+```
+
+终端二：
+
+```bash
+curl -X POST http://127.0.0.1:22888/start
+bin/maa-online startup Official --batch -v
+```
+
+编辑日常配置：
+
+```bash
+bin/maa-online-config
+```
+
+验证配置：
+
+```bash
+bin/maa-online run daily --dry-run --batch
+```
+
+执行日常：
+
+```bash
+bin/maa-online run daily --batch -v
+```
+
+退出云游戏：
+
+```bash
+curl -X POST http://127.0.0.1:22888/exit
+```
+
+服务默认仅监听 `127.0.0.1:22888`，不要直接暴露到公网。
+
+## 默认日常模板
+
+`user_config/daily.example.toml` 是脱敏示例。首次安装时复制为被 Git 忽略的 `user_config/daily.toml`，包括：
+
+- 基建一键轮换；
+- 自动公招；
+- 刷 `1-7` 清理理智；
+- 信用商店与好友访问；
+- 日常、周常及邮件奖励；
+- 完成后退出云游戏。
+
+示例默认不吃理智药、不碎石、不使用加急许可。运行前务必检查 `stage`、公招次数、信用商店列表和邮件领取选项。全部参数说明见 [`user_config/README.md`](user_config/README.md)。
+
+## 更新
+
+```bash
+bin/maa-online-update
+```
+
+该脚本更新官方 maa-cli、MaaCore、基础资源和热更新资源。适配代码位于官方管理目录之外，不会被 `maa update` 清理。
+
+## 离线测试
+
+启动假后端：
+
+```bash
+runtime/venv/bin/python tests/fake_backend.py
+```
+
+另一个终端验证官方 MaaCore → ADB 适配层：
+
+```bash
+LD_LIBRARY_PATH="$PWD/runtime/home/.local/share/maa/lib" \
+  runtime/venv/bin/python tests/smoke_maa_connect.py
+```
+
+预期：
+
+```text
+MaaCore -> adb-cloud -> fake backend: PASS
+```
+
+## 已知限制
+
+- 网易私有协议可能随时变化；
+- 云视频压缩与网络抖动会降低 MAA 图像识别稳定性；
+- 高频截图在低性能服务器上较慢，基建换班可能耗时较长；
+- Home/ESC 等键值尚未完整验证；
+- 断线自动恢复仍有限；
+- 后端可能出现少量 H.264 解码丢包警告；
+- 游戏自动化会真实消耗招聘许可、理智、信用等资源，请先 dry-run 并审阅配置。
+
+## 安全与脱敏
+
+公开仓库只应保留代码和示例配置。以下内容已明确排除：
+
+- 网易 token、短信验证码、手机号及实名信息；
+- 明日方舟账号、角色 ID、截图及游戏日志；
+- Python 虚拟环境、MAA 二进制、MaaCore 和资源文件；
+- 本地运行产物、备份、缓存和真实 `daily.toml`；
+- 上游项目的完整 Git 工作树。
+
+## 许可证
+
+本仓库自有代码按 Apache License 2.0 发布，详见 [`LICENSE`](LICENSE)。派生文件及第三方组件同时受对应上游许可证约束。