Skip to content

feat(decisive): 决战功能拓展 - #583

Open
YaoerWu wants to merge 8 commits into
OpenWSGR:mainfrom
YaoerWu:refactor/decisive-ex-repair
Open

YaoerWu wants to merge 8 commits into
OpenWSGR:mainfrom
YaoerWu:refactor/decisive-ex-repair

Conversation

@YaoerWu

@YaoerWu YaoerWu commented Nov 19, 2026

Copy link
Copy Markdown
Contributor

决战 EX 需要按实际地图拓扑选路,并在舰船受损时衔接编队、维修和原轮次续战。本次调整将页面确认、节点交接和具名维修串联起来,避免依据旧页面继续点击,以及仅凭维修计时到期就将舰船视为可出战。

  • 使用 EX 地图拓扑与有序敌方编队数据;核实地图、编队和结算页面后再推进流程。
  • 按舰名和维修时长统一登记舰船与浴室槽位。短修入浴,长修优先换健康舰;快修前复核缺员、舰名和伤情,入浴计时到期后仍需观察实际状态。
  • 在安全节点交回设备,协调日常任务、维修和原轮次续战;战果页消失后将控制交回决战结算。
  • 支持等待中止并复用新帧判断,补充相关测试、日志、配置示例及使用和采集文档。

验证:重组前全量测试为 2043 通过、25 跳过;本次 8 个分类提交与重组前完整快照的 tree 完全一致。pre-commit run --all-files、各提交 hooks 和 git diff --check 均通过,8 个提交的 GPG 签名均已验证。

尚未进行实机验证,页面识别、选路及维修交接仍需设备验收。

@codecov

codecov Bot commented Nov 19, 2026

Copy link
Copy Markdown

@YaoerWu
YaoerWu requested a review from kuainx November 19, 2026 03:04
@YaoerWu YaoerWu changed the title feat(decisive): 完善 EX 选路与具名维修续战 feat(decisive): 决战功能拓展 Nov 19, 2026

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review from [deepseek-v4-flash]:
- Total changes: 92
- Filtered: 73
- Reviewed: 73
- Found issues: 24

最后一条是已有的资料可信度规则,与普通战敌方编队第三个位置出现战利品补给舰的机制分开处理。

## 回放

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

整体看,这次变更主要是对文档/注释的澄清,没有涉及可执行代码,因此没有发现运行时逻辑、性能、安全或兼容性问题。不过有几点建议:

  1. “不用待测结果挑选模板”这一约束被弱化
    原文“只有节点全部合法敌情变体中一致的舰类槽位才用于核对,不用待测结果挑选模板”强调的是:校验时模板来自资料,不能由待测识别结果反向选择。新文改成“只有这些编队在同一位置上的舰种都相同时,才核对该位置的识别结果”后,虽然保留了“一致才核对”的条件,但少了“模板不依赖待测结果”的明确说明。建议补回或合并这一语义,避免读者产生歧义。

  2. “可观测字母”表述较模糊,且“18 份 EX YAML”是固定数量
    “从 18 份 EX YAML 将真实分支投影为可观测字母”中的“可观测字母”具体指什么?如果是指决战地图的分支节点字母(如 A/B/C),建议直接写明。另外“18 份”是当前实现中的固定数量还是容易变化的配置?如果是文档描述,建议确认其准确性,或改为“对应的 EX YAML”以免未来文件数量变化导致文档过时。

  3. “跳过该位置”与“跳过相应证据”两种表述可统一
    前一句说“某个位置的舰种未知或识别为 NO 时,跳过该位置”,后一句说“阵型未知或未检出迂回按钮时也跳过相应证据”。二者一个是“位置”,一个是“证据”,建议统一为比如“该位置的相应证据不参与匹配”,避免阅读时混淆。

return self.ship_registry[key]

def is_ship_available(self, name: str) -> bool:
"""判断舰船是否可用 (非大破 且 非修理中)。"""

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

根据代码变更,发现以下潜在问题:

  1. is_ship_available 等后续方法可能未同步使用标准化后的键名
    get_ship 现在使用 normalize_ship_name(name) 的结果作为注册表的键,但 is_ship_available 等函数如果仍直接用原始 name 查找 ship_registry,将无法命中已注册的标准化键,导致逻辑失效或异常。

  2. 旧数据兼容性问题
    若 ship_registry 中已存在以原始名称注册的旧数据,而新代码使用标准化后的键名,会造成同一艘船对应两个键,伤情和维修记录无法统一;且旧引用无法被新代码访问到。

  3. normalize_ship_name 返回值未定义明确行为
    虽然代码用 or name 兜底了 None/空字符串,但该函数本身可能返回其他非规范化形式(如大小写不同、包含空格等),需要确认其输出是否稳定且唯一。若返回结果不可预期,仍可能造成键冲突。

  4. Ship 对象名称与用户传入名称不一致
    注册时 Ship(name=key) 使用的是标准化后的名称,而非用户传入的原始名称,可能导致后续日志、界面展示或与外部系统交互时出现名称差异。

  5. 缺少对 normalize_ship_name 的单元测试
    该函数是本变更的关键依赖,但未看到相关测试覆盖,若其逻辑有误则会影响整个注册机制。

if not destroy_ships_auto(self._ctx, from_dialog=True):
# 保留舰种覆盖全部舰种, 无可解装对象, 船坞仍满
raise DockFullError('决战中船坞已满,且无可解装舰种')
return

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

以下是针对该代码变更的审核意见:

  1. check_stop 添加合理:在关键操作前调用 check_stop(self._ctx.stop_event) 能及时响应停止请求,避免长时间阻塞,属于明显改进。

  2. _prepare_entry_state 中的提前返回需谨慎
    goto_page(...) 之后若 self._state.expected_stage is not None 直接 return,会跳过 navigate_to_chapter。但该逻辑依赖以下前提:

    • goto_page 已确保页面处于决战章节,或
    • _state.expected_stage 被严格同步为“当前已处于该章节”的状态。
      若后续逻辑期望 _battle_page 已经导航到具体章节,而实际仍停留在总览页,可能导致后续操作失败。建议确认 goto_page 的导航范围,或在此分支补充页面状态断言/日志。
  3. destroy_ships_auto 的接口变更未在片段中体现
    原代码先 click 再调用 destroy_ships_auto(self._ctx),新代码改为直接 destroy_ships_auto(self._ctx, from_dialog=True)。这要求 destroy_ships_auto 已实现 from_dialog 参数并能正确处理“从对话框开始”的流程。若该函数未同步修改,会导致 TypeError 或行为错误,建议确认相关函数定义及调用约定。

  4. 移除固定点击可能影响旧流程兼容性
    删除 self._ctrl.click(0.38, 0.565) 后,原有依赖该点击位置的流程(如关闭弹窗、切换标签等)将不再执行。如果 from_dialog=True 未能完全覆盖原点击操作的功能,比如某些情况下对话框并未弹出或位置发生变化,可能导致 API 调用失败。建议检查其他调用 destroy_ships_auto 的位置,确保行为一致。

  5. 缺乏测试覆盖
    新增的提前返回分支和 from_dialog 行为是新的逻辑路径,建议补充单元测试或集成测试,覆盖“已处于目标阶段”和“船坞满但可解装/不可解装”等场景,避免回归。

综上,改动方向是积极的,但需重点验证第 2、3 点的前提条件是否成立,并确保 destroy_ships_auto 的新参数实现正确。在确认这些之前,不建议直接合并。

Comment thread autowsgr/ops/repair.py
# 没有可修候选,结束本轮派单。
_log.debug('[OPS] 无可修理舰船, 结束派单 (本轮已派 {} 艘)', repaired)
break

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

根据代码审核,发现以下潜在问题:

  1. secs == 0 的处理与原逻辑语义不一致
    原代码中 secs == 0 被视为“修理时间解析失败”,不记为成功派单也不占用浴室。修改后 secs >= 0 均执行 repaired += 1,且通过回调 _record_bath 执行了 occupy(0)。这会导致:

    • 统计的“已派单数”虚增,可能影响外部循环调度。
    • occupy(0) 的行为不明确,可能产生无效占用或意外释放槽位,破坏浴室状态管理。
  2. 回调 on_accepted 的调用时机与参数未在本次改动中体现
    代码中 page.repair_longest(blacklist=blocked, on_accepted=record) 使用了新参数,但 BathPage.repair_longest 的实现是否已同步修改并正确回调 partial(_record_bath, ctx)(即需要传递 name 和 seconds)无法从本片段确认。若未同步修改,会直接导致 TypeError 或行为异常。

  3. _record_bath 中无条件重置 slot_count 可能覆盖动态配置

    ctx.bathroom.slot_count = ctx.config.bathroom_count

    每次修理后都强制将槽位数量设为配置值,可能覆盖程序运行期间其他逻辑对 slot_count 的动态调整(例如根据实际状态临时修改),存在潜在状态覆盖风险。

  4. repair_ship_by_name 中对 repair_secs == 0 同样调用了 _record_bath
    原代码在 repair_secs >= 0 时执行 ship.set_repair(repair_secs),而新代码额外执行了 occupy(seconds) 和重置 slot_count。若 repair_secs 为 0,会触发与上面第 1 点相同的副作用,且 record_bath(time.time() + 0) 会让舰船“立即结束维修”,可能不符合预期。

  5. 循环逻辑中 break 的使用与注释不符
    secs == 0 时执行 break,注释说明“下一轮触发时再选船”,但这与 repaired += 1 及已执行 occupy(0) 的状态相矛盾。建议明确该场景下是否应视为成功、是否应占用浴室,并相应调整计费与状态变更逻辑。

建议

  • 明确 repair_longest 返回 0 的含义,是“无修理时间”还是“解析失败”,避免用同一数值表示不同状态。
  • 在 _record_bath 中增加对 seconds == 0 的特殊处理,或由调用方确保不传入 0。
  • 确认 BathPage.repair_longest 已兼容 on_accepted 参数,且回调在正确的时机、以正确的参数调用。
  • 检查 bathroom.occupy() 对 0 的处理逻辑,必要时跳过调用。
  • 审慎对待 slot_count 的重置,避免覆盖动态状态。

因此,不能通过本次审核。

RepairAction.QUICK if repair_seconds >= quick_threshold_seconds else RepairAction.BATH
)
return RepairDecision(action)
return RepairDecision(RepairAction.RECHECK)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

根据代码审核,发现以下问题与改进建议:

  1. Python 版本兼容性:使用了 StrEnum,该枚举类型仅在 Python 3.11+ 中可用。若项目需兼容更低版本,建议改为 class RepairAction(str, Enum) 的方式实现。

  2. 冗余条件判断:

    • _validate_duration 中 isinstance(value, bool) 与 not isinstance(value, (int, float)) 重复,因为 bool 本身就是 int 的子类,可简化。
    • repairing is True 分支中的 if repair_seconds is not None and repair_seconds > 0,由于前面已经处理了 repair_seconds is None 的情况,这里可简化为 if repair_seconds > 0。
  3. 边界情况需明确:当 repair_seconds == 0 且 required is True 时,当前逻辑会根据 quick_threshold_seconds 返回 BATH 或 QUICK(若阈值为 0)。如果 0 秒表示“无需修复”或“异常数据”,建议显式处理,避免产生不符合预期的决策。

  4. 建议补充测试覆盖:特别是 required、repairing、repair_seconds、quick_threshold_seconds 为 None 和 0 的边界组合,确保决策逻辑在所有合法输入下都符合预期。

  5. 安全性:未发现敏感信息泄露或执行外部代码的风险,此方面无需修改。

use_quick_repair: true # 允许使用快修桶;关闭后仍可按时长阈值安排入浴。
full_destroy: false # 船舱满了是否解装舰船
useful_skill: false # 充分利用技能
useful_skill_strict: false # 严格利用技能 (useful_skill 为 true 时才生效)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

根据代码变更片段,仅涉及配置文件的调整,未包含对应的逻辑代码。作为代码审核,我提出以下几点关注与建议:

  1. 配置项是否已被代码实现:新增的 quick_repair_threshold_seconds 字段在配置中定义,但需确认程序是否已实际读取并使用该配置。如果仅添加配置而未在逻辑中处理,则此改动无效,且可能误导用户。
  2. 默认值 null 的兼容性:YAML 中 null 是合法值,但需确认下游代码对 null 的处理是否安全,例如避免出现 None 与数字比较时的类型错误,或需要明确区分“未设置”与“阈值设为0”的场景。
  3. 注释语义的清晰度:新注释“短于阈值立即入浴,达到阈值时优先换船,缺员才用桶”表述略显模糊。建议明确“短于阈值”与“达到阈值”的具体比较逻辑(例如小于还是小于等于),以及“入浴”“换船”“用桶”的优先级关系,避免使用者误解。
  4. 与现有 use_quick_repair 的关联:修改后的注释说明 use_quick_repair 关闭后仍会按时长阈值安排入浴,但需确认代码中该开关与新增阈值的交互逻辑是否符合预期,避免出现配置组合下行为矛盾或不可控的情况。

建议补充对应的代码实现说明或测试用例,确保该配置项确实生效且行为符合注释描述。

controller._repairs.park_after_settlement.return_value = False
controller._ctrl.capture_frame.return_value = frame(4)
controller._state = DecisiveState(chapter=6, stage=1, node=session.current_node)
controller._tracking = session

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

该代码变更整体是对新增场景的测试覆盖,方向合理。不过有一个值得注意的潜在问题:

  • 在新增的 test_late_overlay_after_result_preempts_map 中,构造 controller 时只设置了 _ctx、_state、_ctrl、_map,没有像下方修改的 test_controller_waits_for_page_and_submits_one_step 那样初始化 _repairs。如果 _wait_for_post_combat_page 内部执行路径可能访问 _repairs(比如在 continue_combat_result 之后进行修复判断等),该测试会因为缺少 _repairs 属性而抛出 AttributeError。建议补充 controller._repairs = MagicMock()(并视需要设置 park_after_settlement 的返回值),以保证测试独立性和对未来代码重构的健壮性。

其余修改没有发现明显逻辑错误或兼容性问题。

trigger.reset()
assert trigger.should_fire(ctx) is None
pending.on_done(CombatResult(flag=ConditionFlag.OPERATION_SUCCESS))
assert plan.completed == 1

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

根据代码审核原则,发现以下问题:

  1. Callable 的导入位置可能导致运行时 NameError

    • Callable 被放在 if TYPE_CHECKING: 块中导入,但函数注解(如 Callable[[GameContext], object])如果没有 from __future__ import annotations,会在函数定义时被求值。若运行时未导入 Callable,测试会直接报 NameError。
    • 建议确认文件顶部是否有 from __future__ import annotations;若没有,请将 Callable 移到正常导入区,或改为字符串注解。
  2. GameContext 类型未在片段中可见

    • test_failed_daily_fights_let_decisive_node_run 中使用了 Callable[[GameContext], object] 作为类型注解,但 GameContext 在片段中没有导入或定义。如果该名称在文件顶部未导入,同样会在运行时导致 NameError。
    • 请确保该类型已正确导入,或使用字符串形式避免求值。
  3. test_decisive_mode_only_registers_enabled_dailies 的测试断言与配置含义可能不符

    • 配置中 auto_normal_fight=True 且 normal_fight_tasks=['示例计划'],但断言期望注册的触发器只有 ['远征'],似乎忽略了普通战斗任务。
    • 如果这是有意设计(例如决战模式不执行普通战斗),建议将测试中的 auto_normal_fight 设为 False,或增加注释说明为何忽略,避免误导后续维护者;如果这是实现缺陷,则说明 for_decisive 未正确处理 auto_normal_fight。
  4. 测试直接依赖私有属性/方法,脆弱性较高

    • 多个测试直接访问 scheduler._queue、scheduler._triggers、scheduler._maybe_collect_expedition 等私有成员。虽然当前可工作,但后续内部重构会破坏测试。建议优先通过公开接口或 pytest fixture 暴露行为,减少对私有实现的依赖。
    • 这属于改进建议,不影响当前正确性。

除上述问题外,测试逻辑整体覆盖较充分,未发现明显安全或性能风险。请修复以上问题后合入。

"""HTTP 路由应调用公开的操作入口并创建实际执行器。"""
manager = _ExecutingTaskManager()
captured: list[ResolvedFleetSelection] = []

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

根据代码审核,提出以下改进建议:

  1. 新增测试函数缺少 docstring
    test_decisive_stop_does_not_record_a_completed_round 没有像文件中其他测试那样添加说明性文档字符串,建议补充以保持测试风格一致。

  2. 使用 MagicMock 可能使测试过于宽松
    建议像 test_decisive_error_result_marks_task_failed 中那样,使用一个只包含 run 方法的轻量级 FakeController 类,而不是 MagicMock。因为 MagicMock 会容忍对任意属性的访问,这可能掩盖 _start_decisive 中对控制器其他属性的非预期依赖,从而降低测试的准确性。

  3. 部分中文翻译可优化
    例如 "A decisive ERROR is a task failure, not a successful completed round." 被译为“决战发生错误时应报告本轮失败”,建议改为“决定性错误表示任务失败,而非成功完成一轮”,以更准确传达原意。

pixels[y : y + height, x : x + width] = patch
native = MagicMock()
monkeypatch.setattr('autowsgr.ui.decisive.map_controller.get_api_dll', lambda: native)
assert (

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

以下是代码审核意见:

  1. _repairs 使用 MagicMock() 可能引入隐式行为干扰测试
    在多个测试中直接设置 controller._repairs = MagicMock(),但 MagicMock 的嵌套属性默认为 truthy(例如 _repairs.needs_dispatch 会是一个 MagicMock,布尔值为 True)。如果 _main_loop() 中会读取 _repairs.needs_dispatch 或调用其方法,可能会导致测试走到非预期的分支。建议在需要控制逻辑的位置显式设置相关属性,比如:

    controller._repairs = SimpleNamespace(needs_dispatch=False, park_after_settlement=lambda *a: False)

    或至少为 _repairs 配置关键属性,增强测试的可控性。

  2. overlay 位置字典仅覆盖了三种情况,存在 KeyError 风险
    在 test_collection_does_not_recognize_non_map_or_overlay_frames 中,使用 dict 直接索引 overlay,如果参数化列表中出现其他 overlay 名称(或后续新增模板),测试会因 KeyError 失败。建议使用 .get() 并设置默认放置位置,或者通过断言确保所有传入的 overlay 都已在字典中,避免静默遗漏。

  3. _settings 在不同测试中的设置不一致
    部分测试只设置了 _repairs 而未设置 _settings,如果 _main_loop() 在某个分支访问 _settings.daily_automation,会导致 AttributeError。建议统一在所有相关测试中初始化 _settings,或评估代码路径是否确实不会访问该属性,以避免潜在的不一致。

@kuainx

kuainx commented Nov 19, 2026

Copy link
Copy Markdown
Collaborator

能工智人测试反馈(v1-1120):
P0-1:有3条船要修时,只有两个坑,会死循环
P1-1:不用桶的话,买船逻辑也得改改,得把船都先买上 然后优先升级在队伍里面的船;
P2-1:decisiveDaily优先级我认为应该调整,因为用户明确进入决战而不是autodaily,应该先执行决战

顺序 任务 常量 现值 建议值 是否改
1 远征 PRIO_EXPEDITION 0 0 不变
2 任务奖励 PRIO_BONUS 1 1 不变
3 决战修船(派修) PRIO_REQUESTED_REPAIR 40 2 改
4 决战节点 PRIO_DECISIVE 50 3 改
5 战役 PRIO_CAMPAIGN 5 5 不变
6 演习 PRIO_EXERCISE 10 10 不变
7 常规战 PRIO_NORMAL_FIGHT 100 100 不变
8 浴室修理 PRIO_BATH_REPAIR 200 200 不变

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants