diff --git a/agents/haonan/workspace/dev-workflow/stats.py b/agents/haonan/workspace/dev-workflow/stats.py
index 3abc851..84b5aba 100644
--- a/agents/haonan/workspace/dev-workflow/stats.py
+++ b/agents/haonan/workspace/dev-workflow/stats.py
@@ -86,8 +86,15 @@ def record_event(
     
     Returns:
         bool: 记录是否成功
+    
+    Raises:
+        TypeError: metadata 不是 dict 类型时
     """
     try:
+        # metadata 类型校验
+        if metadata is not None and not isinstance(metadata, dict):
+            raise TypeError(f"metadata 必须是 dict 类型，当前为: {type(metadata).__name__}")
+        
         # 过滤敏感数据
         safe_metadata = _filter_sensitive_data(metadata or {})