""" 参数化卡牌系统演示 展示新的参数化卡牌功能 """ from kards_battle.cards.card_params import ( ParameterDefinition, ParameterType, TargetType, ZoneType, FilterType, CardParameterValidator, CardParameterHelper ) from kards_battle.cards.card import UnitCard from kards_battle.core.enums import Nation, Rarity def demo_parameter_definitions(): """演示参数定义创建""" print("=== 参数定义演示 ===") # 1. 槽位参数 slot_param = ParameterDefinition( name="position", param_type=ParameterType.SLOT, slot_range=[0, 4], required=False, description="Deploy position (0-4)" ) print(f"1. 槽位参数: {slot_param.name} - {slot_param.description}") # 2. HQ目标参数 hq_param = ParameterDefinition( name="target_hq", param_type=ParameterType.TARGET, target_type=TargetType.HQ, target_filter=FilterType.ANY, required=True, description="Select any HQ to target" ) print(f"2. HQ目标参数: {hq_param.name} - {hq_param.description}") # 3. 单位目标参数（带筛选） unit_param = ParameterDefinition( name="target_aircraft", param_type=ParameterType.TARGET, target_type=TargetType.UNIT, valid_zones=[ZoneType.OWN, ZoneType.FRONT], target_filter=FilterType.FRIENDLY, unit_type_filter=["fighter", "bomber"], nation_filter=["uk"], required=True, description="Select friendly British aircraft" ) print(f"3. 单位目标参数: {unit_param.name} - {unit_param.description}") print(f" 筛选条件: 友方 + 英国 + 空军单位") # 4. 多目标参数 multi_param = ParameterDefinition( name="targets", param_type=ParameterType.MULTI_TARGET, target_type=TargetType.UNIT, valid_zones=[ZoneType.ENEMY, ZoneType.FRONT], target_filter=FilterType.ENEMY, min_count=1, max_count=3, required=True, description="Select 1-3 enemy units" ) print(f"4. 多目标参数: {multi_param.name} - {multi_param.description}") print(f" 数量范围: {multi_param.min_count}-{multi_param.max_count}") return [slot_param, hq_param, unit_param, multi_param] def demo_parameter_validation(): """演示参数验证""" print("\n=== 参数验证演示 ===") params = demo_parameter_definitions() # 测试槽位参数验证 slot_param = params[0] print(f"\n测试槽位参数: {slot_param.name}") valid_slot = 2 invalid_slot = 5 print(f" 值 {valid_slot}: {'✓' if CardParameterValidator.validate_slot_parameter(slot_param, valid_slot) else '✗'}") print(f" 值 {invalid_slot}: {'✓' if CardParameterValidator.validate_slot_parameter(slot_param, invalid_slot) else '✗'}") # 测试HQ目标参数验证 hq_param = params[1] print(f"\n测试HQ目标参数: {hq_param.name}") valid_hq = {"player": 0} invalid_hq = {"player": 2} print(f" 值 {valid_hq}: {'✓' if CardParameterValidator.validate_target_parameter(hq_param, valid_hq) else '✗'}") print(f" 值 {invalid_hq}: {'✓' if CardParameterValidator.validate_target_parameter(hq_param, invalid_hq) else '✗'}") # 测试单位目标参数验证 unit_param = params[2] print(f"\n测试单位目标参数: {unit_param.name}") valid_unit = {"zone": "O", "slot": 1} invalid_zone = {"zone": "E", "slot": 1} # 不在valid_zones中 invalid_slot = {"zone": "O", "slot": 5} # 槽位超范围 print(f" 值 {valid_unit}: {'✓' if CardParameterValidator.validate_target_parameter(unit_param, valid_unit) else '✗'}") print(f" 值 {invalid_zone}: {'✓' if CardParameterValidator.validate_target_parameter(unit_param, invalid_zone) else '✗'}") print(f" 值 {invalid_slot}: {'✓' if CardParameterValidator.validate_target_parameter(unit_param, invalid_slot) else '✗'}") def demo_parameter_formatting(): """演示参数值格式化""" print("\n=== 参数格式化演示 ===") params = demo_parameter_definitions() # 格式化不同类型的参数值 print("参数值格式化:") # 槽位参数 slot_value = 3 slot_formatted = CardParameterHelper.format_parameter_value(params[0], slot_value) print(f" 槽位参数 {slot_value} → {slot_formatted}") # HQ目标参数 hq_value = {"player": 1} hq_formatted = CardParameterHelper.format_parameter_value(params[1], hq_value) print(f" HQ目标 {hq_value} → {hq_formatted}") # 单位目标参数 unit_value = {"zone": "F", "slot": 2} unit_formatted = CardParameterHelper.format_parameter_value(params[2], unit_value) print(f" 单位目标 {unit_value} → {unit_formatted}") # 多目标参数 multi_value = [{"zone": "E", "slot": 0}, {"zone": "E", "slot": 3}] multi_formatted = CardParameterHelper.format_parameter_value(params[3], multi_value) print(f" 多目标 {multi_value} → {multi_formatted}") def demo_parameterized_card_creation(): """演示创建带参数的卡牌""" print("\n=== 参数化卡牌创建演示 ===") # 创建带参数的单位卡 parameters = [ ParameterDefinition( name="position", param_type=ParameterType.SLOT, slot_range=[0, 4], required=False, description="Deploy position" ) ] card = UnitCard( name="Parameterized Grenadier", cost=2, nation=Nation.GERMANY, rarity=Rarity.UNCOMMON, unit_definition_id="ger_infantry_grenadier", description="German infantry with customizable deployment", parameters=parameters ) print(f"创建卡牌: {card.name}") print(f" 有参数: {'是' if card.has_parameters() else '否'}") print(f" 参数数量: {len(card.parameters)}") if card.has_parameters(): for param in card.parameters: print(f" - {param.name}: {param.description}") # 测试参数验证 print("\n测试卡牌参数验证:") # 有效参数 valid_params = {"position": 2} errors = card.validate_parameters(valid_params) print(f" 有效参数 {valid_params}: {'✓' if not errors else '✗ ' + str(errors)}") # 无效参数 invalid_params = {"position": 10} errors = card.validate_parameters(invalid_params) print(f" 无效参数 {invalid_params}: {'✓' if not errors else '✗ ' + str(errors)}") # 缺少可选参数（应该通过） empty_params = {} errors = card.validate_parameters(empty_params) print(f" 空参数 {empty_params}: {'✓' if not errors else '✗ ' + str(errors)}") def demo_complex_parameterized_card(): """演示复杂参数化卡牌""" print("\n=== 复杂参数化卡牌演示 ===") # 创建有多个复杂参数的指令卡（概念演示） parameters = [ ParameterDefinition( name="attacker", param_type=ParameterType.TARGET, target_type=TargetType.UNIT, valid_zones=[ZoneType.OWN, ZoneType.FRONT], target_filter=FilterType.FRIENDLY, required=True, description="Select attacking unit" ), ParameterDefinition( name="targets", param_type=ParameterType.MULTI_TARGET, target_type=TargetType.UNIT, valid_zones=[ZoneType.ENEMY, ZoneType.FRONT], target_filter=FilterType.ENEMY, min_count=1, max_count=2, required=True, description="Select 1-2 enemy targets" ), ParameterDefinition( name="bonus_damage", param_type=ParameterType.VALUE, min_value=1, max_value=5, default_value=2, required=False, description="Bonus damage (1-5)" ) ] print("复杂指令卡: Coordinated Strike") print("参数:") for param in parameters: req_str = "必需" if param.required else "可选" print(f" - {param.name} ({param.param_type.value}, {req_str}): {param.description}") # 测试复杂参数验证 print("\n复杂参数验证测试:") valid_complex_params = { "attacker": {"zone": "O", "slot": 1}, "targets": [{"zone": "E", "slot": 0}, {"zone": "E", "slot": 2}], "bonus_damage": 3 } errors = CardParameterValidator.validate_card_parameters(parameters, valid_complex_params) print(f" 有效复杂参数: {'✓' if not errors else '✗ ' + str(errors)}") # 格式化复杂参数显示 print("\n复杂参数格式化:") for param_name, param_value in valid_complex_params.items(): param_def = next(p for p in parameters if p.name == param_name) formatted = CardParameterHelper.format_parameter_value(param_def, param_value) print(f" {param_name}: {formatted}") def main(): """主演示函数""" print("🎮 KARDS 参数化卡牌系统演示") print("="*50) try: demo_parameter_definitions() demo_parameter_validation() demo_parameter_formatting() demo_parameterized_card_creation() demo_complex_parameterized_card() print("\n" + "="*50) print("✅ 参数化卡牌系统演示完成！") print("\n🎯 功能总结:") print("• 支持多种参数类型：槽位、目标、多目标、数值、选择") print("• 灵活的目标筛选：国家、单位类型、区域、敌友") print("• 完整的参数验证系统") print("• 友好的参数格式化显示") print("• 与现有卡牌系统完全兼容") except Exception as e: print(f"\n❌ 演示过程中出现错误: {e}") import traceback traceback.print_exc() if __name__ == "__main__": main()