Update 牌型压制类游戏通用语法.txt

牌型压制类游戏通用语法.txt

@@ -131,8 +131,13 @@
     ;; 区域定义 (Zones) —— 所有牌的物理归属地
     ;; 根据定义，区域分为：牌库(main_deck/item_deck)、手牌(hand)、场上(field)、弃牌区(discard_pile)。
     ;; 所有游戏中的牌，在任意时刻，必须且只能存在于一个已定义的区域中。
+    ;;
+    ;; ★ 可见性规范：所有区域的 default_visibility 必须使用二元结构：
+    ;;   格式：(default_visibility (state visible/hidden) (to owner/teammates/enemies/all/none))
+    ;;   示例：(default_visibility (state visible) (to owner)) 表示默认仅拥有者可见
+    ;;   弃用：face_up/face_down 等旧版简写
       (hand            ; 玩家手牌区
-        (default_visibility (state visible) (to owner)) ;; 默认仅拥有者可见
+        (default_visibility (state visible) (to owner)) ;; 标准二元结构：仅拥有者可见
         (initial_cards 0))         ;; 初始数量（通常为0，由发牌动作填充）
       (field           ; 场上区（出牌后所在位置）
         (default_visibility (state visible) (to all))   ;; 默认全场可见
@@ -527,6 +532,9 @@
   ;; 4. 游戏阶段与流程 (Game Phases)
   ;;    定义游戏的各个阶段及其规则。
   ;; ============================================================================
+  ;; ★ Phase 命名规范：必须使用短枚举，禁止使用 *_phase 后缀
+  ;;   标准短枚举：setup / deal / bid / double / initiative / play / settle / grouping
+  ;;   示例：使用 (settle ...) 而非 (settlement ...) 或 (settle_phase ...)
   (phases
     ;; 叫分阶段（斗地主类游戏特有）
     (bid 
@@ -626,8 +634,8 @@
       )
     )
     
-    ;; 结算阶段
-    (settlement
+    ;; 结算阶段 (使用短枚举 settle，而非 settlement)
+    (settle
       (trigger_condition "condition_type") ; 触发条件:
                                    ;   "first_to_empty_hand" - 有人手牌为空
                                    ;   "round_limit" - 达到轮次限制
@@ -709,26 +717,46 @@
   )
   
   (special_mechanics ; 特殊机制定义（不仅是开关）
-  ;; 机制定义模板（必须包含以下所有字段）：
+  ;; ============================================================================
+  ;; 机制定义完整性规范（与 Prompt 对齐）
+  ;; ============================================================================
+  ;; 每个机制必须包含以下字段（★ 标记为必需字段）：
+  ;;
+  ;; ★ (enabled true/false)            - 是否启用该机制
+  ;; ★ (description "...")              - 精确描述，禁用模糊词汇（"某些"、"部分"、"可能"等）
+  ;; ★ (phase "phase_name")            - 必须是 setup/deal/bid/double/initiative/play/settle/grouping 之一
+  ;; ★ (timing "pre_action"/"post_action"/"during_action") - 具体时机
+  ;; ★ (trigger_condition "...")       - 触发条件，必须是可验证的精确表达式
+  ;; ★ (usage_limit "...")             - once_per_game/once_per_round/N_times
+  ;; ★ (effect_description "...")      - 详细效果说明，包含具体数值和限制
+  ;; ★ (transfer_path from: X to: Y)   - 涉及牌转移时必需；不涉及时写 none
+  ;;   (visibility_change ...)          - 可选：涉及可见性变更时需要
+  ;;   (min_players N)                  - 可选：机制生效的最小玩家数
+  ;;   (max_players N)                  - 可选：机制生效的最大玩家数
+  ;;   (required_conditions {...})      - 可选：前置条件列表
+  ;;
+  ;; 完整示例模板：
   ;; (mechanic "MechanicName"
   ;;   (enabled true/false)
   ;;   (description "精确描述，不得使用'某些'、'部分'等模糊词汇")
-  ;;   (phase "phase_name") ; 必须指定机制所属阶段
-  ;;   (timing "pre_action"/"post_action"/"during_action") ; 必须指定具体时机
-  ;;   (trigger_condition "condition_expression") ; 必须指定触发条件
-  ;;   (usage_limit "once_per_game"/"once_per_round"/"N_times") ; 必须指定使用限制
-  ;;   (min_players N) ; 机制生效所需的最小玩家数
-  ;;   (max_players N) ; 机制生效所需的最大玩家数
-  ;;   (required_conditions { "condition1" "condition2" ... }) ; 必须满足的条件
+  ;;   (phase "phase_name") ; 必须是短枚举之一
+  ;;   (timing "pre_action"/"post_action"/"during_action")
+  ;;   (trigger_condition "condition_expression")
+  ;;   (usage_limit "once_per_game"/"once_per_round"/"N_times")
+  ;;   (min_players N)
+  ;;   (max_players N)
+  ;;   (required_conditions { "condition1" "condition2" ... })
   ;;   (effect_description "必须详细描述效果，包含具体数值和限制")
-  ;;   (exchange_rules
+  ;;   (transfer_path from: X to: Y)  ; 或 none
+  ;;   (visibility_change ...)         ; 可选
+  ;;   (exchange_rules                 ; 仅交换机制需要
   ;;     (number_of_cards 
-  ;;        (type "exact") ; 必须指定类型
-  ;;        (value 2)) ; 必须提供精确值
+  ;;        (type "exact")
+  ;;        (value 2))
   ;;     (allowed_card_types 
-  ;;        (type "list") ; 必须指定类型
-  ;;        (values { "single" "pair" })) ; 必须提供具体列表
-  ;;    )
+  ;;        (type "list")
+  ;;        (values { "single" "pair" })))
+  ;;   )
   
   ;; 示例：交换手牌机制
   (mechanic "HandExchange"