add choice helper

src/classes/single_choice.py

@@ -80,3 +80,25 @@ async def make_decision(
          choice = options[0]["key"]
 
     return choice
+
+
+def format_swap_choice_desc(new_item: Any, old_item: Any | None, item_type_name: str) -> str:
+    """
+    生成替换装备/功法时的决策描述文本。
+    
+    Args:
+        new_item: 新获得的物品对象（必须实现 get_info(detailed=True)）
+        old_item: 当前持有的物品对象（可能为 None）
+        item_type_name: 物品类型名称（如"兵器"、"功法"）
+    """
+    new_info = item.get_info(detailed=True)
+    
+    if old_item:
+        old_info = item.get_info(detailed=True)
+        return (
+            f"现有{item_type_name}：{old_info}\n"
+            f"新{item_type_name}：{new_info}\n"
+            f"（选择替换将卖出旧{item_type_name}）"
+        )
+    else:
+        return f"新{item_type_name}：{new_info}"