From 0a525f8bd041509fa7e291e42c54ec8c8e986e17 Mon Sep 17 00:00:00 2001
From: cfdaily <cfdaily@gitee.com>
Date: Tue, 19 May 2026 14:11:15 +0800
Subject: [PATCH] auto-sync: 2026-05-19 14:11:15

---
 src/blackboard/operations.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/blackboard/operations.py b/src/blackboard/operations.py
index d52c013..edbdbc4 100644
--- a/src/blackboard/operations.py
+++ b/src/blackboard/operations.py
@@ -696,6 +696,9 @@ class Blackboard:
     ) -> dict:
         """创建 Checkpoint"""
         import uuid
+        # BUG-33: 校验 payload 结构必须含 version 字段
+        if not isinstance(payload, dict) or "version" not in payload:
+            raise ValueError("payload must be a dict containing 'version' field")
         cp_id = checkpoint_id or f"cp-{uuid.uuid4().hex[:8]}"
         conn = self._conn()
         try: