Skip to content

feat(miracle): 明确定义策略状态与正式 IG 合同 - #21

Draft
thugongheng wants to merge 1 commit into
codex/24-miracle-core-mechanisms-hardening-v1-20260730from
codex/24-miracle-ig-v2-contract-20260803
Draft

feat(miracle): 明确定义策略状态与正式 IG 合同#21
thugongheng wants to merge 1 commit into
codex/24-miracle-core-mechanisms-hardening-v1-20260730from
codex/24-miracle-ig-v2-contract-20260803

Conversation

@thugongheng

Copy link
Copy Markdown
Collaborator

变更内容

这是 24_miracle 的堆叠 PR A,基于 PR #18 当前 head。

  • 将决策上下文正式定义为 z = (s, m):Judge observation 与显式、连续、可序列化的 if-else 策略状态。
  • 冻结 62 项 MIRACLE_* 配置,并为每个决策点绑定完整 canonical A(s)
  • 统一正式 IG 合同:KL(new || old)epsilon = 0.01、自然对数、新策略 occupancy,主值为逐决策 KL trace 的算术平均,单位为 nats / decision
  • 对缺失或不完整科学证据保持 null/incomplete,不补零;从有序 decision records 重算 tracking/report 汇总。
  • 增加显式状态、IG 数学合同、Decision KL、iteration、tracking 和 report 的回归测试。

原因

24_miracle 建立唯一、可复现、可审计的决策空间和信息增益口径,避免策略内部状态、合法动作空间或上传汇总造成不可验证的指标漂移。

范围边界

本 PR 不包含:

  • H08-v2 真实回放 Adapter、Manifest 或 HumanReplaySkill 批准;
  • IG、胜率、Elo 曲线产物;
  • 懒人版服务器迭代;
  • Harness、SOTA 或 RL 工作。

这些内容将分别通过后续堆叠 PR B、C 交付。

验证

  • Linux / Python 3.11.15 LF 等价隔离快照:320 passed10 subtests passed0 failed0 skipped
  • compileall src tests tools:通过。
  • git diff --check:通过。
  • 26 个路径,patch 299,956 bytes,低于 350,000 bytes 限制。
  • strict UTF-8、LF only、无 BOM/CR,未包含个人绝对路径或凭据。

@thugongheng thugongheng changed the title feat(miracle): formalize policy IG and explicit state feat(miracle): 明确定义策略状态与正式 IG 合同 Aug 3, 2026
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.

1 participant