Repository navigation
Conversation
确认入浴后统一登记舰船与槽位;计时到期仍需观察实际伤情。
在安全节点交回设备,统一调度日常任务、具名派修和原轮次续战。 短修入浴,长修先换健康舰;确认缺员、舰名和伤情后才快修。
Codecov Report❌ Patch coverage is 📢 Thoughts on this report? Let us know! |
| 最后一条是已有的资料可信度规则,与普通战敌方编队第三个位置出现战利品补给舰的机制分开处理。 | ||
|
|
||
| ## 回放 | ||
|
|
There was a problem hiding this comment.
整体看,这次变更主要是对文档/注释的澄清,没有涉及可执行代码,因此没有发现运行时逻辑、性能、安全或兼容性问题。不过有几点建议:
-
“不用待测结果挑选模板”这一约束被弱化
原文“只有节点全部合法敌情变体中一致的舰类槽位才用于核对,不用待测结果挑选模板”强调的是:校验时模板来自资料,不能由待测识别结果反向选择。新文改成“只有这些编队在同一位置上的舰种都相同时,才核对该位置的识别结果”后,虽然保留了“一致才核对”的条件,但少了“模板不依赖待测结果”的明确说明。建议补回或合并这一语义,避免读者产生歧义。 -
“可观测字母”表述较模糊,且“18 份 EX YAML”是固定数量
“从 18 份 EX YAML 将真实分支投影为可观测字母”中的“可观测字母”具体指什么?如果是指决战地图的分支节点字母(如 A/B/C),建议直接写明。另外“18 份”是当前实现中的固定数量还是容易变化的配置?如果是文档描述,建议确认其准确性,或改为“对应的 EX YAML”以免未来文件数量变化导致文档过时。 -
“跳过该位置”与“跳过相应证据”两种表述可统一
前一句说“某个位置的舰种未知或识别为NO时,跳过该位置”,后一句说“阵型未知或未检出迂回按钮时也跳过相应证据”。二者一个是“位置”,一个是“证据”,建议统一为比如“该位置的相应证据不参与匹配”,避免阅读时混淆。
| return self.ship_registry[key] | ||
|
|
||
| def is_ship_available(self, name: str) -> bool: | ||
| """判断舰船是否可用 (非大破 且 非修理中)。""" |
There was a problem hiding this comment.
根据代码变更,发现以下潜在问题:
-
is_ship_available等后续方法可能未同步使用标准化后的键名
get_ship现在使用normalize_ship_name(name)的结果作为注册表的键,但is_ship_available等函数如果仍直接用原始name查找ship_registry,将无法命中已注册的标准化键,导致逻辑失效或异常。 -
旧数据兼容性问题
若ship_registry中已存在以原始名称注册的旧数据,而新代码使用标准化后的键名,会造成同一艘船对应两个键,伤情和维修记录无法统一;且旧引用无法被新代码访问到。 -
normalize_ship_name返回值未定义明确行为
虽然代码用or name兜底了None/空字符串,但该函数本身可能返回其他非规范化形式(如大小写不同、包含空格等),需要确认其输出是否稳定且唯一。若返回结果不可预期,仍可能造成键冲突。 -
Ship对象名称与用户传入名称不一致
注册时Ship(name=key)使用的是标准化后的名称,而非用户传入的原始名称,可能导致后续日志、界面展示或与外部系统交互时出现名称差异。 -
缺少对
normalize_ship_name的单元测试
该函数是本变更的关键依赖,但未看到相关测试覆盖,若其逻辑有误则会影响整个注册机制。
| if not destroy_ships_auto(self._ctx, from_dialog=True): | ||
| # 保留舰种覆盖全部舰种, 无可解装对象, 船坞仍满 | ||
| raise DockFullError('决战中船坞已满,且无可解装舰种') | ||
| return |
There was a problem hiding this comment.
以下是针对该代码变更的审核意见:
-
check_stop添加合理:在关键操作前调用check_stop(self._ctx.stop_event)能及时响应停止请求,避免长时间阻塞,属于明显改进。 -
_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的导航范围,或在此分支补充页面状态断言/日志。
-
destroy_ships_auto的接口变更未在片段中体现
原代码先click再调用destroy_ships_auto(self._ctx),新代码改为直接destroy_ships_auto(self._ctx, from_dialog=True)。这要求destroy_ships_auto已实现from_dialog参数并能正确处理“从对话框开始”的流程。若该函数未同步修改,会导致TypeError或行为错误,建议确认相关函数定义及调用约定。 -
移除固定点击可能影响旧流程兼容性
删除self._ctrl.click(0.38, 0.565)后,原有依赖该点击位置的流程(如关闭弹窗、切换标签等)将不再执行。如果from_dialog=True未能完全覆盖原点击操作的功能,比如某些情况下对话框并未弹出或位置发生变化,可能导致 API 调用失败。建议检查其他调用destroy_ships_auto的位置,确保行为一致。 -
缺乏测试覆盖
新增的提前返回分支和from_dialog行为是新的逻辑路径,建议补充单元测试或集成测试,覆盖“已处于目标阶段”和“船坞满但可解装/不可解装”等场景,避免回归。
综上,改动方向是积极的,但需重点验证第 2、3 点的前提条件是否成立,并确保 destroy_ships_auto 的新参数实现正确。在确认这些之前,不建议直接合并。
| # 没有可修候选,结束本轮派单。 | ||
| _log.debug('[OPS] 无可修理舰船, 结束派单 (本轮已派 {} 艘)', repaired) | ||
| break | ||
|
|
There was a problem hiding this comment.
根据代码审核,发现以下潜在问题:
-
secs == 0的处理与原逻辑语义不一致
原代码中secs == 0被视为“修理时间解析失败”,不记为成功派单也不占用浴室。修改后secs >= 0均执行repaired += 1,且通过回调_record_bath执行了occupy(0)。这会导致:- 统计的“已派单数”虚增,可能影响外部循环调度。
occupy(0)的行为不明确,可能产生无效占用或意外释放槽位,破坏浴室状态管理。
-
回调
on_accepted的调用时机与参数未在本次改动中体现
代码中page.repair_longest(blacklist=blocked, on_accepted=record)使用了新参数,但BathPage.repair_longest的实现是否已同步修改并正确回调partial(_record_bath, ctx)(即需要传递name和seconds)无法从本片段确认。若未同步修改,会直接导致TypeError或行为异常。 -
_record_bath中无条件重置slot_count可能覆盖动态配置ctx.bathroom.slot_count = ctx.config.bathroom_count
每次修理后都强制将槽位数量设为配置值,可能覆盖程序运行期间其他逻辑对
slot_count的动态调整(例如根据实际状态临时修改),存在潜在状态覆盖风险。 -
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)会让舰船“立即结束维修”,可能不符合预期。 -
循环逻辑中
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) |
There was a problem hiding this comment.
根据代码审核,发现以下问题与改进建议:
-
Python 版本兼容性:使用了
StrEnum,该枚举类型仅在 Python 3.11+ 中可用。若项目需兼容更低版本,建议改为class RepairAction(str, Enum)的方式实现。 -
冗余条件判断:
_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。
-
边界情况需明确:当
repair_seconds == 0且required is True时,当前逻辑会根据quick_threshold_seconds返回BATH或QUICK(若阈值为 0)。如果 0 秒表示“无需修复”或“异常数据”,建议显式处理,避免产生不符合预期的决策。 -
建议补充测试覆盖:特别是
required、repairing、repair_seconds、quick_threshold_seconds为None和0的边界组合,确保决策逻辑在所有合法输入下都符合预期。 -
安全性:未发现敏感信息泄露或执行外部代码的风险,此方面无需修改。
| use_quick_repair: true # 允许使用快修桶;关闭后仍可按时长阈值安排入浴。 | ||
| full_destroy: false # 船舱满了是否解装舰船 | ||
| useful_skill: false # 充分利用技能 | ||
| useful_skill_strict: false # 严格利用技能 (useful_skill 为 true 时才生效) |
There was a problem hiding this comment.
根据代码变更片段,仅涉及配置文件的调整,未包含对应的逻辑代码。作为代码审核,我提出以下几点关注与建议:
- 配置项是否已被代码实现:新增的
quick_repair_threshold_seconds字段在配置中定义,但需确认程序是否已实际读取并使用该配置。如果仅添加配置而未在逻辑中处理,则此改动无效,且可能误导用户。 - 默认值
null的兼容性:YAML 中null是合法值,但需确认下游代码对null的处理是否安全,例如避免出现None与数字比较时的类型错误,或需要明确区分“未设置”与“阈值设为0”的场景。 - 注释语义的清晰度:新注释“短于阈值立即入浴,达到阈值时优先换船,缺员才用桶”表述略显模糊。建议明确“短于阈值”与“达到阈值”的具体比较逻辑(例如小于还是小于等于),以及“入浴”“换船”“用桶”的优先级关系,避免使用者误解。
- 与现有
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 |
There was a problem hiding this comment.
该代码变更整体是对新增场景的测试覆盖,方向合理。不过有一个值得注意的潜在问题:
- 在新增的
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 |
There was a problem hiding this comment.
根据代码审核原则,发现以下问题:
-
Callable的导入位置可能导致运行时NameErrorCallable被放在if TYPE_CHECKING:块中导入,但函数注解(如Callable[[GameContext], object])如果没有from __future__ import annotations,会在函数定义时被求值。若运行时未导入Callable,测试会直接报NameError。- 建议确认文件顶部是否有
from __future__ import annotations;若没有,请将Callable移到正常导入区,或改为字符串注解。
-
GameContext类型未在片段中可见test_failed_daily_fights_let_decisive_node_run中使用了Callable[[GameContext], object]作为类型注解,但GameContext在片段中没有导入或定义。如果该名称在文件顶部未导入,同样会在运行时导致NameError。- 请确保该类型已正确导入,或使用字符串形式避免求值。
-
test_decisive_mode_only_registers_enabled_dailies的测试断言与配置含义可能不符- 配置中
auto_normal_fight=True且normal_fight_tasks=['示例计划'],但断言期望注册的触发器只有['远征'],似乎忽略了普通战斗任务。 - 如果这是有意设计(例如决战模式不执行普通战斗),建议将测试中的
auto_normal_fight设为False,或增加注释说明为何忽略,避免误导后续维护者;如果这是实现缺陷,则说明for_decisive未正确处理auto_normal_fight。
- 配置中
-
测试直接依赖私有属性/方法,脆弱性较高
- 多个测试直接访问
scheduler._queue、scheduler._triggers、scheduler._maybe_collect_expedition等私有成员。虽然当前可工作,但后续内部重构会破坏测试。建议优先通过公开接口或pytestfixture 暴露行为,减少对私有实现的依赖。 - 这属于改进建议,不影响当前正确性。
- 多个测试直接访问
除上述问题外,测试逻辑整体覆盖较充分,未发现明显安全或性能风险。请修复以上问题后合入。
| """HTTP 路由应调用公开的操作入口并创建实际执行器。""" | ||
| manager = _ExecutingTaskManager() | ||
| captured: list[ResolvedFleetSelection] = [] | ||
|
|
There was a problem hiding this comment.
根据代码审核,提出以下改进建议:
-
新增测试函数缺少 docstring
test_decisive_stop_does_not_record_a_completed_round没有像文件中其他测试那样添加说明性文档字符串,建议补充以保持测试风格一致。 -
使用
MagicMock可能使测试过于宽松
建议像test_decisive_error_result_marks_task_failed中那样,使用一个只包含run方法的轻量级FakeController类,而不是MagicMock。因为MagicMock会容忍对任意属性的访问,这可能掩盖_start_decisive中对控制器其他属性的非预期依赖,从而降低测试的准确性。 -
部分中文翻译可优化
例如"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 ( |
There was a problem hiding this comment.
以下是代码审核意见:
-
_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配置关键属性,增强测试的可控性。 -
overlay位置字典仅覆盖了三种情况,存在KeyError风险
在test_collection_does_not_recognize_non_map_or_overlay_frames中,使用dict直接索引overlay,如果参数化列表中出现其他 overlay 名称(或后续新增模板),测试会因KeyError失败。建议使用.get()并设置默认放置位置,或者通过断言确保所有传入的 overlay 都已在字典中,避免静默遗漏。 -
_settings在不同测试中的设置不一致
部分测试只设置了_repairs而未设置_settings,如果_main_loop()在某个分支访问_settings.daily_automation,会导致AttributeError。建议统一在所有相关测试中初始化_settings,或评估代码路径是否确实不会访问该属性,以避免潜在的不一致。
|
能工智人测试反馈(v1-1120):
|
决战 EX 需要按实际地图拓扑选路,并在舰船受损时衔接编队、维修和原轮次续战。本次调整将页面确认、节点交接和具名维修串联起来,避免依据旧页面继续点击,以及仅凭维修计时到期就将舰船视为可出战。
验证:重组前全量测试为 2043 通过、25 跳过;本次 8 个分类提交与重组前完整快照的 tree 完全一致。
pre-commit run --all-files、各提交 hooks 和git diff --check均通过,8 个提交的 GPG 签名均已验证。尚未进行实机验证,页面识别、选路及维修交接仍需设备验收。