- MaaKEDR 交流群 QQ：1051890489
✅ 项目状态：持续维护与迭代
本项目已完成每日主要流程（启动游戏、领取奖励、资源刷取、技能演练等核心循环）的完整实现， 现进入持续维护与迭代阶段：
- ✅ 核心流程已完整覆盖
- 🔧 后续以 Bug 修复、游戏版本适配、依赖更新 为主，同时按需评估新功能、新任务、新流程
🎵 开发方式
本项目很大程度上使用了 Vibe Coding 开发模式 —— 通过与 AI 助手对话逐步生成代码。 开发者负责提供需求、截图、ROI 坐标、UI 分析和验收，AI 负责实现 pipeline 逻辑、Python 自定义节点、 CI/CD 配置和文档编写。这种模式下开发效率大幅提升，代码质量通过
pnpm check流水线保证。如果你也在用 AI 做 MaaFramework 项目，这个仓库可以作为一个参考案例。 详见 Vibe Coding 开发说明。
本项目还维护了 AGENTS.md 作为 AI 助手的行为指南，确保开发规范和一致性。
- 启动游戏
- 领取奖励（派遣任务、每日/每周/军旅成就、战令通行证、邮箱、高级账号商店每日奖励，可独立开关）
- 资源刷取（特别军费行动、作战体能训练、兵种能力评级、载具对抗演练）
- 剩余体力刷取（固定清空体力模式的资源刷取，用于刷尽剩余体力，随预设/手动启用）
- 技能演练（基础技能、专业技能）
- 玩家对战（PVP 自动战斗，自动选择等级最低的对手，支持多场循环）
- 多关卡选择，可配置战斗次数（1~6 次 / 最大）
- 清空体力循环模式
- 活动关卡与活动商店（耀斑 EX 关卡刷取、商店商品清空）
- 体力信息（读取主界面体力并提示回满时间）
- 📘 在线文档站 — 用户手册、开发文档、协议约定
- 中文：用户手册 · 开发文档 · 协议文档
- English: User Manual · Development · Protocol
本项目支持 Windows / macOS / Linux 桌面端，以及 Android 客户端。详细安装步骤见新手指南。
桌面端：
- Windows 10+
- VC++ Redistributable 2015+
- .NET Desktop Runtime 10.0（MFAAvalonia 需要）
- ADB 已配置（用于连接 Android 设备或模拟器）
Android 客户端：
- Android 10（API 29）及以上
- 无需模拟器、无需配置 ADB 与运行时环境，安装即用
- 需要 Shizuku 或 root 授权
- 仅提供后台模式（虚拟屏固定 720p@240dpi）；前台模式已关闭，因为手机物理屏比例与 720p 资源不匹配
前往 GitHub Releases 下载最新版本压缩包，解压后运行即可。
- Mirror酱高速下载 — 已拥有 CDK 的用户可前往高速下载与自动更新
桌面端每平台提供 MFAA 与 MXU 两种 GUI，按系统架构选择对应压缩包；Android 端提供三个 APK：
| 包 | 适用 |
|---|---|
MaaKEDR-android-arm64-v8a-<版本>.apk（推荐） |
绝大多数 Android 真机，体积约为通用包的一半 |
MaaKEDR-android-universal-<版本>.apk |
双架构通用包，真机 / 模拟器都能装，不确定就选它 |
MaaKEDR-android-x86_64-<版本>.apk |
x86 环境（部分 Android 模拟器） |
桌面端：
# 安装运行时依赖
DependencySetup_依赖库安装_win.bat
# 启动 GUI（两个版本任选其一）
MFAAvalonia.exe # Avalonia UI 版本
# 或
mxu.exe # Tauri + React 版本（MaaEnd 同款）在 GUI 界面中选择任务并配置选项即可开始自动化。
Android 端：
安装对应架构的 APK 后启动，首次运行需授予通知与电池白名单权限，并完成 Shizuku 或 root 授权。应用内含与桌面端一致的图形界面与任务列表，选择任务即可运行。
pnpm install # 安装开发依赖
pnpm check # 代码检查（格式 + schema + MaaFW + lint）
pnpm check:py # Python 代码检查（ruff + pyright）
pnpm test:py # 运行 Python 单元测试（pytest）
pnpm format # 格式化所有文件
pnpm format:py # 格式化 Python 文件
pnpm release:dry-run # 发版预演（校验产物命名，不实际打包）提交前请确保
pnpm check、pnpm check:py与pnpm test:py全部通过。 改动 pipeline / interface / agent 代码后，建议过一遍maakedr-review自查。
MaaKEDR/
├── interface.json # 项目入口配置（PI V2）
├── maa-project.json # create-maa-project 项目配置
├── tasks/ # 任务定义（GUI 中显示的任务列表）
│ ├── startup.json # 启动游戏
│ ├── pvp.json # 玩家对战
│ ├── claim_rewards.json # 领取奖励
│ ├── farm_resources.json # 资源刷取
│ ├── farm_remaining_stamina.json # 剩余体力刷取
│ ├── event_stage.json # 活动关卡与活动商店
│ └── stamina_info.json # 体力信息
├── resource/
│ ├── base/ # 核心资源（各服共用）
│ │ ├── pipeline/ # Pipeline 流程定义
│ │ ├── image/ # 模板匹配用图片
│ │ └── model/ocr/ # PaddleOCR 模型
│ ├── bilibili/ # B 服差异资源
│ ├── taptap/ # TapTap 服差异资源
│ └── announcement/ # 客户端公告与欢迎页
├── agent/ # Python Agent（自定义识别/动作）
│ ├── main.py # 入口（先调 maafw_paths 再 import maa）
│ ├── maafw_paths.py # 定位客户端原生库，须早于任何 import maa
│ ├── agent_runtime.py # AgentServer 运行时装配
│ ├── custom/
│ │ ├── recognition/ # 自定义识别
│ │ └── action/ # 自定义动作
│ └── utils/ # 可复用工具（日志、HTTP、缩放等）
├── Android/ # Android 客户端打包
│ ├── profile.yaml # MaaFwApp 打包配方
│ └── MaaFwApp/ # 客户端外壳（git 子模块）
├── tests/ # pytest 单元测试
├── docs/ # 开发与用户文档（zh / en）
├── tools/ # 构建、发版、schema 校验、CI 脚本
└── .github/workflows/ # CI/CD 配置
更多文档请前往 docs/ 查看。
详细的项目开发文档请参见 docs/，包含：
- 环境搭建与开发入门
- Pipeline 编写指南
- Custom 识别与动作开发
- 项目结构说明
- 通用回主页枢纽
- Android 客户端与打包
- 格式化规范
- Bug 排查
- 海外客户端适配
- Vibe Coding 开发说明
- MaaFramework
基于图像识别的自动化黑盒测试框架
- MFAAvalonia
基于 Avalonia UI 构建的 MaaFramework 通用 GUI 解决方案 - MXU
基于 MaaFramework PI V2 协议的通用 GUI 客户端，使用 Tauri + React + TypeScript 构建 - MaaFwApp
基于 MaaFramework PI V2 协议的 Android 通用 GUI，MaaKEDR 的 Android 版外壳（见 Android/）
- M9A
优秀的 MaaFramework 自动化项目，开发过程中多有参考
- create-maa-project — 项目脚手架
- MaaMCP — MaaFramework MCP 服务器
感谢以下开发者对本项目作出的贡献: