chore: import private baseline from gitea state

plugin-templates/MaiBot-Napcat-Adapter/codecs/inbound/text.py

@@ -0,0 +1,90 @@
+"""NapCat 入站纯文本与二进制辅助。"""
+
+from __future__ import annotations
+
+from typing import Any, Mapping
+
+import base64
+
+from ...types import NapCatSegments
+
+
+class NapCatInboundTextMixin:
+    """封装入站纯文本与二进制辅助逻辑。"""
+
+    def build_plain_text(self, raw_message: NapCatSegments) -> str:
+        """从标准消息段中提取可展示的纯文本。
+
+        Args:
+            raw_message: 标准化后的消息段列表。
+
+        Returns:
+            str: 用于 Host 展示和命令判断的纯文本内容。
+        """
+        plain_text_parts: list[str] = []
+        for item in raw_message:
+            if not isinstance(item, Mapping):
+                continue
+            item_type = str(item.get("type") or "").strip()
+            item_data = item.get("data")
+            if item_type == "text":
+                plain_text_parts.append(str(item_data or ""))
+            elif item_type == "at" and isinstance(item_data, Mapping):
+                at_target_name = str(
+                    item_data.get("target_user_cardname")
+                    or item_data.get("target_user_nickname")
+                    or item_data.get("target_user_id")
+                    or ""
+                ).strip()
+                if at_target_name:
+                    plain_text_parts.append(f"@{at_target_name}")
+            elif item_type == "reply":
+                plain_text_parts.append("[reply]")
+            elif item_type == "forward":
+                plain_text_parts.append("[forward]")
+            elif item_type in {"image", "emoji", "voice"}:
+                plain_text_parts.append(f"[{item_type}]")
+
+        plain_text = "".join(part for part in plain_text_parts if part).strip()
+        return plain_text or "[unsupported]"
+
+    @staticmethod
+    def _encode_binary(binary_data: bytes) -> str:
+        """将二进制内容编码为 Base64 字符串。
+
+        Args:
+            binary_data: 待编码的二进制内容。
+
+        Returns:
+            str: Base64 编码字符串。
+        """
+        return base64.b64encode(binary_data).decode("utf-8")
+
+    @staticmethod
+    def _decode_binary(binary_base64: str) -> bytes:
+        """将 Base64 字符串解码为二进制内容。
+
+        Args:
+            binary_base64: Base64 字符串。
+
+        Returns:
+            bytes: 解码后的二进制内容。
+        """
+        return base64.b64decode(binary_base64)
+
+    @staticmethod
+    def _normalize_numeric_segment_value(value: Any) -> Any:
+        """将可安全识别的数字字符串转为整数。
+
+        Args:
+            value: 原始字段值。
+
+        Returns:
+            Any: 规范化后的字段值。
+        """
+        if isinstance(value, str):
+            stripped_value = value.strip()
+            if stripped_value.isdigit():
+                return int(stripped_value)
+            return stripped_value
+        return value