add talk and conversation

src/classes/relation.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from enum import Enum
+from typing import TYPE_CHECKING, List
 
 
 class Relation(Enum):
@@ -20,6 +21,19 @@ class Relation(Enum):
     def __str__(self) -> str:
         return relation_display_names.get(self, self.value)
 
+    @classmethod
+    def from_chinese(cls, name_cn: str) -> "Relation|None":
+        """
+        依据中文显示名解析关系；无法解析返回 None。
+        """
+        if not name_cn:
+            return None
+        s = str(name_cn).strip()
+        for rel, cn in relation_display_names.items():
+            if s == cn:
+                return rel
+        return None
+
 
 relation_display_names = {
     # 血缘（先天）
@@ -70,3 +84,54 @@ def get_reciprocal(relation: Relation) -> Relation:
     """
     return RECIPROCAL_RELATION.get(relation, relation)
 
+
+# ——— 新增：评估两名角色可能新增的后天关系 ———
+if TYPE_CHECKING:
+    from src.classes.avatar import Avatar
+
+
+def get_possible_post_relations(from_avatar: "Avatar", to_avatar: "Avatar") -> List[Relation]:
+    """
+    评估“to_avatar 相对于 from_avatar”可能新增的后天关系集合（方向性明确）。
+
+    清晰规则：
+    - LOVERS（情侣）：要求男女异性；若已存在 to->from 的相同关系则不重复
+    - MASTER（师傅）：要求 to.level >= from.level + 20
+    - APPRENTICE（徒弟）：要求 to.level <= from.level - 20
+    - FRIEND（朋友）：始终可能（若未已存在）
+    - ENEMY（仇人）：始终可能（若未已存在）
+
+    说明：本函数只判断“是否可能”，不做概率与人格相关控制；概率留给上层逻辑。
+    返回的是 Relation 列表，均为 to_avatar 相对于 from_avatar 的候选。
+    """
+    # 方向相关：检查 to->from 已有关系，避免重复推荐
+    existing_to_from = to_avatar.get_relation(from_avatar)
+
+    candidates: list[Relation] = []
+
+    # 基础信息（Avatar 定义确保存在）
+    level_from = from_avatar.cultivation_progress.level
+    level_to = to_avatar.cultivation_progress.level
+
+    # - FRIEND
+    if existing_to_from != Relation.FRIEND:
+        candidates.append(Relation.FRIEND)
+
+    # - ENEMY
+    if existing_to_from != Relation.ENEMY:
+        candidates.append(Relation.ENEMY)
+
+    # - LOVERS：异性（Avatar 定义确保性别存在）
+    if from_avatar.gender != to_avatar.gender and existing_to_from != Relation.LOVERS:
+        candidates.append(Relation.LOVERS)
+
+    # - 师徒（方向性）：
+    #   MASTER：to 是 from 的师傅 → to.level >= from.level + 20
+    #   APPRENTICE：to 是 from 的徒弟 → to.level <= from.level - 20
+    if level_to >= level_from + 20 and existing_to_from != Relation.MASTER:
+        candidates.append(Relation.MASTER)
+    if level_to <= level_from - 20 and existing_to_from != Relation.APPRENTICE:
+        candidates.append(Relation.APPRENTICE)
+
+    return candidates
+