Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions autowsgr/combat/handlers.py
Original file line number Diff line number Diff line change
Expand Up @@ -529,7 +529,7 @@ def _click_result_until_closed(
- 命中 *phase* → 点击被动画吞掉, 立即重试点击 (重试即动画等待);
- 识别不到 (过渡帧/页面渐变中) → **只等待不点击**: 对切换中的
页面盲目连点会穿透中间页, 落点若是 PROCEED 对话框还可能误触
按钮。轮询窗口耗尽仍认不出才继续点击推进 (真正的未知页)。
按钮。窗口耗尽时,决战战果交回决战流程识别地图或浮窗,其他情况继续点击。

参数
----------
Expand Down Expand Up @@ -570,7 +570,9 @@ def _click_result_until_closed(
_log.debug('[Combat] {} 已推进到 {}', phase.name, current.name)
return
else:
# 整个轮询窗口都无法识别 → 未知页, 继续点击推进
if phase == CombatPhase.RESULT and self._plan.mode == CombatMode.DECISIVE:
_log.debug('[Combat] 决战战果点击后持续无法识别,交回决战流程')
return
_log.debug(
'[Combat] {} 点击后持续无法识别 (第 {} 次), 继续点击', phase.name, attempt
)
Expand Down
33 changes: 17 additions & 16 deletions autowsgr/combat/node_fusion/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
- `map.py`:地图校验、能力声明、路径枚举、快照指纹及 native 舰类集合。
- `geometry.py`:资料不足时的几何证据组合,以及已有路由的可达性约束。
- `position.py`:只检测本帧船位,不保存节点状态或复用旧船位。
- `enemy.py`:从同一索敌截图采集六槽、阵型和迂回按钮证据。
- `enemy.py`:从同一张索敌截图识别敌方编队每个位置的舰种、敌方阵型和迂回按钮。
- `integration.py`:出征级 `TrackingSession`,适配观测、确认当前节点、保存诊断日志。
- `coordinates.py`:旧 YAML 坐标及入口读取,保留缺失信息,不包含追踪算法。
- `replay.py`:离线重放;`tools/node_fusion/replay.py` 只是命令入口。
Expand Down Expand Up @@ -43,9 +43,9 @@ NULL、REWARD、LOSS 可以静默经过,几何证据按真实航段逐段评
战斗节点构成的环路可重复经过;纯静默环路明确报告元数据异常,避免无限枚举。
距离与射线按加权混合组成一个几何因子,不是两次独立投票。帧间隔越大,方向权重越低。

六槽按位置对应;舰类集合与误识别类别数直接来自实际安装的 native `VesselType`。
同一次遭遇共享敌情变体,阵型与舰类联合匹配。未知槽位、NO、未知阵型与未检出迂回按钮
作为缺失证据。整帧异常项保留相关误识别的可能;重复读取只更新同一遭遇的聚合因子,
模型按敌方编队顺序逐个位置比对舰种。舰种集合与误识别类别数来自当前安装的 native `VesselType`。
同一次遭遇共享敌情变体,阵型与舰种联合匹配。某个位置的舰种未知或识别为 `NO` 时,跳过该位置。
阵型未知或未检出迂回按钮时也跳过相应证据。整帧异常项保留相关误识别的可能;重复读取只更新同一遭遇的聚合因子,
不按轮询次数连乘。每次真实迂回点击仅分配一次结果先验。

模型默认参数集中在 `FusionProfile`。舰类/阵型正确识别率初值 0.9、整帧异常权重 0.1
Expand All @@ -72,8 +72,9 @@ Tracking JSON,文件不存在时回退读取同名旧 YAML(当前 20260930
未知节点类型不会被当作 `NULL` 或战斗点;出现索敌、阵型等页面只确认新证据支持的位置,
不会自动前进一条边。只知道坐标时,没有本航段的新船位证据就不能确认下一个节点。

决战的 `MapData.tracking_map(chapter, stage)` 从中文 `enemy_spec.yaml` 构造顺序小关。
移除旧数组首位占位后规范成有序六槽,空槽保留 `None`;缺敌情、敌方阵型和坐标保持未知。
决战的 `MapData.tracking_map(chapter, stage)` 从 18 份 EX YAML 将真实分支投影为可观测字母。
有敌情记录时,按编队顺序返回六个位置的中文舰种简称,空位记为 `None`。没有敌情记录时返回 `[]`。
敌方阵型和坐标在资料中缺失时也保持未知。
`AF→机场`、`BG→大巡`、`BBG→导战`,补给舰与机场独立处理。决战不伪造起点 `0`
或几何资料,由显式决战场景使用其确定推进规则。

Expand Down Expand Up @@ -108,7 +109,7 @@ log:
| `history_prior` | 历史状态和合法地图转移产生的候选权重 |
| `distance` | 全图船位距离、似然及归一化候选,仅作独立观察 |
| `ray` | 全图射线距离、有效帧间隔、混合权重及不可用原因 |
| `enemy` | 六槽、阵型、联合敌情的各节点评分与候选 |
| `enemy` | 敌方编队每个位置的舰种、阵型、迂回按钮识别结果,以及据此计算的候选节点评分 |
| `geometry` | 模型实际采用的航段评分,或降级后的节点几何评分 |
| `fusion` | 最终节点、航行目的点、最佳路线和历史修订 |

Expand All @@ -131,33 +132,33 @@ log:
## 识别校验

会话结束时核对 native 敌方舰类识别:全程与地图签名一致则保持静默;出现不符时按节点
汇总 `[NodeFusion校验]` WARNING,携带模式、地图/小关、节点、槽位、期望中文舰类、
native 原始识别码及中文解释、native 版本,供用户向维护者反馈。每项还保留观测
汇总 `[NodeFusion校验]` WARNING,列出模式、地图/小关、节点、敌舰在编队中的位置、
资料记载的舰种、识别到的舰种及其原始代码、native 版本,供用户向维护者反馈。每项还保留观测
`event_id` 与遭遇 `encounter_id`,便于关联采集记录。它不参与战斗控制,不自动修改
native 参数或 `FusionProfile`,也不因页面轮询重复告警。

参照节点由独立证据确定:排除本次出征的全部敌情读数,用地图、船位和页面历史重新
平滑定位,保留原场景和初始条件,要求权重至少 0.95 且与最佳历史路线一致。决战可使用
确定 A、经确认的推进和地图字母观测。该阈值是模型权重,不是校准后的准确率。
每次遭遇只取最早索敌帧,保留
首次识别失败;后续证据可以修正此前标签,校验不改写原始观测或已执行动作。只有节点
全部合法敌情变体中一致的舰类槽位才用于核对,不用待测结果挑选模板。
首次识别失败;后续证据可以修正此前标签,校验不改写原始观测或已执行动作。
一个节点可能有多种敌方编队。只有这些编队在同一位置上的舰种都相同时,才核对该位置的识别结果。

变体分歧槽、空槽、NO/未知原始码无法核对。无法独立定位时保留原始样本,不生成具有
资料中该位置为空、识别结果为 `NO` 或代码未知时,跳过该位置。无法独立定位时保留原始样本,不生成具有
确定节点标签的异常结论。原始码以当前安装的 native 枚举解释,例如机场通常输出
`Airfield`,资料里的旧 `AF` 只作为机场迁移别名。

反馈模块显式接收 `CombatPlan.mode`,不使用 native 识别布局参数 `fight` 推断战斗模式。

| 模式与模板 | native 原始读数 | 处理 |
| --- | --- | --- |
| 普通战第 3 槽(数组索引 2),期望非补给 | `AP` | 战利品补给豁免 |
| 普通战其它槽,期望非补给 | `AP` | 正常反馈不符 |
| 活动/决战任何槽,期望非补给 | `AP` | 正常反馈不符 |
| 普通战敌方编队第三个位置(数组索引 2),资料记载非补给 | `AP` | 可能是战利品补给舰,免报告警 |
| 普通战敌方编队的其他位置,资料记载非补给 | `AP` | 报告舰种不符 |
| 活动/决战敌方编队的任意位置,资料记载非补给 | `AP` | 报告舰种不符 |
| 任意模式,期望补给 | `AP` | 正常匹配,静默 |
| 全部合法变体整队都是补给 | 任意有效识别码 | 资料可能过期,独立整队模板豁免 |

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

## 回放

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 时,跳过该位置”,后一句说“阵型未知或未检出迂回按钮时也跳过相应证据”。二者一个是“位置”,一个是“证据”,建议统一为比如“该位置的相应证据不参与匹配”,避免阅读时混淆。

Expand Down
12 changes: 6 additions & 6 deletions autowsgr/combat/node_fusion/calibration.py
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
"""使用不含敌情观测的历史定位核对 native 敌舰识别;不符时由会话告警请求反馈。

参照节点仍是独立证据形成的估计,并非人工真值。只比较所有合法敌情变体均一致的
字段,避免用待测识别结果选择最相似的模板,再把它当作正确答案。普通战第 3 槽
战利品补给不告警;整队 AP 过期签名的资料豁免是独立规则。
字段,避免用待测识别结果选择最相似的模板,再把它当作正确答案。普通战敌方编队第三个位置
出现战利品补给舰时不报警。整队都是补给舰的过期地图记录有单独的豁免规则。
"""

from __future__ import annotations
Expand Down Expand Up @@ -35,7 +35,7 @@

@dataclass(frozen=True)
class SlotMismatch:
"""确认定位遭遇中与地图签名不符的槽位;保留原始识别码便于反馈排查。"""
"""节点已确认时,记录哪艘敌舰的舰种与地图资料不符,并保留原始识别代码。"""

node: str
slot: int
Expand Down Expand Up @@ -94,7 +94,7 @@ def _slot_mismatches(
for index in range(6):
expected = {item.ships[index] if index < len(item.ships) else None for item in variants}
if len(expected) != 1 or expected == {None}:
# 变体分歧或空槽没有唯一真值,不可核对。
# 同一位置在各编队里舰种不同,或一直空着,都无法核对。
continue
true_ship = next(iter(expected))
if true_ship not in SHIP_TYPES:
Expand All @@ -109,7 +109,7 @@ def _slot_mismatches(
if value == true_ship:
continue
if value == _AP_SHIP and combat_mode == CombatMode.NORMAL and index == 2:
# 只有普通战第 3 槽会被战利品补给替换;活动与决战没有此机制。
# 普通战敌方编队的第三个位置可能出现战利品补给舰。
continue
found.append((index + 1, true_ship, code, value))
return found
Expand All @@ -118,7 +118,7 @@ def _slot_mismatches(
def recognition_mismatches(
tracker: FusionTracker, *, combat_mode: str = CombatMode.NORMAL
) -> list[SlotMismatch]:
"""确认定位遭遇中与地图签名不符的槽位;每个独立遭遇只取最早索敌帧。"""
"""用每次遭遇的首张索敌画面,核对已确认节点的敌方编队中哪些位置舰种不符。"""
mismatches: list[SlotMismatch] = []
if not any(obs.phase == 'SPOT_ENEMY_SUCCESS' for obs in tracker.observations):
return mismatches
Expand Down
13 changes: 7 additions & 6 deletions autowsgr/combat/node_fusion/enemy.py
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
"""从同一索敌截图采集舰类槽位、阵型和迂回按钮证据。
"""从同一张索敌截图识别敌方编队每个位置的舰种、敌方阵型和迂回按钮。

这里只记录识别结果,不推断节点。``None`` 表示没有可用证据;尤其 native 的
``NO`` 同时可能表示空槽或识别失败,不能据此确定该槽没有舰船。
识别结果中的 ``None`` 表示该位置的舰种未知。native 返回 ``NO`` 有两种可能:
该位置没有舰船,或识别失败。
"""

from __future__ import annotations
Expand Down Expand Up @@ -38,10 +38,11 @@

@dataclass(frozen=True, slots=True)
class EnemyObservation:
"""一次截图的原始观察,六槽顺序与现有扫描区域相同。
"""一张索敌截图的识别结果,按敌方编队的六个位置依次记录。

``ships`` 使用实际安装 native 枚举的中文舰类名;例如 ``Airfield`` 映射为机场,
``raw_slots`` 保留原码。无效槽数不补齐原始结果,而令全部六槽证据缺失。
``raw_slots`` 保留 native 返回的原始舰种代码,``ships`` 保存对应的中文名称,
例如 ``Airfield`` 对应机场。若返回的代码数量不是六个,保留原始代码,
将该帧全部舰种记为未知。
OCR 和模板分数只是各识别器的原始分数,不代表节点正确概率。
"""

Expand Down
4 changes: 2 additions & 2 deletions autowsgr/combat/node_fusion/factors.py
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@ def _fleet_factor(self, fleet: EnemyVariant, evidence: tuple[_EnemySignature, ..
"""已知敌情变体使用联合似然;未知变体不调用此项。"""
log_model = self._fleet_score(fleet, evidence)
if evidence not in self._background_cache:
# 异常帧可能整体像另一支舰队,不能把它当作各槽独立随机错误。
# 一帧可能把整队识别成另一支舰队,多个位置的错误可能相关。
# 整帧混合项限制这种一致错误带来的过大优势。
scores = np.array([self._fleet_score(fleet, evidence) for fleet in self._all_variants])
self._background_cache[evidence] = _logsum(scores) - math.log(len(scores))
Expand Down Expand Up @@ -151,7 +151,7 @@ def diagnostics(self, obs: FusionObservation) -> dict[str, Any]:
enemy.detour,
)
if not any(signature.ships) and signature.formation is None and signature.detour is None:
return {'available': False, 'reason': '六槽、阵型及迂回信息均缺失', 'weights': {}}
return {'available': False, 'reason': '未识别到敌方舰种、阵型或迂回按钮', 'weights': {}}
robust_scores: dict[str, float] = {}
supported_nodes = []
for name, node in self.map_data.nodes.items():
Expand Down
4 changes: 2 additions & 2 deletions autowsgr/combat/node_fusion/integration.py
Original file line number Diff line number Diff line change
Expand Up @@ -299,12 +299,12 @@ def finish(self) -> None:
by_node.setdefault(item.node, []).append(item)
for node, items in by_node.items():
detail = ';'.join(
f'槽{item.slot} {item.expected}→{item.code}({item.recognized}) '
f'敌方编队第 {item.slot} 个位置预期为{item.expected},识别为{item.recognized}({item.code})'
f'[事件{item.event_id}, 遭遇{item.encounter_id}]'
for item in items
)
_log.warning(
'[NodeFusion校验] 舰类识别与地图签名不符,请反馈:模式 {} 地图 {} 节点 {}:{}(native {})',
'[NodeFusion校验] 敌舰舰种与地图资料不符,请反馈:模式 {} 地图 {} 节点 {}:{}(native {})',
self.combat_mode,
self._map_label,
node,
Expand Down
2 changes: 1 addition & 1 deletion autowsgr/combat/node_fusion/map.py
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@
_EVENT_MAP_ROOT = _MAP_ROOT.parent / 'event'
_SILENT_TYPES = frozenset({'NULL', 'REWARD', 'LOSS'})
_NODE_TYPES = _SILENT_TYPES | {'FIGHT', 'BOSS', 'LITTLE_BOSS', 'AIR_ATTACK', 'SPECIAL_POINT'}
# 从实际安装的 native 枚举取得中文舰类,空槽哨兵不属于敌舰类别。
# 从当前安装的 native 枚举取得中文舰种,排除代表空位或识别失败的 NO。
SHIP_TYPES = frozenset(
value.as_chinese()
for name in dir(VesselType)
Expand Down
2 changes: 1 addition & 1 deletion autowsgr/context/bathroom.py
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
-----------------------
``available_time`` 仅跟踪**本脚本派出的修理**: :meth:`BathRoom.occupy` 在
成功派修后记录该槽释放时间。配合 ``BathPage`` 选择修理 overlay 的点击反馈
(``_try_wait_overlay_close``: overlay 关闭 = 修成功 / 未关 = 浴场满) 实现:
(``wait_repair_accepted``: overlay 关闭 = 修成功 / 未关 = 浴场满) 实现:

- 有空闲槽才派修 (:meth:`is_available`);
- 跟踪已派修理的进度 (释放时间戳自然到期 = 槽回收);
Expand Down
10 changes: 6 additions & 4 deletions autowsgr/context/game_context.py
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@
from dataclasses import dataclass, field
from typing import TYPE_CHECKING

from autowsgr.constants import normalize_ship_name
from autowsgr.infra.logger import get_logger
from autowsgr.types import ShipDamageState
from autowsgr.ui.stack import UIStack
Expand Down Expand Up @@ -136,10 +137,11 @@ def fleet(self, fleet_id: int) -> Fleet:
return self.fleets[fleet_id - 1]

def get_ship(self, name: str) -> Ship:
"""按名称获取舰船, 不存在则自动注册。"""
if name not in self.ship_registry:
self.ship_registry[name] = Ship(name=name)
return self.ship_registry[name]
"""首次实见时登记舰名,同船别名共用伤情和维修记录。"""
key = normalize_ship_name(name) or name
if key not in self.ship_registry:
self.ship_registry[key] = Ship(name=key)
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 的单元测试
    该函数是本变更的关键依赖,但未看到相关测试覆盖,若其逻辑有误则会影响整个注册机制。

Expand Down
22 changes: 19 additions & 3 deletions autowsgr/context/ship.py
Original file line number Diff line number Diff line change
Expand Up @@ -45,6 +45,9 @@ class Ship:
repairing: bool = False
"""是否由上层标记为修理中 (手动设置/清除, 决战只读)。"""

repair_recheck_at: float = 0.0
"""看见维修标记但不知道结束时间时,下次核实该舰伤情的时刻。"""

# ── 计算属性 ──

@property
Expand All @@ -57,7 +60,11 @@ def health_ratio(self) -> float:
@property
def is_repairing(self) -> bool:
"""舰船是否正在修理中。"""
return self.repairing or time.time() < self.repair_end_time
return (
self.repairing
or self.damage_state == ShipDamageState.REPAIRING
or time.time() < self.repair_end_time
)

@property
def available(self) -> bool:
Expand All @@ -74,8 +81,17 @@ def set_repair(self, duration_seconds: int) -> None:
duration_seconds:
修理时长 (秒)。0 表示快修 (立即完成)。
"""
self.repair_end_time = time.time() + duration_seconds
self.damage_state = ShipDamageState.NORMAL
if duration_seconds > 0:
self.record_bath(time.time() + duration_seconds)
else:
self.repair_end_time = self.repair_recheck_at = 0.0
self.damage_state = ShipDamageState.NORMAL

def record_bath(self, deadline: float) -> None:
"""确认入浴后记录结束时间,到期仍需观察这艘舰才能确认伤情。"""
self.repair_end_time = deadline
self.repair_recheck_at = 0.0
self.damage_state = ShipDamageState.REPAIRING

def needs_repair(self, mode: RepairMode) -> bool:
"""根据修理策略判断是否需要入浴。"""
Expand Down
Loading
Loading