docs: 优化 README.md 包级函数不显示泛型签名的情况

game/activity/README.md

@@ -75,88 +75,88 @@ activity 活动状态管理
 > 加载所有活动实体数据
 
 ***
-#### func LoadOrRefreshActivity(activityType Type, activityId ID, options ...*Options) error
+#### func LoadOrRefreshActivity\[Type generic.Basic, ID generic.Basic\](activityType Type, activityId ID, options ...*Options) error
 <span id="LoadOrRefreshActivity"></span>
 > 加载或刷新活动
 >   - 通常在活动配置刷新时候将活动通过该方法注册或刷新
 
 ***
-#### func DefineNoneDataActivity(activityType Type) NoneDataActivityController[Type, ID, *none, none, *none]
+#### func DefineNoneDataActivity\[Type generic.Basic, ID generic.Basic\](activityType Type) NoneDataActivityController[Type, ID, *none, none, *none]
 <span id="DefineNoneDataActivity"></span>
 > 声明无数据的活动类型
 
 ***
-#### func DefineGlobalDataActivity(activityType Type) GlobalDataActivityController[Type, ID, Data, none, *none]
+#### func DefineGlobalDataActivity\[Type generic.Basic, ID generic.Basic, Data any\](activityType Type) GlobalDataActivityController[Type, ID, Data, none, *none]
 <span id="DefineGlobalDataActivity"></span>
 > 声明拥有全局数据的活动类型
 
 ***
-#### func DefineEntityDataActivity(activityType Type) EntityDataActivityController[Type, ID, *none, EntityID, EntityData]
+#### func DefineEntityDataActivity\[Type generic.Basic, ID generic.Basic, EntityID generic.Basic, EntityData any\](activityType Type) EntityDataActivityController[Type, ID, *none, EntityID, EntityData]
 <span id="DefineEntityDataActivity"></span>
 > 声明拥有实体数据的活动类型
 
 ***
-#### func DefineGlobalAndEntityDataActivity(activityType Type) GlobalAndEntityDataActivityController[Type, ID, Data, EntityID, EntityData]
+#### func DefineGlobalAndEntityDataActivity\[Type generic.Basic, ID generic.Basic, Data any, EntityID generic.Basic, EntityData any\](activityType Type) GlobalAndEntityDataActivityController[Type, ID, Data, EntityID, EntityData]
 <span id="DefineGlobalAndEntityDataActivity"></span>
 > 声明拥有全局数据和实体数据的活动类型
 
 ***
-#### func RegUpcomingEvent(activityType Type, handler UpcomingEventHandler[ID], priority ...int)
+#### func RegUpcomingEvent\[Type generic.Basic, ID generic.Basic\](activityType Type, handler UpcomingEventHandler[ID], priority ...int)
 <span id="RegUpcomingEvent"></span>
 > 注册即将开始的活动事件处理器
 
 ***
-#### func OnUpcomingEvent(activity *Activity[Type, ID])
+#### func OnUpcomingEvent\[Type generic.Basic, ID generic.Basic\](activity *Activity[Type, ID])
 <span id="OnUpcomingEvent"></span>
 > 即将开始的活动事件
 
 ***
-#### func RegStartedEvent(activityType Type, handler StartedEventHandler[ID], priority ...int)
+#### func RegStartedEvent\[Type generic.Basic, ID generic.Basic\](activityType Type, handler StartedEventHandler[ID], priority ...int)
 <span id="RegStartedEvent"></span>
 > 注册活动开始事件处理器
 
 ***
-#### func OnStartedEvent(activity *Activity[Type, ID])
+#### func OnStartedEvent\[Type generic.Basic, ID generic.Basic\](activity *Activity[Type, ID])
 <span id="OnStartedEvent"></span>
 > 活动开始事件
 
 ***
-#### func RegEndedEvent(activityType Type, handler EndedEventHandler[ID], priority ...int)
+#### func RegEndedEvent\[Type generic.Basic, ID generic.Basic\](activityType Type, handler EndedEventHandler[ID], priority ...int)
 <span id="RegEndedEvent"></span>
 > 注册活动结束事件处理器
 
 ***
-#### func OnEndedEvent(activity *Activity[Type, ID])
+#### func OnEndedEvent\[Type generic.Basic, ID generic.Basic\](activity *Activity[Type, ID])
 <span id="OnEndedEvent"></span>
 > 活动结束事件
 
 ***
-#### func RegExtendedShowStartedEvent(activityType Type, handler ExtendedShowStartedEventHandler[ID], priority ...int)
+#### func RegExtendedShowStartedEvent\[Type generic.Basic, ID generic.Basic\](activityType Type, handler ExtendedShowStartedEventHandler[ID], priority ...int)
 <span id="RegExtendedShowStartedEvent"></span>
 > 注册活动结束后延长展示开始事件处理器
 
 ***
-#### func OnExtendedShowStartedEvent(activity *Activity[Type, ID])
+#### func OnExtendedShowStartedEvent\[Type generic.Basic, ID generic.Basic\](activity *Activity[Type, ID])
 <span id="OnExtendedShowStartedEvent"></span>
 > 活动结束后延长展示开始事件
 
 ***
-#### func RegExtendedShowEndedEvent(activityType Type, handler ExtendedShowEndedEventHandler[ID], priority ...int)
+#### func RegExtendedShowEndedEvent\[Type generic.Basic, ID generic.Basic\](activityType Type, handler ExtendedShowEndedEventHandler[ID], priority ...int)
 <span id="RegExtendedShowEndedEvent"></span>
 > 注册活动结束后延长展示结束事件处理器
 
 ***
-#### func OnExtendedShowEndedEvent(activity *Activity[Type, ID])
+#### func OnExtendedShowEndedEvent\[Type generic.Basic, ID generic.Basic\](activity *Activity[Type, ID])
 <span id="OnExtendedShowEndedEvent"></span>
 > 活动结束后延长展示结束事件
 
 ***
-#### func RegNewDayEvent(activityType Type, handler NewDayEventHandler[ID], priority ...int)
+#### func RegNewDayEvent\[Type generic.Basic, ID generic.Basic\](activityType Type, handler NewDayEventHandler[ID], priority ...int)
 <span id="RegNewDayEvent"></span>
 > 注册新的一天事件处理器
 
 ***
-#### func OnNewDayEvent(activity *Activity[Type, ID])
+#### func OnNewDayEvent\[Type generic.Basic, ID generic.Basic\](activity *Activity[Type, ID])
 <span id="OnNewDayEvent"></span>
 > 新的一天事件
 

game/fight/README.md

@@ -34,7 +34,7 @@
 
 ***
 ## 详情信息
-#### func NewTurnBased(calcNextTurnDuration func ( Camp,  Entity)  time.Duration) *TurnBased[CampID, EntityID, Camp, Entity]
+#### func NewTurnBased\[CampID comparable, EntityID comparable, Camp generic.IdR[CampID], Entity generic.IdR[EntityID]\](calcNextTurnDuration func ( Camp,  Entity)  time.Duration) *TurnBased[CampID, EntityID, Camp, Entity]
 <span id="NewTurnBased"></span>
 > 创建一个新的回合制
 >   - calcNextTurnDuration 将返回下一次行动时间间隔，适用于按照速度计算下一次行动时间间隔的情况。当返回 0 时，将使用默认的行动超时时间

game/space/README.md

@@ -34,7 +34,7 @@ space 游戏中常见的空间设计，例如房间、地图等
 
 ***
 ## 详情信息
-#### func NewRoomManager() *RoomManager[EntityID, RoomID, Entity, Room]
+#### func NewRoomManager\[EntityID comparable, RoomID comparable, Entity generic.IdR[EntityID], Room generic.IdR[RoomID]\]() *RoomManager[EntityID, RoomID, Entity, Room]
 <span id="NewRoomManager"></span>
 > 创建房间管理器 RoomManager 的实例
 
@@ -49,7 +49,7 @@ func ExampleNewRoomManager() {
 ```
 
 ***
-#### func NewRoomControllerOptions() *RoomControllerOptions[EntityID, RoomID, Entity, Room]
+#### func NewRoomControllerOptions\[EntityID comparable, RoomID comparable, Entity generic.IdR[EntityID], Room generic.IdR[RoomID]\]() *RoomControllerOptions[EntityID, RoomID, Entity, Room]
 <span id="NewRoomControllerOptions"></span>
 > 创建房间控制器选项
 

game/task/README.md

@@ -88,7 +88,7 @@ func TestCond(t *testing.T) {
 
 
 ***
-#### func RegisterRefreshTaskCounterEvent(taskType string, handler RefreshTaskCounterEventHandler[Trigger])
+#### func RegisterRefreshTaskCounterEvent\[Trigger any\](taskType string, handler RefreshTaskCounterEventHandler[Trigger])
 <span id="RegisterRefreshTaskCounterEvent"></span>
 > 注册特定任务类型的刷新任务计数器事件处理函数
 
@@ -98,7 +98,7 @@ func TestCond(t *testing.T) {
 > 触发特定任务类型的刷新任务计数器事件
 
 ***
-#### func RegisterRefreshTaskConditionEvent(taskType string, handler RefreshTaskConditionEventHandler[Trigger])
+#### func RegisterRefreshTaskConditionEvent\[Trigger any\](taskType string, handler RefreshTaskConditionEventHandler[Trigger])
 <span id="RegisterRefreshTaskConditionEvent"></span>
 > 注册特定任务类型的刷新任务条件事件处理函数
 

server/README.md

@@ -138,7 +138,7 @@ func TestNewBot(t *testing.T) {
 <span id="DefaultWebsocketUpgrader"></span>
 
 ***
-#### func NewHttpHandleWrapper(srv *Server, packer ContextPacker[Context]) *Http[Context]
+#### func NewHttpHandleWrapper\[Context any\](srv *Server, packer ContextPacker[Context]) *Http[Context]
 <span id="NewHttpHandleWrapper"></span>
 > 创建一个新的 http 处理程序包装器
 >   - 默认使用 server.HttpContext 作为上下文，如果需要依赖其作为新的上下文，可以通过 NewHttpContext 创建
@@ -149,7 +149,7 @@ func TestNewBot(t *testing.T) {
 > 基于 gin.Context 创建一个新的 HttpContext
 
 ***
-#### func NewGinWrapper(server *gin.Engine, pack func (ctx *gin.Context)  CTX) *HttpWrapper[CTX]
+#### func NewGinWrapper\[CTX any\](server *gin.Engine, pack func (ctx *gin.Context)  CTX) *HttpWrapper[CTX]
 <span id="NewGinWrapper"></span>
 > 创建 gin 包装器，用于对 NewHttpWrapper 函数的替代
 

server/internal/dispatcher/README.md

@@ -36,7 +36,7 @@
 
 ***
 ## 详情信息
-#### func NewDispatcher(bufferSize int, name string, handler Handler[P, M]) *Dispatcher[P, M]
+#### func NewDispatcher\[P Producer, M Message[P]\](bufferSize int, name string, handler Handler[P, M]) *Dispatcher[P, M]
 <span id="NewDispatcher"></span>
 > 创建一个新的消息分发器 Dispatcher 实例
 
@@ -107,7 +107,7 @@ func TestNewDispatcher(t *testing.T) {
 
 
 ***
-#### func NewManager(bufferSize int, handler Handler[P, M]) *Manager[P, M]
+#### func NewManager\[P Producer, M Message[P]\](bufferSize int, handler Handler[P, M]) *Manager[P, M]
 <span id="NewManager"></span>
 > 生成消息分发器管理器
 

server/lockstep/README.md

@@ -37,7 +37,7 @@
 
 ***
 ## 详情信息
-#### func NewLockstep(options ...Option[ClientID, Command]) *Lockstep[ClientID, Command]
+#### func NewLockstep\[ClientID comparable, Command any\](options ...Option[ClientID, Command]) *Lockstep[ClientID, Command]
 <span id="NewLockstep"></span>
 > 创建一个锁步（帧）同步默认实现的组件(Lockstep)进行返回
 
@@ -78,19 +78,19 @@ func TestNewLockstep(t *testing.T) {
 
 
 ***
-#### func WithFrameLimit(frameLimit int64) Option[ClientID, Command]
+#### func WithFrameLimit\[ClientID comparable, Command any\](frameLimit int64) Option[ClientID, Command]
 <span id="WithFrameLimit"></span>
 > 通过特定逻辑帧上限创建锁步（帧）同步组件
 >   - 当达到上限时将停止广播
 
 ***
-#### func WithFrameRate(frameRate int64) Option[ClientID, Command]
+#### func WithFrameRate\[ClientID comparable, Command any\](frameRate int64) Option[ClientID, Command]
 <span id="WithFrameRate"></span>
 > 通过特定逻辑帧率创建锁步（帧）同步组件
 >   - 默认情况下为 15/s
 
 ***
-#### func WithSerialization(handle func (frame int64, commands []Command)  []byte) Option[ClientID, Command]
+#### func WithSerialization\[ClientID comparable, Command any\](handle func (frame int64, commands []Command)  []byte) Option[ClientID, Command]
 <span id="WithSerialization"></span>
 > 通过特定的序列化方式将每一帧的数据进行序列化
 > 
@@ -102,7 +102,7 @@ func TestNewLockstep(t *testing.T) {
 >     }
 
 ***
-#### func WithInitFrame(initFrame int64) Option[ClientID, Command]
+#### func WithInitFrame\[ClientID comparable, Command any\](initFrame int64) Option[ClientID, Command]
 <span id="WithInitFrame"></span>
 > 通过特定的初始帧创建锁步（帧）同步组件
 >   - 默认情况下为 0，即第一帧索引为 0

server/router/README.md

@@ -33,7 +33,7 @@
 
 ***
 ## 详情信息
-#### func NewMultistage(options ...MultistageOption[HandleFunc]) *Multistage[HandleFunc]
+#### func NewMultistage\[HandleFunc any\](options ...MultistageOption[HandleFunc]) *Multistage[HandleFunc]
 <span id="NewMultistage"></span>
 > 创建一个支持多级分类的路由器
 
@@ -47,7 +47,7 @@ func ExampleNewMultistage() {
 ```
 
 ***
-#### func WithRouteTrim(handle func (route any)  any) MultistageOption[HandleFunc]
+#### func WithRouteTrim\[HandleFunc any\](handle func (route any)  any) MultistageOption[HandleFunc]
 <span id="WithRouteTrim"></span>
 > 路由修剪选项
 >   - 将在路由注册前对路由进行对应处理

server/writeloop/README.md

@@ -33,7 +33,7 @@
 
 ***
 ## 详情信息
-#### func NewChannel(pool *hub.ObjectPool[Message], channelSize int, writeHandler func (message Message)  error, errorHandler func (err any)) *Channel[Message]
+#### func NewChannel\[Message any\](pool *hub.ObjectPool[Message], channelSize int, writeHandler func (message Message)  error, errorHandler func (err any)) *Channel[Message]
 <span id="NewChannel"></span>
 > 创建基于 Channel 的写循环
 >   - pool 用于管理 Message 对象的缓冲池，在创建 Message 对象时也应该使用该缓冲池，以便复用 Message 对象。 Channel 会在写入完成后将 Message 对象放回缓冲池
@@ -44,7 +44,7 @@
 > 传入 writeHandler 的消息对象是从 Channel 中获取的，因此 writeHandler 不应该持有消息对象的引用，同时也不应该主动释放消息对象
 
 ***
-#### func NewUnbounded(pool *hub.ObjectPool[Message], writeHandler func (message Message)  error, errorHandler func (err any)) *Unbounded[Message]
+#### func NewUnbounded\[Message any\](pool *hub.ObjectPool[Message], writeHandler func (message Message)  error, errorHandler func (err any)) *Unbounded[Message]
 <span id="NewUnbounded"></span>
 > 创建写循环
 >   - pool 用于管理 Message 对象的缓冲池，在创建 Message 对象时也应该使用该缓冲池，以便复用 Message 对象。 Unbounded 会在写入完成后将 Message 对象放回缓冲池

utils/aoi/README.md

@@ -37,7 +37,7 @@ AOI 问题是在大规模多人在线游戏中常见的问题，它涉及到确
 
 ***
 ## 详情信息
-#### func NewTwoDimensional(width int, height int, areaWidth int, areaHeight int) *TwoDimensional[EID, PosType, E]
+#### func NewTwoDimensional\[EID generic.Basic, PosType generic.SignedNumber, E TwoDimensionalEntity[EID, PosType]\](width int, height int, areaWidth int, areaHeight int) *TwoDimensional[EID, PosType, E]
 <span id="NewTwoDimensional"></span>
 
 <details>

utils/arrangement/README.md

@@ -50,54 +50,54 @@ arrangement 包提供了一些有用的函数来处理数组的排列。
 
 ***
 ## 详情信息
-#### func WithAreaConstraint(constraint AreaConstraintHandle[ID, AreaInfo]) AreaOption[ID, AreaInfo]
+#### func WithAreaConstraint\[ID comparable, AreaInfo any\](constraint AreaConstraintHandle[ID, AreaInfo]) AreaOption[ID, AreaInfo]
 <span id="WithAreaConstraint"></span>
 > 设置编排区域的约束条件
 >   - 该约束用于判断一个成员是否可以被添加到该编排区域中
 >   - 与 WithAreaConflict 不同的是，约束通常用于非成员关系导致的硬性约束，例如：成员的等级过滤、成员的性别等
 
 ***
-#### func WithAreaConflict(conflict AreaConflictHandle[ID, AreaInfo]) AreaOption[ID, AreaInfo]
+#### func WithAreaConflict\[ID comparable, AreaInfo any\](conflict AreaConflictHandle[ID, AreaInfo]) AreaOption[ID, AreaInfo]
 <span id="WithAreaConflict"></span>
 > 设置编排区域的冲突条件，冲突处理函数需要返回造成冲突的成员列表
 >   - 该冲突用于判断一个成员是否可以被添加到该编排区域中
 >   - 与 WithAreaConstraint 不同的是，冲突通常用于成员关系导致的软性约束，例如：成员的职业唯一性、成员的种族唯一性等
 
 ***
-#### func WithAreaEvaluate(evaluate AreaEvaluateHandle[ID, AreaInfo]) AreaOption[ID, AreaInfo]
+#### func WithAreaEvaluate\[ID comparable, AreaInfo any\](evaluate AreaEvaluateHandle[ID, AreaInfo]) AreaOption[ID, AreaInfo]
 <span id="WithAreaEvaluate"></span>
 > 设置编排区域的评估函数
 >   - 该评估函数将影响成员被编入区域的优先级
 
 ***
-#### func NewArrangement(options ...Option[ID, AreaInfo]) *Arrangement[ID, AreaInfo]
+#### func NewArrangement\[ID comparable, AreaInfo any\](options ...Option[ID, AreaInfo]) *Arrangement[ID, AreaInfo]
 <span id="NewArrangement"></span>
 > 创建一个新的编排
 
 ***
-#### func WithItemFixed(matcher ItemFixedAreaHandle[AreaInfo]) ItemOption[ID, AreaInfo]
+#### func WithItemFixed\[ID comparable, AreaInfo any\](matcher ItemFixedAreaHandle[AreaInfo]) ItemOption[ID, AreaInfo]
 <span id="WithItemFixed"></span>
 > 设置成员的固定编排区域
 
 ***
-#### func WithItemPriority(priority ItemPriorityHandle[ID, AreaInfo]) ItemOption[ID, AreaInfo]
+#### func WithItemPriority\[ID comparable, AreaInfo any\](priority ItemPriorityHandle[ID, AreaInfo]) ItemOption[ID, AreaInfo]
 <span id="WithItemPriority"></span>
 > 设置成员的优先级
 
 ***
-#### func WithItemNotAllow(verify ItemNotAllowVerifyHandle[ID, AreaInfo]) ItemOption[ID, AreaInfo]
+#### func WithItemNotAllow\[ID comparable, AreaInfo any\](verify ItemNotAllowVerifyHandle[ID, AreaInfo]) ItemOption[ID, AreaInfo]
 <span id="WithItemNotAllow"></span>
 > 设置成员不允许的编排区域
 
 ***
-#### func WithRetryThreshold(threshold int) Option[ID, AreaInfo]
+#### func WithRetryThreshold\[ID comparable, AreaInfo any\](threshold int) Option[ID, AreaInfo]
 <span id="WithRetryThreshold"></span>
 > 设置编排时的重试阈值
 >   - 当每一轮编排结束任有成员未被编排时，将会进行下一轮编排，直到编排次数达到该阈值
 >   - 默认的阈值为 10 次
 
 ***
-#### func WithConstraintHandle(handle ConstraintHandle[ID, AreaInfo]) Option[ID, AreaInfo]
+#### func WithConstraintHandle\[ID comparable, AreaInfo any\](handle ConstraintHandle[ID, AreaInfo]) Option[ID, AreaInfo]
 <span id="WithConstraintHandle"></span>
 > 设置编排时触发约束时的处理函数
 >   - 当约束条件触发时，将会调用该函数。如果无法在该函数中处理约束，应该继续返回 err，尝试进行下一层的约束处理
@@ -107,7 +107,7 @@ arrangement 包提供了一些有用的函数来处理数组的排列。
 > 有意思的是，硬性约束应该永远是无解的，而当需要进行一些打破规则的操作时，则可以透过该函数传入的 editor 进行操作
 
 ***
-#### func WithConflictHandle(handle ConflictHandle[ID, AreaInfo]) Option[ID, AreaInfo]
+#### func WithConflictHandle\[ID comparable, AreaInfo any\](handle ConflictHandle[ID, AreaInfo]) Option[ID, AreaInfo]
 <span id="WithConflictHandle"></span>
 > 设置编排时触发冲突时的处理函数
 >   - 当冲突条件触发时，将会调用该函数。如果无法在该函数中处理冲突，应该继续返回这一批成员，尝试进行下一层的冲突处理

utils/buffer/README.md

@@ -40,7 +40,7 @@ buffer 提供了缓冲区相关的实用程序。
 
 ***
 ## 详情信息
-#### func NewRing(initSize ...int) *Ring[T]
+#### func NewRing\[T any\](initSize ...int) *Ring[T]
 <span id="NewRing"></span>
 > 创建一个并发不安全的环形缓冲区
 >   - initSize: 初始容量
@@ -68,12 +68,12 @@ func TestNewRing(t *testing.T) {
 
 
 ***
-#### func NewRingUnbounded(bufferSize int) *RingUnbounded[T]
+#### func NewRingUnbounded\[T any\](bufferSize int) *RingUnbounded[T]
 <span id="NewRingUnbounded"></span>
 > 创建一个并发安全的基于环形缓冲区实现的无界缓冲区
 
 ***
-#### func NewUnbounded() *Unbounded[V]
+#### func NewUnbounded\[V any\]() *Unbounded[V]
 <span id="NewUnbounded"></span>
 > 创建一个无界缓冲区
 >   - generateNil: 生成空值的函数，该函数仅需始终返回 nil 即可