docs: poker 包过时标记

game/poker/card_pile.go

@@ -11,6 +11,8 @@ import (
 
 // NewCardPile 返回一个新的牌堆，其中 size 表示了该牌堆由多少副牌组成
 //   - 在不洗牌的情况下，默认牌堆顶部到底部为从大到小排列
+//
+// Deprecated: 从 Minotaur 0.0.25 开始，由于设计原因已弃用，请尝试考虑使用 deck.Deck 或 deck.Group 代替，构建函数为 deck.NewDeck 或 deck.NewGroup
 func NewCardPile[P, C generic.Number, T Card[P, C]](size int, jokers [2]P, points [13]P, colors [4]C, generateCard func(guid int64, point P, color C) T, options ...CardPileOption[P, C, T]) *CardPile[P, C, T] {
 	pile := &CardPile[P, C, T]{
 		size:         size,

game/poker/doc.go

@@ -5,4 +5,6 @@
 //   - 扑克牌规则：该包提供了一系列函数，用于执行常见的扑克牌规则，如判断是否是同花顺、计算牌面点数等。这些函数旨在提供准确和可靠的规则判断和计算结果。
 //   - 扑克牌算法："poker"包还提供了一些算法，用于解决扑克牌游戏中的问题，如计算最佳牌型、判断是否存在顺子等。这些算法旨在提供高效和优化的解决方案。
 //   - 简化接口：该包的设计目标之一是提供简化的接口，使扑克牌游戏的开发变得更加直观和易于使用。您可以轻松地创建和操作扑克牌对象，而无需处理繁琐的底层细节。
+//
+// Deprecated: 从 Minotaur 0.0.25 开始，由于设计原因已弃用，请尝试考虑使用 utils/combination 和 utils/deck 代替
 package poker

game/poker/rule.go

@@ -7,6 +7,7 @@ import (
 	"sort"
 )
 
+// Deprecated: 从 Minotaur 0.0.25 开始，由于设计原因已弃用，请尝试考虑使用 combination.Combination、combination.Matcher、combination.Validator 代替
 func NewRule[P, C generic.Number, T Card[P, C]](options ...Option[P, C, T]) *Rule[P, C, T] {
 	poker := &Rule[P, C, T]{
 		pokerHand: map[string]HandHandle[P, C, T]{},