diff --git a/plan.py b/plan.py index 3554b7b..4e6f1a3 100644 --- a/plan.py +++ b/plan.py @@ -996,38 +996,22 @@ def render_md(d: dict) -> str: class StaleSnapshot(RuntimeError): - """快照还在,但太旧、不能拿来当今天的计划用。调用方接住它回落到实时装配。""" + """旧快照无法证明在有效期内;查询明确失败,不回落实时装配。""" def snapshot_fresh_enough(snap: dict) -> tuple: - """这份快照够不够新,能不能当今天的计划直接下发。返回 (能不能, 一句原因)。 + """旧格式快照的时间守卫,返回 (是否可用, 原因)。 - 为什么需要这道守卫(2026-09-10,台账 057): 快照是出计划那一刻的定格,而实时装配读的是 - 此刻的证据线。实测两条路比对,代码序列一模一样,但候选卡名次、判决、依据这些字段会有 - 实质差异 —— 快照出得越早、差得越多。拿一份过时的快照下发,等于让下游用旧判决。 + 2026-10-15,台账 064:已发布内容与代码部署相互独立。新代码仍可读有效期内 + 的旧计划,保留原 plan_version 并注明追溯不完整,不能因代码版本不同而失效, + 也不能查询时用当前证据重装配。新完整版本不使用旧格式的这道兼容守卫。 - 两条判据,任一不满足就退回实时装配(也就是这次改动之前的行为,不会变坏): - · 代码版本要和现在跑的一致。版本变了说明判决逻辑可能变了,用旧代码算的那份不算数。 - 正常情况下两者相同——出计划任务和接口进程跑的是同一份部署;只有"刚部署了新代码、 - 还没重新出计划"这个窗口里会不一致,而那正是该回落的时候。 - · 生成时刻距今不超过 PLAN_SNAPSHOT_MAX_AGE_HOURS 小时(默认十六)。 - - **时间判据用的是"距今多久",不是"晚于今天几点"**:容器跑在世界协调时上(实测 - 2026-09-10 早上七点十分出的计划,快照里记的是 2026-09-09T23:10),拿本地日期算界会 - 差八小时,把新鲜的快照判成过期。距今多久与时区无关,怎么部署都不会算错。 + 沿用 PLAN_SNAPSHOT_MAX_AGE_HOURS(默认十六小时)及未来时刻检查。 + 有时区的生成时刻按自身时区算经过时间;旧无时区值保持原运行时解释,不能 + 为旧档补造时区或新的决策版本。显式历史查询不受当前时间限制。 """ - import version max_age_h = float(os.environ.get("PLAN_SNAPSHOT_MAX_AGE_HOURS", "16")) gen = str(snap.get("generated_at") or "") - ver = str(snap.get("plan_version") or "") - now_ver = "" - try: - now_ver = str(version.git_short_rev() or "") - except Exception: # noqa: BLE001 —— 取不到版本就不拿这条卡人 - now_ver = "" - if now_ver and ver and ver != now_ver: - return False, (f"快照是用代码版本 {ver} 出的,现在跑的是 {now_ver};" - f"判决逻辑可能已经变了,本次按实时装配") if not gen: return False, "快照没有生成时刻,判不了新旧" try: @@ -1037,7 +1021,7 @@ def snapshot_fresh_enough(snap: dict) -> tuple: age_h = (dt.datetime.now(g.tzinfo) - g).total_seconds() / 3600.0 if age_h > max_age_h: return False, (f"快照出于 {gen},距今 {age_h:.1f} 小时,超过 {max_age_h:g} 小时的界;" - f"证据线可能已经变了,本次按实时装配") + f"请检查已发布计划,查询不会实时重装配") if age_h < -1: # 生成时刻在未来:多半是两边时区不一致,别当新鲜的用 return False, f"快照的生成时刻 {gen} 在未来 {-age_h:.1f} 小时,判不了新旧" return True, "" diff --git a/test_plan_snapshot.py b/test_plan_snapshot.py index 399774f..5845310 100644 --- a/test_plan_snapshot.py +++ b/test_plan_snapshot.py @@ -158,7 +158,7 @@ def test_freshness_guard(): if cur: ok3, why3 = plan.snapshot_fresh_enough( snap((now - _dt.timedelta(hours=2)).isoformat(timespec="seconds"), "deadbee")) - t("代码版本对不上就不可用(判决逻辑可能变了)", not ok3 and "代码版本" in why3, why3) + t("代码部署不让有效期内已发布的旧计划失效", ok3, why3) ok4, _ = plan.snapshot_fresh_enough(snap("")) t("没有生成时刻的快照不可用", not ok4) diff --git a/test_plan_versions.py b/test_plan_versions.py index f1065b3..6e1dcfb 100644 --- a/test_plan_versions.py +++ b/test_plan_versions.py @@ -126,6 +126,26 @@ class VersionsTest(unittest.TestCase): self.assertEqual(small['main'][0]['research_rank'], big['main'][0]['research_rank']) self.assertEqual(big['main'][1]['research_rank'], 2) + def test_latest_legacy_survives_code_deployment_without_reassembly(self): + import version + legacy = sample() + legacy.update(plan_version='old-code', generated_at=( + dt.datetime.now(dt.timezone.utc) - dt.timedelta(hours=2)).isoformat()) + path = Path(self.root) / ('plan_' + DAY + '.json') + path.write_text(json.dumps(legacy), encoding='utf-8') + original = path.read_bytes() + with patch.object(plan.config, 'PLAN_SNAPSHOT_DIR', self.root), \ + patch.object(version, 'git_short_rev', return_value='new-code'), \ + patch.object(plan, 'collect', side_effect=AssertionError('查询禁止重装配')), \ + patch.object(plan.db, 'read_pg', side_effect=AssertionError('查询禁止回源')): + latest = plan.from_snapshot(top=1) + dated = plan.from_snapshot(DAY, top=1) + self.assertEqual(latest, dated) + self.assertEqual(latest['plan_version'], 'old-code') + self.assertEqual(latest['traceability'], 'legacy_unverified') + self.assertIsNone(latest.get('decision')) + self.assertEqual(path.read_bytes(), original) + def test_changed_review_all_exports_share_research(self): a = self.publish() p = sample()