merge: resolve latest main updates

将硬编码的 ID 组合逻辑（100000*OnlineID + Port）提取为通用函数 ComposeRuntimeID，
使用 16 位位移掩码优化，并新增辅助方法与类型转换。同时修复踢人流程中的资源清理问题。

.cnb.yml

@@ -27,5 +27,4 @@ main:
             username: ${GIT_USERNAME}
             password: ${GIT_ACCESS_TOKEN}
             force: true
-            
+            sync_mode: push
-            #sync_mode: rebase

.gitignore

@@ -47,3 +47,4 @@ public/login-linux-amd64
 public/login-login-linux-amd64
 public/logic_linux-amd64_1
 .cache/**
+.agents/**

.ide/Dockerfile

@@ -18,11 +18,11 @@ ENV GOMODCACHE=/workspace/.cache/gomod
 # ==========================================
 # 2. Codex 配置 (更换时修改这里，重新 build)
 # ==========================================
-ENV CODEX_BASE_URL="https://www.jnm.lol/v1"
+ENV CODEX_BASE_URL="https://api.jucode.cn/v1"
 
 ENV CODEX_MODEL="gpt-5.4"
 
-ENV OPENAI_API_KEY="pk_live__NQFz14yuraSLUY9mXCuQ2Swh1NM9XV4uVOB1qukipw"
+ENV OPENAI_API_KEY="sk-E0ZZIFNnD0RkhMC9pT2AGMutz9vNy2VLNrgyyobT5voa81pQ"
 
 # ==========================================
 # 3. 安装系统依赖、Golang、Code-server

.ide/help.md

@@ -1,12 +1,7 @@
-青氧,十九禁给
-https://api.aibh.site/console  张晟    2922919493Zs.
-RUN curl -fsSL https://oss.itbzzb.cn/setup-codex.sh | \
-    YES=1 bash -s -- --base-url https://api.aibh.site \
-    --api-key sk-foAHgsJtmanACECtBlFYZE2z4LkwBboEOYETO3ZdWvCxdmNr \
-    --mirror auto
  
 
-https://api.gemai.cc/console/token  免费给部分额度 ,还有100块
+https://api.jucode.cn/  
+ fastai.fast 使用谷歌邮箱https://linshiguge.com/白嫖
 https://zread.ai/tawer-blog/lmarena-2api/1-overview   GLM web2 pai
 
 https://crazyrouter.com/console   模型最便宜,看看能不能1:10
@@ -14,7 +9,7 @@ https://crazyrouter.com/console   模型最便宜,看看能不能1:10
 https://agentrouter.org/pricing  签到给,有175
 
 
-kuaipao.ai  充了十块 cjf19970621  cjf19970621
+
 
 充了十块 
 使用网址：https://www.jnm.lol

.vscode/launch.json

@@ -29,7 +29,7 @@
       "request": "launch",
       "mode": "auto",
       "cwd": "${workspaceFolder}",
-      "args": ["-id=2"],
+      "args": ["-id=99"],
 
       "program": "${workspaceFolder}/logic"
     }

.woodpecker/my-first-workflow.yaml

@@ -13,7 +13,7 @@ skip_clone: true
 steps:
   # ========== 1. 替代clone：拉取代码（核心依赖） ==========
   prepare:
-    image: alpine/git
+    image: docker.1ms.run/alpine/git
     environment:
       # WOODPECKER_SSH_KEY:
       #   from_secret: WOODPECKER_SSH_KEY
@@ -70,7 +70,7 @@ steps:
 
   # ========== 4. 编译Logic服务（完全参考GitHub Actions编译配置） ==========
   build_logic:
-    image: golang:1.25
+    image: docker.m.daocloud.io/golang:1.25
     depends_on: [prepare]
     environment:
       CGO_ENABLED: 0
@@ -142,23 +142,23 @@ steps:
 
   # ========== 6. SCP推送产物（依赖编译+配置解析） ==========
   scp-exe-to-servers:  # 与fetch-deploy-config同级，缩进2个空格
-    image: appleboy/drone-scp:1.6.2  # 子元素，缩进4个空格
+    image: docker.1ms.run/appleboy/drone-scp:1.6.2  # 子元素，缩进4个空格
     settings:  # 子元素，缩进4个空格
-      host: &ssh_host 2697v22.mc5173.cn
+      host: &ssh_host  43.248.3.21
-      port: &ssh_port 16493
+      port: &ssh_port 22
       username: &ssh_user root
-      password: &ssh_pass xIy9PQcBF96C
+      password: &ssh_pass KQv7yzna7BDukK
 
       source:
         - blazing/build/**
-      target: /opt/blazing/
+      target: /ext/blazing/
       strip_components: 1  # 统一缩进6个空格
       skip_verify: true  # 统一缩进6个空格
       timeout: 30s  # 统一缩进6个空格
     depends_on:  # 子元素，缩进4个空格
       - build_logic  # depends_on内的项，缩进6个空格
   start-login-logic:
-    image: appleboy/drone-ssh:1.6.2
+    image: swr.cn-north-4.myhuaweicloud.com/ddn-k8s/ghcr.io/appleboy/drone-ssh:1.7.7
     depends_on: [scp-exe-to-servers]
     settings:  # 子元素，缩进4个空格
       host: *ssh_host
@@ -167,7 +167,7 @@ steps:
       password: *ssh_pass
       script:
               - |
-                cd /opt/blazing/build
+                cd /ext/blazing/build
                 ls -t login_* 2>/dev/null | head -1
                 BIN_NAME=$(ls -t login_* 2>/dev/null | head -1)
                 echo "BIN_NAME: $BIN_NAME"
@@ -201,9 +201,9 @@ steps:
                 # 移动logic产物到public目录
                 LOGIC_BIN=$(ls -t logic_* 2>/dev/null | head -1)
                 if [ -n "$LOGIC_BIN" ]; then
-                  mkdir -p /opt/blazing/build/public
+                  mkdir -p /ext/blazing/build/public
-                  mv $LOGIC_BIN /opt/blazing/build/public/
+                  mv $LOGIC_BIN /ext/blazing/build/public/
-                  echo "✅ Logic产物已移动到 /opt/blazing/build/public/ | 文件: $(basename $LOGIC_BIN)"
+                  echo "✅ Logic产物已移动到 /ext/blazing/build/public/ | 文件: $(basename $LOGIC_BIN)"
                 else
                   echo "⚠️ 未找到Logic产物"
                 fi

common/contrib/drivers/pgsql/cmd/codexcheck/main.go

@@ -0,0 +1,56 @@
+package main
+
+import (
+	"database/sql"
+	"fmt"
+	"log"
+
+	_ "github.com/lib/pq"
+)
+
+func main() {
+	const dsn = "user=user_YrK4j7 password=password_jSDm76 host=43.248.3.21 port=5432 dbname=bl sslmode=disable timezone=Asia/Shanghai"
+
+	db, err := sql.Open("postgres", dsn)
+	if err != nil {
+		log.Fatal(err)
+	}
+	defer db.Close()
+
+	var (
+		id                  int64
+		cdkCode             string
+		cdkType             int64
+		exchangeRemainCount int64
+		bindUserID          int64
+		validEndTime        sql.NullTime
+		remark              sql.NullString
+	)
+
+	err = db.QueryRow(`
+		select id, cdk_code, type, exchange_remain_count, bind_user_id, valid_end_time, remark
+		from config_gift_cdk
+		where cdk_code = $1
+	`, "nrTbdXFBhKkaTdDk").Scan(
+		&id,
+		&cdkCode,
+		&cdkType,
+		&exchangeRemainCount,
+		&bindUserID,
+		&validEndTime,
+		&remark,
+	)
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	fmt.Printf("id=%d\ncdk_code=%s\ntype=%d\nexchange_remain_count=%d\nbind_user_id=%d\nvalid_end_time=%v\nremark=%q\n",
+		id,
+		cdkCode,
+		cdkType,
+		exchangeRemainCount,
+		bindUserID,
+		validEndTime.Time,
+		remark.String,
+	)
+}

common/cool/controller.go

@@ -2,6 +2,7 @@ package cool
 
 import (
 	"context"
+	"reflect"
 	"strings"
 
 	"blazing/cool/coolconfig"
@@ -158,12 +159,33 @@ func (c *Controller) Page(ctx context.Context, req *PageReq) (res *BaseRes, err
 // 注册控制器到路由
 func RegisterController(c IController) {
 	var ctx = context.Background()
-	var sController = &Controller{}
+	var sController *Controller
-	gconv.Struct(c, &sController)
+	rv := reflect.ValueOf(c)
+	if rv.IsValid() && rv.Kind() == reflect.Ptr {
+		ev := rv.Elem()
+		if ev.IsValid() {
+			field := ev.FieldByName("Controller")
+			if field.IsValid() && !field.IsNil() {
+				if ctrl, ok := field.Interface().(*Controller); ok && ctrl != nil {
+					sController = ctrl
+				}
+			}
+		}
+	}
+	if sController == nil {
+		sController = &Controller{}
+		gconv.Struct(c, &sController)
+	}
 	if coolconfig.Config.Eps {
 		model := sController.Service.GetModel()
-		columns := getModelInfo(ctx, sController.Prefix, model)
+		tableName := ""
-		ModelInfo[sController.Prefix] = columns
+		if model != nil {
+			tableName = strings.TrimSpace(model.TableName())
+		}
+		if tableName != "" && tableName != "this_table_should_not_exist" {
+			columns := getModelInfo(ctx, sController.Prefix, model)
+			ModelInfo[sController.Prefix] = columns
+		}
 	}
 	g.Server().Group(
 		sController.Prefix, func(group *ghttp.RouterGroup) {

common/cool/coolconfig/config.go

@@ -1,10 +1,11 @@
 package coolconfig
 
 import (
+	"os"
+	"strings"
 	"time"
 
 	"github.com/gogf/gf/v2/frame/g"
-	"github.com/gogf/gf/v2/util/gconv"
 )
 
 // cool config
@@ -21,7 +22,7 @@ type sConfig struct {
 
 }
 type ServerList struct {
-	OnlineID uint32 `gorm:"column:online_id;comment:'在线ID';uniqueIndex" json:"online_id"`
+	OnlineID uint32 `gorm:"column:online_id;comment:'在线ID'" json:"online_id"`
 	//服务器名称Desc
 	Name   string `gorm:"comment:'服务器名称'" json:"name"`
 	IP     string `gorm:"type:string;comment:'服务器IP'" json:"ip"`
@@ -48,7 +49,11 @@ type ServerList struct {
 }
 
 func (s *ServerList) GetID() string {
-	return gconv.String(100000*s.OnlineID + s.Port)
+	return RuntimeIDString(s.OnlineID, s.Port)
+}
+
+func (s *ServerList) RuntimeID() uint32 {
+	return ComposeRuntimeID(s.OnlineID, s.Port)
 }
 
 // OSS相关配置
@@ -72,7 +77,7 @@ type file struct {
 func newConfig() *sConfig {
 	var ctx g.Ctx
 	config := &sConfig{
-		AutoMigrate: GetCfgWithDefault(ctx, "blazing.autoMigrate", g.NewVar(false)).Bool(),
+		AutoMigrate: hasDebugArg(),
 		Name:        GetCfgWithDefault(ctx, "server.name", g.NewVar("")).String(),
 
 		Eps: GetCfgWithDefault(ctx, "blazing.eps", g.NewVar(false)).Bool(),
@@ -97,6 +102,19 @@ func newConfig() *sConfig {
 	return config
 }
 
+func hasDebugArg() bool {
+	for _, arg := range os.Args[1:] {
+		if arg == "-debug" || arg == "--debug" {
+			return true
+		}
+		if strings.HasPrefix(arg, "-debug=") || strings.HasPrefix(arg, "--debug=") {
+			value := strings.TrimSpace(strings.SplitN(arg, "=", 2)[1])
+			return value != "" && value != "0" && !strings.EqualFold(value, "false")
+		}
+	}
+	return false
+}
+
 // qiniu 七牛云配置
 type qiniu struct {
 	AccessKey string `json:"ak"`

common/cool/coolconfig/runtime_id.go

@@ -0,0 +1,22 @@
+package coolconfig
+
+import "github.com/gogf/gf/v2/util/gconv"
+
+const runtimeIDPortBits = 16
+const runtimeIDPortMask uint32 = 0xFFFF
+
+// ComposeRuntimeID 将 serverID 和 port 组合成运行时复合 ID。
+// 高 16 位保存 serverID，低 16 位保存 port。
+func ComposeRuntimeID(serverID, port uint32) uint32 {
+	return ((serverID & runtimeIDPortMask) << runtimeIDPortBits) | (port & runtimeIDPortMask)
+}
+
+// SplitRuntimeID 将运行时复合 ID 拆分为 serverID 和 port。
+func SplitRuntimeID(runtimeID uint32) (serverID, port uint32) {
+	return runtimeID >> runtimeIDPortBits, runtimeID & runtimeIDPortMask
+}
+
+// RuntimeIDString 返回运行时复合 ID 的字符串形式。
+func RuntimeIDString(serverID, port uint32) string {
+	return gconv.String(ComposeRuntimeID(serverID, port))
+}

common/cool/global.go

@@ -22,8 +22,14 @@ var ctx = context.TODO()
 type Cmd struct {
 	Func reflect.Value //方法函数
 	Req  reflect.Type  //请求体
+	// HeaderFieldIndex 是请求结构体中 TomeeHeader 字段的索引路径。
+	HeaderFieldIndex []int
+	// UseConn 标记第二个参数是否为 gnet.Conn。
+	UseConn bool
 	// 新增：预缓存的req创建函数（返回结构体指针）
 	NewReqFunc func() interface{}
+	// NewReqValue 返回请求结构体指针的 reflect.Value，避免重复构造类型信息。
+	NewReqValue func() reflect.Value
 	//Res  reflect.Value //返回体
 }
 

common/cool/initdb.go

@@ -3,6 +3,7 @@ package cool
 import (
 	_ "blazing/contrib/drivers/pgsql"
 	"blazing/cool/cooldb"
+	"sync"
 
 	"github.com/gogf/gf/v2/encoding/gjson"
 	"github.com/gogf/gf/v2/frame/g"
@@ -10,6 +11,11 @@ import (
 	"gorm.io/gorm"
 )
 
+var (
+	autoMigrateMu     sync.Mutex
+	autoMigrateModels []IModel
+)
+
 // 初始化数据库连接供gorm使用
 func InitDB(group string) (*gorm.DB, error) {
 	// var ctx context.Context
@@ -54,9 +60,39 @@ func getDBbyModel(model IModel) *gorm.DB {
 
 // 根据entity结构体创建表
 func CreateTable(model IModel) error {
-	if Config.AutoMigrate {
+	autoMigrateMu.Lock()
+	autoMigrateModels = append(autoMigrateModels, model)
+	autoMigrateMu.Unlock()
+
+	if !Config.AutoMigrate {
+		return nil
+	}
+
+	db := getDBbyModel(model)
+	return db.AutoMigrate(model)
+}
+
+// RunAutoMigrate 显式执行已注册模型的建表/迁移。
+func RunAutoMigrate() error {
+	if !Config.AutoMigrate {
+		return nil
+	}
+	autoMigrateMu.Lock()
+	models := append([]IModel(nil), autoMigrateModels...)
+	autoMigrateMu.Unlock()
+
+	seen := make(map[string]struct{}, len(models))
+	for _, model := range models {
+		key := model.GroupName() + ":" + model.TableName()
+		if _, ok := seen[key]; ok {
+			continue
+		}
+		seen[key] = struct{}{}
+
 		db := getDBbyModel(model)
-		return db.AutoMigrate(model)
+		if err := db.AutoMigrate(model); err != nil {
+			return err
+		}
 	}
 	return nil
 }

common/cool/rpc.go

@@ -1,25 +1,27 @@
 package cool
 
+import "blazing/cool/coolconfig"
+
 // 存值示例
 func AddClient(id uint32, client *ClientHandler) {
 	// 普通map：Clientmap[id] = client
 	Clientmap.Store(id, client) // sync.Map存值
 }
 
-// 清理指定client（uid=100000*onlineID+port）
+// 清理指定 client（高 16 位 serverID，低 16 位 port）
 func DeleteClientOnly(uid uint32) {
 	Clientmap.Delete(uid)
 }
 
-// 清理指定client（onlineID+port）
+// 清理指定 client（由 serverID 和 port 组合）
 func DeleteClient(id, port uint32) {
-	Clientmap.Delete(100000*id + port)
+	Clientmap.Delete(coolconfig.ComposeRuntimeID(id, port))
 }
 
 // 取值示例
 func GetClient(id, port uint32) (*ClientHandler, bool) {
 	// 普通map：client, ok := Clientmap[id]
-	val, ok := Clientmap.Load(100000*id + port) // sync.Map取值
+	val, ok := Clientmap.Load(coolconfig.ComposeRuntimeID(id, port)) // sync.Map取值
 	if !ok {
 		return nil, false
 	}

common/data/Element/element.go

@@ -42,15 +42,15 @@ const (
 	maxMatrixSize = 227 // 矩阵维度（覆盖最大属性ID 226）
 )
 
-// 合法单属性ID集合（快速校验）
+// 合法单属性ID集合（按ID直接索引，避免运行时 map 查找）
-var validSingleElementIDs = map[int]bool{
+var validSingleElementIDs = [maxMatrixSize]bool{
 	1: true, 2: true, 3: true, 4: true, 5: true, 6: true, 7: true, 8: true, 9: true, 10: true,
 	11: true, 12: true, 13: true, 14: true, 15: true, 16: true, 17: true, 18: true, 19: true, 20: true,
 	221: true, 222: true, 223: true, 224: true, 225: true, 226: true,
 }
 
-// 元素名称映射（全属性对应，便于日志输出）
+// 元素名称映射（按ID直接索引，便于日志输出）
-var elementNameMap = map[ElementType]string{
+var elementNameMap = [maxMatrixSize]string{
 	ElementTypeGrass:     "GRASS",
 	ElementTypeWater:     "WATER",
 	ElementTypeFire:      "FIRE",
@@ -198,46 +198,55 @@ type ElementCombination struct {
 	ID        int          // 组合唯一ID
 }
 
-// 全局预加载资源（程序启动时init初始化，运行时直接使用）
+// 全局预加载资源（程序启动时初始化，运行时只读）
 var (
-	// 元素组合池：key=组合ID，value=组合实例（预加载所有合法组合）
+	validCombinationIDs      [maxMatrixSize]bool
-	elementCombinationPool = make(map[int]*ElementCombination, 150) // 128双+26单=154，预分配足够容量
+	elementCombinationPool   [maxMatrixSize]ElementCombination
-	// 单属性克制矩阵（预初始化所有特殊克制关系，默认1.0）
+	dualElementSecondaryPool [maxMatrixSize]ElementType
-	matrix [maxMatrixSize][maxMatrixSize]float64
+	matrix                   [maxMatrixSize][maxMatrixSize]float64
+	Calculator               *ElementCalculator
 )
 
 // init 预加载所有资源（程序启动时执行一次，无并发问题）
 func init() {
-	// 1. 初始化单属性克制矩阵
 	initFullTableMatrix()
+	initElementCombinationPool()
+	Calculator = NewElementCalculator()
+}
 
-	// 2. 预加载所有单属性组合
+func initElementCombinationPool() {
-	for id := range validSingleElementIDs {
+	for id, valid := range validSingleElementIDs {
-		combo := &ElementCombination{
+		if !valid {
-			Primary:   ElementType(id),
+			continue
-			Secondary: nil,
+		}
-			ID:        id,
+		validCombinationIDs[id] = true
+		elementCombinationPool[id] = ElementCombination{
+			Primary: ElementType(id),
+			ID:      id,
 		}
-		elementCombinationPool[id] = combo
 	}
 
-	// 3. 预加载所有双属性组合
 	for dualID, atts := range dualElementMap {
 		primaryID, secondaryID := atts[0], atts[1]
-		// 按ID升序排序，保证组合一致性
 		primary, secondary := ElementType(primaryID), ElementType(secondaryID)
 		if primary > secondary {
 			primary, secondary = secondary, primary
 		}
-		combo := &ElementCombination{
+
+		dualElementSecondaryPool[dualID] = secondary
+		validCombinationIDs[dualID] = true
+		elementCombinationPool[dualID] = ElementCombination{
 			Primary:   primary,
-			Secondary: &secondary,
+			Secondary: &dualElementSecondaryPool[dualID],
 			ID:        dualID,
 		}
-		elementCombinationPool[dualID] = combo
 	}
 }
 
+func isValidCombinationID(id int) bool {
+	return id > 0 && id < maxMatrixSize && validCombinationIDs[id]
+}
+
 // IsDual 判断是否为双属性
 func (ec *ElementCombination) IsDual() bool {
 	return ec.Secondary != nil
@@ -245,84 +254,82 @@ func (ec *ElementCombination) IsDual() bool {
 
 // Elements 获取所有属性列表
 func (ec *ElementCombination) Elements() []ElementType {
-	if ec.IsDual() {
+	if secondary := ec.Secondary; secondary != nil {
-		return []ElementType{ec.Primary, *ec.Secondary}
+		return []ElementType{ec.Primary, *secondary}
 	}
 	return []ElementType{ec.Primary}
 }
 
 // String 友好格式化输出
 func (ec *ElementCombination) String() string {
-	primaryName := elementNameMap[ec.Primary]
+	if secondary := ec.Secondary; secondary != nil {
-	if !ec.IsDual() {
+		return fmt.Sprintf("(%s, %s)", elementNameMap[ec.Primary], elementNameMap[*secondary])
-		return fmt.Sprintf("(%s)", primaryName)
 	}
-	return fmt.Sprintf("(%s, %s)", primaryName, elementNameMap[*ec.Secondary])
+	return fmt.Sprintf("(%s)", elementNameMap[ec.Primary])
 }
 
-// ElementCalculator 无锁元素克制计算器（依赖预加载资源）
+// ElementCalculator 无锁元素克制计算器（所有倍数在初始化阶段预计算）
 type ElementCalculator struct {
-	offensiveCache map[string]float64 // 攻击克制缓存（运行时填充，无并发写）
+	offensiveTable [maxMatrixSize][maxMatrixSize]float64
 }
 
-// NewElementCalculator 创建计算器实例（仅初始化缓存）
+// NewElementCalculator 创建计算器实例（构建只读查表缓存）
 func NewElementCalculator() *ElementCalculator {
-	return &ElementCalculator{
+	c := &ElementCalculator{}
-		offensiveCache: make(map[string]float64, 4096), // 预分配大容量缓存
+	c.initOffensiveTable()
+	return c
+}
+
+func (c *ElementCalculator) initOffensiveTable() {
+	for attackerID, valid := range validCombinationIDs {
+		if !valid {
+			continue
+		}
+		attacker := &elementCombinationPool[attackerID]
+		for defenderID, valid := range validCombinationIDs {
+			if !valid {
+				continue
+			}
+			defender := &elementCombinationPool[defenderID]
+			c.offensiveTable[attackerID][defenderID] = c.calculateMultiplier(attacker, defender)
+		}
 	}
 }
 
 // getMatrixValue 直接返回矩阵值（修复核心问题：不再将0转换为1）
 func (c *ElementCalculator) getMatrixValue(attacker, defender ElementType) float64 {
-	return matrix[attacker][defender] // 矩阵默认已初始化1.0，特殊值直接返回
+	return matrix[attacker][defender]
 }
 
-// GetCombination 获取元素组合（直接从预加载池读取）
+// GetCombination 获取元素组合（直接按ID索引）
 func (c *ElementCalculator) GetCombination(id int) (*ElementCombination, error) {
-	combo, exists := elementCombinationPool[id]
+	if !isValidCombinationID(id) {
-	if !exists {
 		return nil, fmt.Errorf("invalid element combination ID: %d", id)
 	}
-	return combo, nil
+	return &elementCombinationPool[id], nil
 }
 
-// GetOffensiveMultiplier 计算攻击方→防御方的克制倍数（缓存优先）
+// GetOffensiveMultiplier 计算攻击方→防御方的克制倍数（只读查表）
 func (c *ElementCalculator) GetOffensiveMultiplier(attackerID, defenderID int) (float64, error) {
-	// 1. 获取预加载的组合实例
+	if !isValidCombinationID(attackerID) {
-	attacker, err := c.GetCombination(attackerID)
+		return 0, fmt.Errorf("attacker invalid: invalid element combination ID: %d", attackerID)
-	if err != nil {
-		return 0, fmt.Errorf("attacker invalid: %w", err)
 	}
-	defender, err := c.GetCombination(defenderID)
+	if !isValidCombinationID(defenderID) {
-	if err != nil {
+		return 0, fmt.Errorf("defender invalid: invalid element combination ID: %d", defenderID)
-		return 0, fmt.Errorf("defender invalid: %w", err)
 	}
-
+	return c.offensiveTable[attackerID][defenderID], nil
-	// 2. 缓存键（全局唯一）
-	cacheKey := fmt.Sprintf("a%d_d%d", attackerID, defenderID)
-	if val, exists := c.offensiveCache[cacheKey]; exists {
-		return val, nil
-	}
-
-	// 3. 核心计算+缓存
-	val := c.calculateMultiplier(attacker, defender)
-	c.offensiveCache[cacheKey] = val
-	return val, nil
 }
 
 // calculateMultiplier 核心克制计算逻辑
 func (c *ElementCalculator) calculateMultiplier(attacker, defender *ElementCombination) float64 {
-	// 场景1：单→单
 	if !attacker.IsDual() && !defender.IsDual() {
 		return c.getMatrixValue(attacker.Primary, defender.Primary)
 	}
 
-	// 场景2：单→双
 	if !attacker.IsDual() {
 		y1, y2 := defender.Primary, *defender.Secondary
 		m1 := c.getMatrixValue(attacker.Primary, y1)
 		m2 := c.getMatrixValue(attacker.Primary, y2)
-
 		switch {
 		case m1 == 2 && m2 == 2:
 			return 4.0
@@ -333,12 +340,10 @@ func (c *ElementCalculator) calculateMultiplier(attacker, defender *ElementCombi
 		}
 	}
 
-	// 场景3：双→单
 	if !defender.IsDual() {
 		return c.calculateDualToSingle(attacker.Primary, *attacker.Secondary, defender.Primary)
 	}
 
-	// 场景4：双→双
 	x1, x2 := attacker.Primary, *attacker.Secondary
 	y1, y2 := defender.Primary, *defender.Secondary
 	coeffY1 := c.calculateDualToSingle(x1, x2, y1)
@@ -350,7 +355,6 @@ func (c *ElementCalculator) calculateMultiplier(attacker, defender *ElementCombi
 func (c *ElementCalculator) calculateDualToSingle(attacker1, attacker2, defender ElementType) float64 {
 	k1 := c.getMatrixValue(attacker1, defender)
 	k2 := c.getMatrixValue(attacker2, defender)
-
 	switch {
 	case k1 == 2 && k2 == 2:
 		return 4.0
@@ -361,60 +365,49 @@ func (c *ElementCalculator) calculateDualToSingle(attacker1, attacker2, defender
 	}
 }
 
-var Calculator = NewElementCalculator()
-
 // TestAllScenarios 全场景测试（验证预加载和计算逻辑）
 func TestAllScenarios() {
-
-	// 测试1：单→单（草→水）
 	m1, _ := Calculator.GetOffensiveMultiplier(1, 2)
 	fmt.Println("草→水: %.2f（预期2.0）", m1)
 	if math.Abs(m1-2.0) > 0.001 {
 		fmt.Println("测试1失败：实际%.2f", m1)
 	}
 
-	// 测试2：特殊单→单（混沌→虚空）
 	m2, _ := Calculator.GetOffensiveMultiplier(222, 226)
 	fmt.Println("混沌→虚空: %.2f（预期0.0）", m2)
 	if math.Abs(m2-0.0) > 0.001 {
 		fmt.Println("测试2失败：实际%.2f", m2)
 	}
 
-	// 测试3：单→双（火→冰龙（43））
 	m3, _ := Calculator.GetOffensiveMultiplier(3, 43)
 	fmt.Println("火→冰龙: %.2f（预期1.5）", m3)
 	if math.Abs(m3-1.5) > 0.001 {
 		fmt.Println("测试3失败：实际%.2f", m3)
 	}
 
-	// 测试4：双→特殊单（混沌暗影（92）→神灵（223））
 	m4, _ := Calculator.GetOffensiveMultiplier(92, 223)
 	fmt.Println("混沌暗影→神灵: %.2f（预期1.25）", m4)
 	if math.Abs(m4-1.25) > 0.001 {
 		fmt.Println("测试4失败：实际%.2f", m4)
 	}
 
-	// 测试5：双→双（虚空邪灵（113）→混沌远古（98））
 	m5, _ := Calculator.GetOffensiveMultiplier(113, 98)
 	fmt.Println("虚空邪灵→混沌远古: %.2f（预期0.875", m5)
 	if math.Abs(m5-0.875) > 0.001 {
 		fmt.Println("测试5失败：实际%.2f", m5)
 	}
 
-	// 测试6：缓存命中
 	m6, _ := Calculator.GetOffensiveMultiplier(113, 98)
 	if math.Abs(m6-m5) > 0.001 {
 		fmt.Println("测试6失败：缓存未命中")
 	}
 
-	// 测试7：含无效组合（电→地面）
 	m7, _ := Calculator.GetOffensiveMultiplier(5, 7)
 	fmt.Println("电→地面: %.2f（预期0.0）", m7)
 	if math.Abs(m7-0.0) > 0.001 {
 		fmt.Println("测试7失败：实际%.2f", m7)
 	}
 
-	// 测试8：双属性含无效（电战斗→地面）
 	m8, _ := Calculator.GetOffensiveMultiplier(35, 7)
 	fmt.Println("电战斗→地面: %.2f（预期0.25）", m8)
 	if math.Abs(m8-0.25) > 0.001 {

common/data/xmlres/effectarg.go

@@ -5,7 +5,7 @@ type EffectArg struct {
 		SideEffect []struct {
 			ID                 int    `json:"ID"`
 			SideEffectArgcount int    `json:"SideEffectArgcount"`
-			SideEffectArg      string `json:"SideEffectArg,omitempty"`
+			SideEffectArg      rawFlexibleString `json:"SideEffectArg,omitempty"`
 		} `json:"SideEffect"`
 	} `json:"SideEffects"`
 }

common/data/xmlres/file.go

@@ -5,7 +5,7 @@ import (
 
 	_ "blazing/common/data/xmlres/packed"
 	"encoding/json"
-	"os"
+	"fmt"
 
 	"github.com/ECUST-XX/xml"
 	"github.com/gogf/gf/v2/os/gres"
@@ -14,22 +14,36 @@ import (
 
 var path string
 
+func readConfigContent(path string) []byte {
+	return gres.GetContent(path)
+}
+
 func getXml[T any](path string) T {
 
 	// 解析XML到结构体
 	var xmls T
 
-	t1 := gres.GetContent(path)
+	t1 := readConfigContent(path)
 	xml.Unmarshal(t1, &xmls)
 
 	return xmls
 }
 func getJson[T any](path string) T {
 
-	// 解析XML到结构体
+	// 解析JSON到结构体
 	var xmls T
-	t1 := gres.GetContent(path)
+	t1 := readConfigContent(path)
-	json.Unmarshal(t1, &xmls)
+	if len(t1) == 0 {
+		fmt.Printf("[xmlres] getJson empty content: path=%s\n", path)
+		return xmls
+	}
+	if err := json.Unmarshal(t1, &xmls); err != nil {
+		head := string(t1)
+		if len(head) > 300 {
+			head = head[:300]
+		}
+		fmt.Printf("[xmlres] getJson unmarshal failed: path=%s len=%d err=%v head=%q\n", path, len(t1), err, head)
+	}
 
 	return xmls
 }
@@ -58,8 +72,6 @@ var (
 
 func Initfile() {
 	//gres.Dump()
-	path1, _ := os.Getwd()
-	path = path1 + "/public/config/"
 	path = "config/"
 	MapConfig = getXml[Maps](path + "210.xml")
 
@@ -87,10 +99,10 @@ func Initfile() {
 		return gconv.Int(m.ProductID)
 
 	})
-	Skill := getXml[MovesTbl](path + "227.xml")
+	skillConfig := getJson[MovesJSON](path + "moves_flash.json")
 
-	SkillMap = make(map[int]Move, len(Skill.Moves))
+	SkillMap = make(map[int]Move, len(skillConfig.MovesTbl.Moves.Move))
-	for _, v := range Skill.Moves {
+	for _, v := range skillConfig.MovesTbl.Moves.Move {
 		v.SideEffectS = ParseSideEffectArgs(v.SideEffect)
 		v.SideEffectArgS = ParseSideEffectArgs(v.SideEffectArg)
 		SkillMap[v.ID] = v

common/data/xmlres/json_compat_test.go

@@ -0,0 +1,26 @@
+package xmlres
+
+import (
+	"encoding/json"
+	"testing"
+)
+
+func TestMoveUnmarshalJSONAcceptsNumericName(t *testing.T) {
+	var move Move
+	if err := json.Unmarshal([]byte(`{"ID":10001,"Name":1,"Category":1,"Type":8,"Power":35,"MaxPP":35,"Accuracy":95}`), &move); err != nil {
+		t.Fatalf("unmarshal move failed: %v", err)
+	}
+	if move.Name != "1" {
+		t.Fatalf("expected numeric name to convert to string, got %q", move.Name)
+	}
+}
+
+func TestEffectArgUnmarshalJSONAcceptsNumericSideEffectArg(t *testing.T) {
+	var cfg EffectArg
+	if err := json.Unmarshal([]byte(`{"SideEffects":{"SideEffect":[{"ID":1,"SideEffectArgcount":1,"SideEffectArg":3}]}}`), &cfg); err != nil {
+		t.Fatalf("unmarshal effect arg failed: %v", err)
+	}
+	if got := string(cfg.SideEffects.SideEffect[0].SideEffectArg); got != "3" {
+		t.Fatalf("expected numeric side effect arg to convert to string, got %q", got)
+	}
+}

common/data/xmlres/skill.go

@@ -1,6 +1,7 @@
 package xmlres
 
 import (
+	"encoding/json"
 	"encoding/xml"
 	"fmt"
 	"io"
@@ -33,52 +34,156 @@ type MovesTbl struct {
 	Moves   []Move       `xml:"Moves>Move"`
 	EFF     []SideEffect `xml:"SideEffects>SideEffect"`
 }
+
+type MovesJSON struct {
+	MovesTbl MovesJSONRoot `json:"MovesTbl"`
+}
+
+type MovesJSONRoot struct {
+	Moves struct {
+		Move []Move `json:"Move"`
+	} `json:"Moves"`
+	SideEffects struct {
+		SideEffect []SideEffect `json:"SideEffect"`
+	} `json:"SideEffects"`
+}
+
 type MovesMap struct {
 	XMLName xml.Name `xml:"MovesTbl"`
 	Moves   map[int]Move
 	EFF     []SideEffect `xml:"SideEffects>SideEffect"`
 }
 
+type rawFlexibleString string
+
+func (s *rawFlexibleString) UnmarshalJSON(data []byte) error {
+	text := strings.TrimSpace(string(data))
+	if text == "" || text == "null" {
+		*s = ""
+		return nil
+	}
+
+	if len(text) >= 2 && text[0] == '"' && text[len(text)-1] == '"' {
+		var decoded string
+		if err := json.Unmarshal(data, &decoded); err != nil {
+			return err
+		}
+		*s = rawFlexibleString(decoded)
+		return nil
+	}
+
+	*s = rawFlexibleString(text)
+	return nil
+}
+
 // Move 定义单个技能的结构
 type Move struct {
-	ID   int    `xml:"ID,attr"`
+	ID   int    `xml:"ID,attr" json:"ID"`
-	Name string `xml:"Name,attr"`
+	Name string `xml:"Name,attr" json:"Name"`
 
-	Category       int    `xml:"Category,attr"`                 //属性
+	Category       int    `xml:"Category,attr" json:"Category"`                                 //属性
-	Type           int    `xml:"Type,attr"`                     //类型
+	Type           int    `xml:"Type,attr" json:"Type"`                                         //类型
-	Power          int    `xml:"Power,attr"`                    //威力
+	Power          int    `xml:"Power,attr" json:"Power"`                                       //威力
-	MaxPP          int    `xml:"MaxPP,attr"`                    //最大PP
+	MaxPP          int    `xml:"MaxPP,attr" json:"MaxPP"`                                       //最大PP
-	Accuracy       int    `xml:"Accuracy,attr"`                 //命中率
+	Accuracy       int    `xml:"Accuracy,attr" json:"Accuracy"`                                 //命中率
-	CritRate       int    `xml:"CritRate,attr,omitempty"`       //暴击率
+	CritRate       int    `xml:"CritRate,attr,omitempty" json:"CritRate,omitempty"`             //暴击率
-	Priority       int    `xml:"Priority,attr,omitempty"`       //优先级
+	Priority       int    `xml:"Priority,attr,omitempty" json:"Priority,omitempty"`             //优先级
-	MustHit        int    `xml:"MustHit,attr,omitempty"`        //是否必中
+	MustHit        int    `xml:"MustHit,attr,omitempty" json:"MustHit,omitempty"`               //是否必中
-	SwapElemType   int    `xml:"SwapElemType,attr,omitempty"`   //技能交换属性
+	SwapElemType   int    `xml:"SwapElemType,attr,omitempty" json:"SwapElemType,omitempty"`     //技能交换属性
-	CopyElemType   int    `xml:"CopyElemType,attr,omitempty"`   // 技能复制属性
+	CopyElemType   int    `xml:"CopyElemType,attr,omitempty" json:"CopyElemType,omitempty"`     // 技能复制属性
-	CritAtkFirst   int    `xml:"CritAtkFirst,attr,omitempty"`   // 先出手时必定致命一击
+	CritAtkFirst   int    `xml:"CritAtkFirst,attr,omitempty" json:"CritAtkFirst,omitempty"`     // 先出手时必定致命一击
-	CritAtkSecond  int    `xml:"CritAtkSecond,attr,omitempty"`  //后出手时必定致命一击
+	CritAtkSecond  int    `xml:"CritAtkSecond,attr,omitempty" json:"CritAtkSecond,omitempty"`   //后出手时必定致命一击
-	CritSelfHalfHp int    `xml:"CritSelfHalfHp,attr,omitempty"` //自身体力低于一半时必定致命一击
+	CritSelfHalfHp int    `xml:"CritSelfHalfHp,attr,omitempty" json:"CritSelfHalfHp,omitempty"` //自身体力低于一半时必定致命一击
-	CritFoeHalfHp  int    `xml:"CritFoeHalfHp,attr,omitempty"`  //对方体力低于一半时必定致命一击
+	CritFoeHalfHp  int    `xml:"CritFoeHalfHp,attr,omitempty" json:"CritFoeHalfHp,omitempty"`   //对方体力低于一半时必定致命一击
-	DmgBindLv      int    `xml:"DmgBindLv,attr,omitempty"`      //使对方受到的伤害值等于自身的等级
+	DmgBindLv      int    `xml:"DmgBindLv,attr,omitempty" json:"DmgBindLv,omitempty"`           //使对方受到的伤害值等于自身的等级
-	PwrBindDv      int    `xml:"PwrBindDv,attr,omitempty"`      //威力（power）取决于自身的潜力（个体值）
+	PwrBindDv      int    `xml:"PwrBindDv,attr,omitempty" json:"PwrBindDv,omitempty"`           //威力（power）取决于自身的潜力（个体值）
-	PwrDouble      int    `xml:"PwrDouble,attr,omitempty"`      //攻击时，若对方处于异常状态, 则威力翻倍;
+	PwrDouble      int    `xml:"PwrDouble,attr,omitempty" json:"PwrDouble,omitempty"`           //攻击时，若对方处于异常状态, 则威力翻倍;
-	DmgBindHpDv    int    `xml:"DmgBindHpDv,attr,omitempty"`    //使对方受到的伤害值等于自身的体力值
+	DmgBindHpDv    int    `xml:"DmgBindHpDv,attr,omitempty" json:"DmgBindHpDv,omitempty"`       //使对方受到的伤害值等于自身的体力值
-	SideEffect     string `xml:"SideEffect,attr,omitempty"`
+	SideEffect     string `xml:"SideEffect,attr,omitempty" json:"SideEffect,omitempty"`
-	SideEffectArg  string `xml:"SideEffectArg,attr,omitempty"`
+	SideEffectArg  string `xml:"SideEffectArg,attr,omitempty" json:"SideEffectArg,omitempty"`
 	SideEffectS    []int
 	SideEffectArgS []int
-	AtkNum         int    `xml:"AtkNum,attr,omitempty"`
+	AtkNum         int    `xml:"AtkNum,attr,omitempty" json:"AtkNum,omitempty"`
-	AtkType        int    `xml:"AtkType,attr,omitempty"` // 0:所有人 1:仅己方 2:仅对方 3:仅自己
+	AtkType        int    `xml:"AtkType,attr,omitempty" json:"AtkType,omitempty"` // 0:所有人 1:仅己方 2:仅对方 3:仅自己
-	Url            string `xml:"Url,attr,omitempty"`
+	Url            string `xml:"Url,attr,omitempty" json:"Url,omitempty"`
 
-	Info string `xml:"info,attr,omitempty"`
+	Info string `xml:"info,attr,omitempty" json:"info,omitempty"`
 
-	CD *int `xml:"CD,attr"`
+	CD *int `xml:"CD,attr" json:"CD"`
+}
+
+func (m *Move) UnmarshalJSON(data []byte) error {
+	type moveAlias struct {
+		ID             int               `json:"ID"`
+		Name           rawFlexibleString `json:"Name"`
+		Category       int               `json:"Category"`
+		Type           int               `json:"Type"`
+		Power          int               `json:"Power"`
+		MaxPP          int               `json:"MaxPP"`
+		Accuracy       int               `json:"Accuracy"`
+		CritRate       int               `json:"CritRate,omitempty"`
+		Priority       int               `json:"Priority,omitempty"`
+		MustHit        int               `json:"MustHit,omitempty"`
+		SwapElemType   int               `json:"SwapElemType,omitempty"`
+		CopyElemType   int               `json:"CopyElemType,omitempty"`
+		CritAtkFirst   int               `json:"CritAtkFirst,omitempty"`
+		CritAtkSecond  int               `json:"CritAtkSecond,omitempty"`
+		CritSelfHalfHp int               `json:"CritSelfHalfHp,omitempty"`
+		CritFoeHalfHp  int               `json:"CritFoeHalfHp,omitempty"`
+		DmgBindLv      int               `json:"DmgBindLv,omitempty"`
+		PwrBindDv      int               `json:"PwrBindDv,omitempty"`
+		PwrDouble      int               `json:"PwrDouble,omitempty"`
+		DmgBindHpDv    int               `json:"DmgBindHpDv,omitempty"`
+		SideEffect     rawFlexibleString `json:"SideEffect,omitempty"`
+		SideEffectArg  rawFlexibleString `json:"SideEffectArg,omitempty"`
+		AtkNum         int               `json:"AtkNum,omitempty"`
+		AtkType        int               `json:"AtkType,omitempty"`
+		Url            string            `json:"Url,omitempty"`
+		Info           string            `json:"info,omitempty"`
+		CD             *int              `json:"CD"`
+	}
+
+	var aux moveAlias
+	if err := json.Unmarshal(data, &aux); err != nil {
+		return err
+	}
+
+	*m = Move{
+		ID:             aux.ID,
+		Name:           string(aux.Name),
+		Category:       aux.Category,
+		Type:           aux.Type,
+		Power:          aux.Power,
+		MaxPP:          aux.MaxPP,
+		Accuracy:       aux.Accuracy,
+		CritRate:       aux.CritRate,
+		Priority:       aux.Priority,
+		MustHit:        aux.MustHit,
+		SwapElemType:   aux.SwapElemType,
+		CopyElemType:   aux.CopyElemType,
+		CritAtkFirst:   aux.CritAtkFirst,
+		CritAtkSecond:  aux.CritAtkSecond,
+		CritSelfHalfHp: aux.CritSelfHalfHp,
+		CritFoeHalfHp:  aux.CritFoeHalfHp,
+		DmgBindLv:      aux.DmgBindLv,
+		PwrBindDv:      aux.PwrBindDv,
+		PwrDouble:      aux.PwrDouble,
+		DmgBindHpDv:    aux.DmgBindHpDv,
+		SideEffect:     string(aux.SideEffect),
+		SideEffectArg:  string(aux.SideEffectArg),
+		AtkNum:         aux.AtkNum,
+		AtkType:        aux.AtkType,
+		Url:            aux.Url,
+		Info:           aux.Info,
+		CD:             aux.CD,
+	}
+	return nil
 }
 
 type SideEffect struct {
-	ID   int    `xml:"ID,attr"`
+	ID   int    `xml:"ID,attr" json:"ID"`
-	Help string `xml:"help,attr"`
+	Help string `xml:"help,attr" json:"help"`
-	Des  string `xml:"des,attr"`
+	Des  string `xml:"des,attr" json:"des"`
 }
 
 // ReadHTTPFile 通过HTTP GET请求获取远程文件内容

common/rpc/func.go

@@ -4,7 +4,7 @@ import (
 	"blazing/cool"
 	"blazing/logic/service/fight/pvp"
 	"blazing/logic/service/fight/pvpwire"
-	"context"
+
 	"fmt"
 	"time"
 
@@ -15,7 +15,8 @@ import (
 )
 
 // ListenFunc 监听函数
-// ListenFunc 改造后的 Redis PubSub 监听函数，支持自动重连和心跳保活
+// ListenFunc 改造后的 Redis PubSub 监听函数，支持自动重连。
+// 注意：PubSub 连接只负责订阅和接收，避免在同一连接上并发 PING。
 func ListenFunc(ctx g.Ctx) {
 	if !cool.IsRedisMode {
 		panic(gerror.New("集群模式下, 请使用Redis作为缓存"))
@@ -23,9 +24,8 @@ func ListenFunc(ctx g.Ctx) {
 
 	// 定义常量配置
 	const (
-		subscribeTopic    = "cool:func"      // 订阅的主题
+		subscribeTopic = "cool:func"      // 订阅的主题
-		retryDelay        = 10 * time.Second // 连接失败重试间隔
+		retryDelay     = 10 * time.Second // 连接失败重试间隔
-		heartbeatInterval = 30 * time.Second // 心跳保活间隔
 	)
 
 	// 外层循环：负责连接断开后的整体重连
@@ -46,47 +46,25 @@ func ListenFunc(ctx g.Ctx) {
 			continue
 		}
 
-		// 2. 启动心跳保活协程，防止连接因空闲被断开
+		// 2. 订阅主题
-		heartbeatCtx, heartbeatCancel := context.WithCancel(context.Background())
-		go func() {
-			ticker := time.NewTicker(heartbeatInterval)
-			defer func() {
-				ticker.Stop()
-				heartbeatCancel()
-			}()
-
-			for {
-				select {
-				case <-heartbeatCtx.Done():
-					cool.Logger.Info(ctx, "心跳协程退出")
-					return
-				case <-ticker.C:
-					// 发送 PING 心跳，保持连接活跃
-					_, pingErr := conn.Do(ctx, "PING")
-					if pingErr != nil {
-						cool.Logger.Error(ctx, "Redis 心跳失败，触发重连", "error", pingErr)
-						// 心跳失败时主动关闭连接，触发外层重连
-						_ = conn.Close(ctx)
-						return
-					}
-
-				}
-			}
-		}()
-
-		// 3. 订阅主题
 		_, err = conn.Do(ctx, "subscribe", subscribeTopic)
 		if err != nil {
 			cool.Logger.Error(ctx, "订阅 Redis 主题失败", "topic", subscribeTopic, "error", err)
-			heartbeatCancel() // 关闭心跳协程
 			_ = conn.Close(ctx)
 			time.Sleep(retryDelay)
 			continue
 		}
 		cool.Logger.Info(ctx, "成功订阅 Redis 主题", "topic", subscribeTopic)
 		_, err = conn.Do(ctx, "subscribe", "sun:join") //加入队列
+		if err != nil {
+			cool.Logger.Error(ctx, "订阅 Redis 主题失败", "topic", "sun:join", "error", err)
+			_ = conn.Close(ctx)
+			time.Sleep(retryDelay)
+			continue
+		}
+		cool.Logger.Info(ctx, "成功订阅 Redis 主题", "topic", "sun:join")
 
-		// 4. 循环接收消息
+		// 3. 循环接收消息
 		connError := false
 		for !connError {
 			select {
@@ -129,15 +107,15 @@ func ListenFunc(ctx g.Ctx) {
 			}
 		}
 
-		// 5. 清理资源，准备重连
+		// 4. 清理资源，准备重连
-		heartbeatCancel()   // 关闭心跳协程
 		_ = conn.Close(ctx) // 关闭当前连接
-		//	Logger.Warn(ctx, "Redis 连接异常，准备重连", "retry_after", retryDelay)
+		cool.Logger.Info(ctx, "Redis 订阅连接异常，准备重连", "retry_after", retryDelay)
 		time.Sleep(retryDelay)
 	}
 }
 
-// ListenFight 完全对齐 ListenFunc 写法，修复收不到消息问题
+// ListenFight 完全对齐 ListenFunc 写法，修复收不到消息问题。
+// 注意：PubSub 连接只负责订阅和接收，避免在同一连接上并发 PING。
 func ListenFight(ctx g.Ctx) {
 	if !cool.IsRedisMode {
 		panic(gerror.New("集群模式下, 请使用Redis作为缓存"))
@@ -145,8 +123,7 @@ func ListenFight(ctx g.Ctx) {
 
 	// 定义常量配置（对齐 ListenFunc 风格）
 	const (
-		retryDelay        = 10 * time.Second // 连接失败重试间隔
+		retryDelay = 10 * time.Second // 连接失败重试间隔
-		heartbeatInterval = 30 * time.Second // 心跳保活间隔
 	)
 
 	// 提前拼接订阅主题（避免重复拼接，便于日志打印）
@@ -175,35 +152,7 @@ func ListenFight(ctx g.Ctx) {
 			continue
 		}
 
-		// 2. 启动心跳保活协程（完全对齐 ListenFunc 逻辑）
+		// 2. 订阅主题（对齐 ListenFunc 的错误处理，替换 panic 为优雅重连）
-		heartbeatCtx, heartbeatCancel := context.WithCancel(context.Background())
-		go func() {
-			ticker := time.NewTicker(heartbeatInterval)
-			defer func() {
-				ticker.Stop()
-				heartbeatCancel()
-			}()
-
-			for {
-				select {
-				case <-heartbeatCtx.Done():
-					cool.Logger.Info(ctx, "心跳协程退出")
-					return
-				case <-ticker.C:
-					// 发送 PING 心跳，保持连接活跃
-					_, pingErr := conn.Do(ctx, "PING")
-					if pingErr != nil {
-						cool.Logger.Error(ctx, "Redis 心跳失败，触发重连", "error", pingErr)
-						// 心跳失败时主动关闭连接，触发外层重连
-						_ = conn.Close(ctx)
-						return
-					}
-					cool.Logger.Debug(ctx, "Redis 心跳发送成功，连接正常")
-				}
-			}
-		}()
-
-		// 3. 订阅主题（对齐 ListenFunc 的错误处理，替换 panic 为优雅重连）
 		subscribeTopics := []string{startTopic, pvpServerTopic}
 		if cool.Config.GameOnlineID == pvp.CoordinatorOnlineID {
 			subscribeTopics = append(subscribeTopics, pvpCoordinatorTopic)
@@ -213,7 +162,6 @@ func ListenFight(ctx g.Ctx) {
 			_, err = conn.Do(ctx, "subscribe", topic)
 			if err != nil {
 				cool.Logger.Error(ctx, "订阅 Redis 主题失败", "topic", topic, "error", err)
-				heartbeatCancel()
 				_ = conn.Close(ctx)
 				time.Sleep(retryDelay)
 				subscribeFailed = true
@@ -239,7 +187,7 @@ func ListenFight(ctx g.Ctx) {
 		// 打印监听提示（保留原有日志）
 		fmt.Println("监听战斗", startTopic)
 
-		// 4. 循环接收消息（完全对齐 ListenFunc 逻辑）
+		// 3. 循环接收消息（完全对齐 ListenFunc 逻辑）
 		connError := false
 		for !connError {
 			select {
@@ -281,9 +229,9 @@ func ListenFight(ctx g.Ctx) {
 			}
 		}
 
-		// 5. 清理资源，准备重连（完全对齐 ListenFunc）
+		// 4. 清理资源，准备重连（完全对齐 ListenFunc）
-		heartbeatCancel()   // 关闭心跳协程
 		_ = conn.Close(ctx) // 关闭当前连接
+		cool.Logger.Info(ctx, "Redis 战斗订阅连接异常，准备重连", "retry_after", retryDelay)
 		time.Sleep(retryDelay)
 	}
 }

common/rpc/pvp_match.go

@@ -0,0 +1,184 @@
+package rpc
+
+import (
+	"blazing/cool"
+	"blazing/logic/service/fight/pvpwire"
+	"context"
+	"encoding/json"
+	"fmt"
+	"sync"
+	"time"
+)
+
+const (
+	pvpMatchQueueTTL      = 12 * time.Second
+	pvpMatchBanPickSecond = 45
+)
+
+type PVPMatchJoinPayload struct {
+	RuntimeServerID uint32   `json:"runtimeServerId"`
+	UserID          uint32   `json:"userId"`
+	Nick            string   `json:"nick"`
+	FightMode       uint32   `json:"fightMode"`
+	Status          uint32   `json:"status"`
+	IsVip           uint32   `json:"isVip"`
+	IsDebug         uint8    `json:"isDebug"`
+	CatchTimes      []uint32 `json:"catchTimes"`
+	TianxuanPetIDs  []uint32 `json:"tianxuanPetIds"`
+}
+
+type pvpMatchQueueKey struct {
+	FightMode uint32
+	IsVip     uint32
+	IsDebug   uint8
+}
+
+type pvpMatchCoordinator struct {
+	mu       sync.Mutex
+	queues   map[pvpMatchQueueKey][]pvpwire.QueuePlayerSnapshot
+	lastSeen map[uint32]time.Time
+}
+
+var defaultPVPMatchCoordinator = &pvpMatchCoordinator{
+	queues:   make(map[pvpMatchQueueKey][]pvpwire.QueuePlayerSnapshot),
+	lastSeen: make(map[uint32]time.Time),
+}
+
+func DefaultPVPMatchCoordinator() *pvpMatchCoordinator {
+	return defaultPVPMatchCoordinator
+}
+
+func (m *pvpMatchCoordinator) JoinOrUpdate(payload PVPMatchJoinPayload) error {
+	if payload.UserID == 0 || payload.RuntimeServerID == 0 || payload.FightMode == 0 {
+		return fmt.Errorf("invalid pvp match payload: uid=%d server=%d mode=%d", payload.UserID, payload.RuntimeServerID, payload.FightMode)
+	}
+
+	now := time.Now()
+	player := pvpwire.QueuePlayerSnapshot{
+		RuntimeServerID: payload.RuntimeServerID,
+		UserID:          payload.UserID,
+		Nick:            payload.Nick,
+		FightMode:       payload.FightMode,
+		Status:          payload.Status,
+		IsVip:           payload.IsVip,
+		IsDebug:         payload.IsDebug,
+		JoinedAtUnix:    now.Unix(),
+		CatchTimes:      append([]uint32(nil), payload.CatchTimes...),
+		TianxuanPetIDs:  append([]uint32(nil), payload.TianxuanPetIDs...),
+	}
+
+	var match *pvpwire.MatchFoundPayload
+
+	m.mu.Lock()
+	m.pruneExpiredLocked(now)
+	m.removeUserLocked(payload.UserID)
+	m.lastSeen[payload.UserID] = now
+
+	queueKey := newPVPMatchQueueKey(player)
+	queue := m.queues[queueKey]
+	if len(queue) > 0 {
+		host := queue[0]
+		queue = queue[1:]
+		m.queues[queueKey] = queue
+		delete(m.lastSeen, host.UserID)
+		delete(m.lastSeen, payload.UserID)
+
+		result := pvpwire.MatchFoundPayload{
+			SessionID:      buildPVPMatchSessionID(host.UserID, payload.UserID),
+			Stage:          pvpwire.StageBanPick,
+			Host:           host,
+			Guest:          player,
+			BanPickTimeout: pvpMatchBanPickSecond,
+		}
+		match = &result
+	} else {
+		m.queues[queueKey] = append(queue, player)
+	}
+	m.mu.Unlock()
+
+	if match == nil {
+		return nil
+	}
+	if err := publishPVPMatchMessage(pvpwire.ServerTopic(match.Host.RuntimeServerID), pvpwire.MessageTypeMatchFound, *match); err != nil {
+		return err
+	}
+	if match.Guest.RuntimeServerID != match.Host.RuntimeServerID {
+		if err := publishPVPMatchMessage(pvpwire.ServerTopic(match.Guest.RuntimeServerID), pvpwire.MessageTypeMatchFound, *match); err != nil {
+			return err
+		}
+	}
+	return nil
+}
+
+func (m *pvpMatchCoordinator) Cancel(userID uint32) {
+	if userID == 0 {
+		return
+	}
+	m.mu.Lock()
+	defer m.mu.Unlock()
+
+	delete(m.lastSeen, userID)
+	m.removeUserLocked(userID)
+}
+
+func (m *pvpMatchCoordinator) pruneExpiredLocked(now time.Time) {
+	for key, queue := range m.queues {
+		next := make([]pvpwire.QueuePlayerSnapshot, 0, len(queue))
+		for _, queued := range queue {
+			last := m.lastSeen[queued.UserID]
+			if last.IsZero() || now.Sub(last) > pvpMatchQueueTTL {
+				delete(m.lastSeen, queued.UserID)
+				continue
+			}
+			next = append(next, queued)
+		}
+		m.queues[key] = next
+	}
+}
+
+func (m *pvpMatchCoordinator) removeUserLocked(userID uint32) {
+	for key, queue := range m.queues {
+		next := make([]pvpwire.QueuePlayerSnapshot, 0, len(queue))
+		for _, queued := range queue {
+			if queued.UserID == userID {
+				continue
+			}
+			next = append(next, queued)
+		}
+		m.queues[key] = next
+	}
+}
+
+func newPVPMatchQueueKey(player pvpwire.QueuePlayerSnapshot) pvpMatchQueueKey {
+	return pvpMatchQueueKey{
+		FightMode: player.FightMode,
+		IsVip:     player.IsVip,
+		IsDebug:   player.IsDebug,
+	}
+}
+
+func publishPVPMatchMessage(topic, msgType string, body any) error {
+	payload, err := json.Marshal(body)
+	if err != nil {
+		return err
+	}
+	envelope, err := json.Marshal(pvpwire.Envelope{
+		Type: msgType,
+		Body: payload,
+	})
+	if err != nil {
+		return err
+	}
+	conn, err := cool.Redis.Conn(context.Background())
+	if err != nil {
+		return err
+	}
+	defer conn.Close(context.Background())
+
+	_, err = conn.Do(context.Background(), "publish", topic, envelope)
+	return err
+}
+
+func buildPVPMatchSessionID(hostUserID, guestUserID uint32) string {
+	return fmt.Sprintf("xsvr-%d-%d-%d", hostUserID, guestUserID, time.Now().UnixNano())
+}

common/rpc/rpc.go

@@ -3,10 +3,13 @@ package rpc
 import (
 	"blazing/common/data/share"
 	"blazing/cool"
+	"blazing/cool/coolconfig"
 
 	"context"
 	"fmt"
 	"log"
+	"net/url"
+	"strings"
 	"time"
 
 	config "blazing/modules/config/service"
@@ -19,6 +22,19 @@ import (
 type ServerHandler struct{}
 
 const kickForwardTimeout = 3 * time.Second
+const ClientCallTimeout = 5 * time.Second
+
+// A 服强关，留下僵尸在线状态：B 服可以通过 login 清理后登录。
+// login 服不可用：B 服不会放行，仍提示系统忙。
+func isDisconnectedLogicReverseClientError(err error) bool {
+	if err == nil {
+		return false
+	}
+	errText := err.Error()
+	return strings.Contains(errText, "websocket routine exiting") ||
+		strings.Contains(errText, "sendRequest failed") ||
+		strings.Contains(errText, "closed out channel")
+}
 
 // 实现踢人
 func (*ServerHandler) Kick(_ context.Context, userid uint32) error {
@@ -57,6 +73,11 @@ func (*ServerHandler) Kick(_ context.Context, userid uint32) error {
 			cool.DeleteClientOnly(useid2)
 			return nil
 		}
+		if isDisconnectedLogicReverseClientError(callErr) {
+			_ = share.ShareManager.DeleteUserOnline(userid)
+			cool.DeleteClientOnly(useid2)
+			return nil
+		}
 
 		// 仍在线则返回失败，不按成功处理
 		return callErr
@@ -79,28 +100,22 @@ func (*ServerHandler) Kick(_ context.Context, userid uint32) error {
 // 注册logic服务器
 func (*ServerHandler) RegisterLogic(ctx context.Context, id, port uint32) error {
 	fmt.Println("注册logic服务器", id, port)
+	return registerReverseLogicClient(ctx, id, port)
 
-	//TODO 待修复滚动更新可能导致的玩家可以同时在旧服务器和新服务器同时在线的bug
+}
-	revClient, ok := jsonrpc.ExtractReverseClient[cool.ClientHandler](ctx)
-	if !ok {
-		return fmt.Errorf("no reverse client")
-	}
-	t := config.NewServerService().GetServerID((id))
 
-	aa, ok := cool.GetClient(t.OnlineID, t.Port)
+func (*ServerHandler) MatchJoinOrUpdate(_ context.Context, payload PVPMatchJoinPayload) error {
-	if ok && aa != nil { //如果已经存在且这个端口已经被存过
+	return DefaultPVPMatchCoordinator().JoinOrUpdate(payload)
-		aa.QuitSelf(0)
+}
-	}
-	cool.AddClient(100000*id+port, &revClient)
 
-	//Refurh()
+func (*ServerHandler) MatchCancel(_ context.Context, userID uint32) error {
+	DefaultPVPMatchCoordinator().Cancel(userID)
 	return nil
-
 }
 
 func CServer() *jsonrpc.RPCServer {
 	// create a new server instance
-	rpcServer := jsonrpc.NewServer(jsonrpc.WithReverseClient[cool.ClientHandler](""))
+	rpcServer := jsonrpc.NewServer(jsonrpc.WithReverseClientSetup[cool.ClientHandler]("", setupLogicReverseClient))
 
 	rpcServer.Register("", &ServerHandler{})
 
@@ -111,28 +126,35 @@ func CServer() *jsonrpc.RPCServer {
 var closer jsonrpc.ClientCloser
 
 func StartClient(id, port uint32, callback any) *struct {
-	Kick func(uint32) error
+	Kick func(context.Context, uint32) error
 
-	RegisterLogic func(uint32, uint32) error
+	RegisterLogic func(context.Context, uint32, uint32) error
+
+	MatchJoinOrUpdate func(context.Context, PVPMatchJoinPayload) error
+
+	MatchCancel func(context.Context, uint32) error
 } {
-	//cool.Config.File.Domain = "127.0.0.1"
+	cool.Config.File.Domain = "127.0.0.1"
-	var rpcaddr = "ws://" + cool.Config.File.Domain + gconv.String(cool.Config.Address) + "/rpc"
+	u := url.URL{
+		Scheme: "ws",
+		Host:   cool.Config.File.Domain + gconv.String(cool.Config.Address),
+		Path:   "/rpc",
+	}
+	q := u.Query()
+	q.Set("logic_id", gconv.String(id))
+	q.Set("logic_port", gconv.String(port))
+	u.RawQuery = q.Encode()
+	rpcaddr := u.String()
 
 	closer1, err := jsonrpc.NewMergeClient(context.Background(),
 		rpcaddr, "", []interface{}{
 			&RPCClient,
 		}, nil, jsonrpc.WithClientHandler("", callback),
-		jsonrpc.WithReconnFun(func() { RPCClient.RegisterLogic(id, port) }),
 	)
 	if err != nil {
 		log.Fatalf("Failed to create client: %v", err)
 	}
 
-	//if port != 0 { //注册logic
-	defer RPCClient.RegisterLogic(id, port)
-
-	//}
-
 	closer = closer1
 
 	return &RPCClient
@@ -140,10 +162,55 @@ func StartClient(id, port uint32, callback any) *struct {
 
 // Setup RPCClient with reverse call handler
 var RPCClient struct {
-	Kick func(uint32) error //踢人
+	Kick func(context.Context, uint32) error //踢人
 
-	RegisterLogic func(uint32, uint32) error
+	RegisterLogic func(context.Context, uint32, uint32) error
+
+	MatchJoinOrUpdate func(context.Context, PVPMatchJoinPayload) error
+
+	MatchCancel func(context.Context, uint32) error
 
 	//	UserLogin  func(int32, int32) error //用户登录事件
 	//	UserLogout func(int32, int32) error //用户登出事件
 }
+
+func setupLogicReverseClient(ctx context.Context, revClient cool.ClientHandler) error {
+	_ = revClient
+	req, ok := jsonrpc.GetHTTPRequest(ctx)
+	if !ok || req == nil {
+		return fmt.Errorf("missing websocket request context")
+	}
+
+	id := gconv.Uint32(req.URL.Query().Get("logic_id"))
+	port := gconv.Uint32(req.URL.Query().Get("logic_port"))
+	if id == 0 || port == 0 {
+		return fmt.Errorf("missing logic identity in websocket query: id=%d port=%d", id, port)
+	}
+
+	if err := registerReverseLogicClient(ctx, id, port); err != nil {
+		return err
+	}
+
+	key := coolconfig.ComposeRuntimeID(id, port)
+	go func() {
+		<-ctx.Done()
+		cool.DeleteClientOnly(key)
+	}()
+	return nil
+}
+
+func registerReverseLogicClient(ctx context.Context, id, port uint32) error {
+	//TODO 待修复滚动更新可能导致的玩家可以同时在旧服务器和新服务器同时在线的bug
+	revClient, ok := jsonrpc.ExtractReverseClient[cool.ClientHandler](ctx)
+	if !ok {
+		return fmt.Errorf("no reverse client")
+	}
+	t := config.NewServerService().GetServerID(id)
+
+	aa, ok := cool.GetClient(t.OnlineID, t.Port)
+	if ok && aa != nil { //如果已经存在且这个端口已经被存过
+		aa.QuitSelf(0)
+	}
+	cool.AddClient(coolconfig.ComposeRuntimeID(id, port), &revClient)
+	return nil
+}

common/socket/ServerEvent.go

@@ -1,24 +1,29 @@
 package socket
 
 import (
+	"blazing/common/socket/codec"
+	"blazing/cool"
+	"blazing/logic/service/player"
+	"blazing/modules/config/service"
+	"bytes"
 	"context"
 	"encoding/binary"
 	"errors"
-	"io"
 	"log"
 	"os"
 	"sync/atomic"
 	"time"
 
-	"blazing/cool"
-	"blazing/logic/service/player"
-	"blazing/modules/config/service"
-
 	"github.com/gogf/gf/v2/frame/g"
 	"github.com/gogf/gf/v2/os/gtime"
 	"github.com/panjf2000/gnet/v2"
 )
 
+const (
+	minPacketLen = 17
+	maxPacketLen = 10 * 1024
+)
+
 func (s *Server) Boot(serverid, port uint32) error {
 	//	go s.bootws()
 	s.serverid = serverid
@@ -53,60 +58,43 @@ func (s *Server) Stop() error {
 func (s *Server) OnClose(c gnet.Conn, err error) (action gnet.Action) {
 	defer func() {
 		if err := recover(); err != nil { // 恢复 panic，err 为 panic 错误值
-			// 1. 打印错误信息
 			if t, ok := c.Context().(*player.ClientData); ok {
 				if t.Player != nil {
 					if t.Player.Info != nil {
 						cool.Logger.Error(context.TODO(), "OnClose 错误：", cool.Config.ServerInfo.OnlineID, t.Player.Info.UserID, err)
-						t.Player.Service.Info.Save(*t.Player.Info)
+						go t.Player.SaveOnDisconnect()
 					}
 
 				}
-
 			} else {
 				cool.Logger.Error(context.TODO(), "OnClose 错误：", cool.Config.ServerInfo.OnlineID, err)
-
 			}
-
 		}
 	}()
-	// 识别 RST 导致的连接中断（错误信息含 "connection reset"）
-	// if err != nil && (strings.Contains(err.Error(), "connection reset") || strings.Contains(err.Error(), "reset by peer")) {
-	// 	remoteIP := c.RemoteAddr().(*net.TCPAddr).IP.String()
 
-	// 	log.Printf("RST 攻击检测: 来源 %s, 累计攻击次数 %d", remoteIP)
-
-	// 	// 防护逻辑：临时封禁异常 IP（可扩展为 IP 黑名单）
-	// 	//	go s.tempBlockIP(remoteIP, 5*time.Minute)
-	// }
-	//fmt.Println(err, c.RemoteAddr().String(), "断开连接")
 	atomic.AddInt64(&cool.Connected, -1)
 
-	//logging.Infof("conn[%v] disconnected", c.RemoteAddr().String())
 	v, _ := c.Context().(*player.ClientData)
 	if v != nil {
 		v.Close()
 		if v.Player != nil {
-			v.Player.Save() //保存玩家数据
+			v.Player.SaveOnDisconnect() //保存玩家数据
 		}
 	}
-
-	//}
-	//关闭连接
 	return
 }
+
 func (s *Server) OnTick() (delay time.Duration, action gnet.Action) {
 	g.Log().Async().Info(context.Background(), gtime.Now().ISO8601(), "服务器ID", cool.Config.ServerInfo.OnlineID, "链接数", atomic.LoadInt64(&cool.Connected))
 	if s.quit && atomic.LoadInt64(&cool.Connected) == 0 {
-		//执行正常退出逻辑
 		os.Exit(0)
 	}
 	return 30 * time.Second, gnet.None
 }
+
 func (s *Server) OnBoot(eng gnet.Engine) gnet.Action {
 	s.eng = eng
-
+	service.NewServerService().SetServerID(s.serverid, s.port)
-	service.NewServerService().SetServerID(s.serverid, s.port) //设置当前服务器端口
 	return gnet.None
 }
 
@@ -114,59 +102,68 @@ func (s *Server) OnOpen(conn gnet.Conn) (out []byte, action gnet.Action) {
 	if s.network != "tcp" {
 		return nil, gnet.Close
 	}
-
 	if conn.Context() == nil {
-		conn.SetContext(player.NewClientData(conn)) //注入data
+		conn.SetContext(player.NewClientData(conn))
 	}
-
 	atomic.AddInt64(&cool.Connected, 1)
-
 	return nil, gnet.None
 }
 
 func (s *Server) OnTraffic(c gnet.Conn) (action gnet.Action) {
 	defer func() {
-		if err := recover(); err != nil { // 恢复 panic，err 为 panic 错误值
+		if err := recover(); err != nil {
-			// 1. 打印错误信息
 			if t, ok := c.Context().(*player.ClientData); ok {
-				if t.Player != nil {
+				if t.Player != nil && t.Player.Info != nil {
-					if t.Player.Info != nil {
+					cool.Logger.Error(context.TODO(), "OnTraffic 错误：", cool.Config.ServerInfo.OnlineID, t.Player.Info.UserID, err)
-						cool.Logger.Error(context.TODO(), "OnTraffic 错误：", cool.Config.ServerInfo.OnlineID, t.Player.Info.UserID, err)
+					t.Player.Service.Info.Save(*t.Player.Info)
-						t.Player.Service.Info.Save(*t.Player.Info)
-
-					}
-
 				}
-
 			}
-
 		}
 	}()
 
-	ws := c.Context().(*player.ClientData).Wsmsg
+	client := c.Context().(*player.ClientData)
-	if ws.Tcp { //升级失败时候防止缓冲区溢出
+	if s.discorse && !client.IsCrossDomainChecked() {
-		return s.handleTCP(c)
+		handled, ready, action := handle(c)
-
+		if action != gnet.None {
+			return action
+		}
+		if handled {
+			client.MarkCrossDomainChecked()
+			return gnet.None
+		}
+		if !ready {
+			return gnet.None
+		}
+		client.MarkCrossDomainChecked()
 	}
 
-	tt, len1 := ws.ReadBufferBytes(c)
+	ws := client.Wsmsg
-	if tt == gnet.Close {
+	if ws.Tcp {
+		return s.handleTCP(c)
+	}
 
+	readAction, inboundLen := ws.ReadBufferBytes(c)
+	if readAction == gnet.Close {
 		return gnet.Close
 	}
 
-	ok, action := ws.Upgrade(c)
+	state, action := ws.Upgrade(c)
-	if action != gnet.None { //连接断开
+	if action != gnet.None {
 		return action
 	}
-	if !ok { //升级失败,说明是tcp连接
+	if state == player.UpgradeNeedMoreData {
-		ws.Tcp = true
+		return gnet.None
-
+	}
-		return s.handleTCP(c)
+	if state == player.UpgradeUseTCP {
-
+		return s.handleTCP(c)
+	}
+
+	if inboundLen > 0 {
+		if _, err := c.Discard(inboundLen); err != nil {
+			return gnet.Close
+		}
+		ws.ResetInboundMirror()
 	}
-	//	fmt.Println(ws.Buf.Bytes())
-	c.Discard(len1)
 
 	messages, err := ws.Decode(c)
 	if err != nil {
@@ -177,91 +174,93 @@ func (s *Server) OnTraffic(c gnet.Conn) (action gnet.Action) {
 	}
 
 	for _, msg := range messages {
-
+		if !s.onevent(c, msg.Payload) {
-		s.onevent(c, msg.Payload)
+			return gnet.Close
-		//t.OnEvent(msg.Payload)
+		}
 	}
-
 	return gnet.None
 }
 
-const maxBodyLen = 10 * 1024 // 业务最大包体长度，按需调整
 func (s *Server) handleTCP(conn gnet.Conn) (action gnet.Action) {
+	client := conn.Context().(*player.ClientData)
+	if s.discorse && !client.IsCrossDomainChecked() {
+		handled, ready, action := handle(conn)
+		if action != gnet.None {
+			return action
+		}
+		if !ready {
+			return gnet.None
+		}
+		if handled {
+			client.MarkCrossDomainChecked()
+			return gnet.None
+		}
+		client.MarkCrossDomainChecked()
+	}
 
-	conn.Context().(*player.ClientData).IsCrossDomain.Do(func() { //跨域检测
+	body, err := s.codec.Decode(conn)
-		handle(conn)
-	})
-
-	//	handle(c)
-	// 先读取4字节的包长度
-	lenBuf, err := conn.Peek(4)
-
 	if err != nil {
-		if errors.Is(err, io.ErrShortBuffer) {
+		if errors.Is(err, codec.ErrIncompletePacket) {
-			return
+			return gnet.None
 		}
 		return gnet.Close
 	}
-
+	if !s.onevent(conn, body) {
-	bodyLen := binary.BigEndian.Uint32(lenBuf)
-
-	if bodyLen > maxBodyLen {
 		return gnet.Close
 	}
-
-	if conn.InboundBuffered() < int(bodyLen) {
-		return
-	}
-	// 提取包体
-	body, err := conn.Next(int(bodyLen))
-	if err != nil {
-		if errors.Is(err, io.ErrShortBuffer) {
-			return
-		}
-		return gnet.Close
-	}
-
-	s.onevent(conn, body)
-
 	if conn.InboundBuffered() > 0 {
-		if err := conn.Wake(nil); err != nil { // wake up the connection manually to avoid missing the leftover data
+		if err := conn.Wake(nil); err != nil {
-
 			return gnet.Close
 		}
 	}
 	return action
-
 }
 
-// CROSS_DOMAIN 定义跨域策略文件内容
 const CROSS_DOMAIN = "<?xml version=\"1.0\"?><!DOCTYPE cross-domain-policy><cross-domain-policy><allow-access-from domain=\"*\" to-ports=\"*\" /></cross-domain-policy>\x00"
-
-// TEXT 定义跨域请求的文本格式
 const TEXT = "<policy-file-request/>\x00"
 
-func handle(c gnet.Conn) {
+func handle(c gnet.Conn) (handled bool, ready bool, action gnet.Action) {
+	probeLen := c.InboundBuffered()
+	if probeLen == 0 {
+		return false, false, gnet.None
+	}
+	if probeLen > len(TEXT) {
+		probeLen = len(TEXT)
+	}
 
-	// 读取数据并检查是否为跨域请求
+	data, err := c.Peek(probeLen)
-	data, err := c.Peek(len(TEXT))
 	if err != nil {
 		log.Printf("Error reading cross-domain request: %v", err)
-		return
+		return false, false, gnet.Close
 	}
-
+	if !bytes.Equal(data, []byte(TEXT[:probeLen])) {
-	if string(data) == TEXT { //判断是否是跨域请求
+		return false, true, gnet.None
-		//log.Printf("Received cross-domain request from %s", c.RemoteAddr())
-		// 处理跨域请求
-		c.Write([]byte(CROSS_DOMAIN))
-		c.Discard(len(TEXT))
-
-		return
 	}
-
+	if probeLen < len(TEXT) {
-	//return
+		return false, false, gnet.None
+	}
+	if _, err := c.Write([]byte(CROSS_DOMAIN)); err != nil {
+		return false, true, gnet.Close
+	}
+	if _, err := c.Discard(len(TEXT)); err != nil {
+		return false, true, gnet.Close
+	}
+	return true, true, gnet.None
 }
 
-func (s *Server) onevent(c gnet.Conn, v []byte) {
+func (s *Server) onevent(c gnet.Conn, v []byte) bool {
+	if !isValidPacket(v) {
+		return false
+	}
 	if t, ok := c.Context().(*player.ClientData); ok {
 		t.PushEvent(v, s.workerPool.Submit)
 	}
+	return true
+}
+
+func isValidPacket(v []byte) bool {
+	if len(v) < minPacketLen || len(v) > maxPacketLen {
+		return false
+	}
+	return binary.BigEndian.Uint32(v[0:4]) == uint32(len(v))
 }

common/socket/errorcode/error.go

@@ -115,6 +115,10 @@ var ErrorCodes = enum.New[struct {
 	ErrPokemonLevelTooLow ErrorCode `enum:"13007"`
 	// 不能展示背包里的精灵！
 	ErrCannotShowBagPokemon ErrorCode `enum:"13017"`
+	// 基地展示精灵数量已达上限！
+	ErrRoomShowPetLimit ErrorCode `enum:"13019"`
+	// 该精灵不在仓库中，无法设为基地展示！
+	ErrPetNotInWarehouse ErrorCode `enum:"13021"`
 	// 你今天已经被吃掉过一回了,明天再来吧！
 	ErrAlreadyEatenToday ErrorCode `enum:"17018"`
 	// 该道具已经在使用中，无法重复使用。

common/utils/go-jsonrpc/client.go

@@ -344,7 +344,7 @@ func websocketClient(ctx context.Context, addr string, namespace string, outs []
 }
 
 func (c *client) setupRequestChan() chan clientRequest {
-	requests := make(chan clientRequest)
+	requests := make(chan clientRequest, 1024)
 
 	c.doRequest = func(ctx context.Context, cr clientRequest) (clientResponse, error) {
 		select {

common/utils/go-jsonrpc/options_server.go

@@ -75,33 +75,53 @@ func WithTracer(l Tracer) ServerOption {
 	}
 }
 
+func buildReverseClient[RP any](c *ServerConfig, ctx context.Context, conn *wsConn, namespace string, onConnect func(context.Context, RP) error) (context.Context, error) {
+	cl := client{
+		namespace:           namespace,
+		paramEncoders:       map[reflect.Type]ParamEncoder{},
+		methodNameFormatter: c.methodNameFormatter,
+	}
+
+	// todo test that everything is closing correctly
+	cl.exiting = conn.exiting
+
+	requests := cl.setupRequestChan()
+	conn.requests = requests
+
+	calls := new(RP)
+
+	err := cl.provide([]interface{}{
+		calls,
+	})
+	if err != nil {
+		return nil, xerrors.Errorf("provide reverse client calls: %w", err)
+	}
+
+	ctx = context.WithValue(ctx, jsonrpcReverseClient{reflect.TypeOf(calls).Elem()}, calls)
+	if onConnect != nil {
+		if err := onConnect(ctx, *calls); err != nil {
+			return nil, err
+		}
+	}
+	return ctx, nil
+}
+
 // WithReverseClient will allow extracting reverse client on **WEBSOCKET** calls.
 // RP is a proxy-struct type, much like the one passed to NewClient.
 func WithReverseClient[RP any](namespace string) ServerOption {
 	return func(c *ServerConfig) {
 		c.reverseClientBuilder = func(ctx context.Context, conn *wsConn) (context.Context, error) {
-			cl := client{
+			return buildReverseClient[RP](c, ctx, conn, namespace, nil)
-				namespace:           namespace,
+		}
-				paramEncoders:       map[reflect.Type]ParamEncoder{},
+	}
-				methodNameFormatter: c.methodNameFormatter,
+}
-			}
 
-			// todo test that everything is closing correctly
+// WithReverseClientSetup behaves like WithReverseClient, and also runs onConnect
-			cl.exiting = conn.exiting
+// once the reverse client has been created for the websocket connection.
-
+func WithReverseClientSetup[RP any](namespace string, onConnect func(context.Context, RP) error) ServerOption {
-			requests := cl.setupRequestChan()
+	return func(c *ServerConfig) {
-			conn.requests = requests
+		c.reverseClientBuilder = func(ctx context.Context, conn *wsConn) (context.Context, error) {
-
+			return buildReverseClient[RP](c, ctx, conn, namespace, onConnect)
-			calls := new(RP)
-
-			err := cl.provide([]interface{}{
-				calls,
-			})
-			if err != nil {
-				return nil, xerrors.Errorf("provide reverse client calls: %w", err)
-			}
-
-			return context.WithValue(ctx, jsonrpcReverseClient{reflect.TypeOf(calls).Elem()}, calls), nil
 		}
 	}
 }

common/utils/go-jsonrpc/server.go

@@ -45,6 +45,16 @@ func GetConnectionType(ctx context.Context) ConnectionType {
 	return ConnectionTypeUnknown
 }
 
+// GetHTTPRequest returns the original HTTP request when the context comes from RPCServer.
+func GetHTTPRequest(ctx context.Context) (*http.Request, bool) {
+	v := ctx.Value(httpRequestCtxKey{})
+	if v == nil {
+		return nil, false
+	}
+	req, ok := v.(*http.Request)
+	return req, ok
+}
+
 // RPCServer provides a jsonrpc 2.0 http server handler
 type RPCServer struct {
 	*handler
@@ -75,6 +85,8 @@ var upgrader = websocket.Upgrader{
 }
 
 func (s *RPCServer) handleWS(ctx context.Context, w http.ResponseWriter, r *http.Request) {
+	ctx = context.WithValue(ctx, httpRequestCtxKey{}, r)
+
 	// TODO: allow setting
 	// (note that we still are mostly covered by jwt tokens)
 	w.Header().Set("Access-Control-Allow-Origin", "*")
@@ -181,3 +193,5 @@ func (s *RPCServer) AliasMethod(alias, original string) {
 }
 
 var _ error = &JSONRPCError{}
+
+type httpRequestCtxKey struct{}

common/utils/go-jsonrpc/websocket.go

@@ -661,7 +661,9 @@ func (c *wsConn) tryReconnect(ctx context.Context) bool {
 		c.writeLk.Unlock()
 
 		go c.nextMessage()
-		c.reconfun()
+		if c.reconfun != nil {
+			go c.reconfun()
+		}
 	}()
 
 	return true

common/utils/go-sensitive-word-1.3.3/go.mod

@@ -2,33 +2,4 @@ module github.com/zmexing/go-sensitive-word
 
 go 1.20
 
-require (
+require github.com/orcaman/concurrent-map/v2 v2.0.1
-	 
-	github.com/orcaman/concurrent-map/v2 v2.0.1
-)
-
-require (
-	github.com/andybalholm/brotli v1.1.0 // indirect
-	github.com/cloudflare/circl v1.3.7 // indirect
-	github.com/go-logr/logr v1.4.2 // indirect
-	github.com/go-task/slim-sprig v0.0.0-20230315185526-52ccab3ef572 // indirect
-	github.com/google/pprof v0.0.0-20240227163752-401108e1b7e7 // indirect
-	github.com/hashicorp/errwrap v1.1.0 // indirect
-	github.com/hashicorp/go-multierror v1.1.1 // indirect
-	github.com/klauspost/compress v1.17.9 // indirect
-	github.com/onsi/ginkgo/v2 v2.16.0 // indirect
-	github.com/quic-go/qpack v0.4.0 // indirect
-	github.com/quic-go/qtls-go1-20 v0.4.1 // indirect
-	github.com/quic-go/quic-go v0.40.1 // indirect
-	github.com/refraction-networking/utls v1.6.3 // indirect
-	github.com/stretchr/testify v1.11.1 // indirect
-	go.uber.org/mock v0.4.0 // indirect
-	golang.org/x/crypto v0.31.0 // indirect
-	golang.org/x/exp v0.0.0-20240222234643-814bf88cf225 // indirect
-	golang.org/x/mod v0.17.0 // indirect
-	golang.org/x/net v0.33.0 // indirect
-	golang.org/x/sys v0.30.0 // indirect
-	golang.org/x/text v0.22.0 // indirect
-	golang.org/x/tools v0.21.1-0.20240508182429-e35e4ccd0d2d // indirect
-	google.golang.org/protobuf v1.31.0 // indirect
-)

common/utils/go-sensitive-word-1.3.3/go.sum

@@ -1,55 +1,2 @@
-github.com/andybalholm/brotli v1.1.0 h1:eLKJA0d02Lf0mVpIDgYnqXcUn0GqVmEFny3VuID1U3M=
-github.com/andybalholm/brotli v1.1.0/go.mod h1:sms7XGricyQI9K10gOSf56VKKWS4oLer58Q+mhRPtnY=
-github.com/cloudflare/circl v1.3.7 h1:qlCDlTPz2n9fu58M0Nh1J/JzcFpfgkFHHX3O35r5vcU=
-github.com/cloudflare/circl v1.3.7/go.mod h1:sRTcRWXGLrKw6yIGJ+l7amYJFfAXbZG0kBSc8r4zxgA=
-github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
-github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
-github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
-github.com/go-logr/logr v1.4.2 h1:6pFjapn8bFcIbiKo3XT4j/BhANplGihG6tvd+8rYgrY=
-github.com/go-task/slim-sprig v0.0.0-20230315185526-52ccab3ef572 h1:tfuBGBXKqDEevZMzYi5KSi8KkcZtzBcTgAUUtapy0OI=
-github.com/go-task/slim-sprig v0.0.0-20230315185526-52ccab3ef572/go.mod h1:9Pwr4B2jHnOSGXyyzV8ROjYa2ojvAY6HCGYYfMoC3Ls=
-github.com/golang/protobuf v1.5.3 h1:KhyjKVUg7Usr/dYsdSqoFveMYd5ko72D+zANwlG1mmg=
-github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=
-github.com/google/pprof v0.0.0-20240227163752-401108e1b7e7 h1:y3N7Bm7Y9/CtpiVkw/ZWj6lSlDF3F74SfKwfTCer72Q=
-github.com/google/pprof v0.0.0-20240227163752-401108e1b7e7/go.mod h1:czg5+yv1E0ZGTi6S6vVK1mke0fV+FaUhNGcd6VRS9Ik=
-github.com/hashicorp/errwrap v1.0.0/go.mod h1:YH+1FKiLXxHSkmPseP+kNlulaMuP3n2brvKWEqk/Jc4=
-github.com/hashicorp/errwrap v1.1.0 h1:OxrOeh75EUXMY8TBjag2fzXGZ40LB6IKw45YeGUDY2I=
-github.com/hashicorp/errwrap v1.1.0/go.mod h1:YH+1FKiLXxHSkmPseP+kNlulaMuP3n2brvKWEqk/Jc4=
-github.com/hashicorp/go-multierror v1.1.1 h1:H5DkEtf6CXdFp0N0Em5UCwQpXMWke8IA0+lD48awMYo=
-github.com/hashicorp/go-multierror v1.1.1/go.mod h1:iw975J/qwKPdAO1clOe2L8331t/9/fmwbPZ6JB6eMoM=
-github.com/imroc/req/v3 v3.42.3 h1:ryPG2AiwouutAopwPxKpWKyxgvO8fB3hts4JXlh3PaE=
-github.com/imroc/req/v3 v3.42.3/go.mod h1:Axz9Y/a2b++w5/Jht3IhQsdBzrG1ftJd1OJhu21bB2Q=
-github.com/klauspost/compress v1.17.9 h1:6KIumPrER1LHsvBVuDa0r5xaG0Es51mhhB9BQB2qeMA=
-github.com/onsi/ginkgo/v2 v2.16.0 h1:7q1w9frJDzninhXxjZd+Y/x54XNjG/UlRLIYPZafsPM=
-github.com/onsi/ginkgo/v2 v2.16.0/go.mod h1:llBI3WDLL9Z6taip6f33H76YcWtJv+7R3HigUjbIBOs=
-github.com/onsi/gomega v1.30.0 h1:hvMK7xYz4D3HapigLTeGdId/NcfQx1VHMJc60ew99+8=
 github.com/orcaman/concurrent-map/v2 v2.0.1 h1:jOJ5Pg2w1oeB6PeDurIYf6k9PQ+aTITr/6lP/L/zp6c=
 github.com/orcaman/concurrent-map/v2 v2.0.1/go.mod h1:9Eq3TG2oBe5FirmYWQfYO5iH1q0Jv47PLaNK++uCdOM=
-github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
-github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
-github.com/quic-go/qpack v0.4.0 h1:Cr9BXA1sQS2SmDUWjSofMPNKmvF6IiIfDRmgU0w1ZCo=
-github.com/quic-go/qpack v0.4.0/go.mod h1:UZVnYIfi5GRk+zI9UMaCPsmZ2xKJP7XBUvVyT1Knj9A=
-github.com/quic-go/qtls-go1-20 v0.4.1 h1:D33340mCNDAIKBqXuAvexTNMUByrYmFYVfKfDN5nfFs=
-github.com/quic-go/qtls-go1-20 v0.4.1/go.mod h1:X9Nh97ZL80Z+bX/gUXMbipO6OxdiDi58b/fMC9mAL+k=
-github.com/quic-go/quic-go v0.40.1 h1:X3AGzUNFs0jVuO3esAGnTfvdgvL4fq655WaOi1snv1Q=
-github.com/quic-go/quic-go v0.40.1/go.mod h1:PeN7kuVJ4xZbxSv/4OX6S1USOX8MJvydwpTx31vx60c=
-github.com/refraction-networking/utls v1.6.3 h1:MFOfRN35sSx6K5AZNIoESsBuBxS2LCgRilRIdHb6fDc=
-github.com/refraction-networking/utls v1.6.3/go.mod h1:yil9+7qSl+gBwJqztoQseO6Pr3h62pQoY1lXiNR/FPs=
-github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
-github.com/stretchr/testify v1.6.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
-github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
-go.uber.org/mock v0.4.0 h1:VcM4ZOtdbR4f6VXfiOpwpVJDL6lCReaZ6mw31wqh7KU=
-go.uber.org/mock v0.4.0/go.mod h1:a6FSlNadKUHUa9IP5Vyt1zh4fC7uAwxMutEAscFbkZc=
-golang.org/x/crypto v0.31.0 h1:ihbySMvVjLAeSH1IbfcRTkD/iNscyz8rGzjF/E5hV6U=
-golang.org/x/exp v0.0.0-20240222234643-814bf88cf225 h1:LfspQV/FYTatPTr/3HzIcmiUFH7PGP+OQ6mgDYo3yuQ=
-golang.org/x/exp v0.0.0-20240222234643-814bf88cf225/go.mod h1:CxmFvTBINI24O/j8iY7H1xHzx2i4OsyguNBmN/uPtqc=
-golang.org/x/mod v0.17.0 h1:zY54UmvipHiNd+pm+m0x9KhZ9hl1/7QNMyxXbc6ICqA=
-golang.org/x/net v0.33.0 h1:74SYHlV8BIgHIFC/LrYkOGIwL19eTYXQ5wc6TBuO36I=
-golang.org/x/sync v0.11.0 h1:GGz8+XQP4FvTTrjZPzNKTMFtSXH80RAzG+5ghFPgK9w=
-golang.org/x/sys v0.30.0 h1:QjkSwP/36a20jFYWkSue1YwXzLmsV5Gfq7Eiy72C1uc=
-golang.org/x/text v0.22.0 h1:bofq7m3/HAFvbF51jz3Q9wLg3jkvSPuiZu/pD1XwgtM=
-golang.org/x/tools v0.21.1-0.20240508182429-e35e4ccd0d2d h1:vU5i/LfpvrRCpgM/VPfJLg5KjxD3E+hfT1SH+d9zLwg=
-google.golang.org/protobuf v1.31.0 h1:g0LDEJHgrBl9N9r17Ru3sqWhkIx2NB67okBHPwC7hs8=
-gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
-gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
-gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=

docs/peak-tianxuan-current-design-2026-04-25.md

@@ -0,0 +1,81 @@
+# 巅峰之战天选池当前逻辑说明
+
+更新时间：2026-04-26
+
+## 1. 入口职责
+
+- `point_1`：巅峰之战主页面，展示当前玩家已配置的天选精灵。
+- `point_2`：天选池投票页面，只保存玩家本周投票。
+- `point_3`：天选精灵配置页面，配置玩家自己的天选精灵属性。
+
+## 2. 投票数据
+
+投票表是 `config_peak_tianxuan_vote`。
+
+字段口径：
+
+- `week_index`：日期周，格式为 ISO 年周，例如 `202617`。
+- `player_id`：投票玩家。
+- `pet_id`：投票精灵。
+
+约束口径：
+
+- 每个玩家每个日期周只能投 1 只精灵。
+- 同周重复投票时更新原记录。
+- 票数统计按 `week_index + pet_id` 聚合。
+
+## 3. 投票池
+
+`point_2` 的候选池来自乱斗精灵池 `config_boss_melee`，按 `mon_id` 去重。
+
+当前不再因为上周出现过就从候选池移除。上周投票结果只作为展示和后续配置参考。
+
+页面会展示：
+
+- 当前日期周投票池。
+- 上一日期周投票统计。
+- 当前玩家本周已投的精灵。
+
+## 4. 天选配置
+
+天选配置表是 `config_peak_tianxuan`。
+
+这张表现在表示“玩家额外拥有的天选精灵配置”，参考 `player_pet` 的归属思路，不再按周保存。
+
+核心字段：
+
+- `player_id`
+- `pet_id`
+- `display_order`
+- `preset_name`
+- `level`
+- `nature`
+- `hp`
+- `max_hp`
+- `attack`
+- `defence`
+- `sp_attack`
+- `sp_defence`
+- `speed`
+- `skin_id`
+- `effect_ids`
+- `skill_ids`
+- `remark`
+- `is_enable`
+
+约束口径：
+
+- 同一玩家不能重复配置同一只天选精灵。
+- 不再校验“本周不能和上周重复”。
+- 不再要求 `week_index`。
+
+## 5. BP 使用
+
+BP 不直接读取投票记录。
+
+进入 BP 时读取双方各自的 `config_peak_tianxuan` 配置：
+
+- 我方看到自己的天选配置。
+- 对方看到对方自己的天选配置。
+
+投票结果后续可用于决定哪些精灵开放给玩家配置，但配置本身是玩家维度的数据。

docs/peak-tianxuan-vote-design-2026-04-25.md

@@ -0,0 +1,42 @@
+# 巅峰之战天选池投票设计
+
+## 规则补全
+
+- 参与规则
+  - 白银及以下：至少 1 只 100 级以上精灵，进行 `1v1`
+  - 黄金、铂金、紫晶：至少 3 只 100 级以上精灵，进行 `3v3`
+  - 钻石及以上：至少 6 只 100 级以上精灵，进行 `6v6`
+- 段位规则
+  - 初始段位为青铜，初始分 `800`
+  - `1000` 白银，`1200` 黄金，`1500` 铂金，`1800` 紫晶，`2100` 钻石，`3000` 大师，`4000` 王者
+  - 王者榜前 100 自动晋升至尊王者
+- 天选池规则
+  - 每周开放一组“天选池”候选精灵
+  - 玩家在进入巅峰匹配前，先从本周天选池中投票选择自己的“天选备选”
+  - 白银及以下可选 `1` 只，紫晶及以下可选 `2` 只，钻石及以上可选 `3` 只
+  - 这些投票结果跟随匹配快照一起进入后续 BP 流程
+- BP 规则
+  - 钻石以下默认无 Ban/Pick 强制要求，但前后端结构统一预留天选池字段
+  - 钻石及以上进入正式 BP
+  - BP 展示区应包含：
+    - 出战备战精灵
+    - 天选精灵
+    - 双方互 Ban / Pick
+  - BP 完成后再进入正式对战
+- 奖励规则
+  - 本次仅补结构与文档位，结算奖励、赛季奖励、周奖励仍按后续配置表落地
+
+## 本次后端结构预留
+
+- `2458` 巅峰加入请求增加 `TianxuanPetIDs`
+- 匹配快照 `QueuePlayerSnapshot` 增加 `TianxuanPetIDs`
+- `CrossServerBanPickStartOutboundInfo` 增加：
+  - `TianxuanSelectableCount`
+  - `MyTianxuanPets`
+  - `OpponentTianxuanPets`
+
+## 当前实现边界
+
+- 本次先完成“开始界面投票 + 匹配快照透传 + BP 启动数据预留”
+- 不直接改现有 `banpick.vue`
+- 天选精灵的正式上场生成、战斗侧实体化和完整 BP 消费，交给后续 BP 页面与战斗链路接入

docs/pvp-cross-server-battle-cmd-data-design-2026-04-27.md

@@ -0,0 +1,257 @@
+# PVP 跨服战斗消息 `cmd/data` 转发改造说明
+
+## 背景
+
+巅峰赛跨服战斗原本已经有 Redis pub/sub 通道，但战斗中的客户端操作转发仍然偏间接：
+
+1. 本服 controller 先把客户端请求翻译成 `FightI` 调用。
+2. `RemoteFightProxy` 再把 `FightI` 调用翻译成 `battle_command`。
+3. 宿主服收到 `battle_command` 后，再翻译回 `FightI` 调用。
+
+这样一来，跨服战斗链路和本地战斗链路之间多了一层“动作语义映射”，调试时不容易直接看到前端到底发了哪个 cmd、带了什么 data。
+
+本次改造只处理“战斗中的消息转发”，不改匹配/加入队列逻辑。
+
+## 保持不变的部分
+
+- 巅峰赛加入和取消匹配仍然走原有 RPC：
+  - `MatchJoinOrUpdate`
+  - `MatchCancel`
+- Ban/Pick、MatchFound、SessionClose 等 PVP 服务内消息仍兼容旧外层格式。
+- `battle_command` 旧语义消息仍保留，作为兼容兜底，不强制一次性切掉。
+
+对应原因：
+
+- 匹配加入需要同步返回结果，RPC 更直接。
+- 现网如果已有旧 envelope 或旧 battle command 发送方，不能直接断。
+
+## 改造目标
+
+把跨服战斗中的“客户端操作转发”改成直接发送：
+
+```json
+{
+  "cmd": "battle_client_command",
+  "data": {
+    "sessionId": "xsvr-...",
+    "userId": 10001,
+    "cmd": 2405,
+    "data": {
+      "SkillId": 1234
+    }
+  }
+}
+```
+
+核心含义：
+
+- 外层 `cmd`：PVP 内部 Redis 消息类型。
+- 内层 `data.cmd`：真实客户端战斗协议 cmd。
+- 内层 `data.data`：该 cmd 对应的 JSON 业务字段。
+
+这样宿主服拿到消息后，可以直接按真实战斗 cmd 处理，而不是先理解一层额外的“跨服动作协议”。
+
+## 本次代码落点
+
+### 1. 新增 `cmd/data` envelope 能力
+
+文件：
+
+- `logic/service/fight/pvpwire/types.go`
+
+改动：
+
+- `Envelope` 新增：
+  - `Cmd string`
+  - `Data json.RawMessage`
+- 保留旧字段：
+  - `Type string`
+  - `Body []byte`
+- 新增辅助方法：
+  - `NewEnvelope`
+  - `MessageCmd`
+  - `MessageData`
+
+作用：
+
+- 新消息可以直接用 `cmd/data`。
+- 旧消息仍可通过 `type/body` 解析。
+
+### 2. controller 层遇到远端跨服战斗时，直接转发原始战斗 cmd
+
+文件：
+
+- `logic/controller/fight_unified.go`
+- `logic/controller/fight_base.go`
+
+改动：
+
+- 在 `fight_unified.go` 增加 `relayRemoteFightCommand`。
+- 当 `c.FightC` 是 `*pvp.RemoteFightProxy` 时，不再走本地 `dispatchFightActionEnvelope` 分发，而是直接转发当前请求的：
+  - `data.Head.CMD`
+  - 当前请求结构体 `data`
+
+已接入的战斗入口包括：
+
+- `2404` 准备
+- `7556` 旧组队准备
+- `2405` 单战位技能
+- `7505` 多战位技能
+- `7558` 旧组队技能
+- `2406` 使用道具
+- `7562` 旧组队道具
+- `2407` 切宠
+- `7563` 旧组队切宠
+- `2410` 逃跑
+- `7565` 旧组队逃跑
+- `2441` 加载进度
+- `50002` 战斗聊天
+
+### 3. RemoteFightProxy 新增“直接转发客户端命令”能力
+
+文件：
+
+- `logic/service/fight/pvp/proxy.go`
+
+改动：
+
+- 新增 `RelayClientCommand(cmd uint32, data any) bool`
+- 新增 `marshalClientCommandData(data any) ([]byte, error)`
+
+说明：
+
+- `marshalClientCommandData` 会把请求结构体转成 JSON。
+- 会删除 `Head/head` 字段，避免把协议头、二进制字段一起塞进跨服消息。
+- 这样发出去的 `data.data` 只保留业务字段。
+
+### 4. PVP 宿主服新增 `battle_client_command` 处理
+
+文件：
+
+- `logic/service/fight/pvp/service.go`
+- `logic/service/fight/pvpwire/types.go`
+
+改动：
+
+- 新增消息类型：
+  - `MessageTypeBattleClientCommand`
+- 新增载荷：
+  - `BattleClientCommandPayload`
+- `handleRedisMessage` 增加 `battle_client_command` 分支。
+- 新增 `handleBattleClientCommand`。
+
+处理方式：
+
+- 宿主服根据内层真实 `cmd` 解出 `data`。
+- 再直接调用当前 `FightI` / `FightC`。
+
+当前支持的映射：
+
+- `2404` / `7556` -> `ReadyFight`
+- `2405` / `7505` / `7558` -> `UseSkillAt`
+- `2406` / `7562` -> `UseItemAt`
+- `2407` / `7563` -> `ChangePetAt`
+- `2410` / `7565` -> `Over(PlayerEscape)`
+- `2441` -> `LoadPercent`
+- `50002` -> `Chat`
+
+### 5. 战斗发包转发也统一改成 `cmd/data`
+
+文件：
+
+- `logic/service/player/rpc.go`
+
+改动：
+
+- `PacketRelayPayload` 外层 envelope 从 `type/body` 改为 `cmd/data`。
+
+原因：
+
+- 它本质也是跨服战斗中的消息转发。
+- 和新的 `battle_client_command` 保持一致，便于抓包和日志排查。
+
+## 当前实际链路
+
+### 客户端操作转发
+
+1. 客户端发战斗包到本服 controller。
+2. controller 判断当前 `FightC` 是否为 `RemoteFightProxy`。
+3. 如果是：
+   - 直接发布 `battle_client_command`
+   - 内层携带真实 `cmd` 和 JSON `data`
+4. 宿主服 `pvp.service` 收到后按 `cmd` 分发回战斗逻辑。
+
+### 战斗结果/下行发包转发
+
+1. 宿主服在 `RPC_player.SendPackCmd` 中组包。
+2. 发布 `packet_relay` 消息，外层使用 `cmd/data`。
+3. 客服端所在服收到后解包并发回真实客户端。
+
+## 兼容策略
+
+为了避免一次性改动过大，这次保留了两层兼容：
+
+### 1. 旧 envelope 兼容
+
+`Envelope` 同时支持：
+
+- 新格式：`cmd/data`
+- 旧格式：`type/body`
+
+`handleRedisMessage` 统一通过：
+
+- `MessageCmd()`
+- `MessageData()`
+
+读取消息。
+
+### 2. 旧 `battle_command` 兼容
+
+`RemoteFightProxy` 旧的：
+
+- `UseSkill`
+- `UseSkillAt`
+- `UseItem`
+- `ChangePet`
+- `Chat`
+
+这些方法仍然保留，并继续发送原来的 `battle_command`。  
+新接入的 controller 优先走 `battle_client_command`，旧路径仍可兜底。
+
+## 这次改造的收益
+
+### 好处
+
+- 跨服战斗消息更直观，日志里能直接看到真实客户端 cmd。
+- controller 到宿主服之间不需要再先翻译成一套额外动作协议。
+- 宿主服调试时更容易复现前端输入。
+- 新老消息可并存，改造风险相对可控。
+
+### 仍然保留的复杂度
+
+- 宿主服仍然需要针对不同战斗 cmd 做一次 decode 和分发。
+- 这是必要复杂度，因为真实战斗入口本来就有多种协议包。
+
+## 验证
+
+本次已执行：
+
+- `cd logic && go test ./service/fight/pvp ./service/fight/pvpwire`
+- `cd logic && go test -c ./controller`
+
+结果：
+
+- `pvp`、`pvpwire` 包通过。
+- `controller` 可以完成编译检查。
+
+补充说明：
+
+- `go test ./controller ./service/player ...` 在当前环境会因为依赖初始化读取 `/proc/sys/kernel/osrelease` 失败而 panic，这属于运行环境问题，不是这次改动引入的编译错误。
+
+## 后续建议
+
+如果后面继续收敛这块逻辑，可以按下面顺序做：
+
+1. 把 `battle_command` 的旧语义层逐步下线，只保留 `battle_client_command`。
+2. 把 `handleBattleClientCommand` 里的 cmd 映射抽成独立表，避免 `switch` 继续膨胀。
+3. 如果后续战斗协议继续统一，可考虑把 controller 入站结构和跨服转发 decode 共享同一套注册表。

docs/pvp-login-rpc-match-design-2026-04-09.md

@@ -0,0 +1,224 @@
+# PVP Match Via RPC, Battle Via Redis
+
+## 目标
+
+本次调整先不解决 `login` 更新期间的排队保活和补偿问题，只收敛到一个更简单、可控的方案：
+
+- 匹配请求走 `logic -> login` 的同步 RPC
+- 对战过程仍走 `logic` 本地战斗 + Redis 转发战斗指令
+- `login` 不可用时，`logic` 直接返回“匹配服务不可用”
+- 前端通过轮询重新发起 / 更新匹配请求，不在后端保留离线补偿队列
+
+这个方案的核心是：先把“能否立即判断匹配服务可用”做好，不继续依赖 Redis PubSub 做匹配入口。
+
+## 当前现状
+
+### 现有匹配入口
+
+- 前端 `2458` 进入 [logic/controller/fight_巅峰.go](/workspace/logic/controller/fight_巅峰.go#L19)
+- 当前 `JoINtop` 直接调用 [logic/service/fight/pvp/service.go](/workspace/logic/service/fight/pvp/service.go#L83) 的 `JoinPeakQueue`
+- `JoinPeakQueue` 当前实现是本地建 `localQueueTicket`，并通过 Redis `publish` 发 `queue_join`
+
+### 现有跨服协调
+
+- `logic` 侧订阅 PVP Redis topic 的入口在 [common/rpc/func.go](/workspace/common/rpc/func.go#L153)
+- PVP 匹配状态当前存在 `logic/service/fight/pvp/service.go` 的 manager 内存里：
+  - `queues`
+  - `lastSeen`
+  - `localQueues`
+  - `sessions`
+  - `userSession`
+
+### 现有 RPC 能力
+
+- `logic` 启动时通过 [common/rpc/rpc.go](/workspace/common/rpc/rpc.go#L113) 建立到 `login` 的 RPC client
+- `login` 的 `/rpc/*` 入口绑定在 [modules/base/middleware/middleware.go](/workspace/modules/base/middleware/middleware.go#L152)
+- `login` 侧 RPC server 由 [common/rpc/rpc.go](/workspace/common/rpc/rpc.go#L101) 暴露
+
+### 当前问题
+
+Redis PubSub 适合“广播消息”，不适合“同步判断服务是否可用”。
+
+如果继续让匹配入口走 PubSub：
+
+- `logic` 无法在请求当下知道 `login` 是否真能处理
+- `login` 更新、重启、未订阅时，匹配请求可能直接丢失
+- 前端即使轮询，也只是重复投递，不能精确表达“当前匹配服务可用/不可用”
+
+## 收敛后的职责划分
+
+### login
+
+`login` 只负责匹配控制面：
+
+- 接收 `logic` 发来的同步匹配 RPC
+- 判断当前匹配服务是否可用
+- 维护匹配队列
+- 找到对手后，记录 match 结果
+- 再通过 Redis 或其他异步方式通知对应 `logic` 开始 Ban/Pick / Battle
+
+### logic
+
+`logic` 只负责：
+
+- 接收前端匹配请求
+- 同步 RPC 到 `login`
+- RPC 失败时立即返回“匹配服务不可用”
+- RPC 成功时返回“排队中”
+- 收到 match 结果后负责真正 `fight.NewFight(...)`
+- 对战期间继续使用现有 Redis topic 转发战斗指令
+
+### Redis
+
+Redis 只保留在“对战消息面”：
+
+- `match_found`
+- `ban_pick_submit`
+- `battle_command`
+- `packet_relay`
+- `session_close`
+
+也就是说：
+
+- 匹配入口走 RPC
+- 对战过程走 Redis
+
+## 推荐目标链路
+
+### 1. 前端加入/更新匹配
+
+前端定期轮询 `logic` 的加入/更新接口。
+
+`logic` 处理流程：
+
+1. 校验玩家当前战斗状态
+2. 同步调用 `login` 的匹配 RPC
+3. 如果 RPC 成功：返回排队中
+4. 如果 RPC 失败：清理本地匹配状态，返回匹配服务不可用
+
+### 2. login 完成匹配
+
+`login` 维护排队队列和匹配结果，匹配成功后：
+
+1. 确定 host / guest 所在 `logic`
+2. 通过 Redis 通知两个 `logic`
+3. host `logic` 开战
+4. guest `logic` 设置远端代理并进入 Ban/Pick 或战斗态
+
+### 3. 对战期间
+
+继续复用当前 `logic/service/fight/pvp/service.go` 内的 Redis 指令转发模式：
+
+- 战斗操作通过 Redis topic 转发
+- host `logic` 维持真实战斗对象
+- guest `logic` 维持 remote proxy
+
+## 失败语义
+
+本阶段不做补偿，不做离线保队列。
+
+### login 不在线
+
+如果 `logic -> login` RPC 调用失败：
+
+- 本次匹配直接失败
+- `logic` 清理本地匹配状态
+- 返回前端“匹配服务不可用”
+
+### 前端轮询停止
+
+如果前端不再轮询：
+
+- 视为用户不再持续请求匹配
+- `logic` 不负责继续保活
+- 是否从 `login` 队列移除，由 `login` 的超时策略决定
+
+### login 更新中
+
+如果 `login` 正在更新：
+
+- `logic` 的同步 RPC 会失败
+- 前端当前轮询会收到“匹配服务不可用”
+- 等 `login` 恢复后，前端下一轮再发起匹配
+
+这是本阶段明确接受的行为，不在后端做补偿。
+
+## 最小实现建议
+
+### 一、先增加 RPC 健康/匹配接口
+
+在 [common/rpc/rpc.go](/workspace/common/rpc/rpc.go) 增加面向 `logic -> login` 的 RPC 方法。
+
+建议最小接口：
+
+- `MatchJoinOrUpdate(PVPMatchJoinPayload) error`
+- `MatchCancel(userID) error`
+
+如果需要单独健康检查，也可以加：
+
+- `MatchPing() error`
+
+但在最小方案里，`MatchJoinOrUpdate` 自身就可以承担健康检查职责。
+
+### 二、logic 的匹配入口改为同步 RPC
+
+改造 [logic/controller/fight_巅峰.go](/workspace/logic/controller/fight_巅峰.go#L19) 和 [logic/service/fight/pvp/service.go](/workspace/logic/service/fight/pvp/service.go#L83)：
+
+- 入口不再直接发布 `queue_join`
+- 先发 RPC 到 `login`
+- 成功才更新本地匹配状态
+- 失败直接返回错误
+- 取消匹配时通过 `MatchCancel` 做 best-effort 清理
+
+### 三、保留 Redis 对战链路
+
+[logic/service/fight/pvp/service.go](/workspace/logic/service/fight/pvp/service.go#L170) 之后的 Redis 消费、match result 处理、Ban/Pick、战斗 relay 不需要一次性重写，可以继续保留。
+
+调整重点是：
+
+- 不再让匹配入口依赖 PubSub
+- 让对战过程继续走 Redis
+
+## 对前端的要求
+
+前端不要无脑重复“新 join”，而是按“轮询更新匹配状态”处理。
+
+建议行为：
+
+1. 首次点击匹配时发一次加入
+2. 匹配中每隔 `3~5s` 轮询一次更新
+3. 如果返回“匹配服务不可用”，前端退出匹配态并提示
+4. 如果返回“已匹配/进入 Ban/Pick”，前端切换到对应界面
+
+## 本阶段不做的事
+
+以下内容明确不在这次最小改造内：
+
+- `login` 更新期间的排队保活
+- 持久化消息补偿
+- `login` 重启后的队列恢复
+- Redis Stream 化
+- 多 `login` 实例协调
+- 匹配服务自动拉起目标 `logic`
+
+## 后续可选增强
+
+如果后面要继续提高可用性，可以再逐步演进为：
+
+1. 匹配入口仍走 RPC
+2. `login` 内部把队列落 Redis
+3. 加入 ticket 和续租机制
+4. login 更新时支持恢复匹配状态
+
+但这不是当前阶段的目标。
+
+## 最终收敛结论
+
+当前阶段建议明确成一句话：
+
+`匹配走 RPC，对战走 Redis。`
+
+对应业务语义：
+
+- 需要立即判断服务可用性的时候，用 RPC
+- 需要跨服转发战斗消息的时候，用 Redis

docs/rpc-blocking-reconnect-review-2026-04-27.md

@@ -0,0 +1,276 @@
+# RPC 阻塞、并发承载与重连复用检查
+
+日期：2026-04-27
+
+## 1. 检查范围
+
+本次主要检查以下两层：
+
+- 业务 RPC 封装：`common/rpc/rpc.go`
+- 底层 websocket JSON-RPC：`common/utils/go-jsonrpc/client.go`
+- 底层 websocket 重连循环：`common/utils/go-jsonrpc/websocket.go`
+- 业务调用点：`logic/controller/login_main.go`、`logic/controller/fight_巅峰.go`
+
+另外同步看了本轮已有的跨服战斗转发改动：
+
+- `logic/service/fight/pvp/proxy.go`
+- `logic/service/fight/pvp/service.go`
+- `logic/service/fight/pvpwire/types.go`
+- `logic/service/player/rpc.go`
+
+## 2. 结论
+
+### 2.1 现在的 RPC 会不会阻塞
+
+会。
+
+当前业务侧 `Kick`、`MatchJoinOrUpdate`、`MatchCancel`、`RegisterLogic` 都是同步 RPC 调用。  
+调用 goroutine 会一直等到底层返回响应、连接错误，或者调用方自己的 `context` 超时。
+
+原先的问题是：
+
+- 这些业务 RPC 方法没有 `context.Context` 入参
+- 调用方没法给单次 RPC 设置超时
+- 一旦对端卡住或网络异常，调用方可能长期挂住
+
+这会直接影响：
+
+- 登录踢人流程
+- 巅峰匹配加入/取消
+- 重连后的逻辑服重新注册
+
+### 2.2 并发会不会顶不住
+
+结论是：底层支持多路并发，但原实现存在明显背压点。
+
+底层 `go-jsonrpc` 的设计不是“单请求单连接”，而是：
+
+- 一个 `RPCClient`
+- 一个 websocket 连接
+- 多个请求共用一个 `requests` 通道
+- 通过请求 ID 做响应分发
+
+所以它本身支持并发复用同一条连接。
+
+但原实现有两个风险：
+
+1. `client.setupRequestChan()` 里的 `requests` 是无缓冲通道  
+   当 `handleWsConn` 主循环发送不过来时，调用方会在“写入请求通道”这一步被卡住。
+
+2. 业务调用没有统一超时  
+   即使底层连接还能用，某个慢 RPC 也可能把业务 goroutine 长时间挂住。
+
+这不代表“完全扛不住”，但高并发下会更容易出现请求堆积和业务侧等待放大。
+
+### 2.3 重连后 URL 会不会复用
+
+会复用。
+
+当前 websocket client 在初始化时把地址保存在 `connFactory` 中，重连时走的还是同一个 `addr`：
+
+- `common/utils/go-jsonrpc/client.go`
+- `websocketClient(...)` 中构造 `connFactory`
+- `common/utils/go-jsonrpc/websocket.go`
+- `tryReconnect(...)` 中再次调用 `c.connFactory()`
+
+也就是说：
+
+- 重连不是只发一次注册 RPC 就结束
+- 重连后不是一次性临时连接
+- 而是替换 `wsConn.conn` 为新连接
+- 后续 RPC 仍然继续复用同一个 `RPCClient` 和同一个目标 URL
+
+### 2.4 重连后是不是必须再发一次注册 RPC
+
+现在不是了。
+
+当前实现已经改成：
+
+- 客户端在 websocket 建连 URL 上直接带 `logic_id` / `logic_port`
+- 服务端在握手阶段创建 reverse client 后，立刻根据 URL 参数完成 logic 注册
+- 连接断开时再根据同一身份清理 `cool.Clientmap`
+
+这样重连时：
+
+- 仍然走同一个 URL
+- 新连接在握手阶段就知道 client 身份
+- 不需要再依赖重连成功后的二次 `RegisterLogic(id, port)` RPC
+
+保留 `RegisterLogic` 只是兼容已有接口，不再是重连链路的必要步骤。
+
+## 3. 本轮已做修改
+
+### 3.1 给业务 RPC 增加显式超时能力
+
+修改文件：
+
+- `common/rpc/rpc.go`
+- `logic/controller/Controller.go`
+- `logic/controller/login_main.go`
+- `logic/controller/fight_巅峰.go`
+
+改动内容：
+
+- `Kick`
+- `RegisterLogic`
+- `MatchJoinOrUpdate`
+- `MatchCancel`
+
+统一改成带 `context.Context` 的签名。
+
+新增：
+
+- `common/rpc/rpc.go`
+- `ClientCallTimeout = 5 * time.Second`
+
+调用侧现在会显式设置超时，避免业务 goroutine 无限等待。
+
+### 3.2 连接握手阶段直接注册 logic 身份
+
+修改文件：
+
+- `common/rpc/rpc.go`
+- `common/utils/go-jsonrpc/server.go`
+- `common/utils/go-jsonrpc/options_server.go`
+
+行为调整：
+
+- 客户端建连 URL 直接携带 `logic_id` / `logic_port`
+- 服务端握手时把原始 `*http.Request` 放入 RPC 上下文
+- reverse client 建好后立即读取 URL 参数并注册 logic client
+- 连接关闭时按相同 key 自动清理 `cool.Clientmap`
+
+这样重连后不需要额外补发一次注册 RPC。
+
+### 3.3 底层请求通道增加缓冲
+
+修改文件：
+
+- `common/utils/go-jsonrpc/client.go`
+
+改动：
+
+- `requests := make(chan clientRequest, 1024)`
+
+目的：
+
+- 把“调用方 goroutine 立刻卡在请求投递”这个点往后挪
+- 给 `handleWsConn` 主循环留一个有限缓冲区
+
+这不是彻底消除背压，只是把最硬的无缓冲阻塞改掉。
+
+### 3.4 重连回调不再承担注册职责
+
+修改文件：
+
+- `common/rpc/rpc.go`
+
+改动：
+
+- 去掉 `StartClient(...)` 中依赖 `WithReconnFun(...)` 做补注册的逻辑
+
+目的：
+
+- 让“谁是这个 logic client”变成握手时就已确定的连接属性
+- 避免重连后再发一笔注册 RPC
+
+## 4. 这轮修改后的判断
+
+### 4.1 RPC 还会不会阻塞
+
+会，但现在阻塞是“有边界的同步等待”，不是“无上限死等”。
+
+也就是：
+
+- 业务仍然是同步 RPC 模式
+- 但调用方现在有明确超时
+- 超时后能返回错误，不会无限挂住
+
+### 4.2 并发有没有改善
+
+有改善，但不是彻底做成高吞吐 RPC 网关。
+
+现在比原来更稳的点：
+
+- 业务调用有超时
+- 请求投递通道有缓冲
+- 重连时不再额外补发一次注册 RPC
+
+仍然保留的现实限制：
+
+- 单条 websocket 连接仍然只有一个写口
+- `handleWsConn` 仍是单主循环
+- 极端并发下仍会出现排队，只是不会像原来那样更早卡死
+
+## 5. 关于“URL 复用”的最终确认
+
+最终确认如下：
+
+1. `RPCClient` 建立时会把目标 `rpcaddr` 固定到 `connFactory`
+2. 这个 `rpcaddr` 现在已经带上 `logic_id` / `logic_port`
+3. 连接断开后，`tryReconnect(...)` 继续使用这个 `connFactory`
+4. 新连接建立后，服务端在握手阶段直接按 URL 参数注册 reverse client
+5. 原 `RPCClient` 后续 RPC 继续走新连接
+
+所以这里是：
+
+- 复用同一个目标 URL
+- 复用同一个 `RPCClient`
+- 复用同一个请求分发模型
+
+不是：
+
+- 重连后靠额外发一次 `RegisterLogic`
+- 才让后续 RPC 可用
+
+现在身份识别和注册已经前置到连接握手本身。
+
+## 6. 还没解决的风险
+
+### 6.1 连接级串行写仍然存在
+
+虽然请求可以并发入队，但真正写 websocket 还是串行的。  
+如果将来 login 侧 RPC 量继续上升，还是可能需要继续做：
+
+- 更细的调用隔离
+- 独立连接池
+- 或把部分强同步调用改为异步消息
+
+### 6.2 1024 缓冲不是容量上限方案
+
+当前只是经验值，不是经过压测得出的最终值。  
+如果峰值比预期高，还可能继续积压。
+
+### 6.3 业务上仍然是同步等待模式
+
+比如：
+
+- 登录踢人
+- 匹配加入
+
+仍然依赖 RPC 成功/失败来推进。  
+只是现在不会无限挂死，但高峰期延迟仍可能直接体现在业务响应上。
+
+## 7. 验证情况
+
+已完成：
+
+- `gofmt` 已执行
+- `go test ./rpc` in `common` 通过
+- `go test -run '^$' .` in `common/utils/go-jsonrpc` 通过
+
+受环境限制未完整确认：
+
+- `common/utils/go-jsonrpc` 全量测试在 sandbox 下需要本地监听端口
+- `logic` 模块测试受当前环境 `/proc/sys/kernel/osrelease` 读取失败影响，无法作为本轮改动的有效回归结论
+
+另外，`common` 模块全量 `go test ./...` 还会被仓库内已有的 `fmt.Println("%.2f")` 这类历史问题拦住，与本次 RPC 改动无关。
+
+## 8. 建议的下一步
+
+如果后面还要继续收敛这块，建议优先级如下：
+
+1. 给 login 侧关键 RPC 增加更明确的耗时日志和超时日志
+2. 对 `requests` 队列积压增加指标或告警
+3. 评估 `Kick` 和匹配 RPC 是否需要拆连接
+4. 如果 login 压力继续上涨，再考虑把部分同步入口改成异步投递 + 状态查询

help/base_sys_user_role去重.sql

@@ -0,0 +1,37 @@
+-- base_sys_user_role 角色授权去重
+-- 只处理未软删除的有效授权；软删除历史记录不参与去重
+-- 保留每组有效 userId + roleId 中 id 最小的一条，删除其余重复记录
+
+-- 1. 执行前查看重复数据
+SELECT
+  "userId",
+  "roleId",
+  COUNT(*) AS cnt,
+  MIN(id) AS keep_id,
+  ARRAY_AGG(id ORDER BY id) AS ids
+FROM base_sys_user_role
+WHERE deleted_at IS NULL
+GROUP BY "userId", "roleId"
+HAVING COUNT(*) > 1
+ORDER BY cnt DESC, "userId", "roleId";
+
+-- 2. 删除重复数据
+DELETE FROM base_sys_user_role a
+USING base_sys_user_role b
+WHERE a."userId" = b."userId"
+  AND a."roleId" = b."roleId"
+  AND a.deleted_at IS NULL
+  AND b.deleted_at IS NULL
+  AND a.id > b.id;
+
+-- 3. 执行后复查，应返回 0 行
+SELECT
+  "userId",
+  "roleId",
+  COUNT(*) AS cnt
+FROM base_sys_user_role
+WHERE deleted_at IS NULL
+GROUP BY "userId", "roleId"
+HAVING COUNT(*) > 1;
+
+-- 唯一约束统一在 约束类.sql 中维护。

help/ftp.md

@@ -0,0 +1,10 @@
+FTP地址：38.102.84.92 [ 端口：21 ]
+FTP用户名：m1584920
+FTP密码：7WKimiwDH5RL2SLs
+空间容量：10G
+有效期至：2027-04-21（1年）
+
+文件上传之后，其URL地址是：
+https://m1584920.772988.xyz/文件名+文件格式，如果文件名有中文，请注意编码问题，如果你不懂这个就遇到再跟我说。
+
+PS：如果需要绑定你的域名，手续费￥30

help/server_show冠名索引修复.sql

@@ -0,0 +1,14 @@
+-- server_show 冠名索引修复
+-- 目的：允许同一服务器存在多个不同玩家的冠名记录。
+-- 同服同属主唯一约束统一在 约束类.sql 中维护。
+
+BEGIN;
+
+-- 历史上 server_id 被建成了单列唯一约束/唯一索引，会拦截同服多冠名
+ALTER TABLE server_show DROP CONSTRAINT IF EXISTS idx_server_show_server_id;
+DROP INDEX IF EXISTS idx_server_show_server_id;
+
+-- 保留普通查询索引
+CREATE INDEX IF NOT EXISTS idx_server_show_server_id ON server_show (server_id);
+
+COMMIT;

help/初始化SPT配置.sql

@@ -0,0 +1,73 @@
+-- 初始化/修复 SPT 配置表（PostgreSQL）
+-- 用法：在 sun 数据库执行本文件
+
+BEGIN;
+
+CREATE TABLE IF NOT EXISTS config_spt (
+    id BIGSERIAL PRIMARY KEY,
+    "createTime" TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    "updateTime" TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    deleted_at TIMESTAMPTZ NULL,
+    is_enable INTEGER NOT NULL DEFAULT 1,
+    remark VARCHAR(255) NOT NULL DEFAULT '',
+    task_id INTEGER NOT NULL,
+    title VARCHAR(64) NOT NULL DEFAULT '',
+    pet_id INTEGER NOT NULL DEFAULT 0,
+    online INTEGER NOT NULL DEFAULT 1,
+    level INTEGER NOT NULL DEFAULT 1,
+    enter_id INTEGER NOT NULL DEFAULT 0,
+    description TEXT NOT NULL DEFAULT ''
+);
+
+-- task_id 唯一约束统一在 约束类.sql 中维护。
+
+ALTER TABLE config_spt DROP COLUMN IF EXISTS seat_id;
+
+INSERT INTO config_spt
+(task_id, title, pet_id, online, level, enter_id, description, is_enable, remark)
+VALUES
+(301,'蘑菇怪',47,1,1,12,'生活在克洛斯星，被艾里逊的液氮冻伤而发狂，使用火焰喷射器可以使它安静下来。制服它可以获得草系精灵小蘑菇。',1,'破除防护罩'),
+(302,'钢牙鲨',34,1,1,21,'海洋星海底的危险怪兽，据说它躲藏的洞穴中有制作黑武士装的黑晶矿石。记住，到海底一定要穿上耐压的潜水套装。',1,''),
+(303,'里奥斯',42,1,2,17,'海盗艾里逊在火山被它困住，战胜它有机会获得火系精灵“胡里亚”。在火山，你会用到喷水装的。',1,'扑灭火焰屏障'),
+(304,'阿克希亚',50,1,4,40,'塞西利亚星的守护者，正义的精灵圣兽，它是不可战胜的，千年来一直等待着宿命的对手。',1,''),
+(305,'提亚斯',69,1,3,27,'云霄星出现了一只极具攻击性的变异精灵，拥有很多蛋的它虽然想要努力呵护自己的孩子却力不从心，看来需要大家帮帮忙啊。',1,''),
+(306,'雷伊',70,1,3,32,'赫尔卡星天空中划过一道闪电，映出了一个酷似精灵的黑影，它全身被电流包围，从它的神态中可以看出它正等待来自各方的挑战。',1,'雷雨天'),
+(307,'纳多雷',88,1,3,106,'在双子阿尔法星上，特派队遇见了一只巨大的精灵，经过多次挑战后，它仍然丝毫无损，赛尔们是否有办法战胜这只精灵呢？',1,''),
+(308,'雷纳多',113,1,3,49,'彪悍的雷纳多盘踞在双子贝塔星上，和双子阿尔法星的纳多雷遥相对应，守护着星球上所有精灵的。',1,''),
+(309,'尤纳斯',132,1,4,314,'黑暗之门的制造者，拥有能够抵御一切的暗影屏障和所有能量来源的黑暗之核。',1,''),
+(310,'魔狮迪露',187,1,4,53,'魔狮迪露具有神秘的力量，能使自己的体力突破界限，但同时也会受到未知的惩罚。',1,''),
+(311,'哈莫雷特',216,1,5,60,'拥有无比巨大的身躯，集水火草三种原能为一身，龙系的神秘力量使它所向无敌。失忆的它，似乎还有很多谜团……',1,''),
+(312,'奈尼芬多',264,1,4,325,'奈尼芬多是爱迪星的守护者，凄美的歌声连月亮都为之倾倒，据说只有音乐的力量才能够唤醒它。',1,''),
+(316,'厄尔塞拉',421,1,5,61,'浑身散发着各色光芒，任何邪恶在她的光芒下消散无形',1,''),
+(50,'卡特斯',169,1,2,110,'作为暗黑武斗场的试炼精灵，守护着试炼之门，它的气度和风度非同一般，杀气重重很难对付！',1,''),
+(51,'魔牙鲨',171,1,3,503,'暗黑第一门的魔牙鲨，被赋予了传说中的暗黑斗气，隐藏在暗影中攻击时它的能力可以被放大增强。',1,''),
+(53,'贝鲁基德',174,1,3,504,'暗黑第二门的贝鲁基德，暗黑火焰环绕周身，凶悍的外表下藏着善战勇敢的心。',1,''),
+(55,'巴弗洛',177,1,3,505,'勇猛凶横的巴弗洛把守着暗黑武斗场Ⅲ-Ⅰ门，霹雳闪电般的羽翼攻击、震荡心胸的音乐攻击，让人防不胜防。',1,''),
+(56,'奇拉塔顿',183,1,3,505,'勇敢的奇拉塔顿驻守在暗黑武斗场Ⅲ-Ⅱ门的那一边，身为大地之子的它驾驭着反物质能量，纵横无敌。',1,''),
+(59,'西萨拉斯',195,1,3,506,'拥有强大反物质电力的暗黑Ⅳ-Ⅰ门守护者，雷霆之刃震撼寰宇天地，电流之剑穿透空间阻隔，威慑四方。',1,''),
+(60,'克林卡修',192,1,4,506,'暗黑Ⅳ-Ⅱ门守护者冰雪灵兽克林卡修，冰雪之爪具有猛烈的攻击力，果敢不张扬的个性，让它成为忍者般的精灵。',1,''),
+(76,'卡库',222,1,4,507,'暗黑Ⅴ-Ⅰ门是武学之门，守门精灵不张扬、不蛮横、步步为营，每出一招都会致命。',1,''),
+(77,'赫德卡',224,1,4,507,'驻守暗黑V-II门的铁血赫德卡，有着铜墙铁壁的防守能力，有着超级强力的电光炮，它的防御之门你能够开启吗？',1,''),
+(78,'伊兰罗尼',227,1,5,507,'守护暗黑Ⅴ-Ⅲ门的伊兰罗尼是优雅得体的淑女，擅长在裙摆飘飘、光芒闪耀间使出杀手。',1,''),
+(117,'斯加尔卡',356,1,5,508,'暗黑VI-I门的守护者，擅长使用暗黑电能的家伙，比起折磨对手的身体，斯加尔卡更喜欢震慑对手的心灵。',1,''),
+(118,'艾尔伊洛',297,1,5,508,'暗黑VI-II门的守护者，历经了炼狱洗礼的艾尔伊洛开始崇尚爽快的攻击方式，喜欢凭借精湛的技巧近距地伤害对手。',1,''),
+(119,'布林克克',359,1,5,508,'暗黑VI-III门的守护者，拥有海妖之力的庇护，体内充满着混沌的能量企图吞噬整个海洋。',1,''),
+(502,'魔花使者',438,1,5,509,'暗黑VII-I门的守护者，比恩特的进化形态，浑身散发着反物质世界中的黑暗气息，散发出来的毒粉是它的致命武器。',1,''),
+(503,'莫尔加斯',441,1,5,509,'暗黑VII-II门的守护者，莫鲁格尔的进化形态，受到了反物质世界的影响，浑身被黑暗所包围，拥有极强的防御能力，所有攻击在它面前都显得非常渺小。',1,''),
+(504,'萨诺拉斯',435,1,5,509,'暗黑VII-III门的守护者，萨诺的进化形态，经过岩浆洗礼的皮肤拥有独特的降温功能，即使在极其炎热的环境下依然不受影响。',1,''),
+(606,'帕多尼',656,1,5,510,'暗黑Ⅷ-Ⅰ门的守护者，浑身充斥着暗黑能量，暗黑能量会随着它的歌神散发出来。',1,''),
+(607,'加洛德',659,1,5,510,'暗黑Ⅷ-Ⅱ门的守护，暗黑能量的注入，使它的脾气变得暴躁，擅长与对手近身搏斗，浑身的尖刺、催生出的植物都是它进攻的利器。',1,''),
+(608,'萨多拉尼',661,1,5,510,'暗黑Ⅷ-Ⅲ门的守护，将暗黑能量融入自身，肢体变得非常结实有力，虽然体积很小，但是却拥有了堪比巨龙的神力。',1,'')
+ON CONFLICT (task_id) WHERE deleted_at IS NULL DO UPDATE
+SET
+    title = EXCLUDED.title,
+    pet_id = EXCLUDED.pet_id,
+    online = EXCLUDED.online,
+    level = EXCLUDED.level,
+    enter_id = EXCLUDED.enter_id,
+    description = EXCLUDED.description,
+    is_enable = EXCLUDED.is_enable,
+    remark = EXCLUDED.remark,
+    "updateTime" = NOW();
+
+COMMIT;

help/约束类.sql

@@ -1,42 +1,254 @@
+-- 唯一约束修复
+-- 规则：所有带 deleted_at 的业务唯一约束，只约束未软删除记录。
+
 -- 玩家+物品+VIP状态 联合唯一
 ALTER TABLE player_item
-ADD CONSTRAINT uk_player_item_player_item_vip
+DROP CONSTRAINT IF EXISTS uk_player_item_player_item_vip;
-UNIQUE (player_id, item_id, is_vip);
+DROP INDEX IF EXISTS uk_player_item_player_item_vip;
+
+CREATE UNIQUE INDEX IF NOT EXISTS uk_player_item_player_item_vip
+ON player_item (player_id, item_id, is_vip)
+WHERE deleted_at IS NULL;
 
 
 -- 玩家+挖矿 联合唯一
-CREATE UNIQUE INDEX uk_talk_player ON player_talk (talk_id, player_id);
+ALTER TABLE player_talk
+DROP CONSTRAINT IF EXISTS uk_talk_player;
+DROP INDEX IF EXISTS uk_talk_player;
+
+CREATE UNIQUE INDEX IF NOT EXISTS uk_talk_player
+ON player_talk (talk_id, player_id)
+WHERE deleted_at IS NULL;
 
 
 -- 玩家+任务 联合唯一
-CREATE UNIQUE INDEX uk_player_task ON player_task (player_id, task_id);
+ALTER TABLE player_task
+DROP CONSTRAINT IF EXISTS uk_player_task;
+DROP INDEX IF EXISTS uk_player_task;
+
+CREATE UNIQUE INDEX IF NOT EXISTS uk_player_task
+ON player_task (player_id, task_id)
+WHERE deleted_at IS NULL;
+
+
 -- 玩家+称号 联合唯一
-CREATE UNIQUE INDEX uk_player_title ON player_title (player_id, is_vip) WHERE deleted_at IS NULL;
+ALTER TABLE player_title
+DROP CONSTRAINT IF EXISTS uk_player_title;
+DROP INDEX IF EXISTS uk_player_title;
+
+CREATE UNIQUE INDEX IF NOT EXISTS uk_player_title
+ON player_title (player_id, is_vip)
+WHERE deleted_at IS NULL;
+
 
 -- 玩家+精灵 联合唯一
-CREATE UNIQUE INDEX uk_player_pet ON player_pet (player_id, is_vip, catch_time) WHERE deleted_at IS NULL;
+ALTER TABLE player_pet
+DROP CONSTRAINT IF EXISTS uk_player_pet;
+DROP INDEX IF EXISTS uk_player_pet;
+
+CREATE UNIQUE INDEX IF NOT EXISTS uk_player_pet
+ON player_pet (player_id, is_vip, catch_time)
+WHERE deleted_at IS NULL;
+
 
 -- 玩家+CDK 联合唯一
-CREATE UNIQUE INDEX uk_player_cdk_log
+ALTER TABLE player_cdk_log
+DROP CONSTRAINT IF EXISTS uk_player_cdk_log;
+DROP INDEX IF EXISTS uk_player_cdk_log;
+
+CREATE UNIQUE INDEX IF NOT EXISTS uk_player_cdk_log
 ON player_cdk_log (player_id, code_id, is_vip)
 WHERE deleted_at IS NULL;
 
 
 -- 玩家孵蛋 联合唯一
- CREATE UNIQUE INDEX uk_player_egg 
+ALTER TABLE player_egg
+DROP CONSTRAINT IF EXISTS uk_player_egg;
+DROP INDEX IF EXISTS uk_player_egg;
+
+CREATE UNIQUE INDEX IF NOT EXISTS uk_player_egg
 ON player_egg (player_id, is_vip)
 WHERE deleted_at IS NULL;
 
----PVP索引
+
-CREATE UNIQUE INDEX uk_player_pvp
+-- PVP索引
+ALTER TABLE player_pvp
+DROP CONSTRAINT IF EXISTS uk_player_pvp;
+DROP INDEX IF EXISTS uk_player_pvp;
+
+CREATE UNIQUE INDEX IF NOT EXISTS uk_player_pvp
 ON player_pvp (player_id, season)
 WHERE deleted_at IS NULL;
 
---签到
+
-CREATE UNIQUE INDEX uk_player_sign_in_log
+-- 签到
+ALTER TABLE player_sign_in_log
+DROP CONSTRAINT IF EXISTS uk_player_sign_in_log;
+DROP INDEX IF EXISTS uk_player_sign_in_log;
+
+CREATE UNIQUE INDEX IF NOT EXISTS uk_player_sign_in_log
 ON player_sign_in_log (player_id, sign_in_id, is_vip)
 WHERE deleted_at IS NULL;
---房间索引
+
-CREATE UNIQUE INDEX uk_player_room_house
+
+-- 房间索引
+ALTER TABLE player_room_house
+DROP CONSTRAINT IF EXISTS uk_player_room_house;
+DROP INDEX IF EXISTS uk_player_room_house;
+
+CREATE UNIQUE INDEX IF NOT EXISTS uk_player_room_house
 ON player_room_house (player_id, is_vip)
 WHERE deleted_at IS NULL;
+
+
+-- 集市权限角色 联合唯一
+-- 先清理有效重复授权，保留每组 userId + roleId 中 id 最小的一条。
+DELETE FROM base_sys_user_role a
+USING base_sys_user_role b
+WHERE a."userId" = b."userId"
+  AND a."roleId" = b."roleId"
+  AND a.deleted_at IS NULL
+  AND b.deleted_at IS NULL
+  AND a.id > b.id;
+
+ALTER TABLE base_sys_user_role
+DROP CONSTRAINT IF EXISTS uk_base_sys_user_role_user_role;
+DROP INDEX IF EXISTS uk_base_sys_user_role_user_role;
+
+CREATE UNIQUE INDEX IF NOT EXISTS uk_base_sys_user_role_user_role
+ON base_sys_user_role ("userId", "roleId")
+WHERE deleted_at IS NULL;
+
+
+-- CDK配置 编号唯一
+ALTER TABLE config_gift_cdk
+DROP CONSTRAINT IF EXISTS idx_config_gift_cdk_cdk_code;
+DROP INDEX IF EXISTS idx_config_gift_cdk_cdk_code;
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_config_gift_cdk_cdk_code
+ON config_gift_cdk (cdk_code)
+WHERE deleted_at IS NULL;
+
+
+-- 战斗规则 规则索引唯一
+ALTER TABLE config_fight_rule
+DROP CONSTRAINT IF EXISTS idx_rule_idx;
+DROP INDEX IF EXISTS idx_rule_idx;
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_rule_idx
+ON config_fight_rule (rule_idx)
+WHERE deleted_at IS NULL;
+
+
+-- 天选配置 玩家+精灵唯一
+ALTER TABLE config_peak_tianxuan
+DROP CONSTRAINT IF EXISTS idx_peak_tianxuan_player_pet;
+DROP INDEX IF EXISTS idx_peak_tianxuan_player_pet;
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_peak_tianxuan_player_pet
+ON config_peak_tianxuan (player_id, pet_id)
+WHERE deleted_at IS NULL;
+
+
+-- 天选投票 周期+玩家唯一
+ALTER TABLE config_peak_tianxuan_vote
+DROP CONSTRAINT IF EXISTS idx_peak_tianxuan_vote_week_player;
+DROP INDEX IF EXISTS idx_peak_tianxuan_vote_week_player;
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_peak_tianxuan_vote_week_player
+ON config_peak_tianxuan_vote (week_index, player_id)
+WHERE deleted_at IS NULL;
+
+
+-- 服务器冠名 同服同属主唯一
+ALTER TABLE server_show
+DROP CONSTRAINT IF EXISTS idx_server_show_server_owner;
+DROP INDEX IF EXISTS idx_server_show_server_owner;
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_server_show_server_owner
+ON server_show (server_id, owner)
+WHERE deleted_at IS NULL;
+
+
+-- 商店 商品ID唯一
+ALTER TABLE config_shop
+DROP CONSTRAINT IF EXISTS idx_config_shop_product_id;
+DROP INDEX IF EXISTS idx_config_shop_product_id;
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_config_shop_product_id
+ON config_shop (product_id)
+WHERE deleted_at IS NULL;
+
+
+-- 签到配置 签到类别+阶段唯一
+ALTER TABLE config_sign_in
+DROP CONSTRAINT IF EXISTS idx_sign_type_stage;
+DROP INDEX IF EXISTS idx_sign_type_stage;
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_sign_type_stage
+ON config_sign_in (sign_type, stage_days)
+WHERE deleted_at IS NULL;
+
+
+-- 签到配置 CDK唯一
+ALTER TABLE config_sign_in
+DROP CONSTRAINT IF EXISTS idx_config_sign_in_cdk_id;
+DROP INDEX IF EXISTS idx_config_sign_in_cdk_id;
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_config_sign_in_cdk_id
+ON config_sign_in (cdk_id)
+WHERE deleted_at IS NULL;
+
+
+-- SPT配置 任务ID唯一
+ALTER TABLE config_spt
+DROP CONSTRAINT IF EXISTS idx_config_spt_task_id;
+DROP INDEX IF EXISTS idx_config_spt_task_id;
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_config_spt_task_id
+ON config_spt (task_id)
+WHERE deleted_at IS NULL;
+
+
+-- 爬塔配置 层级唯一
+ALTER TABLE config_tower_1
+DROP CONSTRAINT IF EXISTS idx_config_tower_1_tower_level;
+DROP INDEX IF EXISTS idx_config_tower_1_tower_level;
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_config_tower_1_tower_level
+ON config_tower_1 (tower_level)
+WHERE deleted_at IS NULL;
+
+ALTER TABLE config_tower_110
+DROP CONSTRAINT IF EXISTS idx_config_tower_110_tower_level;
+DROP INDEX IF EXISTS idx_config_tower_110_tower_level;
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_config_tower_110_tower_level
+ON config_tower_110 (tower_level)
+WHERE deleted_at IS NULL;
+
+ALTER TABLE config_tower_500
+DROP CONSTRAINT IF EXISTS idx_config_tower_500_tower_level;
+DROP INDEX IF EXISTS idx_config_tower_500_tower_level;
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_config_tower_500_tower_level
+ON config_tower_500 (tower_level)
+WHERE deleted_at IS NULL;
+
+ALTER TABLE config_tower_600
+DROP CONSTRAINT IF EXISTS idx_config_tower_600_tower_level;
+DROP INDEX IF EXISTS idx_config_tower_600_tower_level;
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_config_tower_600_tower_level
+ON config_tower_600 (tower_level)
+WHERE deleted_at IS NULL;
+
+
+-- 玩家信息 角色ID唯一
+ALTER TABLE player_info
+DROP CONSTRAINT IF EXISTS idx_player_info_player_id;
+DROP INDEX IF EXISTS idx_player_info_player_id;
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_player_info_player_id
+ON player_info (player_id)
+WHERE deleted_at IS NULL;

logic/controller/Controller.go

@@ -4,6 +4,7 @@
 package controller
 
 import (
+	"blazing/common/rpc"
 	"blazing/cool"
 	"blazing/logic/service/common"
 	"bytes"
@@ -16,6 +17,7 @@ import (
 
 	"github.com/gogf/gf/v2/os/glog"
 	"github.com/lunixbochs/struc"
+	"github.com/panjf2000/gnet/v2"
 )
 
 // Maincontroller 是控制器层共享变量。
@@ -25,9 +27,13 @@ var Maincontroller = &Controller{} //注入service
 type Controller struct {
 	UID       uint32
 	RPCClient *struct {
-		Kick func(uint32) error
+		Kick func(context.Context, uint32) error
 
-		RegisterLogic func(uint32, uint32) error
+		RegisterLogic func(context.Context, uint32, uint32) error
+
+		MatchJoinOrUpdate func(context.Context, rpc.PVPMatchJoinPayload) error
+
+		MatchCancel func(context.Context, uint32) error
 	}
 }
 
@@ -45,19 +51,14 @@ func ParseCmd[T any](data []byte) T {
 // Init 初始化控制器，注册所有cmd处理方法
 // 参数 isGame: 标识是否为游戏服务器(true)或登录服务器(false)
 func Init(isGame bool) {
-	// 获取控制器实例的反射值
 	controllerValue := reflect.ValueOf(Maincontroller)
-
-	// 获取控制器类型
 	controllerType := controllerValue.Type()
 
-	// 遍历控制器的所有方法
 	for i := 0; i < controllerType.NumMethod(); i++ {
 		method := controllerType.Method(i)
-		methodValue := controllerValue.MethodByName(method.Name)
+		methodValue := controllerValue.Method(i)
 		methodType := methodValue.Type()
 
-		// 获取方法第一个参数的类型（请求结构体）
 		if methodType.NumIn() == 0 {
 			continue
 		}
@@ -68,43 +69,46 @@ func Init(isGame bool) {
 			continue
 		}
 		reqType := reqArgType.Elem()
+		binding := getCmdBinding(reqType)
 
-		// 解析请求结构体中的cmd标签
+		for _, cmd := range binding.cmds {
-		for _, cmd := range getCmd(reqType) {
+			if cmd == 0 {
-			if cmd == 0 { // 说明不是有效的注册方法
 				glog.Warning(context.Background(), "方法参数必须包含CMD参数", method.Name, "跳过注册")
 				continue
 			}
 
-			// 根据服务器类型过滤cmd
+			if methodType.NumIn() != 2 {
-			// 登录服务器只处理小于1000的cmd
+				glog.Warning(context.Background(), "方法参数数量必须为2", method.Name, "跳过注册")
+				continue
+			}
+
 			if !isGame && cmd > 1000 {
 				continue
 			}
 
-			// 游戏服务器只处理大于等于1000的cmd
 			if isGame && cmd < 1000 {
 				continue
 			}
 
-			// 注册命令处理函数
 			if cool.Config.ServerInfo.IsDebug != 0 {
 				fmt.Println("注册方法", cmd, method.Name)
 			}
 
-			cmdInfo := cool.Cmd{
-				Func: methodValue,
-				Req:  reqType,
-
-				// Res: , // TODO 待实现对不同用户初始化方法以取消全局cmdcache
-			}
-			// 预编译创建req实例的函数：返回结构体指针
 			reqTypeForNew := reqType
-			cmdInfo.NewReqFunc = func() interface{} {
+			cmdInfo := cool.Cmd{
-				return reflect.New(reqTypeForNew).Interface()
+				Func:             methodValue,
+				Req:              reqType,
+				HeaderFieldIndex: append([]int(nil), binding.headerFieldIndex...),
+				UseConn:          methodType.In(1) == connType,
+				NewReqFunc: func() interface{} {
+					return reflect.New(reqTypeForNew).Interface()
+				},
+				NewReqValue: func() reflect.Value {
+					return reflect.New(reqTypeForNew)
+				},
 			}
 
-			if _, exists := cool.CmdCache[cmd]; exists { // 方法已存在
+			if _, exists := cool.CmdCache[cmd]; exists {
 				panic(fmt.Sprintf("命令处理方法已存在，跳过注册 %d %s", cmd, method.Name))
 			}
 			cool.CmdCache[cmd] = cmdInfo
@@ -112,12 +116,20 @@ func Init(isGame bool) {
 	}
 }
 
-var targetType = reflect.TypeOf(common.TomeeHeader{})
+var (
-var cmdTypeCache sync.Map
+	targetType   = reflect.TypeOf(common.TomeeHeader{})
+	connType     = reflect.TypeOf((*gnet.Conn)(nil)).Elem()
+	cmdTypeCache sync.Map
+)
 
 // 默认返回值（无匹配字段/解析失败时）
 const defaultCmdValue = 0
 
+type cmdBinding struct {
+	cmds             []uint32
+	headerFieldIndex []int
+}
+
 func normalizeStructType(typ reflect.Type) reflect.Type {
 	for typ.Kind() == reflect.Ptr {
 		typ = typ.Elem()
@@ -125,92 +137,93 @@ func normalizeStructType(typ reflect.Type) reflect.Type {
 	return typ
 }
 
-// getCmd 从结构体类型中提取绑定的cmd指令（递归查找嵌套结构体，支持值/指针类型的TomeeHeader）
+// getCmdBinding 从结构体类型中提取绑定的cmd指令和头字段位置。
-// 参数 typ: 待解析的结构体类型（支持多层指针）
+func getCmdBinding(typ reflect.Type) cmdBinding {
-// 返回值: 解析到的cmd切片，无匹配/解析失败时返回[defaultCmdValue]
-func getCmd(typ reflect.Type) []uint32 {
 	typ = normalizeStructType(typ)
 	if cached, ok := cmdTypeCache.Load(typ); ok {
-		return cached.([]uint32)
+		return cached.(cmdBinding)
 	}
 
-	// 非结构体类型直接返回默认值
 	if typ.Kind() != reflect.Struct {
-		return []uint32{defaultCmdValue}
+		binding := cmdBinding{cmds: []uint32{defaultCmdValue}}
+		cmdTypeCache.Store(typ, binding)
+		return binding
 	}
 
-	if cmd, ok := findCmd(typ, make(map[reflect.Type]struct{})); ok {
+	if binding, ok := findCmdBinding(typ, make(map[reflect.Type]struct{})); ok {
-		cmdTypeCache.Store(typ, cmd)
+		cmdTypeCache.Store(typ, binding)
-		return cmd
+		return binding
 	}
 
-	// 未找到目标字段/所有解析失败，返回默认值
+	binding := cmdBinding{cmds: []uint32{defaultCmdValue}}
-	defaultCmd := []uint32{defaultCmdValue}
+	cmdTypeCache.Store(typ, binding)
-	cmdTypeCache.Store(typ, defaultCmd)
+	return binding
-	return defaultCmd
 }
 
-func findCmd(typ reflect.Type, visiting map[reflect.Type]struct{}) ([]uint32, bool) {
+func findCmdBinding(typ reflect.Type, visiting map[reflect.Type]struct{}) (cmdBinding, bool) {
 	typ = normalizeStructType(typ)
 	if typ.Kind() != reflect.Struct {
-		return nil, false
+		return cmdBinding{}, false
 	}
 	if _, seen := visiting[typ]; seen {
-		return nil, false
+		return cmdBinding{}, false
 	}
 	visiting[typ] = struct{}{}
 	defer delete(visiting, typ)
 
-	// 遍历结构体字段，查找TomeeHeader字段并解析cmd
 	for i := 0; i < typ.NumField(); i++ {
 		field := typ.Field(i)
 
-		// 尝试解析当前字段的cmd标签
 		cmdSlice, isHeader, err := parseCmdTagWithStructField(field)
-		if isHeader && err == nil { // 解析成功，直接返回结果
+		if isHeader && err == nil {
-			return cmdSlice, true
+			return cmdBinding{
+				cmds:             cmdSlice,
+				headerFieldIndex: append([]int(nil), field.Index...),
+			}, true
 		}
 
-		// 递归处理嵌套结构体（值/指针类型）
 		nestedTyp := normalizeStructType(field.Type)
-		if nestedTyp.Kind() == reflect.Struct {
+		if nestedTyp.Kind() != reflect.Struct {
-			// 递归查找，找到有效cmd则立即返回
+			continue
-			if nestedCmd, ok := findCmd(nestedTyp, visiting); ok {
-				return nestedCmd, true
-			}
 		}
+
+		nestedBinding, ok := findCmdBinding(nestedTyp, visiting)
+		if !ok {
+			continue
+		}
+
+		fieldIndex := make([]int, 0, len(field.Index)+len(nestedBinding.headerFieldIndex))
+		fieldIndex = append(fieldIndex, field.Index...)
+		fieldIndex = append(fieldIndex, nestedBinding.headerFieldIndex...)
+		nestedBinding.headerFieldIndex = fieldIndex
+		return nestedBinding, true
 	}
 
-	return nil, false
+	return cmdBinding{}, false
 }
 
 // parseCmdTagWithStructField 校验字段是否为TomeeHeader（值/指针）并解析cmd标签
 // 参数 field: 结构体字段元信息
 // 返回值: 解析后的cmd切片，是否为目标类型，解析失败错误
 func parseCmdTagWithStructField(field reflect.StructField) ([]uint32, bool, error) {
-	// 判断字段类型是否为 TomeeHeader 或 *TomeeHeader
 	if field.Type != targetType && !(field.Type.Kind() == reflect.Ptr && field.Type.Elem() == targetType) {
 		return nil, false, nil
 	}
 
-	// 提取cmd标签
 	cmdStr := field.Tag.Get("cmd")
 	if cmdStr == "" {
 		return nil, true, fmt.Errorf("field %s cmd tag is empty", field.Name)
 	}
 
-	// 高性能解析标签为uint32切片（替代gconv，减少第三方依赖且可控）
 	result := make([]uint32, 0, strings.Count(cmdStr, "|")+1)
 	remain := cmdStr
 	for idx := 0; ; idx++ {
 		part, next, found := strings.Cut(remain, "|")
-		// 去除空白字符（兼容标签中意外的空格）
 		s := strings.TrimSpace(part)
 		if s == "" {
 			return nil, true, fmt.Errorf("field %s cmd tag part %d is empty", field.Name, idx)
 		}
 
-		// 手动解析uint32，比gconv更可控，避免隐式转换问题
 		num, err := strconv.ParseUint(s, 10, 32)
 		if err != nil {
 			return nil, true, fmt.Errorf("field %s cmd tag part %d parse error: %v (value: %s)",

logic/controller/action_大师杯.go

@@ -72,26 +72,32 @@ func (h Controller) DASHIbeiR(req *C2s_MASTER_REWARDSR, c *player.Player) (resul
 	}
 
 	result.ItemList = make([]data.ItemInfo, 0, len(taskInfo.ItemList))
-	c.Service.Task.Exec(masterCupTaskID, func(te *model.Task) bool {
+	taskData, taskErr := c.Service.Task.GetTask(masterCupTaskID)
-		progress := bitset32.From(te.Data)
+	if taskErr != nil {
-		if progress.Test(uint(req.ElementType)) {
+		return nil, errorcode.ErrorCode(errorcode.ErrorCodes.ErrSystemError)
-			err = errorcode.ErrorCode(errorcode.ErrorCodes.ErrAwardAlreadyClaimed)
+	}
-			return false
-		}
 
-		consumeMasterCupItems(c, requiredItems)
+	progress := bitset32.From(taskData.Data)
-		progress.Set(uint(req.ElementType))
+	if progress.Test(uint(req.ElementType)) {
-		te.Data = progress.Bytes()
+		return nil, errorcode.ErrorCode(errorcode.ErrorCodes.ErrAwardAlreadyClaimed)
+	}
 
-		if taskInfo.Pet != nil {
+	if err := consumeMasterCupItems(c, requiredItems); err != nil {
-			c.Service.Pet.PetAdd(taskInfo.Pet, 0)
+		return nil, errorcode.ErrorCode(errorcode.ErrorCodes.ErrInsufficientItems)
-			result.CaptureTime = taskInfo.Pet.CatchTime
+	}
-			result.PetTypeId = taskInfo.Pet.ID
+	progress.Set(uint(req.ElementType))
-		}
+	taskData.Data = progress.Bytes()
+	if taskErr = c.Service.Task.SetTask(taskData); taskErr != nil {
+		return nil, errorcode.ErrorCode(errorcode.ErrorCodes.ErrSystemError)
+	}
 
-		appendMasterCupRewardItems(c, result, taskInfo.ItemList)
+	if taskInfo.Pet != nil {
-		return true
+		c.Service.Pet.PetAdd(taskInfo.Pet, 0)
-	})
+		result.CaptureTime = taskInfo.Pet.CatchTime
+		result.PetTypeId = taskInfo.Pet.ID
+	}
+
+	appendMasterCupRewardItems(c, result, taskInfo.ItemList)
 
 	return
 }
@@ -126,10 +132,13 @@ func hasEnoughMasterCupItems(c *player.Player, requiredItems []ItemS) bool {
 	return true
 }
 
-func consumeMasterCupItems(c *player.Player, requiredItems []ItemS) {
+func consumeMasterCupItems(c *player.Player, requiredItems []ItemS) error {
 	for _, item := range requiredItems {
-		c.Service.Item.UPDATE(item.ItemId, -int(item.ItemCnt))
+		if err := c.Service.Item.UPDATE(item.ItemId, -int(item.ItemCnt)); err != nil {
+			return err
+		}
 	}
+	return nil
 }
 
 func appendMasterCupRewardItems(c *player.Player, result *S2C_MASTER_REWARDSR, itemList []data.ItemInfo) {

logic/controller/action_扭蛋.go

@@ -26,12 +26,11 @@ func (h Controller) EggGamePlay(data1 *C2S_EGG_GAME_PLAY, c *player.Player) (res
 	if data1.EggNum > 10 || data1.EggNum <= 0 {
 		return nil, errorcode.ErrorCode(errorcode.ErrorCodes.ErrSystemError)
 	}
-	if r < 0 {
+	if r <= 0 || data1.EggNum > r {
 		return nil, errorcode.ErrorCode(errorcode.ErrorCodes.ErrGachaTicketsInsufficient)
 	}
-	if data1.EggNum > r {
+	if err := c.Service.Item.UPDATE(400501, int(-data1.EggNum)); err != nil {
 		return nil, errorcode.ErrorCode(errorcode.ErrorCodes.ErrGachaTicketsInsufficient)
-
 	}
 	result = &S2C_EGG_GAME_PLAY{ListInfo: []data.ItemInfo{}}
 	if grand.Meet(int(data1.EggNum), 100) {
@@ -52,8 +51,6 @@ func (h Controller) EggGamePlay(data1 *C2S_EGG_GAME_PLAY, c *player.Player) (res
 	for _, item := range addedItems {
 		result.ListInfo = append(result.ListInfo, data.ItemInfo{ItemId: item.ItemId, ItemCnt: item.ItemCnt})
 	}
-
-	c.Service.Item.UPDATE(400501, int(-data1.EggNum))
 	return
 
 }

logic/controller/action_炫彩碎片.go

@@ -57,6 +57,7 @@ func (h Controller) GET_XUANCAI(data *C2s_GET_XUANCAI, c *player.Player) (result
 
 		// 检查该位是否未被选中（避免重复）
 		if (result.Status & mask) == 0 {
+			result.Status |= mask
 			itemID := uint32(400686 + randBitIdx + 1)
 			selectedItems = append(selectedItems, itemID)
 			itemMask[itemID] = mask

logic/controller/fight_base.go

@@ -21,15 +21,99 @@ func (h Controller) OnReadyToFight(data *ReadyToFightInboundInfo, c *player.Play
 	if err := h.checkFightStatus(c); err != 0 {
 		return nil, err
 	}
+	if h.relayRemoteFightCommand(c, data.Head.CMD, data) {
+		return nil, -1
+	}
 	go c.FightC.ReadyFight(c)
 	return nil, -1
 }
 
+// GroupReadyFightFinish 旧组队协议准备完成。
+func (h Controller) GroupReadyFightFinish(data *GroupReadyFightFinishInboundInfo, c *player.Player) (result *fight.NullOutboundInfo, err errorcode.ErrorCode) {
+	if err := h.checkFightStatus(c); err != 0 {
+		return nil, err
+	}
+	if h.relayRemoteFightCommand(c, data.Head.CMD, data) {
+		return nil, -1
+	}
+	go c.FightC.ReadyFight(c)
+	return nil, -1
+}
+
+func (h Controller) GroupUseSkill(data *GroupUseSkillInboundInfo, c *player.Player) (result *fight.NullOutboundInfo, err errorcode.ErrorCode) {
+	if err := h.checkFightStatus(c); err != 0 {
+		return nil, err
+	}
+	if h.relayRemoteFightCommand(c, data.Head.CMD, data) {
+		return nil, -1
+	}
+	targetRelation := fight.SkillTargetOpponent
+	if data.TargetSide == 1 {
+		targetRelation = fight.SkillTargetAlly
+	}
+	h.dispatchFightActionEnvelope(c, fight.NewSkillActionEnvelope(data.SkillId, int(data.ActorIndex), int(data.TargetPos), targetRelation, 0))
+	c.SendPackCmd(7558, nil)
+	return nil, -1
+}
+
+func (h Controller) GroupUseItem(data *GroupUseItemInboundInfo, c *player.Player) (result *fight.NullOutboundInfo, err errorcode.ErrorCode) {
+	if err := h.checkFightStatus(c); err != 0 {
+		return nil, err
+	}
+	if h.relayRemoteFightCommand(c, data.Head.CMD, data) {
+		return nil, -1
+	}
+	h.dispatchFightActionEnvelope(c, fight.NewItemActionEnvelope(0, data.ItemId, int(data.ActorIndex), int(data.ActorIndex), fight.SkillTargetSelf))
+	return nil, -1
+}
+
+func (h Controller) GroupChangePet(data *GroupChangePetInboundInfo, c *player.Player) (result *fight.NullOutboundInfo, err errorcode.ErrorCode) {
+	if err := h.checkFightStatus(c); err != 0 {
+		return nil, err
+	}
+	if h.relayRemoteFightCommand(c, data.Head.CMD, data) {
+		return nil, -1
+	}
+	h.dispatchFightActionEnvelope(c, fight.NewChangeActionEnvelope(data.CatchTime, int(data.ActorIndex)))
+	return nil, -1
+}
+
+func (h Controller) GroupEscape(data *GroupEscapeInboundInfo, c *player.Player) (result *fight.NullOutboundInfo, err errorcode.ErrorCode) {
+	if err := h.checkFightStatus(c); err != 0 {
+		return nil, err
+	}
+	if h.relayRemoteFightCommand(c, data.Head.CMD, data) {
+		return nil, -1
+	}
+	if fightC, ok := c.FightC.(*fight.FightC); ok && fightC != nil && fightC.LegacyGroupProtocol {
+		fightC.SendLegacyEscapeSuccess(c, int(data.ActorIndex))
+	}
+	h.dispatchFightActionEnvelope(c, fight.NewEscapeActionEnvelope())
+	return nil, 0
+}
+
+func (h Controller) GroupFightWinClose(data *GroupFightWinCloseInboundInfo, c *player.Player) (result *fight.NullOutboundInfo, err errorcode.ErrorCode) {
+	if c != nil {
+		c.QuitFight()
+	}
+	return nil, -1
+}
+
+func (h Controller) GroupFightTimeoutExit(data *GroupFightTimeoutExitInboundInfo, c *player.Player) (result *fight.NullOutboundInfo, err errorcode.ErrorCode) {
+	if c != nil {
+		c.QuitFight()
+	}
+	return nil, -1
+}
+
 // UseSkill 使用技能包
 func (h Controller) UseSkill(data *UseSkillInInfo, c *player.Player) (result *fight.NullOutboundInfo, err errorcode.ErrorCode) {
 	if err := h.checkFightStatus(c); err != 0 {
 		return nil, err
 	}
+	if h.relayRemoteFightCommand(c, data.Head.CMD, data) {
+		return nil, 0
+	}
 	h.dispatchFightActionEnvelope(c, buildLegacyUseSkillEnvelope(data))
 	return nil, 0
 }
@@ -40,6 +124,9 @@ func (h Controller) UseSkillAt(data *UseSkillAtInboundInfo, c *player.Player) (r
 	if err := h.checkFightStatus(c); err != 0 {
 		return nil, err
 	}
+	if h.relayRemoteFightCommand(c, data.Head.CMD, data) {
+		return nil, 0
+	}
 	h.dispatchFightActionEnvelope(c, buildIndexedUseSkillEnvelope(data))
 	return nil, 0
 }
@@ -49,6 +136,9 @@ func (h Controller) Escape(data *EscapeFightInboundInfo, c *player.Player) (resu
 	if err := h.checkFightStatus(c); err != 0 {
 		return nil, err
 	}
+	if h.relayRemoteFightCommand(c, data.Head.CMD, data) {
+		return nil, 0
+	}
 	h.dispatchFightActionEnvelope(c, buildLegacyEscapeEnvelope())
 	return nil, 0
 }
@@ -58,6 +148,9 @@ func (h Controller) ChangePet(data *ChangePetInboundInfo, c *player.Player) (res
 	if err := h.checkFightStatus(c); err != 0 {
 		return nil, err
 	}
+	if h.relayRemoteFightCommand(c, data.Head.CMD, data) {
+		return nil, -1
+	}
 	h.dispatchFightActionEnvelope(c, buildLegacyChangeEnvelope(data))
 	return nil, -1
 }
@@ -82,6 +175,9 @@ func (h Controller) LoadPercent(data *LoadPercentInboundInfo, c *player.Player)
 	if c.FightC == nil {
 		return nil, -1
 	}
+	if h.relayRemoteFightCommand(c, data.Head.CMD, data) {
+		return nil, -1
+	}
 	go c.FightC.LoadPercent(c, int32(data.Percent))
 	return nil, -1
 }
@@ -91,6 +187,9 @@ func (h Controller) UsePetItemInboundInfo(data *UsePetItemInboundInfo, c *player
 	if err := h.checkFightStatus(c); err != 0 {
 		return nil, err
 	}
+	if h.relayRemoteFightCommand(c, data.Head.CMD, data) {
+		return nil, -1
+	}
 	if c.GetSpace().IsTime {
 		if data.ItemId < 300009 {
 			go c.FightC.UseSkill(c, 0)
@@ -106,6 +205,9 @@ func (h Controller) FightChat(data *ChatInfo, c *player.Player) (result *fight.N
 	if err := h.checkFightStatus(c); err != 0 {
 		return nil, err
 	}
+	if h.relayRemoteFightCommand(c, data.Head.CMD, data) {
+		return nil, -1
+	}
 	h.dispatchFightActionEnvelope(c, buildChatEnvelope(data))
 	return nil, -1
 }

logic/controller/fight_boss野怪和地图怪.go

@@ -18,7 +18,8 @@ import (
 )
 
 const (
-	rewardItemExpPool = 3
+	rewardItemExpPool  = 3
+	groupBossSlotLimit = 3
 )
 
 // PlayerFightBoss 挑战地图boss
@@ -27,7 +28,10 @@ func (Controller) PlayerFightBoss(req *ChallengeBossInboundInfo, p *player.Playe
 		return nil, err
 	}
 
-	mapNode := service.NewMapNodeService().GetDataNode(p.Info.MapID, req.BossId)
+	mapNode := p.GetSpace().GetMatchedMapNode(req.BossId)
+	if mapNode == nil {
+		return nil, errorcode.ErrorCodes.ErrPokemonNotExists
+	}
 	bossConfigs, err := loadMapBossConfigs(mapNode)
 	if err != 0 {
 		return nil, err
@@ -39,7 +43,7 @@ func (Controller) PlayerFightBoss(req *ChallengeBossInboundInfo, p *player.Playe
 	}
 
 	p.Fightinfo.Status = fightinfo.BattleMode.FIGHT_WITH_NPC
-	p.Fightinfo.Mode = fightinfo.BattleMode.MULTI_MODE
+	p.Fightinfo.Mode = resolveMapNodeFightMode(mapNode)
 
 	ai := player.NewAI_player(monsterInfo)
 	ai.CanCapture = resolveBossCaptureRate(bossConfigs[0].IsCapture, leadMonsterID)
@@ -47,7 +51,7 @@ func (Controller) PlayerFightBoss(req *ChallengeBossInboundInfo, p *player.Playe
 	ai.AddBattleProp(0, 2)
 
 	var fightC *fight.FightC
-	fightC, err = fight.NewFight(p, ai, p.GetPetInfo(100), ai.GetPetInfo(0), func(foi model.FightOverInfo) {
+	fightC, err = startMapBossFight(mapNode, p, ai, func(foi model.FightOverInfo) {
 		if mapNode.WinBonusID == 0 {
 			return
 		}
@@ -62,13 +66,40 @@ func (Controller) PlayerFightBoss(req *ChallengeBossInboundInfo, p *player.Playe
 	return nil, -1
 }
 
+func startMapBossFight(
+	mapNode *configmodel.MapNode,
+	p *player.Player,
+	ai *player.AI_player,
+	fn func(model.FightOverInfo),
+) (*fight.FightC, errorcode.ErrorCode) {
+	ourPets := p.GetPetInfo(p.CurrentMapPetLevelLimit())
+	oppPets := ai.GetPetInfo(0)
+	if mapNode != nil && mapNode.IsGroupBoss != 0 {
+		if len(ourPets) > 0 && len(oppPets) > 0 {
+			slotLimit := groupBossSlotLimit
+			if mapNode.PkFlag != 0 {
+				slotLimit = 1
+			}
+			return fight.NewLegacyGroupFightSingleController(p, ai, ourPets, oppPets, slotLimit, fn)
+		}
+	}
+	return fight.NewFight(p, ai, ourPets, oppPets, fn)
+}
+
+func resolveMapNodeFightMode(mapNode *configmodel.MapNode) uint32 {
+	if mapNode != nil && mapNode.PkFlag != 0 {
+		return fightinfo.BattleMode.SINGLE_MODE
+	}
+	return fightinfo.BattleMode.MULTI_MODE
+}
+
 // OnPlayerFightNpcMonster 战斗野怪
 func (Controller) OnPlayerFightNpcMonster(req *FightNpcMonsterInboundInfo, p *player.Player) (result *fight.NullOutboundInfo, err errorcode.ErrorCode) {
 	if err = p.CanFight(); err != 0 {
 		return nil, err
 	}
-	if req.Number > 9 {
+	if int(req.Number) >= len(p.Data) {
-		return nil, errorcode.ErrorCodes.ErrSystemError
+		return nil, errorcode.ErrorCodes.ErrPokemonNotHere
 	}
 
 	refPet := p.Data[req.Number]
@@ -83,7 +114,7 @@ func (Controller) OnPlayerFightNpcMonster(req *FightNpcMonsterInboundInfo, p *pl
 	p.Fightinfo.Status = fightinfo.BattleMode.FIGHT_WITH_NPC
 	p.Fightinfo.Mode = fightinfo.BattleMode.MULTI_MODE
 
-	_, err = fight.NewFight(p, ai, p.GetPetInfo(100), ai.GetPetInfo(0), func(foi model.FightOverInfo) {
+	_, err = fight.NewFight(p, ai, p.GetPetInfo(p.CurrentMapPetLevelLimit()), ai.GetPetInfo(0), func(foi model.FightOverInfo) {
 		handleNpcFightRewards(p, foi, monster)
 	})
 	if err != 0 {
@@ -205,7 +236,7 @@ func shouldGrantBossWinBonus(fightC *fight.FightC, playerID uint32, bossConfig c
 
 func buildNpcMonsterInfo(refPet player.OgrePetInfo, mapID uint32) (*model.PetInfo, *model.PlayerInfo, errorcode.ErrorCode) {
 	if refPet.ID == 0 {
-		return nil, nil, errorcode.ErrorCodes.ErrPokemonNotExists
+		return nil, nil, errorcode.ErrorCodes.ErrPokemonNotHere
 	}
 
 	monster := model.GenPetInfo(

logic/controller/fight_pvp_withplayer.go

@@ -55,7 +55,7 @@ func (h Controller) OnPlayerHandleFightInvite(data *HandleFightInviteInboundInfo
 				return
 			}
 
-			_, err = fight.NewFight(v, c, v.GetInfo().PetList, c.GetInfo().PetList, func(foi model.FightOverInfo) {
+			_, err = fight.NewFight(v, c, v.GetPetInfo(100), c.GetPetInfo(100), func(foi model.FightOverInfo) {
 
 				//println("好友对战测试", foi.Reason)
 

logic/controller/fight_unified.go

@@ -4,9 +4,21 @@ import (
 	"blazing/modules/player/model"
 
 	"blazing/logic/service/fight"
+	"blazing/logic/service/fight/pvp"
 	"blazing/logic/service/player"
 )
 
+func (h Controller) relayRemoteFightCommand(c *player.Player, cmd uint32, data any) bool {
+	if c == nil || c.FightC == nil || cmd == 0 {
+		return false
+	}
+	remote, ok := c.FightC.(*pvp.RemoteFightProxy)
+	if !ok || remote == nil {
+		return false
+	}
+	return remote.RelayClientCommand(cmd, data)
+}
+
 // dispatchFightActionEnvelope 把控制器层收到的统一动作结构分发回现有 FightI 接口。
 func (h Controller) dispatchFightActionEnvelope(c *player.Player, envelope fight.FightActionEnvelope) {
 	if c == nil || c.FightC == nil {

logic/controller/fight_塔.go

@@ -13,7 +13,6 @@ import (
 
 	"sync/atomic"
 
-	"github.com/gogf/gf/v2/util/gconv"
 	"github.com/jinzhu/copier"
 )
 
@@ -207,32 +206,8 @@ func buildTowerMonsterInfo(towerBoss configmodel.BaseTowerConfig) (*model.Player
 	monsterInfo := &model.PlayerInfo{Nick: towerBoss.Name}
 	for i, boss := range bosses {
 		monster := model.GenPetInfo(int(boss.MonID), 24, int(boss.Nature), 0, int(boss.Lv), nil, 0)
-		if boss.Hp != 0 {
+		monster.ConfigBoss(boss.PetBaseConfig)
-			monster.Hp = uint32(boss.Hp)
+		appendPetEffects(monster, boss.Effect)
-			monster.MaxHp = uint32(boss.Hp)
-		}
-
-		for statIdx, prop := range boss.Prop {
-			if prop != 0 {
-				monster.Prop[statIdx] = prop
-			}
-		}
-
-		for skillIdx := 0; skillIdx < len(monster.SkillList) && skillIdx < len(boss.SKill); skillIdx++ {
-			if boss.SKill[skillIdx] != 0 {
-				monster.SkillList[skillIdx].ID = boss.SKill[skillIdx]
-			}
-		}
-
-		effects := service.NewEffectService().Args(boss.Effect)
-		for _, effect := range effects {
-			monster.EffectInfo = append(monster.EffectInfo, model.PetEffectInfo{
-				Idx:  uint16(effect.ID),
-				EID:  gconv.Uint16(effect.Eid),
-				Args: gconv.Ints(effect.Args),
-			})
-		}
-
 		monster.CatchTime = uint32(i)
 		monsterInfo.PetList = append(monsterInfo.PetList, *monster)
 	}

logic/controller/fight_巅峰.go

@@ -1,11 +1,14 @@
 package controller
 
 import (
+	"blazing/common/rpc"
 	"blazing/common/socket/errorcode"
+	"blazing/cool"
 	"blazing/logic/service/common"
 	"blazing/logic/service/fight"
 	"blazing/logic/service/fight/pvp"
 	"blazing/logic/service/player"
+	"context"
 )
 
 // 表示"宠物王加入"的入站消息数据
@@ -13,6 +16,8 @@ type PetTOPLEVELnboundInfo struct {
 	Head common.TomeeHeader `cmd:"2458" struc:"skip"`
 	Mode uint32             //巅峰赛对战模式 19 = 普通模式单精灵 20 = 普通模式多精灵
 
+	TianxuanPetIDsLen uint32   `struc:"sizeof=TianxuanPetIDs"`
+	TianxuanPetIDs    []uint32 `json:"tianxuanPetIds"`
 }
 
 // JoINtop 处理控制器请求。
@@ -21,11 +26,41 @@ func (h Controller) JoINtop(data *PetTOPLEVELnboundInfo, c *player.Player) (resu
 	if err != 0 {
 		return nil, err
 	}
+	if Maincontroller.RPCClient == nil || Maincontroller.RPCClient.MatchJoinOrUpdate == nil {
+		pvp.CancelPeakQueue(c)
+		return nil, errorcode.ErrorCodes.ErrSystemBusyTryLater
+	}
+	fightMode, status, err := pvp.NormalizePeakMode(data.Mode)
+	if err != 0 {
+		pvp.CancelPeakQueue(c)
+		return nil, err
+	}
+	joinPayload := rpc.PVPMatchJoinPayload{
+		RuntimeServerID: h.UID,
+		UserID:          c.Info.UserID,
+		Nick:            c.Info.Nick,
+		FightMode:       fightMode,
+		Status:          status,
+		IsVip:           cool.Config.ServerInfo.IsVip,
+		IsDebug:         cool.Config.ServerInfo.IsDebug,
+		CatchTimes:      pvp.AvailableCatchTimes(c.GetPetInfo(0)),
+	}
+	ctx, cancel := context.WithTimeout(context.Background(), rpc.ClientCallTimeout)
+	defer cancel()
+	if callErr := Maincontroller.RPCClient.MatchJoinOrUpdate(ctx, joinPayload); callErr != nil {
+		pvp.CancelPeakQueue(c)
+		return nil, errorcode.ErrorCodes.ErrSystemBusyTryLater
+	}
 	return nil, -1
 }
 
 // CancelPeakQueue 处理控制器请求。
 func (h Controller) CancelPeakQueue(data *PeakQueueCancelInboundInfo, c *player.Player) (result *fight.NullOutboundInfo, err errorcode.ErrorCode) {
+	if Maincontroller.RPCClient != nil && Maincontroller.RPCClient.MatchCancel != nil {
+		ctx, cancel := context.WithTimeout(context.Background(), rpc.ClientCallTimeout)
+		_ = Maincontroller.RPCClient.MatchCancel(ctx, c.Info.UserID)
+		cancel()
+	}
 	pvp.CancelPeakQueue(c)
 	return nil, -1
 }

logic/controller/inbound_fight.go

@@ -19,6 +19,44 @@ type ReadyToFightInboundInfo struct {
 	Head common.TomeeHeader `cmd:"2404" struc:"skip"`
 }
 
+// GroupReadyFightFinishInboundInfo 旧组队协议准备完成。
+type GroupReadyFightFinishInboundInfo struct {
+	Head common.TomeeHeader `cmd:"7556" struc:"skip"`
+}
+
+type GroupUseSkillInboundInfo struct {
+	Head       common.TomeeHeader `cmd:"7558" struc:"skip"`
+	ActorIndex uint8
+	TargetSide uint8
+	TargetPos  uint8
+	SkillId    uint32
+}
+
+type GroupUseItemInboundInfo struct {
+	Head       common.TomeeHeader `cmd:"7562" struc:"skip"`
+	ActorIndex uint8
+	ItemId     uint32
+}
+
+type GroupChangePetInboundInfo struct {
+	Head       common.TomeeHeader `cmd:"7563" struc:"skip"`
+	ActorIndex uint8
+	CatchTime  uint32
+}
+
+type GroupEscapeInboundInfo struct {
+	Head       common.TomeeHeader `cmd:"7565" struc:"skip"`
+	ActorIndex uint8
+}
+
+type GroupFightWinCloseInboundInfo struct {
+	Head common.TomeeHeader `cmd:"7574" struc:"skip"`
+}
+
+type GroupFightTimeoutExitInboundInfo struct {
+	Head common.TomeeHeader `cmd:"7587" struc:"skip"`
+}
+
 // EscapeFightInboundInfo 定义请求或响应数据结构。
 type EscapeFightInboundInfo struct {
 	Head common.TomeeHeader `cmd:"2410" struc:"skip"`

logic/controller/inbound_map_room_nono.go

@@ -87,6 +87,14 @@ type C2S_RoomPetInfo struct {
 	CatchTime uint32             `json:"catchTime"`
 }
 
+// C2S_RoomPetShowToggle 基地展示精灵添加/移除请求
+type C2S_RoomPetShowToggle struct {
+	Head      common.TomeeHeader `cmd:"2326" struc:"skip"`
+	CatchTime uint32             `json:"catchTime"`
+	PetID     uint32             `json:"petID"`
+	Flag      uint32             `json:"flag"` // 1=添加展示, 0=移除展示
+}
+
 // C2S_BUY_FITMENT 定义请求或响应数据结构。
 type C2S_BUY_FITMENT struct {
 	Head  common.TomeeHeader `cmd:"10004" struc:"skip"`

logic/controller/inbound_pet.go

@@ -93,7 +93,18 @@ type C2S_Skill_Sort struct {
 	Skill [4]uint32          `json:"skill_1"`
 }
 
-// C2S_PetFusion 定义请求或响应数据结构。
+// GetPetLearnableSkillsInboundInfo 查询当前精灵可学习技能（含额外技能ExtSKill）
+type GetPetLearnableSkillsInboundInfo struct {
+	Head      common.TomeeHeader `cmd:"52312" struc:"skip"`
+	CatchTime uint32             `json:"catchTime"`
+}
+
+type CommitPetSkillsInboundInfo struct {
+	Head      common.TomeeHeader `cmd:"52313" struc:"skip"`
+	CatchTime uint32             `json:"catchTime"`
+	Skill     [4]uint32          `json:"skill"`
+}
+
 type C2S_PetFusion struct {
 	Head         common.TomeeHeader `cmd:"2351" struc:"skip"`
 	Mcatchtime   uint32             `json:"mcatchtime" msgpack:"mcatchtime"`

logic/controller/inbound_user.go

@@ -16,7 +16,7 @@ type MAIN_LOGIN_IN struct {
 	Sid  []byte             `struc:"[16]byte"`
 }
 
-// CheakSession 处理控制器请求。
+// CheakSession 校验登录session。
 func (l *MAIN_LOGIN_IN) CheakSession() (bool, uint32) {
 	t1 := hex.EncodeToString(l.Sid)
 	r, err := cool.CacheManager.Get(context.Background(), fmt.Sprintf("session:%d", l.Head.UserID))

logic/controller/item_sale.go

@@ -18,10 +18,13 @@ func (h Controller) ItemSale(data *C2S_ITEM_SALE, c *player.Player) (result *fig
 		return nil, errorcode.ErrorCodes.ErrSystemError
 	}
 
+	if err := c.Service.Item.UPDATE(data.ItemId, -gconv.Int(data.Amount)); err != nil {
+		return nil, errorcode.ErrorCodes.ErrInsufficientItems
+	}
+
 	itemConfig := xmlres.ItemsMAP[int(data.ItemId)]
 	if itemConfig.SellPrice != 0 {
 		c.Info.Coins += int64(int64(data.Amount) * int64(itemConfig.SellPrice))
 	}
-	c.Service.Item.UPDATE(data.ItemId, -gconv.Int(data.Amount))
 	return result, 0
 }

logic/controller/item_use.go

@@ -15,6 +15,8 @@ import (
 const (
 	// ItemDefaultLeftTime 道具默认剩余时间（毫秒）
 	ItemDefaultLeftTime = 360000
+	// UniversalNatureItemID 全能性格转化剂Ω
+	UniversalNatureItemID uint32 = 300136
 )
 
 // GetUserItemList 获取用户道具列表
@@ -33,22 +35,38 @@ func (h Controller) GetUserItemList(data *ItemListInboundInfo, c *player.Player)
 // c: 当前玩家对象
 // 返回: 使用后的宠物信息和错误码
 func (h Controller) UsePetItemOutOfFight(data *C2S_USE_PET_ITEM_OUT_OF_FIGHT, c *player.Player) (result *item.S2C_USE_PET_ITEM_OUT_OF_FIGHT, err errorcode.ErrorCode) {
-	_, currentPet, found := c.FindPet(data.CatchTime)
+	slot, found := c.FindPetBagSlot(data.CatchTime)
 	if !found {
 		return nil, errorcode.ErrorCodes.Err10401
 	}
 
+	currentPet := slot.PetInfoPtr()
+	if currentPet == nil {
+		return nil, errorcode.ErrorCodes.Err10401
+	}
+
 	itemID := uint32(data.ItemID)
 	if c.Service.Item.CheakItem(itemID) == 0 {
 		return nil, errorcode.ErrorCodes.ErrInsufficientItems
 	}
 
+	oldHP := currentPet.Hp
 	itemCfg, ok := xmlres.ItemsMAP[int(itemID)]
 	if !ok {
-		return nil, errorcode.ErrorCodes.ErrSystemError
+		errcode := h.handleRegularPetItem(itemID, currentPet)
+		if errcode != 0 {
+			return nil, errcode
+		}
+		refreshPetPaneKeepHP(currentPet, oldHP)
+		if err := c.Service.Item.UPDATE(itemID, -1); err != nil {
+			return nil, errorcode.ErrorCodes.ErrInsufficientItems
+		}
+		c.Service.Info.Save(*c.Info)
+		result = &item.S2C_USE_PET_ITEM_OUT_OF_FIGHT{}
+		copier.Copy(&result, currentPet)
+		return result, 0
 	}
 
-	oldHP := currentPet.Hp
 	var errcode errorcode.ErrorCode
 	switch {
 	case itemID == 300036:
@@ -75,7 +93,10 @@ func (h Controller) UsePetItemOutOfFight(data *C2S_USE_PET_ITEM_OUT_OF_FIGHT, c
 		return nil, errcode
 	}
 
-	c.Service.Item.UPDATE(itemID, -1)
+	if err := c.Service.Item.UPDATE(itemID, -1); err != nil {
+		return nil, errorcode.ErrorCodes.ErrInsufficientItems
+	}
+	c.Service.Info.Save(*c.Info)
 	result = &item.S2C_USE_PET_ITEM_OUT_OF_FIGHT{}
 	copier.Copy(&result, currentPet)
 	return result, 0
@@ -118,7 +139,9 @@ func (h Controller) handlexuancaiItem(currentPet *model.PetInfo, c *player.Playe
 		return errorcode.ErrorCodes.ErrItemUnusable
 	}
 
-	c.Service.Item.UPDATE(itemid, -100)
+	if err := c.Service.Item.UPDATE(itemid, -100); err != nil {
+		return errorcode.ErrorCodes.ErrInsufficientItems
+	}
 	return 0
 }
 
@@ -174,11 +197,24 @@ func (h Controller) handleRegularPetItem(itemID uint32, currentPet *model.PetInf
 // c: 当前玩家对象
 // 返回: 无数据和错误码
 func (h Controller) ResetNature(data *C2S_PET_RESET_NATURE, c *player.Player) (result *fight.NullOutboundInfo, err errorcode.ErrorCode) {
-	_, currentPet, found := c.FindPet(data.CatchTime)
+	slot, found := c.FindPetBagSlot(data.CatchTime)
 	if !found {
 		return nil, errorcode.ErrorCodes.Err10401
 	}
 
+	currentPet := slot.PetInfoPtr()
+	if currentPet == nil {
+		return nil, errorcode.ErrorCodes.Err10401
+	}
+
+	if data.ItemId != UniversalNatureItemID {
+		return nil, errorcode.ErrorCodes.ErrItemUnusable
+	}
+
+	if _, ok := xmlres.NatureRootMap[int(data.Nature)]; !ok {
+		return nil, errorcode.ErrorCodes.ErrItemUnusable
+	}
+
 	if c.Service.Item.CheakItem(data.ItemId) <= 0 {
 		return nil, errorcode.ErrorCodes.ErrInsufficientItems
 	}
@@ -186,7 +222,10 @@ func (h Controller) ResetNature(data *C2S_PET_RESET_NATURE, c *player.Player) (r
 	currentHP := currentPet.Hp
 	currentPet.Nature = data.Nature
 	refreshPetPaneKeepHP(currentPet, currentHP)
-	c.Service.Item.UPDATE(data.ItemId, -1)
+	if err := c.Service.Item.UPDATE(data.ItemId, -1); err != nil {
+		return nil, errorcode.ErrorCodes.ErrInsufficientItems
+	}
+	c.Service.Info.Save(*c.Info)
 	return result, 0
 }
 
@@ -214,29 +253,38 @@ func (h Controller) UseSpeedupItem(data *C2S_USE_SPEEDUP_ITEM, c *player.Player)
 		if c.Info.TwoTimes != 0 {
 			return nil, errorcode.ErrorCodes.ErrItemInUse
 		}
-		c.Info.TwoTimes += 50 // 玩家对象新增 TwoTimesExp 字段存储双倍剩余次数
 	case 300067:
 		if c.Info.TwoTimes != 0 {
 			return nil, errorcode.ErrorCodes.ErrItemInUse
 		}
-		c.Info.TwoTimes += 25 // 玩家对象新增 TwoTimesExp 字段存储双倍剩余次数
 	case 300051: // 假设1002是三倍经验加速器道具ID
 		if c.Info.ThreeTimes != 0 {
 			return nil, errorcode.ErrorCodes.ErrItemInUse
 		}
-		c.Info.ThreeTimes += 50 // 玩家对象新增 ThreeTimesExp 字段存储三倍剩余次数
 	case 300115:
 		if c.Info.ThreeTimes != 0 {
 			return nil, errorcode.ErrorCodes.ErrItemInUse
 		}
-		c.Info.ThreeTimes += 30 // 玩家对象新增 ThreeTimesExp 字段存储三倍剩余次数
 
 	default:
 		return nil, errorcode.ErrorCodes.ErrSystemError // 未知道具ID
 	}
 
 	// 3. 扣减道具（数量-1）
-	c.Service.Item.UPDATE(data.ItemID, -1)
+	if err := c.Service.Item.UPDATE(data.ItemID, -1); err != nil {
+		return nil, errorcode.ErrorCodes.ErrInsufficientItems
+	}
+
+	switch data.ItemID {
+	case 300027: // 假设1001是双倍经验加速器道具ID
+		c.Info.TwoTimes += 50 // 玩家对象新增 TwoTimesExp 字段存储双倍剩余次数
+	case 300067:
+		c.Info.TwoTimes += 25 // 玩家对象新增 TwoTimesExp 字段存储双倍剩余次数
+	case 300051: // 假设1002是三倍经验加速器道具ID
+		c.Info.ThreeTimes += 50 // 玩家对象新增 ThreeTimesExp 字段存储三倍剩余次数
+	case 300115:
+		c.Info.ThreeTimes += 30 // 玩家对象新增 ThreeTimesExp 字段存储三倍剩余次数
+	}
 	result.ThreeTimes = uint32(c.Info.ThreeTimes) // 返回三倍经验剩余次数
 	result.TwoTimes = uint32(c.Info.TwoTimes)     // 返回双倍经验剩余次数
 
@@ -267,10 +315,11 @@ func (h Controller) UseEnergyXishou(data *C2S_USE_ENERGY_XISHOU, c *player.Playe
 	}
 	// 2. 核心业务逻辑：更新能量吸收器剩余次数
 	// （注：可根据道具ID配置不同的次数加成，此处默认+1）
+	if err := c.Service.Item.UPDATE(data.ItemID, -1); err != nil {
+		return nil, errorcode.ErrorCodes.ErrInsufficientItems
+	}
 	c.Info.EnergyTime += 40 // 玩家对象新增 EnergyTimes 字段存储能量吸收剩余次数
 
-	// 3. 扣减道具（数量-1）
-	c.Service.Item.UPDATE(data.ItemID, -1)
 	result = &item.S2C_USE_ENERGY_XISHOU{
 		EnergyTimes: uint32(c.Info.EnergyTime),
 	}
@@ -301,6 +350,9 @@ func (h Controller) UseAutoFightItem(data *C2S_USE_AUTO_FIGHT_ITEM, c *player.Pl
 	if c.Info.AutoFightTime != 0 {
 		return nil, errorcode.ErrorCodes.ErrItemInUse
 	}
+	if err := c.Service.Item.UPDATE(data.ItemID, -1); err != nil {
+		return nil, errorcode.ErrorCodes.ErrInsufficientItems
+	}
 	result = &item.S2C_USE_AUTO_FIGHT_ITEM{}
 	// 2. 核心业务逻辑：开启自动战斗 + 更新剩余次数
 	c.Info.AutoFight = 3 // 按需求设置自动战斗flag为3（需测试）
@@ -316,8 +368,6 @@ func (h Controller) UseAutoFightItem(data *C2S_USE_AUTO_FIGHT_ITEM, c *player.Pl
 		c.Info.AutoFightTime += 50
 	}
 	result.AutoFightTimes = c.Info.AutoFightTime
-	// 3. 扣减道具（数量-1）
-	c.Service.Item.UPDATE(data.ItemID, -1)
 
 	return result, 0
 }

logic/controller/item_use_test.go

@@ -0,0 +1,137 @@
+package controller
+
+import (
+	"blazing/common/data/xmlres"
+	"blazing/logic/service/player"
+	playermodel "blazing/modules/player/model"
+	blservice "blazing/modules/player/service"
+	"testing"
+)
+
+func TestUsePetItemOutOfFightAppliesToBackupPetInMemory(t *testing.T) {
+	petID := firstPetIDForControllerTest(t)
+	backupPet := playermodel.GenPetInfo(petID, 31, 0, 0, 50, nil, 0)
+	if backupPet == nil {
+		t.Fatal("failed to generate backup pet")
+	}
+	if backupPet.MaxHp <= 1 {
+		t.Fatalf("expected generated pet to have max hp > 1, got %d", backupPet.MaxHp)
+	}
+	backupPet.Hp = 1
+
+	testPlayer := player.NewPlayer(nil)
+	testPlayer.Info = &playermodel.PlayerInfo{
+		UserID:        1,
+		PetList:       []playermodel.PetInfo{},
+		BackupPetList: []playermodel.PetInfo{*backupPet},
+	}
+	testPlayer.Service = blservice.NewUserService(testPlayer.Info.UserID)
+
+	itemID, recoverHP := firstRecoverHPItemForControllerTest(t)
+	if recoverHP <= 0 {
+		t.Fatalf("expected positive recover hp for item %d, got %d", itemID, recoverHP)
+	}
+
+	_, err := (Controller{}).UsePetItemOutOfFight(&C2S_USE_PET_ITEM_OUT_OF_FIGHT{
+		CatchTime: backupPet.CatchTime,
+		ItemID:    int32(itemID),
+	}, testPlayer)
+	if err != 0 {
+		t.Fatalf("expected backup pet item use to succeed in-memory, got err=%d", err)
+	}
+
+	updatedPet := testPlayer.Info.BackupPetList[0]
+	if updatedPet.Hp <= 1 {
+		t.Fatalf("expected backup pet hp to increase in memory, got hp=%d", updatedPet.Hp)
+	}
+}
+
+func TestUsePetItemOutOfFightPersistsEnergyOrbEffectInfo(t *testing.T) {
+	petID := firstPetIDForControllerTest(t)
+	petInfo := playermodel.GenPetInfo(petID, 31, 0, 0, 50, nil, 0)
+	if petInfo == nil {
+		t.Fatal("failed to generate test pet")
+	}
+
+	testPlayer := player.NewPlayer(nil)
+	testPlayer.Info = &playermodel.PlayerInfo{
+		UserID:  10001,
+		PetList: []playermodel.PetInfo{*petInfo},
+	}
+	testPlayer.Service = blservice.NewUserService(testPlayer.Info.UserID)
+
+	itemID, effectCfg := firstEnergyOrbItemForControllerTest(t)
+	if err := testPlayer.Service.Item.UPDATE(itemID, 1); err != nil {
+		t.Fatalf("failed to seed energy orb item %d: %v", itemID, err)
+	}
+
+	_, err := (Controller{}).UsePetItemOutOfFight(&C2S_USE_PET_ITEM_OUT_OF_FIGHT{
+		CatchTime: petInfo.CatchTime,
+		ItemID:    int32(itemID),
+	}, testPlayer)
+	if err != 0 {
+		t.Fatalf("expected energy orb use to succeed, got err=%d", err)
+	}
+
+	storedPet := testPlayer.Info.PetList[0]
+	if len(storedPet.EffectInfo) == 0 {
+		t.Fatalf("expected pet effect info to persist after using item %d", itemID)
+	}
+
+	last := storedPet.EffectInfo[len(storedPet.EffectInfo)-1]
+	if last.ItemID != itemID {
+		t.Fatalf("expected stored item id %d, got %d", itemID, last.ItemID)
+	}
+	if last.Status != 2 {
+		t.Fatalf("expected energy orb status 2, got %d", last.Status)
+	}
+	if last.EID != uint16(atoiOrZero(effectCfg.Eid)) {
+		t.Fatalf("expected effect id %s, got %d", effectCfg.Eid, last.EID)
+	}
+}
+
+func firstRecoverHPItemForControllerTest(t *testing.T) (uint32, int) {
+	t.Helper()
+
+	for id, cfg := range xmlres.ItemsMAP {
+		if cfg.HP > 0 {
+			return uint32(id), cfg.HP
+		}
+	}
+
+	t.Fatal("xmlres.ItemsMAP has no HP recovery item")
+	return 0, 0
+}
+
+func firstEnergyOrbItemForControllerTest(t *testing.T) (uint32, xmlres.NewSeIdx) {
+	t.Helper()
+
+	for id, itemCfg := range xmlres.ItemsMAP {
+		if itemCfg.NewSeIdx == 0 {
+			continue
+		}
+
+		effectCfg, ok := xmlres.EffectMAP[itemCfg.NewSeIdx]
+		if !ok {
+			continue
+		}
+
+		if effectCfg.Stat == "2" && effectCfg.ItemId != nil {
+			return uint32(id), effectCfg
+		}
+	}
+
+	t.Fatal("xmlres.ItemsMAP has no energy orb item")
+	return 0, xmlres.NewSeIdx{}
+}
+
+func atoiOrZero(value string) int {
+	result := 0
+	for _, ch := range value {
+		if ch < '0' || ch > '9' {
+			return result
+		}
+		result = result*10 + int(ch-'0')
+	}
+	return result
+}

logic/controller/login_main.go

@@ -2,14 +2,12 @@ package controller
 
 import (
 	"blazing/common/data/share"
-	"blazing/cool"
+	"blazing/common/rpc"
-
 	"blazing/common/socket/errorcode"
-
+	"blazing/cool"
-	"blazing/logic/service/user"
-
 	"blazing/logic/service/player"
 	"blazing/logic/service/space"
+	"blazing/logic/service/user"
 	"blazing/modules/player/service"
 	"context"
 	"time"
@@ -17,6 +15,35 @@ import (
 	"github.com/panjf2000/gnet/v2"
 )
 
+const (
+	waitUserOfflineTimeout  = 30 * time.Second
+	waitUserOfflineInterval = 200 * time.Millisecond
+	waitUserOfflineKickGap  = 5 * time.Second
+)
+
+func waitUserOffline(userID uint32, timeout time.Duration) bool {
+	deadline := time.Now().Add(timeout)
+	lastKickAt := time.Now()
+	for {
+		if _, onlineErr := share.ShareManager.GetUserOnline(userID); onlineErr != nil {
+			return true
+		}
+		if time.Now().After(deadline) {
+			return false
+		}
+		if time.Since(lastKickAt) >= waitUserOfflineKickGap {
+			ctx, cancel := context.WithTimeout(context.Background(), rpc.ClientCallTimeout)
+			kickErr := Maincontroller.RPCClient.Kick(ctx, userID)
+			cancel()
+			if kickErr != nil {
+				cool.Logger.Error(context.Background(), "补踢失败", userID, kickErr)
+			}
+			lastKickAt = time.Now()
+		}
+		time.Sleep(waitUserOfflineInterval)
+	}
+}
+
 // Login 处理命令: 1001
 func (h Controller) Login(data *MAIN_LOGIN_IN, c gnet.Conn) (result *user.LoginMSInfo, err errorcode.ErrorCode) { //这个时候player应该是空的
 
@@ -30,12 +57,20 @@ func (h Controller) Login(data *MAIN_LOGIN_IN, c gnet.Conn) (result *user.LoginM
 		defer c.Close()
 		return
 	}
-	_, erre := share.ShareManager.GetUserOnline(data.Head.UserID)
-	if erre == nil {
-		error := Maincontroller.RPCClient.Kick(data.Head.UserID) //通知其他服务器踢人
-		if error != nil {
-			cool.Logger.Error(context.Background(), "踢人失败", err)
 
+	if onlineServerID, onlineErr := share.ShareManager.GetUserOnline(data.Head.UserID); onlineErr == nil {
+		ctx, cancel := context.WithTimeout(context.Background(), rpc.ClientCallTimeout)
+		kickErr := Maincontroller.RPCClient.Kick(ctx, data.Head.UserID) //通知其他服务器踢人
+		cancel()
+		if kickErr != nil {
+			cool.Logger.Error(context.Background(), "踢人失败", data.Head.UserID, onlineServerID, kickErr)
+			err = errorcode.ErrorCodes.ErrSystemBusyTryLater
+			defer c.Close()
+			return
+		}
+		if ok := waitUserOffline(data.Head.UserID, waitUserOfflineTimeout); !ok {
+			cool.Logger.Error(context.Background(), "等待旧会话下线超时", data.Head.UserID, onlineServerID, waitUserOfflineTimeout)
+			err = errorcode.ErrorCodes.ErrSystemBusyTryLater
 			defer c.Close()
 			return
 		}

logic/controller/nono.go

@@ -64,6 +64,7 @@ func (h *Controller) SwitchFlying(data *SwitchFlyingInboundInfo, c *player.Playe
 // PlayerPetCure 处理控制器请求。
 func (h *Controller) PlayerPetCure(data *PetCureInboundInfo, c *player.Player) (result *nono.PetCureOutboundEmpty, err errorcode.ErrorCode) { //这个时候player应该是空的
 	_ = data
+	result = &nono.PetCureOutboundEmpty{}
 	if c.IsArenaHealLocked() {
 		return result, errorcode.ErrorCodes.ErrChampionCannotHeal
 	}
@@ -73,6 +74,9 @@ func (h *Controller) PlayerPetCure(data *PetCureInboundInfo, c *player.Player) (
 	for i := range c.Info.PetList {
 		c.Info.PetList[i].Cure()
 	}
+	for i := range c.Info.BackupPetList {
+		c.Info.BackupPetList[i].Cure()
+	}
 	c.Info.Coins -= nonoPetCureCost
 	return
 }

logic/controller/pet_bag.go

@@ -19,20 +19,13 @@ func (h Controller) SavePetBagOrder(
 	return nil, 0
 }
 
-// PetRetrieveFromWarehouse 领回仓库精灵
+// PetRetrieveFromWarehouse 从放生仓库领回精灵
 func (h Controller) PetRetrieveFromWarehouse(
 	data *PET_RETRIEVE, player *player.Player) (result *fight.NullOutboundInfo, err errorcode.ErrorCode) {
-	if _, ok := player.FindPetBagSlot(data.CatchTime); ok {
+	if !player.Service.Pet.UpdateFree(data.CatchTime, 1, 0) {
-		return nil, 0
+		return nil, errorcode.ErrorCodes.ErrPokemonIDMismatch
 	}
 
-	petInfo := player.Service.Pet.PetInfoOneByCatchTime(data.CatchTime)
-	if petInfo == nil {
-		return nil, 0
-	}
-
-	player.AddPetToAvailableBag(petInfo.Data)
-
 	return nil, 0
 }
 

logic/controller/pet_barge.go

@@ -18,8 +18,8 @@ func (h Controller) GetPetBargeList(data *PetBargeListInboundInfo, player *playe
 		ret.PetBargeList = append(ret.PetBargeList, pet.PetBargeListInfo{
 			PetId:     uint32(v.Args[0]),
 			EnCntCnt:  1,
-			IsCatched: uint32(v.Results[0]),
+			IsCatched: uint32(v.Results[1]),
-			IsKilled:  uint32(v.Results[1]),
+			IsKilled:  uint32(v.Results[0]),
 		})
 	}
 

logic/controller/pet_elo.go

@@ -37,7 +37,9 @@ func (h Controller) PetELV(data *C2S_PET_EVOLVTION, c *player.Player) (result *f
 		return nil, errorcode.ErrorCodes.ErrInsufficientItemsMulti
 	}
 	if branch.EvolvItem != 0 {
-		c.Service.Item.UPDATE(uint32(branch.EvolvItem), -branch.EvolvItemCount)
+		if err := c.Service.Item.UPDATE(uint32(branch.EvolvItem), -branch.EvolvItemCount); err != nil {
+			return nil, errorcode.ErrorCodes.ErrInsufficientItemsMulti
+		}
 	}
 
 	currentPet.ID = uint32(branch.MonTo)

logic/controller/pet_ev.go

@@ -17,11 +17,16 @@ const (
 // c: 当前玩家对象
 // 返回: 分配结果和错误码
 func (h Controller) PetEVDiy(data *PetEV, c *player.Player) (result *fight.NullOutboundInfo, err errorcode.ErrorCode) {
-	_, currentPet, found := c.FindPet(data.CacthTime)
+	slot, found := c.FindPetBagSlot(data.CacthTime)
 	if !found {
 		return nil, errorcode.ErrorCodes.Err10401
 	}
 
+	currentPet := slot.PetInfoPtr()
+	if currentPet == nil {
+		return nil, errorcode.ErrorCodes.Err10401
+	}
+
 	var targetTotal uint32
 	var currentTotal uint32
 	for i, evValue := range data.EVs {

logic/controller/pet_ev_test.go

@@ -0,0 +1,45 @@
+package controller
+
+import (
+	"testing"
+
+	"blazing/logic/service/player"
+	playermodel "blazing/modules/player/model"
+)
+
+func TestPetEVDiy_AppliesToBackupPet(t *testing.T) {
+	p := player.NewPlayer(nil)
+	p.Info = &playermodel.PlayerInfo{
+		EVPool: 20,
+		PetList: []playermodel.PetInfo{
+			{CatchTime: 1},
+		},
+		BackupPetList: []playermodel.PetInfo{
+			{
+				CatchTime: 2,
+				Level:     100,
+				Ev:        [6]uint32{0, 4, 0, 0, 0, 0},
+			},
+		},
+	}
+
+	data := &PetEV{
+		CacthTime: 2,
+		EVs:       [6]uint32{0, 8, 4, 0, 0, 0},
+	}
+
+	_, err := (Controller{}).PetEVDiy(data, p)
+	if err != 0 {
+		t.Fatalf("PetEVDiy returned error: %v", err)
+	}
+
+	got := p.Info.BackupPetList[0].Ev
+	want := [6]uint32{0, 8, 4, 0, 0, 0}
+	if got != want {
+		t.Fatalf("backup pet EV mismatch, got %v want %v", got, want)
+	}
+
+	if gotPool, wantPool := p.Info.EVPool, int64(12); gotPool != wantPool {
+		t.Fatalf("EVPool mismatch, got %d want %d", gotPool, wantPool)
+	}
+}

logic/controller/pet_fusion.go

@@ -65,16 +65,33 @@ func (h Controller) PetFusion(data *C2S_PetFusion, c *player.Player) (result *pe
 		return result, errorcode.ErrorCodes.ErrSunDouInsufficient10016
 	}
 
-	consumeItems(c, materialCounts)
-	c.Info.Coins -= petFusionCost
-
 	if resultPetID == 0 {
-		if useOptionalItem(c, data.GoldItem1[:], petFusionFailureItemID) {
+		failedAux := *auxPet
-			result.CostItemFlag = 1
+		if auxPet.Level > 5 {
-		} else if auxPet.Level > 5 {
+			failedAux.Downgrade(auxPet.Level - 5)
-			auxPet.Downgrade(auxPet.Level - 5)
 		} else {
-			auxPet.Downgrade(1)
+			failedAux.Downgrade(1)
+		}
+		txResult, errCode := c.Service.PetFusionTx(
+			*c.Info,
+			data.Mcatchtime,
+			data.Auxcatchtime,
+			materialCounts,
+			data.GoldItem1[:],
+			petFusionKeepAuxItemID,
+			petFusionFailureItemID,
+			petFusionCost,
+			nil,
+			&failedAux,
+		)
+		if errCode != 0 {
+			return result, errCode
+		}
+		c.Info.Coins -= petFusionCost
+		if txResult.CostItemUsed {
+			result.CostItemFlag = 1
+		} else if txResult.UpdatedAux != nil {
+			*auxPet = *txResult.UpdatedAux
 		}
 		return &pet.PetFusionInfo{}, 0
 	}
@@ -101,18 +118,37 @@ func (h Controller) PetFusion(data *C2S_PetFusion, c *player.Player) (result *pe
 		newPet.RandomByWeightShiny()
 	}
 
-	c.Service.Pet.PetAdd(newPet, 0)
+	txResult, errCode := c.Service.PetFusionTx(
-	//println(c.Info.UserID, "进行融合", len(c.Info.PetList), masterPet.ID, auxPet.ID, newPet.ID)
+		*c.Info,
-
+		data.Mcatchtime,
-	c.PetDel(data.Mcatchtime)
+		data.Auxcatchtime,
-	if useOptionalItem(c, data.GoldItem1[:], petFusionKeepAuxItemID) {
+		materialCounts,
-		result.CostItemFlag = 1
+		data.GoldItem1[:],
-	} else {
+		petFusionKeepAuxItemID,
-		c.PetDel(data.Auxcatchtime)
+		petFusionFailureItemID,
+		petFusionCost,
+		newPet,
+		nil,
+	)
+	if errCode != 0 {
+		return result, errCode
 	}
 
-	result.ObtainTime = newPet.CatchTime
+	c.Info.Coins -= petFusionCost
-	result.StarterCpTm = newPet.ID
+	if txResult.CostItemUsed {
+		result.CostItemFlag = 1
+	} else {
+		removePetFromPlayerInfo(c, data.Auxcatchtime)
+	}
+	removePetFromPlayerInfo(c, data.Mcatchtime)
+
+	if txResult.NewPet == nil {
+		return result, errorcode.ErrorCodes.ErrSystemError
+	}
+	c.Info.PetList = append(c.Info.PetList, *txResult.NewPet)
+
+	result.ObtainTime = txResult.NewPet.CatchTime
+	result.StarterCpTm = txResult.NewPet.ID
 	return result, 0
 }
 
@@ -149,21 +185,10 @@ func hasEnoughItems(c *player.Player, itemCounts map[uint32]int) bool {
 	return true
 }
 
-func consumeItems(c *player.Player, itemCounts map[uint32]int) {
+func removePetFromPlayerInfo(c *player.Player, catchTime uint32) {
-	for itemID, count := range itemCounts {
+	index, _, ok := c.FindPet(catchTime)
-		_ = c.Service.Item.UPDATE(itemID, -count)
+	if !ok {
+		return
 	}
-}
+	c.Info.PetList = append(c.Info.PetList[:index], c.Info.PetList[index+1:]...)
-
-func useOptionalItem(c *player.Player, itemIDs []uint32, target uint32) bool {
-	if c.Service.Item.CheakItem(target) <= 0 {
-		return false
-	}
-	for _, itemID := range itemIDs {
-		if itemID == target {
-			_ = c.Service.Item.UPDATE(target, -1)
-			return true
-		}
-	}
-	return false
 }

logic/controller/pet_info.go

@@ -4,19 +4,22 @@ import (
 	"blazing/common/socket/errorcode"
 	"blazing/logic/service/common"
 	"blazing/logic/service/pet"
-	"blazing/logic/service/player"
+	playersvc "blazing/logic/service/player"
 	"blazing/modules/player/model"
 )
 
 // GetPetInfo 获取精灵信息
 func (h Controller) GetPetInfo(
 	data *GetPetInfoInboundInfo,
-	player *player.Player) (result *model.PetInfo,
+	player *playersvc.Player) (result *model.PetInfo,
 	err errorcode.ErrorCode) {
-	_, petInfo, found := player.FindPet(data.CatchTime)
+	levelLimit := player.CurrentMapPetLevelLimit()
-	if found {
+	if slot, found := player.FindPetBagSlot(data.CatchTime); found {
-		result = petInfo
+		if petInfo := slot.PetInfoPtr(); petInfo != nil {
-		return result, 0
+			petCopy := playersvc.ApplyPetLevelLimit(*petInfo, levelLimit)
+			result = &petCopy
+			return result, 0
+		}
 	}
 
 	ret := player.Service.Pet.PetInfoOneByCatchTime(data.CatchTime)
@@ -24,16 +27,18 @@ func (h Controller) GetPetInfo(
 		return nil, errorcode.ErrorCodes.ErrPokemonNotExists
 	}
 
-	result = &ret.Data
+	petData := ret.Data
+	petData = playersvc.ApplyPetLevelLimit(petData, levelLimit)
+	result = &petData
 	return result, 0
 }
 
 // GetUserBagPetInfo 获取主背包和并列备用精灵列表
 func (h Controller) GetUserBagPetInfo(
 	data *GetUserBagPetInfoInboundEmpty,
-	player *player.Player) (result *pet.GetUserBagPetInfoOutboundInfo,
+	player *playersvc.Player) (result *pet.GetUserBagPetInfoOutboundInfo,
 	err errorcode.ErrorCode) {
-	return player.GetUserBagPetInfo(), 0
+	return player.GetUserBagPetInfo(player.CurrentMapPetLevelLimit()), 0
 }
 
 // GetPetListInboundEmpty 定义请求或响应数据结构。
@@ -44,7 +49,7 @@ type GetPetListInboundEmpty struct {
 // GetPetList 获取当前主背包列表
 func (h Controller) GetPetList(
 	data *GetPetListInboundEmpty,
-	player *player.Player) (result *pet.GetPetListOutboundInfo,
+	player *playersvc.Player) (result *pet.GetPetListOutboundInfo,
 	err errorcode.ErrorCode) {
 	return buildPetListOutboundInfo(player.Info.PetList), 0
 }
@@ -57,7 +62,7 @@ type GetPetListFreeInboundEmpty struct {
 // GetPetReleaseList 获取仓库可放生列表
 func (h Controller) GetPetReleaseList(
 	data *GetPetListFreeInboundEmpty,
-	player *player.Player) (result *pet.GetPetListOutboundInfo,
+	player *playersvc.Player) (result *pet.GetPetListOutboundInfo,
 	err errorcode.ErrorCode) {
 
 	return buildPetListOutboundInfo(player.WarehousePetList()), 0
@@ -66,14 +71,13 @@ func (h Controller) GetPetReleaseList(
 // PlayerShowPet 精灵展示
 func (h Controller) PlayerShowPet(
 	data *PetShowInboundInfo,
-	player *player.Player) (result *pet.PetShowOutboundInfo, err errorcode.ErrorCode) {
+	player *playersvc.Player) (result *pet.PetShowOutboundInfo, err errorcode.ErrorCode) {
 	result = &pet.PetShowOutboundInfo{
 		UserID:    data.Head.UserID,
 		CatchTime: data.CatchTime,
 		Flag:      data.Flag,
 	}
 
-	_, currentPet, ok := player.FindPet(data.CatchTime)
 	if data.Flag == 0 {
 		player.SetPetDisplay(0, nil)
 		player.GetSpace().RefreshUserInfo(player)
@@ -81,7 +85,14 @@ func (h Controller) PlayerShowPet(
 		return
 	}
 
-	if !ok {
+	// 仅允许背包精灵跟随：仓库中的精灵不允许跟随
+	slot, found := player.FindPetBagSlot(data.CatchTime)
+	if !found {
+		return nil, errorcode.ErrorCodes.ErrCannotShowBagPokemon
+	}
+
+	currentPet := slot.PetInfoPtr()
+	if currentPet == nil {
 		return nil, errorcode.ErrorCodes.ErrPokemonNotExists
 	}
 

logic/controller/pet_manage.go

@@ -6,8 +6,39 @@ import (
 	"blazing/logic/service/fight"
 	"blazing/logic/service/pet"
 	"blazing/logic/service/player"
+	playermodel "blazing/modules/player/model"
 )
 
+func petSetExpLimit(currentPet *playermodel.PetInfo) int64 {
+	if currentPet == nil || currentPet.Level >= 100 {
+		return 0
+	}
+
+	simulatedPet := *currentPet
+	allowedExp := simulatedPet.NextLvExp - simulatedPet.Exp
+	if allowedExp < 0 {
+		allowedExp = 0
+	}
+
+	for simulatedPet.Level < 100 && simulatedPet.NextLvExp > 0 {
+		simulatedPet.Level++
+		simulatedPet.Update(true)
+		if simulatedPet.Level >= 100 {
+			break
+		}
+		allowedExp += simulatedPet.NextLvExp
+	}
+
+	return allowedExp
+}
+
+func minInt64(a, b int64) int64 {
+	if a < b {
+		return a
+	}
+	return b
+}
+
 // PetReleaseToWarehouse 将精灵从仓库包中放生
 func (h Controller) PetReleaseToWarehouse(
 	data *PET_ROWEI, player *player.Player) (result *fight.NullOutboundInfo, err errorcode.ErrorCode) {
@@ -17,9 +48,8 @@ func (h Controller) PetReleaseToWarehouse(
 	if inBag || inBackup || freeForbidden == 1 {
 		return nil, errorcode.ErrorCodes.ErrCannotReleaseNonWarehouse
 	}
-
+	if !player.Service.Pet.UpdateFree(data.CatchTime, 0, 1) {
-	if !player.Service.Pet.UpdateFree(data.CatchTime, 1) {
+		return nil, errorcode.ErrorCodes.ErrCannotReleaseNonWarehouse
-		return nil, errorcode.ErrorCodes.ErrSystemError
 	}
 
 	return nil, 0
@@ -32,9 +62,11 @@ func (h Controller) PetOneCure(
 		return result, errorcode.ErrorCodes.ErrChampionCannotHeal
 	}
 
-	_, currentPet, ok := player.FindPet(data.CatchTime)
+	if slot, ok := player.FindPetBagSlot(data.CatchTime); ok {
-	if ok {
+		currentPet := slot.PetInfoPtr()
-		defer currentPet.Cure()
+		if currentPet != nil {
+			defer currentPet.Cure()
+		}
 	}
 
 	return &pet.PetOneCureOutboundInfo{
@@ -63,11 +95,17 @@ func (h Controller) PetFirst(
 func (h Controller) SetPetExp(
 	data *PetSetExpInboundInfo,
 	player *player.Player) (result *pet.PetSetExpOutboundInfo, err errorcode.ErrorCode) {
-	_, currentPet, found := player.FindPet(data.CatchTime)
+	slot, found := player.FindPetBagSlot(data.CatchTime)
-	if !found || currentPet.Level >= 100 {
+	currentPet := slot.PetInfoPtr()
+	if !found || currentPet == nil || currentPet.Level >= 100 {
 		return &pet.PetSetExpOutboundInfo{Exp: player.Info.ExpPool}, errorcode.ErrorCodes.ErrSystemError
 	}
 
-	player.AddPetExp(currentPet, data.Exp)
+	allowedExp := petSetExpLimit(currentPet)
+	if allowedExp <= 0 {
+		return &pet.PetSetExpOutboundInfo{Exp: player.Info.ExpPool}, errorcode.ErrorCodes.ErrSystemError
+	}
+
+	player.AddPetExp(currentPet, minInt64(data.Exp, allowedExp))
 	return &pet.PetSetExpOutboundInfo{Exp: player.Info.ExpPool}, 0
 }

logic/controller/pet_manage_test.go

@@ -0,0 +1,75 @@
+package controller
+
+import (
+	"blazing/common/data/xmlres"
+	"blazing/common/socket/errorcode"
+	"blazing/logic/service/player"
+	playermodel "blazing/modules/player/model"
+	"testing"
+)
+
+func firstPetIDForControllerTest(t *testing.T) int {
+	t.Helper()
+
+	for id := range xmlres.PetMAP {
+		return id
+	}
+
+	t.Fatal("xmlres.PetMAP is empty")
+	return 0
+}
+
+func TestSetPetExpCapsLevelAt100(t *testing.T) {
+	petID := firstPetIDForControllerTest(t)
+	petInfo := playermodel.GenPetInfo(petID, 31, 0, 0, 99, nil, 0)
+	if petInfo == nil {
+		t.Fatal("failed to generate test pet")
+	}
+
+	expPool := petInfo.NextLvExp + 10_000
+	testPlayer := player.NewPlayer(nil)
+	testPlayer.Info = &playermodel.PlayerInfo{
+		ExpPool: expPool,
+		PetList: []playermodel.PetInfo{*petInfo},
+	}
+
+	currentPet := &testPlayer.Info.PetList[0]
+	result, err := (Controller{}).SetPetExp(&PetSetExpInboundInfo{
+		CatchTime: currentPet.CatchTime,
+		Exp:       expPool,
+	}, testPlayer)
+	if err != 0 {
+		t.Fatalf("expected SetPetExp to succeed, got err=%d", err)
+	}
+	if currentPet.Level != 100 {
+		t.Fatalf("expected pet level to stop at 100, got %d", currentPet.Level)
+	}
+	if result.Exp != 10_000 {
+		t.Fatalf("expected overflow exp to remain in pool, got %d", result.Exp)
+	}
+}
+
+func TestSetPetExpRejectsPetAtLevel100(t *testing.T) {
+	petID := firstPetIDForControllerTest(t)
+	petInfo := playermodel.GenPetInfo(petID, 31, 0, 0, 100, nil, 0)
+	if petInfo == nil {
+		t.Fatal("failed to generate test pet")
+	}
+
+	testPlayer := player.NewPlayer(nil)
+	testPlayer.Info = &playermodel.PlayerInfo{
+		ExpPool: 50_000,
+		PetList: []playermodel.PetInfo{*petInfo},
+	}
+
+	result, err := (Controller{}).SetPetExp(&PetSetExpInboundInfo{
+		CatchTime: petInfo.CatchTime,
+		Exp:       12_345,
+	}, testPlayer)
+	if err != errorcode.ErrorCodes.ErrSystemError {
+		t.Fatalf("expected level-100 pet to be rejected, got err=%d", err)
+	}
+	if result.Exp != 50_000 {
+		t.Fatalf("expected exp pool to remain unchanged, got %d", result.Exp)
+	}
+}

logic/controller/pet_skill.go

@@ -8,47 +8,136 @@ import (
 	"blazing/logic/service/pet"
 	"blazing/logic/service/player"
 	"blazing/modules/player/model"
-
-	"github.com/samber/lo"
 )
 
+type GetPetLearnableSkillsOutboundInfo struct {
+	SkillListLen uint32   `struc:"sizeof=SkillList"`
+	SkillList    []uint32 `json:"skillList"`
+}
+
+func isSameUint32Slice(a []uint32, b []uint32) bool {
+	if len(a) != len(b) {
+		return false
+	}
+	for index := range a {
+		if a[index] != b[index] {
+			return false
+		}
+	}
+	return true
+}
+
+func collectPetLearnableSkillList(currentPet *model.PetInfo) []uint32 {
+	skillSet := make(map[uint32]struct{})
+	skills := make([]uint32, 0)
+
+	appendSkill := func(skillID uint32) {
+		if skillID == 0 {
+			return
+		}
+		if _, exists := skillSet[skillID]; exists {
+			return
+		}
+		skillSet[skillID] = struct{}{}
+		skills = append(skills, skillID)
+	}
+
+	for _, skillID := range currentPet.GetLevelRangeCanLearningSkills(1, currentPet.Level) {
+		appendSkill(skillID)
+	}
+	for _, skillID := range currentPet.ExtSKill {
+		appendSkill(skillID)
+	}
+
+	for _, skill := range currentPet.SkillList {
+		delete(skillSet, skill.ID)
+	}
+
+	result := make([]uint32, 0, len(skillSet))
+	for _, skillID := range skills {
+		if _, exists := skillSet[skillID]; exists {
+			result = append(result, skillID)
+		}
+	}
+	return result
+}
+
+// GetPetLearnableSkills 查询当前精灵可学习技能（等级技能 + 额外技能ExtSKill）
+func (h Controller) GetPetLearnableSkills(
+	data *GetPetLearnableSkillsInboundInfo,
+	c *player.Player,
+) (result *GetPetLearnableSkillsOutboundInfo, err errorcode.ErrorCode) {
+	slot, ok := c.FindPetBagSlot(data.CatchTime)
+	currentPet := slot.PetInfoPtr()
+	if !ok || currentPet == nil {
+		return nil, errorcode.ErrorCodes.ErrPokemonNotExists
+	}
+
+	return &GetPetLearnableSkillsOutboundInfo{
+		SkillList: collectPetLearnableSkillList(currentPet),
+	}, 0
+}
+
 // SetPetSkill 设置宠物技能，消耗50赛尔豆
 func (h Controller) SetPetSkill(data *ChangeSkillInfo, c *player.Player) (result *pet.ChangeSkillOutInfo, err errorcode.ErrorCode) {
 	const setSkillCost = 50
 
-	if !c.GetCoins(setSkillCost) {
+	slot, ok := c.FindPetBagSlot(data.CatchTime)
-		return nil, errorcode.ErrorCodes.ErrSunDouInsufficient10016
+	currentPet := slot.PetInfoPtr()
-	}
+	if !ok || currentPet == nil {
-
-	c.Info.Coins -= setSkillCost
-
-	_, currentPet, ok := c.FindPet(data.CatchTime)
-	if !ok {
 		return nil, errorcode.ErrorCodes.ErrSystemBusy
 	}
-	canleaernskill := currentPet.GetLevelRangeCanLearningSkills(1, currentPet.Level)
 
-	_, ok = lo.Find(canleaernskill, func(item uint32) bool {
+	canLearnSkillSet := make(map[uint32]struct{})
-		return item == data.ReplaceSkill
+	for _, skillID := range collectPetLearnableSkillList(currentPet) {
-	})
+		canLearnSkillSet[skillID] = struct{}{}
-
-	if !ok {
-		return result, errorcode.ErrorCodes.ErrSystemBusy
 	}
-	_, _, ok = utils.FindWithIndex(currentPet.SkillList, func(item model.SkillInfo) bool { //已经存在技能
+	if _, exists := canLearnSkillSet[data.ReplaceSkill]; !exists {
+		return nil, errorcode.ErrorCodes.ErrSystemBusy
+	}
+
+	skillInfo, exists := xmlres.SkillMap[int(data.ReplaceSkill)]
+	if !exists {
+		return nil, errorcode.ErrorCodes.ErrSystemBusy
+	}
+
+	_, _, ok = utils.FindWithIndex(currentPet.SkillList, func(item model.SkillInfo) bool {
 		return item.ID == data.ReplaceSkill
 	})
 	if ok {
 		return nil, errorcode.ErrorCodes.ErrSystemBusy
 	}
 
-	// 查找要学习的技能并替换
+	if data.HasSkill == 0 && len(currentPet.SkillList) >= 4 {
-	_, targetSkill, ok := utils.FindWithIndex(currentPet.SkillList, func(item model.SkillInfo) bool {
+		return nil, errorcode.ErrorCodes.ErrSystemBusy
-		return item.ID == data.HasSkill
+	}
-	})
+
-	if ok {
+	if data.HasSkill != 0 {
+		_, _, found := utils.FindWithIndex(currentPet.SkillList, func(item model.SkillInfo) bool {
+			return item.ID == data.HasSkill
+		})
+		if !found {
+			return nil, errorcode.ErrorCodes.ErrSystemBusy
+		}
+	}
+
+	if !c.GetCoins(setSkillCost) {
+		return nil, errorcode.ErrorCodes.ErrSunDouInsufficient10016
+	}
+
+	c.Info.Coins -= setSkillCost
+	maxPP := uint32(skillInfo.MaxPP)
+	if data.HasSkill != 0 {
+		_, targetSkill, _ := utils.FindWithIndex(currentPet.SkillList, func(item model.SkillInfo) bool {
+			return item.ID == data.HasSkill
+		})
 		targetSkill.ID = data.ReplaceSkill
-		targetSkill.PP = uint32(xmlres.SkillMap[int(targetSkill.ID)].MaxPP)
+		targetSkill.PP = maxPP
+	} else {
+		currentPet.SkillList = append(currentPet.SkillList, model.SkillInfo{
+			ID: data.ReplaceSkill,
+			PP: maxPP,
+		})
 	}
 
 	return &pet.ChangeSkillOutInfo{
@@ -60,25 +149,139 @@ func (h Controller) SetPetSkill(data *ChangeSkillInfo, c *player.Player) (result
 func (h Controller) SortPetSkills(data *C2S_Skill_Sort, c *player.Player) (result *fight.NullOutboundInfo, err errorcode.ErrorCode) {
 	const skillSortCost = 50
 
+	slot, ok := c.FindPetBagSlot(data.CapTm)
+	currentPet := slot.PetInfoPtr()
+	if !ok || currentPet == nil {
+		return nil, errorcode.ErrorCodes.ErrPokemonNotExists
+	}
+
+	usedSkillSet := make(map[uint32]struct{})
+	newSkillList := make([]model.SkillInfo, 0, 4)
+
+	for _, skillID := range data.Skill {
+		if skillID == 0 {
+			continue
+		}
+		if _, used := usedSkillSet[skillID]; used {
+			continue
+		}
+		_, skill, found := utils.FindWithIndex(currentPet.SkillList, func(item model.SkillInfo) bool {
+			return item.ID == skillID
+		})
+		if !found {
+			continue
+		}
+		newSkillList = append(newSkillList, *skill)
+		usedSkillSet[skillID] = struct{}{}
+	}
+
+	for _, skill := range currentPet.SkillList {
+		if skill.ID == 0 {
+			continue
+		}
+		if _, used := usedSkillSet[skill.ID]; used {
+			continue
+		}
+		newSkillList = append(newSkillList, skill)
+		usedSkillSet[skill.ID] = struct{}{}
+	}
+
+	if len(newSkillList) > 4 {
+		newSkillList = newSkillList[:4]
+	}
+
 	if !c.GetCoins(skillSortCost) {
 		return nil, errorcode.ErrorCodes.ErrSunDouInsufficient10016
 	}
 
 	c.Info.Coins -= skillSortCost
-
+	currentPet.SkillList = newSkillList
-	_, currentPet, ok := c.FindPet(data.CapTm)
+
-	if ok {
+	return nil, 0
-		var newSkillList []model.SkillInfo
+}
-		for _, skillID := range data.Skill {
+
-			_, skill, found := utils.FindWithIndex(currentPet.SkillList, func(item model.SkillInfo) bool {
+// CommitPetSkills 按最终技能列表一次性提交学习/替换/排序结果。
-				return item.ID == skillID
+func (h Controller) CommitPetSkills(
-			})
+	data *CommitPetSkillsInboundInfo,
-			if found {
+	c *player.Player,
-				newSkillList = append(newSkillList, *skill)
+) (result *fight.NullOutboundInfo, err errorcode.ErrorCode) {
-			}
+	const setSkillCost = 50
-		}
+	const skillSortCost = 50
-		currentPet.SkillList = newSkillList
+
-	}
+	slot, ok := c.FindPetBagSlot(data.CatchTime)
+	currentPet := slot.PetInfoPtr()
+	if !ok || currentPet == nil {
+		return nil, errorcode.ErrorCodes.ErrPokemonNotExists
+	}
+
+	currentSkillSet := make(map[uint32]model.SkillInfo, len(currentPet.SkillList))
+	currentSkillOrder := make([]uint32, 0, len(currentPet.SkillList))
+	for _, skill := range currentPet.SkillList {
+		if skill.ID == 0 {
+			continue
+		}
+		currentSkillSet[skill.ID] = skill
+		currentSkillOrder = append(currentSkillOrder, skill.ID)
+	}
+
+	finalSkillIDs := make([]uint32, 0, 4)
+	usedSkillSet := make(map[uint32]struct{}, 4)
+	for _, skillID := range data.Skill {
+		if skillID == 0 {
+			continue
+		}
+		if _, exists := usedSkillSet[skillID]; exists {
+			continue
+		}
+		usedSkillSet[skillID] = struct{}{}
+		finalSkillIDs = append(finalSkillIDs, skillID)
+	}
+
+	if len(finalSkillIDs) == 0 {
+		return nil, errorcode.ErrorCodes.ErrSystemBusy
+	}
+	if len(finalSkillIDs) > 4 {
+		finalSkillIDs = finalSkillIDs[:4]
+	}
+	if isSameUint32Slice(currentSkillOrder, finalSkillIDs) {
+		return nil, 0
+	}
+
+	learnableSkillSet := make(map[uint32]struct{})
+	for _, skillID := range collectPetLearnableSkillList(currentPet) {
+		learnableSkillSet[skillID] = struct{}{}
+	}
+
+	newSkillCount := 0
+	finalSkillList := make([]model.SkillInfo, 0, len(finalSkillIDs))
+	for _, skillID := range finalSkillIDs {
+		if skill, exists := currentSkillSet[skillID]; exists {
+			finalSkillList = append(finalSkillList, skill)
+			continue
+		}
+		if _, exists := learnableSkillSet[skillID]; !exists {
+			return nil, errorcode.ErrorCodes.ErrSystemBusy
+		}
+		skillInfo, exists := xmlres.SkillMap[int(skillID)]
+		if !exists {
+			return nil, errorcode.ErrorCodes.ErrSystemBusy
+		}
+		newSkillCount++
+		finalSkillList = append(finalSkillList, model.SkillInfo{
+			ID: skillID,
+			PP: uint32(skillInfo.MaxPP),
+		})
+	}
+
+	totalCost := int64(newSkillCount * setSkillCost)
+	if newSkillCount == 0 {
+		totalCost += int64(skillSortCost)
+	}
+	if totalCost > 0 && !c.GetCoins(totalCost) {
+		return nil, errorcode.ErrorCodes.ErrSunDouInsufficient10016
+	}
+	c.Info.Coins -= totalCost
+	currentPet.SkillList = finalSkillList
 
 	return nil, 0
 }

logic/controller/pet_收集计划.go

@@ -17,15 +17,13 @@ func (h Controller) IsCollect(
 		ID: data.Type,
 	}
 
-	c.Service.Task.Exec(uint32(1335), func(te *model.Task) bool {
+	taskData, taskErr := c.Service.Task.GetTask(uint32(1335))
-
+	if taskErr == nil {
-		r := bitset32.From(te.Data)
+		r := bitset32.From(taskData.Data)
-		// 分支未完成时，标记完成并发放奖励
 		if r.Test(uint(data.Type)) {
 			result.IsCom = 1
 		}
-		return false
+	}
-	})
 
 	_, ok := lo.Find([]uint32{1, 2, 3, 4, 301}, func(item uint32) bool {
 		return data.Type == item
@@ -59,14 +57,17 @@ func (h Controller) Collect(
 		return data.Type == item
 	})
 	if res == model.Completed && ok { //这块是为了兼容旧版本
-		c.Service.Task.Exec(uint32(1335), func(te *model.Task) bool {
+		taskData, taskErr := c.Service.Task.GetTask(uint32(1335))
+		if taskErr != nil {
+			return nil, errorcode.ErrorCode(errorcode.ErrorCodes.ErrSystemError)
+		}
 
-			r := bitset32.From(te.Data)
+		r := bitset32.From(taskData.Data)
-
+		r.Set(uint(data.Type))
-			r.Set(uint(data.Type))
+		taskData.Data = r.Bytes()
-			te.Data = r.Bytes()
+		if taskErr = c.Service.Task.SetTask(taskData); taskErr != nil {
-			return true
+			return nil, errorcode.ErrorCode(errorcode.ErrorCodes.ErrSystemError)
-		})
+		}
 		return nil, errorcode.ErrorCode(errorcode.ErrorCodes.ErrSystemError)
 	}
 
@@ -80,21 +81,22 @@ func (h Controller) Collect(
 	if !lo.Contains(validIDs, data.ID) {
 		return nil, errorcode.ErrorCode(errorcode.ErrorCodes.ErrSystemError)
 	}
-	c.Service.Task.Exec(uint32(1335), func(te *model.Task) bool {
+	taskData, taskErr := c.Service.Task.GetTask(uint32(1335))
+	if taskErr != nil {
+		return nil, errorcode.ErrorCode(errorcode.ErrorCodes.ErrSystemError)
+	}
 
-		r := bitset32.From(te.Data)
+	r := bitset32.From(taskData.Data)
-		// 分支未完成时，标记完成并发放奖励
+	if !r.Test(uint(data.Type)) {
-		if !r.Test(uint(data.Type)) {
+		r.Set(uint(data.Type))
-			r.Set(uint(data.Type))
+		taskData.Data = r.Bytes()
-			te.Data = r.Bytes()
+		if taskErr = c.Service.Task.SetTask(taskData); taskErr != nil {
-			r := model.GenPetInfo(int(data.ID), -1, -1, 0, 1, nil, 0)
+			return nil, errorcode.ErrorCode(errorcode.ErrorCodes.ErrSystemError)
-			c.Service.Pet.PetAdd(r, 0)
-			result.CatchTime = r.CatchTime
-
-			return true
 		}
-		return false
+		petInfo := model.GenPetInfo(int(data.ID), -1, -1, 0, 1, nil, 0)
-	})
+		c.Service.Pet.PetAdd(petInfo, 0)
+		result.CatchTime = petInfo.CatchTime
+	}
 
 	if result.CatchTime == 0 {
 		return nil, errorcode.ErrorCode(errorcode.ErrorCodes.ErrAwardAlreadyClaimed)

logic/controller/room_info.go

@@ -3,6 +3,7 @@ package controller
 import (
 	"blazing/common/socket/errorcode"
 	"blazing/modules/player/model"
+	"blazing/modules/player/service"
 
 	"blazing/logic/service/pet"
 	"blazing/logic/service/player"
@@ -32,17 +33,45 @@ func (h Controller) GetFitmentUsing(data *FitmentUseringInboundInfo, c *player.P
 func (h Controller) GetRoomPetShowInfo(data *PetRoomListInboundInfo, c *player.Player) (result *room.PetRoomListOutboundInfo, err errorcode.ErrorCode) {
 	result = &room.PetRoomListOutboundInfo{}
 	result.Pets = make([]pet.PetShortInfo, 0)
-	roomInfo := c.Service.Room.Get(data.TargetUserID)
+	showPets := service.NewPetService(data.TargetUserID).GetShowPets()
-	for _, catchTime := range roomInfo.ShowPokemon {
+	for i := range showPets {
-		petInfo := c.Service.Pet.PetInfoOneOther(data.TargetUserID, catchTime)
+		var petShortInfo pet.PetShortInfo
-		if petInfo.Data.ID == 0 {
+		copier.Copy(&petShortInfo, &showPets[i].Data)
+		result.Pets = append(result.Pets, petShortInfo)
+	}
+	return
+}
+
+// SetRoomPetShowInfo 设置基地展示精灵并返回最新展示列表（cmd:2323）
+func (h Controller) SetRoomPetShowInfo(data *C2S_PET_ROOM_SHOW, c *player.Player) (result *room.S2C_PET_ROOM_SHOW, err errorcode.ErrorCode) {
+	result = &room.S2C_PET_ROOM_SHOW{}
+	result.PetShowList = make([]pet.PetShortInfo, 0)
+
+	catchTimes := make([]uint32, 0, len(data.PetShowList))
+	seen := make(map[uint32]struct{}, len(data.PetShowList))
+	for _, item := range data.PetShowList {
+		ct := uint32(item.CatchTime)
+		if ct == 0 {
 			continue
 		}
-		var petShortInfo pet.PetShortInfo
+		if _, ok := seen[ct]; ok {
-		copier.Copy(&petShortInfo, &petInfo.Data)
+			continue
-		if petInfo.ID != 0 {
-			result.Pets = append(result.Pets, petShortInfo)
 		}
+		seen[ct] = struct{}{}
+		catchTimes = append(catchTimes, ct)
+	}
+
+	petSvc := service.NewPetService(c.Info.UserID)
+	if !petSvc.SetShowCatchTimes(catchTimes) {
+		err = errorcode.ErrorCodes.ErrSystemError
+		return
+	}
+
+	showPets := petSvc.GetShowPets()
+	for i := range showPets {
+		var petShortInfo pet.PetShortInfo
+		copier.Copy(&petShortInfo, &showPets[i].Data)
+		result.PetShowList = append(result.PetShowList, petShortInfo)
 	}
 	return
 }
@@ -77,6 +106,9 @@ func (h Controller) GetAllFurniture(data *FitmentAllInboundEmpty, c *player.Play
 // 返回: 精灵详细信息和错误码
 func (h Controller) GetRoomPetInfo(data *C2S_RoomPetInfo, c *player.Player) (result *pet.RoomPetInfo, err errorcode.ErrorCode) {
 	petInfo := c.Service.Pet.PetInfoOneOther(data.UserID, data.CatchTime)
+	if petInfo == nil {
+		return nil, errorcode.ErrorCodes.ErrPokemonNotExists
+	}
 	result = &pet.RoomPetInfo{}
 	copier.CopyWithOption(result, &petInfo.Data, copier.Option{DeepCopy: true})
 	result.OwnerId = data.UserID

logic/controller/room_set.go

@@ -2,11 +2,8 @@ package controller
 
 import (
 	"blazing/common/socket/errorcode"
-	"blazing/logic/service/pet"
 	"blazing/logic/service/player"
 	"blazing/logic/service/room"
-
-	"github.com/jinzhu/copier"
 )
 
 // SetFitment 设置基地家具摆放
@@ -18,29 +15,3 @@ func (h Controller) SetFitment(data *SET_FITMENT, c *player.Player) (result *roo
 	c.Service.Room.Set(data.Fitments)
 	return
 }
-
-// SetPet 设置基地展示的精灵
-// data: 包含精灵展示列表的输入信息
-// c: 当前玩家对象
-// 返回: 精灵展示列表和错误码
-func (h Controller) SetPet(data *C2S_PET_ROOM_SHOW, c *player.Player) (result *room.S2C_PET_ROOM_SHOW, err errorcode.ErrorCode) {
-	var showPetCatchTimes []uint32
-	for _, petShowInfo := range data.PetShowList {
-		if petShowInfo.CatchTime != 0 {
-			showPetCatchTimes = append(showPetCatchTimes, petShowInfo.CatchTime)
-		}
-	}
-	c.Service.Room.Show(showPetCatchTimes)
-	result = &room.S2C_PET_ROOM_SHOW{}
-	result.PetShowList = make([]pet.PetShortInfo, len(showPetCatchTimes))
-	for _, catchTime := range showPetCatchTimes {
-		petInfo := c.Service.Pet.PetInfoOneByCatchTime(catchTime)
-		if petInfo == nil {
-			continue
-		}
-		var petShortInfo pet.PetShortInfo
-		copier.Copy(&petShortInfo, &petInfo.Data)
-		result.PetShowList = append(result.PetShowList, petShortInfo)
-	}
-	return
-}

logic/controller/user_cdk.go

@@ -2,62 +2,80 @@ package controller
 
 import (
 	"blazing/common/socket/errorcode"
-	"blazing/logic/service/player"
+	logicplayer "blazing/logic/service/player"
 	"blazing/logic/service/user"
-	"blazing/modules/config/service"
+	baseservice "blazing/modules/base/service"
-	"blazing/modules/player/model"
+	configservice "blazing/modules/config/service"
+	playerservice "blazing/modules/player/service"
+	"strings"
 	"time"
 )
 
 // CDK 处理控制器请求。
-func (h Controller) CDK(data *C2S_GET_GIFT_COMPLETE, player *player.Player) (result *user.S2C_GET_GIFT_COMPLETE, err errorcode.ErrorCode) {
+func (h Controller) CDK(data *C2S_GET_GIFT_COMPLETE, player *logicplayer.Player) (result *user.S2C_GET_GIFT_COMPLETE, err errorcode.ErrorCode) {
 	result = &user.S2C_GET_GIFT_COMPLETE{}
 
-	cdkService := service.NewCdkService()
+	userInfo := baseservice.NewBaseSysUserService().GetPerson(data.Head.UserID)
-	rewardPetService := service.NewPetRewardService()
+	if userInfo == nil || userInfo.QQ == 0 {
-	itemRewardService := service.NewItemService()
+		return nil, errorcode.ErrorCodes.ErrCannotPerformAction
+	}
+
+	cdkCode := strings.Trim(data.PassText, "\x00")
+	cdkService := configservice.NewCdkService()
 	now := time.Now()
 
-	r := cdkService.Get(data.PassText)
+	r := cdkService.Get(cdkCode)
 	if r == nil {
 		return nil, errorcode.ErrorCodes.ErrMolecularCodeNotExists
 	}
+	if r.Type != configservice.CDKTypeReward {
+		return nil, errorcode.ErrorCodes.ErrMolecularCodeNotExists
+	}
 	if r.BindUserId != 0 && r.BindUserId != data.Head.UserID {
 		return nil, errorcode.ErrorCodes.ErrMolecularCodeFrozen
 	}
-
 	if r.ValidEndTime.Compare(now) == -1 {
 		return nil, errorcode.ErrorCodes.ErrMolecularCodeExpired
 	}
 	if !player.Service.Cdk.CanGet(uint32(r.ID)) {
 		return
 	}
-	if !cdkService.Set(data.PassText) {
+	if !cdkService.Set(cdkCode) {
 		return nil, errorcode.ErrorCodes.ErrMolecularCodeGiftsGone
 	}
 
+	reward, grantErr := playerservice.NewCdkService(data.Head.UserID).GrantConfigReward(
+		uint32(r.ID),
+		func(itemID uint32, count int64) bool {
+			return player.ItemAdd(int64(itemID), count)
+		},
+	)
+	if grantErr != nil {
+		return nil, errorcode.ErrorCodes.ErrSystemError
+	}
+
 	result.Flag = 1
-	for _, rewardID := range r.ElfRewardIds {
+	appendGift := func(giftID, count int64) {
-		pet := rewardPetService.Get(rewardID)
+		if giftID == 0 || count <= 0 {
-		if pet == nil {
+			return
-			continue
 		}
-
+		result.GiftList = append(result.GiftList, user.GiftInfo{GiftID: giftID, Count: count})
-		petInfo := model.GenPetInfo(int(pet.MonID), int(pet.DV), int(pet.Nature), int(pet.Effect), int(pet.Lv), nil, 0)
-		player.Service.Pet.PetAdd(petInfo, 0)
-		result.PetGift = append(result.PetGift, user.PetGiftInfo{PetID: petInfo.ID, CacthTime: petInfo.CatchTime})
 	}
 
-	for _, rewardID := range r.ItemRewardIds {
+	appendGift(1, reward.Coins)
-		itemInfo := itemRewardService.GetItemCount(rewardID)
+	appendGift(3, reward.ExpPool)
-		player.ItemAdd(itemInfo.ItemId, itemInfo.ItemCnt)
+	appendGift(5, reward.Gold)
-		result.GiftList = append(result.GiftList, user.GiftInfo{GiftID: itemInfo.ItemId, Count: itemInfo.ItemCnt})
+	appendGift(9, reward.EVPool)
+	for _, item := range reward.Items {
+		appendGift(item.ItemId, item.ItemCnt)
 	}
-	if r.TitleRewardIds != 0 {
+	for _, pet := range reward.Pets {
-		player.Service.Title.Give(r.TitleRewardIds)
+		result.PetGift = append(result.PetGift, user.PetGiftInfo{PetID: pet.PetID, CacthTime: pet.CatchTime})
-		result.Tile = r.TitleRewardIds
 	}
+	if len(reward.TitleIDs) > 0 {
+		result.Tile = reward.TitleIDs[0]
+	}
+
 	player.Service.Cdk.Log(uint32(r.ID))
-
 	return
 }

logic/controller/user_task.go

@@ -28,12 +28,15 @@ func (h Controller) AcceptTask(data *AcceptTaskInboundInfo, c *player.Player) (r
 	}
 
 	c.Info.SetTask(int(data.TaskId), model.Accepted)
-	c.Service.Task.Exec(uint32(data.TaskId), func(t *model.Task) bool {
+	taskData, taskErr := c.Service.Task.GetTask(uint32(data.TaskId))
-		t.Data = []uint32{}
+	if taskErr != nil {
+		return nil, errorcode.ErrorCodes.ErrSystemError
+	}
+	taskData.Data = []uint32{}
+	if taskErr = c.Service.Task.SetTask(taskData); taskErr != nil {
+		return nil, errorcode.ErrorCodes.ErrSystemError
+	}
 
-		return true
-
-	})
 	result = &task.AcceptTaskOutboundInfo{}
 	result.TaskId = data.TaskId
 	return result, 0
@@ -48,10 +51,14 @@ func (h Controller) AddTaskBuf(data *AddTaskBufInboundInfo, c *player.Player) (r
 	if c.Info.GetTask(int(data.TaskId)) != model.Accepted {
 		return result, errorcode.ErrorCodes.ErrAwardAlreadyClaimed
 	}
-	c.Service.Task.Exec(data.TaskId, func(taskEx *model.Task) bool {
+	taskData, taskErr := c.Service.Task.GetTask(data.TaskId)
-		taskEx.Data = data.TaskList
+	if taskErr != nil {
-		return true
+		return nil, errorcode.ErrorCodes.ErrSystemError
-	})
+	}
+	taskData.Data = data.TaskList
+	if taskErr = c.Service.Task.SetTask(taskData); taskErr != nil {
+		return nil, errorcode.ErrorCodes.ErrSystemError
+	}
 	return result, 0
 }
 
@@ -70,31 +77,16 @@ func (h Controller) CompleteTask(data1 *CompleteTaskInboundInfo, c *player.Playe
 	// if service.NewTaskService().IsAcceptable(data1.TaskId) == nil {
 	// 	return nil, errorcode.ErrorCodes.ErrSystemError
 	// }
-	c.Info.SetTask(int(data1.TaskId), model.Completed)
-
 	result = &task.CompleteTaskOutboundInfo{
 		TaskId:   data1.TaskId,
 		ItemList: make([]data.ItemInfo, 0),
 	}
 
-	taskInfo := task.GetTaskInfo(int(data1.TaskId), int(data1.OutState))
+	if _, err = c.ApplyTaskCompletion(data1.TaskId, int(data1.OutState), result); err != 0 {
-	if taskInfo == nil {
+		return nil, err
-		return nil, errorcode.ErrorCodes.ErrNeedCompleteTaskForPrize
 	}
-
+	if taskErr := c.Info.SetTask(int(data1.TaskId), model.Completed); taskErr != nil {
-	if taskInfo.Pet != nil {
+		return nil, errorcode.ErrorCodes.ErrSystemError
-
-		c.Service.Pet.PetAdd(taskInfo.Pet, 0)
-		result.CaptureTime = taskInfo.Pet.CatchTime
-		result.PetTypeId = taskInfo.Pet.ID
-	}
-
-	for _, item := range taskInfo.ItemList {
-		success := c.ItemAdd(item.ItemId, item.ItemCnt)
-		if success {
-			result.ItemList = append(result.ItemList, item)
-		}
-
 	}
 
 	return result, 0 //通过PUB/SUB回包
@@ -105,11 +97,12 @@ func (h Controller) GetTaskBuf(data *GetTaskBufInboundInfo, c *player.Player) (r
 	result = &task.GetTaskBufOutboundInfo{
 		TaskId: data.TaskId,
 	}
-	c.Service.Task.Exec(data.TaskId, func(te *model.Task) bool {
 
-		result.TaskList = te.Data
+	taskData, taskErr := c.Service.Task.GetTask(data.TaskId)
-		return false
+	if taskErr != nil {
-	})
+		return nil, errorcode.ErrorCodes.ErrSystemError
+	}
+	result.TaskList = taskData.Data
 
 	return result, 0
 }

logic/main.go

@@ -52,7 +52,7 @@ func PprofWeb() {
 	}
 
 	// 所有端口都失败时的兜底
-	errMsg := fmt.Sprintf("[FATAL] 端口9909/9910均监听失败，pprof服务启动失败")
+	errMsg := "[FATAL] 端口9909/9910均监听失败，pprof服务启动失败"
 	fmt.Println(errMsg)
 	// 可选：根据业务需求决定是否panic
 	// panic(errMsg)
@@ -148,7 +148,7 @@ func monitorMemAndQuit() {
 
 		// 4. 超70%阈值，执行优雅退出
 		if usedRatio >= memThresholdRatio {
-			log.Fatalf("内存占比达%.1f%%，超过90%阈值，程序开始退出", usedRatio*100)
+			log.Fatalf("内存占比达%.1f%%，超过90%%阈值，程序开始退出", usedRatio*100)
 			// ########## 可选：这里添加你的优雅清理逻辑 ##########
 			// 如：关闭数据库连接、释放文件句柄、保存业务状态、推送退出告警等
 			cleanup()

logic/server.go

@@ -81,7 +81,7 @@ func Start() {
 
 	controller.Maincontroller.RPCClient = rpcClient //将RPC赋值Start
 
-	controller.Maincontroller.UID = gconv.Uint32(cool.Config.ServerInfo.GetID()) //赋值服务器ID
+	controller.Maincontroller.UID = cool.Config.ServerInfo.RuntimeID() //赋值服务器复合ID
 	controller.Init(true)
 	xmlres.Initfile()
 

logic/service/common/pack.go

@@ -1,22 +1,24 @@
 package common
 
 import (
+	"blazing/cool"
 	"bytes"
+	"context"
 	"encoding/binary"
-	"fmt"
+	"reflect"
 
 	"github.com/lunixbochs/struc"
 )
 
 // TomeeHeader 定义协议包头。
 type TomeeHeader struct {
-	Len     uint32 `json:"len"`                  // 包总长度（包头 + 数据体）。
+	Len     uint32 `json:"len"`                     // 包总长度（包头 + 数据体）。
 	Version byte   `json:"version" struc:"[1]byte"` // 协议版本。
 	CMD     uint32 `json:"cmdId" struc:"uint32"`    // 命令 ID。
-	UserID  uint32 `json:"userId"`               // 玩家 ID。
+	UserID  uint32 `json:"userId"`                  // 玩家 ID。
-	Result  uint32 `json:"result"`               // 结果码。
+	Result  uint32 `json:"result"`                  // 结果码。
-	Data    []byte `json:"data" struc:"skip"`  // 数据体，序列化时跳过。
+	Data    []byte `json:"data" struc:"skip"`       // 数据体，序列化时跳过。
-	Res     []byte `struc:"skip"`                // 预留返回数据，序列化时跳过。
+	Res     []byte `struc:"skip"`                   // 预留返回数据，序列化时跳过。
 }
 
 // NewTomeeHeader 创建用于下行封包的默认 TomeeHeader。
@@ -39,7 +41,14 @@ func (h *TomeeHeader) Pack(data any) []byte {
 	var data1 bytes.Buffer
 	err := struc.Pack(&data1, data)
 	if err != nil {
-		fmt.Println(err)
+		cool.Logger.Error(context.Background(),
+			"struc pack failed",
+			"cmd", h.CMD,
+			"userID", h.UserID,
+			"result", h.Result,
+			"payloadType", packetPayloadType(data),
+			"err", err,
+		)
 	}
 
 	if len(data1.Bytes()) == 0 {
@@ -89,3 +98,10 @@ func (h *TomeeHeader) packHeaderWithData(data []byte) []byte {
 
 	return buf
 }
+
+func packetPayloadType(data any) string {
+	if data == nil {
+		return "<nil>"
+	}
+	return reflect.TypeOf(data).String()
+}

logic/service/fight/action.go

@@ -44,6 +44,7 @@ func (f *FightC) openActionWindow() {
 	f.actionMu.Lock()
 	f.acceptActions = true
 	f.pendingActions = f.pendingActions[:0]
+	f.pendingHead = 0
 	f.actionRound.Store(uint32(f.Round))
 	f.actionMu.Unlock()
 }
@@ -52,6 +53,7 @@ func (f *FightC) closeActionWindow() {
 	f.actionMu.Lock()
 	f.acceptActions = false
 	f.pendingActions = f.pendingActions[:0]
+	f.pendingHead = 0
 	f.actionRound.Store(0)
 	f.actionMu.Unlock()
 
@@ -73,8 +75,10 @@ func (f *FightC) submitAction(act action.BattleActionI) {
 		f.actionMu.Unlock()
 		return
 	}
+	f.compactPendingActionsLocked()
 	replaceIndex := -1
-	for i, pending := range f.pendingActions {
+	for i := f.pendingHead; i < len(f.pendingActions); i++ {
+		pending := f.pendingActions[i]
 		if pending == nil || actionSlotKeyFromAction(pending) != actionSlotKeyFromAction(act) {
 			continue
 		}
@@ -82,6 +86,10 @@ func (f *FightC) submitAction(act action.BattleActionI) {
 		break
 	}
 	if replaceIndex >= 0 {
+		if f.LegacyGroupProtocol {
+			f.actionMu.Unlock()
+			return
+		}
 		f.pendingActions[replaceIndex] = act
 	} else {
 		f.pendingActions = append(f.pendingActions, act)
@@ -101,15 +109,23 @@ func (f *FightC) submitAction(act action.BattleActionI) {
 
 func (f *FightC) nextAction() action.BattleActionI {
 	f.actionMu.Lock()
-	if len(f.pendingActions) == 0 {
+	if f.pendingHead >= len(f.pendingActions) {
+		f.pendingActions = f.pendingActions[:0]
+		f.pendingHead = 0
 		f.actionMu.Unlock()
 		return nil
 	}
 
-	act := f.pendingActions[0]
+	act := f.pendingActions[f.pendingHead]
-	copy(f.pendingActions, f.pendingActions[1:])
+	f.pendingActions[f.pendingHead] = nil
-	f.pendingActions = f.pendingActions[:len(f.pendingActions)-1]
+	f.pendingHead++
-	hasMore := len(f.pendingActions) > 0
+	hasMore := f.pendingHead < len(f.pendingActions)
+	if !hasMore {
+		f.pendingActions = f.pendingActions[:0]
+		f.pendingHead = 0
+	} else {
+		f.compactPendingActionsLocked()
+	}
 	notify := f.actionNotify
 	f.actionMu.Unlock()
 
@@ -123,6 +139,22 @@ func (f *FightC) nextAction() action.BattleActionI {
 	return act
 }
 
+func (f *FightC) compactPendingActionsLocked() {
+	if f.pendingHead == 0 {
+		return
+	}
+	if f.pendingHead < len(f.pendingActions)/2 && len(f.pendingActions) < cap(f.pendingActions) {
+		return
+	}
+	remaining := len(f.pendingActions) - f.pendingHead
+	copy(f.pendingActions, f.pendingActions[f.pendingHead:])
+	for i := remaining; i < len(f.pendingActions); i++ {
+		f.pendingActions[i] = nil
+	}
+	f.pendingActions = f.pendingActions[:remaining]
+	f.pendingHead = 0
+}
+
 // 玩家逃跑/无响应/掉线
 func (f *FightC) Over(c common.PlayerI, res model.EnumBattleOverReason) {
 	if f.closefight {
@@ -143,10 +175,13 @@ func (f *FightC) Over(c common.PlayerI, res model.EnumBattleOverReason) {
 	// }
 
 	f.overl.Do(func() {
-		f.Reason = res
+		f.Reason = normalizeFightOverReason(res)
 		if f.GetInputByPlayer(c, true) != nil {
 			f.WinnerId = f.GetInputByPlayer(c, true).UserID
 		}
+		f.FightOverInfo.Reason = f.Reason
+		f.FightOverInfo.WinnerId = f.WinnerId
+		f.closefight = true
 
 		close(f.quit)
 
@@ -218,7 +253,7 @@ func (f *FightC) UseSkillAt(c common.PlayerI, id uint32, actorIndex, targetIndex
 	// }
 	for _, v := range currentPet.Skills {
 		if v.XML.ID == int(id) {
-			ret.SkillEntity = v
+			ret.SkillEntity = info.CreateSkill(v.Info, currentPet)
 
 			break
 		}
@@ -281,9 +316,19 @@ func (f *FightC) UseItemAt(c common.PlayerI, cacthid, itemid uint32, actorIndex,
 
 // ReadyFight 处理玩家战斗准备逻辑，当满足条件时启动战斗循环
 func (f *FightC) ReadyFight(c common.PlayerI) {
-	f.Broadcast(func(ff *input.Input) {
+	if f.LegacyGroupProtocol {
-
+		input := f.GetInputByPlayer(c, false)
-		ff.Player.SendPackCmd(2404, &info.S2C_2404{UserID: c.GetInfo().UserID})
+		if input == nil {
+			return
+		}
+		input.Finished = true
+		if f.checkBothPlayersReady(c) {
+			f.startBattle(f.FightStartOutboundInfo)
+		}
+		return
+	}
+	f.BroadcastPlayers(func(p common.PlayerI) {
+		p.SendPackCmd(2404, &info.S2C_2404{UserID: c.GetInfo().UserID})
 	})
 	// 2. 标记当前玩家已准备完成
 	input := f.GetInputByPlayer(c, false)
@@ -325,7 +370,7 @@ func (f *FightC) collectFightPetInfos(inputs []*input.Input) []info.FightPetInfo
 			Hp:               currentPet.Info.Hp,
 			MaxHp:            currentPet.Info.MaxHp,
 			Level:            currentPet.Info.Level,
-			Catchable:        uint32(fighter.CanCapture),
+			Catchable:        fightPetCatchableFlag(fighter.CanCapture),
 		}
 		if fighter.AttackValue != nil {
 			fightInfo.Prop = fighter.AttackValue.Prop
@@ -335,6 +380,13 @@ func (f *FightC) collectFightPetInfos(inputs []*input.Input) []info.FightPetInfo
 	return infos
 }
 
+func fightPetCatchableFlag(catchRate int) uint32 {
+	if catchRate > 0 {
+		return 1
+	}
+	return 0
+}
+
 // checkBothPlayersReady 检查PVP战斗中双方是否都已准备完成
 // 参数c为当前准备的玩家，返回true表示双方均准备完成
 func (f *FightC) checkBothPlayersReady(currentPlayer common.PlayerI) bool {
@@ -355,8 +407,12 @@ func (f *FightC) startBattle(startInfo info.FightStartOutboundInfo) {
 		go f.battleLoop()
 
 		// 向双方广播战斗开始信息
-		f.Broadcast(func(ff *input.Input) {
+		f.BroadcastPlayers(func(p common.PlayerI) {
-			ff.Player.SendPackCmd(2504, &startInfo)
+			if f.LegacyGroupProtocol {
+				f.sendLegacyGroupStart(p)
+				return
+			}
+			f.sendFightPacket(p, fightPacketStart, &startInfo)
 		})
 	})
 }

logic/service/fight/action_start_test.go

@@ -0,0 +1,66 @@
+package fight
+
+import (
+	"testing"
+
+	fightinfo "blazing/logic/service/fight/info"
+	"blazing/logic/service/fight/input"
+	"blazing/modules/player/model"
+)
+
+func TestEnterTurnRunsActionStartWhenNoOneActs(t *testing.T) {
+	ourPlayer := &stubPlayer{info: model.PlayerInfo{UserID: 1001}}
+	oppPlayer := &stubPlayer{info: model.PlayerInfo{UserID: 2002}}
+
+	our := input.NewInput(nil, ourPlayer)
+	our.InitAttackValue()
+	ourPet := fightinfo.CreateBattlePetEntity(model.PetInfo{
+		ID:        11,
+		Name:      "Alpha",
+		Level:     20,
+		Hp:        100,
+		MaxHp:     100,
+		CatchTime: 101,
+	})
+	ourPet.BindController(ourPlayer.info.UserID)
+	our.SetCurPetAt(0, ourPet)
+	our.Team = []*input.Input{our}
+
+	opp := input.NewInput(nil, oppPlayer)
+	opp.InitAttackValue()
+	oppPet := fightinfo.CreateBattlePetEntity(model.PetInfo{
+		ID:        22,
+		Name:      "Beta",
+		Level:     20,
+		Hp:        80,
+		MaxHp:     80,
+		CatchTime: 202,
+	})
+	oppPet.BindController(oppPlayer.info.UserID)
+	opp.SetCurPetAt(0, oppPet)
+	opp.Team = []*input.Input{opp}
+
+	our.Opp = opp
+	opp.Opp = our
+	our.OppTeam = []*input.Input{opp}
+	opp.OppTeam = []*input.Input{our}
+
+	fc := &FightC{
+		Our: []*input.Input{our},
+		Opp: []*input.Input{opp},
+	}
+	our.FightC = fc
+	opp.FightC = fc
+
+	poison := opp.InitEffect(input.EffectType.Status, int(fightinfo.PetStatus.Poisoned))
+	if poison == nil {
+		t.Fatalf("expected poisoned status effect to be registered")
+	}
+	opp.AddEffect(opp, poison)
+
+	fc.enterturn(nil, nil)
+
+	if got := opp.CurrentPet().Info.Hp; got != 70 {
+		t.Fatalf("expected poisoned defender to lose 10 HP during action-start phase, got %d", got)
+	}
+}

logic/service/fight/boss/NewSeIdx_1.go

@@ -31,6 +31,13 @@ func (e *NewSel0) IsOwner() bool {
 	return e.ID().GetCatchTime() == source.CurPet[0].Info.CatchTime
 }
 
+func (e *NewSel0) CurrentSkillHit() bool {
+	if e.Ctx().SkillEntity == nil {
+		return false
+	}
+	return e.Ctx().SkillEntity.AttackTime != 0
+}
+
 // 免疫"能力(battle_lv)下降"
 type NewSel1 struct {
 	NewSel0

logic/service/fight/boss/NewSeIdx_247.go

@@ -2,6 +2,7 @@ package effect
 
 import (
 	"blazing/logic/service/fight/action"
+	"blazing/logic/service/fight/info"
 	"blazing/logic/service/fight/input"
 )
 
@@ -70,6 +71,29 @@ func (e *NewSel247) TurnEnd() {
 	}
 }
 
+type NewSel239 struct {
+	NewSel0
+}
+
+func (e *NewSel239) ActionStart(a, b *action.SelectSkillAction) bool {
+	if !e.IsOwner() {
+		return true
+	}
+	if e.Ctx().SkillEntity == nil {
+		return true
+	}
+	if e.Ctx().SkillEntity.Category() == info.Category.STATUS {
+		return true
+	}
+	if len(e.Args()) == 0 {
+		return true
+	}
+
+	e.Ctx().SkillEntity.XML.Power += int(e.Args()[0].IntPart())
+	return true
+}
+
 func init() {
+	input.InitEffect(input.EffectType.NewSel, 239, &NewSel239{})
 	input.InitEffect(input.EffectType.NewSel, 247, &NewSel247{})
 }

logic/service/fight/boss/NewSeIdx_38.go

@@ -13,13 +13,13 @@ type NewSel38 struct {
 	NewSel0
 }
 
-func (e *NewSel39) DamageAdd(t *info.DamageZone) bool {
+func (e *NewSel38) DamageAdd(t *info.DamageZone) bool {
 
 	if e.ID().GetCatchTime() != e.Ctx().Our.CurPet[0].Info.CatchTime {
 		return true
 	}
 
-	t.Damage = t.Damage.Add(t.Damage.Mul(alpacadecimal.NewFromInt(int64(e.Args()[0].IntPart()))))
+	t.Damage = t.Damage.Add(t.Damage.Mul(e.Args()[0].Div(alpacadecimal.NewFromInt(100))))
 
 	return true
 }

logic/service/fight/boss/NewSeIdx_41.go

@@ -10,7 +10,7 @@ type NewSel41 struct {
 	NewSel0
 }
 
-func (e *NewSel41) Skill_Use_ex() bool {
+func (e *NewSel41) Skill_Use() bool {
 	if e.ID().GetCatchTime() != e.Ctx().Our.CurPet[0].Info.CatchTime {
 		return true
 	}

logic/service/fight/boss/NewSeIdx_49.go

@@ -28,6 +28,9 @@ func (e *NewSel49) Action_end_ex() bool {
 	if e.Ctx().SkillEntity == nil {
 		return true
 	}
+	if !e.CurrentSkillHit() {
+		return true
+	}
 
 	if e.Ctx().SkillEntity.Category() == info.Category.PHYSICAL {
 		e.attackType = 1

logic/service/fight/boss/NewSeIdx_53.go

@@ -13,8 +13,7 @@ type NewSel53 struct {
 }
 
 func (e *NewSel53) TurnStart(fattack *action.SelectSkillAction, sattack *action.SelectSkillAction) {
-	//魂印特性有不在场的情况,绑定时候将精灵和特性绑定
+	if !e.IsOwner() || e.Ctx().Our.CurPet[0] == nil || e.Ctx().Opp.CurPet[0] == nil {
-	if e.ID().GetCatchTime() != e.Ctx().Our.CurPet[0].Info.CatchTime {
 		return
 	}
 
@@ -23,12 +22,12 @@ func (e *NewSel53) TurnStart(fattack *action.SelectSkillAction, sattack *action.
 	healAmount := maxHP.Mul(e.Args()[0]).Div(alpacadecimal.NewFromInt(100))
 
 	// 恢复我方HP
-	e.Ctx().Our.Heal(e.Ctx().Our, nil, healAmount)
+	e.Ctx().Our.Heal(e.Ctx().Our, &action.SelectSkillAction{}, healAmount)
 
 	// 恢复敌方HP
 	oppMaxHP := e.Ctx().Opp.CurPet[0].GetMaxHP()
 	oppHealAmount := oppMaxHP.Mul(e.Args()[0]).Div(alpacadecimal.NewFromInt(100))
-	e.Ctx().Opp.Heal(e.Ctx().Opp, nil, oppHealAmount)
+	e.Ctx().Opp.Heal(e.Ctx().Opp, &action.SelectSkillAction{}, oppHealAmount)
 }
 
 func init() {

logic/service/fight/boss/NewSeIdx_6.go

@@ -22,6 +22,9 @@ func (e *NewSel6) Action_end_ex() bool {
 	if e.Ctx().SkillEntity.Category() != info.Category.PHYSICAL {
 		return true
 	}
+	if !e.CurrentSkillHit() {
+		return true
+	}
 
 	// 3. 概率判定（Args()[1]为触发概率）
 	success, _, _ := e.Input.Player.Roll(int(e.Args()[1].IntPart()), 100)

logic/service/fight/boss/NewSeIdx_74.go

@@ -23,6 +23,9 @@ func (e *NewSel74) Action_end_ex() bool {
 	if e.Ctx().SkillEntity.Category() == info.Category.STATUS {
 		return true
 	}
+	if !e.CurrentSkillHit() {
+		return true
+	}
 
 	// 检查概率是否触发
 	success, _, _ := e.Input.Player.Roll(int(e.Args()[0].IntPart()), 100)

logic/service/fight/boss/NewSeIdx_78.go

@@ -23,6 +23,9 @@ func (e *NewSel78) Action_end_ex() bool {
 	if e.Ctx().SkillEntity.Category() != info.Category.SPECIAL {
 		return true
 	}
+	if !e.CurrentSkillHit() {
+		return true
+	}
 
 	// 检查概率是否触发
 	success, _, _ := e.Input.Player.Roll(int(e.Args()[1].IntPart()), 100)

logic/service/fight/cmd.go

@@ -94,6 +94,11 @@ type CrossServerBanPickPetInfo struct {
 	MaxHp     uint32 `json:"maxHp"`
 }
 
+type CrossServerBanPickTianxuanPetInfo struct {
+	PetID uint32 `json:"petId"`
+	Name  string `struc:"[16]byte" json:"name"`
+}
+
 type CrossServerBanPickStartOutboundInfo struct {
 	SessionIDLen uint32 `struc:"sizeof=SessionID"`
 	SessionID    string `json:"sessionId"`
@@ -106,12 +111,19 @@ type CrossServerBanPickStartOutboundInfo struct {
 
 	TimeoutSeconds  uint32 `json:"timeoutSeconds"`
 	SelectableCount uint32 `json:"selectableCount"`
+	TianxuanSelectableCount uint32 `json:"tianxuanSelectableCount"`
 
 	MyPetsLen uint32                      `struc:"sizeof=MyPets"`
 	MyPets    []CrossServerBanPickPetInfo `json:"myPets"`
 
+	MyTianxuanPetsLen uint32                              `struc:"sizeof=MyTianxuanPets"`
+	MyTianxuanPets    []CrossServerBanPickTianxuanPetInfo `json:"myTianxuanPets"`
+
 	OpponentPetsLen uint32                      `struc:"sizeof=OpponentPets"`
 	OpponentPets    []CrossServerBanPickPetInfo `json:"opponentPets"`
+
+	OpponentTianxuanPetsLen uint32                              `struc:"sizeof=OpponentTianxuanPets"`
+	OpponentTianxuanPets    []CrossServerBanPickTianxuanPetInfo `json:"opponentTianxuanPets"`
 }
 
 // HandleFightInviteInboundInfo 处理战斗邀请的入站消息

logic/service/fight/effect/1178_1182.go

@@ -140,7 +140,7 @@ func (e *Effect1181) OnSkill() bool {
 type Effect1182 struct{ node.EffectNode }
 
 func (e *Effect1182) Skill_Use() bool {
-	if len(e.Args()) < 2 || e.Ctx().Our == nil || e.Ctx().Our.CurPet[0] == nil || e.Ctx().Opp == nil || e.Ctx().Opp.CurPet[0] == nil {
+	if len(e.Args()) < 2 || e.Ctx().Our == nil || e.Ctx().Our.CurPet[0] == nil {
 		return true
 	}
 
@@ -153,9 +153,15 @@ func (e *Effect1182) Skill_Use() bool {
 	if targetHP.Cmp(alpacadecimal.Zero) < 0 {
 		targetHP = alpacadecimal.Zero
 	}
-	if e.Ctx().Opp.CurPet[0].GetHP().Cmp(targetHP) > 0 {
+	forEachEnemyTargetBySkill(e.Ctx().Our, e.Ctx().Opp, e.Ctx().SkillEntity, func(target *input.Input) bool {
-		e.Ctx().Opp.CurPet[0].Info.Hp = uint32(targetHP.IntPart())
+		if target == nil || target.CurrentPet() == nil {
-	}
+			return true
+		}
+		if target.CurrentPet().GetHP().Cmp(targetHP) > 0 {
+			target.CurrentPet().Info.Hp = uint32(targetHP.IntPart())
+		}
+		return true
+	})
 
 	sub := e.Ctx().Our.InitEffect(input.EffectType.Sub, 1182, int(e.Args()[1].IntPart()))
 	if sub != nil {

logic/service/fight/effect/169.go

@@ -10,20 +10,23 @@ type Effect169 struct {
 }
 
 func (e *Effect169) OnSkill() bool {
-
 	chance := e.Args()[1].IntPart()
 	success, _, _ := e.Input.Player.Roll(int(chance), 100)
 	if success {
-		// 添加异常状态
+		e.ForEachOpponentSlot(func(target *input.Input) bool {
-		statusEffect := e.CarrierInput().InitEffect(input.EffectType.Status, int(e.Args()[2].IntPart())) // 以麻痹为例
+			if target == nil {
-		if statusEffect != nil {
+				return true
-			e.TargetInput().AddEffect(e.CarrierInput(), statusEffect)
+			}
-		}
+			statusEffect := e.CarrierInput().InitEffect(input.EffectType.Status, int(e.Args()[2].IntPart()))
+			if statusEffect != nil {
+				target.AddEffect(e.CarrierInput(), statusEffect)
+			}
+			return true
+		})
 	}
 	return true
 }
 
 func init() {
 	input.InitEffect(input.EffectType.Skill, 169, &Effect169{})
-
 }

logic/service/fight/effect/2170_2194.go

@@ -311,7 +311,7 @@ func (e *Effect2194) OnSkill() bool {
 	if e.Ctx().Opp.CurPet[0] == nil {
 		return true
 	}
-	addStatusByID(e.Ctx().Our, e.Ctx().Opp, int(info.PetStatus.DrainedHP))
+	addTimedStatus(e.Ctx().Our, e.Ctx().Opp, int(info.PetStatus.DrainedHP), 4)
 	return true
 }
 

logic/service/fight/effect/2270_2294.go

@@ -444,7 +444,7 @@ func (e *Effect2278) Skill_Use() bool {
 		return true
 	}
 
-	damage := marked.GetHP().Mul(alpacadecimal.NewFromInt(percent)).Div(hundred)
+	damage := marked.GetMaxHP().Mul(alpacadecimal.NewFromInt(percent)).Div(hundred)
 	if damage.Cmp(alpacadecimal.Zero) > 0 {
 		e.Ctx().Opp.Damage(e.Ctx().Our, &info.DamageZone{
 			Type:   info.DamageType.Percent,

logic/service/fight/effect/85.go

@@ -14,18 +14,25 @@ type Effect85 struct {
 // 执行时逻辑
 // ----------------------
 func (e *Effect85) OnSkill() bool {
-
+	carrier := e.CarrierInput()
-	for i, v := range e.Ctx().Opp.Prop[:] {
+	opp := e.OpponentInput()
-		if v > 0 {
+	if carrier == nil || opp == nil {
-			e.Ctx().Our.SetProp(e.Ctx().Our, int8(i), v)
+		return true
-			e.Ctx().Opp.SetProp(e.Ctx().Our, int8(i), 0)
-		}
-
 	}
-
+	e.transferPositiveProps(carrier, opp)
 	return true
 }
 
+// transferPositiveProps 使用显式入参执行业务逻辑，避免嵌套结算时再从 Ctx 取到漂移后的对象。
+func (e *Effect85) transferPositiveProps(carrier, opp *input.Input) {
+	for i, v := range opp.Prop[:] {
+		if v > 0 {
+			carrier.SetProp(carrier, int8(i), v)
+			opp.SetProp(carrier, int8(i), 0)
+		}
+	}
+}
+
 // ----------------------
 // 注册所有效果
 // ----------------------

logic/service/fight/effect/effect_13.go

@@ -34,7 +34,7 @@ func (e *Effect13) OnSkill() bool {
 	if eff == nil {
 		return true
 	}
-	eff.Duration(e.EffectNode.SideEffectArgs[0] - 1)
+	eff.Duration(e.EffectNode.SideEffectArgs[0])
 
 	e.Ctx().Opp.AddEffect(e.Ctx().Our, eff)
 	return true

logic/service/fight/effect/effect_4_5.go

@@ -1,6 +1,7 @@
 package effect
 
 import (
+	"blazing/logic/service/fight/input"
 	"blazing/logic/service/fight/node"
 )
 
@@ -41,14 +42,16 @@ type Effect5 struct {
 // 技能触发时调用
 // -----------------------------------------------------------
 func (e *Effect5) Skill_Use() bool {
-
 	// 概率判定
 	ok, _, _ := e.Input.Player.Roll(e.SideEffectArgs[1], 100)
 	if !ok {
 		return true
 	}
 
-	e.Ctx().Opp.SetProp(e.Ctx().Our, int8(e.SideEffectArgs[0]), int8(e.SideEffectArgs[2]))
+	forEachEnemyTargetBySkill(e.Ctx().Our, e.Ctx().Opp, e.Ctx().SkillEntity, func(target *input.Input) bool {
+		target.SetProp(e.Ctx().Our, int8(e.SideEffectArgs[0]), int8(e.SideEffectArgs[2]))
+		return true
+	})
 
 	return true
 }

logic/service/fight/effect/effect_724_728.go

@@ -5,6 +5,7 @@ import (
 	"blazing/logic/service/fight/info"
 	"blazing/logic/service/fight/input"
 	"blazing/logic/service/fight/node"
+	"fmt"
 )
 
 // Effect 724: {0}回合内受到攻击{1}%恢复1/{2}体力
@@ -85,6 +86,7 @@ func (e *Effect727) Action_end() bool {
 		return true
 	}
 
+	fmt.Printf("[Effect727] Action_end RESET: Our.Prop %v -> LastTurnEndProp %v\n", e.Ctx().Our.Prop, e.Ctx().Our.LastTurnEndProp)
 	e.Ctx().Our.AttackValue.Prop = e.Ctx().Our.LastTurnEndProp
 	return true
 }

logic/service/fight/effect/effect_76.go

@@ -22,15 +22,19 @@ type Effect76 struct {
 }
 
 func (e *Effect76) OnSkill() bool {
-
 	// 概率判定
 	ok, _, _ := e.Input.Player.Roll(int(e.Args()[0].IntPart()), 100)
 	if !ok {
 		return true
 	}
-	e.Ctx().Opp.Damage(e.Ctx().Our, &info.DamageZone{
+
-		Type:   info.DamageType.Fixed,
+	damage := alpacadecimal.NewFromInt(int64(e.SideEffectArgs[2]))
-		Damage: alpacadecimal.NewFromInt(int64(e.SideEffectArgs[2])),
+	forEachEnemyTargetBySkill(e.Ctx().Our, e.Ctx().Opp, e.Ctx().SkillEntity, func(target *input.Input) bool {
+		target.Damage(e.Ctx().Our, &info.DamageZone{
+			Type:   info.DamageType.Fixed,
+			Damage: damage,
+		})
+		return true
 	})
 	return true
 }

logic/service/fight/effect/effect_91.go

@@ -1,7 +1,6 @@
 package effect
 
 import (
-	"blazing/logic/service/fight/action"
 	"blazing/logic/service/fight/input"
 )
 
@@ -13,23 +12,72 @@ func init() {
 	t := &Effect91{}
 
 	input.InitEffect(input.EffectType.Skill, 91, t)
+	input.InitEffect(input.EffectType.Sub, 91, &Effect91Sub{})
 
 }
 
 // Effect 91: {0}回合内对手的状态变化会同时作用在自己身上
 type Effect91 struct {
 	RoundEffectSideArg0Base
-	can bool
 }
 
-// 默认添加回合
+func (e *Effect91) Skill_Use() bool {
+	sub := e.Ctx().Our.InitEffect(input.EffectType.Sub, 91, e.SideEffectArgs...)
+	if sub != nil {
+		e.Ctx().Opp.AddEffect(e.Ctx().Our, sub)
+	}
+	return true
+}
 
-func (e *Effect91) TurnStart(fattack *action.SelectSkillAction, sattack *action.SelectSkillAction) {
+type Effect91Sub struct {
-
+	RoundEffectSideArg0Base
-	for i, v := range e.Ctx().Opp.Prop[:] {
+}
-
-		e.Ctx().Our.SetProp(e.Ctx().Our, int8(i), v)
 
+func (e *Effect91Sub) PropBefer(_ *input.Input, prop int8, level int8) bool {
+	if prop < 0 || int(prop) >= len(e.Ctx().Our.Prop) {
+		return true
 	}
 
+	// 当前效果挂在“对手”身上：当对手能力变化时，将实际变化量同步给来源方。
+	target := e.Ctx().Our
+	current := target.Prop[prop]
+	actualDelta := calcPropActualDelta(current, level)
+	if actualDelta == 0 {
+		return true
+	}
+
+	owner := e.SourceInput()
+	if owner == nil || owner == target {
+		return true
+	}
+	owner.SetProp(owner, prop, actualDelta)
+	return true
+}
+
+func calcPropActualDelta(current, change int8) int8 {
+	switch {
+	case change < 0:
+		if current <= -6 {
+			return 0
+		}
+		next := current + change
+		if next < -6 {
+			next = -6
+		}
+		return next - current
+	case change > 0:
+		if current >= 6 {
+			return 0
+		}
+		next := current + change
+		if next > 6 {
+			next = 6
+		}
+		return next - current
+	default:
+		if current == 0 {
+			return 0
+		}
+		return -current
+	}
 }

logic/service/fight/effect/effect_info_map.go

@@ -19,7 +19,7 @@ var effectInfoByID = map[int]string{
 	29:  "额外附加{0}点固定伤害",
 	31:  "",
 	32:  "使用后{0}回合攻击击中对象要害概率增加1/16",
-	33:  "消除对手能力提升状态",
+	33:  "消除敌方阵营所有强化",
 	34:  "将所受的伤害{0}倍反馈给对手",
 	35:  "惩罚，对方能力等级越高，此技能威力越大",
 	36:  "命中时{0}%的概率秒杀对方",
@@ -120,7 +120,7 @@ var effectInfoByID = map[int]string{
 	164: "{0}回合内若受到攻击则有{1}%概率令对手{2}",
 	165: "{0}回合内每回合防御和特防等级+{1}",
 	166: "{0}回合内若对手使用属性攻击则{2}%对手{1}等级{3}",
-	169: "{0}回合内每回合额外附加{1}%概率令对手{2}",
+	169: "{0}回合内每回合额外附加{1}%概率令对方阵营全体{2}",
 	170: "若先出手，则免疫当回合伤害并回复1/{0}的最大体力值",
 	171: "{0}回合内自身使用属性技能时能较快出手",
 	172: "若后出手，则给予对方损伤的1/{0}会回复自己的体力",