docs(m107): add product review of state semantics and evidence fallback
This commit is contained in:
@@ -0,0 +1,77 @@
|
||||
# M107 产品口径审查:BAT-002 状态语义与证据替代方案
|
||||
|
||||
日期:2026-09-21
|
||||
角色:Product/System 只读审查(本文件为唯一写入;未改代码、计划、checkpoint、STATUS、ledger)
|
||||
审查对象:`docs/plans/M107_BAT002_EVIDENCE_HARDENING.md`(P1 COMPLETE、P2 IN_PROGRESS、P3 PENDING)
|
||||
权威对读:`docs/03_PAGES_AND_UX.md:259,574`、`docs/plans/M103_BATTLE_COMPREHENSION_FEEDBACK.md`、`docs/design-authority/pages/BAT-002-live-battle/state-matrix.json`、`approved/v001/live-state-map.json`、`docs/reports/M106_UI_AUDIT_20260921.md`
|
||||
非声明:本审查不构成 Owner 验收,不覆盖 Q3–Q6、手感、听感、设备与最终美术。
|
||||
|
||||
## 1. 结论
|
||||
|
||||
1. M107 的四个动作状态语义与 BAT-002 state matrix / live-state-map **一致**,方向正确:M107-I01(forecast/committed/resolving 全部采自 phase-0 opening)确实是"夹具投影覆盖"缺陷,live-state-map 的 `focal_invariants` 明确要求 "forecast, committed source, affected target and resolved state each have a visible frame"。
|
||||
2. `opening` **不是** BAT-002 契约状态:它是 M80 九拍 phase-0 / BAT-001→BAT-002 交接边界。M107 单独命名 opening 拍是正确的,但必须在 manifest 中标为 boundary/pre-roll,不得计入 forecast/committed/resolving 覆盖;opening 拍不显示状态词是既有行为(M106 F2),属产品决策,M107 冻结范围内不得改。
|
||||
3. 静态/中性动态证据只能证"结构、ownership、槽位、边界";"状态含义是否被读懂"永远只能 Owner。若 harness 无法取得 neutral/static,§5 给出合规替代与"必须留缺口、不得声称满足三态契约"的底线。
|
||||
|
||||
## 2. 状态语义对读
|
||||
|
||||
| M107 状态 | docs/03 `BAT-002`(:574) | M103 | BAT-002 matrix / live-state-map | 一致性判定 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| opening(边界拍) | 无此状态;objective/cause/event sequence 从 waiting 起 | 九拍 phase 0 = 开场,observation 入口 | matrix 无 `opening`;live-state-map 仅有 `waiting_for_next_event` 的专属守卫("no current event reserves the same urgent-cause region for Waiting for next event") | **一致但须改名**:作为 BAT-001 交接边界采集;不得当作 forecast 覆盖 |
|
||||
| forecast | urgent cause、target relation、event sequence | 字段反馈行挂在"被选中事件"上 | `event_forecast`:event_id/tick、urgent_cause、source_actor、forecast_target_ids、action_or_rule、contact_window;guard "never claims a result" | **一致**:须采自**非 opening** 事件的提交前预览;帧上应有 target/forecast 几何而非结果 |
|
||||
| committed | 同上(event sequence 内的承诺拍) | 同上 | `action_committed`:committed_source、reserved_target_id、action_id、reach/protection rule、commit_event_id;guard "reservation remains visible" | **一致**:须在 commit 后、resolve 前采样 |
|
||||
| resolving | "real melee, ranged, magic, healing, guard, damage and defeat events"(:259) | who acted / what changed | `event_resolving`:source_to_target_path、actual_recipient、event_kind、authoritative contact/release frame;guard "contact cannot precede the authoritative event" | **一致**:采样窗口=解析中 |
|
||||
| resolved | 状态/结果可读、event sequence | why the line/readiness changed | `event_resolved`:outcome_disposition、actual_recipient、hp/resource/position delta、resolved_actor_state、causal_neighbor_event_ids、recent_event_sequence;guard "persists long enough to inspect + stable non-color shape" | **一致**:须含 delta 与持久帧 |
|
||||
| waiting(既有态) | "No current event shows `Waiting for next event`" | — | `waiting_for_next_event` 精确文案 + never blank | **一致**,M107 保持不动 |
|
||||
|
||||
补充事实与要求:
|
||||
|
||||
- **M107 采样的第一事件**:`battle_live_capture_test.gd:73-86` 在 `waiting` 后连续 `advance_battle_phase()` 采样四态;首事件即 phase-0 opening,故三帧逐字节相同(`M106_UI_AUDIT_20260921.md` F1)。修复必须在**同一个非 opening 事件**内依次采样四态,且 manifest 记录 `event_id/tick` 与来源 phase。
|
||||
- **"帧不同"不等于"投影对"**:M107 验收"the first real action state differs from opening for the right reason"要求 manifest 同时记录**变了什么 ownership**(状态词 id、target 节点出现、reservation 可见、contact 帧、delta 文本),否则计时/渲染噪声也能产生 diff。
|
||||
- **M103 覆盖说明**:M103 字段反馈行只随"被选中事件"出现;若采样的非 opening 事件不带 signature/status/movement/cast 轨迹,则本 packet 不覆盖 M103 行。这是采样选择问题,记录即可,不改契约。
|
||||
- **命名稳定**:marker 目前报 `waiting,forecast,committed,resolving,resolved,paused,invalid,loading,interrupted,outcome`;M107 若新增/更名 `opening`,manifest 应保留 matrix 状态 id 映射(`event_forecast`/`action_committed`/`event_resolving`/`event_resolved`),避免台账引用漂移。
|
||||
|
||||
## 3. 结构证据分工(静态 / 中性动态 / 终稿)
|
||||
|
||||
| 证据态 | 能证明(机器/代理) | 不能证明 |
|
||||
| --- | --- | --- |
|
||||
| static-only ownership | 世界层身份与哈希(runtime base = approved `clean-static-master.png`)、层序与 `layer-map.json` 一致、无 BAT-002 母版预载/无烤字、演员节点数与家族、尺度带、48px、16:9 contained canvas | 玩家能否在实机看清、最终美术接受 |
|
||||
| dynamic-only on neutral | 状态词/反馈/控件由引擎节点拥有、与场景艺术解耦、槽位 containment、中性底上的文字/对比、各状态词可见性(forecast..resolved 有无状态词)、130%/双语适配 | 画在真实场景上的对比(须靠终稿+ink 门)、语义是否读懂 |
|
||||
| final composite | 完整画面下的 line/corridor/ink/48px/scale、状态序列可达 | comprehension/fun、听感、手感、Owner 接受 |
|
||||
|
||||
Owner-only 清单(不得由任何证据态替代):opening 肃静是否可接受(M106 F2)、forecast→commit→contact→outcome 是否被感知为因果(Q3/Q5 邻近)、Guard/治疗/打断"值不值"(Q4)、听感与舒适度、最终美术与趣味。
|
||||
|
||||
## 4. M106 缺口在 M107 下的处理建议
|
||||
|
||||
- F1(三帧重复):M107-I01 修复,验收见 §2。
|
||||
- F2(opening 无状态词):冻结;记录为产品决策,M107 不得改 runtime。
|
||||
- F3(无 checked-in neutral/static 路径):M107-I02;主方案与替代见 §5。
|
||||
- F4/F5(dev5 无 ink/scale 断言):可在同一 harness 包内低成本补 `ui_ink_check` 扫描与 scale 断言,或继续以 M60/M77 路线门替代并注明。
|
||||
|
||||
## 5. neutral/static 取不到时的合规替代
|
||||
|
||||
**主方案(harness-only,允许)**:在采集用 SubViewport 内通过既有节点可见性隔离取两态,不新增 chrome、不改 runtime:
|
||||
- static-only:隐藏引擎文字/数值/控件节点,仅留世界层 + 演员层(+ 已批 grounding);
|
||||
- neutral dynamic:隐藏世界/演员/反馈几何,仅留状态词、反馈文本、轨道与控件,置于声明的中性底色(SubViewport 纯色或 harness 内 ColorRect);
|
||||
- manifest 记录被切换的节点集合、中性色值、还原断言。
|
||||
|
||||
**若主方案不可行(需 runtime 改动或会扰动状态机),按顺序降级并如实留缺口**:
|
||||
1. static ownership 以"代码路径 + `layer-map.json` + 运行时 base 与 `clean-static-master.png` 哈希一致 + 逐节点 census"替代,标注为 **替代证据**;
|
||||
2. dynamic 结构以"路线 ink 门 + 节点 rect/文本扫描 + 共享 token 中性对比值"替代,标注 dev5 packet 自身无 ink 断言这一缺口(同 M106 F4);
|
||||
3. 在 packet/manifest 中将字面 neutral/static 帧标为 **NOT OBTAINED**,对应审查项保持 OPEN,不声称满足 static/dynamic/final 三态契约;若 Owner 需要字面视图,另开一个 harness 计划。
|
||||
|
||||
**禁止的替代**:从终稿合成/擦除、复用 M52/M55 的中性帧充当 BAT-002、或在没有隔离记录的情况下声称"等价"。这些会制造无法追溯的证据(违反 AGENTS 的 ownership 与 earliest-boundary 规则)。
|
||||
|
||||
## 6. 对 M107 验收的补充建议(不改变其范围)
|
||||
|
||||
- P2 acceptance 增加"manifest 逐态记录 matrix 状态 id + event id/tick + 变化 ownership 项",否则"differs for the right reason"不可复核;
|
||||
- P3 明确:若 neutral/static 落入 §5 降级路径,收口文案必须写"三态契约部分未达",并保持 M106-I01/I02 相应项 OPEN;
|
||||
- 保持 M107-I03(Q3–Q6/听感/唯一性)不得由本包结案。
|
||||
|
||||
## 7. 证据索引
|
||||
|
||||
- `docs/plans/M107_BAT002_EVIDENCE_HARDENING.md`(P2 IN_PROGRESS;I01/I02/I03)
|
||||
- `docs/reports/M106_UI_AUDIT_20260921.md`(F1–F5、三态判定)
|
||||
- `docs/design-authority/pages/BAT-002-live-battle/state-matrix.json`(waiting/forecast/committed/resolving/resolved 的 required reading 与 guard)
|
||||
- `docs/design-authority/pages/BAT-002-live-battle/approved/v001/live-state-map.json`(focal_invariants:四态各有可见帧)
|
||||
- `docs/03_PAGES_AND_UX.md:259,574`;`docs/plans/M103_BATTLE_COMPREHENSION_FEEDBACK.md`
|
||||
- `runtime/tests/dev5/battle_live_capture_test.gd:70-121`(现行采样点)
|
||||
Reference in New Issue
Block a user