AzurLaneAutoScript 项目深度解析指南

一、项目架构解析

1.1 目录结构全景图

AzurLaneAutoScript采用模块化架构设计，主要目录结构如下：

AzurLaneAutoScript/
├── assets/           # 资源文件存储
├── campaign/         # 战役脚本目录
├── config/           # 配置文件目录
├── deploy/           # 部署相关脚本
├── dev_tools/        # 开发工具集
├── doc/              # 项目文档
├── module/           # 核心功能模块
├── submodule/        # 子模块依赖
├── webapp/           # Web应用相关
├── alas.py           # 主程序入口
└── gui.py            # 图形界面入口

1.2 核心目录权重分析

• module/ ⭐⭐⭐⭐⭐
  项目核心功能实现区，包含自动化逻辑的核心代码，如战役系统、设备控制、UI处理等。所有关键业务逻辑均在此实现。

• campaign/ ⭐⭐⭐⭐
  战役脚本存储中心，按不同活动和难度分级管理，包含大量如a1.py、b2.py的战役场景脚本。

• config/ ⭐⭐⭐⭐
  配置系统核心目录，存储全局设置和各类任务参数，是定制自动化行为的关键所在。

• assets/ ⭐⭐⭐
  资源文件仓库，包含多语言支持文件、地图数据、图像模板等关键资源，支持脚本的图像识别功能。

二、核心入口文件指南

2.1 命令行驱动：alas.py 🛠️

alas.py是项目的命令行主入口，通过AzurLaneAutoScript类实现核心调度逻辑。其主要功能包括：

• 初始化配置系统和设备连接
• 任务调度与错误处理
• 提供超过50种自动化任务方法，如：

  def research(self):          # 科研任务处理
  def commission(self):        # 委托任务处理
  def main(self):              # 主线战役执行
  def opsi_explore(self):      # 深海探索模式
  

2.2 图形界面驱动：gui.py 🖥️

gui.py提供WebUI界面支持，基于uvicorn实现Web服务，主要特性：

• 提供直观的浏览器操作界面
• 支持远程访问与控制
• 内置SSL加密支持

2.3 命令行参数对比

参数类型	alas.py	gui.py
核心功能	任务执行引擎	Web服务启动器
参数处理	无显式命令行参数	丰富的启动参数
典型用法	python alas.py	python gui.py --host 0.0.0.0 --port 8080
扩展能力	通过配置文件扩展	支持SSL、密码保护等

gui.py支持的主要参数：

• --host：绑定主机地址
• -p/--port：指定端口号
• -k/--key：设置访问密码
• --cdn：启用CDN加速
• --ssl-cert/--ssl-key：启用HTTPS支持

三、配置系统详解

3.1 配置文件体系

项目配置系统采用分层设计，主要配置文件包括：

• config/config.yaml 🔧
  全局主配置文件，定义基础运行参数和设备信息

• config/campaign_config.yaml ⚔️
  战役相关配置，包含关卡选择、舰队配置等

• config/deploy_config.yaml 🚀
  部署相关设置，控制Web服务、更新策略等

3.2 自定义配置最佳实践

3.2.1 配置修改三原则

1. 备份优先：修改前先备份原始配置文件

   cp config/config.yaml config/config.yaml.bak
   

2. 分层定制：针对不同任务创建专用配置文件，如config/event_christmas.yaml

3. 版本控制：使用#注释记录修改内容和原因，便于后续维护

3.2.2 高级配置技巧

• 条件配置：利用配置系统的条件判断功能，实现不同场景自动切换
• 任务调度：合理设置任务执行间隔，避免操作过于频繁
• 错误处理：调整错误重试次数和等待时间，优化稳定性

3.2.3 常见问题解决

• 配置不生效：检查配置文件路径和格式，确保没有语法错误
• 参数冲突：注意全局配置与任务配置的优先级关系
• 性能优化：通过调整截图频率和识别阈值平衡性能与准确性

通过本指南，您应该能够全面了解AzurLaneAutoScript项目的架构设计和使用方法。合理利用这些知识，可以帮助您更高效地配置和扩展自动化脚本功能。