fix: handle text list index normalization

Author: BlueSkyXN

core/converter.py

@@ -162,7 +162,7 @@ def _normalize_number_index_value(self, value: Any) -> Optional[str]:
         return str(number)
 
     def _normalize_timestamp_index_value(self, value: Any) -> Optional[str]:
-        """规范化日期索引值为飞书日期字段使用的毫秒时间戳。"""
+        """规范化日期索引值，统一为按天比较的 ISO 日期字符串。"""
         if self._is_empty_value(value):
             return None
 
@@ -258,7 +258,17 @@ def _normalize_index_value(
             if field_type == 1 or all(
                 isinstance(item, dict) and "text" in item for item in values
             ):
-                return "".join(str(item.get("text", "")) for item in values)
+                text_parts = []
+                for item in values:
+                    if isinstance(item, dict) and "text" in item:
+                        text_parts.append(str(item.get("text", "")))
+                    else:
+                        item_value = self._normalize_index_value(item)
+                        if item_value is not None:
+                            text_parts.append(item_value)
+                if not text_parts:
+                    return None
+                return "".join(text_parts)
 
             normalized_items = [
                 self._normalize_index_value(item, field_type) for item in values

tests/test_converter.py

@@ -169,6 +169,17 @@ def test_get_index_value_hash_rich_text_matches_plain_text(self):
 
         assert plain_hash == rich_text_hash
 
+    def test_get_index_value_hash_text_list_matches_plain_text(self):
+        """测试文本字段中 list[str] 与普通文本生成相同索引哈希"""
+        converter = DataConverter(TargetType.BITABLE)
+        plain_row = pd.Series({"ID": "AB"})
+        text_list_row = pd.Series({"ID": ["A", "B"]})
+
+        plain_hash = converter.get_index_value_hash(plain_row, "ID", {"ID": 1})
+        text_list_hash = converter.get_index_value_hash(text_list_row, "ID", {"ID": 1})
+
+        assert plain_hash == text_list_hash
+
     def test_get_index_value_hash_date_string_matches_timestamp(self):
         """测试本地日期字符串和飞书日期时间戳生成相同索引哈希"""
         converter = DataConverter(TargetType.BITABLE)