user-guide.md

AutoWSGR GUI 用户使用指南

本文面向日常使用者，按实际界面说明当前版本已实现的功能与操作流程。

1. 页面功能总览

• 主页
  • 显示连接状态、当前任务、远征倒计时。
  • 管理任务队列：开始执行、停止、清空。
  • 管理任务列表（任务组）：新建/重命名/删除任务组，导入导出任务列表，整组加入队列。
  • 查看运行日志并按级别过滤。
  • 手动执行常用操作：收取远征、收取奖励、收取建造、食堂烹饪、浴室修理。
• 方案预览
  • 导入 YAML 方案或按地图新建方案。
  • 可视化编辑节点路线与节点参数。
  • 配置编队预设、泡澡修理阈值、任务执行参数。
  • 将方案加入队列或加入任务组。
• 配置
  • 模拟器与 ADB 连接设置。
  • Python 解释器与后端端口设置。
  • 自动更新设置。
  • 每日自动任务开关。
  • 主题、主色调与调试模式。

2. 首次使用建议

1. 打开配置页，先完成模拟器类型和 ADB 串号设置。
2. 点击检测 ADB，确认状态为可连接。
3. 检查 Python 环境（默认可留空自动检测）。
4. 点击保存配置。
5. 回到主页，确认状态从“未连接”转为可用。

3. 新建任务配置流程（从方案预览页开始）

3.1 进入方案预览页

1. 点击顶部导航中的“方案预览”。
2. 在空白页可看到两个入口：
   • 选择 yaml 文件（导入现有方案）。
   • 新建方案（按章节和地图生成新方案）。

3.2 选择方案来源

1. 如果你已有 YAML 方案，点击“选择 yaml 文件”导入。
2. 如果要新建，点击“新建方案”。
3. 在弹窗中配置：
   • 海域（第 1~9 章或 Ex 系列）。
   • 地图（普通章节 16，Ex 章节 112）。
4. 点击“确定”后进入方案详情编辑区。

3.3 配置方案级设置

在方案详情左侧顶部可配置：

• 修理策略
  • 中破就修
  • 大破才修
• 战况
  • 稳步前进
  • 火力万岁
  • 全力以赴
  • 深入敌阵
  • 以退为进
• 编队
  • 第 1~4 舰队
• 注释
  • 点击注释区域可直接编辑文本备注。

3.4 配置编队预设（可选）

1. 在“编队配置”区域点击“+”新增预设。
2. 为预设填写名称。
3. 逐个设置 1~6 号位舰船。
4. 每个号位支持两种模式：
   • 固定舰船模式
     • 舰船名称
     • 最低等级（可选）
     • 最高等级（可选）
   • 模糊匹配模式
     • 固定舰名（可选）
     • 国籍（可选）
     • 舰种（可选）
     • 优先舰船（逗号分隔，可点“填入建议”）
     • 最低等级（可选）
     • 最高等级（可选）
5. 保存后，可在列表中多选预设用于轮换执行。

3.5 配置任务参数

在“任务配置”区域可配置：

• 执行次数
• 间隔（秒）
• 终止条件
  • 战利品 >= 指定值时停止（-1 为不启用）
  • 掉落舰船 >= 指定值时停止（-1 为不启用）
• 泡澡修理（不使用快修）
  • 开关
  • 默认阈值类型：百分比 / 绝对值
  • 默认阈值数值
  • 按舰船名单独设置阈值（需先在编队预设中选中舰船）

3.6 配置节点参数

1. 点击右侧“节点路线”中的任意节点。
2. 在节点编辑面板可配置：
   • 启用节点（关闭后该节点从路线中移除）
   • 迂回（仅在可迂回节点生效）
   • 阵型（单纵/复纵/轮型/梯形/单横）
   • 前进
   • 夜战
   • 远程打击
   • 索敌规则（每行一条，支持 and 组合）
3. 点击“应用”保存节点设置。

索敌规则示例：

DD >= 1, 4
DD >= 1 and CL >= 2, 4

3.7 保存并投递任务

编辑完成后，你可以选择：

• 加入队列：立即进入主页队列等待执行。
• 加入任务组：保存到任务列表，便于后续重复使用。
• 保存 YAML：覆盖当前方案文件。
• 另存为：保存为新文件。

4. 模板库创建与使用

方案预览页右侧“模板库”支持创建可复用任务模板。

1. 点击“创建模板”进入三步向导。
2. 第一步：选择模板类型（普通出击 / 演习 / 战役 / 决战）。
3. 第二步：按类型填写参数。
   • 普通出击：可选方案文件（可多选）、编队、可选舰船编队。
   • 演习：演习舰队、可选舰船编队。
   • 战役：战役类型、可选舰船编队。
   • 决战：章节、level1、level2、旗舰优先级、是否启用快修。
4. 第三步：填写模板名称、默认执行次数、停止条件（可选）。
5. 保存后可在模板项中点击“加入列表”，加入主页任务列表。

5. 主页执行任务

1. 切回主页。
2. 在任务列表中选择任务组，可进行：
   • 全部加入队列
   • 从文件添加
   • 导出列表
   • 导入列表
3. 在任务队列中点击“开始执行”。
4. 运行中可点击“停止”终止当前执行。

6. 配置页可配置项清单

6.1 模拟器配置

• 模拟器类型（雷电 / 蓝叠 / MuMu）
• 模拟器路径（可留空自动检测）
• ADB 端口 serial（可检测）

6.2 Python 环境

• Python 解释器路径（可浏览、可检测，建议 3.12/3.13）
• 后端端口（修改后重启生效）

6.3 界面设置

• 颜色主题（暗色 / 浅色 / 跟随系统）
• 主色调
• 调试模式

6.4 更新设置

• 更新模式（自动 / 手动）
• 立即检查更新

6.5 自动化设置

• 自动远征（含检查间隔）
• 自动战役（战役类型、次数）
• 自动演习（演习舰队）
• 自动常规出击
• 自动决战（保留票数、模板）
• 每日自动刷战利品（地图方案、停止数量）

7. 常见建议

• 调整后端端口或 Python 路径后，建议重启 GUI 再执行任务。
• 任务经常复用时，优先使用模板库和任务组，减少重复配置。
• 节点规则建议先小范围测试，再用于高次数任务。